@kensio/colophon 2.1.0 → 2.3.0

package/dist/placement/relative.js

@@ -0,0 +1,53 @@
+import path from "node:path";
+/**
+ * How much of an image's digest goes in its filename.
+ *
+ * Eight hex characters is what the asset pipelines settle on, and it is the
+ * length at which a site would need tens of thousands of images before two of
+ * them were likely to collide.
+ */
+const hashLength = 8;
+/**
+ * The filename one image is written under: `<slug>-<size>.png`, or
+ * `<slug>-<size>.<hash>.png` where the placement asks for a hash. The slug
+ * carries the post's keywords, and the size name keeps every image of a post
+ * distinct (`my-post-og.png`, `my-post-square.png`).
+ *
+ * A slug carrying directories of its own — what the `route` strategy produces,
+ * and what a frontmatter `slug` of `docs/intro` means — puts them in the name,
+ * so the image's path mirrors the route wherever it is placed.
+ *
+ * The digest is the image's rebuild stamp: the props, the config and the size
+ * it is drawn from. Hashing the rendered bytes would be a truer name, but they
+ * are not known until the image has been rendered, and the point of the stamp
+ * is not rendering the ones that have not changed.
+ */
+export function imageName(file, size, hash) {
+    const stem = `${file.slug}-${size.name}`;
+    return hash === undefined
+        ? `${stem}.png`
+        : `${stem}.${hash.slice(0, hashLength)}.png`;
+}
+/**
+ * Where an image goes relative to the content root, in URL form.
+ *
+ * Slashes rather than the platform's separator, because this is also what a
+ * URL is built from: a Windows build must not serve `posts\my-post\a.png`.
+ * The disk path is joined back up per platform by whoever places it.
+ *
+ * A slug with directories of its own is placed from the content root, so its
+ * path mirrors the route. Resolving it beside the file would repeat the
+ * directories already in the slug, putting `services/iam` under
+ * `content/services/iam/`.
+ */
+export function besideContent(file, size, hash) {
+    const name = imageName(file, size, hash);
+    if (file.slug.includes("/")) {
+        return name;
+    }
+    const directory = path.dirname(file.contentPath);
+    return directory === "." || directory === ""
+        ? name
+        : `${directory.split(path.sep).join("/")}/${name}`;
+}
+//# sourceMappingURL=relative.js.map

package/dist/placement/relative.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"relative.js","sourceRoot":"","sources":["../../src/placement/relative.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAI7B;;;;;;GAMG;AACH,MAAM,UAAU,GAAG,CAAC,CAAC;AAErB;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,SAAS,CACvB,IAAiB,EACjB,IAAgB,EAChB,IAAwB;IAExB,MAAM,IAAI,GAAG,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;IAEzC,OAAO,IAAI,KAAK,SAAS;QACvB,CAAC,CAAC,GAAG,IAAI,MAAM;QACf,CAAC,CAAC,GAAG,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,MAAM,CAAC;AACjD,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,aAAa,CAC3B,IAAiB,EACjB,IAAgB,EAChB,IAAwB;IAExB,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAEzC,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAEjD,OAAO,SAAS,KAAK,GAAG,IAAI,SAAS,KAAK,EAAE;QAC1C,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,GAAG,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC;AACvD,CAAC"}

package/dist/pool.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Map over `items` with at most `limit` calls to `worker` in flight at once,
+ * returning the results in input order.
+ *
+ * `Promise.all` over a mapped array starts everything at once, which for a
+ * few hundred images means a few hundred rasterisations queued on the thread
+ * pool with every pending bitmap held in memory. This starts `limit` workers
+ * instead and lets each pull the next item as it finishes, so the work in
+ * flight stays bounded however large the input is.
+ *
+ * The first rejection propagates, as it would from `Promise.all`. Items
+ * already in flight run to completion — there is no cancelling a render — but
+ * no further ones are started.
+ *
+ * Throws if `limit` is not a positive integer.
+ */
+export declare function mapConcurrent<Item, Result>(items: readonly Item[], limit: number, worker: (item: Item, index: number) => Promise<Result>): Promise<Result[]>;
+//# sourceMappingURL=pool.d.ts.map

package/dist/pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pool.d.ts","sourceRoot":"","sources":["../src/pool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAC9C,KAAK,EAAE,SAAS,IAAI,EAAE,EACtB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,GACrD,OAAO,CAAC,MAAM,EAAE,CAAC,CA8CnB"}

package/dist/pool.js

@@ -0,0 +1,56 @@
+/**
+ * Map over `items` with at most `limit` calls to `worker` in flight at once,
+ * returning the results in input order.
+ *
+ * `Promise.all` over a mapped array starts everything at once, which for a
+ * few hundred images means a few hundred rasterisations queued on the thread
+ * pool with every pending bitmap held in memory. This starts `limit` workers
+ * instead and lets each pull the next item as it finishes, so the work in
+ * flight stays bounded however large the input is.
+ *
+ * The first rejection propagates, as it would from `Promise.all`. Items
+ * already in flight run to completion — there is no cancelling a render — but
+ * no further ones are started.
+ *
+ * Throws if `limit` is not a positive integer.
+ */
+export async function mapConcurrent(items, limit, worker) {
+    // A limit below one starts no workers at all, and an empty `Promise.all`
+    // resolves happily — so the caller would get an empty result back as though
+    // there had been nothing to do. A build reporting success having rendered
+    // nothing is the failure worth being loud about.
+    if (!Number.isSafeInteger(limit) || limit < 1) {
+        throw new Error(`Invalid concurrency limit ${String(limit)}; expected a positive integer.`);
+    }
+    // Assigned by index rather than pushed, so results come back in input order
+    // however the workers interleave.
+    const results = [];
+    // One shared iterator is the queue: each worker pulls the next entry when it
+    // is free, so a slow item holds up only itself rather than a fixed share of
+    // the work.
+    const queue = items.entries();
+    let isStopped = false;
+    async function run() {
+        for (const [index, item] of queue) {
+            if (isStopped) {
+                return;
+            }
+            // Awaiting in the loop is the whole point: a worker takes one item at a
+            // time, and the parallelism comes from there being several of them.
+            // eslint-disable-next-line no-await-in-loop
+            results[index] = await worker(item, index);
+        }
+    }
+    const workers = Array.from({ length: Math.min(limit, items.length) }, () => run());
+    try {
+        await Promise.all(workers);
+    }
+    catch (error) {
+        // The run is already lost, so stop feeding it: a build that fails on the
+        // first file should not render the rest of the tree before it exits.
+        isStopped = true;
+        throw error;
+    }
+    return results;
+}
+//# sourceMappingURL=pool.js.map

package/dist/pool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pool.js","sourceRoot":"","sources":["../src/pool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,KAAsB,EACtB,KAAa,EACb,MAAsD;IAEtD,yEAAyE;IACzE,4EAA4E;IAC5E,0EAA0E;IAC1E,iDAAiD;IACjD,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QAC9C,MAAM,IAAI,KAAK,CACb,6BAA6B,MAAM,CAAC,KAAK,CAAC,gCAAgC,CAC3E,CAAC;IACJ,CAAC;IAED,4EAA4E;IAC5E,kCAAkC;IAClC,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,6EAA6E;IAC7E,4EAA4E;IAC5E,YAAY;IACZ,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC;IAC9B,IAAI,SAAS,GAAG,KAAK,CAAC;IAEtB,KAAK,UAAU,GAAG;QAChB,KAAK,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,KAAK,EAAE,CAAC;YAClC,IAAI,SAAS,EAAE,CAAC;gBACd,OAAO;YACT,CAAC;YACD,wEAAwE;YACxE,oEAAoE;YACpE,4CAA4C;YAC5C,OAAO,CAAC,KAAK,CAAC,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,EAAE,CACzE,GAAG,EAAE,CACN,CAAC;IAEF,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,yEAAyE;QACzE,qEAAqE;QACrE,SAAS,GAAG,IAAI,CAAC;QACjB,MAAM,KAAK,CAAC;IACd,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/render/index.d.ts

@@ -0,0 +1,10 @@
+import type { ColophonConfig, MetaImageProps, RenderedMetaImage } from "../types.js";
+export { buildSvg } from "./svg.js";
+export { renderSvgToPng } from "./png.js";
+/**
+ * Render an image for every configured output size from a single set of props.
+ * This is the reusable core: it takes props and config and returns rendered
+ * bytes, with no filesystem or content-discovery concerns.
+ */
+export declare function renderMetaImages(props: MetaImageProps, config?: ColophonConfig): Promise<RenderedMetaImage[]>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/render/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EACd,iBAAiB,EAClB,MAAM,aAAa,CAAC;AAKrB,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpC,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE1C;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,cAAc,EACrB,MAAM,CAAC,EAAE,cAAc,GACtB,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAiB9B"}

package/dist/render/index.js

@@ -0,0 +1,27 @@
+import { resolveConfig } from "../config/index.js";
+import { resolveConfigForSize } from "../config/size.js";
+import { renderSvgToPng } from "./png.js";
+import { buildSvg } from "./svg.js";
+import { selectTemplate } from "./template.js";
+export { buildSvg } from "./svg.js";
+export { renderSvgToPng } from "./png.js";
+/**
+ * Render an image for every configured output size from a single set of props.
+ * This is the reusable core: it takes props and config and returns rendered
+ * bytes, with no filesystem or content-discovery concerns.
+ */
+export async function renderMetaImages(props, config) {
+    const resolved = resolveConfig(config);
+    // Validate the template once up front so a bad name fails fast.
+    selectTemplate(resolved, props.template);
+    return Promise.all(resolved.sizes.map(async (size) => {
+        // Each size renders with its own overrides folded in, so one size wanting
+        // a smaller minimum font does not mean a second pass over everything.
+        const sizeConfig = resolveConfigForSize(config, size);
+        const dimensions = { width: size.width, height: size.height };
+        const svg = await buildSvg(props, sizeConfig, dimensions);
+        const png = await renderSvgToPng(svg, dimensions, sizeConfig);
+        return { name: size.name, dimensions, svg, png };
+    }));
+}
+//# sourceMappingURL=index.js.map

package/dist/render/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/render/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAMzD,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpC,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpC,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE1C;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,KAAqB,EACrB,MAAuB;IAEvB,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IAEvC,gEAAgE;IAChE,cAAc,CAAC,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;IAEzC,OAAO,OAAO,CAAC,GAAG,CAChB,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QAChC,0EAA0E;QAC1E,sEAAsE;QACtE,MAAM,UAAU,GAAG,oBAAoB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QACtD,MAAM,UAAU,GAAG,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;QAC9D,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,KAAK,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;QAC1D,MAAM,GAAG,GAAG,MAAM,cAAc,CAAC,GAAG,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;QAC9D,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;IACnD,CAAC,CAAC,CACH,CAAC;AACJ,CAAC"}

package/dist/render/png.d.ts

@@ -0,0 +1,10 @@
+import type { Dimensions, ResolvedConfig } from "../types.js";
+/**
+ * Rasterise an SVG string to a PNG buffer, scaled to `dimensions.width`.
+ *
+ * Text is drawn with the fonts named by `config`, which is what keeps the
+ * output the same on a laptop, in CI and in a container. Height follows the
+ * SVG's own aspect ratio; `buildSvg` sizes it to match.
+ */
+export declare function renderSvgToPng(svg: string, dimensions: Dimensions, config?: ResolvedConfig): Promise<Buffer>;
+//# sourceMappingURL=png.d.ts.map

package/dist/render/png.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"png.d.ts","sourceRoot":"","sources":["../../src/render/png.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAkB9D;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,UAAU,EACtB,MAAM,GAAE,cAAgC,GACvC,OAAO,CAAC,MAAM,CAAC,CAOjB"}

package/dist/render/png.js

@@ -0,0 +1,30 @@
+import { renderAsync } from "@resvg/resvg-js";
+import { resolveConfig } from "../config/index.js";
+import { fallbackFamily, fontFilePaths } from "../fonts/index.js";
+/**
+ * Font options for the rasteriser: the configured font files, and whether to
+ * fall back to the machine's own.
+ */
+async function fontOptions(config) {
+    const fallback = fallbackFamily(config.fonts);
+    return {
+        loadSystemFonts: config.systemFonts,
+        fontFiles: await fontFilePaths(config.fonts),
+        ...(fallback !== undefined && { defaultFontFamily: fallback }),
+    };
+}
+/**
+ * Rasterise an SVG string to a PNG buffer, scaled to `dimensions.width`.
+ *
+ * Text is drawn with the fonts named by `config`, which is what keeps the
+ * output the same on a laptop, in CI and in a container. Height follows the
+ * SVG's own aspect ratio; `buildSvg` sizes it to match.
+ */
+export async function renderSvgToPng(svg, dimensions, config = resolveConfig()) {
+    const rendered = await renderAsync(svg, {
+        fitTo: { mode: "width", value: dimensions.width },
+        font: await fontOptions(config),
+    });
+    return rendered.asPng();
+}
+//# sourceMappingURL=png.js.map

package/dist/render/png.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"png.js","sourceRoot":"","sources":["../../src/render/png.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE9C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGlE;;;GAGG;AACH,KAAK,UAAU,WAAW,CACxB,MAAsB;IAEtB,MAAM,QAAQ,GAAG,cAAc,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAE9C,OAAO;QACL,eAAe,EAAE,MAAM,CAAC,WAAW;QACnC,SAAS,EAAE,MAAM,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC;QAC5C,GAAG,CAAC,QAAQ,KAAK,SAAS,IAAI,EAAE,iBAAiB,EAAE,QAAQ,EAAE,CAAC;KAC/D,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,GAAW,EACX,UAAsB,EACtB,MAAM,GAAmB,aAAa,EAAE;IAExC,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,GAAG,EAAE;QACtC,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,CAAC,KAAK,EAAE;QACjD,IAAI,EAAE,MAAM,WAAW,CAAC,MAAM,CAAC;KAChC,CAAC,CAAC;IAEH,OAAO,QAAQ,CAAC,KAAK,EAAE,CAAC;AAC1B,CAAC"}

package/dist/render/svg.d.ts

@@ -0,0 +1,10 @@
+import type { Dimensions, MetaImageProps, ResolvedConfig } from "../types.js";
+/**
+ * Build the complete SVG document for one image: the enclosing `<svg>` root,
+ * the config-driven background, and the template's foreground content.
+ *
+ * Asynchronous because a template may need to load resources — the `code`
+ * template fetches syntax grammars and themes on demand.
+ */
+export declare function buildSvg(props: MetaImageProps, config: ResolvedConfig, dimensions: Dimensions): Promise<string>;
+//# sourceMappingURL=svg.d.ts.map

package/dist/render/svg.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"svg.d.ts","sourceRoot":"","sources":["../../src/render/svg.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAK9E;;;;;;GAMG;AACH,wBAAsB,QAAQ,CAC5B,KAAK,EAAE,cAAc,EACrB,MAAM,EAAE,cAAc,EACtB,UAAU,EAAE,UAAU,GACrB,OAAO,CAAC,MAAM,CAAC,CAWjB"}

package/dist/render/svg.js

@@ -0,0 +1,20 @@
+import { backgroundSvg } from "../background.js";
+import { selectTemplate } from "./template.js";
+const backgroundId = "colophon-bg";
+/**
+ * Build the complete SVG document for one image: the enclosing `<svg>` root,
+ * the config-driven background, and the template's foreground content.
+ *
+ * Asynchronous because a template may need to load resources — the `code`
+ * template fetches syntax grammars and themes on demand.
+ */
+export async function buildSvg(props, config, dimensions) {
+    const template = selectTemplate(config, props.template);
+    const background = backgroundSvg(config.background, dimensions, backgroundId);
+    const body = await template.render({ props, config, dimensions });
+    const { width, height } = dimensions;
+    return (`<svg width="${String(width)}" height="${String(height)}"` +
+        ` viewBox="0 0 ${String(width)} ${String(height)}"` +
+        ` xmlns="http://www.w3.org/2000/svg">${background}${body}</svg>`);
+}
+//# sourceMappingURL=svg.js.map

package/dist/render/svg.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"svg.js","sourceRoot":"","sources":["../../src/render/svg.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C,MAAM,YAAY,GAAG,aAAa,CAAC;AAEnC;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,KAAqB,EACrB,MAAsB,EACtB,UAAsB;IAEtB,MAAM,QAAQ,GAAG,cAAc,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;IACxD,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,UAAU,EAAE,UAAU,EAAE,YAAY,CAAC,CAAC;IAC9E,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;IAClE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC;IAErC,OAAO,CACL,eAAe,MAAM,CAAC,KAAK,CAAC,aAAa,MAAM,CAAC,MAAM,CAAC,GAAG;QAC1D,iBAAiB,MAAM,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,GAAG;QACnD,uCAAuC,UAAU,GAAG,IAAI,QAAQ,CACjE,CAAC;AACJ,CAAC"}

package/dist/render/template.d.ts

@@ -0,0 +1,9 @@
+import type { ResolvedConfig, Template } from "../types.js";
+/**
+ * Look up the template a set of props asks for, failing with the names that
+ * are actually available. A template name comes from frontmatter, so getting
+ * it wrong is routine, and "unknown template" alone leaves the author guessing
+ * at what the project registered.
+ */
+export declare function selectTemplate(config: ResolvedConfig, name: string): Template;
+//# sourceMappingURL=template.d.ts.map

package/dist/render/template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../../src/render/template.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5D;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,QAAQ,CAa7E"}

package/dist/render/template.js

@@ -0,0 +1,17 @@
+/**
+ * Look up the template a set of props asks for, failing with the names that
+ * are actually available. A template name comes from frontmatter, so getting
+ * it wrong is routine, and "unknown template" alone leaves the author guessing
+ * at what the project registered.
+ */
+export function selectTemplate(config, name) {
+    const template = config.templates[name];
+    if (template === undefined) {
+        const available = Object.keys(config.templates)
+            .toSorted((a, b) => a.localeCompare(b))
+            .join(", ");
+        throw new Error(`Unknown template "${name}". Available templates: ${available}.`);
+    }
+    return template;
+}
+//# sourceMappingURL=template.js.map

package/dist/render/template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.js","sourceRoot":"","sources":["../../src/render/template.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,MAAsB,EAAE,IAAY;IACjE,MAAM,QAAQ,GAAG,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAExC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC;aAC5C,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;aACtC,IAAI,CAAC,IAAI,CAAC,CAAC;QACd,MAAM,IAAI,KAAK,CACb,qBAAqB,IAAI,2BAA2B,SAAS,GAAG,CACjE,CAAC;IACJ,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/render.d.ts

@@ -8,9 +8,13 @@ import type { ColophonConfig, Dimensions, MetaImageProps, RenderedMetaImage, Res
  */
 export declare function buildSvg(props: MetaImageProps, config: ResolvedConfig, dimensions: Dimensions): Promise<string>;
 /**
- * Rasterise an SVG string to a PNG buffer at the given dimensions.
+ * Rasterise an SVG string to a PNG buffer, scaled to `dimensions.width`.
+ *
+ * Text is drawn with the fonts named by `config`, which is what keeps the
+ * output the same on a laptop, in CI and in a container. Height follows the
+ * SVG's own aspect ratio; {@link buildSvg} sizes it to match.
  */
-export declare function renderSvgToPng(svg: string, dimensions: Dimensions): Promise<Buffer>;
+export declare function renderSvgToPng(svg: string, dimensions: Dimensions, config?: ResolvedConfig): Promise<Buffer>;
 /**
  * Render an image for every configured output size from a single set of props.
  * This is the reusable core: it takes props and config and returns rendered

package/dist/render.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../src/render.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,cAAc,EACd,UAAU,EACV,cAAc,EACd,iBAAiB,EACjB,cAAc,EAEf,MAAM,YAAY,CAAC;AAmBpB;;;;;;GAMG;AACH,wBAAsB,QAAQ,CAC5B,KAAK,EAAE,cAAc,EACrB,MAAM,EAAE,cAAc,EACtB,UAAU,EAAE,UAAU,GACrB,OAAO,CAAC,MAAM,CAAC,CAWjB;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,UAAU,GACrB,OAAO,CAAC,MAAM,CAAC,CAKjB;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,cAAc,EACrB,MAAM,CAAC,EAAE,cAAc,GACtB,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAc9B"}
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../src/render.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,cAAc,EACd,UAAU,EACV,cAAc,EACd,iBAAiB,EACjB,cAAc,EAEf,MAAM,YAAY,CAAC;AAmBpB;;;;;;GAMG;AACH,wBAAsB,QAAQ,CAC5B,KAAK,EAAE,cAAc,EACrB,MAAM,EAAE,cAAc,EACtB,UAAU,EAAE,UAAU,GACrB,OAAO,CAAC,MAAM,CAAC,CAWjB;AAkBD;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,UAAU,EACtB,MAAM,GAAE,cAAgC,GACvC,OAAO,CAAC,MAAM,CAAC,CAOjB;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,cAAc,EACrB,MAAM,CAAC,EAAE,cAAc,GACtB,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAiB9B"}

package/dist/render.js

@@ -1,6 +1,7 @@
-import sharp from "sharp";
+import { renderAsync } from "@resvg/resvg-js";
 import { backgroundSvg } from "./background.js";
-import { resolveConfig } from "./config.js";
+import { resolveConfig, resolveConfigForSize } from "./config.js";
+import { fallbackFamily, fontFilePaths } from "./fonts.js";
 const backgroundId = "colophon-bg";
 function selectTemplate(config, name) {
     const template = config.templates[name];
@@ -29,13 +30,30 @@ export async function buildSvg(props, config, dimensions) {
         ` xmlns="http://www.w3.org/2000/svg">${background}${body}</svg>`);
 }
 /**
- * Rasterise an SVG string to a PNG buffer at the given dimensions.
+ * Font options for the rasteriser: the configured font files, and whether to
+ * fall back to the machine's own.
  */
-export async function renderSvgToPng(svg, dimensions) {
-    return sharp(Buffer.from(svg))
-        .resize(dimensions.width, dimensions.height, { fit: "fill" })
-        .png()
-        .toBuffer();
+async function fontOptions(config) {
+    const fallback = fallbackFamily(config.fonts);
+    return {
+        loadSystemFonts: config.systemFonts,
+        fontFiles: await fontFilePaths(config.fonts),
+        ...(fallback !== undefined && { defaultFontFamily: fallback }),
+    };
+}
+/**
+ * Rasterise an SVG string to a PNG buffer, scaled to `dimensions.width`.
+ *
+ * Text is drawn with the fonts named by `config`, which is what keeps the
+ * output the same on a laptop, in CI and in a container. Height follows the
+ * SVG's own aspect ratio; {@link buildSvg} sizes it to match.
+ */
+export async function renderSvgToPng(svg, dimensions, config = resolveConfig()) {
+    const rendered = await renderAsync(svg, {
+        fitTo: { mode: "width", value: dimensions.width },
+        font: await fontOptions(config),
+    });
+    return rendered.asPng();
 }
 /**
  * Render an image for every configured output size from a single set of props.
@@ -47,9 +65,12 @@ export async function renderMetaImages(props, config) {
     // Validate the template once up front so a bad name fails fast.
     selectTemplate(resolved, props.template);
     return Promise.all(resolved.sizes.map(async (size) => {
+        // Each size renders with its own overrides folded in, so one size wanting
+        // a smaller minimum font does not mean a second pass over everything.
+        const sizeConfig = resolveConfigForSize(config, size);
         const dimensions = { width: size.width, height: size.height };
-        const svg = await buildSvg(props, resolved, dimensions);
-        const png = await renderSvgToPng(svg, dimensions);
+        const svg = await buildSvg(props, sizeConfig, dimensions);
+        const png = await renderSvgToPng(svg, dimensions, sizeConfig);
         return { name: size.name, dimensions, svg, png };
     }));
 }

package/dist/render.js.map

@@ -1 +1 @@
-{"version":3,"file":"render.js","sourceRoot":"","sources":["../src/render.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAU5C,MAAM,YAAY,GAAG,aAAa,CAAC;AAEnC,SAAS,cAAc,CAAC,MAAsB,EAAE,IAAY;IAC1D,MAAM,QAAQ,GAAG,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAExC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC;aAC5C,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;aACtC,IAAI,CAAC,IAAI,CAAC,CAAC;QACd,MAAM,IAAI,KAAK,CACb,qBAAqB,IAAI,2BAA2B,SAAS,GAAG,CACjE,CAAC;IACJ,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,KAAqB,EACrB,MAAsB,EACtB,UAAsB;IAEtB,MAAM,QAAQ,GAAG,cAAc,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;IACxD,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,UAAU,EAAE,UAAU,EAAE,YAAY,CAAC,CAAC;IAC9E,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;IAClE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC;IAErC,OAAO,CACL,eAAe,MAAM,CAAC,KAAK,CAAC,aAAa,MAAM,CAAC,MAAM,CAAC,GAAG;QAC1D,iBAAiB,MAAM,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,GAAG;QACnD,uCAAuC,UAAU,GAAG,IAAI,QAAQ,CACjE,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,GAAW,EACX,UAAsB;IAEtB,OAAO,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;SAC3B,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,UAAU,CAAC,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC;SAC5D,GAAG,EAAE;SACL,QAAQ,EAAE,CAAC;AAChB,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,KAAqB,EACrB,MAAuB;IAEvB,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IAEvC,gEAAgE;IAChE,cAAc,CAAC,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;IAEzC,OAAO,OAAO,CAAC,GAAG,CAChB,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QAChC,MAAM,UAAU,GAAG,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;QAC9D,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,KAAK,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;QACxD,MAAM,GAAG,GAAG,MAAM,cAAc,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;QAClD,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;IACnD,CAAC,CAAC,CACH,CAAC;AACJ,CAAC"}
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../src/render.ts"],"names":[],"mappings":"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"}

package/dist/stamp/chunk.d.ts

@@ -0,0 +1,16 @@
+/**
+ * PNG `tEXt` keyword the stamp is stored under. Keeping it in the image means
+ * there is no sidecar file to fall out of sync, and deleting an image deletes
+ * its stamp with it.
+ */
+export declare const stampKeyword = "colophon";
+/** The eight bytes every PNG file starts with. */
+export declare const pngSignature: Buffer<ArrayBuffer>;
+/** Signature + the whole `IHDR` chunk: length, type, 13 bytes of data, CRC. */
+export declare const afterHeader: number;
+/**
+ * Return `png` with the stamp embedded as a `tEXt` chunk, inserted straight
+ * after the header so it can be read back without decoding the image.
+ */
+export declare function stampPng(png: Buffer, stamp: string): Buffer;
+//# sourceMappingURL=chunk.d.ts.map

package/dist/stamp/chunk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk.d.ts","sourceRoot":"","sources":["../../src/stamp/chunk.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,eAAO,MAAM,YAAY,aAAa,CAAC;AAEvC,kDAAkD;AAClD,eAAO,MAAM,YAAY,qBAEvB,CAAC;AAEH,+EAA+E;AAC/E,eAAO,MAAM,WAAW,QAAuC,CAAC;AAwBhE;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAc3D"}

package/dist/stamp/chunk.js

@@ -0,0 +1,46 @@
+import { crc32 } from "node:zlib";
+/**
+ * PNG `tEXt` keyword the stamp is stored under. Keeping it in the image means
+ * there is no sidecar file to fall out of sync, and deleting an image deletes
+ * its stamp with it.
+ */
+export const stampKeyword = "colophon";
+/** The eight bytes every PNG file starts with. */
+export const pngSignature = Buffer.from([
+    0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a,
+]);
+/** Signature + the whole `IHDR` chunk: length, type, 13 bytes of data, CRC. */
+export const afterHeader = pngSignature.length + 4 + 4 + 13 + 4;
+/**
+ * A PNG `tEXt` chunk: length, type, `keyword\0text`, CRC over type and data.
+ */
+function textChunk(keyword, text) {
+    const data = Buffer.concat([
+        Buffer.from(keyword, "latin1"),
+        Buffer.from([0]),
+        Buffer.from(text, "latin1"),
+    ]);
+    const chunk = Buffer.alloc(4 + 4 + data.length + 4);
+    chunk.writeUInt32BE(data.length, 0);
+    chunk.write("tEXt", 4, "latin1");
+    data.copy(chunk, 8);
+    chunk.writeUInt32BE(crc32(chunk.subarray(4, 8 + data.length)), 8 + data.length);
+    return chunk;
+}
+/**
+ * Return `png` with the stamp embedded as a `tEXt` chunk, inserted straight
+ * after the header so it can be read back without decoding the image.
+ */
+export function stampPng(png, stamp) {
+    if (png.length < afterHeader ||
+        !png.subarray(0, pngSignature.length).equals(pngSignature) ||
+        png.toString("latin1", 12, 16) !== "IHDR") {
+        throw new Error("Cannot stamp: not a PNG image.");
+    }
+    return Buffer.concat([
+        png.subarray(0, afterHeader),
+        textChunk(stampKeyword, stamp),
+        png.subarray(afterHeader),
+    ]);
+}
+//# sourceMappingURL=chunk.js.map

package/dist/stamp/chunk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk.js","sourceRoot":"","sources":["../../src/stamp/chunk.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAElC;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,UAAU,CAAC;AAEvC,kDAAkD;AAClD,MAAM,CAAC,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC;IACtC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI;CAC/C,CAAC,CAAC;AAEH,+EAA+E;AAC/E,MAAM,CAAC,MAAM,WAAW,GAAG,YAAY,CAAC,MAAM,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;AAEhE;;GAEG;AACH,SAAS,SAAS,CAAC,OAAe,EAAE,IAAY;IAC9C,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC;QACzB,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC;QAC9B,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QAChB,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC;KAC5B,CAAC,CAAC;IACH,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAEpD,KAAK,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IACpC,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,QAAQ,CAAC,CAAC;IACjC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IACpB,KAAK,CAAC,aAAa,CACjB,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,EACzC,CAAC,GAAG,IAAI,CAAC,MAAM,CAChB,CAAC;IAEF,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,GAAW,EAAE,KAAa;IACjD,IACE,GAAG,CAAC,MAAM,GAAG,WAAW;QACxB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC;QAC1D,GAAG,CAAC,QAAQ,CAAC,QAAQ,EAAE,EAAE,EAAE,EAAE,CAAC,KAAK,MAAM,EACzC,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACpD,CAAC;IAED,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,GAAG,CAAC,QAAQ,CAAC,CAAC,EAAE,WAAW,CAAC;QAC5B,SAAS,CAAC,YAAY,EAAE,KAAK,CAAC;QAC9B,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC;KAC1B,CAAC,CAAC;AACL,CAAC"}

package/dist/stamp/config-digest.d.ts

@@ -0,0 +1,11 @@
+import type { ResolvedConfig } from "../types.js";
+/**
+ * Digest the config fields that affect what an image looks like.
+ *
+ * `onWarning` is left out because it cannot change a pixel. So are `sizes` and
+ * `templates`: the one size and the one template an image actually uses go into
+ * its own stamp, so adding a third size or an unrelated custom template does
+ * not invalidate everything already on disk.
+ */
+export declare function configDigest(config: ResolvedConfig): Promise<string>;
+//# sourceMappingURL=config-digest.d.ts.map

package/dist/stamp/config-digest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-digest.d.ts","sourceRoot":"","sources":["../../src/stamp/config-digest.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAc,cAAc,EAAE,MAAM,aAAa,CAAC;AA0B9D;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAkB1E"}

package/dist/stamp/config-digest.js

@@ -0,0 +1,43 @@
+import { readFile } from "node:fs/promises";
+import { sha256, stableStringify } from "./digest.js";
+/**
+ * The installed Colophon version. The built-in templates ship in this package,
+ * so an upgrade can change what an image looks like without anything in the
+ * project changing; folding the version into the stamp makes that upgrade
+ * re-render rather than leave the old images in place.
+ */
+async function packageVersion() {
+    const manifest = await readFile(new URL("../../package.json", import.meta.url), "utf8");
+    return JSON.parse(manifest).version;
+}
+/**
+ * Digest one configured font by its contents, not its path: replacing the file
+ * at the same path changes every image drawn with it.
+ */
+async function fontDigest(font) {
+    const bytes = "data" in font ? font.data : await readFile(font.path);
+    return sha256(stableStringify({ family: font.family, bytes: sha256(bytes) }));
+}
+/**
+ * Digest the config fields that affect what an image looks like.
+ *
+ * `onWarning` is left out because it cannot change a pixel. So are `sizes` and
+ * `templates`: the one size and the one template an image actually uses go into
+ * its own stamp, so adding a third size or an unrelated custom template does
+ * not invalidate everything already on disk.
+ */
+export async function configDigest(config) {
+    const fonts = await Promise.all(config.fonts.map(async (font) => fontDigest(font)));
+    return sha256(stableStringify({
+        version: await packageVersion(),
+        colors: config.colors,
+        background: config.background,
+        fonts,
+        systemFonts: config.systemFonts,
+        fontFamily: config.fontFamily,
+        footer: config.footer,
+        badge: config.badge,
+        code: config.code,
+    }));
+}
+//# sourceMappingURL=config-digest.js.map

package/dist/stamp/config-digest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-digest.js","sourceRoot":"","sources":["../../src/stamp/config-digest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAG5C,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEtD;;;;;GAKG;AACH,KAAK,UAAU,cAAc;IAC3B,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAC7B,IAAI,GAAG,CAAC,oBAAoB,EAAE,OAAO,IAAI,CAAC,GAAG,CAAC,EAC9C,MAAM,CACP,CAAC;IACF,OAAQ,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAyB,CAAC,OAAO,CAAC;AAC/D,CAAC;AAED;;;GAGG;AACH,KAAK,UAAU,UAAU,CAAC,IAAgB;IACxC,MAAM,KAAK,GAAG,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACrE,OAAO,MAAM,CAAC,eAAe,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;AAChF,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,MAAsB;IACvD,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,GAAG,CAC7B,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CACnD,CAAC;IAEF,OAAO,MAAM,CACX,eAAe,CAAC;QACd,OAAO,EAAE,MAAM,cAAc,EAAE;QAC/B,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,KAAK;QACL,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,IAAI,EAAE,MAAM,CAAC,IAAI;KAClB,CAAC,CACH,CAAC;AACJ,CAAC"}

package/dist/stamp/digest.d.ts

@@ -0,0 +1,8 @@
+/** SHA-256 of a string or buffer, as hex. */
+export declare function sha256(value: string | Uint8Array): string;
+/**
+ * `JSON.stringify` with object keys sorted, so that reordering frontmatter
+ * without changing it does not look like a change.
+ */
+export declare function stableStringify(value: unknown): string;
+//# sourceMappingURL=digest.d.ts.map

package/dist/stamp/digest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"digest.d.ts","sourceRoot":"","sources":["../../src/stamp/digest.ts"],"names":[],"mappings":"AAEA,6CAA6C;AAC7C,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM,CAEzD;AAMD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAUtD"}

package/dist/stamp/digest.js

@@ -0,0 +1,20 @@
+import { createHash } from "node:crypto";
+/** SHA-256 of a string or buffer, as hex. */
+export function sha256(value) {
+    return createHash("sha256").update(value).digest("hex");
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/**
+ * `JSON.stringify` with object keys sorted, so that reordering frontmatter
+ * without changing it does not look like a change.
+ */
+export function stableStringify(value) {
+    return JSON.stringify(value, (_key, raw) => isRecord(raw)
+        ? Object.fromEntries(Object.keys(raw)
+            .toSorted((a, b) => a.localeCompare(b))
+            .map((key) => [key, raw[key]]))
+        : raw);
+}
+//# sourceMappingURL=digest.js.map

package/dist/stamp/digest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"digest.js","sourceRoot":"","sources":["../../src/stamp/digest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,6CAA6C;AAC7C,MAAM,UAAU,MAAM,CAAC,KAA0B;IAC/C,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC1D,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,GAAY,EAAE,EAAE,CAClD,QAAQ,CAAC,GAAG,CAAC;QACX,CAAC,CAAC,MAAM,CAAC,WAAW,CAChB,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;aACb,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;aACtC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CACjC;QACH,CAAC,CAAC,GAAG,CACR,CAAC;AACJ,CAAC"}

package/dist/stamp/index.d.ts

@@ -0,0 +1,20 @@
+import type { MetaImageProps, OutputSize, ResolvedConfig } from "../types.js";
+export { stampPng } from "./chunk.js";
+export { readPngStamp } from "./read.js";
+/**
+ * Computes stamps for the images rendered from one resolved config.
+ */
+export interface Stamper {
+    /**
+     * The stamp for one image: a digest of the props, the config and the size it
+     * was rendered from. Equal stamps mean re-rendering would produce the same
+     * image.
+     */
+    stamp(props: MetaImageProps, size: OutputSize): string;
+}
+/**
+ * Build a {@link Stamper} for a resolved config. Asynchronous because it reads
+ * the configured font files; do it once per run rather than once per image.
+ */
+export declare function createStamper(config: ResolvedConfig): Promise<Stamper>;
+//# sourceMappingURL=index.d.ts.map