@finos/legend-cube-builder 0.0.3 → 0.0.5

package/lib/__lib__/LegendCubeHelpText.js

@@ -13,16 +13,34 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import { Distinct, Drop, Filter, Join, Limit, RelationalTableSource, Rename, Restrict, Slice, Sort, UnknownNode, } from '@finos/legend-cube';
+import { Concat, DataProductAccessPointSource, Difference, IngestDatasetSource, Distinct, Drop, ExpressionFilter, Extend, Filter, FunctionSource, Group, Join, Limit, Partition, Pivot, RelationalTableSource, Rename, Restrict, ServiceSource, Slice, Sort, UnknownNode, } from '@finos/legend-cube';
 // The node editor's help text, verbatim from the original (spec §17.9), but
 // Slice's, which counts rows from 0 and leaves the stop row out (D5, PLAN
-// §11.4). A new node type adds its entry here.
+// §11.4), and Concat's, which matches columns by position (PLAN §11.5, Q8).
+// A new node type adds its entry here.
 export const CUBE_NODE_HELP_TEXT = {
     [RelationalTableSource.TYPE]: 'Sources data from relational database table.',
+    /** Added by Cube: the original's PURE Native Function source (PLAN §6.5) */
+    [FunctionSource.TYPE]: 'Sources data from a function of the model that returns a relation, called with a value for each parameter.',
+    /** Added by Cube: the original has no data product source (PLAN §6.8) */
+    [DataProductAccessPointSource.TYPE]: 'Sources data from an access point of a deployed data product.',
+    /** Added by Cube: the original has no ingest data set source (PLAN §6.7) */
+    [IngestDatasetSource.TYPE]: 'Sources data from a data set of a deployed ingest definition.',
+    /** Added by Cube: the original's service source is read another way, still to come (PLAN §6.4) */
+    [ServiceSource.TYPE]: "Sources data from a deployed service. In progress: Cube can't read services yet.",
+    [Concat.TYPE]: 'Combines the rows of the two previous data sets, keeping duplicates, in no particular order. Both must have the same columns: the same names, in the same order, with the same types.',
+    [Difference.TYPE]: 'Compares numeric values of specified columns from two previous data sets.',
     [Distinct.TYPE]: 'Removes duplicate rows from the previous data set.',
     [Drop.TYPE]: 'Reduces the number of rows in the previous data set, removing the specified number of rows from the beginning of the data set.',
+    [Extend.TYPE]: 'Extends outgoing data set with new columns produced by expressions.',
     [Filter.TYPE]: 'Reduces the number of rows in the previous data set, keeping only rows matching the specified criteria.',
+    /** Added by Cube: the original has no filter by expression (PLAN §11.11) */
+    [ExpressionFilter.TYPE]: 'Reduces the number of rows in the previous data set, keeping only rows for which the expression is true.',
+    [Group.TYPE]: 'Aggregates the data from the previous data set using the specified columns and aggregation functions.',
+    /** Added by Cube: the original has pivot only in the grid (PLAN §11.12) */
+    [Pivot.TYPE]: 'Turns the values of a column of the previous data set into columns: a row for each combination of the row columns that has a picked value, and a column for each picked value, holding its aggregate.',
     [Join.TYPE]: 'Joins two previous data sets using specified columns as join keys.',
+    [Partition.TYPE]: 'Adds new columns with outputs of window functions for optional window partition and order.',
     [Limit.TYPE]: 'Reduces the number of rows in the previous data set, keeping the specified number of rows from the beginning of the data set.',
     [Rename.TYPE]: 'Renames specified columns in the previous data set to new names.',
     [Restrict.TYPE]: 'Restricts outgoing data set to the specified columns only.',
@@ -31,5 +49,9 @@ export const CUBE_NODE_HELP_TEXT = {
     [UnknownNode.TYPE]: 'Source or transformation unknown to the application.',
 };
 /** The tooltip of the editor's Select link (spec §17.9) */
-export const SELECT_NODE_TOOLTIP = 'Selects this node as active and its output will be shown in the grid once query is executed.';
+export const SELECT_NODE_TOOLTIP = 'Make this the step that runs: Execute shows its rows in the grid.';
+/** The marker on the step that runs, on the canvas and in its editor */
+export const RUNNING_NODE_LABEL = 'Runs';
+/** What a node's menu and editor call making it the step that runs */
+export const RUN_THIS_STEP_LABEL = 'Run this step';
 //# sourceMappingURL=LegendCubeHelpText.js.map

package/lib/__lib__/LegendCubeHelpText.js.map

@@ -1 +1 @@
-{"version":3,"file":"LegendCubeHelpText.js","sourceRoot":"","sources":["../../src/__lib__/LegendCubeHelpText.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EACL,QAAQ,EACR,IAAI,EACJ,MAAM,EACN,IAAI,EACJ,KAAK,EACL,qBAAqB,EACrB,MAAM,EACN,QAAQ,EACR,KAAK,EACL,IAAI,EACJ,WAAW,GACZ,MAAM,oBAAoB,CAAC;AAE5B,4EAA4E;AAC5E,0EAA0E;AAC1E,+CAA+C;AAE/C,MAAM,CAAC,MAAM,mBAAmB,GAAqC;IACnE,CAAC,qBAAqB,CAAC,IAAI,CAAC,EAAE,8CAA8C;IAC5E,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,oDAAoD;IACrE,CAAC,IAAI,CAAC,IAAI,CAAC,EACT,gIAAgI;IAClI,CAAC,MAAM,CAAC,IAAI,CAAC,EACX,yGAAyG;IAC3G,CAAC,IAAI,CAAC,IAAI,CAAC,EACT,oEAAoE;IACtE,CAAC,KAAK,CAAC,IAAI,CAAC,EACV,+HAA+H;IACjI,CAAC,MAAM,CAAC,IAAI,CAAC,EACX,kEAAkE;IACpE,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,4DAA4D;IAC7E,CAAC,KAAK,CAAC,IAAI,CAAC,EACV,8JAA8J;IAChK,CAAC,IAAI,CAAC,IAAI,CAAC,EACT,oHAAoH;IACtH,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,sDAAsD;CAC3E,CAAC;AAEF,2DAA2D;AAC3D,MAAM,CAAC,MAAM,mBAAmB,GAC9B,8FAA8F,CAAC"}
+{"version":3,"file":"LegendCubeHelpText.js","sourceRoot":"","sources":["../../src/__lib__/LegendCubeHelpText.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EACL,MAAM,EACN,4BAA4B,EAC5B,UAAU,EACV,mBAAmB,EACnB,QAAQ,EACR,IAAI,EACJ,gBAAgB,EAChB,MAAM,EACN,MAAM,EACN,cAAc,EACd,KAAK,EACL,IAAI,EACJ,KAAK,EACL,SAAS,EACT,KAAK,EACL,qBAAqB,EACrB,MAAM,EACN,QAAQ,EACR,aAAa,EACb,KAAK,EACL,IAAI,EACJ,WAAW,GACZ,MAAM,oBAAoB,CAAC;AAE5B,4EAA4E;AAC5E,0EAA0E;AAC1E,4EAA4E;AAC5E,uCAAuC;AAEvC,MAAM,CAAC,MAAM,mBAAmB,GAAqC;IACnE,CAAC,qBAAqB,CAAC,IAAI,CAAC,EAAE,8CAA8C;IAC5E,4EAA4E;IAC5E,CAAC,cAAc,CAAC,IAAI,CAAC,EACnB,4GAA4G;IAC9G,yEAAyE;IACzE,CAAC,4BAA4B,CAAC,IAAI,CAAC,EACjC,+DAA+D;IACjE,4EAA4E;IAC5E,CAAC,mBAAmB,CAAC,IAAI,CAAC,EACxB,+DAA+D;IACjE,kGAAkG;IAClG,CAAC,aAAa,CAAC,IAAI,CAAC,EAClB,kFAAkF;IACpF,CAAC,MAAM,CAAC,IAAI,CAAC,EACX,uLAAuL;IACzL,CAAC,UAAU,CAAC,IAAI,CAAC,EACf,2EAA2E;IAC7E,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,oDAAoD;IACrE,CAAC,IAAI,CAAC,IAAI,CAAC,EACT,gIAAgI;IAClI,CAAC,MAAM,CAAC,IAAI,CAAC,EACX,qEAAqE;IACvE,CAAC,MAAM,CAAC,IAAI,CAAC,EACX,yGAAyG;IAC3G,4EAA4E;IAC5E,CAAC,gBAAgB,CAAC,IAAI,CAAC,EACrB,0GAA0G;IAC5G,CAAC,KAAK,CAAC,IAAI,CAAC,EACV,uGAAuG;IACzG,2EAA2E;IAC3E,CAAC,KAAK,CAAC,IAAI,CAAC,EACV,uMAAuM;IACzM,CAAC,IAAI,CAAC,IAAI,CAAC,EACT,oEAAoE;IACtE,CAAC,SAAS,CAAC,IAAI,CAAC,EACd,4FAA4F;IAC9F,CAAC,KAAK,CAAC,IAAI,CAAC,EACV,+HAA+H;IACjI,CAAC,MAAM,CAAC,IAAI,CAAC,EACX,kEAAkE;IACpE,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,4DAA4D;IAC7E,CAAC,KAAK,CAAC,IAAI,CAAC,EACV,8JAA8J;IAChK,CAAC,IAAI,CAAC,IAAI,CAAC,EACT,oHAAoH;IACtH,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,sDAAsD;CAC3E,CAAC;AAEF,2DAA2D;AAC3D,MAAM,CAAC,MAAM,mBAAmB,GAC9B,mEAAmE,CAAC;AAEtE,wEAAwE;AACxE,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAEzC,sEAAsE;AACtE,MAAM,CAAC,MAAM,mBAAmB,GAAG,eAAe,CAAC"}

package/lib/__lib__/LegendCubeIngestLabels.d.ts

@@ -0,0 +1,25 @@
+/**
+ * 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 { SchemaDiff } from '@finos/legend-cube';
+export declare const getDataSetDriftWarning: (diff: SchemaDiff) => string;
+export declare const getDataSetRecheckWarning: (firstLine: string) => string;
+export declare const CUBE_INGEST_RECHECK_MESSAGE: {
+    readonly NO_ANSWER: "The ingest catalog gave no columns for this data set";
+    readonly NO_CATALOG: "This Legend deployment doesn't serve ingest data sets";
+};
+/** How many of a producer deployment's definitions the tab leaves out, or nothing when it lists them all */
+export declare const getDroppedDefinitionsLabel: (count: number) => string | undefined;
+//# sourceMappingURL=LegendCubeIngestLabels.d.ts.map

package/lib/__lib__/LegendCubeIngestLabels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LegendCubeIngestLabels.d.ts","sourceRoot":"","sources":["../../src/__lib__/LegendCubeIngestLabels.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAMrD,eAAO,MAAM,sBAAsB,GAAI,MAAM,UAAU,KAAG,MACsB,CAAC;AAEjF,eAAO,MAAM,wBAAwB,GAAI,WAAW,MAAM,KAAG,MACoB,CAAC;AAElF,eAAO,MAAM,2BAA2B;;;CAG9B,CAAC;AAEX,4GAA4G;AAC5G,eAAO,MAAM,0BAA0B,GACrC,OAAO,MAAM,KACZ,MAAM,GAAG,SAG6H,CAAC"}

package/lib/__lib__/LegendCubeIngestLabels.js

@@ -0,0 +1,29 @@
+/**
+ * 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 { getSchemaChangeList } from './LegendCubeLabels.js';
+// The text of ingest data set sources (PLAN §6.7): the source dialog's
+// Ingest tab and an ingest data set's panel
+export const getDataSetDriftWarning = (diff) => `This data set changed since the cube was saved: ${getSchemaChangeList(diff)}`;
+export const getDataSetRecheckWarning = (firstLine) => `Could not re-check this data set, so it keeps its saved columns: ${firstLine}`;
+export const CUBE_INGEST_RECHECK_MESSAGE = {
+    NO_ANSWER: 'The ingest catalog gave no columns for this data set',
+    NO_CATALOG: "This Legend deployment doesn't serve ingest data sets",
+};
+/** How many of a producer deployment's definitions the tab leaves out, or nothing when it lists them all */
+export const getDroppedDefinitionsLabel = (count) => count === 0
+    ? undefined
+    : `${count} ${count === 1 ? 'definition' : 'definitions'} not deployed from a project, or deployed to another environment, not shown`;
+//# sourceMappingURL=LegendCubeIngestLabels.js.map

package/lib/__lib__/LegendCubeIngestLabels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LegendCubeIngestLabels.js","sourceRoot":"","sources":["../../src/__lib__/LegendCubeIngestLabels.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D,uEAAuE;AACvE,4CAA4C;AAE5C,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,IAAgB,EAAU,EAAE,CACjE,mDAAmD,mBAAmB,CAAC,IAAI,CAAC,EAAE,CAAC;AAEjF,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,SAAiB,EAAU,EAAE,CACpE,oEAAoE,SAAS,EAAE,CAAC;AAElF,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACzC,SAAS,EAAE,sDAAsD;IACjE,UAAU,EAAE,uDAAuD;CAC3D,CAAC;AAEX,4GAA4G;AAC5G,MAAM,CAAC,MAAM,0BAA0B,GAAG,CACxC,KAAa,EACO,EAAE,CACtB,KAAK,KAAK,CAAC;IACT,CAAC,CAAC,SAAS;IACX,CAAC,CAAC,GAAG,KAAK,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,aAAa,6EAA6E,CAAC"}

package/lib/__lib__/LegendCubeLabels.d.ts

@@ -13,7 +13,7 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import type { SchemaColumn, SchemaDiff } from '@finos/legend-cube';
+import { type SchemaColumn, type SchemaDiff } from '@finos/legend-cube';
 import { CubeTableFlag } from '../graph-manager/CubeEngine.js';
 /** The rows a run returns by default (PLAN §9, Settled before M1.8) */
 export declare const DEFAULT_ROW_LIMIT = 1000;
@@ -23,32 +23,72 @@ export declare const ROW_LIMIT_WARNING_THRESHOLD = 100000;
 export declare const MAX_UNDO_STEPS = 100;
 export declare enum LEGEND_CUBE_USER_DATA_KEY {
     ROW_LIMIT = "legend-cube.row-limit",
-    PALETTE_COLLAPSED = "legend-cube.palette-collapsed"
+    PALETTE_COLLAPSED = "legend-cube.palette-collapsed",
+    /** The warehouse the viewer last picked for a data product cube (PLAN §6.8) */
+    DATA_PRODUCT_WAREHOUSE = "legend-cube.data-product-warehouse",
+    /** Server-side or local (PLAN §11.10) */
+    GRID_MODE = "legend-cube.grid-mode",
+    /** Engine requests sent uncompressed, for the browser's Network tab (PLAN §11.16) */
+    UNCOMPRESSED_REQUESTS = "legend-cube.uncompressed-requests"
 }
 export declare const UNSAVED_CUBE_NAME = "Unsaved Query";
+/** Why a source is disabled on a cube: it reads database tables or data products, never both (PLAN §6.8) */
+export declare const OTHER_SOURCE_KIND_TITLE = "This cube's sources are of another kind: a cube reads database tables or data products, never both";
+/** Why no source can be added to a cube: the host doesn't serve the cube's kind of source (PLAN §6.8) */
+export declare const UNSERVED_SOURCE_KIND_TITLE = "This Legend deployment doesn't serve this cube's kind of source, so no source can be added to it";
 /** Why a cube's edits are disabled: it was saved by a newer version (Settled before M1.8) */
 export declare const READ_ONLY_CUBE_TITLE = "This cube was saved by a newer version of Legend Cube, so it can't be changed or exported";
 /** How a SQL NULL shows in the grid, distinct from an empty string */
 export declare const NULL_CELL_TEXT = "(null)";
+/** What the Runs panel calls a run (PLAN §11.10, §11.16); a fetch of the grid's rows is described by its level */
+export declare const CUBE_RUN_LABEL: {
+    EXECUTE: string;
+    EXPORT_CSV: string;
+    pivotValues: (column: string) => string;
+};
+/**
+ * Above a run's Pure (PLAN §11.16): unlike Show Pure, it shows the limit a
+ * grid run adds, one more than the row limit, to tell whether there are more
+ */
+export declare const CUBE_RUN_PURE_NOTE = "As it ran, with any row limit Cube added to it.";
 /** Pending labels: lower-case gerunds, shown as they are (spec §17.13) */
 export declare enum CUBE_PENDING_LABEL {
     LOADING_MODEL = "loading model",
     RESOLVING_SOURCE = "resolving source",
     EXECUTING_QUERY = "executing query",
+    FETCHING_ROWS = "fetching rows",
+    EXPORTING_CSV = "exporting CSV",
     RENDERING_QUERY = "rendering query",
-    REFRESHING_SOURCE = "refreshing source"
+    REFRESHING_SOURCE = "refreshing source",
+    CHECKING_EXPRESSIONS = "checking expressions"
 }
-export declare const getRowLimitError: (text: string) => string | undefined;
+/**
+ * Why a row limit can't be taken: the number its text holds
+ * (`parseWholeNumberText`, so `0x10`, `1e3` and `1.0` hold none, PLAN
+ * §11.14) isn't a safe whole number of at least 1
+ */
+export declare const getRowLimitError: (value: number | undefined) => string | undefined;
 export declare const getTruncationMessage: (rowLimit: number) => string;
+/** In server-side mode, when a drill-down level or a sorted level was cut at the row limit (PLAN §11.10) */
+export declare const getLevelTruncationMessage: (rowLimit: number) => string;
 /** How the picker shows a table's problem, and why (PLAN §6.2.6) */
 export declare const CUBE_TABLE_FLAG_LABELS: Readonly<Record<CubeTableFlag, {
     label: string;
     description: string;
 }>>;
-/** A column's type as the editors show it: its display name, `?` when it takes NULL, e.g. `Varchar(5)?` */
+/** A column's exact type: its display name, `?` when it takes NULL, e.g. `Varchar(5)?`; for hover and type messages */
+export declare const getExactColumnTypeLabel: (column: SchemaColumn) => string;
+/**
+ * A column's type as the editors show it: the kind of value, and whether it
+ * can be empty, e.g. `Text, can be empty`; an enumeration, or a type Cube
+ * doesn't know, by its name. The exact type (`getExactColumnTypeLabel`) is
+ * on hover.
+ */
 export declare const getColumnTypeLabel: (column: SchemaColumn) => string;
 /** Why Execute (and Show Pure) can't run, one reason a line, for a tooltip */
 export declare const formatDisabledReasons: (reasons: readonly string[]) => string;
+/** A source's changes since the cube was saved, as its drift warning lists them */
+export declare const getSchemaChangeList: (diff: SchemaDiff) => string;
 /** The warning on a source whose table changed since the cube was saved; the table's new columns are used */
 export declare const getSchemaDriftWarning: (diff: SchemaDiff) => string;
 /** Why the Sort editor's picker doesn't offer a column, after its type */
@@ -60,19 +100,35 @@ export declare const CUBE_SORT_COLUMN_DISABLED_REASON: {
 export declare const CUBE_QUICK_ACTION_DISABLED_REASON: {
     STALE_ROWS: string;
     RUNNING: string;
+    EDITING: string;
     UNREADABLE_VALUE: string;
+    /** On a group row's cell that holds its aggregation (PLAN §11.10) */
+    AGGREGATE_VALUE: string;
+    /** On a group row's cell that shows nothing */
+    NO_VALUE: string;
     notSortable: (typeName: string) => string;
+    notGroupable: (typeName: string) => string;
     notComparable: (typeName: string) => string;
 };
+/** Why 'Format Column' can't be used on a column (spec §13.1) */
+export declare const CUBE_FORMAT_NOT_A_NUMBER = "Only number columns can be formatted.";
+/** Why 'Drilldown by' can't be used on a column (PLAN §11.10) */
+export declare const CUBE_DRILLDOWN_BLOCKER: {
+    ALREADY_A_LEVEL: string;
+    notGroupable: (typeName: string) => string;
+};
 /** Beside a condition comparing a floating-point column for equality (R133) */
 export declare const FILTER_FLOAT_COMPARISON_HINT = "exact comparison on floating-point columns may not match";
+/** The Filter and Join editors' warning on a column that can hold both dates and timestamps (PLAN §11.5) */
+export declare const DATE_OR_TIMESTAMP_WARNING = "this column can hold both dates and timestamps, as Convert types made it a Date: a date reads as midnight, so it matches a timestamp only at midnight";
 /** The Filter editor's note on NULLs (D4): negated conditions keep them */
 export declare const FILTER_NULL_NOTE = "A negated condition (is not, does not contain, is not in list of, Not) also keeps the rows where its column is empty (NULL).";
 /** Why the node editor closed without applying its edits */
 export declare enum CUBE_EDITOR_CLOSED_REASON {
     NODE_CHANGED = "nodeChanged",
     NODE_REMOVED = "nodeRemoved",
-    CUBE_REPLACED = "cubeReplaced"
+    CUBE_REPLACED = "cubeReplaced",
+    CANNOT_APPLY = "cannotApply"
 }
 /** The notice of a node editor that closed by itself, dropping its edits (M1.8b) */
 export declare const getEditorClosedNotice: (nodeId: string, reason: CUBE_EDITOR_CLOSED_REASON) => string;
@@ -82,6 +138,115 @@ export declare const getSourceRecheckWarning: (firstLine: string) => string;
 export declare const SLICE_RANGE_HINT = "Rows count from 0: the start row is kept, the stop row is not.";
 /** The Distinct editor's text: it has nothing to set (spec §17.6) */
 export declare const DISTINCT_EDITOR_TEXT = "Keeps one row of each set of identical rows. There is nothing to set.";
+/** The Concat editor's text: what Concat requires of its inputs (PLAN §11.5) */
+export declare const CONCAT_EDITOR_TEXT = "Gives the rows of both inputs, keeping duplicates, in no particular order. Both must have the same columns, matched by position: the same names, in the same order, with the same types.";
+/** What the Concat editor's Convert types setting does (PLAN §11.5, Q5) */
+export declare const CONCAT_CONVERT_TYPES_HINT = "Converts types that differ within numbers, strings or dates to the type they share, e.g. Varchar(15) and Varchar(40) to String.";
+/** What the Concat editor says when a fix would make its inputs match only with Convert types ticked (PLAN §11.5) */
+export declare const CONCAT_FIX_NEEDS_CONVERT_TEXT = "With Convert types ticked, Cube can rename or drop columns to make the inputs match.";
+/** What the Concat editor says when Convert types would make its inputs match (PLAN §11.5, Q5) */
+export declare const CONCAT_CONVERT_FIX_TEXT = "The types differ, but converting them to the type they share makes the inputs match:";
+export declare const CONCAT_CONVERT_FIX_TITLE = "Tick Convert types; Apply stores it";
+/** What the Concat editor's Rename autofix says it will do (PLAN §11.5, Q6) */
+export declare const CONCAT_RENAME_FIX_TEXT = "The second input's columns can take the first input's names:";
+export declare const CONCAT_RENAME_FIX_TITLE = "Add a Rename before the second input that gives these columns the first input's names, as one step to undo";
+/** What the Concat editor's Restrict autofix says it will do, for the input it drops columns from (PLAN §11.5, Q6) */
+export declare const getConcatRestrictFixText: (input: string, other: string) => string;
+export declare const getConcatRestrictFixTitle: (input: string, other: string) => string;
+/** The Concat editor's warning on columns whose real type Cube doesn't know (PLAN §8.7) */
+export declare const getConcatUntypedWarning: (columns: readonly string[]) => string;
+/** Why the Group editor can't take a column as a key (PLAN §11.5) */
+export declare const CUBE_GROUP_COLUMN_DISABLED_REASON = "can't be grouped";
+/** What the Group editor says about its aggregations (PLAN §11.5; Count counts non-empty values, D4) */
+export declare const GROUP_EDITOR_NOTES: string[];
+/** Why the Pivot editor won't take a column (PLAN §11.12), shown after the column's type */
+export declare const PIVOT_COLUMN_DISABLED_REASON: {
+    /** a row column that can't be compared */
+    readonly NOT_GROUPABLE: "can't be grouped";
+    /** a pivot column of another type than a String, an integer, a StrictDate or a Boolean */
+    readonly NOT_PIVOTABLE: "can't be pivoted";
+    /** a column the pivot uses for another part */
+    readonly PIVOT_COLUMN: "the pivot column";
+    readonly ROW_COLUMN: "a row column";
+    readonly AGGREGATED: "the aggregated column";
+};
+/** Why the Pivot editor won't tick a value (PLAN §11.12) */
+export declare const PIVOT_VALUE_DISABLED_REASON: {
+    readonly NOT_A_COLUMN_NAME: "can't name a column";
+    /** another value ticked has the same text in another case */
+    readonly DIFFERS_ONLY_IN_CASE: "only its case differs from a ticked value";
+    /** as many values are ticked as a Pivot takes */
+    readonly TOO_MANY: "as many values as a Pivot takes are ticked";
+};
+/** What the Pivot editor says (PLAN §11.12) */
+export declare const PIVOT_EDITOR_NOTES: readonly ["Each picked value becomes a column, named by the value, holding the aggregation of its rows; each combination of the row columns with a picked value becomes a row. Values not picked, and combinations holding only them, are left out.", "Load values lists the pivot column's values, each once, up to 100. An empty value can't be pivoted, nor one that can't name a column; of two values that differ only in case, one can be ticked, as some databases would mix up their columns.", "Pivot runs on Snowflake, Databricks, SingleStore and DuckDB; other databases, such as H2 and Postgres, can't run it."];
+/** Says that Load values found no value to list (PLAN §11.12) */
+export declare const PIVOT_NO_VALUES_NOTICE = "The pivot column has no value to list: its rows are all empty, or there are none.";
+/** Says that the engine has more values than the Pivot editor lists (PLAN §11.12) */
+export declare const getPivotValuesCutNotice: (shown: number) => string;
+/** Why the Partition editor won't tick a column that can't be compared (PLAN §11.6) */
+export declare const CUBE_PARTITION_COLUMN_DISABLED_REASON = "can't be partitioned by";
+/** What a Partition row shows in the column's place for a function that takes none (PLAN §11.6) */
+export declare const getPartitionNoColumnText: (fn: string) => string;
+/** What the Partition editor says about its window functions (PLAN §11.6: D5's frames, Q2, Q3; §11.9) */
+export declare const PARTITION_EDITOR_NOTES: string[];
+/** Why a column of the Left input can't be a difference column (PLAN §11.7) */
+export declare const CUBE_DIFFERENCE_COLUMN_REASONS: Readonly<{
+    JOIN_COLUMN: "a join column";
+    NOT_NUMERIC: "not a number";
+    NOT_IN_RIGHT: "not in the Right input";
+    TYPE_DIFFERS: (rightType: string) => string;
+}>;
+/** What the Difference editor says about its output (spec §7.12, PLAN §11.7) */
+export declare const DIFFERENCE_EDITOR_NOTES: string[];
+/** What the Extend editor says about its expressions (PLAN §11.7) */
+export declare const EXTEND_EDITOR_NOTES: string[];
+/** Why the Extend editor's Apply waits (PLAN §11.7) */
+export declare const EXTEND_APPLY_DISABLED_REASON: Readonly<{
+    NOT_VALIDATED: "Validate the expressions first (F10)";
+    VALIDATING: "Validating the expressions";
+}>;
+/** The warning on an Extend whose saved types the engine couldn't check again, e.g. offline (PLAN §11.7) */
+export declare const getExtendRetypeWarning: (firstLine: string) => string;
+/** The warning on a Filter by Expression whose condition the engine couldn't check again, e.g. offline (PLAN §11.11) */
+export declare const getConditionRecheckWarning: (firstLine: string) => string;
+/** The notice of a node editor kept open, since its changes can't be applied yet, e.g. an Extend's expressions not validated */
+export declare const getEditorKeptOpenNotice: (nodeId: string, waiting: string) => string;
+/** Why the Filter by Expression editor's Apply waits (PLAN §11.11) */
+export declare const EXPRESSION_FILTER_APPLY_DISABLED_REASON: Readonly<{
+    NOT_VALIDATED: "Validate the condition first (F10)";
+    VALIDATING: "Validating the condition";
+}>;
+/**
+ * The hint after an engine error on `and`, `or` or `not` given something
+ * other than a Boolean, which Pure's precedence usually causes: comparisons
+ * bind no tighter than `&&`, `||` and `!` (PLAN §11.11)
+ */
+export declare const EXPRESSION_FILTER_PARENTHESES_HINT = "Put each comparison in parentheses: ($x.A > 1) && ($x.B > 3).";
+/** What the Filter by Expression editor says about conditions (PLAN §11.11) */
+export declare const EXPRESSION_FILTER_EDITOR_NOTES: readonly ["A condition of one row, written as in Query's text mode: x | $x.SHIPPED_DATE > $x.REQUIRED_DATE. The rows for which it is true are kept, in their order.", "Put each comparison in parentheses when you combine them: ($x.A > 1) && ($x.B > 3). In Pure, &&, || and ! bind as tightly as >, <, >= and <=; == binds tighter.", "A column that can be empty, compared directly ($x.A > 6), fails the condition when it is empty and passes its negation. After ->toOne(), an empty value fails both.", "Validate (F10) checks the condition with the engine and plans it for the cube's database.", "startsWith, endsWith and contains can't take a value with a backslash (\\) yet, nor, on DuckDB, one with % or _."];
+/** The hint after an engine error on a column that can be empty, in arithmetic (PLAN §11.7) */
+export declare const EXTEND_TO_ONE_HINT = "A column that can be empty needs ->toOne() first, such as $x.QTY->toOne() + 1.";
+/** The problem a database refusing an Extend's or a Filter by Expression's plan gives (PLAN §11.7, §11.11) */
+export declare const getExtendPlanProblem: (databaseType: string | undefined, detail: string) => string;
 /** Under the Rename editor's rows: the rule for new column names (PLAN §11.4) */
 export declare const COLUMN_NAME_RULES_HINT = "Names can't start or end with a space, or contain \" or \\ or control characters, and have at most 128 characters.";
+/**
+ * A node type's label as the node editor's title shows it, each word
+ * capitalised but `a`, `an` and `of` (QUESTIONS.md U1(a)), e.g. 'Take a Range
+ * of Rows'; the registry keeps its own wording
+ */
+export declare const toEditorTitle: (label: string) => string;
+/** The source dialog's body until a tab is chosen, opened from the empty canvas (spec §17.8, U4(b)) */
+export declare const SELECT_SOURCE_TYPE_PROMPT = "Select source type above";
+/** Why the source dialog's Add is disabled: nothing picked yet, or not ready */
+export declare const CUBE_PICK_TO_ADD_TITLE = "Pick what to add first";
+/**
+ * The badge a node type shows beside its name: WIP for one that doesn't
+ * work yet (a service, PLAN §6.4), else BETA for one in beta, else none
+ */
+export declare const getCubeNodeBadge: (definition: {
+    readonly beta: boolean;
+    readonly wip?: boolean | undefined;
+}) => "WIP" | "BETA" | undefined;
 //# sourceMappingURL=LegendCubeLabels.d.ts.map

package/lib/__lib__/LegendCubeLabels.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"LegendCubeLabels.d.ts","sourceRoot":"","sources":["../../src/__lib__/LegendCubeLabels.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAK/D,uEAAuE;AACvE,eAAO,MAAM,iBAAiB,OAAO,CAAC;AACtC,6FAA6F;AAC7F,eAAO,MAAM,2BAA2B,SAAU,CAAC;AACnD,4CAA4C;AAC5C,eAAO,MAAM,cAAc,MAAM,CAAC;AAElC,oBAAY,yBAAyB;IACnC,SAAS,0BAA0B;IACnC,iBAAiB,kCAAkC;CACpD;AAED,eAAO,MAAM,iBAAiB,kBAAkB,CAAC;AACjD,6FAA6F;AAC7F,eAAO,MAAM,oBAAoB,8FAC4D,CAAC;AAC9F,sEAAsE;AACtE,eAAO,MAAM,cAAc,WAAW,CAAC;AAEvC,0EAA0E;AAC1E,oBAAY,kBAAkB;IAC5B,aAAa,kBAAkB;IAC/B,gBAAgB,qBAAqB;IACrC,eAAe,oBAAoB;IACnC,eAAe,oBAAoB;IACnC,iBAAiB,sBAAsB;CACxC;AAED,eAAO,MAAM,gBAAgB,GAAI,MAAM,MAAM,KAAG,MAAM,GAAG,SAKxD,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAAI,UAAU,MAAM,KAAG,MACgC,CAAC;AAEzF,oEAAoE;AACpE,eAAO,MAAM,sBAAsB,EAAE,QAAQ,CAC3C,MAAM,CAAC,aAAa,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,CAc9D,CAAC;AAEF,2GAA2G;AAC3G,eAAO,MAAM,kBAAkB,GAAI,QAAQ,YAAY,KAAG,MACC,CAAC;AAK5D,8EAA8E;AAC9E,eAAO,MAAM,qBAAqB,GAAI,SAAS,SAAS,MAAM,EAAE,KAAG,MAChB,CAAC;AAEpD,6GAA6G;AAC7G,eAAO,MAAM,qBAAqB,GAAI,MAAM,UAAU,KAAG,MAiBxD,CAAC;AAEF,0EAA0E;AAC1E,eAAO,MAAM,gCAAgC;;;CAG5C,CAAC;AAEF,8DAA8D;AAC9D,eAAO,MAAM,iCAAiC;;;;4BAKpB,MAAM,KAAG,MAAM;8BAEb,MAAM,KAAG,MAAM;CAE1C,CAAC;AAEF,+EAA+E;AAC/E,eAAO,MAAM,4BAA4B,6DACmB,CAAC;AAE7D,2EAA2E;AAC3E,eAAO,MAAM,gBAAgB,iIACmG,CAAC;AAEjI,4DAA4D;AAC5D,oBAAY,yBAAyB;IACnC,YAAY,gBAAgB;IAC5B,YAAY,gBAAgB;IAC5B,aAAa,iBAAiB;CAC/B;AAED,oFAAoF;AACpF,eAAO,MAAM,qBAAqB,GAChC,QAAQ,MAAM,EACd,QAAQ,yBAAyB,KAChC,MAQF,CAAC;AAEF,qFAAqF;AACrF,eAAO,MAAM,uBAAuB,GAAI,WAAW,MAAM,KAAG,MACkB,CAAC;AAE/E,iGAAiG;AACjG,eAAO,MAAM,gBAAgB,mEACqC,CAAC;AAEnE,qEAAqE;AACrE,eAAO,MAAM,oBAAoB,0EACwC,CAAC;AAE1E,iFAAiF;AACjF,eAAO,MAAM,sBAAsB,uHACmF,CAAC"}
+{"version":3,"file":"LegendCubeLabels.d.ts","sourceRoot":"","sources":["../../src/__lib__/LegendCubeLabels.ts"],"names":[],"mappings":"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"}