@dcloudio/uni-app-x 0.7.113 → 0.7.114

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/uni/uts-plugin-api/lib/uni-editor/utssdk/interface.d.ts

@@ -848,9 +848,8 @@ export interface Uni {
    *  }
    * }
    *
-   * @tutorial-uni-app https://uniapp.dcloud.net.cn/api/location/editor.html#createeditorcontext
-   * @tutorial-uni-app-x https://doc.dcloud.net.cn/uni-app-x/api/create-editor-context.html
-   * @tutorial https://doc.dcloud.net.cn/uni-app-x/api/create-editor-context.html
+   * @tutorial_uni_app_x https://doc.dcloud.net.cn/uni-app-x/api/create-editor-context-async.html
+   * @tutorial https://doc.dcloud.net.cn/uni-app-x/api/create-editor-context-async.html
    */
   createEditorContextAsync : CreateEditorContextAsync
 }

package/types/uni/uts-plugin-component/lib/uni-editor/utssdk/interface.d.ts

@@ -848,9 +848,8 @@ export interface Uni {
    *  }
    * }
    *
-   * @tutorial-uni-app https://uniapp.dcloud.net.cn/api/location/editor.html#createeditorcontext
-   * @tutorial-uni-app-x https://doc.dcloud.net.cn/uni-app-x/api/create-editor-context.html
-   * @tutorial https://doc.dcloud.net.cn/uni-app-x/api/create-editor-context.html
+   * @tutorial_uni_app_x https://doc.dcloud.net.cn/uni-app-x/api/create-editor-context-async.html
+   * @tutorial https://doc.dcloud.net.cn/uni-app-x/api/create-editor-context-async.html
    */
   createEditorContextAsync : CreateEditorContextAsync
 }