@things-factory/figure-ui 10.1.151 → 10.1.153

package/dist-client/modeller/modeller-keys.d.ts

@@ -0,0 +1,22 @@
+import type { ReactiveController, ReactiveControllerHost } from 'lit';
+import { type KeyAction } from './keys.js';
+/** What the keys ask of the editor. */
+export interface ModellerKeysHost {
+    /** Whether the modeller takes keys now: a figure open, not loading or saving, and no section editor open. */
+    taking(): boolean;
+    /** The scene, whose keys the modeller's are too. */
+    scene(): Element | null;
+    selected(): string;
+    act(action: KeyAction): void;
+}
+/**
+ * The modeller's keys (`keys.ts`): undo, redo, duplicate, remove, back to the whole figure, the gizmo's modes. Heard on
+ * the window, first (capture), while the editor is on the page.
+ */
+export declare class ModellerKeys implements ReactiveController {
+    private readonly of;
+    constructor(host: ReactiveControllerHost, of: ModellerKeysHost);
+    hostConnected(): void;
+    hostDisconnected(): void;
+    private onKey;
+}

package/dist-client/modeller/modeller-keys.js

@@ -0,0 +1,43 @@
+import { keyActionOf } from './keys.js';
+/**
+ * The modeller's keys (`keys.ts`): undo, redo, duplicate, remove, back to the whole figure, the gizmo's modes. Heard on
+ * the window, first (capture), while the editor is on the page.
+ */
+export class ModellerKeys {
+    constructor(host, of) {
+        this.of = of;
+        this.onKey = (e) => {
+            if (!this.of.taking())
+                return;
+            const canvas = this.of.scene();
+            const path = e.composedPath();
+            const action = keyActionOf({
+                key: e.key,
+                ctrlKey: e.ctrlKey,
+                metaKey: e.metaKey,
+                shiftKey: e.shiftKey,
+                altKey: e.altKey,
+                target: path[0],
+                inScene: !!canvas && path.includes(canvas)
+            }, this.of.selected());
+            if (!action)
+                return;
+            e.preventDefault();
+            /*
+              The session's history is the only one. With the canvas focused the scene took Ctrl+Z as well, undoing on its own
+              board the last value the canvas had written -- which the canvas then told as a drag: an undo of a drag on a
+              part placed by a rule wrote the drag again (2026-09-25). Heard first (capture) and kept from the scene.
+            */
+            e.stopPropagation();
+            this.of.act(action);
+        };
+        host.addController(this);
+    }
+    hostConnected() {
+        window.addEventListener('keydown', this.onKey, true);
+    }
+    hostDisconnected() {
+        window.removeEventListener('keydown', this.onKey, true);
+    }
+}
+//# sourceMappingURL=modeller-keys.js.map

package/dist-client/modeller/modeller-keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"modeller-keys.js","sourceRoot":"","sources":["../../client/modeller/modeller-keys.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAkB,MAAM,WAAW,CAAA;AAYvD;;;GAGG;AACH,MAAM,OAAO,YAAY;IACvB,YACE,IAA4B,EACX,EAAoB;QAApB,OAAE,GAAF,EAAE,CAAkB;QAa/B,UAAK,GAAG,CAAC,CAAgB,EAAE,EAAE;YACnC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE;gBAAE,OAAM;YAC7B,MAAM,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAA;YAC9B,MAAM,IAAI,GAAG,CAAC,CAAC,YAAY,EAAE,CAAA;YAC7B,MAAM,MAAM,GAAG,WAAW,CACxB;gBACE,GAAG,EAAE,CAAC,CAAC,GAAG;gBACV,OAAO,EAAE,CAAC,CAAC,OAAO;gBAClB,OAAO,EAAE,CAAC,CAAC,OAAO;gBAClB,QAAQ,EAAE,CAAC,CAAC,QAAQ;gBACpB,MAAM,EAAE,CAAC,CAAC,MAAM;gBAChB,MAAM,EAAE,IAAI,CAAC,CAAC,CAAgB;gBAC9B,OAAO,EAAE,CAAC,CAAC,MAAM,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;aAC3C,EACD,IAAI,CAAC,EAAE,CAAC,QAAQ,EAAE,CACnB,CAAA;YACD,IAAI,CAAC,MAAM;gBAAE,OAAM;YACnB,CAAC,CAAC,cAAc,EAAE,CAAA;YAClB;;;;cAIE;YACF,CAAC,CAAC,eAAe,EAAE,CAAA;YACnB,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;QACrB,CAAC,CAAA;QApCC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAA;IAC1B,CAAC;IAED,aAAa;QACX,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAA;IACtD,CAAC;IAED,gBAAgB;QACd,MAAM,CAAC,mBAAmB,CAAC,SAAS,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAA;IACzD,CAAC;CA4BF","sourcesContent":["import type { ReactiveController, ReactiveControllerHost } from 'lit'\nimport { keyActionOf, type KeyAction } from './keys.js'\n\n/** What the keys ask of the editor. */\nexport interface ModellerKeysHost {\n  /** Whether the modeller takes keys now: a figure open, not loading or saving, and no section editor open. */\n  taking(): boolean\n  /** The scene, whose keys the modeller's are too. */\n  scene(): Element | null\n  selected(): string\n  act(action: KeyAction): void\n}\n\n/**\n * The modeller's keys (`keys.ts`): undo, redo, duplicate, remove, back to the whole figure, the gizmo's modes. Heard on\n * the window, first (capture), while the editor is on the page.\n */\nexport class ModellerKeys implements ReactiveController {\n  constructor(\n    host: ReactiveControllerHost,\n    private readonly of: ModellerKeysHost\n  ) {\n    host.addController(this)\n  }\n\n  hostConnected() {\n    window.addEventListener('keydown', this.onKey, true)\n  }\n\n  hostDisconnected() {\n    window.removeEventListener('keydown', this.onKey, true)\n  }\n\n  private onKey = (e: KeyboardEvent) => {\n    if (!this.of.taking()) return\n    const canvas = this.of.scene()\n    const path = e.composedPath()\n    const action = keyActionOf(\n      {\n        key: e.key,\n        ctrlKey: e.ctrlKey,\n        metaKey: e.metaKey,\n        shiftKey: e.shiftKey,\n        altKey: e.altKey,\n        target: path[0] as HTMLElement,\n        inScene: !!canvas && path.includes(canvas)\n      },\n      this.of.selected()\n    )\n    if (!action) return\n    e.preventDefault()\n    /*\n      The session's history is the only one. With the canvas focused the scene took Ctrl+Z as well, undoing on its own\n      board the last value the canvas had written -- which the canvas then told as a drag: an undo of a drag on a\n      part placed by a rule wrote the drag again (2026-09-25). Heard first (capture) and kept from the scene.\n    */\n    e.stopPropagation()\n    this.of.act(action)\n  }\n}\n"]}

package/dist-client/modeller/pane-fold.d.ts

@@ -0,0 +1,15 @@
+import type { ReactiveController, ReactiveControllerHost } from 'lit';
+import type { OxThreePane } from '@operato/layout';
+export declare class PaneFold implements ReactiveController {
+    private readonly host;
+    private readonly panes;
+    static readonly FOLD_START_UNDER = 1100;
+    private foldedForWidth;
+    private keptOpenByAuthor;
+    private widthWatch;
+    /** `panes` is the frame the bar folds, once it is drawn. */
+    constructor(host: ReactiveControllerHost & HTMLElement, panes: () => OxThreePane | undefined);
+    hostConnected(): void;
+    hostDisconnected(): void;
+    fitTo(width: number): void;
+}

package/dist-client/modeller/pane-fold.js

@@ -0,0 +1,60 @@
+import { i18next } from '@operato/i18n';
+import { notify } from '@operato/layout';
+/** Whether the narrow fold was said in this browser before; true from now on. Storage refused: said, as before. */
+function foldSaid() {
+    try {
+        if (localStorage.getItem('figure-fold-said'))
+            return true;
+        localStorage.setItem('figure-fold-said', '1');
+    }
+    catch {
+        /* No storage here: said every time, as it was. */
+    }
+    return false;
+}
+/*
+  Narrow, the parts list gives way to the canvas rather than all three shrinking (designer 2026-09-27, U11): under
+  FOLD_START_UNDER px the canvas would be left under about 560 px beside both sides. The fold is said once, and the
+  bar's own toggle opens it again; opened by the author, it is not folded again until the screen has been wide.
+  Said once in this browser, not on every opening (2026-10-02): the list folds as before, the notice does not come back.
+*/
+export class PaneFold {
+    static { this.FOLD_START_UNDER = 1100; }
+    /** `panes` is the frame the bar folds, once it is drawn. */
+    constructor(host, panes) {
+        this.host = host;
+        this.panes = panes;
+        this.foldedForWidth = false;
+        this.keptOpenByAuthor = false;
+        this.widthWatch = new ResizeObserver(([entry]) => this.fitTo(entry.contentRect.width));
+        host.addController(this);
+    }
+    hostConnected() {
+        this.widthWatch.observe(this.host);
+    }
+    hostDisconnected() {
+        this.widthWatch.disconnect();
+    }
+    fitTo(width) {
+        const panes = this.panes();
+        if (!panes || !width)
+            return;
+        if (this.foldedForWidth && !panes.foldStart)
+            this.keptOpenByAuthor = true;
+        if (width < PaneFold.FOLD_START_UNDER) {
+            if (!panes.foldStart && !this.keptOpenByAuthor) {
+                panes.foldStart = true;
+                this.foldedForWidth = true;
+                if (!foldSaid())
+                    notify({ level: 'info', message: i18next.t('figure.text.parts-panel-folded-narrow') });
+            }
+        }
+        else {
+            if (this.foldedForWidth && panes.foldStart)
+                panes.foldStart = false;
+            this.foldedForWidth = false;
+            this.keptOpenByAuthor = false;
+        }
+    }
+}
+//# sourceMappingURL=pane-fold.js.map

package/dist-client/modeller/pane-fold.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pane-fold.js","sourceRoot":"","sources":["../../client/modeller/pane-fold.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAEvC,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAExC,mHAAmH;AACnH,SAAS,QAAQ;IACf,IAAI,CAAC;QACH,IAAI,YAAY,CAAC,OAAO,CAAC,kBAAkB,CAAC;YAAE,OAAO,IAAI,CAAA;QACzD,YAAY,CAAC,OAAO,CAAC,kBAAkB,EAAE,GAAG,CAAC,CAAA;IAC/C,CAAC;IAAC,MAAM,CAAC;QACP,kDAAkD;IACpD,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC;AAED;;;;;EAKE;AACF,MAAM,OAAO,QAAQ;aACH,qBAAgB,GAAG,IAAI,AAAP,CAAO;IAKvC,4DAA4D;IAC5D,YACmB,IAA0C,EAC1C,KAAoC;QADpC,SAAI,GAAJ,IAAI,CAAsC;QAC1C,UAAK,GAAL,KAAK,CAA+B;QAP/C,mBAAc,GAAG,KAAK,CAAA;QACtB,qBAAgB,GAAG,KAAK,CAAA;QACxB,eAAU,GAAG,IAAI,cAAc,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,KAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAA;QAOxF,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAA;IAC1B,CAAC;IAED,aAAa;QACX,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACpC,CAAC;IAED,gBAAgB;QACd,IAAI,CAAC,UAAU,CAAC,UAAU,EAAE,CAAA;IAC9B,CAAC;IAED,KAAK,CAAC,KAAa;QACjB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,EAAE,CAAA;QAC1B,IAAI,CAAC,KAAK,IAAI,CAAC,KAAK;YAAE,OAAM;QAC5B,IAAI,IAAI,CAAC,cAAc,IAAI,CAAC,KAAK,CAAC,SAAS;YAAE,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAA;QACzE,IAAI,KAAK,GAAG,QAAQ,CAAC,gBAAgB,EAAE,CAAC;YACtC,IAAI,CAAC,KAAK,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC;gBAC/C,KAAK,CAAC,SAAS,GAAG,IAAI,CAAA;gBACtB,IAAI,CAAC,cAAc,GAAG,IAAI,CAAA;gBAC1B,IAAI,CAAC,QAAQ,EAAE;oBAAE,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,uCAAuC,CAAC,EAAE,CAAC,CAAA;YACzG,CAAC;QACH,CAAC;aAAM,CAAC;YACN,IAAI,IAAI,CAAC,cAAc,IAAI,KAAK,CAAC,SAAS;gBAAE,KAAK,CAAC,SAAS,GAAG,KAAK,CAAA;YACnE,IAAI,CAAC,cAAc,GAAG,KAAK,CAAA;YAC3B,IAAI,CAAC,gBAAgB,GAAG,KAAK,CAAA;QAC/B,CAAC;IACH,CAAC","sourcesContent":["import type { ReactiveController, ReactiveControllerHost } from 'lit'\nimport { i18next } from '@operato/i18n'\nimport type { OxThreePane } from '@operato/layout'\nimport { notify } from '@operato/layout'\n\n/** Whether the narrow fold was said in this browser before; true from now on. Storage refused: said, as before. */\nfunction foldSaid(): boolean {\n  try {\n    if (localStorage.getItem('figure-fold-said')) return true\n    localStorage.setItem('figure-fold-said', '1')\n  } catch {\n    /* No storage here: said every time, as it was. */\n  }\n  return false\n}\n\n/*\n  Narrow, the parts list gives way to the canvas rather than all three shrinking (designer 2026-09-27, U11): under\n  FOLD_START_UNDER px the canvas would be left under about 560 px beside both sides. The fold is said once, and the\n  bar's own toggle opens it again; opened by the author, it is not folded again until the screen has been wide.\n  Said once in this browser, not on every opening (2026-10-02): the list folds as before, the notice does not come back.\n*/\nexport class PaneFold implements ReactiveController {\n  static readonly FOLD_START_UNDER = 1100\n  private foldedForWidth = false\n  private keptOpenByAuthor = false\n  private widthWatch = new ResizeObserver(([entry]) => this.fitTo(entry!.contentRect.width))\n\n  /** `panes` is the frame the bar folds, once it is drawn. */\n  constructor(\n    private readonly host: ReactiveControllerHost & HTMLElement,\n    private readonly panes: () => OxThreePane | undefined\n  ) {\n    host.addController(this)\n  }\n\n  hostConnected() {\n    this.widthWatch.observe(this.host)\n  }\n\n  hostDisconnected() {\n    this.widthWatch.disconnect()\n  }\n\n  fitTo(width: number) {\n    const panes = this.panes()\n    if (!panes || !width) return\n    if (this.foldedForWidth && !panes.foldStart) this.keptOpenByAuthor = true\n    if (width < PaneFold.FOLD_START_UNDER) {\n      if (!panes.foldStart && !this.keptOpenByAuthor) {\n        panes.foldStart = true\n        this.foldedForWidth = true\n        if (!foldSaid()) notify({ level: 'info', message: i18next.t('figure.text.parts-panel-folded-narrow') })\n      }\n    } else {\n      if (this.foldedForWidth && panes.foldStart) panes.foldStart = false\n      this.foldedForWidth = false\n      this.keptOpenByAuthor = false\n    }\n  }\n}\n"]}

package/dist-client/modeller/panel-memory.d.ts

@@ -0,0 +1,15 @@
+export declare class PanelMemory {
+    private readonly root;
+    private kept;
+    private restoreFor?;
+    /** `root` is where the properties panel is drawn: the editor's render root. */
+    constructor(root: () => ParentNode);
+    private panel;
+    private foldsOf;
+    /** Another model: nothing kept. */
+    clear(): void;
+    /** The selection moves from `was` to `now` ('' is the model): the panel as `was` left it is kept, `now`'s put back after the update. */
+    leave(was: string, now: string): void;
+    /** After the update: the panel of the part chosen as it was left, while that part is still the one chosen. */
+    restore(selected: () => string): void;
+}

package/dist-client/modeller/panel-memory.js

@@ -0,0 +1,54 @@
+/*
+  Per model and per part, how far its properties panel was scrolled and which of its folds were open, so going back
+  to one finds it as it was left (designer 2026-09-27, B.1). The path stays held at the top, so a scroll kept cannot
+  hide which part the panel speaks of. Another model starts clean.
+*/
+export class PanelMemory {
+    /** `root` is where the properties panel is drawn: the editor's render root. */
+    constructor(root) {
+        this.root = root;
+        this.kept = new Map();
+    }
+    panel() {
+        return this.root().querySelector('div[panel]');
+    }
+    foldsOf(panel) {
+        const folds = [...panel.querySelectorAll('details')];
+        for (const inner of panel.querySelectorAll('figure-links'))
+            folds.push(...(inner.shadowRoot?.querySelectorAll('details') ?? []));
+        return folds;
+    }
+    /** Another model: nothing kept. */
+    clear() {
+        this.kept.clear();
+    }
+    /** The selection moves from `was` to `now` ('' is the model): the panel as `was` left it is kept, `now`'s put back after the update. */
+    leave(was, now) {
+        const panel = this.panel();
+        if (panel)
+            this.kept.set(was || '@model', { top: panel.scrollTop, open: this.foldsOf(panel).map(d => d.open) });
+        this.restoreFor = now || '@model';
+    }
+    /** After the update: the panel of the part chosen as it was left, while that part is still the one chosen. */
+    restore(selected) {
+        if (this.restoreFor === undefined)
+            return;
+        const key = this.restoreFor;
+        this.restoreFor = undefined;
+        /*
+          Put back as soon as the links have drawn, before any click can come: the updates are microtasks. Put back a
+          frame later, it closed a fold opened by a click in that frame (2026-10-11, the row on a bench under load).
+        */
+        const panel = this.panel();
+        if (panel)
+            void Promise.all([...panel.querySelectorAll('figure-links')].map(el => el.updateComplete)).then(() => {
+                if ((selected() || '@model') !== key)
+                    return;
+                const kept = this.kept.get(key);
+                if (kept)
+                    this.foldsOf(panel).forEach((fold, i) => i < kept.open.length && (fold.open = kept.open[i]));
+                panel.scrollTop = kept?.top ?? 0;
+            });
+    }
+}
+//# sourceMappingURL=panel-memory.js.map

package/dist-client/modeller/panel-memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"panel-memory.js","sourceRoot":"","sources":["../../client/modeller/panel-memory.ts"],"names":[],"mappings":"AAAA;;;;EAIE;AACF,MAAM,OAAO,WAAW;IAItB,+EAA+E;IAC/E,YAA6B,IAAsB;QAAtB,SAAI,GAAJ,IAAI,CAAkB;QAJ3C,SAAI,GAAG,IAAI,GAAG,EAA4C,CAAA;IAIZ,CAAC;IAE/C,KAAK;QACX,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,aAAa,CAAc,YAAY,CAAC,CAAA;IAC7D,CAAC;IAEO,OAAO,CAAC,KAAkB;QAChC,MAAM,KAAK,GAAG,CAAC,GAAG,KAAK,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC,CAAA;QACpD,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,gBAAgB,CAAC,cAAc,CAAC;YAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,EAAE,gBAAgB,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;QAChI,OAAO,KAAK,CAAA;IACd,CAAC;IAED,mCAAmC;IACnC,KAAK;QACH,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAA;IACnB,CAAC;IAED,wIAAwI;IACxI,KAAK,CAAC,GAAW,EAAE,GAAW;QAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,EAAE,CAAA;QAC1B,IAAI,KAAK;YAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,QAAQ,EAAE,EAAE,GAAG,EAAE,KAAK,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QAC/G,IAAI,CAAC,UAAU,GAAG,GAAG,IAAI,QAAQ,CAAA;IACnC,CAAC;IAED,8GAA8G;IAC9G,OAAO,CAAC,QAAsB;QAC5B,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS;YAAE,OAAM;QACzC,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,CAAA;QAC3B,IAAI,CAAC,UAAU,GAAG,SAAS,CAAA;QAC3B;;;UAGE;QACF,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,EAAE,CAAA;QAC1B,IAAI,KAAK;YACP,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,gBAAgB,CAAsD,cAAc,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE;gBACxJ,IAAI,CAAC,QAAQ,EAAE,IAAI,QAAQ,CAAC,KAAK,GAAG;oBAAE,OAAM;gBAC5C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;gBAC/B,IAAI,IAAI;oBAAE,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAE,CAAC,CAAC,CAAA;gBACvG,KAAK,CAAC,SAAS,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC,CAAA;YAClC,CAAC,CAAC,CAAA;IACN,CAAC;CACF","sourcesContent":["/*\n  Per model and per part, how far its properties panel was scrolled and which of its folds were open, so going back\n  to one finds it as it was left (designer 2026-09-27, B.1). The path stays held at the top, so a scroll kept cannot\n  hide which part the panel speaks of. Another model starts clean.\n*/\nexport class PanelMemory {\n  private kept = new Map<string, { top: number; open: boolean[] }>()\n  private restoreFor?: string\n\n  /** `root` is where the properties panel is drawn: the editor's render root. */\n  constructor(private readonly root: () => ParentNode) {}\n\n  private panel() {\n    return this.root().querySelector<HTMLElement>('div[panel]')\n  }\n\n  private foldsOf(panel: HTMLElement): HTMLDetailsElement[] {\n    const folds = [...panel.querySelectorAll('details')]\n    for (const inner of panel.querySelectorAll('figure-links')) folds.push(...(inner.shadowRoot?.querySelectorAll('details') ?? []))\n    return folds\n  }\n\n  /** Another model: nothing kept. */\n  clear() {\n    this.kept.clear()\n  }\n\n  /** The selection moves from `was` to `now` ('' is the model): the panel as `was` left it is kept, `now`'s put back after the update. */\n  leave(was: string, now: string) {\n    const panel = this.panel()\n    if (panel) this.kept.set(was || '@model', { top: panel.scrollTop, open: this.foldsOf(panel).map(d => d.open) })\n    this.restoreFor = now || '@model'\n  }\n\n  /** After the update: the panel of the part chosen as it was left, while that part is still the one chosen. */\n  restore(selected: () => string) {\n    if (this.restoreFor === undefined) return\n    const key = this.restoreFor\n    this.restoreFor = undefined\n    /*\n      Put back as soon as the links have drawn, before any click can come: the updates are microtasks. Put back a\n      frame later, it closed a fold opened by a click in that frame (2026-10-11, the row on a bench under load).\n    */\n    const panel = this.panel()\n    if (panel)\n      void Promise.all([...panel.querySelectorAll<HTMLElement & { updateComplete?: Promise<unknown> }>('figure-links')].map(el => el.updateComplete)).then(() => {\n        if ((selected() || '@model') !== key) return\n        const kept = this.kept.get(key)\n        if (kept) this.foldsOf(panel).forEach((fold, i) => i < kept.open.length && (fold.open = kept.open[i]!))\n        panel.scrollTop = kept?.top ?? 0\n      })\n  }\n}\n"]}

package/dist-client/modeller/product-session.d.ts

@@ -310,6 +310,8 @@ export declare function createFigureProductSession(store: FigureProductStore): {
         palette: Record<string, string>;
     };
     edit(edit: FigurePartEdit): {
+        made?: string[] | undefined;
+        removal?: import("@hatiolab/figure-model").RemovalNotice | undefined;
         context: null;
         name: null;
         fields: never[];
@@ -322,34 +324,8 @@ export declare function createFigureProductSession(store: FigureProductStore): {
         palette?: undefined;
         asset?: undefined;
     } | {
-        context: string;
-        name: string;
-        revision: number;
-        dirty: boolean;
-        canUndo: boolean;
-        canRedo: boolean;
-        fields: Array<import("@hatiolab/figure-model").FigureAsset["document"]["model"]["inputs"][number] & {
-            value: number;
-        }>;
-        readonly asset: import("@hatiolab/figure-model").FigureAsset;
-        geometry: import("@hatiolab/figure-model").FigureAssetGeometry[];
-        bindings: import("@hatiolab/figure-model").FigureEvaluatedBinding[];
-        palette: Record<string, string>;
-    } | {
-        removal: import("@hatiolab/figure-model").RemovalNotice;
-        context: null;
-        name: null;
-        fields: never[];
-        geometry: never[];
-        bindings: never[];
-        dirty: false;
-        revision: null;
-        canUndo?: undefined;
-        canRedo?: undefined;
-        palette?: undefined;
-        asset?: undefined;
-    } | {
-        removal: import("@hatiolab/figure-model").RemovalNotice;
+        made?: string[] | undefined;
+        removal?: import("@hatiolab/figure-model").RemovalNotice | undefined;
         context: string;
         name: string;
         revision: number;

package/dist-client/modeller/refusal-teller.d.ts

@@ -0,0 +1,36 @@
+import type { PropertyValues } from 'lit';
+import type { FigureAuthoringAction } from '@hatiolab/figure-model';
+import type { FigureProductSession } from './product-session.js';
+/** The same link offered again with the size range narrowed, after a link the declared range could not hold. */
+export type Retry = {
+    label: string;
+    action?: FigureAuthoringAction;
+    run?: () => void;
+};
+/** What the teller reads of the editor, and what it asks of it. */
+export interface RefusalHost {
+    session(): FigureProductSession | undefined;
+    error(): string;
+    notice(): string;
+    retry(): Retry | undefined;
+    /** Said as the editor's refusal. */
+    refuse(message: string): void;
+    /** A narrowed link, confirmed: run as the editor runs a command. */
+    command(action: FigureAuthoringAction): void;
+}
+/**
+ * Refusals and notices go to the app's shared surfaces, as every screen's do (user, 2026-09-27: 「왜 모두가 사용하는
+ * notification 오류 표현 방법을 사용하지 않고」 · 「혹은 oxprompt 에서 확인하고 진행하던지」). A refusal with a way on --
+ * delete and fit the space again, narrow the range -- asks in the app's prompt and goes on when confirmed; any
+ * other refusal is the app's notification, which stays until it is closed.
+ */
+export declare class RefusalTeller {
+    private readonly of;
+    private toldViewError;
+    constructor(of: RefusalHost);
+    /** After the editor's update: what changed in its refusal and notice, and the session's own error, said once. */
+    tell(changed: PropertyValues): void;
+    askClipLoss(error: unknown, again: () => void): boolean;
+    private confirmClipLoss;
+    private ask;
+}

package/dist-client/modeller/refusal-teller.js

@@ -0,0 +1,81 @@
+import { i18next } from '@operato/i18n';
+import { notify } from '@operato/layout';
+import { OxPrompt } from '@operato/popup';
+import { clipLossOf } from './refusals.js';
+/**
+ * Refusals and notices go to the app's shared surfaces, as every screen's do (user, 2026-09-27: 「왜 모두가 사용하는
+ * notification 오류 표현 방법을 사용하지 않고」 · 「혹은 oxprompt 에서 확인하고 진행하던지」). A refusal with a way on --
+ * delete and fit the space again, narrow the range -- asks in the app's prompt and goes on when confirmed; any
+ * other refusal is the app's notification, which stays until it is closed.
+ */
+export class RefusalTeller {
+    constructor(of) {
+        this.of = of;
+        this.toldViewError = '';
+    }
+    /** After the editor's update: what changed in its refusal and notice, and the session's own error, said once. */
+    tell(changed) {
+        const error = this.of.error();
+        if (changed.has('error') && error) {
+            const retry = this.of.retry();
+            if (retry)
+                this.ask(error, retry);
+            else
+                notify({ level: 'error', message: error });
+        }
+        const notice = this.of.notice();
+        if (changed.has('notice') && notice)
+            notify({ level: 'info', message: notice });
+        const viewError = this.of.session()?.read()?.error ?? '';
+        if (viewError && viewError !== this.toldViewError)
+            notify({ level: 'error', message: viewError });
+        this.toldViewError = viewError;
+    }
+    /*
+      An edit that would stop clips is refused by figure-model with the clips named (CLIPS_DROPPED). The person is told
+      which, and why, before anything is written; agreed, the same edit is made again letting exactly those go, as one
+      step undo brings back (designer 2026-09-27).
+    */
+    askClipLoss(error, again) {
+        const clips = clipLossOf(error);
+        if (!clips)
+            return false;
+        /* The consent is for this edit, on this figure as it is now: held with it while the person reads. */
+        const session = this.of.session();
+        const { context, revision } = session.read();
+        void this.confirmClipLoss(clips, again, { session, context: context, revision: revision });
+        return true;
+    }
+    async confirmClipLoss(clips, again, asked) {
+        const agreed = await OxPrompt.open({
+            type: 'warning',
+            text: i18next.t('figure.text.clips-would-go', { clips: clips.map(c => i18next.t(`figure.text.clip-${c.why}`, { clip: c.clip })).join(', ') }),
+            confirmButton: { text: i18next.t('figure.button.let-clips-go') },
+            cancelButton: { text: i18next.t('figure.button.keep-editing') }
+        });
+        if (!agreed)
+            return;
+        /* Changed while the person read -- another figure, or an edit in between: the consent was not for this; nothing is applied. */
+        const now = this.of.session() === asked.session ? asked.session.read() : undefined;
+        if (!now || now.context !== asked.context || now.revision !== asked.revision) {
+            this.of.refuse(i18next.t('figure.text.clips-consent-stale'));
+            return;
+        }
+        asked.session.withConsent({ dropClips: clips.map(c => c.id), context: asked.context, revision: asked.revision }, again);
+    }
+    async ask(message, retry) {
+        const agreed = await OxPrompt.open({
+            type: 'question',
+            text: message,
+            confirmButton: { text: retry.label },
+            cancelButton: { text: i18next.t('figure.button.keep-editing') }
+        });
+        if (!agreed)
+            return;
+        if (retry.run)
+            retry.run();
+        else
+            this.of.command(retry.action);
+    }
+}
+//# sourceMappingURL=refusal-teller.js.map

package/dist-client/modeller/refusal-teller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"refusal-teller.js","sourceRoot":"","sources":["../../client/modeller/refusal-teller.ts"],"names":[],"mappings":"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","sourcesContent":["import type { PropertyValues } from 'lit'\nimport { i18next } from '@operato/i18n'\nimport { notify } from '@operato/layout'\nimport { OxPrompt } from '@operato/popup'\nimport type { FigureAuthoringAction, FigureClipLoss } from '@hatiolab/figure-model'\nimport type { FigureProductSession } from './product-session.js'\nimport { clipLossOf } from './refusals.js'\n\n/** The same link offered again with the size range narrowed, after a link the declared range could not hold. */\nexport type Retry = { label: string; action?: FigureAuthoringAction; run?: () => void }\n\n/** What the teller reads of the editor, and what it asks of it. */\nexport interface RefusalHost {\n  session(): FigureProductSession | undefined\n  error(): string\n  notice(): string\n  retry(): Retry | undefined\n  /** Said as the editor's refusal. */\n  refuse(message: string): void\n  /** A narrowed link, confirmed: run as the editor runs a command. */\n  command(action: FigureAuthoringAction): void\n}\n\n/**\n * Refusals and notices go to the app's shared surfaces, as every screen's do (user, 2026-09-27: 「왜 모두가 사용하는\n * notification 오류 표현 방법을 사용하지 않고」 · 「혹은 oxprompt 에서 확인하고 진행하던지」). A refusal with a way on --\n * delete and fit the space again, narrow the range -- asks in the app's prompt and goes on when confirmed; any\n * other refusal is the app's notification, which stays until it is closed.\n */\nexport class RefusalTeller {\n  private toldViewError = ''\n\n  constructor(private readonly of: RefusalHost) {}\n\n  /** After the editor's update: what changed in its refusal and notice, and the session's own error, said once. */\n  tell(changed: PropertyValues) {\n    const error = this.of.error()\n    if (changed.has('error') && error) {\n      const retry = this.of.retry()\n      if (retry) this.ask(error, retry)\n      else notify({ level: 'error', message: error })\n    }\n    const notice = this.of.notice()\n    if (changed.has('notice') && notice) notify({ level: 'info', message: notice })\n    const viewError = this.of.session()?.read()?.error ?? ''\n    if (viewError && viewError !== this.toldViewError) notify({ level: 'error', message: viewError })\n    this.toldViewError = viewError\n  }\n\n  /*\n    An edit that would stop clips is refused by figure-model with the clips named (CLIPS_DROPPED). The person is told\n    which, and why, before anything is written; agreed, the same edit is made again letting exactly those go, as one\n    step undo brings back (designer 2026-09-27).\n  */\n  askClipLoss(error: unknown, again: () => void): boolean {\n    const clips = clipLossOf(error)\n    if (!clips) return false\n    /* The consent is for this edit, on this figure as it is now: held with it while the person reads. */\n    const session = this.of.session()!\n    const { context, revision } = session.read()\n    void this.confirmClipLoss(clips, again, { session, context: context!, revision: revision! })\n    return true\n  }\n\n  private async confirmClipLoss(clips: FigureClipLoss[], again: () => void, asked: { session: FigureProductSession; context: string; revision: number }) {\n    const agreed = await OxPrompt.open({\n      type: 'warning',\n      text: i18next.t('figure.text.clips-would-go', { clips: clips.map(c => i18next.t(`figure.text.clip-${c.why}`, { clip: c.clip })).join(', ') }),\n      confirmButton: { text: i18next.t('figure.button.let-clips-go') },\n      cancelButton: { text: i18next.t('figure.button.keep-editing') }\n    })\n    if (!agreed) return\n    /* Changed while the person read -- another figure, or an edit in between: the consent was not for this; nothing is applied. */\n    const now = this.of.session() === asked.session ? asked.session.read() : undefined\n    if (!now || now.context !== asked.context || now.revision !== asked.revision) {\n      this.of.refuse(i18next.t('figure.text.clips-consent-stale'))\n      return\n    }\n    asked.session.withConsent({ dropClips: clips.map(c => c.id), context: asked.context, revision: asked.revision }, again)\n  }\n\n  private async ask(message: string, retry: Retry) {\n    const agreed = await OxPrompt.open({\n      type: 'question',\n      text: message,\n      confirmButton: { text: retry.label },\n      cancelButton: { text: i18next.t('figure.button.keep-editing') }\n    })\n    if (!agreed) return\n    if (retry.run) retry.run()\n    else this.of.command(retry.action!)\n  }\n}\n"]}

package/dist-client/modeller/refusals.d.ts

@@ -1,3 +1,4 @@
+import { type FigureClipLoss, type FigureRefusalDetails } from '@hatiolab/figure-model';
 type Say = (key: string, params: Record<string, string>) => string;
 /** A size range the figure cannot be drawn over, or one that leaves out its own size, in words; nothing for any other refusal. */
 export declare function sizeRangeRefusalOf(error: unknown, say: Say): string | null;
@@ -19,6 +20,15 @@ export declare function narrowingRetryOf<A extends {
  * on the floor, when the figure is to hang on a wall), said in the author's words with the parts it names.
  */
 export declare function placementRefusalOf(error: unknown, say: Say): string | null;
+/** A refusal carried on in a record (an AI proposal's outcome) in figure-model's own shape: its code and details. */
+export interface FigureRefusalRecord {
+    code?: string;
+    details?: FigureRefusalDetails;
+}
+/** The record of a refusal: figure-model's code and details, copied as they are. */
+export declare function refusalRecordOf(error: unknown): FigureRefusalRecord;
+/** The clips an edit would stop, as figure-model named them (CLIPS_DROPPED) -- the person is asked before any go; nothing for any other refusal. */
+export declare function clipLossOf(error: unknown): FigureClipLoss[] | null;
 /** A part refused because the declared room reads it -- the one refusal deleting it with the room refitted answers. */
 export declare function inDeclaredRoom(error: unknown): boolean;
 /**
@@ -76,7 +86,8 @@ export declare function editRefusalOf(error: unknown, say: Say): string;
 export declare function inputRangeRefusalOf(error: unknown, say: Say): string | null;
 /**
  * A row past its limits: a pitch so fine it would hold more copies than a row takes, a row that would expand to more
- * bodies than a figure draws, or a number of copies outside what a row may have.
+ * bodies than a figure draws, a number of copies outside what a row may have or more than its length holds apart, a
+ * row inside a row along the same axis, or a part whose face something holds made into a row.
  */
 export declare function rowLimitRefusalOf(error: unknown, say: Say): string | null;
 /** A row's pitch under which the figure, at the length it is authored, would hold more copies than a row takes. */

package/dist-client/modeller/refusals.js

@@ -70,6 +70,15 @@ export function placementRefusalOf(error, say) {
         faces: misfit.takes.join(', ')
     });
 }
+/** The record of a refusal: figure-model's code and details, copied as they are. */
+export function refusalRecordOf(error) {
+    const { details } = (error ?? {});
+    return { code: codeOf(error), ...(details ? { details } : {}) };
+}
+/** The clips an edit would stop, as figure-model named them (CLIPS_DROPPED) -- the person is asked before any go; nothing for any other refusal. */
+export function clipLossOf(error) {
+    return codeOf(error) === 'CLIPS_DROPPED' ? (detailsOf(error, 'clips-dropped')?.clips ?? []) : null;
+}
 /** A part refused because the declared room reads it -- the one refusal deleting it with the room refitted answers. */
 export function inDeclaredRoom(error) {
     return codeOf(error) === 'PART_REFERENCED' && !!detailsOf(error, 'in-declared-space');
@@ -105,6 +114,10 @@ export function placedRefusalOf(error, part, say) {
 }
 /** A part name refused: not a name, already used, or another part is named under the part. The rule is the kernel's. */
 export function partNameRefusalOf(error, say) {
+    /* A new part named as one already is: the same sentence as a part renamed so. */
+    const takenId = detailsOf(error, 'part-id-taken');
+    if (takenId)
+        return say('figure.text.part-name-taken', { name: takenId.part });
     if (codeOf(error) !== 'PART_ID')
         return null;
     const invalid = detailsOf(error, 'name-invalid');
@@ -249,7 +262,8 @@ export function inputRangeRefusalOf(error, say) {
 }
 /**
  * A row past its limits: a pitch so fine it would hold more copies than a row takes, a row that would expand to more
- * bodies than a figure draws, or a number of copies outside what a row may have.
+ * bodies than a figure draws, a number of copies outside what a row may have or more than its length holds apart, a
+ * row inside a row along the same axis, or a part whose face something holds made into a row.
  */
 export function rowLimitRefusalOf(error, say) {
     const copies = detailsOf(error, 'copies-over-limit');
@@ -261,8 +275,19 @@ export function rowLimitRefusalOf(error, say) {
     const count = detailsOf(error, 'row-copies-out-of-range');
     if (count)
         return say('figure.text.row-copies-out-of-range', { count: count.count.toLocaleString(), min: String(count.min), max: String(count.max) });
+    const fit = detailsOf(error, 'row-does-not-fit');
+    if (fit)
+        return say('figure.text.row-does-not-fit', { count: fit.count.toLocaleString(), length: mmOf(fit.length), extent: mmOf(fit.extent) });
+    const axis = detailsOf(error, 'row-same-axis');
+    if (axis)
+        return say('figure.text.row-same-axis', { part: axis.part, outer: axis.outer, axis: axis.axis.toUpperCase() });
+    const held = detailsOf(error, 'surface-on-row');
+    if (held)
+        return say(`figure.text.row-face-held-${heldByOf(held.at)}`, { part: held.part });
     return null;
 }
+/* What holds a face, from the contract path the kernel names it by: the slot layout, a place, the footprint. */
+const heldByOf = (at) => (at.startsWith('slotLayout') ? 'slot-layout' : at.startsWith('bindings') ? 'place' : at.startsWith('occupancy') ? 'footprint' : 'other');
 /** A row's pitch under which the figure, at the length it is authored, would hold more copies than a row takes. */
 export function repeatPitchRefusalOf(error, say) {
     if (codeOf(error) !== 'INPUT_RANGE')