@things-factory/figure-ui 10.1.34 → 10.1.35

package/dist-client/types.d.ts

@@ -161,6 +161,12 @@ export interface FigureGateFix {
     /** All blocking sizing cases clear after this exact edit was remeasured server-side. */
     safe: boolean;
 }
+/** A server-remeasured set of draft-only changes that clears every blocking sizing split. */
+export interface FigureGateFixPlan {
+    fixes: FigureGateFix[];
+    resolved: number;
+    safe: boolean;
+}
 export interface FigureGateFinding {
     code: string;
     message: string;
@@ -172,6 +178,7 @@ export interface FigureGateFinding {
     at?: string;
     /** Candidate edits; the UI must preview and explicitly apply these, never auto-save them. */
     fixes?: FigureGateFix[];
+    fixPlan?: FigureGateFixPlan;
     blocking: boolean;
 }
 /** 발행해도 되나. `blocked` 면 서버가 거절한다. */

package/dist-client/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../client/types.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * 화면이 다루는 모양.\n *\n * 정본 형식(`FigureSource`)의 타입은 **여기서 다시 정의하지 않는다** —\n * `@hatiolab/figure-model` 에서 가져온다. 두 벌이면 갈리고, 갈리면 화면이 서버가\n * 거절할 것을 만들어 낸다.\n */\nexport type { FigureSource, FigureBlueprint, FigurePart, ErrorCode, ViolationCode } from '@hatiolab/figure-model'\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  /** `FigureSource` 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 * **정본이 아니다.** 저작자가 보고 받아야 정본이 된다 — 서버는 저장하지 않고\n * 돌려주기만 한다.\n */\nexport interface FigureProposal {\n  /** 후보 정본. JSON 문자열이다 — 화면이 파싱한다. */\n  source: string\n  score: number\n  grade: string\n  triangles: number\n  /** 재질 묶음 = 인스턴스 하나가 무는 draw call. */\n  groups: number\n  /** Rule-based review of measurable design concerns; it is not an aesthetic verdict. */\n  quality: {\n    status: 'ready' | 'review'\n    summary: string\n    findings: Array<{ dimension: string; code: string; message: string }>\n    visualRegions: number\n    visualCoverage: number\n    visualReadability: number\n  }\n  /** 형식은 맞으나 정책을 넘은 것. 막지 않는다 — 저작자가 정한다. */\n  violations: FigureFinding[]\n  /** 몇 번 만에 됐나. 진단용이다. */\n  attempts: number\n}\n\n/** 사람이 후보를 수락하거나 버릴 때 직접 남긴 현재 저작 세션의 참고 신호. */\nexport interface ProposalFeedback {\n  outcome: 'accepted' | 'discarded'\n  selectedChanges: number\n  totalChanges: number\n  note?: string\n  grade?: string\n  quality?: { status?: 'ready' | 'review'; findingCodes?: string[] }\n}\n\n/**\n * 발행 판정 한 줄.\n *\n * `FigureFinding` 과 달리 **`blocking` 이 있다.** 저장 쪽 발견은 정의상 막지 않는 것들이고,\n * 발행 판정은 막는 것과 알리는 것을 함께 내므로 어느 쪽인지를 값이 스스로 말한다 — 코드를 보고\n * 화면이 다시 분류하면 규칙이 두 벌이 된다.\n */\n/** One reversible anchor edit the sizing gate has measured against this exact source. */\nexport interface FigureGateFix {\n  findingWay: string\n  part: string\n  axis: 'x' | 'y' | 'z'\n  from?: string\n  to: 'min' | 'center' | 'max' | 'span'\n  resolved: number\n  /** All blocking sizing cases clear after this exact edit was remeasured server-side. */\n  safe: boolean\n}\n\nexport interface FigureGateFinding {\n  code: string\n  message: string\n  /** 왜 그것이 문제인가 — 사람이 무엇을 보게 되나. */\n  why?: string\n  /** 무엇을 바꾸면 되나 — 부품 이름과 값으로. */\n  how?: string\n  /** 갈라진 부품 이름들, 또는 정본 안의 경로. */\n  at?: string\n  /** Candidate edits; the UI must preview and explicitly apply these, never auto-save them. */\n  fixes?: FigureGateFix[]\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":"","sourcesContent":["/**\n * 화면이 다루는 모양.\n *\n * 정본 형식(`FigureSource`)의 타입은 **여기서 다시 정의하지 않는다** —\n * `@hatiolab/figure-model` 에서 가져온다. 두 벌이면 갈리고, 갈리면 화면이 서버가\n * 거절할 것을 만들어 낸다.\n */\nexport type { FigureSource, FigureBlueprint, FigurePart, ErrorCode, ViolationCode } from '@hatiolab/figure-model'\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  /** `FigureSource` 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 * **정본이 아니다.** 저작자가 보고 받아야 정본이 된다 — 서버는 저장하지 않고\n * 돌려주기만 한다.\n */\nexport interface FigureProposal {\n  /** 후보 정본. JSON 문자열이다 — 화면이 파싱한다. */\n  source: string\n  score: number\n  grade: string\n  triangles: number\n  /** 재질 묶음 = 인스턴스 하나가 무는 draw call. */\n  groups: number\n  /** Rule-based review of measurable design concerns; it is not an aesthetic verdict. */\n  quality: {\n    status: 'ready' | 'review'\n    summary: string\n    findings: Array<{ dimension: string; code: string; message: string }>\n    visualRegions: number\n    visualCoverage: number\n    visualReadability: number\n  }\n  /** 형식은 맞으나 정책을 넘은 것. 막지 않는다 — 저작자가 정한다. */\n  violations: FigureFinding[]\n  /** 몇 번 만에 됐나. 진단용이다. */\n  attempts: number\n}\n\n/** 사람이 후보를 수락하거나 버릴 때 직접 남긴 현재 저작 세션의 참고 신호. */\nexport interface ProposalFeedback {\n  outcome: 'accepted' | 'discarded'\n  selectedChanges: number\n  totalChanges: number\n  note?: string\n  grade?: string\n  quality?: { status?: 'ready' | 'review'; findingCodes?: string[] }\n}\n\n/**\n * 발행 판정 한 줄.\n *\n * `FigureFinding` 과 달리 **`blocking` 이 있다.** 저장 쪽 발견은 정의상 막지 않는 것들이고,\n * 발행 판정은 막는 것과 알리는 것을 함께 내므로 어느 쪽인지를 값이 스스로 말한다 — 코드를 보고\n * 화면이 다시 분류하면 규칙이 두 벌이 된다.\n */\n/** One reversible anchor edit the sizing gate has measured against this exact source. */\nexport interface FigureGateFix {\n  findingWay: string\n  part: string\n  axis: 'x' | 'y' | 'z'\n  from?: string\n  to: 'min' | 'center' | 'max' | 'span'\n  resolved: number\n  /** All blocking sizing cases clear after this exact edit was remeasured server-side. */\n  safe: boolean\n}\n\n/** A server-remeasured set of draft-only changes that clears every blocking sizing split. */\nexport interface FigureGateFixPlan {\n  fixes: FigureGateFix[]\n  resolved: number\n  safe: boolean\n}\n\nexport interface FigureGateFinding {\n  code: string\n  message: string\n  /** 왜 그것이 문제인가 — 사람이 무엇을 보게 되나. */\n  why?: string\n  /** 무엇을 바꾸면 되나 — 부품 이름과 값으로. */\n  how?: string\n  /** 갈라진 부품 이름들, 또는 정본 안의 경로. */\n  at?: string\n  /** Candidate edits; the UI must preview and explicitly apply these, never auto-save them. */\n  fixes?: FigureGateFix[]\n  fixPlan?: FigureGateFixPlan\n  blocking: boolean\n}\n\n/** 발행해도 되나. `blocked` 면 서버가 거절한다. */\nexport interface FigureInspection {\n  blocked: boolean\n  findings: FigureGateFinding[]\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@things-factory/figure-ui",
-  "version": "10.1.34",
+  "version": "10.1.35",
   "publishConfig": {
     "access": "public",
     "@things-factory:registry": "https://registry.npmjs.org"
@@ -26,7 +26,7 @@
     "clean": "npm run clean:server && npm run clean:client"
   },
   "dependencies": {
-    "@hatiolab/figure-model": "^0.1.27",
+    "@hatiolab/figure-model": "^0.1.32",
     "@hatiolab/things-scene": "^10.1.22",
     "@material/web": "^2.0.0",
     "@operato/data-grist": "^10.0.0",
@@ -37,8 +37,8 @@
     "@operato/shell": "^10.0.0",
     "@operato/styles": "^10.0.0",
     "@operato/utils": "^10.0.0",
-    "@things-factory/figure-service": "^10.1.34",
+    "@things-factory/figure-service": "^10.1.35",
     "three": "^0.185.1"
   },
-  "gitHead": "5e16fd9f0cbb71c8d395b58a95bd9e99c93975c7"
+  "gitHead": "396f43b648b704f1938a2d890ab2f6efa33fdb86"
 }

package/test/v3-renderer.test.ts

@@ -0,0 +1,24 @@
+import {test} from 'node:test'
+import assert from 'node:assert/strict'
+import * as THREE from 'three'
+import {replaceV3Meshes} from '../client/modeller/v3-renderer.ts'
+import type {V3RenderPart} from '../client/modeller/v3-renderer.ts'
+const box=(id:string):V3RenderPart=>({id,shape:{provider:'box',dimensions:{width:100,height:200,depth:300}},pose:{r:[[1,0,0],[0,1,0],[0,0,1]],t:[0,100,0]},material:{token:'primary'}})
+test('V3 renderer replaces rather than accumulates; empty scene disposes old resources',()=>{
+ const group=new THREE.Group();replaceV3Meshes(group,[box('a'),box('b')],{primary:'#123456'})
+ assert.equal(group.children.length,2);let disposed=0
+ const first=group.children[0] as THREE.Mesh;first.geometry.addEventListener('dispose',()=>disposed++)
+ replaceV3Meshes(group,[box('c')],{primary:'#123456'});assert.equal(group.children.length,1);assert.equal(group.children[0].name,'c');assert.equal(disposed,1)
+ replaceV3Meshes(group,[],{});assert.equal(group.children.length,0)
+})
+test('V3 renderer preserves scene on unsupported geometry and resolves pose/material',()=>{
+ const group=new THREE.Group();replaceV3Meshes(group,[box('a')],{primary:'#123456'})
+ const old=group.children[0],bounds=new THREE.Box3().setFromObject(group)
+ assert.equal(bounds.min.y,0);assert.equal(bounds.max.y,200)
+ assert.throws(()=>replaceV3Meshes(group,[box('b'),{...box('c'),shape:{provider:'unknown',dimensions:{}}}],{primary:'#123456'}),/Unsupported/)
+ assert.equal(group.children[0],old)
+ const p=box('glow');p.material={token:'primary',preset:'metal',transparent:true,emissive:{token:'primary',intensity:2,on:true}}
+ replaceV3Meshes(group,[p],{primary:'#123456'})
+ const material=(group.children[0] as THREE.Mesh).material as THREE.MeshStandardMaterial
+ assert.equal(material.metalness,0.8);assert.equal(material.transparent,true);assert.equal(material.emissiveIntensity,2)
+})

package/translations/en.json

@@ -4,6 +4,7 @@
   "figure.button.add-key": "add key",
   "figure.button.add-parameter": "add parameter",
   "figure.button.apply-fix": "apply fix · {part} {axis} face: {from} → {to}",
+  "figure.button.apply-recommended-fix": "apply recommended fix",
   "figure.button.ask": "ask",
   "figure.button.cancel": "cancel",
   "figure.button.center-x": "centre X",
@@ -35,6 +36,8 @@
   "figure.button.settle-on-floor": "settle on the floor",
   "figure.button.snap": "snap",
   "figure.button.take-n-changes": "apply {n}",
+  "figure.text.recommended-fix-explained": "{n} changes rechecked against every resize case. They apply to this draft only; review and save when ready.",
+  "figure.text.show-affected-parts": "show affected parts",
   "figure.button.to-floor": "to floor",
   "figure.button.undo": "undo",
   "figure.label.accepts": "accepts",

package/translations/ja.json

@@ -4,6 +4,7 @@
   "figure.button.add-key": "キーを追加",
   "figure.button.add-parameter": "パラメーターを追加",
   "figure.button.apply-fix": "修正を適用 · {part} {axis} 固定面: {from} → {to}",
+  "figure.button.apply-recommended-fix": "推奨修正を適用",
   "figure.button.ask": "ask",
   "figure.button.cancel": "キャンセル",
   "figure.button.center-x": "centre X",
@@ -33,6 +34,8 @@
   "figure.button.settle-on-floor": "床に置く",
   "figure.button.snap": "snap",
   "figure.button.take-n-changes": "apply {n}",
+  "figure.text.recommended-fix-explained": "すべてのサイズ変更ケースを再検査した {n} 件の修正です。下書きだけに適用され、保存前に確認できます。",
+  "figure.text.show-affected-parts": "影響する部品を見る",
   "figure.button.to-floor": "to floor",
   "figure.button.undo": "元に戻す",
   "figure.label.accepts": "受け入れるもの",

package/translations/ko.json

@@ -4,6 +4,7 @@
   "figure.button.add-key": "키 추가",
   "figure.button.add-parameter": "파라미터 추가",
   "figure.button.apply-fix": "수정 적용 · {part} {axis} 고정 면: {from} → {to}",
+  "figure.button.apply-recommended-fix": "권장 수정 적용",
   "figure.button.ask": "요청",
   "figure.button.cancel": "취소",
   "figure.button.center-x": "X 가운데",
@@ -35,6 +36,8 @@
   "figure.button.settle-on-floor": "바닥에 앉히기",
   "figure.button.snap": "눈금에",
   "figure.button.take-n-changes": "{n}개 적용",
+  "figure.text.recommended-fix-explained": "서버가 전체 크기 변경을 다시 검사한 {n}개 수정입니다. 초안에만 적용되며 저장 전 확인할 수 있습니다.",
+  "figure.text.show-affected-parts": "영향 받는 부품 보기",
   "figure.button.to-floor": "바닥에",
   "figure.button.undo": "실행 취소",
   "figure.label.accepts": "받는 것",

package/translations/ms.json

@@ -4,6 +4,7 @@
   "figure.button.add-key": "tambah kunci",
   "figure.button.add-parameter": "tambah parameter",
   "figure.button.apply-fix": "guna pembetulan · {part} {axis} muka: {from} → {to}",
+  "figure.button.apply-recommended-fix": "guna pembetulan disyorkan",
   "figure.button.ask": "ask",
   "figure.button.cancel": "batal",
   "figure.button.center-x": "centre X",
@@ -33,6 +34,8 @@
   "figure.button.settle-on-floor": "letak di lantai",
   "figure.button.snap": "snap",
   "figure.button.take-n-changes": "apply {n}",
+  "figure.text.recommended-fix-explained": "{n} pembetulan telah diperiksa semula untuk semua keadaan saiz. Ia hanya digunakan pada draf ini; semak dan simpan apabila sedia.",
+  "figure.text.show-affected-parts": "tunjukkan bahagian terjejas",
   "figure.button.to-floor": "to floor",
   "figure.button.undo": "Nyahbuat",
   "figure.label.accepts": "diterima",

package/translations/zh.json

@@ -4,6 +4,7 @@
   "figure.button.add-key": "添加关键帧",
   "figure.button.add-parameter": "添加参数",
   "figure.button.apply-fix": "应用修正 · {part} {axis} 固定面: {from} → {to}",
+  "figure.button.apply-recommended-fix": "应用推荐修正",
   "figure.button.ask": "ask",
   "figure.button.cancel": "取消",
   "figure.button.center-x": "centre X",
@@ -33,6 +34,8 @@
   "figure.button.settle-on-floor": "落到地面",
   "figure.button.snap": "snap",
   "figure.button.take-n-changes": "apply {n}",
+  "figure.text.recommended-fix-explained": "已针对所有尺寸变化情况重新检查的 {n} 项修正。它们只应用到草稿；请确认后再保存。",
+  "figure.text.show-affected-parts": "查看受影响部件",
   "figure.button.to-floor": "to floor",
   "figure.button.undo": "撤销",
   "figure.label.accepts": "接受的类型",