@things-factory/figure-ui 10.1.35 → 10.1.37

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

@@ -0,0 +1,366 @@
+import { type V3InputChange, type V3PrimitiveCreation, type V3PartEdit } from '@hatiolab/figure-model';
+export interface V3ProductRecord {
+    id: string;
+    source: string;
+}
+/** Persistence is injected; neither the model engine nor the renderer owns the product ID. */
+export interface V3ProductStore {
+    load(id: string): Promise<V3ProductRecord>;
+    save(request: {
+        id?: string;
+        source: string;
+        expectedSource?: string;
+        creationId?: string;
+    }): Promise<V3ProductRecord>;
+}
+/** Product lifecycle boundary. A late response can never change another editor's asset or ID. */
+export declare function createV3ProductSession(store: V3ProductStore): {
+    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").V3Unit;
+            min: number;
+            max: number;
+            role?: "design" | "state";
+        }[];
+        geometry: import("@hatiolab/figure-model").V3AssetGeometry[];
+        bindings: import("@hatiolab/figure-model").V3EvaluatedBinding[];
+        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").V3Unit;
+            min: number;
+            max: number;
+            role?: "design" | "state";
+        }[];
+        geometry: import("@hatiolab/figure-model").V3AssetGeometry[];
+        bindings: import("@hatiolab/figure-model").V3EvaluatedBinding[];
+        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").V3Unit;
+            min: number;
+            max: number;
+            role?: "design" | "state";
+        }[];
+        geometry: import("@hatiolab/figure-model").V3AssetGeometry[];
+        bindings: import("@hatiolab/figure-model").V3EvaluatedBinding[];
+        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").V3Unit;
+            min: number;
+            max: number;
+            role?: "design" | "state";
+        }[];
+        geometry: import("@hatiolab/figure-model").V3AssetGeometry[];
+        bindings: import("@hatiolab/figure-model").V3EvaluatedBinding[];
+        palette: Record<string, string>;
+    };
+    apply(changes: V3InputChange[], 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").V3Unit;
+            min: number;
+            max: number;
+            role?: "design" | "state";
+        }[];
+        geometry: import("@hatiolab/figure-model").V3AssetGeometry[];
+        bindings: import("@hatiolab/figure-model").V3EvaluatedBinding[];
+        palette: Record<string, string>;
+    };
+    add(part: V3PrimitiveCreation): {
+        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").V3Unit;
+            min: number;
+            max: number;
+            role?: "design" | "state";
+        }[];
+        geometry: import("@hatiolab/figure-model").V3AssetGeometry[];
+        bindings: import("@hatiolab/figure-model").V3EvaluatedBinding[];
+        palette: Record<string, string>;
+    };
+    edit(edit: V3PartEdit): {
+        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").V3Unit;
+            min: number;
+            max: number;
+            role?: "design" | "state";
+        }[];
+        geometry: import("@hatiolab/figure-model").V3AssetGeometry[];
+        bindings: import("@hatiolab/figure-model").V3EvaluatedBinding[];
+        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").V3Unit;
+            min: number;
+            max: number;
+            role?: "design" | "state";
+        }[];
+        geometry: import("@hatiolab/figure-model").V3AssetGeometry[];
+        bindings: import("@hatiolab/figure-model").V3EvaluatedBinding[];
+        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").V3Unit;
+            min: number;
+            max: number;
+            role?: "design" | "state";
+        }[];
+        geometry: import("@hatiolab/figure-model").V3AssetGeometry[];
+        bindings: import("@hatiolab/figure-model").V3EvaluatedBinding[];
+        palette: Record<string, string>;
+    };
+    source(): string;
+    save(): 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").V3Unit;
+            min: number;
+            max: number;
+            role?: "design" | "state";
+        }[];
+        geometry: import("@hatiolab/figure-model").V3AssetGeometry[];
+        bindings: import("@hatiolab/figure-model").V3EvaluatedBinding[];
+        palette: Record<string, string>;
+    }>;
+};
+export type V3ProductSession = ReturnType<typeof createV3ProductSession>;

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

@@ -0,0 +1,130 @@
+import { createV3Asset, createV3EditorWorkspace, serializeV3Asset, parseV3Asset } from '@hatiolab/figure-model';
+/** Product lifecycle boundary. A late response can never change another editor's asset or ID. */
+export function createV3ProductSession(store) {
+    const workspace = createV3EditorWorkspace();
+    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(serializeV3Asset(createV3Asset('새 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
+            });
+        },
+        add(part) {
+            return workspace.addPrimitive({ ...writable(), part });
+        },
+        edit(edit) {
+            return workspace.editPart({ ...writable(), edit });
+        },
+        undo() {
+            return workspace.undo(writable());
+        },
+        redo() {
+            return workspace.redo(writable());
+        },
+        source() {
+            const { context } = writable();
+            return workspace.export({ context }).text;
+        },
+        async save() {
+            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 });
+                if (requestEpoch !== epoch)
+                    return read();
+                if (!record.id || (id !== undefined && record.id !== id))
+                    throw Error('저장 응답의 Figure 대상이 다릅니다.');
+                if (serializeV3Asset(parseV3Asset(record.source)) !== exported.text)
+                    throw Error('저장 응답이 보낸 모델과 다릅니다. 저장 상태를 다시 확인해 주세요.');
+                workspace.acknowledgeSaved(exported);
+                id = record.id;
+                baseline = record.source;
+            }
+            finally {
+                if (requestEpoch === epoch)
+                    saving = false;
+            }
+            return read();
+        }
+    };
+}
+//# sourceMappingURL=v3-product-session.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"v3-product-session.js","sourceRoot":"","sources":["../../client/modeller/v3-product-session.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  createV3Asset,\n  createV3EditorWorkspace,\n  serializeV3Asset,\n  parseV3Asset,\n  type V3InputChange,\n  type V3PrimitiveCreation,\n  type V3PartEdit\n} from '@hatiolab/figure-model'\n\nexport interface V3ProductRecord {\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 V3ProductStore {\n  load(id: string): Promise<V3ProductRecord>\n  save(request: { id?: string; source: string; expectedSource?: string; creationId?: string }): Promise<V3ProductRecord>\n}\n\n/** Product lifecycle boundary. A late response can never change another editor's asset or ID. */\nexport function createV3ProductSession(store: V3ProductStore) {\n  const workspace = createV3EditorWorkspace()\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(serializeV3Asset(createV3Asset('새 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: V3InputChange[], 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    add(part: V3PrimitiveCreation) {\n      return workspace.addPrimitive({ ...writable(), part })\n    },\n    edit(edit: V3PartEdit) {\n      return workspace.editPart({ ...writable(), edit })\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    async save() {\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 })\n        if (requestEpoch !== epoch) return read()\n        if (!record.id || (id !== undefined && record.id !== id)) throw Error('저장 응답의 Figure 대상이 다릅니다.')\n        if (serializeV3Asset(parseV3Asset(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 V3ProductSession = ReturnType<typeof createV3ProductSession>\n"]}

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

@@ -0,0 +1,26 @@
+import { PageView } from '@operato/shell';
+import '../modeller/v3-editor.js';
+/** The V3 product page has exactly one authoritative workspace for UI and AI input transactions. */
+export declare class FigureV3ModellerPage extends PageView {
+    static styles: import("lit").CSSResult;
+    private readonly session;
+    private routeId;
+    private discardApproved;
+    private revision;
+    private error;
+    private announce;
+    private changed;
+    /** The dock must explicitly use this checked transaction contract, never an unversioned overwrite. */
+    private applyAI;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    canDeactivate(): Promise<boolean>;
+    pageUpdated(changes: Record<string, unknown>, lifecycle: {
+        resourceId?: string;
+    }): Promise<void>;
+    get context(): {
+        title: string;
+        actions: never[];
+    };
+    render(): import("lit-html").TemplateResult<1>;
+}

package/dist-client/pages/figure-v3-modeller-page.js

@@ -0,0 +1,140 @@
+import { __decorate, __metadata } from "tslib";
+import { html, css } from 'lit';
+import { customElement, state } from 'lit/decorators.js';
+import { PageView } from '@operato/shell';
+import { createV3ProductSession } from '../modeller/v3-product-session.js';
+import { v3ProductStore } from '../graphql/v3-store.js';
+import '../modeller/v3-editor.js';
+/** The V3 product page has exactly one authoritative workspace for UI and AI input transactions. */
+let FigureV3ModellerPage = class FigureV3ModellerPage extends PageView {
+    constructor() {
+        super(...arguments);
+        this.session = createV3ProductSession(v3ProductStore);
+        this.discardApproved = false;
+        this.revision = 0;
+        this.error = '';
+        this.announce = () => {
+            const view = this.session.read();
+            if (!this.active || view.loading || view.saving || view.error || !view.context)
+                return;
+            window.dispatchEvent(new CustomEvent('figure-ai-context', {
+                detail: {
+                    figureId: view.id,
+                    source: JSON.parse(this.session.source()),
+                    context: view.context,
+                    revision: view.revision,
+                    format: 'v3'
+                }
+            }));
+        };
+        this.changed = () => {
+            this.revision++;
+            if (!this.session.read().saving)
+                this.announce();
+        };
+        /** The dock must explicitly use this checked transaction contract, never an unversioned overwrite. */
+        this.applyAI = (event) => {
+            const detail = event.detail;
+            if (!this.active || !detail)
+                return;
+            try {
+                this.session.apply(detail.changes, 'ai', detail.revision, detail.context);
+                detail.applied = true;
+                this.changed();
+            }
+            catch (error) {
+                detail.applied = false;
+                detail.error = error instanceof Error ? error.message : String(error);
+            }
+        };
+    }
+    static { this.styles = css `
+    :host {
+      display: flex;
+      flex-direction: column;
+      height: 100%;
+      min-height: 0;
+    }
+    figure-v3-editor {
+      flex: 1;
+      min-height: 0;
+    }
+    .error {
+      padding: 16px;
+      color: #922716;
+    }
+  `; }
+    connectedCallback() {
+        super.connectedCallback();
+        window.addEventListener('figure-ai-context-request', this.announce);
+        window.addEventListener('figure-v3-apply', this.applyAI);
+    }
+    disconnectedCallback() {
+        window.removeEventListener('figure-ai-context-request', this.announce);
+        window.removeEventListener('figure-v3-apply', this.applyAI);
+        super.disconnectedCallback();
+    }
+    async canDeactivate() {
+        const view = this.session.read();
+        if (view.saving)
+            return false;
+        if (!view.dirty)
+            return true;
+        // The shell invokes this while the edited model is still visible, before navigating away.
+        this.discardApproved = window.confirm('저장하지 않은 변경을 버리고 이동하시겠습니까?');
+        return this.discardApproved;
+    }
+    async pageUpdated(changes, lifecycle) {
+        if (!this.active) {
+            if (this.session.read().loading)
+                this.session.close();
+            window.dispatchEvent(new CustomEvent('figure-ai-context', { detail: undefined }));
+            return;
+        }
+        const id = lifecycle?.resourceId;
+        if (this.session.read().context && id === this.routeId && !changes.active)
+            return;
+        try {
+            const discard = this.discardApproved;
+            this.discardApproved = false;
+            if (id) {
+                const opening = this.session.open(id, { discard });
+                this.changed();
+                await opening;
+            }
+            else
+                this.session.startNew({ discard });
+            this.routeId = id;
+            this.error = '';
+            this.changed();
+        }
+        catch (error) {
+            this.error = error instanceof Error ? error.message : String(error);
+        }
+    }
+    get context() {
+        return { title: this.session.read().name ?? 'Figure', actions: [] };
+    }
+    render() {
+        return this.error
+            ? html `<p role="alert" class="error">${this.error}</p>`
+            : html `<figure-v3-editor
+          .session=${this.session}
+          .revision=${this.revision}
+          @v3-changed=${this.changed}
+        ></figure-v3-editor>`;
+    }
+};
+__decorate([
+    state(),
+    __metadata("design:type", Object)
+], FigureV3ModellerPage.prototype, "revision", void 0);
+__decorate([
+    state(),
+    __metadata("design:type", Object)
+], FigureV3ModellerPage.prototype, "error", void 0);
+FigureV3ModellerPage = __decorate([
+    customElement('figure-modeller-page')
+], FigureV3ModellerPage);
+export { FigureV3ModellerPage };
+//# sourceMappingURL=figure-v3-modeller-page.js.map