@ascribed/astro 0.1.0

package/dist/content.js

@@ -0,0 +1,27 @@
+// The content collection over a build's site output. Import it from
+// `content.config.ts`, which Vite loads, so it can read what the integration
+// resolved (`virtual:ascribe/site`) instead of finding the project itself.
+//
+//   import { defineCollection } from "astro:content";
+//   import { ascribeCollection } from "@ascribed/astro/content";
+//   import { schema } from "../.ascribe/build/site/site/_ascribe/schema.ts";
+//   export const collections = { docs: defineCollection(ascribeCollection({ schema })) };
+import { pathToFileURL } from "node:url";
+import path from "node:path";
+import { glob } from "astro/loaders";
+import { siteRoot } from "virtual:ascribe/site";
+/**
+ * The collection's loader and schema: the `glob` loader on the site output's
+ * pages, with the generated Zod schema (`_ascribe/schema.ts`'s `schema`).
+ *
+ * Entry ids are Astro's own (`guides/my-setup` for `Guides/My Setup.md`, `index`
+ * for the root page), which is what `AstroRouter` in `tessera-resolve`
+ * computes, so a page's route is the base path plus its id, and the root page is
+ * at the base path itself.
+ */
+export function ascribeCollection(options) {
+    // `_ascribe/` holds the schema and published files, never pages.
+    const base = pathToFileURL(siteRoot + path.sep);
+    return { loader: glob({ pattern: ["**/*.md", "!_ascribe/**"], base }), schema: options.schema };
+}
+//# sourceMappingURL=content.js.map

package/dist/content.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content.js","sourceRoot":"","sources":["../src/content.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,6EAA6E;AAC7E,2EAA2E;AAC3E,EAAE;AACF,sDAAsD;AACtD,iEAAiE;AACjE,6EAA6E;AAC7E,0FAA0F;AAC1F,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAEhD;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAAI,OAAsB;IAIzD,iEAAiE;IACjE,MAAM,IAAI,GAAG,aAAa,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;IAChD,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC,SAAS,EAAE,cAAc,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;AAClG,CAAC"}

package/dist/dev.d.ts

@@ -0,0 +1,25 @@
+import type { AstroIntegration } from "astro";
+import { type ProjectInfo } from "./project.js";
+type ServerOptions = Parameters<NonNullable<AstroIntegration["hooks"]["astro:server:setup"]>>[0];
+/**
+ * The assets a build copied from outside the content root, as absolute paths,
+ * read from the site output's manifest. Watching the content root doesn't
+ * cover them. A manifest that's missing or unreadable gives none: the next
+ * successful build writes one.
+ */
+export declare function outsideAssets(project: ProjectInfo, build: string): string[];
+/** Watch source files, serialize compiler runs, and refresh Astro after successful output. */
+export declare function watchDev(options: {
+    server: ServerOptions["server"];
+    refreshContent: () => Promise<void>;
+    logger: ServerOptions["logger"];
+    project: ProjectInfo;
+    astro: {
+        base: string;
+        trailingSlash: string;
+        site: string | undefined;
+    };
+    build: string;
+    rebuild: () => Promise<void>;
+}): void;
+export {};

package/dist/dev.js

@@ -0,0 +1,135 @@
+import { readFileSync } from "node:fs";
+import path from "node:path";
+import { consumerMismatches, readProject } from "./project.js";
+/**
+ * The assets a build copied from outside the content root, as absolute paths,
+ * read from the site output's manifest. Watching the content root doesn't
+ * cover them. A manifest that's missing or unreadable gives none: the next
+ * successful build writes one.
+ */
+export function outsideAssets(project, build) {
+    const manifest = path.join(path.dirname(project.siteRoot(build)), "site.manifest.json");
+    let files;
+    try {
+        files = JSON.parse(readFileSync(manifest, "utf8")).files;
+    }
+    catch {
+        return [];
+    }
+    if (!Array.isArray(files))
+        return [];
+    const assets = new Set();
+    for (const entry of files) {
+        if (entry.kind !== "asset" || typeof entry.source !== "string")
+            continue;
+        const absolute = path.resolve(project.contentRoot, entry.source);
+        if (!absolute.startsWith(project.contentRoot + path.sep))
+            assets.add(absolute);
+    }
+    return [...assets].sort();
+}
+/** Watch source files, serialize compiler runs, and refresh Astro after successful output. */
+export function watchDev(options) {
+    const { server, refreshContent, logger, rebuild } = options;
+    let project = options.project;
+    let timer;
+    let pending = Promise.resolve();
+    let dirty = false;
+    let running = false;
+    let failed = false;
+    let assets = new Set();
+    const watchAssets = () => {
+        assets = new Set(outsideAssets(project, options.build));
+        if (assets.size > 0)
+            server.watcher.add([...assets]);
+    };
+    const drain = async () => {
+        running = true;
+        const previousProject = project;
+        const previousSiteRoot = previousProject.siteRoot(options.build);
+        while (dirty) {
+            dirty = false;
+            try {
+                await rebuild();
+                failed = false;
+            }
+            catch (error) {
+                failed = true;
+                logger.error(error instanceof Error ? error.message : String(error));
+            }
+        }
+        if (!failed) {
+            try {
+                const reloaded = readProject(project.dir);
+                if (reloaded.siteRoot(options.build) !== previousSiteRoot) {
+                    throw new Error("ascribe.toml changed output-dir; restart astro dev to reload the collection.");
+                }
+                const mismatches = consumerMismatches(reloaded, options.astro);
+                if (mismatches.length > 0) {
+                    throw new Error(`@ascribed/astro: ascribe.toml and astro.config disagree:\n- ${mismatches.join("\n- ")}`);
+                }
+                project = reloaded;
+                server.watcher.add(project.contentRoot);
+                server.watcher.add(project.configPath);
+                watchAssets();
+                await refreshContent();
+                server.ws.send({ type: "full-reload" });
+            }
+            catch (error) {
+                failed = true;
+                logger.error(`could not refresh Ascribe content: ${error instanceof Error ? error.message : String(error)}`);
+            }
+        }
+        running = false;
+    };
+    const schedule = () => {
+        if (timer)
+            clearTimeout(timer);
+        timer = setTimeout(() => {
+            timer = undefined;
+            pending = pending.then(drain);
+        }, 50);
+    };
+    const onChange = (event, file) => {
+        const absolute = path.resolve(file);
+        if ((absolute === project.configPath || assets.has(absolute)) &&
+            ["add", "change", "unlink"].includes(event)) {
+            dirty = true;
+            schedule();
+            return;
+        }
+        if (!["add", "change", "unlink"].includes(event) ||
+            !absolute.startsWith(project.contentRoot + path.sep) ||
+            absolute.startsWith(project.outputRoot + path.sep))
+            return;
+        dirty = true;
+        schedule();
+    };
+    server.watcher.add(project.contentRoot);
+    server.watcher.add(project.configPath);
+    watchAssets();
+    server.watcher.on("all", onChange);
+    server.httpServer?.once("close", () => {
+        if (timer)
+            clearTimeout(timer);
+        server.watcher.off("all", onChange);
+    });
+    server.middlewares.use((_req, res, next) => {
+        if (!dirty && !running && !failed)
+            return next();
+        if (timer) {
+            clearTimeout(timer);
+            timer = undefined;
+            pending = pending.then(drain);
+        }
+        void pending.then(() => {
+            if (failed) {
+                res.statusCode = 503;
+                res.end("Ascribe build failed; fix the source and save to retry.");
+            }
+            else
+                next();
+        });
+    });
+}
+//# sourceMappingURL=dev.js.map

package/dist/dev.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev.js","sourceRoot":"","sources":["../src/dev.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAoB,MAAM,cAAc,CAAC;AAIjF;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,OAAoB,EAAE,KAAa;IAC/D,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,oBAAoB,CAAC,CAAC;IACxF,IAAI,KAAc,CAAC;IACnB,IAAI,CAAC;QACH,KAAK,GAAI,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAyB,CAAC,KAAK,CAAC;IACpF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACrC,MAAM,MAAM,GAAG,IAAI,GAAG,EAAU,CAAC;IACjC,KAAK,MAAM,KAAK,IAAI,KAA+C,EAAE,CAAC;QACpE,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,IAAI,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ;YAAE,SAAS;QACzE,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QACjE,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC;YAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACjF,CAAC;IACD,OAAO,CAAC,GAAG,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;AAC5B,CAAC;AAED,8FAA8F;AAC9F,MAAM,UAAU,QAAQ,CAAC,OAQxB;IACC,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;IAC5D,IAAI,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAC9B,IAAI,KAAgD,CAAC;IACrD,IAAI,OAAO,GAAkB,OAAO,CAAC,OAAO,EAAE,CAAC;IAC/C,IAAI,KAAK,GAAG,KAAK,CAAC;IAClB,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,IAAI,MAAM,GAAG,KAAK,CAAC;IACnB,IAAI,MAAM,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,WAAW,GAAG,GAAG,EAAE;QACvB,MAAM,GAAG,IAAI,GAAG,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;QACxD,IAAI,MAAM,CAAC,IAAI,GAAG,CAAC;YAAE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC;IACvD,CAAC,CAAC;IAEF,MAAM,KAAK,GAAG,KAAK,IAAI,EAAE;QACvB,OAAO,GAAG,IAAI,CAAC;QACf,MAAM,eAAe,GAAG,OAAO,CAAC;QAChC,MAAM,gBAAgB,GAAG,eAAe,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACjE,OAAO,KAAK,EAAE,CAAC;YACb,KAAK,GAAG,KAAK,CAAC;YACd,IAAI,CAAC;gBACH,MAAM,OAAO,EAAE,CAAC;gBAChB,MAAM,GAAG,KAAK,CAAC;YACjB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,GAAG,IAAI,CAAC;gBACd,MAAM,CAAC,KAAK,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YACvE,CAAC;QACH,CAAC;QACD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;gBAC1C,IAAI,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,gBAAgB,EAAE,CAAC;oBAC1D,MAAM,IAAI,KAAK,CACb,8EAA8E,CAC/E,CAAC;gBACJ,CAAC;gBACD,MAAM,UAAU,GAAG,kBAAkB,CAAC,QAAQ,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;gBAC/D,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAC1B,MAAM,IAAI,KAAK,CACb,+DAA+D,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CACzF,CAAC;gBACJ,CAAC;gBACD,OAAO,GAAG,QAAQ,CAAC;gBACnB,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;gBACxC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;gBACvC,WAAW,EAAE,CAAC;gBACd,MAAM,cAAc,EAAE,CAAC;gBACvB,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC,CAAC;YAC1C,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,GAAG,IAAI,CAAC;gBACd,MAAM,CAAC,KAAK,CACV,sCAAsC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAC/F,CAAC;YACJ,CAAC;QACH,CAAC;QACD,OAAO,GAAG,KAAK,CAAC;IAClB,CAAC,CAAC;IACF,MAAM,QAAQ,GAAG,GAAG,EAAE;QACpB,IAAI,KAAK;YAAE,YAAY,CAAC,KAAK,CAAC,CAAC;QAC/B,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YACtB,KAAK,GAAG,SAAS,CAAC;YAClB,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC,EAAE,EAAE,CAAC,CAAC;IACT,CAAC,CAAC;IACF,MAAM,QAAQ,GAAG,CAAC,KAAa,EAAE,IAAY,EAAE,EAAE;QAC/C,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACpC,IACE,CAAC,QAAQ,KAAK,OAAO,CAAC,UAAU,IAAI,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACzD,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,EAC3C,CAAC;YACD,KAAK,GAAG,IAAI,CAAC;YACb,QAAQ,EAAE,CAAC;YACX,OAAO;QACT,CAAC;QACD,IACE,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC;YAC5C,CAAC,QAAQ,CAAC,UAAU,CAAC,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC;YACpD,QAAQ,CAAC,UAAU,CAAC,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC;YAElD,OAAO;QACT,KAAK,GAAG,IAAI,CAAC;QACb,QAAQ,EAAE,CAAC;IACb,CAAC,CAAC;IACF,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IACxC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACvC,WAAW,EAAE,CAAC;IACd,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACnC,MAAM,CAAC,UAAU,EAAE,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE;QACpC,IAAI,KAAK;YAAE,YAAY,CAAC,KAAK,CAAC,CAAC;QAC/B,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IACH,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QACzC,IAAI,CAAC,KAAK,IAAI,CAAC,OAAO,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,EAAE,CAAC;QACjD,IAAI,KAAK,EAAE,CAAC;YACV,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,KAAK,GAAG,SAAS,CAAC;YAClB,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC;QACD,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE;YACrB,IAAI,MAAM,EAAE,CAAC;gBACX,GAAG,CAAC,UAAU,GAAG,GAAG,CAAC;gBACrB,GAAG,CAAC,GAAG,CAAC,yDAAyD,CAAC,CAAC;YACrE,CAAC;;gBAAM,IAAI,EAAE,CAAC;QAChB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/files.d.ts

@@ -0,0 +1,7 @@
+import type { IncomingMessage, ServerResponse } from "node:http";
+/** The directory of published files inside a site output root. */
+export declare function publishedDir(siteRoot: string): string;
+/** Copies the published files to `<outDir>/_ascribe/files/`. Returns how many top-level entries were there. */
+export declare function copyPublishedFiles(siteRoot: string, outDir: URL): Promise<boolean>;
+/** A dev-server middleware serving the published files at `<base>_ascribe/files/`. */
+export declare function filesMiddleware(siteRoot: string, base: string): (req: IncomingMessage, res: ServerResponse, next: () => void) => void;

package/dist/files.js

@@ -0,0 +1,71 @@
+// Serving `_ascribe/files/`: the files pages link to that aren't pages or
+// images. Astro doesn't copy them, so the integration
+// does: into the build's output directory, and in dev through a middleware.
+// Both put them at `<base>_ascribe/files/`, the URL the site output links to.
+import { createReadStream } from "node:fs";
+import { cp, stat } from "node:fs/promises";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+/** The directory of published files inside a site output root. */
+export function publishedDir(siteRoot) {
+    return path.join(siteRoot, "_ascribe", "files");
+}
+/** Copies the published files to `<outDir>/_ascribe/files/`. Returns how many top-level entries were there. */
+export async function copyPublishedFiles(siteRoot, outDir) {
+    const from = publishedDir(siteRoot);
+    if (!(await stat(from).then((s) => s.isDirectory(), () => false)))
+        return false;
+    await cp(from, path.join(fileURLToPath(outDir), "_ascribe", "files"), { recursive: true });
+    return true;
+}
+const TYPES = {
+    ".pdf": "application/pdf",
+    ".zip": "application/zip",
+    ".json": "application/json",
+    ".yaml": "text/yaml; charset=utf-8",
+    ".yml": "text/yaml; charset=utf-8",
+    ".txt": "text/plain; charset=utf-8",
+    ".csv": "text/csv; charset=utf-8",
+    ".md": "text/markdown; charset=utf-8",
+    ".html": "text/html; charset=utf-8",
+    ".css": "text/css; charset=utf-8",
+    ".js": "text/javascript; charset=utf-8",
+    ".png": "image/png",
+    ".jpg": "image/jpeg",
+    ".jpeg": "image/jpeg",
+    ".gif": "image/gif",
+    ".webp": "image/webp",
+    ".svg": "image/svg+xml",
+};
+/** A dev-server middleware serving the published files at `<base>_ascribe/files/`. */
+export function filesMiddleware(siteRoot, base) {
+    const root = publishedDir(siteRoot);
+    // Only under the base path, as in the build. Vite strips the base from
+    // `req.url` before a plugin's middleware runs, but connect keeps the original in `originalUrl`.
+    const prefix = `${base}_ascribe/files/`;
+    return (req, res, next) => {
+        const pathname = (req.originalUrl ?? req.url ?? "").split(/[?#]/, 1)[0] ?? "";
+        if (!pathname.startsWith(prefix) || (req.method !== "GET" && req.method !== "HEAD"))
+            return next();
+        let relative;
+        try {
+            relative = decodeURIComponent(pathname.slice(prefix.length));
+        }
+        catch {
+            return next();
+        }
+        const file = path.resolve(root, relative);
+        if (file !== root && !file.startsWith(root + path.sep))
+            return next();
+        stat(file).then((info) => {
+            if (!info.isFile())
+                return next();
+            res.setHeader("Content-Type", TYPES[path.extname(file).toLowerCase()] ?? "application/octet-stream");
+            res.setHeader("Content-Length", info.size);
+            if (req.method === "HEAD")
+                return void res.end();
+            createReadStream(file).pipe(res);
+        }, () => next());
+    };
+}
+//# sourceMappingURL=files.js.map

package/dist/files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.js","sourceRoot":"","sources":["../src/files.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+import type { AstroIntegration } from "astro";
+export { default as rehypeAscribeAttributes } from "./rehype.js";
+export { satteriAscribeAttributes } from "./satteri.js";
+/** Options of the integration. */
+export interface AscribeOptions {
+    /** The build whose site output is the collection (a name in `ascribe.toml`). */
+    build: string;
+    /** The directory holding `ascribe.toml`, relative to the Astro root. Default: the root. */
+    project?: string;
+    /**
+     * The `ascribe` binary, relative to the Astro root. Default: `ASCRIBE_BIN`, then
+     * the platform binary installed with `@ascribed/cli`.
+     */
+    binary?: string;
+}
+/** Runs `ascribe build`, checks the site's routing, adds the markdown plugin, and serves published files. */
+export default function ascribe(options: AscribeOptions): AstroIntegration;

package/dist/index.js

@@ -0,0 +1,137 @@
+// @ascribed/astro: the Astro integration for Ascribe. Written against Astro
+// 7.3.5.
+//
+//   // astro.config.mjs
+//   import ascribe from "@ascribed/astro";
+//   export default defineConfig({
+//     base: "/docs", trailingSlash: "never",     // as in ascribe.toml's [consumer]
+//     integrations: [ascribe({ build: "site" })],
+//   });
+//
+//   // src/content.config.ts
+//   import { defineCollection } from "astro:content";
+//   import { ascribeCollection } from "@ascribed/astro/content";
+//   import { schema } from "../.ascribe/build/site/site/_ascribe/schema.ts";
+//   export const collections = { docs: defineCollection(ascribeCollection({ schema })) };
+//
+//   // a layout's <head>
+//   import Elements from "@ascribed/astro/Elements.astro";   // <Elements />
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { findBinary } from "./binary.js";
+import { watchDev } from "./dev.js";
+import { copyPublishedFiles, filesMiddleware } from "./files.js";
+import { consumerMismatches, readProject } from "./project.js";
+import rehypeAscribeAttributes from "./rehype.js";
+import { runBuild } from "./run.js";
+import { satteriAscribeAttributes } from "./satteri.js";
+export { default as rehypeAscribeAttributes } from "./rehype.js";
+export { satteriAscribeAttributes } from "./satteri.js";
+/** The virtual module `content.ts` reads the resolved site output root from. */
+const SITE_MODULE = "virtual:ascribe/site";
+/** Runs `ascribe build`, checks the site's routing, adds the markdown plugin, and serves published files. */
+export default function ascribe(options) {
+    let siteRoot = "";
+    let devProject;
+    let devConfig;
+    let rebuild;
+    return {
+        name: "@ascribed/astro",
+        hooks: {
+            "astro:config:setup": async ({ config, command, logger, updateConfig }) => {
+                const root = fileURLToPath(config.root);
+                const project = readProject(path.resolve(root, options.project ?? "."));
+                // An unknown build is `ascribe build`'s to report: it knows the implicit `site` build.
+                siteRoot = project.siteRoot(options.build);
+                // `ascribe.toml`'s routing must be Astro's, or every link Ascribe writes is wrong.
+                const problems = consumerMismatches(project, {
+                    base: config.base,
+                    trailingSlash: config.trailingSlash,
+                    site: config.site,
+                });
+                if (problems.length > 0) {
+                    throw new Error(`@ascribed/astro: ascribe.toml and astro.config disagree:\n- ${problems.join("\n- ")}`);
+                }
+                // Where a markdown plugin goes depends on the processor Astro 7.3 runs.
+                const processor = config.markdown.processor;
+                const pluginLists = processor.options;
+                if (processor.name === "satteri" && pluginLists.hastPlugins !== undefined) {
+                    pluginLists.hastPlugins.push(satteriAscribeAttributes());
+                }
+                else if (processor.name === "unified" && pluginLists.rehypePlugins !== undefined) {
+                    pluginLists.rehypePlugins.push(rehypeAscribeAttributes);
+                }
+                else {
+                    throw new Error(`@ascribed/astro: the markdown processor "${processor.name}" is not one it can add its plugin to. ` +
+                        "Use Astro's default (satteri) or unified(), or add `rehypeAscribeAttributes` to your own.");
+                }
+                devConfig = {
+                    base: config.base,
+                    trailingSlash: config.trailingSlash,
+                    site: config.site,
+                };
+                if (command !== "preview") {
+                    const binary = findBinary({ binary: options.binary, root });
+                    rebuild = async () => {
+                        logger.info(`running ${path.basename(binary)} build for "${options.build}"`);
+                        const result = await runBuild({
+                            binary,
+                            configPath: project.configPath,
+                            build: options.build,
+                            cwd: project.dir,
+                        });
+                        if (result.diagnostics !== "")
+                            logger.warn(result.diagnostics);
+                        if (result.summary !== "")
+                            logger.info(result.summary);
+                    };
+                    await rebuild();
+                    if (command === "dev")
+                        devProject = project;
+                }
+                // Dev serving of `_ascribe/files/`; the build copies them in `astro:build:done`.
+                updateConfig({
+                    vite: {
+                        // `Elements.astro` is Astro source, so Vite must compile it, not load it as a Node module.
+                        ssr: { noExternal: ["@ascribed/astro"] },
+                        plugins: [
+                            {
+                                name: "@ascribed/astro:site",
+                                resolveId: (id) => (id === SITE_MODULE ? `\0${SITE_MODULE}` : undefined),
+                                load: (id) => id === `\0${SITE_MODULE}`
+                                    ? `export const siteRoot = ${JSON.stringify(siteRoot)};`
+                                    : undefined,
+                            },
+                            {
+                                name: "@ascribed/astro:files",
+                                configureServer(server) {
+                                    server.middlewares.use(filesMiddleware(siteRoot, config.base.endsWith("/") ? config.base : `${config.base}/`));
+                                },
+                            },
+                        ],
+                    },
+                });
+            },
+            "astro:server:setup": ({ server, refreshContent, logger }) => {
+                if (devProject && rebuild && devConfig) {
+                    if (!refreshContent)
+                        throw new Error("@ascribed/astro: this Astro version does not support refreshContent.");
+                    watchDev({
+                        server,
+                        refreshContent: () => refreshContent({}),
+                        logger,
+                        project: devProject,
+                        astro: devConfig,
+                        build: options.build,
+                        rebuild,
+                    });
+                }
+            },
+            "astro:build:done": async ({ dir, logger }) => {
+                if (await copyPublishedFiles(siteRoot, dir))
+                    logger.info("copied _ascribe/files/");
+            },
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/project.d.ts

@@ -0,0 +1,33 @@
+/** The parts of an Ascribe project the integration reads. */
+export interface ProjectInfo {
+    /** The directory holding `ascribe.toml`. */
+    dir: string;
+    /** The path of `ascribe.toml`. */
+    configPath: string;
+    /** Source files and assets watched during development. */
+    contentRoot: string;
+    /** Generated output, never treated as a source change. */
+    outputRoot: string;
+    /** `[consumer]`, with the profile's defaults. */
+    consumer: {
+        site: string | undefined;
+        basePath: string;
+        trailingSlash: "always" | "never";
+    };
+    /** The site output's root for a build: `<output-dir>/<build>/site`. */
+    siteRoot(build: string): string;
+}
+/** Reads `ascribe.toml` in `dir`. Throws a readable error if it can't be read. */
+export declare function readProject(dir: string): ProjectInfo;
+/** A base path with a leading and a trailing `/`, as Ascribe's router has it. */
+export declare function normalizeBase(base: string): string;
+/**
+ * The ways `ascribe.toml`'s `[consumer]` disagrees with Astro's configuration,
+ * as sentences. Ascribe writes every link with its own settings, so a site
+ * whose routes differ would have broken links.
+ */
+export declare function consumerMismatches(project: ProjectInfo, astro: {
+    base: string;
+    trailingSlash: string;
+    site: string | undefined;
+}): string[];

package/dist/project.js

@@ -0,0 +1,79 @@
+// What the integration needs from `ascribe.toml`: where a build's site output
+// goes, and the consumer settings that must agree with `astro.config`.
+// The compiler validates the whole file; this reads
+// only what it compiled.
+import { readFileSync } from "node:fs";
+import path from "node:path";
+import { parse } from "smol-toml";
+/** Reads `ascribe.toml` in `dir`. Throws a readable error if it can't be read. */
+export function readProject(dir) {
+    const configPath = path.join(dir, "ascribe.toml");
+    let table;
+    try {
+        table = parse(readFileSync(configPath, "utf8"));
+    }
+    catch (error) {
+        throw new Error(`@ascribed/astro can't read ${configPath}: ${error instanceof Error ? error.message : String(error)}`, { cause: error });
+    }
+    const project = section(table, "project");
+    const consumer = section(table, "consumer");
+    const outputDir = typeof project["output-dir"] === "string" ? project["output-dir"] : ".ascribe/build";
+    const contentDir = typeof project["content-root"] === "string" ? project["content-root"] : "docs";
+    const trailingSlash = consumer["trailing-slash"] === "never" ? "never" : "always";
+    return {
+        dir,
+        configPath,
+        contentRoot: path.resolve(dir, contentDir),
+        outputRoot: path.resolve(dir, outputDir),
+        consumer: {
+            site: typeof consumer["site"] === "string" ? consumer["site"] : undefined,
+            basePath: normalizeBase(typeof consumer["base-path"] === "string" ? consumer["base-path"] : "/"),
+            trailingSlash,
+        },
+        siteRoot: (build) => path.resolve(dir, outputDir, build, "site"),
+    };
+}
+function section(table, name) {
+    const value = table[name];
+    return typeof value === "object" && value !== null && !Array.isArray(value)
+        ? value
+        : {};
+}
+/** A base path with a leading and a trailing `/`, as Ascribe's router has it. */
+export function normalizeBase(base) {
+    let result = base.trim();
+    if (!result.startsWith("/"))
+        result = `/${result}`;
+    if (!result.endsWith("/"))
+        result += "/";
+    return result;
+}
+/**
+ * The ways `ascribe.toml`'s `[consumer]` disagrees with Astro's configuration,
+ * as sentences. Ascribe writes every link with its own settings, so a site
+ * whose routes differ would have broken links.
+ */
+export function consumerMismatches(project, astro) {
+    const problems = [];
+    const { basePath, trailingSlash, site } = project.consumer;
+    if (normalizeBase(astro.base) !== basePath) {
+        problems.push(`[consumer] base-path is "${basePath}", but Astro's \`base\` is "${astro.base}". Set them to the same path.`);
+    }
+    // Astro's "ignore" serves both forms, so Ascribe's links work either way.
+    if (astro.trailingSlash !== "ignore" && astro.trailingSlash !== trailingSlash) {
+        problems.push(`[consumer] trailing-slash is "${trailingSlash}", but Astro's \`trailingSlash\` is "${astro.trailingSlash}".`);
+    }
+    if (site !== undefined && astro.site !== undefined && origin(site) !== origin(astro.site)) {
+        problems.push(`[consumer] site is "${site}", but Astro's \`site\` is "${astro.site}".`);
+    }
+    return problems;
+}
+function origin(url) {
+    try {
+        return new URL(url).origin;
+    }
+    catch {
+        return url;
+    }
+}
+//# sourceMappingURL=project.js.map

package/dist/project.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.js","sourceRoot":"","sources":["../src/project.ts"],"names":[],"mappings":"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"}

package/dist/rehype.d.ts

@@ -0,0 +1,3 @@
+import type { Root } from "hast";
+/** Applies the site output's attribute markers (`ascribe-attributes`). */
+export default function rehypeAscribeAttributes(): (tree: Root) => void;

package/dist/rehype.js

@@ -0,0 +1,46 @@
+// The attribute marker as a rehype plugin, for Astro's `unified()` markdown
+// processor (`@astrojs/markdown-remark`).
+//
+// Astro builds that processor as: remark-parse, remark-gfm, remark-smartypants,
+// the user's remark plugins, remark-collect-images, remark-rehype (raw HTML
+// allowed), syntax highlighting, the user's rehype plugins, `rehypeImages`,
+// `rehypeHeadingIds`, and finally `rehype-raw`. A user rehype plugin therefore
+// runs where markers are still `raw` nodes and before both of Astro's passes:
+// `rehypeImages` copies an `<img>`'s properties into the image it optimizes,
+// and `rehypeHeadingIds` keeps an id a heading already has and records it for
+// the table of contents. A rehype plugin, not a remark one, so that both of
+// Astro's processors can share `findEdits`.
+import { findEdits, toProperty } from "./attributes.js";
+/** Applies the site output's attribute markers (`ascribe-attributes`). */
+export default function rehypeAscribeAttributes() {
+    return (tree) => {
+        const edits = findEdits(tree);
+        if (edits.length === 0)
+            return;
+        const removed = new Set();
+        for (const edit of edits) {
+            const properties = (edit.target.properties ??= {});
+            for (const attribute of edit.attributes) {
+                const [name, value] = toProperty(attribute);
+                properties[name] = value;
+            }
+            for (const node of edit.remove)
+                removed.add(node);
+            for (const { node, value } of edit.trim) {
+                if (value === "")
+                    removed.add(node);
+                else
+                    node.value = value;
+            }
+        }
+        dropNodes(tree, removed);
+    };
+}
+function dropNodes(node, removed) {
+    if (node.children === undefined)
+        return;
+    node.children = node.children.filter((child) => !removed.has(child));
+    for (const child of node.children)
+        dropNodes(child, removed);
+}
+//# sourceMappingURL=rehype.js.map

package/dist/rehype.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rehype.js","sourceRoot":"","sources":["../src/rehype.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,0CAA0C;AAC1C,EAAE;AACF,gFAAgF;AAChF,4EAA4E;AAC5E,4EAA4E;AAC5E,+EAA+E;AAC/E,8EAA8E;AAC9E,6EAA6E;AAC7E,8EAA8E;AAC9E,4EAA4E;AAC5E,4CAA4C;AAG5C,OAAO,EAAE,SAAS,EAAE,UAAU,EAAiB,MAAM,iBAAiB,CAAC;AAEvE,0EAA0E;AAC1E,MAAM,CAAC,OAAO,UAAU,uBAAuB;IAC7C,OAAO,CAAC,IAAI,EAAE,EAAE;QACd,MAAM,KAAK,GAAG,SAAS,CAAC,IAAgB,CAAC,CAAC;QAC1C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAC/B,MAAM,OAAO,GAAG,IAAI,GAAG,EAAY,CAAC;QACpC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,UAAU,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,KAAK,EAAE,CAAC,CAAC;YACnD,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;gBACxC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC;gBAC5C,UAAU,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;YAC3B,CAAC;YACD,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,MAAM;gBAAE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAClD,KAAK,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBACxC,IAAI,KAAK,KAAK,EAAE;oBAAE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;;oBAC/B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;YAC1B,CAAC;QACH,CAAC;QACD,SAAS,CAAC,IAAgB,EAAE,OAAO,CAAC,CAAC;IACvC,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,IAAc,EAAE,OAAsB;IACvD,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS;QAAE,OAAO;IACxC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;IACrE,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ;QAAE,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;AAC/D,CAAC"}