twico-ui 1.27.0 → 1.29.0

package/CHANGELOG.md

@@ -2,6 +2,20 @@
 
 All notable changes to Twico UI are documented here (newest first). This file is generated automatically on each release by [semantic-release](https://semantic-release.gitbook.io/) from [Conventional Commits](https://www.conventionalcommits.org/) — do not edit it by hand. The same notes appear on each [GitHub Release](https://github.com/EncryptionL/twico-ui/releases).
 
+# [1.29.0](https://github.com/EncryptionL/twico-ui/compare/v1.28.0...v1.29.0) (2026-08-03)
+
+
+### Features
+
+* **datatable:** controlled active row for selectionMode="row" (activeRowId) ([#324](https://github.com/EncryptionL/twico-ui/issues/324)) ([c118a06](https://github.com/EncryptionL/twico-ui/commit/c118a069d3f91ce9640b39751cab24717569be2b))
+
+# [1.28.0](https://github.com/EncryptionL/twico-ui/compare/v1.27.0...v1.28.0) (2026-08-03)
+
+
+### Features
+
+* **datatable:** selection-aware batch actions (predicate disabled/hidden) + onRowSelectionChange ([#322](https://github.com/EncryptionL/twico-ui/issues/322)) ([33a1c36](https://github.com/EncryptionL/twico-ui/commit/33a1c36340e36cf0c9cc763cda7ed5d26fd46baa))
+
 # [1.27.0](https://github.com/EncryptionL/twico-ui/compare/v1.26.0...v1.27.0) (2026-08-03)
 
 

package/dist/index.cjs

@@ -9158,6 +9158,7 @@ function Datatable({
   onServerChange,
   onColumnVisibilityChange,
   batchActions = [],
+  onRowSelectionChange,
   showExport = false,
   showDensity = false,
   showPivot = false,
@@ -9182,6 +9183,8 @@ function Datatable({
   onCellClick,
   onActiveCellChange,
   onCellSelectionChange,
+  activeRowId,
+  scrollActiveRowIntoView = true,
   enableClipboard = false,
   onCellsCopy,
   onCellsPaste,
@@ -9314,6 +9317,8 @@ function Datatable({
   };
   const [selected, setSelected] = React51__namespace.default.useState(() => /* @__PURE__ */ new Set());
   const [activeRow, setActiveRow] = React51__namespace.default.useState(null);
+  const activeRowControlled = activeRowId !== void 0;
+  const activeRowVal = activeRowControlled ? activeRowId : activeRow;
   const [activeCell, setActiveCell] = React51__namespace.default.useState(null);
   const [anchorCell, setAnchorCell] = React51__namespace.default.useState(null);
   const gridId = React51__namespace.default.useId();
@@ -10301,7 +10306,7 @@ function Datatable({
     if (selectionMode === "none") return;
     if (e.target.closest("button, a, input, select, .twc-dt__check, .twc-dt__editor-wrap")) return;
     if (selectionMode === "row") {
-      setActiveRow(k);
+      if (!activeRowControlled) setActiveRow(k);
       onRowClick?.(row, k);
       onActiveCellChange?.(null);
     }
@@ -10380,8 +10385,9 @@ function Datatable({
         }
         if (selectionMode === "row") {
           e.preventDefault();
-          setActiveRow(keyOf(leafRows[r2], r2));
-          onRowClick?.(leafRows[r2], keyOf(leafRows[r2], r2));
+          const rk = keyOf(leafRows[r2], r2);
+          if (!activeRowControlled) setActiveRow(rk);
+          onRowClick?.(leafRows[r2], rk);
           return;
         }
         handled = false;
@@ -10410,6 +10416,23 @@ function Datatable({
     setFocus((f) => ({ r: Math.min(f.r, Math.max(0, leafRows.length - 1)), c: Math.min(f.c, Math.max(0, ordered.length - 1)) }));
   }, [leafRows.length, ordered.length, pageVal]);
   const selectedRows = React51__namespace.default.useMemo(() => rows.filter((r2, i) => selected.has(keyOf(r2, i))), [rows, selected]);
+  const selKeys = React51__namespace.default.useMemo(() => [...selected], [selected]);
+  const onRowSelRef = React51__namespace.default.useRef(onRowSelectionChange);
+  onRowSelRef.current = onRowSelectionChange;
+  const prevRowSelSigRef = React51__namespace.default.useRef("");
+  React51__namespace.default.useEffect(() => {
+    const cb = onRowSelRef.current;
+    if (!cb) return;
+    const sig = selKeys.join(",");
+    if (sig === prevRowSelSigRef.current) return;
+    prevRowSelSigRef.current = sig;
+    cb(selKeys, selectedRows);
+  }, [selKeys, selectedRows]);
+  React51__namespace.default.useEffect(() => {
+    if (!activeRowControlled || !scrollActiveRowIntoView || activeRowId == null) return;
+    const el = gridRef.current && gridRef.current.querySelector('.twc-dt__row[data-active="true"]');
+    if (el && el.scrollIntoView) el.scrollIntoView({ block: "nearest" });
+  }, [activeRowId, activeRowControlled, scrollActiveRowIntoView]);
   function clearSelection() {
     setSelected(/* @__PURE__ */ new Set());
   }
@@ -10506,11 +10529,11 @@ function Datatable({
       }
       patch[c.field] = v;
     });
-    const selKeys = new Set(selected);
+    const selKeys2 = new Set(selected);
     const changedRows = [];
     const nextAll = rows.map((r2, i) => {
       const k = keyOf(r2, i);
-      if (!selKeys.has(k)) return r2;
+      if (!selKeys2.has(k)) return r2;
       const updated = { ...r2, ...patch };
       changedRows.push(updated);
       return updated;
@@ -11127,7 +11150,7 @@ function Datatable({
   function renderLeaf(row, ri, pinSide, midIdx) {
     const k = keyOf(row, ri);
     const sel = selected.has(k);
-    const rowActive = selectionMode === "row" && activeRow === k;
+    const rowActive = selectionMode === "row" && activeRowVal === k;
     const stickyStyle = pinSide === "top" ? { position: "sticky", top: headH, zIndex: 5 } : pinSide === "bottom" ? { position: "sticky", bottom: 0, zIndex: 5 } : void 0;
     const h = rowHeights[k];
     const rowStyle = { ...stickyStyle || {}, ...h ? { height: h } : {} };
@@ -11400,21 +11423,26 @@ function Datatable({
             /* @__PURE__ */ jsxRuntime.jsx(Svg, { d: I.pencil }),
             "Edit"
           ] }) : null,
-          batchActions.map((a, i) => /* @__PURE__ */ jsxRuntime.jsxs(
-            "button",
-            {
-              type: "button",
-              className: "twc-dt__batch-btn",
-              "data-danger": a.danger || void 0,
-              disabled: a.disabled,
-              onClick: (e) => a.onClick?.([...selected], selectedRows, clearSelection, { anchorEl: e.currentTarget }),
-              children: [
-                a.icon,
-                a.label
-              ]
-            },
-            i
-          ))
+          batchActions.map((a, i) => {
+            const isHidden = typeof a.hidden === "function" ? a.hidden(selKeys, selectedRows) : !!a.hidden;
+            if (isHidden) return null;
+            const isDisabled = typeof a.disabled === "function" ? a.disabled(selKeys, selectedRows) : !!a.disabled;
+            return /* @__PURE__ */ jsxRuntime.jsxs(
+              "button",
+              {
+                type: "button",
+                className: "twc-dt__batch-btn",
+                "data-danger": a.danger || void 0,
+                disabled: isDisabled,
+                onClick: (e) => a.onClick?.(selKeys, selectedRows, clearSelection, { anchorEl: e.currentTarget }),
+                children: [
+                  a.icon,
+                  a.label
+                ]
+              },
+              i
+            );
+          })
         ] })
       ] }) : null,
       isDiff && diff.showSummary !== false ? /* @__PURE__ */ jsxRuntime.jsxs("span", { className: "twc-dt__diff-summary", "aria-label": "Diff summary", children: [