@lynx-js/react 0.105.0

package/runtime/lib/lynx-api.d.ts

@@ -0,0 +1,311 @@
+import type { Consumer, FC, ReactNode } from 'react';
+import { withInitDataInState } from './compat/initData.js';
+/**
+ * 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/>);
+     * ```
+     *
+     * @example
+     *
+     * ```tsx
+     * import { root } from "@lynx-js/react"
+     *
+     * function App() {
+     *   // Your app
+     *   return <view>...</view>
+     * }
+     *
+     * if (__LEPUS__) {
+     *   root.render(
+     *     <DataProvider data={DEFAULT_DATA}>
+     *        <App/>
+     *     </DataProvider>
+     *   );
+     * } else if (__JS__) {
+     *   fetchData().then((data) => {
+     *     root.render(
+     *       <DataProvider data={data}>
+     *          <App/>
+     *       </DataProvider>
+     *     ); // You can render later after your data is ready
+     *   })
+     * }
+     * ```
+     *
+     * @public
+     */
+    render: (jsx: ReactNode) => void;
+    /**
+     * {@inheritDoc Lynx.registerDataProcessors}
+     * @deprecated use {@link Lynx.registerDataProcessors | lynx.registerDataProcessors} instead
+     * @public
+     */
+    registerDataProcessors: (dataProcessorDefinition: DataProcessorDefinition) => 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;
+/**
+ * The {@link https://react.dev/reference/react/createContext#provider | Provider} Component that provide `initData`,
+ * you must wrap your JSX inside it
+ * @group Components
+ *
+ * @example
+ *
+ * ```ts
+ * import { root } from "@lynx-js/react"
+ *
+ * function App() {
+ *   return (
+ *     <InitDataConsumer children={(initData) => <view>...</view>}/>
+ *   )
+ * }
+ *
+ * root.render(
+ *   <InitDataProvider>
+ *      <App/>
+ *   </InitDataProvider>
+ * );
+ *
+ * ```
+ *
+ * @public
+ */
+export declare const InitDataProvider: FC<{
+    children?: ReactNode | undefined;
+}>;
+/**
+ * The {@link https://react.dev/reference/react/createContext#consumer | Consumer} Component that provide `initData`.
+ * This should be used with {@link InitDataProvider}
+ * @group Components
+ * @public
+ */
+export declare const InitDataConsumer: Consumer<InitData>;
+/**
+ * A React Hooks for you to get `initData`.
+ * If `initData` is changed, a re-render will be triggered automatically.
+ *
+ * @example
+ *
+ * ```ts
+ * function App() {
+ *   const initData = useInitData();
+ *
+ *   initData.someProperty // use it
+ * }
+ * ```
+ *
+ * @public
+ */
+export declare const useInitData: () => InitData;
+/**
+ * A React Hooks for you to get notified when `initData` changed.
+ *
+ * @example
+ * ```ts
+ * function App() {
+ *   useInitDataChanged((data) => {
+ *     data.someProperty // can use it
+ *   })
+ * }
+ * ```
+ * @public
+ */
+export declare const useInitDataChanged: (callback: (data: InitData) => void) => void;
+/**
+ * The interface you can extends so that the `defaultDataProcessor` parameter can be customized
+ *
+ * Should be used with `lynx.registerDataProcessors`. See more examples at {@link Lynx.registerDataProcessors}.
+ *
+ * @public
+ */
+export interface InitDataRaw {
+}
+/**
+ * The interface you can extends so that the `defaultDataProcessor` returning value can be customized
+ *
+ * Should be used with `lynx.registerDataProcessors`. See more examples at {@link Lynx.registerDataProcessors}.
+ *
+ * @public
+ */
+export interface InitData {
+}
+export { withInitDataInState };
+/**
+ * Definition of DataProcessor(s)
+ * @public
+ */
+export interface DataProcessorDefinition {
+    /**
+     * You can custom input and output type of `defaultDataProcessor` by extends {@link InitDataRaw} and {@link InitData}
+     *
+     * Should be used with `lynx.registerDataProcessors`. See more examples at {@link Lynx.registerDataProcessors}.
+     *
+     * @param rawInitData - initData passed from native code
+     * @returns
+     * @public
+     */
+    defaultDataProcessor?: (rawInitData: InitDataRaw) => InitData;
+    /**
+     * Should be used with `lynx.registerDataProcessors`. See more examples at {@link Lynx.registerDataProcessors}.
+     *
+     * @public
+     */
+    dataProcessors?: Record<string, Function>;
+}
+/**
+ * APIs under `lynx` global variable that added by ReactLynx.
+ *
+ * @example
+ *
+ * ```ts
+ * lynx.registerDataProcessors(...);
+ * lynx.querySelector(...);
+ * lynx.querySelectorAll(...);
+ * ```
+ *
+ * @public
+ */
+export interface Lynx {
+    /**
+     * An alias of `lynx.getJSModule("GlobalEventEmitter").trigger(eventName, params)` only in Lepus
+     *
+     * @public
+     */
+    triggerGlobalEventFromLepus: (eventName: string, params: any) => void;
+    /**
+     * Register DataProcessors. You MUST call this before `root.render()`.
+     *
+     * @example
+     *
+     * You MUST call `lynx.registerDataProcessors` before calling `root.render()`.
+     *
+     * ```ts
+     * import { root } from "@lynx-js/react"
+     *
+     * // You MUST call this before `root.render()`
+     * lynx.registerDataProcessors({
+     *   defaultDataProcessor: () => {...} // default DataProcessor
+     *   dataProcessors: {
+     *     getScreenMetricsOverride: () => {...} // named DataProcessor
+     *   }
+     * })
+     *
+     * root.render(<App/>);
+     * ```
+     *
+     * @example
+     *
+     * If you have a class component with `static defaultDataProcessor`
+     * or `static dataProcessors`, you can use it to register DataProcessors.
+     *
+     * ```ts
+     * import { root, Component } from "@lynx-js/react"
+     *
+     * class App extends Component {
+     *   static defaultDataProcessor() {
+     *      ...
+     *   }
+     *
+     *   static dataProcessors = {
+     *     getScreenMetricsOverride() {
+     *       ...
+     *     }
+     *   }
+     * }
+     *
+     * lynx.registerDataProcessors(App); // You can pass `App` because it has the required shape
+     * root.render(<App/>);
+     * ```
+     *
+     * @example
+     *
+     * For developers who want fully typed `defaultDataProcessor`,
+     * they can achieve it by extends interface `InitDataRaw` and `InitData`.
+     *
+     * ```ts
+     * import { root } from "@lynx-js/react"
+     *
+     * interface ExistingInterface {
+     *   somePropertyFromExistingInterface: number
+     * }
+     *
+     * declare module '@lynx-js/react' {
+     *   interface InitDataRaw extends ExistingInterface {
+     *     someAnotherCustomProperty: string
+     *   }
+     * }
+     *
+     * lynx.registerDataProcessors({
+     *   defaultDataProcessor: (initDataRaw) => {
+     *     initDataRaw.somePropertyFromExistingInterface // will be typed
+     *   }
+     * })
+     *
+     * ```
+     *
+     * @example
+     *
+     * For developers who want fully typed `defaultDataProcessor`,
+     * they can achieve it by extends interface `InitDataRaw` and `InitData`.
+     *
+     * ```ts
+     * import { root, useInitData } from "@lynx-js/react"
+     *
+     * interface AnotherExistingInterface {
+     *   someAnotherPropertyFromExistingInterface: number
+     * }
+     *
+     * declare module '@lynx-js/react' {
+     *   interface InitData extends AnotherExistingInterface {
+     *     someCustomProperty: string
+     *   }
+     * }
+     *
+     * root.registerDataProcessors({
+     *   defaultDataProcessor: () => {
+     *     return {
+     *       someCustomProperty: 'value', // will be typed
+     *       someAnotherPropertyFromExistingInterface: 1, // will be typed
+     *     }
+     *   }
+     * })
+     *
+     * function App() {
+     *   const initData = useInitData();
+     *
+     *   initData.someCustomProperty // will be typed
+     *   initData.someAnotherPropertyFromExistingInterface // will be typed
+     * }
+     *
+     * ```
+     * @public
+     */
+    registerDataProcessors: (dataProcessorDefinition: DataProcessorDefinition) => void;
+}
+export { runOnBackground, runOnMainThread } from './worklet/runWorklet.js';
+export { MainThreadRef, useMainThreadRef } from './worklet/workletRef.js';
+export { useLynxGlobalEventListener } from './hooks/useLynxGlobalEventListener.js';

package/runtime/lib/lynx-api.js

@@ -0,0 +1,116 @@
+// 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 { render } from 'preact';
+import { createContext, createElement } from 'preact/compat';
+import { useState } from 'preact/hooks';
+import { factory, withInitDataInState } from './compat/initData.js';
+import { LifecycleConstant } from './lifecycleConstant.js';
+import { flushDelayedLifecycleEvents } from './lynx/tt.js';
+import { useLynxGlobalEventListener } from './hooks/useLynxGlobalEventListener.js';
+import { __root } from './root.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) => {
+        if (__LEPUS__) {
+            __root.__jsx = jsx;
+        }
+        else {
+            __root.__jsx = jsx;
+            render(jsx, __root);
+            if (__FIRST_SCREEN_SYNC_TIMING__ === 'immediately') {
+            }
+            else {
+                lynx.getNativeApp().callLepusMethod(LifecycleConstant.jsReady, {});
+            }
+            flushDelayedLifecycleEvents();
+        }
+    },
+    registerDataProcessors: (dataProcessorDefinition) => {
+        lynx.registerDataProcessors(dataProcessorDefinition);
+    },
+};
+const _InitData = /* @__PURE__ */ factory({
+    createContext,
+    useState,
+    createElement,
+    useLynxGlobalEventListener,
+}, '__initData', 'onDataChanged');
+/**
+ * The {@link https://react.dev/reference/react/createContext#provider | Provider} Component that provide `initData`,
+ * you must wrap your JSX inside it
+ * @group Components
+ *
+ * @example
+ *
+ * ```ts
+ * import { root } from "@lynx-js/react"
+ *
+ * function App() {
+ *   return (
+ *     <InitDataConsumer children={(initData) => <view>...</view>}/>
+ *   )
+ * }
+ *
+ * root.render(
+ *   <InitDataProvider>
+ *      <App/>
+ *   </InitDataProvider>
+ * );
+ *
+ * ```
+ *
+ * @public
+ */
+export const InitDataProvider = /* @__PURE__ */ _InitData.Provider();
+/**
+ * The {@link https://react.dev/reference/react/createContext#consumer | Consumer} Component that provide `initData`.
+ * This should be used with {@link InitDataProvider}
+ * @group Components
+ * @public
+ */
+export const InitDataConsumer = /* @__PURE__ */ _InitData.Consumer();
+/**
+ * A React Hooks for you to get `initData`.
+ * If `initData` is changed, a re-render will be triggered automatically.
+ *
+ * @example
+ *
+ * ```ts
+ * function App() {
+ *   const initData = useInitData();
+ *
+ *   initData.someProperty // use it
+ * }
+ * ```
+ *
+ * @public
+ */
+export const useInitData = /* @__PURE__ */ _InitData.use();
+/**
+ * A React Hooks for you to get notified when `initData` changed.
+ *
+ * @example
+ * ```ts
+ * function App() {
+ *   useInitDataChanged((data) => {
+ *     data.someProperty // can use it
+ *   })
+ * }
+ * ```
+ * @public
+ */
+export const useInitDataChanged = /* @__PURE__ */ _InitData.useChanged();
+export { withInitDataInState };
+export { runOnBackground, runOnMainThread } from './worklet/runWorklet.js';
+export { MainThreadRef, useMainThreadRef } from './worklet/workletRef.js';
+export { useLynxGlobalEventListener } from './hooks/useLynxGlobalEventListener.js';
+//# sourceMappingURL=lynx-api.js.map

package/runtime/lib/lynx-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lynx-api.js","sourceRoot":"","sources":["../src/lynx-api.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,yEAAyE;AACzE,0DAA0D;AAC1D,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC7D,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAGxC,OAAO,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,2BAA2B,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,EAAE,0BAA0B,EAAE,MAAM,uCAAuC,CAAC;AACnF,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AA6DnC;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,IAAI,GAAS;IACxB,MAAM,EAAE,CAAC,GAAc,EAAQ,EAAE;QAC/B,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,CAAC,KAAK,GAAG,GAAG,CAAC;QACrB,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,KAAK,GAAG,GAAG,CAAC;YACnB,MAAM,CAAC,GAAG,EAAE,MAAa,CAAC,CAAC;YAC3B,IAAI,4BAA4B,KAAK,aAAa,EAAE,CAAC;YACrD,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,YAAY,EAAE,CAAC,eAAe,CAAC,iBAAiB,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YACrE,CAAC;YAED,2BAA2B,EAAE,CAAC;QAChC,CAAC;IACH,CAAC;IACD,sBAAsB,EAAE,CAAC,uBAAgD,EAAQ,EAAE;QACjF,IAAI,CAAC,sBAAsB,CAAC,uBAAuB,CAAC,CAAC;IACvD,CAAC;CACF,CAAC;AAEF,MAAM,SAAS,GAAG,eAAe,CAAC,OAAO,CACvC;IACE,aAAa;IACb,QAAQ;IACR,aAAa;IACb,0BAA0B;CACpB,EACR,YAAY,EACZ,eAAe,CAChB,CAAC;AACF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAA6C,eAAe,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAC;AAC/G;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAuB,eAAe,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAC;AACzF;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,WAAW,GAAmB,eAAe,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC;AAC3E;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAiD,eAAe,CAAC,SAAS,CAAC,UAAU,EAAE,CAAC;AAsCvH,OAAO,EAAE,mBAAmB,EAAE,CAAC;AA6J/B,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC1E,OAAO,EAAE,0BAA0B,EAAE,MAAM,uCAAuC,CAAC"}

package/runtime/lib/lynx.d.ts

@@ -0,0 +1,2 @@
+import './hooks/react.js';
+export declare function runWithForce(cb: () => void): void;

package/runtime/lib/lynx.js

@@ -0,0 +1,91 @@
+// 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 { options } from 'preact';
+// to make sure preact's hooks to register earlier than ours
+import './hooks/react.js';
+import { initProfileHook } from './debug/profile.js';
+import { document, setupBackgroundDocument } from './document.js';
+import { initDelayUnmount } from './lifecycle/delayUnmount.js';
+import { injectUpdatePatch, replaceCommitHook, replaceRequestAnimationFrame } from './lifecycle/patchUpdate.js';
+import { injectCalledByNative } from './lynx/calledByNative.js';
+import { setupLynxEnv } from './lynx/env.js';
+import { injectLepusMethods } from './lynx/injectLepusMethods.js';
+import { initTimingAPI } from './lynx/performance.js';
+import { injectTt } from './lynx/tt.js';
+import { COMPONENT, DIFF, DIFFED, FORCE } from './renderToOpcodes/constants.js';
+// @ts-expect-error Element implicitly has an 'any' type because type 'typeof globalThis' has no index signature
+if (__LEPUS__ && typeof globalThis.processEvalResult === 'undefined') {
+    // @ts-expect-error Element implicitly has an 'any' type because type 'typeof globalThis' has no index signature
+    globalThis.processEvalResult = (result, schema) => {
+        return result(schema);
+    };
+}
+export function runWithForce(cb) {
+    // save vnode and its `_component` in WeakMap
+    const m = new WeakMap();
+    const oldDiff = options[DIFF];
+    options[DIFF] = (vnode) => {
+        if (oldDiff) {
+            oldDiff(vnode);
+        }
+        // when `options[DIFF]` is called, a newVnode is passed in
+        // so its `vnode[COMPONENT]` should be null,
+        // but it will be set later
+        Object.defineProperty(vnode, COMPONENT, {
+            configurable: true,
+            set(c) {
+                m.set(vnode, c);
+                if (c) {
+                    c[FORCE] = true;
+                }
+            },
+            get() {
+                return m.get(vnode);
+            },
+        });
+    };
+    const oldDiffed = options[DIFFED];
+    options[DIFFED] = (vnode) => {
+        if (oldDiffed) {
+            oldDiffed(vnode);
+        }
+        // delete is a reverse operation of previous `Object.defineProperty`
+        delete vnode[COMPONENT];
+        // restore
+        vnode[COMPONENT] = m.get(vnode);
+    };
+    try {
+        cb();
+    }
+    finally {
+        options[DIFF] = oldDiff;
+        options[DIFFED] = oldDiffed;
+    }
+}
+if (__LEPUS__) {
+    injectCalledByNative();
+    injectUpdatePatch();
+    if (__DEV__) {
+        injectLepusMethods();
+    }
+}
+// TODO: replace this with __PROFILE__
+if (__PROFILE__) {
+    // We are profiling both main-thread and background.
+    initProfileHook();
+}
+if (__JS__) {
+    options.document = document;
+    setupBackgroundDocument();
+    injectTt();
+    if (process.env['NODE_ENV'] === 'test') { }
+    else {
+        replaceCommitHook();
+        replaceRequestAnimationFrame();
+        initTimingAPI();
+        initDelayUnmount();
+    }
+}
+setupLynxEnv();
+//# sourceMappingURL=lynx.js.map

package/runtime/lib/lynx.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lynx.js","sourceRoot":"","sources":["../src/lynx.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,yEAAyE;AACzE,0DAA0D;AAC1D,OAAO,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAEjC,4DAA4D;AAC5D,OAAO,kBAAkB,CAAC;AAE1B,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,4BAA4B,EAAE,MAAM,4BAA4B,CAAC;AAChH,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,gCAAgC,CAAC;AAEhF,gHAAgH;AAChH,IAAI,SAAS,IAAI,OAAO,UAAU,CAAC,iBAAiB,KAAK,WAAW,EAAE,CAAC;IACrE,gHAAgH;IAChH,UAAU,CAAC,iBAAiB,GAAG,CAAI,MAA6B,EAAE,MAAc,EAAE,EAAE;QAClF,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC;IACxB,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,EAAc;IACzC,6CAA6C;IAC7C,MAAM,CAAC,GAAG,IAAI,OAAO,EAAc,CAAC;IAEpC,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9B,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,KAAY,EAAE,EAAE;QAC/B,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,CAAC,KAAK,CAAC,CAAC;QACjB,CAAC;QAED,0DAA0D;QAC1D,4CAA4C;QAC5C,2BAA2B;QAC3B,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,SAAS,EAAE;YACtC,YAAY,EAAE,IAAI;YAClB,GAAG,CAAC,CAAC;gBACH,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;gBAChB,IAAI,CAAC,EAAE,CAAC;oBACN,CAAC,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;gBAClB,CAAC;YACH,CAAC;YACD,GAAG;gBACD,OAAO,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YACtB,CAAC;SACF,CAAC,CAAC;IACL,CAAC,CAAC;IAEF,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAElC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,KAAY,EAAE,EAAE;QACjC,IAAI,SAAS,EAAE,CAAC;YACd,SAAS,CAAC,KAAK,CAAC,CAAC;QACnB,CAAC;QAED,oEAAoE;QACpE,OAAO,KAAK,CAAC,SAAS,CAAC,CAAC;QACxB,UAAU;QACV,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC,CAAC;IAEF,IAAI,CAAC;QACH,EAAE,EAAE,CAAC;IACP,CAAC;YAAS,CAAC;QACT,OAAO,CAAC,IAAI,CAAC,GAAG,OAAiC,CAAC;QAClD,OAAO,CAAC,MAAM,CAAC,GAAG,SAAmC,CAAC;IACxD,CAAC;AACH,CAAC;AAED,IAAI,SAAS,EAAE,CAAC;IACd,oBAAoB,EAAE,CAAC;IACvB,iBAAiB,EAAE,CAAC;IACpB,IAAI,OAAO,EAAE,CAAC;QACZ,kBAAkB,EAAE,CAAC;IACvB,CAAC;AACH,CAAC;AAED,sCAAsC;AACtC,IAAI,WAAW,EAAE,CAAC;IAChB,oDAAoD;IACpD,eAAe,EAAE,CAAC;AACpB,CAAC;AAED,IAAI,MAAM,EAAE,CAAC;IACX,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC5B,uBAAuB,EAAE,CAAC;IAC1B,QAAQ,EAAE,CAAC;IAEX,IAAI,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,MAAM,EAAE,CAAC,CAAA,CAAC;SACrC,CAAC;QACJ,iBAAiB,EAAE,CAAC;QACpB,4BAA4B,EAAE,CAAC;QAC/B,aAAa,EAAE,CAAC;QAChB,gBAAgB,EAAE,CAAC;IACrB,CAAC;AACH,CAAC;AAED,YAAY,EAAE,CAAC"}

package/runtime/lib/opcodes.d.ts

@@ -0,0 +1,2 @@
+import { SnapshotInstance } from './snapshot.js';
+export declare function renderOpcodesInto(opcodes: any[], into: SnapshotInstance): void;

package/runtime/lib/opcodes.js

@@ -0,0 +1,59 @@
+// 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 { CHILDREN } from './renderToOpcodes/constants.js';
+import { SnapshotInstance } from './snapshot.js';
+var Opcode;
+(function (Opcode) {
+    Opcode[Opcode["Begin"] = 0] = "Begin";
+    Opcode[Opcode["End"] = 1] = "End";
+    Opcode[Opcode["Attr"] = 2] = "Attr";
+    Opcode[Opcode["Text"] = 3] = "Text";
+})(Opcode || (Opcode = {}));
+export function renderOpcodesInto(opcodes, into) {
+    let top = into;
+    const stack = [into];
+    for (let i = 0; i < opcodes.length;) {
+        const opcode = opcodes[i];
+        switch (opcode) {
+            case Opcode.Begin: {
+                const p = top;
+                top = opcodes[i + 1];
+                // @ts-ignore
+                if (top.__parent) {
+                    // already inserted
+                    top = new SnapshotInstance(top.type);
+                }
+                p.insertBefore(top);
+                stack.push(top);
+                i += 2;
+                break;
+            }
+            case Opcode.End: {
+                // @ts-ignore
+                top[CHILDREN] = undefined;
+                stack.pop();
+                const p = stack[stack.length - 1];
+                top = p;
+                i += 1;
+                break;
+            }
+            case Opcode.Attr: {
+                const key = opcodes[i + 1];
+                const value = opcodes[i + 2];
+                top.setAttribute(key, value);
+                i += 3;
+                break;
+            }
+            case Opcode.Text: {
+                const text = opcodes[i + 1];
+                const s = new SnapshotInstance(null);
+                s.setAttribute(0, text);
+                top.insertBefore(s);
+                i += 2;
+                break;
+            }
+        }
+    }
+}
+//# sourceMappingURL=opcodes.js.map

package/runtime/lib/opcodes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"opcodes.js","sourceRoot":"","sources":["../src/opcodes.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,yEAAyE;AACzE,0DAA0D;AAC1D,OAAO,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEjD,IAAW,MAKV;AALD,WAAW,MAAM;IACf,qCAAS,CAAA;IACT,iCAAG,CAAA;IACH,mCAAI,CAAA;IACJ,mCAAI,CAAA;AACN,CAAC,EALU,MAAM,KAAN,MAAM,QAKhB;AAED,MAAM,UAAU,iBAAiB,CAAC,OAAc,EAAE,IAAsB;IACtE,IAAI,GAAG,GAAqB,IAAI,CAAC;IACjC,MAAM,KAAK,GAAuB,CAAC,IAAI,CAAC,CAAC;IACzC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC;QACpC,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QAC1B,QAAQ,MAAM,EAAE,CAAC;YACf,KAAK,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;gBAClB,MAAM,CAAC,GAAG,GAAG,CAAC;gBACd,GAAG,GAAG,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;gBACrB,aAAa;gBACb,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC;oBACjB,mBAAmB;oBACnB,GAAG,GAAG,IAAI,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBACvC,CAAC;gBACD,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;gBACpB,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBAEhB,CAAC,IAAI,CAAC,CAAC;gBACP,MAAM;YACR,CAAC;YACD,KAAK,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;gBAChB,aAAa;gBACb,GAAG,CAAC,QAAQ,CAAC,GAAG,SAAS,CAAC;gBAE1B,KAAK,CAAC,GAAG,EAAE,CAAC;gBACZ,MAAM,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;gBAClC,GAAG,GAAG,CAAE,CAAC;gBAET,CAAC,IAAI,CAAC,CAAC;gBACP,MAAM;YACR,CAAC;YACD,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;gBACjB,MAAM,GAAG,GAAG,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;gBAC3B,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;gBAC7B,GAAG,CAAC,YAAY,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;gBAE7B,CAAC,IAAI,CAAC,CAAC;gBACP,MAAM;YACR,CAAC;YACD,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;gBACjB,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;gBAC5B,MAAM,CAAC,GAAG,IAAI,gBAAgB,CAAC,IAAyB,CAAC,CAAC;gBAC1D,CAAC,CAAC,YAAY,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;gBACxB,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;gBAEpB,CAAC,IAAI,CAAC,CAAC;gBACP,MAAM;YACR,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC"}

package/runtime/lib/renderToOpcodes/constants.d.ts

@@ -0,0 +1,17 @@
+export declare const DIFF = "__b";
+export declare const RENDER = "__r";
+export declare const DIFFED = "diffed";
+export declare const COMMIT = "__c";
+export declare const SKIP_EFFECTS = "__s";
+export declare const CATCH_ERROR = "__e";
+export declare const COMPONENT = "__c";
+export declare const CHILDREN = "__k";
+export declare const PARENT = "__";
+export declare const MASK = "__m";
+export declare const VNODE = "__v";
+export declare const DIRTY = "__d";
+export declare const FORCE = "__e";
+export declare const NEXT_STATE = "__s";
+export declare const CHILD_DID_SUSPEND = "__c";
+export declare const RENDER_CALLBACKS = "__h";
+export declare const HOOK = "__h";

package/runtime/lib/renderToOpcodes/constants.js

@@ -0,0 +1,23 @@
+// 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 DIFF = '__b';
+export const RENDER = '__r';
+export const DIFFED = 'diffed';
+export const COMMIT = '__c';
+export const SKIP_EFFECTS = '__s';
+export const CATCH_ERROR = '__e';
+// VNode properties
+export const COMPONENT = '__c';
+export const CHILDREN = '__k';
+export const PARENT = '__';
+export const MASK = '__m';
+// Component properties
+export const VNODE = '__v';
+export const DIRTY = '__d';
+export const FORCE = '__e';
+export const NEXT_STATE = '__s';
+export const CHILD_DID_SUSPEND = '__c';
+export const RENDER_CALLBACKS = '__h';
+export const HOOK = '__h';
+//# sourceMappingURL=constants.js.map

package/runtime/lib/renderToOpcodes/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/renderToOpcodes/constants.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,yEAAyE;AACzE,0DAA0D;AAC1D,MAAM,CAAC,MAAM,IAAI,GAAG,KAAK,CAAC;AAC1B,MAAM,CAAC,MAAM,MAAM,GAAG,KAAK,CAAC;AAC5B,MAAM,CAAC,MAAM,MAAM,GAAG,QAAQ,CAAC;AAC/B,MAAM,CAAC,MAAM,MAAM,GAAG,KAAK,CAAC;AAC5B,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,CAAC;AAClC,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,CAAC;AAEjC,mBAAmB;AACnB,MAAM,CAAC,MAAM,SAAS,GAAG,KAAK,CAAC;AAC/B,MAAM,CAAC,MAAM,QAAQ,GAAG,KAAK,CAAC;AAC9B,MAAM,CAAC,MAAM,MAAM,GAAG,IAAI,CAAC;AAC3B,MAAM,CAAC,MAAM,IAAI,GAAG,KAAK,CAAC;AAE1B,uBAAuB;AACvB,MAAM,CAAC,MAAM,KAAK,GAAG,KAAK,CAAC;AAC3B,MAAM,CAAC,MAAM,KAAK,GAAG,KAAK,CAAC;AAC3B,MAAM,CAAC,MAAM,KAAK,GAAG,KAAK,CAAC;AAC3B,MAAM,CAAC,MAAM,UAAU,GAAG,KAAK,CAAC;AAChC,MAAM,CAAC,MAAM,iBAAiB,GAAG,KAAK,CAAC;AACvC,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,CAAC;AACtC,MAAM,CAAC,MAAM,IAAI,GAAG,KAAK,CAAC"}

package/runtime/lib/renderToOpcodes/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 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 default renderToString;
+export declare const render: typeof renderToString;
+export declare const renderToStaticMarkup: typeof renderToString;