@things-factory/figure-ui 10.1.46 → 10.1.48

package/test/v3-scene-canvas.test.ts

@@ -0,0 +1,85 @@
+/*
+ * **편집 캔버스는 V2 처럼 things-scene 편집 모드 위에 선다** (사용자 2026-09-24: 「v2 방식으로 하면 안되냐」).
+ *
+ * 부품마다 `figure-v3-part` 컴포넌트로 판에 세우면 고르기 · 주황 테두리 · 기즈모와 스냅 · 박스 선택 · 카메라(감속 ·
+ * 커서 쪽 확대 · 더블클릭 맞추기 · 시점 1~6) · 스튜디오 환경 · 좌표 바탕 · 조명과 그림자가 씬에서 온다. 여기서는 그
+ * 배선과, 몸체 ↔ 컴포넌트의 대응이 왕복하는지를 잰다.
+ */
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+import { readFileSync } from 'node:fs'
+import { fileURLToPath } from 'node:url'
+
+import { changedKeys, componentOf, gizmoResultOf } from '../client/modeller/v3-stage-model.ts'
+import type { V3RenderPart } from '../client/modeller/v3-renderer.ts'
+
+const read = (path: string) => readFileSync(fileURLToPath(new URL(path, import.meta.url)), 'utf8')
+const canvas = read('../client/modeller/v3-canvas.ts')
+const board = { width: 2000, height: 2000 }
+
+const turned = (deg: number) => {
+  const a = (deg * Math.PI) / 180
+  return [
+    [Math.cos(a), 0, Math.sin(a)],
+    [0, 1, 0],
+    [-Math.sin(a), 0, Math.cos(a)]
+  ]
+}
+const box = (t: number[], r = turned(0)): V3RenderPart => ({
+  id: 'block',
+  shape: { provider: 'box', dimensions: { width: 200, height: 100, depth: 60 } },
+  pose: { r, t },
+  material: { token: 'palette.primary' }
+})
+
+test('things-scene 의 판을 편집 모드로 세우고, 보기 설정은 판의 상태 이름 그대로 넣는다', () => {
+  assert.ok(canvas.includes("import { create, Model, niceGridStep } from '@hatiolab/things-scene'"))
+  assert.match(canvas, /type: 'model-layer'/)
+  assert.match(canvas, /mode: 1\n/, '편집 모드 — 시점 단추 · 기즈모 · 도움말 · 단축키')
+  assert.ok(canvas.includes('...sceneLook(this.view ?? DEFAULT_VIEW)'))
+  assert.ok(canvas.includes('pixelRatio: Math.min(3, (window.devicePixelRatio || 1) * 2)'), 'V2 의 두 배 표본')
+  assert.doesNotMatch(canvas, /new THREE\.|WebGLRenderer|OrbitControls|TransformControls/, '제 장면을 짜지 않는다')
+})
+
+test('몸체는 자기 상자로 서고, 씬의 낱말(width·depth·height · left·top·zPos · 회전)로 적힌다', () => {
+  const state = componentOf(box([100, 50, -30]), { 'palette.primary': '#123456' }, board)!
+  assert.equal(state.type, 'figure-v3-part')
+  assert.equal(state.name, 'block')
+  assert.deepEqual([state.width, state.depth, state.height], [200, 100, 60])
+  assert.equal(state.left, 100 + 1000 - 100)
+  assert.equal(state.top, -30 + 1000 - 30)
+  assert.equal(state.zPos, 0, '가운데가 y 50, 높이 100 이면 바닥이 0')
+  assert.equal(state.color, '#123456')
+})
+
+test('기즈모가 옮기면 원점이, 돌리면 각도가, 늘리면 자기 축의 배율이 돌아온다', () => {
+  const part = box([100, 50, -30])
+  const at = componentOf(part, {}, board)!
+  assert.deepEqual(gizmoResultOf(part, at, board), {}, '안 움직였으면 아무것도')
+
+  const moved = gizmoResultOf(part, { ...at, left: (at.left as number) + 40, zPos: 20 }, board)
+  assert.deepEqual(moved.position!.map(Math.round), [140, 70, -30])
+  assert.equal(moved.rotation, undefined)
+
+  const spun = gizmoResultOf(part, { ...at, rotation: -Math.PI / 6 }, board)
+  assert.deepEqual(spun.rotation!.map(v => Math.round(v * 10) / 10 + 0), [0, 30, 0])
+
+  const grown = gizmoResultOf(part, { ...at, width: 400, left: (at.left as number) - 100 }, board)
+  assert.deepEqual(grown.scale!.map(v => Math.round(v * 1000) / 1000), [2, 1, 1])
+  assert.equal(grown.position, undefined, '가운데서 양쪽으로 늘리면 원점은 그대로')
+})
+
+test('돌린 몸체도 왕복한다 — 판에 적은 상태를 그대로 되읽으면 아무것도 안 바뀐다', () => {
+  const part = box([10, 50, 20], turned(35))
+  const at = componentOf(part, {}, board)!
+  assert.deepEqual(gizmoResultOf(part, at, board), {})
+  assert.equal(changedKeys(at, { ...at }), null, '같은 값은 다시 넣지 않는다 — 씬이 메아리를 내지 않게')
+  assert.deepEqual(changedKeys(at, { ...at, left: 1 }), { left: 1 })
+})
+
+test('고르기와 끌기는 이름으로 알리고, 스스로 적은 것의 메아리는 끌기로 읽지 않는다', () => {
+  assert.ok(canvas.includes("root.on('selected'"))
+  assert.ok(canvas.includes("if (this.writing) return"))
+  assert.ok(canvas.includes("new CustomEvent('part-transformed', { detail: { id: part.id, result }"))
+  assert.ok(canvas.includes('setTimeout(() => this.sync())'), '받지 못한 변경은 입력이 둔 자리로 돌아간다')
+})

package/test/v3-stage-model.test.ts

@@ -0,0 +1,25 @@
+/*
+ * The editing board only grows while a figure is edited (user 2026-09-24: 「조작값을 변경하면, 편집기가 자꾸 리프레시」).
+ * A board that outgrows itself is stood up again and the camera is lost; a raised arm made the height larger and the
+ * height was measured afresh each time.
+ */
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+
+import { addV3Box, compileV3Asset, createV3Asset } from '@hatiolab/figure-model'
+
+import { drawableV3Parts } from '../client/modeller/v3-renderer.ts'
+import { boardFor } from '../client/modeller/v3-stage-model.ts'
+
+const partsOf = (height: number) =>
+  drawableV3Parts(
+    compileV3Asset(addV3Box(createV3Asset('Probe'), { id: 'post', size: { x: 100, y: height, z: 100 }, position: { x: 0, y: height / 2, z: 0 } }))
+      .evaluate().geometry
+  )
+
+test('the board keeps the height it had: a part that shrinks back does not stand a new board up', () => {
+  const tall = boardFor(partsOf(2000))
+  const after = boardFor(partsOf(500), tall)
+  assert.equal(after.depth, tall.depth)
+  assert.ok(boardFor(partsOf(3000), tall).depth > tall.depth, 'it still grows')
+})

package/test/v3-theme.test.ts

@@ -20,24 +20,14 @@ const fixed = (text: string) =>
     .replace(/var\(--[\w-]+,\s*#[0-9a-fA-F]{3,8}\)/g, '')
     .match(/#[0-9a-fA-F]{6}\b|#[0-9a-fA-F]{3}\b(?![\w-])/g) ?? []
 
-test('캔버스와 편집기에 박힌 색이 없다 — 토큰의 대체값만 남는다', () => {
-  assert.deepEqual(fixed(canvas), [], 'v3-canvas.ts')
+test('편집기에 박힌 색이 없다 — 토큰의 대체값만 남는다', () => {
   assert.deepEqual(fixed(editor), [], 'v3-editor.ts')
 })
 
-test('캔버스 바탕은 CSS 와 3D 가 같은 토큰에서 온다', () => {
-  assert.match(canvas, /background: var\(--md-sys-color-surface-container\)/)
-  assert.match(canvas, /this\.scene\.background = new THREE\.Color\(colour\)/)
-  assert.match(canvas, /getComputedStyle\(this\)\.backgroundColor/, '3D 바탕이 호스트의 바탕을 읽는다')
-})
-
-test('테마를 바꾸면 3D 바탕을 다시 읽는다 — 한 번만 읽으면 가운데만 밝은 판이 남는다', () => {
-  assert.match(canvas, /observe\(document\.body, \{ attributes: true, attributeFilter: \['class'\] \}\)/)
-  const onChange = canvas.slice(canvas.indexOf('new MutationObserver'), canvas.indexOf('this.themeObserver.observe'))
-  assert.match(onChange, /this\.paintBackground\(\)/)
-  assert.match(onChange, /this\.draw\(\)/, '다시 읽고 그리지 않으면 다음 움직임까지 옛 색이다')
-  const leave = canvas.slice(canvas.indexOf('disconnectedCallback()'))
-  assert.match(leave, /this\.themeObserver\?\.disconnect\(\)/, '떠난 캔버스가 body 를 계속 지켜본다')
+test('캔버스 바탕은 V2 의 작업대 회색 — 판의 하늘색이라 환경 탭에서 바꾼다', () => {
+  assert.ok(canvas.includes('background-color: ${unsafeCSS(WORKBENCH)}'), '씬이 서기 전 · 2D 쪽도 같은 색')
+  assert.ok(canvas.includes("sky: 'color'") && canvas.includes('...sceneLook(this.view ?? DEFAULT_VIEW)'), '3D 바탕은 보기 설정의 skyColor')
+  assert.match(read('../client/modeller/figure-view.ts'), /skyColor: WORKBENCH/)
 })
 
 test('눌린 단추와 오류 칸은 셸이 두 테마 대비를 맞춘 칸을 쓴다', () => {
@@ -50,18 +40,19 @@ test('눌린 단추와 오류 칸은 셸이 두 테마 대비를 맞춘 칸을
   assert.match(error, /--md-sys-color-on-error-container\)/)
 })
 
-test('편집기는 창이 아니라 자기 폭으로 접는다 — 레일과 오른쪽 칸이 폭을 먼저 가져간다', () => {
+test('편집기는 창이 아니라 자기 폭으로 접는다 — 레일이 폭을 먼저 가져간다', () => {
+  /* The widths - 200 | 1fr | 340, 160 | 300 under 860px, one column with the canvas first under 560px - are
+     ox-three-pane's, measured in @operato/layout's own test. The editor must not write the grid again. */
   assert.match(editor, /container-type: inline-size/)
-  assert.doesNotMatch(editor, /@media \(max-width/, '창 폭 기준이 남아 있다 — 레일을 펼치면 편집기가 오른쪽 칸 위로 넘친다')
-  assert.match(editor, /@container \(max-width: 659px\)/, '세 칸의 최소 폭 합(660) 아래에서 두 칸')
-  const one = editor.slice(editor.indexOf('@container (max-width: 419px)'))
-  assert.match(one, /grid-template-columns: minmax\(0, 1fr\)/, '420 아래에서 한 줄')
-  assert.match(one, /figure-v3-canvas \{\s*order: -1;/, '한 줄에서는 캔버스가 먼저')
+  assert.doesNotMatch(editor, /@media \(max-width/, '창 폭 기준이 남아 있다 — 레일을 펼치면 편집기가 넘친다')
+  assert.match(editor, /<ox-three-pane>/, '세 칸은 공용 틀')
+  assert.doesNotMatch(editor, /grid-template-columns/, '편집기가 격자를 다시 쓰지 않는다')
 })
 
-test('넘침이 없으니 오른쪽 칸은 편집기를 가리지 않는다 — 가림은 우회였다', () => {
-  const page = read('../client/pages/figure-v3-modeller-page.ts')
-  const aside = page.slice(page.indexOf('    aside {'), page.indexOf('}', page.indexOf('    aside {')))
+test('양쪽 칸은 띠에서 접는다 — 접으면 캔버스가 그 폭을 갖고, 오른쪽 칸은 무엇도 가리지 않는다', () => {
+  assert.ok(editor.includes('.pane=${this.panes}'), '띠가 그 틀을 접는다')
+  assert.match(editor, /querySelector<OxThreePane>\('ox-three-pane'\)/, '띠에 건네는 틀은 편집기의 세 칸')
+  const aside = editor.slice(editor.indexOf('    aside {'), editor.indexOf('}', editor.indexOf('    aside {')))
   assert.doesNotMatch(aside, /z-index/)
-  assert.match(aside, /border-left: 1px solid var\(--md-sys-color-outline-variant\)/, '칸 경계선은 남는다')
+  assert.doesNotMatch(aside, /border-left/, '칸 경계선은 틀이 긋는다 — 두 줄이 되지 않게')
 })

package/test/v3-thumbnail.test.ts

@@ -0,0 +1,29 @@
+/*
+ * **저장하면 카드 그림이 남는다** (사용자 2026-09-24: 「why you don't save thumbnail when I save the figure?」).
+ *
+ * 캔버스가 씬 위로 옮겨 갈 때 찍는 길(`snapshot`)이 빠졌고, 찍는 쪽은 없는 메서드를 `?.()` 로 불러 아무 말 없이
+ * 그림 없이 저장했다. 브라우저에서만 찍히므로 여기서는 길이 이어져 있는지를 본다: 찍는 쪽이 보기 전용 캔버스를 세워
+ * `snapshot` 을 부르고, 캔버스는 씬의 3D 그림(`snapshot3d`)을 내며, 보기 전용이면 편집기에 아무것도 알리지 않는다.
+ */
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+import { readFileSync } from 'node:fs'
+import { fileURLToPath } from 'node:url'
+
+const read = (path: string) => readFileSync(fileURLToPath(new URL(path, import.meta.url)), 'utf8')
+
+test('the save takes the card picture from a view-only canvas, through the scene’s 3D snapshot', () => {
+  const shooter = read('../client/modeller/v3-thumbnail.ts')
+  assert.ok(shooter.includes('shooter.viewOnly = true'))
+  assert.ok(shooter.includes('return shooter.snapshot ? await shooter.snapshot(WIDTH, HEIGHT) : undefined'))
+  assert.ok(!shooter.includes('thumbnail?.()'), 'no call to a method the canvas does not have')
+
+  const canvas = read('../client/modeller/v3-canvas.ts')
+  assert.ok(canvas.includes('async snapshot(width = 480, height = 360)'))
+  assert.ok(canvas.includes("await layer.snapshot3d(width, height, 'image/webp', 0.85)"), 'the 3D view, not the 2D sheet')
+  const watch = canvas.slice(canvas.indexOf('  private watchScene()'), canvas.indexOf('  private showSelected()'))
+  assert.ok(watch.includes('|| this.viewOnly) return'), 'a view-only canvas tells the editor nothing')
+
+  const editor = read('../client/modeller/v3-editor.ts')
+  assert.ok(editor.includes('const thumbnail = await captureV3Thumbnail('), 'the save asks for it')
+})

package/test/v3-verdict.test.ts

@@ -29,8 +29,10 @@ test('개수는 목록 카드와 같은 셈이다 — V3 원가를 같은 capaci
 
   assert.equal(cost.groups, 2, '전제: 그려지는 부품 둘이 묶음 둘')
   assert.equal(capacityFrom(cost.groups, cost.triangles)?.instances, Math.floor(SCENE_BUDGET.groupsOnScreen / 2))
-  assert.ok(/capacityFrom\(cost\.groups, cost\.triangles\)/.test(verdict), '판정 탭이 카드와 같은 함수로 센다')
-  assert.ok(!/grade/.test(verdict.replace(/\/\*[\s\S]*?\*\//g, '')), 'V3 에는 잰 것이 없는 등급을 그리지 않는다')
+  const maturity = read('../client/modeller/v3-maturity.ts')
+  assert.ok(/capacityFrom\(cost\.groups, cost\.triangles\)/.test(maturity), '판정 탭이 카드와 같은 함수로 센다')
+  assert.ok(/report = asset \? v3ReportOf\(asset\) : undefined/.test(verdict), '탭은 그 셈을 부르고 보여 줄 뿐이다')
+  assert.ok(/instances: report\?\.capacity\.instances/.test(verdict), '탭 이름표의 개수도 같은 셈에서 온다')
 })
 
 test('판정은 발행 패널과 같은 서버 문에서 온다 — 화면이 따로 판정하지 않는다', () => {
@@ -56,15 +58,19 @@ test('판정 탭은 발행 패널과 같은 두 판정에 「부품에 맞추기
   assert.ok(/<figure-v3-verdict[\s\S]*?@fit-base-to-parts=\$\{this\.fitToParts\}/.test(page), '누르면 공간 선언으로 이어진다')
 })
 
-test('화면이 탭 둘을 걸고, 감추되 떼지 않는다', () => {
+test('판정과 이력은 편집기의 탭에 서고, 감추되 떼지 않는다', () => {
+  const editor = read('../client/modeller/v3-editor.ts')
   assert.ok(/<figure-v3-verdict[\s\S]*?\.source=\$\{this\.draftSource\(\)\}/.test(page), '편집 중인 원본을 넘긴다')
   assert.ok(/<figure-v3-verdict[\s\S]*?\.figureType=/.test(page), '타입을 바꾸면 다시 판정한다')
-  assert.ok(/<figure-v3-verdict\s+\?off=/.test(page) && /<figure-history-panel\s+\?off=/.test(page), '고르지 않은 탭은 감춘다')
-  assert.ok(/@capacity-changed=/.test(page) && /this\.instances\)/.test(page), '개수가 탭 이름표에 남는다')
+  assert.ok(/<figure-v3-verdict\s+slot="verdict"/.test(page) && /<figure-history-panel\s+slot="history"/.test(page))
+  assert.ok(editor.includes(`<div panel flush ?off=\${tab !== 'verdict'}><slot name="verdict"></slot></div>`), '고르지 않은 탭은 감춘다 — 판정은 마지막 답을 지킨다')
+  assert.ok(/@capacity-changed=/.test(page) && page.includes('.instances=${this.instances}'), '개수를 편집기에 넘긴다')
+  assert.ok(editor.includes("this.renderTab('verdict', 'insights', i18next.t('figure.label.maturity'), this.instances)"), '개수가 탭 이름표에 남는다')
 })
 
 test('판정 탭의 말은 다섯 말 모두에 있다 — 없으면 키가 그대로 찍힌다', () => {
-  const keys = [...verdict.matchAll(/'(figure\.[a-z.-]*[a-z])'/g)].map(m => m[1])
+  const maturity = read('../client/modeller/v3-maturity.ts')
+  const keys = [...(verdict + maturity).matchAll(/'(figure\.[a-z.-]*[a-z])'/g)].map(m => m[1])
   assert.ok(keys.includes('figure.text.verdict-asking'), '전제: 삼항 안의 키도 센다')
   for (const lang of ['ko', 'en', 'ja', 'zh', 'ms']) {
     const table = JSON.parse(read(`../translations/${lang}.json`))

package/test/v3-view.test.ts

@@ -0,0 +1,20 @@
+/*
+ * **보기 — 작업대의 설정** (V3 동등표 ⑦, V2 의 「환경」 탭). 도형에 저장되지 않고, 보는 사람의 브라우저에 남는다.
+ */
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+import { readFileSync } from 'node:fs'
+import { fileURLToPath } from 'node:url'
+
+
+const read = (path: string) => readFileSync(fileURLToPath(new URL(path, import.meta.url)), 'utf8')
+
+test('환경 탭은 V2 의 보기 패널 그대로 — 설정은 판의 상태 이름이고, 도형이 아니라 브라우저에 둔다', () => {
+  const editor = read('../client/modeller/v3-editor.ts')
+  assert.ok(editor.includes('<figure-settings .view=${this.view} @update-view=${(e: CustomEvent) => this.setView(e.detail.view)}></figure-settings>'))
+  assert.ok(editor.includes("localStorage.setItem('figure-v3-view'"))
+  assert.doesNotMatch(editor.slice(editor.indexOf('private setView'), editor.indexOf('private setView') + 400), /session/, '설정은 세션(도형)에 닿지 않는다')
+  const view = read('../client/modeller/figure-view.ts')
+  assert.ok(view.includes("'studio',") && view.includes("'rainy'"), '환경 여덟')
+  assert.ok(read('../client/modeller/figure-settings.ts').includes("i18next.t('figure.text.view-settings-are-not-saved')"))
+})

package/translations/en.json

@@ -15,6 +15,13 @@
   "figure.button.duplicate-part": "duplicate",
   "figure.button.fit-base-to-parts": "fit to parts",
   "figure.button.fix-position": "fix here",
+  "figure.button.scale-position": "in proportion",
+  "figure.button.remeasure-range": "measure again",
+  "figure.label.sizing-rule": "when the size changes",
+  "figure.label.sizing-uniform": "one ratio (geometric mean of the three axes)",
+  "figure.button.scale-uniformly": "grow by one ratio",
+  "figure.text.sizing-uniform-proposed": "this figure has joints. growing it by one ratio keeps the joints together at any size.",
+  "figure.text.sizing-uniform-explained": "grows the whole figure by the geometric mean of the three sizes a board gives it. the feet stay on the floor; room left above the figure stays empty.",
   "figure.button.mirror-x": "mirror X",
   "figure.button.mirror-z": "mirror Z",
   "figure.button.move-part-down": "move down",
@@ -24,7 +31,6 @@
   "figure.button.pivot-set": "set",
   "figure.button.pose-as-default": "make this the default pose",
   "figure.button.preview-fix": "preview fix · {part} {axis} face: {from} → {to}",
-  "figure.button.redo": "redo",
   "figure.button.release-figure": "release",
   "figure.button.restore-released-base": "restore the previous model width",
   "figure.button.keep-changed-appearance": "publish with the adjusted width",
@@ -43,6 +49,7 @@
   "figure.label.gizmo-scale": "size",
   "figure.label.gizmo-translate": "move",
   "figure.label.position-worked-out": "moves with the figure size",
+  "figure.label.position-in-proportion": "in proportion to the figure size",
   "figure.label.primitive-rounded-box": "rounded box",
   "figure.text.catalog-needs-a-save": "can be set once the figure is saved.",
   "figure.text.declared-space-declared": "declared from the parts.",
@@ -50,6 +57,9 @@
   "figure.text.fasten-would-loop": "that part is already fastened to this one, so it cannot be fastened the other way.",
   "figure.text.follow-would-loop": "that dimension already follows this part, so the two cannot follow each other.",
   "figure.text.links-need-a-box": "size following works on box-shaped parts, fastening on boxes and cylinders.",
+  "figure.text.scale-position-explained": "keeps this place as a share of the figure size — at twice the size it is twice as far.",
+  "figure.text.repeat-member": "copy {index} of {count} made by repeating {name}.",
+  "figure.text.instance-range-can-widen": "measured again after the parts changed: {ranges} mm.",
   "figure.text.mounting-face-needs-space": "declare the space first to choose one.",
   "figure.text.part-is-referenced": "'{part}' cannot be deleted: another part is fastened to it or follows its size. Undo that link first.",
   "figure.text.part-name-invalid": "'{name}' cannot be a part name. Start with a letter and use letters, digits, - and _.",
@@ -58,7 +68,6 @@
   "figure.text.recommended-fix-explained": "{n} changes rechecked against every resize case. They apply to this draft only; review and save when ready.",
   "figure.text.show-affected-parts": "show affected parts",
   "figure.button.to-floor": "to floor",
-  "figure.button.undo": "undo",
   "figure.label.accepts": "accepts",
   "figure.label.anchor": "anchored face",
   "figure.label.anchor-advanced": "advanced proportional sizing",
@@ -110,11 +119,12 @@
   "figure.label.axis-scale-short": "scale",
   "figure.label.axis-width": "width",
   "figure.label.base-box": "base box (mm)",
-  "figure.label.budget-groups": "material groups",
+  "figure.label.budget-groups": "groups (draw calls)",
   "figure.label.budget-independent": "independently moved parts",
   "figure.label.budget-parts": "part count",
   "figure.label.budget-surface": "surfaces outside the palette",
   "figure.label.budget-transparent": "transparent materials",
+  "figure.label.budget-triangles": "triangles",
   "figure.label.budgets": "budgets",
   "figure.label.by-axis": "maturity by item",
   "figure.label.candidate-review": "candidate review",
@@ -137,6 +147,8 @@
   "figure.label.detail-level": "detail level",
   "figure.label.distinct-materials": "distinct materials",
   "figure.label.distinct-shapes": "distinct shapes",
+  "figure.label.draw-calls": "draw calls",
+  "figure.label.vertex-buffers": "vertex buffers",
   "figure.label.draft": "draft",
   "figure.label.emissive": "emissive",
   "figure.label.emissive-color": "lit color",
@@ -253,6 +265,7 @@
   "figure.label.repeat-count": "count",
   "figure.label.repeat-pitch": "pitch",
   "figure.label.reuse-trend": "reuse trend",
+  "figure.label.instance-count": "instance count",
   "figure.label.role-in-capability": "role in the capability",
   "figure.label.role-port-in": "inbound port",
   "figure.label.role-port-out": "outbound port",
@@ -273,7 +286,6 @@
   "figure.label.shapes": "shapes",
   "figure.label.sizing-fixed": "keeps its size",
   "figure.label.sizing-repeat": "repeats",
-  "figure.label.sizing-rule": "when the size changes",
   "figure.label.sizing-scale": "scales proportionally",
   "figure.label.sizing-stretch": "stretches on one axis",
   "figure.label.sky-color": "sky color",
@@ -308,6 +320,12 @@
   "figure.text.bound-by-triangles": "triangles reach the limit first ({per} per instance, {budget} per drawing).",
   "figure.text.budget-measured-on": "Measured on {gpu}, {on}. A figure standing still costs nothing — only what is on screen and redrawn counts.",
   "figure.text.budget-not-measured-yet": "this target has not been measured yet.",
+  "figure.text.budgets-not-in-v3": "off-palette surfaces and the part-count limit are not in the V3 format, so they are not shown.",
+  "figure.text.trend-chart-title": "drawing cost by instance count",
+  "figure.text.trend-chart-lead": "flat lines stay the same as instances grow. instances of the same size share them.",
+  "figure.text.trend-at-count": "at {n}",
+  "figure.text.trend-stays": "unchanged",
+  "figure.text.trend-flat-lines-overlap": "the flat lines overlap at {value}.",
   "figure.text.cannot-release-now": "cannot be released yet",
   "figure.text.fit-needs-parts": "there are no parts to fit to — add a shape first.",
   "figure.text.nothing-blocks-release": "nothing in the figure as it stands blocks releasing it.",
@@ -362,8 +380,12 @@
   "figure.text.floor-explained": "overlaps the coordinate ground, so it is usually off",
   "figure.text.follow-camera-explained": "turn off to fix the shadow direction",
   "figure.text.grade-decided-by": "what decided the grade",
-  "figure.text.grade-explained": "the grade is set by the usage of the item closest to its limit.",
+  "figure.text.grade-explained": "the grade is the headroom against placing {target} of this figure on one screen. the item closest to its limit decides it.",
   "figure.text.grade-scale-lead": "grade scale (limit used)",
+  "figure.text.grade-target": "target: {target} on one screen — up to {groups} groups · {triangles} triangles each",
+  "figure.text.parts-budget": "{triangles} triangles · {groups} groups · {instances} on one screen",
+  "figure.text.parts-budget-over": "over the {budget} limit — {used} / {limit}",
+  "figure.text.parts-budget-open": "open maturity",
   "figure.text.headroom-percent": "{percent}% headroom",
   "figure.text.hemisphere-light-explained": "even light from sky and ground. it brightens shaded faces.",
   "figure.text.hide-all-parts": "hide all",
@@ -387,6 +409,7 @@
   "figure.text.keys-must-rise": "each key must come after the one before it.",
   "figure.text.limit-comes-from-level": "the detail level sets this limit.",
   "figure.text.maturity-blocked-no-binding": "state display is not measured yet.",
+  "figure.text.maturity-blocked-no-detail-level": "the V3 format has no detail level. the budgets and placement scale above take its place.",
   "figure.text.maturity-blocked-no-parts": "nothing to measure — there are no parts.",
   "figure.text.maturity-consistency-because": "checks texture use, recommended segment counts and the number of materials.",
   "figure.text.maturity-consistency-clean": "no issues",
@@ -501,6 +524,8 @@
   "figure.text.follows-explained": "What this side grows with. Stretch the figure on a board and this follows.",
   "figure.label.follows-nothing": "fixed",
   "figure.label.follows-instance": "instance size",
+  "figure.label.follows-instance-share": "in proportion to size",
+  "figure.label.instance-range": "sizes it can be placed at",
   "figure.label.follows-part": "another part",
   "figure.label.times": "times",
   "figure.label.plus": "plus (mm)",
@@ -579,5 +604,64 @@
   "figure.label.place-accepts": "Takes",
   "figure.label.place-capacity": "How many",
   "figure.text.place-accepts-needed": "Name at least one type it takes, separated by commas.",
-  "figure.button.add-place": "Add place"
+  "figure.button.add-place": "Add place",
+  "figure.label.controls": "Controls",
+  "figure.text.controls-explained": "A board or a connection sets these values to pose the figure. Move a slider to try one.",
+  "figure.text.no-controls": "No controls yet. Adding a motion to a part makes one.",
+  "figure.button.keep-pose": "Keep this pose as the default",
+  "figure.label.control-name": "Name",
+  "figure.text.control-starts-at": "Starts at {value} {unit} when placed on a board.",
+  "figure.label.control-sweep": "Full travel time (s)",
+  "figure.button.whole-figure": "Whole figure",
+  "figure.label.places-on-part": "Places on {part}",
+  "figure.text.choose-a-part-to-move": "Choose a part to set how it moves.",
+  "figure.text.loading-figure": "Loading",
+  "figure.text.no-places": "No places yet. Choose a part and add one here.",
+  "figure.text.opening-model": "Opening the model.",
+  "figure.text.saved": "Saved",
+  "figure.text.clips-explained": "Plays controls over time. Move the bar to see the pose at a moment; make a pose with the control sliders, then add a key at that moment.",
+  "figure.label.clip-duration": "Length (s)",
+  "figure.label.clip-time": "Clip time",
+  "figure.label.clip-loop": "After the end",
+  "figure.label.clip-loop-wrap": "Repeat",
+  "figure.label.clip-loop-hold": "Hold the last value",
+  "figure.button.remove-track": "Stop playing this control",
+  "figure.button.remove-key": "Remove key",
+  "figure.button.add-key-here": "Add a key at {seconds} s ({value})",
+  "figure.label.add-track": "Play a control",
+  "figure.label.clip": "Clip",
+  "figure.label.new-clip": "New clip",
+  "figure.button.add-track": "Add",
+  "figure.text.add-a-shape-to-start": "Add a shape to start modelling.",
+  "figure.label.primitive-frustum": "Cone",
+  "figure.label.primitive-plate": "Plate",
+  "figure.label.field-width": "Width",
+  "figure.label.field-height": "Height",
+  "figure.label.field-depth": "Depth",
+  "figure.label.field-radius": "Radius",
+  "figure.label.field-length": "Length",
+  "figure.label.field-round": "Corner radius",
+  "figure.label.field-left": "Left",
+  "figure.label.field-right": "Right",
+  "figure.label.field-bottom": "Bottom",
+  "figure.label.field-top": "Top",
+  "figure.label.field-openingLeft": "Opening left",
+  "figure.label.field-openingRight": "Opening right",
+  "figure.label.field-openingTop": "Opening top",
+  "figure.label.field-radiusX": "Radius X",
+  "figure.label.field-radiusY": "Radius Y",
+  "figure.label.field-radiusZ": "Radius Z",
+  "figure.label.field-radiusTop": "Top radius",
+  "figure.label.field-radiusBottom": "Bottom radius",
+  "figure.label.group-position": "Position",
+  "figure.label.group-rotation": "Rotation (°)",
+  "figure.label.group-size": "Size",
+  "figure.label.group-placement-size": "Position and size",
+  "figure.label.group-shape": "Shape",
+  "figure.label.group-figure-size": "Figure size",
+  "figure.label.group-part": "Part",
+  "figure.label.group-figure": "Figure",
+  "figure.label.group-standing": "Where it stands",
+  "figure.label.group-catalog": "Catalogue",
+  "figure.button.control-settings": "Name, range and time"
 }