@zfqh/uniapp 0.1.1

package/docs/components/g-page-container.md

@@ -0,0 +1,170 @@
+# g-page-container 页面容器
+
+::: tip 组件名
+`g-page-container`
+
+发布路径：`@zfqh/uniapp/lib/components/g-page-container/g-page-container.vue`
+:::
+
+完整页面骨架，包含导航栏、下拉刷新、滚动区、底部栏、安全区、背景层和返回/首页按钮。
+
+## 平台兼容性
+
+| App（vue） | App（nvue） | H5 | 小程序 | Vue 2 | Vue 3 |
+| --- | --- | --- | --- | --- | --- |
+| √ | 依赖源码条件编译 | √ | √ | - | √ |
+
+## 使用前提
+
+- 已安装并注册 `@zfqh/uniapp` 插件。
+- 已按 [项目接入](./usage) 配置 easycom，或手动从构建产物导入组件。
+- 尺寸类属性通常支持数字或带单位字符串；数字值会在组件内部通过 `uni.$uv.addUnit` 转成样式单位。
+- 样式类属性中，`customStyle`、`xxxStyle` 接收对象，`customClass`、`xxxClass` 接收 class 字符串。
+
+## 基本使用
+
+```vue
+<template>
+  <g-page-container
+    show-header
+    show-extra
+    has-tabbar
+    refresh-enabled
+    :show-navbar="false"
+    :triggered="refreshing"
+    @refresh="refresh"
+    @scrollbottom="loadMore"
+  >
+    <template #extra>
+      <g-search placeholder="搜索医生、医院或疾病" @search="search" />
+    </template>
+
+    <view class="g-p-24">
+      <doctor-card v-for="doctor in doctors" :key="doctor.id" :doctor="doctor" />
+    </view>
+  </g-page-container>
+</template>
+
+<script setup>
+import { ref } from 'vue';
+
+const refreshing = ref(false);
+const doctors = ref([]);
+
+async function refresh() {
+  refreshing.value = true;
+  doctors.value = await doctorApi.list({ page: 1 });
+  refreshing.value = false;
+}
+
+function search(keyword) {
+  doctorApi.list({ keyword });
+}
+
+function loadMore() {
+  doctorApi.nextPage();
+}
+</script>
+```
+
+## API
+
+### 页面容器 Props
+
+| 属性 | 类型 | 默认值 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `triggered` | `Boolean` | `-` | 否 | 下拉刷新受控状态。 |
+| `spinnerColor` | `String` | `-` | 否 | spinner 颜色。 |
+| `title` | `[String, Boolean]` | `''` | 否 | 标题文本；传 false 时可隐藏标题内容。 |
+| `loading` | `[String, Boolean]` | `false` | 否 | 外部加载状态；组件内部也可能通过 setLoading 控制。 |
+| `refreshEnabled` | `Boolean` | `false` | 否 | 是否启用下拉刷新。 |
+| `showNavbar` | `Boolean` | `true` | 否 | 是否显示自定义导航栏。 |
+| `showHeader` | `Boolean` | `false` | 否 | 是否显示头部区域。 |
+| `showFooter` | `Boolean` | `false` | 否 | 是否显示底部区域。 |
+| `showBack` | `Boolean` | `false` | 否 | 是否显示返回按钮。 |
+| `showHome` | `Boolean` | `false` | 否 | 是否显示返回首页按钮。 |
+| `showExtra` | `Boolean` | `true` | 否 | 是否显示 extra 插槽区域。 |
+| `hasNavbar` | `Boolean` | `false` | 否 | 是否预留系统导航栏高度。 |
+| `hasTabbar` | `Boolean` | `false` | 否 | 是否预留 tabBar 底部高度。 |
+| `bgColor` | `String` | `() => color.bgColor` | 否 | 背景颜色。 |
+| `titleColor` | `String` | `'#fff'` | 否 | 标题颜色。 |
+| `titleSize` | `[String, Number]` | `18` | 否 | 标题字号。 |
+| `titleBold` | `[String, Number]` | `500` | 否 | 标题是否加粗。 |
+| `titleStyle` | `Object` | `() => ({})` | 否 | 自定义 title 区域 style 对象。 |
+| `headerStyle` | `Object` | `() => ({})` | 否 | 自定义 header 区域 style 对象。 |
+| `navbarStyle` | `Object` | `() => ({})` | 否 | 自定义 navbar 区域 style 对象。 |
+| `footerStyle` | `Object` | `() => ({})` | 否 | 自定义 footer 区域 style 对象。 |
+| `footerBorder` | `Boolean` | `true` | 否 | 底部栏是否显示上边框。 |
+| `footerShadow` | `Boolean` | `false` | 否 | 底部栏是否显示阴影。 |
+| `contentStyle` | `Object` | `() => ({})` | 否 | 自定义 content 区域 style 对象。 |
+| `customStyle` | `Object` | `() => ({})` | 否 | 最外层自定义 style 对象。 |
+| `loadingStyle` | `Object` | `() => ({})` | 否 | 自定义 loading 区域 style 对象。 |
+| `backgroundStyle` | `Object` | `() => ({})` | 否 | 自定义 background 区域 style 对象。 |
+| `leftStyle` | `Object` | `() => ({})` | 否 | 自定义 left 区域 style 对象。 |
+| `rightStyle` | `Object` | `() => ({})` | 否 | 自定义 right 区域 style 对象。 |
+| `footerSafeArea` | `Boolean` | `true` | 否 | 底部是否追加安全区高度。 |
+| `animation` | `Boolean` | `false` | 否 | 组件公开属性 animation，用于控制该组件对应的渲染、交互或业务参数。 |
+| `completeText` | `String` | `'刷新成功'` | 否 | complete 文案。 |
+| `iconColor` | `String` | `'#fff'` | 否 | icon 颜色。 |
+| `iconType` | `String` | `''` | 否 | 传给 g-icon 的图标类型，用于区分内置图标或图标库类型。 |
+| `iconFont` | `String` | `''` | 否 | 图标字体类名前缀或字体族配置。 |
+| `iconSize` | `[String, Number]` | `0` | 否 | 主图标尺寸，数字会按 uni.$uv.addUnit 转成 rpx/px。 |
+| `homeIconSize` | `[String, Number]` | `0` | 否 | 首页图标尺寸。 |
+| `iconName` | `String` | `'arrow-left'` | 否 | 主图标名称。 |
+| `homeIconName` | `String` | `'home-fill'` | 否 | 首页图标名称。 |
+| `refreshMode` | `String` | `'none'` | 否 | 组件公开属性 refreshMode，用于控制该组件对应的渲染、交互或业务参数。 |
+
+### 页面容器 Events
+
+| 事件 | 说明 |
+| --- | --- |
+| `refresh` | 下拉刷新被触发时触发。 |
+| `scroll` | 滚动时触发，透传 scroll-view 事件对象。 |
+| `scrolltop` | 滚动到顶部时触发。 |
+| `scrollbottom` | 滚动到底部时触发。 |
+
+### 页面容器 Slots
+
+| 插槽 | 说明 |
+| --- | --- |
+| `left` | 导航栏左侧区域；g-page-container 中可替换返回/首页按钮。 |
+| `title` | 标题区域。 |
+| `right` | 导航栏右侧操作区。 |
+| `extra` | 头部额外内容区，受 showExtra 控制。 |
+| `content` | 完整内容区；提供后会替代默认滚动内容包装。 |
+| `default` | 默认内容区域。 |
+| `bottom` | 内容区底部插槽，位于滚动内容之后、footer 之前。 |
+| `footer` | 底部固定栏内容。 |
+
+### 页面容器 Methods
+
+| 方法 | 说明 |
+| --- | --- |
+| `setLoading(loading)` | 切换内部 loading 状态。 |
+| `refresh()` | 触发刷新流程并向外抛出 refresh 事件。 |
+| `scroll(e)` | 组件内部公开方法 scroll(e)；通过 ref 调用前需要确认组件平台条件和当前状态。 |
+| `scrolltop()` | 组件内部公开方法 scrolltop()；通过 ref 调用前需要确认组件平台条件和当前状态。 |
+| `scrollbottom()` | 组件内部公开方法 scrollbottom()；通过 ref 调用前需要确认组件平台条件和当前状态。 |
+| `scrollTo(e)` | 滚动到指定位置或元素。 |
+| `getRect()` | 读取组件内部元素尺寸信息。 |
+
+### 页面容器 Internal State
+
+| 类型 | 名称 | 说明 |
+| --- | --- | --- |
+| computed | `systemInfo` | 内部计算属性，用于把 props、平台信息或样式配置转换为模板可用值。 |
+| computed | `topBarTitleHeight` | 内部计算属性，用于把 props、平台信息或样式配置转换为模板可用值。 |
+| computed | `hasBg` | 内部计算属性，用于把 props、平台信息或样式配置转换为模板可用值。 |
+| computed | `containerStyle` | 内部计算属性，用于把 props、平台信息或样式配置转换为模板可用值。 |
+| computed | `_titleStyle` | 内部计算属性，用于把 props、平台信息或样式配置转换为模板可用值。 |
+| computed | `_navbarStyle` | 内部计算属性，用于把 props、平台信息或样式配置转换为模板可用值。 |
+| computed | `_leftStyle` | 内部计算属性，用于把 props、平台信息或样式配置转换为模板可用值。 |
+| computed | `_loadingStyle` | 内部计算属性，用于把 props、平台信息或样式配置转换为模板可用值。 |
+| computed | `_headerStyle` | 内部计算属性，用于把 props、平台信息或样式配置转换为模板可用值。 |
+| computed | `_contentStyle` | 内部计算属性，用于把 props、平台信息或样式配置转换为模板可用值。 |
+| computed | `_footerStyle` | 内部计算属性，用于把 props、平台信息或样式配置转换为模板可用值。 |
+| data | `trigger` | 内部响应式状态，通常不建议由外部直接依赖。 |
+| data | `scroll_top` | 内部响应式状态，通常不建议由外部直接依赖。 |
+| data | `scrollTop` | 内部响应式状态，通常不建议由外部直接依赖。 |
+| data | `pulling` | 内部响应式状态，通常不建议由外部直接依赖。 |
+| data | `headerRect` | 内部响应式状态，通常不建议由外部直接依赖。 |

package/docs/components/g-permission-popup.md

@@ -0,0 +1,117 @@
+# g-permission-popup 权限弹窗
+
+::: tip 组件名
+`g-permission-popup`
+
+发布路径：`@zfqh/uniapp/lib/components/g-permission-popup/g-permission-popup.vue`
+:::
+
+权限申请辅助弹层，配合 `requestPermission` 使用。在 App 端申请权限时，顶部浮窗展示为什么需要该权限的说明文案。**上架应用市场必须包含此组件。**
+
+## 平台兼容性
+
+| App（vue） | App（nvue） | H5 | 小程序 | Vue 2 | Vue 3 |
+| --- | --- | --- | --- | --- | --- |
+| √ | 依赖源码条件编译 | - | - | - | √ |
+
+## 使用前提
+
+- 已安装并注册 `@zfqh/uniapp` 插件。
+- 已按 [项目接入](./usage) 配置 easycom，或手动从构建产物导入组件。
+
+## 工作原理
+
+当调用 `requestPermission('camera')` 时：
+
+1. 系统弹出权限申请对话框
+2. 组件监听到 `requestPermission` 事件，在页面顶部显示浮窗，展示权限用途说明
+3. 用户授权或拒绝后，浮窗自动关闭
+
+每个权限的说明文案已内置在 `@zfqh/uniapp/lib/utils/permit` 中：
+
+| 权限 | 说明文案 |
+| --- | --- |
+| `camera` | 我们需要获取您的相机权限，用于拍摄照片、录制视频、视频通话、扫码识别、发布内容等服务 |
+| `record` | 我们需要获取您的麦克风权限，用于录制语音、语音通话，发布内容等服务 |
+| `location` | 我们需要获取您的定位权限，用于城市定位、地址获取、位置获取，发现附近设备等服务 |
+| `storage` | 我们需要获取您的文件存储权限，用于设置头像、保存图片、上传文件、发布内容等服务 |
+| `bluetooth` | 我们需要获取您的蓝牙权限，用于数据传输、设备配对、发现附近设备等服务 |
+
+## 基本使用
+
+参考商户端体检、头像上传和脉诊设备连接页面的用法：先在需要申请权限的页面顶部放置弹窗，再在真实业务动作前调用 `requestPermission`。
+
+```vue
+<template>
+  <!-- #ifdef APP -->
+  <g-permission-popup v-if="showPermissionPopup" />
+  <!-- #endif -->
+
+  <view>
+    <button @click="chooseAvatar('camera')">拍照上传头像</button>
+    <button @click="chooseAvatar('album')">从相册选择</button>
+    <button @click="scanDevice">搜索蓝牙设备</button>
+  </view>
+</template>
+
+<script setup>
+import { computed } from 'vue';
+import { requestPermission } from '@zfqh/uniapp';
+import { currentLocale } from '@/locales';
+
+const showPermissionPopup = computed(() => currentLocale.value === 'zh-CN');
+
+async function chooseAvatar(sourceType) {
+  if (sourceType === 'camera') {
+    await requestPermission('camera');
+  }
+  await requestPermission('storage');
+
+  const { tempFilePaths, tempFiles } = await uni.chooseImage({
+    count: 1,
+    sourceType: [sourceType],
+    sizeType: ['compressed'],
+  });
+
+  await uploadAvatar(tempFilePaths[0], tempFiles?.[0]);
+}
+
+async function scanDevice() {
+  await requestPermission('bluetooth');
+  await requestPermission('location', false);
+
+  await searchBluetoothDevices();
+}
+
+async function uploadAvatar(path, file) {
+  // 上传图片到业务服务
+}
+
+async function searchBluetoothDevices() {
+  // 搜索并连接蓝牙设备
+}
+</script>
+```
+
+如果页面没有自定义导航栏，需要让弹窗避开系统状态栏和导航栏时，可以传入 `:has-navbar="false"`；需要调整位置或宽度时使用 `customStyle`。
+
+::: warning 注意
+`g-permission-popup` 必须放在每个需要申请权限的页面中，不能放在 App.vue 或全局布局组件中（App 和小程序不支持全局组件跨页面渲染）。
+:::
+
+## API
+
+### Props
+
+| 属性 | 类型 | 默认值 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `customStyle` | `Object` | `() => ({})` | 否 | 最外层自定义 style 对象。 |
+| `hasNavbar` | `Boolean` | `true` | 否 | 是否预留系统导航栏高度。 |
+
+### Events
+
+无显式组件事件。
+
+### Slots
+
+无显式插槽。

package/docs/components/g-polyline-chat.md

@@ -0,0 +1,102 @@
+# g-polyline-chat 折线聊天
+
+::: tip 组件名
+`g-polyline-chat`
+
+发布路径：`@zfqh/uniapp/lib/components/g-polyline-chat/g-polyline-chat.vue`
+:::
+
+柱状/折线组合趋势视图，用 bars 与 data 渲染聊天或统计类走势图。
+
+## 平台兼容性
+
+| App（vue） | App（nvue） | H5 | 小程序 | Vue 2 | Vue 3 |
+| --- | --- | --- | --- | --- | --- |
+| √ | 依赖源码条件编译 | √ | √ | - | √ |
+
+## 使用前提
+
+- 已安装并注册 `@zfqh/uniapp` 插件。
+- 已按 [项目接入](./usage) 配置 easycom，或手动从构建产物导入组件。
+- 尺寸类属性通常支持数字或带单位字符串；数字值会在组件内部通过 `uni.$uv.addUnit` 转成样式单位。
+- 样式类属性中，`customStyle`、`xxxStyle` 接收对象，`customClass`、`xxxClass` 接收 class 字符串。
+
+## 基本使用
+
+```vue
+<template>
+  <g-polyline-chat
+    :bars="pulseBars"
+    :data="pulseData"
+    :width="320"
+    :height="260"
+    main-color="#A3E5D9"
+    line-color="#39BDA7"
+  />
+</template>
+
+<script setup>
+const pulseBars = [
+  ['弦', '软'],
+  ['滑', '细'],
+  ['浮', '沉'],
+  ['数', '迟'],
+];
+
+const pulseData = {
+  title: '左手寸脉',
+  color: '#39BDA7',
+  data: [42, 64, 58, 76],
+};
+</script>
+```
+
+## API
+
+### 折线聊天 Props
+
+| 属性 | 类型 | 默认值 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `bars` | `Array` | `() => [ ['弦', '软'], ['滑', '细'], ['浮', '沉'], ['数', '迟'], ]` | 否 | 组件公开属性 bars，用于控制该组件对应的渲染、交互或业务参数。 |
+| `mainColor` | `String` | `'#A3E5D9'` | 否 | main 颜色。 |
+| `bgColor` | `String` | `'#F7F3E9'` | 否 | 背景颜色。 |
+| `lineColor` | `String` | `'#B8EAE2'` | 否 | line 颜色。 |
+| `border` | `[String, Boolean]` | `false` | 否 | 是否显示边框。 |
+| `borderColor` | `String` | `'transparent'` | 否 | border 颜色。 |
+| `borderWidth` | `[String, Number]` | `1` | 否 | 组件公开属性 borderWidth，用于控制该组件对应的渲染、交互或业务参数。 |
+| `textColor` | `String` | `'#333'` | 否 | text 颜色。 |
+| `textSize` | `Number` | `18` | 否 | text 尺寸。 |
+| `data` | `[Array, Object]` | `() => ({ title: '', color: '', data: [], })` | 否 | 组件渲染或业务计算使用的数据源。 |
+| `height` | `Number` | `300` | 否 | 高度。 |
+| `width` | `Number` | `300` | 否 | 宽度。 |
+| `space` | `Number` | `16` | 否 | 组件公开属性 space，用于控制该组件对应的渲染、交互或业务参数。 |
+
+### 折线聊天 Events
+
+无显式组件事件。
+
+### 折线聊天 Slots
+
+无显式插槽。
+
+### 折线聊天 Methods
+
+无 Options API methods。
+
+### 折线聊天 Internal State
+
+| 类型 | 名称 | 说明 |
+| --- | --- | --- |
+| computed | `step` | 内部计算属性，用于把 props、平台信息或样式配置转换为模板可用值。 |
+| computed | `list` | 内部计算属性，用于把 props、平台信息或样式配置转换为模板可用值。 |
+| computed | `style` | 内部计算属性，用于把 props、平台信息或样式配置转换为模板可用值。 |
+| computed | `barWidth` | 内部计算属性，用于把 props、平台信息或样式配置转换为模板可用值。 |
+| computed | `wrapStyle` | 内部计算属性，用于把 props、平台信息或样式配置转换为模板可用值。 |
+| computed | `innerStyle` | 内部计算属性，用于把 props、平台信息或样式配置转换为模板可用值。 |
+| computed | `barStyle` | 内部计算属性，用于把 props、平台信息或样式配置转换为模板可用值。 |
+| computed | `mainStyle` | 内部计算属性，用于把 props、平台信息或样式配置转换为模板可用值。 |
+| computed | `lineStyle` | 内部计算属性，用于把 props、平台信息或样式配置转换为模板可用值。 |
+| computed | `textStyle` | 内部计算属性，用于把 props、平台信息或样式配置转换为模板可用值。 |
+| data | `id` | 内部响应式状态，通常不建议由外部直接依赖。 |
+| data | `realWidth` | 内部响应式状态，通常不建议由外部直接依赖。 |
+| data | `value` | 内部响应式状态，通常不建议由外部直接依赖。 |

package/docs/components/g-polyline-view.md

@@ -0,0 +1,67 @@
+# g-polyline-view 折线展示
+
+::: tip 组件名
+`g-polyline-view`
+
+发布路径：`@zfqh/uniapp/lib/components/g-polyline-view/g-polyline-view.vue`
+:::
+
+简单折线段渲染组件，根据数据点生成多段连线。
+
+## 平台兼容性
+
+| App（vue） | App（nvue） | H5 | 小程序 | Vue 2 | Vue 3 |
+| --- | --- | --- | --- | --- | --- |
+| √ | 依赖源码条件编译 | √ | √ | - | √ |
+
+## 使用前提
+
+- 已安装并注册 `@zfqh/uniapp` 插件。
+- 已按 [项目接入](./usage) 配置 easycom，或手动从构建产物导入组件。
+- 尺寸类属性通常支持数字或带单位字符串；数字值会在组件内部通过 `uni.$uv.addUnit` 转成样式单位。
+- 样式类属性中，`customStyle`、`xxxStyle` 接收对象，`customClass`、`xxxClass` 接收 class 字符串。
+
+## 基本使用
+
+```vue
+<template>
+  <view class="trend-card">
+    <g-polyline-view :data="points" color="#39BDA7" :start-left="12" :end-left="72" />
+  </view>
+</template>
+
+<script setup>
+const points = [12, 38, 26, 56, 42, 68];
+</script>
+```
+
+## API
+
+### 折线展示 Props
+
+| 属性 | 类型 | 默认值 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `data` | `Array` | `() => []` | 否 | 组件渲染或业务计算使用的数据源。 |
+| `color` | `String` | `''` | 否 | 文字或图标主色。 |
+| `startLeft` | `Number` | `0` | 否 | 组件公开属性 startLeft，用于控制该组件对应的渲染、交互或业务参数。 |
+| `endLeft` | `Number` | `0` | 否 | 组件公开属性 endLeft，用于控制该组件对应的渲染、交互或业务参数。 |
+
+### 折线展示 Events
+
+无显式组件事件。
+
+### 折线展示 Slots
+
+无显式插槽。
+
+### 折线展示 Methods
+
+无 Options API methods。
+
+### 折线展示 Internal State
+
+| 类型 | 名称 | 说明 |
+| --- | --- | --- |
+| computed | `list` | 内部计算属性，用于把 props、平台信息或样式配置转换为模板可用值。 |
+| computed | `colors` | 内部计算属性，用于把 props、平台信息或样式配置转换为模板可用值。 |
+| computed | `lineStyle` | 内部计算属性，用于把 props、平台信息或样式配置转换为模板可用值。 |

package/docs/components/g-popup.md

@@ -0,0 +1,144 @@
+# g-popup 业务弹窗
+
+::: tip 组件名
+`g-popup`
+
+发布路径：`@zfqh/uniapp/lib/components/g-popup/g-popup.vue`
+:::
+
+通用弹窗，封装 uv-popup 的标题、内容、底部按钮、关闭、确认和样式配置。
+
+## 平台兼容性
+
+| App（vue） | App（nvue） | H5 | 小程序 | Vue 2 | Vue 3 |
+| --- | --- | --- | --- | --- | --- |
+| √ | 依赖源码条件编译 | √ | √ | - | √ |
+
+## 使用前提
+
+- 已安装并注册 `@zfqh/uniapp` 插件。
+- 已按 [项目接入](./usage) 配置 easycom，或手动从构建产物导入组件。
+- 尺寸类属性通常支持数字或带单位字符串；数字值会在组件内部通过 `uni.$uv.addUnit` 转成样式单位。
+- 样式类属性中，`customStyle`、`xxxStyle` 接收对象，`customClass`、`xxxClass` 接收 class 字符串。
+
+## 基本使用
+
+```vue
+<template>
+  <uv-button type="primary" text="清空消息" @click="popupRef?.open()" />
+
+  <g-popup
+    ref="popupRef"
+    title="确认清空"
+    content="清空后消息列表不可恢复，是否继续？"
+    confirm-text="清空"
+    :close-on-click-overlay="false"
+    @confirm="clearMessages"
+  />
+</template>
+
+<script setup>
+import { ref } from 'vue';
+
+const popupRef = ref(null);
+
+function clearMessages() {
+  messageApi.clear();
+}
+</script>
+```
+
+## API
+
+### 业务弹窗 Props
+
+| 属性 | 类型 | 默认值 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `size` | `String` | `'normal'` | 否 | 组件尺寸。 |
+| `content` | `String` | `''` | 否 | 组件公开属性 content，用于控制该组件对应的渲染、交互或业务参数。 |
+| `showHeader` | `Boolean` | `true` | 否 | 是否显示头部区域。 |
+| `showTitle` | `Boolean` | `true` | 否 | 是否显示 Title 区域或能力。 |
+| `showContent` | `Boolean` | `true` | 否 | 是否显示 Content 区域或能力。 |
+| `showFooter` | `Boolean` | `true` | 否 | 是否显示底部区域。 |
+| `showCancel` | `Boolean` | `true` | 否 | 是否显示 Cancel 区域或能力。 |
+| `showConfirm` | `Boolean` | `true` | 否 | 是否显示 Confirm 区域或能力。 |
+| `title` | `String` | `'提示'` | 否 | 标题文本；传 false 时可隐藏标题内容。 |
+| `titleAlign` | `String` | `'center'` | 否 | 组件公开属性 titleAlign，用于控制该组件对应的渲染、交互或业务参数。 |
+| `titleBorder` | `Boolean` | `false` | 否 | 组件公开属性 titleBorder，用于控制该组件对应的渲染、交互或业务参数。 |
+| `titleBold` | `Boolean` | `true` | 否 | 标题是否加粗。 |
+| `align` | `String` | `'left'` | 否 | 组件公开属性 align，用于控制该组件对应的渲染、交互或业务参数。 |
+| `width` | `[String, Number]` | `325` | 否 | 宽度。 |
+| `duration` | `[String, Number]` | `300` | 否 | 动画或显示持续时间，单位通常为毫秒。 |
+| `round` | `[Number, String]` | `8` | 否 | 组件公开属性 round，用于控制该组件对应的渲染、交互或业务参数。 |
+| `zoom` | `Boolean` | `true` | 否 | 组件公开属性 zoom，用于控制该组件对应的渲染、交互或业务参数。 |
+| `bgColor` | `String` | `'#fff'` | 否 | 背景颜色。 |
+| `closeOnClickOverlay` | `Boolean` | `true` | 否 | 点击遮罩时是否关闭。 |
+| `overlayOpacity` | `[Number, String]` | `0.5` | 否 | 组件公开属性 overlayOpacity，用于控制该组件对应的渲染、交互或业务参数。 |
+| `overlay` | `Boolean` | `true` | 否 | 组件公开属性 overlay，用于控制该组件对应的渲染、交互或业务参数。 |
+| `closeIconPos` | `String` | `'top-right'` | 否 | 组件公开属性 closeIconPos，用于控制该组件对应的渲染、交互或业务参数。 |
+| `zIndex` | `[Number, String]` | `10075` | 否 | 层级。 |
+| `mode` | `String` | `'center'` | 否 | 组件模式，不同组件含义不同；例如 popup 方位、tag-editor 编辑模式、refresh-view 刷新模式。 |
+| `cancelText` | `[String, Boolean]` | `'取 消'` | 否 | 取消按钮文案。 |
+| `confirmText` | `[String, Boolean]` | `'确 定'` | 否 | 确认按钮文案。 |
+| `closeable` | `Boolean` | `true` | 否 | 是否显示关闭按钮。 |
+| `safeAreaInsetBottom` | `Boolean` | `true` | 否 | 组件公开属性 safeAreaInsetBottom，用于控制该组件对应的渲染、交互或业务参数。 |
+| `headerBorder` | `Boolean` | `false` | 否 | 组件公开属性 headerBorder，用于控制该组件对应的渲染、交互或业务参数。 |
+| `footerBorder` | `Boolean` | `false` | 否 | 底部栏是否显示上边框。 |
+| `closeOnConfirm` | `Boolean` | `true` | 否 | 点击确认按钮后是否自动关闭。 |
+| `closeOnCancel` | `Boolean` | `true` | 否 | 点击取消按钮后是否自动关闭。 |
+| `cancelProps` | `Object` | `() => ({})` | 否 | 组件公开属性 cancelProps，用于控制该组件对应的渲染、交互或业务参数。 |
+| `confirmProps` | `Object` | `() => ({})` | 否 | 组件公开属性 confirmProps，用于控制该组件对应的渲染、交互或业务参数。 |
+| `buttonProps` | `Object` | `() => ({})` | 否 | 组件公开属性 buttonProps，用于控制该组件对应的渲染、交互或业务参数。 |
+| `headerStyle` | `Object` | `() => ({})` | 否 | 自定义 header 区域 style 对象。 |
+| `titleStyle` | `Object` | `() => ({})` | 否 | 自定义 title 区域 style 对象。 |
+| `footerStyle` | `Object` | `() => ({})` | 否 | 自定义 footer 区域 style 对象。 |
+| `scrollStyle` | `Object` | `() => ({})` | 否 | 自定义 scroll 区域 style 对象。 |
+| `contentStyle` | `Object` | `() => ({})` | 否 | 自定义 content 区域 style 对象。 |
+| `customStyle` | `Object` | `() => ({})` | 否 | 最外层自定义 style 对象。 |
+| `overlayStyle` | `Object` | `() => ({})` | 否 | 自定义 overlay 区域 style 对象。 |
+
+### 业务弹窗 Events
+
+| 事件 | 说明 |
+| --- | --- |
+| `change` | 值或状态变化时触发。 |
+| `cancel` | 点击取消按钮或执行取消动作时触发。 |
+| `confirm` | 点击确认按钮或执行确认动作时触发。 |
+
+### 业务弹窗 Slots
+
+| 插槽 | 说明 |
+| --- | --- |
+| `header` | 弹窗头部区域。 |
+| `content` | 完整内容区；提供后会替代默认滚动内容包装。 |
+| `default` | 默认内容区域。 |
+| `footer` | 底部固定栏内容。 |
+
+### 业务弹窗 Methods
+
+| 方法 | 说明 |
+| --- | --- |
+| `change(e)` | 处理变更事件并同步内部状态。 |
+| `close()` | 关闭组件或弹层。 |
+| `open(opts = {})` | 打开组件或弹层；部分组件支持传入选项覆盖当前展示内容。 |
+| `cancel()` | 组件内部公开方法 cancel()；通过 ref 调用前需要确认组件平台条件和当前状态。 |
+| `confirm()` | 组件内部公开方法 confirm()；通过 ref 调用前需要确认组件平台条件和当前状态。 |
+
+### 业务弹窗 Internal State
+
+| 类型 | 名称 | 说明 |
+| --- | --- | --- |
+| computed | `style` | 内部计算属性，用于把 props、平台信息或样式配置转换为模板可用值。 |
+| computed | `options` | 内部计算属性，用于把 props、平台信息或样式配置转换为模板可用值。 |
+| computed | `_headerStyle` | 内部计算属性，用于把 props、平台信息或样式配置转换为模板可用值。 |
+| computed | `_titleStyle` | 内部计算属性，用于把 props、平台信息或样式配置转换为模板可用值。 |
+| computed | `_footerStyle` | 内部计算属性，用于把 props、平台信息或样式配置转换为模板可用值。 |
+| computed | `_contentStyle` | 内部计算属性，用于把 props、平台信息或样式配置转换为模板可用值。 |
+| computed | `_scrollStyle` | 内部计算属性，用于把 props、平台信息或样式配置转换为模板可用值。 |
+| computed | `_cancelProps` | 内部计算属性，用于把 props、平台信息或样式配置转换为模板可用值。 |
+| computed | `_confirmProps` | 内部计算属性，用于把 props、平台信息或样式配置转换为模板可用值。 |
+| computed | `_customStyle` | 内部计算属性，用于把 props、平台信息或样式配置转换为模板可用值。 |
+| data | `opts` | 内部响应式状态，通常不建议由外部直接依赖。 |
+| data | `visible` | 内部响应式状态，通常不建议由外部直接依赖。 |
+| data | `resolve` | 内部响应式状态，通常不建议由外部直接依赖。 |
+| data | `reject` | 内部响应式状态，通常不建议由外部直接依赖。 |