@things-factory/figure-ui 10.1.75 → 10.1.76

package/docs/product-cutover.md

@@ -0,0 +1,25 @@
+# V3 제품 현황
+
+형식은 V3(`figure-asset-1`) 하나다. V1·V2 형식은 2026-09-26 코드와 명세에서 제거했다.
+
+## 제품 코드
+
+- `client/modeller/product-session.ts`: 모델 ID·로드·저장 경계를 workspace에 연결한다. 다른 모델의 지연 응답을 버리며 로드 실패 시 이전 형상을 노출하지 않는다. UI/AI는 같은 리비전과 undo/redo를 사용한다. AI 편집은 요청 당시 context/revision을 필수로 받는다.
+- `client/modeller/canvas.ts`: things-scene 편집 모드의 판 위에 평가된 V3 형상을 부품마다 `figure-part` 컴포넌트로 세운다. 새 문맥에서 렌더링이 실패하면 이전 모델을 지운다.
+- `client/modeller/editor.ts`: 부품 목록 · 캔버스 · 오른쪽 탭(속성 · 능력 · 움직임 · 판정 · 환경 · 이력). 실행 취소/다시 실행과 저장 연결.
+- `client/graphql/store.ts`: 정본을 그대로 `saveFigure`로 보낸다.
+- figure-service의 `saveFigure`: 도메인 권한 검사, V3 검증, 정확한 이전 정본을 조건으로 하는 atomic UPDATE, 생성 요청 ID를 이용한 재시도. SQLite에서 지원하지 않는 행 잠금은 사용하지 않는다. 재지 않은 성능 점수/삼각형 수는 null로 둔다. 실제 운영 DB 저장 테스트는 아직 하지 않았다.
+- `client/pages/figure-modeller-page.ts`: 위 요소를 묶는 페이지. `route.ts`의 `figure-modeller`와 `figure-modeller`가 이 페이지를 연다.
+
+## 남은 항목
+
+1. operato-figure의 AI-dock과 figure-service 도구/제안 생성기를 V3 정본 및 승인된 트랜잭션 계약으로 연결한다. 페이지 이벤트만 추가한 것은 AI 통합 완료가 아니다.
+2. 발행 게이트, 썸네일, 카탈로그/배치 소비처가 V3 평가 결과를 사용하는지 확인한다.
+
+## 검증
+
+- figure-ui `npm test`: 251개 통과(2026-09-26).
+- SQLite in-memory 테스트: 테넌트 경계·이전 정본 비교·오래된 편집 거절. 실제 TypeORM 리졸버/제품 DB end-to-end 검증을 대체하지 않는다.
+- 브라우저 검사(`npm run test:browser`): 기즈모 끌기 · 자세 슬라이더를 실제 마우스로 조작한다.
+
+배포는 사용자가 담당한다.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@things-factory/figure-ui",
-  "version": "10.1.75",
+  "version": "10.1.76",
   "publishConfig": {
     "access": "public",
     "@things-factory:registry": "https://registry.npmjs.org"
@@ -27,8 +27,8 @@
     "clean": "npm run clean:server && npm run clean:client"
   },
   "dependencies": {
-    "@hatiolab/figure-model": "^0.1.92",
-    "@hatiolab/things-scene": "^10.1.60",
+    "@hatiolab/figure-model": "^0.1.93",
+    "@hatiolab/things-scene": "^10.1.61",
     "@material/web": "^2.0.0",
     "@operato/data-grist": "^10.0.0",
     "@operato/graphql": "^10.0.0",
@@ -41,8 +41,8 @@
     "@operato/styles": "^10.0.0",
     "@operato/utils": "^10.0.0",
     "@things-factory/ai-assistant": "^10.1.58",
-    "@things-factory/figure-service": "^10.1.75",
+    "@things-factory/figure-service": "^10.1.76",
     "three": "^0.185.1"
   },
-  "gitHead": "931154ec5ab1b4d3bd2530a9a689363157f21f5f"
+  "gitHead": "66a70458dfea95fe8c835067f0fd857b38736203"
 }

package/test/{v3-ai-proposal.test.ts → ai-proposal.test.ts}

@@ -6,10 +6,10 @@ import { test } from 'node:test'
 import assert from 'node:assert/strict'
 import { readFileSync } from 'node:fs'
 import { fileURLToPath } from 'node:url'
-import { createV3Asset, addV3Box, serializeV3Asset } from '@hatiolab/figure-model'
+import { createFigureAsset, addFigureBox, serializeFigureAsset } from '@hatiolab/figure-model'
 
-import { createV3ProductSession } from '../client/modeller/v3-product-session.js'
-import { pendNewFigure, runFigureProposal, takePendingNewFigure, type FigureApplyDetail } from '../client/modeller/v3-ai-proposal.js'
+import { createFigureProductSession } from '../client/modeller/product-session.js'
+import { pendNewFigure, runFigureProposal, takePendingNewFigure, type FigureApplyDetail } from '../client/modeller/ai-proposal.js'
 
 const ko = JSON.parse(readFileSync(fileURLToPath(new URL('../translations/ko.json', import.meta.url)), 'utf8'))
 const say = (key: string, params: Record<string, string> = {}) => {
@@ -18,7 +18,7 @@ const say = (key: string, params: Record<string, string> = {}) => {
 }
 
 const source = () =>
-  serializeV3Asset(addV3Box(createV3Asset('A'), { id: 'body', size: { x: 100, y: 100, z: 100 }, position: { x: 0, y: 50, z: 0 } }))
+  serializeFigureAsset(addFigureBox(createFigureAsset('A'), { id: 'body', size: { x: 100, y: 100, z: 100 }, position: { x: 0, y: 50, z: 0 } }))
 const store = {
   load: async (id: string) => ({ id, source: source() }),
   save: async (q: { id?: string; source: string }) => ({ id: q.id ?? 'created', source: q.source })
@@ -30,7 +30,7 @@ const steps = [
 ] as any[]
 
 test('a proposal is one step of the history on the version the model saw, undone whole', async () => {
-  const s = createV3ProductSession(store)
+  const s = createFigureProductSession(store)
   await s.open('A')
   const seen = s.read()
   s.applyProposal(steps, seen.revision!, seen.context!)
@@ -43,7 +43,7 @@ test('a proposal is one step of the history on the version the model saw, undone
 })
 
 test('a person\'s edit after the proposal was asked makes it stale -- refused, nothing applied', async () => {
-  const s = createV3ProductSession(store)
+  const s = createFigureProductSession(store)
   await s.open('A')
   const seen = s.read()
   s.apply([{ kind: 'set-design', input: 'body.size.y', unit: 'mm', value: 150 }])

package/test/{v3-align.test.ts → align.test.ts}

@@ -1,7 +1,7 @@
 /*
  * **부품 맞추기 — 가운데 · 바닥 · 대칭 · 눈금** (2026-09-24).
  *
- * 「맞추기」 여섯 단추. V3 의 틀은 바닥이 y 0, X · Z 가 0 에 가운데다. 각 도구가 부품의 **실제로 차지하는
+ * 「맞추기」 여섯 단추. 이 모델의 틀은 바닥이 y 0, X · Z 가 0 에 가운데다. 각 도구가 부품의 **실제로 차지하는
  * 상자**(돌린 부품이면 돈 부피)를 기준으로 맞추는지, 그 결과를 잰다.
  */
 import { test } from 'node:test'
@@ -9,15 +9,15 @@ import assert from 'node:assert/strict'
 import { readFileSync } from 'node:fs'
 import { fileURLToPath } from 'node:url'
 
-import { addV3Box, createV3Asset, editV3Part } from '@hatiolab/figure-model'
+import { addFigureBox, createFigureAsset, editFigurePart } from '@hatiolab/figure-model'
 
-import { alignChanges, boxOf, canMirror, gridStepOf, mirrorChanges, niceStep } from '../client/modeller/v3-align.ts'
-import { gizmoReachOf } from '../client/modeller/v3-gizmo.ts'
+import { alignChanges, boxOf, canMirror, gridStepOf, mirrorChanges, niceStep } from '../client/modeller/align.ts'
+import { gizmoReachOf } from '../client/modeller/gizmo.ts'
 
 const read = (path: string) => readFileSync(fileURLToPath(new URL(path, import.meta.url)), 'utf8')
 const probe = (at = { x: 130, y: 90, z: -70 }, rotation?: { x: number; y: number; z: number }) => {
-  let asset = createV3Asset('Probe')
-  asset = addV3Box(asset, { id: 'body', size: { x: 200, y: 100, z: 100 }, position: at, ...(rotation ? { rotation } : {}) })
+  let asset = createFigureAsset('Probe')
+  asset = addFigureBox(asset, { id: 'body', size: { x: 200, y: 100, z: 100 }, position: at, ...(rotation ? { rotation } : {}) })
   return asset
 }
 const applied = (asset: ReturnType<typeof probe>, changes: ReturnType<typeof alignChanges>) => {
@@ -52,7 +52,7 @@ test('눈금은 1 · 2 · 5 간격으로 자리와 크기를 맞추고, 크기
 
 test('대칭은 복제본을 가운데 면 반대편 같은 거리에 둔다 · 가운데에 있으면 내지 않는다', () => {
   const asset = probe()
-  const copied = editV3Part(asset, { kind: 'duplicate-part', target: 'body' })
+  const copied = editFigurePart(asset, { kind: 'duplicate-part', target: 'body' })
   const mirrored = applied(copied, mirrorChanges(copied, 'body', 'body-copy', 'x'))
   assert.equal(Math.round(boxOf(mirrored, 'body-copy')!.centre.x), -Math.round(boxOf(mirrored, 'body')!.centre.x))
   assert.equal(canMirror(probe({ x: 0, y: 50, z: 0 }) as never, 'body', 'x', gizmoReachOf(probe() as never, 'body')), false)
@@ -60,7 +60,7 @@ test('대칭은 복제본을 가운데 면 반대편 같은 거리에 둔다 ·
 
 test('붙인 부품처럼 옮길 수 없는 것은 맞추기도 없다', () => {
   assert.deepEqual(alignChanges(probe(), 'body', { translate: false, rotate: false, scale: false }, 'floor'), [])
-  assert.match(read('../client/modeller/v3-editor.ts'), /if \(!this\.selected \|\| !reach\.translate\) return null/)
+  assert.match(read('../client/modeller/editor.ts'), /if \(!this\.selected \|\| !reach\.translate\) return null/)
 })
 
 test('the grid step reads well -- 27 or 33 would make coordinates unreadable -- and is never 0', () => {

package/test/browser/modeller-page.js

@@ -1,12 +1,12 @@
 /*
- * The page the browser check drives: the V3 editor as the modeller page mounts it, over a store in memory, so the check
+ * The page the browser check drives: the editor as the modeller page mounts it, over a store in memory, so the check
  * needs no server and no sign-in. Everything the editor draws and does is the product's own code, emitted fresh from
  * `client/` by the runner.
  */
-import 'figure-ui-client/modeller/v3-editor.js'
-import { budgetOf, v3ReportOf } from 'figure-ui-client/modeller/v3-maturity.js'
-import { createV3ProductSession } from 'figure-ui-client/modeller/v3-product-session.js'
-import { addV3Box, addV3Primitive, applyV3Authoring, createV3Asset, parseV3Asset, robotArmV3, serializeV3Asset } from '@hatiolab/figure-model'
+import 'figure-ui-client/modeller/editor.js'
+import { budgetOf, figureReportOf } from 'figure-ui-client/modeller/maturity.js'
+import { createFigureProductSession } from 'figure-ui-client/modeller/product-session.js'
+import { addFigureBox, addFigurePrimitive, applyFigureAuthoring, createFigureAsset, parseFigureAsset, robotArmFigure, serializeFigureAsset } from '@hatiolab/figure-model'
 
 const PALETTE = {
   'palette.dark': '#2b2b2b',
@@ -18,38 +18,38 @@ const PALETTE = {
 
 function sourceOf(kind, text) {
   if (text) return text
-  if (kind === 'arm') return serializeV3Asset(robotArmV3())
+  if (kind === 'arm') return serializeFigureAsset(robotArmFigure())
   if (kind === 'box') {
-    const asset = createV3Asset('Probe')
+    const asset = createFigureAsset('Probe')
     asset.palette = { ...asset.palette, ...PALETTE }
-    return serializeV3Asset(addV3Box(asset, { id: 'box', size: { x: 400, y: 400, z: 400 }, position: { x: 0, y: 200, z: 0 } }))
+    return serializeFigureAsset(addFigureBox(asset, { id: 'box', size: { x: 400, y: 400, z: 400 }, position: { x: 0, y: 200, z: 0 } }))
   }
   if (kind === 'door') {
     /* A frame, and a leaf set off it: 250 mm to the side and 100 mm in front, by its own numbers. */
-    let asset = createV3Asset('Door')
+    let asset = createFigureAsset('Door')
     asset.palette = { ...asset.palette, ...PALETTE }
-    asset = addV3Box(asset, { id: 'frame', size: { x: 1600, y: 100, z: 150 }, position: { x: 0, y: 50, z: 0 } })
-    return serializeV3Asset(addV3Box(asset, { id: 'leaf', size: { x: 1400, y: 2200, z: 40 }, position: { x: 250, y: 1100, z: 100 } }))
+    asset = addFigureBox(asset, { id: 'frame', size: { x: 1600, y: 100, z: 150 }, position: { x: 0, y: 50, z: 0 } })
+    return serializeFigureAsset(addFigureBox(asset, { id: 'leaf', size: { x: 1400, y: 2200, z: 40 }, position: { x: 250, y: 1100, z: 100 } }))
   }
   if (kind === 'room') {
     /* A room a recipe is put on: a 4 x 3 x 6 m box standing on the floor. */
-    const asset = createV3Asset('Room')
+    const asset = createFigureAsset('Room')
     asset.palette = { ...asset.palette, ...PALETTE }
-    return serializeV3Asset(addV3Box(asset, { id: 'room', size: { x: 4000, y: 3000, z: 6000 }, position: { x: 0, y: 1500, z: 0 } }))
+    return serializeFigureAsset(addFigureBox(asset, { id: 'room', size: { x: 4000, y: 3000, z: 6000 }, position: { x: 0, y: 1500, z: 0 } }))
   }
   if (kind === 'rollers') {
     /* A roller row whose rollers spin in place, each carrying a mark (ADR-0093, 2026-09-26). */
-    let asset = createV3Asset('Rollers')
+    let asset = createFigureAsset('Rollers')
     asset.palette = { ...asset.palette, ...PALETTE }
-    asset = addV3Box(asset, { id: 'bed', size: { x: 2000, y: 400, z: 600 }, position: { x: 0, y: 200, z: 0 } })
-    asset = applyV3Authoring(asset, { kind: 'attach', part: 'bed', face: 'bottom', to: { plane: 'mounting-plane' } })
-    asset = addV3Primitive(asset, { id: 'roller', kind: 'cylinder', dimensions: { radius: 40, length: 560 }, position: { x: 0, y: 0, z: 0 }, rotation: { x: 90, y: 0, z: 0 } })
-    asset = applyV3Authoring(asset, { kind: 'attach', part: 'roller', face: 'centre', to: { part: 'bed', face: 'top' }, gap: 40 })
-    asset = addV3Box(asset, { id: 'mark', size: { x: 30, y: 30, z: 560 }, position: { x: 0, y: 0, z: 0 } })
-    asset = applyV3Authoring(asset, { kind: 'attach', part: 'mark', face: 'left', to: { part: 'roller', face: 'right' } })
+    asset = addFigureBox(asset, { id: 'bed', size: { x: 2000, y: 400, z: 600 }, position: { x: 0, y: 200, z: 0 } })
+    asset = applyFigureAuthoring(asset, { kind: 'attach', part: 'bed', face: 'bottom', to: { plane: 'mounting-plane' } })
+    asset = addFigurePrimitive(asset, { id: 'roller', kind: 'cylinder', dimensions: { radius: 40, length: 560 }, position: { x: 0, y: 0, z: 0 }, rotation: { x: 90, y: 0, z: 0 } })
+    asset = applyFigureAuthoring(asset, { kind: 'attach', part: 'roller', face: 'centre', to: { part: 'bed', face: 'top' }, gap: 40 })
+    asset = addFigureBox(asset, { id: 'mark', size: { x: 30, y: 30, z: 560 }, position: { x: 0, y: 0, z: 0 } })
+    asset = applyFigureAuthoring(asset, { kind: 'attach', part: 'mark', face: 'left', to: { part: 'roller', face: 'right' } })
     const j = asset.joints.find(o => o.body1.part === 'roller')
-    asset = applyV3Authoring(asset, { kind: 'set-joint', joint: { ...j, type: 'revolute', axis: 'Z', lowerLimit: -360, upperLimit: 360, state: { id: 'spin' } } })
-    return serializeV3Asset(applyV3Authoring(asset, { kind: 'make-repeat', part: 'roller', axis: 'x', pitch: 200 }))
+    asset = applyFigureAuthoring(asset, { kind: 'set-joint', joint: { ...j, type: 'revolute', axis: 'Z', lowerLimit: -360, upperLimit: 360, state: { id: 'spin' } } })
+    return serializeFigureAsset(applyFigureAuthoring(asset, { kind: 'make-repeat', part: 'roller', axis: 'x', pitch: 200 }))
   }
   throw Error(`no figure for ${kind}`)
 }
@@ -60,8 +60,8 @@ function deep(selector, root = document) {
   return found
 }
 
-const editor = () => document.querySelector('figure-v3-editor')
-const canvas = () => deep('figure-v3-canvas')[0]
+const editor = () => document.querySelector('figure-editor')
+const canvas = () => deep('figure-canvas')[0]
 const three = () => canvas().scene.root._threeCapability
 const controls = () => three().gizmoManager.controls
 
@@ -244,28 +244,28 @@ window.probe = {
 window.harness = {
   async mount(kind, text, templates = [], guides = {}) {
     const source = sourceOf(kind, text)
-    const session = createV3ProductSession({
+    const session = createFigureProductSession({
       load: async id => ({ id, source }),
       save: async request => ({ id: request.id ?? 'probe', source: request.source })
     })
     await session.open('probe')
-    const editor = document.createElement('figure-v3-editor')
+    const editor = document.createElement('figure-editor')
     editor.session = session
-    /* The cost line as the modeller page gives it: the maturity report of what is authored (figure-v3-verdict). */
+    /* The cost line as the modeller page gives it: the maturity report of what is authored (figure-verdict). */
     const report = () => {
       try {
-        return budgetOf(v3ReportOf(parseV3Asset(session.source())))
+        return budgetOf(figureReportOf(parseFigureAsset(session.source())))
       } catch {
         return undefined
       }
     }
     editor.budget = report()
-    editor.addEventListener('v3-changed', () => (editor.budget = report()))
+    editor.addEventListener('changed', () => (editor.budget = report()))
     editor.templates = templates
     editor.guideOf = async name => guides[name] ?? ''
     editor.revision = 0
     /* The modeller page counts a change the same way: the editor re-reads the session on a new revision. */
-    editor.addEventListener('v3-changed', () => (editor.revision = editor.revision + 1))
+    editor.addEventListener('changed', () => (editor.revision = editor.revision + 1))
     document.body.replaceChildren(editor)
     await editor.updateComplete
     return session.read().revision

package/test/browser/modeller.check.mjs

@@ -1,5 +1,5 @@
 /*
- * The V3 modeller driven with the mouse, in a real browser.
+ * The modeller driven with the mouse, in a real browser.
  *
  * The unit suite proves the rules; it cannot prove what happens between a pointer going down on a gizmo handle and
  * coming up -- the scene writes the component on every move, the editor must not fight it, and the drag must land as
@@ -252,7 +252,7 @@ describe('a pose slider dragged with the mouse (user 2026-09-24: the arm jumped
   })
 })
 
-describe('the V3 robot arm: a drag on a part edits its joint (ADR-0093)', () => {
+describe('the robot arm: a drag on a part edits its joint (ADR-0093)', () => {
   before(async () => {
     await mount('arm')
     await click(await read(() => probe.row('upper-arm')))
@@ -348,7 +348,7 @@ describe('the fastening form belongs to the part it is for', () => {
     await click(await read(() => probe.row('elbow')))
     /* The elbow opens on its own fastening (walk 1, 2026-09-26), not on the forearm's choices. */
     const own = await read(() => {
-      const joint = JSON.parse(document.querySelector('figure-v3-editor').session.source()).joints.find(j => j.body1.part === 'elbow')
+      const joint = JSON.parse(document.querySelector('figure-editor').session.source()).joints.find(j => j.body1.part === 'elbow')
       return { target: joint.body0.part, x: joint.origin?.align?.x ?? 'centre' }
     })
     const nextTarget = await alignSelect('figure.label.target-part')
@@ -390,7 +390,7 @@ describe('a figure made in the modeller is given its size from its parts (user 2
       }, id)
     const declared = () =>
       page().evaluate(() => {
-        const deep = (root = document) => [...root.querySelectorAll('figure-v3-editor')].concat(...[...root.querySelectorAll('*')].filter(e => e.shadowRoot).map(e => deep(e.shadowRoot)))
+        const deep = (root = document) => [...root.querySelectorAll('figure-editor')].concat(...[...root.querySelectorAll('*')].filter(e => e.shadowRoot).map(e => deep(e.shadowRoot)))
         const inputs = JSON.parse(deep()[0].session.source()).document.model.inputs
         return Object.fromEntries(inputs.filter(i => i.id.startsWith('size.')).map(i => [i.id, [i.min, i.max]]))
       })
@@ -479,7 +479,7 @@ describe('a figure made in the modeller is given its size from its parts (user 2
     assert.equal(after.error, '', 'not refused')
     assert.equal(after.revision, start.revision + 1, 'one step')
     const follows = await page().evaluate(() => {
-      const deep = (root = document) => [...root.querySelectorAll('figure-v3-editor')].concat(...[...root.querySelectorAll('*')].filter(e => e.shadowRoot).map(e => deep(e.shadowRoot)))
+      const deep = (root = document) => [...root.querySelectorAll('figure-editor')].concat(...[...root.querySelectorAll('*')].filter(e => e.shadowRoot).map(e => deep(e.shadowRoot)))
       const model = JSON.parse(deep()[0].session.source()).document.model
       return ['x', 'y', 'z'].map(axis => {
         const ref = String(model.nodes.find(n => n.id === `box.dimension.${axis}`)?.args[0] ?? '')
@@ -499,7 +499,7 @@ describe('a motion is changed where it is (2026-09-25)', () => {
 
   test('the shoulder\'s range is changed from the motion tab: one step, the same joint, its new limit', async () => {
     await click(await read(() => probe.tab('figure.label.motion')))
-    const jointOf = part => read(part => (JSON.parse(document.querySelector('figure-v3-editor').session.source()).joints ?? []).find(j => j.body1.part === part) ?? null, part)
+    const jointOf = part => read(part => (JSON.parse(document.querySelector('figure-editor').session.source()).joints ?? []).find(j => j.body1.part === part) ?? null, part)
     const was = await jointOf('upper-arm')
     assert.ok(was, 'the upper arm has its joint')
     const button = async text =>
@@ -514,7 +514,7 @@ describe('a motion is changed where it is (2026-09-25)', () => {
     await click(await button('figure.button.change-motion'))
     const max = await page().evaluateHandle(() => {
       const deep = (root = document) => [...root.querySelectorAll('input[type=number]')].concat(...[...root.querySelectorAll('*')].filter(e => e.shadowRoot).map(e => deep(e.shadowRoot)))
-      const inputs = deep().filter(i => i.closest('div[pair]') && i.getRootNode().host?.tagName === 'FIGURE-V3-LINKS')
+      const inputs = deep().filter(i => i.closest('div[pair]') && i.getRootNode().host?.tagName === 'FIGURE-LINKS')
       return inputs[inputs.length - 1] ?? null
     })
     assert.ok(await max.evaluate(i => !!i), 'the form is open with the range')
@@ -620,9 +620,9 @@ describe('the modeller made easier to find and to keep (2026-09-26 baseline)', (
     await select.select(control)
     await sleep(500)
     assert.equal((await state()).revision, start.revision + 1, 'one step')
-    const drawn = () => read(() => document.querySelector('figure-v3-editor').session.read().geometry.find(g => g.id === 'upper-arm')?.visible)
+    const drawn = () => read(() => document.querySelector('figure-editor').session.read().geometry.find(g => g.id === 'upper-arm')?.visible)
     const { value, atLeast } = await read(control => {
-      const asset = JSON.parse(document.querySelector('figure-v3-editor').session.source())
+      const asset = JSON.parse(document.querySelector('figure-editor').session.source())
       const node = asset.document.model.nodes.find(n => n.op === 'at-least@1' && n.args[0] === control)
       return { value: asset.stateDefaults[control], atLeast: asset.document.model.constants.find(c => c.id === node.args[1]).value }
     }, control)
@@ -670,7 +670,7 @@ describe('a part follows the figure size in one step (follow-size, 2026-09-26)',
     })
     assert.ok(notice?.includes('figure.text.size-declared-to-follow'), `a line says so: ${notice}`)
     const grown = await read(() => {
-      const editor = document.querySelector('figure-v3-editor')
+      const editor = document.querySelector('figure-editor')
       editor.session.apply([{ kind: 'set-design', input: 'size.x', unit: 'mm', value: 800 }])
       return editor.session.read().geometry.find(g => g.id === 'box').shape.dimensions
     })
@@ -694,7 +694,7 @@ describe('the recipe catalog: a template chosen, filled in, put onto the chosen
       const r = e.getBoundingClientRect()
       return { x: r.left + r.width / 2, y: r.top + r.height / 2, disabled: !!e.disabled, text: e.textContent.trim() }
     }, selector)
-  const parts = () => read(() => document.querySelector('figure-v3-editor').session.read().geometry.map(g => g.id))
+  const parts = () => read(() => document.querySelector('figure-editor').session.read().geometry.map(g => g.id))
   const type = async (selector, text) => {
     const field = await page().evaluateHandle(selector => {
       const deep = (root = document) => [...root.querySelectorAll(selector)].concat(...[...root.querySelectorAll('*')].filter(e => e.shadowRoot).map(e => deep(e.shadowRoot)))
@@ -712,7 +712,7 @@ describe('the recipe catalog: a template chosen, filled in, put onto the chosen
     await sleep(2500)
     await click(await read(() => probe.row('room')))
     await click(await at('button[recipe-catalog]'))
-    assert.ok(await at('figure-v3-recipe-catalog'), 'the catalog is open')
+    assert.ok(await at('figure-recipe-catalog'), 'the catalog is open')
     await click(await at('button[card="hinged-door"]'))
     /* A search that takes the chosen card away tells the first card it leaves (:3300, 2026-09-26). */
     await type('input[search]', 'sliding')
@@ -734,13 +734,13 @@ describe('the recipe catalog: a template chosen, filled in, put onto the chosen
     await type('input[param="share"]', '50')
     const start = await state()
     await click(await at('button[insert]'))
-    assert.equal(await read(() => document.querySelector('figure-v3-editor').recipeError), '', 'not refused')
+    assert.equal(await read(() => document.querySelector('figure-editor').recipeError), '', 'not refused')
     assert.equal((await state()).revision, start.revision + 1, 'one step')
     const ids = await parts()
     for (const part of ['frame', 'left', 'right', 'lamp']) assert.ok(ids.includes(`sliding-door-1-${part}`), `${part} is in`)
     const frame = await body('sliding-door-1-frame')
     assert.equal(Math.round(frame.dimensions.right - frame.dimensions.left), 2000, "half the room's 4000 mm")
-    assert.equal(await at('figure-v3-recipe-catalog'), null, 'the catalog closes')
+    assert.equal(await at('figure-recipe-catalog'), null, 'the catalog closes')
   })
 
   test('a door the room cannot take is refused in the catalog, with the step it stopped at, and nothing is added', async () => {

package/test/browser/serve.mjs

@@ -10,7 +10,7 @@ const HTML = `<!DOCTYPE html>
 <html><head><meta charset="utf-8"><style>
   html, body { margin: 0; height: 100%; }
   body { display: flex; font-family: sans-serif; }
-  figure-v3-editor { flex: 1; min-width: 0; min-height: 0; }
+  figure-editor { flex: 1; min-width: 0; min-height: 0; }
 </style></head>
 <body><script type="module" src="/page.js"></script></body></html>`
 

package/test/browser/thumbnail-page.js

@@ -1,14 +1,14 @@
 /*
  * The page that draws recipe template thumbnails (ADR-0095 amended): a model -- the host and the template's parts -- drawn
- * the way the modeller draws a figure's card, by the same code (`captureV3Thumbnail`).
+ * the way the modeller draws a figure's card, by the same code (`captureFigureThumbnail`).
  */
-import { captureV3Thumbnail } from 'figure-ui-client/modeller/v3-thumbnail.js'
-import { drawableV3Parts } from 'figure-ui-client/modeller/v3-renderer.js'
-import { compileV3Asset } from '@hatiolab/figure-model'
+import { captureFigureThumbnail } from 'figure-ui-client/modeller/thumbnail.js'
+import { drawableFigureParts } from 'figure-ui-client/modeller/renderer.js'
+import { compileFigureAsset } from '@hatiolab/figure-model'
 
 window.harness = { ready: true }
 window.shoot = async (text, state = {}) => {
   const asset = JSON.parse(text)
-  const evaluation = compileV3Asset(asset).evaluate({ ...asset.stateDefaults, ...state })
-  return await captureV3Thumbnail(drawableV3Parts(evaluation.geometry), evaluation.palette ?? asset.palette ?? {})
+  const evaluation = compileFigureAsset(asset).evaluate({ ...asset.stateDefaults, ...state })
+  return await captureFigureThumbnail(drawableFigureParts(evaluation.geometry), evaluation.palette ?? asset.palette ?? {})
 }

package/test/{v3-clips.test.ts → clips.test.ts}

@@ -8,25 +8,25 @@ import assert from 'node:assert/strict'
 import { readFileSync } from 'node:fs'
 import { fileURLToPath } from 'node:url'
 
-import { addV3Box, applyV3Authoring, createV3Asset, editV3Part } from '@hatiolab/figure-model'
-import type { V3Asset } from '@hatiolab/figure-model'
+import { addFigureBox, applyFigureAuthoring, createFigureAsset, editFigurePart } from '@hatiolab/figure-model'
+import type { FigureAsset } from '@hatiolab/figure-model'
 
-import { clipsOf, poseAt, trackEdit, undrivenOf, withKey, withoutKey } from '../client/modeller/v3-clips.ts'
+import { clipsOf, poseAt, trackEdit, undrivenOf, withKey, withoutKey } from '../client/modeller/clips.ts'
 import { moving } from './joints.ts'
 
 const read = (path: string) => readFileSync(fileURLToPath(new URL(path, import.meta.url)), 'utf8')
 
-const machine = (): V3Asset => {
-  let asset = createV3Asset('Machine')
-  asset = addV3Box(asset, { id: 'block', size: { x: 100, y: 100, z: 100 }, position: { x: 0, y: 50, z: 0 } })
+const machine = (): FigureAsset => {
+  let asset = createFigureAsset('Machine')
+  asset = addFigureBox(asset, { id: 'block', size: { x: 100, y: 100, z: 100 }, position: { x: 0, y: 50, z: 0 } })
   asset = moving(asset, 'block', { kind: 'slide', axis: 'x', id: 'shift', min: 0, max: 60, start: 0 })
-  asset = addV3Box(asset, { id: 'arm', size: { x: 40, y: 200, z: 40 }, position: { x: 0, y: 200, z: 0 } })
+  asset = addFigureBox(asset, { id: 'arm', size: { x: 40, y: 200, z: 40 }, position: { x: 0, y: 200, z: 0 } })
   return moving(asset, 'arm', { kind: 'turn', axis: 'y', id: 'spin', min: -180, max: 180, start: 0 })
 }
 
 test('클립마다 길이와 트랙을, 트랙마다 키를 초로 읽는다', () => {
-  let asset = editV3Part(machine(), { kind: 'set-state-input', input: 'shift', label: '밀기' })
-  asset = editV3Part(asset, { kind: 'set-driver', state: 'shift', clip: 'cycle', duration: 4, keys: [{ seconds: 0, value: 0 }, { seconds: 2, value: 60 }, { seconds: 4, value: 0 }] })
+  let asset = editFigurePart(machine(), { kind: 'set-state-input', input: 'shift', label: '밀기' })
+  asset = editFigurePart(asset, { kind: 'set-driver', state: 'shift', clip: 'cycle', duration: 4, keys: [{ seconds: 0, value: 0 }, { seconds: 2, value: 60 }, { seconds: 4, value: 0 }] })
   assert.deepEqual(undrivenOf(asset), ['spin'], '재생하지 않는 조작값만 새 트랙이 된다')
   const [clip] = clipsOf(asset)
   assert.equal(clip!.name, 'cycle')
@@ -35,19 +35,19 @@ test('클립마다 길이와 트랙을, 트랙마다 키를 초로 읽는다', (
 })
 
 test('막대를 옮기면 그 순간의 자세를 한 묶음으로 — 드라이버와 같은 값', () => {
-  const asset = editV3Part(machine(), { kind: 'set-driver', state: 'shift', clip: 'cycle', duration: 4, keys: [{ seconds: 0, value: 0 }, { seconds: 4, value: 60 }] })
+  const asset = editFigurePart(machine(), { kind: 'set-driver', state: 'shift', clip: 'cycle', duration: 4, keys: [{ seconds: 0, value: 0 }, { seconds: 4, value: 60 }] })
   assert.deepEqual(poseAt(asset, 'cycle', 1), [{ kind: 'set-state', input: 'shift', unit: 'mm', value: 15 }])
   assert.deepEqual(poseAt(asset, 'nothing', 1), [])
 })
 
 test('키를 그 순간에 더하고 빼며, 쓰면 figure-model 이 받는다 — 양 끝은 남는다', () => {
-  let asset = editV3Part(machine(), { kind: 'set-driver', state: 'shift', clip: 'cycle', duration: 4, keys: [{ seconds: 0, value: 0 }, { seconds: 4, value: 60 }] })
+  let asset = editFigurePart(machine(), { kind: 'set-driver', state: 'shift', clip: 'cycle', duration: 4, keys: [{ seconds: 0, value: 0 }, { seconds: 4, value: 60 }] })
   const [clip] = clipsOf(asset)
   const track = clip!.tracks[0]!
   const keys = withKey(track.keys, { seconds: 2, value: 30 })
   assert.deepEqual(keys.map(k => k.seconds), [0, 2, 4])
   assert.deepEqual(withKey(keys, { seconds: 2, value: 45 }).map(k => k.value), [0, 45, 60], '같은 순간이면 바꾼다')
-  asset = editV3Part(asset, trackEdit(clip!, track, { keys }))
+  asset = editFigurePart(asset, trackEdit(clip!, track, { keys }))
   assert.equal(clipsOf(asset)[0]!.tracks[0]!.keys.length, 3)
   assert.equal(withoutKey(track.keys, 1), null, '두 개뿐이면 뺄 수 없다')
   assert.equal(withoutKey(keys, 0), null, '처음 키(0초)는 뺄 수 없다')
@@ -55,13 +55,13 @@ test('키를 그 순간에 더하고 빼며, 쓰면 figure-model 이 받는다
 })
 
 test('움직임 탭에 서고, 막대는 입력 한 묶음 · 나머지는 부품 편집으로 편집기에 닿는다', () => {
-  const editor = read('../client/modeller/v3-editor.ts')
-  const start = editor.indexOf('<figure-v3-clips')
-  const block = editor.slice(start, editor.indexOf('</figure-v3-clips>', start))
+  const editor = read('../client/modeller/editor.ts')
+  const start = editor.indexOf('<figure-clips')
+  const block = editor.slice(start, editor.indexOf('</figure-clips>', start))
   assert.ok(start >= 0)
-  assert.ok(block.includes('@v3-states=${(e: CustomEvent) => this.run(() => this.session!.apply(e.detail.changes))}'))
-  assert.ok(block.includes('@v3-part-edit=${(e: CustomEvent) => this.run(() => this.session!.edit(e.detail.edit))}'))
-  const clips = read('../client/modeller/figure-v3-clips.ts')
+  assert.ok(block.includes('@states=${(e: CustomEvent) => this.run(() => this.session!.apply(e.detail.changes))}'))
+  assert.ok(block.includes('@part-edit=${(e: CustomEvent) => this.run(() => this.session!.edit(e.detail.edit))}'))
+  const clips = read('../client/modeller/figure-clips.ts')
   assert.ok(clips.includes("@change=${(e: Event) => this.scrub(clip, number(e))}"), '막대는 놓을 때 한 번')
   const keys = [...clips.matchAll(/'(figure\.[a-z.-]*[a-z])'/g)].map(m => m[1])
   for (const lang of ['ko', 'en', 'ja', 'zh', 'ms']) {

package/test/{v3-controls.test.ts → controls.test.ts}

@@ -9,25 +9,25 @@ import assert from 'node:assert/strict'
 import { readFileSync } from 'node:fs'
 import { fileURLToPath } from 'node:url'
 
-import { addV3Box, applyV3Authoring, createV3Asset, editV3Part } from '@hatiolab/figure-model'
-import type { V3Asset } from '@hatiolab/figure-model'
+import { addFigureBox, applyFigureAuthoring, createFigureAsset, editFigurePart } from '@hatiolab/figure-model'
+import type { FigureAsset } from '@hatiolab/figure-model'
 
-import { controlsOf, poseAsDefault, poseDiffers } from '../client/modeller/v3-controls.ts'
+import { controlsOf, poseAsDefault, poseDiffers } from '../client/modeller/controls.ts'
 import { moving } from './joints.ts'
 
 const read = (path: string) => readFileSync(fileURLToPath(new URL(path, import.meta.url)), 'utf8')
 
-const slider = (): V3Asset => {
-  let asset = createV3Asset('Slider')
-  asset = addV3Box(asset, { id: 'block', size: { x: 100, y: 100, z: 100 }, position: { x: 0, y: 50, z: 0 } })
+const slider = (): FigureAsset => {
+  let asset = createFigureAsset('Slider')
+  asset = addFigureBox(asset, { id: 'block', size: { x: 100, y: 100, z: 100 }, position: { x: 0, y: 50, z: 0 } })
   asset = moving(asset, 'block', { kind: 'slide', axis: 'x', id: 'shift', min: 0, max: 60, start: 20 })
-  asset = addV3Box(asset, { id: 'arm', size: { x: 40, y: 200, z: 40 }, position: { x: 0, y: 200, z: 0 } })
+  asset = addFigureBox(asset, { id: 'arm', size: { x: 40, y: 200, z: 40 }, position: { x: 0, y: 200, z: 0 } })
   return moving(asset, 'arm', { kind: 'turn', axis: 'y', id: 'spin', min: -90, max: 90, start: 0 })
 }
 
 test('조작값마다 이름 · 단위 · 범위 · 지금 값 · 시작 값 · 이동 시간을 읽는다', () => {
   let asset = slider()
-  asset = editV3Part(asset, { kind: 'set-state-input', input: 'shift', label: '밀기', sweep: 2 })
+  asset = editFigurePart(asset, { kind: 'set-state-input', input: 'shift', label: '밀기', sweep: 2 })
   const [shift, spin] = controlsOf(asset, { shift: 45 })
   assert.deepEqual(
     { ...shift, step: undefined },
@@ -45,21 +45,21 @@ test('지금 자세를 기본으로 — 보고 있는 자세가 시작 자세와
   assert.equal(poseDiffers(controlsOf(asset)), false)
   const looking = controlsOf(asset, { shift: 50, spin: 30 })
   assert.equal(poseDiffers(looking), true)
-  const kept = editV3Part(asset, poseAsDefault(looking))
+  const kept = editFigurePart(asset, poseAsDefault(looking))
   assert.deepEqual([kept.stateDefaults['shift'], kept.stateDefaults['spin']], [50, 30])
   assert.equal(poseDiffers(controlsOf(kept, { shift: 50, spin: 30 })), false)
 })
 
 test('편집기에 닿는다 — 값 바꾸기는 입력으로, 이름 · 범위 · 시간 · 기본 자세는 부품 편집으로', () => {
-  const editor = read('../client/modeller/v3-editor.ts')
-  const start = editor.indexOf('<figure-v3-controls')
-  const block = editor.slice(start, editor.indexOf('</figure-v3-controls>', start))
+  const editor = read('../client/modeller/editor.ts')
+  const start = editor.indexOf('<figure-controls')
+  const block = editor.slice(start, editor.indexOf('</figure-controls>', start))
   assert.ok(start >= 0)
-  assert.ok(block.includes("@v3-state=${(e: CustomEvent) => this.run(() => this.session!.apply([{ kind: 'set-state'"))
-  assert.ok(block.includes('@v3-part-edit=${(e: CustomEvent) => this.run(() => this.session!.edit(e.detail.edit))}'))
+  assert.ok(block.includes("@state=${(e: CustomEvent) => this.run(() => this.session!.apply([{ kind: 'set-state'"))
+  assert.ok(block.includes('@part-edit=${(e: CustomEvent) => this.run(() => this.session!.edit(e.detail.edit))}'))
   assert.ok(editor.includes("const design = view.fields.filter(i => i.role !== 'state')"), '조작값은 설계 값 칸에 두 번 나오지 않는다')
 
-  const controls = read('../client/modeller/figure-v3-controls.ts')
+  const controls = read('../client/modeller/figure-controls.ts')
   assert.ok(controls.includes("@change=${(e: Event) => this.try(c, number(e))}"), '슬라이더는 놓을 때 한 번 — 끄는 동안 기록이 쌓이지 않는다')
   const keys = [...controls.matchAll(/'(figure\.[a-z.-]*[a-z])'/g)].map(m => m[1])
   for (const lang of ['ko', 'en', 'ja', 'zh', 'ms']) {