mirror of
https://github.com/Matysh/houseplan-card
synced 2026-10-06 06:38:57 +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
189 lines
5.8 KiB
TypeScript
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;
|
|
}
|
|
|