@finos/legend-cube-builder 0.0.2 → 0.0.3

package/README.md

@@ -3,4 +3,63 @@
 The UI and the Legend engine adapter of Legend Cube, a canvas-based visual query builder. The domain model lives in the
 host-free [`@finos/legend-cube`](../legend-cube).
 
-Legend Query mounts Legend Cube at `/query/cube`.
+It holds the page (the canvas, the palette, the side-panel editors, the source picker and the results grid), its MobX
+stores, the engine port with its `v1/` adapter, and the bundled model catalog. Legend Query hosts the page at
+`/query/cube`.
+
+**Status:** work in progress, version 0.0.x. This version has relational tables, Join, Sort, Filter, Restrict, Rename, Distinct, Drop, Limit and Slice, with one model, one
+runtime and one database per query. A cube is kept only through Export and Import of its spec, marked "(dev)", until
+the Cube store exists. A pasted model is kept in the cube. Nothing links to the page yet, there is no redo, and Cube sends no telemetry.
+
+## Layout
+
+| Folder                                | Holds                                                                                                                                                   |
+| ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `src/components/`                     | the page, `CubeEditor`, and its parts: `canvas/`, `palette/`, `editors/`, `source-picker/`, `grid/`, `show-pure/`, `spec-transfer/`                     |
+| `src/stores/`                         | the MobX state of the page, its parts and the side panel; `editors/` (node drafts); `LocalModelCatalog` and `fixtures/` (the bundled model); `CubeHost` |
+| `src/graph-manager/`                  | the engine port (`CubeEngine.ts`) and `buildCubeEngine`                                                                                                 |
+| `src/graph-manager/protocol/pure/v1/` | the engine adapter, `V1_LegendCubeEngine`: the lambda serializer, the result and relation-type readers, the error mapping                               |
+| `src/__lib__/`                        | labels, help text, the command config and test ids                                                                                                      |
+| `src/__test-utils__/`                 | the fake engine and the helpers of the tests                                                                                                            |
+| `style/`                              | the stylesheet, built to `lib/index.css`                                                                                                                |
+
+It depends on `@finos/legend-cube`, legend-graph, legend-application, legend-art, legend-lego and legend-shared, never
+on an application package (`legend-application-*`) or on legend-query-builder.
+
+**The V1 rule:** `V1_*` protocol code lives under `src/graph-manager/protocol/pure/v1/`. The one product file outside
+it that names `V1_*` is the seam `src/graph-manager/protocol/pure/CubeEngineBuilder.ts`: `buildCubeEngine` is the only
+product code that makes a `V1_LegendCubeEngine`, so hosts never name a `V1_*` symbol. The repo's
+`enforce-module-import-hierarchy` lint rule forbids imports between `stores/` or `components/` and `v1/`, both ways.
+The engine-backed tests in `src/__tests__/` are an exception: they need both the adapter and `stores/`.
+
+## Public API
+
+`src/index.ts` exports:
+
+- `CubeEditor`, the page, and `CubeHost`, what a host gives it;
+- the engine port, everything in `CubeEngine.ts` (`CubeEngine`, `CubeEngineError`, `CubeEngineErrorKind`,
+  `CubeResult`, `CubeModelOutline`, …), with `buildCubeEngine` and `CubeEngineConfig`;
+- `LocalModelCatalog` and `BUNDLED_MODELS`;
+- `LEGEND_CUBE_COMMAND_CONFIG` and `LEGEND_CUBE_COMMAND_KEY`, the page's shortcuts;
+- `LEGEND_CUBE_TEST_ID`;
+- helpers that 0.0.2 published and nothing outside the package uses yet: `getRuntimesForDatabase`, `createTextModel`,
+  `BundledModel`, and the bundled model's `CUBE_NORTHWIND_MODEL`, `CUBE_NORTHWIND_DATABASE` and
+  `CUBE_NORTHWIND_RUNTIME`.
+
+The node-type registries (drafts, editors, help text and icons) are internal: there is no plugin API for node types
+yet.
+
+## New source kinds
+
+Adding a kind of source (beyond relational tables) is not a registration yet. The builder is wired to relational
+tables in `CubeEditorState` (re-checking tables, opening the picker), `CubeSourcePickerState`, `CubeJoinDraft`,
+`CubeSourceEditor`, and the port's `resolveSchemas` and `CubeModelOutline`. New sources wait on the design of the
+sources dialog.
+
+## Documentation
+
+- [Hosting the page](./docs/hosting.md): what a host gives the page, the shortcuts, the stylesheet, and the dev loop.
+- [Testing](./docs/testing.md): the test groups, the fake engine, and the tests against a real engine.
+- [Adding an operation](./docs/adding-an-operation.md): the builder half of a new transform. The core half is in
+  [`@finos/legend-cube`](../legend-cube/docs/adding-an-operation.md).
+- [The plan](../../docs/wip/legend-cube/PLAN.md) and [the known issues](../../docs/wip/legend-cube/ISSUES.md).

package/docs/adding-an-operation.md

@@ -0,0 +1,92 @@
+# Adding an operation: the builder half
+
+Start with the core half, in [`@finos/legend-cube`'s guide](../../legend-cube/docs/adding-an-operation.md): the
+node, its messages, emitter and codec, and its entry in the node registry. The palette, the context menu and the
+canvas read that registry, so the new type shows there with no change here.
+
+The builder adds four pieces: a draft, an editor and help text, in registries keyed by node type, and an icon, keyed by
+the icon name the node's definition gives. Join and Filter are the examples to follow.
+
+## 1. A draft
+
+The side panel never edits the document: an editor edits a draft, and the panel's **Apply** stores the draft's node
+as one undo step (**Cancel** drops it).
+
+- In `src/stores/editors/Cube<Type>Draft.ts`, extend `CubeNodeDraft<Type>`: observable fields for the settings being
+  edited, actions that change them, and `build()`. `build()` returns `original` itself while nothing was edited, and
+  otherwise a new node with the same id and `rest`. The panel also treats a node that saves the same as `original`
+  as no change.
+- Register a factory in `CUBE_NODE_DRAFT_FACTORIES` (`src/stores/editors/CubeNodeDraftRegistry.ts`).
+- A transform with nothing to set, such as Distinct, has no draft: it registers an editor that only describes it
+  (`CubeDistinctEditor`) and is listed in `CUBE_NODE_TYPES_WITHOUT_SETTINGS`, which the registry test skips when it
+  asks for a factory. The panel then shows no Apply or Cancel (PLAN §7.4 item 2).
+
+## 2. An editor
+
+- In `src/components/editors/Cube<Type>Editor.tsx`, an `observer` component taking `CubeNodeEditorProps`:
+  `editorState`, `draft`, `inputSchemas` (the inputs' schemas in port order; the panel shows the editor only once all
+  are there) and `readOnly` (a cube saved by a newer version: show, don't edit).
+- It changes only the draft. An action on the document, such as Join's Swap Inputs, goes through
+  `editorState.nodeEditor`, which applies the draft first.
+- `CubeColumnPicker` picks a column from a schema, and `CubeValueEditor` takes a value as a column's type wants it.
+  `isColumnDisabled` gives the reason a column can't be picked, shown after its type, as Sort does for a type that can't
+  be sorted (`isSortableType`) and a column another row has; the column stays shown.
+- A whole-number setting (a size, a row index) is a `CubeIntegerField` over text the draft keeps as typed, read with
+  `parseWholeNumberText` (`src/stores/editors/CubeIntegerText.ts`): an optional sign and digits, nothing else, and empty
+  text gives `undefined`, which the node reports. Never `Number()` the raw text (it reads `''` as 0, `0x10` as 16 and
+  `1e3` as 1000) and never fall back to a default. `CubeRowCountDraft` and `CubeRowCountEditor` (Limit's) are the
+  example.
+- Give each control a stable `aria-label` (numbered per row in a list, e.g. `Sort column 2`): the tests and the
+  browser rehearsal find controls by it.
+- An editor must work in either host: today's side panel, or a floating editor anchored under the node, which M3
+  decides on (PLAN §11.4, §12.2 question 1). Don't rely on the panel's height: a list scrolls on its own (a
+  `max-height` with `overflow: auto`), column and direction pickers stay native `<select>` elements, as
+  `CubeColumnPicker` is, and no editor measures the panel or reads its size.
+- A Tailwind class no other file uses yet, such as an arbitrary `grid-cols-[…]`, does nothing in the dev server until
+  the deployment's Tailwind build runs again ([hosting.md](./hosting.md)); jsdom tests don't see it either way, so
+  check a new layout in the browser.
+- Register it in `CUBE_NODE_EDITORS` (`src/components/editors/CubeNodeEditorRegistry.ts`).
+
+## 3. Help text
+
+An entry in `CUBE_NODE_HELP_TEXT` (`src/__lib__/LegendCubeHelpText.ts`), shown in the panel's header. Use the spec's
+text (§17.9) where it has one.
+
+## 4. An icon
+
+Map the icon name of the node's definition to a legend-art icon in `NODE_ICONS` (`src/components/CubeNodeIcon.tsx`).
+
+## Warnings
+
+A warning is never an error: it doesn't make the node invalid or keep Execute from running. A warning worked out from
+the query, as the Sort warning is (`findLostSortOrders` in the core), goes in `CubeEditorState.derivedWarnings`, by
+node id, so it follows every edit and undo and is never stored; one about the outside world, such as a table that
+changed, is stored in `CubeEditorState.warnings`, by node key. `getNodeWarnings(node)` gives both: the canvas marks the
+node (`legend-cube__node--warning`) and lists them in its tooltip after its errors, and the panel shows each one as a
+`role="status"` line above the editor. A derived warning waits until the nodes it names have no errors of their own.
+
+## Columns that change name
+
+The Join editor warns when a join key's column has no type in the model, tracing the column back to its table and the
+table's own name for it with `findColumnOrigins` (`src/stores/editors/CubeJoinDraft.ts`). It requires each node's
+output to have the column, maps a Rename's new name back to its old one, and follows a Join's same-named keys to the
+side the join keeps. Every other node is taken to pass its input's columns through under the same name. If a new
+transform's output columns aren't its inputs' under the same name (a computed column, say), teach `findColumnOrigins`
+how they map back, or the warning goes missing or shows on the wrong column.
+
+## Tests
+
+- `src/components/editors/__tests__/CubeNodeEditorRegistry.test.ts` fails for a type missing a piece: it checks every
+  registered type for help text, an icon and an editor, and that each transform's draft gives back its node until
+  edited. Add the new help text to its exact list.
+- Add the new item, in the spec's menu order, to the lists in `src/components/palette/__tests__/CubePalette.test.tsx`
+  and to `TRANSFORMS` in `src/components/canvas/__tests__/CubeCanvasContextMenu.test.tsx`.
+- A draft test (`src/stores/editors/__tests__/`) and an editor test (`src/components/editors/__tests__/`), as Join's
+  and Filter's are.
+- An engine test of the operation in `src/__tests__/LegendCubeOperations.engine-roundtrip-test.ts` (see
+  [Testing](./testing.md)): its lambda as the engine parses the printed Pure, its typing against Cube's inferred
+  schema, and what it returns, not its text.
+
+The `v1/` adapter (`V1_CubeLambdaSerializer`) needs no change while the operation's emitter uses only IR and literal
+kinds it already writes. A new kind of IR node or literal needs its own case there, with a test in
+`src/graph-manager/protocol/pure/v1/__tests__/`.

package/docs/hosting.md

@@ -0,0 +1,79 @@
+# Hosting the Cube page
+
+A Legend application hosts the page by giving it a `CubeHost` and contributing its shortcuts. Legend Query is the
+host today: `LegendQueryCubeHost` (`src/stores/cube/`), and the lazy route and page (`src/components/cube/`) of
+`@finos/legend-application-query`.
+
+## The host
+
+```ts
+interface CubeHost {
+  readonly applicationStore: GenericLegendApplicationStore;
+  readonly engine: CubeEngine;
+  readonly modelCatalog: LocalModelCatalog;
+}
+```
+
+- **The application store** gives the page its commands, user data, clipboard, theme, notifications and alerts, and
+  its telemetry service, which Cube doesn't use yet: it sends no events. Cube keeps no auth or config of its own.
+- **The engine:** `buildCubeEngine(config, tracerService)` builds Legend's implementation of the `CubeEngine` port.
+  `config` is the engine client's configuration (`CubeEngineConfig`); Legend Query passes its own engine server URL
+  and options, so Cube talks to the engine its query editor uses.
+- **The models:** `new LocalModelCatalog(engine)`. It offers `BUNDLED_MODELS` (the "Northwind (Cube fixture)" model)
+  and caches each model's outline: its tables, for the source picker, and its runtimes' connections with their
+  database types, which Drop, Slice, Limit and Distinct need on some databases (PLAN §11.4). Users can also paste a Pure
+  model.
+
+Render the page with `<CubeEditor host={host} />`, and pass `initialDocument` to open a given cube. The page's state
+lives as long as the page; Legend Query makes a new host on each visit.
+
+**The bundled model runs only on an engine that allows LocalH2.** It sets up Northwind in an in-memory H2 database
+through its connection's `testDataSetupSqls`. On an engine that forbids LocalH2, its queries don't run.
+
+## Shortcuts
+
+A Legend application binds keys only through its plugins. The host returns the page's commands from one of its
+plugins:
+
+```ts
+override getExtraKeyedCommandConfigEntries(): KeyedCommandConfigEntry[] {
+  return collectKeyedCommandConfigEntriesFromConfig(LEGEND_CUBE_COMMAND_CONFIG);
+}
+```
+
+The page registers the commands while it is open: F9 runs the query, and Ctrl+Z or Cmd+Z undoes.
+
+## The stylesheet
+
+- Import `@finos/legend-cube-builder/lib/index.css` in the host's stylesheet (Legend Query does it in
+  `legend-application-query-bootstrap/style/index.scss`). The page's root element has the class `legend-cube`.
+- The page uses Tailwind classes. The host's Tailwind build must scan the builder's sources: Legend Query's deployment
+  scans `../legend-*/src/**/*.tsx`. So Tailwind classes go in `.tsx` files only.
+- React Flow's stylesheet comes with the canvas. Load the page lazily, as Legend Query does, to keep it and the page's
+  libraries out of the host's main bundle.
+
+## The dev loop
+
+1. Start an engine on `localhost:6300` that allows LocalH2: legend-engine's `org.finos.legend.engine.server.Server`
+   from an IDE, or the repo's docker compose
+   (`fixtures/legend-docker-setup/grammar-test-setup/grammar-test-setup-docker-compose.yml`). Check it with
+   `curl -s localhost:6300/api/server/v1/info`.
+2. Run `yarn build` once: `yarn dev:ts` doesn't build the stylesheets.
+3. Run `yarn dev:ts` and `yarn dev:query`, and open `http://localhost:9001/query/cube`.
+4. Run `yarn workspace @finos/legend-cube-builder dev:sass` to rebuild the stylesheet as you change it (the root
+   `yarn dev:ts` already rebuilds the TypeScript).
+
+If Tailwind classes seem to do nothing, the deployment's Tailwind watcher may have stopped: it exits when
+`yarn dev:query` runs without a terminal. Restart it in a terminal of its own with
+`yarn workspace @finos/legend-application-query-deployment dev:tailwindcss`, or rebuild once with `build:tailwindcss`
+(again after each new class).
+
+**A second checkout.** To run a second copy next to the first (another git worktree, say), give it its own port and
+skip the watchers you don't need: in that checkout, run `yarn install`, `yarn build` and
+`yarn workspace @finos/legend-application-query-deployment setup` once, then
+`yarn workspace @finos/legend-application-query-deployment build:tailwindcss` and
+`yarn workspace @finos/legend-application-query-deployment dev:webpack --port 9002`, and open
+`http://localhost:9002/query/cube`. The dev server serves the packages' built `lib/`, so rebuild what you change
+(`yarn workspace @finos/legend-cube-builder build:ts`, and `@finos/legend-cube`'s) before looking, or run `yarn dev:ts`.
+
+The manual check of the whole page is the plan's Part B (PLAN §11.2).

package/docs/testing.md

@@ -0,0 +1,83 @@
+# Testing Legend Cube's builder
+
+The builder has two test groups:
+
+- **`core`** (the default group): unit tests and jsdom page tests against a fake engine. No engine needed:
+  `TEST_GROUP=core yarn workspace @finos/legend-cube-builder test`.
+- **`engine-roundtrip`**: tests against a real engine on `localhost:6300`, in files named
+  `*.engine-roundtrip-test.ts`: `TEST_GROUP=engine-roundtrip yarn workspace @finos/legend-cube-builder test`.
+
+A plain `yarn workspace @finos/legend-cube-builder test` runs both, so it fails without an engine. Add a path pattern to
+run some files, e.g. `TEST_GROUP=core yarn workspace @finos/legend-cube-builder test source-picker`. The core
+(`@finos/legend-cube`) has no engine tests.
+
+## Page tests, against a fake engine
+
+- `const { host, fake } = TEST__createCubeHost()` gives a host over `createFakeCubeEngine()`'s engine, and `fake`,
+  its Jest mocks, answering from `FAKE_NORTHWIND_OUTLINE` and `FAKE_NORTHWIND_SCHEMAS`. Override an answer per test,
+  e.g. `fake.execute.mockRejectedValueOnce(…)`, or pass answers to `TEST__createCubeHost(answers)`.
+- `TEST__renderInCubeApplication(<CubeEditor host={host} />, host.applicationStore, LEGEND_CUBE_TEST_ID.EDITOR)`
+  renders the page in a Legend application and waits for it.
+- A test of one part of the page makes the state itself, `new CubeEditorState(host, document)`, and renders the part
+  with it, e.g. `<CubeCanvas editorState={editorState} />` and `<CubeNodeEditorPanel editorState={editorState} />`
+  (as `CubeJoinEditor.test.tsx` does). `TEST__importDocument(editorState, document)` then imports a cube and waits
+  for its tables to be typed again, so nothing changes after the test. A `<CubeEditor>` test has no handle on the
+  state, so it imports through the Import dialog.
+- `TEST__findCanvasNode(id)`, `TEST__getCanvasNodes()` and `TEST__getCanvasNodeTooltip(node)` read the canvas.
+- `src/__test-utils__/CubeNorthwindTestQueries.ts` has the Northwind tables' columns and ready-made queries, e.g.
+  `sliceQuery()`.
+
+What jsdom can't do:
+
+- **Fit the canvas.** jsdom measures nothing, so React Flow never reports the nodes measured and the refit never runs.
+  Check fitting in a browser (PLAN §11.2 Part B).
+- **Show Chrome's own behaviour**, e.g. its date input sending React no Enter key.
+- **Print a failing comparison of two queries.** A query holds `BigInt`s, which Jest can't print, so a failing
+  `toBe` between queries crashes the worker. Compare them as booleans: `expect(a === b).toBe(true)`.
+
+Drag and drop goes through react-dnd's HTML5 backend: fire `dragStart`, `dragEnter`, `dragOver`, `drop` and
+`dragEnd` on the elements.
+
+**Proving a test.** To show a new test fails without the code it covers, change the code in a copy of the package
+outside the checkout, never in place: a running `yarn dev:ts` rebuilds `lib/` from the changed file, and the dev server
+would serve it.
+
+## Engine tests
+
+- **The engine:** a local legend-engine, or the repo's docker compose
+  (`fixtures/legend-docker-setup/grammar-test-setup/grammar-test-setup-docker-compose.yml`), on `localhost:6300`. CI
+  runs the group on that docker image.
+- **No `fetch` in Jest:** the repo's Jest setup blocks it. Engine tests reach the engine through axios: the
+  `CUBE_ENGINE_TEST__*` helpers (`src/__test-utils__/CubeEngineTestSupport.ts`) for direct calls, and
+  `V1_createEngineBackedCubeEngine()` (`src/graph-manager/protocol/pure/v1/__test-utils__/`). The latter returns
+  `{ engine, calls }`: a real `V1_LegendCubeEngine` whose client calls are spied onto those helpers (and legend-graph's
+  `ENGINE_TEST_SUPPORT__grammarToJSON_model`), and the spies. Make it in `beforeEach` or in the test: the repo's Jest
+  config restores mocks before each test, so an engine made in `beforeAll` would call the real client, and the
+  blocked `fetch`.
+- **Assert meaning, not text.** The CI engine image changes with every engine merge, so assert row counts, the set of
+  keys returned, types and nullability, not SQL or Pure formatting, and never an engine answer that is a known
+  defect.
+- **Rows come back in the database's order** unless a Sort reaches the node that runs, and H2's order changes between
+  queries, so compare counts and sets, never positions, without a Sort. Facts of the Cube Northwind data a test may
+  rely on: ORDERS has 830 orders, `ORDER_ID` running from 10248 to 11077 with no gap. Avoid comparing or sorting on its
+  32-bit `REAL` columns (`FREIGHT`, `UNIT_PRICE`, `DISCOUNT`), where exact equality silently matches nothing.
+- `src/__tests__/LegendCubeNorthwind.engine-roundtrip-test.ts` is the slice's automated acceptance (PLAN §11.2 Part
+  A). It logs the engine's commit.
+- `src/__tests__/LegendCubeOperations.engine-roundtrip-test.ts` checks each operation: its lambda as the engine parses
+  the printed Pure, its typing against Cube's inferred schema, and its rows. Its helpers are in
+  `src/__test-utils__/CubeOperationsTestUtils.ts`; they take any `CubeEngine` and import no `V1_*` class.
+- **Sort descending in order tests.** H2 scans ORDERS in ascending `ORDER_ID` order, so a test that sorts ascending,
+  or numbers rows by `ORDER_ID`, passes without the sort; the operations tests sort descending, with a control test
+  pinning H2's own order.
+- **Database workarounds** (PLAN §11.4) are checked two ways. The operations tests write them for `SqlServer` and run
+  them on the fixture's H2, which takes both forms, so their rows can be compared with the native forms'.
+  `src/__tests__/LegendCubeDialects.engine-roundtrip-test.ts` plans them, never running anything, on a test-only copy
+  of the fixture model with a static connection per database type (`CUBE_ENGINE_TEST__generatePlanSql`), and checks
+  facts about the SQL: row numbers in the Sort's order, no `limit m,n`, no `top N distinct`. A check that should catch
+  a missing workaround must fail without it: run it once with the workaround off before relying on it.
+- `src/__tests__/CubeNorthwindRelationTypes.json` records the engine's relation type for every table of the bundled
+  model. If the test comparing with it fails, the engine's typing changed: check the change, then record the file
+  again by hand.
+
+The engine tests in `src/__tests__/` import `V1_*` classes there, as an exception to the V1 rule: they need both the
+`v1/` adapter and `stores/`, which the import-hierarchy lint rule keeps apart.

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

@@ -1 +1 @@
-{"version":3,"file":"LegendCubeHelpText.d.ts","sourceRoot":"","sources":["../../src/__lib__/LegendCubeHelpText.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAYH,eAAO,MAAM,mBAAmB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAOhE,CAAC;AAEF,2DAA2D;AAC3D,eAAO,MAAM,mBAAmB,iGACgE,CAAC"}
+{"version":3,"file":"LegendCubeHelpText.d.ts","sourceRoot":"","sources":["../../src/__lib__/LegendCubeHelpText.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAoBH,eAAO,MAAM,mBAAmB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAmBhE,CAAC;AAEF,2DAA2D;AAC3D,eAAO,MAAM,mBAAmB,iGACgE,CAAC"}

package/lib/__lib__/LegendCubeHelpText.js

@@ -13,13 +13,21 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import { Filter, Join, RelationalTableSource, UnknownNode, } from '@finos/legend-cube';
-// The node editor's help text, verbatim from the original (spec §17.9). A
-// new node type adds its entry here.
+import { Distinct, Drop, Filter, Join, Limit, RelationalTableSource, Rename, Restrict, 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.
 export const CUBE_NODE_HELP_TEXT = {
     [RelationalTableSource.TYPE]: 'Sources data from relational database table.',
+    [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.',
     [Filter.TYPE]: 'Reduces the number of rows in the previous data set, keeping only rows matching the specified criteria.',
     [Join.TYPE]: 'Joins two previous data sets using specified columns as join keys.',
+    [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.',
+    [Slice.TYPE]: 'Reduces the number of rows in the previous data set, keeping only the rows from position "start" up to, but not including, position "stop", counting from 0.',
+    [Sort.TYPE]: 'Reorders rows of the previous data set by one or more columns, either in ascending or descending order per column.',
     [UnknownNode.TYPE]: 'Source or transformation unknown to the application.',
 };
 /** The tooltip of the editor's Select link (spec §17.9) */

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,MAAM,EACN,IAAI,EACJ,qBAAqB,EACrB,WAAW,GACZ,MAAM,oBAAoB,CAAC;AAE5B,0EAA0E;AAC1E,qCAAqC;AAErC,MAAM,CAAC,MAAM,mBAAmB,GAAqC;IACnE,CAAC,qBAAqB,CAAC,IAAI,CAAC,EAAE,8CAA8C;IAC5E,CAAC,MAAM,CAAC,IAAI,CAAC,EACX,yGAAyG;IAC3G,CAAC,IAAI,CAAC,IAAI,CAAC,EACT,oEAAoE;IACtE,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,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"}

package/lib/__lib__/LegendCubeLabels.d.ts

@@ -51,6 +51,19 @@ export declare const getColumnTypeLabel: (column: SchemaColumn) => string;
 export declare const formatDisabledReasons: (reasons: readonly string[]) => 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 */
+export declare const CUBE_SORT_COLUMN_DISABLED_REASON: {
+    NOT_SORTABLE: string;
+    TAKEN: string;
+};
+/** Why the grid's quick actions (spec §12.4) can't be used */
+export declare const CUBE_QUICK_ACTION_DISABLED_REASON: {
+    STALE_ROWS: string;
+    RUNNING: string;
+    UNREADABLE_VALUE: string;
+    notSortable: (typeName: string) => string;
+    notComparable: (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 editor's note on NULLs (D4): negated conditions keep them */
@@ -65,4 +78,10 @@ export declare enum CUBE_EDITOR_CLOSED_REASON {
 export declare const getEditorClosedNotice: (nodeId: string, reason: CUBE_EDITOR_CLOSED_REASON) => string;
 /** The warning on a source with saved columns that the engine couldn't type again */
 export declare const getSourceRecheckWarning: (firstLine: string) => string;
+/** Under the Slice editor's fields: the range counts from 0, and leaves out its stop row (D5) */
+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.";
+/** 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.";
 //# 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,+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"}
+{"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"}

package/lib/__lib__/LegendCubeLabels.js

@@ -84,6 +84,19 @@ export const getSchemaDriftWarning = (diff) => {
     ];
     return `This table changed since the cube was saved: ${changes.join('; ')}`;
 };
+/** Why the Sort editor's picker doesn't offer a column, after its type */
+export const CUBE_SORT_COLUMN_DISABLED_REASON = {
+    NOT_SORTABLE: "can't be sorted",
+    TAKEN: 'already sorted on',
+};
+/** Why the grid's quick actions (spec §12.4) can't be used */
+export const CUBE_QUICK_ACTION_DISABLED_REASON = {
+    STALE_ROWS: 'Execute again: these rows are from an earlier version of the query.',
+    RUNNING: 'Wait for the run to finish.',
+    UNREADABLE_VALUE: "This value can't be used in a filter.",
+    notSortable: (typeName) => `Values of type ${typeName} can't be sorted.`,
+    notComparable: (typeName) => `Values of type ${typeName} can't be compared.`,
+};
 /** Beside a condition comparing a floating-point column for equality (R133) */
 export const FILTER_FLOAT_COMPARISON_HINT = 'exact comparison on floating-point columns may not match';
 /** The Filter editor's note on NULLs (D4): negated conditions keep them */
@@ -106,4 +119,10 @@ export const getEditorClosedNotice = (nodeId, reason) => {
 };
 /** The warning on a source with saved columns that the engine couldn't type again */
 export const getSourceRecheckWarning = (firstLine) => `Could not re-check this table, so it keeps its saved columns: ${firstLine}`;
+/** Under the Slice editor's fields: the range counts from 0, and leaves out its stop row (D5) */
+export 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 const DISTINCT_EDITOR_TEXT = 'Keeps one row of each set of identical rows. There is nothing to set.';
+/** Under the Rename editor's rows: the rule for new column names (PLAN §11.4) */
+export 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.';
 //# sourceMappingURL=LegendCubeLabels.js.map

package/lib/__lib__/LegendCubeLabels.js.map

@@ -1 +1 @@
-{"version":3,"file":"LegendCubeLabels.js","sourceRoot":"","sources":["../../src/__lib__/LegendCubeLabels.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAE/D,2EAA2E;AAC3E,4BAA4B;AAE5B,uEAAuE;AACvE,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,CAAC;AACtC,6FAA6F;AAC7F,MAAM,CAAC,MAAM,2BAA2B,GAAG,OAAO,CAAC;AACnD,4CAA4C;AAC5C,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,CAAC;AAElC,MAAM,CAAN,IAAY,yBAGX;AAHD,WAAY,yBAAyB;IACnC,gEAAmC,CAAA;IACnC,gFAAmD,CAAA;AACrD,CAAC,EAHW,yBAAyB,KAAzB,yBAAyB,QAGpC;AAED,MAAM,CAAC,MAAM,iBAAiB,GAAG,eAAe,CAAC;AACjD,6FAA6F;AAC7F,MAAM,CAAC,MAAM,oBAAoB,GAC/B,2FAA2F,CAAC;AAC9F,sEAAsE;AACtE,MAAM,CAAC,MAAM,cAAc,GAAG,QAAQ,CAAC;AAEvC,0EAA0E;AAC1E,MAAM,CAAN,IAAY,kBAMX;AAND,WAAY,kBAAkB;IAC5B,qDAA+B,CAAA;IAC/B,2DAAqC,CAAA;IACrC,yDAAmC,CAAA;IACnC,yDAAmC,CAAA;IACnC,6DAAuC,CAAA;AACzC,CAAC,EANW,kBAAkB,KAAlB,kBAAkB,QAM7B;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,IAAY,EAAsB,EAAE;IACnE,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IAClC,OAAO,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC;QACpE,CAAC,CAAC,qDAAqD;QACvD,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,QAAgB,EAAU,EAAE,CAC/D,qBAAqB,QAAQ,CAAC,cAAc,CAAC,OAAO,CAAC,iCAAiC,CAAC;AAEzF,oEAAoE;AACpE,MAAM,CAAC,MAAM,sBAAsB,GAE/B;IACF,CAAC,aAAa,CAAC,WAAW,CAAC,EAAE;QAC3B,KAAK,EAAE,aAAa;QACpB,WAAW,EAAE,8DAA8D;KAC5E;IACD,CAAC,aAAa,CAAC,cAAc,CAAC,EAAE;QAC9B,KAAK,EAAE,gBAAgB;QACvB,WAAW,EAAE,iDAAiD;KAC/D;IACD,CAAC,aAAa,CAAC,YAAY,CAAC,EAAE;QAC5B,KAAK,EAAE,cAAc;QACrB,WAAW,EAAE,wDAAwD;KACtE;CACF,CAAC;AAEF,2GAA2G;AAC3G,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,MAAoB,EAAU,EAAE,CACjE,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;AAE5D,MAAM,WAAW,GAAG,CAAC,OAAgC,EAAU,EAAE,CAC/D,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAElD,8EAA8E;AAC9E,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,OAA0B,EAAU,EAAE,CAC1E,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,KAAK,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEpD,6GAA6G;AAC7G,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,IAAgB,EAAU,EAAE;IAChE,MAAM,OAAO,GAAG;QACd,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAClE,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACxE,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM;YACrB,CAAC,CAAC;gBACE,WAAW,IAAI,CAAC,OAAO;qBACpB,GAAG,CACF,CAAC,MAAM,EAAE,EAAE,CACT,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,KAAK,kBAAkB,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,kBAAkB,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CACvG;qBACA,IAAI,CAAC,IAAI,CAAC,EAAE;aAChB;YACH,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;KACrD,CAAC;IACF,OAAO,gDAAgD,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AAC9E,CAAC,CAAC;AAEF,+EAA+E;AAC/E,MAAM,CAAC,MAAM,4BAA4B,GACvC,0DAA0D,CAAC;AAE7D,2EAA2E;AAC3E,MAAM,CAAC,MAAM,gBAAgB,GAC3B,8HAA8H,CAAC;AAEjI,4DAA4D;AAC5D,MAAM,CAAN,IAAY,yBAIX;AAJD,WAAY,yBAAyB;IACnC,yDAA4B,CAAA;IAC5B,yDAA4B,CAAA;IAC5B,2DAA8B,CAAA;AAChC,CAAC,EAJW,yBAAyB,KAAzB,yBAAyB,QAIpC;AAED,oFAAoF;AACpF,MAAM,CAAC,MAAM,qBAAqB,GAAG,CACnC,MAAc,EACd,MAAiC,EACzB,EAAE;IACV,MAAM,KAAK,GACT,MAAM,KAAK,yBAAyB,CAAC,YAAY;QAC/C,CAAC,CAAC,GAAG,MAAM,UAAU;QACrB,CAAC,CAAC,MAAM,KAAK,yBAAyB,CAAC,YAAY;YACjD,CAAC,CAAC,GAAG,MAAM,cAAc;YACzB,CAAC,CAAC,yBAAyB,CAAC;IAClC,OAAO,GAAG,KAAK,sBAAsB,MAAM,uCAAuC,CAAC;AACrF,CAAC,CAAC;AAEF,qFAAqF;AACrF,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,SAAiB,EAAU,EAAE,CACnE,iEAAiE,SAAS,EAAE,CAAC"}
+{"version":3,"file":"LegendCubeLabels.js","sourceRoot":"","sources":["../../src/__lib__/LegendCubeLabels.ts"],"names":[],"mappings":"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"}

package/lib/__test-utils__/CubeEngineTestSupport.d.ts

@@ -38,4 +38,10 @@ export declare const CUBE_ENGINE_TEST__execute: (input: object | string) => Prom
     status: number;
     text: () => Promise<string>;
 }>;
+/**
+ * Generates the execution plan of a query, never running it, and gives the
+ * SQL of its nodes, outermost first; a body given as text (with lossless
+ * numbers) is sent as it is
+ */
+export declare const CUBE_ENGINE_TEST__generatePlanSql: (input: object | string) => Promise<string[]>;
 //# sourceMappingURL=CubeEngineTestSupport.d.ts.map

package/lib/__test-utils__/CubeEngineTestSupport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CubeEngineTestSupport.d.ts","sourceRoot":"","sources":["../../src/__test-utils__/CubeEngineTestSupport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,EAIL,KAAK,WAAW,EACjB,MAAM,sBAAsB,CAAC;AAa9B,qDAAqD;AACrD,eAAO,MAAM,2BAA2B,QAAa,OAAO,CAAC,MAAM,CAMlE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,sCAAsC,GACjD,MAAM,MAAM,KACX,OAAO,CAAC,OAAO,CAcf,CAAC;AAEJ,uFAAuF;AACvF,eAAO,MAAM,yCAAyC,GACpD,OAAO,MAAM,KACZ,OAAO,CAAC,WAAW,CAOd,CAAC;AAET,4EAA4E;AAC5E,eAAO,MAAM,yBAAyB,GACpC,OAAO,MAAM,KACZ,OAAO,CAAC,WAAW,CAOd,CAAC;AAET,0DAA0D;AAC1D,eAAO,MAAM,sCAAsC,GACjD,QAAQ,WAAW,EACnB,cAAc,MAAM,GAAG,SAAS,KAC/B,OAAO,CAAC,MAAM,CAeT,CAAC;AAET;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,GACpC,OAAO,MAAM,GAAG,MAAM,KACrB,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAA;CAAE,CAiBtE,CAAC"}
+{"version":3,"file":"CubeEngineTestSupport.d.ts","sourceRoot":"","sources":["../../src/__test-utils__/CubeEngineTestSupport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,EAIL,KAAK,WAAW,EACjB,MAAM,sBAAsB,CAAC;AAa9B,qDAAqD;AACrD,eAAO,MAAM,2BAA2B,QAAa,OAAO,CAAC,MAAM,CAMlE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,sCAAsC,GACjD,MAAM,MAAM,KACX,OAAO,CAAC,OAAO,CAcf,CAAC;AAEJ,uFAAuF;AACvF,eAAO,MAAM,yCAAyC,GACpD,OAAO,MAAM,KACZ,OAAO,CAAC,WAAW,CAOd,CAAC;AAET,4EAA4E;AAC5E,eAAO,MAAM,yBAAyB,GACpC,OAAO,MAAM,KACZ,OAAO,CAAC,WAAW,CAOd,CAAC;AAET,0DAA0D;AAC1D,eAAO,MAAM,sCAAsC,GACjD,QAAQ,WAAW,EACnB,cAAc,MAAM,GAAG,SAAS,KAC/B,OAAO,CAAC,MAAM,CAeT,CAAC;AAET;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,GACpC,OAAO,MAAM,GAAG,MAAM,KACrB,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAA;CAAE,CAiBtE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,iCAAiC,GAC5C,OAAO,MAAM,GAAG,MAAM,KACrB,OAAO,CAAC,MAAM,EAAE,CA0BlB,CAAC"}

package/lib/__test-utils__/CubeEngineTestSupport.js

@@ -73,4 +73,34 @@ export const CUBE_ENGINE_TEST__execute = async (input) => {
         text: async () => response.data,
     };
 };
+/**
+ * Generates the execution plan of a query, never running it, and gives the
+ * SQL of its nodes, outermost first; a body given as text (with lossless
+ * numbers) is sent as it is
+ */
+export const CUBE_ENGINE_TEST__generatePlanSql = async (input) => {
+    const { data } = await axios.post(`${PURE_API}/execution/generatePlan`, input, {
+        headers: JSON_HEADERS,
+        responseType: 'text',
+        transformResponse: (text) => text,
+    });
+    const sql = [];
+    const visit = (node) => {
+        if (Array.isArray(node)) {
+            node.forEach(visit);
+        }
+        else if (node && typeof node === 'object') {
+            Object.entries(node).forEach(([key, value]) => {
+                if (key === 'sqlQuery' && typeof value === 'string') {
+                    sql.push(value);
+                }
+                else {
+                    visit(value);
+                }
+            });
+        }
+    };
+    visit(parseLosslessJSON(data));
+    return sql;
+};
 //# sourceMappingURL=CubeEngineTestSupport.js.map

package/lib/__test-utils__/CubeEngineTestSupport.js.map

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

package/lib/__test-utils__/CubeOperationsTestUtils.d.ts

@@ -0,0 +1,42 @@
+/**
+ * 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 { Query, type QueryNode, RelationalTableSource, Schema } from '@finos/legend-cube';
+import type { CubeEngine, CubeResult, CubeResultValue } from '../graph-manager/CubeEngine.js';
+/** A table of the Cube Northwind model, not resolved yet */
+export declare const TEST__northwindTable: (id: string, table: string, schema?: string) => RelationalTableSource;
+/** The sources, resolved through the engine as the editor resolves them */
+export declare const TEST__resolveSources: (engine: CubeEngine, sources: readonly RelationalTableSource[]) => Promise<RelationalTableSource[]>;
+/** A chain of nodes, each feeding the next on its first port, captured at the last */
+export declare const TEST__chainOf: (nodes: readonly QueryNode[]) => Query;
+/** Every node of the query is valid */
+export declare const TEST__expectValidQuery: (query: Query) => void;
+/**
+ * Runs the query up to its capture node, with this row limit; with a database
+ * type, written as for that database (on the fixture's H2 all the same, so a
+ * workaround's rows can be checked)
+ */
+export declare const TEST__runQuery: (engine: CubeEngine, query: Query, rowLimit: number, databaseType?: string) => Promise<CubeResult>;
+/** The values of one column of a result */
+export declare const TEST__columnValues: (result: CubeResult, column: string) => CubeResultValue[];
+/** The schema Cube infers for a node of the query, its capture node by default */
+export declare const TEST__inferredSchema: (query: Query, nodeId?: string) => Schema;
+/**
+ * The engine types the node as Cube infers it: the same names, in the same
+ * order, of the same types and parameters. Cube's nullability may only be
+ * wider, since the engine misreports it after outer joins (PLAN §4.7).
+ */
+export declare const TEST__expectEngineTyping: (engine: CubeEngine, query: Query, nodeId?: string) => Promise<void>;
+//# sourceMappingURL=CubeOperationsTestUtils.d.ts.map

package/lib/__test-utils__/CubeOperationsTestUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CubeOperationsTestUtils.d.ts","sourceRoot":"","sources":["../../src/__test-utils__/CubeOperationsTestUtils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,EAIL,KAAK,EACL,KAAK,SAAS,EAEd,qBAAqB,EACrB,MAAM,EACP,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EACV,UAAU,EACV,UAAU,EACV,eAAe,EAChB,MAAM,gCAAgC,CAAC;AAUxC,4DAA4D;AAC5D,eAAO,MAAM,oBAAoB,GAC/B,IAAI,MAAM,EACV,OAAO,MAAM,EACb,eAAoB,KACnB,qBAKC,CAAC;AAEL,2EAA2E;AAC3E,eAAO,MAAM,oBAAoB,GAC/B,QAAQ,UAAU,EAClB,SAAS,SAAS,qBAAqB,EAAE,KACxC,OAAO,CAAC,qBAAqB,EAAE,CAiBjC,CAAC;AAEF,sFAAsF;AACtF,eAAO,MAAM,aAAa,GAAI,OAAO,SAAS,SAAS,EAAE,KAAG,KAczD,CAAC;AAEJ,uCAAuC;AACvC,eAAO,MAAM,sBAAsB,GAAI,OAAO,KAAK,KAAG,IAMrD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,cAAc,GACzB,QAAQ,UAAU,EAClB,OAAO,KAAK,EACZ,UAAU,MAAM,EAChB,eAAe,MAAM,KACpB,OAAO,CAAC,UAAU,CAUpB,CAAC;AAEF,2CAA2C;AAC3C,eAAO,MAAM,kBAAkB,GAC7B,QAAQ,UAAU,EAClB,QAAQ,MAAM,KACb,eAAe,EAIjB,CAAC;AAEF,kFAAkF;AAClF,eAAO,MAAM,oBAAoB,GAC/B,OAAO,KAAK,EACZ,eAA6B,KAC5B,MAOF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,GACnC,QAAQ,UAAU,EAClB,OAAO,KAAK,EACZ,eAA6B,KAC5B,OAAO,CAAC,IAAI,CAoBd,CAAC"}