@things-factory/figure-ui 10.1.210 → 10.1.211

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@things-factory/figure-ui",
-  "version": "10.1.210",
+  "version": "10.1.211",
   "publishConfig": {
     "access": "public",
     "@things-factory:registry": "https://registry.npmjs.org"
@@ -48,5 +48,5 @@
     "@things-factory/setting-base": "^10.1.208",
     "three": "^0.185.1"
   },
-  "gitHead": "89fbda12d43d8532ba4e95ba6d6d7e05e2da2502"
+  "gitHead": "1b781d2bbb963380eda73ab7020091987393de37"
 }

package/test/browser/editing.check.mjs

@@ -374,6 +374,44 @@ describe('values in hand on the properties tab: drawn at once, written on change
   })
 })
 
+/* A size of the part's own on the 「배치」 tab's size editor is a value in hand as any field is (user 2026-09-24). */
+describe('a size in hand on the arrangement tab: drawn while typed or dragged, written once', () => {
+  const WIDTH = 'box X figure.label.size-measure'
+  const wide = async () => Math.round((await look('box')).size[0])
+  let was
+  before(async () => {
+    await mount('box')
+    await pick('box')
+    await click(await read(() => probe.tab('figure.label.tab-arrangement')))
+  })
+
+  test('a width typed is drawn while it is typed, and written once on Enter', async () => {
+    was = await wide()
+    const start = await revision()
+    await type(WIDTH, '700')
+    assert.equal(await wide(), 700, 'drawn 700 wide while typed')
+    assert.equal(await revision(), start, 'nothing written yet')
+    await page().keyboard.press('Enter')
+    await sleep(400)
+    assert.equal(await revision(), start + 1)
+    assert.equal(await read(() => probe.value('box.size.x')), 700)
+    await press(...UNDO)
+    assert.equal(await wide(), was, 'undone, drawn as it stands')
+  })
+
+  test('its label dragged sideways scrubs the width: drawn while held, one step on release', async () => {
+    const start = await revision()
+    const label = await read(id => editing.fieldLabel(id), WIDTH)
+    assert.ok(label, 'the X of the size editor')
+    const held = await drag(label, 60, async () => ({ drawn: await wide(), shown: await read(id => editing.fieldValue(id), WIDTH), revision: await revision() }))
+    assert.notEqual(held.drawn, was, 'drawn while held')
+    assert.equal(String(held.drawn), held.shown, 'the field follows what is drawn')
+    assert.equal(held.revision, start, 'nothing written while held')
+    assert.equal(await revision(), start + 1, 'the release is one step')
+    assert.equal(await read(() => probe.value('box.size.x')), held.drawn)
+  })
+})
+
 describe('the pose sliders: drawn while dragged, one step on release; the pose kept as the default (user 2026-09-24)', () => {
   before(async () => {
     await mount('six-axis')

package/test/browser/modeller.check.mjs

@@ -630,6 +630,61 @@ describe('a motion is changed where it is (2026-09-25)', () => {
     assert.equal(now.motion[0].upperLimit, 45, 'the new limit')
     assert.equal(now.id, was.id, 'the same joint')
   })
+
+  /* A joint is a list of axes (ADR-0159): one more is added where the motion is said, and taken away again. */
+  const jointOf = part => read(part => (JSON.parse(document.querySelector('figure-editor').session.source()).joints ?? []).find(j => j.body1.part === part) ?? null, part)
+  const button = async (text, attribute) =>
+    page().evaluate(
+      (text, attribute) => {
+        const deep = (root = document) => [...root.querySelectorAll('button')].concat(...[...root.querySelectorAll('*')].filter(e => e.shadowRoot).map(e => deep(e.shadowRoot)))
+        const b = deep().find(x => x.textContent.includes(text) && (!attribute || x.hasAttribute(attribute)))
+        if (!b) return null
+        b.scrollIntoView({ block: 'center' })
+        const r = b.getBoundingClientRect()
+        return { x: r.left + r.width / 2, y: r.top + r.height / 2 }
+      },
+      text,
+      attribute
+    )
+  const rows = () =>
+    page().evaluate(() => {
+      const deep = (root = document) => [...root.querySelectorAll('div[motion-axis]')].concat(...[...root.querySelectorAll('*')].filter(e => e.shadowRoot).map(e => deep(e.shadowRoot)))
+      return deep().length
+    })
+
+  test('an axis added to the shoulder: one step, after the first, on an axis the first does not use, with a control of its own', async () => {
+    const was = await jointOf('upper-arm')
+    await click(await button('figure.button.add-axis', 'add-axis'), 'add an axis')
+    const start = await state()
+    await click(await button('figure.button.add-axis'), 'the form\'s add-axis')
+    const after = await state()
+    assert.equal(after.error, '', 'not refused')
+    assert.equal(after.revision, start.revision + 1, 'one step')
+    const now = await jointOf('upper-arm')
+    assert.equal(now.motion.length, 2)
+    assert.deepEqual(now.motion[0], was.motion[0], 'the first axis as it was')
+    assert.notEqual(now.motion[1].axis, now.motion[0].axis, 'another axis')
+    assert.equal(now.motion[1].state.id, 'upper-arm-turn-2')
+    assert.equal(await rows(), 2, 'a row an axis')
+  })
+
+  test('the second axis taken away: one step, the first as it was', async () => {
+    const was = await jointOf('upper-arm')
+    const start = await state()
+    const removes = await page().evaluate(() => {
+      const deep = (root = document) => [...root.querySelectorAll('button[remove-axis]')].concat(...[...root.querySelectorAll('*')].filter(e => e.shadowRoot).map(e => deep(e.shadowRoot)))
+      const b = deep()[1]
+      if (!b) return null
+      b.scrollIntoView({ block: 'center' })
+      const r = b.getBoundingClientRect()
+      return { x: r.left + r.width / 2, y: r.top + r.height / 2 }
+    })
+    await click(removes, 'remove the second axis')
+    assert.equal((await state()).revision, start.revision + 1, 'one step')
+    const now = await jointOf('upper-arm')
+    assert.deepEqual(now.motion, [was.motion[0]], 'the first axis alone, as it was')
+    assert.equal(await rows(), 1)
+  })
 })
 
 describe('the modeller made easier to find and to keep (2026-09-26 baseline)', () => {

package/test/links.test.ts

@@ -703,3 +703,42 @@ test('a follower of several leaders and a stroke that is a sum of lengths are wr
   assert.equal(slide.travel, '')
   assert.deepEqual(motionJoint(reach, slide, 'wrist').motion![0]!.travel, reach.motion[0]!.travel, 'saving keeps the summed stroke')
 })
+
+test('어깨는 축 둘 — 축 추가는 쓰지 않은 축으로 시작하고, 고쳐도 다른 축은 그대로, 같은 관절의 다른 축을 따를 수 있고, 축을 빼도 남은 축의 조작값 이름은 그대로 (ADR-0159)', async () => {
+  const { leadersFor, motionJoint, motionFormOf, motionOf, withoutAxis, controlIdFor } = await import('../client/modeller/links.ts')
+  const { compileFigureAsset, motionIdOf } = await import('@hatiolab/figure-model')
+  let asset = createFigureAsset('Shoulder')
+  asset = addFigureBox(asset, { id: 'body', size: { x: 300, y: 400, z: 200 }, position: { x: 0, y: 200, z: 0 } })
+  asset = addFigureBox(asset, { id: 'arm', size: { x: 60, y: 300, z: 60 }, position: { x: 0, y: 550, z: 0 } })
+  asset = applyFigureAuthoring(asset, { kind: 'attach', part: 'body', to: { plane: 'mounting-plane' } })
+  asset = applyFigureAuthoring(asset, { kind: 'attach', part: 'arm', to: { part: 'body', face: 'top' } })
+  const jointOf = () => asset.joints!.find(j => j.body1.part === 'arm')!
+  asset = applyFigureAuthoring(asset, { kind: 'set-joint', joint: motionJoint(jointOf(), { ...motionFormOf(jointOf()), kind: 'turn', axis: 'x', id: 'pitch', min: -60, max: 180 }, 'arm') })
+
+  const fresh = motionFormOf(jointOf(), 1)
+  assert.deepEqual([fresh.kind, fresh.axis, fresh.id, fresh.min, fresh.max], ['turn', 'y', '', -90, 90], '새 축은 쓰지 않은 축의 돎')
+  asset = applyFigureAuthoring(asset, { kind: 'set-joint', joint: motionJoint(jointOf(), fresh, 'arm', 1) })
+  assert.equal(jointOf().motion!.length, 2)
+  assert.equal(controlIdFor('arm', 'turn', 1), 'arm-turn-2')
+  assert.deepEqual(motionOf(asset, 'arm', 1), { kind: 'turn', axis: 'y', control: { id: 'arm-turn-2', unit: 'deg', min: -90, max: 90 } }, '둘째 축은 기록대로 읽는다')
+  assert.equal(motionOf(asset, 'arm')?.control?.id, 'pitch', '첫 축은 그대로')
+
+  asset = applyFigureAuthoring(asset, { kind: 'set-joint', joint: motionJoint(jointOf(), { ...motionFormOf(jointOf(), 1), min: -30, max: 30 }, 'arm', 1) })
+  assert.deepEqual([jointOf().motion![0]!.lowerLimit, jointOf().motion![0]!.upperLimit, jointOf().motion![1]!.lowerLimit], [-60, 180, -30], '둘째 축만 바뀐다')
+
+  /* The second axis turns the arm about Y, on top of the first. */
+  const turned = (state: Record<string, number>) => compileFigureAsset(asset).evaluate(state).geometry.find(g => g.id === 'arm')!.pose.r
+  assert.notDeepEqual(turned({ 'arm-turn-2': 30 }), turned({}))
+
+  assert.deepEqual(leadersFor(asset, 'arm', 'turn', motionIdOf(jointOf(), 1)).map(a => a.id), ['arm'], '같은 관절의 첫 축은 따를 수 있다')
+  assert.deepEqual(leadersFor(asset, 'arm', 'turn', motionIdOf(jointOf(), 0)).map(a => a.id), ['arm.2'], '제 축은 고르지 않는다')
+
+  asset = applyFigureAuthoring(asset, { kind: 'set-joint', joint: motionJoint(jointOf(), { ...motionFormOf(jointOf(), 2), id: 'roll' }, 'arm', 2) })
+  asset = applyFigureAuthoring(asset, { kind: 'set-joint', joint: withoutAxis(jointOf(), 0) })
+  assert.deepEqual(
+    jointOf().motion!.map(a => [a.id, a.state?.id]),
+    [['arm.2', 'arm-turn-2'], ['arm.3', 'roll']],
+    '앞 축을 빼도 뒤 축은 제 이름과 조작값을 지킨다'
+  )
+  assert.notDeepEqual(turned({ 'arm-turn-2': 30 }), turned({}), '남은 축은 같은 조작값으로 움직인다')
+})

package/translations/en.json

@@ -594,6 +594,9 @@
   "figure.label.control-start": "start",
   "figure.label.travel-follows": "travel follows",
   "figure.button.add-motion": "Add motion",
+  "figure.button.add-axis": "Add axis",
+  "figure.button.remove-axis": "Remove axis",
+  "figure.label.motion-axis-n": "Axis {n}",
   "figure.button.remove-motion": "Remove motion",
   "figure.label.room": "Room it takes up",
   "figure.text.room-explained": "Bounds computed from the parts are a proposal. Nothing is declared until you confirm, and a declaration never widens on its own.",

package/translations/es.json

@@ -594,6 +594,9 @@
   "figure.label.control-start": "inicio",
   "figure.label.travel-follows": "el recorrido sigue a",
   "figure.button.add-motion": "Añadir movimiento",
+  "figure.button.add-axis": "Añadir eje",
+  "figure.button.remove-axis": "Quitar eje",
+  "figure.label.motion-axis-n": "Eje {n}",
   "figure.button.remove-motion": "Quitar movimiento",
   "figure.label.room": "Espacio que ocupa",
   "figure.text.room-explained": "Los límites calculados a partir de las piezas son una propuesta. No se declara nada hasta que lo confirme, y una declaración nunca se amplía por sí sola.",

package/translations/ja.json

@@ -594,6 +594,9 @@
   "figure.label.control-start": "start",
   "figure.label.travel-follows": "travel follows",
   "figure.button.add-motion": "Add motion",
+  "figure.button.add-axis": "軸を追加",
+  "figure.button.remove-axis": "軸を削除",
+  "figure.label.motion-axis-n": "軸 {n}",
   "figure.button.remove-motion": "Remove motion",
   "figure.label.room": "Room it takes up",
   "figure.text.room-explained": "Bounds computed from the parts are a proposal. Nothing is declared until you confirm, and a declaration never widens on its own.",

package/translations/ko.json

@@ -594,6 +594,9 @@
   "figure.label.control-start": "시작값",
   "figure.label.travel-follows": "이동 거리가 따르는 것",
   "figure.button.add-motion": "움직임 추가",
+  "figure.button.add-axis": "축 추가",
+  "figure.button.remove-axis": "축 삭제",
+  "figure.label.motion-axis-n": "축 {n}",
   "figure.button.remove-motion": "움직임 삭제",
   "figure.label.room": "차지하는 공간",
   "figure.text.room-explained": "부품에서 계산한 경계는 권장 범위입니다. 확인 후 공간 선언에 반영됩니다. 모델을 변경해도 선언된 범위는 자동으로 확장되지 않습니다.",

package/translations/ms.json

@@ -594,6 +594,9 @@
   "figure.label.control-start": "start",
   "figure.label.travel-follows": "travel follows",
   "figure.button.add-motion": "Add motion",
+  "figure.button.add-axis": "Tambah paksi",
+  "figure.button.remove-axis": "Buang paksi",
+  "figure.label.motion-axis-n": "Paksi {n}",
   "figure.button.remove-motion": "Remove motion",
   "figure.label.room": "Room it takes up",
   "figure.text.room-explained": "Bounds computed from the parts are a proposal. Nothing is declared until you confirm, and a declaration never widens on its own.",

package/translations/zh.json

@@ -594,6 +594,9 @@
   "figure.label.control-start": "start",
   "figure.label.travel-follows": "travel follows",
   "figure.button.add-motion": "Add motion",
+  "figure.button.add-axis": "添加轴",
+  "figure.button.remove-axis": "删除轴",
+  "figure.label.motion-axis-n": "轴 {n}",
   "figure.button.remove-motion": "Remove motion",
   "figure.label.room": "Room it takes up",
   "figure.text.room-explained": "Bounds computed from the parts are a proposal. Nothing is declared until you confirm, and a declaration never widens on its own.",