@toolbox-web/grid 1.12.1 → 1.14.0

package/lib/plugins/selection/index.js

@@ -1,20 +1,20 @@
-function S(r) {
-  if (!r) return -1;
-  const e = r.getAttribute("data-row");
+function R(o) {
+  if (!o) return -1;
+  const e = o.getAttribute("data-row");
   if (e) return parseInt(e, 10);
-  const t = r.closest(".data-grid-row");
+  const t = o.closest(".data-grid-row");
   if (!t) return -1;
   const s = t.parentElement;
   if (!s) return -1;
-  const i = s.querySelectorAll(":scope > .data-grid-row");
-  for (let l = 0; l < i.length; l++)
-    if (i[l] === t) return l;
+  const r = s.querySelectorAll(":scope > .data-grid-row");
+  for (let n = 0; n < r.length; n++)
+    if (r[n] === t) return n;
   return -1;
 }
-function m(r) {
-  r && r.querySelectorAll(".cell-focus").forEach((e) => e.classList.remove("cell-focus"));
+function C(o) {
+  o && o.querySelectorAll(".cell-focus").forEach((e) => e.classList.remove("cell-focus"));
 }
-const R = '<svg viewBox="0 0 16 16" width="12" height="12"><path fill="currentColor" d="M6 10.5a.5.5 0 0 1 .5-.5h3a.5.5 0 0 1 0 1h-3a.5.5 0 0 1-.5-.5zm-2-3a.5.5 0 0 1 .5-.5h7a.5.5 0 0 1 0 1h-7a.5.5 0 0 1-.5-.5zm-2-3a.5.5 0 0 1 .5-.5h11a.5.5 0 0 1 0 1h-11a.5.5 0 0 1-.5-.5z"/></svg>', y = {
+const p = '<svg viewBox="0 0 16 16" width="12" height="12"><path fill="currentColor" d="M6 10.5a.5.5 0 0 1 .5-.5h3a.5.5 0 0 1 0 1h-3a.5.5 0 0 1-.5-.5zm-2-3a.5.5 0 0 1 .5-.5h7a.5.5 0 0 1 0 1h-7a.5.5 0 0 1-.5-.5zm-2-3a.5.5 0 0 1 .5-.5h11a.5.5 0 0 1 0 1h-11a.5.5 0 0 1-.5-.5z"/></svg>', A = {
   expand: "▶",
   collapse: "▼",
   sortAsc: "▲",
@@ -23,8 +23,8 @@ const R = '<svg viewBox="0 0 16 16" width="12" height="12"><path fill="currentCo
   submenuArrow: "▶",
   dragHandle: "⋮⋮",
   toolPanel: "☰",
-  filter: R,
-  filterActive: R,
+  filter: p,
+  filterActive: p,
   print: "🖨️"
 };
 class v {
@@ -317,7 +317,7 @@ class v {
    */
   get gridIcons() {
     const e = this.grid?.gridConfig?.icons ?? {};
-    return { ...y, ...e };
+    return { ...A, ...e };
   }
   // #region Animation Helpers
   /**
@@ -393,65 +393,69 @@ class v {
   }
   // #endregion
 }
-function g(r) {
-  return r.meta?.utility === !0;
+const E = "__tbw_expander";
+function k(o) {
+  return o.field === E;
 }
-function u(r) {
+function f(o) {
+  return o.meta?.utility === !0;
+}
+function g(o) {
   return {
-    startRow: Math.min(r.startRow, r.endRow),
-    startCol: Math.min(r.startCol, r.endCol),
-    endRow: Math.max(r.startRow, r.endRow),
-    endCol: Math.max(r.startCol, r.endCol)
+    startRow: Math.min(o.startRow, o.endRow),
+    startCol: Math.min(o.startCol, o.endCol),
+    endRow: Math.max(o.startRow, o.endRow),
+    endCol: Math.max(o.startCol, o.endCol)
   };
 }
-function E(r) {
-  const e = u(r);
+function I(o) {
+  const e = g(o);
   return {
     from: { row: e.startRow, col: e.startCol },
     to: { row: e.endRow, col: e.endCol }
   };
 }
-function p(r) {
-  return r.map(E);
+function y(o) {
+  return o.map(I);
 }
-function x(r, e, t) {
-  const s = u(t);
-  return r >= s.startRow && r <= s.endRow && e >= s.startCol && e <= s.endCol;
+function _(o, e, t) {
+  const s = g(t);
+  return o >= s.startRow && o <= s.endRow && e >= s.startCol && e <= s.endCol;
 }
-function C(r, e, t) {
-  return t.some((s) => x(r, e, s));
+function q(o, e, t) {
+  return t.some((s) => _(o, e, s));
 }
-function I(r) {
-  const e = [], t = u(r);
+function K(o) {
+  const e = [], t = g(o);
   for (let s = t.startRow; s <= t.endRow; s++)
-    for (let i = t.startCol; i <= t.endCol; i++)
-      e.push({ row: s, col: i });
+    for (let r = t.startCol; r <= t.endCol; r++)
+      e.push({ row: s, col: r });
   return e;
 }
-function q(r) {
+function M(o) {
   const e = /* @__PURE__ */ new Map();
-  for (const t of r)
-    for (const s of I(t))
+  for (const t of o)
+    for (const s of K(t))
       e.set(`${s.row},${s.col}`, s);
   return [...e.values()];
 }
-function b(r, e) {
+function m(o, e) {
   return {
-    startRow: r.row,
-    startCol: r.col,
+    startRow: o.row,
+    startCol: o.col,
     endRow: e.row,
     endCol: e.col
   };
 }
-function w(r, e) {
-  const t = u(r), s = u(e);
+function b(o, e) {
+  const t = g(o), s = g(e);
   return t.startRow === s.startRow && t.startCol === s.startCol && t.endRow === s.endRow && t.endCol === s.endCol;
 }
-const k = "@layer tbw-plugins{tbw-grid.selecting .data-grid-row>.cell{-webkit-user-select:none;user-select:none}tbw-grid:has(.selection){-webkit-user-select:none;user-select:none}tbw-grid[data-has-focus] .data-grid-row.row-focus{background-color:var(--tbw-focus-background, rgba(from var(--tbw-color-accent) r g b / 12%))}tbw-grid[data-selection-mode=row] .cell-focus{outline:none}tbw-grid .data-grid-row>.cell.selected{background-color:var(--tbw-range-selection-bg)}tbw-grid .data-grid-row>.cell.selected.top{border-top:2px solid var(--tbw-range-border-color);padding-top:calc(var(--tbw-cell-padding, 2px 8px) - 2px)}tbw-grid .data-grid-row>.cell.selected.bottom{border-bottom:2px solid var(--tbw-range-border-color);padding-bottom:calc(var(--tbw-cell-padding, 2px 8px) - 2px)}tbw-grid .data-grid-row>.cell.selected.first{border-left:2px solid var(--tbw-range-border-color);padding-left:calc(var(--tbw-cell-padding, 2px 8px) - 2px)}tbw-grid .data-grid-row>.cell.selected.last{border-right:2px solid var(--tbw-range-border-color);padding-right:calc(var(--tbw-cell-padding, 2px 8px) - 2px)}tbw-grid .data-grid-row[data-selectable=false]{cursor:not-allowed;opacity:.6}tbw-grid .data-grid-row[data-selectable=false].row-focus{background-color:var(--tbw-color-row-alt)}tbw-grid .data-grid-row>.cell[data-selectable=false]{cursor:not-allowed;opacity:.6}tbw-grid .data-grid-row>.cell[data-selectable=false].selected{background-color:var(--tbw-selection-warning-bg, rgba(from var(--tbw-color-error) r g b / 50%))}tbw-grid .tbw-selection-summary{font-size:var(--tbw-font-size-sm, .8125rem);color:var(--tbw-color-fg-muted);white-space:nowrap}}";
-function _(r, e, t) {
-  if (r === "cell" && e.selectedCell)
+const F = '@layer tbw-plugins{tbw-grid.selecting .data-grid-row>.cell{-webkit-user-select:none;user-select:none}tbw-grid:has(.selection){-webkit-user-select:none;user-select:none}tbw-grid .data-grid-row.row-focus{background-color:var(--tbw-focus-background, rgba(from var(--tbw-color-accent) r g b / 12%));outline:none;position:relative}tbw-grid .data-grid-row.row-focus:after{content:"";position:absolute;inset:0;pointer-events:none;border-width:0;border-style:var(--tbw-selection-border-style, var(--tbw-border-style));border-color:var(--tbw-range-border-color, var(--tbw-color-accent));border-top-width:var(--tbw-selection-border-width, var(--tbw-border-width));border-bottom-width:var(--tbw-selection-border-width, var(--tbw-border-width));z-index:1}tbw-grid .data-grid-row.row-focus+.data-grid-row.row-focus:after{border-top-width:0}tbw-grid .data-grid-row.row-focus:has(+.data-grid-row.row-focus):after{border-bottom-width:0}tbw-grid[data-selection-mode=row] .cell-focus,tbw-grid[data-selection-mode=row] .row-focus,tbw-grid[data-selection-mode=range] .cell-focus{outline:none}tbw-grid .data-grid-row>.cell.selected{background-color:var(--tbw-range-selection-bg);position:relative}tbw-grid .data-grid-row>.cell.selected:after{content:"";position:absolute;inset:0;pointer-events:none;border:0 var(--tbw-selection-border-style, var(--tbw-border-style)) var(--tbw-range-border-color);z-index:1}tbw-grid .data-grid-row>.cell.selected.top:after{border-top-width:var(--tbw-selection-border-width, var(--tbw-border-width))}tbw-grid .data-grid-row>.cell.selected.bottom:after{border-bottom-width:var(--tbw-selection-border-width, var(--tbw-border-width))}tbw-grid .data-grid-row>.cell.selected.first:after{border-left-width:var(--tbw-selection-border-width, var(--tbw-border-width))}tbw-grid .data-grid-row>.cell.selected.last:after{border-right-width:var(--tbw-selection-border-width, var(--tbw-border-width))}tbw-grid .data-grid-row[data-selectable=false]{cursor:not-allowed;opacity:.6}tbw-grid .data-grid-row[data-selectable=false].row-focus{background-color:var(--tbw-color-row-alt)}tbw-grid .data-grid-row>.cell[data-selectable=false]{cursor:not-allowed;opacity:.6}tbw-grid .data-grid-row>.cell[data-selectable=false].selected{background-color:var(--tbw-selection-warning-bg, rgba(from var(--tbw-color-error) r g b / 50%))}tbw-grid .tbw-selection-summary{font-size:var(--tbw-font-size-sm, .8125rem);color:var(--tbw-color-fg-muted);white-space:nowrap}tbw-grid .data-grid-row>.cell[data-field=__tbw_checkbox],tbw-grid .header-row>.cell[data-field=__tbw_checkbox]{text-align:center;cursor:pointer;padding:0;display:flex;align-items:center;justify-content:center}tbw-grid .tbw-select-row-checkbox{pointer-events:none;margin:0;cursor:pointer}tbw-grid .tbw-checkbox-header{display:flex;justify-content:center;align-items:center;height:100%}tbw-grid .tbw-select-all-checkbox{margin:0;cursor:pointer}}', S = "__tbw_checkbox";
+function D(o, e, t) {
+  if (o === "cell" && e.selectedCell)
     return {
-      mode: r,
+      mode: o,
       ranges: [
         {
           from: { row: e.selectedCell.row, col: e.selectedCell.col },
@@ -459,22 +463,26 @@ function _(r, e, t) {
         }
       ]
     };
-  if (r === "row" && e.selected.size > 0) {
-    const s = [...e.selected].map((i) => ({
-      from: { row: i, col: 0 },
-      to: { row: i, col: t - 1 }
-    }));
-    return { mode: r, ranges: s };
-  }
-  return r === "range" && e.ranges.length > 0 ? { mode: r, ranges: p(e.ranges) } : { mode: r, ranges: [] };
+  if (o === "row" && e.selected.size > 0) {
+    const s = [...e.selected].sort((l, d) => l - d), r = [];
+    let n = s[0], i = n;
+    for (let l = 1; l < s.length; l++)
+      s[l] === i + 1 ? i = s[l] : (r.push({ from: { row: n, col: 0 }, to: { row: i, col: t - 1 } }), n = s[l], i = n);
+    return r.push({ from: { row: n, col: 0 }, to: { row: i, col: t - 1 } }), { mode: o, ranges: r };
+  }
+  return o === "range" && e.ranges.length > 0 ? { mode: o, ranges: y(e.ranges) } : { mode: o, ranges: [] };
 }
-class D extends v {
+class L extends v {
   /**
    * Plugin manifest - declares queries and configuration validation rules.
    * @internal
    */
   static manifest = {
-    queries: [{ type: "getSelection", description: "Get the current selection state" }],
+    queries: [
+      { type: "getSelection", description: "Get the current selection state" },
+      { type: "selectRows", description: "Select specific rows by index (row mode only)" },
+      { type: "getSelectedRowIndices", description: "Get sorted array of selected row indices" }
+    ],
     configRules: [
       {
         id: "selection/range-dblclick",
@@ -489,7 +497,7 @@ class D extends v {
   /** @internal */
   name = "selection";
   /** @internal */
-  styles = k;
+  styles = F;
   /** @internal */
   get defaultConfig() {
     return {
@@ -512,6 +520,12 @@ class D extends v {
   pendingKeyboardUpdate = null;
   /** Cell selection state (cell mode) */
   selectedCell = null;
+  /** Last synced focus row — used to detect when grid focus moves so selection follows */
+  lastSyncedFocusRow = -1;
+  /** Last synced focus col (cell mode) */
+  lastSyncedFocusCol = -1;
+  /** True when selection was explicitly set (click/keyboard) — prevents #syncSelectionToFocus from overwriting */
+  explicitSelection = !1;
   // #endregion
   // #region Private Helpers - Selection Enabled Check
   /**
@@ -530,10 +544,10 @@ class D extends v {
   checkSelectable(e, t) {
     const { isSelectable: s } = this.config;
     if (!s) return !0;
-    const i = this.rows[e];
-    if (!i) return !1;
-    const l = t !== void 0 ? this.columns[t] : void 0;
-    return s(i, e, l, t);
+    const r = this.rows[e];
+    if (!r) return !1;
+    const n = t !== void 0 ? this.columns[t] : void 0;
+    return s(r, e, n, t);
   }
   /**
    * Check if an entire row is selectable (for row mode).
@@ -560,42 +574,62 @@ class D extends v {
   handleQuery(e) {
     if (e.type === "getSelection")
       return this.getSelection();
+    if (e.type === "getSelectedRowIndices")
+      return this.getSelectedRowIndices();
+    if (e.type === "selectRows")
+      return this.selectRows(e.context), !0;
   }
   /** @internal */
   detach() {
-    this.selected.clear(), this.ranges = [], this.activeRange = null, this.cellAnchor = null, this.isDragging = !1, this.selectedCell = null, this.pendingKeyboardUpdate = null;
+    this.selected.clear(), this.ranges = [], this.activeRange = null, this.cellAnchor = null, this.isDragging = !1, this.selectedCell = null, this.pendingKeyboardUpdate = null, this.lastSyncedFocusRow = -1, this.lastSyncedFocusCol = -1;
   }
   /**
    * Clear selection without emitting an event.
    * Used when selection is invalidated by external changes (filtering, grouping, etc.)
    */
   clearSelectionSilent() {
-    this.selected.clear(), this.ranges = [], this.activeRange = null, this.cellAnchor = null, this.selectedCell = null, this.lastSelected = null, this.anchor = null, this.requestAfterRender();
+    this.selected.clear(), this.ranges = [], this.activeRange = null, this.cellAnchor = null, this.selectedCell = null, this.lastSelected = null, this.anchor = null, this.lastSyncedFocusRow = -1, this.lastSyncedFocusCol = -1, this.requestAfterRender();
   }
   // #endregion
   // #region Event Handlers
   /** @internal */
   onCellClick(e) {
     if (!this.isSelectionEnabled()) return !1;
-    const { rowIndex: t, colIndex: s, originalEvent: i } = e, { mode: l, triggerOn: n = "click" } = this.config;
-    if (i.type !== n)
+    const { rowIndex: t, colIndex: s, originalEvent: r } = e, { mode: n, triggerOn: i = "click" } = this.config;
+    if (r.type !== i)
       return !1;
-    const o = this.columns[s], d = o && g(o);
-    if (l === "cell") {
+    const l = this.columns[s], d = l && f(l);
+    if (n === "cell") {
       if (d || !this.isCellSelectable(t, s))
         return !1;
       const a = this.selectedCell;
       return a && a.row === t && a.col === s || (this.selectedCell = { row: t, col: s }, this.emit("selection-change", this.#e()), this.requestAfterRender()), !1;
     }
-    if (l === "row")
-      return !this.isRowSelectable(t) || this.selected.size === 1 && this.selected.has(t) || (this.selected.clear(), this.selected.add(t), this.lastSelected = t, this.emit("selection-change", this.#e()), this.requestAfterRender()), !1;
-    if (l === "range") {
+    if (n === "row") {
+      if (!this.isRowSelectable(t))
+        return !1;
+      const a = r.shiftKey, h = r.ctrlKey || r.metaKey, c = l?.meta?.checkboxColumn === !0;
+      if (a && this.anchor !== null) {
+        const u = Math.min(this.anchor, t), x = Math.max(this.anchor, t);
+        h || this.selected.clear();
+        for (let w = u; w <= x; w++)
+          this.isRowSelectable(w) && this.selected.add(w);
+      } else if (h || c)
+        this.selected.has(t) ? this.selected.delete(t) : this.selected.add(t), this.anchor = t;
+      else {
+        if (this.selected.size === 1 && this.selected.has(t))
+          return !1;
+        this.selected.clear(), this.selected.add(t), this.anchor = t;
+      }
+      return this.lastSelected = t, this.explicitSelection = !0, this.emit("selection-change", this.#e()), this.requestAfterRender(), !1;
+    }
+    if (n === "range") {
       if (d || !this.isCellSelectable(t, s))
         return !1;
-      const a = i.shiftKey, h = i.ctrlKey || i.metaKey;
+      const a = r.shiftKey, h = r.ctrlKey || r.metaKey;
       if (a && this.cellAnchor) {
-        const c = b(this.cellAnchor, { row: t, col: s }), f = this.ranges.length > 0 ? this.ranges[this.ranges.length - 1] : null;
-        if (f && w(f, c))
+        const c = m(this.cellAnchor, { row: t, col: s }), u = this.ranges.length > 0 ? this.ranges[this.ranges.length - 1] : null;
+        if (u && b(u, c))
           return !1;
         h ? this.ranges.length > 0 ? this.ranges[this.ranges.length - 1] = c : this.ranges.push(c) : this.ranges = [c], this.activeRange = c;
       } else if (h) {
@@ -613,7 +647,7 @@ class D extends v {
           endRow: t,
           endCol: s
         };
-        if (this.ranges.length === 1 && w(this.ranges[0], c))
+        if (this.ranges.length === 1 && b(this.ranges[0], c))
           return !1;
         this.ranges = [c], this.activeRange = c, this.cellAnchor = { row: t, col: s };
       }
@@ -624,104 +658,205 @@ class D extends v {
   /** @internal */
   onKeyDown(e) {
     if (!this.isSelectionEnabled()) return !1;
-    const { mode: t } = this.config, i = ["ArrowUp", "ArrowDown", "ArrowLeft", "ArrowRight", "Tab", "Home", "End", "PageUp", "PageDown"].includes(e.key);
+    const { mode: t } = this.config, r = ["ArrowUp", "ArrowDown", "ArrowLeft", "ArrowRight", "Tab", "Home", "End", "PageUp", "PageDown"].includes(e.key);
     if (e.key === "Escape")
-      return t === "cell" ? this.selectedCell = null : t === "row" ? (this.selected.clear(), this.anchor = null) : t === "range" && (this.ranges = [], this.activeRange = null, this.cellAnchor = null), this.emit("selection-change", this.#e()), this.requestAfterRender(), !0;
-    if (t === "cell" && i)
-      return queueMicrotask(() => {
-        const l = this.grid._focusRow, n = this.grid._focusCol;
-        this.isCellSelectable(l, n) ? this.selectedCell = { row: l, col: n } : this.selectedCell = null, this.emit("selection-change", this.#e()), this.requestAfterRender();
-      }), !1;
-    if (t === "row" && (e.key === "ArrowUp" || e.key === "ArrowDown"))
+      return this.grid.query("isEditing").some(Boolean) ? !1 : (t === "cell" ? this.selectedCell = null : t === "row" ? (this.selected.clear(), this.anchor = null) : t === "range" && (this.ranges = [], this.activeRange = null, this.cellAnchor = null), this.emit("selection-change", this.#e()), this.requestAfterRender(), !0);
+    if (t === "cell" && r)
       return queueMicrotask(() => {
-        const l = this.grid._focusRow;
-        this.isRowSelectable(l) ? (this.selected.clear(), this.selected.add(l), this.lastSelected = l) : this.selected.clear(), this.emit("selection-change", this.#e()), this.requestAfterRender();
+        const n = this.grid._focusRow, i = this.grid._focusCol;
+        this.isCellSelectable(n, i) ? this.selectedCell = { row: n, col: i } : this.selectedCell = null, this.emit("selection-change", this.#e()), this.requestAfterRender();
       }), !1;
-    if (t === "range" && i) {
-      const l = e.key === "Tab", n = e.shiftKey && !l;
-      return n && !this.cellAnchor && (this.cellAnchor = { row: this.grid._focusRow, col: this.grid._focusCol }), this.pendingKeyboardUpdate = { shiftKey: n }, queueMicrotask(() => this.requestAfterRender()), !1;
-    }
-    if (t === "range" && e.key === "a" && (e.ctrlKey || e.metaKey)) {
-      const l = this.rows.length, n = this.columns.length;
-      if (l > 0 && n > 0) {
-        e.preventDefault(), e.stopPropagation();
-        const o = {
-          startRow: 0,
-          startCol: 0,
-          endRow: l - 1,
-          endCol: n - 1
-        };
-        return this.ranges = [o], this.activeRange = o, this.emit("selection-change", this.#e()), this.requestAfterRender(), !0;
+    if (t === "row") {
+      if (e.key === "ArrowUp" || e.key === "ArrowDown") {
+        const n = e.shiftKey;
+        return n && this.anchor === null && (this.anchor = this.grid._focusRow), queueMicrotask(() => {
+          const i = this.grid._focusRow;
+          if (n && this.anchor !== null) {
+            this.selected.clear();
+            const l = Math.min(this.anchor, i), d = Math.max(this.anchor, i);
+            for (let a = l; a <= d; a++)
+              this.isRowSelectable(a) && this.selected.add(a);
+          } else
+            this.isRowSelectable(i) ? (this.selected.clear(), this.selected.add(i), this.anchor = i) : this.selected.clear();
+          this.lastSelected = i, this.explicitSelection = !0, this.emit("selection-change", this.#e()), this.requestAfterRender();
+        }), !1;
       }
+      if (e.key === "a" && (e.ctrlKey || e.metaKey))
+        return e.preventDefault(), e.stopPropagation(), this.selectAll(), !0;
     }
-    return !1;
+    if (t === "range" && r) {
+      const n = e.key === "Tab", i = e.shiftKey && !n;
+      return i && !this.cellAnchor && (this.cellAnchor = { row: this.grid._focusRow, col: this.grid._focusCol }), this.pendingKeyboardUpdate = { shiftKey: i }, queueMicrotask(() => this.requestAfterRender()), !1;
+    }
+    return t === "range" && e.key === "a" && (e.ctrlKey || e.metaKey) ? (e.preventDefault(), e.stopPropagation(), this.selectAll(), !0) : !1;
   }
   /** @internal */
   onCellMouseDown(e) {
     if (!this.isSelectionEnabled() || this.config.mode !== "range" || e.rowIndex === void 0 || e.colIndex === void 0 || e.rowIndex < 0) return;
     const t = this.columns[e.colIndex];
-    if (t && g(t) || !this.isCellSelectable(e.rowIndex, e.colIndex) || e.originalEvent.shiftKey && this.cellAnchor)
+    if (t && f(t) || !this.isCellSelectable(e.rowIndex, e.colIndex) || e.originalEvent.shiftKey && this.cellAnchor)
       return;
     this.isDragging = !0;
-    const s = e.rowIndex, i = e.colIndex, l = e.originalEvent.ctrlKey || e.originalEvent.metaKey, n = {
+    const s = e.rowIndex, r = e.colIndex, n = e.originalEvent.ctrlKey || e.originalEvent.metaKey, i = {
       startRow: s,
-      startCol: i,
+      startCol: r,
       endRow: s,
-      endCol: i
+      endCol: r
     };
-    return !l && this.ranges.length === 1 && w(this.ranges[0], n) ? (this.cellAnchor = { row: s, col: i }, !0) : (this.cellAnchor = { row: s, col: i }, l || (this.ranges = []), this.ranges.push(n), this.activeRange = n, this.emit("selection-change", this.#e()), this.requestAfterRender(), !0);
+    return !n && this.ranges.length === 1 && b(this.ranges[0], i) ? (this.cellAnchor = { row: s, col: r }, !0) : (this.cellAnchor = { row: s, col: r }, n || (this.ranges = []), this.ranges.push(i), this.activeRange = i, this.emit("selection-change", this.#e()), this.requestAfterRender(), !0);
   }
   /** @internal */
   onCellMouseMove(e) {
     if (!this.isSelectionEnabled() || this.config.mode !== "range" || !this.isDragging || !this.cellAnchor || e.rowIndex === void 0 || e.colIndex === void 0 || e.rowIndex < 0) return;
     let t = e.colIndex;
     const s = this.columns[t];
-    if (s && g(s)) {
-      const n = this.columns.findIndex((o) => !g(o));
-      n >= 0 && (t = n);
+    if (s && f(s)) {
+      const i = this.columns.findIndex((l) => !f(l));
+      i >= 0 && (t = i);
     }
-    const i = b(this.cellAnchor, { row: e.rowIndex, col: t }), l = this.ranges.length > 0 ? this.ranges[this.ranges.length - 1] : null;
-    return l && w(l, i) || (this.ranges.length > 0 ? this.ranges[this.ranges.length - 1] = i : this.ranges.push(i), this.activeRange = i, this.emit("selection-change", this.#e()), this.requestAfterRender()), !0;
+    const r = m(this.cellAnchor, { row: e.rowIndex, col: t }), n = this.ranges.length > 0 ? this.ranges[this.ranges.length - 1] : null;
+    return n && b(n, r) || (this.ranges.length > 0 ? this.ranges[this.ranges.length - 1] = r : this.ranges.push(r), this.activeRange = r, this.emit("selection-change", this.#e()), this.requestAfterRender()), !0;
   }
   /** @internal */
   onCellMouseUp(e) {
     if (this.isSelectionEnabled() && this.config.mode === "range" && this.isDragging)
       return this.isDragging = !1, !0;
   }
+  // #region Checkbox Column
   /**
-   * Apply selection classes to visible cells/rows.
-   * Shared by afterRender and onScrollRender.
+   * Inject checkbox column when `checkbox: true` and mode is `'row'`.
+   * @internal
+   */
+  processColumns(e) {
+    if (this.config.checkbox && this.config.mode === "row") {
+      if (e.some((n) => n.field === S))
+        return e;
+      const t = this.#t(), s = e.findIndex(k), r = s >= 0 ? s + 1 : 0;
+      return [...e.slice(0, r), t, ...e.slice(r)];
+    }
+    return e;
+  }
+  /**
+   * Create the checkbox utility column configuration.
    */
   #t() {
+    return {
+      field: S,
+      header: "",
+      width: 32,
+      resizable: !1,
+      sortable: !1,
+      meta: {
+        lockPosition: !0,
+        suppressMovable: !0,
+        utility: !0,
+        checkboxColumn: !0
+      },
+      headerRenderer: () => {
+        const e = document.createElement("div");
+        e.className = "tbw-checkbox-header";
+        const t = document.createElement("input");
+        return t.type = "checkbox", t.className = "tbw-select-all-checkbox", t.addEventListener("click", (s) => {
+          s.stopPropagation(), s.target.checked ? this.selectAll() : this.clearSelection();
+        }), e.appendChild(t), e;
+      },
+      renderer: (e) => {
+        const t = document.createElement("input");
+        t.type = "checkbox", t.className = "tbw-select-row-checkbox";
+        const s = e.cellEl;
+        if (s) {
+          const r = parseInt(s.getAttribute("data-row") ?? "-1", 10);
+          r >= 0 && (t.checked = this.selected.has(r));
+        }
+        return t;
+      }
+    };
+  }
+  /**
+   * Update checkbox checked states to reflect current selection.
+   * Called from #applySelectionClasses.
+   */
+  #r(e) {
+    e.querySelectorAll(".tbw-select-row-checkbox").forEach((r) => {
+      const n = r.closest(".cell"), i = n ? R(n) : -1;
+      i >= 0 && (r.checked = this.selected.has(i));
+    });
+    const s = e.querySelector(".tbw-select-all-checkbox");
+    if (s) {
+      const r = this.rows.length;
+      let n = 0;
+      if (this.config.isSelectable)
+        for (let d = 0; d < r; d++)
+          this.isRowSelectable(d) && n++;
+      else
+        n = r;
+      const i = n > 0 && this.selected.size >= n, l = this.selected.size > 0;
+      s.checked = i, s.indeterminate = l && !i;
+    }
+  }
+  // #endregion
+  /**
+   * Sync selection state to the grid's current focus position.
+   * In row mode, keeps `selected` in sync with `_focusRow`.
+   * In cell mode, keeps `selectedCell` in sync with `_focusRow`/`_focusCol`.
+   * Only updates when the focus has changed since the last sync.
+   * Skips when `explicitSelection` is set (click/keyboard set selection directly).
+   */
+  #i(e) {
+    const t = this.grid._focusRow, s = this.grid._focusCol;
+    if (e === "row") {
+      if (this.explicitSelection) {
+        this.explicitSelection = !1, this.lastSyncedFocusRow = t;
+        return;
+      }
+      t !== this.lastSyncedFocusRow && (this.lastSyncedFocusRow = t, this.isRowSelectable(t) && (!this.selected.has(t) || this.selected.size !== 1) && (this.selected.clear(), this.selected.add(t), this.lastSelected = t, this.anchor = t, this.emit("selection-change", this.#e())));
+    }
+    if (e === "cell") {
+      if (this.explicitSelection) {
+        this.explicitSelection = !1, this.lastSyncedFocusRow = t, this.lastSyncedFocusCol = s;
+        return;
+      }
+      if ((t !== this.lastSyncedFocusRow || s !== this.lastSyncedFocusCol) && (this.lastSyncedFocusRow = t, this.lastSyncedFocusCol = s, this.isCellSelectable(t, s))) {
+        const r = this.selectedCell;
+        (!r || r.row !== t || r.col !== s) && (this.selectedCell = { row: t, col: s }, this.emit("selection-change", this.#e()));
+      }
+    }
+  }
+  /**
+   * Apply CSS selection classes to row/cell elements.
+   * Shared by afterRender and onScrollRender.
+   */
+  #s() {
     const e = this.gridElement;
     if (!e) return;
     const { mode: t } = this.config, s = !!this.config.isSelectable;
-    e.querySelectorAll(".cell").forEach((n) => {
-      n.classList.remove("selected", "top", "bottom", "first", "last"), s && n.removeAttribute("data-selectable");
+    e.querySelectorAll(".cell").forEach((i) => {
+      i.classList.remove("selected", "top", "bottom", "first", "last"), s && i.removeAttribute("data-selectable");
     });
-    const l = e.querySelectorAll(".data-grid-row");
-    if (l.forEach((n) => {
-      n.classList.remove("selected", "row-focus"), s && n.removeAttribute("data-selectable");
-    }), t === "row" && (m(e), l.forEach((n) => {
-      const o = n.querySelector(".cell[data-row]"), d = S(o);
-      d >= 0 && (s && !this.isRowSelectable(d) && n.setAttribute("data-selectable", "false"), this.selected.has(d) && n.classList.add("selected", "row-focus"));
-    })), (t === "cell" || t === "range") && s && e.querySelectorAll(".cell[data-row][data-col]").forEach((o) => {
-      const d = parseInt(o.getAttribute("data-row") ?? "-1", 10), a = parseInt(o.getAttribute("data-col") ?? "-1", 10);
-      d >= 0 && a >= 0 && (this.isCellSelectable(d, a) || o.setAttribute("data-selectable", "false"));
+    const n = e.querySelectorAll(".data-grid-row");
+    if (n.forEach((i) => {
+      i.classList.remove("selected", "row-focus"), s && i.removeAttribute("data-selectable");
+    }), t === "row" && (C(e), n.forEach((i) => {
+      const l = i.querySelector(".cell[data-row]"), d = R(l);
+      d >= 0 && (s && !this.isRowSelectable(d) && i.setAttribute("data-selectable", "false"), this.selected.has(d) && i.classList.add("selected", "row-focus"));
+    }), this.config.checkbox && this.#r(e)), (t === "cell" || t === "range") && s && e.querySelectorAll(".cell[data-row][data-col]").forEach((l) => {
+      const d = parseInt(l.getAttribute("data-row") ?? "-1", 10), a = parseInt(l.getAttribute("data-col") ?? "-1", 10);
+      d >= 0 && a >= 0 && (this.isCellSelectable(d, a) || l.setAttribute("data-selectable", "false"));
     }), t === "range" && this.ranges.length > 0) {
-      m(e);
-      const n = this.activeRange ? u(this.activeRange) : null, o = this.columns.findIndex((a) => !g(a));
-      this.columns.length - 1, e.querySelectorAll(".cell[data-row][data-col]").forEach((a) => {
+      C(e);
+      const i = this.ranges.map(g), l = (a, h) => {
+        for (const c of i)
+          if (a >= c.startRow && a <= c.endRow && h >= c.startCol && h <= c.endCol)
+            return !0;
+        return !1;
+      };
+      e.querySelectorAll(".cell[data-row][data-col]").forEach((a) => {
         const h = parseInt(a.getAttribute("data-row") ?? "-1", 10), c = parseInt(a.getAttribute("data-col") ?? "-1", 10);
         if (h >= 0 && c >= 0) {
-          const f = this.columns[c];
-          if (f && g(f))
+          const u = this.columns[c];
+          if (u && f(u))
             return;
-          if (C(h, c, this.ranges) && (a.classList.add("selected"), n)) {
-            h === n.startRow && a.classList.add("top"), h === n.endRow && a.classList.add("bottom");
-            const A = Math.max(n.startCol, o);
-            c === A && a.classList.add("first"), c === n.endCol && a.classList.add("last");
-          }
+          l(h, c) && (a.classList.add("selected"), l(h - 1, c) || a.classList.add("top"), l(h + 1, c) || a.classList.add("bottom"), l(h, c - 1) || a.classList.add("first"), l(h, c + 1) || a.classList.add("last"));
         }
       });
     }
@@ -733,16 +868,16 @@ class D extends v {
     if (!e) return;
     const t = e.children[0], { mode: s } = this.config;
     if (this.pendingKeyboardUpdate && s === "range") {
-      const { shiftKey: i } = this.pendingKeyboardUpdate;
+      const { shiftKey: r } = this.pendingKeyboardUpdate;
       this.pendingKeyboardUpdate = null;
-      const l = this.grid._focusRow, n = this.grid._focusCol;
-      if (i && this.cellAnchor) {
-        const o = b(this.cellAnchor, { row: l, col: n });
-        this.ranges = [o], this.activeRange = o;
-      } else i || (this.ranges = [], this.activeRange = null, this.cellAnchor = { row: l, col: n });
+      const n = this.grid._focusRow, i = this.grid._focusCol;
+      if (r && this.cellAnchor) {
+        const l = m(this.cellAnchor, { row: n, col: i });
+        this.ranges = [l], this.activeRange = l;
+      } else r || (this.ranges = [], this.activeRange = null, this.cellAnchor = { row: n, col: i });
       this.emit("selection-change", this.#e());
     }
-    this.grid.setAttribute("data-selection-mode", s), t && t.classList.toggle("selecting", this.isDragging), this.#t();
+    this.#i(s), this.grid.setAttribute("data-selection-mode", s), t && t.classList.toggle("selecting", this.isDragging), this.#s();
   }
   /**
    * Called after scroll-triggered row rendering.
@@ -750,7 +885,7 @@ class D extends v {
    * @internal
    */
   onScrollRender() {
-    this.isSelectionEnabled() && this.#t();
+    this.isSelectionEnabled() && this.#s();
   }
   // #endregion
   // #region Public API
@@ -780,13 +915,80 @@ class D extends v {
    * Get all selected cells across all ranges.
    */
   getSelectedCells() {
-    return q(this.ranges);
+    return M(this.ranges);
   }
   /**
    * Check if a specific cell is in range selection.
    */
   isCellSelected(e, t) {
-    return C(e, t, this.ranges);
+    return q(e, t, this.ranges);
+  }
+  /**
+   * Select all selectable rows (row mode) or all cells (range mode).
+   *
+   * In row mode, selects every row where `isSelectable` returns true (or all rows if no callback).
+   * In range mode, creates a single range spanning all rows and columns.
+   * Has no effect in cell mode.
+   *
+   * @example
+   * ```ts
+   * const plugin = grid.getPlugin(SelectionPlugin);
+   * plugin.selectAll(); // Selects everything in current mode
+   * ```
+   */
+  selectAll() {
+    const { mode: e } = this.config;
+    if (e === "row") {
+      this.selected.clear();
+      for (let t = 0; t < this.rows.length; t++)
+        this.isRowSelectable(t) && this.selected.add(t);
+      this.explicitSelection = !0, this.emit("selection-change", this.#e()), this.requestAfterRender();
+    } else if (e === "range") {
+      const t = this.rows.length, s = this.columns.length;
+      if (t > 0 && s > 0) {
+        const r = {
+          startRow: 0,
+          startCol: 0,
+          endRow: t - 1,
+          endCol: s - 1
+        };
+        this.ranges = [r], this.activeRange = r, this.emit("selection-change", this.#e()), this.requestAfterRender();
+      }
+    }
+  }
+  /**
+   * Select specific rows by index (row mode only).
+   * Replaces the current selection with the provided row indices.
+   * Indices that are out of bounds or fail the `isSelectable` check are ignored.
+   *
+   * @param indices - Array of row indices to select
+   *
+   * @example
+   * ```ts
+   * const plugin = grid.getPlugin(SelectionPlugin);
+   * plugin.selectRows([0, 2, 4]); // Select rows 0, 2, and 4
+   * ```
+   */
+  selectRows(e) {
+    if (this.config.mode === "row") {
+      this.selected.clear();
+      for (const t of e)
+        t >= 0 && t < this.rows.length && this.isRowSelectable(t) && this.selected.add(t);
+      this.anchor = e.length > 0 ? e[e.length - 1] : null, this.explicitSelection = !0, this.emit("selection-change", this.#e()), this.requestAfterRender();
+    }
+  }
+  /**
+   * Get the indices of all selected rows (convenience for row mode).
+   * Returns indices sorted in ascending order.
+   *
+   * @example
+   * ```ts
+   * const plugin = grid.getPlugin(SelectionPlugin);
+   * const rows = plugin.getSelectedRowIndices(); // [0, 2, 4]
+   * ```
+   */
+  getSelectedRowIndices() {
+    return [...this.selected].sort((e, t) => e - t);
   }
   /**
    * Clear all selection.
@@ -805,13 +1007,13 @@ class D extends v {
       endCol: t.to.col
     })), this.activeRange = this.ranges.length > 0 ? this.ranges[this.ranges.length - 1] : null, this.emit("selection-change", {
       mode: this.config.mode,
-      ranges: p(this.ranges)
+      ranges: y(this.ranges)
     }), this.requestAfterRender();
   }
   // #endregion
   // #region Private Helpers
   #e() {
-    return _(
+    return D(
       this.config.mode,
       {
         selectedCell: this.selectedCell,
@@ -824,6 +1026,6 @@ class D extends v {
   // #endregion
 }
 export {
-  D as SelectionPlugin
+  L as SelectionPlugin
 };
 //# sourceMappingURL=index.js.map