@things-factory/figure-ui 10.1.117 → 10.1.121

package/dist-client/types.d.ts

@@ -6,6 +6,8 @@ export interface Figure {
     id: string;
     /** 컴포넌트 타입 이름. **만든 뒤에 고칠 수 없다.** */
     type: string;
+    /** Namespace of the full name {namespace}/{type} (ADR-0114). */
+    namespace?: string | null;
     name: string;
     description?: string;
     /** 분류 하나 — 팔레트에서 묶어 보이는 기준. */

package/dist-client/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../client/types.ts"],"names":[],"mappings":"AAAA;;GAEG","sourcesContent":["/**\n * 화면이 다루는 모양. 도형 자산의 타입은 `@hatiolab/figure-model` 이 정한다 — 여기서 다시 적지 않는다.\n */\n\n/** 서버가 돌려주는 Figure 한 벌. `source` 는 상세 또는 저작면을 열 때만 받는다. */\nexport interface Figure {\n  id: string\n  /** 컴포넌트 타입 이름. **만든 뒤에 고칠 수 없다.** */\n  type: string\n  name: string\n  description?: string\n  /** 분류 하나 — 팔레트에서 묶어 보이는 기준. */\n  category?: string\n  /** 태그 여럿 — 분류로는 못 하는 찾기. */\n  tags?: string[]\n  state?: 'draft' | 'released'\n  /** 재활용 점수 0~100. 서버가 정본에서 계산한다 — 화면이 보내는 값이 아니다. */\n  score?: number\n  triangles?: number\n  groups?: number\n  thumbnail?: string\n  thumbnailUpdatedAt?: string\n  updatedAt?: string\n  updater?: { id: string; name: string }\n  /** 도형 자산 JSON 문자열. 목록 질의에는 실려 오지 않는다. */\n  source?: string\n  properties?: string\n  version?: number\n}\n\n/**\n * 발행된 판 하나.\n *\n * 저작 중 저장은 여기 오지 않는다 — 판본은 발행에서만 생긴다.\n */\nexport interface FigureVersion {\n  version: number\n  /** 발행하며 남긴 말. */\n  comment?: string\n  state?: 'draft' | 'released'\n  updatedAt?: string\n  updater?: { id: string; name: string }\n  score?: number\n  triangles?: number\n  groups?: number\n}\n\nexport interface FigureListResult {\n  items: Figure[]\n  total: number\n}\n\n/**\n * 새 Figure.\n *\n * `score`·`triangles`·`groups` 가 없다 — **서버가 정본에서 계산한다.** 화면이 보내면\n * 거짓이 들어오고 목록이 실물과 다른 것을 보여 준다.\n */\nexport interface NewFigure {\n  type: string\n  name: string\n  description?: string\n  category?: string\n  tags?: string[]\n  source: string\n  properties?: string\n  state?: 'draft' | 'released'\n  thumbnail?: string\n}\n\n/**\n * 수정.\n *\n * `type` 이 없다 — 저장되는 식별자라 고칠 수 없다. 배치된 도면이 그 이름으로 타입을\n * 찾으므로, 바꾸면 그 도면이 빈 화면이 된다.\n */\nexport interface FigurePatch {\n  /** 발행 전 초안에서만 받는다 — 발행된 뒤에는 문이 거절한다(ADR-0063 결정 4). */\n  type?: string\n  name?: string\n  description?: string\n  category?: string\n  /** 빈 배열은 「전부 지운다」, 안 주는 것은 「건드리지 않는다」. */\n  tags?: string[]\n  source?: string\n  properties?: string\n  state?: 'draft' | 'released'\n  thumbnail?: string\n}\n\n/** 검증 결과 한 줄. 코드는 figure-model 의 것을 그대로 쓴다. */\nexport interface FigureFinding {\n  code: string\n  message: string\n  at?: string\n}\n\n/**\n * 발행 판정 한 줄.\n *\n * `FigureFinding` 과 달리 **`blocking` 이 있다.** 저장 쪽 발견은 정의상 막지 않는 것들이고,\n * 발행 판정은 막는 것과 알리는 것을 함께 내므로 어느 쪽인지를 값이 스스로 말한다 — 코드를 보고\n * 화면이 다시 분류하면 규칙이 두 벌이 된다.\n */\nexport interface FigureGateFinding {\n  code: string\n  message: string\n  /** 왜 그것이 문제인가 — 사람이 무엇을 보게 되나. */\n  why?: string\n  /** 무엇을 바꾸면 되나 — 부품 이름과 값으로. */\n  how?: string\n  /** 갈라진 부품 이름들, 또는 정본 안의 경로. */\n  at?: string\n  blocking: boolean\n}\n\n/** 발행해도 되나. `blocked` 면 서버가 거절한다. */\nexport interface FigureInspection {\n  blocked: boolean\n  findings: FigureGateFinding[]\n}\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../client/types.ts"],"names":[],"mappings":"AAAA;;GAEG","sourcesContent":["/**\n * 화면이 다루는 모양. 도형 자산의 타입은 `@hatiolab/figure-model` 이 정한다 — 여기서 다시 적지 않는다.\n */\n\n/** 서버가 돌려주는 Figure 한 벌. `source` 는 상세 또는 저작면을 열 때만 받는다. */\nexport interface Figure {\n  id: string\n  /** 컴포넌트 타입 이름. **만든 뒤에 고칠 수 없다.** */\n  type: string\n  /** Namespace of the full name {namespace}/{type} (ADR-0114). */\n  namespace?: string | null\n  name: string\n  description?: string\n  /** 분류 하나 — 팔레트에서 묶어 보이는 기준. */\n  category?: string\n  /** 태그 여럿 — 분류로는 못 하는 찾기. */\n  tags?: string[]\n  state?: 'draft' | 'released'\n  /** 재활용 점수 0~100. 서버가 정본에서 계산한다 — 화면이 보내는 값이 아니다. */\n  score?: number\n  triangles?: number\n  groups?: number\n  thumbnail?: string\n  thumbnailUpdatedAt?: string\n  updatedAt?: string\n  updater?: { id: string; name: string }\n  /** 도형 자산 JSON 문자열. 목록 질의에는 실려 오지 않는다. */\n  source?: string\n  properties?: string\n  version?: number\n}\n\n/**\n * 발행된 판 하나.\n *\n * 저작 중 저장은 여기 오지 않는다 — 판본은 발행에서만 생긴다.\n */\nexport interface FigureVersion {\n  version: number\n  /** 발행하며 남긴 말. */\n  comment?: string\n  state?: 'draft' | 'released'\n  updatedAt?: string\n  updater?: { id: string; name: string }\n  score?: number\n  triangles?: number\n  groups?: number\n}\n\nexport interface FigureListResult {\n  items: Figure[]\n  total: number\n}\n\n/**\n * 새 Figure.\n *\n * `score`·`triangles`·`groups` 가 없다 — **서버가 정본에서 계산한다.** 화면이 보내면\n * 거짓이 들어오고 목록이 실물과 다른 것을 보여 준다.\n */\nexport interface NewFigure {\n  type: string\n  name: string\n  description?: string\n  category?: string\n  tags?: string[]\n  source: string\n  properties?: string\n  state?: 'draft' | 'released'\n  thumbnail?: string\n}\n\n/**\n * 수정.\n *\n * `type` 이 없다 — 저장되는 식별자라 고칠 수 없다. 배치된 도면이 그 이름으로 타입을\n * 찾으므로, 바꾸면 그 도면이 빈 화면이 된다.\n */\nexport interface FigurePatch {\n  /** 발행 전 초안에서만 받는다 — 발행된 뒤에는 문이 거절한다(ADR-0063 결정 4). */\n  type?: string\n  name?: string\n  description?: string\n  category?: string\n  /** 빈 배열은 「전부 지운다」, 안 주는 것은 「건드리지 않는다」. */\n  tags?: string[]\n  source?: string\n  properties?: string\n  state?: 'draft' | 'released'\n  thumbnail?: string\n}\n\n/** 검증 결과 한 줄. 코드는 figure-model 의 것을 그대로 쓴다. */\nexport interface FigureFinding {\n  code: string\n  message: string\n  at?: string\n}\n\n/**\n * 발행 판정 한 줄.\n *\n * `FigureFinding` 과 달리 **`blocking` 이 있다.** 저장 쪽 발견은 정의상 막지 않는 것들이고,\n * 발행 판정은 막는 것과 알리는 것을 함께 내므로 어느 쪽인지를 값이 스스로 말한다 — 코드를 보고\n * 화면이 다시 분류하면 규칙이 두 벌이 된다.\n */\nexport interface FigureGateFinding {\n  code: string\n  message: string\n  /** 왜 그것이 문제인가 — 사람이 무엇을 보게 되나. */\n  why?: string\n  /** 무엇을 바꾸면 되나 — 부품 이름과 값으로. */\n  how?: string\n  /** 갈라진 부품 이름들, 또는 정본 안의 경로. */\n  at?: string\n  blocking: boolean\n}\n\n/** 발행해도 되나. `blocked` 면 서버가 거절한다. */\nexport interface FigureInspection {\n  blocked: boolean\n  findings: FigureGateFinding[]\n}\n"]}

package/docs/product-cutover.md

@@ -1,20 +1,20 @@
-# V3 제품 현황
+# Figure 제품 현황
 
-형식은 V3(`figure-asset-1`) 하나다. V1·V2 형식은 2026-09-26 코드와 명세에서 제거했다.
+형식은 `figure-asset-1` 하나다. 옛 형식 V1·V2는 2026-09-26 코드와 명세에서 제거했다.
 
 ## 제품 코드
 
 - `client/modeller/product-session.ts`: 모델 ID·로드·저장 경계를 workspace에 연결한다. 다른 모델의 지연 응답을 버리며 로드 실패 시 이전 형상을 노출하지 않는다. UI/AI는 같은 리비전과 undo/redo를 사용한다. AI 편집은 요청 당시 context/revision을 필수로 받는다.
-- `client/modeller/canvas.ts`: things-scene 편집 모드의 판 위에 평가된 V3 형상을 부품마다 `figure-part` 컴포넌트로 세운다. 새 문맥에서 렌더링이 실패하면 이전 모델을 지운다.
+- `client/modeller/canvas.ts`: things-scene 편집 모드의 판 위에 평가된 Figure 형상을 부품마다 `figure-part` 컴포넌트로 세운다. 새 문맥에서 렌더링이 실패하면 이전 모델을 지운다.
 - `client/modeller/editor.ts`: 부품 목록 · 캔버스 · 오른쪽 탭(속성 · 능력 · 움직임 · 판정 · 환경 · 이력). 실행 취소/다시 실행과 저장 연결.
 - `client/graphql/store.ts`: 정본을 그대로 `saveFigure`로 보낸다.
-- figure-service의 `saveFigure`: 도메인 권한 검사, V3 검증, 정확한 이전 정본을 조건으로 하는 atomic UPDATE, 생성 요청 ID를 이용한 재시도. SQLite에서 지원하지 않는 행 잠금은 사용하지 않는다. 재지 않은 성능 점수/삼각형 수는 null로 둔다. 실제 운영 DB 저장 테스트는 아직 하지 않았다.
-- `client/pages/figure-modeller-page.ts`: 위 요소를 묶는 페이지. `route.ts`의 `figure-modeller`와 `figure-modeller`가 이 페이지를 연다.
+- figure-service의 `saveFigure`: 도메인 권한 검사, 자산 검증, 정확한 이전 정본을 조건으로 하는 atomic UPDATE, 생성 요청 ID를 이용한 재시도. SQLite에서 지원하지 않는 행 잠금은 사용하지 않는다. 재지 않은 성능 점수/삼각형 수는 null로 둔다. 실제 운영 DB 저장 테스트는 아직 하지 않았다.
+- `client/pages/figure-modeller-page.ts`: 위 요소를 묶는 페이지. `route.ts`의 `figure-modeller`가 이 페이지를 연다.
 
 ## 남은 항목
 
-1. operato-figure의 AI-dock과 figure-service 도구/제안 생성기를 V3 정본 및 승인된 트랜잭션 계약으로 연결한다. 페이지 이벤트만 추가한 것은 AI 통합 완료가 아니다.
-2. 발행 게이트, 썸네일, 카탈로그/배치 소비처가 V3 평가 결과를 사용하는지 확인한다.
+1. operato-figure의 AI-dock과 figure-service 도구/제안 생성기를 Figure 정본 및 승인된 트랜잭션 계약으로 연결한다. 페이지 이벤트만 추가한 것은 AI 통합 완료가 아니다.
+2. 발행 게이트, 썸네일, 카탈로그/배치 소비처가 Figure 평가 결과를 사용하는지 확인한다.
 
 ## 검증
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@things-factory/figure-ui",
-  "version": "10.1.117",
+  "version": "10.1.121",
   "publishConfig": {
     "access": "public",
     "@things-factory:registry": "https://registry.npmjs.org"
@@ -27,8 +27,8 @@
     "clean": "npm run clean:server && npm run clean:client"
   },
   "dependencies": {
-    "@hatiolab/figure-model": "^0.3.3",
-    "@hatiolab/things-scene": "^10.1.72",
+    "@hatiolab/figure-model": "^0.4.0",
+    "@hatiolab/things-scene": "^10.1.74",
     "@material/web": "^2.0.0",
     "@operato/data-grist": "^10.0.0",
     "@operato/graphql": "^10.0.0",
@@ -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.116",
-    "@things-factory/figure-service": "^10.1.117",
+    "@things-factory/ai-assistant": "^10.1.121",
+    "@things-factory/figure-service": "^10.1.121",
     "three": "^0.185.1"
   },
-  "gitHead": "cab2426c1c6e63b53a0a2087eef28c9c55df71dd"
+  "gitHead": "23536a73b10f103048a2c893d3960b2a4e0f03dd"
 }

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

@@ -13,18 +13,18 @@ import { suggestTypeOf, releasableType } from '../client/modeller/first-save.js'
 const read = (path: string) => readFileSync(fileURLToPath(new URL(path, import.meta.url)), 'utf8')
 
 test('an identifier is offered for any name: plain letters as they are, anything else a prefix and a random part', () => {
-  assert.equal(suggestTypeOf('Lift table', []), 'LIFT_TABLE')
-  assert.equal(suggestTypeOf('roller-conveyor 2', []), 'ROLLER_CONVEYOR_2')
+  assert.equal(suggestTypeOf('Lift table', []), 'lift-table')
+  assert.equal(suggestTypeOf('roller-conveyor 2', []), 'roller-conveyor-2')
   for (const name of ['리프트 테이블', '새 Figure', '', '___', '2층 선반']) {
     const made = suggestTypeOf(name, [])
-    assert.match(made, /^FIG_[0-9A-Z]{6}$/, name)
+    assert.match(made, /^fig-[0-9a-z]{6}$/, name)
     assert.ok(releasableType(made) && TYPE_PATTERN.test(made) && made.length >= TYPE_LENGTH.min && !isPlaceholderType(made))
   }
   /* Never one already used: a taken name falls back, a taken random part is drawn again. */
-  assert.match(suggestTypeOf('Lift table', ['LIFT_TABLE']), /^FIG_/)
+  assert.match(suggestTypeOf('Lift table', ['lift-table']), /^fig-/)
   let n = 0
   const draws = [0, 0, 0, 0, 0, 0, 0.5, 0.5, 0.5, 0.5, 0.5, 0.5]
-  assert.equal(suggestTypeOf('선반', ['FIG_000000'], () => draws[n++ % draws.length]!), 'FIG_IIIIII')
+  assert.equal(suggestTypeOf('선반', ['fig-000000'], () => draws[n++ % draws.length]!), 'fig-iiiiii')
 })
 
 test('the first save asks the name first; the identifier offered stays through retries, and renaming does not change it', () => {

package/test/first-save.test.ts

@@ -8,23 +8,25 @@ import { placeholderType } from '@hatiolab/figure-model'
 import { firstSaveRefusalOf, releasableType, typeOf } from '../client/modeller/first-save.ts'
 import { createFigureProductSession, type FigureProductStore } from '../client/modeller/product-session.ts'
 
-test('치는 대로 타입의 모양이 된다 — 대문자 · 숫자 · 밑줄', () => {
-  assert.equal(typeOf(' agv lifter '), 'AGV_LIFTER')
-  assert.equal(typeOf('oht-2'), 'OHT_2')
+test('치는 대로 타입의 모양이 된다 — 소문자 · 숫자 · 하이픈 하나', () => {
+  assert.equal(typeOf(' agv lifter '), 'agv-lifter')
+  assert.equal(typeOf('OHT_2'), 'oht-2')
+  assert.equal(typeOf('-Roller  Conveyor-'), 'roller-conveyor')
 })
 
 test('발행할 수 없는 이름은 미리 말한다 — 임시 이름 · 형식 · 길이', () => {
-  assert.equal(releasableType('AGV_LIFTER'), true)
+  assert.equal(releasableType('agv-lifter'), true)
   assert.equal(releasableType(placeholderType()), false, '서버가 붙이는 임시 이름')
-  assert.equal(releasableType('AB'), false, '3 자 미만')
-  assert.equal(releasableType('A__B'), false, '밑줄 둘')
-  assert.equal(releasableType('_OHT'), false)
+  assert.equal(releasableType('a'), false, '2 자 미만')
+  assert.equal(releasableType('a--b'), false, '하이픈 둘')
+  assert.equal(releasableType('-oht'), false)
+  assert.equal(releasableType('AGV_LIFTER'), false, '대문자 · 밑줄')
 })
 
 test('비었거나 이미 쓰는 이름이면 저장하지 않는다', () => {
-  assert.deepEqual(firstSaveRefusalOf('', ['OHT']), { key: 'figure.text.enter-a-type-name' })
-  assert.deepEqual(firstSaveRefusalOf('OHT', ['OHT']), { key: 'figure.text.type-name-already-taken', type: 'OHT' })
-  assert.equal(firstSaveRefusalOf('AGV', ['OHT']), null)
+  assert.deepEqual(firstSaveRefusalOf('', ['oht']), { key: 'figure.text.enter-a-type-name' })
+  assert.deepEqual(firstSaveRefusalOf('oht', ['oht']), { key: 'figure.text.type-name-already-taken', type: 'oht' })
+  assert.equal(firstSaveRefusalOf('agv', ['oht']), null)
 })
 
 /** A store that remembers what it was asked. */
@@ -46,12 +48,12 @@ test('타입은 새 도형을 만드는 저장에만 실린다 — 이미 있는
   const { store, requests } = recording()
   const session = createFigureProductSession(store)
   session.startNew()
-  await session.save({ type: 'AGV_LIFTER' })
-  assert.equal(requests[0]!.type, 'AGV_LIFTER')
+  await session.save({ type: 'agv-lifter' })
+  assert.equal(requests[0]!.type, 'agv-lifter')
   assert.equal(requests[0]!.id, undefined, '만드는 저장')
 
   session.command({ kind: 'rename', name: '리프터' })
-  await session.save({ type: 'OTHER' })
+  await session.save({ type: 'other' })
   assert.equal(requests[1]!.id, 'new-id')
   assert.equal('type' in requests[1]!, false, '있는 도형에는 보내지 않는다')
 })

package/test/package-download.test.ts

@@ -0,0 +1,16 @@
+/*
+ * A released version downloads as a package by its release reference {namespace}/{type}@{version} (ADR-0114).
+ */
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+import { readFileSync } from 'node:fs'
+
+const panel = readFileSync(new URL('../client/modeller/figure-history-panel.ts', import.meta.url), 'utf8')
+
+test('each released version links to the package door by its full reference, only once the figure has a full name', () => {
+  const href = panel.slice(panel.indexOf('private packageHref'), panel.indexOf('private renderVersion'))
+  assert.match(href, /if \(!this\.figureNamespace \|\| !this\.figureType\) return undefined/)
+  assert.match(href, /`\$\{contextPath\}\/figure-package\?refs=\$\{encodeURIComponent\(`\$\{this\.figureNamespace\}\/\$\{this\.figureType\}@\$\{version\}`\)\}`/)
+  const row = panel.slice(panel.indexOf('private renderVersion'), panel.indexOf('private renderKept'))
+  assert.match(row, /<a package download href=/)
+})

package/translations/en.json

@@ -983,5 +983,6 @@
   "figure.text.detail-no-motion": "No motion is defined.",
   "figure.text.detail-playing": "Playing",
   "figure.label.detail-summary": "Drawing cost of the selected model",
-  "figure.text.detail-paused": "Paused"
+  "figure.text.detail-paused": "Paused",
+  "figure.button.download-package": "download package"
 }

package/translations/ja.json

@@ -983,5 +983,6 @@
   "figure.text.detail-no-motion": "登録された動きがありません。",
   "figure.text.detail-playing": "再生中",
   "figure.label.detail-summary": "選択したモデルの描画コスト",
-  "figure.text.detail-paused": "一時停止"
+  "figure.text.detail-paused": "一時停止",
+  "figure.button.download-package": "パッケージをダウンロード"
 }

package/translations/ko.json

@@ -983,5 +983,6 @@
   "figure.text.detail-no-motion": "등록된 움직임이 없습니다.",
   "figure.text.detail-playing": "재생 중",
   "figure.label.detail-summary": "선택한 모델의 그리기 비용",
-  "figure.text.detail-paused": "일시정지"
+  "figure.text.detail-paused": "일시정지",
+  "figure.button.download-package": "꾸러미 내려받기"
 }

package/translations/ms.json

@@ -983,5 +983,6 @@
   "figure.text.detail-no-motion": "Tiada gerakan didaftarkan.",
   "figure.text.detail-playing": "Sedang dimainkan",
   "figure.label.detail-summary": "Kos lukisan model yang dipilih",
-  "figure.text.detail-paused": "Dijeda"
+  "figure.text.detail-paused": "Dijeda",
+  "figure.button.download-package": "muat turun pakej"
 }

package/translations/zh.json

@@ -983,5 +983,6 @@
   "figure.text.detail-no-motion": "没有已注册的动作。",
   "figure.text.detail-playing": "播放中",
   "figure.label.detail-summary": "所选模型的绘制成本",
-  "figure.text.detail-paused": "已暂停"
+  "figure.text.detail-paused": "已暂停",
+  "figure.button.download-package": "下载包"
 }