@plumeria/unplugin 18.2.33 → 18.3.0

package/README.md

@@ -196,4 +196,54 @@ If the two disagree, the prop type-checks but is never compiled away. [`@plumeri
 
 `@plumeria/unplugin` provides HMR optimized for each bundler in development mode (dev server).
 
-- **Vite / Farm / Webpack / Rspack**: The plugin extracts styles as CSS modules, enabling seamless updates via hot reloading.
+- **Vite / Farm / Webpack / Rspack**: The plugin extracts styles as CSS modules, enabling seamless updates via hot reloading.
+
+## Testing
+
+`@plumeria/unplugin/factory` exposes the compiler behind every bundler entry as a plain function. Give it a source string and it hands back the rewritten code, with the stylesheet available from `resolveId` and `load`:
+
+```js
+// compile.test.js
+const { unpluginFactory } = require('@plumeria/unplugin/factory');
+
+const compile = async (source) => {
+  const plugin = unpluginFactory(undefined, { framework: 'vite' });
+  const result = await plugin.transform.call(
+    { addWatchFile: () => {} },
+    source,
+    `${__dirname}/fixture.tsx`,
+  );
+  const code = typeof result === 'string' ? result : (result?.code ?? '');
+  const cssId = code.match(/import "([^"]*\.zero\.css)"/)?.[1];
+  const resolved = await plugin.resolveId?.call({}, cssId);
+  const loaded = await plugin.load?.call({}, resolved?.id ?? resolved);
+  return { code, css: typeof loaded === 'string' ? loaded : (loaded?.code ?? '') };
+};
+
+test('two properties become two atoms', async () => {
+  const { code, css } = await compile(`
+    import * as css from '@plumeria/core';
+    const styles = css.create({ box: { padding: 16, color: 'red' } });
+    export const A = () => <div classStyle={styles.box} />;
+  `);
+
+  expect(code).toMatch(/className=\{"\S+ \S+"\}/);
+  expect(css).toContain('padding: 16px');
+  expect(css).toContain('color: red');
+});
+```
+
+No bundler, no DOM, and no runtime resolution of `@plumeria/core` is involved, so Jest, Vitest and `node:test` all run it as it stands. The bundler entries reach `unplugin` itself, which is ESM and cannot be required from a CommonJS runner; this subpath skips them.
+
+Read the class names out of the returned code rather than hard-coding them. An atomic class name is one property–value pair, hashed, so a list spelled out in a test breaks the next time a property is added to the style.
+
+See [Testing](https://plumeria.dev/docs/testing) for the layer this belongs to, and the two it does not cover.
+
+## API Stability
+
+**Stability: Frozen** — the signature will not change; behaviour may still be corrected.
+See [API Stability](https://github.com/zss-in-js/plumeria#api-stability).
+
+## License
+
+Plumeria is [MIT licensed](https://github.com/zss-in-js/plumeria/blob/main/LICENSE).

package/dist/core.js

@@ -958,7 +958,9 @@ const unpluginFactory = (options = {}, unpluginMeta) => {
                             given.set(String(prop.key.value), prop.value);
                         }
                     });
-                    const argObj = resolveObjectArg(argExpr) ?? {};
+                    const argObj = argExpr
+                        ? (resolveObjectArg(argExpr) ?? {})
+                        : {};
                     func.named.forEach(({ key, local }) => {
                         const source = given.get(key);
                         if (!source) {

package/dist/core.mjs

@@ -922,7 +922,9 @@ export const unpluginFactory = (options = {}, unpluginMeta) => {
                             given.set(String(prop.key.value), prop.value);
                         }
                     });
-                    const argObj = resolveObjectArg(argExpr) ?? {};
+                    const argObj = argExpr
+                        ? (resolveObjectArg(argExpr) ?? {})
+                        : {};
                     func.named.forEach(({ key, local }) => {
                         const source = given.get(key);
                         if (!source) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plumeria/unplugin",
-  "version": "18.2.33",
+  "version": "18.3.0",
   "description": "Universal Plumeria plugin for various build tools",
   "author": "Refirst 11",
   "license": "MIT",
@@ -36,6 +36,11 @@
       "import": "./dist/index.mjs",
       "require": "./dist/index.js"
     },
+    "./factory": {
+      "types": "./dist/core.d.ts",
+      "import": "./dist/core.mjs",
+      "require": "./dist/core.js"
+    },
     "./vite": {
       "types": "./dist/vite.d.ts",
       "import": "./dist/vite.mjs",
@@ -89,7 +94,7 @@
   "dependencies": {
     "@rollup/pluginutils": "^5.4.0",
     "unplugin": "^3.0.0",
-    "@plumeria/utils": "^18.2.33"
+    "@plumeria/utils": "^18.3.0"
   },
   "devDependencies": {
     "@swc/core": "1.15.47",