mirror of
https://github.com/Matysh/houseplan-card
synced 2026-09-28 19:01:34 +00:00
§4 SPEC.md референса, четыре карточки: Basics (имя и масштаб в сетке 1fr/175, подложка двумя choice-карточками, callout о пересчёте масштаба), Appearance (строка-тумблер границ с иконкой и подписью, сегмент стиля стен с образцами линии, плашка цвета с hex/прозрачностью/Reset, сегмент заливки с деталями режима, компактный список «Видимые слои» с логикой «включено = видно» — К2), Room cards (строка-тумблер названий, четыре плитки значений с отключением и callout-ссылкой, слайдер размера с числом, концами и «Сбросить до 100%», образец карточки внутри блока на тинте — Q2), Sun & light (сегмент фона, плашка цвета фона, радио «свет через окна» в строку, север селектом с компасом 44 px и полем градусов, строка-тумблер свечения). Одна форма на два рантайма. `renderSpaceForm` в `editors/space-form.ts` собирает тело и футер; редакторский вход (`space-settings-dialog.ts`) и онбординг подают порт с тем, что у них различается, и сами рисуют `<hp-dialog data-kind=…>` — контракт #489 требует литеральный kind. Копия разметки онбординга на 300 строк удалена; локальные дубли CELL_CM_* и strictNumber там же — тоже («одно число — один источник»). К10 (решение владельца Q1): Save активен только при изменениях и без ошибок, в футере «Есть несохранённые изменения» либо ссылка «Проверьте поля: N» к первому ошибочному; «✕», Cancel и Escape с изменениями спрашивают через `_confirmDanger`, без изменений закрывают сразу. Снимок делается при открытии (`editors/space-form-state.ts`, WeakMap по хосту) — `SpaceDialogState` не получил ни одного ключа. Валидация: имя, подложка без изображения, диапазон температур, север 0–359 — с `aria-invalid` и текстом под полем. Строки. 51 новый ключ живёт в ленивом словаре `i18n/settings` (приём #423/#459), не в первом кадре: стартовый граф 291 260 при потолке 292 500. Отдельный словарь, а не `support`, — иначе онбординг тянул бы весь словарь редактора ради одной формы. 11 существующих ключей переименованы по Q6 («Space name», «Appearance», «Room cards», «Draw it myself», «Zigbee signal next to devices»…), 9 мёртвых удалены из четырёх локалей. `hp-color-opacity` получил `hide-label`: подпись рисует плашка, `label` остаётся для title/aria и `smoke_color_picker_consumers` проходит без правок (AC5). Смоки. Переписаны осознанно (К6 снят), каждый — с пометкой #600 у правки: smoke_hide_layers (компактные строки, инверсия К2 проверяется кликом), smoke_ux_fixes (сегмент, строка-тумблер, поля °C, ширина 560 — Q7), smoke_dialog_footer_width (560 для form-shell), smoke_temp_fill (два поля по id), smoke_settings_dialog_cards (три сегмента), smoke_space_settings и smoke_space_create_display_defaults и smoke_lazy_editor_chunk (choice-карточка по смыслу, не по индексу — порядок §4.2 draw → file), smoke_space_scale_defaults (поле с единицей). Новый фокусный свидетель demo/smoke_space_settings_form.mjs: состав карточек и отсутствие старой разметки, оболочка 560 и один скроллер, цели 44, запись каждого нового контрола в свой ключ, Save/dirty/вопрос при закрытии, семь контрольных ширин (320…1920). Мутанты: space-fill-segment-writes-a-neighbour-key, space-save-enabled-without-changes, space-discard-without-asking, space-layer-toggle-loses-inversion. Контрактные тесты: `houseplan-source.mjs` дописывает общие модули диалогов к логическому исходнику; коллектор i18n видит `help(...)` порта и `shelp(...)` (заодно встал на учёт `radar.help`, проходивший мимо счётчика — 30 → 35). Потолок ленивого редакторского графа 225 900 → 236 300 (замер 235 560) с разбором в bundle-budget.mjs: словарь на четыре локали и подписи — большая часть роста; промежуточно, итог в конце серий. Гейты: typecheck, build, bundle:sync, npm test 2792 pass (красным был только потолок — поднят с доводом), 10 смоков пространства зелёные, smoke_color_picker_consumers без правок, mutation-gate --check. Issue: #600 User-Visible: no
163 lines
7.4 KiB
JavaScript
163 lines
7.4 KiB
JavaScript
// #337: the display-only card must stay independent from the editor runtime.
|
|
// Exercise the production bundle, including its content-hashed retry URL.
|
|
import { readFileSync } from 'node:fs';
|
|
import { launchColdView, checkAll, finish } from './serve.mjs';
|
|
|
|
const manifest = JSON.parse(readFileSync('dist/houseplan-assets.json', 'utf8'));
|
|
const runtimePath = manifest.files
|
|
.map((file) => file.path)
|
|
.find((path) => /houseplan-editor-runtime-[^/]+\.js$/.test(path));
|
|
if (!runtimePath) throw new Error('editor runtime is absent from the bundle manifest');
|
|
const runtimeName = runtimePath.split('/').at(-1);
|
|
const runtimeUrlPattern = `**/${runtimeName}*`;
|
|
const runtimeFile = `demo/srv/assets/${runtimePath}`;
|
|
const onboardingPath = manifest.files
|
|
.map((file) => file.path)
|
|
.find((path) => /houseplan-onboarding-runtime-[^/]+\.js$/.test(path));
|
|
if (!onboardingPath) throw new Error('onboarding runtime is absent from the bundle manifest');
|
|
const onboardingName = onboardingPath.split('/').at(-1);
|
|
|
|
const clickEditor = async (page, index, mode) => {
|
|
await page.locator('houseplan-card').evaluate((card, tabIndex) => {
|
|
const root = card.shadowRoot || card.renderRoot;
|
|
root.querySelectorAll('.modetab')[tabIndex]?.click();
|
|
}, index);
|
|
await page.waitForFunction((expected) => window.__card._mode === expected, mode);
|
|
await page.waitForFunction(() => window.__card._modeTransitionBusy === false);
|
|
};
|
|
|
|
const { page, browser } = await launchColdView();
|
|
const requested = [];
|
|
page.on('request', (request) => requested.push(new URL(request.url()).pathname));
|
|
const initialResources = await page.evaluate(() => performance.getEntriesByType('resource')
|
|
.map((entry) => new URL(entry.name).pathname));
|
|
const out = {
|
|
editorAbsentBeforeIntent: !initialResources.some((path) => path.endsWith(`/${runtimeName}`)),
|
|
};
|
|
|
|
await clickEditor(page, 0, 'plan');
|
|
await clickEditor(page, 1, 'devices');
|
|
await clickEditor(page, 2, 'decor');
|
|
out.oneRuntimeRequestForAllEditors = requested.filter((path) => path.endsWith(`/${runtimeName}`)).length === 1;
|
|
out.allEditorsUseInstalledRuntime = await page.evaluate(() =>
|
|
window.__card._editorRuntimeLoader.state === 'ready' && window.__card._mode === 'decor');
|
|
|
|
// Empty-install onboarding is a separate lazy surface. It may fetch its own
|
|
// dialog chunk, but must not fetch or install the editor until Save explicitly
|
|
// continues into Plan mode.
|
|
const onboarding = await launchColdView();
|
|
const onboardingRequests = [];
|
|
onboarding.page.on('request', (request) => {
|
|
onboardingRequests.push(new URL(request.url()).pathname);
|
|
});
|
|
await onboarding.page.evaluate(async () => {
|
|
const card = window.__card;
|
|
card._onboardingShown = false;
|
|
card._serverCfg = { ...card._serverCfg, spaces: [] };
|
|
card._model = [];
|
|
card.hass = { ...card.hass, floors: {}, areas: {} };
|
|
card.requestUpdate();
|
|
await card.updateComplete;
|
|
});
|
|
await onboarding.page.waitForFunction(() => {
|
|
const card = window.__card;
|
|
return card._onboardingRuntime && card.renderRoot.querySelector('hp-dialog');
|
|
});
|
|
out.onboardingUsesOwnChunk = onboardingRequests
|
|
.filter((path) => path.endsWith(`/${onboardingName}`)).length === 1;
|
|
out.onboardingDoesNotLoadEditor = onboardingRequests
|
|
.every((path) => !path.endsWith(`/${runtimeName}`))
|
|
&& await onboarding.page.evaluate(() => !window.__card._editorRuntime);
|
|
await onboarding.page.evaluate(async () => {
|
|
const card = window.__card;
|
|
const root = card.renderRoot;
|
|
// #600: онбординг рисует ту же форму, что редактор; поле имени — по id,
|
|
// карточка «Нарисовать» — по смыслу (порядок §4.2: draw → file).
|
|
const title = root.querySelector('hp-dialog #onboarding-space-title');
|
|
title.value = 'Cold onboarding';
|
|
title.dispatchEvent(new InputEvent('input', { bubbles: true }));
|
|
await card.updateComplete;
|
|
[...root.querySelectorAll('hp-dialog input[name="plansrc"]')]
|
|
.find((radio) => radio.closest('label')?.textContent.includes(card._t('space.source_draw')))?.click();
|
|
await card.updateComplete;
|
|
const buttons = [...root.querySelectorAll('hp-dialog button')];
|
|
buttons.find((button) => button.textContent.includes(card._t('btn.save')))?.click();
|
|
});
|
|
await onboarding.page.waitForFunction(() => {
|
|
const card = window.__card;
|
|
return card._editorRuntime && card._mode === 'plan'
|
|
&& card._serverCfg.spaces.some((space) => space.title === 'Cold onboarding');
|
|
});
|
|
out.onboardingSaveContinuesToPlan = onboardingRequests
|
|
.filter((path) => path.endsWith(`/${runtimeName}`)).length === 1;
|
|
|
|
const gui = await launchColdView();
|
|
out.guiEditorLoadsAsynchronously = await gui.page.evaluate(async () => {
|
|
const ctor = customElements.get('houseplan-card');
|
|
const editor = await ctor.getConfigElement();
|
|
return editor?.localName === 'houseplan-card-editor';
|
|
});
|
|
|
|
// Two network failures end one load cycle, but are NOT terminal (#353): the
|
|
// loader re-arms and the next explicit press starts a fresh cycle that heals
|
|
// once the network is back. The retry inside a cycle is the same immutable
|
|
// chunk with a cache-busting query string.
|
|
const failed = await launchColdView();
|
|
let failedRequests = 0;
|
|
await failed.page.route(runtimeUrlPattern, async (route) => {
|
|
failedRequests += 1;
|
|
await route.abort('failed');
|
|
});
|
|
const pressEditor = () => failed.page.locator('houseplan-card').evaluate((card) => {
|
|
const root = card.shadowRoot || card.renderRoot;
|
|
root.querySelectorAll('.modetab')[0]?.click();
|
|
});
|
|
await pressEditor();
|
|
await failed.page.waitForFunction(() =>
|
|
window.__card._editorRuntimeLoader.state === 'idle' && window.__card._toast);
|
|
out.networkFailureRetriesExactlyOnce = failedRequests === 2;
|
|
out.networkFailureKeepsViewWithRetryAdvice = await failed.page.evaluate(() => {
|
|
const card = window.__card;
|
|
return card._mode === 'view'
|
|
&& !card._editorRuntime
|
|
&& card._toast.includes(card._t('editor.load_failed'))
|
|
&& card._toast.includes(card._t('editor.retry_advice'));
|
|
});
|
|
await failed.page.unroute(runtimeUrlPattern);
|
|
await pressEditor();
|
|
await failed.page.waitForFunction(() =>
|
|
window.__card._editorRuntimeLoader.state === 'ready' && window.__card._mode === 'plan');
|
|
out.secondPressAfterNetworkFailureOpensEditor = true;
|
|
|
|
// A valid module from a different build is no safer than a 404. Both attempts
|
|
// are fulfilled deliberately so this checks the fingerprint handshake rather
|
|
// than the network branch above.
|
|
const mismatch = await launchColdView();
|
|
let mismatchRequests = 0;
|
|
const incompatibleRuntime = readFileSync(runtimeFile, 'utf8')
|
|
.replaceAll(manifest.fingerprint, `${manifest.fingerprint}-mismatch`);
|
|
await mismatch.page.route(runtimeUrlPattern, async (route) => {
|
|
mismatchRequests += 1;
|
|
await route.fulfill({
|
|
status: 200,
|
|
contentType: 'text/javascript',
|
|
body: incompatibleRuntime,
|
|
});
|
|
});
|
|
await mismatch.page.locator('houseplan-card').evaluate((card) => {
|
|
const root = card.shadowRoot || card.renderRoot;
|
|
root.querySelectorAll('.modetab')[1]?.click();
|
|
});
|
|
await mismatch.page.waitForFunction(() => window.__card._editorRuntimeLoader.state === 'failed');
|
|
out.fingerprintMismatchRetriesExactlyOnce = mismatchRequests === 2;
|
|
out.fingerprintMismatchKeepsView = await mismatch.page.evaluate(() =>
|
|
window.__card._mode === 'view' && !window.__card._editorRuntime
|
|
&& window.__card._toast.includes(window.__card._t('editor.refresh_advice')));
|
|
|
|
await failed.browser.close();
|
|
await mismatch.browser.close();
|
|
await onboarding.browser.close();
|
|
await gui.browser.close();
|
|
checkAll(out);
|
|
await finish(browser, out);
|