@ai-matrx/records-ui 0.101.31 → 0.101.34

package/dist/index.d.cts

@@ -588,6 +588,12 @@ interface ReferenceChipRef {
     icon?: string | null | undefined;
 }
 interface RecordsUiHost {
+    /**
+     * Draws an icon kept as a NAME ("Briefcase" — how the store keeps an icon a person picked from the
+     * icon list). A relation cell in an embedded table wears its record's icon; an emoji is drawn as
+     * text and a name only through this port. Unbound (or `null` back), the page glyph stands in.
+     */
+    renderIcon?: ((name: string) => ReactNode) | undefined;
     /**
      * TEMPORARY (one-grid merge, steps 5-8). Which table grid draws: `classic` — the default Grid
      * as it shipped in 0.86; `merged` — the same grid with the older /data grid's control layer on
@@ -2247,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;
     /**
@@ -2327,6 +2342,11 @@ interface ViewReading {
  */
 type LabelLookup = ((field: Field$1, id: string) => string | null) & {
     archived?: (field: Field$1, id: string) => boolean;
+    /** The linked record's own icon, and its table's icon for one that has none (same call as the words). */
+    icons?: (field: Field$1, id: string) => {
+        icon: string | null;
+        tableIcon: string | null;
+    } | undefined;
 };
 /**
  * HOW LONG A CELL MAY SAY "Loading…" BEFORE IT HAS TO SAY WHAT IT IS WAITING
@@ -3899,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;
@@ -3930,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 {
@@ -5974,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;
     /**
@@ -6372,6 +6402,14 @@ 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?: {
@@ -6382,10 +6420,11 @@ declare function entityNameColumn(columns: readonly EntityColumn[]): EntityColum
 /** 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. */

package/dist/index.d.ts

@@ -588,6 +588,12 @@ interface ReferenceChipRef {
     icon?: string | null | undefined;
 }
 interface RecordsUiHost {
+    /**
+     * Draws an icon kept as a NAME ("Briefcase" — how the store keeps an icon a person picked from the
+     * icon list). A relation cell in an embedded table wears its record's icon; an emoji is drawn as
+     * text and a name only through this port. Unbound (or `null` back), the page glyph stands in.
+     */
+    renderIcon?: ((name: string) => ReactNode) | undefined;
     /**
      * TEMPORARY (one-grid merge, steps 5-8). Which table grid draws: `classic` — the default Grid
      * as it shipped in 0.86; `merged` — the same grid with the older /data grid's control layer on
@@ -2247,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;
     /**
@@ -2327,6 +2342,11 @@ interface ViewReading {
  */
 type LabelLookup = ((field: Field$1, id: string) => string | null) & {
     archived?: (field: Field$1, id: string) => boolean;
+    /** The linked record's own icon, and its table's icon for one that has none (same call as the words). */
+    icons?: (field: Field$1, id: string) => {
+        icon: string | null;
+        tableIcon: string | null;
+    } | undefined;
 };
 /**
  * HOW LONG A CELL MAY SAY "Loading…" BEFORE IT HAS TO SAY WHAT IT IS WAITING
@@ -3899,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;
@@ -3930,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 {
@@ -5974,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;
     /**
@@ -6372,6 +6402,14 @@ 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?: {
@@ -6382,10 +6420,11 @@ declare function entityNameColumn(columns: readonly EntityColumn[]): EntityColum
 /** 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. */