@lynx-js/react 0.120.0 → 0.121.0

package/runtime/lib/element-template/background/instance.js

@@ -0,0 +1,349 @@
+// Copyright 2024 The Lynx Authors. All rights reserved.
+// Licensed under the Apache License Version 2.0 that can be found in the
+// LICENSE file in the root directory of this source tree.
+import { prepareAttributeSlots as prepareRawAttributeSlots } from './attr-slots.js';
+import { globalCommitContext, markRemovedSubtreeForCurrentCommit } from './commit-context.js';
+import { isElementTemplateHydrated } from './commit-hook.js';
+import { backgroundElementTemplateInstanceManager } from './manager.js';
+import { isDirectOrDeepEqual } from '../../utils.js';
+import { ElementTemplateUpdateOps } from '../protocol/opcodes.js';
+function pushOp(...items) {
+    globalCommitContext.ops.push(...items);
+}
+export const BUILTIN_RAW_TEXT_TEMPLATE_KEY = '_et_builtin_raw_text';
+function isBuiltinRawTextTemplateKey(type) {
+    return type === BUILTIN_RAW_TEXT_TEMPLATE_KEY;
+}
+function stringifyRawTextValue(value) {
+    if (typeof value === 'string') {
+        return value;
+    }
+    if (typeof value === 'number' || typeof value === 'boolean') {
+        return String(value);
+    }
+    return '';
+}
+function syncElementSlotChildren(parent, slotId, children) {
+    if (!parent || slotId < 0) {
+        return;
+    }
+    parent.elementSlots[slotId] = [...children];
+}
+export class BackgroundElementTemplateInstance {
+    instanceId = 0; // Assigned by manager
+    type;
+    parent = null;
+    firstChild = null;
+    lastChild = null;
+    nextSibling = null;
+    previousSibling = null;
+    // Shadow State for Hydration
+    attributeSlots;
+    elementSlots = [];
+    rawAttributeSlots;
+    hasEmittedCreate = false;
+    get parentNode() {
+        return this.parent;
+    }
+    get childNodes() {
+        const nodes = [];
+        let child = this.firstChild;
+        while (child) {
+            nodes.push(child);
+            child = child.nextSibling;
+        }
+        return nodes;
+    }
+    nodeType;
+    constructor(type, initialAttributeSlots) {
+        this.type = type;
+        this.nodeType = isBuiltinRawTextTemplateKey(type) ? 3 : 1;
+        backgroundElementTemplateInstanceManager.register(this);
+        if (initialAttributeSlots) {
+            const preparedSlots = prepareRawAttributeSlots(this.type, this.instanceId, initialAttributeSlots);
+            this.attributeSlots = preparedSlots;
+            if (preparedSlots !== initialAttributeSlots) {
+                this.rawAttributeSlots = initialAttributeSlots;
+            }
+        }
+        else {
+            this.attributeSlots = [];
+        }
+    }
+    emitCreate() {
+        if (this.hasEmittedCreate) {
+            return;
+        }
+        if (this.instanceId === 0 && __DEV__) {
+            lynx.reportError(new Error('ElementTemplate patch has illegal handleId 0.'));
+            return;
+        }
+        pushOp(ElementTemplateUpdateOps.createTemplate, this.instanceId, this.type, null, this.attributeSlots, this.elementSlots.map((children) => children.map((child) => child.instanceId)));
+        this.hasEmittedCreate = true;
+    }
+    isPendingCreate() {
+        return this.instanceId > 0 && !this.hasEmittedCreate;
+    }
+    canEmitPatch() {
+        // Background tree construction is local until hydrate binds it to main-thread
+        // instances. Only hydrated and already-created owners can emit update ops.
+        return isElementTemplateHydrated() && !this.isPendingCreate();
+    }
+    // DOM API for Preact
+    appendChild(child) {
+        this.insertBefore(child, null);
+    }
+    insertBefore(child, beforeChild, silent) {
+        if (beforeChild === child) {
+            throw new Error('Cannot insert a node before itself');
+        }
+        if (beforeChild && beforeChild.parent !== this) {
+            throw new Error('Reference node is not a child of this parent');
+        }
+        if (child.parent) {
+            child.parent.removeChild(child, true);
+        }
+        child.parent = this;
+        if (beforeChild) {
+            child.nextSibling = beforeChild;
+            child.previousSibling = beforeChild.previousSibling;
+            if (beforeChild.previousSibling) {
+                beforeChild.previousSibling.nextSibling = child;
+            }
+            else {
+                this.firstChild = child;
+            }
+            beforeChild.previousSibling = child;
+        }
+        else {
+            if (this.lastChild) {
+                this.lastChild.nextSibling = child;
+                child.previousSibling = this.lastChild;
+            }
+            else {
+                this.firstChild = child;
+            }
+            this.lastChild = child;
+            child.nextSibling = null;
+        }
+        if (child instanceof BackgroundElementTemplateSlot) {
+            syncElementSlotChildren(this, child.partId, collectChildren(child));
+        }
+        if (this instanceof BackgroundElementTemplateSlot) {
+            const slotId = this.partId;
+            const parent = this.parent;
+            if (parent) {
+                syncElementSlotChildren(parent, slotId, collectChildren(this));
+            }
+            if (silent) {
+                return;
+            }
+            if (slotId !== -1 && parent) {
+                if (!parent.canEmitPatch()) {
+                    return;
+                }
+                const beforeId = beforeChild ? beforeChild.instanceId : 0;
+                emitCreateRecursive(child);
+                pushOp(ElementTemplateUpdateOps.insertNode, parent.instanceId, slotId, child.instanceId, beforeId);
+            }
+            return;
+        }
+        if (silent) {
+            return;
+        }
+    }
+    removeChild(child, silent) {
+        if (child.parent !== this) {
+            throw new Error('Node is not a child of this parent');
+        }
+        if (child.previousSibling) {
+            child.previousSibling.nextSibling = child.nextSibling;
+        }
+        else {
+            this.firstChild = child.nextSibling;
+        }
+        if (child.nextSibling) {
+            child.nextSibling.previousSibling = child.previousSibling;
+        }
+        else {
+            this.lastChild = child.previousSibling;
+        }
+        child.parent = null;
+        child.nextSibling = null;
+        child.previousSibling = null;
+        if (child instanceof BackgroundElementTemplateSlot && child.partId >= 0) {
+            this.elementSlots[child.partId] = [];
+        }
+        if (this instanceof BackgroundElementTemplateSlot) {
+            const slotId = this.partId;
+            const parent = this.parent;
+            if (parent) {
+                syncElementSlotChildren(parent, slotId, collectChildren(this));
+            }
+            if (silent) {
+                return;
+            }
+            if (slotId !== -1 && parent) {
+                if (!parent.canEmitPatch()) {
+                    if (child.isPendingCreate()) {
+                        // A never-created subtree has no main-thread registry entry, so it
+                        // can be released from the background manager without delayed cleanup.
+                        child.tearDown();
+                    }
+                    return;
+                }
+                pushOp(ElementTemplateUpdateOps.removeNode, parent.instanceId, slotId, child.instanceId, collectElementTemplateSubtreeHandleIds(child));
+                // The removed JS object graph may outlive the detach until GC, so keep
+                // it pending and tear it down on the Snapshot-aligned delayed boundary.
+                markRemovedSubtreeForCurrentCommit(child);
+            }
+            return;
+        }
+        if (silent) {
+            return;
+        }
+    }
+    tearDown() {
+        // Recursively tear down children first
+        let child = this.firstChild;
+        while (child) {
+            const next = child.nextSibling;
+            child.tearDown();
+            child = next;
+        }
+        // Clear references
+        this.parent = null;
+        this.firstChild = null;
+        this.lastChild = null;
+        this.previousSibling = null;
+        this.nextSibling = null;
+        this.attributeSlots = [];
+        this.rawAttributeSlots = undefined;
+        this.elementSlots = [];
+        // Remove from manager
+        if (this.instanceId) {
+            backgroundElementTemplateInstanceManager.values.delete(this.instanceId);
+        }
+    }
+    getRawAttributeSlot(attrSlotIndex) {
+        return this.rawAttributeSlots?.[attrSlotIndex] ?? this.attributeSlots[attrSlotIndex];
+    }
+    markCreateEmittedForHydration() {
+        // Hydration binds this object to a template that already exists on the main
+        // thread; future updates must treat it as created without emitting create.
+        this.hasEmittedCreate = true;
+    }
+    prepareAttributeSlotsForNative() {
+        if (!this.rawAttributeSlots) {
+            return;
+        }
+        this.attributeSlots = prepareRawAttributeSlots(this.type, this.instanceId, this.rawAttributeSlots);
+    }
+    setAttribute(key, value) {
+        if (isBuiltinRawTextTemplateKey(this.type) && (key === '0' || key === 'data')) {
+            this.text = String(value);
+        }
+        else if (key === 'attributeSlots' && Array.isArray(value)) {
+            const previousSlots = this.attributeSlots;
+            const isHydrated = isElementTemplateHydrated();
+            const canEmitPatch = isHydrated && !this.isPendingCreate();
+            const nextSlots = prepareRawAttributeSlots(this.type, this.instanceId, value);
+            this.rawAttributeSlots = nextSlots === value ? undefined : value;
+            const maxLength = Math.max(previousSlots.length, nextSlots.length);
+            this.attributeSlots = nextSlots;
+            for (let slotIndex = 0; slotIndex < maxLength; slotIndex += 1) {
+                const previousValue = previousSlots[slotIndex];
+                const nextValue = nextSlots[slotIndex];
+                if (isDirectOrDeepEqual(previousValue, nextValue)) {
+                    continue;
+                }
+                if (!canEmitPatch) {
+                    continue;
+                }
+                pushOp(ElementTemplateUpdateOps.setAttribute, this.instanceId, slotIndex, nextValue ?? null);
+            }
+        }
+        else if (key === 'id' && this instanceof BackgroundElementTemplateSlot) {
+            const previousPartId = this.partId;
+            this.partId = Number(value);
+            if (this.parent && previousPartId >= 0 && previousPartId !== this.partId) {
+                this.parent.elementSlots[previousPartId] = [];
+            }
+            syncElementSlotChildren(this.parent, this.partId, collectChildren(this));
+        }
+        else {
+            return;
+        }
+    }
+    get text() {
+        return stringifyRawTextValue(this.attributeSlots[0]);
+    }
+    set text(value) {
+        if (!isBuiltinRawTextTemplateKey(this.type)) {
+            return;
+        }
+        const text = String(value);
+        if (this.attributeSlots[0] === text) {
+            return;
+        }
+        this.rawAttributeSlots = undefined;
+        this.attributeSlots = [text];
+        if (!this.canEmitPatch()) {
+            return;
+        }
+        pushOp(ElementTemplateUpdateOps.setAttribute, this.instanceId, 0, text);
+    }
+    get data() {
+        return this.text;
+    }
+    set data(value) {
+        this.text = value;
+    }
+}
+export class BackgroundElementTemplateSlot extends BackgroundElementTemplateInstance {
+    partId = -1;
+    constructor() {
+        super('slot');
+    }
+}
+export function collectElementTemplateSubtreeHandleIds(root) {
+    const handles = [];
+    collectElementTemplateSubtreeHandleIdsImpl(root, handles);
+    return handles;
+}
+function collectElementTemplateSubtreeHandleIdsImpl(instance, handles) {
+    if (!(instance instanceof BackgroundElementTemplateSlot) && instance.instanceId !== 0) {
+        handles.push(instance.instanceId);
+    }
+    let child = instance.firstChild;
+    while (child) {
+        collectElementTemplateSubtreeHandleIdsImpl(child, handles);
+        child = child.nextSibling;
+    }
+}
+function emitCreateRecursive(instance) {
+    if (!isElementTemplateHydrated()
+        || instance.instanceId < 0
+        || instance instanceof BackgroundElementTemplateSlot) {
+        return;
+    }
+    for (const slotChildren of instance.elementSlots) {
+        if (!slotChildren) {
+            continue;
+        }
+        for (const child of slotChildren) {
+            emitCreateRecursive(child);
+        }
+    }
+    instance.emitCreate();
+}
+function collectChildren(slot) {
+    const res = [];
+    let child = slot.firstChild;
+    while (child) {
+        res.push(child);
+        child = child.nextSibling;
+    }
+    return res;
+}
+//# sourceMappingURL=instance.js.map

package/runtime/lib/element-template/background/instance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instance.js","sourceRoot":"","sources":["../../../src/element-template/background/instance.ts"],"names":[],"mappings":"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"}

package/runtime/lib/element-template/background/manager.d.ts

@@ -0,0 +1,10 @@
+import type { BackgroundElementTemplateInstance } from './instance.js';
+export declare const backgroundElementTemplateInstanceManager: {
+    nextId: number;
+    values: Map<number, BackgroundElementTemplateInstance>;
+    register(instance: BackgroundElementTemplateInstance): void;
+    updateId(oldId: number, newId: number): void;
+    get(id: number): BackgroundElementTemplateInstance | undefined;
+    getRawAttributeValueByEventValue(eventValue: string): unknown;
+    clear(): void;
+};

package/runtime/lib/element-template/background/manager.js

@@ -0,0 +1,60 @@
+// Copyright 2024 The Lynx Authors. All rights reserved.
+// Licensed under the Apache License Version 2.0 that can be found in the
+// LICENSE file in the root directory of this source tree.
+export const backgroundElementTemplateInstanceManager = {
+    nextId: 0,
+    values: new Map(),
+    register(instance) {
+        instance.instanceId = this.nextId += 1;
+        this.values.set(instance.instanceId, instance);
+    },
+    updateId(oldId, newId) {
+        if (!Number.isInteger(newId) || newId === 0) {
+            throw new Error(`ElementTemplate handleId must be a non-zero integer, got ${String(newId)}.`);
+        }
+        const instance = this.values.get(oldId);
+        if (!instance) {
+            throw new Error(`ElementTemplate instance ${oldId} is not registered.`);
+        }
+        const existing = this.values.get(newId);
+        if (existing && existing !== instance) {
+            throw new Error(`ElementTemplate handleId ${newId} is already bound.`);
+        }
+        if (oldId === newId) {
+            return;
+        }
+        this.values.delete(oldId);
+        instance.instanceId = newId;
+        this.values.set(newId, instance);
+        // DevTools event emission can be added here later
+        // if (__DEV__) { ... }
+    },
+    get(id) {
+        return this.values.get(id);
+    },
+    getRawAttributeValueByEventValue(eventValue) {
+        const parts = eventValue?.split(':');
+        if (!parts || (parts.length !== 2 && parts.length !== 3)) {
+            throw new Error('Invalid ElementTemplate event value: ' + eventValue);
+        }
+        const instance = this.values.get(Number(parts[0]));
+        if (!instance) {
+            return null;
+        }
+        const value = instance.getRawAttributeSlot(Number(parts[1]));
+        const spreadKey = parts[2];
+        if (!spreadKey) {
+            return value;
+        }
+        if (value === null || typeof value !== 'object' || Array.isArray(value)) {
+            return undefined;
+        }
+        return value[spreadKey];
+    },
+    clear() {
+        // Note: nextId is NOT reset to prevent ID collisions with potentially surviving instances
+        // or when the clear is partial/soft reset in some scenarios.
+        this.values.clear();
+    },
+};
+//# sourceMappingURL=manager.js.map

package/runtime/lib/element-template/background/manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.js","sourceRoot":"","sources":["../../../src/element-template/background/manager.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,yEAAyE;AACzE,0DAA0D;AAI1D,MAAM,CAAC,MAAM,wCAAwC,GAQjD;IACF,MAAM,EAAE,CAAC;IACT,MAAM,EAAE,IAAI,GAAG,EAA6C;IAE5D,QAAQ,CAAC,QAA2C;QAClD,QAAQ,CAAC,UAAU,GAAG,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC;QACvC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IACjD,CAAC;IAED,QAAQ,CAAC,KAAa,EAAE,KAAa;QACnC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;YAC5C,MAAM,IAAI,KAAK,CAAC,4DAA4D,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAChG,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACxC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,4BAA4B,KAAK,qBAAqB,CAAC,CAAC;QAC1E,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACxC,IAAI,QAAQ,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;YACtC,MAAM,IAAI,KAAK,CAAC,4BAA4B,KAAK,oBAAoB,CAAC,CAAC;QACzE,CAAC;QAED,IAAI,KAAK,KAAK,KAAK,EAAE,CAAC;YACpB,OAAO;QACT,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC1B,QAAQ,CAAC,UAAU,GAAG,KAAK,CAAC;QAC5B,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QAEjC,kDAAkD;QAClD,uBAAuB;IACzB,CAAC;IAED,GAAG,CAAC,EAAU;QACZ,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC7B,CAAC;IAED,gCAAgC,CAAC,UAAkB;QACjD,MAAM,KAAK,GAAG,UAAU,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;QACrC,IAAI,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC;YACzD,MAAM,IAAI,KAAK,CAAC,uCAAuC,GAAG,UAAU,CAAC,CAAC;QACxE,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACnD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,KAAK,GAAG,QAAQ,CAAC,mBAAmB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7D,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QAC3B,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACxE,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAQ,KAAiC,CAAC,SAAS,CAAC,CAAC;IACvD,CAAC;IAED,KAAK;QACH,0FAA0F;QAC1F,6DAA6D;QAC7D,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IACtB,CAAC;CACF,CAAC"}

package/runtime/lib/element-template/client/root.d.ts

@@ -0,0 +1,36 @@
+import type { ReactNode } from 'react';
+/**
+ * The default root exported by `@lynx-js/react` for you to render a JSX
+ * @public
+ */
+export interface Root {
+    /**
+     * Use this API to pass in your JSX to render
+     *
+     * @example
+     *
+     * ```ts
+     * import { root } from "@lynx-js/react"
+     *
+     * function App() {
+     *   // Your app
+     *   return <view>...</view>
+     * }
+     *
+     * root.render(<App/>);
+     * ```
+     *
+     * @public
+     */
+    render: (jsx: ReactNode) => void;
+}
+/**
+ * The default and only root of ReactLynx for you to render JSX
+ * @example
+ * ```ts
+ * import { root } from "@lynx-js/react"
+ * ```
+ *
+ * @public
+ */
+export declare const root: Root;

package/runtime/lib/element-template/client/root.js

@@ -0,0 +1,33 @@
+import { render } from 'preact';
+// import { factory, withInitDataInState } from '../../compat/initData.js';
+import { profileEnd, profileStart } from '../debug/profile.js';
+// import { useLynxGlobalEventListener } from '../../core/hooks/useLynxGlobalEventListener.js';
+import { __root } from '../runtime/page/root-instance.js';
+/**
+ * The default and only root of ReactLynx for you to render JSX
+ * @example
+ * ```ts
+ * import { root } from "@lynx-js/react"
+ * ```
+ *
+ * @public
+ */
+export const root = {
+    render: (jsx) => {
+        __root.__jsx = jsx;
+        if (__BACKGROUND__) {
+            if (__PROFILE__) {
+                profileStart('ReactLynx::renderBackground');
+            }
+            render(jsx, __root);
+            if (__PROFILE__) {
+                profileEnd();
+            }
+        }
+    },
+    /* v8 ignore next 3 */
+    // registerDataProcessors: (dataProcessorDefinition: DataProcessorDefinition): void => {
+    //   lynx.registerDataProcessors(dataProcessorDefinition);
+    // },
+};
+//# sourceMappingURL=root.js.map

package/runtime/lib/element-template/client/root.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"root.js","sourceRoot":"","sources":["../../../src/element-template/client/root.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGhC,2EAA2E;AAC3E,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAC/D,+FAA+F;AAC/F,OAAO,EAAE,MAAM,EAAE,MAAM,kCAAkC,CAAC;AAkC1D;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,IAAI,GAAS;IACxB,MAAM,EAAE,CAAC,GAAc,EAAQ,EAAE;QAC/B,MAAM,CAAC,KAAK,GAAG,GAAG,CAAC;QACnB,IAAI,cAAc,EAAE,CAAC;YACnB,IAAI,WAAW,EAAE,CAAC;gBAChB,YAAY,CAAC,6BAA6B,CAAC,CAAC;YAC9C,CAAC;YACD,MAAM,CAAC,GAAqB,EAAE,MAAkC,CAAC,CAAC;YAClE,IAAI,WAAW,EAAE,CAAC;gBAChB,UAAU,EAAE,CAAC;YACf,CAAC;QACH,CAAC;IACH,CAAC;IACD,sBAAsB;IACtB,wFAAwF;IACxF,0DAA0D;IAC1D,KAAK;CACN,CAAC"}

package/runtime/lib/element-template/debug/alog.d.ts

@@ -0,0 +1,34 @@
+import type { BackgroundElementTemplateInstance } from '../background/instance.js';
+import type { ElementTemplateUpdateCommandStream } from '../protocol/types.js';
+export type FormattedElementTemplateUpdateCommand = {
+    op: 'createTemplate';
+    handleId: number;
+    templateKey: string;
+    bundleUrl: string | null | undefined;
+    attributeSlots: unknown;
+    elementSlots: unknown;
+} | {
+    op: 'setAttribute';
+    targetId: number;
+    attrSlotIndex: number;
+    value: unknown;
+} | {
+    op: 'insertNode';
+    targetId: number;
+    elementSlotIndex: number;
+    childId: number;
+    referenceId: number;
+} | {
+    op: 'removeNode';
+    targetId: number;
+    elementSlotIndex: number;
+    childId: number;
+    removedSubtreeHandleIds: number[];
+} | {
+    op: 'unknown';
+    opcode: unknown;
+    index: number;
+    remaining: unknown[];
+};
+export declare function formatElementTemplateUpdateCommands(stream: ElementTemplateUpdateCommandStream | undefined): FormattedElementTemplateUpdateCommand[];
+export declare function printElementTemplateTreeToString(root: BackgroundElementTemplateInstance | null | undefined): string;

package/runtime/lib/element-template/debug/alog.js

@@ -0,0 +1,93 @@
+// Copyright 2026 The Lynx Authors. All rights reserved.
+// Licensed under the Apache License Version 2.0 that can be found in the
+// LICENSE file in the root directory of this source tree.
+import { ElementTemplateUpdateOps } from '../protocol/opcodes.js';
+export function formatElementTemplateUpdateCommands(stream) {
+    if (!Array.isArray(stream)) {
+        return [];
+    }
+    const result = [];
+    for (let index = 0; index < stream.length;) {
+        const opIndex = index;
+        const op = stream[index++];
+        switch (op) {
+            case ElementTemplateUpdateOps.createTemplate:
+                result.push({
+                    op: 'createTemplate',
+                    handleId: stream[index++],
+                    templateKey: stream[index++],
+                    bundleUrl: stream[index++],
+                    attributeSlots: stream[index++],
+                    elementSlots: stream[index++],
+                });
+                break;
+            case ElementTemplateUpdateOps.setAttribute:
+                result.push({
+                    op: 'setAttribute',
+                    targetId: stream[index++],
+                    attrSlotIndex: stream[index++],
+                    value: stream[index++],
+                });
+                break;
+            case ElementTemplateUpdateOps.insertNode:
+                result.push({
+                    op: 'insertNode',
+                    targetId: stream[index++],
+                    elementSlotIndex: stream[index++],
+                    childId: stream[index++],
+                    referenceId: stream[index++],
+                });
+                break;
+            case ElementTemplateUpdateOps.removeNode:
+                result.push({
+                    op: 'removeNode',
+                    targetId: stream[index++],
+                    elementSlotIndex: stream[index++],
+                    childId: stream[index++],
+                    removedSubtreeHandleIds: stream[index++],
+                });
+                break;
+            default:
+                result.push({
+                    op: 'unknown',
+                    opcode: op,
+                    index: opIndex,
+                    remaining: stream.slice(index),
+                });
+                index = stream.length;
+                break;
+        }
+    }
+    return result;
+}
+export function printElementTemplateTreeToString(root) {
+    if (!root) {
+        return '<empty>';
+    }
+    const lines = [];
+    appendInstance(lines, root, 0);
+    return lines.join('\n');
+}
+function appendInstance(lines, instance, depth) {
+    const indent = '  '.repeat(depth);
+    const type = instance.type ?? '<unknown>';
+    const instanceId = instance.instanceId ?? '<unknown>';
+    lines.push(`${indent}${type}#${instanceId}`);
+    if (Array.isArray(instance.attributeSlots) && instance.attributeSlots.length > 0) {
+        lines.push(`${indent}  attributeSlots: ${JSON.stringify(instance.attributeSlots)}`);
+    }
+    const elementSlots = Array.isArray(instance.elementSlots) ? instance.elementSlots : [];
+    for (let slotIndex = 0; slotIndex < elementSlots.length; slotIndex += 1) {
+        const children = elementSlots[slotIndex];
+        if (!children || children.length === 0) {
+            continue;
+        }
+        lines.push(`${indent}  elementSlots[${slotIndex}]: [${children.map(child => child.instanceId).join(', ')}]`);
+    }
+    let child = instance.firstChild;
+    while (child) {
+        appendInstance(lines, child, depth + 1);
+        child = child.nextSibling;
+    }
+}
+//# sourceMappingURL=alog.js.map

package/runtime/lib/element-template/debug/alog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"alog.js","sourceRoot":"","sources":["../../../src/element-template/debug/alog.ts"],"names":[],"mappings":"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"}

package/runtime/lib/element-template/debug/elementPAPICall.d.ts

@@ -0,0 +1 @@
+export declare function initElementTemplatePAPICallAlog(globalWithIndex?: Record<string, unknown>): void;