@things-factory/figure-ui 10.1.74 → 10.1.75

package/client/modeller/v3-editor.ts

@@ -31,7 +31,7 @@ import type { V3PaletteKind, V3PartRow } from './figure-v3-parts.js'
 import { paletteRecipe } from './v3-palette.js'
 import type { FigureV3Canvas } from './v3-canvas.js'
 import { nudgeOf } from './v3-stage-model.js'
-import { inDeclaredRoom, inputRangeRefusalOf, narrowingRetryOf, partRefusalOf, placementRefusalOf, sizeRangeRefusalOf } from './v3-refusals.js'
+import { editRefusalOf, inDeclaredRoom, inputRangeRefusalOf, narrowingRetryOf, partRefusalOf, placementRefusalOf, recipeRefusalOf, removalNoticeOf, sizeRangeRefusalOf } from './v3-refusals.js'
 import type { V3RenderPart } from './v3-renderer.js'
 import type { V3BudgetLine } from './v3-maturity.js'
 import { instanceRangeOf, instanceRangeToDeclare, proportionToFollow, rangeDiffers, rangeWith, turnsAboutAJoint, valueNow } from './v3-links.js'
@@ -402,14 +402,23 @@ export class FigureV3Editor extends LitElement {
     this.renderRoot.querySelector<FigureV3Canvas>('figure-v3-canvas')?.gizmo(mode)
     this.gizmoMode = this.gizmoMode === mode ? undefined : mode
   }
+  /**
+   * A refusal no particular sentence knows: figure-model's code said as a refusal, never its English; any other error
+   * (the network, the server) as it came.
+   */
+  private said(error: unknown): string {
+    return (error as { code?: string })?.code ? editRefusalOf(error, (key, params) => i18next.t(key, params)) : error instanceof Error ? error.message : String(error)
+  }
   private run(action: () => unknown) {
     try {
       action()
       this.error = ''
+      /* The next step stands on its own: what the last removal let go of is no longer the news. */
+      this.notice = ''
       this.changed()
     } catch (error) {
       const say = (key: string, params: Record<string, string>) => i18next.t(key, params)
-      this.error = sizeRangeRefusalOf(error, say) ?? inputRangeRefusalOf(error, say) ?? (error instanceof Error ? error.message : String(error))
+      this.error = sizeRangeRefusalOf(error, say) ?? inputRangeRefusalOf(error, say) ?? this.said(error)
     } finally {
       /* Committed or refused, the value in hand is gone: the figure as it stands is drawn again. */
       this.live = NOTHING_LIVE
@@ -475,7 +484,7 @@ export class FigureV3Editor extends LitElement {
       await promise
       this.error = ''
     } catch (error) {
-      this.error = error instanceof Error ? error.message : String(error)
+      this.error = this.said(error)
     } finally {
       this.changed()
     }
@@ -508,13 +517,15 @@ export class FigureV3Editor extends LitElement {
   private removePart(id: string, refitRoom = false) {
     this.retry = undefined
     try {
-      this.session!.edit({ kind: 'remove-part', target: id, ...(refitRoom ? { refitRoom: true } : {}) })
+      const view = this.session!.edit({ kind: 'remove-part', target: id, ...(refitRoom ? { refitRoom: true } : {}) }) as { removal?: Parameters<typeof removalNoticeOf>[0] }
       this.error = ''
+      /* What else the removal let go of, named (chief architect, 2026-09-27); undo brings it back. */
+      this.notice = removalNoticeOf(view.removal, (key, params) => i18next.t(key, params)) ?? ''
       if (this.selected === id) this.selected = ''
       this.changed()
     } catch (error) {
       /* The refusal a person meets most: another part stands on this one or follows its size. Said in their words. */
-      this.error = partRefusalOf(error, id, (key, params) => i18next.t(key, params)) ?? (error instanceof Error ? error.message : String(error))
+      this.error = partRefusalOf(error, id, (key, params) => i18next.t(key, params)) ?? this.said(error)
       /* In the declared room only: the way on is to delete it and fit the room to the parts left, in one step. */
       if (!refitRoom && inDeclaredRoom(error)) this.retry = { label: i18next.t('figure.button.remove-and-refit-room', { part: id }), run: () => this.removePart(id, true) }
     }
@@ -546,7 +557,7 @@ export class FigureV3Editor extends LitElement {
       this.error = ''
       this.changed()
     } catch (error) {
-      this.recipeError = error instanceof Error ? error.message : String(error)
+      this.recipeError = recipeRefusalOf(error, (key, params) => i18next.t(key, params)) ?? this.said(error)
     }
   }
   /** The design values of the asset being edited. */
@@ -630,7 +641,7 @@ export class FigureV3Editor extends LitElement {
         ? i18next.t('figure.text.gizmo-joint-places', { part: partLabelOf(id) })
         : /is fastened to/.test(message)
           ? i18next.t('figure.text.gizmo-fastening-places', { part: partLabelOf(id) })
-          : message
+          : this.said(error)
       this.requestUpdate()
     }
   }
@@ -803,7 +814,7 @@ export class FigureV3Editor extends LitElement {
             ? i18next.t('figure.text.fasten-would-loop')
             : sizeRangeRefusalOf(error, (key, params) => i18next.t(key, params)) ??
               placementRefusalOf(error, (key, params) => i18next.t(key, params)) ??
-              (error instanceof Error ? error.message : String(error))
+              this.said(error)
     }
   }
   private changeField(field: { id: string; unit: V3InputChange['unit']; role?: string }, event: Event) {
@@ -1095,7 +1106,7 @@ export class FigureV3Editor extends LitElement {
         this.error = ''
         this.changed()
       } catch (error) {
-        this.error = error instanceof Error ? error.message : String(error)
+        this.error = this.said(error)
       }
     }
     return html`<div public-pitch>
@@ -1152,7 +1163,7 @@ export class FigureV3Editor extends LitElement {
       this.error =
         code === 'INPUT_RANGE' && found
           ? i18next.t('figure.text.repeat-pitch-too-small', { length: Number(found[1]).toLocaleString(), min: found[2], limit: found[3] })
-          : message
+          : this.said(error)
     }
   }
   /** Choose a part, from the list, the canvas or a place row. A figure-level tab gives way to the part's properties. */

package/client/modeller/v3-refusals.ts

@@ -39,11 +39,6 @@ export function narrowingRetryOf<A extends { kind: string }>(action: A, error: u
   }
 }
 
-/**
- * Why a part cannot be deleted, in the author's words -- figure-model names four reasons (PART_REFERENCED): parts hang
- * from it, the declared space holds it, another part follows its size or place, or a joint moves with its joint. One
- * sentence for all of them told the author to undo a link that was not there (the architect's workbench, 2026-09-25).
- */
 /**
  * A placement refused because a part is fastened to the mounting plane by a face the new plane does not take (a bottom
  * on the floor, when the figure is to hang on a wall), said in the author's words with the parts it names.
@@ -61,20 +56,74 @@ export function inDeclaredRoom(error: unknown): boolean {
   return (error as { code?: string })?.code === 'PART_REFERENCED' && /is in the space the figure declares/.test(error instanceof Error ? error.message : String(error))
 }
 
+/**
+ * Why a part cannot be deleted, in the author's words. Since the chief architect's ruling of 2026-09-27 a part that
+ * holds others, leads a motion or is followed goes, and what depended on it is let go of (`removalNoticeOf`); what is
+ * left is the declared space (with a way on: fit it again) and a row -- one laid along the part, or hanging in its row.
+ */
 export function partRefusalOf(error: unknown, part: string, say: Say): string | null {
-  if ((error as { code?: string })?.code !== 'PART_REFERENCED') return null
-  /* figure-model's sentence after its code and path: 「PART_REFERENCED: top: top holds leg-2, lamp; …」. */
+  const code = (error as { code?: string })?.code
+  if (code !== 'PART_REFERENCED' && code !== 'PART_ROW') return null
+  /* figure-model's sentence after its code and path: 「PART_ROW: bed: roller is a row laid along bed; …」. */
   const message = (error instanceof Error ? error.message : String(error)).replace(/^[A-Z_]+: [^:]+: /, '')
-  const holds = / holds (.+?); take (?:them|it) off first/.exec(message)
-  if (holds) return say('figure.text.part-holds-others', { part, others: holds[1]! })
   if (/is in the space the figure declares/.test(message)) return say('figure.text.part-in-declared-space', { part })
-  const moves = /^(.+?) (?:moves|move) with /.exec(message)
-  if (moves) return say('figure.text.part-is-led', { part, others: moves[1]! })
-  const follows = /^(.+?) (?:follows|follow) .+'s size or place/.exec(message)
-  if (follows) return say('figure.text.part-is-followed', { part, others: follows[1]! })
+  const along = /^(.+?) (?:is a row|are rows) laid along /.exec(message)
+  if (along) return say('figure.text.part-row-along', { part, rows: along[1]! })
+  const carried = /^(.+?) hangs? in the row /.exec(message)
+  if (carried) return say('figure.text.part-row-carries', { part, others: carried[1]! })
   return say('figure.text.part-is-referenced', { part })
 }
 
+/** What removing a part let go of (figure-model's `RemovalNotice`), said in one line, or nothing when it let go of nothing. */
+export function removalNoticeOf(
+  notice:
+    | {
+        released: Array<{ part: string; control?: string }>
+        fixed: Array<{ part: string }>
+        controls: Array<{ part: string; control: string; min: number; max: number }>
+        mountingFace?: boolean
+        bindings?: Array<{ id: string; label?: string }>
+      }
+    | undefined,
+  say: Say
+): string | null {
+  if (!notice) return null
+  const number = (v: number) => v.toLocaleString(undefined, { maximumFractionDigits: 3 })
+  const lines: string[] = []
+  const still = notice.released.filter(r => !r.control).map(r => r.part)
+  if (still.length) lines.push(say('figure.text.removal-released', { parts: still.join(', ') }))
+  for (const r of notice.released.filter(r => r.control)) lines.push(say('figure.text.removal-released-motion', { part: r.part, control: r.control! }))
+  for (const c of notice.controls) lines.push(say('figure.text.removal-own-control', { part: c.part, control: c.control, min: number(c.min), max: number(c.max) }))
+  const fixed = [...new Set(notice.fixed.map(f => f.part))]
+  if (fixed.length) lines.push(say('figure.text.removal-fixed', { parts: fixed.join(', ') }))
+  if (notice.bindings?.length) lines.push(say('figure.text.removal-bindings', { places: notice.bindings.map(b => b.label ?? b.id).join(', ') }))
+  if (notice.mountingFace) lines.push(say('figure.text.removal-mounting-face', {}))
+  return lines.length ? lines.join(' ') : null
+}
+
+/**
+ * A recipe refused at one of its steps: which step, and why -- the particular sentence when there is one (a size
+ * range, a value's range, a placement), otherwise the kernel's code. The kernel says 「steps[2]: attach: …」.
+ */
+export function recipeRefusalOf(error: unknown, say: Say): string | null {
+  const step = /^steps\[(\d+)\]$/.exec((error as { path?: string })?.path ?? '')
+  if (!step) return null
+  const why = sizeRangeRefusalOf(error, say) ?? inputRangeRefusalOf(error, say) ?? placementRefusalOf(error, say)
+  return say('figure.text.recipe-step-refused', { step: String(Number(step[1]) + 1), why: why ?? '', code: (error as { code?: string })?.code ?? '' })
+}
+
+/**
+ * A refusal no sentence above knows, said as a refusal with its code -- never the kernel's English on the screen (the
+ * duplicate of a row's part showed 「EDIT_TARGET: … not a repeated template」, 2026-09-27). The figure's node limit
+ * is said with its number.
+ */
+export function editRefusalOf(error: unknown, say: Say): string {
+  const code = (error as { code?: string })?.code
+  const message = error instanceof Error ? error.message : String(error)
+  if (code === 'DOCUMENT_LIMIT') return say('figure.text.edit-refused-node-limit', { max: /maximum (\d+) nodes/.exec(message)?.[1] ?? '' })
+  return say('figure.text.edit-refused', { code: code ?? '' })
+}
+
 /**
  * A value outside the range its input declares, with the range and the value given -- the kernel says
  * 「size.x: 6021100 outside [300,1200]」. The figure's own size is named by its axis; any other input by its range only.

package/dist-client/modeller/v3-clips.d.ts

@@ -34,6 +34,6 @@ export declare const trackEdit: (clip: Clip, track: ClipTrack, patch?: Partial<P
     state: string;
     clip: string;
     keys: ClipKey[];
-    loop: "hold" | "wrap";
+    loop: "wrap" | "hold";
     interpolation: "linear" | "step";
 };

package/dist-client/modeller/v3-editor.d.ts

@@ -79,6 +79,11 @@ export declare class FigureV3Editor extends LitElement {
     protected willUpdate(_changed: PropertyValues): void;
     /** The scene toggles: the mode already shown takes the gizmo away. */
     private useGizmo;
+    /**
+     * A refusal no particular sentence knows: figure-model's code said as a refusal, never its English; any other error
+     * (the network, the server) as it came.
+     */
+    private said;
     private run;
     /** What the canvas draws: the figure with the value in hand when there is one, and without the parts hidden on the workbench. */
     private drawnParts;

package/dist-client/modeller/v3-editor.js

@@ -27,7 +27,7 @@ import { ScrollbarStyles } from '@operato/styles';
 import { alignChanges, boxOf, canMirror, mirrorChanges } from './v3-align.js';
 import { paletteRecipe } from './v3-palette.js';
 import { nudgeOf } from './v3-stage-model.js';
-import { inDeclaredRoom, inputRangeRefusalOf, narrowingRetryOf, partRefusalOf, placementRefusalOf, sizeRangeRefusalOf } from './v3-refusals.js';
+import { editRefusalOf, inDeclaredRoom, inputRangeRefusalOf, narrowingRetryOf, partRefusalOf, placementRefusalOf, recipeRefusalOf, removalNoticeOf, sizeRangeRefusalOf } from './v3-refusals.js';
 import { instanceRangeOf, instanceRangeToDeclare, proportionToFollow, rangeDiffers, rangeWith, turnsAboutAJoint, valueNow } from './v3-links.js';
 import { jointFanOf } from './v3-joint-fan.js';
 import { jointDragOf } from './v3-joint-drag.js';
@@ -376,15 +376,24 @@ let FigureV3Editor = class FigureV3Editor extends LitElement {
         this.renderRoot.querySelector('figure-v3-canvas')?.gizmo(mode);
         this.gizmoMode = this.gizmoMode === mode ? undefined : mode;
     }
+    /**
+     * A refusal no particular sentence knows: figure-model's code said as a refusal, never its English; any other error
+     * (the network, the server) as it came.
+     */
+    said(error) {
+        return error?.code ? editRefusalOf(error, (key, params) => i18next.t(key, params)) : error instanceof Error ? error.message : String(error);
+    }
     run(action) {
         try {
             action();
             this.error = '';
+            /* The next step stands on its own: what the last removal let go of is no longer the news. */
+            this.notice = '';
             this.changed();
         }
         catch (error) {
             const say = (key, params) => i18next.t(key, params);
-            this.error = sizeRangeRefusalOf(error, say) ?? inputRangeRefusalOf(error, say) ?? (error instanceof Error ? error.message : String(error));
+            this.error = sizeRangeRefusalOf(error, say) ?? inputRangeRefusalOf(error, say) ?? this.said(error);
         }
         finally {
             /* Committed or refused, the value in hand is gone: the figure as it stands is drawn again. */
@@ -456,7 +465,7 @@ let FigureV3Editor = class FigureV3Editor extends LitElement {
             this.error = '';
         }
         catch (error) {
-            this.error = error instanceof Error ? error.message : String(error);
+            this.error = this.said(error);
         }
         finally {
             this.changed();
@@ -492,15 +501,17 @@ let FigureV3Editor = class FigureV3Editor extends LitElement {
     removePart(id, refitRoom = false) {
         this.retry = undefined;
         try {
-            this.session.edit({ kind: 'remove-part', target: id, ...(refitRoom ? { refitRoom: true } : {}) });
+            const view = this.session.edit({ kind: 'remove-part', target: id, ...(refitRoom ? { refitRoom: true } : {}) });
             this.error = '';
+            /* What else the removal let go of, named (chief architect, 2026-09-27); undo brings it back. */
+            this.notice = removalNoticeOf(view.removal, (key, params) => i18next.t(key, params)) ?? '';
             if (this.selected === id)
                 this.selected = '';
             this.changed();
         }
         catch (error) {
             /* The refusal a person meets most: another part stands on this one or follows its size. Said in their words. */
-            this.error = partRefusalOf(error, id, (key, params) => i18next.t(key, params)) ?? (error instanceof Error ? error.message : String(error));
+            this.error = partRefusalOf(error, id, (key, params) => i18next.t(key, params)) ?? this.said(error);
             /* In the declared room only: the way on is to delete it and fit the room to the parts left, in one step. */
             if (!refitRoom && inDeclaredRoom(error))
                 this.retry = { label: i18next.t('figure.button.remove-and-refit-room', { part: id }), run: () => this.removePart(id, true) };
@@ -536,7 +547,7 @@ let FigureV3Editor = class FigureV3Editor extends LitElement {
             this.changed();
         }
         catch (error) {
-            this.recipeError = error instanceof Error ? error.message : String(error);
+            this.recipeError = recipeRefusalOf(error, (key, params) => i18next.t(key, params)) ?? this.said(error);
         }
     }
     /** The design values of the asset being edited. */
@@ -629,7 +640,7 @@ let FigureV3Editor = class FigureV3Editor extends LitElement {
                 ? i18next.t('figure.text.gizmo-joint-places', { part: partLabelOf(id) })
                 : /is fastened to/.test(message)
                     ? i18next.t('figure.text.gizmo-fastening-places', { part: partLabelOf(id) })
-                    : message;
+                    : this.said(error);
             this.requestUpdate();
         }
     }
@@ -810,7 +821,7 @@ let FigureV3Editor = class FigureV3Editor extends LitElement {
                         ? i18next.t('figure.text.fasten-would-loop')
                         : sizeRangeRefusalOf(error, (key, params) => i18next.t(key, params)) ??
                             placementRefusalOf(error, (key, params) => i18next.t(key, params)) ??
-                            (error instanceof Error ? error.message : String(error));
+                            this.said(error);
         }
     }
     changeField(field, event) {
@@ -1104,7 +1115,7 @@ let FigureV3Editor = class FigureV3Editor extends LitElement {
                 this.changed();
             }
             catch (error) {
-                this.error = error instanceof Error ? error.message : String(error);
+                this.error = this.said(error);
             }
         };
         return html `<div public-pitch>
@@ -1162,7 +1173,7 @@ let FigureV3Editor = class FigureV3Editor extends LitElement {
             this.error =
                 code === 'INPUT_RANGE' && found
                     ? i18next.t('figure.text.repeat-pitch-too-small', { length: Number(found[1]).toLocaleString(), min: found[2], limit: found[3] })
-                    : message;
+                    : this.said(error);
         }
     }
     /** Choose a part, from the list, the canvas or a place row. A figure-level tab gives way to the part's properties. */