@a2simcode/ui 0.0.154 → 0.0.156

package/docs/components/dynamic-layer.md

@@ -1,118 +1,118 @@
-# DynamicLayer 动态层
-
-动态加载组件的弹层，基于 Layer 组件封装，支持动态渲染任意组件并提供统一的弹层交互。
-
-## 基础用法
-
-通过 `open` 方法打开弹层，动态加载指定组件。
-
-<Demo :source-code="dynamicLayerBasicCode">
-  <template #source>
-    <dynamic-layer-basic />
-  </template>
-  <template #description>
-    使用 `ref` 调用 `open` 方法打开弹层，通过 `name` 属性指定要加载的组件。
-  </template>
-</Demo>
-
-## 表单场景
-
-适用于动态表单的场景，组件内可以定义 `open` 和 `ok` 方法与弹层交互。
-
-<Demo :source-code="dynamicLayerFormCode">
-  <template #source>
-    <dynamic-layer-form />
-  </template>
-  <template #description>
-    动态组件可以通过 `expose` 暴露 `open` 和 `ok` 方法。`open` 方法接收传入的参数，`ok` 方法在点击确定时调用，返回 `true` 时弹层关闭。
-  </template>
-</Demo>
-
-## 不同类型
-
-支持 modal、drawer、full 三种弹层类型。
-
-<Demo :source-code="dynamicLayerTypesCode">
-  <template #source>
-    <dynamic-layer-types />
-  </template>
-  <template #description>
-    通过 `type` 参数指定弹层类型，支持弹窗(modal)、抽屉(drawer)、全屏(full)三种形式。
-  </template>
-</Demo>
-
-## 自定义按钮
-
-组件内可以通过 `getConfig` 方法返回自定义按钮配置。
-
-<Demo :source-code="dynamicLayerCustomButtonsCode">
-  <template #source>
-    <dynamic-layer-custom-buttons />
-  </template>
-  <template #description>
-    动态组件通过 `getConfig` 方法返回 `buttons` 数组，可以添加自定义按钮。设置 `hasSaveBtn` 为 `false` 可隐藏默认保存按钮。
-  </template>
-</Demo>
-
-## 步骤弹窗
-
-支持步骤条模式的弹层。
-
-<Demo :source-code="dynamicLayerStepsCode">
-  <template #source>
-    <dynamic-layer-steps />
-  </template>
-  <template #description>
-    动态组件通过 `getConfig` 返回 `isStep` 和 `steps` 配置步骤条，通过 `validateSteps` 方法进行步骤校验。
-  </template>
-</Demo>
-
-## API
-
-### 方法
-
-| 方法名 | 说明     | 参数                             |
-| ------ | -------- | -------------------------------- |
-| open   | 打开弹层 | `(data: LayerParamType) => void` |
-
-### LayerParamType 参数
-
-<ApiTable :data="dynamicLayerApi" componentName="dynamic-layer" />
-
-### 动态组件约定
-
-动态加载的组件可以通过 `expose` 暴露以下方法与弹层交互：
-
-| 方法名        | 说明               | 参数                                             | 返回值                                                    |
-| ------------- | ------------------ | ------------------------------------------------ | --------------------------------------------------------- |
-| open          | 弹层打开时调用     | `(param: any, layerRef: any, afterOk: Function)` | `Promise<{ buttons?: any[] }>`                            |
-| ok            | 点击确定按钮时调用 | -                                                | `Promise<boolean \| any>`                                 |
-| closed        | 弹层关闭后调用     | -                                                | `void`                                                    |
-| beforeClose   | 弹层关闭前调用     | -                                                | `boolean \| Promise<boolean>`                             |
-| getConfig     | 获取弹层配置       | -                                                | `{ isStep?: boolean, steps?: string[], buttons?: any[] }` |
-| validateSteps | 步骤校验           | `(stepActive: number)`                           | `Promise<boolean>`                                        |
-
-### 回调函数
-
-可以通过 `open` 方法的参数传入以下回调函数：
-
-| 回调名      | 说明       | 参数                  |
-| ----------- | ---------- | --------------------- |
-| afterOk     | 确定后回调 | `(data: any) => void` |
-| afterClose  | 关闭后回调 | `() => void`          |
-| afterCancel | 取消后回调 | `() => void`          |
-
-<script setup>
-import DynamicLayerBasic from '../examples/dynamic-layer/basic.vue'
-import DynamicLayerForm from '../examples/dynamic-layer/form.vue'
-import DynamicLayerTypes from '../examples/dynamic-layer/types.vue'
-import DynamicLayerCustomButtons from '../examples/dynamic-layer/custom-buttons.vue'
-import DynamicLayerSteps from '../examples/dynamic-layer/steps.vue'
-import dynamicLayerApi from './meta/dynamic-layer'
-
-import dynamicLayerBasicCode from '../examples/dynamic-layer/basic.vue?raw'
-import dynamicLayerFormCode from '../examples/dynamic-layer/form.vue?raw'
-import dynamicLayerTypesCode from '../examples/dynamic-layer/types.vue?raw'
-import dynamicLayerCustomButtonsCode from '../examples/dynamic-layer/custom-buttons.vue?raw'
-import dynamicLayerStepsCode from '../examples/dynamic-layer/steps.vue?raw'
-</script>
+# DynamicLayer 动态层
+
+动态加载组件的弹层，基于 Layer 组件封装，支持动态渲染任意组件并提供统一的弹层交互。
+
+## 基础用法
+
+通过 `open` 方法打开弹层，动态加载指定组件。
+
+<Demo :source-code="dynamicLayerBasicCode">
+  <template #source>
+    <dynamic-layer-basic />
+  </template>
+  <template #description>
+    使用 `ref` 调用 `open` 方法打开弹层，通过 `name` 属性指定要加载的组件。
+  </template>
+</Demo>
+
+## 表单场景
+
+适用于动态表单的场景，组件内可以定义 `open` 和 `ok` 方法与弹层交互。
+
+<Demo :source-code="dynamicLayerFormCode">
+  <template #source>
+    <dynamic-layer-form />
+  </template>
+  <template #description>
+    动态组件可以通过 `expose` 暴露 `open` 和 `ok` 方法。`open` 方法接收传入的参数，`ok` 方法在点击确定时调用，返回 `true` 时弹层关闭。
+  </template>
+</Demo>
+
+## 不同类型
+
+支持 modal、drawer、full 三种弹层类型。
+
+<Demo :source-code="dynamicLayerTypesCode">
+  <template #source>
+    <dynamic-layer-types />
+  </template>
+  <template #description>
+    通过 `type` 参数指定弹层类型，支持弹窗(modal)、抽屉(drawer)、全屏(full)三种形式。
+  </template>
+</Demo>
+
+## 自定义按钮
+
+组件内可以通过 `getConfig` 方法返回自定义按钮配置。
+
+<Demo :source-code="dynamicLayerCustomButtonsCode">
+  <template #source>
+    <dynamic-layer-custom-buttons />
+  </template>
+  <template #description>
+    动态组件通过 `getConfig` 方法返回 `buttons` 数组，可以添加自定义按钮。设置 `hasSaveBtn` 为 `false` 可隐藏默认保存按钮。
+  </template>
+</Demo>
+
+## 步骤弹窗
+
+支持步骤条模式的弹层。
+
+<Demo :source-code="dynamicLayerStepsCode">
+  <template #source>
+    <dynamic-layer-steps />
+  </template>
+  <template #description>
+    动态组件通过 `getConfig` 返回 `isStep` 和 `steps` 配置步骤条，通过 `validateSteps` 方法进行步骤校验。
+  </template>
+</Demo>
+
+## API
+
+### 方法
+
+| 方法名 | 说明     | 参数                             |
+| ------ | -------- | -------------------------------- |
+| open   | 打开弹层 | `(data: LayerParamType) => void` |
+
+### LayerParamType 参数
+
+<ApiTable :data="dynamicLayerApi" componentName="dynamic-layer" />
+
+### 动态组件约定
+
+动态加载的组件可以通过 `expose` 暴露以下方法与弹层交互：
+
+| 方法名        | 说明               | 参数                                             | 返回值                                                    |
+| ------------- | ------------------ | ------------------------------------------------ | --------------------------------------------------------- |
+| open          | 弹层打开时调用     | `(param: any, layerRef: any, afterOk: Function)` | `Promise<{ buttons?: any[] }>`                            |
+| ok            | 点击确定按钮时调用 | -                                                | `Promise<boolean \| any>`                                 |
+| closed        | 弹层关闭后调用     | -                                                | `void`                                                    |
+| beforeClose   | 弹层关闭前调用     | -                                                | `boolean \| Promise<boolean>`                             |
+| getConfig     | 获取弹层配置       | -                                                | `{ isStep?: boolean, steps?: string[], buttons?: any[] }` |
+| validateSteps | 步骤校验           | `(stepActive: number)`                           | `Promise<boolean>`                                        |
+
+### 回调函数
+
+可以通过 `open` 方法的参数传入以下回调函数：
+
+| 回调名      | 说明       | 参数                  |
+| ----------- | ---------- | --------------------- |
+| afterOk     | 确定后回调 | `(data: any) => void` |
+| afterClose  | 关闭后回调 | `() => void`          |
+| afterCancel | 取消后回调 | `() => void`          |
+
+<script setup>
+import DynamicLayerBasic from '../examples/dynamic-layer/basic.vue'
+import DynamicLayerForm from '../examples/dynamic-layer/form.vue'
+import DynamicLayerTypes from '../examples/dynamic-layer/types.vue'
+import DynamicLayerCustomButtons from '../examples/dynamic-layer/custom-buttons.vue'
+import DynamicLayerSteps from '../examples/dynamic-layer/steps.vue'
+import dynamicLayerApi from './meta/dynamic-layer'
+
+import dynamicLayerBasicCode from '../examples/dynamic-layer/basic.vue?raw'
+import dynamicLayerFormCode from '../examples/dynamic-layer/form.vue?raw'
+import dynamicLayerTypesCode from '../examples/dynamic-layer/types.vue?raw'
+import dynamicLayerCustomButtonsCode from '../examples/dynamic-layer/custom-buttons.vue?raw'
+import dynamicLayerStepsCode from '../examples/dynamic-layer/steps.vue?raw'
+</script>

package/docs/components/echarts.md

@@ -1,72 +1,72 @@
-# Echarts 图表
-
-基于 ECharts 的 Vue 3 图表组件封装。
-
-## 基础用法
-
-通过 `option` 属性传入 ECharts 配置。
-
-<Demo :source-code="echartsBasicCode">
-  <template #source>
-    <echarts-basic />
-  </template>
-  <template #description>
-    最基础的柱状图示例，通过点击事件可以获取图表数据。
-  </template>
-</Demo>
-
-## 折线图
-
-使用折线图展示趋势数据。
-
-<Demo :source-code="echartsLineCode">
-  <template #source>
-    <echarts-line />
-  </template>
-  <template #description>
-    多系列折线图，适合展示趋势对比。
-  </template>
-</Demo>
-
-## 饼图
-
-使用饼图展示占比数据。
-
-<Demo :source-code="echartsPieCode">
-  <template #source>
-    <echarts-pie />
-  </template>
-  <template #description>
-    饼图适合展示各部分在整体中的占比。
-  </template>
-</Demo>
-
-## 动态数据
-
-图表数据可以动态更新。
-
-<Demo :source-code="echartsDynamicCode">
-  <template #source>
-    <echarts-dynamic />
-  </template>
-  <template #description>
-    通过修改 `option` 数据，图表会自动更新。
-  </template>
-</Demo>
-
-## API
-
-<ApiTable :data="echartsApi" componentName="echarts" />
-
-<script setup>
-import EchartsBasic from '../examples/echarts/basic.vue'
-import EchartsLine from '../examples/echarts/line.vue'
-import EchartsPie from '../examples/echarts/pie.vue'
-import EchartsDynamic from '../examples/echarts/dynamic.vue'
-import echartsApi from './meta/echarts'
-
-import echartsBasicCode from '../examples/echarts/basic.vue?raw'
-import echartsLineCode from '../examples/echarts/line.vue?raw'
-import echartsPieCode from '../examples/echarts/pie.vue?raw'
-import echartsDynamicCode from '../examples/echarts/dynamic.vue?raw'
-</script>
+# Echarts 图表
+
+基于 ECharts 的 Vue 3 图表组件封装。
+
+## 基础用法
+
+通过 `option` 属性传入 ECharts 配置。
+
+<Demo :source-code="echartsBasicCode">
+  <template #source>
+    <echarts-basic />
+  </template>
+  <template #description>
+    最基础的柱状图示例，通过点击事件可以获取图表数据。
+  </template>
+</Demo>
+
+## 折线图
+
+使用折线图展示趋势数据。
+
+<Demo :source-code="echartsLineCode">
+  <template #source>
+    <echarts-line />
+  </template>
+  <template #description>
+    多系列折线图，适合展示趋势对比。
+  </template>
+</Demo>
+
+## 饼图
+
+使用饼图展示占比数据。
+
+<Demo :source-code="echartsPieCode">
+  <template #source>
+    <echarts-pie />
+  </template>
+  <template #description>
+    饼图适合展示各部分在整体中的占比。
+  </template>
+</Demo>
+
+## 动态数据
+
+图表数据可以动态更新。
+
+<Demo :source-code="echartsDynamicCode">
+  <template #source>
+    <echarts-dynamic />
+  </template>
+  <template #description>
+    通过修改 `option` 数据，图表会自动更新。
+  </template>
+</Demo>
+
+## API
+
+<ApiTable :data="echartsApi" componentName="echarts" />
+
+<script setup>
+import EchartsBasic from '../examples/echarts/basic.vue'
+import EchartsLine from '../examples/echarts/line.vue'
+import EchartsPie from '../examples/echarts/pie.vue'
+import EchartsDynamic from '../examples/echarts/dynamic.vue'
+import echartsApi from './meta/echarts'
+
+import echartsBasicCode from '../examples/echarts/basic.vue?raw'
+import echartsLineCode from '../examples/echarts/line.vue?raw'
+import echartsPieCode from '../examples/echarts/pie.vue?raw'
+import echartsDynamicCode from '../examples/echarts/dynamic.vue?raw'
+</script>

package/docs/components/editor.md

@@ -1,24 +1,24 @@
-# Editor 富文本编辑器
-
-基于 wangeditor 的富文本编辑器组件。
-
-## 基础用法
-
-<Demo :source-code="editorBasicCode">
-  <template #source>
-    <editor-basic />
-  </template>
-  <template #description>
-    基础用法，支持 `v-model:value` 双向绑定。
-  </template>
-</Demo>
-
-## API
-
-<ApiTable :data="editorApi" componentName="editor" />
-
-<script setup>
-import EditorBasic from '../examples/editor/basic.vue'
-import editorApi from './meta/editor'
-import editorBasicCode from '../examples/editor/basic.vue?raw'
-</script>
+# Editor 富文本编辑器
+
+基于 wangeditor 的富文本编辑器组件。
+
+## 基础用法
+
+<Demo :source-code="editorBasicCode">
+  <template #source>
+    <editor-basic />
+  </template>
+  <template #description>
+    基础用法，支持 `v-model:value` 双向绑定。
+  </template>
+</Demo>
+
+## API
+
+<ApiTable :data="editorApi" componentName="editor" />
+
+<script setup>
+import EditorBasic from '../examples/editor/basic.vue'
+import editorApi from './meta/editor'
+import editorBasicCode from '../examples/editor/basic.vue?raw'
+</script>

package/docs/components/form.md

@@ -1,57 +1,72 @@
-# Form 表单
-
-`j-form` 是一个强大的动态表单组件，支持通过 Schema 配置来生成表单，提供了完整的表单验证、数据管理和事件处理能力。
-
-## 基础用法
-
-通过 `schema` 属性定义表单结构，`config` 属性配置表单样式。
-
-<Demo :source-code="basicCode">
-  <template #source>
-    <basic />
-  </template>
-  <template #description>
-    使用 `j-form` 快速创建一个包含多个输入项的表单。通过 `validate` 方法进行表单验证，通过 `getFormData` 方法获取表单数据；也可以通过 `init` 方法在运行时重新加载 Schema（可选传入初始数据）。
-  </template>
-</Demo>
-
-## Init 方法
-
-通过模板引用调用 `init(schema, data)`，可以在运行时重新初始化表单 Schema，并可选传入初始数据。
-
-<Demo :source-code="initCode">
-  <template #source>
-    <init />
-  </template>
-  <template #description>
-    点击按钮切换不同的 Schema，并通过第二个参数传入初始数据。
-  </template>
-</Demo>
-
-## 主从表（主表 + 子表）
-
-通过 `j-layout` 划分区域，并在 `children` 中利用 `j-table` 搭配其子级输入组件，可以实现复杂的主从表（表单 + 子表格）布局。
-
-<Demo :source-code="masterDetailCode">
-  <template #source>
-    <master-detail />
-  </template>
-  <template #description>
-    结合 `j-layout` 布局组件实现主从表单。在子表中配置 `editConfig: { isAddBtn: true, isRemoveBtn: true }` 并提供 `addRow` 函数来管理行数据；通过 `slot: 'top'` 指定字段归属为主表区域。
-  </template>
-</Demo>
-
-## API
-
-<ApiTable :data="formApi" componentName="form" />
-
-<script setup>
-import Basic from '../examples/form/basic.vue'
-import Init from '../examples/form/init.vue'
-import MasterDetail from '../examples/form/master-detail.vue'
-import formApi from './meta/form'
-
-import basicCode from '../examples/form/basic.vue?raw'
-import initCode from '../examples/form/init.vue?raw'
-import masterDetailCode from '../examples/form/master-detail.vue?raw'
-</script>
+# Form 表单
+
+`j-form` 是一个强大的动态表单组件，支持通过 Schema 配置来生成表单，提供了完整的表单验证、数据管理和事件处理能力。
+
+## 基础用法
+
+通过 `schema` 属性定义表单结构，`config` 属性配置表单样式。
+
+<Demo :source-code="basicCode">
+  <template #source>
+    <basic />
+  </template>
+  <template #description>
+    使用 `j-form` 快速创建一个包含多个输入项的表单。通过 `validate` 方法进行表单验证，通过 `getFormData` 方法获取表单数据；也可以通过 `init` 方法在运行时重新加载 Schema（可选传入初始数据）。
+  </template>
+</Demo>
+
+## Init 方法
+
+通过模板引用调用 `init(schema, data)`，可以在运行时重新初始化表单 Schema，并可选传入初始数据。
+
+<Demo :source-code="initCode">
+  <template #source>
+    <init />
+  </template>
+  <template #description>
+    点击按钮切换不同的 Schema，并通过第二个参数传入初始数据。
+  </template>
+</Demo>
+
+## 主从表（主表 + 子表）
+
+通过 `j-layout` 划分区域，并在 `children` 中利用 `j-table` 搭配其子级输入组件，可以实现复杂的主从表（表单 + 子表格）布局。
+
+<Demo :source-code="masterDetailCode">
+  <template #source>
+    <master-detail />
+  </template>
+  <template #description>
+    结合 `j-layout` 布局组件实现主从表单。在子表中配置 `editConfig: { isAddBtn: true, isRemoveBtn: true }` 并提供 `addRow` 函数来管理行数据；通过 `slot: 'top'` 指定字段归属为主表区域。
+  </template>
+</Demo>
+
+## 表单 + 子表（规则格式）
+
+通过 `j-table` 在表单中嵌入可编辑的子表格，适用于编码规则、格式配置等场景。
+
+<Demo :source-code="ruleFormatCode">
+  <template #source>
+    <rule-format />
+  </template>
+  <template #description>
+    示例包含基础字段校验（必填/唯一性）以及 `j-table` 子表的可增删编辑能力。
+  </template>
+</Demo>
+
+## API
+
+<ApiTable :data="formApi" componentName="form" />
+
+<script setup>
+import Basic from '../examples/form/basic.vue'
+import Init from '../examples/form/init.vue'
+import MasterDetail from '../examples/form/master-detail.vue'
+import RuleFormat from '../examples/form/rule-format.vue'
+import formApi from './meta/form'
+
+import basicCode from '../examples/form/basic.vue?raw'
+import initCode from '../examples/form/init.vue?raw'
+import masterDetailCode from '../examples/form/master-detail.vue?raw'
+import ruleFormatCode from '../examples/form/rule-format.vue?raw'
+</script>

package/docs/components/guid.md

@@ -1,39 +1,39 @@
-# GUID 全局唯一标识符
-
-用于生成和展示全局唯一标识符(GUID/UUID)。当不指定值时，组件会自动生成一个UUID，这在创建新记录或需要唯一标识时非常有用。
-
-## 基础用法
-
-<Demo :source-code="guidBasicCode">
-  <template #source>
-    <guid-basic />
-  </template>
-  <template #description>
-    自动生成UUID，如果需要指定特定的GUID值，可以通过 v-model 绑定。
-  </template>
-</Demo>
-
-## 不同尺寸
-
-Guid 组件提供三种尺寸。
-
-<Demo :source-code="guidSizeCode">
-  <template #source>
-    <guid-size />
-  </template>
-  <template #description>
-    使用 size 属性改变组件大小。除了默认大小外，还有另外两个选项：large, small。
-  </template>
-</Demo>
-
-## API
-
-<ApiTable :data="guidApi" componentName="guid" />
-
-<script setup>
-import GuidBasic from '../examples/guid/basic.vue'
-import GuidSize from '../examples/guid/size.vue'
-import guidApi from './meta/guid'
-import guidBasicCode from '../examples/guid/basic.vue?raw'
-import guidSizeCode from '../examples/guid/size.vue?raw'
-</script>
+# GUID 全局唯一标识符
+
+用于生成和展示全局唯一标识符(GUID/UUID)。当不指定值时，组件会自动生成一个UUID，这在创建新记录或需要唯一标识时非常有用。
+
+## 基础用法
+
+<Demo :source-code="guidBasicCode">
+  <template #source>
+    <guid-basic />
+  </template>
+  <template #description>
+    自动生成UUID，如果需要指定特定的GUID值，可以通过 v-model 绑定。
+  </template>
+</Demo>
+
+## 不同尺寸
+
+Guid 组件提供三种尺寸。
+
+<Demo :source-code="guidSizeCode">
+  <template #source>
+    <guid-size />
+  </template>
+  <template #description>
+    使用 size 属性改变组件大小。除了默认大小外，还有另外两个选项：large, small。
+  </template>
+</Demo>
+
+## API
+
+<ApiTable :data="guidApi" componentName="guid" />
+
+<script setup>
+import GuidBasic from '../examples/guid/basic.vue'
+import GuidSize from '../examples/guid/size.vue'
+import guidApi from './meta/guid'
+import guidBasicCode from '../examples/guid/basic.vue?raw'
+import guidSizeCode from '../examples/guid/size.vue?raw'
+</script>