@elaraai/e3-ui-components 1.0.83 → 1.0.85

package/dist/platform/record-runtime.d.ts

@@ -1,13 +1,17 @@
 import { EastType, EastTypeValue, ValueTypeOf } from '@elaraai/east';
 import { PlatformFunction } from '@elaraai/east/internal';
 import { RecordErrorType } from '@elaraai/e3-ui/internal';
-import { RecordSignature, MutationResult, RecordHistoryResult } from '@elaraai/e3-api-client';
+import { RecordSignature, MutationResult, RecordHistoryResult, RequestOptions } from '@elaraai/e3-api-client';
 import { TrackedChannelStore } from './tracked-channel.js';
 import { ReactiveDatasetCacheInterface } from './dataset-store.js';
 /** Request shape for {@link RecordApi.mutate} — beast2-encoded positional
  *  args (the extra reducer parameters, after the implicit state). */
 export interface RecordMutateArgs {
     args: Uint8Array[];
+    /** The write's idempotency key: a retry with the same key after an
+     *  unanswered call resolves to the first call's commit instead of writing
+     *  twice. */
+    idempotencyKey?: string;
 }
 /**
  * Adapter for the workspace record endpoints. The default wraps
@@ -26,8 +30,14 @@ export interface RecordApi {
 /**
  * Build the default {@link RecordApi} that talks to a real e3 server via
  * `@elaraai/e3-api-client`.
+ *
+ * @param apiUrl - Base URL of the e3 API server
+ * @param repo - Repository name
+ * @param getOptions - Reads the current request options — the token, and the
+ *   `fetch` requests go through — so a rotated one is used at once
+ * @returns The adapter
  */
-export declare function createDefaultRecordApi(apiUrl: string, repo: string, getToken: () => string | null): RecordApi;
+export declare function createDefaultRecordApi(apiUrl: string, repo: string, getOptions: () => RequestOptions): RecordApi;
 type RecordError = ValueTypeOf<RecordErrorType>;
 type RecordMutateTag = "idle" | "running" | "committed" | "failed" | "cancelled";
 /** A handle's signature, recovered from the instantiated handle type. */
@@ -73,7 +83,8 @@ export declare class RecordRuntime extends TrackedChannelStore<RecordEntry> {
     private readonly handleCache;
     protected createEntry(): RecordEntry;
     /** Install the API adapter + dataset cache + workspace — called by the
-     *  React provider (or a test/showcase harness) before any handle is used. */
+     *  React provider (or a test, or the snapshot harness) before any handle
+     *  is used. */
     initialize(api: RecordApi, cache: ReactiveDatasetCacheInterface, workspace: string): void;
     /**
      * Tear down the adapter and all record state.
@@ -88,9 +99,29 @@ export declare class RecordRuntime extends TrackedChannelStore<RecordEntry> {
     private signature;
     /** Validate a mutation's declared arg types against the deployed signature. */
     private validate;
-    /** Fetch a record's history once per channel (deduped); notify on settle. */
+    /**
+     * Fetch a record's history once per channel (deduped); notify on settle.
+     *
+     * @param again - Fetch once more after a fetch in flight, which may have
+     *   read the chain before what the caller fetches it for
+     * @returns The fetch, settled once the history or its failure is in
+     */
     private fetchHistory;
-    private launchMutation;
+    /**
+     * Run one mutation on the record's channel, and settle to the server's
+     * outcome.
+     *
+     * @remarks
+     * The channel shows the write as it shows every launch, latest-wins; the
+     * outcome returned is the server's own, whatever became of the channel. A
+     * commit refreshes the record's bytes and drops its history. A conflict
+     * fetches both again before the outcome settles, so an awaiting caller
+     * reads the state and the history its write lost to.
+     *
+     * @param idempotencyKey - The write's request id, when it has one
+     * @returns The outcome
+     */
+    private runMutation;
     /**
      * The low-level primitives backing handle methods, bound to THIS runtime.
      * Registered globally (extension registry) and included by the scoped
@@ -117,7 +148,7 @@ export declare class RecordRuntime extends TrackedChannelStore<RecordEntry> {
 /** Process-global runtime backing the `RecordPlatform` export. */
 export declare const defaultRecordRuntime: RecordRuntime;
 /** Install the record API adapter + dataset cache + workspace — called by the
- *  React provider on mount (or by a test/showcase harness). */
+ *  React provider on mount (or by a test, or the snapshot harness). */
 export declare function initializeRecordApi(api: RecordApi, cache: ReactiveDatasetCacheInterface, workspace: string): void;
 /**
  * Tear down the record API adapter and all record state.
@@ -152,8 +183,15 @@ export interface InMemoryRecordDef {
 }
 /**
  * Build an offline {@link RecordApi} from local implementations — the
- * showcase/snapshot harnesses' stand-in for a deployed record. Seeds each
+ * snapshot harness's stand-in for a deployed record. Seeds each
  * record's current value into the dataset cache so `read()` works offline.
+ *
+ * @remarks
+ * A reducer that throws a patch's `ConflictError` — `applyFor` over a patch
+ * whose befores the state no longer holds — is the stale write the server
+ * reports as a `conflict` naming the key; any other throw is a failed program.
+ * A mutation carrying the key the last one carried returns that one's result
+ * without running again, as the server's idempotent retry does.
  */
 export declare function createInMemoryRecordApi(cache: ReactiveDatasetCacheInterface, workspace: string, defs: InMemoryRecordDef[]): RecordApi;
 export {};

package/dist/platform/record-runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"record-runtime.d.ts","sourceRoot":"","sources":["../../src/platform/record-runtime.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAaH,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,KAAK,WAAW,EACnB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,KAAK,gBAAgB,EAAgB,MAAM,wBAAwB,CAAC;AAC7E,OAAO,EAA8C,KAAK,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC3G,OAAO,EAIH,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,mBAAmB,EAE3B,MAAM,wBAAwB,CAAC;AAKhC,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAE3D,OAAO,EAAmB,KAAK,6BAA6B,EAAE,MAAM,oBAAoB,CAAC;AASzF;qEACqE;AACrE,MAAM,WAAW,gBAAgB;IAC7B,IAAI,EAAE,UAAU,EAAE,CAAC;CACtB;AAED;;;;;GAKG;AACH,MAAM,WAAW,SAAS;IACtB,8EAA8E;IAC9E,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IACtE,6EAA6E;IAC7E,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAC5G,mDAAmD;IACnD,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;CACtH;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAClC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,MAAM,GAAG,IAAI,GAC9B,SAAS,CAiBX;AAMD,KAAK,WAAW,GAAG,WAAW,CAAC,eAAe,CAAC,CAAC;AAChD,KAAK,eAAe,GAAG,MAAM,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;AAKjF,yEAAyE;AACzE,UAAU,qBAAqB;IAC3B,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC,CAAC;CAC5D;AAKD;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAAC,UAAU,EAAE,aAAa,GAAG,qBAAqB,CAuB5F;AAwCD,qDAAqD;AACrD,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAExE;AAMD,8DAA8D;AAC9D,UAAU,WAAW;IACjB,MAAM,EAAE,eAAe,CAAC;IACxB;uEACmE;IACnE,SAAS,EAAE,MAAM,CAAC;IAClB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB;gFAC4E;IAC5E,QAAQ,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B;AAED;;;;GAIG;AACH,qBAAa,aAAc,SAAQ,mBAAmB,CAAC,WAAW,CAAC;IAC/D,OAAO,CAAC,GAAG,CAA0B;IACrC,OAAO,CAAC,KAAK,CAA8C;IAC3D,OAAO,CAAC,SAAS,CAAuB;IAGxC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA+C;IAE9E,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmC;IAC7D,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAqB;IAKrD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAqB;IAOnD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA8C;IAE1E,SAAS,CAAC,WAAW,IAAI,WAAW;IAMpC;iFAC6E;IAC7E,UAAU,CAAC,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,6BAA6B,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAMzF;;;;;;OAMG;IACH,KAAK,CAAC,GAAG,CAAC,EAAE,SAAS,GAAG,IAAI;IAa5B,OAAO,CAAC,gBAAgB;IAOxB,uFAAuF;IACvF,OAAO,CAAC,SAAS;IAejB,+EAA+E;YACjE,QAAQ;IAqBtB,6EAA6E;IAC7E,OAAO,CAAC,YAAY;IAuBpB,OAAO,CAAC,cAAc;IA6CtB;;;;;;;;OAQG;IACH,eAAe,IAAI,gBAAgB,EAAE;IAgGrC;;;;;;OAMG;IACH,WAAW,CAAC,UAAU,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAuD7E;;4BAEwB;IACxB,aAAa,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,IAAI,GAAG,gBAAgB;CAcvE;AAMD,kEAAkE;AAClE,eAAO,MAAM,oBAAoB,eAAsB,CAAC;AAExD;+DAC+D;AAC/D,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,6BAA6B,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAEjH;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,CAAC,EAAE,SAAS,GAAG,IAAI,CAEpD;AAED;6EAC6E;AAC7E,eAAO,MAAM,cAAc,EAAE,gBAAgB,EAG5C,CAAC;AAEF;;;;;0DAK0D;AAC1D,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,gBAAgB,EAAE,CAKzF;AASD,6EAA6E;AAC7E,MAAM,WAAW,iBAAiB;IAC9B,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,+BAA+B;IAC/B,SAAS,EAAE,QAAQ,GAAG,aAAa,CAAC;IACpC,qDAAqD;IACrD,OAAO,EAAE,OAAO,CAAC;IACjB,wEAAwE;IACxE,SAAS,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,CAAC,QAAQ,GAAG,aAAa,CAAC,EAAE,CAAC;QACvC,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC;KAC3D,EAAE,CAAC;CACP;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CACnC,KAAK,EAAE,6BAA6B,EACpC,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,iBAAiB,EAAE,GAC1B,SAAS,CAmEX"}
+{"version":3,"file":"record-runtime.d.ts","sourceRoot":"","sources":["../../src/platform/record-runtime.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAcH,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,KAAK,WAAW,EACnB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,KAAK,gBAAgB,EAAgB,MAAM,wBAAwB,CAAC;AAC7E,OAAO,EAA8C,KAAK,eAAe,EAA0B,MAAM,yBAAyB,CAAC;AACnI,OAAO,EAIH,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,mBAAmB,EAGxB,KAAK,cAAc,EACtB,MAAM,wBAAwB,CAAC;AAKhC,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAE3D,OAAO,EAAmB,KAAK,6BAA6B,EAAE,MAAM,oBAAoB,CAAC;AASzF;qEACqE;AACrE,MAAM,WAAW,gBAAgB;IAC7B,IAAI,EAAE,UAAU,EAAE,CAAC;IACnB;;iBAEa;IACb,cAAc,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;GAKG;AACH,MAAM,WAAW,SAAS;IACtB,8EAA8E;IAC9E,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IACtE,6EAA6E;IAC7E,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAC5G,mDAAmD;IACnD,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;CACtH;AAED;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CAClC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,cAAc,GACjC,SAAS,CAgBX;AAMD,KAAK,WAAW,GAAG,WAAW,CAAC,eAAe,CAAC,CAAC;AAEhD,KAAK,eAAe,GAAG,MAAM,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;AAsBjF,yEAAyE;AACzE,UAAU,qBAAqB;IAC3B,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC,CAAC;CAC5D;AAKD;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAAC,UAAU,EAAE,aAAa,GAAG,qBAAqB,CAuB5F;AA4CD,qDAAqD;AACrD,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAExE;AAMD,8DAA8D;AAC9D,UAAU,WAAW;IACjB,MAAM,EAAE,eAAe,CAAC;IACxB;uEACmE;IACnE,SAAS,EAAE,MAAM,CAAC;IAClB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB;gFAC4E;IAC5E,QAAQ,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B;AAED;;;;GAIG;AACH,qBAAa,aAAc,SAAQ,mBAAmB,CAAC,WAAW,CAAC;IAC/D,OAAO,CAAC,GAAG,CAA0B;IACrC,OAAO,CAAC,KAAK,CAA8C;IAC3D,OAAO,CAAC,SAAS,CAAuB;IAGxC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA+C;IAE9E,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmC;IAC7D,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAoC;IAKpE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAqB;IAOnD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA8C;IAE1E,SAAS,CAAC,WAAW,IAAI,WAAW;IAMpC;;mBAEe;IACf,UAAU,CAAC,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,6BAA6B,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAMzF;;;;;;OAMG;IACH,KAAK,CAAC,GAAG,CAAC,EAAE,SAAS,GAAG,IAAI;IAa5B,OAAO,CAAC,gBAAgB;IAOxB,uFAAuF;IACvF,OAAO,CAAC,SAAS;IAejB,+EAA+E;YACjE,QAAQ;IAqBtB;;;;;;OAMG;IACH,OAAO,CAAC,YAAY;IAyBpB;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,WAAW;IAgEnB;;;;;;;;OAQG;IACH,eAAe,IAAI,gBAAgB,EAAE;IAwGrC;;;;;;OAMG;IACH,WAAW,CAAC,UAAU,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAkE7E;;4BAEwB;IACxB,aAAa,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,IAAI,GAAG,gBAAgB;CAcvE;AAMD,kEAAkE;AAClE,eAAO,MAAM,oBAAoB,eAAsB,CAAC;AAExD;uEACuE;AACvE,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,6BAA6B,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAEjH;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,CAAC,EAAE,SAAS,GAAG,IAAI,CAEpD;AAED;6EAC6E;AAC7E,eAAO,MAAM,cAAc,EAAE,gBAAgB,EAG5C,CAAC;AAEF;;;;;0DAK0D;AAC1D,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,gBAAgB,EAAE,CAKzF;AASD,6EAA6E;AAC7E,MAAM,WAAW,iBAAiB;IAC9B,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,+BAA+B;IAC/B,SAAS,EAAE,QAAQ,GAAG,aAAa,CAAC;IACpC,qDAAqD;IACrD,OAAO,EAAE,OAAO,CAAC;IACjB,wEAAwE;IACxE,SAAS,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,CAAC,QAAQ,GAAG,aAAa,CAAC,EAAE,CAAC;QACvC,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC;KAC3D,EAAE,CAAC;CACP;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CACnC,KAAK,EAAE,6BAA6B,EACpC,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,iBAAiB,EAAE,GAC1B,SAAS,CAkFX"}

package/dist/platform/recovery.d.ts

@@ -0,0 +1,44 @@
+import { QueryObserverResult } from '@tanstack/react-query';
+/** The most a view waits before it tries a read again after its first
+ *  failure; each failure in a row doubles it, up to {@link RECOVERY_MAX_MS}. */
+export declare const RECOVERY_FIRST_MS = 1000;
+/** The most a view waits before it tries a read again. */
+export declare const RECOVERY_MAX_MS = 30000;
+/**
+ * How long a view waits before it tries a failed read again.
+ *
+ * @remarks
+ * The wait backs off: at most 1 s after the first failure in a row, doubling
+ * with each failure after it, up to 30 s. It is a random point in the second
+ * half of that: 0.5–1 s after the first failure, 1–2 s after the second, and
+ * 15–30 s from the sixth on. So views that failed together try again apart,
+ * and none tries again sooner than half its backoff.
+ *
+ * @param failures - How many times in a row the read has failed, from 1
+ * @param random - A draw from [0, 1); `Math.random` unless a test gives one
+ * @returns The wait, in milliseconds
+ */
+export declare function recoveryDelay(failures: number, random?: () => number): number;
+/** What {@link useQueryRecovery} reads of a query, as `useQuery` returns it. */
+export type RecoveringQuery = Pick<QueryObserverResult<unknown, Error>, "error" | "errorUpdatedAt" | "dataUpdatedAt" | "fetchStatus" | "refetch">;
+/**
+ * Tries a failed query again by itself, for as long as the view is mounted,
+ * and gives the failure to show meanwhile.
+ *
+ * @remarks
+ * A query that failed fetches again only when the window regains focus or the
+ * view mounts again, so a view on a screen no one touches would stay on the
+ * failure. This fetches it again after {@link recoveryDelay}'s wait for each
+ * failure in a row, once the query has stopped fetching.
+ *
+ * TanStack clears the error of a query that holds no data while it fetches
+ * again, so a view that showed the query's error would go back to loading at
+ * every try. The failure this gives stands until a fetch reads: the latest,
+ * through each try.
+ *
+ * @param query - The query to keep trying while it fails
+ * @returns The failure to show, or `null` while the query has not failed since
+ *   it last read
+ */
+export declare function useQueryRecovery(query: RecoveringQuery): Error | null;
+//# sourceMappingURL=recovery.d.ts.map

package/dist/platform/recovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recovery.d.ts","sourceRoot":"","sources":["../../src/platform/recovery.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAgBH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAEjE;gFACgF;AAChF,eAAO,MAAM,iBAAiB,OAAQ,CAAC;AAEvC,0DAA0D;AAC1D,eAAO,MAAM,eAAe,QAAS,CAAC;AAEtC;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,MAAoB,GAAG,MAAM,CAG1F;AAED,gFAAgF;AAChF,MAAM,MAAM,eAAe,GAAG,IAAI,CAC9B,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,EACnC,OAAO,GAAG,gBAAgB,GAAG,eAAe,GAAG,aAAa,GAAG,SAAS,CAC3E,CAAC;AAYF;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,eAAe,GAAG,KAAK,GAAG,IAAI,CAsBrE"}

package/dist/platform/staged-store.d.ts

@@ -135,7 +135,23 @@ export declare class StagedStore implements StagedStoreInterface {
     private emitPersistError;
     private hydrate;
 }
+/**
+ * The staged store the package uses: the one installed
+ * ({@link initializeStagedStore}), else the default — over IndexedDB where
+ * there is one, made when it is first asked for.
+ *
+ * @returns The store
+ */
 export declare function getStagedStore(): StagedStoreInterface;
+/**
+ * Install the staged store the package uses from now on. The default
+ * `Data.bind` runtime, its reactive tracker and the providers each read the
+ * store installed when they use it, so a host installs its own as it loads —
+ * one that keeps edits in memory, say, when what they are staged against
+ * lives no longer than the page.
+ *
+ * @param store - The store
+ */
 export declare function initializeStagedStore(store: StagedStoreInterface): void;
 export declare function clearStagedStoreSingleton(): void;
 //# sourceMappingURL=staged-store.d.ts.map

package/dist/platform/staged-store.d.ts.map

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

package/dist/platform/tracked-channel.d.ts

@@ -51,6 +51,18 @@ export declare abstract class TrackedChannelStore<E extends ChannelEntry> {
     protected track(key: string): void;
     subscribe(key: string, callback: () => void): () => void;
     getKeyVersion(key: string): number;
+    /** Whether anything is subscribed to a channel. */
+    protected isSubscribed(key: string): boolean;
+    /**
+     * Called as a channel's last subscriber leaves, synchronously — a
+     * subclass that holds something for the channel's readers can let it go.
+     * A reader re-subscribing drops its subscriptions first (a tracked read's
+     * run, React's), so what is let go should be let go only if the channel
+     * is still unsubscribed once that is done.
+     *
+     * @param _key - The channel
+     */
+    protected unsubscribed(_key: string): void;
     protected notify(key: string): void;
     protected entry(key: string): E;
     /**

package/dist/platform/tracked-channel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tracked-channel.d.ts","sourceRoot":"","sources":["../../src/platform/tracked-channel.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;;;GAaG;AAEH,sDAAsD;AACtD,MAAM,WAAW,YAAY;IACzB;sDACkD;IAClD,MAAM,EAAE,MAAM,CAAC;IACf;0EACsE;IACtE,SAAS,EAAE,MAAM,CAAC;CACrB;AAED;;;;;GAKG;AACH,8BAAsB,mBAAmB,CAAC,CAAC,SAAS,YAAY;IAC5D,SAAS,CAAC,QAAQ,CAAC,OAAO,iBAAwB;IAGlD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAsC;IACrE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA6B;IAIzD,OAAO,CAAC,eAAe,CAA4B;IAEnD,+DAA+D;IAC/D,SAAS,CAAC,QAAQ,CAAC,WAAW,IAAI,CAAC;IAInC,cAAc,IAAI,GAAG,CAAC,MAAM,CAAC;IAK7B,eAAe,IAAI,MAAM,EAAE;IAM3B,UAAU,IAAI,OAAO;IAIrB;;;+CAG2C;IAC3C,SAAS,CAAC,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzC;qBACiB;IACjB,SAAS,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAMlC,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAexD,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAIlC,SAAS,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAQnC,SAAS,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC;IAS/B;;;;;;OAMG;IACH,SAAS,CAAC,WAAW,CACjB,GAAG,EAAE,MAAM,EACX,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,GAC3B;QAAE,KAAK,EAAE,CAAC,CAAC;QAAC,MAAM,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,KAAK,IAAI,CAAA;KAAE;IAiB7D;;;;OAIG;IACH,SAAS,CAAC,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,GAAG,IAAI;IAUtE,mEAAmE;IACnE,SAAS,CAAC,aAAa,IAAI,IAAI;CAKlC"}
+{"version":3,"file":"tracked-channel.d.ts","sourceRoot":"","sources":["../../src/platform/tracked-channel.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;;;GAaG;AAEH,sDAAsD;AACtD,MAAM,WAAW,YAAY;IACzB;sDACkD;IAClD,MAAM,EAAE,MAAM,CAAC;IACf;0EACsE;IACtE,SAAS,EAAE,MAAM,CAAC;CACrB;AAED;;;;;GAKG;AACH,8BAAsB,mBAAmB,CAAC,CAAC,SAAS,YAAY;IAC5D,SAAS,CAAC,QAAQ,CAAC,OAAO,iBAAwB;IAGlD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAsC;IACrE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA6B;IAIzD,OAAO,CAAC,eAAe,CAA4B;IAEnD,+DAA+D;IAC/D,SAAS,CAAC,QAAQ,CAAC,WAAW,IAAI,CAAC;IAInC,cAAc,IAAI,GAAG,CAAC,MAAM,CAAC;IAK7B,eAAe,IAAI,MAAM,EAAE;IAM3B,UAAU,IAAI,OAAO;IAIrB;;;+CAG2C;IAC3C,SAAS,CAAC,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzC;qBACiB;IACjB,SAAS,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAMlC,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAgBxD,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAIlC,mDAAmD;IACnD,SAAS,CAAC,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAI5C;;;;;;;;OAQG;IACH,SAAS,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAE1C,SAAS,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAQnC,SAAS,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC;IAS/B;;;;;;OAMG;IACH,SAAS,CAAC,WAAW,CACjB,GAAG,EAAE,MAAM,EACX,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,GAC3B;QAAE,KAAK,EAAE,CAAC,CAAC;QAAC,MAAM,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,KAAK,IAAI,CAAA;KAAE;IAiB7D;;;;OAIG;IACH,SAAS,CAAC,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,GAAG,IAAI;IAUtE,mEAAmE;IACnE,SAAS,CAAC,aAAa,IAAI,IAAI;CAKlC"}

package/dist/query/about.d.ts

@@ -0,0 +1,50 @@
+import { Formatters } from '@elaraai/east-ui-components';
+import { OutlineLine } from './model/cards.js';
+import { QueryWords } from './model/words.js';
+import { QueryRoot } from './one-shot.js';
+import { SavedQuery } from './session.js';
+/** What a saved query, or a recent run, is here. */
+export interface QueryAbout {
+    /**
+     * The data source its steps start from; for a program that is not steps,
+     * the first its root reads — else the first bound.
+     */
+    readonly source: string;
+    /** Its description: the author's, else the sentence generated from its steps; `undefined` when there is neither. */
+    readonly description: string | undefined;
+    /** Why it can't open here, in the builder's words; `undefined` when it can. */
+    readonly refusal: string | undefined;
+    /** Its steps: how many, and one outline line per finished step; `undefined` for a program that is not steps. */
+    readonly steps: {
+        readonly count: number;
+        readonly outline: readonly OutlineLine[];
+    } | undefined;
+    /** How many problems it has here: the errors its check finds. */
+    readonly problems: number;
+    /** The first, in plain words; `undefined` when it has none. */
+    readonly problem: string | undefined;
+    /** What it gives, in words — "Up to 10 shipped orders"; `undefined` while it has problems. */
+    readonly gives: string | undefined;
+}
+/**
+ * What a saved query, or a recent run, is against a root: its steps parsed
+ * and checked once (`Query Editor Spec.md` §4.10, §5).
+ *
+ * @param saved - The saved query, or the run
+ * @param root - The root the surface's data sources make
+ * @param words - The words
+ * @returns What it is here
+ */
+export declare function queryAbout(saved: SavedQuery, root: QueryRoot, words: QueryWords): QueryAbout;
+/**
+ * When a query was saved, or a run ran, in a card's words — "14:02" today,
+ * "Tue" within the last six days, "Sep 12" this year, else "Sep 12, 2025" —
+ * in the viewer's locale and time zone.
+ *
+ * @param at - When
+ * @param now - The moment it is read at
+ * @param formatters - The locale's formatters
+ * @returns The words
+ */
+export declare function whenWords(at: Date, now: Date, formatters: Formatters): string;
+//# sourceMappingURL=about.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"about.d.ts","sourceRoot":"","sources":["../../src/query/about.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAaH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAa,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EAA2C,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC5F,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAA2C,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AASxF,oDAAoD;AACpD,MAAM,WAAW,UAAU;IACvB;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,oHAAoH;IACpH,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,+EAA+E;IAC/E,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,gHAAgH;IAChH,QAAQ,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,CAAA;KAAE,GAAG,SAAS,CAAC;IACjG,iEAAiE;IACjE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,+DAA+D;IAC/D,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,8FAA8F;IAC9F,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;CACtC;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,GAAG,UAAU,CA+B5F;AAED;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,UAAU,EAAE,UAAU,GAAG,MAAM,CAI7E"}

package/dist/query/autocomplete.d.ts

@@ -0,0 +1,112 @@
+import { SlotItem } from './model/slots.js';
+/** A box as the viewport measures it — what `getBoundingClientRect` gives. */
+export interface PlacementBox {
+    /** Its left edge. */
+    readonly left: number;
+    /** Its top edge. */
+    readonly top: number;
+    /** Its width. */
+    readonly width: number;
+    /** Its height. */
+    readonly height: number;
+}
+/** What {@link placeAutocomplete} places the popover by. */
+export interface AutocompletePlacementInput {
+    /** The slot's box, as the viewport measures it. */
+    readonly anchor: PlacementBox;
+    /** The builder's box, as the viewport measures it. */
+    readonly bounds: PlacementBox;
+    /** The popover's width, in the builder's own pixels (its `offsetWidth`). */
+    readonly width: number;
+    /** How much the builder is CSS-scaled: its measured width over its own (`offsetWidth`); 1 when it is not. */
+    readonly scale: number;
+}
+/** The popover below its slot, in the builder's own pixels. */
+export interface AutocompleteBelow {
+    /** The side of its slot it opens on. */
+    readonly side: "below";
+    /** Its left edge, from the builder's. */
+    readonly left: number;
+    /** Its top edge, from the builder's. */
+    readonly top: number;
+    /** Its greatest height, to end inside the builder. */
+    readonly maxHeight: number;
+}
+/** The popover above its slot, in the builder's own pixels: its bottom edge is held, so it grows upward. */
+export interface AutocompleteAbove {
+    /** The side of its slot it opens on. */
+    readonly side: "above";
+    /** Its left edge, from the builder's. */
+    readonly left: number;
+    /** Its bottom edge, from the builder's bottom edge. */
+    readonly bottom: number;
+    /** Its greatest height, to start inside the builder. */
+    readonly maxHeight: number;
+}
+/** Where the popover goes, in the builder's own pixels. */
+export type AutocompletePlacement = AutocompleteBelow | AutocompleteAbove;
+/**
+ * Where the slot autocomplete goes (`Query Editor Spec.md` §4.5): left-aligned
+ * with its slot and clamped 8px inside the builder; 4px below the slot, or 4px
+ * above it when under 280px remain below and more is above. A CSS-scaled
+ * builder measures scaled, so every measure is divided by its scale into the
+ * builder's own pixels, the ones its absolutely positioned popover is laid
+ * out in.
+ *
+ * @param input - the slot's and the builder's boxes as measured, the popover's width and the builder's scale
+ * @returns the side it opens on, its left edge and its top edge (below) or bottom edge (above), and its greatest height
+ */
+export declare function placeAutocomplete({ anchor, bounds, width, scale }: AutocompletePlacementInput): AutocompletePlacement;
+/** Props of {@link SlotAutocomplete}. */
+export interface SlotAutocompleteProps {
+    /** The slot's element: the popover hangs from it, and a press on it is the host's (it toggles the slot), not a press outside. */
+    anchor: HTMLElement;
+    /**
+     * The builder's element: the popover is portaled into it and stays inside
+     * it, absolutely positioned in its coordinates — so it is the popover's
+     * containing block (positioned, or transformed).
+     */
+    bounds: HTMLElement;
+    /** Its label — `FIELD` (#934's `slotLabel`). */
+    label: string;
+    /** The filter's placeholder (#934's `slotPlaceholder`). */
+    placeholder: string;
+    /** The footer's hint: where the offers come from (#934's `slotHint`). */
+    hint: string;
+    /** What it says with nothing to offer (#934's `slotEmpty`). */
+    empty: string;
+    /** The keys' hint, `↑↓ ⏎ esc` (#934's `slotKeys`). */
+    keys: string;
+    /**
+     * The offers for the text typed — #934's `slotItems`, which the host
+     * recomputes on each change of text. A new list for the same text (a
+     * summary arrived) keeps the active offer, found by its group and label,
+     * while it is still offered.
+     */
+    items: readonly SlotItem[];
+    /** The text typed; a text the host sets, other than the one typed, replaces it. */
+    text: string;
+    /** Told each change of the text. */
+    onText: (text: string) => void;
+    /**
+     * The offer active when it opens — #934's `activeItem`; `-1` when none can
+     * be picked. Typing makes the first offer that can be picked active.
+     */
+    initialActive: number;
+    /** Told the offer picked: ⏎, Tab or a click. */
+    onPick: (item: SlotItem) => void;
+    /** Told it closes: Esc, or a press outside it and its anchor. */
+    onClose: () => void;
+}
+/**
+ * The slot autocomplete — see the module docs. It opens with `initialActive`
+ * active and its filter focused (without scrolling); the active offer stays in
+ * view. While it is open it follows its slot as the page scrolls or resizes,
+ * and when it closes with the focus in it, the focus returns to its slot.
+ * Callbacks reach the host through `queueMicrotask`.
+ *
+ * @param props - its slot and builder, its words, the offers, the text typed, and the callbacks ({@link SlotAutocompleteProps})
+ * @returns the popover, portaled into the builder
+ */
+export declare const SlotAutocomplete: import('react').NamedExoticComponent<SlotAutocompleteProps>;
+//# sourceMappingURL=autocomplete.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"autocomplete.d.ts","sourceRoot":"","sources":["../../src/query/autocomplete.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAmCH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAiBjD,8EAA8E;AAC9E,MAAM,WAAW,YAAY;IACzB,qBAAqB;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,oBAAoB;IACpB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,iBAAiB;IACjB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,kBAAkB;IAClB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CAC3B;AAED,4DAA4D;AAC5D,MAAM,WAAW,0BAA0B;IACvC,mDAAmD;IACnD,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,sDAAsD;IACtD,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,4EAA4E;IAC5E,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,6GAA6G;IAC7G,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CAC1B;AAED,+DAA+D;AAC/D,MAAM,WAAW,iBAAiB;IAC9B,wCAAwC;IACxC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,yCAAyC;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,wCAAwC;IACxC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,sDAAsD;IACtD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC9B;AAED,4GAA4G;AAC5G,MAAM,WAAW,iBAAiB;IAC9B,wCAAwC;IACxC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,yCAAyC;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,uDAAuD;IACvD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,wDAAwD;IACxD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC9B;AAED,2DAA2D;AAC3D,MAAM,MAAM,qBAAqB,GAAG,iBAAiB,GAAG,iBAAiB,CAAC;AAE1E;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,0BAA0B,GAAG,qBAAqB,CAYrH;AAmKD,yCAAyC;AACzC,MAAM,WAAW,qBAAqB;IAClC,iIAAiI;IACjI,MAAM,EAAE,WAAW,CAAC;IACpB;;;;OAIG;IACH,MAAM,EAAE,WAAW,CAAC;IACpB,gDAAgD;IAChD,KAAK,EAAE,MAAM,CAAC;IACd,2DAA2D;IAC3D,WAAW,EAAE,MAAM,CAAC;IACpB,yEAAyE;IACzE,IAAI,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,KAAK,EAAE,MAAM,CAAC;IACd,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;IACb;;;;;OAKG;IACH,KAAK,EAAE,SAAS,QAAQ,EAAE,CAAC;IAC3B,mFAAmF;IACnF,IAAI,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B;;;OAGG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB,gDAAgD;IAChD,MAAM,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,IAAI,CAAC;IACjC,iEAAiE;IACjE,OAAO,EAAE,MAAM,IAAI,CAAC;CACvB;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,gBAAgB,6DAgN3B,CAAC"}

package/dist/query/builder.d.ts

@@ -0,0 +1,29 @@
+import { ValueTypeOf } from '@elaraai/east';
+import { QueryBuilderComponent } from '@elaraai/e3-ui/internal';
+/** The renderer's payload, decoded. */
+type QueryBuilderValue = ValueTypeOf<typeof QueryBuilderComponent.schema>;
+/** A tab of the pane. */
+export type QueryTab = "query" | "datasets" | "library";
+/** Where an issue the history item goes to is: its step, and its slot. */
+export interface QueryFocus {
+    /** The step's id, or `$query` for the query as a whole. */
+    readonly entry: string;
+    /** The slot, when the issue is on one. */
+    readonly slot: string | undefined;
+}
+/** Props of {@link EastChakraQueryBuilder}. */
+export interface EastChakraQueryBuilderProps {
+    /** The payload, decoded. */
+    value: QueryBuilderValue;
+    /** The structural storage key. */
+    storageKey: string;
+}
+/**
+ * Renders the query builder — see the module docs.
+ *
+ * @param props - The payload and its storage key
+ * @returns The builder
+ */
+export declare const EastChakraQueryBuilder: import('react').NamedExoticComponent<EastChakraQueryBuilderProps>;
+export {};
+//# sourceMappingURL=builder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../src/query/builder.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAmDH,OAAO,EAA+D,KAAK,WAAW,EAAe,MAAM,eAAe,CAAC;AAC3H,OAAO,EAAE,qBAAqB,EAAsC,MAAM,yBAAyB,CAAC;AAgCpG,uCAAuC;AACvC,KAAK,iBAAiB,GAAG,WAAW,CAAC,OAAO,qBAAqB,CAAC,MAAM,CAAC,CAAC;AAS1E,yBAAyB;AACzB,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,UAAU,GAAG,SAAS,CAAC;AAExD,0EAA0E;AAC1E,MAAM,WAAW,UAAU;IACvB,2DAA2D;IAC3D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,0CAA0C;IAC1C,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;CACrC;AAED,+CAA+C;AAC/C,MAAM,WAAW,2BAA2B;IACxC,4BAA4B;IAC5B,KAAK,EAAE,iBAAiB,CAAC;IACzB,kCAAkC;IAClC,UAAU,EAAE,MAAM,CAAC;CACtB;AAuBD;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,mEAoCiE,CAAC"}

package/dist/query/calls.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * A query's calls without the builder (#941) — `@elaraai/e3-ui-components/query`:
+ * the root a query reads, its one-shot call and the reading of its answer
+ * (`one-shot.ts`), a run's plan and its split call (`plan.ts`), and each call
+ * answered in memory where there is no server (`in-memory-call.ts`).
+ *
+ * It imports neither React nor the renderers — only East and e3's wire types —
+ * so a host in Node, where the package's main entry cannot load (its renderers
+ * need a DOM), plans and makes a query's calls exactly as the builder does: a
+ * CLI, an agent, or a test against an e3 server. The main entry exports the
+ * same names.
+ *
+ * @example
+ * ```ts
+ * import { planQuery, prepareQuery, queryResultOf, queryRoot } from "@elaraai/e3-ui-components/query";
+ * import { oneShotExecute, splitCall } from "@elaraai/e3-api-client";
+ *
+ * const root = queryRoot([{ name: "orders", path: ordersPath, type: toEastTypeValue(OrdersType) }]);
+ * const planned = planQuery(".orders | map(.total) | add", root, new Map([["orders", { bytes, rows }]]));
+ * if ("result" in planned) return planned.result;               // the checker's problems
+ * const plan = planned.plan;
+ * switch (plan.kind) {
+ *     case "split":
+ *         return queryResultOf(plan.reading, (await splitCall(url, repo, workspace, plan.request, { token })).result);
+ *     case "rekey": {
+ *         // A re-keyed join (#942): the re-key call, then the join call over its output, by its hash.
+ *         const first = await splitCall(url, repo, workspace, plan.first, { token });
+ *         const join = first.output === null ? undefined : (await splitCall(url, repo, workspace, plan.join(first.output), { token })).result;
+ *         return queryResultOf(plan.reading, plan.answer(first.result, join));
+ *     }
+ *     case "one_shot":
+ *         return queryResultOf(plan.prepared, await oneShotExecute(url, repo, workspace, plan.prepared.request, { token }));
+ * }
+ * ```
+ *
+ * @packageDocumentation
+ */
+export { prepareQuery, programChecks, queryResultOf, queryRoot, type CheckedProgram, type PreparedQuery, type QueryOptions, type QueryReading, type QueryResult, type QueryRoot, type QueryRootEntry, } from './one-shot.js';
+export { draftPlan, weighPlan, planQuery, splitCallRequest, rekeyCallRequests, type OneCallWhy, type PlanDraft, type PlanExplanation, type PlanOptions, type PlanPath, type PlanPrograms, type QueryPlan, type RekeyCalls, type SourceWeight, } from './plan.js';
+export { createInMemoryQueryCall, createInMemorySplitCall, createInMemorySourceStatus, type InMemoryDataset, type InMemorySplitCall, type InMemorySplitCallOptions, } from './in-memory-call.js';
+export type { QueryCall, QuerySplitCall, QuerySplitCallOptions, QuerySplitExplain, QuerySourceStatus, SourceStatus } from './hooks.js';
+//# sourceMappingURL=calls.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"calls.d.ts","sourceRoot":"","sources":["../../src/query/calls.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,OAAO,EACH,YAAY,EACZ,aAAa,EACb,aAAa,EACb,SAAS,EACT,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,cAAc,GACtB,MAAM,eAAe,CAAC;AACvB,OAAO,EACH,SAAS,EACT,SAAS,EACT,SAAS,EACT,gBAAgB,EAChB,iBAAiB,EACjB,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,QAAQ,EACb,KAAK,YAAY,EACjB,KAAK,SAAS,EACd,KAAK,UAAU,EACf,KAAK,YAAY,GACpB,MAAM,WAAW,CAAC;AACnB,OAAO,EACH,uBAAuB,EACvB,uBAAuB,EACvB,0BAA0B,EAC1B,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,wBAAwB,GAChC,MAAM,qBAAqB,CAAC;AAE7B,YAAY,EAAE,SAAS,EAAE,cAAc,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/dist/query/datasets-tab.d.ts

@@ -0,0 +1,52 @@
+import { EastType } from '@elaraai/east';
+import { QueryWords } from './model/words.js';
+import { QueryRoot } from './one-shot.js';
+/** A kind of data source: the Datasets tab's group. */
+export type SourceKind = "rows" | "lookups" | "values" | "models";
+/** How the open query reads a data source: as its source, or looked up. */
+export type SourceRole = "source" | "lookedUp";
+/**
+ * What a data source is, by its type: its group and its icon.
+ *
+ * @param type - its type
+ * @returns the group and the icon
+ */
+export declare function sourceKind(type: EastType): {
+    kind: SourceKind;
+    icon: string;
+};
+/**
+ * A data source's size in words: a list's or a lookup table's count, once its
+ * status gives one; a tree, a record, a calculation's inputs and result, or a
+ * value's kind otherwise.
+ *
+ * @param name - its name, which names its items
+ * @param type - its type
+ * @param rows - how many elements its status counts, if it does
+ * @param words - the words
+ * @returns the size, or `""` for a list or a lookup table not counted yet
+ */
+export declare function sourceSize(name: string, type: EastType, rows: number | undefined, words: QueryWords): string;
+/** Props of {@link DatasetsTab}. */
+export interface DatasetsTabProps {
+    /** The data sources, as the root holds them. */
+    readonly root: QueryRoot;
+    /** How the open query reads each data source it reads, by name. */
+    readonly reads: ReadonlyMap<string, SourceRole>;
+    /** Starts a new query on a data source. */
+    readonly onStart: (name: string) => void;
+    /** The tab's library's id. */
+    readonly id: string;
+    /** The words. */
+    readonly words: QueryWords;
+    /** Where the library keeps its state. */
+    readonly storageKey: string;
+}
+/**
+ * Renders the Datasets tab — see the module docs.
+ *
+ * @param props - The data sources, how the open query reads them, and what a click does ({@link DatasetsTabProps})
+ * @returns The tab's library
+ */
+export declare const DatasetsTab: import('react').NamedExoticComponent<DatasetsTabProps>;
+//# sourceMappingURL=datasets-tab.d.ts.map

package/dist/query/datasets-tab.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"datasets-tab.d.ts","sourceRoot":"","sources":["../../src/query/datasets-tab.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAwBH,OAAO,EAAc,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAC;AAI1D,OAAO,EAA4B,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC7E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAI/C,uDAAuD;AACvD,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAKlE,2EAA2E;AAC3E,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,UAAU,CAAC;AAQ/C;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,QAAQ,GAAG;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAU7E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,UAAU,GAAG,MAAM,CAyB5G;AAED,oCAAoC;AACpC,MAAM,WAAW,gBAAgB;IAC7B,gDAAgD;IAChD,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,mEAAmE;IACnE,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAChD,2CAA2C;IAC3C,QAAQ,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,iBAAiB;IACjB,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,yCAAyC;IACzC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC/B;AAKD;;;;;GAKG;AACH,eAAO,MAAM,WAAW,wDAKtB,CAAC"}

package/dist/query/downloads.d.ts

@@ -0,0 +1,29 @@
+import { QueryWords } from './model/words.js';
+import { DownloadFormat } from './results.js';
+import { RunOutput, RunState } from './run.js';
+/**
+ * A result's rows as CSV: one row per output, its header the fields' names.
+ *
+ * @param output - the run's result
+ * @param words - the words, for a nested value
+ * @returns the CSV's bytes, UTF-8
+ */
+export declare function resultCsv(output: RunOutput, words: QueryWords): Uint8Array;
+/**
+ * A result with its type, self-describing beast2: what the run returned.
+ *
+ * @param output - the run's result
+ * @returns the bytes
+ */
+export declare function resultBeast2(output: RunOutput): Uint8Array;
+/**
+ * Downloads a run's result, and says so.
+ *
+ * @param run - the run, answered with a result
+ * @param format - CSV or BEAST2
+ * @param name - the query's name: the file's
+ * @param words - the words
+ * @returns the note the results show after it; `undefined` when the run has no result
+ */
+export declare function downloadResult(run: RunState, format: DownloadFormat, name: string, words: QueryWords): string | undefined;
+//# sourceMappingURL=downloads.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"downloads.d.ts","sourceRoot":"","sources":["../../src/query/downloads.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAoBH,OAAO,EAAc,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EAAkB,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnE,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAiBpD;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,GAAG,UAAU,CAkB1E;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,GAAG,UAAU,CAE1D;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS,CAWzH"}

package/dist/query/drops.d.ts

@@ -0,0 +1,28 @@
+import { ReactElement, ReactNode } from 'react';
+import { QueryWords } from './model/words.js';
+/** Props of {@link QueryDropTarget}. */
+export interface QueryDropTargetProps {
+    /** The builder's id (`queryKeys(id)`'s), naming its drop target. */
+    readonly id: string | undefined;
+    /** Why a query of a name can't open here, in the builder's words; undefined when it can. */
+    readonly refusal: (name: string) => string | undefined;
+    /** How many steps the query of a name has, for the target's words; undefined when unknown. */
+    readonly steps: (name: string) => number | undefined;
+    /** Opens the query of a name — what dropping it does. */
+    readonly onOpen: (name: string) => void;
+    /** The words. */
+    readonly words: QueryWords;
+    /** The builder's frame: the toolbar, the pane, the results and the status line. */
+    readonly children: ReactNode;
+}
+/**
+ * The builder's frame as a drop target for the query library's cards — see
+ * the module docs. The builder wraps its frame in it: with a drag layer on the
+ * page the frame sits in the target's zone, which takes the frame's place;
+ * without one, the frame renders alone.
+ *
+ * @param props - The builder's id, the refusal and the steps of a query by name, what a drop does, the words and the frame ({@link QueryDropTargetProps})
+ * @returns The frame, in its drop zone when a drag layer is on the page
+ */
+export declare function QueryDropTarget({ id, refusal, steps, onOpen, words, children }: QueryDropTargetProps): ReactElement;
+//# sourceMappingURL=drops.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"drops.d.ts","sourceRoot":"","sources":["../../src/query/drops.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAA6C,KAAK,YAAY,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAOrG,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAiBnD,wCAAwC;AACxC,MAAM,WAAW,oBAAoB;IACjC,oEAAoE;IACpE,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,4FAA4F;IAC5F,QAAQ,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IACvD,8FAA8F;IAC9F,QAAQ,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IACrD,yDAAyD;IACzD,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,iBAAiB;IACjB,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,mFAAmF;IACnF,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;CAChC;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,oBAAoB,GAAG,YAAY,CA4DnH"}