@hatiolab/figure-model 0.1.92 → 0.1.94

package/dist/{v3-editor-workspace.d.ts → editor-workspace.d.ts}

@@ -1,18 +1,27 @@
-import type { V3EditRequest, V3EditControl } from './v3-authoring-session.ts';
-import type { V3BoxCreation, V3PrimitiveCreation } from './v3-create.ts';
-import { type V3ProposalStep } from './v3-proposal.ts';
-import type { V3AuthoringAction } from './v3-authoring-actions.ts';
-import type { V3PartEdit } from './v3-part-edit.ts';
-export interface V3WorkspaceExport {
+import type { FigureEditRequest, FigureEditControl } from './authoring-session.ts';
+import type { FigureBoxCreation, FigurePrimitiveCreation } from './create.ts';
+import { type FigureProposalStep } from './proposal.ts';
+import type { FigureAuthoringAction } from './authoring-actions.ts';
+import type { FigurePartEdit } from './part-edit.ts';
+import type { FigureAsset } from './asset-types.ts';
+export interface FigureWorkspaceExport {
     context: string;
     revision: number;
     text: string;
 }
-export interface V3LeaveOptions {
+export interface FigureLeaveOptions {
     discardDesignChanges?: boolean;
 }
+/**
+ * `baseline`: the saved text the opened one is measured against, when they differ -- an unsaved draft reopened from the
+ * browser (ADR-0098): the draft is what is edited, the saved text is what "unsaved" is measured from, so the figure
+ * opens dirty. Left out, the text opened is its own baseline. The undo history is not brought back.
+ */
+export interface FigureOpenOptions extends FigureLeaveOptions {
+    baseline?: string;
+}
 /** One history for structural and input edits. No persistence or authentication is implied. */
-export declare function createV3EditorWorkspace(): {
+export declare function createFigureEditorWorkspace(): {
     read: () => {
         context: null;
         name: null;
@@ -34,16 +43,16 @@ export declare function createV3EditorWorkspace(): {
         fields: {
             value: number;
             id: string;
-            unit: import("./v3-graph-types.ts").V3Unit;
+            unit: import("./graph-types.ts").FigureUnit;
             min: number;
             max: number;
             role?: "design" | "state";
         }[];
-        geometry: import("./v3-asset-types.ts").V3AssetGeometry[];
-        bindings: import("./v3-asset-types.ts").V3EvaluatedBinding[];
+        geometry: import("./asset-types.ts").FigureAssetGeometry[];
+        bindings: import("./asset-types.ts").FigureEvaluatedBinding[];
         palette: Record<string, string>;
     };
-    open(text: string, { discardDesignChanges }?: V3LeaveOptions): {
+    open(text: string, { discardDesignChanges, baseline }?: FigureOpenOptions): {
         context: null;
         name: null;
         fields: never[];
@@ -64,16 +73,16 @@ export declare function createV3EditorWorkspace(): {
         fields: {
             value: number;
             id: string;
-            unit: import("./v3-graph-types.ts").V3Unit;
+            unit: import("./graph-types.ts").FigureUnit;
             min: number;
             max: number;
             role?: "design" | "state";
         }[];
-        geometry: import("./v3-asset-types.ts").V3AssetGeometry[];
-        bindings: import("./v3-asset-types.ts").V3EvaluatedBinding[];
+        geometry: import("./asset-types.ts").FigureAssetGeometry[];
+        bindings: import("./asset-types.ts").FigureEvaluatedBinding[];
         palette: Record<string, string>;
     };
-    close({ discardDesignChanges }?: V3LeaveOptions): {
+    close({ discardDesignChanges }?: FigureLeaveOptions): {
         context: null;
         name: null;
         fields: never[];
@@ -94,21 +103,21 @@ export declare function createV3EditorWorkspace(): {
         fields: {
             value: number;
             id: string;
-            unit: import("./v3-graph-types.ts").V3Unit;
+            unit: import("./graph-types.ts").FigureUnit;
             min: number;
             max: number;
             role?: "design" | "state";
         }[];
-        geometry: import("./v3-asset-types.ts").V3AssetGeometry[];
-        bindings: import("./v3-asset-types.ts").V3EvaluatedBinding[];
+        geometry: import("./asset-types.ts").FigureAssetGeometry[];
+        bindings: import("./asset-types.ts").FigureEvaluatedBinding[];
         palette: Record<string, string>;
     };
-    preview({ context, ...q }: V3EditRequest & {
+    preview({ context, ...q }: FigureEditRequest & {
         context: string;
     }): {
         candidate: {
             inputs: Record<string, number>;
-            evaluation: import("./v3-asset-types.ts").V3CapabilityEvaluation;
+            evaluation: import("./asset-types.ts").FigureCapabilityEvaluation;
         };
         baseRevision: number;
         origin: "ui" | "ai";
@@ -116,7 +125,7 @@ export declare function createV3EditorWorkspace(): {
             before: number | undefined;
             kind: "set-design" | "set-state";
             input: string;
-            unit: import("./v3-graph-types.ts").V3Unit;
+            unit: import("./graph-types.ts").FigureUnit;
             value: number;
         }[];
         effects: {
@@ -134,7 +143,7 @@ export declare function createV3EditorWorkspace(): {
             safety: string;
         };
     };
-    apply({ context, ...q }: V3EditRequest & {
+    apply({ context, ...q }: FigureEditRequest & {
         context: string;
     }): {
         context: null;
@@ -157,18 +166,18 @@ export declare function createV3EditorWorkspace(): {
         fields: {
             value: number;
             id: string;
-            unit: import("./v3-graph-types.ts").V3Unit;
+            unit: import("./graph-types.ts").FigureUnit;
             min: number;
             max: number;
             role?: "design" | "state";
         }[];
-        geometry: import("./v3-asset-types.ts").V3AssetGeometry[];
-        bindings: import("./v3-asset-types.ts").V3EvaluatedBinding[];
+        geometry: import("./asset-types.ts").FigureAssetGeometry[];
+        bindings: import("./asset-types.ts").FigureEvaluatedBinding[];
         palette: Record<string, string>;
     };
-    addBox({ context, box, ...q }: V3EditControl & {
+    addBox({ context, box, ...q }: FigureEditControl & {
         context: string;
-        box: V3BoxCreation;
+        box: FigureBoxCreation;
     }): {
         context: null;
         name: null;
@@ -190,18 +199,18 @@ export declare function createV3EditorWorkspace(): {
         fields: {
             value: number;
             id: string;
-            unit: import("./v3-graph-types.ts").V3Unit;
+            unit: import("./graph-types.ts").FigureUnit;
             min: number;
             max: number;
             role?: "design" | "state";
         }[];
-        geometry: import("./v3-asset-types.ts").V3AssetGeometry[];
-        bindings: import("./v3-asset-types.ts").V3EvaluatedBinding[];
+        geometry: import("./asset-types.ts").FigureAssetGeometry[];
+        bindings: import("./asset-types.ts").FigureEvaluatedBinding[];
         palette: Record<string, string>;
     };
-    addPrimitive({ context, part, ...q }: V3EditControl & {
+    addPrimitive({ context, part, ...q }: FigureEditControl & {
         context: string;
-        part: V3PrimitiveCreation;
+        part: FigurePrimitiveCreation;
     }): {
         context: null;
         name: null;
@@ -223,19 +232,19 @@ export declare function createV3EditorWorkspace(): {
         fields: {
             value: number;
             id: string;
-            unit: import("./v3-graph-types.ts").V3Unit;
+            unit: import("./graph-types.ts").FigureUnit;
             min: number;
             max: number;
             role?: "design" | "state";
         }[];
-        geometry: import("./v3-asset-types.ts").V3AssetGeometry[];
-        bindings: import("./v3-asset-types.ts").V3EvaluatedBinding[];
+        geometry: import("./asset-types.ts").FigureAssetGeometry[];
+        bindings: import("./asset-types.ts").FigureEvaluatedBinding[];
         palette: Record<string, string>;
     };
     /** A part edit, one step of the history. Removing a part also says what else that changed (`removal`). */
-    editPart({ context, edit, ...q }: V3EditControl & {
+    editPart({ context, edit, ...q }: FigureEditControl & {
         context: string;
-        edit: V3PartEdit;
+        edit: FigurePartEdit;
     }): {
         context: null;
         name: null;
@@ -257,16 +266,16 @@ export declare function createV3EditorWorkspace(): {
         fields: {
             value: number;
             id: string;
-            unit: import("./v3-graph-types.ts").V3Unit;
+            unit: import("./graph-types.ts").FigureUnit;
             min: number;
             max: number;
             role?: "design" | "state";
         }[];
-        geometry: import("./v3-asset-types.ts").V3AssetGeometry[];
-        bindings: import("./v3-asset-types.ts").V3EvaluatedBinding[];
+        geometry: import("./asset-types.ts").FigureAssetGeometry[];
+        bindings: import("./asset-types.ts").FigureEvaluatedBinding[];
         palette: Record<string, string>;
     } | {
-        removal: import("./v3-authoring-actions.ts").RemovalNotice;
+        removal: import("./authoring-actions.ts").RemovalNotice;
         context: null;
         name: null;
         fields: never[];
@@ -278,7 +287,7 @@ export declare function createV3EditorWorkspace(): {
         canRedo?: undefined;
         palette?: undefined;
     } | {
-        removal: import("./v3-authoring-actions.ts").RemovalNotice;
+        removal: import("./authoring-actions.ts").RemovalNotice;
         context: string;
         name: string;
         revision: number;
@@ -288,13 +297,13 @@ export declare function createV3EditorWorkspace(): {
         fields: {
             value: number;
             id: string;
-            unit: import("./v3-graph-types.ts").V3Unit;
+            unit: import("./graph-types.ts").FigureUnit;
             min: number;
             max: number;
             role?: "design" | "state";
         }[];
-        geometry: import("./v3-asset-types.ts").V3AssetGeometry[];
-        bindings: import("./v3-asset-types.ts").V3EvaluatedBinding[];
+        geometry: import("./asset-types.ts").FigureAssetGeometry[];
+        bindings: import("./asset-types.ts").FigureEvaluatedBinding[];
         palette: Record<string, string>;
     };
     /**
@@ -304,11 +313,11 @@ export declare function createV3EditorWorkspace(): {
      * The command sees the values the author is looking at: the live inputs are captured into the asset
      * first, so "fasten this to that" reads the part where it stands now, not where it stood when the model
      * was opened. A refused command leaves history, revision and the asset as they were, the same as an
-     * input edit that fails validation (`applyV3Authoring` clones and throws before anything is written).
+     * input edit that fails validation (`applyFigureAuthoring` clones and throws before anything is written).
      */
-    command({ context, action, ...q }: V3EditControl & {
+    command({ context, action, ...q }: FigureEditControl & {
         context: string;
-        action: V3AuthoringAction;
+        action: FigureAuthoringAction;
     }): {
         context: null;
         name: null;
@@ -330,22 +339,39 @@ export declare function createV3EditorWorkspace(): {
         fields: {
             value: number;
             id: string;
-            unit: import("./v3-graph-types.ts").V3Unit;
+            unit: import("./graph-types.ts").FigureUnit;
             min: number;
             max: number;
             role?: "design" | "state";
         }[];
-        geometry: import("./v3-asset-types.ts").V3AssetGeometry[];
-        bindings: import("./v3-asset-types.ts").V3EvaluatedBinding[];
+        geometry: import("./asset-types.ts").FigureAssetGeometry[];
+        bindings: import("./asset-types.ts").FigureEvaluatedBinding[];
         palette: Record<string, string>;
     };
+    /**
+     * What a command would do, seen before it is done (ADR-0097 §5.5): the same command on a copy, with the values the
+     * author is looking at. No revision, no history, no clip, no consent is touched; the answer names the figure and
+     * version it was worked out on, so the caller drops it once either has moved on.
+     */
+    previewCommand({ context, action }: {
+        context: string;
+        action: FigureAuthoringAction;
+    }): {
+        asset: FigureAsset;
+        geometry: unknown[];
+        moves: import("./command-preview.ts").FigureBodyMove[];
+        added: string[];
+        clipsWouldGo: import("./clip-keeping.ts").FigureClipLoss[];
+        context: string;
+        revision: number;
+    };
     /**
      * An AI proposal -- the modeller's own commands in a list (ADR-0094) -- as one step of the history: accepted, it is
      * undone whole. Refused at any step, nothing of it is kept, as a refused command keeps nothing.
      */
-    applyProposal({ context, steps, ...q }: V3EditControl & {
+    applyProposal({ context, steps, ...q }: FigureEditControl & {
         context: string;
-        steps: readonly V3ProposalStep[];
+        steps: readonly FigureProposalStep[];
     }): {
         context: null;
         name: null;
@@ -367,16 +393,16 @@ export declare function createV3EditorWorkspace(): {
         fields: {
             value: number;
             id: string;
-            unit: import("./v3-graph-types.ts").V3Unit;
+            unit: import("./graph-types.ts").FigureUnit;
             min: number;
             max: number;
             role?: "design" | "state";
         }[];
-        geometry: import("./v3-asset-types.ts").V3AssetGeometry[];
-        bindings: import("./v3-asset-types.ts").V3EvaluatedBinding[];
+        geometry: import("./asset-types.ts").FigureAssetGeometry[];
+        bindings: import("./asset-types.ts").FigureEvaluatedBinding[];
         palette: Record<string, string>;
     };
-    undo({ context, ...q }: V3EditControl & {
+    undo({ context, ...q }: FigureEditControl & {
         context: string;
     }): {
         context: null;
@@ -399,16 +425,16 @@ export declare function createV3EditorWorkspace(): {
         fields: {
             value: number;
             id: string;
-            unit: import("./v3-graph-types.ts").V3Unit;
+            unit: import("./graph-types.ts").FigureUnit;
             min: number;
             max: number;
             role?: "design" | "state";
         }[];
-        geometry: import("./v3-asset-types.ts").V3AssetGeometry[];
-        bindings: import("./v3-asset-types.ts").V3EvaluatedBinding[];
+        geometry: import("./asset-types.ts").FigureAssetGeometry[];
+        bindings: import("./asset-types.ts").FigureEvaluatedBinding[];
         palette: Record<string, string>;
     };
-    redo({ context, ...q }: V3EditControl & {
+    redo({ context, ...q }: FigureEditControl & {
         context: string;
     }): {
         context: null;
@@ -431,20 +457,20 @@ export declare function createV3EditorWorkspace(): {
         fields: {
             value: number;
             id: string;
-            unit: import("./v3-graph-types.ts").V3Unit;
+            unit: import("./graph-types.ts").FigureUnit;
             min: number;
             max: number;
             role?: "design" | "state";
         }[];
-        geometry: import("./v3-asset-types.ts").V3AssetGeometry[];
-        bindings: import("./v3-asset-types.ts").V3EvaluatedBinding[];
+        geometry: import("./asset-types.ts").FigureAssetGeometry[];
+        bindings: import("./asset-types.ts").FigureEvaluatedBinding[];
         palette: Record<string, string>;
     };
     export({ context, captureStateDefaults }: {
         context: string;
         captureStateDefaults?: boolean;
-    }): V3WorkspaceExport;
-    acknowledgeSaved({ context, revision, text }: V3WorkspaceExport): {
+    }): FigureWorkspaceExport;
+    acknowledgeSaved({ context, revision, text }: FigureWorkspaceExport): {
         context: null;
         name: null;
         fields: never[];
@@ -465,16 +491,16 @@ export declare function createV3EditorWorkspace(): {
         fields: {
             value: number;
             id: string;
-            unit: import("./v3-graph-types.ts").V3Unit;
+            unit: import("./graph-types.ts").FigureUnit;
             min: number;
             max: number;
             role?: "design" | "state";
         }[];
-        geometry: import("./v3-asset-types.ts").V3AssetGeometry[];
-        bindings: import("./v3-asset-types.ts").V3EvaluatedBinding[];
+        geometry: import("./asset-types.ts").FigureAssetGeometry[];
+        bindings: import("./asset-types.ts").FigureEvaluatedBinding[];
         palette: Record<string, string>;
     };
 };
-export type V3EditorWorkspace = ReturnType<typeof createV3EditorWorkspace>;
-export type V3WorkspaceView = ReturnType<V3EditorWorkspace['read']>;
-//# sourceMappingURL=v3-editor-workspace.d.ts.map
+export type FigureEditorWorkspace = ReturnType<typeof createFigureEditorWorkspace>;
+export type FigureWorkspaceView = ReturnType<FigureEditorWorkspace['read']>;
+//# sourceMappingURL=editor-workspace.d.ts.map

package/dist/editor-workspace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor-workspace.d.ts","sourceRoot":"","sources":["../src/editor-workspace.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAElF,OAAO,KAAK,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAA;AAG7E,OAAO,EAAuB,KAAK,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAC5E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAA;AACnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AACpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAEnD,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;CACb;AACD,MAAM,WAAW,kBAAkB;IACjC,oBAAoB,CAAC,EAAE,OAAO,CAAA;CAC/B;AACD;;;;GAIG;AACH,MAAM,WAAW,iBAAkB,SAAQ,kBAAkB;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAeD,+FAA+F;AAC/F,wBAAgB,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;eA8D5B,MAAM,uCAA8C,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qCAkBxC,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;+BAM/B,iBAAiB,GAAG;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6BAGzC,iBAAiB,GAAG;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mCAOjC,iBAAiB,GAAG;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,iBAAiB,CAAA;KAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0CAQxD,iBAAiB,GAAG;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,uBAAuB,CAAA;KAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAQ5G,0GAA0G;sCACxE,iBAAiB,GAAG;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,cAAc,CAAA;KAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAgB/F;;;;;;;;OAQG;uCACgC,iBAAiB,GAAG;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,qBAAqB,CAAA;KAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAWzG;;;;OAIG;wCACiC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,qBAAqB,CAAA;KAAE;;;;;;;;;IAKtF;;;OAGG;4CACqC,iBAAiB,GAAG;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,SAAS,kBAAkB,EAAE,CAAA;KAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4BAW7F,iBAAiB,GAAG;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4BAavC,iBAAiB,GAAG;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8CAgB5D;QACD,OAAO,EAAE,MAAM,CAAA;QACf,oBAAoB,CAAC,EAAE,OAAO,CAAA;KAC/B,GAAG,qBAAqB;kDAQqB,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgBtE;AACD,MAAM,MAAM,qBAAqB,GAAG,UAAU,CAAC,OAAO,2BAA2B,CAAC,CAAA;AAClF,MAAM,MAAM,mBAAmB,GAAG,UAAU,CAAC,qBAAqB,CAAC,MAAM,CAAC,CAAC,CAAA"}

package/dist/{v3-editor-workspace.js → editor-workspace.js}

@@ -1,15 +1,16 @@
-import { parseV3Asset, serializeV3Asset, compileV3Asset, captureV3AuthoredInputs } from "./v3-asset.js";
-import { createV3AuthoringSession } from "./v3-authoring-session.js";
-import { addV3Box, addV3Primitive } from "./v3-create.js";
-import { editV3Part, removePart } from "./v3-part-edit.js";
-import { applyV3Authoring } from "./v3-authoring-actions.js";
-import { applyV3Proposal } from "./v3-proposal.js";
-import { V3ContractError } from "./v3-contract.js";
+import { previewFigureCommand } from "./command-preview.js";
+import { parseFigureAsset, serializeFigureAsset, compileFigureAsset, captureFigureAuthoredInputs } from "./asset.js";
+import { createFigureAuthoringSession } from "./authoring-session.js";
+import { addFigureBox, addFigurePrimitive } from "./create.js";
+import { editFigurePart, removePart } from "./part-edit.js";
+import { applyFigureAuthoring } from "./authoring-actions.js";
+import { applyFigureProposal } from "./proposal.js";
+import { FigureContractError } from "./contract.js";
 function fail(code, message) {
-    throw new V3ContractError(code, 'workspace', message);
+    throw new FigureContractError(code, 'workspace', message);
 }
 /** One history for structural and input edits. No persistence or authentication is implied. */
-export function createV3EditorWorkspace() {
+export function createFigureEditorWorkspace() {
     let active = null, epoch = 0;
     function current(context) {
         if (!active || active.context !== context)
@@ -19,13 +20,16 @@ export function createV3EditorWorkspace() {
     function control(a, q) {
         if (!['ui', 'ai'].includes(q.origin))
             fail('EDIT_ORIGIN', 'ui or ai required');
+        /* Only the person may let a clip go: an AI request carrying a consent is refused whole, whatever it asks (designer 2026-09-27). */
+        if (q.origin === 'ai' && q.dropClips !== undefined)
+            fail('CONSENT_ORIGIN', 'an AI request cannot agree to let clips go');
         if (!Number.isSafeInteger(q.expectedRevision) || q.expectedRevision < 0)
             fail('EDIT_REVISION', 'nonnegative integer required');
         if (q.expectedRevision !== a.revision)
             fail('REVISION_CONFLICT', 'editor changed since request');
     }
     function dirty() {
-        return !!active && serializeV3Asset(active.asset) !== serializeV3Asset(active.baseline);
+        return !!active && serializeFigureAsset(active.asset) !== serializeFigureAsset(active.baseline);
     }
     function leave(discard) {
         if (dirty() && !discard)
@@ -33,7 +37,7 @@ export function createV3EditorWorkspace() {
     }
     const snapshot = (a) => structuredClone({ asset: a.asset, inputs: a.inputs });
     function validate(s) {
-        compileV3Asset(captureV3AuthoredInputs(s.asset, s.inputs, { captureStateDefaults: true })).evaluate();
+        compileFigureAsset(captureFigureAuthoredInputs(s.asset, s.inputs, { captureStateDefaults: true })).evaluate();
     }
     function install(a, next) {
         validate(next);
@@ -48,7 +52,7 @@ export function createV3EditorWorkspace() {
     function read() {
         if (!active)
             return { context: null, name: null, fields: [], geometry: [], bindings: [], dirty: false, revision: null };
-        const a = active, rendered = compileV3Asset(captureV3AuthoredInputs(a.asset, a.inputs, { captureStateDefaults: true })).evaluate();
+        const a = active, rendered = compileFigureAsset(captureFigureAuthoredInputs(a.asset, a.inputs, { captureStateDefaults: true })).evaluate();
         return {
             context: a.context,
             name: a.asset.name,
@@ -64,21 +68,23 @@ export function createV3EditorWorkspace() {
     }
     function candidate(a, q) {
         control(a, q);
-        const session = createV3AuthoringSession(a.asset.document, a.inputs);
+        const session = createFigureAuthoringSession(a.asset.document, a.inputs);
         const report = session.preview({ ...q, expectedRevision: 0 });
         report.baseRevision = a.revision;
         return report;
     }
     return {
         read,
-        open(text, { discardDesignChanges = false } = {}) {
+        open(text, { discardDesignChanges = false, baseline } = {}) {
             leave(discardDesignChanges);
-            const asset = parseV3Asset(text), inputs = { ...asset.designInputs, ...asset.stateDefaults };
+            const asset = parseFigureAsset(text), inputs = { ...asset.designInputs, ...asset.stateDefaults };
             validate({ asset, inputs });
+            /* Parsed before anything is replaced: a baseline that is not a figure opens nothing. */
+            const saved = baseline === undefined ? structuredClone(asset) : parseFigureAsset(baseline);
             active = {
                 asset,
                 inputs,
-                baseline: structuredClone(asset),
+                baseline: saved,
                 revision: 0,
                 context: `asset-context-${++epoch}`,
                 undo: [],
@@ -98,20 +104,20 @@ export function createV3EditorWorkspace() {
         apply({ context, ...q }) {
             const a = current(context), c = candidate(a, q);
             if (c.changes.length)
-                install(a, { asset: captureV3AuthoredInputs(a.asset, c.candidate.inputs), inputs: c.candidate.inputs });
+                install(a, { asset: captureFigureAuthoredInputs(a.asset, c.candidate.inputs), inputs: c.candidate.inputs });
             return read();
         },
         addBox({ context, box, ...q }) {
             const a = current(context);
             control(a, q);
-            const asset = addV3Box(a.asset, box), inputs = { ...asset.designInputs, ...asset.stateDefaults, ...a.inputs };
+            const asset = addFigureBox(a.asset, box), inputs = { ...asset.designInputs, ...asset.stateDefaults, ...a.inputs };
             install(a, { asset, inputs });
             return read();
         },
         addPrimitive({ context, part, ...q }) {
             const a = current(context);
             control(a, q);
-            const asset = addV3Primitive(a.asset, part), inputs = { ...asset.designInputs, ...asset.stateDefaults, ...a.inputs };
+            const asset = addFigurePrimitive(a.asset, part), inputs = { ...asset.designInputs, ...asset.stateDefaults, ...a.inputs };
             install(a, { asset, inputs });
             return read();
         },
@@ -119,9 +125,9 @@ export function createV3EditorWorkspace() {
         editPart({ context, edit, ...q }) {
             const a = current(context);
             control(a, q);
-            const removed = edit.kind === 'remove-part' ? removePart(a.asset, edit) : undefined;
-            const asset = removed ? removed.asset : editV3Part(a.asset, edit);
-            if (serializeV3Asset(asset) !== serializeV3Asset(a.asset)) {
+            const removed = edit.kind === 'remove-part' ? removePart(a.asset, edit, q) : undefined;
+            const asset = removed ? removed.asset : editFigurePart(a.asset, edit, q);
+            if (serializeFigureAsset(asset) !== serializeFigureAsset(a.asset)) {
                 const inputs = Object.fromEntries(asset.document.model.inputs.map(i => [
                     i.id,
                     a.inputs[i.id] ?? asset.designInputs[i.id] ?? asset.stateDefaults[i.id]
@@ -137,17 +143,27 @@ export function createV3EditorWorkspace() {
          * The command sees the values the author is looking at: the live inputs are captured into the asset
          * first, so "fasten this to that" reads the part where it stands now, not where it stood when the model
          * was opened. A refused command leaves history, revision and the asset as they were, the same as an
-         * input edit that fails validation (`applyV3Authoring` clones and throws before anything is written).
+         * input edit that fails validation (`applyFigureAuthoring` clones and throws before anything is written).
          */
         command({ context, action, ...q }) {
             const a = current(context);
             control(a, q);
-            const seen = captureV3AuthoredInputs(a.asset, a.inputs, { captureStateDefaults: true });
-            const asset = applyV3Authoring(seen, action);
+            const seen = captureFigureAuthoredInputs(a.asset, a.inputs, { captureStateDefaults: true });
+            const asset = applyFigureAuthoring(seen, action, q);
             const inputs = Object.fromEntries(asset.document.model.inputs.map(i => [i.id, asset.designInputs[i.id] ?? asset.stateDefaults[i.id]]));
             install(a, { asset, inputs });
             return read();
         },
+        /**
+         * What a command would do, seen before it is done (ADR-0097 §5.5): the same command on a copy, with the values the
+         * author is looking at. No revision, no history, no clip, no consent is touched; the answer names the figure and
+         * version it was worked out on, so the caller drops it once either has moved on.
+         */
+        previewCommand({ context, action }) {
+            const a = current(context);
+            const seen = captureFigureAuthoredInputs(a.asset, a.inputs, { captureStateDefaults: true });
+            return { context, revision: a.revision, ...previewFigureCommand(seen, action, a.inputs) };
+        },
         /**
          * An AI proposal -- the modeller's own commands in a list (ADR-0094) -- as one step of the history: accepted, it is
          * undone whole. Refused at any step, nothing of it is kept, as a refused command keeps nothing.
@@ -155,8 +171,8 @@ export function createV3EditorWorkspace() {
         applyProposal({ context, steps, ...q }) {
             const a = current(context);
             control(a, q);
-            const seen = captureV3AuthoredInputs(a.asset, a.inputs, { captureStateDefaults: true });
-            const asset = applyV3Proposal(seen, steps);
+            const seen = captureFigureAuthoredInputs(a.asset, a.inputs, { captureStateDefaults: true });
+            const asset = applyFigureProposal(seen, steps, q);
             const inputs = Object.fromEntries(asset.document.model.inputs.map(i => [i.id, asset.designInputs[i.id] ?? asset.stateDefaults[i.id]]));
             install(a, { asset, inputs });
             return read();
@@ -194,16 +210,16 @@ export function createV3EditorWorkspace() {
             return {
                 context,
                 revision: a.revision,
-                text: serializeV3Asset(captureV3AuthoredInputs(a.asset, a.inputs, { captureStateDefaults }))
+                text: serializeFigureAsset(captureFigureAuthoredInputs(a.asset, a.inputs, { captureStateDefaults }))
             };
         },
         acknowledgeSaved({ context, revision, text }) {
             const a = current(context);
             if (revision !== a.revision)
                 fail('REVISION_CONFLICT', 'edited since export');
-            const saved = parseV3Asset(text), ordinary = captureV3AuthoredInputs(a.asset, a.inputs), withPose = captureV3AuthoredInputs(a.asset, a.inputs, { captureStateDefaults: true });
-            if (serializeV3Asset(saved) !== serializeV3Asset(ordinary) &&
-                serializeV3Asset(saved) !== serializeV3Asset(withPose))
+            const saved = parseFigureAsset(text), ordinary = captureFigureAuthoredInputs(a.asset, a.inputs), withPose = captureFigureAuthoredInputs(a.asset, a.inputs, { captureStateDefaults: true });
+            if (serializeFigureAsset(saved) !== serializeFigureAsset(ordinary) &&
+                serializeFigureAsset(saved) !== serializeFigureAsset(withPose))
                 fail('SAVE_MISMATCH', 'acknowledgement does not match current asset');
             a.asset = saved;
             a.baseline = structuredClone(saved);
@@ -211,4 +227,4 @@ export function createV3EditorWorkspace() {
         }
     };
 }
-//# sourceMappingURL=v3-editor-workspace.js.map
+//# sourceMappingURL=editor-workspace.js.map

package/dist/editor-workspace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor-workspace.js","sourceRoot":"","sources":["../src/editor-workspace.ts"],"names":[],"mappings":"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"}

package/dist/{v3-examples.d.ts → examples.d.ts}

@@ -1,6 +1,6 @@
-import { type V3PrimitiveCreation } from './v3-create.ts';
-import type { V3Asset } from './v3-asset-types.ts';
-type Part = V3PrimitiveCreation;
+import { type FigurePrimitiveCreation } from './create.ts';
+import type { FigureAsset } from './asset-types.ts';
+type Part = FigurePrimitiveCreation;
 /** The chain, from the floor up: each part's bottom on the top of the one before. */
 export declare const ROBOT_ARM_CHAIN: {
     part: Part;
@@ -16,6 +16,6 @@ export declare const ROBOT_ARM_CHAIN: {
  * A six-axis arm: each link joined to the one before at a joint, which is the one relation the arm needs; every size is
  * the part's own number. The room it takes is worked out.
  */
-export declare function robotArmV3(): V3Asset;
+export declare function robotArmFigure(): FigureAsset;
 export {};
-//# sourceMappingURL=v3-examples.d.ts.map
+//# sourceMappingURL=examples.d.ts.map

package/dist/examples.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"examples.d.ts","sourceRoot":"","sources":["../src/examples.ts"],"names":[],"mappings":"AAKA,OAAO,EAAyC,KAAK,uBAAuB,EAAE,MAAM,aAAa,CAAA;AACjG,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAEnD,KAAK,IAAI,GAAG,uBAAuB,CAAA;AAMnC,qFAAqF;AACrF,eAAO,MAAM,eAAe,EAAE;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,KAAK,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,GAAG,GAAG,GAAG,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,IAAI,CAAA;KAAE,CAAA;CAAE,EAWjI,CAAA;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI,WAAW,CAqB5C"}