@hatiolab/figure-model 0.1.30 → 0.1.32

package/dist/v3-create.js

@@ -0,0 +1,151 @@
+import { compileV3Asset } from "./v3-asset.js";
+import { V3ContractError } from "./v3-contract.js";
+/** New assets start empty. A box is created only by an explicit authoring action. */
+export function createV3Asset(name) {
+    const asset = {
+        version: 'figure-v3-asset-experiment-1',
+        name,
+        document: {
+            version: 'figure-v3-prototype-1',
+            model: { version: 'r3-spatial-1', inputs: [], constants: [], nodes: [] },
+            capabilities: { version: 'r3-capability-3', assetFrame: 'asset', bindings: [] }
+        },
+        designInputs: {},
+        stateDefaults: {},
+        palette: { 'palette.primary': '#477b9e' },
+        appearance: []
+    };
+    compileV3Asset(asset);
+    return asset;
+}
+/** Authoring recipes use existing providers; they introduce no extra evaluation rules. */
+export function addV3Primitive(source, part) {
+    const recipes = {
+        box: { op: 'box-shape@1', keys: ['width', 'height', 'depth'] },
+        cylinder: { op: 'cylinder-shape@1', keys: ['radius', 'length'] },
+        'rounded-box': { op: 'rounded-box@1', keys: ['width', 'height', 'depth', 'round'] },
+        portal: {
+            op: 'portal-profile@1',
+            keys: ['left', 'right', 'bottom', 'top', 'openingLeft', 'openingRight', 'openingTop', 'depth']
+        }
+    };
+    if (!part || !Object.hasOwn(recipes, part.kind))
+        throw new V3ContractError('PROVIDER', 'part', 'unknown primitive');
+    const recipe = recipes[part.kind];
+    if (!part.dimensions ||
+        Object.keys(part.dimensions).length !== recipe.keys.length ||
+        recipe.keys.some(k => !Object.hasOwn(part.dimensions, k)))
+        throw new V3ContractError('SCHEMA', part.id, 'provider dimensions must match declared fields');
+    const asset = addV3Box(source, {
+        id: part.id,
+        size: { x: 1, y: 1, z: 1 },
+        position: part.position,
+        ...(part.rotation ? { rotation: part.rotation } : {}),
+        ...(part.material ? { material: part.material } : {})
+    });
+    const model = asset.document.model, removed = new Set(['x', 'y', 'z'].map(a => part.id + '.size.' + a));
+    model.inputs = model.inputs.filter(i => !removed.has(i.id));
+    for (const id of removed)
+        delete asset.designInputs[id];
+    const shape = model.nodes.find(n => n.id === part.id + '.shape');
+    shape.op = recipe.op;
+    shape.args = [];
+    const existing = new Set([
+        ...model.inputs.map(i => i.id),
+        ...model.constants.map(c => c.id),
+        ...model.nodes.flatMap(n => [n.id, ...Object.values(n.outputs)])
+    ]);
+    for (const key of recipe.keys) {
+        const id = part.id + '.dimension.' + key, value = part.dimensions[key];
+        if (existing.has(id))
+            throw new V3ContractError('DUPLICATE_WRITER', id, 'input already exists');
+        if (!Number.isFinite(value))
+            throw new V3ContractError('NON_FINITE', id, 'finite dimension required');
+        model.inputs.push({ id, unit: 'mm', min: -Number.MAX_VALUE, max: Number.MAX_VALUE, role: 'design' });
+        asset.designInputs[id] = value;
+        shape.args.push(id);
+    }
+    if (part.kind === 'cylinder')
+        asset.appearance.find(a => a.target === part.id).segments = 12;
+    compileV3Asset(asset);
+    return asset;
+}
+/** Pure authoring operation. Expands to standard graph operators, not a second runtime geometry model. */
+export function addV3Box(source, box) {
+    compileV3Asset(source);
+    if (!box || typeof box.id !== 'string' || !/^[a-zA-Z][a-zA-Z0-9_-]*$/.test(box.id)) {
+        throw new V3ContractError('ID', 'box', 'letter-led part ID required');
+    }
+    const asset = structuredClone(source), model = asset.document.model, prefix = box.id;
+    const keys = [
+        'size.x',
+        'size.y',
+        'size.z',
+        'position.x',
+        'position.y',
+        'position.z',
+        'rotation.x',
+        'rotation.y',
+        'rotation.z'
+    ];
+    const reserved = new Set([
+        prefix,
+        `${prefix}.shape`,
+        `${prefix}.shapeValue`,
+        `${prefix}.pose`,
+        `${prefix}.poseValue`,
+        `${prefix}.placed`,
+        ...keys.map(k => `${prefix}.${k}`)
+    ]);
+    const existing = [
+        ...model.inputs.map(i => i.id),
+        ...model.constants.map(c => c.id),
+        ...model.nodes.flatMap(n => [n.id, ...Object.values(n.outputs)])
+    ];
+    if (existing.some(id => reserved.has(id)))
+        throw new V3ContractError('DUPLICATE_PART', prefix, 'part IDs overlap existing graph identifiers');
+    const rotation = box.rotation ?? { x: 0, y: 0, z: 0 };
+    for (const group of ['size', 'position', 'rotation']) {
+        const values = group === 'rotation' ? rotation : box[group];
+        if (!values || Object.keys(values).length !== 3)
+            throw new V3ContractError('SCHEMA', prefix, `${group} requires x, y, z`);
+        for (const axis of ['x', 'y', 'z']) {
+            const value = values[axis];
+            if (!Number.isFinite(value) || (group === 'size' && value <= 0))
+                throw new V3ContractError('GEOMETRY_DOMAIN', `${prefix}.${group}.${axis}`, 'finite value and positive size required');
+            const id = `${prefix}.${group}.${axis}`;
+            // These are broad authoring limits, not a rendering safety/performance guarantee.
+            model.inputs.push({
+                id,
+                unit: group === 'rotation' ? 'deg' : 'mm',
+                min: group === 'size' ? Number.MIN_VALUE : -Number.MAX_VALUE,
+                max: Number.MAX_VALUE,
+                role: 'design'
+            });
+            asset.designInputs[id] = value;
+        }
+    }
+    const local = `${prefix}.local`;
+    model.nodes.push({
+        id: `${prefix}.shape`,
+        op: 'box-shape@1',
+        args: keys.slice(0, 3).map(k => `${prefix}.${k}`),
+        outputs: { shape: `${prefix}.shapeValue` },
+        params: { frame: local }
+    }, {
+        id: `${prefix}.pose`,
+        op: 'rigid@1',
+        args: keys.slice(3).map(k => `${prefix}.${k}`),
+        outputs: { pose: `${prefix}.poseValue` },
+        params: { from: local, to: asset.document.capabilities.assetFrame }
+    }, {
+        id: prefix,
+        op: 'place@1',
+        args: [`${prefix}.shapeValue`, `${prefix}.poseValue`],
+        outputs: { placed: `${prefix}.placed` }
+    });
+    asset.appearance.push({ target: prefix, material: structuredClone(box.material ?? { token: 'palette.primary' }) });
+    compileV3Asset(asset);
+    return asset;
+}
+//# sourceMappingURL=v3-create.js.map

package/dist/v3-create.js.map

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

package/dist/v3-document.d.ts

@@ -0,0 +1,5 @@
+import type { V3Document, V3CompiledCapabilities } from './v3-asset-types.ts';
+export declare function compileV3Document(source: unknown): V3CompiledCapabilities;
+export declare function serializeV3Document(doc: unknown): string;
+export declare function parseV3Document(text: string): V3Document;
+//# sourceMappingURL=v3-document.d.ts.map

package/dist/v3-document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"v3-document.d.ts","sourceRoot":"","sources":["../src/v3-document.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAA;AAE7E,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,OAAO,GAAG,sBAAsB,CAmBzE;AACD,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAGxD;AACD,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAIxD"}

package/dist/v3-document.js

@@ -0,0 +1,31 @@
+import { compileV3Capabilities } from "./v3-capabilities.js";
+import { V3ContractError } from "./v3-contract.js";
+import { assertV3Json, parseV3Json, V3_JSON_MAX_BYTES, v3Utf8ByteLength } from "./v3-json.js";
+export function compileV3Document(source) {
+    assertV3Json(source);
+    if (!source ||
+        Array.isArray(source) ||
+        typeof source !== 'object' ||
+        Object.keys(source).length !== 3 ||
+        !['version', 'model', 'capabilities'].every(k => Object.hasOwn(source, k))) {
+        throw new V3ContractError('SCHEMA', 'document', 'expected version, model, capabilities only');
+    }
+    if (source.version !== 'figure-v3-prototype-1')
+        throw new V3ContractError('VERSION', 'document', 'unsupported document version');
+    if (v3Utf8ByteLength(JSON.stringify(source)) > V3_JSON_MAX_BYTES)
+        throw new V3ContractError('DOCUMENT_LIMIT', 'document', 'over 1 MiB');
+    const doc = source;
+    if (!Array.isArray(doc.model?.nodes) || doc.model.nodes.length > 512)
+        throw new V3ContractError('DOCUMENT_LIMIT', 'document', 'maximum 512 nodes');
+    return compileV3Capabilities(doc.model, doc.capabilities);
+}
+export function serializeV3Document(doc) {
+    compileV3Document(doc);
+    return JSON.stringify(doc);
+}
+export function parseV3Document(text) {
+    const doc = parseV3Json(text);
+    compileV3Document(doc);
+    return doc;
+}
+//# sourceMappingURL=v3-document.js.map

package/dist/v3-document.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"v3-document.js","sourceRoot":"","sources":["../src/v3-document.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAA;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAClD,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAG7F,MAAM,UAAU,iBAAiB,CAAC,MAAe;IAC/C,YAAY,CAAC,MAAM,CAAC,CAAA;IACpB,IACE,CAAC,MAAM;QACP,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QACrB,OAAO,MAAM,KAAK,QAAQ;QAC1B,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,KAAK,CAAC;QAChC,CAAC,CAAC,SAAS,EAAE,OAAO,EAAE,cAAc,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAC1E,CAAC;QACD,MAAM,IAAI,eAAe,CAAC,QAAQ,EAAE,UAAU,EAAE,4CAA4C,CAAC,CAAA;IAC/F,CAAC;IACD,IAAI,MAAM,CAAC,OAAO,KAAK,uBAAuB;QAC5C,MAAM,IAAI,eAAe,CAAC,SAAS,EAAE,UAAU,EAAE,8BAA8B,CAAC,CAAA;IAClF,IAAI,gBAAgB,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,GAAG,iBAAiB;QAC9D,MAAM,IAAI,eAAe,CAAC,gBAAgB,EAAE,UAAU,EAAE,YAAY,CAAC,CAAA;IACvE,MAAM,GAAG,GAAG,MAA+B,CAAA;IAC3C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,GAAG;QAClE,MAAM,IAAI,eAAe,CAAC,gBAAgB,EAAE,UAAU,EAAE,mBAAmB,CAAC,CAAA;IAC9E,OAAO,qBAAqB,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,YAAY,CAAC,CAAA;AAC3D,CAAC;AACD,MAAM,UAAU,mBAAmB,CAAC,GAAY;IAC9C,iBAAiB,CAAC,GAAG,CAAC,CAAA;IACtB,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAA;AAC5B,CAAC;AACD,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,MAAM,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,CAAA;IAC7B,iBAAiB,CAAC,GAAG,CAAC,CAAA;IACtB,OAAO,GAA4B,CAAA;AACrC,CAAC"}

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

@@ -0,0 +1,367 @@
+import type { V3EditRequest, V3EditControl } from './v3-authoring-session.ts';
+import type { V3BoxCreation, V3PrimitiveCreation } from './v3-create.ts';
+import type { V3PartEdit } from './v3-part-edit.ts';
+export interface V3WorkspaceExport {
+    context: string;
+    revision: number;
+    text: string;
+}
+export interface V3LeaveOptions {
+    discardDesignChanges?: boolean;
+}
+/** One history for structural and input edits. No persistence or authentication is implied. */
+export declare function createV3EditorWorkspace(): {
+    read: () => {
+        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("./v3-graph-types.ts").V3Unit;
+            min: number;
+            max: number;
+            role?: "design" | "state";
+        }[];
+        geometry: import("./v3-asset-types.ts").V3AssetGeometry[];
+        bindings: import("./v3-asset-types.ts").V3EvaluatedBinding[];
+        palette: Record<string, string>;
+    };
+    open(text: string, { discardDesignChanges }?: V3LeaveOptions): {
+        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("./v3-graph-types.ts").V3Unit;
+            min: number;
+            max: number;
+            role?: "design" | "state";
+        }[];
+        geometry: import("./v3-asset-types.ts").V3AssetGeometry[];
+        bindings: import("./v3-asset-types.ts").V3EvaluatedBinding[];
+        palette: Record<string, string>;
+    };
+    close({ discardDesignChanges }?: V3LeaveOptions): {
+        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("./v3-graph-types.ts").V3Unit;
+            min: number;
+            max: number;
+            role?: "design" | "state";
+        }[];
+        geometry: import("./v3-asset-types.ts").V3AssetGeometry[];
+        bindings: import("./v3-asset-types.ts").V3EvaluatedBinding[];
+        palette: Record<string, string>;
+    };
+    preview({ context, ...q }: V3EditRequest & {
+        context: string;
+    }): {
+        candidate: {
+            inputs: Record<string, number>;
+            evaluation: import("./v3-asset-types.ts").V3CapabilityEvaluation;
+        };
+        baseRevision: number;
+        origin: "ui" | "ai";
+        changes: {
+            before: number | undefined;
+            kind: "set-design" | "set-state";
+            input: string;
+            unit: import("./v3-graph-types.ts").V3Unit;
+            value: number;
+        }[];
+        effects: {
+            geometry: {
+                added: string[];
+                removed: string[];
+                changed: string[];
+            };
+            bindingsChanged: string[];
+        };
+        validation: {
+            status: string;
+            spatial: string;
+            collision: string;
+            safety: string;
+        };
+    };
+    apply({ context, ...q }: V3EditRequest & {
+        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("./v3-graph-types.ts").V3Unit;
+            min: number;
+            max: number;
+            role?: "design" | "state";
+        }[];
+        geometry: import("./v3-asset-types.ts").V3AssetGeometry[];
+        bindings: import("./v3-asset-types.ts").V3EvaluatedBinding[];
+        palette: Record<string, string>;
+    };
+    addBox({ context, box, ...q }: V3EditControl & {
+        context: string;
+        box: V3BoxCreation;
+    }): {
+        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("./v3-graph-types.ts").V3Unit;
+            min: number;
+            max: number;
+            role?: "design" | "state";
+        }[];
+        geometry: import("./v3-asset-types.ts").V3AssetGeometry[];
+        bindings: import("./v3-asset-types.ts").V3EvaluatedBinding[];
+        palette: Record<string, string>;
+    };
+    addPrimitive({ context, part, ...q }: V3EditControl & {
+        context: string;
+        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("./v3-graph-types.ts").V3Unit;
+            min: number;
+            max: number;
+            role?: "design" | "state";
+        }[];
+        geometry: import("./v3-asset-types.ts").V3AssetGeometry[];
+        bindings: import("./v3-asset-types.ts").V3EvaluatedBinding[];
+        palette: Record<string, string>;
+    };
+    editPart({ context, edit, ...q }: V3EditControl & {
+        context: string;
+        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("./v3-graph-types.ts").V3Unit;
+            min: number;
+            max: number;
+            role?: "design" | "state";
+        }[];
+        geometry: import("./v3-asset-types.ts").V3AssetGeometry[];
+        bindings: import("./v3-asset-types.ts").V3EvaluatedBinding[];
+        palette: Record<string, string>;
+    };
+    undo({ context, ...q }: V3EditControl & {
+        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("./v3-graph-types.ts").V3Unit;
+            min: number;
+            max: number;
+            role?: "design" | "state";
+        }[];
+        geometry: import("./v3-asset-types.ts").V3AssetGeometry[];
+        bindings: import("./v3-asset-types.ts").V3EvaluatedBinding[];
+        palette: Record<string, string>;
+    };
+    redo({ context, ...q }: V3EditControl & {
+        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("./v3-graph-types.ts").V3Unit;
+            min: number;
+            max: number;
+            role?: "design" | "state";
+        }[];
+        geometry: import("./v3-asset-types.ts").V3AssetGeometry[];
+        bindings: import("./v3-asset-types.ts").V3EvaluatedBinding[];
+        palette: Record<string, string>;
+    };
+    export({ context, captureStateDefaults }: {
+        context: string;
+        captureStateDefaults?: boolean;
+    }): V3WorkspaceExport;
+    acknowledgeSaved({ context, revision, text }: V3WorkspaceExport): {
+        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("./v3-graph-types.ts").V3Unit;
+            min: number;
+            max: number;
+            role?: "design" | "state";
+        }[];
+        geometry: import("./v3-asset-types.ts").V3AssetGeometry[];
+        bindings: import("./v3-asset-types.ts").V3EvaluatedBinding[];
+        palette: Record<string, string>;
+    };
+};
+export type V3EditorWorkspace = ReturnType<typeof createV3EditorWorkspace>;
+export type V3WorkspaceView = ReturnType<V3EditorWorkspace['read']>;
+//# sourceMappingURL=v3-editor-workspace.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"v3-editor-workspace.d.ts","sourceRoot":"","sources":["../src/v3-editor-workspace.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AAE7E,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAA;AAExE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAGnD,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;CACb;AACD,MAAM,WAAW,cAAc;IAC7B,oBAAoB,CAAC,EAAE,OAAO,CAAA;CAC/B;AAeD,+FAA+F;AAC/F,wBAAgB,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;eA4DxB,MAAM,6BAAoC,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qCAgB3B,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;+BAM3B,aAAa,GAAG;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6BAGrC,aAAa,GAAG;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mCAO7B,aAAa,GAAG;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,aAAa,CAAA;KAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0CAQhD,aAAa,GAAG;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,mBAAmB,CAAA;KAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sCAQlE,aAAa,GAAG;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,UAAU,CAAA;KAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4BAe/D,aAAa,GAAG;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4BAanC,aAAa,GAAG;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8CAgBxD;QACD,OAAO,EAAE,MAAM,CAAA;QACf,oBAAoB,CAAC,EAAE,OAAO,CAAA;KAC/B,GAAG,iBAAiB;kDAQyB,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgBlE;AACD,MAAM,MAAM,iBAAiB,GAAG,UAAU,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAC1E,MAAM,MAAM,eAAe,GAAG,UAAU,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAA"}