@zfqh/uniapp 0.1.1

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

@@ -0,0 +1,118 @@
+# g-refresh-view 下拉刷新容器
+
+::: tip 组件名
+`g-refresh-view`
+
+发布路径：`@zfqh/uniapp/lib/components/g-refresh-view/g-refresh-view.vue`
+:::
+
+滚动刷新容器，封装 scroll-view refresher，并统一下拉状态事件。
+
+## 平台兼容性
+
+| App（vue） | App（nvue） | H5 | 小程序 | Vue 2 | Vue 3 |
+| --- | --- | --- | --- | --- | --- |
+| √ | 依赖源码条件编译 | √ | √ | - | √ |
+
+## 使用前提
+
+- 已安装并注册 `@zfqh/uniapp` 插件。
+- 已按 [项目接入](./usage) 配置 easycom，或手动从构建产物导入组件。
+- 尺寸类属性通常支持数字或带单位字符串；数字值会在组件内部通过 `uni.$uv.addUnit` 转成样式单位。
+- 样式类属性中，`customStyle`、`xxxStyle` 接收对象，`customClass`、`xxxClass` 接收 class 字符串。
+
+## 基本使用
+
+```vue
+<template>
+  <g-refresh-view
+    :triggered="refreshing"
+    height="100vh"
+    enabled
+    @refresh="reload"
+    @scrollbottom="loadMore"
+  >
+    <goods-card v-for="item in list" :key="item.id" :data="item" />
+  </g-refresh-view>
+</template>
+
+<script setup>
+import { ref } from 'vue';
+
+const refreshing = ref(false);
+const list = ref([]);
+
+async function reload() {
+  refreshing.value = true;
+  list.value = await goodsApi.page({ page: 1 });
+  refreshing.value = false;
+}
+
+function loadMore() {
+  goodsApi.nextPage();
+}
+</script>
+```
+
+## API
+
+### 下拉刷新容器 Props
+
+| 属性 | 类型 | 默认值 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `enabled` | `Boolean` | `true` | 否 | 是否启用 scroll-view refresher。 |
+| `triggered` | `Boolean` | `false` | 否 | 下拉刷新受控状态。 |
+| `completeText` | `String` | `'刷新成功'` | 否 | complete 文案。 |
+| `loadingStyle` | `Object` | `() => ({})` | 否 | 自定义 loading 区域 style 对象。 |
+| `mode` | `String` | `'none'` | 否 | 组件模式，不同组件含义不同；例如 popup 方位、tag-editor 编辑模式、refresh-view 刷新模式。 |
+| `height` | `String` | `'100%'` | 否 | 高度。 |
+| `scrollTop` | `Number` | `0` | 否 | 组件公开属性 scrollTop，用于控制该组件对应的渲染、交互或业务参数。 |
+| `threshold` | `Number` | `40` | 否 | 组件公开属性 threshold，用于控制该组件对应的渲染、交互或业务参数。 |
+| `background` | `String` | `'transparent'` | 否 | 组件公开属性 background，用于控制该组件对应的渲染、交互或业务参数。 |
+| `spinnerColor` | `String` | `''` | 否 | spinner 颜色。 |
+| `animation` | `Boolean` | `false` | 否 | 组件公开属性 animation，用于控制该组件对应的渲染、交互或业务参数。 |
+
+### 下拉刷新容器 Events
+
+| 事件 | 说明 |
+| --- | --- |
+| `pulling` | 下拉刷新拖拽过程中触发。 |
+| `refresh` | 下拉刷新被触发时触发。 |
+| `restore` | 下拉刷新复位时触发。 |
+| `abort` | 下拉刷新被中止时触发。 |
+| `scroll` | 滚动时触发，透传 scroll-view 事件对象。 |
+| `scrolltop` | 滚动到顶部时触发。 |
+| `scrollbottom` | 滚动到底部时触发。 |
+
+### 下拉刷新容器 Slots
+
+| 插槽 | 说明 |
+| --- | --- |
+| `refresher` | 自定义下拉刷新区域。 |
+| `completeText` | 刷新完成文案区域。 |
+| `spinner` | 刷新中 loading 区域。 |
+| `default` | 默认内容区域。 |
+
+### 下拉刷新容器 Methods
+
+| 方法 | 说明 |
+| --- | --- |
+| `refresherpulling(e)` | 组件内部公开方法 refresherpulling(e)；通过 ref 调用前需要确认组件平台条件和当前状态。 |
+| `refresherrefresh(e)` | 组件内部公开方法 refresherrefresh(e)；通过 ref 调用前需要确认组件平台条件和当前状态。 |
+| `refresherrestore(e)` | 组件内部公开方法 refresherrestore(e)；通过 ref 调用前需要确认组件平台条件和当前状态。 |
+| `refresherabort(e)` | 组件内部公开方法 refresherabort(e)；通过 ref 调用前需要确认组件平台条件和当前状态。 |
+| `scroll(e)` | 组件内部公开方法 scroll(e)；通过 ref 调用前需要确认组件平台条件和当前状态。 |
+| `scrolltoupper()` | 组件内部公开方法 scrolltoupper()；通过 ref 调用前需要确认组件平台条件和当前状态。 |
+| `scrolltolower()` | 组件内部公开方法 scrolltolower()；通过 ref 调用前需要确认组件平台条件和当前状态。 |
+
+### 下拉刷新容器 Internal State
+
+| 类型 | 名称 | 说明 |
+| --- | --- | --- |
+| computed | `spinnerStyle` | 内部计算属性，用于把 props、平台信息或样式配置转换为模板可用值。 |
+| computed | `_loadingStyle` | 内部计算属性，用于把 props、平台信息或样式配置转换为模板可用值。 |
+| computed | `refresherBackground` | 内部计算属性，用于把 props、平台信息或样式配置转换为模板可用值。 |
+| data | `refreshing` | 内部响应式状态，通常不建议由外部直接依赖。 |
+| data | `completed` | 内部响应式状态，通常不建议由外部直接依赖。 |
+| data | `pulling` | 内部响应式状态，通常不建议由外部直接依赖。 |
+| data | `opacity` | 内部响应式状态，通常不建议由外部直接依赖。 |

package/docs/components/g-render-image.md

@@ -0,0 +1,83 @@
+# g-render-image 图片渲染
+
+::: tip 组件名
+`g-render-image`
+
+发布路径：`@zfqh/uniapp/lib/components/g-render-image/g-render-image.vue`
+:::
+
+把页面 DOM/插槽内容渲染成图片并保存或返回路径的分享海报辅助组件。
+
+## 平台兼容性
+
+| App（vue） | App（nvue） | H5 | 小程序 | Vue 2 | Vue 3 |
+| --- | --- | --- | --- | --- | --- |
+| √ | 依赖源码条件编译 | √ | √ | - | √ |
+
+## 使用前提
+
+- 已安装并注册 `@zfqh/uniapp` 插件。
+- 已按 [项目接入](./usage) 配置 easycom，或手动从构建产物导入组件。
+- 尺寸类属性通常支持数字或带单位字符串；数字值会在组件内部通过 `uni.$uv.addUnit` 转成样式单位。
+- 样式类属性中，`customStyle`、`xxxStyle` 接收对象，`customClass`、`xxxClass` 接收 class 字符串。
+
+## 基本使用
+
+```vue
+<template>
+  <g-render-image ref="renderRef" dom-id="goodsPoster" name="goods-poster" :content-style="{ borderRadius: '12rpx' }">
+    <view id="goodsPoster" class="poster-card">
+      <image :src="goods.cover" mode="aspectFill" />
+      <view class="title">{{ goods.name }}</view>
+    </view>
+  </g-render-image>
+
+  <uv-button text="保存海报" @click="renderRef?.download()" />
+</template>
+
+<script setup>
+import { ref } from 'vue';
+
+const renderRef = ref(null);
+const goods = { name: '黄芪养生茶', cover: 'https://static.example.com/goods.png' };
+</script>
+```
+
+## API
+
+### 图片渲染 Props
+
+| 属性 | 类型 | 默认值 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `domId` | `String` | `''` | 否 | 组件公开属性 domId，用于控制该组件对应的渲染、交互或业务参数。 |
+| `name` | `String` | `''` | 否 | 组件公开属性 name，用于控制该组件对应的渲染、交互或业务参数。 |
+| `successTips` | `String` | `'已保存到相册'` | 否 | 组件公开属性 successTips，用于控制该组件对应的渲染、交互或业务参数。 |
+| `saveTips` | `String` | `'长按图片保存到相册'` | 否 | 组件公开属性 saveTips，用于控制该组件对应的渲染、交互或业务参数。 |
+| `contentStyle` | `Object` | `() => ({})` | 否 | 自定义 content 区域 style 对象。 |
+| `imageStyle` | `Object` | `() => ({})` | 否 | 自定义 image 区域 style 对象。 |
+
+### 图片渲染 Events
+
+无显式组件事件。
+
+### 图片渲染 Slots
+
+| 插槽 | 说明 |
+| --- | --- |
+| `default` | 默认内容区域。 |
+
+### 图片渲染 Methods
+
+| 方法 | 说明 |
+| --- | --- |
+| `setResolve(e)` | 组件内部公开方法 setResolve(e)；通过 ref 调用前需要确认组件平台条件和当前状态。 |
+| `setReject(e)` | 组件内部公开方法 setReject(e)；通过 ref 调用前需要确认组件平台条件和当前状态。 |
+| `getBase64()` | 组件内部公开方法 getBase64()；通过 ref 调用前需要确认组件平台条件和当前状态。 |
+| `download()` | 组件内部公开方法 download()；通过 ref 调用前需要确认组件平台条件和当前状态。 |
+
+### 图片渲染 Internal State
+
+| 类型 | 名称 | 说明 |
+| --- | --- | --- |
+
+| data | `path` | 内部响应式状态，通常不建议由外部直接依赖。 | | data | `count` | 内部响应式状态，通常不建议由外部直接依赖。 | | data | `show` | 内部响应式状态，通常不建议由外部直接依赖。 | | data | `resolve` | 内部响应式状态，通常不建议由外部直接依赖。 | | data | `reject` | 内部响应式状态，通常不建议由外部直接依赖。 |

package/docs/components/g-search.md

@@ -0,0 +1,120 @@
+# g-search 搜索栏
+
+::: tip 组件名
+`g-search`
+
+发布路径：`@zfqh/uniapp/lib/components/g-search/g-search.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-search
+    v-model="keyword"
+    height="70rpx"
+    font-size="26rpx"
+    shape="circle"
+    placeholder="请输入您要搜索的商品"
+    show-button
+    clearable
+    @search="search"
+    @clear="reset"
+  />
+</template>
+
+<script setup>
+import { ref } from 'vue';
+
+const keyword = ref('');
+
+function search(value) {
+  goodsApi.page({ keyword: value });
+}
+
+function reset() {
+  keyword.value = '';
+  goodsApi.page({ keyword: '' });
+}
+</script>
+```
+
+## API
+
+### 搜索栏 Props
+
+| 属性 | 类型 | 默认值 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `placeholder` | `String` | `-` | 否 | 输入框占位文本。 |
+| `height` | `[String, Number]` | `35` | 否 | 高度。 |
+| `customStyle` | `Object` | `() => ({})` | 否 | 最外层自定义 style 对象。 |
+| `inputStyle` | `Object` | `() => ({})` | 否 | 自定义 input 区域 style 对象。 |
+| `buttonStyle` | `Object` | `() => ({})` | 否 | 自定义 button 区域 style 对象。 |
+| `showButton` | `Boolean` | `false` | 否 | 是否显示 Button 区域或能力。 |
+| `fontSize` | `[String, Number]` | `14` | 否 | 字体大小。 |
+| `bgColor` | `String` | `'#fff'` | 否 | 背景颜色。 |
+| `lineColor` | `String` | `'#ECEDF0'` | 否 | line 颜色。 |
+| `borderColor` | `String` | `() => color.primary` | 否 | border 颜色。 |
+| `placeholderStyle` | `Object` | `() => ({})` | 否 | 自定义 placeholder 区域 style 对象。 |
+| `placeholderClass` | `String` | `''` | 否 | 自定义 placeholder 区域 class。 |
+| `border` | `[Boolean, Number]` | `true` | 否 | 是否显示边框。 |
+| `maxlength` | `[String, Number]` | `100` | 否 | 最大输入长度。 |
+| `borderRadius` | `[String, Number]` | `4` | 否 | 圆角。 |
+| `clearSize` | `[String, Number]` | `15` | 否 | clear 尺寸。 |
+| `shape` | `String` | `'square'` | 否 | 组件公开属性 shape，用于控制该组件对应的渲染、交互或业务参数。 |
+| `keywords` | `[Boolean, Array]` | `() => false` | 否 | 搜索框受控关键词。 |
+| `params` | `Object` | `() => ({})` | 否 | 拼接到跳转地址或业务请求中的 query 参数。 |
+| `autoFocus` | `Boolean` | `-` | 否 | 是否自动聚焦。 |
+| `clearable` | `Boolean` | `-` | 否 | 是否显示清空按钮。 |
+
+### 搜索栏 Events
+
+| 事件 | 说明 |
+| --- | --- |
+| `search` | 用户提交搜索时触发。 |
+| `input` | 输入内容变化时触发。 |
+| `clear` | 用户清空输入时触发。 |
+
+### 搜索栏 Slots
+
+| 插槽 | 说明 |
+| --- | --- |
+| `icon` | 搜索框左侧图标区域。 |
+| `button` | 搜索框右侧按钮区域。 |
+
+### 搜索栏 Methods
+
+| 方法 | 说明 |
+| --- | --- |
+| `setKeyword()` | 组件内部公开方法 setKeyword()；通过 ref 调用前需要确认组件平台条件和当前状态。 |
+| `change({ detail })` | 处理变更事件并同步内部状态。 |
+| `click()` | 处理点击逻辑；可能触发跳转、自定义函数或对外事件。 |
+| `search()` | 提交搜索关键词。 |
+| `input()` | 同步输入框内容并抛出 input。 |
+| `clear()` | 清空内部数据或输入值。 |
+
+### 搜索栏 Internal State
+
+| 类型 | 名称 | 说明 |
+| --- | --- | --- |
+| computed | `style` | 内部计算属性，用于把 props、平台信息或样式配置转换为模板可用值。 |
+| computed | `closeStyle` | 内部计算属性，用于把 props、平台信息或样式配置转换为模板可用值。 |
+| computed | `_placeholderStyle` | 内部计算属性，用于把 props、平台信息或样式配置转换为模板可用值。 |
+| computed | `inputPlaceholderStyle` | 内部计算属性，用于把 props、平台信息或样式配置转换为模板可用值。 |
+| computed | `_inputStyle` | 内部计算属性，用于把 props、平台信息或样式配置转换为模板可用值。 |
+| data | `current` | 内部响应式状态，通常不建议由外部直接依赖。 |

package/docs/components/g-share-photo.md

@@ -0,0 +1,77 @@
+# g-share-photo 分享图片
+
+::: tip 组件名
+`g-share-photo`
+
+发布路径：`@zfqh/uniapp/lib/components/g-share-photo/g-share-photo.vue`
+:::
+
+保存图片到相册的分享入口，可走默认保存流程或 custom 自定义逻辑。
+
+## 平台兼容性
+
+| App（vue） | App（nvue） | H5 | 小程序 | Vue 2 | Vue 3 |
+| --- | --- | --- | --- | --- | --- |
+| √ | 依赖源码条件编译 | √ | √ | - | √ |
+
+## 使用前提
+
+- 已安装并注册 `@zfqh/uniapp` 插件。
+- 已按 [项目接入](./usage) 配置 easycom，或手动从构建产物导入组件。
+- 尺寸类属性通常支持数字或带单位字符串；数字值会在组件内部通过 `uni.$uv.addUnit` 转成样式单位。
+- 样式类属性中，`customStyle`、`xxxStyle` 接收对象，`customClass`、`xxxClass` 接收 class 字符串。
+
+## 基本使用
+
+```vue
+<template>
+  <g-share-photo color="#fff" text="保存海报" :data="poster" @confirm="downloadPoster" />
+</template>
+
+<script setup>
+const poster = { url: 'https://static.example.com/poster.png', name: 'goods-poster' };
+
+function downloadPoster(data) {
+  uni.saveImageToPhotosAlbum({ filePath: data.url });
+}
+</script>
+```
+
+## API
+
+### 分享图片 Props
+
+| 属性 | 类型 | 默认值 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `size` | `[Number, String]` | `40` | 否 | 组件尺寸。 |
+| `url` | `String` | `'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAFAAAABQCAMAAAC5zwKfAAAAe1BMVEVHcEz29vb29vb39/f39/f29vb29vb39/f29vb29vb29vb29vb29vb39/f29vb39/f29vb39/f6+vn49/f29vbw8PDp6ezb3eTQ0dO5xeGusLOZsOqjpKigoKSNj5Vmi+ODhYqAgoh9f4R3eX9zdXxvcXhEcd5rbXQaUdgrKM5JAAAAEnRSTlMABxMjOFVkdY2epaqwxdPc7feYI9LvAAAC+UlEQVR42rWZ23arIBCGVYwxadABBhNzbk7m/Z9wb7pXSrtABrvp34t69a2PkMDMmIWSF6ys6iVvAQRA2/BlXZWsyLOfpWCz+oOFnzFYXs9YMZ2Ws9miNSw3AtrFjOUTcXNuaT4mn7N8Cq4BJAJNNLKoOGBEgFdFjF65BIwMLMuc1msERkc0lCSrAScFahbilSuBEyNWZYDHBU6O4OU4D38UXhK8BETLS0dkxH4QO+PsdVETPIJYF995eQXoRMmxKPf7WOXfgGWDnnRj0eikKb8teClcP90fzyPZr91FL4vwghVu3oex3PZahhbNOHoEt/fh7s8wHDsHiJx9Cs7BD7wf9r4czl4gzF+KrEE/8LrRvnSHuw+IDXMEHaCUyvmTem+BPkXGcRSICp1IbQ29n+IMpgHVKBBmRrFYiFSGYlGYFbcYA1SKNsSWZVk+A0xgaNdc1CIGuN71WpGG5tBhHGmg0rvno5Okodnnso0ASgsMGmJbZhXEA2lDqLIaUhpCnb2JlIbiLeOY0hB51mJKQ2wzSGsIMUCpXkApKUPIBA3U+gXUmjIUEYbr007jB9A8KZT/BzS/uufuw3D9MNQgUEHWRhg+n33/fPSPv//pz7AhgcoQT8+H4ZG73MZ8saUhmvRI7jKP+empf8SH4RGG4i3qcFCyOz1OPSr6tKmjji8D6TpUEadNFXfAGknzRBq2JX0FOAkZckZfUk5k8JIirlEplROp94FrNHzR92tvAhd9sBS5DdfLK9erfb7chlApYtfsAm3u19vwJaFiye6zC/wsga/bzeZoS+QhWM7lc6CAt20n1fo8DKEa29bErKGAZrtldxyGoGHDbNFOAO+HDvXm4hg6grFtxXA79FvDC7cVROPTX4cvMZhXjLGv8SFas277pTV7v7yfbQ4bX2tGNY9Kd6MhmsfJ7a1UoQWnb8DTjwjSDzHSj1nsYCnxaEmk4VniCnBiYFWmHvelHkimH5mmH+qmHzunH4ynH93//ssF+vWHYcW8/vgDsk2pVS+emuAAAAAASUVORK5CYII='` | 否 | 目标地址或图片地址，具体含义取决于组件。 |
+| `text` | `String` | `'保存图片'` | 否 | 组件公开属性 text，用于控制该组件对应的渲染、交互或业务参数。 |
+| `fontSize` | `[Number, String]` | `13` | 否 | 字体大小。 |
+| `color` | `String` | `''` | 否 | 文字或图标主色。 |
+| `space` | `[Number, String]` | `4` | 否 | 组件公开属性 space，用于控制该组件对应的渲染、交互或业务参数。 |
+| `data` | `Object` | `() => ({})` | 否 | 组件渲染或业务计算使用的数据源。 |
+| `custom` | `Function` | `null` | 否 | 自定义处理函数；存在时组件会优先调用它接管默认动作。 |
+| `customStyle` | `Object` | `() => ({})` | 否 | 最外层自定义 style 对象。 |
+
+### 分享图片 Events
+
+| 事件 | 说明 |
+| --- | --- |
+| `confirm` | 点击确认按钮或执行确认动作时触发。 |
+
+### 分享图片 Slots
+
+无显式插槽。
+
+### 分享图片 Methods
+
+| 方法 | 说明 |
+| --- | --- |
+| `click()` | 处理点击逻辑；可能触发跳转、自定义函数或对外事件。 |
+
+### 分享图片 Internal State
+
+| 类型 | 名称 | 说明 |
+| --- | --- | --- |
+| computed | `style` | 内部计算属性，用于把 props、平台信息或样式配置转换为模板可用值。 |
+| computed | `textStyle` | 内部计算属性，用于把 props、平台信息或样式配置转换为模板可用值。 |

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

@@ -0,0 +1,83 @@
+# g-share-view 分享视图
+
+::: tip 组件名
+`g-share-view`
+
+发布路径：`@zfqh/uniapp/lib/components/g-share-view/g-share-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 id="shareCover" class="share-cover">{{ title }}</view>
+
+  <g-share-view dom-id="shareCover" :buttons="shareButtons" :custom-style="{ padding: '24rpx' }" />
+</template>
+
+<script setup>
+const title = '中医体质分析报告';
+const shareButtons = [
+  { type: 'photo', text: '保存图片' },
+  { type: 'weixin', text: '微信好友' },
+];
+</script>
+```
+
+## API
+
+### 分享视图 Props
+
+| 属性 | 类型 | 默认值 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `domId` | `String` | `''` | 否 | 组件公开属性 domId，用于控制该组件对应的渲染、交互或业务参数。 |
+| `title` | `[String, Boolean]` | `'分享至：'` | 否 | 标题文本；传 false 时可隐藏标题内容。 |
+| `successTips` | `String` | `'已保存到相册'` | 否 | 组件公开属性 successTips，用于控制该组件对应的渲染、交互或业务参数。 |
+| `saveTips` | `String` | `'长按图片保存到相册'` | 否 | 组件公开属性 saveTips，用于控制该组件对应的渲染、交互或业务参数。 |
+| `shareTips` | `String` | `'点击分享至微信'` | 否 | 组件公开属性 shareTips，用于控制该组件对应的渲染、交互或业务参数。 |
+| `titleSize` | `[String, Number]` | `14` | 否 | 标题字号。 |
+| `titleColor` | `String` | `''` | 否 | 标题颜色。 |
+| `gutter` | `[String, Number]` | `20` | 否 | 间距。 |
+| `customStyle` | `Object` | `() => ({})` | 否 | 最外层自定义 style 对象。 |
+| `buttons` | `Array` | `() => [ { type: 'photo', }, { type: 'weixin', }, ]` | 否 | 组件公开属性 buttons，用于控制该组件对应的渲染、交互或业务参数。 |
+
+### 分享视图 Events
+
+无显式组件事件。
+
+### 分享视图 Slots
+
+无显式插槽。
+
+### 分享视图 Methods
+
+| 方法 | 说明 |
+| --- | --- |
+| `click(data)` | 处理点击逻辑；可能触发跳转、自定义函数或对外事件。 |
+
+### 分享视图 Internal State
+
+| 类型 | 名称 | 说明 |
+| --- | --- | --- |
+| computed | `hasPhoto` | 内部计算属性，用于把 props、平台信息或样式配置转换为模板可用值。 |
+| computed | `hasWeixin` | 内部计算属性，用于把 props、平台信息或样式配置转换为模板可用值。 |
+| computed | `guideStyle` | 内部计算属性，用于把 props、平台信息或样式配置转换为模板可用值。 |
+| computed | `titleStyle` | 内部计算属性，用于把 props、平台信息或样式配置转换为模板可用值。 |
+| computed | `itemStyle` | 内部计算属性，用于把 props、平台信息或样式配置转换为模板可用值。 |
+| data | `arrow` | 内部响应式状态，通常不建议由外部直接依赖。 |
+| data | `show` | 内部响应式状态，通常不建议由外部直接依赖。 |

package/docs/components/g-share-weixin.md

@@ -0,0 +1,81 @@
+# g-share-weixin 微信分享
+
+::: tip 组件名
+`g-share-weixin`
+
+发布路径：`@zfqh/uniapp/lib/components/g-share-weixin/g-share-weixin.vue`
+:::
+
+微信分享入口，适配 App/WebView 场景并通过 confirm 事件回传分享数据。
+
+## 平台兼容性
+
+| App（vue） | App（nvue） | H5 | 小程序 | Vue 2 | Vue 3 |
+| --- | --- | --- | --- | --- | --- |
+| √ | 依赖源码条件编译 | √ | √ | - | √ |
+
+## 使用前提
+
+- 已安装并注册 `@zfqh/uniapp` 插件。
+- 已按 [项目接入](./usage) 配置 easycom，或手动从构建产物导入组件。
+- 尺寸类属性通常支持数字或带单位字符串；数字值会在组件内部通过 `uni.$uv.addUnit` 转成样式单位。
+- 样式类属性中，`customStyle`、`xxxStyle` 接收对象，`customClass`、`xxxClass` 接收 class 字符串。
+
+## 基本使用
+
+```vue
+<template>
+  <g-share-weixin text="微信好友" color="#333" :data="shareData" @confirm="shareToWeixin" />
+</template>
+
+<script setup>
+const shareData = {
+  title: '黄芪养生茶',
+  path: '/pages/goods/goodsDetail/goodsDetail?id=1001',
+  imageUrl: 'https://static.example.com/share.png',
+};
+
+function shareToWeixin(data) {
+  uni.share({ provider: 'weixin', scene: 'WXSceneSession', type: 0, ...data });
+}
+</script>
+```
+
+## API
+
+### 微信分享 Props
+
+| 属性 | 类型 | 默认值 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `size` | `[Number, String]` | `40` | 否 | 组件尺寸。 |
+| `url` | `String` | `'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAFAAAABQCAMAAAC5zwKfAAAATlBMVEVHcEz19fX39/f39/f29vb39/f29vb29vb39/f39/f39/f29vb39/f39/f6+Pr29vbk8uTQ7dC66LqZ4Jhv1W5OzU0wxS4YvxYIuwYFugSG7RHKAAAADnRSTlMAECM5WG2NpLbI2+rx+KBF4WsAAAO2SURBVHjaxZnrcoMgEIWNGg0i95u8/4sWUMPUJV5qZnp+WWfy9eyyuyJWu3rUTdv1aMAjGfEwoL5rm/pRnRSktd0rstgiwsaAfXVtYl6n9QHGCgrQHjAPcU+ESWZAJnpeQQYc8AaYAXnWXsYdIU+ZbHrMTgr3zQl7A2GnRYYjk3WH2SXhrt7lvQi7KPLaCbtBhF0WQc1nHvuTUHOXB4l3eTDqm+sBV6YG9dcRdkOk29bjE7Nbws9NAgd2T2RofgXcE3aX2D9OBExXXQy6RkVa5PAkxk4wUZ0nzFjCMS6U0sYYrZXk/JA5Ph87BgNOaevcFOWcs1pydkAc6mwQ2OPKuMkHTT4pUI3ilJ6xWCPIE9pFSlb8y2lBz2SxxSBcaaeMy8zJyN2wcVusQUqljTifPb6Dt5LSo1qsQZOIhefc5BfeNF/7yQq6vywwYsrN8luttPMzzyi13DWc7sUMxwxlKlG8U5yJlSKi7+U2o7tDp0bAoE+/tJxGeAJqRpf7Pt7fW2c4Z2RgbB1aGe5bH3RgcWi2c4HyNW/eaWXWHFqtbVwla4wJwKCPE6Ib4ZKsZZdX2YdLZ5QMUkqKj509dlVPSsCkX3XojBQytXf0qVUZSfqqvCarMk8JaWIxzvrY2agaTgGtFHqmJXyUK/bhUJXKeouLPDNth4W3ChJxNTJQ1wDolFi7+41LeYDEsSIM1uGGN2lhEmGKUa+L7pPzLZAEh0dJ9FYsDWN0TORcli4RQWeTmENo0W8MWj+DWSp77yTj6X/AoMd1lWGv5AxK5RYgZSoBBZ0zAy3iDRAutA8cnf6Ovais9/M0s9M6QjZlgxgk5hpJJqT17zHrfb4oAdHSevAZlVP4Bi6FnS/gMCN9Hg6FPPoMLAo6HLs8vkB5rzLS+DIROsTPPGBBMTprnQuhW6knf9Lh0JQ3SlS6yWrBpVJaawG7MdfobyCq54cUTGHErdsvmjq5HLGgYGfc4gJQyWXa0ShetggbBbf5QQ+goL+PA2ZDfXI7TIXxAJke+nArAmIuSxg3EzPOJX8gYridK4tvHgHQHyOozhvOQ1EutZ2ZsZVdGjRww3nBYtpza2ODjI57Jycp3G8eWIT7eC6E4JzHFFjFKDAILB4hV8WscmDw3psepfDF5/uvZvdfHvOc+frr7fdfwL9/RAAPMf79WATy4MHSd4+W/pTH3cOv13gVNwLeV4/7oB4tIlfS14L6A8TbR6b3D3W/f+x8/2CcpIPxfzu6hx8XsrM/f1yAnz8C69Tnjx/J3knKZLi2SwAAAABJRU5ErkJggg=='` | 否 | 目标地址或图片地址，具体含义取决于组件。 |
+| `text` | `String` | `'微信好友'` | 否 | 组件公开属性 text，用于控制该组件对应的渲染、交互或业务参数。 |
+| `fontSize` | `[Number, String]` | `13` | 否 | 字体大小。 |
+| `color` | `String` | `''` | 否 | 文字或图标主色。 |
+| `data` | `Object` | `() => ({})` | 否 | 组件渲染或业务计算使用的数据源。 |
+| `space` | `[Number, String]` | `4` | 否 | 组件公开属性 space，用于控制该组件对应的渲染、交互或业务参数。 |
+| `custom` | `Function` | `null` | 否 | 自定义处理函数；存在时组件会优先调用它接管默认动作。 |
+| `customStyle` | `Object` | `() => ({})` | 否 | 最外层自定义 style 对象。 |
+
+### 微信分享 Events
+
+| 事件 | 说明 |
+| --- | --- |
+| `confirm` | 点击确认按钮或执行确认动作时触发。 |
+
+### 微信分享 Slots
+
+无显式插槽。
+
+### 微信分享 Methods
+
+| 方法 | 说明 |
+| --- | --- |
+| `click()` | 处理点击逻辑；可能触发跳转、自定义函数或对外事件。 |
+
+### 微信分享 Internal State
+
+| 类型 | 名称 | 说明 |
+| --- | --- | --- |
+| computed | `style` | 内部计算属性，用于把 props、平台信息或样式配置转换为模板可用值。 |
+| computed | `textStyle` | 内部计算属性，用于把 props、平台信息或样式配置转换为模板可用值。 |

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

@@ -0,0 +1,71 @@
+# g-skeleton-view 骨架视图
+
+::: tip 组件名
+`g-skeleton-view`
+
+发布路径：`@zfqh/uniapp/lib/components/g-skeleton-view/g-skeleton-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="goods-skeleton">
+    <g-skeleton-view height="158rpx" width="158rpx" border-radius="20rpx" />
+    <view class="g-flex-1 g-m-l-20">
+      <g-skeleton-view height="40rpx" width="320rpx" border-radius="8rpx" />
+      <g-skeleton-view height="32rpx" width="240rpx" border-radius="8rpx" margin-top="12rpx" />
+    </view>
+  </view>
+</template>
+```
+
+## API
+
+### 骨架视图 Props
+
+| 属性 | 类型 | 默认值 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `customStyle` | `Object` | `() => ({})` | 否 | 最外层自定义 style 对象。 |
+| `borderRadius` | `[String, Number]` | `0` | 否 | 圆角。 |
+| `bgColor` | `String` | `'#e5e5e5'` | 否 | 背景颜色。 |
+| `width` | `[String, Number]` | `'auto'` | 否 | 宽度。 |
+| `height` | `[String, Number]` | `20` | 否 | 高度。 |
+| `marginTop` | `[String, Number]` | `0` | 否 | 组件公开属性 marginTop，用于控制该组件对应的渲染、交互或业务参数。 |
+| `marginLeft` | `[String, Number]` | `0` | 否 | 组件公开属性 marginLeft，用于控制该组件对应的渲染、交互或业务参数。 |
+| `marginRight` | `[String, Number]` | `0` | 否 | 组件公开属性 marginRight，用于控制该组件对应的渲染、交互或业务参数。 |
+
+### 骨架视图 Events
+
+无显式组件事件。
+
+### 骨架视图 Slots
+
+| 插槽 | 说明 |
+| --- | --- |
+| `default` | 默认内容区域。 |
+
+### 骨架视图 Methods
+
+无 Options API methods。
+
+### 骨架视图 Internal State
+
+| 类型 | 名称 | 说明 |
+| --- | --- | --- |
+| computed | `style` | 内部计算属性，用于把 props、平台信息或样式配置转换为模板可用值。 |