@elaraai/e3-ui-components 1.0.83 → 1.0.85

package/dist/query/steps/jq.d.ts.map

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

package/dist/query/steps/parse.d.ts

@@ -0,0 +1,38 @@
+import { EastType, ParsedJq, QueryErrorType, ValueTypeOf } from '@elaraai/east';
+import { Shape } from './shape.js';
+import { Aggregate, StepQuery } from './values.js';
+/** A problem that keeps a program from being steps, as the query wire types hold one. */
+export type StepParseError = ValueTypeOf<typeof QueryErrorType>;
+/** Where a step was read from in the program's text: the segments it was made of, first to last. */
+export interface StepSpan {
+    /** The step's id. */
+    readonly stepId: string;
+    /** The offset its first segment starts at. */
+    readonly from: number;
+    /** The offset after its last segment. */
+    readonly to: number;
+}
+/** The name a total takes until its author names it: count, the field's name for a sum, `fn_field` otherwise. */
+export declare function defaultTotalName(shape: Shape, fn: Aggregate["fn"]["type"], ref: string | undefined): string;
+/**
+ * Parses a jq program into steps.
+ *
+ * @param program - the program's text, or what east's `parseJq` made of it
+ * @param root - the root's type: a struct of the data sources
+ * @returns the query as steps, with where each was read from in the text; or
+ *   the problem that keeps it from being steps
+ *
+ * @remarks
+ * The program starts with the `.ds as $ds` binds of its Look ups, then reads
+ * a data source; every canonical form after it becomes its step, and a
+ * segment no form takes is a jq step, as is every segment after it. Ids are
+ * fresh on every parse. A program that does not parse, or does not start
+ * from a data source, is not steps.
+ */
+export declare function parseSteps(program: string | ParsedJq, root: EastType): {
+    query: StepQuery;
+    spans: readonly StepSpan[];
+} | {
+    error: StepParseError;
+};
+//# sourceMappingURL=parse.d.ts.map

package/dist/query/steps/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../../src/query/steps/parse.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;GAQG;AAEH,OAAO,EAEH,KAAK,QAAQ,EAAe,KAAK,QAAQ,EAAE,KAAK,cAAc,EAAE,KAAK,WAAW,EACnF,MAAM,eAAe,CAAC;AAMvB,OAAO,EAA+C,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AACrF,OAAO,EACkB,KAAK,SAAS,EACnC,KAAK,SAAS,EACjB,MAAM,aAAa,CAAC;AAErB,yFAAyF;AACzF,MAAM,MAAM,cAAc,GAAG,WAAW,CAAC,OAAO,cAAc,CAAC,CAAC;AAEhE,oGAAoG;AACpG,MAAM,WAAW,QAAQ;IACrB,qBAAqB;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,8CAA8C;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,yCAAyC;IACzC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACvB;AA0LD,iHAAiH;AACjH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAI3G;AA+PD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,EAAE,IAAI,EAAE,QAAQ,GAAG;IAAE,KAAK,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,SAAS,QAAQ,EAAE,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,cAAc,CAAA;CAAE,CAsGnJ"}

package/dist/query/steps/print.d.ts

@@ -0,0 +1,195 @@
+import { CheckJqResult, EastType, JqNode } from '@elaraai/east';
+import { StepField } from './fields.js';
+import { Shape } from './shape.js';
+import { Condition, Step, StepQuery } from './values.js';
+/** A printed step's range of text. */
+export interface StepRange {
+    /** The step's id. */
+    readonly id: string;
+    /** Its first offset. */
+    readonly from: number;
+    /** The offset after its last. */
+    readonly to: number;
+}
+/** A printed condition's range of text, and the ranges of its field and its value. */
+export interface ConditionRange {
+    /** The step it is in. */
+    readonly stepId: string;
+    /** The condition's id. */
+    readonly condId: string;
+    /** Its first offset. */
+    readonly from: number;
+    /** The offset after its last. */
+    readonly to: number;
+    /** Where its field's read is, and its value's literal. */
+    readonly parts: {
+        readonly field?: readonly [number, number];
+        readonly value?: readonly [number, number];
+    };
+}
+/**
+ * A step's slot: what a check's diagnostic is placed on, besides a
+ * condition. `dataset`, `key` and `fields` are a Look up's; `by` and
+ * `agg-field` (a total's field, with the total's id) a Group and total's;
+ * `pick-field` (with the field shown's id) a Show only fields'; `n` a Keep
+ * the first's; `field` the field of a Sort, a Fill, an Open each list or a
+ * Take part of a date; `value` a Fill's; `via` a List every part's; `range`
+ * and `fixed` (with the input's name) a Try the model's.
+ */
+export type StepSlot = "dataset" | "key" | "fields" | "by" | "agg-field" | "pick-field" | "n" | "field" | "value" | "via" | "range" | "fixed";
+/** A printed slot's range of text. */
+export interface SlotRange {
+    /** The step it is in. */
+    readonly stepId: string;
+    /** The slot. */
+    readonly slot: StepSlot;
+    /** The total, field shown, field brought in or input it is for. */
+    readonly id?: string;
+    /** Its first offset. */
+    readonly from: number;
+    /** The offset after its last. */
+    readonly to: number;
+}
+/** Steps printed as canonical jq. */
+export interface PrintedSteps {
+    /** The program's text. */
+    readonly text: string;
+    /** The program, or `null` when a jq step's text breaks it. */
+    readonly program: JqNode | null;
+    /** Where the data source's read is. */
+    readonly source: {
+        readonly from: number;
+        readonly to: number;
+    };
+    /** Each printed step's range, in order; an unfinished step is not printed. */
+    readonly steps: readonly StepRange[];
+    /** Each printed condition's range, groups included. */
+    readonly conds: readonly ConditionRange[];
+    /** Each printed slot's range. */
+    readonly slots: readonly SlotRange[];
+}
+/** One step laid out: the shape it takes and gives, and whether it printed and checked. */
+export interface LaidOutStep {
+    /** The step. */
+    readonly step: Step;
+    /** The shape of the rows it takes. */
+    readonly before: Shape;
+    /** The shape it gives: its input's when it is unfinished or does not check. */
+    readonly after: Shape;
+    /** Whether it is in the program: unfinished steps are left out. */
+    readonly printed: boolean;
+    /** Whether it checked in the program before it. */
+    readonly checked: boolean;
+}
+/** A segment of the program, as the counting program reads it. */
+export interface LaidOutSegment {
+    /** The step it is part of; `undefined` for the prologue and the source. */
+    readonly stepId: string | undefined;
+    /** Its text. */
+    readonly text: string;
+    /** Whether it is the source, or a step's last segment, after which the step's shape holds. */
+    readonly last: boolean;
+}
+/** A query laid out: the printed program, each step's shapes, and the program's check. */
+export interface StepLayout {
+    /** The printed program. */
+    readonly printed: PrintedSteps;
+    /** The shape the data source gives. */
+    readonly source: Shape;
+    /** Each step, in order. */
+    readonly steps: readonly LaidOutStep[];
+    /** The shape the query gives. */
+    readonly final: Shape;
+    /** The whole program's check, against the root. */
+    readonly check: CheckJqResult;
+    /** The program's segments, in order. */
+    readonly segments: readonly LaidOutSegment[];
+}
+/** What separates two segments of the pipeline layout. */
+export declare const SEP = "\n| ";
+/**
+ * The fields jq reads a step's field through, in a shape.
+ *
+ * @param shape - the shape
+ * @param ref - how the step names the field
+ * @param whole - read a variant as its whole value, not its case
+ * @returns the fields read
+ */
+export declare function pathFor(shape: Shape, ref: string, whole?: boolean): readonly string[];
+/**
+ * The shape of each item of a list field, for the conditions inside has any
+ * where.
+ *
+ * @param field - the list field
+ * @returns the items as rows of their record, or {@link UNKNOWN}
+ */
+export declare function itemShape(field: StepField | undefined): Shape;
+/**
+ * Whether a condition of an all filter narrows the rows to a case, and so
+ * prints in a `select` of its own before the rest: a variant field is one of
+ * its cases.
+ *
+ * @param condition - a top-level condition of the filter
+ * @param shape - the rows it tests
+ * @returns the variant field and the case, or `undefined`
+ */
+export declare function narrowingOf(condition: Condition, shape: Shape): {
+    field: string;
+    case: string | undefined;
+} | undefined;
+/** The name a step gives a field made from another: the field's own, or the step's name for it. */
+export declare function nameFor(shape: Shape, ref: string): string;
+/** The scalar fields of a tree's node, which List every part keeps. */
+export declare function scalarFieldsOf(record: EastType): string[];
+/** The name of a variable a step binds, from a name it would like: the name, or `value` when jq cannot read it as one. */
+export declare function variableName(name: string): string;
+/**
+ * Whether a finished step can be printed: a Look up's dataset must be one jq
+ * can bind as a variable.
+ *
+ * @param step - the step
+ * @returns whether it prints
+ */
+export declare function printable(step: Step): boolean;
+/**
+ * What the steps know of the shape a step gives, besides its type: the cases
+ * its rows are narrowed to, a Keep the first bound, and what a row is called.
+ *
+ * @param step - the step
+ * @param before - the shape it takes
+ * @returns the narrowed fields, the bound and the noun
+ */
+export declare function knownAfter(step: Step, before: Shape): {
+    narrowed: ReadonlyMap<string, string>;
+    limit: number | undefined;
+    noun: string;
+};
+/** The shape a stage of a checked prefix gives, found by where the segment starts. */
+export declare function stageAt(check: CheckJqResult, from: number): {
+    type: EastType;
+    multiplicity: CheckJqResult["stages"][number]["multiplicity"];
+} | undefined;
+/**
+ * Lays a query out: prints each finished step for the shape before it,
+ * checking each prefix against the root, and checks the whole program.
+ *
+ * @param query - the query
+ * @param root - the root's type: a struct of the data sources
+ * @returns the printed program, each step's shapes, and the program's check
+ */
+export declare function layOutSteps(query: StepQuery, root: EastType): StepLayout;
+/**
+ * Prints a query's steps as canonical jq (`Query Editor Spec.md` §4.7), with
+ * the span of every step and condition.
+ *
+ * @param query - the query
+ * @param root - the root's type: a struct of the data sources
+ * @returns the program's text, the program, and the ranges
+ *
+ * @remarks
+ * The program starts with `.ds as $ds` for each dataset a finished Look up
+ * reads, then the data source; each finished step follows on its own line.
+ * Unfinished steps are left out. A jq step's text is printed as written.
+ */
+export declare function printSteps(query: StepQuery, root: EastType): PrintedSteps;
+//# sourceMappingURL=print.d.ts.map

package/dist/query/steps/print.d.ts.map

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

package/dist/query/steps/shape.d.ts

@@ -0,0 +1,90 @@
+import { EastType, JqMultiplicity } from '@elaraai/east';
+/**
+ * What a stage gives: `rows` — an array (or set) of records, which the
+ * steps that keep, reshape and total rows take; `one` — any other value, or a
+ * stream; `unknown` — the checker could not tell, after a problem.
+ */
+export type ShapeKind = "rows" | "one" | "unknown";
+/** The shape of a query at a step. */
+export interface Shape {
+    /** What it gives. */
+    readonly kind: ShapeKind;
+    /** The stage's type, as the checker gives it; `Never` when unknown. */
+    readonly type: EastType;
+    /** For rows, the record each row is. */
+    readonly row: EastType | undefined;
+    /** How many outputs the program has given here, as the checker counts them. */
+    readonly multiplicity: JqMultiplicity | null;
+    /**
+     * For rows, each variant field a Keep rows where step narrowed to one
+     * case, with the case: its payload's fields are exact, not missing.
+     */
+    readonly narrowed: ReadonlyMap<string, string>;
+    /** For rows, the most a Keep the first step lets through. */
+    readonly limit: number | undefined;
+    /** What one row, or the value, is called: "order", "line", "part". */
+    readonly noun: string;
+}
+/** The shape after a problem the checker stopped at. */
+export declare const UNKNOWN: Shape;
+/**
+ * A type read through its recursive wrapper: what a value of it is made of.
+ *
+ * @param type - a type
+ * @returns its node, for a recursive type; itself otherwise
+ */
+export declare function unwrapRecursive(type: EastType): EastType;
+/**
+ * The payload of an option type.
+ *
+ * @param type - a type
+ * @returns `T` when the type is `Option<T>`, decided by East's type equality;
+ *   `undefined` otherwise
+ */
+export declare function optionPayload(type: EastType): EastType | undefined;
+/**
+ * A type read through its option and recursive wrappers.
+ *
+ * @param type - a type
+ * @returns what a present value of it is made of
+ */
+export declare function baseType(type: EastType): EastType;
+/**
+ * The type a read gives where the value can be missing: `Option<T>`, or `T`
+ * itself when it is already an option or `Null`.
+ *
+ * @param type - the value's type
+ * @returns the type of a read that can miss it
+ */
+export declare function orMissing(type: EastType): EastType;
+/**
+ * The record of each row, when a type is rows: an array or a set of structs.
+ *
+ * @param type - a stage's type
+ * @returns the struct, or `undefined` when the type is not rows
+ */
+export declare function rowOf(type: EastType): EastType | undefined;
+/**
+ * The shape of a stage.
+ *
+ * @param type - the stage's type
+ * @param multiplicity - how many outputs the program has given there
+ * @param known - what the steps know besides: the narrowed variant fields,
+ *   a Keep the first bound, and the noun
+ * @returns the shape: rows when one value is an array or set of structs
+ */
+export declare function shapeOf(type: EastType, multiplicity: JqMultiplicity | null, known: {
+    narrowed?: ReadonlyMap<string, string>;
+    limit?: number | undefined;
+    noun: string;
+}): Shape;
+/**
+ * The singular of a plural name, as English mostly forms it: `orders` →
+ * `order`, `categories` → `category`, `statuses` → `status`; a name that is
+ * not plural is itself.
+ *
+ * @param word - the name
+ * @returns its singular
+ */
+export declare function singular(word: string): string;
+//# sourceMappingURL=shape.d.ts.map

package/dist/query/steps/shape.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shape.d.ts","sourceRoot":"","sources":["../../../src/query/steps/shape.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;GAMG;AAEH,OAAO,EAAsC,KAAK,QAAQ,EAAE,KAAK,cAAc,EAAE,MAAM,eAAe,CAAC;AAEvG;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,KAAK,GAAG,SAAS,CAAC;AAEnD,sCAAsC;AACtC,MAAM,WAAW,KAAK;IAClB,qBAAqB;IACrB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,uEAAuE;IACvE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,wCAAwC;IACxC,QAAQ,CAAC,GAAG,EAAE,QAAQ,GAAG,SAAS,CAAC;IACnC,+EAA+E;IAC/E,QAAQ,CAAC,YAAY,EAAE,cAAc,GAAG,IAAI,CAAC;IAC7C;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/C,6DAA6D;IAC7D,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,sEAAsE;IACtE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACzB;AAID,wDAAwD;AACxD,eAAO,MAAM,OAAO,EAAE,KAQrB,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,QAAQ,GAAG,QAAQ,CAIxD;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAKlE;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,QAAQ,CAGjD;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,QAAQ,GAAG,QAAQ,CAIlD;AAED;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAM1D;AAED;;;;;;;;GAQG;AACH,wBAAgB,OAAO,CACnB,IAAI,EAAE,QAAQ,EACd,YAAY,EAAE,cAAc,GAAG,IAAI,EACnC,KAAK,EAAE;IAAE,QAAQ,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC5F,KAAK,CAWP;AAED;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAK7C"}

package/dist/query/steps/values.d.ts

@@ -0,0 +1,85 @@
+import { ValueTypeOf } from '@elaraai/east';
+import { QueryAggregateType, QueryComparisonType, QueryConditionType, QueryMatchType, QueryPickFieldType, QueryStepInputType, QueryStepType, QueryStepValueType, QueryStepsType } from '@elaraai/e3-ui/internal';
+/** A query as steps: its data source and its steps. */
+export type StepQuery = ValueTypeOf<typeof QueryStepsType>;
+/** One step of a query. */
+export type Step = ValueTypeOf<typeof QueryStepType>;
+/** A step's kind: `filter`, `lookup`, … */
+export type StepKind = Step["type"];
+/** One step of a kind. */
+export type StepOf<K extends StepKind> = Extract<Step, {
+    type: K;
+}>;
+/** A condition of a Keep rows where step. */
+export type Condition = ValueTypeOf<typeof QueryConditionType>;
+/** A test of one field. */
+export type TestCondition = Extract<Condition, {
+    type: "test";
+}>;
+/** A group of conditions. */
+export type GroupCondition = Extract<Condition, {
+    type: "group";
+}>;
+/** How a condition compares a field. */
+export type Comparison = ValueTypeOf<typeof QueryComparisonType>;
+/** A comparison's kind: `eq`, `inYear`, … */
+export type ComparisonKind = Comparison["type"];
+/** How conditions combine. */
+export type Match = ValueTypeOf<typeof QueryMatchType>;
+/** One total of a Group and total step. */
+export type Aggregate = ValueTypeOf<typeof QueryAggregateType>;
+/** One field a Show only fields step shows. */
+export type PickField = ValueTypeOf<typeof QueryPickFieldType>;
+/** A value a step compares with or fills in. */
+export type StepValue = ValueTypeOf<typeof QueryStepValueType>;
+/** A count or a bound a step takes. */
+export type StepInput = ValueTypeOf<typeof QueryStepInputType>;
+/** What an id names: a step, a condition, a total or a field shown. */
+export type IdKind = "step" | "condition" | "aggregate" | "pick";
+/**
+ * A fresh id, unique for the life of the page: each call gives a new one, so
+ * an id is never reused, even by a query parsed again.
+ *
+ * @param kind - what it names
+ * @returns the id
+ */
+export declare function freshId(kind: IdKind): string;
+/**
+ * A comparison of a kind.
+ *
+ * @param kind - the comparison
+ * @returns its value
+ */
+export declare function comparison(kind: ComparisonKind): Comparison;
+/**
+ * Whether a value is filled in: any value but empty text.
+ *
+ * @param value - the value
+ * @returns whether it counts as given
+ */
+export declare function isGiven(value: StepValue): boolean;
+/**
+ * Whether a comparison takes a value: every one but missing, present, yes,
+ * no, and any where, which takes an inner condition instead.
+ *
+ * @param kind - the comparison
+ * @returns whether it needs a value
+ */
+export declare function needsValue(kind: ComparisonKind): boolean;
+/**
+ * Whether a condition is finished: a test with its field, its comparison and
+ * the value or inner condition it needs; a group with a finished condition.
+ *
+ * @param condition - the condition
+ * @returns whether it is printed
+ */
+export declare function isConditionComplete(condition: Condition): boolean;
+/**
+ * Whether a step is finished: every slot it needs is filled. An unfinished
+ * step is left out of the program until it is.
+ *
+ * @param step - the step
+ * @returns whether it is printed
+ */
+export declare function isComplete(step: Step): boolean;
+//# sourceMappingURL=values.d.ts.map

package/dist/query/steps/values.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"values.d.ts","sourceRoot":"","sources":["../../../src/query/steps/values.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;GAKG;AAEH,OAAO,EAAW,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,KAAK,EACR,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EAClB,aAAa,EACb,kBAAkB,EAClB,cAAc,EACjB,MAAM,yBAAyB,CAAC;AAEjC,uDAAuD;AACvD,MAAM,MAAM,SAAS,GAAG,WAAW,CAAC,OAAO,cAAc,CAAC,CAAC;AAC3D,2BAA2B;AAC3B,MAAM,MAAM,IAAI,GAAG,WAAW,CAAC,OAAO,aAAa,CAAC,CAAC;AACrD,2CAA2C;AAC3C,MAAM,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;AACpC,0BAA0B;AAC1B,MAAM,MAAM,MAAM,CAAC,CAAC,SAAS,QAAQ,IAAI,OAAO,CAAC,IAAI,EAAE;IAAE,IAAI,EAAE,CAAC,CAAA;CAAE,CAAC,CAAC;AACpE,6CAA6C;AAC7C,MAAM,MAAM,SAAS,GAAG,WAAW,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC/D,2BAA2B;AAC3B,MAAM,MAAM,aAAa,GAAG,OAAO,CAAC,SAAS,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AACjE,6BAA6B;AAC7B,MAAM,MAAM,cAAc,GAAG,OAAO,CAAC,SAAS,EAAE;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC,CAAC;AACnE,wCAAwC;AACxC,MAAM,MAAM,UAAU,GAAG,WAAW,CAAC,OAAO,mBAAmB,CAAC,CAAC;AACjE,6CAA6C;AAC7C,MAAM,MAAM,cAAc,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;AAChD,8BAA8B;AAC9B,MAAM,MAAM,KAAK,GAAG,WAAW,CAAC,OAAO,cAAc,CAAC,CAAC;AACvD,2CAA2C;AAC3C,MAAM,MAAM,SAAS,GAAG,WAAW,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC/D,+CAA+C;AAC/C,MAAM,MAAM,SAAS,GAAG,WAAW,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC/D,gDAAgD;AAChD,MAAM,MAAM,SAAS,GAAG,WAAW,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC/D,uCAAuC;AACvC,MAAM,MAAM,SAAS,GAAG,WAAW,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE/D,uEAAuE;AACvE,MAAM,MAAM,MAAM,GAAG,MAAM,GAAG,WAAW,GAAG,WAAW,GAAG,MAAM,CAAC;AAMjE;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG5C;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG,UAAU,CAE3D;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAEjD;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAExD;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAOjE;AAaD;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAkC9C"}

package/dist/query/toolbar.d.ts

@@ -0,0 +1,56 @@
+import { ReactNode } from 'react';
+import { ToolbarItem } from '@elaraai/east-ui-components';
+import { QueryWords } from './model/words.js';
+import { Styles } from './parts.js';
+/** A view of the query: its steps, or its jq. */
+export type QueryView = "visual" | "jq";
+/** How long Copy jq shows its check. */
+export declare const COPIED_MS = 1600;
+/** What the builder's toolbar holds. */
+export interface QueryToolbarOptions {
+    /** The history item (#935). */
+    readonly history: ToolbarItem;
+    /** The text Copy jq copies: the program, or the jq as typed in the jq view. */
+    readonly copyText: () => string;
+    /** The save popover, its trigger the toolbar's Save…. */
+    readonly save: ReactNode;
+    /** Whether the save popover is open: its item keeps its form. */
+    readonly saving: boolean;
+    /** Whether a run goes. */
+    readonly running: boolean;
+    /** Runs the query. */
+    readonly onRun: () => void;
+    /** The words. */
+    readonly words: QueryWords;
+    /** The `queryBuilder` recipe's styles. */
+    readonly styles: Styles;
+}
+/** What the Query tab's band holds: Visual · jq. */
+export interface ViewItemOptions {
+    /** The view shown. */
+    readonly view: QueryView;
+    /** Shows a view. */
+    readonly onView: (view: QueryView) => void;
+    /** The words. */
+    readonly words: QueryWords;
+    /** The `queryBuilder` recipe's styles. */
+    readonly styles: Styles;
+    /** The `seg` recipe's styles. */
+    readonly seg: Styles;
+}
+/**
+ * Visual · jq, an item of the Query tab's band (`Query Editor Spec.md` §4.2):
+ * the `seg` strip, folding to its icons.
+ *
+ * @param options - The view, what picking one does, the words and the styles ({@link ViewItemOptions})
+ * @returns The item
+ */
+export declare function viewToolbarItem(options: ViewItemOptions): ToolbarItem;
+/**
+ * The builder's toolbar items — see the module docs.
+ *
+ * @param options - The history item, the result's controls, the save popover, the run, and the words ({@link QueryToolbarOptions})
+ * @returns The items, in their order along the row
+ */
+export declare function queryToolbarItems(options: QueryToolbarOptions): ToolbarItem[];
+//# sourceMappingURL=toolbar.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"toolbar.d.ts","sourceRoot":"","sources":["../../src/query/toolbar.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAA+B,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAIpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAO,KAAK,MAAM,EAAE,MAAM,YAAY,CAAC;AAE9C,iDAAiD;AACjD,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,IAAI,CAAC;AAaxC,wCAAwC;AACxC,eAAO,MAAM,SAAS,OAAO,CAAC;AAE9B,wCAAwC;AACxC,MAAM,WAAW,mBAAmB;IAChC,+BAA+B;IAC/B,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,+EAA+E;IAC/E,QAAQ,CAAC,QAAQ,EAAE,MAAM,MAAM,CAAC;IAChC,yDAAyD;IACzD,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,iEAAiE;IACjE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,0BAA0B;IAC1B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,sBAAsB;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC;IAC3B,iBAAiB;IACjB,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,0CAA0C;IAC1C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CAC3B;AA2BD,oDAAoD;AACpD,MAAM,WAAW,eAAe;IAC5B,sBAAsB;IACtB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,oBAAoB;IACpB,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI,CAAC;IAC3C,iBAAiB;IACjB,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,0CAA0C;IAC1C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,iCAAiC;IACjC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,eAAe,GAAG,WAAW,CAmBrE;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,mBAAmB,GAAG,WAAW,EAAE,CAmB7E"}

package/dist/query/use-query-editor.d.ts

@@ -0,0 +1,153 @@
+import { CheckJqResult } from '@elaraai/east';
+import { Origin } from '@elaraai/east-ui-components';
+import { Card, SourceCard } from './model/cards.js';
+import { SlotRef } from './model/refs.js';
+import { SavedOffer, SlotItem, StepOption } from './model/slots.js';
+import { SummaryCache } from './model/summaries.js';
+import { QueryWords } from './model/words.js';
+import { QueryRoot } from './one-shot.js';
+import { QueryEntry, QueryHeader } from './session.js';
+import { CardActions } from './step-card.js';
+import { QueryCheckLine, QueryGivesLine } from './status-line.js';
+import { CheckedSteps } from './steps/check.js';
+import { StepKind, StepQuery } from './steps/values.js';
+import { QueryView } from './toolbar.js';
+/** A notice at the top of the Query tab: what just happened. */
+export interface QueryNotice {
+    /** Its identity among the notices. */
+    readonly id: number;
+    /** What it says. */
+    readonly text: string;
+}
+/** A slot's autocomplete, open. */
+export interface OpenSlot {
+    /** The slot. */
+    readonly ref: SlotRef;
+    /** Its key. */
+    readonly key: string;
+    /** The element it hangs from. */
+    readonly anchor: HTMLElement;
+}
+/** What the autocomplete of the open slot shows, and what it is told. */
+export interface SlotPopover {
+    /** The slot. */
+    readonly slot: OpenSlot;
+    /** Changes when the offers' source does — a summary arriving — so the list opens afresh on its current value. */
+    readonly generation: string;
+    /** Its label, filter placeholder, footer, empty words and keys. */
+    readonly label: string;
+    readonly placeholder: string;
+    readonly hint: string;
+    readonly empty: string;
+    readonly keys: string;
+    /** The offers for the text typed. */
+    readonly items: readonly SlotItem[];
+    /** The text typed. */
+    readonly text: string;
+    /** The offer active as it opens. */
+    readonly initialActive: number;
+    /** Told each change of the text. */
+    readonly onText: (text: string) => void;
+    /** Told the offer picked. */
+    readonly onPick: (item: SlotItem) => void;
+    /** Told it closes. */
+    readonly onClose: () => void;
+}
+/** What editing the open query needs. */
+export interface QueryEditorOptions {
+    /** The query's entries as its drafts stand. */
+    readonly entries: readonly QueryEntry[];
+    /** The query's entries as the drafts stand this moment — after a gesture in the same event, too. */
+    readonly current: () => readonly QueryEntry[] | undefined;
+    /** Records a gesture: the entries it leaves, as one transaction. */
+    readonly gesture: (next: readonly QueryEntry[], origin: Origin, label: string) => boolean;
+    /** Moves with every change of the session. */
+    readonly version: number;
+    /** The root. */
+    readonly root: QueryRoot;
+    /** The words. */
+    readonly words: QueryWords;
+    /** The builder's summaries, and the latest hash of each data source a run has read. */
+    readonly summaries: {
+        readonly cache: SummaryCache;
+        readonly hashes: ReadonlyMap<string, string>;
+    };
+    /** The saved queries the add-step list of a query with no steps offers. */
+    readonly saved: readonly SavedOffer[];
+    /** Opens a saved query picked from the add-step list. */
+    readonly onOpenSaved: (name: string) => void;
+    /** Shows the Query tab, the pane expanded: Visual · jq picked. */
+    readonly onShowQuery: () => void;
+    /** The builder's element: the autocomplete hangs inside it, and the slots are found in it. */
+    readonly bounds: () => HTMLElement | null;
+    /** Its session's source id: another query opened starts afresh. */
+    readonly sourceId: string;
+    /** The rows a fresh run of the steps counted at each stage, by step id (#938): the shape lines count them. */
+    readonly counts?: ReadonlyMap<string, number> | undefined;
+    /**
+     * The notice a query arrives with when it opens (#939) — "Opened “Big
+     * orders” from the library.", "Started a new query on customers." — by its
+     * session's source id: shown when that query opens, in place of the last
+     * query's notices.
+     */
+    readonly arrival?: {
+        readonly sourceId: string;
+        readonly text: string;
+    } | undefined;
+}
+/** Editing the open query: what the surfaces draw, and what they do. */
+export interface QueryEditor {
+    /** The header. */
+    readonly header: QueryHeader;
+    /** The steps, as a query on the header's data source. */
+    readonly query: StepQuery;
+    /** The steps' check; `undefined` while the program is jq. */
+    readonly checked: CheckedSteps | undefined;
+    /** The source's card, and each step's; empty while the program is jq. */
+    readonly source: SourceCard | undefined;
+    readonly cards: readonly Card[];
+    /** The Quick add buttons at the end of the query. */
+    readonly quick: readonly StepOption[];
+    /** The view shown. */
+    readonly view: QueryView;
+    /** Shows a view: to jq prints the program; back to visual parses it. */
+    readonly setView: (view: QueryView) => void;
+    /** The jq as typed, in the jq view. */
+    readonly jqText: string;
+    /** Told each change of the jq typed. */
+    readonly onJqText: (text: string) => void;
+    /** The jq typed in and left: one gesture. */
+    readonly leaveJq: () => void;
+    /** A fix taken in the jq view: the jq typed so far left, then the text the fix makes, a gesture of its own, under its label. */
+    readonly onJqFix: (text: string, label: string) => void;
+    /** The jq view's check of the jq as typed; `undefined` in the visual view. */
+    readonly jqChecked: CheckJqResult | undefined;
+    /** The jq view's note: unfinished steps left out, or the jq kept for its syntax. */
+    readonly jqNote: string | undefined;
+    /** The root, which the jq view completes and reads steps over. */
+    readonly root: QueryRoot;
+    /** The builder's summaries, whose values the jq view's completions offer. */
+    readonly summaries: QueryEditorOptions["summaries"];
+    /** The program as it stands: what Run runs and Copy jq copies — in the jq view, the jq as typed. */
+    readonly program: string;
+    /** The status line's check, and the shape the query gives. */
+    readonly check: QueryCheckLine;
+    readonly gives: QueryGivesLine | undefined;
+    /** The notices, newest last; a notice dismissed. */
+    readonly notices: readonly QueryNotice[];
+    readonly dismiss: (id: number) => void;
+    /** The parts' and the cards' asks. */
+    readonly actions: CardActions;
+    /** A Quick add button pressed. */
+    readonly onQuick: (kind: StepKind) => void;
+    /** The open slot's autocomplete. */
+    readonly popover: SlotPopover | undefined;
+}
+/**
+ * Editing the open query — see the module docs.
+ *
+ * @param options - The session's entries and gesture, the root, the words and the builder's element
+ * @returns What the surfaces draw, and what they do
+ */
+export declare function useQueryEditor(options: QueryEditorOptions): QueryEditor;
+//# sourceMappingURL=use-query-editor.d.ts.map