@things-factory/figure-ui 10.1.79 → 10.1.82

package/client/modeller/figure-parts.ts

@@ -29,6 +29,11 @@ export interface FigurePartRow {
   invisible?: boolean
   /** 되풀이한 부품이면 지금 몇 개로 그려지나. 되풀이는 한 부품이다 — 한 줄로 보인다. */
   copies?: number
+  /**
+   * 바로 붙어 있는 곳: `대상 부품 · 대상 면`. 목록은 평평한 채로 두고 보조 문구로만 적는다 — 순서도 들여쓰기도
+   * 붙임 때문에 바뀌지 않는다(ADR-0097 §5.5, 설계자 2026-09-27).
+   */
+  fastenedTo?: string
 }
 
 /** 제공자마다의 아이콘. Material Symbols 이름이다. */
@@ -104,6 +109,36 @@ export class FigureParts extends localize(i18next)(LitElement) {
         color: var(--md-sys-color-on-surface-variant, var(--md-sys-color-on-surface));
       }
       /* The cost line: the grade's letter in its colour, then what the figure costs. */
+      button[model-root] {
+        display: flex;
+        align-items: center;
+        gap: 6px;
+        width: 100%;
+        min-height: 32px;
+        padding: 4px 8px;
+        border: 1px solid transparent;
+        border-radius: 6px;
+        background: none;
+        font: inherit;
+        font-weight: 600;
+        text-align: start;
+        color: var(--md-sys-color-on-surface);
+        cursor: pointer;
+      }
+      button[model-root] span {
+        overflow: hidden;
+        white-space: nowrap;
+        text-overflow: ellipsis;
+      }
+      /* Chosen: a frame and a tint, not colour alone. */
+      button[model-root][on] {
+        border-color: var(--md-sys-color-primary);
+        background: var(--md-sys-color-primary-container);
+      }
+      button[model-root]:focus-visible {
+        outline: 2px solid var(--md-sys-color-primary);
+        outline-offset: 1px;
+      }
       button[budget] {
         display: flex;
         align-items: flex-start;
@@ -366,6 +401,8 @@ export class FigureParts extends localize(i18next)(LitElement) {
   @property({ type: Array }) parts: FigurePartRow[] = []
   /** 고른 부품의 id. 자리(index)가 아니다 — 부품은 id 로 안정하게 가리킨다. */
   @property({ type: String }) selected = ''
+  /** The model's own name, the list's root: choosing it shows the model's settings (B.1). */
+  @property({ type: String }) modelName = ''
   /** 편집할 수 없을 때(불러오는 중 · 저장 중) 팔레트와 조작을 잠근다. */
   @property({ type: Boolean }) locked = false
   /**
@@ -407,6 +444,20 @@ export class FigureParts extends localize(i18next)(LitElement) {
       ${this.renderRecipes(full)}
 
       <section list>
+        <!--
+          The list's root: the model by its name. Choosing it shows the model's settings -- not "select all", not "fit the
+          view" -- the same move as the model name in the properties panel's path (designer 2026-09-27, B.1).
+        -->
+        <button
+          model-root
+          aria-pressed=${String(!this.selected)}
+          ?on=${!this.selected}
+          title=${i18next.t('figure.button.show-model-settings')}
+          aria-label=${`${i18next.t('figure.button.show-model-settings')}: ${this.modelName || i18next.t('figure.text.new-figure-name')}`}
+          @click=${() => this.dispatchEvent(new CustomEvent('show-model-settings', { bubbles: true, composed: true }))}
+        >
+          <md-icon>category</md-icon><span>${this.modelName || i18next.t('figure.text.new-figure-name')}</span>
+        </button>
         <h3>
           <span>${i18next.t('figure.label.parts')}</span>
           <span room ?full=${full} title=${i18next.t('figure.text.limit-comes-from-level')}
@@ -428,7 +479,8 @@ export class FigureParts extends localize(i18next)(LitElement) {
   /** 디테일 등급 — 고르면 한도가 바뀐다. 목록 머리 아래. */
   private renderLevel() {
     const b = this.partBudget
-    if (!b) return nothing
+    /* Not before the first part: a level with nothing to limit was the first choice a new figure met (U09). Once set, it shows. */
+    if (!b || (!this.parts.length && !b.level)) return nothing
     return html`<div level>
       <label for="detail-level">${i18next.t('figure.label.detail-level')}</label>
       <select
@@ -525,7 +577,9 @@ export class FigureParts extends localize(i18next)(LitElement) {
         </button>
         <md-icon>${PROVIDER_ICON[part.provider] ?? 'deployed_code'}</md-icon>
         <span label title=${part.id}
-          >${partLabelOf(part.id)}${part.copies ? html` <small copies>× ${part.copies}</small>` : nothing}${part.invisible ? html`<small>${i18next.t('figure.label.state-hidden')}</small>` : nothing}</span
+          >${partLabelOf(part.id)}${part.copies ? html` <small copies>× ${part.copies}</small>` : nothing}${part.invisible ? html`<small>${i18next.t('figure.label.state-hidden')}</small>` : nothing}${part.fastenedTo
+            ? html`<small fastened-to title=${i18next.t('figure.label.fastened-to')}>${part.fastenedTo}</small>`
+            : nothing}</span
         >
         ${selected ? this.renderOps(part.id, index) : nothing}
       </li>

package/client/modeller/figure-preview.ts

@@ -52,6 +52,9 @@ export class FigurePreview extends localize(i18next)(LitElement) {
       width: 100%;
       height: 100%;
     }
+    div[setup] { position: absolute; bottom: 8px; left: 8px; max-width: min(320px, calc(100% - 16px)); padding: 12px; border-radius: 8px; background: rgba(28,28,30,.9); color: #fff; display: grid; gap: 8px; }
+    div[setup] p { margin: 0; line-height: 1.5; }
+    div[setup] select, div[setup] button { font: inherit; padding: 8px; min-width: 0; }
     /* Which is which: side by side means nothing without a legend. */
     div[legend] {
       position: absolute;
@@ -159,6 +162,14 @@ export class FigurePreview extends localize(i18next)(LitElement) {
   /** Clip speeds and control values given here -- the preview's, not the figure's. */
   @state() private driving: Record<string, number> = {}
   @state() private giving: Record<string, number> = {}
+  @state() private setupPart = ''
+
+  /** What is being tried here now -- clip speeds and control values -- for the AI dock to hear with a request; none when nothing is. */
+  tried(): { clips?: Record<string, number>; controls?: Record<string, number> } | undefined {
+    const clips = Object.keys(this.driving).length ? { ...this.driving } : undefined
+    const controls = Object.keys(this.giving).length ? { ...this.giving } : undefined
+    return clips || controls ? { ...(clips ? { clips } : {}), ...(controls ? { controls } : {}) } : undefined
+  }
 
   private scene?: SceneHandle
   private standing?: string
@@ -189,6 +200,13 @@ export class FigurePreview extends localize(i18next)(LitElement) {
                 </span>`
               })}
             </div>
+            ${asset?.appearance.length ? html`<div setup>
+              <p>${i18next.t('figure.text.preview-setup')}</p>
+              <select aria-label=${i18next.t('figure.label.resize-part')} @change=${(e: Event) => this.setupPart = (e.target as HTMLSelectElement).value}>
+                ${asset.appearance.map(p => html`<option value=${p.target} ?selected=${p.target === this.setupPart}>${p.target}</option>`)}
+              </select>
+              <button @click=${() => this.dispatchEvent(new CustomEvent('configure-size', { detail: { part: asset.appearance.some(p => p.target === this.setupPart) ? this.setupPart : asset.appearance[0]!.target }, bubbles: true, composed: true }))}>${i18next.t('figure.button.configure-size')}</button>
+            </div>` : nothing}
             ${controls.length + clips.length ? this.renderDrivers(asset!, controls, clips) : nothing}`}`
   }
 
@@ -318,7 +336,7 @@ export class FigurePreview extends localize(i18next)(LitElement) {
           type: 'model-layer',
           width: board.width,
           height: board.height,
-          depth: previewBoardDepth({ placement: asset.occupancy?.placement, base: { y: size.y } }, view.ceilingHeight, PREVIEW_FACTOR),
+          depth: previewBoardDepth({ placement: asset.placement, base: { y: size.y } }, view.ceilingHeight, PREVIEW_FACTOR),
           threed: true,
           sky: 'color',
           ...sceneLook(view),

package/client/modeller/figure-properties.ts

@@ -127,11 +127,11 @@ export class FigureProperties extends localize(i18next)(LitElement) {
       <div field>
         <label>${i18next.t('figure.label.figure-placement')}</label>
         <select
-          ?disabled=${!facts.parts.length}
           .value=${live(current)}
           @change=${(event: Event) => {
             const select = event.target as HTMLSelectElement
-            this.declare(select.value as Placement)
+            /* The figure's own setting (ADR-0097): chosen with no part too, and the room is left as it is declared. */
+            this.command({ kind: 'set-placement', placement: select.value as Placement })
             /* Refused, the figure is placed as it was, and the list says so; taken, the figure drawn again says the new one. */
             select.value = current
           }}
@@ -140,7 +140,7 @@ export class FigureProperties extends localize(i18next)(LitElement) {
             one => html`<option value=${one} ?selected=${one === current}>${i18next.t('figure.label.placement-' + one)}</option>`
           )}
         </select>
-        <small>${i18next.t(facts.parts.length ? 'figure.text.placement-redeclares' : 'figure.text.fit-needs-parts')}</small>
+        <small>${i18next.t('figure.text.placement-is-intent')}</small>
       </div>
     `
   }

package/client/modeller/figure-revert-choice.ts

@@ -0,0 +1,49 @@
+import { LitElement, html, css } from 'lit'
+import { customElement, property } from 'lit/decorators.js'
+import { i18next } from '@operato/i18n'
+import { closePopup } from '@operato/popup'
+import '@operato/popup/ox-popup-actions.js'
+import { CommonPopupStyles } from '@operato/styles'
+import '@material/web/button/filled-button.js'
+import '@material/web/button/text-button.js'
+
+/** What to do with edits not saved yet, before going back to a released version (designer 2026-09-27, Q-D1). */
+export type RevertChoice = 'save' | 'discard'
+
+/**
+ * Going back to a released version with edits not saved yet: save them first, let them go, or stay. Closes with the
+ * choice, or with nothing -- then nothing happens.
+ */
+@customElement('figure-revert-choice')
+export class FigureRevertChoice extends LitElement {
+  static styles = [
+    CommonPopupStyles,
+    css`
+      :host {
+        overflow-y: auto;
+      }
+      p {
+        margin: 0 0 12px;
+      }
+    `
+  ]
+
+  @property({ type: Number }) version = 0
+  /** Going back to a version, or taking a revert back (ADR-0097 §5.6): the same three, asked in its words. */
+  @property({ type: String }) purpose: 'revert' | 'undo' = 'revert'
+
+  render() {
+    return html`
+      <p>
+        ${this.purpose === 'undo'
+          ? i18next.t('figure.text.undo-revert-with-unsaved')
+          : i18next.t('figure.text.revert-with-unsaved', { version: String(this.version) })}
+      </p>
+      <ox-popup-actions>
+        <md-text-button slot="cancel" @click=${() => closePopup(this)}>${i18next.t('figure.button.keep-editing')}</md-text-button>
+        <md-text-button slot="start" destructive @click=${() => closePopup(this, 'discard' satisfies RevertChoice)}>${i18next.t(this.purpose === 'undo' ? 'figure.button.discard-and-continue' : 'figure.button.revert-discarding')}</md-text-button>
+        <md-filled-button slot="confirm" @click=${() => closePopup(this, 'save' satisfies RevertChoice)}>${i18next.t(this.purpose === 'undo' ? 'figure.button.save-and-continue' : 'figure.button.revert-saving')}</md-filled-button>
+      </ox-popup-actions>
+    `
+  }
+}

package/client/modeller/first-save.ts

@@ -19,6 +19,22 @@ export function releasableType(type: string): boolean {
   return !isPlaceholderType(type) && TYPE_PATTERN.test(type) && type.length >= TYPE_LENGTH.min && type.length <= TYPE_LENGTH.max
 }
 
+/**
+ * An identifier offered for a new figure, so the first save asks for a name and has a valid identifier ready (designer
+ * 2026-09-27, Q-D3). A name in plain letters is used as it is when it makes a free, releasable identifier; any other
+ * name -- Korean, say -- gets a valid prefix and a random part: no transliteration is guessed. Never the temporary
+ * shape (`FIGURE_` and eight), which the release gate refuses; never one this domain already uses.
+ */
+export function suggestTypeOf(name: string, taken: readonly string[], random: () => number = Math.random): string {
+  const fromName = /^[A-Za-z][A-Za-z0-9 _-]*$/.test(name.trim()) ? typeOf(name).replace(/_+/g, '_').replace(/_$/, '') : ''
+  if (fromName && releasableType(fromName) && !taken.includes(fromName)) return fromName
+  const alphabet = '0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ'
+  for (;;) {
+    const made = `FIG_${Array.from({ length: 6 }, () => alphabet[Math.floor(random() * alphabet.length)]).join('')}`
+    if (releasableType(made) && !taken.includes(made)) return made
+  }
+}
+
 /** Why the first save cannot go on with this type, as an i18n key, or null when it can. */
 export function firstSaveRefusalOf(type: string, taken: readonly string[]): { key: string; type?: string } | null {
   if (!type) return { key: 'figure.text.enter-a-type-name' }

package/client/modeller/gizmo.ts

@@ -138,19 +138,3 @@ export function gizmoChanges(part: string, reach: GizmoReach, result: GizmoResul
   }
   return changes
 }
-
-/**
- * A height typed into its field keeps the part's bottom where it is, as the scale gizmo does (it anchors the opposite
- * face): the part's own Y position moves by half the change. A post typed 2200 tall sank 933 mm under the floor
- * (2026-09-26). Only for a part placed by its own numbers and standing unturned; otherwise its height is not up and down.
- */
-export function keepBottomChanges(part: string, reach: GizmoReach, input: string, value: number, values: Record<string, number>): FigureInputChange[] {
-  if (!reach.translate) return []
-  const height = reach.sizes?.[1] ?? reach.ownSizes?.[1] ?? reach.round?.along[0]
-  if (!height || height !== input) return []
-  if (AXES.some(axis => (values[`${part}.rotation.${axis}`] ?? 0) % 360 !== 0)) return []
-  const before = values[input],
-    y = values[`${part}.position.y`]
-  if (before === undefined || y === undefined || !Number.isFinite(value)) return []
-  return [{ kind: 'set-design', input: `${part}.position.y`, unit: 'mm', value: Math.round((y + (value - before) / 2) * 10) / 10 } as FigureInputChange]
-}

package/client/modeller/links.ts

@@ -1,4 +1,4 @@
-import { FIGURE_FACES, figureShapeFaces, figurePartsExtentOf, compileFigureAsset, compileFigureGraph, figureFollowOf, proposeFigureProportion, defaultInstanceSizeRange, foldInstanceSizeRange, figureAttachmentsOf, figureBindingsOf, figureInstanceSizeLimitsOf } from '@hatiolab/figure-model'
+import { FIGURE_FACES, figureShapeFaces, figurePartsExtentOf, compileFigureAsset, compileFigureGraph, figureFollowOf, proposeFigureProportion, defaultInstanceSizeRange, foldInstanceSizeRange, figureAttachmentsOf, figureBindingsOf, figureInstanceSizeLimitsOf, figureFollowableAxesOf, figureShapeProviderOf } from '@hatiolab/figure-model'
 import type { FigureFollow, FigureSizeRange } from '@hatiolab/figure-model'
 import type { FigureAsset, FigureBindingPlace, FigureFace, FigureJoint } from '@hatiolab/figure-model'
 
@@ -57,16 +57,90 @@ export function canFollow(asset: FigureAsset, part: string): boolean {
 }
 
 /**
- * The axes whose size can follow something, by the shape's own measures: a box's X · Y · Z; a cylinder's radius (read
- * as X) and length (Y) -- its shape takes those two, so it has no Z of its own.
+ * The axes whose size can follow something: figure-model's one list (`figureFollowableAxesOf`), which follow-size and
+ * the resize plan ask too -- the screen does not keep a list of its own (designer 2026-09-27).
  */
 export function followableAxes(asset: FigureAsset, part: string): Axis[] {
   const shape = modelOf(asset).nodes.find(n => n.id === `${part}.shape`)
-  if (!shape) return []
-  /* A door frame's first three measures are its width, height and depth, as a box's (figure-model portal-profile@2). */
-  if (shape.op === 'box-shape@1' || shape.op === 'rounded-box@1' || shape.op === 'portal-profile@2' || shape.op === 'hollow-box@2') return [...AXES]
-  if (shape.op === 'cylinder-shape@1') return ['x', 'y']
-  return []
+  return shape ? figureFollowableAxesOf(shape.op) : []
+}
+
+/**
+ * The directions "follow the size, attached" passes to figure-model (designer 2026-09-27):
+ *   - `chosen`: what the author ticked, and the ones already following, which stay;
+ *   - `suggested`: a part the author has not chosen for yet and that follows nothing -- every direction, said as
+ *     "all three" on the button, never as a choice the author made;
+ *   - `none`: the author set every direction back to fixed, or unticked them all -- nothing is taken for all.
+ * `pending` is the author's ticks for this part in this screen, when they have ticked or fixed anything.
+ */
+export function resizeAxesOf(asset: FigureAsset, part: string, pending?: readonly Axis[]): { axes: Axis[]; basis: 'chosen' | 'suggested' | 'none' } {
+  const editable = followableAxes(asset, part)
+  const following = editable.filter(axis => {
+    const now = followOf(asset, part, axis)
+    return now.of === 'instance' && now.axis === axis
+  })
+  if (pending) {
+    const axes = editable.filter(axis => pending.includes(axis) || following.includes(axis))
+    return { axes, basis: axes.length ? 'chosen' : 'none' }
+  }
+  if (following.length) return { axes: following, basis: 'chosen' }
+  return { axes: editable, basis: editable.length ? 'suggested' : 'none' }
+}
+
+const KIND_OF_SHAPE: Record<string, string> = {
+  'box-shape@1': 'cube',
+  'rounded-box@1': 'rounded-box',
+  'rounded-box@2': 'rounded-box',
+  'hollow-box@1': 'hollow-box',
+  'hollow-box@2': 'hollow-box',
+  'portal-profile@2': 'portal',
+  'cylinder-shape@1': 'cylinder',
+  'cylinder-shape@2': 'cylinder',
+  'sphere-shape@1': 'sphere',
+  'frustum-shape@1': 'frustum',
+  'polygon-shape@1': 'polygon'
+}
+
+/**
+ * The selected part in three short lines, for the head of its panel (designer 2026-09-27, B): what it is, how its
+ * size answers the figure's, and what holds it -- 「box · 상자 / 너비는 도형을 따라감 / 아랫면을 바닥에 유지 중」.
+ */
+export function partSummaryOf(asset: FigureAsset, part: string, say: (key: string, params?: Record<string, string>) => string): { kind: string; size: string; relation: string } {
+  const shape = modelOf(asset).nodes.find(n => n.id === `${part}.shape`)
+  const kind = shape && KIND_OF_SHAPE[shape.op] ? say(`figure.label.primitive-${KIND_OF_SHAPE[shape.op]}`) : ''
+  const editable = followableAxes(asset, part)
+  const round = editable.length === 2
+  const word = (axis: Axis) => say(round && axis === 'x' ? 'figure.label.resize-diameter' : `figure.label.resize-${axis}`)
+  const following = editable.filter(axis => {
+    const now = followOf(asset, part, axis)
+    return now.of === 'instance' && now.axis === axis
+  })
+  const ruled = editable.filter(axis => followOf(asset, part, axis).of !== 'own' && !following.includes(axis))
+  const size = [
+    following.length ? say('figure.text.summary-follows', { axes: following.map(word).join(' · ') }) : '',
+    ruled.length ? say('figure.text.summary-ruled', { axes: ruled.map(word).join(' · ') }) : ''
+  ].filter(Boolean).join(' / ') || say('figure.text.summary-size-fixed')
+  const joint = asset.joints?.find(j => j.body1.part === part)
+  let relation = say('figure.text.summary-free')
+  if (joint) {
+    const face = say(`figure.label.face-${joint.body1.face}`)
+    const gap = typeof joint.origin?.gap === 'number' ? joint.origin.gap : 0
+    relation =
+      'plane' in joint.body0
+        ? say('figure.text.held-on-plane', { face, place: say(`figure.label.resize-place-${asset.placement ?? 'floor'}`), gap: String(gap) })
+        : say('figure.text.held-on-part', { face, other: joint.body0.part, otherFace: say(`figure.label.face-${joint.body0.face}`) })
+  }
+  return { kind, size, relation }
+}
+
+/**
+ * A part's own field in the words its row uses -- 「위치 Y」, 「크기 X」, and the turn as one 「회전」 -- so a field the plan
+ * replaces, or one only the room reads, is named as the author knows it, not by its id.
+ */
+export function fieldWordsOf(id: string, say: (key: string) => string): string {
+  const own = /\.(position|rotation|size)\.([xyz])$/.exec(id)
+  if (!own) return id
+  return own[1] === 'rotation' ? say('figure.label.group-rotation') : `${say(`figure.label.group-${own[1]}`)} ${own[2]!.toUpperCase()}`
 }
 
 /** What a part's own measure on an axis is now (a box's side, a cylinder's radius or length), at the design as it stands. */
@@ -83,6 +157,23 @@ export function dimensionNow(asset: FigureAsset, part: string, axis: Axis): numb
   }
 }
 
+/**
+ * How long a part is along one axis now, as it is drawn: the shape's own measure through figure-model's provider (a
+ * cylinder's width is twice its radius), read after any rule it follows -- so a linked measure still says its size.
+ */
+export function measureNow(asset: FigureAsset, part: string, axis: Axis): number | undefined {
+  const shape = modelOf(asset).nodes.find(n => n.id === `${part}.shape`)
+  const edit = shape && figureShapeProviderOf(shape.op)?.edit[axis]
+  if (!shape || !edit || 'refused' in edit) return undefined
+  try {
+    const values = compileFigureGraph(asset.document.model as never).evaluate({ ...asset.designInputs, ...asset.stateDefaults }).values as Record<string, number>
+    const value = values[shape.args[edit.arg]!]
+    return typeof value === 'number' && Number.isFinite(value) ? value * edit.k : undefined
+  } catch {
+    return undefined
+  }
+}
+
 /**
  * The flat faces a part's shape declares, by name -- figure-model's shape definitions are the one place they are
  * written (a portal's opening sides as well as its outer faces). A sphere has none.
@@ -113,17 +204,33 @@ const OUTER: Record<Axis, [string, string]> = { x: ['left', 'right'], y: ['botto
 export function rowAxesOf(asset: FigureAsset, part: string): Axis[] {
   const joints = asset.joints ?? []
   const j = joints.find(o => o.body1.part === part)
-  if (!j || j.type !== 'fixed' || j.repeat || !('part' in j.body0)) return []
+  /* A part that moves may be a row too: every copy on the one control, from its own place (designer 2026-09-27). */
+  if (!j || j.repeat || !('part' in j.body0)) return []
   if (joints.some(o => 'part' in o.body0 && o.body0.part === part)) return []
   return AXES.filter(axis => axis !== FIGURE_FACES[j.body1.face])
 }
 
+/**
+ * Why a part cannot be made into a row here, in the terms `rowAxesOf` refuses it: said, not hidden (ADR-0097 §5.5).
+ * Nothing when it can, or when it already is a row (that row is shown where it stands).
+ */
+export function rowBlockOf(asset: FigureAsset, part: string): 'unfastened' | 'on-plane' | 'holds-parts' | undefined {
+  const joints = asset.joints ?? []
+  const j = joints.find(o => o.body1.part === part)
+  if (!j) return 'unfastened'
+  if (j.repeat) return undefined
+  if (!('part' in j.body0)) return 'on-plane'
+  if (joints.some(o => 'part' in o.body0 && o.body0.part === part)) return 'holds-parts'
+  return undefined
+}
+
 /** The row a part is made into, as its fastening's record keeps it. */
 export const rowOf = (asset: FigureAsset, part: string) => asset.joints?.find(o => o.body1.part === part)?.repeat
 
 /** Where a part sits across the face it is fastened to, on one axis: centred, level with an edge, or a distance off centre. */
 /** `share`: the distance as a share of the figure's size on that axis, so it keeps its place when the figure is resized. */
-export type Alignment = 'centre' | 'min' | 'max' | 'mm' | 'share'
+/** `input`: the place across the face follows one of the part's position fields -- as "follow size, attached" keeps it (ADR-0097). */
+export type Alignment = 'centre' | 'min' | 'max' | 'mm' | 'share' | 'input'
 
 /**
  * The axes across the face a part is fastened to — the two a fastening does not set by itself. Edges to line up with
@@ -135,7 +242,7 @@ export type Alignment = 'centre' | 'min' | 'max' | 'mm' | 'share'
  * on it by its bottom or hangs from it by its top; a wall is Z = 0 and a part is fastened to it by its back.
  */
 export function mountingPlaneOf(asset: FigureAsset): { normal: Axis; faces: FigureFace[] } {
-  return asset.occupancy?.placement === 'wall' ? { normal: 'z', faces: ['back'] } : { normal: 'y', faces: ['bottom', 'top'] }
+  return asset.placement === 'wall' ? { normal: 'z', faces: ['back'] } : { normal: 'y', faces: ['bottom', 'top'] }
 }
 
 export function alignAxesOf(asset: FigureAsset, part: string, target: { part: string; face: string } | 'plane', twisted = false): { axis: Axis; edges: boolean }[] {
@@ -217,6 +324,11 @@ export function fasteningOf(
     } else if (how && typeof how === 'object' && typeof (how as { mm?: unknown }).mm === 'number') {
       kept.align[axis] = 'mm'
       kept.alignMm[axis] = (how as { mm: number }).mm
+    } else if ((how as { mm?: { from?: { of?: string; input?: string } } })?.mm?.from?.of === 'input') {
+      /* Following a position field: read as that, so fastening again keeps the field and does not fix its number. */
+      kept.align[axis] = 'input'
+      kept.alignInput[axis] = (how as { mm: { from: { input: string } } }).mm.from.input
+      delete kept.alignMm[axis]
     }
   }
   const gap = record.origin?.gap
@@ -242,8 +354,8 @@ export function placeKeptOf(
   part: string,
   target: { part: string; face: string } | 'plane',
   twisted = false
-): { align: Partial<Record<Axis, Alignment>>; alignMm: Partial<Record<Axis, number>> } {
-  const kept = { align: {} as Partial<Record<Axis, Alignment>>, alignMm: {} as Partial<Record<Axis, number>> }
+): { align: Partial<Record<Axis, Alignment>>; alignMm: Partial<Record<Axis, number>>; alignInput: Partial<Record<Axis, string>> } {
+  const kept = { align: {} as Partial<Record<Axis, Alignment>>, alignMm: {} as Partial<Record<Axis, number>>, alignInput: {} as Partial<Record<Axis, string>> }
   let geometry
   try {
     geometry = compileFigureAsset(asset).evaluate().geometry as unknown as Array<{ id: string; pose?: { r: number[][]; t: number[] } }>
@@ -277,9 +389,10 @@ export function alignOf(
   target: { part: string; face: string } | 'plane',
   how: Partial<Record<Axis, Alignment>>,
   mm: Partial<Record<Axis, number>>,
-  twisted = false
+  twisted = false,
+  inputs: Partial<Record<Axis, string>> = {}
 ) {
-  const align: Partial<Record<Axis, 'min' | 'max' | { mm: number | { from: { of: 'instance'; axis: Axis }; times: number } }>> = {}
+  const align: Partial<Record<Axis, 'min' | 'max' | { mm: number | { from: { of: 'instance'; axis: Axis }; times: number } | { from: { of: 'input'; input: string } } }>> = {}
   for (const { axis, edges } of alignAxesOf(asset, part, target, twisted)) {
     const one = how[axis] ?? 'centre'
     const size = asset.designInputs[`size.${axis}`]
@@ -287,6 +400,7 @@ export function alignOf(
       align[axis] = { mm: { from: { of: 'instance', axis }, times: Math.round((mm[axis]! / size) * 1e6) / 1e6 } }
     else if (one === 'mm' && mm[axis]) align[axis] = { mm: mm[axis]! }
     else if ((one === 'min' || one === 'max') && edges) align[axis] = one
+    else if (one === 'input' && inputs[axis]) align[axis] = { mm: { from: { of: 'input', input: inputs[axis]! } } }
   }
   return Object.keys(align).length ? align : undefined
 }
@@ -413,6 +527,8 @@ export function motionJoint(joint: FigureJoint, m: MotionForm, part: string): Fi
     body0: joint.body0,
     body1: joint.body1,
     ...(joint.origin ? { origin: joint.origin } : {}),
+    /* A row keeps being a row when it is given a motion: dropped here, the row went with it (designer 2026-09-27). */
+    ...(joint.repeat ? { repeat: joint.repeat } : {}),
     type: m.kind === 'slide' ? ('prismatic' as const) : ('revolute' as const),
     axis: m.axis.toUpperCase() as 'X' | 'Y' | 'Z'
   }
@@ -560,3 +676,14 @@ export function turnsAboutAJoint(asset: FigureAsset): boolean {
   return modelOf(asset).nodes.some(n => n.op === 'axis-turn@1')
 }
 
+/** The joint made still: its fastening, its place and its row kept, its motion gone. */
+export function fixedJointOf(joint: FigureJoint): FigureJoint {
+  return {
+    id: joint.id,
+    type: 'fixed',
+    body0: joint.body0,
+    body1: joint.body1,
+    ...(joint.origin ? { origin: joint.origin } : {}),
+    ...(joint.repeat ? { repeat: joint.repeat } : {})
+  } as FigureJoint
+}

package/client/modeller/motion-ends.ts

@@ -0,0 +1,83 @@
+import { compileFigureAsset } from '@hatiolab/figure-model'
+import type { FigureAsset } from '@hatiolab/figure-model'
+
+import { PREVIEW, TARGET_FACE } from './command-preview.js'
+import type { FigureRenderPart } from './renderer.js'
+
+/*
+ * Where a part's motion takes it (ADR-0097 §5.5, designer 2026-09-27): the bodies its control moves, drawn translucent at
+ * the control's lowest and highest value -- evaluated there by figure-model, not guessed -- and, for a slide, the line it
+ * travels. Only the two ends are shown; nothing here says what lies between them is clear.
+ */
+
+type Pose = { r: number[][]; t: number[] }
+type Body = FigureRenderPart & { pose: Pose }
+
+/** The line a slide travels along, thin enough not to hide the part. */
+const THICKNESS = 6
+
+export interface MotionEnds {
+  control: string
+  min: number
+  max: number
+  unit: string
+  /** The moving bodies at the lowest value, then at the highest. */
+  ghost: FigureRenderPart[]
+}
+
+const samePose = (a: Pose, b: Pose) => [0, 1, 2].every(i => Math.abs(a.t[i]! - b.t[i]!) < 1e-6 && [0, 1, 2].every(k => Math.abs(a.r[i]![k]! - b.r[i]![k]!) < 1e-9))
+
+/** The ends of the selected part's own motion, or nothing: a part that does not move, follows another, or turns without end. */
+export function motionEndsOf(asset: FigureAsset, part: string, values: Record<string, number> = {}): MotionEnds | null {
+  const joint = asset.joints?.find(j => j.body1.part === part)
+  /* A turn without end is a revolute joint whose control has no range: the range check below leaves it out. */
+  if (!joint || joint.type === 'fixed' || joint.mimic) return null
+  const control = joint.state?.id ?? joint.id
+  const input = asset.document.model.inputs.find(i => i.id === control && i.role === 'state')
+  if (!input || typeof input.min !== 'number' || typeof input.max !== 'number' || input.min === input.max) return null
+  /* The values in hand, each where it belongs: design values into the figure, controls into the evaluation. */
+  const pick = (of: Record<string, number>) => Object.fromEntries(Object.entries(values).filter(([id]) => id in of))
+  const shown = { ...asset, designInputs: { ...asset.designInputs, ...pick(asset.designInputs) } }
+  const state = pick(asset.stateDefaults)
+  const at = (value: number) => {
+    try {
+      return compileFigureAsset(shown).evaluate({ ...state, [control]: value }).geometry as unknown as Body[]
+    } catch {
+      return null
+    }
+  }
+  const low = at(input.min)
+  const high = at(input.max)
+  if (!low || !high) return null
+  const byId = new Map(high.filter(b => b.pose).map(b => [b.id, b]))
+  const moving = low.filter(b => b.pose && 'shape' in b && byId.has(b.id) && !samePose(b.pose, byId.get(b.id)!.pose))
+  if (!moving.length) return null
+  const ghost: FigureRenderPart[] = [
+    ...moving.map(b => ({ ...b, id: `${PREVIEW}:min:${b.id}`, material: { token: PREVIEW, transparent: true } })),
+    ...moving.map(b => ({ ...byId.get(b.id)!, id: `${PREVIEW}:max:${b.id}`, material: { token: PREVIEW, transparent: true } }))
+  ]
+  /* A slide: the line its own body travels, from the lowest value to the highest. */
+  const own = moving.find(b => b.id === part)
+  if (joint.type === 'prismatic' && own) {
+    const from = own.pose.t
+    const to = byId.get(part)!.pose.t
+    const v = [0, 1, 2].map(i => to[i]! - from[i]!)
+    const length = Math.hypot(...v)
+    if (length > 1e-6) {
+      const x = v.map(c => c / length)
+      /* Any two directions square to it and to each other complete its frame. */
+      const helper = Math.abs(x[1]!) < 0.9 ? [0, 1, 0] : [1, 0, 0]
+      const zRaw = [x[1]! * helper[2]! - x[2]! * helper[1]!, x[2]! * helper[0]! - x[0]! * helper[2]!, x[0]! * helper[1]! - x[1]! * helper[0]!]
+      const zl = Math.hypot(...zRaw)
+      const z = zRaw.map(c => c / zl)
+      const y = [z[1]! * x[2]! - z[2]! * x[1]!, z[2]! * x[0]! - z[0]! * x[2]!, z[0]! * x[1]! - z[1]! * x[0]!]
+      ghost.push({
+        id: `${TARGET_FACE}:slide`,
+        shape: { provider: 'box', dimensions: { width: length, height: THICKNESS, depth: THICKNESS } },
+        pose: { r: [0, 1, 2].map(i => [x[i]!, y[i]!, z[i]!]), t: [0, 1, 2].map(i => (from[i]! + to[i]!) / 2) },
+        material: { token: TARGET_FACE }
+      })
+    }
+  }
+  return { control, min: input.min, max: input.max, unit: input.unit, ghost }
+}

package/client/modeller/occupancy.ts

@@ -1,4 +1,4 @@
-import { parseFigureAsset, proposeFigureOccupancy, type FigureAuthoringAction } from '@hatiolab/figure-model'
+import { parseFigureAsset, proposeFigureOccupancy, type FigureAuthoringAction, type FigureRoomRefit } from '@hatiolab/figure-model'
 
 /**
  * 「부품에 맞추기」의 짝 — 공간을 지금 부품에서 다시 선언하는 한 걸음.
@@ -21,6 +21,32 @@ export function occupancyFromParts(
   return {
     kind: 'declare-occupancy',
     proposal: proposeFigureOccupancy(asset, { over: 'range' }),
-    placement: placement ?? asset.occupancy?.placement ?? 'floor'
+    /* The placement is the figure's own now (ADR-0097): named only when a different one is asked for. */
+    ...(placement && placement !== (asset.placement ?? 'floor') ? { placement } : {})
   }
 }
+
+/**
+ * 공간 다시 계산의 확인 표 — 선언된 공간과 제안된 공간을 그린 크기와 가장 큰 크기에서, 축마다 한 줄로. 같은 줄은
+ * 같다고 적는다. 밖으로 나간 부품은 figure-model 이 잰 것만 적는다 — 재지 않은 것을 「넘친다」고 단정하지 않는다
+ * (설계자 2026-09-27).
+ */
+export interface RoomRefitRow {
+  at: 'authored' | 'largest'
+  axis: 'x' | 'y' | 'z'
+  declared: string
+  proposed: string
+  same: boolean
+}
+export function roomRefitRowsOf(refit: FigureRoomRefit): RoomRefitRow[] {
+  const span = (b: { min: number; max: number }) => `${Math.round(b.min)} ~ ${Math.round(b.max)}`
+  const rows: RoomRefitRow[] = []
+  for (const at of ['authored', 'largest'] as const) {
+    const declared = refit.declared[at],
+      proposed = refit.proposed[at]
+    if (!declared || !proposed) continue
+    for (const axis of ['x', 'y', 'z'] as const)
+      rows.push({ at, axis, declared: span(declared[axis]), proposed: span(proposed[axis]), same: span(declared[axis]) === span(proposed[axis]) })
+  }
+  return rows
+}