@a2simcode/ui 0.0.269 → 0.0.271

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

@@ -17,6 +17,10 @@ declare const JTable: {
             required: true;
             default: () => never[];
         };
+        mergeHeader: {
+            type: import('vue').PropType<import('.').MergeHeaderOption[]>;
+            default: () => never[];
+        };
         columnFilter: {
             type: import('vue').PropType<string[]>;
             default: () => never[];
@@ -224,6 +228,7 @@ declare const JTable: {
         rowNum: number;
         isPage: boolean;
         columns: import('.').ColumnSchemaConfig[];
+        mergeHeader: import('.').MergeHeaderOption[];
         columnFilter: string[];
         records: Record<string, any>[];
         isTree: boolean;
@@ -292,6 +297,10 @@ declare const JTable: {
             required: true;
             default: () => never[];
         };
+        mergeHeader: {
+            type: import('vue').PropType<import('.').MergeHeaderOption[]>;
+            default: () => never[];
+        };
         columnFilter: {
             type: import('vue').PropType<string[]>;
             default: () => never[];
@@ -474,6 +483,7 @@ declare const JTable: {
         rowNum: number;
         isPage: boolean;
         columns: import('.').ColumnSchemaConfig[];
+        mergeHeader: import('.').MergeHeaderOption[];
         columnFilter: string[];
         records: Record<string, any>[];
         isTree: boolean;
@@ -537,6 +547,10 @@ declare const JTable: {
         required: true;
         default: () => never[];
     };
+    mergeHeader: {
+        type: import('vue').PropType<import('.').MergeHeaderOption[]>;
+        default: () => never[];
+    };
     columnFilter: {
         type: import('vue').PropType<string[]>;
         default: () => never[];
@@ -744,6 +758,7 @@ declare const JTable: {
     rowNum: number;
     isPage: boolean;
     columns: import('.').ColumnSchemaConfig[];
+    mergeHeader: import('.').MergeHeaderOption[];
     columnFilter: string[];
     records: Record<string, any>[];
     isTree: boolean;

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

@@ -37,6 +37,19 @@ export interface CustomMergeCellRule {
  * @zh 自定义合并单元格配置类型
  */
 export type CustomMergeCellOption = CustomMergeCellRule[] | ((col: number, row: number, table: any) => CustomMergeCellRule | undefined);
+/**
+ * @zh 合并表头配置
+ */
+export interface MergeHeaderOption {
+    /** 表头配置唯一标识，可被后续 value 引用 */
+    _i?: string;
+    /** 合并表头显示文本 */
+    label: string;
+    /** 子列 id 或上级表头 _i，多个用英文逗号分隔 */
+    value: string;
+    /** 表头对齐方式 */
+    align?: 'left' | 'center' | 'right';
+}
 export interface TableColumnConfig {
     /**
      * @zh 列的宽度

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

@@ -1,4 +1,4 @@
-import { ColumnSchemaConfig, CustomMergeCellOption } from './interface';
+import { ColumnSchemaConfig, CustomMergeCellOption, MergeHeaderOption } from './interface';
 import { ButtonCompType } from '../../buttons/src/interface';
 import { EditConfigType } from '../../input-rows/src/interface';
 import { PropType } from 'vue';
@@ -27,6 +27,13 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         required: true;
         default: () => never[];
     };
+    /**
+     * @zh 合并表头配置，value 支持逗号分隔列 id 或前置合并表头 _i
+     */
+    mergeHeader: {
+        type: PropType<MergeHeaderOption[]>;
+        default: () => never[];
+    };
     /**
      * @zh 列过滤（用于隐藏列）
      */
@@ -329,6 +336,13 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         required: true;
         default: () => never[];
     };
+    /**
+     * @zh 合并表头配置，value 支持逗号分隔列 id 或前置合并表头 _i
+     */
+    mergeHeader: {
+        type: PropType<MergeHeaderOption[]>;
+        default: () => never[];
+    };
     /**
      * @zh 列过滤（用于隐藏列）
      */
@@ -606,6 +620,7 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
     rowNum: number;
     isPage: boolean;
     columns: ColumnSchemaConfig[];
+    mergeHeader: MergeHeaderOption[];
     columnFilter: string[];
     records: Record<string, any>[];
     isTree: boolean;