@plumeria/swc-jest 19.8.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) zss-in-js contributer
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,91 @@
+# @plumeria/swc-jest
+
+Jest transformer for Plumeria.  
+It compiles the styling prop away, then hands the file to [`@swc/jest`](https://www.npmjs.com/package/@swc/jest), so components render in a test with the class names the build gives them.
+
+## Installation
+
+```bash
+npm install -D @plumeria/swc-jest @swc/core
+# or
+yarn add -D @plumeria/swc-jest @swc/core
+# or
+pnpm add -D @plumeria/swc-jest @swc/core
+```
+
+## How to Use
+
+Put it where `@swc/jest` was. Jest runs one transformer per pattern, so it replaces the entry rather than sitting beside it:
+
+```js
+// jest.config.js
+module.exports = {
+  testEnvironment: 'jsdom',
+  transform: {
+    '^.+\\.(t|j)sx?$': '@plumeria/swc-jest',
+  },
+};
+```
+
+SWC is configured as before: from `.swcrc`, or from the options next to the transformer.
+
+## Options
+
+```js
+module.exports = {
+  transform: {
+    '^.+\\.(t|j)sx?$': [
+      '@plumeria/swc-jest',
+      {
+        styleProp: 'sx',
+        jsc: { transform: { react: { runtime: 'automatic' } } },
+      },
+    ],
+  },
+};
+```
+
+| Option | Default | Description |
+| :-- | :-- | :-- |
+| `styleProp` | `'classStyle'` | The JSX prop that carries styles. |
+| `withoutLogicalProperties` | `false` | Reject the logical name of a property that also has a physical name. Takes `true` or `{ sizes?: boolean }`. |
+| `withoutPhysicalProperties` | `false` | Reject the physical name of a property that also has a logical name. Takes `true` or `{ sizes?: boolean }`. |
+
+Every other key is passed to `@swc/jest` unchanged. Keep these three the same as in the bundler config.
+
+## Do
+
+Assert what the component does. The class names are real, so a branch that picks a different style shows up as a different `className`:
+
+```tsx
+test('the active tab is styled apart from the rest', () => {
+  render(<Tabs active="b" />);
+
+  const a = screen.getByRole('tab', { name: 'A' });
+  const b = screen.getByRole('tab', { name: 'B' });
+
+  expect(b.getAttribute('aria-selected')).toBe('true');
+  expect(b.className).not.toBe(a.className);
+});
+```
+
+- Test text, roles, state and events, as you would without Plumeria.
+- Compare class names between two renders or two elements to check a conditional style took effect.
+- Import styles from other files freely. They compile as in the build, and Jest's cache follows them: change a shared style and the files that use it are compiled again.
+
+## Don't
+
+```tsx
+expect(button.className).toBe('xqqbxt1d xq96bg3w'); // don't
+expect(getComputedStyle(button).color).toBe('red'); // don't
+```
+
+- Don't hard-code a generated class name. Each one is a hashed property–value pair, so adding a property to the style breaks the test without anything being wrong.
+- Don't assert computed styles. jsdom applies no stylesheet, and none is written: `getComputedStyle` returns initial values. Check the cascade, `@media` and pseudo-classes in a real browser.
+- Don't list it beside `@swc/jest`, `ts-jest` or `babel-jest` for the same files. Only one transformer runs per pattern.
+- Don't rely on the test run for type checking. SWC strips types; run `tsc` for that.
+- Don't use it to test what a style compiles to. Call the transform directly for that; see [Driving the transform](https://plumeria.dev/docs/api-reference/plugins/unplugin#driving-the-transform).
+
+## License
+
+Plumeria is [MIT licensed](https://github.com/zss-in-js/plumeria/blob/main/LICENSE).

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+import swcJest from '@swc/jest';
+import type { PropertyPolicyOptions } from '@plumeria/compiler';
+type SwcOptions = NonNullable<Parameters<typeof swcJest.createTransformer>[0]>;
+type SwcTransformer = ReturnType<typeof swcJest.createTransformer>;
+export interface TransformerOptions extends SwcOptions, PropertyPolicyOptions {
+    styleProp?: string;
+}
+export declare function createTransformer(options?: TransformerOptions): SwcTransformer;
+declare const _default: {
+    createTransformer: typeof createTransformer;
+};
+export default _default;

package/dist/index.js

@@ -0,0 +1,55 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createTransformer = createTransformer;
+const jest_1 = __importDefault(require("@swc/jest"));
+const compiler_1 = require("@plumeria/compiler");
+function createTransformer(options = {}) {
+    const { styleProp = compiler_1.DEFAULT_STYLE_PROP, withoutLogicalProperties, withoutPhysicalProperties, ...swcOptions } = options;
+    const propertyPolicy = (0, compiler_1.resolvePropertyPolicy)({
+        withoutLogicalProperties,
+        withoutPhysicalProperties,
+    });
+    const swc = jest_1.default.createTransformer(swcOptions);
+    const compiled = new Map();
+    const compile = (src, filename, jestOptions) => {
+        if (filename.includes('node_modules') ||
+            !(0, compiler_1.needsCompile)(src, styleProp, filename)) {
+            return src;
+        }
+        return (0, compiler_1.transformSource)({
+            source: src,
+            moduleId: filename,
+            filePath: filename,
+            root: jestOptions.config.rootDir,
+            styleProp,
+            propertyPolicy,
+            isDev: process.env.NODE_ENV !== 'production',
+            collectOndemandSheets: false,
+        }).code;
+    };
+    const take = (src, filename, jestOptions) => {
+        const cached = compiled.get(filename);
+        compiled.delete(filename);
+        return cached && cached.src === src
+            ? cached.code
+            : compile(src, filename, jestOptions);
+    };
+    return {
+        canInstrument: swc.canInstrument,
+        process(...[src, filename, jestOptions]) {
+            return swc.process(take(src, filename, jestOptions), filename, jestOptions);
+        },
+        processAsync(...[src, filename, jestOptions]) {
+            return swc.processAsync(take(src, filename, jestOptions), filename, jestOptions);
+        },
+        getCacheKey(...[src, filename, jestOptions]) {
+            const code = compile(src, filename, jestOptions);
+            compiled.set(filename, { src, code });
+            return swc.getCacheKey(code, filename, jestOptions);
+        },
+    };
+}
+exports.default = { createTransformer };

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@plumeria/swc-jest",
+  "version": "19.8.2",
+  "description": "Plumeria Jest transformer on @swc/jest",
+  "author": "Refirst 11",
+  "license": "MIT",
+  "homepage": "https://plumeria.dev",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/zss-in-js/plumeria.git",
+    "directory": "packages/swc-jest"
+  },
+  "bugs": {
+    "url": "https://github.com/zss-in-js/plumeria/issues"
+  },
+  "sideEffects": false,
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist/"
+  ],
+  "dependencies": {
+    "@swc/jest": "^0.2.39",
+    "@plumeria/compiler": "19.8.2"
+  },
+  "peerDependencies": {
+    "@swc/core": "*"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "scripts": {
+    "build": "rimraf dist && pnpm cjs",
+    "cjs": "tsc --project tsconfig.cjs.json"
+  }
+}