@things-factory/figure-ui 10.1.7 → 10.1.8

package/dist-client/types.d.ts

@@ -111,11 +111,36 @@ export interface FigureProposal {
     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[];
+    };
+}
 /**
  * 발행 판정 한 줄.
  *
@@ -123,6 +148,17 @@ export interface FigureProposal {
  * 발행 판정은 막는 것과 알리는 것을 함께 내므로 어느 쪽인지를 값이 스스로 말한다 — 코드를 보고
  * 화면이 다시 분류하면 규칙이 두 벌이 된다.
  */
+/** One reversible anchor edit the sizing gate has measured against this exact source. */
+export interface FigureGateFix {
+    findingWay: string;
+    part: string;
+    axis: 'x' | 'y' | 'z';
+    from?: string;
+    to: 'min' | 'center' | 'max' | 'span';
+    resolved: number;
+    /** All blocking sizing cases clear after this exact edit was remeasured server-side. */
+    safe: boolean;
+}
 export interface FigureGateFinding {
     code: string;
     message: string;
@@ -132,6 +168,8 @@ export interface FigureGateFinding {
     how?: string;
     /** 갈라진 부품 이름들, 또는 정본 안의 경로. */
     at?: string;
+    /** Candidate edits; the UI must preview and explicitly apply these, never auto-save them. */
+    fixes?: FigureGateFix[];
     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  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  /** 형식은 맞으나 정책을 넘은 것. 막지 않는다 — 저작자가 정한다. */\n  violations: FigureFinding[]\n  /** 몇 번 만에 됐나. 진단용이다. */\n  attempts: number\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":"","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  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"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@things-factory/figure-ui",
-  "version": "10.1.7",
+  "version": "10.1.8",
   "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.15",
+    "@hatiolab/figure-model": "^0.1.16",
     "@hatiolab/things-scene": "^10.1.10",
     "@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.7",
+    "@things-factory/figure-service": "^10.1.8",
     "three": "^0.185.1"
   },
-  "gitHead": "9a036f83f5751f9e4af9180e9a0018f716a4ba27"
+  "gitHead": "c402982e29aab3b49e56bea4e41948be6a749c7f"
 }

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

@@ -0,0 +1,169 @@
+/*
+ * AI 후보가 저작 화면의 정본에 닿는 마지막 경계다.
+ *
+ * 모델의 응답은 신뢰하지 않는다. `proposal.ts`는 사람이 고른 변경만 옮기고, 저장 식별자인
+ * Figure type과 이름으로 연결된 부품의 의미를 보존해야 한다. 이 순수 로직을 Lit 화면 밖에서
+ * 시험해 두면 DOM 배선이 바뀌어도 후보 수락 규칙이 조용히 약해지지 않는다.
+ */
+import assert from 'node:assert/strict'
+import { readFileSync } from 'node:fs'
+import { fileURLToPath } from 'node:url'
+import { test } from 'node:test'
+
+import { applyProposal, diffProposal, takeProposal } from '../client/modeller/proposal.ts'
+import { feedbackFromSession, openAiProposal, openSizingFix, toggleProposalChange } from '../client/modeller/proposal-session.ts'
+
+const current = () => ({
+  type: 'MIXER',
+  base: { x: 100, y: 100, z: 100 },
+  detailLevel: 'M',
+  parts: [
+    {
+      name: 'body',
+      primitive: 'cube',
+      transform: { position: { x: 0, y: 0, z: 0 }, size: { x: 100, y: 100, z: 100 } },
+      material: { token: 'palette.primary' }
+    },
+    {
+      name: 'motor',
+      primitive: 'cube',
+      transform: { position: { x: 0, y: 60, z: 0 }, size: { x: 20, y: 20, z: 20 } },
+      material: { token: 'palette.neutral' }
+    }
+  ]
+})
+
+const proposal = () => ({
+  type: 'FORKLIFT', // 모델이 이 값을 지어내도 이미 저장된 Figure의 type은 바꾸지 않는다.
+  base: { x: 200, y: 100, z: 100 },
+  detailLevel: 'L',
+  parts: [
+    {
+      name: 'body',
+      primitive: 'cube',
+      transform: { position: { x: 0, y: 0, z: 0 }, size: { x: 200, y: 100, z: 100 } },
+      material: { token: 'palette.accent' }
+    },
+    {
+      name: 'guard',
+      primitive: 'cube',
+      transform: { position: { x: 0, y: 50, z: 0 }, size: { x: 100, y: 10, z: 10 } },
+      material: { token: 'palette.primary' }
+    }
+  ]
+})
+
+test('AI 후보는 모든 변경을 이름 단위로 드러낸다 — 사람에게 숨은 변경이 없다', () => {
+  const changes = diffProposal(current() as any, proposal() as any)
+
+  assert.deepEqual(
+    changes.map(change => `${change.kind}:${change.key}`).sort(),
+    ['added:guard', 'base:base', 'changed:body', 'detail:detailLevel', 'removed:motor']
+  )
+})
+
+test('선택하지 않은 후보 변경은 정본에 들어가지 않는다', () => {
+  const result = applyProposal(current() as any, proposal() as any, new Set(['body', 'base']))
+
+  assert.deepEqual(result.base, { x: 200, y: 100, z: 100 })
+  assert.equal(result.detailLevel, 'M')
+  assert.deepEqual(result.parts.map(part => part.name), ['body', 'motor'])
+  assert.equal(result.parts[0].material.token, 'palette.accent')
+})
+
+test('후보가 다른 type을 내도 이미 존재하는 Figure의 저장 식별자는 보존한다', () => {
+  const result = takeProposal(current() as any, proposal() as any)
+
+  assert.equal(result.type, 'MIXER')
+})
+
+test('새 Figure의 후보는 사람의 수락 전까지 입력 source를 바꾸지 않는다', () => {
+  const candidate = proposal()
+  const result = takeProposal(undefined, candidate as any)
+
+  assert.notEqual(result, candidate)
+  assert.equal(candidate.type, 'FORKLIFT')
+  assert.equal(result.type, 'FORKLIFT')
+})
+
+test('AI 후보의 검토 상태는 하나의 세션으로 열리고, 선택은 불변으로 바뀐다', () => {
+  const candidate = openAiProposal(current() as any, {
+    source: JSON.stringify(proposal()),
+    grade: 'L',
+    triangles: 42,
+    groups: 2,
+    attempts: 1,
+    quality: { status: 'ready', summary: 'ready', findings: [], visualRegions: 1, visualCoverage: 1, visualReadability: 1 }
+  } as any)
+
+  const toggled = toggleProposalChange(candidate, 'body')
+  assert.notEqual(toggled, candidate)
+  assert.equal(candidate.picked.has('body'), true)
+  assert.equal(toggled.picked.has('body'), false)
+  assert.equal(toggled.note, '')
+})
+
+test('발행 게이트 수정과 AI 후보는 같은 검토 세션 경계를 쓴다', () => {
+  const session = openSizingFix(current() as any, { part: 'body', axis: 'x', from: 'auto', to: 'max' } as any)
+  assert.equal(session?.metrics, undefined)
+  assert.equal(session?.source.parts[0].anchor?.x, 'max')
+  assert.equal(openSizingFix(current() as any, { part: 'missing', axis: 'x', to: 'max' } as any), undefined)
+})
+
+test('피드백은 후보 세션의 선택과 측정값만 전송한다', () => {
+  const session = openAiProposal(current() as any, {
+    source: JSON.stringify(proposal()),
+    grade: 'L',
+    triangles: 42,
+    groups: 2,
+    attempts: 1,
+    quality: { status: 'review', summary: 'check', findings: [{ dimension: 'shape', code: 'S1', message: 'check' }], visualRegions: 1, visualCoverage: 1, visualReadability: 1 }
+  } as any)
+  const feedback = feedbackFromSession(current() as any, { ...session, note: ' keep body ' }, 'accepted')
+  assert.deepEqual(feedback, {
+    outcome: 'accepted', selectedChanges: session.picked.size, totalChanges: session.picked.size,
+    note: 'keep body', grade: 'L', quality: { status: 'review', findingCodes: ['S1'] }
+  })
+})
+
+test('모델러 AI 입구는 후보만 알리고, 팔레트·그림·현재 정본을 서버에 함께 보낸다', () => {
+  /* Lit 컴포넌트는 DOM 없이 실로드하지 않는다. 이 경계에서는 실제 소스 계약을 읽는다. */
+  const path = fileURLToPath(new URL('../client/modeller/figure-ask.ts', import.meta.url))
+  const source = readFileSync(path, 'utf8')
+
+  assert.match(source, /proposeFigure\(\{[\s\S]*prompt,[\s\S]*base: this\.source \? JSON\.stringify\(this\.source\) : undefined,[\s\S]*type: this\.source \? undefined : this\.type,[\s\S]*palette: Object\.keys\(activePalette\(\)/)
+  assert.match(source, /image: this\.picture/)
+  assert.match(source, /feedback: this\.feedback/)
+  assert.match(source, /new CustomEvent\('proposed', \{ detail: \{ proposal \}/)
+  assert.match(source, /this\.failure = \(err as Error\)\.message/)
+})
+
+test('모델러의 수락·거절 피드백은 다음 인라인 후보 요청에도 같은 Figure 세션에서만 전달한다', () => {
+  const path = fileURLToPath(new URL('../client/pages/figure-modeller-page.ts', import.meta.url))
+  const source = readFileSync(path, 'utf8')
+
+  assert.match(source, /\.feedback=\$\{this\.proposalFeedback\}/)
+  assert.match(source, /this\.proposalFeedback = \[\.\.\.this\.proposalFeedback, feedback\]\.slice\(-5\)/)
+  assert.match(source, /changed\.has\('figure'\).*this\.proposalFeedback = \[\]/s)
+})
+
+test('발행 게이트 수정안은 원본을 바꾸지 않고 후보로만 연다', () => {
+  const historyPath = fileURLToPath(new URL('../client/modeller/figure-history-panel.ts', import.meta.url))
+  const modellerPath = fileURLToPath(new URL('../client/pages/figure-modeller-page.ts', import.meta.url))
+  const sessionPath = fileURLToPath(new URL('../client/modeller/proposal-session.ts', import.meta.url))
+  const history = readFileSync(historyPath, 'utf8')
+  const modeller = readFileSync(modellerPath, 'utf8')
+  const session = readFileSync(sessionPath, 'utf8')
+
+  assert.match(history, /수정안 미리보기/)
+  assert.match(history, /안전하게 수정 적용/)
+  assert.match(history, /new CustomEvent\('apply-sizing-fix'/)
+  assert.match(history, /new CustomEvent\('preview-sizing-fix'/)
+  assert.match(modeller, /@preview-sizing-fix=\$\{\(e: CustomEvent\) => this\.previewSizingFix\(e\.detail\)\}/)
+  assert.match(modeller, /private previewSizingFix\(fix: FigureGateFix\)/)
+  assert.match(modeller, /private applySizingFix\(fix: FigureGateFix\)/)
+  assert.match(modeller, /if \(!fix\.safe \|\| !this\.folded\) return/)
+  assert.match(modeller, /this\.proposalSession = proposalSessions\.openSizingFix\(this\.folded, fix\)/)
+  assert.match(modeller, /private take\(\)[\s\S]*applyProposal\(this\.folded, this\.proposalSession\.source, this\.proposalSession\.picked\)[\s\S]*this\.dirty = true/)
+  assert.match(session, /export function openSizingFix[\s\S]*anchor: \{ \.\.\.\(part\.anchor \?\? \{\}\), \[fix\.axis\]: fix\.to \}/)
+})

package/translations/en.json

@@ -3,6 +3,11 @@
   "figure.button.add-clip": "add clip",
   "figure.button.add-key": "add key",
   "figure.button.ask": "ask",
+  "figure.label.candidate-review": "candidate review",
+  "figure.text.proposal-feedback-note": "Optional note for the next suggestion (this session only)",
+  "figure.text.proposal-feedback-placeholder": "e.g. keep the silhouette, but make the port easier to read",
+  "figure.text.tools-explained": "Use alignment after setting position, size, and rotation. From left: centre X, centre Z, put on floor, mirror X, mirror Z, and snap to grid. Hover an icon to confirm its action.",
+  "figure.text.palette-purpose-explained": "Choose the visual role this part plays, not an implementation color name.",
   "figure.button.attach-a-picture": "image",
   "figure.button.center-x": "centre X",
   "figure.button.center-z": "centre Z",
@@ -33,6 +38,20 @@
   "figure.label.anchor-aspect-y": "grows only as much as y does (keeps ratio)",
   "figure.label.anchor-aspect-z": "grows only as much as z does (keeps ratio)",
   "figure.label.anchor-auto": "automatic ({rule})",
+  "figure.label.anchor-advanced": "advanced proportional sizing",
+  "figure.label.anchor-choice-auto": "automatic",
+  "figure.label.anchor-choice-aspect-x": "keep X ratio",
+  "figure.label.anchor-choice-aspect-y": "keep Y ratio",
+  "figure.label.anchor-choice-aspect-z": "keep Z ratio",
+  "figure.label.anchor-choice-center": "stay centred",
+  "figure.label.anchor-choice-max-x": "right face",
+  "figure.label.anchor-choice-max-y": "upper face",
+  "figure.label.anchor-choice-max-z": "front face",
+  "figure.label.anchor-choice-min-x": "left face",
+  "figure.label.anchor-choice-min-y": "lower face",
+  "figure.label.anchor-choice-min-z": "back face",
+  "figure.label.anchor-choice-scale": "grow together",
+  "figure.label.anchor-choice-span": "fill both faces",
   "figure.label.anchor-center": "stays centred, keeps its size",
   "figure.label.anchor-max": "stays on the upper face",
   "figure.label.anchor-max-x": "stays on the right face",
@@ -126,6 +145,18 @@
   "figure.label.now": "current",
   "figure.label.on-by-default": "on by default",
   "figure.label.palette-token": "palette token",
+  "figure.label.palette-role": "color role",
+  "figure.label.palette-purpose-accent": "accent part · handles and covers that must stand out",
+  "figure.label.palette-purpose-danger": "danger signal · an error or stop indicator",
+  "figure.label.palette-purpose-dark": "frame and shadow · dark structure and edges",
+  "figure.label.palette-purpose-info": "information signal · an operating-information indicator",
+  "figure.label.palette-purpose-light": "light face · light housings and label surrounds",
+  "figure.label.palette-purpose-neutral": "neutral machine face · supporting structures and machine parts",
+  "figure.label.palette-purpose-primary": "main body · the largest equipment housing",
+  "figure.label.palette-purpose-registered": "registered palette color",
+  "figure.label.palette-purpose-success": "normal signal · a normal-operation indicator",
+  "figure.label.palette-purpose-surface": "surface and background · broad background faces",
+  "figure.label.palette-purpose-warning": "warning signal · an attention-needed indicator",
   "figure.label.part": "part",
   "figure.label.part-material": "material",
   "figure.label.part-position": "position (centre)",
@@ -295,6 +326,7 @@
   "figure.text.nothing-released-yet": "nothing released yet. releasing keeps the figure as it is now, as a version.",
   "figure.text.on-by-default-explained": "the starting state when placed on a board. an instance switching it wins.",
   "figure.text.other-segment-count": "enter a value",
+  "figure.text.more-segment-options": "advanced segment counts",
   "figure.text.part-limit-reached": "the detail level allows no more parts — raise the level or remove a part.",
   "figure.text.part-limit-reached-short": "level {level} allows {limit} parts. Raise the level or remove a part.",
   "figure.text.path-rotation-unit": "Euler degrees — the same convention as the part's own rotation.",

package/translations/ja.json

@@ -1,5 +1,10 @@
 {
   "figure.button.ask": "ask",
+  "figure.label.candidate-review": "candidate review",
+  "figure.text.proposal-feedback-note": "Optional note for the next suggestion (this session only)",
+  "figure.text.proposal-feedback-placeholder": "e.g. keep the silhouette, but make the port easier to read",
+  "figure.text.tools-explained": "Use alignment after setting position, size, and rotation. From left: centre X, centre Z, put on floor, mirror X, mirror Z, and snap to grid. Hover an icon to confirm its action.",
+  "figure.text.palette-purpose-explained": "Choose the visual role this part plays, not an implementation color name.",
   "figure.button.attach-a-picture": "image",
   "figure.button.center-x": "centre X",
   "figure.button.center-z": "centre Z",
@@ -26,6 +31,20 @@
   "figure.label.anchor-aspect-y": "y 軸が大きくなる分だけ大きくなる (比率維持)",
   "figure.label.anchor-aspect-z": "z 軸が大きくなる分だけ大きくなる (比率維持)",
   "figure.label.anchor-auto": "自動 ({rule})",
+  "figure.label.anchor-advanced": "advanced proportional sizing",
+  "figure.label.anchor-choice-auto": "automatic",
+  "figure.label.anchor-choice-aspect-x": "keep X ratio",
+  "figure.label.anchor-choice-aspect-y": "keep Y ratio",
+  "figure.label.anchor-choice-aspect-z": "keep Z ratio",
+  "figure.label.anchor-choice-center": "stay centred",
+  "figure.label.anchor-choice-max-x": "right face",
+  "figure.label.anchor-choice-max-y": "upper face",
+  "figure.label.anchor-choice-max-z": "front face",
+  "figure.label.anchor-choice-min-x": "left face",
+  "figure.label.anchor-choice-min-y": "lower face",
+  "figure.label.anchor-choice-min-z": "back face",
+  "figure.label.anchor-choice-scale": "grow together",
+  "figure.label.anchor-choice-span": "fill both faces",
   "figure.label.anchor-center": "中央に残り大きさはそのまま",
   "figure.label.anchor-max": "大きい側の面にくっついている",
   "figure.label.anchor-max-x": "右の面にくっついている",
@@ -107,6 +126,18 @@
   "figure.label.now": "current",
   "figure.label.on-by-default": "on by default",
   "figure.label.palette-token": "palette token",
+  "figure.label.palette-role": "color role",
+  "figure.label.palette-purpose-accent": "accent part · handles and covers that must stand out",
+  "figure.label.palette-purpose-danger": "danger signal · an error or stop indicator",
+  "figure.label.palette-purpose-dark": "frame and shadow · dark structure and edges",
+  "figure.label.palette-purpose-info": "information signal · an operating-information indicator",
+  "figure.label.palette-purpose-light": "light face · light housings and label surrounds",
+  "figure.label.palette-purpose-neutral": "neutral machine face · supporting structures and machine parts",
+  "figure.label.palette-purpose-primary": "main body · the largest equipment housing",
+  "figure.label.palette-purpose-registered": "registered palette color",
+  "figure.label.palette-purpose-success": "normal signal · a normal-operation indicator",
+  "figure.label.palette-purpose-surface": "surface and background · broad background faces",
+  "figure.label.palette-purpose-warning": "warning signal · an attention-needed indicator",
   "figure.label.part": "part",
   "figure.label.part-material": "material",
   "figure.label.part-position": "position (centre)",
@@ -236,6 +267,7 @@
   "figure.text.nothing-released-yet": "まだ公開した版がありません。公開すると、その時点のフィギュアが版として残ります。",
   "figure.text.on-by-default-explained": "the starting state when placed on a board. an instance switching it wins.",
   "figure.text.other-segment-count": "enter a value",
+  "figure.text.more-segment-options": "advanced segment counts",
   "figure.text.part-limit-reached": "the detail level allows no more parts — raise the level or remove a part.",
   "figure.text.part-limit-reached-short": "level {level} allows {limit} parts. Raise the level or remove a part.",
   "figure.text.pick-a-shape-above-to-start": "pick a shape above to add the first part.",

package/translations/ko.json

@@ -3,6 +3,11 @@
   "figure.button.add-clip": "clip 추가",
   "figure.button.add-key": "키 추가",
   "figure.button.ask": "요청",
+  "figure.label.candidate-review": "후보 검토 근거",
+  "figure.text.proposal-feedback-note": "다음 제안에 반영할 메모 (현재 세션에만 사용)",
+  "figure.text.proposal-feedback-placeholder": "예: 실루엣은 유지하되 포트가 더 잘 보이게",
+  "figure.text.tools-explained": "맞추기는 위치·크기·회전을 직접 입력한 뒤 빠르게 정렬하는 도구입니다. 왼쪽부터 X 가운데, Z 가운데, 바닥에 붙이기, X 대칭, Z 대칭, 눈금 맞춤입니다. 아이콘 위에 마우스를 올리면 각 동작을 다시 확인할 수 있습니다.",
+  "figure.text.palette-purpose-explained": "색 이름이 아니라 이 부품이 화면에서 맡을 역할을 고릅니다.",
   "figure.button.attach-a-picture": "이미지",
   "figure.button.center-x": "X 가운데",
   "figure.button.center-z": "Z 가운데",
@@ -33,6 +38,20 @@
   "figure.label.anchor-aspect-y": "y 축이 커지는 만큼만 커진다 (비율 유지)",
   "figure.label.anchor-aspect-z": "z 축이 커지는 만큼만 커진다 (비율 유지)",
   "figure.label.anchor-auto": "자동 ({rule})",
+  "figure.label.anchor-advanced": "고급 비율 유지",
+  "figure.label.anchor-choice-auto": "자동",
+  "figure.label.anchor-choice-aspect-x": "X 비율 유지",
+  "figure.label.anchor-choice-aspect-y": "Y 비율 유지",
+  "figure.label.anchor-choice-aspect-z": "Z 비율 유지",
+  "figure.label.anchor-choice-center": "가운데 고정",
+  "figure.label.anchor-choice-max-x": "오른쪽 면",
+  "figure.label.anchor-choice-max-y": "위 면",
+  "figure.label.anchor-choice-max-z": "앞 면",
+  "figure.label.anchor-choice-min-x": "왼쪽 면",
+  "figure.label.anchor-choice-min-y": "아래 면",
+  "figure.label.anchor-choice-min-z": "뒤 면",
+  "figure.label.anchor-choice-scale": "함께 확대",
+  "figure.label.anchor-choice-span": "양쪽 채움",
   "figure.label.anchor-center": "가운데에 남고 크기는 그대로",
   "figure.label.anchor-max": "큰 쪽 면에 붙어 있는다",
   "figure.label.anchor-max-x": "오른쪽 면에 붙어 있는다",
@@ -45,6 +64,11 @@
   "figure.label.anchor-scale": "상자와 함께 커진다",
   "figure.label.anchor-span": "양쪽 면에 닿아 사이를 채운다",
   "figure.label.animation": "애니메이션",
+  "figure.label.motion-intent": "무엇을 움직일까요?",
+  "figure.label.recipe-conveyor": "컨베이어 롤러 계속 회전",
+  "figure.label.recipe-gate": "문 또는 게이트 열기",
+  "figure.label.recipe-pusher": "푸셔 위치 이동",
+  "figure.label.recipe-lift": "리프트 높이 변경",
   "figure.label.axis-consistency": "표현 일관성",
   "figure.label.axis-consistency-short": "일관성",
   "figure.label.axis-depth": "높이",
@@ -126,6 +150,18 @@
   "figure.label.now": "현재",
   "figure.label.on-by-default": "기본으로 켜 둔다",
   "figure.label.palette-token": "팔레트 토큰",
+  "figure.label.palette-role": "색 역할",
+  "figure.label.palette-purpose-accent": "강조 부품 · 손잡이·커버처럼 눈에 띄어야 할 곳",
+  "figure.label.palette-purpose-danger": "위험 신호 · 오류·정지 상태를 알리는 표시등",
+  "figure.label.palette-purpose-dark": "프레임·그림자 · 어두운 구조와 테두리",
+  "figure.label.palette-purpose-info": "정보 신호 · 동작 정보용 표시등",
+  "figure.label.palette-purpose-light": "밝은 면 · 밝은 외장과 라벨 주변",
+  "figure.label.palette-purpose-neutral": "중립 기계면 · 보조 구조와 기계 부품",
+  "figure.label.palette-purpose-primary": "기본 몸체 · 설비의 가장 큰 외장",
+  "figure.label.palette-purpose-registered": "등록된 팔레트 색",
+  "figure.label.palette-purpose-success": "정상 신호 · 정상 동작 상태를 알리는 표시등",
+  "figure.label.palette-purpose-surface": "표면·바탕 · 넓은 바탕 면",
+  "figure.label.palette-purpose-warning": "주의 신호 · 확인이 필요한 상태를 알리는 표시등",
   "figure.label.part": "부품",
   "figure.label.part-material": "재질",
   "figure.label.part-position": "위치 (중심)",
@@ -205,6 +241,11 @@
   "figure.text.animation-empty-what-it-is": "이 도형은 아직 움직이지 않습니다. clip 은 부품 여럿을 한 벌로 움직이는 단위입니다 — 문 열림은 왼짝과 오른짝이 반대로 미끄러지는 것 하나입니다.",
   "figure.text.animation-is-driven-by-a-fact": "clip 하나가 부품 여럿을 함께 움직입니다. 보드에서는 사실이 그 값을 정합니다 — 「지금 40% 열려 있다」처럼.",
   "figure.text.animation-needs-a-named-part": "부품이 먼저 있어야 합니다. clip 은 부품을 가리켜 움직입니다.",
+  "figure.text.motion-intent-help": "움직일 부품을 고른 뒤 목적을 선택하세요. 만들어진 동작은 아래 고급 편집에서 조정할 수 있습니다.",
+  "figure.text.recipe-conveyor": "계속 움직임 · 입력값은 속도 또는 배속",
+  "figure.text.recipe-gate": "상태 위치 · 입력값은 열림 비율 0~100%",
+  "figure.text.recipe-pusher": "상태 위치 · 입력값은 이동 위치 0~100%",
+  "figure.text.recipe-lift": "상태 위치 · 입력값은 높이 0~100%",
   "figure.text.ask-create-example": "예: 3단 선반형 컨베이어 소터",
   "figure.text.ask-revise-example": "예: 재질 묶음을 2개로 줄여줘",
   "figure.text.ask-to-create": "신규",
@@ -295,6 +336,7 @@
   "figure.text.nothing-released-yet": "아직 발행한 판이 없습니다. 발행하면 그때의 도형이 판으로 남습니다.",
   "figure.text.on-by-default-explained": "보드에 놓았을 때의 처음 상태입니다. 인스턴스가 켜고 끄면 그것이 이깁니다.",
   "figure.text.other-segment-count": "직접 입력",
+  "figure.text.more-segment-options": "고급 분할 수",
   "figure.text.part-limit-reached": "디테일 등급이 허용하는 부품 수를 모두 사용했습니다. 등급을 올리거나 부품을 삭제하세요.",
   "figure.text.part-limit-reached-short": "{level} 등급은 부품 {limit}개까지입니다. 등급을 올리거나 부품을 삭제하세요.",
   "figure.text.path-rotation-unit": "오일러 도(°)입니다. 배치의 회전과 같은 약속입니다.",

package/translations/ms.json

@@ -1,5 +1,10 @@
 {
   "figure.button.ask": "ask",
+  "figure.label.candidate-review": "candidate review",
+  "figure.text.proposal-feedback-note": "Optional note for the next suggestion (this session only)",
+  "figure.text.proposal-feedback-placeholder": "e.g. keep the silhouette, but make the port easier to read",
+  "figure.text.tools-explained": "Use alignment after setting position, size, and rotation. From left: centre X, centre Z, put on floor, mirror X, mirror Z, and snap to grid. Hover an icon to confirm its action.",
+  "figure.text.palette-purpose-explained": "Choose the visual role this part plays, not an implementation color name.",
   "figure.button.attach-a-picture": "image",
   "figure.button.center-x": "centre X",
   "figure.button.center-z": "centre Z",
@@ -26,6 +31,20 @@
   "figure.label.anchor-aspect-y": "membesar hanya sebanyak paksi y (kekalkan nisbah)",
   "figure.label.anchor-aspect-z": "membesar hanya sebanyak paksi z (kekalkan nisbah)",
   "figure.label.anchor-auto": "automatik ({rule})",
+  "figure.label.anchor-advanced": "advanced proportional sizing",
+  "figure.label.anchor-choice-auto": "automatic",
+  "figure.label.anchor-choice-aspect-x": "keep X ratio",
+  "figure.label.anchor-choice-aspect-y": "keep Y ratio",
+  "figure.label.anchor-choice-aspect-z": "keep Z ratio",
+  "figure.label.anchor-choice-center": "stay centred",
+  "figure.label.anchor-choice-max-x": "right face",
+  "figure.label.anchor-choice-max-y": "upper face",
+  "figure.label.anchor-choice-max-z": "front face",
+  "figure.label.anchor-choice-min-x": "left face",
+  "figure.label.anchor-choice-min-y": "lower face",
+  "figure.label.anchor-choice-min-z": "back face",
+  "figure.label.anchor-choice-scale": "grow together",
+  "figure.label.anchor-choice-span": "fill both faces",
   "figure.label.anchor-center": "kekal di tengah, saiz tidak berubah",
   "figure.label.anchor-max": "melekat pada permukaan atas",
   "figure.label.anchor-max-x": "melekat pada permukaan kanan",
@@ -107,6 +126,18 @@
   "figure.label.now": "current",
   "figure.label.on-by-default": "on by default",
   "figure.label.palette-token": "palette token",
+  "figure.label.palette-role": "color role",
+  "figure.label.palette-purpose-accent": "accent part · handles and covers that must stand out",
+  "figure.label.palette-purpose-danger": "danger signal · an error or stop indicator",
+  "figure.label.palette-purpose-dark": "frame and shadow · dark structure and edges",
+  "figure.label.palette-purpose-info": "information signal · an operating-information indicator",
+  "figure.label.palette-purpose-light": "light face · light housings and label surrounds",
+  "figure.label.palette-purpose-neutral": "neutral machine face · supporting structures and machine parts",
+  "figure.label.palette-purpose-primary": "main body · the largest equipment housing",
+  "figure.label.palette-purpose-registered": "registered palette color",
+  "figure.label.palette-purpose-success": "normal signal · a normal-operation indicator",
+  "figure.label.palette-purpose-surface": "surface and background · broad background faces",
+  "figure.label.palette-purpose-warning": "warning signal · an attention-needed indicator",
   "figure.label.part": "part",
   "figure.label.part-material": "material",
   "figure.label.part-position": "position (centre)",
@@ -236,6 +267,7 @@
   "figure.text.nothing-released-yet": "belum ada versi diterbitkan. penerbitan menyimpan figura seperti sekarang sebagai satu versi.",
   "figure.text.on-by-default-explained": "the starting state when placed on a board. an instance switching it wins.",
   "figure.text.other-segment-count": "enter a value",
+  "figure.text.more-segment-options": "advanced segment counts",
   "figure.text.part-limit-reached": "the detail level allows no more parts — raise the level or remove a part.",
   "figure.text.part-limit-reached-short": "level {level} allows {limit} parts. Raise the level or remove a part.",
   "figure.text.pick-a-shape-above-to-start": "pick a shape above to add the first part.",

package/translations/zh.json

@@ -1,5 +1,10 @@
 {
   "figure.button.ask": "ask",
+  "figure.label.candidate-review": "candidate review",
+  "figure.text.proposal-feedback-note": "Optional note for the next suggestion (this session only)",
+  "figure.text.proposal-feedback-placeholder": "e.g. keep the silhouette, but make the port easier to read",
+  "figure.text.tools-explained": "Use alignment after setting position, size, and rotation. From left: centre X, centre Z, put on floor, mirror X, mirror Z, and snap to grid. Hover an icon to confirm its action.",
+  "figure.text.palette-purpose-explained": "Choose the visual role this part plays, not an implementation color name.",
   "figure.button.attach-a-picture": "image",
   "figure.button.center-x": "centre X",
   "figure.button.center-z": "centre Z",
@@ -26,6 +31,20 @@
   "figure.label.anchor-aspect-y": "只按 y 轴变大的比例变大 (保持比例)",
   "figure.label.anchor-aspect-z": "只按 z 轴变大的比例变大 (保持比例)",
   "figure.label.anchor-auto": "自动 ({rule})",
+  "figure.label.anchor-advanced": "advanced proportional sizing",
+  "figure.label.anchor-choice-auto": "automatic",
+  "figure.label.anchor-choice-aspect-x": "keep X ratio",
+  "figure.label.anchor-choice-aspect-y": "keep Y ratio",
+  "figure.label.anchor-choice-aspect-z": "keep Z ratio",
+  "figure.label.anchor-choice-center": "stay centred",
+  "figure.label.anchor-choice-max-x": "right face",
+  "figure.label.anchor-choice-max-y": "upper face",
+  "figure.label.anchor-choice-max-z": "front face",
+  "figure.label.anchor-choice-min-x": "left face",
+  "figure.label.anchor-choice-min-y": "lower face",
+  "figure.label.anchor-choice-min-z": "back face",
+  "figure.label.anchor-choice-scale": "grow together",
+  "figure.label.anchor-choice-span": "fill both faces",
   "figure.label.anchor-center": "留在中间，尺寸不变",
   "figure.label.anchor-max": "贴在较大一侧的面",
   "figure.label.anchor-max-x": "贴在右面",
@@ -107,6 +126,18 @@
   "figure.label.now": "current",
   "figure.label.on-by-default": "on by default",
   "figure.label.palette-token": "palette token",
+  "figure.label.palette-role": "color role",
+  "figure.label.palette-purpose-accent": "accent part · handles and covers that must stand out",
+  "figure.label.palette-purpose-danger": "danger signal · an error or stop indicator",
+  "figure.label.palette-purpose-dark": "frame and shadow · dark structure and edges",
+  "figure.label.palette-purpose-info": "information signal · an operating-information indicator",
+  "figure.label.palette-purpose-light": "light face · light housings and label surrounds",
+  "figure.label.palette-purpose-neutral": "neutral machine face · supporting structures and machine parts",
+  "figure.label.palette-purpose-primary": "main body · the largest equipment housing",
+  "figure.label.palette-purpose-registered": "registered palette color",
+  "figure.label.palette-purpose-success": "normal signal · a normal-operation indicator",
+  "figure.label.palette-purpose-surface": "surface and background · broad background faces",
+  "figure.label.palette-purpose-warning": "warning signal · an attention-needed indicator",
   "figure.label.part": "part",
   "figure.label.part-material": "material",
   "figure.label.part-position": "position (centre)",
@@ -236,6 +267,7 @@
   "figure.text.nothing-released-yet": "还没有发布过。发布后会把当前的图形保留为一个版本。",
   "figure.text.on-by-default-explained": "the starting state when placed on a board. an instance switching it wins.",
   "figure.text.other-segment-count": "enter a value",
+  "figure.text.more-segment-options": "advanced segment counts",
   "figure.text.part-limit-reached": "the detail level allows no more parts — raise the level or remove a part.",
   "figure.text.part-limit-reached-short": "level {level} allows {limit} parts. Raise the level or remove a part.",
   "figure.text.pick-a-shape-above-to-start": "pick a shape above to add the first part.",