@things-factory/figure-ui 10.1.205 → 10.1.207

package/client/modeller/editor-styles.ts

@@ -131,6 +131,22 @@ export const EditorStyles = css`
     min-width: 0;
     min-height: 0;
   }
+  /* Which size handles change one diameter (ADR-0140 4.1): a quiet line over the canvas, out of the gizmo's way. */
+  p[same-measure] {
+    position: absolute;
+    bottom: 12px;
+    left: 50%;
+    z-index: 5;
+    transform: translateX(-50%);
+    margin: 0;
+    padding: 4px 10px;
+    border-radius: 999em;
+    background: var(--md-sys-color-surface-container-high);
+    color: var(--md-sys-color-on-surface-variant);
+    font-size: var(--ui-t-small, 11.5px);
+    pointer-events: none;
+    white-space: nowrap;
+  }
   /* A new figure's first question, over the empty canvas. */
   div[start] {
     position: absolute;

package/client/modeller/editor.ts

@@ -6,7 +6,7 @@ import { openPopup } from '@operato/layout'
 import { OxPrompt } from '@operato/popup'
 import { customElement, property, state } from 'lit/decorators.js'
 import { live } from 'lit/directives/live.js'
-import { figurePartFaceOf, PART_LIMIT, parseFigureRecipe, resolveFigureRecipe, figurePartCountOf, figurePartIdFor, figureRecipeIdFor, figureSizeEditOf, figureSizeEditorOf, figureSectionMeasuresOf, figurePlaneAlignChanges, type FigurePlaneContact, figureRowOf, type FigureRowReading, figureFaceOverhangOf, type FigureFaceOverhang, figureRoomOnlyInputsOf, figureRoomRefitOf } from '@hatiolab/figure-model'
+import { figurePartFaceOf, PART_LIMIT, parseFigureRecipe, resolveFigureRecipe, figurePartCountOf, figurePartIdFor, figureRecipeIdFor, figureSizeEditOf, figureSizeEditorOf, figureSectionMeasuresOf, figurePlaneAlignChanges, type FigurePlaneContact, figureRowOf, type FigureRowReading, figureFaceOverhangOf, type FigureFaceOverhang } from '@hatiolab/figure-model'
 import type { RecipeTemplate } from './recipes.js'
 import './figure-recipe-catalog.js'
 import type { FigureAsset, FigureAuthoringAction, FigureEvaluatedShape, FigureInputChange, FigurePartEdit, FigurePrimitiveCreation, FigureProposalStep, FigureRecipe, FigureRecipeValue, FigurePlacement, FigureFaceMappingNeed, FigureFaceRemap } from '@hatiolab/figure-model'
@@ -30,13 +30,13 @@ import './figure-preview.js'
 import './figure-settings.js'
 import { DEFAULT_VIEW, type ViewSettings } from '@things-factory/figure-viewer/dist-client/figure-view.js'
 import './figure-capability-panel.js'
-import { gizmoChanges, gizmoReachOf, sizeKeepOf, type GizmoReach, type GizmoResult } from './gizmo.js'
+import { gizmoChanges, gizmoReachOf, sameMeasureAxesOf, sizeKeepOf, type GizmoReach, type GizmoResult } from './gizmo.js'
 import { keptBySizeOf, partsAtFrame, SIZE_KEEPS_WORDS, startSizeDrag, throughPlaneOf, type SizeDrag, type SizeDragFrame } from './size-drag.js'
 import type { KeyAction } from './keys.js'
 import { ModellerKeys } from './modeller-keys.js'
 import { PaneFold } from './pane-fold.js'
 import { PanelMemory } from './panel-memory.js'
-import { RefusalTeller, type Retry } from './refusal-teller.js'
+import { RefusalTeller } from './refusal-teller.js'
 import { groupFields, ownerOf, partLabelOf, repeatOf, type FieldLike, type FieldGroup } from './fields.js'
 import { SidePanelStyles } from '@things-factory/figure-viewer/dist-client/side-panel-styles.js'
 import { EditorStyles } from './editor-styles.js'
@@ -57,14 +57,13 @@ import { nudgeOf, placementOf } from './stage-model.js'
 
 /** The numbers a rule gives a part's position, turn and size, per axis, for the cells that have no field. */
 type HeldValues = { position?: number[]; rotation?: number[]; size?: (number | undefined)[]; sizeRuled?: boolean }
-import { occupancyFromParts, roomRefitRowsOf } from './occupancy.js'
 import { gateFindingStyles, renderGateFinding } from './gate-findings.js'
 import type { FigureGateFinding } from '../types.js'
-import { editRefusalOf, inDeclaredRoom, narrowingRetryOf, partNameRefusalOf, partRefusalOf, placedRefusalOf, recipeRefusalOf, removalNoticeOf } from './refusals.js'
+import { editRefusalOf, partNameRefusalOf, sizeRangeFitsOf, partRefusalOf, placedRefusalOf, recipeRefusalOf, removalNoticeOf } from './refusals.js'
 import type { FigureRenderPart } from './renderer.js'
 import type { FigureBudgetLine } from './maturity.js'
 import { HelpToggles } from './help.js'
-import { endPlaceKeyOf, fieldWordsOf, followOf, sizeFollowersOf, measureNow, partSummaryOf, instanceRangeOf, instanceRangeToDeclare, proportionToFollow, rangeDiffers, rangeWith, turnsAboutAJoint, valueNow } from './links.js'
+import { endPlaceKeyOf, fieldWordsOf, followOf, sizeFollowersOf, measureNow, partSummaryOf, instanceRangeOf, instanceSizeToDeclare, proportionToFollow, rangeWith, turnsAboutAJoint, valueNow } from './links.js'
 import { jointFanOf } from './joint-fan.js'
 import { derivedOf, type FigureRevision } from './revision.js'
 import { jointDragOf } from './joint-drag.js'
@@ -135,8 +134,6 @@ export class FigureEditor extends LitElement {
    * edit was made (`from`).
    */
   @state() private faceMapping?: { action: FigureAuthoringAction; need: FigureFaceMappingNeed; from: 'section-editor' | 'panel' }
-  /** The same link offered again with the size range narrowed, after a link the declared range could not hold. */
-  @state() private retry?: Retry
   @state() private tab: SideTab = 'properties'
   /** The view settings or the release history, open over the work from the bar. */
   @state() private overlay?: BarOverlay
@@ -268,6 +265,14 @@ export class FigureEditor extends LitElement {
     selected: () => this.selected,
     act: action => this.keyAction(action)
   })
+  /** The part Ctrl+C took: pasted as the kernel's duplicate. Not kept past the editor, nor written anywhere. */
+  private copied = ''
+  /** A copied part still in the figure is duplicated -- a part of its own, named by figure-model; one gone, nothing. */
+  private pasteCopied() {
+    const asset = this.session?.revisionNow()?.asset
+    if (!this.copied || !asset?.document.model.nodes.some(n => n.op === 'place@1' && n.id === this.copied)) return
+    this.duplicatePart(this.copied)
+  }
   private keyAction(action: KeyAction) {
     const view = this.session!.read()
     const canvas = this.renderRoot.querySelector<FigureCanvas>('figure-canvas')
@@ -275,6 +280,9 @@ export class FigureEditor extends LitElement {
     else if (action === 'undo') view.canUndo && this.run(() => this.session!.undo())
     else if (action === 'redo') view.canRedo && this.run(() => this.session!.redo())
     else if (action === 'duplicate') this.duplicatePart(this.selected)
+    else if (action === 'copy') this.copied = this.selected
+    else if (action === 'paste') this.pasteCopied()
+    else if (action === 'hold') return
     else if (action === 'remove') this.removePart(this.selected)
     else this.selected = ''
   }
@@ -283,9 +291,7 @@ export class FigureEditor extends LitElement {
     session: () => this.session,
     error: () => this.error,
     notice: () => this.notice,
-    retry: () => this.retry,
-    refuse: message => (this.error = message),
-    command: action => this.linkCommand(action)
+    refuse: message => (this.error = message)
   })
   private panelMemory = new PanelMemory(() => this.renderRoot)
   /** The preview is made when first asked for, and kept (hidden) after that; it is taken down with the editor. */
@@ -331,6 +337,14 @@ export class FigureEditor extends LitElement {
       if (closed && this.selected === editing) this.selected = next
     })
   }
+  /** While the size tool is on a round part: which of its handles change the one diameter (ADR-0140 4.1). */
+  private renderSameMeasure(unavailable: boolean) {
+    if (unavailable || this.gizmoMode !== 'scale' || !this.selected) return nothing
+    const axes = sameMeasureAxesOf(this.reachOf(this.selected))
+    return axes
+      ? html`<p same-measure role="status">${i18next.t('figure.text.gizmo-same-measure', { axes: axes.map(a => a.toUpperCase()).join(' · ') })}</p>`
+      : nothing
+  }
   /** The scene toggles: the mode already shown takes the gizmo away. */
   private useGizmo(mode: 'translate' | 'rotate' | 'scale') {
     /*
@@ -412,6 +426,9 @@ export class FigureEditor extends LitElement {
   }
 
   private changed() {
+    /* What the step did to the size ends the author typed, said with whatever else it said. */
+    const fits = this.session?.takeSizeRangeFits() ?? []
+    if (fits.length) this.notice = [this.notice, sizeRangeFitsOf(fits, (key, params) => i18next.t(key, params))].filter(Boolean).join(' ')
     this.requestUpdate()
     this.dispatchEvent(new CustomEvent('changed', { bubbles: true, composed: true }))
   }
@@ -506,27 +523,16 @@ export class FigureEditor extends LitElement {
   private movePart(id: string, to: number) {
     this.run(() => this.session!.edit({ kind: 'move-part', target: id, to }))
   }
-  private removePart(id: string, refitRoom = false) {
-    this.retry = undefined
+  private removePart(id: string) {
     try {
-      const view = this.session!.edit({ kind: 'remove-part', target: id, ...(refitRoom ? { refitRoom: true } : {}) }) as { removal?: Parameters<typeof removalNoticeOf>[0] }
+      const view = this.session!.edit({ kind: 'remove-part', target: id }) 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) {
-      if (this.refusals.askClipLoss(error, () => this.removePart(id, refitRoom))) return
-      /*
-        A part in the declared space goes, and the space is fitted to the parts left, in the same click: every space
-        this product declares is fitted to the parts (「부품에 맞추기」, the AI's fit-room -- no padding), so fitting it
-        again keeps what it says, and there is nothing to ask (user, 2026-09-27: 「이 확인이 꼭 필요한가 ?」).
-      */
-      if (!refitRoom && inDeclaredRoom(error)) {
-        this.removePart(id, true)
-        if (!this.error) this.notice = [this.notice, i18next.t('figure.text.removal-space-refitted')].filter(Boolean).join(' ')
-        return
-      }
+      if (this.refusals.askClipLoss(error, () => this.removePart(id))) return
       this.error = partRefusalOf(error, id, (key, params) => i18next.t(key, params)) ?? this.said(error)
     }
   }
@@ -965,10 +971,8 @@ export class FigureEditor extends LitElement {
   private linkCommand(action: FigureAuthoringAction, from: 'section-editor' | 'panel' = 'panel'): boolean {
     /* Committed or refused, a command in hand is let go of: the figure as it stands is drawn again. */
     this.holdAction(null)
-    this.retry = undefined
     this.notice = ''
     const hadSize = this.hasSize()
-    const hadSpace = !!this.shown()?.asset.occupancy
     try {
       this.session!.command(action)
       this.error = ''
@@ -976,9 +980,7 @@ export class FigureEditor extends LitElement {
       /* What the command did besides what was asked, in one line: the figure's size declared to follow (ADR ruling Q1). */
       if (action.kind === 'follow-size' && !hadSize) {
         const size = this.designValues()
-        /* The same step may have fitted the space the figure takes to its parts (figure-model, ruling 2026-10-16 Q1 A): one line says both. */
-        const spaceToo = !hadSpace && !!this.shown()?.asset.occupancy
-        this.notice = i18next.t(spaceToo ? 'figure.text.size-and-space-declared-to-follow' : 'figure.text.size-declared-to-follow', {
+        this.notice = i18next.t('figure.text.size-declared-to-follow', {
           x: Math.round(size['size.x'] ?? 0).toLocaleString(),
           y: Math.round(size['size.y'] ?? 0).toLocaleString(),
           z: Math.round(size['size.z'] ?? 0).toLocaleString()
@@ -996,12 +998,6 @@ export class FigureEditor extends LitElement {
         this.error = ''
         return false
       }
-      const narrowing = narrowingRetryOf(action, error, (key, params) => i18next.t(key, params))
-      if (narrowing) {
-        this.error = narrowing.message
-        this.retry = { label: narrowing.label, action: narrowing.retry as FigureAuthoringAction }
-        return false
-      }
       this.error =
         code === 'DIMENSION_CYCLE'
           ? i18next.t('figure.text.follow-would-loop')
@@ -1086,21 +1082,21 @@ export class FigureEditor extends LitElement {
     label.addEventListener('pointerup', up)
     label.addEventListener('pointercancel', up)
   }
-  /** The sizes a board may give the figure, and the way to measure them again after its parts changed. */
+  /** The sizes a board may give the figure: the ends the author typed, and the rest as far as its parts allow. */
   private renderInstanceRange(shown: FigureRevision | undefined, unavailable: boolean) {
     if (!shown) return nothing
     const asset = shown.asset
-    /* Measured once per version: measuring evaluates the figure at its edges. */
+    /* Computed once per version: figure-model evaluates the figure at its edges. */
     const measured = derivedOf(shown, 'instance-range', () => {
       let of: ReturnType<typeof instanceRangeOf>
-      let toDeclare: ReturnType<typeof instanceRangeToDeclare>
+      let toDeclare: ReturnType<typeof instanceSizeToDeclare>
       try {
         of = instanceRangeOf(asset)
       } catch {
         of = undefined
       }
       try {
-        toDeclare = of ? undefined : instanceRangeToDeclare(asset)
+        toDeclare = of ? undefined : instanceSizeToDeclare(asset)
       } catch {
         toDeclare = undefined
       }
@@ -1121,13 +1117,17 @@ export class FigureEditor extends LitElement {
       return html`<section board-size>
         ${title('figure.text.board-size-fixed-explained')}
         <p fixed-size>${i18next.t('figure.text.board-size-fixed', { x: mm(toDeclare.at.x), y: mm(toDeclare.at.y), z: mm(toDeclare.at.z) })}</p>
-        <button act ?disabled=${unavailable} @click=${() => this.linkCommand({ kind: 'declare-instance-size', range: toDeclare.range, at: toDeclare.at })}>
+        <button act ?disabled=${unavailable} @click=${() => this.linkCommand({ kind: 'declare-instance-size', at: toDeclare.at })}>
           <md-icon>open_in_full</md-icon>${i18next.t('figure.button.declare-instance-size')}
         </button>
       </section>`
     if (!range) return nothing
-    const differs = rangeDiffers(range.declared, range.measured)
     const followers = sizeFollowersOf(asset)
+    /*
+      An end the author typed shows its number; an open end is empty, with what the parts allow written faintly in it
+      (ADR-0087 decision 6). Typing narrows that end, emptying the field opens it again.
+    */
+    const shownEnd = (r: (typeof range)['x'], bound: 'min' | 'max') => (bound === 'max' && !Number.isFinite(r.max) ? '∞' : mm(r[bound]))
     return html`<section board-size>
       ${title('figure.text.board-size-range-explained')}
       ${(['x', 'y', 'z'] as const).map(
@@ -1139,11 +1139,12 @@ export class FigureEditor extends LitElement {
                 aria-label=${`size.${axis}.${bound}`}
                 type="number"
                 step="any"
-                .value=${live(String(Math.round(range.declared[axis][bound])))}
+                .value=${live(range[axis].narrowed[bound] ? String(Math.round(range[axis][bound])) : '')}
+                placeholder=${shownEnd(range[axis], bound)}
                 ?disabled=${unavailable}
                 @change=${(e: Event) => {
-                  const next = rangeWith(range.declared, axis, bound, (e.target as HTMLInputElement).valueAsNumber)
-                  if (next) this.linkCommand({ kind: 'declare-instance-size', range: next, replace: true })
+                  const typed = (e.target as HTMLInputElement).valueAsNumber
+                  this.linkCommand({ kind: 'declare-instance-size', range: rangeWith(range, axis, bound, typed), replace: true })
                 }}
               />`
             )}
@@ -1157,19 +1158,6 @@ export class FigureEditor extends LitElement {
             })
           : i18next.t('figure.text.board-size-no-followers')}
       </p>
-      ${differs
-        ? html`<p hint>
-              ${i18next.t('figure.text.instance-range-can-widen', {
-                ranges: (['x', 'y', 'z'] as const)
-                  .filter(axis => rangeDiffers(range.declared, { ...range.declared, [axis]: range.measured[axis] }))
-                  .map(axis => `${axis.toUpperCase()} ${mm(range.measured[axis].min)} – ${mm(range.measured[axis].max)}`)
-                  .join(' · ')
-              })}
-            </p>
-            <button act ?disabled=${unavailable} @click=${() => this.linkCommand({ kind: 'declare-instance-size', range: range.measured, replace: true })}>
-              <md-icon>straighten</md-icon>${i18next.t('figure.button.remeasure-range')}
-            </button>`
-        : nothing}
       ${this.renderSizingRule(asset, unavailable)}
     </section>`
   }
@@ -1325,7 +1313,7 @@ export class FigureEditor extends LitElement {
       this.publishing?.part === part
         ? this.publishing
         : listed && input
-          ? { part, label: listed.label, min: input.min, max: input.max }
+          ? /* A published input has both ends (figure-model checkPublicInput). */ { part, label: listed.label, min: input.min!, max: input.max! }
           : undefined
     const open = !!form
     const edit = (key: 'label' | 'min' | 'max') => (e: Event) => {
@@ -1417,19 +1405,13 @@ export class FigureEditor extends LitElement {
     if (state === 'released') return i18next.t('figure.text.release-state-released', { version: String(version) })
     return version > 0 ? i18next.t('figure.text.release-state-draft-over', { version: String(version) }) : i18next.t('figure.text.release-state-draft-new')
   }
-  /** The findings that block release, under the bar beside 「발행」, each with the way out the verdict tab offers for it. */
-  private renderReleaseBlockers(blockers: FigureGateFinding[], asset: FigureAsset | undefined, unavailable: boolean) {
+  /** The findings that block release, under the bar beside 「발행」. */
+  private renderReleaseBlockers(blockers: FigureGateFinding[], asset: FigureAsset | undefined) {
     const parts = (asset?.appearance ?? []).map(look => look.target)
-    const way = (code: string) =>
-      (code === 'occupancy-undeclared' || code === 'part-outside-occupancy') && asset && parts.length
-        ? html`<button act ?disabled=${unavailable} @click=${() => this.linkCommand(occupancyFromParts(asset))}>
-            <md-icon>fit_screen</md-icon>${i18next.t('figure.button.fit-base-to-parts')}
-          </button>`
-        : nothing
     return html`<div release-blockers role="dialog" aria-label=${i18next.t('figure.text.must-fix-to-release')} @keydown=${(e: KeyboardEvent) => e.key === 'Escape' && (this.blockersOpen = false)}>
       <ul gate>
         <li head>${i18next.t('figure.text.must-fix-to-release')}</li>
-        ${blockers.map(finding => renderGateFinding(finding, true, way(finding.code), parts))}
+        ${blockers.map(finding => renderGateFinding(finding, true, nothing, parts))}
       </ul>
     </div>`
   }
@@ -1758,19 +1740,9 @@ export class FigureEditor extends LitElement {
     /* A repeat's own row values (its pitch) have their own section, not the shape's. */
     const own = design.filter(i => this.selected && i.id.startsWith(this.selected + '.') && !i.id.startsWith(this.selected + '.repeat.'))
     const common = design.filter(i => !view.geometry.some(g => i.id.startsWith(ownerOf(g.id) + '.')))
-    /*
-      A part's field only the declared room still reads -- its old height position once the floor holds it -- moves
-      nothing; it is shown apart as what it is, not as a position (ADR-0097, designer 2026-09-27).
-    */
     const shown = this.shown()
     const asset = shown?.asset
-    let roomOnly: string[] = []
-    try {
-      roomOnly = this.selected && asset ? figureRoomOnlyInputsOf(asset, this.selected) : []
-    } catch {
-      roomOnly = []
-    }
-    const partFields = own.filter(i => !roomOnly.includes(i.id))
+    const partFields = own
     /* The numbers a rule gives the axes that have no field of their own -- shown read-only, never as a blank. */
     let held: HeldValues | undefined
     try {
@@ -1787,7 +1759,6 @@ export class FigureEditor extends LitElement {
     } catch {
       held = undefined
     }
-    const roomFields = own.filter(i => roomOnly.includes(i.id))
     /*
       Only what is under way is said. Saved or not is the save button's: filled and pressable when there is something
       to save, dimmed when not -- the saved and unsaved words beside it said the same thing again in the primary
@@ -1840,7 +1811,7 @@ export class FigureEditor extends LitElement {
         </button>
         <button slot="commit" save ?disabled=${unavailable || (!view.dirty && !!view.id)} @click=${this.save}><md-icon>save</md-icon>${i18next.t('figure.button.save')}</button>
       </ox-canvas-bar>
-      ${this.blockersOpen && blockers.length ? this.renderReleaseBlockers(blockers, asset, unavailable) : nothing}
+      ${this.blockersOpen && blockers.length ? this.renderReleaseBlockers(blockers, asset) : nothing}
       ${this.catalogOpen
         ? html`<figure-recipe-catalog
             .templates=${this.templates}
@@ -1921,7 +1892,7 @@ export class FigureEditor extends LitElement {
           @render-error=${(e: CustomEvent<Error>) => {
             this.error = e.detail.message
           }}
-        ></figure-canvas></div>
+        ></figure-canvas>${this.renderSameMeasure(unavailable)}</div>
         <aside slot="end">
           <div tabs>
             ${this.renderTab('properties', 'tune', i18next.t('figure.label.properties'))}
@@ -1950,7 +1921,6 @@ export class FigureEditor extends LitElement {
                     ${this.renderRepeatNote(view.geometry)}
                   </section>
                   ${this.renderPartGroups(shown, view.geometry, partFields, unavailable, held)}
-                  ${roomFields.length ? this.renderRoomOnly(roomFields, unavailable) : nothing}
                   <figure-material-panel
                     .body=${{ ...part, id: this.selected }}
                     .palette=${view.palette ?? {}}
@@ -2096,60 +2066,6 @@ export class FigureEditor extends LitElement {
     if (fastened && placed) return html`<p hint held-axes>${i18next.t('figure.text.held-by-fastening')}</p>`
     return html`<p hint held-axes>${i18next.t('figure.text.held-worked-out', { group: held.map(g => i18next.t('figure.label.group-' + g.name)).join(' · ') })}</p>`
   }
-  /**
-   * A part's fields only the declared room still reads (ADR-0097, designer 2026-09-27): shown as what they are and not
-   * typed into -- they move nothing. Declaring the room again is offered; nothing is deleted or widened on the way.
-   */
-  private renderRoomOnly(fields: FieldLike[], unavailable: boolean) {
-    return html`<section room-only>
-      <h3>${i18next.t('figure.label.room-only-inputs')}</h3>
-      <p hint>${i18next.t('figure.text.room-only-inputs')}</p>
-      <div form>
-        ${fields.map(
-          f => html`<span>${fieldWordsOf(f.id, key => i18next.t(key))} (${f.unit})</span><input aria-label=${f.id} type="number" .value=${String(f.value)} disabled />`
-        )}
-      </div>
-      <button act room-refit ?disabled=${unavailable} @click=${() => this.askRoomRefit()}><md-icon>fit_screen</md-icon>${i18next.t('figure.button.room-refit')}</button>
-    </section>`
-  }
-  /** The room as declared and as proposed, and what lies outside each as measured, before the author confirms. */
-  private async askRoomRefit() {
-    let refit
-    try {
-      refit = figureRoomRefitOf(this.shown()!.asset)
-    } catch (error) {
-      this.error = this.said(error)
-      return
-    }
-    if (!refit) return
-    const rows = roomRefitRowsOf(refit)
-    const outside = (list: typeof refit.outside.declared) =>
-      list.length
-        ? list.map(o => i18next.t('figure.text.room-part-outside', { part: partLabelOf(o.part), axis: o.axis.toUpperCase(), mm: String(o.mm) })).join(' · ')
-        : i18next.t('figure.text.room-nothing-outside')
-    const agreed = await OxPrompt.open({
-      type: 'question',
-      title: i18next.t('figure.label.room-refit'),
-      template: html`<table room-refit>
-          <tr><th></th><th>${i18next.t('figure.label.room-declared')}</th><th>${i18next.t('figure.label.room-proposed')}</th></tr>
-          ${rows.map(
-            r => html`<tr>
-              <td>${i18next.t(`figure.label.room-at-${r.at}`)} ${r.axis.toUpperCase()}</td>
-              <td>${r.declared}</td>
-              <td>${r.same ? i18next.t('figure.text.room-same') : r.proposed}</td>
-            </tr>`
-          )}
-        </table>
-        <p>${i18next.t('figure.label.room-declared')}: ${outside(refit.outside.declared)}</p>
-        <p>${i18next.t('figure.label.room-proposed')}: ${outside(refit.outside.proposed)}</p>
-        ${refit.drops.length
-          ? html`<p>${i18next.t('figure.text.room-drops', { fields: [...new Set(refit.drops.map(id => `${partLabelOf(id.split('.')[0]!)} ${fieldWordsOf(id, key => i18next.t(key))}`))].join(' · ') })}</p>`
-          : nothing}`,
-      confirmButton: { text: i18next.t('figure.button.room-refit-confirm') },
-      cancelButton: { text: i18next.t('figure.button.keep-editing') }
-    })
-    if (agreed) this.linkCommand(refit.step)
-  }
   private renderSingle(name: string, field: FieldLike, unavailable: boolean) {
     const words = name.split('.').map(part => i18next.t('figure.label.field-' + part, { defaultValue: part }))
     return html`<span ?scrub=${!unavailable} @pointerdown=${(e: PointerEvent) => this.scrub(field as never, e, unavailable)}>${words.join(' · ')} (${field.unit})</span

package/client/modeller/fasten-form.ts

@@ -1,4 +1,4 @@
-import { FIGURE_FACES, figureFastenTargetAt, figurePlaneFacingOf, figureSurfaceKeptPlaceOf } from '@hatiolab/figure-model'
+import { FIGURE_FACES, figureFastenKeptGapOf, figureFastenTargetAt, figurePlaneFacingOf, figureSurfaceKeptPlaceOf } from '@hatiolab/figure-model'
 import type { FigureAuthoringAction, FigureFace, FigureSurfacePlace } from '@hatiolab/figure-model'
 
 import { faceViewOf, type FaceView, type FastenMode, type FastenTarget } from './fasten-geometry.js'
@@ -38,6 +38,12 @@ export interface FastenForm {
   gap: number
   /** The record's gap when it is worked out (a length that follows something): kept until a number is typed. */
   gapKept: unknown
+  /**
+   * Where the gap came from (ADR-0140 stage 4, 「현재 상태로 붙이기」): `kept` -- the distance the part stands at, worked
+   * out again whenever where or how it is fastened changes, so fastening does not move it; `typed` -- the author's
+   * number, left as it is; `pressed` -- 0, the part put where the canvas was pressed.
+   */
+  gapFrom: 'kept' | 'typed' | 'pressed'
   align: Partial<Record<Axis, Alignment>>
   alignMm: Partial<Record<Axis, number>>
   alignInput: Partial<Record<Axis, string>>
@@ -52,6 +58,7 @@ export const freshFasten = (): FastenForm => ({
   facing: 'meet',
   gap: 0,
   gapKept: undefined,
+  gapFrom: 'kept',
   align: {},
   alignMm: {},
   alignInput: {}
@@ -60,7 +67,9 @@ export const freshFasten = (): FastenForm => ({
 /** The part's own fastening as a form, or a fresh one: a window opens on what the part has (walk 1, 2026-09-26). */
 export function fastenFormOf(revision: FigureRevision, part: string): FastenForm {
   const own = fasteningOf(revision, part)
-  return own && !own.atOrigin ? ({ ...freshFasten(), ...own } as FastenForm) : freshFasten()
+  if (!own || own.atOrigin) return freshFasten()
+  /* A gap the record works out is the author's; a number is where the part stands, so aiming again keeps it there. */
+  return { ...freshFasten(), ...own, gapFrom: own.gapKept !== undefined ? 'typed' : 'kept' } as FastenForm
 }
 
 /** What a part may be fastened to: every other part that can be, each said whether it would close a loop. */
@@ -133,11 +142,11 @@ export function fastenChanged(
   change: FastenChange
 ): FastenForm {
   const f = form
-  if ('targetFace' in change) return aimFasten(revision, part, f, { targetFace: change.targetFace as FigureFace })
-  if ('onSurface' in change) return aimFasten(revision, part, f, { surface: true })
-  if ('surface' in change) return { ...f, surface: change.surface }
-  if ('mode' in change) return { ...f, facing: change.mode }
-  if ('gap' in change) return { ...f, gap: change.gap, gapKept: undefined }
+  if ('targetFace' in change) return keptGapOf(revision, part, aimFasten(revision, part, f, { targetFace: change.targetFace as FigureFace }))
+  if ('onSurface' in change) return keptGapOf(revision, part, aimFasten(revision, part, f, { surface: true }))
+  if ('surface' in change) return keptGapOf(revision, part, { ...f, surface: change.surface })
+  if ('mode' in change) return keptGapOf(revision, part, { ...f, facing: change.mode })
+  if ('gap' in change) return { ...f, gap: change.gap, gapKept: undefined, gapFrom: 'typed' }
   return {
     ...f,
     align: { ...f.align, [change.axis]: change.how },
@@ -145,6 +154,29 @@ export function fastenChanged(
   }
 }
 
+/**
+ * The form with the gap that keeps the part where it stands (ADR-0140 stage 4, user 2026-10-20 「현재 상태로 붙이기」):
+ * figure-model's `figureFastenKeptGapOf` for what it is aimed at and how it meets it. A gap the author typed, or the 0 a
+ * canvas press puts, is left as it is. Nothing aimed at yet, the form is as it was.
+ */
+export function keptGapOf(revision: FigureRevision, part: string, form: FastenForm): FastenForm {
+  if (form.gapFrom !== 'kept') return form
+  const asset = revision.asset
+  const theirFaces = form.target ? facesOf(asset, form.target) : FACES
+  const targetFace = (theirFaces.includes(form.targetFace) ? form.targetFace : theirFaces[0]) as FigureFace
+  const planeWay = figurePlaneFacingOf(asset)
+  const mode: FastenMode = form.toPlane ? (mountingPlaneOf(asset).facings.includes(form.facing) ? form.facing : (planeWay ?? 'meet')) : form.facing
+  const to = form.toPlane
+    ? ('plane' as const)
+    : form.target && form.surface && surfaceOf(asset, form.target)
+      ? { part: form.target, surface: form.surface }
+      : form.target
+        ? { part: form.target, face: targetFace }
+        : undefined
+  if (!to) return form
+  return { ...form, gap: figureFastenKeptGapOf(asset, part, to, mode, { ...revision.inputs }), gapKept: undefined }
+}
+
 /** What a form comes to: the face aimed at, the way, the drawing of the face and the command. */
 export interface FastenPlan {
   /** Nothing is aimed at until a part or the plane is chosen. */
@@ -226,12 +258,16 @@ export function fastenSentenceOf(
   return say(`figure.text.fasten-sentence-${plan.mode}`, { to })
 }
 
-/** What the folded details hold that is not their default, said while folded; nothing for the default. */
+/**
+ * What the folded details hold that is not their default, said while folded; nothing for the default. The gap's default
+ * is the one it starts at -- the distance the part stands at, or 0 where the canvas was pressed -- so only a number typed
+ * is said.
+ */
 export function fastenDetailWordsOf(form: FastenForm, say: Say): string[] {
   return [
     ...(form.gapKept !== undefined
       ? [say('figure.text.fasten-summary-gap-worked-out')]
-      : form.gap
+      : form.gapFrom === 'typed' && form.gap
         ? [say('figure.text.fasten-summary-gap', { mm: String(form.gap) })]
         : [])
   ]
@@ -244,6 +280,9 @@ export function fastenDetailWordsOf(form: FastenForm, say: Say): string[] {
  * nothing to fasten to is not aimed at; a press on a curve there is no fastening to aims at the part alone. Each says
  * why, by its words' key.
  */
+/* Put where the canvas was pressed: on the face or the surface there, with no gap (ADR-0140 stage 4). */
+const PRESSED = { gap: 0, gapKept: undefined, gapFrom: 'pressed' as const }
+
 export function aimFastenAt(
   revision: FigureRevision,
   part: string,
@@ -265,8 +304,8 @@ export function aimFastenAt(
     /* On the face where it was pressed, as a point of a curved surface is: its middle there. */
     const onFace = aimFasten(revision, part, { ...aimed, surface: undefined }, { targetFace: lands.face as FigureFace })
     const at = lands.at as Partial<Record<Axis, number>>
-    return { form: { ...onFace, align: Object.fromEntries(Object.keys(at).map(a => [a, 'mm'])) as FastenForm['align'], alignMm: { ...at }, alignInput: {} }, part: target }
+    return { form: { ...onFace, ...PRESSED, align: Object.fromEntries(Object.keys(at).map(a => [a, 'mm'])) as FastenForm['align'], alignMm: { ...at }, alignInput: {} }, part: target }
   }
-  if ('surface' in lands) return { form: { ...aimed, toPlane: false, target, surface: lands.surface, align: {}, alignMm: {}, alignInput: {} }, part: target }
+  if ('surface' in lands) return { form: { ...aimed, ...PRESSED, toPlane: false, target, surface: lands.surface, align: {}, alignMm: {}, alignInput: {} }, part: target }
   return { form: aimed, note: 'aim-not-here', part: target }
 }

package/client/modeller/figure-facts.ts

@@ -27,7 +27,7 @@ export function figureFigureFacts(revision: FigureRevision): FigureFigureFacts {
 }
 function figureFactsOf(revision: FigureRevision): FigureFigureFacts {
   const asset = revision.asset as FigureAsset
-  const feature = (asset.occupancy?.contact as { surface?: { feature?: string } } | undefined)?.surface?.feature
+  const feature = asset.mountingFace?.surface.feature
   const found = feature?.match(/^(.+)\.mount\.(left|right|bottom|top|back|front)\.value$/)
   return {
     name: asset.name,

package/client/modeller/figure-fasten-dialog.ts

@@ -16,6 +16,7 @@ import { turnsInPlace, type FastenMode } from './fasten-geometry.js'
 import {
   aimFasten,
   aimFastenAt,
+  keptGapOf,
   fastenChanged,
   fastenDetailWordsOf,
   fastenFormOf,
@@ -260,7 +261,7 @@ export class FigureFastenDialog extends localize(i18next)(LitElement) {
                       step="any"
                       .value=${f.gapKept !== undefined ? '' : String(f.gap)}
                       placeholder=${f.gapKept !== undefined ? i18next.t('figure.label.follows-expression') : ''}
-                      @change=${(e: Event) => this.set({ gap: Number((e.target as HTMLInputElement).value) || 0, gapKept: undefined })}
+                      @change=${(e: Event) => this.set({ gap: Number((e.target as HTMLInputElement).value) || 0, gapKept: undefined, gapFrom: 'typed' })}
                     />
                   </div>
                 </details>
@@ -330,7 +331,7 @@ export class FigureFastenDialog extends localize(i18next)(LitElement) {
     this.aimNote = ''
     const chosen = this.form.toPlane ? PLANE : this.form.target
     if (part === chosen) return
-    this.form = aimFasten(this.revision, this.partId, this.form, part === PLANE ? { plane: true } : { part })
+    this.form = keptGapOf(this.revision, this.partId, aimFasten(this.revision, this.partId, this.form, part === PLANE ? { plane: true } : { part }))
   }
 
   /**

package/client/modeller/figure-history-panel.ts

@@ -401,35 +401,7 @@ export class FigureHistoryPanel extends localize(i18next)(LitElement) {
    * 준다 — 화면이 문장을 지으면 서버가 거절할 때와 다른 말을 하게 된다.
    */
   private renderFinding(finding: FigureGateFinding, blocking: boolean) {
-    return renderGateFinding(finding, blocking, html`
-        ${this.offersFit(finding.code)
-          ? html`<button fit-base @click=${() => this.fitBase()}>
-              ${i18next.t('figure.button.fit-base-to-parts')}
-            </button>`
-          : nothing}
-    `)
-  }
-
-  /**
-   * 넘친 것을 담는 길 하나를 여기서도 내민다 — **같은 동작이 속성 패널에도 있다**(「부품에 맞추기」).
-   *
-   * 그 단추를 아는 저작자는 거기서 누른다. 발행이 막혔다는 말을 여기서 읽은 사람은 그 단추가 있는
-   * 것을 모르고, 문구는 그것을 가리킬 수 없다 — 문장은 형식이 쓰고 형식은 화면의 단추를 모른다.
-   * 그래서 화면이 자기 자리에서 같은 동작을 낸다. 누르면 상자만 커지고 부품은 제자리이며, 저장은
-   * 여전히 저작자가 따로 한다.
-   */
-  /**
-   * 「부품에 맞추기」를 내미는 판정: 공간을 부품에서 다시 선언한다(`declare-occupancy`) — 부품은 그대로 두고 선언만
-   * 바꾼다. 공간을 아직 선언하지 않은 도형도 같은 단추로 선언한다: 새로 만든 도형은 전부 그 판정으로 막히고, 화면에
-   * 다른 길이 없다. 장착면이 떠 있는 것은 여기 없다 — 부품 하나를 평면에 붙여도 거기 붙지 않은 것은 따라오지 않는다.
-   * 판정의 「어떻게」가 할 일을 말한다.
-   */
-  private offersFit(code: string): boolean {
-    return code === 'part-outside-occupancy' || code === 'occupancy-undeclared'
-  }
-
-  private fitBase() {
-    this.dispatchEvent(new CustomEvent('fit-base-to-parts', { bubbles: true, composed: true }))
+    return renderGateFinding(finding, blocking, nothing)
   }
 
   /** Where one released version downloads as a package file, or undefined before the figure has a full name. */

package/client/modeller/figure-links.ts

@@ -278,7 +278,7 @@ export class FigureLinks extends localize(i18next)(LitElement) {
         <section size-response>
           <h3>${i18next.t('figure.label.group-size')}</h3>
           <p group-question>${i18next.t('figure.label.resize-intent')}</p>
-          ${canFollow(asset, this.partId) ? this.renderDimensions(asset) : html`<p hint>${i18next.t('figure.text.links-need-a-box')}</p>`}
+          ${canFollow(asset, this.partId) ? this.renderDimensions(asset) : html`<p hint>${i18next.t('figure.text.part-cannot-follow')}</p>`}
         </section>
         ${positions.length
           ? html`<section position-response>
@@ -302,7 +302,7 @@ export class FigureLinks extends localize(i18next)(LitElement) {
           ${groupMenu([{ label: i18next.t('figure.button.detach'), icon: 'link_off', disabled: this.locked || !held, run: () => this.command({ kind: 'detach', part: this.partId }) }])}
         </h3>${this.help.hint('figure.text.fastening-explained')}
         <slot name="place"></slot>
-        ${canFasten(asset, this.partId) ? this.renderFastening(asset) : html`<p hint>${i18next.t('figure.text.links-need-a-box')}</p>`}
+        ${canFasten(asset, this.partId) ? this.renderFastening(asset) : html`<p hint>${i18next.t('figure.text.part-cannot-fasten')}</p>`}
       </section>
     `
     this.candidate = this.fastenCandidate