@elaraai/e3-ui-components 1.0.79 → 1.0.81

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

@@ -2,6 +2,7 @@ import { EastTypeValue } from '@elaraai/east';
 import { PlatformFunction } from '@elaraai/east/internal';
 import { DatasetPage, DatasetFindQuery, DatasetFindResult } from '@elaraai/e3-api-client';
 import { TreePath } from '@elaraai/e3-types';
+import { ReactiveDatasetCacheInterface } from './dataset-store.js';
 import { TrackedChannelStore } from './tracked-channel.js';
 /** One element window of a paged source. */
 export interface PagedWindow {
@@ -9,33 +10,77 @@ export interface PagedWindow {
     offset: number;
     /** Maximum elements to return (the server may clamp it). */
     limit: number;
+    /** Read through one of a record's secondary indexes instead of the record
+     *  itself — the window is then the INDEX's row space, in its own order. */
+    index?: string;
+    /** With {@link index}: read each entry's row from the record too. */
+    join?: boolean;
+    /** The content hash the window is pinned to. The server answers from that
+     *  content or refuses, naming the content the dataset holds now; it never
+     *  answers from other content. */
+    hash?: string;
+}
+/** Which rows a bind serves: the dataset's own, or one of a record's indexes.
+ *  Every channel key, every fetch and the handle cache carry it, because two
+ *  binds that differ here serve different row spaces from one path. */
+export interface PagedSelector {
+    /** The index's name, or `null` for the dataset itself. */
+    index: string | null;
+    /** Whether an index read joins each entry to its row. */
+    join: boolean;
 }
 /**
- * Adapter for the dataset paging endpoint. The default wraps
- * `@elaraai/e3-api-client`'s `datasetGetPage`.
+ * Adapter for the dataset paging endpoints. The default wraps
+ * `@elaraai/e3-api-client`'s `datasetGetPage`, `datasetFindKey` and
+ * `datasetGetStatus`, and follows datasets through the dataset store.
  */
 export interface PagedApi {
-    /** Fetch one element window of a collection dataset. */
+    /** Fetch one element window of a collection dataset — or of one of a
+     *  record's indexes, when the window names one. */
     getPage(workspace: string, path: TreePath, window: PagedWindow): Promise<DatasetPage>;
     /** Locate a key query in a Set/Dict dataset's canonical key order. The
      *  `row` it answers with indexes the SAME row space {@link getPage}'s
      *  element windows serve, which is what makes a hit addressable. */
     findKey(workspace: string, path: TreePath, query: DatasetFindQuery): Promise<DatasetFindResult>;
+    /**
+     * The dataset's current content hash, or `null` while it has no value. For
+     * a record it is the record's state hash, which reads through its indexes
+     * are pinned to as well.
+     */
+    getRevision(workspace: string, path: TreePath): Promise<string | null>;
+    /**
+     * Follow a dataset's content hash.
+     *
+     * @param workspace - The workspace
+     * @param path - The dataset's path
+     * @param onChange - Hears each hash the dataset moves to, the first report
+     *   included; `null` while it has no value
+     * @returns A function that stops following
+     */
+    watchRevision(workspace: string, path: TreePath, onChange: (hash: string | null) => void): () => void;
 }
 /**
  * Build the default {@link PagedApi} that talks to a real e3 server via
  * `@elaraai/e3-api-client`.
  *
  * @remarks
- * Windows are requested unpinned (no content hash). `useDatasetPage` pins its
- * requests so browser/edge caches can hold pages immutably; a bound paged
- * source has no hash to pin with — it never fetches the whole value or polls
- * status — so it reads the current content instead.
+ * A dataset is followed through the dataset store's workspace-status poll,
+ * which reports every dataset's hash: a followed dataset joins that poll, adds
+ * no request of its own, and never has its content fetched.
+ *
+ * @param apiUrl - Base URL of the e3 API server
+ * @param repo - Repository name
+ * @param getToken - Reads the current token, so a rotated one is used at once
+ * @param datasets - The dataset store whose status poll reports the hashes
+ * @returns The adapter
  */
-export declare function createDefaultPagedApi(apiUrl: string, repo: string, getToken: () => string | null): PagedApi;
-/** One tracked channel per window (and one per source, for the total). */
+export declare function createDefaultPagedApi(apiUrl: string, repo: string, getToken: () => string | null, datasets: Pick<ReactiveDatasetCacheInterface, "watchHash">): PagedApi;
+/** One tracked channel per window, per total and per search. */
 interface PageEntry {
     status: "idle" | "running" | "loaded" | "failed";
+    /** The fetch the channel waits on; a settling fetch that is no longer it
+     *  is discarded. Unique across the runtime, so a channel dropped by a move
+     *  and made again never mistakes an old fetch for its own. */
     launchSeq: number;
     /** The decoded window — a value of the dataset's own type. */
     window?: unknown;
@@ -43,29 +88,35 @@ interface PageEntry {
     total?: number;
     /** Where a key query landed — the answer on a seek channel. */
     range?: DatasetFindResult;
+    /** Why the last attempt failed — what a read of the channel throws. */
+    error?: string;
     /** When the last attempt failed, so a retry can be rate-limited. */
     failedAtMs?: number;
-    /** The failure is an authoring error, so retrying can never help. */
+    /** No retry can help while the source holds the same content. */
     permanent?: boolean;
 }
 /** The Dict key / Set element type of a keyed collection, else null — the
  *  `seek` capability is decided from the dataset's own type at bind time. */
 export declare function keyTypeOf(sourceType: EastTypeValue): EastTypeValue | null;
-/** Tracked-channel key for one window. */
-export declare function pagedWindowKey(workspace: string, path: TreePath, offset: number, limit: number): string;
-/** Tracked-channel key for a source's element total. */
-export declare function pagedTotalKey(workspace: string, path: TreePath): string;
-/** Tracked-channel key for ONE key query against a source. Every distinct
- *  query gets its own channel: a search result is as immutable as a window. */
-export declare function pagedSeekKey(workspace: string, path: TreePath, query: DatasetFindQuery): string;
+/** Tracked-channel key for a dataset's revision. Every read of the dataset
+ *  tracks it, so every read re-fires when the source moves. */
+export declare function pagedRevisionKey(workspace: string, path: TreePath): string;
+/** Tracked-channel key for one window of one revision. */
+export declare function pagedWindowKey(workspace: string, path: TreePath, revision: string, offset: number, limit: number, selector?: PagedSelector): string;
+/** Tracked-channel key for one revision's element total. */
+export declare function pagedTotalKey(workspace: string, path: TreePath, revision: string, selector?: PagedSelector): string;
+/** Tracked-channel key for ONE key query against one revision. Every distinct
+ *  query gets its own channel: a search result is as fixed as a window. */
+export declare function pagedSeekKey(workspace: string, path: TreePath, revision: string, query: DatasetFindQuery, selector?: PagedSelector): string;
 /**
  * The decoded East {@link SeekQueryType} value as e3's wire query.
  *
- * The two are deliberately the same three shapes, so this is a re-tagging
- * rather than a translation: `.east` literals stay text, and the East option on
- * the `fields` arm becomes an absent property (`exactOptionalPropertyTypes`).
+ * The two are deliberately the same shapes, so this is a re-tagging rather
+ * than a translation: `.east` literals stay text, and the East option on the
+ * `fields` arm, like an open end of a `range`, becomes an absent property
+ * (`exactOptionalPropertyTypes`).
  */
-export declare function toFindQuery(query: unknown): DatasetFindQuery;
+export declare function toFindQuery(query: unknown, selector?: PagedSelector): DatasetFindQuery;
 /**
  * Encapsulates all `Data.bindPaged` runtime state. The module-level
  * {@link defaultPagedRuntime} instance backs the registered platform; tests
@@ -78,32 +129,95 @@ export declare class PagedRuntime extends TrackedChannelStore<PageEntry> {
     /** Loaded window keys in least-recently-READ order (a Map preserves
      *  insertion order; a read re-inserts). Bounds the decoded-window cache. */
     private readonly loadedWindows;
+    /** Each dataset's snapshot, by workspace and path. */
+    private readonly snapshots;
+    /** Fetches launched so far — the source of every channel's `launchSeq`. */
+    private launches;
     /** Monotonic clock seam so tests can drive the retry gate. */
     protected now(): number;
     protected createEntry(): PageEntry;
     /** Install the API adapter + workspace — called by the React provider
-     *  (or a test/showcase harness) before any handle is used. */
+     *  (or a test/showcase harness) before any handle is used. Another adapter
+     *  or workspace starts from nothing: no snapshot of the old one's carries
+     *  over. */
     initialize(api: PagedApi, workspace: string): void;
-    /** Tear down the adapter and all window state. */
-    clear(): void;
+    /**
+     * Tear down the adapter and all window state.
+     *
+     * @param api - Clear only while this is the installed adapter, so a
+     *   provider tearing down after another installed its own leaves that one
+     *   in place
+     */
+    clear(api?: PagedApi): void;
+    /** Stop following every dataset, and drop what every snapshot delivered. */
+    private reset;
     private resolveWorkspace;
-    /** Note a window as most-recently-read, and drop the coldest decoded
-     *  windows once the cache exceeds its cap. An evicted window returns to
-     *  `idle`, so the next read refetches it rather than reading a hole. */
-    private touchWindow;
+    /** A dataset's snapshot, followed from its first read until the runtime
+     *  is cleared. */
+    private snapshotOf;
+    /** Whether a snapshot is still the runtime's, rather than one a clear or a
+     *  re-initialization dropped. */
+    private isLive;
+    /** Whether a live snapshot is still pinned to `revision`. */
+    private pinnedTo;
     /**
-     * Start the fetch for a window if it isn't loaded or already in flight.
+     * The revision a read of `path` is pinned to — a hash, `null` while the
+     * dataset has no value, or `undefined` while it is being found — tracked so
+     * the read re-fires when the source moves.
      *
-     * Deliberately does NOT notify on launch — the read that triggers it runs
-     * inside a render pass, and notifying there would re-enter the renderer.
-     * Only the settle notifies.
+     * @throws The failed lookup's reason, until a read after the retry gap
+     *   looks again
      */
-    private ensureWindow;
+    private revisionFor;
     /**
-     * Start the fence search for one key query if it isn't answered or already
-     * in flight — the seek sibling of {@link ensureWindow}, with the same
-     * launch-does-not-notify rule (the read runs inside a render pass).
+     * Ask the server which content the dataset holds, and move there — unless
+     * a move lands first, which came from something no older than the answer.
      */
+    private find;
+    /**
+     * Move a dataset's source to `revision`: drop what the old snapshot
+     * delivered and re-fire every read of the dataset, so the windows and
+     * searches still in use are fetched again, pinned to the new one. A move to
+     * the revision the source already has changes nothing.
+     */
+    private moveTo;
+    /**
+     * Handle what a pinned fetch threw when it is not the read's failure: a
+     * refusal naming other content moves the source there, and "no value"
+     * moves it to no snapshot. Returns whether the error was one of those, or
+     * arrived after the source had already moved on.
+     */
+    private followed;
+    /** A channel of the snapshot's current revision, dropped when it moves. */
+    private channel;
+    /** Whether a channel is due a fetch: never fetched, evicted, or failed
+     *  for a reason a retry can fix, longer ago than the retry gap. */
+    private due;
+    /**
+     * Mark a channel's fetch as started, returning the fetch's sequence number.
+     *
+     * Deliberately does NOT notify — the read that triggers it runs inside a
+     * render pass, and notifying there would re-enter the renderer. Only the
+     * settle notifies.
+     */
+    private launch;
+    /** Apply a fetch's outcome if the channel still waits on it, re-firing the
+     *  channel's reads. Returns whether it applied. */
+    private settle;
+    /** Settle a fetch as failed, with the reason a read will throw. */
+    private fail;
+    /** What a read of a channel answers: its value once loaded, `none` while
+     *  in flight, or its failure, thrown. */
+    private answer;
+    /** Note a window as most-recently-read, and drop the coldest decoded
+     *  windows once the cache exceeds its cap. An evicted window returns to
+     *  `idle`, so the next read refetches it rather than reading a hole. */
+    private touchWindow;
+    /** Start the pinned fetch for a window if it is due one, returning its
+     *  channel. */
+    private ensureWindow;
+    /** Start the pinned fence search for one key query if it is due one,
+     *  returning its channel — the seek sibling of {@link ensureWindow}. */
     private ensureSeek;
     /**
      * The low-level primitives backing handle methods, bound to THIS runtime.
@@ -113,29 +227,49 @@ export declare class PagedRuntime extends TrackedChannelStore<PageEntry> {
      */
     buildPrimitives(): PlatformFunction[];
     /**
-     * Build the handle value for one `Data.bindPaged` evaluation. Both methods
-     * are thin IR-bearing `East.function`s over {@link buildPrimitives},
-     * capturing only the plain-data source path (the value type rides as a
-     * type-arg) — so the handle is ordinary serializable East data (issue #106).
+     * Build the handle value for one paged bind. Every method is a thin
+     * IR-bearing `East.function` over {@link buildPrimitives}, capturing only
+     * the plain-data source path and selector (the value type rides as a
+     * type-arg) — so the handle is ordinary serializable East data (issue
+     * #106).
+     *
+     * @param sourceType - The dataset's type, or an index's window type
+     * @param path - The dataset's path
+     * @param selector - The rows the bind serves
+     * @param shape - `released`: the handle `data_bind_paged` returns, without
+     *   `revision` or `refresh`; `pinned`: the handle `data_bind_paged_pinned`
+     *   returns. Both read through the same snapshot.
+     * @returns The handle
      */
-    buildHandle(sourceType: EastTypeValue, path: TreePath): Record<string, unknown>;
-    /** Build a `Data.bindPaged` PlatformFunction bound to this runtime. Pass
-     *  `allowed=null` for an unscoped impl; pass a Set of path strings for
-     *  manifest scoping. */
+    buildHandle(sourceType: EastTypeValue, path: TreePath, selector: PagedSelector, shape: "released" | "pinned"): Record<string, unknown>;
+    /** Build the PlatformFunction behind `data_bind_paged` — the bind a UI
+     *  exported before pinned reads calls — bound to this runtime. Its handle
+     *  has no `revision` or `refresh`, but its reads are pinned, follow the
+     *  dataset and fail visibly all the same. Pass `allowed=null` for an
+     *  unscoped impl, or a Set of path strings for manifest scoping. */
     buildPlatform(allowed: ReadonlySet<string> | null): PlatformFunction;
+    /** Build the PlatformFunction behind `data_bind_paged_pinned` — what
+     *  `Data.bindPaged` emits, for a dataset's own rows or a record's index —
+     *  bound to this runtime and scoped by `allowed` exactly as
+     *  {@link buildPlatform} is: an index read is a read of the record's path. */
+    buildPinnedPlatform(allowed: ReadonlySet<string> | null): PlatformFunction;
 }
 /** Process-global runtime backing the `PagedPlatform` export. */
 export declare const defaultPagedRuntime: PagedRuntime;
 /** Install the paging API adapter + workspace — called by the React provider
  *  on mount (or by a test/showcase harness). */
 export declare function initializePagedApi(api: PagedApi, workspace: string): void;
-/** Tear down the paging API adapter and all window state. */
-export declare function clearPagedApi(): void;
-/** Global, manifest-unscoped `Data.bindPaged` impl + its backing primitives.
+/**
+ * Tear down the paging API adapter and all window state.
+ *
+ * @param api - Clear only while this is the installed adapter
+ */
+export declare function clearPagedApi(api?: PagedApi): void;
+/** Global, manifest-unscoped paged binds + their backing primitives.
  *  Registered on module load (powers the extension registry decode path). */
 export declare const PagedPlatform: PlatformFunction[];
-/** Build a manifest-scoped `Data.bindPaged` implementation + its backing
- *  primitives, from the manifest's `pages` list.
+/** Build manifest-scoped paged binds + their backing primitives, from the
+ *  manifest's `pages` list.
  *
  *  The `data_page*` primitives MUST ship with the scoped platform: e3 `ui()`
  *  tasks render through `createScoped*()` arrays (UITaskPreview), NOT the

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

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

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

@@ -75,8 +75,14 @@ export declare class RecordRuntime extends TrackedChannelStore<RecordEntry> {
     /** Install the API adapter + dataset cache + workspace — called by the
      *  React provider (or a test/showcase harness) before any handle is used. */
     initialize(api: RecordApi, cache: ReactiveDatasetCacheInterface, workspace: string): void;
-    /** Tear down the adapter and all record state. */
-    clear(): void;
+    /**
+     * Tear down the adapter and all record state.
+     *
+     * @param api - Clear only while this is the installed adapter, so a
+     *   provider tearing down after another installed its own leaves that one
+     *   in place
+     */
+    clear(api?: RecordApi): void;
     private resolveWorkspace;
     /** The deployed describe signature for a record (fetched once, evicted on failure). */
     private signature;
@@ -113,8 +119,12 @@ 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). */
 export declare function initializeRecordApi(api: RecordApi, cache: ReactiveDatasetCacheInterface, workspace: string): void;
-/** Tear down the record API adapter and all record state. */
-export declare function clearRecordApi(): void;
+/**
+ * Tear down the record API adapter and all record state.
+ *
+ * @param api - Clear only while this is the installed adapter
+ */
+export declare function clearRecordApi(api?: RecordApi): void;
 /** Global, manifest-unscoped `Record.bind` impl + its backing primitives.
  *  Registered on module load (powers the extension registry decode path). */
 export declare const RecordPlatform: PlatformFunction[];

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

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

@@ -47,8 +47,18 @@ export interface StagedStoreInterface {
     write(workspace: string, path: TreePath, snapshotIfNew: Uint8Array, buffered: Uint8Array): void;
     /** Drop the staged entry for a path. Returns true if there was one. */
     discard(workspace: string, path: TreePath): boolean;
-    /** All currently-staged keys (workspace+path combinations). */
+    /** All currently-staged keys (workspace+path combinations) in the scope. */
     listKeys(): string[];
+    /**
+     * Scope the store to a server and repository: every read and write goes to
+     * that scope's entries, and entries of any other scope are kept, unseen.
+     * With no scope set, the store has one scope of its own.
+     *
+     * @param scope - The server and repository, as one string
+     * @returns A function that unsets the scope while it is still this one, so
+     *   a provider tearing down after another set its own leaves that in place
+     */
+    setScope(scope: string): () => void;
     subscribe(key: string, callback: () => void): () => void;
     getKeyVersion(key: string): number;
     /** Register a listener for durable-persistence failures (save / remove /
@@ -85,6 +95,7 @@ export declare class MemoryStagedAdapter implements StagedPersistenceAdapter {
 }
 export declare class StagedStore implements StagedStoreInterface {
     private entries;
+    private scope;
     private subscribers;
     private versions;
     private adapter;
@@ -102,11 +113,17 @@ export declare class StagedStore implements StagedStoreInterface {
     write(workspace: string, path: TreePath, snapshotIfNew: Uint8Array, buffered: Uint8Array): void;
     discard(workspace: string, path: TreePath): boolean;
     listKeys(): string[];
+    setScope(scope: string): () => void;
     subscribe(key: string, callback: () => void): () => void;
     getKeyVersion(key: string): number;
     onPersistError(cb: (key: string, err: unknown) => void): () => void;
-    /** Test-only: clear in-memory + persisted state. */
+    /** Test-only: clear in-memory + persisted state, in every scope. */
     clear(): Promise<void>;
+    /** The key a path's entry is held under in the current scope. */
+    private keyOf;
+    /** Tells every path with an entry in either scope that what it reads has
+     *  changed: the scope's move shows one's entries and hides the other's. */
+    private notifyScopes;
     private notify;
     /**
      * Serialize a persistence op behind any prior op for the same key, so they

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elaraai/e3-ui-components",
-  "version": "1.0.79",
+  "version": "1.0.81",
   "description": "React Query hooks and preview components for the e3 API",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -36,12 +36,12 @@
     "@tanstack/react-query": "^5.62.0",
     "react": "^19.0.0",
     "react-dom": "^19.0.0",
-    "@elaraai/e3-api-client": "1.0.79",
-    "@elaraai/e3-types": "1.0.79",
-    "@elaraai/east": "1.0.79",
-    "@elaraai/east-ui": "1.0.79",
-    "@elaraai/e3-ui": "1.0.79",
-    "@elaraai/east-ui-components": "1.0.79"
+    "@elaraai/e3-api-client": "1.0.81",
+    "@elaraai/e3-types": "1.0.81",
+    "@elaraai/e3-ui": "1.0.81",
+    "@elaraai/east-ui": "1.0.81",
+    "@elaraai/east-ui-components": "1.0.81",
+    "@elaraai/east": "1.0.81"
   },
   "dependencies": {
     "@emotion/react": "^11.14.0",
@@ -87,12 +87,13 @@
     "vite": "^6.0.0",
     "vite-plugin-dts": "^4.3.0",
     "vitest": "^4.0.14",
-    "@elaraai/e3-api-client": "1.0.79",
-    "@elaraai/e3-types": "1.0.79",
-    "@elaraai/e3-ui": "1.0.79",
-    "@elaraai/east": "1.0.79",
-    "@elaraai/east-ui": "1.0.79",
-    "@elaraai/east-ui-components": "1.0.79"
+    "@elaraai/e3-api-client": "1.0.81",
+    "@elaraai/e3-ui": "1.0.81",
+    "@elaraai/e3-types": "1.0.81",
+    "@elaraai/east-ui": "1.0.81",
+    "@elaraai/east": "1.0.81",
+    "@elaraai/eslint-plugin-east": "1.0.81",
+    "@elaraai/east-ui-components": "1.0.81"
   },
   "repository": {
     "type": "git",
@@ -112,8 +113,8 @@
     "node": ">=22.0.0"
   },
   "scripts": {
-    "build": "vite build",
-    "typecheck": "tsc --noEmit",
+    "build": "pnpm run typecheck && vite build",
+    "typecheck": "tsc -p tsconfig.typecheck.json",
     "lint": "eslint .",
     "lint:fix": "eslint . --fix",
     "test": "node --import tsx --test test/*.spec.ts test/**/*.spec.ts && vitest run",