@3dsource/angular-unreal-module 0.0.173 → 0.0.175

package/README.md

@@ -377,12 +377,26 @@ The package publishes two dependency-free scripts for use in the document
 ></script>
 ```
 
-`stream-prefetch.js` runs by default only on
-`metabox-configurator/{modular|basic}/...` routes. It reads the same-origin
-`assets/config.json`; override that path with `data-config-url` when needed.
-It also forwards the orchestration-issued `streamRequestId` from the polling
-response to Cirrus on the WebSocket URL (the session `connectionId`) and parks it
-for the Angular side to adopt.
+`stream-prefetch.js` runs only on `metabox-configurator/modular/{configuratorId}`
+routes — the configurator id comes from the route and there is no attribute to
+supply one, so the script cannot be enabled for an arbitrary page.
+
+It reads the same-origin `assets/config.json` and `assets/features.json`, then
+the configurator's cached record from `{cdn}/cache/configurator/{id}.json` — the
+same document the host app reads — so it polls under the identity the app will
+use rather than inventing one. The `newOrchestration` feature flag picks the
+transport: `signalling` (HTTP polling) or `newSignalling` (control socket +
+`requestStream`). The orchestration-issued `streamRequestId` is forwarded to
+Cirrus on the WebSocket URL (the session `connectionId`) and parked for adoption.
+
+`window.__stream` is both the parked stream and the lock: whichever of the script
+and the Angular module writes it first owns the connection, so a page never
+builds two. Load the script and the package from the same version — an older
+script does not know about the lock.
+
+Optional `data-*`: `data-config-url`, `data-features-url`, `data-ws-timeout`,
+`data-poll-timeout`.
+
 Pin an exact package version in production when deterministic CDN assets are
 required.
 
@@ -418,4 +432,4 @@ pnpm unreal:purge-cdn -- latest
 pnpm unreal:purge-cdn -- dev
 ```
 
-Repository tooling requires Node.js 24.16.0 or newer and pnpm 11.21.0.
+Repository tooling requires Node.js 24.16.0 or newer and pnpm 11.22.0.