@toolbox-web/grid 1.24.2 → 1.25.1

package/lib/plugins/visibility/types.d.ts

@@ -74,4 +74,3 @@ declare module '../../core/types' {
         visibility: import('./VisibilityPlugin').VisibilityPlugin;
     }
 }
-//# sourceMappingURL=types.d.ts.map

package/lib/plugins/visibility/visibility.d.ts

@@ -27,4 +27,3 @@ export declare function canHideColumn<TRow = unknown>(columns: ColumnConfig<TRow
  * @returns New Set with updated hidden state
  */
 export declare function toggleColumnVisibility(hidden: Set<string>, field: string, visible?: boolean): Set<string>;
-//# sourceMappingURL=visibility.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@toolbox-web/grid",
-  "version": "1.24.2",
+  "version": "1.25.1",
   "description": "Zero-dependency, framework-agnostic data grid web component with virtualization, sorting, filtering, editing, and 20+ plugins. Works in vanilla JS, React, Vue, Angular, and any framework.",
   "type": "module",
   "main": "./index.js",

package/public.d.ts

@@ -45,23 +45,41 @@ export declare function createGrid<TRow = unknown>(config?: Partial<GridConfig<T
 /**
  * Query an existing grid element from the DOM with proper typing.
  *
- * This avoids the need to cast when querying grids:
- * ```typescript
- * // Before: manual cast required
- * const grid = document.querySelector('tbw-grid') as DataGridElement<Employee>;
+ * **Sync mode** (default) — returns the element immediately. The element may not
+ * be upgraded yet if the grid module hasn't loaded.
  *
- * // After: fully typed
+ * **Async mode** — pass `true` as the second or third argument to wait for the
+ * custom element to be defined and upgraded before resolving. This guarantees
+ * all `DataGridElement` methods (e.g. `registerStyles`, `ready`, `on`) are
+ * available on the returned instance.
+ *
+ * @example
+ * ```typescript
+ * // Sync — unchanged from before
  * const grid = queryGrid<Employee>('#my-grid');
  * if (grid) {
- *   grid.rows = employees; // ✓ Typed!
+ *   grid.rows = employees; // ✓ Typed (assumes element is upgraded)
  * }
+ *
+ * // Async — waits for custom-element upgrade
+ * const grid = await queryGrid<Employee>('#my-grid', true);
+ * if (grid) {
+ *   grid.registerStyles('my-id', '.cell { color: red; }'); // ✓ Safe
+ * }
+ *
+ * // Async with parent scope
+ * const grid = await queryGrid<Employee>('tbw-grid', container, true);
  * ```
  *
  * @param selector - CSS selector to find the grid element
- * @param parent - Parent node to search within (defaults to document)
- * @returns The typed grid element or null if not found
+ * @param parentOrAwait - Parent node to search within, or `true` to wait for upgrade
+ * @param awaitUpgrade - When `true`, waits for the custom element to be defined before resolving
+ * @returns The typed grid element (or null), either synchronously or as a Promise
  */
-export declare function queryGrid<TRow = unknown>(selector: string, parent?: ParentNode): DataGridElement<TRow> | null;
+export declare function queryGrid<TRow = unknown>(selector: string): DataGridElement<TRow> | null;
+export declare function queryGrid<TRow = unknown>(selector: string, parent: ParentNode): DataGridElement<TRow> | null;
+export declare function queryGrid<TRow = unknown>(selector: string, awaitUpgrade: true): Promise<DataGridElement<TRow> | null>;
+export declare function queryGrid<TRow = unknown>(selector: string, parent: ParentNode, awaitUpgrade: true): Promise<DataGridElement<TRow> | null>;
 /**
  * Event name constants for DataGrid (public API).
  *
@@ -108,6 +126,8 @@ export declare const DGEvents: {
     readonly CELL_ACTIVATE: "cell-activate";
     readonly GROUP_TOGGLE: "group-toggle";
     readonly COLUMN_STATE_CHANGE: "column-state-change";
+    /** Emitted when grid row data changes (set, insert, remove, update) */
+    readonly DATA_CHANGE: "data-change";
 };
 /**
  * Union type of all DataGrid event names.
@@ -189,11 +209,11 @@ export declare const PluginEvents: {
 export type PluginEventName = (typeof PluginEvents)[keyof typeof PluginEvents];
 export type { 
 /** @deprecated Use CellActivateDetail instead */
-ActivateCellDetail, AggregatorRef, AnimationConfig, AnimationMode, AnimationStyle, BaseColumnConfig, CellActivateDetail, CellActivateTrigger, CellChangeDetail, CellClickDetail, CellRenderContext, ColumnConfig, ColumnConfigMap, ColumnEditorContext, ColumnEditorSpec, ColumnResizeDetail, ColumnSortState, ColumnState, ColumnType, ColumnViewRenderer, DataGridCustomEvent, DataGridElement as DataGridElementInterface, DataGridEventMap, ExpandCollapseAnimation, ExternalMountEditorDetail, ExternalMountViewDetail, FeatureConfig, FitMode, FrameworkAdapter, GridColumnState, GridConfig, GridIcons, GridPlugin, HeaderCellContext, HeaderContentDefinition, HeaderLabelContext, HeaderLabelRenderer, HeaderRenderer, IconValue, InferredColumnResult, LoadingContext, LoadingRenderer, LoadingSize, PrimitiveColumnType, PublicGrid, RowAnimationType, RowClickDetail, RowGroupRenderConfig, RowUpdate, ScrollToRowOptions, ShellConfig, ShellHeaderConfig, SortChangeDetail, SortHandler, SortState, ToolbarContentDefinition, ToolPanelConfig, ToolPanelDefinition, TypeDefault, UpdateSource, } from './lib/core/types';
+ActivateCellDetail, AggregatorRef, AnimationConfig, AnimationMode, AnimationStyle, BaseColumnConfig, CellActivateDetail, CellActivateTrigger, CellChangeDetail, CellClickDetail, CellRenderContext, ColumnConfig, ColumnConfigMap, ColumnEditorContext, ColumnEditorSpec, ColumnResizeDetail, ColumnSortState, ColumnState, ColumnType, ColumnViewRenderer, DataChangeDetail, DataGridCustomEvent, DataGridElement as DataGridElementInterface, DataGridEventMap, ExpandCollapseAnimation, ExternalMountEditorDetail, ExternalMountViewDetail, FeatureConfig, FitMode, FrameworkAdapter, GridColumnState, GridConfig, GridIcons, GridPlugin, HeaderCellContext, HeaderContentDefinition, HeaderLabelContext, HeaderLabelRenderer, HeaderRenderer, IconValue, InferredColumnResult, LoadingContext, LoadingRenderer, LoadingSize, PrimitiveColumnType, PublicGrid, RowAnimationType, RowClickDetail, RowGroupRenderConfig, RowUpdate, ScrollToRowOptions, ShellConfig, ShellHeaderConfig, SortChangeDetail, SortHandler, SortState, ToolbarContentDefinition, ToolPanelConfig, ToolPanelDefinition, TypeDefault, UpdateSource } from './lib/core/types';
 export { DEFAULT_ANIMATION_CONFIG, DEFAULT_GRID_ICONS, FitModeEnum } from './lib/core/types';
 export { builtInSort, defaultComparator } from './lib/core/internal/sorting';
 export { BaseGridPlugin, PLUGIN_QUERIES } from './lib/core/plugin';
-export type { AfterCellRenderContext, AfterRowRenderContext, CellMouseEvent, EventDefinition, PluginDependency, PluginManifest, PluginQuery, QueryDefinition, } from './lib/core/plugin';
+export type { AfterCellRenderContext, AfterRowRenderContext, CellMouseEvent, EventDefinition, PluginDependency, PluginManifest, PluginQuery, QueryDefinition } from './lib/core/plugin';
 export { GridClasses, GridCSSVars, GridDataAttrs, GridSelectors } from './lib/core/constants';
 export type { GridClassName, GridCSSVar, GridDataAttr } from './lib/core/constants';
 /**
@@ -316,4 +336,3 @@ export { RenderPhase } from './lib/core/internal/render-scheduler';
  * @internal
  */
 export { setFeatureResolver } from './lib/core/internal/feature-hook';
-//# sourceMappingURL=public.d.ts.map