@toolbox-web/grid 0.3.2 → 0.4.0

package/public.d.ts

@@ -38,21 +38,112 @@ export declare const PluginEvents: {
     readonly GROUP_EXPAND: "group-expand";
 };
 export type PluginEventName = (typeof PluginEvents)[keyof typeof PluginEvents];
-export type { ActivateCellDetail, AggregatorRef, AnimationConfig, AnimationMode, AnimationStyle, BaseColumnConfig, CellCommitDetail, CellRenderContext, ChangedRowsResetDetail, ColumnConfig, ColumnConfigMap, ColumnEditorContext, ColumnEditorSpec, ColumnResizeDetail, ColumnSortState, ColumnState, ColumnViewRenderer, DataGridCustomEvent, DataGridElement as DataGridElementInterface, DataGridEventMap, ExpandCollapseAnimation, ExternalMountEditorDetail, ExternalMountViewDetail, FitMode, FrameworkAdapter, GridColumnState, GridConfig, GridIcons, GridPlugin, HeaderContentDefinition, IconValue, InferredColumnResult, PrimitiveColumnType, PublicGrid, RowCommitDetail, RowGroupRenderConfig, ShellConfig, ShellHeaderConfig, SortChangeDetail, SortHandler, SortState, ToolPanelConfig, ToolPanelDefinition, ToolbarButtonConfig, } from './lib/core/types';
+export type { ActivateCellDetail, AggregatorRef, AnimationConfig, AnimationMode, AnimationStyle, BaseColumnConfig, CellCommitDetail, CellRenderContext, ChangedRowsResetDetail, ColumnConfig, ColumnConfigMap, ColumnEditorContext, ColumnEditorSpec, ColumnResizeDetail, ColumnSortState, ColumnState, ColumnViewRenderer, DataGridCustomEvent, DataGridElement as DataGridElementInterface, DataGridEventMap, ExpandCollapseAnimation, ExternalMountEditorDetail, ExternalMountViewDetail, FitMode, FrameworkAdapter, GridColumnState, GridConfig, GridIcons, GridPlugin, HeaderContentDefinition, IconValue, InferredColumnResult, PrimitiveColumnType, PublicGrid, RowCommitDetail, RowGroupRenderConfig, ShellConfig, ShellHeaderConfig, SortChangeDetail, SortHandler, SortState, ToolbarButtonConfig, ToolPanelConfig, ToolPanelDefinition, } 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 type { CellRange, SelectionChangeDetail, SelectionConfig, SelectionMode } from './lib/plugins/selection/types';
-export type { TreeConfig, TreeExpandDetail } from './lib/plugins/tree/types';
-export type { FilterConfig, FilterHandler, FilterModel, FilterOperator, FilterType, FilterValuesHandler, } from './lib/plugins/filtering/types';
-export type { MultiSortConfig, SortModel } from './lib/plugins/multi-sort/types';
-export type { ExportFormat, ExportParams } from './lib/plugins/export/types';
-export type { PinnedRowsContext, PinnedRowsPanel } from './lib/plugins/pinned-rows/types';
-export type { PivotConfig, PivotResult, PivotValueField } from './lib/plugins/pivot/types';
-export type { GetRowsParams, GetRowsResult, ServerSideDataSource } from './lib/plugins/server-side/types';
-export type { EditAction } from './lib/plugins/undo-redo/types';
-export type { GroupingRowsConfig } from './lib/plugins/grouping-rows/types';
 export { BaseGridPlugin, PLUGIN_QUERIES } from './lib/core/plugin';
 export type { PluginQuery } from './lib/core/plugin';
-export { GridCSSVars, GridClasses, GridDataAttrs, GridSelectors } from './lib/core/constants';
-export type { GridCSSVar, GridClassName, GridDataAttr } from './lib/core/constants';
+export { GridClasses, GridCSSVars, GridDataAttrs, GridSelectors } from './lib/core/constants';
+export type { GridClassName, GridCSSVar, GridDataAttr } from './lib/core/constants';
+/**
+ * Internal types for advanced users building custom plugins or enterprise extensions.
+ *
+ * These types provide access to grid internals that may be needed for deep customization.
+ * While not part of the "stable" API, they are exported for power users who need them.
+ *
+ * @remarks
+ * Use with caution - these types expose internal implementation details.
+ * The underscore-prefixed members they reference are considered less stable
+ * than the public API surface.
+ *
+ * @example
+ * ```typescript
+ * import { BaseGridPlugin } from '@toolbox-web/grid';
+ * import type { InternalGrid, ColumnInternal } from '@toolbox-web/grid';
+ *
+ * export class MyPlugin extends BaseGridPlugin<MyConfig> {
+ *   afterRender(): void {
+ *     // Access grid internals with proper typing
+ *     const grid = this.grid as InternalGrid;
+ *     const columns = grid._columns as ColumnInternal[];
+ *     // ...
+ *   }
+ * }
+ * ```
+ */
+/**
+ * Column configuration with internal cache properties.
+ * Extends the public ColumnConfig with compiled template caches (__compiledView, __viewTemplate, etc.)
+ * @internal
+ */
+export type { ColumnInternal } from './lib/core/types';
+/**
+ * Compiled template function with __blocked property for error handling.
+ * @internal
+ */
+export type { CompiledViewFunction } from './lib/core/types';
+/**
+ * Full internal grid interface extending PublicGrid with internal state.
+ * Provides typed access to _columns, _rows, virtualization state, etc.
+ * @internal
+ */
+export type { InternalGrid } from './lib/core/types';
+/**
+ * Cell context for renderer/editor operations.
+ * @internal
+ */
+export type { CellContext } from './lib/core/types';
+/**
+ * Editor execution context extending CellContext with commit/cancel functions.
+ * @internal
+ */
+export type { EditorExecContext } from './lib/core/types';
+/**
+ * Template evaluation context for dynamic templates.
+ * @internal
+ */
+export type { EvalContext } from './lib/core/types';
+/**
+ * Column resize controller interface.
+ * @internal
+ */
+export type { ResizeController } from './lib/core/types';
+/**
+ * Row virtualization state interface.
+ * @internal
+ */
+export type { VirtualState } from './lib/core/types';
+/**
+ * Row element with internal editing state cache.
+ * Used for tracking editing cell count without querySelector.
+ * @internal
+ */
+export type { RowElementInternal } from './lib/core/types';
+/**
+ * Union type for input-like elements that have a `value` property.
+ * Covers standard form elements and custom elements with value semantics.
+ * @internal
+ */
+export type { InputLikeElement } from './lib/core/types';
+/**
+ * Utility type to safely cast a grid element to InternalGrid for plugin use.
+ *
+ * @example
+ * ```typescript
+ * import type { AsInternalGrid, InternalGrid } from '@toolbox-web/grid';
+ *
+ * class MyPlugin extends BaseGridPlugin {
+ *   get internalGrid(): InternalGrid {
+ *     return this.grid as AsInternalGrid;
+ *   }
+ * }
+ * ```
+ * @internal
+ */
+export type AsInternalGrid<T = unknown> = import('./lib/core/types').InternalGrid<T>;
+/**
+ * Render phase enum for debugging and understanding the render pipeline.
+ * Higher phases include all lower phase work.
+ */
+export { RenderPhase } from './lib/core/internal/render-scheduler';
 //# sourceMappingURL=public.d.ts.map

package/public.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"public.d.ts","sourceRoot":"","sources":["../../../libs/grid/src/public.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,eAAe,EAAE,eAAe,IAAI,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAGlF,eAAO,MAAM,QAAQ;;;;;;;;;;;CAWX,CAAC;AAEX,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,OAAO,QAAQ,CAAC,CAAC;AAGnE,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;CA+Bf,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,OAAO,YAAY,CAAC,CAAC;AAG/E,YAAY,EACV,kBAAkB,EAClB,aAAa,EAEb,eAAe,EACf,aAAa,EACb,cAAc,EACd,gBAAgB,EAEhB,gBAAgB,EAChB,iBAAiB,EACjB,sBAAsB,EACtB,YAAY,EACZ,eAAe,EACf,mBAAmB,EAEnB,gBAAgB,EAChB,kBAAkB,EAElB,eAAe,EACf,WAAW,EACX,kBAAkB,EAClB,mBAAmB,EACnB,eAAe,IAAI,wBAAwB,EAC3C,gBAAgB,EAChB,uBAAuB,EACvB,yBAAyB,EACzB,uBAAuB,EACvB,OAAO,EAEP,gBAAgB,EAChB,eAAe,EAEf,UAAU,EAEV,SAAS,EAET,UAAU,EAEV,uBAAuB,EACvB,SAAS,EAET,oBAAoB,EACpB,mBAAmB,EAEnB,UAAU,EACV,eAAe,EAEf,oBAAoB,EACpB,WAAW,EACX,iBAAiB,EACjB,gBAAgB,EAEhB,WAAW,EACX,SAAS,EACT,eAAe,EACf,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAG7F,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAQ7E,YAAY,EAAE,SAAS,EAAE,qBAAqB,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAGtH,YAAY,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAG7E,YAAY,EACV,YAAY,EACZ,aAAa,EACb,WAAW,EACX,cAAc,EACd,UAAU,EACV,mBAAmB,GACpB,MAAM,+BAA+B,CAAC;AAGvC,YAAY,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAGjF,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAG7E,YAAY,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAG1F,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAG3F,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAG1G,YAAY,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAGhE,YAAY,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAG5E,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnE,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC9F,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"public.d.ts","sourceRoot":"","sources":["../../../libs/grid/src/public.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,eAAe,EAAE,eAAe,IAAI,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAGlF,eAAO,MAAM,QAAQ;;;;;;;;;;;CAWX,CAAC;AAEX,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,OAAO,QAAQ,CAAC,CAAC;AAGnE,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;CA+Bf,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,OAAO,YAAY,CAAC,CAAC;AAG/E,YAAY,EACV,kBAAkB,EAClB,aAAa,EAEb,eAAe,EACf,aAAa,EACb,cAAc,EACd,gBAAgB,EAEhB,gBAAgB,EAChB,iBAAiB,EACjB,sBAAsB,EACtB,YAAY,EACZ,eAAe,EACf,mBAAmB,EAEnB,gBAAgB,EAChB,kBAAkB,EAElB,eAAe,EACf,WAAW,EACX,kBAAkB,EAClB,mBAAmB,EACnB,eAAe,IAAI,wBAAwB,EAC3C,gBAAgB,EAChB,uBAAuB,EACvB,yBAAyB,EACzB,uBAAuB,EACvB,OAAO,EAEP,gBAAgB,EAChB,eAAe,EAEf,UAAU,EAEV,SAAS,EAET,UAAU,EAEV,uBAAuB,EACvB,SAAS,EAET,oBAAoB,EACpB,mBAAmB,EAEnB,UAAU,EACV,eAAe,EAEf,oBAAoB,EACpB,WAAW,EACX,iBAAiB,EACjB,gBAAgB,EAEhB,WAAW,EACX,SAAS,EACT,mBAAmB,EACnB,eAAe,EACf,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAG7F,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAK7E,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnE,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC9F,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAUpF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH;;;;GAIG;AACH,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD;;;GAGG;AACH,YAAY,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAE7D;;;;GAIG;AACH,YAAY,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD;;;GAGG;AACH,YAAY,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD;;;GAGG;AACH,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE1D;;;GAGG;AACH,YAAY,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD;;;GAGG;AACH,YAAY,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEzD;;;GAGG;AACH,YAAY,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD;;;;GAIG;AACH,YAAY,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAE3D;;;;GAIG;AACH,YAAY,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEzD;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,cAAc,CAAC,CAAC,GAAG,OAAO,IAAI,OAAO,kBAAkB,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;AAErF;;;GAGG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,sCAAsC,CAAC"}