@things-factory/figure-ui 10.1.157 → 10.1.159

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@things-factory/figure-ui",
-  "version": "10.1.157",
+  "version": "10.1.159",
   "publishConfig": {
     "access": "public",
     "@things-factory:registry": "https://registry.npmjs.org"
@@ -41,10 +41,10 @@
     "@operato/slot-layout-editor": "^10.29.25",
     "@operato/styles": "^10.0.0",
     "@operato/utils": "^10.0.0",
-    "@things-factory/ai-assistant": "^10.1.157",
-    "@things-factory/figure-service": "^10.1.157",
+    "@things-factory/ai-assistant": "^10.1.159",
+    "@things-factory/figure-service": "^10.1.159",
     "@things-factory/figure-viewer": "^10.1.155",
     "three": "^0.185.1"
   },
-  "gitHead": "bde810f804966549a7041457ad7ede40fcb78488"
+  "gitHead": "fc15cdcb18e562ca1e723a1e1bf042f9582cbbfb"
 }

package/test/brand-palette.test.ts

@@ -25,13 +25,17 @@ const HERE = import.meta.dirname
 const FOLDER = 'harness-theme'
 const BRAND = join(HERE, '..', 'client', FOLDER, 'brand.css')
 const THEMES = ['light.css', 'dark.css'].map(f => join(HERE, '..', 'client', FOLDER, f))
-/** 저작 하네스 둘. 이 저장소 안의 두 번째 사본 자리다. */
-const HARNESSES = ['modeller-page.mjs', 'real-modeller.mjs'].map(f =>
+/** 저작 하네스 — 앱의 모델러 페이지를 그대로 세우는 것 하나다(옛 V2 픽스처 페이지는 2026-10-13 에 지웠다). */
+const HARNESSES = ['real-modeller.mjs'].map(f =>
   join(HERE, '..', '..', '..', 'test', 'browser', f)
 )
 
 const read = (path: string) => readFileSync(path, 'utf8')
 
+/** brand.css 가 들여오는 teal — operato-suite 의 틀. 하네스의 `/pkg/` 처럼 저장소 안 경로로 읽는다. */
+const TEAL_IMPORT = /@import url\('(\.\.\/\.\.\/\.\.\/operato-suite\/client\/frames\/teal\.css)'\);/
+const TEAL = join(HERE, '..', 'client', FOLDER, '../../../operato-suite/client/frames/teal.css')
+
 /** `--이름: 값;` 을 모은다. 한 줄에 여러 개 붙어 있어도 잡는다. */
 function definitions(css: string): Map<string, string[]> {
   const found = new Map<string, string[]>()
@@ -69,6 +73,37 @@ function colorOf(css: string, name: string): string {
   return value
 }
 
+/**
+ * 브랜드 이름의 실제 색. brand.css 는 `var(--teal-on-*)` 로 suite 를 가리키므로 그 값을 따라가
+ * 6자리 hex 로 돌려준다.
+ */
+function brandColor(name: string): string {
+  const value = definitions(read(BRAND)).get(name)?.[0]
+  const teal = /^var\((--teal-on-(?:light|dark))\)$/.exec(value ?? '')
+
+  assert.ok(teal, `${name} 이 suite 의 teal 이름을 읽지 않는다: ${value}`)
+
+  const literal = definitions(read(TEAL)).get(teal[1]!)?.[0] ?? ''
+  const rgb = /^rgb\((\d+) (\d+) (\d+)\)$/.exec(literal)
+
+  assert.ok(rgb, `suite 의 ${teal[1]} 를 읽을 수 없다: ${literal}`)
+  return '#' + [rgb[1], rgb[2], rgb[3]].map(v => Number(v).toString(16).padStart(2, '0')).join('')
+}
+
+test('teal 값은 operato-suite 에만 있다 — brand.css 는 들여와 이름만 잇는다', () => {
+  /*
+   * operato-figure · operato-twin 의 앱 화면이 읽는 teal 과 하네스의 teal 이 사본으로 따로 살았다
+   * (2026-10-13 까지). 이제 brand.css 는 suite 의 `frames/teal.css` 를 들여오고 값을 적지 않는다.
+   */
+  const brand = read(BRAND)
+
+  assert.match(brand, TEAL_IMPORT, 'brand.css 가 suite 의 teal 틀을 들여오지 않는다')
+  assert.ok(existsSync(TEAL), `들여오는 자리에 teal 틀이 없다: ${TEAL}`)
+
+  const literals = [...brand.replace(/\/\*[\s\S]*?\*\//g, ' ').matchAll(/#[0-9a-f]{3,8}\b|rgba?\(/gi)].map(m => m[0])
+  assert.deepEqual(literals, [], `brand.css 가 색을 직접 적는다: ${literals.join(' · ')}`)
+})
+
 test('브랜드 색의 정본이 있다 — 없으면 아래 테스트가 다 통과해 버린다', () => {
   const brand = definitions(read(BRAND))
 
@@ -168,7 +203,7 @@ test('산출물에 소스에 없는 css 가 없다 — copyfiles 는 지운 것
   옮긴 자리를 하네스가 가리키지 않으면 하네스는 스타일시트 없이 뜬다 — 오류 없이 무채색 화면이
   되고, 아래 대비 시험들은 **어느 화면에도 없는 값**을 재게 된다.
 */
-test('하네스 둘이 옮긴 팔레트를 가리킨다 — 밝은 것과 어두운 것 모두', () => {
+test('하네스가 옮긴 팔레트를 가리킨다 — 밝은 것과 어두운 것 모두', () => {
   for (const path of HARNESSES) {
     const html = read(path)
 
@@ -189,14 +224,14 @@ test('밝은 면과 어두운 면을 함께 든다 — 한쪽만 있으면 어
 })
 
 test('브랜드 색 위의 흰 글자가 읽힌다 — 작은 글자 기준 4.5', () => {
-  const figure = colorOf(read(BRAND), '--figure-brand')
+  const figure = brandColor('--figure-brand')
   const measured = contrast(figure, '#ffffff')
 
   assert.ok(measured >= 4.5, `${figure} 위 흰 글자 대비가 ${measured.toFixed(2)} 다`)
 })
 
 test('어두운 면 위의 브랜드 색이 읽힌다 — 그쪽은 -2 가 맡는다', () => {
-  const bright = colorOf(read(BRAND), '--figure-brand-2')
+  const bright = brandColor('--figure-brand-2')
   const surface = colorOf(read(THEMES[1]!), '--md-sys-color-surface')
   const measured = contrast(bright, surface)
 
@@ -207,7 +242,7 @@ test('밝은 쪽 값을 어두운 면에 쓰지 않는다 — 이름이 뜻이
   /*
    * `--figure-brand` 를 어두운 면에 그대로 쓰면 대비 1.6 이라 사라진다. 그 실수를 잡는다.
    */
-  const figure = colorOf(read(BRAND), '--figure-brand')
+  const figure = brandColor('--figure-brand')
   const darkSurface = colorOf(read(THEMES[1]!), '--md-sys-color-surface')
 
   assert.ok(

package/test/data-motion.test.ts

@@ -116,9 +116,14 @@ test('데이터 탭 · 클립 패널 · 미리보기의 배선과 문구', () =>
   assert.match(preview, /tellInstances\('motion'/)
   const clips = read('../client/modeller/figure-clips.ts')
   assert.match(clips, /kind: 'remove-driver', state: track\.state, clip: clip\.name/)
+  /* A key's value is shown to three decimals: a slider's 14.399999999999999 is not what a person typed. */
+  assert.match(clips, /value: current === undefined \? '' : shown\(current\)/)
+  assert.match(clips, /\$\{key\.seconds\}s → \$\{shown\(key\.value\)\}/)
   const keys = [read('../client/modeller/figure-data-panel.ts'), clips, read('../client/modeller/refusals.ts')].flatMap(src => [...src.matchAll(/'(figure\.[a-z.-]*[a-z])'/g)].map(m => m[1]!))
   /* Keys made from a value: each value the kernel can give has its words. */
   const made = [
+    /* The tab's short name, the one it shows under its icon (renderTab reads figure.label.tab-short-<tab>). */
+    'figure.label.tab-short-data',
     ...['number', 'boolean', 'enum'].map(k => `figure.label.data-kind-${k}`),
     ...['state', 'palette', 'motion-clip', 'motion-speed'].flatMap(k => [`figure.label.data-target-${k}`, `figure.text.data-target-absent-${k}`]),
     ...['observed', 'commanded'].map(k => `figure.label.data-${k}`),

package/test/harness-serve.test.ts

@@ -0,0 +1,49 @@
+import assert from 'node:assert/strict'
+import { join } from 'node:path'
+import { pathToFileURL } from 'node:url'
+import test from 'node:test'
+
+/**
+ * 저작 하네스(`test/browser/serve-modeller.mjs`)가 서고, 표본이 모델러에서 열린다.
+ *
+ * import map 이 꾸러미의 `exports` 하위 경로를 따른다.
+ *
+ * 하네스(`test/browser/serve.mjs`)는 `name/` 접두 하나만 두고 있었다. 그래서
+ * `@operato/popup/ox-popup-actions.js` 처럼 들이는 이름과 파일 자리(`dist/src/...`)가 다른 모듈이
+ * 패키지 맨 위에서 찾아져 404 가 되었고, 그것을 무는 모델러가 하네스에서 통째로 안 떴다(2026-10-13).
+ */
+
+const SERVE = join(import.meta.dirname, '..', '..', '..', 'test', 'browser', 'serve.mjs')
+const REAL = join(import.meta.dirname, '..', '..', '..', 'test', 'browser', 'real-modeller.mjs')
+
+test('exports 의 하위 경로가 그 파일 자리로 간다', async () => {
+  const { buildImportMap } = await import(pathToFileURL(SERVE).href)
+  const { imports } = buildImportMap()
+
+  assert.equal(imports['@operato/popup/ox-popup-actions.js'], '/nm/@operato/popup/dist/src/ox-popup-actions.js')
+  assert.equal(imports['@operato/styles/action-heights.js'], '/nm/@operato/styles/dist/src/action-heights.js')
+  assert.equal(imports['@operato/popup/'], '/nm/@operato/popup/', 'the prefix stays for paths exports does not name')
+})
+
+test('표본은 모두 지금의 자산 형식이라 모델러가 연다', async () => {
+  /*
+   * 손으로 쓴 옛 부품 형식 표본은 figure-model 이 `ASSET_SCHEMA: asset: missing version` 으로 거절해
+   * 하나도 열리지 않았다(2026-10-13). 이제 저장소의 V3 자산(시험 고정물 · 레시피 기본 모델)을 그대로 읽는다.
+   */
+  const { currentSamples } = await import(pathToFileURL(REAL).href)
+  const { parseFigureAsset } = await import('@hatiolab/figure-model')
+  const samples = currentSamples()
+  const refused: string[] = []
+
+  for (const sample of samples) {
+    try {
+      parseFigureAsset(JSON.stringify(sample.source))
+    } catch (error) {
+      refused.push(`${sample.key}: ${(error as Error).message}`)
+    }
+  }
+
+  assert.ok(samples.length > 10, `표본이 ${samples.length} 개뿐이다`)
+  assert.equal(new Set(samples.map(s => s.key)).size, samples.length, '표본 키가 겹친다')
+  assert.deepEqual(refused, [])
+})

package/translations/en.json

@@ -1107,5 +1107,6 @@
   "figure.text.motion-setting-clip-not-in-group": "{clip} is not a clip of {group}.",
   "figure.text.motion-setting-speed-out-of-range": "The speed of {group} is 0 to 3.",
   "figure.text.motion-setting-group-selection-required": "Choose which clip of {group} plays.",
-  "figure.text.motion-key-outside-range": "The key {value} of {input} is outside {min} to {max}; a grouped clip keys inside the range."
+  "figure.text.motion-key-outside-range": "The key {value} of {input} is outside {min} to {max}; a grouped clip keys inside the range.",
+  "figure.label.tab-short-data": "Data"
 }

package/translations/es.json

@@ -504,7 +504,7 @@
   "figure.text.view-settings-are-not-saved": "esta configuración no se guarda.",
   "figure.text.what-a-figure-is": "una Figure es un componente 3D que usted crea. compóngala a partir de formas sencillas y se convierte en un componente que puede colocar en un plano, compartiendo forma y material entre todas las instancias.",
   "figure.text.what-changed-in-this-release": "qué cambió en esta publicación",
-  "figure.title.figures": "figuras",
+  "figure.title.figures": "catálogo de figuras",
   "figure.title.new-figure": "nueva figura",
   "figure.title.save-new-figure": "guardar borrador de figura",
   "figure.text.no-parts-yet": "Aún no hay piezas. Elija una forma arriba para colocar una.",
@@ -1107,5 +1107,6 @@
   "figure.text.motion-setting-clip-not-in-group": "{clip} no es un clip de {group}.",
   "figure.text.motion-setting-speed-out-of-range": "La velocidad de {group} es de 0 a 3.",
   "figure.text.motion-setting-group-selection-required": "Elija qué clip de {group} se reproduce.",
-  "figure.text.motion-key-outside-range": "La clave {value} de {input} está fuera de {min} a {max}; un clip de grupo usa claves dentro del rango."
+  "figure.text.motion-key-outside-range": "La clave {value} de {input} está fuera de {min} a {max}; un clip de grupo usa claves dentro del rango.",
+  "figure.label.tab-short-data": "Datos"
 }

package/translations/ja.json

@@ -1107,5 +1107,6 @@
   "figure.text.motion-setting-clip-not-in-group": "{clip} は {group} のクリップではありません。",
   "figure.text.motion-setting-speed-out-of-range": "{group} の速度は 0 ～ 3 です。",
   "figure.text.motion-setting-group-selection-required": "{group} で再生するクリップを選びます。",
-  "figure.text.motion-key-outside-range": "{input} のキー {value} が範囲 {min} ～ {max} の外です。グループのクリップは範囲内のキーだけを使います。"
+  "figure.text.motion-key-outside-range": "{input} のキー {value} が範囲 {min} ～ {max} の外です。グループのクリップは範囲内のキーだけを使います。",
+  "figure.label.tab-short-data": "データ"
 }

package/translations/ko.json

@@ -1107,5 +1107,6 @@
   "figure.text.motion-setting-clip-not-in-group": "{clip} 클립은 {group} 그룹의 클립이 아닙니다.",
   "figure.text.motion-setting-speed-out-of-range": "{group} 그룹의 배속은 0 ~ 3입니다.",
   "figure.text.motion-setting-group-selection-required": "{group} 그룹에서 재생할 클립을 고릅니다.",
-  "figure.text.motion-key-outside-range": "{input} 조작값의 키 {value} 값이 범위 {min} ~ {max} 밖입니다. 그룹의 클립은 범위 안의 키만 씁니다."
+  "figure.text.motion-key-outside-range": "{input} 조작값의 키 {value} 값이 범위 {min} ~ {max} 밖입니다. 그룹의 클립은 범위 안의 키만 씁니다.",
+  "figure.label.tab-short-data": "데이터"
 }

package/translations/ms.json

@@ -1107,5 +1107,6 @@
   "figure.text.motion-setting-clip-not-in-group": "{clip} bukan klip {group}.",
   "figure.text.motion-setting-speed-out-of-range": "Kelajuan {group} ialah 0 hingga 3.",
   "figure.text.motion-setting-group-selection-required": "Pilih klip {group} yang dimainkan.",
-  "figure.text.motion-key-outside-range": "Kunci {value} bagi {input} di luar {min} hingga {max}; klip berkumpulan mesti dalam julat."
+  "figure.text.motion-key-outside-range": "Kunci {value} bagi {input} di luar {min} hingga {max}; klip berkumpulan mesti dalam julat.",
+  "figure.label.tab-short-data": "Data"
 }

package/translations/zh.json

@@ -1107,5 +1107,6 @@
   "figure.text.motion-setting-clip-not-in-group": "{clip} 不是 {group} 的片段。",
   "figure.text.motion-setting-speed-out-of-range": "{group} 的倍速为 0 ~ 3。",
   "figure.text.motion-setting-group-selection-required": "请选择 {group} 播放的片段。",
-  "figure.text.motion-key-outside-range": "{input} 的关键帧 {value} 超出 {min} ~ {max}；组内片段只能在范围内设关键帧。"
+  "figure.text.motion-key-outside-range": "{input} 的关键帧 {value} 超出 {min} ~ {max}；组内片段只能在范围内设关键帧。",
+  "figure.label.tab-short-data": "数据"
 }