@toolbox-web/grid 2.4.0 → 2.5.0

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

@@ -12,6 +12,8 @@ export interface AriaState {
     ariaLabel: string | undefined;
     /** Last set aria-describedby */
     ariaDescribedBy: string | undefined;
+    /** Last source row count announced via `dataLoaded`; used to suppress duplicate announcements */
+    lastAnnouncedSourceCount: number;
 }
 /**
  * Create initial ARIA state.
@@ -69,3 +71,14 @@ export declare function announce(gridEl: HTMLElement, message: string): void;
  * @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;
+/**
+ * Announce a `dataLoaded` message — but only when the source row count has
+ * actually changed since the last announcement. This prevents announcement
+ * spam from internal `data-change` emits triggered by sort/filter/edit, which
+ * have their own dedicated announcements.
+ *
+ * @param gridEl - The grid host element
+ * @param state - ARIA state (tracks last announced count)
+ * @param sourceRowCount - Current source row count
+ */
+export declare function announceDataLoaded(gridEl: HTMLElement, state: AriaState, sourceRowCount: number): void;

package/lib/core/types.d.ts

@@ -1262,6 +1262,32 @@ export interface ColumnEditorContext<TRow = any, TValue = any> {
      * ```
      */
     onValueChange?: (callback: (newValue: TValue) => void) => void;
+    /**
+     * The grid element that owns this editor.
+     *
+     * Use to access public grid API from custom editors — e.g.
+     * `grid.registerExternalFocusContainer(panel)` so the grid treats focus
+     * inside a portal-rendered overlay (Autocomplete, date picker, color
+     * picker) as "still inside the editor" and does not exit row edit on
+     * click. Mirrors {@link CellRenderContext.grid} for renderers.
+     *
+     * Always populated when the editor is mounted via the grid's editing
+     * pipeline. Optional in the type for backwards compatibility with
+     * factory functions written against the original signature.
+     *
+     * @example
+     * ```typescript
+     * const editor: ColumnEditorSpec = (ctx: ColumnEditorContext) => {
+     *   const panel = document.createElement('div');
+     *   document.body.appendChild(panel);
+     *   ctx.grid?.registerExternalFocusContainer(panel);
+     *   // ...
+     * };
+     * ```
+     *
+     * @see {@link CellRenderContext.grid}
+     */
+    grid?: DataGridElement;
 }
 /**
  * Context passed to custom view renderers (pure display – no commit helpers).