tmui-cli 2.0.6 → 5.3.1

package/data/uni-app-x-docs/upload-video.md

@@ -0,0 +1,86 @@
+---
+title: tmui 3.2.0 组件库
+---
+
+<script setup>
+import webview from '../components/mobileWebview.vue'
+import headertips from '../components/headertips.vue'
+</script>
+
+<headertips></headertips>
+
+#### 表单组件
+
+# 视频上传 TmUploadVideo
+
+样式丰富塑造性好
+
+## :hot_pepper: 示例
+
+<webview url="https://tmui.design/h5by32/#/pages/index/upload-video"></webview>
+
+::: details 示例模板
+
+<<< ../../../src/pages/index/upload-video.vue{vue}
+
+:::
+
+## :hot_pepper: 兼容性
+
+平台兼容
+|H5|uniAPP|小程序|version|
+|---|---|---|---|
+|☑️|☑️|☑️|☑️|☑️|1.0.0|
+
+## :seedling: 参数
+| 参数名 | 类型 | 默认值 | 描述 |
+| :--: | :--: | :--: | :-- |
+| maxCount | number | 9 | 最大的可上传数量 | 
+| round | string\|number | 10 | 图片项目圆角。 | 
+| url | string | "https://mockapi.eolink.com/LRViGGZ8e6c1e8b4a636cd82bca1eb15d2635ed8c74e774/admin/upload_pic/" | 上传地址 | 
+| name | string | "file" | 上传到服务器的名称字段 | 
+| header | Record\<string, any\> \| null | null | 上传到服务器的头文件 | 
+| formData | Record\<string, any\> \| null | null | 额外的表单数据。 | 
+| imgHeight | string | "110" | 图片高,此处不可使用%单位 | 
+| column | number | 5 | 一行显示几列 | 
+| okFileIsDelete | boolean | true | 上传成功的文件是否允许删除 | 
+| uploadingFileIsDelete | boolean | true | 上传中的文件是否允许删除 | 
+| maxFileSize | number | 1024*1024*30 | 图片上传的限制大小，默认是30mb(可以开启压缩，最后可能比较小) | 
+| maxDuration | number | 30 | 最大拍摄时长不能超过60秒默认建议30秒 | 
+| camera | string | 'back' | 摄像头类型,前置还是后置 | 
+| statusCode | number | 200 | 开发者服务器响应码,默认是200表示上传成功. | 
+| modelValue | Array\<Record\<string, any\> \| string\> | ()=\>[] | 等同v-model | 
+| rangUrl | string | 'url' | 用于回显时,如果你提供的数组数据是对象,需要指定图片的地址.同时该对象数据会被保留到response字段中 | 
+| beforeDel | func\|boolean | true | 图片被删除时触发如果返回Promise\<false\>删除失败否则成功类型null|(index:number,item:XUPLOADFILE_FILE_INFO)=\>Promise\<boolean\> | 
+| beforeComplete | func\|boolean | true | 你需要原路返回参数提供的itemitem可以自行修改响应内容，响应类型这样可以自己根据服务的内容判断是成功还是失败或者没有权限。修改其中的status来达到成功还是失败TMUPLOAD_PHOTO_STATUS | 
+| autoStart | boolean | true | 是否自动上传 | 
+| sourceType | Array\<"album" \| "camera"\> | ()=\>["album","camera"] | 图片来源同官方的sourceType：'album','camera' | 
+| compress | boolean | true | 是否压缩 | 
+| addPos | string | "after" | 添加图片的位置'before'出现在前面'after'出现在后面 | 
+| mode | string | "scaleToFill" | 图片展示的缩放模式同官方. | 
+| sortable | boolean | true | 是否允许长按拖拽排序 | 
+
+
+## :rose: 事件
+| 事件名 | 参数 | 返回数据 | 描述 |
+| --- | --- | --- | --- |
+| complete | 名称：-,列表数据, | - | 每次全部上传完时触发 | 
+| change | 名称：-,列表数据, | - | 变化时触发 | 
+| delete | 名称：-,列表数据, | - | 图片被删除时触发 | 
+| preview | - | - | 点击项目预览视频,有的回显视频可能需要授权播放,返回的可能是个视频图片,因此你需要通过事件自行创建预览窗口. | 
+| update:modelValue | - | - | 同步文件列表。 | 
+
+
+## :corn: slot插槽
+| 插槽名 | 数据 | 描述 |
+| :--: | :--: |  :-- |
+| default | - | - | 
+
+
+## :green_salad: ref方法
+| 方法名 | 参数 | 返回值 | 描述 |
+| :--: | :--: | :--: | :-- |
+| startUpload | - | - | - | 
+| choose | - | - | - | 
+
+

package/data/uni-app-x-docs/uts/README.md

@@ -44,9 +44,9 @@ uts这门语言，有2个用途：
   <thead>
     <tr>
       <th></th>
-      <th colspan="3">uni-app</th>
-      <th colspan="3">uni-app x VDOM模式</th>
-			<th colspan="3">uni-app x 蒸汽模式</th>
+      <th colspan="2">uni-app</th>
+      <th colspan="2">uni-app x VDOM模式</th>
+			<th colspan="2">uni-app x 蒸汽模式</th>
     </tr>
   </thead>
   <tbody>
@@ -88,9 +88,9 @@ uts这门语言，有2个用途：
     </tr>
     <tr>
       <td>HarmonyNext</td>
-      <td>JS</td>
+      <td>JS(jsvm引擎中)</td>
       <td>ets</td>
-      <td>js（运行在ArkTS引擎中）</td>
+      <td>js(ArkTS引擎中)</td>
       <td>ets</td>
 			<td>js（可选择运行在ArkTS或jsvm中）</td>
 			<td>ets</td>
@@ -309,7 +309,7 @@ function test2(arg : boolean) { // 自动推导返回值类型为 number | null
     }
     return null
 }
-function test3(arg : boolean): any { // 暂不支持多个不同类型的返回值推导，需要主动声明为 any
+function test3(arg : boolean): any { // 不支持多个不同类型的返回值推导，需要主动声明为 any
     if (arg) {
         return 1
     }
@@ -446,12 +446,9 @@ uts是全面了解ts、kotlin、swift、ArkTS等不同的语言后，全新设
 
 ## 其他FAQ
 
-- Q：使用uts，万一uts编译器有bug、干坏事，怎么办？
-1. uts发展已经2年了，已经有上千个项目和插件上线，语言虽然还需要继续完善，但本身不存在影响项目发布的bug。
-2. uts编译后的kt、swift代码，都在uni-app x项目的unpackage目录下，开发者都可以看到，可以放心使用。
-
-- Q：uts不如js好用
-1. 我们承认js的灵活和易用在所有编程语言里名列前茅。如果你认为基于js的uni-app已经能满足你的跨平台需求那也很好。如果你追求原生的性能体验，那么选择uts虽然需要一定的学习和适应成本，但我们相信这个成本比任何其他方案都低。
+- Q：使用uts，万一uts编译器有bug、乱埋点，怎么办？
+1. uts从2022年推出，已经有上千个项目和插件上线，语言虽然还需要继续完善，但本身不存在影响项目发布的bug。
+2. uts编译后的kt、swift、ets代码，都在uni-app x项目的unpackage目录下，开发者都可以看到，可以放心使用。
 
 - Q：引用ts/js类型文件时编译器如何处理
 1. 在目标语言非js时，仅可引用ts文件，此时ts文件会当做uts文件处理。

package/data/uni-app-x-docs/uts/_sidebar.md

@@ -54,4 +54,4 @@
 * [关键字](keywords.md)
 * [UTS App插件开发](../plugin/uts-plugin.md)
 * [UTS与TS的差异](uts_diff_ts.md)
-<!-- * [学习资料](learning.md) -->
+* [UTS2JS](uts2js.md)

package/data/uni-app-x-docs/uts/uts2js.md

@@ -0,0 +1,34 @@
+# uts2js
+
+uts在编译运行目标为js时，会通过uts2js来编译。
+
+## uts2js的应用范围
+- web、小程序
+- ios、鸿蒙的非uts插件
+- android蒸汽模式的非uts插件
+
+蒸汽模式支持独立的区分uts、ts、js，但需要指定版本以上：
+- 在HBuilder 5.31 以前，非uts插件，均执行uts2js。
+- 从HBuilder 5.31+，支持独立设置js、ts、uts。独立设置的js将不编译；ts将执行普通的ts编译；主动设置为uts，继续执行uts2js。
+
+从HBuilder 5.31+起，uts2js，主要用于历史代码兼容。新项目推荐使用ts。
+
+## uts2js编译器的功能和特点
+由于运行在js运行时，所以uts2js中，不要求强类型，大多数情况与ts是相同的。
+
+如果开发者写了js，可能会在编译器或IDE静态校验时提示类型错误，但不影响实际运行时表现。
+
+1. 为了拉齐uts编译原生强类型的跨端表现，uts编译后的js，与标准js有略微差异：
+	+ 支持UTSJSONObject。尤其是UTSJSONObject有几个方法，在标准js object中不存在，包括getString、getNumber、getArray。
+	+ type没有擦除而是编译成了class。这也是为了保持和uts2kt、uts2swift一致。
+	+ 把部分js内置API返回值从undefined改为null。因为kt、swift等强类型语言没有undefined概念，为拉齐而反向修改了js端逻辑。以下js内置API在uts2js编译后，会将返回值从undefined改为null：
+		* Array.prototype.pop
+		* Array.prototype.shift
+		* Array.prototype.find
+		* Array.prototype.findLast
+		* Array.prototype.at
+		* Map.prototype.get
+		* WeakMap.prototype.get
+		* String.prototype.at
+		* String.prototype.codePointAt
+2. 编译速度慢于普通ts编译器。

package/data/uni-app-x-docs/vue/README.md

@@ -153,12 +153,12 @@ VDOM模式lang的值域只有uts。Android平台按uts2kt执行，此时要求
 
 如果页面script未设置，则根据全局配置 manifest.json 中 蒸汽模式下 script lang 的默认值来执行。如果未改动manifest默认值，则默认为`ts`。
 
-注意：默认值是 `ts`。不是uni-app默认的`js`，也不是uni-app x VDOM模式默认的`uts`。
+注意：**默认值是 `ts`**。不是uni-app默认的`js`，也不是uni-app x VDOM模式默认的`uts`。
 默认值之所以调整，一是为了方便AI，二是为了提升编译速度。
 
 此时uts、ts、js三者将有不同的编译逻辑，见下。
 
-蒸汽模式下，使用uts、ts，实际也需要经过uts2js、ts2js的编译流程。uts、ts和js的区别：
+蒸汽模式下，使用uts、ts，实际也需要经过[uts2js](../uts/uts2js.md)、ts2js的编译流程。uts、ts和js的区别：
 - js：没有额外的编译流程。编译速度快。
 - ts：需执行ts2js的编译器，类型仅对开发阶段生效，实际运行时会擦除类型。编译速度中。
 - uts：需执行uts2js编译器。编译速度慢。为了拉齐uts编译原生强类型的跨端表现，运行时与标准js有略微差异：
@@ -166,11 +166,29 @@ VDOM模式lang的值域只有uts。Android平台按uts2kt执行，此时要求
 	+ type没有擦除而是编译成了class
 	+ 把部分js内置API返回值从undefined改为null
 
-	不使用uts时，将无法再使用UTSJSONObject，UTSJSONObject变成了普通的object，type会被擦除，运行时内置API被改成`null`的会还原为`undefined`。
+	不使用uts时，将无法再使用UTSJSONObject，UTSJSONObject变成了普通的object，type会被擦除，运行时内置API被改成`null`的会还原为`undefined`。。
 	
-	如果你之前使用过UTSJSONObject的专有方法，比如getString、getNumber、getArray等方法，在5.31+运行，由于默认按ts编译，会造成控制台报警找不到相关类型和方法，此时有如下处理方案：
+	如果你之前使用过UTSJSONObject的专有方法，比如getString、getNumber、getArray等方法，在5.31+运行，由于默认按ts编译，会造成控制台报警找不到相关类型和方法：
+	`getString is not a function`、`getNumber is not a function`、`getArray is not a function`。UTSJSONObject实例方法：`parse`,`get`,`set`,`getAny`,`getBoolean`,`getNumber`,`getString`,`getArray`,`getJSON`,`toMap`。
+	
+	此时有如下处理方案：
 	1. 把相关页面的script的lang，显式指定为uts。
-	2. 把UTSJSONObject的写法，改成普通object写法。
+	2. 把UTSJSONObject的写法，改成普通object写法，即`.`点运算符。（推荐，可以获得更快的编译速度和更好的AI支持度）
+
+	`JSON.parseArray`、`JSON.parseObject`在非uts环境下也无法使用，使用`JSON.parse`方法代替即可。
+
+	undefined转null的js内置API：
+		* Array.prototype.pop
+		* Array.prototype.shift
+		* Array.prototype.find
+		* Array.prototype.findLast
+		* Array.prototype.at
+		* Map.prototype.get
+		* WeakMap.prototype.get
+		* String.prototype.at
+		* String.prototype.codePointAt
+
+5.31+，不同后缀的文件，比如`*.js`、`*.ts`、`*.uts`，互相import的时，都按各自独立的编译器编译。
 
 ### setup
 setup属性声明代表script里的代码为组合式写法，如果没有setup属性则为选项式写法。蒸汽模式只支持setup。

package/data/uni-app-x-docs/vue/built-in.md

@@ -33,7 +33,7 @@
 更新元素的内容，并且不会被解析。
 
 ::: warning 注意
-在 `App-android` 平台，`v-html` 指令通过编译为 [rich-text](../component/rich-text.md) 组件实现。因此，`v-html` 指令的内容必须是 `rich-text` 支持的格式。\
+在 `App-android VDOM 模式`，`v-html` 指令通过编译为 [rich-text](../component/rich-text.md) 组件实现。因此，`v-html` 指令的内容必须是 `rich-text` 支持的格式。\
 同时，受限于 `rich-text` 组件不支持 `class` 样式，`v-html` 指令中同样不支持 `class` 样式。\
 绑定 `v-html` 的标签内的内容会被忽略，`v-html` 指令的内容会编译为 `rich-text` 组件渲染为该标签的子节点。
 :::
@@ -99,7 +99,7 @@
 
 基于原始数据多次渲染元素或模板块。
 
-- 期望的绑定值类型：`Array | UTSJSONObject | number | string | Iterable`
+- 期望的绑定值类型：`Array | Object/UTSJSONObject | number | string | Iterable`
 
 - 详细信息
 
@@ -318,7 +318,8 @@
   当组件的 `selected` 状态改变，默认会重新创建大量的 vnode，尽管绝大部分都跟之前是一模一样的。`v-memo` 用在这里本质上是在说“只有当该项的被选中状态改变时才需要更新”。这使得每个选中状态没有变的项能完全重用之前的 vnode 并跳过差异比较。注意这里 memo 依赖数组中并不需要包含 `item.id`，因为 Vue 也会根据 item 的 `:key` 进行判断。
 
   ::: warning 警告
-  当搭配 `v-for` 使用 `v-memo`，确保两者都绑定在同一个元素上。`v-memo` 不能用在 `v-for` 内部。
+  - 当搭配 `v-for` 使用 `v-memo`，确保两者都绑定在同一个元素上。`v-memo` 不能用在 `v-for` 内部。
+  - `v-memo` 的作用是在 VDOM 模式下缓存虚拟 DOM 子树，在依赖未变化时跳过 vnode 创建和虚拟 DOM diff。蒸汽模式去除了虚拟 DOM，不会创建 vnode，也不需要进行虚拟 DOM diff，因此不支持且不需要使用 `v-memo`。
   :::
 
   `v-memo` 也能被用于在一些默认优化失败的边际情况下，手动避免子组件出现不需要的更新。但是一样的，开发者需要负责指定正确的依赖数组以免跳过必要的更新。
@@ -346,10 +347,6 @@
 - [监听页面生命周期](../component/README.md#监听页面生命周期)
 - [vue 与 uvue 不同文件后缀的优先级](../component/README.md#priority)
 
-::: warning 注意
-- App 端，如需页面级滚动，根节点必须是 `scroll-view` 标签。
-:::
-
 ### \<KeepAlive> @keep-alive
 
 <!-- VUEJSON.keep-alive.description -->

package/data/uni-app-x-docs/vue/component.md

@@ -1,8 +1,6 @@
 # 组件
 
-我们可以对一段要复用的js/uts逻辑代码进行封装，抽出function、module等形式。
-
-那么涉及UI的复用时，该如何抽象？
+我们可以对一段要复用的js/ts/uts逻辑代码进行封装，抽出function、module等形式。那么涉及UI的复用时，该如何抽象？
 
 这就是vue的组件机制，把视图template、script、style都封装到独立的uvue组件文件中，在其他需要的地方使用组件的名称进行引用。
 
@@ -33,7 +31,7 @@ uni-app x 组件基于 vue 单文件组件规范，一个组件内，有 3 个
 
 
 ## 创建及引用组件 @create-and-import-component
-<!-- TODO：此处需要重写 -->
+
 ### 创建组件 @create-component
 
 #### easycom
@@ -56,14 +54,14 @@ uni-app x 项目支持使用 `.vue`、`.uvue` 文件作为组件使用，但同
 
 只要组件安装在项目的 `components` 目录下或 `uni_modules/插件 id/components/插件 id/插件 id.uvue` 目录下，并符合 `组件名称/组件名称.(vue|uvue)` 目录结构。就可以不用引用、注册，直接在页面中使用。
 
-- 比如 [uni-loading](https://ext.dcloud.net.cn/plugin?id=15980)，它导入到项目后，存放在了目录 /uni_modules/uni-loading/components/uni-loading/uni-loading.uvue
+- 比如 [uni-link](https://ext.dcloud.net.cn/plugin?id=27898)，它导入到项目后，存放在了目录 /uni_modules/uni-link-x/components/uni-link/uni-link.uvue
 
-  同时它的组件名称也叫 uni-loading，所以这样的组件，不用在 script 里注册和引用。如下：
+  同时它的组件名称也叫 uni-link，所以这样的组件，不用在 script 里注册和引用。如下：
 
   ```html
   <template>
       <view>
-        <uni-loading></uni-loading><!-- 这里会显示一个loading -->
+        <uni-link></uni-link><!-- 这里会显示一个loading -->
       </view>
     </template>
   <script>
@@ -72,9 +70,9 @@ uni-app x 项目支持使用 `.vue`、`.uvue` 文件作为组件使用，但同
   </script>
   ```
 
-这里出现了`uni_module`的概念，简单说下，它是uni-app的一种包管理方案。
+这里出现了`uni_module`的概念，简单说下，它是uni-app(x)的一种包管理方案。
 
-`uni_module`其实不止服务于组件，它可以容纳组件、script库、页面、项目等所有DCloud插件市场所支持的种类。
+`uni_module`其实不止服务于组件，它可以容纳组件、script库、原生插件、页面、项目等所有DCloud插件市场所支持的种类。
 
 在HBuilderX中点右键可方便的更新插件，插件作者也可以方便的上传插件。
 
@@ -105,7 +103,7 @@ uni_module有详细的专项文档，请另行查阅[uni_module规范](https://u
     <child ref="component1"></child>
   </view>
 </template>
-<script setup lang="uts">
+<script setup>
 // 引入 child 组件
 import child from './child.vue'
 
@@ -199,7 +197,7 @@ const component1 = ref<ComponentPublicInstance | null>(null) // 手动引入组
 
 :::
 
-#### 在 `main.uts` 中使用 `app.config.globalProperties`
+#### 在 `main.uts/ts/js` 中使用 `app.config.globalProperties`
 
 如在 `main.uts` 中的 `createApp` 方法中使用：
 ```ts
@@ -283,7 +281,7 @@ Android VDOM模式是强类型，如果不是内置组件，也不是easycom组
 
 callMethod可用于所有自定义组件，包括easycom组件也可以使用，只不过easycom组件可以直接`.`。
 
-蒸汽模式下不再推荐使用`callMethod`
+蒸汽模式下不再推荐使用`callMethod`，正常的使用`.`操作符访问组件的方法即可。
 
 **语法**
 
@@ -352,7 +350,7 @@ Uni`组件名(驼峰)`Element
 
 ### 组件监听应用、页面生命周期 @component-page-lifecycle
 
-|组件中监听应用生命周期 |Android |Android(Vapor)  |iOS  | iOS(Vapor) |HarmonyOS | HarmonyOS(Vapor) |Web |微信小程序 |
+|组件中监听应用生命周期 |Android(VDOM) |Android(Vapor)  |iOS(VDOM)  | iOS(Vapor) |HarmonyOS(VDOM) | HarmonyOS(Vapor) |Web |微信小程序 |
 |:-:			          |:-:		 |:-:             |:-:  |:-:         |:-:		  |:-:               |:-:	 |:-:		  |
 |onAppShow          |4.11    |5.21            |4.11 |5.21        |4.61     |5.21             |4.11 |4.41     |
 |onAppHide          |4.11    |5.21            |4.11 |5.21        |4.61     |5.21             |4.11 |4.41     |
@@ -372,7 +370,7 @@ Uni`组件名(驼峰)`Element
 
 :::
 
-|组件中监听页面生命周期 |Android |Android(Vapor) |iOS  | iOS(Vapor) |HarmonyOS | HarmonyOS(Vapor) |Web |微信小程序 |
+|组件中监听页面生命周期 |Android(VDOM) |Android(Vapor) |iOS(VDOM)  | iOS(Vapor) |HarmonyOS(VDOM) | HarmonyOS(Vapor) |Web |微信小程序 |
 |:-:			          |:-:		 |:-:             |:-:  |:-:         |:-:		   |:-:               |:-:	|:-:		  |
 |onLoad             |4.11    |5.21            |4.11 |5.21        |4.61     |5.21              |4.11 |4.41     |
 |onPageShow         |4.11    |5.21            |4.11 |5.21        |4.61     |5.21              |4.11 |4.41     |
@@ -411,14 +409,14 @@ Uni`组件名(驼峰)`Element
 
 ## 组件的生命周期 @component-lifecycle
 
-### 组件生命周期（选项式 API）兼容性 @component-lifecycle-options-compatibility
-
-<!-- VUEJSON.options_lifecycle.compatibility -->
-
 ### 组件生命周期（组合式 API）兼容性 @component-lifecycle-composition-compatibility
 
 <!-- VUEJSON.composition_lifecycle.compatibility -->
 
+### 组件生命周期（选项式 API）兼容性 @component-lifecycle-options-compatibility
+
+<!-- VUEJSON.options_lifecycle.compatibility -->
+
 示例 [详情](<!-- VUEJSON.E_lifecycle.component_ChildComponentOptions.gitUrl -->)
 
 ::: preview <!-- VUEJSON.E_lifecycle.component_component-options.webUrl -->
@@ -565,13 +563,13 @@ defineOptions({
 
 ## ref
 
-在 `uni-app js 引擎版`中，非 `Web端` 只能用于获取自定义组件，不能用于获取内置组件实例（如：`view`、`text`）。\
+在 `老uni-app`中，非 `Web端` 只能用于获取自定义组件，不能用于获取内置组件实例（如：`view`、`text`）。\
 在 `uni-app x` 中，内置组件会返回组件根节点的引用，自定义组件会返回组件实例。
 
 **注意事项：**
 - 如果多个节点或自定义组件绑定相同 `ref` 属性，将获取到最后一个节点或组件实例的引用。
 - 在 `v-for` 循环时，绑定 `ref` 属性会获取到节点或组件实例的集合。
-- 在 `uni-app x` 中，要访问 `$refs` 中的属性，需要使用索引方式。
+- 访问 `$refs` 中的属性，Android平台VDOM模式无法使用`.`运算符，需要使用索引方式。
 
 示例 [详情](<!-- VUEJSON.E_component-instance.refs_refs-options.gitUrl -->)
 
@@ -609,7 +607,7 @@ defineOptions({
 
 ## 自定义组件 v-model 绑定复杂表达式 @v-model-complex-expression
 
-自定义组件 `v-model` 绑定复杂表达式时，需要通过 `as` 指定类型(仅App-Android 平台)。
+自定义组件 `v-model` 绑定复杂表达式时，Android平台VDOM模式需要通过 `as` 指定类型。
 
 ::: preview
 

package/data/uni-app-x-docs/vue/composition-api.md

@@ -2,10 +2,10 @@
 
 > `App.uvue` 从HBuilderX 5.0+起支持组合式 API。
 
-::: warning Android注意
-- 暂不支持 `<script setup>` 和 `<script>` 同时使用，如果需要配置 `options` 内容，比如 `name`，可以使用 `defineOptions`。
-- 暂不支持顶层 `await`。
-- 暂不支持 `<script setup>` 配置 `generic` 泛型类型参数。
+::: warning 注意
+- App-Android VDOM 模式和 App 平台蒸汽模式均不支持同时使用 `<script setup>` 和 `<script>`。如需配置 `options` 内容（例如 `name`），可以使用 `defineOptions`。
+- App-Android VDOM 模式、微信小程序 VDOM 模式和 App 平台蒸汽模式均不支持顶层 `await`。
+- App-Android VDOM 模式不支持通过 `<script setup>` 的 `generic` 属性声明泛型类型参数。
 
 :::
 
@@ -107,9 +107,7 @@ watch(
 
   若要避免深层响应式转换，只想保留对这个对象顶层次访问的响应性，请使用 [shallowReactive()](#shallowreactive) 作替代。
 
-::: warning 注意
-- `reactive` 在 App-Android VDOM 模式不支持对 class 做响应式，推荐使用 type 定义存储数据的对象类型。
-:::
+注意： `reactive` 在 App-Android VDOM 模式不支持对 class 做响应式，此时推荐使用 type 定义存储数据的对象类型。
 
 - 示例 [详情](<!-- VUEJSON.E_reactivity.core_reactive_reactive.gitUrl -->)
 
@@ -442,7 +440,7 @@ watch(
 
 ::: warning 注意
 - `getCurrentInstance` 只能在 setup 或生命周期钩子中调用。
-- 在 `app` 端 `proxy` 属性可能为空，需使用 `!` 非空断言操作符。
+- 在 `app` 端 `proxy` 属性可能为空，在uts/ts等涉及类型的语言中需使用 `!` 非空断言操作符。
 :::
 
 ```uts
@@ -771,6 +769,9 @@ const props = withDefaults(defineProps<Props>(), {
 
 ### 与渲染函数一起使用
 
+::: warning 注意
+`render()` 函数仅在 `VDOM 模式`下支持。
+:::
 
 示例 [详情](<!-- VUEJSON.E_render-function.render_render-composition.gitUrl -->)
 

package/data/uni-app-x-docs/vue/data-bind.md

@@ -8,38 +8,19 @@ vue的一大特色，就是可以定义一个响应式变量，通过模板绑
 
 响应式变量被绑定到UI界面后（template和style都可以），
 1. 在逻辑script中修改变量，UI界面会自动更新。省却再编写dom代码操作UI。
-2. 响应式变量有diff更新机制。比如对于一个大列表的UTSJSONObject数据，其中一项变更时，框架底层会自动计算diff，给UI层差量同步数据。这在大多数情况是很好的，但注意diff这个计算过程本身也会增加耗时。
+2. 响应式变量有diff更新机制。比如对于一个大列表数据，其中一项变更时，框架底层会自动计算diff，给UI层差量同步数据。这在大多数情况是很好的，但注意diff这个计算过程本身也会增加耗时。
 
 下面分别讲解各种方式的用法。
 
 ## 声明响应式状态 @declaring-reactive-state
 
-### 选项式 API @options-api
-
-选用选项式 API 时，会用 `data` 选项来声明组件的响应式状态。此选项的值应为返回一个对象的函数。Vue 将在创建新组件实例的时候调用此函数，并将函数返回的对象用响应式系统进行包装。此对象的所有顶层属性都会被代理到组件实例 (即方法和生命周期钩子中的 `this`) 上。
-
-data需要特殊类型时，通过 as 来转换。
-
-如下示例中，
-- 首先在data的return中定义了响应式变量：str、num、arr，并赋值了初始值。
-- 第2步在模板template中通过`{{}}`的方式绑定和显示在text组件的内容区中。即右边预览区显示的3行内容，显示了3个响应式变量的初始值。
-- 第3步点击按钮“update data”，触发`updateData()`，在这个方法里通过`this.`来访问响应式变量，给它们重新赋值。然后界面上3行内容会被自动更新为新值。
-
-示例 [详情](<!-- VUEJSON.E_component-instance.data_data-options.gitUrl -->)
-
-::: preview <!-- VUEJSON.E_component-instance.data_data-options.webUrl -->
-<!-- VUEJSON.E_component-instance.data_data-options.code -->
-:::
-
-data中的响应式变量，如需在script中使用，需通过 `this.xx` 的方式，比如上述的`this.str`。
-
 ### 组合式 API @composition-api
 
 组合式 API 没有 data 这种选项，而是通过 `ref`、`reactive` 方法来声明组件的响应式状态。
 
 这种定义方式更加灵活和简洁。
 
-建议把 `ref` 定义都写在开头，否则到处都写也不好找。
+建议把 `ref` 定义都写在开头，方便统一管理。
 
 示例 [详情](<!-- VUEJSON.E_component-instance.data_data-composition.gitUrl -->)
 
@@ -51,13 +32,13 @@ data中的响应式变量，如需在script中使用，需通过 `this.xx` 的
 
 使用 `ref()` 函数来定义一个响应式变量。
 
-需要给 `ref` 标注类型时，可通过泛型的写法，如：`ref<string>()`， 或使用 `as` 的写法。
+需要给 `ref` 标注类型时，在uts/ts中可通过泛型的写法，如：`ref<string>()`， 或使用 `as` 的写法。
 
-当然 uts 有一定的自动推导能力，对于特别简单的布尔值/数字/字符串的字面量，不写泛型或as，也可以自动推导类型。
+当然 uts/ts 有一定的自动推导能力，对于特别简单的布尔值/数字/字符串的字面量，不写泛型或as，也可以自动推导类型。
 
 `ref()` 接收参数，并将其包裹在一个带有 `.value` 属性的 `ref` 对象中返回。这个对象，
 
-- 在 uts 中取值时，需要使用 `.value`属性。
+- ref定义的响应式变量，在script代码中取值时，需要使用 `.value`属性。
 - 而在模板中使用 ref 时，不需要附加 `.value`（为了方便起见，在模板中使用时，ref 会自动解包，这样模板里的写法和选项式保持了一致）。
 
 如下示例中，
@@ -65,7 +46,7 @@ data中的响应式变量，如需在script中使用，需通过 `this.xx` 的
 - 通过ref定义了3个响应式变量：count1、count2、counter（注意是小写），并赋值了初始值。
 - 在模板template中通过`{{}}`的方式绑定和显示在text组件的内容区中。即右边预览区显示的3行内容，显示了3个响应式变量的初始值。
 - 点击按钮“increment”，触发`increment()`，在这个方法里通过`.value`属性给响应式变量自增。然后界面上3行内容会被自动更新为新值。
-<!-- TODO 为什么加2 -->
+
 示例 [详情](<!-- VUEJSON.E_reactivity.core_ref_ref.gitUrl -->)
 
 ::: preview <!-- VUEJSON.E_reactivity.core_ref_ref.webUrl -->
@@ -100,6 +81,28 @@ data中的响应式变量，如需在script中使用，需通过 `this.xx` 的
 <!-- VUEJSON.E_component-instance.define-expose_define-expose.code -->
 :::
 
+
+### 选项式 API @options-api
+
+选用选项式 API 时，会用 `data` 选项来声明组件的响应式状态。此选项的值应为返回一个对象的函数。
+Vue 将在创建新组件实例的时候调用此函数，并将函数返回的对象用响应式系统进行包装。此对象的所有顶层属性都会被代理到组件实例 (即方法和生命周期钩子中的 `this`) 上。
+
+data需要特殊类型时，通过 as 来转换。
+
+如下示例中，
+- 首先在data的return中定义了响应式变量：str、num、arr，并赋值了初始值。
+- 第2步在模板template中通过`{{}}`的方式绑定和显示在text组件的内容区中。即右边预览区显示的3行内容，显示了3个响应式变量的初始值。
+- 第3步点击按钮“update data”，触发`updateData()`，在这个方法里通过`this.`来访问响应式变量，给它们重新赋值。然后界面上3行内容会被自动更新为新值。
+
+示例 [详情](<!-- VUEJSON.E_component-instance.data_data-options.gitUrl -->)
+
+::: preview <!-- VUEJSON.E_component-instance.data_data-options.webUrl -->
+<!-- VUEJSON.E_component-instance.data_data-options.code -->
+:::
+
+data中的响应式变量，如需在script中使用，需通过 `this.xx` 的方式，比如上述的`this.str`。
+
+
 ## 绑定变量 @bind-data
 
 ### 在模板里绑定 @bind-template-data
@@ -134,9 +137,9 @@ data中的响应式变量，如需在script中使用，需通过 `this.xx` 的
 
 单文件组件的 `<style>` 标签支持使用 `v-bind` CSS 函数将 CSS 的值链接到动态的组件状态
 
-这个语法同样也适用于 `<script setup>`，且支持 UTS 表达式 (需要用引号包裹起来)
+这个语法同样也适用于 `<script setup>`，且支持表达式 (需要用引号包裹起来)
 
-`v-bind` 也可在样式中使用，可以很方便的在 uts 中改变样式，如下所示：
+`v-bind` 也可在样式中使用，可以很方便的在 script 中改变样式，如下所示：
 
 示例 [详情](<!-- VUEJSON.E_directive.v-bind_v-bind-options.gitUrl -->)
 
@@ -152,7 +155,7 @@ data中的响应式变量，如需在script中使用，需通过 `this.xx` 的
 ## 定义方法 @methods
 
 使用选项式 API 时可以在 `methods` 选项中定义方法，这些方法可以在模板中使用\
-而使用组合式 API 时，可以直接在 `<script setup lang="uts">` 中定义方法
+而使用组合式 API 时，可以直接在 `<script setup>` 中定义方法
 
 定义方法之后，可以传递给子组件，子组件使用 `emit` 调用，也可以在 `script` 中直接使用
 

package/data/uni-app-x-docs/web/README.md

@@ -9,7 +9,7 @@
 web版默认有页面滚动；app平台vdom模式时没有页面滚动，但蒸汽模式时已经支持页面滚动了。所以从蒸汽开始，这点平台差异不再存在。
 
 - 与老uni-app x相比，uni-app x 编译到web平台时，有几处不同：
-1. 如果使用uts代码，会走uts2js逻辑，会注入UTSJSONObject。如果使用ts/js则无法使用UTSJSONObject。
+1. 如果使用uts代码，会走[uts2js](../uts/uts2js.md)逻辑，会注入UTSJSONObject。如果使用ts/js则无法使用UTSJSONObject。
 2. 重置了css，拉齐App布局引擎，比如统一使用flex布局。详见[css重置](../css/README.md#css-reset)
 
 ## web运行失败注意事项@faq
@@ -162,15 +162,11 @@ position: fixed定位时，web端为相对于整个浏览器页面进行定位
   height: 100px;
   background-color: #FF0000;
   left: 10px;
-  /* #ifdef WEB */
   /*
    * HBuilderX 4.52之前只能使用--window-top，不可使用--uni-safe-area-inset-top
+	 * App端蒸汽模式5.31+起支持calc
    */
   top: calc(--uni-safe-area-inset-top + 10px);
-  /* #endif */
-  /* #ifdef APP */
-  top: 10px;  /* App端暂不支持calc */
-  /* #endif */
 }
 ```
 

package/data/uni-app-x-docs//346/250/241/346/235/277.md

@@ -0,0 +1,47 @@
+---
+title: tmui 3.0 组件库
+---
+
+<script setup>
+import webview from '../components/mobileWebview.vue'
+</script>
+
+#### 组件库文档 tmui.design
+
+# 应用节点 App
+这是所有页面的根节点，请务必在创建页面是把它作为页面的根节点。以后可扩展性非常强。
+
+---
+
+## :hot_pepper: 示例
+
+<webview url="https://tmui.design/h5/#/pages/changyong/button"></webview>
+
+::: details 示例模板
+
+<!-- <<< ../src/pages/changyong/button.nvue{vue} -->
+
+:::
+
+## :hot_pepper: 兼容性
+
+| APP-VUE | APP-NVUE | 小程序 | WEB/H5 | VUE3/TS |
+| --- | --- | --- | --- | --- |
+| :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: |
+
+## :seedling: 参数
+本组件含有公共属性 [公共属性](/spec/组件公共样式.html)
+| 参数名 | 类型 | 默认值 | 描述 |
+| :--: | :--: | :--: | :-- |
+
+## :rose: 事件
+| 事件名 | 参数 | 返回数据 | 描述 |
+| --- | --- | --- | --- |
+
+## :corn: slot插槽
+默认default
+
+## :green_salad: ref方法
+| 方法名 | 参数 | 返回值 | 描述 |
+| :--: | :--: | :--: | :-- |
+