@kirana-style/webpack 0.1.0 → 0.2.0

package/CHANGELOG.md

@@ -0,0 +1,47 @@
+# Changelog
+
+## [0.2.0](https://github.com/kirana-style/kirana/compare/v0.1.0...v0.2.0) (2026-10-15)
+
+
+### ⚠ BREAKING CHANGES
+
+* one command name, kirana-style ([#29](https://github.com/kirana-style/kirana/issues/29))
+
+### Features
+
+* **editor:** real editor output on the site, open vsx trusted publishing ([#21](https://github.com/kirana-style/kirana/issues/21)) ([350fa4e](https://github.com/kirana-style/kirana/commit/350fa4ec0d8054a082d6c7dcdae2b5be53f8d98a))
+* one command name, kirana-style ([#29](https://github.com/kirana-style/kirana/issues/29)) ([b3f3154](https://github.com/kirana-style/kirana/commit/b3f3154662589dd1bd43fd0ff2341acf4f3df628))
+* **site:** paper, ink, scenery and type for one identity ([#27](https://github.com/kirana-style/kirana/issues/27)) ([5da3c6f](https://github.com/kirana-style/kirana/commit/5da3c6f0f1c8cbfdb450b36a6609a3ab4b20e358))
+* **site:** reorganise the homepage, product pages and docs ([#28](https://github.com/kirana-style/kirana/issues/28)) ([88b5209](https://github.com/kirana-style/kirana/commit/88b52093488b2aa0112b458ca04b836c83d03954))
+* **site:** scenery gradients, logo downloads, pixel k, glass icons ([#25](https://github.com/kirana-style/kirana/issues/25)) ([2953dc1](https://github.com/kirana-style/kirana/commit/2953dc126f47b68257ebfdb33c61992984708c49))
+
+
+### Bug fixes
+
+* hold emnapi at 2.0.0-alpha.6, the wasi engine fails on the beta ([#26](https://github.com/kirana-style/kirana/issues/26)) ([8aa33e1](https://github.com/kirana-style/kirana/commit/8aa33e1dbccaefa15b87f6487ac0a346bbf6581a))
+* settle the ember dev check, resolve code scanning findings ([#23](https://github.com/kirana-style/kirana/issues/23)) ([0c266c8](https://github.com/kirana-style/kirana/commit/0c266c8428c1453892beeeb5f98918cbc0eae6ff))
+* **site:** keep syntax colours in the production build ([#22](https://github.com/kirana-style/kirana/issues/22)) ([621f2fc](https://github.com/kirana-style/kirana/commit/621f2fcf67dada773ca66110e295ab7ac5605f56))
+
+
+### Documentation
+
+* fix the extension's settings table ([#13](https://github.com/kirana-style/kirana/issues/13)) ([457e06d](https://github.com/kirana-style/kirana/commit/457e06d12f9e3b005e0820aab36faac5bf3f80b3))
+
+
+### Dependencies
+
+* bump the minor-and-patch group across 1 directory with 3 updates ([#19](https://github.com/kirana-style/kirana/issues/19)) ([7ea00ed](https://github.com/kirana-style/kirana/commit/7ea00edcc5cc02b9ab5e41b13f152ae344ea448f))
+* emnapi 2.0.0-beta.1, minor and patch updates ([#24](https://github.com/kirana-style/kirana/issues/24)) ([a399fa7](https://github.com/kirana-style/kirana/commit/a399fa78e53dcfd7f41f249ccee1133809e66544))
+
+## [0.1.0](https://github.com/kirana-style/kirana/compare/v0.1.0...v0.1.0) (2026-10-13)
+
+
+### Features
+
+* kirana goes public — write objects, read classes, ship css ([79732ed](https://github.com/kirana-style/kirana/commit/79732edd5cab419169ab74ad59e1c70053dfa57d))
+
+
+### Dependencies
+
+* bump the minor-and-patch group in /packages/kirana with 6 updates ([#10](https://github.com/kirana-style/kirana/issues/10)) ([0deaf9f](https://github.com/kirana-style/kirana/commit/0deaf9f3e75ebc377d764c294250bd2577d53844))
+* bump the oxc group in /packages/kirana with 7 updates ([#9](https://github.com/kirana-style/kirana/issues/9)) ([a3ca94c](https://github.com/kirana-style/kirana/commit/a3ca94c170b2ca49c9691abf5ad48c3ef4ac8620))

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kirana authors
+
+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

@@ -23,7 +23,7 @@ export default withKirana({})
 - **Loader.** The plugin registers a `pre` loader for scripts, so `sx` is read before `swc-loader`,
   `babel-loader` or Next.js compile JSX away.
 - **Stylesheet.** `@kirana-style/core/stylesheet.css` is ordinary CSS to webpack. The plugin writes the
-  finished stylesheet into the emitted asset at `processAssets`' optimize stage — after every module,
+  finished stylesheet into the emitted asset at `processAssets`' optimize stage: after every module,
   before the CSS minimizer and before `realContentHash` renames the file by its content.
 - **Several compilers.** Every compiler of a project (Next.js's server, edge and client) shares one
   compiler session, so atoms from server components reach the client's stylesheet.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kirana-style/webpack",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Kirana for webpack 5 and Rspack: a loader that compiles modules and a plugin that finishes the stylesheet.",
   "license": "MIT",
   "author": "The Kirana authors",
@@ -14,6 +14,9 @@
     "url": "https://github.com/kirana-style/kirana/issues"
   },
   "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
   "exports": {
     ".": {
       "types": "./src/index.d.ts",
@@ -30,8 +33,8 @@
     "./package.json": "./package.json"
   },
   "dependencies": {
-    "@kirana-style/compiler": "0.1.0",
-    "@kirana-style/core": "0.1.0"
+    "@kirana-style/compiler": "0.2.0",
+    "@kirana-style/core": "0.2.0"
   },
   "peerDependencies": {
     "webpack": "^5.90.0",
@@ -51,6 +54,8 @@
     "*.d.ts",
     "*.css",
     "README.md",
+    "CHANGELOG.md",
+    "LICENSE",
     "builders.json",
     "schemas",
     "gatsby-node.mjs",

package/src/index.d.ts

@@ -1,64 +1,65 @@
-import type { KiranaWebpackOptions } from "./session.ts";
-export type { KiranaWebpackOptions } from "./session.ts";
+import { KiranaWebpackOptions } from "./session.js";
+//#region src/index.d.ts
 type Asset = {
-    name: string;
-    source: {
-        source: () => string | Buffer;
-    };
+  name: string;
+  source: {
+    source: () => string | Buffer;
+  };
 };
 type Compilation = {
-    warnings: Error[];
-    errors: Error[];
-    getAssets: () => readonly Asset[];
-    updateAsset: (name: string, source: unknown) => void;
-    hooks: {
-        finishModules: {
-            tapPromise: (name: string, hook: (modules: Iterable<unknown>) => Promise<void>) => void;
-        };
-        processAssets: {
-            tapPromise: (options: {
-                name: string;
-                stage: number;
-            }, hook: () => Promise<void>) => void;
-        };
+  warnings: Error[];
+  errors: Error[];
+  getAssets: () => readonly Asset[];
+  updateAsset: (name: string, source: unknown) => void;
+  hooks: {
+    finishModules: {
+      tapPromise: (name: string, hook: (modules: Iterable<unknown>) => Promise<void>) => void;
+    };
+    processAssets: {
+      tapPromise: (options: {
+        name: string;
+        stage: number;
+      }, hook: () => Promise<void>) => void;
     };
+  };
 };
 /** The part of webpack's and Rspack's compiler the plugin uses. */
 export type Compiler = {
-    context: string;
-    options: {
-        mode?: string;
-        module: {
-            rules: unknown[];
-        };
+  context: string;
+  options: {
+    mode?: string;
+    module: {
+      rules: unknown[];
+    };
+  };
+  webpack: {
+    WebpackError: new (message: string) => Error;
+    Compilation: {
+      PROCESS_ASSETS_STAGE_OPTIMIZE: number;
+    };
+    sources: {
+      RawSource: new (source: string) => unknown;
+    };
+  };
+  hooks: {
+    thisCompilation: {
+      tap: (name: string, hook: (compilation: Compilation) => void) => void;
+    };
+    invalid: {
+      tap: (name: string, hook: (file: string | null) => void) => void;
     };
-    webpack: {
-        WebpackError: new (message: string) => Error;
-        Compilation: {
-            PROCESS_ASSETS_STAGE_OPTIMIZE: number;
-        };
-        sources: {
-            RawSource: new (source: string) => unknown;
-        };
+    watchRun: {
+      tapPromise: (name: string, hook: () => Promise<void>) => void;
     };
-    hooks: {
-        thisCompilation: {
-            tap: (name: string, hook: (compilation: Compilation) => void) => void;
-        };
-        invalid: {
-            tap: (name: string, hook: (file: string | null) => void) => void;
-        };
-        watchRun: {
-            tapPromise: (name: string, hook: () => Promise<void>) => void;
-        };
-        done: {
-            tapPromise: (name: string, hook: () => Promise<void>) => void;
-        };
+    done: {
+      tapPromise: (name: string, hook: () => Promise<void>) => void;
     };
+  };
 };
 export declare class KiranaPlugin {
-    readonly options: KiranaWebpackOptions;
-    constructor(options?: KiranaWebpackOptions);
-    apply(compiler: Compiler): void;
+  readonly options: KiranaWebpackOptions;
+  constructor(options?: KiranaWebpackOptions);
+  apply(compiler: Compiler): void;
 }
-export default KiranaPlugin;
+//#endregion
+export { KiranaPlugin as default, type KiranaWebpackOptions };

package/src/index.js

@@ -1,114 +1,103 @@
-/**
- * The webpack 5 and Rspack host adapter (KRN-INT-001, KRN-INT-003): a `pre` loader compiles modules,
- * and the plugin finishes the stylesheet entry. Rspack implements webpack's plugin and loader API,
- * so one adapter serves both. It never interprets styles (D-028).
- *
- * The stylesheet entry is ordinary CSS to the host — native CSS, `css-loader` with
- * `mini-css-extract-plugin`, Rsbuild's or Next.js's pipeline — so the host names and links it as it
- * does any stylesheet. The loader answers it with the placeholder rule, and the plugin writes the
- * finished stylesheet into the emitted asset at `processAssets`' optimize stage: after every module
- * is built, before the CSS minimizer, and before `realContentHash` renames the file by its real
- * content (on by default in production in both bundlers).
- *
- * Not `rebuildModule` at `finishModules`, which would let the host hash the right content from the
- * start: Rspack 2 panics ("should have event sender") rebuilding a module under Rsbuild's CSS
- * extraction.
- */
-import { fillStylesheet, shouldCompile, stylesheetPath, } from "@kirana-style/compiler/host";
+import { createSession, sessions } from "./session.js";
+import { fillStylesheet, shouldCompile, stylesheetPath } from "@kirana-style/compiler/host";
 import { createHash } from "node:crypto";
 import { readFile, writeFile } from "node:fs/promises";
 import { tmpdir } from "node:os";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
-import { createSession, sessions } from "./session.js";
+//#region src/index.ts
+/**
+* The webpack 5 and Rspack host adapter (KRN-INT-001, KRN-INT-003): a `pre` loader compiles modules,
+* and the plugin finishes the stylesheet entry. Rspack implements webpack's plugin and loader API,
+* so one adapter serves both. It never interprets styles (D-028).
+*
+* The stylesheet entry is ordinary CSS to the host — native CSS, `css-loader` with
+* `mini-css-extract-plugin`, Rsbuild's or Next.js's pipeline — so the host names and links it as it
+* does any stylesheet. The loader answers it with the placeholder rule, and the plugin writes the
+* finished stylesheet into the emitted asset at `processAssets`' optimize stage: after every module
+* is built, before the CSS minimizer, and before `realContentHash` renames the file by its real
+* content (on by default in production in both bundlers).
+*
+* Not `rebuildModule` at `finishModules`, which would let the host hash the right content from the
+* start: Rspack 2 panics ("should have event sender") rebuilding a module under Rsbuild's CSS
+* extraction.
+*/
 /** The loader, next to this file with the same extension (TypeScript source in the workspace, JavaScript when packed). */
 const LOADER = fileURLToPath(new URL(`./loader${import.meta.url.slice(import.meta.url.lastIndexOf("."))}`, import.meta.url));
 const NAME = "kirana";
 const SCRIPT_FILE = /\.[cm]?[jt]sx?$/;
-export class KiranaPlugin {
-    options;
-    constructor(options = {}) {
-        this.options = options;
-    }
-    apply(compiler) {
-        const root = this.options.root ?? compiler.context;
-        const stylesheetFile = stylesheetPath(root);
-        const id = createSession(this.options, root, stylesheetFile, compiler.options.mode !== "development");
-        const session = sessions.get(id);
-        const loader = {
-            loader: this.options.loader ?? LOADER,
-            options: { session: id },
-        };
-        compiler.options.module.rules.unshift({
-            enforce: "pre",
-            test: SCRIPT_FILE,
-            // Installed packages pass through the loader untouched unless they are in `libraries`.
-            use: [loader],
-        }, {
-            enforce: "pre",
-            test: (file) => file === stylesheetFile,
-            use: [loader],
-        });
-        // A watch rebuild: modules that read the changed file's tokens or relations compile again.
-        compiler.hooks.invalid.tap(NAME, (file) => {
-            if (file)
-                void session.driver().then((driver) => driver.invalidate(file));
-        });
-        // Watching: the stylesheet entry follows a file the plugin rewrites whenever the stylesheet
-        // changes, outside `node_modules`, which bundlers treat as immutable and do not watch.
-        compiler.hooks.watchRun.tapPromise(NAME, async () => {
-            if (session.live)
-                return;
-            session.live = path.join(tmpdir(), `kirana-${createHash("sha256").update(root).digest("hex").slice(0, 12)}.css`);
-            await writeFile(session.live, "");
-        });
-        compiler.hooks.done.tapPromise(NAME, async () => {
-            if (!session.live)
-                return;
-            const css = (await session.driver()).stylesheet(false);
-            if ((await readFile(session.live, "utf8")) !== css)
-                await writeFile(session.live, css);
-        });
-        compiler.hooks.thisCompilation.tap(NAME, (compilation) => {
-            const { Compilation, sources, WebpackError } = compiler.webpack;
-            compilation.hooks.finishModules.tapPromise(NAME, async (modules) => {
-                const driver = await session.driver();
-                // Modules a persistent cache restored never reached the loader: compile them from disk, so
-                // their atoms are in the stylesheet. Their cached code already names the same classes.
-                for (const module of modules) {
-                    // A module without a file (webpack's runtime) has no `resource`, and is no script.
-                    const file = String(module.resource).split("?")[0];
-                    if (!SCRIPT_FILE.test(file) || session.compiled.has(file))
-                        continue;
-                    const source = await readFile(file, "utf8");
-                    if (!shouldCompile(file, source, driver.libraries))
-                        continue;
-                    driver.transform(file, source);
-                    session.compiled.add(file);
-                }
-                try {
-                    session.reporter.project({
-                        warn: (message) => compilation.warnings.push(new WebpackError(message)),
-                        error: (message) => {
-                            throw new WebpackError(message);
-                        },
-                    }, root, driver.diagnostics());
-                }
-                catch (error) {
-                    compilation.errors.push(error);
-                }
-            });
-            compilation.hooks.processAssets.tapPromise({ name: NAME, stage: Compilation.PROCESS_ASSETS_STAGE_OPTIMIZE }, async () => {
-                const css = (await session.driver()).stylesheet(session.minify);
-                for (const asset of compilation.getAssets()) {
-                    if (!asset.name.endsWith(".css"))
-                        continue;
-                    const source = fillStylesheet(String(asset.source.source()), css);
-                    if (source !== undefined)
-                        compilation.updateAsset(asset.name, new sources.RawSource(source));
-                }
-            });
-        });
-    }
-}
-export default KiranaPlugin;
+var KiranaPlugin = class {
+	options;
+	constructor(options = {}) {
+		this.options = options;
+	}
+	apply(compiler) {
+		const root = this.options.root ?? compiler.context;
+		const stylesheetFile = stylesheetPath(root);
+		const id = createSession(this.options, root, stylesheetFile, compiler.options.mode !== "development");
+		const session = sessions.get(id);
+		const loader = {
+			loader: this.options.loader ?? LOADER,
+			options: { session: id }
+		};
+		compiler.options.module.rules.unshift({
+			enforce: "pre",
+			test: SCRIPT_FILE,
+			use: [loader]
+		}, {
+			enforce: "pre",
+			test: (file) => file === stylesheetFile,
+			use: [loader]
+		});
+		compiler.hooks.invalid.tap(NAME, (file) => {
+			if (file) session.driver().then((driver) => driver.invalidate(file));
+		});
+		compiler.hooks.watchRun.tapPromise(NAME, async () => {
+			if (session.live) return;
+			session.live = path.join(tmpdir(), `kirana-${createHash("sha256").update(root).digest("hex").slice(0, 12)}.css`);
+			await writeFile(session.live, "");
+		});
+		compiler.hooks.done.tapPromise(NAME, async () => {
+			if (!session.live) return;
+			const css = (await session.driver()).stylesheet(false);
+			if (await readFile(session.live, "utf8") !== css) await writeFile(session.live, css);
+		});
+		compiler.hooks.thisCompilation.tap(NAME, (compilation) => {
+			const { Compilation, sources, WebpackError } = compiler.webpack;
+			compilation.hooks.finishModules.tapPromise(NAME, async (modules) => {
+				const driver = await session.driver();
+				for (const module of modules) {
+					const file = String(module.resource).split("?")[0];
+					if (!SCRIPT_FILE.test(file) || session.compiled.has(file)) continue;
+					const source = await readFile(file, "utf8");
+					if (!shouldCompile(file, source, driver.libraries)) continue;
+					driver.transform(file, source);
+					session.compiled.add(file);
+				}
+				try {
+					session.reporter.project({
+						warn: (message) => compilation.warnings.push(new WebpackError(message)),
+						error: (message) => {
+							throw new WebpackError(message);
+						}
+					}, root, driver.diagnostics());
+				} catch (error) {
+					compilation.errors.push(error);
+				}
+			});
+			compilation.hooks.processAssets.tapPromise({
+				name: NAME,
+				stage: Compilation.PROCESS_ASSETS_STAGE_OPTIMIZE
+			}, async () => {
+				const css = (await session.driver()).stylesheet(session.minify);
+				for (const asset of compilation.getAssets()) {
+					if (!asset.name.endsWith(".css")) continue;
+					const source = fillStylesheet(String(asset.source.source()), css);
+					if (source !== void 0) compilation.updateAsset(asset.name, new sources.RawSource(source));
+				}
+			});
+		});
+	}
+};
+//#endregion
+export { KiranaPlugin, KiranaPlugin as default };

package/src/loader.d.ts

@@ -1,12 +1,14 @@
+//#region src/loader.d.ts
 /** The part of webpack's and Rspack's loader context the loader uses. */
 export type LoaderContext = {
-    resourcePath: string;
-    resourceQuery: string;
-    getOptions: () => {
-        session: string;
-    };
-    async: () => (error: Error | null, code?: string, map?: unknown) => void;
-    addDependency: (file: string) => void;
-    emitWarning: (warning: Error) => void;
+  resourcePath: string;
+  resourceQuery: string;
+  getOptions: () => {
+    session: string;
+  };
+  async: () => (error: Error | null, code?: string, map?: unknown) => void;
+  addDependency: (file: string) => void;
+  emitWarning: (warning: Error) => void;
 };
 export default function kiranaLoader(this: LoaderContext, source: string, map?: unknown): void;
+//#endregion

package/src/loader.js

@@ -1,51 +1,43 @@
-/**
- * The loader half of the webpack and Rspack adapter (KRN-INT-001): it compiles one module, or
- * answers the stylesheet entry with the placeholder rule the plugin later replaces. The plugin
- * registers it as a `pre` loader, so it sees the source before any other loader strips types or JSX.
- */
-import { PLACEHOLDER, shouldCompile } from "@kirana-style/compiler/host";
 import { sessions } from "./session.js";
-export default function kiranaLoader(source, map) {
-    const callback = this.async();
-    const session = sessions.get(this.getOptions().session);
-    if (!session) {
-        callback(new Error("@kirana-style/webpack/loader runs only through the Kirana plugin: add `new KiranaPlugin()` to `plugins`"));
-        return;
-    }
-    const file = this.resourcePath;
-    session
-        .driver()
-        .then((driver) => {
-        // In a build the plugin writes the finished stylesheet into the emitted asset; while watching,
-        // the entry is the live stylesheet (see index.ts).
-        if (file === session.stylesheetFile) {
-            if (session.live) {
-                this.addDependency(session.live);
-                callback(null, driver.stylesheet(false));
-            }
-            else
-                callback(null, PLACEHOLDER);
-            return;
-        }
-        if (!shouldCompile(file + this.resourceQuery, source, driver.libraries)) {
-            callback(null, source, map);
-            return;
-        }
-        const result = driver.transform(file, source);
-        session.compiled.add(file);
-        for (const dependency of result.dependencies)
-            this.addDependency(dependency);
-        session.reporter.module({
-            warn: (message) => this.emitWarning(new Error(message)),
-            error: (message) => {
-                throw new Error(message);
-            },
-        }, file, source, result.diagnostics);
-        if (result.code === undefined)
-            callback(null, source, map);
-        // An object, as loaders pass maps to each other: Next.js's SWC loader encodes a string again.
-        else
-            callback(null, result.code, result.map && JSON.parse(result.map));
-    })
-        .catch((error) => callback(error));
+import { PLACEHOLDER, shouldCompile } from "@kirana-style/compiler/host";
+//#region src/loader.ts
+/**
+* The loader half of the webpack and Rspack adapter (KRN-INT-001): it compiles one module, or
+* answers the stylesheet entry with the placeholder rule the plugin later replaces. The plugin
+* registers it as a `pre` loader, so it sees the source before any other loader strips types or JSX.
+*/
+function kiranaLoader(source, map) {
+	const callback = this.async();
+	const session = sessions.get(this.getOptions().session);
+	if (!session) {
+		callback(/* @__PURE__ */ new Error("@kirana-style/webpack/loader runs only through the Kirana plugin: add `new KiranaPlugin()` to `plugins`"));
+		return;
+	}
+	const file = this.resourcePath;
+	session.driver().then((driver) => {
+		if (file === session.stylesheetFile) {
+			if (session.live) {
+				this.addDependency(session.live);
+				callback(null, driver.stylesheet(false));
+			} else callback(null, PLACEHOLDER);
+			return;
+		}
+		if (!shouldCompile(file + this.resourceQuery, source, driver.libraries)) {
+			callback(null, source, map);
+			return;
+		}
+		const result = driver.transform(file, source);
+		session.compiled.add(file);
+		for (const dependency of result.dependencies) this.addDependency(dependency);
+		session.reporter.module({
+			warn: (message) => this.emitWarning(new Error(message)),
+			error: (message) => {
+				throw new Error(message);
+			}
+		}, file, source, result.diagnostics);
+		if (result.code === void 0) callback(null, source, map);
+		else callback(null, result.code, result.map && JSON.parse(result.map));
+	}).catch((error) => callback(error));
 }
+//#endregion
+export { kiranaLoader as default };

package/src/next.d.ts

@@ -1,13 +1,14 @@
-import type { KiranaWebpackOptions } from "./session.ts";
+import { KiranaWebpackOptions } from "./session.js";
+//#region src/next.d.ts
 type WebpackConfig = {
-    plugins?: unknown[];
+  plugins?: unknown[];
 };
 type NextContext = {
-    dir: string;
+  dir: string;
 };
 type NextConfig = {
-    webpack?: (config: WebpackConfig, context: NextContext) => WebpackConfig;
-    [key: string]: unknown;
+  webpack?: (config: WebpackConfig, context: NextContext) => WebpackConfig;
+  [key: string]: unknown;
 };
 export declare function withKirana<Config extends NextConfig>(nextConfig?: Config, options?: KiranaWebpackOptions): Omit<Config, "webpack"> & Required<Pick<NextConfig, "webpack">>;
-export {};
+//#endregion

package/src/next.js

@@ -1,16 +1,21 @@
-/**
- * Next.js with webpack (`next build --webpack`, KRN-INT-003): `withKirana` adds the plugin to every
- * compiler Next creates — server, client and edge — at the project directory, and keeps any
- * `webpack` function the configuration already has. For Turbopack, `@kirana-style/next` configures both.
- */
 import { KiranaPlugin } from "./index.js";
-export function withKirana(nextConfig = {}, options = {}) {
-    return {
-        ...nextConfig,
-        webpack(config, context) {
-            ;
-            (config.plugins ??= []).push(new KiranaPlugin({ root: context.dir, ...options }));
-            return nextConfig.webpack ? nextConfig.webpack(config, context) : config;
-        },
-    };
+//#region src/next.ts
+/**
+* Next.js with webpack (`next build --webpack`, KRN-INT-003): `withKirana` adds the plugin to every
+* compiler Next creates — server, client and edge — at the project directory, and keeps any
+* `webpack` function the configuration already has. For Turbopack, `@kirana-style/next` configures both.
+*/
+function withKirana(nextConfig = {}, options = {}) {
+	return {
+		...nextConfig,
+		webpack(config, context) {
+			(config.plugins ??= []).push(new KiranaPlugin({
+				root: context.dir,
+				...options
+			}));
+			return nextConfig.webpack ? nextConfig.webpack(config, context) : config;
+		}
+	};
 }
+//#endregion
+export { withKirana };

package/src/session.d.ts

@@ -1,43 +1,38 @@
-/**
- * What the plugin and the loader share: one Driver per compiler, found by an id the plugin puts in
- * the loader's options. An id rather than the object, because Rspack hands loader options across its
- * JavaScript–Rust boundary as data.
- */
-import { Driver } from "@kirana-style/compiler";
-import type { DriverOptions } from "@kirana-style/compiler";
+import { Driver, DriverOptions } from "@kirana-style/compiler";
 import { createReporter } from "@kirana-style/compiler/host";
-import type { KiranaConfig } from "@kirana-style/core/config";
+import { KiranaConfig } from "@kirana-style/core/config";
+//#region src/session.d.ts
 export type KiranaWebpackOptions = {
-    /** The project root: where `kirana.config.*` and `@kirana-style/core` are found. Default: the compiler's context. */
-    root?: string;
-    /** Options that override `kirana.config.*`. */
-    config?: KiranaConfig;
-    /** Report `info` diagnostics (such as `dynamic-bridged`) as warnings. */
-    reportInfo?: boolean;
-    /** Injected Driver options (tests). */
-    driver?: Pick<DriverOptions, "native" | "importModule">;
-    /** The loader's path, in place of this package's (tests: one instance of the loader to measure). */
-    loader?: string;
+  /** The project root: where `kirana.config.*` and `@kirana-style/core` are found. Default: the compiler's context. */
+  root?: string;
+  /** Options that override `kirana.config.*`. */
+  config?: KiranaConfig;
+  /** Report `info` diagnostics (such as `dynamic-bridged`) as warnings. */
+  reportInfo?: boolean;
+  /** Injected Driver options (tests). */
+  driver?: Pick<DriverOptions, "native" | "importModule">;
+  /** The loader's path, in place of this package's (tests: one instance of the loader to measure). */
+  loader?: string;
 };
 export type Session = {
-    root: string;
-    /** `@kirana-style/core/stylesheet.css` as the compiler resolves it. */
-    stylesheetFile: string;
-    minify: boolean;
-    driver: () => Promise<Driver>;
-    reporter: ReturnType<typeof createReporter>;
-    /**
-     * The scripts this process's loader compiled. A persistent cache (`cache: { type: "filesystem" }`,
-     * which Meteor turns on) hands back a module without running loaders, so the plugin compiles the
-     * rest from disk before it writes the stylesheet.
-     */
-    compiled: Set<string>;
-    /**
-     * Set while the compiler watches (a dev server, `--watch`): the stylesheet entry then holds the
-     * live stylesheet and depends on this file, which the plugin rewrites when the stylesheet changes
-     * so the bundler rebuilds the entry and sends its own CSS hot update (KRN-INT-009).
-     */
-    live?: string;
+  root: string;
+  /** `@kirana-style/core/stylesheet.css` as the compiler resolves it. */
+  stylesheetFile: string;
+  minify: boolean;
+  driver: () => Promise<Driver>;
+  reporter: ReturnType<typeof createReporter>;
+  /**
+   * The scripts this process's loader compiled. A persistent cache (`cache: { type: "filesystem" }`,
+   * which Meteor turns on) hands back a module without running loaders, so the plugin compiles the
+   * rest from disk before it writes the stylesheet.
+   */
+  compiled: Set<string>;
+  /**
+   * Set while the compiler watches (a dev server, `--watch`): the stylesheet entry then holds the
+   * live stylesheet and depends on this file, which the plugin rewrites when the stylesheet changes
+   * so the bundler rebuilds the entry and sends its own CSS hot update (KRN-INT-009).
+   */
+  live?: string;
 };
 /**
  * Registries live on `globalThis` under registered symbols, because the loader is loaded by the
@@ -46,3 +41,4 @@ export type Session = {
  */
 export declare const sessions: Map<string, Session>;
 export declare function createSession(options: KiranaWebpackOptions, root: string, stylesheetFile: string, minify: boolean): string;
+//#endregion

package/src/session.js

@@ -1,51 +1,57 @@
-/**
- * What the plugin and the loader share: one Driver per compiler, found by an id the plugin puts in
- * the loader's options. An id rather than the object, because Rspack hands loader options across its
- * JavaScript–Rust boundary as data.
- */
 import { Driver } from "@kirana-style/compiler";
 import { createReporter } from "@kirana-style/compiler/host";
+//#region src/session.ts
+/**
+* What the plugin and the loader share: one Driver per compiler, found by an id the plugin puts in
+* the loader's options. An id rather than the object, because Rspack hands loader options across its
+* JavaScript–Rust boundary as data.
+*/
 /**
- * Registries live on `globalThis` under registered symbols, because the loader is loaded by the
- * bundler's own module loader and may be a second instance of this module (a test runner's, or a
- * duplicated install); every instance must find the same entries.
- */
-export const sessions = registry("sessions");
+* Registries live on `globalThis` under registered symbols, because the loader is loaded by the
+* bundler's own module loader and may be a second instance of this module (a test runner's, or a
+* duplicated install); every instance must find the same entries.
+*/
+const sessions = registry("sessions");
 /**
- * One Driver and one reporter per project — root and configuration — shared by every compiler that
- * builds it. Next.js runs a server, an edge and a client compiler over one app: a server component is
- * compiled only by the server compiler while the stylesheet is emitted by the client one, so a Driver
- * per compiler would leave the client's stylesheet without the server components' atoms. Next.js builds
- * the server first, so the client's stylesheet, filled at the end of its own build, holds them all.
- * Sharing also reports a module's warnings once rather than once per compiler.
- */
+* One Driver and one reporter per project — root and configuration — shared by every compiler that
+* builds it. Next.js runs a server, an edge and a client compiler over one app: a server component is
+* compiled only by the server compiler while the stylesheet is emitted by the client one, so a Driver
+* per compiler would leave the client's stylesheet without the server components' atoms. Next.js builds
+* the server first, so the client's stylesheet, filled at the end of its own build, holds them all.
+* Sharing also reports a module's warnings once rather than once per compiler.
+*/
 const projects = registry("projects");
 function registry(name) {
-    return (globalThis[Symbol.for(`kirana.webpack.${name}`)] ??= new Map());
+	return globalThis[Symbol.for(`kirana.webpack.${name}`)] ??= /* @__PURE__ */ new Map();
 }
-export function createSession(options, root, stylesheetFile, minify) {
-    const id = `kirana-${sessions.size}`;
-    const key = JSON.stringify([
-        root,
-        options.config ?? null,
-        options.reportInfo ?? false,
-    ]);
-    // Injected engines (tests) are never shared, in either direction.
-    let project = options.driver ? undefined : projects.get(key);
-    if (!project) {
-        let driver;
-        project = {
-            driver: () => (driver ??= Driver.create({
-                root,
-                config: options.config,
-                ...options.driver,
-            })),
-            reporter: createReporter(options),
-            compiled: new Set(),
-        };
-        if (!options.driver)
-            projects.set(key, project);
-    }
-    sessions.set(id, { root, stylesheetFile, minify, ...project });
-    return id;
+function createSession(options, root, stylesheetFile, minify) {
+	const id = `kirana-${sessions.size}`;
+	const key = JSON.stringify([
+		root,
+		options.config ?? null,
+		options.reportInfo ?? false
+	]);
+	let project = options.driver ? void 0 : projects.get(key);
+	if (!project) {
+		let driver;
+		project = {
+			driver: () => driver ??= Driver.create({
+				root,
+				config: options.config,
+				...options.driver
+			}),
+			reporter: createReporter(options),
+			compiled: /* @__PURE__ */ new Set()
+		};
+		if (!options.driver) projects.set(key, project);
+	}
+	sessions.set(id, {
+		root,
+		stylesheetFile,
+		minify,
+		...project
+	});
+	return id;
 }
+//#endregion
+export { createSession, sessions };