stk-table-vue 1.2.4 → 1.2.6

package/src/StkTable/index.ts

@@ -1,20 +1,20 @@
-export { useAreaSelection } from './features/index';
-export { registerFeature } from './registerFeature';
-export { default as StkTable } from './StkTable.vue';
-export type { AreaSelectionRange, Order, ScrollAxisTarget, ScrollToFn, ScrollToOptions, SortConfig, SortOption, SortState, StkTableColumn } from './types/index';
-export { binarySearch, insertToOrderedArray, strCompare, tableSort } from './utils';
-// export custom cells
-export { createFilterCell } from './custom-cells/FilterCell/index';
-export type { CreateFilterCellOption, FilterStatus } from './custom-cells/FilterCell/index';
-export { createEditableCell } from './custom-cells/EditableCell/index';
-export type { CreateEditableCellOptions } from './custom-cells/EditableCell/index';
-export { createCheckboxCell } from './custom-cells/CheckboxCell/index';
-export type { createCheckboxCellOptions } from './custom-cells/CheckboxCell/index';
-export { createNumberCell } from './custom-cells/NumberCell/index';
-export type { CreateNumberCellOptions } from './custom-cells/NumberCell/index';
-export { createChangeCell } from './custom-cells/ChangeCell/index';
-export type { CreateChangeCellOptions } from './custom-cells/ChangeCell/index';
-export { formatNumber } from './custom-cells/utils/formatNumber';
-export type { FormatNumberOptions } from './custom-cells/utils/formatNumber';
-
-import './style.less';
+export { useAreaSelection } from './features/index';
+export { registerFeature } from './registerFeature';
+export { default as StkTable } from './StkTable.vue';
+export type { AreaSelectionRange, Order, ScrollAxisTarget, ScrollToFn, ScrollToOptions, SortConfig, SortOption, SortState, StkTableColumn } from './types/index';
+export { binarySearch, insertToOrderedArray, strCompare, tableSort } from './utils';
+// export custom cells
+export { createFilterCell } from './custom-cells/FilterCell/index';
+export type { CreateFilterCellOption, FilterStatus } from './custom-cells/FilterCell/index';
+export { createEditableCell } from './custom-cells/EditableCell/index';
+export type { CreateEditableCellOptions } from './custom-cells/EditableCell/index';
+export { createCheckboxCell } from './custom-cells/CheckboxCell/index';
+export type { createCheckboxCellOptions } from './custom-cells/CheckboxCell/index';
+export { createNumberCell } from './custom-cells/NumberCell/index';
+export type { CreateNumberCellOptions } from './custom-cells/NumberCell/index';
+export { createChangeCell } from './custom-cells/ChangeCell/index';
+export type { CreateChangeCellOptions } from './custom-cells/ChangeCell/index';
+export { formatNumber } from './custom-cells/utils/formatNumber';
+export type { FormatNumberOptions } from './custom-cells/utils/formatNumber';
+
+import './style.less';

package/src/StkTable/mergeCellsCache.ts

@@ -1,69 +1,69 @@
-import { MergeCellsParam } from './types';
-
-/** mergeCells 计算结果 */
-export type MergeCellsResult = { colspan: number; rowspan: number };
-/** 缓存条目：额外保存行引用，用于校验缓存是否仍对应当前行数据 */
-type MergeCellsCacheEntry = MergeCellsResult & { row: MergeCellsParam<any>['row'] };
-
-/** 无合并时的默认结果（只读共享，调用方均只解构读取） */
-const DEFAULT_RESULT: MergeCellsResult = { colspan: 1, rowspan: 1 };
-
-/**
- * 缓存键编码为数字：绝对行索引 * 0x10000 + 叶子列索引。
- * 相比字符串键更省内存、查询更快（列数不可能超过 0x10000）。
- */
-const COL_INDEX_BASE = 0x10000;
-
-/**
- * mergeCells 结果缓存工厂。
- *
- * - 缓存键为「绝对行索引 + 叶子列索引」，所有 mergeCells 调用处
- *   （hiddenCellMap 构建、virtual-x 可视列范围修正、视口上方占位计算、单元格渲染）共享，
- *   同一单元格只调用一次用户回调；
- * - 缓存可跨虚拟滚动帧复用（键为绝对索引，不随窗口滑动变化），
- *   稳态滚动时仅新进入窗口的行会触发回调，只需在数据/列真正变化时 clear；
- * - 条目额外保存行引用并在命中时校验同一性：即使数据被重排/替换（如排序后同一批行对象
- *   顺序变化），也不会取到错行的旧结果，缓存清理时机不再影响正确性。
- * - 注意：引用同一性校验无法感知行字段被原地修改（行引用不变）。
- *   业务原地改行且 mergeCells 结果依赖该字段时，需调用 clear() 显式失效
- *   （组件已暴露 clearMergeCellsCache 实例方法）。
- */
-export function createMergeCellsCache() {
-    const cache = new Map<number, MergeCellsCacheEntry>();
-
-    /**
-     * 获取（必要时计算并缓存）mergeCells 结果
-     * @param row 行数据
-     * @param col 列配置
-     * @param rowIndex 绝对行索引
-     * @param colIndex 叶子列索引
-     */
-    function getMergeCellsResult(
-        row: MergeCellsParam<any>['row'],
-        col: MergeCellsParam<any>['col'],
-        rowIndex: number,
-        colIndex: number,
-    ): MergeCellsResult {
-        if (!col.mergeCells) return DEFAULT_RESULT;
-
-        const cacheKey = rowIndex * COL_INDEX_BASE + colIndex;
-        const cached = cache.get(cacheKey);
-        if (cached && cached.row === row) return cached;
-
-        let { colspan = 1, rowspan = 1 } = col.mergeCells({ row, col, rowIndex, colIndex }) || {};
-        colspan = colspan || 1;
-        rowspan = rowspan || 1;
-        const entry: MergeCellsCacheEntry = { row, colspan, rowspan };
-        cache.set(cacheKey, entry);
-        return entry;
-    }
-
-    /** 清空缓存（数据/列变化时自动调用；行字段被原地修改时需显式调用以强制重算） */
-    function clear() {
-        cache.clear();
-    }
-
-    return { getMergeCellsResult, clear };
-}
-
-export type MergeCellsCache = ReturnType<typeof createMergeCellsCache>;
+import { MergeCellsParam } from './types';
+
+/** mergeCells 计算结果 */
+export type MergeCellsResult = { colspan: number; rowspan: number };
+/** 缓存条目：额外保存行引用，用于校验缓存是否仍对应当前行数据 */
+type MergeCellsCacheEntry = MergeCellsResult & { row: MergeCellsParam<any>['row'] };
+
+/** 无合并时的默认结果（只读共享，调用方均只解构读取） */
+const DEFAULT_RESULT: MergeCellsResult = { colspan: 1, rowspan: 1 };
+
+/**
+ * 缓存键编码为数字：绝对行索引 * 0x10000 + 叶子列索引。
+ * 相比字符串键更省内存、查询更快（列数不可能超过 0x10000）。
+ */
+const COL_INDEX_BASE = 0x10000;
+
+/**
+ * mergeCells 结果缓存工厂。
+ *
+ * - 缓存键为「绝对行索引 + 叶子列索引」，所有 mergeCells 调用处
+ *   （hiddenCellMap 构建、virtual-x 可视列范围修正、视口上方占位计算、单元格渲染）共享，
+ *   同一单元格只调用一次用户回调；
+ * - 缓存可跨虚拟滚动帧复用（键为绝对索引，不随窗口滑动变化），
+ *   稳态滚动时仅新进入窗口的行会触发回调，只需在数据/列真正变化时 clear；
+ * - 条目额外保存行引用并在命中时校验同一性：即使数据被重排/替换（如排序后同一批行对象
+ *   顺序变化），也不会取到错行的旧结果，缓存清理时机不再影响正确性。
+ * - 注意：引用同一性校验无法感知行字段被原地修改（行引用不变）。
+ *   业务原地改行且 mergeCells 结果依赖该字段时，需调用 clear() 显式失效
+ *   （组件已暴露 clearMergeCellsCache 实例方法）。
+ */
+export function createMergeCellsCache() {
+    const cache = new Map<number, MergeCellsCacheEntry>();
+
+    /**
+     * 获取（必要时计算并缓存）mergeCells 结果
+     * @param row 行数据
+     * @param col 列配置
+     * @param rowIndex 绝对行索引
+     * @param colIndex 叶子列索引
+     */
+    function getMergeCellsResult(
+        row: MergeCellsParam<any>['row'],
+        col: MergeCellsParam<any>['col'],
+        rowIndex: number,
+        colIndex: number,
+    ): MergeCellsResult {
+        if (!col.mergeCells) return DEFAULT_RESULT;
+
+        const cacheKey = rowIndex * COL_INDEX_BASE + colIndex;
+        const cached = cache.get(cacheKey);
+        if (cached && cached.row === row) return cached;
+
+        let { colspan = 1, rowspan = 1 } = col.mergeCells({ row, col, rowIndex, colIndex }) || {};
+        colspan = colspan || 1;
+        rowspan = rowspan || 1;
+        const entry: MergeCellsCacheEntry = { row, colspan, rowspan };
+        cache.set(cacheKey, entry);
+        return entry;
+    }
+
+    /** 清空缓存（数据/列变化时自动调用；行字段被原地修改时需显式调用以强制重算） */
+    function clear() {
+        cache.clear();
+    }
+
+    return { getMergeCellsResult, clear };
+}
+
+export type MergeCellsCache = ReturnType<typeof createMergeCellsCache>;

package/src/StkTable/registerFeature.ts

@@ -1,40 +1,40 @@
-import { computed, ref } from 'vue';
-import { useAreaSelection, useAreaSelectionName } from './features';
-import { MY_FN_NAME } from './features/const';
-
-type OnDemandFeature = {
-    [useAreaSelectionName]: typeof useAreaSelection<any>;
-};
-
-export const ON_DEMAND_FEATURE: OnDemandFeature = {
-    [useAreaSelectionName]: (props => {
-        if ('useAreaSelection' in props) {
-            console.warn('useAreaSelection is not registered');
-        }
-        return {
-            config: computed(() => ({ enabled: false })),
-            isSelecting: ref(false),
-            onMD: () => {},
-            // getClass: () => [],
-            // getRowClass: () => [],
-            get: () => ({ rows: [], cols: [], ranges: [] }),
-            set: () => [],
-            clear: () => {},
-            copy: () => '',
-        };
-    }) as typeof useAreaSelection<any>,
-};
-
-type Feature = OnDemandFeature[keyof OnDemandFeature];
-
-export function registerFeature(feature: Feature | Feature[]) {
-    const features = Array.isArray(feature) ? feature : [feature];
-    features.forEach(f => {
-        const fnName = (f as any)[MY_FN_NAME];
-        if (!fnName) {
-            console.warn('invalid feature');
-            return;
-        }
-        (ON_DEMAND_FEATURE as any)[fnName] = f as any;
-    });
-}
+import { computed, ref } from 'vue';
+import { useAreaSelection, useAreaSelectionName } from './features';
+import { MY_FN_NAME } from './features/const';
+
+type OnDemandFeature = {
+    [useAreaSelectionName]: typeof useAreaSelection<any>;
+};
+
+export const ON_DEMAND_FEATURE: OnDemandFeature = {
+    [useAreaSelectionName]: (props => {
+        if ('useAreaSelection' in props) {
+            console.warn('useAreaSelection is not registered');
+        }
+        return {
+            config: computed(() => ({ enabled: false })),
+            isSelecting: ref(false),
+            onMD: () => {},
+            // getClass: () => [],
+            // getRowClass: () => [],
+            get: () => ({ rows: [], cols: [], ranges: [] }),
+            set: () => [],
+            clear: () => {},
+            copy: () => '',
+        };
+    }) as typeof useAreaSelection<any>,
+};
+
+type Feature = OnDemandFeature[keyof OnDemandFeature];
+
+export function registerFeature(feature: Feature | Feature[]) {
+    const features = Array.isArray(feature) ? feature : [feature];
+    features.forEach(f => {
+        const fnName = (f as any)[MY_FN_NAME];
+        if (!fnName) {
+            console.warn('invalid feature');
+            return;
+        }
+        (ON_DEMAND_FEATURE as any)[fnName] = f as any;
+    });
+}