@things-factory/figure-ui 10.1.64 → 10.1.66

package/client/figure-assistant.ts

@@ -1,20 +1,36 @@
 /*
- * What the AI dock does with a figure candidate - figure-ui declares it because figure-service declares the tool
+ * What the AI dock does with a figure proposal - figure-ui declares it because figure-service declares the tool
  * (`proposeFigureCandidate`, design/ai/shared-dock.md §4).
  *
- * Today a candidate cannot be taken anywhere. The proposer writes V2 figures and the modeller opens V3 only; the V2
- * modeller that reviewed candidates was removed with its listeners (`figure-ai-review`, `figure-ai-stage`), and the
- * server already refuses to propose for a V3 figure (`V3_PROPOSAL_UNAVAILABLE`). So the outcome is `unavailable`,
- * said to the person in words, not a silent pass - until a proposer writes V3 changes, which the modeller takes
- * through `figure-v3-apply`.
+ * 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`).
  */
 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, type FigureApplyDetail } from './modeller/v3-ai-proposal.js'
+
 export const FIGURE_CANDIDATE_TOOL = 'proposeFigureCandidate'
 
-registerProposalHandler(FIGURE_CANDIDATE_TOOL, async (_proposal, context) => {
-  const note = i18next.t('figure.text.candidate-cannot-open')
-  context.notify('info', note)
-  return { verdict: 'unavailable', errorCode: 'v3-review-missing', note }
+registerProposalHandler(FIGURE_CANDIDATE_TOOL, async (proposal, context) => {
+  const outcome = await runFigureProposal(
+    proposal,
+    {
+      offer(detail: FigureApplyDetail) {
+        window.dispatchEvent(new CustomEvent('figure-v3-apply', { detail }))
+        return detail
+      },
+      openNew(steps) {
+        const opened = pendNewFigure(steps)
+        navigate(modellerPathOf())
+        return opened
+      }
+    },
+    (key, params) => i18next.t(key, params)
+  )
+  if (outcome.note) context.notify(outcome.verdict === 'accepted' ? 'info' : 'error', outcome.note)
+  return outcome
 })

package/client/graphql/index.ts

@@ -8,8 +8,6 @@ import type {
   FigureInspection,
   FigureListResult,
   FigurePatch,
-  FigureProposal,
-  ProposalFeedback,
   FigureVersion,
   NewFigure
 } from '../types.js'
@@ -187,62 +185,6 @@ export async function deleteFigure(id: string): Promise<boolean> {
   return unwrap<boolean>(response, 'deleteFigure')
 }
 
-/**
- * 저작 보조에게 후보를 시킨다.
- *
- * 팔레트를 **클라이언트가 보낸다.** 서버는 팔레트를 모른다 — things-scene 이 갖고
- * 있는데 그 패키지의 node 조건은 팔레트가 없는 번들로 간다. 그리는 쪽이 어떤 토큰을
- * 풀 수 있는지 아는 유일한 자리이므로 그쪽이 보낸다.
- *
- * 돌아오는 것은 **후보**다. 저장되지 않았다 — 저작자가 받아야 정본이 된다.
- */
-export async function proposeFigure(request: {
-  prompt: string
-  base?: string
-  type?: string
-  palette: string[]
-  refine?: boolean
-  feedback?: ProposalFeedback[]
-  image?: File
-}): Promise<FigureProposal> {
-  const response = await client.mutate({
-    mutation: gql`
-      mutation ProposeFigure($request: ProposeRequest!) {
-        proposeFigure(request: $request) {
-          source
-          score
-          grade
-          triangles
-          groups
-          quality {
-            status
-            summary
-            findings {
-              dimension
-              code
-              message
-            }
-            visualRegions
-            visualCoverage
-            visualReadability
-          }
-          attempts
-          violations {
-            code
-            message
-          }
-        }
-      }
-    `,
-    variables: { request },
-    // @operato/graphql 는 이 신호가 있을 때만 Upload가 포함된 변수를 multipart로 인코딩한다.
-    // 없으면 브라우저 File은 JSON에서 {}가 되어 서버 Upload scalar가 요청 자체를 거절한다.
-    context: { hasUpload: !!request.image }
-  })
-
-  return unwrap<FigureProposal>(response, 'proposeFigure')
-}
-
 /**
  * 발행한다 — 판 번호가 오르고, 그 순간이 판본으로 남는다.
  *

package/client/modeller/v3-ai-proposal.ts

@@ -0,0 +1,111 @@
+/*
+ * An AI proposal reaching the modeller (ADR-0094). The dock's card carries the modeller's own commands; running it
+ * applies them as one step of the modeller's history, undone whole, on the version the model saw. Nothing half made
+ * is applied, and every outcome is said: applied, refused with the reason, or not possible here.
+ *
+ * Kept free of Lit, i18n and the shell so node tests read it directly; the handler and the page pass in what they own.
+ */
+import type { V3ProposalStep } from '@hatiolab/figure-model'
+
+/** What the card carries, as `proposeFigureCandidate` returned it. */
+export interface FigureProposalCard {
+  steps?: V3ProposalStep[]
+  create?: boolean
+  figureId?: string
+  context?: string
+  revision?: number
+}
+
+/** The `figure-v3-apply` event's detail. The page that takes it sets `applied`, and `error` when refused. */
+export interface FigureApplyDetail {
+  steps: V3ProposalStep[]
+  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: V3ProposalStep[]): Promise<{ applied: boolean; error?: string; code?: string }>
+}
+
+export interface FigureProposalOutcome {
+  verdict: 'accepted' | 'refused' | 'unavailable'
+  errorCode?: string
+  applied?: number
+  note?: string
+}
+
+/** The workspace refuses a request made on another version; said as what happened, not as the kernel's code. */
+const STALE = new Set(['REVISION_CONFLICT', 'CONTEXT_CONFLICT'])
+
+function refused(code: string | undefined, error: string | undefined, say: Say): FigureProposalOutcome {
+  const note =
+    code && STALE.has(code)
+      ? say('figure.text.proposal-stale')
+      : code === 'NEW_FIGURE_UNSAVED'
+        ? (error ?? '')
+        : say('figure.text.proposal-refused', { reason: error ?? '' })
+  return { verdict: 'refused', errorCode: code ?? 'refused', note }
+}
+
+export async function runFigureProposal(card: FigureProposalCard, target: FigureProposalTarget, say: Say): Promise<FigureProposalOutcome> {
+  const steps = card?.steps
+  if (!Array.isArray(steps) || !steps.length) return { verdict: 'unavailable', errorCode: 'no-steps' }
+  const create = card.create === true
+  const accepted = (): FigureProposalOutcome => ({
+    verdict: 'accepted',
+    applied: steps.length,
+    note: say('figure.text.proposal-applied', { n: String(steps.length) })
+  })
+
+  const detail = target.offer({ steps, create, context: card.context, revision: card.revision })
+  if (detail.applied) return accepted()
+  if (detail.applied === false) return refused(detail.code, detail.error, say)
+
+  /* A revision belongs to the figure the model saw; with that modeller gone there is nowhere true to apply it. */
+  if (!create) return { verdict: 'unavailable', errorCode: 'modeller-not-open', note: say('figure.text.proposal-needs-modeller') }
+
+  const opened = await target.openNew(steps)
+  if (opened.applied) return accepted()
+  return opened.code === 'not-opened'
+    ? { verdict: 'unavailable', errorCode: 'not-opened', note: say('figure.text.proposal-not-opened') }
+    : refused(opened.code, opened.error, say)
+}
+
+/*
+  A new figure's proposal handed to the modeller page across a navigation: the handler leaves it here and opens the
+  modeller on a new figure; the page takes it once it has started that figure. Left untaken, it lapses -- a later new
+  figure must not receive steps nobody is waiting for.
+*/
+let pending: { steps: V3ProposalStep[]; settle: (result: { applied: boolean; error?: string; code?: string }) => void } | undefined
+
+export function pendNewFigure(steps: V3ProposalStep[], ms = 10_000): Promise<{ applied: boolean; error?: string; code?: string }> {
+  pending?.settle({ applied: false, code: 'not-opened' })
+  return new Promise(resolve => {
+    const mine = {
+      steps,
+      settle: (result: { applied: boolean; error?: string; code?: string }) => {
+        clearTimeout(timer)
+        if (pending === mine) pending = undefined
+        resolve(result)
+      }
+    }
+    const timer = setTimeout(() => mine.settle({ applied: false, code: 'not-opened' }), ms)
+    pending = mine
+  })
+}
+
+/** For the page, on a new figure it has just started: the steps waiting for it, and where to say how it went. */
+export function takePendingNewFigure(): { steps: V3ProposalStep[]; settle: (result: { applied: boolean; error?: string; code?: string }) => void } | undefined {
+  const taken = pending
+  pending = undefined
+  return taken
+}

package/client/modeller/v3-editor.ts

@@ -29,7 +29,7 @@ import type { V3PaletteKind, V3PartRow } from './figure-v3-parts.js'
 import { paletteRecipe } from './v3-palette.js'
 import type { FigureV3Canvas } from './v3-canvas.js'
 import { nudgeOf } from './v3-stage-model.js'
-import { inDeclaredRoom, narrowingRetryOf, partRefusalOf, placementRefusalOf, sizeRangeRefusalOf } from './v3-refusals.js'
+import { inDeclaredRoom, inputRangeRefusalOf, narrowingRetryOf, partRefusalOf, placementRefusalOf, sizeRangeRefusalOf } from './v3-refusals.js'
 import type { V3RenderPart } from './v3-renderer.js'
 import type { V3BudgetLine } from './v3-maturity.js'
 import { instanceRangeOf, instanceRangeToDeclare, proportionToFollow, rangeDiffers, rangeWith, turnsAboutAJoint, valueNow } from './v3-links.js'
@@ -324,7 +324,8 @@ export class FigureV3Editor extends LitElement {
       this.error = ''
       this.changed()
     } catch (error) {
-      this.error = sizeRangeRefusalOf(error, (key, params) => i18next.t(key, params)) ?? (error instanceof Error ? error.message : String(error))
+      const say = (key: string, params: Record<string, string>) => i18next.t(key, params)
+      this.error = sizeRangeRefusalOf(error, say) ?? inputRangeRefusalOf(error, say) ?? (error instanceof Error ? error.message : String(error))
     } finally {
       /* Committed or refused, the value in hand is gone: the figure as it stands is drawn again. */
       this.live = NOTHING_LIVE

package/client/modeller/v3-product-session.ts

@@ -6,7 +6,8 @@ import {
   type V3InputChange,
   type V3PrimitiveCreation,
   type V3PartEdit,
-  type V3AuthoringAction
+  type V3AuthoringAction,
+  type V3ProposalStep
 } from '@hatiolab/figure-model'
 
 export interface V3ProductRecord {
@@ -111,6 +112,14 @@ export function createV3ProductSession(store: V3ProductStore) {
         changes
       })
     },
+    /**
+     * An AI proposal (ADR-0094): the modeller's commands, as one step of the history, on the version the model saw.
+     * Never on the current one instead -- a person's edit in between makes the proposal stale, and it is refused.
+     */
+    applyProposal(steps: readonly V3ProposalStep[], expectedRevision: number, context: string) {
+      writable()
+      return workspace.applyProposal({ origin: 'ai', context, expectedRevision, steps })
+    },
     add(part: V3PrimitiveCreation) {
       return workspace.addPrimitive({ ...writable(), part })
     },

package/client/modeller/v3-refusals.ts

@@ -74,3 +74,20 @@ export function partRefusalOf(error: unknown, part: string, say: Say): string |
   if (follows) return say('figure.text.part-is-followed', { part, others: follows[1]! })
   return say('figure.text.part-is-referenced', { part })
 }
+
+/**
+ * A value outside the range its input declares, with the range and the value given -- the kernel says
+ * 「size.x: 6021100 outside [300,1200]」. The figure's own size is named by its axis; any other input by its range only.
+ * The repeat pitch's refusal shares the code and has its own words (`figure.text.repeat-pitch-too-small`).
+ */
+export function inputRangeRefusalOf(error: unknown, say: Say): string | null {
+  if ((error as { code?: string })?.code !== 'INPUT_RANGE') return null
+  const message = error instanceof Error ? error.message : String(error)
+  const found = /([\w.-]+): (-?[\d.e+]+) outside \[(-?[\d.e+]+),\s*(-?[\d.e+]+)\]/.exec(message)
+  if (!found) return null
+  const [, input, value, min, max] = found
+  const number = (text: string) => Number(text).toLocaleString(undefined, { maximumFractionDigits: 3 })
+  const axis = /^size\.([xyz])$/.exec(input!)?.[1]
+  const params = { value: number(value!), min: number(min!), max: number(max!) }
+  return axis ? say('figure.text.input-range-size', { ...params, axis: axis.toUpperCase() }) : say('figure.text.input-range', params)
+}

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

@@ -25,6 +25,7 @@ import {
 } 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'
 
 /**
  * The V3 product page has exactly one authoritative workspace for UI and AI input transactions.
@@ -158,6 +159,9 @@ export class FigureV3ModellerPage extends PageView {
         editorMode: 'existing',
         figureId: id,
         draftSource: JSON.parse(this.session.source()),
+        /* The version the model sees; a proposal is applied on it, or refused if the figure moved on (ADR-0094). */
+        context: this.session.read().context,
+        revision: this.session.read().revision,
         palette: Object.keys(activePalette())
       })
     })
@@ -297,16 +301,32 @@ export class FigureV3ModellerPage extends PageView {
     this.changed()
     this.readRow(id)
   }
-  /** The dock must explicitly use this checked transaction contract, never an unversioned overwrite. */
+  /**
+   * The dock's way in (`figure-assistant.ts`): input changes, or a proposal's commands as one step (ADR-0094). A
+   * revision is applied on the version the model saw; a new figure's proposal only on a new figure not yet touched. A
+   * page on a saved figure leaves a new figure's proposal untaken, and the handler opens a new figure for it.
+   */
   private applyAI = (event: Event) => {
     const detail = (event as CustomEvent).detail
     if (!this.active || !detail) return
+    const view = this.session.read()
+    if (detail.create && this.routeId) return
+    if (detail.create && view.dirty) {
+      /* A new figure already being made is the person's; a proposal does not go on top of it or replace it. */
+      detail.applied = false
+      detail.code = 'NEW_FIGURE_UNSAVED'
+      detail.error = i18next.t('figure.text.proposal-new-figure-unsaved')
+      return
+    }
     try {
-      this.session.apply(detail.changes, 'ai', detail.revision, detail.context)
+      if (detail.create) this.session.applyProposal(detail.steps, view.revision!, view.context!)
+      else if (detail.steps) this.session.applyProposal(detail.steps, detail.revision, detail.context)
+      else this.session.apply(detail.changes, 'ai', detail.revision, detail.context)
       detail.applied = true
       this.changed()
     } catch (error) {
       detail.applied = false
+      detail.code = (error as { code?: string })?.code
       detail.error = error instanceof Error ? error.message : String(error)
     }
   }
@@ -361,6 +381,7 @@ export class FigureV3ModellerPage extends PageView {
         this.draft = undefined
         this.row = { version: 0 }
         this.typeError = ''
+        this.takeNewFigureProposal()
       }
       this.routeId = id
       this.error = ''
@@ -369,6 +390,18 @@ export class FigureV3ModellerPage extends PageView {
       this.error = error instanceof Error ? error.message : String(error)
     }
   }
+  /** A new figure the dock opened for a proposal: its steps, applied as the new figure's first step. */
+  private takeNewFigureProposal() {
+    const waiting = takePendingNewFigure()
+    if (!waiting) return
+    const view = this.session.read()
+    try {
+      this.session.applyProposal(waiting.steps, view.revision!, view.context!)
+      waiting.settle({ applied: true })
+    } catch (error) {
+      waiting.settle({ applied: false, code: (error as { code?: string })?.code, error: error instanceof Error ? error.message : String(error) })
+    }
+  }
   /** The first save's question, over the names this domain already uses (V2 asked the same). */
   private askFirstSave = async (name: string): Promise<FirstSave | undefined> => {
     const taken = await fetchFigureTypeNames().catch(() => [] as string[])

package/client/types.ts

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

package/dist-client/figure-assistant.js

@@ -1,19 +1,31 @@
 /*
- * What the AI dock does with a figure candidate - figure-ui declares it because figure-service declares the tool
+ * What the AI dock does with a figure proposal - figure-ui declares it because figure-service declares the tool
  * (`proposeFigureCandidate`, design/ai/shared-dock.md §4).
  *
- * Today a candidate cannot be taken anywhere. The proposer writes V2 figures and the modeller opens V3 only; the V2
- * modeller that reviewed candidates was removed with its listeners (`figure-ai-review`, `figure-ai-stage`), and the
- * server already refuses to propose for a V3 figure (`V3_PROPOSAL_UNAVAILABLE`). So the outcome is `unavailable`,
- * said to the person in words, not a silent pass - until a proposer writes V3 changes, which the modeller takes
- * through `figure-v3-apply`.
+ * 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`).
  */
 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';
 export const FIGURE_CANDIDATE_TOOL = 'proposeFigureCandidate';
-registerProposalHandler(FIGURE_CANDIDATE_TOOL, async (_proposal, context) => {
-    const note = i18next.t('figure.text.candidate-cannot-open');
-    context.notify('info', note);
-    return { verdict: 'unavailable', errorCode: 'v3-review-missing', note };
+registerProposalHandler(FIGURE_CANDIDATE_TOOL, async (proposal, context) => {
+    const outcome = await runFigureProposal(proposal, {
+        offer(detail) {
+            window.dispatchEvent(new CustomEvent('figure-v3-apply', { detail }));
+            return detail;
+        },
+        openNew(steps) {
+            const opened = pendNewFigure(steps);
+            navigate(modellerPathOf());
+            return opened;
+        }
+    }, (key, params) => i18next.t(key, params));
+    if (outcome.note)
+        context.notify(outcome.verdict === 'accepted' ? 'info' : 'error', outcome.note);
+    return outcome;
 });
 //# sourceMappingURL=figure-assistant.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"figure-assistant.js","sourceRoot":"","sources":["../client/figure-assistant.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AACvC,OAAO,EAAE,uBAAuB,EAAE,MAAM,mDAAmD,CAAA;AAE3F,MAAM,CAAC,MAAM,qBAAqB,GAAG,wBAAwB,CAAA;AAE7D,uBAAuB,CAAC,qBAAqB,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE;IAC1E,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,mCAAmC,CAAC,CAAA;IAC3D,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;IAC5B,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,mBAAmB,EAAE,IAAI,EAAE,CAAA;AACzE,CAAC,CAAC,CAAA","sourcesContent":["/*\n * What the AI dock does with a figure candidate - figure-ui declares it because figure-service declares the tool\n * (`proposeFigureCandidate`, design/ai/shared-dock.md §4).\n *\n * Today a candidate cannot be taken anywhere. The proposer writes V2 figures and the modeller opens V3 only; the V2\n * modeller that reviewed candidates was removed with its listeners (`figure-ai-review`, `figure-ai-stage`), and the\n * server already refuses to propose for a V3 figure (`V3_PROPOSAL_UNAVAILABLE`). So the outcome is `unavailable`,\n * said to the person in words, not a silent pass - until a proposer writes V3 changes, which the modeller takes\n * through `figure-v3-apply`.\n */\nimport { i18next } from '@operato/i18n'\nimport { registerProposalHandler } from '@things-factory/ai-assistant/dist-client/index.js'\n\nexport const FIGURE_CANDIDATE_TOOL = 'proposeFigureCandidate'\n\nregisterProposalHandler(FIGURE_CANDIDATE_TOOL, async (_proposal, context) => {\n  const note = i18next.t('figure.text.candidate-cannot-open')\n  context.notify('info', note)\n  return { verdict: 'unavailable', errorCode: 'v3-review-missing', note }\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,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"]}

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

@@ -1,4 +1,4 @@
-import type { Figure, FigureFinding, FigureInspection, FigureListResult, FigurePatch, FigureProposal, ProposalFeedback, FigureVersion, NewFigure } from '../types.js';
+import type { Figure, FigureFinding, FigureInspection, FigureListResult, FigurePatch, FigureVersion, NewFigure } from '../types.js';
 /**
  * 목록을 가져온다.
  *
@@ -32,24 +32,6 @@ export interface SaveResult {
 export declare function createFigure(figure: NewFigure): Promise<SaveResult>;
 export declare function updateFigure(id: string, patch: FigurePatch): Promise<SaveResult>;
 export declare function deleteFigure(id: string): Promise<boolean>;
-/**
- * 저작 보조에게 후보를 시킨다.
- *
- * 팔레트를 **클라이언트가 보낸다.** 서버는 팔레트를 모른다 — things-scene 이 갖고
- * 있는데 그 패키지의 node 조건은 팔레트가 없는 번들로 간다. 그리는 쪽이 어떤 토큰을
- * 풀 수 있는지 아는 유일한 자리이므로 그쪽이 보낸다.
- *
- * 돌아오는 것은 **후보**다. 저장되지 않았다 — 저작자가 받아야 정본이 된다.
- */
-export declare function proposeFigure(request: {
-    prompt: string;
-    base?: string;
-    type?: string;
-    palette: string[];
-    refine?: boolean;
-    feedback?: ProposalFeedback[];
-    image?: File;
-}): Promise<FigureProposal>;
 /**
  * 발행한다 — 판 번호가 오르고, 그 순간이 판본으로 남는다.
  *

package/dist-client/graphql/index.js

@@ -147,52 +147,6 @@ export async function deleteFigure(id) {
     });
     return unwrap(response, 'deleteFigure');
 }
-/**
- * 저작 보조에게 후보를 시킨다.
- *
- * 팔레트를 **클라이언트가 보낸다.** 서버는 팔레트를 모른다 — things-scene 이 갖고
- * 있는데 그 패키지의 node 조건은 팔레트가 없는 번들로 간다. 그리는 쪽이 어떤 토큰을
- * 풀 수 있는지 아는 유일한 자리이므로 그쪽이 보낸다.
- *
- * 돌아오는 것은 **후보**다. 저장되지 않았다 — 저작자가 받아야 정본이 된다.
- */
-export async function proposeFigure(request) {
-    const response = await client.mutate({
-        mutation: gql `
-      mutation ProposeFigure($request: ProposeRequest!) {
-        proposeFigure(request: $request) {
-          source
-          score
-          grade
-          triangles
-          groups
-          quality {
-            status
-            summary
-            findings {
-              dimension
-              code
-              message
-            }
-            visualRegions
-            visualCoverage
-            visualReadability
-          }
-          attempts
-          violations {
-            code
-            message
-          }
-        }
-      }
-    `,
-        variables: { request },
-        // @operato/graphql 는 이 신호가 있을 때만 Upload가 포함된 변수를 multipart로 인코딩한다.
-        // 없으면 브라우저 File은 JSON에서 {}가 되어 서버 Upload scalar가 요청 자체를 거절한다.
-        context: { hasUpload: !!request.image }
-    });
-    return unwrap(response, 'proposeFigure');
-}
 /**
  * 발행한다 — 판 번호가 오르고, 그 순간이 판본으로 남는다.
  *