@a2simcode/ui 0.0.263 → 0.0.265

package/README.md

@@ -1,156 +1,156 @@
-# SimCode UI
-
-<div align="center">
-  <h1>SimCode UI</h1>
-  <p>基于 Vue 3 + TypeScript 的现代化 UI 组件库</p>
-</div>
-
-## ✨ 特性
-
-- 🚀 **现代化技术栈**: 基于 Vue 3 + TypeScript + Vite
-- 📦 **开箱即用**: 提供完善的类型定义和文档
-- 🎨 **精美设计**: 现代化的设计风格
-- 🔧 **易于定制**: 支持主题定制
-- ⚡️ **按需加载**: 支持 Tree Shaking
-- 🧪 **完善测试**: 单元测试覆盖
-
-## 📦 安装
-
-使用 pnpm:
-
-```bash
-pnpm add @a2simcode/ui
-```
-
-使用 npm:
-
-```bash
-npm install @a2simcode/ui
-```
-
-使用 yarn:
-
-```bash
-yarn add @a2simcode/ui
-```
-
-### 安装 Peer Dependencies
-
-`@a2simcode/ui` 使用 peer dependencies 来避免重复打包依赖。**必须安装**以下依赖：
-
-```bash
-pnpm add vue element-plus
-```
-
-根据你使用的组件，可能还需要安装以下**可选依赖**：
-
-```bash
-# 如果使用表格组件
-pnpm add @visactor/vtable @visactor/vtable-editors
-
-# 如果使用图表组件
-pnpm add echarts
-
-# 如果使用代码编辑器组件
-pnpm add codemirror @codemirror/autocomplete @codemirror/commands @codemirror/lang-javascript @codemirror/lang-json @codemirror/lang-sql @codemirror/lang-python @codemirror/lang-java @codemirror/lang-css @codemirror/lang-html @codemirror/lang-xml @codemirror/lang-markdown @codemirror/language @codemirror/state @codemirror/view
-
-# 如果使用其他功能组件
-pnpm add @iconify/vue @vueuse/core dayjs async-validator crypto-js sortablejs sql-formatter countup.js @bwip-js/browser @wangeditor/editor diagram-js diagram-js-direct-editing min-dom inherits tiny-svg min-dash
-```
-
-> **注意**: 由于 `@a2simcode/ui` 输出的是预打包的单文件，使用方的打包器可能无法自动识别 peer dependencies。请确保在使用相关组件前，已安装对应的 peer dependencies。
-
-## 🔨 快速开始
-
-### 完整引入
-
-```typescript
-import { createApp } from 'vue'
-import App from './App.vue'
-import SimCodeUI from '@a2simcode/ui'
-import '@a2simcode/ui/dist/style.css'
-
-const app = createApp(App)
-app.use(SimCodeUI)
-app.mount('#app')
-```
-
-### 按需引入
-
-```vue
-<template>
-  <j-button type="primary">按钮</j-button>
-</template>
-
-<script setup lang="ts">
-import { JButton } from '@a2simcode/ui'
-import '@a2simcode/ui/dist/style.css'
-</script>
-```
-
-## 🎯 组件列表
-
-- ✅ Button 按钮
-- ✅ Input 输入框
-- ✅ Radio 单选框
-- 🚧 更多组件开发中...
-
-## 💻 本地开发
-
-```bash
-# 进入项目目录
-cd simcode-ui
-
-# 安装依赖
-pnpm install
-
-# 启动开发服务器
-pnpm dev
-
-# 构建组件库
-pnpm build
-
-# 运行测试
-pnpm test
-
-# 启动文档站点
-pnpm docs:dev
-```
-
-## 📁 项目结构
-
-```
-simcode-ui/
-├── packages/              # 组件源码
-│   ├── components/        # 组件
-│   │   ├── button/       # 按钮组件
-│   │   ├── input/        # 输入框组件
-│   │   └── index.ts      # 组件入口
-│   └── theme/            # 主题样式
-│       └── src/          # 样式源码 (Less)
-├── examples/             # 组件预览
-│   ├── App.vue          # 预览应用
-│   └── main.ts          # 入口文件
-├── docs/                # 文档
-│   ├── .vitepress/      # VitePress 配置
-│   ├── guide/           # 指南
-│   └── components/      # 组件文档
-├── __tests__/           # 测试文件
-├── vite.config.ts       # Vite 配置
-├── vitest.config.ts     # Vitest 配置
-└── package.json         # 项目配置
-```
-
-## 🤝 贡献
-
-欢迎提交 Issue 和 Pull Request!
-
-## 📄 版权声明
-
-Copyright © 2024 苏州极简搭信息技术有限公司. All rights reserved.
-
-本软件及其相关文档为专有软件,受版权法保护。未经版权所有者明确书面许可,不得以任何形式或方式(电子、机械、复印、录制或其他方式)复制、分发、传播或使用本软件的任何部分。
-
-## 🙏 致谢
-
-感谢所有为这个项目做出贡献的开发者!
+# SimCode UI
+
+<div align="center">
+  <h1>SimCode UI</h1>
+  <p>基于 Vue 3 + TypeScript 的现代化 UI 组件库</p>
+</div>
+
+## ✨ 特性
+
+- 🚀 **现代化技术栈**: 基于 Vue 3 + TypeScript + Vite
+- 📦 **开箱即用**: 提供完善的类型定义和文档
+- 🎨 **精美设计**: 现代化的设计风格
+- 🔧 **易于定制**: 支持主题定制
+- ⚡️ **按需加载**: 支持 Tree Shaking
+- 🧪 **完善测试**: 单元测试覆盖
+
+## 📦 安装
+
+使用 pnpm:
+
+```bash
+pnpm add @a2simcode/ui
+```
+
+使用 npm:
+
+```bash
+npm install @a2simcode/ui
+```
+
+使用 yarn:
+
+```bash
+yarn add @a2simcode/ui
+```
+
+### 安装 Peer Dependencies
+
+`@a2simcode/ui` 使用 peer dependencies 来避免重复打包依赖。**必须安装**以下依赖：
+
+```bash
+pnpm add vue element-plus
+```
+
+根据你使用的组件，可能还需要安装以下**可选依赖**：
+
+```bash
+# 如果使用表格组件
+pnpm add @visactor/vtable @visactor/vtable-editors
+
+# 如果使用图表组件
+pnpm add echarts
+
+# 如果使用代码编辑器组件
+pnpm add codemirror @codemirror/autocomplete @codemirror/commands @codemirror/lang-javascript @codemirror/lang-json @codemirror/lang-sql @codemirror/lang-python @codemirror/lang-java @codemirror/lang-css @codemirror/lang-html @codemirror/lang-xml @codemirror/lang-markdown @codemirror/language @codemirror/state @codemirror/view
+
+# 如果使用其他功能组件
+pnpm add @iconify/vue @vueuse/core dayjs async-validator crypto-js sortablejs sql-formatter countup.js @bwip-js/browser @wangeditor/editor diagram-js diagram-js-direct-editing min-dom inherits tiny-svg min-dash
+```
+
+> **注意**: 由于 `@a2simcode/ui` 输出的是预打包的单文件，使用方的打包器可能无法自动识别 peer dependencies。请确保在使用相关组件前，已安装对应的 peer dependencies。
+
+## 🔨 快速开始
+
+### 完整引入
+
+```typescript
+import { createApp } from 'vue'
+import App from './App.vue'
+import SimCodeUI from '@a2simcode/ui'
+import '@a2simcode/ui/dist/style.css'
+
+const app = createApp(App)
+app.use(SimCodeUI)
+app.mount('#app')
+```
+
+### 按需引入
+
+```vue
+<template>
+  <j-button type="primary">按钮</j-button>
+</template>
+
+<script setup lang="ts">
+import { JButton } from '@a2simcode/ui'
+import '@a2simcode/ui/dist/style.css'
+</script>
+```
+
+## 🎯 组件列表
+
+- ✅ Button 按钮
+- ✅ Input 输入框
+- ✅ Radio 单选框
+- 🚧 更多组件开发中...
+
+## 💻 本地开发
+
+```bash
+# 进入项目目录
+cd simcode-ui
+
+# 安装依赖
+pnpm install
+
+# 启动开发服务器
+pnpm dev
+
+# 构建组件库
+pnpm build
+
+# 运行测试
+pnpm test
+
+# 启动文档站点
+pnpm docs:dev
+```
+
+## 📁 项目结构
+
+```
+simcode-ui/
+├── packages/              # 组件源码
+│   ├── components/        # 组件
+│   │   ├── button/       # 按钮组件
+│   │   ├── input/        # 输入框组件
+│   │   └── index.ts      # 组件入口
+│   └── theme/            # 主题样式
+│       └── src/          # 样式源码 (Less)
+├── examples/             # 组件预览
+│   ├── App.vue          # 预览应用
+│   └── main.ts          # 入口文件
+├── docs/                # 文档
+│   ├── .vitepress/      # VitePress 配置
+│   ├── guide/           # 指南
+│   └── components/      # 组件文档
+├── __tests__/           # 测试文件
+├── vite.config.ts       # Vite 配置
+├── vitest.config.ts     # Vitest 配置
+└── package.json         # 项目配置
+```
+
+## 🤝 贡献
+
+欢迎提交 Issue 和 Pull Request!
+
+## 📄 版权声明
+
+Copyright © 2024 苏州极简搭信息技术有限公司. All rights reserved.
+
+本软件及其相关文档为专有软件,受版权法保护。未经版权所有者明确书面许可,不得以任何形式或方式(电子、机械、复印、录制或其他方式)复制、分发、传播或使用本软件的任何部分。
+
+## 🙏 致谢
+
+感谢所有为这个项目做出贡献的开发者!

package/dist/components/table/index.d.ts

@@ -4,6 +4,10 @@ declare const JTable: {
             type: StringConstructor;
             default: string;
         };
+        label: {
+            type: StringConstructor;
+            default: string;
+        };
         modelValue: {
             type: import('vue').PropType<Record<string, any>[]>;
             default: () => never[];
@@ -116,6 +120,14 @@ declare const JTable: {
             type: (StringConstructor | NumberConstructor)[];
             default: undefined;
         };
+        isRowFixed: {
+            type: BooleanConstructor;
+            default: boolean;
+        };
+        rowNum: {
+            type: NumberConstructor;
+            default: number;
+        };
         highlightMode: {
             type: import('vue').PropType<"cross" | "row" | "column" | "cell">;
             default: string;
@@ -144,6 +156,10 @@ declare const JTable: {
             type: import('vue').PropType<(record: Record<string, any>) => Promise<any[]>>;
             default: null;
         };
+        customMergeCell: {
+            type: import('vue').PropType<import('.').CustomMergeCellOption>;
+            default: null;
+        };
     }>> & Readonly<{
         "onUpdate:modelValue"?: ((value: Record<string, any>[]) => any) | undefined;
         onChange?: ((data: {
@@ -202,8 +218,10 @@ declare const JTable: {
             page: number;
         }) => any;
     }, import('vue').PublicProps, {
+        label: string;
         id: string;
         modelValue: Record<string, any>[];
+        rowNum: number;
         isPage: boolean;
         columns: import('.').ColumnSchemaConfig[];
         columnFilter: string[];
@@ -238,6 +256,7 @@ declare const JTable: {
         isAnimationAppear: boolean;
         heightMode: "auto" | "full";
         maxHeight: string | number;
+        isRowFixed: boolean;
         highlightMode: "row" | "cross" | "column" | "cell";
         editConfig: import('..').EditConfigType;
         emptyTipText: string;
@@ -245,6 +264,7 @@ declare const JTable: {
         isSubShowNumber: boolean;
         subActions: import('..').ButtonCompType[];
         loadChildren: (record: Record<string, any>) => Promise<any[]>;
+        customMergeCell: import('.').CustomMergeCellOption;
     }, true, {}, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, {
         tableContainer: HTMLDivElement;
     }, HTMLDivElement, import('vue').ComponentProvideOptions, {
@@ -259,6 +279,10 @@ declare const JTable: {
             type: StringConstructor;
             default: string;
         };
+        label: {
+            type: StringConstructor;
+            default: string;
+        };
         modelValue: {
             type: import('vue').PropType<Record<string, any>[]>;
             default: () => never[];
@@ -371,6 +395,14 @@ declare const JTable: {
             type: (StringConstructor | NumberConstructor)[];
             default: undefined;
         };
+        isRowFixed: {
+            type: BooleanConstructor;
+            default: boolean;
+        };
+        rowNum: {
+            type: NumberConstructor;
+            default: number;
+        };
         highlightMode: {
             type: import('vue').PropType<"cross" | "row" | "column" | "cell">;
             default: string;
@@ -399,6 +431,10 @@ declare const JTable: {
             type: import('vue').PropType<(record: Record<string, any>) => Promise<any[]>>;
             default: null;
         };
+        customMergeCell: {
+            type: import('vue').PropType<import('.').CustomMergeCellOption>;
+            default: null;
+        };
     }>> & Readonly<{
         "onUpdate:modelValue"?: ((value: Record<string, any>[]) => any) | undefined;
         onChange?: ((data: {
@@ -432,8 +468,10 @@ declare const JTable: {
         setSelection: (records: any[]) => void;
         renderTable: () => void;
     }, {}, {}, {}, {
+        label: string;
         id: string;
         modelValue: Record<string, any>[];
+        rowNum: number;
         isPage: boolean;
         columns: import('.').ColumnSchemaConfig[];
         columnFilter: string[];
@@ -468,6 +506,7 @@ declare const JTable: {
         isAnimationAppear: boolean;
         heightMode: "auto" | "full";
         maxHeight: string | number;
+        isRowFixed: boolean;
         highlightMode: "row" | "cross" | "column" | "cell";
         editConfig: import('..').EditConfigType;
         emptyTipText: string;
@@ -475,6 +514,7 @@ declare const JTable: {
         isSubShowNumber: boolean;
         subActions: import('..').ButtonCompType[];
         loadChildren: (record: Record<string, any>) => Promise<any[]>;
+        customMergeCell: import('.').CustomMergeCellOption;
     }>;
     __isFragment?: never;
     __isTeleport?: never;
@@ -484,6 +524,10 @@ declare const JTable: {
         type: StringConstructor;
         default: string;
     };
+    label: {
+        type: StringConstructor;
+        default: string;
+    };
     modelValue: {
         type: import('vue').PropType<Record<string, any>[]>;
         default: () => never[];
@@ -596,6 +640,14 @@ declare const JTable: {
         type: (StringConstructor | NumberConstructor)[];
         default: undefined;
     };
+    isRowFixed: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    rowNum: {
+        type: NumberConstructor;
+        default: number;
+    };
     highlightMode: {
         type: import('vue').PropType<"cross" | "row" | "column" | "cell">;
         default: string;
@@ -624,6 +676,10 @@ declare const JTable: {
         type: import('vue').PropType<(record: Record<string, any>) => Promise<any[]>>;
         default: null;
     };
+    customMergeCell: {
+        type: import('vue').PropType<import('.').CustomMergeCellOption>;
+        default: null;
+    };
 }>> & Readonly<{
     "onUpdate:modelValue"?: ((value: Record<string, any>[]) => any) | undefined;
     onChange?: ((data: {
@@ -682,8 +738,10 @@ declare const JTable: {
         page: number;
     }) => any;
 }, string, {
+    label: string;
     id: string;
     modelValue: Record<string, any>[];
+    rowNum: number;
     isPage: boolean;
     columns: import('.').ColumnSchemaConfig[];
     columnFilter: string[];
@@ -718,6 +776,7 @@ declare const JTable: {
     isAnimationAppear: boolean;
     heightMode: "auto" | "full";
     maxHeight: string | number;
+    isRowFixed: boolean;
     highlightMode: "row" | "cross" | "column" | "cell";
     editConfig: import('..').EditConfigType;
     emptyTipText: string;
@@ -725,6 +784,7 @@ declare const JTable: {
     isSubShowNumber: boolean;
     subActions: import('..').ButtonCompType[];
     loadChildren: (record: Record<string, any>) => Promise<any[]>;
+    customMergeCell: import('.').CustomMergeCellOption;
 }, {}, string, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, import('vue').ComponentProvideOptions> & import('vue').VNodeProps & import('vue').AllowedComponentProps & import('vue').ComponentCustomProps & {
     install: (app: import('vue').App) => void;
 };

package/dist/components/table/src/interface.d.ts

@@ -1,4 +1,42 @@
 import { BaseSchemaConfig, BaseCompConfig } from '../../comp/src/interface';
+/**
+ * @zh 合并单元格配置类型
+ */
+export type MergeCellOption = boolean | ((v1: unknown, v2: unknown, info: {
+    source: {
+        col: number;
+        row: number;
+    };
+    target: {
+        col: number;
+        row: number;
+    };
+    table: any;
+}) => boolean);
+/**
+ * @zh 自定义合并单元格规则
+ */
+export interface CustomMergeCellRule {
+    /** 合并单元格内的文字 */
+    text?: string;
+    /** 合并的范围 */
+    range: {
+        start: {
+            col: number;
+            row: number;
+        };
+        end: {
+            col: number;
+            row: number;
+        };
+    };
+    /** 合并单元格的样式 */
+    style?: Record<string, any>;
+}
+/**
+ * @zh 自定义合并单元格配置类型
+ */
+export type CustomMergeCellOption = CustomMergeCellRule[] | ((col: number, row: number, table: any) => CustomMergeCellRule | undefined);
 export interface TableColumnConfig {
     /**
      * @zh 列的宽度
@@ -52,6 +90,10 @@ export interface TableColumnConfig {
      * @zh 冻结列 left 左侧冻结 right 右侧冻结
      */
     frozen?: 'left' | 'right';
+    /**
+     * @zh 合并单元格配置，为 true 时自动合并相邻相同值的单元格，也可传入自定义合并函数
+     */
+    mergeCell?: MergeCellOption;
 }
 export type TableColumnCompConfig = TableColumnConfig & BaseCompConfig;
 export interface TableColumnFilter {

package/dist/components/table/src/table.vue.d.ts

@@ -1,4 +1,4 @@
-import { ColumnSchemaConfig } from './interface';
+import { ColumnSchemaConfig, CustomMergeCellOption } from './interface';
 import { ButtonCompType } from '../../buttons/src/interface';
 import { EditConfigType } from '../../input-rows/src/interface';
 import { PropType } from 'vue';
@@ -7,6 +7,10 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         type: StringConstructor;
         default: string;
     };
+    label: {
+        type: StringConstructor;
+        default: string;
+    };
     /**
      * @zh 输入值【作为表单的编辑表格使用】
      * @vModel
@@ -198,6 +202,20 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         type: (StringConstructor | NumberConstructor)[];
         default: undefined;
     };
+    /**
+     * @zh 是否固定行数
+     */
+    isRowFixed: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /**
+     * @zh 固定行数，仅在 isRowFixed 为 true 时生效
+     */
+    rowNum: {
+        type: NumberConstructor;
+        default: number;
+    };
     /**
      * @zh 高亮模式 cross 十字 row 行 column 列 cell 单元格
      */
@@ -247,6 +265,13 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         type: PropType<(record: Record<string, any>) => Promise<any[]>>;
         default: null;
     };
+    /**
+     * @zh 自定义合并单元格配置，支持回调函数或合并规则数组
+     */
+    customMergeCell: {
+        type: PropType<CustomMergeCellOption>;
+        default: null;
+    };
 }>, {
     getInstance: () => any;
     setRecords: (records: Record<string, any>[]) => void;
@@ -284,6 +309,10 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         type: StringConstructor;
         default: string;
     };
+    label: {
+        type: StringConstructor;
+        default: string;
+    };
     /**
      * @zh 输入值【作为表单的编辑表格使用】
      * @vModel
@@ -475,6 +504,20 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         type: (StringConstructor | NumberConstructor)[];
         default: undefined;
     };
+    /**
+     * @zh 是否固定行数
+     */
+    isRowFixed: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /**
+     * @zh 固定行数，仅在 isRowFixed 为 true 时生效
+     */
+    rowNum: {
+        type: NumberConstructor;
+        default: number;
+    };
     /**
      * @zh 高亮模式 cross 十字 row 行 column 列 cell 单元格
      */
@@ -524,6 +567,13 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         type: PropType<(record: Record<string, any>) => Promise<any[]>>;
         default: null;
     };
+    /**
+     * @zh 自定义合并单元格配置，支持回调函数或合并规则数组
+     */
+    customMergeCell: {
+        type: PropType<CustomMergeCellOption>;
+        default: null;
+    };
 }>> & Readonly<{
     "onUpdate:modelValue"?: ((value: Record<string, any>[]) => any) | undefined;
     onChange?: ((data: {
@@ -550,8 +600,10 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         page: number;
     }) => any) | undefined;
 }>, {
+    label: string;
     id: string;
     modelValue: Record<string, any>[];
+    rowNum: number;
     isPage: boolean;
     columns: ColumnSchemaConfig[];
     columnFilter: string[];
@@ -586,6 +638,7 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
     isAnimationAppear: boolean;
     heightMode: "auto" | "full";
     maxHeight: string | number;
+    isRowFixed: boolean;
     highlightMode: "row" | "cross" | "column" | "cell";
     editConfig: EditConfigType;
     emptyTipText: string;
@@ -593,6 +646,7 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
     isSubShowNumber: boolean;
     subActions: ButtonCompType[];
     loadChildren: (record: Record<string, any>) => Promise<any[]>;
+    customMergeCell: CustomMergeCellOption;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {
     tableContainer: HTMLDivElement;
 }, HTMLDivElement>;