@elaraai/e3-ui-components 1.0.67 → 1.0.69

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;AAwB5B;;;;GAIG;AACH,MAAM,WAAW,4BAA4B;IACzC,QAAQ,EAAE,SAAS,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,uBAAuB,CAAC,EACpC,QAAQ,GACX,EAAE,4BAA4B,2CA2F9B;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;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"}

package/dist/platform/index.d.ts

@@ -12,6 +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 { 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,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,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

@@ -0,0 +1,146 @@
+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 { TrackedChannelStore } from './tracked-channel.js';
+/** One element window of a paged source. */
+export interface PagedWindow {
+    /** Global element offset of the window's first element. */
+    offset: number;
+    /** Maximum elements to return (the server may clamp it). */
+    limit: number;
+}
+/**
+ * Adapter for the dataset paging endpoint. The default wraps
+ * `@elaraai/e3-api-client`'s `datasetGetPage`.
+ */
+export interface PagedApi {
+    /** Fetch one element window of a collection dataset. */
+    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>;
+}
+/**
+ * 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.
+ */
+export declare function createDefaultPagedApi(apiUrl: string, repo: string, getToken: () => string | null): PagedApi;
+/** One tracked channel per window (and one per source, for the total). */
+interface PageEntry {
+    status: "idle" | "running" | "loaded" | "failed";
+    launchSeq: number;
+    /** The decoded window — a value of the dataset's own type. */
+    window?: unknown;
+    /** Total elements in the source, learned from any landed window. */
+    total?: number;
+    /** Where a key query landed — the answer on a seek channel. */
+    range?: DatasetFindResult;
+    /** 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. */
+    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;
+/**
+ * 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`).
+ */
+export declare function toFindQuery(query: unknown): DatasetFindQuery;
+/**
+ * Encapsulates all `Data.bindPaged` runtime state. The module-level
+ * {@link defaultPagedRuntime} instance backs the registered platform; tests
+ * construct their own for isolation.
+ */
+export declare class PagedRuntime extends TrackedChannelStore<PageEntry> {
+    private api;
+    private workspace;
+    private readonly handleCache;
+    /** 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;
+    /** 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. */
+    initialize(api: PagedApi, workspace: string): void;
+    /** Tear down the adapter and all window state. */
+    clear(): void;
+    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;
+    /**
+     * Start the fetch for a window if it isn't loaded or already in flight.
+     *
+     * 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.
+     */
+    private ensureWindow;
+    /**
+     * 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).
+     */
+    private ensureSeek;
+    /**
+     * The low-level primitives backing handle methods, bound to THIS runtime.
+     * Registered globally (extension registry) and included by the scoped
+     * platform (e3 `ui()` tasks) so a decoded handle re-binds to whatever
+     * runtime resolves the primitives on the decode side.
+     */
+    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).
+     */
+    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. */
+    buildPlatform(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.
+ *  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.
+ *
+ *  The `data_page*` primitives MUST ship with the scoped platform: e3 `ui()`
+ *  tasks render through `createScoped*()` arrays (UITaskPreview), NOT the
+ *  global registry, so a serialized handle's methods would otherwise decode to
+ *  "Platform function 'data_page' is not available". */
+export declare function createScopedPagedPlatform(pages: readonly TreePath[]): PlatformFunction[];
+export {};
+//# sourceMappingURL=paged-runtime.d.ts.map

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

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

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

@@ -41,6 +41,11 @@ export declare abstract class TrackedChannelStore<E extends ChannelEntry> {
     enableTracking(): Set<string>;
     disableTracking(): string[];
     isTracking(): boolean;
+    /** Whether the CURRENT evaluation has already read this channel. A cache
+     *  that evicts by least-recently-read must never drop one of these: a read
+     *  pass longer than the cache would otherwise evict its own head, and the
+     *  next pass would find it gone (#581). */
+    protected isTracked(key: string): boolean;
     /** Record a channel-key dependency for the current render (no-op when not
      *  tracking). */
     protected track(key: string): void;

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;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;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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elaraai/e3-ui-components",
-  "version": "1.0.67",
+  "version": "1.0.69",
   "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-types": "1.0.67",
-    "@elaraai/e3-ui": "1.0.67",
-    "@elaraai/e3-api-client": "1.0.67",
-    "@elaraai/east": "1.0.67",
-    "@elaraai/east-ui-components": "1.0.67",
-    "@elaraai/east-ui": "1.0.67"
+    "@elaraai/e3-api-client": "1.0.69",
+    "@elaraai/e3-types": "1.0.69",
+    "@elaraai/e3-ui": "1.0.69",
+    "@elaraai/east": "1.0.69",
+    "@elaraai/east-ui": "1.0.69",
+    "@elaraai/east-ui-components": "1.0.69"
   },
   "dependencies": {
     "@emotion/react": "^11.14.0",
@@ -87,12 +87,12 @@
     "vite": "^6.0.0",
     "vite-plugin-dts": "^4.3.0",
     "vitest": "^4.0.14",
-    "@elaraai/e3-api-client": "1.0.67",
-    "@elaraai/e3-types": "1.0.67",
-    "@elaraai/east": "1.0.67",
-    "@elaraai/e3-ui": "1.0.67",
-    "@elaraai/east-ui": "1.0.67",
-    "@elaraai/east-ui-components": "1.0.67"
+    "@elaraai/e3-api-client": "1.0.69",
+    "@elaraai/e3-ui": "1.0.69",
+    "@elaraai/east": "1.0.69",
+    "@elaraai/e3-types": "1.0.69",
+    "@elaraai/east-ui": "1.0.69",
+    "@elaraai/east-ui-components": "1.0.69"
   },
   "repository": {
     "type": "git",

package/dist/components/DatasetKeySearch.d.ts

@@ -1,84 +0,0 @@
-import { EastTypeValue } from '@elaraai/east';
-/** Where a query landed in the collection's canonical key order. */
-export interface DatasetKeyMatchRange {
-    /** Whether any row matched. */
-    found: boolean;
-    /** First matched row (for a miss, the query's insertion row). */
-    row: number;
-    /** Number of matched rows. */
-    count: number;
-}
-/**
- * A key query in wire form: a whole-key `.east` literal (`key`), a String
- * prefix (`prefix`), or — for struct keys — exact leading-field literals
- * (`fields`, declaration order) optionally followed by a `prefix` on the
- * next (String) field. Every form addresses one contiguous row range in
- * the canonical key order.
- */
-export type DatasetKeyQuery = {
-    key: string;
-} | {
-    prefix: string;
-} | {
-    fields: string[];
-    prefix?: string;
-};
-export interface DatasetKeySearchProps {
-    /** The searched collection's Dict key / Set element type. */
-    keyType: EastTypeValue;
-    /** Locates a query; literals are canonical `.east` text of
-     *  already-validated values. */
-    onFind: (query: DatasetKeyQuery) => Promise<DatasetKeyMatchRange>;
-    /** Labels rows `[row, row + limit)` for the popup, in row order. */
-    onListRange: (row: number, limit: number) => Promise<string[]>;
-    /** Jumps the host tree to a global root row. */
-    onJump: (row: number) => void;
-    /** Clears the host's jump (and its held row highlight) when the query
-     *  is cleared. */
-    onClear?: (() => void) | undefined;
-}
-/** A parsed search input: a wire query, or the hint to show instead. */
-export type ParsedKeyInput = {
-    kind: 'query';
-    query: DatasetKeyQuery;
-} | {
-    kind: 'hint';
-    hint: string;
-};
-/**
- * Turns typed search text into a wire query, or a hint when it cannot
- * parse. Struct keys: `(` opens a whole-key `.east` literal; otherwise
- * comma-separated leading field values — exact for all but the last
- * segment (unquoted String segments need no quotes), the last a prefix on
- * a String field or an exact value otherwise, and a trailing comma
- * narrows to the leading exact fields.
- *
- * @param keyType - the collection's Dict key / Set element type
- * @param text - the raw search input
- * @returns the query to send, or the hint to display
- */
-export declare function parseKeyInput(keyType: EastTypeValue, text: string): ParsedKeyInput;
-/**
- * Builds the monotone lower/upper row predicates of a RANGE query over
- * keys in canonical East order — the client-side mirror of the server's
- * fence-search predicates, for inline (already-decoded) previews. The
- * range is `[first row where lower holds, first row where upper holds)`.
- *
- * @param keyType - the collection's Dict key / Set element type
- * @param query - the wire query
- * @returns the predicate pair, or `null` for a whole-key literal query
- *   (an exact lookup, not a range)
- */
-export declare function keyRangePredicates(keyType: EastTypeValue, query: DatasetKeyQuery): {
-    lower: (k: unknown) => boolean;
-    upper: (k: unknown) => boolean;
-} | null;
-/**
- * Renders the dataset key search control.
- *
- * @param props - see {@link DatasetKeySearchProps}
- * @returns the search combobox with its match count, range navigation and
- *   clear affordance
- */
-export declare const DatasetKeySearch: import('react').NamedExoticComponent<DatasetKeySearchProps>;
-//# sourceMappingURL=DatasetKeySearch.d.ts.map

package/dist/components/DatasetKeySearch.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"DatasetKeySearch.d.ts","sourceRoot":"","sources":["../../src/components/DatasetKeySearch.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAoCH,OAAO,EAAmE,KAAK,aAAa,EAAE,MAAM,eAAe,CAAC;AAQpH,oEAAoE;AACpE,MAAM,WAAW,oBAAoB;IACjC,+BAA+B;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,iEAAiE;IACjE,GAAG,EAAE,MAAM,CAAC;IACZ,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;GAMG;AACH,MAAM,MAAM,eAAe,GACrB;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,GACf;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAClB;IAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5C,MAAM,WAAW,qBAAqB;IAClC,6DAA6D;IAC7D,OAAO,EAAE,aAAa,CAAC;IACvB;oCACgC;IAChC,MAAM,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAClE,oEAAoE;IACpE,WAAW,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC/D,gDAAgD;IAChD,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9B;sBACkB;IAClB,OAAO,CAAC,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAC;CACtC;AAwDD,wEAAwE;AACxE,MAAM,MAAM,cAAc,GACpB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,eAAe,CAAA;CAAE,GACzC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAErC;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,GAAG,cAAc,CA2ClF;AAKD;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,eAAe,GAC3E;IAAE,KAAK,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC;IAAC,KAAK,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,OAAO,CAAA;CAAE,GAClE,IAAI,CAgDT;AAED;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,6DA0J3B,CAAC"}