@kirana-style/astro 0.0.0-stage → 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/package.json

@@ -1,6 +1,50 @@
 {
   "name": "@kirana-style/astro",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.2.0",
+  "description": "Kirana for Astro: the integration that compiles .astro components and finishes the stylesheet.",
+  "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/astro"
+  },
+  "bugs": {
+    "url": "https://github.com/kirana-style/kirana/issues"
+  },
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "types": "./src/index.d.ts",
+      "default": "./src/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "dependencies": {
+    "@kirana-style/compiler": "0.2.0",
+    "@kirana-style/core": "0.2.0",
+    "@kirana-style/vite": "0.2.0"
+  },
+  "peerDependencies": {
+    "astro": ">=5.0.0"
+  },
+  "files": [
+    "src",
+    "bin",
+    "*.d.ts",
+    "*.css",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE",
+    "builders.json",
+    "schemas",
+    "gatsby-node.mjs",
+    "rules",
+    "recommended.json",
+    "strict.json"
+  ]
+}

package/src/index.d.ts

@@ -0,0 +1,28 @@
+import { KiranaViteOptions } from "@kirana-style/vite";
+//#region src/index.d.ts
+export type KiranaAstroOptions = Omit<KiranaViteOptions, "renameStylesheet">;
+/**
+ * Renames each filled stylesheet in `outDir` by its content hash and replaces its old name in every
+ * text file there. Returns the renames, old name to new.
+ */
+export declare function renameStylesheets(outDir: string, filled: Iterable<string>): Promise<Map<string, string>>;
+type Hooks = {
+  "astro:config:setup": (options: {
+    updateConfig: (config: {
+      vite: {
+        plugins: unknown[];
+      };
+    }) => void;
+  }) => void;
+  "astro:config:done": (options: {
+    config: {
+      outDir: URL;
+    };
+  }) => void;
+  "astro:build:done": () => Promise<void>;
+};
+export default function kirana(options?: KiranaAstroOptions): {
+  name: string;
+  hooks: Hooks;
+};
+//#endregion

package/src/index.js

@@ -0,0 +1,71 @@
+import { readFile, readdir, rename, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { renameAsset } from "@kirana-style/compiler/host";
+import vite from "@kirana-style/vite";
+//#region src/index.ts
+/**
+* The Astro integration (KRN-INT-004): `@kirana-style/vite` for Astro's Vite, which compiles `.astro`
+* components as they are read (`design-notes/sfc-masking.md`), plus the one step Astro needs after
+* its build. Astro links each page's stylesheet — or inlines a small one — by the name and content it
+* recorded before the bundle was finished, so the Vite plugin fills the stylesheet in place, and once
+* Astro has written every page this integration renames the file by its real content and rewrites
+* every reference to it.
+*/
+/** Files whose text can name the stylesheet: pages, server chunks, manifests, other stylesheets. */
+const TEXT = /\.(?:html|m?js|json|css)$/;
+/** Every file under a directory. */
+async function files(directory) {
+	return (await readdir(directory, {
+		recursive: true,
+		withFileTypes: true
+	})).filter((entry) => entry.isFile()).map((entry) => path.join(entry.parentPath, entry.name));
+}
+/**
+* Renames each filled stylesheet in `outDir` by its content hash and replaces its old name in every
+* text file there. Returns the renames, old name to new.
+*/
+async function renameStylesheets(outDir, filled) {
+	const all = await files(outDir);
+	const renames = /* @__PURE__ */ new Map();
+	for (const fileName of filled) {
+		const base = path.posix.basename(fileName);
+		for (const file of all.filter((candidate) => path.basename(candidate) === base)) {
+			const next = path.basename(renameAsset(base, await readFile(file, "utf8")));
+			if (next === base) continue;
+			await rename(file, path.join(path.dirname(file), next));
+			renames.set(base, next);
+		}
+	}
+	if (renames.size === 0) return renames;
+	for (const file of await files(outDir)) {
+		if (!TEXT.test(file)) continue;
+		const text = await readFile(file, "utf8");
+		let next = text;
+		for (const [from, to] of renames) next = next.replaceAll(from, to);
+		if (next !== text) await writeFile(file, next);
+	}
+	return renames;
+}
+function kirana(options = {}) {
+	const plugins = vite({
+		...options,
+		renameStylesheet: false
+	});
+	const { filled } = plugins[0].api;
+	let outDir = "";
+	return {
+		name: "@kirana-style/astro",
+		hooks: {
+			"astro:config:setup": ({ updateConfig }) => updateConfig({ vite: { plugins } }),
+			"astro:config:done": ({ config }) => {
+				outDir = fileURLToPath(config.outDir);
+			},
+			"astro:build:done": async () => {
+				await renameStylesheets(outDir, filled);
+			}
+		}
+	};
+}
+//#endregion
+export { kirana as default, renameStylesheets };

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-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.