@kirana-style/esbuild 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

@@ -15,6 +15,6 @@ await esbuild.build({
 ```
 
 `onLoad` compiles modules that carry styles; the stylesheet entry loads as a placeholder esbuild
-bundles as CSS, and `onEnd` writes the finished stylesheet into it — on disk, or in `outputFiles`
+bundles as CSS, and `onEnd` writes the finished stylesheet into it, on disk or in `outputFiles`
 with `write: false`. Under `context().watch()` and `serve()` the entry reloads from a file the plugin
 keeps current, so the served stylesheet follows every edit.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kirana-style/esbuild",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Kirana for esbuild: compiles modules and finishes the stylesheet esbuild bundles.",
   "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",
@@ -22,8 +25,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": {
     "esbuild": ">=0.25.0"
@@ -34,6 +37,8 @@
     "*.d.ts",
     "*.css",
     "README.md",
+    "CHANGELOG.md",
+    "LICENSE",
     "builders.json",
     "schemas",
     "gatsby-node.mjs",

package/src/index.d.ts

@@ -1,14 +1,16 @@
-import type { DriverOptions } from "@kirana-style/compiler";
-import type { KiranaConfig } from "@kirana-style/core/config";
-import type { Plugin } from "esbuild";
+import { DriverOptions } from "@kirana-style/compiler";
+import { KiranaConfig } from "@kirana-style/core/config";
+import { Plugin } from "esbuild";
+//#region src/index.d.ts
 export type KiranaEsbuildOptions = {
-    /** 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;
-    /** Report `info` diagnostics (such as `dynamic-bridged`) as warnings. */
-    reportInfo?: boolean;
-    /** Injected Driver options (tests). */
-    driver?: Pick<DriverOptions, "native" | "importModule">;
+  /** 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;
+  /** Report `info` diagnostics (such as `dynamic-bridged`) as warnings. */
+  reportInfo?: boolean;
+  /** Injected Driver options (tests). */
+  driver?: Pick<DriverOptions, "native" | "importModule">;
 };
 export default function kirana(options?: KiranaEsbuildOptions): Plugin;
+//#endregion

package/src/index.js

@@ -1,111 +1,102 @@
-/**
- * The esbuild host adapter (KRN-INT-001, KRN-INT-003): `onLoad` compiles modules, and `onEnd` writes
- * the finished stylesheet into the CSS esbuild bundled. It never interprets styles (D-028).
- *
- * The stylesheet entry loads as the placeholder rule, which esbuild bundles like any CSS import
- * (`main.css` beside `main.js`); once every module has loaded, the plugin replaces it — in the written
- * file, or in `outputFiles` when esbuild keeps them in memory (`write: false`). Watch and serve reload
- * the entry itself from a file the plugin keeps current, so what `serve` sends follows every edit. A
- * `naming` pattern that hashes CSS keeps the placeholder's hash.
- */
 import { createHash } from "node:crypto";
 import { existsSync, writeFileSync } from "node:fs";
 import { readFile, writeFile } from "node:fs/promises";
 import { tmpdir } from "node:os";
 import path from "node:path";
 import { Driver } from "@kirana-style/compiler";
-import { PLACEHOLDER, createReporter, fillStylesheet, shouldCompile, stylesheetPath, } from "@kirana-style/compiler/host";
+import { PLACEHOLDER, createReporter, fillStylesheet, shouldCompile, stylesheetPath } from "@kirana-style/compiler/host";
+//#region src/index.ts
+/**
+* The esbuild host adapter (KRN-INT-001, KRN-INT-003): `onLoad` compiles modules, and `onEnd` writes
+* the finished stylesheet into the CSS esbuild bundled. It never interprets styles (D-028).
+*
+* The stylesheet entry loads as the placeholder rule, which esbuild bundles like any CSS import
+* (`main.css` beside `main.js`); once every module has loaded, the plugin replaces it — in the written
+* file, or in `outputFiles` when esbuild keeps them in memory (`write: false`). Watch and serve reload
+* the entry itself from a file the plugin keeps current, so what `serve` sends follows every edit. A
+* `naming` pattern that hashes CSS keeps the placeholder's hash.
+*/
 const LOADERS = {
-    tsx: "tsx",
-    ts: "ts",
-    mts: "ts",
-    cts: "ts",
-    jsx: "jsx",
+	tsx: "tsx",
+	ts: "ts",
+	mts: "ts",
+	cts: "ts",
+	jsx: "jsx"
 };
 /** An output file with new text, in the shape esbuild gives them. */
 function outputFile(file, text) {
-    return { ...file, contents: new TextEncoder().encode(text), text };
+	return {
+		...file,
+		contents: new TextEncoder().encode(text),
+		text
+	};
 }
-export default function kirana(options = {}) {
-    return {
-        name: "kirana",
-        setup(build) {
-            const root = options.root ?? process.cwd();
-            const stylesheetFile = stylesheetPath(root);
-            // The written outputs are found through the metafile.
-            build.initialOptions.metafile = true;
-            let driver;
-            const session = () => (driver ??= Driver.create({
-                root,
-                config: options.config,
-                ...options.driver,
-            }));
-            const reporter = createReporter(options);
-            const context = {
-                warn: (message) => console.warn(message),
-                error: (message) => {
-                    throw new Error(message);
-                },
-            };
-            // Watch and serve: the entry follows a file `onEnd` writes whenever the stylesheet changes, so a
-            // rebuild reloads it with the live stylesheet — which is what `serve` sends, from its own
-            // copy of the outputs. The first load, and every load of a one-shot build, is the placeholder.
-            const live = path.join(tmpdir(), `kirana-esbuild-${createHash("sha256").update(root).digest("hex").slice(0, 12)}.css`);
-            let written;
-            writeFileSync(live, "");
-            build.onLoad({ filter: /stylesheet\.css$/ }, async ({ path: file }) => file === stylesheetFile
-                ? {
-                    contents: written === undefined
-                        ? PLACEHOLDER
-                        : (await session()).stylesheet(Boolean(build.initialOptions.minify)),
-                    loader: "css",
-                    watchFiles: [live],
-                }
-                : undefined);
-            build.onLoad({ filter: /\.[cm]?[jt]sx?$/ }, async ({ path: file }) => {
-                const compiler = await session();
-                if (!compiler.compiles(file))
-                    return undefined;
-                const code = await readFile(file, "utf8");
-                if (!shouldCompile(file, code, compiler.libraries))
-                    return undefined;
-                const result = compiler.transform(file, code);
-                reporter.module(context, file, code, result.diagnostics);
-                if (result.code === undefined)
-                    return undefined;
-                return {
-                    contents: result.code,
-                    loader: LOADERS[file.slice(file.lastIndexOf(".") + 1)] ?? "js",
-                };
-            });
-            build.onEnd(async (result) => {
-                const compiler = await session();
-                reporter.project(context, root, compiler.diagnostics());
-                const css = compiler.stylesheet(Boolean(build.initialOptions.minify));
-                if (css !== written) {
-                    written = css;
-                    await writeFile(live, css);
-                }
-                if (result.outputFiles) {
-                    result.outputFiles.forEach((file, index) => {
-                        const source = file.path.endsWith(".css")
-                            ? fillStylesheet(file.text, css)
-                            : undefined;
-                        if (source !== undefined)
-                            result.outputFiles[index] = outputFile(file, source);
-                    });
-                    return;
-                }
-                const base = build.initialOptions.absWorkingDir ?? process.cwd();
-                for (const output of Object.keys(result.metafile.outputs)) {
-                    const file = path.resolve(base, output);
-                    if (!file.endsWith(".css") || !existsSync(file))
-                        continue;
-                    const source = fillStylesheet(await readFile(file, "utf8"), css);
-                    if (source !== undefined)
-                        await writeFile(file, source);
-                }
-            });
-        },
-    };
+function kirana(options = {}) {
+	return {
+		name: "kirana",
+		setup(build) {
+			const root = options.root ?? process.cwd();
+			const stylesheetFile = stylesheetPath(root);
+			build.initialOptions.metafile = true;
+			let driver;
+			const session = () => driver ??= Driver.create({
+				root,
+				config: options.config,
+				...options.driver
+			});
+			const reporter = createReporter(options);
+			const context = {
+				warn: (message) => console.warn(message),
+				error: (message) => {
+					throw new Error(message);
+				}
+			};
+			const live = path.join(tmpdir(), `kirana-esbuild-${createHash("sha256").update(root).digest("hex").slice(0, 12)}.css`);
+			let written;
+			writeFileSync(live, "");
+			build.onLoad({ filter: /stylesheet\.css$/ }, async ({ path: file }) => file === stylesheetFile ? {
+				contents: written === void 0 ? PLACEHOLDER : (await session()).stylesheet(Boolean(build.initialOptions.minify)),
+				loader: "css",
+				watchFiles: [live]
+			} : void 0);
+			build.onLoad({ filter: /\.[cm]?[jt]sx?$/ }, async ({ path: file }) => {
+				const compiler = await session();
+				if (!compiler.compiles(file)) return void 0;
+				const code = await readFile(file, "utf8");
+				if (!shouldCompile(file, code, compiler.libraries)) return void 0;
+				const result = compiler.transform(file, code);
+				reporter.module(context, file, code, result.diagnostics);
+				if (result.code === void 0) return void 0;
+				return {
+					contents: result.code,
+					loader: LOADERS[file.slice(file.lastIndexOf(".") + 1)] ?? "js"
+				};
+			});
+			build.onEnd(async (result) => {
+				const compiler = await session();
+				reporter.project(context, root, compiler.diagnostics());
+				const css = compiler.stylesheet(Boolean(build.initialOptions.minify));
+				if (css !== written) {
+					written = css;
+					await writeFile(live, css);
+				}
+				if (result.outputFiles) {
+					result.outputFiles.forEach((file, index) => {
+						const source = file.path.endsWith(".css") ? fillStylesheet(file.text, css) : void 0;
+						if (source !== void 0) result.outputFiles[index] = outputFile(file, source);
+					});
+					return;
+				}
+				const base = build.initialOptions.absWorkingDir ?? process.cwd();
+				for (const output of Object.keys(result.metafile.outputs)) {
+					const file = path.resolve(base, output);
+					if (!file.endsWith(".css") || !existsSync(file)) continue;
+					const source = fillStylesheet(await readFile(file, "utf8"), css);
+					if (source !== void 0) await writeFile(file, source);
+				}
+			});
+		}
+	};
 }
+//#endregion
+export { kirana as default };