@dcloudio/uni-app-x 0.7.114 → 0.7.116

package/package.json

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

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

@@ -142,6 +142,7 @@ declare global {
     getStyleBorderLeftWidth(): UniCSSUnitValue
     /**
      * 设置Flex相关CSS属性
+     * 注意：组合属性（如flex、flex-flow）不需要定义结构，由编译器拆分处理
      */
     setStyleFlexDirection(value: UniCSSFlexDirectionType): void
     getStyleFlexDirection(): UniCSSFlexDirectionType

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

@@ -324,9 +324,9 @@ declare global {
     options: UniSharedDataComponentOptions,
   ): InferSharedData<T, UniSharedDataComponent>
 
-  function useSharedDataVFor<T, S extends UniSharedData>(sharedDataVFor: S): S
+  function useSharedDataVFor<T, S extends UniSharedData>(sharedDataVFor: UniSharedData): S
 
-  function useSharedDataRecycleVFor<T, S extends UniSharedData>(sharedDataVFor: S): S
+  function useSharedDataRecycleVFor<T, S extends UniSharedData>(sharedDataVFor: UniSharedData): S
   // android kotlin 属性委托
   function observable(): any
 }
@@ -335,8 +335,8 @@ declare global {
   /**
    * 动态 sharedData class 的最小描述信息。
    *
-   * 这份 descriptor 只服务于动态实例创建与字段/flag 存储分配，
-   * 不扩展成复杂的 registry 或反射系统。
+   * 该描述信息由 sharedData bundle provider 返回，
+   * 供动态 sharedData 实例初始化字段槽和 flag 分配使用。
    */
   interface UniDynamicSharedDataClassDefinition {
     /**
@@ -348,8 +348,6 @@ declare global {
 
     /**
      * 当前 template 内唯一的 sharedData class 编号。
-     *
-     * 与动态 shared schema 中的 `sharedDataClassId` 对齐。
      */
     readonly sharedDataClassId: number
 
@@ -365,13 +363,6 @@ declare global {
 
     /**
      * 当前 class 的字段声明。
-     *
-     * 动态实现通过这些字段声明完成 fieldId -> flag 标记。
-     *
-     * 当前阶段不额外放 `nullable` / `valueTag`：
-     * - 动态 `_setData(fieldId, value)` 不依赖这两类信息
-     * - 解释器读取 `getField(fieldId)` / `getFlag(flagGroupId)` 也不依赖
-     * - 如后续宿主实现证明需要，再单独补充
      */
     readonly fields: ReadonlyArray<UniDynamicSharedDataField>
   }
@@ -396,6 +387,47 @@ declare global {
     readonly flagBit: number
   }
 
+  /**
+   * 动态 sharedData 的最小初始化参数。
+   *
+   * 所有动态 sharedData 实例统一通过：
+   * - `bundleKey`
+   * - `sharedDataClassId`
+   *
+   * 完成初始化。
+   *
+   * root page / root component 的 `sharedDataClassId` 固定由编译器传入 `0`。
+   */
+  interface UniDynamicSharedDataInitOptions {
+    /**
+     * 当前动态 bundle 的稳定标识。
+     */
+    readonly bundleKey: string
+
+    /**
+     * 当前实例对应的 sharedData class 编号。
+     *
+     * root page / root component 固定为 `0`，
+     * 其他 scoped sharedData 使用编译器分配的实际 classId。
+     */
+    readonly sharedDataClassId: number
+  }
+
+  interface UniDynamicSharedDataBundle {
+    getSharedDataClassDefinition(sharedDataClassId: number): UniDynamicSharedDataClassDefinition
+  }
+
+  /**
+   * 动态 sharedData bundle provider 的接口定义。
+   */
+  interface UniDynamicSharedDataBundleProvider {
+    /**
+     * 根据 bundleKey 加载对应的动态 bundle。
+     * @param bundleKey
+     */
+    loadBundle(bundleKey: string): UniDynamicSharedDataBundle
+  }
+
   /**
    * 普通动态 sharedData 的最小读取接口。
    *
@@ -465,29 +497,38 @@ declare global {
    * 动态普通 scope 的最终目标基类。
    *
    * 外部仓库的真实实现应继承静态基类 `UniSharedData`，
-   * 同时实现 `IUniDynamicSharedData`。
+   * 并通过 `bundleKey + sharedDataClassId` 初始化实例。
    */
   abstract class UniDynamicSharedData extends UniSharedData implements IUniDynamicSharedData {
+    /**
+     * 当前实例所属 bundleKey。
+     */
+    readonly _bundleKey: string
+
+    /**
+     * 当前实例对应的 sharedData class 编号。
+     */
+    readonly _sharedDataClassId: number
+
     /**
      * 当前动态实例对应的 sharedData class 描述。
+     *
+     * 该 metadata 由实例构造时通过 bundle provider 获取。
      */
     readonly _sharedDataClass: UniDynamicSharedDataClassDefinition
 
-    constructor(scope: UniSharedDataPage, sharedDataClass: UniDynamicSharedDataClassDefinition)
+    constructor(scope: UniSharedDataPage, dynamicOptions: UniDynamicSharedDataInitOptions)
 
     abstract getField(fieldId: number): UniSharedDataAny
     abstract getFlag(flagGroupId: number): number
 
     /**
-     * 动态模式继续复用静态 `_setData` / `_resetFlags()` 命名，
-     * 但动态 `renderSharedData` 代码应优先传 `fieldId`，避免运行时再做
-     * `key -> fieldId` 匹配。
+     * 动态 `renderSharedData` 主路径固定传 `fieldId`。
      *
-     * 为兼容静态语义与旧调用形态，这里保留 `string` / `number` 双签名：
-     * - `string`：兼容静态 sharedData 风格，仅做类型定义无需实现
-     * - `number`：动态 sharedData 主路径，表示 `fieldId`
+     * 这里保留 `string` / `number` 双签名：
+     * - `string`：与静态基类签名保持兼容，不需要支持
+     * - `number`：动态 sharedData 通过字段编号设置数据，供解释器渲染器使用
      */
-    // 同样保留双签名兼容静态调用形态，但动态实现只使用 `fieldId` 版本，无需实现 `string` 版本
     abstract _setData(key: string, value: any | null): void
     abstract _setData(fieldId: number, value: any | null): void
   }
@@ -496,22 +537,18 @@ declare global {
    * 动态组件 scope 的最终目标基类。
    *
    * 外部仓库真实实现需要保持与静态 `UniSharedDataComponent`
-   * 相同的组件级 builtin 语义。
-   *
-   * 这里的 class 继承表达“复用哪一个静态基类”：
-   * - component 复用 `UniSharedDataComponent`
-   *
-   * 因为这里不继承 `UniDynamicSharedData`，所以动态读取接口仍需显式声明，
-   * 不能只留在 `IUniDynamicSharedDataComponent` 里。
+   * 相同的组件级 builtin 语义，并通过 `bundleKey + sharedDataClassId`
+   * 初始化实例。
    */
   abstract class UniDynamicSharedDataComponent extends UniSharedDataComponent implements IUniDynamicSharedDataComponent {
+    readonly _bundleKey: string
+    readonly _sharedDataClassId: number
     readonly _sharedDataClass: UniDynamicSharedDataClassDefinition
 
-    constructor(scope: UniSharedDataPage, options: UniSharedDataComponentOptions, sharedDataClass: UniDynamicSharedDataClassDefinition)
+    constructor(scope: UniSharedDataPage, options: UniSharedDataComponentOptions, dynamicOptions: UniDynamicSharedDataInitOptions)
 
     abstract getField(fieldId: number): UniSharedDataAny
     abstract getFlag(flagGroupId: number): number
-    // 同样保留双签名兼容静态调用形态，但动态实现只使用 `fieldId` 版本，无需实现 `string` 版本
     abstract _setData(key: string, value: any | null): void
     abstract _setData(fieldId: number, value: any | null): void
     abstract getVueId(): number
@@ -523,25 +560,18 @@ declare global {
    * 动态页面 scope 的最终目标基类。
    *
    * 外部仓库真实实现应继承 `UniSharedDataPage`，
-   * 并沿用 component builtin 读取面。
-   *
-   * 这里不写成 `UniDynamicSharedDataPage extends UniDynamicSharedDataComponent`。
-   * 原因：
-   * 1. `page` 是否属于 `component`，由接口继承表达
-   * 2. class 继承优先表达真实静态基类复用关系
-   * 3. `UniSharedDataPage` 已经继承 `UniSharedDataComponent`
-   *
-   * 因为这里不继承 `UniDynamicSharedDataComponent`，所以动态读取接口同样
-   * 需要显式声明，不能只留在 `IUniDynamicSharedDataPage` 里。
+   * 并沿用 component builtin 读取面，通过 `bundleKey + sharedDataClassId`
+   * 初始化实例。
    */
   abstract class UniDynamicSharedDataPage extends UniSharedDataPage implements IUniDynamicSharedDataPage {
+    readonly _bundleKey: string
+    readonly _sharedDataClassId: number
     readonly _sharedDataClass: UniDynamicSharedDataClassDefinition
 
-    constructor(pageIdOrScope: number | UniSharedDataPage, options: UniSharedDataComponentOptions, sharedDataClass: UniDynamicSharedDataClassDefinition)
+    constructor(pageIdOrScope: number | UniSharedDataPage, options: UniSharedDataComponentOptions, dynamicOptions: UniDynamicSharedDataInitOptions)
 
     abstract getField(fieldId: number): UniSharedDataAny
     abstract getFlag(flagGroupId: number): number
-    // 同样保留双签名兼容静态调用形态，但动态实现只使用 `fieldId` 版本，无需实现 `string` 版本
     abstract _setData(key: string, value: any | null): void
     abstract _setData(fieldId: number, value: any | null): void
     abstract getVueId(): number