rj-grid 0.1.0

package/dist/types/src/RjHeader.vue.d.ts

@@ -0,0 +1,80 @@
+import type { RjColumn } from './types';
+import type { RjLeafCol } from './useColumnState';
+export interface HeaderLevelCell {
+    col: RjColumn;
+    colId: string;
+    title?: string;
+    x: number;
+    width: number;
+    isGroup: boolean;
+    leafCol?: RjLeafCol;
+}
+declare const _default: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_TypePropsToRuntimeProps<{
+    levelCells: HeaderLevelCell[][];
+    totalWidth: number;
+    scrollLeft: number;
+    headerRowHeight: number;
+    sortStates: {
+        field: string;
+        dir: string;
+    }[];
+    activeFilters: string[];
+    reorderable?: boolean | undefined;
+    gridSlots?: Record<string, any> | undefined;
+    allLeaves: RjLeafCol[];
+    headerChecked?: boolean | undefined;
+    headerIndeterminate?: boolean | undefined;
+    /** 浮动筛选行 */
+    floating?: boolean | undefined;
+    floatValues?: Record<string, string> | undefined;
+    filterRowHeight?: number | undefined;
+}>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    sort: (colId: string, field: string | undefined, additive: boolean) => void;
+    "open-filter": (cell: HeaderLevelCell, el: MouseEvent) => void;
+    "header-menu": (cell: HeaderLevelCell, ev: MouseEvent) => void;
+    resize: (colId: string, width: number, done: boolean) => void;
+    "col-drop": (dragId: string, targetId: string) => void;
+    "col-draggroup": (dragId: string, ev: DragEvent) => void;
+    "auto-width": (colId: string) => void;
+    "toggle-check-all": () => void;
+    "float-filter": (colId: string, value: string) => void;
+}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_TypePropsToRuntimeProps<{
+    levelCells: HeaderLevelCell[][];
+    totalWidth: number;
+    scrollLeft: number;
+    headerRowHeight: number;
+    sortStates: {
+        field: string;
+        dir: string;
+    }[];
+    activeFilters: string[];
+    reorderable?: boolean | undefined;
+    gridSlots?: Record<string, any> | undefined;
+    allLeaves: RjLeafCol[];
+    headerChecked?: boolean | undefined;
+    headerIndeterminate?: boolean | undefined;
+    /** 浮动筛选行 */
+    floating?: boolean | undefined;
+    floatValues?: Record<string, string> | undefined;
+    filterRowHeight?: number | undefined;
+}>>> & Readonly<{
+    onSort?: ((colId: string, field: string | undefined, additive: boolean) => any) | undefined;
+    onResize?: ((colId: string, width: number, done: boolean) => any) | undefined;
+    "onCol-drop"?: ((dragId: string, targetId: string) => any) | undefined;
+    "onOpen-filter"?: ((cell: HeaderLevelCell, el: MouseEvent) => any) | undefined;
+    "onHeader-menu"?: ((cell: HeaderLevelCell, ev: MouseEvent) => any) | undefined;
+    "onCol-draggroup"?: ((dragId: string, ev: DragEvent) => any) | undefined;
+    "onAuto-width"?: ((colId: string) => any) | undefined;
+    "onToggle-check-all"?: (() => any) | undefined;
+    "onFloat-filter"?: ((colId: string, value: string) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export default _default;
+type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;
+type __VLS_TypePropsToRuntimeProps<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: import('vue').PropType<__VLS_NonUndefinedable<T[K]>>;
+    } : {
+        type: import('vue').PropType<T[K]>;
+        required: true;
+    };
+};

package/dist/types/src/RjImgList.vue.d.ts

@@ -0,0 +1,29 @@
+declare const _default: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_TypePropsToRuntimeProps<{
+    urls: string[];
+    style: Record<string, string>;
+    shape: 'square' | 'rounded' | 'circle';
+    lazy: boolean;
+    alt: string;
+    fallback: string;
+}>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    preview: (url: string) => void;
+}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_TypePropsToRuntimeProps<{
+    urls: string[];
+    style: Record<string, string>;
+    shape: 'square' | 'rounded' | 'circle';
+    lazy: boolean;
+    alt: string;
+    fallback: string;
+}>>> & Readonly<{
+    onPreview?: ((url: string) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export default _default;
+type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;
+type __VLS_TypePropsToRuntimeProps<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: import('vue').PropType<__VLS_NonUndefinedable<T[K]>>;
+    } : {
+        type: import('vue').PropType<T[K]>;
+        required: true;
+    };
+};

package/dist/types/src/RjPager.vue.d.ts

@@ -0,0 +1,41 @@
+declare const _default: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<{
+    page: number;
+    pageSize: number;
+    total: number;
+    variant?: "top" | "bottom" | undefined;
+}>, {
+    variant: string;
+}>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:page": (v: number) => void;
+    "update:pageSize": (v: number) => void;
+}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<{
+    page: number;
+    pageSize: number;
+    total: number;
+    variant?: "top" | "bottom" | undefined;
+}>, {
+    variant: string;
+}>>> & Readonly<{
+    "onUpdate:page"?: ((v: number) => any) | undefined;
+    "onUpdate:pageSize"?: ((v: number) => any) | undefined;
+}>, {
+    variant: 'top' | 'bottom';
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export default _default;
+type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;
+type __VLS_TypePropsToRuntimeProps<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: import('vue').PropType<__VLS_NonUndefinedable<T[K]>>;
+    } : {
+        type: import('vue').PropType<T[K]>;
+        required: true;
+    };
+};
+type __VLS_WithDefaults<P, D> = {
+    [K in keyof Pick<P, keyof P>]: K extends keyof D ? __VLS_Prettify<P[K] & {
+        default: D[K];
+    }> : P[K];
+};
+type __VLS_Prettify<T> = {
+    [K in keyof T]: T[K];
+} & {};

package/dist/types/src/RjQueryBar.vue.d.ts

@@ -0,0 +1,47 @@
+import type { RjQueryAction, RjQueryCondition, RjQueryFieldDef, RjRowData } from './types';
+declare const _default: __VLS_WithTemplateSlots<import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_TypePropsToRuntimeProps<{
+    fields: RjQueryFieldDef[];
+    modelValue: RjQueryCondition[];
+    /** 重置旁的自定义操作按钮（queryActions prop） */
+    actions?: RjQueryAction[] | undefined;
+    /** 当前选中行：供按钮禁用态实时求值 */
+    selectedRows?: RjRowData[] | undefined;
+}>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:modelValue": (v: RjQueryCondition[]) => void;
+    search: () => void;
+    "action-click": (a: RjQueryAction) => void;
+}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_TypePropsToRuntimeProps<{
+    fields: RjQueryFieldDef[];
+    modelValue: RjQueryCondition[];
+    /** 重置旁的自定义操作按钮（queryActions prop） */
+    actions?: RjQueryAction[] | undefined;
+    /** 当前选中行：供按钮禁用态实时求值 */
+    selectedRows?: RjRowData[] | undefined;
+}>>> & Readonly<{
+    onSearch?: (() => any) | undefined;
+    "onUpdate:modelValue"?: ((v: RjQueryCondition[]) => any) | undefined;
+    "onAction-click"?: ((a: RjQueryAction) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>, Readonly<{
+    actions?: ((props: {
+        rows: RjRowData[];
+    }) => unknown) | undefined;
+}> & {
+    actions?: ((props: {
+        rows: RjRowData[];
+    }) => unknown) | undefined;
+}>;
+export default _default;
+type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;
+type __VLS_TypePropsToRuntimeProps<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: import('vue').PropType<__VLS_NonUndefinedable<T[K]>>;
+    } : {
+        type: import('vue').PropType<T[K]>;
+        required: true;
+    };
+};
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/types/src/RjRowFormDialog.vue.d.ts

@@ -0,0 +1,50 @@
+import type { RjFormField } from './rowForm';
+import type { RjRowData } from './types';
+declare const _default: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<{
+    fields: RjFormField[];
+    rows: RjRowData[];
+    title?: string | undefined;
+    width?: number | undefined;
+    /** add=新增模式（空白表单）；缺省 edit=编辑模式（预填选中行） */
+    mode?: "edit" | "add" | undefined;
+}>, {
+    width: number;
+    mode: string;
+}>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    submit: (changes: Record<string, any>) => void;
+    close: () => void;
+}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<{
+    fields: RjFormField[];
+    rows: RjRowData[];
+    title?: string | undefined;
+    width?: number | undefined;
+    /** add=新增模式（空白表单）；缺省 edit=编辑模式（预填选中行） */
+    mode?: "edit" | "add" | undefined;
+}>, {
+    width: number;
+    mode: string;
+}>>> & Readonly<{
+    onClose?: (() => any) | undefined;
+    onSubmit?: ((changes: Record<string, any>) => any) | undefined;
+}>, {
+    mode: 'edit' | 'add';
+    width: number;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export default _default;
+type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;
+type __VLS_TypePropsToRuntimeProps<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: import('vue').PropType<__VLS_NonUndefinedable<T[K]>>;
+    } : {
+        type: import('vue').PropType<T[K]>;
+        required: true;
+    };
+};
+type __VLS_WithDefaults<P, D> = {
+    [K in keyof Pick<P, keyof P>]: K extends keyof D ? __VLS_Prettify<P[K] & {
+        default: D[K];
+    }> : P[K];
+};
+type __VLS_Prettify<T> = {
+    [K in keyof T]: T[K];
+} & {};

package/dist/types/src/RjSlotRender.d.ts

@@ -0,0 +1,56 @@
+import { type PropType } from 'vue';
+declare const _default: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+    slots: {
+        type: PropType<Readonly<{
+            [name: string]: import("vue").Slot<any> | undefined;
+        }>>;
+        required: true;
+    };
+    name: {
+        type: StringConstructor;
+        required: true;
+    };
+    params: {
+        type: PropType<any>;
+        default: undefined;
+    };
+}>, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+    [key: string]: any;
+}>[] | null, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+    slots: {
+        type: PropType<Readonly<{
+            [name: string]: import("vue").Slot<any> | undefined;
+        }>>;
+        required: true;
+    };
+    name: {
+        type: StringConstructor;
+        required: true;
+    };
+    params: {
+        type: PropType<any>;
+        default: undefined;
+    };
+}>> & Readonly<{}>, {
+    params: any;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export default _default;
+export declare const RjFnRender: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+    render: {
+        type: PropType<(p: any) => any>;
+        required: true;
+    };
+    params: {
+        type: PropType<any>;
+        required: true;
+    };
+}>, () => any, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+    render: {
+        type: PropType<(p: any) => any>;
+        required: true;
+    };
+    params: {
+        type: PropType<any>;
+        required: true;
+    };
+}>> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;

package/dist/types/src/RjSparkline.vue.d.ts

@@ -0,0 +1,43 @@
+declare const _default: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<{
+    data: number[];
+    style?: "bar" | "line" | "spider" | undefined;
+    color?: string | undefined;
+    w?: number | undefined;
+    h?: number | undefined;
+}>, {
+    color: string;
+    w: number;
+    h: number;
+}>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<{
+    data: number[];
+    style?: "bar" | "line" | "spider" | undefined;
+    color?: string | undefined;
+    w?: number | undefined;
+    h?: number | undefined;
+}>, {
+    color: string;
+    w: number;
+    h: number;
+}>>> & Readonly<{}>, {
+    color: string;
+    w: number;
+    h: number;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export default _default;
+type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;
+type __VLS_TypePropsToRuntimeProps<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: import('vue').PropType<__VLS_NonUndefinedable<T[K]>>;
+    } : {
+        type: import('vue').PropType<T[K]>;
+        required: true;
+    };
+};
+type __VLS_WithDefaults<P, D> = {
+    [K in keyof Pick<P, keyof P>]: K extends keyof D ? __VLS_Prettify<P[K] & {
+        default: D[K];
+    }> : P[K];
+};
+type __VLS_Prettify<T> = {
+    [K in keyof T]: T[K];
+} & {};

package/dist/types/src/RjToolPanel.vue.d.ts

@@ -0,0 +1,103 @@
+import type { RjColumn } from './types';
+export interface PanelLeaf {
+    col: RjColumn;
+    colId: string;
+    field?: string;
+    title?: string;
+    hidden: boolean;
+    pinned: 'left' | 'right' | null;
+    aggFunc?: string;
+}
+declare const _default: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_TypePropsToRuntimeProps<{
+    leafList: PanelLeaf[];
+    /**
+     * 候选列（分组维 / 透视维 / 透视值）专用列源：应始终为用户真正声明的列。
+     * 透视态下 leafList 会被引擎生成的 __pv* 列顶替，直接拿它做候选，
+     * 用户可以把 `__pvrow0:kind` 再勾一次当透视维，把透视结果直接做塌。
+     */
+    pivotLeafList?: PanelLeaf[] | undefined;
+    /**
+     * 默认「全部指标」隐式态下引擎真正生效的度量 colId 集。
+     * 面板候选按类型列出所有数值列，隐式态却只聚合已声明 aggFunc 的那几项，
+     * 不拿这份基线画勾选态，会把未生效项也显示成已勾选。
+     */
+    pivotValueDefault?: string[] | undefined;
+    groupedFields: string[];
+    pivot: {
+        cols: string[];
+        values: string[];
+        active: boolean;
+    };
+    filters?: {
+        colId: string;
+        kind: 'column' | 'float' | 'advanced';
+        title: string;
+        text: string;
+    }[] | undefined;
+    quickFilter?: string | undefined;
+}>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "toggle-hide": (colId: string) => void;
+    "toggle-pin": (colId: string, pin: "left" | "right" | null) => void;
+    "col-drop": (from: string, to: string) => void;
+    "group-add": (field: string) => void;
+    "group-remove": (field: string) => void;
+    "group-drop": (colId: string) => void;
+    "pivot-enable": (v: boolean) => void;
+    "pivot-toggle": (which: "values" | "cols", key: string) => void;
+    "pivot-drop": (colId: string) => void;
+    "set-agg": (field: string, agg: string | undefined) => void;
+    "filter-remove": (colId: string, kind: "column" | "advanced" | "float") => void;
+    "filters-clear-all": () => void;
+    "quick-clear": () => void;
+}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_TypePropsToRuntimeProps<{
+    leafList: PanelLeaf[];
+    /**
+     * 候选列（分组维 / 透视维 / 透视值）专用列源：应始终为用户真正声明的列。
+     * 透视态下 leafList 会被引擎生成的 __pv* 列顶替，直接拿它做候选，
+     * 用户可以把 `__pvrow0:kind` 再勾一次当透视维，把透视结果直接做塌。
+     */
+    pivotLeafList?: PanelLeaf[] | undefined;
+    /**
+     * 默认「全部指标」隐式态下引擎真正生效的度量 colId 集。
+     * 面板候选按类型列出所有数值列，隐式态却只聚合已声明 aggFunc 的那几项，
+     * 不拿这份基线画勾选态，会把未生效项也显示成已勾选。
+     */
+    pivotValueDefault?: string[] | undefined;
+    groupedFields: string[];
+    pivot: {
+        cols: string[];
+        values: string[];
+        active: boolean;
+    };
+    filters?: {
+        colId: string;
+        kind: 'column' | 'float' | 'advanced';
+        title: string;
+        text: string;
+    }[] | undefined;
+    quickFilter?: string | undefined;
+}>>> & Readonly<{
+    "onCol-drop"?: ((from: string, to: string) => any) | undefined;
+    "onToggle-hide"?: ((colId: string) => any) | undefined;
+    "onToggle-pin"?: ((colId: string, pin: "left" | "right" | null) => any) | undefined;
+    "onGroup-add"?: ((field: string) => any) | undefined;
+    "onGroup-remove"?: ((field: string) => any) | undefined;
+    "onGroup-drop"?: ((colId: string) => any) | undefined;
+    "onPivot-enable"?: ((v: boolean) => any) | undefined;
+    "onPivot-toggle"?: ((which: "values" | "cols", key: string) => any) | undefined;
+    "onPivot-drop"?: ((colId: string) => any) | undefined;
+    "onSet-agg"?: ((field: string, agg: string | undefined) => any) | undefined;
+    "onFilter-remove"?: ((colId: string, kind: "column" | "advanced" | "float") => any) | undefined;
+    "onFilters-clear-all"?: (() => any) | undefined;
+    "onQuick-clear"?: (() => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export default _default;
+type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;
+type __VLS_TypePropsToRuntimeProps<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: import('vue').PropType<__VLS_NonUndefinedable<T[K]>>;
+    } : {
+        type: import('vue').PropType<T[K]>;
+        required: true;
+    };
+};

package/dist/types/src/RjViewManager.vue.d.ts

@@ -0,0 +1,28 @@
+declare function open(): void;
+declare const _default: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_TypePropsToRuntimeProps<{
+    condCount: number;
+    colCount: number;
+}>>, {
+    openNew: typeof open;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    save: (payload: {
+        name: string;
+    }) => void;
+}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_TypePropsToRuntimeProps<{
+    condCount: number;
+    colCount: number;
+}>>> & Readonly<{
+    onSave?: ((payload: {
+        name: string;
+    }) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export default _default;
+type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;
+type __VLS_TypePropsToRuntimeProps<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: import('vue').PropType<__VLS_NonUndefinedable<T[K]>>;
+    } : {
+        type: import('vue').PropType<T[K]>;
+        required: true;
+    };
+};

package/dist/types/src/editHistory.d.ts

@@ -0,0 +1,27 @@
+export interface EditChange<T = any> {
+    /** 变更目标（此处为行数据对象引用） */
+    target: T;
+    /** 列 id（colId / field） */
+    field: string;
+    oldValue: any;
+    newValue: any;
+}
+export declare class EditHistory<T = any> {
+    private undoStack;
+    private redoStack;
+    private limit;
+    constructor(limit?: number);
+    setLimit(n: number): void;
+    /** 记录一次动作（一组变更）；清空重做栈 */
+    push(group: EditChange<T>[]): void;
+    private trim;
+    canUndo(): boolean;
+    canRedo(): boolean;
+    get undoDepth(): number;
+    get redoDepth(): number;
+    /** 弹出一组待反向应用（写回 oldValue）的变更 */
+    undo(): EditChange<T>[] | null;
+    /** 弹出一组待正向应用（写回 newValue）的变更 */
+    redo(): EditChange<T>[] | null;
+    clear(): void;
+}

package/dist/types/src/export.d.ts

@@ -0,0 +1,24 @@
+export declare function toCsvText(matrix: any[][]): string;
+export declare function downloadCsv(matrix: any[][], fileName: string): void;
+export interface XlsxSheet {
+    name: string;
+    matrix: any[][];
+    colWidths?: number[];
+    /** 每个样式 id：0 常规 1 表头 2 分组/汇总 3 数字 */
+    rowStyles?: number[];
+    /** 前多少行为表头（默认 1），用于冻结窗格 */
+    headerRows?: number;
+}
+/** 多 sheet xlsx 工作簿 → Blob */
+export declare function buildXlsxWorkbook(sheets: XlsxSheet[]): Blob;
+/**
+ * 单矩阵 → xlsx Blob（向后兼容）
+ */
+export declare function buildXlsxBlob(matrix: any[][], colWidths?: number[]): Blob;
+export declare function downloadXlsx(matrix: any[][], fileName: string, colWidths?: number[]): void;
+export declare function downloadXlsxWorkbook(sheets: XlsxSheet[], fileName: string): void;
+export declare function toTsv(matrix: any[][]): string;
+/** 解析剪贴板文本（TSV，兼容引号包裹单元格） */
+export declare function parseTsv(text: string): string[][];
+export declare function writeClipboard(text: string): Promise<boolean>;
+export declare function readClipboard(): Promise<string>;

package/dist/types/src/expression.d.ts

@@ -0,0 +1,19 @@
+export interface ExprScope {
+    value?: any;
+    data?: any;
+    row?: any;
+    node?: any;
+    colId?: string;
+    column?: any;
+    [key: string]: any;
+}
+export type ExprFn = (scope: ExprScope) => any;
+/** 是否为字符串表达式（非空字符串） */
+export declare function isExpression(v: any): v is string;
+/**
+ * 编译字符串表达式为取值函数。编译失败返回 null（调用方回退原值）。
+ * 注入别名：value/data/row/node/colId/column/params，表达式内可用 `data.price * 100` 或 `params.value`。
+ */
+export declare function compileExpression(expr: string): ExprFn | null;
+/** 清空编译缓存（测试 / 热更新用） */
+export declare function clearExpressionCache(): void;

package/dist/types/src/filtering.d.ts

@@ -0,0 +1,29 @@
+import type { RjFilterCondition } from './types';
+/** 条件是否为"空条件"（未选择操作符）——空条件不参与判定 */
+export declare function isEmptyCondition(c: RjFilterCondition | undefined | null): boolean;
+/**
+ * 多条件组合判定（对标 AG Grid 单列 andOrConditions）。
+ * - 修正旧实现"命中任一即通过"的错误：operator==='and' 需全部非空条件通过；'or' 任一通过即可。
+ * - 全部为空条件时返回 true（视为不过滤）。
+ * test 由调用方提供（含类型转换 / 值解析）。
+ */
+export declare function evalConditions(conditions: RjFilterCondition[] | undefined, operator: 'and' | 'or', test: (c: RjFilterCondition) => boolean): boolean;
+/** 高级过滤：单个条件（绑定到某列） */
+export interface AdvColumnCondition {
+    colId: string;
+    condition: RjFilterCondition;
+    filterType?: string;
+}
+/** 高级过滤节点：可嵌套 and/or 组（表达式树，对标 AG Grid Advanced Filter） */
+export interface AdvFilterGroup {
+    operator: 'and' | 'or';
+    items: Array<AdvFilterGroup | AdvColumnCondition>;
+}
+export declare function isAdvGroup(node: AdvFilterGroup | AdvColumnCondition): node is AdvFilterGroup;
+/**
+ * 求值高级过滤表达式树。testCond 由调用方提供（解析列值 + matchCondition）。
+ * 空组 / 无条件视为通过。
+ */
+export declare function evalAdvancedFilter(node: AdvFilterGroup | null | undefined, testCond: (c: AdvColumnCondition) => boolean): boolean;
+/** 统计表达式树里的列条件总数（供状态栏/校验） */
+export declare function countAdvConditions(node: AdvFilterGroup | null | undefined): number;