@things-factory/figure-ui 10.1.65 → 10.1.67

package/client/modeller/modeller-route.ts

@@ -1,7 +1,6 @@
 /**
- * The one modeller. Every figure is V3 since ADR-0087 step 5 (2026-09-24, user decision: V2 is not kept), so the
- * catalogue, a new figure and an old address all open the same page. `figure-v3-modeller` stays as an alias so a
- * link written before the switch still lands.
+ * The one modeller. The catalogue, a new figure and an old address all open the same page. `figure-v3-modeller`
+ * stays as an alias so a link written under that name still lands.
  */
 export const MODELLER = 'figure-modeller'
 

package/client/modeller/scene-budget.ts

@@ -1,4 +1,3 @@
-import type { FigureCost } from '@hatiolab/figure-model'
 
 /**
  * 한 화면이 감당하는 양 — 「몇 개까지 편한가」의 분모.
@@ -56,19 +55,6 @@ export interface FigureCapacity {
   budget: number
 }
 
-/**
- * 몇 개까지 놓을 수 있나.
- *
- * 두 예산 중 **먼저 차는 쪽**이 답이다. 평균이나 곱을 내지 않는다 — 하나만 꽉 차도
- * 그것이 병목이고, 저작자가 고쳐야 할 곳은 그 하나다.
- *
- * 셈은 여기서 하지만 재료는 전부 figure-model 이 낸 것이다. `cost.groups` 가 인스턴스
- * 하나당 draw call 이고 `cost.triangles` 가 인스턴스 하나의 삼각형 수다.
- */
-export function capacityOf(cost: FigureCost): FigureCapacity | undefined {
-  return capacityFrom(cost.groups, cost.triangles)
-}
-
 /**
  * 저장된 값만으로 셈한다.
  *

package/client/modeller/side-panel-styles.ts

@@ -1,14 +1,14 @@
 import { css } from 'lit'
 
 /**
- * The side panel's one look -- V2's inspector, for every element that draws in the V3 modeller's side.
+ * The side panel's one look, for every element that draws in the modeller's side.
  *
  * The side is drawn by several elements (the type field, the figure's properties, a part's values, fastening, places,
  * motion, material, controls, clips, the environment) and each had styled its own fields: three label styles and
  * three field heights in one column (user, 2026-09-24: "why are the styles and layout all different?"). They share
  * this sheet now and keep only what is theirs.
  *
- * The vocabulary, V2's:
+ * The vocabulary:
  *   section              one titled group; the side is a stack of them
  *   h3                   a group's title -- small capitals
  *   div[inline-field]    a short label and its one field on one line
@@ -28,7 +28,7 @@ export const SidePanelStyles = css`
     font-size: 0.76rem;
     color: var(--md-sys-color-on-surface);
   }
-  /* The side is a stack of sections, each a titled group (V2's inspector). */
+  /* The side is a stack of sections, each a titled group. */
   section {
     display: grid;
     gap: 6px;
@@ -101,7 +101,7 @@ export const SidePanelStyles = css`
   div[vector-row] + div[inline-field] {
     margin-top: 5px;
   }
-  /* A row of icon tools (align, mirror, snap), as V2's placement section had them. */
+  /* A row of icon tools (align, mirror, snap). */
   div[tools] {
     display: flex;
     flex-wrap: wrap;
@@ -270,7 +270,7 @@ export const SidePanelStyles = css`
     font-size: 0.76rem;
     color: var(--md-sys-color-on-surface);
   }
-  /* The 「?」 beside a title: no border, it says there is more rather than asking to be pressed (V2). */
+  /* The 「?」 beside a title: no border, it says there is more rather than asking to be pressed. */
   button[help] {
     display: inline-flex;
     align-items: center;

package/client/modeller/v3-align.ts

@@ -1,15 +1,13 @@
 import { compileV3Asset, v3OccupiedBoxesOf, v3WritersOf } from '@hatiolab/figure-model'
 import type { V3Asset, V3InputChange, V3WorldBox } from '@hatiolab/figure-model'
 
-import { niceStep } from './part-edits.js'
 import type { GizmoReach } from './v3-gizmo.js'
 
 /**
- * 맞추기 — the V2 inspector's align tools on a V3 part (parity row ③): centre on X, centre on Z, stand on the floor,
+ * 맞추기 — the align tools on a part: centre on X, centre on Z, stand on the floor,
  * mirror on X or Z, snap to the grid.
  *
- * V2 measured against its base box, which ran from 0 to its size on each axis. A V3 asset's frame has the floor at
- * y 0 and X and Z centred on 0, so centring puts the part's box centre on 0 and the floor puts its lowest point on
+ * The asset's frame has the floor at y 0 and X and Z centred on 0, so centring puts the part's box centre on 0 and the floor puts its lowest point on
  * y 0. The part's box is its evaluated, rotated extent (`v3OccupiedBoxesOf`), so a turned part lands by what it
  * actually covers, not by its unturned size.
  *
@@ -25,7 +23,7 @@ export function boxOf(asset: V3Asset, part: string): V3WorldBox | undefined {
   return v3OccupiedBoxesOf(geometry, v3WritersOf(asset)).find(box => box.part === part)
 }
 
-/** The grid V2 snaps to: about five steps across the figure, on 1 · 2 · 5 multiples. */
+/** The snapping grid: about five steps across the figure, on 1 · 2 · 5 multiples. */
 export function gridStepOf(asset: V3Asset): number {
   const geometry = compileV3Asset(asset).evaluate().geometry
   const boxes = v3OccupiedBoxesOf(geometry, v3WritersOf(asset))
@@ -77,8 +75,20 @@ export function mirrorChanges(asset: V3Asset, part: string, copy: string, axis:
   return [{ kind: 'set-design', input: `${copy}.position.${axis}`, unit: 'mm', value: Math.round((asset.designInputs[id] ?? 0) - 2 * box.centre[axis]) }]
 }
 
-/** Mirroring a part that already sits on the centre plane would put the copy inside it — V2 refuses it too. */
+/** Mirroring a part that already sits on the centre plane would put the copy inside it, so it is refused. */
 export function canMirror(asset: V3Asset, part: string, axis: 'x' | 'z', reach: GizmoReach): boolean {
   const box = reach.translate ? boxOf(asset, part) : undefined
   return !!box && Math.abs(box.centre[axis]) >= 0.5
 }
+
+/**
+ * A **readable** grid step for a length: about five cells, rounded up to a 1, 2 or 5 multiple as rulers and charts do.
+ * Divided plainly it gives 27 or 33, and coordinates snapped to that read as 54 and 81. Never 0.
+ */
+export function niceStep(span: number): number {
+  const raw = Math.max(span, 1) / 5
+  const magnitude = Math.pow(10, Math.floor(Math.log10(raw)))
+  const n = raw / magnitude
+  const multiple = n < 1.5 ? 1 : n < 3.5 ? 2 : n < 7.5 ? 5 : 10
+  return Math.max(1, multiple * magnitude)
+}

package/client/modeller/v3-canvas.ts

@@ -11,10 +11,10 @@ import { JOINT_FAN } from './v3-joint-fan.js'
 import { ownerOf } from './v3-fields.js'
 
 /*
- * The V3 modeller's canvas -- a things-scene board in editing mode, as the V2 modeller's was.
+ * The modeller's canvas -- a things-scene board in editing mode.
  *
- * Each body figure-model evaluates stands on the board as a `figure-v3-part` component, so everything the V2 canvas
- * had comes from the scene, not from code of our own: picking and the orange outline, the gizmo with its snapping and
+ * Each body figure-model evaluates stands on the board as a `figure-v3-part` component, so everything the canvas
+ * has comes from the scene, not from code of our own: picking and the orange outline, the gizmo with its snapping and
  * live readout, box and shift selection, the camera (damping, zoom toward the cursor, double-click to fit, the six
  * view presets and their keys), the studio environment, the coordinate ground, lights and shadows, supersampling.
  * An earlier canvas drew the bodies with three.js directly and lost all of that (user, 2026-09-24: "why nerf it?").
@@ -90,7 +90,7 @@ export class FigureV3Canvas extends LitElement {
   /**
    * View only: nothing that happens on the board is told out. The card's picture is taken from a second canvas stood up
    * off screen (`v3-thumbnail.ts`); the scene settles its components as it builds them, and a change told from there
-   * would reach the editor as an edit (V2's `viewOnly`, for the same reason).
+   * would reach the editor as an edit.
    */
   @property({ type: Boolean }) viewOnly = false
   /** Where the selected part turns and how far (`v3-joint-fan`): shown, never picked, never saved. */
@@ -131,9 +131,9 @@ export class FigureV3Canvas extends LitElement {
 
   /**
    * The board as a picture, for the card: the 3D view at this size, or nothing when it cannot be taken. The scene's
-   * `toDataURL` renders the 2D board (a white sheet, V2 found), and the 3D renderer keeps no drawing buffer, so the
+   * `toDataURL` renders the 2D board (a white sheet), and the 3D renderer keeps no drawing buffer, so the
    * scene's own `snapshot3d` draws and reads in one task. A picture that cannot be taken is not an error and is not
-   * faked (V2's `snapshot`, lost when this canvas moved onto the scene -- no card had a picture since, user 2026-09-24).
+   * faked (user, 2026-09-24: no card had a picture after this canvas moved onto the scene).
    */
   async snapshot(width = 480, height = 360): Promise<string | undefined> {
     const layer = this.scene?.root as (SceneLayer & { snapshot3d?: (w?: number, h?: number, type?: string, quality?: number) => Promise<string | undefined> }) | undefined
@@ -148,7 +148,7 @@ export class FigureV3Canvas extends LitElement {
     }
   }
 
-  /** The whole figure in view: the board's fit, then the 3D camera's own, as V2 did. */
+  /** The whole figure in view: the board's fit, then the 3D camera's own. */
   fit() {
     this.scene?.fit?.('ratio')
     this.scene?.root?.fitCameraToModel?.()
@@ -188,7 +188,7 @@ export class FigureV3Canvas extends LitElement {
           height: needed.height,
           depth: needed.depth,
           threed: true,
-          /* Two samples a pixel: MSAA alone leaves steps on the silhouettes of one asset shown large (V2). */
+          /* Two samples a pixel: MSAA alone leaves steps on the silhouettes of one asset shown large. */
           pixelRatio: Math.min(3, (window.devicePixelRatio || 1) * 2),
           ...sceneLook(this.view ?? DEFAULT_VIEW),
           gridStep: niceGridStep(Math.max(needed.width, needed.height)),
@@ -196,7 +196,7 @@ export class FigureV3Canvas extends LitElement {
           fillStyle: PAPER,
           components: this.components()
         },
-        /* Editing mode: the camera view buttons, gizmo modes, help and keys V2's canvas had. */
+        /* Editing mode: the camera view buttons, gizmo modes, help and keys. */
         mode: 1
       }) as SceneHandle
       this.standingFor = this.context
@@ -280,7 +280,7 @@ export class FigureV3Canvas extends LitElement {
     })
     /*
       A change comes up to the board with the component in the last argument's `origin` (the scene appends
-      { origin, name, deliverer } as it bubbles). Reading the first argument as the component does nothing (V2).
+      { origin, name, deliverer } as it bubbles). Reading the first argument as the component does nothing.
     */
     /*
       A drag is written once, when it ends. The scene's gizmo writes the component on every move -- a size anchored on
@@ -323,8 +323,8 @@ export class FigureV3Canvas extends LitElement {
   private commit() {
     /*
       Not while a pointer is down: a pause set by a change just before the press (the arrow keys, the scene settling
-      the pick) fired in the middle of the drag and wrote where the part was then -- a drag on a converted part became
-      two steps, the first one a few millimetres in (browser check, 2026-09-25). What is pending waits for the release.
+      the pick) fired in the middle of the drag and wrote where the part was then -- a drag on a part placed by a rule
+      became two steps, the first one a few millimetres in (browser check, 2026-09-25). What is pending waits for the release.
     */
     if (this.pointerDown || !this.board || !this.pending.size) return
     const changed = [...this.pending]

package/client/modeller/v3-clips.ts

@@ -2,7 +2,7 @@ import { driverValue } from '@hatiolab/figure-model'
 import type { V3Asset, V3Driver, V3InputChange } from '@hatiolab/figure-model'
 
 /*
- * The figure's clips -- V2's animations: controls played by keys over time, grouped into clips that each run on one
+ * The figure's clips: controls played by keys over time, grouped into clips that each run on one
  * clock. Kept apart from the element so the reading is tested without a browser.
  */
 export interface ClipKey {

package/client/modeller/v3-controls.ts

@@ -1,7 +1,7 @@
 import type { V3Asset } from '@hatiolab/figure-model'
 
 /*
- * The figure's controls -- its state inputs, what V2 called parameters: the values a board or a connector sets to pose
+ * The figure's controls -- its state inputs: the values a board or a connector sets to pose
  * the figure (a lift height, a joint angle, a gripper opening). Kept apart from the element so the reading is tested
  * without a browser.
  */

package/client/modeller/v3-editor.ts

@@ -29,7 +29,7 @@ import type { V3PaletteKind, V3PartRow } from './figure-v3-parts.js'
 import { paletteRecipe } from './v3-palette.js'
 import type { FigureV3Canvas } from './v3-canvas.js'
 import { nudgeOf } from './v3-stage-model.js'
-import { inDeclaredRoom, narrowingRetryOf, partRefusalOf, placementRefusalOf, sizeRangeRefusalOf } from './v3-refusals.js'
+import { inDeclaredRoom, inputRangeRefusalOf, narrowingRetryOf, partRefusalOf, placementRefusalOf, sizeRangeRefusalOf } from './v3-refusals.js'
 import type { V3RenderPart } from './v3-renderer.js'
 import type { V3BudgetLine } from './v3-maturity.js'
 import { instanceRangeOf, instanceRangeToDeclare, proportionToFollow, rangeDiffers, rangeWith, turnsAboutAJoint, valueNow } from './v3-links.js'
@@ -40,8 +40,7 @@ import { isLive, livePartsOf, liveOverSession, NOTHING_LIVE, scrubbed, scrubStep
 
 
 /**
- * The side's tabs, V2's six in V2's order where V3 has them: properties, what it does (places), motion, the verdict,
- * the release history. A figure-level tab (verdict, history) gives way to properties when a part is chosen; a tab about
+ * The side's tabs: properties, what it does (places), motion, the verdict, the view, the release history. A figure-level tab (verdict, history) gives way to properties when a part is chosen; a tab about
  * parts keeps showing the newly chosen part.
  */
 type SideTab = 'properties' | 'capability' | 'motion' | 'verdict' | 'view' | 'history'
@@ -106,7 +105,7 @@ export class FigureV3Editor extends LitElement {
       min-width: 0;
       min-height: 0;
     }
-    /* The side: tabs over one panel at a time, each using the whole height (V2's side, and why it had tabs). */
+    /* The side: tabs over one panel at a time, each using the whole height. */
     aside {
       display: flex;
       flex-direction: column;
@@ -228,7 +227,7 @@ export class FigureV3Editor extends LitElement {
   `]
   @property({ attribute: false }) session?: V3ProductSession
   @property({ type: Number }) revision = 0
-  /** The verdict's count, drawn on its tab so it stays in sight while another tab is open (V2's badge). */
+  /** The verdict's count, drawn on its tab so it stays in sight while another tab is open. */
   @property({ type: Number }) instances?: number
   /** The cost line the parts list shows, from the maturity report. */
   @property({ attribute: false }) budget?: V3BudgetLine
@@ -244,10 +243,10 @@ export class FigureV3Editor extends LitElement {
   @state() private tab: SideTab = 'properties'
   /** The frame the bar folds - found after the first render, since the bar is drawn before it. */
   @state() private panes?: OxThreePane
-  /** What the middle shows: the parts being edited, or the figure placed on a board at eight sizes (V2's two modes). */
+  /** What the middle shows: the parts being edited, or the figure placed on a board at eight sizes. */
   @state() private middle: 'edit' | 'preview' = 'edit'
   /**
-   * How the workbench shows the figure -- V2's view settings, the board's own state names. The viewer's, kept in
+   * How the workbench shows the figure, in the board's own state names. The viewer's, kept in
    * their browser, never in the figure.
    */
   @state() private view: ViewSettings = FigureV3Editor.storedView()
@@ -268,8 +267,8 @@ export class FigureV3Editor extends LitElement {
     }
   }
   /**
-   * Parts hidden on the workbench — the author's view while working, not the asset's visibility. Not saved, as in
-   * the V2 modeller: a part hidden here is still in the figure, still checked, still drawn on a board.
+   * Parts hidden on the workbench — the author's view while working, not the asset's visibility. Not saved: a part
+   * hidden here is still in the figure, still checked, still drawn on a board.
    */
   @state() private hiddenParts = new Set<string>()
   /** A value in hand -- typed, held on a spinner, scrubbed, dragged -- drawn at once and recorded on release. */
@@ -290,7 +289,7 @@ export class FigureV3Editor extends LitElement {
     /*
       The session's history is the only one. With the canvas focused the scene took Ctrl+Z as well, undoing on its own
       board the last value the canvas had written -- which the canvas then told as a drag: an undo of a drag on a
-      converted part wrote the drag again (2026-09-25). Heard first (capture) and kept from the scene.
+      part placed by a rule wrote the drag again (2026-09-25). Heard first (capture) and kept from the scene.
     */
     e.stopPropagation()
     if (action === 'translate' || action === 'rotate' || action === 'scale') canvas?.gizmo(action)
@@ -324,7 +323,8 @@ export class FigureV3Editor extends LitElement {
       this.error = ''
       this.changed()
     } catch (error) {
-      this.error = sizeRangeRefusalOf(error, (key, params) => i18next.t(key, params)) ?? (error instanceof Error ? error.message : String(error))
+      const say = (key: string, params: Record<string, string>) => i18next.t(key, params)
+      this.error = sizeRangeRefusalOf(error, say) ?? inputRangeRefusalOf(error, say) ?? (error instanceof Error ? error.message : String(error))
     } finally {
       /* Committed or refused, the value in hand is gone: the figure as it stands is drawn again. */
       this.live = NOTHING_LIVE
@@ -408,7 +408,7 @@ export class FigureV3Editor extends LitElement {
   }
   /**
    * The list's own operations, as V3 part edits — each one step of the session's history. The copy and the moved
-   * part stay selected, as they do in the V2 list.
+   * part stay selected.
    */
   private duplicatePart(id: string) {
     this.run(() => {
@@ -486,14 +486,14 @@ export class FigureV3Editor extends LitElement {
       return this.requestUpdate()
     }
     /*
-      A part whose place is worked out (a converted one) has no numbers for the gizmo to write: the drag is added beside
+      A part whose place is worked out has no numbers for the gizmo to write: the drag is added beside
       its rule (`nudge-part`). A part a joint or a fastening places, or a size that is worked out, is refused -- said in
       words, not by the part silently springing back (user, 2026-09-24: 「기즈모 컨트롤도 전혀 작동이 안되는군」).
     */
     const body = view.geometry.find(g => g.id === id) as unknown as V3RenderPart | undefined
     if (!body) return this.requestUpdate()
     const { by, turn } = nudgeOf(body, result)
-    /* A size worked out from the figure's: the drag's factor beside its rule, so it still follows (V2 scaled any part). */
+    /* A size worked out from the figure's: the drag's factor beside its rule, so it still follows. */
     const grow: Partial<Record<'x' | 'y' | 'z', number>> = {}
     if (result.scale) (['x', 'y', 'z'] as const).forEach((axis, i) => Math.abs(result.scale![i]! - 1) > 1e-6 && (grow[axis] = Math.round(result.scale![i]! * 1e6) / 1e6))
     if (!Object.keys(by).length && !Object.keys(turn).length && !Object.keys(grow).length) return this.requestUpdate()
@@ -525,7 +525,7 @@ export class FigureV3Editor extends LitElement {
       if (changes.length) this.session!.apply(changes)
     })
   }
-  /** A mirrored copy: duplicate, then place the copy on the other side — two steps, as the V2 list makes it. */
+  /** A mirrored copy: duplicate, then place the copy on the other side — two steps. */
   private mirror(axis: 'x' | 'z') {
     this.run(() => {
       const id = this.selected
@@ -569,7 +569,7 @@ export class FigureV3Editor extends LitElement {
     </div>`
   }
   /**
-   * A part's name — the V2 part name field. It renames every value the part owns, and what refers to them follows
+   * A part's name. It renames every value the part owns, and what refers to them follows
    * (figure-model's rename-part), as one step of the history.
    */
   /**
@@ -603,7 +603,7 @@ export class FigureV3Editor extends LitElement {
             : String(error)
     }
   }
-  /** Size response, fastening and motion for the selected part (parity ④ ⑤ ⑥), as authoring commands. */
+  /** Size response, fastening and motion for the selected part, as authoring commands. */
   private renderLinks(unavailable: boolean, section: 'shape' | 'places' | 'motion') {
     let asset
     try {
@@ -627,7 +627,7 @@ export class FigureV3Editor extends LitElement {
       @v3-part-edit=${(e: CustomEvent) => this.run(() => this.session!.edit(e.detail.edit))}
     ></figure-v3-links>`
   }
-  /** The figure's controls: try a value, name it, set its range and travel time, keep the pose (parity row ⑥). */
+  /** The figure's controls: try a value, name it, set its range and travel time, keep the pose. */
   private renderControls(view: { fields: Array<{ id: string; role?: string; value: number }> }, unavailable: boolean) {
     let asset
     try {
@@ -827,8 +827,8 @@ export class FigureV3Editor extends LitElement {
       </button>`
   }
   /**
-   * The parts list, one row per part the author made: a repeat is one row with how many copies it makes now (V2 listed
-   * its parts the same way; user, 2026-09-24: the conveyor's sixteen rollers were sixteen rows).
+   * The parts list, one row per part the author made: a repeat is one row with how many copies it makes now
+   * (user, 2026-09-24: the conveyor's sixteen rollers were sixteen rows).
    */
   private partRows(geometry: readonly { id: string }[]): V3PartRow[] {
     const rows = new Map<string, V3PartRow>()
@@ -859,7 +859,7 @@ export class FigureV3Editor extends LitElement {
     }
   }
   /**
-   * A repeat: which way its copies run, how many there are now, and how far apart -- V2's `repeat: { axis, pitch }`.
+   * A repeat: which way its copies run, how many there are now, and how far apart.
    * The pitch of a row that fills its length is edited as a number (`set-repeat` makes it the part's own the first
    * time); a row of a fixed count says its pitch cannot be set yet (figure-model refuses it the same way).
    */

package/client/modeller/v3-fields.ts

@@ -1,5 +1,5 @@
 /*
- * The values a part or the figure is edited by, grouped as V2's inspector showed them: position, rotation and size
+ * The values a part or the figure is edited by, grouped: position, rotation and size
  * as one row of three cells each (X · Y · Z read together), and the shape's own measures one to a line under their
  * own title. Kept apart from the editor so the grouping is tested without a browser.
  */

package/client/modeller/v3-figure-facts.ts

@@ -38,7 +38,7 @@ export function v3FigureFacts(source: string): V3FigureFacts {
 }
 
 /**
- * A tag line as a list — the V2 inspector's rule: split on commas, drop a leading `#`, keep each once. An empty
+ * A tag line as a list: split on commas, drop a leading `#`, keep each once. An empty
  * line is an empty list, so an author can clear every tag.
  */
 export function tagsOf(raw: string): string[] {

package/client/modeller/v3-first-save.ts

@@ -1,10 +1,9 @@
 import { isPlaceholderType, TYPE_LENGTH, TYPE_PATTERN } from '@hatiolab/figure-model'
 
 /*
- * The first save of a new figure asks for its type and name, as V2's page did. The type is the name a board places
- * the figure by; it freezes when the figure is released (ADR-0063 decision 4). The V3 modeller saved a new figure
- * under a temporary machine name instead and asked nothing -- the author had to find the field afterwards
- * (user, 2026-09-25: V2 features are not to go missing).
+ * The first save of a new figure asks for its type and name. The type is the name a board places
+ * the figure by; it freezes when the figure is released (ADR-0063 decision 4). The modeller once saved a new figure
+ * under a temporary machine name and asked nothing -- the author had to find the field afterwards (user, 2026-09-25).
  */
 
 /** A type as typed, made into the shape a type has: letters, digits and underscores, upper case. */

package/client/modeller/v3-gizmo.ts

@@ -2,13 +2,13 @@ import { v3AttachmentsOf } from '@hatiolab/figure-model'
 import type { V3Asset, V3InputChange } from '@hatiolab/figure-model'
 
 /**
- * What the gizmo may write for a part — the V2 gizmo's move · turn · size, on a V3 asset (parity row ③).
+ * What the gizmo may write for a part: move · turn · size, on a V3 asset.
  *
  * A drag can only be written back where the part is placed by its own numbers. A part the create commands made is:
  * its pose is `rigid@1` into the asset frame from `<part>.position.*` and `<part>.rotation.*`, and a box's shape
  * (`box-shape@1` or `rounded-box@1`) takes its width, height and depth from inputs of its own — `<part>.size.*` from
- * `addV3Box`, `<part>.dimension.*` from the editor's shape palette. A part fastened to another, following an instance size or made by the
- * converter from expressions has no such numbers; the gizmo does not offer what it could not write back, rather
+ * `addV3Box`, `<part>.dimension.*` from the editor's shape palette. A part fastened to another, following an instance size or placed by
+ * expressions has no such numbers; the gizmo does not offer what it could not write back, rather
  * than move something the next evaluation would put back.
  */
 export interface GizmoReach {
@@ -23,7 +23,7 @@ export interface GizmoReach {
    */
   ownSizes?: (string | null)[]
   /**
-   * A round part keeps its section round, as V2 kept it (`keepRound`): the radii across (X and Z) take the one factor
+   * A round part keeps its section round: the radii across (X and Z) take the one factor
    * the drag gave most; the length along Y takes its own. A sphere's three radii take one factor together.
    */
   round?: { across: string[]; along: string[] }
@@ -109,7 +109,7 @@ export interface GizmoResult {
 
 /**
  * The input changes a drag makes — one list, applied as one step. Millimetres to the millimetre and degrees to a
- * tenth, as the V2 gizmo rounds (a drag otherwise stores 722.4180046035418 mm). A size never goes below 1 mm.
+ * tenth (a drag otherwise stores 722.4180046035418 mm). A size never goes below 1 mm.
  */
 export function gizmoChanges(part: string, reach: GizmoReach, result: GizmoResult, sizes: Record<string, number>): V3InputChange[] {
   const changes: V3InputChange[] = []

package/client/modeller/v3-help.ts

@@ -4,7 +4,7 @@ import { html, nothing, type ReactiveController, type ReactiveControllerHost } f
 import { i18next } from '@operato/i18n'
 
 /**
- * V2's help toggles: a small 「?」 beside a title opens the longer explanation under it. Explanations left open on every
+ * Help toggles: a small 「?」 beside a title opens the longer explanation under it. Explanations left open on every
  * section made the side read as clutter (user, 2026-09-24); the author opens the one they want. What was opened stays
  * open while the author moves between parts.
  */

package/client/modeller/v3-joint-fan.ts

@@ -4,8 +4,7 @@ import type { V3Asset } from '@hatiolab/figure-model'
 import type { V3RenderPart } from './v3-renderer.js'
 
 /*
- * Where the selected part turns, and how far -- a translucent fan on the editing board (V2's joint gizmo, inventory
- * 3.38). An axis name says nothing about which way a part swings; on a six-axis arm the author went to the preview and
+ * Where the selected part turns, and how far -- a translucent fan on the editing board. An axis name says nothing about which way a part swings; on a six-axis arm the author went to the preview and
  * pushed each slider to its end to find out. The fan lies in the plane the part turns in, at the pivot, open from the
  * control's lowest value to its highest; the edge at the value the figure holds now is where the part is.
  *
@@ -15,7 +14,7 @@ import type { V3RenderPart } from './v3-renderer.js'
  *
  * Two ways a part turns are read:
  *   - a joint record (ADR-0093): at the joint's origin, about its axis;
- *   - a joint the converter wrote from V2 (`<joint>.motion` · `<joint>.chain`): the part is composed on the joint's
+ *   - a joint written as values (`<joint>.motion` · `<joint>.chain`): the part is composed on the joint's
  *     chain, the pivot is the joint's origin (`<joint>.frameOnParent`).
  * A slide has no fan. Nothing is drawn when the turn cannot be found -- a fan in some guessed plane would point the
  * wrong way.
@@ -117,7 +116,7 @@ function turnOf(asset: V3Asset, part: string, values: Record<string, unknown>, b
   }
 
   /*
-    Written by the converter: a joint (`<joint>.motion`, its origin `<joint>.frameOnParent`) carries its own part and
+    A joint written as values (`<joint>.motion`, its origin `<joint>.frameOnParent`) carries its own part and
     everything fastened below it, through its chain (the first joint of a chain has only its attachment). A part shows
     the joint it is to that part of the mechanism (user, 2026-09-24: 「elbow-housing itself is a axis」 · 「please check
     all that logic and concept」), tested in this order on the joints as they stand now:
@@ -222,7 +221,7 @@ export function jointFanOf(asset: V3Asset, part: string, values: Record<string,
   const inPlane = sub(rel, turn.axis.map(v => v * dot(rel, turn.axis)))
   const d = norm(inPlane) ?? norm(cross(turn.axis, Math.abs(turn.axis[0]!) < 0.9 ? [1, 0, 0] : [0, 1, 0]))!
   /*
-    Sized from what the joint turns, as V2 sized it from the joint's child: selecting the elbow housing or the forearm
+    Sized from what the joint turns, not from the selected part: selecting the elbow housing or the forearm
     shows the elbow's one fan, not a smaller one for the smaller part (user, 2026-09-24).
   */
   const radius = Math.max(60, Math.round(Math.max(largestMeasureOf(asset, turn.turnedPart, inputs), Math.hypot(...inPlane)) * 0.6))

package/client/modeller/v3-keys.ts

@@ -1,5 +1,5 @@
 /*
- * The modeller's keys (V2 had undo and redo on Ctrl+Z / Ctrl+Y; these add what a person reaches for next). Read apart
+ * The modeller's keys: undo and redo on Ctrl+Z / Ctrl+Y, and what a person reaches for next. Read apart
  * from the element so the rule is tested without a browser.
  *
  * Typing is never taken: a key pressed in a field belongs to the field -- Backspace in a name box deletes a letter,

package/client/modeller/v3-links.ts

@@ -3,8 +3,7 @@ import type { V3SizeRange } from '@hatiolab/figure-model'
 import type { V3Asset, V3BindingPlace, V3Face, V3Joint } from '@hatiolab/figure-model'
 
 /*
- * What a V3 part is tied to — the readers behind the parts' size response, fastening and motion sections (parity rows
- * ④ ⑤ ⑥). Kept apart from the element so they can be tested without a browser.
+ * What a V3 part is tied to — the readers behind the parts' size response, fastening and motion sections. Kept apart from the element so they can be tested without a browser.
  */
 
 export type Axis = 'x' | 'y' | 'z'
@@ -22,11 +21,11 @@ const modelOf = (asset: V3Asset) =>
 /** What one dimension of a part is worked out from. */
 export type Follow =
   | { of: 'own' }
-  /** `times` 1 is the instance size itself; any other is a share of it -- V2's proportional rule. */
+  /** `times` 1 is the instance size itself; any other is a share of it. */
   | { of: 'instance'; axis: Axis; times: number; plus?: number }
   | { of: 'part'; part: string; axis: Axis; times?: number; plus?: number }
   | { of: 'input'; input: string }
-  /** Worked out some other way (the converter writes expressions) — shown, not offered as a choice. */
+  /** Worked out some other way (an expression) — shown, not offered as a choice. */
   | { of: 'expression' }
 
 /**
@@ -38,7 +37,7 @@ export function followOf(asset: V3Asset, part: string, axis: Axis): Follow {
   const m = modelOf(asset)
   /*
     A link routes the dimension through `<part>.dimension.<axis>`; before any link the shape reads its measure directly,
-    and that may already be worked out -- the converter writes V2's rules there (ROBOT_ARM's flange filled what was left).
+    and that may already be worked out (ROBOT_ARM's flange fills what is left).
   */
   const node = m.nodes.find(n => n.id === `${part}.dimension.${axis}`)
   const start = node ? node.args[0] : m.nodes.find(n => n.id === `${part}.shape`)?.args[AXES.indexOf(axis)]
@@ -79,8 +78,8 @@ export function followOf(asset: V3Asset, part: string, axis: Axis): Follow {
     const onward = writer.args.filter(arg => !constant(arg))
     if (onward.length !== 1) return { of: 'expression' }
     /*
-      Only a product is a share of its source. A sum with a number is not (V2's 「fill what is left」 is the size plus a
-      negative gap -- ROBOT_ARM's tool flange), nor anything else; those read as worked out some other way.
+      Only a product is a share of its source. A sum with a number is not (「fill what is left」 is the size plus a negative
+      gap -- ROBOT_ARM's tool flange), nor anything else; those read as worked out some other way.
     */
     const factors = writer.args.filter(arg => constant(arg)).map(arg => constant(arg)!.value)
     if (writer.op === 'mul@1') times *= factors.reduce((a, b) => a * b, 1)
@@ -118,8 +117,7 @@ export function canFollow(asset: V3Asset, 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 (V2's sizing cards had the cylinder's
- * two as well).
+ * as X) and length (Y) -- its shape takes those two, so it has no Z of its own.
  */
 export function followableAxes(asset: V3Asset, part: string): Axis[] {
   const shape = modelOf(asset).nodes.find(n => n.id === `${part}.shape`)
@@ -234,8 +232,7 @@ export function alignOf(
 }
 
 /**
- * The axes on which the part's position is worked out from other values rather than being its own number — the
- * converter writes V2's anchor rules that way. `fix-position` makes one its own number where it is now.
+ * The axes on which the part's position is worked out from other values rather than being its own number. `fix-position` makes one its own number where it is now.
  */
 export function positionsWorkedOut(asset: V3Asset, part: string): Axis[] {
   const m = modelOf(asset)
@@ -417,7 +414,7 @@ export const acceptsOf = (typed: string) => [...new Set(typed.split(',').map(one
 
 /**
  * The sizes a board may give this figure: the range it declares now, and the range measured afresh -- the default
- * (1 mm to ten times the authored size) narrowed only where the figure cannot follow, by the converter's own functions.
+ * (1 mm to ten times the authored size) narrowed only where the figure cannot follow, by figure-model's own functions.
  * A range measured when a part filled what the others left (ROBOT_ARM: Y from 1,854 mm) stays narrow after the part is
  * made to grow with the figure; measuring again gives the figure its whole range back. Nothing when no size is declared.
  */