For AI agents: the complete documentation index is available at /next/llms.txt, the full documentation bundle is available at /next/llms-full.txt, and this page is available as Markdown at /next/api/packages/external-bundle-rsbuild-plugin/interfaces/ReactLynxExternalsPresetOptions.md.
Lynx
  • English
  • Interface: ReactLynxExternalsPresetOptions

    Options for the built-in reactlynx externals preset.

    Properties

    async?

    optional async?: boolean

    Load the ReactLynx runtime bundle asynchronously, for the web target.

    The web runtime (@lynx-js/web-core) can only fetch external bundles asynchronously (fetchBundle().then), so ReactLynx must be mounted as a promise that consuming modules await before reading a subpath (otherwise React.memo etc. are read off a pending promise and are undefined). Only controls how the runtime is mounted; the web bundle is chosen for environments other than lynx / lynx-*.

    Default Value

    false


    bundlePath?

    optional bundlePath?: string

    Emit the ReactLynx runtime bundle into the current build output and load it through the generated runtime public path.

    Prefer this over url for normal Rspeedy projects. In addition to letting the runtime resolve the final URL from publicPath, the plugin will also copy the corresponding @lynx-js/react-umd bundle into the emitted assets, so application bundles can reference it without requiring an extra manual copy step when publishing.

    Default Value

    'react.lynx.bundle', or 'react.web.bundle' outside lynx / lynx-* environments


    reactUmdPackageName?

    optional reactUmdPackageName?: string

    Package name that provides the ReactLynx runtime bundle.

    Override this when wrapping the plugin for another distribution, such as @byted-lynx/react-umd.

    Default Value

    '@lynx-js/react-umd'


    url?

    optional url?: string

    Override the runtime bundle URL directly.

    Use this only when the ReactLynx runtime is hosted outside the current build output, for example on a CDN. Unlike bundlePath, this does not emit any extra asset into the current compilation.

    Deprecated

    Prefer bundlePath, which resolves through the runtime public path and enables automatic asset emission.

    Except as otherwise noted, this work is licensed under a Creative Commons Attribution 4.0 International License, and code samples are licensed under the Apache License 2.0.