@toolbox-web/grid 0.2.7 → 0.3.0

package/lib/plugins/filtering/FilteringPlugin.d.ts

@@ -0,0 +1,128 @@
+import { BaseGridPlugin, GridElement } from '../../core/plugin/base-plugin';
+import { ColumnState } from '../../core/types';
+import { FilterConfig, FilterModel } from './types';
+/**
+ * Filtering Plugin for tbw-grid
+ *
+ * @example
+ * ```ts
+ * new FilteringPlugin({ enabled: true, debounceMs: 300 })
+ * ```
+ */
+export declare class FilteringPlugin extends BaseGridPlugin<FilterConfig> {
+    readonly name = "filtering";
+    readonly version = "1.0.0";
+    protected get defaultConfig(): Partial<FilterConfig>;
+    private filters;
+    private cachedResult;
+    private cacheKey;
+    private openPanelField;
+    private panelElement;
+    private searchText;
+    private excludedValues;
+    private panelAbortController;
+    private globalStylesInjected;
+    private static readonly LIST_ITEM_HEIGHT;
+    private static readonly LIST_OVERSCAN;
+    private static readonly LIST_BYPASS_THRESHOLD;
+    attach(grid: GridElement): void;
+    detach(): void;
+    processRows(rows: readonly unknown[]): unknown[];
+    afterRender(): void;
+    /**
+     * Set a filter on a specific field.
+     * Pass null to remove the filter.
+     */
+    setFilter(field: string, filter: Omit<FilterModel, 'field'> | null): void;
+    /**
+     * Get the current filter for a field.
+     */
+    getFilter(field: string): FilterModel | undefined;
+    /**
+     * Get all active filters.
+     */
+    getFilters(): FilterModel[];
+    /**
+     * Alias for getFilters() to match functional API naming.
+     */
+    getFilterModel(): FilterModel[];
+    /**
+     * Set filters from an array (replaces all existing filters).
+     */
+    setFilterModel(filters: FilterModel[]): void;
+    /**
+     * Clear all filters.
+     */
+    clearAllFilters(): void;
+    /**
+     * Clear filter for a specific field.
+     */
+    clearFieldFilter(field: string): void;
+    /**
+     * Check if a field has an active filter.
+     */
+    isFieldFiltered(field: string): boolean;
+    /**
+     * Get the count of filtered rows (from cache).
+     */
+    getFilteredRowCount(): number;
+    /**
+     * Get all active filters (alias for getFilters).
+     */
+    getActiveFilters(): FilterModel[];
+    /**
+     * Get unique values for a field (for set filter dropdowns).
+     * Uses sourceRows to include all values regardless of current filter.
+     */
+    getUniqueValues(field: string): unknown[];
+    /**
+     * Inject global styles for filter panel (rendered in document.body)
+     */
+    private injectGlobalStyles;
+    /**
+     * Toggle the filter panel for a field
+     */
+    private toggleFilterPanel;
+    /**
+     * Render filter panel content with given values
+     */
+    private renderPanelContent;
+    /**
+     * Setup click-outside handler to close the panel
+     */
+    private setupPanelCloseHandler;
+    /**
+     * Close the filter panel
+     */
+    private closeFilterPanel;
+    /**
+     * Position the panel below the button
+     */
+    private positionPanel;
+    /**
+     * Render the default filter panel content
+     */
+    private renderDefaultFilterPanel;
+    /**
+     * Apply a set filter (exclude values)
+     */
+    private applySetFilter;
+    /**
+     * Apply a text filter
+     */
+    private applyTextFilter;
+    /**
+     * Internal method to apply filters (sync or async based on config)
+     */
+    private applyFiltersInternal;
+    /**
+     * Return filter state for a column if it has an active filter.
+     */
+    getColumnState(field: string): Partial<ColumnState> | undefined;
+    /**
+     * Apply filter state from column state.
+     */
+    applyColumnState(field: string, state: ColumnState): void;
+    readonly styles: string;
+}
+//# sourceMappingURL=FilteringPlugin.d.ts.map

package/lib/plugins/filtering/FilteringPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FilteringPlugin.d.ts","sourceRoot":"","sources":["../../../../../../libs/grid/src/lib/plugins/filtering/FilteringPlugin.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,cAAc,EAAE,KAAK,WAAW,EAAE,MAAM,+BAA+B,CAAC;AACjF,OAAO,KAAK,EAAgB,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAIlE,OAAO,KAAK,EAAsB,YAAY,EAAE,WAAW,EAAqB,MAAM,SAAS,CAAC;AAEhG;;;;;;;GAOG;AACH,qBAAa,eAAgB,SAAQ,cAAc,CAAC,YAAY,CAAC;IAC/D,QAAQ,CAAC,IAAI,eAAe;IAC5B,SAAkB,OAAO,WAAW;IAEpC,cAAuB,aAAa,IAAI,OAAO,CAAC,YAAY,CAAC,CAO5D;IAGD,OAAO,CAAC,OAAO,CAAuC;IACtD,OAAO,CAAC,YAAY,CAA0B;IAC9C,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,cAAc,CAAuB;IAC7C,OAAO,CAAC,YAAY,CAA4B;IAChD,OAAO,CAAC,UAAU,CAAkC;IACpD,OAAO,CAAC,cAAc,CAAwC;IAC9D,OAAO,CAAC,oBAAoB,CAAgC;IAC5D,OAAO,CAAC,oBAAoB,CAAS;IAGrC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAM;IAC9C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAK;IAC1C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,qBAAqB,CAAM;IAK1C,MAAM,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI;IAK/B,MAAM,IAAI,IAAI;IAmBd,WAAW,CAAC,IAAI,EAAE,SAAS,OAAO,EAAE,GAAG,OAAO,EAAE;IA6BhD,WAAW,IAAI,IAAI;IAsD5B;;;OAGG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,IAAI;IAyBzE;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAIjD;;OAEG;IACH,UAAU,IAAI,WAAW,EAAE;IAI3B;;OAEG;IACH,cAAc,IAAI,WAAW,EAAE;IAI/B;;OAEG;IACH,cAAc,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,IAAI;IAoB5C;;OAEG;IACH,eAAe,IAAI,IAAI;IAQvB;;OAEG;IACH,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAQrC;;OAEG;IACH,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAIvC;;OAEG;IACH,mBAAmB,IAAI,MAAM;IAI7B;;OAEG;IACH,gBAAgB,IAAI,WAAW,EAAE;IAIjC;;;OAGG;IACH,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,EAAE;IAOzC;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAmB1B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA0CzB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA8C1B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAoB9B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAWxB;;OAEG;IACH,OAAO,CAAC,aAAa;IAmBrB;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAoPhC;;OAEG;IACH,OAAO,CAAC,cAAc;IAoBtB;;OAEG;IACH,OAAO,CAAC,eAAe;IAYvB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAiD5B;;OAEG;IACM,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,GAAG,SAAS;IAcxE;;OAEG;IACM,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI;IAyBlE,SAAkB,MAAM,SAAU;CAEnC"}

package/lib/plugins/filtering/filter-model.d.ts

@@ -0,0 +1,38 @@
+import { FilterModel } from './types';
+/**
+ * Check if a single row matches a filter condition.
+ *
+ * @param row - The row data object
+ * @param filter - The filter to apply
+ * @param caseSensitive - Whether text comparisons are case sensitive
+ * @returns True if the row matches the filter
+ */
+export declare function matchesFilter(row: Record<string, unknown>, filter: FilterModel, caseSensitive?: boolean): boolean;
+/**
+ * Filter rows based on multiple filter conditions (AND logic).
+ * All filters must match for a row to be included.
+ *
+ * @param rows - The rows to filter
+ * @param filters - Array of filters to apply
+ * @param caseSensitive - Whether text comparisons are case sensitive
+ * @returns Filtered rows
+ */
+export declare function filterRows<T extends Record<string, unknown>>(rows: T[], filters: FilterModel[], caseSensitive?: boolean): T[];
+/**
+ * Compute a cache key for a set of filters.
+ * Used for memoization of filter results.
+ *
+ * @param filters - Array of filters
+ * @returns Stable string key for the filter set
+ */
+export declare function computeFilterCacheKey(filters: FilterModel[]): string;
+/**
+ * Extract unique values from a field across all rows.
+ * Useful for populating "set" filter dropdowns.
+ *
+ * @param rows - The rows to extract values from
+ * @param field - The field name
+ * @returns Sorted array of unique non-null values
+ */
+export declare function getUniqueValues<T extends Record<string, unknown>>(rows: T[], field: string): unknown[];
+//# sourceMappingURL=filter-model.d.ts.map

package/lib/plugins/filtering/filter-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter-model.d.ts","sourceRoot":"","sources":["../../../../../../libs/grid/src/lib/plugins/filtering/filter-model.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,aAAa,UAAQ,GAAG,OAAO,CAiE/G;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC1D,IAAI,EAAE,CAAC,EAAE,EACT,OAAO,EAAE,WAAW,EAAE,EACtB,aAAa,UAAQ,GACpB,CAAC,EAAE,CAGL;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,MAAM,CASpE;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,EAAE,CAetG"}

package/lib/plugins/filtering/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Filtering Plugin Entry Point
+ * Re-exports plugin class and types for tree-shakeable imports.
+ */
+export { FilteringPlugin } from './FilteringPlugin';
+export type { FilterConfig, FilterModel, FilterOperator, FilterType } from './types';
+//# sourceMappingURL=index.d.ts.map

package/lib/plugins/filtering/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../libs/grid/src/lib/plugins/filtering/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC"}

package/lib/plugins/filtering/index.js

@@ -221,10 +221,10 @@ function q(p, e, t = !1) {
       return !0;
   }
 }
-function B(p, e, t = !1) {
+function z(p, e, t = !1) {
   return e.length ? p.filter((r) => e.every((l) => q(r, l, t))) : p;
 }
-function z(p) {
+function B(p) {
   return JSON.stringify(
     p.map((e) => ({
       field: e.field,
@@ -242,7 +242,7 @@ function N(p, e) {
   }
   return [...t].sort((r, l) => typeof r == "number" && typeof l == "number" ? r - l : String(r).localeCompare(String(l)));
 }
-const $ = '.header-cell.filtered:before{content:"";position:absolute;top:4px;right:4px;width:6px;height:6px;background:var(--tbw-filter-accent, var(--tbw-color-accent, #3b82f6));border-radius:50%}.tbw-filter-btn{display:inline-flex;align-items:center;justify-content:center;background:transparent;border:none;cursor:pointer;padding:2px;margin-left:4px;opacity:.4;transition:opacity .15s;color:inherit;vertical-align:middle}.tbw-filter-btn:hover,.tbw-filter-btn.active{opacity:1}.tbw-filter-btn.active{color:var(--tbw-filter-accent, var(--tbw-color-accent, #3b82f6))}', K = ".tbw-filter-panel{position:fixed;background:var(--tbw-filter-panel-bg, var(--tbw-color-panel-bg, light-dark(#eeeeee, #222222)));color:var(--tbw-filter-panel-fg, var(--tbw-color-fg, light-dark(#222222, #eeeeee)));border:1px solid var(--tbw-filter-panel-border, var(--tbw-color-border, light-dark(#d0d0d4, #454545)));border-radius:var(--tbw-filter-panel-radius, var(--tbw-border-radius, 4px));box-shadow:0 4px 16px var(--tbw-filter-panel-shadow, var(--tbw-color-shadow, light-dark(rgba(0, 0, 0, .1), rgba(0, 0, 0, .3))));padding:12px;z-index:10000;min-width:200px;max-width:280px;max-height:350px;display:flex;flex-direction:column;font-family:var(--tbw-font-family, system-ui, sans-serif);font-size:var(--tbw-font-size, 13px)}.tbw-filter-search{margin-bottom:8px}.tbw-filter-search-input{width:100%;padding:6px 10px;background:var(--tbw-filter-input-bg, var(--tbw-color-bg, transparent));color:inherit;border:1px solid var(--tbw-filter-input-border, var(--tbw-color-border, light-dark(#d0d0d4, #454545)));border-radius:var(--tbw-filter-input-radius, 4px);font-size:inherit;box-sizing:border-box}.tbw-filter-search-input:focus{outline:none;border-color:var(--tbw-filter-accent, var(--tbw-color-accent, #3b82f6));box-shadow:0 0 0 2px rgba(from var(--tbw-filter-accent, var(--tbw-color-accent, #3b82f6)) r g b / 15%)}.tbw-filter-actions{display:flex;padding:4px 2px;margin-bottom:8px;border-bottom:1px solid var(--tbw-filter-divider, var(--tbw-color-border, light-dark(#d0d0d4, #454545)))}.tbw-filter-action-btn{background:transparent;border:none;color:var(--tbw-filter-accent, var(--tbw-color-accent, #3b82f6));cursor:pointer;font-size:12px;padding:2px 0}.tbw-filter-action-btn:hover{text-decoration:underline}.tbw-filter-values{flex:1;overflow-y:auto;margin-bottom:8px;max-height:180px;position:relative}.tbw-filter-values-spacer{width:1px}.tbw-filter-values-content{position:absolute;top:0;left:0;right:0}.tbw-filter-value-item{display:flex;align-items:center;gap:8px;padding:4px 2px;cursor:pointer;border-radius:3px}.tbw-filter-value-item:hover{background:var(--tbw-filter-hover, var(--tbw-color-row-hover, light-dark(#f0f6ff, #1c1c1c)))}.tbw-filter-checkbox{margin:0;cursor:pointer;accent-color:var(--tbw-filter-accent, var(--tbw-color-accent, #3b82f6))}.tbw-filter-no-match{color:var(--tbw-filter-muted, var(--tbw-color-fg-muted, light-dark(#555555, #aaaaaa)));padding:8px 0;text-align:center;font-style:italic}.tbw-filter-buttons{display:flex;gap:8px;padding-top:8px;border-top:1px solid var(--tbw-filter-divider, var(--tbw-color-border, light-dark(#d0d0d4, #454545)))}.tbw-filter-apply-btn{flex:1;padding:6px 12px;background:var(--tbw-filter-accent, var(--tbw-color-accent, #3b82f6));color:var(--tbw-filter-accent-fg, var(--tbw-color-accent-fg, light-dark(#ffffff, #000000)));border:none;border-radius:4px;cursor:pointer;font-size:13px}.tbw-filter-apply-btn:hover{filter:brightness(.9)}.tbw-filter-clear-btn{flex:1;padding:6px 12px;background:transparent;color:var(--tbw-filter-muted, var(--tbw-color-fg-muted, light-dark(#555555, #aaaaaa)));border:1px solid var(--tbw-filter-input-border, var(--tbw-color-border, light-dark(#d0d0d4, #454545)));border-radius:4px;cursor:pointer;font-size:13px}.tbw-filter-clear-btn:hover{background:var(--tbw-filter-hover, var(--tbw-color-row-hover, light-dark(#f0f6ff, #1c1c1c)))}";
+const $ = ':host .tbw-quick-filter-input{flex:1;max-width:300px;height:28px;padding:0 8px;border:1px solid var(--tbw-color-border);border-radius:var(--tbw-border-radius);background:var(--tbw-color-bg);color:var(--tbw-color-fg);font-size:13px}:host .tbw-quick-filter-input:focus{outline:none;border-color:var(--tbw-color-accent)}.header-cell.filtered:before{content:"";position:absolute;top:4px;right:4px;width:6px;height:6px;background:var(--tbw-filter-accent, var(--tbw-color-accent, #3b82f6));border-radius:50%}.tbw-filter-btn{display:inline-flex;align-items:center;justify-content:center;background:transparent;border:none;cursor:pointer;padding:2px;margin-left:4px;opacity:.4;transition:opacity .15s;color:inherit;vertical-align:middle}.tbw-filter-btn:hover,.tbw-filter-btn.active{opacity:1}.tbw-filter-btn.active{color:var(--tbw-filter-accent, var(--tbw-color-accent, #3b82f6))}', K = ".tbw-filter-panel{position:fixed;background:var(--tbw-filter-panel-bg, var(--tbw-color-panel-bg, light-dark(#eeeeee, #222222)));color:var(--tbw-filter-panel-fg, var(--tbw-color-fg, light-dark(#222222, #eeeeee)));border:1px solid var(--tbw-filter-panel-border, var(--tbw-color-border, light-dark(#d0d0d4, #454545)));border-radius:var(--tbw-filter-panel-radius, var(--tbw-border-radius, 4px));box-shadow:0 4px 16px var(--tbw-filter-panel-shadow, var(--tbw-color-shadow, light-dark(rgba(0, 0, 0, .1), rgba(0, 0, 0, .3))));padding:12px;z-index:10000;min-width:200px;max-width:280px;max-height:350px;display:flex;flex-direction:column;font-family:var(--tbw-font-family, system-ui, sans-serif);font-size:var(--tbw-font-size, 13px)}.tbw-filter-search{margin-bottom:8px}.tbw-filter-search-input{width:100%;padding:6px 10px;background:var(--tbw-filter-input-bg, var(--tbw-color-bg, transparent));color:inherit;border:1px solid var(--tbw-filter-input-border, var(--tbw-color-border, light-dark(#d0d0d4, #454545)));border-radius:var(--tbw-filter-input-radius, 4px);font-size:inherit;box-sizing:border-box}.tbw-filter-search-input:focus{outline:none;border-color:var(--tbw-filter-accent, var(--tbw-color-accent, #3b82f6));box-shadow:0 0 0 2px rgba(from var(--tbw-filter-accent, var(--tbw-color-accent, #3b82f6)) r g b / 15%)}.tbw-filter-actions{display:flex;padding:4px 2px;margin-bottom:8px;border-bottom:1px solid var(--tbw-filter-divider, var(--tbw-color-border, light-dark(#d0d0d4, #454545)))}.tbw-filter-action-btn{background:transparent;border:none;color:var(--tbw-filter-accent, var(--tbw-color-accent, #3b82f6));cursor:pointer;font-size:12px;padding:2px 0}.tbw-filter-action-btn:hover{text-decoration:underline}.tbw-filter-values{flex:1;overflow-y:auto;margin-bottom:8px;max-height:180px;position:relative}.tbw-filter-values-spacer{width:1px}.tbw-filter-values-content{position:absolute;top:0;left:0;right:0}.tbw-filter-value-item{display:flex;align-items:center;gap:8px;padding:4px 2px;cursor:pointer;border-radius:3px}.tbw-filter-value-item:hover{background:var(--tbw-filter-hover, var(--tbw-color-row-hover, light-dark(#f0f6ff, #1c1c1c)))}.tbw-filter-checkbox{margin:0;cursor:pointer;accent-color:var(--tbw-filter-accent, var(--tbw-color-accent, #3b82f6))}.tbw-filter-no-match{color:var(--tbw-filter-muted, var(--tbw-color-fg-muted, light-dark(#555555, #aaaaaa)));padding:8px 0;text-align:center;font-style:italic}.tbw-filter-buttons{display:flex;gap:8px;padding-top:8px;border-top:1px solid var(--tbw-filter-divider, var(--tbw-color-border, light-dark(#d0d0d4, #454545)))}.tbw-filter-apply-btn{flex:1;padding:6px 12px;background:var(--tbw-filter-accent, var(--tbw-color-accent, #3b82f6));color:var(--tbw-filter-accent-fg, var(--tbw-color-accent-fg, light-dark(#ffffff, #000000)));border:none;border-radius:4px;cursor:pointer;font-size:13px}.tbw-filter-apply-btn:hover{filter:brightness(.9)}.tbw-filter-clear-btn{flex:1;padding:6px 12px;background:transparent;color:var(--tbw-filter-muted, var(--tbw-color-fg-muted, light-dark(#555555, #aaaaaa)));border:1px solid var(--tbw-filter-input-border, var(--tbw-color-border, light-dark(#d0d0d4, #454545)));border-radius:4px;cursor:pointer;font-size:13px}.tbw-filter-clear-btn:hover{background:var(--tbw-filter-hover, var(--tbw-color-row-hover, light-dark(#f0f6ff, #1c1c1c)))}";
 class x extends _ {
   name = "filtering";
   version = "1.0.0";
@@ -285,10 +285,10 @@ class x extends _ {
     if (!t.length) return [...e];
     if (this.config.filterHandler)
       return this.cachedResult ? this.cachedResult : [...e];
-    const r = z(t);
+    const r = B(t);
     if (this.cacheKey === r && this.cachedResult)
       return this.cachedResult;
-    const l = B([...e], t, this.config.caseSensitive);
+    const l = z([...e], t, this.config.caseSensitive);
     return this.cachedResult = l, this.cacheKey = r, l;
   }
   afterRender() {