@things-factory/figure-ui 10.1.145 → 10.1.147

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@things-factory/figure-ui",
-  "version": "10.1.145",
+  "version": "10.1.147",
   "publishConfig": {
     "access": "public",
     "@things-factory:registry": "https://registry.npmjs.org"
@@ -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.145",
-    "@things-factory/figure-service": "^10.1.145",
+    "@things-factory/ai-assistant": "^10.1.147",
+    "@things-factory/figure-service": "^10.1.147",
     "three": "^0.185.1"
   },
-  "gitHead": "1c33612ba31f51b9af59f9bc68751971097350a5"
+  "gitHead": "df93dddb6ac19a27c32fad21e29ca0ce02d08eb6"
 }

package/test/align.test.ts

@@ -91,7 +91,7 @@ test('a tilted part is told it touches by a point or an edge, a ball by its lowe
   const editor = read('../client/modeller/editor.ts')
   assert.ok(editor.includes("const told = contact === 'tilted' || contact === 'extreme' ? `-${contact}` : ''"), 'the tooltip follows the contact')
   assert.ok(editor.includes("this.notice = i18next.t(`figure.text.aligned-${contact}-${asset.placement ?? 'floor'}`)"), 'and so does the word after')
-  for (const lang of ['en', 'ja', 'ko', 'ms', 'zh']) {
+  for (const lang of ['en', 'ja', 'ko', 'ms', 'zh', 'es']) {
     const t = JSON.parse(read(`../translations/${lang}.json`))
     for (const placement of ['floor', 'ceiling', 'wall'])
       for (const contact of ['tilted', 'extreme'])
@@ -106,7 +106,7 @@ test('a tilted part is told it touches by a point or an edge, a ball by its lowe
 test('the size gizmo\'s reason names what the placement keeps, in every language', () => {
   const editor = read('../client/modeller/editor.ts')
   assert.equal(editor.match(/'figure\.text\.gizmo-size-turned-fastening'[^\n]*extreme: this\.keptExtremeWord\(\)/g)?.length, 3, 'every place it is said')
-  for (const lang of ['en', 'ja', 'ko', 'ms', 'zh']) {
+  for (const lang of ['en', 'ja', 'ko', 'ms', 'zh', 'es']) {
     const t = JSON.parse(read(`../translations/${lang}.json`))
     assert.ok(t['figure.text.gizmo-size-turned-fastening'].includes('{extreme}'), lang)
     for (const placement of ['floor', 'ceiling', 'wall', 'center']) assert.ok(t[`figure.label.kept-extreme-${placement}`], `${lang} ${placement}`)

package/test/browser/modeller-page.js

@@ -172,9 +172,9 @@ window.probe = {
   ids() {
     return editor().session.read().geometry.map(g => g.id)
   },
-  /** The value of the selects that offer this option, as they stand. */
-  selectsOffering(value) {
-    return deep('select').filter(s => [...s.options].some(o => o.value === value)).map(s => s.value)
+  /** The way the fastening drawing shows the part fastened: meet, flush or centre. */
+  fastenMode() {
+    return deep('figure-fasten-drawing')[0]?.mode ?? null
   },
   /** The page point of an input by its aria-label, or of the part name field. */
   nameField() {

package/test/browser/modeller.check.mjs

@@ -133,9 +133,9 @@ describe('the gizmo on a part the modeller made (own numbers)', () => {
     const after = await state()
     assert.equal(after.revision, start.revision + 1, 'one step of the history')
     assert.equal(after.selected, 'box')
-    assert.ok(now.dimensions.width > was.dimensions.width * 1.2, `grew: ${was.dimensions.width} → ${now.dimensions.width}`)
-    assert.equal(now.dimensions.height, was.dimensions.height)
-    assert.equal(now.dimensions.depth, was.dimensions.depth)
+    assert.ok(now.dimensions['size.x'] > was.dimensions['size.x'] * 1.2, `grew: ${was.dimensions['size.x']} → ${now.dimensions['size.x']}`)
+    assert.equal(now.dimensions.length, was.dimensions.length)
+    assert.equal(now.dimensions['size.z'], was.dimensions['size.z'])
   })
 
   test('rotate: one step, the part turns about the handle axis and keeps the turn', async () => {
@@ -182,7 +182,7 @@ describe('the gizmo on a part placed by worked-out rules', () => {
     assert.equal(after.error, '', 'not refused')
     assert.equal(after.revision, start.revision + 1, 'one step of the history')
     assert.equal(after.selected, 'pedestal')
-    assert.ok(now.dimensions.radius > was.dimensions.radius * 1.1, `wider: ${was.dimensions.radius} → ${now.dimensions.radius}`)
+    assert.ok(now.dimensions['radius.x'] > was.dimensions['radius.x'] * 1.1, `wider: ${was.dimensions['radius.x']} → ${now.dimensions['radius.x']}`)
     assert.equal(now.dimensions.length, was.dimensions.length)
   })
 
@@ -219,7 +219,7 @@ describe('the gizmo on a part placed by worked-out rules', () => {
 describe('a pose slider dragged with the mouse (user 2026-09-24: the arm jumped on release)', () => {
   before(async () => {
     await mount('six-axis')
-    await click(await read(() => probe.tab('figure.label.motion')))
+    await click(await read(() => probe.tab('figure.label.tab-short-motion')))
   })
 
   /** Presses a slider's thumb, moves it `units`, reads the canvas while still held, then releases. */
@@ -328,33 +328,50 @@ describe('the fastening form belongs to the part it is for', () => {
   })
 
   /* The select whose label (the i18n key: the check loads no translations) is `label`, in the parts' links form. */
-  const alignSelect = label =>
+  const select = label =>
     page().evaluateHandle(label => {
       const deep = (root = document) => [...root.querySelectorAll('select')].concat(...[...root.querySelectorAll('*')].filter(e => e.shadowRoot).map(e => deep(e.shadowRoot)))
       return deep().find(s => s.previousElementSibling?.textContent?.trim() === label) ?? null
     }, label)
+  /* Where the part sits across the target face, as the face drawing holds it (the drawing sets it since 2026-10-02). */
+  const placing = () =>
+    read(() => {
+      const deep = (root = document) => [...root.querySelectorAll('figure-fasten-drawing')].concat(...[...root.querySelectorAll('*')].filter(e => e.shadowRoot).map(e => deep(e.shadowRoot)))
+      const drawing = deep()[0]
+      return drawing ? { target: drawing.target, x: drawing.align.x ?? 'centre', mm: drawing.alignMm.x ?? 0 } : null
+    })
 
   test('a choice made for one part is not carried to the next part picked; the next opens on its own fastening (셔터 커튼 2026-09-25, walk 1 2026-09-26)', async () => {
-    /* The placing across the target face is asked once there is a target: the form starts with none. */
     await click(await read(() => probe.row('forearm')))
-    const target = await alignSelect('figure.label.target-part')
-    assert.ok(await target.evaluate(s => !!s), 'the form asks what the forearm is fastened to')
-    await target.select('elbow')
-    const select = await alignSelect('figure.label.align-x')
-    assert.ok(await select.evaluate(s => !!s), 'with a target, the form offers left-right placing for the forearm')
-    await select.select('max')
-    assert.equal(await select.evaluate(s => s.value), 'max', 'chosen for the forearm')
+    assert.equal(await (await select('figure.label.target-part')).evaluate(s => s?.value), 'elbow', 'the forearm opens on what it is fastened to')
+    /* Placed off centre on the elbow's face, as a hand does: the face drawing focused, the arrows. */
+    const face = await read(() => {
+      const deep = (root = document) => [...root.querySelectorAll('figure-fasten-drawing')].concat(...[...root.querySelectorAll('*')].filter(e => e.shadowRoot).map(e => deep(e.shadowRoot)))
+      const rect = deep()[0]?.shadowRoot.querySelector('div[where] svg > rect')
+      if (!rect) return null
+      rect.scrollIntoView({ block: 'center' })
+      const r = rect.getBoundingClientRect()
+      return { x: r.left + 4, y: r.top + 4 }
+    })
+    await click(face)
+    await page().keyboard.down('Shift')
+    for (let i = 0; i < 3; i++) await page().keyboard.press('ArrowRight')
+    await page().keyboard.up('Shift')
+    await sleep(600)
+    const chosen = await placing()
+    assert.equal(chosen?.x, 'mm', `placed off centre for the forearm: ${JSON.stringify(chosen)}`)
+    assert.ok(chosen.mm > 0)
 
     await click(await read(() => probe.row('elbow')))
     /* The elbow opens on its own fastening (walk 1, 2026-09-26), not on the forearm's choices. */
     const own = await read(() => {
       const joint = JSON.parse(document.querySelector('figure-editor').session.source()).joints.find(j => j.body1.part === 'elbow')
-      return { target: joint.body0.part, x: joint.origin?.align?.x ?? 'centre' }
+      return { target: joint.body0.part, x: Object.keys(joint.origin?.align?.x ?? {})[0] ?? 'centre' }
     })
-    const nextTarget = await alignSelect('figure.label.target-part')
-    assert.equal(await nextTarget.evaluate(s => s.value), own.target, 'the elbow opens on what it is fastened to')
-    const next = await alignSelect('figure.label.align-x')
-    assert.ok(await next.evaluate((s, x) => !s || s.value === (typeof x === 'string' ? x : 'mm') || s.value === 'centre', own.x), 'and on its own placing, not the forearm\'s edge')
+    assert.equal(await (await select('figure.label.target-part')).evaluate(s => s?.value), own.target, 'the elbow opens on what it is fastened to')
+    const next = await placing()
+    assert.equal(next?.target, own.target)
+    assert.equal(next.x, own.x, 'and on its own placing, not the forearm\'s')
   })
 })
 
@@ -410,11 +427,22 @@ 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.equal((await declared())['size.x'][1], 3000, 'the largest width is what was typed')
     await type('size.x.min', '500')
-    assert.match((await state()).error, /500|400/, 'the figure is 400 wide: a smallest of 500 is refused, and said')
+    assert.notEqual((await state()).error, '', 'the figure is 400 wide: a smallest of 500 is refused')
     assert.equal((await declared())['size.x'][0] < 400, true, 'and the range is as it was')
     assert.equal(await (await field('size.x.min')).evaluate(i => Number(i.value) < 400), true, 'the field shows the range it still has')
   })
 
+  /*
+    The smallest refused is said with the figure's size (2026-10-11): figure-model refuses it with INSTANCE_SIZE_RANGE
+    「size.x: the authored size 400 mm must lie within 500…4000 mm」, which the screen once showed as the bare
+    figure.text.edit-refused. The page loads no translations: the numbers are the unit suite's to check, the sentence's key here.
+  */
+  test('the smallest refused is said in its own words, with the figure\'s size, not as a bare refusal', async () => {
+    const said = (await state()).error
+    assert.notEqual(said, '', 'refused')
+    assert.notEqual(said, 'figure.text.edit-refused', `said in its own words: ${said}`)
+  })
+
   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')
@@ -428,15 +456,19 @@ describe('a figure made in the modeller is given its size from its parts (user 2
         what,
         label
       )
+    /* The way to make a side follow is folded under the advanced choice (2026-09-28): opened, as a hand does. */
+    await click(await read(() => {
+      const deep = (root = document) => [...root.querySelectorAll('details[resize-choice] > summary')].concat(...[...root.querySelectorAll('*')].filter(e => e.shadowRoot).map(e => deep(e.shadowRoot)))
+      const summary = deep()[0]
+      if (!summary) return null
+      summary.scrollIntoView({ block: 'center' })
+      const r = summary.getBoundingClientRect()
+      return { x: r.left + r.width / 2, y: r.top + r.height / 2 }
+    }))
     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)
-    /* Refusals and notices go to the app's notification: heard here as the event it is. */
-    await page().evaluate(() => {
-      window.__told = []
-      document.addEventListener('notify', e => window.__told.push(e.detail))
-    })
     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' }))
@@ -446,17 +478,21 @@ describe('a figure made in the modeller is given its size from its parts (user 2
     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 told = await read(() => {
-      const last = window.__told.at(-1)
-      return last && { level: last.level, message: last.message, label: last.option?.action?.label }
+    /* A refusal with a way on is asked in the app's prompt (OxPrompt): confirmed, the narrowed link is made. */
+    const asked = await read(() => {
+      const deep = (root = document) => [...root.querySelectorAll('ox-prompt')].concat(...[...root.querySelectorAll('*')].filter(e => e.shadowRoot).map(e => deep(e.shadowRoot)))
+      const prompt = deep().at(-1)
+      const confirm = prompt?.shadowRoot?.querySelector('#confirm')
+      if (!confirm) return null
+      const r = confirm.getBoundingClientRect()
+      return { text: prompt.text, label: confirm.textContent.trim(), x: r.left + r.width / 2, y: r.top + r.height / 2 }
     })
-    assert.equal(told?.level, 'error', 'said in the app\'s notification')
-    assert.match(told?.message ?? '', /figure.text.link-needs-smaller-range/)
-    assert.match(told?.label ?? '', /figure.button.narrow-range-from/, 'the same link is offered with the sizes narrowed')
-    await read(() => window.__told.at(-1).option.action.callback())
+    assert.match(asked?.text ?? '', /figure.text.link-needs-smaller-range/, 'asked in the app\'s prompt')
+    assert.match(asked.label, /figure.button.narrow-range-from/, 'the same link is offered with the sizes narrowed')
+    await click(asked)
     await sleep(600)
     assert.equal((await state()).error, '', 'taken')
-    assert.equal((await body('box')).dimensions.width, 350, 'the figure\'s 400 less 50')
+    assert.equal((await body('box')).dimensions['size.x'], 350, 'the figure\'s 400 less 50')
   })
 
   test('grown by one ratio, every part is made to follow it in one step, and the offer goes', async () => {
@@ -503,7 +539,7 @@ describe('a motion is changed where it is (2026-09-25)', () => {
   })
 
   test('the shoulder\'s range is changed from the motion tab: one step, the same joint, its new limit', async () => {
-    await click(await read(() => probe.tab('figure.label.motion')))
+    await click(await read(() => probe.tab('figure.label.tab-short-motion')))
     const jointOf = part => read(part => (JSON.parse(document.querySelector('figure-editor').session.source()).joints ?? []).find(j => j.body1.part === part) ?? null, part)
     const was = await jointOf('upper-arm')
     assert.ok(was, 'the upper arm has its joint')
@@ -582,23 +618,25 @@ describe('the modeller made easier to find and to keep (2026-09-26 baseline)', (
     await page().keyboard.press('Enter')
     await sleep(600)
     const now = await body('box')
-    assert.equal(Math.round(now.t[1] - now.dimensions.height / 2), 0, `bottom on the floor: centre ${now.t[1]}, height ${now.dimensions.height}`)
-    assert.equal(now.dimensions.height, 1000)
+    /* The box is drawn up y from its start: its bottom is its centre plus the start. */
+    assert.equal(Math.round(now.t[1] + now.dimensions.start), 0, `bottom on the floor: centre ${now.t[1]}, starts at ${now.dimensions.start}`)
+    assert.equal(now.dimensions.length, 1000)
   })
 
   test('fastened to the floor, a leaf set off its frame stays where it stood', async () => {
     await mount('door')
     await click(await read(() => probe.row('leaf')))
     const was = await body('leaf')
-    const box = await page().evaluate(() => {
-      const deep = (root = document) => [...root.querySelectorAll('label[toggle]')].concat(...[...root.querySelectorAll('*')].filter(e => e.shadowRoot).map(e => deep(e.shadowRoot)))
-      const label = deep().find(l => l.textContent.includes('figure.label.stands-on-plane'))
-      label.scrollIntoView({ block: 'center' })
-      const r = label.querySelector('input').getBoundingClientRect()
-      return { x: r.left + r.width / 2, y: r.top + r.height / 2 }
+    /* The floor is chosen as what the leaf is fastened to, in the fastening form; a new fastening waits for 붙이기. */
+    await click(await centre(await find('button', 'figure.button.fasten-start')))
+    const target = await page().evaluateHandle(() => {
+      const deep = (root = document) => [...root.querySelectorAll('select')].concat(...[...root.querySelectorAll('*')].filter(e => e.shadowRoot).map(e => deep(e.shadowRoot)))
+      return deep().find(s => s.previousElementSibling?.textContent?.trim() === 'figure.label.target-part') ?? null
     })
-    await click(box)
-    const fasten = await find('button', 'figure.button.fasten')
+    assert.ok(await target.evaluate(s => !!s), 'the form asks what the leaf is fastened to')
+    await target.select('__plane')
+    await sleep(500)
+    const fasten = await find('button[act]', 'figure.button.fasten')
     const start = await state()
     await click(await centre(fasten))
     const after = await state()
@@ -611,7 +649,7 @@ describe('the modeller made easier to find and to keep (2026-09-26 baseline)', (
   test('a part is shown while a control is at least a value: chosen in the motion tab, one step each, drawn or not', async () => {
     await mount('arm')
     await click(await read(() => probe.row('upper-arm')))
-    await click(await read(() => probe.tab('figure.label.motion')))
+    await click(await read(() => probe.tab('figure.label.tab-short-motion')))
     const shownSelect = () =>
       page().evaluateHandle(() => {
         const deep = (root = document) => [...root.querySelectorAll('select')].concat(...[...root.querySelectorAll('*')].filter(e => e.shadowRoot).map(e => deep(e.shadowRoot)))
@@ -680,7 +718,7 @@ describe('a part follows the figure size in one step (follow-size, 2026-09-26)',
       editor.session.apply([{ kind: 'set-design', input: 'size.x', unit: 'mm', value: 800 }])
       return editor.session.read().geometry.find(g => g.id === 'box').shape.dimensions
     })
-    assert.equal(Math.round(grown.width), 800, 'twice the size, twice the box')
+    assert.equal(Math.round(grown['size.x']), 800, 'twice the size, twice the box')
   })
 })
 
@@ -745,7 +783,7 @@ describe('the recipe catalog: a template chosen, filled in, put onto the chosen
     const ids = await parts()
     for (const part of ['frame', 'left', 'right', 'lamp']) assert.ok(ids.includes(`sliding-door-1-${part}`), `${part} is in`)
     const frame = await body('sliding-door-1-frame')
-    assert.equal(Math.round(frame.dimensions.right - frame.dimensions.left), 2000, "half the room's 4000 mm")
+    assert.equal(Math.round(frame.dimensions['size.x']), 2000, "half the room's 4000 mm")
     assert.equal(await at('figure-recipe-catalog'), null, 'the catalog closes')
   })
 
@@ -760,8 +798,12 @@ describe('the recipe catalog: a template chosen, filled in, put onto the chosen
     assert.equal((await state()).revision, start.revision, 'no step')
     assert.deepEqual(await parts(), before, 'nothing added')
     const said = await at('section[detail] p[role="alert"]')
-    /* The step it stopped at and the kernel's code -- not the kernel's English (2026-09-27). */
-    assert.ok(said && /recipe-step-refused|단계|step/i.test(said.text) && /\([A-Z_]+\)/.test(said.text) && !/steps\[/.test(said.text), `the step and the code, in words: ${said?.text}`)
+    /*
+      The step it stopped at and the kernel's code -- not the kernel's English (2026-09-27). The page loads no
+      translations, so the sentence shows as its key; the step and the code it is given are the unit suite's
+      (refusals.test.ts, recipeRefusalOf).
+    */
+    assert.equal(said?.text, 'figure.text.recipe-step-refused', `the step's sentence, not the kernel's English: ${said?.text}`)
     await click(await at('button[close]'))
   })
 })
@@ -823,8 +865,8 @@ describe('a row that carries a part (ADR-0093, 2026-09-26)', () => {
     await click(await read(() => probe.row('roller')))
     assert.equal((await state()).selected, 'roller')
     assert.ok(await read(() => probe.hasInput('roller.repeat.pitch')), 'the roller offers its row')
-    /* Walk 1 (2026-09-26): the fastening form opens on the roller's own fastening -- by its centre. */
-    assert.ok((await read(() => probe.selectsOffering('centre'))).includes('centre'), 'my face reads centre')
+    /* Walk 1 (2026-09-26): the fastening form opens on the roller's own fastening -- by its centre, the drawing's way (2026-10-01). */
+    assert.equal(await read(() => probe.fastenMode()), 'centre', 'the way it is fastened reads centre')
     /* And the row's part keeps a name of its own to change. */
     const name = await read(() => probe.nameField())
     assert.equal(name.disabled, false, 'the roller can be renamed')

package/test/cavity-drawing.test.ts

@@ -66,7 +66,7 @@ test('단면 칸에 그림이 들어간다: 속 공간이 있을 때, 면마다
   assert.ok(!panel.includes("cavityField(") && !panel.includes('renderEnd('), 'no number fields repeating the drawing')
   has(drawing, /@pointerdown=\$\{\(ev: PointerEvent\) => this\.type\(ev, \{ kind: 'wall', side \}, 'top', w\.wall\[side\]!\)\}/)
   has(drawing, /!open && this\.type\(ev, \{ kind: 'end', end \}, 'side'/)
-  for (const lang of ['ko', 'en', 'ja', 'zh', 'ms']) {
+  for (const lang of ['ko', 'en', 'ja', 'zh', 'ms', 'es']) {
     const t = JSON.parse(read(`../translations/${lang}.json`)) as Record<string, string>
     for (const key of ['figure.label.section-cavity-top', 'figure.label.section-cavity-side']) assert.ok(t[key], `${lang} ${key}`)
   }

package/test/clip-consent.test.ts

@@ -80,7 +80,7 @@ test('the modeller asks on every path an edit can stop a clip, in every language
     assert.ok(editor.includes(`if (this.askClipLoss(error, ${path})) return`), path)
   assert.ok(editor.includes('if (!now || now.context !== asked.context || now.revision !== asked.revision) {'), 'what was asked about is checked after the answer')
   assert.ok(editor.includes('asked.session.withConsent({ dropClips: clips.map(c => c.id), context: asked.context, revision: asked.revision }, again)'))
-  for (const lang of ['en', 'ja', 'ko', 'ms', 'zh']) {
+  for (const lang of ['en', 'ja', 'ko', 'ms', 'zh', 'es']) {
     const t = JSON.parse(read(`../translations/${lang}.json`))
     for (const key of ['figure.text.clips-would-go', 'figure.text.clip-gone', 'figure.text.clip-changed', 'figure.button.let-clips-go', 'figure.text.clips-consent-stale']) assert.ok(t[key], `${lang} ${key}`)
     assert.ok(t['figure.text.clips-would-go'].includes('{clips}') && t['figure.text.clip-gone'].includes('{clip}'), lang)

package/test/clips.test.ts

@@ -64,7 +64,7 @@ test('움직임 탭에 서고, 막대는 입력 한 묶음 · 나머지는 부
   const clips = read('../client/modeller/figure-clips.ts')
   assert.ok(clips.includes("@change=${(e: Event) => this.scrub(clip, number(e))}"), '막대는 놓을 때 한 번')
   const keys = [...clips.matchAll(/'(figure\.[a-z.-]*[a-z])'/g)].map(m => m[1])
-  for (const lang of ['ko', 'en', 'ja', 'zh', 'ms']) {
+  for (const lang of ['ko', 'en', 'ja', 'zh', 'ms', 'es']) {
     const table = JSON.parse(read(`../translations/${lang}.json`))
     for (const key of keys) assert.ok(table[key], `${lang}: ${key}`)
   }

package/test/command-preview.test.ts

@@ -94,7 +94,7 @@ test('the details fold, and what they hold that is not the default stays said --
   /* The way and the place on the face are the drawing's: not said again in the summary, nor chosen again in the details. */
   assert.ok(!links.includes('fasten-summary-edge') && !links.includes('fasten-summary-off-centre') && !links.includes("'figure.label.facing-flush'"))
   assert.ok(links.includes('({ axis }) => !view || !view.axes.includes(axis) || !!f.alignInput?.[axis] || hasInstanceSize(asset, axis)'), 'a row only where the drawing cannot set it')
-  for (const lang of ['en', 'ja', 'ko', 'ms', 'zh']) {
+  for (const lang of ['en', 'ja', 'ko', 'ms', 'zh', 'es']) {
     const t = JSON.parse(read(`../translations/${lang}.json`))
     for (const key of ['preview-refused', 'preview-stays', 'preview-moves', 'preview-turns-named', 'preview-turns-slanted', 'preview-carries', 'preview-copies', 'preview-clips', 'preview-face-unknown', 'target-would-loop', 'fasten-summary-gap', 'fasten-summary-twist'])
       assert.ok(t[`figure.text.${key}`], `${lang} ${key}`)
@@ -124,7 +124,7 @@ test('detaching says what it would do: stays, what stays fastened to it, the cli
   assert.ok(editor.includes(': /* It stays where it is: as expected, so nothing is said (user 2026-10-01). */ []'), 'nothing said when it stays')
   const links = read('../client/modeller/figure-links.ts')
   assert.equal(links.match(/\$\{this\.renderDetachWords\(\)\}/g)?.length, 3, 'beside every button that detaches (a part at an origin has its own)')
-  for (const lang of ['en', 'ja', 'ko', 'ms', 'zh']) {
+  for (const lang of ['en', 'ja', 'ko', 'ms', 'zh', 'es']) {
     const t = JSON.parse(read(`../translations/${lang}.json`))
     for (const key of ['detach-moves', 'detach-keeps-children', 'detach-clips', 'detach-refused']) assert.ok(t[`figure.text.${key}`], `${lang} ${key}`)
   }
@@ -164,7 +164,7 @@ test('a row is seen before it is made, read as figure-model draws it -- and said
   const editor = read('../client/modeller/editor.ts')
   assert.ok(editor.includes("const row = candidate.action.kind === 'make-repeat' ? figureRowOf(seen.asset, this.selected, this.shown()!.inputs) : undefined"))
   assert.ok(editor.includes('<ul row-reading>${rowWordsOf(this.rowNow(shown)'), 'a row made says the same, as it stands')
-  for (const lang of ['en', 'ja', 'ko', 'ms', 'zh']) {
+  for (const lang of ['en', 'ja', 'ko', 'ms', 'zh', 'es']) {
     const t = JSON.parse(read(`../translations/${lang}.json`))
     for (const key of ['row-count-pitch', 'row-count-uneven', 'row-ends-centred', 'row-ends', 'row-ends-unknown', 'row-companions', 'row-count-spreads', 'row-blocked-unfastened', 'row-blocked-on-plane', 'row-blocked-holds-parts'])
       assert.ok(t[`figure.text.${key}`], `${lang} ${key}`)
@@ -241,7 +241,7 @@ test('past the edge of its face is said beside the fastening, with the way to ch
   assert.ok(links.includes("<button act @click=${() => this.showWhere()}><md-icon>tune</md-icon>${i18next.t('figure.button.fix-alignment')}</button>"))
   assert.ok(links.includes("shadowRoot?.querySelector<HTMLElement>('div[where]')"), 'to the face in the drawing, where the place is dragged or keyed')
   assert.equal(say('figure.text.overhang-out', { on: 'top', face: '윗면', sides: say('figure.text.overhang-side-high', { axis: 'X', mm: '100' }) }), 'top의 윗면 가장자리 밖으로 나와 있습니다: X 높은 쪽 100 mm. 모델의 점유 공간과는 따로 봅니다.')
-  for (const lang of ['en', 'ja', 'ko', 'ms', 'zh']) {
+  for (const lang of ['en', 'ja', 'ko', 'ms', 'zh', 'es']) {
     const t = JSON.parse(read(`../translations/${lang}.json`))
     for (const key of ['figure.text.overhang-out', 'figure.text.overhang-possible', 'figure.text.overhang-unknown', 'figure.text.overhang-held', 'figure.text.overhang-side-low', 'figure.text.overhang-side-high', 'figure.button.fix-alignment']) assert.ok(t[key], `${lang} ${key}`)
   }
@@ -290,7 +290,7 @@ test('a part wider than its face is said in the relation, with its numbers and w
   const links = read('../client/modeller/figure-links.ts')
   assert.ok(links.includes("${this.overhangNote.length ? html`<p hint overhang-note>${this.overhangNote.join(' ')}</p>` : nothing}"), 'in the details, not the warning')
   assert.equal(say('figure.text.overhang-larger', { on: 'leg', face: '윗면', sides: 'X 낮은 쪽 270 mm, X 높은 쪽 870 mm' }), 'leg의 윗면보다 넓어 가장자리 밖으로 나와 있습니다: X 낮은 쪽 270 mm, X 높은 쪽 870 mm.')
-  for (const lang of ['en', 'ja', 'ko', 'ms', 'zh']) {
+  for (const lang of ['en', 'ja', 'ko', 'ms', 'zh', 'es']) {
     const t = JSON.parse(read(`../translations/${lang}.json`))
     assert.ok(t['figure.text.overhang-larger'] && t['figure.text.overhang-lopsided'], lang)
   }

package/test/controls.test.ts

@@ -62,7 +62,7 @@ test('편집기에 닿는다 — 값 바꾸기는 입력으로, 이름 · 범위
   const controls = read('../client/modeller/figure-controls.ts')
   assert.ok(controls.includes("@change=${(e: Event) => this.try(c, number(e))}"), '슬라이더는 놓을 때 한 번 — 끄는 동안 기록이 쌓이지 않는다')
   const keys = [...controls.matchAll(/'(figure\.[a-z.-]*[a-z])'/g)].map(m => m[1])
-  for (const lang of ['ko', 'en', 'ja', 'zh', 'ms']) {
+  for (const lang of ['ko', 'en', 'ja', 'zh', 'ms', 'es']) {
     const table = JSON.parse(read(`../translations/${lang}.json`))
     for (const key of keys) assert.ok(table[key], `${lang}: ${key}`)
   }

package/test/fasten-drawing.test.ts

@@ -40,6 +40,6 @@ test('화면 문구는 결과와 예외만 — 한 줄 요약, 가장자리 밖,
   assert.equal(say('figure.text.fasten-sentence-meet', { part: 'lid', face: '아랫면', to: 'bin의 윗면' }), 'lid의 아랫면을 bin의 윗면에 맞닿게')
   assert.equal(say('figure.text.fasten-sentence-centre', { part: 'roller', face: '', to: 'frame의 앞면' }), 'roller의 가운데를 frame의 앞면 위에')
   for (const key of ['figure.text.fasten-off-face', 'figure.text.fasten-past-edges', 'figure.label.fasten-mode-meet', 'figure.label.fasten-mode-flush', 'figure.label.fasten-mode-centre'])
-    for (const lang of ['ko', 'en', 'ja', 'zh', 'ms']) assert.ok((JSON.parse(read(`../translations/${lang}.json`)) as Record<string, string>)[key], `${lang} ${key}`)
+    for (const lang of ['ko', 'en', 'ja', 'zh', 'ms', 'es']) assert.ok((JSON.parse(read(`../translations/${lang}.json`)) as Record<string, string>)[key], `${lang} ${key}`)
   assert.ok(!/끌어 옮깁니다|면 밖으로도/.test(JSON.stringify(ko)), 'no instructions on the screen')
 })

package/test/fields.test.ts

@@ -96,7 +96,7 @@ test('pitch 는 한 곳에서 하나의 값이고, 늘 set-repeat 로 바꿔 최
   const pitch = editor.slice(editor.indexOf('  private setPitch('), editor.indexOf('  /** Choose a part,'))
   assert.ok(pitch.includes("this.session!.command({ kind: 'set-repeat', part: this.selected, pitch })"), '늘 명령으로 — 최대 길이가 따라온다')
   assert.ok(!pitch.includes('changeField'))
-  for (const lang of ['ko', 'en', 'ja', 'zh', 'ms']) {
+  for (const lang of ['ko', 'en', 'ja', 'zh', 'ms', 'es']) {
     const table = JSON.parse(readFileSync(fileURLToPath(new URL(`../translations/${lang}.json`, import.meta.url)), 'utf8'))
     /* The term stays pitch; what it measures is said beside it (ADR-0097 §5.5: centre to centre). */
     assert.ok(table['figure.label.repeat-gap'].startsWith('pitch') && table['figure.label.repeat-gap'].length > 'pitch'.length, lang)

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

@@ -48,7 +48,7 @@ test('a figure proposal is answered by its handler, in words, never left without
   assert.match(handler, /export const FIGURE_CANDIDATE_TOOL = 'proposeFigureCandidate'/)
   assert.match(handler, /runFigureProposal\(/)
   assert.match(handler, /context\.notify\(/)
-  for (const lang of ['en', 'ko', 'ja', 'zh', 'ms']) {
+  for (const lang of ['en', 'ko', 'ja', 'zh', 'ms', 'es']) {
     const words = JSON.parse(readFileSync(fileURLToPath(new URL(`../translations/${lang}.json`, import.meta.url)), 'utf8'))
     for (const key of ['applied', 'stale', 'refused', 'needs-modeller', 'not-opened', 'new-figure-unsaved'])
       assert.ok(words[`figure.text.proposal-${key}`], `${lang} has no words for proposal-${key}`)

package/test/first-minute.test.ts

@@ -50,7 +50,7 @@ test('the side tabs say their names, in every language', () => {
   assert.ok(editor.includes("const name = i18next.t('figure.label.tab-short-' + tab)"))
   assert.ok(editor.includes('aria-label=${name}'), 'its accessible name is the name it shows')
   assert.ok(editor.includes('<span tab-label aria-hidden="true">${name}</span>'))
-  for (const lang of ['ko', 'en', 'ja', 'zh', 'ms']) {
+  for (const lang of ['ko', 'en', 'ja', 'zh', 'ms', 'es']) {
     const table = JSON.parse(read(`../translations/${lang}.json`))
     for (const tab of ['properties', 'capability', 'motion', 'verdict', 'view', 'history']) assert.ok(table[`figure.label.tab-short-${tab}`], `${lang} ${tab}`)
   }

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

@@ -35,7 +35,7 @@ test('the first save asks the name first; the identifier offered stays through r
   assert.ok(popup.includes('if (!this.type || offeredAndTaken) this.type = this.suggested = suggestTypeOf(this.name, this.taken)'), 'offered again only when empty, or offered and taken')
   const page = read('../client/pages/figure-modeller-page.ts')
   assert.ok(page.includes('if (answer) this.row = { ...this.row, type: answer.type }'), 'a retry opens on the identifier answered before')
-  for (const lang of ['en', 'ja', 'ko', 'ms', 'zh']) {
+  for (const lang of ['en', 'ja', 'ko', 'ms', 'zh', 'es']) {
     const t = JSON.parse(read(`../translations/${lang}.json`))
     assert.ok(t['figure.label.figure-identifier'] && t['figure.text.identifier-suggested'], lang)
   }

package/test/gizmo.test.ts

@@ -94,7 +94,7 @@ test('캔버스 — 기즈모 · W E R · 스냅은 씬의 편집 모드가 한
 })
 
 test('기즈모의 말은 다섯 말 모두에 있다', () => {
-  for (const lang of ['ko', 'en', 'ja', 'zh', 'ms']) {
+  for (const lang of ['ko', 'en', 'ja', 'zh', 'ms', 'es']) {
     const table = JSON.parse(read(`../translations/${lang}.json`))
     for (const mode of ['translate', 'rotate', 'scale']) assert.ok(table[`figure.label.gizmo-${mode}`], `${lang}: ${mode}`)
   }

package/test/layout.test.ts

@@ -66,7 +66,7 @@ test('띠 — 칸 접기 · 되돌리기 · 전체 보기 · 저장 상태 ·
     assert.ok(bar.includes(piece), piece)
   assert.doesNotMatch(renderBody, /[가-힣]/, '편집기의 화면 말에 한국어가 박혀 있지 않다')
   const keys = [...editor.matchAll(/'(figure\.[a-z.-]*[a-z])'/g)].map(m => m[1])
-  for (const lang of ['ko', 'en', 'ja', 'zh', 'ms']) {
+  for (const lang of ['ko', 'en', 'ja', 'zh', 'ms', 'es']) {
     const table = JSON.parse(read(`../translations/${lang}.json`))
     for (const key of keys) assert.ok(table[key], `${lang}: ${key}`)
   }
@@ -103,7 +103,7 @@ test('불러오는 동안 빈 무대에 「도형을 추가해…」가 깜빡
   /* A new figure's start card says how to begin; an empty stage otherwise is one loading, or with every part hidden. */
   assert.ok(canvas.includes('return html`<div stage></div>`'))
   assert.ok(!canvas.includes('add-a-shape-to-start') && !editor.includes('startShown'))
-  for (const lang of ['ko', 'en', 'ja', 'zh', 'ms'])
+  for (const lang of ['ko', 'en', 'ja', 'zh', 'ms', 'es'])
     assert.equal((JSON.parse(read(`../translations/${lang}.json`)) as Record<string, string>)['figure.text.add-a-shape-to-start'], undefined, lang)
   assert.ok(editor.includes("if (!foldSaid()) notify({ level: 'info', message: i18next.t('figure.text.parts-panel-folded-narrow') })"))
   assert.ok(/function foldSaid\(\): boolean \{\s*try \{\s*if \(localStorage\.getItem\('figure-fold-said'\)\) return true\s*localStorage\.setItem\('figure-fold-said', '1'\)\s*\} catch/.test(editor), 'storage refused: said, as before')

package/test/links.test.ts

@@ -98,7 +98,7 @@ test('떼면 지금 크기로 고정한다 — 따르던 값을 잃지 않는다
 test('세 칸의 말은 다섯 말 모두에 있다', () => {
   const links = read('../client/modeller/figure-links.ts')
   const keys = [...links.matchAll(/'(figure\.[a-z.-]*[a-z])'/g)].map(m => m[1])
-  for (const lang of ['ko', 'en', 'ja', 'zh', 'ms']) {
+  for (const lang of ['ko', 'en', 'ja', 'zh', 'ms', 'es']) {
     const table = JSON.parse(read(`../translations/${lang}.json`))
     for (const key of [...keys, 'figure.text.follow-would-loop', 'figure.text.fasten-would-loop', 'figure.label.motion-slide', 'figure.label.motion-turn', 'figure.label.place-grip', 'figure.label.place-seat'])
       assert.ok(table[key], `${lang}: ${key}`)

package/test/maturity.test.ts

@@ -229,7 +229,7 @@ test('화면이 키를 이어 붙여 찾는 말도 다섯 말 모두에 있다',
     'figure.text.bound-by-triangles',
     ...[...maturity.matchAll(/'(figure\.[a-z.-]*[a-z])'/g)].map(m => m[1]!)
   ]
-  for (const lang of ['ko', 'en', 'ja', 'zh', 'ms']) {
+  for (const lang of ['ko', 'en', 'ja', 'zh', 'ms', 'es']) {
     const table = JSON.parse(read(`../translations/${lang}.json`))
     for (const key of keys) assert.ok(table[key], `${lang}: ${key}`)
   }

package/test/parts-wiring.test.ts

@@ -40,7 +40,7 @@ test('지울 수 없는 부품은 사람의 말로 거절하고, 지우며 풀
   /* Since 2026-09-25 the reason is told apart (partRefusalOf, tested in refusals); the editor hands the refusal to it. */
   assert.match(editor, /private removePart[\s\S]*?partRefusalOf\(error, id,/)
   assert.match(editor, /private removePart[\s\S]*?this\.notice = removalNoticeOf\(view\.removal,/, '지운 뒤 풀어 준 것을 알린다')
-  for (const lang of ['ko', 'en', 'ja', 'zh', 'ms']) {
+  for (const lang of ['ko', 'en', 'ja', 'zh', 'ms', 'es']) {
     const table = JSON.parse(read(`../translations/${lang}.json`))
     for (const key of ['part-is-referenced', 'part-in-declared-space', 'part-row-along', 'part-row-carries'])
       assert.ok(table[`figure.text.${key}`]?.includes('{part}'), `${lang} ${key}`)
@@ -63,7 +63,7 @@ test('팔레트는 시작 모양만 낸다 — 둥근 상자와 통은 상자의
   assert.deepEqual(kinds, ['box', 'cylinder', 'sphere', 'frustum', 'polygon', 'pyramid', 'plate', 'wall', 'portal'])
   /* A part made so is still called by what it is: its icon in the parts list, its name over the properties (links.ts). */
   assert.match(panel, /'rounded-box': 'crop_square'/)
-  for (const lang of ['ko', 'en', 'ja', 'zh', 'ms'])
+  for (const lang of ['ko', 'en', 'ja', 'zh', 'ms', 'es'])
     assert.ok(JSON.parse(read(`../translations/${lang}.json`))['figure.label.primitive-rounded-box'], lang)
 })
 
@@ -71,7 +71,7 @@ test('부품 이름은 figure-model 의 rename-part 로 바꾸고, 거절은 까
   assert.match(editor, /this\.session!\.edit\(\{ kind: 'rename-part', target: from, name \}\)/)
   assert.match(editor, /this\.selected = name/, '바꾼 이름의 부품이 그대로 골라져 있다')
   assert.match(editor, /'figure\.text\.part-name-taken' : 'figure\.text\.part-name-invalid'/)
-  for (const lang of ['ko', 'en', 'ja', 'zh', 'ms']) {
+  for (const lang of ['ko', 'en', 'ja', 'zh', 'ms', 'es']) {
     const table = JSON.parse(read(`../translations/${lang}.json`))
     for (const key of ['figure.text.part-name-taken', 'figure.text.part-name-invalid']) assert.ok(table[key]?.includes('{name}'), `${lang}: ${key}`)
   }

package/test/properties.test.ts

@@ -89,7 +89,7 @@ test('속성 탭의 말은 다섯 말 모두에 있다', () => {
   const keys = [...tab.matchAll(/'(figure\.[a-z.-]*[a-z])'/g)].map(m => m[1])
   for (const face of ['left', 'right', 'bottom', 'top', 'back', 'front']) keys.push(`figure.label.face-${face}`)
   for (const one of ['floor', 'ceiling', 'center']) keys.push(`figure.label.placement-${one}`)
-  for (const lang of ['ko', 'en', 'ja', 'zh', 'ms']) {
+  for (const lang of ['ko', 'en', 'ja', 'zh', 'ms', 'es']) {
     const table = JSON.parse(read(`../translations/${lang}.json`))
     for (const key of keys) assert.ok(table[key], `${lang}: ${key}`)
   }

package/test/proposal-record.test.ts

@@ -122,5 +122,5 @@ test('the dock checks the result from the server: saved is accepted and named, n
   assert.equal(proposalOutcomeFrom([], sayKo), undefined, 'not saved is not known, never refused')
   const page = read('../client/pages/figure-modeller-page.ts')
   assert.ok(page.includes('proposalOutcomeFrom(await fetchProposalOutcome(proposalKey)'), 'the surface asks the server')
-  for (const lang of ['en', 'ja', 'ko', 'ms', 'zh']) assert.ok(JSON.parse(read(`../translations/${lang}.json`))['figure.text.proposal-saved-into'], lang)
+  for (const lang of ['en', 'ja', 'ko', 'ms', 'zh', 'es']) assert.ok(JSON.parse(read(`../translations/${lang}.json`))['figure.text.proposal-saved-into'], lang)
 })