@cssxio/babel-plugin 0.4.0 → 0.4.3

package/README.md

@@ -29,4 +29,4 @@ export default {
 
 The plugin accepts an optional `theme` string containing CSS text with CSSX `@theme` input. Use `themeFile` in the CSSX adapter when the build tool should read theme CSS text from a file.
 
-Set `stableClassNames: true` when development builds need composite class names to remain stable across CSS-only edits. The generated names are derived from the source file and call site, so use the same setting consistently for a given development environment.
+Set `stableClassNames: true` when development builds need composite class names to remain stable across CSS-only edits, or when a framework transforms server and client modules in separate compiler processes. The generated names are derived from the source file and call site, so use the same setting consistently for a given build.

package/dist/index.cjs

@@ -151,7 +151,7 @@ function cssxBabelPlugin(api, options = {}) {
     visitor: {
       Program: {
         enter(_path, babelState) {
-          fileName = babelState.file.opts.filename ?? "";
+          fileName = options.stableClassNameFileName ?? babelState.file.opts.filename ?? "";
           state = {
             classNameAllocator: options.classNameAllocator ?? (0, import_compiler.createClassNameAllocator)(options.className),
             styles: /* @__PURE__ */ new Map(),

package/dist/index.d.cts

@@ -14,8 +14,10 @@ interface CssxPluginOptions {
     readonly classNameAllocator?: ClassNameAllocator;
     /** Controls how aggressively static styles share generated class fragments. */
     readonly reusabilityBudget?: ReusabilityBudget;
-    /** Uses source-addressed composite names for development stylesheet updates. */
+    /** Uses source-addressed composite names across independently transformed modules. */
     readonly stableClassNames?: boolean;
+    /** Canonical source identifier used when deriving stable composite class names. */
+    readonly stableClassNameFileName?: string;
     /** Controls how the `dark` variant is activated. */
     readonly darkMode?: DarkMode;
 }

package/dist/index.d.ts

@@ -14,8 +14,10 @@ interface CssxPluginOptions {
     readonly classNameAllocator?: ClassNameAllocator;
     /** Controls how aggressively static styles share generated class fragments. */
     readonly reusabilityBudget?: ReusabilityBudget;
-    /** Uses source-addressed composite names for development stylesheet updates. */
+    /** Uses source-addressed composite names across independently transformed modules. */
     readonly stableClassNames?: boolean;
+    /** Canonical source identifier used when deriving stable composite class names. */
+    readonly stableClassNameFileName?: string;
     /** Controls how the `dark` variant is activated. */
     readonly darkMode?: DarkMode;
 }

package/dist/index.js

@@ -125,7 +125,7 @@ function cssxBabelPlugin(api, options = {}) {
     visitor: {
       Program: {
         enter(_path, babelState) {
-          fileName = babelState.file.opts.filename ?? "";
+          fileName = options.stableClassNameFileName ?? babelState.file.opts.filename ?? "";
           state = {
             classNameAllocator: options.classNameAllocator ?? createClassNameAllocator(options.className),
             styles: /* @__PURE__ */ new Map(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cssxio/babel-plugin",
-  "version": "0.4.0",
+  "version": "0.4.3",
   "description": "Babel compiler transform for CSSX.",
   "license": "MIT",
   "repository": {
@@ -27,7 +27,7 @@
     "@babel/core": "^7.28.0"
   },
   "dependencies": {
-    "@cssxio/compiler": "^0.2.0"
+    "@cssxio/compiler": "^0.4.2"
   },
   "scripts": {
     "build": "tsup src/index.ts --format esm,cjs --dts --external @babel/core --clean"