@dcloudio/uni-app-x 0.7.112 → 0.7.114

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

@@ -29,6 +29,7 @@ export interface UniNativeView extends UniNativeBaseView {
    */
   /**
    * 是否支持hover样式更新
+   *  用于原生View保存状态来确定是否需要在按下时更新样式，目前实际上框架没有调用，而是各平台内部调用
    */
   hover(value: boolean): UniNativeView
   /**

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

@@ -183,5 +183,21 @@ declare global {
      * @internal
      */
     defineStyleVariable(key: string, value: string): void
+
+    /**
+     * 获取DOM数据
+     * @return {UTSJSONObject} 对象中包含以下字段数据
+     *  children - Array[UTSJSONObject]类型，如果没有子，则此数据不存在
+     *  attributes - UTSJSONObject类型，所有的属性列表：key为字符串类型属性名称，value为字符串类型属性值
+     *                属性名称存在中划线时，保留中划线
+     *  styles - UTSJSONObject类型，所有的样式列表：key为字符串类型样式名称，value为字符串类型样式值
+     *                样式名称存在中划线时，保留中划线
+     *  computedLayouts - UTSJSONObject类型，包括left/top/width/height，单位为逻辑像素值
+     *  vueComponentId - string类型，vue组件标识，仅蒸汽模式存在
+     *  vueComponentName - string类型，vue组件名称，仅蒸汽模式存在
+     *  VueComponentPath - string类型，vue组件路径，仅蒸汽模式存在
+     * @internal
+     */
+    getDom(): UTSJSONObject
   }
 }

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

@@ -331,4 +331,223 @@ declare global {
   function observable(): any
 }
 
+declare global {
+  /**
+   * 动态 sharedData class 的最小描述信息。
+   *
+   * 这份 descriptor 只服务于动态实例创建与字段/flag 存储分配，
+   * 不扩展成复杂的 registry 或反射系统。
+   */
+  interface UniDynamicSharedDataClassDefinition {
+    /**
+     * sharedData class 名称。
+     *
+     * 用于调试、日志和与静态 sharedData class 对照。
+     */
+    readonly sharedDataClassName: string
+
+    /**
+     * 当前 template 内唯一的 sharedData class 编号。
+     *
+     * 与动态 shared schema 中的 `sharedDataClassId` 对齐。
+     */
+    readonly sharedDataClassId: number
+
+    /**
+     * 该 class 持有的字段数量。
+     */
+    readonly fieldCount: number
+
+    /**
+     * 该 class 持有的 flag group 数量。
+     */
+    readonly flagGroupCount: number
+
+    /**
+     * 当前 class 的字段声明。
+     *
+     * 动态实现通过这些字段声明完成 fieldId -> flag 标记。
+     *
+     * 当前阶段不额外放 `nullable` / `valueTag`：
+     * - 动态 `_setData(fieldId, value)` 不依赖这两类信息
+     * - 解释器读取 `getField(fieldId)` / `getFlag(flagGroupId)` 也不依赖
+     * - 如后续宿主实现证明需要，再单独补充
+     */
+    readonly fields: ReadonlyArray<UniDynamicSharedDataField>
+  }
+
+  /**
+   * 动态 sharedData 字段声明。
+   */
+  interface UniDynamicSharedDataField {
+    /**
+     * 当前 template 内唯一的字段编号。
+     */
+    readonly fieldId: number
+
+    /**
+     * 对应的 flag group 编号。
+     */
+    readonly flagGroupId: number
+
+    /**
+     * 对应的 flag bit。
+     */
+    readonly flagBit: number
+  }
+
+  /**
+   * 普通动态 sharedData 的最小读取接口。
+   *
+   * 解释器只依赖字段与 flag 读取。
+   *
+   * 非解释器使用的内部字段、方法，命名尽量贴近静态 sharedData：
+   * - 复用已有静态基类字段
+   * - 内部方法沿用 `_xxx` 风格
+   *
+   * 这样外部仓库实现动态 sharedData 时，底层更容易复用现有代码。
+   */
+  interface IUniDynamicSharedData {
+    /**
+     * 按字段编号读取值。
+     *
+     * 这里的 `fieldId` 由编译器 shared schema 分配，
+     * 解释器与真实实现都以该编号作为统一索引。
+     */
+    getField(fieldId: number): UniSharedDataAny
+
+    /**
+     * 按 flag 组编号读取脏标记。
+     *
+     * 返回值与静态 sharedData 的 flag group 对齐，
+     * 解释器只关心位图值本身，不关心内部存储结构。
+     */
+    getFlag(flagGroupId: number): number
+  }
+
+  /**
+   * 动态组件 sharedData 的最小接口。
+   *
+   * 对齐静态 renderer 会直接读取的 component builtin：
+   * - `_vueId`
+   * - `_flatten`
+   * - `_renderer`
+   */
+  interface IUniDynamicSharedDataComponent extends IUniDynamicSharedData {
+    /**
+     * 返回组件或页面实例的 vueId。
+     */
+    getVueId(): number
+
+    /**
+     * 返回组件当前 flatten 状态。
+     */
+    getFlatten(): UniSharedDataComponentFlatten
+
+    /**
+     * 返回当前 renderer 类型。
+     */
+    getRenderer(): UniSharedDataComponentRenderer
+  }
+
+  /**
+   * 动态页面 sharedData 的最小接口。
+   *
+   * 接口层明确表达：dynamic page 也是 dynamic component。
+   *
+   * 当前阶段 page 不额外增加读取能力，直接继承 component 接口。
+   * `_flushJobs`、`_render`、`_textLayouts` 等行为属于真实运行时职责，
+   * 不放进当前解释器契约。
+   */
+  interface IUniDynamicSharedDataPage extends IUniDynamicSharedDataComponent {}
+
+  /**
+   * 动态普通 scope 的最终目标基类。
+   *
+   * 外部仓库的真实实现应继承静态基类 `UniSharedData`，
+   * 同时实现 `IUniDynamicSharedData`。
+   */
+  abstract class UniDynamicSharedData extends UniSharedData implements IUniDynamicSharedData {
+    /**
+     * 当前动态实例对应的 sharedData class 描述。
+     */
+    readonly _sharedDataClass: UniDynamicSharedDataClassDefinition
+
+    constructor(scope: UniSharedDataPage, sharedDataClass: UniDynamicSharedDataClassDefinition)
+
+    abstract getField(fieldId: number): UniSharedDataAny
+    abstract getFlag(flagGroupId: number): number
+
+    /**
+     * 动态模式继续复用静态 `_setData` / `_resetFlags()` 命名，
+     * 但动态 `renderSharedData` 代码应优先传 `fieldId`，避免运行时再做
+     * `key -> fieldId` 匹配。
+     *
+     * 为兼容静态语义与旧调用形态，这里保留 `string` / `number` 双签名：
+     * - `string`：兼容静态 sharedData 风格，仅做类型定义无需实现
+     * - `number`：动态 sharedData 主路径，表示 `fieldId`
+     */
+    // 同样保留双签名兼容静态调用形态，但动态实现只使用 `fieldId` 版本，无需实现 `string` 版本
+    abstract _setData(key: string, value: any | null): void
+    abstract _setData(fieldId: number, value: any | null): void
+  }
+
+  /**
+   * 动态组件 scope 的最终目标基类。
+   *
+   * 外部仓库真实实现需要保持与静态 `UniSharedDataComponent`
+   * 相同的组件级 builtin 语义。
+   *
+   * 这里的 class 继承表达“复用哪一个静态基类”：
+   * - component 复用 `UniSharedDataComponent`
+   *
+   * 因为这里不继承 `UniDynamicSharedData`，所以动态读取接口仍需显式声明，
+   * 不能只留在 `IUniDynamicSharedDataComponent` 里。
+   */
+  abstract class UniDynamicSharedDataComponent extends UniSharedDataComponent implements IUniDynamicSharedDataComponent {
+    readonly _sharedDataClass: UniDynamicSharedDataClassDefinition
+
+    constructor(scope: UniSharedDataPage, options: UniSharedDataComponentOptions, sharedDataClass: UniDynamicSharedDataClassDefinition)
+
+    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
+    abstract getFlatten(): UniSharedDataComponentFlatten
+    abstract getRenderer(): UniSharedDataComponentRenderer
+  }
+
+  /**
+   * 动态页面 scope 的最终目标基类。
+   *
+   * 外部仓库真实实现应继承 `UniSharedDataPage`，
+   * 并沿用 component builtin 读取面。
+   *
+   * 这里不写成 `UniDynamicSharedDataPage extends UniDynamicSharedDataComponent`。
+   * 原因：
+   * 1. `page` 是否属于 `component`，由接口继承表达
+   * 2. class 继承优先表达真实静态基类复用关系
+   * 3. `UniSharedDataPage` 已经继承 `UniSharedDataComponent`
+   *
+   * 因为这里不继承 `UniDynamicSharedDataComponent`，所以动态读取接口同样
+   * 需要显式声明，不能只留在 `IUniDynamicSharedDataPage` 里。
+   */
+  abstract class UniDynamicSharedDataPage extends UniSharedDataPage implements IUniDynamicSharedDataPage {
+    readonly _sharedDataClass: UniDynamicSharedDataClassDefinition
+
+    constructor(pageIdOrScope: number | UniSharedDataPage, options: UniSharedDataComponentOptions, sharedDataClass: UniDynamicSharedDataClassDefinition)
+
+    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
+    abstract getFlatten(): UniSharedDataComponentFlatten
+    abstract getRenderer(): UniSharedDataComponentRenderer
+  }
+}
+
 export {}

package/types/native/CSSStyleDeclaration.d.ts

@@ -1,172 +1,172 @@
-/**
- * CSSStyleDeclaration表示一个CSS 声明块对象，它是一个 CSS 属性键值对的集合，暴露样式信息和各种与样式相关的方法和属性。
- * @package io.dcloud.uniapp.runtime
- * @uniPlatform {
- *    "app": {
- *        "android": {
- *            "osVer": "5.0",
- *            "uniVer": "x",
- *            "unixVer": "3.9"
- *        },
- *        "ios": {
- *            "osVer": "12.0",
- *            "uniVer": "x",
- *            "unixVer": "4.11"
- *        },
- *        "harmony": {
- *            "osVer": "5.0.0",
- *            "uniVer": "x",
- *            "unixVer": "4.61",
- *            "unixvVer": "5.0"
- *        }
- *    },
- *    "web": {
- *        "uniVer": "x",
- *        "unixVer": "4.0"
- *    }
- * }
- */
-export class CSSStyleDeclaration {
-
-  /**
-   * 对CSS指定样式设置一个新值，如有此样式已存在则更新。
-   * @param name CSS样式名称
-   * @param {string} [value=""] 要设置的新CSS样式值 默认值空字符串
-   * @uniPlatform {
-   *    "app": {
-   *        "android": {
-   *            "osVer": "5.0",
-   *            "uniVer": "x",
-   *            "unixVer": "4.51"
-   *        },
-   *        "ios": {
-   *            "osVer": "12.0",
-   *            "uniVer": "x",
-   *            "unixVer": "4.51"
-   *        },
-   *        "harmony": {
-   *            "osVer": "5.0.0",
-   *            "uniVer": "x",
-   *            "unixVer": "4.61"
-   *        }
-   *    },
-   *    "mp": {
-   *      "weixin": {
-   *        "osVer": "x",
-   *        "uniVer": "x",
-   *        "unixVer": "4.41"
-   *      }
-   *    },
-   *    "web": {
-   *        "uniVer": "x",
-   *        "unixVer": "4.0"
-   *    }
-   * }
-   */
-  setProperty(name: string | string.cssPropertyString, value?: string): void
-
-  /**
-   * 对CSS指定样式设置一个新值，如有此样式已存在则更新。
-   * @param name CSS样式名称
-   * @param value 要设置的新CSS样式值
-   * @deprecated 已废弃，仅为了向下兼容保留
-   * @uniPlatform {
-   *    "app": {
-   *        "android": {
-   *            "osVer": "5.0",
-   *            "uniVer": "x",
-   *            "unixVer": "3.9"
-   *        },
-   *        "ios": {
-   *            "osVer": "12.0",
-   *            "uniVer": "x",
-   *            "unixVer": "4.11"
-   *        },
-   *        "harmony": {
-   *            "osVer": "5.0.0",
-   *            "uniVer": "x",
-   *            "unixVer": "4.61",
-   *            "unixVer": "x"
-   *        }
-   *    },
-   *    "mp": {
-   *      "weixin": {
-   *        "osVer": "x",
-   *        "uniVer": "x",
-   *        "unixVer": "4.41"
-   *      }
-   *    },
-   *    "web": {
-   *        "uniVer": "x",
-   *        "unixVer": "4.0"
-   *    }
-   * }
-   */
-  setProperty(name: string | string.cssPropertyString, value: any | null): void
-
-  /**
-   * 获取CSS指定的样式值，如果指定的样式不存在则返回空字符串。
-   * @param property 要获取的CSS样式名称
-   * @uniPlatform {
-   *    "app": {
-   *        "android": {
-   *            "osVer": "5.0",
-   *            "uniVer": "x",
-   *            "unixVer": "4.51"
-   *        },
-   *        "ios": {
-   *            "osVer": "12.0",
-   *            "uniVer": "x",
-   *            "unixVer": "4.51"
-   *        },
-   *        "harmony": {
-   *            "osVer": "5.0.0",
-   *            "uniVer": "x",
-   *            "unixVer": "4.61"
-   *        }
-   *    },
-   *    "mp": {
-   *      "weixin": {
-   *        "osVer": "x",
-   *        "uniVer": "x",
-   *        "unixVer": "4.41"
-   *      }
-   *    },
-   *    "web": {
-   *        "uniVer": "x",
-   *        "unixVer": "4.0"
-   *    }
-   * }
-   */
-  getPropertyValue(property: string | string.cssPropertyString): string
-
-  /**
-   * 删除CSS指定的样式值
-   * @param property 要删除的CSS样式名称
-   * @uniPlatform {
-   *    "app": {
-   *        "android": {
-   *            "osVer": "5.0",
-   *            "uniVer": "x",
-   *            "unixVer": "4.51"
-   *        },
-   *        "ios": {
-   *            "osVer": "12.0",
-   *            "uniVer": "x",
-   *            "unixVer": "4.51"
-   *        },
-   *        "harmony": {
-   *            "osVer": "5.0.0",
-   *            "uniVer": "x",
-   *            "unixVer": "4.61",
-   *            "unixvVer": "x"
-   *        }
-   *    }
-   *    "web": {
-   *        "uniVer": "x",
-   *        "unixVer": "4.0"
-   *    }
-   * }
-   */
-  removeProperty(property: string | string.cssPropertyString): string
-}
+/**
+ * CSSStyleDeclaration表示一个CSS 声明块对象，它是一个 CSS 属性键值对的集合，暴露样式信息和各种与样式相关的方法和属性。
+ * @package io.dcloud.uniapp.runtime
+ * @uniPlatform {
+ *    "app": {
+ *        "android": {
+ *            "osVer": "5.0",
+ *            "uniVer": "x",
+ *            "unixVer": "3.9"
+ *        },
+ *        "ios": {
+ *            "osVer": "12.0",
+ *            "uniVer": "x",
+ *            "unixVer": "4.11"
+ *        },
+ *        "harmony": {
+ *            "osVer": "5.0.0",
+ *            "uniVer": "x",
+ *            "unixVer": "4.61",
+ *            "unixVaporVer": "5.0"
+ *        }
+ *    },
+ *    "web": {
+ *        "uniVer": "x",
+ *        "unixVer": "4.0"
+ *    }
+ * }
+ */
+export class CSSStyleDeclaration {
+
+  /**
+   * 对CSS指定样式设置一个新值，如有此样式已存在则更新。
+   * @param name CSS样式名称
+   * @param {string} [value=""] 要设置的新CSS样式值 默认值空字符串
+   * @uniPlatform {
+   *    "app": {
+   *        "android": {
+   *            "osVer": "5.0",
+   *            "uniVer": "x",
+   *            "unixVer": "4.51"
+   *        },
+   *        "ios": {
+   *            "osVer": "12.0",
+   *            "uniVer": "x",
+   *            "unixVer": "4.51"
+   *        },
+   *        "harmony": {
+   *            "osVer": "5.0.0",
+   *            "uniVer": "x",
+   *            "unixVer": "4.61"
+   *        }
+   *    },
+   *    "mp": {
+   *      "weixin": {
+   *        "osVer": "x",
+   *        "uniVer": "x",
+   *        "unixVer": "4.41"
+   *      }
+   *    },
+   *    "web": {
+   *        "uniVer": "x",
+   *        "unixVer": "4.0"
+   *    }
+   * }
+   */
+  setProperty(name: string | string.cssPropertyString, value?: string): void
+
+  /**
+   * 对CSS指定样式设置一个新值，如有此样式已存在则更新。
+   * @param name CSS样式名称
+   * @param value 要设置的新CSS样式值
+   * @deprecated 已废弃，仅为了向下兼容保留
+   * @uniPlatform {
+   *    "app": {
+   *        "android": {
+   *            "osVer": "5.0",
+   *            "uniVer": "x",
+   *            "unixVer": "3.9"
+   *        },
+   *        "ios": {
+   *            "osVer": "12.0",
+   *            "uniVer": "x",
+   *            "unixVer": "4.11"
+   *        },
+   *        "harmony": {
+   *            "osVer": "5.0.0",
+   *            "uniVer": "x",
+   *            "unixVer": "4.61",
+   *            "unixVer": "x"
+   *        }
+   *    },
+   *    "mp": {
+   *      "weixin": {
+   *        "osVer": "x",
+   *        "uniVer": "x",
+   *        "unixVer": "4.41"
+   *      }
+   *    },
+   *    "web": {
+   *        "uniVer": "x",
+   *        "unixVer": "4.0"
+   *    }
+   * }
+   */
+  setProperty(name: string | string.cssPropertyString, value: any | null): void
+
+  /**
+   * 获取CSS指定的样式值，如果指定的样式不存在则返回空字符串。
+   * @param property 要获取的CSS样式名称
+   * @uniPlatform {
+   *    "app": {
+   *        "android": {
+   *            "osVer": "5.0",
+   *            "uniVer": "x",
+   *            "unixVer": "4.51"
+   *        },
+   *        "ios": {
+   *            "osVer": "12.0",
+   *            "uniVer": "x",
+   *            "unixVer": "4.51"
+   *        },
+   *        "harmony": {
+   *            "osVer": "5.0.0",
+   *            "uniVer": "x",
+   *            "unixVer": "4.61"
+   *        }
+   *    },
+   *    "mp": {
+   *      "weixin": {
+   *        "osVer": "x",
+   *        "uniVer": "x",
+   *        "unixVer": "4.41"
+   *      }
+   *    },
+   *    "web": {
+   *        "uniVer": "x",
+   *        "unixVer": "4.0"
+   *    }
+   * }
+   */
+  getPropertyValue(property: string | string.cssPropertyString): string
+
+  /**
+   * 删除CSS指定的样式值
+   * @param property 要删除的CSS样式名称
+   * @uniPlatform {
+   *    "app": {
+   *        "android": {
+   *            "osVer": "5.0",
+   *            "uniVer": "x",
+   *            "unixVer": "4.51"
+   *        },
+   *        "ios": {
+   *            "osVer": "12.0",
+   *            "uniVer": "x",
+   *            "unixVer": "4.51"
+   *        },
+   *        "harmony": {
+   *            "osVer": "5.0.0",
+   *            "uniVer": "x",
+   *            "unixVer": "4.61",
+   *            "unixVaporVer": "x"
+   *        }
+   *    }
+   *    "web": {
+   *        "uniVer": "x",
+   *        "unixVer": "4.0"
+   *    }
+   * }
+   */
+  removeProperty(property: string | string.cssPropertyString): string
+}