tmui-cli 5.3.1 → 5.3.3

package/data/uniappx/api/uniresizeobserver.md

@@ -0,0 +1,225 @@
+## UniResizeObserver
+
+用于监视 UniElement 元素的大小变化。它可以观察一个或多个
+
+### UniResizeObserver 兼容性  
+ | Web | 微信小程序 | 支付宝小程序 | Android | iOS | HarmonyOS |
+| :- | :- | :- | :- | :- | :- |
+| 4.16 | x | x | 4.13 | 4.18 | 4.61 |
+
+小程序自身未提供ResizeObserver。社区有三方库可模拟实现，虽性能不及原生ResizeObserver，但在需要时也可以使用。参考[lime-resize](https://ext.dcloud.net.cn/plugin?id=14117)
+
+### 构造函数
+| 名称 | 类型 | 必备 | 描述 |
+| :- | :- | :- | :- |
+| callback | (entries: Array<UniResizeObserverEntry>) => void | 是 | 每当监视的元素调整大小时，回调该函数 |
+
+### 构造函数
+| 名称 | 类型 | 必备 | 描述 |
+| :- | :- | :- | :- |
+| callback | (entries: Array<UniResizeObserverEntry>, observer: UniResizeObserver) => void | 是 | 每当监视的元素调整大小时，回调该函数 |
+
+### UniResizeObserver 的方法 @uniresizeobserver-methods
+
+### 示例 
+ 示例为[hello uni-app x alpha分支](https://gitcode.com/dcloud/hello-uni-app-x/blob/prod_alpha/pages/API/uni-resize-observer/uni-resize-observer.uvue)，与最新HBuilderX Alpha版同步。与最新正式版同步的master分支示例[另见](https://gitcode.com/dcloud/hello-uni-app-x/blob/master//pages/API/uni-resize-observer/uni-resize-observer.uvue) 
+::: preview https://hellouniappx.dcloud.net.cn/web/#/pages/API/uni-resize-observer/uni-resize-observer
+
+> appRedirect https://hellouniappx.dcloud.net.cn/appredirect.html?path=pages/API/uni-resize-observer/uni-resize-observer
+
+>示例
+```vue
+<template>
+    <view style="padding-bottom: var(--uni-safe-area-inset-bottom);">
+      <page-intro content="本页演示 uni.createResizeObserver：监听元素尺寸变化，回调中可获取 contentRect（x、y、width、height）。含 view 嵌套、text、image、scroll-view 等组件的监听示例；可点击方块改宽高、改变字体/图片/scroll-view 尺寸，支持停止/恢复监听、隐藏/显示元素。"></page-intro>
+      <view class="section-heading">
+        <text class="section-title">基础监听</text>
+        <text class="section-caption">点击蓝色或红色方块，观察对应元素的尺寸变化</text>
+      </view>
+      <view v-show="boxDisplay" class="box-stage">
+        <view
+          style="width: 140px; height: 140px; background-color: blue; align-items: center; justify-content: center; padding: 5px;"
+          id="outBox" @click="outBoxClick">
+          <view style="width: 80px; height: 80px; background-color: red; padding: 5px;" id="innerBox"
+            @click="innerBoxClick"></view>
+        </view>
+      </view>
+      <view class="action-grid">
+        <button class="action-grid-button" @click="revertBoxSize">还原尺寸</button>
+        <button class="action-grid-button" @click="toggleDisplay">{{boxDisplay? '隐藏元素': '显示元素'}}</button>
+        <button class="action-grid-button" @click='cancelListen'>停止监听</button>
+        <button class="action-grid-button" @click='goOnListen'>恢复监听</button>
+      </view>
+      <view class="result-grid">
+        <view class="result-card accent-blue">
+          <text class="result-title">蓝色外层元素</text>
+          <text class="result-summary">{{outBoxSizeInfo ? outBoxSummary : '等待首次回调...'}}</text>
+          <text class="result-detail">{{outBoxSizeInfo}}</text>
+        </view>
+        <view class="result-card accent-red">
+          <text class="result-title">红色内层元素</text>
+          <text class="result-summary">{{innerBoxSizeInfo ? innerBoxSummary : '等待首次回调...'}}</text>
+          <text class="result-detail">{{innerBoxSizeInfo}}</text>
+        </view>
+      </view>
+
+      
+      <view class="uni-common-mt" v-show="textImageScrollViewDisplay">
+        <view class="section-heading"><text class="section-title">Text 组件</text></view>
+        <text class="uni-tips">说明：左边是正常版本，右边是拍平版本</text>
+        <view class="flat-compare-row">
+          <text id="testText" class="flat-compare-item" :style="{fontSize: textFontSize + 'px', color: '#333'}">普通文本</text>
+          <text id="testTextFlat" class="flat-compare-item" :style="{fontSize: textFontSize + 'px', color: '#333'}" flatten>拍平文本</text>
+        </view>
+        <button @click="changeTextSize">改变文本字体大小</button>
+        <view class="result-grid">
+          <view class="result-card"><text class="result-title">正常</text><text class="result-summary">{{infoSummary(data.textSizeInfoObj)}}</text><text class="result-detail">{{data.textSizeInfo}}</text></view>
+          <view class="result-card"><text class="result-title">拍平</text><text class="result-summary">{{infoSummary(data.textFlatSizeInfoObj)}}</text><text class="result-detail">{{data.textFlatSizeInfo}}</text></view>
+        </view>
+      </view>
+
+      
+      <view class="uni-common-mt" v-show="flatDisplay">
+        <view class="section-heading"><text class="section-title">View 组件</text></view>
+        <view class="flat-compare-row">
+          <view id="testViewNormal" class="flat-compare-item" style="background-color: #409eff;" :style="{width: viewFlatWidth + 'px', height: viewFlatHeight + 'px'}"></view>
+          <view id="testViewFlat" class="flat-compare-item" style="background-color: #3cb371;" :style="{width: viewFlatWidth + 'px', height: viewFlatHeight + 'px'}" flatten></view>
+        </view>
+        <button @click="changeViewFlatSize">改变 view 尺寸</button>
+        <view class="result-grid">
+          <view class="result-card"><text class="result-title">正常</text><text class="result-summary">{{infoSummary(data.viewNormalSizeInfoObj)}}</text><text class="result-detail">{{data.viewNormalSizeInfo}}</text></view>
+          <view class="result-card"><text class="result-title">拍平</text><text class="result-summary">{{infoSummary(data.viewFlatSizeInfoObj)}}</text><text class="result-detail">{{data.viewFlatSizeInfo}}</text></view>
+        </view>
+      </view>
+
+      
+      <view class="uni-common-mt" v-show="textImageScrollViewDisplay">
+        <view class="section-heading"><text class="section-title">Image 组件</text></view>
+        <view class="flat-compare-row">
+          <image id="testImage" class="flat-compare-item" :style="{width: imageWidth + 'px', height: imageHeight + 'px'}" src="/static/test-image/logo.png" mode="aspectFit"></image>
+          <image id="testImageFlat" class="flat-compare-item" :style="{width: imageWidth + 'px', height: imageHeight + 'px'}" src="/static/test-image/logo.png" mode="aspectFit" flatten></image>
+        </view>
+        <button @click="changeImageSize">改变图片尺寸</button>
+        <view class="result-grid">
+          <view class="result-card"><text class="result-title">正常</text><text class="result-summary">{{infoSummary(data.imageSizeInfoObj)}}</text><text class="result-detail">{{data.imageSizeInfo}}</text></view>
+          <view class="result-card"><text class="result-title">拍平</text><text class="result-summary">{{infoSummary(data.imageFlatSizeInfoObj)}}</text><text class="result-detail">{{data.imageFlatSizeInfo}}</text></view>
+        </view>
+      </view>
+
+      
+      <view class="uni-common-mt" v-show="textImageScrollViewDisplay">
+        <view class="section-heading"><text class="section-title">Scroll-view 组件</text><text class="section-caption">监听滚动容器尺寸</text></view>
+        <scroll-view id="testScrollView" :style="{width: scrollViewWidth + 'px', height: '100px', border: '1px solid #ccc'}" >
+          <view style="padding: 10px;">
+            <text>这是 scroll-view 内的内容</text>
+            <text v-for="i in 10" :key="i">第 {{i}} 行内容</text>
+          </view>
+        </scroll-view>
+        <button @click="changeScrollViewSize">改变 scroll-view 宽度</button>
+        <view class="result-card"><text class="result-summary">{{infoSummary(data.scrollViewSizeInfoObj)}}</text><text class="result-detail">{{data.scrollViewSizeInfo}}</text></view>
+      </view>
+    </view>
+</template>
+
+
+
+<style>
+  .section-heading {
+    margin-top: 18px;
+    margin-bottom: 10px;
+  }
+
+  .section-title {
+    font-size: 18px;
+    font-weight: bold;
+    color: #1f2937;
+  }
+
+  .section-caption {
+    margin-top: 3px;
+    font-size: 12px;
+    color: #6b7280;
+  }
+
+  .box-stage {
+    min-height: 170px;
+    align-items: center;
+    justify-content: center;
+    margin: 10px 0;
+    background-color: #f5f7fa;
+    border-radius: 8px;
+  }
+
+  .action-grid {
+    flex-direction: row;
+    flex-wrap: wrap;
+    justify-content: space-between;
+  }
+
+  .action-grid-button {
+    width: 48%;
+    margin-bottom: 8px;
+  }
+
+  .result-grid {
+    flex-direction: row;
+    align-items: stretch;
+    justify-content: space-between;
+    margin-top: 8px;
+  }
+
+  .result-card {
+    flex: 1;
+    min-width: 0;
+    margin: 0 4px 8px 0;
+    padding: 10px;
+    background-color: #f8fafc;
+    border-radius: 6px;
+    border: 1px solid #e5e7eb;
+  }
+
+  .accent-blue {
+    border-left-width: 4px;
+    border-left-color: #409eff;
+  }
+
+  .accent-red {
+    border-left-width: 4px;
+    border-left-color: #ef4444;
+  }
+
+  .result-title {
+    font-size: 14px;
+    font-weight: bold;
+    color: #374151;
+  }
+
+  .result-summary {
+    margin-top: 5px;
+    font-size: 14px;
+    color: #111827;
+  }
+
+  .result-detail {
+    margin-top: 6px;
+    font-size: 11px;
+    line-height: 17px;
+    color: #6b7280;
+  }
+
+  .flat-compare-row {
+    flex-direction: row;
+    justify-content: space-around;
+    align-items: center;
+    min-height: 110px;
+    margin: 10px 0 6px;
+    background-color: #f5f7fa;
+    border-radius: 8px;
+  }
+
+  .flat-compare-item {
+    margin: 0 5px;
+  }
+</style>
+
+```

package/data/uniappx/api/upload-file.md

@@ -1,9 +1,9 @@
 ::: sourceCode
 ## uni.uploadFile(options) @uploadfile
 
-> GitCode: https://gitcode.com/dcloud/uni-api/tree/alpha/uni_modules/uni-network
+> GitCode: https://gitcode.com/dcloud/uni-app/tree/uni-app-x-alpha/src/uni_modules/uni-network
 
-> GitHub: https://github.com/dcloudio/uni-api/tree/alpha/uni_modules/uni-network
+> GitHub: https://github.com/dcloudio/uni-app/tree/uni-app-x-alpha/src/uni_modules/uni-network
 
 将本地资源上传到开发者服务器。
 

package/data/uniappx/api/vibrate.md

@@ -1,50 +1,54 @@
 ::: sourceCode
 ## uni.vibrateShort(options) @vibrateshort
 
+> GitCode: https://gitcode.com/dcloud/uni-app/tree/uni-app-x-alpha/src/uni_modules/uni-vibrate
+
+> GitHub: https://github.com/dcloudio/uni-app/tree/uni-app-x-alpha/src/uni_modules/uni-vibrate
+
 使设备发生短时间的振动。
 
 ### vibrateShort 兼容性  
 | Web | 微信小程序 | 支付宝小程序 | Android | iOS | HarmonyOS |
 | :- | :- | :- | :- | :- | :- |
-| <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | 4.41 | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | 5.08 | 5.08 | 5.08 |
+| <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | 4.41 | 5.31 | 5.08 | 5.08 | 5.08 |
 
 ### 参数 
 
 | 名称 | 类型 | 必填 | 兼容性 |
 | :- | :- | :- |  :-: |
-| options | **VibrateShortOptions** | 是 | Web x / 支付宝小程序 x（部分支持，见上） |
+| options | **VibrateShortOptions** | 是 | Web x（部分支持，见上） |
 | 名称 | 类型 | 必备 | 兼容性 |
 | :- | :- | :- |  :-: |
-| type | string | 是 | Web x / 支付宝小程序 x（部分支持，见上） |
+| type | string | 是 | Web x（部分支持，见上） |
 @@| 合法值 | 兼容性 |
 @@| :- |  :-: |
-@@| "heavy" | Web x / 支付宝小程序 x（部分支持，见上） |
-@@| "medium" | Web x / 支付宝小程序 x（部分支持，见上） |
-@@| "light" | Web x / 支付宝小程序 x（部分支持，见上） |
-| success | (result: [VibrateShortSuccess](#vibrateshortsuccess-values)) => void | 否 | Web x / 支付宝小程序 x（部分支持，见上） |
-| fail | (result: [VibrateShortFail](#vibrateshortfail-values)) => void | 否 | Web x / 支付宝小程序 x（部分支持，见上） |
-| complete | (result: [VibrateShortSuccess](#vibrateshortsuccess-values) \| [VibrateShortFail](#vibrateshortfail-values)) => void | 否 | Web x / 支付宝小程序 x（部分支持，见上） | 
+@@| "heavy" | Web x（部分支持，见上） |
+@@| "medium" | Web x（部分支持，见上） |
+@@| "light" | Web x（部分支持，见上） |
+| success | (result: [VibrateShortSuccess](#vibrateshortsuccess-values)) => void | 否 | Web x（部分支持，见上） |
+| fail | (result: [VibrateShortFail](#vibrateshortfail-values)) => void | 否 | Web x（部分支持，见上） |
+| complete | (result: [VibrateShortSuccess](#vibrateshortsuccess-values) \| [VibrateShortFail](#vibrateshortfail-values)) => void | 否 | Web x（部分支持，见上） | 
 
 #### VibrateShortSuccess 的属性值 @vibrateshortsuccess-values 
 
 | 名称 | 类型 | 必备 | 兼容性 |
 | :- | :- | :- |  :-: |
-| errMsg | string | 是 | Web x / 支付宝小程序 x（部分支持，见上） |
+| errMsg | string | 是 | Web x（部分支持，见上） |
 
 #### VibrateShortFail 的属性值 @vibrateshortfail-values 
 
 | 名称 | 类型 | 必备 | 兼容性 | 描述 |
 | :- | :- | :- |  :-: | :- |
-| errCode | number | 是 | Web x / 支付宝小程序 x（部分支持，见上） |  |
+| errCode | number | 是 | Web x（部分支持，见上） |  |
 | 合法值 | 兼容性 |
 | :- |  :-: |
-| 9001001 | Web x / 支付宝小程序 x（部分支持，见上） |
-| 9001002 | Web x / 支付宝小程序 x（部分支持，见上） |
-| 9001003 | Web x / 支付宝小程序 x（部分支持，见上） |
-| errSubject | string | 是 | Web x / 支付宝小程序 x（部分支持，见上） | 统一错误主题（模块）名称 |
-| data | any | 否 | Web x / 支付宝小程序 x（部分支持，见上） | 错误信息中包含的数据 |
+| 9001001 | Web x（部分支持，见上） |
+| 9001002 | Web x（部分支持，见上） |
+| 9001003 | Web x（部分支持，见上） |
+| errSubject | string | 是 | Web x（部分支持，见上） | 统一错误主题（模块）名称 |
+| data | any | 否 | Web x（部分支持，见上） | 错误信息中包含的数据 |
 | cause | Error | 否 |   | 源错误信息，可以包含多个错误，详见SourceError |
-| errMsg | string | 是 | Web x / 支付宝小程序 x（部分支持，见上） |  |
+| errMsg | string | 是 | Web x（部分支持，见上） |  |
 
 ### 参见
 - [相关 Bug](https://issues.dcloud.net.cn/?mid=api.device.vibrate.vibrateShort)
@@ -64,44 +68,48 @@
 ::: sourceCode
 ## uni.vibrateLong(options) @vibratelong
 
+> GitCode: https://gitcode.com/dcloud/uni-app/tree/uni-app-x-alpha/src/uni_modules/uni-vibrate
+
+> GitHub: https://github.com/dcloudio/uni-app/tree/uni-app-x-alpha/src/uni_modules/uni-vibrate
+
 使设备发生长时间的振动。
 
 ### vibrateLong 兼容性  
 | Web | 微信小程序 | 支付宝小程序 | Android | iOS | HarmonyOS |
 | :- | :- | :- | :- | :- | :- |
-| <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | 4.41 | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | 5.08 | 5.08 | 5.08 |
+| <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | 4.41 | 5.31 | 5.08 | 5.08 | 5.08 |
 
 ### 参数 
 
 | 名称 | 类型 | 必填 | 兼容性 |
 | :- | :- | :- |  :-: |
-| options | **VibrateLongOptions** | 是 | Web x / 支付宝小程序 x（部分支持，见上） |
+| options | **VibrateLongOptions** | 是 | Web x（部分支持，见上） |
 | 名称 | 类型 | 必备 | 兼容性 |
 | :- | :- | :- |  :-: |
-| success | (result: [VibrateLongSuccess](#vibratelongsuccess-values)) => void | 否 | Web x / 支付宝小程序 x（部分支持，见上） |
-| fail | (result: [VibrateLongFail](#vibratelongfail-values)) => void | 否 | Web x / 支付宝小程序 x（部分支持，见上） |
-| complete | (result: [VibrateLongSuccess](#vibratelongsuccess-values) \| [VibrateLongFail](#vibratelongfail-values)) => void | 否 | Web x / 支付宝小程序 x（部分支持，见上） | 
+| success | (result: [VibrateLongSuccess](#vibratelongsuccess-values)) => void | 否 | Web x（部分支持，见上） |
+| fail | (result: [VibrateLongFail](#vibratelongfail-values)) => void | 否 | Web x（部分支持，见上） |
+| complete | (result: [VibrateLongSuccess](#vibratelongsuccess-values) \| [VibrateLongFail](#vibratelongfail-values)) => void | 否 | Web x（部分支持，见上） | 
 
 #### VibrateLongSuccess 的属性值 @vibratelongsuccess-values 
 
 | 名称 | 类型 | 必备 | 兼容性 |
 | :- | :- | :- |  :-: |
-| errMsg | string | 是 | Web x / 支付宝小程序 x（部分支持，见上） |
+| errMsg | string | 是 | Web x（部分支持，见上） |
 
 #### VibrateLongFail 的属性值 @vibratelongfail-values 
 
 | 名称 | 类型 | 必备 | 兼容性 | 描述 |
 | :- | :- | :- |  :-: | :- |
-| errCode | number | 是 | Web x / 支付宝小程序 x（部分支持，见上） |  |
+| errCode | number | 是 | Web x（部分支持，见上） |  |
 | 合法值 | 兼容性 |
 | :- |  :-: |
-| 9001001 | Web x / 支付宝小程序 x（部分支持，见上） |
-| 9001002 | Web x / 支付宝小程序 x（部分支持，见上） |
-| 9001003 | Web x / 支付宝小程序 x（部分支持，见上） |
-| errSubject | string | 是 | Web x / 支付宝小程序 x（部分支持，见上） | 统一错误主题（模块）名称 |
-| data | any | 否 | Web x / 支付宝小程序 x（部分支持，见上） | 错误信息中包含的数据 |
+| 9001001 | Web x（部分支持，见上） |
+| 9001002 | Web x（部分支持，见上） |
+| 9001003 | Web x（部分支持，见上） |
+| errSubject | string | 是 | Web x（部分支持，见上） | 统一错误主题（模块）名称 |
+| data | any | 否 | Web x（部分支持，见上） | 错误信息中包含的数据 |
 | cause | Error | 否 |   | 源错误信息，可以包含多个错误，详见SourceError |
-| errMsg | string | 是 | Web x / 支付宝小程序 x（部分支持，见上） |  |
+| errMsg | string | 是 | Web x（部分支持，见上） |  |
 
 ### 参见
 - [相关 Bug](https://issues.dcloud.net.cn/?mid=api.device.vibrate.vibrateLong)

package/data/uniappx/api/virtual-payment.md

@@ -28,9 +28,9 @@
 ::: sourceCode
 ## uni.requestVirtualPayment(options) @requestvirtualpayment
 
-> GitCode: https://gitcode.com/dcloud/uni-api/tree/alpha/uni_modules/uni-virtualPayment
+> GitCode: https://gitcode.com/dcloud/uni-app/tree/uni-app-x-alpha/src/uni_modules/uni-virtualPayment
 
-> GitHub: https://github.com/dcloudio/uni-api/tree/alpha/uni_modules/uni-virtualPayment
+> GitHub: https://github.com/dcloudio/uni-app/tree/uni-app-x-alpha/src/uni_modules/uni-virtualPayment
 
 请求支付
 

package/data/uniappx/api/websocket.md

@@ -7,9 +7,9 @@
 ::: sourceCode
 ## uni.connectSocket(options) @connectsocket
 
-> GitCode: https://gitcode.com/dcloud/uni-api/tree/alpha/uni_modules/uni-websocket
+> GitCode: https://gitcode.com/dcloud/uni-app/tree/uni-app-x-alpha/src/uni_modules/uni-websocket
 
-> GitHub: https://github.com/dcloudio/uni-api/tree/alpha/uni_modules/uni-websocket
+> GitHub: https://github.com/dcloudio/uni-app/tree/uni-app-x-alpha/src/uni_modules/uni-websocket
 
 创建一个 WebSocket 连接。
 
@@ -202,9 +202,9 @@ onMessage
 ::: sourceCode
 ## uni.~~onSocketOpen(options)~~ @onsocketopen
 
-> GitCode: https://gitcode.com/dcloud/uni-api/tree/alpha/uni_modules/uni-websocket
+> GitCode: https://gitcode.com/dcloud/uni-app/tree/uni-app-x-alpha/src/uni_modules/uni-websocket
 
-> GitHub: https://github.com/dcloudio/uni-api/tree/alpha/uni_modules/uni-websocket
+> GitHub: https://github.com/dcloudio/uni-app/tree/uni-app-x-alpha/src/uni_modules/uni-websocket
 
 监听WebSocket连接打开事件。  **已废弃，使用 SocketTask 的 onOpen 替换。**
 
@@ -243,9 +243,9 @@ onMessage
 ::: sourceCode
 ## uni.~~onSocketError(callback)~~ @onsocketerror
 
-> GitCode: https://gitcode.com/dcloud/uni-api/tree/alpha/uni_modules/uni-websocket
+> GitCode: https://gitcode.com/dcloud/uni-app/tree/uni-app-x-alpha/src/uni_modules/uni-websocket
 
-> GitHub: https://github.com/dcloudio/uni-api/tree/alpha/uni_modules/uni-websocket
+> GitHub: https://github.com/dcloudio/uni-app/tree/uni-app-x-alpha/src/uni_modules/uni-websocket
 
 监听WebSocket错误。  **已废弃，使用 SocketTask 的 onError 替换。**
 
@@ -284,9 +284,9 @@ onMessage
 ::: sourceCode
 ## uni.~~sendSocketMessage(options)~~ @sendsocketmessage
 
-> GitCode: https://gitcode.com/dcloud/uni-api/tree/alpha/uni_modules/uni-websocket
+> GitCode: https://gitcode.com/dcloud/uni-app/tree/uni-app-x-alpha/src/uni_modules/uni-websocket
 
-> GitHub: https://github.com/dcloudio/uni-api/tree/alpha/uni_modules/uni-websocket
+> GitHub: https://github.com/dcloudio/uni-app/tree/uni-app-x-alpha/src/uni_modules/uni-websocket
 
 通过 WebSocket 连接发送数据，需要先 uni.connectSocket，并在 uni.onSocketOpen 回调之后才能发送。  **已废弃，使用 SocketTask 的 send 替换。**
 
@@ -344,9 +344,9 @@ onMessage
 ::: sourceCode
 ## uni.~~onSocketMessage(callback)~~ @onsocketmessage
 
-> GitCode: https://gitcode.com/dcloud/uni-api/tree/alpha/uni_modules/uni-websocket
+> GitCode: https://gitcode.com/dcloud/uni-app/tree/uni-app-x-alpha/src/uni_modules/uni-websocket
 
-> GitHub: https://github.com/dcloudio/uni-api/tree/alpha/uni_modules/uni-websocket
+> GitHub: https://github.com/dcloudio/uni-app/tree/uni-app-x-alpha/src/uni_modules/uni-websocket
 
 监听WebSocket接受到服务器的消息事件。  **已废弃，使用 SocketTask 的 onMessage 替换。**
 
@@ -385,9 +385,9 @@ onMessage
 ::: sourceCode
 ## uni.~~closeSocket(options)~~ @closesocket
 
-> GitCode: https://gitcode.com/dcloud/uni-api/tree/alpha/uni_modules/uni-websocket
+> GitCode: https://gitcode.com/dcloud/uni-app/tree/uni-app-x-alpha/src/uni_modules/uni-websocket
 
-> GitHub: https://github.com/dcloudio/uni-api/tree/alpha/uni_modules/uni-websocket
+> GitHub: https://github.com/dcloudio/uni-app/tree/uni-app-x-alpha/src/uni_modules/uni-websocket
 
 关闭 WebSocket 连接。  **已废弃，使用 SocketTask 的 close 替换。**
 
@@ -427,9 +427,9 @@ onMessage
 ::: sourceCode
 ## uni.~~onSocketClose(callback)~~ @onsocketclose
 
-> GitCode: https://gitcode.com/dcloud/uni-api/tree/alpha/uni_modules/uni-websocket
+> GitCode: https://gitcode.com/dcloud/uni-app/tree/uni-app-x-alpha/src/uni_modules/uni-websocket
 
-> GitHub: https://github.com/dcloudio/uni-api/tree/alpha/uni_modules/uni-websocket
+> GitHub: https://github.com/dcloudio/uni-app/tree/uni-app-x-alpha/src/uni_modules/uni-websocket
 
 监听WebSocket关闭。  **已废弃，使用 SocketTask 的 onClose 替换。**
 

package/data/uniappx/app-vapor.md

@@ -303,7 +303,7 @@ uni-app x 蒸汽模式 提供了应该是业内最好的rich-text组件。
 
 - uni-app x 的App平台到底是自渲染还是原生渲染？
 
-答案是原生渲染。uni-app x 选择原生渲染是为了更好的和原生生态无缝融合、以及降低内存占用（无需2套渲染管线）。
+答案是原生渲染。uni-app x 选择原生渲染是为了更好的和原生生态无缝融合、以及降低内存占用（无需2套渲染管线）。自渲染在冷启动和原生混合渲染时劣势明显，参考[《一文讲透原生渲染和自渲染》](./select/native-render-and-self-render.md)
 
 - 为什么都是原生渲染，uni-app x的蒸汽模式比原生渲染更快？
 
@@ -491,43 +491,7 @@ ninja: error: failed recompaction: Permission denied。
     * 支持3D轮播
     * swiper-item的position属性的值固定为absolute
     * swiper默认高度为150px。如需根据内容高度撑开，可使用auto-height属性。
-- 新增：view、text、image这3个组件的flatten拍平属性
-
-  拍平即不创建独立元素，而是绘制在父上。在审查元素边界时无法看到红框。
-
-  `<view flatten></view>`
-
-  该属性为初始化属性，不支持动态修改。
-
-  被拍平的元素存在一些限制，因为本质上是把这拍平元素画在了它的父级上。限制具体如下：
-  * 拍平的元素无法支持事件（如click、touch）
-  * 拍平的元素不支持截图API：takeSnapshot
-  * 拍平时如下css不支持：
-    + 不支持 [visibility](css/visibility.md)
-    + 不支持 [z-index](css/z-index.md)
-    + 不支持 [background-image](css/background-image.md)、[background-clip](css/background-clip.md)
-    + 不支持 [pointer-events](css/pointer-events.md)
-    + [box-shadow](css/box-shadow.md) 不支持设置 inset 及 spreadRadius
-    + [display](css/display.md) 为 fixed 时显示存在缺陷，无法覆盖其它非 fixed 的元素
-    + [transition](css/transform.md) 动画不支持渲染相关（如background-color）的样式
-  * image组件拍平后无法播放动画，gif、webp动画仅显示第一帧
-  * view组件拍平后css属性transform、overflow、display、opacity存在缺陷，如果view存在子元素，这些样式不会对非拍平的子元素产生效果
-
-  注意：当自定义组件的单根节点是（view、text、image）时，该自定义组件会自动支持flatten属性，并将其传递给它的单根节点，如果在不符合要求的自定义组件上使用flatten属性，则会被自动忽略。
-
-#### 拍平（flatten）在鸿蒙平台注意事项
-支持 flatten属性的组件（如 View、Text、Image）在逻辑上均可设置为 true 以进行“拍平”，但实际性能优化效果需满足以下条件：
-`仅当存在至少两个相邻元素同时设置为拍平时，才能提升性能，否则可能导致性能下降。`
-
-相邻元素包括：
-- 兄弟节点
-  不要求直接紧挨，例如父元素 P 下有 C1、C2、C3 三个子元素，只要其中任意两个或以上设置为拍平，即可带来性能提升。
-- 父子节点
-  要求直接紧邻，例如 P → C → G 三层结构中：
-  + 对 P 和 C、C 和 G，或 P、C、G 同时拍平，可优化性能。
-  + 若仅对 P 和 G 拍平（中间隔了 C），则无法优化。
-- 混合情况
-  只要存在至少两个相邻节点（父子或兄弟）同时拍平，即可获得性能优化。
+- 新增：view、text、image这3个组件的[flatten](component/common.md#flatten)拍平属性
 
 ### Element API
 - TODO：缺少Drawable。dom2的view、text创建足够快且支持拍平，故优先级不高
@@ -537,7 +501,11 @@ ninja: error: failed recompaction: Permission denied。
 
 其他还有一些差异，见文档的兼容性说明。
 
-## 使用uni-agent，从VDOM模式升级到蒸汽模式@vom2vapor
+## 使用uni-agent，从VDOM模式升级到蒸汽模式@vdom2vapor
+
+在uni-agent中有内置的skill，可以方便的升级vdom到蒸汽。
+
+如果你需要手动处理，可以参考以下步骤：
 
 1. 在vdom模式下，要求uni-agent把复杂的组合选择器，改成 简单的class选择器或分组选择器，确认是否正常
 2. 在vdom模式下，打开manifest.json中的样式隔离策略2.0，把[文档](css/common/style-isolation.md)贴给ai，要求ai改造，确认是否正常。如涉及三方组件，核对三方组件的新版是否支持样式隔离策略2.0，尽量选择支持该策略的组件。官方的 [uni ui x](https://doc.dcloud.net.cn/uni-app-x/component/uni-ui-x/) 是支持的。

package/data/uniappx/collocation/manifest-android.md

@@ -766,7 +766,21 @@ uni-push是DCloud与合作伙伴个推共同推出的统一推送服务。
 蒸汽模式下 Android 平台业务逻辑代码运行在Google V8 JS 引擎中。  
 Google V8 引擎通过 Android NDK 编译为 .so 动态链接库，且需要针对多种 CPU 架构（如 armeabi-v7a、arm64-v8a 等）分别打包。为严格控制 APK 的安装包体积，构建时默认禁用了 ICU 模块（编译参数 v8_enable_i18n_support = false）。  
 
-> 后续会提供配置使用包含 ICU 功能的 V8 引擎
+在uni-app x项目中使用包含 ICU 功能的 V8 引擎，需在manifest.json中配置：  
+
+- HBuilderX 5.35 及以上版本  
+  需通过 manifest.json 的`源码视图`在 "app-android" -> "distribute" -> "modules" 下添加 "v8-icu" 节点，如下示例：  
+  ```json
+  {
+    "app-android": {
+      "distribute": {
+        "modules": {
+          "v8-icu": {}
+        }
+      }
+    }
+  }
+  ```
 
 启用该裁剪后，所有与国际化（i18n）、本地化格式化以及复杂 Unicode 字符处理相关的 API 与特性将被限制或禁用，具体影响如下：  
 + [Intl](https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Intl) 全局对象不可用  

package/data/uniappx/collocation/manifest.md

@@ -46,6 +46,7 @@ uni-app x 目前不提供内置模块选择，而是提供了摇树机制自动
 | vapor | boolean | false | Web 4.0 / Android(VDOM) x / Android(Vapor) 5.21 / iOS(VDOM) x / iOS(Vapor) 5.11 / HarmonyOS(VDOM) x / HarmonyOS(Vapor) 5.0（部分支持，见上） | 是否启用蒸汽模式 |
 | styleIsolationVersion | '2' | "2" | Web 5.0 / Android 5.0 / iOS 5.0 / HarmonyOS 5.0（部分支持，见上） | 样式隔离策略 |
 | vapor-render-target | 'bytecode' \| 'nativecode' | "bytecode" | Web x / Android x / iOS x / HarmonyOS(VDOM) x / HarmonyOS(Vapor) 5.11（部分支持，见上） | 视图层编译目标 |
+| vapor-default-script-lang | 'ts' \| 'js' \| 'uts' | "ts" | Web 5.31 / 微信小程序 5.31 / 支付宝小程序 5.31 / Android(VDOM) x / Android(Vapor) 5.31 / iOS(VDOM) x / iOS(Vapor) 5.31 / HarmonyOS(VDOM) x / HarmonyOS(Vapor) 5.31（部分支持，见上） | uvue/vue 文件 script lang 默认值 |
 
 ### APP配置 @manifest-app
 

package/data/uniappx/component/_sidebar.md

@@ -62,6 +62,7 @@
     * [canvas | 画布](canvas.md)
   * 广告
     * [ad | 信息流广告](ad.md)
+    * [ad-drama | 短剧](ad-drama.md)
   * 网页
     * [web-view](web-view.md)
   * 页面属性配置节点
@@ -70,12 +71,15 @@
     * [page-meta](page-meta.md)
   * unicloud
     * [unicloud-db](unicloud-db.md)
-* [uni-ui x 扩展组件](./uni-ui-x/README.md)
+* uni-ui x 扩展组件
+  * [概述](./uni-ui-x/README.md)
   * [uni-badge-view | 数字角标](./uni-ui-x/uni-badge-view.md)
   * [uni-collapse | 折叠面板容器](./uni-ui-x/uni-collapse.md)
   * [uni-combox | 组合框](./uni-ui-x/uni-combox.md)
   * [uni-drag-cell | 可拖拽排序](./uni-ui-x/uni-drag-cell.md)
+  * [uni-expandable-text | 可折叠文本](./uni-ui-x/uni-expandable-text.md)
   * [uni-fab-button | 悬浮按钮](./uni-ui-x/uni-fab-button.md)
+  * [uni-icons | 字体图标](./uni-ui-x/uni-icons.md)
   * [uni-index-bar | 索引条](./uni-ui-x/uni-index-bar.md)
   * [uni-link | 链接](./uni-ui-x/uni-link.md)
   * [uni-number-box | 数字输入框](./uni-ui-x/uni-number-box.md)