@things-factory/figure-ui 10.1.27 → 10.1.29

package/test/joint-needle.test.ts

@@ -0,0 +1,162 @@
+import assert from 'node:assert/strict'
+import { describe, it } from 'node:test'
+
+import { readFileSync } from 'node:fs'
+import { fileURLToPath } from 'node:url'
+
+import { compile, validate } from '@hatiolab/figure-model'
+import type { FigureSource } from '@hatiolab/figure-model'
+
+import { jointNeedles, NEEDLE } from '../client/modeller/joint-gizmo.ts'
+
+/*
+ * 미리보기에서 관절이 돌았다는 것을 보이게 하는 바늘.
+ *
+ * 이 시험이 지키는 것은 하나다 — **축에서 비켜나 있을 것.** 축 위에 붙으면 대칭인 부품과 같이
+ * 돌면서 같은 그림이 되고, 그러면 바늘을 붙인 뜻이 없어진다. 없는 것보다 나쁘다: 화면에 무엇이
+ * 하나 더 생겼는데 여전히 아무것도 안 움직인다.
+ */
+
+const source = (over: Partial<FigureSource> = {}): FigureSource => ({
+  version: 2,
+  type: 'ARM',
+  base: { x: 400, y: 1200, z: 400 },
+  placement: 'floor',
+  detailLevel: 'M',
+  parts: [
+    {
+      name: 'post',
+      primitive: 'cylinder',
+      transform: { position: { x: 0, y: 100, z: 0 }, size: { x: 200, y: 200, z: 200 } },
+      material: { token: 'palette.dark' }
+    },
+    {
+      name: 'arm',
+      primitive: 'cylinder',
+      transform: { position: { x: 0, y: 400, z: 0 }, size: { x: 120, y: 400, z: 120 } },
+      material: { token: 'palette.primary' },
+      parent: 'post'
+    }
+  ],
+  joints: [
+    {
+      name: 'turn',
+      child: 'arm',
+      type: 'revolute',
+      origin: { x: 0, y: 200, z: 0 },
+      axis: { x: 0, y: 1, z: 0 },
+      limits: { min: -90, max: 90 }
+    }
+  ],
+  ...over
+})
+
+describe('관절 바늘', () => {
+  it('관절이 모는 부품에 자식으로 붙는다 — 그래야 관절이 도는 만큼 같이 돈다', () => {
+    const [needle] = jointNeedles(source())
+
+    assert.equal(needle!.parent, 'arm')
+    assert.equal(needle!.name, `${NEEDLE}turn`)
+  })
+
+  it('축에서 비켜나 선다 — 축 위에 있으면 대칭인 부품과 같은 그림이다', () => {
+    const [needle] = jointNeedles(source())
+    const { position, size } = needle!.transform
+
+    /* y 축으로 도는 관절: 바늘은 x 로 비켜나고 x 로 길다. */
+    assert.ok(position.x > 0, '축에서 비켜났다')
+    assert.equal(position.y, 200, '기준점 높이 그대로')
+    assert.ok(size.x > size.y && size.x > size.z, 'x 로 길다')
+  })
+
+  it('가로축으로 도는 관절은 z 로 비켜난다', () => {
+    const [needle] = jointNeedles(source({ joints: [{ ...source().joints![0]!, axis: { x: 1, y: 0, z: 0 } }] }))
+    const { position, size } = needle!.transform
+
+    assert.ok(position.z > 0)
+    assert.ok(size.z > size.x && size.z > size.y)
+  })
+
+  it('세로축(z)으로 도는 관절은 x 로 비켜난다', () => {
+    const [needle] = jointNeedles(source({ joints: [{ ...source().joints![0]!, axis: { x: 0, y: 0, z: 1 } }] }))
+    assert.ok(needle!.transform.position.x > 0)
+  })
+
+  it('비스듬한 축은 그리지 않는다 — 비켜날 쪽을 못 고른다', () => {
+    const oblique = source({ joints: [{ ...source().joints![0]!, axis: { x: 1, y: 1, z: 0 } }] })
+    assert.deepEqual(jointNeedles(oblique), [])
+  })
+
+  it('길이는 도는 부품에서 온다. 작은 부품에서도 보일 만큼은 된다', () => {
+    const [big] = jointNeedles(source())
+    assert.equal(big!.transform.size.x, Math.round(400 * 0.6))
+
+    const small = source({
+      parts: source().parts.map(part =>
+        part.name === 'arm'
+          ? { ...part, transform: { ...part.transform, size: { x: 10, y: 10, z: 10 } } }
+          : part
+      )
+    })
+    assert.equal(jointNeedles(small)[0]!.transform.size.x, 60)
+  })
+
+  it('굵기는 길이에 견준다 — 8mm 로 고정했더니 미리보기에서 한 픽셀이 안 됐다', () => {
+    const [needle] = jointNeedles(source())
+    const { size } = needle!.transform
+
+    /* 길이 240 짜리 막대는 48 로 두껍다. 부품이 작아도 6 밑으로는 안 내려간다. */
+    assert.equal(size.y, Math.round(size.x / 5))
+    assert.equal(size.z, size.y)
+
+    const small = source({
+      parts: source().parts.map(part =>
+        part.name === 'arm' ? { ...part, transform: { ...part.transform, size: { x: 10, y: 10, z: 10 } } } : part
+      )
+    })
+    assert.equal(jointNeedles(small)[0]!.transform.size.y, Math.max(6, Math.round(60 / 5)))
+  })
+
+  it('관절이 없으면 바늘도 없다', () => {
+    assert.deepEqual(jointNeedles(source({ joints: [] })), [])
+    assert.deepEqual(jointNeedles(source({ joints: undefined })), [])
+  })
+
+  it('바늘을 붙인 형식이 그대로 선다 — 미리보기가 이것을 compile 한다', () => {
+    const shown: FigureSource = { ...source(), parts: [...source().parts, ...jointNeedles(source())] }
+
+    assert.deepEqual(validate(shown).errors, [])
+    assert.doesNotThrow(() => compile(shown))
+  })
+})
+
+/*
+ * 바늘은 **미리보기에만** 있다. 저장 형식으로 새어 나가면 발행된 도형에 없던 막대가 생기고,
+ * 계약 판정에서는 부품이 하나 늘어난 것으로 읽힌다.
+ */
+describe('바늘이 미리보기 밖으로 안 나간다', () => {
+  const read = (path: string) => readFileSync(fileURLToPath(new URL(path, import.meta.url)), 'utf8')
+
+  it('미리보기가 붙여서 세운다', () => {
+    const preview = read('../client/modeller/figure-preview.ts')
+
+    assert.ok(/jointNeedles\(source\)/.test(preview), '붙인다')
+    assert.ok(/registerFigure\(compile\(shown\)/.test(preview), '붙인 것을 세운다')
+  })
+
+  it('저작면과 저장은 원본 그대로다', () => {
+    const page = read('../client/pages/figure-modeller-page.ts')
+    const canvas = read('../client/modeller/figure-canvas.ts')
+
+    assert.ok(!/jointNeedles/.test(page), '페이지는 바늘을 모른다')
+    assert.ok(!/jointNeedles/.test(canvas), '저작 캔버스는 바늘을 모른다')
+  })
+
+  it('원본 목록을 건드리지 않는다 — 같은 배열에 밀어 넣으면 저장에 들어간다', () => {
+    const original = source()
+    const before = original.parts.length
+    jointNeedles(original)
+
+    assert.equal(original.parts.length, before)
+  })
+})

package/test/part-edits.test.ts

@@ -1,5 +1,7 @@
 import assert from 'node:assert/strict'
 import { describe, it, test } from 'node:test'
+import { readFileSync } from 'node:fs'
+import { fileURLToPath } from 'node:url'
 
 import { expect } from './expect.ts'
 
@@ -17,6 +19,7 @@ import {
   niceStep,
   partLimit,
   removePart,
+  roundPart,
   snapPart,
   updatePart
 } from '../client/modeller/part-edits.ts'
@@ -55,6 +58,53 @@ const DECK: PartModel = {
   token: 'palette.primary'
 }
 
+/*
+ * 기즈모에서 온 숫자.
+ *
+ * 화면에서 끌면 씬이 비율을 곱한 값을 돌려준다. 그 값이 그대로 부품에 들어가면 저장 형식에
+ * 소수 넷째 자리가 남고, 크기 칸은 잘려서 보인다.
+ */
+describe('씬에서 온 부품을 밀리미터로 맞춘다', () => {
+  const part = (over: Partial<PartModel> = {}): PartModel => ({ ...DECK, ...over })
+
+  it('끈 크기와 자리를 정수로 맞춘다', () => {
+    const dragged = part({ left: 384.99999999999994, top: 380, zPos: 930, width: 368.98743869823886, height: 140, depth: 722.4180046035418 })
+    const fixed = roundPart(dragged)
+
+    expect(fixed.left).toBe(385)
+    expect(fixed.width).toBe(369)
+    expect(fixed.depth).toBe(722)
+    expect(fixed.top).toBe(380)
+  })
+
+  it('크기는 1 밑으로 안 내려간다 — 0 이면 부피가 사라지고 배율이 0 으로 나뉜다', () => {
+    const tiny = roundPart(part({ width: 0.2, height: 0.4, depth: 0 }))
+    expect(tiny.width).toBe(1)
+    expect(tiny.height).toBe(1)
+    expect(tiny.depth).toBe(1)
+  })
+
+  it('맞춘 값을 다시 맞춰도 같다', () => {
+    const once = roundPart(part({ left: 12.5, width: 7.5 }))
+    expect(roundPart(once)).toEqual(once)
+  })
+
+  it('캔버스가 씬의 변경을 받을 때 그것을 지난다 — 안 부르면 위 넷이 전부 초록인 채로 소수가 남는다', () => {
+    const canvas = readFileSync(fileURLToPath(new URL('../client/modeller/figure-canvas.ts', import.meta.url)), 'utf8')
+
+    assert.ok(/roundPart/.test(canvas), 'import')
+    assert.ok(/this\.tell\('part-changed', \{ name, part: roundPart\(/.test(canvas), '올려 보내기 전에 맞춘다')
+  })
+
+  it('크기·자리 밖의 값은 건드리지 않는다', () => {
+    const kept = roundPart(part({ name: 'arm', token: 'palette.dark', segments: 12, zPos: 3.4 }))
+    expect(kept.name).toBe('arm')
+    expect(kept.token).toBe('palette.dark')
+    expect(kept.segments).toBe(12)
+    expect(kept.zPos).toBe(3)
+  })
+})
+
 describe('부품 생성', () => {
   it('기준 상자의 3분의 1 크기로 생성된다 — 추가하자마자 보여야 한다', () => {
     const part = newPart(DRAFT, [], 'cube')
@@ -98,6 +148,56 @@ describe('부품 생성', () => {
     expect(newPart(DRAFT, [], 'polygon').path).toHaveLength(3)
   })
 
+  /*
+   * 둘째 부품이 어디에 서는가.
+   *
+   * 언제나 바닥 한가운데였을 때, 둘째 부품은 첫 부품 **속에** 들어갔다 — 같은 자리에 같은
+   * 크기라 화면에는 덩어리 하나뿐이고 저작자는 무엇이 늘었는지 못 봤다.
+   */
+  describe('고른 부품 위에 얹는다', () => {
+    /* 갑판을 바닥에 내려 둔다 — 그 위에 3분의 1 짜리가 들어가야 얹는 갈래를 볼 수 있다. */
+    const FLOOR_DECK = { ...DECK, zPos: 0 }
+
+    it('윗면에 서고 발자국이 가운데로 맞는다', () => {
+      const part = newPart(DRAFT, [FLOOR_DECK], 'cube', FLOOR_DECK)
+
+      expect(part.zPos).toBe(FLOOR_DECK.zPos + FLOOR_DECK.depth)
+      // 자리도 크기도 정수로 맞추므로 0.5 까지는 어긋난다
+      const middle = { x: FLOOR_DECK.left + FLOOR_DECK.width / 2, y: FLOOR_DECK.top + FLOOR_DECK.height / 2 }
+      expect(Math.abs(part.left + part.width / 2 - middle.x)).toBeLessThanOrEqual(0.5)
+      expect(Math.abs(part.top + part.height / 2 - middle.y)).toBeLessThanOrEqual(0.5)
+    })
+
+    it('얹으면 상자를 넘을 때는 바닥 한가운데로 간다 — 추가가 발행을 막지 않는다', () => {
+      /* 갑판이 이미 높다: 500 + 200 위에 267 을 더 쌓으면 상자 높이 800 을 넘는다. */
+      const part = newPart(DRAFT, [DECK], 'cube', DECK)
+
+      expect(part.zPos).toBe(0)
+      expect(Math.abs(part.left + part.width / 2 - DRAFT.width / 2)).toBeLessThanOrEqual(0.5)
+    })
+
+    it('가장자리 부품 위에서도 상자 안에 남는다', () => {
+      const corner = { ...DECK, left: 0, top: 0, width: 200, height: 200, zPos: 0, depth: 100 }
+      const part = newPart(DRAFT, [corner], 'cube', corner)
+
+      expect(part.left).toBe(0)
+      expect(part.top).toBe(0)
+      expect(part.left + part.width).toBeLessThanOrEqual(DRAFT.width)
+      expect(part.top + part.height).toBeLessThanOrEqual(DRAFT.height)
+    })
+
+    it('고른 것이 없으면 전과 같이 바닥 한가운데다', () => {
+      const alone = newPart(DRAFT, [DECK], 'cube')
+      expect(alone.zPos).toBe(0)
+      expect(Math.abs(alone.left + alone.width / 2 - DRAFT.width / 2)).toBeLessThanOrEqual(0.5)
+    })
+
+    it('쌓은 둘이 서로 겹치지 않는다 — 이 규칙이 지키는 것이 그것이다', () => {
+      const [, stacked] = addPart(DRAFT, [FLOOR_DECK], 'cylinder', FLOOR_DECK)
+      expect(stacked!.zPos).toBeGreaterThanOrEqual(FLOOR_DECK.zPos + FLOOR_DECK.depth)
+    })
+  })
+
   /*
     화면에서 멀쩡해 보여도 저장이 거부되면 사용자는 이유를 알 수 없다. 새로 만든 부품은
     손대지 않은 상태로도 검증을 통과해야 한다.

package/test/pose-defaults.test.ts

@@ -0,0 +1,71 @@
+import assert from 'node:assert/strict'
+import { describe, it } from 'node:test'
+
+import { poseAsDefaults, poseChanges } from '../client/modeller/pose-defaults.ts'
+import type { FigureDraft } from '../client/modeller/figure-source.ts'
+
+/*
+ * 미리보기에서 세운 자세를 기본값으로 앉힌다.
+ *
+ * 관절 도형의 휴지 자세(값 0)는 곧게 선 기둥이라, 기본값이 없으면 목록에서도 도면에서도 그
+ * 모양으로 선다. 옮겨 적는 일을 손으로 하면 여섯 축에 여섯 번이고, 옮기는 사이 화면의 자세와
+ * 적은 수가 갈린다.
+ */
+
+const DRAFT: FigureDraft = {
+  version: 2,
+  figureType: 'ARM',
+  width: 900,
+  height: 900,
+  depth: 1900,
+  detailLevel: 'L',
+  parameters: [
+    { name: 'shoulder', range: { unit: 'deg', min: -120, max: 120 }, default: 0, clip: { channels: [] } },
+    { name: 'elbow', range: { unit: 'deg', min: -150, max: 150 }, default: 0, clip: { channels: [] } },
+    /* 기본값을 안 적은 파라미터. 형식은 그때 범위의 처음에 선다. */
+    { name: 'hoist', range: { unit: 'mm', min: 0, max: 1800 }, clip: { channels: [] } }
+  ]
+}
+
+describe('이 자세를 기본으로', () => {
+  it('민 것만 앉히고 나머지는 건드리지 않는다', () => {
+    const next = poseAsDefaults(DRAFT, { shoulder: -35 })
+
+    assert.equal(next.parameters![0]!.default, -35)
+    assert.equal(next.parameters![1], DRAFT.parameters![1], '안 민 파라미터는 같은 객체 그대로다')
+    assert.equal(next.parameters![2], DRAFT.parameters![2])
+  })
+
+  it('이미 그 값이면 초안을 그대로 돌려준다 — 고친 것이 없는데 「저장 안 됨」이 붙지 않게', () => {
+    assert.equal(poseAsDefaults(DRAFT, { shoulder: 0 }), DRAFT)
+    assert.equal(poseAsDefaults(DRAFT, {}), DRAFT)
+    /* 기본값을 안 적은 파라미터는 범위의 처음에 서 있다. 그 값을 다시 적지 않는다. */
+    assert.equal(poseAsDefaults(DRAFT, { hoist: 0 }), DRAFT)
+  })
+
+  it('기본값을 안 적었던 파라미터에도 앉는다', () => {
+    const next = poseAsDefaults(DRAFT, { hoist: 1200 })
+    assert.equal(next.parameters![2]!.default, 1200)
+  })
+
+  it('범위 밖은 끝에서 문다 — 다른 길로 들어온 값도 형식을 지나야 한다', () => {
+    const next = poseAsDefaults(DRAFT, { elbow: 400 })
+    assert.equal(next.parameters![1]!.default, 150)
+  })
+
+  it('수가 아닌 값은 안 말한 것으로 친다', () => {
+    for (const bad of [NaN, Infinity, undefined as unknown as number]) {
+      assert.equal(poseAsDefaults(DRAFT, { shoulder: bad }), DRAFT, String(bad))
+    }
+  })
+
+  it('무엇이 달라지는지 먼저 말할 수 있다 — 단추를 띄울지 이것으로 정한다', () => {
+    assert.deepEqual(poseChanges(DRAFT, { shoulder: -35, elbow: 0 }), [{ name: 'shoulder', from: 0, to: -35 }])
+    assert.deepEqual(poseChanges(DRAFT, { shoulder: 0 }), [])
+    assert.deepEqual(poseChanges(undefined, { shoulder: -35 }), [])
+  })
+
+  it('없는 파라미터 이름은 무시한다 — 후보를 보다 남은 값이 섞여도 초안을 늘리지 않는다', () => {
+    assert.equal(poseAsDefaults(DRAFT, { 'no-such-thing': 42 }), DRAFT)
+  })
+})

package/test/scene-budget.test.ts

@@ -0,0 +1,82 @@
+import assert from 'node:assert/strict'
+import { describe, it } from 'node:test'
+
+import { readFileSync } from 'node:fs'
+import { join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+import { capacityFrom, MEASURED, SCENE_BUDGET } from '../client/modeller/scene-budget.ts'
+
+/*
+ * 「몇 개까지 편한가」의 분모.
+ *
+ * 이 수는 **잰 값이다**(2026-09-18, Apple M5). 시험이 지키는 것은 셈이 아니라 그 사실이다 —
+ * 분모가 조용히 목표치로 돌아가거나, 잰 기계와 날짜가 화면에서 빠지면 사람이 어디서나 참인
+ * 수로 읽는다.
+ */
+
+describe('한 화면이 감당하는 양', () => {
+  it('분모는 화면에 보이는 부품 묶음이고, 잰 기계와 날짜를 달고 있다', () => {
+    assert.equal(SCENE_BUDGET.groupsOnScreen, 4000)
+    assert.equal(MEASURED.gpu, 'Apple M5')
+    assert.equal(MEASURED.on, '2026-09-18')
+    assert.equal(MEASURED.fps, 60)
+  })
+
+  it('묶음으로 갈리면 묶음 수로 나눈다 — 그림자를 다시 곱하지 않는다', () => {
+    /*
+      실측이 그림자를 켠 채 잰 값이라 배수가 이미 안에 있다. 전에는 여기서 2 를 곱했고,
+      그 곱을 남겨 두면 같은 값을 두 번 세어 개수가 절반으로 나온다.
+    */
+    const robot = capacityFrom(9, 200)!
+    assert.equal(robot.bound, 'groups')
+    assert.equal(robot.per, 9)
+    assert.equal(robot.instances, Math.floor(4000 / 9))
+  })
+
+  it('삼각형이 먼저 차면 그쪽으로 갈린다', () => {
+    const heavy = capacityFrom(2, 100_000)!
+    assert.equal(heavy.bound, 'triangles')
+    assert.equal(heavy.instances, 5)
+  })
+
+  it('잴 것이 없으면 답하지 않는다 — 「무한히 놓을 수 있다」가 아니다', () => {
+    assert.equal(capacityFrom(0, 0), undefined)
+  })
+
+  /*
+    실측한 두 도형이 이 분모로 되돌아오는지 본다. 분모를 누가 고치면 이 둘이 먼저 어긋난다.
+  */
+  it('잰 두 도형이 잰 수와 맞다', () => {
+    /* 묶음 9 짜리 6 축 로봇: 600 대에서 59.5fps, 700 대에서 56.7fps 였다. */
+    assert.ok(capacityFrom(9, 200)!.instances <= 600, '잰 값보다 많이 놓으라고 하면 안 된다')
+    /* 묶음 2 짜리 컨베이어: 1,600 대에서 59.3fps, 2,500 대에서 36.8fps 였다. */
+    const conveyor = capacityFrom(2, 100)!
+    assert.ok(conveyor.instances >= 1600 && conveyor.instances <= 2500)
+  })
+})
+
+/*
+ * 놓는 개수로 값을 말하지 않는다 — ADR-0051 ③.
+ *
+ * 보고서에 「100개 기준 draw call」 · 「1만개 기준」이 오래 남아 있었다. 놓는 개수는 값을 치르지
+ * 않는다(가만히 선 도형은 프레임 비용 0, 카메라 밖은 컬링). 치르는 것은 한 화면에 보이는 개수 ×
+ * 그 도형의 묶음 수이고, 그 답은 위의 실측 분모가 한다.
+ */
+describe('놓는 개수 기준 문구가 화면에 없다', () => {
+  const HERE = fileURLToPath(new URL('.', import.meta.url))
+
+  it('보고서가 「N개 기준」 칸을 그리지 않는다', () => {
+    const report = readFileSync(join(HERE, '../client/modeller/figure-report.ts'), 'utf8')
+
+    assert.ok(!/at-100|at-10k/.test(report), '개수 기준 칸')
+    assert.ok(!/costOf\(blueprint, \d/.test(report), '개수를 넣어 셈하지 않는다')
+  })
+
+  it('번역에 그 낱말이 남아 있지 않다', () => {
+    const ko = JSON.parse(readFileSync(join(HERE, '../translations/ko.json'), 'utf8')) as Record<string, string>
+    const left = Object.entries(ko).filter(([key]) => /at-100|at-10k/.test(key))
+
+    assert.deepEqual(left, [])
+  })
+})

package/translations/en.json

@@ -12,6 +12,7 @@
   "figure.button.delete-figure": "delete",
   "figure.button.discard": "discard",
   "figure.button.duplicate-part": "duplicate",
+  "figure.button.fit-base-to-parts": "fit to parts",
   "figure.button.mirror-x": "mirror X",
   "figure.button.mirror-z": "mirror Z",
   "figure.button.move-part-down": "move down",
@@ -19,6 +20,7 @@
   "figure.button.new-figure": "new figure",
   "figure.button.pivot-clear": "part centre",
   "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",
@@ -82,8 +84,9 @@
   "figure.label.axis-scale": "scale",
   "figure.label.axis-scale-short": "scale",
   "figure.label.axis-width": "width",
-  "figure.label.budget-animations": "moving parts",
+  "figure.label.base-box": "base box (mm)",
   "figure.label.budget-groups": "material groups",
+  "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",
@@ -110,8 +113,6 @@
   "figure.label.distinct-materials": "distinct materials",
   "figure.label.distinct-shapes": "distinct shapes",
   "figure.label.draft": "draft",
-  "figure.label.draw-calls-at-100": "draw calls for 100",
-  "figure.label.draw-calls-at-10k": "draw calls at 10k instances",
   "figure.label.emissive": "emissive",
   "figure.label.emissive-color": "lit color",
   "figure.label.environment": "environment",
@@ -260,8 +261,8 @@
   "figure.label.tools": "align",
   "figure.label.transparent": "transparent",
   "figure.label.triangles": "triangles",
-  "figure.label.triangles-at-100": "triangles for 100",
-  "figure.label.triangles-at-10k": "triangles at 10k instances",
+  "figure.label.unit-none": "no unit",
+  "figure.label.unit-type-it": "type it…",
   "figure.label.weight": "drawing cost",
   "figure.label.what-this-does": "what this figure does",
   "figure.text.accepts-anything": "empty means anything",
@@ -271,15 +272,15 @@
   "figure.text.already-released-edit-to-release-again": "already released. edit and save to go back to draft, then release again.",
   "figure.text.anchor-explained": "where this part stays as the box grows. two touching parts on different faces drift apart as it grows.",
   "figure.text.anchors-are-not-drawn": "slots and ports are not drawn on a drawing; only the editor shows them.",
-  "figure.text.animated-parts-cost": "each moving part adds one draw call.",
-  "figure.text.animated-parts-over": "over the limit. many of these on one drawing will slow it down.",
   "figure.text.animation-empty-examples": "a turning roller · a sliding door leaf · a rising lift · a blinking beacon.",
   "figure.text.animation-empty-what-it-is": "no motion yet. add a clip to move parts.",
   "figure.text.animation-needs-a-named-part": "add a part first.",
   "figure.text.assistant-proposed-a-figure": "the proposal is shown on the right.",
   "figure.text.axes-not-measurable-yet": "left off the chart because they cannot be measured: {axes}. the reasons are below.",
-  "figure.text.bound-by-drawCalls": "draw calls reach the limit first ({per} per instance, {budget} per drawing).",
+  "figure.text.base-box-explained": "The box that sets the scale when the figure is placed on a drawing. A part reaching outside it blocks release. Changing the size leaves the parts where they are.",
+  "figure.text.bound-by-groups": "Part groups fill up first — this figure is {per} groups, and one screen draws {budget} groups at 60fps.",
   "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.cannot-release-now": "cannot be released yet",
   "figure.text.canvas-appears-once-a-part-exists": "pick a shape on the left to add the first part.",
@@ -296,6 +297,7 @@
   "figure.text.change-capabilities": "capabilities",
   "figure.text.change-changed": "a changed part",
   "figure.text.change-detail": "the detail level",
+  "figure.text.change-joints": "joints",
   "figure.text.change-placement": "placement",
   "figure.text.change-removed": "a part being removed",
   "figure.text.change-styleKit": "the style kit",
@@ -307,6 +309,7 @@
   "figure.text.clip-needs-a-name": "enter a name.",
   "figure.text.collapse-parts-pane": "collapse the part list",
   "figure.text.collapse-properties-pane": "collapse the property pane",
+  "figure.text.contract-not-compared": "Could not check whether this change breaks what is already placed — {why}",
   "figure.text.coordinate-ground-explained": "draws the origin and a grid on the floor",
   "figure.text.delete-figure-confirm": "delete {name}? drawings already using this type will no longer find it.",
   "figure.text.designate-in-properties": "nothing designated yet. select a part and set its role in the properties tab.",
@@ -323,6 +326,7 @@
   "figure.text.figure-type-example": "e.g. OHT, AGV_LIFTER",
   "figure.text.figure-type-placeholder": "Figure type identifier (e.g. OHT)",
   "figure.text.find-by-this-tag": "find by this tag",
+  "figure.text.fit-base-explained": "Shrinks the box to the smallest one holding every part. The centre stays put, so a part sitting off-centre leaves room on the other side.",
   "figure.text.fits-n-instances": "up to {n}",
   "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",
@@ -333,7 +337,9 @@
   "figure.text.hemisphere-light-explained": "even light from sky and ground. it brightens shaded faces.",
   "figure.text.hide-all-parts": "hide all",
   "figure.text.hide-this-part": "hide this part while you work. not saved",
-  "figure.text.how-many-fit": "how many fit on one drawing without slowing it down",
+  "figure.text.how-many-fit": "how many can be on screen before it slows down",
+  "figure.text.independent-parts-cost": "each part that carries its own transform adds one draw call.",
+  "figure.text.independent-parts-over": "over the limit. fewer of these fit on one screen at once.",
   "figure.text.instances-unit": "instances",
   "figure.text.interpolation-explained": "how the gap between keys is filled.",
   "figure.text.joint-channel-value-deg": "key values are joint angles in degrees.",
@@ -392,6 +398,7 @@
   "figure.text.picked-changes-do-not-validate": "the selected changes do not make a valid figure",
   "figure.text.pivot-defaults-to-the-part-centre": "left unset, the part turns about its own centre. coordinates are local to the part.",
   "figure.text.placement-explained": "sets the anchor plane in 3D scene (floor: AGV/conveyor, ceiling: OHT/hoist, center: sensor/drone).",
+  "figure.text.pose-as-default-explained": "Writes the pose you have set as the parameters’ defaults, so the figure stands like this when nobody gives it a value.",
   "figure.text.preview-blocked-by-errors": "cannot show the preview because of format errors. see the maturity tab for the reason.",
   "figure.text.preview-needs-a-part": "add a part to see how it looks placed on a drawing.",
   "figure.text.proposal-feedback-note": "optional note for the next suggestion (this session only)",

package/translations/ja.json

@@ -12,6 +12,7 @@
   "figure.button.delete-figure": "delete",
   "figure.button.discard": "discard",
   "figure.button.duplicate-part": "duplicate",
+  "figure.button.fit-base-to-parts": "部品に合わせる",
   "figure.button.mirror-x": "mirror X",
   "figure.button.mirror-z": "mirror Z",
   "figure.button.move-part-down": "move down",
@@ -19,6 +20,7 @@
   "figure.button.new-figure": "new figure",
   "figure.button.pivot-clear": "部品の中心",
   "figure.button.pivot-set": "設定",
+  "figure.button.pose-as-default": "この姿勢を既定に",
   "figure.button.preview-fix": "修正案をプレビュー · {part} {axis} 固定面: {from} → {to}",
   "figure.button.redo": "やり直す",
   "figure.button.release-figure": "公開する",
@@ -82,8 +84,9 @@
   "figure.label.axis-scale": "scale",
   "figure.label.axis-scale-short": "scale",
   "figure.label.axis-width": "width",
-  "figure.label.budget-animations": "animation points",
+  "figure.label.base-box": "基準ボックス (mm)",
   "figure.label.budget-groups": "material groups",
+  "figure.label.budget-independent": "個別に動く部品",
   "figure.label.budget-parts": "part count",
   "figure.label.budget-surface": "surfaces outside the palette",
   "figure.label.budget-transparent": "transparent materials",
@@ -110,8 +113,6 @@
   "figure.label.distinct-materials": "distinct materials",
   "figure.label.distinct-shapes": "distinct shapes",
   "figure.label.draft": "下書き",
-  "figure.label.draw-calls-at-100": "draw calls for 100",
-  "figure.label.draw-calls-at-10k": "draw calls at 10k instances",
   "figure.label.emissive": "emissive",
   "figure.label.emissive-color": "lit color",
   "figure.label.environment": "environment",
@@ -260,8 +261,8 @@
   "figure.label.tools": "align",
   "figure.label.transparent": "transparent",
   "figure.label.triangles": "triangles",
-  "figure.label.triangles-at-100": "triangles for 100",
-  "figure.label.triangles-at-10k": "triangles at 10k instances",
+  "figure.label.unit-none": "単位なし",
+  "figure.label.unit-type-it": "直接入力…",
   "figure.label.weight": "weight",
   "figure.label.what-this-does": "この Figure の役割",
   "figure.text.accepts-anything": "空欄なら何でも可",
@@ -271,15 +272,15 @@
   "figure.text.already-released-edit-to-release-again": "すでに公開済みです。修正して保存すると下書きに戻り、そこで再び公開できます。",
   "figure.text.anchor-explained": "ボックスが伸びるときにこの部品が付いている面です。接する部品と違う面に付くと、伸びたときに間が空きます。",
   "figure.text.anchors-are-not-drawn": "スロットとポートは図面には描かれず、編集画面にだけ表示されます。",
-  "figure.text.animated-parts-cost": "動く部品ごとに draw call が 1 増えます。",
-  "figure.text.animated-parts-over": "上限を超えました。1 つの図面に多く置くと画面が遅くなります。",
   "figure.text.animation-empty-examples": "回るローラー · スライドする扉 · 上下するリフト · 点滅する表示灯。",
   "figure.text.animation-empty-what-it-is": "まだ動きがありません。clip を追加して部品を動かしてください。",
   "figure.text.animation-needs-a-named-part": "先に部品を追加してください。",
   "figure.text.assistant-proposed-a-figure": "提案を右側に表示しました。",
   "figure.text.axes-not-measurable-yet": "測定できない項目はチャートから外しました: {axes}。理由は下にあります。",
-  "figure.text.bound-by-drawCalls": "draw call が先に上限に達します (1 個あたり {per}、図面あたり {budget})。",
+  "figure.text.base-box-explained": "図面に置くときの倍率を決めるボックスです。部品がこのボックスを越えると発行できません。サイズを変えても部品はその場に残ります。",
+  "figure.text.bound-by-groups": "部品グループが先に埋まります — この図形は {per} グループで、1 画面は {budget} グループまで 60fps で描きます。",
   "figure.text.bound-by-triangles": "三角形が先に上限に達します (1 個あたり {per}、図面あたり {budget})。",
+  "figure.text.budget-measured-on": "{gpu} で {on} に測定した値です。静止している図形は負荷になりません — 画面に見えて再描画されるものだけを数えます。",
   "figure.text.budget-not-measured-yet": "this target has not been measured yet.",
   "figure.text.cannot-release-now": "今は公開できません",
   "figure.text.canvas-appears-once-a-part-exists": "左の「図形」から 1 つ選んで最初の部品を追加してください。",
@@ -296,6 +297,7 @@
   "figure.text.change-capabilities": "能力",
   "figure.text.change-changed": "a changed part",
   "figure.text.change-detail": "the detail level",
+  "figure.text.change-joints": "関節",
   "figure.text.change-placement": "配置基準",
   "figure.text.change-removed": "a part being removed",
   "figure.text.change-styleKit": "the style kit",
@@ -307,6 +309,7 @@
   "figure.text.clip-needs-a-name": "名前を入力してください。",
   "figure.text.collapse-parts-pane": "collapse the part list",
   "figure.text.collapse-properties-pane": "collapse the property pane",
+  "figure.text.contract-not-compared": "この修正がすでに配置されたものを壊すか確認できませんでした — {why}",
   "figure.text.coordinate-ground-explained": "原点と目盛りを床に表示します",
   "figure.text.delete-figure-confirm": "delete {name}? drawings already using this type will no longer find it.",
   "figure.text.designate-in-properties": "まだ指定された部品がありません。部品を選び、プロパティタブで「能力での役割」を指定してください。",
@@ -323,6 +326,7 @@
   "figure.text.figure-type-example": "例: OHT, AGV_LIFTER",
   "figure.text.figure-type-placeholder": "Figure 識別タイプ (例: OHT)",
   "figure.text.find-by-this-tag": "find by this tag",
+  "figure.text.fit-base-explained": "すべての部品を包む最小のボックスに変えます。中心はそのままなので、偏った部品があると反対側に余裕が残ります。",
   "figure.text.fits-n-instances": "up to {n}",
   "figure.text.floor-explained": "座標の下地と重なるため、通常はオフにします",
   "figure.text.follow-camera-explained": "オフにすると影の向きが固定されます",
@@ -333,7 +337,9 @@
   "figure.text.hemisphere-light-explained": "空と床から均一に照らす光です。陰になった面を明るくします。",
   "figure.text.hide-all-parts": "hide all",
   "figure.text.hide-this-part": "hide this part while you work. not saved",
-  "figure.text.how-many-fit": "1 つの図面に画面が遅くならずに置ける数",
+  "figure.text.how-many-fit": "画面に出しても遅くならない数",
+  "figure.text.independent-parts-cost": "個別に動く部品ごとに draw call が 1 増えます。",
+  "figure.text.independent-parts-over": "上限を超えました。1 つの画面に一緒に置ける台数がその分減ります。",
   "figure.text.instances-unit": "instances",
   "figure.text.interpolation-explained": "キーの間をどうつなぐか。",
   "figure.text.joint-channel-value-deg": "キーの値は関節の角度 (度) です。",
@@ -392,6 +398,7 @@
   "figure.text.picked-changes-do-not-validate": "the selected changes do not make a valid figure",
   "figure.text.pivot-defaults-to-the-part-centre": "未設定なら部品の中心で回転します。座標は部品基準です。",
   "figure.text.placement-explained": "3D シーンでの基準面を決めます (床: AGV/コンベヤ、天井: OHT/ホイスト、中心: センサー/ドローン)。",
+  "figure.text.pose-as-default-explained": "今の姿勢をパラメータの既定値として書き込みます。値が与えられないとき、この姿勢で立ちます。",
   "figure.text.preview-blocked-by-errors": "形式エラーのためプレビューを表示できません。成熟度タブで理由を確認してください。",
   "figure.text.preview-needs-a-part": "部品を追加すると、図面に置いたときの姿が表示されます。",
   "figure.text.proposal-feedback-note": "次の提案に反映するメモ (このセッションのみ)",