@elaraai/e3-ui-components 1.0.79 → 1.0.80

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

@@ -69,8 +69,13 @@ export declare class BindRuntime {
      *  leftover queued writes that captured the old cache. Same-cache
      *  re-init (Strict Mode double-invoke; HMR) preserves the queue. */
     initializeCache(cache: ReactiveDatasetCacheInterface): void;
-    /** Clear the active cache and drop any queued writes. */
-    clearCache(): void;
+    /**
+     * Clear the active cache and drop any queued writes.
+     *
+     * @param cache - Clear only while this is the active cache, so a provider
+     *   tearing down after another installed its own leaves that one in place
+     */
+    clearCache(cache?: ReactiveDatasetCacheInterface): void;
     /** Subscribe to write-queue errors. Returns an unsubscribe fn. */
     onWriteError(cb: (error: unknown) => void): () => void;
     /** Fan a write/persistence error out to every registered listener. */
@@ -136,9 +141,13 @@ export declare const defaultBindRuntime: BindRuntime;
 export declare function getReactiveDatasetCache(): ReactiveDatasetCacheInterface;
 /** Set the active cache singleton — called by the React provider on mount. */
 export declare function initializeReactiveDatasetCache(cache: ReactiveDatasetCacheInterface): void;
-/** Clear the active cache singleton — called on unmount or test teardown.
- *  Also drops any queued writes that captured the old cache. */
-export declare function clearReactiveDatasetCache(): void;
+/**
+ * Clear the active cache singleton — called on unmount or test teardown. Also
+ * drops any queued writes that captured the old cache.
+ *
+ * @param cache - Clear only while this is the active cache
+ */
+export declare function clearReactiveDatasetCache(cache?: ReactiveDatasetCacheInterface): void;
 export declare function enableBindingTracking(): Set<string>;
 export declare function disableBindingTracking(): string[];
 export declare function isBindingTracking(): boolean;

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

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

package/dist/platform/dataset-hooks.d.ts

@@ -14,9 +14,17 @@ export interface ReactiveDatasetProviderProps {
  *
  * @remarks
  * Reads server identity from the surrounding `<E3Provider>` to build a
- * default {@link DatasetApi} adapter, then constructs a workspace-scoped
- * cache. Configures the cache's scheduler to use `queueMicrotask` so
- * cache notifications never fire during a React render pass.
+ * default {@link DatasetApi} adapter and a workspace-scoped cache, and installs
+ * them — with the `Func.bind`, `Data.bindPaged` and `Record.bind` adapters — in
+ * the process-global runtimes the East-side bindings resolve through. The
+ * cache's scheduler uses `queueMicrotask`, so cache notifications never fire
+ * during a React render pass.
+ *
+ * The children render once the provider's cache is installed, so a
+ * `Data.bind`'s first read finds it; they render again from nothing when the
+ * server identity changes. A provider tears down only what it installed, so
+ * one replacing another — re-keyed to a new workspace — or StrictMode's
+ * mount → unmount → mount never leaves the runtimes empty.
  *
  * Must be mounted inside an `<E3Provider>` (which also owns the
  * `<QueryClientProvider>` wrap that this package's TanStack hooks
@@ -31,7 +39,7 @@ export interface ReactiveDatasetProviderProps {
  * </E3Provider>
  * ```
  */
-export declare function ReactiveDatasetProvider({ children, }: ReactiveDatasetProviderProps): import("react/jsx-runtime").JSX.Element;
+export declare function ReactiveDatasetProvider({ children, }: ReactiveDatasetProviderProps): import("react/jsx-runtime").JSX.Element | null;
 /**
  * Hook to access the ReactiveDatasetCache from context.
  *

package/dist/platform/dataset-hooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dataset-hooks.d.ts","sourceRoot":"","sources":["../../src/platform/dataset-hooks.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;GAIG;AAEH,OAAO,EASH,KAAK,SAAS,EACjB,MAAM,OAAO,CAAC;AACf,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAEH,KAAK,6BAA6B,EAGrC,MAAM,oBAAoB,CAAC;AA6B5B;;;;GAIG;AACH,MAAM,WAAW,4BAA4B;IACzC,QAAQ,EAAE,SAAS,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,uBAAuB,CAAC,EACpC,QAAQ,GACX,EAAE,4BAA4B,2CAwG9B;AAMD;;;;;GAKG;AACH,wBAAgB,uBAAuB,IAAI,6BAA6B,CAMvE;AAED;;;;GAIG;AACH,wBAAgB,+BAA+B,IAAI,6BAA6B,GAAG,IAAI,CAEtF;AAED;;;;GAIG;AACH,wBAAgB,mCAAmC,IAAI,MAAM,CAM5D;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS,CAc/F;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,QAAQ,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,6BAA6B;IAC1C,4BAA4B;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,iCAAiC;IACjC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,0BAA0B;IAC1B,MAAM,EAAE,MAAM,IAAI,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,wBAAwB,EAAE,GAAG,6BAA6B,CAkD9G;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACvC,0BAA0B;IAC1B,QAAQ,EAAE,wBAAwB,EAAE,CAAC;IACrC,qCAAqC;IACrC,QAAQ,EAAE,SAAS,CAAC;IACpB,uBAAuB;IACvB,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,4BAA4B;IAC5B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,IAAI,KAAK,SAAS,CAAC;CAC7D;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,qBAAqB,CAAC,EAClC,QAAQ,EACR,QAAQ,EACR,QAAe,EACf,OAAO,GACV,EAAE,0BAA0B,2CAuB5B;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,uBAAuB,IAAI,CACvC,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,QAAQ,EACd,KAAK,EAAE,UAAU,KAChB,OAAO,CAAC,IAAI,CAAC,CAOjB;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,OAAO,CAchF"}
+{"version":3,"file":"dataset-hooks.d.ts","sourceRoot":"","sources":["../../src/platform/dataset-hooks.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;GAIG;AAEH,OAAO,EASH,KAAK,SAAS,EACjB,MAAM,OAAO,CAAC;AACf,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAEH,KAAK,6BAA6B,EAGrC,MAAM,oBAAoB,CAAC;AA8B5B;;;;GAIG;AACH,MAAM,WAAW,4BAA4B;IACzC,QAAQ,EAAE,SAAS,CAAC;CACvB;AAUD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,uBAAuB,CAAC,EACpC,QAAQ,GACX,EAAE,4BAA4B,kDAoF9B;AAMD;;;;;GAKG;AACH,wBAAgB,uBAAuB,IAAI,6BAA6B,CAMvE;AAED;;;;GAIG;AACH,wBAAgB,+BAA+B,IAAI,6BAA6B,GAAG,IAAI,CAEtF;AAED;;;;GAIG;AACH,wBAAgB,mCAAmC,IAAI,MAAM,CAM5D;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS,CAc/F;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,QAAQ,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,6BAA6B;IAC1C,4BAA4B;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,iCAAiC;IACjC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,0BAA0B;IAC1B,MAAM,EAAE,MAAM,IAAI,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,wBAAwB,EAAE,GAAG,6BAA6B,CAkD9G;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACvC,0BAA0B;IAC1B,QAAQ,EAAE,wBAAwB,EAAE,CAAC;IACrC,qCAAqC;IACrC,QAAQ,EAAE,SAAS,CAAC;IACpB,uBAAuB;IACvB,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,4BAA4B;IAC5B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,IAAI,KAAK,SAAS,CAAC;CAC7D;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,qBAAqB,CAAC,EAClC,QAAQ,EACR,QAAQ,EACR,QAAe,EACf,OAAO,GACV,EAAE,0BAA0B,2CAuB5B;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,uBAAuB,IAAI,CACvC,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,QAAQ,EACd,KAAK,EAAE,UAAU,KAChB,OAAO,CAAC,IAAI,CAAC,CAOjB;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,OAAO,CAchF"}

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

@@ -99,22 +99,48 @@ export interface ReactiveDatasetCacheInterface {
     preload(workspace: string, path: TreePath): Promise<void>;
     /** List fields at a path */
     list(workspace: string, path: TreePath): Promise<string[]>;
-    /** Set polling interval for a dataset */
+    /**
+     * Poll a dataset, for one watcher. Each call is paired with one
+     * {@link clearRefetchInterval}: a path two views watch stays polled until
+     * both have cleared it.
+     */
     setRefetchInterval(workspace: string, path: TreePath, intervalMs: number): void;
     /**
-     * Stop polling a dataset previously registered with
-     * {@link setRefetchInterval}. The workspace's shared poller stops
-     * entirely once its last path is cleared — without this, a long-lived
-     * session accumulates watched paths (and network traffic) forever.
+     * Stop polling a dataset for one watcher registered with
+     * {@link setRefetchInterval}. The path stops being polled once its last
+     * watcher clears it, and the workspace's shared poller once its last path
+     * goes — without this, a long-lived session accumulates watched paths (and
+     * network traffic) forever.
      */
     clearRefetchInterval(workspace: string, path: TreePath): void;
+    /**
+     * Follow a dataset's content hash without fetching its content — what a
+     * paged source follows its dataset by.
+     *
+     * @remarks
+     * The path joins its workspace's status poll, started at `intervalMs` when
+     * nothing else polls the workspace. `onHash` is called with the hash a
+     * poll reports whenever it differs from the last this watch was told
+     * (`null` while the dataset has no value), the first poll after the watch
+     * starts included. The dataset's content is never fetched.
+     *
+     * @param workspace - The workspace
+     * @param path - The dataset's path
+     * @param onHash - Called with each new hash
+     * @param intervalMs - The poll's interval, when this watch starts it
+     * @returns A function that stops the watch; the poller stops once nothing
+     *   watches the workspace
+     */
+    watchHash(workspace: string, path: TreePath, onHash: (hash: string | null) => void, intervalMs?: number): () => void;
     /**
      * Force one immediate workspace-status poll, reconciling every watched
      * path's content against the server (hash-gated; only changed datasets
      * refetch). Use after an out-of-band server mutation (e.g. a record
      * mutation commit) so a watched dataset picks up the new bytes without
-     * waiting for the standing poll interval. No-op if the workspace has no
-     * active poller. Fire-and-forget; resolves when the poll settles.
+     * waiting for the standing poll interval. A poll already in flight may
+     * have read the status before the mutation, so the refresh polls again
+     * once it settles. No-op if the workspace has no active poller.
+     * Fire-and-forget; resolves when the refresh's poll settles.
      */
     refresh(workspace: string): Promise<void>;
     /** Subscribe to changes on a specific key */
@@ -178,6 +204,7 @@ export declare class ReactiveDatasetCache implements ReactiveDatasetCacheInterfa
     private workspacePollers;
     private readonly clock;
     private inFlightPolls;
+    private hashWatches;
     private batchDepth;
     private changedKeys;
     private scheduler;
@@ -247,15 +274,24 @@ export declare class ReactiveDatasetCache implements ReactiveDatasetCacheInterfa
      * 3. Only fetches full content when hash changes
      *
      * Multiple subscriptions to the same workspace share a single poller.
-     * Pair with {@link clearRefetchInterval} on unmount so the poller can
-     * stop when nothing is watching.
+     * Pair each call with one {@link clearRefetchInterval} on unmount so the
+     * poller can stop when nothing is watching.
      */
     setRefetchInterval(workspace: string, path: TreePath, intervalMs: number): void;
     /**
-     * Stop polling a dataset; the workspace poller is torn down when its
-     * last watched path is cleared.
+     * Stop polling a dataset for one watcher; the path goes when its last
+     * watcher clears it, and the workspace poller is torn down when its last
+     * path goes.
      */
     clearRefetchInterval(workspace: string, path: TreePath): void;
+    /**
+     * Follow a dataset's content hash without fetching its content; see the
+     * interface doc.
+     */
+    watchHash(workspace: string, path: TreePath, onHash: (hash: string | null) => void, intervalMs?: number): () => void;
+    /** Stops a workspace's poller once it has no path to reconcile and no hash
+     *  to follow — without this, a long-lived session polls forever. */
+    private stopIdlePoller;
     refresh(workspace: string): Promise<void>;
     /**
      * Poll workspace status and reconcile the cache with the server.

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

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

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

@@ -66,8 +66,14 @@ export declare class FuncRuntime extends TrackedChannelStore<FuncEntry> {
     /** Install the API adapter + workspace — called by the React provider
      *  (or a test/showcase harness) before any handle is used. */
     initialize(api: FunctionApi, workspace: string): void;
-    /** Tear down the adapter and all call state. */
-    clear(): void;
+    /**
+     * Tear down the adapter and all call 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?: FunctionApi): void;
     /** The deployed signature list for a workspace (fetched once). */
     private signatures;
     /** Validate a declared signature against the deployed list. Returns a
@@ -100,8 +106,12 @@ export declare const defaultFuncRuntime: FuncRuntime;
 /** Install the function API adapter + workspace — called by the React
  *  provider on mount (or by a test/showcase harness). */
 export declare function initializeFunctionApi(api: FunctionApi, workspace: string): void;
-/** Tear down the function API adapter and all call state. */
-export declare function clearFunctionApi(): void;
+/**
+ * Tear down the function API adapter and all call state.
+ *
+ * @param api - Clear only while this is the installed adapter
+ */
+export declare function clearFunctionApi(api?: FunctionApi): void;
 /** Global, manifest-unscoped `Func.bind` impl + its backing primitives.
  *  Registered on module load (powers the extension registry decode path). */
 export declare const FuncPlatform: PlatformFunction[];

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

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

package/dist/platform/index.d.ts

@@ -12,7 +12,7 @@ export { ReactiveDatasetCache, createReactiveDatasetCache, createDefaultDatasetA
 export { StagedStore, IndexedDBStagedAdapter, MemoryStagedAdapter, type StagedStoreInterface, type StagedPersistenceAdapter, type StagedEntry, type PersistedStagedEntry, getStagedStore, initializeStagedStore, clearStagedStoreSingleton, } from './staged-store.js';
 export { BindRuntime, defaultBindRuntime, BindPlatform, createScopedBindPlatform, getReactiveDatasetCache, initializeReactiveDatasetCache, clearReactiveDatasetCache, enableBindingTracking, disableBindingTracking, isBindingTracking, trackDatasetPath, getBindingTypes, clearBindingRegistry, type BindingTypes, type BindHandle, preloadReactiveDatasetList, clearReactiveDatasetListCache, onWriteError, awaitPendingWrites, clearPendingWrites, } from './bind-runtime.js';
 export { FuncRuntime, defaultFuncRuntime, FuncPlatform, createScopedFuncPlatform, createDefaultFunctionApi, initializeFunctionApi, clearFunctionApi, funcChannelKey, signatureOfFuncHandleType, createInMemoryFunctionApi, type InMemoryFunctionDef, type FunctionApi, type FunctionCallArgs, } from './func-runtime.js';
-export { PagedRuntime, defaultPagedRuntime, PagedPlatform, createScopedPagedPlatform, createDefaultPagedApi, initializePagedApi, clearPagedApi, pagedWindowKey, pagedTotalKey, type PagedApi, type PagedWindow, } from './paged-runtime.js';
+export { PagedRuntime, defaultPagedRuntime, PagedPlatform, createScopedPagedPlatform, createDefaultPagedApi, initializePagedApi, clearPagedApi, pagedRevisionKey, pagedWindowKey, pagedTotalKey, type PagedApi, type PagedWindow, } from './paged-runtime.js';
 export { RecordRuntime, defaultRecordRuntime, RecordPlatform, createScopedRecordPlatform, createDefaultRecordApi, initializeRecordApi, clearRecordApi, recordChannelKey, createInMemoryRecordApi, type InMemoryRecordDef, type RecordApi, type RecordMutateArgs, } from './record-runtime.js';
 export { E3Provider, useE3Config, useE3ConfigOptional, type E3Config, type E3ProviderProps, } from './e3-config.js';
 export { ReactiveDatasetProvider, type ReactiveDatasetProviderProps, useReactiveDatasetCache, useReactiveDatasetCacheSubscription, useReactiveDatasetKey, usePreloadReactiveDatasets, type ReactiveDatasetToPreload, type PreloadReactiveDatasetsResult, useReactiveDatasetWrite, useReactiveDatasetHas, ReactiveDatasetLoader, type ReactiveDatasetLoaderProps, } from './dataset-hooks.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/platform/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;GAKG;AAGH,OAAO,EACH,oBAAoB,EACpB,0BAA0B,EAC1B,uBAAuB,EACvB,SAAS,EACT,KAAK,6BAA6B,EAClC,KAAK,0BAA0B,EAC/B,KAAK,UAAU,EACf,KAAK,KAAK,EACV,eAAe,EACf,mBAAmB,GACtB,MAAM,oBAAoB,CAAC;AAK5B,OAAO,EACH,WAAW,EACX,sBAAsB,EACtB,mBAAmB,EACnB,KAAK,oBAAoB,EACzB,KAAK,wBAAwB,EAC7B,KAAK,WAAW,EAChB,KAAK,oBAAoB,EACzB,cAAc,EACd,qBAAqB,EACrB,yBAAyB,GAC5B,MAAM,mBAAmB,CAAC;AAI3B,OAAO,EACH,WAAW,EACX,kBAAkB,EAClB,YAAY,EACZ,wBAAwB,EACxB,uBAAuB,EACvB,8BAA8B,EAC9B,yBAAyB,EACzB,qBAAqB,EACrB,sBAAsB,EACtB,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,oBAAoB,EACpB,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,0BAA0B,EAC1B,6BAA6B,EAC7B,YAAY,EACZ,kBAAkB,EAClB,kBAAkB,GACrB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACH,WAAW,EACX,kBAAkB,EAClB,YAAY,EACZ,wBAAwB,EACxB,wBAAwB,EACxB,qBAAqB,EACrB,gBAAgB,EAChB,cAAc,EACd,yBAAyB,EACzB,yBAAyB,EACzB,KAAK,mBAAmB,EACxB,KAAK,WAAW,EAChB,KAAK,gBAAgB,GACxB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACH,YAAY,EACZ,mBAAmB,EACnB,aAAa,EACb,yBAAyB,EACzB,qBAAqB,EACrB,kBAAkB,EAClB,aAAa,EACb,cAAc,EACd,aAAa,EACb,KAAK,QAAQ,EACb,KAAK,WAAW,GACnB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACH,aAAa,EACb,oBAAoB,EACpB,cAAc,EACd,0BAA0B,EAC1B,sBAAsB,EACtB,mBAAmB,EACnB,cAAc,EACd,gBAAgB,EAChB,uBAAuB,EACvB,KAAK,iBAAiB,EACtB,KAAK,SAAS,EACd,KAAK,gBAAgB,GACxB,MAAM,qBAAqB,CAAC;AAK7B,OAAO,EACH,UAAU,EACV,WAAW,EACX,mBAAmB,EACnB,KAAK,QAAQ,EACb,KAAK,eAAe,GACvB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACH,uBAAuB,EACvB,KAAK,4BAA4B,EACjC,uBAAuB,EACvB,mCAAmC,EACnC,qBAAqB,EACrB,0BAA0B,EAC1B,KAAK,wBAAwB,EAC7B,KAAK,6BAA6B,EAClC,uBAAuB,EACvB,qBAAqB,EACrB,qBAAqB,EACrB,KAAK,0BAA0B,GAClC,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/platform/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;GAKG;AAGH,OAAO,EACH,oBAAoB,EACpB,0BAA0B,EAC1B,uBAAuB,EACvB,SAAS,EACT,KAAK,6BAA6B,EAClC,KAAK,0BAA0B,EAC/B,KAAK,UAAU,EACf,KAAK,KAAK,EACV,eAAe,EACf,mBAAmB,GACtB,MAAM,oBAAoB,CAAC;AAK5B,OAAO,EACH,WAAW,EACX,sBAAsB,EACtB,mBAAmB,EACnB,KAAK,oBAAoB,EACzB,KAAK,wBAAwB,EAC7B,KAAK,WAAW,EAChB,KAAK,oBAAoB,EACzB,cAAc,EACd,qBAAqB,EACrB,yBAAyB,GAC5B,MAAM,mBAAmB,CAAC;AAI3B,OAAO,EACH,WAAW,EACX,kBAAkB,EAClB,YAAY,EACZ,wBAAwB,EACxB,uBAAuB,EACvB,8BAA8B,EAC9B,yBAAyB,EACzB,qBAAqB,EACrB,sBAAsB,EACtB,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,oBAAoB,EACpB,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,0BAA0B,EAC1B,6BAA6B,EAC7B,YAAY,EACZ,kBAAkB,EAClB,kBAAkB,GACrB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACH,WAAW,EACX,kBAAkB,EAClB,YAAY,EACZ,wBAAwB,EACxB,wBAAwB,EACxB,qBAAqB,EACrB,gBAAgB,EAChB,cAAc,EACd,yBAAyB,EACzB,yBAAyB,EACzB,KAAK,mBAAmB,EACxB,KAAK,WAAW,EAChB,KAAK,gBAAgB,GACxB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACH,YAAY,EACZ,mBAAmB,EACnB,aAAa,EACb,yBAAyB,EACzB,qBAAqB,EACrB,kBAAkB,EAClB,aAAa,EACb,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,KAAK,QAAQ,EACb,KAAK,WAAW,GACnB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACH,aAAa,EACb,oBAAoB,EACpB,cAAc,EACd,0BAA0B,EAC1B,sBAAsB,EACtB,mBAAmB,EACnB,cAAc,EACd,gBAAgB,EAChB,uBAAuB,EACvB,KAAK,iBAAiB,EACtB,KAAK,SAAS,EACd,KAAK,gBAAgB,GACxB,MAAM,qBAAqB,CAAC;AAK7B,OAAO,EACH,UAAU,EACV,WAAW,EACX,mBAAmB,EACnB,KAAK,QAAQ,EACb,KAAK,eAAe,GACvB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACH,uBAAuB,EACvB,KAAK,4BAA4B,EACjC,uBAAuB,EACvB,mCAAmC,EACnC,qBAAqB,EACrB,0BAA0B,EAC1B,KAAK,wBAAwB,EAC7B,KAAK,6BAA6B,EAClC,uBAAuB,EACvB,qBAAqB,EACrB,qBAAqB,EACrB,KAAK,0BAA0B,GAClC,MAAM,oBAAoB,CAAC"}

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