@things-factory/figure-ui 10.1.74 → 10.1.76

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

@@ -0,0 +1,510 @@
+import { type FigureInputChange, type FigurePrimitiveCreation, type FigurePartEdit, type FigureAuthoringAction, type FigureProposalStep } from '@hatiolab/figure-model';
+export interface FigureProductRecord {
+    id: string;
+    source: string;
+}
+/** Persistence is injected; neither the model engine nor the renderer owns the product ID. */
+export interface FigureProductStore {
+    load(id: string): Promise<FigureProductRecord>;
+    save(request: {
+        id?: string;
+        source: string;
+        expectedSource?: string;
+        creationId?: string;
+        /** The card's picture. Absent when the browser could not draw one; the source is saved either way. */
+        thumbnail?: string;
+        /** The type name a new figure is created under (the first save asks for it). Not sent for an existing one. */
+        type?: string;
+    }): Promise<FigureProductRecord>;
+}
+/** Product lifecycle boundary. A late response can never change another editor's asset or ID. */
+export declare function createFigureProductSession(store: FigureProductStore): {
+    read: () => {
+        id: string | undefined;
+        loading: boolean;
+        saving: boolean;
+        error: string | undefined;
+        context: null;
+        name: null;
+        fields: never[];
+        geometry: never[];
+        bindings: never[];
+        dirty: boolean;
+        revision: null;
+        canUndo?: undefined;
+        canRedo?: undefined;
+        palette?: undefined;
+    } | {
+        id: string | undefined;
+        loading: boolean;
+        saving: boolean;
+        error: string | undefined;
+        context: string;
+        name: string;
+        revision: number;
+        dirty: boolean;
+        canUndo: boolean;
+        canRedo: boolean;
+        fields: {
+            value: number;
+            id: string;
+            unit: import("@hatiolab/figure-model").FigureUnit;
+            min: number;
+            max: number;
+            role?: "design" | "state";
+        }[];
+        geometry: import("@hatiolab/figure-model").FigureAssetGeometry[];
+        bindings: import("@hatiolab/figure-model").FigureEvaluatedBinding[];
+        palette: Record<string, string>;
+    };
+    startNew({ discard }?: {
+        discard?: boolean | undefined;
+    }): {
+        id: string | undefined;
+        loading: boolean;
+        saving: boolean;
+        error: string | undefined;
+        context: null;
+        name: null;
+        fields: never[];
+        geometry: never[];
+        bindings: never[];
+        dirty: boolean;
+        revision: null;
+        canUndo?: undefined;
+        canRedo?: undefined;
+        palette?: undefined;
+    } | {
+        id: string | undefined;
+        loading: boolean;
+        saving: boolean;
+        error: string | undefined;
+        context: string;
+        name: string;
+        revision: number;
+        dirty: boolean;
+        canUndo: boolean;
+        canRedo: boolean;
+        fields: {
+            value: number;
+            id: string;
+            unit: import("@hatiolab/figure-model").FigureUnit;
+            min: number;
+            max: number;
+            role?: "design" | "state";
+        }[];
+        geometry: import("@hatiolab/figure-model").FigureAssetGeometry[];
+        bindings: import("@hatiolab/figure-model").FigureEvaluatedBinding[];
+        palette: Record<string, string>;
+    };
+    open(nextId: string, { discard }?: {
+        discard?: boolean | undefined;
+    }): Promise<{
+        id: string | undefined;
+        loading: boolean;
+        saving: boolean;
+        error: string | undefined;
+        context: null;
+        name: null;
+        fields: never[];
+        geometry: never[];
+        bindings: never[];
+        dirty: boolean;
+        revision: null;
+        canUndo?: undefined;
+        canRedo?: undefined;
+        palette?: undefined;
+    } | {
+        id: string | undefined;
+        loading: boolean;
+        saving: boolean;
+        error: string | undefined;
+        context: string;
+        name: string;
+        revision: number;
+        dirty: boolean;
+        canUndo: boolean;
+        canRedo: boolean;
+        fields: {
+            value: number;
+            id: string;
+            unit: import("@hatiolab/figure-model").FigureUnit;
+            min: number;
+            max: number;
+            role?: "design" | "state";
+        }[];
+        geometry: import("@hatiolab/figure-model").FigureAssetGeometry[];
+        bindings: import("@hatiolab/figure-model").FigureEvaluatedBinding[];
+        palette: Record<string, string>;
+    }>;
+    close({ discard }?: {
+        discard?: boolean | undefined;
+    }): {
+        id: string | undefined;
+        loading: boolean;
+        saving: boolean;
+        error: string | undefined;
+        context: null;
+        name: null;
+        fields: never[];
+        geometry: never[];
+        bindings: never[];
+        dirty: boolean;
+        revision: null;
+        canUndo?: undefined;
+        canRedo?: undefined;
+        palette?: undefined;
+    } | {
+        id: string | undefined;
+        loading: boolean;
+        saving: boolean;
+        error: string | undefined;
+        context: string;
+        name: string;
+        revision: number;
+        dirty: boolean;
+        canUndo: boolean;
+        canRedo: boolean;
+        fields: {
+            value: number;
+            id: string;
+            unit: import("@hatiolab/figure-model").FigureUnit;
+            min: number;
+            max: number;
+            role?: "design" | "state";
+        }[];
+        geometry: import("@hatiolab/figure-model").FigureAssetGeometry[];
+        bindings: import("@hatiolab/figure-model").FigureEvaluatedBinding[];
+        palette: Record<string, string>;
+    };
+    apply(changes: FigureInputChange[], origin?: "ui" | "ai", expectedRevision?: number, context?: string): {
+        context: null;
+        name: null;
+        fields: never[];
+        geometry: never[];
+        bindings: never[];
+        dirty: boolean;
+        revision: null;
+        canUndo?: undefined;
+        canRedo?: undefined;
+        palette?: undefined;
+    } | {
+        context: string;
+        name: string;
+        revision: number;
+        dirty: boolean;
+        canUndo: boolean;
+        canRedo: boolean;
+        fields: {
+            value: number;
+            id: string;
+            unit: import("@hatiolab/figure-model").FigureUnit;
+            min: number;
+            max: number;
+            role?: "design" | "state";
+        }[];
+        geometry: import("@hatiolab/figure-model").FigureAssetGeometry[];
+        bindings: import("@hatiolab/figure-model").FigureEvaluatedBinding[];
+        palette: Record<string, string>;
+    };
+    /**
+     * 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 FigureProposalStep[], expectedRevision: number, context: string): {
+        context: null;
+        name: null;
+        fields: never[];
+        geometry: never[];
+        bindings: never[];
+        dirty: boolean;
+        revision: null;
+        canUndo?: undefined;
+        canRedo?: undefined;
+        palette?: undefined;
+    } | {
+        context: string;
+        name: string;
+        revision: number;
+        dirty: boolean;
+        canUndo: boolean;
+        canRedo: boolean;
+        fields: {
+            value: number;
+            id: string;
+            unit: import("@hatiolab/figure-model").FigureUnit;
+            min: number;
+            max: number;
+            role?: "design" | "state";
+        }[];
+        geometry: import("@hatiolab/figure-model").FigureAssetGeometry[];
+        bindings: import("@hatiolab/figure-model").FigureEvaluatedBinding[];
+        palette: Record<string, string>;
+    };
+    /**
+     * A recipe put in by the person (ADR-0095): its resolved commands, as one step of the history, on the version open
+     * now. The same path as a proposal; the person is its origin.
+     */
+    applyRecipe(steps: readonly FigureProposalStep[]): {
+        context: null;
+        name: null;
+        fields: never[];
+        geometry: never[];
+        bindings: never[];
+        dirty: boolean;
+        revision: null;
+        canUndo?: undefined;
+        canRedo?: undefined;
+        palette?: undefined;
+    } | {
+        context: string;
+        name: string;
+        revision: number;
+        dirty: boolean;
+        canUndo: boolean;
+        canRedo: boolean;
+        fields: {
+            value: number;
+            id: string;
+            unit: import("@hatiolab/figure-model").FigureUnit;
+            min: number;
+            max: number;
+            role?: "design" | "state";
+        }[];
+        geometry: import("@hatiolab/figure-model").FigureAssetGeometry[];
+        bindings: import("@hatiolab/figure-model").FigureEvaluatedBinding[];
+        palette: Record<string, string>;
+    };
+    add(part: FigurePrimitiveCreation): {
+        context: null;
+        name: null;
+        fields: never[];
+        geometry: never[];
+        bindings: never[];
+        dirty: boolean;
+        revision: null;
+        canUndo?: undefined;
+        canRedo?: undefined;
+        palette?: undefined;
+    } | {
+        context: string;
+        name: string;
+        revision: number;
+        dirty: boolean;
+        canUndo: boolean;
+        canRedo: boolean;
+        fields: {
+            value: number;
+            id: string;
+            unit: import("@hatiolab/figure-model").FigureUnit;
+            min: number;
+            max: number;
+            role?: "design" | "state";
+        }[];
+        geometry: import("@hatiolab/figure-model").FigureAssetGeometry[];
+        bindings: import("@hatiolab/figure-model").FigureEvaluatedBinding[];
+        palette: Record<string, string>;
+    };
+    edit(edit: FigurePartEdit): {
+        context: null;
+        name: null;
+        fields: never[];
+        geometry: never[];
+        bindings: never[];
+        dirty: boolean;
+        revision: null;
+        canUndo?: undefined;
+        canRedo?: undefined;
+        palette?: undefined;
+    } | {
+        context: string;
+        name: string;
+        revision: number;
+        dirty: boolean;
+        canUndo: boolean;
+        canRedo: boolean;
+        fields: {
+            value: number;
+            id: string;
+            unit: import("@hatiolab/figure-model").FigureUnit;
+            min: number;
+            max: number;
+            role?: "design" | "state";
+        }[];
+        geometry: import("@hatiolab/figure-model").FigureAssetGeometry[];
+        bindings: import("@hatiolab/figure-model").FigureEvaluatedBinding[];
+        palette: Record<string, string>;
+    } | {
+        removal: import("@hatiolab/figure-model").RemovalNotice;
+        context: null;
+        name: null;
+        fields: never[];
+        geometry: never[];
+        bindings: never[];
+        dirty: boolean;
+        revision: null;
+        canUndo?: undefined;
+        canRedo?: undefined;
+        palette?: undefined;
+    } | {
+        removal: import("@hatiolab/figure-model").RemovalNotice;
+        context: string;
+        name: string;
+        revision: number;
+        dirty: boolean;
+        canUndo: boolean;
+        canRedo: boolean;
+        fields: {
+            value: number;
+            id: string;
+            unit: import("@hatiolab/figure-model").FigureUnit;
+            min: number;
+            max: number;
+            role?: "design" | "state";
+        }[];
+        geometry: import("@hatiolab/figure-model").FigureAssetGeometry[];
+        bindings: import("@hatiolab/figure-model").FigureEvaluatedBinding[];
+        palette: Record<string, string>;
+    };
+    /** One authoring command — what a person means, not a graph edit — as one step of the same history. */
+    command(action: FigureAuthoringAction): {
+        context: null;
+        name: null;
+        fields: never[];
+        geometry: never[];
+        bindings: never[];
+        dirty: boolean;
+        revision: null;
+        canUndo?: undefined;
+        canRedo?: undefined;
+        palette?: undefined;
+    } | {
+        context: string;
+        name: string;
+        revision: number;
+        dirty: boolean;
+        canUndo: boolean;
+        canRedo: boolean;
+        fields: {
+            value: number;
+            id: string;
+            unit: import("@hatiolab/figure-model").FigureUnit;
+            min: number;
+            max: number;
+            role?: "design" | "state";
+        }[];
+        geometry: import("@hatiolab/figure-model").FigureAssetGeometry[];
+        bindings: import("@hatiolab/figure-model").FigureEvaluatedBinding[];
+        palette: Record<string, string>;
+    };
+    undo(): {
+        context: null;
+        name: null;
+        fields: never[];
+        geometry: never[];
+        bindings: never[];
+        dirty: boolean;
+        revision: null;
+        canUndo?: undefined;
+        canRedo?: undefined;
+        palette?: undefined;
+    } | {
+        context: string;
+        name: string;
+        revision: number;
+        dirty: boolean;
+        canUndo: boolean;
+        canRedo: boolean;
+        fields: {
+            value: number;
+            id: string;
+            unit: import("@hatiolab/figure-model").FigureUnit;
+            min: number;
+            max: number;
+            role?: "design" | "state";
+        }[];
+        geometry: import("@hatiolab/figure-model").FigureAssetGeometry[];
+        bindings: import("@hatiolab/figure-model").FigureEvaluatedBinding[];
+        palette: Record<string, string>;
+    };
+    redo(): {
+        context: null;
+        name: null;
+        fields: never[];
+        geometry: never[];
+        bindings: never[];
+        dirty: boolean;
+        revision: null;
+        canUndo?: undefined;
+        canRedo?: undefined;
+        palette?: undefined;
+    } | {
+        context: string;
+        name: string;
+        revision: number;
+        dirty: boolean;
+        canUndo: boolean;
+        canRedo: boolean;
+        fields: {
+            value: number;
+            id: string;
+            unit: import("@hatiolab/figure-model").FigureUnit;
+            min: number;
+            max: number;
+            role?: "design" | "state";
+        }[];
+        geometry: import("@hatiolab/figure-model").FigureAssetGeometry[];
+        bindings: import("@hatiolab/figure-model").FigureEvaluatedBinding[];
+        palette: Record<string, string>;
+    };
+    source(): string;
+    /**
+     * Saves the model, and the card's picture when the caller managed to take one.
+     *
+     * The picture is the caller's because taking it needs a canvas, and this session is the place that knows
+     * nothing about drawing. A save with no picture is a save: a tab in the background cannot draw, and the
+     * source matters more than the card (see `thumbnail.ts`).
+     */
+    save({ thumbnail, type }?: {
+        thumbnail?: string;
+        type?: string;
+    }): Promise<{
+        id: string | undefined;
+        loading: boolean;
+        saving: boolean;
+        error: string | undefined;
+        context: null;
+        name: null;
+        fields: never[];
+        geometry: never[];
+        bindings: never[];
+        dirty: boolean;
+        revision: null;
+        canUndo?: undefined;
+        canRedo?: undefined;
+        palette?: undefined;
+    } | {
+        id: string | undefined;
+        loading: boolean;
+        saving: boolean;
+        error: string | undefined;
+        context: string;
+        name: string;
+        revision: number;
+        dirty: boolean;
+        canUndo: boolean;
+        canRedo: boolean;
+        fields: {
+            value: number;
+            id: string;
+            unit: import("@hatiolab/figure-model").FigureUnit;
+            min: number;
+            max: number;
+            role?: "design" | "state";
+        }[];
+        geometry: import("@hatiolab/figure-model").FigureAssetGeometry[];
+        bindings: import("@hatiolab/figure-model").FigureEvaluatedBinding[];
+        palette: Record<string, string>;
+    }>;
+};
+export type FigureProductSession = ReturnType<typeof createFigureProductSession>;

package/dist-client/modeller/product-session.js

@@ -0,0 +1,157 @@
+import { createFigureAsset, createFigureEditorWorkspace, serializeFigureAsset, parseFigureAsset } from '@hatiolab/figure-model';
+/** Product lifecycle boundary. A late response can never change another editor's asset or ID. */
+export function createFigureProductSession(store) {
+    const workspace = createFigureEditorWorkspace();
+    let epoch = 0, id, baseline;
+    let loading = false, saving = false, error;
+    let creationId;
+    function read() {
+        return { ...workspace.read(), id, loading, saving, error };
+    }
+    function writable() {
+        const view = workspace.read();
+        if (loading || error || !view.context || view.revision === null)
+            throw Error('먼저 모델을 정상적으로 열어 주세요.');
+        // Serializing writes also makes create retries safe: no second create while the first is pending.
+        if (saving)
+            throw Error('저장이 끝난 뒤 편집해 주세요.');
+        return { context: view.context, expectedRevision: view.revision, origin: 'ui' };
+    }
+    function clear() {
+        workspace.close({ discardDesignChanges: true });
+        id = undefined;
+        baseline = undefined;
+        error = undefined;
+        saving = false;
+        creationId = undefined;
+    }
+    function canLeave(discard) {
+        if (saving)
+            throw Error('저장이 끝난 뒤 모델을 전환해 주세요.');
+        if (workspace.read().dirty && !discard)
+            throw Error('저장하지 않은 변경이 있습니다.');
+    }
+    return {
+        read,
+        startNew({ discard = false } = {}) {
+            canLeave(discard);
+            ++epoch;
+            clear();
+            loading = false;
+            workspace.open(serializeFigureAsset(createFigureAsset('새 Figure')));
+            creationId = crypto.randomUUID();
+            return read();
+        },
+        async open(nextId, { discard = false } = {}) {
+            canLeave(discard);
+            const requestEpoch = ++epoch;
+            clear();
+            loading = true;
+            try {
+                const record = await store.load(nextId);
+                if (requestEpoch !== epoch)
+                    return read();
+                if (record.id !== nextId)
+                    throw Error('요청한 Figure와 응답의 대상이 다릅니다.');
+                workspace.open(record.source);
+                id = nextId;
+                baseline = record.source;
+            }
+            catch (cause) {
+                if (requestEpoch === epoch)
+                    error = cause instanceof Error ? cause.message : String(cause);
+            }
+            finally {
+                if (requestEpoch === epoch)
+                    loading = false;
+            }
+            return read();
+        },
+        close({ discard = false } = {}) {
+            canLeave(discard);
+            ++epoch;
+            clear();
+            loading = false;
+            return read();
+        },
+        apply(changes, origin = 'ui', expectedRevision, context) {
+            const control = writable();
+            // AI must supply the context AND revision captured when it started. Never substitute current values.
+            if (origin === 'ai' && (context === undefined || expectedRevision === undefined))
+                throw Error('AI 편집에는 요청 당시의 모델 문맥과 리비전이 필요합니다.');
+            return workspace.apply({
+                ...control,
+                origin,
+                context: context ?? control.context,
+                expectedRevision: expectedRevision ?? control.expectedRevision,
+                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, expectedRevision, context) {
+            writable();
+            return workspace.applyProposal({ origin: 'ai', context, expectedRevision, steps });
+        },
+        /**
+         * A recipe put in by the person (ADR-0095): its resolved commands, as one step of the history, on the version open
+         * now. The same path as a proposal; the person is its origin.
+         */
+        applyRecipe(steps) {
+            const at = writable();
+            return workspace.applyProposal({ origin: 'ui', context: at.context, expectedRevision: at.expectedRevision, steps });
+        },
+        add(part) {
+            return workspace.addPrimitive({ ...writable(), part });
+        },
+        edit(edit) {
+            return workspace.editPart({ ...writable(), edit });
+        },
+        /** One authoring command — what a person means, not a graph edit — as one step of the same history. */
+        command(action) {
+            return workspace.command({ ...writable(), action });
+        },
+        undo() {
+            return workspace.undo(writable());
+        },
+        redo() {
+            return workspace.redo(writable());
+        },
+        source() {
+            const { context } = writable();
+            return workspace.export({ context }).text;
+        },
+        /**
+         * Saves the model, and the card's picture when the caller managed to take one.
+         *
+         * The picture is the caller's because taking it needs a canvas, and this session is the place that knows
+         * nothing about drawing. A save with no picture is a save: a tab in the background cannot draw, and the
+         * source matters more than the card (see `thumbnail.ts`).
+         */
+        async save({ thumbnail, type } = {}) {
+            const control = writable(), requestEpoch = epoch;
+            const exported = workspace.export(control);
+            saving = true;
+            try {
+                const record = await store.save({ id, source: exported.text, expectedSource: baseline, creationId, thumbnail, ...(id || !type ? {} : { type }) });
+                if (requestEpoch !== epoch)
+                    return read();
+                if (!record.id || (id !== undefined && record.id !== id))
+                    throw Error('저장 응답의 Figure 대상이 다릅니다.');
+                if (serializeFigureAsset(parseFigureAsset(record.source)) !== exported.text)
+                    throw Error('저장 응답이 보낸 모델과 다릅니다. 저장 상태를 다시 확인해 주세요.');
+                workspace.acknowledgeSaved(exported);
+                id = record.id;
+                baseline = record.source;
+            }
+            finally {
+                if (requestEpoch === epoch)
+                    saving = false;
+            }
+            return read();
+        }
+    };
+}
+//# sourceMappingURL=product-session.js.map

package/dist-client/modeller/product-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"product-session.js","sourceRoot":"","sources":["../../client/modeller/product-session.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  createFigureAsset,\n  createFigureEditorWorkspace,\n  serializeFigureAsset,\n  parseFigureAsset,\n  type FigureInputChange,\n  type FigurePrimitiveCreation,\n  type FigurePartEdit,\n  type FigureAuthoringAction,\n  type FigureProposalStep\n} from '@hatiolab/figure-model'\n\nexport interface FigureProductRecord {\n  id: string\n  source: string\n}\n\n/** Persistence is injected; neither the model engine nor the renderer owns the product ID. */\nexport interface FigureProductStore {\n  load(id: string): Promise<FigureProductRecord>\n  save(request: {\n    id?: string\n    source: string\n    expectedSource?: string\n    creationId?: string\n    /** The card's picture. Absent when the browser could not draw one; the source is saved either way. */\n    thumbnail?: string\n    /** The type name a new figure is created under (the first save asks for it). Not sent for an existing one. */\n    type?: string\n  }): Promise<FigureProductRecord>\n}\n\n/** Product lifecycle boundary. A late response can never change another editor's asset or ID. */\nexport function createFigureProductSession(store: FigureProductStore) {\n  const workspace = createFigureEditorWorkspace()\n  let epoch = 0,\n    id: string | undefined,\n    baseline: string | undefined\n  let loading = false,\n    saving = false,\n    error: string | undefined\n  let creationId: string | undefined\n  function read() {\n    return { ...workspace.read(), id, loading, saving, error }\n  }\n  function writable() {\n    const view = workspace.read()\n    if (loading || error || !view.context || view.revision === null) throw Error('먼저 모델을 정상적으로 열어 주세요.')\n    // Serializing writes also makes create retries safe: no second create while the first is pending.\n    if (saving) throw Error('저장이 끝난 뒤 편집해 주세요.')\n    return { context: view.context, expectedRevision: view.revision, origin: 'ui' as const }\n  }\n  function clear() {\n    workspace.close({ discardDesignChanges: true })\n    id = undefined\n    baseline = undefined\n    error = undefined\n    saving = false\n    creationId = undefined\n  }\n  function canLeave(discard: boolean) {\n    if (saving) throw Error('저장이 끝난 뒤 모델을 전환해 주세요.')\n    if (workspace.read().dirty && !discard) throw Error('저장하지 않은 변경이 있습니다.')\n  }\n  return {\n    read,\n    startNew({ discard = false } = {}) {\n      canLeave(discard)\n      ++epoch\n      clear()\n      loading = false\n      workspace.open(serializeFigureAsset(createFigureAsset('새 Figure')))\n      creationId = crypto.randomUUID()\n      return read()\n    },\n    async open(nextId: string, { discard = false } = {}) {\n      canLeave(discard)\n      const requestEpoch = ++epoch\n      clear()\n      loading = true\n      try {\n        const record = await store.load(nextId)\n        if (requestEpoch !== epoch) return read()\n        if (record.id !== nextId) throw Error('요청한 Figure와 응답의 대상이 다릅니다.')\n        workspace.open(record.source)\n        id = nextId\n        baseline = record.source\n      } catch (cause) {\n        if (requestEpoch === epoch) error = cause instanceof Error ? cause.message : String(cause)\n      } finally {\n        if (requestEpoch === epoch) loading = false\n      }\n      return read()\n    },\n    close({ discard = false } = {}) {\n      canLeave(discard)\n      ++epoch\n      clear()\n      loading = false\n      return read()\n    },\n    apply(changes: FigureInputChange[], origin: 'ui' | 'ai' = 'ui', expectedRevision?: number, context?: string) {\n      const control = writable()\n      // AI must supply the context AND revision captured when it started. Never substitute current values.\n      if (origin === 'ai' && (context === undefined || expectedRevision === undefined))\n        throw Error('AI 편집에는 요청 당시의 모델 문맥과 리비전이 필요합니다.')\n      return workspace.apply({\n        ...control,\n        origin,\n        context: context ?? control.context,\n        expectedRevision: expectedRevision ?? control.expectedRevision,\n        changes\n      })\n    },\n    /**\n     * An AI proposal (ADR-0094): the modeller's commands, as one step of the history, on the version the model saw.\n     * Never on the current one instead -- a person's edit in between makes the proposal stale, and it is refused.\n     */\n    applyProposal(steps: readonly FigureProposalStep[], expectedRevision: number, context: string) {\n      writable()\n      return workspace.applyProposal({ origin: 'ai', context, expectedRevision, steps })\n    },\n    /**\n     * A recipe put in by the person (ADR-0095): its resolved commands, as one step of the history, on the version open\n     * now. The same path as a proposal; the person is its origin.\n     */\n    applyRecipe(steps: readonly FigureProposalStep[]) {\n      const at = writable()\n      return workspace.applyProposal({ origin: 'ui', context: at.context, expectedRevision: at.expectedRevision, steps })\n    },\n    add(part: FigurePrimitiveCreation) {\n      return workspace.addPrimitive({ ...writable(), part })\n    },\n    edit(edit: FigurePartEdit) {\n      return workspace.editPart({ ...writable(), edit })\n    },\n    /** One authoring command — what a person means, not a graph edit — as one step of the same history. */\n    command(action: FigureAuthoringAction) {\n      return workspace.command({ ...writable(), action })\n    },\n    undo() {\n      return workspace.undo(writable())\n    },\n    redo() {\n      return workspace.redo(writable())\n    },\n    source() {\n      const { context } = writable()\n      return workspace.export({ context }).text\n    },\n    /**\n     * Saves the model, and the card's picture when the caller managed to take one.\n     *\n     * The picture is the caller's because taking it needs a canvas, and this session is the place that knows\n     * nothing about drawing. A save with no picture is a save: a tab in the background cannot draw, and the\n     * source matters more than the card (see `thumbnail.ts`).\n     */\n    async save({ thumbnail, type }: { thumbnail?: string; type?: string } = {}) {\n      const control = writable(),\n        requestEpoch = epoch\n      const exported = workspace.export(control)\n      saving = true\n      try {\n        const record = await store.save({ id, source: exported.text, expectedSource: baseline, creationId, thumbnail, ...(id || !type ? {} : { type }) })\n        if (requestEpoch !== epoch) return read()\n        if (!record.id || (id !== undefined && record.id !== id)) throw Error('저장 응답의 Figure 대상이 다릅니다.')\n        if (serializeFigureAsset(parseFigureAsset(record.source)) !== exported.text)\n          throw Error('저장 응답이 보낸 모델과 다릅니다. 저장 상태를 다시 확인해 주세요.')\n        workspace.acknowledgeSaved(exported)\n        id = record.id\n        baseline = record.source\n      } finally {\n        if (requestEpoch === epoch) saving = false\n      }\n      return read()\n    }\n  }\n}\nexport type FigureProductSession = ReturnType<typeof createFigureProductSession>\n"]}