@things-factory/figure-ui 10.1.75 → 10.1.76

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

@@ -7,16 +7,16 @@ import assert from 'node:assert/strict'
 import { readFileSync } from 'node:fs'
 import { fileURLToPath } from 'node:url'
 
-import { addV3Box, applyV3Authoring, compileV3Asset, createV3Asset } from '@hatiolab/figure-model'
+import { addFigureBox, applyFigureAuthoring, compileFigureAsset, createFigureAsset } from '@hatiolab/figure-model'
 
-import { liveOverridesOf, liveOverSession, livePartsOf, NOTHING_LIVE, scrubbed, scrubStep } from '../client/modeller/v3-live.ts'
+import { liveOverridesOf, liveOverSession, livePartsOf, NOTHING_LIVE, scrubbed, scrubStep } from '../client/modeller/live.ts'
 import { moving } from './joints.ts'
 
 const read = (path: string) => readFileSync(fileURLToPath(new URL(path, import.meta.url)), 'utf8')
 
 const slider = () => {
-  let asset = createV3Asset('Slider')
-  asset = addV3Box(asset, { id: 'block', size: { x: 100, y: 100, z: 100 }, position: { x: 0, y: 50, z: 0 } })
+  let asset = createFigureAsset('Slider')
+  asset = addFigureBox(asset, { id: 'block', size: { x: 100, y: 100, z: 100 }, position: { x: 0, y: 50, z: 0 } })
   return moving(asset, 'block', { kind: 'slide', axis: 'x', id: 'shift', min: 0, max: 60, start: 0 })
 }
 
@@ -69,29 +69,29 @@ test('이름표를 끌면 값이 크기에 맞는 걸음으로 움직인다 —
 })
 
 test('속성창 숫자 칸은 치는 동안 알리고, 이름표를 끌 수 있다 — 기록은 change 에서', () => {
-  const editor = read('../client/modeller/v3-editor.ts')
+  const editor = read('../client/modeller/editor.ts')
   assert.ok(editor.includes('@input=${(e: Event) => this.typing(group.cells[axis] as never, e)}'))
   assert.ok(editor.includes('@input=${(e: Event) => this.typing(field as never, e)}'))
   assert.ok(editor.includes('@pointerdown=${(e: PointerEvent) => this.scrub(group.cells[axis] as never, e, unavailable)}'))
-  for (const event of ['@v3-state-live=', '@v3-states-live=', '@v3-part-live=']) assert.ok(editor.includes(event), event)
-  assert.ok(editor.includes('liveOverSession(asset as V3Asset, this.currentInputs(), this.live)'), '캔버스는 세션 위에 끄는 값을 그린다 (행동은 아래 시험)')
+  for (const event of ['@state-live=', '@states-live=', '@part-live=']) assert.ok(editor.includes(event), event)
+  assert.ok(editor.includes('liveOverSession(asset as FigureAsset, this.currentInputs(), this.live)'), '캔버스는 세션 위에 끄는 값을 그린다 (행동은 아래 시험)')
   const run = editor.slice(editor.indexOf('  private run(action'), editor.indexOf('  private hold('))
   assert.ok(run.includes('this.live = NOTHING_LIVE'), '기록하거나 거절되면 끄는 값을 버린다')
-  const material = read('../client/modeller/figure-v3-material.ts')
+  const material = read('../client/modeller/figure-material-panel.ts')
   assert.ok(material.includes('@input=${(e: Event) => this.glow(Number((e.target as HTMLInputElement).value), true)}'))
 })
 
 test('슬라이더와 클립 막대는 끄는 동안 알리고, 놓을 때 한 번 기록한다', () => {
-  const controls = read('../client/modeller/figure-v3-controls.ts')
+  const controls = read('../client/modeller/figure-controls.ts')
   assert.ok(controls.includes('@input=${(e: Event) => this.drag(c, number(e))}') && controls.includes('@change=${(e: Event) => this.try(c, number(e))}'))
-  assert.ok(controls.includes("new CustomEvent('v3-state-live'"))
-  const clips = read('../client/modeller/figure-v3-clips.ts')
+  assert.ok(controls.includes("new CustomEvent('state-live'"))
+  const clips = read('../client/modeller/figure-clips.ts')
   assert.ok(clips.includes('@input=${(e: Event) => this.scrub(clip, number(e), true)}'))
-  assert.ok(clips.includes("new CustomEvent('v3-states-live'"))
+  assert.ok(clips.includes("new CustomEvent('states-live'"))
 })
 
 test('클립 트랙의 머리는 이름 한 줄, 그 아래 반복 방식과 지우기 — 이름이 한 글자씩 쌓이지 않는다', () => {
-  const clips = read('../client/modeller/figure-v3-clips.ts')
+  const clips = read('../client/modeller/figure-clips.ts')
   const head = clips.slice(clips.indexOf('    div[track-head] {'), clips.indexOf('    div[keys] {'))
   assert.ok(head.includes('display: grid;') && !head.includes('display: flex;'), '공통 스타일의 폭 100% 가 이름을 누르지 않는다')
   assert.ok(head.includes('grid-column: 1 / -1;'), '이름은 제 줄')
@@ -102,14 +102,14 @@ test('끄는 동안은 세션이 지금 든 자세 위에 그린다 — 다른
   /* Two joints: the author turned one with its control; then drags the other. */
   let asset = slider()
   /* An arm on a post of its own, turning about the post's left edge -- so a swing moves it, and the slide does not. */
-  asset = addV3Box(asset, { id: 'post', size: { x: 100, y: 100, z: 100 }, position: { x: 400, y: 50, z: 0 } })
-  asset = applyV3Authoring(asset, { kind: 'attach', part: 'post', face: 'bottom', to: { plane: 'mounting-plane' }, align: { x: { mm: 400 } } })
-  asset = addV3Box(asset, { id: 'arm', size: { x: 100, y: 20, z: 20 }, position: { x: 400, y: 110, z: 0 } })
-  asset = applyV3Authoring(asset, { kind: 'attach', part: 'arm', face: 'bottom', to: { part: 'post', face: 'top' }, align: { x: 'min' } })
+  asset = addFigureBox(asset, { id: 'post', size: { x: 100, y: 100, z: 100 }, position: { x: 400, y: 50, z: 0 } })
+  asset = applyFigureAuthoring(asset, { kind: 'attach', part: 'post', face: 'bottom', to: { plane: 'mounting-plane' }, align: { x: { mm: 400 } } })
+  asset = addFigureBox(asset, { id: 'arm', size: { x: 100, y: 20, z: 20 }, position: { x: 400, y: 110, z: 0 } })
+  asset = applyFigureAuthoring(asset, { kind: 'attach', part: 'arm', face: 'bottom', to: { part: 'post', face: 'top' }, align: { x: 'min' } })
   asset = moving(asset, 'arm', { kind: 'turn', axis: 'y', id: 'swing', min: -180, max: 180 })
   const current = { ...asset.designInputs, ...asset.stateDefaults, swing: 90 }
   const armAt = (parts: { id: string; pose: { t: number[] } }[]) => parts.find(p => p.id === 'arm')!.pose.t.map(v => Math.round(v))
-  const committed = armAt(compileV3Asset({ ...asset, stateDefaults: { ...asset.stateDefaults, swing: 90 } }).evaluate().geometry as never)
+  const committed = armAt(compileFigureAsset({ ...asset, stateDefaults: { ...asset.stateDefaults, swing: 90 } }).evaluate().geometry as never)
   const dragging = armAt(liveOverSession(asset, current, { values: { shift: 30 } }) as never)
   assert.deepEqual(dragging, committed, '사용자 2026-09-24: 「조작을 끝내면 완전히 다른 위치로 된다」 — swing 90 이 끄는 동안에도 남는다')
   const overSaved = armAt(livePartsOf(asset, { values: { shift: 30 } }) as never)

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

@@ -9,23 +9,23 @@ import assert from 'node:assert/strict'
 import { readFileSync } from 'node:fs'
 import { fileURLToPath } from 'node:url'
 
-import { addV3Box, addV3Primitive, compileV3Asset, createV3Asset, editV3Part, v3CostOf } from '@hatiolab/figure-model'
+import { addFigureBox, addFigurePrimitive, compileFigureAsset, createFigureAsset, editFigurePart, figureCostOf } from '@hatiolab/figure-model'
 
 const read = (path: string) => readFileSync(fileURLToPath(new URL(path, import.meta.url)), 'utf8')
-const material = read('../client/modeller/figure-v3-material.ts')
-const editor = read('../client/modeller/v3-editor.ts')
+const material = read('../client/modeller/figure-material-panel.ts')
+const editor = read('../client/modeller/editor.ts')
 
 const probe = () => {
-  let asset = createV3Asset('Probe')
-  asset = addV3Box(asset, { id: 'body', size: { x: 100, y: 100, z: 100 }, position: { x: 0, y: 50, z: 0 } })
-  asset = addV3Primitive(asset, { id: 'drum', kind: 'cylinder', dimensions: { radius: 50, length: 100 }, position: { x: 0, y: 50, z: 0 } })
+  let asset = createFigureAsset('Probe')
+  asset = addFigureBox(asset, { id: 'body', size: { x: 100, y: 100, z: 100 }, position: { x: 0, y: 50, z: 0 } })
+  asset = addFigurePrimitive(asset, { id: 'drum', kind: 'cylinder', dimensions: { radius: 50, length: 100 }, position: { x: 0, y: 50, z: 0 } })
   return asset
 }
 const drawn = (asset: ReturnType<typeof probe>, id: string) =>
-  compileV3Asset(asset).evaluate().geometry.find(g => (g as { id: string }).id === id)!
+  compileFigureAsset(asset).evaluate().geometry.find(g => (g as { id: string }).id === id)!
 
 test('재질 칸이 보내는 모양 그대로 figure-model 이 받고, 그려지는 재질이 바뀐다', () => {
-  const edited = editV3Part(probe(), {
+  const edited = editFigurePart(probe(), {
     kind: 'set-material',
     target: 'body',
     material: { token: 'palette.accent', preset: 'metal', transparent: true, emissive: { token: 'palette.accent', intensity: 0.5, on: true } },
@@ -47,8 +47,8 @@ test('발광 세기 0 은 발광을 없앤다 — 빈 칸을 남기지 않는다
 
 test('곡면 분할은 둥근 몸체에만 내고, 고르면 삼각형 수가 그만큼 바뀐다', () => {
   assert.match(material, /const ROUND = new Set\(\['cylinder', 'ellipticCylinder', 'sphere', 'frustum'\]\)/)
-  const coarse = v3CostOf(editV3Part(probe(), { kind: 'set-segments', target: 'drum', segments: 8 })).triangles
-  const fine = v3CostOf(editV3Part(probe(), { kind: 'set-segments', target: 'drum', segments: 48 })).triangles
+  const coarse = figureCostOf(editFigurePart(probe(), { kind: 'set-segments', target: 'drum', segments: 8 })).triangles
+  const fine = figureCostOf(editFigurePart(probe(), { kind: 'set-segments', target: 'drum', segments: 48 })).triangles
   assert.ok(fine > coarse, `48 분할이 8 분할보다 삼각형이 많다 (${coarse} → ${fine})`)
 })
 
@@ -58,7 +58,7 @@ test('색 역할은 날것의 이름이 아니라 쓰임새로 부른다', () =>
 })
 
 test('편집기는 재질 칸의 편집을 세션의 이력 하나로 돌린다', () => {
-  assert.match(editor, /<figure-v3-material[\s\S]*?@v3-part-edit=\$\{\(e: CustomEvent\) => this\.run\(\(\) => this\.session!\.edit\(e\.detail\.edit\)\)\}/)
+  assert.match(editor, /<figure-material-panel[\s\S]*?@part-edit=\$\{\(e: CustomEvent\) => this\.run\(\(\) => this\.session!\.edit\(e\.detail\.edit\)\)\}/)
 })
 
 test('자산에 없는 색 역할은 그 색을 함께 보낸다 — 새 도형의 팔레트는 기본색 하나다', () => {
@@ -68,7 +68,7 @@ test('자산에 없는 색 역할은 그 색을 함께 보낸다 — 새 도형
 })
 
 test('분할 수 — 흔한 넷은 다각형 윤곽과 삼각형 수로, 나머지는 접어 둔다', () => {
-  const source = readFileSync(fileURLToPath(new URL('../client/modeller/figure-v3-material.ts', import.meta.url)), 'utf8')
+  const source = readFileSync(fileURLToPath(new URL('../client/modeller/figure-material-panel.ts', import.meta.url)), 'utf8')
   assert.ok(source.includes('SEGMENT_PRESETS.slice(0, 4).map(') && source.includes('${silhouette(preset)}'))
   assert.ok(source.includes('<details free') && source.includes('SEGMENT_PRESETS.slice(4)'))
 })

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

@@ -2,16 +2,16 @@
  * **성숙도 탭** (사용자 2026-09-24: 「분석부분도 많이 부족하고, 왜 이렇게 너프되었는지」).
  *
  * 탭은 개수 · 등급과 눈금 · 등급을 정한 한도 · 여섯 축 radar · 한도 막대 · 그리는 비용 · 재사용 추이를 보인다. 여기서는
- * 그 수들이 V3 자산에서 바르게 나오는지, V3 렌더러가 실제로 나눠 쓰는 것을 세는지, 화면이 그 순서와 말로 그리는지를 본다.
+ * 그 수들이 자산에서 바르게 나오는지, 렌더러가 실제로 나눠 쓰는 것을 세는지, 화면이 그 순서와 말로 그리는지를 본다.
  */
 import { test } from 'node:test'
 import assert from 'node:assert/strict'
 import { readFileSync } from 'node:fs'
 import { fileURLToPath } from 'node:url'
 
-import { addV3Box, addV3Primitive, applyV3Authoring, compileV3Asset, createV3Asset, LIMITS, v3ScoreOf } from '@hatiolab/figure-model'
-import type { V3Asset } from '@hatiolab/figure-model'
-import { acquireV3Geometry, releaseV3Geometry } from '@hatiolab/things-scene'
+import { addFigureBox, addFigurePrimitive, applyFigureAuthoring, compileFigureAsset, createFigureAsset, LIMITS, figureScoreOf } from '@hatiolab/figure-model'
+import type { FigureAsset } from '@hatiolab/figure-model'
+import { acquireFigureGeometry, releaseFigureGeometry } from '@hatiolab/things-scene'
 
 import {
   BOARD_ASSETS,
@@ -20,19 +20,19 @@ import {
   decadeSteps,
   GRADE_SCALE,
   gradeOf,
-  V3_BUDGET_KEYS,
-  v3ReportOf
-} from '../client/modeller/v3-maturity.ts'
+  FIGURE_BUDGET_KEYS,
+  figureReportOf
+} from '../client/modeller/maturity.ts'
 import { capacityFrom } from '../client/modeller/scene-budget.ts'
 import { moving } from './joints.ts'
 
 const read = (path: string) => readFileSync(fileURLToPath(new URL(path, import.meta.url)), 'utf8')
-const verdict = read('../client/modeller/figure-v3-verdict.ts')
-const maturity = read('../client/modeller/v3-maturity.ts')
+const verdict = read('../client/modeller/figure-verdict.ts')
+const maturity = read('../client/modeller/maturity.ts')
 
 /** An asset with the given tokens in its palette, so boxes can differ in colour. */
-function withPalette(...tokens: string[]): V3Asset {
-  const asset = createV3Asset('Probe')
+function withPalette(...tokens: string[]): FigureAsset {
+  const asset = createFigureAsset('Probe')
   for (const token of tokens) asset.palette[token] = '#336699'
   return asset
 }
@@ -45,7 +45,7 @@ const cube = (id: string, x: number, token = 'palette.primary', extra: Record<st
 })
 
 test('부품이 없으면 리포트가 없다 — 0 으로 그리지 않는다', () => {
-  assert.equal(v3ReportOf(createV3Asset('Empty')), undefined)
+  assert.equal(figureReportOf(createFigureAsset('Empty')), undefined)
 })
 
 test('등급의 눈금 — 한도의 절반 A · 4분의 3 B · 한도 C · 넘치면 D', () => {
@@ -61,76 +61,76 @@ test('등급의 눈금 — 한도의 절반 A · 4분의 3 B · 한도 C · 넘
   assert.equal(gradeOf(1.01), 'D')
 })
 
-test('등급은 figure-model 의 v3ScoreOf 그대로다 — 목록과 이 탭이 한 셈으로 매긴다', () => {
-  let asset = createV3Asset('Probe')
-  asset = addV3Box(asset, cube('a', 0))
-  const one = v3ReportOf(asset)!
-  assert.deepEqual(one.score, v3ScoreOf(asset))
-  assert.deepEqual(V3_BUDGET_KEYS.filter(k => k !== 'parts'), one.score.budgets.map(b => b.key), '화면이 말을 찾는 키와 셈의 키가 같다 — 등급을 안 정하면 부품 수 한도는 없다')
+test('등급은 figure-model 의 figureScoreOf 그대로다 — 목록과 이 탭이 한 셈으로 매긴다', () => {
+  let asset = createFigureAsset('Probe')
+  asset = addFigureBox(asset, cube('a', 0))
+  const one = figureReportOf(asset)!
+  assert.deepEqual(one.score, figureScoreOf(asset))
+  assert.deepEqual(FIGURE_BUDGET_KEYS.filter(k => k !== 'parts'), one.score.budgets.map(b => b.key), '화면이 말을 찾는 키와 셈의 키가 같다 — 등급을 안 정하면 부품 수 한도는 없다')
 })
 
 test('draw call 한도 3 은 없다 — 한 화면 166 대 목표에 견준다(수석 아키텍트 판정 09-24)', () => {
-  let asset = createV3Asset('Probe')
-  for (let i = 0; i < 4; i++) asset = addV3Box(asset, cube(`b${i}`, i * 200))
-  const four = v3ReportOf(asset)!
+  let asset = createFigureAsset('Probe')
+  for (let i = 0; i < 4; i++) asset = addFigureBox(asset, cube(`b${i}`, i * 200))
+  const four = figureReportOf(asset)!
   assert.equal(four.score.grade, 'A', '예전 한도 3 으로는 D 였다')
   const groups = four.score.budgets.find(b => b.key === 'groups')!
   assert.equal(groups.limit, LIMITS.groupsOnScreen / LIMITS.screenInstances)
   assert.ok(four.capacity.instances >= 2 * LIMITS.screenInstances, 'A 는 목표의 두 배가 들어간다는 뜻')
 })
 
-test('감춘 부품은 그리지 않으므로 한도에 들지 않는다 — v3CostOf 와 같은 셈', () => {
-  let asset = createV3Asset('Probe')
-  asset = addV3Box(asset, cube('a', 0))
-  asset = addV3Box(asset, cube('b', 200))
-  const report = v3ReportOf(asset)!
+test('감춘 부품은 그리지 않으므로 한도에 들지 않는다 — figureCostOf 와 같은 셈', () => {
+  let asset = createFigureAsset('Probe')
+  asset = addFigureBox(asset, cube('a', 0))
+  asset = addFigureBox(asset, cube('b', 200))
+  const report = figureReportOf(asset)!
   assert.equal(report.score.budgets.find(b => b.key === 'groups')!.used, report.cost.groups)
   assert.equal(report.capacity.instances, capacityFrom(report.cost.groups, report.cost.triangles)!.instances)
 })
 
 test('투명 재질은 서로 다른 재질로 센다 — 둘이면 한도 1 을 넘고, 그것이 등급을 정한다', () => {
   let asset = withPalette('glass.a', 'glass.b')
-  asset = addV3Box(asset, cube('a', 0, 'glass.a', { transparent: true }))
-  asset = addV3Box(asset, cube('b', 200, 'glass.b', { transparent: true }))
-  const report = v3ReportOf(asset)!
+  asset = addFigureBox(asset, cube('a', 0, 'glass.a', { transparent: true }))
+  asset = addFigureBox(asset, cube('b', 200, 'glass.b', { transparent: true }))
+  const report = figureReportOf(asset)!
   assert.equal(report.score.budgets.find(b => b.key === 'transparent')!.used, 2)
   assert.equal(report.score.tightest.key, 'transparent')
   assert.equal(report.score.grade, 'D')
 
   let same = withPalette('glass.a')
-  same = addV3Box(same, cube('a', 0, 'glass.a', { transparent: true }))
-  same = addV3Box(same, cube('b', 200, 'glass.a', { transparent: true }))
-  assert.equal(v3ReportOf(same)!.score.budgets.find(b => b.key === 'transparent')!.used, 1, '같은 재질은 하나로 나눠 쓴다')
+  same = addFigureBox(same, cube('a', 0, 'glass.a', { transparent: true }))
+  same = addFigureBox(same, cube('b', 200, 'glass.a', { transparent: true }))
+  assert.equal(figureReportOf(same)!.score.budgets.find(b => b.key === 'transparent')!.used, 1, '같은 재질은 하나로 나눠 쓴다')
 })
 
 test('상태를 따라 움직이는 부품을 센다 — 「따로 움직이는 부품」', () => {
-  let asset = createV3Asset('Probe')
-  asset = addV3Box(asset, cube('base', 0))
-  asset = addV3Box(asset, cube('arm', 200))
-  assert.equal(v3ReportOf(asset)!.score.budgets.find(b => b.key === 'independent')!.used, 0, '전제: 움직임이 없으면 0')
+  let asset = createFigureAsset('Probe')
+  asset = addFigureBox(asset, cube('base', 0))
+  asset = addFigureBox(asset, cube('arm', 200))
+  assert.equal(figureReportOf(asset)!.score.budgets.find(b => b.key === 'independent')!.used, 0, '전제: 움직임이 없으면 0')
 
   asset = moving(asset, 'arm', { kind: 'turn', axis: 'y', id: 'arm.turn', min: 0, max: 90 })
-  assert.equal(v3ReportOf(asset)!.score.budgets.find(b => b.key === 'independent')!.used, 1, '도는 팔 하나')
+  assert.equal(figureReportOf(asset)!.score.budgets.find(b => b.key === 'independent')!.used, 1, '도는 팔 하나')
 })
 
 test('서로 다른 형상은 things-scene 이 정점 버퍼를 나눠 쓰는 수와 같다', () => {
-  let asset = createV3Asset('Probe')
-  asset = addV3Box(asset, cube('a', 0))
-  asset = addV3Box(asset, cube('b', 200))
-  asset = addV3Box(asset, { id: 'c', size: { x: 100, y: 300, z: 100 }, position: { x: 400, y: 150, z: 0 } })
-  asset = addV3Primitive(asset, { id: 'd', kind: 'cylinder', dimensions: { radius: 40, length: 100 }, position: { x: 600, y: 50, z: 0 } })
-  asset = addV3Primitive(asset, { id: 'e', kind: 'cylinder', dimensions: { radius: 40, length: 100 }, position: { x: 800, y: 50, z: 0 } })
-  asset = addV3Primitive(asset, { id: 'f', kind: 'cylinder', dimensions: { radius: 40, length: 100 }, position: { x: 1000, y: 50, z: 0 } })
+  let asset = createFigureAsset('Probe')
+  asset = addFigureBox(asset, cube('a', 0))
+  asset = addFigureBox(asset, cube('b', 200))
+  asset = addFigureBox(asset, { id: 'c', size: { x: 100, y: 300, z: 100 }, position: { x: 400, y: 150, z: 0 } })
+  asset = addFigurePrimitive(asset, { id: 'd', kind: 'cylinder', dimensions: { radius: 40, length: 100 }, position: { x: 600, y: 50, z: 0 } })
+  asset = addFigurePrimitive(asset, { id: 'e', kind: 'cylinder', dimensions: { radius: 40, length: 100 }, position: { x: 800, y: 50, z: 0 } })
+  asset = addFigurePrimitive(asset, { id: 'f', kind: 'cylinder', dimensions: { radius: 40, length: 100 }, position: { x: 1000, y: 50, z: 0 } })
   // The same cylinder, rounder: another vertex buffer in the renderer, so another shape here.
   asset.appearance.find(look => look.target === 'f')!.segments = 24
-  const report = v3ReportOf(asset)!
+  const report = figureReportOf(asset)!
 
-  const bodies = compileV3Asset(asset).evaluate().geometry
-  const held = bodies.map(body => acquireV3Geometry((body as { shape: never }).shape, (body as { segments?: number }).segments))
+  const bodies = compileFigureAsset(asset).evaluate().geometry
+  const held = bodies.map(body => acquireFigureGeometry((body as { shape: never }).shape, (body as { segments?: number }).segments))
   try {
     assert.equal(report.distinctShapes, new Set(held).size, '렌더러의 은행과 같은 키')
   } finally {
-    held.forEach(geometry => releaseV3Geometry(geometry))
+    held.forEach(geometry => releaseFigureGeometry(geometry))
   }
   assert.equal(report.distinctShapes, 4, '같은 상자 둘 · 키 큰 상자 · 같은 원기둥 둘 · 분할이 다른 원기둥')
   assert.deepEqual(report.reuse, { distinct: 4, parts: 6, saved: 2 })
@@ -139,9 +139,9 @@ test('서로 다른 형상은 things-scene 이 정점 버퍼를 나눠 쓰는
 
 test('여섯 축 — 정해진 순서, 잴 수 없는 둘은 비율 없이 까닭을 단다', () => {
   let asset = withPalette('palette.accent')
-  asset = addV3Box(asset, cube('a', 50))
-  asset = addV3Box(asset, cube('b', 150, 'palette.accent'))
-  const axes = v3ReportOf(asset)!.axes
+  asset = addFigureBox(asset, cube('a', 50))
+  asset = addFigureBox(asset, cube('b', 150, 'palette.accent'))
+  const axes = figureReportOf(asset)!.axes
 
   assert.deepEqual(
     axes.map(axis => axis.key),
@@ -149,7 +149,7 @@ test('여섯 축 — 정해진 순서, 잴 수 없는 둘은 비율 없이 까
   )
   const byKey = Object.fromEntries(axes.map(axis => [axis.key, axis]))
   assert.equal(byKey.detail!.ratio, undefined)
-  assert.equal(byKey.detail!.blocked, 'figure.text.maturity-blocked-no-detail-level', '디테일 등급은 V3 에 없다(ADR-0087)')
+  assert.equal(byKey.detail!.blocked, 'figure.text.maturity-blocked-no-detail-level', '디테일 등급은 이 모델에 없다(ADR-0087)')
   assert.equal(byKey.reactive!.ratio, undefined)
   assert.equal(byKey.reactive!.blocked, 'figure.text.maturity-blocked-no-binding')
 
@@ -162,11 +162,11 @@ test('여섯 축 — 정해진 순서, 잴 수 없는 둘은 비율 없이 까
 
 test('재질이 한도를 넘으면 일관성이 한 칸 내려간다 — 셋 중 하나', () => {
   let asset = withPalette('t1', 't2', 't3')
-  asset = addV3Box(asset, cube('a', 0))
-  asset = addV3Box(asset, cube('b', 200, 't1'))
-  asset = addV3Box(asset, cube('c', 400, 't2'))
-  asset = addV3Box(asset, cube('d', 600, 't3'))
-  const report = v3ReportOf(asset)!
+  asset = addFigureBox(asset, cube('a', 0))
+  asset = addFigureBox(asset, cube('b', 200, 't1'))
+  asset = addFigureBox(asset, cube('c', 400, 't2'))
+  asset = addFigureBox(asset, cube('d', 600, 't3'))
+  const report = figureReportOf(asset)!
   assert.equal(report.distinctMaterials, 4)
   const consistency = report.axes.find(axis => axis.key === 'consistency')!
   assert.equal(consistency.ratio, 2 / 3)
@@ -174,18 +174,18 @@ test('재질이 한도를 넘으면 일관성이 한 칸 내려간다 — 셋
 })
 
 test('한 색이 발자국을 다 덮으면 식별성은 0 이다 — 위에서 보면 한 덩어리', () => {
-  let asset = createV3Asset('Probe')
-  asset = addV3Box(asset, { id: 'slab', size: { x: 400, y: 20, z: 400 }, position: { x: 0, y: 10, z: 0 } })
-  asset = addV3Box(asset, { id: 'under', size: { x: 100, y: 5, z: 100 }, position: { x: 0, y: 2.5, z: 0 } })
-  assert.equal(v3ReportOf(asset)!.axes.find(axis => axis.key === 'readable')!.ratio, 0, '아래 부품은 가려진다')
+  let asset = createFigureAsset('Probe')
+  asset = addFigureBox(asset, { id: 'slab', size: { x: 400, y: 20, z: 400 }, position: { x: 0, y: 10, z: 0 } })
+  asset = addFigureBox(asset, { id: 'under', size: { x: 100, y: 5, z: 100 }, position: { x: 0, y: 2.5, z: 0 } })
+  assert.equal(figureReportOf(asset)!.axes.find(axis => axis.key === 'readable')!.ratio, 0, '아래 부품은 가려진다')
 })
 
 test('추이 — 1 에서 1만까지 1·2·5, 삼각형과 draw call 은 오르고 정점 버퍼와 재질은 평평하다', () => {
   assert.deepEqual(decadeSteps(1, 100), [1, 2, 5, 10, 20, 50, 100])
-  let asset = createV3Asset('Probe')
-  asset = addV3Box(asset, cube('a', 0))
-  asset = addV3Box(asset, cube('b', 200))
-  const report = v3ReportOf(asset)!
+  let asset = createFigureAsset('Probe')
+  asset = addFigureBox(asset, cube('a', 0))
+  asset = addFigureBox(asset, cube('b', 200))
+  const report = figureReportOf(asset)!
   const last = report.curve[report.curve.length - 1]!
   assert.equal(report.curve[0]!.instances, 1)
   assert.equal(last.instances, 10000)
@@ -223,7 +223,7 @@ test('radar 와 추이 그림의 조각은 svg 템플릿이다 — html 로 만
 
 test('화면이 키를 이어 붙여 찾는 말도 다섯 말 모두에 있다', () => {
   const keys = [
-    ...V3_BUDGET_KEYS.map(key => `figure.label.budget-${key}`),
+    ...FIGURE_BUDGET_KEYS.map(key => `figure.label.budget-${key}`),
     ...['scale', 'consistency', 'reuse', 'detail', 'reactive', 'readable'].flatMap(key => [`figure.label.axis-${key}`, `figure.label.axis-${key}-short`]),
     'figure.text.bound-by-groups',
     'figure.text.bound-by-triangles',
@@ -237,9 +237,9 @@ test('화면이 키를 이어 붙여 찾는 말도 다섯 말 모두에 있다',
 
 test('부품 목록 머리의 값 한 줄 — 삼각형 · 묶음 · 한 화면 몇 대 · 등급, D 면 넘친 한도를 적는다', () => {
   assert.equal(budgetOf(undefined), undefined, '잴 것이 없으면 줄도 없다')
-  let asset = createV3Asset('Probe')
-  asset = addV3Box(asset, cube('a', 0))
-  const line = budgetOf(v3ReportOf(asset))!
+  let asset = createFigureAsset('Probe')
+  asset = addFigureBox(asset, cube('a', 0))
+  const line = budgetOf(figureReportOf(asset))!
   assert.deepEqual(
     { triangles: line.triangles, groups: line.groups, grade: line.grade },
     { triangles: 12, groups: 1, grade: 'A' }
@@ -247,17 +247,17 @@ test('부품 목록 머리의 값 한 줄 — 삼각형 · 묶음 · 한 화면
   assert.equal(line.instances, capacityFrom(1, 12)!.instances)
 
   let glass = withPalette('glass.a', 'glass.b')
-  glass = addV3Box(glass, cube('a', 0, 'glass.a', { transparent: true }))
-  glass = addV3Box(glass, cube('b', 200, 'glass.b', { transparent: true }))
-  const over = budgetOf(v3ReportOf(glass))!
+  glass = addFigureBox(glass, cube('a', 0, 'glass.a', { transparent: true }))
+  glass = addFigureBox(glass, cube('b', 200, 'glass.b', { transparent: true }))
+  const over = budgetOf(figureReportOf(glass))!
   assert.equal(over.grade, 'D')
   assert.deepEqual(over.tightest, { key: 'transparent', used: 2, limit: 1 })
 
-  const parts = read('../client/modeller/figure-v3-parts.ts')
+  const parts = read('../client/modeller/figure-parts.ts')
   const drawn = parts.slice(parts.indexOf('  private renderBudget()'), parts.indexOf('  /** 한꺼번에 감추고'))
   assert.ok(drawn.includes("const over = b.grade === 'D'") && drawn.includes("'figure.text.parts-budget-over'"), 'D 에서 넘친 한도를 적는다')
   assert.ok(parts.includes("new CustomEvent('show-maturity'"), '누르면 성숙도로')
-  const editor = read('../client/modeller/v3-editor.ts')
+  const editor = read('../client/modeller/editor.ts')
   assert.ok(editor.includes('.budget=${this.budget}') && editor.includes("@show-maturity=${() => (this.tab = 'verdict')}"))
   assert.ok(verdict.includes('budget: budgetOf(report)'), '성숙도 탭이 같은 보고서에서 알린다')
 })

package/test/modeller-route.test.ts

@@ -15,13 +15,12 @@ test('every figure and a new one open the one modeller', () => {
   assert.equal(modellerPathOf(), 'figure-modeller')
 })
 
-test('the route and the shell table send both addresses to the V3 page, and no `figure-modeller-page` is registered', () => {
+test('one modeller page at one address: the route and the shell table agree', () => {
   const route = read('../client/route.ts')
-  assert.doesNotMatch(route, /figure-modeller-page/)
+  assert.equal(route.match(/case 'figure-modeller':/g)?.length, 1)
+  assert.match(route, /import\('\.\/pages\/figure-modeller-page'\)/)
   const config = read('../things-factory.config.js')
-  assert.match(config, /tagname: 'figure-v3-modeller-page', page: 'figure-modeller'/)
-  assert.match(config, /tagname: 'figure-v3-modeller-page', page: 'figure-v3-modeller'/)
-  assert.doesNotMatch(config, /'figure-modeller-page'/)
+  assert.equal(config.match(/tagname: 'figure-modeller-page', page: 'figure-modeller'/g)?.length, 1)
 })
 
 test('the catalogue opens figures through the one path', () => {
@@ -30,7 +29,7 @@ test('the catalogue opens figures through the one path', () => {
 })
 
 test('reloading or closing the tab with unsaved work asks first — the shell does not ask canDeactivate then (09-26)', () => {
-  const page = read('../client/pages/figure-v3-modeller-page.ts')
+  const page = read('../client/pages/figure-modeller-page.ts')
   const hold = page.slice(page.indexOf('private holdUnsaved'), page.indexOf('connectedCallback()'))
   assert.match(hold, /session\.read\(\)\.dirty/, 'only when there is something unsaved')
   assert.match(hold, /event\.preventDefault\(\)/)

package/test/{v3-palette-icons.test.ts → palette-icons.test.ts}

@@ -14,7 +14,7 @@ import { fileURLToPath } from 'node:url'
 const RENDERS = new Set(['deployed_code', 'database', 'crop_square', 'circle', 'change_history', 'hexagon', 'check_box_outline_blank', 'crop_portrait', 'door_front'])
 
 test('every shape in the palette has an icon the font draws', () => {
-  const parts = readFileSync(fileURLToPath(new URL('../client/modeller/figure-v3-parts.ts', import.meta.url)), 'utf8')
+  const parts = readFileSync(fileURLToPath(new URL('../client/modeller/figure-parts.ts', import.meta.url)), 'utf8')
   const recipes = parts.slice(parts.indexOf('const RECIPES'), parts.indexOf(']', parts.indexOf('const RECIPES')))
   const icons = [...recipes.matchAll(/icon: '([a-z_]+)'/g)].map(m => m[1]!)
   assert.ok(icons.length >= 9)

package/test/{v3-parts-wiring.test.ts → parts-wiring.test.ts}

@@ -1,7 +1,7 @@
 /*
  * **편집기의 부품 목록** (2026-09-24).
  *
- * `figure-v3-parts` 는 지어졌지만(fdc15e162e) 편집기 어디에도
+ * `figure-parts` 는 지어졌지만(fdc15e162e) 편집기 어디에도
  * 걸리지 않았다. 편집기는 맨 단추 네 개와 이름 단추 목록이었다. 패널이 내는 사건마다 받는 자리가 있어야 한다 —
  * 없으면 눌러도 아무 일이 없다.
  */
@@ -11,14 +11,14 @@ import { readFileSync } from 'node:fs'
 import { fileURLToPath } from 'node:url'
 
 const read = (path: string) => readFileSync(fileURLToPath(new URL(path, import.meta.url)), 'utf8')
-const editor = read('../client/modeller/v3-editor.ts')
-const panel = read('../client/modeller/figure-v3-parts.ts')
+const editor = read('../client/modeller/editor.ts')
+const panel = read('../client/modeller/figure-parts.ts')
 
 test('패널이 내는 사건마다 편집기에 받는 자리가 있다', () => {
   const asked = new Set([...panel.matchAll(/this\.ask\('([a-z-]+)'/g)].map(m => m[1]))
   for (const name of [...panel.matchAll(/op\('([a-z-]+)'/g)].map(m => m[1])) asked.add(name)
   assert.ok(asked.size >= 8, `전제: 패널의 사건을 읽었다 (${[...asked].join(', ')})`)
-  const listener = editor.slice(editor.indexOf('<figure-v3-parts'), editor.indexOf('</figure-v3-parts>'))
+  const listener = editor.slice(editor.indexOf('<figure-parts'), editor.indexOf('</figure-parts>'))
   for (const name of asked) assert.ok(listener.includes(`@${name}=`), `${name} 을 받는 자리가 없다`)
 })
 
@@ -37,7 +37,7 @@ test('작업대에서 가린 부품은 캔버스에서 빠지고, 다른 도형
 })
 
 test('지울 수 없는 부품은 사람의 말로 거절하고, 지우며 풀어 준 것은 사람의 말로 알린다 — 다섯 말 모두', () => {
-  /* Since 2026-09-25 the reason is told apart (partRefusalOf, tested in v3-refusals); the editor hands the refusal to it. */
+  /* Since 2026-09-25 the reason is told apart (partRefusalOf, tested in refusals); the editor hands the refusal to it. */
   assert.match(editor, /private removePart[\s\S]*?partRefusalOf\(error, id,/)
   assert.match(editor, /private removePart[\s\S]*?this\.notice = removalNoticeOf\(view\.removal,/, '지운 뒤 풀어 준 것을 알린다')
   for (const lang of ['ko', 'en', 'ja', 'zh', 'ms']) {

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

@@ -7,9 +7,9 @@ import assert from 'node:assert/strict'
 import { readFileSync } from 'node:fs'
 import { fileURLToPath } from 'node:url'
 
-import { addV3Box, createV3Asset } from '@hatiolab/figure-model'
+import { addFigureBox, createFigureAsset } from '@hatiolab/figure-model'
 
-import { authoredSizeOf, PREVIEW_WAYS, previewClampsOf, previewInstances } from '../client/modeller/v3-preview-model.ts'
+import { authoredSizeOf, PREVIEW_WAYS, previewClampsOf, previewInstances } from '../client/modeller/preview-model.ts'
 
 const read = (path: string) => readFileSync(fileURLToPath(new URL(path, import.meta.url)), 'utf8')
 
@@ -26,31 +26,31 @@ test('여덟 — 기준과 일곱 조합, 한 줄에 넷, 늘린 축만 두 배
 })
 
 test('크기를 선언하지 않은 도형은 부품이 차지하는 범위를 기준 크기로', () => {
-  const asset = addV3Box(createV3Asset('Fixed'), { id: 'body', size: { x: 300, y: 200, z: 100 }, position: { x: 0, y: 100, z: 0 } })
+  const asset = addFigureBox(createFigureAsset('Fixed'), { id: 'body', size: { x: 300, y: 200, z: 100 }, position: { x: 0, y: 100, z: 0 } })
   assert.deepEqual(authoredSizeOf(asset), { x: 300, y: 200, z: 100 })
 })
 
 test('편집 | 미리보기 — 띠에서 오가고, 미리보기는 도면처럼 등록해 세우며 제 타입으로 남의 도면을 건드리지 않는다', () => {
-  const editor = read('../client/modeller/v3-editor.ts')
+  const editor = read('../client/modeller/editor.ts')
   assert.ok(editor.includes("(['edit', 'preview'] as const).map("))
-  assert.ok(editor.includes('<figure-v3-preview'))
-  const preview = read('../client/modeller/figure-v3-preview.ts')
-  assert.ok(preview.includes('registerFigureV3(type, asset)') && preview.includes('unregisterFigureV3(this.registered)'))
-  assert.ok(preview.includes('`figure-v3-preview-${this.context || \'new\'}`'))
+  assert.ok(editor.includes('<figure-preview'))
+  const preview = read('../client/modeller/figure-preview.ts')
+  assert.ok(preview.includes('registerFigure(type, asset)') && preview.includes('unregisterFigure(this.registered)'))
+  assert.ok(preview.includes('`figure-preview-${this.context || \'new\'}`'))
   assert.ok(preview.includes("kind: 'set-state-defaults'"), '이 자세를 기본으로')
   assert.ok(preview.includes('dialShape('), '각도는 다이얼로')
 })
 
 test('미리보기 — 선언하지 않은 크기를 묻는 변형은 그려지는 크기를 말한다(높이만 따르는 조명탑, 아키텍트 판정 09-25)', async () => {
   const fm = await import('@hatiolab/figure-model')
-  let a = fm.addV3Box(fm.createV3Asset('Tower'), { id: 'mast', size: { x: 200, y: 2000, z: 300 }, position: { x: 0, y: 0, z: 0 } })
-  a = fm.applyV3Authoring(a, { kind: 'attach', part: 'mast', face: 'bottom', to: { plane: 'mounting-plane' } })
-  a = fm.applyV3Authoring(a, { kind: 'declare-instance-size', range: { x: { min: 200, max: 200 }, y: { min: 1000, max: 3000 }, z: { min: 300, max: 300 } } })
+  let a = fm.addFigureBox(fm.createFigureAsset('Tower'), { id: 'mast', size: { x: 200, y: 2000, z: 300 }, position: { x: 0, y: 0, z: 0 } })
+  a = fm.applyFigureAuthoring(a, { kind: 'attach', part: 'mast', face: 'bottom', to: { plane: 'mounting-plane' } })
+  a = fm.applyFigureAuthoring(a, { kind: 'declare-instance-size', range: { x: { min: 200, max: 200 }, y: { min: 1000, max: 3000 }, z: { min: 300, max: 300 } } })
   const clamps = previewClampsOf(a, authoredSizeOf(a))
   assert.deepEqual(clamps['base'], [], '기준은 그대로')
   assert.deepEqual(clamps['x'], [{ axis: 'x', asked: 400, used: 200 }])
   assert.deepEqual(clamps['y'], [{ axis: 'y', asked: 4000, used: 3000 }], '높이도 선언 최대까지')
   assert.deepEqual(clamps['x·y·z'].map(c => c.axis), ['x', 'y', 'z'])
-  const view = readFileSync(fileURLToPath(new URL('../client/modeller/figure-v3-preview.ts', import.meta.url)), 'utf8')
+  const view = readFileSync(fileURLToPath(new URL('../client/modeller/figure-preview.ts', import.meta.url)), 'utf8')
   assert.ok(view.includes("i18next.t('figure.text.preview-clamped'"), '범례에 적는다')
 })