@elaraai/e3-ui-components 1.0.83 → 1.0.85

package/dist/query/results.d.ts

@@ -0,0 +1,137 @@
+import { ToolbarItem } from '@elaraai/east-ui-components';
+import { QueryWords } from './model/words.js';
+import { Styles } from './parts.js';
+import { RunOutput, RunState } from './run.js';
+/** How a result shows: as a Table of its rows, or as a Value tree. */
+export type ResultView = "table" | "tree";
+/** A download's format. */
+export type DownloadFormat = "csv" | "beast2";
+/**
+ * How a result opens: rows — an array, a set or a vector — as a Table, one
+ * value as a tree.
+ *
+ * @param output - the result
+ * @returns its view
+ */
+export declare function pickedView(output: RunOutput): ResultView;
+/** What a run that gave no result says: its title, and the words under it. */
+export interface RunFailure {
+    readonly title: string;
+    readonly message: string;
+}
+/**
+ * Why a run gave no result, in the builder's words (`Query Editor Spec.md`
+ * §4.11): the checker's problems; a runtime error or e3's refusal; the time
+ * limit; the size limit; a platform function the server lacks; a call that
+ * never reached the server, or that the server refused.
+ *
+ * @param state - the run
+ * @param words - the words
+ * @returns the banner's title and message; `undefined` for a run that gave a result, or none yet
+ */
+export declare function runFailure(state: RunState, words: QueryWords): RunFailure | undefined;
+/** The footer's read-outs of a run: its count, its fields, the run's own line and what it read. */
+export interface ResultFooter {
+    /** The count in words, or the run's state — `10 orders`, `Showing 1–1,000 of 4,210`, `Running…`. */
+    readonly count: string;
+    /** The rows' fields — `· order, customer, total`. */
+    readonly fields: string;
+    /** The run's own line — `run #3 · 14:02 · 412 ms`. */
+    readonly run: string;
+    /** Its East type and multiplicity, on hover. */
+    readonly type: string;
+    /** What it read — `reads orders #4f2a1c8d · customers #9b07e3a4`. */
+    readonly reads: string;
+}
+/**
+ * The footer's read-outs of a run (`Query Editor Spec.md` §4.11).
+ *
+ * @param state - the run
+ * @param words - the words
+ * @returns the footer's parts
+ */
+export declare function resultFooter(state: RunState, words: QueryWords): ResultFooter;
+/** Props of {@link QueryResults}. */
+export interface QueryResultsProps {
+    /** The run. */
+    readonly state: RunState;
+    /** Whether the query changed after the run that gave the result. */
+    readonly stale: boolean;
+    /** How the result shows. */
+    readonly view: ResultView;
+    /** The words. */
+    readonly words: QueryWords;
+    /** The builder's storage key: the result's renderers keep their state under it. */
+    readonly storageKey: string;
+    /** The result's controls, for the band ({@link resultToolbarItems}). */
+    readonly controls: readonly ToolbarItem[];
+}
+/**
+ * Renders the results — see the module docs.
+ *
+ * @param props - The run, whether it is stale, the view, the words and the result's controls ({@link QueryResultsProps})
+ * @returns The results
+ */
+export declare const QueryResults: import('react').NamedExoticComponent<QueryResultsProps>;
+/** Props of {@link ResultStrips}. */
+export interface ResultStripsProps {
+    /** The run. */
+    readonly state: RunState;
+    /** Whether the query changed after the run that gave the result. */
+    readonly stale: boolean;
+    /** The note after a download, until it is dismissed or the next run. */
+    readonly note: string | undefined;
+    /** Dismisses the note. */
+    readonly onDismissNote: () => void;
+    /** Runs the query again. */
+    readonly onRunAgain: () => void;
+    /** The words. */
+    readonly words: QueryWords;
+}
+/**
+ * The result's strips (`Query Editor Spec.md` §4.11): under the builder's
+ * toolbar, the builder's full width, edge to edge, each over a rule — the
+ * stale strip while the query differs from the one the result is of; a run
+ * that gave no result, worded by how it ended; and the note after a download,
+ * dismissible. None, and the strips take no room.
+ *
+ * @param props - The run, whether it is stale, the note and the words ({@link ResultStripsProps})
+ * @returns The strips
+ */
+export declare const ResultStrips: import('react').NamedExoticComponent<ResultStripsProps>;
+/** What the result's toolbar items show, and do. */
+export interface ResultToolbarOptions {
+    /** The view shown; `undefined` without a result. */
+    readonly view: ResultView | undefined;
+    /** The view the run picked. */
+    readonly picked: ResultView | undefined;
+    /** Shows a view. */
+    readonly onView: (view: ResultView) => void;
+    /** Downloads the result. */
+    readonly onDownload: (format: DownloadFormat) => void;
+    /** The words. */
+    readonly words: QueryWords;
+    /** The `queryBuilder` recipe's styles. */
+    readonly styles: Styles;
+    /** The `seg` recipe's styles. */
+    readonly seg: Styles;
+}
+/**
+ * The result's controls, the items of the results' band (`Query Editor
+ * Spec.md` §4.11): **Table · Tree**, the `seg` strip, folding to its icons;
+ * and **Download ▾**, a menu of CSV and BEAST2, folding to its icon. Both are
+ * off without a result.
+ *
+ * @param options - The view, the picked view, the downloads and the words ({@link ResultToolbarOptions})
+ * @returns The items, in their order along the row
+ */
+export declare function resultToolbarItems(options: ResultToolbarOptions): ToolbarItem[];
+/**
+ * A result's file name, from the query's name: lower-cased, every other
+ * character a "-" — `top-shipped-orders-2026`.
+ *
+ * @param name - the query's name
+ * @returns the file's name, without its extension
+ */
+export declare function resultFileName(name: string): string;
+//# sourceMappingURL=results.d.ts.map

package/dist/query/results.d.ts.map

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

package/dist/query/run.d.ts

@@ -0,0 +1,199 @@
+import { CheckJqResult, EastType, option } from '@elaraai/east';
+import { SplitCallProgress } from '@elaraai/e3-types';
+import { QueryCall, QuerySourceStatus, QuerySplitCall, QuerySplitExplain } from './hooks.js';
+import { QueryResult, QueryRoot } from './one-shot.js';
+import { PlanOptions, QueryPlan } from './plan.js';
+import { QueryHeader } from './session.js';
+import { CheckedSteps } from './steps/check.js';
+import { Shape } from './steps/shape.js';
+import { StepQuery } from './steps/values.js';
+import { QueryView } from './toolbar.js';
+/** The most rows a visual run returns; the counting program counts them all. */
+export declare const RUN_MAX_ROWS = 1000;
+/**
+ * A program's canonical text: printed in the pipeline layout when it parses,
+ * as written when it does not — what a result is fresh against.
+ *
+ * @param program - the program's text
+ * @returns its canonical text
+ */
+export declare function canonicalProgram(program: string): string;
+/** What a run sends as a split call, and what reading its answer needs. */
+export interface SplitRun {
+    /**
+     * The program: in the visual view the query, a rows result followed by
+     * `{counts: [length], result: .[:1000]}` — the rows joined, and that run
+     * once after them; in the jq view, the jq.
+     */
+    readonly program: string;
+    /** What each of its counts is of — the last counted stage, for a visual run of rows; `undefined` when it answers the result alone. */
+    readonly counted: readonly string[] | undefined;
+    /** The data source whose stored row count is the source's count — a visual run's, when its source counts; `undefined` otherwise. */
+    readonly source: string | undefined;
+}
+/** What a run sends, and what reading its answer needs. */
+export interface RunPlan {
+    /** The program a one-shot call runs: the counting program, or the jq. */
+    readonly program: string;
+    /** The query's own program, canonical: what its result is fresh against, and what its plan splits and explains. */
+    readonly canonical: string;
+    /** What each of the counting program's counts is of — `undefined` for a jq run. */
+    readonly counted: readonly string[] | undefined;
+    /** What a split call runs instead. */
+    readonly split: SplitRun;
+    /** The shape the query gives, as the editor knew it when it ran: what its rows are called. */
+    readonly shape: Shape | undefined;
+    /** The query's name and description when it ran: what its recent query is called. */
+    readonly name: string;
+    readonly description: option<string>;
+}
+/** What planning a run needs of the open query. */
+export interface RunEditor {
+    /** The view shown. */
+    readonly view: QueryView;
+    /** The header: its jq, when the program is not steps. */
+    readonly header: QueryHeader;
+    /** The steps. */
+    readonly query: StepQuery;
+    /** The steps' check; `undefined` while the program is jq. */
+    readonly checked: CheckedSteps | undefined;
+    /** The jq as typed, in the jq view. */
+    readonly jqText: string;
+    /** The jq view's check of it. */
+    readonly jqChecked: CheckJqResult | undefined;
+}
+/**
+ * What a run of the open query sends.
+ *
+ * @param editor - the open query, as the editor holds it
+ * @param root - the root
+ * @returns the plan: in the visual view the counting program, or for a split
+ *   call the query, a rows result wrapped to count its rows; in the jq view the jq
+ */
+export declare function planRun(editor: RunEditor, root: QueryRoot): RunPlan;
+/** What a run that answered gave: the query's result, and what the counting program counted. */
+export interface RunOutput {
+    /** The result's type: `T`, `Option<T>` or `Array<T>` by the query's multiplicity. */
+    readonly type: EastType;
+    /** The result. */
+    readonly value: unknown;
+    /** The rows each stage gave, by step id (`SOURCE_COUNT` for the source's): a visual run's. */
+    readonly counts: ReadonlyMap<string, number> | undefined;
+    /** The rows the query gives in all, when the run returned fewer: the counting program's last count. */
+    readonly total: number | undefined;
+    /** Whether the answer was cut at the call's most outputs, its total unknown: a jq run's. */
+    readonly truncated: boolean;
+}
+/**
+ * Reads a run's answer.
+ *
+ * @param program - what the run's program counts: a {@link RunPlan}'s
+ *   counting program, or a {@link SplitRun}'s
+ * @param result - what the call answered
+ * @param known - counts known before the run answered, by step id: a split
+ *   run's source's stored rows
+ * @returns the result and its counts; `undefined` for a run that gave no result
+ * @throws {Error} When a counting run's answer does not hold one count per counted stage.
+ */
+export declare function runOutput(program: {
+    readonly counted: readonly string[] | undefined;
+}, result: QueryResult, known?: ReadonlyMap<string, number>): RunOutput | undefined;
+/** Where the builder's run stands. */
+export type RunState = {
+    readonly status: "idle";
+}
+/**
+ * A run going: its number, its plan, the data sources it reads; how it
+ * reads them, once planned; and a split call's progress, and how many
+ * pieces it cut, once e3 says.
+ */
+ | {
+    readonly status: "running";
+    readonly n: number;
+    readonly plan: RunPlan;
+    readonly reads: readonly string[];
+    readonly planned: QueryPlan | undefined;
+    readonly progress: SplitCallProgress | undefined;
+    readonly pieces: number | undefined;
+}
+/**
+ * A run answered — a result, or the checker's, the runner's or e3's
+ * refusal — how it read its data, and how many pieces it cut, once e3
+ * says: for a split call that answered before it did, after the answer,
+ * from its explain (#1132).
+ */
+ | {
+    readonly status: "done";
+    readonly n: number;
+    readonly plan: RunPlan;
+    readonly result: QueryResult;
+    readonly output: RunOutput | undefined;
+    readonly at: Date;
+    readonly ms: number;
+    readonly planned: QueryPlan | undefined;
+    readonly pieces: number | undefined;
+}
+/** A call that never answered: unreachable, or refused by the server — and how it was to read its data. */
+ | {
+    readonly status: "failed";
+    readonly n: number;
+    readonly plan: RunPlan;
+    readonly reason: "unreachable" | "refused";
+    readonly message: string;
+    readonly at: Date;
+    readonly planned: QueryPlan | undefined;
+};
+/** What a run reaches e3 through, and how it plans. */
+export interface QueryRunSeams {
+    /** How a one-shot call is made; `undefined` when there is no server. */
+    readonly call: QueryCall | undefined;
+    /** How a split call is made; `undefined` when there is no server. */
+    readonly split: QuerySplitCall | undefined;
+    /** How a split call's pieces are counted when it answered before e3 reported them; `undefined` when there is none to ask, and they go uncounted. */
+    readonly explain: QuerySplitExplain | undefined;
+    /** How a data source's status is read; `undefined` when there is none to read, and every dataset's weight is unknown. */
+    readonly status: QuerySourceStatus | undefined;
+    /** How the run plans: the most a dataset may weigh and still be read by one call. */
+    readonly options: PlanOptions;
+}
+/**
+ * Runs the open query: each run planned in the browser and sent as one
+ * one-shot call, or as a split call over the dataset it works through; one
+ * run in flight at a time, a new run abandoning the old.
+ *
+ * @param root - The root, or why it cannot be queried
+ * @param seams - How a one-shot call, a split call and a data source's status
+ *   are made, and how the run plans
+ * @param onRan - Told each run that answered, with its result, for the recent queries
+ * @returns The run's state, and `run(plan)`
+ *
+ * @remarks
+ * A run checks and splits the query (`draftPlan`); reads the status of the
+ * datasets whose weights decide its path, when it would cut one; plans the
+ * call by what they weigh (`weighPlan`); and makes it — a re-keyed join's two
+ * calls one after the other, the second over the first's output (#942). A
+ * split call's progress is the run's as e3 reports it, and how many pieces it
+ * cut is the partition's units — the join call's, for a re-keyed join. A
+ * split visual run counts the source from its dataset's stored rows, and a
+ * rows result's rows from the call; nothing between.
+ *
+ * A split call that answered before e3 reported its pieces — one that ended
+ * between two polls, or one served whole from e3's cache — has them counted
+ * once it has answered, by e3's explain of the call, which plans them as the
+ * run did and runs no unit (#1132): the answer shows at once, and the count
+ * lands after it. An explain is work in proportion to the dataset, so a call
+ * whose progress named its pieces is never explained. An explain that fails
+ * leaves the count unknown; a new run abandons it with the run.
+ *
+ * The builder going — unmounted, or hidden — abandons the run in flight: its
+ * split call stops polling, and its answer is dropped when it lands. Its
+ * coming back starts that run again, under its number: React's development
+ * check of a component's effects, which mounts it, unmounts it and mounts it
+ * again, would otherwise fail the run a saved query starts as it opens, with
+ * the abandoned call's "signal is aborted".
+ */
+export declare function useQueryRun(root: QueryRoot | string, seams: QueryRunSeams, onRan?: (result: QueryResult, plan: RunPlan) => void): {
+    state: RunState;
+    run: (plan: RunPlan) => void;
+};
+//# sourceMappingURL=run.d.ts.map

package/dist/query/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/query/run.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAoCH,OAAO,EAEH,KAAK,aAAa,EAAE,KAAK,QAAQ,EAAE,KAAK,MAAM,EACjD,MAAM,eAAe,CAAC;AAEvB,OAAO,KAAK,EAAiB,iBAAiB,EAAoB,MAAM,mBAAmB,CAAC;AAC5F,OAAO,KAAK,EAAE,SAAS,EAAE,iBAAiB,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAClG,OAAO,EAAoC,KAAK,WAAW,EAAE,KAAK,SAAS,EAAE,MAAM,eAAe,CAAC;AACnG,OAAO,EAAwC,KAAK,WAAW,EAAE,KAAK,SAAS,EAAqB,MAAM,WAAW,CAAC;AACtH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGrD,OAAO,EAAW,KAAK,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,gFAAgF;AAChF,eAAO,MAAM,YAAY,OAAO,CAAC;AAKjC;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGxD;AAED,2EAA2E;AAC3E,MAAM,WAAW,QAAQ;IACrB;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,sIAAsI;IACtI,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IAChD,oIAAoI;IACpI,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;CACvC;AAED,2DAA2D;AAC3D,MAAM,WAAW,OAAO;IACpB,yEAAyE;IACzE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,mHAAmH;IACnH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,mFAAmF;IACnF,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IAChD,sCAAsC;IACtC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,8FAA8F;IAC9F,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS,CAAC;IAClC,qFAAqF;IACrF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;CACxC;AAED,mDAAmD;AACnD,MAAM,WAAW,SAAS;IACtB,sBAAsB;IACtB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,yDAAyD;IACzD,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,iBAAiB;IACjB,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,6DAA6D;IAC7D,QAAQ,CAAC,OAAO,EAAE,YAAY,GAAG,SAAS,CAAC;IAC3C,uCAAuC;IACvC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,iCAAiC;IACjC,QAAQ,CAAC,SAAS,EAAE,aAAa,GAAG,SAAS,CAAC;CACjD;AAED;;;;;;;GAOG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,GAAG,OAAO,CA0BnE;AAED,gGAAgG;AAChG,MAAM,WAAW,SAAS;IACtB,qFAAqF;IACrF,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,kBAAkB;IAClB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,8FAA8F;IAC9F,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;IACzD,uGAAuG;IACvG,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,4FAA4F;IAC5F,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC/B;AAKD;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CACrB,OAAO,EAAE;IAAE,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAA;CAAE,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,GAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAa,GAClI,SAAS,GAAG,SAAS,CAevB;AAED,sCAAsC;AACtC,MAAM,MAAM,QAAQ,GACd;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE;AAC7B;;;;GAIG;GACD;IACE,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1G,QAAQ,CAAC,OAAO,EAAE,SAAS,GAAG,SAAS,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,GAAG,SAAS,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;CAClI;AACD;;;;;GAKG;GACD;IACE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAClG,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAC/E,QAAQ,CAAC,OAAO,EAAE,SAAS,GAAG,SAAS,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;CAChF;AACD,2GAA2G;GACzG;IACE,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,aAAa,GAAG,SAAS,CAAC;IAClH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,SAAS,GAAG,SAAS,CAAC;CACxF,CAAC;AAEN,uDAAuD;AACvD,MAAM,WAAW,aAAa;IAC1B,wEAAwE;IACxE,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,CAAC;IACrC,qEAAqE;IACrE,QAAQ,CAAC,KAAK,EAAE,cAAc,GAAG,SAAS,CAAC;IAC3C,oJAAoJ;IACpJ,QAAQ,CAAC,OAAO,EAAE,iBAAiB,GAAG,SAAS,CAAC;IAChD,yHAAyH;IACzH,QAAQ,CAAC,MAAM,EAAE,iBAAiB,GAAG,SAAS,CAAC;IAC/C,qFAAqF;IACrF,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;CACjC;AAyCD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAgB,WAAW,CACvB,IAAI,EAAE,SAAS,GAAG,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,OAAO,KAAK,IAAI,GACrG;IAAE,KAAK,EAAE,QAAQ,CAAC;IAAC,GAAG,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAA;CAAE,CA4KnD"}

package/dist/query/save-popover.d.ts

@@ -0,0 +1,29 @@
+import { ReactNode } from 'react';
+import { option } from '@elaraai/east';
+/** Props of {@link QuerySavePopover}. */
+export interface QuerySavePopoverProps {
+    /** Whether it is open. */
+    open: boolean;
+    /** Opens or closes it — its trigger, ×, Esc, a click outside, Cancel, or a save that was made. */
+    onOpenChange: (open: boolean) => void;
+    /** The button it hangs from — the toolbar's Save…, which its host renders. */
+    trigger: ReactNode;
+    /** The open query's name — its head names it, and its name field offers it each time it opens. */
+    name: string;
+    /** The names the other saved queries hold; the open query's own saved name is not among them. */
+    taken: ReadonlySet<string>;
+    /** The open query's description: `none` while it is the generated sentence, which the field then shows. */
+    description: option<string>;
+    /** The sentence generated from the steps (the model's `describeQuery`), `""` while no step is finished. */
+    generated: string;
+    /** Saves the query under the name, with the description — `none` for the generated sentence — and resolves to what refused the save, or `undefined` once it is saved. */
+    onSave: (name: string, description: option<string>) => Promise<string | undefined>;
+}
+/**
+ * Renders the save popover — see the module docs.
+ *
+ * @param props - The query it saves, and the save
+ * @returns The trigger, and the popover while open
+ */
+export declare const QuerySavePopover: import('react').NamedExoticComponent<QuerySavePopoverProps>;
+//# sourceMappingURL=save-popover.d.ts.map

package/dist/query/save-popover.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"save-popover.d.ts","sourceRoot":"","sources":["../../src/query/save-popover.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,EAA4E,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAEjH,OAAO,EAA+D,KAAK,MAAM,EAAE,MAAM,eAAe,CAAC;AAezG,yCAAyC;AACzC,MAAM,WAAW,qBAAqB;IAClC,0BAA0B;IAC1B,IAAI,EAAE,OAAO,CAAC;IACd,kGAAkG;IAClG,YAAY,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACtC,8EAA8E;IAC9E,OAAO,EAAE,SAAS,CAAC;IACnB,kGAAkG;IAClG,IAAI,EAAE,MAAM,CAAC;IACb,iGAAiG;IACjG,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC3B,2GAA2G;IAC3G,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IAC5B,2GAA2G;IAC3G,SAAS,EAAE,MAAM,CAAC;IAClB,yKAAyK;IACzK,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;CACtF;AAED;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,6DA2EiE,CAAC"}