@elaraai/e3-ui-components 1.0.60 → 1.0.62

package/dist/components/DatasetKeySearch.d.ts

@@ -0,0 +1,84 @@
+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

@@ -0,0 +1 @@
+{"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"}

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

@@ -1 +1 @@
-{"version":3,"file":"DatasetPreview.d.ts","sourceRoot":"","sources":["../../src/components/DatasetPreview.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAqBH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAkB7D,MAAM,WAAW,mBAAmB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,mDAAmD;IACnD,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,wEAAwE;IACxE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;+EAC2E;IAC3E,QAAQ,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,+DAA+D;AAC/D,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIhD;AAED,oFAAoF;AACpF,wBAAgB,cAAc,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;IAAE,OAAO,EAAE,MAAM,IAAI,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,2CAYzF;AAED,eAAO,MAAM,cAAc,2DAiJzB,CAAC"}
+{"version":3,"file":"DatasetPreview.d.ts","sourceRoot":"","sources":["../../src/components/DatasetPreview.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAqBH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAmB7D,MAAM,WAAW,mBAAmB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,mDAAmD;IACnD,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,wEAAwE;IACxE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;+EAC2E;IAC3E,QAAQ,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,+DAA+D;AAC/D,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIhD;AAED,oFAAoF;AACpF,wBAAgB,cAAc,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;IAAE,OAAO,EAAE,MAAM,IAAI,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,2CAYzF;AAED,eAAO,MAAM,cAAc,2DAoMzB,CAAC"}

package/dist/components/PagedDatasetPreview.d.ts

@@ -1,5 +1,8 @@
 import { RequestOptions } from '@elaraai/e3-api-client';
 import { EastTypeValue } from '@elaraai/east';
+/** Drops loaded pages far from the window `[firstPage, lastPage]`, keeping
+ *  the window itself and then the nearest pages up to the retention cap. */
+export declare function pruneRetainedPages<T>(pages: ReadonlyMap<number, T>, firstPage: number, lastPage: number, max: number): ReadonlyMap<number, T>;
 export interface PagedDatasetPreviewProps {
     apiUrl: string;
     repo: string;

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

@@ -1 +1 @@
-{"version":3,"file":"PagedDatasetPreview.d.ts","sourceRoot":"","sources":["../../src/components/PagedDatasetPreview.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAqBH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAwC,KAAK,aAAa,EAAE,MAAM,eAAe,CAAC;AAezF,MAAM,WAAW,wBAAwB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,wDAAwD;IACxD,IAAI,EAAE,aAAa,CAAC;IACpB,wEAAwE;IACxE,IAAI,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,oEAAoE;IACpE,UAAU,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC;;;6DAGyD;IACzD,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;CAC7B;AAiCD,eAAO,MAAM,mBAAmB,gEAyIgH,CAAC"}
+{"version":3,"file":"PagedDatasetPreview.d.ts","sourceRoot":"","sources":["../../src/components/PagedDatasetPreview.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAqBH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAwC,KAAK,aAAa,EAAE,MAAM,eAAe,CAAC;AAyBzF;4EAC4E;AAC5E,wBAAgB,kBAAkB,CAAC,CAAC,EAChC,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC,EAC7B,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,GACZ,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC,CASxB;AAED,MAAM,WAAW,wBAAwB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,wDAAwD;IACxD,IAAI,EAAE,aAAa,CAAC;IACpB,wEAAwE;IACxE,IAAI,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,oEAAoE;IACpE,UAAU,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC;;;6DAGyD;IACzD,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;CAC7B;AAiCD,eAAO,MAAM,mBAAmB,gEAwLgH,CAAC"}