@ai-matrx/design-system 0.49.36 → 0.49.37

package/dist/data-table/index.d.cts

@@ -83,8 +83,13 @@ interface MatrxTableCardProps {
     iconClassName?: string;
     /** Classes for the left accent rail (e.g. `bg-violet-500`). Left out: no rail. */
     railClassName?: string;
-    /** The records the table holds: "4 clients". */
-    records?: MatrxTableCardNoun;
+    /**
+     * The records the table holds: "4 clients". Leave `count` out and the card uses the count the
+     * table inside it reports (its source's total), shown once the table knows it.
+     */
+    records?: Omit<MatrxTableCardNoun, "count"> & {
+        count?: number;
+    };
     /**
      * The columns the table's records carry: "14 fields". Field is the canonical word for a column
      * definition (Data Doctrine §1.3); pass `singular`/`plural` to say something else.
@@ -145,12 +150,15 @@ declare function MatrxTableCardEmpty({ message, action, children }: MatrxTableCa
  *   instead of stacking a second row. `null` while the header mounts (draw nothing, never a flash).
  * - `footerSlot`: the card's footer row; the table's "Show more" sits beside "+ Add".
  * - `initialRows`: how many rows the table shows before "Show more".
+ * - `reportTotal`: the table tells the card how many records it holds, so the counts line says
+ *   "4 clients" from the table's own answer (no second read). `undefined` while it is unknown.
  */
 interface MatrxTableCardContextValue {
     appearance: MatrxDataTableAppearance;
     toolbarSlot: HTMLElement | null;
     footerSlot: HTMLElement | null;
     initialRows: number;
+    reportTotal: (total: number | undefined) => void;
 }
 declare const MatrxTableCardContext: React.Context<MatrxTableCardContextValue | null>;
 /** The enclosing table card, or null outside one. */
@@ -158,6 +166,27 @@ declare function useMatrxTableCard(): MatrxTableCardContextValue | null;
 /** The card's default initial row count (Arman, 2026-09-29). */
 declare const TABLE_CARD_DEFAULT_INITIAL_ROWS = 10;
 
+interface MatrxTableCardShowMoreProps {
+    shown: number;
+    /** Left out when the source cannot say (a full page): the control reads "10 shown". */
+    total?: number | undefined;
+    /** A fetch for the next batch is in flight. */
+    busy?: boolean;
+    onShowMore: () => void;
+    /**
+     * The card to draw in. Left out: the enclosing card. A `MatrxDataTable` passes its own (it hides
+     * the card from what it renders so nested tables stay ordinary).
+     */
+    card?: MatrxTableCardContextValue | null;
+}
+/**
+ * The table card's one footer control: "10 of 642 · Show more", drawn in the card's footer row
+ * beside "+ Add". `MatrxDataTable` draws it for its own rows; a host that pages its own source
+ * inside a card (records-ui's classic Grid) draws it too, so a card never shows two pagers.
+ * Outside a card it sits under the rows.
+ */
+declare function MatrxTableCardShowMore({ shown, total, busy, onShowMore, card }: MatrxTableCardShowMoreProps): React.JSX.Element | null;
+
 interface SavedViewsControlProps {
     views: ReadonlyArray<{
         id: string;
@@ -475,4 +504,4 @@ declare function useDrillUrlState({ fallback, prefix, }: {
     prefix?: string | undefined;
 }): DrillUrlState;
 
-export { ColumnMarker, DefaultTableReadFailure, DefaultTableStaleNotice, type DrillUrlState, FORMAT_MISMATCH_CLASS, FormattedCell, type FrozenColumns, MatrxColumnDef, MatrxDataTable, MatrxDataTableAppearance, MatrxDataTableProps, MatrxDataTableRead, MatrxDataTableRecordControls, MatrxDrillAnswerTable, type MatrxDrillAnswerTableProps, MatrxDrillAnswers, MatrxDrillDimension, MatrxDrillGroupByMenu, MatrxDrillMeasure, MatrxDrillMeasurePicker, MatrxDrillQuestion, MatrxDrillTrail, MatrxDrillWindowMenu, MatrxTableCard, MatrxTableCardContext, type MatrxTableCardContextValue, MatrxTableCardEmpty, type MatrxTableCardEmptyProps, type MatrxTableCardNoun, type MatrxTableCardProps, type MatrxTableGroupHeaderCell, MatrxTableGroupHeaderRow, type MatrxTableGroupHeaderRowProps, MatrxTableRowAlchemyProvider, NO_FROZEN_COLUMNS, type ResolvedColumnMarker, SavedViewsControl, type SavedViewsControlProps, TABLE_CARD_DEFAULT_INITIAL_ROWS, TOOLBAR_CONTROL_HEIGHT, TableReadFailureProps, type TableReadView, TableStaleNoticeProps, TableTitleRow, type TableTitleRowProps, TableViewSnapshot, type ToggleSelectionArgs, type ToggleSelectionResult, ToolbarListedLabel, ToolbarOverflowMenu, type ToolbarOverflowMode, ToolbarOverflowSheet, alignForFormat, formatColumnValue, parseTableViewSnapshot, pixelWidth, resolveColumnMarker, resolveFrozenColumns, tableReadView, toggleSelection, useDrillUrlState, useMatrxTableCard, useToolbarListed };
+export { ColumnMarker, DefaultTableReadFailure, DefaultTableStaleNotice, type DrillUrlState, FORMAT_MISMATCH_CLASS, FormattedCell, type FrozenColumns, MatrxColumnDef, MatrxDataTable, MatrxDataTableAppearance, MatrxDataTableProps, MatrxDataTableRead, MatrxDataTableRecordControls, MatrxDrillAnswerTable, type MatrxDrillAnswerTableProps, MatrxDrillAnswers, MatrxDrillDimension, MatrxDrillGroupByMenu, MatrxDrillMeasure, MatrxDrillMeasurePicker, MatrxDrillQuestion, MatrxDrillTrail, MatrxDrillWindowMenu, MatrxTableCard, MatrxTableCardContext, type MatrxTableCardContextValue, MatrxTableCardEmpty, type MatrxTableCardEmptyProps, type MatrxTableCardNoun, type MatrxTableCardProps, MatrxTableCardShowMore, type MatrxTableCardShowMoreProps, type MatrxTableGroupHeaderCell, MatrxTableGroupHeaderRow, type MatrxTableGroupHeaderRowProps, MatrxTableRowAlchemyProvider, NO_FROZEN_COLUMNS, type ResolvedColumnMarker, SavedViewsControl, type SavedViewsControlProps, TABLE_CARD_DEFAULT_INITIAL_ROWS, TOOLBAR_CONTROL_HEIGHT, TableReadFailureProps, type TableReadView, TableStaleNoticeProps, TableTitleRow, type TableTitleRowProps, TableViewSnapshot, type ToggleSelectionArgs, type ToggleSelectionResult, ToolbarListedLabel, ToolbarOverflowMenu, type ToolbarOverflowMode, ToolbarOverflowSheet, alignForFormat, formatColumnValue, parseTableViewSnapshot, pixelWidth, resolveColumnMarker, resolveFrozenColumns, tableReadView, toggleSelection, useDrillUrlState, useMatrxTableCard, useToolbarListed };

package/dist/data-table/index.d.ts

@@ -83,8 +83,13 @@ interface MatrxTableCardProps {
     iconClassName?: string;
     /** Classes for the left accent rail (e.g. `bg-violet-500`). Left out: no rail. */
     railClassName?: string;
-    /** The records the table holds: "4 clients". */
-    records?: MatrxTableCardNoun;
+    /**
+     * The records the table holds: "4 clients". Leave `count` out and the card uses the count the
+     * table inside it reports (its source's total), shown once the table knows it.
+     */
+    records?: Omit<MatrxTableCardNoun, "count"> & {
+        count?: number;
+    };
     /**
      * The columns the table's records carry: "14 fields". Field is the canonical word for a column
      * definition (Data Doctrine §1.3); pass `singular`/`plural` to say something else.
@@ -145,12 +150,15 @@ declare function MatrxTableCardEmpty({ message, action, children }: MatrxTableCa
  *   instead of stacking a second row. `null` while the header mounts (draw nothing, never a flash).
  * - `footerSlot`: the card's footer row; the table's "Show more" sits beside "+ Add".
  * - `initialRows`: how many rows the table shows before "Show more".
+ * - `reportTotal`: the table tells the card how many records it holds, so the counts line says
+ *   "4 clients" from the table's own answer (no second read). `undefined` while it is unknown.
  */
 interface MatrxTableCardContextValue {
     appearance: MatrxDataTableAppearance;
     toolbarSlot: HTMLElement | null;
     footerSlot: HTMLElement | null;
     initialRows: number;
+    reportTotal: (total: number | undefined) => void;
 }
 declare const MatrxTableCardContext: React.Context<MatrxTableCardContextValue | null>;
 /** The enclosing table card, or null outside one. */
@@ -158,6 +166,27 @@ declare function useMatrxTableCard(): MatrxTableCardContextValue | null;
 /** The card's default initial row count (Arman, 2026-09-29). */
 declare const TABLE_CARD_DEFAULT_INITIAL_ROWS = 10;
 
+interface MatrxTableCardShowMoreProps {
+    shown: number;
+    /** Left out when the source cannot say (a full page): the control reads "10 shown". */
+    total?: number | undefined;
+    /** A fetch for the next batch is in flight. */
+    busy?: boolean;
+    onShowMore: () => void;
+    /**
+     * The card to draw in. Left out: the enclosing card. A `MatrxDataTable` passes its own (it hides
+     * the card from what it renders so nested tables stay ordinary).
+     */
+    card?: MatrxTableCardContextValue | null;
+}
+/**
+ * The table card's one footer control: "10 of 642 · Show more", drawn in the card's footer row
+ * beside "+ Add". `MatrxDataTable` draws it for its own rows; a host that pages its own source
+ * inside a card (records-ui's classic Grid) draws it too, so a card never shows two pagers.
+ * Outside a card it sits under the rows.
+ */
+declare function MatrxTableCardShowMore({ shown, total, busy, onShowMore, card }: MatrxTableCardShowMoreProps): React.JSX.Element | null;
+
 interface SavedViewsControlProps {
     views: ReadonlyArray<{
         id: string;
@@ -475,4 +504,4 @@ declare function useDrillUrlState({ fallback, prefix, }: {
     prefix?: string | undefined;
 }): DrillUrlState;
 
-export { ColumnMarker, DefaultTableReadFailure, DefaultTableStaleNotice, type DrillUrlState, FORMAT_MISMATCH_CLASS, FormattedCell, type FrozenColumns, MatrxColumnDef, MatrxDataTable, MatrxDataTableAppearance, MatrxDataTableProps, MatrxDataTableRead, MatrxDataTableRecordControls, MatrxDrillAnswerTable, type MatrxDrillAnswerTableProps, MatrxDrillAnswers, MatrxDrillDimension, MatrxDrillGroupByMenu, MatrxDrillMeasure, MatrxDrillMeasurePicker, MatrxDrillQuestion, MatrxDrillTrail, MatrxDrillWindowMenu, MatrxTableCard, MatrxTableCardContext, type MatrxTableCardContextValue, MatrxTableCardEmpty, type MatrxTableCardEmptyProps, type MatrxTableCardNoun, type MatrxTableCardProps, type MatrxTableGroupHeaderCell, MatrxTableGroupHeaderRow, type MatrxTableGroupHeaderRowProps, MatrxTableRowAlchemyProvider, NO_FROZEN_COLUMNS, type ResolvedColumnMarker, SavedViewsControl, type SavedViewsControlProps, TABLE_CARD_DEFAULT_INITIAL_ROWS, TOOLBAR_CONTROL_HEIGHT, TableReadFailureProps, type TableReadView, TableStaleNoticeProps, TableTitleRow, type TableTitleRowProps, TableViewSnapshot, type ToggleSelectionArgs, type ToggleSelectionResult, ToolbarListedLabel, ToolbarOverflowMenu, type ToolbarOverflowMode, ToolbarOverflowSheet, alignForFormat, formatColumnValue, parseTableViewSnapshot, pixelWidth, resolveColumnMarker, resolveFrozenColumns, tableReadView, toggleSelection, useDrillUrlState, useMatrxTableCard, useToolbarListed };
+export { ColumnMarker, DefaultTableReadFailure, DefaultTableStaleNotice, type DrillUrlState, FORMAT_MISMATCH_CLASS, FormattedCell, type FrozenColumns, MatrxColumnDef, MatrxDataTable, MatrxDataTableAppearance, MatrxDataTableProps, MatrxDataTableRead, MatrxDataTableRecordControls, MatrxDrillAnswerTable, type MatrxDrillAnswerTableProps, MatrxDrillAnswers, MatrxDrillDimension, MatrxDrillGroupByMenu, MatrxDrillMeasure, MatrxDrillMeasurePicker, MatrxDrillQuestion, MatrxDrillTrail, MatrxDrillWindowMenu, MatrxTableCard, MatrxTableCardContext, type MatrxTableCardContextValue, MatrxTableCardEmpty, type MatrxTableCardEmptyProps, type MatrxTableCardNoun, type MatrxTableCardProps, MatrxTableCardShowMore, type MatrxTableCardShowMoreProps, type MatrxTableGroupHeaderCell, MatrxTableGroupHeaderRow, type MatrxTableGroupHeaderRowProps, MatrxTableRowAlchemyProvider, NO_FROZEN_COLUMNS, type ResolvedColumnMarker, SavedViewsControl, type SavedViewsControlProps, TABLE_CARD_DEFAULT_INITIAL_ROWS, TOOLBAR_CONTROL_HEIGHT, TableReadFailureProps, type TableReadView, TableStaleNoticeProps, TableTitleRow, type TableTitleRowProps, TableViewSnapshot, type ToggleSelectionArgs, type ToggleSelectionResult, ToolbarListedLabel, ToolbarOverflowMenu, type ToolbarOverflowMode, ToolbarOverflowSheet, alignForFormat, formatColumnValue, parseTableViewSnapshot, pixelWidth, resolveColumnMarker, resolveFrozenColumns, tableReadView, toggleSelection, useDrillUrlState, useMatrxTableCard, useToolbarListed };