@kirana-style/astro 0.0.0-stage → 0.1.0

package/package.json

@@ -1,6 +1,45 @@
 {
   "name": "@kirana-style/astro",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.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",
+  "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",
+    "@kirana-style/vite": "0.1.0"
+  },
+  "peerDependencies": {
+    "astro": ">=5.0.0"
+  },
+  "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,27 @@
+import type { KiranaViteOptions } from "@kirana-style/vite";
+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;
+};
+export {};

package/src/index.js

@@ -0,0 +1,73 @@
+/**
+ * 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.
+ */
+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";
+/** 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) {
+    const entries = await readdir(directory, {
+        recursive: true,
+        withFileTypes: true,
+    });
+    return entries
+        .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.
+ */
+export async function renameStylesheets(outDir, filled) {
+    const all = await files(outDir);
+    const renames = 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;
+}
+export default 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);
+            },
+        },
+    };
+}

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.