@octanejs/rsbuild-plugin 0.1.37 → 0.1.39

package/README.md

@@ -75,7 +75,7 @@ includes Samsung Internet 14, which corresponds to Chromium 87. ES levels and
 browser targets cannot be mixed in the same array. Transpilation changes syntax;
 applications remain responsible for any additional Web API polyfills they use.
 
-Options are declarative and cache-stable:
+Common compiler options:
 
 - `hmr` controls browser component handoff;
 - `parallel` controls compiler workers; the default uses up to four, `false`
@@ -89,6 +89,16 @@ Rspack shares one loader worker pool per process, so the first parallel loader
 determines its effective size. Worker startup has a fixed cost, so very small
 builds may be faster with `parallel: false`.
 
+The experimental `cssModuleConstants` option forwards the Rspack class plugin's
+immutable CSS-export contract to both build environments. Use
+`pluginOctane({ cssModuleConstants: true })` with
+`output.cssModules.namedExport: true` and named or namespace CSS imports to fold
+proven strings from Rsbuild's CSS-loader pipeline. Mutable default maps require
+an explicit immutable-provider callback. This is disabled by default, adds a
+bounded extra compile for eligible consumers, and leaves native `css/module`,
+development, HMR, and watch output unchanged. See
+[CSS-module constants](../../docs/compiler-css-module-constants.md).
+
 Enable Strong mode for the whole app in `octane.config.ts`:
 
 ```ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@octanejs/rsbuild-plugin",
-  "version": "0.1.37",
+  "version": "0.1.39",
   "license": "MIT",
   "type": "module",
   "engines": {
@@ -48,12 +48,12 @@
     }
   },
   "dependencies": {
-    "@octanejs/app-core": "0.0.38",
-    "@octanejs/rspack-plugin": "0.1.37"
+    "@octanejs/app-core": "0.0.40",
+    "@octanejs/rspack-plugin": "0.1.39"
   },
   "peerDependencies": {
     "@rsbuild/core": "^2.0.0",
-    "octane": "0.1.42"
+    "octane": "0.1.44"
   },
   "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.42"
+    "octane": "0.1.44"
   }
 }

package/src/index.js

@@ -234,6 +234,7 @@ function assertRootPublicPaths(config, clientEnvironment) {
  * @param {{
  *   hmr?: boolean,
  *   parallel?: boolean | { maxWorkers?: number },
+ *   cssModuleConstants?: import('@octanejs/rspack-plugin').OctaneRspackPluginOptions['cssModuleConstants'],
  *   profile?: boolean,
  *   strong?: boolean,
  *   exclude?: string[],
@@ -548,6 +549,9 @@ export function pluginOctane(inlineOptions = {}) {
 						environment,
 						transpile: false,
 						...(inlineOptions.parallel === undefined ? null : { parallel: inlineOptions.parallel }),
+						...(inlineOptions.cssModuleConstants === undefined
+							? null
+							: { cssModuleConstants: inlineOptions.cssModuleConstants }),
 						...(strong === undefined ? null : { strong }),
 						...(inlineOptions.hmr === undefined ? null : { hmr: inlineOptions.hmr }),
 						...(inlineOptions.profile === undefined

package/types/index.d.ts

@@ -1,4 +1,5 @@
 import type { RsbuildPlugin } from '@rsbuild/core';
+import type { OctaneRspackPluginOptions } from '@octanejs/rspack-plugin';
 
 export * from '@octanejs/app-core';
 export {
@@ -9,6 +10,12 @@ export {
 } from '@octanejs/app-core/config-loader';
 
 export interface OctaneRsbuildPluginOptions {
+	/**
+	 * @experimental Fold authenticated JavaScript CSS-module exports in one-shot
+	 * production builds. Uses the Rspack plugin's exact-source provider contract;
+	 * native `css/module` remains unchanged. Disabled by default.
+	 */
+	cssModuleConstants?: OctaneRspackPluginOptions['cssModuleConstants'];
 	/** Override component HMR in the browser environment. */
 	hmr?: boolean;
 	/**