@toolbox-web/grid 2.3.0 → 2.4.0

package/lib/core/grid.d.ts

@@ -1,3 +1,4 @@
+import { RenderPhase } from './internal/render-scheduler';
 import { ShellState } from './internal/shell';
 import { AfterCellRenderContext, AfterRowRenderContext, CellMouseEvent } from './plugin';
 import { BaseGridPlugin } from './plugin/base-plugin';
@@ -511,7 +512,7 @@ export declare class DataGridElement<T = any> extends HTMLElement implements Int
     /** Updates ARIA row/col counts. Delegates to aria.ts module. */
     _updateAriaCounts(rowCount: number, colCount: number): void;
     /** @internal Request a render at the given phase through the scheduler. */
-    _requestSchedulerPhase(phase: number, source: string): void;
+    _requestSchedulerPhase(phase: RenderPhase, source: string): void;
     /** @internal Plugin-specific row height override. */
     _getPluginRowHeight(row: T, index: number): number | undefined;
     /** @internal Let plugins adjust the virtual start index backwards. */

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

@@ -64,8 +64,12 @@ export declare const MISSING_DEPENDENCY: "TBW020";
 export declare const OPTIONAL_DEPENDENCY: "TBW021";
 /** Two loaded plugins are incompatible. */
 export declare const INCOMPATIBLE_PLUGINS: "TBW022";
+/** Two plugin instances resolve to the same canonical name (alias collapse). */
+export declare const PLUGIN_ALIAS_COLLAPSE: "TBW023";
 /** Error thrown inside a plugin event handler. */
 export declare const PLUGIN_EVENT_ERROR: "TBW024";
+/** Conflicting config values found while merging alias-collapsed plugin instances. */
+export declare const PLUGIN_ALIAS_CONFIG_CONFLICT: "TBW025";
 /** Feature was re-registered (overwritten). */
 export declare const FEATURE_REREGISTERED: "TBW030";
 /** Feature configured but not imported. */
@@ -136,7 +140,7 @@ export declare const DATASOURCE_CHILD_FETCH_ERROR: "TBW141";
 export declare const DATASOURCE_NO_CHILD_HANDLER: "TBW142";
 /** ServerSidePlugin: concurrent request limit reached, request deferred. */
 export declare const DATASOURCE_THROTTLED: "TBW143";
-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 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 | typeof DATASOURCE_FETCH_ERROR | typeof DATASOURCE_CHILD_FETCH_ERROR | typeof DATASOURCE_NO_CHILD_HANDLER | typeof DATASOURCE_THROTTLED;
+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 PLUGIN_ALIAS_COLLAPSE | typeof PLUGIN_EVENT_ERROR | typeof PLUGIN_ALIAS_CONFIG_CONFLICT | 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 | typeof DATASOURCE_FETCH_ERROR | typeof DATASOURCE_CHILD_FETCH_ERROR | typeof DATASOURCE_NO_CHILD_HANDLER | typeof DATASOURCE_THROTTLED;
 /**
  * Format a diagnostic message with prefix, code, and docs link.
  *

package/lib/core/internal/dom-builder.d.ts

@@ -8,31 +8,6 @@
  *
  * Benchmark: DOM construction is ~2-3x faster than innerHTML for complex structures.
  */
-/**
- * Create an element with attributes and optional children.
- * Optimized helper that avoids repeated function calls.
- */
-export declare function createElement<K extends keyof HTMLElementTagNameMap>(tag: K, attrs?: Record<string, string>, children?: (Node | string | null | undefined)[]): HTMLElementTagNameMap[K];
-/**
- * Create a text node (shorthand).
- */
-export declare function text(content: string): Text;
-/**
- * Create an element with class (common pattern).
- */
-export declare function div(className?: string, attrs?: Record<string, string>): HTMLDivElement;
-/**
- * Create a button element.
- */
-export declare function button(className?: string, attrs?: Record<string, string>, content?: string | Node): HTMLButtonElement;
-/**
- * Append multiple children to a parent element.
- */
-export declare function appendChildren(parent: Element, children: (Node | null | undefined)[]): void;
-/**
- * Set multiple attributes on an element.
- */
-export declare function setAttrs(el: Element, attrs: Record<string, string | undefined>): void;
 /**
  * Clone the grid content structure.
  * Using template cloning is faster than createElement for nested structures.

package/lib/core/internal/drag-drop-registry.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Drag-Drop Registry
+ *
+ * Module-level singleton that holds live (WeakRef) references to row objects
+ * being dragged across grids in the same JS heap. Used by `RowDragDropPlugin`
+ * to recover live references on drop, avoiding any serialization cost when
+ * source and target grids share a heap.
+ *
+ * Lives in `core/internal/` (not in the plugin bundle) so that two copies of
+ * `@toolbox-web/grid` loaded via different entry points (e.g. `/all` vs
+ * per-plugin imports) cannot end up with two separate registries that silently
+ * fall back to JSON.
+ *
+ * Cross-window / cross-origin-iframe drags do NOT go through this registry —
+ * they fall back to `dataTransfer` JSON.
+ *
+ * @internal
+ */
+/**
+ * Register a drag session's live row references.
+ *
+ * Object rows are stored as `WeakRef<object>`; primitive rows cannot be held
+ * weakly and would either need a sentinel (which corrupts the row value on
+ * recovery) or be omitted (which misaligns indices). We instead flag the
+ * session as containing primitives — `lookupDragSession()` then returns
+ * `undefined` so callers fall back to the JSON payload, which round-trips
+ * primitives losslessly.
+ *
+ * @param sessionId - Unique drag session identifier (typically a UUID).
+ * @param rows      - Rows being dragged.
+ * @param meta      - Optional opaque metadata to associate with the session.
+ */
+export declare function registerDragSession(sessionId: string, rows: readonly unknown[], meta?: unknown): void;
+/**
+ * Look up the live row references for a drag session.
+ *
+ * Returns `undefined` when the caller MUST fall back to the JSON payload:
+ *   - the session is unknown,
+ *   - any registered reference has been garbage-collected (partial recovery
+ *     would silently corrupt cross-grid moves), or
+ *   - the session contains primitive rows (which cannot be held weakly).
+ */
+export declare function lookupDragSession<T = unknown>(sessionId: string): T[] | undefined;
+/**
+ * Get the metadata associated with a drag session, if any.
+ */
+export declare function getDragSessionMeta<M = unknown>(sessionId: string): M | undefined;
+/**
+ * Clear a drag session from the registry.
+ * Should be called from `dragend` on the source grid.
+ */
+export declare function clearDragSession(sessionId: string): void;
+/**
+ * @internal Test-only — clear all sessions.
+ */
+export declare function _clearAllDragSessions(): void;
+/**
+ * Generate a unique drag session identifier.
+ *
+ * Used as a Map key to recover live row references for in-process drags; this
+ * is **not** a security context. Uses `crypto.randomUUID()` when available
+ * (modern browsers in secure contexts, Node 19+, Bun) and falls back to
+ * `crypto.getRandomValues()` for older non-secure contexts. `Math.random()`
+ * is intentionally avoided to keep CodeQL clean.
+ */
+export declare function newDragSessionId(): string;

package/lib/core/internal/render-scheduler.d.ts

@@ -5,20 +5,21 @@ import { InternalGrid } from '../types';
  *
  * @category Plugin Development
  */
-export declare enum RenderPhase {
+export declare const RenderPhase: {
     /** Lightweight style updates only (plugin afterRender hooks) */
-    STYLE = 1,
+    readonly STYLE: 1;
     /** Virtual window recalculation (includes STYLE) */
-    VIRTUALIZATION = 2,
+    readonly VIRTUALIZATION: 2;
     /** Header re-render (includes VIRTUALIZATION) */
-    HEADER = 3,
+    readonly HEADER: 3;
     /** Row model rebuild (includes HEADER) */
-    ROWS = 4,
+    readonly ROWS: 4;
     /** Column processing (includes ROWS) */
-    COLUMNS = 5,
+    readonly COLUMNS: 5;
     /** Full render including config merge (includes COLUMNS) */
-    FULL = 6
-}
+    readonly FULL: 6;
+};
+export type RenderPhase = (typeof RenderPhase)[keyof typeof RenderPhase];
 /**
  * @internal Scheduler now takes InternalGrid directly — no callback interface needed.
  */

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

@@ -368,6 +368,29 @@ export declare abstract class BaseGridPlugin<TConfig = unknown> implements GridP
      */
     protected get defaultConfig(): Partial<TConfig>;
     constructor(config?: Partial<TConfig>);
+    /**
+     * Merge user-supplied configuration from other plugin instances into this
+     * plugin's `userConfig`. Used by `PluginManager.attachAll()`'s alias-collapse
+     * pre-pass: when a consumer instantiates the same plugin under multiple
+     * names (e.g. `RowReorderPlugin` and `RowDragDropPlugin`, which are aliases
+     * after V2.x), only one instance is attached, and the other instances'
+     * configs are folded in via this method.
+     *
+     * Merge rules (shallow):
+     *
+     * - Same key, **same value** → silent.
+     * - Same key, **different values** (incl. function vs function) → throws
+     *   a diagnostic naming the conflicting key. Conflicting callbacks
+     *   (`canDrag`, `canDrop`, etc.) cannot be reconciled automatically.
+     * - **Disjoint keys** → merged cleanly.
+     *
+     * Subclasses may override to implement custom deep-merge logic, but should
+     * call `super.mergeConfigsFrom(others)` to inherit the conflict-detection.
+     *
+     * @internal Plugin infrastructure (used by `PluginManager.attachAll`).
+     * @throws Error with diagnostic code `TBW025` when configs conflict.
+     */
+    mergeConfigsFrom(others: readonly BaseGridPlugin<TConfig>[]): void;
     /**
      * Called when the plugin is attached to a grid.
      * Override to set up event listeners, initialize state, etc.

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

@@ -43,6 +43,15 @@ export declare class PluginManager {
     constructor(grid: GridElement);
     /**
      * Attach all plugins from the config.
+     *
+     * Runs an alias-collapse pre-pass before per-instance attach: when multiple
+     * plugin instances resolve to the same canonical constructor (e.g.
+     * `RowReorderPlugin` and `RowDragDropPlugin`, which point to the same class
+     * after V2.x), only the first instance is attached, and the others' user
+     * configs are folded into it via `BaseGridPlugin.mergeConfigsFrom()`.
+     *
+     * Skipped duplicates trigger a one-time `console.warn` with diagnostic code
+     * `TBW023` (suppressed in production builds via `import.meta.env.PROD`).
      */
     attachAll(plugins: BaseGridPlugin[]): void;
     /**

package/lib/core/types.d.ts

@@ -1,3 +1,4 @@
+import { RenderPhase } from './internal/render-scheduler';
 import { ShellState } from './internal/shell';
 import { RowPosition } from './internal/virtualization';
 import { AfterCellRenderContext, AfterRowRenderContext, CellMouseEvent } from './plugin/types';
@@ -557,7 +558,7 @@ export interface InternalGrid<T = any> extends PublicGrid<T>, GridConfig<T> {
     _invalidateVisibleColumnsCache(): void;
     /** @internal */ _renderVisibleRows(start: number, end: number, epoch?: number): void;
     /** @internal */ _updateAriaCounts(totalRows: number, totalCols: number): void;
-    /** @internal */ _requestSchedulerPhase(phase: number, source: string): void;
+    /** @internal */ _requestSchedulerPhase(phase: RenderPhase, source: string): void;
     /** @internal */ _rebuildRowIdMap(): void;
     /** @internal */ _emitDataChange(): void;
     /** @internal */ _getPluginRowHeight(row: T, index: number): number | undefined;
@@ -1922,16 +1923,24 @@ export interface RowGroupRenderConfig {
  * - A built-in aggregator name: `'sum'`, `'avg'`, `'min'`, `'max'`, `'count'`
  * - A custom function that calculates the aggregate value
  *
+ * Aggregators are not declared on a column directly — they are configured per
+ * field on the consumer (e.g. {@link RowGroupRenderConfig.aggregators} for
+ * group rows, keyed by column field name).
+ *
  * @example
  * ```typescript
- * // Built-in aggregator
- * { field: 'amount', aggregator: 'sum' }
+ * // Built-in aggregator on a group row config
+ * { aggregators: { amount: 'sum' } }
  *
  * // Custom aggregator function
- * { field: 'price', aggregator: (rows, field) => {
- *   const values = rows.map(r => r[field]).filter(v => v != null);
- *   return values.length ? Math.max(...values) : null;
- * }}
+ * {
+ *   aggregators: {
+ *     price: (rows, field) => {
+ *       const values = rows.map((r) => (r as any)[field]).filter((v) => v != null);
+ *       return values.length ? Math.max(...values as number[]) : null;
+ *     },
+ *   },
+ * }
  * ```
  *
  * @see {@link RowGroupRenderConfig} for using aggregators in group rows
@@ -2367,32 +2376,46 @@ export interface GridConfig<TRow = any> {
      */
     animation?: AnimationConfig;
     /**
-     * Custom sort handler for full control over sorting behavior.
+     * Custom sort handler for the entire grid.
+     *
+     * :::caution
+     * **Prefer {@link BaseColumnConfig.sortComparator} over `sortHandler`.**
      *
-     * When provided, this handler is called instead of the built-in sorting logic.
-     * Enables custom sorting algorithms, server-side sorting, or plugin-specific sorting.
+     * `sortHandler` is a low-level escape hatch with significant limitations:
+     * - Only consulted by the **single-column** sort path (core header click,
+     *   `TreePlugin` per-level sort, `ServerSidePlugin` `sortMode: 'local'`).
+     * - **Bypassed entirely** when `MultiSortPlugin` is loaded.
+     * - Owns ALL columns at once — your handler must implement field/direction
+     *   dispatch and null handling for every sortable column itself.
+     *
+     * For per-column custom sort logic, use {@link BaseColumnConfig.sortComparator}
+     * instead. It is honored by every sort code path in the grid (core, multi-sort,
+     * tree, server-side) and is composable across columns.
+     *
+     * For server-side sort, prefer {@link ServerSideConfig.dataSource} — the
+     * `sortModel` is shipped to your `getRows` handler so the backend can return
+     * pre-sorted blocks.
+     * :::
+     *
+     * Use `sortHandler` only when you need to replace the grid's sort engine
+     * wholesale (e.g. integrating a third-party sort library that operates on
+     * the full row array, or routing every sort through a single async pipeline).
      *
      * The handler receives:
      * - `rows`: Current row array to sort
      * - `sortState`: Sort field and direction (1 = asc, -1 = desc)
      * - `columns`: Column configurations (for accessing sortComparator)
      *
-     * Return the sorted array (sync) or a Promise that resolves to the sorted array (async).
-     * For server-side sorting, return a Promise that resolves when data is fetched.
+     * Return the sorted array (sync) or a Promise that resolves to it (async).
      *
      * @example
      * ```ts
-     * // Custom stable sort
-     * sortHandler: (rows, state, cols) => {
-     *   return stableSort(rows, (a, b) => compare(a[state.field], b[state.field]) * state.direction);
-     * }
-     *
-     * // Server-side sorting
-     * sortHandler: async (rows, state) => {
-     *   const response = await fetch(`/api/data?sort=${state.field}&dir=${state.direction}`);
-     *   return response.json();
-     * }
+     * // Replace the entire client-side sort engine with a custom stable sort
+     * sortHandler: (rows, state) => stableSort(rows, state.field, state.direction);
      * ```
+     *
+     * @see {@link BaseColumnConfig.sortComparator} — recommended per-column override
+     * @see {@link ServerSideConfig.dataSource} — recommended server-side sort path
      */
     sortHandler?: SortHandler<TRow>;
     /**
@@ -2572,8 +2595,17 @@ export interface SortState {
 /**
  * Custom sort handler function signature.
  *
- * Enables full control over sorting behavior including server-side sorting,
- * custom algorithms, or multi-column sorting.
+ * :::caution
+ * **Prefer {@link BaseColumnConfig.sortComparator} over `SortHandler`.**
+ * `sortHandler` is bypassed by `MultiSortPlugin` and only sees the single
+ * active sort field. For per-column custom sort logic that survives every
+ * sort code path (core, multi-sort, tree, server-side), set `sortComparator`
+ * on the relevant columns instead. For server-side sort, use
+ * {@link ServerSideConfig.dataSource}.
+ * :::
+ *
+ * Use `SortHandler` only when you need to replace the grid's sort engine
+ * wholesale.
  *
  * @param rows - Current row array to sort
  * @param sortState - Sort field and direction
@@ -2582,32 +2614,17 @@ export interface SortState {
  *
  * @example
  * ```typescript
- * // Custom client-side sort with locale awareness
- * const localeSortHandler: SortHandler<Employee> = (rows, state, cols) => {
- *   const col = cols.find(c => c.field === state.field);
- *   return [...rows].sort((a, b) => {
- *     const aVal = String(a[state.field] ?? '');
- *     const bVal = String(b[state.field] ?? '');
- *     return aVal.localeCompare(bVal) * state.direction;
- *   });
+ * // Replace the built-in sort with a third-party stable sort library
+ * const customSortHandler: SortHandler<Employee> = (rows, state) => {
+ *   return thirdPartyStableSort(rows, state.field, state.direction);
  * };
  *
- * // Server-side sorting
- * const serverSortHandler: SortHandler<Employee> = async (rows, state) => {
- *   const response = await fetch(
- *     `/api/employees?sortBy=${state.field}&dir=${state.direction}`
- *   );
- *   return response.json();
- * };
- *
- * grid.gridConfig = {
- *   sortHandler: localeSortHandler,
- * };
+ * grid.gridConfig = { sortHandler: customSortHandler };
  * ```
  *
  * @see {@link SortState} for the sort state object
- * @see {@link GridConfig.sortHandler} for configuring the handler
- * @see {@link BaseColumnConfig.sortComparator} for column-level comparators
+ * @see {@link GridConfig.sortHandler} for configuring the handler (and its caveats)
+ * @see {@link BaseColumnConfig.sortComparator} — recommended per-column comparator
  */
 export type SortHandler<TRow = any> = (rows: TRow[], sortState: SortState, columns: ColumnConfig<TRow>[]) => TRow[] | Promise<TRow[]>;
 /**
@@ -3115,7 +3132,11 @@ export interface GridIcons {
     /** Print icon for print button. Default: '🖨️' */
     print?: IconValue;
 }
-/** Default icons used when not overridden */
+/** Default icons used when not overridden. Most entries are short text/emoji;
+ * `filter` and `filterActive` are empty strings because the actual rendering
+ * is driven by the `--tbw-icon-filter[-active]-mask` CSS custom properties
+ * (see `core/styles/variables.css`). Userland that wants an HTML/SVG fallback
+ * via `gridConfig.icons.filter = '<svg…>'` is unaffected — that path overrides this default. */
 export declare const DEFAULT_GRID_ICONS: Required<GridIcons>;
 /**
  * Shell configuration for the grid's optional header bar and tool panels.

package/lib/features/registry.js.map

@@ -1 +1 @@
-{"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/** 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\n// --- DataSource / ServerSide (140–149) ---\n/** ServerSidePlugin: getRows() rejected. */\nexport const DATASOURCE_FETCH_ERROR = 'TBW140' as const;\n/** ServerSidePlugin: getChildRows() rejected. */\nexport const DATASOURCE_CHILD_FETCH_ERROR = 'TBW141' as const;\n/** ServerSidePlugin: getChildRows() not implemented but a plugin queried for children. */\nexport const DATASOURCE_NO_CHILD_HANDLER = 'TBW142' as const;\n/** ServerSidePlugin: concurrent request limit reached, request deferred. */\nexport const DATASOURCE_THROTTLED = 'TBW143' 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 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  | typeof DATASOURCE_FETCH_ERROR\n  | typeof DATASOURCE_CHILD_FETCH_ERROR\n  | typeof DATASOURCE_NO_CHILD_HANDLER\n  | typeof DATASOURCE_THROTTLED;\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 a debug message with a diagnostic code and docs link.\n * Use for optional/soft dependency notifications — visible only when\n * the browser DevTools \"Verbose\" log level is enabled.\n */\nexport function debugDiagnostic(code: DiagnosticCode, message: string, gridId?: string, pluginName?: string): void {\n  console.debug(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 * 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 * - 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  // Collect enabled feature names\n  for (const [key, value] of Object.entries(features)) {\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 = features[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","createPluginFromFeature","config","entry","add","kebab","replace","createPluginsFromFeatures","features","plugins","enabledFeatures","key","value","Object","entries","push","featureNames","featureSet","feature","deps","dep","validateDependencies","dependencyOrder","filter","f","orderedFeatures","includes","featureName","plugin","clearFeatureRegistry","clear","setFeatureResolver"],"mappings":"uDA8QO,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,CC5NA,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,EDYgC,SCZK,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,cAOP,SAASC,EAAwBd,EAAce,GACpD,MAAMC,EAAQzB,EAAgBe,IAAIN,GAElC,GAAKgB,EAcL,OAAOA,EAAMf,QAAQc,GAbnB,GAAIpB,MAAYF,EAAeS,IAAIF,GAAO,CACxCP,EAAewB,IAAIjB,GACnB,MAAMkB,EAAQlB,EAAKmB,QAAQ,kBAAmB,SAAS/B,cACvDP,EDpC8B,SCsC5B,YAAYmB,+GAE8BkB,QAE9C,CAKJ,CAoCO,SAASE,EAA0BC,GACxC,MAAMC,EAAwB,GACxBC,EAA4B,GAGlC,IAAA,MAAYC,EAAKC,KAAUC,OAAOC,QAAQN,QAC1B,IAAVI,IAAiC,IAAVA,GAC3BF,EAAgBK,KAAKJ,IAtCzB,SAA8BK,GAC5B,MAAMC,EAAa,IAAIpC,IAAImC,GAE3B,IAAA,MAAWE,KAAWF,EAAc,CAClC,MAAMG,EAAOrB,EAAoBoB,GACjC,GAAKC,EAEL,IAAA,MAAWC,KAAOD,EACXF,EAAW5B,IAAI+B,IACdtC,KACFd,ED5DyB,SC8DvB,YAAYkD,gBAAsBE,0BAAiCA,qCAK7E,CACF,CAwBEC,CAAqBX,GAGrB,MAAMY,EAA4B,CAChC,YACA,aACGZ,EAAgBa,OAAQC,GAAY,cAANA,GAA2B,YAANA,IAElDC,EAAkB,IAAI,IAAI5C,IAAIyC,IAAkBC,OAAQC,GAAMd,EAAgBgB,SAASF,IAE7F,IAAA,MAAWG,KAAeF,EAAiB,CACzC,MAAMvB,EAASM,EAASmB,GACxB,QAAe,IAAXzB,IAAmC,IAAXA,EAAkB,SAE9C,MAAM0B,EAAS3B,EAAwB0B,EAAazB,GAChD0B,GACFnB,EAAQM,KAAKa,EAEjB,CAEA,OAAOnB,CACT,CAkBO,SAASoB,IACdnD,EAAgBoD,QAChBlD,EAAekD,OACjB,CAbAC,EAAmBxB"}
+{"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/** Two plugin instances resolve to the same canonical name (alias collapse). */\nexport const PLUGIN_ALIAS_COLLAPSE = 'TBW023' as const;\n/** Error thrown inside a plugin event handler. */\nexport const PLUGIN_EVENT_ERROR = 'TBW024' as const;\n/** Conflicting config values found while merging alias-collapsed plugin instances. */\nexport const PLUGIN_ALIAS_CONFIG_CONFLICT = 'TBW025' 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\n// --- DataSource / ServerSide (140–149) ---\n/** ServerSidePlugin: getRows() rejected. */\nexport const DATASOURCE_FETCH_ERROR = 'TBW140' as const;\n/** ServerSidePlugin: getChildRows() rejected. */\nexport const DATASOURCE_CHILD_FETCH_ERROR = 'TBW141' as const;\n/** ServerSidePlugin: getChildRows() not implemented but a plugin queried for children. */\nexport const DATASOURCE_NO_CHILD_HANDLER = 'TBW142' as const;\n/** ServerSidePlugin: concurrent request limit reached, request deferred. */\nexport const DATASOURCE_THROTTLED = 'TBW143' 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 PLUGIN_ALIAS_COLLAPSE\n  | typeof PLUGIN_EVENT_ERROR\n  | typeof PLUGIN_ALIAS_CONFIG_CONFLICT\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  | typeof DATASOURCE_FETCH_ERROR\n  | typeof DATASOURCE_CHILD_FETCH_ERROR\n  | typeof DATASOURCE_NO_CHILD_HANDLER\n  | typeof DATASOURCE_THROTTLED;\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 a debug message with a diagnostic code and docs link.\n * Use for optional/soft dependency notifications — visible only when\n * the browser DevTools \"Verbose\" log level is enabled.\n */\nexport function debugDiagnostic(code: DiagnosticCode, message: string, gridId?: string, pluginName?: string): void {\n  console.debug(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 * 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 * - 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  // Collect enabled feature names\n  for (const [key, value] of Object.entries(features)) {\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 = features[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","createPluginFromFeature","config","entry","add","kebab","replace","createPluginsFromFeatures","features","plugins","enabledFeatures","key","value","Object","entries","push","featureNames","featureSet","feature","deps","dep","validateDependencies","dependencyOrder","filter","f","orderedFeatures","includes","featureName","plugin","clearFeatureRegistry","clear","setFeatureResolver"],"mappings":"uDAoRO,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,CClOA,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,EDgBgC,SChBK,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,cAOP,SAASC,EAAwBd,EAAce,GACpD,MAAMC,EAAQzB,EAAgBe,IAAIN,GAElC,GAAKgB,EAcL,OAAOA,EAAMf,QAAQc,GAbnB,GAAIpB,MAAYF,EAAeS,IAAIF,GAAO,CACxCP,EAAewB,IAAIjB,GACnB,MAAMkB,EAAQlB,EAAKmB,QAAQ,kBAAmB,SAAS/B,cACvDP,EDhC8B,SCkC5B,YAAYmB,+GAE8BkB,QAE9C,CAKJ,CAoCO,SAASE,EAA0BC,GACxC,MAAMC,EAAwB,GACxBC,EAA4B,GAGlC,IAAA,MAAYC,EAAKC,KAAUC,OAAOC,QAAQN,QAC1B,IAAVI,IAAiC,IAAVA,GAC3BF,EAAgBK,KAAKJ,IAtCzB,SAA8BK,GAC5B,MAAMC,EAAa,IAAIpC,IAAImC,GAE3B,IAAA,MAAWE,KAAWF,EAAc,CAClC,MAAMG,EAAOrB,EAAoBoB,GACjC,GAAKC,EAEL,IAAA,MAAWC,KAAOD,EACXF,EAAW5B,IAAI+B,IACdtC,KACFd,EDxDyB,SC0DvB,YAAYkD,gBAAsBE,0BAAiCA,qCAK7E,CACF,CAwBEC,CAAqBX,GAGrB,MAAMY,EAA4B,CAChC,YACA,aACGZ,EAAgBa,OAAQC,GAAY,cAANA,GAA2B,YAANA,IAElDC,EAAkB,IAAI,IAAI5C,IAAIyC,IAAkBC,OAAQC,GAAMd,EAAgBgB,SAASF,IAE7F,IAAA,MAAWG,KAAeF,EAAiB,CACzC,MAAMvB,EAASM,EAASmB,GACxB,QAAe,IAAXzB,IAAmC,IAAXA,EAAkB,SAE9C,MAAM0B,EAAS3B,EAAwB0B,EAAazB,GAChD0B,GACFnB,EAAQM,KAAKa,EAEjB,CAEA,OAAOnB,CACT,CAkBO,SAASoB,IACdnD,EAAgBoD,QAChBlD,EAAekD,OACjB,CAbAC,EAAmBxB"}

package/lib/features/reorder-rows.d.ts

@@ -1,8 +1,8 @@
-import { RowReorderConfig } from '../plugins/reorder-rows';
+import { RowDragDropConfig } from '../plugins/row-drag-drop';
 declare module '../core/types' {
     interface FeatureConfig {
-        /** Enable row drag-to-reorder. */
-        reorderRows?: boolean | RowReorderConfig;
+        /** @deprecated Use `rowDragDrop`. Forwarded to the same underlying plugin. */
+        reorderRows?: boolean | RowDragDropConfig;
     }
 }
 /** @internal Type anchor — forces bundlers to preserve this module's FeatureConfig augmentation when re-exported. */

package/lib/features/reorder-rows.js

@@ -1,2 +1,2 @@
-import{RowReorderPlugin as r}from"@toolbox-web/grid/plugins/reorder-rows";import{registerFeature as o}from"@toolbox-web/grid/features/registry";o("reorderRows",o=>!0===o?new r:new r(o??void 0));
+import{RowDragDropPlugin as o}from"@toolbox-web/grid/plugins/row-drag-drop";import{registerFeature as r}from"@toolbox-web/grid/features/registry";r("reorderRows",r=>!0===r?new o:new o(r??void 0));
 //# sourceMappingURL=reorder-rows.js.map

package/lib/features/reorder-rows.js.map

@@ -1 +1 @@
-{"version":3,"file":"reorder-rows.js","sources":["../../../../../libs/grid/src/lib/features/reorder-rows.ts"],"sourcesContent":["/**\n * Row Reorder feature for @toolbox-web/grid\n *\n * @example\n * ```typescript\n * import '@toolbox-web/grid/features/reorder-rows';\n *\n * grid.gridConfig = { features: { reorderRows: true } };\n * ```\n */\n\nimport { RowReorderPlugin, type RowReorderConfig } from '../plugins/reorder-rows';\nimport { registerFeature } from './registry';\n\ndeclare module '../core/types' {\n  interface FeatureConfig {\n    /** Enable row drag-to-reorder. */\n    reorderRows?: boolean | RowReorderConfig;\n  }\n}\n\nconst factory = (config: unknown) => {\n  if (config === true) {\n    return new RowReorderPlugin();\n  }\n  return new RowReorderPlugin((config as RowReorderConfig) ?? undefined);\n};\n\nregisterFeature('reorderRows', factory);\n\n/** @internal Type anchor — forces bundlers to preserve this module's FeatureConfig augmentation when re-exported. */\nexport type _Augmentation = true;\n"],"names":["registerFeature","config","RowReorderPlugin"],"mappings":"gJA4BAA,EAAgB,cAPCC,IACA,IAAXA,EACK,IAAIC,EAEN,IAAIA,EAAkBD,QAA+B"}
+{"version":3,"file":"reorder-rows.js","sources":["../../../../../libs/grid/src/lib/features/reorder-rows.ts"],"sourcesContent":["/**\n * Row Reorder feature (deprecated alias for `rowDragDrop`).\n *\n * `RowReorderPlugin` is now an alias of `RowDragDropPlugin`. This feature\n * module forwards to the new plugin so existing\n * `import '@toolbox-web/grid/features/reorder-rows'` calls keep working.\n *\n * @example\n * ```typescript\n * import '@toolbox-web/grid/features/reorder-rows';\n *\n * grid.gridConfig = { features: { reorderRows: true } };\n * ```\n *\n * @deprecated Use `@toolbox-web/grid/features/row-drag-drop` and the\n * `rowDragDrop` feature key. This module will be removed in V3.\n */\n\nimport { RowDragDropPlugin, type RowDragDropConfig } from '../plugins/row-drag-drop';\nimport { registerFeature } from './registry';\n\ndeclare module '../core/types' {\n  interface FeatureConfig {\n    /** @deprecated Use `rowDragDrop`. Forwarded to the same underlying plugin. */\n    reorderRows?: boolean | RowDragDropConfig;\n  }\n}\n\nconst factory = (config: unknown) => {\n  if (config === true) return new RowDragDropPlugin();\n  return new RowDragDropPlugin((config as RowDragDropConfig) ?? undefined);\n};\n\nregisterFeature('reorderRows', factory);\n\n/** @internal Type anchor — forces bundlers to preserve this module's FeatureConfig augmentation when re-exported. */\nexport type _Augmentation = true;\n"],"names":["registerFeature","config","RowDragDropPlugin"],"mappings":"kJAiCAA,EAAgB,cALCC,IACA,IAAXA,EAAwB,IAAIC,EACzB,IAAIA,EAAmBD,QAAgC"}

package/lib/features/row-drag-drop.d.ts

@@ -0,0 +1,9 @@
+import { RowDragDropConfig } from '../plugins/row-drag-drop';
+declare module '../core/types' {
+    interface FeatureConfig {
+        /** Enable row drag-drop (intra-grid + optional cross-grid via `dropZone`). */
+        rowDragDrop?: boolean | RowDragDropConfig;
+    }
+}
+/** @internal Type anchor — forces bundlers to preserve this module's FeatureConfig augmentation when re-exported. */
+export type _Augmentation = true;

package/lib/features/row-drag-drop.js

@@ -0,0 +1,2 @@
+import{RowDragDropPlugin as o}from"@toolbox-web/grid/plugins/row-drag-drop";import{registerFeature as r}from"@toolbox-web/grid/features/registry";r("rowDragDrop",r=>!0===r?new o:new o(r??void 0));
+//# sourceMappingURL=row-drag-drop.js.map

package/lib/features/row-drag-drop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"row-drag-drop.js","sources":["../../../../../libs/grid/src/lib/features/row-drag-drop.ts"],"sourcesContent":["/**\n * Row Drag-Drop feature for @toolbox-web/grid\n *\n * Drag rows within a single grid and (with `dropZone`) between grids.\n *\n * @example\n * ```typescript\n * import '@toolbox-web/grid/features/row-drag-drop';\n *\n * grid.gridConfig = { features: { rowDragDrop: { dropZone: 'tasks' } } };\n * ```\n */\n\nimport { RowDragDropPlugin, type RowDragDropConfig } from '../plugins/row-drag-drop';\nimport { registerFeature } from './registry';\n\ndeclare module '../core/types' {\n  interface FeatureConfig {\n    /** Enable row drag-drop (intra-grid + optional cross-grid via `dropZone`). */\n    rowDragDrop?: boolean | RowDragDropConfig;\n  }\n}\n\nconst factory = (config: unknown) => {\n  if (config === true) {\n    return new RowDragDropPlugin();\n  }\n  return new RowDragDropPlugin((config as RowDragDropConfig) ?? undefined);\n};\n\nregisterFeature('rowDragDrop', factory);\n\n/** @internal Type anchor — forces bundlers to preserve this module's FeatureConfig augmentation when re-exported. */\nexport type _Augmentation = true;\n"],"names":["registerFeature","config","RowDragDropPlugin"],"mappings":"kJA8BAA,EAAgB,cAPCC,IACA,IAAXA,EACK,IAAIC,EAEN,IAAIA,EAAmBD,QAAgC"}

package/lib/features/server-side.js.map

@@ -1 +1 @@
-{"version":3,"file":"server-side.js","sources":["../../../../../libs/grid/src/lib/features/server-side.ts"],"sourcesContent":["/**\n * Server-Side feature for @toolbox-web/grid\n *\n * @example\n * ```typescript\n * import '@toolbox-web/grid/features/server-side';\n *\n * grid.gridConfig = { features: { serverSide: { fetchRows: async (params) => ... } } };\n * ```\n */\n\nimport { ServerSidePlugin, type ServerSideConfig } from '../plugins/server-side';\nimport { registerFeature } from './registry';\n\ndeclare module '../core/types' {\n  interface FeatureConfig {\n    /** Enable server-side data fetching, sorting, filtering, etc. */\n    serverSide?: ServerSideConfig;\n  }\n}\n\nregisterFeature('serverSide', (config) => {\n  return new ServerSidePlugin((config as ServerSideConfig) ?? undefined);\n});\n\n/** @internal Type anchor — forces bundlers to preserve this module's FeatureConfig augmentation when re-exported. */\nexport type _Augmentation = true;\n"],"names":["registerFeature","config","ServerSidePlugin"],"mappings":"+IAqBAA,EAAgB,aAAeC,GACtB,IAAIC,EAAkBD,QAA+B"}
+{"version":3,"file":"server-side.js","sources":["../../../../../libs/grid/src/lib/features/server-side.ts"],"sourcesContent":["/**\n * Server-Side feature for @toolbox-web/grid\n *\n * @example\n * ```typescript\n * import '@toolbox-web/grid/features/server-side';\n *\n * grid.gridConfig = { features: { serverSide: { dataSource: { getRows: async (params) => ... } } } };\n * ```\n */\n\nimport { ServerSidePlugin, type ServerSideConfig } from '../plugins/server-side';\nimport { registerFeature } from './registry';\n\ndeclare module '../core/types' {\n  interface FeatureConfig {\n    /** Enable server-side data fetching, sorting, filtering, etc. */\n    serverSide?: ServerSideConfig;\n  }\n}\n\nregisterFeature('serverSide', (config) => {\n  return new ServerSidePlugin((config as ServerSideConfig) ?? undefined);\n});\n\n/** @internal Type anchor — forces bundlers to preserve this module's FeatureConfig augmentation when re-exported. */\nexport type _Augmentation = true;\n"],"names":["registerFeature","config","ServerSidePlugin"],"mappings":"+IAqBAA,EAAgB,aAAeC,GACtB,IAAIC,EAAkBD,QAA+B"}