@lynx-js/react 0.120.0 → 0.121.1

package/runtime/lib/element-template/runtime/render/render-main-thread.js

@@ -0,0 +1,71 @@
+// 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.
+/**
+ * Implements the IFR (Instant First-Frame Rendering) on main thread.
+ */
+import { renderOpcodesIntoElementTemplate } from './render-opcodes.js';
+import { render as renderToString } from './render-to-opcodes.js';
+import { getReloadVersion } from '../../../core/reload-version.js';
+import { profileEnd, profileStart } from '../../debug/profile.js';
+import { ElementTemplateLifecycleConstant } from '../../protocol/lifecycle-constant.js';
+import { insertRootIntoPage, removeRootFromPage } from '../page/page.js';
+import { __root } from '../page/root-instance.js';
+// ET reload reuses the native page, so the main-thread render path owns the
+// root refs it appended and can remove only those roots before rebuilding.
+let mainThreadRootRefs = [];
+function resetMainThreadRootRefs() {
+    mainThreadRootRefs = [];
+}
+function removeMainThreadRootRefs() {
+    const rootRefs = mainThreadRootRefs;
+    mainThreadRootRefs = [];
+    for (const rootRef of rootRefs) {
+        removeRootFromPage(rootRef);
+    }
+}
+function renderMainThread() {
+    let opcodes;
+    profileStart('ReactLynx::renderMainThread');
+    try {
+        opcodes = renderToString(__root.__jsx, undefined);
+    }
+    catch (e) {
+        lynx.reportError(e);
+        opcodes = [];
+    }
+    finally {
+        profileEnd();
+    }
+    profileStart('ReactLynx::renderOpcodes');
+    try {
+        const { rootRefs } = renderOpcodesIntoElementTemplate(opcodes);
+        for (const rootRef of rootRefs) {
+            insertRootIntoPage(rootRef);
+        }
+        mainThreadRootRefs = rootRefs;
+    }
+    finally {
+        profileEnd();
+    }
+    profileStart('ReactLynx::packSerializedETInstance');
+    try {
+        const instances = [];
+        for (const rootRef of mainThreadRootRefs) {
+            instances.push(__SerializeElementTemplate(rootRef));
+        }
+        const payload = {
+            instances,
+            reloadVersion: getReloadVersion(),
+        };
+        lynx.getJSContext().dispatchEvent({
+            type: ElementTemplateLifecycleConstant.hydrate,
+            data: payload,
+        });
+    }
+    finally {
+        profileEnd();
+    }
+}
+export { removeMainThreadRootRefs, renderMainThread, resetMainThreadRootRefs };
+//# sourceMappingURL=render-main-thread.js.map

package/runtime/lib/element-template/runtime/render/render-main-thread.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-main-thread.js","sourceRoot":"","sources":["../../../../src/element-template/runtime/render/render-main-thread.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,yEAAyE;AACzE,0DAA0D;AAE1D;;GAEG;AAEH,OAAO,EAAE,gCAAgC,EAAE,MAAM,qBAAqB,CAAC;AACvE,OAAO,EAAE,MAAM,IAAI,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,gCAAgC,EAAE,MAAM,sCAAsC,CAAC;AAExF,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACzE,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAElD,4EAA4E;AAC5E,2EAA2E;AAC3E,IAAI,kBAAkB,GAAiB,EAAE,CAAC;AAE1C,SAAS,uBAAuB;IAC9B,kBAAkB,GAAG,EAAE,CAAC;AAC1B,CAAC;AAED,SAAS,wBAAwB;IAC/B,MAAM,QAAQ,GAAG,kBAAkB,CAAC;IACpC,kBAAkB,GAAG,EAAE,CAAC;IACxB,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC;AACH,CAAC;AAED,SAAS,gBAAgB;IACvB,IAAI,OAAO,CAAC;IACZ,YAAY,CAAC,6BAA6B,CAAC,CAAC;IAC5C,IAAI,CAAC;QACH,OAAO,GAAG,cAAc,CAAC,MAAM,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IACpD,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,IAAI,CAAC,WAAW,CAAC,CAAU,CAAC,CAAC;QAC7B,OAAO,GAAG,EAAE,CAAC;IACf,CAAC;YAAS,CAAC;QACT,UAAU,EAAE,CAAC;IACf,CAAC;IAED,YAAY,CAAC,0BAA0B,CAAC,CAAC;IACzC,IAAI,CAAC;QACH,MAAM,EAAE,QAAQ,EAAE,GAAG,gCAAgC,CAAC,OAAO,CAAC,CAAC;QAC/D,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,kBAAkB,CAAC,OAAO,CAAC,CAAC;QAC9B,CAAC;QACD,kBAAkB,GAAG,QAAQ,CAAC;IAChC,CAAC;YAAS,CAAC;QACT,UAAU,EAAE,CAAC;IACf,CAAC;IAED,YAAY,CAAC,qCAAqC,CAAC,CAAC;IACpD,IAAI,CAAC;QACH,MAAM,SAAS,GAAuB,EAAE,CAAC;QACzC,KAAK,MAAM,OAAO,IAAI,kBAAkB,EAAE,CAAC;YACzC,SAAS,CAAC,IAAI,CAAC,0BAA0B,CAAC,OAAO,CAAC,CAAC,CAAC;QACtD,CAAC;QACD,MAAM,OAAO,GAAwC;YACnD,SAAS;YACT,aAAa,EAAE,gBAAgB,EAAE;SAClC,CAAC;QAEF,IAAI,CAAC,YAAY,EAAE,CAAC,aAAa,CAAC;YAChC,IAAI,EAAE,gCAAgC,CAAC,OAAO;YAC9C,IAAI,EAAE,OAAO;SACd,CAAC,CAAC;IACL,CAAC;YAAS,CAAC;QACT,UAAU,EAAE,CAAC;IACf,CAAC;AACH,CAAC;AAED,OAAO,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,CAAC"}

package/runtime/lib/element-template/runtime/render/render-opcodes.d.ts

@@ -0,0 +1,4 @@
+export interface MainThreadCreateResult {
+    rootRefs: ElementRef[];
+}
+export declare function renderOpcodesIntoElementTemplate(opcodes: unknown[]): MainThreadCreateResult;

package/runtime/lib/element-template/runtime/render/render-opcodes.js

@@ -0,0 +1,134 @@
+// 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 { __OpAttr, __OpBegin, __OpEnd, __OpSlot, __OpText } from './render-to-opcodes.js';
+import { __etAttrPlanMap } from '../template/attr-slot-plan.js';
+import { createElementTemplateWithReservedHandle, reserveElementTemplateId } from '../template/handle.js';
+const BUILTIN_RAW_TEXT_TEMPLATE_KEY = '_et_builtin_raw_text';
+function appendChildToParent(parentTemplateKey, parentActiveElementSlot, rootRefs, elementRef) {
+    /* v8 ignore start -- stackTop is always rooted with `null`, never `undefined`. */
+    if (parentTemplateKey === undefined) {
+        return;
+    }
+    /* v8 ignore end */
+    if (parentTemplateKey === null) {
+        rootRefs.push(elementRef);
+        return;
+    }
+    if (!parentActiveElementSlot) {
+        throw new Error(`Template '${parentTemplateKey}' received a child outside of any element slot.`);
+    }
+    parentActiveElementSlot.push(elementRef);
+}
+export function renderOpcodesIntoElementTemplate(opcodes) {
+    const rootRefs = [];
+    const templateKeyStack = [null];
+    const attributeSlotsStack = [undefined];
+    const elementSlotsStack = [undefined];
+    const activeElementSlotStack = [undefined];
+    let stackTop = 0;
+    for (let i = 0; i < opcodes.length;) {
+        const opcode = opcodes[i];
+        switch (opcode) {
+            case __OpBegin: {
+                const vnode = opcodes[i + 1];
+                stackTop += 1;
+                templateKeyStack[stackTop] = vnode.type;
+                attributeSlotsStack[stackTop] = undefined;
+                elementSlotsStack[stackTop] = undefined;
+                activeElementSlotStack[stackTop] = undefined;
+                i += 2;
+                break;
+            }
+            case __OpEnd: {
+                if (stackTop === 0) {
+                    throw new Error('Instruction mismatch: Popped root frame at __OpEnd');
+                }
+                const templateKey = templateKeyStack[stackTop];
+                const attributeSlots = attributeSlotsStack[stackTop];
+                const elementSlots = elementSlotsStack[stackTop];
+                stackTop -= 1;
+                // If templateKey is null, it means we popped the root frame?
+                // But __OpEnd should pair with __OpBegin.
+                // The Root frame is manually pushed and has no __OpBegin.
+                // So we should never pop the Root frame via __OpEnd unless there's an extra End.
+                if (templateKey === null) {
+                    // This should effectively not happen if opcodes are balanced?
+                    // Actually, if we are at root, and opcode has __OpEnd, it implies we are closing a component.
+                    // The structure is: Root -> [Begin ... End] -> Root.
+                    // Wait, if opcodes list ends, loop finishes.
+                    // __OpEnd corresponds to a component.
+                    // So if we pop, we must get a valid component frame.
+                    /* v8 ignore start -- the synthetic root frame cannot be popped by balanced opcodes. */
+                    throw new Error('Instruction mismatch: Popped root frame at __OpEnd');
+                    /* v8 ignore end */
+                }
+                const concreteTemplateKey = templateKey;
+                const parentTemplateKey = templateKeyStack[stackTop];
+                const parentActiveElementSlot = activeElementSlotStack[stackTop];
+                const attrPlan = __etAttrPlanMap[concreteTemplateKey];
+                const handleId = reserveElementTemplateId();
+                let elementRef;
+                if (attrPlan === undefined) {
+                    elementRef = createElementTemplateWithReservedHandle(handleId, concreteTemplateKey, null, attributeSlots ?? null, elementSlots ?? null);
+                }
+                else {
+                    const preparedAttributeSlots = attributeSlots?.slice() ?? [];
+                    for (let planIndex = 0; planIndex < attrPlan.length; planIndex += 2) {
+                        const attrSlotIndex = attrPlan[planIndex];
+                        const adapter = attrPlan[planIndex + 1];
+                        preparedAttributeSlots[attrSlotIndex] = adapter(handleId, attrSlotIndex, preparedAttributeSlots[attrSlotIndex]);
+                    }
+                    elementRef = createElementTemplateWithReservedHandle(handleId, concreteTemplateKey, null, preparedAttributeSlots, elementSlots ?? null);
+                }
+                appendChildToParent(parentTemplateKey, parentActiveElementSlot, rootRefs, elementRef);
+                i += 1;
+                break;
+            }
+            case __OpAttr: {
+                const name = opcodes[i + 1];
+                const value = opcodes[i + 2];
+                if (name === 'attributeSlots') {
+                    attributeSlotsStack[stackTop] = value;
+                }
+                i += 3;
+                break;
+            }
+            case __OpSlot: {
+                const slotId = opcodes[i + 1];
+                const elementSlots = elementSlotsStack[stackTop] ?? (elementSlotsStack[stackTop] = []);
+                const activeElementSlot = elementSlots[slotId] = [];
+                activeElementSlotStack[stackTop] = activeElementSlot;
+                i += 2;
+                break;
+            }
+            case __OpText: {
+                const text = opcodes[i + 1];
+                const handleId = reserveElementTemplateId();
+                const textRef = createElementTemplateWithReservedHandle(handleId, BUILTIN_RAW_TEXT_TEMPLATE_KEY, null, [String(text)], []);
+                const parentTemplateKey = templateKeyStack[stackTop];
+                if (parentTemplateKey === null) {
+                    rootRefs.push(textRef);
+                }
+                else {
+                    const activeElementSlot = activeElementSlotStack[stackTop];
+                    if (!activeElementSlot) {
+                        throw new Error(`Template '${parentTemplateKey}' received a text child outside of any element slot.`);
+                    }
+                    activeElementSlot.push(textRef);
+                }
+                i += 2;
+                break;
+            }
+            default:
+                // Unknown opcode, maybe skip? or throw?
+                // renderToString loop increments manually.
+                // If we hit here, something is desync.
+                throw new Error(`Unknown opcode: ${opcode}`);
+        }
+    }
+    return {
+        rootRefs,
+    };
+}
+//# sourceMappingURL=render-opcodes.js.map

package/runtime/lib/element-template/runtime/render/render-opcodes.js.map

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

package/runtime/lib/element-template/runtime/render/render-to-opcodes.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Render Preact JSX + Components to an HTML string.
+ * @param {VNode} vnode	JSX Element / VNode to render
+ * @param {object} [context] Initial root context object
+ */
+export declare function renderToString(vnode: any, context: any): any[];
+export declare const __OpBegin = 0;
+export declare const __OpEnd = 1;
+export declare const __OpAttr = 2;
+export declare const __OpText = 3;
+export declare const __OpSlot = 4;
+export default renderToString;
+export declare const render: typeof renderToString;
+export declare const renderToStaticMarkup: typeof renderToString;

package/runtime/lib/element-template/runtime/render/render-to-opcodes.js

@@ -0,0 +1,278 @@
+// 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.
+/**
+ * Implements rendering to opcodes.
+ * This module is modified from preact-render-to-string@6.0.3 to generate
+ * opcodes instead of HTML strings for Lynx.
+ */
+// @ts-nocheck
+import { Fragment, h, options } from 'preact';
+import { CHILDREN, COMMIT, COMPONENT, DIFF, DIFF2, DIFFED, DIRTY, NEXT_STATE, PARENT, RENDER, SKIP_EFFECTS, VNODE, } from '../../../shared/render-constants.js';
+/** @typedef {import('preact').VNode} VNode */
+const EMPTY_ARR = [];
+const isArray = /* @__PURE__ */ Array.isArray;
+const assign = /* @__PURE__ */ Object.assign;
+// Global state for the current render pass
+let beforeDiff, beforeDiff2, afterDiff, renderHook, ummountHook;
+/**
+ * Render Preact JSX + Components to an HTML string.
+ * @param {VNode} vnode	JSX Element / VNode to render
+ * @param {object} [context] Initial root context object
+ */
+export function renderToString(vnode, context) {
+    // Performance optimization: `renderToString` is synchronous and we
+    // therefore don't execute any effects. To do that we pass an empty
+    // array to `options._commit` (`__c`). But we can go one step further
+    // and avoid a lot of dirty checks and allocations by setting
+    // `options._skipEffects` (`__s`) too.
+    const previousSkipEffects = options[SKIP_EFFECTS];
+    options[SKIP_EFFECTS] = true;
+    // store options hooks once before each synchronous render call
+    beforeDiff = options[DIFF];
+    beforeDiff2 = options[DIFF2];
+    afterDiff = options[DIFFED];
+    renderHook = options[RENDER];
+    ummountHook = options.unmount;
+    const parent = h(Fragment, null);
+    parent[CHILDREN] = [vnode];
+    const opcodes = [];
+    try {
+        _renderToString(vnode, context || EMPTY_OBJ, parent, opcodes);
+    }
+    finally {
+        // options._commit, we don't schedule any effects in this library right now,
+        // so we can pass an empty queue to this hook.
+        if (options[COMMIT])
+            options[COMMIT](vnode, EMPTY_ARR);
+        options[SKIP_EFFECTS] = previousSkipEffects;
+        EMPTY_ARR.length = 0;
+    }
+    return opcodes;
+}
+// Installed as setState/forceUpdate for function components
+/* v8 ignore start */
+function markAsDirty() {
+    this.__d = true;
+}
+/* v8 ignore stop */
+const EMPTY_OBJ = {};
+export const __OpBegin = 0;
+export const __OpEnd = 1;
+export const __OpAttr = 2;
+export const __OpText = 3;
+export const __OpSlot = 4;
+/**
+ * @param {VNode} vnode
+ * @param {Record<string, unknown>} context
+ */
+function renderClassComponent(vnode, context) {
+    const type = /** @type {import("preact").ComponentClass<typeof vnode.props>} */ (vnode.type);
+    let c;
+    if (vnode[COMPONENT]) {
+        c = vnode[COMPONENT];
+        c.state = c[NEXT_STATE];
+    }
+    else {
+        c = new type(vnode.props, context);
+    }
+    vnode[COMPONENT] = c;
+    c[VNODE] = vnode;
+    c.props = vnode.props;
+    c.context = context;
+    // turn off stateful re-rendering:
+    c[DIRTY] = true;
+    if (c.state == null)
+        c.state = EMPTY_OBJ;
+    if (c[NEXT_STATE] == null) {
+        c[NEXT_STATE] = c.state;
+    }
+    if (type.getDerivedStateFromProps) {
+        c.state = assign({}, c.state, type.getDerivedStateFromProps(c.props, c.state));
+    }
+    if (renderHook)
+        renderHook(vnode);
+    return c.render(c.props, c.state, context);
+}
+function cleanupVNode(vnode) {
+    if (afterDiff)
+        afterDiff(vnode);
+    vnode[PARENT] = undefined;
+    if (ummountHook)
+        ummountHook(vnode);
+}
+function shouldRenderEtChild(child) {
+    return child != null && child !== false && child !== true;
+}
+function isCompiledEtHostType(type) {
+    return type.startsWith('_et_')
+        || type.includes(':_et_');
+}
+function renderEtSlotArray(slotChildrenById, context, vnode, opcodes) {
+    for (let slotId = 0; slotId < slotChildrenById.length; slotId += 1) {
+        const slotChildren = slotChildrenById[slotId];
+        if (!shouldRenderEtChild(slotChildren)) {
+            continue;
+        }
+        opcodes.push(__OpSlot, slotId);
+        _renderToString(slotChildren, context, vnode, opcodes);
+    }
+}
+function renderComponentVNode(vnode, type, props, context, opcodes) {
+    let cctx = context;
+    let rendered;
+    let component;
+    const opcodesLength = opcodes.length;
+    if (type === Fragment) {
+        rendered = props.children;
+    }
+    else {
+        const contextType = type.contextType;
+        if (contextType != null) {
+            const provider = context[contextType.__c];
+            cctx = provider ? provider.props.value : contextType.__;
+        }
+        if (type.prototype && typeof type.prototype.render === 'function') {
+            rendered = /**#__NOINLINE__**/ renderClassComponent(vnode, cctx);
+            component = vnode[COMPONENT];
+        }
+        else {
+            component = {
+                __v: vnode,
+                props,
+                context: cctx,
+                // silently drop state updates
+                setState: markAsDirty,
+                forceUpdate: markAsDirty,
+                __d: true,
+                // hooks
+                __h: [],
+            };
+            vnode[COMPONENT] = component;
+            component.constructor = type;
+            component.render = doRender;
+            let count = 0;
+            while (component[DIRTY] && count++ < 25) {
+                component[DIRTY] = false;
+                if (renderHook)
+                    renderHook(vnode);
+                rendered = component.render(props, component.state, cctx);
+            }
+            component[DIRTY] = true;
+        }
+        if (component.getChildContext != null) {
+            context = assign({}, context, component.getChildContext());
+        }
+    }
+    const isTopLevelFragment = rendered != null && rendered.type === Fragment
+        && rendered.key == null;
+    rendered = isTopLevelFragment ? rendered.props.children : rendered;
+    try {
+        _renderToString(rendered, context, vnode, opcodes);
+    }
+    catch (e) {
+        if (e && typeof e === 'object' && e.then && component && /* _childDidSuspend */ component.__c) {
+            component.setState({ /* _suspended */ __a: true });
+            if (component[DIRTY]) {
+                rendered = renderClassComponent(vnode, context);
+                component = vnode[COMPONENT];
+                opcodes.length = opcodesLength;
+                _renderToString(rendered, context, vnode, opcodes);
+            }
+        }
+        else {
+            throw e;
+        }
+    }
+    finally {
+        cleanupVNode(vnode);
+    }
+}
+function renderCompiledEtHostVNode(vnode, props, context, opcodes) {
+    opcodes.push(__OpBegin, vnode);
+    const attributeSlots = props.attributeSlots;
+    if (attributeSlots !== undefined) {
+        opcodes.push(__OpAttr, 'attributeSlots', attributeSlots);
+    }
+    // ET host nodes are compiler-generated; `swc_plugin_element_template`
+    // (lowering.rs) emits dynamic children as `$N` named props only — no
+    // `children` prop is produced — so the renderer only consumes `$N`.
+    let elementSlots;
+    for (const name in props) {
+        if (name.startsWith('$')) {
+            (elementSlots ??= [])[+name.slice(1)] = props[name];
+        }
+    }
+    if (elementSlots !== undefined) {
+        renderEtSlotArray(elementSlots, context, vnode, opcodes);
+    }
+    cleanupVNode(vnode);
+    opcodes.push(__OpEnd);
+}
+function renderStringHostVNode(type, vnode, props, context, opcodes) {
+    if (__DEV__ && !isCompiledEtHostType(type)) {
+        cleanupVNode(vnode);
+        throw new Error(`Element Template main-thread renderer received an uncompiled host vnode: ${type}`);
+    }
+    renderCompiledEtHostVNode(vnode, props, context, opcodes);
+}
+/**
+ * Recursively render VNodes to HTML.
+ * @param {VNode|any} vnode
+ * @param {any} context
+ * @param {VNode} parent
+ * @param opcodes
+ */
+function _renderToString(vnode, context, parent, opcodes) {
+    // Ignore non-rendered VNodes/values
+    if (vnode == null || vnode === true || vnode === false || vnode === '') {
+        return;
+    }
+    // Text VNodes: escape as HTML
+    if (typeof vnode !== 'object') {
+        if (typeof vnode === 'function')
+            return;
+        opcodes.push(__OpText, vnode + '');
+        return;
+    }
+    // Recurse into children / Arrays
+    if (isArray(vnode)) {
+        parent[CHILDREN] = vnode;
+        for (let i = 0; i < vnode.length; i++) {
+            const child = vnode[i];
+            if (child == null || typeof child === 'boolean')
+                continue;
+            _renderToString(child, context, parent, opcodes);
+        }
+        return;
+    }
+    // VNodes have {constructor:undefined} to prevent JSON injection:
+    // if (vnode.constructor !== undefined) return;
+    vnode[PARENT] = parent;
+    if (beforeDiff)
+        beforeDiff(vnode);
+    if (beforeDiff2)
+        beforeDiff2(vnode, EMPTY_OBJ);
+    let type = vnode.type, props = vnode.props;
+    // Invoke rendering on Components
+    if (typeof type === 'function') {
+        renderComponentVNode(vnode, type, props, context, opcodes);
+        return;
+    }
+    if (typeof type === 'string') {
+        renderStringHostVNode(type, vnode, props, context, opcodes);
+        return;
+    }
+    if (__DEV__) {
+        cleanupVNode(vnode);
+        throw new Error('Element Template main-thread renderer received an invalid vnode.');
+    }
+}
+/** The `.render()` method for a PFC backing instance. */
+function doRender(props, state, context) {
+    return this.constructor(props, context);
+}
+export default renderToString;
+export const render = renderToString;
+export const renderToStaticMarkup = renderToString;
+//# sourceMappingURL=render-to-opcodes.js.map

package/runtime/lib/element-template/runtime/render/render-to-opcodes.js.map

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

package/runtime/lib/element-template/runtime/template/attr-slot-plan.d.ts

@@ -0,0 +1,12 @@
+import type { SpreadAttrAdapterContext } from '../../prop-adapters/spread.js';
+import type { SerializableValue } from '../../protocol/types.js';
+export interface EtAttrAdapterContext extends SpreadAttrAdapterContext {
+}
+export type EtAttrAdapter = (handleId: number, attrSlotIndex: number, value: unknown, context?: EtAttrAdapterContext) => SerializableValue | null;
+export type EtAttrPlan = (number | EtAttrAdapter)[];
+export type EtAttrPlanMap = Record<string, EtAttrPlan | undefined>;
+export declare const __etAttrPlanMap: EtAttrPlanMap;
+export declare function adaptEventAttrSlot(handleId: number, attrSlotIndex: number, value: unknown, _context?: EtAttrAdapterContext): SerializableValue | null;
+export declare function adaptRefAttrSlot(handleId: number, attrSlotIndex: number, value: unknown, _context?: EtAttrAdapterContext): SerializableValue | null;
+export declare function adaptSpreadAttrSlot(handleId: number, attrSlotIndex: number, value: unknown, context?: EtAttrAdapterContext): SerializableValue | null;
+export declare function clearEtAttrPlanMap(): void;

package/runtime/lib/element-template/runtime/template/attr-slot-plan.js

@@ -0,0 +1,27 @@
+// Copyright 2025 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 { getEventValue } from '../../prop-adapters/event-value.js';
+import { prepareRefAttrSlot } from '../../prop-adapters/ref.js';
+import { prepareSpreadAttrSlot } from '../../prop-adapters/spread.js';
+export const __etAttrPlanMap = Object.create(null);
+export function adaptEventAttrSlot(handleId, attrSlotIndex, value, _context) {
+    if (value === null || value === undefined || value === false) {
+        return null;
+    }
+    return getEventValue(handleId, attrSlotIndex);
+}
+export function adaptRefAttrSlot(handleId, attrSlotIndex, value, _context) {
+    return prepareRefAttrSlot(handleId, attrSlotIndex, value);
+}
+export function adaptSpreadAttrSlot(handleId, attrSlotIndex, value, context) {
+    return prepareSpreadAttrSlot(handleId, attrSlotIndex, value, context);
+}
+export function clearEtAttrPlanMap() {
+    // The compiled output assigns into the exported side table directly, so the
+    // object identity must stay stable when tests or teardown clear state.
+    for (const templateKey in __etAttrPlanMap) {
+        delete __etAttrPlanMap[templateKey];
+    }
+}
+//# sourceMappingURL=attr-slot-plan.js.map

package/runtime/lib/element-template/runtime/template/attr-slot-plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attr-slot-plan.js","sourceRoot":"","sources":["../../../../src/element-template/runtime/template/attr-slot-plan.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,yEAAyE;AACzE,0DAA0D;AAE1D,OAAO,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAoBtE,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAkB,CAAC;AAEpE,MAAM,UAAU,kBAAkB,CAChC,QAAgB,EAChB,aAAqB,EACrB,KAAc,EACd,QAA+B;IAE/B,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,KAAK,EAAE,CAAC;QAC7D,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,aAAa,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,QAAgB,EAChB,aAAqB,EACrB,KAAc,EACd,QAA+B;IAE/B,OAAO,kBAAkB,CAAC,QAAQ,EAAE,aAAa,EAAE,KAAK,CAAC,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,QAAgB,EAChB,aAAqB,EACrB,KAAc,EACd,OAA8B;IAE9B,OAAO,qBAAqB,CAAC,QAAQ,EAAE,aAAa,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;AACxE,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,4EAA4E;IAC5E,uEAAuE;IACvE,KAAK,MAAM,WAAW,IAAI,eAAe,EAAE,CAAC;QAC1C,OAAO,eAAe,CAAC,WAAW,CAAC,CAAC;IACtC,CAAC;AACH,CAAC"}

package/runtime/lib/element-template/runtime/template/handle.d.ts

@@ -0,0 +1,5 @@
+import type { SerializableValue } from '../../protocol/types.js';
+export declare function reserveElementTemplateId(): number;
+export declare function createElementTemplateWithReservedHandle(handleId: number, templateKey: string, bundleUrl: string | null | undefined, attributeSlots: SerializableValue[] | null | undefined, elementSlots: ElementRef[][] | null | undefined): ElementRef;
+export declare function resetTemplateId(): void;
+export declare function destroyElementTemplateId(id: number): void;

package/runtime/lib/element-template/runtime/template/handle.js

@@ -0,0 +1,22 @@
+// Copyright 2025 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 { deleteElementTemplateNativeRef, setElementTemplateNativeRef } from './registry.js';
+// Main-thread IFR allocates ids as consecutive negative integers.
+let nextId = -1;
+export function reserveElementTemplateId() {
+    const id = nextId--;
+    return id;
+}
+export function createElementTemplateWithReservedHandle(handleId, templateKey, bundleUrl, attributeSlots, elementSlots) {
+    const nativeRef = __CreateElementTemplate(templateKey, bundleUrl, attributeSlots, elementSlots, handleId);
+    setElementTemplateNativeRef(handleId, nativeRef);
+    return nativeRef;
+}
+export function resetTemplateId() {
+    nextId = -1;
+}
+export function destroyElementTemplateId(id) {
+    deleteElementTemplateNativeRef(id);
+}
+//# sourceMappingURL=handle.js.map

package/runtime/lib/element-template/runtime/template/handle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handle.js","sourceRoot":"","sources":["../../../../src/element-template/runtime/template/handle.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,yEAAyE;AACzE,0DAA0D;AAE1D,OAAO,EAAE,8BAA8B,EAAE,2BAA2B,EAAE,MAAM,eAAe,CAAC;AAG5F,kEAAkE;AAClE,IAAI,MAAM,GAAG,CAAC,CAAC,CAAC;AAEhB,MAAM,UAAU,wBAAwB;IACtC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,uCAAuC,CACrD,QAAgB,EAChB,WAAmB,EACnB,SAAoC,EACpC,cAAsD,EACtD,YAA+C;IAE/C,MAAM,SAAS,GAAG,uBAAuB,CACvC,WAAW,EACX,SAAS,EACT,cAAc,EACd,YAAY,EACZ,QAAQ,CACT,CAAC;IACF,2BAA2B,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IACjD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,MAAM,GAAG,CAAC,CAAC,CAAC;AACd,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,EAAU;IACjD,8BAA8B,CAAC,EAAE,CAAC,CAAC;AACrC,CAAC"}

package/runtime/lib/element-template/runtime/template/registry.d.ts

@@ -0,0 +1,13 @@
+export declare function setElementTemplateNativeRef(id: number, nativeRef: ElementRef): void;
+export declare function getElementTemplateNativeRef(id: number): ElementRef | undefined;
+export declare function hasElementTemplateNativeRef(id: number): boolean;
+export declare function deleteElementTemplateNativeRef(id: number): void;
+export declare function clearElementTemplateNativeRefRegistry(): void;
+export interface ElementTemplateRegistryFacade {
+    set: (id: number, nativeRef: ElementRef) => void;
+    get: (id: number) => ElementRef | undefined;
+    has: (id: number) => boolean;
+    delete: (id: number) => void;
+    clear: () => void;
+}
+export declare const elementTemplateRegistry: ElementTemplateRegistryFacade;