@toolbox-web/grid 2.0.0-rc.1 → 2.0.0-rc.3

package/lib/plugins/server-side/ServerSidePlugin.d.ts

@@ -1,10 +1,12 @@
-import { BaseGridPlugin, ScrollEvent, PluginManifest } from '../../core/plugin/base-plugin';
-import { ServerSideConfig, ServerSideDataSource } from './types';
+import { BaseGridPlugin, ScrollEvent, PluginManifest, PluginQuery } from '../../core/plugin/base-plugin';
+import { ServerSideDataSource } from './datasource-types';
+import { ServerSideConfig } from './types';
 /**
  * Server-Side Data Plugin for tbw-grid
  *
- * Enables lazy loading of data from a remote server with caching and block-based fetching.
- * Ideal for large datasets where loading all data upfront is impractical.
+ * Central data orchestrator for the grid. Manages fetch, cache, and row-model for
+ * server-side data loading. Structural plugins (Tree, GroupingRows) can claim data
+ * via events; the core grid uses it as flat rows when unclaimed.
  *
  * ## Installation
  *
@@ -17,6 +19,7 @@ import { ServerSideConfig, ServerSideDataSource } from './types';
  * ```ts
  * interface ServerSideDataSource {
  *   getRows(params: GetRowsParams): Promise<GetRowsResult>;
+ *   getChildRows?(params: GetChildRowsParams): Promise<GetChildRowsResult>;
  * }
  * ```
  *
@@ -28,10 +31,10 @@ import { ServerSideConfig, ServerSideDataSource } from './types';
  * const dataSource = {
  *   async getRows(params) {
  *     const response = await fetch(
- *       `/api/data?start=${params.startRow}&end=${params.endRow}`
+ *       `/api/data?start=${params.startNode}&end=${params.endNode}`
  *     );
  *     const data = await response.json();
- *     return { rows: data.rows, totalRowCount: data.total };
+ *     return { rows: data.rows, totalNodeCount: data.total };
  *   },
  * };
  *
@@ -51,7 +54,7 @@ import { ServerSideConfig, ServerSideDataSource } from './types';
  */
 export declare class ServerSidePlugin extends BaseGridPlugin<ServerSideConfig> {
     /**
-     * Plugin manifest declaring incompatibilities with other plugins.
+     * Plugin manifest declaring capabilities, hooks, events, and queries.
      * @internal
      */
     static readonly manifest: PluginManifest;
@@ -60,15 +63,31 @@ export declare class ServerSidePlugin extends BaseGridPlugin<ServerSideConfig> {
     /** @internal */
     protected get defaultConfig(): Partial<ServerSideConfig>;
     private dataSource;
-    private totalRowCount;
+    private totalNodeCount;
     private loadedBlocks;
     private loadingBlocks;
     private lastRequestId;
     private scrollDebounceTimer?;
-    /** Persistent row array with stable placeholder references to avoid unnecessary DOM rebuilds. */
-    private managedRows;
+    /** Persistent node array with stable placeholder references to avoid unnecessary DOM rebuilds. */
+    private managedNodes;
+    /** @internal */
+    attach(grid: import('../../core/plugin/base-plugin').GridElement): void;
     /** @internal */
     detach(): void;
+    /**
+     * Build enrichment params by querying sort/filter models from loaded plugins.
+     */
+    private getEnrichmentParams;
+    /**
+     * Translate visible viewport indices to node-space indices via structural plugins.
+     * Falls back to 1:1 mapping (flat data) when no structural plugin responds.
+     */
+    private getViewportMapping;
+    /**
+     * Handle sort or filter model changes.
+     * Purge cache and refetch current viewport with new enrichment params.
+     */
+    private onModelChange;
     /**
      * Check current viewport and load any missing blocks.
      */
@@ -77,13 +96,20 @@ export declare class ServerSidePlugin extends BaseGridPlugin<ServerSideConfig> {
     processRows(rows: readonly unknown[]): unknown[];
     /** @internal */
     onScroll(event: ScrollEvent): void;
+    /** @internal */
+    handleQuery(query: PluginQuery): unknown;
+    /**
+     * Fetch child rows via the datasource and broadcast the result.
+     */
+    private fetchChildren;
     /**
      * Set the data source for server-side loading.
-     * @param dataSource - Data source implementing the getRows method
+     * @param dataSource - Data source implementing the getRows method (and optionally getChildRows)
      */
     setDataSource(dataSource: ServerSideDataSource): void;
     /**
      * Refresh all data from the server.
+     * Purges cache and refetches from block 0.
      */
     refresh(): void;
     /**
@@ -91,12 +117,20 @@ export declare class ServerSidePlugin extends BaseGridPlugin<ServerSideConfig> {
      */
     purgeCache(): void;
     /**
-     * Get the total row count from the server.
+     * Get the total node count from the server.
+     */
+    getTotalNodeCount(): number;
+    /**
+     * @deprecated Use {@link getTotalNodeCount} instead. Will be removed in a future version.
      */
     getTotalRowCount(): number;
     /**
-     * Check if a specific row is loaded in the cache.
-     * @param rowIndex - Row index to check
+     * Check if a specific node is loaded in the cache.
+     * @param nodeIndex - Node index to check
+     */
+    isNodeLoaded(nodeIndex: number): boolean;
+    /**
+     * @deprecated Use {@link isNodeLoaded} instead. Will be removed in a future version.
      */
     isRowLoaded(rowIndex: number): boolean;
     /**

package/lib/plugins/server-side/datasource-types.d.ts

@@ -0,0 +1,189 @@
+/** Sort/filter state passed through to the server. */
+export interface DataRequestModel {
+    /** Active sort columns, in priority order. Empty array when unsorted. */
+    sortModel?: Array<{
+        field: string;
+        direction: 'asc' | 'desc';
+    }>;
+    /** Active filter model keyed by field name. Empty object when no filters are applied. */
+    filterModel?: Record<string, unknown>;
+}
+/**
+ * Parameters passed to {@link ServerSideDataSource.getRows} for each data request.
+ *
+ * Pagination is in **node space** — one node equals one atomic pagination unit.
+ * For flat data, a node is a row. For tree data, a node is a top-level tree node.
+ * For grouped data, a node is a group definition.
+ *
+ * The grid enriches these params with the current sort/filter state from loaded plugins
+ * (MultiSort, Filtering) so the server can apply them remotely.
+ */
+export interface GetRowsParams extends DataRequestModel {
+    /** Zero-based index of the first node to fetch (inclusive). */
+    startNode: number;
+    /** Zero-based index of the last node to fetch (exclusive). `endNode - startNode` equals the block size. */
+    endNode: number;
+}
+/**
+ * Result returned from {@link ServerSideDataSource.getRows}.
+ *
+ * @example
+ * ```typescript
+ * // Known total (pagination-style)
+ * return { rows: pageData, totalNodeCount: 5000 };
+ *
+ * // Infinite scroll — set lastNode when the final page is reached
+ * return { rows: pageData, totalNodeCount: -1, lastNode: absoluteLastIndex };
+ * ```
+ */
+export interface GetRowsResult<TRow = unknown> {
+    /** The fetched top-level node objects for the requested range. */
+    rows: TRow[];
+    /**
+     * Total number of top-level nodes available on the server.
+     * Use `-1` if unknown (infinite scroll mode).
+     */
+    totalNodeCount: number;
+    /**
+     * The absolute index of the last available node.
+     * Only needed for **infinite scroll** when `totalNodeCount` is `-1`.
+     * Once the server returns the final page, set this so the grid knows
+     * scrolling has reached the end and stops requesting further blocks.
+     */
+    lastNode?: number;
+}
+/**
+ * Parameters for fetching child rows of a parent node.
+ *
+ * The `context` is opaque — provided by the requesting plugin and passed through
+ * to the user's `getChildRows` callback verbatim. Each plugin sets a `source`
+ * discriminator so listeners can filter incoming child events.
+ *
+ * Known context shapes:
+ * - Tree: `{ source: 'tree', parentNode: TreeRow, nodePath: string[] }`
+ * - GroupingRows: `{ source: 'grouping-rows', group: GroupDefinition, groupPath: string[] }`
+ * - MasterDetail: `{ source: 'master-detail', row: TRow, rowIndex: number }`
+ *
+ * Child rows are fetched as a single batch — no pagination.
+ */
+export interface GetChildRowsParams extends DataRequestModel {
+    /**
+     * Opaque context from the requesting plugin.
+     * Contains a `source` discriminator string and plugin-specific fields.
+     * ServerSide does not interpret this object.
+     */
+    context: {
+        source: string;
+        [key: string]: unknown;
+    };
+}
+/**
+ * Result returned from {@link ServerSideDataSource.getChildRows}.
+ * All children are returned in a single batch (no pagination).
+ */
+export interface GetChildRowsResult<TRow = unknown> {
+    rows: TRow[];
+}
+/**
+ * Unified data source contract for server-side data loading.
+ *
+ * Implement `getRows` to supply root-level rows from a remote API, database,
+ * or any asynchronous provider. The grid calls `getRows()` whenever it needs
+ * a new block of rows (on initial load, scroll, sort change, or filter change).
+ *
+ * Optionally implement `getChildRows` for on-demand child data (tree children,
+ * group rows, detail panels, etc.). If child data is already embedded in
+ * parent rows (e.g. tree nodes with inline `children` arrays), this method
+ * is not needed.
+ *
+ * @example
+ * ```typescript
+ * const dataSource: ServerSideDataSource = {
+ *   async getRows(params) {
+ *     const res = await fetch(`/api/data?start=${params.startNode}&end=${params.endNode}`);
+ *     const data = await res.json();
+ *     return { rows: data.items, totalNodeCount: data.total };
+ *   },
+ *   async getChildRows(params) {
+ *     const { source, parentId } = params.context;
+ *     const res = await fetch(`/api/data/${parentId}/children`);
+ *     return { rows: await res.json() };
+ *   }
+ * };
+ * ```
+ */
+export interface ServerSideDataSource<TRow = unknown> {
+    /**
+     * Fetch a page/block of root-level nodes.
+     * Called on initial load and on scroll/page events.
+     *
+     * Before calling this, ServerSide queries loaded plugins for their
+     * current state (sort model, filter model, etc.) and passes it
+     * through in the params.
+     */
+    getRows(params: GetRowsParams): Promise<GetRowsResult<TRow>>;
+    /**
+     * Fetch child rows for a parent context.
+     * Called when a plugin queries `datasource:fetch-children`.
+     *
+     * Child rows are fetched as a single batch — no pagination.
+     * If the dataset is too large, the server should limit the response.
+     *
+     * This method is optional. When not provided and a plugin queries
+     * for children, ServerSide emits a `TBW142` diagnostic warning.
+     */
+    getChildRows?(params: GetChildRowsParams): Promise<GetChildRowsResult<TRow>>;
+}
+/** Detail for `datasource:data` broadcast events. */
+export interface DataSourceDataDetail<TRow = unknown> {
+    rows: TRow[];
+    totalNodeCount: number;
+    startNode: number;
+    endNode: number;
+    /** Mutable flag — structural plugins set this to `true` when they consume the data. */
+    claimed: boolean;
+}
+/** Detail for `datasource:children` broadcast events. */
+export interface DataSourceChildrenDetail<TRow = unknown> {
+    rows: TRow[];
+    context: {
+        source: string;
+        [key: string]: unknown;
+    };
+    /** Mutable flag — the requesting plugin sets this to `true` when it consumes the data. */
+    claimed: boolean;
+}
+/** Detail for `datasource:loading` broadcast events. */
+export interface DataSourceLoadingDetail {
+    loading: boolean;
+    context?: {
+        source: string;
+        [key: string]: unknown;
+    };
+}
+/** Detail for `datasource:error` broadcast events. */
+export interface DataSourceErrorDetail {
+    error: Error;
+    context?: {
+        source: string;
+        [key: string]: unknown;
+    };
+}
+/** Context for `datasource:viewport-mapping` query. */
+export interface ViewportMappingQuery {
+    viewportStart: number;
+    viewportEnd: number;
+}
+/** Response from `datasource:viewport-mapping` query. */
+export interface ViewportMappingResponse {
+    startNode: number;
+    endNode: number;
+    totalLoadedNodes: number;
+}
+/** Context for `datasource:fetch-children` query. */
+export interface FetchChildrenQuery {
+    context: {
+        source: string;
+        [key: string]: unknown;
+    };
+}

package/lib/plugins/server-side/datasource.d.ts

@@ -1,11 +1,11 @@
-import { ServerSideDataSource, GetRowsParams, GetRowsResult } from './types';
-export declare function getBlockNumber(rowIndex: number, blockSize: number): number;
+import { GetRowsParams, GetRowsResult, ServerSideDataSource } from './datasource-types';
+export declare function getBlockNumber(nodeIndex: number, blockSize: number): number;
 export declare function getBlockRange(blockNumber: number, blockSize: number): {
     start: number;
     end: number;
 };
-export declare function getRequiredBlocks(startRow: number, endRow: number, blockSize: number): number[];
+export declare function getRequiredBlocks(startNode: number, endNode: number, blockSize: number): number[];
 export declare function loadBlock(dataSource: ServerSideDataSource, blockNumber: number, blockSize: number, params: Partial<GetRowsParams>): Promise<GetRowsResult>;
-export declare function getRowFromCache(rowIndex: number, blockSize: number, loadedBlocks: Map<number, any[]>): any | undefined;
-export declare function isBlockLoaded(blockNumber: number, loadedBlocks: Map<number, any[]>): boolean;
+export declare function getRowFromCache(nodeIndex: number, blockSize: number, loadedBlocks: Map<number, unknown[]>): unknown | undefined;
+export declare function isBlockLoaded(blockNumber: number, loadedBlocks: Map<number, unknown[]>): boolean;
 export declare function isBlockLoading(blockNumber: number, loadingBlocks: Set<number>): boolean;

package/lib/plugins/server-side/index.d.ts

@@ -5,4 +5,4 @@
  * @module Plugins/Server-Side
  */
 export { ServerSidePlugin } from './ServerSidePlugin';
-export type { GetRowsParams, GetRowsResult, ServerSideConfig, ServerSideDataSource } from './types';
+export type { DataRequestModel, DataSourceChildrenDetail, DataSourceDataDetail, DataSourceErrorDetail, DataSourceLoadingDetail, FetchChildrenQuery, GetChildRowsParams, GetChildRowsResult, GetRowsParams, GetRowsResult, ServerSideConfig, ServerSideDataSource, ViewportMappingQuery, ViewportMappingResponse, } from './types';

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

@@ -1,2 +1,2 @@
-function e(e,t){return`[tbw-grid${e?`#${e}`:""}${t?`:${t}`:""}]`}function t(t,o,r,s){return`${e(r,s)} ${t}: ${o}\n\n  → More info: ${function(e){return`https://toolboxjs.com/grid/errors#${e.toLowerCase()}`}(t)}`}["__otorp__","__retteGenifed__","__retteSenifed__","rotcurtsnoc","wodniw","sihTlabolg","labolg","ssecorp","noitcnuF","tropmi","lave","tcelfeR","yxorP","rorrE","stnemugra","tnemucod","noitacol","eikooc","egarotSlacol","egarotSnoisses","BDdexedni","hctef","tseuqeRpttHLMX","tekcoSbeW","rekroW","rekroWderahS","rekroWecivreS","renepo","tnerap","pot","semarf","fles"].map(e=>e.split("").reverse().join(""));const o=/* @__PURE__ */new Set(["script","iframe","object","embed","form","input","button","textarea","select","link","meta","base","style","template","slot","portal","frame","frameset","applet","noscript","noembed","plaintext","xmp","listing"]),r=/^on\w+$/i,s=/* @__PURE__ */new Set(["href","src","action","formaction","data","srcdoc","xlink:href","poster","srcset"]),i=/^\s*(javascript|vbscript|data|blob):/i;function n(e){if(!e||"string"!=typeof e)return"";if(-1===e.indexOf("<"))return e;const t=document.createElement("template");return t.innerHTML=e,function(e){const t=[],n=e.querySelectorAll("*");for(const a of n){const e=a.tagName.toLowerCase();if(o.has(e)){t.push(a);continue}if("svg"===e||"http://www.w3.org/2000/svg"===a.namespaceURI){if(Array.from(a.attributes).some(e=>r.test(e.name)||"href"===e.name||"xlink:href"===e.name)){t.push(a);continue}}const n=[];for(const t of a.attributes){const e=t.name.toLowerCase();r.test(e)?n.push(t.name):(s.has(e)&&i.test(t.value)||"style"===e&&/expression\s*\(|javascript:|behavior\s*:/i.test(t.value))&&n.push(t.name)}n.forEach(e=>a.removeAttribute(e))}t.forEach(e=>e.remove())}(t.content),t.innerHTML}const a='<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>',l={expand:"▶",collapse:"▼",sortAsc:"▲",sortDesc:"▼",sortNone:"⇅",submenuArrow:"▶",dragHandle:"⋮⋮",toolPanel:"☰",filter:a,filterActive:a,print:"🖨️"};class c{static dependencies;static manifest;aliases;version="undefined"!=typeof __GRID_VERSION__?__GRID_VERSION__:"dev";styles;cellRenderers;headerRenderers;cellEditors;grid;config;userConfig;#e;get defaultConfig(){return{}}constructor(e={}){this.userConfig=e}attach(e){this.#e?.abort(),this.#e=new AbortController,this.grid=e,this.config={...this.defaultConfig,...this.userConfig}}detach(){this.#e?.abort(),this.#e=void 0}getPlugin(e){return this.grid?.getPlugin(e)}emit(e,t){this.grid?.dispatchEvent?.(new CustomEvent(e,{detail:t,bubbles:!0}))}emitCancelable(e,t){const o=new CustomEvent(e,{detail:t,bubbles:!0,cancelable:!0});return this.grid?.dispatchEvent?.(o),o.defaultPrevented}on(e,t){this.grid?._pluginManager?.subscribe(this,e,t)}off(e){this.grid?._pluginManager?.unsubscribe(this,e)}emitPluginEvent(e,t){this.grid?._pluginManager?.emitPluginEvent(e,t)}requestRender(){this.grid?.requestRender?.()}requestColumnsRender(){this.grid?.requestColumnsRender?.()}requestRenderWithFocus(){this.grid?.requestRenderWithFocus?.()}requestAfterRender(){this.grid?.requestAfterRender?.()}requestVirtualRefresh(){this.grid?.requestVirtualRefresh?.()}get rows(){return this.grid?.rows??[]}get sourceRows(){return this.grid?.sourceRows??[]}get columns(){return this.grid?.columns??[]}get visibleColumns(){return this.grid?._visibleColumns??[]}get gridElement(){return this.grid?._hostElement}get disconnectSignal(){return this.#e?.signal??this.grid?.disconnectSignal}get gridIcons(){const e=this.grid?.gridConfig?.icons??{};return{...l,...e}}get isAnimationEnabled(){const e=this.grid?.effectiveConfig?.animation?.mode??"reduced-motion";if(!1===e||"off"===e)return!1;if(!0===e||"on"===e)return!0;const t=this.gridElement;if(t){return"0"!==getComputedStyle(t).getPropertyValue("--tbw-animation-enabled").trim()}return!0}get animationDuration(){const e=this.gridElement;if(e){const t=getComputedStyle(e).getPropertyValue("--tbw-animation-duration").trim(),o=parseInt(t,10);if(!isNaN(o))return o}return 200}setIcon(e,t,o){e.dataset.icon=t.replace(/([A-Z])/g,"-$1").toLowerCase(),"collapse"===t?e.dataset.expanded="":"expand"===t&&delete e.dataset.expanded;const r=this.#t(t,o);void 0!==r?"string"==typeof r?e.innerHTML=n(r):r instanceof HTMLElement&&(e.innerHTML="",e.appendChild(r.cloneNode(!0))):e.innerHTML=""}#t(e,t){return void 0!==t?t:this.grid?.gridConfig?.icons?.[e]}updateSortIndicator(e,t){e.querySelector('[part~="sort-indicator"], .sort-indicator')?.remove();const o=document.createElement("span");o.setAttribute("part","sort-indicator"),o.className="sort-indicator",t?(e.setAttribute("aria-sort","asc"===t?"ascending":"descending"),e.setAttribute("data-sort",t),this.setIcon(o,"asc"===t?"sortAsc":"sortDesc")):(e.setAttribute("aria-sort","none"),e.removeAttribute("data-sort"),this.setIcon(o,"sortNone"));const r=e.querySelector(".tbw-filter-btn")??e.querySelector(".resize-handle");return r?e.insertBefore(o,r):e.appendChild(o),o}warn(o,r){void 0!==r?console.warn(t(o,r,this.gridElement.id,this.name)):console.warn(`${e(this.gridElement.id,this.name)} ${o}`)}throwDiagnostic(e,o){throw new Error(t(e,o,this.gridElement.id,this.name))}}function d(e,t){return Math.floor(e/t)}async function u(e,t,o,r){const s=function(e,t){return{start:e*t,end:(e+1)*t}}(t,o);return e.getRows({startRow:s.start,endRow:s.end,sortModel:r.sortModel,filterModel:r.filterModel})}function h(e,t,o){const r=d(e,t),s=o.get(r);if(!s)return;return s[e%t]}class g extends c{static manifest={incompatibleWith:[{name:"tree",reason:"TreePlugin requires the full hierarchy to flatten and manage expansion state. ServerSidePlugin lazy-loads rows in blocks and cannot provide nested children on demand. Server-side tree would require lazy child loading as nodes expand."},{name:"pivot",reason:"PivotPlugin requires the full dataset to compute aggregations. ServerSidePlugin lazy-loads rows in blocks, so pivot aggregation cannot be performed client-side."}]};name="serverSide";get defaultConfig(){return{pageSize:100,cacheBlockSize:100,maxConcurrentRequests:2}}dataSource=null;totalRowCount=0;loadedBlocks=/* @__PURE__ */new Map;loadingBlocks=/* @__PURE__ */new Set;lastRequestId=0;scrollDebounceTimer;managedRows=[];detach(){this.dataSource=null,this.totalRowCount=0,this.loadedBlocks.clear(),this.loadingBlocks.clear(),this.managedRows=[],this.lastRequestId=0,this.scrollDebounceTimer&&(clearTimeout(this.scrollDebounceTimer),this.scrollDebounceTimer=void 0)}loadRequiredBlocks(){if(!this.dataSource)return;const e=this.grid,t=this.config.cacheBlockSize??100,o={startRow:e._virtualization.start,endRow:e._virtualization.end},r=function(e,t,o){const r=d(e,o),s=d(t-1,o),i=[];for(let n=r;n<=s;n++)i.push(n);return i}(o.startRow,o.endRow,t);for(const s of r)if(!this.loadedBlocks.has(s)&&!this.loadingBlocks.has(s)){if(this.loadingBlocks.size>=(this.config.maxConcurrentRequests??2))break;this.loadingBlocks.add(s),u(this.dataSource,s,t,{}).then(e=>{this.loadedBlocks.set(s,e.rows),this.totalRowCount=e.totalRowCount,this.loadingBlocks.delete(s);const o=s*t;for(let t=0;t<e.rows.length;t++)o+t<this.managedRows.length&&(this.managedRows[o+t]=e.rows[t]);this.requestVirtualRefresh(),this.loadRequiredBlocks()}).catch(()=>{this.loadingBlocks.delete(s)})}}processRows(e){if(!this.dataSource)return[...e];const t=this.config.cacheBlockSize??100;for(;this.managedRows.length<this.totalRowCount;){const e=this.managedRows.length;this.managedRows.push({__loading:!0,__index:e})}this.managedRows.length=this.totalRowCount;for(let o=0;o<this.totalRowCount;o++){const e=h(o,t,this.loadedBlocks);e&&(this.managedRows[o]=e)}return this.managedRows}onScroll(e){this.dataSource&&(this.loadRequiredBlocks(),this.scrollDebounceTimer&&clearTimeout(this.scrollDebounceTimer),this.scrollDebounceTimer=setTimeout(()=>{this.loadRequiredBlocks()},100))}setDataSource(e){this.dataSource=e,this.loadedBlocks.clear(),this.loadingBlocks.clear(),this.managedRows=[];u(e,0,this.config.cacheBlockSize??100,{}).then(e=>{this.loadedBlocks.set(0,e.rows),this.totalRowCount=e.totalRowCount,this.requestRender()})}refresh(){this.dataSource&&(this.loadedBlocks.clear(),this.loadingBlocks.clear(),this.managedRows=[],this.requestRender())}purgeCache(){this.loadedBlocks.clear(),this.managedRows=[]}getTotalRowCount(){return this.totalRowCount}isRowLoaded(e){const t=d(e,this.config.cacheBlockSize??100);return this.loadedBlocks.has(t)}getLoadedBlockCount(){return this.loadedBlocks.size}}export{g as ServerSidePlugin};
+function t(t,e){return`[tbw-grid${t?`#${t}`:""}${e?`:${e}`:""}]`}const e="TBW140";function o(e,o,r,s){return`${t(r,s)} ${e}: ${o}\n\n  → More info: ${function(t){return`https://toolboxjs.com/grid/errors#${t.toLowerCase()}`}(e)}`}function r(t,e,r,s){console.debug(o(t,e,r,s))}function s(t,e,r,s){console.error(o(t,e,r,s))}["__otorp__","__retteGenifed__","__retteSenifed__","rotcurtsnoc","wodniw","sihTlabolg","labolg","ssecorp","noitcnuF","tropmi","lave","tcelfeR","yxorP","rorrE","stnemugra","tnemucod","noitacol","eikooc","egarotSlacol","egarotSnoisses","BDdexedni","hctef","tseuqeRpttHLMX","tekcoSbeW","rekroW","rekroWderahS","rekroWecivreS","renepo","tnerap","pot","semarf","fles"].map(t=>t.split("").reverse().join(""));const i=/* @__PURE__ */new Set(["script","iframe","object","embed","form","input","button","textarea","select","link","meta","base","style","template","slot","portal","frame","frameset","applet","noscript","noembed","plaintext","xmp","listing"]),n=/^on\w+$/i,a=/* @__PURE__ */new Set(["href","src","action","formaction","data","srcdoc","xlink:href","poster","srcset"]),d=/^\s*(javascript|vbscript|data|blob):/i;function c(t){if(!t||"string"!=typeof t)return"";if(-1===t.indexOf("<"))return t;const e=document.createElement("template");return e.innerHTML=t,function(t){const e=[],o=t.querySelectorAll("*");for(const r of o){const t=r.tagName.toLowerCase();if(i.has(t)){e.push(r);continue}if("svg"===t||"http://www.w3.org/2000/svg"===r.namespaceURI){if(Array.from(r.attributes).some(t=>n.test(t.name)||"href"===t.name||"xlink:href"===t.name)){e.push(r);continue}}const o=[];for(const e of r.attributes){const t=e.name.toLowerCase();n.test(t)?o.push(e.name):(a.has(t)&&d.test(e.value)||"style"===t&&/expression\s*\(|javascript:|behavior\s*:/i.test(e.value))&&o.push(e.name)}o.forEach(t=>r.removeAttribute(t))}e.forEach(t=>t.remove())}(e.content),e.innerHTML}const l='<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>',u={expand:"▶",collapse:"▼",sortAsc:"▲",sortDesc:"▼",sortNone:"⇅",submenuArrow:"▶",dragHandle:"⋮⋮",toolPanel:"☰",filter:l,filterActive:l,print:"🖨️"};class h{static dependencies;static manifest;aliases;version="undefined"!=typeof __GRID_VERSION__?__GRID_VERSION__:"dev";styles;cellRenderers;headerRenderers;cellEditors;grid;config;userConfig;#t;get defaultConfig(){return{}}constructor(t={}){this.userConfig=t}attach(t){this.#t?.abort(),this.#t=new AbortController,this.grid=t,this.config={...this.defaultConfig,...this.userConfig}}detach(){this.#t?.abort(),this.#t=void 0}getPlugin(t){return this.grid?.getPlugin(t)}emit(t,e){this.grid?.dispatchEvent?.(new CustomEvent(t,{detail:e,bubbles:!0}))}emitCancelable(t,e){const o=new CustomEvent(t,{detail:e,bubbles:!0,cancelable:!0});return this.grid?.dispatchEvent?.(o),o.defaultPrevented}on(t,e){this.grid?._pluginManager?.subscribe(this,t,e)}off(t){this.grid?._pluginManager?.unsubscribe(this,t)}emitPluginEvent(t,e){this.grid?._pluginManager?.emitPluginEvent(t,e)}broadcast(t,e){this.emitPluginEvent(t,e),this.emit(t,e)}requestRender(){this.grid?.requestRender?.()}requestColumnsRender(){this.grid?.requestColumnsRender?.()}requestRenderWithFocus(){this.grid?.requestRenderWithFocus?.()}requestAfterRender(){this.grid?.requestAfterRender?.()}requestVirtualRefresh(){this.grid?.requestVirtualRefresh?.()}get rows(){return this.grid?.rows??[]}get sourceRows(){return this.grid?.sourceRows??[]}get columns(){return this.grid?.columns??[]}get visibleColumns(){return this.grid?._visibleColumns??[]}get gridElement(){return this.grid?._hostElement}get disconnectSignal(){return this.#t?.signal??this.grid?.disconnectSignal}get gridIcons(){const t=this.grid?.gridConfig?.icons??{};return{...u,...t}}get isAnimationEnabled(){const t=this.grid?.effectiveConfig?.animation?.mode??"reduced-motion";if(!1===t||"off"===t)return!1;if(!0===t||"on"===t)return!0;const e=this.gridElement;if(e){return"0"!==getComputedStyle(e).getPropertyValue("--tbw-animation-enabled").trim()}return!0}get animationDuration(){const t=this.gridElement;if(t){const e=getComputedStyle(t).getPropertyValue("--tbw-animation-duration").trim(),o=parseInt(e,10);if(!isNaN(o))return o}return 200}setIcon(t,e,o){t.dataset.icon=e.replace(/([A-Z])/g,"-$1").toLowerCase(),"collapse"===e?t.dataset.expanded="":"expand"===e&&delete t.dataset.expanded;const r=this.#e(e,o);void 0!==r?"string"==typeof r?t.innerHTML=c(r):r instanceof HTMLElement&&(t.innerHTML="",t.appendChild(r.cloneNode(!0))):t.innerHTML=""}#e(t,e){return void 0!==e?e:this.grid?.gridConfig?.icons?.[t]}updateSortIndicator(t,e){t.querySelector('[part~="sort-indicator"], .sort-indicator')?.remove();const o=document.createElement("span");o.setAttribute("part","sort-indicator"),o.className="sort-indicator",e?(t.setAttribute("aria-sort","asc"===e?"ascending":"descending"),t.setAttribute("data-sort",e),this.setIcon(o,"asc"===e?"sortAsc":"sortDesc")):(t.setAttribute("aria-sort","none"),t.removeAttribute("data-sort"),this.setIcon(o,"sortNone"));const r=t.querySelector(".tbw-filter-btn")??t.querySelector(".resize-handle");return r?t.insertBefore(o,r):t.appendChild(o),o}warn(e,r){void 0!==r?console.warn(o(e,r,this.gridElement.id,this.name)):console.warn(`${t(this.gridElement.id,this.name)} ${e}`)}throwDiagnostic(t,e){throw new Error(o(t,e,this.gridElement.id,this.name))}}function g(t,e){return Math.floor(t/e)}async function f(t,e,o,r){const s=function(t,e){return{start:t*e,end:(t+1)*e}}(e,o);return t.getRows({startNode:s.start,endNode:s.end,sortModel:r.sortModel,filterModel:r.filterModel})}function m(t,e,o){const r=g(t,e),s=o.get(r);if(!s)return;return s[t%e]}class p extends h{static manifest={modifiesRowStructure:!0,hookPriority:{processRows:-10},incompatibleWith:[{name:"pivot",reason:"PivotPlugin requires the full dataset to compute aggregations. ServerSidePlugin lazy-loads rows in blocks, so pivot aggregation cannot be performed client-side."}],events:[{type:"datasource:data",description:"Root data page/block loaded"},{type:"datasource:children",description:"Child data loaded for a parent context"},{type:"datasource:loading",description:"Loading state changed"},{type:"datasource:error",description:"Fetch operation failed"}],queries:[{type:"datasource:fetch-children",description:"Request child rows for a parent context"},{type:"datasource:is-active",description:"Check if ServerSide plugin has an active data source"}]};name="serverSide";get defaultConfig(){return{pageSize:100,cacheBlockSize:100,maxConcurrentRequests:2}}dataSource=null;totalNodeCount=0;loadedBlocks=/* @__PURE__ */new Map;loadingBlocks=/* @__PURE__ */new Set;lastRequestId=0;scrollDebounceTimer;managedNodes=[];attach(t){super.attach(t),this.on("sort-change",()=>this.onModelChange()),this.on("filter-change",()=>this.onModelChange())}detach(){this.dataSource=null,this.totalNodeCount=0,this.loadedBlocks.clear(),this.loadingBlocks.clear(),this.managedNodes=[],this.lastRequestId=0,this.scrollDebounceTimer&&(clearTimeout(this.scrollDebounceTimer),this.scrollDebounceTimer=void 0)}getEnrichmentParams(){const t=this.grid?.query?.("sort:get-model",null),e=this.grid?.query?.("filter:get-model",null);return{sortModel:t?.[0],filterModel:e?.[0]}}getViewportMapping(t,e){const o={viewportStart:t,viewportEnd:e},r=this.grid?.query?.("datasource:viewport-mapping",o);return r?.[0]?r[0]:{startNode:t,endNode:e,totalLoadedNodes:this.totalNodeCount}}onModelChange(){this.dataSource&&(this.loadedBlocks.clear(),this.loadingBlocks.clear(),this.managedNodes=[],this.totalNodeCount=0,this.requestRender())}loadRequiredBlocks(){if(!this.dataSource)return;const t=this.grid,o=this.config.cacheBlockSize??100,i=this.getViewportMapping(t._virtualization.start,t._virtualization.end),n=function(t,e,o){const r=g(t,o),s=g(e-1,o),i=[];for(let n=r;n<=s;n++)i.push(n);return i}(i.startNode,i.endNode,o),a=this.getEnrichmentParams(),d=this.grid?.getAttribute?.("id")??void 0;for(const c of n)if(!this.loadedBlocks.has(c)&&!this.loadingBlocks.has(c)){if(this.loadingBlocks.size>=(this.config.maxConcurrentRequests??2)){r("TBW143","Concurrent request limit reached, deferring block load",d);break}this.loadingBlocks.add(c),this.broadcast("datasource:loading",{loading:!0}),f(this.dataSource,c,o,a).then(t=>{this.loadedBlocks.set(c,t.rows),this.totalNodeCount=t.totalNodeCount,this.loadingBlocks.delete(c);const e=c*o;for(let o=0;o<t.rows.length;o++)e+o<this.managedNodes.length&&(this.managedNodes[e+o]=t.rows[o]);const r={rows:t.rows,totalNodeCount:t.totalNodeCount,startNode:e,endNode:e+t.rows.length,claimed:!1};this.broadcast("datasource:data",r),0===this.loadingBlocks.size&&this.broadcast("datasource:loading",{loading:!1}),this.requestVirtualRefresh(),this.loadRequiredBlocks()}).catch(t=>{this.loadingBlocks.delete(c);const o=t instanceof Error?t:new Error(String(t));s(e,`getRows() failed: ${o.message}`,d),this.broadcast("datasource:error",{error:o}),0===this.loadingBlocks.size&&this.broadcast("datasource:loading",{loading:!1})})}}processRows(t){if(!this.dataSource)return[...t];const e=this.config.cacheBlockSize??100,o=Number.isFinite(this.totalNodeCount)&&this.totalNodeCount>=0?this.totalNodeCount:0;for(;this.managedNodes.length<o;){const t=this.managedNodes.length;this.managedNodes.push({__loading:!0,__index:t})}this.managedNodes.length=o;for(let r=0;r<o;r++){const t=m(r,e,this.loadedBlocks);t&&(this.managedNodes[r]=t)}return this.managedNodes}onScroll(t){this.dataSource&&(this.loadRequiredBlocks(),this.scrollDebounceTimer&&clearTimeout(this.scrollDebounceTimer),this.scrollDebounceTimer=setTimeout(()=>{this.loadRequiredBlocks()},100))}handleQuery(t){switch(t.type){case"datasource:is-active":return null!=this.dataSource;case"datasource:fetch-children":{const{context:e}=t.context;return void this.fetchChildren(e)}}}fetchChildren(t){if(!this.dataSource)return;const e=this.grid?.getAttribute?.("id")??void 0;if(!this.dataSource.getChildRows)return void function(t,e,r,s){console.warn(o(t,e,r,s))}("TBW142",`Plugin "${t.source}" requested child rows but getChildRows() is not implemented on the dataSource`,e);const r=this.getEnrichmentParams();this.broadcast("datasource:loading",{loading:!0,context:t}),this.dataSource.getChildRows({context:t,sortModel:r.sortModel,filterModel:r.filterModel}).then(e=>{const o={rows:e.rows,context:t,claimed:!1};this.broadcast("datasource:children",o),this.broadcast("datasource:loading",{loading:!1,context:t})}).catch(o=>{const r=o instanceof Error?o:new Error(String(o));s("TBW141",`getChildRows() failed: ${r.message}`,e),this.broadcast("datasource:error",{error:r,context:t}),this.broadcast("datasource:loading",{loading:!1,context:t})})}setDataSource(t){this.dataSource=t,this.loadedBlocks.clear(),this.loadingBlocks.clear(),this.managedNodes=[],this.totalNodeCount=0;const o=this.config.cacheBlockSize??100,r=this.getEnrichmentParams(),i=this.grid?.getAttribute?.("id")??void 0;this.broadcast("datasource:loading",{loading:!0}),f(t,0,o,r).then(t=>{this.loadedBlocks.set(0,t.rows),this.totalNodeCount=t.totalNodeCount;const e={rows:t.rows,totalNodeCount:t.totalNodeCount,startNode:0,endNode:t.rows.length,claimed:!1};this.broadcast("datasource:data",e),this.broadcast("datasource:loading",{loading:!1}),this.requestRender()}).catch(t=>{const o=t instanceof Error?t:new Error(String(t));s(e,`getRows() failed: ${o.message}`,i),this.broadcast("datasource:error",{error:o}),this.broadcast("datasource:loading",{loading:!1})})}refresh(){if(!this.dataSource)return;const t=this.dataSource;this.loadedBlocks.clear(),this.loadingBlocks.clear(),this.managedNodes=[],this.totalNodeCount=0,this.setDataSource(t)}purgeCache(){this.loadedBlocks.clear(),this.managedNodes=[]}getTotalNodeCount(){return this.totalNodeCount}getTotalRowCount(){return this.totalNodeCount}isNodeLoaded(t){const e=g(t,this.config.cacheBlockSize??100);return this.loadedBlocks.has(e)}isRowLoaded(t){return this.isNodeLoaded(t)}getLoadedBlockCount(){return this.loadedBlocks.size}}export{p as ServerSidePlugin};
 //# sourceMappingURL=index.js.map