@things-factory/figure-ui 10.1.75 → 10.1.76

package/client/modeller/{v3-renderer.ts → renderer.ts}

@@ -1,8 +1,8 @@
 import * as THREE from 'three'
-import { buildV3Geometry } from '@hatiolab/things-scene'
+import { buildFigureGeometry } from '@hatiolab/things-scene'
 
-/** Evaluated V3 boundary: graph values are resolved before reaching the renderer. */
-export interface V3RenderPart {
+/** Evaluated boundary: graph values are resolved before reaching the renderer. */
+export interface FigureRenderPart {
   id: string
   shape: { provider: string; dimensions: Record<string, number>; profile?: Array<{x:number;y:number}> }
   pose: {r:number[][];t:number[]}
@@ -15,12 +15,12 @@ export interface V3RenderPart {
  *
  * Two are left out. A scalar body carries no shape or pose — it is a number the graph produced, not something
  * on screen. A body the asset hides is evaluated, placed and gated exactly as a shown one, and excluded from
- * rendering, from shadows and from pointer picking (V3 designer's ruling 2026-09-22); drawing it would make
+ * rendering, from shadows and from pointer picking (designer's ruling 2026-09-22); drawing it would make
  * "hidden" mean nothing in the modeller while it means something on a board.
  */
-export function drawableV3Parts(geometry: readonly unknown[]): V3RenderPart[] {
+export function drawableFigureParts(geometry: readonly unknown[]): FigureRenderPart[] {
   return geometry.filter(
-    (body): body is V3RenderPart =>
+    (body): body is FigureRenderPart =>
       !!body && typeof body === 'object' && 'shape' in body && 'pose' in body && (body as { visible?: boolean }).visible !== false
   )
 }
@@ -29,16 +29,16 @@ export function drawableV3Parts(geometry: readonly unknown[]): V3RenderPart[] {
  * The mesh for one body — things-scene's builder, not a copy of it.
  *
  * The modeller kept its own provider switch and it knew four providers; figures use eleven. A body the
- * board drew was refused here with "Unsupported V3 provider: roundedBoxXZ" (2026-09-24, the first canvas check of
+ * board drew was refused here with "Unsupported provider: roundedBoxXZ" (2026-09-24, the first canvas check of
  * ADR-0087 step 4). One builder, and the canvas an author looks at shows what a board will show.
  */
-function geometry(part: V3RenderPart): THREE.BufferGeometry {
-  const built = buildV3Geometry(part.shape as never, part.segments ?? 12) as THREE.BufferGeometry | undefined
-  if (!built) throw Error('Unsupported V3 provider: ' + part.shape.provider)
+function geometry(part: FigureRenderPart): THREE.BufferGeometry {
+  const built = buildFigureGeometry(part.shape as never, part.segments ?? 12) as THREE.BufferGeometry | undefined
+  if (!built) throw Error('Unsupported provider: ' + part.shape.provider)
   return built
 }
 
-export function disposeV3Meshes(group:THREE.Group):void {
+export function disposeFigureMeshes(group:THREE.Group):void {
  for(const child of [...group.children]){
   if(child instanceof THREE.Mesh){child.geometry.dispose();const materials=Array.isArray(child.material)?child.material:[child.material];materials.forEach(m=>m.dispose())}
   group.remove(child)
@@ -46,15 +46,15 @@ export function disposeV3Meshes(group:THREE.Group):void {
 }
 
 /** Build first, then swap; failed rendering must not erase the previous scene. No old meshes survive a successful swap. */
-export function replaceV3Meshes(group:THREE.Group,parts:readonly V3RenderPart[],palette:Record<string,string>):void {
+export function replaceFigureMeshes(group:THREE.Group,parts:readonly FigureRenderPart[],palette:Record<string,string>):void {
  const staged=new THREE.Group(),ids=new Set<string>()
  try{
   for(const part of parts){
-   if(ids.has(part.id))throw Error('Duplicate V3 geometry ID: '+part.id);ids.add(part.id)
+   if(ids.has(part.id))throw Error('Duplicate geometry ID: '+part.id);ids.add(part.id)
    const color=palette[part.material.token]
    if(!color||!/^#[0-9a-f]{6}$/i.test(color))throw Error('Unresolved material token: '+part.material.token)
    const {r,t}=part.pose
-   if(r.length!==3||r.some(row=>row.length!==3||row.some(x=>!Number.isFinite(x)))||t.length!==3||t.some(x=>!Number.isFinite(x)))throw Error('Invalid V3 pose: '+part.id)
+   if(r.length!==3||r.some(row=>row.length!==3||row.some(x=>!Number.isFinite(x)))||t.length!==3||t.some(x=>!Number.isFinite(x)))throw Error('Invalid pose: '+part.id)
    const emissive=part.material.emissive
    if(emissive?.on&&!/^#[0-9a-f]{6}$/i.test(palette[emissive.token]??''))throw Error('Unresolved emissive token')
    const g=geometry(part)
@@ -63,8 +63,8 @@ export function replaceV3Meshes(group:THREE.Group,parts:readonly V3RenderPart[],
    mesh.matrixAutoUpdate=false;mesh.matrix.set(r[0][0],r[0][1],r[0][2],t[0],r[1][0],r[1][1],r[1][2],t[1],r[2][0],r[2][1],r[2][2],t[2],0,0,0,1)
    staged.add(mesh)
   }
- }catch(error){disposeV3Meshes(staged);throw error}
- disposeV3Meshes(group)
+ }catch(error){disposeFigureMeshes(staged);throw error}
+ disposeFigureMeshes(group)
  for(const mesh of [...staged.children])group.add(mesh)
  group.updateMatrixWorld(true)
 }

package/client/modeller/{v3-stage-model.ts → stage-model.ts}

@@ -1,17 +1,17 @@
 import * as THREE from 'three'
-import { buildV3Geometry } from '@hatiolab/things-scene'
+import { buildFigureGeometry } from '@hatiolab/things-scene'
 
-import type { GizmoResult } from './v3-gizmo.js'
-import type { V3RenderPart } from './v3-renderer.js'
+import type { GizmoResult } from './gizmo.js'
+import type { FigureRenderPart } from './renderer.js'
 
 /*
- * V3 bodies <-> scene components, in one place.
+ * bodies <-> scene components, in one place.
  *
  * The modeller stands on a things-scene board in editing mode: each body figure-model evaluates is a
- * `figure-v3-part` component, and what the scene's gizmo writes back comes here to become a change of the part's
+ * `figure-part` component, and what the scene's gizmo writes back comes here to become a change of the part's
  * inputs. The two vocabularies:
  *
- *     V3 (asset frame, mm, y up)            scene component
+ *     (asset frame, mm, y up)            scene component
  *     ────────────────────────────────      ─────────────────────────────────────────────
  *     body box extent  x · y · z             width · depth · height
  *     body box centre  x                     left + width/2  - board width/2
@@ -39,11 +39,11 @@ export interface BodyFrame {
 
 const round = (n: number) => Math.round(n * 1e6) / 1e6
 
-export function frameOf(part: V3RenderPart): BodyFrame | null {
-  /* The box things-scene's `figure-v3-part` centres the body on: the same builder, measured the same way. */
+export function frameOf(part: FigureRenderPart): BodyFrame | null {
+  /* The box things-scene's `figure-part` centres the body on: the same builder, measured the same way. */
   let built: THREE.BufferGeometry | undefined
   try {
-    built = buildV3Geometry(part.shape as never, part.segments) as THREE.BufferGeometry | undefined
+    built = buildFigureGeometry(part.shape as never, part.segments) as THREE.BufferGeometry | undefined
   } catch {
     return null
   }
@@ -58,14 +58,14 @@ export function frameOf(part: V3RenderPart): BodyFrame | null {
 }
 
 /** The colours a body is drawn in, from the palette the modeller resolved (the asset's, over which the theme wins). */
-function colours(part: V3RenderPart, palette: Record<string, string>) {
+function colours(part: FigureRenderPart, palette: Record<string, string>) {
   const m = part.material
   const glow = m.emissive?.on ? { color: palette[m.emissive.token] ?? palette[m.token] ?? '#9a9a9a', intensity: m.emissive.intensity } : undefined
   return { color: palette[m.token] ?? '#9a9a9a', preset: m.preset, transparent: !!m.transparent, ...(glow ? { glow } : {}) }
 }
 
 /** The component state that draws a body where figure-model put it. */
-export function componentOf(part: V3RenderPart, palette: Record<string, string>, board: Board): Record<string, unknown> | null {
+export function componentOf(part: FigureRenderPart, palette: Record<string, string>, board: Board): Record<string, unknown> | null {
   const frame = frameOf(part)
   if (!frame) return null
   const { centre, extent, rotation, origin } = frame
@@ -75,7 +75,7 @@ export function componentOf(part: V3RenderPart, palette: Record<string, string>,
     depth = extent.y || 1,
     height = extent.z || 1
   return {
-    type: 'figure-v3-part',
+    type: 'figure-part',
     name: part.id,
     shape: part.shape,
     ...(part.segments !== undefined ? { segments: part.segments } : {}),
@@ -99,7 +99,7 @@ const num = (v: unknown, fallback = 0) => (typeof v === 'number' && Number.isFin
  * order) and how much each of its own axes grew. Only what changed is given; a component the gizmo did not move gives
  * nothing.
  */
-export function gizmoResultOf(part: V3RenderPart, after: Record<string, unknown>, board: Board): GizmoResult {
+export function gizmoResultOf(part: FigureRenderPart, after: Record<string, unknown>, board: Board): GizmoResult {
   const frame = frameOf(part)
   if (!frame) return {}
   const { centre, extent, rotation, origin } = frame
@@ -130,7 +130,7 @@ export function gizmoResultOf(part: V3RenderPart, after: Record<string, unknown>
  * A drag as amounts, for a part whose place is worked out (`nudge-part`): how far its origin moved and how far each of
  * its angles turned (rigid@1's order, degrees). Nothing on an axis that did not change.
  */
-export function nudgeOf(part: V3RenderPart, result: GizmoResult): { by: Partial<Record<'x' | 'y' | 'z', number>>; turn: Partial<Record<'x' | 'y' | 'z', number>> } {
+export function nudgeOf(part: FigureRenderPart, result: GizmoResult): { by: Partial<Record<'x' | 'y' | 'z', number>>; turn: Partial<Record<'x' | 'y' | 'z', number>> } {
   const axes = ['x', 'y', 'z'] as const
   const by: Partial<Record<'x' | 'y' | 'z', number>> = {}
   const turn: Partial<Record<'x' | 'y' | 'z', number>> = {}
@@ -163,7 +163,7 @@ export function changedKeys(current: Record<string, unknown>, next: Record<strin
 }
 
 /** A board wide and deep enough for the figure, with room around it; its size only grows while a figure is edited. */
-export function boardFor(parts: readonly V3RenderPart[], at: Board & { depth?: number } = { width: 0, height: 0 }): Board & { depth: number } {
+export function boardFor(parts: readonly FigureRenderPart[], at: Board & { depth?: number } = { width: 0, height: 0 }): Board & { depth: number } {
   const box = new THREE.Box3()
   for (const part of parts) {
     const frame = frameOf(part)

package/client/modeller/{v3-thumbnail.ts → thumbnail.ts}

@@ -1,9 +1,9 @@
-import './v3-canvas.js'
+import './canvas.js'
 
-import type { V3RenderPart } from './v3-renderer.js'
+import type { FigureRenderPart } from './renderer.js'
 
 /**
- * 카드에 쓸 그림을 찍는다 — **숨은 자리에 V3 캔버스를 하나 더 세워서.**
+ * 카드에 쓸 그림을 찍는다 — **숨은 자리에 캔버스를 하나 더 세워서.**
  *
  * ## 왜 보이는 캔버스를 찍지 않나
  *
@@ -33,7 +33,7 @@ const HEIGHT = 360
 const PATIENCE = 5000
 
 interface Shooter extends HTMLElement {
-  parts?: V3RenderPart[]
+  parts?: FigureRenderPart[]
   palette?: Record<string, string>
   context?: string
   viewOnly?: boolean
@@ -55,8 +55,8 @@ function within<T>(work: Promise<T>, ms: number): Promise<T | undefined> {
   return Promise.race([work, delay(ms).then(() => undefined)])
 }
 
-export async function captureV3Thumbnail(
-  parts: V3RenderPart[],
+export async function captureFigureThumbnail(
+  parts: FigureRenderPart[],
   palette: Record<string, string>
 ): Promise<string | undefined> {
   if (!parts.length) return undefined
@@ -66,11 +66,11 @@ export async function captureV3Thumbnail(
     WebGL context 는 브라우저가 8~16개에서 끊으므로 찍은 뒤 반드시 버린다(아래 finally).
   */
   const host = document.createElement('div')
-  host.setAttribute('figure-v3-thumbnail-stage', '')
+  host.setAttribute('figure-thumbnail-stage', '')
   host.style.cssText = `position: fixed; left: -10000px; top: 0; width: ${WIDTH}px; height: ${HEIGHT}px; pointer-events: none;`
   document.body.appendChild(host)
 
-  const shooter = document.createElement('figure-v3-canvas') as Shooter
+  const shooter = document.createElement('figure-canvas') as Shooter
   shooter.parts = parts
   shooter.palette = palette
   shooter.context = 'thumbnail'

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

@@ -429,11 +429,11 @@ export class FigureListPage extends FigureListPageBase {
               말이 알려 준다.
 
               색칠한 배지로 두지 않는다. 옛 draw call 한도 3 으로 재던 때는 카탈로그 거의 모두가 0 점이라
-              붉은 덩어리가 카드마다 섰고 아무것도 가르지 못했다. V3 는 「한 화면 N 대」 목표에 견준
-              여유라(`v3ScoreOf`, 2026-09-24) 퍼지지만, 숫자는 조용히 적고 낮은 것에만 **점 하나**를 붙인다.
+              붉은 덩어리가 카드마다 섰고 아무것도 가르지 못했다. 이 모델은 「한 화면 N 대」 목표에 견준
+              여유라(`figureScoreOf`, 2026-09-24) 퍼지지만, 숫자는 조용히 적고 낮은 것에만 **점 하나**를 붙인다.
 
               아직 재지 않은 것을 0 으로 보여 주지 않는다 — 0 은 「가볍다」는 뜻이 되어 버린다.
-              등급 문자(A~D)도 여기서 만들지 않는다: 경계는 `figure-model` 의 `scoreOf` · `v3ScoreOf` 가 정하고,
+              등급 문자(A~D)도 여기서 만들지 않는다: 경계는 `figure-model` 의 `scoreOf` · `figureScoreOf` 가 정하고,
               화면이 그것을 베끼면 두 벌이 되어 목록과 저작면이 다른 등급을 말한다.
             */
             renderer: (value: number | null) =>
@@ -586,7 +586,7 @@ export class FigureListPage extends FigureListPageBase {
     return { total: total || 0, records: items || [] }
   }
 
-  /** The modeller that can edit this figure, by its format; a new figure starts in V3 (`modeller-route.ts`). */
+  /** The modeller that can edit this figure, by its format; a new figure starts in (`modeller-route.ts`). */
   private openModeller(figure?: Figure) {
     navigate(modellerPathOf(figure))
   }

package/client/pages/{figure-v3-modeller-page.ts → figure-modeller-page.ts}

@@ -3,41 +3,41 @@ import { customElement, state } from 'lit/decorators.js'
 import { navigate, PageView } from '@operato/shell'
 import { getPathInfo } from '@operato/utils'
 import { modellerPathOf } from '../modeller/modeller-route.js'
-import { createV3ProductSession } from '../modeller/v3-product-session.js'
-import { v3ProductStore } from '../graphql/v3-store.js'
+import { createFigureProductSession } from '../modeller/product-session.js'
+import { figureProductStore } from '../graphql/store.js'
 import { i18next } from '@operato/i18n'
 import { fetchFigure, fetchFigureTypeNames, updateFigure } from '../graphql/index.js'
-import { availableRecipes, recipeGuide } from '../modeller/v3-recipe-source.js'
-import type { RecipeTemplate } from '../modeller/v3-recipes.js'
-import { occupancyFromParts } from '../modeller/v3-occupancy.js'
-import type { V3AuthoringAction } from '@hatiolab/figure-model'
-import '../modeller/v3-editor.js'
+import { availableRecipes, recipeGuide } from '../modeller/recipe-source.js'
+import type { RecipeTemplate } from '../modeller/recipes.js'
+import { occupancyFromParts } from '../modeller/occupancy.js'
+import type { FigureAuthoringAction } from '@hatiolab/figure-model'
+import '../modeller/editor.js'
 import '@material/web/icon/icon.js'
 import '../modeller/figure-history-panel.js'
-import '../modeller/figure-v3-verdict.js'
-import '../modeller/figure-v3-properties.js'
-import type { V3BudgetLine } from '../modeller/v3-maturity.js'
+import '../modeller/figure-verdict.js'
+import '../modeller/figure-properties.js'
+import type { FigureBudgetLine } from '../modeller/maturity.js'
 import { OxPrompt } from '@operato/popup'
 import { openPopup } from '@operato/layout'
-import '../modeller/figure-v3-first-save.js'
+import '../modeller/figure-first-save.js'
 import { activePalette } from '@hatiolab/things-scene'
 import {
   clearAssistantSurface,
   notifyAssistantSurface,
   provideAssistantSurface
 } from '@things-factory/ai-assistant/dist-client/index.js'
-import type { FirstSave } from '../modeller/v3-first-save.js'
-import { placementRefusalOf } from '../modeller/v3-refusals.js'
-import { takePendingNewFigure } from '../modeller/v3-ai-proposal.js'
+import type { FirstSave } from '../modeller/first-save.js'
+import { placementRefusalOf } from '../modeller/refusals.js'
+import { takePendingNewFigure } from '../modeller/ai-proposal.js'
 
 /**
- * The V3 product page has exactly one authoritative workspace for UI and AI input transactions.
+ * The product page has exactly one authoritative workspace for UI and AI input transactions.
  *
- * The one modeller since ADR-0087 step 5 (2026-09-24): it answers to `figure-modeller`, and to `figure-v3-modeller`
+ * The one modeller since ADR-0087 step 5 (2026-09-24): it answers to `figure-modeller`, and to `figure-modeller`
  * as an alias for links made before the switch.
  */
-@customElement('figure-v3-modeller-page')
-export class FigureV3ModellerPage extends PageView {
+@customElement('figure-modeller-page')
+export class FigureModellerPage extends PageView {
   static styles = css`
     :host {
       display: flex;
@@ -50,7 +50,7 @@ export class FigureV3ModellerPage extends PageView {
       */
       overflow: hidden;
     }
-    figure-v3-editor {
+    figure-editor {
       flex: 1;
       min-width: 0;
       min-height: 0;
@@ -92,7 +92,7 @@ export class FigureV3ModellerPage extends PageView {
       color: var(--md-sys-color-error);
     }
   `
-  private readonly session = createV3ProductSession(v3ProductStore)
+  private readonly session = createFigureProductSession(figureProductStore)
   private routeId: string | undefined
   private discardApproved = false
   @state() private revision = 0
@@ -107,7 +107,7 @@ export class FigureV3ModellerPage extends PageView {
    * 발행 패널이 읽는 행의 사실 — 상태와 발행 판 번호. 원본은 세션이 들고, 이 둘은 행에 있다.
    *
    * 이 화면에는 발행 패널이 없었다. 저장은 되고 발행 · 판본 · 복원 · 판정을 볼 자리가 없어서, ADR-0087 5단계에서
-   * `figure-modeller` 가 이 화면으로 바뀌면 저작자는 발행을 할 수 없었다. 새 V3 도형은 공간을 선언하기 전에는 전부
+   * `figure-modeller` 가 이 화면으로 바뀌면 저작자는 발행을 할 수 없었다. 새 도형은 공간을 선언하기 전에는 전부
    * 발행 판정에 막히는데 그 선언을 할 단추도 없었다(2026-09-24 확인). 그래서 발행 패널을 건다.
    */
   @state() private row: { state?: 'draft' | 'released'; version: number; type?: string; category?: string; tags?: string[] } = {
@@ -118,7 +118,7 @@ export class FigureV3ModellerPage extends PageView {
   @state() private commandError = ''
   /** The verdict's count, handed to the editor's verdict tab. */
   @state() private instances?: number
-  @state() private budget?: V3BudgetLine
+  @state() private budget?: FigureBudgetLine
   /**
    * The source the verdict judges. The session refuses to export while it loads or saves, so the last one read is
    * kept rather than blanked — the verdict would otherwise flicker to 「waiting」 on every save.
@@ -219,8 +219,8 @@ export class FigureV3ModellerPage extends PageView {
   /**
    * 타입을 정한다 — 보드가 도형을 부르는 이름이고, 발행하면 굳는다(ADR-0063 결정 4).
    *
-   * 새 V3 도형은 저장할 때 임시 타입을 받는데, 이 화면에는 그것을 바꿀 칸이 없어서 임시 타입 그대로 발행됐다.
-   * 행만 바뀐다 — V3 자산은 타입을 원본에 적지 않으므로(적으면 형식이 거절한다) 편집 중인 원본과 부딪히지 않는다.
+   * 새 도형은 저장할 때 임시 타입을 받는데, 이 화면에는 그것을 바꿀 칸이 없어서 임시 타입 그대로 발행됐다.
+   * 행만 바뀐다 — 자산은 타입을 원본에 적지 않으므로(적으면 형식이 거절한다) 편집 중인 원본과 부딪히지 않는다.
    * 서버의 거절(이미 쓰는 타입 · 발행 뒤)은 그 문장 그대로 칸 아래에 둔다.
    */
   private renameType = async (event: Event) => {
@@ -253,14 +253,14 @@ export class FigureV3ModellerPage extends PageView {
   }
   /** A command from the properties tab — rename, declare the room, the mounting face. */
   private onCommand = (event: Event) => {
-    const action = (event as CustomEvent).detail?.action as V3AuthoringAction | undefined
+    const action = (event as CustomEvent).detail?.action as FigureAuthoringAction | undefined
     if (action) this.runCommand(() => action)
   }
   /**
    * One step of the session's history, whichever part of the side asked for it — so undo takes it back like any
    * other edit, and it is saved with the figure.
    */
-  private runCommand(actionOf: () => V3AuthoringAction) {
+  private runCommand(actionOf: () => FigureAuthoringAction) {
     try {
       this.session.command(actionOf())
       this.commandError = ''
@@ -348,12 +348,12 @@ export class FigureV3ModellerPage extends PageView {
   }
   connectedCallback() {
     super.connectedCallback()
-    window.addEventListener('figure-v3-apply', this.applyAI)
+    window.addEventListener('figure-apply', this.applyAI)
     window.addEventListener('beforeunload', this.holdUnsaved)
   }
   disconnectedCallback() {
     this.withdrawAssistant()
-    window.removeEventListener('figure-v3-apply', this.applyAI)
+    window.removeEventListener('figure-apply', this.applyAI)
     window.removeEventListener('beforeunload', this.holdUnsaved)
     super.disconnectedCallback()
   }
@@ -429,7 +429,7 @@ export class FigureV3ModellerPage extends PageView {
   /** The first save's question, over the names this domain already uses. */
   private askFirstSave = async (name: string): Promise<FirstSave | undefined> => {
     const taken = await fetchFigureTypeNames().catch(() => [] as string[])
-    return openPopup<FirstSave>(html`<figure-v3-first-save .type=${this.row.type ?? ''} .name=${name} .taken=${taken}></figure-v3-first-save>`, {
+    return openPopup<FirstSave>(html`<figure-first-save .type=${this.row.type ?? ''} .name=${name} .taken=${taken}></figure-first-save>`, {
       backdrop: true,
       size: 'small',
       title: i18next.t('figure.title.save-new-figure')
@@ -450,16 +450,16 @@ export class FigureV3ModellerPage extends PageView {
   render() {
     if (this.error) return html`<p role="alert" class="error">${this.error}</p>`
     const view = this.session.read()
-    return html`<figure-v3-editor .session=${this.session} .templates=${this.templates} .guideOf=${this.guideOf} .thumbnailOf=${this.thumbnailOf} .firstSave=${this.askFirstSave} .revision=${this.revision} .instances=${this.instances} .budget=${this.budget} @v3-changed=${this.changed}>
+    return html`<figure-editor .session=${this.session} .templates=${this.templates} .guideOf=${this.guideOf} .thumbnailOf=${this.thumbnailOf} .firstSave=${this.askFirstSave} .revision=${this.revision} .instances=${this.instances} .budget=${this.budget} @changed=${this.changed}>
       ${this.commandError ? html`<p slot="notice" fit-error role="alert">${this.commandError}</p>` : ''}
-      <figure-v3-properties
+      <figure-properties
         slot="figure"
         .source=${this.draftSource()}
         .figureId=${view.id}
         .figureCategory=${this.row.category}
         .figureTags=${this.row.tags}
-        @v3-command=${this.onCommand}
-        @v3-catalog=${this.onCatalog}
+        @command=${this.onCommand}
+        @catalog=${this.onCatalog}
       >
         <label slot="type" type-field>
             <span>${i18next.t('figure.label.figure-type')}</span>
@@ -472,8 +472,8 @@ export class FigureV3ModellerPage extends PageView {
                 />`}
             ${this.typeError ? html`<small role="alert">${this.typeError}</small>` : ''}
           </label>
-      </figure-v3-properties>
-      <figure-v3-verdict
+      </figure-properties>
+      <figure-verdict
         slot="verdict"
         .source=${this.draftSource()}
         .figureId=${view.id}
@@ -483,7 +483,7 @@ export class FigureV3ModellerPage extends PageView {
           this.budget = event.detail.budget
         }}
         @fit-base-to-parts=${this.fitToParts}
-      ></figure-v3-verdict>
+      ></figure-verdict>
       <figure-history-panel
         slot="history"
         .figureId=${view.id}
@@ -495,7 +495,7 @@ export class FigureV3ModellerPage extends PageView {
         @figure-released=${this.released}
         @figure-reverted=${this.reverted}
       ></figure-history-panel>
-    </figure-v3-editor>`
+    </figure-editor>`
   }
 
 }

package/client/route.ts

@@ -4,12 +4,8 @@ export default function route(page: string) {
       import('./pages/figure-list-page')
       return page
 
-    /*
-      One modeller since ADR-0087 step 5. `figure-v3-modeller` is kept as an alias for links made before the switch.
-    */
     case 'figure-modeller':
-    case 'figure-v3-modeller':
-      import('./pages/figure-v3-modeller-page')
+      import('./pages/figure-modeller-page')
       return page
   }
 }

package/dist-client/figure-assistant.js

@@ -4,18 +4,18 @@
  *
  * A proposal is a list of the modeller's own commands (ADR-0094). Running it applies them in the modeller as one step
  * of its history: a revision on the figure open there, at the version the model saw; a new figure on a new figure the
- * modeller opens. The outcome is said in words on every branch (`v3-ai-proposal.ts`).
+ * modeller opens. The outcome is said in words on every branch (`ai-proposal.ts`).
  */
 import { i18next } from '@operato/i18n';
 import { navigate } from '@operato/shell';
 import { registerProposalHandler } from '@things-factory/ai-assistant/dist-client/index.js';
 import { modellerPathOf } from './modeller/modeller-route.js';
-import { pendNewFigure, runFigureProposal } from './modeller/v3-ai-proposal.js';
+import { pendNewFigure, runFigureProposal } from './modeller/ai-proposal.js';
 export const FIGURE_CANDIDATE_TOOL = 'proposeFigureCandidate';
 registerProposalHandler(FIGURE_CANDIDATE_TOOL, async (proposal, context) => {
     const outcome = await runFigureProposal(proposal, {
         offer(detail) {
-            window.dispatchEvent(new CustomEvent('figure-v3-apply', { detail }));
+            window.dispatchEvent(new CustomEvent('figure-apply', { detail }));
             return detail;
         },
         openNew(steps) {

package/dist-client/figure-assistant.js.map

@@ -1 +1 @@
-{"version":3,"file":"figure-assistant.js","sourceRoot":"","sources":["../client/figure-assistant.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AACzC,OAAO,EAAE,uBAAuB,EAAE,MAAM,mDAAmD,CAAA;AAE3F,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAA;AAC7D,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAA0B,MAAM,8BAA8B,CAAA;AAEvG,MAAM,CAAC,MAAM,qBAAqB,GAAG,wBAAwB,CAAA;AAE7D,uBAAuB,CAAC,qBAAqB,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE;IACzE,MAAM,OAAO,GAAG,MAAM,iBAAiB,CACrC,QAAQ,EACR;QACE,KAAK,CAAC,MAAyB;YAC7B,MAAM,CAAC,aAAa,CAAC,IAAI,WAAW,CAAC,iBAAiB,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,CAAA;YACpE,OAAO,MAAM,CAAA;QACf,CAAC;QACD,OAAO,CAAC,KAAK;YACX,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,CAAC,CAAA;YACnC,QAAQ,CAAC,cAAc,EAAE,CAAC,CAAA;YAC1B,OAAO,MAAM,CAAA;QACf,CAAC;KACF,EACD,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,MAAM,CAAC,CACxC,CAAA;IACD,IAAI,OAAO,CAAC,IAAI;QAAE,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,KAAK,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;IACjG,OAAO,OAAO,CAAA;AAChB,CAAC,CAAC,CAAA","sourcesContent":["/*\n * What the AI dock does with a figure proposal - figure-ui declares it because figure-service declares the tool\n * (`proposeFigureCandidate`, design/ai/shared-dock.md §4).\n *\n * A proposal is a list of the modeller's own commands (ADR-0094). Running it applies them in the modeller as one step\n * of its history: a revision on the figure open there, at the version the model saw; a new figure on a new figure the\n * modeller opens. The outcome is said in words on every branch (`v3-ai-proposal.ts`).\n */\nimport { i18next } from '@operato/i18n'\nimport { navigate } from '@operato/shell'\nimport { registerProposalHandler } from '@things-factory/ai-assistant/dist-client/index.js'\n\nimport { modellerPathOf } from './modeller/modeller-route.js'\nimport { pendNewFigure, runFigureProposal, type FigureApplyDetail } from './modeller/v3-ai-proposal.js'\n\nexport const FIGURE_CANDIDATE_TOOL = 'proposeFigureCandidate'\n\nregisterProposalHandler(FIGURE_CANDIDATE_TOOL, async (proposal, context) => {\n  const outcome = await runFigureProposal(\n    proposal,\n    {\n      offer(detail: FigureApplyDetail) {\n        window.dispatchEvent(new CustomEvent('figure-v3-apply', { detail }))\n        return detail\n      },\n      openNew(steps) {\n        const opened = pendNewFigure(steps)\n        navigate(modellerPathOf())\n        return opened\n      }\n    },\n    (key, params) => i18next.t(key, params)\n  )\n  if (outcome.note) context.notify(outcome.verdict === 'accepted' ? 'info' : 'error', outcome.note)\n  return outcome\n})\n"]}
+{"version":3,"file":"figure-assistant.js","sourceRoot":"","sources":["../client/figure-assistant.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AACzC,OAAO,EAAE,uBAAuB,EAAE,MAAM,mDAAmD,CAAA;AAE3F,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAA;AAC7D,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAA0B,MAAM,2BAA2B,CAAA;AAEpG,MAAM,CAAC,MAAM,qBAAqB,GAAG,wBAAwB,CAAA;AAE7D,uBAAuB,CAAC,qBAAqB,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE;IACzE,MAAM,OAAO,GAAG,MAAM,iBAAiB,CACrC,QAAQ,EACR;QACE,KAAK,CAAC,MAAyB;YAC7B,MAAM,CAAC,aAAa,CAAC,IAAI,WAAW,CAAC,cAAc,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,CAAA;YACjE,OAAO,MAAM,CAAA;QACf,CAAC;QACD,OAAO,CAAC,KAAK;YACX,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,CAAC,CAAA;YACnC,QAAQ,CAAC,cAAc,EAAE,CAAC,CAAA;YAC1B,OAAO,MAAM,CAAA;QACf,CAAC;KACF,EACD,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,MAAM,CAAC,CACxC,CAAA;IACD,IAAI,OAAO,CAAC,IAAI;QAAE,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,KAAK,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;IACjG,OAAO,OAAO,CAAA;AAChB,CAAC,CAAC,CAAA","sourcesContent":["/*\n * What the AI dock does with a figure proposal - figure-ui declares it because figure-service declares the tool\n * (`proposeFigureCandidate`, design/ai/shared-dock.md §4).\n *\n * A proposal is a list of the modeller's own commands (ADR-0094). Running it applies them in the modeller as one step\n * of its history: a revision on the figure open there, at the version the model saw; a new figure on a new figure the\n * modeller opens. The outcome is said in words on every branch (`ai-proposal.ts`).\n */\nimport { i18next } from '@operato/i18n'\nimport { navigate } from '@operato/shell'\nimport { registerProposalHandler } from '@things-factory/ai-assistant/dist-client/index.js'\n\nimport { modellerPathOf } from './modeller/modeller-route.js'\nimport { pendNewFigure, runFigureProposal, type FigureApplyDetail } from './modeller/ai-proposal.js'\n\nexport const FIGURE_CANDIDATE_TOOL = 'proposeFigureCandidate'\n\nregisterProposalHandler(FIGURE_CANDIDATE_TOOL, async (proposal, context) => {\n  const outcome = await runFigureProposal(\n    proposal,\n    {\n      offer(detail: FigureApplyDetail) {\n        window.dispatchEvent(new CustomEvent('figure-apply', { detail }))\n        return detail\n      },\n      openNew(steps) {\n        const opened = pendNewFigure(steps)\n        navigate(modellerPathOf())\n        return opened\n      }\n    },\n    (key, params) => i18next.t(key, params)\n  )\n  if (outcome.note) context.notify(outcome.verdict === 'accepted' ? 'info' : 'error', outcome.note)\n  return outcome\n})\n"]}

package/dist-client/graphql/store.d.ts

@@ -0,0 +1,3 @@
+import type { FigureProductStore } from '../modeller/product-session.js';
+/** source is sent intact. No conversion into the old parts/base authoring representation. */
+export declare const figureProductStore: FigureProductStore;

package/dist-client/graphql/store.js

@@ -0,0 +1,39 @@
+import gql from 'graphql-tag';
+import { client } from '@operato/graphql';
+import { fetchFigure } from './index.js';
+/** source is sent intact. No conversion into the old parts/base authoring representation. */
+export const figureProductStore = {
+    async load(id) {
+        const record = await fetchFigure(id);
+        if (!record?.source)
+            throw Error('Figure 정본이 없습니다.');
+        return { id: record.id, source: record.source };
+    },
+    async save(request) {
+        const response = await client.mutate({
+            mutation: gql `
+        mutation SaveFigure($source: String!, $id: String, $expectedSource: String, $creationId: String, $thumbnail: String, $type: String) {
+          saveFigure(
+            source: $source
+            id: $id
+            expectedSource: $expectedSource
+            creationId: $creationId
+            thumbnail: $thumbnail
+            type: $type
+          ) {
+            id
+            source
+          }
+        }
+      `,
+            variables: request
+        });
+        if (response.errors?.length)
+            throw Error(response.errors.map(e => e.message).join('\n'));
+        const result = response.data?.saveFigure;
+        if (!result?.id || !result.source)
+            throw Error('서버가 저장 결과를 돌려주지 않았습니다.');
+        return result;
+    }
+};
+//# sourceMappingURL=store.js.map

package/dist-client/graphql/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../client/graphql/store.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,aAAa,CAAA;AAC7B,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAGxC,6FAA6F;AAC7F,MAAM,CAAC,MAAM,kBAAkB,GAAuB;IACpD,KAAK,CAAC,IAAI,CAAC,EAAE;QACX,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,EAAE,CAAC,CAAA;QACpC,IAAI,CAAC,MAAM,EAAE,MAAM;YAAE,MAAM,KAAK,CAAC,kBAAkB,CAAC,CAAA;QACpD,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAA;IACjD,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,OAAO;QAChB,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC;YACnC,QAAQ,EAAE,GAAG,CAAA;;;;;;;;;;;;;;OAcZ;YACD,SAAS,EAAE,OAAO;SACnB,CAAC,CAAA;QACF,IAAI,QAAQ,CAAC,MAAM,EAAE,MAAM;YAAE,MAAM,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;QACxF,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,EAAE,UAA6C,CAAA;QAC3E,IAAI,CAAC,MAAM,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM;YAAE,MAAM,KAAK,CAAC,wBAAwB,CAAC,CAAA;QACxE,OAAO,MAAM,CAAA;IACf,CAAC;CACF,CAAA","sourcesContent":["import gql from 'graphql-tag'\nimport { client } from '@operato/graphql'\nimport { fetchFigure } from './index.js'\nimport type { FigureProductStore, FigureProductRecord } from '../modeller/product-session.js'\n\n/** source is sent intact. No conversion into the old parts/base authoring representation. */\nexport const figureProductStore: FigureProductStore = {\n  async load(id) {\n    const record = await fetchFigure(id)\n    if (!record?.source) throw Error('Figure 정본이 없습니다.')\n    return { id: record.id, source: record.source }\n  },\n  async save(request) {\n    const response = await client.mutate({\n      mutation: gql`\n        mutation SaveFigure($source: String!, $id: String, $expectedSource: String, $creationId: String, $thumbnail: String, $type: String) {\n          saveFigure(\n            source: $source\n            id: $id\n            expectedSource: $expectedSource\n            creationId: $creationId\n            thumbnail: $thumbnail\n            type: $type\n          ) {\n            id\n            source\n          }\n        }\n      `,\n      variables: request\n    })\n    if (response.errors?.length) throw Error(response.errors.map(e => e.message).join('\\n'))\n    const result = response.data?.saveFigure as FigureProductRecord | undefined\n    if (!result?.id || !result.source) throw Error('서버가 저장 결과를 돌려주지 않았습니다.')\n    return result\n  }\n}\n"]}

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

@@ -0,0 +1,51 @@
+import type { FigureProposalStep } from '@hatiolab/figure-model';
+/** What the card carries, as `proposeFigureCandidate` returned it. */
+export interface FigureProposalCard {
+    steps?: FigureProposalStep[];
+    create?: boolean;
+    figureId?: string;
+    context?: string;
+    revision?: number;
+}
+/** The `figure-apply` event's detail. The page that takes it sets `applied`, and `error` when refused. */
+export interface FigureApplyDetail {
+    steps: FigureProposalStep[];
+    create: boolean;
+    context?: string;
+    revision?: number;
+    applied?: boolean;
+    error?: string;
+    code?: string;
+}
+export type Say = (key: string, params?: Record<string, string>) => string;
+export interface FigureProposalTarget {
+    /** Offers the proposal to a modeller on screen. It comes back untouched when none took it. */
+    offer(detail: FigureApplyDetail): FigureApplyDetail;
+    /** Opens a new figure in the modeller and applies the steps there; resolves once the page has, or has not. */
+    openNew(steps: FigureProposalStep[]): Promise<{
+        applied: boolean;
+        error?: string;
+        code?: string;
+    }>;
+}
+export interface FigureProposalOutcome {
+    verdict: 'accepted' | 'refused' | 'unavailable';
+    errorCode?: string;
+    applied?: number;
+    note?: string;
+}
+export declare function runFigureProposal(card: FigureProposalCard, target: FigureProposalTarget, say: Say): Promise<FigureProposalOutcome>;
+export declare function pendNewFigure(steps: FigureProposalStep[], ms?: number): Promise<{
+    applied: boolean;
+    error?: string;
+    code?: string;
+}>;
+/** For the page, on a new figure it has just started: the steps waiting for it, and where to say how it went. */
+export declare function takePendingNewFigure(): {
+    steps: FigureProposalStep[];
+    settle: (result: {
+        applied: boolean;
+        error?: string;
+        code?: string;
+    }) => void;
+} | undefined;