@things-factory/figure-ui 10.1.15 → 10.1.16

package/client/modeller/figure-source.ts

@@ -62,16 +62,32 @@ import { FIGURE_SOURCE_VERSION, type DetailLevel, type FigurePart, type FigurePl
  * is the guard below actually earning its keep. The third showed up as a conveyor motor that stayed on the
  * floor no matter what the sample said; the fourth as a hollowed tray that
  * came out a solid block.
+ *
+ * All four passed the round-trip test, because the fixture it uses did not
+ * carry the field. So the test now reads the **field list the format declares**
+ * rather than trusting the fixture.
+ *
+ * `shape` is unpacked into `round`, `path` and `hollow` rather than carried
+ * whole, because the editor holds those as separate state. Every field added
+ * under `shape` costs a line here, and forgetting that line was the fourth
+ * of the four.
  */
 /** 판 컴포넌트의 상태. 씬의 용어 그대로다. */
 export interface BoardModel {
   /** 형식 버전. */
   version?: number
-  /** 가로 너비 (mm). 씬의 x 축. */
+  /*
+    The three sizes keep the scene component's names, and the scene assigns its axes differently
+    from the format: here `depth` is the vertical one. Naming the axis alone ("the y axis") does
+    not say which of the two conventions is meant, and this interface sits on the boundary between
+    them — so each field names the `FigureSource` field it becomes. `toFigureSource` and
+    `fromFigureSource` below are the only places that may disagree with these three lines.
+  */
+  /** 가로 너비 (mm) → `base.x`. */
   width: number
-  /** 세로 깊이 (mm). 씬의 y 축 (평면에서는 세로, 저작자가 위에서 내려다보는 세로). */
+  /** 앞뒤 깊이 (mm) → `base.z`. 저작자가 위에서 내려다볼 때의 세로다. */
   height: number
-  /** 높이 (mm). 씬의 z 축. */
+  /** 높이 (mm) → `base.y`. 서 있는 방향이다. */
   depth: number
   /** 컴포넌트 타입 이름. **저장되는 식별자다.** */
   figureType?: string
@@ -136,11 +152,21 @@ export interface PartModel {
 
   /** 색 토큰 이름 (`palette.primary` 등). */
   token?: string
-  preset?: FigurePart['material'] extends infer M ? (M extends { preset?: infer P } ? P : never) : never
+  /*
+    `FigurePart['material']` is required in the format, so these index into it directly. The
+    `NonNullable` on `shape` above is not the same case — `shape` is optional there.
+  */
+  preset?: FigurePart['material']['preset']
   flatShading?: boolean
   transparent?: boolean
-  emissive?: NonNullable<FigurePart['material']>['emissive']
-  surface?: NonNullable<FigurePart['material']>['surface']
+  /**
+   * 자체발광. 없으면 안 빛난다.
+   *
+   * 바깥의 `token` 이 **꺼진 모습**이고 이 안의 `token` 이 **켜진 모습**이다 — 꺼진
+   * 전구는 빨갛지 않고 어두운 플라스틱이다.
+   */
+  emissive?: FigurePart['material']['emissive']
+  surface?: FigurePart['material']['surface']
 
   /* 아직 아무 일도 안 하지만 잃어버리지 않는다. */
   materialSlot?: FigurePart['materialSlot']

package/client/pages/figure-modeller-page.ts

@@ -719,23 +719,26 @@ export class FigureModellerPage extends FigureModellerPageBase {
     }))
   }
 
-  private acceptDockProposal = (event: Event) => {
+  /*
+    `detail.staged` is the dock's answer to "did anything actually happen to my candidate". The
+    listener is synchronous, so the dock reads it right after dispatching and only then tells the
+    chat card to say so. It used to be called `accepted`, which claimed more than it knew — the
+    page had put the candidate somewhere, not the person had agreed to it.
+  */
+  private receiveDockProposal = (event: Event) => {
     const detail = (event as CustomEvent).detail
     if (!detail) return
-    if (detail?.baseSource && detail.baseSource !== JSON.stringify(this.folded)) {
-      try {
-        const parsedBase = typeof detail.baseSource === 'string' ? JSON.parse(detail.baseSource) : detail.baseSource
-        if (parsedBase?.type && this.folded?.type && parsedBase.type !== this.folded.type) {
-          // type 불일치 시에만 차단하고 그 외 미세 차이는 수용
-        }
-      } catch {
-        // ignore
-      }
-    }
-    const source = detail?.source || (detail?.proposal?.source ? (typeof detail.proposal.source === 'string' ? JSON.parse(detail.proposal.source) : detail.proposal.source) : undefined)
+
+    const source =
+      detail?.source ||
+      (detail?.proposal?.source
+        ? typeof detail.proposal.source === 'string'
+          ? JSON.parse(detail.proposal.source)
+          : detail.proposal.source
+        : undefined)
+
     if (source) {
-      this.applySourceDirectly(source, detail.proposal)
-      detail.accepted = true
+      detail.staged = this.openProposalForReview(source, detail.proposal)
     }
   }
 
@@ -743,36 +746,71 @@ export class FigureModellerPage extends FigureModellerPageBase {
     const detail = (event as CustomEvent).detail
     const source = detail?.source || (detail?.proposal?.source ? (typeof detail.proposal.source === 'string' ? JSON.parse(detail.proposal.source) : detail.proposal.source) : undefined)
     if (source) {
-      this.applySourceDirectly(source, detail.proposal)
+      this.openProposalForReview(source, detail.proposal)
     }
   }
 
-  private applySourceDirectly(rawSource: any, proposal?: any) {
+  /**
+   * A candidate from the dock opens the review lane. It does not become the draft.
+   *
+   * This used to write `board` and `parts` straight onto the working draft and then set
+   * `proposalSession = undefined` — the dock's candidate overwrote what the author had open and
+   * erased the lane built to review it. There was no moment where the person said yes, and a
+   * draft has no version history to go back to, so the previous work was simply gone.
+   *
+   * `ai-client-base`'s analysis contract states this as a literal type: `approvalRequired: true`,
+   * and of `proposal`, "It is never an instruction to mutate canonical state." The in-page
+   * `figure-ask` entrance already honoured it through `openAiProposal`; the dock entrance is now
+   * the same door. Applying is what the take button does, from the lane, per change.
+   *
+   * ## Why the overwrite was there — so it does not come back
+   *
+   * The dock opened the review lane originally. Before `c42a0b63df` this handler read:
+   *
+   *     if (!this.active || (detail?.figureId ?? '') !== (this.figure?.id ?? '')) return
+   *     if (detail?.draftType && detail.draftType !== this.folded?.type) return
+   *     if (detail?.baseSource && detail.baseSource !== JSON.stringify(this.folded)) return
+   *     this.receive(detail.proposal)
+   *
+   * Three guards, each a silent `return`, and the last compared a serialized source byte for byte.
+   * Any difference that changed nothing at all dropped the candidate with no message, so the dock
+   * would report a candidate and the screen would show none.
+   *
+   * The `ox-assistant-chat` migration fixed that by replacing the path rather than the guards, and
+   * the review lane went out with them — `applySourceDirectly` wrote straight to the draft, and
+   * cleared `proposalSession` on the way past. **Nobody decided that reviews were unwanted here.**
+   * It was the cost of loosening a guard by deleting what stood around it.
+   *
+   * So the guards are gone and stay gone, and the lane is back. If a candidate ever seems not to
+   * arrive, the thing to look for is a silent `return` on this path — not the lane.
+   *
+   * Returns whether the lane opened, so the dock can tell the chat whether to say it staged.
+   */
+  private openProposalForReview(rawSource: any, proposal?: any): boolean {
     const source = typeof rawSource === 'string' ? JSON.parse(rawSource) : rawSource
-    if (!source || !Array.isArray(source.parts)) return
+    if (!source || !Array.isArray(source.parts)) return false
 
-    this.recordHistory()
     try {
-      const { board, parts } = fromFigureSource(source)
-      this.board = board
-      this.parts = parts
-      this.dirty = true
-      this.selected = parts.length ? 0 : -1
-
-      if (source.type) {
-        this.figure = { ...(this.figure || {}), type: source.type } as Figure
-        if (this.board) {
-          this.board = { ...this.board, figureType: source.type }
-        }
-      }
-
-      this.proposalSession = undefined
-      this.sceneRevision++
-
+      /*
+        The dock sends a FigureProposal whose metrics sit at the top level; the staged-on-navigate
+        path carries the raw tool result, which nests them under score/cost. Read both rather than
+        making one of the two entrances reshape its payload.
+      */
+      this.proposalSession = proposalSessions.openAiProposal(this.folded, {
+        source: JSON.stringify(source),
+        grade: proposal?.grade ?? proposal?.score?.grade,
+        triangles: proposal?.triangles ?? proposal?.cost?.triangles,
+        groups: proposal?.groups ?? proposal?.cost?.groups,
+        attempts: proposal?.attempts,
+        quality: proposal?.quality
+      } as FigureProposal)
+
+      this.mode = 'edit'
       this.requestUpdate()
-      document.dispatchEvent(new CustomEvent('notify', { detail: { message: `${source.type || 'Figure'} 모델이 3D 뷰어에 반영되었습니다.` } }))
+      return true
     } catch (e) {
-      console.error('[FigureModeller] Failed to apply AI proposal source:', e)
+      console.error('[FigureModeller] Failed to open the AI candidate for review:', e)
+      return false
     }
   }
 
@@ -781,7 +819,7 @@ export class FigureModellerPage extends FigureModellerPageBase {
   connectedCallback() {
     super.connectedCallback()
     window.addEventListener('figure-ai-context-request', this.announceAiContext)
-    window.addEventListener('figure-ai-review', this.acceptDockProposal)
+    window.addEventListener('figure-ai-review', this.receiveDockProposal)
     window.addEventListener('figure-ai-stage', this.onFigureAiStage)
     window.addEventListener('figure-save-request', this.onSaveRequest)
     window.addEventListener('keydown', this.handleKeyDown)
@@ -792,7 +830,7 @@ export class FigureModellerPage extends FigureModellerPageBase {
     window.removeEventListener('figure-save-request', this.onSaveRequest)
     window.removeEventListener('figure-ai-stage', this.onFigureAiStage)
     window.removeEventListener('figure-ai-context-request', this.announceAiContext)
-    window.removeEventListener('figure-ai-review', this.acceptDockProposal)
+    window.removeEventListener('figure-ai-review', this.receiveDockProposal)
     window.dispatchEvent(new CustomEvent('figure-ai-context', { detail: undefined }))
     super.disconnectedCallback()
   }
@@ -1286,7 +1324,7 @@ export class FigureModellerPage extends FigureModellerPageBase {
       }
       const pending = consumePendingFigureProposal()
       if (pending?.source) {
-        this.applySourceDirectly(pending.source, pending.proposal)
+        this.openProposalForReview(pending.source, pending.proposal)
       }
       return
     }
@@ -1307,7 +1345,7 @@ export class FigureModellerPage extends FigureModellerPageBase {
       this.startNew()
       const pending = consumePendingFigureProposal()
       if (pending?.source) {
-        this.applySourceDirectly(pending.source, pending.proposal)
+        this.openProposalForReview(pending.source, pending.proposal)
       }
       return
     }
@@ -1316,7 +1354,7 @@ export class FigureModellerPage extends FigureModellerPageBase {
       this.startNew()
       const pending = consumePendingFigureProposal()
       if (pending?.source) {
-        this.applySourceDirectly(pending.source, pending.proposal)
+        this.openProposalForReview(pending.source, pending.proposal)
       }
       return
     }
@@ -1325,14 +1363,14 @@ export class FigureModellerPage extends FigureModellerPageBase {
       this.startNew()
       const pending = consumePendingFigureProposal()
       if (pending?.source) {
-        this.applySourceDirectly(pending.source, pending.proposal)
+        this.openProposalForReview(pending.source, pending.proposal)
       }
       return
     }
 
     const pending = consumePendingFigureProposal()
     if (pending?.source) {
-      this.applySourceDirectly(pending.source, pending.proposal)
+      this.openProposalForReview(pending.source, pending.proposal)
     }
   }
 

package/dist-client/modeller/figure-source.d.ts

@@ -61,16 +61,25 @@ import { type DetailLevel, type FigurePart, type FigurePlacement, type FigureSou
  * is the guard below actually earning its keep. The third showed up as a conveyor motor that stayed on the
  * floor no matter what the sample said; the fourth as a hollowed tray that
  * came out a solid block.
+ *
+ * All four passed the round-trip test, because the fixture it uses did not
+ * carry the field. So the test now reads the **field list the format declares**
+ * rather than trusting the fixture.
+ *
+ * `shape` is unpacked into `round`, `path` and `hollow` rather than carried
+ * whole, because the editor holds those as separate state. Every field added
+ * under `shape` costs a line here, and forgetting that line was the fourth
+ * of the four.
  */
 /** 판 컴포넌트의 상태. 씬의 용어 그대로다. */
 export interface BoardModel {
     /** 형식 버전. */
     version?: number;
-    /** 가로 너비 (mm). 씬의 x 축. */
+    /** 가로 너비 (mm) → `base.x`. */
     width: number;
-    /** 세로 깊이 (mm). 씬의 y 축 (평면에서는 세로, 저작자가 위에서 내려다보는 세로). */
+    /** 앞뒤 깊이 (mm) → `base.z`. 저작자가 위에서 내려다볼 때의 세로다. */
     height: number;
-    /** 높이 (mm). 씬의 z 축. */
+    /** 높이 (mm) → `base.y`. 서 있는 방향이다. */
     depth: number;
     /** 컴포넌트 타입 이름. **저장되는 식별자다.** */
     figureType?: string;
@@ -132,13 +141,17 @@ export interface PartModel {
     hidden?: boolean;
     /** 색 토큰 이름 (`palette.primary` 등). */
     token?: string;
-    preset?: FigurePart['material'] extends infer M ? (M extends {
-        preset?: infer P;
-    } ? P : never) : never;
+    preset?: FigurePart['material']['preset'];
     flatShading?: boolean;
     transparent?: boolean;
-    emissive?: NonNullable<FigurePart['material']>['emissive'];
-    surface?: NonNullable<FigurePart['material']>['surface'];
+    /**
+     * 자체발광. 없으면 안 빛난다.
+     *
+     * 바깥의 `token` 이 **꺼진 모습**이고 이 안의 `token` 이 **켜진 모습**이다 — 꺼진
+     * 전구는 빨갛지 않고 어두운 플라스틱이다.
+     */
+    emissive?: FigurePart['material']['emissive'];
+    surface?: FigurePart['material']['surface'];
     materialSlot?: FigurePart['materialSlot'];
     /** 단면을 원으로 지킬까. 곡면만 뜻이 있고 기본은 지키는 것이다. */
     keepRound?: FigurePart['keepRound'];

package/dist-client/modeller/figure-source.js.map

@@ -1 +1 @@
-{"version":3,"file":"figure-source.js","sourceRoot":"","sources":["../../client/modeller/figure-source.ts"],"names":[],"mappings":"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","sourcesContent":["import { FIGURE_SOURCE_VERSION, type DetailLevel, type FigurePart, type FigurePlacement, type FigureSource, type Vec3 } from '@hatiolab/figure-model'\n\n/**\n * Scene model <-> `FigureSource`.\n *\n * ## Why this is the only place that converts\n *\n * While authoring, the source of truth is the **scene model** -- part\n * components sitting on a board. `FigureSource` is produced from it when the\n * asset is saved or scored.\n *\n * The two use different vocabularies. The scene inherited 2D canvas terms\n * (`width`/`height` in plan, `depth` for height, `left`/`top`/`zPos` for\n * position); the format uses the axes 3D tools use (`x` right, `y` up, `z`\n * front, position at the part's **centre**).\n *\n * **Convert in one place.** Two places drift, and this format has already had\n * one incident caused by axes disagreeing.\n *\n * ## It was called `fold`, and that was wrong\n *\n * `fold` is an established term -- it reduces a structure to a summary, and\n * this repo already uses it correctly (`foldKpi`, `foldProbeResults`). Nothing\n * is reduced here: the same information comes out in a different shape, and it\n * goes back unchanged. A reader who learned `fold` from `foldKpi` reads this\n * one as reducing something, and the user did exactly that.\n *\n * ## The mapping\n *\n * The board is the base box; its centre is the format's origin.\n *\n *     format            scene\n *     ────────────────  ──────────────────────────────\n *     base.x            board width\n *     base.y            board depth      <- height\n *     base.z            board height\n *\n *     size.x            width\n *     size.y            depth\n *     size.z            height\n *\n *     position.x        left + width/2  - board width/2\n *     position.y        zPos + depth/2  - board depth/2      <- zPos is the underside\n *     position.z        top  + height/2 - board height/2\n *\n *     rotation.x        rotationX       (scene radians, format degrees)\n *     rotation.y        -rotation\n *     rotation.z        rotationY\n *\n * The rotation names are crossed because of the scene: `rotationY` becomes\n * three's z (`real-object.ts`, `get rotation()`). That stays inside this table.\n *\n * ## Fields nothing reads yet still travel\n *\n * `materialSlot`, `keepRound`, `sizing`, `anchor`, `repeat` and `label` exist in the format\n * and the editor ignores them. They still have to survive a round trip. When a\n * source proposed by AI is opened, edited and written back, a field that\n * disappears **without an error** is one the author cannot know about.\n *\n * **Five have gone that way here**: `ports`, `animations`, `anchor`,\n * `shape.hollow` and `keepRound`. The last one the test caught first, which\n * is the guard below actually earning its keep. The third showed up as a conveyor motor that stayed on the\n * floor no matter what the sample said; the fourth as a hollowed tray that\n * came out a solid block.\n */\n/** 판 컴포넌트의 상태. 씬의 용어 그대로다. */\nexport interface BoardModel {\n  /** 형식 버전. */\n  version?: number\n  /** 가로 너비 (mm). 씬의 x 축. */\n  width: number\n  /** 세로 깊이 (mm). 씬의 y 축 (평면에서는 세로, 저작자가 위에서 내려다보는 세로). */\n  height: number\n  /** 높이 (mm). 씬의 z 축. */\n  depth: number\n  /** 컴포넌트 타입 이름. **저장되는 식별자다.** */\n  figureType?: string\n  /** 3D 배치 기준면 ('floor' | 'ceiling' | 'center'). */\n  placement?: FigurePlacement\n  detailLevel?: DetailLevel\n  styleKit?: string\n  /**\n   * 움직임. **부품 바깥에 있다** — clip 하나가 부품 여럿을 함께 움직이기 때문이다.\n   *\n   * 편집면이 아직 이것을 만지지 않는다. 그래도 여기 실어 두는 것은, 안 실으면 열었다\n   * 저장하는 것만으로 **조용히 지워지기** 때문이다.\n   */\n  animations?: FigureSource['animations']\n  /**\n   * 이 도형이 지는 능력. 씬의 capability mixin 이름이다.\n   *\n   * **부품이 아니라 도형 전체의 것이다** — 「이 컨베이어는 흐름의 마디다」는 부품 하나가\n   * 아니라 도형이 지는 성질이다. 부품 쪽 `capability` 는 그 능력을 **어느 부품이 받쳐\n   * 주나**를 말하는 다른 칸이다.\n   */\n  capabilities?: FigureSource['capabilities']\n}\n\n/** 부품 컴포넌트의 상태. 씬의 용어 그대로다. */\nexport interface PartModel {\n  type: 'figure-part'\n  /** 부품 이름. **저장되는 식별자다.** 씬은 이 값을 검색에도 쓴다. */\n  name: string\n  primitive: FigurePart['primitive']\n\n  left: number\n  top: number\n  width: number\n  height: number\n  /** 부피의 **밑면** 높이. 씬의 'floor' 배치에서 그렇게 정해져 있다. */\n  zPos: number\n  depth: number\n\n  /** 라디안. 씬이 그렇게 쓴다. */\n  rotationX?: number\n  rotation?: number\n  rotationY?: number\n\n  segments?: number\n  round?: number\n  path?: { x: number; y: number }[]\n  /** 속을 판 단면. 편집면이 아직 안 만지지만 잃어버리면 통이 통짜 상자가 된다. */\n  hollow?: NonNullable<FigurePart['shape']>['hollow']\n\n  /**\n   * 편집 중에만 쓰는 상태 — **저장 형식으로 넘어가지 않는다.**\n   *\n   * 씬이 이미 갖고 있는 속성이다. 편집 모드에서는 `faint`(반투명 + 색을 버리고 회색으로\n   * 수렴)로 보이고, 뷰 모드에서는 아예 안 그려진다. 판단은 씬의 `modeling-faint` 한 곳에\n   * 있고 2D 캔버스·3D 재질·DOM 세 채널이 같이 쓴다.\n   *\n   * 숨김은 \"지금 이 뒤를 만지려고\" 하는 것이지 그 부품의 성질이 아니다. 그래서\n   * `toFigureSource` 가 싣지 않고, 다시 열면 전부 보이는 상태로 돌아온다.\n   */\n  hidden?: boolean\n\n  /** 색 토큰 이름 (`palette.primary` 등). */\n  token?: string\n  preset?: FigurePart['material'] extends infer M ? (M extends { preset?: infer P } ? P : never) : never\n  flatShading?: boolean\n  transparent?: boolean\n  emissive?: NonNullable<FigurePart['material']>['emissive']\n  surface?: NonNullable<FigurePart['material']>['surface']\n\n  /* 아직 아무 일도 안 하지만 잃어버리지 않는다. */\n  materialSlot?: FigurePart['materialSlot']\n  /** 단면을 원으로 지킬까. 곡면만 뜻이 있고 기본은 지키는 것이다. */\n  keepRound?: FigurePart['keepRound']\n  sizing?: FigurePart['sizing']\n  /** 축마다 어느 면을 붙잡나. `sizing` 이 정한 것을 덮어쓴다. */\n  anchor?: FigurePart['anchor']\n  repeat?: FigurePart['repeat']\n  label?: FigurePart['label']\n  /**\n   * 이 부품이 능력의 어느 자리인가 — 물건이 앉는 자리(slot)이거나 드나드는 문(port)이다.\n   *\n   * 이 칸이 있는 부품은 **그려지지 않는다.** 저작면에서는 어디인지 보여야 하니 그리지만,\n   * 청사진에서는 `groups` 가 아니라 `anchors` 로 간다.\n   */\n  capability?: FigurePart['capability']\n}\n\nconst RAD_TO_DEG = 180 / Math.PI\nconst DEG_TO_RAD = Math.PI / 180\n\n/** 값이 있는 것만 남긴다. 없는 필드를 `undefined` 로 두면 접었다 편 것이 원본과 달라진다. */\nfunction withoutEmpty<T extends object>(value: T): T {\n  const out = {} as Record<string, unknown>\n  for (const [key, item] of Object.entries(value)) {\n    if (item !== undefined) out[key] = item\n  }\n  return out as T\n}\n\n/** 소수점 넷째 자리까지. 라디안↔도를 오가며 생기는 꼬리를 자른다. */\nfunction round4(value: number): number {\n  return Math.round(value * 1e4) / 1e4\n}\n\n/**\n * 판의 절반. 형식의 원점이 판 중심이라 이 값이 늘 함께 다닌다.\n *\n * 축 이름은 **형식의 것**이다 — x 가로 · y 높이 · z 세로.\n */\nexport function halfOf(board: BoardModel): Vec3 {\n  return { x: board.width / 2, y: board.depth / 2, z: board.height / 2 }\n}\n\n/**\n * 저작자가 보는 축이 씬의 어느 용어인가.\n *\n * 씬은 2D 캔버스에서 온 용어를 쓰므로 축 이름이 그대로 없다. 이 표가 **유일한** 대응이다 —\n * 편집 규칙이 저마다 자기 표를 들면 한 곳을 고칠 때 다른 곳이 남는다.\n */\nexport const AXIS_KEYS = {\n  x: { at: 'left', size: 'width' },\n  y: { at: 'zPos', size: 'depth' },\n  z: { at: 'top', size: 'height' }\n} as const\n\nexport type PlaneAxis = keyof typeof AXIS_KEYS\n\n/** 판이 그 축으로 얼마나 넓은가. */\nexport function boardExtent(board: BoardModel, axis: PlaneAxis): number {\n  return axis === 'x' ? board.width : axis === 'y' ? board.depth : board.height\n}\n\n/** 부품 하나를 저장 형식으로 변환한다. 저작 화면이 저작자의 어휘로 보일 때 쓴다. */\nexport function partToFigure(part: PartModel, board: BoardModel): FigurePart {\n  return partTo(part, halfOf(board))\n}\n\n/** 부품 하나를 씬 용어로 되돌린다. */\nexport function partFromFigure(part: FigurePart, board: BoardModel): PartModel {\n  return partFrom(part, halfOf(board))\n}\n\n/** 씬 모델을 저장 형식으로 변환한다. */\nexport function toFigureSource(board: BoardModel, parts: PartModel[]): FigureSource {\n  const half = halfOf(board)\n\n  return withoutEmpty({\n    version: board.version ?? FIGURE_SOURCE_VERSION,\n    type: board.figureType ?? '',\n    base: { x: board.width, y: board.depth, z: board.height },\n    placement: board.placement,\n    detailLevel: board.detailLevel,\n    styleKit: board.styleKit,\n    parts: parts.map(part => partTo(part, half)),\n    animations: board.animations,\n    capabilities: board.capabilities\n  }) as FigureSource\n}\n\nfunction partTo(part: PartModel, half: Vec3): FigurePart {\n  const rotation = withoutEmpty({\n    x: part.rotationX ? round4(part.rotationX * RAD_TO_DEG) : undefined,\n    y: part.rotation ? round4(-part.rotation * RAD_TO_DEG) : undefined,\n    z: part.rotationY ? round4(part.rotationY * RAD_TO_DEG) : undefined\n  })\n\n  const shape = withoutEmpty({ round: part.round, path: part.path, hollow: part.hollow })\n  /*\n    재질이 하나도 없으면 **칸 자체를 안 적는다.**\n\n    빈 객체를 적으면 형식이 「재질은 있는데 무엇으로 칠할지 모른다」로 읽어\n    `material-unresolvable` 을 낸다. 그리지 않는 자리(`capability`)에는 재질이 없는 것이\n    정상이고, 그 부품이 조용히 오류를 달고 다니게 된다.\n  */\n  const material = withoutEmpty({\n    token: part.token,\n    preset: part.preset,\n    flatShading: part.flatShading,\n    transparent: part.transparent,\n    emissive: part.emissive,\n    surface: part.surface\n  })\n\n  return withoutEmpty({\n    name: part.name,\n    primitive: part.primitive,\n    transform: withoutEmpty({\n      position: {\n        x: round4(part.left + part.width / 2 - half.x),\n        y: round4(part.zPos + part.depth / 2 - half.y),\n        z: round4(part.top + part.height / 2 - half.z)\n      },\n      size: { x: part.width, y: part.depth, z: part.height },\n      rotation: Object.keys(rotation).length > 0 ? rotation : undefined\n    }),\n    segments: part.segments,\n    shape: Object.keys(shape).length > 0 ? shape : undefined,\n    material: Object.keys(material).length > 0 ? material : undefined,\n    materialSlot: part.materialSlot,\n    keepRound: part.keepRound,\n    sizing: part.sizing,\n    anchor: part.anchor,\n    repeat: part.repeat,\n    label: part.label,\n    capability: part.capability\n  }) as FigurePart\n}\n\n/** 형식을 씬 모델로 편다. */\nexport function fromFigureSource(source: FigureSource): { board: BoardModel; parts: PartModel[] } {\n  const half: Vec3 = { x: source.base.x / 2, y: source.base.y / 2, z: source.base.z / 2 }\n\n  const board = withoutEmpty({\n    version: source.version,\n    width: source.base.x,\n    height: source.base.z,\n    depth: source.base.y,\n    figureType: source.type,\n    placement: source.placement,\n    detailLevel: source.detailLevel,\n    styleKit: source.styleKit,\n    animations: source.animations,\n    capabilities: source.capabilities\n  }) as BoardModel\n\n  return { board, parts: source.parts.map(part => partFrom(part, half)) }\n}\n\nfunction partFrom(part: FigurePart, half: Vec3): PartModel {\n  const { position, size, rotation } = part.transform\n  const material = part.material ?? {}\n\n  return withoutEmpty({\n    type: 'figure-part',\n    name: part.name,\n    primitive: part.primitive,\n\n    left: round4(half.x + position.x - size.x / 2),\n    top: round4(half.z + position.z - size.z / 2),\n    width: size.x,\n    height: size.z,\n    zPos: round4(half.y + position.y - size.y / 2),\n    depth: size.y,\n\n    /*\n      라디안은 자르지 않는다.\n\n      소수 넷째에서 잘랐더니 도로 되돌릴 때 57 배로 커져 45 도가 45.0001 이 됐다.\n      자르는 것은 **사람이 읽는 쪽**(도)에서만 한다.\n    */\n    rotationX: rotation?.x ? rotation.x * DEG_TO_RAD : undefined,\n    rotation: rotation?.y ? -rotation.y * DEG_TO_RAD : undefined,\n    rotationY: rotation?.z ? rotation.z * DEG_TO_RAD : undefined,\n\n    segments: part.segments,\n    round: part.shape?.round,\n    path: part.shape?.path,\n    hollow: part.shape?.hollow,\n\n    token: material.token,\n    preset: material.preset,\n    flatShading: material.flatShading,\n    transparent: material.transparent,\n    emissive: material.emissive,\n    surface: material.surface,\n\n    materialSlot: part.materialSlot,\n    keepRound: part.keepRound,\n    sizing: part.sizing,\n    anchor: part.anchor,\n    repeat: part.repeat,\n    label: part.label,\n    capability: part.capability\n  }) as PartModel\n}\n"]}
+{"version":3,"file":"figure-source.js","sourceRoot":"","sources":["../../client/modeller/figure-source.ts"],"names":[],"mappings":"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","sourcesContent":["import { FIGURE_SOURCE_VERSION, type DetailLevel, type FigurePart, type FigurePlacement, type FigureSource, type Vec3 } from '@hatiolab/figure-model'\n\n/**\n * Scene model <-> `FigureSource`.\n *\n * ## Why this is the only place that converts\n *\n * While authoring, the source of truth is the **scene model** -- part\n * components sitting on a board. `FigureSource` is produced from it when the\n * asset is saved or scored.\n *\n * The two use different vocabularies. The scene inherited 2D canvas terms\n * (`width`/`height` in plan, `depth` for height, `left`/`top`/`zPos` for\n * position); the format uses the axes 3D tools use (`x` right, `y` up, `z`\n * front, position at the part's **centre**).\n *\n * **Convert in one place.** Two places drift, and this format has already had\n * one incident caused by axes disagreeing.\n *\n * ## It was called `fold`, and that was wrong\n *\n * `fold` is an established term -- it reduces a structure to a summary, and\n * this repo already uses it correctly (`foldKpi`, `foldProbeResults`). Nothing\n * is reduced here: the same information comes out in a different shape, and it\n * goes back unchanged. A reader who learned `fold` from `foldKpi` reads this\n * one as reducing something, and the user did exactly that.\n *\n * ## The mapping\n *\n * The board is the base box; its centre is the format's origin.\n *\n *     format            scene\n *     ────────────────  ──────────────────────────────\n *     base.x            board width\n *     base.y            board depth      <- height\n *     base.z            board height\n *\n *     size.x            width\n *     size.y            depth\n *     size.z            height\n *\n *     position.x        left + width/2  - board width/2\n *     position.y        zPos + depth/2  - board depth/2      <- zPos is the underside\n *     position.z        top  + height/2 - board height/2\n *\n *     rotation.x        rotationX       (scene radians, format degrees)\n *     rotation.y        -rotation\n *     rotation.z        rotationY\n *\n * The rotation names are crossed because of the scene: `rotationY` becomes\n * three's z (`real-object.ts`, `get rotation()`). That stays inside this table.\n *\n * ## Fields nothing reads yet still travel\n *\n * `materialSlot`, `keepRound`, `sizing`, `anchor`, `repeat` and `label` exist in the format\n * and the editor ignores them. They still have to survive a round trip. When a\n * source proposed by AI is opened, edited and written back, a field that\n * disappears **without an error** is one the author cannot know about.\n *\n * **Five have gone that way here**: `ports`, `animations`, `anchor`,\n * `shape.hollow` and `keepRound`. The last one the test caught first, which\n * is the guard below actually earning its keep. The third showed up as a conveyor motor that stayed on the\n * floor no matter what the sample said; the fourth as a hollowed tray that\n * came out a solid block.\n *\n * All four passed the round-trip test, because the fixture it uses did not\n * carry the field. So the test now reads the **field list the format declares**\n * rather than trusting the fixture.\n *\n * `shape` is unpacked into `round`, `path` and `hollow` rather than carried\n * whole, because the editor holds those as separate state. Every field added\n * under `shape` costs a line here, and forgetting that line was the fourth\n * of the four.\n */\n/** 판 컴포넌트의 상태. 씬의 용어 그대로다. */\nexport interface BoardModel {\n  /** 형식 버전. */\n  version?: number\n  /*\n    The three sizes keep the scene component's names, and the scene assigns its axes differently\n    from the format: here `depth` is the vertical one. Naming the axis alone (\"the y axis\") does\n    not say which of the two conventions is meant, and this interface sits on the boundary between\n    them — so each field names the `FigureSource` field it becomes. `toFigureSource` and\n    `fromFigureSource` below are the only places that may disagree with these three lines.\n  */\n  /** 가로 너비 (mm) → `base.x`. */\n  width: number\n  /** 앞뒤 깊이 (mm) → `base.z`. 저작자가 위에서 내려다볼 때의 세로다. */\n  height: number\n  /** 높이 (mm) → `base.y`. 서 있는 방향이다. */\n  depth: number\n  /** 컴포넌트 타입 이름. **저장되는 식별자다.** */\n  figureType?: string\n  /** 3D 배치 기준면 ('floor' | 'ceiling' | 'center'). */\n  placement?: FigurePlacement\n  detailLevel?: DetailLevel\n  styleKit?: string\n  /**\n   * 움직임. **부품 바깥에 있다** — clip 하나가 부품 여럿을 함께 움직이기 때문이다.\n   *\n   * 편집면이 아직 이것을 만지지 않는다. 그래도 여기 실어 두는 것은, 안 실으면 열었다\n   * 저장하는 것만으로 **조용히 지워지기** 때문이다.\n   */\n  animations?: FigureSource['animations']\n  /**\n   * 이 도형이 지는 능력. 씬의 capability mixin 이름이다.\n   *\n   * **부품이 아니라 도형 전체의 것이다** — 「이 컨베이어는 흐름의 마디다」는 부품 하나가\n   * 아니라 도형이 지는 성질이다. 부품 쪽 `capability` 는 그 능력을 **어느 부품이 받쳐\n   * 주나**를 말하는 다른 칸이다.\n   */\n  capabilities?: FigureSource['capabilities']\n}\n\n/** 부품 컴포넌트의 상태. 씬의 용어 그대로다. */\nexport interface PartModel {\n  type: 'figure-part'\n  /** 부품 이름. **저장되는 식별자다.** 씬은 이 값을 검색에도 쓴다. */\n  name: string\n  primitive: FigurePart['primitive']\n\n  left: number\n  top: number\n  width: number\n  height: number\n  /** 부피의 **밑면** 높이. 씬의 'floor' 배치에서 그렇게 정해져 있다. */\n  zPos: number\n  depth: number\n\n  /** 라디안. 씬이 그렇게 쓴다. */\n  rotationX?: number\n  rotation?: number\n  rotationY?: number\n\n  segments?: number\n  round?: number\n  path?: { x: number; y: number }[]\n  /** 속을 판 단면. 편집면이 아직 안 만지지만 잃어버리면 통이 통짜 상자가 된다. */\n  hollow?: NonNullable<FigurePart['shape']>['hollow']\n\n  /**\n   * 편집 중에만 쓰는 상태 — **저장 형식으로 넘어가지 않는다.**\n   *\n   * 씬이 이미 갖고 있는 속성이다. 편집 모드에서는 `faint`(반투명 + 색을 버리고 회색으로\n   * 수렴)로 보이고, 뷰 모드에서는 아예 안 그려진다. 판단은 씬의 `modeling-faint` 한 곳에\n   * 있고 2D 캔버스·3D 재질·DOM 세 채널이 같이 쓴다.\n   *\n   * 숨김은 \"지금 이 뒤를 만지려고\" 하는 것이지 그 부품의 성질이 아니다. 그래서\n   * `toFigureSource` 가 싣지 않고, 다시 열면 전부 보이는 상태로 돌아온다.\n   */\n  hidden?: boolean\n\n  /** 색 토큰 이름 (`palette.primary` 등). */\n  token?: string\n  /*\n    `FigurePart['material']` is required in the format, so these index into it directly. The\n    `NonNullable` on `shape` above is not the same case — `shape` is optional there.\n  */\n  preset?: FigurePart['material']['preset']\n  flatShading?: boolean\n  transparent?: boolean\n  /**\n   * 자체발광. 없으면 안 빛난다.\n   *\n   * 바깥의 `token` 이 **꺼진 모습**이고 이 안의 `token` 이 **켜진 모습**이다 — 꺼진\n   * 전구는 빨갛지 않고 어두운 플라스틱이다.\n   */\n  emissive?: FigurePart['material']['emissive']\n  surface?: FigurePart['material']['surface']\n\n  /* 아직 아무 일도 안 하지만 잃어버리지 않는다. */\n  materialSlot?: FigurePart['materialSlot']\n  /** 단면을 원으로 지킬까. 곡면만 뜻이 있고 기본은 지키는 것이다. */\n  keepRound?: FigurePart['keepRound']\n  sizing?: FigurePart['sizing']\n  /** 축마다 어느 면을 붙잡나. `sizing` 이 정한 것을 덮어쓴다. */\n  anchor?: FigurePart['anchor']\n  repeat?: FigurePart['repeat']\n  label?: FigurePart['label']\n  /**\n   * 이 부품이 능력의 어느 자리인가 — 물건이 앉는 자리(slot)이거나 드나드는 문(port)이다.\n   *\n   * 이 칸이 있는 부품은 **그려지지 않는다.** 저작면에서는 어디인지 보여야 하니 그리지만,\n   * 청사진에서는 `groups` 가 아니라 `anchors` 로 간다.\n   */\n  capability?: FigurePart['capability']\n}\n\nconst RAD_TO_DEG = 180 / Math.PI\nconst DEG_TO_RAD = Math.PI / 180\n\n/** 값이 있는 것만 남긴다. 없는 필드를 `undefined` 로 두면 접었다 편 것이 원본과 달라진다. */\nfunction withoutEmpty<T extends object>(value: T): T {\n  const out = {} as Record<string, unknown>\n  for (const [key, item] of Object.entries(value)) {\n    if (item !== undefined) out[key] = item\n  }\n  return out as T\n}\n\n/** 소수점 넷째 자리까지. 라디안↔도를 오가며 생기는 꼬리를 자른다. */\nfunction round4(value: number): number {\n  return Math.round(value * 1e4) / 1e4\n}\n\n/**\n * 판의 절반. 형식의 원점이 판 중심이라 이 값이 늘 함께 다닌다.\n *\n * 축 이름은 **형식의 것**이다 — x 가로 · y 높이 · z 세로.\n */\nexport function halfOf(board: BoardModel): Vec3 {\n  return { x: board.width / 2, y: board.depth / 2, z: board.height / 2 }\n}\n\n/**\n * 저작자가 보는 축이 씬의 어느 용어인가.\n *\n * 씬은 2D 캔버스에서 온 용어를 쓰므로 축 이름이 그대로 없다. 이 표가 **유일한** 대응이다 —\n * 편집 규칙이 저마다 자기 표를 들면 한 곳을 고칠 때 다른 곳이 남는다.\n */\nexport const AXIS_KEYS = {\n  x: { at: 'left', size: 'width' },\n  y: { at: 'zPos', size: 'depth' },\n  z: { at: 'top', size: 'height' }\n} as const\n\nexport type PlaneAxis = keyof typeof AXIS_KEYS\n\n/** 판이 그 축으로 얼마나 넓은가. */\nexport function boardExtent(board: BoardModel, axis: PlaneAxis): number {\n  return axis === 'x' ? board.width : axis === 'y' ? board.depth : board.height\n}\n\n/** 부품 하나를 저장 형식으로 변환한다. 저작 화면이 저작자의 어휘로 보일 때 쓴다. */\nexport function partToFigure(part: PartModel, board: BoardModel): FigurePart {\n  return partTo(part, halfOf(board))\n}\n\n/** 부품 하나를 씬 용어로 되돌린다. */\nexport function partFromFigure(part: FigurePart, board: BoardModel): PartModel {\n  return partFrom(part, halfOf(board))\n}\n\n/** 씬 모델을 저장 형식으로 변환한다. */\nexport function toFigureSource(board: BoardModel, parts: PartModel[]): FigureSource {\n  const half = halfOf(board)\n\n  return withoutEmpty({\n    version: board.version ?? FIGURE_SOURCE_VERSION,\n    type: board.figureType ?? '',\n    base: { x: board.width, y: board.depth, z: board.height },\n    placement: board.placement,\n    detailLevel: board.detailLevel,\n    styleKit: board.styleKit,\n    parts: parts.map(part => partTo(part, half)),\n    animations: board.animations,\n    capabilities: board.capabilities\n  }) as FigureSource\n}\n\nfunction partTo(part: PartModel, half: Vec3): FigurePart {\n  const rotation = withoutEmpty({\n    x: part.rotationX ? round4(part.rotationX * RAD_TO_DEG) : undefined,\n    y: part.rotation ? round4(-part.rotation * RAD_TO_DEG) : undefined,\n    z: part.rotationY ? round4(part.rotationY * RAD_TO_DEG) : undefined\n  })\n\n  const shape = withoutEmpty({ round: part.round, path: part.path, hollow: part.hollow })\n  /*\n    재질이 하나도 없으면 **칸 자체를 안 적는다.**\n\n    빈 객체를 적으면 형식이 「재질은 있는데 무엇으로 칠할지 모른다」로 읽어\n    `material-unresolvable` 을 낸다. 그리지 않는 자리(`capability`)에는 재질이 없는 것이\n    정상이고, 그 부품이 조용히 오류를 달고 다니게 된다.\n  */\n  const material = withoutEmpty({\n    token: part.token,\n    preset: part.preset,\n    flatShading: part.flatShading,\n    transparent: part.transparent,\n    emissive: part.emissive,\n    surface: part.surface\n  })\n\n  return withoutEmpty({\n    name: part.name,\n    primitive: part.primitive,\n    transform: withoutEmpty({\n      position: {\n        x: round4(part.left + part.width / 2 - half.x),\n        y: round4(part.zPos + part.depth / 2 - half.y),\n        z: round4(part.top + part.height / 2 - half.z)\n      },\n      size: { x: part.width, y: part.depth, z: part.height },\n      rotation: Object.keys(rotation).length > 0 ? rotation : undefined\n    }),\n    segments: part.segments,\n    shape: Object.keys(shape).length > 0 ? shape : undefined,\n    material: Object.keys(material).length > 0 ? material : undefined,\n    materialSlot: part.materialSlot,\n    keepRound: part.keepRound,\n    sizing: part.sizing,\n    anchor: part.anchor,\n    repeat: part.repeat,\n    label: part.label,\n    capability: part.capability\n  }) as FigurePart\n}\n\n/** 형식을 씬 모델로 편다. */\nexport function fromFigureSource(source: FigureSource): { board: BoardModel; parts: PartModel[] } {\n  const half: Vec3 = { x: source.base.x / 2, y: source.base.y / 2, z: source.base.z / 2 }\n\n  const board = withoutEmpty({\n    version: source.version,\n    width: source.base.x,\n    height: source.base.z,\n    depth: source.base.y,\n    figureType: source.type,\n    placement: source.placement,\n    detailLevel: source.detailLevel,\n    styleKit: source.styleKit,\n    animations: source.animations,\n    capabilities: source.capabilities\n  }) as BoardModel\n\n  return { board, parts: source.parts.map(part => partFrom(part, half)) }\n}\n\nfunction partFrom(part: FigurePart, half: Vec3): PartModel {\n  const { position, size, rotation } = part.transform\n  const material = part.material ?? {}\n\n  return withoutEmpty({\n    type: 'figure-part',\n    name: part.name,\n    primitive: part.primitive,\n\n    left: round4(half.x + position.x - size.x / 2),\n    top: round4(half.z + position.z - size.z / 2),\n    width: size.x,\n    height: size.z,\n    zPos: round4(half.y + position.y - size.y / 2),\n    depth: size.y,\n\n    /*\n      라디안은 자르지 않는다.\n\n      소수 넷째에서 잘랐더니 도로 되돌릴 때 57 배로 커져 45 도가 45.0001 이 됐다.\n      자르는 것은 **사람이 읽는 쪽**(도)에서만 한다.\n    */\n    rotationX: rotation?.x ? rotation.x * DEG_TO_RAD : undefined,\n    rotation: rotation?.y ? -rotation.y * DEG_TO_RAD : undefined,\n    rotationY: rotation?.z ? rotation.z * DEG_TO_RAD : undefined,\n\n    segments: part.segments,\n    round: part.shape?.round,\n    path: part.shape?.path,\n    hollow: part.shape?.hollow,\n\n    token: material.token,\n    preset: material.preset,\n    flatShading: material.flatShading,\n    transparent: material.transparent,\n    emissive: material.emissive,\n    surface: material.surface,\n\n    materialSlot: part.materialSlot,\n    keepRound: part.keepRound,\n    sizing: part.sizing,\n    anchor: part.anchor,\n    repeat: part.repeat,\n    label: part.label,\n    capability: part.capability\n  }) as PartModel\n}\n"]}

package/dist-client/pages/figure-modeller-page.d.ts

@@ -98,9 +98,45 @@ export declare class FigureModellerPage extends FigureModellerPageBase {
      */
     updated(changed: Map<string, unknown>): void;
     private announceAiContext;
-    private acceptDockProposal;
+    private receiveDockProposal;
     private onFigureAiStage;
-    private applySourceDirectly;
+    /**
+     * A candidate from the dock opens the review lane. It does not become the draft.
+     *
+     * This used to write `board` and `parts` straight onto the working draft and then set
+     * `proposalSession = undefined` — the dock's candidate overwrote what the author had open and
+     * erased the lane built to review it. There was no moment where the person said yes, and a
+     * draft has no version history to go back to, so the previous work was simply gone.
+     *
+     * `ai-client-base`'s analysis contract states this as a literal type: `approvalRequired: true`,
+     * and of `proposal`, "It is never an instruction to mutate canonical state." The in-page
+     * `figure-ask` entrance already honoured it through `openAiProposal`; the dock entrance is now
+     * the same door. Applying is what the take button does, from the lane, per change.
+     *
+     * ## Why the overwrite was there — so it does not come back
+     *
+     * The dock opened the review lane originally. Before `c42a0b63df` this handler read:
+     *
+     *     if (!this.active || (detail?.figureId ?? '') !== (this.figure?.id ?? '')) return
+     *     if (detail?.draftType && detail.draftType !== this.folded?.type) return
+     *     if (detail?.baseSource && detail.baseSource !== JSON.stringify(this.folded)) return
+     *     this.receive(detail.proposal)
+     *
+     * Three guards, each a silent `return`, and the last compared a serialized source byte for byte.
+     * Any difference that changed nothing at all dropped the candidate with no message, so the dock
+     * would report a candidate and the screen would show none.
+     *
+     * The `ox-assistant-chat` migration fixed that by replacing the path rather than the guards, and
+     * the review lane went out with them — `applySourceDirectly` wrote straight to the draft, and
+     * cleared `proposalSession` on the way past. **Nobody decided that reviews were unwanted here.**
+     * It was the cost of loosening a guard by deleting what stood around it.
+     *
+     * So the guards are gone and stay gone, and the lane is back. If a candidate ever seems not to
+     * arrive, the thing to look for is a silent `return` on this path — not the lane.
+     *
+     * Returns whether the lane opened, so the dock can tell the chat whether to say it staged.
+     */
+    private openProposalForReview;
     private proposalBaseSource?;
     connectedCallback(): void;
     disconnectedCallback(): void;