@ai-matrx/records-ui 0.101.34 → 0.101.35

package/dist/index.d.cts

@@ -6414,6 +6414,7 @@ interface EntitySourceState {
 /** A standard source's presented columns and one page of its rows, read as the person. */
 declare function useEntitySource(token: string, options?: {
     limit?: number;
+    search?: string | null;
 }): EntitySourceState;
 /** The column that names a row: the door's first of name / display_name / title / subject, else its first text column. */
 declare function entityNameColumn(columns: readonly EntityColumn[]): EntityColumn | null;
@@ -6483,11 +6484,14 @@ interface EntityTablePageProps {
     /** The board's choice column (api_name). */
     groupBy?: string | undefined;
     onOpenRecord?: ((rowId: string) => void) | undefined;
+    /** The viewer's own search, handed by the host; asked of the door. Never saved. */
+    searchOverride?: string | null | undefined;
+    onSearchChange?: ((search: string) => void) | undefined;
     /** Beside the title row's controls (the host's own). */
     actions?: ReactNode;
     className?: string | undefined;
 }
-declare function EntityTablePage({ source, presentation, pageSize, layout: opened, onLayoutChange, groupBy, onOpenRecord, actions, className, }: EntityTablePageProps): react.JSX.Element;
+declare function EntityTablePage({ source, presentation, searchOverride, onSearchChange, pageSize, layout: opened, onLayoutChange, groupBy, onOpenRecord, actions, className, }: EntityTablePageProps): react.JSX.Element;
 
 type TablePageSource = {
     kind: "table";

package/dist/index.d.ts

@@ -6414,6 +6414,7 @@ interface EntitySourceState {
 /** A standard source's presented columns and one page of its rows, read as the person. */
 declare function useEntitySource(token: string, options?: {
     limit?: number;
+    search?: string | null;
 }): EntitySourceState;
 /** The column that names a row: the door's first of name / display_name / title / subject, else its first text column. */
 declare function entityNameColumn(columns: readonly EntityColumn[]): EntityColumn | null;
@@ -6483,11 +6484,14 @@ interface EntityTablePageProps {
     /** The board's choice column (api_name). */
     groupBy?: string | undefined;
     onOpenRecord?: ((rowId: string) => void) | undefined;
+    /** The viewer's own search, handed by the host; asked of the door. Never saved. */
+    searchOverride?: string | null | undefined;
+    onSearchChange?: ((search: string) => void) | undefined;
     /** Beside the title row's controls (the host's own). */
     actions?: ReactNode;
     className?: string | undefined;
 }
-declare function EntityTablePage({ source, presentation, pageSize, layout: opened, onLayoutChange, groupBy, onOpenRecord, actions, className, }: EntityTablePageProps): react.JSX.Element;
+declare function EntityTablePage({ source, presentation, searchOverride, onSearchChange, pageSize, layout: opened, onLayoutChange, groupBy, onOpenRecord, actions, className, }: EntityTablePageProps): react.JSX.Element;
 
 type TablePageSource = {
     kind: "table";

package/dist/index.js

@@ -23169,8 +23169,10 @@ import { jsx as jsx69 } from "react/jsx-runtime";
 function useEntitySource(token, options = {}) {
   const client = useRecordsClient38();
   const limit = options.limit ?? 50;
+  const search = (options.search ?? "").trim();
   const [tick, setTick] = useState60(0);
   const held = useRef30(0);
+  const askedSearch = useRef30("");
   const [loadingMore, setLoadingMore] = useState60(false);
   const [state, setState] = useState60({
     label: null,
@@ -23183,8 +23185,12 @@ function useEntitySource(token, options = {}) {
   });
   useEffect48(() => {
     let cancelled = false;
+    if (askedSearch.current !== search) {
+      askedSearch.current = search;
+      held.current = 0;
+    }
     const source = { kind: "entity", token };
-    void Promise.all([client.drillDescribe({ source }), client.drillRows({ source, limit: Math.max(limit, held.current) })]).then(
+    void Promise.all([client.drillDescribe({ source }), client.drillRows({ source, limit: Math.max(limit, held.current), ...search ? { search } : {} })]).then(
       ([def, page]) => {
         if (cancelled) return;
         if (!def.ok) return setState((s) => ({ ...s, loading: false, error: refusalSentence(def.error) || "This table could not be read." }));
@@ -23210,7 +23216,7 @@ function useEntitySource(token, options = {}) {
     return () => {
       cancelled = true;
     };
-  }, [client, token, limit, tick]);
+  }, [client, token, limit, tick, search]);
   const reload = useCallback26(() => setTick((t) => t + 1), []);
   const write = useCallback26(
     async (rowId, apiName, value) => {
@@ -23240,7 +23246,7 @@ function useEntitySource(token, options = {}) {
     if (loadingMore) return;
     setLoadingMore(true);
     const source = { kind: "entity", token };
-    const next = await client.drillRows({ source, limit, offset: held.current });
+    const next = await client.drillRows({ source, limit, offset: held.current, ...search ? { search } : {} });
     setLoadingMore(false);
     if (!next.ok) return;
     const more = next.data.rows ?? [];
@@ -23249,7 +23255,7 @@ function useEntitySource(token, options = {}) {
       const seen = new Set(s.rows.map((r) => r.id));
       return { ...s, rows: [...s.rows, ...more.filter((r) => !seen.has(r.id))] };
     });
-  }, [client, token, limit, loadingMore]);
+  }, [client, token, limit, loadingMore, search]);
   const hasMore = !state.loading && state.total > state.rows.length;
   return { ...state, write, create, reload, loadMore, hasMore, loadingMore };
 }
@@ -47201,6 +47207,7 @@ function usePublicReadOnly(client, organizationId, tableId, table, rights) {
 }
 
 // src/entityViews.tsx
+import { TapTargetSearchGroup as TapTargetSearchGroup2, TooltipProvider } from "@ai-matrx/design-system";
 import { MatrxTableCardShowMore as MatrxTableCardShowMore2 } from "@ai-matrx/design-system/data-table";
 import { useEffect as useEffect110, useMemo as useMemo75, useState as useState132 } from "react";
 import { Button as Button106, ErrorBox as ErrorBox9, Input as Input12, cn as cn93 } from "@ai-matrx/design-system";
@@ -47345,6 +47352,8 @@ function EntityChartBlock({ source, kind, by, measure, title, where, organizatio
 function EntityTablePage({
   source,
   presentation = "page",
+  searchOverride,
+  onSearchChange,
   pageSize = presentation === "embedded" ? EMBEDDED_PAGE_SIZE : 100,
   layout: opened = "grid",
   onLayoutChange,
@@ -47353,7 +47362,9 @@ function EntityTablePage({
   actions,
   className
 }) {
-  const entity = useEntitySource(source.token, { limit: pageSize });
+  const [typed2, setTyped] = useState132("");
+  const term = searchOverride ?? typed2;
+  const entity = useEntitySource(source.token, { limit: pageSize, search: term });
   const [layout, setLayout] = useState132(opened);
   useEffect110(() => setLayout(opened), [opened]);
   const choose = (next) => {
@@ -47430,6 +47441,17 @@ function EntityTablePage({
     ] }) : null,
     addRefused ? /* @__PURE__ */ jsx153(ErrorBox9, { className: "rounded border border-destructive/40 px-1.5 py-1 text-xs text-destructive", message: addRefused, operation: "Add a row", origin: "records-ui/entityViews" }) : null,
     entity.error ? /* @__PURE__ */ jsx153("p", { className: "px-1 py-3 text-xs text-muted-foreground", children: `This table could not be read: ${entity.error}` }) : layout === "board" && boardable ? /* @__PURE__ */ jsx153(EntityBoard, { entity, groupBy, onOpenRecord }) : /* @__PURE__ */ jsxs141(Fragment62, { children: [
+      presentation === "embedded" ? /* @__PURE__ */ jsx153("div", { className: "flex min-w-0 items-center justify-end", "data-records-entity-search": "", children: /* @__PURE__ */ jsx153(TooltipProvider, { children: /* @__PURE__ */ jsx153(
+        TapTargetSearchGroup2,
+        {
+          placeholder: "Search",
+          value: term,
+          onValueChange: (next) => {
+            setTyped(next);
+            onSearchChange?.(next);
+          }
+        }
+      ) }) }) : null,
       /* @__PURE__ */ jsx153(EntityGrid, { entity, pageSize, embedded: presentation === "embedded", ...drill ? { drill } : {} }),
       presentation === "embedded" && entity.hasMore ? /* @__PURE__ */ jsx153(
         MatrxTableCardShowMore2,
@@ -47456,6 +47478,8 @@ function TablePage2(props) {
       source,
       ...rest.presentation ? { presentation: rest.presentation } : {},
       ...rest.pageSize ? { pageSize: rest.pageSize } : {},
+      ...rest.searchOverride !== void 0 ? { searchOverride: rest.searchOverride } : {},
+      ...rest.onSearchChange ? { onSearchChange: rest.onSearchChange } : {},
       ...layout ? { layout } : {},
       ...onLayoutChange ? { onLayoutChange } : {},
       ...groupBy ? { groupBy } : {},