@kensio/colophon 2.2.0 → 2.4.0

package/dist/config.js

@@ -1,4 +1,6 @@
+import { resolveFonts } from "./fonts.js";
 import { builtinTemplates } from "./templates/index.js";
+import { validateConfig } from "./validate.js";
 /**
  * Named output-size presets covering the common social-image standards. Each
  * `name` becomes the filename suffix (e.g. `my-post-og.png`).
@@ -23,7 +25,11 @@ export const DEFAULT_SIZES = [
     SIZE_PRESETS.og,
     SIZE_PRESETS.square,
 ];
-/** Default font stack. Override via `config.fontFamily` for branded fonts. */
+/**
+ * Default font stack, used when no fonts are configured. It names families and
+ * hopes the machine has them, which is exactly what `config.fonts` exists to
+ * avoid: supply a font file and the output stops depending on the machine.
+ */
 export const DEFAULT_FONT_FAMILY = "Arial, Helvetica, sans-serif";
 /** Neutral default palette, used when no `colors.brand` is supplied. */
 export const DEFAULT_COLORS = {
@@ -64,6 +70,9 @@ export const DEFAULT_CODE_STYLE = {
  * via `config.onWarning`.
  */
 function warnToConsole(message) {
+    // The console is the point: this is the default sink, replaced wholesale by
+    // a caller-supplied `onWarning`.
+    // eslint-disable-next-line no-console
     console.warn(`colophon: ${message}`);
 }
 /**
@@ -112,15 +121,39 @@ function resolveSizes(sizes) {
     }
     return sizes;
 }
+/**
+ * Whether to load the machine's own fonts. Configured fonts are meant to make
+ * the output the same everywhere, so supplying any turns system fonts off
+ * unless the project asks for them back.
+ */
+function shouldLoadSystemFonts(systemFonts, fonts) {
+    if (systemFonts === undefined) {
+        return fonts.length === 0;
+    }
+    if (!systemFonts && fonts.length === 0) {
+        throw new Error("systemFonts is false and no fonts are configured, so no text could be" +
+            " rendered. Add fonts, or leave systemFonts unset.");
+    }
+    return systemFonts;
+}
 /**
  * Apply defaults to a user config. Safe to call with no argument.
+ *
+ * Unknown options are rejected before anything is resolved, so a config
+ * written against a different version of the package is a build error rather
+ * than a set of images quietly rendered with the defaults.
  */
 export function resolveConfig(config = {}) {
+    validateConfig(config);
     const colors = resolveColors(config.colors);
+    const fonts = resolveFonts(config.fonts);
     return {
         colors,
         background: config.background ?? defaultBackground(colors),
-        fontFamily: config.fontFamily ?? DEFAULT_FONT_FAMILY,
+        fonts,
+        systemFonts: shouldLoadSystemFonts(config.systemFonts, fonts),
+        // A project that supplies one font should not have to name it twice.
+        fontFamily: config.fontFamily ?? fonts[0]?.family ?? DEFAULT_FONT_FAMILY,
         footer: config.footer,
         badge: config.badge,
         code: resolveCode(config.code),
@@ -129,4 +162,47 @@ export function resolveConfig(config = {}) {
         templates: { ...builtinTemplates, ...config.templates },
     };
 }
+/**
+ * Merge a size's colour overrides onto the config's.
+ *
+ * A size may name any single shade, so the merge starts from the full default
+ * palette when the config sets no colours of its own. Starting from nothing
+ * instead would hand `resolveColors` a lone `foreground`, and its rule that a
+ * bare `brand` colours the whole gradient would then flatten the default
+ * gradient — a size asking only for darker text would silently lose it.
+ */
+function mergeColors(base, overrides) {
+    return { ...(base ?? DEFAULT_COLORS), ...overrides };
+}
+/**
+ * Apply a size's own overrides to a config and resolve the result: the config
+ * one image is actually rendered with.
+ *
+ * The overrides are folded into the user config and the whole thing resolved
+ * again, rather than patched onto an already-resolved config, so that anything
+ * derived stays consistent — a size that overrides `colors.brand` gets the
+ * default gradient rebuilt around its brand, exactly as a config setting the
+ * same colour at the top level would.
+ *
+ * `colors` and `code` merge over their config-level counterparts, because both
+ * are bags of independent settings and the point of the feature is to change
+ * one of them. The rest replace: a `background` is a union whose variants have
+ * different keys, so half of one over half of another is not a background at
+ * all, and `badge` carries a required `text` that a partial override could not
+ * supply.
+ */
+export function resolveConfigForSize(config, size) {
+    const base = config ?? {};
+    return resolveConfig({
+        ...base,
+        ...(size.colors !== undefined && {
+            colors: mergeColors(base.colors, size.colors),
+        }),
+        ...(size.code !== undefined && { code: { ...base.code, ...size.code } }),
+        ...(size.background !== undefined && { background: size.background }),
+        ...(size.fontFamily !== undefined && { fontFamily: size.fontFamily }),
+        ...(size.footer !== undefined && { footer: size.footer }),
+        ...(size.badge !== undefined && { badge: size.badge }),
+    });
+}
 //# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/content/index.d.ts

@@ -1,52 +1,6 @@
-import type { MetaImageProps } from "../types.js";
-/**
- * Options for {@link walkContent}. Only `dir` is required.
- */
-export interface WalkOptions {
-    /** Root directory to search recursively for content files. */
-    readonly dir: string;
-    /** Frontmatter key holding the image props object. Default `meta_img_props`. */
-    readonly propsKey?: string;
-    /** Field within the props object naming the template. Default `template`. */
-    readonly templateField?: string;
-    /** Template to use when the template field is absent. */
-    readonly defaultTemplate?: string;
-    /**
-     * Top-level frontmatter field to read the post slug from (used as the base
-     * filename). Default `slug`; falls back to the file/directory name.
-     */
-    readonly slugField?: string;
-    /** File extensions to include. Default `.md` and `.markdown`. */
-    readonly extensions?: readonly string[];
-}
-/**
- * A discovered content file with the image props read from its frontmatter.
- */
-export interface ContentFile {
-    /** Path relative to the walk `dir`. */
-    readonly contentPath: string;
-    /** Absolute path on disk. */
-    readonly absolutePath: string;
-    /** Base filename for this post's images (frontmatter slug, or path-derived). */
-    readonly slug: string;
-    readonly props: MetaImageProps;
-}
-/**
- * Derive a slug from a file path: the filename without extension, or the
- * parent directory name when the file is `index.*` (the common page-bundle
- * convention).
- */
-export declare function slugFromPath(filePath: string): string;
-/**
- * Extract {@link MetaImageProps} from a parsed frontmatter object, or return
- * `undefined` if this file should be skipped (no props object, or no usable
- * template/title). Pure — no filesystem access.
- */
-export declare function extractProps(frontmatter: Record<string, unknown>, options?: Pick<WalkOptions, "propsKey" | "templateField" | "defaultTemplate">): MetaImageProps | undefined;
-/**
- * Walk a content tree, read each file's frontmatter with `gray-matter`, and
- * return the files that declare image props. This is the host-project concern
- * — finding content and reading frontmatter — kept separate from rendering.
- */
-export declare function walkContent(options: WalkOptions): Promise<ContentFile[]>;
+export { extractProps } from "./props.js";
+export { slugFromPath } from "./slug.js";
+export { walkContent } from "./walk.js";
+export type { WalkOptions } from "./walk.js";
+export type { ContentFile } from "../types.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/content/index.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAuBlD;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,8DAA8D;IAC9D,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,gFAAgF;IAChF,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,6EAA6E;IAC7E,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,yDAAyD;IACzD,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,iEAAiE;IACjE,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACzC;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,uCAAuC;IACvC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,6BAA6B;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,gFAAgF;IAChF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;CAChC;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAIrD;AAMD;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,OAAO,GAAE,IAAI,CACX,WAAW,EACX,UAAU,GAAG,eAAe,GAAG,iBAAiB,CAC5C,GACL,cAAc,GAAG,SAAS,CA4C5B;AA8BD;;;;GAIG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,WAAW,EAAE,CAAC,CAgCxB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/content/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,YAAY,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAE7C,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC"}

package/dist/content/index.js

@@ -1,116 +1,4 @@
-import { readdir, readFile } from "node:fs/promises";
-import path from "node:path";
-import matter from "gray-matter";
-const defaultPropsKey = "meta_img_props";
-const defaultTemplateField = "template";
-const defaultSlugField = "slug";
-const defaultExtensions = [".md", ".markdown"];
-function coerceString(value) {
-    if (typeof value === "string") {
-        return value;
-    }
-    if (typeof value === "number" ||
-        typeof value === "boolean" ||
-        typeof value === "bigint") {
-        return String(value);
-    }
-    return undefined;
-}
-/**
- * Derive a slug from a file path: the filename without extension, or the
- * parent directory name when the file is `index.*` (the common page-bundle
- * convention).
- */
-export function slugFromPath(filePath) {
-    const extension = path.extname(filePath);
-    const base = path.basename(filePath, extension);
-    return base === "index" ? path.basename(path.dirname(filePath)) : base;
-}
-function isRecord(value) {
-    return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-/**
- * Extract {@link MetaImageProps} from a parsed frontmatter object, or return
- * `undefined` if this file should be skipped (no props object, or no usable
- * template/title). Pure — no filesystem access.
- */
-export function extractProps(frontmatter, options = {}) {
-    const propsKey = options.propsKey ?? defaultPropsKey;
-    const templateField = options.templateField ?? defaultTemplateField;
-    const record = frontmatter[propsKey];
-    if (!isRecord(record)) {
-        return undefined;
-    }
-    const templateRaw = record[templateField];
-    const template = typeof templateRaw === "string" ? templateRaw : options.defaultTemplate;
-    if (template === undefined) {
-        return undefined;
-    }
-    // Title is optional: templates such as `code` describe the image entirely
-    // from their own fields, and requiring a title would be pure boilerplate.
-    const title = coerceString(record["title"]);
-    const subtitle = coerceString(record["subtitle"]);
-    const version = coerceString(record["version"]);
-    const extras = {};
-    for (const [key, value] of Object.entries(record)) {
-        if (key !== templateField &&
-            key !== "template" &&
-            key !== "title" &&
-            key !== "subtitle" &&
-            key !== "version") {
-            extras[key] = value;
-        }
-    }
-    return {
-        ...extras,
-        template,
-        ...(title !== undefined && { title }),
-        ...(subtitle !== undefined && { subtitle }),
-        ...(version !== undefined && { version }),
-    };
-}
-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 declare image props. 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 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 declaredSlug = coerceString(frontmatter[slugField])?.trim();
-        const slug = declaredSlug !== undefined && declaredSlug !== ""
-            ? declaredSlug
-            : slugFromPath(filePath);
-        return {
-            contentPath: path.relative(options.dir, filePath),
-            absolutePath: filePath,
-            slug,
-            props,
-        };
-    }));
-    return files.filter((file) => file !== undefined);
-}
+export { extractProps } from "./props.js";
+export { slugFromPath } from "./slug.js";
+export { walkContent } from "./walk.js";
 //# sourceMappingURL=index.js.map

package/dist/content/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/content/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/content/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC"}

package/dist/content/props.d.ts

@@ -0,0 +1,15 @@
+import type { ContentOptions, MetaImageProps } from "../types.js";
+/** Read a frontmatter scalar as a string, ignoring anything else. */
+export declare function coerceString(value: unknown): string | undefined;
+/**
+ * Extract {@link MetaImageProps} from a parsed frontmatter object, or return
+ * `undefined` if this file should be skipped (nothing to build props from, or
+ * no usable template). Pure, with no filesystem access.
+ *
+ * Props can come from two places: the post's own props object, and a project's
+ * `props` mapper reading the frontmatter it already has. Where both speak the
+ * post wins, field by field. The mapper describes the site's usual shape, and
+ * a post that says otherwise is saying so on purpose.
+ */
+export declare function extractProps(frontmatter: Record<string, unknown>, options?: Pick<ContentOptions, "propsKey" | "templateField" | "defaultTemplate" | "props">): MetaImageProps | undefined;
+//# sourceMappingURL=props.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"props.d.ts","sourceRoot":"","sources":["../../src/content/props.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAKlE,qEAAqE;AACrE,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAc/D;AASD;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAC1B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,OAAO,GAAE,IAAI,CACX,cAAc,EACd,UAAU,GAAG,eAAe,GAAG,iBAAiB,GAAG,OAAO,CACtD,GACL,cAAc,GAAG,SAAS,CAiD5B"}

package/dist/content/props.js

@@ -0,0 +1,71 @@
+const defaultPropsKey = "meta_img_props";
+const defaultTemplateField = "template";
+/** Read a frontmatter scalar as a string, ignoring anything else. */
+export function coerceString(value) {
+    if (typeof value === "string") {
+        return value;
+    }
+    if (typeof value === "number" ||
+        typeof value === "boolean" ||
+        typeof value === "bigint") {
+        return String(value);
+    }
+    return undefined;
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/** The fields the props shape names itself, which never become extras. */
+const namedFields = new Set(["template", "title", "subtitle", "version"]);
+/**
+ * Extract {@link MetaImageProps} from a parsed frontmatter object, or return
+ * `undefined` if this file should be skipped (nothing to build props from, or
+ * no usable template). Pure, with no filesystem access.
+ *
+ * Props can come from two places: the post's own props object, and a project's
+ * `props` mapper reading the frontmatter it already has. Where both speak the
+ * post wins, field by field. The mapper describes the site's usual shape, and
+ * a post that says otherwise is saying so on purpose.
+ */
+export function extractProps(frontmatter, options = {}) {
+    const propsKey = options.propsKey ?? defaultPropsKey;
+    const templateField = options.templateField ?? defaultTemplateField;
+    const declared = frontmatter[propsKey];
+    const hasDeclared = isRecord(declared);
+    const mapped = options.props?.(frontmatter);
+    // A mapper opting a post out cannot overrule a post that asked for an image
+    // outright, so the skip only applies where the post says nothing itself.
+    if (!hasDeclared && mapped === undefined) {
+        return undefined;
+    }
+    // Merged rather than replaced, so a post correcting one field does not have
+    // to restate everything the mapper already got right.
+    const record = {
+        ...mapped,
+        ...(hasDeclared && declared),
+    };
+    const templateRaw = record[templateField];
+    const template = typeof templateRaw === "string" ? templateRaw : options.defaultTemplate;
+    if (template === undefined) {
+        return undefined;
+    }
+    // Title is optional: templates such as `code` describe the image entirely
+    // from their own fields, and requiring a title would be pure boilerplate.
+    const title = coerceString(record["title"]);
+    const subtitle = coerceString(record["subtitle"]);
+    const version = coerceString(record["version"]);
+    const extras = {};
+    for (const [key, value] of Object.entries(record)) {
+        if (key !== templateField && !namedFields.has(key)) {
+            extras[key] = value;
+        }
+    }
+    return {
+        ...extras,
+        template,
+        ...(title !== undefined && { title }),
+        ...(subtitle !== undefined && { subtitle }),
+        ...(version !== undefined && { version }),
+    };
+}
+//# sourceMappingURL=props.js.map

package/dist/content/props.js.map

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

package/dist/content/slug.d.ts

@@ -0,0 +1,23 @@
+import type { SlugStrategy } from "../types.js";
+/**
+ * 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.*`, which is 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 declare function slugFromPath(contentPath: string, strategy?: SlugStrategy): string;
+/**
+ * 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 declare function assertSlugStaysInside(slug: string, contentPath: string): void;
+//# sourceMappingURL=slug.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"slug.d.ts","sourceRoot":"","sources":["../../src/content/slug.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAC1B,WAAW,EAAE,MAAM,EACnB,QAAQ,GAAE,YAAyB,GAClC,MAAM,CAqBR;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAe7E"}

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.*`, which is 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,sEAAsE;IACtE,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 of 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 of 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":"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"}

package/dist/fonts/index.d.ts

@@ -0,0 +1,11 @@
+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. It is 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;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,SAAS,UAAU,EAAE,GAC3B,MAAM,GAAG,SAAS,CAEpB"}

package/dist/fonts/index.js

@@ -0,0 +1,12 @@
+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. It is 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;;;;;GAKG;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"}