@ai-matrx/design-system 0.49.32 → 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, l as MatrxDrillDimension, m as MatrxDrillMeasure, n as MatrxDrillQuestion, o as MatrxDrillAnswers } from '../layered-filters-DmI_v_ku.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-DmI_v_ku.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';
@@ -327,13 +327,15 @@ interface MatrxDrillAnswerTableProps {
     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, error, rowNoun, emptyLabel, className, }: MatrxDrillAnswerTableProps): React.JSX.Element;
+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[];

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, l as MatrxDrillDimension, m as MatrxDrillMeasure, n as MatrxDrillQuestion, o as MatrxDrillAnswers } from '../layered-filters-QG3LUn_h.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-QG3LUn_h.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';
@@ -327,13 +327,15 @@ interface MatrxDrillAnswerTableProps {
     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, error, rowNoun, emptyLabel, className, }: MatrxDrillAnswerTableProps): React.JSX.Element;
+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[];

package/dist/data-table/index.js

@@ -43832,14 +43832,23 @@ function drillPath(question, dimensions) {
   if (question.path && question.path.length > 0) return question.path;
   return dimensions.map((d) => d.kind === "time" ? `${d.key}:month` : d.key);
 }
-function nextDrillLevel(question, dimensions) {
+function nextDrillLevel(question, dimensions, paths = []) {
+  const deepest = question.by[question.by.length - 1];
+  const usedRefs = /* @__PURE__ */ new Set([...question.where.map((w) => w.dim), ...question.by]);
+  if (deepest) {
+    for (const levels of paths) {
+      const at2 = levels.indexOf(deepest);
+      if (at2 < 0) continue;
+      const next = levels.slice(at2 + 1).find((ref) => !usedRefs.has(ref) && dimensionFor(dimensions, ref));
+      if (next) return next;
+    }
+  }
   const path2 = drillPath(question, dimensions);
   const used = /* @__PURE__ */ new Set([
     ...question.where.map((w) => parseDimensionRef(w.dim).key),
     ...question.by.map((b) => parseDimensionRef(b).key),
     ...question.across ? [parseDimensionRef(question.across).key] : []
   ]);
-  const deepest = question.by[question.by.length - 1];
   const from = deepest ? path2.indexOf(deepest) : -1;
   const ordered = from >= 0 ? [...path2.slice(from + 1), ...path2.slice(0, from)] : path2;
   for (const ref of ordered) {
@@ -43847,10 +43856,10 @@ function nextDrillLevel(question, dimensions) {
   }
   return null;
 }
-function drillInto(question, groups, dimensions, into) {
+function drillInto(question, groups, dimensions, into, paths = []) {
   const added = question.by.filter((ref) => ref in groups).map((ref) => ({ dim: ref, value: groups[ref] ?? null }));
   const narrowed = { ...question, where: [...question.where, ...added] };
-  const next = into === void 0 ? nextDrillLevel(question, dimensions) : into;
+  const next = into === void 0 ? nextDrillLevel(question, dimensions, paths) : into;
   return { ...narrowed, by: next ? [next] : [], across: next && question.across === next ? null : question.across ?? null };
 }
 function drillToRecords(question, groups) {
@@ -44091,6 +44100,7 @@ function normalize(q) {
 
 // src/data-table/DrillAnswerTable.tsx
 import { Fragment as Fragment11, jsx as jsx41, jsxs as jsxs31 } from "react/jsx-runtime";
+var NO_PATHS = [];
 function plural(n2, noun) {
   return `${n2.toLocaleString()} ${n2 === 1 ? noun : `${noun}s`}`;
 }
@@ -44147,6 +44157,7 @@ function MatrxDrillAnswerTable({
   question,
   onQuestionChange,
   answers,
+  paths = NO_PATHS,
   error,
   rowNoun = "record",
   emptyLabel = "No value",
@@ -44163,7 +44174,7 @@ function MatrxDrillAnswerTable({
     [question, answers, dimensions, measures]
   );
   const pivot = Boolean(question.across) && columns !== null && columns.length > 0;
-  const next = nextDrillLevel(question, dimensions);
+  const next = nextDrillLevel(question, dimensions, paths);
   const nextLabel = next ? dimensionRefLabel(dimensions, next) : null;
   const byKeys = new Set(question.by.map((ref) => parseDimensionRef(ref).key));
   const filteredKeys = new Set(question.where.map((w) => parseDimensionRef(w.dim).key));
@@ -44240,7 +44251,7 @@ function MatrxDrillAnswerTable({
     const scope = { ...question, by: question.by.slice(0, node.level + 1) };
     const intoRef = deepest ? next : question.by[node.level + 1] ?? null;
     const intoLabel = intoRef ? dimensionRefLabel(dimensions, intoRef) : null;
-    const drill = () => onQuestionChange(drillInto(scope, node.groups, dimensions, intoRef));
+    const drill = () => onQuestionChange(drillInto(scope, node.groups, dimensions, intoRef, paths));
     const records = () => onQuestionChange(drillToRecords(scope, node.groups));
     return /* @__PURE__ */ jsxs31(Fragment10, { children: [
       /* @__PURE__ */ jsx41(
@@ -53871,6 +53882,7 @@ function MatrxDataTableCore(coreProps) {
                                 question: drill.question,
                                 onQuestionChange: drill.onQuestionChange,
                                 answers: drill.answers,
+                                ...drill.paths ? { paths: drill.paths } : {},
                                 error: drill.error,
                                 rowNoun: drill.rowNoun ?? grouping?.rowNoun ?? "record",
                                 emptyLabel: drill.emptyLabel