@ai-matrx/records-ui 0.101.33 → 0.101.35

package/dist/index.d.cts

@@ -2253,6 +2253,15 @@ interface GridProps {
         field: string;
         direction: "asc" | "desc";
     } | null | undefined;
+    /**
+     * THE VIEWER'S OWN SEARCH, handed by the host (CHAIR-EMBEDDED-FIDELITY 15), the way `sortOverride`
+     * hands a sort: it filters rows for this viewer only, is never written to the view, and is asked of
+     * the store's own search (`custom.read_records_page`'s `search`), never a filter over loaded rows.
+     * `null` / `""` clears it. Left out, an embedded grid's own magnifier owns the term.
+     */
+    searchOverride?: string | null | undefined;
+    /** Every change of the term, from the embedded magnifier or the override (a controlled host's echo). */
+    onSearchChange?: ((search: string) => void) | undefined;
     /** The new-row line's words ("New page"). Default "Add row". */
     newRowLabel?: string | undefined;
     /**
@@ -3910,6 +3919,9 @@ interface ViewSwitcherProps {
         field: string;
         direction: "asc" | "desc";
     } | null | undefined;
+    /** The viewer's own search (`GridProps.searchOverride`): this viewer only, never saved, asked of the store. */
+    searchOverride?: string | null | undefined;
+    onSearchChange?: ((search: string) => void) | undefined;
     /** The grid's new-row line words (`GridProps.newRowLabel`). */
     newRowLabel?: string | undefined;
     className?: string | undefined;
@@ -3941,7 +3953,7 @@ declare function useViewRecords(view: SavedViewSpec, pageSize?: number, filter?:
      */
     membership: string;
 };
-declare function ViewSwitcher({ view, onLayoutChange, onViewChange, onOpenRecord, openRecordId, onCloseRecord, onMoved, onNewRecordForm, onAskWhoChanged, pageSize: pageSizeAsked, titleField, filter, onClearFilter, hostLayout, onHostLayoutChange, chooser, openExport, viewId, onOrderPlaced, footer, embedded, sortOverride, newRowLabel, className, }: ViewSwitcherProps): react.JSX.Element;
+declare function ViewSwitcher({ view, onLayoutChange, onViewChange, onOpenRecord, openRecordId, onCloseRecord, onMoved, onNewRecordForm, onAskWhoChanged, pageSize: pageSizeAsked, titleField, filter, onClearFilter, hostLayout, onHostLayoutChange, chooser, openExport, viewId, onOrderPlaced, footer, embedded, sortOverride, searchOverride, onSearchChange, newRowLabel, className, }: ViewSwitcherProps): react.JSX.Element;
 
 type CalendarMode = "month" | "week" | "day" | "list";
 interface CalendarViewProps {
@@ -5985,6 +5997,13 @@ interface TablePageProps$1 {
     presentation?: "page" | "embedded" | undefined;
     /** The new-row line's words in an embedded table ("New page"). */
     newRowLabel?: string | undefined;
+    /**
+     * The viewer's own search, handed by the host (the `sortOverride` model): filters rows for this
+     * viewer only, is never saved to the view, and is asked of the store's search. An embedded table
+     * also draws its own magnifier (`onSearchChange` hears it).
+     */
+    searchOverride?: string | null | undefined;
+    onSearchChange?: ((search: string) => void) | undefined;
     /** Rows per page for every layout. */
     pageSize?: number | undefined;
     /**
@@ -6383,20 +6402,30 @@ interface EntitySourceState {
         refused: string;
     }>;
     reload: () => void;
+    /**
+     * "SHOW MORE" (CHAIR-EMBEDDED-FIDELITY 16): the rows the door has not given yet are asked as the
+     * NEXT page (`limit` = one page, `offset` = rows held) and appended — never the whole source.
+     */
+    loadMore: () => Promise<void>;
+    /** The door counts more rows than are held. */
+    hasMore: boolean;
+    loadingMore: boolean;
 }
 /** 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;
 /** The columns of the one table, from the door's presented columns. */
 declare function entityTableColumns(columns: readonly EntityColumn[]): MatrxColumnDef$1<EntityRow>[];
 /** A standard source in the one table. */
-declare function EntityGrid({ entity, pageSize, drill }: {
+declare function EntityGrid({ entity, pageSize, drill, embedded }: {
     entity: EntitySourceState;
     pageSize?: number;
     drill?: MatrxDataTableDrillConfig;
+    embedded?: boolean;
 }): react.JSX.Element;
 
 /** A standard source, by its registry token. */
@@ -6455,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

@@ -2253,6 +2253,15 @@ interface GridProps {
         field: string;
         direction: "asc" | "desc";
     } | null | undefined;
+    /**
+     * THE VIEWER'S OWN SEARCH, handed by the host (CHAIR-EMBEDDED-FIDELITY 15), the way `sortOverride`
+     * hands a sort: it filters rows for this viewer only, is never written to the view, and is asked of
+     * the store's own search (`custom.read_records_page`'s `search`), never a filter over loaded rows.
+     * `null` / `""` clears it. Left out, an embedded grid's own magnifier owns the term.
+     */
+    searchOverride?: string | null | undefined;
+    /** Every change of the term, from the embedded magnifier or the override (a controlled host's echo). */
+    onSearchChange?: ((search: string) => void) | undefined;
     /** The new-row line's words ("New page"). Default "Add row". */
     newRowLabel?: string | undefined;
     /**
@@ -3910,6 +3919,9 @@ interface ViewSwitcherProps {
         field: string;
         direction: "asc" | "desc";
     } | null | undefined;
+    /** The viewer's own search (`GridProps.searchOverride`): this viewer only, never saved, asked of the store. */
+    searchOverride?: string | null | undefined;
+    onSearchChange?: ((search: string) => void) | undefined;
     /** The grid's new-row line words (`GridProps.newRowLabel`). */
     newRowLabel?: string | undefined;
     className?: string | undefined;
@@ -3941,7 +3953,7 @@ declare function useViewRecords(view: SavedViewSpec, pageSize?: number, filter?:
      */
     membership: string;
 };
-declare function ViewSwitcher({ view, onLayoutChange, onViewChange, onOpenRecord, openRecordId, onCloseRecord, onMoved, onNewRecordForm, onAskWhoChanged, pageSize: pageSizeAsked, titleField, filter, onClearFilter, hostLayout, onHostLayoutChange, chooser, openExport, viewId, onOrderPlaced, footer, embedded, sortOverride, newRowLabel, className, }: ViewSwitcherProps): react.JSX.Element;
+declare function ViewSwitcher({ view, onLayoutChange, onViewChange, onOpenRecord, openRecordId, onCloseRecord, onMoved, onNewRecordForm, onAskWhoChanged, pageSize: pageSizeAsked, titleField, filter, onClearFilter, hostLayout, onHostLayoutChange, chooser, openExport, viewId, onOrderPlaced, footer, embedded, sortOverride, searchOverride, onSearchChange, newRowLabel, className, }: ViewSwitcherProps): react.JSX.Element;
 
 type CalendarMode = "month" | "week" | "day" | "list";
 interface CalendarViewProps {
@@ -5985,6 +5997,13 @@ interface TablePageProps$1 {
     presentation?: "page" | "embedded" | undefined;
     /** The new-row line's words in an embedded table ("New page"). */
     newRowLabel?: string | undefined;
+    /**
+     * The viewer's own search, handed by the host (the `sortOverride` model): filters rows for this
+     * viewer only, is never saved to the view, and is asked of the store's search. An embedded table
+     * also draws its own magnifier (`onSearchChange` hears it).
+     */
+    searchOverride?: string | null | undefined;
+    onSearchChange?: ((search: string) => void) | undefined;
     /** Rows per page for every layout. */
     pageSize?: number | undefined;
     /**
@@ -6383,20 +6402,30 @@ interface EntitySourceState {
         refused: string;
     }>;
     reload: () => void;
+    /**
+     * "SHOW MORE" (CHAIR-EMBEDDED-FIDELITY 16): the rows the door has not given yet are asked as the
+     * NEXT page (`limit` = one page, `offset` = rows held) and appended — never the whole source.
+     */
+    loadMore: () => Promise<void>;
+    /** The door counts more rows than are held. */
+    hasMore: boolean;
+    loadingMore: boolean;
 }
 /** 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;
 /** The columns of the one table, from the door's presented columns. */
 declare function entityTableColumns(columns: readonly EntityColumn[]): MatrxColumnDef$1<EntityRow>[];
 /** A standard source in the one table. */
-declare function EntityGrid({ entity, pageSize, drill }: {
+declare function EntityGrid({ entity, pageSize, drill, embedded }: {
     entity: EntitySourceState;
     pageSize?: number;
     drill?: MatrxDataTableDrillConfig;
+    embedded?: boolean;
 }): react.JSX.Element;
 
 /** A standard source, by its registry token. */
@@ -6455,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";