Files
houseplan-card/src/space-dialog.ts
T
Claude 91a008db9c feat(space): диалог «Пространство» по референсу — серия 1 из четырёх (#600)
§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
2026-09-20 10:28:51 +03:00

189 lines
5.8 KiB
TypeScript

import { roomTempRangeOf, type FillColorEntry, type RoomTempRange } from './logic';
import type { ZeroWallStyle } from './types';
export type SpacePlanSource = 'file' | 'draw';
export interface SpaceCopyDraft {
title: string;
busy: boolean;
token: number;
}
export interface SpaceDialogState {
mode: 'edit' | 'create';
spaceId?: string;
title: string;
planUrl: string | null;
planFile: { ext: string; b64: string; aspect: number; name: string } | null;
/** Server-side plan picker state; asset files are never inferred garbage. */
pickSaved?: boolean;
saved?: Array<{
name: string; url: string; size: number; modified: number; used_by: string[];
}> | null;
savedBusy?: boolean;
savedAspect?: number;
source: SpacePlanSource;
showBorders: boolean;
showNames: boolean;
zeroWallStyle: ZeroWallStyle;
displayTouched: boolean;
hideDecor: boolean;
hideOpenings: boolean;
roomColor: string;
roomOpacity: number;
bgColor: string | null;
bgMode: 'static' | 'daynight' | null;
northDeg: number | null;
sunRays: boolean | null;
fillMode: 'none' | 'lqi' | 'light' | 'temp' | 'custom';
customFill: FillColorEntry | null;
glowEnabled: boolean;
tempMin: number;
tempMax: number;
showLqi: boolean;
cardFontScale: number;
labelTemp: boolean;
labelHum: boolean;
labelLqi: boolean;
labelLight: boolean;
cellCm: number;
cellCmInput?: string;
cellCmTouched?: boolean;
deleteBlockers?: number;
copy?: SpaceCopyDraft;
busy: boolean;
}
export interface SpaceDisplayDraft {
source: SpacePlanSource;
showBorders: boolean;
showNames: boolean;
/** Ephemeral create-dialog guard; never persisted in the House Plan config. */
displayTouched: boolean;
}
/**
* A current empty space is still a complete wall-model document. In
* particular, model v8+ forbids using an absent catalogue to mean "no walls":
* absence means an outdated/partial writer, while an empty array is the
* canonical empty catalogue.
*/
export function createEmptySpaceConfig(id: string, title: string): Record<string, unknown> {
return {
id,
title,
plan_url: null,
view_box: [0, 0, 1, 1],
rooms: [],
wall_segments: [],
};
}
/** Source-specific visible defaults for a fresh create/onboarding step. */
export function initialSpaceDisplayDraft(source: SpacePlanSource = 'file'): SpaceDisplayDraft {
const visible = source === 'draw';
return {
source,
showBorders: visible,
showNames: visible,
displayTouched: false,
};
}
/**
* Project source defaults only while the owner has not changed either display
* switch. Once touched, the pair is one user choice and must survive switches.
*/
export function switchSpacePlanSource<T extends SpaceDisplayDraft>(
draft: T,
source: SpacePlanSource,
): T {
if (draft.displayTouched) return { ...draft, source };
const visible = source === 'draw';
return { ...draft, source, showBorders: visible, showNames: visible };
}
/** Changing either switch protects the complete pair from source projection. */
export function touchSpaceDisplay<T extends SpaceDisplayDraft>(
draft: T,
field: 'showBorders' | 'showNames',
value: boolean,
): T {
return { ...draft, [field]: value, displayTouched: true };
}
/** Numeric dialog fields consume the complete value; decimal comma is valid. */
export function strictNumber(value: string): number | null {
const text = String(value ?? '').trim().replace(',', '.');
if (!/^[+-]?(?:\d+(?:\.\d*)?|\.\d+)$/.test(text)) return null;
const parsed = Number(text);
return Number.isFinite(parsed) ? parsed : null;
}
export interface RoomTempThresholdDraft {
valid: boolean;
min: number | null;
max: number | null;
}
/** Parse room threshold inputs without conflating an empty field with zero. */
export function roomTempThresholdDraft(
rawMin: string,
rawMax: string,
): RoomTempThresholdDraft {
const parse = (raw: string): { valid: boolean; value: number | null } => {
if (String(raw ?? '').trim() === '') return { valid: true, value: null };
const value = strictNumber(raw);
return { valid: value !== null, value };
};
const lower = parse(rawMin);
const upper = parse(rawMax);
if (!lower.valid || !upper.valid) {
return { valid: false, min: lower.value, max: upper.value };
}
if (lower.value !== null && upper.value !== null && lower.value > upper.value) {
return { valid: true, min: upper.value, max: lower.value };
}
return { valid: true, min: lower.value, max: upper.value };
}
/** Resolve saved or pending room bounds through the same production inheritance rule. */
export function roomTempRangeFromDraft(
spaceMin: number,
spaceMax: number,
room: { settings?: { temp_min?: unknown; temp_max?: unknown } | null },
rawMin: string,
rawMax: string,
useDraft: boolean,
): RoomTempRange {
const draft = roomTempThresholdDraft(rawMin, rawMax);
const source = useDraft && draft.valid
? { settings: { ...(room.settings || {}), temp_min: draft.min, temp_max: draft.max } }
: room;
return roomTempRangeOf(spaceMin, spaceMax, source);
}
export function roomTempThresholdInputValues(
settings: { temp_min?: unknown; temp_max?: unknown } | null | undefined,
): [string, string] {
const value = (value: unknown): string =>
typeof value === 'number' && Number.isFinite(value) ? String(value) : '';
return [value(settings?.temp_min), value(settings?.temp_max)];
}
/** Mutate a dialog-owned settings draft; false means the inputs must not be saved. */
export function applyRoomTempThresholdDraft(
settings: Record<string, unknown>,
rawMin: string,
rawMax: string,
): boolean {
const draft = roomTempThresholdDraft(rawMin, rawMax);
if (!draft.valid) return false;
if (draft.min === null) delete settings.temp_min;
else settings.temp_min = draft.min;
if (draft.max === null) delete settings.temp_max;
else settings.temp_max = draft.max;
return true;
}