vite-plugin-taro-runtime 0.7.12-beta.1 → 0.7.13

package/dist/plugin-framework-react/runtime.js

@@ -1,16 +1,6 @@
 import { EMPTY_OBJ, isArray, isFunction, hooks, ensure, isUndefined } from '@tarojs/shared';
-import { Current, getPageInstance, injectPageInstance, incrementId, document, perf, PAGE_INIT, CONTAINER, window, CONTEXT_ACTIONS, safeExecute, ON_HIDE, eventCenter, getOnHideEventKey, ON_SHOW, requestAnimationFrame, getOnShowEventKey, ON_READY, getOnReadyEventKey, removePageInstance, getPath, eventHandler, addLeadingSlash, hydrate } from '@tarojs/runtime';
+import { Current, getPageInstance, injectPageInstance, incrementId, document, perf, PAGE_INIT, CONTAINER, window, CONTEXT_ACTIONS, safeExecute, ON_HIDE, eventCenter, getOnHideEventKey, ON_SHOW, requestAnimationFrame, getOnShowEventKey, ON_READY, getOnReadyEventKey, removePageInstance, getPath, eventHandler, addLeadingSlash } from '@tarojs/runtime';
 
-/**
- * WX App-wrap flow:
- *
- * React still owns one root in which every Page remains an ordinary child of the singleton App. Native WX rendering,
- * however, is driven by independent Page.setData surfaces, so App hosts above those Page roots have no scheduler of their
- * own. The Mini Program branch below gives the App host an app.* scheduler, fans its deltas into every mounted Page, places
- * one opaque outlet at App {children}, and seeds each new Page with the current App snapshot in its first native batch.
- * hydrate() is needed only for that initial snapshot; the patched runtime stops traversal at the outlet so Page roots stay
- * in the React/Taro ownership tree without being copied into app data.
- */
 const reactMeta = {
     PageContext: EMPTY_OBJ,
     R: EMPTY_OBJ,
@@ -266,29 +256,6 @@ function connectReactPage(R, id) {
         };
     };
 }
-/**
- * One App reconciliation produces one granular app.* batch, while WX stores an App mirror inside every mounted native
- * Page. Resolve the native stack only when that batch flushes instead of maintaining a second Page registry or active-Page
- * tracker. WeChat orders getCurrentPages() from the oldest hidden Page to the current visible Page, so forEach dispatches
- * all hidden surfaces first. Only the final current Page receives Taro's callback: every setData call has then been issued,
- * and Taro's scheduler completes its batch exactly once rather than coordinating one callback per Page.
- */
-function broadcastAppUpdate(data, callback) {
-    const pages = getCurrentPages();
-    const currentPage = pages[pages.length - 1];
-    if (!currentPage) {
-        callback();
-        return;
-    }
-    pages.forEach(page => {
-        if (page === currentPage) {
-            page.setData(data, callback);
-        }
-        else {
-            page.setData(data);
-        }
-    });
-}
 /**
  * 桥接小程序 App 构造器和 React 渲染流程
  * @param App 用户编写的入口组件
@@ -335,21 +302,9 @@ function createReactApp(App, react, dom, config) {
             container.id = appId;
             appContainer === null || appContainer === void 0 ? void 0 : appContainer.appendChild(container);
         }
-        /*
-         * renderReactRoot runs only for the Mini Program branch. The patched WX document makes this App container a
-         * TaroRootElement, so it serves simultaneously as React's existing host container and Taro's App scheduler; its
-         * structural _path is app and its _root is itself. Assign only the native sink that fans Taro's normal granular
-         * batches across Page surfaces. No detached scheduler node, second React root, or host-property override participates.
-         */
-        container.ctx = { setData: broadcastAppUpdate };
         // VPT requires React 19: both the Mini renderer and react-dom/client provide concurrent roots.
         const root = ReactDOM$1.createRoot(container);
         root.render(h$1(AppWrapper));
-        /*
-         * Return the exact host passed to ReactDOM. AppWrapper.mount closes over this immutable value when a Page is added,
-         * guaranteeing that its initial snapshot comes from the same singleton App tree without a host registry or lookup.
-         */
-        return container;
     }
     class AppWrapper extends react.Component {
         constructor(props) {
@@ -371,19 +326,6 @@ function createReactApp(App, react, dom, config) {
             }
             this.forceUpdate((...args) => {
                 perf.stop(PAGE_INIT);
-                if (process.env.TARO_PLATFORM !== 'web') {
-                    /*
-                     * React has now committed the Page root, but createPageConfig has not yet attached the native Page ctx or
-                     * called performUpdate(true). Queue a lazy app.cn snapshot beside the Page root's already-pending page.*
-                     * payloads. Taro therefore resolves both in one initial setData: no blank App frame, second bridge write,
-                     * Page-ready phase, or custom pending queue. Patched hydrate() stops at the outlet before Page roots.
-                     */
-                    const pageRoot = document.getElementById(id);
-                    pageRoot.enqueueUpdate({
-                        path: 'app.cn',
-                        value: () => hydrate(container).cn
-                    });
-                }
                 return cb(...args);
             });
         }
@@ -417,11 +359,9 @@ function createReactApp(App, react, dom, config) {
             return h$1(App, props, children);
         }
     }
-    /*
-     * Mini Program lifecycle mounting is internal to this runtime, so create and retain exactly one App host for every Page
-     * mount callback to snapshot. Web keeps upstream external mounting and never executes the WX scheduler/outlet path.
-     */
-    const container = process.env.TARO_PLATFORM !== 'web' ? renderReactRoot() : null;
+    if (process.env.TARO_PLATFORM !== 'web') {
+        renderReactRoot();
+    }
     const [ONLAUNCH, ONSHOW, ONHIDE] = hooks.call('getMiniLifecycleImpl').app;
     const appObj = Object.create({
         render(cb) {

package/dist/react/react.esm.js

@@ -32,6 +32,7 @@ function getEventPriority(domEventName) {
     switch (domEventName) {
         case 'cancel':
         case 'click':
+        case 'tap':
         case 'close':
         case 'contextmenu':
         case 'copy':
@@ -660,7 +661,8 @@ const hostConfig = {
     getChildHostContext(parentHostContext) {
         return parentHostContext;
     },
-    prepareForCommit(..._) {
+    prepareForCommit(container) {
+        host.beforeCommit?.(container);
         return null;
     },
     resetAfterCommit(container) {

package/dist/react/renderer-host.d.ts

@@ -1,7 +1,8 @@
-/** Host-owned creation, form classification and post-commit work for the shared React renderer. */
+/** Host-owned creation, form classification and commit boundaries for the shared React renderer. */
 export type RendererHost<Container, Context, Element, Text> = Readonly<{
     createElement(container: Container, context: Context, type: string): Element
     createText(container: Container, context: Context, text: string): Text
     isFormElement(element: Element): boolean
+    beforeCommit?(container: Container): void
     afterCommit(container: Container): void
 }>

package/dist/runtime/dom/element.d.ts

@@ -30,7 +30,11 @@ declare class TaroElement extends TaroNode {
     set focus(value: () => void);
     blur(): void;
     setAttribute(qualifiedName: string, value: any): void;
+    /** Delegates after logical storage and ID/dataset updates; the flag records the prior template view classification. */
+    delegateAttributeUpdate(qualifiedName: string, value: unknown, isPureView: boolean): void;
     removeAttribute(qualifiedName: string): void;
+    /** Delegates after successful logical removal; the flag records the prior template view classification. */
+    delegateAttributeRemoval(qualifiedName: string, isStaticView: boolean): void;
     getAttribute(qualifiedName: string): string;
     getElementsByTagName(tagName: string): TaroElement[];
     getElementsByClassName(className: string): TaroElement[];

package/dist/runtime/dom/element.js

@@ -124,6 +124,10 @@ class TaroElement extends TaroNode {
                 }
                 break;
         }
+        this.delegateAttributeUpdate(qualifiedName, value, isPureView);
+    }
+    /** Delegates the stored attribute value; isPureView preserves the pre-mutation template classification. */
+    delegateAttributeUpdate(qualifiedName, value, isPureView) {
         // Serialization
         if (!this._root)
             return;
@@ -185,6 +189,10 @@ class TaroElement extends TaroNode {
             }
             delete this.props[qualifiedName];
         }
+        this.delegateAttributeRemoval(qualifiedName, isStaticView);
+    }
+    /** Delegates a completed removal; interrupted and absent attributes retain their original early returns. */
+    delegateAttributeRemoval(qualifiedName, isStaticView) {
         // Serialization
         if (!this._root)
             return;

package/dist/runtime/dom/node.d.ts

@@ -20,7 +20,8 @@ declare class TaroNode extends TaroEventTarget {
     childNodes: TaroNode[];
     constructor();
     private hydrate;
-    private updateChildNodes;
+    /** Delegates a complete child-list update, including the final reset after element textContent changes. */
+    delegateChildReset(isClean?: boolean): void;
     private updateSingleChild;
     get _root(): TaroRootElement | null;
     get _scope(): MpInstance | null | undefined;
@@ -71,6 +72,16 @@ declare class TaroNode extends TaroEventTarget {
      *   2. remove C
      */
     removeChild<T extends TaroNode>(child: T, options?: RemoveChildOptions): T;
+    /**
+     * Delegates an insertion after Taro updates its tree, including detached parents.
+     * The index is the insertion offset when refChild is supplied. The default prepares template payloads.
+     */
+    delegateChildInsertion(newChild: TaroNode, refChild: TaroNode | null | undefined, index: number, isReplace: boolean | undefined): void;
+    /**
+     * Delegates a removal after logical detachment and event identity cleanup.
+     * Every removal is forwarded; options.doUpdate only suppresses the default template update.
+     */
+    delegateChildRemoval(child: TaroNode, options: RemoveChildOptions): void;
     remove(options?: RemoveChildOptions): void;
     hasChildNodes(): boolean;
     enqueueUpdate(payload: UpdatePayload): void;

package/dist/runtime/dom/node.js

@@ -20,7 +20,8 @@ class TaroNode extends TaroEventTarget {
         this.sid = this.uid; // dom 节点全局唯一 id，不可被修改
         eventSource.set(this.sid, this);
     }
-    updateChildNodes(isClean) {
+    /** Delegates a complete child-list update; the default hydrates lazily or emits an empty list. */
+    delegateChildReset(isClean) {
         const cleanChildNodes = () => [];
         const rerenderChildNodes = () => {
             const childNodes = this.childNodes.filter(node => !isComment(node));
@@ -101,13 +102,13 @@ class TaroNode extends TaroEventTarget {
             this.removeChild(this.firstChild, { doUpdate: false });
         }
         if (text === '') {
-            this.updateChildNodes(true);
+            this.delegateChildReset(true);
         }
         else {
             const newText = env.document.createTextNode(text);
             addedNodes.push(newText);
             this.appendChild(newText);
-            this.updateChildNodes();
+            this.delegateChildReset();
         }
         // @Todo: appendChild 会多触发一次
         MutationObserver.record({
@@ -149,52 +150,9 @@ class TaroNode extends TaroEventTarget {
             // appendChild
             this.childNodes.push(newChild);
         }
-        const childNodesLength = this.childNodes.length;
-        // Serialization
-        if (this._root) {
-            if (!refChild) {
-                // appendChild
-                const isOnlyChild = childNodesLength === 1;
-                if (isOnlyChild) {
-                    this.updateChildNodes();
-                }
-                else {
-                    this.enqueueUpdate({
-                        path: newChild._path,
-                        value: this.hydrate(newChild)
-                    });
-                }
-            }
-            else if (isReplace) {
-                // replaceChild
-                this.enqueueUpdate({
-                    path: newChild._path,
-                    value: this.hydrate(newChild)
-                });
-            }
-            else {
-                // insertBefore 有两种更新模式
-                // 比方说有 A B C 三个节点，现在要在 C 前插入 D
-                // 1. 插入 D，然后更新整个父节点的 childNodes 数组
-                // setData({ cn: [A, B, D, C] })
-                // 2. 插入 D，然后更新 D 以及 D 之后每个节点的数据
-                // setData ({
-                //   cn.[2]: D,
-                //   cn.[3]: C,
-                // })
-                // 由于微信解析 ’cn.[2]‘ 这些路径的时候也需要消耗时间，
-                // 所以根据 insertBefore 插入的位置来做不同的处理
-                const mark = childNodesLength * 2 / 3;
-                if (mark > index) {
-                    // 如果 insertBefore 的位置在 childNodes 的 2/3 前，则为了避免解析路径消耗过多的时间，采用第一种方式
-                    this.updateChildNodes();
-                }
-                else {
-                    // 如果 insertBefore 的位置在 childNodes 的 2/3 之后，则采用第二种方式，避免 childNodes 的全量更新
-                    this.updateSingleChild(index);
-                }
-            }
-        }
+        // Delegation runs after the logical insertion, including on detached parents.
+        // Its default implementation prepares template payloads; native hosts can replace it before any serialization work.
+        this.delegateChildInsertion(newChild, refChild, index, isReplace);
         if (this._root) {
             bumpNearestCtxEpochForRoot(this._root);
         }
@@ -270,15 +228,68 @@ class TaroNode extends TaroEventTarget {
         if (cleanRef !== false) {
             eventSource.removeNodeTree(child);
         }
-        // Serialization
-        if (this._root && doUpdate !== false) {
-            this.updateChildNodes();
-        }
+        // Forward every removal. doUpdate controls template batching, not whether the logical child was removed.
+        this.delegateChildRemoval(child, options);
         if (this._root) {
             bumpNearestCtxEpochForRoot(this._root);
         }
         return child;
     }
+    /** Delegates an insertion after Taro has updated parentNode and childNodes. */
+    delegateChildInsertion(newChild, refChild, index, isReplace) {
+        const childNodesLength = this.childNodes.length;
+        // Serialization
+        if (this._root) {
+            if (!refChild) {
+                // appendChild
+                const isOnlyChild = childNodesLength === 1;
+                if (isOnlyChild) {
+                    this.delegateChildReset();
+                }
+                else {
+                    this.enqueueUpdate({
+                        path: newChild._path,
+                        value: this.hydrate(newChild)
+                    });
+                }
+            }
+            else if (isReplace) {
+                // replaceChild
+                this.enqueueUpdate({
+                    path: newChild._path,
+                    value: this.hydrate(newChild)
+                });
+            }
+            else {
+                // insertBefore 有两种更新模式
+                // 比方说有 A B C 三个节点，现在要在 C 前插入 D
+                // 1. 插入 D，然后更新整个父节点的 childNodes 数组
+                // setData({ cn: [A, B, D, C] })
+                // 2. 插入 D，然后更新 D 以及 D 之后每个节点的数据
+                // setData ({
+                //   cn.[2]: D,
+                //   cn.[3]: C,
+                // })
+                // 由于微信解析 ’cn.[2]‘ 这些路径的时候也需要消耗时间，
+                // 所以根据 insertBefore 插入的位置来做不同的处理
+                const mark = childNodesLength * 2 / 3;
+                if (mark > index) {
+                    // 如果 insertBefore 的位置在 childNodes 的 2/3 前，则为了避免解析路径消耗过多的时间，采用第一种方式
+                    this.delegateChildReset();
+                }
+                else {
+                    // 如果 insertBefore 的位置在 childNodes 的 2/3 之后，则采用第二种方式，避免 childNodes 的全量更新
+                    this.updateSingleChild(index);
+                }
+            }
+        }
+    }
+    /** Delegates a removal after logical detachment and event identity cleanup. */
+    delegateChildRemoval(_child, options) {
+        if (this._root && options.doUpdate !== false) {
+            this.delegateChildReset();
+        }
+    }
     remove(options) {
         var _a;
         (_a = this.parentNode) === null || _a === void 0 ? void 0 : _a.removeChild(this, options);
@@ -287,15 +298,6 @@ class TaroNode extends TaroEventTarget {
         return this.childNodes.length > 0;
     }
     enqueueUpdate(payload) {
-        /*
-         * The outlet is the structural boundary between singleton App hosts and Page roots in Taro's in-memory tree. Its
-         * children must remain attached there for React ancestry, event ownership, unmounting, and Taro parent links, while
-         * each Page root independently schedules its own page.* native updates. Allowing outlet child mutations to bubble
-         * into the App scheduler would fan Page topology out as app.* data and duplicate work across every mounted Page.
-         * Suppress only this native update propagation; do not change the in-memory childNodes relationship.
-         */
-        if (this.nodeName === 'vpt_page_outlet')
-            return;
         var _a;
         (_a = this._root) === null || _a === void 0 ? void 0 : _a.enqueueUpdate(payload);
     }

package/dist/runtime/dom/root.js

@@ -1,5 +1,5 @@
 import { hooks, isFunction, isArray, isUndefined } from '@tarojs/shared';
-import { ROOT_STR, SET_DATA, PAGE_INIT, CUSTOM_WRAPPER, CONTAINER } from '../constants/index.js';
+import { ROOT_STR, SET_DATA, PAGE_INIT, CUSTOM_WRAPPER } from '../constants/index.js';
 import { options } from '../options.js';
 import { perf } from '../perf.js';
 import { isComment, customWrapperCache } from '../utils/index.js';
@@ -50,14 +50,7 @@ class TaroRootElement extends TaroElement {
         this.tagName = ROOT_STR.toUpperCase();
     }
     get _path() {
-        /*
-         * Both the singleton App host and every Page host are now real TaroRootElement schedulers. Their structural parent
-         * distinguishes ownership without a mode flag: the App root is the sole root directly below the document's
-         * <container>, while Page roots live below vpt_page_outlet. Every descendant derives its setData path from this one
-         * prefix, yielding direct app.* and page.* payloads without host overrides or per-update path translation. nodeName
-         * remains root in both cases, preserving Taro's host, event, and scheduler semantics.
-         */
-        return this.parentNode && this.parentNode.nodeName === CONTAINER ? 'app' : 'page';
+        return ROOT_STR;
     }
     get _root() {
         return this;
@@ -83,13 +76,14 @@ class TaroRootElement extends TaroElement {
             perf.start(setDataMark);
             const data = Object.create(null);
             /*
-             * During the first render Taro replaces the leading child array and removes redundant descendant writes from
-             * that same batch. For Page roots, _path emits page.*, so upstream's literal root.cn reset paths no longer match those queued
-             * payloads; the optimization would miss them and could also target a native key that does not exist. Align the
-             * two initial literals with page.cn so initial and steady-state scheduling obey one namespace.
+             * During the first render Taro replaces the leading child and removes redundant descendant writes from that
+             * same batch. Reset paths must use the root's actual _path, just like ordinary descendant payloads: VPT's App
+             * and Page schedulers use app.* and page.*, while the default root uses root.*. Recognize both indexed-path
+             * spellings so descendant writes are discarded before their lazy values are evaluated. Initial and
+             * steady-state scheduling therefore share one namespace for every root.
              */
             const resetPaths = new Set(initRender
-                ? ['page.cn.[0]', 'page.cn[0]']
+                ? [`${this._path}.cn.[0]`, `${this._path}.cn[0]`]
                 : []);
             while (this.updatePayloads.length > 0) {
                 const { path, value } = this.updatePayloads.shift();

package/dist/runtime/dom/style.d.ts

@@ -9,6 +9,8 @@ declare class Style {
     private setCssVariables;
     get cssText(): string;
     set cssText(str: string);
+    /** Delegates after logical style changes and cssText batching, before the default template payload is prepared. */
+    delegateStyleUpdate(): void;
     setProperty(propertyName: string, value?: string | null): void;
     removeProperty(propertyName: string): string;
     getPropertyValue(propertyName: string): any;

package/dist/runtime/dom/style.js

@@ -11,15 +11,6 @@ function recordCss(obj) {
         oldValue: obj.cssText
     });
 }
-function enqueueUpdate(obj) {
-    const element = obj._element;
-    if (element._root) {
-        element.enqueueUpdate({
-            path: `${element._path}.${"st" /* Shortcuts.Style */}`,
-            value: obj.cssText
-        });
-    }
-}
 function setStyle(newVal, styleKey) {
     process.env.NODE_ENV !== 'production' && warn(isString(newVal) && newVal.length > PROPERTY_THRESHOLD, `Style 属性 ${styleKey} 的值数据量过大，可能会影响渲染性能，考虑使用 CSS 类或其它方案替代。`);
     const old = this[styleKey];
@@ -34,7 +25,7 @@ function setStyle(newVal, styleKey) {
         this._usedStyleProp.add(styleKey);
         this._value[styleKey] = newVal;
     }
-    !this._pending && enqueueUpdate(this);
+    !this._pending && this.delegateStyleUpdate();
 }
 function initStyle(ctor, styleProperties) {
     const properties = {};
@@ -99,7 +90,7 @@ class Style {
         });
         if (str === '' || isUndefined(str) || isNull(str)) {
             this._pending = false;
-            enqueueUpdate(this);
+            this.delegateStyleUpdate();
             return;
         }
         const rules = str.split(';');
@@ -117,7 +108,17 @@ class Style {
             this.setProperty(propName.trim(), val.trim());
         }
         this._pending = false;
-        enqueueUpdate(this);
+        this.delegateStyleUpdate();
+    }
+    /** Delegates the completed style mutation; cssText assignments finish their synchronous batch before calling it. */
+    delegateStyleUpdate() {
+        const element = this._element;
+        if (element._root) {
+            element.enqueueUpdate({
+                path: `${element._path}.${"st" /* Shortcuts.Style */}`,
+                value: this.cssText
+            });
+        }
     }
     setProperty(propertyName, value) {
         if (propertyName[0] === '-') {

package/dist/runtime/dom/text.d.ts

@@ -12,6 +12,11 @@ declare class TaroText extends TaroNode {
     get nodeValue(): string;
     set data(text: string);
     get data(): string;
+    /**
+     * Delegates a text update after Taro records the mutation and stores the logical value.
+     * The default prepares the template payload; textContent, nodeValue and data share this boundary.
+     */
+    delegateTextUpdate(text: string): void;
 }
 
 export { TaroText };

package/dist/runtime/dom/text.js

@@ -15,10 +15,7 @@ class TaroText extends TaroNode {
             oldValue: this._value
         });
         this._value = text;
-        this.enqueueUpdate({
-            path: `${this._path}.${"v" /* Shortcuts.Text */}`,
-            value: text
-        });
+        this.delegateTextUpdate(text);
     }
     get textContent() {
         return this._value;
@@ -35,6 +32,13 @@ class TaroText extends TaroNode {
     get data() {
         return this._value;
     }
+    /** Delegates the logical value after its mutation record; hosts can replace template payload preparation. */
+    delegateTextUpdate(text) {
+        this.enqueueUpdate({
+            path: `${this._path}.${"v" /* Shortcuts.Text */}`,
+            value: text
+        });
+    }
 }
 
 export { TaroText };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vite-plugin-taro-runtime",
-  "version": "0.7.12-beta.1",
+  "version": "0.7.13",
   "description": "Taro runtime, React, and platform support for vite-plugin-taro.",
   "author": "sep2",
   "license": "MIT",
@@ -11,6 +11,11 @@
       "import": "./dist/runtime/index.js",
       "default": "./dist/runtime/index.js"
     },
+    "./runtime/tt-document": {
+      "types": "./types/tt-document.d.ts",
+      "import": "./dist/runtime/bom/document.js",
+      "default": "./dist/runtime/bom/document.js"
+    },
     "./runtime/h5": {
       "types": "./dist/runtime/runtime.esm.d.ts",
       "import": "./dist/runtime/runtime.esm.js",
@@ -109,6 +114,7 @@
   },
   "files": [
     "dist",
+    "types",
     "LICENSE",
     "README.md"
   ],

package/types/tt-document.d.ts

@@ -0,0 +1,38 @@
+import type { MpEvent } from 'vite-plugin-taro-runtime/runtime/mini'
+
+/** TT SDK nodes are Page-local presentation instances; React refs retain TaroNode identities. */
+export interface TTNativeNode {
+    readonly nodeType: number
+    readonly childNodes: readonly TTNativeNode[]
+    readonly firstChild: TTNativeNode | null
+    readonly nextSibling: TTNativeNode | null
+    readonly parentNode: TTNativeNode | null
+    nodeValue: string
+    appendChild(child: TTNativeNode): void
+    insertBefore(child: TTNativeNode, before: TTNativeNode | null): void
+    removeChild(child: TTNativeNode): void
+}
+
+export interface TTNativeElement extends TTNativeNode {
+    id: string
+    readonly attributes: Readonly<Record<string, unknown>>
+    setAttribute(name: string, value: unknown): void
+    removeAttribute(name: string): void
+    addEventListener(name: string, listener: (event: MpEvent) => unknown): void
+    removeEventListener(name: string, listener: (event: MpEvent) => unknown): void
+}
+
+export interface TTNativeComponent extends TTNativeElement {
+    readonly componentName: string
+    /** SDK native components accept their default-slot value as one node or an array of nodes. */
+    appendChild(children: TTNativeNode | readonly TTNativeNode[]): void
+}
+
+export interface TTNativeDocument {
+    getPageDocumentById(id: number): TTNativeElement | undefined
+    createElement(name: string): TTNativeElement
+    createTextNode(text: string): TTNativeNode
+}
+
+/** Adapts the current TT appDocument through Taro's existing native document factory. */
+export declare function createTTDomDocument(): TTNativeDocument