@toolbox-web/grid 1.12.0 → 1.13.0

package/lib/plugins/selection/index.js

@@ -1,8 +1,8 @@
-function S(r) {
-  if (!r) return -1;
-  const e = r.getAttribute("data-row");
+function R(n) {
+  if (!n) return -1;
+  const e = n.getAttribute("data-row");
   if (e) return parseInt(e, 10);
-  const t = r.closest(".data-grid-row");
+  const t = n.closest(".data-grid-row");
   if (!t) return -1;
   const s = t.parentElement;
   if (!s) return -1;
@@ -11,10 +11,10 @@ function S(r) {
     if (i[l] === t) return l;
   return -1;
 }
-function m(r) {
-  r && r.querySelectorAll(".cell-focus").forEach((e) => e.classList.remove("cell-focus"));
+function C(n) {
+  n && n.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,11 +23,11 @@ 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 {
+class k {
   /**
    * Plugin dependencies - declare other plugins this one requires.
    *
@@ -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 I(n) {
+  return n.field === E;
 }
-function u(r) {
+function f(n) {
+  return n.meta?.utility === !0;
+}
+function g(n) {
   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(n.startRow, n.endRow),
+    startCol: Math.min(n.startCol, n.endCol),
+    endRow: Math.max(n.startRow, n.endRow),
+    endCol: Math.max(n.startCol, n.endCol)
   };
 }
-function E(r) {
-  const e = u(r);
+function v(n) {
+  const e = g(n);
   return {
     from: { row: e.startRow, col: e.startCol },
     to: { row: e.endRow, col: e.endCol }
   };
 }
-function p(r) {
-  return r.map(E);
+function y(n) {
+  return n.map(v);
 }
-function I(r, e, t) {
-  const s = u(t);
-  return r >= s.startRow && r <= s.endRow && e >= s.startCol && e <= s.endCol;
+function _(n, e, t) {
+  const s = g(t);
+  return n >= s.startRow && n <= s.endRow && e >= s.startCol && e <= s.endCol;
 }
-function C(r, e, t) {
-  return t.some((s) => I(r, e, s));
+function q(n, e, t) {
+  return t.some((s) => _(n, e, s));
 }
-function x(r) {
-  const e = [], t = u(r);
+function K(n) {
+  const e = [], t = g(n);
   for (let s = t.startRow; s <= t.endRow; s++)
     for (let i = t.startCol; i <= t.endCol; i++)
       e.push({ row: s, col: i });
   return e;
 }
-function q(r) {
+function M(n) {
   const e = /* @__PURE__ */ new Map();
-  for (const t of r)
-    for (const s of x(t))
+  for (const t of n)
+    for (const s of K(t))
       e.set(`${s.row},${s.col}`, s);
   return [...e.values()];
 }
-function b(r, e) {
+function m(n, e) {
   return {
-    startRow: r.row,
-    startCol: r.col,
+    startRow: n.row,
+    startCol: n.col,
     endRow: e.row,
     endCol: e.col
   };
 }
-function w(r, e) {
-  const t = u(r), s = u(e);
+function b(n, e) {
+  const t = g(n), 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)}tbw-grid .data-grid-row>.cell.selected.bottom{border-bottom:2px solid var(--tbw-range-border-color)}tbw-grid .data-grid-row>.cell.selected.first{border-left:2px solid var(--tbw-range-border-color)}tbw-grid .data-grid-row>.cell.selected.last{border-right:2px solid var(--tbw-range-border-color)}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-has-focus] .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-has-focus] .data-grid-row.row-focus:after{content:"";position:absolute;inset:0;pointer-events:none;border:0 solid var(--tbw-range-border-color, var(--tbw-color-accent));border-top-width:2px;border-bottom-width:2px;z-index:1}tbw-grid[data-has-focus] .data-grid-row.row-focus+.data-grid-row.row-focus:after{border-top-width:0}tbw-grid[data-has-focus] .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 solid var(--tbw-range-border-color);z-index:1}tbw-grid .data-grid-row>.cell.selected.top:after{border-top-width:2px}tbw-grid .data-grid-row>.cell.selected.bottom:after{border-bottom-width:2px}tbw-grid .data-grid-row>.cell.selected.first:after{border-left-width:2px}tbw-grid .data-grid-row>.cell.selected.last:after{border-right-width: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}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(n, e, t) {
+  if (n === "cell" && e.selectedCell)
     return {
-      mode: r,
+      mode: n,
       ranges: [
         {
           from: { row: e.selectedCell.row, col: e.selectedCell.col },
@@ -459,16 +463,16 @@ 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 (n === "row" && e.selected.size > 0) {
+    const s = [...e.selected].sort((o, h) => o - h), i = [];
+    let l = s[0], r = l;
+    for (let o = 1; o < s.length; o++)
+      s[o] === r + 1 ? r = s[o] : (i.push({ from: { row: l, col: 0 }, to: { row: r, col: t - 1 } }), l = s[o], r = l);
+    return i.push({ from: { row: l, col: 0 }, to: { row: r, col: t - 1 } }), { mode: n, ranges: i };
+  }
+  return n === "range" && e.ranges.length > 0 ? { mode: n, ranges: y(e.ranges) } : { mode: n, ranges: [] };
 }
-class D extends v {
+class L extends k {
   /**
    * Plugin manifest - declares queries and configuration validation rules.
    * @internal
@@ -489,7 +493,7 @@ class D extends v {
   /** @internal */
   name = "selection";
   /** @internal */
-  styles = k;
+  styles = F;
   /** @internal */
   get defaultConfig() {
     return {
@@ -512,6 +516,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
   /**
@@ -563,42 +573,58 @@ class D extends v {
   }
   /** @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: i } = e, { mode: l, triggerOn: r = "click" } = this.config;
+    if (i.type !== r)
       return !1;
-    const o = this.columns[s], d = o && g(o);
+    const o = this.columns[s], h = o && f(o);
     if (l === "cell") {
-      if (d || !this.isCellSelectable(t, s))
+      if (h || !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 === "row") {
+      if (!this.isRowSelectable(t))
+        return !1;
+      const a = i.shiftKey, d = i.ctrlKey || i.metaKey, c = o?.meta?.checkboxColumn === !0;
+      if (a && this.anchor !== null) {
+        const u = Math.min(this.anchor, t), x = Math.max(this.anchor, t);
+        d || this.selected.clear();
+        for (let w = u; w <= x; w++)
+          this.isRowSelectable(w) && this.selected.add(w);
+      } else if (d || 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 (l === "range") {
-      if (d || !this.isCellSelectable(t, s))
+      if (h || !this.isCellSelectable(t, s))
         return !1;
-      const a = i.shiftKey, h = i.ctrlKey || i.metaKey;
+      const a = i.shiftKey, d = i.ctrlKey || i.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) {
+        d ? this.ranges.length > 0 ? this.ranges[this.ranges.length - 1] = c : this.ranges.push(c) : this.ranges = [c], this.activeRange = c;
+      } else if (d) {
         const c = {
           startRow: t,
           startCol: s,
@@ -613,7 +639,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 };
       }
@@ -629,99 +655,200 @@ class D extends v {
       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();
+        const l = this.grid._focusRow, r = this.grid._focusCol;
+        this.isCellSelectable(l, r) ? this.selectedCell = { row: l, col: r } : this.selectedCell = null, this.emit("selection-change", this.#e()), this.requestAfterRender();
       }), !1;
-    if (t === "row" && (e.key === "ArrowUp" || e.key === "ArrowDown"))
-      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();
-      }), !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 l = e.shiftKey;
+        return l && this.anchor === null && (this.anchor = this.grid._focusRow), queueMicrotask(() => {
+          const r = this.grid._focusRow;
+          if (l && this.anchor !== null) {
+            this.selected.clear();
+            const o = Math.min(this.anchor, r), h = Math.max(this.anchor, r);
+            for (let a = o; a <= h; a++)
+              this.isRowSelectable(a) && this.selected.add(a);
+          } else
+            this.isRowSelectable(r) ? (this.selected.clear(), this.selected.add(r), this.anchor = r) : this.selected.clear();
+          this.lastSelected = r, 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" && i) {
+      const l = e.key === "Tab", r = e.shiftKey && !l;
+      return r && !this.cellAnchor && (this.cellAnchor = { row: this.grid._focusRow, col: this.grid._focusCol }), this.pendingKeyboardUpdate = { shiftKey: r }, 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, i = e.colIndex, l = e.originalEvent.ctrlKey || e.originalEvent.metaKey, r = {
       startRow: s,
       startCol: i,
       endRow: s,
       endCol: i
     };
-    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 !l && this.ranges.length === 1 && b(this.ranges[0], r) ? (this.cellAnchor = { row: s, col: i }, !0) : (this.cellAnchor = { row: s, col: i }, l || (this.ranges = []), this.ranges.push(r), this.activeRange = r, 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 r = this.columns.findIndex((o) => !f(o));
+      r >= 0 && (t = r);
     }
-    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 i = m(this.cellAnchor, { row: e.rowIndex, col: t }), l = this.ranges.length > 0 ? this.ranges[this.ranges.length - 1] : null;
+    return l && b(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;
   }
   /** @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((l) => l.field === S))
+        return e;
+      const t = this.#t(), s = e.findIndex(I), i = s >= 0 ? s + 1 : 0;
+      return [...e.slice(0, i), t, ...e.slice(i)];
+    }
+    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 i = parseInt(s.getAttribute("data-row") ?? "-1", 10);
+          i >= 0 && (t.checked = this.selected.has(i));
+        }
+        return t;
+      }
+    };
+  }
+  /**
+   * Update checkbox checked states to reflect current selection.
+   * Called from #applySelectionClasses.
+   */
+  #i(e) {
+    e.querySelectorAll(".tbw-select-row-checkbox").forEach((i) => {
+      const l = i.closest(".cell"), r = l ? R(l) : -1;
+      r >= 0 && (i.checked = this.selected.has(r));
+    });
+    const s = e.querySelector(".tbw-select-all-checkbox");
+    if (s) {
+      const i = this.rows.length;
+      let l = 0;
+      if (this.config.isSelectable)
+        for (let h = 0; h < i; h++)
+          this.isRowSelectable(h) && l++;
+      else
+        l = i;
+      const r = l > 0 && this.selected.size >= l, o = this.selected.size > 0;
+      s.checked = r, s.indeterminate = o && !r;
+    }
+  }
+  // #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).
+   */
+  #r(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 i = this.selectedCell;
+        (!i || i.row !== t || i.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((r) => {
+      r.classList.remove("selected", "top", "bottom", "first", "last"), s && r.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"));
+    if (l.forEach((r) => {
+      r.classList.remove("selected", "row-focus"), s && r.removeAttribute("data-selectable");
+    }), t === "row" && (C(e), l.forEach((r) => {
+      const o = r.querySelector(".cell[data-row]"), h = R(o);
+      h >= 0 && (s && !this.isRowSelectable(h) && r.setAttribute("data-selectable", "false"), this.selected.has(h) && r.classList.add("selected", "row-focus"));
+    }), this.config.checkbox && this.#i(e)), (t === "cell" || t === "range") && s && e.querySelectorAll(".cell[data-row][data-col]").forEach((o) => {
+      const h = parseInt(o.getAttribute("data-row") ?? "-1", 10), a = parseInt(o.getAttribute("data-col") ?? "-1", 10);
+      h >= 0 && a >= 0 && (this.isCellSelectable(h, a) || o.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) => {
-        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))
+      C(e);
+      const r = this.ranges.map(g), o = (a, d) => {
+        for (const c of r)
+          if (a >= c.startRow && a <= c.endRow && d >= c.startCol && d <= c.endCol)
+            return !0;
+        return !1;
+      };
+      e.querySelectorAll(".cell[data-row][data-col]").forEach((a) => {
+        const d = parseInt(a.getAttribute("data-row") ?? "-1", 10), c = parseInt(a.getAttribute("data-col") ?? "-1", 10);
+        if (d >= 0 && c >= 0) {
+          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");
-          }
+          o(d, c) && (a.classList.add("selected"), o(d - 1, c) || a.classList.add("top"), o(d + 1, c) || a.classList.add("bottom"), o(d, c - 1) || a.classList.add("first"), o(d, c + 1) || a.classList.add("last"));
         }
       });
     }
@@ -735,14 +862,14 @@ class D extends v {
     if (this.pendingKeyboardUpdate && s === "range") {
       const { shiftKey: i } = this.pendingKeyboardUpdate;
       this.pendingKeyboardUpdate = null;
-      const l = this.grid._focusRow, n = this.grid._focusCol;
+      const l = this.grid._focusRow, r = this.grid._focusCol;
       if (i && this.cellAnchor) {
-        const o = b(this.cellAnchor, { row: l, col: n });
+        const o = m(this.cellAnchor, { row: l, col: r });
         this.ranges = [o], this.activeRange = o;
-      } else i || (this.ranges = [], this.activeRange = null, this.cellAnchor = { row: l, col: n });
+      } else i || (this.ranges = [], this.activeRange = null, this.cellAnchor = { row: l, col: r });
       this.emit("selection-change", this.#e());
     }
-    this.grid.setAttribute("data-selection-mode", s), t && t.classList.toggle("selecting", this.isDragging), this.#t();
+    this.#r(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 +877,7 @@ class D extends v {
    * @internal
    */
   onScrollRender() {
-    this.isSelectionEnabled() && this.#t();
+    this.isSelectionEnabled() && this.#s();
   }
   // #endregion
   // #region Public API
@@ -780,13 +907,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 i = {
+          startRow: 0,
+          startCol: 0,
+          endRow: t - 1,
+          endCol: s - 1
+        };
+        this.ranges = [i], this.activeRange = i, 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 +999,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 +1018,6 @@ class D extends v {
   // #endregion
 }
 export {
-  D as SelectionPlugin
+  L as SelectionPlugin
 };
 //# sourceMappingURL=index.js.map