@toolbox-web/grid 1.25.1 → 1.25.2

package/lib/core/grid.d.ts

@@ -228,6 +228,14 @@ export declare class DataGridElement<T = any> extends HTMLElement implements Int
      *
      * @param rowId - The row's unique identifier (from getRowId)
      * @param loading - Whether the row is loading
+     *
+     * @example
+     * ```typescript
+     * // Show loading while saving row data
+     * grid.setRowLoading('row-123', true);
+     * await saveRow(rowData);
+     * grid.setRowLoading('row-123', false);
+     * ```
      */
     setRowLoading(rowId: string, loading: boolean): void;
     /**
@@ -237,6 +245,14 @@ export declare class DataGridElement<T = any> extends HTMLElement implements Int
      * @param rowId - The row's unique identifier
      * @param field - The column field
      * @param loading - Whether the cell is loading
+     *
+     * @example
+     * ```typescript
+     * // Show loading while validating a single field
+     * grid.setCellLoading('row-123', 'email', true);
+     * const valid = await validateEmail(newValue);
+     * grid.setCellLoading('row-123', 'email', false);
+     * ```
      */
     setCellLoading(rowId: string, field: string, loading: boolean): void;
     /**
@@ -687,7 +703,7 @@ export declare class DataGridElement<T = any> extends HTMLElement implements Int
      *
      * @example
      * ```typescript
-     * const grid = document.querySelector('tbw-grid');
+     * const grid = queryGrid('tbw-grid');
      * await grid.ready();
      * console.log('Grid is ready, rows:', grid.rows.length);
      * ```
@@ -1179,7 +1195,7 @@ export declare class DataGridElement<T = any> extends HTMLElement implements Int
      * @example
      * ```typescript
      * // Restore saved state on page load
-     * const grid = document.querySelector('tbw-grid');
+     * const grid = queryGrid('tbw-grid');
      * const saved = localStorage.getItem('myGridState');
      * if (saved) {
      *   grid.columnState = JSON.parse(saved);

package/lib/core/internal/diagnostics.d.ts

@@ -0,0 +1,164 @@
+/**
+ * Centralized diagnostic messages for @toolbox-web/grid.
+ *
+ * Every user-facing warning, error, or info message in the grid has a unique
+ * diagnostic code (e.g. `TBW001`). Each code maps to a section on the online
+ * troubleshooting page, giving developers a direct link to resolution steps.
+ *
+ * ## Usage
+ *
+ * ```ts
+ * import { MISSING_BREAKPOINT, warnDiagnostic, throwDiagnostic } from './diagnostics';
+ *
+ * // Warn with a code
+ * warnDiagnostic(MISSING_BREAKPOINT, 'Set a breakpoint...', gridId);
+ *
+ * // Throw with a code
+ * throwDiagnostic(MISSING_ROW_ID, 'Configure getRowId...', gridId);
+ * ```
+ *
+ * Plugins should prefer `this.warn(MISSING_BREAKPOINT, message)` via BaseGridPlugin
+ * instead of importing this module directly.
+ *
+ * @internal
+ */
+/**
+ * Build the `[tbw-grid]` or `[tbw-grid#my-id]` log prefix.
+ * Pass `pluginName` for a scoped prefix like `[tbw-grid:SelectionPlugin]`.
+ */
+export declare function gridPrefix(gridId?: string, pluginName?: string): string;
+/**
+ * Diagnostic codes used across the grid library.
+ *
+ * Each code is an individual export so that unused codes are tree-shaken
+ * from bundles that don't reference them (esbuild can't tree-shake
+ * properties from a single object).
+ *
+ * Naming: TBW + 3-digit number.
+ * Ranges:
+ *   001–019  Configuration validation (missing plugins, bad config)
+ *   020–029  Plugin lifecycle (dependencies, incompatibilities, deprecation)
+ *   030–039  Feature registry
+ *   040–049  Row operations (row ID, row mutations)
+ *   050–059  Column operations (width, template)
+ *   060–069  Rendering (callbacks, formatters, external views)
+ *   070–079  Shell (tool panels, header/toolbar content)
+ *   080–089  Editing & editors
+ *   090–099  Print
+ *   100–109  Clipboard
+ *   110–119  Plugin-specific (responsive, undo-redo, grouping-columns)
+ *   120–129  Style injection
+ *   130–139  Attribute parsing
+ */
+/** Column uses a plugin-owned property but the plugin is not loaded. */
+export declare const MISSING_PLUGIN: "TBW001";
+/** Grid config uses a plugin-owned property but the plugin is not loaded. */
+export declare const MISSING_PLUGIN_CONFIG: "TBW002";
+/** Plugin config rule violation (error severity). */
+export declare const CONFIG_RULE_ERROR: "TBW003";
+/** Plugin config rule violation (warning severity). */
+export declare const CONFIG_RULE_WARN: "TBW004";
+/** Required plugin dependency is missing. */
+export declare const MISSING_DEPENDENCY: "TBW020";
+/** Optional plugin dependency is missing. */
+export declare const OPTIONAL_DEPENDENCY: "TBW021";
+/** Two loaded plugins are incompatible. */
+export declare const INCOMPATIBLE_PLUGINS: "TBW022";
+/** Plugin uses deprecated hooks. */
+export declare const DEPRECATED_HOOK: "TBW023";
+/** Error thrown inside a plugin event handler. */
+export declare const PLUGIN_EVENT_ERROR: "TBW024";
+/** Feature was re-registered (overwritten). */
+export declare const FEATURE_REREGISTERED: "TBW030";
+/** Feature configured but not imported. */
+export declare const FEATURE_NOT_IMPORTED: "TBW031";
+/** Feature depends on another feature that is not enabled. */
+export declare const FEATURE_MISSING_DEP: "TBW032";
+/** Cannot determine row ID (no getRowId and no id property). */
+export declare const MISSING_ROW_ID: "TBW040";
+/** Row with given ID not found. */
+export declare const ROW_NOT_FOUND: "TBW041";
+/** Column has an invalid CSS width value. */
+export declare const INVALID_COLUMN_WIDTH: "TBW050";
+/** rowClass callback threw an error. */
+export declare const ROW_CLASS_ERROR: "TBW060";
+/** cellClass callback threw an error. */
+export declare const CELL_CLASS_ERROR: "TBW061";
+/** Column format function threw an error. */
+export declare const FORMAT_ERROR: "TBW062";
+/** External view mount() threw an error. */
+export declare const VIEW_MOUNT_ERROR: "TBW063";
+/** External view event dispatch error. */
+export declare const VIEW_DISPATCH_ERROR: "TBW064";
+/** Tool panel missing required id or title. */
+export declare const TOOL_PANEL_MISSING_ATTR: "TBW070";
+/** No tool panels registered. */
+export declare const NO_TOOL_PANELS: "TBW071";
+/** Tool panel section not found. */
+export declare const TOOL_PANEL_NOT_FOUND: "TBW072";
+/** Tool panel already registered. */
+export declare const TOOL_PANEL_DUPLICATE: "TBW073";
+/** Header content already registered. */
+export declare const HEADER_CONTENT_DUPLICATE: "TBW074";
+/** Toolbar content already registered. */
+export declare const TOOLBAR_CONTENT_DUPLICATE: "TBW075";
+/** External editor mount() threw an error. */
+export declare const EDITOR_MOUNT_ERROR: "TBW080";
+/** Print already in progress. */
+export declare const PRINT_IN_PROGRESS: "TBW090";
+/** Grid not available for printing. */
+export declare const PRINT_NO_GRID: "TBW091";
+/** Print operation failed. */
+export declare const PRINT_FAILED: "TBW092";
+/** Multiple elements share the same grid ID (print isolation issue). */
+export declare const PRINT_DUPLICATE_ID: "TBW093";
+/** Clipboard API write failed. */
+export declare const CLIPBOARD_FAILED: "TBW100";
+/** ResponsivePlugin: no breakpoint configured. */
+export declare const MISSING_BREAKPOINT: "TBW110";
+/** UndoRedoPlugin: transaction already in progress. */
+export declare const TRANSACTION_IN_PROGRESS: "TBW111";
+/** UndoRedoPlugin: no transaction in progress. */
+export declare const NO_TRANSACTION: "TBW112";
+/** GroupingColumnsPlugin: missing id or header on column group definition. */
+export declare const COLUMN_GROUP_NO_ID: "TBW113";
+/** GroupingColumnsPlugin: conflicting columnGroups sources. */
+export declare const COLUMN_GROUPS_CONFLICT: "TBW114";
+/** Failed to extract grid.css from document stylesheets. */
+export declare const STYLE_EXTRACT_FAILED: "TBW120";
+/** Could not find grid.css in document.styleSheets. */
+export declare const STYLE_NOT_FOUND: "TBW121";
+/** Invalid JSON in an HTML attribute. */
+export declare const INVALID_ATTRIBUTE_JSON: "TBW130";
+export type DiagnosticCode = typeof MISSING_PLUGIN | typeof MISSING_PLUGIN_CONFIG | typeof CONFIG_RULE_ERROR | typeof CONFIG_RULE_WARN | typeof MISSING_DEPENDENCY | typeof OPTIONAL_DEPENDENCY | typeof INCOMPATIBLE_PLUGINS | typeof DEPRECATED_HOOK | typeof PLUGIN_EVENT_ERROR | typeof FEATURE_REREGISTERED | typeof FEATURE_NOT_IMPORTED | typeof FEATURE_MISSING_DEP | typeof MISSING_ROW_ID | typeof ROW_NOT_FOUND | typeof INVALID_COLUMN_WIDTH | typeof ROW_CLASS_ERROR | typeof CELL_CLASS_ERROR | typeof FORMAT_ERROR | typeof VIEW_MOUNT_ERROR | typeof VIEW_DISPATCH_ERROR | typeof TOOL_PANEL_MISSING_ATTR | typeof NO_TOOL_PANELS | typeof TOOL_PANEL_NOT_FOUND | typeof TOOL_PANEL_DUPLICATE | typeof HEADER_CONTENT_DUPLICATE | typeof TOOLBAR_CONTENT_DUPLICATE | typeof EDITOR_MOUNT_ERROR | typeof PRINT_IN_PROGRESS | typeof PRINT_NO_GRID | typeof PRINT_FAILED | typeof PRINT_DUPLICATE_ID | typeof CLIPBOARD_FAILED | typeof MISSING_BREAKPOINT | typeof TRANSACTION_IN_PROGRESS | typeof NO_TRANSACTION | typeof COLUMN_GROUP_NO_ID | typeof COLUMN_GROUPS_CONFLICT | typeof STYLE_EXTRACT_FAILED | typeof STYLE_NOT_FOUND | typeof INVALID_ATTRIBUTE_JSON;
+/**
+ * Format a diagnostic message with prefix, code, and docs link.
+ *
+ * Output format:
+ * ```
+ * [tbw-grid#my-id] TBW001: Your message here.
+ *
+ *   → More info: https://toolboxjs.com/grid/errors#tbw001
+ * ```
+ */
+export declare function formatDiagnostic(code: DiagnosticCode, message: string, gridId?: string, pluginName?: string): string;
+/**
+ * Throw an error with a diagnostic code and docs link.
+ * Use for configuration errors and API misuse that should halt execution.
+ */
+export declare function throwDiagnostic(code: DiagnosticCode, message: string, gridId?: string, pluginName?: string): never;
+/**
+ * Log a warning with a diagnostic code and docs link.
+ * Use for recoverable issues the developer should fix.
+ */
+export declare function warnDiagnostic(code: DiagnosticCode, message: string, gridId?: string, pluginName?: string): void;
+/**
+ * Log an info message with a diagnostic code and docs link.
+ * Use for optional/soft dependency notifications.
+ */
+export declare function infoDiagnostic(code: DiagnosticCode, message: string, gridId?: string, pluginName?: string): void;
+/**
+ * Log an error with a diagnostic code and docs link.
+ * Use for non-throwing errors (e.g., failed async operations).
+ */
+export declare function errorDiagnostic(code: DiagnosticCode, message: string, gridId?: string, pluginName?: string): void;

package/lib/core/internal/sorting.d.ts

@@ -1,12 +1,61 @@
 import { ColumnConfig, GridHost, InternalGrid, SortState } from '../types';
 /**
- * Default comparator for sorting values.
- * Handles nulls (pushed to end), numbers, and string fallback.
+ * Default comparator used when no column-level `sortComparator` is configured.
+ * Pushes `null`/`undefined` to the end and compares remaining values via `>` / `<`
+ * operators, which works correctly for numbers and falls back to lexicographic
+ * comparison for strings.
+ *
+ * Use this as a fallback inside a custom `sortComparator` when you only need
+ * special handling for certain values:
+ *
+ * @example
+ * ```typescript
+ * import { defaultComparator } from '@toolbox-web/grid';
+ *
+ * const column = {
+ *   field: 'priority',
+ *   sortComparator: (a, b, rowA, rowB) => {
+ *     // Pin "urgent" to the top, then fall back to default ordering
+ *     if (a === 'urgent') return -1;
+ *     if (b === 'urgent') return 1;
+ *     return defaultComparator(a, b);
+ *   },
+ * };
+ * ```
+ *
+ * @see {@link BaseColumnConfig.sortComparator} for column-level comparators
+ * @see {@link builtInSort} for the full sort handler that uses this comparator
+ * @category Factory Functions
  */
 export declare function defaultComparator(a: unknown, b: unknown): number;
 /**
- * Built-in sort implementation using column comparator or default.
- * This is the default sortHandler when none is configured.
+ * The default `sortHandler` used when none is provided in {@link GridConfig.sortHandler}.
+ * Reads each column's `sortComparator` (falling back to {@link defaultComparator})
+ * and returns a sorted copy of the rows array.
+ *
+ * Use this as a fallback inside a custom `sortHandler` when you only need to
+ * intercept sorting for specific columns or add pre/post-processing:
+ *
+ * @example
+ * ```typescript
+ * import { builtInSort } from '@toolbox-web/grid';
+ * import type { SortHandler } from '@toolbox-web/grid';
+ *
+ * const customSort: SortHandler<Employee> = (rows, state, columns) => {
+ *   // Server-side sort for the "salary" column, client-side for everything else
+ *   if (state.field === 'salary') {
+ *     return fetch(`/api/employees?sort=${state.field}&dir=${state.direction}`)
+ *       .then(res => res.json());
+ *   }
+ *   return builtInSort(rows, state, columns);
+ * };
+ *
+ * grid.gridConfig = { sortHandler: customSort };
+ * ```
+ *
+ * @see {@link GridConfig.sortHandler} for configuring the handler
+ * @see {@link defaultComparator} for the comparator used per column
+ * @category Factory Functions
  */
 export declare function builtInSort<T>(rows: T[], sortState: SortState, columns: ColumnConfig<T>[]): T[];
 /**

package/lib/core/internal/utils.d.ts

@@ -4,14 +4,6 @@
  * Used to show warnings only in development.
  */
 export declare function isDevelopment(): boolean;
-/**
- * Build the `[tbw-grid]` or `[tbw-grid#my-id]` log prefix.
- * Pass `pluginName` for a scoped prefix like `[tbw-grid:SelectionPlugin]`.
- *
- * @param gridId - The grid element's `id` attribute (optional)
- * @param pluginName - Plugin display name to include (optional)
- */
-export declare function gridPrefix(gridId?: string, pluginName?: string): string;
 /**
  * Generate accessible HTML for a boolean cell.
  * Uses role="checkbox" with proper aria attributes.

package/lib/core/plugin/base-plugin.d.ts

@@ -1,7 +1,8 @@
+import { DiagnosticCode } from '../internal/diagnostics';
 import { ColumnConfig, ColumnState, GridPlugin, HeaderContentDefinition, IconValue, PluginNameMap, ToolPanelDefinition, DEFAULT_GRID_ICONS } from '../types';
 import { AfterCellRenderContext, AfterRowRenderContext, CellClickEvent, CellEditor, CellMouseEvent, CellRenderer, GridElementRef, HeaderClickEvent, HeaderRenderer, PluginQuery, RowClickEvent, ScrollEvent } from './types';
 export { PLUGIN_QUERIES } from './types';
-export type { AfterCellRenderContext, AfterRowRenderContext, CellClickEvent, CellCoords, CellEditor, CellMouseEvent, CellRenderer, ContextMenuItem, ContextMenuParams, GridElementRef, HeaderClickEvent, HeaderRenderer, KeyboardModifiers, PluginCellRenderContext, PluginQuery, RowClickEvent, ScrollEvent } from './types';
+export type { AfterCellRenderContext, AfterRowRenderContext, CellClickEvent, CellCoords, CellEditor, CellMouseEvent, CellRenderer, ContextMenuItem, ContextMenuParams, GridElementRef, HeaderClickEvent, HeaderRenderer, KeyboardModifiers, PluginCellRenderContext, PluginQuery, RowClickEvent, ScrollEvent, } from './types';
 /**
  * Grid element interface for plugins.
  * Extends GridElementRef with plugin-specific methods.
@@ -622,9 +623,24 @@ export declare abstract class BaseGridPlugin<TConfig = unknown> implements GridP
      */
     protected setIcon(element: HTMLElement, icon: IconValue): void;
     /**
-     * Log a warning message.
+     * Log a warning with an optional diagnostic code.
+     *
+     * When a diagnostic code is provided, the message is formatted with the code
+     * and a link to the troubleshooting docs.
+     *
+     * @example
+     * ```ts
+     * this.warn('Something went wrong');                          // plain
+     * this.warn(MISSING_BREAKPOINT, 'Set a breakpoint'); // with code + docs link
+     * ```
      */
     protected warn(message: string): void;
+    protected warn(code: DiagnosticCode, message: string): void;
+    /**
+     * Throw an error with a diagnostic code and docs link.
+     * Use for configuration errors and API misuse that should halt execution.
+     */
+    protected throwDiagnostic(code: DiagnosticCode, message: string): never;
     /**
      * Transform rows before rendering.
      * Called during each render cycle before rows are rendered to the DOM.

package/lib/core/plugin/plugin-manager.d.ts

@@ -7,6 +7,7 @@ import { AfterCellRenderContext, AfterRowRenderContext, BaseGridPlugin, CellClic
  * Place plugins in the order you want their hooks to execute.
  */
 export declare class PluginManager {
+    #private;
     private grid;
     /** Plugin instances in order of attachment */
     private plugins;
@@ -20,6 +21,9 @@ export declare class PluginManager {
     private headerRenderers;
     /** Cell editors registered by plugins */
     private cellEditors;
+    /** Cached hook presence flags — invalidated on plugin attach/detach */
+    private _hasAfterCellRender;
+    private _hasAfterRowRender;
     /**
      * Event listeners indexed by event type.
      * Maps event type → Map<plugin instance → callback>.
@@ -35,8 +39,6 @@ export declare class PluginManager {
     /** Set of plugin constructors that have been warned about deprecated hooks */
     private static deprecationWarned;
     constructor(grid: GridElement);
-    /** Build log prefix: `[tbw-grid]` or `[tbw-grid#my-id]` */
-    private get logPrefix();
     /**
      * Attach all plugins from the config.
      */
@@ -129,7 +131,7 @@ export declare class PluginManager {
     afterCellRender(context: AfterCellRenderContext): void;
     /**
      * Check if any plugin has the afterCellRender hook implemented.
-     * Used to skip the hook call overhead when no plugins need it.
+     * Cached — invalidated on plugin attach/detach.
      */
     hasAfterCellRenderHook(): boolean;
     /**
@@ -141,7 +143,7 @@ export declare class PluginManager {
     afterRowRender(context: AfterRowRenderContext): void;
     /**
      * Check if any plugin has the afterRowRender hook implemented.
-     * Used to skip the hook call overhead when no plugins need it.
+     * Cached — invalidated on plugin attach/detach.
      */
     hasAfterRowRenderHook(): boolean;
     /**

package/lib/core/types.d.ts

@@ -20,8 +20,9 @@ export type RowPositionEntry = RowPosition;
  *
  * @example
  * ```typescript
- * // Query existing grid
- * const grid = document.querySelector('tbw-grid') as DataGridElement<Employee>;
+ * // Query existing grid with type safety
+ * import { queryGrid } from '@toolbox-web/grid';
+ * const grid = queryGrid<Employee>('tbw-grid');
  * grid.rows = employees;
  * grid.on('cell-click', (detail) => console.log(detail));
  *

package/lib/features/registry.js

@@ -1,2 +1,2 @@
-import{setFeatureResolver as o}from"@toolbox-web/grid";const e=/* @__PURE__ */new Map,t=/* @__PURE__ */new Set,n=()=>"undefined"!=typeof window&&("localhost"===window.location?.hostname||"127.0.0.1"===window.location?.hostname);function r(o,t){n()&&e.has(o)&&console.warn(`[tbw-grid] Feature "${o}" was re-registered. Previous registration overwritten.`),e.set(o,{factory:t,name:o})}function i(o){return e.has(o)}function s(o){return e.get(o)?.factory}function c(){return Array.from(e.keys())}const d={undoRedo:["editing"],clipboard:["selection"]},a={sorting:"multiSort",reorder:"reorderColumns",rowReorder:"reorderRows"};function f(o,r){const i=e.get(o);if(i)return i.factory(r);if(n()&&!t.has(o)){t.add(o);const e=o.replace(/([a-z])([A-Z])/g,"$1-$2").toLowerCase();console.warn(`[tbw-grid] Feature "${o}" is configured but not registered.\nAdd this import to enable it:\n\n  import '@toolbox-web/grid/features/${e}';\n`)}}function u(o){const e=[],t=[],r={...o};for(const[n,c]of Object.entries(a))void 0!==r[n]&&void 0===r[c]&&(r[c]=r[n]),delete r[n];for(const[n,c]of Object.entries(r))void 0!==c&&!1!==c&&t.push(n);!function(o){const e=new Set(o);for(const t of o){const o=d[t];if(o)for(const r of o)e.has(r)||n()&&console.warn(`[tbw-grid] Feature "${t}" requires "${r}" to be enabled. Add "${r}" to your features configuration.`)}}(t);const i=["selection","editing",...t.filter(o=>"selection"!==o&&"editing"!==o)],s=[...new Set(i)].filter(o=>t.includes(o));for(const n of s){const o=r[n];if(void 0===o||!1===o)continue;const t=f(n,o);t&&e.push(t)}return e}function l(){e.clear(),t.clear()}o(u);export{l as clearFeatureRegistry,f as createPluginFromFeature,u as createPluginsFromFeatures,s as getFeatureFactory,c as getRegisteredFeatures,i as isFeatureRegistered,r as registerFeature};
+import{setFeatureResolver as o}from"@toolbox-web/grid";function e(o,e,t,n){console.warn(function(o,e){return`[tbw-grid] ${o}: ${e}\n\n  → More info: ${function(o){return`https://toolboxjs.com/grid/errors#${o.toLowerCase()}`}(o)}`}(o,e))}const t=/* @__PURE__ */new Map,n=/* @__PURE__ */new Set,r=()=>"undefined"!=typeof window&&("localhost"===window.location?.hostname||"127.0.0.1"===window.location?.hostname);function i(o,n){r()&&t.has(o)&&e("TBW030",`Feature "${o}" was re-registered. Previous registration overwritten.`),t.set(o,{factory:n,name:o})}function s(o){return t.has(o)}function c(o){return t.get(o)?.factory}function f(){return Array.from(t.keys())}const u={undoRedo:["editing"],clipboard:["selection"]},d={sorting:"multiSort",reorder:"reorderColumns",rowReorder:"reorderRows"};function a(o,i){const s=t.get(o);if(s)return s.factory(i);if(r()&&!n.has(o)){n.add(o);const t=o.replace(/([a-z])([A-Z])/g,"$1-$2").toLowerCase();e("TBW031",`Feature "${o}" is configured but not registered.\nAdd this import to enable it:\n\n  import '@toolbox-web/grid/features/${t}';\n`)}}function l(o){const t=[],n=[],i={...o};for(const[e,r]of Object.entries(d))void 0!==i[e]&&void 0===i[r]&&(i[r]=i[e]),delete i[e];for(const[e,r]of Object.entries(i))void 0!==r&&!1!==r&&n.push(e);!function(o){const t=new Set(o);for(const n of o){const o=u[n];if(o)for(const i of o)t.has(i)||r()&&e("TBW032",`Feature "${n}" requires "${i}" to be enabled. Add "${i}" to your features configuration.`)}}(n);const s=["selection","editing",...n.filter(o=>"selection"!==o&&"editing"!==o)],c=[...new Set(s)].filter(o=>n.includes(o));for(const e of c){const o=i[e];if(void 0===o||!1===o)continue;const n=a(e,o);n&&t.push(n)}return t}function w(){t.clear(),n.clear()}o(l);export{w as clearFeatureRegistry,a as createPluginFromFeature,l as createPluginsFromFeatures,c as getFeatureFactory,f as getRegisteredFeatures,s as isFeatureRegistered,i as registerFeature};
 //# sourceMappingURL=registry.js.map

package/lib/features/registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.js","sources":["../../../../../libs/grid/src/lib/features/registry.ts"],"sourcesContent":["/**\n * Core Feature Registry for @toolbox-web/grid\n *\n * This module provides a framework-agnostic registry for plugin factories.\n * Features are registered via side-effect imports, enabling tree-shaking\n * while maintaining a clean declarative API.\n *\n * @example\n * ```typescript\n * // Import features you need (side-effect imports)\n * import '@toolbox-web/grid/features/selection';\n * import '@toolbox-web/grid/features/filtering';\n *\n * // Configure grid declaratively\n * grid.gridConfig = {\n *   features: {\n *     selection: 'range',\n *     filtering: { debounceMs: 200 },\n *   },\n * };\n * ```\n *\n * @packageDocumentation\n * @module Features\n */\n\nimport type { FeatureConfig, GridPlugin } from '../core/types';\nimport { setFeatureResolver } from '../core/internal/feature-hook';\n\n// #region Types\n\n/** Feature name — keys of the augmented FeatureConfig interface. */\nexport type FeatureName = keyof FeatureConfig;\n\n/** Factory function that creates a plugin from a feature config value. */\nexport type PluginFactory<TConfig = unknown> = (config: TConfig) => GridPlugin;\n\ninterface RegistryEntry {\n  factory: PluginFactory;\n  name: string;\n}\n\n// #endregion\n\n// #region Registry State\n\nconst featureRegistry = new Map<string, RegistryEntry>();\nconst warnedFeatures = new Set<string>();\n\n// #endregion\n\n// #region Registration API\n\n/** Runtime dev-mode check (localhost or 127.0.0.1). */\nconst isDev = (): boolean =>\n  typeof window !== 'undefined' &&\n  (window.location?.hostname === 'localhost' || window.location?.hostname === '127.0.0.1');\n\n/**\n * Register a feature's plugin factory.\n * Called by side-effect feature imports (e.g., `import '@toolbox-web/grid/features/selection'`).\n *\n * @param name - The feature name (matches a key on FeatureConfig)\n * @param factory - Function that creates a plugin instance from config\n */\nexport function registerFeature<K extends FeatureName>(name: K, factory: PluginFactory<FeatureConfig[K]>): void;\nexport function registerFeature(name: string, factory: PluginFactory): void;\nexport function registerFeature(name: string, factory: PluginFactory): void {\n  if (isDev() && featureRegistry.has(name)) {\n    console.warn(`[tbw-grid] Feature \"${name}\" was re-registered. Previous registration overwritten.`);\n  }\n  featureRegistry.set(name, { factory, name });\n}\n\n/**\n * Check if a feature has been registered.\n */\nexport function isFeatureRegistered(name: string): boolean {\n  return featureRegistry.has(name);\n}\n\n/**\n * Get a registered feature's factory. Returns undefined if not registered.\n */\nexport function getFeatureFactory(name: string): PluginFactory | undefined {\n  return featureRegistry.get(name)?.factory;\n}\n\n/**\n * Get all registered feature names.\n */\nexport function getRegisteredFeatures(): string[] {\n  return Array.from(featureRegistry.keys());\n}\n\n// #endregion\n\n// #region Plugin Creation\n\n/**\n * Plugin dependency declarations.\n * Some plugins require others to be loaded first.\n */\nconst PLUGIN_DEPENDENCIES: Record<string, string[]> = {\n  undoRedo: ['editing'],\n  clipboard: ['selection'],\n};\n\n/**\n * Deprecated alias mappings.\n * When both alias and primary are set, primary takes precedence.\n */\nconst FEATURE_ALIASES: Record<string, string> = {\n  sorting: 'multiSort',\n  reorder: 'reorderColumns',\n  rowReorder: 'reorderRows',\n};\n\n/**\n * Create a plugin instance for a single feature.\n * Shows a warning if the feature is not registered.\n */\nexport function createPluginFromFeature(name: string, config: unknown): GridPlugin | undefined {\n  const entry = featureRegistry.get(name);\n\n  if (!entry) {\n    if (isDev() && !warnedFeatures.has(name)) {\n      warnedFeatures.add(name);\n      const kebab = name.replace(/([a-z])([A-Z])/g, '$1-$2').toLowerCase();\n      console.warn(\n        `[tbw-grid] Feature \"${name}\" is configured but not registered.\\n` +\n          `Add this import to enable it:\\n\\n` +\n          `  import '@toolbox-web/grid/features/${kebab}';\\n`,\n      );\n    }\n    return undefined;\n  }\n\n  return entry.factory(config);\n}\n\n/**\n * Validate feature dependencies and log warnings for missing ones.\n */\nfunction validateDependencies(featureNames: string[]): void {\n  const featureSet = new Set(featureNames);\n\n  for (const feature of featureNames) {\n    const deps = PLUGIN_DEPENDENCIES[feature];\n    if (!deps) continue;\n\n    for (const dep of deps) {\n      if (!featureSet.has(dep)) {\n        if (isDev()) {\n          console.warn(\n            `[tbw-grid] Feature \"${feature}\" requires \"${dep}\" to be enabled. ` +\n              `Add \"${dep}\" to your features configuration.`,\n          );\n        }\n      }\n    }\n  }\n}\n\n/**\n * Create plugin instances from a features configuration object.\n *\n * Handles:\n * - Deprecated alias resolution (sorting → multiSort, etc.)\n * - Dependency validation (clipboard needs selection)\n * - Dependency ordering (selection before clipboard)\n * - Skipping false/undefined values\n *\n * @param features - Partial FeatureConfig object\n * @returns Array of plugin instances ready for gridConfig.plugins\n */\nexport function createPluginsFromFeatures(features: Record<string, unknown>): GridPlugin[] {\n  const plugins: GridPlugin[] = [];\n  const enabledFeatures: string[] = [];\n\n  // Resolve deprecated aliases: use primary name, skip alias if primary is set\n  const effective: Record<string, unknown> = { ...features };\n  for (const [alias, primary] of Object.entries(FEATURE_ALIASES)) {\n    if (effective[alias] !== undefined && effective[primary] === undefined) {\n      effective[primary] = effective[alias];\n    }\n    delete effective[alias];\n  }\n\n  // Collect enabled feature names\n  for (const [key, value] of Object.entries(effective)) {\n    if (value === undefined || value === false) continue;\n    enabledFeatures.push(key);\n  }\n\n  // Validate dependencies\n  validateDependencies(enabledFeatures);\n\n  // Create plugins in dependency order: dep-targets first, then the rest\n  const dependencyOrder: string[] = [\n    'selection',\n    'editing',\n    ...enabledFeatures.filter((f) => f !== 'selection' && f !== 'editing'),\n  ];\n  const orderedFeatures = [...new Set(dependencyOrder)].filter((f) => enabledFeatures.includes(f));\n\n  for (const featureName of orderedFeatures) {\n    const config = effective[featureName];\n    if (config === undefined || config === false) continue;\n\n    const plugin = createPluginFromFeature(featureName, config);\n    if (plugin) {\n      plugins.push(plugin);\n    }\n  }\n\n  return plugins;\n}\n\n// #endregion\n\n// #region Auto-Registration\n\n// Wire feature resolver into grid core so `gridConfig.features` is handled automatically.\n// This runs when any feature module is imported (they all import this registry).\nsetFeatureResolver(createPluginsFromFeatures as (features: Record<string, unknown>) => GridPlugin[]);\n\n// #endregion\n\n// #region Testing Utilities\n\n/**\n * Clear the registry. For testing only.\n * @internal\n */\nexport function clearFeatureRegistry(): void {\n  featureRegistry.clear();\n  warnedFeatures.clear();\n}\n\n// #endregion\n"],"names":["featureRegistry","Map","warnedFeatures","Set","isDev","window","location","hostname","registerFeature","name","factory","has","console","warn","set","isFeatureRegistered","getFeatureFactory","get","getRegisteredFeatures","Array","from","keys","PLUGIN_DEPENDENCIES","undoRedo","clipboard","FEATURE_ALIASES","sorting","reorder","rowReorder","createPluginFromFeature","config","entry","add","kebab","replace","toLowerCase","createPluginsFromFeatures","features","plugins","enabledFeatures","effective","alias","primary","Object","entries","key","value","push","featureNames","featureSet","feature","deps","dep","validateDependencies","dependencyOrder","filter","f","orderedFeatures","includes","featureName","plugin","clearFeatureRegistry","clear","setFeatureResolver"],"mappings":"uDA8CA,MAAMA,qBAAsBC,IACtBC,qBAAqBC,IAOrBC,EAAQ,IACM,oBAAXC,SACwB,cAA9BA,OAAOC,UAAUC,UAA0D,cAA9BF,OAAOC,UAAUC,UAW1D,SAASC,EAAgBC,EAAcC,GACxCN,KAAWJ,EAAgBW,IAAIF,IACjCG,QAAQC,KAAK,uBAAuBJ,4DAEtCT,EAAgBc,IAAIL,EAAM,CAAEC,UAASD,QACvC,CAKO,SAASM,EAAoBN,GAClC,OAAOT,EAAgBW,IAAIF,EAC7B,CAKO,SAASO,EAAkBP,GAChC,OAAOT,EAAgBiB,IAAIR,IAAOC,OACpC,CAKO,SAASQ,IACd,OAAOC,MAAMC,KAAKpB,EAAgBqB,OACpC,CAUA,MAAMC,EAAgD,CACpDC,SAAU,CAAC,WACXC,UAAW,CAAC,cAORC,EAA0C,CAC9CC,QAAS,YACTC,QAAS,iBACTC,WAAY,eAOP,SAASC,EAAwBpB,EAAcqB,GACpD,MAAMC,EAAQ/B,EAAgBiB,IAAIR,GAElC,GAAKsB,EAaL,OAAOA,EAAMrB,QAAQoB,GAZnB,GAAI1B,MAAYF,EAAeS,IAAIF,GAAO,CACxCP,EAAe8B,IAAIvB,GACnB,MAAMwB,EAAQxB,EAAKyB,QAAQ,kBAAmB,SAASC,cACvDvB,QAAQC,KACN,uBAAuBJ,+GAEmBwB,QAE9C,CAKJ,CAqCO,SAASG,EAA0BC,GACxC,MAAMC,EAAwB,GACxBC,EAA4B,GAG5BC,EAAqC,IAAKH,GAChD,IAAA,MAAYI,EAAOC,KAAYC,OAAOC,QAAQnB,QACnB,IAArBe,EAAUC,SAA+C,IAAvBD,EAAUE,KAC9CF,EAAUE,GAAWF,EAAUC,WAE1BD,EAAUC,GAInB,IAAA,MAAYI,EAAKC,KAAUH,OAAOC,QAAQJ,QAC1B,IAAVM,IAAiC,IAAVA,GAC3BP,EAAgBQ,KAAKF,IAhDzB,SAA8BG,GAC5B,MAAMC,EAAa,IAAI9C,IAAI6C,GAE3B,IAAA,MAAWE,KAAWF,EAAc,CAClC,MAAMG,EAAO7B,EAAoB4B,GACjC,GAAKC,EAEL,IAAA,MAAWC,KAAOD,EACXF,EAAWtC,IAAIyC,IACdhD,KACFQ,QAAQC,KACN,uBAAuBqC,gBAAsBE,0BACnCA,qCAKpB,CACF,CAkCEC,CAAqBd,GAGrB,MAAMe,EAA4B,CAChC,YACA,aACGf,EAAgBgB,OAAQC,GAAY,cAANA,GAA2B,YAANA,IAElDC,EAAkB,IAAI,IAAItD,IAAImD,IAAkBC,OAAQC,GAAMjB,EAAgBmB,SAASF,IAE7F,IAAA,MAAWG,KAAeF,EAAiB,CACzC,MAAM3B,EAASU,EAAUmB,GACzB,QAAe,IAAX7B,IAAmC,IAAXA,EAAkB,SAE9C,MAAM8B,EAAS/B,EAAwB8B,EAAa7B,GAChD8B,GACFtB,EAAQS,KAAKa,EAEjB,CAEA,OAAOtB,CACT,CAkBO,SAASuB,IACd7D,EAAgB8D,QAChB5D,EAAe4D,OACjB,CAbAC,EAAmB3B"}
+{"version":3,"file":"registry.js","sources":["../../../../../libs/grid/src/lib/core/internal/diagnostics.ts","../../../../../libs/grid/src/lib/features/registry.ts"],"sourcesContent":["/**\n * Centralized diagnostic messages for @toolbox-web/grid.\n *\n * Every user-facing warning, error, or info message in the grid has a unique\n * diagnostic code (e.g. `TBW001`). Each code maps to a section on the online\n * troubleshooting page, giving developers a direct link to resolution steps.\n *\n * ## Usage\n *\n * ```ts\n * import { MISSING_BREAKPOINT, warnDiagnostic, throwDiagnostic } from './diagnostics';\n *\n * // Warn with a code\n * warnDiagnostic(MISSING_BREAKPOINT, 'Set a breakpoint...', gridId);\n *\n * // Throw with a code\n * throwDiagnostic(MISSING_ROW_ID, 'Configure getRowId...', gridId);\n * ```\n *\n * Plugins should prefer `this.warn(MISSING_BREAKPOINT, message)` via BaseGridPlugin\n * instead of importing this module directly.\n *\n * @internal\n */\n\n// #region Grid Prefix\n\n/**\n * Build the `[tbw-grid]` or `[tbw-grid#my-id]` log prefix.\n * Pass `pluginName` for a scoped prefix like `[tbw-grid:SelectionPlugin]`.\n */\nexport function gridPrefix(gridId?: string, pluginName?: string): string {\n  const id = gridId ? `#${gridId}` : '';\n  const plugin = pluginName ? `:${pluginName}` : '';\n  return `[tbw-grid${id}${plugin}]`;\n}\n\n// #endregion\n\n// #region Diagnostic Codes\n\n/**\n * Diagnostic codes used across the grid library.\n *\n * Each code is an individual export so that unused codes are tree-shaken\n * from bundles that don't reference them (esbuild can't tree-shake\n * properties from a single object).\n *\n * Naming: TBW + 3-digit number.\n * Ranges:\n *   001–019  Configuration validation (missing plugins, bad config)\n *   020–029  Plugin lifecycle (dependencies, incompatibilities, deprecation)\n *   030–039  Feature registry\n *   040–049  Row operations (row ID, row mutations)\n *   050–059  Column operations (width, template)\n *   060–069  Rendering (callbacks, formatters, external views)\n *   070–079  Shell (tool panels, header/toolbar content)\n *   080–089  Editing & editors\n *   090–099  Print\n *   100–109  Clipboard\n *   110–119  Plugin-specific (responsive, undo-redo, grouping-columns)\n *   120–129  Style injection\n *   130–139  Attribute parsing\n */\n\n// --- Config validation (001–019) ---\n/** Column uses a plugin-owned property but the plugin is not loaded. */\nexport const MISSING_PLUGIN = 'TBW001' as const;\n/** Grid config uses a plugin-owned property but the plugin is not loaded. */\nexport const MISSING_PLUGIN_CONFIG = 'TBW002' as const;\n/** Plugin config rule violation (error severity). */\nexport const CONFIG_RULE_ERROR = 'TBW003' as const;\n/** Plugin config rule violation (warning severity). */\nexport const CONFIG_RULE_WARN = 'TBW004' as const;\n\n// --- Plugin lifecycle (020–029) ---\n/** Required plugin dependency is missing. */\nexport const MISSING_DEPENDENCY = 'TBW020' as const;\n/** Optional plugin dependency is missing. */\nexport const OPTIONAL_DEPENDENCY = 'TBW021' as const;\n/** Two loaded plugins are incompatible. */\nexport const INCOMPATIBLE_PLUGINS = 'TBW022' as const;\n/** Plugin uses deprecated hooks. */\nexport const DEPRECATED_HOOK = 'TBW023' as const;\n/** Error thrown inside a plugin event handler. */\nexport const PLUGIN_EVENT_ERROR = 'TBW024' as const;\n\n// --- Feature registry (030–039) ---\n/** Feature was re-registered (overwritten). */\nexport const FEATURE_REREGISTERED = 'TBW030' as const;\n/** Feature configured but not imported. */\nexport const FEATURE_NOT_IMPORTED = 'TBW031' as const;\n/** Feature depends on another feature that is not enabled. */\nexport const FEATURE_MISSING_DEP = 'TBW032' as const;\n\n// --- Row operations (040–049) ---\n/** Cannot determine row ID (no getRowId and no id property). */\nexport const MISSING_ROW_ID = 'TBW040' as const;\n/** Row with given ID not found. */\nexport const ROW_NOT_FOUND = 'TBW041' as const;\n\n// --- Column operations (050–059) ---\n/** Column has an invalid CSS width value. */\nexport const INVALID_COLUMN_WIDTH = 'TBW050' as const;\n\n// --- Rendering callbacks (060–069) ---\n/** rowClass callback threw an error. */\nexport const ROW_CLASS_ERROR = 'TBW060' as const;\n/** cellClass callback threw an error. */\nexport const CELL_CLASS_ERROR = 'TBW061' as const;\n/** Column format function threw an error. */\nexport const FORMAT_ERROR = 'TBW062' as const;\n/** External view mount() threw an error. */\nexport const VIEW_MOUNT_ERROR = 'TBW063' as const;\n/** External view event dispatch error. */\nexport const VIEW_DISPATCH_ERROR = 'TBW064' as const;\n\n// --- Shell (070–079) ---\n/** Tool panel missing required id or title. */\nexport const TOOL_PANEL_MISSING_ATTR = 'TBW070' as const;\n/** No tool panels registered. */\nexport const NO_TOOL_PANELS = 'TBW071' as const;\n/** Tool panel section not found. */\nexport const TOOL_PANEL_NOT_FOUND = 'TBW072' as const;\n/** Tool panel already registered. */\nexport const TOOL_PANEL_DUPLICATE = 'TBW073' as const;\n/** Header content already registered. */\nexport const HEADER_CONTENT_DUPLICATE = 'TBW074' as const;\n/** Toolbar content already registered. */\nexport const TOOLBAR_CONTENT_DUPLICATE = 'TBW075' as const;\n\n// --- Editing & editors (080–089) ---\n/** External editor mount() threw an error. */\nexport const EDITOR_MOUNT_ERROR = 'TBW080' as const;\n\n// --- Print (090–099) ---\n/** Print already in progress. */\nexport const PRINT_IN_PROGRESS = 'TBW090' as const;\n/** Grid not available for printing. */\nexport const PRINT_NO_GRID = 'TBW091' as const;\n/** Print operation failed. */\nexport const PRINT_FAILED = 'TBW092' as const;\n/** Multiple elements share the same grid ID (print isolation issue). */\nexport const PRINT_DUPLICATE_ID = 'TBW093' as const;\n\n// --- Clipboard (100–109) ---\n/** Clipboard API write failed. */\nexport const CLIPBOARD_FAILED = 'TBW100' as const;\n\n// --- Plugin-specific (110–119) ---\n/** ResponsivePlugin: no breakpoint configured. */\nexport const MISSING_BREAKPOINT = 'TBW110' as const;\n/** UndoRedoPlugin: transaction already in progress. */\nexport const TRANSACTION_IN_PROGRESS = 'TBW111' as const;\n/** UndoRedoPlugin: no transaction in progress. */\nexport const NO_TRANSACTION = 'TBW112' as const;\n/** GroupingColumnsPlugin: missing id or header on column group definition. */\nexport const COLUMN_GROUP_NO_ID = 'TBW113' as const;\n/** GroupingColumnsPlugin: conflicting columnGroups sources. */\nexport const COLUMN_GROUPS_CONFLICT = 'TBW114' as const;\n\n// --- Style injection (120–129) ---\n/** Failed to extract grid.css from document stylesheets. */\nexport const STYLE_EXTRACT_FAILED = 'TBW120' as const;\n/** Could not find grid.css in document.styleSheets. */\nexport const STYLE_NOT_FOUND = 'TBW121' as const;\n\n// --- Attribute parsing (130–139) ---\n/** Invalid JSON in an HTML attribute. */\nexport const INVALID_ATTRIBUTE_JSON = 'TBW130' as const;\n\nexport type DiagnosticCode =\n  | typeof MISSING_PLUGIN\n  | typeof MISSING_PLUGIN_CONFIG\n  | typeof CONFIG_RULE_ERROR\n  | typeof CONFIG_RULE_WARN\n  | typeof MISSING_DEPENDENCY\n  | typeof OPTIONAL_DEPENDENCY\n  | typeof INCOMPATIBLE_PLUGINS\n  | typeof DEPRECATED_HOOK\n  | typeof PLUGIN_EVENT_ERROR\n  | typeof FEATURE_REREGISTERED\n  | typeof FEATURE_NOT_IMPORTED\n  | typeof FEATURE_MISSING_DEP\n  | typeof MISSING_ROW_ID\n  | typeof ROW_NOT_FOUND\n  | typeof INVALID_COLUMN_WIDTH\n  | typeof ROW_CLASS_ERROR\n  | typeof CELL_CLASS_ERROR\n  | typeof FORMAT_ERROR\n  | typeof VIEW_MOUNT_ERROR\n  | typeof VIEW_DISPATCH_ERROR\n  | typeof TOOL_PANEL_MISSING_ATTR\n  | typeof NO_TOOL_PANELS\n  | typeof TOOL_PANEL_NOT_FOUND\n  | typeof TOOL_PANEL_DUPLICATE\n  | typeof HEADER_CONTENT_DUPLICATE\n  | typeof TOOLBAR_CONTENT_DUPLICATE\n  | typeof EDITOR_MOUNT_ERROR\n  | typeof PRINT_IN_PROGRESS\n  | typeof PRINT_NO_GRID\n  | typeof PRINT_FAILED\n  | typeof PRINT_DUPLICATE_ID\n  | typeof CLIPBOARD_FAILED\n  | typeof MISSING_BREAKPOINT\n  | typeof TRANSACTION_IN_PROGRESS\n  | typeof NO_TRANSACTION\n  | typeof COLUMN_GROUP_NO_ID\n  | typeof COLUMN_GROUPS_CONFLICT\n  | typeof STYLE_EXTRACT_FAILED\n  | typeof STYLE_NOT_FOUND\n  | typeof INVALID_ATTRIBUTE_JSON;\n\n// #endregion\n\n// #region Docs URL\n\nconst DOCS_BASE = 'https://toolboxjs.com/grid/errors';\n\n/** Build a direct link to the troubleshooting section for a code. */\nfunction docsUrl(code: DiagnosticCode): string {\n  return `${DOCS_BASE}#${code.toLowerCase()}`;\n}\n\n// #endregion\n\n// #region Formatting\n\n/**\n * Format a diagnostic message with prefix, code, and docs link.\n *\n * Output format:\n * ```\n * [tbw-grid#my-id] TBW001: Your message here.\n *\n *   → More info: https://toolboxjs.com/grid/errors#tbw001\n * ```\n */\nexport function formatDiagnostic(code: DiagnosticCode, message: string, gridId?: string, pluginName?: string): string {\n  const prefix = gridPrefix(gridId, pluginName);\n  return `${prefix} ${code}: ${message}\\n\\n  → More info: ${docsUrl(code)}`;\n}\n\n// #endregion\n\n// #region Public API\n\n/**\n * Throw an error with a diagnostic code and docs link.\n * Use for configuration errors and API misuse that should halt execution.\n */\nexport function throwDiagnostic(code: DiagnosticCode, message: string, gridId?: string, pluginName?: string): never {\n  throw new Error(formatDiagnostic(code, message, gridId, pluginName));\n}\n\n/**\n * Log a warning with a diagnostic code and docs link.\n * Use for recoverable issues the developer should fix.\n */\nexport function warnDiagnostic(code: DiagnosticCode, message: string, gridId?: string, pluginName?: string): void {\n  console.warn(formatDiagnostic(code, message, gridId, pluginName));\n}\n\n/**\n * Log an info message with a diagnostic code and docs link.\n * Use for optional/soft dependency notifications.\n */\nexport function infoDiagnostic(code: DiagnosticCode, message: string, gridId?: string, pluginName?: string): void {\n  console.info(formatDiagnostic(code, message, gridId, pluginName));\n}\n\n/**\n * Log an error with a diagnostic code and docs link.\n * Use for non-throwing errors (e.g., failed async operations).\n */\nexport function errorDiagnostic(code: DiagnosticCode, message: string, gridId?: string, pluginName?: string): void {\n  console.error(formatDiagnostic(code, message, gridId, pluginName));\n}\n\n// #endregion\n","/**\n * Core Feature Registry for @toolbox-web/grid\n *\n * This module provides a framework-agnostic registry for plugin factories.\n * Features are registered via side-effect imports, enabling tree-shaking\n * while maintaining a clean declarative API.\n *\n * @example\n * ```typescript\n * // Import features you need (side-effect imports)\n * import '@toolbox-web/grid/features/selection';\n * import '@toolbox-web/grid/features/filtering';\n *\n * // Configure grid declaratively\n * grid.gridConfig = {\n *   features: {\n *     selection: 'range',\n *     filtering: { debounceMs: 200 },\n *   },\n * };\n * ```\n *\n * @packageDocumentation\n * @module Features\n */\n\nimport {\n  FEATURE_MISSING_DEP,\n  FEATURE_NOT_IMPORTED,\n  FEATURE_REREGISTERED,\n  warnDiagnostic,\n} from '../core/internal/diagnostics';\nimport { setFeatureResolver } from '../core/internal/feature-hook';\nimport type { FeatureConfig, GridPlugin } from '../core/types';\n\n// #region Types\n\n/** Feature name — keys of the augmented FeatureConfig interface. */\nexport type FeatureName = keyof FeatureConfig;\n\n/** Factory function that creates a plugin from a feature config value. */\nexport type PluginFactory<TConfig = unknown> = (config: TConfig) => GridPlugin;\n\ninterface RegistryEntry {\n  factory: PluginFactory;\n  name: string;\n}\n\n// #endregion\n\n// #region Registry State\n\nconst featureRegistry = new Map<string, RegistryEntry>();\nconst warnedFeatures = new Set<string>();\n\n// #endregion\n\n// #region Registration API\n\n/** Runtime dev-mode check (localhost or 127.0.0.1). */\nconst isDev = (): boolean =>\n  typeof window !== 'undefined' &&\n  (window.location?.hostname === 'localhost' || window.location?.hostname === '127.0.0.1');\n\n/**\n * Register a feature's plugin factory.\n * Called by side-effect feature imports (e.g., `import '@toolbox-web/grid/features/selection'`).\n *\n * @param name - The feature name (matches a key on FeatureConfig)\n * @param factory - Function that creates a plugin instance from config\n */\nexport function registerFeature<K extends FeatureName>(name: K, factory: PluginFactory<FeatureConfig[K]>): void;\nexport function registerFeature(name: string, factory: PluginFactory): void;\nexport function registerFeature(name: string, factory: PluginFactory): void {\n  if (isDev() && featureRegistry.has(name)) {\n    warnDiagnostic(FEATURE_REREGISTERED, `Feature \"${name}\" was re-registered. Previous registration overwritten.`);\n  }\n  featureRegistry.set(name, { factory, name });\n}\n\n/**\n * Check if a feature has been registered.\n */\nexport function isFeatureRegistered(name: string): boolean {\n  return featureRegistry.has(name);\n}\n\n/**\n * Get a registered feature's factory. Returns undefined if not registered.\n */\nexport function getFeatureFactory(name: string): PluginFactory | undefined {\n  return featureRegistry.get(name)?.factory;\n}\n\n/**\n * Get all registered feature names.\n */\nexport function getRegisteredFeatures(): string[] {\n  return Array.from(featureRegistry.keys());\n}\n\n// #endregion\n\n// #region Plugin Creation\n\n/**\n * Plugin dependency declarations.\n * Some plugins require others to be loaded first.\n */\nconst PLUGIN_DEPENDENCIES: Record<string, string[]> = {\n  undoRedo: ['editing'],\n  clipboard: ['selection'],\n};\n\n/**\n * Deprecated alias mappings.\n * When both alias and primary are set, primary takes precedence.\n */\nconst FEATURE_ALIASES: Record<string, string> = {\n  sorting: 'multiSort',\n  reorder: 'reorderColumns',\n  rowReorder: 'reorderRows',\n};\n\n/**\n * Create a plugin instance for a single feature.\n * Shows a warning if the feature is not registered.\n */\nexport function createPluginFromFeature(name: string, config: unknown): GridPlugin | undefined {\n  const entry = featureRegistry.get(name);\n\n  if (!entry) {\n    if (isDev() && !warnedFeatures.has(name)) {\n      warnedFeatures.add(name);\n      const kebab = name.replace(/([a-z])([A-Z])/g, '$1-$2').toLowerCase();\n      warnDiagnostic(\n        FEATURE_NOT_IMPORTED,\n        `Feature \"${name}\" is configured but not registered.\\n` +\n          `Add this import to enable it:\\n\\n` +\n          `  import '@toolbox-web/grid/features/${kebab}';\\n`,\n      );\n    }\n    return undefined;\n  }\n\n  return entry.factory(config);\n}\n\n/**\n * Validate feature dependencies and log warnings for missing ones.\n */\nfunction validateDependencies(featureNames: string[]): void {\n  const featureSet = new Set(featureNames);\n\n  for (const feature of featureNames) {\n    const deps = PLUGIN_DEPENDENCIES[feature];\n    if (!deps) continue;\n\n    for (const dep of deps) {\n      if (!featureSet.has(dep)) {\n        if (isDev()) {\n          warnDiagnostic(\n            FEATURE_MISSING_DEP,\n            `Feature \"${feature}\" requires \"${dep}\" to be enabled. ` + `Add \"${dep}\" to your features configuration.`,\n          );\n        }\n      }\n    }\n  }\n}\n\n/**\n * Create plugin instances from a features configuration object.\n *\n * Handles:\n * - Deprecated alias resolution (sorting → multiSort, etc.)\n * - Dependency validation (clipboard needs selection)\n * - Dependency ordering (selection before clipboard)\n * - Skipping false/undefined values\n *\n * @param features - Partial FeatureConfig object\n * @returns Array of plugin instances ready for gridConfig.plugins\n */\nexport function createPluginsFromFeatures(features: Record<string, unknown>): GridPlugin[] {\n  const plugins: GridPlugin[] = [];\n  const enabledFeatures: string[] = [];\n\n  // Resolve deprecated aliases: use primary name, skip alias if primary is set\n  const effective: Record<string, unknown> = { ...features };\n  for (const [alias, primary] of Object.entries(FEATURE_ALIASES)) {\n    if (effective[alias] !== undefined && effective[primary] === undefined) {\n      effective[primary] = effective[alias];\n    }\n    delete effective[alias];\n  }\n\n  // Collect enabled feature names\n  for (const [key, value] of Object.entries(effective)) {\n    if (value === undefined || value === false) continue;\n    enabledFeatures.push(key);\n  }\n\n  // Validate dependencies\n  validateDependencies(enabledFeatures);\n\n  // Create plugins in dependency order: dep-targets first, then the rest\n  const dependencyOrder: string[] = [\n    'selection',\n    'editing',\n    ...enabledFeatures.filter((f) => f !== 'selection' && f !== 'editing'),\n  ];\n  const orderedFeatures = [...new Set(dependencyOrder)].filter((f) => enabledFeatures.includes(f));\n\n  for (const featureName of orderedFeatures) {\n    const config = effective[featureName];\n    if (config === undefined || config === false) continue;\n\n    const plugin = createPluginFromFeature(featureName, config);\n    if (plugin) {\n      plugins.push(plugin);\n    }\n  }\n\n  return plugins;\n}\n\n// #endregion\n\n// #region Auto-Registration\n\n// Wire feature resolver into grid core so `gridConfig.features` is handled automatically.\n// This runs when any feature module is imported (they all import this registry).\nsetFeatureResolver(createPluginsFromFeatures as (features: Record<string, unknown>) => GridPlugin[]);\n\n// #endregion\n\n// #region Testing Utilities\n\n/**\n * Clear the registry. For testing only.\n * @internal\n */\nexport function clearFeatureRegistry(): void {\n  featureRegistry.clear();\n  warnedFeatures.clear();\n}\n\n// #endregion\n"],"names":["warnDiagnostic","code","message","gridId","pluginName","console","warn","toLowerCase","docsUrl","formatDiagnostic","featureRegistry","Map","warnedFeatures","Set","isDev","window","location","hostname","registerFeature","name","factory","has","set","isFeatureRegistered","getFeatureFactory","get","getRegisteredFeatures","Array","from","keys","PLUGIN_DEPENDENCIES","undoRedo","clipboard","FEATURE_ALIASES","sorting","reorder","rowReorder","createPluginFromFeature","config","entry","add","kebab","replace","createPluginsFromFeatures","features","plugins","enabledFeatures","effective","alias","primary","Object","entries","key","value","push","featureNames","featureSet","feature","deps","dep","validateDependencies","dependencyOrder","filter","f","orderedFeatures","includes","featureName","plugin","clearFeatureRegistry","clear","setFeatureResolver"],"mappings":"uDAmQO,SAASA,EAAeC,EAAsBC,EAAiBC,EAAiBC,GACrFC,QAAQC,KAtBH,SAA0BL,EAAsBC,GAErD,MAAO,cAAaD,MAASC,uBApB/B,SAAiBD,GACf,MAAO,qCAAgBA,EAAKM,eAC9B,CAkB4DC,CAAQP,IACpE,CAmBeQ,CAAiBR,EAAMC,GACtC,CCjNA,MAAMQ,qBAAsBC,IACtBC,qBAAqBC,IAOrBC,EAAQ,IACM,oBAAXC,SACwB,cAA9BA,OAAOC,UAAUC,UAA0D,cAA9BF,OAAOC,UAAUC,UAW1D,SAASC,EAAgBC,EAAcC,GACxCN,KAAWJ,EAAgBW,IAAIF,IACjCnB,EDcgC,SCdK,YAAYmB,4DAEnDT,EAAgBY,IAAIH,EAAM,CAAEC,UAASD,QACvC,CAKO,SAASI,EAAoBJ,GAClC,OAAOT,EAAgBW,IAAIF,EAC7B,CAKO,SAASK,EAAkBL,GAChC,OAAOT,EAAgBe,IAAIN,IAAOC,OACpC,CAKO,SAASM,IACd,OAAOC,MAAMC,KAAKlB,EAAgBmB,OACpC,CAUA,MAAMC,EAAgD,CACpDC,SAAU,CAAC,WACXC,UAAW,CAAC,cAORC,EAA0C,CAC9CC,QAAS,YACTC,QAAS,iBACTC,WAAY,eAOP,SAASC,EAAwBlB,EAAcmB,GACpD,MAAMC,EAAQ7B,EAAgBe,IAAIN,GAElC,GAAKoB,EAcL,OAAOA,EAAMnB,QAAQkB,GAbnB,GAAIxB,MAAYF,EAAeS,IAAIF,GAAO,CACxCP,EAAe4B,IAAIrB,GACnB,MAAMsB,EAAQtB,EAAKuB,QAAQ,kBAAmB,SAASnC,cACvDP,ED5C8B,SC8C5B,YAAYmB,+GAE8BsB,QAE9C,CAKJ,CAqCO,SAASE,EAA0BC,GACxC,MAAMC,EAAwB,GACxBC,EAA4B,GAG5BC,EAAqC,IAAKH,GAChD,IAAA,MAAYI,EAAOC,KAAYC,OAAOC,QAAQlB,QACnB,IAArBc,EAAUC,SAA+C,IAAvBD,EAAUE,KAC9CF,EAAUE,GAAWF,EAAUC,WAE1BD,EAAUC,GAInB,IAAA,MAAYI,EAAKC,KAAUH,OAAOC,QAAQJ,QAC1B,IAAVM,IAAiC,IAAVA,GAC3BP,EAAgBQ,KAAKF,IAhDzB,SAA8BG,GAC5B,MAAMC,EAAa,IAAI3C,IAAI0C,GAE3B,IAAA,MAAWE,KAAWF,EAAc,CAClC,MAAMG,EAAO5B,EAAoB2B,GACjC,GAAKC,EAEL,IAAA,MAAWC,KAAOD,EACXF,EAAWnC,IAAIsC,IACd7C,KACFd,EDpEyB,SCsEvB,YAAYyD,gBAAsBE,0BAAiCA,qCAK7E,CACF,CAkCEC,CAAqBd,GAGrB,MAAMe,EAA4B,CAChC,YACA,aACGf,EAAgBgB,OAAQC,GAAY,cAANA,GAA2B,YAANA,IAElDC,EAAkB,IAAI,IAAInD,IAAIgD,IAAkBC,OAAQC,GAAMjB,EAAgBmB,SAASF,IAE7F,IAAA,MAAWG,KAAeF,EAAiB,CACzC,MAAM1B,EAASS,EAAUmB,GACzB,QAAe,IAAX5B,IAAmC,IAAXA,EAAkB,SAE9C,MAAM6B,EAAS9B,EAAwB6B,EAAa5B,GAChD6B,GACFtB,EAAQS,KAAKa,EAEjB,CAEA,OAAOtB,CACT,CAkBO,SAASuB,IACd1D,EAAgB2D,QAChBzD,EAAeyD,OACjB,CAbAC,EAAmB3B"}

package/lib/plugins/clipboard/index.js

@@ -1,2 +1,2 @@
-const e='<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>',t={expand:"▶",collapse:"▼",sortAsc:"▲",sortDesc:"▼",sortNone:"⇅",submenuArrow:"▶",dragHandle:"⋮⋮",toolPanel:"☰",filter:e,filterActive:e,print:"🖨️"};class n{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 n=new CustomEvent(e,{detail:t,bubbles:!0,cancelable:!0});return this.grid?.dispatchEvent?.(n),n.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{...t,...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(),n=parseInt(t,10);if(!isNaN(n))return n}return 200}resolveIcon(e,t){return void 0!==t?t:this.gridIcons[e]}setIcon(e,t){"string"==typeof t?e.innerHTML=t:t instanceof HTMLElement&&(e.innerHTML="",e.appendChild(t.cloneNode(!0)))}warn(e){var t,n;console.warn(`${t=this.gridElement.id,n=this.name,`[tbw-grid${t?`#${t}`:""}${n?`:${n}`:""}]`} ${e}`)}}function i(e,t,n=!0){let i=e;if(n&&(i=i.filter(e=>!e.hidden&&!e.field.startsWith("__")&&!0!==e.meta?.utility)),t?.length){const e=new Set(t);i=i.filter(t=>e.has(t.field))}return i}function r(e){return null==e?"":e instanceof Date?e.toISOString():"object"==typeof e?JSON.stringify(e):String(e)}function s(e,t){const n=t.delimiter??"\t",i=t.newline??"\n",r=e.replace(/\r\n/g,"\n").replace(/\r/g,"\n"),s=[];let o=[],l="",a=!1;for(let c=0;c<r.length;c++){const e=r[c];'"'!==e||a?'"'===e&&a?'"'===r[c+1]?(l+='"',c++):a=!1:e!==n||a?e!==i||a?l+=e:(o.push(l),l="",(o.length>1||o.some(e=>""!==e.trim()))&&s.push(o),o=[]):(o.push(l),l=""):a=!0}return o.push(l),(o.length>1||o.some(e=>""!==e.trim()))&&s.push(o),s}function o(e,t){const{rows:n,target:i,fields:r}=e;if(!i)return;const s=t.rows,o=t.effectiveConfig.columns??[],l=o.map(e=>e.field),a=/* @__PURE__ */new Map;o.forEach(e=>{a.set(e.field,!0===e.editable)});const c=[...s],d=i.bounds?i.bounds.endRow:1/0;n.forEach((e,t)=>{const n=i.row+t;if(!(n>d)){if(i.bounds){if(n>=c.length)return}else for(;n>=c.length;){const e={};l.forEach(t=>e[t]=""),c.push(e)}c[n]={...c[n]},e.forEach((e,t)=>{const i=r[t];i&&a.get(i)&&(c[n][i]=e)})}}),t.rows=c}class l extends n{static dependencies=[{name:"selection",required:!1,reason:"Enables copy/paste of selected cells instead of entire grid"}];name="clipboard";get defaultConfig(){return{includeHeaders:!1,delimiter:"\t",newline:"\n",quoteStrings:!1}}lastCopied=null;attach(e){super.attach(e),e.addEventListener("paste",e=>this.#t(e),{signal:this.disconnectSignal})}detach(){this.lastCopied=null}onKeyDown(e){return!(!e.ctrlKey&&!e.metaKey||"c"!==e.key)&&(e.preventDefault(),this.#n(e.target),!0)}#n(e){const t=this.#i();if(t&&0===t.ranges.length){const t=this.#r(e);if(!t)return;const n=this.columns[t.col];if(!n)return;return void this.copy({rowIndices:[t.row],columns:[n.field]})}this.copy()}#t(e){const t=e.clipboardData?.getData("text/plain");if(!t)return;e.preventDefault();const n=s(t,this.config),i=this.#i(),r=i?.ranges?.[0],o=r?.from.row??0,l=r?.from.col??0,a=r&&("range"===i?.mode||"row"===i?.mode)&&(r.from.row!==r.to.row||r.from.col!==r.to.col)?{endRow:r.to.row,endCol:r.to.col}:null,c=a?.endCol??this.visibleColumns.length-1,d=this.visibleColumns[l],u=d?{row:o,col:l,field:d.field,bounds:a}:null,h=[],g=n[0]?.length??0;for(let s=0;s<g&&l+s<=c;s++){const e=this.visibleColumns[l+s];e&&h.push(e.field)}const f={rows:n,text:t,target:u,fields:h};this.emit("paste",f),this.#s(f)}#s(e){if(!this.grid)return;const{pasteHandler:t}=this.config;if(null===t)return;(t??o)(e,this.grid)}#i(){const e=this.grid?.query("getSelection");return e?.[0]}#o(e){const t=this.#i();let n,r;if(e?.columns)n=i(this.columns,e.columns);else if(t?.ranges.length&&"row"!==t.mode){const e=t.ranges[t.ranges.length-1],r=Math.min(e.from.col,e.to.col),s=Math.max(e.from.col,e.to.col);n=i(this.visibleColumns.slice(r,s+1))}else n=i(this.columns);if(e?.rowIndices)r=function(e,t){return t?.length?[...t].sort((e,t)=>e-t).map(t=>e[t]).filter(e=>null!=e):e}(this.rows,e.rowIndices);else if(t?.ranges.length){const e=t.ranges[t.ranges.length-1],n=Math.min(e.from.row,e.to.row),i=Math.max(e.from.row,e.to.row);r=[];for(let t=n;t<=i;t++){const e=this.rows[t];e&&r.push(e)}}else r=this.rows;return{columns:n,rows:r}}#l(e,t,n){const i=n?.delimiter??this.config.delimiter??"\t",s=n?.newline??this.config.newline??"\n",o=n?.includeHeaders??this.config.includeHeaders??!1,l=n?.processCell??this.config.processCell,a=[];o&&a.push(e.map(e=>e.header||e.field).join(i));for(const c of t){const t=e.map(e=>{const t=c[e.field];return l?l(t,e.field,c):r(t)});a.push(t.join(i))}return a.join(s)}#r(e){const t=e.closest("[data-field-cache]");if(!t)return null;const n=t.dataset.fieldCache,i=t.dataset.row;if(!n||!i)return null;const r=parseInt(i,10);if(isNaN(r))return null;const s=this.columns.findIndex(e=>e.field===n);return-1===s?null:{row:r,col:s}}getSelectionAsText(e){const{columns:t,rows:n}=this.#o(e);return 0===t.length||0===n.length?"":this.#l(t,n,e)}async copy(e){const{columns:t,rows:n}=this.#o(e);if(0===t.length||0===n.length)return"";const i=this.#l(t,n,e);return await async function(e){try{return await navigator.clipboard.writeText(e),!0}catch(t){console.warn("[copyToClipboard] Clipboard API failed:",t);const n=document.createElement("textarea");n.value=e,n.style.position="fixed",n.style.opacity="0",n.style.pointerEvents="none",document.body.appendChild(n),n.select();const i=document.execCommand("copy");return document.body.removeChild(n),i}}(i),this.lastCopied={text:i,timestamp:Date.now()},this.emit("copy",{text:i,rowCount:n.length,columnCount:t.length}),i}async copyRows(e,t){return 0===e.length?"":this.copy({...t,rowIndices:e})}async paste(){const e=await async function(){try{return await navigator.clipboard.readText()}catch{return""}}();return e?s(e,this.config):null}getLastCopied(){return this.lastCopied}}export{l as ClipboardPlugin,o as defaultPasteHandler};
+function e(e,t){return`[tbw-grid${e?`#${e}`:""}${t?`:${t}`:""}]`}function t(t,n,r,i){return`${e(r,i)} ${t}: ${n}\n\n  → More info: ${function(e){return`https://toolboxjs.com/grid/errors#${e.toLowerCase()}`}(t)}`}const n='<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>',r={expand:"▶",collapse:"▼",sortAsc:"▲",sortDesc:"▼",sortNone:"⇅",submenuArrow:"▶",dragHandle:"⋮⋮",toolPanel:"☰",filter:n,filterActive:n,print:"🖨️"};class i{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 n=new CustomEvent(e,{detail:t,bubbles:!0,cancelable:!0});return this.grid?.dispatchEvent?.(n),n.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{...r,...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(),n=parseInt(t,10);if(!isNaN(n))return n}return 200}resolveIcon(e,t){return void 0!==t?t:this.gridIcons[e]}setIcon(e,t){"string"==typeof t?e.innerHTML=t:t instanceof HTMLElement&&(e.innerHTML="",e.appendChild(t.cloneNode(!0)))}warn(n,r){void 0!==r?console.warn(t(n,r,this.gridElement.id,this.name)):console.warn(`${e(this.gridElement.id,this.name)} ${n}`)}throwDiagnostic(e,n){throw new Error(t(e,n,this.gridElement.id,this.name))}}function o(e,t,n=!0){let r=e;if(n&&(r=r.filter(e=>!e.hidden&&!e.field.startsWith("__")&&!0!==e.meta?.utility)),t?.length){const e=new Set(t);r=r.filter(t=>e.has(t.field))}return r}function s(e){return null==e?"":e instanceof Date?e.toISOString():"object"==typeof e?JSON.stringify(e):String(e)}async function l(e){try{return await navigator.clipboard.writeText(e),!0}catch(s){n="TBW100",r=`Clipboard API failed: ${s}`,console.warn(t(n,r,i,o));const l=document.createElement("textarea");l.value=e,l.style.position="fixed",l.style.opacity="0",l.style.pointerEvents="none",document.body.appendChild(l),l.select();const a=document.execCommand("copy");return document.body.removeChild(l),a}var n,r,i,o}function a(e,t){const n=t.delimiter??"\t",r=t.newline??"\n",i=e.replace(/\r\n/g,"\n").replace(/\r/g,"\n"),o=[];let s=[],l="",a=!1;for(let c=0;c<i.length;c++){const e=i[c];'"'!==e||a?'"'===e&&a?'"'===i[c+1]?(l+='"',c++):a=!1:e!==n||a?e!==r||a?l+=e:(s.push(l),l="",(s.length>1||s.some(e=>""!==e.trim()))&&o.push(s),s=[]):(s.push(l),l=""):a=!0}return s.push(l),(s.length>1||s.some(e=>""!==e.trim()))&&o.push(s),o}function c(e,t){const{rows:n,target:r,fields:i}=e;if(!r)return;const o=t.rows,s=t.effectiveConfig.columns??[],l=s.map(e=>e.field),a=/* @__PURE__ */new Map;s.forEach(e=>{a.set(e.field,!0===e.editable)});const c=[...o],d=r.bounds?r.bounds.endRow:1/0;n.forEach((e,t)=>{const n=r.row+t;if(!(n>d)){if(r.bounds){if(n>=c.length)return}else for(;n>=c.length;){const e={};l.forEach(t=>e[t]=""),c.push(e)}c[n]={...c[n]},e.forEach((e,t)=>{const r=i[t];r&&a.get(r)&&(c[n][r]=e)})}}),t.rows=c}class d extends i{static dependencies=[{name:"selection",required:!1,reason:"Enables copy/paste of selected cells instead of entire grid"}];name="clipboard";get defaultConfig(){return{includeHeaders:!1,delimiter:"\t",newline:"\n",quoteStrings:!1}}lastCopied=null;attach(e){super.attach(e),e.addEventListener("paste",e=>this.#t(e),{signal:this.disconnectSignal})}detach(){this.lastCopied=null}onKeyDown(e){return!(!e.ctrlKey&&!e.metaKey||"c"!==e.key)&&(e.preventDefault(),this.#n(e.target),!0)}#n(e){const t=this.#r();if(t&&0===t.ranges.length){const t=this.#i(e);if(!t)return;const n=this.columns[t.col];if(!n)return;return void this.copy({rowIndices:[t.row],columns:[n.field]})}this.copy()}#t(e){const t=e.clipboardData?.getData("text/plain");if(!t)return;e.preventDefault();const n=a(t,this.config),r=this.#r(),i=r?.ranges?.[0],o=i?.from.row??0,s=i?.from.col??0,l=i&&("range"===r?.mode||"row"===r?.mode)&&(i.from.row!==i.to.row||i.from.col!==i.to.col)?{endRow:i.to.row,endCol:i.to.col}:null,c=l?.endCol??this.visibleColumns.length-1,d=this.visibleColumns[s],u=d?{row:o,col:s,field:d.field,bounds:l}:null,h=[],g=n[0]?.length??0;for(let a=0;a<g&&s+a<=c;a++){const e=this.visibleColumns[s+a];e&&h.push(e.field)}const f={rows:n,text:t,target:u,fields:h};this.emit("paste",f),this.#o(f)}#o(e){if(!this.grid)return;const{pasteHandler:t}=this.config;if(null===t)return;(t??c)(e,this.grid)}#r(){const e=this.grid?.query("getSelection");return e?.[0]}#s(e){const t=this.#r();let n,r;if(e?.columns)n=o(this.columns,e.columns);else if(t?.ranges.length&&"row"!==t.mode){const e=t.ranges[t.ranges.length-1],r=Math.min(e.from.col,e.to.col),i=Math.max(e.from.col,e.to.col);n=o(this.visibleColumns.slice(r,i+1))}else n=o(this.columns);if(e?.rowIndices)r=function(e,t){return t?.length?[...t].sort((e,t)=>e-t).map(t=>e[t]).filter(e=>null!=e):e}(this.rows,e.rowIndices);else if(t?.ranges.length){const e=t.ranges[t.ranges.length-1],n=Math.min(e.from.row,e.to.row),i=Math.max(e.from.row,e.to.row);r=[];for(let t=n;t<=i;t++){const e=this.rows[t];e&&r.push(e)}}else r=this.rows;return{columns:n,rows:r}}#l(e,t,n){const r=n?.delimiter??this.config.delimiter??"\t",i=n?.newline??this.config.newline??"\n",o=n?.includeHeaders??this.config.includeHeaders??!1,l=n?.processCell??this.config.processCell,a=[];o&&a.push(e.map(e=>e.header||e.field).join(r));for(const c of t){const t=e.map(e=>{const t=c[e.field];return l?l(t,e.field,c):s(t)});a.push(t.join(r))}return a.join(i)}#i(e){const t=e.closest("[data-field-cache]");if(!t)return null;const n=t.dataset.fieldCache,r=t.dataset.row;if(!n||!r)return null;const i=parseInt(r,10);if(isNaN(i))return null;const o=this.columns.findIndex(e=>e.field===n);return-1===o?null:{row:i,col:o}}getSelectionAsText(e){const{columns:t,rows:n}=this.#s(e);return 0===t.length||0===n.length?"":this.#l(t,n,e)}async copy(e){const{columns:t,rows:n}=this.#s(e);if(0===t.length||0===n.length)return"";const r=this.#l(t,n,e);return await l(r),this.lastCopied={text:r,timestamp:Date.now()},this.emit("copy",{text:r,rowCount:n.length,columnCount:t.length}),r}async copyRows(e,t){return 0===e.length?"":this.copy({...t,rowIndices:e})}async paste(){const e=await async function(){try{return await navigator.clipboard.readText()}catch{return""}}();return e?a(e,this.config):null}getLastCopied(){return this.lastCopied}}export{d as ClipboardPlugin,c as defaultPasteHandler};
 //# sourceMappingURL=index.js.map