@things-factory/figure-ui 10.1.63 → 10.1.65

package/dist-client/types.d.ts

@@ -101,50 +101,6 @@ export interface FigureFinding {
     message: string;
     at?: string;
 }
-/**
- * 저작 보조가 낸 후보.
- *
- * **정본이 아니다.** 저작자가 보고 받아야 정본이 된다 — 서버는 저장하지 않고
- * 돌려주기만 한다.
- */
-export interface FigureProposal {
-    /** 후보 정본. JSON 문자열이다 — 화면이 파싱한다. */
-    source: string;
-    score: number;
-    grade: string;
-    triangles: number;
-    /** 재질 묶음 = 인스턴스 하나가 무는 draw call. */
-    groups: number;
-    /** Rule-based review of measurable design concerns; it is not an aesthetic verdict. */
-    quality: {
-        status: 'ready' | 'review';
-        summary: string;
-        findings: Array<{
-            dimension: string;
-            code: string;
-            message: string;
-        }>;
-        visualRegions: number;
-        visualCoverage: number;
-        visualReadability: number;
-    };
-    /** 형식은 맞으나 정책을 넘은 것. 막지 않는다 — 저작자가 정한다. */
-    violations: FigureFinding[];
-    /** 몇 번 만에 됐나. 진단용이다. */
-    attempts: number;
-}
-/** 사람이 후보를 수락하거나 버릴 때 직접 남긴 현재 저작 세션의 참고 신호. */
-export interface ProposalFeedback {
-    outcome: 'accepted' | 'discarded';
-    selectedChanges: number;
-    totalChanges: number;
-    note?: string;
-    grade?: string;
-    quality?: {
-        status?: 'ready' | 'review';
-        findingCodes?: string[];
-    };
-}
 /**
  * 발행 판정 한 줄.
  *

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  /** Which format the stored source is in — `'v2'`, `'v3'`, or null when the server cannot tell. */\n  format?: 'v2' | 'v3' | null\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"]}
+{"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  /** Which format the stored source is in — `'v2'`, `'v3'`, or null when the server cannot tell. */\n  format?: 'v2' | 'v3' | null\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 * `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.63",
+  "version": "10.1.65",
   "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.1.74",
-    "@hatiolab/things-scene": "^10.1.50",
+    "@hatiolab/figure-model": "^0.1.76",
+    "@hatiolab/things-scene": "^10.1.51",
     "@material/web": "^2.0.0",
     "@operato/data-grist": "^10.0.0",
     "@operato/graphql": "^10.0.0",
@@ -40,8 +40,8 @@
     "@operato/styles": "^10.0.0",
     "@operato/utils": "^10.0.0",
     "@things-factory/ai-assistant": "^10.1.58",
-    "@things-factory/figure-service": "^10.1.63",
+    "@things-factory/figure-service": "^10.1.65",
     "three": "^0.185.1"
   },
-  "gitHead": "9d23a04edc8129d7ab1b066e1fb7a2855b6a0df8"
+  "gitHead": "87b95ef312f11d3d646f6e2247ee202b68d23e3f"
 }

package/test/figure-assistant-surface.test.ts

@@ -20,7 +20,7 @@ test('a saved figure provides a surface anchored on its row', () => {
 })
 
 test('the draft is read when the message is sent, as host context the figure tools read', () => {
-  assert.match(source, /hostContext: \(\) => \(\{[\s\S]*?figureId: id,[\s\S]*?draftSource: JSON\.parse\(this\.session\.source\(\)\),[\s\S]*?palette: Object\.keys\(activePalette\(\)\)/)
+  assert.match(source, /hostContext: \(\) => \(\{[\s\S]*?figureId: id,[\s\S]*?draftSource: JSON\.parse\(this\.session\.source\(\)\),[\s\S]*?context: this\.session\.read\(\)\.context,\s*revision: this\.session\.read\(\)\.revision,/)
 })
 
 test('an unsaved figure provides nothing', () => {
@@ -33,19 +33,22 @@ test('the surface is taken back when the page goes inactive or leaves', () => {
   assert.doesNotMatch(source, /figure-ai-context/, 'the old window-event channel is gone')
 })
 
-test('the V3 apply entry stays for the proposer that writes V3 changes', () => {
+test('the dock applies a proposal through the page, on the version the model saw', () => {
   assert.match(source, /window\.addEventListener\('figure-v3-apply', this\.applyAI\)/)
+  assert.match(source, /this\.session\.applyProposal\(detail\.steps, detail\.revision, detail\.context\)/)
+  assert.match(source, /this\.takeNewFigureProposal\(\)/, 'a new figure opened for a proposal takes its steps')
 })
 
-test('a figure candidate is answered - unavailable, in words - never left without a handler', () => {
+test('a figure proposal is answered by its handler, in words, never left without one', () => {
   const handler = readFileSync(fileURLToPath(new URL('../client/figure-assistant.ts', import.meta.url)), 'utf8')
   assert.match(handler, /registerProposalHandler\(FIGURE_CANDIDATE_TOOL,/)
   assert.match(handler, /export const FIGURE_CANDIDATE_TOOL = 'proposeFigureCandidate'/)
-  assert.match(handler, /verdict: 'unavailable'/)
-  assert.match(handler, /figure\.text\.candidate-cannot-open/)
+  assert.match(handler, /runFigureProposal\(/)
+  assert.match(handler, /context\.notify\(/)
   for (const lang of ['en', 'ko', 'ja', 'zh', 'ms']) {
     const words = JSON.parse(readFileSync(fileURLToPath(new URL(`../translations/${lang}.json`, import.meta.url)), 'utf8'))
-    assert.ok(words['figure.text.candidate-cannot-open'], `${lang} has no words for it`)
+    for (const key of ['applied', 'stale', 'refused', 'needs-modeller', 'not-opened', 'new-figure-unsaved'])
+      assert.ok(words[`figure.text.proposal-${key}`], `${lang} has no words for proposal-${key}`)
   }
   const index = readFileSync(fileURLToPath(new URL('../client/index.ts', import.meta.url)), 'utf8')
   assert.match(index, /figure-assistant\.js/)

package/test/v3-ai-proposal.test.ts

@@ -0,0 +1,112 @@
+/*
+ * An AI proposal reaching the modeller (ADR-0094): the modeller's commands, applied as one step of its history on the
+ * version the model saw, undone whole; every outcome said in words.
+ */
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+import { readFileSync } from 'node:fs'
+import { fileURLToPath } from 'node:url'
+import { createV3Asset, addV3Box, serializeV3Asset } from '@hatiolab/figure-model'
+
+import { createV3ProductSession } from '../client/modeller/v3-product-session.js'
+import { pendNewFigure, runFigureProposal, takePendingNewFigure, type FigureApplyDetail } from '../client/modeller/v3-ai-proposal.js'
+
+const ko = JSON.parse(readFileSync(fileURLToPath(new URL('../translations/ko.json', import.meta.url)), 'utf8'))
+const say = (key: string, params: Record<string, string> = {}) => {
+  assert.ok(ko[key], `ko has no words for ${key}`)
+  return ko[key].replace(/\{(\w+)\}/g, (_: string, k: string) => params[k] ?? '')
+}
+
+const source = () =>
+  serializeV3Asset(addV3Box(createV3Asset('A'), { id: 'body', size: { x: 100, y: 100, z: 100 }, position: { x: 0, y: 50, z: 0 } }))
+const store = {
+  load: async (id: string) => ({ id, source: source() }),
+  save: async (q: { id?: string; source: string }) => ({ id: q.id ?? 'created', source: q.source })
+}
+const steps = [
+  { kind: 'add-part', part: { id: 'lid', kind: 'box', dimensions: { width: 100, height: 10, depth: 100 } } },
+  { kind: 'attach', part: 'lid', face: 'bottom', to: { part: 'body', face: 'top' } },
+  { kind: 'rename', name: 'Box with lid' }
+] as any[]
+
+test('a proposal is one step of the history on the version the model saw, undone whole', async () => {
+  const s = createV3ProductSession(store)
+  await s.open('A')
+  const seen = s.read()
+  s.applyProposal(steps, seen.revision!, seen.context!)
+  assert.equal(s.read().name, 'Box with lid')
+  assert.ok(s.read().geometry.length > seen.geometry.length)
+  s.undo()
+  assert.equal(s.read().name, 'A', 'one undo takes the whole proposal back')
+  assert.equal(s.read().geometry.length, seen.geometry.length)
+  assert.equal(s.read().canUndo, false)
+})
+
+test('a person\'s edit after the proposal was asked makes it stale -- refused, nothing applied', async () => {
+  const s = createV3ProductSession(store)
+  await s.open('A')
+  const seen = s.read()
+  s.apply([{ kind: 'set-design', input: 'body.size.y', unit: 'mm', value: 150 }])
+  assert.throws(() => s.applyProposal(steps, seen.revision!, seen.context!), (e: any) => e.code === 'REVISION_CONFLICT')
+  assert.equal(s.read().name, 'A')
+})
+
+const taker = (result: Partial<FigureApplyDetail>) => ({
+  offered: [] as FigureApplyDetail[],
+  opened: [] as unknown[],
+  offer(detail: FigureApplyDetail) {
+    this.offered.push(detail)
+    return Object.assign(detail, result)
+  },
+  async openNew(s: unknown[]) {
+    this.opened.push(s)
+    return { applied: true }
+  }
+})
+
+test('applied: said with how many commands, and the card carries the version to the page', async () => {
+  const target = taker({ applied: true })
+  const out = await runFigureProposal({ steps, context: 'c', revision: 3 }, target, say)
+  assert.deepEqual(out, { verdict: 'accepted', applied: 3, note: '명령 3개를 한 단계로 적용했습니다.' })
+  assert.equal(target.offered[0]!.context, 'c')
+  assert.equal(target.offered[0]!.revision, 3)
+})
+
+test('refused: a stale version is said as what happened; any other refusal carries its reason', async () => {
+  const stale = await runFigureProposal({ steps }, taker({ applied: false, code: 'REVISION_CONFLICT', error: 'editor changed' }), say)
+  assert.equal(stale.verdict, 'refused')
+  assert.match(stale.note!, /모델이 바뀌어/)
+  const other = await runFigureProposal({ steps }, taker({ applied: false, code: 'ATTACH_FACE', error: 'faces along x' }), say)
+  assert.match(other.note!, /적용하지 않았습니다: faces along x/)
+})
+
+test('a revision with no modeller to take it is not applied anywhere else', async () => {
+  const target = taker({})
+  const out = await runFigureProposal({ steps }, target, say)
+  assert.equal(out.verdict, 'unavailable')
+  assert.equal(target.opened.length, 0, 'a revision never opens a new figure')
+})
+
+test('a new figure with no new modeller on screen opens one', async () => {
+  const target = taker({})
+  const out = await runFigureProposal({ steps, create: true }, target, say)
+  assert.equal(out.verdict, 'accepted')
+  assert.equal(target.opened.length, 1)
+})
+
+test('an empty card is not applied', async () => {
+  assert.equal((await runFigureProposal({ steps: [] }, taker({ applied: true }), say)).verdict, 'unavailable')
+})
+
+test('a new figure\'s steps wait for the page once, and lapse if no page takes them', async () => {
+  const waiting = pendNewFigure(steps, 50)
+  const taken = takePendingNewFigure()!
+  assert.equal(taken.steps, steps)
+  assert.equal(takePendingNewFigure(), undefined, 'taken once')
+  taken.settle({ applied: true })
+  assert.deepEqual(await waiting, { applied: true })
+
+  const lapsing = pendNewFigure(steps, 10)
+  assert.deepEqual(await lapsing, { applied: false, code: 'not-opened' })
+  assert.equal(takePendingNewFigure(), undefined, 'a later new figure does not receive them')
+})

package/test/v3-refusals.test.ts

@@ -116,4 +116,9 @@ test('배치를 바꿀 수 없는 까닭 — 평면에 붙은 부품과 새 평
   const said = placementRefusalOf(refused, say)!
   assert.ok(said.includes('post (bottom)') && said.includes('벽 기반') && said.includes('back'), said)
   assert.equal(placementRefusalOf(new Error('x'), say), null)
+  /* The placement list sends its command through the page, not the editor: the page says it in words too, and the list goes back. */
+  const page = readFileSync(fileURLToPath(new URL('../client/pages/figure-v3-modeller-page.ts', import.meta.url)), 'utf8')
+  assert.ok(page.includes('placementRefusalOf(error, (key, params) => i18next.t(key, params))'), '페이지 경로도 사람의 말로')
+  const props = readFileSync(fileURLToPath(new URL('../client/modeller/figure-v3-properties.ts', import.meta.url)), 'utf8')
+  assert.ok(props.includes('select.value = current'), '거절되면 목록이 원래 배치로 돌아온다')
 })

package/translations/en.json

@@ -711,7 +711,12 @@
   "figure.label.twist": "twist (°)",
   "figure.text.instance-size-undeclared": "the figure has no size, so a board cannot resize it.",
   "figure.button.declare-instance-size": "declare the figure size",
-  "figure.text.candidate-cannot-open": "this candidate is a V2 figure and the modeller opens V3 figures only, so it cannot be opened for review yet.",
+  "figure.text.proposal-applied": "applied {n} commands as one step.",
+  "figure.text.proposal-needs-modeller": "this proposal can be applied only while its figure is open in the modeller.",
+  "figure.text.proposal-new-figure-unsaved": "a new figure is being made, so the proposal was not applied. save or discard it, then run it again.",
+  "figure.text.proposal-not-opened": "a new figure could not be opened in the modeller, so the proposal was not applied.",
+  "figure.text.proposal-refused": "the modeller did not apply the proposal: {reason}",
+  "figure.text.proposal-stale": "the model changed after the proposal was made, so it was not applied. ask again.",
   "figure.label.follows-plus": "plus (mm)",
   "figure.label.motion-travel": "travel",
   "figure.label.motion-travel-mm": "its own range (mm)",

package/translations/ja.json

@@ -711,7 +711,12 @@
   "figure.label.twist": "ひねり (°)",
   "figure.text.instance-size-undeclared": "図形サイズがないため、ボードでサイズを変えられません。",
   "figure.button.declare-instance-size": "図形サイズを宣言",
-  "figure.text.candidate-cannot-open": "この候補は V2 図形で、モデラーは V3 図形しか開けないため、まだレビュー用に開けません。",
+  "figure.text.proposal-applied": "{n} 個のコマンドを 1 ステップとして適用しました。",
+  "figure.text.proposal-needs-modeller": "この提案は、その図形がモデラーで開いているときだけ適用できます。",
+  "figure.text.proposal-new-figure-unsaved": "作成中の新しい図形があるため、提案を適用しませんでした。保存または破棄してから、もう一度実行してください。",
+  "figure.text.proposal-not-opened": "新しい図形をモデラーで開けなかったため、提案を適用しませんでした。",
+  "figure.text.proposal-refused": "モデラーは提案を適用しませんでした: {reason}",
+  "figure.text.proposal-stale": "提案の後にモデルが変わったため、適用しませんでした。もう一度依頼してください。",
   "figure.label.follows-plus": "加算 (mm)",
   "figure.label.motion-travel": "移動距離",
   "figure.label.motion-travel-mm": "自分の範囲 (mm)",

package/translations/ko.json

@@ -711,7 +711,12 @@
   "figure.label.twist": "비틀기 (°)",
   "figure.text.instance-size-undeclared": "도형 크기가 없어 보드에서 크기를 바꿀 수 없습니다.",
   "figure.button.declare-instance-size": "도형 크기 선언",
-  "figure.text.candidate-cannot-open": "이 후보는 V2 도형이고 모델러는 V3 도형만 열 수 있어, 아직 검토하도록 열 수 없습니다.",
+  "figure.text.proposal-applied": "명령 {n}개를 한 단계로 적용했습니다.",
+  "figure.text.proposal-needs-modeller": "이 제안은 모델러에 그 도형이 열려 있을 때만 적용할 수 있습니다.",
+  "figure.text.proposal-new-figure-unsaved": "만들고 있는 새 Figure가 있어 제안을 적용하지 않았습니다. 저장하거나 버린 뒤 다시 실행해 주세요.",
+  "figure.text.proposal-not-opened": "새 Figure를 모델러에 열지 못해 제안을 적용하지 않았습니다.",
+  "figure.text.proposal-refused": "모델러가 제안을 적용하지 않았습니다: {reason}",
+  "figure.text.proposal-stale": "제안을 받은 뒤 모델이 바뀌어 적용하지 않았습니다. 다시 요청해 주세요.",
   "figure.label.follows-plus": "더하기 (mm)",
   "figure.label.motion-travel": "이동 거리",
   "figure.label.motion-travel-mm": "제 범위 (mm)",

package/translations/ms.json

@@ -711,7 +711,12 @@
   "figure.label.twist": "pusingan (°)",
   "figure.text.instance-size-undeclared": "rajah tiada saiz, jadi papan tidak boleh mengubah saiznya.",
   "figure.button.declare-instance-size": "isytihar saiz rajah",
-  "figure.text.candidate-cannot-open": "calon ini ialah rajah V2 dan pemodel hanya membuka rajah V3, jadi ia belum boleh dibuka untuk semakan.",
+  "figure.text.proposal-applied": "{n} arahan digunakan sebagai satu langkah.",
+  "figure.text.proposal-needs-modeller": "cadangan ini hanya boleh digunakan semasa rajahnya dibuka dalam pemodel.",
+  "figure.text.proposal-new-figure-unsaved": "rajah baharu sedang dibuat, jadi cadangan tidak digunakan. simpan atau buang dahulu, kemudian jalankan semula.",
+  "figure.text.proposal-not-opened": "rajah baharu tidak dapat dibuka dalam pemodel, jadi cadangan tidak digunakan.",
+  "figure.text.proposal-refused": "pemodel tidak menggunakan cadangan: {reason}",
+  "figure.text.proposal-stale": "model berubah selepas cadangan dibuat, jadi ia tidak digunakan. minta sekali lagi.",
   "figure.label.follows-plus": "tambah (mm)",
   "figure.label.motion-travel": "jarak gerak",
   "figure.label.motion-travel-mm": "julat sendiri (mm)",

package/translations/zh.json

@@ -711,7 +711,12 @@
   "figure.label.twist": "扭转 (°)",
   "figure.text.instance-size-undeclared": "图形没有尺寸，看板上无法调整大小。",
   "figure.button.declare-instance-size": "声明图形尺寸",
-  "figure.text.candidate-cannot-open": "此候选为 V2 图形，而建模器只能打开 V3 图形，因此暂时无法打开以供审阅。",
+  "figure.text.proposal-applied": "已将 {n} 条命令作为一步应用。",
+  "figure.text.proposal-needs-modeller": "只有在建模器中打开该图形时才能应用此提案。",
+  "figure.text.proposal-new-figure-unsaved": "正在制作一个新图形，因此未应用该提案。请保存或放弃后再运行。",
+  "figure.text.proposal-not-opened": "无法在建模器中打开新图形，因此未应用该提案。",
+  "figure.text.proposal-refused": "建模器未应用该提案：{reason}",
+  "figure.text.proposal-stale": "提案生成后模型已更改，因此未应用。请重新请求。",
   "figure.label.follows-plus": "加 (mm)",
   "figure.label.motion-travel": "行程",
   "figure.label.motion-travel-mm": "自身范围 (mm)",

package/client/modeller/proposal-session.ts

@@ -1,98 +0,0 @@
-import type { FigureSource } from '@hatiolab/figure-model'
-
-import type { FigureGateFix, FigureProposal, ProposalFeedback } from '../types.js'
-import { diffProposal } from './proposal.js'
-
-/**
- * 한 번의 AI 후보 검토에만 존재하는 상태다.
- *
- * 후보는 정본이 아니다. 후보 원본·선택·메모·측정값을 한 값으로 묶어 두면 화면이
- * 수락/거절 중 일부만 이전 후보에서 남기는 일이 없다.
- */
-export interface ProposalSession {
-  source: FigureSource
-  title: string
-  picked: Set<string>
-  note: string
-  metrics?: Pick<FigureProposal, 'grade' | 'triangles' | 'groups' | 'attempts' | 'quality'>
-  /**
-   * The release-check fix this session was opened from, if any. The page translates the title from it;
-   * this module stays free of i18n because node tests import it directly.
-   */
-  fix?: FigureGateFix
-}
-
-function selectedKeys(current: FigureSource | undefined, source: FigureSource): Set<string> {
-  return new Set(diffProposal(current, source).map(change => change.key))
-}
-
-/** 서버 후보를 검토 세션으로 연다. 저장 형식이 아니면 화면에 후보를 열지 않는다. */
-export function openAiProposal(current: FigureSource | undefined, proposal: FigureProposal): ProposalSession {
-  const source = JSON.parse(proposal.source) as FigureSource
-  if (!source || !Array.isArray(source.parts)) {
-    throw new Error('the AI candidate is not a figure source: parts is missing or not an array')
-  }
-
-  return {
-    source,
-    title: '',
-    picked: selectedKeys(current, source),
-    note: '',
-    metrics: {
-      grade: proposal.grade,
-      triangles: proposal.triangles,
-      groups: proposal.groups,
-      attempts: proposal.attempts,
-      quality: proposal.quality
-    }
-  }
-}
-
-/** 발행 게이트가 측정한 한-앵커 수정도 같은 후보 세션으로 연다. */
-export function openSizingFix(current: FigureSource, fix: FigureGateFix): ProposalSession | undefined {
-  if (!current.parts.some(part => part.name === fix.part)) return undefined
-
-  const source: FigureSource = {
-    ...current,
-    parts: current.parts.map(part =>
-      part.name === fix.part ? { ...part, anchor: { ...(part.anchor ?? {}), [fix.axis]: fix.to } } : part
-    )
-  }
-
-  return {
-    source,
-    title: '',
-    fix,
-    picked: selectedKeys(current, source),
-    note: ''
-  }
-}
-
-/** 후보 검토 중 사람의 선택을 뒤집는다. 기존 Set을 바꾸지 않아 Lit 상태 경계도 보존한다. */
-export function toggleProposalChange(session: ProposalSession, key: string): ProposalSession {
-  const picked = new Set(session.picked)
-  if (picked.has(key)) picked.delete(key)
-  else picked.add(key)
-  return { ...session, picked }
-}
-
-/** 사람의 결정을, 다음 AI 요청에만 쓰는 제한된 피드백으로 만든다. */
-export function feedbackFromSession(
-  current: FigureSource | undefined,
-  session: ProposalSession,
-  outcome: ProposalFeedback['outcome']
-): ProposalFeedback | undefined {
-  if (!session.metrics) return undefined
-
-  return {
-    outcome,
-    selectedChanges: outcome === 'accepted' ? session.picked.size : 0,
-    totalChanges: diffProposal(current, session.source).length,
-    note: session.note.trim().slice(0, 500) || undefined,
-    grade: session.metrics.grade,
-    quality: {
-      status: session.metrics.quality.status,
-      findingCodes: session.metrics.quality.findings.map(finding => finding.code)
-    }
-  }
-}

package/client/modeller/proposal.ts

@@ -1,171 +0,0 @@
-import type { FigurePart, FigureSource } from '@hatiolab/figure-model'
-
-/**
- * AI 후보를 지금 것과 비교하고, 고른 것만 받아들인다.
- *
- * 비교는 **저장 형식**으로 한다. 편집 중의 데이터는 씬 모델이지만, 후보는 서버에서
- * FigureSource 로 오고 기준 치수·디테일 등급처럼 부품 밖의 값도 함께 봐야 한다.
- *
- * 부품 편집 규칙은 여기 없다 — `part-edits.ts` 가 씬 모델 용어로 갖고 있다.
- */
-
-/**
- * 후보가 무엇을 바꾸자는 것인가.
- *
- * 후보를 통째로만 받게 두면 「몸통은 좋은데 모터 자리가 틀렸다」에 답할 수 없다 —
- * 그게 가장 흔한 반응이다. 그래서 후보를 **변경 목록**으로 본다.
- *
- * 부품은 이름으로 짝짓는다. `FigurePart.name` 이 저장되는 식별자이고 바인딩이
- * 그 이름을 가리키므로, 이름이 같으면 같은 부품이다.
- *
- * 기준 치수와 디테일 등급도 목록에 넣는다. 부품만 골라 받으면 새 부품이 옛 기준
- * 상자 밖으로 나가 **검증에 걸릴 수 있다** — 무엇을 함께 받아야 하는지 보여야 한다.
- */
-export type ChangeKind =
-  | 'added'
-  | 'changed'
-  | 'removed'
-  | 'base'
-  | 'placement'
-  | 'detail'
-  | 'styleKit'
-  | 'animations'
-  | 'parameters'
-  | 'capabilities'
-  | 'joints'
-
-/**
- * 부품 밖에서 바뀔 수 있는 것 전부.
- *
- * 여기 없는 필드는 **조용히 버려진다** — 후보가 바꿔 왔어도 목록에 안 뜨고 받아도
- * 반영되지 않는다. 형식에 필드가 늘면 여기에 더해야 한다.
- *
- * 그 일이 실제로 났다(2026-09-15). `animations` · `capabilities` · `placement` 셋이 빠져 있었다.
- * 후보가 애니메이션만 더해 오면 변경 목록이 **비어서** 「n건 반영」 단추가 잠기고, 저작자는
- * 후보를 받지도 버리지도 못한 채 멈춘다. 다른 변경과 섞여 오면 단추는 눌리는데 애니메이션만
- * 말없이 사라진다. 그리고 `anchor` 는 도형 수준 필드였다가 형식에서 없어진 것인데(2026-09-10)
- * 여기 남아 있었다 — 이 목록이 형식을 따라가지 않은 것이 양쪽으로 드러난 셈이다.
- *
- * 같은 일이 `joints` 로 한 번 더 났다(2026-09-18). 형식에 관절이 서고 저작 화면도 지었는데 이
- * 목록만 그대로여서, 관절을 더해 온 후보는 변경 목록에 안 뜨고 받아도 관절이 사라졌다. 형식의
- * 칸을 세는 시험이 그것을 잡았다.
- *
- * 형식의 `FigureSource` 는 `type` · `parts` 를 빼면 이 일곱이 전부다. `type` 은 저장되는
- * 식별자라 후보가 바꿔 와도 받지 않고(`applyProposal` 참고), `version` 은 저작자가 고를 것이
- * 아니라 저장할 때 서버가 찍는다.
- */
-const FIGURE_FIELDS = ['base', 'placement', 'detailLevel', 'styleKit', 'animations', 'parameters', 'capabilities', 'joints'] as const
-const FIELD_KIND: Record<(typeof FIGURE_FIELDS)[number], ChangeKind> = {
-  base: 'base',
-  placement: 'placement',
-  detailLevel: 'detail',
-  styleKit: 'styleKit',
-  animations: 'animations',
-  parameters: 'parameters',
-  capabilities: 'capabilities',
-  joints: 'joints'
-}
-
-export interface ProposalChange {
-  kind: ChangeKind
-  /** 부품 변경이면 부품 이름. 그 밖이면 무엇이 바뀌는지. */
-  key: string
-  /** 부품 변경일 때 후보 쪽 부품. */
-  part?: FigurePart
-}
-
-/** 부품 둘이 같은가. 순서까지 같은 JSON 으로 견준다 — 필드 순서는 만드는 쪽이 정한다. */
-function samePart(a: FigurePart, b: FigurePart): boolean {
-  return JSON.stringify(sortKeys(a)) === JSON.stringify(sortKeys(b))
-}
-
-/** 키 순서를 맞춰 견줄 수 있게 한다. */
-function sortKeys(value: unknown): unknown {
-  if (Array.isArray(value)) return value.map(sortKeys)
-  if (value && typeof value === 'object') {
-    const out: Record<string, unknown> = {}
-    for (const key of Object.keys(value as object).sort()) {
-      out[key] = sortKeys((value as Record<string, unknown>)[key])
-    }
-    return out
-  }
-  return value
-}
-
-export function diffProposal(current: FigureSource | undefined, proposal: FigureSource): ProposalChange[] {
-  const changes: ProposalChange[] = []
-  const mine = new Map((current?.parts ?? []).map(part => [part.name, part]))
-  const theirs = new Map(proposal.parts.map(part => [part.name, part]))
-
-  for (const field of FIGURE_FIELDS) {
-    if (!current) break
-    const before = JSON.stringify(sortKeys(current[field]))
-    const after = JSON.stringify(sortKeys(proposal[field]))
-    if (before !== after) {
-      changes.push({ kind: FIELD_KIND[field], key: field })
-    }
-  }
-
-  for (const part of proposal.parts) {
-    const old = mine.get(part.name)
-    if (!old) changes.push({ kind: 'added', key: part.name, part })
-    else if (!samePart(old, part)) changes.push({ kind: 'changed', key: part.name, part })
-  }
-  for (const part of current?.parts ?? []) {
-    if (!theirs.has(part.name)) changes.push({ kind: 'removed', key: part.name })
-  }
-
-  return changes
-}
-
-/**
- * 고른 변경만 받는다.
- *
- * **타입 이름은 지금 것을 지킨다.** 만든 뒤에는 고칠 수 없는 저장 식별자이고,
- * 배치된 인스턴스가 그 이름으로 청사진을 찾는다. 후보가 다른 이름을 지어 왔어도
- * 그것 때문에 이미 놓인 것이 빈 자리가 되면 안 된다.
- *
- * `picked` 를 주지 않으면 전부 받는다 — 그것이 보통의 길이다.
- *
- * 더해지는 부품은 **뒤에 붙인다.** 후보가 놓은 자리에 끼워 넣으면, 일부만 골랐을
- * 때 순서가 어디서 온 것인지 알 수 없게 된다.
- */
-export function applyProposal(
-  current: FigureSource | undefined,
-  proposal: FigureSource,
-  picked?: Set<string>
-): FigureSource {
-  const takes = (change: ProposalChange) => !picked || picked.has(change.key)
-  const changes = diffProposal(current, proposal)
-
-  if (!current) {
-    return { ...proposal }
-  }
-
-  const removed = new Set(changes.filter(c => c.kind === 'removed' && takes(c)).map(c => c.key))
-  const replaced = new Map(
-    changes.filter(c => c.kind === 'changed' && takes(c)).map(c => [c.key, c.part as FigurePart])
-  )
-  const added = changes.filter(c => c.kind === 'added' && takes(c)).map(c => c.part as FigurePart)
-
-  const parts = [
-    ...current.parts.filter(part => !removed.has(part.name)).map(part => replaced.get(part.name) ?? part),
-    ...added
-  ]
-
-  // 고른 필드만 후보 값으로 바꾼다. 안 고른 것은 지금 값이 남는다.
-  const fields: Record<string, unknown> = {}
-  for (const field of FIGURE_FIELDS) {
-    const change = changes.find(c => c.key === field)
-    if (change && takes(change)) {
-      fields[field] = proposal[field]
-    }
-  }
-
-  return { ...current, ...fields, parts } as FigureSource
-}
-
-/** 전부 받는다. */
-export function takeProposal(current: FigureSource | undefined, proposal: FigureSource): FigureSource {
-  return applyProposal(current, proposal)
-}

package/dist-client/modeller/proposal-session.d.ts

@@ -1,28 +0,0 @@
-import type { FigureSource } from '@hatiolab/figure-model';
-import type { FigureGateFix, FigureProposal, ProposalFeedback } from '../types.js';
-/**
- * 한 번의 AI 후보 검토에만 존재하는 상태다.
- *
- * 후보는 정본이 아니다. 후보 원본·선택·메모·측정값을 한 값으로 묶어 두면 화면이
- * 수락/거절 중 일부만 이전 후보에서 남기는 일이 없다.
- */
-export interface ProposalSession {
-    source: FigureSource;
-    title: string;
-    picked: Set<string>;
-    note: string;
-    metrics?: Pick<FigureProposal, 'grade' | 'triangles' | 'groups' | 'attempts' | 'quality'>;
-    /**
-     * The release-check fix this session was opened from, if any. The page translates the title from it;
-     * this module stays free of i18n because node tests import it directly.
-     */
-    fix?: FigureGateFix;
-}
-/** 서버 후보를 검토 세션으로 연다. 저장 형식이 아니면 화면에 후보를 열지 않는다. */
-export declare function openAiProposal(current: FigureSource | undefined, proposal: FigureProposal): ProposalSession;
-/** 발행 게이트가 측정한 한-앵커 수정도 같은 후보 세션으로 연다. */
-export declare function openSizingFix(current: FigureSource, fix: FigureGateFix): ProposalSession | undefined;
-/** 후보 검토 중 사람의 선택을 뒤집는다. 기존 Set을 바꾸지 않아 Lit 상태 경계도 보존한다. */
-export declare function toggleProposalChange(session: ProposalSession, key: string): ProposalSession;
-/** 사람의 결정을, 다음 AI 요청에만 쓰는 제한된 피드백으로 만든다. */
-export declare function feedbackFromSession(current: FigureSource | undefined, session: ProposalSession, outcome: ProposalFeedback['outcome']): ProposalFeedback | undefined;