@things-factory/figure-ui 10.1.75 → 10.1.76

package/client/modeller/{figure-v3-preview.ts → figure-preview.ts}

@@ -2,13 +2,13 @@ import { css, html, LitElement, nothing, unsafeCSS } from 'lit'
 import { customElement, property, query, state } from 'lit/decorators.js'
 
 import { i18next, localize } from '@operato/i18n'
-import { compileV3Asset } from '@hatiolab/figure-model'
-import type { V3Asset } from '@hatiolab/figure-model'
-import { create, registerFigureV3, unregisterFigureV3 } from '@hatiolab/things-scene'
+import { compileFigureAsset } from '@hatiolab/figure-model'
+import type { FigureAsset } from '@hatiolab/figure-model'
+import { create, registerFigure, unregisterFigure } from '@hatiolab/things-scene'
 
 import { DEFAULT_VIEW, previewBoardDepth, sceneLook, WORKBENCH, type ViewSettings } from './figure-view.js'
 import { dialShape } from './angle-dial.js'
-import { authoredSizeOf, PREVIEW_FACTOR, PREVIEW_WAYS, previewClampsOf, previewInstances } from './v3-preview-model.js'
+import { authoredSizeOf, PREVIEW_FACTOR, PREVIEW_WAYS, previewClampsOf, previewInstances } from './preview-model.js'
 
 /**
  * The figure placed on a board.
@@ -17,7 +17,7 @@ import { authoredSizeOf, PREVIEW_FACTOR, PREVIEW_WAYS, previewClampsOf, previewI
  * different size, so here the figure being authored is registered as a board registers it and placed as
  * `FigureInstance`s: the size it was made, and each of the seven ways of growing one, two or three axes twice as
  * large, side by side at one scale, four to a row. The board draws them as it will on a real board --
- * placement, lights, environment, the same V3 renderer.
+ * placement, lights, environment, the same renderer.
  *
  * The controls: each value that poses the figure with a slider (and a dial for an angle), each clip's
  * speed, and 「이 자세를 기본으로」 to keep the pose as the one it stands in. Nothing here is edited; the canvas edits.
@@ -34,8 +34,8 @@ interface SceneHandle {
   }
 }
 
-@customElement('figure-v3-preview')
-export class FigureV3Preview extends localize(i18next)(LitElement) {
+@customElement('figure-preview')
+export class FigurePreview extends localize(i18next)(LitElement) {
   static styles = css`
     :host {
       position: relative;
@@ -149,7 +149,7 @@ export class FigureV3Preview extends localize(i18next)(LitElement) {
   `
 
   /** The figure being authored, as the editor holds it now. */
-  @property({ attribute: false }) asset?: V3Asset
+  @property({ attribute: false }) asset?: FigureAsset
   /** Which figure: the type it is registered under here is this one's own, never a real type a board uses. */
   @property() context = ''
   @property({ attribute: false }) view: ViewSettings = DEFAULT_VIEW
@@ -192,7 +192,7 @@ export class FigureV3Preview extends localize(i18next)(LitElement) {
             ${controls.length + clips.length ? this.renderDrivers(asset!, controls, clips) : nothing}`}`
   }
 
-  private renderDrivers(asset: V3Asset, controls: V3Asset['document']['model']['inputs'], clips: string[]) {
+  private renderDrivers(asset: FigureAsset, controls: FigureAsset['document']['model']['inputs'], clips: string[]) {
     const changed = controls.filter(c => this.giving[c.id] !== undefined && this.giving[c.id] !== asset.stateDefaults[c.id])
     return html`<div clips>
       ${changed.length
@@ -252,7 +252,7 @@ export class FigureV3Preview extends localize(i18next)(LitElement) {
   }
 
   private poseAsDefault() {
-    this.dispatchEvent(new CustomEvent('v3-part-edit', { detail: { edit: { kind: 'set-state-defaults', values: { ...this.giving } } }, bubbles: true, composed: true }))
+    this.dispatchEvent(new CustomEvent('part-edit', { detail: { edit: { kind: 'set-state-defaults', values: { ...this.giving } } }, bubbles: true, composed: true }))
     this.giving = {}
   }
 
@@ -297,7 +297,7 @@ export class FigureV3Preview extends localize(i18next)(LitElement) {
     const signature = JSON.stringify([asset, view.placement, view.ceilingHeight])
     if (this.scene && this.standing === signature) return
     try {
-      compileV3Asset(asset)
+      compileFigureAsset(asset)
     } catch {
       this.cannot = i18next.t('figure.text.preview-blocked-by-errors')
       this.teardown()
@@ -307,8 +307,8 @@ export class FigureV3Preview extends localize(i18next)(LitElement) {
     this.driving = {}
     try {
       /* Registered as a board registers it, under a type of this preview's own: a real type's drawings stay as they are. */
-      const type = `figure-v3-preview-${this.context || 'new'}`
-      registerFigureV3(type, asset)
+      const type = `figure-preview-${this.context || 'new'}`
+      registerFigure(type, asset)
       this.registered = type
       const size = authoredSizeOf(asset)
       const { components, board } = previewInstances(type, size)
@@ -343,7 +343,7 @@ export class FigureV3Preview extends localize(i18next)(LitElement) {
     this.scene?.dispose?.()
     this.scene = undefined
     this.standing = undefined
-    if (this.registered) unregisterFigureV3(this.registered)
+    if (this.registered) unregisterFigure(this.registered)
     this.registered = undefined
   }
 }

package/client/modeller/{figure-v3-properties.ts → figure-properties.ts}

@@ -5,16 +5,16 @@ import { customElement, property, state } from 'lit/decorators.js'
 import { live } from 'lit/directives/live.js'
 
 import { i18next, localize } from '@operato/i18n'
-import { V3_FACES } from '@hatiolab/figure-model'
-import type { V3AuthoringAction, V3Face } from '@hatiolab/figure-model'
+import { FIGURE_FACES } from '@hatiolab/figure-model'
+import type { FigureAuthoringAction, FigureFace } from '@hatiolab/figure-model'
 
-import { occupancyFromParts } from './v3-occupancy.js'
-import { tagsOf, v3FigureFacts, type Placement, type V3FigureFacts } from './v3-figure-facts.js'
+import { occupancyFromParts } from './occupancy.js'
+import { tagsOf, figureFigureFacts, type Placement, type FigureFigureFacts } from './figure-facts.js'
 import { SidePanelStyles } from './side-panel-styles.js'
 import { ScrollbarStyles } from '@operato/styles'
 
 const PLACEMENTS: Placement[] = ['floor', 'ceiling', 'center', 'wall']
-const FACES = Object.keys(V3_FACES) as V3Face[]
+const FACES = Object.keys(FIGURE_FACES) as FigureFace[]
 
 /**
  * 속성 — the modeller's figure properties.
@@ -23,16 +23,16 @@ const FACES = Object.keys(V3_FACES) as V3Face[]
  * catalogue files it.
  *
  * Two kinds of change leave this tab, and it does neither itself:
- *  - `v3-command` carries an authoring command (rename, declare the room, the mounting face). The page runs it
+ *  - `command` carries an authoring command (rename, declare the room, the mounting face). The page runs it
  *    through the session, so it is one step of the same undo history as every other edit, and is saved with it.
- *  - `v3-catalog` carries a change to the row (category, tags). Those are not in the asset; the page writes them
+ *  - `catalog` carries a change to the row (category, tags). Those are not in the asset; the page writes them
  *    to the saved row at once, so they need a saved figure.
  *
- * Not here yet, because V3 has no place for them: editing the declared room by hand (V3 declares it from the
- * parts, as graph expressions), and the detail level. Both wait on a V3 ruling.
+ * Not here yet, because has no place for them: editing the declared room by hand (declares it from the
+ * parts, as graph expressions), and the detail level. Both wait on a ruling.
  */
-@customElement('figure-v3-properties')
-export class FigureV3Properties extends localize(i18next)(LitElement) {
+@customElement('figure-properties')
+export class FigureProperties extends localize(i18next)(LitElement) {
   static styles = [ScrollbarStyles, SidePanelStyles, css`
     :host {
       display: block;
@@ -66,11 +66,11 @@ export class FigureV3Properties extends localize(i18next)(LitElement) {
   @property({ type: Array }) figureTags?: string[]
   /** The part and face picked for the mounting face, before 「이 면으로」 is pressed. */
   @state() private pickedPart?: string
-  @state() private pickedFace?: V3Face
+  @state() private pickedFace?: FigureFace
 
-  private facts(): V3FigureFacts | undefined {
+  private facts(): FigureFigureFacts | undefined {
     try {
-      return this.source ? v3FigureFacts(this.source) : undefined
+      return this.source ? figureFigureFacts(this.source) : undefined
     } catch {
       /* A source the format refuses has no facts to show; the verdict tab says why. */
       return undefined
@@ -96,7 +96,7 @@ export class FigureV3Properties extends localize(i18next)(LitElement) {
       </section>`
   }
 
-  private renderName(facts: V3FigureFacts) {
+  private renderName(facts: FigureFigureFacts) {
     return html`
       <div field>
         <label>${i18next.t('figure.label.name')}</label>
@@ -118,10 +118,10 @@ export class FigureV3Properties extends localize(i18next)(LitElement) {
   }
 
   /**
-   * The face the figure is placed by. In V3 it is part of the room declaration, so choosing one declares the room
-   * again from the parts — the only way V3 declares it — with the new face. The hint says so.
+   * The face the figure is placed by. In it is part of the room declaration, so choosing one declares the room
+   * again from the parts — the only way declares it — with the new face. The hint says so.
    */
-  private renderPlacement(facts: V3FigureFacts) {
+  private renderPlacement(facts: FigureFigureFacts) {
     const current = facts.placement ?? 'floor'
     return html`
       <div field>
@@ -145,7 +145,7 @@ export class FigureV3Properties extends localize(i18next)(LitElement) {
     `
   }
 
-  private renderSpace(facts: V3FigureFacts) {
+  private renderSpace(facts: FigureFigureFacts) {
     return html`
       <div field>
         <label>${i18next.t('figure.label.declared-space')}</label>
@@ -159,11 +159,11 @@ export class FigureV3Properties extends localize(i18next)(LitElement) {
     `
   }
 
-  private renderMounting(facts: V3FigureFacts) {
+  private renderMounting(facts: FigureFigureFacts) {
     const mounting = facts.mounting
     /* Chosen, or what is set, or where the figure meets its plane -- not the first part listed (walk 1). */
     const part = [this.pickedPart, mounting?.part, facts.suggested?.part, facts.parts[0]].find(one => one && facts.parts.includes(one))
-    const face: V3Face = this.pickedFace ?? mounting?.face ?? facts.suggested?.face ?? 'bottom'
+    const face: FigureFace = this.pickedFace ?? mounting?.face ?? facts.suggested?.face ?? 'bottom'
     return html`
       <div field>
         <label>${i18next.t('figure.label.mounting-face')}</label>
@@ -171,7 +171,7 @@ export class FigureV3Properties extends localize(i18next)(LitElement) {
           <select ?disabled=${!facts.declared} @change=${(e: Event) => (this.pickedPart = (e.target as HTMLSelectElement).value)}>
             ${facts.parts.map(one => html`<option value=${one} ?selected=${one === part}>${one}</option>`)}
           </select>
-          <select ?disabled=${!facts.declared} @change=${(e: Event) => (this.pickedFace = (e.target as HTMLSelectElement).value as V3Face)}>
+          <select ?disabled=${!facts.declared} @change=${(e: Event) => (this.pickedFace = (e.target as HTMLSelectElement).value as FigureFace)}>
             ${FACES.map(one => html`<option value=${one} ?selected=${one === face}>${i18next.t('figure.label.face-' + one)}</option>`)}
           </select>
         </div>
@@ -224,11 +224,11 @@ export class FigureV3Properties extends localize(i18next)(LitElement) {
     this.command(occupancyFromParts(this.source, placement))
   }
 
-  private command(action: V3AuthoringAction) {
-    this.dispatchEvent(new CustomEvent('v3-command', { detail: { action }, bubbles: true, composed: true }))
+  private command(action: FigureAuthoringAction) {
+    this.dispatchEvent(new CustomEvent('command', { detail: { action }, bubbles: true, composed: true }))
   }
 
   private catalog(patch: { category?: string; tags?: string[] }) {
-    this.dispatchEvent(new CustomEvent('v3-catalog', { detail: patch, bubbles: true, composed: true }))
+    this.dispatchEvent(new CustomEvent('catalog', { detail: patch, bubbles: true, composed: true }))
   }
 }

package/client/modeller/{figure-v3-recipe-catalog.ts → figure-recipe-catalog.ts}

@@ -6,19 +6,19 @@ import { customElement, property, state } from 'lit/decorators.js'
 
 import { i18next, localize } from '@operato/i18n'
 import { ScrollbarStyles } from '@operato/styles'
-import { describeV3Recipe } from '@hatiolab/figure-model'
-import type { V3Recipe, V3RecipeValue } from '@hatiolab/figure-model'
+import { describeFigureRecipe } from '@hatiolab/figure-model'
+import type { FigureRecipe, FigureRecipeValue } from '@hatiolab/figure-model'
 
-import { recipeFieldOf, recipeReady, recipeValueOf, recipeWord, recipeWorkings, recipesMatching, type RecipeTemplate } from './v3-recipes.js'
+import { recipeFieldOf, recipeReady, recipeValueOf, recipeWord, recipeWorkings, recipesMatching, type RecipeTemplate } from './recipes.js'
 
 /**
  * The recipe catalog (ADR-0095): the templates the product ships, by category, found by words, each told in full --
  * what it puts in, how many parts, how they move, what each value does, and how to use it -- and put onto the chosen
- * part in one step. The numbers and the ways of moving are worked out from the recipe (`describeV3Recipe`), so they say
+ * part in one step. The numbers and the ways of moving are worked out from the recipe (`describeFigureRecipe`), so they say
  * what it does; only the descriptions and the guide are written.
  */
-@customElement('figure-v3-recipe-catalog')
-export class FigureV3RecipeCatalog extends localize(i18next)(LitElement) {
+@customElement('figure-recipe-catalog')
+export class FigureRecipeCatalog extends localize(i18next)(LitElement) {
   static styles = [
     ScrollbarStyles,
     css`
@@ -238,7 +238,7 @@ export class FigureV3RecipeCatalog extends localize(i18next)(LitElement) {
   @state() private category = ''
   @state() private query = ''
   @state() private chosen = ''
-  @state() private values: Record<string, V3RecipeValue> = {}
+  @state() private values: Record<string, FigureRecipeValue> = {}
   /*
     The guide as a page \`ox-markdown\` can read: it renders what its src points to, not text, and given the text it
     fetched it as a path and drew the app's own page in its place (seen on :3300, 2026-09-26). A blob of type
@@ -314,7 +314,7 @@ export class FigureV3RecipeCatalog extends localize(i18next)(LitElement) {
   }
 
   private renderDetail(t: RecipeTemplate, language: string) {
-    const d = describeV3Recipe(t.recipe)
+    const d = describeFigureRecipe(t.recipe)
     const count = d.parts.min === d.parts.max ? String(d.parts.min) : `${d.parts.min}–${d.parts.max}`
     const ready = recipeReady(t.recipe, this.selected)
     return html`
@@ -339,8 +339,8 @@ export class FigureV3RecipeCatalog extends localize(i18next)(LitElement) {
   }
 
   /** Each value: its name, what it does, and the field to set it -- a share typed as a percentage. */
-  private renderForm(recipe: V3Recipe, language: string) {
-    const set = (name: string, value: V3RecipeValue) => (this.values = { ...this.values, [name]: value })
+  private renderForm(recipe: FigureRecipe, language: string) {
+    const set = (name: string, value: FigureRecipeValue) => (this.values = { ...this.values, [name]: value })
     return html`<div form>
       <h3>${i18next.t('figure.label.recipe-values')}</h3>
       ${recipe.params.map(param => {

package/client/modeller/{figure-v3-verdict.ts → figure-verdict.ts}

@@ -5,15 +5,15 @@ import { customElement, property, state } from 'lit/decorators.js'
 
 import { i18next, localize } from '@operato/i18n'
 import { ScrollbarStyles } from '@operato/styles'
-import { LIMITS, parseV3Asset, V3_PER_INSTANCE, v3CostOf } from '@hatiolab/figure-model'
+import { LIMITS, parseFigureAsset, FIGURE_PER_INSTANCE, figureCostOf } from '@hatiolab/figure-model'
 
 import { inspectFigureDraft } from '../graphql/index.js'
 import type { FigureInspection } from '../types.js'
 import { gateFindingStyles, renderGateFinding } from './gate-findings.js'
 import { MEASURED } from './scene-budget.js'
 import { SidePanelStyles } from './side-panel-styles.js'
-import { budgetOf, CURVE_SIZE, curveLayout, GRADE_SCALE, shortNumber, v3ReportOf } from './v3-maturity.js'
-import type { V3BudgetUse, V3MaturityAxis, V3Report } from './v3-maturity.js'
+import { budgetOf, CURVE_SIZE, curveLayout, GRADE_SCALE, shortNumber, figureReportOf } from './maturity.js'
+import type { FigureBudgetUse, FigureMaturityAxis, FigureReport } from './maturity.js'
 
 /** How long an edit settles before the server is asked again. One question per pause, not one per keystroke. */
 export const VERDICT_SETTLE_MS = 400
@@ -28,7 +28,7 @@ export const VERDICT_SETTLE_MS = 400
  *
  * ## What is computed where
  *
- * The numbers come from `v3-maturity.ts`, which reads the evaluated asset the way the V3 renderer draws it — the
+ * The numbers come from `maturity.ts`, which reads the evaluated asset the way the renderer draws it — the
  * screen calls and shows, it does not count. The count uses the same `capacityFrom` the catalogue cards use, so the
  * tab and the card cannot disagree.
  *
@@ -38,16 +38,16 @@ export const VERDICT_SETTLE_MS = 400
  *
  * ## The grade
  *
- * figure-model's `v3ScoreOf`, which the catalogue uses too: headroom against placing `LIMITS.screenInstances` of the
+ * figure-model's `figureScoreOf`, which the catalogue uses too: headroom against placing `LIMITS.screenInstances` of the
  * figure on one screen (chief architect, 2026-09-24) -- the screen's measured groups and its triangle target shared
  * per instance -- and the rule limits for independently moved parts and transparent materials, decided by the
- * tightest. The two budgets V3 has no field for are left out and the tab says so.
+ * tightest. The two budgets has no field for are left out and the tab says so.
  */
 /** A per-instance share of the screen is not a whole number; what an instance may draw is the whole part of it. */
-const limitOf = (use: V3BudgetUse) => Math.floor(use.limit).toLocaleString()
+const limitOf = (use: FigureBudgetUse) => Math.floor(use.limit).toLocaleString()
 
-@customElement('figure-v3-verdict')
-export class FigureV3Verdict extends localize(i18next)(LitElement) {
+@customElement('figure-verdict')
+export class FigureVerdict extends localize(i18next)(LitElement) {
   static styles = [
     ScrollbarStyles,
     SidePanelStyles,
@@ -384,7 +384,7 @@ export class FigureV3Verdict extends localize(i18next)(LitElement) {
   @property({ type: String }) figureType?: string
 
   /** The report over the source being edited. Absent when nothing is drawn, or the format refuses the source. */
-  @state() private report?: V3Report
+  @state() private report?: FigureReport
   /** Bodies in the asset, drawn or hidden. With none there is nothing to fit the space to, so the button is not offered. */
   @state() private bodies = 0
   /** Whether the trend chart is open at its own size. */
@@ -408,13 +408,13 @@ export class FigureV3Verdict extends localize(i18next)(LitElement) {
   }
 
   private measure() {
-    let report: V3Report | undefined
+    let report: FigureReport | undefined
     let bodies = 0
     try {
-      const asset = this.source ? parseV3Asset(this.source) : undefined
-      const cost = asset ? v3CostOf(asset) : undefined
+      const asset = this.source ? parseFigureAsset(this.source) : undefined
+      const cost = asset ? figureCostOf(asset) : undefined
       bodies = cost ? cost.groups + cost.hidden : 0
-      report = asset ? v3ReportOf(asset) : undefined
+      report = asset ? figureReportOf(asset) : undefined
     } catch {
       /* A source the format refuses has no report; the server's finding below says why. */
       report = undefined
@@ -481,7 +481,7 @@ export class FigureV3Verdict extends localize(i18next)(LitElement) {
    * The count's denominator is measured (2026-09-18, Apple M5) and says so with the machine and the date; the
    * triangle side is still the design document's target and says that.
    */
-  private renderVerdict(report: V3Report) {
+  private renderVerdict(report: FigureReport) {
     const { capacity, score } = report
     return html`
       <section>
@@ -508,8 +508,8 @@ export class FigureV3Verdict extends localize(i18next)(LitElement) {
         <p basis>
           ${i18next.t('figure.text.grade-target', {
             target: LIMITS.screenInstances,
-            groups: Math.floor(V3_PER_INSTANCE.groups),
-            triangles: Math.floor(V3_PER_INSTANCE.triangles).toLocaleString()
+            groups: Math.floor(FIGURE_PER_INSTANCE.groups),
+            triangles: Math.floor(FIGURE_PER_INSTANCE.triangles).toLocaleString()
           })}
         </p>
         ${this.renderGradeScale(score.grade)}
@@ -544,7 +544,7 @@ export class FigureV3Verdict extends localize(i18next)(LitElement) {
    *
    * Scale is left out of the list: it leads the tab, and the same number twice reads as two different things.
    */
-  private renderAxes(report: V3Report) {
+  private renderAxes(report: FigureReport) {
     const measured = report.axes.filter(axis => axis.ratio !== undefined)
     const unmeasured = report.axes.filter(axis => axis.ratio === undefined)
     return html`
@@ -566,7 +566,7 @@ export class FigureV3Verdict extends localize(i18next)(LitElement) {
   }
 
   /** The radar: rings at a third, two thirds and full, short names so the left edge is not cut. */
-  private renderRadar(axes: V3MaturityAxis[]) {
+  private renderRadar(axes: FigureMaturityAxis[]) {
     const cx = 60
     const cy = 46
     const r = 28
@@ -600,7 +600,7 @@ export class FigureV3Verdict extends localize(i18next)(LitElement) {
     `
   }
 
-  private renderAxis(axis: V3MaturityAxis) {
+  private renderAxis(axis: FigureMaturityAxis) {
     const name = i18next.t('figure.label.axis-' + axis.key)
     if (axis.blocked) {
       return html`
@@ -623,7 +623,7 @@ export class FigureV3Verdict extends localize(i18next)(LitElement) {
   }
 
   /** The budget bars. The one closest to its limit is coloured — it decided the grade. */
-  private renderBudgets(report: V3Report) {
+  private renderBudgets(report: FigureReport) {
     const { score } = report
     return html`
       <section>
@@ -639,12 +639,12 @@ export class FigureV3Verdict extends localize(i18next)(LitElement) {
             `
           )}
         </ul>
-        <p quiet>${i18next.t('figure.text.budgets-not-in-v3')}</p>
+        <p quiet>${i18next.t('figure.text.budgets-not-in')}</p>
       </section>
     `
   }
 
-  private renderMetrics(report: V3Report) {
+  private renderMetrics(report: FigureReport) {
     return html`
       <section>
         <h3>${i18next.t('figure.label.weight')}</h3>
@@ -673,7 +673,7 @@ export class FigureV3Verdict extends localize(i18next)(LitElement) {
    * The trend at its own size: both axes logarithmic, the growing lines against the flat ones, and a
    * legend with each line's value at the last count.
    */
-  private renderSheet(report: V3Report) {
+  private renderSheet(report: FigureReport) {
     if (!this.expanded) return nothing
     const layout = curveLayout(report.curve)
     if (!layout) return nothing

package/client/modeller/gate-findings.ts

@@ -6,8 +6,8 @@ import type { FigureGateFinding } from '../types.js'
 /**
  * One release-gate finding as a line on screen — the measured fact, where, why it matters, and what to change.
  *
- * Two places draw these: the release panel (`figure-history-panel`) and the V3 modeller's verdict while editing
- * (`figure-v3-verdict`). They show the same findings from the same server door, so they draw them one way; a copy
+ * Two places draw these: the release panel (`figure-history-panel`) and the modeller's verdict while editing
+ * (`figure-verdict`). They show the same findings from the same server door, so they draw them one way; a copy
  * in each would drift the first time one of them is touched. The caller passes its own action buttons, because
  * what can be done about a finding depends on the screen it is shown on.
  */

package/client/modeller/{v3-gizmo.ts → gizmo.ts}

@@ -1,13 +1,13 @@
-import { v3AttachmentsOf } from '@hatiolab/figure-model'
-import type { V3Asset, V3InputChange } from '@hatiolab/figure-model'
+import { figureAttachmentsOf } from '@hatiolab/figure-model'
+import type { FigureAsset, FigureInputChange } from '@hatiolab/figure-model'
 
 /**
- * What the gizmo may write for a part: move · turn · size, on a V3 asset.
+ * What the gizmo may write for a part: move · turn · size, on a 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 placed by
+ * `addFigureBox`, `<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.
  */
@@ -61,7 +61,7 @@ export function gizmoReachOf(asset: AssetLike, part: string): GizmoReach {
     !!pose &&
     pose.op === 'rigid@1' &&
     !nodes.some(node => node.id === `${part}.motion`) &&
-    v3AttachmentsOf(asset as unknown as V3Asset)[part] === null
+    figureAttachmentsOf(asset as unknown as FigureAsset)[part] === null
   const posed = direct || reseated
   const shape = nodes.find(node => node.id === `${part}.shape`)
   const mine = (ids: string[]) => ids.every(id => id.startsWith(`${part}.`) && design.has(id))
@@ -111,10 +111,10 @@ export interface GizmoResult {
  * The input changes a drag makes — one list, applied as one step. Millimetres to the millimetre and degrees to a
  * 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[] = []
-  const put = (input: string, unit: V3InputChange['unit'], value: number) =>
-    changes.push({ kind: 'set-design', input, unit, value } as V3InputChange)
+export function gizmoChanges(part: string, reach: GizmoReach, result: GizmoResult, sizes: Record<string, number>): FigureInputChange[] {
+  const changes: FigureInputChange[] = []
+  const put = (input: string, unit: FigureInputChange['unit'], value: number) =>
+    changes.push({ kind: 'set-design', input, unit, value } as FigureInputChange)
   if (result.position && reach.translate)
     AXES.forEach((axis, i) => put(`${part}.position.${axis}`, 'mm', Math.round(result.position![i]!)))
   if (result.rotation && reach.rotate)
@@ -144,7 +144,7 @@ export function gizmoChanges(part: string, reach: GizmoReach, result: GizmoResul
  * 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>): V3InputChange[] {
+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 []
@@ -152,5 +152,5 @@ export function keepBottomChanges(part: string, reach: GizmoReach, input: string
   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 V3InputChange]
+  return [{ kind: 'set-design', input: `${part}.position.y`, unit: 'mm', value: Math.round((y + (value - before) / 2) * 10) / 10 } as FigureInputChange]
 }

package/client/modeller/{v3-joint-drag.ts → joint-drag.ts}

@@ -1,9 +1,9 @@
 import * as THREE from 'three'
-import { compileV3Asset } from '@hatiolab/figure-model'
-import type { V3Asset, V3Joint } from '@hatiolab/figure-model'
+import { compileFigureAsset } from '@hatiolab/figure-model'
+import type { FigureAsset, FigureJoint } from '@hatiolab/figure-model'
 
-import type { GizmoResult } from './v3-gizmo.js'
-import type { V3RenderPart } from './v3-renderer.js'
+import type { GizmoResult } from './gizmo.js'
+import type { FigureRenderPart } from './renderer.js'
 
 /*
  * A gizmo drag on a part that hangs from a joint edits the joint, not the part (ADR-0093; r3 §3: the modeller changes
@@ -19,12 +19,12 @@ import type { V3RenderPart } from './v3-renderer.js'
 
 export type JointDrag =
   | { kind: 'value'; input: string; unit: 'deg' | 'mm' | 'ratio'; value: number }
-  | { kind: 'joint'; joint: V3Joint }
+  | { kind: 'joint'; joint: FigureJoint }
   | { kind: 'refused'; reason: 'mimic' | 'fixed-turn' | 'origin-follows' | 'turned-slide' | 'off-axis'; joint: string; leader?: string; axis?: string }
 
 type Axis = 'x' | 'y' | 'z'
 const AXES: Axis[] = ['x', 'y', 'z']
-/** The axis each face faces along, and which way (as figure-model's `V3_FACES`). */
+/** The axis each face faces along, and which way (as figure-model's `FIGURE_FACES`). */
 const FACE_AXIS: Record<string, Axis> = { left: 'x', right: 'x', bottom: 'y', top: 'y', back: 'z', front: 'z' }
 const FACE_SIGN: Record<string, number> = { left: -1, right: 1, bottom: -1, top: 1, back: -1, front: 1 }
 
@@ -34,17 +34,17 @@ const unit = (axis: string) => new THREE.Vector3(/x/i.test(axis) ? 1 : 0, /y/i.t
 const round = (v: number, step: number) => Number((Math.round(v / step) * step).toFixed(Math.max(0, -Math.floor(Math.log10(step)))))
 
 /** The part's own quarter turn in the joint frame, as the record says it. */
-const turnMatrix = (j: V3Joint) => eulerMatrix(AXES.map(a => j.origin?.turn?.[a] ?? 0))
+const turnMatrix = (j: FigureJoint) => eulerMatrix(AXES.map(a => j.origin?.turn?.[a] ?? 0))
 
 /** The joint frame's rotation in the figure: the part's rotation now, less its own turn and less the joint's. */
-function jointFrameRotation(j: V3Joint, part: V3RenderPart, angle: number): THREE.Matrix4 {
+function jointFrameRotation(j: FigureJoint, part: FigureRenderPart, angle: number): THREE.Matrix4 {
   const now = matrixOf(part.pose.r as number[][])
   const own = turnMatrix(j)
   const turn = j.type === 'revolute' ? new THREE.Matrix4().makeRotationAxis(unit(j.axis!), THREE.MathUtils.degToRad(angle)) : new THREE.Matrix4()
   return now.multiply(own.invert()).multiply(turn.invert())
 }
 
-export function jointDragOf(asset: V3Asset, id: string, part: V3RenderPart, result: GizmoResult, values: Record<string, number>): JointDrag | null {
+export function jointDragOf(asset: FigureAsset, id: string, part: FigureRenderPart, result: GizmoResult, values: Record<string, number>): JointDrag | null {
   const j = asset.joints?.find(joint => joint.body1.part === id)
   /* A size is the part's own, not the joint's: a scale drag goes to the part's measures (the editor drops the shift). */
   if (!j || result.scale || (!result.rotation && !result.position)) return null
@@ -81,7 +81,7 @@ export function jointDragOf(asset: V3Asset, id: string, part: V3RenderPart, resu
     /* How far one unit of the value moves the part along its axis, measured on the figure itself (a ratio travels a length). */
     const along = unit(j.axis!).applyMatrix4(frame).normalize()
     const at = (v: number) => {
-      const g = compileV3Asset(asset).evaluate({ ...values, [stateId]: v }).geometry.find(g => g.id === id && 'pose' in g) as { pose: { t: number[] } } | undefined
+      const g = compileFigureAsset(asset).evaluate({ ...values, [stateId]: v }).geometry.find(g => g.id === id && 'pose' in g) as { pose: { t: number[] } } | undefined
       return g ? new THREE.Vector3(...(g.pose.t as [number, number, number])).dot(along) : 0
     }
     const step = j.travel ? 0.01 : 1
@@ -97,7 +97,7 @@ export function jointDragOf(asset: V3Asset, id: string, part: V3RenderPart, resu
   const normal: Axis = 'plane' in j.body0 ? 'y' : FACE_AXIS[j.body0.face]!
   /* Which way a larger gap moves the part: out of the face it meets (on the plane: up when it stands, down when it hangs). */
   const outward = 'plane' in j.body0 ? (j.body1.face === 'bottom' ? 1 : -1) : ((j.origin?.facing ?? 'meet') === 'meet' ? 1 : -1) * FACE_SIGN[j.body0.face]!
-  const origin: NonNullable<V3Joint['origin']> = { ...(j.origin ?? {}) }
+  const origin: NonNullable<FigureJoint['origin']> = { ...(j.origin ?? {}) }
   const along = local[normal]
   if (Math.abs(along) >= 0.5) {
     const gap = origin.gap ?? 0

package/client/modeller/{v3-joint-fan.ts → joint-fan.ts}

@@ -1,7 +1,7 @@
-import { compileV3Asset, compileV3Graph, v3WorldBoxesOf, v3WritersOf } from '@hatiolab/figure-model'
-import type { V3Asset } from '@hatiolab/figure-model'
+import { compileFigureAsset, compileFigureGraph, figureWorldBoxesOf, figureWritersOf } from '@hatiolab/figure-model'
+import type { FigureAsset } from '@hatiolab/figure-model'
 
-import type { V3RenderPart } from './v3-renderer.js'
+import type { FigureRenderPart } from './renderer.js'
 
 /*
  * 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
@@ -68,7 +68,7 @@ interface Turn {
   control: { id: string; min: number; max: number }
 }
 
-function turnOf(asset: V3Asset, part: string, values: Record<string, unknown>, box: WorldBox | undefined): Turn | null {
+function turnOf(asset: FigureAsset, part: string, values: Record<string, unknown>, box: WorldBox | undefined): Turn | null {
   const m = asset.document.model as unknown as { nodes: Node[]; constants: { id: string; value: number }[]; inputs: { id: string; role?: string; min?: number; max?: number }[] }
   const node = (id: string) => m.nodes.find(n => n.id === id)
   const constant = (ref: string) => m.constants.find(c => c.id === ref)?.value
@@ -183,11 +183,11 @@ function turnOf(asset: V3Asset, part: string, values: Record<string, unknown>, b
  * The fan for the part, as a body to stand on the board, or null when the part does not turn. `values` are the
  * inputs the figure is drawn with now (a pose in hand included), so the fan follows the arm as it is posed.
  */
-export function jointFanOf(asset: V3Asset, part: string, values: Record<string, number> = {}): V3RenderPart | null {
+export function jointFanOf(asset: FigureAsset, part: string, values: Record<string, number> = {}): FigureRenderPart | null {
   if (!part) return null
-  let graph: ReturnType<typeof compileV3Graph>
+  let graph: ReturnType<typeof compileFigureGraph>
   try {
-    graph = compileV3Graph(asset.document.model as never)
+    graph = compileFigureGraph(asset.document.model as never)
   } catch {
     return null
   }
@@ -201,11 +201,11 @@ export function jointFanOf(asset: V3Asset, part: string, values: Record<string,
   }
   let box: WorldBox | undefined
   try {
-    box = v3WorldBoxesOf(
-      compileV3Asset({ ...asset, designInputs: { ...asset.designInputs, ...pick(values, asset.designInputs) }, stateDefaults: { ...asset.stateDefaults, ...pick(values, asset.stateDefaults) } })
+    box = figureWorldBoxesOf(
+      compileFigureAsset({ ...asset, designInputs: { ...asset.designInputs, ...pick(values, asset.designInputs) }, stateDefaults: { ...asset.stateDefaults, ...pick(values, asset.stateDefaults) } })
         .evaluate()
         .geometry.filter(g => g.id === part),
-      v3WritersOf(asset)
+      figureWritersOf(asset)
     )[0]
   } catch {
     box = undefined
@@ -261,7 +261,7 @@ export function jointFanOf(asset: V3Asset, part: string, values: Record<string,
     material: { token: '__joint-fan', transparent: true },
     /** Which control turns it: the joint the fan shows. */
     turns: turn.control.id
-  } as unknown as V3RenderPart
+  } as unknown as FigureRenderPart
 }
 
 /** The values in hand that belong to a record's keys (design inputs, or state defaults). */
@@ -270,9 +270,9 @@ function pick(values: Record<string, number>, of: Record<string, number>): Recor
 }
 
 /** A part's largest own measure (a box side, a diameter, a length) at the inputs given; 0 when it cannot be read. */
-function largestMeasureOf(asset: V3Asset, part: string, inputs: Record<string, number>): number {
+function largestMeasureOf(asset: FigureAsset, part: string, inputs: Record<string, number>): number {
   try {
-    const body = compileV3Asset({ ...asset, designInputs: pick(inputs, asset.designInputs), stateDefaults: pick(inputs, asset.stateDefaults) })
+    const body = compileFigureAsset({ ...asset, designInputs: pick(inputs, asset.designInputs), stateDefaults: pick(inputs, asset.stateDefaults) })
       .evaluate()
       .geometry.find(g => g.id === part) as { shape?: { dimensions?: Record<string, number> } } | undefined
     const dims = Object.entries(body?.shape?.dimensions ?? {}).map(([k, v]) => (k.startsWith('radius') ? v * 2 : v))