@octanejs/rsbuild-plugin 0.1.14 → 0.1.16

package/README.md

@@ -75,9 +75,22 @@ Options are declarative and cache-stable:
 
 - `hmr` controls browser component handoff;
 - `profile` enables component profiling in the browser environment;
+- `strong` overrides the app's `compiler.strong` setting;
 - `exclude` skips path fragments in the plain `.ts`/`.js` hook-slot pass; and
 - `clientEnvironment` / `serverEnvironment` rename the generated environments.
 
+Enable Strong mode for the whole app in `octane.config.ts`:
+
+```ts
+export default defineConfig({
+	compiler: { strong: true },
+});
+```
+
+You can also pass `pluginOctane({ strong: true })`. The plugin option takes
+priority over the app config. Dependencies are unaffected unless they begin a
+module with `"use strong"`.
+
 App mode currently serves from the root path and uses Rsbuild's default asset
 prefix. Keep `server.base` at `/` and `output.assetPrefix` at `auto` or `/`; for
 a subpath deployment, rewrite that prefix to the app root in the hosting proxy.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@octanejs/rsbuild-plugin",
-  "version": "0.1.14",
+  "version": "0.1.16",
   "license": "MIT",
   "type": "module",
   "engines": {
@@ -48,12 +48,12 @@
     }
   },
   "dependencies": {
-    "@octanejs/app-core": "0.0.15",
-    "@octanejs/rspack-plugin": "0.1.14"
+    "@octanejs/app-core": "0.0.17",
+    "@octanejs/rspack-plugin": "0.1.16"
   },
   "peerDependencies": {
     "@rsbuild/core": "^2.0.0",
-    "octane": "0.1.19"
+    "octane": "0.1.21"
   },
   "devDependencies": {
     "@rsbuild/core": "^2.1.6",
@@ -62,6 +62,6 @@
     "playwright": "^1.61.1",
     "type-fest": "^5.8.0",
     "vitest": "^4.1.10",
-    "octane": "0.1.19"
+    "octane": "0.1.21"
   }
 }

package/src/index.js

@@ -132,8 +132,11 @@ function hasRoutes(config) {
 	return (config?.router.routes.length ?? 0) > 0;
 }
 
-/** @param {import('@octanejs/app-core').ResolvedOctaneConfig} config */
-function configSignature(config) {
+/**
+ * @param {import('@octanejs/app-core').ResolvedOctaneConfig} config
+ * @param {boolean | undefined} strongOverride
+ */
+function configSignature(config, strongOverride) {
 	return JSON.stringify({
 		build: config.build,
 		routes: config.router.routes.map((route) =>
@@ -150,7 +153,10 @@ function configSignature(config) {
 		preHydrate: config.router.preHydrate,
 		rootBoundary: config.rootBoundary,
 		server: config.server,
-		compiler: { renderers: config.compiler.renderers.signature },
+		compiler: {
+			renderers: config.compiler.renderers.signature,
+			strong: strongOverride ?? config.compiler.strong,
+		},
 	});
 }
 
@@ -228,6 +234,7 @@ function assertRootPublicPaths(config, clientEnvironment) {
  * @param {{
  *   hmr?: boolean,
  *   profile?: boolean,
+ *   strong?: boolean,
  *   exclude?: string[],
  *   requireDirective?: boolean,
  *   clientEnvironment?: string,
@@ -236,6 +243,9 @@ function assertRootPublicPaths(config, clientEnvironment) {
  * @returns {import('@rsbuild/core').RsbuildPlugin}
  */
 export function pluginOctane(inlineOptions = {}) {
+	if (inlineOptions.strong !== undefined && typeof inlineOptions.strong !== 'boolean') {
+		throw new TypeError('[@octanejs/rsbuild-plugin] `strong` must be a boolean.');
+	}
 	return {
 		name: PLUGIN_NAME,
 		enforce: 'pre',
@@ -253,14 +263,19 @@ export function pluginOctane(inlineOptions = {}) {
 					})
 				: null;
 			const initialConfig = initialLoaded?.config ?? null;
+			const strong = inlineOptions.strong ?? initialConfig?.compiler.strong;
 			const appEnabled = hasRoutes(initialConfig);
 			const buildTargetPlan =
 				initialConfig?.build.target === undefined
 					? null
 					: createBuildTargetPlan(initialConfig.build.target);
-			const neutralCompiler = appEnabled ? createOctaneCompiler({ root }) : null;
+			const neutralCompiler = appEnabled
+				? createOctaneCompiler({ root, ...(strong === undefined ? null : { strong }) })
+				: null;
 			let currentConfig = initialConfig;
-			let lastConfigSignature = initialLoaded ? configSignature(initialLoaded.config) : '';
+			let lastConfigSignature = initialLoaded
+				? configSignature(initialLoaded.config, inlineOptions.strong)
+				: '';
 			let configNeedsReload = false;
 			/** @type {import('@rsbuild/core').RsbuildDevServer | null} */
 			let devServer = null;
@@ -307,7 +322,7 @@ export function pluginOctane(inlineOptions = {}) {
 					throw error;
 				}
 				registerConfigDependencies(context, loaded);
-				const signature = configSignature(loaded.config);
+				const signature = configSignature(loaded.config, inlineOptions.strong);
 				if (lastConfigSignature && signature !== lastConfigSignature) configNeedsReload = true;
 				lastConfigSignature = signature;
 				currentConfig = loaded.config;
@@ -531,6 +546,7 @@ export function pluginOctane(inlineOptions = {}) {
 						root,
 						environment,
 						transpile: false,
+						...(strong === undefined ? null : { strong }),
 						...(inlineOptions.hmr === undefined ? null : { hmr: inlineOptions.hmr }),
 						...(inlineOptions.profile === undefined
 							? null

package/types/index.d.ts

@@ -13,6 +13,11 @@ export interface OctaneRsbuildPluginOptions {
 	hmr?: boolean;
 	/** Enable component profiling in the browser environment. */
 	profile?: boolean;
+	/**
+	 * Override `compiler.strong` for this integration. Strong mode applies to
+	 * project-owned modules; dependencies can opt in with `"use strong"`.
+	 */
+	strong?: boolean;
 	/**
 	 * Ad-hoc path fragments skipped by the plain TypeScript/JavaScript
 	 * hook-slot pass. With `requireDirective`, excluded paths are exempt from