@lynx-js/react 0.119.0 → 0.121.0

package/runtime/lib/element-template/runtime/components/slot.js

@@ -0,0 +1,11 @@
+import { createElement } from 'preact';
+/**
+ * @internal
+ */
+export function __etSlot(id, children) {
+    if (__BACKGROUND__) {
+        return createElement('slot', { id }, children);
+    }
+    throw new Error('__etSlot() should not run on the main thread. LEPUS ET children are lowered to slot arrays at compile time.');
+}
+//# sourceMappingURL=slot.js.map

package/runtime/lib/element-template/runtime/components/slot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slot.js","sourceRoot":"","sources":["../../../../src/element-template/runtime/components/slot.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAEvC;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,EAAU,EAAE,QAA2B;IAC9D,IAAI,cAAc,EAAE,CAAC;QACnB,OAAO,aAAa,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,QAAQ,CAAC,CAAC;IACjD,CAAC;IACD,MAAM,IAAI,KAAK,CACb,6GAA6G,CAC9G,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,2 @@
+export declare let __page: FiberElement;
+export declare function setupPage(page: FiberElement): void;

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

@@ -0,0 +1,8 @@
+// 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 let __page;
+export function setupPage(page) {
+    __page = page;
+}
+//# sourceMappingURL=page.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"page.js","sourceRoot":"","sources":["../../../../src/element-template/runtime/page/page.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,yEAAyE;AACzE,0DAA0D;AAE1D,MAAM,CAAC,IAAI,MAAoB,CAAC;AAEhC,MAAM,UAAU,SAAS,CAAC,IAAkB;IAC1C,MAAM,GAAG,IAAI,CAAC;AAChB,CAAC"}

package/runtime/lib/element-template/runtime/page/root-instance.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Element Template-only root for renderPage.
+ */
+declare let __root: {
+    __jsx?: React.ReactNode;
+    __opcodes?: any[];
+    nodeType?: Element['nodeType'];
+};
+declare function setRoot(root: typeof __root): void;
+export { __root, setRoot };

package/runtime/lib/element-template/runtime/page/root-instance.js

@@ -0,0 +1,17 @@
+// 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.
+/**
+ * Element Template-only root for renderPage.
+ */
+let __root;
+function setRoot(root) {
+    __root = root;
+    // A fake ELEMENT_NODE to make preact/debug happy.
+    if (__DEV__ && __root) {
+        __root.nodeType = 1;
+    }
+}
+setRoot({});
+export { __root, setRoot };
+//# sourceMappingURL=root-instance.js.map

package/runtime/lib/element-template/runtime/page/root-instance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"root-instance.js","sourceRoot":"","sources":["../../../../src/element-template/runtime/page/root-instance.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,yEAAyE;AACzE,0DAA0D;AAE1D;;GAEG;AACH,IAAI,MAIH,CAAC;AAEF,SAAS,OAAO,CAAC,IAAmB;IAClC,MAAM,GAAG,IAAI,CAAC;IAEd,kDAAkD;IAClD,IAAI,OAAO,IAAI,MAAM,EAAE,CAAC;QACtB,MAAM,CAAC,QAAQ,GAAG,CAAC,CAAC;IACtB,CAAC;AACH,CAAC;AAED,OAAO,CAAC,EAAE,CAAC,CAAC;AAEZ,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC"}

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

@@ -0,0 +1,3 @@
+import type { ElementTemplateUpdateCommandStream } from '../protocol/types.js';
+export type { ElementTemplateUpdateCommandStream } from '../protocol/types.js';
+export declare function applyElementTemplateUpdateCommands(stream: ElementTemplateUpdateCommandStream): void;

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

@@ -0,0 +1,145 @@
+// 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 { elementTemplateRegistry } from './template/registry.js';
+import { ElementTemplateUpdateOps } from '../protocol/opcodes.js';
+export function applyElementTemplateUpdateCommands(stream) {
+    let i = 0;
+    while (i < stream.length) {
+        const op = stream[i++];
+        switch (op) {
+            case ElementTemplateUpdateOps.createTemplate: {
+                const handleId = stream[i++];
+                const templateKey = stream[i++];
+                const bundleUrl = stream[i++];
+                const attributeSlots = stream[i++];
+                const elementSlots = stream[i++];
+                if (__DEV__) {
+                    const createError = validateCreateTemplatePayload(handleId, attributeSlots, elementSlots);
+                    if (createError) {
+                        lynx.reportError(createError);
+                        continue;
+                    }
+                }
+                const resolvedElementSlots = resolveElementSlots(elementSlots);
+                if (__DEV__ && resolvedElementSlots.hasError) {
+                    continue;
+                }
+                const nativeRef = __CreateElementTemplate(templateKey, bundleUrl, normalizeAttributeSlots(attributeSlots), resolvedElementSlots.value, handleId);
+                if (nativeRef) {
+                    elementTemplateRegistry.set(handleId, nativeRef);
+                }
+                break;
+            }
+            case ElementTemplateUpdateOps.setAttribute: {
+                const targetId = stream[i++];
+                const attrSlotIndex = stream[i++];
+                const value = stream[i++];
+                const nativeRef = resolveHandle(targetId, 'target');
+                if (!nativeRef) {
+                    continue;
+                }
+                __SetAttributeOfElementTemplate(nativeRef, attrSlotIndex, value, null);
+                break;
+            }
+            case ElementTemplateUpdateOps.insertNode: {
+                const targetId = stream[i++];
+                const elementSlotIndex = stream[i++];
+                const childId = stream[i++];
+                const referenceId = stream[i++];
+                const nativeRef = resolveHandle(targetId, 'target');
+                const childRef = resolveHandle(childId, 'child');
+                if (!nativeRef || !childRef) {
+                    continue;
+                }
+                const referenceRef = referenceId === 0 ? null : resolveHandle(referenceId, 'reference');
+                if (referenceId !== 0 && !referenceRef) {
+                    continue;
+                }
+                __InsertNodeToElementTemplate(nativeRef, elementSlotIndex, childRef, referenceRef);
+                break;
+            }
+            case ElementTemplateUpdateOps.removeNode: {
+                const targetId = stream[i++];
+                const elementSlotIndex = stream[i++];
+                const childId = stream[i++];
+                const removedSubtreeHandleIds = stream[i++];
+                const nativeRef = resolveHandle(targetId, 'target');
+                const childRef = resolveHandle(childId, 'child');
+                if (!nativeRef || !childRef) {
+                    continue;
+                }
+                __RemoveNodeFromElementTemplate(nativeRef, elementSlotIndex, childRef);
+                // The native API only detaches from the slot. Releasing ET runtime's
+                // strong refs after a successful detach lets JS GC reclaim the subtree.
+                for (const handleId of removedSubtreeHandleIds) {
+                    elementTemplateRegistry.delete(handleId);
+                }
+                break;
+            }
+            default: {
+                lynx.reportError(new Error(`ElementTemplate update opcode ${String(op)} is not supported.`));
+            }
+        }
+    }
+}
+function resolveElementSlots(elementSlots) {
+    if (!Array.isArray(elementSlots)) {
+        return { hasError: false, value: null };
+    }
+    let hasError = false;
+    const value = elementSlots.map((children, slotIndex) => {
+        if (!Array.isArray(children)) {
+            if (__DEV__) {
+                lynx.reportError(new Error(`ElementTemplate create slot ${slotIndex} must be an array of child handles.`));
+                hasError = true;
+            }
+            return [];
+        }
+        return children
+            .map((childId) => {
+            const childRef = __DEV__
+                ? resolveHandle(childId, 'child')
+                : (elementTemplateRegistry.get(childId) ?? null);
+            if (__DEV__ && childRef === null) {
+                hasError = true;
+            }
+            return childRef;
+        })
+            .filter((childRef) => childRef !== null);
+    });
+    return { hasError, value };
+}
+function resolveHandle(id, role) {
+    const nativeRef = elementTemplateRegistry.get(id);
+    if (!nativeRef) {
+        lynx.reportError(new Error(`ElementTemplate update ${role} handle ${id} not found.`));
+        return null;
+    }
+    return nativeRef;
+}
+function isValidHandleId(handleId) {
+    return Number.isInteger(handleId) && handleId !== 0;
+}
+function validateCreateTemplatePayload(handleId, attributeSlots, elementSlots) {
+    if (!isValidHandleId(handleId)) {
+        return new Error(`ElementTemplate update has invalid handleId ${String(handleId)}.`);
+    }
+    if (elementTemplateRegistry.get(handleId)) {
+        return new Error(`ElementTemplate update received duplicate handleId ${handleId}.`);
+    }
+    if (attributeSlots != null && !Array.isArray(attributeSlots)) {
+        return new Error('ElementTemplate update create attributeSlots must be an array, null, or undefined.');
+    }
+    if (elementSlots != null && !Array.isArray(elementSlots)) {
+        return new Error('ElementTemplate update create elementSlots must be an array, null, or undefined.');
+    }
+    return null;
+}
+function normalizeAttributeSlots(attributeSlots) {
+    if (!Array.isArray(attributeSlots)) {
+        return attributeSlots;
+    }
+    return attributeSlots.map((value) => (value === undefined ? null : value));
+}
+//# sourceMappingURL=patch.js.map

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

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

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

@@ -0,0 +1,53 @@
+// 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 { profileEnd, profileStart } from '../../debug/profile.js';
+import { ElementTemplateLifecycleConstant } from '../../protocol/lifecycle-constant.js';
+import { __page } from '../page/page.js';
+import { __root } from '../page/root-instance.js';
+function renderMainThread() {
+    let opcodes;
+    let rootRefs = [];
+    profileStart('ReactLynx::renderMainThread');
+    try {
+        opcodes = renderToString(__root.__jsx, undefined);
+    }
+    catch (e) {
+        lynx.reportError(e);
+        opcodes = [];
+    }
+    finally {
+        profileEnd();
+    }
+    profileStart('ReactLynx::renderOpcodes');
+    try {
+        rootRefs = renderOpcodesIntoElementTemplate(opcodes).rootRefs;
+        for (const rootRef of rootRefs) {
+            __AppendElement(__page, rootRef);
+        }
+    }
+    finally {
+        profileEnd();
+    }
+    profileStart('ReactLynx::packSerializedETInstance');
+    try {
+        const instances = [];
+        for (const rootRef of rootRefs) {
+            instances.push(__SerializeElementTemplate(rootRef));
+        }
+        lynx.getJSContext().dispatchEvent({
+            type: ElementTemplateLifecycleConstant.hydrate,
+            data: instances,
+        });
+    }
+    finally {
+        profileEnd();
+    }
+}
+export { renderMainThread };
+//# 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,UAAU,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,gCAAgC,EAAE,MAAM,sCAAsC,CAAC;AAExF,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAElD,SAAS,gBAAgB;IACvB,IAAI,OAAO,CAAC;IACZ,IAAI,QAAQ,GAAiB,EAAE,CAAC;IAChC,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,QAAQ,GAAG,gCAAgC,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC;QAC9D,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;YAAS,CAAC;QACT,UAAU,EAAE,CAAC;IACf,CAAC;IAED,YAAY,CAAC,qCAAqC,CAAC,CAAC;IACpD,IAAI,CAAC;QACH,MAAM,SAAS,GAAgC,EAAE,CAAC;QAClD,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,SAAS,CAAC,IAAI,CAAC,0BAA0B,CAAC,OAAO,CAAC,CAAC,CAAC;QACtD,CAAC;QAED,IAAI,CAAC,YAAY,EAAE,CAAC,aAAa,CAAC;YAChC,IAAI,EAAE,gCAAgC,CAAC,OAAO;YAC9C,IAAI,EAAE,SAAS;SAChB,CAAC,CAAC;IACL,CAAC;YAAS,CAAC;QACT,UAAU,EAAE,CAAC;IACf,CAAC;AACH,CAAC;AAED,OAAO,EAAE,gBAAgB,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;