bways-grid 0.0.5

package/lib/models/csv-export.model.d.ts

@@ -0,0 +1,12 @@
+export interface CsvExportOptions {
+    /** Whether to export all rows in the dataset or only the rows currently visible (filtered/sorted). Default: 'all' */
+    mode?: 'visible' | 'all';
+    /** The filename to save the downloaded file as. Default: 'export.csv' */
+    fileName?: string;
+    /** Whether to include the column headers in the first row. Default: true */
+    includeHeaders?: boolean;
+    /** The character used to separate values. Default: ',' */
+    separator?: string;
+    /** Optional list of column fields to export. If not provided, all visible columns are exported. */
+    columnKeys?: string[];
+}

package/lib/models/filter.model.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Condition-based filter model for AG Grid-style advanced filtering.
+ * Each column can have up to 2 conditions joined by AND/OR.
+ */
+export type TextFilterType = 'contains' | 'notContains' | 'equals' | 'notEqual' | 'startsWith' | 'endsWith' | 'blank' | 'notBlank';
+export type NumberFilterType = 'equals' | 'notEqual' | 'greaterThan' | 'greaterThanOrEqual' | 'lessThan' | 'lessThanOrEqual' | 'inRange' | 'blank' | 'notBlank';
+export type FilterConditionType = TextFilterType | NumberFilterType;
+export interface FilterCondition {
+    type: FilterConditionType;
+    value: string;
+    valueTo?: string;
+}
+export type JoinOperator = 'AND' | 'OR';
+export interface ColumnConditionFilter {
+    condition1: FilterCondition;
+    operator: JoinOperator;
+    condition2?: FilterCondition;
+}

package/lib/models/grid-config.model.d.ts

@@ -0,0 +1,11 @@
+export interface UltraGridConfig {
+    rowHeight?: number;
+    headerHeight?: number;
+    bufferSize?: number;
+    theme?: 'ag-theme-alpine' | 'ag-theme-balham' | 'custom';
+    multiSort?: boolean;
+    rowSelection?: 'single' | 'multiple';
+    sideBar?: boolean;
+    groupIncludeFooter?: boolean;
+    statusBar?: boolean;
+}

package/lib/models/row.model.d.ts

@@ -0,0 +1,26 @@
+export type UltraGridNodeType = 'group' | 'leaf' | 'group-footer';
+export interface UltraGridNode {
+    id: string | number;
+    type: UltraGridNodeType;
+    level: number;
+    parent?: UltraGridGroupNode | null;
+    data: any;
+    selected?: boolean;
+    height?: number;
+    top?: number;
+}
+export interface UltraGridLeafNode extends UltraGridNode {
+    type: 'leaf';
+}
+export interface UltraGridGroupNode extends UltraGridNode {
+    type: 'group';
+    groupField: string;
+    groupKey: any;
+    children: UltraGridNode[];
+}
+export interface UltraGridGroupFooterNode extends UltraGridNode {
+    type: 'group-footer';
+    groupField: string;
+    groupKey: any;
+}
+export type UltraGridRow = UltraGridLeafNode | UltraGridGroupNode | UltraGridGroupFooterNode;

package/lib/services/csv-export.service.d.ts

@@ -0,0 +1,11 @@
+import { CsvExportOptions } from '../models/csv-export.model';
+import { UltraGridColumn } from '../models/column.model';
+import * as i0 from "@angular/core";
+export declare class CsvExportService {
+    private isBrowser;
+    constructor(platformId: Object);
+    exportDataAsCsv(options: CsvExportOptions, columns: UltraGridColumn[], data: any[], config?: any): Promise<void>;
+    private downloadBlob;
+    static ɵfac: i0.ɵɵFactoryDeclaration<CsvExportService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<CsvExportService>;
+}

package/lib/workers/generated/export.worker.code.d.ts

@@ -0,0 +1 @@
+export declare const EXPORT_WORKER_CODE = "\"use strict\";(()=>{var E=1e4;addEventListener(\"message\",({data:a})=>{let{action:c,columns:e,data:l,options:u}=a;if(c===\"START_EXPORT\")try{let s=u.separator||\",\",g=u.includeHeaders!==!1,o=[];if(g){let t=e.map(n=>m(n.headerName||n.field,s)).join(s);o.push(t+`\n`)}let r=\"\",d=0,f=(t,n)=>{let C=t.data?t.data:t,y=e.map((p,h)=>{let i=C[p.field];return h===0&&n>0&&(i=\"   \".repeat(n)+(i||\"\")),h===0&&t.type===\"group\"&&t.children&&(i=(i||\"\")+` (${t.children.length})`),m(i,s)}).join(s);if(r+=y+`\n`,d++,d>0&&d%E===0&&(o.push(r),r=\"\"),t.type===\"group\"&&t.children&&t.children.length>0)for(let p of t.children)f(p,n+1)};for(let t=0;t<l.length;t++){let n=l[t].level||0;f(l[t],n)}r&&o.push(r),postMessage({action:\"COMPLETE\",payload:{parts:o,type:\"text/csv;charset=utf-8\"}})}catch(s){postMessage({action:\"ERROR\",error:s.message||\"CSV Export Failed\"})}});function m(a,c){if(a==null)return\"\";let e=String(a);return e.includes(c)||e.includes(`\n`)||e.includes('\"')?`\"${e.replace(/\"/g,'\"\"')}\"`:e}})();\n";

package/lib/workers/generated/sorting.worker.code.d.ts

@@ -0,0 +1 @@
+export declare const SORTING_WORKER_CODE = "\"use strict\";(()=>{var G=[],N=[];addEventListener(\"message\",r=>{let{action:a,rows:n,sortModel:o,filterModel:i,conditionFilters:e,groupModel:t,aggregations:d,groupStateMap:l}=r.data;if(a===\"INIT\"){G=(n||[]).map(u=>({...u,type:\"leaf\",level:0})),postMessage({action:\"INIT_DONE\"});return}if(a===\"FLATTEN_ONLY\"){let s=m(N,l||{},r.data.groupIncludeFooter);postMessage({flatList:s});return}if(a===\"EXECUTE\"){let s=G;if(i&&Object.keys(i).length>0){let c={};for(let p of Object.keys(i))c[p]=new Set(i[p]);s=s.filter(p=>{for(let y of Object.keys(c)){let F=c[y],k=p.data?p.data[y]:null;if(!F.has(k))return!1}return!0})}e&&Object.keys(e).length>0&&(s=O(s,e));let u=s,f=d||{};if(t&&t.length>0?u=E(s,t,f):s.forEach(c=>c.level=0),o&&o.length>0&&L(u,o),N=u,t&&t.length>0&&r.data.groupIncludeFooter&&Object.keys(f).length>0){let p={id:\"grand-total-footer\",type:\"group-footer\",level:0,groupField:\"Grand Total\",groupKey:\"Grand Total\",data:v(s,f)};N.push(p)}let g=m(N,l||{},r.data.groupIncludeFooter),h=U(N);postMessage({flatList:g,resultTree:h})}});function U(r){return r.map(a=>{if(a.type===\"leaf\")return{id:a.id,type:\"leaf\",level:a.level};if(a.type===\"group\"){let n=a;return{...n,children:n.children?U(n.children):void 0}}return a})}function m(r,a,n=!1){let o=[],i=[];for(let e=r.length-1;e>=0;e--)i.push(r[e]);for(;i.length>0;){let e=i.pop();if(e.type===\"group\"){let t=e;if(o.push({id:t.id,type:\"group\",level:t.level,groupField:t.groupField,groupKey:t.groupKey,data:t.data,childCount:t.children?t.children.length:0}),!!a[t.id]&&(n&&i.push({id:`${t.id}-footer`,type:\"group-footer\",level:t.level,groupField:t.groupField,groupKey:t.groupKey,data:{...t.data}}),t.children))for(let l=t.children.length-1;l>=0;l--)i.push(t.children[l])}else e.type===\"group-footer\"?o.push({id:e.id,type:\"group-footer\",level:e.level,groupField:e.groupField,groupKey:e.groupKey,data:e.data}):o.push({id:e.id,type:\"leaf\",level:e.level})}return o}function E(r,a,n){return T(r,a,0,n,\"root\")}function T(r,a,n,o,i){let e=a[n],t=n===a.length-1,d=new Map;for(let s of r){let u=s.data?s.data[e]:null;d.has(u)||d.set(u,[]),d.get(u).push(s)}let l=[];for(let[s,u]of d.entries()){let f=`${i}-${e}-${s}`,g={id:f,type:\"group\",level:n,groupField:e,groupKey:s,data:{[e]:s},children:[]},h=v(u,o);Object.assign(g.data,h),t?(u.forEach(c=>c.level=n+1),g.children=u):g.children=T(u,a,n+1,o,f),l.push(g)}return l}function v(r,a){let n={};for(let o of Object.keys(a)){let i=a[o],e=0;if(i===\"count\")e=r.length;else{let t=!0,d=0,l=0;for(let s of r){let u=s.data?s.data[o]:0,f=0;typeof u==\"number\"?f=u:typeof u==\"string\"&&(f=Number(u.replace(/[^0-9.-]+/g,\"\"))),isNaN(f)&&(f=0),i===\"sum\"?e+=f:i===\"min\"?t?e=f:e=Math.min(e,f):i===\"max\"?t?e=f:e=Math.max(e,f):i===\"avg\"&&(d+=f,l++),t=!1}i===\"avg\"&&(e=l>0?d/l:0)}n[o]=e}return n}function L(r,a){r.sort((n,o)=>{for(let i of a){let{field:e,direction:t}=i,d=n.data?n.data[e]:null,l=o.data?o.data[e]:null;if(d===l)continue;let s=d>l?1:-1;return t===\"asc\"?s:-s}return 0});for(let n of r)n.type===\"group\"&&n.children&&L(n.children,a)}function O(r,a){let n=Object.keys(a);return n.length===0?r:r.filter(o=>{for(let i of n){let e=a[i];if(!e||!e.condition1)continue;let t=o.data?o.data[i]:null,d=b(t,e.condition1);if(e.condition2&&e.condition2.type){let l=b(t,e.condition2);if(!(e.operator===\"OR\"?d||l:d&&l))return!1}else if(!d)return!1}return!0})}function b(r,a){let{type:n,value:o,valueTo:i}=a;if(n===\"blank\")return r==null||r===\"\";if(n===\"notBlank\")return r!=null&&r!==\"\";if(o==null||o===\"\")return!0;let e=String(r??\"\").toLowerCase(),t=String(o).toLowerCase();switch(n){case\"contains\":return e.includes(t);case\"notContains\":return!e.includes(t);case\"equals\":return!isNaN(Number(r))&&!isNaN(Number(o))?Number(r)===Number(o):e===t;case\"notEqual\":return!isNaN(Number(r))&&!isNaN(Number(o))?Number(r)!==Number(o):e!==t;case\"startsWith\":return e.startsWith(t);case\"endsWith\":return e.endsWith(t);case\"greaterThan\":return Number(r)>Number(o);case\"greaterThanOrEqual\":return Number(r)>=Number(o);case\"lessThan\":return Number(r)<Number(o);case\"lessThanOrEqual\":return Number(r)<=Number(o);case\"inRange\":if(i==null||i===\"\")return!0;let d=Number(r);return d>=Number(o)&&d<=Number(i);default:return!0}}})();\n";

package/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "bways-grid",
+  "version": "0.0.5",
+  "peerDependencies": {
+    "@angular/common": "^19.2.0",
+    "@angular/core": "^19.2.0"
+  },
+  "dependencies": {
+    "tslib": "^2.3.0"
+  },
+  "sideEffects": false,
+  "module": "fesm2022/bways-grid.mjs",
+  "typings": "index.d.ts",
+  "exports": {
+    "./package.json": {
+      "default": "./package.json"
+    },
+    ".": {
+      "types": "./index.d.ts",
+      "default": "./fesm2022/bways-grid.mjs"
+    }
+  }
+}

package/public-api.d.ts

@@ -0,0 +1,19 @@
+export * from './lib/bways-grid.module';
+export * from './lib/components/ultra-grid/ultra-grid.component';
+export * from './lib/components/header/header.component';
+export * from './lib/components/row/row.component';
+export * from './lib/components/cell/cell.component';
+export * from './lib/components/pagination/pagination.component';
+export * from './lib/components/side-bar/side-bar.component';
+export * from './lib/components/column-tool-panel/column-tool-panel.component';
+export * from './lib/components/filter-tool-panel/filter-tool-panel.component';
+export * from './lib/directives/column-resize.directive';
+export * from './lib/models/column.model';
+export * from './lib/models/row.model';
+export * from './lib/models/grid-config.model';
+export * from './lib/models/filter.model';
+export * from './lib/datasources/server-datasource.interface';
+export * from './lib/datasources/infinite-scroll.datasource';
+export * from './lib/core/grid-engine.service';
+export * from './lib/core/viewport-manager';
+export * from './lib/core/row-cache';

package/src/lib/workers/export.worker.ts

@@ -0,0 +1,110 @@
+/// <reference lib="webworker" />
+import { CsvExportOptions } from '../models/csv-export.model';
+import { UltraGridColumn } from '../models/column.model';
+
+const CHUNK_SIZE = 10000;
+
+addEventListener('message', ({ data: msg }) => {
+    const { action, columns, data, options } = msg;
+
+    if (action === 'START_EXPORT') {
+        try {
+            const separator = options.separator || ',';
+            const includeHeaders = options.includeHeaders !== false;
+
+            // We use an array of strings as a payload buffer. 
+            // V8 String concat `a += b` can hit memory bounds and slow down exponentially.
+            // Joining an array at the end is orders of magnitude faster and memory-safe.
+            const parts: string[] = [];
+
+            // Write Headers
+            if (includeHeaders) {
+                const headerRow = columns.map((col: UltraGridColumn) => escapeCsvValue(col.headerName || col.field, separator)).join(separator);
+                parts.push(headerRow + '\n');
+            }
+
+            // We use a helper function to process rows recursively to handle hidden/collapsed tree children
+            let currentChunkStr = '';
+            let rowCount = 0;
+
+            const processRow = (row: any, currentLevel: number) => {
+                // If it's a flattened Tree Node (from Grid engine), extract the underlying 'data'
+                const rowData = row.data ? row.data : row;
+
+                const csvRow = columns.map((col: UltraGridColumn, colIndex: number) => {
+                    let val = rowData[col.field];
+
+                    // Add indentation for TREE data on the very first column
+                    if (colIndex === 0 && currentLevel > 0) {
+                        const indent = '   '.repeat(currentLevel);
+                        val = indent + (val || '');
+                    }
+
+                    // Append count to groups if it's the group field
+                    if (colIndex === 0 && row.type === 'group' && row.children) {
+                        val = (val || '') + ` (${row.children.length})`;
+                    }
+
+                    return escapeCsvValue(val, separator);
+                }).join(separator);
+
+                currentChunkStr += csvRow + '\n';
+                rowCount++;
+
+                if (rowCount > 0 && rowCount % CHUNK_SIZE === 0) {
+                    parts.push(currentChunkStr);
+                    currentChunkStr = '';
+                }
+
+                // Recursively process children if they exist to ensure collapsed rows are exported
+                if (row.type === 'group' && row.children && row.children.length > 0) {
+                    for (const child of row.children) {
+                        processRow(child, currentLevel + 1);
+                    }
+                }
+            };
+
+            for (let i = 0; i < data.length; i++) {
+                // Determine base level, usually 0 for top level rows. 
+                // data[i].level might already be set if it came from the flattener, so we prefer that if present.
+                const baseLevel = data[i].level || 0;
+                processRow(data[i], baseLevel);
+            }
+
+            // Push final remaining rows
+            if (currentChunkStr) {
+                parts.push(currentChunkStr);
+            }
+
+            // Return the Array of Strings (not joined) back to main thread.
+            // The Main Thread using `new Blob(parts)` accepts string arrays directly and handles the concatenation 
+            // using native fast path, avoiding hitting Javascript String length allocation limits.
+            postMessage({
+                action: 'COMPLETE',
+                payload: {
+                    parts,
+                    type: 'text/csv;charset=utf-8'
+                }
+            });
+
+        } catch (e: any) {
+            postMessage({ action: 'ERROR', error: e.message || 'CSV Export Failed' });
+        }
+    }
+});
+
+function escapeCsvValue(value: any, separator: string): string {
+    if (value === null || value === undefined) {
+        return '';
+    }
+
+    const strValue = String(value);
+
+    // If the value contains the separator, a newline, or a double quote, it must be enclosed in quotes
+    if (strValue.includes(separator) || strValue.includes('\n') || strValue.includes('"')) {
+        // Double up any existing quotes inside the string, then wrap the whole string in quotes
+        return `"${strValue.replace(/"/g, '""')}"`;
+    }
+
+    return strValue;
+}

package/src/lib/workers/generated/export.worker.code.ts

@@ -0,0 +1,7 @@
+// AUTO-GENERATED FILE. DO NOT EDIT.
+// Built from src/lib/workers/export.worker.ts
+export const EXPORT_WORKER_CODE = `"use strict";(()=>{var E=1e4;addEventListener("message",({data:a})=>{let{action:c,columns:e,data:l,options:u}=a;if(c==="START_EXPORT")try{let s=u.separator||",",g=u.includeHeaders!==!1,o=[];if(g){let t=e.map(n=>m(n.headerName||n.field,s)).join(s);o.push(t+\`
+\`)}let r="",d=0,f=(t,n)=>{let C=t.data?t.data:t,y=e.map((p,h)=>{let i=C[p.field];return h===0&&n>0&&(i="   ".repeat(n)+(i||"")),h===0&&t.type==="group"&&t.children&&(i=(i||"")+\` (\${t.children.length})\`),m(i,s)}).join(s);if(r+=y+\`
+\`,d++,d>0&&d%E===0&&(o.push(r),r=""),t.type==="group"&&t.children&&t.children.length>0)for(let p of t.children)f(p,n+1)};for(let t=0;t<l.length;t++){let n=l[t].level||0;f(l[t],n)}r&&o.push(r),postMessage({action:"COMPLETE",payload:{parts:o,type:"text/csv;charset=utf-8"}})}catch(s){postMessage({action:"ERROR",error:s.message||"CSV Export Failed"})}});function m(a,c){if(a==null)return"";let e=String(a);return e.includes(c)||e.includes(\`
+\`)||e.includes('"')?\`"\${e.replace(/"/g,'""')}"\`:e}})();
+`;

package/src/lib/workers/generated/sorting.worker.code.ts

@@ -0,0 +1,4 @@
+// AUTO-GENERATED FILE. DO NOT EDIT.
+// Built from src/lib/workers/sorting.worker.ts
+export const SORTING_WORKER_CODE = `"use strict";(()=>{var G=[],N=[];addEventListener("message",r=>{let{action:a,rows:n,sortModel:o,filterModel:i,conditionFilters:e,groupModel:t,aggregations:d,groupStateMap:l}=r.data;if(a==="INIT"){G=(n||[]).map(u=>({...u,type:"leaf",level:0})),postMessage({action:"INIT_DONE"});return}if(a==="FLATTEN_ONLY"){let s=m(N,l||{},r.data.groupIncludeFooter);postMessage({flatList:s});return}if(a==="EXECUTE"){let s=G;if(i&&Object.keys(i).length>0){let c={};for(let p of Object.keys(i))c[p]=new Set(i[p]);s=s.filter(p=>{for(let y of Object.keys(c)){let F=c[y],k=p.data?p.data[y]:null;if(!F.has(k))return!1}return!0})}e&&Object.keys(e).length>0&&(s=O(s,e));let u=s,f=d||{};if(t&&t.length>0?u=E(s,t,f):s.forEach(c=>c.level=0),o&&o.length>0&&L(u,o),N=u,t&&t.length>0&&r.data.groupIncludeFooter&&Object.keys(f).length>0){let p={id:"grand-total-footer",type:"group-footer",level:0,groupField:"Grand Total",groupKey:"Grand Total",data:v(s,f)};N.push(p)}let g=m(N,l||{},r.data.groupIncludeFooter),h=U(N);postMessage({flatList:g,resultTree:h})}});function U(r){return r.map(a=>{if(a.type==="leaf")return{id:a.id,type:"leaf",level:a.level};if(a.type==="group"){let n=a;return{...n,children:n.children?U(n.children):void 0}}return a})}function m(r,a,n=!1){let o=[],i=[];for(let e=r.length-1;e>=0;e--)i.push(r[e]);for(;i.length>0;){let e=i.pop();if(e.type==="group"){let t=e;if(o.push({id:t.id,type:"group",level:t.level,groupField:t.groupField,groupKey:t.groupKey,data:t.data,childCount:t.children?t.children.length:0}),!!a[t.id]&&(n&&i.push({id:\`\${t.id}-footer\`,type:"group-footer",level:t.level,groupField:t.groupField,groupKey:t.groupKey,data:{...t.data}}),t.children))for(let l=t.children.length-1;l>=0;l--)i.push(t.children[l])}else e.type==="group-footer"?o.push({id:e.id,type:"group-footer",level:e.level,groupField:e.groupField,groupKey:e.groupKey,data:e.data}):o.push({id:e.id,type:"leaf",level:e.level})}return o}function E(r,a,n){return T(r,a,0,n,"root")}function T(r,a,n,o,i){let e=a[n],t=n===a.length-1,d=new Map;for(let s of r){let u=s.data?s.data[e]:null;d.has(u)||d.set(u,[]),d.get(u).push(s)}let l=[];for(let[s,u]of d.entries()){let f=\`\${i}-\${e}-\${s}\`,g={id:f,type:"group",level:n,groupField:e,groupKey:s,data:{[e]:s},children:[]},h=v(u,o);Object.assign(g.data,h),t?(u.forEach(c=>c.level=n+1),g.children=u):g.children=T(u,a,n+1,o,f),l.push(g)}return l}function v(r,a){let n={};for(let o of Object.keys(a)){let i=a[o],e=0;if(i==="count")e=r.length;else{let t=!0,d=0,l=0;for(let s of r){let u=s.data?s.data[o]:0,f=0;typeof u=="number"?f=u:typeof u=="string"&&(f=Number(u.replace(/[^0-9.-]+/g,""))),isNaN(f)&&(f=0),i==="sum"?e+=f:i==="min"?t?e=f:e=Math.min(e,f):i==="max"?t?e=f:e=Math.max(e,f):i==="avg"&&(d+=f,l++),t=!1}i==="avg"&&(e=l>0?d/l:0)}n[o]=e}return n}function L(r,a){r.sort((n,o)=>{for(let i of a){let{field:e,direction:t}=i,d=n.data?n.data[e]:null,l=o.data?o.data[e]:null;if(d===l)continue;let s=d>l?1:-1;return t==="asc"?s:-s}return 0});for(let n of r)n.type==="group"&&n.children&&L(n.children,a)}function O(r,a){let n=Object.keys(a);return n.length===0?r:r.filter(o=>{for(let i of n){let e=a[i];if(!e||!e.condition1)continue;let t=o.data?o.data[i]:null,d=b(t,e.condition1);if(e.condition2&&e.condition2.type){let l=b(t,e.condition2);if(!(e.operator==="OR"?d||l:d&&l))return!1}else if(!d)return!1}return!0})}function b(r,a){let{type:n,value:o,valueTo:i}=a;if(n==="blank")return r==null||r==="";if(n==="notBlank")return r!=null&&r!=="";if(o==null||o==="")return!0;let e=String(r??"").toLowerCase(),t=String(o).toLowerCase();switch(n){case"contains":return e.includes(t);case"notContains":return!e.includes(t);case"equals":return!isNaN(Number(r))&&!isNaN(Number(o))?Number(r)===Number(o):e===t;case"notEqual":return!isNaN(Number(r))&&!isNaN(Number(o))?Number(r)!==Number(o):e!==t;case"startsWith":return e.startsWith(t);case"endsWith":return e.endsWith(t);case"greaterThan":return Number(r)>Number(o);case"greaterThanOrEqual":return Number(r)>=Number(o);case"lessThan":return Number(r)<Number(o);case"lessThanOrEqual":return Number(r)<=Number(o);case"inRange":if(i==null||i==="")return!0;let d=Number(r);return d>=Number(o)&&d<=Number(i);default:return!0}}})();
+`;