balala-revogrid 1.0.0

package/dist/types/plugins/pin-shadow.plugin.d.ts

@@ -0,0 +1,73 @@
+import type { PluginProviders } from "../types/index";
+import { BasePlugin } from './base.plugin';
+/**
+ * 冻结列阴影插件
+ * 只有在内容滚动时才显示冻结列的阴影，类似 position: sticky 效果
+ * 同时支持头部阴影，垂直滚动时显示
+ */
+export declare class PinShadowPlugin extends BasePlugin {
+    private static readonly SHADOW_SYNC_FRAMES;
+    private static readonly VIEWPORT_RECOVERY_COOLDOWN;
+    private static readonly COVERAGE_CHECK_INTERVAL;
+    private scrollTop;
+    private maxScrollLeft;
+    private syncFrameId;
+    private pendingHorizontalSync;
+    private pendingVerticalSync;
+    private pinShadowSyncFrameId;
+    private pinShadowSyncFrameCount;
+    private lastViewportRecoveryAt;
+    private mainViewportEl;
+    private verticalScrollEl;
+    private viewportsContainerEl;
+    private pinStartViewportEl;
+    private pinEndViewportEl;
+    private headerEl;
+    private pinStartWidth;
+    private pinEndWidth;
+    private headerHeight;
+    private hasVerticalScrollSpace;
+    private pinStartShadowApplied;
+    private pinEndShadowApplied;
+    private headerShadowApplied;
+    private pinStartShadowOffset;
+    private pinEndShadowOffset;
+    private headerShadowOffset;
+    private lastMainScrollLeft;
+    private lastPinShadowSnapshot;
+    private lastCoverageCheckAt;
+    private readonly onMainViewportScroll;
+    private readonly onVerticalViewportScroll;
+    private resizeDebounceTimer;
+    private isResizing;
+    private static readonly RESIZE_DEBOUNCE_DELAY;
+    private static readonly VERTICAL_SCROLL_THRESHOLD;
+    constructor(revogrid: HTMLRevoGridElement, providers: PluginProviders);
+    private cacheStaticElements;
+    private refreshStaticMetrics;
+    private clearShadowState;
+    private bindViewportDomListeners;
+    private ensureViewportBindings;
+    private schedulePinShadowSync;
+    private shouldSyncHeaderShadow;
+    private scheduleDomSync;
+    /**
+     * 处理 resize 事件，使用防抖避免频繁更新
+     */
+    private onResize;
+    /**
+     * resize 进行中同步阴影偏移，不切换显隐状态，避免头部/冻结列阴影闪烁
+     */
+    private syncShadowOffsetsDuringResize;
+    /**
+     * 从 DOM 中重新获取当前的垂直滚动位置（仅用于初始化/重布局后的兜底）
+     */
+    private refreshVerticalScrollPosition;
+    private onScroll;
+    private setPinStartShadow;
+    private setPinEndShadow;
+    private setHeaderShadow;
+    private updatePinShadow;
+    private updateHeaderShadow;
+    destroy(): void;
+}

package/dist/types/plugins/resize-indicator.plugin.d.ts

@@ -0,0 +1,71 @@
+/**
+ * 列宽拖拽指示线插件
+ * 让拖拽列宽时的蓝色指示线延伸到整个表格高度
+ */
+import { BasePlugin } from './base.plugin';
+import type { PluginProviders } from "../types/index";
+export interface ResizeIndicatorConfig {
+    /** 是否启用全高度指示线，默认 true */
+    enabled?: boolean;
+    /** 指示线颜色，默认 deepskyblue */
+    color?: string;
+    /** 指示线宽度，默认 2px */
+    width?: number;
+    /** 底部偏移量，指示线高度会减去这个值，默认 0 */
+    bottomOffset?: number;
+}
+export declare class ResizeIndicatorPlugin extends BasePlugin {
+    private config;
+    private mouseDownHandler;
+    private hoveredResizableElement;
+    private lastPointerPosition;
+    constructor(revogrid: HTMLRevoGridElement, providers: PluginProviders | null, config?: ResizeIndicatorConfig);
+    private init;
+    private indicatorLine;
+    private currentResizableElement;
+    private resizeContext;
+    private dragListenersAttached;
+    private readonly onMouseMove;
+    private readonly onMouseUp;
+    private readonly onMouseLeave;
+    private readonly onPointerUp;
+    private readonly onPointerCancel;
+    private readonly onWindowBlur;
+    private readonly onVisibilityChange;
+    private readonly onRightClick;
+    private readonly onContextMenu;
+    private readonly onGridMouseMove;
+    private readonly onGridMouseLeave;
+    private attachDragListeners;
+    private detachDragListeners;
+    private cleanupDragState;
+    /**
+     * 触发一次原生 resize 结束，确保 ResizeDirective 能执行 handleUp -> dropInitial。
+     * 主要用于 Safari 在边界场景丢失 mouseup 的兜底。
+     */
+    private forceReleaseNativeResizeState;
+    /**
+     * 清理可能遗留的视觉状态（active 类和 resizable 内联样式）。
+     */
+    private cleanupStaleResizeVisualState;
+    private setHoveredResizable;
+    /**
+     * 拖拽结束后按当前指针位置恢复 hover 效果，
+     * 这样“按下立即松开”也能保持句柄高亮，无需再移动一次鼠标。
+     */
+    private restoreHoverFromPointer;
+    private handleMouseDown;
+    private createIndicatorLine;
+    /**
+     * 长线元素挂在 body 下，无法继承 revo-grid 上的 CSS 变量。
+     * 这里把 var(...) 解析为实际颜色值后再写入内联样式。
+     */
+    private resolveIndicatorColor;
+    private updateIndicatorLine;
+    private removeIndicatorLine;
+    /**
+     * 动态更新配置
+     */
+    updateConfig(config: Partial<ResizeIndicatorConfig>): void;
+    destroy(): void;
+}

package/dist/types/plugins/row-select-plugin-2026228.d.ts

@@ -0,0 +1,367 @@
+/**
+ * RowSelectPlugin - 行选择插件
+ *
+ * 功能说明：
+ * 1. 单选/多选：支持点击复选框选择单行，支持 Shift 键范围多选
+ * 2. 全选/取消全选：列头复选框支持全选当前可见行，半选状态显示
+ * 3. 树形选择：与 TreeDataPlugin 配合，支持选择父节点时自动选择/取消子节点
+ * 4. 选中状态同步：行选中后会在行元素上添加 selected 属性，方便 CSS 样式控制
+ * 5. 事件通知：选中状态变化时触发 rowselected 事件，包含选中数量等信息
+ *
+ * 使用方式：
+ * 1. 在列配置中添加 rowSelect: true 启用该列的复选框
+ * 2. 或使用 columnType 指定自定义的 CheckboxCellType
+ * 3. rowSelect 也可以是函数，根据行数据动态决定是否显示复选框
+ */
+import type { VNode } from '../stencil-public-runtime';
+import type { ColumnDataSchemaModel, DataType, HyperFunc, CellTemplate, ColumnTemplateProp, CellProps, DimensionRows } from "../types/index";
+import type { PluginProviders } from '../types';
+import { BasePlugin } from './base.plugin';
+/** 选中属性名称 */
+export declare const SELECTED_ATTRIBUTE = "selected";
+/** 行选中状态变化事件详情 */
+export interface RowSelectedEventDetail {
+    /** 选中行的集合，按行类型分组 */
+    selected: Map<DimensionRows, Set<number>>;
+    /** 所有选中行的总数 */
+    count: number;
+    /** 所有行的总数 */
+    allRowsCount: number;
+    /** 当前可见的选中行数 */
+    visibleCount: number;
+    /** 当前可见的行总数 */
+    visibleRowsCount: number;
+}
+/** 复选框单元格属性扩展 */
+export interface CheckboxCellProps extends ColumnDataSchemaModel {
+    selected?: boolean;
+    allSelected?: boolean;
+    allIndeterminate?: boolean;
+}
+/** 自定义复选框模板函数 */
+export type CheckboxTemplateFunc = (h: HyperFunc<VNode>, context: {
+    selected: boolean;
+    onClick: (event: MouseEvent) => void;
+    props?: any;
+    additionalData?: any;
+}) => VNode;
+/** 自定义列头复选框模板函数 */
+export type HeaderCheckboxTemplateFunc = (h: HyperFunc<VNode>, context: {
+    allSelected: boolean;
+    indeterminate: boolean;
+    onClick: (event: MouseEvent) => void;
+    props?: any;
+    additionalData?: any;
+}) => VNode;
+/** 树形数据配置 */
+export interface TreeConfig {
+    /** ID 字段名 */
+    idField: string;
+    /** 父 ID 字段名 */
+    parentIdField: string;
+    /** 根节点的父 ID 值 */
+    rootParentId?: any;
+}
+/** 行样式类型 */
+export type RowStyleType = 'highlight' | 'background' | 'focused';
+/** 行选择插件配置 */
+export interface RowSelectConfig {
+    /** 初始选中的行索引 */
+    initialSelected?: Map<DimensionRows, Set<number>>;
+    /** 自定义单元格复选框模板 */
+    checkboxTemplate?: CheckboxTemplateFunc;
+    /** 自定义列头复选框模板 */
+    headerCheckboxTemplate?: HeaderCheckboxTemplateFunc;
+    /** 自定义复选框列类型（优先级高于 checkboxTemplate，可以是 Vue/React 组件） */
+    customCheckboxType?: any;
+    /** 树形数据配置（用于过滤子节点） */
+    tree?: TreeConfig;
+    /** 选中行的样式配置 */
+    selectedRowStyle?: {
+        /** 背景色 */
+        backgroundColor?: string;
+    };
+    /** 未选中行的 hover 样式配置 */
+    hoverRowStyle?: {
+        /** hover 时的背景色 */
+        backgroundColor?: string;
+    };
+    /** 高亮行的样式配置 */
+    highlightRowStyle?: {
+        /** 背景色 */
+        backgroundColor?: string;
+    };
+    /** 聚焦行的样式配置 */
+    focusedRowStyle?: {
+        /** 背景色 */
+        backgroundColor?: string;
+    };
+    /** 高亮行的 ID 字段名，默认为 'id' */
+    highlightIdField?: string;
+}
+/**
+ * 复选框单元格类型
+ * 提供复选框的单元格和列头模板
+ */
+export declare class CheckboxCellType {
+    readonly: boolean;
+    /**
+     * 单元格模板 - 渲染行复选框
+     */
+    cellTemplate: CellTemplate;
+    /**
+     * 单元格属性
+     */
+    cellProperties: () => CellProps;
+    /**
+     * 列属性
+     */
+    columnProperties: () => CellProps;
+    /**
+     * 列头模板 - 渲染全选复选框
+     */
+    columnTemplate: (h: HyperFunc<VNode>, props: ColumnTemplateProp & {
+        allSelected?: boolean;
+        allIndeterminate?: boolean;
+    }) => VNode;
+}
+/**
+ * 行选择插件
+ * 实现表格行的单选和多选功能
+ */
+export declare class RowSelectPlugin extends BasePlugin {
+    /** 最后选中的行索引（用于 Shift 多选） */
+    private lastSelectedIndex?;
+    /** 选中行的集合，按行类型分组存储 */
+    private selected;
+    /** 复选框单元格类型实例 */
+    private checkboxCellType;
+    /** 自定义复选框模板 */
+    private customCheckboxTemplate?;
+    /** 自定义列头复选框模板 */
+    private customHeaderCheckboxTemplate?;
+    /** 自定义复选框列类型 */
+    private customCheckboxType?;
+    /** 树形数据配置 */
+    private treeConfig?;
+    /** 选中行样式配置 */
+    private selectedRowStyle?;
+    /** 未选中行 hover 样式配置 */
+    private hoverRowStyle?;
+    /** 高亮行样式配置 */
+    private highlightRowStyle?;
+    /** 聚焦行样式配置 */
+    private focusedRowStyle?;
+    /** 高亮行的 ID 字段名 */
+    private highlightIdField;
+    /** 行样式 ID 集合，按类型分组存储 */
+    private rowStyleIds;
+    /** 样式元素 */
+    private styleElement?;
+    /** Hover 同步状态 */
+    private hoverSyncEnabled;
+    private hoverRowType;
+    private hoverPhysicalIndex;
+    private hoverLastPointer;
+    private hoverSyncProcessing;
+    private hoverResyncTimer;
+    private hoverResyncRaf;
+    private hoverRenderBlocked;
+    private hoverResyncPending;
+    private hoverMouseDown;
+    private hoverInteractionSuspended;
+    private viewportScrollIdleTimer;
+    private viewportScrolling;
+    private pendingWheelSelectionSyncAfterScroll;
+    private lastWheelSelectionSyncAt;
+    private lastHoverPointerSyncAt;
+    private cleanupHoverSync;
+    private pendingSelectionAttributeSync;
+    private selectionAttributeSyncRaf;
+    private postRefreshSyncRaf;
+    private wheelRowSelectionSyncRaf;
+    constructor(revogrid: HTMLRevoGridElement, providers: PluginProviders, config?: RowSelectConfig);
+    /**
+     * 获取所有选中行的索引
+     */
+    getSelectedIndexes(): Map<DimensionRows, Set<number>>;
+    /**
+     * 获取选中行的数据
+     */
+    getSelectedRows(): Map<DimensionRows, DataType[]>;
+    /**
+     * 清空所有选中
+     */
+    clearSelection(): void;
+    /**
+     * 全选所有行（触发全选事件）
+     */
+    selectAll(): void;
+    /**
+     * 取消全选（触发取消全选事件）
+     */
+    deselectAll(): void;
+    /**
+     * 选中指定行（支持树形联动）
+     */
+    selectRows(rowType: DimensionRows, indices: number[]): void;
+    /**
+     * 取消选中指定行（支持树形联动）
+     */
+    deselectRows(rowType: DimensionRows, indices: number[]): void;
+    /**
+     * 获取选中行的指定字段值列表
+     * @param field 字段名，如 'id'、'key' 等
+     * @param rowType 行类型，默认 'rgRow'
+     * @returns 字段值数组
+     */
+    getSelectedFieldValues<T = any>(field: string, rowType?: DimensionRows): T[];
+    /**
+     * 获取所有选中行的数据（扁平数组）
+     * @param rowType 行类型，默认 'rgRow'
+     * @returns 选中行数据数组
+     */
+    getSelectedData(rowType?: DimensionRows): DataType[];
+    /**
+     * 获取选中的根节点数据（过滤掉子节点）
+     * 用于树形数据场景，只返回顶层选中的节点
+     * @param rowType 行类型，默认 'rgRow'
+     * @returns 根节点数据数组
+     */
+    getSelectedRootData(rowType?: DimensionRows): DataType[];
+    /**
+     * 获取选中根节点的指定字段值列表（过滤掉子节点）
+     * @param field 字段名，如 'id'、'key' 等
+     * @param rowType 行类型，默认 'rgRow'
+     * @returns 字段值数组
+     */
+    getSelectedRootFieldValues<T = any>(field: string, rowType?: DimensionRows): T[];
+    /**
+     * 根据 ID 高亮某一行
+     * @param id 行的 ID 值
+     * @param idField 可选，ID 字段名，默认使用配置的 highlightIdField
+     * @deprecated 请使用 applyRowStyle('highlight', [id], idField) 代替
+     */
+    highlightRowById(id: any, idField?: string): void;
+    /**
+     * 清除行高亮
+     * @deprecated 请使用 clearRowStyle('highlight') 代替
+     */
+    clearHighlight(): void;
+    /**
+     * 获取当前高亮的行 ID
+     * @deprecated 请使用 getRowStyleIds('highlight') 代替
+     */
+    getHighlightedRowId(): any;
+    /**
+     * 获取当前高亮的行数据
+     * @param rowType 行类型，默认 'rgRow'
+     */
+    getHighlightedRowData(rowType?: DimensionRows): DataType | null;
+    /**
+     * 为指定行应用样式（高亮或背景色）
+     * @param type 样式类型：'highlight' 使用高亮色，'background' 使用 hover 背景色
+     * @param ids 行的 ID 值数组
+     * @param idField 可选，ID 字段名，默认使用配置的 highlightIdField
+     */
+    applyRowStyle(type: RowStyleType, ids: any[], idField?: string): void;
+    /**
+     * 移除指定行的样式
+     * @param type 样式类型：'highlight' 或 'background'
+     * @param ids 行的 ID 值数组，如果不传则移除该类型所有行的样式
+     * @param idField 可选，ID 字段名，默认使用配置的 highlightIdField
+     */
+    removeRowStyle(type: RowStyleType, ids?: any[], idField?: string): void;
+    /**
+     * 清除指定类型的所有行样式
+     * @param type 样式类型：'highlight' 或 'background'
+     */
+    clearRowStyle(type: RowStyleType): void;
+    /**
+     * 获取已应用样式的行 ID
+     * @param type 样式类型：'highlight' 或 'background'
+     */
+    getRowStyleIds(type: RowStyleType): Set<any>;
+    /**
+     * 清除所有行样式（高亮和背景色）
+     */
+    clearAllRowStyles(): void;
+    /**
+     * 注入自定义样式
+     */
+    private injectCustomStyles;
+    /**
+     * 设置 hover 同步（跨视口）
+     * 通过添加/移除 row-hover-active 类实现跨视口的 hover 效果
+     */
+    private getRowTypeFromElement;
+    private getPhysicalIndexFromRow;
+    private getVirtualIndexFromPhysical;
+    private getRowElementsByVirtualIndex;
+    private isRowSelected;
+    private applyHoverClass;
+    private clearHoverClass;
+    private clearAllHoverClass;
+    private normalizeHoverClasses;
+    private updateHoverFromRow;
+    private syncHoverFromPointer;
+    private blockHoverRender;
+    private queueHoverResync;
+    private scheduleHoverResync;
+    private queueSelectionAttributeSync;
+    private setHoverSuspendedClass;
+    private setupHoverSync;
+    /**
+     * 获取所有子节点的索引（递归）
+     */
+    private getChildrenIndices;
+    /**
+     * 更新行样式属性
+     */
+    private updateRowStyleAttribute;
+    /**
+     * 清除行样式属性
+     */
+    private clearRowStyleAttribute;
+    private hasAnySelectedRows;
+    private hasAnyRowStyles;
+    private getRowStyleFlags;
+    private applyRowStyleFlagsToAttrs;
+    /**
+     * 判断是否为复选框列
+     */
+    private isCheckboxColumn;
+    /**
+     * 获取选中状态统计
+     */
+    private getSelectionStatus;
+    /**
+     * 发出选中状态变化事件
+     */
+    private emitSelectionChange;
+    /**
+     * 刷新视口以更新 UI
+     */
+    private refreshViewports;
+    private markViewportScrolling;
+    private queueWheelRowSelectionSync;
+    private updateWheelCaptureSelectedAttributes;
+    /**
+     * 更新所有行的选中属性
+     * 用于确保展开分组后，之前被折叠的行也能正确显示选中状态
+     */
+    private updateSelectedAttributes;
+    /**
+     * 创建列头模板
+     */
+    private createHeaderTemplate;
+    /**
+     * 创建单元格复选框模板
+     */
+    private createCellCheckboxTemplate;
+    /**
+     * 单元格模板包装器 - 注入选中状态
+     */
+    private cellTemplateWrapper;
+    destroy(): void;
+}