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/rspeedy/external-bundle-rsbuild-plugin.reactlynxexternalspresetoptions.md.
Rspeedy logo
Rspeedy
  • English
  • Home > @lynx-js/external-bundle-rsbuild-plugin > ReactLynxExternalsPresetOptions

    ReactLynxExternalsPresetOptions interface

    Options for the built-in reactlynx externals preset.

    Signature:

    export interface ReactLynxExternalsPresetOptions 

    Properties

    Property

    Modifiers

    Type

    Description

    async?

    boolean

    (Optional) 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). Enabling this also resolves the web-encoded @lynx-js/react-umd/{dev,prod}-web bundle and defaults bundlePath to react.web.bundle.

    bundlePath?

    string

    (Optional) 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.

    reactUmdPackageName?

    string

    (Optional) Package name that provides the ReactLynx runtime bundle.

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

    url?

    string

    (Optional) 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.

    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.