@toolbox-web/grid 1.2.0 → 1.3.1

package/lib/plugins/selection/types.d.ts

@@ -1,8 +1,4 @@
-/**
- * Selection Plugin Types
- *
- * Type definitions for the selection feature.
- */
+import { ColumnConfig } from '../../core/types';
 /**
  * Selection mode for the grid.
  *
@@ -47,8 +43,31 @@ export type SelectionMode = 'cell' | 'row' | 'range';
  * ```
  */
 export type SelectionTrigger = 'click' | 'dblclick';
+/**
+ * Callback that determines whether a specific row or cell can be selected.
+ *
+ * Return `true` if the row/cell should be selectable, `false` otherwise.
+ *
+ * @param row - The row data object
+ * @param rowIndex - The row index in the grid
+ * @param column - The column config (provided in cell/range modes, undefined in row mode)
+ * @param colIndex - The column index (provided in cell/range modes, undefined in row mode)
+ *
+ * @example
+ * ```ts
+ * // Prevent selection of locked rows
+ * isSelectable: (row) => row.status !== 'locked'
+ *
+ * // Prevent selection of specific columns
+ * isSelectable: (row, rowIndex, col) => col?.field !== 'id'
+ *
+ * // Permission-based selection
+ * isSelectable: (row) => userPermissions.canSelect(row)
+ * ```
+ */
+export type SelectableCallback<T = unknown> = (row: T, rowIndex: number, column?: ColumnConfig, colIndex?: number) => boolean;
 /** Configuration options for the selection plugin */
-export interface SelectionConfig {
+export interface SelectionConfig<T = unknown> {
     /** Selection mode (default: 'cell') */
     mode: SelectionMode;
     /**
@@ -61,6 +80,31 @@ export interface SelectionConfig {
      * selection which is unaffected by this option.
      */
     triggerOn?: SelectionTrigger;
+    /**
+     * Callback that determines whether a specific row or cell can be selected.
+     *
+     * Non-selectable rows/cells:
+     * - Don't respond to click/keyboard selection
+     * - Are excluded from "select all" operations
+     * - Have visual indicator (muted styling via `[data-selectable="false"]`)
+     * - Remain focusable for navigation
+     *
+     * @example
+     * ```ts
+     * // Prevent selection of locked rows
+     * new SelectionPlugin({
+     *   mode: 'row',
+     *   isSelectable: (row) => row.status !== 'locked',
+     * })
+     *
+     * // Prevent selection of specific columns (cell/range mode)
+     * new SelectionPlugin({
+     *   mode: 'cell',
+     *   isSelectable: (row, rowIndex, col) => col?.field !== 'id',
+     * })
+     * ```
+     */
+    isSelectable?: SelectableCallback<T>;
 }
 /** Internal state managed by the selection plugin */
 export interface SelectionState {

package/lib/plugins/selection/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../libs/grid/src/lib/plugins/selection/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,CAAC;AAErD;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,UAAU,CAAC;AAEpD,qDAAqD;AACrD,MAAM,WAAW,eAAe;IAC9B,uCAAuC;IACvC,IAAI,EAAE,aAAa,CAAC;IAEpB;;;;;;;;OAQG;IACH,SAAS,CAAC,EAAE,gBAAgB,CAAC;CAC9B;AAED,qDAAqD;AACrD,MAAM,WAAW,cAAc;IAC7B,kCAAkC;IAClC,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACtB,wDAAwD;IACxD,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,iDAAiD;IACjD,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAID,0DAA0D;AAC1D,MAAM,WAAW,iBAAiB;IAChC,yBAAyB;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,4BAA4B;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,uBAAuB;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,0BAA0B;IAC1B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,yDAAyD;AACzD,MAAM,WAAW,SAAS;IACxB,gCAAgC;IAChC,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IACnC,8BAA8B;IAC9B,EAAE,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;CAClC;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,mDAAmD;IACnD,IAAI,EAAE,aAAa,CAAC;IACpB,iHAAiH;IACjH,MAAM,EAAE,SAAS,EAAE,CAAC;CACrB;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,eAAe;IAC9B,iCAAiC;IACjC,IAAI,EAAE,aAAa,CAAC;IACpB,yDAAyD;IACzD,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,yFAAyF;IACzF,MAAM,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CAC7C;AAED,0CAA0C;AAC1C,MAAM,WAAW,oBAAqB,SAAQ,cAAc;IAC1D,uEAAuE;IACvE,MAAM,EAAE,iBAAiB,EAAE,CAAC;IAC5B,+CAA+C;IAC/C,WAAW,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACtC,sCAAsC;IACtC,UAAU,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAChD,0CAA0C;IAC1C,UAAU,EAAE,OAAO,CAAC;IACpB,oCAAoC;IACpC,YAAY,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CACnD"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../libs/grid/src/lib/plugins/selection/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,CAAC;AAErD;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,UAAU,CAAC;AAEpD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,MAAM,kBAAkB,CAAC,CAAC,GAAG,OAAO,IAAI,CAC5C,GAAG,EAAE,CAAC,EACN,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,YAAY,EACrB,QAAQ,CAAC,EAAE,MAAM,KACd,OAAO,CAAC;AAEb,qDAAqD;AACrD,MAAM,WAAW,eAAe,CAAC,CAAC,GAAG,OAAO;IAC1C,uCAAuC;IACvC,IAAI,EAAE,aAAa,CAAC;IAEpB;;;;;;;;OAQG;IACH,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAE7B;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,YAAY,CAAC,EAAE,kBAAkB,CAAC,CAAC,CAAC,CAAC;CACtC;AAED,qDAAqD;AACrD,MAAM,WAAW,cAAc;IAC7B,kCAAkC;IAClC,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACtB,wDAAwD;IACxD,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,iDAAiD;IACjD,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAID,0DAA0D;AAC1D,MAAM,WAAW,iBAAiB;IAChC,yBAAyB;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,4BAA4B;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,uBAAuB;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,0BAA0B;IAC1B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,yDAAyD;AACzD,MAAM,WAAW,SAAS;IACxB,gCAAgC;IAChC,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IACnC,8BAA8B;IAC9B,EAAE,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;CAClC;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,mDAAmD;IACnD,IAAI,EAAE,aAAa,CAAC;IACpB,iHAAiH;IACjH,MAAM,EAAE,SAAS,EAAE,CAAC;CACrB;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,eAAe;IAC9B,iCAAiC;IACjC,IAAI,EAAE,aAAa,CAAC;IACpB,yDAAyD;IACzD,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,yFAAyF;IACzF,MAAM,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CAC7C;AAED,0CAA0C;AAC1C,MAAM,WAAW,oBAAqB,SAAQ,cAAc;IAC1D,uEAAuE;IACvE,MAAM,EAAE,iBAAiB,EAAE,CAAC;IAC5B,+CAA+C;IAC/C,WAAW,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACtC,sCAAsC;IACtC,UAAU,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAChD,0CAA0C;IAC1C,UAAU,EAAE,OAAO,CAAC;IACpB,oCAAoC;IACpC,YAAY,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CACnD"}

package/lib/plugins/server-side/index.js

@@ -1,4 +1,4 @@
-const a = {
+const c = '<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>', d = {
   expand: "▶",
   collapse: "▼",
   sortAsc: "▲",
@@ -6,9 +6,11 @@ const a = {
   sortNone: "⇅",
   submenuArrow: "▶",
   dragHandle: "⋮⋮",
-  toolPanel: "☰"
+  toolPanel: "☰",
+  filter: c,
+  filterActive: c
 };
-class d {
+class u {
   /**
    * Plugin dependencies - declare other plugins this one requires.
    *
@@ -232,7 +234,7 @@ class d {
    */
   get gridIcons() {
     const e = this.grid?.gridConfig?.icons ?? {};
-    return { ...a, ...e };
+    return { ...d, ...e };
   }
   // #region Animation Helpers
   /**
@@ -311,35 +313,35 @@ class d {
 function l(s, e) {
   return Math.floor(s / e);
 }
-function u(s, e) {
+function h(s, e) {
   return {
     start: s * e,
     end: (s + 1) * e
   };
 }
-function h(s, e, t) {
-  const o = l(s, t), i = l(e - 1, t), r = [];
-  for (let n = o; n <= i; n++)
-    r.push(n);
-  return r;
+function g(s, e, t) {
+  const o = l(s, t), r = l(e - 1, t), i = [];
+  for (let n = o; n <= r; n++)
+    i.push(n);
+  return i;
 }
-async function c(s, e, t, o) {
-  const i = u(e, t);
+async function a(s, e, t, o) {
+  const r = h(e, t);
   return s.getRows({
-    startRow: i.start,
-    endRow: i.end,
+    startRow: r.start,
+    endRow: r.end,
     sortModel: o.sortModel,
     filterModel: o.filterModel
   });
 }
-function g(s, e, t) {
-  const o = l(s, e), i = t.get(o);
-  if (!i) return;
-  const r = s % e;
-  return i[r];
+function f(s, e, t) {
+  const o = l(s, e), r = t.get(o);
+  if (!r) return;
+  const i = s % e;
+  return r[i];
 }
-const f = 100;
-class R extends d {
+const R = 100;
+class k extends u {
   /** @internal */
   name = "serverSide";
   /** @internal */
@@ -370,15 +372,15 @@ class R extends d {
    */
   loadRequiredBlocks() {
     if (!this.dataSource) return;
-    const e = this.grid, t = this.config.cacheBlockSize ?? 100, o = { startRow: e._virtualization.start, endRow: e._virtualization.end }, i = h(o.startRow, o.endRow, t);
-    for (const r of i)
-      if (!(this.loadedBlocks.has(r) || this.loadingBlocks.has(r))) {
+    const e = this.grid, t = this.config.cacheBlockSize ?? 100, o = { startRow: e._virtualization.start, endRow: e._virtualization.end }, r = g(o.startRow, o.endRow, t);
+    for (const i of r)
+      if (!(this.loadedBlocks.has(i) || this.loadingBlocks.has(i))) {
         if (this.loadingBlocks.size >= (this.config.maxConcurrentRequests ?? 2))
           break;
-        this.loadingBlocks.add(r), c(this.dataSource, r, t, {}).then((n) => {
-          this.loadedBlocks.set(r, n.rows), this.totalRowCount = n.totalRowCount, this.loadingBlocks.delete(r), this.requestRender(), this.loadRequiredBlocks();
+        this.loadingBlocks.add(i), a(this.dataSource, i, t, {}).then((n) => {
+          this.loadedBlocks.set(i, n.rows), this.totalRowCount = n.totalRowCount, this.loadingBlocks.delete(i), this.requestRender(), this.loadRequiredBlocks();
         }).catch(() => {
-          this.loadingBlocks.delete(r);
+          this.loadingBlocks.delete(i);
         });
       }
   }
@@ -389,8 +391,8 @@ class R extends d {
     if (!this.dataSource) return [...e];
     const t = [];
     for (let o = 0; o < this.totalRowCount; o++) {
-      const i = g(o, this.config.cacheBlockSize ?? 100, this.loadedBlocks);
-      t.push(i ?? { __loading: !0, __index: o });
+      const r = f(o, this.config.cacheBlockSize ?? 100, this.loadedBlocks);
+      t.push(r ?? { __loading: !0, __index: o });
     }
     return t;
   }
@@ -398,7 +400,7 @@ class R extends d {
   onScroll(e) {
     this.dataSource && (this.loadRequiredBlocks(), this.scrollDebounceTimer && clearTimeout(this.scrollDebounceTimer), this.scrollDebounceTimer = setTimeout(() => {
       this.loadRequiredBlocks();
-    }, f));
+    }, R));
   }
   // #endregion
   // #region Public API
@@ -409,7 +411,7 @@ class R extends d {
   setDataSource(e) {
     this.dataSource = e, this.loadedBlocks.clear(), this.loadingBlocks.clear();
     const t = this.config.cacheBlockSize ?? 100;
-    c(e, 0, t, {}).then((o) => {
+    a(e, 0, t, {}).then((o) => {
       this.loadedBlocks.set(0, o.rows), this.totalRowCount = o.totalRowCount, this.requestRender();
     });
   }
@@ -448,6 +450,6 @@ class R extends d {
   // #endregion
 }
 export {
-  R as ServerSidePlugin
+  k as ServerSidePlugin
 };
 //# sourceMappingURL=index.js.map