@ai-matrx/records-ui 0.115.74 → 0.115.75

package/dist/index.d.cts

@@ -2059,6 +2059,8 @@ interface GridProps {
      * Space only opens.
      */
     onCloseRecord?: (() => void) | undefined;
+    /** The ids the grid is showing, in the order it shows them (AT-RECORD: previous / next in the expanded record). */
+    onRowsShown?: ((ids: Uuid$1[]) => void) | undefined;
     /** SCR-2. Called when an admin clicks the "+" at the end of the headers. */
     onAddField?: (() => void) | undefined;
     /**
@@ -3835,6 +3837,8 @@ interface ViewSwitcherProps {
     openRecordId?: Uuid$1 | null | undefined;
     /** Put the record panel away (Escape, or Space on the open row): `Grid.onCloseRecord`. */
     onCloseRecord?: (() => void) | undefined;
+    /** The ids the grid shows, in its order (`Grid.onRowsShown`). */
+    onRowsShown?: ((ids: Uuid$1[]) => void) | undefined;
     /**
      * Called after a card moves between columns, so the host re-reads the rows it owns. A
      * board that moved a card and left the row list alone would show the card in two places
@@ -3942,7 +3946,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, chooser, viewId, onOrderPlaced, footer, embedded, sortOverride, searchOverride, onSearchChange, searchBox, hideRefusedRowActions, newRowLabel, className, }: ViewSwitcherProps): react.JSX.Element;
+declare function ViewSwitcher({ view, onLayoutChange, onViewChange, onOpenRecord, openRecordId, onCloseRecord, onRowsShown, onMoved, onNewRecordForm, onAskWhoChanged, pageSize: pageSizeAsked, titleField, filter, onClearFilter, chooser, viewId, onOrderPlaced, footer, embedded, sortOverride, searchOverride, onSearchChange, searchBox, hideRefusedRowActions, newRowLabel, className, }: ViewSwitcherProps): react.JSX.Element;
 
 /** The host app's saved zone (IANA). `null` / junk clears it: the device zone applies. */
 declare function setPersonTimeZone(next: string | null | undefined): void;
@@ -5906,6 +5910,12 @@ interface TablePageProps$1 {
      * Absent, nothing changes: the page opens exactly as it did.
      */
     activeRecordId?: Uuid | null | undefined;
+    /**
+     * THE RECORD IN THE ADDRESS (AT-RECORD). Told whenever the open record changes (null: shut), so the
+     * host can write `?record=` — pushed when one opens, replaced when she steps to the next, so Back
+     * closes it and a pasted link reopens it. Read back through `activeRecordId`.
+     */
+    onRecordChange?: ((recordId: Uuid | null, how: "open" | "step" | "close") => void) | undefined;
     /**
      * WHICH VIEW THE ADDRESS NAMES — `grid`, `kanban`, `calendar`, `gallery` or
      * `dashboards`, exactly as the host read it out of `?view=`.
@@ -6830,6 +6840,13 @@ interface ViewActionHost {
 /** `whyNot`: the person's reason they may not change this table's views, or null when they may. */
 declare function viewActions(whyNot: string | null, host: ViewActionHost, locked?: boolean, personal?: boolean): ObjectAction[];
 
+interface RecordNeighbors {
+    index: number;
+    total: number;
+    previous: string | null;
+    next: string | null;
+}
+
 interface RecordPanelProps {
     tableId: Uuid$1;
     recordId: Uuid$1;
@@ -6842,8 +6859,14 @@ interface RecordPanelProps {
     onAskAboutField?: ((fieldKey: string) => void) | undefined;
     /** Drawn as the record's own page (no "Open" link to itself). */
     onPage?: boolean | undefined;
-}
-declare function RecordPanel({ tableId, recordId, onClose, onAskAboutField, onPage }: RecordPanelProps): react.JSX.Element;
+    /** Where this record sits in the view the grid shows, and how to move to another (AT-RECORD). */
+    neighbors?: RecordNeighbors | null | undefined;
+    onStep?: ((recordId: Uuid$1) => void) | undefined;
+    /** Drawn over the grid, wide (true) or beside it; `onToggleExpand` draws the control. */
+    expanded?: boolean | undefined;
+    onToggleExpand?: (() => void) | undefined;
+}
+declare function RecordPanel({ tableId, recordId, onClose, onAskAboutField, onPage, neighbors, onStep, expanded, onToggleExpand }: RecordPanelProps): react.JSX.Element;
 
 /**
  * The column a record page writes its body in: the formatted-text column NAMED like a page's body

package/dist/index.d.ts

@@ -2059,6 +2059,8 @@ interface GridProps {
      * Space only opens.
      */
     onCloseRecord?: (() => void) | undefined;
+    /** The ids the grid is showing, in the order it shows them (AT-RECORD: previous / next in the expanded record). */
+    onRowsShown?: ((ids: Uuid$1[]) => void) | undefined;
     /** SCR-2. Called when an admin clicks the "+" at the end of the headers. */
     onAddField?: (() => void) | undefined;
     /**
@@ -3835,6 +3837,8 @@ interface ViewSwitcherProps {
     openRecordId?: Uuid$1 | null | undefined;
     /** Put the record panel away (Escape, or Space on the open row): `Grid.onCloseRecord`. */
     onCloseRecord?: (() => void) | undefined;
+    /** The ids the grid shows, in its order (`Grid.onRowsShown`). */
+    onRowsShown?: ((ids: Uuid$1[]) => void) | undefined;
     /**
      * Called after a card moves between columns, so the host re-reads the rows it owns. A
      * board that moved a card and left the row list alone would show the card in two places
@@ -3942,7 +3946,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, chooser, viewId, onOrderPlaced, footer, embedded, sortOverride, searchOverride, onSearchChange, searchBox, hideRefusedRowActions, newRowLabel, className, }: ViewSwitcherProps): react.JSX.Element;
+declare function ViewSwitcher({ view, onLayoutChange, onViewChange, onOpenRecord, openRecordId, onCloseRecord, onRowsShown, onMoved, onNewRecordForm, onAskWhoChanged, pageSize: pageSizeAsked, titleField, filter, onClearFilter, chooser, viewId, onOrderPlaced, footer, embedded, sortOverride, searchOverride, onSearchChange, searchBox, hideRefusedRowActions, newRowLabel, className, }: ViewSwitcherProps): react.JSX.Element;
 
 /** The host app's saved zone (IANA). `null` / junk clears it: the device zone applies. */
 declare function setPersonTimeZone(next: string | null | undefined): void;
@@ -5906,6 +5910,12 @@ interface TablePageProps$1 {
      * Absent, nothing changes: the page opens exactly as it did.
      */
     activeRecordId?: Uuid | null | undefined;
+    /**
+     * THE RECORD IN THE ADDRESS (AT-RECORD). Told whenever the open record changes (null: shut), so the
+     * host can write `?record=` — pushed when one opens, replaced when she steps to the next, so Back
+     * closes it and a pasted link reopens it. Read back through `activeRecordId`.
+     */
+    onRecordChange?: ((recordId: Uuid | null, how: "open" | "step" | "close") => void) | undefined;
     /**
      * WHICH VIEW THE ADDRESS NAMES — `grid`, `kanban`, `calendar`, `gallery` or
      * `dashboards`, exactly as the host read it out of `?view=`.
@@ -6830,6 +6840,13 @@ interface ViewActionHost {
 /** `whyNot`: the person's reason they may not change this table's views, or null when they may. */
 declare function viewActions(whyNot: string | null, host: ViewActionHost, locked?: boolean, personal?: boolean): ObjectAction[];
 
+interface RecordNeighbors {
+    index: number;
+    total: number;
+    previous: string | null;
+    next: string | null;
+}
+
 interface RecordPanelProps {
     tableId: Uuid$1;
     recordId: Uuid$1;
@@ -6842,8 +6859,14 @@ interface RecordPanelProps {
     onAskAboutField?: ((fieldKey: string) => void) | undefined;
     /** Drawn as the record's own page (no "Open" link to itself). */
     onPage?: boolean | undefined;
-}
-declare function RecordPanel({ tableId, recordId, onClose, onAskAboutField, onPage }: RecordPanelProps): react.JSX.Element;
+    /** Where this record sits in the view the grid shows, and how to move to another (AT-RECORD). */
+    neighbors?: RecordNeighbors | null | undefined;
+    onStep?: ((recordId: Uuid$1) => void) | undefined;
+    /** Drawn over the grid, wide (true) or beside it; `onToggleExpand` draws the control. */
+    expanded?: boolean | undefined;
+    onToggleExpand?: (() => void) | undefined;
+}
+declare function RecordPanel({ tableId, recordId, onClose, onAskAboutField, onPage, neighbors, onStep, expanded, onToggleExpand }: RecordPanelProps): react.JSX.Element;
 
 /**
  * The column a record page writes its body in: the formatted-text column NAMED like a page's body