@things-factory/figure-ui 10.1.115 → 10.1.116

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@things-factory/figure-ui",
-  "version": "10.1.115",
+  "version": "10.1.116",
   "publishConfig": {
     "access": "public",
     "@things-factory:registry": "https://registry.npmjs.org"
@@ -27,8 +27,8 @@
     "clean": "npm run clean:server && npm run clean:client"
   },
   "dependencies": {
-    "@hatiolab/figure-model": "^0.2.15",
-    "@hatiolab/things-scene": "^10.1.69",
+    "@hatiolab/figure-model": "^0.3.2",
+    "@hatiolab/things-scene": "^10.1.71",
     "@material/web": "^2.0.0",
     "@operato/data-grist": "^10.0.0",
     "@operato/graphql": "^10.0.0",
@@ -40,9 +40,9 @@
     "@operato/shell": "^10.0.0",
     "@operato/styles": "^10.0.0",
     "@operato/utils": "^10.0.0",
-    "@things-factory/ai-assistant": "^10.1.114",
-    "@things-factory/figure-service": "^10.1.115",
+    "@things-factory/ai-assistant": "^10.1.116",
+    "@things-factory/figure-service": "^10.1.116",
     "three": "^0.185.1"
   },
-  "gitHead": "3d1f480028b680a6da3d0ae6a73c3121d644b64a"
+  "gitHead": "49fa935cc703be70200eef4d29f473de98f871ce"
 }

package/test/browser/detail-page.js

@@ -0,0 +1,34 @@
+/* Isolated product detail: fixtures are in memory, never saved to the running app. */
+import 'figure-ui-client/viewparts/figure-detail-dock.js'
+import { i18next } from '@operato/i18n'
+import { addFigureBox, createFigureAsset, editFigurePart, applyFigureAuthoring, serializeFigureAsset } from '@hatiolab/figure-model'
+
+async function start() {
+  i18next.addResourceBundle('ko', 'translations', await fetch('/ko.json').then(r => r.json()), true, true)
+  await i18next.changeLanguage('ko')
+  let asset = addFigureBox(createFigureAsset('클립 시험'), { id: 'block', size: { x: 100, y: 100, z: 100 }, position: { x: 0, y: 50, z: 0 } })
+  asset = applyFigureAuthoring(asset, { kind: 'set-joint', joint: {
+    id: 'block', type: 'prismatic', body0: { plane: 'mounting-plane' }, body1: { part: 'block', face: 'bottom' }, axis: 'X', lowerLimit: 0, upperLimit: 200, state: { id: 'shift', start: 0 }
+  } })
+  asset = editFigurePart(asset, { kind: 'set-driver', state: 'shift', clip: 'cycle', duration: 4, keys: [{ seconds: 0, value: 0 }, { seconds: 2, value: 200 }, { seconds: 4, value: 0 }] })
+  const source = serializeFigureAsset(asset)
+  const dock = document.createElement('figure-detail-dock')
+  let fail = true
+  dock.load = async id => {
+    if (id === 'retry' && fail) { fail = false; throw Error('test connection failure') }
+    if (id === 'slow') await new Promise(done => setTimeout(done, 1200))
+    return { saved: { id, name: id === 'slow' ? '늦은 이전 모델' : '클립 시험', type: 'DETAIL_TEST', state: 'draft', source }, released: id === 'invalid' ? { version: 1, source: 'broken json' } : undefined }
+  }
+  const controls = document.createElement('nav')
+  for (const [label, id] of [['클립 모델 열기','motion'],['연결 오류 시험','retry'],['깨진 발행판 시험','invalid'],['느린 모델 열기','slow']]) {
+    const button = document.createElement('button'); button.textContent = label
+    button.onclick = () => void dock.show(id); controls.append(button)
+  }
+  document.body.append(controls,dock)
+  await dock.show('motion')
+  const original = document.createElement('output'); original.setAttribute('aria-label','원본 보존')
+  const check = document.createElement('button'); check.textContent='원본 확인'
+  check.onclick=()=>original.textContent=serializeFigureAsset(asset)===source?'원본 그대로':'원본 변경됨'
+  controls.append(check,original)
+}
+start()

package/test/browser/serve-detail.mjs

@@ -0,0 +1,10 @@
+import { createServer } from 'node:http'
+import { readFileSync } from 'node:fs'
+import { dirname, resolve } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { buildPage } from './build.mjs'
+const here=dirname(fileURLToPath(import.meta.url))
+const bundle=await buildPage('detail-page.js')
+const html=`<!doctype html><html><head><meta charset="utf-8"><title>Figure 상세 검증</title><link rel="stylesheet" href="/theme.css"><style>body{margin:0;font-family:sans-serif;display:flex;height:100vh}nav{flex:1;padding:24px;display:flex;flex-direction:column;gap:12px}nav button{padding:12px}figure-detail-dock{position:static!important;height:100%!important}output{display:block}</style></head><body><script type="module" src="/page.js"></script></body></html>`
+const routes={ '/page.js':[bundle,'text/javascript'], '/ko.json':[resolve(here,'../../translations/ko.json'),'application/json'], '/theme.css':[resolve(here,'../../client/harness-theme/light.css'),'text/css'] }
+createServer((req,res)=>{const match=routes[req.url];res.writeHead(200,{'Content-Type':match?.[1]??'text/html; charset=utf-8'});res.end(match?readFileSync(match[0]):html)}).listen(3394,'127.0.0.1',()=>console.log('Detail fixture: http://localhost:3394'))

package/test/detail-motion.test.ts

@@ -0,0 +1,26 @@
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+import { addFigureBox, createFigureAsset, editFigurePart, serializeFigureAsset } from '@hatiolab/figure-model'
+import { moving } from './joints.ts'
+import { clipForControl, parametersForClip } from '../client/viewparts/detail-motion.ts'
+
+function machine() {
+  let asset = addFigureBox(createFigureAsset('Motion probe'), { id: 'block', size: { x: 100, y: 100, z: 100 }, position: { x: 0, y: 50, z: 0 } })
+  asset = moving(asset, 'block', { kind: 'slide', axis: 'x', id: 'shift', min: 0, max: 200, start: 0 })
+  return editFigurePart(asset, { kind: 'set-driver', state: 'shift', clip: 'cycle', duration: 4, keys: [{ seconds: 0, value: 0 }, { seconds: 2, value: 200 }, { seconds: 4, value: 0 }] })
+}
+
+test('playing a clip releases manual values that would mask its drivers, retaining unrelated controls and the source', () => {
+  const asset = machine()
+  const source = serializeFigureAsset(asset)
+  const values = { shift: 75, other: 42 }
+  assert.deepEqual(parametersForClip(asset, values, 'cycle'), { other: 42 })
+  assert.deepEqual(values, { shift: 75, other: 42 })
+  assert.equal(serializeFigureAsset(asset), source)
+  assert.equal(clipForControl(asset, 'shift'), 'cycle')
+  assert.equal(clipForControl(asset, 'other'), undefined)
+})
+
+test('choosing a different clip cannot clear another clip’s manual control', () => {
+  assert.deepEqual(parametersForClip(machine(), { shift: 75 }, 'other'), { shift: 75 })
+})

package/test/links.test.ts

@@ -371,7 +371,7 @@ test('따라 움직이는 관절 — 같은 방식으로 움직이고 제 조작
   assert.equal(x('left', 40) - x('left', 0), 40)
   assert.equal(x('right', 40) - x('right', 0), -40, '오른손은 거울로 따라 닫힌다')
   const { motionOf } = await import('../client/modeller/links.ts')
-  assert.deepEqual(motionOf(asset, 'right')?.follows, { joint: 'left', multiplier: -1 }, '화면은 무엇을 따르는지 읽는다')
+  assert.deepEqual(motionOf(asset, 'right')?.follows, { sum: [{ joint: 'left', multiplier: -1 }], offset: 0 }, '화면은 무엇을 따르는지 읽는다')
 })
 
 test('면은 도형이 정한다 — 문틀(portal)은 바깥 여섯에 개구부 셋, 공은 없음, 원뿔대는 위아래뿐 (2026-09-25)', async () => {
@@ -661,3 +661,22 @@ test('붙이기 칸은 부품 제 붙임으로 열린다 — 가운데로 붙은
   assert.ok(panel.includes('fasteningOf(this.asset, this.partId)'), '부품을 고르면 제 붙임으로 연다')
   assert.ok(panel.includes("...(f.toPlane ? [] : (['centre'] as const))"), '내 면에 가운데가 있다')
 })
+
+test('a follower of several leaders and a stroke that is a sum of lengths are written back unchanged by the motion form (ADR-0107)', async () => {
+  const { motionFormOf, motionJoint, motionOf } = await import('../client/modeller/links.ts')
+  const { palletizerRobotFigure } = await import('@hatiolab/figure-model')
+  const { asset } = palletizerRobotFigure()
+  const wrist = asset.joints!.find(j => j.id === 'wrist')!
+  const form = motionFormOf(wrist)
+  assert.equal(form.follow, '', 'no single leader to pick')
+  assert.deepEqual(form.followSum, [{ joint: 'j2', multiplier: -1 }, { joint: 'j3', multiplier: -1 }])
+  const saved = motionJoint(wrist, { ...form, axis: form.axis }, 'wrist')
+  assert.deepEqual(saved.mimic, { sum: [{ joint: 'j2', multiplier: -1 }, { joint: 'j3', multiplier: -1 }] }, 'saving the form keeps the follower a follower')
+  assert.equal(saved.state, undefined, 'and gives it no control of its own')
+  assert.deepEqual(motionOf(asset, 'wrist')?.follows, { sum: [{ joint: 'j2', multiplier: -1 }, { joint: 'j3', multiplier: -1 }], offset: 0 })
+
+  const reach = { ...wrist, id: 'reach', type: 'prismatic' as const, mimic: undefined, axis: 'X' as const, travel: { sum: [{ from: { of: 'part' as const, part: 'base', axis: 'x' as const } }, { from: { of: 'part' as const, part: 'turret', axis: 'x' as const }, times: 0.5 }] } }
+  const slide = motionFormOf(reach)
+  assert.equal(slide.travel, '')
+  assert.deepEqual(motionJoint(reach, slide, 'wrist').travel, reach.travel, 'saving keeps the summed stroke')
+})

package/test/modeller-route.test.ts

@@ -23,9 +23,11 @@ test('one modeller page at one address: the route and the shell table agree', ()
   assert.equal(config.match(/tagname: 'figure-modeller-page', page: 'figure-modeller'/g)?.length, 1)
 })
 
-test('the catalogue opens figures through the one path', () => {
+test('the catalogue opens details first; editing is an explicit action in the detail dock', () => {
   const list = read('../client/pages/figure-list-page.ts')
-  assert.match(list, /navigate\(modellerPathOf\(figure\)\)/)
+  assert.match(list, /openFigureDetail\(record\)/)
+  const detail = read('../client/viewparts/figure-detail-dock.ts')
+  assert.match(detail, /navigate\(modellerPathOf\(saved\)\)/)
 })
 
 test('reloading or closing the tab with unsaved work asks first — the shell does not ask canDeactivate then (09-26)', () => {

package/test/verdict.test.ts

@@ -12,7 +12,7 @@ import assert from 'node:assert/strict'
 import { readFileSync } from 'node:fs'
 import { fileURLToPath } from 'node:url'
 
-import { addFigureBox, createFigureAsset, figureCostOf } from '@hatiolab/figure-model'
+import { addFigureBox, createFigureAsset, editFigurePart, figureCostOf } from '@hatiolab/figure-model'
 
 import { capacityFrom, SCENE_BUDGET } from '../client/modeller/scene-budget.ts'
 
@@ -25,6 +25,8 @@ test('개수는 목록 카드와 같은 셈이다 — 원가를 같은 capacityF
   let asset = createFigureAsset('Probe')
   asset = addFigureBox(asset, { id: 'a', size: { x: 100, y: 100, z: 100 }, position: { x: 0, y: 50, z: 0 } })
   asset = addFigureBox(asset, { id: 'b', size: { x: 100, y: 100, z: 100 }, position: { x: 200, y: 50, z: 0 } })
+  // The kernel batches static parts with the same material. Use two colours to test two draw groups.
+  asset = editFigurePart(asset, { kind: 'set-material', target: 'b', material: { token: 'palette.accent' }, palette: { 'palette.accent': '#f28c28' } })
   const cost = figureCostOf(asset)
 
   assert.equal(cost.groups, 2, '전제: 그려지는 부품 둘이 묶음 둘')

package/translations/en.json

@@ -965,5 +965,23 @@
   "figure.label.face-mapping-choose": "Choose",
   "figure.label.face-mapping-detach": "Let go (stays where it is)",
   "figure.button.face-mapping-cancel": "Cancel",
-  "figure.button.face-mapping-apply": "Move and apply"
+  "figure.button.face-mapping-apply": "Move and apply",
+  "figure.title.detail": "Figure details",
+  "figure.text.detail-loading": "Loading model…",
+  "figure.button.detail-retry": "Retry",
+  "figure.text.detail-load-failed": "Could not load the model. Check your connection and access, then retry.",
+  "figure.text.detail-no-source": "No saved model is available.",
+  "figure.text.detail-invalid-source": "This model format could not be read. Open the editor to inspect it.",
+  "figure.label.detail-source": "Model to view",
+  "figure.label.detail-released": "Released version {version}",
+  "figure.label.detail-saved": "Saved model",
+  "figure.text.detail-unreleased": "Not released yet. Showing the saved draft.",
+  "figure.button.detail-edit": "Open editor",
+  "figure.label.detail-size": "Placement size",
+  "figure.button.detail-reset": "Reset size and pose",
+  "figure.text.detail-transient": "Try sizes and motion here. The saved model stays unchanged.",
+  "figure.text.detail-no-motion": "No motion is defined.",
+  "figure.text.detail-playing": "Playing",
+  "figure.label.detail-summary": "Drawing cost of the selected model",
+  "figure.text.detail-paused": "Paused"
 }

package/translations/ja.json

@@ -965,5 +965,23 @@
   "figure.label.face-mapping-choose": "移動先",
   "figure.label.face-mapping-detach": "外しておく(今の位置のまま)",
   "figure.button.face-mapping-cancel": "やめる",
-  "figure.button.face-mapping-apply": "移して適用"
+  "figure.button.face-mapping-apply": "移して適用",
+  "figure.title.detail": "Figure の詳細",
+  "figure.text.detail-loading": "モデルを読み込み中…",
+  "figure.button.detail-retry": "再試行",
+  "figure.text.detail-load-failed": "モデルを読み込めませんでした。接続とアクセス権を確認して再試行してください。",
+  "figure.text.detail-no-source": "保存されたモデルがありません。",
+  "figure.text.detail-invalid-source": "このモデルの形式を読み取れません。編集画面で確認してください。",
+  "figure.label.detail-source": "表示するモデル",
+  "figure.label.detail-released": "公開版 {version}",
+  "figure.label.detail-saved": "保存版",
+  "figure.text.detail-unreleased": "まだ公開されていません。保存された下書きを表示します。",
+  "figure.button.detail-edit": "編集画面を開く",
+  "figure.label.detail-size": "配置サイズ",
+  "figure.button.detail-reset": "基準サイズと姿勢に戻す",
+  "figure.text.detail-transient": "サイズと動きはここでのみ試します。保存されたモデルは変更されません。",
+  "figure.text.detail-no-motion": "登録された動きがありません。",
+  "figure.text.detail-playing": "再生中",
+  "figure.label.detail-summary": "選択したモデルの描画コスト",
+  "figure.text.detail-paused": "一時停止"
 }

package/translations/ko.json

@@ -965,5 +965,23 @@
   "figure.label.face-mapping-choose": "옮길 곳",
   "figure.label.face-mapping-detach": "떼어 두기(지금 자리에 그대로)",
   "figure.button.face-mapping-cancel": "그만두기",
-  "figure.button.face-mapping-apply": "옮기고 적용"
+  "figure.button.face-mapping-apply": "옮기고 적용",
+  "figure.title.detail": "Figure 상세",
+  "figure.text.detail-loading": "모델을 불러오는 중…",
+  "figure.button.detail-retry": "다시 시도",
+  "figure.text.detail-load-failed": "모델을 불러오지 못했습니다. 연결과 접근 권한을 확인하고 다시 시도하세요.",
+  "figure.text.detail-no-source": "저장된 모델이 없습니다.",
+  "figure.text.detail-invalid-source": "이 모델의 형식을 읽을 수 없습니다. 편집 화면에서 확인하세요.",
+  "figure.label.detail-source": "보는 모델",
+  "figure.label.detail-released": "발행판 {version}",
+  "figure.label.detail-saved": "저장본",
+  "figure.text.detail-unreleased": "아직 발행되지 않았습니다. 저장된 초안을 보여줍니다.",
+  "figure.button.detail-edit": "편집 화면 열기",
+  "figure.label.detail-size": "배치 크기",
+  "figure.button.detail-reset": "기준 크기와 자세로",
+  "figure.text.detail-transient": "크기와 움직임은 여기서만 시험합니다. 저장된 모델은 바뀌지 않습니다.",
+  "figure.text.detail-no-motion": "등록된 움직임이 없습니다.",
+  "figure.text.detail-playing": "재생 중",
+  "figure.label.detail-summary": "선택한 모델의 그리기 비용",
+  "figure.text.detail-paused": "일시정지"
 }

package/translations/ms.json

@@ -965,5 +965,23 @@
   "figure.label.face-mapping-choose": "Pilih",
   "figure.label.face-mapping-detach": "Lepaskan (kekal di tempatnya)",
   "figure.button.face-mapping-cancel": "Batal",
-  "figure.button.face-mapping-apply": "Alih dan guna"
+  "figure.button.face-mapping-apply": "Alih dan guna",
+  "figure.title.detail": "Butiran Figure",
+  "figure.text.detail-loading": "Memuatkan model…",
+  "figure.button.detail-retry": "Cuba lagi",
+  "figure.text.detail-load-failed": "Model tidak dapat dimuatkan. Semak sambungan dan hak akses, kemudian cuba lagi.",
+  "figure.text.detail-no-source": "Tiada model yang disimpan.",
+  "figure.text.detail-invalid-source": "Format model ini tidak dapat dibaca. Semak dalam editor.",
+  "figure.label.detail-source": "Model untuk dilihat",
+  "figure.label.detail-released": "Versi terbitan {version}",
+  "figure.label.detail-saved": "Versi disimpan",
+  "figure.text.detail-unreleased": "Belum diterbitkan. Draf yang disimpan dipaparkan.",
+  "figure.button.detail-edit": "Buka editor",
+  "figure.label.detail-size": "Saiz penempatan",
+  "figure.button.detail-reset": "Pulihkan saiz dan posisi asal",
+  "figure.text.detail-transient": "Saiz dan gerakan hanya diuji di sini. Model yang disimpan tidak berubah.",
+  "figure.text.detail-no-motion": "Tiada gerakan didaftarkan.",
+  "figure.text.detail-playing": "Sedang dimainkan",
+  "figure.label.detail-summary": "Kos lukisan model yang dipilih",
+  "figure.text.detail-paused": "Dijeda"
 }

package/translations/zh.json

@@ -965,5 +965,23 @@
   "figure.label.face-mapping-choose": "去处",
   "figure.label.face-mapping-detach": "解除连接（保持原位）",
   "figure.button.face-mapping-cancel": "取消",
-  "figure.button.face-mapping-apply": "移动并应用"
+  "figure.button.face-mapping-apply": "移动并应用",
+  "figure.title.detail": "Figure 详情",
+  "figure.text.detail-loading": "正在加载模型…",
+  "figure.button.detail-retry": "重试",
+  "figure.text.detail-load-failed": "无法加载模型。请检查连接和访问权限后重试。",
+  "figure.text.detail-no-source": "没有已保存的模型。",
+  "figure.text.detail-invalid-source": "无法读取此模型的格式。请在编辑页面检查。",
+  "figure.label.detail-source": "查看模型",
+  "figure.label.detail-released": "发布版 {version}",
+  "figure.label.detail-saved": "已保存版本",
+  "figure.text.detail-unreleased": "尚未发布。显示已保存的草稿。",
+  "figure.button.detail-edit": "打开编辑页面",
+  "figure.label.detail-size": "放置尺寸",
+  "figure.button.detail-reset": "恢复基准尺寸与姿态",
+  "figure.text.detail-transient": "尺寸和动作仅在此处试用，不会修改已保存的模型。",
+  "figure.text.detail-no-motion": "没有已注册的动作。",
+  "figure.text.detail-playing": "播放中",
+  "figure.label.detail-summary": "所选模型的绘制成本",
+  "figure.text.detail-paused": "已暂停"
 }