@kensio/colophon 2.1.0 → 2.3.0

package/dist/content/slug.js

@@ -0,0 +1,52 @@
+import path from "node:path";
+/**
+ * Derive a slug from a content file's path, relative to the root of the walk.
+ *
+ * `basename` gives the filename without extension, or the parent directory for
+ * `index.*` — the page-bundle convention, where an image sits beside its post.
+ * `route` keeps the directories, so a site addressed by route gets a slug that
+ * matches the address rather than just its last segment.
+ *
+ * The path must be relative to the content root for `route` to mean anything;
+ * `basename` reads the same either way.
+ */
+export function slugFromPath(contentPath, strategy = "basename") {
+    const extension = path.extname(contentPath);
+    const base = path.basename(contentPath, extension);
+    const directory = path.dirname(contentPath);
+    if (strategy === "basename") {
+        if (base !== "index") {
+            return base;
+        }
+        // A root-level `index.*` has no parent inside the tree to be named after,
+        // so it keeps its own name rather than borrowing the content directory's.
+        const parent = path.basename(directory);
+        return parent === "" || parent === "." ? base : parent;
+    }
+    const route = base === "index" ? directory : path.join(directory, base);
+    // `path.dirname` of a root-level file is ".", which as a route is the site
+    // root — and the one place there is no directory name to fall back on.
+    const normalised = route === "." ? "index" : route.split(path.sep).join("/");
+    return normalised;
+}
+/**
+ * Reject a slug that would name a file outside the tree it came from.
+ *
+ * A slug is a filename, and may carry directories under the `route` strategy —
+ * but a declared one is written by hand, and `slug: ../../../tmp/x` would have
+ * `generate` create directories and write an image there. Nothing derived from
+ * a path can look like this, so the check only ever fires on frontmatter.
+ */
+export function assertSlugStaysInside(slug, contentPath) {
+    // An empty segment catches a leading or doubled separator, so an absolute
+    // slug is rejected by the same pass as a traversing one.
+    const outside = new Set(["", ".", ".."]);
+    const isEscaping = slug.split(/[/\\]/).some((segment) => outside.has(segment)) ||
+        /^[A-Za-z]:/.test(slug);
+    if (isEscaping) {
+        throw new Error(`Invalid slug "${slug}" in ${contentPath}: a slug names an image inside` +
+            ` the output tree, so it cannot be absolute or contain "." or ".."` +
+            ` segments.`);
+    }
+}
+//# sourceMappingURL=slug.js.map

package/dist/content/slug.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slug.js","sourceRoot":"","sources":["../../src/content/slug.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAI7B;;;;;;;;;;GAUG;AACH,MAAM,UAAU,YAAY,CAC1B,WAAmB,EACnB,QAAQ,GAAiB,UAAU;IAEnC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAC5C,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;IACnD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAE5C,IAAI,QAAQ,KAAK,UAAU,EAAE,CAAC;QAC5B,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;YACrB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,0EAA0E;QAC1E,0EAA0E;QAC1E,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QACxC,OAAO,MAAM,KAAK,EAAE,IAAI,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC;IACzD,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IACxE,2EAA2E;IAC3E,uEAAuE;IACvE,MAAM,UAAU,GAAG,KAAK,KAAK,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC7E,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAY,EAAE,WAAmB;IACrE,0EAA0E;IAC1E,yDAAyD;IACzD,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,CAAC,EAAE,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC;IACzC,MAAM,UAAU,GACd,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC3D,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAE1B,IAAI,UAAU,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,iBAAiB,IAAI,QAAQ,WAAW,gCAAgC;YACtE,mEAAmE;YACnE,YAAY,CACf,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/content/walk.d.ts

@@ -0,0 +1,17 @@
+import type { ContentFile, ContentOptions } from "../types.js";
+/**
+ * Options for {@link walkContent}: everything a project can say about reading
+ * its own content, plus the directory to read it from. Only `dir` is required.
+ */
+export interface WalkOptions extends ContentOptions {
+    /** Root directory to search recursively for content files. */
+    readonly dir: string;
+}
+/**
+ * Walk a content tree, read each file's frontmatter with `gray-matter`, and
+ * return the files that image props can be built for. This is the host-project
+ * concern — finding content and reading frontmatter — kept separate from
+ * rendering.
+ */
+export declare function walkContent(options: WalkOptions): Promise<ContentFile[]>;
+//# sourceMappingURL=walk.d.ts.map

package/dist/content/walk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"walk.d.ts","sourceRoot":"","sources":["../../src/content/walk.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAQ/D;;;GAGG;AACH,MAAM,WAAW,WAAY,SAAQ,cAAc;IACjD,8DAA8D;IAC9D,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AA8BD;;;;;GAKG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,WAAW,EAAE,CAAC,CAoCxB"}

package/dist/content/walk.js

@@ -0,0 +1,57 @@
+import { readdir, readFile } from "node:fs/promises";
+import path from "node:path";
+import matter from "gray-matter";
+import { coerceString, extractProps } from "./props.js";
+import { assertSlugStaysInside, slugFromPath } from "./slug.js";
+const defaultSlugField = "slug";
+const defaultSlugStrategy = "basename";
+const defaultExtensions = [".md", ".markdown"];
+async function collectContentFiles(dir, extensions) {
+    const entries = await readdir(dir, { withFileTypes: true });
+    const nested = await Promise.all(entries.map(async (entry) => {
+        const entryPath = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            return collectContentFiles(entryPath, extensions);
+        }
+        if (entry.isFile() &&
+            extensions.some((extension) => entry.name.endsWith(extension))) {
+            return [entryPath];
+        }
+        return [];
+    }));
+    return nested.flat();
+}
+/**
+ * Walk a content tree, read each file's frontmatter with `gray-matter`, and
+ * return the files that image props can be built for. This is the host-project
+ * concern — finding content and reading frontmatter — kept separate from
+ * rendering.
+ */
+export async function walkContent(options) {
+    const extensions = options.extensions ?? defaultExtensions;
+    const filePaths = await collectContentFiles(options.dir, extensions);
+    const slugField = options.slugField ?? defaultSlugField;
+    const slugStrategy = options.slugStrategy ?? defaultSlugStrategy;
+    const files = await Promise.all(filePaths.map(async (filePath) => {
+        const raw = await readFile(filePath, "utf8");
+        const frontmatter = matter(raw).data;
+        const props = extractProps(frontmatter, options);
+        if (props === undefined) {
+            return;
+        }
+        const contentPath = path.relative(options.dir, filePath);
+        const declaredSlug = coerceString(frontmatter[slugField])?.trim();
+        const slug = declaredSlug !== undefined && declaredSlug !== ""
+            ? declaredSlug
+            : slugFromPath(contentPath, slugStrategy);
+        assertSlugStaysInside(slug, contentPath);
+        return {
+            contentPath,
+            absolutePath: filePath,
+            slug,
+            props,
+        };
+    }));
+    return files.filter((file) => file !== undefined);
+}
+//# sourceMappingURL=walk.js.map

package/dist/content/walk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"walk.js","sourceRoot":"","sources":["../../src/content/walk.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,MAAM,MAAM,aAAa,CAAC;AAGjC,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEhE,MAAM,gBAAgB,GAAG,MAAM,CAAC;AAChC,MAAM,mBAAmB,GAAG,UAAU,CAAC;AACvC,MAAM,iBAAiB,GAAsB,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;AAWlE,KAAK,UAAU,mBAAmB,CAChC,GAAW,EACX,UAA6B;IAE7B,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAE5D,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAC9B,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;QAC1B,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAE7C,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,OAAO,mBAAmB,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;QACpD,CAAC;QAED,IACE,KAAK,CAAC,MAAM,EAAE;YACd,UAAU,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,EAC9D,CAAC;YACD,OAAO,CAAC,SAAS,CAAC,CAAC;QACrB,CAAC;QAED,OAAO,EAAE,CAAC;IACZ,CAAC,CAAC,CACH,CAAC;IAEF,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;AACvB,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,OAAoB;IAEpB,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,iBAAiB,CAAC;IAC3D,MAAM,SAAS,GAAG,MAAM,mBAAmB,CAAC,OAAO,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;IAErE,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,gBAAgB,CAAC;IACxD,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,mBAAmB,CAAC;IAEjE,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,GAAG,CAC7B,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE;QAC/B,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAC7C,MAAM,WAAW,GAA4B,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;QAC9D,MAAM,KAAK,GAAG,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QAEjD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,OAAO;QACT,CAAC;QAED,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QACzD,MAAM,YAAY,GAAG,YAAY,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;QAClE,MAAM,IAAI,GACR,YAAY,KAAK,SAAS,IAAI,YAAY,KAAK,EAAE;YAC/C,CAAC,CAAC,YAAY;YACd,CAAC,CAAC,YAAY,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;QAE9C,qBAAqB,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;QAEzC,OAAO;YACL,WAAW;YACX,YAAY,EAAE,QAAQ;YACtB,IAAI;YACJ,KAAK;SACN,CAAC;IACJ,CAAC,CAAC,CACH,CAAC;IAEF,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAuB,EAAE,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;AACzE,CAAC"}

package/dist/fonts/index.d.ts

@@ -0,0 +1,10 @@
+import type { FontSource } from "../types.js";
+export { fontFilePaths } from "./materialise.js";
+export { resolveFonts } from "./resolve.js";
+/**
+ * The family the rasteriser should fall back to when a `font-family` names
+ * something it has not loaded — the first declared family, so the fallback is
+ * the same wherever the build runs rather than whichever font loaded first.
+ */
+export declare function fallbackFamily(fonts: readonly FontSource[]): string | undefined;
+//# sourceMappingURL=index.d.ts.map

package/dist/fonts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/fonts/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,SAAS,UAAU,EAAE,GAC3B,MAAM,GAAG,SAAS,CAEpB"}

package/dist/fonts/index.js

@@ -0,0 +1,11 @@
+export { fontFilePaths } from "./materialise.js";
+export { resolveFonts } from "./resolve.js";
+/**
+ * The family the rasteriser should fall back to when a `font-family` names
+ * something it has not loaded — the first declared family, so the fallback is
+ * the same wherever the build runs rather than whichever font loaded first.
+ */
+export function fallbackFamily(fonts) {
+    return fonts.find((font) => font.family !== undefined)?.family;
+}
+//# sourceMappingURL=index.js.map

package/dist/fonts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/fonts/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAC5B,KAA4B;IAE5B,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,EAAE,MAAM,CAAC;AACjE,CAAC"}

package/dist/fonts/materialise.d.ts

@@ -0,0 +1,7 @@
+import type { FontSource } from "../types.js";
+/**
+ * File paths for the configured fonts, in order, writing any supplied as
+ * bytes to a temp file first.
+ */
+export declare function fontFilePaths(fonts: readonly FontSource[]): Promise<string[]>;
+//# sourceMappingURL=materialise.d.ts.map

package/dist/fonts/materialise.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"materialise.d.ts","sourceRoot":"","sources":["../../src/fonts/materialise.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AA4C9C;;;GAGG;AACH,wBAAsB,aAAa,CACjC,KAAK,EAAE,SAAS,UAAU,EAAE,GAC3B,OAAO,CAAC,MAAM,EAAE,CAAC,CAMnB"}

package/dist/fonts/materialise.js

@@ -0,0 +1,47 @@
+import { createHash } from "node:crypto";
+import { existsSync } from "node:fs";
+import { mkdir, writeFile } from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+/**
+ * Directory in-memory fonts are written to. The rasteriser takes file paths
+ * only, so a font supplied as bytes has to land on disk somewhere; the temp
+ * directory keeps it out of the user's project.
+ */
+const materialisedDir = path.join(os.tmpdir(), "colophon-fonts");
+/**
+ * In-flight and completed writes of in-memory fonts, keyed by content hash.
+ * A build renders many images from one config, so the same bytes would
+ * otherwise be written once per image.
+ */
+const materialised = new Map();
+/**
+ * Write font bytes to a temp file and return its path, reusing the file for
+ * identical bytes. The name is the content hash, so a rebuild reuses whatever
+ * an earlier run left behind and nothing has to be cleaned up.
+ */
+async function materialise(data) {
+    const hash = createHash("sha256").update(data).digest("hex").slice(0, 32);
+    const pending = materialised.get(hash);
+    if (pending !== undefined) {
+        return pending;
+    }
+    const write = (async () => {
+        const file = path.join(materialisedDir, `${hash}.font`);
+        if (!existsSync(file)) {
+            await mkdir(materialisedDir, { recursive: true });
+            await writeFile(file, data);
+        }
+        return file;
+    })();
+    materialised.set(hash, write);
+    return write;
+}
+/**
+ * File paths for the configured fonts, in order, writing any supplied as
+ * bytes to a temp file first.
+ */
+export async function fontFilePaths(fonts) {
+    return Promise.all(fonts.map(async (font) => "data" in font ? materialise(font.data) : font.path));
+}
+//# sourceMappingURL=materialise.js.map

package/dist/fonts/materialise.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"materialise.js","sourceRoot":"","sources":["../../src/fonts/materialise.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAI7B;;;;GAIG;AACH,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,gBAAgB,CAAC,CAAC;AAEjE;;;;GAIG;AACH,MAAM,YAAY,GAAG,IAAI,GAAG,EAA2B,CAAC;AAExD;;;;GAIG;AACH,KAAK,UAAU,WAAW,CAAC,IAAgB;IACzC,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC1E,MAAM,OAAO,GAAG,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAEvC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,MAAM,KAAK,GAAG,CAAC,KAAK,IAAqB,EAAE;QACzC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,GAAG,IAAI,OAAO,CAAC,CAAC;QAExD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACtB,MAAM,KAAK,CAAC,eAAe,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAClD,MAAM,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC9B,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,EAAE,CAAC;IAEL,YAAY,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC9B,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,KAA4B;IAE5B,OAAO,OAAO,CAAC,GAAG,CAChB,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CACvB,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CACpD,CACF,CAAC;AACJ,CAAC"}

package/dist/fonts/resolve.d.ts

@@ -0,0 +1,7 @@
+import type { FontSource } from "../types.js";
+/**
+ * Validate the configured fonts and make their paths absolute. Safe to call
+ * with no fonts, which is the default.
+ */
+export declare function resolveFonts(fonts: readonly FontSource[] | undefined): readonly FontSource[];
+//# sourceMappingURL=resolve.d.ts.map

package/dist/fonts/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/fonts/resolve.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AA0D9C;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,SAAS,UAAU,EAAE,GAAG,SAAS,GACvC,SAAS,UAAU,EAAE,CAMvB"}

package/dist/fonts/resolve.js

@@ -0,0 +1,50 @@
+import { existsSync, statSync } from "node:fs";
+import path from "node:path";
+function label(index) {
+    return `fonts[${String(index)}]`;
+}
+/**
+ * Validate one font source and make its path absolute.
+ *
+ * The rasteriser ignores a font file it cannot read and renders the text in
+ * whatever else it has loaded — or, with system fonts off, renders no text at
+ * all. A typo in a path would therefore show up as a blank image rather than
+ * an error, so the path is checked here instead.
+ */
+function resolveFont(font, index) {
+    const source = font;
+    const hasPath = source.path !== undefined;
+    const hasData = source.data !== undefined;
+    if (hasPath && hasData) {
+        throw new Error(`${label(index)} has both "path" and "data"; give one or the other.`);
+    }
+    if (source.data !== undefined) {
+        if (source.data.byteLength === 0) {
+            throw new Error(`${label(index)} has empty font data.`);
+        }
+        return font;
+    }
+    if (source.path === undefined || source.path === "") {
+        throw new Error(`${label(index)} needs a "path" to a font file, or its bytes as "data".`);
+    }
+    const absolute = path.resolve(source.path);
+    if (!existsSync(absolute) || !statSync(absolute).isFile()) {
+        throw new Error(`${label(index)}: font file not found at ${absolute}` +
+            ` (from "${source.path}"). Relative paths resolve from the working directory.`);
+    }
+    return {
+        ...(source.family !== undefined && { family: source.family }),
+        path: absolute,
+    };
+}
+/**
+ * Validate the configured fonts and make their paths absolute. Safe to call
+ * with no fonts, which is the default.
+ */
+export function resolveFonts(fonts) {
+    if (fonts === undefined || fonts.length === 0) {
+        return [];
+    }
+    return fonts.map((font, index) => resolveFont(font, index));
+}
+//# sourceMappingURL=resolve.js.map

package/dist/fonts/resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../../src/fonts/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,IAAI,MAAM,WAAW,CAAC;AAI7B,SAAS,KAAK,CAAC,KAAa;IAC1B,OAAO,SAAS,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC;AACnC,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,WAAW,CAAC,IAAgB,EAAE,KAAa;IAClD,MAAM,MAAM,GAAG,IAId,CAAC;IACF,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,KAAK,SAAS,CAAC;IAC1C,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,KAAK,SAAS,CAAC;IAE1C,IAAI,OAAO,IAAI,OAAO,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CACb,GAAG,KAAK,CAAC,KAAK,CAAC,qDAAqD,CACrE,CAAC;IACJ,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC9B,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,KAAK,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;QAC1D,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,IAAI,MAAM,CAAC,IAAI,KAAK,EAAE,EAAE,CAAC;QACpD,MAAM,IAAI,KAAK,CACb,GAAG,KAAK,CAAC,KAAK,CAAC,yDAAyD,CACzE,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAE3C,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;QAC1D,MAAM,IAAI,KAAK,CACb,GAAG,KAAK,CAAC,KAAK,CAAC,4BAA4B,QAAQ,EAAE;YACnD,WAAW,MAAM,CAAC,IAAI,wDAAwD,CACjF,CAAC;IACJ,CAAC;IAED,OAAO;QACL,GAAG,CAAC,MAAM,CAAC,MAAM,KAAK,SAAS,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;QAC7D,IAAI,EAAE,QAAQ;KACf,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAC1B,KAAwC;IAExC,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9C,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;AAC9D,CAAC"}

package/dist/fonts.d.ts

@@ -0,0 +1,18 @@
+import type { FontSource } from "./types.js";
+/**
+ * Validate the configured fonts and make their paths absolute. Safe to call
+ * with no fonts, which is the default.
+ */
+export declare function resolveFonts(fonts: readonly FontSource[] | undefined): readonly FontSource[];
+/**
+ * File paths for the configured fonts, in order, writing any supplied as
+ * bytes to a temp file first.
+ */
+export declare function fontFilePaths(fonts: readonly FontSource[]): Promise<string[]>;
+/**
+ * The family the rasteriser should fall back to when a `font-family` names
+ * something it has not loaded — the first declared family, so the fallback is
+ * the same wherever the build runs rather than whichever font loaded first.
+ */
+export declare function fallbackFamily(fonts: readonly FontSource[]): string | undefined;
+//# sourceMappingURL=fonts.d.ts.map

package/dist/fonts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fonts.d.ts","sourceRoot":"","sources":["../src/fonts.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAwE7C;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,SAAS,UAAU,EAAE,GAAG,SAAS,GACvC,SAAS,UAAU,EAAE,CAMvB;AA8BD;;;GAGG;AACH,wBAAsB,aAAa,CACjC,KAAK,EAAE,SAAS,UAAU,EAAE,GAC3B,OAAO,CAAC,MAAM,EAAE,CAAC,CAMnB;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,SAAS,UAAU,EAAE,GAC3B,MAAM,GAAG,SAAS,CAEpB"}

package/dist/fonts.js

@@ -0,0 +1,102 @@
+import { createHash } from "node:crypto";
+import { existsSync, statSync } from "node:fs";
+import { mkdir, writeFile } from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+/**
+ * Directory in-memory fonts are written to. The rasteriser takes file paths
+ * only, so a font supplied as bytes has to land on disk somewhere; the temp
+ * directory keeps it out of the user's project.
+ */
+const materialisedDir = path.join(os.tmpdir(), "colophon-fonts");
+/**
+ * In-flight and completed writes of in-memory fonts, keyed by content hash.
+ * A build renders many images from one config, so the same bytes would
+ * otherwise be written once per image.
+ */
+const materialised = new Map();
+function label(index) {
+    return `fonts[${String(index)}]`;
+}
+/**
+ * Validate one font source and make its path absolute.
+ *
+ * The rasteriser ignores a font file it cannot read and renders the text in
+ * whatever else it has loaded — or, with system fonts off, renders no text at
+ * all. A typo in a path would therefore show up as a blank image rather than
+ * an error, so the path is checked here instead.
+ */
+function resolveFont(font, index) {
+    const source = font;
+    const hasPath = source.path !== undefined;
+    const hasData = source.data !== undefined;
+    if (hasPath && hasData) {
+        throw new Error(`${label(index)} has both "path" and "data"; give one or the other.`);
+    }
+    if (source.data !== undefined) {
+        if (source.data.byteLength === 0) {
+            throw new Error(`${label(index)} has empty font data.`);
+        }
+        return font;
+    }
+    if (source.path === undefined || source.path === "") {
+        throw new Error(`${label(index)} needs a "path" to a font file, or its bytes as "data".`);
+    }
+    const absolute = path.resolve(source.path);
+    if (!existsSync(absolute) || !statSync(absolute).isFile()) {
+        throw new Error(`${label(index)}: font file not found at ${absolute}` +
+            ` (from "${source.path}"). Relative paths resolve from the working directory.`);
+    }
+    return {
+        ...(source.family !== undefined && { family: source.family }),
+        path: absolute,
+    };
+}
+/**
+ * Validate the configured fonts and make their paths absolute. Safe to call
+ * with no fonts, which is the default.
+ */
+export function resolveFonts(fonts) {
+    if (fonts === undefined || fonts.length === 0) {
+        return [];
+    }
+    return fonts.map((font, index) => resolveFont(font, index));
+}
+/**
+ * Write font bytes to a temp file and return its path, reusing the file for
+ * identical bytes. The name is the content hash, so a rebuild reuses whatever
+ * an earlier run left behind and nothing has to be cleaned up.
+ */
+async function materialise(data) {
+    const hash = createHash("sha256").update(data).digest("hex").slice(0, 32);
+    const pending = materialised.get(hash);
+    if (pending !== undefined) {
+        return pending;
+    }
+    const write = (async () => {
+        const file = path.join(materialisedDir, `${hash}.font`);
+        if (!existsSync(file)) {
+            await mkdir(materialisedDir, { recursive: true });
+            await writeFile(file, data);
+        }
+        return file;
+    })();
+    materialised.set(hash, write);
+    return write;
+}
+/**
+ * File paths for the configured fonts, in order, writing any supplied as
+ * bytes to a temp file first.
+ */
+export async function fontFilePaths(fonts) {
+    return Promise.all(fonts.map(async (font) => "data" in font ? materialise(font.data) : font.path));
+}
+/**
+ * The family the rasteriser should fall back to when a `font-family` names
+ * something it has not loaded — the first declared family, so the fallback is
+ * the same wherever the build runs rather than whichever font loaded first.
+ */
+export function fallbackFamily(fonts) {
+    return fonts.find((font) => font.family !== undefined)?.family;
+}
+//# sourceMappingURL=fonts.js.map

package/dist/fonts.js.map

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

package/dist/generate/extra.d.ts

@@ -0,0 +1,16 @@
+import type { Stamper } from "../stamp/index.js";
+import type { ColophonConfig, ResolvedConfig } from "../types.js";
+import type { RenderJob } from "./job.js";
+/**
+ * The jobs for the images a config declares outright, rather than finding in
+ * the content tree.
+ *
+ * An extra image is a size like any other as far as the renderer is concerned,
+ * so it goes through `resolveConfigForSize` too and gets the same override
+ * rules rather than a second set that would have to agree with the first.
+ * Each resolves its own: there are a handful of these at most, and one
+ * carrying overrides is the normal case rather than the exception, so caching
+ * them by name the way the content jobs do would save nothing.
+ */
+export declare function extraJobs(config: ColophonConfig | undefined, resolved: ResolvedConfig, stamper: Stamper): RenderJob[];
+//# sourceMappingURL=extra.d.ts.map

package/dist/generate/extra.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extra.d.ts","sourceRoot":"","sources":["../../src/generate/extra.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAE,cAAc,EAAc,cAAc,EAAE,MAAM,aAAa,CAAC;AAE9E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AA4B1C;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CACvB,MAAM,EAAE,cAAc,GAAG,SAAS,EAClC,QAAQ,EAAE,cAAc,EACxB,OAAO,EAAE,OAAO,GACf,SAAS,EAAE,CA0Bb"}

package/dist/generate/extra.js

@@ -0,0 +1,60 @@
+import { SIZE_PRESETS } from "../config/defaults.js";
+import { resolveConfigForSize } from "../config/size.js";
+import { isRecord } from "../validate/check.js";
+/**
+ * Reject an extra image that says too little to be rendered or written.
+ *
+ * The type requires both fields, but a CLI user's config module is plain
+ * JavaScript with nothing checking it, and neither omission fails anywhere
+ * near the config: a missing `output` surfaces as a complaint about an
+ * argument to `path`, and missing props as a property read on `undefined`.
+ * Key validation is no help either — it is the option that is not there.
+ */
+function checkImage(image, index) {
+    // The types say what should be here; this exists for when it is not.
+    const declared = image;
+    const label = `extra[${String(index)}]`;
+    if (typeof declared.output !== "string" || declared.output === "") {
+        throw new Error(`${label} needs an "output" path to write the image to.`);
+    }
+    if (!isRecord(declared.props)) {
+        throw new Error(`${label} needs a "props" object describing the image.`);
+    }
+}
+/**
+ * The jobs for the images a config declares outright, rather than finding in
+ * the content tree.
+ *
+ * An extra image is a size like any other as far as the renderer is concerned,
+ * so it goes through `resolveConfigForSize` too and gets the same override
+ * rules rather than a second set that would have to agree with the first.
+ * Each resolves its own: there are a handful of these at most, and one
+ * carrying overrides is the normal case rather than the exception, so caching
+ * them by name the way the content jobs do would save nothing.
+ */
+export function extraJobs(config, resolved, stamper) {
+    // `resolveSizes` never returns an empty list; the default is for the type.
+    const [firstSize = SIZE_PRESETS.og] = resolved.sizes;
+    return (config?.extra ?? []).map((image, index) => {
+        checkImage(image, index);
+        const size = image.size ?? firstSize;
+        return {
+            contentPath: undefined,
+            // Not a page, so not something the manifest can key by.
+            slug: undefined,
+            props: image.props,
+            size,
+            // Left as written rather than made absolute: the file system resolves a
+            // relative path against the working directory anyway, and the build log
+            // reads better saying what the config said.
+            outputPath: image.output,
+            // An extra names its own path, so the placement — which maps posts to
+            // paths — has nothing to say about where this one is served, nor about
+            // hashing a filename it did not choose.
+            url: undefined,
+            stamp: stamper.stamp(image.props, size),
+            config: resolveConfigForSize(config, size),
+        };
+    });
+}
+//# sourceMappingURL=extra.js.map

package/dist/generate/extra.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extra.js","sourceRoot":"","sources":["../../src/generate/extra.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAGzD,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAGhD;;;;;;;;GAQG;AACH,SAAS,UAAU,CAAC,KAAiB,EAAE,KAAa;IAClD,qEAAqE;IACrE,MAAM,QAAQ,GAAG,KAGhB,CAAC;IACF,MAAM,KAAK,GAAG,SAAS,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC;IAExC,IAAI,OAAO,QAAQ,CAAC,MAAM,KAAK,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;QAClE,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,gDAAgD,CAAC,CAAC;IAC5E,CAAC;IAED,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,+CAA+C,CAAC,CAAC;IAC3E,CAAC;AACH,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,SAAS,CACvB,MAAkC,EAClC,QAAwB,EACxB,OAAgB;IAEhB,2EAA2E;IAC3E,MAAM,CAAC,SAAS,GAAG,YAAY,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC;IAErD,OAAO,CAAC,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;QAChD,UAAU,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QACzB,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,IAAI,SAAS,CAAC;QAErC,OAAO;YACL,WAAW,EAAE,SAAS;YACtB,wDAAwD;YACxD,IAAI,EAAE,SAAS;YACf,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,IAAI;YACJ,wEAAwE;YACxE,wEAAwE;YACxE,4CAA4C;YAC5C,UAAU,EAAE,KAAK,CAAC,MAAM;YACxB,sEAAsE;YACtE,uEAAuE;YACvE,wCAAwC;YACxC,GAAG,EAAE,SAAS;YACd,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC;YACvC,MAAM,EAAE,oBAAoB,CAAC,MAAM,EAAE,IAAI,CAAC;SAC3C,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/generate/index.d.ts

@@ -0,0 +1,19 @@
+import type { GeneratedImage, GenerateOptions } from "./options.js";
+export { defaultOutputPath } from "./output-path.js";
+export type { GeneratedImage, GenerateOptions } from "./options.js";
+/**
+ * Walk a content tree and render meta images for every file that declares
+ * props, writing PNGs to disk. Images the config declares outright under
+ * `extra` are rendered by the same pass, on the same terms.
+ *
+ * Each image is stamped with a digest of the props, config and size it came
+ * from, so a rebuild renders only what has actually changed: an image whose
+ * stamp still matches is left alone, and one whose title, colours or template
+ * has moved on is rendered again. `overwrite` ignores the stamps and renders
+ * everything. Sizes with no image to render are never rasterised.
+ *
+ * Rendering runs `concurrency` images at a time rather than all of them, so a
+ * large tree does not start hundreds of rasterisations at once.
+ */
+export declare function generate(options: GenerateOptions): Promise<GeneratedImage[]>;
+//# sourceMappingURL=index.d.ts.map

package/dist/generate/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/generate/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAKpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpE;;;;;;;;;;;;;GAaG;AACH,wBAAsB,QAAQ,CAC5B,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,cAAc,EAAE,CAAC,CA6B3B"}

package/dist/generate/index.js

@@ -0,0 +1,46 @@
+import { writeManifest } from "../manifest/index.js";
+import { mapConcurrent } from "../pool.js";
+import { readPngStamp } from "../stamp/index.js";
+import { resolveConcurrency } from "./options.js";
+import { planBuild } from "./plan.js";
+import { renderImage } from "./render-image.js";
+export { defaultOutputPath } from "./output-path.js";
+/**
+ * Walk a content tree and render meta images for every file that declares
+ * props, writing PNGs to disk. Images the config declares outright under
+ * `extra` are rendered by the same pass, on the same terms.
+ *
+ * Each image is stamped with a digest of the props, config and size it came
+ * from, so a rebuild renders only what has actually changed: an image whose
+ * stamp still matches is left alone, and one whose title, colours or template
+ * has moved on is rendered again. `overwrite` ignores the stamps and renders
+ * everything. Sizes with no image to render are never rasterised.
+ *
+ * Rendering runs `concurrency` images at a time rather than all of them, so a
+ * large tree does not start hundreds of rasterisations at once.
+ */
+export async function generate(options) {
+    const concurrency = resolveConcurrency(options.concurrency);
+    const plan = await planBuild(options);
+    const results = await mapConcurrent(plan.jobs, concurrency, async (job) => {
+        const isSkipped = options.overwrite !== true &&
+            (await readPngStamp(job.outputPath)) === job.stamp;
+        if (!isSkipped) {
+            await renderImage(job, job.stamp);
+        }
+        const result = {
+            contentPath: job.contentPath,
+            size: job.size,
+            outputPath: job.outputPath,
+            url: job.url,
+            skipped: isSkipped,
+        };
+        options.onResult?.(result);
+        return result;
+    });
+    // Written last, and only once every image is on disk: a manifest naming a
+    // file that failed to render would outlive the build that failed.
+    await writeManifest(plan.manifest);
+    return results;
+}
+//# sourceMappingURL=index.js.map

package/dist/generate/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/generate/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAGrD;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,OAAwB;IAExB,MAAM,WAAW,GAAG,kBAAkB,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAC5D,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,CAAC;IAEtC,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;QACxE,MAAM,SAAS,GACb,OAAO,CAAC,SAAS,KAAK,IAAI;YAC1B,CAAC,MAAM,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,KAAK,GAAG,CAAC,KAAK,CAAC;QAErD,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC;QACpC,CAAC;QAED,MAAM,MAAM,GAAmB;YAC7B,WAAW,EAAE,GAAG,CAAC,WAAW;YAC5B,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,UAAU,EAAE,GAAG,CAAC,UAAU;YAC1B,GAAG,EAAE,GAAG,CAAC,GAAG;YACZ,OAAO,EAAE,SAAS;SACnB,CAAC;QACF,OAAO,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,CAAC;QAC3B,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC,CAAC;IAEH,0EAA0E;IAC1E,kEAAkE;IAClE,MAAM,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAEnC,OAAO,OAAO,CAAC;AACjB,CAAC"}