@elaraai/e3-ui 1.0.79 → 1.0.80

package/README.md

@@ -121,7 +121,7 @@ Dual-licensed:
   - [@elaraai/e3](https://www.npmjs.com/package/@elaraai/e3): SDK for authoring e3 packages with typed tasks and pipelines
   - [@elaraai/e3-core](https://www.npmjs.com/package/@elaraai/e3-core): Object store, dataflow orchestrator, execution state
   - [@elaraai/e3-types](https://www.npmjs.com/package/@elaraai/e3-types): Shared type definitions for e3 packages
-  - [@elaraai/e3-cli](https://www.npmjs.com/package/@elaraai/e3-cli): `e3 repo`, `e3 package`, `e3 workspace`, `e3 start`, `e3 watch`, `e3 logs` commands
+  - [@elaraai/e3-cli](https://www.npmjs.com/package/@elaraai/e3-cli): `e3 repo`, `e3 package`, `e3 workspace`, `e3 dataflow run`, `e3 watch`, `e3 task logs` commands
   - [@elaraai/e3-api-client](https://www.npmjs.com/package/@elaraai/e3-api-client): HTTP client for remote e3 repositories
   - [@elaraai/e3-api-server](https://www.npmjs.com/package/@elaraai/e3-api-server): REST API server for e3 repositories
   - [@elaraai/e3-api-tests](https://www.npmjs.com/package/@elaraai/e3-api-tests): Shared API compliance test suites

package/dist/src/bind/data.d.ts

@@ -7,8 +7,8 @@
  *
  * @packageDocumentation
  */
-import { NullType, BooleanType, FunctionType, IntegerType, StringType, StructType, VariantType, OptionType, type EastType, type ExprType } from '@elaraai/east';
-import type { DatasetDef, TaskDef } from '@elaraai/e3';
+import { ArrayType, NullType, BooleanType, FunctionType, IntegerType, StringType, StructType, VariantType, OptionType, type DictType, type EastType, type ExprType } from '@elaraai/east';
+import type { DatasetDef, RecordDef, RecordIndexDef, TaskDef } from '@elaraai/e3';
 /**
  * The two operating modes for {@link Data.bind}.
  *
@@ -42,10 +42,10 @@ export type DataBindModeLiteral = "staged" | "direct";
  * @property mode - The binding's operating mode — see {@link DataBindModeType}.
  */
 export declare const DiffBindingType: StructType<{
-    readonly source: import("@elaraai/east").ArrayType<VariantType<{
+    readonly source: ArrayType<VariantType<{
         readonly field: StringType;
     }>>;
-    readonly patch: OptionType<import("@elaraai/east").ArrayType<VariantType<{
+    readonly patch: OptionType<ArrayType<VariantType<{
         readonly field: StringType;
     }>>>;
     readonly mode: VariantType<{
@@ -99,10 +99,10 @@ export declare const DataBindHandleType: <T extends EastType | string>(t: T) =>
         readonly 'up-to-date': NullType;
     }>>;
     readonly binding: StructType<{
-        readonly source: import("@elaraai/east").ArrayType<VariantType<{
+        readonly source: ArrayType<VariantType<{
             readonly field: StringType;
         }>>;
-        readonly patch: OptionType<import("@elaraai/east").ArrayType<VariantType<{
+        readonly patch: OptionType<ArrayType<VariantType<{
             readonly field: StringType;
         }>>>;
         readonly mode: VariantType<{
@@ -138,9 +138,9 @@ export type BoundValue<T extends EastType> = ExprType<ReturnType<typeof DataBind
  * runtime implementations register against this raw definition via
  * `bindPlatformFn.implement(...)`.
  */
-export declare const bindPlatformFn: import("@elaraai/east").GenericPlatformDefinition<readonly ["T"], readonly [import("@elaraai/east").ArrayType<VariantType<{
+export declare const bindPlatformFn: import("@elaraai/east").GenericPlatformDefinition<readonly ["T"], readonly [ArrayType<VariantType<{
     readonly field: StringType;
-}>>, OptionType<import("@elaraai/east").ArrayType<VariantType<{
+}>>, OptionType<ArrayType<VariantType<{
     readonly field: StringType;
 }>>>, VariantType<{
     readonly staged: NullType;
@@ -161,10 +161,10 @@ export declare const bindPlatformFn: import("@elaraai/east").GenericPlatformDefi
         readonly 'up-to-date': NullType;
     }>>;
     readonly binding: StructType<{
-        readonly source: import("@elaraai/east").ArrayType<VariantType<{
+        readonly source: ArrayType<VariantType<{
             readonly field: StringType;
         }>>;
-        readonly patch: OptionType<import("@elaraai/east").ArrayType<VariantType<{
+        readonly patch: OptionType<ArrayType<VariantType<{
             readonly field: StringType;
         }>>>;
         readonly mode: VariantType<{
@@ -182,90 +182,90 @@ export declare const bindPlatformFn: import("@elaraai/east").GenericPlatformDefi
  */
 export declare const DataBindPrimitives: {
     /** `data_read([T], source, patch, mode) -> T` — the binding's view (mode×patch). */
-    readonly read: import("@elaraai/east").GenericPlatformDefinition<readonly ["T"], readonly [import("@elaraai/east").ArrayType<VariantType<{
+    readonly read: import("@elaraai/east").GenericPlatformDefinition<readonly ["T"], readonly [ArrayType<VariantType<{
         readonly field: StringType;
-    }>>, OptionType<import("@elaraai/east").ArrayType<VariantType<{
+    }>>, OptionType<ArrayType<VariantType<{
         readonly field: StringType;
     }>>>, VariantType<{
         readonly staged: NullType;
         readonly direct: NullType;
     }>], "T">;
     /** `data_source([T], source, patch, mode) -> T` — raw source, no overlay. */
-    readonly source: import("@elaraai/east").GenericPlatformDefinition<readonly ["T"], readonly [import("@elaraai/east").ArrayType<VariantType<{
+    readonly source: import("@elaraai/east").GenericPlatformDefinition<readonly ["T"], readonly [ArrayType<VariantType<{
         readonly field: StringType;
-    }>>, OptionType<import("@elaraai/east").ArrayType<VariantType<{
+    }>>, OptionType<ArrayType<VariantType<{
         readonly field: StringType;
     }>>>, VariantType<{
         readonly staged: NullType;
         readonly direct: NullType;
     }>], "T">;
     /** `data_write([T], source, patch, mode, value) -> Null`. */
-    readonly write: import("@elaraai/east").GenericPlatformDefinition<readonly ["T"], readonly [import("@elaraai/east").ArrayType<VariantType<{
+    readonly write: import("@elaraai/east").GenericPlatformDefinition<readonly ["T"], readonly [ArrayType<VariantType<{
         readonly field: StringType;
-    }>>, OptionType<import("@elaraai/east").ArrayType<VariantType<{
+    }>>, OptionType<ArrayType<VariantType<{
         readonly field: StringType;
     }>>>, VariantType<{
         readonly staged: NullType;
         readonly direct: NullType;
     }>, "T"], NullType>;
     /** `data_write_and_start([T], source, patch, mode, value) -> Null`. */
-    readonly writeAndStart: import("@elaraai/east").GenericPlatformDefinition<readonly ["T"], readonly [import("@elaraai/east").ArrayType<VariantType<{
+    readonly writeAndStart: import("@elaraai/east").GenericPlatformDefinition<readonly ["T"], readonly [ArrayType<VariantType<{
         readonly field: StringType;
-    }>>, OptionType<import("@elaraai/east").ArrayType<VariantType<{
+    }>>, OptionType<ArrayType<VariantType<{
         readonly field: StringType;
     }>>>, VariantType<{
         readonly staged: NullType;
         readonly direct: NullType;
     }>, "T"], NullType>;
     /** `data_start([T], source, patch, mode) -> Null`. */
-    readonly start: import("@elaraai/east").GenericPlatformDefinition<readonly ["T"], readonly [import("@elaraai/east").ArrayType<VariantType<{
+    readonly start: import("@elaraai/east").GenericPlatformDefinition<readonly ["T"], readonly [ArrayType<VariantType<{
         readonly field: StringType;
-    }>>, OptionType<import("@elaraai/east").ArrayType<VariantType<{
+    }>>, OptionType<ArrayType<VariantType<{
         readonly field: StringType;
     }>>>, VariantType<{
         readonly staged: NullType;
         readonly direct: NullType;
     }>], NullType>;
     /** `data_pending([T], source, patch, mode) -> Bool`. */
-    readonly pending: import("@elaraai/east").GenericPlatformDefinition<readonly ["T"], readonly [import("@elaraai/east").ArrayType<VariantType<{
+    readonly pending: import("@elaraai/east").GenericPlatformDefinition<readonly ["T"], readonly [ArrayType<VariantType<{
         readonly field: StringType;
-    }>>, OptionType<import("@elaraai/east").ArrayType<VariantType<{
+    }>>, OptionType<ArrayType<VariantType<{
         readonly field: StringType;
     }>>>, VariantType<{
         readonly staged: NullType;
         readonly direct: NullType;
     }>], BooleanType>;
     /** `data_commit([T], source, patch, mode) -> Null`. */
-    readonly commit: import("@elaraai/east").GenericPlatformDefinition<readonly ["T"], readonly [import("@elaraai/east").ArrayType<VariantType<{
+    readonly commit: import("@elaraai/east").GenericPlatformDefinition<readonly ["T"], readonly [ArrayType<VariantType<{
         readonly field: StringType;
-    }>>, OptionType<import("@elaraai/east").ArrayType<VariantType<{
+    }>>, OptionType<ArrayType<VariantType<{
         readonly field: StringType;
     }>>>, VariantType<{
         readonly staged: NullType;
         readonly direct: NullType;
     }>], NullType>;
     /** `data_discard([T], source, patch, mode) -> Null`. */
-    readonly discard: import("@elaraai/east").GenericPlatformDefinition<readonly ["T"], readonly [import("@elaraai/east").ArrayType<VariantType<{
+    readonly discard: import("@elaraai/east").GenericPlatformDefinition<readonly ["T"], readonly [ArrayType<VariantType<{
         readonly field: StringType;
-    }>>, OptionType<import("@elaraai/east").ArrayType<VariantType<{
+    }>>, OptionType<ArrayType<VariantType<{
         readonly field: StringType;
     }>>>, VariantType<{
         readonly staged: NullType;
         readonly direct: NullType;
     }>], NullType>;
     /** `data_has([T], source, patch, mode) -> Bool`. */
-    readonly has: import("@elaraai/east").GenericPlatformDefinition<readonly ["T"], readonly [import("@elaraai/east").ArrayType<VariantType<{
+    readonly has: import("@elaraai/east").GenericPlatformDefinition<readonly ["T"], readonly [ArrayType<VariantType<{
         readonly field: StringType;
-    }>>, OptionType<import("@elaraai/east").ArrayType<VariantType<{
+    }>>, OptionType<ArrayType<VariantType<{
         readonly field: StringType;
     }>>>, VariantType<{
         readonly staged: NullType;
         readonly direct: NullType;
     }>], BooleanType>;
     /** `data_status([T], source, patch, mode) -> DatasetStatus`. */
-    readonly status: import("@elaraai/east").GenericPlatformDefinition<readonly ["T"], readonly [import("@elaraai/east").ArrayType<VariantType<{
+    readonly status: import("@elaraai/east").GenericPlatformDefinition<readonly ["T"], readonly [ArrayType<VariantType<{
         readonly field: StringType;
-    }>>, OptionType<import("@elaraai/east").ArrayType<VariantType<{
+    }>>, OptionType<ArrayType<VariantType<{
         readonly field: StringType;
     }>>>, VariantType<{
         readonly staged: NullType;
@@ -370,17 +370,32 @@ declare function bindData<T extends EastType>(dataset: DatasetDef<T> | TaskDef<T
  * a window is not a value you can diff or stage. Bind the same dataset with
  * {@link Data.bind} when you need to edit it.
  *
+ * Every window, the total and every search belong to one snapshot of the
+ * dataset, its `revision`, so rows from two snapshots never sit side by side.
+ *
+ * @property id - The source's identity: its dataset path, and the index it
+ *   reads through. A renderer keys its window cache on `id` and `revision`.
  * @property page - Read one window: `(offset, limit)` → the window's elements
  *   as a value of the dataset's own type. `none` means the window is still in
  *   flight — the call re-fires when it lands (use inside `Reactive.Root`). An
  *   EMPTY window means the source is exhausted at that offset, so a reader
- *   that walks offsets terminates on `some([])`, never on `none`.
- * @property total - The source's total element count, once any window has
- *   landed; `none` until then.
+ *   that walks offsets terminates on `some([])`, never on `none`. A window
+ *   whose fetch failed throws its reason, and a read after a short gap fetches
+ *   it again.
+ * @property total - The source's total element count, once any window of the
+ *   snapshot has landed; `none` until then.
  * @property seek - Key search over the dataset, backed by the server's fence
  *   search (`datasetFindKey`). `none` for an Array-typed dataset: stream order
  *   has nothing to binary-search. Decided at bind time from the dataset's own
  *   type, so a component renders the affordance only where it works.
+ * @property revision - The snapshot the source serves: the dataset's content
+ *   hash, or, for a read through an index, the record's state hash. `none`
+ *   while it is being found, or while the dataset has no value. A reader
+ *   re-fires when the source moves to another snapshot.
+ * @property refresh - Move the source: `some(hash)` to that snapshot, `none`
+ *   to the dataset's current one. Call it from an event handler after a
+ *   confirmed write, so the view shows the write without waiting for the
+ *   source to notice it. Returns at once.
  */
 export declare const DataPagedHandleType: <T extends EastType | string>(t: T) => StructType<{
     readonly id: StringType;
@@ -390,15 +405,52 @@ export declare const DataPagedHandleType: <T extends EastType | string>(t: T) =>
         readonly key: StringType;
         readonly prefix: StringType;
         readonly fields: StructType<{
-            readonly values: import("@elaraai/east").ArrayType<StringType>;
+            readonly values: ArrayType<StringType>;
             readonly prefix: OptionType<StringType>;
         }>;
+        readonly range: StructType<{
+            readonly from: ArrayType<StringType>;
+            readonly to: ArrayType<StringType>;
+        }>;
     }>], OptionType<StructType<{
         readonly found: BooleanType;
         readonly row: IntegerType;
         readonly count: IntegerType;
     }>>>>;
+    readonly revision: FunctionType<[], OptionType<StringType>>;
+    readonly refresh: FunctionType<[OptionType<StringType>], NullType>;
 }>;
+/** The window type an index-selected {@link Data.bindPaged} serves, spelled at
+ *  the TypeScript level so a component's prop types against it. */
+export type IndexWindowType<T extends EastType, IK extends EastType, P extends EastType> = T extends DictType<infer K, infer V> ? ArrayType<StructType<{
+    ik: IK;
+    key: K;
+    value: P;
+    row: OptionType<V>;
+}>> : never;
+/** Reading a record through one of its secondary indexes. */
+export interface BindPagedIndexOptions<T extends EastType, IK extends EastType, P extends EastType> {
+    /**
+     * The index to read through, as the `e3.recordIndex` declaration.
+     *
+     * @remarks
+     * The declaration rather than the name: the window's type — the index key
+     * and the covering projection — comes from it, so a component binding an
+     * index gets the row shape it will actually render, checked at compile
+     * time. Only the NAME travels in the IR.
+     */
+    index: RecordIndexDef<string, T, IK, P>;
+    /**
+     * Read each entry's row from the record too.
+     *
+     * @remarks
+     * Off by default, which is what a covering projection is for: a queue view
+     * that renders from `value` alone touches the index's segments and none of
+     * the record's. Turn it on when the view needs fields the projection does
+     * not carry, and accept a read per entry's segment.
+     */
+    join?: boolean;
+}
 /**
  * The TypeScript type of a {@link Data.bindPaged} handle bound to source type
  * `T` — the paged sibling of {@link BoundValue}.
@@ -414,11 +466,13 @@ export declare const DataPagedHandleType: <T extends EastType | string>(t: T) =>
  */
 export type PagedValue<T extends EastType> = ExprType<ReturnType<typeof DataPagedHandleType<T>>>;
 /**
- * The underlying `Data.bindPaged` platform-function definition. End-users
- * should call {@link Data.bindPaged}; runtime implementations register
- * against this raw definition via `bindPagedPlatformFn.implement(...)`.
+ * The platform function a UI exported before pinned reads calls: a paged bind
+ * of the dataset's own rows, whose handle has no `revision` or `refresh`. Its
+ * reads are pinned, follow the dataset and fail visibly all the same, since the
+ * runtime serves both binds alike. End-users call {@link Data.bindPaged}, which
+ * emits {@link bindPagedPinnedPlatformFn}.
  */
-export declare const bindPagedPlatformFn: import("@elaraai/east").GenericPlatformDefinition<readonly ["T"], readonly [import("@elaraai/east").ArrayType<VariantType<{
+export declare const bindPagedPlatformFn: import("@elaraai/east").GenericPlatformDefinition<readonly ["T"], readonly [ArrayType<VariantType<{
     readonly field: StringType;
 }>>], StructType<{
     readonly id: StringType;
@@ -428,14 +482,55 @@ export declare const bindPagedPlatformFn: import("@elaraai/east").GenericPlatfor
         readonly key: StringType;
         readonly prefix: StringType;
         readonly fields: StructType<{
-            readonly values: import("@elaraai/east").ArrayType<StringType>;
+            readonly values: ArrayType<StringType>;
+            readonly prefix: OptionType<StringType>;
+        }>;
+        readonly range: StructType<{
+            readonly from: ArrayType<StringType>;
+            readonly to: ArrayType<StringType>;
+        }>;
+    }>], OptionType<StructType<{
+        readonly found: BooleanType;
+        readonly row: IntegerType;
+        readonly count: IntegerType;
+    }>>>>;
+}>>;
+/**
+ * The underlying `Data.bindPaged` platform-function definition: the source
+ * path, the index to read through (`none` for the dataset's own rows), and
+ * whether each index entry is joined to its row. Runtime implementations
+ * register against it via `bindPagedPinnedPlatformFn.implement(...)`.
+ *
+ * @remarks
+ * A function of its own rather than a wider `data_bind_paged`: that call and
+ * the handle it returns are baked into every UI package already exported, and
+ * a platform call is checked against its implementation's arity and return
+ * type exactly, so widening either would refuse every one of them.
+ */
+export declare const bindPagedPinnedPlatformFn: import("@elaraai/east").GenericPlatformDefinition<readonly ["T"], readonly [ArrayType<VariantType<{
+    readonly field: StringType;
+}>>, OptionType<StringType>, BooleanType], StructType<{
+    readonly id: StringType;
+    readonly page: FunctionType<[IntegerType, IntegerType], OptionType<"T">>;
+    readonly total: FunctionType<[], OptionType<IntegerType>>;
+    readonly seek: OptionType<FunctionType<[VariantType<{
+        readonly key: StringType;
+        readonly prefix: StringType;
+        readonly fields: StructType<{
+            readonly values: ArrayType<StringType>;
             readonly prefix: OptionType<StringType>;
         }>;
+        readonly range: StructType<{
+            readonly from: ArrayType<StringType>;
+            readonly to: ArrayType<StringType>;
+        }>;
     }>], OptionType<StructType<{
         readonly found: BooleanType;
         readonly row: IntegerType;
         readonly count: IntegerType;
     }>>>>;
+    readonly revision: FunctionType<[], OptionType<StringType>>;
+    readonly refresh: FunctionType<[OptionType<StringType>], NullType>;
 }>>;
 /**
  * Low-level platform primitives that back {@link Data.bindPaged}'s handle
@@ -444,30 +539,47 @@ export declare const bindPagedPlatformFn: import("@elaraai/east").GenericPlatfor
  * @internal Not for direct use — author against {@link Data.bindPaged}.
  */
 export declare const DataPagedPrimitives: {
-    /** `data_page([T], source, offset, limit) -> Option<T>` — one window (`none` = in flight). */
-    readonly page: import("@elaraai/east").GenericPlatformDefinition<readonly ["T"], readonly [import("@elaraai/east").ArrayType<VariantType<{
+    /** `data_page([T], source, index, join, offset, limit) -> Option<T>` — one
+     *  window (`none` = in flight). */
+    readonly page: import("@elaraai/east").GenericPlatformDefinition<readonly ["T"], readonly [ArrayType<VariantType<{
         readonly field: StringType;
-    }>>, IntegerType, IntegerType], OptionType<string>>;
-    /** `data_page_total([T], source) -> Option<Integer>` — total elements, once known. */
-    readonly total: import("@elaraai/east").GenericPlatformDefinition<readonly ["T"], readonly [import("@elaraai/east").ArrayType<VariantType<{
+    }>>, OptionType<StringType>, BooleanType, IntegerType, IntegerType], OptionType<string>>;
+    /** `data_page_total([T], source, index, join) -> Option<Integer>` — total
+     *  elements, once known. */
+    readonly total: import("@elaraai/east").GenericPlatformDefinition<readonly ["T"], readonly [ArrayType<VariantType<{
         readonly field: StringType;
-    }>>], OptionType<IntegerType>>;
-    /** `data_page_seek([T], source, query) -> Option<SeekRange>` — where a key
-     *  query lands in the source's row order (`none` = search in flight). */
-    readonly seek: import("@elaraai/east").GenericPlatformDefinition<readonly ["T"], readonly [import("@elaraai/east").ArrayType<VariantType<{
+    }>>, OptionType<StringType>, BooleanType], OptionType<IntegerType>>;
+    /** `data_page_seek([T], source, index, join, query) -> Option<SeekRange>` —
+     *  where a key query lands in the source's row order (`none` = search in
+     *  flight). */
+    readonly seek: import("@elaraai/east").GenericPlatformDefinition<readonly ["T"], readonly [ArrayType<VariantType<{
         readonly field: StringType;
-    }>>, VariantType<{
+    }>>, OptionType<StringType>, BooleanType, VariantType<{
         readonly key: StringType;
         readonly prefix: StringType;
         readonly fields: StructType<{
-            readonly values: import("@elaraai/east").ArrayType<StringType>;
+            readonly values: ArrayType<StringType>;
             readonly prefix: OptionType<StringType>;
         }>;
+        readonly range: StructType<{
+            readonly from: ArrayType<StringType>;
+            readonly to: ArrayType<StringType>;
+        }>;
     }>], OptionType<StructType<{
         readonly found: BooleanType;
         readonly row: IntegerType;
         readonly count: IntegerType;
     }>>>;
+    /** `data_page_revision([T], source, index, join) -> Option<String>` — the
+     *  snapshot the source serves (`none` while it is found). */
+    readonly revision: import("@elaraai/east").GenericPlatformDefinition<readonly ["T"], readonly [ArrayType<VariantType<{
+        readonly field: StringType;
+    }>>, OptionType<StringType>, BooleanType], OptionType<StringType>>;
+    /** `data_page_refresh([T], source, index, join, target) -> Null` — move
+     *  the source to `target`, or to the dataset's current snapshot. */
+    readonly refresh: import("@elaraai/east").GenericPlatformDefinition<readonly ["T"], readonly [ArrayType<VariantType<{
+        readonly field: StringType;
+    }>>, OptionType<StringType>, BooleanType, OptionType<StringType>], NullType>;
 };
 /**
  * Bind a collection dataset (Array / Set / Dict) to a WINDOWED reactive view
@@ -480,19 +592,28 @@ export declare const DataPagedPrimitives: {
  *
  * @typeParam T - The East type of the source dataset value (a collection type).
  * @param dataset - The dataset (or task) definition to bind.
- * @returns A handle struct described by {@link DataPagedHandleType} — `page`
- *   and `total`.
+ * @returns A handle struct described by {@link DataPagedHandleType} — `page`,
+ *   `total`, `seek`, `revision` and `refresh`.
  *
  * @remarks
  * Each `page(offset, limit)` fetches exactly that window and decodes it
  * against the dataset's own type — no blobs, no beast2, no manual fetch in
  * user code. A window still in flight reads `none` and the call re-fires when
  * it lands, so use it inside `Reactive.Root`; an empty window means the source
- * is exhausted, which is how a walking reader terminates.
+ * is exhausted, which is how a walking reader terminates. A window whose fetch
+ * failed throws its reason, so a view shows the failure rather than waiting;
+ * a read after a short gap fetches it again.
+ *
+ * Every window and search is pinned to the source's `revision`, the dataset's
+ * content hash, so rows from two snapshots never sit side by side. The source
+ * follows its dataset: when the content changes — a dataflow run, another
+ * user's write — it moves to the new snapshot, drops what it held, and fetches
+ * again only the windows and searches being read. `refresh` moves it at once,
+ * after a write the view itself confirmed.
  *
- * Unlike {@link Data.bind}, a paged source is NOT preloaded or polled as a
- * whole value — it is declared in the UI task's manifest under `pages`, which
- * is the entire point of binding it paged.
+ * Unlike {@link Data.bind}, a paged source is never preloaded or fetched
+ * whole: it is declared in the UI task's manifest under `pages`, and follows
+ * its dataset by content hash alone, which is the point of binding it paged.
  *
  * @example
  * ```ts
@@ -521,6 +642,7 @@ export declare const DataPagedPrimitives: {
  * ```
  */
 declare function bindDataPaged<T extends EastType>(dataset: DatasetDef<T> | TaskDef<T>): PagedValue<T>;
+declare function bindDataPaged<T extends EastType, IK extends EastType, P extends EastType>(record: RecordDef<T>, options: BindPagedIndexOptions<T, IK, P>): PagedValue<IndexWindowType<T, IK, P>>;
 /**
  * The Data namespace — reactive dataset binding for e3 UI tasks.
  *

package/dist/src/bind/data.d.ts.map

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