@things-factory/figure-ui 10.1.34 → 10.1.36

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/docs/v3-product-cutover.md

@@ -0,0 +1,35 @@
+# V3 제품 전환 현황
+
+기준일: 2026-09-21. **풀적용·배포 완료 문서가 아니다.** V3 단일 제품 경로가 목표이며 V2 병행 운영이 목표가 아니다.
+
+## 작성한 제품 코드
+
+- `client/modeller/v3-product-session.ts`: 모델 ID·로드·저장 경계를 V3 workspace에 연결한다. 다른 모델의 지연 응답을 버리며 로드 실패 시 이전 형상을 노출하지 않는다. UI/AI는 같은 리비전과 undo/redo를 사용한다. AI 편집은 요청 당시 context/revision을 필수로 받는다.
+- `client/modeller/v3-canvas.ts`: 평가된 V3 형상을 Three.js에 직접 전달한다. 이전 parts/base 형식으로 변환하지 않는다. 새 문맥에서 렌더링이 실패하면 이전 모델을 지운다.
+- `client/modeller/v3-editor.ts`: 빈 모델, 네 도형 추가, 선언된 수치 입력, 재질 토큰 변경, 실행 취소/다시 실행, 저장 연결. 관계·바인딩 편집, 이름 편집, 전체 재질 편집과 직접 조작 도구는 아직 부족하다.
+- `client/graphql/v3-store.ts`: 정본을 변환 없이 `saveFigureV3`로 보낸다.
+- figure-service의 `saveFigureV3`: 도메인 권한 검사, V3 검증, 정확한 이전 정본을 조건으로 하는 atomic UPDATE, 생성 요청 ID를 이용한 재시도. SQLite에서 지원하지 않는 행 잠금은 사용하지 않는다. 기존 V2 성능 점수/삼각형 수는 승계하지 않고 null로 둔다. 실제 운영 DB 저장 테스트는 아직 하지 않았다.
+- `client/pages/figure-v3-modeller-page.ts`: 위 요소를 묶는 페이지를 작성했다. **route.ts는 여전히 기존 페이지를 import한다. 이 새 페이지는 아직 사용자 진입점이 아니다.**
+
+## 데이터 확인
+
+로컬 `operato-application/packages/operato-figure/db.sqlite`를 read-only로 조사했다. 삭제되지 않은 모델 32개 모두 `version: 2`다. 부품 분포는 cube114, cylinder86, polygon4, rect79, sphere5, wall2다. DB와 발행 이력은 변경하지 않았다.
+
+V3의 네 렌더링 공급자만으로 기존 모델 전체가 보존된다고 주장할 수 없다. 구·일반 단면뿐 아니라 관절, 반복, 부품 간 배치 관계, capability, 기본 동작값을 검증해야 한다. 버전 숫자만 변경하거나 형상을 정적 메시로 평탄화하는 것은 전체 전환이 아니다.
+
+## 활성화 전에 끝낼 항목
+
+1. 기존 32개 자산과 발행 이력의 전환 계획·복구본·미지원 항목 보고. 형상 및 움직임을 비교 검증한다.
+2. 새 페이지의 저작 기능 누락을 채우고 실제 브라우저에서 생성·편집·로드·저장·전환을 확인한다.
+3. operato-figure의 AI-dock과 figure-service 도구/제안 생성기를 V3 정본 및 승인된 트랜잭션 계약으로 전환한다. 페이지 이벤트만 추가한 것은 AI 통합 완료가 아니다.
+4. 발행 게이트, 썸네일, 카탈로그/배치 소비처도 V3 평가 결과를 사용하도록 연결한다. V2 평가 함수에 V3 정본을 전달하지 않는다.
+5. 위 작업을 마친 뒤 기본 모델러 route를 새 페이지로 교체하고 이전 구현을 제거한다. 데이터 미전환 상태에서 route만 먼저 바꾸지 않는다.
+
+## 검증
+
+- figure-ui `npm test`: 241개 통과. 신규 세션/저장 검사와 기존 회귀 검사를 합친 수치다.
+- figure-ui client 및 figure-service `tsc --noEmit`: 통과.
+- SQLite in-memory 테스트: 테넌트 경계·이전 정본 비교·오래된 편집 거절. 실제 TypeORM 리졸버/제품 DB end-to-end 검증을 대체하지 않는다.
+- 이번 새 V3 페이지의 실제 브라우저 검증, 기본 route 변경, 패키지 발행·배포는 하지 않았다.
+
+배포는 사용자가 담당한다. 이 문서의 미완료 항목이 남은 채로 제품 전체 V3 전환 완료를 선언하지 않는다.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@things-factory/figure-ui",
-  "version": "10.1.34",
+  "version": "10.1.36",
   "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.35",
     "@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.36",
     "three": "^0.185.1"
   },
-  "gitHead": "5e16fd9f0cbb71c8d395b58a95bd9e99c93975c7"
+  "gitHead": "3942ac0aa4f004b4700e739889e12ffc35d78794"
 }

package/test/v3-product-session.test.ts

@@ -0,0 +1,133 @@
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+import { createV3Asset, addV3Box, serializeV3Asset } from '@hatiolab/figure-model'
+import { createV3ProductSession, type V3ProductRecord } from '../client/modeller/v3-product-session.js'
+
+const source = (name = 'sample') =>
+  serializeV3Asset(
+    addV3Box(createV3Asset(name), {
+      id: 'body',
+      size: { x: 100, y: 100, z: 100 },
+      position: { x: 0, y: 50, z: 0 }
+    })
+  )
+function deferred<T>() {
+  let resolve!: (value: T) => void, reject!: (error: Error) => void
+  const promise = new Promise<T>((yes, no) => {
+    resolve = yes
+    reject = no
+  })
+  return { promise, resolve, reject }
+}
+const store = {
+  load: async (id: string) => ({ id, source: source(id) }),
+  save: async (q: { id?: string; source: string }) => ({ id: q.id ?? 'created', source: q.source })
+}
+
+test('existing model -> new clears geometry, ID, history and derived state', async () => {
+  const s = createV3ProductSession(store)
+  await s.open('A')
+  assert.equal(s.read().geometry.length, 1)
+  const v = s.startNew()
+  assert.equal(v.id, undefined)
+  assert.equal(v.geometry.length, 0)
+  assert.equal(v.canUndo, false)
+  assert.equal(v.dirty, false)
+  assert.equal(JSON.parse(s.source()).version, 'figure-v3-asset-1')
+})
+test('late load cannot overwrite another model or a new figure', async () => {
+  const pending = deferred<V3ProductRecord>()
+  const s = createV3ProductSession({ ...store, load: id => (id === 'A' ? pending.promise : store.load(id)) })
+  const first = s.open('A')
+  await s.open('B')
+  pending.resolve({ id: 'A', source: source('A') })
+  await first
+  assert.equal(s.read().id, 'B')
+  const p = deferred<V3ProductRecord>(),
+    t = createV3ProductSession({ ...store, load: () => p.promise })
+  const loading = t.open('A')
+  t.startNew()
+  p.resolve({ id: 'A', source: source() })
+  await loading
+  assert.equal(t.read().id, undefined)
+  assert.equal(t.read().geometry.length, 0)
+})
+test('failed load hides previous geometry and cannot save under the failed ID', async () => {
+  const s = createV3ProductSession({ ...store, load: async id => ({ id, source: id === 'bad' ? '{}' : source() }) })
+  await s.open('A')
+  await s.open('bad')
+  assert.equal(s.read().geometry.length, 0)
+  assert.equal(s.read().id, undefined)
+  assert.ok(s.read().error)
+  await assert.rejects(s.save())
+})
+test('UI and AI use a shared revision and history; stale/cross-model AI is rejected', async () => {
+  const s = createV3ProductSession(store)
+  await s.open('A')
+  const before = s.read(),
+    changes = [{ kind: 'set-design' as const, input: 'body.size.y', unit: 'mm' as const, value: 150 }]
+  assert.throws(() => s.apply(changes, 'ai'), /문맥/)
+  s.apply(changes, 'ai', before.revision!, before.context!)
+  assert.throws(() => s.apply(changes, 'ai', before.revision!, before.context!))
+  s.undo()
+  assert.equal(s.read().fields.find(i => i.id === 'body.size.y')?.value, 100)
+  await s.open('B')
+  assert.throws(() => s.apply(changes, 'ai', 0, before.context!))
+})
+test('save carries exact baseline and acknowledges only matching response', async () => {
+  let baseline: string | undefined
+  const s = createV3ProductSession({
+    ...store,
+    save: async q => {
+      baseline = q.expectedSource
+      return store.save(q)
+    }
+  })
+  await s.open('A')
+  const original = s.source()
+  s.apply([{ kind: 'set-design', input: 'body.size.y', unit: 'mm', value: 200 }])
+  await s.save()
+  assert.equal(baseline, original)
+  assert.equal(s.read().dirty, false)
+  s.undo()
+  assert.equal(s.read().dirty, true)
+})
+test('pending save locks edits/navigation and duplicate create', async () => {
+  const p = deferred<V3ProductRecord>(),
+    s = createV3ProductSession({ ...store, save: () => p.promise })
+  s.startNew()
+  const text = s.source(),
+    saving = s.save()
+  assert.throws(() => s.startNew())
+  assert.throws(() => s.undo())
+  await assert.rejects(s.save())
+  p.resolve({ id: 'new', source: text })
+  await saving
+  assert.equal(s.read().id, 'new')
+})
+test('save failure preserves edits and allows retry; wrong acknowledgement never clears dirty', async () => {
+  const s = createV3ProductSession({ ...store, save: async () => ({ id: 'wrong', source: source() }) })
+  await s.open('A')
+  s.apply([{ kind: 'set-design', input: 'body.size.y', unit: 'mm', value: 200 }])
+  await assert.rejects(s.save())
+  assert.equal(s.read().dirty, true)
+  assert.equal(s.read().saving, false)
+  assert.equal(s.read().id, 'A')
+})
+test('retry after a lost create response reuses the same creation identity', async () => {
+  const keys: string[] = []
+  const s = createV3ProductSession({
+    ...store,
+    save: async q => {
+      keys.push(q.creationId!)
+      if (keys.length === 1) throw Error('response lost')
+      return { id: q.creationId!, source: q.source }
+    }
+  })
+  s.startNew()
+  await assert.rejects(s.save())
+  await s.save()
+  assert.equal(keys.length, 2)
+  assert.equal(keys[0], keys[1])
+  assert.ok(keys[0])
+})

package/test/v3-product-write.test.ts

@@ -0,0 +1,48 @@
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+import { createV3Asset, serializeV3Asset } from '@hatiolab/figure-model'
+import { prepareV3Write, compareAndSwapV3 } from '../../figure-service/server/service/figure/figure-v3-write.js'
+import { DatabaseSync } from 'node:sqlite'
+
+test('V3 saves preserve the graph and clear unmeasured previous scores', () => {
+  const source = serializeV3Asset(createV3Asset('빈 자산'))
+  const saved = prepareV3Write(source)
+  assert.equal(saved.source, source)
+  assert.equal(saved.name, '빈 자산')
+  assert.equal(saved.score, null)
+  assert.equal(saved.triangles, null)
+  assert.equal(saved.groups, 0)
+  assert.equal(saved.state, 'draft')
+})
+test('source concurrency check requires exact baseline; no implicit overwrite', () => {
+  const source = serializeV3Asset(createV3Asset('A'))
+  assert.throws(() => prepareV3Write(source, { source }))
+  assert.throws(() => prepareV3Write(source, { source }, 'changed'))
+  assert.equal(prepareV3Write(source, { source }, source).source, source)
+})
+test('old/invalid/duplicate-key sources never become a V3 saved draft', () => {
+  assert.throws(() => prepareV3Write('{"version":2,"parts":[]}'))
+  assert.throws(() => prepareV3Write('{"version":1,"version":2}'))
+  assert.throws(() => prepareV3Write('{'))
+})
+
+test('SQLite compare-and-swap rejects a stale editor and another tenant', async () => {
+  const db = new DatabaseSync(':memory:')
+  try {
+    db.exec('CREATE TABLE figures(id TEXT PRIMARY KEY,domain_id TEXT,source TEXT)')
+    db.prepare('INSERT INTO figures VALUES(?,?,?)').run('A', 'tenant-A', 'original')
+    const update = async (where: { id: string; domain: { id: string }; source: string }) => {
+      const result = db
+        .prepare('UPDATE figures SET source=? WHERE id=? AND domain_id=? AND source=?')
+        .run('next', where.id, where.domain.id, where.source)
+      return { affected: Number(result.changes) }
+    }
+    await assert.rejects(compareAndSwapV3(update, 'A', 'tenant-B', 'original'))
+    await compareAndSwapV3(update, 'A', 'tenant-A', 'original')
+    await assert.rejects(compareAndSwapV3(update, 'A', 'tenant-A', 'original'))
+    await assert.rejects(compareAndSwapV3(update, 'A', 'tenant-A', undefined))
+    assert.equal(db.prepare('SELECT source FROM figures WHERE id=?').get('A')!.source, 'next')
+  } finally {
+    db.close()
+  }
+})

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": "接受的类型",