tmui-cli 2.0.1 → 2.0.3

package/data/tmui4x/10./346/217/222/344/273/266/345/272/223/xSqliteS SQLite/346/225/260/346/215/256/345/272/223.md"

@@ -0,0 +1,248 @@
+# x-sqlite-s SQLite数据库
+
+## 简介
+x-sqlite-s 是一个用于 uni-appx 的 SQLite 数据库操作插件，支持基本的数据库。
+
+### 兼容性
+
+| Harmony | IOS | Android | WEB | 小程序 |
+| --- | --- | --- | --- | --- |
+| 支持 | 支持 | 支持 | 支持 | x |
+
+## 安装
+在插件市场搜索并导入 x-sqlite-s 插件。
+
+## 特别注意
+配置中的密码等加密功能,未实现,只是一个预设功能.
+
+## web注意事项
+
+请到插件目录内复制static到你的根目录static即可。否则web无法使用。
+
+## 类型定义
+
+### SQLiteConfig 配置项
+**鸿蒙不支持自定义其它目录**为了全平台兼容，不建议设置defaultDirectory，
+在安卓和ios中defaultDirectory它可指定为缓存目录，下载目录，用户目录等等沙盒目录。
+但鸿蒙它是固定在`应用目录/rdb/自定义目录`，下，因为实际上是被固定在了`应用目录/rdb/`下.
+因此差异非常大。故，鸿蒙端defaultDirectory我将不会生效。仅在安卓和ios下生效。就算你写了我也不使用。
+鸿蒙一定要离开页面后关闭。否则再次打开时会失败，鸿蒙端他全局允许打开一个db实例，而且是唯一的
+
+```typescript
+type SQLiteConfig = {
+    password?: string;      // 数据库密码
+    encryption?: boolean;   // 是否启用加密
+    defaultDirectory?: string; // 数据库文件存储目录,鸿蒙不支持，它的目录是固定的加密区目录，无法像安卓,ios那样保存到其它目录：比如用户目录，缓存目录等。
+    locateFile?: (filename: string) => string;  // 自定义文件位置，web专用属性，默认内置
+}
+```
+
+### SQLiteResult 返回结果
+```typescript
+type SQLiteResult = {
+    rows?: any[][];        // 查询结果行数据
+    columns?: string[];    // 列名
+    maps?: any[];         // 查询结果对象数组，可通过列名访问数据
+    changes?: number;      // 影响的行数
+    lastInsertRowid?: number;  // 最后插入的行ID
+    error?: string;        // 错误信息
+}
+```
+
+### SQLiteExecuteBatchParams 批量执行参数
+```typescript
+type SQLiteExecuteBatchParams = {
+    sql: string;           // SQL语句
+    params?: any[];        // 参数列表
+}
+```
+
+## API 说明
+
+### 创建数据库
+```javascript
+createDb(filename?: string): boolean
+// web端是Promise函数,执行时可以await createDb
+// app是同步操作,不是Promise
+```
+创建或打开一个数据库。如果未指定文件名，默认为 "sqlite.db"。
+
+### 执行SQL查询
+```javascript
+run(sql: string, params: any[] = []): SQLiteResult
+```
+执行一条SQL语句，支持参数绑定。
+
+### 查询数据
+```javascript
+query(sql: string, params: any[] = []): SQLiteResult
+```
+执行查询语句并返回结果集。
+
+### 插入数据
+```javascript
+insert(table: string, data: object): SQLiteResult
+```
+向指定表插入数据。
+
+### 更新数据
+```javascript
+update(table: string, data: object, where: string, params: any[] = []): SQLiteResult
+```
+更新表中的数据。
+
+### 删除数据
+```javascript
+delete(table: string, where: string, params: any[] = []): SQLiteResult
+```
+删除表中的数据。
+
+### 事务处理
+```javascript
+beginTransaction(): SQLiteResult  // 开始事务
+commit(): SQLiteResult           // 提交事务
+rollback(): SQLiteResult         // 回滚事务
+```
+
+### 批量执行
+```javascript
+executeBatch(statements: SQLiteExecuteBatchParams[]): SQLiteResult[]
+```
+批量执行SQL语句，支持事务。
+
+### 数据库文件管理
+
+**createDb,loadFromBuffer,loadLocal三个函数**
+**web端是Promise函数**
+**app是同步操作,不是Promise**
+
+```javascript
+createDb(filename?: string): boolean    // 创建一个本地数据库,重命的重复创建不会覆盖,只是读取已有的数据库.
+saveLocal(filename?: string): SQLiteResult    // 保存数据库到本地
+loadLocal(filename: string): SQLiteResult     // 从本地加载数据库
+getDatabasePath(): string | null             // app端获取数据库备份临时文件路径
+getDatabasePath(): Uint8Array | null         // web端返回的是二进制数据
+loadFromBuffer(buffer: Uint8Array):void      // web端专用函数,用来从进制制数据加载远程数据库
+setDefaultDirectory(directory: string): void  // 设置数据库文件存储目录
+setPassword(password: string|null): void      // 设置数据库密码，null或空值表示删除密码
+```
+
+### 表操作
+```javascript
+tableExists(tableName: string): boolean       // 检查表是否存在
+createTable(tableName: string, columns: UTSJSONObject): SQLiteResult  // 创建表
+dropTable(tableName: string): SQLiteResult    // 删除表
+```
+
+## 使用示例
+
+### 基本操作
+```javascript
+import {xSqlite} from "@/uni_modules/x-sqlite-s"
+
+// 创建数据库实例并配置
+const db = new xSqlite({
+    encryption: true,
+    password: "mypassword",
+    defaultDirectory: "/custom/db/path"
+});
+
+// 创建数据库
+db.createDb("mydb");
+
+// 创建表
+db.createTable("users", {
+    "id": "INTEGER PRIMARY KEY AUTOINCREMENT",
+    "name": "TEXT",
+    "age": "INTEGER"
+});
+
+// 插入数据
+db.insert("users", {
+    name: "张三",
+    age: 25
+});
+
+// 查询数据
+const result = db.query("SELECT * FROM users WHERE age > ?", [20]);
+console.log(result.rows);    // 通过数组下标访问：[[1, "张三", 25], [2, "李四", 30]]
+console.log(result.maps);    // 通过列名访问：[{"id": 1, "name": "张三", "age": 25}, {"id": 2, "name": "李四", "age": 30}]
+```
+
+### 事务使用
+```javascript
+// 开始事务
+db.beginTransaction();
+
+try {
+    db.insert("users", { name: "李四", age: 30 });
+    db.insert("users", { name: "王五", age: 35 });
+    db.commit();
+} catch (e) {
+    db.rollback();
+}
+```
+
+### 批量操作
+```javascript
+const statements = [
+    {
+        sql: "INSERT INTO users (name, age) VALUES (?, ?)",
+        params: ["赵六", 40]
+    },
+    {
+        sql: "UPDATE users SET age = ? WHERE name = ?",
+        params: [45, "张三"]
+    }
+];
+
+db.executeBatch(statements);
+```
+
+### 数据库配置管理
+```javascript
+// 更改数据库存储目录
+db.setDefaultDirectory("/new/db/path");
+
+// 更新数据库密码
+db.setPassword("newpassword");
+
+// 移除数据库密码
+db.setPassword(null);
+```
+
+## 注意事项
+1. 在进行数据库操作前，确保已经成功创建/打开数据库
+2. 使用参数绑定来防止SQL注入
+3. 大量数据操作时建议使用事务
+4. 及时关闭不再使用的数据库连接
+5. 加密数据库需要在创建时指定密码
+
+## 更新日志
+
+### 1.0.7（2026-08-20）
+* 安卓：Statement / Cursor 用后关闭；重复 createDb 先关旧连接；未知绑定类型不再静默跳过。
+* iOS：createDb 返回真实成败；绑定文本使用 SQLITE_TRANSIENT；重复打开先关旧连接。
+* 鸿蒙：查询后关闭 ResultSet；修正文件名重复追加 .db；事务中允许查询。
+* Web：修复事务 / 批量被 isInTransaction 拦截；wasm 脚本只加载一次；saveLocal 成功返回结果。
+### 1.0.6（2026-04-21）
+* 修复安卓错误的宽容性。
+### 1.0.5 (2025-11-26)
+* 安卓端优化了两行代码，删除警告。
+### 1.0.4 (2025-10-24)
+* 鸿蒙端增加了部分函数的路径及文件名校验，防止使用者没有按跨平台规范使用。
+### 1.0.3 (2025-09-03)
+* 适配鸿蒙
+### 1.0.2 (2025-05-18)
+* 修复安卓端执行插入数据时，可能会被执行两次。修复安卓/ios端不能使用应用的uni.env.USER_DATA_PATH目录及自定二级目录，在安卓端执行COUNT(*)时类型转换错误。
+### 1.0.1 (2025-05-05)
+* 修复安卓端执行插入数据时，可能会被执行两次。
+### 1.0.0 (2025-03-15)
+### ✨ 新功能
+- 支持基本的SQLite3数据库操作
+  - 数据库的创建、打开和关闭
+  - 表的创建和删除
+  - 数据的增删改查操作
+- 支持数据库加密功能
+- 支持事务处理
+- 支持批量SQL执行

package/data/tmui4x/10./346/217/222/344/273/266/345/272/223/xSseS SSE/346/216/250/351/200/201.md"

@@ -0,0 +1,127 @@
+# x-sse-s SSE推送
+
+进程级单连接 SSE。`new SSEClientApp()` 只是门面，全局只保持一条活连接；再次 `create` 会断开旧连接，**监听保留**。
+
+**微信小程序没有流式 HTTP，`connect` 会报 1008。** Web / 微信不支持自定义证书，`applyTls` 为空实现。
+
+### 兼容性
+
+| Harmony | IOS | Android | WEB | 小程序 |
+| --- | --- | --- | --- | --- |
+| 支持 | 支持 | 支持 | 支持 | x |
+
+鸿蒙需要 `ohos.permission.INTERNET`。
+
+### 调用
+
+```ts
+import { SSEClientApp, xSSEOptions } from "@/uni_modules/x-sse-s"
+
+const sse = new SSEClientApp()
+
+sse.onMessage((msg: string) => {
+  console.log(msg)
+})
+
+sse.create({
+  method: "get",
+  url: "https://testsse.element-ui-x.com/api/sse",
+  header: {},
+  rejectUnauthorized: true
+} as xSSEOptions)
+
+sse.connect()
+```
+
+构造时传入 `xSSEOptions` 等价于立刻 `create`，兼容旧写法：
+
+```ts
+const sse = new SSEClientApp({
+  method: "post",
+  url: "https://testsse.element-ui-x.com/api/sse",
+  header: { token: "token" }
+})
+sse.setBody({ prompt: "hi" })
+sse.connect()
+```
+
+### 方法
+
+| 名称 | 参数 | 说明 |
+| --- | --- | --- |
+| create | `xSSEOptions` | 配置并替换当前连接，不自动 connect |
+| connect | `headers?` | 连接 SSE；可临时合并 header |
+| setBody | `string \| ArrayBuffer \| UTSJSONObject` | POST 时在 connect 前设置请求体 |
+| disconnect | 无 | 断开，保留监听 |
+| destroy | 无 | 断开并清空监听 |
+| isConnected | 无 | 是否已打开 |
+| getState | 无 | `wait` / `opening` / `open` / `closed` / `error` |
+| applyTls | `SSE_TLS_OPTS` | 写入证书配置，下次 create 生效。Web / 微信空实现 |
+| onOpen / onError / onClosed / onMessage | 回调 | 兼容旧 API，换连接时保留 |
+| addEventListener | `open` / `error` / `closed` / `message` | 返回监听 id；`error` / `message` 的 data 为字符串 |
+| removeEventListener | `id` | 按 id 移除 |
+
+`error` 事件的 data 为 `errCode:errMsg`。`onError` 仍无参，兼容旧代码。
+
+### 证书
+
+Android / iOS / Harmony 从**各端插件资源目录**读取证书，更换后重新打包：
+
+| 平台 | 目录 |
+| --- | --- |
+| Android | `utssdk/app-android/assets/` |
+| iOS | `utssdk/app-ios/Resources/` |
+| Harmony | `utssdk/app-harmony/resources/rawfile/` |
+
+| 字段 | 说明 |
+| --- | --- |
+| certName | CA：`ca.crt` / `ca.pem`。若为 `.p12` 则作为客户端证书 |
+| clientCertName | 客户端证书。Android/iOS 用 p12；Harmony 用 pem |
+| clientKeyName | Harmony mTLS 私钥 pem |
+| certPassword | p12 或私钥密码 |
+| rejectUnauthorized | 默认 `true` |
+| serverName | SNI，默认从 url 解析主机名 |
+
+仓库自带示例 `x-sse-ca.crt`（公共根 CA，文件名避开与其它插件冲突）。私有 CA / mTLS 请替换同名文件或改 `certName` 后重新出包。Web / 微信走系统信任链，自定义证书无效。
+
+### 错误码
+
+| 码 | 含义 |
+| --- | --- |
+| 1001 | 系统错误 |
+| 1002 | 参数错误 |
+| 1005 | 连接超时 |
+| 1008 | 当前平台不支持此协议或证书 |
+| 1010 | 尚未 create |
+| 1011 | 证书加载失败 |
+| 1012 | 证书校验失败 |
+
+### 注意事项
+
+使用前一定要打基座才可用，一定要在页面上先引用，再去打基座。
+如果你 mac 开发，ios 可以不用打基座，能直接使用（但前提是你要配置好原生开发环境，否则一样要打包）。
+如果你是开发安卓，不管是 mac、win 电脑都要打包基座才能使用。
+
+### 版本
+
+版权归 https://xui.tmui.design 你不得修改及二次开发，仅供 TMUI4 会员商用使用。不得转给非 VIP 会员使用，一经查实数倍赔偿，并追究法律责任。
+
+## 更新日志
+
+### 1.1.1（2026-08-16）
+* 鸿蒙禁止 for-in，header 遍历改为 UTSJSONObject.keys
+### 1.1.0（2026-08-16）
+* 改为进程级单连接：再次 create 自动断开旧实例，监听保留
+* 新增 destroy / getState / applyTls / addEventListener；证书从各端资源目录加载
+* 鸿蒙去掉 HAR，改为原生 HTTP 流式 SSE
+* Web GET 改为 fetch，支持自定义 header；微信保持同签名并返回 1008
+### 1.0.3（2026-07-27）
+* 安卓和ios事件移到主线程
+### 1.0.3（2026-06-05）
+* 新增支持post,get请求方法，post时允许使用方法setBody来设置向服务器发送body数据体
+### 1.0.2（2025-07-25）
+* 兼容原生鸿蒙
+### 1.0.1（2025-05-22）
+参数修改，支持header
+### 1.0.0（2025-01-07）
+连接sse服务器

package/data/tmui4x/10./346/217/222/344/273/266/345/272/223/xStartintentS /346/211/223/345/274/200/345/215/217/350/256/256/351/223/276/346/216/245.md"

@@ -0,0 +1,97 @@
+# x-startintent-s 打开协议链接
+
+打开网页、自定义协议和应用链接。参数与回调对齐 DCloud `plus.runtime.openURL` 的 `success / fail / complete`。
+
+成功只表示已经交给系统处理，不代表目标应用一定完成业务。
+
+### 兼容性
+
+| Harmony | iOS | Android | WEB | 微信小程序 |
+| --- | --- | --- | --- | --- |
+| 支持 | 支持 | 支持 | 支持 | 仅 http/https |
+
+### 调用
+
+```ts
+import { startIntent, XStartIntentOptions } from "@/uni_modules/x-startintent-s"
+
+startIntent({
+  url: "https://www.dcloud.io",
+  success: (res) => {
+    console.log(res.errMsg, res.url)
+  },
+  fail: (err) => {
+    console.log(err.errCode, err.errMsg)
+  }
+} as XStartIntentOptions)
+```
+
+检测是否可打开：
+
+```ts
+import { canOpenIntent, XCanOpenIntentOptions } from "@/uni_modules/x-startintent-s"
+
+canOpenIntent({
+  url: "weixin://",
+  success: (res) => {
+    console.log(res.canOpen)
+  }
+} as XCanOpenIntentOptions)
+```
+
+### 方法
+
+| 名称 | 说明 |
+| --- | --- |
+| startIntent | 打开协议链接或应用 |
+| canOpenIntent | 检测当前设备是否能处理该协议 |
+
+### 参数
+
+`XStartIntentOptions`
+
+| 字段 | 说明 | 默认 |
+| --- | --- | --- |
+| url | 要打开的链接。支持 http(s)、tel、mailto、sms、geo、weixin://、alipays://、intent:// 等 | 必填 |
+| packageName | Android 指定包名，显式拉起某个应用 | 空 |
+| success | 成功，`errMsg` 为 `startIntent:ok` | - |
+| fail | 失败 | - |
+| complete | 结束 | - |
+
+没有 scheme 的地址会自动补 `https://`。
+
+### 错误码
+
+| 码 | 含义 |
+| --- | --- |
+| 1001 | 系统错误，或正在打开其它链接 |
+| 1002 | 参数错误，链接为空或无法解析 |
+| 1003 | 无法打开，没有可处理的应用 |
+| 1008 | 当前平台不支持此功能 |
+
+### 平台差异
+
+1. Android 使用 `ACTION_VIEW`；`intent://`、`android-app://` 走 `Intent.parseUri`。Android 11+ 用 `<queries>` 声明常见协议，未声明的自定义协议 `canOpenIntent` 可能为 false，但仍可尝试 `startIntent`。
+2. iOS 使用 `UIApplication.open`。自定义协议要写进 `LSApplicationQueriesSchemes`，否则 `canOpenURL` 会返回 false。
+3. HarmonyOS 先 `openLink`，失败再 `startAbility` + `ohos.want.action.viewData`。
+4. Web 用 `<a>` 打开；自定义协议依赖浏览器和已安装应用。
+5. 微信小程序仅支持 http/https，走 `wx.openUrl`，需要对应权限。
+
+### 版本
+
+版权归 https://xui.tmui.design 你不得修改及二次开发，仅供 TMUI4 会员商用使用。不得转给非 VIP 会员使用，一经查实数倍赔偿，并追究法律责任。
+
+## 更新日志
+
+### 1.1.0（2026-08-20）
+* 改为 DCloud success / fail / complete 风格
+* 新增 startIntent、canOpenIntent，移除旧方法 openWeb
+* 支持自定义协议、Android intent://，去掉鸿蒙远程 HAR 依赖
+### 1.0.3（2025-07-25）
+* 兼容原生鸿蒙
+### 1.0.2（2025-03-15）
+* 兼容ios16+
+### 1.0.1（2025-02-10）
+* 兼容微信
+### 1.0.0（2024-08-24）
+首次发布

package/data/tmui4x/10./346/217/222/344/273/266/345/272/223/xSvgU SVG/347/273/204/344/273/266.md"

@@ -0,0 +1,26 @@
+# x-svg-u SVG组件
+
+### 开发文档
+
+从 1.0.1 开始此组件变更为标准原生组件，使用时，不需要导入组件，可以直接在页面上使用组件，更方便了。 
+
+```vue
+<x-svg-u src="/static/undraw_farming_ni77.svg" :width="100" :height="120" ></x-svg-u>
+```
+
+### 兼容性
+
+| Harmony | IOS | Android | WEB | 小程序 |
+| --- | --- | --- | --- | --- |
+| 支持 | 支持 | 支持 | 支持 | 支持 |
+
+### 注意事项
+
+使用前一定要打基座才可用，一定要在页面上先引用，再去打基座。安卓依赖 `com.caverock:androidsvg:1.4`，不要再往 `libs` 放同名 jar。
+
+## 更新日志
+
+### 1.0.2（2026-08-20）
+* 安卓只走 Maven `androidsvg:1.4`，去掉本地 jar，避免和基座官方依赖重复 class。
+### 1.0.1（2025-07-27）
+* 兼容原生鸿蒙