@octanejs/rsbuild-plugin 0.1.42 → 0.1.44

package/README.md

@@ -108,8 +108,17 @@ export default defineConfig({
 ```
 
 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"`.
+priority over the app config. Strong mode opts application code into immutable
+render snapshots and pure render projections. The compiler rejects detectable
+state, ref, Effect Event, snapshot-mutation, and nondeterministic-render
+violations; production client builds condition memoization on the author's
+assertion that every user-authored render operation is pure for its witnessed
+inputs. Callee shape and `use*` spelling do not disable that optimization.
+
+Dependencies retain compatibility behavior unless they begin a module with
+`"use strong"`. Strong analysis is bounded: an unknown call is assumed pure, so
+imported live accessors do not become immutable merely because their caller opts
+in. Keep such consumers in compatibility mode or pass an actual snapshot.
 
 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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@octanejs/rsbuild-plugin",
-  "version": "0.1.42",
+  "version": "0.1.44",
   "license": "MIT",
   "type": "module",
   "engines": {
@@ -48,12 +48,12 @@
     }
   },
   "dependencies": {
-    "@octanejs/app-core": "0.0.43",
-    "@octanejs/rspack-plugin": "0.1.42"
+    "@octanejs/app-core": "0.0.45",
+    "@octanejs/rspack-plugin": "0.1.44"
   },
   "peerDependencies": {
     "@rsbuild/core": "^2.0.0",
-    "octane": "0.1.47"
+    "octane": "0.1.49"
   },
   "devDependencies": {
     "@rsbuild/core": "^2.1.6",
@@ -63,6 +63,6 @@
     "playwright": "^1.61.1",
     "type-fest": "^5.8.0",
     "vitest": "^4.1.10",
-    "octane": "0.1.47"
+    "octane": "0.1.49"
   }
 }

package/src/index.js

@@ -135,8 +135,9 @@ function hasRoutes(config) {
 /**
  * @param {import('@octanejs/app-core').ResolvedOctaneConfig} config
  * @param {boolean | undefined} strongOverride
+ * @param {boolean | undefined} nativeReadsOverride
  */
-function configSignature(config, strongOverride) {
+function configSignature(config, strongOverride, nativeReadsOverride) {
 	return JSON.stringify({
 		build: config.build,
 		routes: config.router.routes.map((route) =>
@@ -156,6 +157,7 @@ function configSignature(config, strongOverride) {
 		compiler: {
 			renderers: config.compiler.renderers.signature,
 			strong: strongOverride ?? config.compiler.strong,
+			nativeReads: nativeReadsOverride ?? config.compiler.nativeReads,
 		},
 	});
 }
@@ -237,6 +239,7 @@ function assertRootPublicPaths(config, clientEnvironment) {
  *   cssModuleConstants?: import('@octanejs/rspack-plugin').OctaneRspackPluginOptions['cssModuleConstants'],
  *   profile?: boolean,
  *   strong?: boolean,
+ *   nativeReads?: boolean,
  *   exclude?: string[],
  *   requireDirective?: boolean,
  *   clientEnvironment?: string,
@@ -245,6 +248,9 @@ function assertRootPublicPaths(config, clientEnvironment) {
  * @returns {import('@rsbuild/core').RsbuildPlugin}
  */
 export function pluginOctane(inlineOptions = {}) {
+	if (inlineOptions.nativeReads !== undefined && typeof inlineOptions.nativeReads !== 'boolean') {
+		throw new TypeError('[@octanejs/rsbuild-plugin] nativeReads must be a boolean.');
+	}
 	if (inlineOptions.strong !== undefined && typeof inlineOptions.strong !== 'boolean') {
 		throw new TypeError('[@octanejs/rsbuild-plugin] `strong` must be a boolean.');
 	}
@@ -266,17 +272,22 @@ export function pluginOctane(inlineOptions = {}) {
 				: null;
 			const initialConfig = initialLoaded?.config ?? null;
 			const strong = inlineOptions.strong ?? initialConfig?.compiler.strong;
+			const nativeReads = inlineOptions.nativeReads ?? initialConfig?.compiler.nativeReads;
 			const appEnabled = hasRoutes(initialConfig);
 			const buildTargetPlan =
 				initialConfig?.build.target === undefined
 					? null
 					: createBuildTargetPlan(initialConfig.build.target);
 			const neutralCompiler = appEnabled
-				? createOctaneCompiler({ root, ...(strong === undefined ? null : { strong }) })
+				? createOctaneCompiler({
+						root,
+						...(strong === undefined ? null : { strong }),
+						...(nativeReads === undefined ? null : { nativeReads }),
+					})
 				: null;
 			let currentConfig = initialConfig;
 			let lastConfigSignature = initialLoaded
-				? configSignature(initialLoaded.config, inlineOptions.strong)
+				? configSignature(initialLoaded.config, inlineOptions.strong, inlineOptions.nativeReads)
 				: '';
 			let configNeedsReload = false;
 			/** @type {import('@rsbuild/core').RsbuildDevServer | null} */
@@ -324,7 +335,11 @@ export function pluginOctane(inlineOptions = {}) {
 					throw error;
 				}
 				registerConfigDependencies(context, loaded);
-				const signature = configSignature(loaded.config, inlineOptions.strong);
+				const signature = configSignature(
+					loaded.config,
+					inlineOptions.strong,
+					inlineOptions.nativeReads,
+				);
 				if (lastConfigSignature && signature !== lastConfigSignature) configNeedsReload = true;
 				lastConfigSignature = signature;
 				currentConfig = loaded.config;
@@ -553,6 +568,7 @@ export function pluginOctane(inlineOptions = {}) {
 							? null
 							: { cssModuleConstants: inlineOptions.cssModuleConstants }),
 						...(strong === undefined ? null : { strong }),
+						...(nativeReads === undefined ? null : { nativeReads }),
 						...(inlineOptions.hmr === undefined ? null : { hmr: inlineOptions.hmr }),
 						...(inlineOptions.profile === undefined
 							? null

package/src/project.js

@@ -106,6 +106,7 @@ function maskNonCode(source) {
  * @param {string} id
  */
 function ownsServerModule(source, id) {
+	if (!source.includes('module') || !source.includes('server')) return false;
 	if (!SERVER_MODULE_CANDIDATE.test(maskNonCode(source))) return false;
 	const compiled = compile(source, id, { mode: 'server' });
 	return COMPILED_SERVER_NAMESPACE.test(maskNonCode(compiled.code));

package/types/index.d.ts

@@ -28,10 +28,13 @@ export interface OctaneRsbuildPluginOptions {
 	/** 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"`.
+	 * Override `compiler.strong` for this integration. Strong asserts pure
+	 * immutable-snapshot renders in project-owned modules; dependencies can opt
+	 * in with `"use strong"`.
 	 */
 	strong?: boolean;
+	/** Experimental native signal reads in DOM client/server render scopes. */
+	nativeReads?: boolean;
 	/**
 	 * Ad-hoc path fragments skipped by the plain TypeScript/JavaScript
 	 * hook-slot pass. With `requireDirective`, excluded paths are exempt from