@things-factory/figure-ui 10.1.168 → 10.1.170

package/client/modeller/links.ts

@@ -134,7 +134,9 @@ export function partSummaryOf(
     if (f.of === 'own') continue
     if (f.of === 'instance') {
       key = f.times === 1 ? 'figure.text.summary-size-follows' : 'figure.text.summary-size-share'
-      params = { pct: pct(f.times), whole: say(`figure.label.measure-${f.axis}`) }
+      /* A measure following the figure's own size on its own axis says no measure word, so the axes that do so are one
+         sentence -- 「너비 · 높이 · 깊이는 도형 크기를 따라 바뀝니다」, not three (user 2026-10-16). */
+      params = f.times === 1 && f.axis === axis && !f.plus ? {} : { pct: pct(f.times), whole: say(`figure.label.measure-${f.axis}`) }
       if (f.plus) (key = key + '-plus'), (params.plus = String(f.plus))
     } else if (f.of === 'part') {
       const other = say(`figure.label.measure-${f.axis}`)
@@ -675,6 +677,25 @@ export function motionFormRefusalOf(m: MotionForm, follow: string): 'multiplier'
 }
 
 /** The select's value for what a dimension follows now. */
+/**
+ * What a measure that is not its own follows, in the words of the choice that set it -- 「도형 X 크기에 비례」, 「bed의 X」 --
+ * where the row once said only 「다른 규칙에 연결됨」 (user 2026-10-16: which rule?).
+ */
+export function followWordsOf(follow: Follow, say: (key: string, params?: Record<string, string>) => string): string {
+  switch (follow.of) {
+    case 'own':
+      return say('figure.label.follows-nothing')
+    case 'instance':
+      return say(follow.times === 1 ? 'figure.label.follows-instance' : 'figure.label.follows-instance-share', { axis: follow.axis.toUpperCase() })
+    case 'part':
+      return say('figure.label.follows-part-axis', { part: follow.part, axis: follow.axis.toUpperCase() })
+    case 'input':
+      return follow.input
+    case 'expression':
+      return say('figure.label.follows-expression')
+  }
+}
+
 export function choiceOf(follow: Follow): string {
   switch (follow.of) {
     case 'own':

package/client/modeller/modeller-keys.ts

@@ -35,6 +35,12 @@ export class ModellerKeys implements ReactiveController {
     if (!this.of.taking()) return
     const canvas = this.of.scene()
     const path = e.composedPath()
+    /*
+      A key for something open over the work -- a group's 「⋯」 menu, the view or the history, a question -- is that
+      thing's: heard here first, Esc deselected the part and was kept from the menu, which then could not be closed by
+      the keyboard (2026-10-16).
+    */
+    if (path.some(node => node instanceof Element && (node.localName.startsWith('ox-popup') || node.getAttribute('role') === 'dialog'))) return
     const action = keyActionOf(
       {
         key: e.key,

package/client/modeller/preview-size.ts

@@ -0,0 +1,32 @@
+import { figureRowOf, FIGURE_INSTANCE_SIZE_INPUTS, type FigureAsset } from '@hatiolab/figure-model'
+
+type Say = (key: string, params?: Record<string, string>) => string
+
+/**
+ * What the preview's one figure is at the size being tried, in a line the author reads beside it -- its size in
+ * millimetres and how many copies each row holds there (first 15 minutes, 2026-10-16: the author stretched the conveyor
+ * and could not tell that the rollers grew in number). The counts are figure-model's reading of what the figure draws at
+ * that size (`figureRowOf`), never worked out again here.
+ */
+export function previewSizeWordsOf(asset: FigureAsset, size: { x: number; y: number; z: number }, say: Say): string {
+  const mm = (v: number) => Math.round(v).toLocaleString()
+  const words = [`${mm(size.x)} × ${mm(size.y)} × ${mm(size.z)} mm`]
+  for (const row of rowCountsAt(asset, size)) words.push(say('figure.text.preview-copies', { part: row.part, n: String(row.count) }))
+  return words.join(' · ')
+}
+
+/** Each row's count at the size given, in the order the parts are listed. */
+export function rowCountsAt(asset: FigureAsset, size: { x: number; y: number; z: number }): Array<{ part: string; count: number }> {
+  const values = { [FIGURE_INSTANCE_SIZE_INPUTS.x]: size.x, [FIGURE_INSTANCE_SIZE_INPUTS.y]: size.y, [FIGURE_INSTANCE_SIZE_INPUTS.z]: size.z }
+  const rows: Array<{ part: string; count: number }> = []
+  for (const look of asset.appearance) {
+    let reading: ReturnType<typeof figureRowOf>
+    try {
+      reading = figureRowOf(asset, look.target, values)
+    } catch {
+      reading = undefined
+    }
+    if (reading) rows.push({ part: reading.part, count: reading.count })
+  }
+  return rows
+}

package/client/modeller/product-session.ts

@@ -14,6 +14,15 @@ import {
 } from '@hatiolab/figure-model'
 
 /** Consent to let clips go, and the figure and version it was given on. */
+
+/**
+ * A request the session refuses, with its code: a screen says it from the code (`sessionRefusalOf`), never from the
+ * message, which stays for logs (ADR-0054; figure audit 2026-10-16 N6 -- an AI card put the message in its note).
+ */
+function refusal(code: string, message: string): Error & { code: string } {
+  return Object.assign(Error(message), { code })
+}
+
 export interface FigureClipConsentFor extends FigureClipConsent {
   context: string
   revision: number
@@ -110,13 +119,18 @@ export function createFigureProductSession(store: FigureProductStore) {
     }
     return { dropClips: given.dropClips }
   }
-  function writable() {
+  /* A model open to read: the draft is read during a save too -- the dock reads it when the person sends (audit N5). */
+  function readable() {
     const view = workspace.read()
-    if (loading || error || !view.context || view.revision === null) throw Error('먼저 모델을 정상적으로 열어 주세요.')
-    // Serializing writes also makes create retries safe: no second create while the first is pending.
-    if (saving) throw Error('저장이 끝난 뒤 편집해 주세요.')
+    if (loading || error || !view.context || view.revision === null) throw refusal('SESSION_NOT_OPEN', '먼저 모델을 정상적으로 열어 주세요.')
     return { context: view.context, expectedRevision: view.revision, origin: 'ui' as const }
   }
+  function writable() {
+    const open = readable()
+    // Serializing writes also makes create retries safe: no second create while the first is pending.
+    if (saving) throw refusal('SESSION_SAVING', '저장이 끝난 뒤 편집해 주세요.')
+    return open
+  }
   function clear() {
     workspace.close({ discardDesignChanges: true })
     id = undefined
@@ -179,7 +193,7 @@ export function createFigureProductSession(store: FigureProductStore) {
       const control = writable()
       // AI must supply the context AND revision captured when it started. Never substitute current values.
       if (origin === 'ai' && (context === undefined || expectedRevision === undefined))
-        throw Error('AI 편집에는 요청 당시의 모델 문맥과 리비전이 필요합니다.')
+        throw refusal('SESSION_VERSION_MISSING', 'AI 편집에는 요청 당시의 모델 문맥과 리비전이 필요합니다.')
       return tracked('do', () =>
         workspace.apply({
           ...control,
@@ -206,8 +220,8 @@ export function createFigureProductSession(store: FigureProductStore) {
      * new figure not yet touched -- one being made is the person's, and keeps its own.
      */
     createUnder(key: string) {
-      if (id || workspace.read().dirty) throw Error('손대지 않은 새 모델에만 쓸 수 있습니다.')
-      if (!/^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(key)) throw Error('제안 식별자가 올바르지 않습니다.')
+      if (id || workspace.read().dirty) throw refusal('SESSION_NEW_FIGURE_TOUCHED', '손대지 않은 새 모델에만 쓸 수 있습니다.')
+      if (!/^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(key)) throw refusal('SESSION_PROPOSAL_KEY', '제안 식별자가 올바르지 않습니다.')
       creationId = key
     },
     /** The AI proposals whose steps are in the model now, each once. */
@@ -229,7 +243,7 @@ export function createFigureProductSession(store: FigureProductStore) {
     /** What a command would do, on a copy (ADR-0097 §5.5): nothing is written, and the answer names its version. */
     previewCommand(action: FigureAuthoringAction) {
       const view = workspace.read()
-      if (loading || error || !view.context || view.revision === null) throw Error('먼저 모델을 정상적으로 열어 주세요.')
+      if (loading || error || !view.context || view.revision === null) throw refusal('SESSION_NOT_OPEN', '먼저 모델을 정상적으로 열어 주세요.')
       return workspace.previewCommand({ context: view.context, action })
     },
     /** One authoring command — what a person means, not a graph edit — as one step of the same history. */
@@ -256,7 +270,7 @@ export function createFigureProductSession(store: FigureProductStore) {
       return tracked('redo', () => workspace.redo(writable()))
     },
     source() {
-      const { context } = writable()
+      const { context } = readable()
       return workspace.export({ context }).text
     },
     /**

package/client/modeller/refusals.ts

@@ -226,8 +226,22 @@ function documentLimitRefusalOf(error: unknown, say: Say): string | null {
  * 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 modeller session's own refusals (`product-session.ts`), by their code. Nothing for any other refusal. */
+const SESSION_REFUSALS: Record<string, string> = {
+  SESSION_NOT_OPEN: 'figure.text.session-not-open',
+  SESSION_SAVING: 'figure.text.session-saving',
+  SESSION_VERSION_MISSING: 'figure.text.session-version-missing',
+  SESSION_NEW_FIGURE_TOUCHED: 'figure.text.session-new-figure-touched',
+  SESSION_PROPOSAL_KEY: 'figure.text.session-proposal-key'
+}
+export function sessionRefusalOf(error: unknown, say: Say): string | null {
+  const key = SESSION_REFUSALS[codeOf(error) ?? '']
+  return key ? say(key, {}) : null
+}
+
 export function editRefusalOf(error: unknown, say: Say): string {
   return (
+    sessionRefusalOf(error, say) ??
     sizeRangeRefusalOf(error, say) ??
     inputRangeRefusalOf(error, say) ??
     repeatPitchRefusalOf(error, say) ??

package/client/modeller/stage-model.ts

@@ -191,6 +191,17 @@ export function boardFor(parts: readonly FigureRenderPart[], at: Board & { depth
   }
 }
 
+/**
+ * Whether the figure's reach has changed so far since the view was last fitted that the camera should fit it again:
+ * more than twice, or less than half, on any axis (first 15 minutes, 2026-10-16: a 100 mm box typed to 3000 × 800 × 600
+ * put the camera inside it, and the author saw grey until pressing 「화면에 맞추기」). A drag that nudges a part does not
+ * move the camera.
+ */
+export function needsRefit(fitted: (Board & { depth: number }) | undefined, now: Board & { depth: number }): boolean {
+  if (!fitted) return false
+  return (['width', 'height', 'depth'] as const).some(key => now[key] > fitted[key] * 2 || now[key] < fitted[key] / 2)
+}
+
 /**
  * A body's placement as its fields would read it: its origin in mm and its turn in degrees (rigid@1's X·Y·Z order, as
  * `componentOf` reads it). For a field a rule sets -- a fastened part's height, a turn its joint fixes -- the screen shows

package/client/pages/figure-modeller-page.ts

@@ -6,11 +6,13 @@ import { modellerPathOf } from '../modeller/modeller-route.js'
 import { createFigureProductSession } from '../modeller/product-session.js'
 import { figureProductStore } from '../graphql/store.js'
 import { i18next } from '@operato/i18n'
-import { fetchFigure, fetchFigureTypeNames, fetchProposalOutcome, updateFigure } from '../graphql/index.js'
+import { fetchFigure, fetchFigureTypeNames, updateFigure } from '../graphql/index.js'
+import { figureProposalOutcome } from '../figure-assistant.js'
 import { availableRecipes, recipeGuide } from '../modeller/recipe-source.js'
 import type { RecipeTemplate } from '../modeller/recipes.js'
 import { occupancyFromParts } from '../modeller/occupancy.js'
 import type { FigureAuthoringAction } from '@hatiolab/figure-model'
+import type { FigureGateFinding } from '../types.js'
 import '../modeller/editor.js'
 import '@material/web/icon/icon.js'
 import '../modeller/figure-history-panel.js'
@@ -30,7 +32,7 @@ import {
 import type { FirstSave } from '../modeller/first-save.js'
 import { typeOf } from '../modeller/first-save.js'
 import { editRefusalOf } from '../modeller/refusals.js'
-import { proposalOutcomeFrom, takeFigureOffer, takePendingNewFigure } from '../modeller/ai-proposal.js'
+import { askingToLeave, takeFigureOffer, takePendingNewFigure } from '../modeller/ai-proposal.js'
 
 /**
  * The product page has exactly one authoritative workspace for UI and AI input transactions.
@@ -118,6 +120,8 @@ export class FigureModellerPage extends PageView {
   @state() private typeError = ''
   /** Why a command from the side did nothing. Shown beside the tabs — the editor stays, since nothing in it was lost. */
   @state() private commandError = ''
+  /** What the verdict says blocks release now, handed to the editor's bar. */
+  @state() private releaseBlockers: FigureGateFinding[] = []
   /** The verdict's count, handed to the editor's verdict tab. */
   @state() private instances?: number
   @state() private budget?: FigureBudgetLine
@@ -152,8 +156,7 @@ export class FigureModellerPage extends PageView {
       detail: () => (this.session.read().dirty ? i18next.t('figure.text.unsaved-changes') : ''),
       anchor: () => ({ anchorType: 'figure', anchorId: id }),
       /* The card's "check the result": the server's record, never the dock's memory; nothing is applied again. */
-      proposalOutcome: async (proposalKey: string) =>
-        proposalOutcomeFrom(await fetchProposalOutcome(proposalKey), (key, params) => i18next.t(key, params)),
+      proposalOutcome: figureProposalOutcome,
       hostContext: () => ({
         surface: 'figure-modeller',
         editorMode: this.session.read().id ? 'existing' : 'new',
@@ -389,6 +392,8 @@ export class FigureModellerPage extends PageView {
       The shell asks this while the edited model is still on screen. The app's own prompt, as every operato screen
       asks -- not the browser's confirm box (user, 2026-09-24).
     */
+    /* A new figure the dock is opening waits for this answer, not against a clock (audit N4). */
+    const answered = askingToLeave()
     this.discardApproved = !!(await OxPrompt.open({
       type: 'warning',
       title: i18next.t('figure.text.unsaved-changes'),
@@ -396,6 +401,7 @@ export class FigureModellerPage extends PageView {
       confirmButton: { text: i18next.t('figure.button.leave-without-saving') },
       cancelButton: { text: i18next.t('figure.button.keep-editing') }
     }))
+    answered?.(this.discardApproved)
     return this.discardApproved
   }
   async pageUpdated(changes: Record<string, unknown>, lifecycle: { resourceId?: string }) {
@@ -471,6 +477,8 @@ export class FigureModellerPage extends PageView {
         the rail matches the page name and marks "new figure" while an existing one is being edited.
       */
       menu: view.id ? 'figure-list' : undefined,
+      /* The canvas needs the width: the rail folds while the modeller is open and comes back as it was on leaving. */
+      rail: 'collapsed',
       actions: [],
       /*
         No heading line: the canvas is what this page is for, and the name is already in the properties' first section
@@ -484,7 +492,7 @@ export class FigureModellerPage extends PageView {
     if (this.error) return html`<p role="alert" class="error">${this.error}</p>`
     const view = this.session.read()
     /* A new figure's third way to start: the app's assistant dock, with a request put in its input for the author to finish and send (B, U04). */
-    return html`<figure-editor .session=${this.session} .releaseState=${this.row} .templates=${this.templates} .guideOf=${this.guideOf} .thumbnailOf=${this.thumbnailOf} .firstSave=${this.askFirstSave} .revision=${this.revision} .instances=${this.instances} .budget=${this.budget} aiDraft @ask-ai-draft=${() => askAssistant({ draft: i18next.t('figure.text.ai-draft-request') })} @changed=${this.changed}>
+    return html`<figure-editor .session=${this.session} .releaseState=${this.row} .releaseBlockers=${this.releaseBlockers} .templates=${this.templates} .guideOf=${this.guideOf} .thumbnailOf=${this.thumbnailOf} .firstSave=${this.askFirstSave} .revision=${this.revision} .instances=${this.instances} .budget=${this.budget} aiDraft @ask-ai-draft=${() => askAssistant({ draft: i18next.t('figure.text.ai-draft-request') })} @changed=${this.changed}>
       ${this.commandError ? html`<p slot="notice" fit-error role="alert">${this.commandError}</p>` : ''}
       <figure-properties
         slot="figure"
@@ -496,7 +504,7 @@ export class FigureModellerPage extends PageView {
         @catalog=${this.onCatalog}
       >
         <label slot="type" type-field>
-            <span>${i18next.t('figure.label.figure-type')}</span>
+            <span>${i18next.t('figure.label.figure-identifier')}</span>
             ${this.row.version > 0
               ? html`<code>${this.row.type}</code><small>${i18next.t('figure.text.type-name-cannot-change')}</small>`
               : html`<input
@@ -517,6 +525,7 @@ export class FigureModellerPage extends PageView {
           this.budget = event.detail.budget
         }}
         @fit-base-to-parts=${this.fitToParts}
+        @release-verdict=${(event: CustomEvent<{ blocking: FigureGateFinding[] }>) => (this.releaseBlockers = event.detail.blocking)}
       ></figure-verdict>
       <figure-history-panel
         slot="history"

package/dist-client/figure-assistant.d.ts

@@ -1 +1,7 @@
 export declare const FIGURE_CANDIDATE_TOOL = "proposeFigureCandidate";
+/**
+ * The dock's "check the result" of a figure proposal, on every screen that offers its card: what the server recorded of
+ * its save (ADR-0097 §5.6 item 5). The modeller asks it, and so does an app's home where a new figure's card is made --
+ * there it was missing, and a card cut off by a reload stayed "no answer" for good (figure audit 2026-10-16 N8).
+ */
+export declare function figureProposalOutcome(proposalKey: string): Promise<import("./modeller/ai-proposal.js").FigureProposalOutcome | undefined>;

package/dist-client/figure-assistant.js

@@ -11,8 +11,16 @@ import { navigate } from '@operato/shell';
 import { registerProposalHandler } from '@things-factory/ai-assistant/dist-client/index.js';
 import { fetchProposalOutcome } from './graphql/index.js';
 import { modellerPathOf } from './modeller/modeller-route.js';
-import { pendNewFigure, runFigureProposal } from './modeller/ai-proposal.js';
+import { pendNewFigure, proposalOutcomeFrom, runFigureProposal } from './modeller/ai-proposal.js';
 export const FIGURE_CANDIDATE_TOOL = 'proposeFigureCandidate';
+/**
+ * The dock's "check the result" of a figure proposal, on every screen that offers its card: what the server recorded of
+ * its save (ADR-0097 §5.6 item 5). The modeller asks it, and so does an app's home where a new figure's card is made --
+ * there it was missing, and a card cut off by a reload stayed "no answer" for good (figure audit 2026-10-16 N8).
+ */
+export async function figureProposalOutcome(proposalKey) {
+    return proposalOutcomeFrom(await fetchProposalOutcome(proposalKey), (key, params) => i18next.t(key, params));
+}
 registerProposalHandler(FIGURE_CANDIDATE_TOOL, async (proposal, context) => {
     const outcome = await runFigureProposal(proposal, {
         offer(detail) {

package/dist-client/figure-assistant.js.map

@@ -1 +1 @@
-{"version":3,"file":"figure-assistant.js","sourceRoot":"","sources":["../client/figure-assistant.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AACzC,OAAO,EAAE,uBAAuB,EAAE,MAAM,mDAAmD,CAAA;AAE3F,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAA;AAC7D,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAA0B,MAAM,2BAA2B,CAAA;AAEpG,MAAM,CAAC,MAAM,qBAAqB,GAAG,wBAAwB,CAAA;AAE7D,uBAAuB,CAAC,qBAAqB,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE;IACzE,MAAM,OAAO,GAAG,MAAM,iBAAiB,CACrC,QAAQ,EACR;QACE,KAAK,CAAC,MAAyB;YAC7B,MAAM,CAAC,aAAa,CAAC,IAAI,WAAW,CAAC,cAAc,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,CAAA;YACjE,OAAO,MAAM,CAAA;QACf,CAAC;QACD,OAAO,CAAC,KAAK,EAAE,GAAG;YAChB,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,EAAE,GAAG,CAAC,CAAA;YACxC,QAAQ,CAAC,cAAc,EAAE,CAAC,CAAA;YAC1B,OAAO,MAAM,CAAA;QACf,CAAC;QACD,SAAS,EAAE,oBAAoB;QAC/B,SAAS,CAAC,EAAE;YACV,QAAQ,CAAC,cAAc,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAA;QAClC,CAAC;KACF,EACD,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,MAAM,CAAC,CACxC,CAAA;IACD,IAAI,OAAO,CAAC,IAAI;QAAE,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,KAAK,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;IACjG,OAAO,OAAO,CAAA;AAChB,CAAC,CAAC,CAAA","sourcesContent":["/*\n * What the AI dock does with a figure proposal - figure-ui declares it because figure-service declares the tool\n * (`proposeFigureCandidate`, design/ai/shared-dock.md §4).\n *\n * A proposal is a list of the modeller's own commands (ADR-0094). Running it applies them in the modeller as one step\n * of its history: a revision on the figure open there, at the version the model saw; a new figure on a new figure the\n * modeller opens. The outcome is said in words on every branch (`ai-proposal.ts`).\n */\nimport { i18next } from '@operato/i18n'\nimport { navigate } from '@operato/shell'\nimport { registerProposalHandler } from '@things-factory/ai-assistant/dist-client/index.js'\n\nimport { fetchProposalOutcome } from './graphql/index.js'\nimport { modellerPathOf } from './modeller/modeller-route.js'\nimport { pendNewFigure, runFigureProposal, type FigureApplyDetail } from './modeller/ai-proposal.js'\n\nexport const FIGURE_CANDIDATE_TOOL = 'proposeFigureCandidate'\n\nregisterProposalHandler(FIGURE_CANDIDATE_TOOL, async (proposal, context) => {\n  const outcome = await runFigureProposal(\n    proposal,\n    {\n      offer(detail: FigureApplyDetail) {\n        window.dispatchEvent(new CustomEvent('figure-apply', { detail }))\n        return detail\n      },\n      openNew(steps, key) {\n        const opened = pendNewFigure(steps, key)\n        navigate(modellerPathOf())\n        return opened\n      },\n      savedInto: fetchProposalOutcome,\n      openSaved(id) {\n        navigate(modellerPathOf({ id }))\n      }\n    },\n    (key, params) => i18next.t(key, params)\n  )\n  if (outcome.note) context.notify(outcome.verdict === 'accepted' ? 'info' : 'error', outcome.note)\n  return outcome\n})\n"]}
+{"version":3,"file":"figure-assistant.js","sourceRoot":"","sources":["../client/figure-assistant.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AACzC,OAAO,EAAE,uBAAuB,EAAE,MAAM,mDAAmD,CAAA;AAE3F,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAA;AAC7D,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,iBAAiB,EAA0B,MAAM,2BAA2B,CAAA;AAEzH,MAAM,CAAC,MAAM,qBAAqB,GAAG,wBAAwB,CAAA;AAE7D;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,WAAmB;IAC7D,OAAO,mBAAmB,CAAC,MAAM,oBAAoB,CAAC,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAA;AAC9G,CAAC;AAED,uBAAuB,CAAC,qBAAqB,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE;IACzE,MAAM,OAAO,GAAG,MAAM,iBAAiB,CACrC,QAAQ,EACR;QACE,KAAK,CAAC,MAAyB;YAC7B,MAAM,CAAC,aAAa,CAAC,IAAI,WAAW,CAAC,cAAc,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,CAAA;YACjE,OAAO,MAAM,CAAA;QACf,CAAC;QACD,OAAO,CAAC,KAAK,EAAE,GAAG;YAChB,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,EAAE,GAAG,CAAC,CAAA;YACxC,QAAQ,CAAC,cAAc,EAAE,CAAC,CAAA;YAC1B,OAAO,MAAM,CAAA;QACf,CAAC;QACD,SAAS,EAAE,oBAAoB;QAC/B,SAAS,CAAC,EAAE;YACV,QAAQ,CAAC,cAAc,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAA;QAClC,CAAC;KACF,EACD,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,MAAM,CAAC,CACxC,CAAA;IACD,IAAI,OAAO,CAAC,IAAI;QAAE,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,KAAK,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;IACjG,OAAO,OAAO,CAAA;AAChB,CAAC,CAAC,CAAA","sourcesContent":["/*\n * What the AI dock does with a figure proposal - figure-ui declares it because figure-service declares the tool\n * (`proposeFigureCandidate`, design/ai/shared-dock.md §4).\n *\n * A proposal is a list of the modeller's own commands (ADR-0094). Running it applies them in the modeller as one step\n * of its history: a revision on the figure open there, at the version the model saw; a new figure on a new figure the\n * modeller opens. The outcome is said in words on every branch (`ai-proposal.ts`).\n */\nimport { i18next } from '@operato/i18n'\nimport { navigate } from '@operato/shell'\nimport { registerProposalHandler } from '@things-factory/ai-assistant/dist-client/index.js'\n\nimport { fetchProposalOutcome } from './graphql/index.js'\nimport { modellerPathOf } from './modeller/modeller-route.js'\nimport { pendNewFigure, proposalOutcomeFrom, runFigureProposal, type FigureApplyDetail } from './modeller/ai-proposal.js'\n\nexport const FIGURE_CANDIDATE_TOOL = 'proposeFigureCandidate'\n\n/**\n * The dock's \"check the result\" of a figure proposal, on every screen that offers its card: what the server recorded of\n * its save (ADR-0097 §5.6 item 5). The modeller asks it, and so does an app's home where a new figure's card is made --\n * there it was missing, and a card cut off by a reload stayed \"no answer\" for good (figure audit 2026-10-16 N8).\n */\nexport async function figureProposalOutcome(proposalKey: string) {\n  return proposalOutcomeFrom(await fetchProposalOutcome(proposalKey), (key, params) => i18next.t(key, params))\n}\n\nregisterProposalHandler(FIGURE_CANDIDATE_TOOL, async (proposal, context) => {\n  const outcome = await runFigureProposal(\n    proposal,\n    {\n      offer(detail: FigureApplyDetail) {\n        window.dispatchEvent(new CustomEvent('figure-apply', { detail }))\n        return detail\n      },\n      openNew(steps, key) {\n        const opened = pendNewFigure(steps, key)\n        navigate(modellerPathOf())\n        return opened\n      },\n      savedInto: fetchProposalOutcome,\n      openSaved(id) {\n        navigate(modellerPathOf({ id }))\n      }\n    },\n    (key, params) => i18next.t(key, params)\n  )\n  if (outcome.note) context.notify(outcome.verdict === 'accepted' ? 'info' : 'error', outcome.note)\n  return outcome\n})\n"]}

package/dist-client/modeller/affected-parts.d.ts

@@ -0,0 +1,6 @@
+/**
+ * The parts a release finding points at, by the author's names. The server's `at` lists the first word of each path it
+ * could not prove -- a part's name, or a section of the format such as 「occupancy」 -- and the screen showed it as it came
+ * (「occupancy · roller-row-1-roller」, user 2026-10-16). Only the figure's own part names are kept.
+ */
+export declare function affectedPartsOf(at: string, parts: readonly string[]): string[];

package/dist-client/modeller/affected-parts.js

@@ -0,0 +1,12 @@
+/**
+ * The parts a release finding points at, by the author's names. The server's `at` lists the first word of each path it
+ * could not prove -- a part's name, or a section of the format such as 「occupancy」 -- and the screen showed it as it came
+ * (「occupancy · roller-row-1-roller」, user 2026-10-16). Only the figure's own part names are kept.
+ */
+export function affectedPartsOf(at, parts) {
+    return at
+        .split('·')
+        .map(word => word.trim())
+        .filter(word => parts.includes(word));
+}
+//# sourceMappingURL=affected-parts.js.map

package/dist-client/modeller/affected-parts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"affected-parts.js","sourceRoot":"","sources":["../../client/modeller/affected-parts.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,EAAU,EAAE,KAAwB;IAClE,OAAO,EAAE;SACN,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;SACxB,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAA;AACzC,CAAC","sourcesContent":["/**\n * The parts a release finding points at, by the author's names. The server's `at` lists the first word of each path it\n * could not prove -- a part's name, or a section of the format such as 「occupancy」 -- and the screen showed it as it came\n * (「occupancy · roller-row-1-roller」, user 2026-10-16). Only the figure's own part names are kept.\n */\nexport function affectedPartsOf(at: string, parts: readonly string[]): string[] {\n  return at\n    .split('·')\n    .map(word => word.trim())\n    .filter(word => parts.includes(word))\n}\n"]}

package/dist-client/modeller/ai-proposal.d.ts

@@ -19,6 +19,8 @@ export interface FigureApplyDetail extends FigureRefusalRecord {
     key?: string;
     steps: FigureProposalStep[];
     create: boolean;
+    /** The figure a revision was made for: the one the model read. */
+    figureId?: string;
     context?: string;
     revision?: number;
     applied?: boolean;
@@ -72,18 +74,26 @@ export declare function takeFigureOffer(session: FigureProductSession, detail: F
     say: Say;
 }): boolean;
 export declare function runFigureProposal(card: FigureProposalCard, target: FigureProposalTarget, say: Say): Promise<FigureProposalOutcome>;
+type Settle = (result: {
+    applied: boolean;
+    error?: string;
+    code?: string;
+}) => void;
 export declare function pendNewFigure(steps: FigureProposalStep[], key?: string, ms?: number): Promise<{
     applied: boolean;
     error?: string;
     code?: string;
 }>;
+/**
+ * For a page about to ask the person whether to leave unsaved edits: the new figure waiting to open stops its clock
+ * while they answer -- an answer is no absent page (figure audit 2026-10-16 N4). Give it the answer: leaving runs the
+ * clock again for the page that opens; staying says now that it was not opened. Nothing waiting: undefined.
+ */
+export declare function askingToLeave(): ((leaving: boolean) => void) | undefined;
 /** For the page, on a new figure it has just started: the steps waiting for it, and where to say how it went. */
 export declare function takePendingNewFigure(): {
     steps: FigureProposalStep[];
     key?: string;
-    settle: (result: {
-        applied: boolean;
-        error?: string;
-        code?: string;
-    }) => void;
+    settle: Settle;
 } | undefined;
+export {};

package/dist-client/modeller/ai-proposal.js

@@ -1,4 +1,4 @@
-import { clipLossOf, refusalRecordOf } from './refusals.js';
+import { clipLossOf, editRefusalOf, refusalRecordOf } from './refusals.js';
 /**
  * The dock's "check the result" (ADR-0097 §5.6 item 5): what the server recorded of a proposal. Saved into figures:
  * accepted, named. Nothing recorded: not known -- applied and not saved yet, undone, or never taken -- so `undefined`,
@@ -25,7 +25,8 @@ function refused(refusal, say) {
             ? (error ?? '')
             : clips
                 ? say('figure.text.proposal-would-drop-clips', { clips: clips.map(c => c.clip).join(', ') })
-                : say('figure.text.proposal-refused', { reason: error ?? '' });
+                : /* A refusal with a code is said from it, as the modeller says an edit it refuses; never its message (audit N6). */
+                    say('figure.text.proposal-refused', { reason: code ? editRefusalOf(refusal, (key, params) => say(key, params)) : (error ?? '') });
     return { verdict: 'refused', errorCode: code ?? 'refused', note };
 }
 /**
@@ -38,6 +39,13 @@ export function takeFigureOffer(session, detail, { onSavedFigure, say }) {
     const view = session.read();
     if (detail.create && onSavedFigure)
         return false;
+    /*
+      A revision is for the figure the model read; with another open it is left untaken, and the handler says it needs that
+      figure open. The version is no proof of the figure: two figures opened in two page loads stood at the same one
+      (figure audit 2026-10-16 N3).
+    */
+    if (!detail.create && typeof detail.figureId === 'string' && detail.figureId !== (view.id ?? view.creationId))
+        return false;
     if (detail.create && view.dirty) {
         /* A new figure already being made is the person's; a proposal does not go on top of it or replace it. */
         detail.applied = false;
@@ -71,7 +79,7 @@ export function takeFigureOffer(session, detail, { onSavedFigure, say }) {
 export async function runFigureProposal(card, target, say) {
     const steps = card?.steps;
     if (!Array.isArray(steps) || !steps.length)
-        return { verdict: 'unavailable', errorCode: 'no-steps' };
+        return { verdict: 'unavailable', errorCode: 'no-steps', note: say('figure.text.proposal-empty') };
     const create = card.create === true;
     /*
       A new figure's proposal already saved into a figure is not made again: that figure is opened (ADR-0061 decision 3,
@@ -89,7 +97,7 @@ export async function runFigureProposal(card, target, say) {
         applied: steps.length,
         note: say('figure.text.proposal-applied', { n: String(steps.length) })
     });
-    const detail = target.offer({ key: card.key, steps, create, context: card.context, revision: card.revision });
+    const detail = target.offer({ key: card.key, steps, create, figureId: create ? undefined : card.figureId, context: card.context, revision: card.revision });
     if (detail.applied)
         return accepted();
     if (detail.applied === false)
@@ -104,15 +112,12 @@ export async function runFigureProposal(card, target, say) {
         ? { verdict: 'unavailable', errorCode: 'not-opened', note: say('figure.text.proposal-not-opened') }
         : refused(opened, say);
 }
-/*
-  A new figure's proposal handed to the modeller page across a navigation: the handler leaves it here and opens the
-  modeller on a new figure; the page takes it once it has started that figure. Left untaken, it lapses -- a later new
-  figure must not receive steps nobody is waiting for.
-*/
 let pending;
 export function pendNewFigure(steps, key, ms = 10_000) {
     pending?.settle({ applied: false, code: 'not-opened' });
     return new Promise(resolve => {
+        let timer;
+        const lapse = () => mine.settle({ applied: false, code: 'not-opened' });
         const mine = {
             steps,
             key,
@@ -121,12 +126,36 @@ export function pendNewFigure(steps, key, ms = 10_000) {
                 if (pending === mine)
                     pending = undefined;
                 resolve(result);
+            },
+            hold: () => clearTimeout(timer),
+            resume: () => {
+                clearTimeout(timer);
+                timer = setTimeout(lapse, ms);
             }
         };
-        const timer = setTimeout(() => mine.settle({ applied: false, code: 'not-opened' }), ms);
+        mine.resume();
         pending = mine;
     });
 }
+/**
+ * For a page about to ask the person whether to leave unsaved edits: the new figure waiting to open stops its clock
+ * while they answer -- an answer is no absent page (figure audit 2026-10-16 N4). Give it the answer: leaving runs the
+ * clock again for the page that opens; staying says now that it was not opened. Nothing waiting: undefined.
+ */
+export function askingToLeave() {
+    const waiting = pending;
+    if (!waiting)
+        return undefined;
+    waiting.hold();
+    return leaving => {
+        if (pending !== waiting)
+            return;
+        if (leaving)
+            waiting.resume();
+        else
+            waiting.settle({ applied: false, code: 'not-opened' });
+    };
+}
 /** For the page, on a new figure it has just started: the steps waiting for it, and where to say how it went. */
 export function takePendingNewFigure() {
     const taken = pending;

package/dist-client/modeller/ai-proposal.js.map

@@ -1 +1 @@
-{"version":3,"file":"ai-proposal.js","sourceRoot":"","sources":["../../client/modeller/ai-proposal.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * An AI proposal reaching the modeller (ADR-0094). The dock's card carries the modeller's own commands; running it\n * applies them as one step of the modeller's history, undone whole, on the version the model saw. Nothing half made\n * is applied, and every outcome is said: applied, refused with the reason, or not possible here.\n *\n * Kept free of Lit, i18n and the shell so node tests read it directly; the handler and the page pass in what they own.\n */\nimport type { FigureProposalStep } from '@hatiolab/figure-model'\nimport type { FigureProductSession } from './product-session.js'\nimport { clipLossOf, refusalRecordOf, type FigureRefusalRecord } from './refusals.js'\n\n/** What the card carries, as `proposeFigureCandidate` returned it. */\nexport interface FigureProposalCard {\n  /** The proposal's own name, given by the tool: a save records it, a new figure made from it is created under it. */\n  key?: string\n  steps?: FigureProposalStep[]\n  create?: boolean\n  figureId?: string\n  context?: string\n  revision?: number\n}\n\n/**\n * The `figure-apply` event's detail. The page that takes it sets `applied`, and when refused `error` and the refusal in\n * figure-model's shape (`code`, `details`, the `clips` it would stop).\n */\nexport interface FigureApplyDetail extends FigureRefusalRecord {\n  key?: string\n  steps: FigureProposalStep[]\n  create: boolean\n  context?: string\n  revision?: number\n  applied?: boolean\n  error?: string\n}\n\nexport type Say = (key: string, params?: Record<string, string>) => string\n\nexport interface FigureProposalTarget {\n  /** Offers the proposal to a modeller on screen. It comes back untouched when none took it. */\n  offer(detail: FigureApplyDetail): FigureApplyDetail\n  /** Opens a new figure in the modeller and applies the steps there; resolves once the page has, or has not. */\n  openNew(steps: FigureProposalStep[], key?: string): Promise<{ applied: boolean; error?: string; code?: string }>\n  /** The figures the server recorded a save of this proposal into (`figureProposalOutcome`), first saved first. */\n  savedInto(key: string): Promise<ReadonlyArray<{ figureId: string; type?: string; name?: string }>>\n  /** Opens a saved figure in the modeller. */\n  openSaved(figureId: string): void\n}\n\nexport interface FigureProposalOutcome {\n  verdict: 'accepted' | 'refused' | 'unavailable'\n  errorCode?: string\n  applied?: number\n  note?: string\n}\n\n/**\n * The dock's \"check the result\" (ADR-0097 §5.6 item 5): what the server recorded of a proposal. Saved into figures:\n * accepted, named. Nothing recorded: not known -- applied and not saved yet, undone, or never taken -- so `undefined`,\n * which the dock keeps as \"not known\" and never turns into a refusal. Nothing is run again.\n */\nexport function proposalOutcomeFrom(saved: ReadonlyArray<{ figureId: string; type?: string; name?: string }>, say: Say): FigureProposalOutcome | undefined {\n  if (!saved.length) return undefined\n  const names = saved.map(f => f.name || f.type || f.figureId).join(', ')\n  return { verdict: 'accepted', note: say('figure.text.proposal-saved-into', { names }) }\n}\n\n/** The workspace refuses a request made on another version; said as what happened, not as the kernel's code. */\nconst STALE = new Set(['REVISION_CONFLICT', 'CONTEXT_CONFLICT'])\n\nfunction refused(refusal: FigureRefusalRecord & { error?: string }, say: Say): FigureProposalOutcome {\n  const { code, error } = refusal\n  const clips = clipLossOf(refusal)\n  /*\n    A proposal that would stop clips is refused whole; nobody but the person may agree to that, and a proposal is not\n    asked about -- the person edits by hand if they mean it (designer 2026-09-27).\n  */\n  const note =\n    code && STALE.has(code)\n      ? say('figure.text.proposal-stale')\n      : code === 'NEW_FIGURE_UNSAVED'\n        ? (error ?? '')\n        : clips\n          ? say('figure.text.proposal-would-drop-clips', { clips: clips.map(c => c.clip).join(', ') })\n          : say('figure.text.proposal-refused', { reason: error ?? '' })\n  return { verdict: 'refused', errorCode: code ?? 'refused', note }\n}\n\n/**\n * The modeller page's way of taking an offer from the dock (`figure-apply`): input changes, or a proposal's commands\n * as one step (ADR-0094). A revision is applied on the version the model saw; a new figure's proposal only on a new\n * figure not yet touched, and a page on a saved figure leaves it untaken. Never with a consent to let clips go: a\n * proposal that would stop one is refused whole, the clips named (designer 2026-09-27). True when it was applied.\n */\nexport function takeFigureOffer(\n  session: FigureProductSession,\n  detail: FigureApplyDetail & { changes?: unknown },\n  { onSavedFigure, say }: { onSavedFigure: boolean; say: Say }\n): boolean {\n  const view = session.read()\n  if (detail.create && onSavedFigure) return false\n  if (detail.create && view.dirty) {\n    /* A new figure already being made is the person's; a proposal does not go on top of it or replace it. */\n    detail.applied = false\n    detail.code = 'NEW_FIGURE_UNSAVED'\n    detail.error = say('figure.text.proposal-new-figure-unsaved')\n    return false\n  }\n  try {\n    if (detail.create) {\n      /*\n        Taken on the new figure the modeller has open, whose conversation asked for it: the figure keeps its own creation\n        id, the anchor of that conversation (ADR-0061 decision 3, ruled 2026-10-16). One proposal stays one figure by the\n        save's record of it, which `runFigureProposal` reads before the card runs again.\n      */\n      session.applyProposal(detail.steps, view.revision!, view.context!, detail.key)\n    } else if (detail.steps) session.applyProposal(detail.steps, detail.revision!, detail.context!, detail.key)\n    else session.apply(detail.changes as never, 'ai', detail.revision, detail.context)\n    detail.applied = true\n    return true\n  } catch (error) {\n    detail.applied = false\n    Object.assign(detail, refusalRecordOf(error))\n    detail.error = error instanceof Error ? error.message : String(error)\n    return false\n  }\n}\n\nexport async function runFigureProposal(card: FigureProposalCard, target: FigureProposalTarget, say: Say): Promise<FigureProposalOutcome> {\n  const steps = card?.steps\n  if (!Array.isArray(steps) || !steps.length) return { verdict: 'unavailable', errorCode: 'no-steps' }\n  const create = card.create === true\n  /*\n    A new figure's proposal already saved into a figure is not made again: that figure is opened (ADR-0061 decision 3,\n    ruled 2026-10-16). Taken on a new figure that kept its own creation id, the save's record is what says it was made.\n  */\n  if (create && card.key) {\n    const saved = await target.savedInto(card.key)\n    if (saved.length) {\n      target.openSaved(saved[0]!.figureId)\n      return proposalOutcomeFrom(saved, say)!\n    }\n  }\n  const accepted = (): FigureProposalOutcome => ({\n    verdict: 'accepted',\n    applied: steps.length,\n    note: say('figure.text.proposal-applied', { n: String(steps.length) })\n  })\n\n  const detail = target.offer({ key: card.key, steps, create, context: card.context, revision: card.revision })\n  if (detail.applied) return accepted()\n  if (detail.applied === false) return refused(detail, say)\n\n  /* A revision belongs to the figure the model saw; with that modeller gone there is nowhere true to apply it. */\n  if (!create) return { verdict: 'unavailable', errorCode: 'modeller-not-open', note: say('figure.text.proposal-needs-modeller') }\n\n  const opened = await target.openNew(steps, card.key)\n  if (opened.applied) return accepted()\n  return opened.code === 'not-opened'\n    ? { verdict: 'unavailable', errorCode: 'not-opened', note: say('figure.text.proposal-not-opened') }\n    : refused(opened, say)\n}\n\n/*\n  A new figure's proposal handed to the modeller page across a navigation: the handler leaves it here and opens the\n  modeller on a new figure; the page takes it once it has started that figure. Left untaken, it lapses -- a later new\n  figure must not receive steps nobody is waiting for.\n*/\nlet pending: { steps: FigureProposalStep[]; key?: string; settle: (result: { applied: boolean; error?: string; code?: string }) => void } | undefined\n\nexport function pendNewFigure(steps: FigureProposalStep[], key?: string, ms = 10_000): Promise<{ applied: boolean; error?: string; code?: string }> {\n  pending?.settle({ applied: false, code: 'not-opened' })\n  return new Promise(resolve => {\n    const mine = {\n      steps,\n      key,\n      settle: (result: { applied: boolean; error?: string; code?: string }) => {\n        clearTimeout(timer)\n        if (pending === mine) pending = undefined\n        resolve(result)\n      }\n    }\n    const timer = setTimeout(() => mine.settle({ applied: false, code: 'not-opened' }), ms)\n    pending = mine\n  })\n}\n\n/** For the page, on a new figure it has just started: the steps waiting for it, and where to say how it went. */\nexport function takePendingNewFigure():\n  | { steps: FigureProposalStep[]; key?: string; settle: (result: { applied: boolean; error?: string; code?: string }) => void }\n  | undefined {\n  const taken = pending\n  pending = undefined\n  return taken\n}\n"]}
+{"version":3,"file":"ai-proposal.js","sourceRoot":"","sources":["../../client/modeller/ai-proposal.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * An AI proposal reaching the modeller (ADR-0094). The dock's card carries the modeller's own commands; running it\n * applies them as one step of the modeller's history, undone whole, on the version the model saw. Nothing half made\n * is applied, and every outcome is said: applied, refused with the reason, or not possible here.\n *\n * Kept free of Lit, i18n and the shell so node tests read it directly; the handler and the page pass in what they own.\n */\nimport type { FigureProposalStep } from '@hatiolab/figure-model'\nimport type { FigureProductSession } from './product-session.js'\nimport { clipLossOf, editRefusalOf, refusalRecordOf, type FigureRefusalRecord } from './refusals.js'\n\n/** What the card carries, as `proposeFigureCandidate` returned it. */\nexport interface FigureProposalCard {\n  /** The proposal's own name, given by the tool: a save records it, a new figure made from it is created under it. */\n  key?: string\n  steps?: FigureProposalStep[]\n  create?: boolean\n  figureId?: string\n  context?: string\n  revision?: number\n}\n\n/**\n * The `figure-apply` event's detail. The page that takes it sets `applied`, and when refused `error` and the refusal in\n * figure-model's shape (`code`, `details`, the `clips` it would stop).\n */\nexport interface FigureApplyDetail extends FigureRefusalRecord {\n  key?: string\n  steps: FigureProposalStep[]\n  create: boolean\n  /** The figure a revision was made for: the one the model read. */\n  figureId?: string\n  context?: string\n  revision?: number\n  applied?: boolean\n  error?: string\n}\n\nexport type Say = (key: string, params?: Record<string, string>) => string\n\nexport interface FigureProposalTarget {\n  /** Offers the proposal to a modeller on screen. It comes back untouched when none took it. */\n  offer(detail: FigureApplyDetail): FigureApplyDetail\n  /** Opens a new figure in the modeller and applies the steps there; resolves once the page has, or has not. */\n  openNew(steps: FigureProposalStep[], key?: string): Promise<{ applied: boolean; error?: string; code?: string }>\n  /** The figures the server recorded a save of this proposal into (`figureProposalOutcome`), first saved first. */\n  savedInto(key: string): Promise<ReadonlyArray<{ figureId: string; type?: string; name?: string }>>\n  /** Opens a saved figure in the modeller. */\n  openSaved(figureId: string): void\n}\n\nexport interface FigureProposalOutcome {\n  verdict: 'accepted' | 'refused' | 'unavailable'\n  errorCode?: string\n  applied?: number\n  note?: string\n}\n\n/**\n * The dock's \"check the result\" (ADR-0097 §5.6 item 5): what the server recorded of a proposal. Saved into figures:\n * accepted, named. Nothing recorded: not known -- applied and not saved yet, undone, or never taken -- so `undefined`,\n * which the dock keeps as \"not known\" and never turns into a refusal. Nothing is run again.\n */\nexport function proposalOutcomeFrom(saved: ReadonlyArray<{ figureId: string; type?: string; name?: string }>, say: Say): FigureProposalOutcome | undefined {\n  if (!saved.length) return undefined\n  const names = saved.map(f => f.name || f.type || f.figureId).join(', ')\n  return { verdict: 'accepted', note: say('figure.text.proposal-saved-into', { names }) }\n}\n\n/** The workspace refuses a request made on another version; said as what happened, not as the kernel's code. */\nconst STALE = new Set(['REVISION_CONFLICT', 'CONTEXT_CONFLICT'])\n\nfunction refused(refusal: FigureRefusalRecord & { error?: string }, say: Say): FigureProposalOutcome {\n  const { code, error } = refusal\n  const clips = clipLossOf(refusal)\n  /*\n    A proposal that would stop clips is refused whole; nobody but the person may agree to that, and a proposal is not\n    asked about -- the person edits by hand if they mean it (designer 2026-09-27).\n  */\n  const note =\n    code && STALE.has(code)\n      ? say('figure.text.proposal-stale')\n      : code === 'NEW_FIGURE_UNSAVED'\n        ? (error ?? '')\n        : clips\n          ? say('figure.text.proposal-would-drop-clips', { clips: clips.map(c => c.clip).join(', ') })\n          : /* A refusal with a code is said from it, as the modeller says an edit it refuses; never its message (audit N6). */\n            say('figure.text.proposal-refused', { reason: code ? editRefusalOf(refusal, (key, params) => say(key, params)) : (error ?? '') })\n  return { verdict: 'refused', errorCode: code ?? 'refused', note }\n}\n\n/**\n * The modeller page's way of taking an offer from the dock (`figure-apply`): input changes, or a proposal's commands\n * as one step (ADR-0094). A revision is applied on the version the model saw; a new figure's proposal only on a new\n * figure not yet touched, and a page on a saved figure leaves it untaken. Never with a consent to let clips go: a\n * proposal that would stop one is refused whole, the clips named (designer 2026-09-27). True when it was applied.\n */\nexport function takeFigureOffer(\n  session: FigureProductSession,\n  detail: FigureApplyDetail & { changes?: unknown },\n  { onSavedFigure, say }: { onSavedFigure: boolean; say: Say }\n): boolean {\n  const view = session.read()\n  if (detail.create && onSavedFigure) return false\n  /*\n    A revision is for the figure the model read; with another open it is left untaken, and the handler says it needs that\n    figure open. The version is no proof of the figure: two figures opened in two page loads stood at the same one\n    (figure audit 2026-10-16 N3).\n  */\n  if (!detail.create && typeof detail.figureId === 'string' && detail.figureId !== (view.id ?? view.creationId)) return false\n  if (detail.create && view.dirty) {\n    /* A new figure already being made is the person's; a proposal does not go on top of it or replace it. */\n    detail.applied = false\n    detail.code = 'NEW_FIGURE_UNSAVED'\n    detail.error = say('figure.text.proposal-new-figure-unsaved')\n    return false\n  }\n  try {\n    if (detail.create) {\n      /*\n        Taken on the new figure the modeller has open, whose conversation asked for it: the figure keeps its own creation\n        id, the anchor of that conversation (ADR-0061 decision 3, ruled 2026-10-16). One proposal stays one figure by the\n        save's record of it, which `runFigureProposal` reads before the card runs again.\n      */\n      session.applyProposal(detail.steps, view.revision!, view.context!, detail.key)\n    } else if (detail.steps) session.applyProposal(detail.steps, detail.revision!, detail.context!, detail.key)\n    else session.apply(detail.changes as never, 'ai', detail.revision, detail.context)\n    detail.applied = true\n    return true\n  } catch (error) {\n    detail.applied = false\n    Object.assign(detail, refusalRecordOf(error))\n    detail.error = error instanceof Error ? error.message : String(error)\n    return false\n  }\n}\n\nexport async function runFigureProposal(card: FigureProposalCard, target: FigureProposalTarget, say: Say): Promise<FigureProposalOutcome> {\n  const steps = card?.steps\n  if (!Array.isArray(steps) || !steps.length) return { verdict: 'unavailable', errorCode: 'no-steps', note: say('figure.text.proposal-empty') }\n  const create = card.create === true\n  /*\n    A new figure's proposal already saved into a figure is not made again: that figure is opened (ADR-0061 decision 3,\n    ruled 2026-10-16). Taken on a new figure that kept its own creation id, the save's record is what says it was made.\n  */\n  if (create && card.key) {\n    const saved = await target.savedInto(card.key)\n    if (saved.length) {\n      target.openSaved(saved[0]!.figureId)\n      return proposalOutcomeFrom(saved, say)!\n    }\n  }\n  const accepted = (): FigureProposalOutcome => ({\n    verdict: 'accepted',\n    applied: steps.length,\n    note: say('figure.text.proposal-applied', { n: String(steps.length) })\n  })\n\n  const detail = target.offer({ key: card.key, steps, create, figureId: create ? undefined : card.figureId, context: card.context, revision: card.revision })\n  if (detail.applied) return accepted()\n  if (detail.applied === false) return refused(detail, say)\n\n  /* A revision belongs to the figure the model saw; with that modeller gone there is nowhere true to apply it. */\n  if (!create) return { verdict: 'unavailable', errorCode: 'modeller-not-open', note: say('figure.text.proposal-needs-modeller') }\n\n  const opened = await target.openNew(steps, card.key)\n  if (opened.applied) return accepted()\n  return opened.code === 'not-opened'\n    ? { verdict: 'unavailable', errorCode: 'not-opened', note: say('figure.text.proposal-not-opened') }\n    : refused(opened, say)\n}\n\n/*\n  A new figure's proposal handed to the modeller page across a navigation: the handler leaves it here and opens the\n  modeller on a new figure; the page takes it once it has started that figure. Left untaken, it lapses -- a later new\n  figure must not receive steps nobody is waiting for.\n*/\ntype Settle = (result: { applied: boolean; error?: string; code?: string }) => void\nlet pending: { steps: FigureProposalStep[]; key?: string; settle: Settle; hold(): void; resume(): void } | undefined\n\nexport function pendNewFigure(steps: FigureProposalStep[], key?: string, ms = 10_000): Promise<{ applied: boolean; error?: string; code?: string }> {\n  pending?.settle({ applied: false, code: 'not-opened' })\n  return new Promise(resolve => {\n    let timer: ReturnType<typeof setTimeout> | undefined\n    const lapse = () => mine.settle({ applied: false, code: 'not-opened' })\n    const mine = {\n      steps,\n      key,\n      settle: (result: { applied: boolean; error?: string; code?: string }) => {\n        clearTimeout(timer)\n        if (pending === mine) pending = undefined\n        resolve(result)\n      },\n      hold: () => clearTimeout(timer),\n      resume: () => {\n        clearTimeout(timer)\n        timer = setTimeout(lapse, ms)\n      }\n    }\n    mine.resume()\n    pending = mine\n  })\n}\n\n/**\n * For a page about to ask the person whether to leave unsaved edits: the new figure waiting to open stops its clock\n * while they answer -- an answer is no absent page (figure audit 2026-10-16 N4). Give it the answer: leaving runs the\n * clock again for the page that opens; staying says now that it was not opened. Nothing waiting: undefined.\n */\nexport function askingToLeave(): ((leaving: boolean) => void) | undefined {\n  const waiting = pending\n  if (!waiting) return undefined\n  waiting.hold()\n  return leaving => {\n    if (pending !== waiting) return\n    if (leaving) waiting.resume()\n    else waiting.settle({ applied: false, code: 'not-opened' })\n  }\n}\n\n/** For the page, on a new figure it has just started: the steps waiting for it, and where to say how it went. */\nexport function takePendingNewFigure(): { steps: FigureProposalStep[]; key?: string; settle: Settle } | undefined {\n  const taken = pending\n  pending = undefined\n  return taken\n}\n"]}

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

@@ -34,6 +34,9 @@ export declare class FigureCanvas extends LitElement {
     private stage;
     private scene?;
     private board?;
+    /** The figure's reach when the view was last fitted to it. */
+    private fittedFor?;
+    private refitTimer?;
     private standingFor?;
     private watcher?;
     /** Set while this canvas writes to components, so the scene's echo of it is not taken for a drag. */