@mfeflow/rsbuild 0.2.0 → 0.3.0

package/dist/head-scripts.d.ts

@@ -0,0 +1,19 @@
+/** An Rsbuild html tag (`html.tags`) that puts an inline script first in `<head>`. */
+export interface HeadScriptTag {
+    tag: 'script';
+    children: string;
+    head: true;
+    append: false;
+}
+/**
+ * Asks the shell's `<head>` to run `source` before anything else: the first thing the page does, ahead of
+ * the app's bundles (a stored theme, for example, so a reload never paints the wrong colours first).
+ * Call it from a module that `rsbuild.config.ts` imports, before `createShellConfig` runs. Keyed by
+ * `name`, so a config that is loaded again (dev server restart) replaces its script instead of adding a
+ * second one. Only the shell uses it; remotes have no page of their own.
+ */
+export declare function registerHeadScript(name: string, source: string): void;
+/** The registered scripts as Rsbuild html tags, in the order they were first registered. */
+export declare function headScriptTags(): HeadScriptTag[];
+/** Only for tests. */
+export declare function resetHeadScriptsForTests(): void;

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 import type { RsbuildConfig } from '@rsbuild/core';
 import { type SharedConfig } from './shared.js';
 export { esmTwin, isMfCjs, pluginMfEsmRuntime } from './esm-runtime.js';
+export { headScriptTags, registerHeadScript } from './head-scripts.js';
 export { RUNTIME_CONFIG_URL, runtimeConfigEnv, runtimeConfigEnvs, runtimeConfigHandler, runtimeConfigSetup, } from './runtime-config.js';
 export { DEFAULT_SINGLETONS, installedVersionFrom, packageNameOf, resolvableFrom, sharedSingletons, type SharedConfig, } from './shared.js';
 export interface RemoteOptions {

package/dist/index.js

@@ -56,6 +56,20 @@ function pluginMfEsmRuntime() {
         }
     };
 }
+const scripts = new Map();
+function registerHeadScript(name, source) {
+    scripts.set(name, source);
+}
+function headScriptTags() {
+    return [
+        ...scripts.values()
+    ].map((children)=>({
+            tag: "script",
+            children,
+            head: true,
+            append: false
+        }));
+}
 const RUNTIME_CONFIG_URL = '/config/runtime-config.json';
 const ENV_NAME = /^[a-z0-9-]+$/;
 const ENV_FILE = /^runtime-config\.([a-z0-9-]+)\.json$/;
@@ -308,6 +322,7 @@ function createShellConfig(o) {
     const require = createRequire(node_path.join(cwd, 'package.json'));
     if (false === o.eager) assertAsyncBoundary(node_path.join(cwd, 'src/index.ts'));
     const setup = runtimeConfigSetup(cwd, o.env ?? process.env);
+    const headScripts = headScriptTags();
     return {
         plugins: [
             pluginReact(),
@@ -316,6 +331,11 @@ function createShellConfig(o) {
             ],
             pluginModuleFederation(shellFederationOptions(o, resolvableFrom(cwd), (s)=>require.resolve(s)))
         ],
+        ...0 === headScripts.length ? {} : {
+            html: {
+                tags: headScripts
+            }
+        },
         source: {
             entry: {
                 index: './src/index.ts'
@@ -336,4 +356,4 @@ function createShellConfig(o) {
         }
     };
 }
-export { DEFAULT_SINGLETONS, RUNTIME_CONFIG_URL, appVersion, assertAsyncBoundary, createRemoteConfig, createShellConfig, esmTwin, installedVersionFrom, isMfCjs, packageNameOf, pluginMfEsmRuntime, remoteFederationOptions, resolvableFrom, runtimeConfigEnv, runtimeConfigEnvs, runtimeConfigHandler, runtimeConfigSetup, sharedSingletons, shellFederationOptions, snapshotEnabled };
+export { DEFAULT_SINGLETONS, RUNTIME_CONFIG_URL, appVersion, assertAsyncBoundary, createRemoteConfig, createShellConfig, esmTwin, headScriptTags, installedVersionFrom, isMfCjs, packageNameOf, pluginMfEsmRuntime, registerHeadScript, remoteFederationOptions, resolvableFrom, runtimeConfigEnv, runtimeConfigEnvs, runtimeConfigHandler, runtimeConfigSetup, sharedSingletons, shellFederationOptions, snapshotEnabled };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mfeflow/rsbuild",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Rsbuild presets for Module Federation 2.0 micro-frontends: createShellConfig and createRemoteConfig with shared singletons, external runtime, manifests, types and error reporting set up.",
   "keywords": [
     "micro-frontend",