@things-factory/figure-ui 10.1.52 → 10.1.54

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@things-factory/figure-ui",
-  "version": "10.1.52",
+  "version": "10.1.54",
   "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.1.60",
-    "@hatiolab/things-scene": "^10.1.37",
+    "@hatiolab/figure-model": "^0.1.63",
+    "@hatiolab/things-scene": "^10.1.40",
     "@material/web": "^2.0.0",
     "@operato/data-grist": "^10.0.0",
     "@operato/graphql": "^10.0.0",
@@ -39,8 +39,9 @@
     "@operato/shell": "^10.0.0",
     "@operato/styles": "^10.0.0",
     "@operato/utils": "^10.0.0",
-    "@things-factory/figure-service": "^10.1.52",
+    "@things-factory/ai-assistant": "^10.1.53",
+    "@things-factory/figure-service": "^10.1.54",
     "three": "^0.185.1"
   },
-  "gitHead": "b3ec4f0a38f0759d396f49b1f47c547bff4657be"
+  "gitHead": "0bc2238c6df9cb041b22146c85181ed7efe38f40"
 }

package/test/browser/modeller.check.mjs

@@ -376,6 +376,45 @@ describe('a figure made in the modeller is given its size from its parts (user 2
     assert.equal(after.revision, start.revision + 1, 'one step')
     assert.deepEqual(await read(() => probe.fields('size.')), { 'size.x': 400, 'size.y': 400, 'size.z': 400 }, 'the size it is authored at: its parts now')
   })
+
+  test('a part follows the figure\'s width less a difference: chosen and typed, the width is the size less it', async () => {
+    await click(await read(() => probe.partOnPage('box')))
+    assert.equal((await state()).selected, 'box')
+    const handle = (what, label) =>
+      page().evaluateHandle(
+        (what, label) => {
+          const deep = (root = document) => [...root.querySelectorAll(what)].concat(...[...root.querySelectorAll('*')].filter(e => e.shadowRoot).map(e => deep(e.shadowRoot)))
+          if (what === 'select') return deep().find(s => s.previousElementSibling?.textContent?.trim() === label && [...s.options].some(o => o.value === 'instance:x')) ?? null
+          return deep().find(i => i.closest('label[inline-plus]')) ?? null
+        },
+        what,
+        label
+      )
+    const width = await handle('select', 'X')
+    assert.ok(await width.evaluate(s => !!s), 'the width can follow the figure size')
+    await width.select('instance:x')
+    await sleep(600)
+    const plus = await handle('input')
+    assert.ok(await plus.evaluate(i => !!i), 'a following width offers its difference')
+    await plus.evaluate(i => i.scrollIntoView({ block: 'center' }))
+    await plus.click({ clickCount: 3 })
+    await page().keyboard.type('-50')
+    await page().keyboard.press('Tab')
+    await sleep(600)
+    /* The declared sizes start at 1 mm: less 50 the box would be gone below 50, so the link is refused -- with the way on. */
+    assert.match((await state()).error, /figure.text.link-needs-smaller-range/, 'refused, said in words')
+    const narrow = await page().evaluateHandle(() => {
+      const deep = (root = document) => [...root.querySelectorAll('button')].concat(...[...root.querySelectorAll('*')].filter(e => e.shadowRoot).map(e => deep(e.shadowRoot)))
+      return deep().find(b => b.textContent.includes('figure.button.narrow-range-from')) ?? null
+    })
+    assert.ok(await narrow.evaluate(b => !!b), 'the same link is offered with the sizes narrowed')
+    await click(await narrow.evaluate(b => {
+      const r = b.getBoundingClientRect()
+      return { x: r.left + r.width / 2, y: r.top + r.height / 2 }
+    }))
+    assert.equal((await state()).error, '', 'taken')
+    assert.equal((await body('box')).dimensions.width, 350, 'the figure\'s 400 less 50')
+  })
 })
 
 test('the page raised no error', () => {

package/test/figure-assistant-surface.test.ts

@@ -0,0 +1,52 @@
+/*
+ * The V3 modeller's AI - the framework dock talks about the figure on screen (design/ai/shared-dock.md §3).
+ *
+ * What this holds: ① a saved figure provides a surface anchored on its row ② the draft is read at the moment of
+ * sending, not when the surface was provided ③ an unsaved figure provides nothing - no conversation without a row
+ * ④ the page takes the surface back when it goes inactive or leaves. The page pulls in the shell and things-scene,
+ * so this reads its source.
+ */
+import assert from 'node:assert/strict'
+import { readFileSync } from 'node:fs'
+import { fileURLToPath } from 'node:url'
+import { test } from 'node:test'
+
+const source = readFileSync(fileURLToPath(new URL('../client/pages/figure-v3-modeller-page.ts', import.meta.url)), 'utf8')
+
+test('a saved figure provides a surface anchored on its row', () => {
+  assert.match(source, /provideAssistantSurface\(this, \{/)
+  assert.match(source, /subject: 'figure'/)
+  assert.match(source, /anchor: \(\) => \(\{ anchorType: 'figure', anchorId: id \}\)/)
+})
+
+test('the draft is read when the message is sent, as host context the figure tools read', () => {
+  assert.match(source, /hostContext: \(\) => \(\{[\s\S]*?figureId: id,[\s\S]*?draftSource: JSON\.parse\(this\.session\.source\(\)\),[\s\S]*?palette: Object\.keys\(activePalette\(\)\)/)
+})
+
+test('an unsaved figure provides nothing', () => {
+  assert.match(source, /if \(!view\.id\) \{\s*this\.withdrawAssistant\(\)/)
+})
+
+test('the surface is taken back when the page goes inactive or leaves', () => {
+  const withdraws = source.match(/this\.withdrawAssistant\(\)/g) ?? []
+  assert.ok(withdraws.length >= 3, 'unsaved, inactive and disconnected each withdraw')
+  assert.doesNotMatch(source, /figure-ai-context/, 'the old window-event channel is gone')
+})
+
+test('the V3 apply entry stays for the proposer that writes V3 changes', () => {
+  assert.match(source, /window\.addEventListener\('figure-v3-apply', this\.applyAI\)/)
+})
+
+test('a figure candidate is answered - unavailable, in words - never left without a handler', () => {
+  const handler = readFileSync(fileURLToPath(new URL('../client/figure-assistant.ts', import.meta.url)), 'utf8')
+  assert.match(handler, /registerProposalHandler\(FIGURE_CANDIDATE_TOOL,/)
+  assert.match(handler, /export const FIGURE_CANDIDATE_TOOL = 'proposeFigureCandidate'/)
+  assert.match(handler, /verdict: 'unavailable'/)
+  assert.match(handler, /figure\.text\.candidate-cannot-open/)
+  for (const lang of ['en', 'ko', 'ja', 'zh', 'ms']) {
+    const words = JSON.parse(readFileSync(fileURLToPath(new URL(`../translations/${lang}.json`, import.meta.url)), 'utf8'))
+    assert.ok(words['figure.text.candidate-cannot-open'], `${lang} has no words for it`)
+  }
+  const index = readFileSync(fileURLToPath(new URL('../client/index.ts', import.meta.url)), 'utf8')
+  assert.match(index, /figure-assistant\.js/)
+})

package/test/v3-first-save.test.ts

@@ -82,3 +82,11 @@ test('처음 저장한 도형은 주소가 제 것이 된다 — 모델러를
   /* The early return that kept the old figure reads the route id; it now matches only the figure the address names. */
   assert.match(page, /if \(this\.session\.read\(\)\.context && id === this\.routeId && !changes\.active\) return/)
 })
+
+test('다른 도형을 열면 행을 먼저 비운다 — 앞 도형의 타입이 칸에 남지 않는다 (C2, 2026-09-25)', async () => {
+  const { readFileSync } = await import('node:fs')
+  const page = readFileSync(new URL('../client/pages/figure-v3-modeller-page.ts', import.meta.url), 'utf8')
+  const updated = page.slice(page.indexOf('async pageUpdated'), page.indexOf('private askFirstSave'))
+  const opening = updated.slice(updated.indexOf('if (id) {'), updated.indexOf('this.session.open(id'))
+  assert.match(opening, /this\.row = \{ version: 0 \}/, '열기 전에 행을 비운다')
+})

package/test/v3-links.test.ts

@@ -30,7 +30,7 @@ test('크기 — 제 치수 · 인스턴스 크기 · 다른 부품의 치수를
   const byInstance = applyV3Authoring(asset, { kind: 'link-dimension', part: 'plate', axis: 'x', source: { of: 'instance', axis: 'x' } })
   assert.deepEqual(followOf(byInstance, 'plate', 'x'), { of: 'instance', axis: 'x', times: 1 })
   const byPart = applyV3Authoring(byInstance, { kind: 'link-dimension', part: 'block', axis: 'x', source: { of: 'part', part: 'plate', axis: 'x' }, times: 0.5 })
-  assert.deepEqual(followOf(byPart, 'block', 'x'), { of: 'part', part: 'plate', axis: 'x' }, '배율이 끼어도 원천을 찾는다')
+  assert.deepEqual(followOf(byPart, 'block', 'x'), { of: 'part', part: 'plate', axis: 'x', times: 0.5 }, '배율이 끼어도 원천을 찾고, 배율도 읽는다')
   const back = applyV3Authoring(byPart, { kind: 'unlink-dimension', part: 'block', axis: 'x', mm: 300 })
   assert.deepEqual(followOf(back, 'block', 'x'), { of: 'own' }, '떼면 다시 제 치수')
   assert.equal(hasInstanceSize(asset, 'y'), true)
@@ -182,7 +182,8 @@ test('비례 — 인스턴스 크기의 몫을 따르는 치수는 비례로 읽
   m.nodes.push({ id: 'flange.free', op: 'add@1', args: ['size.y', 'k.gaps'], outputs: { value: 'flange.free.value' } })
   m.nodes.push({ id: 'flange.dimension.y', op: 'mul@1', args: ['flange.free.value', m.constants.find(c => c.value === 1)?.id ?? 'k.one'], outputs: { value: 'flange.dimension.y.value' } })
   if (!m.constants.some(c => c.value === 1)) m.constants.push({ id: 'k.one', unit: 'ratio', value: 1 })
-  assert.deepEqual(followOf(fill as V3Asset, 'flange', 'y'), { of: 'expression' })
+  /* Read as what it is since the plus is read (2026-09-25): the size less 90 -- following the size, not a share of it. */
+  assert.deepEqual(followOf(fill as V3Asset, 'flange', 'y'), { of: 'instance', axis: 'y', times: 1, plus: -90 })
 
   /* Before any link the shape reads the measure directly; a worked-out one there is not 「고정」 (ROBOT_ARM on :3300). */
   const direct = structuredClone(asset)
@@ -363,3 +364,74 @@ test('모델러에서 만든 도형은 부품에서 재어 도형 크기를 선
   const at = (size: number) => (compileV3Asset({ ...asset, designInputs: { ...asset.designInputs, 'size.x': size } }).evaluate().geometry.find(g => g.id === 'frame')!.shape.dimensions as { width: number }).width
   assert.equal(at(3000), 3000, '보드가 3000 으로 놓으면 틀도 3000')
 })
+
+test('따르는 치수의 더하기를 읽는다 — 문짝 폭 = 개구부 − 틈 (사이징, 2026-09-25)', async () => {
+  const { followOf, choiceOf } = await import('../client/modeller/v3-links.ts')
+  let asset = createV3Asset('Door')
+  asset = addV3Box(asset, { id: 'head', size: { x: 1100, y: 100, z: 150 }, position: { x: 0, y: 0, z: 0 } })
+  asset = addV3Box(asset, { id: 'leaf', size: { x: 890, y: 2095, z: 40 }, position: { x: 0, y: 0, z: 0 } })
+  asset = applyV3Authoring(asset, { kind: 'link-dimension', part: 'leaf', axis: 'x', source: { of: 'part', part: 'head', axis: 'x' }, plus: -210 })
+  assert.deepEqual(followOf(asset, 'leaf', 'x'), { of: 'part', part: 'head', axis: 'x', plus: -210 })
+  assert.equal(choiceOf(followOf(asset, 'leaf', 'x')), 'part:head:x', '선택은 그대로 — 더하기는 따로')
+  const { compileV3Asset } = await import('@hatiolab/figure-model')
+  const wide = { ...asset, designInputs: { ...asset.designInputs, 'head.size.x': 1500 } }
+  assert.equal((compileV3Asset(wide).evaluate().geometry.find(g => g.id === 'leaf')!.shape.dimensions as { width: number }).width, 1290, '상인방 1500 이면 문짝 1290')
+  asset = applyV3Authoring(asset, { kind: 'declare-instance-size', range: { x: { min: 500, max: 5000 }, y: { min: 500, max: 5000 }, z: { min: 50, max: 500 } }, at: { x: 1100, y: 2200, z: 150 } })
+  asset = applyV3Authoring(asset, { kind: 'link-dimension', part: 'head', axis: 'x', source: { of: 'instance', axis: 'x' }, times: 0.5, plus: 20 })
+  assert.deepEqual(followOf(asset, 'head', 'x'), { of: 'instance', axis: 'x', times: 0.5, plus: 20 })
+})
+
+test('미끄러짐의 이동 거리가 부품 길이를 따른다 — 레일이 길어지면 브리지가 끝까지 간다 (사이징, 2026-09-25)', async () => {
+  const { motionJoint, motionOf } = await import('../client/modeller/v3-links.ts')
+  const { compileV3Asset } = await import('@hatiolab/figure-model')
+  let asset = createV3Asset('Gantry')
+  asset = addV3Box(asset, { id: 'rail', size: { x: 3000, y: 120, z: 120 }, position: { x: 0, y: 0, z: 0 } })
+  asset = addV3Box(asset, { id: 'bridge', size: { x: 160, y: 160, z: 1300 }, position: { x: 0, y: 0, z: 0 } })
+  asset = applyV3Authoring(asset, { kind: 'attach', part: 'rail', face: 'bottom', to: { plane: 'mounting-plane' } })
+  asset = applyV3Authoring(asset, { kind: 'attach', part: 'bridge', face: 'bottom', to: { part: 'rail', face: 'top' }, align: { x: 'min' } })
+  const joint = asset.joints!.find(j => j.body1.part === 'bridge')!
+  const form = { kind: 'slide' as const, axis: 'x' as const, id: 'x', min: 0, max: 500, follow: '', multiplier: 1, offset: 0, travel: 'rail:x', travelPlus: -160 }
+  const record = motionJoint(joint, form, 'bridge')
+  assert.deepEqual(record.travel, { source: { of: 'part', part: 'rail', axis: 'x' }, plus: -160 })
+  assert.equal(record.lowerLimit, undefined, '거리는 레일이 정한다 — mm 범위는 없다')
+  asset = applyV3Authoring(asset, { kind: 'set-joint', joint: record })
+  assert.deepEqual(motionOf(asset, 'bridge')?.travel, { part: 'rail', axis: 'x', plus: -160 }, '화면은 무엇을 따르는지 읽는다')
+  const end = (railLength: number) => {
+    const a = { ...asset, designInputs: { ...asset.designInputs, 'rail.size.x': railLength } }
+    const g = (id: string) => compileV3Asset(a).evaluate({ x: 1 }).geometry.find(x => x.id === id)! as unknown as { pose: { t: number[] }; shape: { dimensions: { width: number } } }
+    return Math.round(g('bridge').pose.t[0]! + 80 - (g('rail').pose.t[0]! + railLength / 2))
+  }
+  assert.equal(end(3000), 0, '끝까지(1) 가면 브리지 끝이 레일 끝')
+  assert.equal(end(4500), 0, '레일이 길어져도 끝까지')
+})
+
+test('면 위 거리를 도형 크기 비율로 — 도형이 커지면 그 자리도 비율로 옮긴다 (사이징, 2026-09-25)', async () => {
+  const { alignOf } = await import('../client/modeller/v3-links.ts')
+  const { compileV3Asset } = await import('@hatiolab/figure-model')
+  let asset = createV3Asset('Panel')
+  asset = addV3Box(asset, { id: 'panel', size: { x: 1000, y: 800, z: 40 }, position: { x: 0, y: 0, z: 0 } })
+  asset = addV3Box(asset, { id: 'lamp', size: { x: 60, y: 60, z: 30 }, position: { x: 0, y: 0, z: 0 } })
+  asset = applyV3Authoring(asset, { kind: 'attach', part: 'panel', face: 'bottom', to: { plane: 'mounting-plane' } })
+  const front = { part: 'panel', face: 'front' }
+  assert.deepEqual(alignOf(asset, 'lamp', front, { x: 'share' }, { x: 300 }), undefined, '도형 크기가 없으면 비율을 보낼 수 없다')
+  asset = applyV3Authoring(asset, { kind: 'declare-instance-size', range: { x: { min: 200, max: 5000 }, y: { min: 200, max: 5000 }, z: { min: 10, max: 500 } }, at: { x: 1000, y: 800, z: 40 } })
+  asset = applyV3Authoring(asset, { kind: 'link-dimension', part: 'panel', axis: 'x', source: { of: 'instance', axis: 'x' } })
+  const align = alignOf(asset, 'lamp', front, { x: 'share' }, { x: 300 })!
+  assert.deepEqual(align, { x: { mm: { from: { of: 'instance', axis: 'x' }, times: 0.3 } } })
+  asset = applyV3Authoring(asset, { kind: 'attach', part: 'lamp', face: 'back', to: front, align })
+  const x = (size: number) => Math.round(compileV3Asset({ ...asset, designInputs: { ...asset.designInputs, 'size.x': size } }).evaluate().geometry.find(g => g.id === 'lamp')!.pose.t[0]!)
+  assert.equal(x(1000), 300)
+  assert.equal(x(2000), 600, '도형이 두 배면 거리도 두 배')
+})
+
+test('선언할 크기는 부품이 쉬고 있을 때의 크기 — 문짝이 도는 자리까지 재지 않는다 (2026-09-25)', async () => {
+  const { instanceRangeToDeclare } = await import('../client/modeller/v3-links.ts')
+  let asset = createV3Asset('Door')
+  asset = addV3Box(asset, { id: 'jamb', size: { x: 100, y: 2100, z: 150 }, position: { x: 0, y: 0, z: 0 } })
+  asset = addV3Box(asset, { id: 'leaf', size: { x: 890, y: 2095, z: 40 }, position: { x: 0, y: 0, z: 0 } })
+  asset = applyV3Authoring(asset, { kind: 'attach', part: 'jamb', face: 'bottom', to: { plane: 'mounting-plane' } })
+  asset = applyV3Authoring(asset, { kind: 'attach', part: 'leaf', face: 'left', to: { part: 'jamb', face: 'right' }, align: { y: 'min', z: 'max' }, gap: 5 })
+  const j = asset.joints!.find(o => o.id === 'leaf')!
+  asset = applyV3Authoring(asset, { kind: 'set-joint', joint: { ...j, type: 'revolute', axis: 'Y', lowerLimit: -90, upperLimit: 0, state: { id: 'open' } } })
+  assert.deepEqual(instanceRangeToDeclare(asset)!.at, { x: 995, y: 2100, z: 150 })
+})

package/test/v3-parts-wiring.test.ts

@@ -37,10 +37,12 @@ test('작업대에서 가린 부품은 캔버스에서 빠지고, 다른 도형
 })
 
 test('지울 수 없는 부품은 사람의 말로 거절한다 — 다섯 말 모두', () => {
-  assert.match(editor, /code === 'PART_REFERENCED'[\s\S]*?figure\.text\.part-is-referenced/)
+  /* Since 2026-09-25 the reason is told apart (partRefusalOf, tested in v3-refusals); the editor hands the refusal to it. */
+  assert.match(editor, /private removePart[\s\S]*?partRefusalOf\(error, id,/)
   for (const lang of ['ko', 'en', 'ja', 'zh', 'ms']) {
     const table = JSON.parse(read(`../translations/${lang}.json`))
-    assert.ok(table['figure.text.part-is-referenced']?.includes('{part}'), lang)
+    for (const key of ['part-is-referenced', 'part-holds-others', 'part-in-declared-space', 'part-is-followed', 'part-is-led'])
+      assert.ok(table[`figure.text.${key}`]?.includes('{part}'), `${lang} ${key}`)
   }
 })
 

package/test/v3-refusals.test.ts

@@ -26,3 +26,54 @@ test('위쪽 끝도, 부품 이름이 없어도', () => {
 test('다른 거절은 건드리지 않는다', () => {
   assert.equal(sizeRangeRefusalOf(Object.assign(new Error('x'), { code: 'EDIT_TARGET' }), say), null)
 })
+
+test('범위가 받을 수 없는 연결은 같은 연결을 범위를 좁혀 다시 권한다 — 다시 재기로는 풀리지 않는다 (사이징, 2026-09-25)', async () => {
+  const { narrowingRetryOf } = await import('../client/modeller/v3-refusals.ts')
+  const { addV3Box, applyV3Authoring, createV3Asset } = await import('@hatiolab/figure-model')
+  let asset = addV3Box(createV3Asset('Panel'), { id: 'panel', size: { x: 400, y: 400, z: 400 }, position: { x: 0, y: 0, z: 0 } })
+  asset = applyV3Authoring(asset, { kind: 'declare-instance-size', range: { x: { min: 1, max: 4000 }, y: { min: 1, max: 4000 }, z: { min: 1, max: 4000 } }, at: { x: 400, y: 400, z: 400 } })
+  const link = { kind: 'link-dimension' as const, part: 'panel', axis: 'x' as const, source: { of: 'instance' as const, axis: 'x' as const }, plus: -50 }
+  let error: unknown
+  try {
+    applyV3Authoring(asset, link)
+  } catch (e) {
+    error = e
+  }
+  const say = (key: string, p: Record<string, string>) => `${key} ${JSON.stringify(p)}`
+  const offer = narrowingRetryOf(link, error, say)!
+  assert.ok(offer, '권한다')
+  assert.match(offer.label, /figure.button.narrow-range-from .*"axis":"X"/)
+  assert.deepEqual(offer.retry, { ...link, narrowRange: true })
+  assert.doesNotThrow(() => applyV3Authoring(asset, offer.retry as never), '권한 것은 받아들여진다')
+  assert.equal(narrowingRetryOf({ kind: 'attach' }, error, say), null, '연결이 아닌 명령에는 권하지 않는다')
+})
+
+test('부품을 못 지우는 까닭을 넷으로 가려 말한다 — 매단 것 · 공간 선언 · 크기를 따르는 것 · 따라 움직이는 것 (2026-09-25)', async () => {
+  const { partRefusalOf } = await import('../client/modeller/v3-refusals.ts')
+  const fm = await import('@hatiolab/figure-model')
+  const say = (key: string, p: Record<string, string>) => `${key} ${JSON.stringify(p)}`
+  let a = fm.createV3Asset('Bench')
+  a = fm.addV3Box(a, { id: 'leg', size: { x: 60, y: 700, z: 60 }, position: { x: 0, y: 0, z: 0 } })
+  a = fm.addV3Box(a, { id: 'top', size: { x: 1200, y: 40, z: 600 }, position: { x: 0, y: 0, z: 0 } })
+  a = fm.addV3Box(a, { id: 'lamp', size: { x: 80, y: 80, z: 80 }, position: { x: 0, y: 0, z: 0 } })
+  a = fm.addV3Box(a, { id: 'shade', size: { x: 40, y: 40, z: 40 }, position: { x: 0, y: 0, z: 0 } })
+  a = fm.applyV3Authoring(a, { kind: 'attach', part: 'leg', face: 'bottom', to: { plane: 'mounting-plane' } })
+  a = fm.applyV3Authoring(a, { kind: 'attach', part: 'top', face: 'bottom', to: { part: 'leg', face: 'top' } })
+  a = fm.applyV3Authoring(a, { kind: 'attach', part: 'lamp', face: 'bottom', to: { part: 'top', face: 'top' }, align: { x: { mm: -300 } } })
+  a = fm.applyV3Authoring(a, { kind: 'attach', part: 'shade', face: 'bottom', to: { part: 'top', face: 'top' }, align: { x: { mm: 300 } } })
+  const turn = (asset: typeof a, part: string, extra: object) => fm.applyV3Authoring(asset, { kind: 'set-joint', joint: { ...asset.joints!.find(j => j.body1.part === part)!, type: 'revolute', axis: 'Y', ...extra } as never })
+  a = turn(a, 'lamp', { state: { id: 'lamp-turn' } })
+  a = turn(a, 'shade', { mimic: { joint: 'lamp', multiplier: 1 } })
+  const why = (asset: typeof a, part: string) => {
+    try {
+      fm.editV3Part(asset, { kind: 'remove-part', target: part })
+      return 'removed'
+    } catch (e) {
+      return partRefusalOf(e, part, say)
+    }
+  }
+  assert.match(why(a, 'top')!, /part-holds-others .*"others":"lamp, shade"/)
+  assert.match(why(a, 'lamp')!, /part-is-led .*"others":"shade"/)
+  const declared = fm.applyV3Authoring(a, { kind: 'declare-occupancy', proposal: fm.proposeV3Occupancy(a), placement: 'floor' })
+  assert.match(why(declared, 'shade')!, /part-in-declared-space .*"part":"shade"/, '잎인데 공간 선언에 들어 있다')
+})

package/translations/en.json

@@ -710,5 +710,19 @@
   "figure.button.remove-repeat": "remove the row",
   "figure.label.twist": "twist (°)",
   "figure.text.instance-size-undeclared": "the figure has no size, so a board cannot resize it.",
-  "figure.button.declare-instance-size": "declare the figure size"
+  "figure.button.declare-instance-size": "declare the figure size",
+  "figure.text.candidate-cannot-open": "this candidate is a V2 figure and the modeller opens V3 figures only, so it cannot be opened for review yet.",
+  "figure.label.follows-plus": "plus (mm)",
+  "figure.label.motion-travel": "travel",
+  "figure.label.motion-travel-mm": "its own range (mm)",
+  "figure.label.motion-travel-is": "travel: {part} · {axis} + {plus} mm",
+  "figure.label.align-share": "offset from centre, as a share of the figure size",
+  "figure.text.link-needs-smaller-range": "with this link {part} is gone when the figure's {axis} is under {mm} mm, and the declared sizes go below that.",
+  "figure.button.narrow-range-from": "narrow {axis} to {mm} mm and up, and link",
+  "figure.text.link-needs-larger-range": "with this link the figure cannot be drawn when its {axis} is over {mm} mm, and the declared sizes go above that.",
+  "figure.button.narrow-range-to": "narrow {axis} to {mm} mm and under, and link",
+  "figure.text.part-holds-others": "'{part}' holds {others}; take them off first.",
+  "figure.text.part-in-declared-space": "'{part}' is in the declared space; declare the space again without it, or fit it to the parts, first.",
+  "figure.text.part-is-followed": "{others} follow the size or place of '{part}'; make them their own numbers first.",
+  "figure.text.part-is-led": "{others} move with '{part}'; give them their own control first."
 }

package/translations/ja.json

@@ -710,5 +710,19 @@
   "figure.button.remove-repeat": "繰り返しをなくす",
   "figure.label.twist": "ひねり (°)",
   "figure.text.instance-size-undeclared": "図形サイズがないため、ボードでサイズを変えられません。",
-  "figure.button.declare-instance-size": "図形サイズを宣言"
+  "figure.button.declare-instance-size": "図形サイズを宣言",
+  "figure.text.candidate-cannot-open": "この候補は V2 図形で、モデラーは V3 図形しか開けないため、まだレビュー用に開けません。",
+  "figure.label.follows-plus": "加算 (mm)",
+  "figure.label.motion-travel": "移動距離",
+  "figure.label.motion-travel-mm": "自分の範囲 (mm)",
+  "figure.label.motion-travel-is": "移動距離: {part} · {axis} + {plus} mm",
+  "figure.label.align-share": "中央からの距離 — 図形サイズの比率で",
+  "figure.text.link-needs-smaller-range": "この連結で図形の {axis} が {mm} mm 未満だと {part} がなくなります。宣言された置けるサイズはそれより小さくまで開いています。",
+  "figure.button.narrow-range-from": "{axis} を {mm} mm からに絞って連結",
+  "figure.text.link-needs-larger-range": "この連結で図形の {axis} が {mm} mm を超えると描けません。宣言された置けるサイズはそれより大きくまで開いています。",
+  "figure.button.narrow-range-to": "{axis} を {mm} mm までに絞って連結",
+  "figure.text.part-holds-others": "'{part}' に {others} が付いているため削除できません。先に外してください。",
+  "figure.text.part-in-declared-space": "'{part}' は宣言された空間に含まれるため削除できません。この部品なしで空間を宣言し直すか「部品に合わせる」をしてから削除してください。",
+  "figure.text.part-is-followed": "{others} が '{part}' のサイズか位置に従っているため削除できません。先に自分の数値に変えてください。",
+  "figure.text.part-is-led": "{others} が '{part}' に連動しているため削除できません。先に自分の操作値に変えてください。"
 }

package/translations/ko.json

@@ -710,5 +710,19 @@
   "figure.button.remove-repeat": "되풀이 없애기",
   "figure.label.twist": "비틀기 (°)",
   "figure.text.instance-size-undeclared": "도형 크기가 없어 보드에서 크기를 바꿀 수 없습니다.",
-  "figure.button.declare-instance-size": "도형 크기 선언"
+  "figure.button.declare-instance-size": "도형 크기 선언",
+  "figure.text.candidate-cannot-open": "이 후보는 V2 도형이고 모델러는 V3 도형만 열 수 있어, 아직 검토하도록 열 수 없습니다.",
+  "figure.label.follows-plus": "더하기 (mm)",
+  "figure.label.motion-travel": "이동 거리",
+  "figure.label.motion-travel-mm": "제 범위 (mm)",
+  "figure.label.motion-travel-is": "이동 거리: {part} · {axis} + {plus} mm",
+  "figure.label.align-share": "가운데서 거리 — 도형 크기 비율로",
+  "figure.text.link-needs-smaller-range": "이 연결로 {part} 부품은 도형 {axis} 가 {mm} mm 보다 작으면 사라집니다. 지금 선언된 놓일 수 있는 크기는 그보다 작은 데까지 열려 있습니다.",
+  "figure.button.narrow-range-from": "{axis} 를 {mm} mm 부터로 좁히고 연결",
+  "figure.text.link-needs-larger-range": "이 연결로 도형 {axis} 가 {mm} mm 보다 크면 그릴 수 없습니다. 지금 선언된 놓일 수 있는 크기는 그보다 큰 데까지 열려 있습니다.",
+  "figure.button.narrow-range-to": "{axis} 를 {mm} mm 까지로 좁히고 연결",
+  "figure.text.part-holds-others": "'{part}' 에 {others} 이 매달려 있어 지울 수 없습니다. 먼저 떼어 주세요.",
+  "figure.text.part-in-declared-space": "'{part}' 는 선언된 공간에 들어 있어 지울 수 없습니다. 이 부품 없이 공간을 다시 선언하거나 「부품에 맞추기」를 한 뒤 지우세요.",
+  "figure.text.part-is-followed": "{others} 이 '{part}' 의 크기나 자리를 따르고 있어 지울 수 없습니다. 먼저 그 부품을 제 숫자로 바꾸세요.",
+  "figure.text.part-is-led": "{others} 이 '{part}' 를 따라 움직여 지울 수 없습니다. 먼저 제 조작값으로 바꾸세요."
 }

package/translations/ms.json

@@ -710,5 +710,19 @@
   "figure.button.remove-repeat": "buang baris",
   "figure.label.twist": "pusingan (°)",
   "figure.text.instance-size-undeclared": "rajah tiada saiz, jadi papan tidak boleh mengubah saiznya.",
-  "figure.button.declare-instance-size": "isytihar saiz rajah"
+  "figure.button.declare-instance-size": "isytihar saiz rajah",
+  "figure.text.candidate-cannot-open": "calon ini ialah rajah V2 dan pemodel hanya membuka rajah V3, jadi ia belum boleh dibuka untuk semakan.",
+  "figure.label.follows-plus": "tambah (mm)",
+  "figure.label.motion-travel": "jarak gerak",
+  "figure.label.motion-travel-mm": "julat sendiri (mm)",
+  "figure.label.motion-travel-is": "jarak gerak: {part} · {axis} + {plus} mm",
+  "figure.label.align-share": "jarak dari tengah — nisbah saiz rajah",
+  "figure.text.link-needs-smaller-range": "dengan pautan ini {part} hilang apabila {axis} rajah di bawah {mm} mm, dan saiz yang diisytihar pergi lebih rendah.",
+  "figure.button.narrow-range-from": "sempitkan {axis} dari {mm} mm dan pautkan",
+  "figure.text.link-needs-larger-range": "dengan pautan ini rajah tidak boleh dilukis apabila {axis} melebihi {mm} mm, dan saiz yang diisytihar pergi lebih tinggi.",
+  "figure.button.narrow-range-to": "sempitkan {axis} hingga {mm} mm dan pautkan",
+  "figure.text.part-holds-others": "'{part}' memegang {others}; tanggalkan dahulu.",
+  "figure.text.part-in-declared-space": "'{part}' berada dalam ruang yang diisytihar; isytihar semula ruang tanpanya, atau muatkan pada bahagian, dahulu.",
+  "figure.text.part-is-followed": "{others} mengikut saiz atau tempat '{part}'; jadikan nombor sendiri dahulu.",
+  "figure.text.part-is-led": "{others} bergerak bersama '{part}'; beri kawalan sendiri dahulu."
 }

package/translations/zh.json

@@ -710,5 +710,19 @@
   "figure.button.remove-repeat": "取消重复",
   "figure.label.twist": "扭转 (°)",
   "figure.text.instance-size-undeclared": "图形没有尺寸，看板上无法调整大小。",
-  "figure.button.declare-instance-size": "声明图形尺寸"
+  "figure.button.declare-instance-size": "声明图形尺寸",
+  "figure.text.candidate-cannot-open": "此候选为 V2 图形，而建模器只能打开 V3 图形，因此暂时无法打开以供审阅。",
+  "figure.label.follows-plus": "加 (mm)",
+  "figure.label.motion-travel": "行程",
+  "figure.label.motion-travel-mm": "自身范围 (mm)",
+  "figure.label.motion-travel-is": "行程: {part} · {axis} + {plus} mm",
+  "figure.label.align-share": "距中心 — 按图形尺寸比例",
+  "figure.text.link-needs-smaller-range": "此连接下，图形 {axis} 小于 {mm} mm 时 {part} 会消失，而声明的可放置尺寸低于此值。",
+  "figure.button.narrow-range-from": "将 {axis} 收窄为 {mm} mm 起并连接",
+  "figure.text.link-needs-larger-range": "此连接下，图形 {axis} 大于 {mm} mm 时无法绘制，而声明的可放置尺寸高于此值。",
+  "figure.button.narrow-range-to": "将 {axis} 收窄为 {mm} mm 以内并连接",
+  "figure.text.part-holds-others": "'{part}' 上挂着 {others}，无法删除。请先卸下。",
+  "figure.text.part-in-declared-space": "'{part}' 在已声明的空间内，无法删除。请先在不含它的情况下重新声明空间或「贴合部件」。",
+  "figure.text.part-is-followed": "{others} 跟随 '{part}' 的尺寸或位置，无法删除。请先改为自身数值。",
+  "figure.text.part-is-led": "{others} 跟随 '{part}' 运动，无法删除。请先改为自身控制值。"
 }

package/client/modeller/figure-ai-target.ts

@@ -1,23 +0,0 @@
-/** Explicit AI entry survives lazy creation of the app-level dock. */
-let pending: { figureId?: string; source?: unknown } | undefined
-export function requestFigureAI(target: { figureId?: string; source?: unknown }) {
-  pending = structuredClone(target)
-  window.dispatchEvent(new CustomEvent('figure-ai-target'))
-}
-export function takeFigureAITarget() {
-  const target = pending
-  pending = undefined
-  return target
-}
-
-let pendingStage: { figureId?: string; source?: any; proposal?: any } | undefined
-export function stageFigureProposal(data: { figureId?: string; source?: any; proposal?: any }) {
-  pendingStage = structuredClone(data)
-  window.dispatchEvent(new CustomEvent('figure-ai-stage', { detail: data }))
-}
-
-export function consumePendingFigureProposal() {
-  const target = pendingStage
-  pendingStage = undefined
-  return target
-}

package/dist-client/modeller/figure-ai-target.d.ts

@@ -1,18 +0,0 @@
-export declare function requestFigureAI(target: {
-    figureId?: string;
-    source?: unknown;
-}): void;
-export declare function takeFigureAITarget(): {
-    figureId?: string;
-    source?: unknown;
-} | undefined;
-export declare function stageFigureProposal(data: {
-    figureId?: string;
-    source?: any;
-    proposal?: any;
-}): void;
-export declare function consumePendingFigureProposal(): {
-    figureId?: string;
-    source?: any;
-    proposal?: any;
-} | undefined;

package/dist-client/modeller/figure-ai-target.js

@@ -1,22 +0,0 @@
-/** Explicit AI entry survives lazy creation of the app-level dock. */
-let pending;
-export function requestFigureAI(target) {
-    pending = structuredClone(target);
-    window.dispatchEvent(new CustomEvent('figure-ai-target'));
-}
-export function takeFigureAITarget() {
-    const target = pending;
-    pending = undefined;
-    return target;
-}
-let pendingStage;
-export function stageFigureProposal(data) {
-    pendingStage = structuredClone(data);
-    window.dispatchEvent(new CustomEvent('figure-ai-stage', { detail: data }));
-}
-export function consumePendingFigureProposal() {
-    const target = pendingStage;
-    pendingStage = undefined;
-    return target;
-}
-//# sourceMappingURL=figure-ai-target.js.map

package/dist-client/modeller/figure-ai-target.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"figure-ai-target.js","sourceRoot":"","sources":["../../client/modeller/figure-ai-target.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,IAAI,OAA4D,CAAA;AAChE,MAAM,UAAU,eAAe,CAAC,MAA+C;IAC7E,OAAO,GAAG,eAAe,CAAC,MAAM,CAAC,CAAA;IACjC,MAAM,CAAC,aAAa,CAAC,IAAI,WAAW,CAAC,kBAAkB,CAAC,CAAC,CAAA;AAC3D,CAAC;AACD,MAAM,UAAU,kBAAkB;IAChC,MAAM,MAAM,GAAG,OAAO,CAAA;IACtB,OAAO,GAAG,SAAS,CAAA;IACnB,OAAO,MAAM,CAAA;AACf,CAAC;AAED,IAAI,YAA6E,CAAA;AACjF,MAAM,UAAU,mBAAmB,CAAC,IAAyD;IAC3F,YAAY,GAAG,eAAe,CAAC,IAAI,CAAC,CAAA;IACpC,MAAM,CAAC,aAAa,CAAC,IAAI,WAAW,CAAC,iBAAiB,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAA;AAC5E,CAAC;AAED,MAAM,UAAU,4BAA4B;IAC1C,MAAM,MAAM,GAAG,YAAY,CAAA;IAC3B,YAAY,GAAG,SAAS,CAAA;IACxB,OAAO,MAAM,CAAA;AACf,CAAC","sourcesContent":["/** Explicit AI entry survives lazy creation of the app-level dock. */\nlet pending: { figureId?: string; source?: unknown } | undefined\nexport function requestFigureAI(target: { figureId?: string; source?: unknown }) {\n  pending = structuredClone(target)\n  window.dispatchEvent(new CustomEvent('figure-ai-target'))\n}\nexport function takeFigureAITarget() {\n  const target = pending\n  pending = undefined\n  return target\n}\n\nlet pendingStage: { figureId?: string; source?: any; proposal?: any } | undefined\nexport function stageFigureProposal(data: { figureId?: string; source?: any; proposal?: any }) {\n  pendingStage = structuredClone(data)\n  window.dispatchEvent(new CustomEvent('figure-ai-stage', { detail: data }))\n}\n\nexport function consumePendingFigureProposal() {\n  const target = pendingStage\n  pendingStage = undefined\n  return target\n}\n"]}

package/test/ai-target.test.ts

@@ -1,25 +0,0 @@
-import assert from 'node:assert/strict'
-import { test } from 'node:test'
-import { requestFigureAI, takeFigureAITarget } from '../client/modeller/figure-ai-target.ts'
-
-test('AI 진입은 늦게 생성되는 Dock에도 복제된 원본을 한 번 전달한다', () => {
-  const oldWindow = globalThis.window
-  globalThis.window = new EventTarget() as any
-  try {
-    const source = { type: 'TEST', parts: [{ name: 'cube', size: { y: 100 } }] }
-    requestFigureAI({ figureId: 'a', source })
-    source.parts[0].size.y = 200
-    assert.equal((takeFigureAITarget()?.source as any).parts[0].size.y, 100)
-    assert.equal(takeFigureAITarget(), undefined)
-  } finally { globalThis.window = oldWindow }
-})
-
-test('연속된 명시적 진입에서는 최신 대상만 지연 Dock에 전달한다', () => {
-  const oldWindow = globalThis.window
-  globalThis.window = new EventTarget() as any
-  try {
-    requestFigureAI({ figureId: 'a' })
-    requestFigureAI({ figureId: 'b' })
-    assert.equal(takeFigureAITarget()?.figureId, 'b')
-  } finally { globalThis.window = oldWindow }
-})