@things-factory/figure-ui 10.1.71 → 10.1.72

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@things-factory/figure-ui",
-  "version": "10.1.71",
+  "version": "10.1.72",
   "publishConfig": {
     "access": "public",
     "@things-factory:registry": "https://registry.npmjs.org"
@@ -27,7 +27,7 @@
     "clean": "npm run clean:server && npm run clean:client"
   },
   "dependencies": {
-    "@hatiolab/figure-model": "^0.1.86",
+    "@hatiolab/figure-model": "^0.1.87",
     "@hatiolab/things-scene": "^10.1.56",
     "@material/web": "^2.0.0",
     "@operato/data-grist": "^10.0.0",
@@ -41,8 +41,8 @@
     "@operato/styles": "^10.0.0",
     "@operato/utils": "^10.0.0",
     "@things-factory/ai-assistant": "^10.1.58",
-    "@things-factory/figure-service": "^10.1.71",
+    "@things-factory/figure-service": "^10.1.72",
     "three": "^0.185.1"
   },
-  "gitHead": "4ee13a8b66a34e889994eff3ad31af6ebb8d7ca5"
+  "gitHead": "fdf6d4faac454dbdca62d8fe7409395dff1ada22"
 }

package/test/browser/build.mjs

@@ -56,6 +56,18 @@ export async function buildPage(page = 'modeller-page.js') {
   const file = join(out, 'page.js')
   await bundle.write({ file, format: 'esm', inlineDynamicImports: true })
   await bundle.close()
+
+  /*
+    ox-markdown renders in a worker it loads from beside its module (\`../../workers/markdown-webworker.js\`); from
+    /page.js that is /workers/. Bundled here and served there, the guides render as in the app -- without it the worker
+    never answers and a guide is drawn empty.
+  */
+  const worker = await rollup({
+    input: join(ROOT, 'node_modules/@operato/markdown/workers/markdown-webworker.js'),
+    plugins: [nodeResolve({ browser: true, modulePaths: [join(PACKAGE, 'node_modules'), join(ROOT, 'node_modules')] }), commonjs()]
+  })
+  await worker.write({ file: join(out, 'workers/markdown-webworker.js'), format: 'esm', inlineDynamicImports: true })
+  await worker.close()
   return file
 }
 

package/test/browser/modeller-page.js

@@ -213,7 +213,7 @@ window.probe = {
 }
 
 window.harness = {
-  async mount(kind, text, templates = []) {
+  async mount(kind, text, templates = [], guides = {}) {
     const source = sourceOf(kind, text)
     const session = createV3ProductSession({
       load: async id => ({ id, source }),
@@ -223,6 +223,7 @@ window.harness = {
     const editor = document.createElement('figure-v3-editor')
     editor.session = session
     editor.templates = templates
+    editor.guideOf = async name => guides[name] ?? ''
     editor.revision = 0
     /* The modeller page counts a change the same way: the editor re-reads the session on a new revision. */
     editor.addEventListener('v3-changed', () => (editor.revision = editor.revision + 1))

package/test/browser/modeller.check.mjs

@@ -702,13 +702,30 @@ describe('the recipe catalog: a template chosen, filled in, put onto the chosen
   }
 
   test('the room chosen, the catalog opened: the door told in full, a share typed, put in -- the frame, the leaves and the lamp, and the catalog closes', async () => {
-    await read(list => harness.mount('room', null, list), templates())
+    const guides = { 'sliding-door': readFileSync(resolve(HERE, '../../../figure-service/recipes/sliding-door/guide.en.md'), 'utf-8') }
+    await read((list, guides) => harness.mount('room', null, list, guides), templates(), guides)
     await sleep(2500)
     await click(await read(() => probe.row('room')))
     await click(await at('button[recipe-catalog]'))
     assert.ok(await at('figure-v3-recipe-catalog'), 'the catalog is open')
-    await click(await at('button[card="sliding-door"]'))
+    await click(await at('button[card="hinged-door"]'))
+    /* A search that takes the chosen card away tells the first card it leaves (:3300, 2026-09-26). */
+    await type('input[search]', 'sliding')
+    assert.equal(await read(() => {
+      const deep = (root = document) => [...root.querySelectorAll('button[card][on]')].concat(...[...root.querySelectorAll('*')].filter(e => e.shadowRoot).map(e => deep(e.shadowRoot)))
+      return deep().map(b => b.getAttribute('card')).join()
+    }), 'sliding-door', 'the card told is one the search shows')
     assert.ok(await at('li[parts="2–4"]'), 'the parts it adds, worked out from its choices: 2 to 4')
+    /* The guide is drawn as its text, not as the page its words would name (seen on :3300, 2026-09-26). */
+    await sleep(1500)
+    const guide = await read(() => {
+      const deep = (root = document) => [...root.querySelectorAll('ox-markdown')].concat(...[...root.querySelectorAll('*')].filter(e => e.shadowRoot).map(e => deep(e.shadowRoot)))
+      const shown = deep()[0]
+      return shown ? { headings: [...shown.shadowRoot.querySelectorAll('h2')].map(h => h.textContent.trim()), app: !!shown.shadowRoot.querySelector('ox-app, things-app, body, html') } : null
+    })
+    assert.ok(guide, 'the guide is shown')
+    assert.ok(guide.headings.includes('When to use it'), `the guide's own headings: ${JSON.stringify(guide.headings)}`)
+    assert.equal(guide.app, false, 'no page drawn inside it')
     await type('input[param="share"]', '50')
     const start = await state()
     await click(await at('button[insert]'))

package/test/browser/serve.mjs

@@ -2,7 +2,8 @@
  * Opens the built page in a headless browser: a tiny server for page.js, and puppeteer on it at a desktop size.
  */
 import { createServer } from 'node:http'
-import { readFileSync } from 'node:fs'
+import { existsSync, readFileSync } from 'node:fs'
+import { dirname, join, normalize } from 'node:path'
 import puppeteer from 'puppeteer'
 
 const HTML = `<!DOCTYPE html>
@@ -16,9 +17,14 @@ const HTML = `<!DOCTYPE html>
 export async function openPage(bundle, { width = 1400, height = 900 } = {}) {
   const js = readFileSync(bundle)
   const server = createServer((req, res) => {
+    /* Scripts built beside the page (the markdown worker) are served as they are. */
+    const beside = join(dirname(bundle), normalize(req.url.split('?')[0]).replace(/^([/\\])+/, ''))
     if (req.url === '/page.js') {
       res.writeHead(200, { 'Content-Type': 'application/javascript' })
       res.end(js)
+    } else if (req.url.endsWith('.js') && existsSync(beside)) {
+      res.writeHead(200, { 'Content-Type': 'application/javascript' })
+      res.end(readFileSync(beside))
     } else {
       res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' })
       res.end(HTML)

package/test/v3-recipes.test.ts

@@ -53,7 +53,12 @@ test('작동 방식은 레시피에서 셈한다 — 미닫이 문: 두 문짝
     { key: 'figure.text.recipe-controls', words: { count: 1 } },
     { key: 'figure.text.recipe-shown-by-control', words: { parts: 'lamp' } }
   ])
-  assert.deepEqual(recipeWorkings(JSON.parse(template('roller-row'))), [{ key: 'figure.text.recipe-row', words: { part: 'roller' } }])
+  /* The rollers spin on one control, every copy (ADR-0093, 2026-09-26). */
+  assert.deepEqual(recipeWorkings(JSON.parse(template('roller-row'))), [
+    { key: 'figure.text.recipe-turns', words: { part: 'roller' } },
+    { key: 'figure.text.recipe-controls', words: { count: 1 } },
+    { key: 'figure.text.recipe-row', words: { part: 'roller' } }
+  ])
 })
 
 test('모델러 — 부품 칸의 단추가 카탈로그를 열고, 넣으면 한 단계로 들어가고 창이 닫힌다; 목록은 페이지가 서버에서 한 번 읽는다', () => {