@elaraai/e3-ui-components 1.0.61 → 1.0.63

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

package/dist/index.cjs

@@ -64006,6 +64006,271 @@ class ErrorBoundary extends React.Component {
     return this.props.children;
   }
 }
+const FIND_DEBOUNCE_MS = 250;
+const POPUP_LIMIT = 20;
+function structFields(keyType) {
+  if (keyType.type !== "Struct") return null;
+  const fields = keyType.value;
+  return fields.length > 0 ? fields : null;
+}
+function splitTopLevel(text) {
+  const parts = [];
+  let current = "";
+  let inString = false;
+  let depth = 0;
+  for (let i = 0; i < text.length; i++) {
+    const ch = text[i];
+    if (inString) {
+      current += ch;
+      if (ch === "\\" && i + 1 < text.length) {
+        current += text[i + 1];
+        i++;
+      } else if (ch === '"') {
+        inString = false;
+      }
+      continue;
+    }
+    if (ch === '"') {
+      inString = true;
+      current += ch;
+    } else if (ch === "(" || ch === "[" || ch === "{") {
+      depth++;
+      current += ch;
+    } else if (ch === ")" || ch === "]" || ch === "}") {
+      depth--;
+      current += ch;
+    } else if (ch === "," && depth === 0) {
+      parts.push(current);
+      current = "";
+    } else {
+      current += ch;
+    }
+  }
+  parts.push(current);
+  return parts;
+}
+function keySignature(keyType) {
+  const fields = structFields(keyType);
+  if (fields === null) return keyType.type;
+  return `(${fields.map((f2) => `${f2.name}: ${f2.type.type}`).join(", ")})`;
+}
+function parseKeyInput(keyType, text) {
+  const fields = structFields(keyType);
+  if (fields === null) {
+    if (keyType.type === "String") return { kind: "query", query: { prefix: text } };
+    const parsed = east.parseFor(keyType)(text);
+    if (!parsed.success) return { kind: "hint", hint: `Key is ${keyType.type}` };
+    return { kind: "query", query: { key: east.printFor(keyType)(parsed.value) } };
+  }
+  if (text.trimStart().startsWith("(")) {
+    const parsed = east.parseFor(keyType)(text);
+    if (!parsed.success) return { kind: "hint", hint: `Key is ${keySignature(keyType)}` };
+    return { kind: "query", query: { key: east.printFor(keyType)(parsed.value) } };
+  }
+  const segments = splitTopLevel(text);
+  if (segments.length > fields.length) {
+    return { kind: "hint", hint: `Key is ${keySignature(keyType)}` };
+  }
+  const exact = [];
+  for (let i = 0; i < segments.length; i++) {
+    const field = fields[i];
+    const raw = segments[i].trim();
+    const isLast = i === segments.length - 1;
+    if (isLast && raw === "" && i > 0) {
+      return { kind: "query", query: { fields: exact } };
+    }
+    if (field.type.type === "String" && !raw.startsWith('"')) {
+      if (isLast) {
+        return exact.length === 0 ? { kind: "query", query: { prefix: raw } } : { kind: "query", query: { fields: exact, prefix: raw } };
+      }
+      exact.push(east.printFor(east.StringType)(raw));
+      continue;
+    }
+    const parsed = east.parseFor(field.type)(raw);
+    if (!parsed.success) {
+      return { kind: "hint", hint: `${field.name} is ${field.type.type} — key is ${keySignature(keyType)}` };
+    }
+    exact.push(east.printFor(field.type)(parsed.value));
+  }
+  return { kind: "query", query: { fields: exact } };
+}
+const MATCH_NOTHING = { lower: () => false, upper: () => false };
+function keyRangePredicates(keyType, query) {
+  if ("key" in query) return null;
+  if (keyType.type === "Struct") {
+    const meta3 = keyType.value;
+    const literals = "fields" in query ? query.fields : [];
+    if (literals.length > meta3.length) return MATCH_NOTHING;
+    const values = [];
+    for (let j2 = 0; j2 < literals.length; j2++) {
+      const parsed = east.parseFor(meta3[j2].type)(literals[j2]);
+      if (!parsed.success) return MATCH_NOTHING;
+      values.push(parsed.value);
+    }
+    const cmps = meta3.map((f2) => east.compareFor(f2.type));
+    const lead = (k2) => {
+      for (let j2 = 0; j2 < values.length; j2++) {
+        const c2 = cmps[j2](k2[meta3[j2].name], values[j2]);
+        if (c2 !== 0) return c2;
+      }
+      return 0;
+    };
+    const prefix22 = query.prefix;
+    if (prefix22 === void 0) {
+      return { lower: (k2) => lead(k2) >= 0, upper: (k2) => lead(k2) > 0 };
+    }
+    const prefixIdx = values.length;
+    if (prefixIdx >= meta3.length || meta3[prefixIdx].type.type !== "String") return MATCH_NOTHING;
+    const prefixName = meta3[prefixIdx].name;
+    const prefixCmp = cmps[prefixIdx];
+    return {
+      lower: (k2) => {
+        const c2 = lead(k2);
+        return c2 !== 0 ? c2 > 0 : prefixCmp(k2[prefixName], prefix22) >= 0;
+      },
+      upper: (k2) => {
+        const c2 = lead(k2);
+        if (c2 !== 0) return c2 > 0;
+        const field = k2[prefixName];
+        return prefixCmp(field, prefix22) > 0 && !field.startsWith(prefix22);
+      }
+    };
+  }
+  if (!("prefix" in query) || query.prefix === void 0 || keyType.type !== "String") return MATCH_NOTHING;
+  const prefix2 = query.prefix;
+  const cmp = east.compareFor(keyType);
+  return {
+    lower: (k2) => cmp(k2, prefix2) >= 0,
+    upper: (k2) => cmp(k2, prefix2) > 0 && !k2.startsWith(prefix2)
+  };
+}
+const DatasetKeySearch = React.memo(function DatasetKeySearch2({ keyType, onFind, onListRange, onJump, onClear }) {
+  const [range, setRange] = React.useState(null);
+  const [items, setItems] = React.useState([]);
+  const [activeIdx, setActiveIdx] = React.useState(-1);
+  const [hint, setHint] = React.useState(null);
+  const [resetSeq, setResetSeq] = React.useState(0);
+  const debounceRef = React.useRef(void 0);
+  const findSeqRef = React.useRef(0);
+  React.useEffect(() => () => clearTimeout(debounceRef.current), []);
+  const runFind = React.useCallback((query) => {
+    const seq = ++findSeqRef.current;
+    void (async () => {
+      try {
+        const result = await onFind(query);
+        if (seq !== findSeqRef.current) return;
+        setRange(result);
+        setActiveIdx(-1);
+        if (result.found) {
+          const labels = await onListRange(result.row, Math.min(POPUP_LIMIT, result.count));
+          if (seq !== findSeqRef.current) return;
+          setItems(labels.map((label, i) => ({ row: result.row + i, label })));
+        } else {
+          setItems([]);
+        }
+      } catch {
+        if (seq !== findSeqRef.current) return;
+        setRange(null);
+        setItems([]);
+      }
+    })();
+  }, [onFind, onListRange]);
+  const resetQueryState = React.useCallback(() => {
+    clearTimeout(debounceRef.current);
+    findSeqRef.current++;
+    setRange(null);
+    setItems([]);
+    setActiveIdx(-1);
+    setHint(null);
+  }, []);
+  const handleInput = React.useCallback((text) => {
+    clearTimeout(debounceRef.current);
+    if (text === "") {
+      resetQueryState();
+      onClear == null ? void 0 : onClear();
+      return;
+    }
+    const parsed = parseKeyInput(keyType, text);
+    if (parsed.kind === "hint") {
+      findSeqRef.current++;
+      setRange(null);
+      setItems([]);
+      setActiveIdx(-1);
+      setHint(parsed.hint);
+      return;
+    }
+    setHint(null);
+    debounceRef.current = setTimeout(() => runFind(parsed.query), FIND_DEBOUNCE_MS);
+  }, [keyType, runFind, resetQueryState, onClear]);
+  const clearSearch = React.useCallback(() => {
+    resetQueryState();
+    setResetSeq((s2) => s2 + 1);
+    onClear == null ? void 0 : onClear();
+  }, [resetQueryState, onClear]);
+  const commit = React.useCallback((row) => {
+    onJump(row);
+    if (range !== null) setActiveIdx(row - range.row);
+  }, [onJump, range]);
+  const step3 = React.useCallback((delta) => {
+    if (range === null || !range.found) return;
+    const next2 = Math.max(0, Math.min(range.count - 1, (activeIdx === -1 ? 0 : activeIdx) + delta));
+    commit(range.row + next2);
+  }, [range, activeIdx, commit]);
+  const onKeyDownCapture = React.useCallback((e3) => {
+    if (e3.key !== "Enter" || range === null || !range.found) return;
+    if (document.querySelector('[data-scope="combobox"][data-part="content"] [data-highlighted]') !== null) return;
+    commit(range.row + Math.max(0, activeIdx));
+  }, [range, activeIdx, commit]);
+  const placeholder = React.useMemo(() => {
+    const fields = structFields(keyType);
+    if (fields !== null) return `Search keys (${fields.map((f2) => f2.name).join(", ")})`;
+    return keyType.type === "String" ? "Search keys" : `Find key (${keyType.type})`;
+  }, [keyType]);
+  const payload = React.useMemo(() => ({
+    value: east.none,
+    items: items.map((it) => ({ value: String(it.row), label: it.label, disabled: east.none })),
+    placeholder: east.some(placeholder),
+    multiple: east.none,
+    disabled: east.none,
+    allowCustomValue: east.some(true),
+    onChange: east.some((v3) => commit(Number(v3))),
+    onChangeMultiple: east.none,
+    onInputValueChange: east.some(handleInput),
+    onOpenChange: east.none,
+    style: east.some({ size: east.some(east.variant("xs", null)), color: east.none, background: east.none, borderColor: east.none })
+  }), [items, placeholder, commit, handleInput]);
+  const status = hint !== null ? hint : range === null ? null : !range.found ? "No matches" : activeIdx === -1 ? `${range.count.toLocaleString()} ${range.count === 1 ? "match" : "matches"}` : `${(activeIdx + 1).toLocaleString()} of ${range.count.toLocaleString()}`;
+  const canStep = range !== null && range.found && range.count > 1;
+  return /* @__PURE__ */ jsxRuntime.jsxs(react.Flex, { gap: 1, align: "center", minW: "0", onKeyDownCapture, "data-part": "dataset-key-search", children: [
+    /* @__PURE__ */ jsxRuntime.jsx(react.Flex, { width: `min(${placeholder.length + 10}ch, 40rem)`, minW: "12rem", flexShrink: 1, children: /* @__PURE__ */ jsxRuntime.jsx(eastUiComponents.EastChakraCombobox, { value: payload, selectionBehavior: "preserve" }, resetSeq) }),
+    status !== null && /* @__PURE__ */ jsxRuntime.jsx(react.Text, { fontSize: "xs", color: "fg.muted", whiteSpace: "nowrap", children: status }),
+    canStep && /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
+      /* @__PURE__ */ jsxRuntime.jsx(
+        react.IconButton,
+        {
+          "aria-label": "Previous match",
+          size: "2xs",
+          variant: "ghost",
+          disabled: activeIdx <= 0,
+          onClick: () => step3(-1),
+          children: /* @__PURE__ */ jsxRuntime.jsx(FontAwesomeIcon, { icon: faChevronUp })
+        }
+      ),
+      /* @__PURE__ */ jsxRuntime.jsx(
+        react.IconButton,
+        {
+          "aria-label": "Next match",
+          size: "2xs",
+          variant: "ghost",
+          disabled: activeIdx >= range.count - 1,
+          onClick: () => step3(1),
+          children: /* @__PURE__ */ jsxRuntime.jsx(FontAwesomeIcon, { icon: faChevronDown })
+        }
+      )
+    ] }),
+    (range !== null || hint !== null) && /* @__PURE__ */ jsxRuntime.jsx(react.IconButton, { "aria-label": "Clear search", size: "2xs", variant: "ghost", onClick: clearSearch, children: /* @__PURE__ */ jsxRuntime.jsx(FontAwesomeIcon, { icon: faXmark }) })
+  ] });
+});
 function pagingDebug(...args) {
   try {
     if (typeof localStorage === "undefined") return;
@@ -64017,6 +64282,17 @@ function pagingDebug(...args) {
   console.info("[e3-paging]", ...args);
 }
 const PAGE_SIZE = 500;
+const MAX_RETAINED_PAGES = 8;
+function pruneRetainedPages(pages, firstPage, lastPage, max5) {
+  if (pages.size <= max5) return pages;
+  const distance2 = (p2) => p2 < firstPage ? firstPage - p2 : p2 > lastPage ? p2 - lastPage : 0;
+  const keep = [...pages.keys()].sort((a2, b2) => distance2(a2) - distance2(b2) || a2 - b2).slice(0, max5);
+  const kept = /* @__PURE__ */ new Map();
+  for (const p2 of keep.sort((a2, b2) => a2 - b2)) {
+    kept.set(p2, pages.get(p2));
+  }
+  return kept;
+}
 function pageRows(type, decoded, offset) {
   if (type.type === "Array") {
     const elemType2 = type.value;
@@ -64060,12 +64336,14 @@ const PagedDatasetPreview = React.memo(function PagedDatasetPreview2({
   const [totals, setTotals] = React.useState(null);
   const [loadingCount, setLoadingCount] = React.useState(0);
   const [error3, setError] = React.useState(null);
+  const [jumpRow, setJumpRow] = React.useState(void 0);
   const inflightRef = React.useRef(/* @__PURE__ */ new Set());
   React.useEffect(() => {
     pagingDebug(`reset (path=${path2}, hash=${hash2.slice(0, 8)})`);
     setPages(/* @__PURE__ */ new Map());
     setTotals(null);
     setError(null);
+    setJumpRow(void 0);
     inflightRef.current.clear();
   }, [path2, hash2]);
   const loadPage = React.useCallback((pageIdx) => {
@@ -64073,13 +64351,13 @@ const PagedDatasetPreview = React.memo(function PagedDatasetPreview2({
     inflightRef.current.add(pageIdx);
     setLoadingCount((n2) => n2 + 1);
     pagingDebug(`fetch p${pageIdx} (offset=${pageIdx * PAGE_SIZE}, limit=${PAGE_SIZE}, hash=${hash2.slice(0, 8)})`);
-    const pathParts = path2.split(".").filter(Boolean).map((v3) => east.variant("field", v3));
+    const pathParts2 = path2.split(".").filter(Boolean).map((v3) => east.variant("field", v3));
     const reqOpts = requestOptions ?? { token: null };
     queryClient.fetchQuery({
       queryKey: ["datasetPage", apiUrl, repo, workspace, path2, hash2, `p${pageIdx}`],
       // Hash-pinned: the URL is a pure function of the bytes, so any
       // HTTP cache between here and the server can hold it immutably.
-      queryFn: () => e3ApiClient.datasetGetPage(apiUrl, repo, workspace, pathParts, { offset: pageIdx * PAGE_SIZE, limit: PAGE_SIZE, hash: hash2 }, reqOpts),
+      queryFn: () => e3ApiClient.datasetGetPage(apiUrl, repo, workspace, pathParts2, { offset: pageIdx * PAGE_SIZE, limit: PAGE_SIZE, hash: hash2 }, reqOpts),
       staleTime: Infinity
       // pages of one content hash are immutable
     }).then((page) => {
@@ -64116,8 +64394,35 @@ const PagedDatasetPreview = React.memo(function PagedDatasetPreview2({
       if (!pages.has(p2)) missing.push(p2);
     }
     pagingDebug(`need rows [${startRow}, ${endRow}) → pages ${first2}..${last2}, missing=[${missing.join(",")}], inflight=[${[...inflightRef.current].join(",")}]`);
+    setPages((prev2) => pruneRetainedPages(prev2, first2, last2, MAX_RETAINED_PAGES));
     for (const p2 of missing) loadPage(p2);
   }, [pages, loadPage]);
+  const keyType = React.useMemo(() => type.type === "Dict" ? type.value.key : type.type === "Set" ? type.value : null, [type]);
+  const pathParts = React.useMemo(() => path2.split(".").filter(Boolean).map((v3) => east.variant("field", v3)), [path2]);
+  const onFindKey = React.useCallback(async (query) => {
+    const reqOpts = requestOptions ?? { token: null };
+    const queryTag = JSON.stringify(query);
+    const result = await queryClient.fetchQuery({
+      queryKey: ["datasetFind", apiUrl, repo, workspace, path2, hash2, queryTag],
+      queryFn: () => e3ApiClient.datasetFindKey(apiUrl, repo, workspace, pathParts, { ...query, hash: hash2 }, reqOpts),
+      staleTime: Infinity
+      // hash-pinned: one content hash, one answer
+    });
+    pagingDebug(`find ${queryTag}: found=${result.found} row=${result.row} count=${result.count}`);
+    return result;
+  }, [queryClient, apiUrl, repo, workspace, path2, hash2, pathParts, requestOptions]);
+  const onListRange = React.useCallback(async (row, limit2) => {
+    const reqOpts = requestOptions ?? { token: null };
+    const page = await queryClient.fetchQuery({
+      queryKey: ["datasetPage", apiUrl, repo, workspace, path2, hash2, `w${row}:${limit2}`],
+      queryFn: () => e3ApiClient.datasetGetPage(apiUrl, repo, workspace, pathParts, { offset: row, limit: limit2, hash: hash2 }, reqOpts),
+      staleTime: Infinity
+    });
+    const decoded = east.decodeBeast2For(type)(page.data);
+    const stringKeys = keyType !== null && keyType.type === "String";
+    const keys = type.type === "Dict" ? [...decoded.keys()] : [...decoded.values()];
+    return keys.map((k2) => stringKeys ? k2 : eastUi.ValueTree.keyLabel(keyType, k2));
+  }, [queryClient, apiUrl, repo, workspace, path2, hash2, pathParts, requestOptions, type, keyType]);
   const treeValue = React.useMemo(() => ({
     root: eastUi.ValueTree.materialize(type, emptyOf(type)),
     onEdit: east.none,
@@ -64130,8 +64435,9 @@ const PagedDatasetPreview = React.memo(function PagedDatasetPreview2({
     totalRows: totals.elements,
     pageSize: PAGE_SIZE,
     pages,
-    onNeedRows
-  }, [totals, pages, onNeedRows]);
+    onNeedRows,
+    scrollToRow: jumpRow
+  }, [totals, pages, onNeedRows, jumpRow]);
   if (error3 !== null) {
     if (error3 instanceof e3ApiClient.ApiError && error3.code === "dataset_too_large") {
       return /* @__PURE__ */ jsxRuntime.jsxs(react.Flex, { height: "100%", direction: "column", align: "center", justify: "center", gap: 3, p: 6, children: [
@@ -64156,6 +64462,16 @@ const PagedDatasetPreview = React.memo(function PagedDatasetPreview2({
         formatSize(totals.bytes > 0 ? totals.bytes : sizeBytes)
       ] }),
       loadingCount > 0 && /* @__PURE__ */ jsxRuntime.jsx(react.Text, { fontSize: "xs", color: "fg.muted", children: "Loading…" }),
+      keyType !== null && /* @__PURE__ */ jsxRuntime.jsx(
+        DatasetKeySearch,
+        {
+          keyType,
+          onFind: onFindKey,
+          onListRange,
+          onJump: setJumpRow,
+          onClear: () => setJumpRow(void 0)
+        }
+      ),
       /* @__PURE__ */ jsxRuntime.jsx(react.Flex, { flex: 1, justify: "flex-end", children: /* @__PURE__ */ jsxRuntime.jsx(DownloadButton, { onClick: onDownload }) })
     ] }),
     /* @__PURE__ */ jsxRuntime.jsx(react.Box, { flex: 1, minHeight: 0, overflow: "hidden", children: /* @__PURE__ */ jsxRuntime.jsx(eastUiComponents.EastChakraValueTree, { value: treeValue, storageKey: `${path2}:page`, paging }) })
@@ -64227,6 +64543,37 @@ const DatasetPreview = React.memo(function DatasetPreview2({
     await setMutation.mutateAsync({ path: treePath, data: data4 });
     await queryClient.invalidateQueries({ queryKey: ["datasetStatus", apiUrl, repo, workspace, path2] });
   }, [apiUrl, repo, workspace, path2, type, setMutation, queryClient]);
+  const keyType = React.useMemo(() => type === void 0 ? null : type.type === "Dict" ? type.value.key : type.type === "Set" ? type.value : null, [type]);
+  const inlineKeys = React.useMemo(() => decoded === void 0 || type === void 0 ? null : type.type === "Dict" ? [...decoded.keys()] : type.type === "Set" ? [...decoded.values()] : null, [type, decoded]);
+  const [jumpRow, setJumpRow] = React.useState(void 0);
+  React.useEffect(() => {
+    setJumpRow(void 0);
+  }, [decoded]);
+  const onFindInline = React.useCallback(async (query) => {
+    if (inlineKeys === null || keyType === null) return { found: false, row: 0, count: 0 };
+    const range = keyRangePredicates(keyType, query);
+    if (range === null) {
+      const parsed = east.parseFor(keyType)(query.key);
+      if (!parsed.success) return { found: false, row: 0, count: 0 };
+      const cmp = east.compareFor(keyType);
+      for (let i = 0; i < inlineKeys.length; i++) {
+        const order = cmp(inlineKeys[i], parsed.value);
+        if (order === 0) return { found: true, row: i, count: 1 };
+        if (order > 0) return { found: false, row: i, count: 0 };
+      }
+      return { found: false, row: inlineKeys.length, count: 0 };
+    }
+    let row = inlineKeys.findIndex(range.lower);
+    if (row === -1) row = inlineKeys.length;
+    let count2 = 0;
+    while (row + count2 < inlineKeys.length && !range.upper(inlineKeys[row + count2])) count2++;
+    return { found: count2 > 0, row, count: count2 };
+  }, [inlineKeys, keyType]);
+  const onListInline = React.useCallback(async (row, limit2) => {
+    if (inlineKeys === null || keyType === null) return [];
+    const stringKeys = keyType.type === "String";
+    return inlineKeys.slice(row, row + limit2).map((k2) => stringKeys ? k2 : eastUi.ValueTree.keyLabel(keyType, k2));
+  }, [inlineKeys, keyType]);
   const treeValue = React.useMemo(() => {
     if (type === void 0 || decoded === void 0) return null;
     const root2 = eastUi.ValueTree.materialize(type, decoded);
@@ -64281,14 +64628,26 @@ const DatasetPreview = React.memo(function DatasetPreview2({
   const count = type === void 0 || decoded === void 0 ? null : type.type === "Array" ? decoded.length : type.type === "Set" || type.type === "Dict" ? decoded.size : null;
   const countText = count === null ? "" : `${count.toLocaleString()} ${(type == null ? void 0 : type.type) === "Dict" ? "entries" : "items"} · `;
   return /* @__PURE__ */ jsxRuntime.jsxs(react.Flex, { direction: "column", height: "100%", overflow: "hidden", children: [
-    /* @__PURE__ */ jsxRuntime.jsxs(react.Flex, { px: 4, py: 2, justify: "flex-end", flexShrink: 0, borderBottom: "1px solid", borderColor: "border.subtle", children: [
-      /* @__PURE__ */ jsxRuntime.jsxs(react.Text, { fontSize: "xs", color: "fg.muted", mr: 2, alignSelf: "center", children: [
-        countText,
-        formatSize(sizeBytes)
-      ] }),
-      /* @__PURE__ */ jsxRuntime.jsx(DownloadButton, { onClick: download })
+    /* @__PURE__ */ jsxRuntime.jsxs(react.Flex, { px: 4, py: 2, gap: 2, align: "center", flexShrink: 0, borderBottom: "1px solid", borderColor: "border.subtle", children: [
+      keyType !== null && inlineKeys !== null && /* @__PURE__ */ jsxRuntime.jsx(
+        DatasetKeySearch,
+        {
+          keyType,
+          onFind: onFindInline,
+          onListRange: onListInline,
+          onJump: setJumpRow,
+          onClear: () => setJumpRow(void 0)
+        }
+      ),
+      /* @__PURE__ */ jsxRuntime.jsxs(react.Flex, { flex: 1, justify: "flex-end", align: "center", gap: 2, children: [
+        /* @__PURE__ */ jsxRuntime.jsxs(react.Text, { fontSize: "xs", color: "fg.muted", children: [
+          countText,
+          formatSize(sizeBytes)
+        ] }),
+        /* @__PURE__ */ jsxRuntime.jsx(DownloadButton, { onClick: download })
+      ] })
     ] }),
-    /* @__PURE__ */ jsxRuntime.jsx(react.Box, { flex: 1, minHeight: 0, overflow: "hidden", children: treeValue !== null && /* @__PURE__ */ jsxRuntime.jsx(eastUiComponents.EastChakraValueTree, { value: treeValue, storageKey: path2 ?? "value" }) })
+    /* @__PURE__ */ jsxRuntime.jsx(react.Box, { flex: 1, minHeight: 0, overflow: "hidden", children: treeValue !== null && /* @__PURE__ */ jsxRuntime.jsx(eastUiComponents.EastChakraValueTree, { value: treeValue, storageKey: path2 ?? "value", scrollToRow: jumpRow }) })
   ] });
 });
 const InputPreview = React.memo(function InputPreview2({
@@ -65279,6 +65638,7 @@ function EastValueViewer({ type, value }) {
 exports.BindPlatform = BindPlatform;
 exports.BindRuntime = BindRuntime;
 exports.DataTaskPreview = DataTaskPreview;
+exports.DatasetKeySearch = DatasetKeySearch;
 exports.DatasetPreview = DatasetPreview;
 exports.E3Provider = E3Provider;
 exports.EastChakraDecisionJournal = EastChakraDecisionJournal;