@finos/legend-cube-builder 0.0.0-stage → 0.0.3

package/lib/stores/CubeNodeEditorState.js

@@ -0,0 +1,262 @@
+/**
+ * Copyright (c) 2026-present, Goldman Sachs
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { canFixJoinDuplicates, fixJoinDuplicates, } from '@finos/legend-cube';
+import { action, computed, makeObservable, observable, reaction, } from 'mobx';
+import { CUBE_EDITOR_CLOSED_REASON, getEditorClosedNotice, } from '../__lib__/LegendCubeLabels.js';
+import { createCubeNodeDraft } from './editors/CubeNodeDraftRegistry.js';
+/**
+ * Whether two nodes of the same id save the same: their own fields, as the
+ * spec stores them, and the keys this version doesn't know. A node of a type
+ * the registry doesn't know is the same only as itself.
+ */
+export const isSameNodeContent = (registry, a, b) => {
+    if (a === b) {
+        return true;
+    }
+    const definition = registry.get(a.type);
+    return (definition !== undefined &&
+        a.type === b.type &&
+        JSON.stringify([definition.spec.encode(a), a.rest]) ===
+            JSON.stringify([definition.spec.encode(b), b.rest]));
+};
+/**
+ * The node editor in the side panel (PLAN §7.4, spec §17.5). Opening it
+ * never changes which node Execute runs. Edits go to a draft, and only Apply,
+ * or closing the panel, stores them, as one undo step; Cancel drops them.
+ *
+ * The panel follows the cube (user's choice, 2026-10-07): when the node it
+ * shows is replaced or removed underneath it, by Undo, a re-check or a
+ * Remove, a panel with edits closes without applying them and says so; one
+ * without edits shows the new node, or closes when the node is gone.
+ */
+export class CubeNodeEditorState {
+    editorState;
+    /** The id of the node the panel shows, while it is open */
+    nodeId;
+    /** The key of the node the draft was made from */
+    nodeKey;
+    draft;
+    /** Why the panel closed by itself, until it opens again or is dismissed */
+    notice;
+    disposeSync;
+    constructor(editorState) {
+        makeObservable(this, {
+            nodeId: observable,
+            nodeKey: observable,
+            draft: observable.ref,
+            notice: observable,
+            node: computed,
+            edited: computed,
+            hasChanges: computed,
+            open: action,
+            canSwapInputs: computed,
+            canRenameDuplicateColumns: computed,
+            apply: action,
+            swapInputs: action,
+            renameDuplicateColumns: action,
+            close: action,
+            cancel: action,
+            discard: action,
+            dismissNotice: action,
+            sync: action,
+        });
+        this.editorState = editorState;
+        this.disposeSync = reaction(() => this.node, () => this.sync());
+    }
+    /** The node the panel shows, as the cube has it now */
+    get node() {
+        return this.nodeId === undefined
+            ? undefined
+            : this.editorState.document.query.getNode(this.nodeId);
+    }
+    /** The node Apply would store, built once per edit */
+    get edited() {
+        return this.draft?.build();
+    }
+    /** The draft saves differently from the node it was made from */
+    get hasChanges() {
+        const { draft, edited } = this;
+        return (draft !== undefined &&
+            edited !== undefined &&
+            !isSameNodeContent(this.editorState.registry, edited, draft.original));
+    }
+    /** Opens the panel on a node, closing (and so applying) the one it showed */
+    open(nodeId) {
+        if (nodeId === this.nodeId) {
+            this.notice = undefined;
+            return;
+        }
+        const node = this.editorState.document.query.getNode(nodeId);
+        if (!node) {
+            return;
+        }
+        this.close();
+        this.notice = undefined;
+        this.bind(node);
+    }
+    /**
+     * Stores the draft in place of the node, as one undo step, and goes on
+     * editing the stored node. Does nothing without changes, or while the cube
+     * is read-only.
+     */
+    apply() {
+        const { node, edited } = this;
+        if (!node ||
+            !edited ||
+            node.key !== this.nodeKey ||
+            !this.hasChanges ||
+            this.editorState.readOnly) {
+            return;
+        }
+        const { query } = this.editorState.document;
+        if (query.canReplace(edited)) {
+            this.editorState.applyQuery(query.replace(edited));
+            this.bind(edited);
+        }
+    }
+    get canSwapInputs() {
+        const { node } = this;
+        return (node !== undefined &&
+            !this.editorState.readOnly &&
+            this.editorState.document.query.canSwapInputs(node.id));
+    }
+    /**
+     * Swaps the node's two inputs (a Join's Swap Inputs, spec §17.6), applying
+     * the draft first, as one undo step, then goes on editing the swapped
+     * node, whose settings followed its inputs
+     */
+    swapInputs() {
+        const { node, edited } = this;
+        if (!node || !edited || node.key !== this.nodeKey || !this.canSwapInputs) {
+            return;
+        }
+        let { query } = this.editorState.document;
+        if (this.hasChanges && query.canReplace(edited)) {
+            query = query.replace(edited);
+        }
+        query = query.swapInputs(node.id);
+        this.editorState.applyQuery(query);
+        this.bind(query.getNode(node.id) ?? node);
+    }
+    /**
+     * The cube's query with the draft in place of its node, when it has
+     * changes, and the schemas of the node's inputs, which the draft doesn't
+     * change
+     */
+    get queryWithEdits() {
+        const { node, edited } = this;
+        let { query } = this.editorState.document;
+        if (edited && this.hasChanges && query.canReplace(edited)) {
+            query = query.replace(edited);
+        }
+        return {
+            query,
+            inputSchemas: node
+                ? query
+                    .getInputIds(node.id)
+                    .map((inputId) => inputId === undefined
+                    ? undefined
+                    : this.editorState.analysis.schemas.get(inputId))
+                : [],
+        };
+    }
+    /**
+     * Whether the join being edited, edits included, can have the columns its
+     * inputs share renamed (spec §7.11's autofix, PLAN §11.4): its only problem
+     * is the duplicate rule, and the cube isn't read-only
+     */
+    get canRenameDuplicateColumns() {
+        const { node } = this;
+        if (!node || node.key !== this.nodeKey || this.editorState.readOnly) {
+            return false;
+        }
+        const { query, inputSchemas } = this.queryWithEdits;
+        const [leftSchema, rightSchema] = inputSchemas;
+        return canFixJoinDuplicates(query, node.id, leftSchema, rightSchema);
+    }
+    /**
+     * Renames the columns the join's inputs share with a Rename before each
+     * input, applying the draft first, as one undo step, then goes on editing
+     * the join, whose keys follow the renames
+     */
+    renameDuplicateColumns() {
+        const { node } = this;
+        if (!node || !this.canRenameDuplicateColumns) {
+            return;
+        }
+        const { query, inputSchemas } = this.queryWithEdits;
+        const [leftSchema, rightSchema] = inputSchemas;
+        const fixed = fixJoinDuplicates(query, node.id, leftSchema, rightSchema);
+        this.editorState.applyQuery(fixed);
+        this.bind(fixed.getNode(node.id) ?? node);
+    }
+    /** Applies the draft, then closes the panel (spec §17.5: edits commit on close) */
+    close() {
+        this.apply();
+        this.reset();
+    }
+    /** Closes the panel, dropping the draft */
+    cancel() {
+        this.reset();
+    }
+    /**
+     * Closes the panel without applying the draft, e.g. when another cube is
+     * opened, saying so when that drops edits
+     */
+    discard(reason) {
+        const { nodeId } = this;
+        if (nodeId !== undefined && this.hasChanges) {
+            this.notice = getEditorClosedNotice(nodeId, reason);
+        }
+        this.reset();
+    }
+    dismissNotice() {
+        this.notice = undefined;
+    }
+    /** Stops following the cube; call when the page closes */
+    dispose() {
+        this.disposeSync();
+    }
+    bind(node) {
+        this.nodeId = node.id;
+        this.nodeKey = node.key;
+        this.draft = createCubeNodeDraft(node, this.editorState);
+    }
+    reset() {
+        this.nodeId = undefined;
+        this.nodeKey = undefined;
+        this.draft = undefined;
+    }
+    /** Runs whenever the node with the panel's id is another object, or gone */
+    sync() {
+        const { node } = this;
+        if (this.nodeId === undefined || node?.key === this.nodeKey) {
+            return;
+        }
+        if (this.hasChanges) {
+            this.discard(node
+                ? CUBE_EDITOR_CLOSED_REASON.NODE_CHANGED
+                : CUBE_EDITOR_CLOSED_REASON.NODE_REMOVED);
+        }
+        else if (node) {
+            this.bind(node);
+        }
+        else {
+            this.reset();
+        }
+    }
+}
+//# sourceMappingURL=CubeNodeEditorState.js.map

package/lib/stores/CubeNodeEditorState.js.map

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

package/lib/stores/CubeShowPureState.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Copyright (c) 2026-present, Goldman Sachs
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type { GeneratorFn } from '@finos/legend-shared';
+import { CubeEngineError } from '../graph-manager/CubeEngine.js';
+import type { CubeEditorState } from './CubeEditorState.js';
+/**
+ * Show Pure: the Pure text of what Execute would run, the capture node's
+ * execution lambda with the row limit, as the engine renders it. For display
+ * only: the text is never parsed back (PLAN §8.7).
+ */
+export declare class CubeShowPureState {
+    readonly editorState: CubeEditorState;
+    isOpen: boolean;
+    text: string | undefined;
+    /** Why the engine couldn't render the query; shown in the dialog */
+    error: CubeEngineError | undefined;
+    isRendering: boolean;
+    /** Counts renders, so one that finishes after the dialog closed is dropped */
+    private request;
+    constructor(editorState: CubeEditorState);
+    /**
+     * Opens the dialog and renders the query, written for the database it runs
+     * on, as Execute writes it; does nothing when Execute can't run
+     */
+    open(): GeneratorFn<void>;
+    close(): void;
+}
+//# sourceMappingURL=CubeShowPureState.d.ts.map

package/lib/stores/CubeShowPureState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CubeShowPureState.d.ts","sourceRoot":"","sources":["../../src/stores/CubeShowPureState.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD,OAAO,EACL,eAAe,EAEhB,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D;;;;GAIG;AACH,qBAAa,iBAAiB;IAC5B,QAAQ,CAAC,WAAW,EAAE,eAAe,CAAC;IAEtC,MAAM,UAAS;IACf,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,oEAAoE;IACpE,KAAK,EAAE,eAAe,GAAG,SAAS,CAAC;IACnC,WAAW,UAAS;IACpB,8EAA8E;IAC9E,OAAO,CAAC,OAAO,CAAK;gBAER,WAAW,EAAE,eAAe;IAYxC;;;OAGG;IACF,IAAI,IAAI,WAAW,CAAC,IAAI,CAAC;IAqD1B,KAAK,IAAI,IAAI;CAOd"}

package/lib/stores/CubeShowPureState.js

@@ -0,0 +1,100 @@
+/**
+ * Copyright (c) 2026-present, Goldman Sachs
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { needsDatabaseType } from '@finos/legend-cube';
+import { action, flow, flowResult, makeObservable, observable } from 'mobx';
+import { CubeEngineError, CubeEngineErrorKind, } from '../graph-manager/CubeEngine.js';
+/**
+ * Show Pure: the Pure text of what Execute would run, the capture node's
+ * execution lambda with the row limit, as the engine renders it. For display
+ * only: the text is never parsed back (PLAN §8.7).
+ */
+export class CubeShowPureState {
+    editorState;
+    isOpen = false;
+    text;
+    /** Why the engine couldn't render the query; shown in the dialog */
+    error;
+    isRendering = false;
+    /** Counts renders, so one that finishes after the dialog closed is dropped */
+    request = 0;
+    constructor(editorState) {
+        makeObservable(this, {
+            isOpen: observable,
+            text: observable,
+            error: observable.ref,
+            isRendering: observable,
+            open: flow,
+            close: action,
+        });
+        this.editorState = editorState;
+    }
+    /**
+     * Opens the dialog and renders the query, written for the database it runs
+     * on, as Execute writes it; does nothing when Execute can't run
+     */
+    *open() {
+        const { execution, document, emitter, rowLimit, host } = this.editorState;
+        const { query, context } = document;
+        const runtime = context?.runtime;
+        const model = context?.model;
+        // checked by canExecute
+        const captureId = query.selected;
+        if (!execution.canExecute || runtime === undefined || model === undefined) {
+            return;
+        }
+        const request = ++this.request;
+        this.isOpen = true;
+        this.text = undefined;
+        this.error = undefined;
+        this.isRendering = true;
+        try {
+            let databaseType;
+            if (needsDatabaseType(query, captureId)) {
+                yield flowResult(this.editorState.loadModelOutline(model));
+                // closed, or opened again, while the outline loaded
+                if (request !== this.request) {
+                    return;
+                }
+                databaseType = this.editorState.getRunDatabaseType(query, captureId, model, runtime);
+            }
+            const text = (yield host.engine.renderPure(emitter.emitExecutionLambda({ rowLimit, runtime, databaseType })));
+            if (request === this.request) {
+                this.text = text;
+            }
+        }
+        catch (error) {
+            if (request === this.request) {
+                this.error =
+                    error instanceof CubeEngineError
+                        ? error
+                        : new CubeEngineError(CubeEngineErrorKind.COMPILE, error instanceof Error ? error.message : String(error));
+            }
+        }
+        finally {
+            if (request === this.request) {
+                this.isRendering = false;
+            }
+        }
+    }
+    close() {
+        this.request++;
+        this.isOpen = false;
+        this.isRendering = false;
+        this.text = undefined;
+        this.error = undefined;
+    }
+}
+//# sourceMappingURL=CubeShowPureState.js.map

package/lib/stores/CubeShowPureState.js.map

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

package/lib/stores/CubeSourcePickerState.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Copyright (c) 2026-present, Goldman Sachs
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { type CubeContext, type ModelContext } from '@finos/legend-cube';
+import { type GeneratorFn } from '@finos/legend-shared';
+import { type CubeModelOutline, type CubeOutlineDatabase, type CubeOutlineRuntime, type CubeOutlineSchema, type CubeOutlineTable } from '../graph-manager/CubeEngine.js';
+import type { CubeEditorState } from './CubeEditorState.js';
+import { type BundledModel } from './LocalModelCatalog.js';
+/** Whether a table can be picked: a table with a column Cube can't read can't */
+export declare const isTableSelectable: (table: CubeOutlineTable) => boolean;
+/**
+ * The source picker (PLAN §6.2.7, Settled before M1.8): model, then database,
+ * then a runtime keyed by that database, then schema and table. A step with
+ * a single choice is picked automatically. The first table fixes the cube's
+ * model and runtime; later tables come from the same database and runtime.
+ * A table is added only once its schema has resolved.
+ */
+export declare class CubeSourcePickerState {
+    readonly editorState: CubeEditorState;
+    isOpen: boolean;
+    model: ModelContext | undefined;
+    /** The model is Pure text the user pastes, not a bundled one */
+    isPastingModel: boolean;
+    pastedModelText: string;
+    /** The model the paste box last loaded: only it keeps the box shown */
+    private pastedModel;
+    outline: CubeModelOutline | undefined;
+    isLoadingModel: boolean;
+    databasePath: string | undefined;
+    runtimePath: string | undefined;
+    schemaName: string | undefined;
+    tableName: string | undefined;
+    tableSearch: string;
+    isResolving: boolean;
+    /** Why the outline or the table couldn't be loaded, shown in the dialog */
+    error: string | undefined;
+    /** Counts Add presses: closing the dialog moves it on, so the pending Add is dropped */
+    private confirmRequest;
+    constructor(editorState: CubeEditorState);
+    get models(): readonly BundledModel[];
+    /** Once the cube has a model, every table comes from it */
+    get fixedContext(): CubeContext | undefined;
+    /** Once the cube has a table, every other one comes from its database */
+    get fixedDatabasePath(): string | undefined;
+    get databases(): readonly CubeOutlineDatabase[];
+    get runtimes(): readonly CubeOutlineRuntime[];
+    get schemas(): readonly CubeOutlineSchema[];
+    /** The schema's tables, views left out, filtered by the search text */
+    get tables(): readonly CubeOutlineTable[];
+    get canConfirm(): boolean;
+    /**
+     * Opens the dialog on the cube's model, or on the only model offered. A
+     * model whose outline failed to load is loaded again. Does nothing while
+     * the cube is read-only.
+     */
+    open(): void;
+    /** Closes the dialog; a table still being typed is not added */
+    close(): void;
+    /** Offers a text box for a Pure model in place of the bundled ones */
+    startPastingModel(): void;
+    setPastedModelText(text: string): void;
+    /**
+     * Loads the pasted Pure text as the model: the cube will hold the text
+     * itself, so it counts towards the size a saved cube can have
+     */
+    loadPastedModel(): GeneratorFn<void>;
+    /**
+     * Loads a model's outline. Any model but the one the paste box loaded ends
+     * pasting, e.g. a bundled model, or the model of a cube opened meanwhile.
+     */
+    selectModel(model: ModelContext): GeneratorFn<void>;
+    selectDatabase(path: string | undefined): void;
+    selectRuntime(path: string | undefined): void;
+    selectSchema(name: string | undefined): void;
+    selectTable(name: string | undefined): void;
+    setTableSearch(search: string): void;
+    /**
+     * Types the picked table with the engine, then adds it; the first table
+     * also sets the cube's model and runtime, in the same undo step. The cube
+     * may have changed while the engine answered: the table is added only if
+     * the cube still has the same model and runtime and can take it.
+     */
+    confirm(): GeneratorFn<void>;
+    private resetFrom;
+}
+//# sourceMappingURL=CubeSourcePickerState.d.ts.map

package/lib/stores/CubeSourcePickerState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CubeSourcePickerState.d.ts","sourceRoot":"","sources":["../../src/stores/CubeSourcePickerState.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EACL,KAAK,WAAW,EAEhB,KAAK,YAAY,EAGlB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAqB,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAS3E,OAAO,EAIL,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACtB,MAAM,gCAAgC,CAAC;AAExC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,KAAK,YAAY,EAAmB,MAAM,wBAAwB,CAAC;AAO5E,iFAAiF;AACjF,eAAO,MAAM,iBAAiB,GAAI,OAAO,gBAAgB,KAAG,OACV,CAAC;AAEnD;;;;;;GAMG;AACH,qBAAa,qBAAqB;IAChC,QAAQ,CAAC,WAAW,EAAE,eAAe,CAAC;IAEtC,MAAM,UAAS;IACf,KAAK,EAAE,YAAY,GAAG,SAAS,CAAC;IAChC,gEAAgE;IAChE,cAAc,UAAS;IACvB,eAAe,SAAM;IACrB,uEAAuE;IACvE,OAAO,CAAC,WAAW,CAA2B;IAC9C,OAAO,EAAE,gBAAgB,GAAG,SAAS,CAAC;IACtC,cAAc,UAAS;IACvB,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,WAAW,SAAM;IACjB,WAAW,UAAS;IACpB,2EAA2E;IAC3E,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,wFAAwF;IACxF,OAAO,CAAC,cAAc,CAAK;gBAEf,WAAW,EAAE,eAAe;IAsCxC,IAAI,MAAM,IAAI,SAAS,YAAY,EAAE,CAEpC;IAED,2DAA2D;IAC3D,IAAI,YAAY,IAAI,WAAW,GAAG,SAAS,CAE1C;IAED,yEAAyE;IACzE,IAAI,iBAAiB,IAAI,MAAM,GAAG,SAAS,CAK1C;IAED,IAAI,SAAS,IAAI,SAAS,mBAAmB,EAAE,CAa9C;IAED,IAAI,QAAQ,IAAI,SAAS,kBAAkB,EAAE,CAQ5C;IAED,IAAI,OAAO,IAAI,SAAS,iBAAiB,EAAE,CAK1C;IAED,uEAAuE;IACvE,IAAI,MAAM,IAAI,SAAS,gBAAgB,EAAE,CAUxC;IAED,IAAI,UAAU,IAAI,OAAO,CAYxB;IAED;;;;OAIG;IACH,IAAI,IAAI,IAAI;IA8BZ,gEAAgE;IAChE,KAAK,IAAI,IAAI;IAMb,sEAAsE;IACtE,iBAAiB,IAAI,IAAI;IASzB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAItC;;;OAGG;IACF,eAAe,IAAI,WAAW,CAAC,IAAI,CAAC;IAOrC;;;OAGG;IACF,WAAW,CAAC,KAAK,EAAE,YAAY,GAAG,WAAW,CAAC,IAAI,CAAC;IA8BpD,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAa9C,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAI7C,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAK5C,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAK3C,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAIpC;;;;;OAKG;IACF,OAAO,IAAI,WAAW,CAAC,IAAI,CAAC;IA6E7B,OAAO,CAAC,SAAS;CAWlB"}