@toolbox-web/grid 1.31.2 → 2.0.0-alpha

package/lib/core/grid.d.ts

@@ -1,6 +1,6 @@
 import { ShellState } from './internal/shell';
 import { AfterCellRenderContext, AfterRowRenderContext, CellMouseEvent } from './plugin';
-import { BaseGridPlugin, PluginQuery } from './plugin/base-plugin';
+import { BaseGridPlugin } from './plugin/base-plugin';
 import { PluginManager } from './plugin/plugin-manager';
 import { ColumnConfig, ColumnConfigMap, ColumnInternal, DataGridEventMap, FitMode, FrameworkAdapter, GridColumnState, GridConfig, HeaderContentDefinition, IconValue, InternalGrid, PluginNameMap, ResizeController, RowAnimationType, RowElementInternal, RowTransaction, ScrollToRowOptions, ToolbarContentDefinition, ToolPanelDefinition, TransactionResult, UpdateSource, VirtualState } from './types';
 export declare class DataGridElement<T = any> extends HTMLElement implements InternalGrid<T> {
@@ -512,12 +512,8 @@ export declare class DataGridElement<T = any> extends HTMLElement implements Int
     _updateAriaCounts(rowCount: number, colCount: number): void;
     /** @internal Request a render at the given phase through the scheduler. */
     _requestSchedulerPhase(phase: number, source: string): void;
-    /** @internal Plugin extra height for spacer calculation. */
-    _getPluginExtraHeight(): number;
     /** @internal Plugin-specific row height override. */
     _getPluginRowHeight(row: T, index: number): number | undefined;
-    /** @internal Plugin extra height before a given row index. */
-    _getPluginExtraHeightBefore(start: number): number;
     /** @internal Let plugins adjust the virtual start index backwards. */
     _adjustPluginVirtualStart(start: number, scrollTop: number, rowHeight: number): number | undefined;
     /** @internal Run plugin afterRender hooks. */
@@ -612,20 +608,6 @@ export declare class DataGridElement<T = any> extends HTMLElement implements Int
         right: number;
         skipScroll?: boolean;
     };
-    /**
-     * Query all plugins with a generic query and collect responses.
-     * This enables inter-plugin communication without the core knowing plugin-specific concepts.
-     * @group Plugin Communication
-     * @internal Plugin API
-     *
-     * @example
-     * // Check if any plugin vetoes moving a column
-     * const responses = grid.queryPlugins<boolean>({ type: 'canMoveColumn', context: column });
-     * const canMove = !responses.includes(false);
-     *
-     * @deprecated Use the simplified `query<T>(type, context)` method instead. Will be removed in v2.
-     */
-    queryPlugins<T>(query: PluginQuery): T[];
     /**
      * Query plugins with a simplified API.
      * This is a convenience wrapper around `queryPlugins` that uses a flat signature.
@@ -1019,16 +1001,6 @@ export declare class DataGridElement<T = any> extends HTMLElement implements Int
      * ```
      */
     applyTransactionAsync(transaction: RowTransaction<T>): Promise<TransactionResult<T>>;
-    /**
-     * Suspend row processing for the next rows update.
-     *
-     * @deprecated This method is a no-op. Use {@link insertRow} or {@link removeRow}
-     * instead, which correctly preserve the current sort/filter view while adding
-     * or removing individual rows. Will be removed in v2.
-     *
-     * @group Lifecycle
-     */
-    suspendProcessing(): void;
     /**
      * Move focus to a specific cell.
      *

package/lib/core/internal/aggregators.bench.d.ts

@@ -0,0 +1 @@
+export {};

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

@@ -59,8 +59,3 @@ export declare function getValueAggregator(aggFunc: string): ValueAggregatorFn;
  * @returns Aggregated result
  */
 export declare function runValueAggregator(aggFunc: string, values: number[]): number;
-export declare const registerAggregator: (name: string, fn: AggregatorFn) => void;
-export declare const unregisterAggregator: (name: string) => void;
-export declare const getAggregator: (ref: AggregatorRef | undefined) => AggregatorFn | undefined;
-export declare const runAggregator: (ref: AggregatorRef | undefined, rows: any[], field: string, column?: any) => any;
-export declare const listAggregators: () => string[];

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

@@ -1,4 +1,4 @@
-import { GridConfig } from '../types';
+import { A11yMessages, GridConfig } from '../types';
 import { ShellState } from './shell';
 /**
  * State for caching ARIA attributes to avoid redundant DOM writes.
@@ -53,7 +53,19 @@ export declare function updateAriaLabels<T>(state: AriaState, rowsBodyEl: HTMLEl
  * Announce a message to screen readers via the grid's aria-live region.
  * Clears then sets text to ensure repeated messages are re-announced.
  *
+ * Respects `effectiveConfig.a11y.announcements` — if set to `false`,
+ * the announcement is silently skipped.
+ *
  * @param gridEl - The grid host element (or any ancestor containing `.tbw-sr-only`)
  * @param message - The message to announce
  */
 export declare function announce(gridEl: HTMLElement, message: string): void;
+/**
+ * Get an announcement message, preferring custom overrides from config.
+ * Falls back to default English messages when no override is provided.
+ *
+ * @param gridEl - The grid host element
+ * @param key - The message key from A11yMessages
+ * @param args - Arguments to pass to the message function
+ */
+export declare function getA11yMessage<K extends keyof A11yMessages>(gridEl: HTMLElement, key: K, ...args: Parameters<A11yMessages[K]>): string;

package/lib/core/internal/config.bench.d.ts

@@ -0,0 +1 @@
+export {};

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

@@ -64,8 +64,6 @@ export declare const MISSING_DEPENDENCY: "TBW020";
 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). */
@@ -130,7 +128,7 @@ export declare const STYLE_EXTRACT_FAILED: "TBW120";
 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;
+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;
 /**
  * Format a diagnostic message with prefix, code, and docs link.
  *

package/lib/core/internal/render-pipeline.bench.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Render Pipeline Benchmarks
+ *
+ * Measures the combined cost of operations that the render scheduler
+ * executes per flush cycle: sorting → processRows plugins → processColumns
+ * plugins → virtualization. This catches regressions from plugin
+ * composition overhead that per-function benchmarks miss.
+ */
+export {};

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

@@ -226,8 +226,6 @@ export interface ShellController {
     setInitialized(value: boolean): void;
     /** Whether the tool panel is currently open */
     readonly isPanelOpen: boolean;
-    /** Get the currently active panel ID (deprecated) */
-    readonly activePanel: string | null;
     /** Get IDs of expanded accordion sections */
     readonly expandedSections: string[];
     /** Open the tool panel */

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

@@ -0,0 +1 @@
+export {};

package/lib/core/internal/virtualization.bench.d.ts

@@ -0,0 +1 @@
+export {};

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

@@ -1,7 +1,6 @@
 import { DiagnosticCode } from '../internal/diagnostics';
 import { ColumnConfig, ColumnState, GridIcons, GridPlugin, HeaderContentDefinition, IconValue, PluginNameMap, ToolPanelDefinition } 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';
 /**
  * Grid element interface for plugins.
@@ -607,16 +606,6 @@ export declare abstract class BaseGridPlugin<TConfig = unknown> implements GridP
      * ```
      */
     protected get animationDuration(): number;
-    /**
-     * Resolve an icon value to string or HTMLElement.
-     * Checks plugin config first, then grid-level icons, then defaults.
-     *
-     * @deprecated Use `setIcon(element, iconKey)` instead. Will be removed in v2.0.0.
-     * @param iconKey - The icon key in GridIcons (e.g., 'expand', 'collapse')
-     * @param pluginOverride - Optional plugin-level override
-     * @returns The resolved icon value
-     */
-    protected resolveIcon(iconKey: keyof GridIcons, pluginOverride?: IconValue): IconValue;
     /**
      * Set an icon on an element using the CSS-first hybrid approach.
      *
@@ -823,68 +812,6 @@ export declare abstract class BaseGridPlugin<TConfig = unknown> implements GridP
      * ```
      */
     onScrollRender?(): void;
-    /**
-     * Return extra height contributed by this plugin (e.g., expanded detail rows).
-     * Used to adjust scrollbar height calculations for virtualization.
-     *
-     * @returns Total extra height in pixels
-     *
-     * @deprecated Use {@link getRowHeight} instead. This hook will be removed in v2.0.
-     * The new `getRowHeight(row, index)` hook provides per-row height information which
-     * enables better position caching and variable row height support.
-     *
-     * @example
-     * ```ts
-     * // OLD (deprecated):
-     * getExtraHeight(): number {
-     *   return this.expandedRows.size * this.detailHeight;
-     * }
-     *
-     * // NEW (preferred):
-     * getRowHeight(row: unknown, index: number): number | undefined {
-     *   if (this.isExpanded(row)) {
-     *     return this.baseRowHeight + this.getDetailHeight(row);
-     *   }
-     *   return undefined;
-     * }
-     * ```
-     */
-    getExtraHeight?(): number;
-    /**
-     * Return extra height that appears before a given row index.
-     * Used by virtualization to correctly calculate scroll positions when
-     * there's variable height content (like expanded detail rows) above the viewport.
-     *
-     * @param beforeRowIndex - The row index to calculate extra height before
-     * @returns Extra height in pixels that appears before this row
-     *
-     * @deprecated Use {@link getRowHeight} instead. This hook will be removed in v2.0.
-     * The new `getRowHeight(row, index)` hook provides per-row height information which
-     * enables better position caching and variable row height support.
-     *
-     * @example
-     * ```ts
-     * // OLD (deprecated):
-     * getExtraHeightBefore(beforeRowIndex: number): number {
-     *   let height = 0;
-     *   for (const expandedRowIndex of this.expandedRowIndices) {
-     *     if (expandedRowIndex < beforeRowIndex) {
-     *       height += this.getDetailHeight(expandedRowIndex);
-     *     }
-     *   }
-     *   return height;
-     * }
-     *
-     * // NEW (preferred):
-     * getRowHeight(row: unknown, index: number): number | undefined {
-     *   if (this.isExpanded(row)) {
-     *     return this.baseRowHeight + this.getDetailHeight(row);
-     *   }
-     *   return undefined;
-     * }
-     * ```
-     */
-    getExtraHeightBefore?(beforeRowIndex: number): number;
     /**
      * Get the height of a specific row.
      * Used for synthetic rows (group headers, detail panels, etc.) that have fixed heights.
@@ -896,17 +823,6 @@ export declare abstract class BaseGridPlugin<TConfig = unknown> implements GridP
      * @param row - The row data
      * @param index - The row index in the processed rows array
      * @returns The row height in pixels, or undefined if not managed by this plugin
-     *
-     * @example
-     * ```ts
-     * getRowHeight(row: unknown, index: number): number | undefined {
-     *   // Group headers have a fixed height
-     *   if (this.isGroupHeader(row)) {
-     *     return 32;
-     *   }
-     *   return undefined; // Let grid use default/measured height
-     * }
-     * ```
      */
     getRowHeight?(row: unknown, index: number): number | undefined;
     /**
@@ -956,38 +872,6 @@ export declare abstract class BaseGridPlugin<TConfig = unknown> implements GridP
      * ```
      */
     renderRow?(row: any, rowEl: HTMLElement, rowIndex: number): boolean | void;
-    /**
-     * Handle queries from other plugins.
-     * This is the generic mechanism for inter-plugin communication.
-     * Plugins can respond to well-known query types or define their own.
-     *
-     * **Prefer `handleQuery` for new plugins** - it has the same signature but
-     * a clearer name. `onPluginQuery` is kept for backwards compatibility.
-     *
-     * @category Plugin Development
-     * @param query - The query object with type and context
-     * @returns Query-specific response, or undefined if not handling this query
-     *
-     * @example
-     * ```ts
-     * onPluginQuery(query: PluginQuery): unknown {
-     *   switch (query.type) {
-     *     case PLUGIN_QUERIES.CAN_MOVE_COLUMN:
-     *       // Prevent moving pinned columns
-     *       const column = query.context as ColumnConfig;
-     *       if (column.sticky === 'left' || column.sticky === 'right') {
-     *         return false;
-     *       }
-     *       break;
-     *     case PLUGIN_QUERIES.GET_CONTEXT_MENU_ITEMS:
-     *       const params = query.context as ContextMenuParams;
-     *       return [{ id: 'my-action', label: 'My Action', action: () => {} }];
-     *   }
-     * }
-     * ```
-     * @deprecated Use `handleQuery` instead for new plugins. Will be removed in v2.
-     */
-    onPluginQuery?(query: PluginQuery): unknown;
     /**
      * Handle queries from other plugins or the grid.
      *

package/lib/core/plugin/index.d.ts

@@ -4,7 +4,7 @@
  * Public API for the plugin infrastructure.
  * All plugins extend BaseGridPlugin and are attached to grids via PluginManager.
  */
-export { BaseGridPlugin, PLUGIN_QUERIES } from './base-plugin';
+export { BaseGridPlugin } from './base-plugin';
 export type { AfterCellRenderContext, AfterRowRenderContext, CellClickEvent, CellCoords, CellEditor, CellMouseEvent, CellRenderer, ContextMenuItem, ContextMenuParams, GridElement, HeaderClickEvent, HeaderRenderer, KeyboardModifiers, PluginCellRenderContext, PluginHeaderRenderContext, PluginQuery, RowClickEvent, ScrollEvent, } from './base-plugin';
 export { PluginManager } from './plugin-manager';
 export type { EventDefinition, HookName, PluginConfigRule, PluginDependency, PluginIncompatibility, PluginManifest, PluginPropertyDefinition, QueryDefinition, } from './base-plugin';

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

@@ -37,8 +37,6 @@ export declare class PluginManager {
      * Built from manifest.queries during plugin attach.
      */
     private queryHandlers;
-    /** Set of plugin constructors that have been warned about deprecated hooks */
-    private static deprecationWarned;
     constructor(grid: GridElement);
     /**
      * Attach all plugins from the config.
@@ -53,11 +51,6 @@ export declare class PluginManager {
      * Register query handlers from a plugin's manifest.
      */
     private registerQueryHandlers;
-    /**
-     * Warn about deprecated plugin hooks.
-     * Only warns once per plugin class, only in development environments.
-     */
-    private warnDeprecatedHooks;
     /**
      * Unregister query handlers for a plugin.
      */
@@ -153,22 +146,6 @@ export declare class PluginManager {
      * Called after scroll-triggered row rendering for lightweight visual state updates.
      */
     onScrollRender(): void;
-    /**
-     * Get total extra height contributed by plugins (e.g., expanded detail rows).
-     * Used to adjust scrollbar height calculations.
-     */
-    getExtraHeight(): number;
-    /**
-     * Check if any plugin is contributing extra height.
-     * When true, plugins are managing variable row heights and the grid should
-     * not override the base row height via #measureRowHeight().
-     */
-    hasExtraHeight(): boolean;
-    /**
-     * Get extra height from plugins that appears before a given row index.
-     * Used by virtualization to correctly position the scroll window.
-     */
-    getExtraHeightBefore(beforeRowIndex: number): number;
     /**
      * Get the height of a specific row from plugins.
      * Used for synthetic rows (group headers, etc.) that have fixed heights.
@@ -198,8 +175,6 @@ export declare class PluginManager {
      * the query type in their `manifest.queries` are invoked. Falls back to querying
      * all plugins for backwards compatibility with legacy plugins.
      *
-     * Checks both `handleQuery` (preferred) and `onPluginQuery` (legacy) hooks.
-     *
      * @param query - The query object containing type and context
      * @returns Array of non-undefined responses from plugins
      */

package/lib/core/plugin/types.d.ts

@@ -190,28 +190,6 @@ export interface PluginQuery<T = unknown> {
     /** Query-specific context/parameters */
     context: T;
 }
-/**
- * Well-known plugin query types.
- * Plugins can define additional query types beyond these.
- *
- * @deprecated Use string literals with `grid.query()` instead. Query types should
- * be declared in the responding plugin's `manifest.queries` for automatic routing.
- * This constant will be removed in  v2.0.
- *
- * @example
- * // Before (deprecated):
- * import { PLUGIN_QUERIES } from '@toolbox-web/grid';
- * const responses = grid.queryPlugins({ type: PLUGIN_QUERIES.CAN_MOVE_COLUMN, context: column });
- *
- * // After (recommended):
- * const responses = grid.query<boolean>('canMoveColumn', column);
- */
-export declare const PLUGIN_QUERIES: {
-    /** Ask if a column can be moved. Context: ColumnConfig. Response: boolean | undefined */
-    readonly CAN_MOVE_COLUMN: "canMoveColumn";
-    /** Get context menu items. Context: ContextMenuParams. Response: ContextMenuItem[] */
-    readonly GET_CONTEXT_MENU_ITEMS: "getContextMenuItems";
-};
 /**
  * Cell render context for plugin cell renderers.
  * Provides full context including position and editing state.
@@ -352,19 +330,6 @@ export interface GridElementRef {
         unsubscribe(plugin: unknown, eventType: string): void;
         emitPluginEvent<T>(eventType: string, detail: T): void;
     };
-    /**
-     * Query all plugins with a generic query and collect responses.
-     * Used for inter-plugin communication (e.g., asking PinnedColumnsPlugin
-     * if a column can be moved).
-     *
-     * @example
-     * const responses = grid.queryPlugins<boolean>({
-     *   type: PLUGIN_QUERIES.CAN_MOVE_COLUMN,
-     *   context: column
-     * });
-     * const canMove = !responses.includes(false);
-     */
-    queryPlugins<T>(query: PluginQuery): T[];
     /**
      * Query plugins with a simplified API.
      * Convenience wrapper that uses a flat signature.

package/lib/core/styles/index.d.ts

@@ -28,4 +28,3 @@
  * 10. Media Queries (accessibility, responsive)
  */
 export declare const gridStyles: string;
-export default gridStyles;

package/lib/core/types.d.ts

@@ -1,6 +1,5 @@
 import { ShellState } from './internal/shell';
 import { RowPosition } from './internal/virtualization';
-import { PluginQuery } from './plugin/base-plugin';
 import { AfterCellRenderContext, AfterRowRenderContext, CellMouseEvent } from './plugin/types';
 /**
  * Position entry for a single row in the position cache.
@@ -535,8 +534,6 @@ export interface InternalGrid<T = any> extends PublicGrid<T>, GridConfig<T> {
         right: number;
         skipScroll?: boolean;
     };
-    /** Query all plugins with a generic query and collect responses */
-    queryPlugins?: <T>(query: PluginQuery) => T[];
     /** Request emission of column-state-change event (debounced) */
     requestStateChange?: () => void;
     /** @internal Clear the cached _visibleColumns array so the next read recomputes from _columns. */
@@ -546,9 +543,7 @@ export interface InternalGrid<T = any> extends PublicGrid<T>, GridConfig<T> {
     /** @internal */ _requestSchedulerPhase(phase: number, source: string): void;
     /** @internal */ _rebuildRowIdMap(): void;
     /** @internal */ _emitDataChange(): void;
-    /** @internal */ _getPluginExtraHeight(): number;
     /** @internal */ _getPluginRowHeight(row: T, index: number): number | undefined;
-    /** @internal */ _getPluginExtraHeightBefore(start: number): number;
     /** @internal */ _adjustPluginVirtualStart(start: number, scrollTop: number, rowHeight: number): number | undefined;
     /** @internal */ _afterPluginRender(): void;
     /** @internal */ _emitPluginEvent(event: string, detail: unknown): void;
@@ -1967,6 +1962,74 @@ export interface FeatureConfig<TRow = unknown> {
      */
     __brand?: never;
 }
+/**
+ * Default announcement messages for screen reader live regions.
+ * Each function returns a localized string for a specific state change.
+ * Override individual messages via {@link A11yConfig.messages} for i18n.
+ *
+ * @group Accessibility
+ */
+export interface A11yMessages {
+    /** Announced when sorting is applied. */
+    sortApplied: (column: string, direction: string) => string;
+    /** Announced when sorting is cleared. */
+    sortCleared: () => string;
+    /** Announced when a filter is applied. */
+    filterApplied: (column: string) => string;
+    /** Announced when a filter is cleared from a column. */
+    filterCleared: (column: string) => string;
+    /** Announced when all filters are cleared. */
+    allFiltersCleared: () => string;
+    /** Announced when a group row is expanded. */
+    groupExpanded: (name: string, count: number) => string;
+    /** Announced when a group row is collapsed. */
+    groupCollapsed: (name: string) => string;
+    /** Announced when row selection changes. */
+    selectionChanged: (count: number) => string;
+    /** Announced when row editing starts. */
+    editingStarted: (rowIndex: number) => string;
+    /** Announced when row editing is committed. */
+    editingCommitted: (rowIndex: number) => string;
+    /** Announced when data is loaded. */
+    dataLoaded: (count: number) => string;
+}
+/**
+ * Accessibility configuration for controlling screen reader announcements.
+ *
+ * @group Accessibility
+ *
+ * @example
+ * ```ts
+ * // Disable all live announcements
+ * a11y: { announcements: false }
+ *
+ * // Override specific messages for French locale
+ * a11y: {
+ *   messages: {
+ *     sortApplied: (col, dir) => `Trié par ${col}, ${dir}`,
+ *     sortCleared: () => 'Tri effacé',
+ *   },
+ * }
+ * ```
+ */
+export interface A11yConfig {
+    /**
+     * Enable or disable live region announcements.
+     * When `false`, the `aria-live` region remains in the DOM but no messages are set.
+     * @defaultValue `true`
+     */
+    announcements?: boolean;
+    /**
+     * Custom announcement text overrides for internationalization.
+     * Partial — only override the messages you need; defaults are used for the rest.
+     */
+    messages?: Partial<A11yMessages>;
+}
+/**
+ * Default English announcement messages.
+ * Used when no custom messages are provided via {@link A11yConfig.messages}.
+ */
+export declare const DEFAULT_A11Y_MESSAGES: A11yMessages;
 /**
  * Grid configuration object - the **single source of truth** for grid behavior.
  *
@@ -2298,6 +2361,30 @@ export interface GridConfig<TRow = any> {
      * ```
      */
     gridAriaDescribedBy?: string;
+    /**
+     * Accessibility configuration for screen reader announcements.
+     *
+     * The grid automatically announces state changes (sort, filter, selection, etc.)
+     * via an `aria-live` region. Use this config to toggle announcements or override
+     * message text for internationalization.
+     *
+     * @example
+     * ```ts
+     * // Disable all announcements
+     * gridConfig = { a11y: { announcements: false } };
+     *
+     * // Custom messages for i18n
+     * gridConfig = {
+     *   a11y: {
+     *     messages: {
+     *       sortApplied: (col, dir) => `Trié par ${col}, ${dir}`,
+     *       filterApplied: (col) => `Filtre appliqué sur ${col}`,
+     *     },
+     *   },
+     * };
+     * ```
+     */
+    a11y?: A11yConfig;
     /**
      * Custom renderer for the loading overlay.
      *
@@ -3329,18 +3416,6 @@ export interface CellActivateDetail<TRow = unknown> {
     /** The original event (KeyboardEvent for keyboard, MouseEvent/PointerEvent for pointer). */
     originalEvent: KeyboardEvent | MouseEvent | PointerEvent;
 }
-/**
- * @deprecated Use `CellActivateDetail` instead. Will be removed in next major version.
- * Kept for backwards compatibility. Will be removed in v2.
- *
- * @category Events
- */
-export interface ActivateCellDetail {
-    /** Zero-based row index now focused. */
-    row: number;
-    /** Zero-based column index now focused. */
-    col: number;
-}
 /**
  * Event detail for mounting external view renderers.
  *
@@ -3471,8 +3546,7 @@ export interface DataGridEventMap<TRow = unknown> {
     'row-click': RowClickDetail<TRow>;
     /**
      * Fired when a cell is activated by Enter key or pointer click.
-     * Unified event for both keyboard and pointer activation — use this
-     * instead of the deprecated `activate-cell`.
+     * Unified event for both keyboard and pointer activation.
      *
      * Call `event.preventDefault()` to suppress default behavior (e.g., inline editing).
      *
@@ -3617,12 +3691,6 @@ export interface DataGridEventMap<TRow = unknown> {
      * @group Core Events
      */
     'column-resize': ColumnResizeDetail;
-    /**
-     * @deprecated Use `cell-activate` instead. Will be removed in v2.
-     * @see {@link ActivateCellDetail}
-     * @group Core Events
-     */
-    'activate-cell': ActivateCellDetail;
     /**
      * Fired when column state changes — reordering, resizing, visibility toggle,
      * or sort changes. Use with `getColumnState()` / `columnState` setter for

package/lib/features/multi-sort.d.ts

@@ -3,8 +3,6 @@ declare module '../core/types' {
     interface FeatureConfig {
         /** Enable multi-column sorting. */
         multiSort?: boolean | 'single' | 'multi' | MultiSortConfig;
-        /** @deprecated Use `multiSort` instead. Will be removed in v2.*/
-        sorting?: boolean | 'single' | 'multi' | MultiSortConfig;
     }
 }
 /** @internal Type anchor — forces bundlers to preserve this module's FeatureConfig augmentation when re-exported. */

package/lib/features/multi-sort.js.map

@@ -1 +1 @@
-{"version":3,"file":"multi-sort.js","sources":["../../../../../libs/grid/src/lib/features/multi-sort.ts"],"sourcesContent":["/**\n * Multi-sort feature for @toolbox-web/grid\n *\n * @example\n * ```typescript\n * import '@toolbox-web/grid/features/multi-sort';\n *\n * grid.gridConfig = { features: { multiSort: true } };\n * ```\n */\n\nimport { MultiSortPlugin, type MultiSortConfig } from '../plugins/multi-sort';\nimport { registerFeature } from './registry';\n\ndeclare module '../core/types' {\n  interface FeatureConfig {\n    /** Enable multi-column sorting. */\n    multiSort?: boolean | 'single' | 'multi' | MultiSortConfig;\n    /** @deprecated Use `multiSort` instead. Will be removed in v2.*/\n    sorting?: boolean | 'single' | 'multi' | MultiSortConfig;\n  }\n}\n\nregisterFeature('multiSort', (config) => {\n  if (config === true || config === 'multi') {\n    return new MultiSortPlugin();\n  }\n  if (config === 'single') {\n    return new MultiSortPlugin({ maxSortColumns: 1 });\n  }\n  return new MultiSortPlugin(config as MultiSortConfig);\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","MultiSortPlugin","maxSortColumns"],"mappings":"6IAuBAA,EAAgB,YAAcC,IACb,IAAXA,GAA8B,UAAXA,EACd,IAAIC,EAGJ,IAAIA,EADE,WAAXD,EACyB,CAAEE,eAAgB,GAEpBF"}
+{"version":3,"file":"multi-sort.js","sources":["../../../../../libs/grid/src/lib/features/multi-sort.ts"],"sourcesContent":["/**\n * Multi-sort feature for @toolbox-web/grid\n *\n * @example\n * ```typescript\n * import '@toolbox-web/grid/features/multi-sort';\n *\n * grid.gridConfig = { features: { multiSort: true } };\n * ```\n */\n\nimport { MultiSortPlugin, type MultiSortConfig } from '../plugins/multi-sort';\nimport { registerFeature } from './registry';\n\ndeclare module '../core/types' {\n  interface FeatureConfig {\n    /** Enable multi-column sorting. */\n    multiSort?: boolean | 'single' | 'multi' | MultiSortConfig;\n  }\n}\n\nregisterFeature('multiSort', (config) => {\n  if (config === true || config === 'multi') {\n    return new MultiSortPlugin();\n  }\n  if (config === 'single') {\n    return new MultiSortPlugin({ maxSortColumns: 1 });\n  }\n  return new MultiSortPlugin(config as MultiSortConfig);\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","MultiSortPlugin","maxSortColumns"],"mappings":"6IAqBAA,EAAgB,YAAcC,IACb,IAAXA,GAA8B,UAAXA,EACd,IAAIC,EAGJ,IAAIA,EADE,WAAXD,EACyB,CAAEE,eAAgB,GAEpBF"}

package/lib/features/registry.d.ts

@@ -33,7 +33,6 @@ export declare function createPluginFromFeature(name: string, config: unknown):
  * Create plugin instances from a features configuration object.
  *
  * Handles:
- * - Deprecated alias resolution (sorting → multiSort, etc.)
  * - Dependency validation (clipboard needs selection)
  * - Dependency ordering (selection before clipboard)
  * - Skipping false/undefined values

package/lib/features/registry.js

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