@dcloudio/uni-app-x 0.7.99 → 0.7.100

package/package.json

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

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

@@ -17,52 +17,52 @@ declare global {
     | UniSharedDataFunctionEventListener
     | UniSharedDataFunctionSetTemplateRef
 
-  type UniSharedDataFunctionEventListener = (event : UniEvent) => void
-  type UniSharedDataFunctionSetTemplateRef = (el : UniElement) => void
+  type UniSharedDataFunctionEventListener = (event: UniEvent) => void
+  type UniSharedDataFunctionSetTemplateRef = (el: UniElement) => void
 
   class UniSharedData {
     /**
      * 所属文件
      * @internal
      */
-    _filename ?: string | null
+    _filename?: string | null
     /**
      * ArkTS/Kotlin/JavaScript 层数据缓存，主要用于判断属性值是否有变化
      * @internal
      */
-    _cacheProps : Map<string, UniSharedDataAny>
+    _cacheProps: Map<string, UniSharedDataAny>
     /**
      * 所属页面，用于批量执行响应式变更
      * @internal
      */
-    _scope : UniSharedDataPage
+    _scope: UniSharedDataPage
     /**
      * 是否已初始化完成，主要用于二次更新时触发响应式
      * @internal
      */
-    _setReady() : void
+    _setReady(): void
     /**
      * 属性变更时收集 Jobs
      * @internal
      */
-    _queueJobs : (key : string) => void
+    _queueJobs: (key: string) => void
     /**
      * 设置 callMethod，用于 script cpp 调用 $callMethod 方法
      * @internal
      */
-    _setCallMethod(fn : (...args : any[]) => void) : void
+    _setCallMethod(fn: (...args: any[]) => void): void
     /**
      * 重置当前数据对象的所有标记位
      * @internal
      */
-    _resetFlags() : void
-    constructor(scope : UniSharedDataPage)
+    _resetFlags(): void
+    constructor(scope: UniSharedDataPage)
   }
 
   enum UniSharedDataComponentStyleIsolation {
     Isolated,
     App,
-    AppAndPage
+    AppAndPage,
   }
 
   enum UniSharedDataComponentRenderer {
@@ -77,79 +77,103 @@ declare global {
   }
 
   interface UniSharedDataComponentOptions {
-    vueId : number
-    styleIsolation : UniSharedDataComponentStyleIsolation
-    renderer : UniSharedDataComponentRenderer
-    flatten : UniSharedDataComponentFlatten
+    vueId: number
+    styleIsolation: UniSharedDataComponentStyleIsolation
+    renderer: UniSharedDataComponentRenderer
+    flatten: UniSharedDataComponentFlatten
   }
 
   abstract class UniSharedDataComponent extends UniSharedData {
     /**
      * 组件的类名
      */
-    static className : string
+    static className: string
     /**
      * 当前页面或组件的样式表
      * @internal
      */
-    static styleSheet : Map<string, Map<string, Map<number, any>>>
+    static styleSheet: Map<string, Map<string, Map<number, any>>>
     /**
      * vue实例ID
      * @internal
      */
-    _vueId : number
+    _vueId: number
     /**
      * 当前页面或组件关联的 UniPage 对象
      * @internal
      */
-    _page : UniPage
+    _page: UniPage
     /**
      * 当前组件所在的上下文，主要用于查找上下文组件的样式表
      * @internal
      */
-    _ctx : UniSharedDataComponent | null
+    _ctx: UniSharedDataComponent | null
     /**
      * 当前组件或页面样式隔离策略
      */
-    _styleIsolation : UniSharedDataComponentStyleIsolation
+    _styleIsolation: UniSharedDataComponentStyleIsolation
     /**
      * 当前组件实例是否拍平
      */
-    _flatten : UniSharedDataComponentFlatten
+    _flatten: UniSharedDataComponentFlatten
     /**
      * 当前组件或页面渲染类型，页面也有可能作为组件来渲染
      */
-    _renderer : UniSharedDataComponentRenderer
+    _renderer: UniSharedDataComponentRenderer
     /**
      * 自定义组件需要透传的属性
      * @internal
      */
-    _inheritAttrs : UniSharedDataJSONObject
-    constructor(scope : UniSharedDataPage, options : UniSharedDataComponentOptions)
+    _inheritAttrs: UniSharedDataJSONObject
+    constructor(scope: UniSharedDataPage, options: UniSharedDataComponentOptions)
     /**
      * 自定义组件需要透传的属性，需要暴露给前端设置: set_inheritAttrs()
      * @param attrs
      */
-    set_inheritAttrs(attrs : UniSharedDataJSONObject) : void
+    set_inheritAttrs(attrs: UniSharedDataJSONObject): void
     /**
      * 监听组件根节点样式变更
      * @internal
      */
-    useComputedStyle(options : {
-      properties : number[]
-      filterProperties ?: boolean | null
-      callback : (result : Array<[string, any | null]>) => void
-    }) : Map<string, any | null>
+    useComputedStyle(options: {
+      properties: number[]
+      filterProperties?: boolean | null
+      callback: (result: Array<[string, any | null]>) => void
+    }): Map<string, any | null>
+    /**
+     * 目前仅限 android 平台
+     * 文本布局缓存数组
+     * @internal
+     */
+    _textLayouts: Array<[number, number, number]>
+    /**
+     * 目前仅限 android 平台
+     * 创建文本布局(先缓存，后批量同步至kotlin层)
+     * 接收三个参数：nodeId, fid, eid
+     * 内部存储为数组解构_textLayouts[[nodeId, fid, eid]]
+     * 应该统一存储在scope中（即页面上）
+     * @internal
+     */
+    _createTextLayout(nodeId: number, fid: number, eid: number): void
+    /**
+     * 目前仅限 android 平台
+     * 批量同步文本布局至kotlin层，kotlin层会根据_textLayouts数组进行处理（编译器生成指定函数switch执行具体的创建逻辑）
+     * 需要确保调用时机（确保在排版之前同步触发）：
+     * 当页面首次渲染时，在调用c层renderElement之后同步调用
+     * 当页面二次更新时，在flushJobs中所有element jobs执行完之后调用
+     * @internal
+     */
+    _flushTextLayouts(): void
     /**
      * 由编译器动态生成的子类中的 Element 渲染器
      * @internal
      */
-    abstract _renderElement() : UniElementBlock
+    abstract _renderElement(): UniElementBlock
     /**
      * 由编译器动态生成的子类中的 NativeView 渲染器
      * @internal
      */
-    abstract _renderNativeView() : UniNativeViewBlock
+    abstract _renderNativeView(): UniNativeViewBlock
   }
 
   abstract class UniSharedDataPage extends UniSharedDataComponent {
@@ -158,29 +182,29 @@ declare global {
      * key 是组件class名称
      * @internal
      */
-    _styleSheetCache : Map<string, Map<string, Map<string, Map<string, unknown>>>>
+    _styleSheetCache: Map<string, Map<string, Map<string, Map<string, unknown>>>>
     /**
      * 本次更新收集到的element Jobs，用于批量执行响应式变更(c层)
      * @internal
      */
-    _elementJobs : Array<ReactiveEffect<any | null>>
+    _elementJobs: Array<ReactiveEffect<any | null>>
     /**
      * 本次更新收集到的kotlin element Jobs，用于批量执行响应式变更
      * @internal
      */
-    _kotlinElementJobs : Array<ReactiveEffect<any | null>>
+    _kotlinElementJobs: Array<ReactiveEffect<any | null>>
     /**
      * 本次更新收集到的nativeView Jobs，用于批量执行响应式变更
      * @internal
      */
-    _nativeViewJobs : Array<ReactiveEffect<any | null>>
+    _nativeViewJobs: Array<ReactiveEffect<any | null>>
 
-    constructor(pageId : number, options : UniSharedDataComponentOptions)
+    constructor(pageId: number, options: UniSharedDataComponentOptions)
     /**
      * 批量执行响应式变更
      * @internal
      */
-    _flushJobs : () => Promise<void> | void
+    _flushJobs: () => Promise<void> | void
     /**
      * 页面渲染函数
      * 调用页面的 _renderElement 和 _renderNativeView
@@ -188,7 +212,7 @@ declare global {
      * 拿到两个渲染器执行后的 Block 后，插入到页面的根 NativeView 和根 Dom元素中
      * @internal
      */
-    _render : () => Promise<void>
+    _render: () => Promise<void>
   }
 
   abstract class UniSharedDataApp extends UniSharedData {
@@ -196,7 +220,7 @@ declare global {
      * 当前应用全局样式
      * @internal
      */
-    static styleSheet : Map<string, Map<string, Map<number, any>>>
+    static styleSheet: Map<string, Map<string, Map<number, any>>>
   }
 
   enum UniSharedDataVForDirty {
@@ -215,7 +239,7 @@ declare global {
   }
 
   type UniSharedDataVForMount = {
-    readonly index : number
+    readonly index: number
   }
 
   type UniSharedDataVForUnmount = {
@@ -223,9 +247,9 @@ declare global {
      * 需要移除的索引值
      * 重要：该索引值是oldBlocks中的索引值
      */
-    readonly index : number
-    readonly doRemove : boolean
-    readonly doDeregister : boolean
+    readonly index: number
+    readonly doRemove: boolean
+    readonly doDeregister: boolean
   }
 
   type UniSharedDataVForUpdate = {
@@ -233,21 +257,21 @@ declare global {
      * 需要更新的索引值
      * update((newBlocks[index] = oldBlocks[oldIndex]), getItem(source, i))
      */
-    readonly index : number
+    readonly index: number
     /**
      * 旧索引值
      */
-    readonly oldIndex : number
+    readonly oldIndex: number
   }
 
   class UniSharedDataVFor<T extends UniSharedData> extends UniSharedData {
-    setData(data : T[]) : void
-    setMount(mount : UniSharedDataVForMount[]) : void
-    setUnmount(unmount : UniSharedDataVForUnmount[]) : void
-    setUpdate(update : UniSharedDataVForUpdate[]) : void
-    setDirty(dirty : UniSharedDataVForDirty) : void
-    create : () => T
-    constructor(scope : UniSharedDataPage)
+    setData(data: T[]): void
+    setMount(mount: UniSharedDataVForMount[]): void
+    setUnmount(unmount: UniSharedDataVForUnmount[]): void
+    setUpdate(update: UniSharedDataVForUpdate[]): void
+    setDirty(dirty: UniSharedDataVForDirty): void
+    create: () => T
+    constructor(scope: UniSharedDataPage)
   }
 
   class VueReactivity { }
@@ -258,18 +282,21 @@ declare global {
 
   type InferSharedData<T, R extends UniSharedData = UniSharedData> = T extends keyof UniSharedDataRegistry ? UniSharedDataRegistry[T] : R
 
-  function useSharedData<T extends string>(scope : UniSharedDataPage) : InferSharedData<T>
+  function useSharedData<T extends string>(scope: UniSharedDataPage): InferSharedData<T>
 
-  function useSharedDataPage<T extends string>(pageIdOrScope : number | UniSharedDataPage, options : UniSharedDataComponentOptions) : InferSharedData<T, UniSharedDataPage>
+  function useSharedDataPage<T extends string>(
+    pageIdOrScope: number | UniSharedDataPage,
+    options: UniSharedDataComponentOptions,
+  ): InferSharedData<T, UniSharedDataPage>
 
   function useSharedDataComponent<T extends string>(
-    scope : UniSharedDataPage,
-    options : UniSharedDataComponentOptions
-  ) : InferSharedData<T, UniSharedDataComponent>
+    scope: UniSharedDataPage,
+    options: UniSharedDataComponentOptions,
+  ): InferSharedData<T, UniSharedDataComponent>
 
-  function useSharedDataVFor<T, S extends UniSharedData>(sharedDataVFor : S) : S
+  function useSharedDataVFor<T, S extends UniSharedData>(sharedDataVFor: S): S
 
-  function useSharedDataRecycleVFor<T, S extends UniSharedData>(sharedDataVFor : S) : S
+  function useSharedDataRecycleVFor<T, S extends UniSharedData>(sharedDataVFor: S): S
 }
 
 export { }