@ai-matrx/design-system 0.49.54 → 0.49.56

package/dist/data-table/filter-engine.d.cts

@@ -1,4 +1,4 @@
-import { M as MatrxColumnDef, C as ColumnFiltersState, S as SortState, L as LayeredFilterRule, T as TableSearchMatchMode, a as ColumnFilterValue } from '../layered-filters-RHe2Kzrs.cjs';
+import { M as MatrxColumnDef, C as ColumnFiltersState, S as SortState, L as LayeredFilterRule, T as TableSearchMatchMode, a as ColumnFilterValue } from '../layered-filters-HFquDviC.cjs';
 import '../content-transfer.cjs';
 import 'react';
 import '@ai-matrx/kit/content-transfer';
@@ -7,7 +7,7 @@ import './copy-types.cjs';
 import './table-style.cjs';
 import '../types-JnZD8wM0.cjs';
 import './grouping.cjs';
-import '../drill-cISpem5b.cjs';
+import '../drill-qJ5gHL2F.cjs';
 import './fill.cjs';
 import './facets.cjs';
 import './spreadsheet.cjs';

package/dist/data-table/filter-engine.d.ts

@@ -1,4 +1,4 @@
-import { M as MatrxColumnDef, C as ColumnFiltersState, S as SortState, L as LayeredFilterRule, T as TableSearchMatchMode, a as ColumnFilterValue } from '../layered-filters-ma_P0GDG.js';
+import { M as MatrxColumnDef, C as ColumnFiltersState, S as SortState, L as LayeredFilterRule, T as TableSearchMatchMode, a as ColumnFilterValue } from '../layered-filters-CTdPPgxf.js';
 import '../content-transfer.js';
 import 'react';
 import '@ai-matrx/kit/content-transfer';
@@ -7,7 +7,7 @@ import './copy-types.js';
 import './table-style.js';
 import '../types-JnZD8wM0.js';
 import './grouping.js';
-import '../drill-cISpem5b.js';
+import '../drill-qJ5gHL2F.js';
 import './fill.js';
 import './facets.js';
 import './spreadsheet.js';

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

@@ -2,7 +2,7 @@ import * as React from 'react';
 import { ComponentType, ReactNode, MouseEventHandler } from 'react';
 import { CopyControlProps } from './copy-types.cjs';
 export { AgentPayloadInput, AiCustomSource, AiVariant, CopyExportConfig } from './copy-types.cjs';
-import { b as TableSavedViewsProps, c as MatrxDataTableDensity, d as MatrxDataTableRecordControls } from '../layered-filters-RHe2Kzrs.cjs';
+import { b as TableSavedViewsProps, c as MatrxDataTableDensity, d as MatrxDataTableRecordControls } from '../layered-filters-HFquDviC.cjs';
 import { MatrxTableMenuItem, MatrxTableMenuTarget, MatrxTableMenuPayload, MatrxTableMenuSectionsResolver, MatrxTableMenuIconName } from './menu-targets.cjs';
 export { MatrxTableMenuSection } from './menu-targets.cjs';
 import '../content-transfer.cjs';
@@ -11,7 +11,7 @@ import '../content-transfer/icon.cjs';
 import './table-style.cjs';
 import '../types-JnZD8wM0.cjs';
 import './grouping.cjs';
-import '../drill-cISpem5b.cjs';
+import '../drill-qJ5gHL2F.cjs';
 import './fill.cjs';
 import './facets.cjs';
 import './spreadsheet.cjs';

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

@@ -2,7 +2,7 @@ import * as React from 'react';
 import { ComponentType, ReactNode, MouseEventHandler } from 'react';
 import { CopyControlProps } from './copy-types.js';
 export { AgentPayloadInput, AiCustomSource, AiVariant, CopyExportConfig } from './copy-types.js';
-import { b as TableSavedViewsProps, c as MatrxDataTableDensity, d as MatrxDataTableRecordControls } from '../layered-filters-ma_P0GDG.js';
+import { b as TableSavedViewsProps, c as MatrxDataTableDensity, d as MatrxDataTableRecordControls } from '../layered-filters-CTdPPgxf.js';
 import { MatrxTableMenuItem, MatrxTableMenuTarget, MatrxTableMenuPayload, MatrxTableMenuSectionsResolver, MatrxTableMenuIconName } from './menu-targets.js';
 export { MatrxTableMenuSection } from './menu-targets.js';
 import '../content-transfer.js';
@@ -11,7 +11,7 @@ import '../content-transfer/icon.js';
 import './table-style.js';
 import '../types-JnZD8wM0.js';
 import './grouping.js';
-import '../drill-cISpem5b.js';
+import '../drill-qJ5gHL2F.js';
 import './fill.js';
 import './facets.js';
 import './spreadsheet.js';

package/dist/data-table/index.cjs

@@ -34144,6 +34144,7 @@ __export(data_table_exports, {
   drillPareto: () => drillPareto,
   drillParetoSentence: () => drillParetoSentence,
   drillPath: () => drillPath,
+  drillPivotSortKey: () => drillPivotSortKey,
   drillQuestionFromParams: () => drillQuestionFromParams,
   drillQuestionToParams: () => drillQuestionToParams,
   drillRequestKey: () => drillRequestKey,
@@ -44350,7 +44351,7 @@ function otherOf(parent, children, measures) {
   }
   return { row_count: rest, measures: out };
 }
-function sortRows(rows, ref, sort) {
+function sortRows(rows, ref, sort, cellOf) {
   if (!sort) return rows;
   const dir = sort.direction === "asc" ? 1 : -1;
   return [...rows].sort((a, b) => {
@@ -44363,6 +44364,13 @@ function sortRows(rows, ref, sort) {
       return av2.localeCompare(bv2, void 0, { numeric: true }) * dir;
     }
     const read = (row) => {
+      if (sort.key.startsWith("across:")) {
+        const rest = sort.key.slice(7);
+        const at2 = rest.indexOf(":");
+        if (at2 < 0 || !cellOf) return null;
+        const value = rest.slice(at2 + 1);
+        return cellOf(row, rest.slice(0, at2), value === "(none)" ? null : value);
+      }
       if (sort.key.startsWith("delta:")) {
         const key = sort.key.slice(6);
         return drillDelta(row.measures[key], row.prior_measures?.[key]).change;
@@ -44392,10 +44400,17 @@ function buildDrillTree(question, answers, measures) {
   const build = (level, parentGroups, parentKey) => {
     const ref = by[level];
     const sort = question.sort ?? (parseDimensionRef(ref).grain ? { key: "label", direction: "asc" } : null);
+    const across = question.across ?? null;
+    const crossed = across ? answers[drillRequestKey([...by.slice(0, level + 1), across])] : void 0;
     const rows = sortRows(
       (levels[level] ?? []).filter((row) => matches(row, parentGroups)),
       ref,
-      sort
+      sort,
+      across && crossed ? (row, measure, value) => {
+        const groups = { ...parentGroups, [ref]: row.groups[ref] ?? null };
+        const hit = crossed.find((r) => matches(r, groups) && (r.groups[across] ?? null) === value);
+        return hit ? hit.measures[measure] ?? null : null;
+      } : void 0
     );
     return rows.map((row) => {
       const groups = { ...parentGroups, [ref]: row.groups[ref] ?? null };
@@ -44675,9 +44690,16 @@ function drillChartQuestions(question, seriesLimit = MATRX_DRILL_CHART_SERIES_LI
   const timeInBy = question.by.find((ref) => parseDimensionRef(ref).grain !== null);
   const firstTime = context.dimensions.find((d) => d.kind === "time");
   const time = timeInBy ?? context.time ?? (firstTime ? `${firstTime.key}:${drillAutoGrain(question.window ?? null, context.now, firstTime.grains ?? MATRX_DRILL_DEFAULT_GRAINS)}` : null);
-  const split = question.by.find((ref) => parseDimensionRef(ref).grain === null && dimensionFor(context.dimensions, ref)?.kind !== "time") ?? null;
+  const stack = context.stack && context.stack.length >= 2 ? [...context.stack] : null;
+  const split = stack ? null : question.by.find((ref) => parseDimensionRef(ref).grain === null && dimensionFor(context.dimensions, ref)?.kind !== "time") ?? null;
   const refuse = (sentence) => ({ ...base, time, split, refused: sentence, first: [], periodsHint: null });
   if (!time) return refuse("This answer has no time to chart it over.");
+  if (stack) {
+    const missing = stack.find((k) => !context.measures.some((m) => m.key === k));
+    if (missing) return refuse(`There is no Measure "${missing}" to chart.`);
+    const loose = stack.map((k) => context.measures.find((m) => m.key === k)).find((m) => !m.additive || m.moment);
+    if (loose) return refuse(`${loose.label} does not add up, so it cannot be stacked.`);
+  }
   if (!measure) return refuse(`There is no Measure "${measureKey}" to chart.`);
   if (split && !measure.additive) {
     return refuse(
@@ -44690,13 +44712,13 @@ function drillChartQuestions(question, seriesLimit = MATRX_DRILL_CHART_SERIES_LI
   const periodsHint = Number.isFinite(days2) && days2 > 0 ? Math.ceil(days2 / GRAIN_DAYS[grain]) + 1 : null;
   const where = trailWhere(question);
   const window2 = question.window ?? null;
-  const show = [measureKey];
+  const show = stack ?? [measureKey];
   const first = [];
   if (split) {
     first.push({ key: "series", by: [split], where, show, sort: { key: measureKey, direction: "desc" }, limit, window: window2 });
   }
   first.push({ key: "periods", by: [time], where, show, sort: null, limit: periodsHint ? clampLimit(periodsHint, ceiling) : null, window: window2 });
-  return { ...base, time, split, refused: null, first, periodsHint };
+  return { ...base, ...stack ? { measure: stack[0], stack } : {}, time, split, refused: null, first, periodsHint };
 }
 function drillChartCellsQuestion(plan, question, series) {
   if (plan.refused || !plan.split || !plan.time) return null;
@@ -44770,6 +44792,35 @@ function drillChartData(plan, answers, dimensions, measures, emptyLabel = "No va
       values: {}
     };
   });
+  if (plan.stack) {
+    const keys2 = plan.stack;
+    const readOf = (row, k) => {
+      const v = row?.measures[k];
+      return v === null || v === void 0 ? null : v;
+    };
+    const totalRow = periodRows.find((r) => rowKind(r) === "total");
+    for (const [i, p] of periodBase.entries()) {
+      const row = groups[i];
+      let sum = null;
+      for (const k of keys2) {
+        const v = readOf(row, k);
+        p.values[`m:${k}`] = v;
+        if (v !== null) sum = (sum ?? 0) + v;
+      }
+      p.total = sum;
+    }
+    const totals = keys2.map((k) => readOf(totalRow, k));
+    const total = totals.every((t) => t === null) ? null : totals.reduce((a, t) => a + (t ?? 0), 0);
+    return {
+      time,
+      split: null,
+      measure: m,
+      series: keys2.map((k, i) => ({ key: `m:${k}`, value: null, label: measures.find((x) => x.key === k)?.label ?? k, other: false, total: totals[i] ?? null })),
+      periods: periodBase,
+      total,
+      says
+    };
+  }
   if (!split) {
     const key = "all";
     for (const p of periodBase) p.values[key] = p.total;
@@ -44970,6 +45021,9 @@ function drillGroupsAgentInput(nodes, question, dimensions, measures, actions, r
 
 // src/data-table/DrillAnswerTable.tsx
 var import_jsx_runtime42 = require("react/jsx-runtime");
+function drillPivotSortKey(measure, value) {
+  return `across:${measure}:${value === null ? "(none)" : value}`;
+}
 var NO_PATHS = [];
 function plural(n, noun) {
   return `${n.toLocaleString()} ${n === 1 ? noun : `${noun}s`}`;
@@ -45113,7 +45167,8 @@ function MatrxDrillAnswerTable({
   pareto,
   rowActions,
   pivotColumnCap,
-  search
+  search,
+  attributes
 }) {
   const host = useMatrxDataTableHost();
   const tableId = `drill-answer-${(0, import_react15.useId)()}`;
@@ -45225,8 +45280,18 @@ function MatrxDrillAnswerTable({
     }
     const ref = node.level >= 0 ? question.by[node.level] : void 0;
     const color = ref ? drillValueColor(dimensions, ref, node.groups[ref] ?? null) : null;
-    return shown.map((m) => ({ id: m.key, align: "right", aggregate: true, content: valueCell(m, row, parent, color) }));
+    const glance = (attributes ?? []).map((a) => {
+      const said = node.level === 0 ? a.read(node.groups) : null;
+      return {
+        id: `attr::${a.key}`,
+        align: "left",
+        aggregate: false,
+        content: node.level !== 0 ? "" : said === void 0 ? /* @__PURE__ */ (0, import_jsx_runtime42.jsx)("span", { className: "text-muted-foreground", children: "\u2026" }) : said === null ? /* @__PURE__ */ (0, import_jsx_runtime42.jsx)("span", { className: "text-muted-foreground", children: "\u2014" }) : /* @__PURE__ */ (0, import_jsx_runtime42.jsx)("span", { "data-matrx-drill-attribute": a.key, className: "block max-w-[14rem] truncate text-xs", title: said, children: said })
+      };
+    });
+    return [...glance, ...shown.map((m) => ({ id: m.key, align: "right", aggregate: true, content: valueCell(m, row, parent, color) }))];
   };
+  const glanceShown = !pivot && (attributes?.length ?? 0) > 0 ? attributes : [];
   const toggleSort = (key) => {
     const current = question.sort;
     const direction = current?.key === key && current.direction === "desc" ? "asc" : "desc";
@@ -45236,39 +45301,43 @@ function MatrxDrillAnswerTable({
     if (question.sort?.key !== key) return null;
     return question.sort.direction === "desc" ? /* @__PURE__ */ (0, import_jsx_runtime42.jsx)(ArrowDown, { "aria-hidden": "true", className: "h-3 w-3" }) : /* @__PURE__ */ (0, import_jsx_runtime42.jsx)(ArrowUp, { "aria-hidden": "true", className: "h-3 w-3" });
   };
-  const measureHeader = (m, id) => /* @__PURE__ */ (0, import_jsx_runtime42.jsxs)("th", { scope: "col", className: "whitespace-nowrap px-2 py-2 text-right text-xs font-medium text-muted-foreground", children: [
-    /* @__PURE__ */ (0, import_jsx_runtime42.jsxs)(
-      "button",
-      {
-        type: "button",
-        "data-matrx-drill-sort": m.key,
-        "aria-label": `Sort groups by ${m.label}`,
-        onClick: () => toggleSort(m.key),
-        className: "inline-flex items-center gap-1 hover:text-foreground",
-        children: [
-          m.label,
-          sortMark(m.key)
-        ]
-      }
-    ),
-    comparing ? /* @__PURE__ */ (0, import_jsx_runtime42.jsxs)(
-      "button",
-      {
-        type: "button",
-        "data-matrx-drill-sort": `delta:${m.key}`,
-        "aria-label": `Sort groups by the change in ${m.label}`,
-        title: "Sort by the change against the prior window",
-        onClick: () => toggleSort(`delta:${m.key}`),
-        className: "ml-1.5 inline-flex items-center gap-0.5 hover:text-foreground",
-        children: [
-          "\u0394",
-          sortMark(`delta:${m.key}`)
-        ]
-      }
-    ) : null
-  ] }, id);
+  const measureHeader = (m, id, column) => {
+    const key = column ? drillPivotSortKey(m.key, column.value) : m.key;
+    return /* @__PURE__ */ (0, import_jsx_runtime42.jsxs)("th", { scope: "col", className: "whitespace-nowrap px-2 py-2 text-right text-xs font-medium text-muted-foreground", children: [
+      /* @__PURE__ */ (0, import_jsx_runtime42.jsxs)(
+        "button",
+        {
+          type: "button",
+          "data-matrx-drill-sort": key,
+          "aria-label": `Sort groups by ${m.label}`,
+          title: m.description,
+          onClick: () => toggleSort(key),
+          className: "inline-flex items-center gap-1 hover:text-foreground",
+          children: [
+            m.label,
+            sortMark(key)
+          ]
+        }
+      ),
+      comparing ? /* @__PURE__ */ (0, import_jsx_runtime42.jsxs)(
+        "button",
+        {
+          type: "button",
+          "data-matrx-drill-sort": `delta:${m.key}`,
+          "aria-label": `Sort groups by the change in ${m.label}`,
+          title: "Sort by the change against the prior window",
+          onClick: () => toggleSort(`delta:${m.key}`),
+          className: "ml-1.5 inline-flex items-center gap-0.5 hover:text-foreground",
+          children: [
+            "\u0394",
+            sortMark(`delta:${m.key}`)
+          ]
+        }
+      ) : null
+    ] }, id);
+  };
   const labelHeader = question.by.map((ref) => dimensionRefLabel(dimensions, ref)).join(" \u203A ");
-  const colCount = 1 + (pivot && columns ? (columns.length + 1) * shown.length : shown.length) + 1;
+  const colCount = 1 + glanceShown.length + (pivot && columns ? (columns.length + 1) * shown.length : shown.length) + 1;
   const renderOther = (other, depth, key, siblings = []) => {
     if (!other) return null;
     const distinct = siblings.reduce((m, n) => {
@@ -45425,6 +45494,7 @@ function MatrxDrillAnswerTable({
                 type: "button",
                 "data-matrx-drill-sort": "label",
                 "aria-label": `Sort groups by ${labelHeader}`,
+                title: question.by.length === 1 ? dimensionFor(dimensions, question.by[0])?.description : void 0,
                 onClick: () => toggleSort("label"),
                 className: "inline-flex items-center gap-1 hover:text-foreground",
                 children: [
@@ -45433,7 +45503,12 @@ function MatrxDrillAnswerTable({
                 ]
               }
             ) }),
-            pivot && columns ? [...columns.map((c) => c.value ?? "\u2205"), "total"].flatMap((col) => shown.map((m) => measureHeader(m, `${col}::${m.key}`))) : shown.map((m) => measureHeader(m, m.key)),
+            glanceShown.map((a) => /* @__PURE__ */ (0, import_jsx_runtime42.jsx)("th", { scope: "col", "data-matrx-drill-attribute-header": a.key, title: a.description, className: "whitespace-nowrap px-2 py-2 text-left text-xs font-medium text-muted-foreground", children: a.label }, `attr-${a.key}`)),
+            pivot && columns ? [
+              // a named pivot column sorts by its own cell (L5); the rest column and the total by the row's number
+              ...columns.flatMap((c) => shown.map((m) => measureHeader(m, `${c.value ?? "\u2205"}::${m.key}`, c.other ? void 0 : { value: c.value }))),
+              ...shown.map((m) => measureHeader(m, `total::${m.key}`))
+            ] : shown.map((m) => measureHeader(m, m.key)),
             pivot ? null : /* @__PURE__ */ (0, import_jsx_runtime42.jsx)("th", { className: "w-8", "aria-label": "Drill options" })
           ] })
         ] }),
@@ -45454,6 +45529,7 @@ function MatrxDrillAnswerTable({
             /* @__PURE__ */ (0, import_jsx_runtime42.jsx)("span", { className: "pl-[1.625rem]", children: "Total" }),
             /* @__PURE__ */ (0, import_jsx_runtime42.jsx)("span", { className: "ml-1.5 text-xs font-normal text-muted-foreground", children: plural(tree.total.row_count, rowNoun) })
           ] }),
+          glanceShown.map((a) => /* @__PURE__ */ (0, import_jsx_runtime42.jsx)("td", {}, `t-attr-${a.key}`)),
           pivot && columns ? [
             ...columns.flatMap(
               (column) => shown.map((m) => /* @__PURE__ */ (0, import_jsx_runtime42.jsx)("td", { className: "px-2 py-2 text-right text-xs", children: formatMeasure(m, column.total.measures[m.key]) }, `t-${column.value ?? "\u2205"}-${m.key}`))