twico-ui 1.37.2 → 1.38.0

package/dist/index.d.cts

@@ -1907,6 +1907,12 @@ interface DatatableProps<T = any> extends Omit<React.HTMLAttributes<HTMLDivEleme
   showDensity?: boolean;
   /** Show the Pivot toolbar button. Also shown automatically when `pivot` or `pivotMode` is set. @default false */
   showPivot?: boolean;
+  /** Show the **Columns** toolbar button (the show/hide picker). Omit for the smart default — shown only when a
+   *  column is `hideable` or `rowNumbers` is on (else the picker would be empty). `true`/`false` forces it. */
+  showColumns?: boolean;
+  /** Show the **Filters** toolbar button (the filter builder). Omit for the smart default — shown only when a
+   *  column is `filterable` (else the builder would be empty). `true`/`false` forces it. */
+  showFilters?: boolean;
   /** Filename (without extension) for exports (CSV / Excel). @default "export" */
   exportFilename?: string;
   /** Server-mode precomputed aggregation. Per field, either a scalar/node (used as-is) or a per-function map
@@ -2011,6 +2017,16 @@ interface DatatableProps<T = any> extends Omit<React.HTMLAttributes<HTMLDivEleme
   ariaLabel?: string;
   /** Row-grouping fields (collapsible groups with subtotals). Changing the prop re-applies it; users can also group via a column's ⋮ menu. @default [] */
   rowGrouping?: string[];
+  /** Show the "Grouped by …" bar above the header (with the per-field chips + Clear all). Set `false` for a
+   *  screen whose layout **is** the grouping — the bar's remove/clear controls would otherwise let the user
+   *  dismantle a grouping they can't restore. Grouping still applies; only the bar is hidden. @default true */
+  showGroupBar?: boolean;
+  /** #387: custom content for a group header row (the chevron + collapse/expand toggle are kept). Return the
+   *  node to render in place of the default `"<field>: <value>  <count>"` — e.g. a section title + a summary.
+   *  `rows` is the group's rows; `count` is their number. Return `null` to render an empty label (matching
+   *  `renderCell`/`renderHeader`). The content sits **inside** the group's toggle button, so keep it
+   *  non-interactive — a nested button/link would be invalid HTML and its clicks would also toggle the group. */
+  renderGroupLabel?: (group: { field: string; value: unknown; count: number; rows: T[] }) => React.ReactNode;
   /** Enable row pinning — adds "Pin to top/bottom" to each row's actions menu; pinned rows stay sticky above/below the scroll body. @default false */
   rowPinning?: boolean;
   /** Enable reorder of rows: the whole row is mouse-draggable, and a focusable drag handle supports

package/dist/index.d.ts

@@ -1907,6 +1907,12 @@ interface DatatableProps<T = any> extends Omit<React.HTMLAttributes<HTMLDivEleme
   showDensity?: boolean;
   /** Show the Pivot toolbar button. Also shown automatically when `pivot` or `pivotMode` is set. @default false */
   showPivot?: boolean;
+  /** Show the **Columns** toolbar button (the show/hide picker). Omit for the smart default — shown only when a
+   *  column is `hideable` or `rowNumbers` is on (else the picker would be empty). `true`/`false` forces it. */
+  showColumns?: boolean;
+  /** Show the **Filters** toolbar button (the filter builder). Omit for the smart default — shown only when a
+   *  column is `filterable` (else the builder would be empty). `true`/`false` forces it. */
+  showFilters?: boolean;
   /** Filename (without extension) for exports (CSV / Excel). @default "export" */
   exportFilename?: string;
   /** Server-mode precomputed aggregation. Per field, either a scalar/node (used as-is) or a per-function map
@@ -2011,6 +2017,16 @@ interface DatatableProps<T = any> extends Omit<React.HTMLAttributes<HTMLDivEleme
   ariaLabel?: string;
   /** Row-grouping fields (collapsible groups with subtotals). Changing the prop re-applies it; users can also group via a column's ⋮ menu. @default [] */
   rowGrouping?: string[];
+  /** Show the "Grouped by …" bar above the header (with the per-field chips + Clear all). Set `false` for a
+   *  screen whose layout **is** the grouping — the bar's remove/clear controls would otherwise let the user
+   *  dismantle a grouping they can't restore. Grouping still applies; only the bar is hidden. @default true */
+  showGroupBar?: boolean;
+  /** #387: custom content for a group header row (the chevron + collapse/expand toggle are kept). Return the
+   *  node to render in place of the default `"<field>: <value>  <count>"` — e.g. a section title + a summary.
+   *  `rows` is the group's rows; `count` is their number. Return `null` to render an empty label (matching
+   *  `renderCell`/`renderHeader`). The content sits **inside** the group's toggle button, so keep it
+   *  non-interactive — a nested button/link would be invalid HTML and its clicks would also toggle the group. */
+  renderGroupLabel?: (group: { field: string; value: unknown; count: number; rows: T[] }) => React.ReactNode;
   /** Enable row pinning — adds "Pin to top/bottom" to each row's actions menu; pinned rows stay sticky above/below the scroll body. @default false */
   rowPinning?: boolean;
   /** Enable reorder of rows: the whole row is mouse-draggable, and a focusable drag handle supports

package/dist/index.mjs

@@ -7958,7 +7958,11 @@ var TOOLTIP_CSS = `
      (opacity:0) nor a shown bubble can block neighbouring cells/buttons (matches MUI/Radix tooltips). */
   pointer-events: none;
   padding: 6px 10px; border-radius: var(--radius-md);
-  background: var(--color-text); color: var(--color-surface);
+  /* #385: capture the ink as the bubble bg via a private var BEFORE the content wrapper re-scopes
+     --color-text, so a token-driven child (Text/Heading) reads the bubble's fg \u2014 not the page ink,
+     which is this very background \u2014 and the re-scope can't feed back into the bg. */
+  --_tt-bg: var(--color-text); --_tt-fg: var(--color-surface);
+  background: var(--_tt-bg); color: var(--_tt-fg);
   font-family: var(--font-sans); font-size: var(--text-xs); font-weight: var(--font-medium);
   line-height: 1.3; white-space: normal;
   /* Grow horizontally to max-width, then wrap. max-content sizes to the content (capped by
@@ -7974,7 +7978,13 @@ var TOOLTIP_CSS = `
 .twc-tooltip[data-place="left"]   { transform-origin: right center; translate: 0 -50%; }
 .twc-tooltip[data-place="right"]  { transform-origin: left center; translate: 0 -50%; }
 .twc-tooltip[data-show="true"][data-place="top"], .twc-tooltip[data-show="true"][data-place="bottom"] { transform: scale(1); }
-.twc-tooltip__arrow { position: absolute; width: 7px; height: 7px; background: var(--color-text); transform: rotate(45deg); }
+.twc-tooltip__arrow { position: absolute; width: 7px; height: 7px; background: var(--_tt-bg); transform: rotate(45deg); }
+/* #385: re-scope token ink for the label subtree so Text/Heading (which set --color-text as an inline
+   style) render in the bubble's fg instead of the page ink. display:contents adds no box, so the label's
+   own flex/block layout is unchanged; custom properties still inherit through it. */
+.twc-tooltip__content { display: contents; --color-text: var(--_tt-fg);
+  --color-text-muted: color-mix(in srgb, var(--_tt-fg) 72%, var(--_tt-bg));
+  --color-text-subtle: color-mix(in srgb, var(--_tt-fg) 55%, var(--_tt-bg)); }
 /* Arrow tracks the trigger via --_tw-arrow-x/y (px from the tooltip edge) instead of being
    locked to the centre, so it still points at the trigger when the bubble is clamped near a
    viewport edge. Falls back to 50% before measurement / SSR. */
@@ -8099,7 +8109,7 @@ function Tooltip({
           "--_tw-arrow-y": coords.arrowY != null ? `${coords.arrowY}px` : void 0
         },
         children: [
-          label,
+          /* @__PURE__ */ jsx("span", { className: "twc-tooltip__content", children: label }),
           /* @__PURE__ */ jsx("span", { className: "twc-tooltip__arrow", "aria-hidden": "true" })
         ]
       }
@@ -9279,6 +9289,8 @@ function Datatable({
   showExport = false,
   showDensity = false,
   showPivot = false,
+  showColumns,
+  showFilters,
   exportFilename = "export",
   aggregationValues = null,
   disableColumnReorder = false,
@@ -9310,6 +9322,8 @@ function Datatable({
   ariaLabel = "Data table",
   "aria-label": ariaLabelAttr,
   rowGrouping = [],
+  showGroupBar = true,
+  renderGroupLabel,
   rowNumbers = false,
   searchFields = null,
   searchable = true,
@@ -11089,6 +11103,8 @@ function Datatable({
   }
   const tableMinWidth = leadW + ordered.reduce((a, c) => a + widthOf(c), 0);
   const filterableCols = React51__default.useMemo(() => cols.filter((c) => c.filterable), [cols]);
+  const columnsShown = showColumns !== void 0 ? showColumns : cols.some((c) => c.hideable) || rowNumbers;
+  const filtersShown = showFilters !== void 0 ? showFilters : filterableCols.length > 0;
   React51__default.useEffect(() => {
     const el = filterPanelRef.current;
     if (panel !== "filters" || !el || typeof document === "undefined") return void 0;
@@ -11475,6 +11491,7 @@ function Datatable({
   const totalCols = ordered.length + (checkboxSelection ? 1 : 0) + (showRowNum ? 1 : 0) + (hasExpandCol ? 1 : 0);
   function renderGroupRow(item) {
     const subs = aggOn ? subtotalText(item.rows) : [];
+    const custom = renderGroupLabel ? renderGroupLabel({ field: item.field, value: item.value, count: item.count, rows: item.rows }) : null;
     return /* @__PURE__ */ jsx("tr", { className: "twc-dt__group-row", role: "row", children: /* @__PURE__ */ jsxs("td", { className: "twc-dt__group-cell", role: "gridcell", colSpan: totalCols, style: { maxWidth: "none" }, children: [
       /* @__PURE__ */ jsxs(
         "button",
@@ -11486,12 +11503,14 @@ function Datatable({
           onClick: () => toggleGroup(item.key),
           children: [
             /* @__PURE__ */ jsx("span", { className: "twc-dt__group-chev", "data-open": !item.collapsed || void 0, children: /* @__PURE__ */ jsx(Svg, { d: I.chevDown }) }),
-            /* @__PURE__ */ jsxs("span", { className: "twc-dt__group-name", children: [
-              fieldLabel(item.field),
-              ":"
-            ] }),
-            /* @__PURE__ */ jsx("span", { className: "twc-dt__group-val", children: String(item.value) }),
-            /* @__PURE__ */ jsx("span", { className: "twc-dt__group-count", children: item.count })
+            renderGroupLabel ? custom : /* @__PURE__ */ jsxs(Fragment, { children: [
+              /* @__PURE__ */ jsxs("span", { className: "twc-dt__group-name", children: [
+                fieldLabel(item.field),
+                ":"
+              ] }),
+              /* @__PURE__ */ jsx("span", { className: "twc-dt__group-val", children: String(item.value) }),
+              /* @__PURE__ */ jsx("span", { className: "twc-dt__group-count", children: item.count })
+            ] })
           ]
         }
       ),
@@ -11856,11 +11875,12 @@ function Datatable({
         /* @__PURE__ */ jsx("input", { type: "checkbox", checked: diffOnly, onChange: (e) => setDiffOnly(e.target.checked) }),
         diff.toggleLabel != null ? diff.toggleLabel : "Only changed"
       ] }) : null,
-      /* @__PURE__ */ jsxs(
+      columnsShown ? /* @__PURE__ */ jsxs(
         "button",
         {
           type: "button",
           className: "twc-dt__tbtn",
+          "data-tbtn": "columns",
           "data-active": panel === "columns" || void 0,
           "data-tip": "Show or hide columns",
           onClick: (e) => {
@@ -11880,12 +11900,13 @@ function Datatable({
             hidden.size ? /* @__PURE__ */ jsx("span", { className: "twc-dt__tbadge", children: cols.length - hidden.size }) : null
           ]
         }
-      ),
-      /* @__PURE__ */ jsxs(
+      ) : null,
+      filtersShown ? /* @__PURE__ */ jsxs(
         "button",
         {
           type: "button",
           className: "twc-dt__tbtn",
+          "data-tbtn": "filters",
           "data-active": panel === "filters" || void 0,
           "data-tip": "Filter rows",
           onClick: (e) => {
@@ -11904,7 +11925,7 @@ function Datatable({
             filters.length ? /* @__PURE__ */ jsx("span", { className: "twc-dt__tbadge", children: filters.length }) : null
           ]
         }
-      ),
+      ) : null,
       showDensity ? /* @__PURE__ */ jsxs("button", { type: "button", className: "twc-dt__tbtn", "data-tip": "Change row density", onClick: () => setDensity((d) => d === "compact" ? "standard" : d === "standard" ? "comfortable" : "compact"), children: [
         /* @__PURE__ */ jsx(Svg, { d: I.density }),
         /* @__PURE__ */ jsx("span", { className: "twc-dt__tlabel", children: density[0].toUpperCase() + density.slice(1) })
@@ -12001,7 +12022,7 @@ function Datatable({
         }, children: /* @__PURE__ */ jsx(Svg, { d: I.x }) }) : null
       ] }) : null
     ] }),
-    !pivotActive && activeGroupBy.length ? /* @__PURE__ */ jsxs("div", { className: "twc-dt__groupbar", children: [
+    !pivotActive && activeGroupBy.length && showGroupBar ? /* @__PURE__ */ jsxs("div", { className: "twc-dt__groupbar", children: [
       /* @__PURE__ */ jsx(Svg, { d: I.group }),
       /* @__PURE__ */ jsx("span", { className: "twc-dt__groupbar-label", children: "Grouped by" }),
       activeGroupBy.map((f) => /* @__PURE__ */ jsxs("span", { className: "twc-dt__groupchip", children: [
@@ -12476,13 +12497,13 @@ function Datatable({
                   " Sort descending"
                 ] })
               ] }) : null,
-              c.filterable ? /* @__PURE__ */ jsxs("button", { type: "button", role: "menuitem", className: "twc-dt__mi", onClick: (e) => {
+              c.filterable && filtersShown ? /* @__PURE__ */ jsxs("button", { type: "button", role: "menuitem", className: "twc-dt__mi", onClick: (e) => {
                 addFilter(c.field);
                 setColMenu(null);
                 closeMenu();
                 restoreTriggerFocus();
                 setPanel("filters");
-                openPanel(document.querySelector(".twc-dt__toolbar .twc-dt__tbtn:nth-child(2)"), "left", DT_FILTER_PANEL_W);
+                openPanel(document.querySelector('.twc-dt__toolbar .twc-dt__tbtn[data-tbtn="filters"]'), "left", DT_FILTER_PANEL_W);
               }, children: [
                 /* @__PURE__ */ jsx(Svg, { d: I.filter }),
                 " Filter"
@@ -12555,7 +12576,7 @@ function Datatable({
                 " ",
                 wrapped.has(c.field) ? "Unwrap text" : "Wrap text"
               ] }) : null,
-              c.hideable ? /* @__PURE__ */ jsxs("button", { type: "button", role: "menuitem", className: "twc-dt__mi", onClick: () => {
+              c.hideable && columnsShown ? /* @__PURE__ */ jsxs("button", { type: "button", role: "menuitem", className: "twc-dt__mi", onClick: () => {
                 setHidden((h) => new Set(h).add(c.field));
                 close();
               }, children: [