tmui-cli 2.0.5 → 5.3.1

package/data/tmui4x/10./346/217/222/344/273/266/345/272/223/xPdfS PDF/345/220/210/346/210/220.md"

@@ -68,6 +68,30 @@ imageTextToPdf({
 
 ## 更新日志
 
+### 0.1.25（2026-09-11）
+- **修「叠字整体往下掉、偏下约 3/4 个字高」**。落点原来算的是「检测框中心 ± 半个字号」：PDF 的 y 是从**页底往上**算的，而这一项按「y 向下」写成了 `框底 - 框高/2 + 字号/2`，等于把落点压到框底下面一截 —— 实测比正确基线低约 0.58 个字高，和真机上看到的「偏下 3/4 个字」一致。
+- 现在三端都优先钉在 **OCR 量出来的基线**上（`XPdfTextLine` 新增可选 `baseline` / `inkTop` / `inkH`，由 `x-correct-s` 的 OCR 结果透传）：基线是按**墨迹**算的，和检测框的位置无关，框偏下、框里混进上下标都不会带偏。没给基线才退回墨迹带底，最后才退回「按框居中」。
+  - 鸿蒙：`addTextObject` 直接吃基线（页底往上算）；
+  - Android：`Canvas.drawText` 的 baseline（视图坐标，从上往下算）；
+  - iOS：`NSString.draw(at:)` 的点是文字框左上角，所以从基线往上退一个 `ascender`；顺带修掉原来「从框顶再退 ascent」把字整体抬高的问题。
+- `XPdfTextLine` 去掉恒为空串的 `latex`（`x-correct-s` 的公式识别已下线，这个字段是它留下的空壳，本版起不再透传）。`kind` 保留。
+
+### 0.1.24（2026-09-11）
+- 叠字 PDF 的字号不再夹在 8–28 点，改成 `框高(图片像素) × fontScale × 图片到页面的缩放`，框越高字越大，和原图比例一致；预览叠字用同一个 0.85 系数，两边对得上。
+- 新增 `minFontPt`：等比换算后小于它才用它兜底，避免缩得太小看不清。默认 10pt，不影响坐标。
+- 新增 `textOnly`：纯文本模式不画底图，页面尺寸按图片比例（最长边 842pt）且不套页边距，文字按原图位置与大小等比输出。适合要「可选中纯文字、位置尺寸同图」的场合；此时 `paperSize` / `margin` / `imageOpacity` 不起作用。
+- 新增 `fontScale`：框高到字号的系数，默认 0.85，可 0.3–1.5 之间调。
+- 有坐标行的文字改为按框居中，框不够宽时整行横向压扁（先缩字号、再压字距），不再截断或溢出。
+- `XPdfTextLine` 增加 `kind` / `latex` 两个可选字段，供上层把行类型与公式原文一路带到 PDF 层（本版只透传，PDF 里画的仍是 `text`）。
+
+### 0.1.23（2026-09-09）
+- iOS 合成不再对相册 / 扫描的沙箱绝对路径走 `convert2AbsFullPath`，文件已存在就直接读。避免和安卓一样报「图片读取失败」。
+### 0.1.22（2026-09-09）
+- 安卓改为 Kotlin 后台线程合成：当前线程先 `JSON.stringify`，避免 UTS 对象在 IO dispatcher 里序列化卡死。PDF 固定写到应用 cacheDir。
+### 0.1.21（2026-09-08）
+- 安卓合成 / 删页 / 调序 / 合并改到 IO 线程，完成后再回主线程回调。避免挡住 `showLoading`，转圈不再假死。
+### 0.1.20（2026-09-08）
+- 安卓合成不再对相册 / 扫描的沙箱绝对路径走 `convert2AbsFullPath`，避免被当成包内相对路径拼坏后报「图片读取失败」。`file://` 会解码，`content://` 原样交给 BitmapFactory。大图按长边抽样，避免整图解码失败。
 ### 0.1.19（2026-08-20）
 - iOS 图文叠字不再把 `options` 强转成 `UTSJSONObject`。Options 是 Swift 类型，`as!` 会闪退。页面数组改为 `JSON.stringify` 后再按 JSON 读字段。
 ### 0.1.18（2026-08-20）

package/data/tmui4x/10./346/217/222/344/273/266/345/272/223/xPdfU PDF/351/242/204/350/247/210.md"

@@ -30,7 +30,7 @@ pdf.value?.jumpTo(2)
 pdf.value?.print()
 ```
 
-App 端远程 http/https/ftp 会先下载再渲染；本地路径直接打开。
+App 端远程 http/https/ftp 会先下载再渲染。本地支持绝对路径、`file:///`、鸿蒙文档库授权 URI（`file://docs/...`）、Android `content://`、iOS `unifile://`；中文文件名的百分号编码会解开。
 
 ### 参数
 
@@ -44,6 +44,7 @@ App 端远程 http/https/ftp 会先下载再渲染；本地路径直接打开。
 | --- | --- | --- |
 | onInit | `{ page, pageCount }` | PDF 加载完成，`page` 从 0 开始 |
 | pageChange | `{ page, pageCount }` | 当前页变化 |
+| error | `{ errMsg }` | 文件不存在、下载失败或解析失败 |
 
 ### 方法
 
@@ -68,6 +69,12 @@ App 端远程 http/https/ftp 会先下载再渲染；本地路径直接打开。
 
 ## 更新日志
 
+### 1.0.9（2026-09-09）
+* 安卓已是沙箱绝对路径、`file://` 不再先 `convert2AbsFullPath`，避免合成后的 cache PDF 打不开。
+### 1.0.8（2026-09-08）
+* 全端补 `error` 事件（`{ errMsg }`）：文件不存在、路径无效、解析失败、远程下载失败都会回调，不再只打日志。
+### 1.0.7（2026-09-08）
+* 全端规范化本地文档路径：鸿蒙 `file://docs/...` 授权 URI 先落沙箱再打开（不再剥成 `docs/storage/...`）；Android 处理 `file://` / `content://` / `unifile://`；iOS 对齐 mime-s 解析 `file://` 与 `unifile://`；Web 解开 `file://` 百分号路径。
 ### 1.0.6（2026-08-18）
 * Android 预览在 scroll-view 内禁止父级拦截触摸，翻页/缩放只留在 PDF 内，不再穿透到页面。
 

package/data/tmui4x/10./346/217/222/344/273/266/345/272/223/xPiniaS.md

@@ -0,0 +1,122 @@
+# x-pinia-s
+
+Pinia v3.0.4 单文件版 + 基于 uni 存储的持久化插件。去掉 `@vue/devtools-api` 依赖，适配 uni-app-x；自带 `createPersistPlugin`，用 `uni.setStorageSync` 保存 `store.$state`，下次启动自动还原。
+
+### 兼容性
+
+| Harmony | IOS | Android | WEB | 小程序 |
+| --- | --- | --- | --- | --- |
+| 支持 | 支持 | 支持 | 支持 | 支持 |
+
+### 接入
+
+`main.uts` 中创建 Pinia 并挂载持久化插件：
+
+```ts
+// @ts-ignore
+import { createPinia } from '@/uni_modules/x-pinia-s/js_sdk/pinia'
+import { createPersistPlugin } from '@/uni_modules/x-pinia-s/js_sdk/piniaPersist'
+
+const pinia = createPinia()
+
+export function createApp() {
+  // @ts-ignore
+  const app = createSSRApp(App)
+
+  pinia.use(createPersistPlugin({
+    keyPrefix: 'pinia:',
+    includeStores: ['user'],
+    excludeStores: [],
+    serializer: null
+  }))
+  app.use(pinia)
+
+  return {
+    app
+  }
+}
+```
+
+### 定义 store
+
+```ts
+import { ref, computed } from 'vue'
+// @ts-ignore
+import { defineStore } from '@/uni_modules/x-pinia-s/js_sdk/pinia'
+
+export const useUserStore = defineStore('user', () => {
+  const token = ref<string | null>(null)
+  const isLogin = computed(() : boolean => token.value != null && token.value != '')
+
+  const setLogin = (newToken : string) => {
+    token.value = newToken
+  }
+
+  return {
+    token,
+    isLogin,
+    setLogin
+  }
+})
+```
+
+页面中使用：
+
+```ts
+import { useUserStore } from '@/store/useUserStore'
+import { storeToRefs } from '@/uni_modules/x-pinia-s/js_sdk/pinia'
+
+const store = useUserStore()
+const { token } = storeToRefs(store)
+store.setLogin('abc')
+```
+
+### 方法
+
+| 名称 | 说明 |
+| --- | --- |
+| createPinia | 创建 Pinia 实例 |
+| defineStore | 定义 store，支持 options 与 setup 两种写法 |
+| storeToRefs | 解构 state / getters 并保持响应式 |
+| mapState / mapActions / mapStores / mapWritableState | Options API 辅助函数 |
+| acceptHMRUpdate | HMR 更新 |
+| setActivePinia / getActivePinia | SSR 或组件外手动切换活动实例 |
+| disposePinia | 销毁 Pinia 实例 |
+| skipHydrate / shouldHydrate | 控制 setup store 的 hydration |
+| createPersistPlugin | 持久化插件 |
+| clearPersistedState | 清除某个 store 的持久化数据 |
+
+### 持久化插件参数
+
+`createPersistPlugin(options)`
+
+| 字段 | 说明 | 默认 |
+| --- | --- | --- |
+| keyPrefix | storage key 前缀，实际 key 为 `keyPrefix + store.$id` | `pinia:` |
+| includeStores | 白名单，`null` 表示全部持久化 | `null` |
+| excludeStores | 黑名单，优先级高于白名单 | `[]` |
+| serializer | 自定义序列化器 `{ serialize, deserialize }`，`null` 用 JSON | `null` |
+
+```ts
+import { clearPersistedState } from '@/uni_modules/x-pinia-s/js_sdk/piniaPersist'
+
+// 只清存储，不影响内存状态
+clearPersistedState('user', 'pinia:')
+```
+
+### 平台差异
+
+1. 单文件接入，去掉 `@vue/devtools-api`，uni-app-x 无 Vue DevTools。
+2. 持久化走 `uni.setStorageSync` / `uni.getStorageSync`，各端存储实现由 uni 提供。
+3. 白名单 / 黑名单按 `store.$id` 匹配；同时命中时黑名单优先。
+
+### 版本
+
+https://xui.tmui.design 下载归档。
+
+## 更新日志
+
+### 1.0.0（2026-08-24）
+* 接入 Pinia v3.0.4，单文件编译，去掉 @vue/devtools-api，适配 uni-app-x
+* 提供 createPersistPlugin 持久化插件，uni.setStorageSync 保存 store.$state，启动自动还原
+* 提供 clearPersistedState 清除单个 store 的持久化数据

package/data/tmui4x/10./346/217/222/344/273/266/345/272/223/xSkiaU Skia/347/224/273/345/270/203.md"

@@ -69,7 +69,7 @@ iOS 请用 `new XSkiaRecipe(...)`，不要用工厂函数返回的实例。
 
 | 名称 | 参数 | 说明 |
 | --- | --- | --- |
-| ready | 无 | 画布已可呈现。之后缓冲因尺寸重建被清空时会再发，应在回调里全量重绘 |
+| ready | 无 | 画布已可呈现。首次在业务组件挂载后发出（不会早于模板 ref 可用）；之后缓冲因尺寸重建被清空时会再发，应在回调里全量重绘 |
 
 ### 实时画布方法
 

package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/205/266/345/256/203/347/273/204/344/273/266//344/272/214/347/273/264/347/240/201 xQrcoder.md"

@@ -38,7 +38,7 @@
 | padding | `边距`<br> | `number` | `2` |
 | mode | `绘制样式：rect/circular/line/rectSmall/xing/vertical`<br> | `string` | `"rect"` |
 | pdRounded | `定位位点是否使用圆角`<br> | `boolean` | `false` |
-| wifi | `生成wifi码`<br> | `UTSJSONObject` | `() : UTSJSONObject => ({} as UTSJSONObject)` |
+| wifi | `生成wifi码`<br> | `Record` | `() : Record<string, any> => ({} as Record<string, any>)` |
 
 
 ## Events 事件
@@ -147,7 +147,7 @@
 	
 </template>
 
-<script setup>
+<script setup lang="ts">
 	const qxqr = ref<XQrcoderComponentPublicInstance|null>(null)
 	const logo = ref('')
 	const text = ref('https://tmui.design')
@@ -156,13 +156,13 @@
 	const auth = ref("WPA")
 	const password = ref("123456")
 	const hidnpassword = ref("true")
-	const wifiQr = computed(():UTSJSONObject=>{
+	const wifiQr = computed(():Record<string, any>=>{
 		return {
 			ssid:ssid.value,
 			auth:auth.value,
 			password:password.value,
 			hidden:hidnpassword.value
-		} as UTSJSONObject
+		} as Record<string, any>
 	})
 	const getImgQr = ()=> {
 		qxqr.value?.getQrImg?.((imgstr:string)=>{

package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/205/266/345/256/203/347/273/204/344/273/266//345/233/276/347/211/207/350/243/201/345/211/252 xImageResizer.md"

@@ -3,7 +3,7 @@
 ## 介绍
 
 兼容PC操作，可双指缩放，单指平移，翻转，也可支持电脑端滚轮缩放，鼠标平移，裁剪框四角缩放，功能齐全，操作方便。
-web端裁剪后返回的是Base64数据，其它端是文件连接。
+裁剪绘制与导出使用 x-skia-u 画布（不再使用官方 canvas），确认时通过 toTempFilePath 返回临时文件路径。
 
 ## 平台兼容
 
@@ -37,7 +37,7 @@ web端裁剪后返回的是Base64数据，其它端是文件连接。
 
 | 名称 | 参数 | 说明 |
 | ------ | ---- | ---- |
-| confirm | `filepath: string<br>` | 确认时返回文件<br>ios,安卓返回的是缓存文件路径<br>web返回的是Bolb文件对象<br>微信返回的是base64图片数据 |
+| confirm | `filepath: string<br>` | 确认时返回文件<br>app端返回缓存文件路径(file://)，web/微信端返回 dataURL |
 | cancel | `-` | 取消裁剪时触 |
 
 

package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/205/266/345/256/203/347/273/204/344/273/266//345/233/276/350/241/250 xEchart.md"

@@ -119,7 +119,7 @@
 			if (data!=null&& typeof data == 'object') {
 				uni.showModal({
 					title: "提醒",
-					content: JSON.stringify(data! as UTSJSONObject),
+					content: JSON.stringify(data! as Record<string, any>),
 					showCancel: false
 				})
 			}
@@ -145,7 +145,7 @@
 					data: [100, 50, 20, 70, 40, 600]
 				}
 			]
-		} as UTSJSONObject
+		} as Record<string, any>
 
 		echart.value?.setOptions?.(opts)
 		
@@ -194,7 +194,7 @@
 					}
 				}
 			]
-		} as UTSJSONObject;
+		} as Record<string, any>;
 
 		echart2.value?.setOptions?.(option)
 	}
@@ -221,7 +221,7 @@
 				}
 			]
 
-		} as UTSJSONObject
+		} as Record<string, any>
 		echart.value?.setOptions?.(opts)
 	}
 </script>

package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/205/266/345/256/203/347/273/204/344/273/266//345/256/211/345/205/250/351/252/214/350/257/201 xSafeVerify.md"

@@ -0,0 +1,239 @@
+# 安全验证 xSafeVerify
+
+## 介绍
+
+全端 x-skia-u 绘制的人机安全验证。拼图模式：把用户图片画到画板上，随机位置挖出内置图形缺口，拖动随机图形与缺口重合即通过；字符模式：把一组字符随机渲染到用户图片上，按提示顺序点选（点选处圆形数字索引，再点一次取消），点满自动校验。
+
+## 平台兼容
+
+| Harmony | H5 | andriod | IOS | 小程序 | UTS | UNIAPP-X SDK | version |
+| --- | --- | --- | --- | --- | --- | --- | --- |
+| ☑ | ☑ | ☑️ | ☑️ | ☑️ | ☑️ | 4.76+ | 1.9.9 |
+
+## 文件路径
+
+```ts
+@/uni_modules/tmx-ui/components/x-safe-verify/x-safe-verify.uvue
+```
+
+## 使用
+
+```ts
+<x-safe-verify></x-safe-verify>
+```
+
+## Props 属性
+
+| 名称 | 说明 | 类型 | 默认值 |
+| ------ | ---- | ---- | ---- |
+| mode | `验证模式`<br>`jigsaw：拖动随机图形与图片缺口重合`<br>`char：按顺序点选图中字符`<br> | `XSafeVerifyMode` | `'jigsaw'` |
+| src | `背景图片地址，支持网络图片和本地图片`<br>`网络图片在 App 端需要配置下载合法域名`<br> | `string` | `''` |
+| width | `宽，允许使用数字，百分比，带单位的字符串`<br> | `string` | `'100%'` |
+| height | `高，允许使用数字，带单位的字符串`<br> | `string` | `'180'` |
+| round | `圆角`<br> | `string` | `'10'` |
+| shape | `拼图模式的内置图形，random 为每次随机一种`<br>`puzzle 拼图块 / circle 圆形 / square 方形 / triangle 三角 / diamond 菱形`<br>`hexagon 六边形 / star 五角星 / heart 心形 / cross 十字`<br> | `XSafeVerifyShape` | `'random'` |
+| pieceSize | `拼图模式下图形边长，px，0 为按画板自动`<br> | `number` | `0` |
+| tolerance | `允许的误差 px，0 为按图形大小自动(图形边长 16%)`<br> | `number` | `0` |
+| chars | `字符模式下用户指定的按顺序字符组，例如 '天地玄黄'`<br>`为空时从内置字库中随机抽取 count 个不重复字符`<br> | `string` | `''` |
+| count | `字符模式随机字符数量，2-8，提供 chars 时以 chars 长度为准`<br> | `number` | `4` |
+| fontSize | `字符字号 px，0 为自动`<br> | `number` | `0` |
+| maskColor | `拼图缺口遮罩色`<br> | `string` | `'rgba(0,0,0,0.55)'` |
+| lineColor | `缺口和图形描边色`<br> | `string` | `'rgba(255,255,255,0.95)'` |
+| activeColor | `激活色，空取全局主题色，用于序号索引`<br> | `string` | `''` |
+| successColor | `验证通过色`<br> | `string` | `'success'` |
+| failColor | `验证失败色`<br> | `string` | `'error'` |
+| showTips | `是否显示底部提示`<br> | `boolean` | `true` |
+| tipsRender | `状态提示渲染位置`<br>`dom：渲染成组件底部小字提示层，可用 tips 插槽自定义，默认`<br>`canvas：画在画布上，不依赖 DOM 层级，DOM 会被原生画布遮住时用它`<br> | `union` | `'dom'` |
+| tips | `自定义未验证时的提示文本`<br> | `string` | `''` |
+| tipsSuccess | `自定义验证成功的提示文本`<br> | `string` | `''` |
+| tipsFail | `自定义验证失败的提示文本`<br> | `string` | `''` |
+| tipsColor | `提示文本颜色，空为白色`<br> | `string` | `''` |
+| resetAuto | `验证失败后是否自动重置（重新出题）`<br> | `boolean` | `true` |
+| resetDelay | `自动重置的延时毫秒`<br> | `number` | `900` |
+| autoVerify | `拼图模式松手后是否自动校验，false 时由 ref.verify() 手动校验`<br> | `boolean` | `true` |
+| disabled | `是否禁用交互`<br> | `boolean` | `false` |
+
+
+## Events 事件
+
+| 名称 | 参数 | 说明 |
+| ------ | ---- | ---- |
+| ready | `-` | 题目已生成（首次就绪以及每次重新出题时触发） |
+| success | `mode: string<br>` | 验证通过 |
+| fail | `mode: string<br>reason: string<br>` | 验证失败 |
+| error | `message: string<br>` | 图片加载失败等错误 |
+| reset | `-` | 重置完成后触发 |
+| click | `char: string<br>order: number<br>` | 字符模式点选字符时触发 |
+
+
+## Slots 插槽
+
+| 名称 | 说明 | 数据 |
+| ------ | ---- | ---- |
+| tips | `底部提示插槽,文本随状态变化` | text: string<br> |
+
+
+## Ref 方法
+
+| 名称 | 参数 | 返回值 | 说明 |
+| ------ | ---- | ---- | ---- |
+| reset | - | `-` | 重置，重新出题并清空操作 * |
+| refresh | - | `-` | 同reset，重新出题 * |
+| clear | - | `-` | 只清空当前操作，题目不变 * |
+| verify | - | `-` | 手动校验当前状态 * |
+| getStatus | - | `-` | 当前状态 load/ready/success/fail * |
+| getTries | - | `-` | 当前题目失败次数 * |
+| getAnswer | - | `-` | 当前题目答案 * |
+| getSelected | - | `-` | 用户当前操作结果 * |
+| getImage | - | `-` | 导出画板图片 * |
+
+
+## 示例文件路径
+
+```json
+/pages/qita/safe-verify
+```
+
+## 示例源码
+
+```vue
+<template>
+	<!-- #ifdef MP-WEIXIN -->
+	<page-meta :page-style="`background-color:${xThemeConfigBgColor}`">
+		<navigation-bar :background-color="xThemeConfigNavBgColor" :front-color="xThemeConfigNavFontColor"></navigation-bar>
+	</page-meta>
+	<!-- #endif -->
+
+	<x-sheet>
+		<x-text font-size="18" class=" text-weight-b mb-8">安全验证 xSafeVerify</x-text>
+		<x-text color="#999999">
+			全端 x-skia-u 原生绘制。拼图模式：拖动随机图形与图片缺口重合；字符模式：按顺序点选图中字符，点选处显示圆形数字索引，再点一次取消。
+		</x-text>
+	</x-sheet>
+
+	<x-sheet>
+		<x-text font-size="18" class=" text-weight-b mb-8">拼图拖动验证</x-text>
+		<x-text color="#999999" class="mb-8">拖动右侧的图形到左侧缺口处，重合即通过。松手自动校验，失败自动换题。</x-text>
+		<x-safe-verify ref="jigsawRef" src="https://cdn.tmui.design/xui/tmui4.0banner1.jpg" height="200"
+			@ready="onReady" @success="onSuccess" @fail="onFail" @error="onError"></x-safe-verify>
+		<x-button class="mt-20" :block="true" @click="resetJigsaw">重置/换题</x-button>
+	</x-sheet>
+
+	<x-sheet>
+		<x-text font-size="18" class=" text-weight-b mb-8">拼图验证：指定图形与颜色</x-text>
+		<x-text color="#999999" class="mb-8">shape 指定内置图形（puzzle/circle/square/triangle/diamond/hexagon/star/heart/cross）。</x-text>
+		<x-safe-verify ref="starRef" shape="star" height="200" :piece-size="64" :tolerance="8" line-color="#F7B500"
+			src="/static/temqrcoderPicCanvas.jpg" @success="onSuccess" @fail="onFail"></x-safe-verify>
+		<x-button class="mt-20" :block="true" color="warn" @click="resetStar">重置/换题</x-button>
+	</x-sheet>
+
+	<x-sheet>
+		<x-text font-size="18" class=" text-weight-b mb-8">拼图验证：自己控制校验</x-text>
+		<x-text color="#999999" class="mb-8">auto-verify 设为 false 后，松手不校验，由 ref.verify() 触发。</x-text>
+		<x-safe-verify ref="manualRef" height="200" :auto-verify="false" :piece-size="56"
+			src="https://cdn.tmui.design/xui/tmui4.0banner1.jpg" @success="onSuccess" @fail="onFail"></x-safe-verify>
+		<x-sheet class="flex flex-row mt-20">
+			<x-button width="48%" @click="doVerify">手动校验</x-button>
+			<x-button width="48%" class="mx-10" color="warn" @click="resetManual">重置</x-button>
+		</x-sheet>
+	</x-sheet>
+
+	<x-sheet>
+		<x-text font-size="18" class=" text-weight-b mb-8">中文字符顺序验证（内置随机字符）</x-text>
+		<x-text color="#999999" class="mb-8">从内置字库随机取 4 个不重复字符随机渲染，按顶部提示顺序点选，点满自动校验。</x-text>
+		<x-safe-verify ref="charRef" mode="char" :count="4" height="220"
+			src="https://cdn.tmui.design/xui/tmui4.0banner1.jpg"
+			@success="onSuccess" @fail="onFail" @click="onCharClick"></x-safe-verify>
+		<x-button class="mt-20" :block="true" @click="resetChar">重置/换题</x-button>
+	</x-sheet>
+
+	<x-sheet>
+		<x-text font-size="18" class=" text-weight-b mb-8">中文字符顺序验证（自定义字符组）</x-text>
+		<x-text color="#999999" class="mb-8">chars 传入按顺序的字符组，用它来控制答案顺序。</x-text>
+		<x-safe-verify ref="charsRef" mode="char" chars="天地玄黄" height="220" :font-size="30"
+			src="https://cdn.tmui.design/xui/tmui4.0banner1.jpg" @success="onSuccess" @fail="onFail"></x-safe-verify>
+		<x-sheet class="flex flex-row mt-20">
+			<x-button width="48%" @click="resetChars">重置/换题</x-button>
+			<x-button width="48%" class="mx-10" color="warn" @click="showResult">查看用户点选结果</x-button>
+		</x-sheet>
+	</x-sheet>
+
+	<x-sheet>
+		<x-text font-size="18" class=" text-weight-b mb-8">弹层内使用</x-text>
+		<x-text color="#999999" class="mb-8">弹层动画结束后再挂画布，所以要在 @open 里 v-if。</x-text>
+		<x-modal @open="onModalOpen" @close="show=false" height="370">
+			<template v-slot:trigger>
+				<x-button :block="true">打开弹层验证</x-button>
+			</template>
+			<x-safe-verify v-if="show" ref="modalRef" mode="char" chars="上善若水" height="200"
+				src="https://cdn.tmui.design/xui/tmui4.0banner1.jpg" @success="onSuccess" @fail="onFail"></x-safe-verify>
+		</x-modal>
+	</x-sheet>
+
+</template>
+
+<script lang="ts" setup>
+	const jigsawRef = ref<XSafeVerifyComponentPublicInstance | null>(null)
+	const starRef = ref<XSafeVerifyComponentPublicInstance | null>(null)
+	const manualRef = ref<XSafeVerifyComponentPublicInstance | null>(null)
+	const charRef = ref<XSafeVerifyComponentPublicInstance | null>(null)
+	const charsRef = ref<XSafeVerifyComponentPublicInstance | null>(null)
+	const modalRef = ref<XSafeVerifyComponentPublicInstance | null>(null)
+
+	const onReady = () => {
+		console.log('x-safe-verify 题目已生成')
+	}
+	const onSuccess = (mode : string) => {
+		uni.showToast({ title: '验证通过:' + mode, icon: 'success' })
+	}
+	const onFail = (mode : string, reason : string) => {
+		uni.showToast({ title: '验证失败:' + reason, icon: 'error' })
+	}
+	const onError = (message : string) => {
+		uni.showToast({ title: message, icon: 'none' })
+	}
+	const onCharClick = (char : string, order : number) => {
+		console.log('点选字符', char, order)
+	}
+
+	const resetJigsaw = () => {
+		jigsawRef.value?.reset()
+	}
+	const resetStar = () => {
+		starRef.value?.reset()
+	}
+	const resetManual = () => {
+		manualRef.value?.clear()
+	}
+	const doVerify = () => {
+		manualRef.value?.verify()
+	}
+	const resetChar = () => {
+		charRef.value?.reset()
+	}
+	const resetChars = () => {
+		charsRef.value?.reset()
+	}
+	const showResult = () => {
+		const el = charsRef.value
+		if (el == null) return
+		uni.showToast({ title: '你点的顺序:' + el.getSelected() + ' 状态:' + el.getStatus(), icon: 'none' })
+	}
+
+	const show = ref(false)
+	const onModalOpen = () => {
+		show.value = true
+	}
+</script>
+
+<style>
+
+</style>
+
+```
+
+---
+
+## 版权
+
+@2026 tmui4x [https://xui.tmui.design](https://xui.tmui.design)

package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/205/266/345/256/203/347/273/204/344/273/266//346/200/235/347/273/264/345/257/274/345/233/276 xTreeFlat.md"

@@ -95,9 +95,9 @@
 
 </template>
 
-<script setup>
+<script setup lang="ts">
 	import { XTreeFlatOpts, XTREEFLAT_NODES } from '@/uni_modules/tmx-ui';
-	import { TestFlatData } from "./mock.uts"
+	import { TestFlatData } from "./mock"
 	const xmind = ref<XTreeFlatComponentPublicInstance | null>(null)
 	const layout = ref<'horizontal' | 'vertical'>('horizontal')
 	const lineType = ref<'straight' | 'curve'>('straight')
@@ -106,7 +106,7 @@
 	})
 	const oninit = () => {
 		console.warn("导图引擎启动成功，可以设置数据了")
-		xmind.value!.setData(JSON.parseArray<XTREEFLAT_NODES>(TestFlatData)!)
+		xmind.value!.setData(JSON.parse(TestFlatData) as XTREEFLAT_NODES[])
 	}
 </script>