@things-factory/figure-ui 10.1.28 → 10.1.31

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/scene-budget.test.ts

@@ -1,6 +1,10 @@
 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'
 
 /*
@@ -51,3 +55,28 @@ describe('한 화면이 감당하는 양', () => {
     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

@@ -85,8 +85,8 @@
   "figure.label.axis-scale-short": "scale",
   "figure.label.axis-width": "width",
   "figure.label.base-box": "base box (mm)",
-  "figure.label.budget-animations": "moving parts",
   "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",
@@ -113,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",
@@ -263,8 +261,6 @@
   "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",
@@ -276,8 +272,6 @@
   "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.",
@@ -344,6 +338,8 @@
   "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 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.",

package/translations/ja.json

@@ -85,8 +85,8 @@
   "figure.label.axis-scale-short": "scale",
   "figure.label.axis-width": "width",
   "figure.label.base-box": "基準ボックス (mm)",
-  "figure.label.budget-animations": "animation points",
   "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",
@@ -113,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",
@@ -263,8 +261,6 @@
   "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",
@@ -276,8 +272,6 @@
   "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": "先に部品を追加してください。",
@@ -344,6 +338,8 @@
   "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": "画面に出しても遅くならない数",
+  "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": "キーの値は関節の角度 (度) です。",

package/translations/ko.json

@@ -85,8 +85,8 @@
   "figure.label.axis-scale-short": "규모",
   "figure.label.axis-width": "가로",
   "figure.label.base-box": "기준 상자 (mm)",
-  "figure.label.budget-animations": "움직이는 부품",
   "figure.label.budget-groups": "재질 그룹",
+  "figure.label.budget-independent": "따로 움직이는 부품",
   "figure.label.budget-parts": "부품 수",
   "figure.label.budget-surface": "팔레트 외 표면",
   "figure.label.budget-transparent": "투명 재질",
@@ -113,8 +113,6 @@
   "figure.label.distinct-materials": "서로 다른 재질",
   "figure.label.distinct-shapes": "서로 다른 형상",
   "figure.label.draft": "초안",
-  "figure.label.draw-calls-at-100": "100개 기준 draw call",
-  "figure.label.draw-calls-at-10k": "1만개 기준 draw call",
   "figure.label.emissive": "자체발광",
   "figure.label.emissive-color": "켜진 색",
   "figure.label.environment": "환경",
@@ -263,8 +261,6 @@
   "figure.label.tools": "맞추기",
   "figure.label.transparent": "투명",
   "figure.label.triangles": "삼각형",
-  "figure.label.triangles-at-100": "100개 기준 삼각형",
-  "figure.label.triangles-at-10k": "1만개 기준 삼각형",
   "figure.label.unit-none": "단위 없음",
   "figure.label.unit-type-it": "직접 적기…",
   "figure.label.weight": "그리는 비용",
@@ -276,8 +272,6 @@
   "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": "한도를 넘었습니다. 한 도면에 여러 개 놓으면 화면이 느려집니다.",
   "figure.text.animation-empty-examples": "도는 롤러 · 미끄러지는 문짝 · 오르내리는 리프트 · 깜빡이는 표시등.",
   "figure.text.animation-empty-what-it-is": "아직 움직임이 없습니다. clip 을 추가해 부품을 움직이세요.",
   "figure.text.animation-needs-a-named-part": "부품을 먼저 추가하세요.",
@@ -344,6 +338,8 @@
   "figure.text.hide-all-parts": "모두 감추기",
   "figure.text.hide-this-part": "이 부품을 잠깐 가립니다. 저장되지 않습니다",
   "figure.text.how-many-fit": "한 화면에 보여도 느려지지 않는 수",
+  "figure.text.independent-parts-cost": "따로 움직이는 부품마다 draw call 이 하나 늘어납니다.",
+  "figure.text.independent-parts-over": "한도를 넘었습니다. 한 화면에 함께 세울 수 있는 대수가 그만큼 줍니다.",
   "figure.text.instances-unit": "개",
   "figure.text.interpolation-explained": "키프레임 사이를 어떻게 잇습니까.",
   "figure.text.joint-channel-value-deg": "키 값은 관절 각도(도)입니다.",

package/translations/ms.json

@@ -85,8 +85,8 @@
   "figure.label.axis-scale-short": "scale",
   "figure.label.axis-width": "width",
   "figure.label.base-box": "kotak asas (mm)",
-  "figure.label.budget-animations": "animation points",
   "figure.label.budget-groups": "material groups",
+  "figure.label.budget-independent": "bahagian yang bergerak sendiri",
   "figure.label.budget-parts": "part count",
   "figure.label.budget-surface": "surfaces outside the palette",
   "figure.label.budget-transparent": "transparent materials",
@@ -113,8 +113,6 @@
   "figure.label.distinct-materials": "distinct materials",
   "figure.label.distinct-shapes": "distinct shapes",
   "figure.label.draft": "draf",
-  "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",
@@ -263,8 +261,6 @@
   "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": "tiada unit",
   "figure.label.unit-type-it": "taip sendiri…",
   "figure.label.weight": "weight",
@@ -276,8 +272,6 @@
   "figure.text.already-released-edit-to-release-again": "sudah diterbitkan. sunting dan simpan untuk kembali ke draf, kemudian terbitkan semula.",
   "figure.text.anchor-explained": "muka tempat bahagian ini kekal apabila kotak membesar. dua bahagian yang bersentuhan pada muka berbeza akan terpisah apabila membesar.",
   "figure.text.anchors-are-not-drawn": "slot dan port tidak dilukis pada lukisan; hanya editor yang memaparkannya.",
-  "figure.text.animated-parts-cost": "setiap bahagian yang bergerak menambah satu draw call.",
-  "figure.text.animated-parts-over": "melebihi had. banyak daripada ini pada satu lukisan akan melambatkannya.",
   "figure.text.animation-empty-examples": "penggelek berputar · daun pintu gelongsor · lif naik · lampu isyarat berkelip.",
   "figure.text.animation-empty-what-it-is": "belum ada gerakan. tambah clip untuk menggerakkan bahagian.",
   "figure.text.animation-needs-a-named-part": "tambah bahagian dahulu.",
@@ -344,6 +338,8 @@
   "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": "berapa banyak boleh ada di skrin sebelum ia perlahan",
+  "figure.text.independent-parts-cost": "setiap bahagian yang bergerak sendiri menambah satu draw call.",
+  "figure.text.independent-parts-over": "melebihi had. lebih sedikit daripada ini muat pada satu skrin.",
   "figure.text.instances-unit": "instances",
   "figure.text.interpolation-explained": "cara jurang antara kunci diisi.",
   "figure.text.joint-channel-value-deg": "nilai kunci ialah sudut sendi dalam darjah.",

package/translations/zh.json

@@ -85,8 +85,8 @@
   "figure.label.axis-scale-short": "scale",
   "figure.label.axis-width": "width",
   "figure.label.base-box": "基准盒 (mm)",
-  "figure.label.budget-animations": "animation points",
   "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",
@@ -113,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",
@@ -263,8 +261,6 @@
   "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",
@@ -276,8 +272,6 @@
   "figure.text.already-released-edit-to-release-again": "已经发布。修改并保存会回到草稿，然后可以再次发布。",
   "figure.text.anchor-explained": "包围盒放大时此部件贴住的面。与相邻部件贴在不同的面上时，放大后两者之间会出现间隙。",
   "figure.text.anchors-are-not-drawn": "槽位和端口不会绘制在图面上，只在编辑画面中显示。",
-  "figure.text.animated-parts-cost": "每个运动部件增加 1 个 draw call。",
-  "figure.text.animated-parts-over": "已超过上限。在一个图面上放置多个会使画面变慢。",
   "figure.text.animation-empty-examples": "转动的滚轮 · 滑动的门扇 · 升降的升降机 · 闪烁的指示灯。",
   "figure.text.animation-empty-what-it-is": "还没有动作。添加 clip 来移动部件。",
   "figure.text.animation-needs-a-named-part": "请先添加部件。",
@@ -344,6 +338,8 @@
   "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": "同屏显示而不变慢的数量",
+  "figure.text.independent-parts-cost": "每个单独运动的部件增加 1 个 draw call。",
+  "figure.text.independent-parts-over": "已超过上限。一个画面上能同时放置的台数会减少。",
   "figure.text.instances-unit": "instances",
   "figure.text.interpolation-explained": "关键帧之间如何衔接。",
   "figure.text.joint-channel-value-deg": "关键帧的值是关节角度（度）。",