@elaraai/e3-ui-components 1.0.83 → 1.0.85

package/dist/query/session.d.ts

@@ -0,0 +1,409 @@
+import { ArrayType, OptionType, StringType, StructType, VariantType, EastType, ValueTypeOf, option } from '@elaraai/east';
+import { Editing } from '@elaraai/east-ui/internal';
+import { SavedQueriesType, SavedQueryType, QueriesHandleType } from '@elaraai/e3-ui/internal';
+import { BatchReadiness, EditSession, EntryVersion, Origin, UIStoreInterface } from '@elaraai/east-ui-components';
+import { CheckedSteps } from './steps/check.js';
+import { Step, StepQuery } from './steps/values.js';
+import { SavedOffer } from './model/slots.js';
+import { QueryWords } from './model/words.js';
+import { QueryRoot } from './one-shot.js';
+import { QueryOpen } from './open-query.js';
+/** The header entry's id. */
+export declare const QUERY_HEADER_ID = "$query";
+/**
+ * A query's header, as its editing session drafts it.
+ *
+ * @property id - Always {@link QUERY_HEADER_ID}
+ * @property name - Its name: its key in the saved queries, once saved
+ * @property description - Its description; `none` shows the generated sentence
+ * @property source - The data source its steps start from
+ * @property jq - The program as jq, when it is not steps — a program that
+ *   does not start from a data source; its steps are then empty
+ */
+export declare const QueryHeaderType: StructType<{
+    readonly id: StringType;
+    readonly name: StringType;
+    readonly description: OptionType<StringType>;
+    readonly source: StringType;
+    readonly jq: OptionType<StringType>;
+}>;
+/** A query's header. */
+export type QueryHeader = ValueTypeOf<typeof QueryHeaderType>;
+/**
+ * One entry of a query's editing session.
+ *
+ * @property header - Its header
+ * @property step - One of its steps
+ */
+export declare const QueryEntryType: VariantType<{
+    readonly header: StructType<{
+        readonly id: StringType;
+        readonly name: StringType;
+        readonly description: OptionType<StringType>;
+        readonly source: StringType;
+        readonly jq: OptionType<StringType>;
+    }>;
+    readonly step: VariantType<{
+        readonly filter: StructType<{
+            readonly id: StringType;
+            readonly match: VariantType<{
+                readonly all: import('@elaraai/east').NullType;
+                readonly any: import('@elaraai/east').NullType;
+            }>;
+            readonly conds: ArrayType<import('@elaraai/east').RecursiveType<VariantType<{
+                readonly test: StructType<{
+                    readonly id: StringType;
+                    readonly field: OptionType<StringType>;
+                    readonly cmp: OptionType<VariantType<{
+                        readonly eq: import('@elaraai/east').NullType;
+                        readonly ne: import('@elaraai/east').NullType;
+                        readonly ge: import('@elaraai/east').NullType;
+                        readonly le: import('@elaraai/east').NullType;
+                        readonly gt: import('@elaraai/east').NullType;
+                        readonly lt: import('@elaraai/east').NullType;
+                        readonly contains: import('@elaraai/east').NullType;
+                        readonly startsWith: import('@elaraai/east').NullType;
+                        readonly missing: import('@elaraai/east').NullType;
+                        readonly present: import('@elaraai/east').NullType;
+                        readonly yes: import('@elaraai/east').NullType;
+                        readonly no: import('@elaraai/east').NullType;
+                        readonly inYear: import('@elaraai/east').NullType;
+                        readonly inMonth: import('@elaraai/east').NullType;
+                        readonly onOrAfter: import('@elaraai/east').NullType;
+                        readonly before: import('@elaraai/east').NullType;
+                        readonly lengthAtLeast: import('@elaraai/east').NullType;
+                        readonly anyWhere: import('@elaraai/east').NullType;
+                    }>>;
+                    readonly value: OptionType<VariantType<{
+                        readonly text: StringType;
+                        readonly number: import('@elaraai/east').FloatType;
+                        readonly boolean: import('@elaraai/east').BooleanType;
+                        readonly null: import('@elaraai/east').NullType;
+                    }>>;
+                    readonly inner: OptionType<import('@elaraai/east').RecursiveTypeMarker>;
+                    readonly whole: import('@elaraai/east').BooleanType;
+                }>;
+                readonly group: StructType<{
+                    readonly id: StringType;
+                    readonly match: VariantType<{
+                        readonly all: import('@elaraai/east').NullType;
+                        readonly any: import('@elaraai/east').NullType;
+                    }>;
+                    readonly conds: ArrayType<import('@elaraai/east').RecursiveTypeMarker>;
+                }>;
+            }>>>;
+        }>;
+        readonly lookup: StructType<{
+            readonly id: StringType;
+            readonly dataset: OptionType<StringType>;
+            readonly key: OptionType<StringType>;
+            readonly fields: ArrayType<StringType>;
+        }>;
+        readonly group: StructType<{
+            readonly id: StringType;
+            readonly by: OptionType<VariantType<{
+                readonly field: StringType;
+                readonly all: import('@elaraai/east').NullType;
+            }>>;
+            readonly aggs: ArrayType<StructType<{
+                readonly id: StringType;
+                readonly fn: VariantType<{
+                    readonly count: import('@elaraai/east').NullType;
+                    readonly sum: import('@elaraai/east').NullType;
+                    readonly mean: import('@elaraai/east').NullType;
+                    readonly min: import('@elaraai/east').NullType;
+                    readonly max: import('@elaraai/east').NullType;
+                    readonly distinct: import('@elaraai/east').NullType;
+                }>;
+                readonly field: OptionType<StringType>;
+                readonly as: StringType;
+            }>>;
+        }>;
+        readonly sort: StructType<{
+            readonly id: StringType;
+            readonly field: OptionType<StringType>;
+            readonly dir: VariantType<{
+                readonly asc: import('@elaraai/east').NullType;
+                readonly desc: import('@elaraai/east').NullType;
+            }>;
+        }>;
+        readonly limit: StructType<{
+            readonly id: StringType;
+            readonly n: VariantType<{
+                readonly number: import('@elaraai/east').FloatType;
+                readonly text: StringType;
+            }>;
+        }>;
+        readonly count: StructType<{
+            readonly id: StringType;
+        }>;
+        readonly pick: StructType<{
+            readonly id: StringType;
+            readonly fields: ArrayType<StructType<{
+                readonly id: StringType;
+                readonly field: OptionType<StringType>;
+                readonly as: StringType;
+            }>>;
+        }>;
+        readonly fill: StructType<{
+            readonly id: StringType;
+            readonly field: OptionType<StringType>;
+            readonly value: OptionType<VariantType<{
+                readonly text: StringType;
+                readonly number: import('@elaraai/east').FloatType;
+                readonly boolean: import('@elaraai/east').BooleanType;
+                readonly null: import('@elaraai/east').NullType;
+            }>>;
+        }>;
+        readonly drill: StructType<{
+            readonly id: StringType;
+            readonly field: OptionType<StringType>;
+        }>;
+        readonly datepart: StructType<{
+            readonly id: StringType;
+            readonly field: OptionType<StringType>;
+            readonly part: VariantType<{
+                readonly year: import('@elaraai/east').NullType;
+                readonly month: import('@elaraai/east').NullType;
+                readonly weekday: import('@elaraai/east').NullType;
+            }>;
+            readonly as: StringType;
+        }>;
+        readonly walk: StructType<{
+            readonly id: StringType;
+            readonly via: OptionType<StringType>;
+        }>;
+        readonly tabulate: StructType<{
+            readonly id: StringType;
+            readonly over: StringType;
+            readonly from: VariantType<{
+                readonly number: import('@elaraai/east').FloatType;
+                readonly text: StringType;
+            }>;
+            readonly to: VariantType<{
+                readonly number: import('@elaraai/east').FloatType;
+                readonly text: StringType;
+            }>;
+            readonly step: VariantType<{
+                readonly number: import('@elaraai/east').FloatType;
+                readonly text: StringType;
+            }>;
+            readonly fixed: import('@elaraai/east').DictType<StringType, VariantType<{
+                readonly text: StringType;
+                readonly number: import('@elaraai/east').FloatType;
+                readonly boolean: import('@elaraai/east').BooleanType;
+                readonly null: import('@elaraai/east').NullType;
+            }>>;
+            readonly as: StringType;
+        }>;
+        readonly jq: StructType<{
+            readonly id: StringType;
+            readonly text: StringType;
+        }>;
+    }>;
+}>;
+/** One entry of a query's editing session. */
+export type QueryEntry = ValueTypeOf<typeof QueryEntryType>;
+/** The session's entry schema, as its wire names it. */
+export declare const QUERY_ENTRY_TYPE: import('@elaraai/east').EastTypeValue;
+/** The session's draft schema: each entry drafted whole. */
+export declare const QUERY_DRAFT_TYPE: import('@elaraai/east').EastTypeValue;
+/** The session's answer to a batch. */
+type ApplyResult = ValueTypeOf<typeof Editing.Types.ApplyResult>;
+/** A saved query. */
+export type SavedQuery = ValueTypeOf<typeof SavedQueryType>;
+/** The saved queries record. */
+export type SavedQueries = ValueTypeOf<typeof SavedQueriesType>;
+/** The bound saved queries record. */
+export type QueriesHandle = ValueTypeOf<typeof QueriesHandleType>;
+/**
+ * The id an entry has in the session.
+ *
+ * @param entry - The entry
+ * @returns Its id: `$query` for the header, a step's own
+ */
+export declare function entryId(entry: QueryEntry): string;
+/**
+ * A query as entries: its header, then its steps.
+ *
+ * @param header - Its header
+ * @param steps - Its steps, in order
+ * @returns The entries
+ */
+export declare function queryEntries(header: QueryHeader, steps: readonly Step[]): QueryEntry[];
+/**
+ * The query a session's entries make.
+ *
+ * @param entries - The entries
+ * @returns The header, and the steps as a query on its data source
+ * @throws {Error} When the entries hold no header
+ */
+export declare function entriesQuery(entries: readonly QueryEntry[]): {
+    header: QueryHeader;
+    query: StepQuery;
+};
+/**
+ * The program a query's entries make: its jq when it is not steps, else its
+ * steps printed as canonical jq.
+ *
+ * @param header - Its header
+ * @param query - Its steps
+ * @param root - The root's type
+ * @returns The program's text
+ */
+export declare function queryProgram(header: QueryHeader, query: StepQuery, root: EastType): string;
+/**
+ * What a query's session begins from: the saved entry, and its entries.
+ *
+ * @property saved - The saved query the entries are of; `undefined` for a query never saved
+ * @property entries - The header and the steps
+ */
+export interface QueryBase {
+    readonly saved: SavedQuery | undefined;
+    readonly entries: readonly QueryEntry[];
+}
+/**
+ * A saved query's entries: its header, and its steps parsed from its
+ * program — or, for a program that is not steps, its jq.
+ *
+ * @param saved - The saved query
+ * @param root - The root's type
+ * @returns The entries; the steps' ids are fresh
+ */
+export declare function savedEntries(saved: SavedQuery, root: EastType): QueryEntry[];
+/**
+ * The base the open query's session begins from: a save it committed; else
+ * the base it was given last, while the record still holds the entry it is
+ * of; else the saved query's entries, parsed once; else a new query's header
+ * alone — or, for a new query begun as a run never saved, the run's entries,
+ * its name and description with them.
+ *
+ * @remarks
+ * A save the session committed is its base from the moment it commits, while
+ * the record has not read it back yet — the session acknowledges its own
+ * request by it, whichever comes first, its answer or the record's re-read —
+ * and its base for good once the record holds it. A record that holds another
+ * entry under its name has moved on since: the record's entry is the base
+ * again.
+ *
+ * @param store - The UI store the sessions live in
+ * @param sourceId - The open query's session's source id
+ * @param open - The open query
+ * @param record - The saved queries
+ * @param root - The root's type
+ * @param untitled - A new query's name on a data source
+ * @returns The base, or `undefined` when the open saved query is not in the record
+ */
+export declare function queryBase(store: UIStoreInterface, sourceId: string, open: QueryOpen, record: SavedQueries, root: EastType, untitled: (source: string) => string): QueryBase | undefined;
+/**
+ * Remembers a save a session's Apply committed, as the base it continues
+ * from: the saved entry it wrote, and the entries it applied — for the session
+ * that applied them, and for the saved query's own, which a new query and a
+ * rename open next ({@link queryBase}).
+ *
+ * @param store - The UI store the sessions live in
+ * @param sourceIds - The source ids to remember it under
+ * @param base - The saved entry and the entries
+ */
+export declare function rememberSave(store: UIStoreInterface, sourceIds: readonly string[], base: QueryBase): void;
+/**
+ * The snapshot a base is, as the session's wire carries it.
+ *
+ * @param base - The base
+ * @returns Its entries, encoded
+ */
+export declare function encodeBase(base: QueryBase): Uint8Array;
+/**
+ * One entry of a base, by id, as the session's wire carries it.
+ *
+ * @param base - The base
+ * @param id - The entry's id
+ * @returns The entry, encoded, or `none` when the base has no entry of that id
+ */
+export declare function readBaseEntry(base: QueryBase, id: string): option<Uint8Array>;
+/**
+ * The saved queries a builder offers to start from, as the add-step list of a
+ * query with no steps offers them (#934): each whose data sources are all
+ * bound here, by the same name and at the same path (`QueryInternal.rootBound`),
+ * with the data source its steps start from.
+ *
+ * @param record - The saved queries
+ * @param root - The root the builder's data sources make
+ * @returns The offers, in name order
+ */
+export declare function savedOffers(record: SavedQueries, root: QueryRoot): SavedOffer[];
+/**
+ * Why a saved query — or a recent run — can't open here, in the builder's
+ * words (`Query Editor Spec.md` §4.10): a data source it reads that no binding
+ * here has the name of, or one bound here at another path
+ * (`QueryInternal.rootBound`).
+ *
+ * @param saved - The saved query, or the run
+ * @param root - The root the builder's data sources make
+ * @param words - The words
+ * @returns The reason — "Reads customers, which isn't here", "Reads
+ *   .inputs.archive.orders, not this builder's orders" — or `undefined` when
+ *   it can open
+ */
+export declare function rootRefusal(saved: SavedQuery, root: QueryRoot, words: QueryWords): string | undefined;
+/**
+ * The query's problems as the session's readiness: each error an `invalid`
+ * issue, each unfinished slot an `incomplete` one, in plain words, on the step
+ * and the slot they are about.
+ *
+ * @param header - The query's header
+ * @param query - Its steps
+ * @param root - The root, or a reason it cannot be queried
+ * @param words - The words
+ * @returns The readiness, and the check it was made from
+ */
+export declare function queryReadiness(header: QueryHeader, query: StepQuery, root: QueryRoot | string, words: QueryWords): {
+    readiness: BatchReadiness;
+    checked: CheckedSteps | undefined;
+};
+/** What a query's Apply needs. */
+export interface QueryApplyContext {
+    /** The saved queries record, bound with its patch. */
+    readonly handle: QueriesHandle;
+    /** The open query. */
+    readonly open: QueryOpen;
+    /** The base its session began from. */
+    readonly base: QueryBase;
+    /** The root. */
+    readonly root: QueryRoot;
+    /** The UI store the sessions live in. */
+    readonly store: UIStoreInterface;
+    /** The session's own source id. */
+    readonly sourceId: string;
+    /** The source id a query of a name has. */
+    readonly sourceIdOf: (name: string) => string;
+    /** What a refused write says, in the builder's words. */
+    readonly refused: (outcome: "changed" | "renamed", name: string, by: string | undefined) => string;
+    /** Told the name a commit saved the query under, once its save is remembered: the base is the save's from then on. */
+    readonly onSaved: (name: string) => void;
+    /** The clock a save is stamped with. */
+    readonly now?: () => Date;
+}
+/**
+ * A query's `onApply`: the batch applied to the base, the program printed,
+ * checked and prepared over the root, and the query committed as one patch.
+ *
+ * @param ctx - The record, the open query, its base and root, and the words
+ * @returns The session's async apply, over the batch's bytes
+ */
+export declare function queryApply(ctx: QueryApplyContext): (bytes: Uint8Array) => Promise<ApplyResult>;
+/**
+ * Records one gesture: the query as it was and as the gesture leaves it, as
+ * one undoable transaction of every entry it changed, added, removed or moved.
+ *
+ * @param session - The open query's session
+ * @param original - An entry's version before any draft of it
+ * @param current - The entries as the drafts stand
+ * @param next - The entries after the gesture
+ * @param origin - The gesture
+ * @param label - Its label in the history
+ * @returns Whether anything changed
+ */
+export declare function recordGesture(session: EditSession<QueryEntry>, original: (id: string) => EntryVersion<QueryEntry>, current: readonly QueryEntry[], next: readonly QueryEntry[], origin: Origin, label: string): boolean;
+export {};
+//# sourceMappingURL=session.d.ts.map

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

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

package/dist/query/shape-line.d.ts

@@ -0,0 +1,21 @@
+import { ShapeLine } from './model/cards.js';
+import { PartActions, PartStyles } from './parts.js';
+/** Props of {@link ShapeLineView}. */
+export interface ShapeLineViewProps {
+    /** The shape. */
+    readonly shape: ShapeLine;
+    /** Where Insert adds a step: before the step at this index. */
+    readonly at: number;
+    /** The parts' styles, and the words. */
+    readonly ps: PartStyles;
+    /** What Insert asks: the add-step list, hanging from it. */
+    readonly onSlot: PartActions["onSlot"];
+}
+/**
+ * Renders the line after the source or a step — see the module docs.
+ *
+ * @param props - The shape, Insert's place, and what it asks ({@link ShapeLineViewProps})
+ * @returns The line
+ */
+export declare const ShapeLineView: import('react').NamedExoticComponent<ShapeLineViewProps>;
+//# sourceMappingURL=shape-line.d.ts.map

package/dist/query/shape-line.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shape-line.d.ts","sourceRoot":"","sources":["../../src/query/shape-line.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAiBH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD,OAAO,EAAgB,KAAK,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7E,sCAAsC;AACtC,MAAM,WAAW,kBAAkB;IAC/B,iBAAiB;IACjB,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,wCAAwC;IACxC,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC;IACxB,4DAA4D;IAC5D,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAC;CAC1C;AAED;;;;;GAKG;AACH,eAAO,MAAM,aAAa,0DAmBxB,CAAC"}

package/dist/query/source.d.ts

@@ -0,0 +1,21 @@
+import { SourceCard } from './model/cards.js';
+import { PartStyles } from './parts.js';
+/** Props of {@link SourceCardView}. */
+export interface SourceCardViewProps {
+    /** The card. */
+    readonly card: SourceCard;
+    /** The data source's name. */
+    readonly source: string;
+    /** The workspace it is read in, when the builder knows it. */
+    readonly workspace: string | undefined;
+    /** The parts' styles, and the words. */
+    readonly ps: PartStyles;
+}
+/**
+ * Renders the source's card — see the module docs.
+ *
+ * @param props - The card, the source, the workspace and the styles ({@link SourceCardViewProps})
+ * @returns The card
+ */
+export declare const SourceCardView: import('react').NamedExoticComponent<SourceCardViewProps>;
+//# sourceMappingURL=source.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"source.d.ts","sourceRoot":"","sources":["../../src/query/source.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAcH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,uCAAuC;AACvC,MAAM,WAAW,mBAAmB;IAChC,gBAAgB;IAChB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,8BAA8B;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,8DAA8D;IAC9D,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,wCAAwC;IACxC,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC;CAC3B;AAED;;;;;GAKG;AACH,eAAO,MAAM,cAAc,2DAYzB,CAAC"}

package/dist/query/status-line.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/** The check, as the status line says it. */
+export interface QueryCheckLine {
+    /** Its dot's tone. */
+    readonly tone: "success" | "warning" | "danger";
+    /** Its word: "Checks clean", "2 to finish", "1 problem". */
+    readonly word: string;
+}
+/** The shape the query gives, as the status line says it. */
+export interface QueryGivesLine {
+    /** "Gives up to 10 shipped orders". */
+    readonly text: string;
+    /** Its East type and multiplicity, on hover. */
+    readonly hover: string;
+    /** Its fields: "· order, customer, total". */
+    readonly fields: string;
+}
+/** The save state, as the status line says it. */
+export interface QuerySaveLine {
+    /** Saved, drafts not yet saved, or never saved. */
+    readonly state: "saved" | "unsaved" | "new";
+    /** Whether it saved just now: its dot is the success ink for a moment, then quiet. */
+    readonly fresh: boolean;
+    /** Its word. */
+    readonly word: string;
+}
+/** Props of {@link QueryStatusLine}. */
+export interface QueryStatusLineProps {
+    /** The check. */
+    readonly check: QueryCheckLine;
+    /** The shape the query gives, when it is known. */
+    readonly gives: QueryGivesLine | undefined;
+    /** The save state. */
+    readonly save: QuerySaveLine;
+    /** The query's name. */
+    readonly name: string;
+}
+/**
+ * Renders the status line — see the module docs.
+ *
+ * @param props - The check, the shape, the save state and the name ({@link QueryStatusLineProps})
+ * @returns The status line
+ */
+export declare const QueryStatusLine: import('react').NamedExoticComponent<QueryStatusLineProps>;
+//# sourceMappingURL=status-line.d.ts.map

package/dist/query/status-line.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-line.d.ts","sourceRoot":"","sources":["../../src/query/status-line.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAoBH,6CAA6C;AAC7C,MAAM,WAAW,cAAc;IAC3B,sBAAsB;IACtB,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;IAChD,4DAA4D;IAC5D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACzB;AAED,6DAA6D;AAC7D,MAAM,WAAW,cAAc;IAC3B,uCAAuC;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,gDAAgD;IAChD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,8CAA8C;IAC9C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CAC3B;AAED,kDAAkD;AAClD,MAAM,WAAW,aAAa;IAC1B,mDAAmD;IACnD,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,GAAG,KAAK,CAAC;IAC5C,sFAAsF;IACtF,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,gBAAgB;IAChB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACzB;AAED,wCAAwC;AACxC,MAAM,WAAW,oBAAoB;IACjC,iBAAiB;IACjB,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,mDAAmD;IACnD,QAAQ,CAAC,KAAK,EAAE,cAAc,GAAG,SAAS,CAAC;IAC3C,sBAAsB;IACtB,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,wBAAwB;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACzB;AAWD;;;;;GAKG;AACH,eAAO,MAAM,eAAe,4DA+B1B,CAAC"}

package/dist/query/step-card.d.ts

@@ -0,0 +1,30 @@
+import { Card } from './model/cards.js';
+import { PartActions, PartStyles } from './parts.js';
+/** What a card asks of the Query tab, besides its parts'. */
+export interface CardActions extends PartActions {
+    /** Moves a step up (`-1`) or down (`1`). */
+    readonly onMove: (stepId: string, by: -1 | 1) => void;
+    /** Takes a step out. */
+    readonly onRemoveStep: (stepId: string) => void;
+}
+/** Props of {@link StepCard}. */
+export interface StepCardProps {
+    /** The card. */
+    readonly card: Card;
+    /** How many steps the query has. */
+    readonly count: number;
+    /** Whether an issue the history item went to is on it. */
+    readonly focused: boolean;
+    /** The parts' styles, and the words. */
+    readonly ps: PartStyles;
+    /** What its parts and its buttons ask. */
+    readonly actions: CardActions;
+}
+/**
+ * Renders a step's card — see the module docs.
+ *
+ * @param props - The card, the step count, and what it asks ({@link StepCardProps})
+ * @returns The card
+ */
+export declare const StepCard: import('react').NamedExoticComponent<StepCardProps>;
+//# sourceMappingURL=step-card.d.ts.map

package/dist/query/step-card.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"step-card.d.ts","sourceRoot":"","sources":["../../src/query/step-card.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAkBH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAA0B,KAAK,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAEvF,6DAA6D;AAC7D,MAAM,WAAW,WAAY,SAAQ,WAAW;IAC5C,4CAA4C;IAC5C,QAAQ,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC;IACtD,wBAAwB;IACxB,QAAQ,CAAC,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CACnD;AAED,iCAAiC;AACjC,MAAM,WAAW,aAAa;IAC1B,gBAAgB;IAChB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,oCAAoC;IACpC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,0DAA0D;IAC1D,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,wCAAwC;IACxC,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC;IACxB,0CAA0C;IAC1C,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;CACjC;AAED;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,qDA2BnB,CAAC"}