@lynx-js/react 0.121.0 → 0.121.2

package/runtime/lib/element-template/prop-adapters/spread.js

@@ -2,6 +2,7 @@
 // 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 './event-value.js';
+import { prepareSpreadRefAttrValue } from './ref.js';
 const eventPropKeyRegExp = /^(?:global-bind|bind|catch|capture-bind|capture-catch)[A-Za-z]+$/;
 const namespacedEventKeyRegExp = /^[A-Za-z-]+:(?:global-bind|bind|catch|capture-bind|capture-catch)[A-Za-z]+$/;
 function isEventPropKey(key) {
@@ -24,6 +25,13 @@ export function prepareSpreadAttrSlot(handleId, attrSlotIndex, value, _context)
             prepared['class'] = (spreadValue ?? '');
             continue;
         }
+        if (key === 'ref') {
+            const refValue = prepareSpreadRefAttrValue(handleId, attrSlotIndex, value);
+            if (refValue !== undefined) {
+                prepared['ref'] = refValue;
+            }
+            continue;
+        }
         if (isEventPropKey(key)) {
             prepared[key] = spreadValue === null || spreadValue === undefined || spreadValue === false
                 ? null
@@ -31,7 +39,6 @@ export function prepareSpreadAttrSlot(handleId, attrSlotIndex, value, _context)
             continue;
         }
         if (spreadValue === undefined
-            || key === 'ref'
             || key.endsWith(':ref')
             || key.endsWith(':gesture')
             || namespacedEventKeyRegExp.test(key)

package/runtime/lib/element-template/prop-adapters/spread.js.map

@@ -1 +1 @@
-{"version":3,"file":"spread.js","sourceRoot":"","sources":["../../../src/element-template/prop-adapters/spread.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,yEAAyE;AACzE,0DAA0D;AAE1D,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAOjD,MAAM,kBAAkB,GAAG,kEAAkE,CAAC;AAC9F,MAAM,wBAAwB,GAAG,6EAA6E,CAAC;AAE/G,SAAS,cAAc,CAAC,GAAW;IACjC,OAAO,kBAAkB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACtC,CAAC;AAED,SAAS,cAAc,CAAC,KAAc;IACpC,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,QAAgB,EAChB,aAAqB,EACrB,KAAc,EACd,QAAmC;IAEnC,IAAI,KAAK,KAAK,KAAK,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;QAC9C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,QAAQ,GAAsC,EAAE,CAAC;IAEvD,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;QACxB,MAAM,WAAW,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;QAC/B,IAAI,GAAG,KAAK,UAAU,IAAI,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,UAAU,EAAE,CAAC;YACjE,SAAS;QACX,CAAC;QAED,IAAI,GAAG,KAAK,OAAO,IAAI,GAAG,KAAK,WAAW,EAAE,CAAC;YAC3C,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,EAAE,CAAsB,CAAC;YAC7D,SAAS;QACX,CAAC;QAED,IAAI,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB,QAAQ,CAAC,GAAG,CAAC,GAAG,WAAW,KAAK,IAAI,IAAI,WAAW,KAAK,SAAS,IAAI,WAAW,KAAK,KAAK;gBACxF,CAAC,CAAC,IAAI;gBACN,CAAC,CAAC,aAAa,CAAC,QAAQ,EAAE,aAAa,EAAE,GAAG,CAAC,CAAC;YAChD,SAAS;QACX,CAAC;QAED,IACE,WAAW,KAAK,SAAS;eACtB,GAAG,KAAK,KAAK;eACb,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC;eACpB,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC;eACxB,wBAAwB,CAAC,IAAI,CAAC,GAAG,CAAC;eAClC,OAAO,WAAW,KAAK,UAAU,EACpC,CAAC;YACD,SAAS;QACX,CAAC;QAED,QAAQ,CAAC,GAAG,CAAC,GAAG,WAAgC,CAAC;IACnD,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}
+{"version":3,"file":"spread.js","sourceRoot":"","sources":["../../../src/element-template/prop-adapters/spread.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,yEAAyE;AACzE,0DAA0D;AAE1D,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC;AAOrD,MAAM,kBAAkB,GAAG,kEAAkE,CAAC;AAC9F,MAAM,wBAAwB,GAAG,6EAA6E,CAAC;AAE/G,SAAS,cAAc,CAAC,GAAW;IACjC,OAAO,kBAAkB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACtC,CAAC;AAED,SAAS,cAAc,CAAC,KAAc;IACpC,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,QAAgB,EAChB,aAAqB,EACrB,KAAc,EACd,QAAmC;IAEnC,IAAI,KAAK,KAAK,KAAK,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;QAC9C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,QAAQ,GAAsC,EAAE,CAAC;IAEvD,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;QACxB,MAAM,WAAW,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;QAC/B,IAAI,GAAG,KAAK,UAAU,IAAI,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,UAAU,EAAE,CAAC;YACjE,SAAS;QACX,CAAC;QAED,IAAI,GAAG,KAAK,OAAO,IAAI,GAAG,KAAK,WAAW,EAAE,CAAC;YAC3C,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,EAAE,CAAsB,CAAC;YAC7D,SAAS;QACX,CAAC;QAED,IAAI,GAAG,KAAK,KAAK,EAAE,CAAC;YAClB,MAAM,QAAQ,GAAG,yBAAyB,CAAC,QAAQ,EAAE,aAAa,EAAE,KAAK,CAAC,CAAC;YAC3E,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;gBAC3B,QAAQ,CAAC,KAAK,CAAC,GAAG,QAAQ,CAAC;YAC7B,CAAC;YACD,SAAS;QACX,CAAC;QAED,IAAI,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB,QAAQ,CAAC,GAAG,CAAC,GAAG,WAAW,KAAK,IAAI,IAAI,WAAW,KAAK,SAAS,IAAI,WAAW,KAAK,KAAK;gBACxF,CAAC,CAAC,IAAI;gBACN,CAAC,CAAC,aAAa,CAAC,QAAQ,EAAE,aAAa,EAAE,GAAG,CAAC,CAAC;YAChD,SAAS;QACX,CAAC;QAED,IACE,WAAW,KAAK,SAAS;eACtB,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC;eACpB,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC;eACxB,wBAAwB,CAAC,IAAI,CAAC,GAAG,CAAC;eAClC,OAAO,WAAW,KAAK,UAAU,EACpC,CAAC;YACD,SAAS;QACX,CAAC;QAED,QAAQ,CAAC,GAAG,CAAC,GAAG,WAAgC,CAAC;IACnD,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

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

@@ -3,5 +3,9 @@ export declare const ElementTemplateUpdateOps: {
     readonly setAttribute: 2;
     readonly insertNode: 3;
     readonly removeNode: 4;
+    readonly createTypedElement: 5;
+    readonly insertTypedListItem: 6;
+    readonly removeTypedListItem: 7;
+    readonly updateTypedListItem: 8;
 };
 export type ElementTemplateUpdateOp = typeof ElementTemplateUpdateOps[keyof typeof ElementTemplateUpdateOps];

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

@@ -6,5 +6,9 @@ export const ElementTemplateUpdateOps = {
     setAttribute: 2,
     insertNode: 3,
     removeNode: 4,
+    createTypedElement: 5,
+    insertTypedListItem: 6,
+    removeTypedListItem: 7,
+    updateTypedListItem: 8,
 };
 //# sourceMappingURL=opcodes.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"opcodes.js","sourceRoot":"","sources":["../../../src/element-template/protocol/opcodes.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,yEAAyE;AACzE,0DAA0D;AAE1D,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,cAAc,EAAE,CAAC;IACjB,YAAY,EAAE,CAAC;IACf,UAAU,EAAE,CAAC;IACb,UAAU,EAAE,CAAC;CACL,CAAC"}
+{"version":3,"file":"opcodes.js","sourceRoot":"","sources":["../../../src/element-template/protocol/opcodes.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,yEAAyE;AACzE,0DAA0D;AAE1D,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,cAAc,EAAE,CAAC;IACjB,YAAY,EAAE,CAAC;IACf,UAAU,EAAE,CAAC;IACb,UAAU,EAAE,CAAC;IACb,kBAAkB,EAAE,CAAC;IACrB,mBAAmB,EAAE,CAAC;IACtB,mBAAmB,EAAE,CAAC;IACtB,mBAAmB,EAAE,CAAC;CACd,CAAC"}

package/runtime/lib/element-template/protocol/template-type.d.ts

@@ -0,0 +1,6 @@
+export interface ParsedElementTemplateType {
+    templateKey: string;
+    bundleUrl: string | null;
+}
+export declare function parseElementTemplateType(type: string): ParsedElementTemplateType;
+export declare function elementTemplateIdentityKey(templateKey: string, bundleUrl: string | null | undefined): string;

package/runtime/lib/element-template/protocol/template-type.js

@@ -0,0 +1,20 @@
+// 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.
+export function parseElementTemplateType(type) {
+    const delimiter = type.lastIndexOf(':');
+    if (delimiter < 0) {
+        return {
+            templateKey: type,
+            bundleUrl: null,
+        };
+    }
+    return {
+        templateKey: type.slice(delimiter + 1),
+        bundleUrl: type.slice(0, delimiter),
+    };
+}
+export function elementTemplateIdentityKey(templateKey, bundleUrl) {
+    return bundleUrl == null ? templateKey : `${bundleUrl}:${templateKey}`;
+}
+//# sourceMappingURL=template-type.js.map

package/runtime/lib/element-template/protocol/template-type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-type.js","sourceRoot":"","sources":["../../../src/element-template/protocol/template-type.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,yEAAyE;AACzE,0DAA0D;AAO1D,MAAM,UAAU,wBAAwB,CAAC,IAAY;IACnD,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACxC,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;QAClB,OAAO;YACL,WAAW,EAAE,IAAI;YACjB,SAAS,EAAE,IAAI;SAChB,CAAC;IACJ,CAAC;IACD,OAAO;QACL,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC;QACtC,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC;KACpC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,WAAmB,EACnB,SAAoC;IAEpC,OAAO,SAAS,IAAI,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,SAAS,IAAI,WAAW,EAAE,CAAC;AACzE,CAAC"}

package/runtime/lib/element-template/protocol/types.d.ts

@@ -2,13 +2,54 @@ import { ElementTemplateUpdateOps } from './opcodes.js';
 export type SerializableValue = string | number | boolean | null | SerializableValue[] | {
     [key: string]: SerializableValue;
 };
-export type RuntimeOptions = Record<string, SerializableValue>;
-export interface SerializedElementTemplate {
+export type RuntimeOptionValue = SerializableValue | ElementRef | RuntimeOptionValue[] | {
+    [key: string]: RuntimeOptionValue;
+};
+export type RuntimeOptions = Record<string, RuntimeOptionValue>;
+export type RuntimeAttributeSlotValue = SerializableValue | ((...args: unknown[]) => unknown) | RuntimeAttributeSlotValue[] | {
+    [key: string]: RuntimeAttributeSlotValue;
+};
+export type RuntimeTypedElementAttributes = Record<string, RuntimeAttributeSlotValue>;
+export type TypedElementAttributesCommand = Record<string, SerializableValue>;
+export type RuntimeElementSlots = Array<ElementRef[] | null | undefined>;
+export type ElementTemplateHandleSlotsCommand = Array<number[] | null | undefined>;
+export type SerializedEtNodeSlots = Array<SerializedEtNode[] | null | undefined>;
+export interface ElementTemplateHandleRefCommandValue {
+    __etHandleRef: number;
+    [key: string]: SerializableValue;
+}
+export interface UpdateTypedListItemCommand extends ElementTemplateHandleRefCommandValue {
+    type: string;
+    platformInfo: Record<string, SerializableValue>;
+}
+export interface RuntimeOptionsCommand extends Record<string, SerializableValue> {
+    listChildren?: UpdateTypedListItemCommand[];
+}
+export type SerializedRuntimeOptionValue = SerializableValue | SerializedEtNode | SerializedRuntimeOptionValue[] | {
+    [key: string]: SerializedRuntimeOptionValue;
+};
+export type SerializedRuntimeOptions = Record<string, SerializedRuntimeOptionValue>;
+export interface SerializedEtNodeBase {
+    attributeSlots?: SerializableValue[] | null;
+    elementSlots?: SerializedEtNodeSlots | null;
+    uid: number | string;
+    options?: SerializedRuntimeOptions | null;
+}
+export interface SerializedCompiledNode extends SerializedEtNodeBase {
     templateKey: string;
     bundleUrl?: string;
     attributeSlots?: SerializableValue[] | null;
-    elementSlots?: SerializedElementTemplate[][] | null;
-    uid: number | string;
+}
+export interface SerializedTypedNode extends SerializedEtNodeBase {
+    tag: string;
+    attributes?: TypedElementAttributesCommand | null;
+}
+export type SerializedEtNode = SerializedCompiledNode | SerializedTypedNode;
+export interface ElementTemplateHydrateCommitContext {
+    instances: SerializedEtNode[];
+    reloadVersion?: number;
+}
+export interface SerializedElementTemplate extends SerializedCompiledNode {
 }
 export type CreateTemplateCommand = [
     typeof ElementTemplateUpdateOps.createTemplate,
@@ -16,7 +57,7 @@ export type CreateTemplateCommand = [
     templateKey: string,
     bundleUrl: string | null | undefined,
     attributeSlots: SerializableValue[] | null | undefined,
-    elementSlots: number[][] | null | undefined
+    elementSlots: ElementTemplateHandleSlotsCommand | null | undefined
 ];
 export type SetAttributeCommand = [
     typeof ElementTemplateUpdateOps.setAttribute,
@@ -38,13 +79,40 @@ export type RemoveNodeCommand = [
     childHandleId: number,
     removedSubtreeHandleIds: number[]
 ];
-export type ElementTemplateUpdateCommand = CreateTemplateCommand | SetAttributeCommand | InsertNodeCommand | RemoveNodeCommand;
+export type CreateTypedElementCommand = [
+    typeof ElementTemplateUpdateOps.createTypedElement,
+    handleId: number,
+    type: string,
+    attributes: TypedElementAttributesCommand | null | undefined,
+    elementSlots: ElementTemplateHandleSlotsCommand | null | undefined,
+    options: RuntimeOptionsCommand | null | undefined
+];
+export type InsertTypedListItemCommand = [
+    typeof ElementTemplateUpdateOps.insertTypedListItem,
+    listHandleId: number,
+    item: UpdateTypedListItemCommand,
+    beforeHandleId: number
+];
+export type RemoveTypedListItemCommand = [
+    typeof ElementTemplateUpdateOps.removeTypedListItem,
+    listHandleId: number,
+    itemHandleId: number,
+    removedSubtreeHandleIds: number[]
+];
+export type UpdateTypedListItemInfoCommand = [
+    typeof ElementTemplateUpdateOps.updateTypedListItem,
+    listHandleId: number,
+    item: UpdateTypedListItemCommand
+];
+export type ElementTemplateUpdateCommand = CreateTemplateCommand | SetAttributeCommand | InsertNodeCommand | RemoveNodeCommand | CreateTypedElementCommand | InsertTypedListItemCommand | RemoveTypedListItemCommand | UpdateTypedListItemInfoCommand;
 export type ElementTemplateUpdateCommandStream = ElementTemplateUpdateCommand[number][];
 export interface ElementTemplateFlushOptions {
     pipelineOptions?: PipelineOptions;
+    triggerDataUpdated?: boolean;
 }
 export interface ElementTemplateUpdateCommitContext {
     ops: ElementTemplateUpdateCommandStream;
     flushOptions: ElementTemplateFlushOptions;
     flowIds?: number[];
+    reloadVersion?: number;
 }

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

@@ -0,0 +1,65 @@
+import type { RuntimeTypedElementAttributes, SerializableValue } from '../../protocol/types.js';
+export type ETListItemPlatformInfo = Record<string, SerializableValue>;
+export interface ETListItemMeta {
+    templateKey: string;
+    platformInfo: ETListItemPlatformInfo;
+}
+interface ETListItemRecord extends ETListItemMeta {
+    uid: number;
+    ref: ElementRef;
+    attached: boolean;
+    needsAttachMove: boolean;
+    skipNextEnqueue: boolean;
+}
+interface ETListCallbacks {
+    componentAtIndex: ComponentAtIndexCallback;
+    componentAtIndexes: ComponentAtIndexesCallback;
+    enqueueComponent: EnqueueComponentCallback;
+}
+export interface ETListState {
+    listHandleId: number | null;
+    holderRef: ElementRef | null;
+    items: ETListItemRecord[];
+    callbackItemBySign: Map<number, ETListItemRecord>;
+    destroyed: boolean;
+    hasAttachedMoves: boolean;
+    attributes: RuntimeTypedElementAttributes;
+    callbacks: ETListCallbacks;
+}
+export interface ETListUpdateItem extends ETListItemMeta {
+    uid: number;
+    ref: ElementRef;
+}
+export interface ETListUpdateInfo {
+    insertAction: Array<{
+        position: number;
+        type: string;
+    } & ETListItemPlatformInfo>;
+    removeAction: number[];
+    updateAction: Array<{
+        from: number;
+        to: number;
+        type: string;
+        flush: boolean;
+    } & ETListItemPlatformInfo>;
+}
+export interface ETListFlushResult {
+    uid: number;
+    attributes: RuntimeTypedElementAttributes;
+    removedSubtreeHandleIds?: number[];
+}
+export declare function registerElementTemplateListItem(uid: number, ref: ElementRef, meta: ETListItemMeta): void;
+export declare function createElementTemplateListState(listItemUids: readonly number[], attributes?: RuntimeTypedElementAttributes | null): ETListState;
+export declare function createElementTemplateListInitialUpdateInfo(state: ETListState): ETListUpdateInfo;
+export declare function createElementTemplateListStateFromItems(items: ETListUpdateItem[], attributes?: RuntimeTypedElementAttributes | null): ETListState;
+export declare function registerElementTemplateListState(uid: number, state: ETListState, needsInitialFlush: boolean, holderRef: ElementRef): void;
+export declare function markElementTemplateListDestroyed(uid: number): number[] | undefined;
+export declare function destroyAllElementTemplateListStates(): void;
+export declare function updateElementTemplateListAttributes(uid: number, attributes: RuntimeTypedElementAttributes | null | undefined, updateListInfo?: ETListUpdateInfo): RuntimeTypedElementAttributes | null;
+export declare function insertElementTemplateListItem(uid: number, item: ETListUpdateItem, beforeUid: number): void;
+export declare function removeElementTemplateListItem(uid: number, itemUid: number, removedSubtreeHandleIds: readonly number[]): void;
+export declare function updateElementTemplateListItem(uid: number, item: ETListUpdateItem): void;
+export declare function flushPendingElementTemplateListUpdates(): ETListFlushResult[];
+export declare function flushInitialElementTemplateListUpdates(): ETListFlushResult[];
+export declare function composeElementTemplateListAttributes(attributes: RuntimeTypedElementAttributes | null | undefined, state: ETListState, updateListInfo?: ETListUpdateInfo): RuntimeTypedElementAttributes;
+export {};