balala-revogrid 1.0.0

package/dist/collection/types/interfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.js","sourceRoot":"","sources":["../../src/types/interfaces.ts"],"names":[],"mappings":"AA0a4D,CAAC","sourcesContent":["import type { VNode } from '@stencil/core';\n\nimport type {\n  DimensionCols,\n  DimensionRows,\n  DimensionColPin,\n  DimensionType,\n  MultiDimensionType,\n} from './dimension';\n\nimport type {\n  Cell,\n  EditorCtr,\n  FocusedCells,\n  OldNewRangeMapping,\n  RangeArea,\n  SelectionStoreState,\n} from './selection';\nimport type { Observable } from '../utils';\nimport type { JSXBase } from '@stencil/core/internal';\n\nexport type Nullable<T> = {\n  [P in keyof T]: T[P] | null;\n};\n\n/**\n * Advanced column data schema model.\n * Used for transpassing data to cell renderer and editor.\n */\nexport interface ColumnDataSchemaModel {\n  /**\n   * Column prop used for mapping value to cell from data source model/row\n   */\n  prop: ColumnProp;\n  /**\n   * Row data object\n   */\n  model: DataType;\n  /**\n   * Column data object\n   */\n  column: ColumnRegular;\n  /**\n   * Virtual index of the row in the viewport\n   */\n  rowIndex: number;\n  /**\n   * Virtual index of the column in the viewport\n   */\n  colIndex: number;\n  /**\n   * Column type based on viewport\n   */\n  colType: DimensionCols;\n  /**\n   * Row type based on viewport\n   */\n  type: DimensionRows;\n  /**\n   * Row models based on viewport\n   */\n  data: DataType[];\n  /**\n   * Current cell data value\n   * Mapped from model through column property like model['prop']\n   */\n  value?: any;\n}\n/**\n * Template property for each cell, extends the column data schema model.\n * Additionally, it provides access to the providers injected into the template.\n */\nexport interface CellTemplateProp extends ColumnDataSchemaModel {\n  /**\n   * Providers injected into the template\n   * Also to get grouping depth\n   */\n  providers: Providers;\n}\n/**\n * The ReadOnlyFormat type is a boolean value or a function that takes ColumnDataSchemaModel\n * as a parameter and returns a boolean value.\n *\n * If it is a boolean value, it represents whether the cell in question is read-only.\n * If it is a function, it returns whether the cell in question is read-only based on the provided\n * ColumnDataSchemaModel.\n */\nexport type ReadOnlyFormat =\n  | boolean\n  | ((params: ColumnDataSchemaModel) => boolean);\nexport type RowDrag =\n  | boolean\n  | {\n      (params: ColumnDataSchemaModel): boolean;\n    };\n/**\n * `ColumnGrouping` type is used to define a grouping in a column.\n */\nexport interface ColumnGrouping<T = any> {\n  /**\n   * An array of objects that represent the children of the grouping.\n   */\n  children: (ColumnGrouping<T> | ColumnRegular)[];\n  /**\n   * A `DataFormat` object that represents the name of the grouping.\n   */\n  name: DataFormat<T>;\n  /**\n   * Represents the header text alignment for the group.\n   * Can be 'left', 'center', or 'right'.\n   * Default is 'left'.\n   */\n  headerAlign?: 'left' | 'center' | 'right';\n}\n/**\n * Configuration for header inner template properties\n */\nexport interface ColumnProperties {\n  /**\n   * Header inner template\n   * Function/component to render custom header content\n   */\n  columnTemplate?: ColumnTemplateFunc;\n  /**\n   * Header Cell properties\n   * Custom function/component to render header properties\n   */\n  columnProperties?: ColPropertiesFunc;\n}\n/**\n * Type that represents a collection of column types.\n * The keys are the names of the column types and the values are the corresponding column type objects.\n */\nexport type ColumnTypes = {\n  /**\n   * The name of the column type.\n   */\n  [name: string]: ColumnType;\n};\n\n/**\n * Interface for custom cell renderer.\n */\nexport interface CellTemplate {\n  // TODO: Add Promise support for template and all custom function so user will be able to use async render on the light speed\n  (\n    createElement: HyperFunc<VNode>,\n    props: CellTemplateProp,\n    additionalData?: any,\n  ): any;\n}\n/**\n * Interface for regular column definition.\n * Regular column can be any column that is not a grouping column.\n */\nexport interface ColumnType extends ColumnProperties {\n  /**\n   * Represents whether the column or cell is read-only.\n   * Can be a boolean or a function that returns a boolean.\n   * The function receives column data as a parameter.\n   */\n  readonly?: ReadOnlyFormat;\n  /**\n   * Represents whether the column can receive focus.\n   * If set to false, cells in this column cannot be focused.\n   */\n  canFocus?: boolean;\n  /**\n   * Represents whether the column header can trigger double click event.\n   * If set to false, double click event will not be emitted for this column header.\n   * Default is true.\n   */\n  canDblClick?: boolean;\n  /**\n   * Represents the default column size.\n   */\n  size?: number;\n  /**\n   * Represents the minimal column size.\n   * This property cannot be less than cell padding\n   * in order to keep performance on top and minimize DOM elements number.\n   */\n  minSize?: number;\n  /**\n   * Represents the maximum column size.\n   */\n  maxSize?: number;\n  /**\n   * Represents a custom editor defined in editors property.\n   * Can be a string or an editor constructor function.\n   */\n  editor?: string | EditorCtr;\n  /**\n   * Represents cell properties for custom styling, classes, and events.\n   */\n  cellProperties?: PropertiesFunc;\n  /**\n   * Represents the cell template for custom rendering.\n   */\n  cellTemplate?: CellTemplate;\n  /**\n   * Represents the cell compare function for custom sorting.\n   */\n  cellCompare?: CellCompareFunc;\n\n  /**\n   * Represents the cell value parse function for custom parsing.\n   * Currently only used for filtering.\n   */\n  cellParser?: (model: DataType, column: ColumnRegular) => any;\n  /**\n   * Represents the header text alignment.\n   * Can be 'left', 'center', or 'right'.\n   * Default is 'left'.\n   */\n  headerAlign?: 'left' | 'center' | 'right';\n}\nexport type Order = 'asc' | 'desc' | undefined;\n/**\n * Interface for regular column definition.\n * Regular column can be any column that is not a grouping column.\n *\n */\n/**\n * ColumnRegular interface represents regular column definition.\n * Regular column can be any column that is not a grouping column.\n */\nexport interface ColumnRegular extends ColumnType {\n  /**\n   * Column prop used for mapping value to cell from data source model/row, used for indexing.\n   */\n  prop: ColumnProp;\n  /**\n   * Column pin 'colPinStart'|'colPinEnd'.\n   */\n  pin?: DimensionColPin;\n  /**\n   * Column header text.\n   */\n  name?: any;\n  /**\n   * Column size would be changed based on space left.\n   */\n  autoSize?: boolean;\n  /**\n   * Filter. Require filter plugin to be installed and activated through grid config filter.\n   */\n  filter?: boolean | string | string[];\n  /**\n   * Is column can be sorted, check cellCompare function for custom sorting.\n   */\n  sortable?: boolean;\n  /**\n   * Sort order.\n   */\n  order?: Order;\n  /**\n   * Is cell in column or individual can be dragged.\n   */\n  rowDrag?: RowDrag;\n  /**\n   * Represents type defined in columnTypes property through grid config.\n   */\n  columnType?: string;\n  /**\n   * Function called before column applied to the store.\n   */\n  beforeSetup?(rgCol: ColumnRegular): void;\n  /**\n   * Additional properties can be added to the column definition.\n   */\n  [key: string]: any;\n}\n\nexport type ColumnData = (ColumnGrouping | ColumnRegular)[];\n/**\n * Column template property.\n * Contains extended properties for column.\n */\nexport interface ColumnTemplateProp extends ColumnRegular {\n  /**\n   * Providers injected into the template.\n   */\n  providers: ProvidersColumns;\n  /**\n   * Index of the column, used for mapping value to cell from data source model/row.\n   */\n  index: number;\n}\n\nexport type ColumnPropProp = ColumnGrouping | ColumnTemplateProp;\n// Column prop used for mapping value to cell from data source model/row, used for indexing.\nexport type ColumnProp = string | number;\n\nexport type DataFormat<T = any> = T;\n\n/**\n * Additional properties applied to the cell.\n * Contains properties for custom cell rendering.\n */\nexport type CellProps = JSXBase.HTMLAttributes<HTMLDivElement> & {\n  className?: JSXBase.HTMLAttributes<HTMLDivElement>['class'];\n  // Additional properties for custom cell rendering\n  [attr: string]: string | number | object | boolean | undefined;\n};\n\n/**\n * Providers for columns which are going to be injected into each header renderer\n */\nexport interface ProvidersColumns<T = DimensionCols | 'rowHeaders'> extends Omit<Providers<T>, 'data' | 'columns' | 'colType'> {\n  /**\n   * Column data source store\n   */\n  data: ColumnRegular[];\n}\n\n/**\n * Providers for grid which are going to be injected into each cell template\n */\nexport interface Providers<T = DimensionRows> {\n  /**\n   * Dimension type (e.g. row or column)\n   */\n  type: T;\n  /**\n   * Dimension type (e.g. row or column)\n   */\n  colType: DimensionCols | 'rowHeaders';\n  /**\n   * Flag indicating if grid is in readonly mode\n   */\n  readonly: boolean;\n  /**\n   * Data source store\n   */\n  data: Observable<DataSourceState<any, any>>;\n  /**\n   * Column data source store\n   */\n  columns: Observable<DataSourceState<ColumnRegular, DimensionCols>>;\n  /**\n   * Viewport store\n   */\n  viewport: Observable<ViewportState>;\n  /**\n   * Dimension store\n   */\n  dimension: Observable<DimensionSettingsState>;\n  /**\n   * Selection store\n   */\n  selection: Observable<SelectionStoreState>;\n}\n/**\n * `HyperFunc` is a function that takes an HTML tag or component, and returns a\n * JSX element. This function is used to create JSX elements in a context where\n * JSX is not valid.\n */\nexport interface HyperFunc<T> {\n  // (tag: any): T;\n  (tag: any): T;\n}\n\n/**\n * `HyperFunc` is a function that takes an HTML tag or component, and returns a\n * JSX element. This function is used to create JSX elements in a context where\n * JSX is not valid.\n */\nexport type VNodeResponse = (VNode | string | number) | (VNode | string | number)[] | null | undefined;\n\n/**\n * `HyperFunc` is a function that takes an HTML tag or component, and returns a\n * JSX element. This function is used to create JSX elements in a context where\n * JSX is not valid.\n */\nexport interface HyperFunc<T> {\n  (tag: any, data: any): T;\n}\n/**\n * `HyperFunc` is a function that takes an HTML tag or component, and returns a\n * JSX element. This function is used to create JSX elements in a context where\n * JSX is not valid.\n */\nexport interface HyperFunc<T> {\n  (tag: any, text: string): T;\n}\n\n/**\n * `HyperFunc` is a function that takes an HTML tag or component, and returns a\n * JSX element. This function is used to create JSX elements in a context where\n * JSX is not valid.\n */\nexport interface HyperFunc<T> {\n  (sel: any, children: Array<T | undefined | null>): T;\n}\n\n/**\n * `HyperFunc` is a function that takes an HTML tag or component, and returns a\n * JSX element. This function is used to create JSX elements in a context where\n * JSX is not valid.\n */\nexport interface HyperFunc<T> {\n  (sel: any, data: any, text: string): T;\n}\n\n/**\n * `HyperFunc` is a function that takes an HTML tag or component, and returns a\n * JSX element. This function is used to create JSX elements in a context where\n * JSX is not valid.\n */\nexport interface HyperFunc<T> {\n  (sel: any, data: any, children: Array<T | undefined | null>): T;\n}\n\n/**\n * `HyperFunc` is a function that takes an HTML tag or component, and returns a\n * JSX element. This function is used to create JSX elements in a context where\n * JSX is not valid.\n */\nexport interface HyperFunc<T> {\n  (sel: any, data: any, children: T): T;\n}\n\n/**\n * `ExtraNodeFuncConfig` is a configuration object for `External nodes rendered in grid in HTMLRevogrExtraElement`.\n */\nexport interface ExtraNodeFuncConfig { refresh: () => void };\n\n/**\n * `FocusTemplateFunc` is a function that takes an HTML tag or component, and\n * returns a JSX element. This function is used to create JSX elements in a\n * context where JSX is not valid.\n */\nexport type FocusTemplateFunc = (\n  createElement: HyperFunc<VNode>,\n  detail: FocusRenderEvent,\n) => any;\n\n/**\n * `CellCompareFunc` is a function that takes the column property to compare,\n * the data of the first cell, and the data of the second cell. It returns a\n * number indicating the relative order of the two cells.\n */\nexport type CellCompareFunc = (\n  // The column property to compare.\n  prop: ColumnProp,\n  // The data of the first cell.\n  a: DataType,\n  // The data of the second cell.\n  b: DataType,\n) => number;\nexport type ColumnTemplateFunc = (\n  createElement: HyperFunc<VNode>,\n  props: ColumnTemplateProp,\n  additionalData?: any,\n) => any;\nexport type PropertiesFunc = (\n  props: CellTemplateProp,\n) => CellProps | void | undefined;\nexport type ColPropertiesFunc = (\n  props: ColumnPropProp,\n) => CellProps | void | undefined;\nexport type DataType<D = any> = {\n  [T in ColumnProp]: DataFormat<D>;\n};\n\nexport type DataLookup<T = any> = {\n  [rowIndex: number]: DataType<T>;\n};\n/**\n * `RowDefinition` is a type that represents a row definition in the\n * viewport.\n */\nexport type RowDefinition = {\n  /**\n   * The type of the row.\n   */\n  type: DimensionRows;\n  /**\n   * The size of the row.\n   */\n  size: number;\n  /**\n   * The index of the row.\n   */\n  index: number;\n};\nexport interface RowHeaders extends ColumnRegular {}\n/**\n * `ViewPortResizeEvent` is an object that contains information about a resize\n * event in the viewport.\n */\nexport type ViewPortResizeEvent = {\n  /* The dimension of the viewport being resized. */\n  dimension: DimensionType;\n  /* The new size of the viewport. */\n  size: number;\n  /* Indicates whether the resize event is for a row header. */\n  rowHeader?: boolean;\n};\n\n/**\n * `ViewPortScrollEvent` is an object that contains information about a scroll\n * event in the viewport.\n */\nexport type ViewPortScrollEvent = {\n  /**\n   * The dimension of the viewport being scrolled.\n   */\n  dimension: DimensionType;\n  /**\n   * The coordinate of the scroll event.\n   */\n  coordinate: number;\n  /**\n   * The change in coordinate between scroll events.\n   */\n  delta?: number;\n  /**\n   * Indicates whether the scroll event occurred outside the viewport.\n   */\n  outside?: boolean;\n};\n\n/**\n * `InitialHeaderClick` represents the information needed to handle a click\n * event on the initial column header.\n */\nexport type InitialHeaderClick = {\n  /**\n   * The index of the column header that was clicked.\n   */\n  index: number;\n  /**\n   * The original mouse event that triggered the click.\n   */\n  originalEvent: MouseEvent;\n  /**\n   * The column that was clicked.\n   */\n  column: ColumnRegular;\n  providers: ProvidersColumns;\n};\n\n/**\n * `Range` is an object that represents a range of values.\n */\nexport type Range = {\n  /**\n   * The start of the range.\n   */\n  start: number;\n  /**\n   * The end of the range.\n   */\n  end: number;\n};\n\n/**\n * `ViewportStateItems` is an object that represents the items in a viewport\n * along with their corresponding range.\n */\nexport type ViewportStateItems = {\n  /**\n   * The items in the viewport.\n   */\n  items: VirtualPositionItem[];\n} & Range;\n\n/**\n * `ViewportState` is an object that represents the state of a viewport.\n */\nexport interface ViewportState extends ViewportStateItems {\n  /**\n   * The number of real items in the viewport.\n   */\n  realCount: number;\n  /**\n   * Version to keep viewport in sync with column source.\n   */\n  version?: number;\n  /**\n   * The virtual size of the viewport.\n   */\n  virtualSize: number;\n\n  /**\n   * The client size of the viewport.\n   * Usually it's same as virtual size.\n   * Until virtualization is not disabled.\n   */\n  clientSize: number;\n}\n\n/**\n * `ViewSettingSizeProp` is a record that maps column or row indexes to their\n * corresponding sizes.\n */\nexport type ViewSettingSizeProp = Record<string, number>;\n\n/**\n * `VirtualPositionItem` is an object that represents a virtual position item\n * in the viewport.\n */\nexport interface VirtualPositionItem extends PositionItem {\n  /**\n   * The size of the virtual position item.\n   */\n  size: number;\n}\nexport type DataSourceState<\n  T extends DataType | ColumnRegular,\n  ST extends DimensionRows | DimensionCols,\n> = {\n  /**\n   * List of indices for visible items in the grid\n   */\n  items: number[];\n  /**\n   * List of indices for visible items in the grid, even if they are trimmed\n   * Update this collection if you want to change items order\n   */\n  proxyItems: number[];\n  /**\n   * Actual data array\n   */\n  source: T[];\n  /**\n   * Grouping information\n   */\n  groupingDepth: number;\n  groups: Record<any, any>;\n  /**\n   * Dimension type, can be rows or columns depending on context\n   */\n  type: ST;\n  /**\n   * Info for trimming or filtering the data, to hide entities from visible data source\n   */\n  trimmed: Record<any, any>;\n  /**\n   * Version to keep source in sync with viewport.\n   */\n  version?: number;\n};\nexport interface PositionItem {\n  itemIndex: number;\n  start: number;\n  end: number;\n}\n/**\n * Object containing information about calculated dimensions.\n * Used for both columns and rows.\n */\nexport interface DimensionCalc {\n  /**\n   * Array of indexes of visible items.\n   */\n  indexes: number[];\n\n  /**\n   * Count of visible items.\n   */\n  count: number;\n\n  /**\n   * Array of indexes of visible items.\n   * Used for mapping items to their position in DOM.\n   */\n  positionIndexes: number[];\n\n  /**\n   * Mapping of position to item.\n   * Used for mapping position in DOM to item.\n   */\n  positionIndexToItem: {\n    /**\n     * Position in DOM.\n     */\n    [position: number]: PositionItem;\n  };\n\n  /**\n   * Mapping of index to item.\n   * Used for mapping index in data source to item.\n   */\n  indexToItem: {\n    /**\n     * Index in data source.\n     */\n    [index: number]: PositionItem;\n  };\n\n  /**\n   * Object containing information about trimmed data.\n   * Used for hiding entities from visible data source.\n   */\n  trimmed: { [index: number]: number} | null;\n\n  /**\n   * Object containing size for each visible item.\n     * provider stores only changed sizes, not all of them\n     * same as indexes but for sizes and positions\n     * virtual item index to size\n   */\n  sizes: ViewSettingSizeProp;\n}\n/**\n * Represents the settings state of a dimension.\n * It extends the calculation properties of a dimension.\n * It also includes the real size and origin item size of the dimension.\n */\nexport interface DimensionSettingsState extends DimensionCalc {\n  /**\n   * Represents the real size of the dimension.\n   */\n  realSize: number;\n\n  /**\n   * Represents the origin item size of the dimension.\n   */\n  originItemSize: number;\n}\n\n/**\n * Represents the mapping of dimension types to their corresponding observable stores.\n */\nexport type DimensionStores = {\n  [T in MultiDimensionType]: Observable<DimensionSettingsState>;\n};\n\n/**\n * Represents the mapping of dimension types to their corresponding observable stores for the viewport.\n */\nexport type ViewportStores = {\n  [T in MultiDimensionType]: Observable<ViewportState>;\n};\n\n/**\n * Represents the event object that is emitted when the drag operation starts.\n */\nexport interface DragStartEvent {\n  /**\n   * Represents the original mouse event that triggered the drag operation.\n   */\n  originalEvent: MouseEvent;\n\n  /**\n   * Represents the model of the column being dragged.\n   */\n  model: ColumnDataSchemaModel;\n}\n\n/**\n * Represents the event object that is emitted before cell rendering.\n * It includes information about the dimension type, column, row, and model.\n */\nexport interface BeforeCellRenderEvent<T = any> extends AllDimensionType {\n  /**\n   * Represents the column being rendered.\n   */\n  column: VirtualPositionItem;\n\n  /**\n   * Represents the row being rendered.\n   */\n  row: VirtualPositionItem;\n\n  /**\n   * Represents the model being rendered.\n   */\n  model: T;\n}\n\n/**\n * Represents the event object that is emitted before row rendering.\n * It includes information about the dimension type, data item, item, and node.\n */\nexport interface BeforeRowRenderEvent<T = any> extends AllDimensionType {\n  /**\n   * Represents the data item being rendered.\n   */\n  model: T;\n\n  /**\n   * Represents the item being rendered.\n   */\n  item: VirtualPositionItem;\n\n  /**\n   * Represents the node being rendered.\n   */\n  node: VNode;\n}\n\n/**\n * Represents the event object that is emitted after rendering.\n * It includes information about the dimension type.\n */\nexport type AfterRendererEvent = {\n  /**\n   * Represents the type of dimension being rendered.\n   */\n  type: DimensionType;\n};\n\n/**\n * Represents the mapping of dimension types to their corresponding dimension types.\n */\nexport interface AllDimensionType {\n  /**\n   * Represents the dimension type for rows.\n   */\n  rowType: DimensionRows;\n\n  /**\n   * Represents the dimension type for columns.\n   */\n  colType: DimensionCols;\n}\n\n/**\n * Represents the event object that is emitted when applying focus.\n * It includes information about the dimension type and focused cells.\n */\nexport interface ApplyFocusEvent extends AllDimensionType, FocusedCells {}\n\n/**\n * Represents the event object that is emitted before focus rendering.\n * It includes information about the dimension type and range area.\n */\nexport interface FocusRenderEvent extends AllDimensionType {\n  /**\n   * Represents the range area of the focus.\n   */\n  range: RangeArea;\n\n  rowDimension: DimensionSettingsState;\n\n  colDimension: DimensionSettingsState;\n\n  /**\n   * Changes for the next cell to focus. @example { y: -1 }\n   */\n  next?: Partial<Cell>;\n}\n\nexport interface FocusAfterRenderEvent extends AllDimensionType {\n  model?: any;\n  column?: ColumnRegular;\n  /**\n   * Virtual index of the row in the viewport\n   */\n  rowIndex: number;\n  /**\n   * Virtual index of the column in the viewport\n   */\n  colIndex: number;\n}\n/**\n * Represents the event object that is emitted when scrolling occurs.\n * The `type` property indicates the type of dimension (row or column) being scrolled.\n * The `coordinate` property represents the current scroll position in that dimension.\n */\nexport type ScrollCoordinateEvent = {\n  /**\n   * Represents the type of dimension being scrolled.\n   * Possible values are 'rgRow' and 'rgCol'.\n   */\n  type: DimensionType;\n\n  /**\n   * Represents the current scroll position in the specified dimension.\n   * The value is a number representing the coordinate in pixels.\n   */\n  coordinate: number;\n};\n\n/** Range paste. */\nexport interface RangeClipboardPasteEvent extends AllDimensionType {\n  data: DataLookup;\n  models: Partial<DataLookup>;\n  range: RangeArea | null;\n}\n\n/** Range copy. */\nexport interface RangeClipboardCopyEventProps<T = any> extends AllDimensionType {\n  data: DataFormat<T>[][];\n  range: RangeArea;\n  mapping: OldNewRangeMapping;\n}\n\nexport interface AdditionalData {\n  /**\n   * Additional data for grid and plugins\n   */\n  [key: string]: any;\n}\n"]}

package/dist/collection/types/plugin.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=plugin.js.map

package/dist/collection/types/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../src/types/plugin.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * Interface for plugin components\n */\nexport interface PluginBaseComponent {\n    /**\n     * Cleans up plugin's resources\n     */\n    destroy?(): void;\n}\n"]}

package/dist/collection/types/plugin.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=plugin.types.js.map

package/dist/collection/types/plugin.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.types.js","sourceRoot":"","sources":["../../src/types/plugin.types.ts"],"names":[],"mappings":"","sourcesContent":["import { PluginBaseComponent } from '@type';\nimport ColumnDataProvider from '../services/column.data.provider';\nimport { DataProvider } from '../services/data.provider';\nimport DimensionProvider from '../services/dimension.provider';\nimport type { SelectionStoreConnector } from '../services/selection.store.connector';\nimport ViewportProvider from '../services/viewport.provider';\n\nexport interface PluginServiceBase {\n  get(): PluginBaseComponent[];\n  add(plugin: PluginBaseComponent): void;\n  remove(plugin: PluginBaseComponent): void;\n  getByClass<T extends PluginBaseComponent>(\n    pluginClass: new (...args: any[]) => T,\n  ): T | undefined;\n}\n\n/**\n * Services that are provided by the various plugins for use by the grid. Each plugin\n * is responsible for providing a specific service, and the `PluginProviders` type collects all the services provided\n * by the plugins.\n */\nexport type PluginProviders = {\n  /**\n   * The data service provides access to the grid data.\n   */\n  data: DataProvider;\n  /**\n   * The dimension service provides access to the grid's dimensions and settings.\n   */\n  dimension: DimensionProvider;\n  /**\n   * The selection service provides access to the grid's selection state.\n   */\n  selection: SelectionStoreConnector;\n  /**\n   * The column service provides access to the grid's column data.\n   */\n  column: ColumnDataProvider;\n  /**\n   * The viewport service provides access to the grid's viewport state.\n   */\n  viewport: ViewportProvider;\n\n  /**\n   * Plugin services\n   */\n\n  plugins: PluginServiceBase;\n};\n\ndeclare global {\n  type CombinedHTMLRevoGridElementEventMap = Record<string, any> &\n    HTMLRevogrClipboardElementEventMap &\n    HTMLRevogrFocusElementEventMap &\n    HTMLRevogrDataElementEventMap &\n    HTMLRevogrEditElementEventMap &\n    HTMLRevogrFilterPanelElementEventMap &\n    HTMLRevogrHeaderElementEventMap &\n    HTMLRevogrOrderEditorElementEventMap &\n    HTMLRevogrOverlaySelectionElementEventMap &\n    HTMLRevogrRowHeadersElementEventMap &\n    HTMLRevogrScrollVirtualElementEventMap &\n    HTMLRevogrViewportScrollElementEventMap &\n    HTMLVnodeHtmlElementEventMap;\n    \n  interface HTMLRevoGridElementEventMap extends CombinedHTMLRevoGridElementEventMap {\n    //\n  }\n}\n"]}

package/dist/collection/types/selection.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=selection.js.map

package/dist/collection/types/selection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection.js","sourceRoot":"","sources":["../../src/types/selection.ts"],"names":[],"mappings":"","sourcesContent":["import { type VNode } from '@stencil/core';\nimport type { DimensionRows, DimensionCols } from './dimension';\nimport type {\n  ColumnProp,\n  DataType,\n  DataLookup,\n  HyperFunc,\n  ColumnDataSchemaModel,\n  PositionItem,\n} from './interfaces';\n\n// Virtual index of row\nexport type RowIndex = number;\n// Virtual index of row\nexport type ColIndex = number;\n\n/**\n * Represents the state of the selection store.\n * It contains information about the selection range, temporary range,\n * focused cell, editing cell, last focused cell, and next cell to focus.\n */\nexport type SelectionStoreState = {\n  range: RangeArea | null;\n  /**\n   * Temporary range selection area\n   */\n  tempRange: RangeArea | null;\n  /**\n   * Type of the temporary range selection\n   */\n  tempRangeType: string | null;\n  /**\n   * Focused cell coordinate\n   */\n  focus: Cell | null;\n  /**\n   * Editing cell store\n   */\n  edit: EditCellStore | null;\n  /**\n   * Last cell which was focused\n   * The last real coordinate + 1\n   */\n  lastCell: Cell | null;\n  /**\n   * Next cell to focus\n   */\n  nextFocus: Cell | null;\n};\n\n// Virtual index of row (y) and column (x)\nexport type RangeArea = {\n  x: ColIndex;\n  y: RowIndex;\n  x1: ColIndex;\n  y1: RowIndex;\n};\nexport type TempRange = {\n  type: string;\n  area: RangeArea;\n};\nexport type OldNewRangeMapping = {\n  [newRowIndex: number]: {\n    [T in ColumnProp]: { // new column prop\n      rowIndex: number; // Virtual index of original row\n      colIndex: number; // Virtual index of original col\n      colProp: ColumnProp; // original column prop\n    };\n  };\n};\nexport type ChangedRange = {\n  type: DimensionRows;\n  colType: DimensionCols;\n  newRange: RangeArea; // new range to apply\n  oldRange: RangeArea; // range to copy from\n  mapping: OldNewRangeMapping;\n  newData: {\n    [newRowIndex: number]: DataType;\n  };\n};\n\n/**\n * Cell coordinates\n */\nexport interface Cell {\n  x: ColIndex; // Virtual index of column\n  y: RowIndex; // Virtual index of row\n}\nexport type FocusedCells = {\n  focus: Cell;\n  end: Cell;\n};\nexport type RangeAreaCss = {\n  left: string;\n  top: string;\n  width: string;\n  height: string;\n};\n\nexport type SaveDataDetails = {\n  rgRow: RowIndex;  // Virtual index of row\n  rgCol: ColIndex; // Virtual index of column\n  type: DimensionRows;\n  prop: ColumnProp;\n  val: any;\n  preventFocus?: boolean;\n};\n\nexport type BeforeEdit = BeforeSaveDataDetails;\n\nexport type RowDragStartDetails = {\n  cell: Cell;\n  text: string;\n  pos: PositionItem;\n  event: MouseEvent;\n  rowType: DimensionRows;\n  model: any;\n};\n\nexport interface BeforeSaveDataDetails extends ColumnDataSchemaModel {\n  /**\n   * Value from editor to save, not part of the model value yet\n   */\n  val?: any;\n}\n\nexport interface CellClickDetails extends BeforeSaveDataDetails {\n  /**\n   * Original mouse or touch event\n   */\n  originalEvent?: MouseEvent | TouchEvent;\n}\n\nexport type BeforeRangeSaveDataDetails = {\n  data: DataLookup;\n  models: Partial<DataLookup>;\n  type: DimensionRows;\n  newRange: RangeArea | null;\n  oldRange: RangeArea | null;\n};\n\nexport type AfterEditEvent = BeforeRangeSaveDataDetails | BeforeSaveDataDetails;\n\n/**\n * Edit cell info for store\n */\nexport interface EditCellStore extends Cell {\n  val?: any;\n}\n/**\n * Edit cell info for editor\n */\nexport type EditCell = EditCellStore & BeforeSaveDataDetails;\n\n/**\n * Available editors in grid\n */\nexport type Editors = {\n  [name: string]: EditorCtr;\n};\n\n/**\n * Editor component\n */\nexport type EditorCtr = EditorCtrCallable | EditorCtrConstructible;\n\n\n/**\n * Editor component callable function\n */\nexport type EditorCtrCallable = {\n  (\n    column: ColumnDataSchemaModel,\n    save: (value?: any, preventFocus?: boolean) => void,\n    close: (focusNext?: boolean) => void,\n  ): EditorBase;\n}\n/**\n * Editor component constructible class\n */\nexport interface EditorCtrConstructible {\n  new (\n    column: ColumnDataSchemaModel,\n    save: (value: any, preventFocus?: boolean) => void,\n    close: (focusNext?: boolean) => void,\n  ): EditorBase;\n}\n\n/**\n * Editor interface\n */\nexport interface EditorBase {\n  element?: Element | null;\n  editCell?: EditCell;\n  /**\n   * Autosave usage when you want to return value for models.\n   */\n  getValue?(): any;\n  /**\n   * For Editor plugin internal usage.\n   * Prevents Editor save. Manual save usage required.\n   */\n  beforeAutoSave?(val?: any): boolean;\n  beforeUpdate?(): void;\n  /**\n   * Before editor got disconnected.\n   * Can be triggered multiple times before actual disconnect.\n   */\n  beforeDisconnect?(): void;\n  componentDidRender?(): void;\n  disconnectedCallback?(): void;\n  render(\n    createElement: HyperFunc<VNode>,\n    additionalData?: any,\n  ): VNode | VNode[] | string | void;\n}\n"]}

package/dist/collection/types/theme.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=theme.js.map

package/dist/collection/types/theme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.js","sourceRoot":"","sources":["../../src/types/theme.ts"],"names":[],"mappings":"","sourcesContent":["export interface ThemePackage {\n  defaultRowSize: number;\n}\n\nexport type ThemeConfig = {\n  rowSize: number;\n};\n\nexport type Theme =\n  | 'default'\n  | 'material'\n  | 'compact'\n  | 'darkMaterial'\n  | 'darkCompact'\n  | string;\n"]}

package/dist/collection/types/viewport.interfaces.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=viewport.interfaces.js.map

package/dist/collection/types/viewport.interfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewport.interfaces.js","sourceRoot":"","sources":["../../src/types/viewport.interfaces.ts"],"names":[],"mappings":"","sourcesContent":["import type { JSXBase } from '@stencil/core/internal';\nimport type {\n  DimensionCols,\n  ColumnRegular,\n  ViewPortScrollEvent,\n  ViewportState,\n  Cell,\n  SelectionStoreState,\n} from '@type';\nimport type {\n  DimensionStoreCollection,\n  ViewportStoreCollection,\n  DSourceState,\n} from '@store';\nimport type { Observable } from '../utils';\nimport type { RowDataSources } from '../services/data.provider';\nimport type { JSX } from '..';\n\nexport type SlotType = 'content' | 'header' | 'footer';\n\nexport interface ElementScroll {\n  changeScroll?(\n    e: ViewPortScrollEvent,\n    silent?: boolean,\n  ): Promise<ViewPortScrollEvent | undefined>;\n  setScroll?(e: ViewPortScrollEvent): Promise<void>;\n}\nexport type ElementsScroll = { [key: string]: ElementScroll[] };\n\nexport type HeaderProperties = JSX.RevogrHeader;\n\nexport type ViewportProperties = JSX.RevogrViewportScroll &\n  JSXBase.HTMLAttributes<HTMLRevogrViewportScrollElement>;\n\nexport type ViewportColumn = {\n  colType: DimensionCols;\n  position: Cell;\n\n  fixWidth?: boolean;\n\n  viewports: ViewportStoreCollection;\n  dimensions: DimensionStoreCollection;\n\n  rowStores: RowDataSources;\n  colStore: Observable<DSourceState<ColumnRegular, DimensionCols>>;\n} & Partial<JSX.RevogrViewportScroll> &\n  Partial<JSX.RevogrHeader>;\n\nexport type ViewportData = {\n  /** Slot to put data */\n  slot: SlotType;\n  style?: { [key: string]: string };\n} & JSX.RevogrOverlaySelection &\n  (Pick<JSXBase.HTMLAttributes<HTMLRevogrOverlaySelectionElement>, 'ref'> &\n    Pick<JSXBase.HTMLAttributes<HTMLRevogrDataElement>, 'ref'>) &\n  JSX.RevogrData;\n\nexport type ViewportProps = {\n  prop: JSX.RevogrViewportScroll &\n    JSXBase.HTMLAttributes<HTMLRevogrViewportScrollElement>;\n  position: Cell;\n  type: DimensionCols;\n  /** Cols dataset */\n  viewportCol: Observable<ViewportState>;\n\n  /** header container props */\n  headerProp: HeaderProperties;\n\n  /** parent selector link */\n  // parent: string;\n\n  /** viewport rows */\n  dataPorts: ViewportData[];\n\n  columnSelectionStore: Observable<SelectionStoreState>;\n};\n"]}

package/dist/collection/utils/batchGroupCollapse.js

@@ -0,0 +1,190 @@
+/*!
+ * Built by Revolist OU ❤️
+ */
+/**
+ * 批量折叠分组工具
+ * 一次性折叠多个指定分组，无动画闪烁，性能最优
+ */
+const GROUP_KEY_PROP = '__rvgr-value';
+const GROUP_EXPANDED_PROP = '__rvgr-expanded';
+/**
+ * 内部辅助函数：更新分组展开状态
+ */
+async function updateGroupExpandedState(grid, groupKeys, expanded, preserveChildState = false) {
+    if (!grid || !groupKeys.length)
+        return;
+    const source = await grid.getSource('rgRow');
+    const currentExpandedState = {};
+    source.forEach(row => {
+        const key = row === null || row === void 0 ? void 0 : row[GROUP_KEY_PROP];
+        if (key)
+            currentExpandedState[key] = !!row[GROUP_EXPANDED_PROP];
+    });
+    const currentGrouping = grid.grouping || {};
+    const newExpandedState = {};
+    // 将所有历史和当前分组默认设为展开
+    Object.keys(currentGrouping.prevExpanded || {}).forEach(key => newExpandedState[key] = true);
+    Object.keys(currentExpandedState).forEach(key => newExpandedState[key] = true);
+    // 更新指定分组状态
+    const keysSet = new Set(groupKeys);
+    keysSet.forEach(key => {
+        newExpandedState[key] = expanded;
+        // 折叠时保持子分组展开
+        if (preserveChildState && !expanded) {
+            Object.keys(currentExpandedState).forEach(childKey => {
+                if (childKey.startsWith(key + ',') && !keysSet.has(childKey)) {
+                    newExpandedState[childKey] = true;
+                }
+            });
+        }
+    });
+    grid.grouping = Object.assign(Object.assign({}, currentGrouping), { expandedAll: false, prevExpanded: newExpandedState });
+}
+/**
+ * 批量折叠指定的分组（一次性完成，无视觉闪烁）
+ *
+ * 核心原理：
+ * 1. 收集所有分组的当前展开状态
+ * 2. 将要折叠的分组状态设为 false
+ * 3. 保留子分组的展开状态（这样重新展开父分组时，子分组会保持原状态）
+ * 4. 通过更新 grouping.prevExpanded 并触发重新分组来应用更改
+ *
+ * @param grid - RevoGrid 实例
+ * @param groupKeysToCollapse - 要折叠的分组 key 数组，例如：['V1.0', 'V2.0,需求']
+ * @returns Promise<void>
+ *
+ * @example
+ * ```typescript
+ * // 折叠多个指定分组
+ * await batchCollapseGroups(grid.value, [
+ *   '技术部',
+ *   '技术部,电商平台',
+ *   '产品部,用户增长,P0'
+ * ]);
+ * ```
+ */
+export async function batchCollapseGroups(grid, groupKeysToCollapse) {
+    await updateGroupExpandedState(grid, groupKeysToCollapse, false, true);
+}
+/**
+ * 批量展开指定的分组
+ *
+ * @param grid - RevoGrid 实例
+ * @param groupKeysToExpand - 要展开的分组 key 数组
+ * @returns Promise<void>
+ */
+export async function batchExpandGroups(grid, groupKeysToExpand) {
+    await updateGroupExpandedState(grid, groupKeysToExpand, true);
+}
+/**
+ * 切换指定分组的展开/折叠状态
+ *
+ * @param grid - RevoGrid 实例
+ * @param groupKeysToToggle - 要切换的分组 key 数组
+ * @returns Promise<void>
+ */
+export async function batchToggleGroups(grid, groupKeysToToggle) {
+    if (!grid || !groupKeysToToggle.length)
+        return;
+    const source = await grid.getSource('rgRow');
+    const keysSet = new Set(groupKeysToToggle);
+    const toCollapse = [];
+    const toExpand = [];
+    source.forEach(row => {
+        const key = row === null || row === void 0 ? void 0 : row[GROUP_KEY_PROP];
+        if (key && keysSet.has(key)) {
+            (row[GROUP_EXPANDED_PROP] ? toCollapse : toExpand).push(key);
+        }
+    });
+    if (toCollapse.length)
+        await batchCollapseGroups(grid, toCollapse);
+    if (toExpand.length)
+        await batchExpandGroups(grid, toExpand);
+}
+/**
+ * 根据条件批量折叠分组
+ *
+ * @param grid - RevoGrid 实例
+ * @param predicate - 判断函数，返回 true 的分组会被折叠
+ * @returns Promise<void>
+ *
+ * @example
+ * ```typescript
+ * // 折叠所有包含 "技术部" 的分组
+ * await batchCollapseGroupsByCondition(grid.value, (key) => key.includes('技术部'));
+ *
+ * // 折叠所有二级分组（包含一个逗号）
+ * await batchCollapseGroupsByCondition(grid.value, (key) => key.split(',').length === 2);
+ * ```
+ */
+export async function batchCollapseGroupsByCondition(grid, predicate) {
+    if (!grid) {
+        return;
+    }
+    const source = await grid.getSource('rgRow');
+    const groupKeysToCollapse = [];
+    source.forEach(row => {
+        const key = row === null || row === void 0 ? void 0 : row[GROUP_KEY_PROP];
+        if (key && predicate(key)) {
+            groupKeysToCollapse.push(key);
+        }
+    });
+    if (groupKeysToCollapse.length === 0) {
+        console.log('⚠️ 没有符合条件的分组需要折叠');
+        return;
+    }
+    await batchCollapseGroups(grid, groupKeysToCollapse);
+}
+/**
+ * 获取所有分组的 key 列表
+ *
+ * @param grid - RevoGrid 实例
+ * @param level - 可选，指定层级（0=一级，1=二级，2=三级...）
+ * @returns Promise<string[]>
+ */
+export async function getAllGroupKeys(grid, level) {
+    if (!grid) {
+        return [];
+    }
+    const source = await grid.getSource('rgRow');
+    const keys = [];
+    source.forEach(row => {
+        const key = row === null || row === void 0 ? void 0 : row[GROUP_KEY_PROP];
+        if (key) {
+            // 如果指定了层级，只返回该层级的分组
+            if (typeof level === 'number') {
+                // 层级 = 逗号数量（一级分组没有逗号，二级有1个逗号，三级有2个逗号）
+                const commaCount = (key.match(/,/g) || []).length;
+                if (commaCount === level) {
+                    keys.push(key);
+                }
+            }
+            else {
+                keys.push(key);
+            }
+        }
+    });
+    return keys;
+}
+/**
+ * 获取所有展开/折叠的分组 key
+ *
+ * @param grid - RevoGrid 实例
+ * @param expanded - true=获取展开的，false=获取折叠的
+ * @returns Promise<string[]>
+ */
+export async function getGroupKeysByState(grid, expanded) {
+    if (!grid) {
+        return [];
+    }
+    const source = await grid.getSource('rgRow');
+    const keys = [];
+    source.forEach(row => {
+        const key = row === null || row === void 0 ? void 0 : row[GROUP_KEY_PROP];
+        if (key && !!row[GROUP_EXPANDED_PROP] === expanded) {
+            keys.push(key);
+        }
+    });
+    return keys;
+}
+//# sourceMappingURL=batchGroupCollapse.js.map

package/dist/collection/utils/batchGroupCollapse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"batchGroupCollapse.js","sourceRoot":"","sources":["../../src/utils/batchGroupCollapse.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * 批量折叠分组工具\n * 一次性折叠多个指定分组，无动画闪烁，性能最优\n */\n\nconst GROUP_KEY_PROP = '__rvgr-value';\nconst GROUP_EXPANDED_PROP = '__rvgr-expanded';\n\n/**\n * 内部辅助函数：更新分组展开状态\n */\nasync function updateGroupExpandedState(\n  grid: HTMLRevoGridElement,\n  groupKeys: string[],\n  expanded: boolean,\n  preserveChildState = false\n): Promise<void> {\n  if (!grid || !groupKeys.length) return;\n\n  const source = await grid.getSource('rgRow');\n  const currentExpandedState: Record<string, boolean> = {};\n  \n  source.forEach(row => {\n    const key = row?.[GROUP_KEY_PROP];\n    if (key) currentExpandedState[key] = !!row[GROUP_EXPANDED_PROP];\n  });\n\n  const currentGrouping = grid.grouping || {};\n  const newExpandedState: Record<string, boolean> = {};\n  \n  // 将所有历史和当前分组默认设为展开\n  Object.keys(currentGrouping.prevExpanded || {}).forEach(key => newExpandedState[key] = true);\n  Object.keys(currentExpandedState).forEach(key => newExpandedState[key] = true);\n  \n  // 更新指定分组状态\n  const keysSet = new Set(groupKeys);\n  keysSet.forEach(key => {\n    newExpandedState[key] = expanded;\n    \n    // 折叠时保持子分组展开\n    if (preserveChildState && !expanded) {\n      Object.keys(currentExpandedState).forEach(childKey => {\n        if (childKey.startsWith(key + ',') && !keysSet.has(childKey)) {\n          newExpandedState[childKey] = true;\n        }\n      });\n    }\n  });\n\n  grid.grouping = {\n    ...currentGrouping,\n    expandedAll: false,\n    prevExpanded: newExpandedState,\n  };\n}\n\n/**\n * 批量折叠指定的分组（一次性完成，无视觉闪烁）\n * \n * 核心原理：\n * 1. 收集所有分组的当前展开状态\n * 2. 将要折叠的分组状态设为 false\n * 3. 保留子分组的展开状态（这样重新展开父分组时，子分组会保持原状态）\n * 4. 通过更新 grouping.prevExpanded 并触发重新分组来应用更改\n * \n * @param grid - RevoGrid 实例\n * @param groupKeysToCollapse - 要折叠的分组 key 数组，例如：['V1.0', 'V2.0,需求']\n * @returns Promise<void>\n * \n * @example\n * ```typescript\n * // 折叠多个指定分组\n * await batchCollapseGroups(grid.value, [\n *   '技术部',\n *   '技术部,电商平台',\n *   '产品部,用户增长,P0'\n * ]);\n * ```\n */\nexport async function batchCollapseGroups(\n  grid: HTMLRevoGridElement,\n  groupKeysToCollapse: string[]\n): Promise<void> {\n  await updateGroupExpandedState(grid, groupKeysToCollapse, false, true);\n}\n\n/**\n * 批量展开指定的分组\n * \n * @param grid - RevoGrid 实例\n * @param groupKeysToExpand - 要展开的分组 key 数组\n * @returns Promise<void>\n */\nexport async function batchExpandGroups(\n  grid: HTMLRevoGridElement,\n  groupKeysToExpand: string[]\n): Promise<void> {\n  await updateGroupExpandedState(grid, groupKeysToExpand, true);\n}\n\n/**\n * 切换指定分组的展开/折叠状态\n * \n * @param grid - RevoGrid 实例\n * @param groupKeysToToggle - 要切换的分组 key 数组\n * @returns Promise<void>\n */\nexport async function batchToggleGroups(\n  grid: HTMLRevoGridElement,\n  groupKeysToToggle: string[]\n): Promise<void> {\n  if (!grid || !groupKeysToToggle.length) return;\n\n  const source = await grid.getSource('rgRow');\n  const keysSet = new Set(groupKeysToToggle);\n  const toCollapse: string[] = [];\n  const toExpand: string[] = [];\n  \n  source.forEach(row => {\n    const key = row?.[GROUP_KEY_PROP];\n    if (key && keysSet.has(key)) {\n      (row[GROUP_EXPANDED_PROP] ? toCollapse : toExpand).push(key);\n    }\n  });\n\n  if (toCollapse.length) await batchCollapseGroups(grid, toCollapse);\n  if (toExpand.length) await batchExpandGroups(grid, toExpand);\n}\n\n/**\n * 根据条件批量折叠分组\n * \n * @param grid - RevoGrid 实例\n * @param predicate - 判断函数，返回 true 的分组会被折叠\n * @returns Promise<void>\n * \n * @example\n * ```typescript\n * // 折叠所有包含 \"技术部\" 的分组\n * await batchCollapseGroupsByCondition(grid.value, (key) => key.includes('技术部'));\n * \n * // 折叠所有二级分组（包含一个逗号）\n * await batchCollapseGroupsByCondition(grid.value, (key) => key.split(',').length === 2);\n * ```\n */\nexport async function batchCollapseGroupsByCondition(\n  grid: HTMLRevoGridElement,\n  predicate: (key: string) => boolean\n): Promise<void> {\n  if (!grid) {\n    return;\n  }\n\n  const source = await grid.getSource('rgRow');\n  const groupKeysToCollapse: string[] = [];\n  \n  source.forEach(row => {\n    const key = row?.[GROUP_KEY_PROP];\n    if (key && predicate(key)) {\n      groupKeysToCollapse.push(key);\n    }\n  });\n\n  if (groupKeysToCollapse.length === 0) {\n    console.log('⚠️ 没有符合条件的分组需要折叠');\n    return;\n  }\n\n  await batchCollapseGroups(grid, groupKeysToCollapse);\n}\n\n/**\n * 获取所有分组的 key 列表\n * \n * @param grid - RevoGrid 实例\n * @param level - 可选，指定层级（0=一级，1=二级，2=三级...）\n * @returns Promise<string[]>\n */\nexport async function getAllGroupKeys(\n  grid: HTMLRevoGridElement,\n  level?: number\n): Promise<string[]> {\n  if (!grid) {\n    return [];\n  }\n\n  const source = await grid.getSource('rgRow');\n  const keys: string[] = [];\n  \n  source.forEach(row => {\n    const key = row?.[GROUP_KEY_PROP];\n    if (key) {\n      // 如果指定了层级，只返回该层级的分组\n      if (typeof level === 'number') {\n        // 层级 = 逗号数量（一级分组没有逗号，二级有1个逗号，三级有2个逗号）\n        const commaCount = (key.match(/,/g) || []).length;\n        if (commaCount === level) {\n          keys.push(key);\n        }\n      } else {\n        keys.push(key);\n      }\n    }\n  });\n\n  return keys;\n}\n\n/**\n * 获取所有展开/折叠的分组 key\n * \n * @param grid - RevoGrid 实例\n * @param expanded - true=获取展开的，false=获取折叠的\n * @returns Promise<string[]>\n */\nexport async function getGroupKeysByState(\n  grid: HTMLRevoGridElement,\n  expanded: boolean\n): Promise<string[]> {\n  if (!grid) {\n    return [];\n  }\n\n  const source = await grid.getSource('rgRow');\n  const keys: string[] = [];\n  \n  source.forEach(row => {\n    const key = row?.[GROUP_KEY_PROP];\n    if (key && !!row[GROUP_EXPANDED_PROP] === expanded) {\n      keys.push(key);\n    }\n  });\n\n  return keys;\n}\n"]}

package/dist/collection/utils/browser.js

@@ -0,0 +1,7 @@
+/*!
+ * Built by Revolist OU ❤️
+ */
+export function isSafariDesktop() {
+    return /Safari/i.test(navigator.userAgent) && !/Chrome/i.test(navigator.userAgent) && !navigator.userAgent.match(/(iPad|iPhone|iPod)/g);
+}
+//# sourceMappingURL=browser.js.map

package/dist/collection/utils/browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../../src/utils/browser.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,eAAe;IAC3B,OAAO,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;AAC5I,CAAC","sourcesContent":["export function isSafariDesktop() {\n    return /Safari/i.test(navigator.userAgent) && !/Chrome/i.test(navigator.userAgent) && !navigator.userAgent.match(/(iPad|iPhone|iPod)/g);\n}\n"]}

package/dist/collection/utils/cell-template-helper.js

@@ -0,0 +1,181 @@
+/*!
+ * Built by Revolist OU ❤️
+ */
+/**
+ * 高性能单元格模板辅助工具
+ *
+ * 当使用 Vue/React 等框架组件作为单元格渲染器时，滚动性能可能会下降。
+ * 这是因为框架组件的创建/挂载开销较大。
+ *
+ * 本工具提供原生的高性能渲染方案，适用于对滚动性能要求较高的场景。
+ */
+/**
+ * 创建高性能单元格模板
+ *
+ * @example
+ * ```ts
+ * const priorityTemplate = createCellTemplate((h, { value }) => {
+ *   const colors = { P0: '#f5222d', P1: '#fa541c', P2: '#faad14' };
+ *   return h('span', {
+ *     style: { color: colors[value] || '#999' }
+ *   }, value);
+ * });
+ *
+ * const columns = [
+ *   { prop: 'priority', cellTemplate: priorityTemplate }
+ * ];
+ * ```
+ */
+export function createCellTemplate(renderFn) {
+    return renderFn;
+}
+/**
+ * 带缓存的单元格模板
+ * 当单元格值没有变化时，返回缓存的结果
+ *
+ * @param renderFn 渲染函数
+ * @param getCacheKey 获取缓存键的函数，默认使用 rowIndex-prop-value
+ */
+export function createCachedCellTemplate(renderFn, getCacheKey) {
+    const cache = new Map();
+    return (h, props, additionalData) => {
+        const key = getCacheKey
+            ? getCacheKey(props)
+            : `${props.rowIndex}-${props.prop}-${JSON.stringify(props.value)}`;
+        if (cache.has(key)) {
+            return cache.get(key);
+        }
+        const result = renderFn(h, props, additionalData);
+        cache.set(key, result);
+        // 限制缓存大小，避免内存泄漏
+        if (cache.size > 1000) {
+            const firstKey = cache.keys().next().value;
+            if (firstKey) {
+                cache.delete(firstKey);
+            }
+        }
+        return result;
+    };
+}
+/**
+ * 常用的单元格渲染器
+ */
+export const CellRenderers = {
+    /**
+     * 带颜色标签的渲染器
+     */
+    colorTag: (colorMap) => {
+        return createCellTemplate((h, { value }) => {
+            const color = colorMap[value] || '#999';
+            return h('span', {
+                style: {
+                    display: 'inline-block',
+                    padding: '2px 8px',
+                    borderRadius: '4px',
+                    fontSize: '12px',
+                    background: color + '20',
+                    color: color
+                }
+            }, String(value !== null && value !== void 0 ? value : ''));
+        });
+    },
+    /**
+     * 进度条渲染器
+     */
+    progressBar: (options) => {
+        const { height = 6, colors = { low: '#f5222d', mid: '#faad14', high: '#52c41a' } } = options || {};
+        return createCellTemplate((h, { value }) => {
+            const progress = Number(value) || 0;
+            const color = progress >= 70 ? colors.high : progress >= 30 ? colors.mid : colors.low;
+            return h('div', {
+                style: {
+                    display: 'flex',
+                    alignItems: 'center',
+                    gap: '8px',
+                    padding: '0 8px'
+                }
+            }, [
+                h('div', {
+                    style: {
+                        flex: '1',
+                        height: `${height}px`,
+                        background: '#e0e0e0',
+                        borderRadius: `${height / 2}px`,
+                        overflow: 'hidden'
+                    }
+                }, [
+                    h('div', {
+                        style: {
+                            width: `${progress}%`,
+                            height: '100%',
+                            background: color,
+                            borderRadius: `${height / 2}px`
+                        }
+                    })
+                ]),
+                h('span', {
+                    style: { fontSize: '12px', color: '#666', minWidth: '36px' }
+                }, `${progress}%`)
+            ]);
+        });
+    },
+    /**
+     * 头像渲染器
+     */
+    avatar: (options) => {
+        const { size = 28, colors = ['#f56a00', '#7265e6', '#ffbf00', '#00a2ae', '#eb2f96'] } = options || {};
+        return createCellTemplate((h, { value, rowIndex }) => {
+            const name = String(value !== null && value !== void 0 ? value : '');
+            const color = colors[(name.charCodeAt(0) || rowIndex) % colors.length];
+            return h('div', {
+                style: {
+                    display: 'flex',
+                    alignItems: 'center',
+                    gap: '8px',
+                    padding: '0 8px'
+                }
+            }, [
+                h('div', {
+                    style: {
+                        width: `${size}px`,
+                        height: `${size}px`,
+                        borderRadius: '50%',
+                        background: color,
+                        display: 'flex',
+                        alignItems: 'center',
+                        justifyContent: 'center',
+                        color: 'white',
+                        fontWeight: '600',
+                        fontSize: `${size * 0.4}px`
+                    }
+                }, name.charAt(0) || '?'),
+                h('span', {}, name)
+            ]);
+        });
+    },
+    /**
+     * 状态指示器渲染器
+     */
+    status: (statusConfig) => {
+        return createCellTemplate((h, { value }) => {
+            const status = String(value !== null && value !== void 0 ? value : '');
+            const config = statusConfig[status] || { color: '#999' };
+            return h('div', {
+                style: {
+                    display: 'flex',
+                    alignItems: 'center',
+                    gap: '6px',
+                    padding: '2px 8px',
+                    borderRadius: '4px',
+                    background: config.color + '15',
+                    color: config.color,
+                    fontSize: '12px'
+                }
+            }, [
+                config.icon ? h('span', {}, config.icon) : null,
+                h('span', {}, status)
+            ].filter(Boolean));
+        });
+    }
+};
+//# sourceMappingURL=cell-template-helper.js.map

package/dist/collection/utils/cell-template-helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cell-template-helper.js","sourceRoot":"","sources":["../../src/utils/cell-template-helper.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * 高性能单元格模板辅助工具\n * \n * 当使用 Vue/React 等框架组件作为单元格渲染器时，滚动性能可能会下降。\n * 这是因为框架组件的创建/挂载开销较大。\n * \n * 本工具提供原生的高性能渲染方案，适用于对滚动性能要求较高的场景。\n */\n\nimport type { HyperFunc, ColumnDataSchemaModel } from '../types';\nimport type { VNode } from '@stencil/core';\n\n/**\n * 单元格渲染函数类型\n */\nexport type CellRenderFn = (\n  h: HyperFunc<VNode>,\n  props: ColumnDataSchemaModel,\n  additionalData?: any\n) => VNode | VNode[] | string;\n\n/**\n * 创建高性能单元格模板\n * \n * @example\n * ```ts\n * const priorityTemplate = createCellTemplate((h, { value }) => {\n *   const colors = { P0: '#f5222d', P1: '#fa541c', P2: '#faad14' };\n *   return h('span', { \n *     style: { color: colors[value] || '#999' } \n *   }, value);\n * });\n * \n * const columns = [\n *   { prop: 'priority', cellTemplate: priorityTemplate }\n * ];\n * ```\n */\nexport function createCellTemplate(renderFn: CellRenderFn) {\n  return renderFn;\n}\n\n/**\n * 带缓存的单元格模板\n * 当单元格值没有变化时，返回缓存的结果\n * \n * @param renderFn 渲染函数\n * @param getCacheKey 获取缓存键的函数，默认使用 rowIndex-prop-value\n */\nexport function createCachedCellTemplate(\n  renderFn: CellRenderFn,\n  getCacheKey?: (props: ColumnDataSchemaModel) => string\n) {\n  const cache = new Map<string, VNode | VNode[] | string>();\n  \n  return (h: HyperFunc<VNode>, props: ColumnDataSchemaModel, additionalData?: any) => {\n    const key = getCacheKey \n      ? getCacheKey(props) \n      : `${props.rowIndex}-${props.prop}-${JSON.stringify(props.value)}`;\n    \n    if (cache.has(key)) {\n      return cache.get(key)!;\n    }\n    \n    const result = renderFn(h, props, additionalData);\n    cache.set(key, result);\n    \n    // 限制缓存大小，避免内存泄漏\n    if (cache.size > 1000) {\n      const firstKey = cache.keys().next().value;\n      if (firstKey) {\n        cache.delete(firstKey);\n      }\n    }\n    \n    return result;\n  };\n}\n\n/**\n * 常用的单元格渲染器\n */\nexport const CellRenderers = {\n  /**\n   * 带颜色标签的渲染器\n   */\n  colorTag: (colorMap: Record<string, string>) => {\n    return createCellTemplate((h, { value }) => {\n      const color = colorMap[value as string] || '#999';\n      return h('span', {\n        style: {\n          display: 'inline-block',\n          padding: '2px 8px',\n          borderRadius: '4px',\n          fontSize: '12px',\n          background: color + '20',\n          color: color\n        }\n      }, String(value ?? ''));\n    });\n  },\n\n  /**\n   * 进度条渲染器\n   */\n  progressBar: (options?: { height?: number; colors?: { low: string; mid: string; high: string } }) => {\n    const { height = 6, colors = { low: '#f5222d', mid: '#faad14', high: '#52c41a' } } = options || {};\n    \n    return createCellTemplate((h, { value }) => {\n      const progress = Number(value) || 0;\n      const color = progress >= 70 ? colors.high : progress >= 30 ? colors.mid : colors.low;\n      \n      return h('div', {\n        style: {\n          display: 'flex',\n          alignItems: 'center',\n          gap: '8px',\n          padding: '0 8px'\n        }\n      }, [\n        h('div', {\n          style: {\n            flex: '1',\n            height: `${height}px`,\n            background: '#e0e0e0',\n            borderRadius: `${height / 2}px`,\n            overflow: 'hidden'\n          }\n        }, [\n          h('div', {\n            style: {\n              width: `${progress}%`,\n              height: '100%',\n              background: color,\n              borderRadius: `${height / 2}px`\n            }\n          })\n        ]),\n        h('span', {\n          style: { fontSize: '12px', color: '#666', minWidth: '36px' }\n        }, `${progress}%`)\n      ]);\n    });\n  },\n\n  /**\n   * 头像渲染器\n   */\n  avatar: (options?: { size?: number; colors?: string[] }) => {\n    const { \n      size = 28, \n      colors = ['#f56a00', '#7265e6', '#ffbf00', '#00a2ae', '#eb2f96'] \n    } = options || {};\n    \n    return createCellTemplate((h, { value, rowIndex }) => {\n      const name = String(value ?? '');\n      const color = colors[(name.charCodeAt(0) || rowIndex) % colors.length];\n      \n      return h('div', {\n        style: {\n          display: 'flex',\n          alignItems: 'center',\n          gap: '8px',\n          padding: '0 8px'\n        }\n      }, [\n        h('div', {\n          style: {\n            width: `${size}px`,\n            height: `${size}px`,\n            borderRadius: '50%',\n            background: color,\n            display: 'flex',\n            alignItems: 'center',\n            justifyContent: 'center',\n            color: 'white',\n            fontWeight: '600',\n            fontSize: `${size * 0.4}px`\n          }\n        }, name.charAt(0) || '?'),\n        h('span', {}, name)\n      ]);\n    });\n  },\n\n  /**\n   * 状态指示器渲染器\n   */\n  status: (statusConfig: Record<string, { color: string; icon?: string }>) => {\n    return createCellTemplate((h, { value }) => {\n      const status = String(value ?? '');\n      const config = statusConfig[status] || { color: '#999' };\n      \n      return h('div', {\n        style: {\n          display: 'flex',\n          alignItems: 'center',\n          gap: '6px',\n          padding: '2px 8px',\n          borderRadius: '4px',\n          background: config.color + '15',\n          color: config.color,\n          fontSize: '12px'\n        }\n      }, [\n        config.icon ? h('span', {}, config.icon) : null,\n        h('span', {}, status)\n      ].filter(Boolean));\n    });\n  }\n};\n"]}

package/dist/collection/utils/closest.polifill.js

@@ -0,0 +1,22 @@
+/*!
+ * Built by Revolist OU ❤️
+ */
+(function closest() {
+    if (!Element.prototype.matches) {
+        Element.prototype.matches =
+            Element.prototype.msMatchesSelector || Element.prototype.webkitMatchesSelector;
+    }
+    if (!Element.prototype.closest) {
+        Element.prototype.closest = function (s) {
+            let el = this;
+            do {
+                if (Element.prototype.matches.call(el, s)) {
+                    return el;
+                }
+                el = el.parentElement || el.parentNode;
+            } while (el !== null && el.nodeType === 1);
+            return null;
+        };
+    }
+})();
+//# sourceMappingURL=closest.polifill.js.map

package/dist/collection/utils/closest.polifill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"closest.polifill.js","sourceRoot":"","sources":["../../src/utils/closest.polifill.ts"],"names":[],"mappings":"AAAA,CAAC,SAAS,OAAO;IACf,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;QAC/B,OAAO,CAAC,SAAS,CAAC,OAAO;YACrB,OAAO,CAAC,SAA+E,CAAC,iBAAiB,IAAI,OAAO,CAAC,SAAS,CAAC,qBAAqB,CAAC;IAC3J,CAAC;IAED,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;QAC/B,OAAO,CAAC,SAAS,CAAC,OAAO,GAAG,UAAU,CAAS;YAC7C,IAAI,EAAE,GAAuD,IAAI,CAAC;YAElE,GAAG,CAAC;gBACF,IAAI,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC;oBAC1C,OAAO,EAAE,CAAC;gBACZ,CAAC;gBACD,EAAE,GAAG,EAAE,CAAC,aAAa,IAAI,EAAE,CAAC,UAAU,CAAC;YACzC,CAAC,QAAQ,EAAE,KAAK,IAAI,IAAI,EAAE,CAAC,QAAQ,KAAK,CAAC,EAAE;YAC3C,OAAO,IAAI,CAAC;QACd,CAAC,CAAC;IACJ,CAAC;AACH,CAAC,CAAC,EAAE,CAAC","sourcesContent":["(function closest() {\n  if (!Element.prototype.matches) {\n    Element.prototype.matches =\n      ((Element.prototype as unknown) as { msMatchesSelector: (selectors: string) => boolean }).msMatchesSelector || Element.prototype.webkitMatchesSelector;\n  }\n\n  if (!Element.prototype.closest) {\n    Element.prototype.closest = function (s: string) {\n      let el: HTMLElement | Element | (Node & ParentNode) | null = this;\n\n      do {\n        if (Element.prototype.matches.call(el, s)) {\n          return el;\n        }\n        el = el.parentElement || el.parentNode;\n      } while (el !== null && el.nodeType === 1);\n      return null;\n    };\n  }\n})();\n"]}