@lynx-js/react 0.111.1 → 0.111.2

package/runtime/src/renderToOpcodes/index.ts

@@ -1,306 +0,0 @@
-// 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,
-  DIFFED,
-  DIRTY,
-  NEXT_STATE,
-  PARENT,
-  RENDER,
-  SKIP_EFFECTS,
-  VNODE,
-} from './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, 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: any, context: any): any[] {
-  // 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];
-  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,
-      false,
-      undefined,
-      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
-function markAsDirty() {
-  this.__d = true;
-}
-
-const EMPTY_OBJ = {};
-
-export const __OpBegin = 0;
-export const __OpEnd = 1;
-export const __OpAttr = 2;
-export const __OpText = 3;
-
-/**
- * @param {VNode} vnode
- * @param {Record<string, unknown>} context
- */
-function renderClassComponent(vnode, context) {
-  const type = /** @type {import("preact").ComponentClass<typeof vnode.props>} */ (vnode.type);
-
-  const 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);
-}
-
-/**
- * Recursively render VNodes to HTML.
- * @param {VNode|any} vnode
- * @param {any} context
- * @param {boolean} isSvgMode
- * @param {any} selectValue
- * @param {VNode} parent
- * @param opcodes
- */
-function _renderToString(
-  vnode,
-  context,
-  isSvgMode,
-  selectValue,
-  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, isSvgMode, selectValue, parent, opcodes);
-    }
-    return;
-  }
-
-  // VNodes have {constructor:undefined} to prevent JSON injection:
-  // if (vnode.constructor !== undefined) return;
-
-  vnode[PARENT] = parent;
-  if (beforeDiff) beforeDiff(vnode);
-
-  let type = vnode.type,
-    props = vnode.props,
-    cctx = context,
-    contextType,
-    rendered,
-    component;
-
-  // Invoke rendering on Components
-  if (typeof type === 'function') {
-    if (type === Fragment) {
-      rendered = props.children;
-    } else {
-      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;
-
-        // If a hook invokes setState() to invalidate the component during rendering,
-        // re-render it up to 25 times to allow "settling" of memoized states.
-        // Note:
-        //   This will need to be updated for Preact 11 to use internal.flags rather than component._dirty:
-        //   https://github.com/preactjs/preact/blob/d4ca6fdb19bc715e49fd144e69f7296b2f4daa40/src/diff/component.js#L35-L44
-        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());
-      }
-    }
-
-    // When a component returns a Fragment node we flatten it in core, so we
-    // need to mirror that logic here too
-    const isTopLevelFragment = rendered != null && rendered.type === Fragment
-      && rendered.key == null;
-    rendered = isTopLevelFragment ? rendered.props.children : rendered;
-
-    // Recurse into children before invoking the after-diff hook
-    _renderToString(rendered, context, isSvgMode, selectValue, vnode, opcodes);
-    if (afterDiff) afterDiff(vnode);
-    vnode[PARENT] = undefined;
-
-    if (ummountHook) ummountHook(vnode);
-
-    return;
-  }
-
-  let children;
-
-  opcodes.push(__OpBegin, vnode);
-
-  for (const name in props) {
-    const v = props[name];
-
-    switch (name) {
-      case 'children':
-        children = v;
-        continue;
-
-      // VDOM-specific props
-      /* c8 ignore next 5 */
-      case 'key':
-      case 'ref':
-      case '__self':
-      case '__source':
-        continue;
-
-      default: {}
-    }
-
-    // write this attribute to the buffer
-    if (v != null && v !== false && typeof v !== 'function') {
-      opcodes.push(__OpAttr, name, v);
-    }
-  }
-
-  if (typeof children === 'string') {
-    // single text child
-    opcodes.push(__OpText, children);
-  } else if (children != null && children !== false && children !== true) {
-    // recurse into this element VNode's children
-    _renderToString(children, context, false, selectValue, vnode, opcodes);
-  }
-
-  if (afterDiff) afterDiff(vnode);
-  vnode[PARENT] = undefined;
-  if (ummountHook) ummountHook(vnode);
-
-  opcodes.push(__OpEnd);
-
-  return;
-}
-
-/** The `.render()` method for a PFC backing instance. */
-function doRender(props, state, context) {
-  return this.constructor(props, context);
-}
-
-export default renderToString;
-export const render: typeof renderToString = renderToString;
-export const renderToStaticMarkup: typeof renderToString = renderToString;

package/runtime/src/root.ts

@@ -1,23 +0,0 @@
-// 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 { BackgroundSnapshotInstance } from './backgroundSnapshot.js';
-import { SnapshotInstance } from './snapshot.js';
-
-/**
- * The internal ReactLynx's root.
- * {@link @lynx-js/react!Root | root}.
- */
-let __root: (SnapshotInstance | BackgroundSnapshotInstance) & { __jsx?: React.ReactNode; __opcodes?: any[] };
-
-function setRoot(root: typeof __root): void {
-  __root = root;
-}
-
-if (__MAIN_THREAD__) {
-  setRoot(new SnapshotInstance('root'));
-} else if (__BACKGROUND__) {
-  setRoot(new BackgroundSnapshotInstance('root'));
-}
-
-export { __root, setRoot };

package/runtime/src/snapshot/dynamicPartType.ts

@@ -1,16 +0,0 @@
-// 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.
-
-/**
- * Types of dynamic parts that can be updated in a snapshot
- * These are determined at compile time through static analysis
- */
-export const enum DynamicPartType {
-  Attr = 0, // Regular attribute updates
-  Spread, // Spread operator in JSX
-  Slot, // Slot for component children
-  Children, // Regular children updates
-  ListChildren, // List/array children updates
-  MultiChildren, // Multiple children updates (compat layer)
-}

package/runtime/src/snapshot/event.ts

@@ -1,33 +0,0 @@
-// 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 { SnapshotInstance } from '../snapshot.js';
-
-function updateEvent(
-  snapshot: SnapshotInstance,
-  expIndex: number,
-  _oldValue: any,
-  elementIndex: number,
-  eventType: string,
-  eventName: string,
-  spreadKey: string,
-): void {
-  const value = snapshot.__values![expIndex];
-  let event;
-  if (!value) {
-    event = undefined;
-  } else if (typeof value === 'string') {
-    event = value;
-  } else {
-    event = `${snapshot.__id}:${expIndex}:${spreadKey}`;
-  }
-
-  // todo: reuseId?
-
-  snapshot.__values![expIndex] = event;
-  if (snapshot.__elements) {
-    __AddEvent(snapshot.__elements[elementIndex]!, eventType, eventName, event);
-  }
-}
-
-export { updateEvent };

package/runtime/src/snapshot/gesture.ts

@@ -1,30 +0,0 @@
-// 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 { processGesture } from '../gesture/processGesture.js';
-import type { GestureKind } from '../gesture/types.js';
-import { isMainThreadHydrationFinished } from '../lifecycle/patch/isMainThreadHydrationFinished.js';
-import { SnapshotInstance } from '../snapshot.js';
-
-export function updateGesture(
-  snapshot: SnapshotInstance,
-  expIndex: number,
-  oldValue: any,
-  elementIndex: number,
-  workletType: string,
-): void {
-  if (!snapshot.__elements) {
-    return;
-  }
-  if (__PROFILE__) {
-    console.profile('updateGesture');
-  }
-  const value = snapshot.__values![expIndex] as GestureKind;
-
-  if (workletType === 'main-thread') {
-    processGesture(snapshot.__elements[elementIndex]!, value, oldValue as GestureKind, !isMainThreadHydrationFinished);
-  }
-  if (__PROFILE__) {
-    console.profileEnd();
-  }
-}

package/runtime/src/snapshot/list.ts

@@ -1,36 +0,0 @@
-// 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 { hydrate } from '../hydrate.js';
-import { componentAtIndexFactory, enqueueComponentFactory, gRecycleMap, gSignMap } from '../list.js';
-import type { SnapshotInstance } from '../snapshot.js';
-
-export function snapshotCreateList(
-  pageId: number,
-  _ctx: SnapshotInstance,
-  _expIndex: number,
-): FiberElement {
-  const signMap = new Map<number, SnapshotInstance>();
-  const recycleMap = new Map<string, Map<number, SnapshotInstance>>();
-  const [componentAtIndex, componentAtIndexes] = componentAtIndexFactory([], hydrate);
-  const list = __CreateList(
-    pageId,
-    componentAtIndex,
-    enqueueComponentFactory(),
-    {},
-    componentAtIndexes,
-  );
-  const listID = __GetElementUniqueID(list);
-  gSignMap[listID] = signMap;
-  gRecycleMap[listID] = recycleMap;
-  return list;
-}
-
-export function snapshotDestroyList(si: SnapshotInstance): void {
-  const [, elementIndex] = si.__snapshot_def.slot[0]!;
-  const list = si.__elements![elementIndex]!;
-  const listID = __GetElementUniqueID(list);
-  delete gSignMap[listID];
-  delete gRecycleMap[listID];
-}

package/runtime/src/snapshot/platformInfo.ts

@@ -1,62 +0,0 @@
-// 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 { ListUpdateInfoRecording } from '../listUpdateInfo.js';
-import { __pendingListUpdates } from '../pendingListUpdates.js';
-import { SnapshotInstance } from '../snapshot.js';
-
-const platformInfoVirtualAttributes: Set<string> = /* @__PURE__ */ new Set<string>(['reuse-identifier']);
-const platformInfoAttributes: Set<string> = /* @__PURE__ */ new Set<string>([
-  'reuse-identifier',
-  'full-span',
-  'item-key',
-  'sticky-top',
-  'sticky-bottom',
-  'estimated-height',
-  'estimated-height-px',
-  'estimated-main-axis-size-px',
-]);
-
-export interface PlatformInfo {
-  'reuse-identifier'?: string;
-  'full-span'?: boolean;
-  'item-key'?: string;
-  'sticky-top'?: boolean;
-  'sticky-bottom'?: boolean;
-  'estimated-height'?: number;
-  'estimated-height-px'?: number;
-  'estimated-main-axis-size-px'?: number;
-}
-
-function updateListItemPlatformInfo(
-  ctx: SnapshotInstance,
-  index: number,
-  oldValue: any,
-  elementIndex: number,
-): void {
-  const newValue = ctx.__listItemPlatformInfo = ctx.__values![index] as PlatformInfo;
-
-  const list = ctx.parentNode;
-  if (list?.__snapshot_def.isListHolder) {
-    (__pendingListUpdates.values[list.__id] ??= new ListUpdateInfoRecording(list)).onSetAttribute(
-      ctx,
-      newValue,
-      oldValue,
-    );
-  }
-
-  // In this updater, unlike `updateSpread`, the shape of the value is guaranteed to be an fixed object.
-  // No adding / removing keys.
-  if (ctx.__elements) {
-    const e = ctx.__elements[elementIndex]!;
-    const value = ctx.__values![index] as Record<string, unknown>;
-    for (const k in value) {
-      if (platformInfoVirtualAttributes.has(k)) {
-        continue;
-      }
-      __SetAttribute(e, k, value[k]);
-    }
-  }
-}
-
-export { updateListItemPlatformInfo, platformInfoAttributes };

package/runtime/src/snapshot/ref.ts

@@ -1,139 +0,0 @@
-// 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 type { Element, Worklet, WorkletRefImpl } from '@lynx-js/react/worklet-runtime/bindings';
-
-import type { SnapshotInstance } from '../snapshot.js';
-import { workletUnRef } from './workletRef.js';
-import { RefProxy } from '../lifecycle/ref/delay.js';
-
-const refsToClear: Ref[] = [];
-const refsToApply: (Ref | [snapshotInstanceId: number, expIndex: number])[] = [];
-
-type Ref = (((ref: RefProxy) => () => void) | { current: RefProxy | null }) & {
-  _unmount?: () => void;
-  __ref?: { value: number };
-};
-
-function unref(snapshot: SnapshotInstance, recursive: boolean): void {
-  snapshot.__worklet_ref_set?.forEach(v => {
-    if (v) {
-      workletUnRef(v as Worklet | WorkletRefImpl<Element>);
-    }
-  });
-  snapshot.__worklet_ref_set?.clear();
-
-  if (recursive) {
-    snapshot.childNodes.forEach(it => {
-      unref(it, recursive);
-    });
-  }
-}
-
-// This function is modified from preact source code.
-function applyRef(ref: Ref, value: null | [snapshotInstanceId: number, expIndex: number]): void {
-  const newRef = value && new RefProxy(value);
-
-  try {
-    if (typeof ref == 'function') {
-      const hasRefUnmount = typeof ref._unmount == 'function';
-      if (hasRefUnmount) {
-        ref._unmount!();
-      }
-
-      if (!hasRefUnmount || newRef != null) {
-        // Store the cleanup function on the function
-        // instance object itself to avoid shape
-        // transitioning vnode
-        ref._unmount = ref(newRef!);
-      }
-    } else ref.current = newRef;
-    /* v8 ignore start */
-  } catch (e) {
-    lynx.reportError(e as Error);
-  }
-  /* v8 ignore stop */
-}
-
-function updateRef(
-  snapshot: SnapshotInstance,
-  expIndex: number,
-  oldValue: string | null,
-  elementIndex: number,
-): void {
-  const value: unknown = snapshot.__values![expIndex];
-  let ref;
-  if (typeof value === 'string') {
-    ref = value;
-  } else {
-    ref = `react-ref-${snapshot.__id}-${expIndex}`;
-  }
-
-  snapshot.__values![expIndex] = ref;
-  if (snapshot.__elements && oldValue !== ref) {
-    if (oldValue) {
-      __SetAttribute(snapshot.__elements[elementIndex]!, oldValue, undefined);
-    }
-    if (ref) {
-      __SetAttribute(snapshot.__elements[elementIndex]!, ref, 1);
-    }
-  }
-}
-
-function transformRef(ref: unknown): Ref | null | undefined {
-  if (ref === undefined || ref === null) {
-    return ref;
-  }
-  if (typeof ref === 'function' || (typeof ref === 'object' && 'current' in ref)) {
-    if ('__ref' in ref) {
-      return ref as Ref;
-    }
-    return Object.defineProperty(ref, '__ref', { value: 1 }) as Ref;
-  }
-  throw new Error(
-    `Elements' "ref" property should be a function, or an object created `
-      + `by createRef(), but got [${typeof ref}] instead`,
-  );
-}
-
-function applyQueuedRefs(): void {
-  try {
-    for (const ref of refsToClear) {
-      applyRef(ref, null);
-    }
-    for (let i = 0; i < refsToApply.length; i += 2) {
-      const ref = refsToApply[i] as Ref;
-      const value = refsToApply[i + 1] as [snapshotInstanceId: number, expIndex: number] | null;
-      applyRef(ref, value);
-    }
-  } finally {
-    clearQueuedRefs();
-  }
-}
-
-function queueRefAttrUpdate(
-  oldRef: Ref | null | undefined,
-  newRef: Ref | null | undefined,
-  snapshotInstanceId: number,
-  expIndex: number,
-): void {
-  if (oldRef === newRef) {
-    return;
-  }
-  if (oldRef) {
-    refsToClear.push(oldRef);
-  }
-  if (newRef) {
-    refsToApply.push(newRef, [snapshotInstanceId, expIndex]);
-  }
-}
-
-function clearQueuedRefs(): void {
-  refsToClear.length = 0;
-  refsToApply.length = 0;
-}
-
-/**
- * @internal
- */
-export { queueRefAttrUpdate, updateRef, unref, transformRef, applyRef, applyQueuedRefs, clearQueuedRefs, type Ref };