@ai-matrx/design-system 0.49.29 → 0.49.33

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

@@ -1,7 +1,7 @@
 import * as React from 'react';
 import { ReactNode } from 'react';
-import { h as MatrxDataTableProps, i as TableViewSnapshot, d as MatrxDataTableRecordControls, j as MatrxDataTableRead, k as ColumnMarker, M as MatrxColumnDef } from '../layered-filters-8S8wob5N.cjs';
-export { A as AnyOfColumnSearch, l as CellEditType, m as CellEditsMap, f as ColumnFilterKind, a as ColumnFilterValue, C as ColumnFiltersState, n as MatrxDataTableContextMenuConfig, g as MatrxDataTableCopyConfig, o as MatrxDataTableCoverageConfig, c as MatrxDataTableDensity, p as MatrxDataTableDetailConfig, q as MatrxDataTableEditConfig, r as MatrxDataTableEmptyState, s as MatrxDataTableExpandedDetailConfig, t as MatrxDataTableFacetsConfig, u as MatrxDataTableFilterUi, v as MatrxDataTableGroupingConfig, w as MatrxDataTableHierarchyConfig, x as MatrxDataTableHierarchyMove, y as MatrxDataTableMobileCardControls, z as MatrxDataTableMultiExpandedDetailConfig, B as MatrxDataTableQueryControl, e as MatrxDataTableQueryState, D as MatrxDataTableReadStatus, E as MatrxDataTableSelectionConfig, F as MatrxDataTableSingleExpandedDetailConfig, G as MatrxDataTableSourceProcessing, H as MatrxDataTableSpreadsheetConfig, I as MatrxDataTableStyleConfig, J as MatrxDataTableSummaryConfig, K as MatrxDataTableSummaryContext, N as MatrxDataTableSummaryMetric, O as MatrxDataTableToolbar, P as MatrxDataTableUrlStateConfig, Q as MatrxDataTableVirtualizeConfig, R as MatrxDataTableWindowConfig, U as MatrxTablePagination, V as NumberFilterOp, W as SavedTableViewTab, X as SortDirection, S as SortState, Y as SpreadsheetSelection, Z as TableRankedSearchOptions, b as TableSavedViewsProps, T as TableSearchMatchMode, _ as TableSearchRole, $ as TableSearchScope, a0 as TableViewQuery, a1 as TableViewTab, a2 as TableViewTabs, a3 as TableViewTabsProps, a4 as TableViewTabsStore, a5 as TextFilterMode, a6 as ToolbarFacet, a7 as inferTableSearchRole, a8 as rankTableSearchRows, a9 as resolveTableSearchScopes } from '../layered-filters-8S8wob5N.cjs';
+import { h as MatrxDataTableProps, i as TableViewSnapshot, d as MatrxDataTableRecordControls, j as MatrxDataTableRead, k as ColumnMarker, M as MatrxColumnDef, l as MatrxDrillDimension, m as MatrxDrillMeasure, n as MatrxDrillQuestion, o as MatrxDrillAnswers } from '../layered-filters-Bxc5mB6_.cjs';
+export { A as AnyOfColumnSearch, p as CellEditType, q as CellEditsMap, f as ColumnFilterKind, a as ColumnFilterValue, C as ColumnFiltersState, r as MATRX_DRILL_GRAINS, s as MATRX_DRILL_MAX_LEVELS, t as MATRX_DRILL_NONE, u as MATRX_DRILL_OTHER_COLUMN, v as MATRX_DRILL_PIVOT_COLUMNS, w as MatrxDataTableContextMenuConfig, g as MatrxDataTableCopyConfig, x as MatrxDataTableCoverageConfig, c as MatrxDataTableDensity, y as MatrxDataTableDetailConfig, z as MatrxDataTableDrillConfig, B as MatrxDataTableEditConfig, D as MatrxDataTableEmptyState, E as MatrxDataTableExpandedDetailConfig, F as MatrxDataTableFacetsConfig, G as MatrxDataTableFilterUi, H as MatrxDataTableGroupingConfig, I as MatrxDataTableHierarchyConfig, J as MatrxDataTableHierarchyMove, K as MatrxDataTableMobileCardControls, N as MatrxDataTableMultiExpandedDetailConfig, O as MatrxDataTableQueryControl, e as MatrxDataTableQueryState, P as MatrxDataTableReadStatus, Q as MatrxDataTableSelectionConfig, R as MatrxDataTableSingleExpandedDetailConfig, U as MatrxDataTableSourceProcessing, V as MatrxDataTableSpreadsheetConfig, W as MatrxDataTableStyleConfig, X as MatrxDataTableSummaryConfig, Y as MatrxDataTableSummaryContext, Z as MatrxDataTableSummaryMetric, _ as MatrxDataTableToolbar, $ as MatrxDataTableUrlStateConfig, a0 as MatrxDataTableVirtualizeConfig, a1 as MatrxDataTableWindowConfig, a2 as MatrxDrillAnswerRow, a3 as MatrxDrillCrumb, a4 as MatrxDrillDimensionKind, a5 as MatrxDrillFilter, a6 as MatrxDrillGrain, a7 as MatrxDrillNode, a8 as MatrxDrillOther, a9 as MatrxDrillPivotColumn, aa as MatrxDrillRequest, ab as MatrxTablePagination, ac as NumberFilterOp, ad as SavedTableViewTab, ae as SortDirection, S as SortState, af as SpreadsheetSelection, ag as TableRankedSearchOptions, b as TableSavedViewsProps, T as TableSearchMatchMode, ah as TableSearchRole, ai as TableSearchScope, aj as TableViewQuery, ak as TableViewTab, al as TableViewTabs, am as TableViewTabsProps, an as TableViewTabsStore, ao as TextFilterMode, ap as ToolbarFacet, aq as addressHasDrill, ar as bucketLabel, as as bucketWindow, at as buildDrillTree, au as dimensionFor, av as dimensionRefLabel, aw as dimensionRefs, ax as drillCrumbs, ay as drillInto, az as drillIsGrouped, aA as drillPath, aB as drillQuestionFromParams, aC as drillQuestionToParams, aD as drillRequestKey, aE as drillRequests, aF as drillToRecords, aG as drillValueLabel, aH as emptyDrillQuestion, aI as inferTableSearchRole, aJ as nextDrillLevel, aK as otherOf, aL as parseDimensionRef, aM as pivotCell, aN as pivotColumns, aO as rankTableSearchRows, aP as resolveTableSearchScopes, aQ as sameDrillQuestion, aR as zoomOutTo } from '../layered-filters-Bxc5mB6_.cjs';
 import { TableReadFailureProps, TableStaleNoticeProps } from './host.cjs';
 export { MatrxDataTableHost, MatrxDataTableProvider, MatrxTableRowAlchemy, TableContextMenuBoundaryProps, TableDoors, TableEntityRefProps, TableLinkProps, TableMenuIconProps, TablePeekProps, TableSidePanelProps, TableToolbarActionProps, TableWindowPanelProps, useMatrxDataTableHost, useMatrxTableRowAlchemy } from './host.cjs';
 import { CopyControlProps } from './copy-types.cjs';
@@ -260,4 +260,118 @@ declare function ToolbarListedLabel({ label, children }: {
     children: ReactNode;
 }): React.JSX.Element;
 
-export { ColumnMarker, DefaultTableReadFailure, DefaultTableStaleNotice, FORMAT_MISMATCH_CLASS, FormattedCell, type FrozenColumns, MatrxColumnDef, MatrxDataTable, MatrxDataTableProps, MatrxDataTableRead, MatrxDataTableRecordControls, MatrxTableRowAlchemyProvider, NO_FROZEN_COLUMNS, type ResolvedColumnMarker, SavedViewsControl, type SavedViewsControlProps, 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, useToolbarListed };
+/**
+ * ONE CELL of a group header after the label cell: a subtotal under its own column.
+ */
+interface MatrxTableGroupHeaderCell {
+    id: string;
+    align?: "left" | "center" | "right" | undefined;
+    /** Hidden below `sm`, like the column it sits under. */
+    mobileHidden?: boolean | undefined;
+    content?: ReactNode;
+    /** Marks the cell `data-matrx-table-group-aggregate=<id>` when it holds a subtotal. */
+    aggregate?: boolean | undefined;
+}
+interface MatrxTableGroupHeaderRowProps {
+    /** The section's stable key (`data-matrx-table-group-row`). */
+    groupKey: string;
+    /** The section's words, used for the toggle's accessible name. */
+    label: string;
+    /** Replaces the plain label (a drill button, an entity chip); the toggle stays. */
+    labelSlot?: ReactNode;
+    /** "12 records" — the count, beside the label. */
+    summary: string;
+    collapsed: boolean;
+    /** A section with nothing inside has no toggle. Default true. */
+    collapsible?: boolean | undefined;
+    /** Nesting depth (0 = outermost), drawn as indent. */
+    depth?: number | undefined;
+    /** Id of the label column, so its cell can be told apart. */
+    labelColumnId?: string | undefined;
+    labelMobileHidden?: boolean | undefined;
+    /** Every other column's cell, in column order. */
+    cells: readonly MatrxTableGroupHeaderCell[];
+    /** Selection / expand gutters before the first column. */
+    leadingCols?: number | undefined;
+    /** Virtualized column spacers, when the table windows its columns. */
+    spacers?: {
+        start: number;
+        end: number;
+    } | null | undefined;
+    showActionsCol?: boolean | undefined;
+    /** What the actions cell holds (a drill menu), when there is one. */
+    actions?: ReactNode;
+    onToggle: () => void;
+    /** Extra data attributes for a caller's own markers (`data-matrx-drill-level`). */
+    dataAttributes?: Record<string, string> | undefined;
+}
+/**
+ * A GROUP'S HEADER ROW — the one primitive every grouped table draws.
+ *
+ * It is a real `<tr>` with a real `<td>` per column, NOT one cell spanning the table —
+ * because the whole point of a subtotal is that it sits UNDER its own column. Airtable,
+ * Sheets and Notion all do it this way, and a colspan banner with the numbers crammed into it
+ * is the version that looks like a group and is useless as one.
+ *
+ * The chevron is a real button with the section's name on it, so the section can be opened and
+ * shut from the keyboard and a screen reader says which one.
+ *
+ * Exported (lane D3) so a page-grouped table, the server-grouped drill answer and any consumer
+ * draw ONE markup — nobody copies it again.
+ */
+declare function MatrxTableGroupHeaderRow({ groupKey, label, labelSlot, summary, collapsed, collapsible, depth, labelColumnId, labelMobileHidden, cells, leadingCols, spacers, showActionsCol, actions, onToggle, dataAttributes, }: MatrxTableGroupHeaderRowProps): React.JSX.Element;
+
+interface MatrxDrillAnswerTableProps {
+    dimensions: readonly MatrxDrillDimension[];
+    measures: readonly MatrxDrillMeasure[];
+    question: MatrxDrillQuestion;
+    onQuestionChange: (next: MatrxDrillQuestion) => void;
+    answers: MatrxDrillAnswers;
+    /** Declared drill paths; a click follows the one its level sits on. */
+    paths?: readonly (readonly string[])[] | undefined;
+    /** A read that failed, in words. */
+    error?: string | null | undefined;
+    rowNoun?: string | undefined;
+    emptyLabel?: string | undefined;
+    className?: string | undefined;
+}
+declare function MatrxDrillAnswerTable({ dimensions, measures, question, onQuestionChange, answers, paths, error, rowNoun, emptyLabel, className, }: MatrxDrillAnswerTableProps): React.JSX.Element;
+
+declare function MatrxDrillGroupByMenu({ dimensions, question, onQuestionChange, }: {
+    dimensions: readonly MatrxDrillDimension[];
+    question: MatrxDrillQuestion;
+    onQuestionChange: (next: MatrxDrillQuestion) => void;
+}): React.JSX.Element;
+declare function MatrxDrillMeasurePicker({ measures, question, onQuestionChange, }: {
+    measures: readonly MatrxDrillMeasure[];
+    question: MatrxDrillQuestion;
+    onQuestionChange: (next: MatrxDrillQuestion) => void;
+}): React.JSX.Element;
+/**
+ * THE BREADCRUMB. `All records › Needs repair › Room 3`. Each crumb but the last zooms back out
+ * to it; the × clears every drill filter. Drawn only while the question is narrowed.
+ */
+declare function MatrxDrillTrail({ dimensions, question, onQuestionChange, rootLabel, emptyLabel, className, }: {
+    dimensions: readonly MatrxDrillDimension[];
+    question: MatrxDrillQuestion;
+    onQuestionChange: (next: MatrxDrillQuestion) => void;
+    rootLabel: string;
+    emptyLabel?: string | undefined;
+    className?: string | undefined;
+}): React.JSX.Element | null;
+
+interface DrillUrlState {
+    question: MatrxDrillQuestion;
+    /** True when the address carries the question (it overrides the Saved view for this visit). */
+    fromAddress: boolean;
+    setQuestion: (next: MatrxDrillQuestion) => void;
+    /** Drop every drill parameter, so the Saved view's own question answers again. */
+    clearAddress: () => void;
+}
+declare function useDrillUrlState({ fallback, prefix, }: {
+    fallback: MatrxDrillQuestion;
+    /** Namespaces the keys (`<prefix>.by`) when a page holds more than one drill table. */
+    prefix?: string | undefined;
+}): DrillUrlState;
+
+export { ColumnMarker, DefaultTableReadFailure, DefaultTableStaleNotice, type DrillUrlState, FORMAT_MISMATCH_CLASS, FormattedCell, type FrozenColumns, MatrxColumnDef, MatrxDataTable, MatrxDataTableProps, MatrxDataTableRead, MatrxDataTableRecordControls, MatrxDrillAnswerTable, type MatrxDrillAnswerTableProps, MatrxDrillAnswers, MatrxDrillDimension, MatrxDrillGroupByMenu, MatrxDrillMeasure, MatrxDrillMeasurePicker, MatrxDrillQuestion, MatrxDrillTrail, type MatrxTableGroupHeaderCell, MatrxTableGroupHeaderRow, type MatrxTableGroupHeaderRowProps, MatrxTableRowAlchemyProvider, NO_FROZEN_COLUMNS, type ResolvedColumnMarker, SavedViewsControl, type SavedViewsControlProps, 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, useToolbarListed };

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

@@ -1,7 +1,7 @@
 import * as React from 'react';
 import { ReactNode } from 'react';
-import { h as MatrxDataTableProps, i as TableViewSnapshot, d as MatrxDataTableRecordControls, j as MatrxDataTableRead, k as ColumnMarker, M as MatrxColumnDef } from '../layered-filters-CsbrucEC.js';
-export { A as AnyOfColumnSearch, l as CellEditType, m as CellEditsMap, f as ColumnFilterKind, a as ColumnFilterValue, C as ColumnFiltersState, n as MatrxDataTableContextMenuConfig, g as MatrxDataTableCopyConfig, o as MatrxDataTableCoverageConfig, c as MatrxDataTableDensity, p as MatrxDataTableDetailConfig, q as MatrxDataTableEditConfig, r as MatrxDataTableEmptyState, s as MatrxDataTableExpandedDetailConfig, t as MatrxDataTableFacetsConfig, u as MatrxDataTableFilterUi, v as MatrxDataTableGroupingConfig, w as MatrxDataTableHierarchyConfig, x as MatrxDataTableHierarchyMove, y as MatrxDataTableMobileCardControls, z as MatrxDataTableMultiExpandedDetailConfig, B as MatrxDataTableQueryControl, e as MatrxDataTableQueryState, D as MatrxDataTableReadStatus, E as MatrxDataTableSelectionConfig, F as MatrxDataTableSingleExpandedDetailConfig, G as MatrxDataTableSourceProcessing, H as MatrxDataTableSpreadsheetConfig, I as MatrxDataTableStyleConfig, J as MatrxDataTableSummaryConfig, K as MatrxDataTableSummaryContext, N as MatrxDataTableSummaryMetric, O as MatrxDataTableToolbar, P as MatrxDataTableUrlStateConfig, Q as MatrxDataTableVirtualizeConfig, R as MatrxDataTableWindowConfig, U as MatrxTablePagination, V as NumberFilterOp, W as SavedTableViewTab, X as SortDirection, S as SortState, Y as SpreadsheetSelection, Z as TableRankedSearchOptions, b as TableSavedViewsProps, T as TableSearchMatchMode, _ as TableSearchRole, $ as TableSearchScope, a0 as TableViewQuery, a1 as TableViewTab, a2 as TableViewTabs, a3 as TableViewTabsProps, a4 as TableViewTabsStore, a5 as TextFilterMode, a6 as ToolbarFacet, a7 as inferTableSearchRole, a8 as rankTableSearchRows, a9 as resolveTableSearchScopes } from '../layered-filters-CsbrucEC.js';
+import { h as MatrxDataTableProps, i as TableViewSnapshot, d as MatrxDataTableRecordControls, j as MatrxDataTableRead, k as ColumnMarker, M as MatrxColumnDef, l as MatrxDrillDimension, m as MatrxDrillMeasure, n as MatrxDrillQuestion, o as MatrxDrillAnswers } from '../layered-filters-rDTFmgfK.js';
+export { A as AnyOfColumnSearch, p as CellEditType, q as CellEditsMap, f as ColumnFilterKind, a as ColumnFilterValue, C as ColumnFiltersState, r as MATRX_DRILL_GRAINS, s as MATRX_DRILL_MAX_LEVELS, t as MATRX_DRILL_NONE, u as MATRX_DRILL_OTHER_COLUMN, v as MATRX_DRILL_PIVOT_COLUMNS, w as MatrxDataTableContextMenuConfig, g as MatrxDataTableCopyConfig, x as MatrxDataTableCoverageConfig, c as MatrxDataTableDensity, y as MatrxDataTableDetailConfig, z as MatrxDataTableDrillConfig, B as MatrxDataTableEditConfig, D as MatrxDataTableEmptyState, E as MatrxDataTableExpandedDetailConfig, F as MatrxDataTableFacetsConfig, G as MatrxDataTableFilterUi, H as MatrxDataTableGroupingConfig, I as MatrxDataTableHierarchyConfig, J as MatrxDataTableHierarchyMove, K as MatrxDataTableMobileCardControls, N as MatrxDataTableMultiExpandedDetailConfig, O as MatrxDataTableQueryControl, e as MatrxDataTableQueryState, P as MatrxDataTableReadStatus, Q as MatrxDataTableSelectionConfig, R as MatrxDataTableSingleExpandedDetailConfig, U as MatrxDataTableSourceProcessing, V as MatrxDataTableSpreadsheetConfig, W as MatrxDataTableStyleConfig, X as MatrxDataTableSummaryConfig, Y as MatrxDataTableSummaryContext, Z as MatrxDataTableSummaryMetric, _ as MatrxDataTableToolbar, $ as MatrxDataTableUrlStateConfig, a0 as MatrxDataTableVirtualizeConfig, a1 as MatrxDataTableWindowConfig, a2 as MatrxDrillAnswerRow, a3 as MatrxDrillCrumb, a4 as MatrxDrillDimensionKind, a5 as MatrxDrillFilter, a6 as MatrxDrillGrain, a7 as MatrxDrillNode, a8 as MatrxDrillOther, a9 as MatrxDrillPivotColumn, aa as MatrxDrillRequest, ab as MatrxTablePagination, ac as NumberFilterOp, ad as SavedTableViewTab, ae as SortDirection, S as SortState, af as SpreadsheetSelection, ag as TableRankedSearchOptions, b as TableSavedViewsProps, T as TableSearchMatchMode, ah as TableSearchRole, ai as TableSearchScope, aj as TableViewQuery, ak as TableViewTab, al as TableViewTabs, am as TableViewTabsProps, an as TableViewTabsStore, ao as TextFilterMode, ap as ToolbarFacet, aq as addressHasDrill, ar as bucketLabel, as as bucketWindow, at as buildDrillTree, au as dimensionFor, av as dimensionRefLabel, aw as dimensionRefs, ax as drillCrumbs, ay as drillInto, az as drillIsGrouped, aA as drillPath, aB as drillQuestionFromParams, aC as drillQuestionToParams, aD as drillRequestKey, aE as drillRequests, aF as drillToRecords, aG as drillValueLabel, aH as emptyDrillQuestion, aI as inferTableSearchRole, aJ as nextDrillLevel, aK as otherOf, aL as parseDimensionRef, aM as pivotCell, aN as pivotColumns, aO as rankTableSearchRows, aP as resolveTableSearchScopes, aQ as sameDrillQuestion, aR as zoomOutTo } from '../layered-filters-rDTFmgfK.js';
 import { TableReadFailureProps, TableStaleNoticeProps } from './host.js';
 export { MatrxDataTableHost, MatrxDataTableProvider, MatrxTableRowAlchemy, TableContextMenuBoundaryProps, TableDoors, TableEntityRefProps, TableLinkProps, TableMenuIconProps, TablePeekProps, TableSidePanelProps, TableToolbarActionProps, TableWindowPanelProps, useMatrxDataTableHost, useMatrxTableRowAlchemy } from './host.js';
 import { CopyControlProps } from './copy-types.js';
@@ -260,4 +260,118 @@ declare function ToolbarListedLabel({ label, children }: {
     children: ReactNode;
 }): React.JSX.Element;
 
-export { ColumnMarker, DefaultTableReadFailure, DefaultTableStaleNotice, FORMAT_MISMATCH_CLASS, FormattedCell, type FrozenColumns, MatrxColumnDef, MatrxDataTable, MatrxDataTableProps, MatrxDataTableRead, MatrxDataTableRecordControls, MatrxTableRowAlchemyProvider, NO_FROZEN_COLUMNS, type ResolvedColumnMarker, SavedViewsControl, type SavedViewsControlProps, 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, useToolbarListed };
+/**
+ * ONE CELL of a group header after the label cell: a subtotal under its own column.
+ */
+interface MatrxTableGroupHeaderCell {
+    id: string;
+    align?: "left" | "center" | "right" | undefined;
+    /** Hidden below `sm`, like the column it sits under. */
+    mobileHidden?: boolean | undefined;
+    content?: ReactNode;
+    /** Marks the cell `data-matrx-table-group-aggregate=<id>` when it holds a subtotal. */
+    aggregate?: boolean | undefined;
+}
+interface MatrxTableGroupHeaderRowProps {
+    /** The section's stable key (`data-matrx-table-group-row`). */
+    groupKey: string;
+    /** The section's words, used for the toggle's accessible name. */
+    label: string;
+    /** Replaces the plain label (a drill button, an entity chip); the toggle stays. */
+    labelSlot?: ReactNode;
+    /** "12 records" — the count, beside the label. */
+    summary: string;
+    collapsed: boolean;
+    /** A section with nothing inside has no toggle. Default true. */
+    collapsible?: boolean | undefined;
+    /** Nesting depth (0 = outermost), drawn as indent. */
+    depth?: number | undefined;
+    /** Id of the label column, so its cell can be told apart. */
+    labelColumnId?: string | undefined;
+    labelMobileHidden?: boolean | undefined;
+    /** Every other column's cell, in column order. */
+    cells: readonly MatrxTableGroupHeaderCell[];
+    /** Selection / expand gutters before the first column. */
+    leadingCols?: number | undefined;
+    /** Virtualized column spacers, when the table windows its columns. */
+    spacers?: {
+        start: number;
+        end: number;
+    } | null | undefined;
+    showActionsCol?: boolean | undefined;
+    /** What the actions cell holds (a drill menu), when there is one. */
+    actions?: ReactNode;
+    onToggle: () => void;
+    /** Extra data attributes for a caller's own markers (`data-matrx-drill-level`). */
+    dataAttributes?: Record<string, string> | undefined;
+}
+/**
+ * A GROUP'S HEADER ROW — the one primitive every grouped table draws.
+ *
+ * It is a real `<tr>` with a real `<td>` per column, NOT one cell spanning the table —
+ * because the whole point of a subtotal is that it sits UNDER its own column. Airtable,
+ * Sheets and Notion all do it this way, and a colspan banner with the numbers crammed into it
+ * is the version that looks like a group and is useless as one.
+ *
+ * The chevron is a real button with the section's name on it, so the section can be opened and
+ * shut from the keyboard and a screen reader says which one.
+ *
+ * Exported (lane D3) so a page-grouped table, the server-grouped drill answer and any consumer
+ * draw ONE markup — nobody copies it again.
+ */
+declare function MatrxTableGroupHeaderRow({ groupKey, label, labelSlot, summary, collapsed, collapsible, depth, labelColumnId, labelMobileHidden, cells, leadingCols, spacers, showActionsCol, actions, onToggle, dataAttributes, }: MatrxTableGroupHeaderRowProps): React.JSX.Element;
+
+interface MatrxDrillAnswerTableProps {
+    dimensions: readonly MatrxDrillDimension[];
+    measures: readonly MatrxDrillMeasure[];
+    question: MatrxDrillQuestion;
+    onQuestionChange: (next: MatrxDrillQuestion) => void;
+    answers: MatrxDrillAnswers;
+    /** Declared drill paths; a click follows the one its level sits on. */
+    paths?: readonly (readonly string[])[] | undefined;
+    /** A read that failed, in words. */
+    error?: string | null | undefined;
+    rowNoun?: string | undefined;
+    emptyLabel?: string | undefined;
+    className?: string | undefined;
+}
+declare function MatrxDrillAnswerTable({ dimensions, measures, question, onQuestionChange, answers, paths, error, rowNoun, emptyLabel, className, }: MatrxDrillAnswerTableProps): React.JSX.Element;
+
+declare function MatrxDrillGroupByMenu({ dimensions, question, onQuestionChange, }: {
+    dimensions: readonly MatrxDrillDimension[];
+    question: MatrxDrillQuestion;
+    onQuestionChange: (next: MatrxDrillQuestion) => void;
+}): React.JSX.Element;
+declare function MatrxDrillMeasurePicker({ measures, question, onQuestionChange, }: {
+    measures: readonly MatrxDrillMeasure[];
+    question: MatrxDrillQuestion;
+    onQuestionChange: (next: MatrxDrillQuestion) => void;
+}): React.JSX.Element;
+/**
+ * THE BREADCRUMB. `All records › Needs repair › Room 3`. Each crumb but the last zooms back out
+ * to it; the × clears every drill filter. Drawn only while the question is narrowed.
+ */
+declare function MatrxDrillTrail({ dimensions, question, onQuestionChange, rootLabel, emptyLabel, className, }: {
+    dimensions: readonly MatrxDrillDimension[];
+    question: MatrxDrillQuestion;
+    onQuestionChange: (next: MatrxDrillQuestion) => void;
+    rootLabel: string;
+    emptyLabel?: string | undefined;
+    className?: string | undefined;
+}): React.JSX.Element | null;
+
+interface DrillUrlState {
+    question: MatrxDrillQuestion;
+    /** True when the address carries the question (it overrides the Saved view for this visit). */
+    fromAddress: boolean;
+    setQuestion: (next: MatrxDrillQuestion) => void;
+    /** Drop every drill parameter, so the Saved view's own question answers again. */
+    clearAddress: () => void;
+}
+declare function useDrillUrlState({ fallback, prefix, }: {
+    fallback: MatrxDrillQuestion;
+    /** Namespaces the keys (`<prefix>.by`) when a page holds more than one drill table. */
+    prefix?: string | undefined;
+}): DrillUrlState;
+
+export { ColumnMarker, DefaultTableReadFailure, DefaultTableStaleNotice, type DrillUrlState, FORMAT_MISMATCH_CLASS, FormattedCell, type FrozenColumns, MatrxColumnDef, MatrxDataTable, MatrxDataTableProps, MatrxDataTableRead, MatrxDataTableRecordControls, MatrxDrillAnswerTable, type MatrxDrillAnswerTableProps, MatrxDrillAnswers, MatrxDrillDimension, MatrxDrillGroupByMenu, MatrxDrillMeasure, MatrxDrillMeasurePicker, MatrxDrillQuestion, MatrxDrillTrail, type MatrxTableGroupHeaderCell, MatrxTableGroupHeaderRow, type MatrxTableGroupHeaderRowProps, MatrxTableRowAlchemyProvider, NO_FROZEN_COLUMNS, type ResolvedColumnMarker, SavedViewsControl, type SavedViewsControlProps, 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, useToolbarListed };