Skip to content

Commit 6ed7e5e

Browse files
docs(lynx): describe paired native container
1 parent 9d76f69 commit 6ed7e5e

1 file changed

Lines changed: 9 additions & 6 deletions

File tree

packages/lynx/README.md

Lines changed: 9 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -139,9 +139,11 @@ pluginLynxModuleFederation(federationOptions, {
139139
shared fallback in the entry bundle. Keep all emitted lazy `.bundle` files
140140
beside the remote entry (or under its manifest `publicPath`) when publishing.
141141
Each ReactLynx exposure needs its own paired background/main-thread lazy root.
142-
Split native bundles encode both programs into one DynamicComponent artifact;
143-
Web remotes use the equivalent paired external bundle. Web remotes reject
144-
`single`, and native `single` is limited to background-only non-UI modules.
142+
Split native remote entries embed background and main-thread container sections,
143+
and each lazy bundle encodes both component programs into one DynamicComponent
144+
artifact. Web remotes use the equivalent paired external bundle. Web remotes
145+
reject `single`, and native `single` is limited to background-only non-UI
146+
modules.
145147

146148
`publicPath: 'auto'` is supported and recommended for colocated Web split
147149
assets. Module Federation still resolves the public remote entry through
@@ -220,9 +222,10 @@ flowchart TB
220222
```
221223

222224
The enhanced federation runtime itself executes in the native background
223-
realm. Native split UI bundles still include their paired TASM/MTS main-thread
224-
snapshot program; this is compiled component output, not a second runtime or a
225-
second remote container. JavaScript object identity remains realm-local.
225+
realm. A native split remote also embeds a paired main-thread container runtime
226+
section so fetched TASM/MTS snapshot chunks install into that realm's registry.
227+
Both sections ship in the same external `.lynx.bundle`; there is no second
228+
network-deployed remote entry. JavaScript object identity remains realm-local.
226229

227230
See `apps/lynx-module-federation-demo` for an official Rspeedy native app,
228231
native artifact checks, and a real Lynx for Web browser E2E.

0 commit comments

Comments
 (0)