@dcloudio/uni-app-x 0.7.120 → 0.7.122

package/README.md

@@ -1 +1,88 @@
 # uni-app x 类型
+
+## 配置环境
+
+当前目录建立 `.env` 文件。
+
+```env
+UNI_CORE_DIR="%vuejs-core 仓库路径%/packages/uni-ext-api/src"
+UNI_UTS_PLUGIN_API_DIR="%新 uni-app 仓库路径%/api"
+UNI_UTS_PLUGIN_MODULES_DIR="%dcloud-uts 仓库路径%/uni_modules"
+UNI_COMPLIER_META_DIR="%旧 uni-app 仓库路径%/packages/uni-uts-v1/lib/ext-api"
+# 可选。不配置时默认使用项目根目录下的 .uni-module-projects-cache
+UNI_MODULE_PROJECTS_CACHE_DIR="%插件项目缓存目录%"
+```
+
+## 聚合单独插件项目
+
+单独插件项目通过 `scripts/uni-module-projects.json` 配置，构建时会自动聚合并同步到当前仓库对应分支。
+
+```json
+[
+  {
+    "name": "uni-im",
+    "repo": "git@your-git-host:team/uni-im.git"
+  },
+  {
+    "name": "uni-pay",
+    "repo": "git@your-git-host:team/uni-pay.git",
+    "branches": {
+      "main": "main",
+      "dev": "dev",
+      "alpha": "alpha"
+    }
+  }
+]
+```
+
+说明：
+
+- `name` 用作本地缓存目录名，必须唯一。
+- `repo` 是插件项目仓库地址。
+- `branches` 可选，用于少数分支名不一致的项目；未配置时默认使用当前仓库分支名。
+- 当前仓库如果在 `master` 分支，构建脚本会自动映射到插件项目的 `main` 分支。
+- 如果未配置 `UNI_MODULE_PROJECTS_CACHE_DIR`，脚本会使用项目根目录下的 `.uni-module-projects-cache` 作为默认缓存目录；该目录已加入 `.gitignore`。
+
+构建时脚本会对 `uni-module-projects.json` 中的每个项目执行以下流程：
+
+- 首次构建时自动 `git clone`
+- 后续构建时自动 `git fetch --all --prune`
+- 切换到当前仓库对应分支
+- 执行 `git pull --ff-only`
+- 从各项目的 `uni_modules/` 中收集插件并参与 dts 构建
+
+如果某个缓存仓库存在未提交改动，构建会直接失败，避免覆盖本地工作区。
+
+如果多个来源中存在相同的 `uni_modules/<plugin>/utssdk/interface.*` 相对路径，构建会直接报错，避免生成结果互相覆盖。
+
+## 构建
+
+构建框架内置 Uni Api：
+
+```sh
+pnpm build:types:core
+```
+
+构建插件 API：
+
+```sh
+pnpm build:types:plugin:api
+```
+
+构建插件组件类型与 vuedoc：
+
+```sh
+pnpm build:types:plugin:component
+```
+
+构建业务插件类型：
+
+```sh
+pnpm build:types:plugin:biz
+```
+
+生成默认参数数据到编译器：
+
+```sh
+pnpm build:types:meta
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dcloudio/uni-app-x",
-  "version": "0.7.120",
+  "version": "0.7.122",
   "description": "uni-app x types",
   "typings": "index.d.ts",
   "main": "index.d.ts",

package/types/app.d.ts

@@ -1134,7 +1134,8 @@ declare global {
    *    "harmony": {
    *      "osVer": "3.0",
    *      "uniVer": "4.23",
-   *      "unixVer": "4.61"
+   *      "unixVer": "4.61",
+   *      "unixVaporVer": "5.0"
    *    }
    *  },
    *  "mp": {

package/types/dom2-internal/UniCommon.d.ts

@@ -12,9 +12,14 @@ export enum UniSlotType {
   None,
   /**
    * 下拉刷新插槽
-   *  scroll-view组件的子组件使用
+   *  scroll-view、list-view、waterflow组件内支持
    */
-  Refresher
+  Refresher,
+  /**
+   * 上拉加载更多插槽
+   *  scroll-view、list-view、waterflow组件内支持
+   */
+  LoadMore
 }
 
 

package/types/dom2-internal/UniNativeDefines.d.ts

@@ -420,9 +420,14 @@ export enum UniNativeSlotType {
   None,
   /**
    * 下拉刷新插槽
-   *  scroll-view组件的子组件使用
+   *  scroll-view、list-view、waterflow组件内支持
    */
-  Refresher
+  Refresher,
+  /**
+   * 上拉加载更多插槽
+   *  scroll-view、list-view、waterflow组件内支持
+   */
+  LoadMore
 }
 //export type UniNativeSlotType = UniSlotType
 

package/types/dom2-internal/UniPage.d.ts

@@ -108,6 +108,12 @@ declare global {
      * @internal
      */
     createElement(type: UniElementType): UniElement
+    /**
+     * Android平台Kotlin层实现
+     *  用于Android平台线程2中uts组件（native-view）中自定义的Element，仅限原生层自定义Element使用
+     * @internal
+     */
+    createCustomNativeElement(name: string, flatten: boolean): UniElement
     /**
      * Android平台Kotlin层实现
      *  用于Android平台线程1中创建UniTextLayout

package/types/native/DrawableContext.d.ts

@@ -10,12 +10,14 @@ declare global {
    *        "android": {
    *            "osVer": "5.0",
    *            "uniVer": "x",
-   *            "unixVer": "3.9"
+   *            "unixVer": "3.9",
+   *            "unixVaporVer": "x"
    *        },
    *        "ios": {
    *            "osVer": "12.0",
    *            "uniVer": "x",
-   *            "unixVer": "4.11"
+   *            "unixVer": "4.11",
+   *            "unixVaporVer": "x"
    *        },
    *        "harmony": {
    *            "osVer": "x",
@@ -81,12 +83,14 @@ declare global {
      *        "android": {
      *            "osVer": "5.0",
      *            "uniVer": "x",
-     *            "unixVer": "3.9"
+     *            "unixVer": "3.9",
+     *            "unixVaporVer": "x"
      *        },
      *        "ios": {
      *            "osVer": "12.0",
      *            "uniVer": "x",
-     *            "unixVer": "4.11"
+     *            "unixVer": "4.11",
+     *            "unixVaporVer": "x"
      *        },
      *        "harmony": {
      *            "osVer": "x",
@@ -152,12 +156,14 @@ declare global {
      *        "android": {
      *            "osVer": "5.0",
      *            "uniVer": "x",
-     *            "unixVer": "3.9"
+     *            "unixVer": "3.9",
+     *            "unixVaporVer": "x"
      *        },
      *        "ios": {
      *            "osVer": "12.0",
      *            "uniVer": "x",
-     *            "unixVer": "4.11"
+     *            "unixVer": "4.11",
+     *            "unixVaporVer": "x"
      *        },
      *        "harmony": {
      *            "osVer": "x",
@@ -223,12 +229,14 @@ declare global {
      *        "android": {
      *            "osVer": "5.0",
      *            "uniVer": "x",
-     *            "unixVer": "3.9"
+     *            "unixVer": "3.9",
+     *            "unixVaporVer": "x"
      *        },
      *        "ios": {
      *            "osVer": "12.0",
      *            "uniVer": "x",
-     *            "unixVer": "4.11"
+     *            "unixVer": "4.11",
+     *            "unixVaporVer": "x"
      *        },
      *        "harmony": {
      *            "osVer": "x",
@@ -293,12 +301,14 @@ declare global {
      *        "android": {
      *            "osVer": "5.0",
      *            "uniVer": "x",
-     *            "unixVer": "3.9"
+     *            "unixVer": "3.9",
+     *            "unixVaporVer": "x"
      *        },
      *        "ios": {
      *            "osVer": "12.0",
      *            "uniVer": "x",
-     *            "unixVer": "4.11"
+     *            "unixVer": "4.11",
+     *            "unixVaporVer": "x"
      *        },
      *        "harmony": {
      *            "osVer": "x",
@@ -364,12 +374,14 @@ declare global {
      *        "android": {
      *            "osVer": "5.0",
      *            "uniVer": "x",
-     *            "unixVer": "3.9"
+     *            "unixVer": "3.9",
+     *            "unixVaporVer": "x"
      *        },
      *        "ios": {
      *            "osVer": "12.0",
      *            "uniVer": "x",
-     *            "unixVer": "4.11"
+     *            "unixVer": "4.11",
+     *            "unixVaporVer": "x"
      *        },
      *        "harmony": {
      *            "osVer": "x",
@@ -435,12 +447,14 @@ declare global {
      *        "android": {
      *            "osVer": "5.0",
      *            "uniVer": "x",
-     *            "unixVer": "3.9"
+     *            "unixVer": "3.9",
+     *            "unixVaporVer": "x"
      *        },
      *        "ios": {
      *            "osVer": "12.0",
      *            "uniVer": "x",
-     *            "unixVer": "4.11"
+     *            "unixVer": "4.11",
+     *            "unixVaporVer": "x"
      *        },
      *        "harmony": {
      *            "osVer": "x",
@@ -506,12 +520,14 @@ declare global {
      *        "android": {
      *            "osVer": "5.0",
      *            "uniVer": "x",
-     *            "unixVer": "3.9"
+     *            "unixVer": "3.9",
+     *            "unixVaporVer": "x"
      *        },
      *        "ios": {
      *            "osVer": "12.0",
      *            "uniVer": "x",
-     *            "unixVer": "4.11"
+     *            "unixVer": "4.11",
+     *            "unixVaporVer": "x"
      *        },
      *        "harmony": {
      *            "osVer": "x",
@@ -577,12 +593,14 @@ declare global {
      *        "android": {
      *            "osVer": "5.0",
      *            "uniVer": "x",
-     *            "unixVer": "3.9"
+     *            "unixVer": "3.9",
+     *            "unixVaporVer": "x"
      *        },
      *        "ios": {
      *            "osVer": "12.0",
      *            "uniVer": "x",
-     *            "unixVer": "4.11"
+     *            "unixVer": "4.11",
+     *            "unixVaporVer": "x"
      *        },
      *        "harmony": {
      *            "osVer": "x",
@@ -648,12 +666,14 @@ declare global {
      *        "android": {
      *            "osVer": "5.0",
      *            "uniVer": "x",
-     *            "unixVer": "3.9"
+     *            "unixVer": "3.9",
+     *            "unixVaporVer": "x"
      *        },
      *        "ios": {
      *            "osVer": "12.0",
      *            "uniVer": "x",
-     *            "unixVer": "4.11"
+     *            "unixVer": "4.11",
+     *            "unixVaporVer": "x"
      *        },
      *        "harmony": {
      *            "osVer": "x",
@@ -725,12 +745,14 @@ declare global {
      *        "android": {
      *            "osVer": "5.0",
      *            "uniVer": "x",
-     *            "unixVer": "3.9"
+     *            "unixVer": "3.9",
+     *            "unixVaporVer": "x"
      *        },
      *        "ios": {
      *            "osVer": "12.0",
      *            "uniVer": "x",
-     *            "unixVer": "4.11"
+     *            "unixVer": "4.11",
+     *            "unixVaporVer": "x"
      *        },
      *        "harmony": {
      *            "osVer": "x",
@@ -798,12 +820,14 @@ declare global {
      *        "android": {
      *            "osVer": "5.0",
      *            "uniVer": "x",
-     *            "unixVer": "3.9"
+     *            "unixVer": "3.9",
+     *            "unixVaporVer": "x"
      *        },
      *        "ios": {
      *            "osVer": "12.0",
      *            "uniVer": "x",
-     *            "unixVer": "4.11"
+     *            "unixVer": "4.11",
+     *            "unixVaporVer": "x"
      *        },
      *        "harmony": {
      *            "osVer": "x",
@@ -873,12 +897,14 @@ declare global {
      *        "android": {
      *            "osVer": "5.0",
      *            "uniVer": "x",
-     *            "unixVer": "3.9"
+     *            "unixVer": "3.9",
+     *            "unixVaporVer": "x"
      *        },
      *        "ios": {
      *            "osVer": "12.0",
      *            "uniVer": "x",
-     *            "unixVer": "4.11"
+     *            "unixVer": "4.11",
+     *            "unixVaporVer": "x"
      *        },
      *        "harmony": {
      *            "osVer": "x",
@@ -946,12 +972,14 @@ declare global {
      *        "android": {
      *            "osVer": "5.0",
      *            "uniVer": "x",
-     *            "unixVer": "3.9"
+     *            "unixVer": "3.9",
+     *            "unixVaporVer": "x"
      *        },
      *        "ios": {
      *            "osVer": "12.0",
      *            "uniVer": "x",
-     *            "unixVer": "4.11"
+     *            "unixVer": "4.11",
+     *            "unixVaporVer": "x"
      *        },
      *        "harmony": {
      *            "osVer": "x",
@@ -1017,12 +1045,14 @@ declare global {
      *        "android": {
      *            "osVer": "5.0",
      *            "uniVer": "x",
-     *            "unixVer": "3.9"
+     *            "unixVer": "3.9",
+     *            "unixVaporVer": "x"
      *        },
      *        "ios": {
      *            "osVer": "12.0",
      *            "uniVer": "x",
-     *            "unixVer": "4.11"
+     *            "unixVer": "4.11",
+     *            "unixVaporVer": "x"
      *        },
      *        "harmony": {
      *            "osVer": "x",
@@ -1088,12 +1118,14 @@ declare global {
      *        "android": {
      *            "osVer": "5.0",
      *            "uniVer": "x",
-     *            "unixVer": "3.9"
+     *            "unixVer": "3.9",
+     *            "unixVaporVer": "x"
      *        },
      *        "ios": {
      *            "osVer": "12.0",
      *            "uniVer": "x",
-     *            "unixVer": "4.11"
+     *            "unixVer": "4.11",
+     *            "unixVaporVer": "x"
      *        },
      *        "harmony": {
      *            "osVer": "x",
@@ -1163,12 +1195,14 @@ declare global {
      *        "android": {
      *            "osVer": "5.0",
      *            "uniVer": "x",
-     *            "unixVer": "3.9"
+     *            "unixVer": "3.9",
+     *            "unixVaporVer": "x"
      *        },
      *        "ios": {
      *            "osVer": "12.0",
      *            "uniVer": "x",
-     *            "unixVer": "4.11"
+     *            "unixVer": "4.11",
+     *            "unixVaporVer": "x"
      *        },
      *        "harmony": {
      *            "osVer": "x",
@@ -1237,12 +1271,14 @@ declare global {
      *        "android": {
      *            "osVer": "5.0",
      *            "uniVer": "x",
-     *            "unixVer": "3.9"
+     *            "unixVer": "3.9",
+     *            "unixVaporVer": "x"
      *        },
      *        "ios": {
      *            "osVer": "12.0",
      *            "uniVer": "x",
-     *            "unixVer": "4.11"
+     *            "unixVer": "4.11",
+     *            "unixVaporVer": "x"
      *        },
      *        "harmony": {
      *            "osVer": "x",
@@ -1309,12 +1345,14 @@ declare global {
      *        "android": {
      *            "osVer": "5.0",
      *            "uniVer": "x",
-     *            "unixVer": "3.9"
+     *            "unixVer": "3.9",
+     *            "unixVaporVer": "x"
      *        },
      *        "ios": {
      *            "osVer": "12.0",
      *            "uniVer": "x",
-     *            "unixVer": "4.11"
+     *            "unixVer": "4.11",
+     *            "unixVaporVer": "x"
      *        },
      *        "harmony": {
      *            "osVer": "x",
@@ -1384,12 +1422,14 @@ declare global {
      *        "android": {
      *            "osVer": "5.0",
      *            "uniVer": "x",
-     *            "unixVer": "3.9"
+     *            "unixVer": "3.9",
+     *            "unixVaporVer": "x"
      *        },
      *        "ios": {
      *            "osVer": "12.0",
      *            "uniVer": "x",
-     *            "unixVer": "4.11"
+     *            "unixVer": "4.11",
+     *            "unixVaporVer": "x"
      *        },
      *        "harmony": {
      *            "osVer": "x",
@@ -1458,12 +1498,14 @@ declare global {
      *        "android": {
      *            "osVer": "5.0",
      *            "uniVer": "x",
-     *            "unixVer": "3.9"
+     *            "unixVer": "3.9",
+     *            "unixVaporVer": "x"
      *        },
      *        "ios": {
      *            "osVer": "12.0",
      *            "uniVer": "x",
-     *            "unixVer": "4.11"
+     *            "unixVer": "4.11",
+     *            "unixVaporVer": "x"
      *        },
      *        "harmony": {
      *            "osVer": "x",
@@ -1529,12 +1571,14 @@ declare global {
      *        "android": {
      *            "osVer": "5.0",
      *            "uniVer": "x",
-     *            "unixVer": "3.9"
+     *            "unixVer": "3.9",
+     *            "unixVaporVer": "x"
      *        },
      *        "ios": {
      *            "osVer": "12.0",
      *            "uniVer": "x",
-     *            "unixVer": "4.11"
+     *            "unixVer": "4.11",
+     *            "unixVaporVer": "x"
      *        },
      *        "harmony": {
      *            "osVer": "x",
@@ -1600,12 +1644,14 @@ declare global {
      *        "android": {
      *            "osVer": "5.0",
      *            "uniVer": "x",
-     *            "unixVer": "3.9"
+     *            "unixVer": "3.9",
+     *            "unixVaporVer": "x"
      *        },
      *        "ios": {
      *            "osVer": "12.0",
      *            "uniVer": "x",
-     *            "unixVer": "4.11"
+     *            "unixVer": "4.11",
+     *            "unixVaporVer": "x"
      *        },
      *        "harmony": {
      *            "osVer": "x",
@@ -1672,12 +1718,14 @@ declare global {
      *        "android": {
      *            "osVer": "5.0",
      *            "uniVer": "x",
-     *            "unixVer": "3.9"
+     *            "unixVer": "3.9",
+     *            "unixVaporVer": "x"
      *        },
      *        "ios": {
      *            "osVer": "12.0",
      *            "uniVer": "x",
-     *            "unixVer": "4.11"
+     *            "unixVer": "4.11",
+     *            "unixVaporVer": "x"
      *        },
      *        "harmony": {
      *            "osVer": "x",
@@ -1748,12 +1796,14 @@ declare global {
      *        "android": {
      *            "osVer": "5.0",
      *            "uniVer": "x",
-     *            "unixVer": "3.9"
+     *            "unixVer": "3.9",
+     *            "unixVaporVer": "x"
      *        },
      *        "ios": {
      *            "osVer": "12.0",
      *            "uniVer": "x",
-     *            "unixVer": "4.11"
+     *            "unixVer": "4.11",
+     *            "unixVaporVer": "x"
      *        },
      *        "harmony": {
      *            "osVer": "x",
@@ -1825,12 +1875,14 @@ declare global {
      *        "android": {
      *            "osVer": "5.0",
      *            "uniVer": "x",
-     *            "unixVer": "3.9"
+     *            "unixVer": "3.9",
+     *            "unixVaporVer": "x"
      *        },
      *        "ios": {
      *            "osVer": "12.0",
      *            "uniVer": "x",
-     *            "unixVer": "4.11"
+     *            "unixVer": "4.11",
+     *            "unixVaporVer": "x"
      *        },
      *        "harmony": {
      *            "osVer": "x",

package/types/native/IUniElement.d.ts

@@ -1590,13 +1590,15 @@ declare global {
      *        "android": {
      *            "osVer": "5.0",
      *            "uniVer": "x",
-     *            "unixVer": "3.9+"
+     *            "unixVer": "3.9+",
+     *            "unixVaporVer": "x"
      *        },
      *        "ios": {
      *            "osVer": "12.0",
      *            "uniVer": "x",
      *            "unixVer": "4.11",
-     *            "unixUtsPlugin": "4.25"
+     *            "unixUtsPlugin": "4.25",
+     *            "unixVaporVer": "x"
      *        },
      *        "harmony": {
      *            "osVer": "5.0",

package/types/node_modules/.package-lock.json

@@ -0,0 +1,20 @@
+{
+  "name": "types",
+  "version": "1.0.0",
+  "lockfileVersion": 3,
+  "requires": true,
+  "packages": {
+    "node_modules/typescript": {
+      "version": "5.5.2",
+      "resolved": "https://registry.npmjs.org/typescript/-/typescript-5.5.2.tgz",
+      "integrity": "sha512-NcRtPEOsPFFWjobJEtfihkLCZCXZt/os3zf8nTxjVH3RvTSxjrCamJpbExGvYOF+tFHc3pA65qpdwPbzjohhew==",
+      "bin": {
+        "tsc": "bin/tsc",
+        "tsserver": "bin/tsserver"
+      },
+      "engines": {
+        "node": ">=14.17"
+      }
+    }
+  }
+}