@kensio/colophon 2.1.0 → 2.3.0

package/dist/generate/job.d.ts

@@ -0,0 +1,35 @@
+import type { MetaImageProps, OutputSize, ResolvedConfig } from "../types.js";
+/**
+ * One image to render: what to draw, how big, where it goes, and the config it
+ * is drawn with. A content file becomes one job per size; a config `extra`
+ * becomes a single job of its own.
+ *
+ * Working the paths and configs out while planning is what lets the two
+ * sources meet: by the time anything is rendered there are only jobs, and
+ * nothing downstream has to ask which kind of image it is holding.
+ */
+export interface RenderJob {
+    /**
+     * The content file this image came from, relative to the content root.
+     * `undefined` for an extra image, which has no content file.
+     */
+    readonly contentPath: string | undefined;
+    /**
+     * The slug the page is addressed by, and the key it appears under in the
+     * manifest. `undefined` for an extra image, which is not a page.
+     */
+    readonly slug: string | undefined;
+    readonly props: MetaImageProps;
+    readonly size: OutputSize;
+    readonly outputPath: string;
+    /** Where the image is served, if the placement knows. */
+    readonly url: string | undefined;
+    /**
+     * The digest of everything this image is drawn from. An image on disk
+     * carrying the same one is already up to date, and a placement that hashes
+     * filenames names the file after it.
+     */
+    readonly stamp: string;
+    readonly config: ResolvedConfig;
+}
+//# sourceMappingURL=job.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"job.d.ts","sourceRoot":"","sources":["../../src/generate/job.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE9E;;;;;;;;GAQG;AACH,MAAM,WAAW,SAAS;IACxB;;;OAGG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,yDAAyD;IACzD,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;CACjC"}

package/dist/generate/job.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=job.js.map

package/dist/generate/job.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"job.js","sourceRoot":"","sources":["../../src/generate/job.ts"],"names":[],"mappings":""}

package/dist/generate/options.d.ts

@@ -0,0 +1,56 @@
+import type { ContentFile, WalkOptions } from "../content/index.js";
+import type { ColophonConfig, OutputSize } from "../types.js";
+/**
+ * Outcome for one generated (or skipped) image.
+ */
+export interface GeneratedImage {
+    /**
+     * The content file this image came from, relative to the content root.
+     * `undefined` for a config `extra` image: there is no post behind it, and
+     * naming one — the output path, say — would quietly break anything grouping
+     * results by the post they belong to.
+     */
+    readonly contentPath: string | undefined;
+    readonly size: OutputSize;
+    readonly outputPath: string;
+    /**
+     * Where the image is served, from the configured placement. `undefined`
+     * when nothing says: no `urlBase`, an image placed by `outputPath`, or an
+     * `extra` that named its own path.
+     */
+    readonly url: string | undefined;
+    /** True when an up-to-date image was left in place (no `overwrite`). */
+    readonly skipped: boolean;
+}
+/**
+ * Options for `generate`.
+ */
+export interface GenerateOptions {
+    /** Root content directory to walk. */
+    readonly contentDir: string;
+    readonly config?: ColophonConfig;
+    /** Extra walk options (props key, template field, slug field, extensions). */
+    readonly walk?: Omit<WalkOptions, "dir">;
+    /** Override where each image is written. */
+    readonly outputPath?: (file: ContentFile, size: OutputSize) => string;
+    /**
+     * Re-render every image, ignoring the stamps that would otherwise mark them
+     * as up to date. Default `false`.
+     */
+    readonly overwrite?: boolean;
+    /**
+     * How many images to render at once. Defaults to the number of CPUs the
+     * process can use. Must be a positive integer.
+     */
+    readonly concurrency?: number;
+    /** Called after each image is written or skipped. */
+    readonly onResult?: (result: GeneratedImage) => void;
+}
+/**
+ * How many images to render at once when nothing is configured: one per CPU
+ * the process can actually use. Rasterising is CPU-bound, so starting more
+ * than that only queues the work up while holding every pending image in
+ * memory.
+ */
+export declare function resolveConcurrency(concurrency: number | undefined): number;
+//# sourceMappingURL=options.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../src/generate/options.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACpE,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;OAKG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,wEAAwE;IACxE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,sCAAsC;IACtC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,cAAc,CAAC;IACjC,8EAA8E;IAC9E,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;IACzC,4CAA4C;IAC5C,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,UAAU,KAAK,MAAM,CAAC;IACtE;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,qDAAqD;IACrD,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,IAAI,CAAC;CACtD;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAY1E"}

package/dist/generate/options.js

@@ -0,0 +1,17 @@
+import { availableParallelism } from "node:os";
+/**
+ * How many images to render at once when nothing is configured: one per CPU
+ * the process can actually use. Rasterising is CPU-bound, so starting more
+ * than that only queues the work up while holding every pending image in
+ * memory.
+ */
+export function resolveConcurrency(concurrency) {
+    if (concurrency === undefined) {
+        return availableParallelism();
+    }
+    if (!Number.isSafeInteger(concurrency) || concurrency < 1) {
+        throw new Error(`Invalid concurrency ${String(concurrency)}; expected a positive integer.`);
+    }
+    return concurrency;
+}
+//# sourceMappingURL=options.js.map

package/dist/generate/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../../src/generate/options.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAqD/C;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,WAA+B;IAChE,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;QAC9B,OAAO,oBAAoB,EAAE,CAAC;IAChC,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,WAAW,CAAC,IAAI,WAAW,GAAG,CAAC,EAAE,CAAC;QAC1D,MAAM,IAAI,KAAK,CACb,uBAAuB,MAAM,CAAC,WAAW,CAAC,gCAAgC,CAC3E,CAAC;IACJ,CAAC;IAED,OAAO,WAAW,CAAC;AACrB,CAAC"}

package/dist/generate/output-path.d.ts

@@ -0,0 +1,12 @@
+import type { ContentFile, OutputSize } from "../types.js";
+/**
+ * Default output path: named `<slug>-<size>.png`, alongside the content file.
+ *
+ * This is the `beside-content` placement reached without a content root to
+ * place from, so it takes the root off the file itself. It stays its own
+ * export because it is what `generate`'s `outputPath` callback replaces, and
+ * a caller wrapping the default has to be able to call it. It never hashes:
+ * a hash names one rendering of an image, and this has no way to know which.
+ */
+export declare function defaultOutputPath(file: ContentFile, size: OutputSize): string;
+//# sourceMappingURL=output-path.d.ts.map

package/dist/generate/output-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-path.d.ts","sourceRoot":"","sources":["../../src/generate/output-path.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE3D;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,UAAU,GAAG,MAAM,CAS7E"}

package/dist/generate/output-path.js

@@ -0,0 +1,18 @@
+import path from "node:path";
+import { besideContent } from "../placement/index.js";
+/**
+ * Default output path: named `<slug>-<size>.png`, alongside the content file.
+ *
+ * This is the `beside-content` placement reached without a content root to
+ * place from, so it takes the root off the file itself. It stays its own
+ * export because it is what `generate`'s `outputPath` callback replaces, and
+ * a caller wrapping the default has to be able to call it. It never hashes:
+ * a hash names one rendering of an image, and this has no way to know which.
+ */
+export function defaultOutputPath(file, size) {
+    // `absolutePath` ends with `contentPath` by construction, so dropping it
+    // leaves the directory the walk started from.
+    const root = file.absolutePath.slice(0, file.absolutePath.length - file.contentPath.length);
+    return path.join(root, ...besideContent(file, size, undefined).split("/"));
+}
+//# sourceMappingURL=output-path.js.map

package/dist/generate/output-path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-path.js","sourceRoot":"","sources":["../../src/generate/output-path.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAGtD;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAiB,EAAE,IAAgB;IACnE,yEAAyE;IACzE,8CAA8C;IAC9C,MAAM,IAAI,GAAG,IAAI,CAAC,YAAY,CAAC,KAAK,CAClC,CAAC,EACD,IAAI,CAAC,YAAY,CAAC,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CACnD,CAAC;IAEF,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;AAC7E,CAAC"}

package/dist/generate/outputs.d.ts

@@ -0,0 +1,28 @@
+import type { RenderJob } from "./job.js";
+/**
+ * Reject a manifest written over one of the images it describes.
+ *
+ * The manifest is written last, so it wins: the image is replaced by JSON, and
+ * — its stamp gone with it — rendered again on every build afterwards. It is
+ * the same collision as two images sharing a path, so it is answered here,
+ * where a path is already compared the way the filesystem would.
+ */
+export declare function assertManifestIsNotAnImage(manifestPath: string | undefined, jobs: readonly RenderJob[]): void;
+/**
+ * Reject a build in which two images would be written to one path.
+ *
+ * They do not merely lose an image between them: each stamps the file with its
+ * own digest, so every later build finds a stamp that does not match and
+ * renders both again, for ever.
+ *
+ * Every job is checked, posts included. That used to be older ground worth
+ * leaving alone — two posts collided only if they shared a directory and a
+ * slug — but `public-dir` gathers a whole tree into one directory, where every
+ * post sharing a basename with another lands on it. Naming both sides is what
+ * makes that worth reporting: the path alone does not say which two posts.
+ *
+ * Paths are compared resolved, since a placement names an absolute path and an
+ * extra names whatever the config wrote.
+ */
+export declare function assertDistinctOutputs(jobs: readonly RenderJob[]): void;
+//# sourceMappingURL=outputs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"outputs.d.ts","sourceRoot":"","sources":["../../src/generate/outputs.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AA0B1C;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CACxC,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,IAAI,EAAE,SAAS,SAAS,EAAE,GACzB,IAAI,CAeN;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,SAAS,SAAS,EAAE,GAAG,IAAI,CAiBtE"}

package/dist/generate/outputs.js

@@ -0,0 +1,71 @@
+import path from "node:path";
+/**
+ * Whether the filesystem underneath treats `Card.png` and `card.png` as one
+ * file. Read off the platform rather than probed: a case-sensitive volume on
+ * macOS would have two images it could have kept told to rename one of them,
+ * which is a rare config and an obvious fix, where missing a real collision
+ * leaves a build re-rendering for ever.
+ */
+const isCaseInsensitive = process.platform === "darwin" || process.platform === "win32";
+/**
+ * How a path is compared, which is not always how it is written: where case
+ * does not distinguish two files, it must not distinguish two jobs either.
+ */
+function comparable(outputPath) {
+    const absolute = path.resolve(outputPath);
+    return isCaseInsensitive ? absolute.toLowerCase() : absolute;
+}
+/** What to call a job in a message: the post it came from, or its path. */
+function describe(job) {
+    return job.contentPath ?? `extra "${job.outputPath}"`;
+}
+/**
+ * Reject a manifest written over one of the images it describes.
+ *
+ * The manifest is written last, so it wins: the image is replaced by JSON, and
+ * — its stamp gone with it — rendered again on every build afterwards. It is
+ * the same collision as two images sharing a path, so it is answered here,
+ * where a path is already compared the way the filesystem would.
+ */
+export function assertManifestIsNotAnImage(manifestPath, jobs) {
+    if (manifestPath === undefined) {
+        return;
+    }
+    const key = comparable(manifestPath);
+    const clash = jobs.find((job) => comparable(job.outputPath) === key);
+    if (clash !== undefined) {
+        throw new Error(`The manifest path "${manifestPath}" is where ${describe(clash)} is` +
+            ` written. The manifest is written last, so it would replace the` +
+            ` image; give one of them a path of its own.`);
+    }
+}
+/**
+ * Reject a build in which two images would be written to one path.
+ *
+ * They do not merely lose an image between them: each stamps the file with its
+ * own digest, so every later build finds a stamp that does not match and
+ * renders both again, for ever.
+ *
+ * Every job is checked, posts included. That used to be older ground worth
+ * leaving alone — two posts collided only if they shared a directory and a
+ * slug — but `public-dir` gathers a whole tree into one directory, where every
+ * post sharing a basename with another lands on it. Naming both sides is what
+ * makes that worth reporting: the path alone does not say which two posts.
+ *
+ * Paths are compared resolved, since a placement names an absolute path and an
+ * extra names whatever the config wrote.
+ */
+export function assertDistinctOutputs(jobs) {
+    const taken = new Map();
+    for (const job of jobs) {
+        const key = comparable(job.outputPath);
+        const first = taken.get(key);
+        if (first !== undefined) {
+            throw new Error(`Two images would be written to "${job.outputPath}":` +
+                ` ${describe(first)} and ${describe(job)}. Each image needs a path` +
+                ` of its own, or one is lost and both re-render on every build.`);
+        }
+        taken.set(key, job);
+    }
+}
+//# sourceMappingURL=outputs.js.map

package/dist/generate/outputs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"outputs.js","sourceRoot":"","sources":["../../src/generate/outputs.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAI7B;;;;;;GAMG;AACH,MAAM,iBAAiB,GACrB,OAAO,CAAC,QAAQ,KAAK,QAAQ,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC;AAEhE;;;GAGG;AACH,SAAS,UAAU,CAAC,UAAkB;IACpC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAC1C,OAAO,iBAAiB,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;AAC/D,CAAC;AAED,2EAA2E;AAC3E,SAAS,QAAQ,CAAC,GAAc;IAC9B,OAAO,GAAG,CAAC,WAAW,IAAI,UAAU,GAAG,CAAC,UAAU,GAAG,CAAC;AACxD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,0BAA0B,CACxC,YAAgC,EAChC,IAA0B;IAE1B,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;QAC/B,OAAO;IACT,CAAC;IAED,MAAM,GAAG,GAAG,UAAU,CAAC,YAAY,CAAC,CAAC;IACrC,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,GAAG,CAAC,CAAC;IAErE,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CACb,sBAAsB,YAAY,cAAc,QAAQ,CAAC,KAAK,CAAC,KAAK;YAClE,iEAAiE;YACjE,6CAA6C,CAChD,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAA0B;IAC9D,MAAM,KAAK,GAAG,IAAI,GAAG,EAAqB,CAAC;IAE3C,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,GAAG,GAAG,UAAU,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACvC,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAE7B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CACb,mCAAmC,GAAG,CAAC,UAAU,IAAI;gBACnD,IAAI,QAAQ,CAAC,KAAK,CAAC,QAAQ,QAAQ,CAAC,GAAG,CAAC,2BAA2B;gBACnE,gEAAgE,CACnE,CAAC;QACJ,CAAC;QAED,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IACtB,CAAC;AACH,CAAC"}

package/dist/generate/plan.d.ts

@@ -0,0 +1,21 @@
+import type { PlannedManifest } from "../manifest/index.js";
+import type { Stamper } from "../stamp/index.js";
+import type { RenderJob } from "./job.js";
+import type { GenerateOptions } from "./options.js";
+/**
+ * Everything a build needs before it starts rendering: one job per image, and
+ * the stamper that says which of them can be skipped.
+ */
+export interface BuildPlan {
+    readonly jobs: readonly RenderJob[];
+    readonly stamper: Stamper;
+    /** What to write down about the build, where a config asked for it. */
+    readonly manifest: PlannedManifest | undefined;
+}
+/**
+ * Work out what a build has to render. The per-size configs are resolved once
+ * rather than once per image: the overrides are the same for every post, and
+ * resolving re-reads the configured font files.
+ */
+export declare function planBuild(options: GenerateOptions): Promise<BuildPlan>;
+//# sourceMappingURL=plan.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../src/generate/plan.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAKjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAMpD;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,SAAS,SAAS,EAAE,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,uEAAuE;IACvE,QAAQ,CAAC,QAAQ,EAAE,eAAe,GAAG,SAAS,CAAC;CAChD;AAqBD;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,SAAS,CAAC,CAmD5E"}

package/dist/generate/plan.js

@@ -0,0 +1,72 @@
+import { resolveConfig } from "../config/index.js";
+import { resolveConfigForSize } from "../config/size.js";
+import { walkContent } from "../content/index.js";
+import { planManifest } from "../manifest/index.js";
+import { createStamper } from "../stamp/index.js";
+import { createPlacer } from "../placement/index.js";
+import { extraJobs } from "./extra.js";
+import { assertDistinctOutputs, assertManifestIsNotAnImage, } from "./outputs.js";
+/**
+ * How this build places its images: the configured placement, or `outputPath`
+ * where a caller passed one.
+ *
+ * `outputPath` is the programmatic equivalent of a `custom` placement and wins
+ * for the same reason `walk` beats `config.content`. The URL then comes from
+ * nowhere: the placement no longer describes where the file went, and the one
+ * it would have named is not where the image is.
+ */
+function placer(options) {
+    const override = options.outputPath;
+    if (override === undefined) {
+        return createPlacer(options.config?.placement, options.contentDir);
+    }
+    return (file, size) => ({ path: override(file, size), url: undefined });
+}
+/**
+ * Work out what a build has to render. The per-size configs are resolved once
+ * rather than once per image: the overrides are the same for every post, and
+ * resolving re-reads the configured font files.
+ */
+export async function planBuild(options) {
+    const resolved = resolveConfig(options.config);
+    const place = placer(options);
+    const configBySize = new Map(resolved.sizes.map((size) => [
+        size.name,
+        resolveConfigForSize(options.config, size),
+    ]));
+    const [stamper, files] = await Promise.all([
+        createStamper(resolved),
+        // Content options can come from the config module, which is the only route
+        // a CLI user has to them; `walk` is the programmatic override and wins.
+        walkContent({
+            dir: options.contentDir,
+            ...options.config?.content,
+            ...options.walk,
+        }),
+    ]);
+    const jobs = files.flatMap((file) => resolved.sizes.map((size) => {
+        // Stamped before it is placed, not after: a hashed filename is built
+        // from the stamp, so the name cannot be known before the digest is.
+        const stamp = stamper.stamp(file.props, size);
+        const placed = place(file, size, stamp);
+        return {
+            contentPath: file.contentPath,
+            slug: file.slug,
+            props: file.props,
+            size,
+            outputPath: placed.path,
+            url: placed.url,
+            stamp,
+            config: configBySize.get(size.name) ?? resolved,
+        };
+    }));
+    const all = [...jobs, ...extraJobs(options.config, resolved, stamper)];
+    assertDistinctOutputs(all);
+    assertManifestIsNotAnImage(options.config?.manifest, all);
+    return {
+        jobs: all,
+        stamper,
+        manifest: planManifest(options.config?.manifest, all),
+    };
+}
+//# sourceMappingURL=plan.js.map

package/dist/generate/plan.js.map

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

package/dist/generate/render-image.d.ts

@@ -0,0 +1,11 @@
+import type { RenderJob } from "./job.js";
+/**
+ * Render one image and write it, stamped, to its output path, creating
+ * whatever directories that path needs.
+ *
+ * Warnings name the image they came from: a build renders many, and "shorten
+ * the sample" is no use without knowing which sample. An extra image has no
+ * content file to name, so it is named by where it is being written.
+ */
+export declare function renderImage(job: RenderJob, stamp: string): Promise<void>;
+//# sourceMappingURL=render-image.d.ts.map

package/dist/generate/render-image.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-image.d.ts","sourceRoot":"","sources":["../../src/generate/render-image.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE1C;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAC/B,GAAG,EAAE,SAAS,EACd,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC,CAef"}

package/dist/generate/render-image.js

@@ -0,0 +1,27 @@
+import { mkdir, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { buildSvg, renderSvgToPng } from "../render/index.js";
+import { stampPng } from "../stamp/index.js";
+/**
+ * Render one image and write it, stamped, to its output path, creating
+ * whatever directories that path needs.
+ *
+ * Warnings name the image they came from: a build renders many, and "shorten
+ * the sample" is no use without knowing which sample. An extra image has no
+ * content file to name, so it is named by where it is being written.
+ */
+export async function renderImage(job, stamp) {
+    const dimensions = { width: job.size.width, height: job.size.height };
+    const source = job.contentPath ?? job.outputPath;
+    const config = {
+        ...job.config,
+        onWarning: (message) => {
+            job.config.onWarning(`${source}: ${message}`);
+        },
+    };
+    const svg = await buildSvg(job.props, config, dimensions);
+    const png = await renderSvgToPng(svg, dimensions, config);
+    await mkdir(path.dirname(job.outputPath), { recursive: true });
+    await writeFile(job.outputPath, stampPng(png, stamp));
+}
+//# sourceMappingURL=render-image.js.map

package/dist/generate/render-image.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-image.js","sourceRoot":"","sources":["../../src/generate/render-image.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAI7C;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,GAAc,EACd,KAAa;IAEb,MAAM,UAAU,GAAG,EAAE,KAAK,EAAE,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;IACtE,MAAM,MAAM,GAAG,GAAG,CAAC,WAAW,IAAI,GAAG,CAAC,UAAU,CAAC;IACjD,MAAM,MAAM,GAAmB;QAC7B,GAAG,GAAG,CAAC,MAAM;QACb,SAAS,EAAE,CAAC,OAAe,EAAQ,EAAE;YACnC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,MAAM,KAAK,OAAO,EAAE,CAAC,CAAC;QAChD,CAAC;KACF,CAAC;IAEF,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;IAC1D,MAAM,GAAG,GAAG,MAAM,cAAc,CAAC,GAAG,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;IAE1D,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/D,MAAM,SAAS,CAAC,GAAG,CAAC,UAAU,EAAE,QAAQ,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;AACxD,CAAC"}

package/dist/generate.d.ts

@@ -7,7 +7,7 @@ export interface GeneratedImage {
     readonly contentPath: string;
     readonly size: OutputSize;
     readonly outputPath: string;
-    /** True when an existing file was left in place (no `overwrite`). */
+    /** True when an up-to-date image was left in place (no `overwrite`). */
     readonly skipped: boolean;
 }
 /**
@@ -21,22 +21,43 @@ export interface GenerateOptions {
     readonly walk?: Omit<WalkOptions, "dir">;
     /** Override where each image is written. */
     readonly outputPath?: (file: ContentFile, size: OutputSize) => string;
-    /** Re-render even when the output file already exists. Default `false`. */
+    /**
+     * Re-render every image, ignoring the stamps that would otherwise mark them
+     * as up to date. Default `false`.
+     */
     readonly overwrite?: boolean;
+    /**
+     * How many images to render at once. Defaults to the number of CPUs the
+     * process can use. Must be a positive integer.
+     */
+    readonly concurrency?: number;
     /** Called after each image is written or skipped. */
     readonly onResult?: (result: GeneratedImage) => void;
 }
 /**
- * Default output path: alongside the content file, named `<slug>-<size>.png`.
+ * Default output path: named `<slug>-<size>.png`, alongside the content file.
  * The slug carries the post's keywords into the filename and the size name
  * keeps every image distinct (e.g. `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 — is written from the
+ * content root instead, so its path mirrors the route. Resolving it beside the
+ * file would repeat the directories that are already in the slug, putting
+ * `services/iam` under `content/services/iam/`.
  */
 export declare function defaultOutputPath(file: ContentFile, size: OutputSize): string;
 /**
  * Walk a content tree and render meta images for every file that declares
- * props, writing PNGs to disk. Existing files are skipped unless `overwrite`
- * is set (matching the original script's behaviour), and skipped sizes are
- * never rendered.
+ * props, writing PNGs to disk.
+ *
+ * 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=generate.d.ts.map

package/dist/generate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../src/generate.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGnE,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,qEAAqE;IACrE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,sCAAsC;IACtC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,cAAc,CAAC;IACjC,8EAA8E;IAC9E,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;IACzC,4CAA4C;IAC5C,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,UAAU,KAAK,MAAM,CAAC;IACtE,2EAA2E;IAC3E,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B,qDAAqD;IACrD,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,IAAI,CAAC;CACtD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,UAAU,GAAG,MAAM,CAG7E;AAED;;;;;GAKG;AACH,wBAAsB,QAAQ,CAC5B,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,cAAc,EAAE,CAAC,CAgC3B"}
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../src/generate.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAKnE,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,wEAAwE;IACxE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,sCAAsC;IACtC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,cAAc,CAAC;IACjC,8EAA8E;IAC9E,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;IACzC,4CAA4C;IAC5C,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,UAAU,KAAK,MAAM,CAAC;IACtE;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,qDAAqD;IACrD,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,IAAI,CAAC;CACtD;AAsBD;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,UAAU,GAAG,MAAM,CAc7E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,QAAQ,CAC5B,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,cAAc,EAAE,CAAC,CA2D3B"}

package/dist/generate.js

@@ -1,38 +1,100 @@
-import { existsSync } from "node:fs";
 import { mkdir, writeFile } from "node:fs/promises";
+import { availableParallelism } from "node:os";
 import path from "node:path";
-import { resolveConfig } from "./config.js";
+import { resolveConfig, resolveConfigForSize } from "./config.js";
 import { walkContent } from "./content/index.js";
+import { mapConcurrent } from "./pool.js";
 import { buildSvg, renderSvgToPng } from "./render.js";
+import { createStamper, readPngStamp, stampPng } from "./stamp.js";
 /**
- * Default output path: alongside the content file, named `<slug>-<size>.png`.
+ * How many images to render at once when nothing is configured: one per CPU
+ * the process can actually use. Rasterising is CPU-bound, so starting more
+ * than that only queues the work up while holding every pending image in
+ * memory.
+ */
+function resolveConcurrency(concurrency) {
+    if (concurrency === undefined) {
+        return availableParallelism();
+    }
+    if (!Number.isSafeInteger(concurrency) || concurrency < 1) {
+        throw new Error(`Invalid concurrency ${String(concurrency)}; expected a positive integer.`);
+    }
+    return concurrency;
+}
+/**
+ * Default output path: named `<slug>-<size>.png`, alongside the content file.
  * The slug carries the post's keywords into the filename and the size name
  * keeps every image distinct (e.g. `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 — is written from the
+ * content root instead, so its path mirrors the route. Resolving it beside the
+ * file would repeat the directories that are already in the slug, putting
+ * `services/iam` under `content/services/iam/`.
  */
 export function defaultOutputPath(file, size) {
-    const directory = path.dirname(file.absolutePath);
-    return path.join(directory, `${file.slug}-${size.name}.png`);
+    const name = `${file.slug}-${size.name}.png`;
+    if (!file.slug.includes("/")) {
+        return path.join(path.dirname(file.absolutePath), name);
+    }
+    // `absolutePath` ends with `contentPath` by construction, so dropping it
+    // leaves the directory the walk started from.
+    const root = file.absolutePath.slice(0, file.absolutePath.length - file.contentPath.length);
+    return path.join(root, name);
 }
 /**
  * Walk a content tree and render meta images for every file that declares
- * props, writing PNGs to disk. Existing files are skipped unless `overwrite`
- * is set (matching the original script's behaviour), and skipped sizes are
- * never rendered.
+ * props, writing PNGs to disk.
+ *
+ * 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 resolved = resolveConfig(options.config);
+    const concurrency = resolveConcurrency(options.concurrency);
     const toOutputPath = options.outputPath ?? defaultOutputPath;
-    const files = await walkContent({ dir: options.contentDir, ...options.walk });
+    // Resolved once per size rather than once per image: the overrides are the
+    // same for every post, and resolving re-reads the configured font files.
+    const configBySize = new Map(resolved.sizes.map((size) => [
+        size.name,
+        resolveConfigForSize(options.config, size),
+    ]));
+    const [stamper, files] = await Promise.all([
+        createStamper(resolved),
+        // Content options can come from the config module, which is the only route
+        // a CLI user has to them; `walk` is the programmatic override and wins.
+        walkContent({
+            dir: options.contentDir,
+            ...options.config?.content,
+            ...options.walk,
+        }),
+    ]);
     const jobs = files.flatMap((file) => resolved.sizes.map((size) => ({ file, size })));
-    return Promise.all(jobs.map(async ({ file, size }) => {
+    return mapConcurrent(jobs, concurrency, async ({ file, size }) => {
         const outputPath = toOutputPath(file, size);
-        const isSkipped = existsSync(outputPath) && options.overwrite !== true;
+        const stamp = stamper.stamp(file.props, size);
+        const isSkipped = options.overwrite !== true && (await readPngStamp(outputPath)) === stamp;
         if (!isSkipped) {
             const dimensions = { width: size.width, height: size.height };
-            const svg = await buildSvg(file.props, resolved, dimensions);
-            const png = await renderSvgToPng(svg, dimensions);
+            const sizeConfig = configBySize.get(size.name) ?? resolved;
+            // Warnings name the post they came from: a build renders many images,
+            // and "shorten the sample" is no use without knowing which sample.
+            const config = {
+                ...sizeConfig,
+                onWarning: (message) => {
+                    resolved.onWarning(`${file.contentPath}: ${message}`);
+                },
+            };
+            const svg = await buildSvg(file.props, config, dimensions);
+            const png = await renderSvgToPng(svg, dimensions, config);
             await mkdir(path.dirname(outputPath), { recursive: true });
-            await writeFile(outputPath, png);
+            await writeFile(outputPath, stampPng(png, stamp));
         }
         const result = {
             contentPath: file.contentPath,
@@ -42,6 +104,6 @@ export async function generate(options) {
         };
         options.onResult?.(result);
         return result;
-    }));
+    });
 }
 //# sourceMappingURL=generate.js.map