@finos/legend-cube-builder 0.0.5 → 0.0.6

package/lib/stores/variant/CubeJsonExplorerState.js.map

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

package/lib/stores/variant/CubeJsonFieldsState.d.ts

@@ -0,0 +1,83 @@
+/**
+ * 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 Schema, type SchemaColumn } from '@finos/legend-cube';
+import { type GeneratorFn } from '@finos/legend-shared';
+import type { CubeEditorState } from '../CubeEditorState.js';
+import { type CubeJsonField } from './CubeJsonOffers.js';
+import type { CubeJsonSample } from './CubeJsonShape.js';
+/**
+ * A Variant input column's fields in an expression editor, Extend's or
+ * Filter by Expression's (PLAN §11.20, V.9): opened from the column's chip,
+ * read from a sample of the column just before the node being edited, so no
+ * run of the cube is needed and stale rows don't matter. The sample is read
+ * as Explore JSON reads one (listed in Runs, and it can be stopped); a field
+ * clicked writes its expression into the editor's.
+ */
+export declare class CubeJsonFieldsState {
+    readonly editorState: CubeEditorState;
+    /** The node being edited, whose input is read */
+    readonly nodeId: string;
+    /** The column whose fields are open; `undefined` while closed */
+    column: SchemaColumn | undefined;
+    /** What was read, and of which column */
+    sample: {
+        readonly column: string;
+        readonly sample: CubeJsonSample;
+    } | undefined;
+    isReading: boolean;
+    /** Why the column couldn't be read */
+    error: string | undefined;
+    search: string;
+    /** The fields folded, by path; every field starts open */
+    readonly folded: import("mobx").ObservableSet<string>;
+    /** The field whose other forms show, by path */
+    formsOf: string | undefined;
+    private controller;
+    constructor(editorState: CubeEditorState, nodeId: string);
+    /** The node's input: its id and schema, once known */
+    get input(): {
+        id: string;
+        schema: Schema;
+    } | undefined;
+    /**
+     * Why the fields can't be read: the database the node's input runs on has
+     * no Variant functions; `undefined` when they can, or it isn't known yet
+     */
+    get databaseProblem(): string | undefined;
+    /** The open column's fields, from what was read of it */
+    get fields(): CubeJsonField | undefined;
+    /** The fields matching the search, with the fields they are in */
+    get shownFields(): CubeJsonField | undefined;
+    isOpen(column: string): boolean;
+    isFolded(path: readonly string[]): boolean;
+    areFormsShown(path: readonly string[]): boolean;
+    /**
+     * Opens a column's fields, reading its first values unless they were read
+     * already, or closes them if open. The model's databases are loaded first:
+     * a database without JSON functions is refused, with the reason.
+     */
+    toggle(column: SchemaColumn): GeneratorFn<void>;
+    /** Reads the open column's first values, or every row, before the node */
+    read(everyRow: boolean): GeneratorFn<void>;
+    /** Stops a read in flight, keeping what was read before it */
+    stop(): void;
+    /** Closes the fields, keeping what was read for when they open again */
+    close(): void;
+    setSearch(search: string): void;
+    toggleFolded(path: readonly string[]): void;
+    toggleForms(path: readonly string[]): void;
+}
+//# sourceMappingURL=CubeJsonFieldsState.d.ts.map

package/lib/stores/variant/CubeJsonFieldsState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CubeJsonFieldsState.d.ts","sourceRoot":"","sources":["../../../src/stores/variant/CubeJsonFieldsState.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAEL,KAAK,MAAM,EACX,KAAK,YAAY,EAClB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAqB,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAU3E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,OAAO,EACL,KAAK,aAAa,EAGnB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAKzD;;;;;;;GAOG;AACH,qBAAa,mBAAmB;IAC9B,QAAQ,CAAC,WAAW,EAAE,eAAe,CAAC;IACtC,iDAAiD;IACjD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,iEAAiE;IACjE,MAAM,EAAE,YAAY,GAAG,SAAS,CAAC;IACjC,yCAAyC;IACzC,MAAM,EACF;QAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAA;KAAE,GAC5D,SAAS,CAAC;IACd,SAAS,UAAS;IAClB,sCAAsC;IACtC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,MAAM,SAAM;IACZ,0DAA0D;IAC1D,QAAQ,CAAC,MAAM,uCAA4B;IAC3C,gDAAgD;IAChD,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAE5B,OAAO,CAAC,UAAU,CAA8B;gBAEpC,WAAW,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM;IAwBxD,sDAAsD;IACtD,IAAI,KAAK,IAAI;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAKtD;IAED;;;OAGG;IACH,IAAI,eAAe,IAAI,MAAM,GAAG,SAAS,CAaxC;IAED,yDAAyD;IACzD,IAAI,MAAM,IAAI,aAAa,GAAG,SAAS,CAKtC;IAED,kEAAkE;IAClE,IAAI,WAAW,IAAI,aAAa,GAAG,SAAS,CAE3C;IAED,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAI/B,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO;IAI1C,aAAa,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO;IAI/C;;;;OAIG;IACF,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,WAAW,CAAC,IAAI,CAAC;IAyBhD,0EAA0E;IACzE,IAAI,CAAC,QAAQ,EAAE,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC;IAsC3C,8DAA8D;IAC9D,IAAI,IAAI,IAAI;IAMZ,wEAAwE;IACxE,KAAK,IAAI,IAAI;IAOb,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAI/B,YAAY,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI;IAS3C,WAAW,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI;CAI3C"}

package/lib/stores/variant/CubeJsonFieldsState.js

@@ -0,0 +1,207 @@
+/**
+ * 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 { getVariantDatabaseProblem, } from '@finos/legend-cube';
+import { assertErrorThrown } from '@finos/legend-shared';
+import { action, computed, flow, flowResult, makeObservable, observable, } from 'mobx';
+import { CubeEngineError } from '../../graph-manager/CubeEngine.js';
+import { CubeQueryRunAborted } from '../CubeQueryRun.js';
+import { filterCubeJsonFields, getCubeJsonFields, } from './CubeJsonOffers.js';
+import { readCubeJsonSample } from './CubeJsonSampling.js';
+/** A field's path as one key */
+const pathKey = (path) => JSON.stringify(path);
+/**
+ * A Variant input column's fields in an expression editor, Extend's or
+ * Filter by Expression's (PLAN §11.20, V.9): opened from the column's chip,
+ * read from a sample of the column just before the node being edited, so no
+ * run of the cube is needed and stale rows don't matter. The sample is read
+ * as Explore JSON reads one (listed in Runs, and it can be stopped); a field
+ * clicked writes its expression into the editor's.
+ */
+export class CubeJsonFieldsState {
+    editorState;
+    /** The node being edited, whose input is read */
+    nodeId;
+    /** The column whose fields are open; `undefined` while closed */
+    column;
+    /** What was read, and of which column */
+    sample;
+    isReading = false;
+    /** Why the column couldn't be read */
+    error;
+    search = '';
+    /** The fields folded, by path; every field starts open */
+    folded = observable.set();
+    /** The field whose other forms show, by path */
+    formsOf;
+    controller;
+    constructor(editorState, nodeId) {
+        makeObservable(this, {
+            column: observable.ref,
+            sample: observable.ref,
+            isReading: observable,
+            error: observable,
+            search: observable,
+            formsOf: observable,
+            input: computed,
+            databaseProblem: computed,
+            fields: computed,
+            shownFields: computed,
+            toggle: flow,
+            read: flow,
+            stop: action,
+            close: action,
+            setSearch: action,
+            toggleFolded: action,
+            toggleForms: action,
+        });
+        this.editorState = editorState;
+        this.nodeId = nodeId;
+    }
+    /** The node's input: its id and schema, once known */
+    get input() {
+        const [id] = this.editorState.document.query.getInputIds(this.nodeId);
+        const schema = id === undefined ? undefined : this.editorState.analysis.schemas.get(id);
+        return id === undefined || !schema ? undefined : { id, schema };
+    }
+    /**
+     * Why the fields can't be read: the database the node's input runs on has
+     * no Variant functions; `undefined` when they can, or it isn't known yet
+     */
+    get databaseProblem() {
+        const { editorState, input } = this;
+        const { context, query } = editorState.document;
+        return input === undefined || context?.runtime === undefined
+            ? undefined
+            : getVariantDatabaseProblem(editorState.getRunDatabaseType(query, input.id, context.model, context.runtime));
+    }
+    /** The open column's fields, from what was read of it */
+    get fields() {
+        const { column, sample } = this;
+        return column && sample?.column === column.name
+            ? getCubeJsonFields(column.name, sample.sample)
+            : undefined;
+    }
+    /** The fields matching the search, with the fields they are in */
+    get shownFields() {
+        return this.fields && filterCubeJsonFields(this.fields, this.search);
+    }
+    isOpen(column) {
+        return this.column?.name === column;
+    }
+    isFolded(path) {
+        return this.folded.has(pathKey(path));
+    }
+    areFormsShown(path) {
+        return this.formsOf === pathKey(path);
+    }
+    /**
+     * Opens a column's fields, reading its first values unless they were read
+     * already, or closes them if open. The model's databases are loaded first:
+     * a database without JSON functions is refused, with the reason.
+     */
+    *toggle(column) {
+        if (this.isOpen(column.name)) {
+            this.close();
+            return;
+        }
+        this.stop();
+        this.column = column;
+        this.error = undefined;
+        this.search = '';
+        this.formsOf = undefined;
+        if (this.sample?.column === column.name) {
+            return;
+        }
+        const { context } = this.editorState.document;
+        if (context) {
+            yield flowResult(this.editorState.loadModelOutline(context.model));
+        }
+        const problem = this.databaseProblem;
+        if (problem) {
+            this.error = problem;
+            return;
+        }
+        yield flowResult(this.read(false));
+    }
+    /** Reads the open column's first values, or every row, before the node */
+    *read(everyRow) {
+        const { editorState, column, input } = this;
+        if (!column || !input || this.isReading) {
+            return;
+        }
+        const controller = new AbortController();
+        this.controller = controller;
+        this.isReading = true;
+        this.error = undefined;
+        try {
+            const sample = (yield readCubeJsonSample(editorState, {
+                document: editorState.document,
+                afterId: input.id,
+                column,
+                everyRow,
+                abortController: controller,
+            }));
+            if (this.controller === controller && sample) {
+                this.sample = { column: column.name, sample };
+            }
+        }
+        catch (error) {
+            if (this.controller !== controller ||
+                error instanceof CubeQueryRunAborted) {
+                return;
+            }
+            assertErrorThrown(error);
+            this.error =
+                error instanceof CubeEngineError ? error.firstLine : error.message;
+        }
+        finally {
+            if (this.controller === controller) {
+                this.controller = undefined;
+                this.isReading = false;
+            }
+        }
+    }
+    /** Stops a read in flight, keeping what was read before it */
+    stop() {
+        this.controller?.abort();
+        this.controller = undefined;
+        this.isReading = false;
+    }
+    /** Closes the fields, keeping what was read for when they open again */
+    close() {
+        this.stop();
+        this.column = undefined;
+        this.error = undefined;
+        this.formsOf = undefined;
+    }
+    setSearch(search) {
+        this.search = search;
+    }
+    toggleFolded(path) {
+        const key = pathKey(path);
+        if (this.folded.has(key)) {
+            this.folded.delete(key);
+        }
+        else {
+            this.folded.add(key);
+        }
+    }
+    toggleForms(path) {
+        const key = pathKey(path);
+        this.formsOf = this.formsOf === key ? undefined : key;
+    }
+}
+//# sourceMappingURL=CubeJsonFieldsState.js.map

package/lib/stores/variant/CubeJsonFieldsState.js.map

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

package/lib/stores/variant/CubeJsonOffers.d.ts

@@ -0,0 +1,76 @@
+/**
+ * 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 CubeJsonSample } from './CubeJsonShape.js';
+/** One column a field can become */
+export interface CubeJsonOffer {
+    /** Unique among the field's offers, e.g. `value`, `count`, `contains:FR` */
+    readonly key: string;
+    /** What the dialog shows, e.g. `the value, as Integer` */
+    readonly label: string;
+    /** The column's default name, e.g. `payload_user_tier` */
+    readonly name: string;
+    /** The Pure type it should take, `Variant` for JSON: a suggestion, the engine types the column */
+    readonly type: string;
+    /** An Extend column's text, `x | …`; `undefined` for an explode */
+    readonly code: string | undefined;
+    /** One row per element of the array at this path: an Explode Array node */
+    readonly explode?: {
+        readonly column: string;
+        readonly path: readonly string[];
+    } | undefined;
+}
+/** A position in the documents, and what it can become */
+export interface CubeJsonField {
+    /** The keys from the column to it; empty for the column itself */
+    readonly path: readonly string[];
+    /** What it held, e.g. `text`, `list of object` */
+    readonly description: string;
+    /** Its share, 0 to 1, of the places it could be: the rows read, or its object's occurrences */
+    readonly presence: number;
+    /** Its most frequent values, for a scalar */
+    readonly topValues: readonly string[];
+    readonly offers: readonly CubeJsonOffer[];
+    readonly children: readonly CubeJsonField[];
+}
+/** The default name of an array's element, as Explode Array makes it: its last key's, or its column's, then `_element` */
+export declare const getCubeJsonElementName: (column: string, path: readonly string[]) => string;
+/**
+ * A column's fields, from a sample of its documents: the column itself, its
+ * object's fields, theirs, and so on, each with what it held, how often it was
+ * there and what it can become. An array's elements' fields are reached
+ * through the array's offers (first element's, total of), not as fields.
+ */
+export declare const getCubeJsonFields: (column: string, sample: CubeJsonSample) => CubeJsonField;
+/** A name no taken column has, compared folded: `name`, else `name_2`, `name_3`, … */
+export declare const getFreeCubeColumnName: (name: string, taken: readonly string[]) => string;
+/** An offer's expression of the row, as an editor writes it: its text without `x | ` */
+export declare const getCubeJsonOfferExpression: (offer: CubeJsonOffer) => string | undefined;
+/**
+ * What clicking a field in an expression editor writes (PLAN §11.20, V.9):
+ * a value as its suggested type, anything else as JSON (the column itself
+ * for its root); and the column "+ column" would add, but for the root,
+ * which is the column already
+ */
+export declare const getCubeJsonFieldDefault: (column: string, field: CubeJsonField) => {
+    expression: string;
+    column?: {
+        name: string;
+        code: string;
+    };
+};
+/** The fields whose keys match a search, with the fields they are in; all without a search */
+export declare const filterCubeJsonFields: (field: CubeJsonField, search: string) => CubeJsonField | undefined;
+//# sourceMappingURL=CubeJsonOffers.d.ts.map

package/lib/stores/variant/CubeJsonOffers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CubeJsonOffers.d.ts","sourceRoot":"","sources":["../../../src/stores/variant/CubeJsonOffers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,OAAO,EAGL,KAAK,cAAc,EAMpB,MAAM,oBAAoB,CAAC;AAgB5B,oCAAoC;AACpC,MAAM,WAAW,aAAa;IAC5B,4EAA4E;IAC5E,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,0DAA0D;IAC1D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,0DAA0D;IAC1D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,kGAAkG;IAClG,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,mEAAmE;IACnE,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,2EAA2E;IAC3E,QAAQ,CAAC,OAAO,CAAC,EACb;QAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,GAC7D,SAAS,CAAC;CACf;AAED,0DAA0D;AAC1D,MAAM,WAAW,aAAa;IAC5B,kEAAkE;IAClE,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,kDAAkD;IAClD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,+FAA+F;IAC/F,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,6CAA6C;IAC7C,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,SAAS,aAAa,EAAE,CAAC;IAC1C,QAAQ,CAAC,QAAQ,EAAE,SAAS,aAAa,EAAE,CAAC;CAC7C;AAUD,0HAA0H;AAC1H,eAAO,MAAM,sBAAsB,GACjC,QAAQ,MAAM,EACd,MAAM,SAAS,MAAM,EAAE,KACtB,MAA8D,CAAC;AAwLlE;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,GAC5B,QAAQ,MAAM,EACd,QAAQ,cAAc,KACrB,aAmBF,CAAC;AAEF,sFAAsF;AACtF,eAAO,MAAM,qBAAqB,GAChC,MAAM,MAAM,EACZ,OAAO,SAAS,MAAM,EAAE,KACvB,MAUF,CAAC;AAEF,wFAAwF;AACxF,eAAO,MAAM,0BAA0B,GACrC,OAAO,aAAa,KACnB,MAAM,GAAG,SAA+C,CAAC;AAE5D;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,GAClC,QAAQ,MAAM,EACd,OAAO,aAAa,KACnB;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;CAS/D,CAAC;AAEF,8FAA8F;AAC9F,eAAO,MAAM,oBAAoB,GAC/B,OAAO,aAAa,EACpB,QAAQ,MAAM,KACb,aAAa,GAAG,SAYlB,CAAC"}

package/lib/stores/variant/CubeJsonOffers.js

@@ -0,0 +1,250 @@
+/**
+ * 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 { foldColumnName } from '@finos/legend-cube';
+import { columnAccessOf, pureStringLiteral } from '../CubePureText.js';
+import { CUBE_JSON_PURE_TYPE, CubeJsonScalarKind, describeCubeJsonShape, getCubeJsonScalarType, getCubeJsonTopValues, isCubeJsonScalarShape, } from './CubeJsonShape.js';
+// The fields of a Variant column's documents, and the columns each can become
+// (PLAN §11.20), after legend-lite's Data Cube: picking one writes the Pure
+// text of an Extend column, which the engine parses and types like any typed
+// there. Only forms run on legend-engine are offered: `contains` goes through
+// `toMany(@Variant)->map(…to(@T))`, since `toMany(@String)->contains` writes
+// invalid SQL on DuckDB; no `exists` (an engine error); no tuple explode
+// (`toVariant(newMap(…))`, nested maps excluded on Snowflake and DuckDB).
+/** The Variant type, as an expression names it */
+const VARIANT = 'Variant';
+/** How many of an array's top values get a "contains" offer */
+const CONTAINS_OFFERS = 8;
+/** A column name from parts: joined by `_`, letters, digits and `_` only */
+const nameOf = (parts) => parts
+    .join('_')
+    .replace(/[^A-Za-z0-9_]+/gu, '_')
+    .replace(/_+/gu, '_')
+    .replace(/^_|_$/gu, '') || 'value';
+/** The default name of an array's element, as Explode Array makes it: its last key's, or its column's, then `_element` */
+export const getCubeJsonElementName = (column, path) => nameOf([path[path.length - 1] ?? column, 'element']);
+/** `$x.c->get('a')->get('b')` */
+const pathOf = (column, path) => path.reduce((expression, key) => `${expression}->get(${pureStringLiteral(key)})`, columnAccessOf(column));
+/** A function of the row */
+const ofRow = (body) => `x | ${body}`;
+/**
+ * A seen value as a Pure literal of the kind it is read as: a number in a
+ * Float list with a point (`2.0`); `undefined` for a number Pure can't write
+ * as a literal (an exponent)
+ */
+const literalOf = (kind, text) => kind === CubeJsonScalarKind.INTEGER || kind === CubeJsonScalarKind.FLOAT
+    ? !/^-?\d+(?:\.\d+)?$/u.test(text)
+        ? undefined
+        : kind === CubeJsonScalarKind.FLOAT && !text.includes('.')
+            ? `${text}.0`
+            : text
+    : kind === CubeJsonScalarKind.BOOLEAN
+        ? String(text === 'true')
+        : pureStringLiteral(text);
+/** The kinds "contains" compares as typed literals: text, numbers and booleans */
+const COMPARABLE_KINDS = new Set([
+    CubeJsonScalarKind.TEXT,
+    CubeJsonScalarKind.INTEGER,
+    CubeJsonScalarKind.FLOAT,
+    CubeJsonScalarKind.BOOLEAN,
+]);
+const arrayOffers = (column, path, shape) => {
+    const array = pathOf(column, path);
+    const names = [column, ...path];
+    const many = `${array}->toMany(@${VARIANT})`;
+    const offers = [
+        {
+            key: 'explode',
+            label: 'one row per element',
+            name: getCubeJsonElementName(column, path),
+            type: VARIANT,
+            code: undefined,
+            explode: { column, path },
+        },
+        {
+            key: 'count',
+            label: 'number of elements',
+            name: nameOf([...names, 'count']),
+            type: 'Integer',
+            code: ofRow(`${many}->size()`),
+        },
+    ];
+    const { element } = shape;
+    if (!element) {
+        return offers;
+    }
+    const elementKind = getCubeJsonScalarType(element);
+    if (elementKind && isCubeJsonScalarShape(element)) {
+        offers.push({
+            key: 'list',
+            label: 'all values, as text',
+            name: nameOf([...names, 'list']),
+            type: 'String',
+            code: ofRow(`${many}->map(e | $e->to(@String))->joinStrings(', ')`),
+        });
+        if (COMPARABLE_KINDS.has(elementKind)) {
+            const type = CUBE_JSON_PURE_TYPE[elementKind];
+            getCubeJsonTopValues(element, CONTAINS_OFFERS).forEach((value) => {
+                const literal = literalOf(elementKind, value);
+                if (literal !== undefined) {
+                    offers.push({
+                        key: `contains:${value}`,
+                        label: `contains ${value}`,
+                        name: nameOf([...names, 'has', value]),
+                        type: 'Boolean',
+                        code: ofRow(`${many}->map(e | $e->to(@${type}))->contains(${literal})`),
+                    });
+                }
+            });
+        }
+    }
+    if (element.objects > 0) {
+        offers.push({
+            key: 'first',
+            label: 'first element, as JSON',
+            name: nameOf([...names, 'first']),
+            type: VARIANT,
+            code: ofRow(`${array}->get(0)`),
+        });
+        [...element.fields.entries()]
+            .sort(([left], [right]) => left.localeCompare(right))
+            .forEach(([key, field]) => {
+            const kind = getCubeJsonScalarType(field);
+            if (!kind || !isCubeJsonScalarShape(field)) {
+                return;
+            }
+            const type = CUBE_JSON_PURE_TYPE[kind];
+            offers.push({
+                key: `first:${key}`,
+                label: `first element's ${key}`,
+                name: nameOf([...names, 'first', key]),
+                type,
+                code: ofRow(`${array}->get(0)->get(${pureStringLiteral(key)})->to(@${type})`),
+            });
+            if (kind === CubeJsonScalarKind.INTEGER ||
+                kind === CubeJsonScalarKind.FLOAT) {
+                offers.push({
+                    key: `total:${key}`,
+                    label: `total of ${key}`,
+                    name: nameOf([...names, key, 'total']),
+                    type,
+                    code: ofRow(`${many}->map(e | $e->get(${pureStringLiteral(key)})->to(@${type}))->sum()`),
+                });
+            }
+        });
+    }
+    return offers;
+};
+const offersOf = (column, path, shape) => {
+    const names = [column, ...path];
+    const offers = [];
+    const kind = getCubeJsonScalarType(shape);
+    if (kind && isCubeJsonScalarShape(shape)) {
+        const type = CUBE_JSON_PURE_TYPE[kind];
+        offers.push({
+            key: 'value',
+            label: `the value, as ${type}`,
+            name: nameOf(path.length ? names : [...names, 'value']),
+            type,
+            code: ofRow(`${pathOf(column, path)}->to(@${type})`),
+        });
+    }
+    // a nested object or array, as a Variant column of its own, to explore again
+    if (path.length > 0 && (shape.objects > 0 || shape.arrays > 0)) {
+        offers.push({
+            key: 'json',
+            label: 'as JSON',
+            name: nameOf(names),
+            type: VARIANT,
+            code: ofRow(pathOf(column, path)),
+        });
+    }
+    if (shape.objects > 0) {
+        offers.push({
+            key: 'keys',
+            label: 'its keys, as text',
+            name: nameOf([...names, 'keys']),
+            type: 'String',
+            code: ofRow(`${pathOf(column, path)}->to(@Map<String, ${VARIANT}>)->toOne()->keys()->joinStrings(', ')`),
+        });
+    }
+    if (shape.arrays > 0) {
+        offers.push(...arrayOffers(column, path, shape));
+    }
+    return offers;
+};
+/**
+ * A column's fields, from a sample of its documents: the column itself, its
+ * object's fields, theirs, and so on, each with what it held, how often it was
+ * there and what it can become. An array's elements' fields are reached
+ * through the array's offers (first element's, total of), not as fields.
+ */
+export const getCubeJsonFields = (column, sample) => {
+    const build = (shape, path, places) => ({
+        path,
+        description: describeCubeJsonShape(shape),
+        presence: Math.min(1, (shape.present - shape.nulls) / Math.max(1, places)),
+        topValues: isCubeJsonScalarShape(shape) ? getCubeJsonTopValues(shape) : [],
+        offers: offersOf(column, path, shape),
+        children: shape.objects > 0
+            ? [...shape.fields.entries()]
+                .sort(([left], [right]) => left.localeCompare(right))
+                .map(([key, field]) => build(field, [...path, key], shape.objects))
+            : [],
+    });
+    return build(sample.shape, [], sample.rows);
+};
+/** A name no taken column has, compared folded: `name`, else `name_2`, `name_3`, … */
+export const getFreeCubeColumnName = (name, taken) => {
+    const folded = new Set(taken.map(foldColumnName));
+    if (!folded.has(foldColumnName(name))) {
+        return name;
+    }
+    let index = 2;
+    while (folded.has(foldColumnName(`${name}_${index}`))) {
+        index += 1;
+    }
+    return `${name}_${index}`;
+};
+/** An offer's expression of the row, as an editor writes it: its text without `x | ` */
+export const getCubeJsonOfferExpression = (offer) => offer.code?.replace(/^x \| /u, '');
+/**
+ * What clicking a field in an expression editor writes (PLAN §11.20, V.9):
+ * a value as its suggested type, anything else as JSON (the column itself
+ * for its root); and the column "+ column" would add, but for the root,
+ * which is the column already
+ */
+export const getCubeJsonFieldDefault = (column, field) => {
+    const offer = field.offers.find(({ key }) => key === 'value' || key === 'json');
+    const expression = (offer && getCubeJsonOfferExpression(offer)) ?? pathOf(column, field.path);
+    return offer?.code && field.path.length
+        ? { expression, column: { name: offer.name, code: offer.code } }
+        : { expression };
+};
+/** The fields whose keys match a search, with the fields they are in; all without a search */
+export const filterCubeJsonFields = (field, search) => {
+    const needle = search.trim().toLowerCase();
+    if (!needle) {
+        return field;
+    }
+    const children = field.children
+        .map((child) => filterCubeJsonFields(child, search))
+        .filter((child) => child !== undefined);
+    return children.length ||
+        field.path.some((key) => key.toLowerCase().includes(needle))
+        ? { ...field, children }
+        : undefined;
+};
+//# sourceMappingURL=CubeJsonOffers.js.map