@things-factory/figure-ui 10.1.271 → 10.1.272

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@things-factory/figure-ui",
-  "version": "10.1.271",
+  "version": "10.1.272",
   "publishConfig": {
     "access": "public",
     "@things-factory:registry": "https://registry.npmjs.org"
@@ -42,11 +42,11 @@
     "@operato/slot-layout-editor": "^10.29.58",
     "@operato/styles": "^10.0.0",
     "@operato/utils": "^10.29.43",
-    "@things-factory/ai-assistant": "^10.1.271",
-    "@things-factory/figure-service": "^10.1.271",
+    "@things-factory/ai-assistant": "^10.1.272",
+    "@things-factory/figure-service": "^10.1.272",
     "@things-factory/figure-viewer": "^10.1.266",
     "@things-factory/setting-base": "^10.1.271",
     "three": "^0.185.1"
   },
-  "gitHead": "843bc2608d8c89348ced871777535966758927db"
+  "gitHead": "f87fefe0687eedf52a25cda1c54d59efabaf3dc2"
 }

package/test/browser/editing.check.mjs

@@ -353,7 +353,7 @@ describe('the material: colours by purpose, one step each, a glow drawn while dr
   test('a diameter typed on the arrangement tab is written once when it is left, as the radius it halves to', async () => {
     await click(await read(() => probe.tab('figure.label.tab-short-response')))
     const start = await revision()
-    await type('drum X · figure.label.size-diameter figure.label.size-measure', '600')
+    await type('drum X·Z · figure.label.size-diameter figure.label.size-measure', '600')
     assert.equal(await revision(), start, 'nothing written yet')
     await page().keyboard.press('Enter')
     await sleep(400)
@@ -514,7 +514,8 @@ describe('a clip scrubbed and keyed (2026-09-24)', () => {
   const typeInClips = async (label, text) => {
     const field = await page().evaluateHandle(label => {
       const deep = (root = document) => [...root.querySelectorAll('input')].concat(...[...root.querySelectorAll('*')].filter(e => e.shadowRoot).map(e => deep(e.shadowRoot)))
-      return deep().find(i => i.type === 'number' && i.getAttribute('aria-label') === label && i.getRootNode().host?.localName === 'figure-clips') ?? null
+      /* The clip's own field, not the pose bar's above the clips: the bar keys the clip last scrubbed (tutorial 2026-11-12). */
+      return deep().find(i => i.type === 'number' && i.getAttribute('aria-label') === label && i.getRootNode().host?.localName === 'figure-clips' && !i.closest('div[pose-bar]')) ?? null
     }, label)
     assert.ok(await field.evaluate(i => !!i), `${label} in the clips`)
     await field.evaluate(i => i.scrollIntoView({ block: 'center' }))
@@ -576,12 +577,12 @@ describe('a track moved round its loop, a clip copied (robot dog 2026-11-03)', (
     await button.click()
   }
 
-  test('a clip in a group is copied in one step; one in none is not offered', async () => {
-    /* The left door's clip is in no group, the right one's is in one. */
+  test('a clip in a group is copied in one step; one in none is offered too, and makes its group (review 2026-11-11)', async () => {
+    /* The left door's clip is in no group, the right one's is in one: both may be copied now. */
     assert.equal(await read(() => {
       const deep = (root = document) => [...root.querySelectorAll('button[copy-clip]')].concat(...[...root.querySelectorAll('*')].filter(e => e.shadowRoot).map(e => deep(e.shadowRoot)))
       return deep().map(b => b.disabled).join()
-    }), 'true,false')
+    }), 'false,false')
     const start = await revision()
     await pressIn('button[copy-clip]', 1)
     await until(async () => (await revision()) === start + 1, 'one step')

package/test/browser/section.check.mjs

@@ -748,6 +748,27 @@ describe('the fastening drawing in the fastening window', () => {
     assert.deepEqual(joint.body0, { part: 'frame', face: 'front' })
     assert.deepEqual([joint.body1, joint.origin?.facing], [{ part: 'leaf' }, 'meet'], 'set on the front by its real shape (ADR-0140 3.2)')
   })
+
+  /* Tutorial 2026-11-11: the field a size opened did not take the keys; 600 typed and Enter fastened the part where it was. */
+  test('a size pressed in the drawing opens its field with the keys in it: typed and Enter moves the part there, the window stays', async () => {
+    await change()
+    await until(() => !!findDeep('text[dim]', { within: 'figure-fasten-drawing' }), 'a size in the drawing')
+    const start = await state()
+    await press('text[dim]', { within: 'figure-fasten-drawing' })
+    await until(() => {
+      const field = findDeep('div[where] input', { within: 'figure-fasten-drawing' })
+      return !!field && field.getRootNode().activeElement === field
+    }, 'the size\'s field, with the keys in it')
+    await page().keyboard.type('37')
+    await page().keyboard.press('Enter')
+    await sleep(300)
+    assert.ok(await read(() => !!probe.fastenTargets()), 'the window stays open')
+    assert.equal((await state()).revision, start.revision, 'nothing written before 적용')
+    await press('[apply]', { within: 'figure-fasten-dialog' })
+    await until(r => probe.state().revision === r + 1, 'one step', start.revision)
+    const align = (await read(() => probe.fastening('leaf'))).origin?.align ?? {}
+    assert.ok(Object.values(align).some(a => a?.mm === 37), `the typed size: ${JSON.stringify(align)}`)
+  })
 })
 
 describe('the face choice: asked where the edit was made, and the same edit goes again with it', () => {

package/test/clips.test.ts

@@ -93,7 +93,7 @@ test('a track copied onto another control a while later; a clip copy takes a fre
 })
 
 /* Review 2026-11-09: a track starts from the pose, a pose is kept in one step, a clip on a played control joins a group. */
-import { newClipEdits, newTrackKeys, rememberedPoseEdits } from '../client/modeller/clips.ts'
+import { copyClipEdits, newClipEdits, newTrackKeys, rememberedPoseEdits } from '../client/modeller/clips.ts'
 
 const applied = (asset: FigureAsset, edits: unknown[]) => edits.reduce<FigureAsset>((a, e) => editFigurePart(a, e as never), asset)
 
@@ -103,7 +103,7 @@ test('새 트랙은 지금 자세를 처음부터 끝까지 유지 — 범위
   assert.deepEqual(newTrackKeys({ min: 5, max: 9 }, undefined, 2), [{ seconds: 0, value: 5 }, { seconds: 2, value: 5 }], '값을 모르면 범위의 시작')
   /* The panel's wiring: the default button holds the pose, the range one is the preset. */
   const panel = read('../client/modeller/figure-clips.ts')
-  assert.match(panel, /newTrackKeys\(input!, this\.values\[stateId!\], duration\)\)/)
+  assert.match(panel, /newTrackKeys\(input!, this\.values\[stateId!\], duration\), 'smooth'\)/)
   assert.match(panel, /newTrackKeys\(input!, this\.values\[stateId!\], duration, 'range'\)/)
   /* Several edits go up as one step, and the editor applies them as one. */
   assert.match(read('../client/modeller/editor.ts'), /<figure-clips[\s\S]*?@part-edits=\$\{\(e: CustomEvent\) => this\.run\(\(\) => this\.session!\.applyRecipe\(e\.detail\.edits\)\)\}[\s\S]*?<\/figure-clips>/)
@@ -128,13 +128,36 @@ test('재생 중인 조작값에 새 클립 — 그룹 없는 클립과 새 동
   assert.deepEqual(applied(grouped, half.edits).motionGroups!.map(g => g.clips), [['닫기', '열기', '반열기']])
 })
 
+test('이 자세 기억하기 — 되풀이 트랙의 처음과 끝은 한 순간: 둘 중 어디서 기억해도 두 키가 함께 바뀐다', () => {
+  const asset = editFigurePart(machine(), { kind: 'set-driver', state: 'shift', clip: 'walk', duration: 4, keys: [{ seconds: 0, value: 0 }, { seconds: 2, value: 60 }, { seconds: 4, value: 0 }] })
+  const keysOf = (a: FigureAsset) => clipsOf(a)[0]!.tracks[0]!.keys
+  assert.equal(clipsOf(asset)[0]!.tracks[0]!.loop, 'wrap')
+
+  /* Kept at the end: the end reads as the start, yet the pose is kept -- at both ends, so the loop does not jump. */
+  const atEnd = rememberedPoseEdits(asset, 'walk', 4, { shift: 20, spin: 0 }, { shift: 0, spin: 0 })
+  assert.equal(atEnd.edits.length, 1)
+  assert.deepEqual(keysOf(applied(asset, atEnd.edits)), [{ seconds: 0, value: 20 }, { seconds: 2, value: 60 }, { seconds: 4, value: 20 }])
+
+  /* Kept at 0: the end key follows. */
+  const atStart = rememberedPoseEdits(asset, 'walk', 0, { shift: 10, spin: 0 }, { shift: 0, spin: 0 })
+  assert.deepEqual(keysOf(applied(asset, atStart.edits)), [{ seconds: 0, value: 10 }, { seconds: 2, value: 60 }, { seconds: 4, value: 10 }])
+
+  /* Both ends already there: nothing to keep. */
+  assert.deepEqual(rememberedPoseEdits(asset, 'walk', 4, { shift: 0, spin: 0 }, { shift: 0, spin: 0 }).edits, [])
+
+  /* A loop left open on purpose -- a ramp that starts over -- keeps its other end. */
+  const ramp = editFigurePart(machine(), { kind: 'set-driver', state: 'shift', clip: 'walk', duration: 4, keys: [{ seconds: 0, value: 0 }, { seconds: 4, value: 60 }] })
+  assert.deepEqual(keysOf(applied(ramp, rememberedPoseEdits(ramp, 'walk', 4, { shift: 50, spin: 0 }, { shift: 0, spin: 0 }).edits)), [{ seconds: 0, value: 0 }, { seconds: 4, value: 50 }])
+  assert.deepEqual(keysOf(applied(ramp, rememberedPoseEdits(ramp, 'walk', 0, { shift: 10, spin: 0 }, { shift: 0, spin: 0 }).edits)), [{ seconds: 0, value: 10 }, { seconds: 4, value: 60 }])
+})
+
 test('이 자세 기억하기 — 바뀐 조작값만, 한 묶음으로; 다른 동작이 쓰는 조작값은 이름만', () => {
   const asset = editFigurePart(machine(), { kind: 'set-driver', state: 'shift', clip: 'cycle', duration: 4, keys: [{ seconds: 0, value: 0 }, { seconds: 4, value: 60 }] })
   const base = { shift: 30, spin: 0 }
   /* At 2 s the clip has shift at 30: unchanged, no key. spin moved to 45 since: a new track from 0 to 45 at 2 s. */
   const kept = rememberedPoseEdits(asset, 'cycle', 2, { shift: 30, spin: 45 }, base)
   assert.deepEqual(kept.skipped, [])
-  assert.deepEqual(kept.edits, [{ kind: 'set-driver', state: 'spin', clip: 'cycle', keys: [{ seconds: 0, value: 0 }, { seconds: 2, value: 45 }] }])
+  assert.deepEqual(kept.edits, [{ kind: 'set-driver', state: 'spin', clip: 'cycle', keys: [{ seconds: 0, value: 0 }, { seconds: 2, value: 45 }], interpolation: 'smooth' }])
   const after = applied(asset, kept.edits)
   assert.equal(poseAt(after, 'cycle', 2).find(c => c.input === 'spin')!.value, 45)
 
@@ -148,7 +171,7 @@ test('이 자세 기억하기 — 바뀐 조작값만, 한 묶음으로; 다른
   assert.deepEqual(rememberedPoseEdits(after, 'cycle', 2, { shift: 30, spin: 45 }, { shift: 30, spin: 45 }).edits, [])
 
   /* At 0 a new track holds the pose throughout. */
-  assert.deepEqual(rememberedPoseEdits(asset, 'cycle', 0, { shift: 0, spin: 10 }, base).edits, [{ kind: 'set-driver', state: 'spin', clip: 'cycle', keys: [{ seconds: 0, value: 10 }, { seconds: 4, value: 10 }] }])
+  assert.deepEqual(rememberedPoseEdits(asset, 'cycle', 0, { shift: 0, spin: 10 }, base).edits, [{ kind: 'set-driver', state: 'spin', clip: 'cycle', keys: [{ seconds: 0, value: 10 }, { seconds: 4, value: 10 }], interpolation: 'smooth' }])
 
   /* spin played by another clip in no group: not taken, named. */
   const other = editFigurePart(asset, { kind: 'set-driver', state: 'spin', clip: 'turn', duration: 2, keys: [{ seconds: 0, value: 0 }, { seconds: 2, value: 90 }] })
@@ -174,3 +197,25 @@ test('키 사이 움직임 — 트랙마다 일정한 속도 · 부드럽게 ·
   assert.match(panel, /\['linear', 'smooth', 'step'\] as const/)
   assert.match(panel, /\?disabled=\$\{this\.locked \|\| same \|\| !!fits\}/)
 })
+
+test('a clip in no group is copied in one step: a group is made with a name of its own, and both are in it (review 2026-11-11)', () => {
+  const asset = editFigurePart(machine(), { kind: 'set-driver', state: 'shift', clip: 'walk', duration: 4, keys: [{ seconds: 0, value: 0 }, { seconds: 2, value: 60 }, { seconds: 4, value: 0 }] })
+  const after = applied(asset, copyClipEdits(asset, 'walk'))
+  assert.deepEqual(clipsOf(after).map(c => c.name), ['walk', 'walk-copy'])
+  assert.deepEqual(after.motionGroups!.map(g => [g.label, g.clips, g.defaultClip]), [['motion', ['walk', 'walk-copy'], 'walk']])
+  /* A second group takes the next free name. */
+  const taken = { ...asset, motionGroups: [{ id: 'motion', label: 'motion', clips: ['lift'], defaultClip: 'lift', transitionSeconds: 0.2 }] }
+  assert.equal((copyClipEdits(taken, 'walk', 'motion')[0] as { group: { label: string } }).group.label, 'motion 2')
+  /* Already in a group: only the copy. */
+  assert.equal(copyClipEdits(after, 'walk').length, 1)
+})
+
+test('a clip lists its tracks in the order of the controls, however its drivers were last written (tutorial 2026-11-12)', () => {
+  const keys = [{ seconds: 0, value: 0 }, { seconds: 2, value: 10 }]
+  let asset = editFigurePart(machine(), { kind: 'set-driver', state: 'shift', clip: 'walk', duration: 2, keys })
+  asset = editFigurePart(asset, { kind: 'set-driver', state: 'spin', clip: 'walk', duration: 2, keys })
+  /* The first track keyed again: its driver is written anew. */
+  const shift = clipsOf(asset)[0]!.tracks.find(t => t.state === 'shift')!
+  asset = editFigurePart(asset, trackEdit(clipsOf(asset)[0]!, shift, { keys: withKey(shift.keys, { seconds: 1, value: 5 }) }) as never)
+  assert.deepEqual(clipsOf(asset)[0]!.tracks.map(t => t.state), ['shift', 'spin'])
+})

package/test/fasten-form.test.ts

@@ -204,6 +204,23 @@ test("pressed on the canvas: the face or the point pressed, read in that part's
   assert.deepEqual([corner.note, corner.form?.target], ['aim-not-here', 'soft'], 'a rounded corner: aimed at the part, said')
 })
 
+test('a part still where the palette put it goes to the centre of the face; one the author moved keeps its place across it (review 2026-11-11)', () => {
+  /* A thigh 85 mm left of the middle of a pelvis 880 mm up; a shin and an arm added from the palette at (0, 50, 0). */
+  let a = fasten(box(createFigureAsset('Humanoid'), 'pelvis', [300, 180, 200], [0, 970, 0]), 'pelvis', 'plane', { gap: 880 })
+  a = applyFigureAuthoring(box(a, 'thigh', [130, 420, 140], [-85, 670, 0]), { kind: 'attach', part: 'thigh', to: { part: 'pelvis', face: 'bottom' }, facing: 'meet', align: { x: { mm: -85 } } } as never)
+  a = box(box(a, 'shin', [110, 420, 120], [0, 50, 0]), 'arm', [90, 300, 90], [0, 50, 0])
+  const r = revisionOf(a)
+  const shin = aimFasten(r, 'shin', fastenFormOf(r, 'shin'), { part: 'thigh' })
+  const onBottom = aimFasten(r, 'shin', shin, { targetFace: 'bottom' })
+  assert.deepEqual([onBottom.align, onBottom.alignMm], [{}, {}], 'on the centre of the thigh, not 85 mm off it')
+  const arm = aimFasten(r, 'arm', aimFasten(r, 'arm', fastenFormOf(r, 'arm'), { part: 'pelvis' }), { targetFace: 'left' })
+  assert.deepEqual([arm.align, arm.alignMm], [{}, {}], 'on the side, not 920 mm below it')
+  /* Moved by the author first, it keeps where it stands across the face. */
+  const moved = revisionOf(box(a, 'tag', [40, 40, 40], [-60, 500, 30]))
+  const kept = aimFasten(moved, 'tag', aimFasten(moved, 'tag', fastenFormOf(moved, 'tag'), { part: 'thigh' }), { targetFace: 'bottom' })
+  assert.deepEqual(kept.alignMm, { x: 25, z: 30 })
+})
+
 test('a part still where the palette put it is fastened on the face; one the author moved keeps its place (tutorial 2026-11-11)', () => {
   /* A body on the floor; a mast added from the palette stands inside it, at the palette's place (0, 50, 0). */
   let a = fasten(box(createFigureAsset('Fork AGV'), 'body', [1000, 300, 700], [0, 150, 0]), 'body', 'plane')
@@ -216,3 +233,30 @@ test('a part still where the palette put it is fastened on the face; one the aut
   const kept = keptGapOf(moved, 'mast', aimFasten(moved, 'mast', fastenFormOf(moved, 'mast'), { part: 'body' }))
   assert.equal(kept.gap, 50, 'the 50 mm its bottom stands above the body')
 })
+
+test('aimed at a part, the form starts on a face nothing is fastened to yet (review 2026-11-11)', () => {
+  let a = fasten(box(createFigureAsset('Humanoid'), 'pelvis', [300, 180, 200], [0, 970, 0]), 'pelvis', 'plane', { gap: 880 })
+  a = applyFigureAuthoring(box(a, 'torso', [340, 500, 200], [0, 50, 0]), { kind: 'attach', part: 'torso', to: { part: 'pelvis', face: 'top' } } as never)
+  a = box(a, 'thigh', [130, 420, 140], [0, 50, 0])
+  const r = revisionOf(a)
+  const thigh = aimFasten(r, 'thigh', fastenFormOf(r, 'thigh'), { part: 'pelvis' })
+  assert.equal(thigh.targetFace, 'bottom', 'across from the top, where the body stands')
+  assert.equal(aimFasten(r, 'torso', fastenFormOf(r, 'torso'), { part: 'pelvis' }).targetFace, 'top', 'a part keeps the face it is fastened to')
+  const head = aimFasten(r, 'thigh', fastenFormOf(r, 'thigh'), { part: 'torso' })
+  assert.equal(head.targetFace, 'top', 'a free top is taken as asked')
+  /* A shin aimed at a thigh hung under the pelvis: the thigh's top touches the pelvis, so the shin goes under it. */
+  let b = applyFigureAuthoring(a, { kind: 'attach', part: 'thigh', to: { part: 'pelvis', face: 'bottom' } } as never)
+  b = box(b, 'shin', [110, 420, 120], [0, 50, 0])
+  const rb = revisionOf(b)
+  assert.equal(aimFasten(rb, 'shin', fastenFormOf(rb, 'shin'), { part: 'thigh' }).targetFace, 'bottom')
+  /* A forearm aimed at an upper arm hung by its side from the torso: on down, under the arm (tutorial run 2026-11-12). */
+  let c = applyFigureAuthoring(box(a, 'upperarm', [90, 300, 90], [0, 50, 0]), { kind: 'attach', part: 'upperarm', to: { part: 'torso', face: 'left' } } as never)
+  c = box(c, 'forearm', [80, 280, 80], [0, 50, 0])
+  const rc = revisionOf(c)
+  assert.equal(aimFasten(rc, 'forearm', fastenFormOf(rc, 'forearm'), { part: 'upperarm' }).targetFace, 'bottom')
+  /* A flat part hung by its side is not a limb: what goes on it keeps the face asked. */
+  let d = applyFigureAuthoring(box(a, 'shelf', [300, 40, 200], [0, 50, 0]), { kind: 'attach', part: 'shelf', to: { part: 'torso', face: 'left' } } as never)
+  d = box(d, 'cup', [60, 80, 60], [0, 50, 0])
+  const rd = revisionOf(d)
+  assert.equal(aimFasten(rd, 'cup', fastenFormOf(rd, 'cup'), { part: 'shelf' }).targetFace, 'top')
+})

package/test/first-save.test.ts

@@ -5,7 +5,7 @@ import { test } from 'node:test'
 import assert from 'node:assert/strict'
 
 import { placeholderType } from '@hatiolab/figure-model'
-import { firstSaveRefusalOf, releasableType, typeOf } from '../client/modeller/first-save.ts'
+import { firstSaveRefusalOf, releasableType, typeOf, typingTypeOf } from '../client/modeller/first-save.ts'
 import { createFigureProductSession, type FigureProductStore } from '../client/modeller/product-session.ts'
 
 test('치는 대로 타입의 모양이 된다 — 소문자 · 숫자 · 하이픈 하나', () => {
@@ -14,6 +14,16 @@ test('치는 대로 타입의 모양이 된다 — 소문자 · 숫자 · 하이
   assert.equal(typeOf('-Roller  Conveyor-'), 'roller-conveyor')
 })
 
+test('하이픈을 칠 수 있다 — 한 글자씩 쳐도 끝의 하이픈이 남고, 저장할 때 다듬는다', () => {
+  let typed = ''
+  for (const key of 'fork-agv-tutorial') typed = typingTypeOf(typed + key)
+  assert.equal(typed, 'fork-agv-tutorial')
+  let trailing = ''
+  for (const key of 'Fork AGV ') trailing = typingTypeOf(trailing + key)
+  assert.equal(trailing, 'fork-agv-')
+  assert.equal(typeOf(trailing), 'fork-agv')
+})
+
 test('발행할 수 없는 이름은 미리 말한다 — 임시 이름 · 형식 · 길이', () => {
   assert.equal(releasableType('agv-lifter'), true)
   assert.equal(releasableType(placeholderType()), false, '서버가 붙이는 임시 이름')

package/test/pivot.test.ts

@@ -0,0 +1,57 @@
+/*
+ * Named points a turn's axis may pass (`pivot.ts`): worked out from the part as it rests, they keep the named point
+ * still as the joint turns -- whatever the face, the alignment, the slider.
+ */
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+
+import { addFigureBox, applyFigureAuthoring, createFigureAsset } from '@hatiolab/figure-model'
+import type { FigureAsset } from '@hatiolab/figure-model'
+
+import { motionJoint } from '../client/modeller/links.ts'
+import { pivotPointOf, pivotPointsOf } from '../client/modeller/pivot.ts'
+import { revisionOf } from './revision-of.ts'
+
+const box = (a: FigureAsset, id: string, [x, y, z]: number[], at = [0, 0, 0]) => addFigureBox(a, { id, size: { x, y, z }, position: { x: at[0]!, y: at[1]!, z: at[2]! } })
+const turn = (through = {}) => ({ kind: 'turn', axis: 'x', id: 'sh', min: -90, max: 90, follow: '', multiplier: 1, offset: 0, travel: '', travelPlus: 0, through }) as never
+
+/* An arm of 300 mm hung by its side from a torso, level with its top -- the lesson's upper arm -- or under it. */
+function arm(face: 'left' | 'bottom', align?: object) {
+  const a = box(createFigureAsset('H'), 'torso', [340, 500, 200], [0, 1000, 0])
+  return applyFigureAuthoring(box(a, 'arm', [90, 300, 90], [0, 50, 0]), { kind: 'attach', part: 'arm', to: { part: 'torso', face }, ...(align ? { align } : {}) } as never)
+}
+const endsAt = (a: FigureAsset, through: object, value: number) => {
+  const joint = a.joints!.find(j => j.body1.part === 'arm')!
+  const b = applyFigureAuthoring(a, { kind: 'set-joint', joint: motionJoint(joint, turn(through), 'arm') } as never)
+  const g = (revisionOf(b, { sh: value }).geometry as Array<{ id: string; pose: { r: number[][]; t: number[] } }>).find(p => p.id === 'arm')!.pose
+  /* The arm's top and bottom end centres in the figure's frame. */
+  return [150, -150].map(y => [0, 1, 2].map(i => g.r[i]![1]! * y + g.t[i]!))
+}
+const near = (a: number[], b: number[]) => a.every((v, i) => Math.abs(v - b[i]!) < 0.5)
+
+test('a named pivot stays where it is as the joint turns: top, middle, bottom of a side-hung or an under-hung arm (tutorial 2026-11-12)', () => {
+  for (const [face, align] of [['left', { y: 'max' }], ['left', undefined], ['bottom', undefined]] as const) {
+    const a = arm(face, align)
+    const points = pivotPointsOf(revisionOf(a), 'arm', 'x')!
+    assert.ok(points, `${face}: points`)
+    const [top0, bottom0] = endsAt(a, points.top, 0)
+    assert.ok(near(endsAt(a, points.top, 70)[0]!, top0!), `${face} ${JSON.stringify(align)}: the top end stays`)
+    assert.ok(near(endsAt(a, points.bottom, 70)[1]!, bottom0!), `${face} ${JSON.stringify(align)}: the bottom end stays`)
+    assert.ok(!near(endsAt(a, points.middle, 70)[0]!, top0!), `${face}: about the middle the top end moves`)
+  }
+})
+
+test('the lesson upper arm, level with the torso top, already turns about its top end: no number is needed', () => {
+  const points = pivotPointsOf(revisionOf(arm('left', { y: 'max' })), 'arm', 'x')!
+  assert.deepEqual(points, { top: {}, middle: { y: -150 }, bottom: { y: -300 } })
+  assert.equal(pivotPointOf(points, {}, 'x'), 'top')
+  assert.equal(pivotPointOf(points, { y: 120 }, 'x'), undefined, 'Y 120 put the axis above the shoulder')
+})
+
+test('a part fastened to nothing, or a slider left turned, has no wrong points', () => {
+  assert.equal(pivotPointsOf(revisionOf(box(createFigureAsset('H'), 'solo', [10, 10, 10])), 'solo'), null)
+  const a = arm('bottom')
+  const joint = a.joints!.find(j => j.body1.part === 'arm')!
+  const b = applyFigureAuthoring(a, { kind: 'set-joint', joint: motionJoint(joint, turn(), 'arm') } as never)
+  assert.deepEqual(pivotPointsOf(revisionOf(b, { sh: 60 }), 'arm'), pivotPointsOf(revisionOf(b), 'arm'))
+})

package/test/size-response.test.ts

@@ -1,7 +1,8 @@
 import { test } from 'node:test'
 import assert from 'node:assert/strict'
-import { applyFigureAuthoring, compileFigureAsset, figureRowOf, figureFollowOf } from '@hatiolab/figure-model'
-import { sizeRelationSteps, sizeRelationOf, sizeInputOf } from '../client/modeller/size-response.ts'
+import { addFigureBox, addFigurePrimitive, applyFigureAuthoring, compileFigureAsset, createFigureAsset, figureRowOf, figureFollowOf } from '@hatiolab/figure-model'
+import { sizeAxisWord, sizeRelationSteps, sizeRelationOf, sizeInputOf } from '../client/modeller/size-response.ts'
+import { followableAxes } from '../client/modeller/links.ts'
 import type { FigureRevision } from '../client/modeller/revision.ts'
 import { multipartResponseFixture } from './multipart-response-fixture.js'
 const revision = (asset: ReturnType<typeof multipartResponseFixture>) => ({ asset, inputs: asset.designInputs } as FigureRevision)
@@ -47,3 +48,10 @@ test('repeat settings can change count, direction and mode without losing the at
  assert.deepEqual(a.joints!.find(j=>j.body1.part==='legLeft')!.body0,initial.body0)
  assert.deepEqual(figureFollowOf(a,'brace','x'),{of:'part',part:'tabletop',axis:'x',plus:-200})
 })
+
+test('a round body names the diameter that sets the axis it has no row for: X·Z across, Y up (tutorial 2026-11-12)', () => {
+  const ball = addFigurePrimitive(createFigureAsset('Ball'), { id: 'ball', kind: 'sphere', dimensions: { radius: 100, radiusY: 120 }, position: { x: 0, y: 0, z: 0 } } as never)
+  assert.deepEqual(followableAxes(ball, 'ball').map(a => sizeAxisWord(ball, 'ball', a, '지름')), ['X·Z · 지름', 'Y · 지름'])
+  const block = addFigureBox(createFigureAsset('Block'), { id: 'block', size: { x: 10, y: 20, z: 30 }, position: { x: 0, y: 0, z: 0 } })
+  assert.deepEqual(followableAxes(block, 'block').map(a => sizeAxisWord(block, 'block', a, '지름')), ['X', 'Y', 'Z'])
+})

package/test/stage-model.test.ts

@@ -9,7 +9,7 @@ import assert from 'node:assert/strict'
 import { addFigureBox, compileFigureAsset, createFigureAsset } from '@hatiolab/figure-model'
 
 import { drawableFigureParts } from '../client/modeller/renderer.ts'
-import { boardFor, needsRefit } from '../client/modeller/stage-model.ts'
+import { boardFor, drawnSpanOf, needsRefit, outgrowsFit } from '../client/modeller/stage-model.ts'
 
 const partsOf = (height: number) =>
   drawableFigureParts(
@@ -33,3 +33,25 @@ test('a size typed far from the view brings the camera to it; a nudge does not (
   assert.equal(needsRefit(boardFor(parts(3000, 800, 600)), boardFor(parts(100, 100, 100))), true, 'shrunk far: fitted again')
   assert.equal(needsRefit(undefined, boardFor(parts(3000, 800, 600))), false, 'never fitted: the first standing fits it')
 })
+
+test('the view follows a figure that grows past the fit, or stands higher off the floor (review 2026-11-11)', () => {
+  const at = (height: number, y: number) =>
+    drawableFigureParts(compileFigureAsset(addFigureBox(createFigureAsset('P'), { id: 'p', size: { x: 300, y: height, z: 200 }, position: { x: 0, y, z: 0 } })).evaluate().geometry)
+  /* A pelvis 180 mm tall put 880 mm up: as tall as it stands from the floor, not as its own height. */
+  const onFloor = boardFor(at(180, 90))
+  const raised = boardFor(at(180, 970))
+  assert.ok(raised.depth >= 1060, `reached from the floor: ${raised.depth}`)
+  assert.equal(needsRefit(onFloor, raised), true, 'raised far: the view follows it up')
+  /* A head added on a 1.56 m body: 1.8 m runs past the fit's margin. */
+  assert.equal(needsRefit(boardFor(at(680, 1220)), boardFor(at(920, 1340))), true)
+  /* A nudge inside the fit's margin leaves the camera where the author put it. */
+  assert.equal(needsRefit(boardFor(at(680, 1220)), boardFor(at(700, 1230))), false)
+})
+
+test('the view follows a part hung below what it was fitted round (review 2026-11-11)', () => {
+  const body = drawnSpanOf(partsOf(500))
+  const longer = drawnSpanOf(partsOf(800))
+  assert.equal(outgrowsFit(body, longer), true, 'reaching 300 mm past the top')
+  assert.equal(outgrowsFit(body, drawnSpanOf(partsOf(520))), false, 'a little taller stays in view')
+  assert.equal(outgrowsFit(undefined, longer), false)
+})

package/translations/en.json

@@ -484,6 +484,8 @@
   "figure.text.pick-a-shape-above-to-start": "pick a shape above to add the first 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.control-played": "Playing",
+  "figure.text.control-played-explained": "The {clip} clip is moving this control. Stop the clip to give it a value.",
   "figure.text.clear-tried-explained": "clears the control values tried here. the saved default pose is unchanged, and the clips move the figure again.",
   "figure.text.preview-blocked-by-errors": "cannot show the preview because of format errors. see the check tab for the reason.",
   "figure.text.put-on-floor": "Moves the part once so its bottom is on the floor (Y=0). It does not stay there when the size changes; for that, use “Follow size, attached to the floor”.",
@@ -715,6 +717,10 @@
   "figure.label.motion-own-control": "its own control",
   "figure.label.motion-multiplier": "multiplier",
   "figure.label.motion-offset": "offset",
+  "figure.label.pivot-at": "turn about",
+  "figure.label.pivot-top": "top end",
+  "figure.label.pivot-middle": "middle",
+  "figure.label.pivot-bottom": "bottom end",
   "figure.label.motion-through": "axis passes through",
   "figure.label.motion-follows": "moves with {joint} × {multiplier} + {offset}",
   "figure.label.face-opening-left": "opening left",
@@ -1020,6 +1026,7 @@
   "figure.text.slot-id-taken": "{slot} is already the name of a place in this figure.",
   "figure.label.placement": "fastening",
   "figure.label.motion-groups": "motion groups",
+  "figure.label.motion-group-named": "motion",
   "figure.label.motion-group": "motion group",
   "figure.label.no-motion-group": "no group",
   "figure.label.motion-group-name": "name",
@@ -1322,6 +1329,7 @@
   "figure.button.shift-track": "shift",
   "figure.button.copy-track-apply": "copy",
   "figure.text.copy-clip-needs-group": "A copy plays the same controls, so only a clip in a motion group can be copied.",
+  "figure.text.copy-clip-makes-group": "Copies every track into a clip with a new name. The copy moves the same controls, so both go into a new motion group named after this clip (one plays at a time).",
   "figure.label.primitive-pipe": "pipe",
   "figure.label.primitive-duct": "duct",
   "figure.label.primitive-tapered-box": "tapered box",

package/translations/es.json

@@ -484,6 +484,8 @@
   "figure.text.pick-a-shape-above-to-start": "elija una forma arriba para añadir la primera pieza.",
   "figure.text.placement-explained": "define el plano de anclaje en la escena 3D (suelo: AGV/transportador, techo: OHT/polipasto, centro: sensor/dron).",
   "figure.text.pose-as-default-explained": "Escribe la postura que ha definido como valores predeterminados de los parámetros, para que la figura quede así cuando nadie le dé un valor.",
+  "figure.text.control-played": "En reproducción",
+  "figure.text.control-played-explained": "El clip {clip} está moviendo este control. Detén el clip para darle un valor.",
   "figure.text.clear-tried-explained": "borra los valores de control probados aquí. la pose por defecto guardada no cambia y los clips vuelven a moverla.",
   "figure.text.preview-blocked-by-errors": "no se puede mostrar la vista previa por errores de formato. consulte el motivo en la pestaña de madurez.",
   "figure.text.put-on-floor": "Mueve la pieza una vez para que su base quede en el suelo (Y=0). No se mantiene ahí cuando cambia el tamaño; para ello, use “Seguir el tamaño, unida al suelo”.",
@@ -715,6 +717,10 @@
   "figure.label.motion-own-control": "su propio control",
   "figure.label.motion-multiplier": "multiplicador",
   "figure.label.motion-offset": "desplazamiento",
+  "figure.label.pivot-at": "girar en",
+  "figure.label.pivot-top": "extremo superior",
+  "figure.label.pivot-middle": "centro",
+  "figure.label.pivot-bottom": "extremo inferior",
   "figure.label.motion-through": "el eje pasa por",
   "figure.label.motion-follows": "se mueve con {joint} × {multiplier} + {offset}",
   "figure.label.face-opening-left": "abertura izquierda",
@@ -1020,6 +1026,7 @@
   "figure.text.slot-id-taken": "{slot} ya es el nombre de un lugar en esta figura.",
   "figure.label.placement": "sujeción",
   "figure.label.motion-groups": "grupos de movimiento",
+  "figure.label.motion-group-named": "movimiento",
   "figure.label.motion-group": "grupo de movimiento",
   "figure.label.no-motion-group": "sin grupo",
   "figure.label.motion-group-name": "nombre",
@@ -1322,6 +1329,7 @@
   "figure.button.shift-track": "desplazar",
   "figure.button.copy-track-apply": "copiar",
   "figure.text.copy-clip-needs-group": "Una copia mueve los mismos controles, así que solo se copia un clip que está en un grupo de movimiento.",
+  "figure.text.copy-clip-makes-group": "Copia todas las pistas en un clip con un nombre nuevo. La copia mueve los mismos controles, así que ambos van a un grupo de movimiento nuevo con el nombre de este clip (se reproduce uno a la vez).",
   "figure.label.primitive-pipe": "tubo",
   "figure.label.primitive-duct": "conducto",
   "figure.label.primitive-tapered-box": "caja ahusada",

package/translations/ja.json

@@ -484,6 +484,8 @@
   "figure.text.pick-a-shape-above-to-start": "pick a shape above to add the first part.",
   "figure.text.placement-explained": "3D シーンでの基準面を決めます (床: AGV/コンベヤ、天井: OHT/ホイスト、中心: センサー/ドローン)。",
   "figure.text.pose-as-default-explained": "今の姿勢をパラメータの既定値として書き込みます。値が与えられないとき、この姿勢で立ちます。",
+  "figure.text.control-played": "再生中",
+  "figure.text.control-played-explained": "{clip} クリップがこの操作値を動かしています。クリップを止めると値を与えられます。",
   "figure.text.clear-tried-explained": "プレビューで変えた操作値を消します。保存された既定の姿勢は変わらず、クリップが再び動かします。",
   "figure.text.preview-blocked-by-errors": "形式エラーのためプレビューを表示できません。成熟度タブで理由を確認してください。",
   "figure.text.put-on-floor": "今の位置だけ底面を床(Y=0)に合わせます。サイズが変わると追従しません。付けたままにするには「床に付けてサイズに追従」を使ってください。",
@@ -715,6 +717,10 @@
   "figure.label.motion-own-control": "自分の操作値",
   "figure.label.motion-multiplier": "倍率",
   "figure.label.motion-offset": "オフセット",
+  "figure.label.pivot-at": "回転の中心",
+  "figure.label.pivot-top": "上端",
+  "figure.label.pivot-middle": "中央",
+  "figure.label.pivot-bottom": "下端",
   "figure.label.motion-through": "軸が通る点",
   "figure.label.motion-follows": "{joint} に連動 × {multiplier} + {offset}",
   "figure.label.face-opening-left": "開口部 左",
@@ -1020,6 +1026,7 @@
   "figure.text.slot-id-taken": "{slot} はこの図形ですでに使われている場所の名前です。",
   "figure.label.placement": "取り付け",
   "figure.label.motion-groups": "モーショングループ",
+  "figure.label.motion-group-named": "動作",
   "figure.label.motion-group": "モーショングループ",
   "figure.label.no-motion-group": "グループなし",
   "figure.label.motion-group-name": "名前",
@@ -1322,6 +1329,7 @@
   "figure.button.shift-track": "ずらす",
   "figure.button.copy-track-apply": "複製",
   "figure.text.copy-clip-needs-group": "複製は同じ操作値を動かすため、動作グループに入れたクリップだけ複製できます。",
+  "figure.text.copy-clip-makes-group": "すべてのトラックを新しい名前のクリップへ複製します。複製は同じ操作値を動かすため、このクリップの名前で動作グループを作り、両方を入れます（同時に再生されるのは一つ）。",
   "figure.label.primitive-pipe": "パイプ",
   "figure.label.primitive-duct": "ダクト",
   "figure.label.primitive-tapered-box": "先細りの箱",

package/translations/ko.json

@@ -484,6 +484,8 @@
   "figure.text.pick-a-shape-above-to-start": "위에서 하나를 골라 첫 부품을 놓으세요.",
   "figure.text.placement-explained": "3D 씬에서 객체의 기준면을 정합니다 (바닥: AGV/컨베이어, 천장: OHT/호이스트, 중심: 센서/드론).",
   "figure.text.pose-as-default-explained": "현재 자세를 파라미터의 기본값으로 저장합니다. 값이 지정되지 않으면 피규어에 이 자세가 적용됩니다.",
+  "figure.text.control-played": "재생 중",
+  "figure.text.control-played-explained": "{clip} 클립이 이 조작값을 움직이고 있습니다. 클립을 멈추면 값을 줄 수 있습니다.",
   "figure.text.clear-tried-explained": "미리 보기에서 바꾼 조작값을 지웁니다. 저장된 기본 자세는 바뀌지 않고, 클립이 다시 움직입니다.",
   "figure.text.preview-blocked-by-errors": "형식 오류로 미리보기를 표시할 수 없습니다. 검사 탭에서 사유를 확인하세요.",
   "figure.text.put-on-floor": "지금 위치만 바닥(Y=0)에 맞춥니다. 크기가 바뀌면 따라가지 않습니다. 계속 붙어 있게 하려면 ‘바닥에 붙여 크기 따라가기’를 쓰세요.",
@@ -715,6 +717,10 @@
   "figure.label.motion-own-control": "제 조작값으로",
   "figure.label.motion-multiplier": "배율",
   "figure.label.motion-offset": "더하기",
+  "figure.label.pivot-at": "회전 중심",
+  "figure.label.pivot-top": "위 끝",
+  "figure.label.pivot-middle": "가운데",
+  "figure.label.pivot-bottom": "아래 끝",
   "figure.label.motion-through": "축이 지나는 점",
   "figure.label.motion-follows": "따라 움직임: {joint} × {multiplier} + {offset}",
   "figure.label.face-opening-left": "개구부 왼쪽",
@@ -1020,6 +1026,7 @@
   "figure.text.slot-id-taken": "이 피규어에서 이미 쓰는 자리 이름입니다: {slot}.",
   "figure.label.placement": "붙이기",
   "figure.label.motion-groups": "동작 그룹",
+  "figure.label.motion-group-named": "동작",
   "figure.label.motion-group": "동작 그룹",
   "figure.label.no-motion-group": "그룹 없음",
   "figure.label.motion-group-name": "이름",
@@ -1322,6 +1329,7 @@
   "figure.button.shift-track": "시간 밀기",
   "figure.button.copy-track-apply": "복사",
   "figure.text.copy-clip-needs-group": "복사본은 같은 조작값을 움직이므로 동작 묶음에 넣은 클립만 복사할 수 있습니다.",
+  "figure.text.copy-clip-makes-group": "모든 트랙을 새 이름의 클립으로 복사합니다. 복사본은 같은 조작값을 움직이므로, 이 클립의 이름으로 동작 묶음을 만들어 둘을 함께 넣습니다(한 번에 하나만 재생).",
   "figure.label.primitive-pipe": "관",
   "figure.label.primitive-duct": "덕트",
   "figure.label.primitive-tapered-box": "가늘어지는 상자",

package/translations/ms.json

@@ -484,6 +484,8 @@
   "figure.text.pick-a-shape-above-to-start": "pick a shape above to add the first part.",
   "figure.text.placement-explained": "menetapkan satah rujukan dalam adegan 3D (lantai: AGV/penghantar, siling: OHT/hois, pusat: sensor/dron).",
   "figure.text.pose-as-default-explained": "Menulis postur semasa sebagai nilai lalai parameter, supaya figura berdiri begini apabila tiada nilai diberi.",
+  "figure.text.control-played": "Dimainkan",
+  "figure.text.control-played-explained": "Klip {clip} sedang menggerakkan kawalan ini. Hentikan klip untuk memberinya nilai.",
   "figure.text.clear-tried-explained": "mengosongkan nilai kawalan yang dicuba di sini. pose lalai yang disimpan tidak berubah, dan klip menggerakkannya semula.",
   "figure.text.preview-blocked-by-errors": "pratonton tidak dapat dipaparkan kerana ralat format. lihat tab kematangan untuk sebabnya.",
   "figure.text.put-on-floor": "Mengalihkan bahagian sekali supaya bahagian bawahnya di lantai (Y=0). Ia tidak kekal di situ apabila saiz berubah; untuk itu, gunakan “Ikut saiz, dilekatkan pada lantai”.",
@@ -715,6 +717,10 @@
   "figure.label.motion-own-control": "kawalan sendiri",
   "figure.label.motion-multiplier": "pendarab",
   "figure.label.motion-offset": "ofset",
+  "figure.label.pivot-at": "pusing pada",
+  "figure.label.pivot-top": "hujung atas",
+  "figure.label.pivot-middle": "tengah",
+  "figure.label.pivot-bottom": "hujung bawah",
   "figure.label.motion-through": "paksi melalui",
   "figure.label.motion-follows": "bergerak bersama {joint} × {multiplier} + {offset}",
   "figure.label.face-opening-left": "bukaan kiri",
@@ -1020,6 +1026,7 @@
   "figure.text.slot-id-taken": "{slot} sudah menjadi nama tempat dalam figura ini.",
   "figure.label.placement": "lekatan",
   "figure.label.motion-groups": "kumpulan gerakan",
+  "figure.label.motion-group-named": "gerakan",
   "figure.label.motion-group": "kumpulan gerakan",
   "figure.label.no-motion-group": "tiada kumpulan",
   "figure.label.motion-group-name": "nama",
@@ -1322,6 +1329,7 @@
   "figure.button.shift-track": "anjak",
   "figure.button.copy-track-apply": "salin",
   "figure.text.copy-clip-needs-group": "Salinan menggerakkan kawalan yang sama, jadi hanya klip dalam kumpulan gerakan boleh disalin.",
+  "figure.text.copy-clip-makes-group": "Menyalin semua trek ke klip bernama baharu. Salinan menggerakkan kawalan yang sama, jadi kedua-duanya dimasukkan ke kumpulan gerakan baharu bernama klip ini (satu dimainkan pada satu masa).",
   "figure.label.primitive-pipe": "paip",
   "figure.label.primitive-duct": "salur",
   "figure.label.primitive-tapered-box": "kotak tirus",

package/translations/zh.json

@@ -484,6 +484,8 @@
   "figure.text.pick-a-shape-above-to-start": "pick a shape above to add the first part.",
   "figure.text.placement-explained": "设置 3D 场景中的基准面 (地面: AGV/输送机，天花板: OHT/吊车，中心: 传感器/无人机)。",
   "figure.text.pose-as-default-explained": "把当前姿态写为参数默认值。没有给值时，图形以此姿态站立。",
+  "figure.text.control-played": "播放中",
+  "figure.text.control-played-explained": "{clip} 片段正在驱动此控制值。停止片段后即可赋值。",
   "figure.text.clear-tried-explained": "清除在预览中修改的控制值。已保存的默认姿态不变,剪辑会再次驱动它。",
   "figure.text.preview-blocked-by-errors": "由于格式错误无法显示预览。请在成熟度标签页查看原因。",
   "figure.text.put-on-floor": "只把当前位置的底面对齐到地面（Y=0）。尺寸变化时不会跟随。若要保持附着，请使用“附着地面并跟随尺寸”。",
@@ -715,6 +717,10 @@
   "figure.label.motion-own-control": "自身控制值",
   "figure.label.motion-multiplier": "倍率",
   "figure.label.motion-offset": "偏移",
+  "figure.label.pivot-at": "转动中心",
+  "figure.label.pivot-top": "上端",
+  "figure.label.pivot-middle": "中间",
+  "figure.label.pivot-bottom": "下端",
   "figure.label.motion-through": "轴经过的点",
   "figure.label.motion-follows": "跟随 {joint} × {multiplier} + {offset}",
   "figure.label.face-opening-left": "开口 左侧",
@@ -1020,6 +1026,7 @@
   "figure.text.slot-id-taken": "{slot} 已是此图形中某个位置的名称。",
   "figure.label.placement": "附着",
   "figure.label.motion-groups": "动作组",
+  "figure.label.motion-group-named": "动作",
   "figure.label.motion-group": "动作组",
   "figure.label.no-motion-group": "不分组",
   "figure.label.motion-group-name": "名称",
@@ -1322,6 +1329,7 @@
   "figure.button.shift-track": "平移",
   "figure.button.copy-track-apply": "复制",
   "figure.text.copy-clip-needs-group": "副本驱动相同的控制值，因此只能复制已放入动作组的片段。",
+  "figure.text.copy-clip-makes-group": "将所有轨道复制为新名称的片段。副本驱动相同的控制值，因此以此片段的名称创建动作组并放入两者（同一时间只播放一个）。",
   "figure.label.primitive-pipe": "管",
   "figure.label.primitive-duct": "风管",
   "figure.label.primitive-tapered-box": "渐变箱",