@kirana-style/jest 0.0.0-stage → 0.1.0

package/README.md

@@ -1,3 +1,19 @@
-# Temporary Holding Version
+# @kirana-style/jest
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+The Jest adapter for Kirana ([11-integrations](../../../../spec/11-integrations.md)): a
+transformer that compiles a module's styles, then hands it to the transformer the project already
+uses.
+
+```js
+// jest.config.js
+export default {
+  transform: {
+    "\\.[jt]sx?$": ["@kirana-style/jest", { transformer: "babel-jest" }],
+  },
+}
+```
+
+Tests see the class names the application ships; no stylesheet is written. Options: `root`,
+`config`, `transformer` (default `babel-jest`), `transformerConfig`. Jest caches a module by its own
+source, so after changing tokens another module reads, run Jest once with `--no-cache`. With Vitest,
+use `@kirana-style/vite` instead.

package/package.json

@@ -1,6 +1,49 @@
 {
   "name": "@kirana-style/jest",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "Kirana for Jest: a transformer that compiles modules, then hands them to your usual one.",
+  "license": "MIT",
+  "author": "The Kirana authors",
+  "homepage": "https://kirana.style",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kirana-style/kirana.git",
+    "directory": "packages/kirana/npm/jest"
+  },
+  "bugs": {
+    "url": "https://github.com/kirana-style/kirana/issues"
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./src/index.d.ts",
+      "default": "./src/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "dependencies": {
+    "@kirana-style/compiler": "0.1.0",
+    "@kirana-style/core": "0.1.0"
+  },
+  "peerDependencies": {
+    "jest": ">=29.0.0"
+  },
+  "peerDependenciesMeta": {
+    "jest": {
+      "optional": true
+    }
+  },
+  "files": [
+    "src",
+    "bin",
+    "*.d.ts",
+    "*.css",
+    "README.md",
+    "builders.json",
+    "schemas",
+    "gatsby-node.mjs",
+    "rules",
+    "recommended.json",
+    "strict.json"
+  ]
+}

package/src/index.d.ts

@@ -0,0 +1,26 @@
+import type { DriverOptions } from "@kirana-style/compiler";
+import type { KiranaConfig } from "@kirana-style/core/config";
+export type KiranaJestOptions = {
+    /** The project root: where `kirana.config.*` and `@kirana-style/core` are found. Default: the working directory. */
+    root?: string;
+    /** Options that override `kirana.config.*`. */
+    config?: KiranaConfig;
+    /** The transformer that runs after Kirana. Default: `babel-jest`. */
+    transformer?: string;
+    /** Options for that transformer. */
+    transformerConfig?: unknown;
+    /** Injected Driver options (tests). */
+    driver?: Pick<DriverOptions, "native">;
+};
+type Transformed = string | {
+    code: string;
+    map?: unknown;
+};
+export declare function createTransformer(options?: KiranaJestOptions): {
+    canInstrument: boolean;
+    process(source: string, file: string, transformOptions: unknown): Transformed;
+};
+declare const _default: {
+    createTransformer: typeof createTransformer;
+};
+export default _default;

package/src/index.js

@@ -0,0 +1,55 @@
+/**
+ * The Jest host adapter (KRN-INT-003): a transformer that compiles a module's styles, then hands the
+ * result to the transformer the project already uses (`babel-jest` unless configured), which strips
+ * types and JSX as before. Tests see the class names the application ships; no stylesheet is
+ * written, because Jest renders no CSS.
+ *
+ *   transform: { "\\.[jt]sx?$": ["@kirana-style/jest", { transformer: "babel-jest" }] }
+ *
+ * Jest's `process` is synchronous, so the Driver is opened with `Driver.createSync`. Jest caches a
+ * module by its own source: after changing tokens another module reads, run Jest once with
+ * `--no-cache`.
+ */
+import { createRequire } from "node:module";
+import path from "node:path";
+import { Driver, formatDiagnostic } from "@kirana-style/compiler";
+import { shouldCompile } from "@kirana-style/compiler/host";
+export function createTransformer(options = {}) {
+    const root = options.root ?? process.cwd();
+    let driver;
+    let next;
+    const chained = () => {
+        if (next)
+            return next;
+        const loaded = createRequire(path.join(root, "package.json"))(options.transformer ?? "babel-jest");
+        const module = "default" in loaded ? loaded.default : loaded;
+        next = module.createTransformer
+            ? module.createTransformer(options.transformerConfig)
+            : module;
+        return next;
+    };
+    return {
+        canInstrument: false,
+        process(source, file, transformOptions) {
+            driver ??= Driver.createSync({
+                root,
+                config: options.config,
+                ...options.driver,
+            });
+            let code = source;
+            if (shouldCompile(file, source, driver.libraries)) {
+                const result = driver.transform(file, source);
+                for (const diagnostic of result.diagnostics) {
+                    const message = formatDiagnostic(diagnostic, source);
+                    if (diagnostic.severity === "error")
+                        throw new Error(message);
+                    if (diagnostic.severity === "warning")
+                        console.warn(message);
+                }
+                code = result.code ?? source;
+            }
+            return chained().process(code, file, transformOptions);
+        },
+    };
+}
+export default { createTransformer };