twico-ui 1.28.0 → 1.29.0

package/dist/index.d.cts

@@ -1949,6 +1949,13 @@ interface DatatableProps<T = any> extends Omit<React.HTMLAttributes<HTMLDivEleme
   selectionMode?: "none" | "row" | "cell";
   /** Fired when a row is clicked in "row" selection mode: (row, key). */
   onRowClick?: (row: T, key: string | number) => void;
+  /** #324: controlled highlighted row key for `selectionMode="row"`. When provided, the grid highlights THIS
+   *  row (not its internal state) and reports clicks via `onRowClick` so you update the prop — the same
+   *  controlled/uncontrolled split as `page`. Pass `null` to clear. Lets an external selection (a graph, a
+   *  master/detail pane) drive the row highlight, with scroll-into-view. */
+  activeRowId?: string | number | null;
+  /** #324: scroll the controlled active row into view when `activeRowId` changes. @default true */
+  scrollActiveRowIntoView?: boolean;
   /** Fired when a cell is clicked in "cell" selection mode: (value, row, field). */
   onCellClick?: (value: any, row: T, field: string) => void;
   /** Fired when the active cell changes: ({ key, field } | null). */

package/dist/index.d.ts

@@ -1949,6 +1949,13 @@ interface DatatableProps<T = any> extends Omit<React.HTMLAttributes<HTMLDivEleme
   selectionMode?: "none" | "row" | "cell";
   /** Fired when a row is clicked in "row" selection mode: (row, key). */
   onRowClick?: (row: T, key: string | number) => void;
+  /** #324: controlled highlighted row key for `selectionMode="row"`. When provided, the grid highlights THIS
+   *  row (not its internal state) and reports clicks via `onRowClick` so you update the prop — the same
+   *  controlled/uncontrolled split as `page`. Pass `null` to clear. Lets an external selection (a graph, a
+   *  master/detail pane) drive the row highlight, with scroll-into-view. */
+  activeRowId?: string | number | null;
+  /** #324: scroll the controlled active row into view when `activeRowId` changes. @default true */
+  scrollActiveRowIntoView?: boolean;
   /** Fired when a cell is clicked in "cell" selection mode: (value, row, field). */
   onCellClick?: (value: any, row: T, field: string) => void;
   /** Fired when the active cell changes: ({ key, field } | null). */

package/dist/index.mjs

@@ -9162,6 +9162,8 @@ function Datatable({
   onCellClick,
   onActiveCellChange,
   onCellSelectionChange,
+  activeRowId,
+  scrollActiveRowIntoView = true,
   enableClipboard = false,
   onCellsCopy,
   onCellsPaste,
@@ -9294,6 +9296,8 @@ function Datatable({
   };
   const [selected, setSelected] = React51__default.useState(() => /* @__PURE__ */ new Set());
   const [activeRow, setActiveRow] = React51__default.useState(null);
+  const activeRowControlled = activeRowId !== void 0;
+  const activeRowVal = activeRowControlled ? activeRowId : activeRow;
   const [activeCell, setActiveCell] = React51__default.useState(null);
   const [anchorCell, setAnchorCell] = React51__default.useState(null);
   const gridId = React51__default.useId();
@@ -10281,7 +10285,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);
     }
@@ -10360,8 +10364,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;
@@ -10402,6 +10407,11 @@ function Datatable({
     prevRowSelSigRef.current = sig;
     cb(selKeys, selectedRows);
   }, [selKeys, selectedRows]);
+  React51__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());
   }
@@ -11119,7 +11129,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 } : {} };