@kensio/colophon 2.4.0 → 2.6.0

package/dist/cli/preview/root.d.ts

@@ -0,0 +1,17 @@
+/**
+ * The content root to read a previewed post against, which is what its slug is
+ * derived from, and so what the preview file ends up called.
+ *
+ * The working directory, for a file underneath it: that is what the path on the
+ * command line was relative to, and it keeps the page-bundle convention
+ * working, where `hello/index.md` is named after its directory instead of being
+ * one more `index`. A file from somewhere else falls back to its own directory,
+ * since a root it is not under cannot describe it, and a relative path full of
+ * `..` segments is not a slug at all.
+ *
+ * The slug only ever names a file in the temp directory here, so the point is
+ * that two posts do not collide, rather than matching what a build would call
+ * the real image.
+ */
+export declare function contentRootFor(file: string): string;
+//# sourceMappingURL=root.d.ts.map

package/dist/cli/preview/root.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"root.d.ts","sourceRoot":"","sources":["../../../src/cli/preview/root.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKnD"}

package/dist/cli/preview/root.js

@@ -0,0 +1,22 @@
+import path from "node:path";
+/**
+ * The content root to read a previewed post against, which is what its slug is
+ * derived from, and so what the preview file ends up called.
+ *
+ * The working directory, for a file underneath it: that is what the path on the
+ * command line was relative to, and it keeps the page-bundle convention
+ * working, where `hello/index.md` is named after its directory instead of being
+ * one more `index`. A file from somewhere else falls back to its own directory,
+ * since a root it is not under cannot describe it, and a relative path full of
+ * `..` segments is not a slug at all.
+ *
+ * The slug only ever names a file in the temp directory here, so the point is
+ * that two posts do not collide, rather than matching what a build would call
+ * the real image.
+ */
+export function contentRootFor(file) {
+    const absolute = path.resolve(file);
+    const cwd = process.cwd();
+    return absolute.startsWith(cwd + path.sep) ? cwd : path.dirname(absolute);
+}
+//# sourceMappingURL=root.js.map

package/dist/cli/preview/root.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"root.js","sourceRoot":"","sources":["../../../src/cli/preview/root.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAE1B,OAAO,QAAQ,CAAC,UAAU,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;AAC5E,CAAC"}

package/dist/cli/preview/size.d.ts

@@ -0,0 +1,7 @@
+import type { OutputSize } from "../../types.js";
+/**
+ * Which size to preview: the one `--size` names, or the first configured one,
+ * which is what an `extra` image already defaults to.
+ */
+export declare function pickSize(sizes: readonly OutputSize[], name: string | undefined): OutputSize;
+//# sourceMappingURL=size.d.ts.map

package/dist/cli/preview/size.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"size.d.ts","sourceRoot":"","sources":["../../../src/cli/preview/size.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD;;;GAGG;AACH,wBAAgB,QAAQ,CACtB,KAAK,EAAE,SAAS,UAAU,EAAE,EAC5B,IAAI,EAAE,MAAM,GAAG,SAAS,GACvB,UAAU,CAWZ"}

package/dist/cli/preview/size.js

@@ -0,0 +1,13 @@
+/**
+ * Which size to preview: the one `--size` names, or the first configured one,
+ * which is what an `extra` image already defaults to.
+ */
+export function pickSize(sizes, name) {
+    const names = sizes.map((size) => size.name);
+    const wanted = sizes.find((size) => size.name === (name ?? names[0]));
+    if (wanted === undefined) {
+        throw new Error(`Unknown size "${String(name)}". Configured sizes: ${names.join(", ")}.`);
+    }
+    return wanted;
+}
+//# sourceMappingURL=size.js.map

package/dist/cli/preview/size.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"size.js","sourceRoot":"","sources":["../../../src/cli/preview/size.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,QAAQ,CACtB,KAA4B,EAC5B,IAAwB;IAExB,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAEtE,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CACb,iBAAiB,MAAM,CAAC,IAAI,CAAC,wBAAwB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CACzE,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/cli/report.d.ts

@@ -0,0 +1,6 @@
+import type { GeneratedImage } from "../generate/index.js";
+/** Report one image as it is written, or as it is left alone. */
+export declare function reportImage(result: GeneratedImage, isDryRun: boolean): void;
+/** Report what a whole run came to. */
+export declare function reportSummary(results: readonly GeneratedImage[], isDryRun: boolean): void;
+//# sourceMappingURL=report.d.ts.map

package/dist/cli/report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../../src/cli/report.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAW3D,iEAAiE;AACjE,wBAAgB,WAAW,CAAC,MAAM,EAAE,cAAc,EAAE,QAAQ,EAAE,OAAO,GAAG,IAAI,CAQ3E;AAED,uCAAuC;AACvC,wBAAgB,aAAa,CAC3B,OAAO,EAAE,SAAS,cAAc,EAAE,EAClC,QAAQ,EAAE,OAAO,GAChB,IAAI,CASN"}

package/dist/cli/report.js

@@ -0,0 +1,23 @@
+/** What this run did, or would have done, to one image. */
+function verbFor(result, isDryRun) {
+    if (result.skipped) {
+        return "skip";
+    }
+    return isDryRun ? "write" : "wrote";
+}
+/** Report one image as it is written, or as it is left alone. */
+export function reportImage(result, isDryRun) {
+    // The URL is the half of a placement nothing else on the command line
+    // would show, and the quickest way to see a `urlBase` is wrong.
+    const served = result.url === undefined ? "" : ` -> ${result.url}`;
+    console.log(`${verbFor(result, isDryRun).padEnd(5)} ${result.outputPath}${served}`);
+}
+/** Report what a whole run came to. */
+export function reportSummary(results, isDryRun) {
+    const written = results.filter((result) => !result.skipped).length;
+    const skipped = String(results.length - written);
+    console.log(isDryRun
+        ? `Dry run: ${String(written)} would be written, ${skipped} already up to date. Nothing was written.`
+        : `Done: ${String(written)} written, ${skipped} skipped.`);
+}
+//# sourceMappingURL=report.js.map

package/dist/cli/report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.js","sourceRoot":"","sources":["../../src/cli/report.ts"],"names":[],"mappings":"AAEA,2DAA2D;AAC3D,SAAS,OAAO,CAAC,MAAsB,EAAE,QAAiB;IACxD,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,OAAO,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;AACtC,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,WAAW,CAAC,MAAsB,EAAE,QAAiB;IACnE,sEAAsE;IACtE,gEAAgE;IAChE,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,MAAM,CAAC,GAAG,EAAE,CAAC;IAEnE,OAAO,CAAC,GAAG,CACT,GAAG,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,UAAU,GAAG,MAAM,EAAE,CACvE,CAAC;AACJ,CAAC;AAED,uCAAuC;AACvC,MAAM,UAAU,aAAa,CAC3B,OAAkC,EAClC,QAAiB;IAEjB,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;IACnE,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,OAAO,CAAC,CAAC;IAEjD,OAAO,CAAC,GAAG,CACT,QAAQ;QACN,CAAC,CAAC,YAAY,MAAM,CAAC,OAAO,CAAC,sBAAsB,OAAO,2CAA2C;QACrG,CAAC,CAAC,SAAS,MAAM,CAAC,OAAO,CAAC,aAAa,OAAO,WAAW,CAC5D,CAAC;AACJ,CAAC"}

package/dist/cli/watch/filter.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Whether a change under the content root is one worth rebuilding for.
+ *
+ * Two kinds of change arrive that are not content. The images themselves: the
+ * default placement writes a PNG next to the post it came from, so every build
+ * changes the tree it is watching. And an editor's own files, such as
+ * `post.md~` or `.post.md.swp`, which come and go around the real write.
+ *
+ * Both are ruled out by the extensions a walk would read, which is the same
+ * list that decides what a build looks at. So the watcher and the build agree
+ * on what content is, rather than keeping two ideas of it.
+ */
+export declare function isContentChange(filename: string, extensions: readonly string[]): boolean;
+//# sourceMappingURL=filter.d.ts.map

package/dist/cli/watch/filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter.d.ts","sourceRoot":"","sources":["../../../src/cli/watch/filter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,SAAS,MAAM,EAAE,GAC5B,OAAO,CAET"}

package/dist/cli/watch/filter.js

@@ -0,0 +1,16 @@
+/**
+ * Whether a change under the content root is one worth rebuilding for.
+ *
+ * Two kinds of change arrive that are not content. The images themselves: the
+ * default placement writes a PNG next to the post it came from, so every build
+ * changes the tree it is watching. And an editor's own files, such as
+ * `post.md~` or `.post.md.swp`, which come and go around the real write.
+ *
+ * Both are ruled out by the extensions a walk would read, which is the same
+ * list that decides what a build looks at. So the watcher and the build agree
+ * on what content is, rather than keeping two ideas of it.
+ */
+export function isContentChange(filename, extensions) {
+    return extensions.some((extension) => filename.endsWith(extension));
+}
+//# sourceMappingURL=filter.js.map

package/dist/cli/watch/filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter.js","sourceRoot":"","sources":["../../../src/cli/watch/filter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,eAAe,CAC7B,QAAgB,EAChB,UAA6B;IAE7B,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;AACtE,CAAC"}

package/dist/cli/watch/index.d.ts

@@ -0,0 +1,27 @@
+/** What a watch run needs: where to look, what counts, and what to run. */
+export interface WatchOptions {
+    readonly dir: string;
+    /** File extensions the build reads, which is what a change has to be. */
+    readonly extensions: readonly string[];
+    readonly build: () => Promise<void>;
+    /** Coalescing window, for tests that would rather not wait for it. */
+    readonly delayMs?: number;
+    /** Stop watching. The CLI watches until the process ends; tests do not. */
+    readonly signal?: AbortSignal;
+}
+/**
+ * Build the tree, then rebuild it whenever a content file changes, until the
+ * process is stopped.
+ *
+ * The returned promise settles when the watcher stops or fails, which is what
+ * keeps the process alive: there is nothing else to await once the first build
+ * is done. The watcher is registered before that build starts, so an edit made
+ * while it runs is not lost.
+ *
+ * Only the content tree is watched. A change to the config module is not picked
+ * up, because reloading it would mean importing it again under a fresh URL and
+ * leaving the old copy behind, and the modules it imports could not be
+ * invalidated at all. Restart the watch after editing a config.
+ */
+export declare function watchContent(options: WatchOptions): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/watch/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/watch/index.ts"],"names":[],"mappings":"AAKA,2EAA2E;AAC3E,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,yEAAyE;IACzE,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,sEAAsE;IACtE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,2EAA2E;IAC3E,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CA0BvE"}

package/dist/cli/watch/index.js

@@ -0,0 +1,38 @@
+import { watch } from "node:fs";
+import { isContentChange } from "./filter.js";
+import { createRebuildQueue } from "./queue.js";
+/**
+ * Build the tree, then rebuild it whenever a content file changes, until the
+ * process is stopped.
+ *
+ * The returned promise settles when the watcher stops or fails, which is what
+ * keeps the process alive: there is nothing else to await once the first build
+ * is done. The watcher is registered before that build starts, so an edit made
+ * while it runs is not lost.
+ *
+ * Only the content tree is watched. A change to the config module is not picked
+ * up, because reloading it would mean importing it again under a fresh URL and
+ * leaving the old copy behind, and the modules it imports could not be
+ * invalidated at all. Restart the watch after editing a config.
+ */
+export async function watchContent(options) {
+    const queue = createRebuildQueue({
+        run: options.build,
+        ...(options.delayMs !== undefined && { delayMs: options.delayMs }),
+    });
+    const watcher = watch(options.dir, {
+        recursive: true,
+        ...(options.signal !== undefined && { signal: options.signal }),
+    }, (_event, filename) => {
+        if (filename !== null && isContentChange(filename, options.extensions)) {
+            queue.touch();
+        }
+    });
+    console.log(`Watching ${options.dir} for changes. Press Ctrl+C to stop.`);
+    queue.touch();
+    return new Promise((resolve, reject) => {
+        watcher.on("close", resolve);
+        watcher.on("error", reject);
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/cli/watch/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cli/watch/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhC,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAchD;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAAqB;IACtD,MAAM,KAAK,GAAG,kBAAkB,CAAC;QAC/B,GAAG,EAAE,OAAO,CAAC,KAAK;QAClB,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC;KACnE,CAAC,CAAC;IAEH,MAAM,OAAO,GAAG,KAAK,CACnB,OAAO,CAAC,GAAG,EACX;QACE,SAAS,EAAE,IAAI;QACf,GAAG,CAAC,OAAO,CAAC,MAAM,KAAK,SAAS,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;KAChE,EACD,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE;QACnB,IAAI,QAAQ,KAAK,IAAI,IAAI,eAAe,CAAC,QAAQ,EAAE,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;YACvE,KAAK,CAAC,KAAK,EAAE,CAAC;QAChB,CAAC;IACH,CAAC,CACF,CAAC;IAEF,OAAO,CAAC,GAAG,CAAC,YAAY,OAAO,CAAC,GAAG,qCAAqC,CAAC,CAAC;IAC1E,KAAK,CAAC,KAAK,EAAE,CAAC;IAEd,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC3C,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC7B,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC9B,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/cli/watch/queue.d.ts

@@ -0,0 +1,24 @@
+/** A rebuild waiting to happen, or happening. */
+export interface RebuildQueue {
+    /** Note that something changed, and rebuild once the changes stop. */
+    touch(): void;
+}
+/** How a queue is driven. */
+export interface QueueOptions {
+    readonly run: () => Promise<void>;
+    /** How long to wait for a burst of changes to finish. */
+    readonly delayMs?: number;
+    readonly onError?: (error: unknown) => void;
+}
+/**
+ * Coalesce change events into rebuilds.
+ *
+ * Two things have to hold for a watch loop to behave. Saving a file produces
+ * more than one event, since editors write, rename and touch mtimes in their
+ * own order, so events are held for `delayMs` and the wait restarts while they
+ * keep arriving. And a build takes longer than the edit that triggered it, so a
+ * change arriving mid-build queues one more run rather than starting a second
+ * build alongside the first.
+ */
+export declare function createRebuildQueue(options: QueueOptions): RebuildQueue;
+//# sourceMappingURL=queue.d.ts.map

package/dist/cli/watch/queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../../../src/cli/watch/queue.ts"],"names":[],"mappings":"AAEA,iDAAiD;AACjD,MAAM,WAAW,YAAY;IAC3B,sEAAsE;IACtE,KAAK,IAAI,IAAI,CAAC;CACf;AAED,6BAA6B;AAC7B,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,yDAAyD;IACzD,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CAC7C;AAQD;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,YAAY,GAAG,YAAY,CA8CtE"}

package/dist/cli/watch/queue.js

@@ -0,0 +1,57 @@
+import { messageOf } from "../message.js";
+/**
+ * Long enough to swallow the several events one save produces, short enough
+ * that the rebuild still feels like a consequence of hitting save.
+ */
+const defaultDelayMs = 80;
+/**
+ * Coalesce change events into rebuilds.
+ *
+ * Two things have to hold for a watch loop to behave. Saving a file produces
+ * more than one event, since editors write, rename and touch mtimes in their
+ * own order, so events are held for `delayMs` and the wait restarts while they
+ * keep arriving. And a build takes longer than the edit that triggered it, so a
+ * change arriving mid-build queues one more run rather than starting a second
+ * build alongside the first.
+ */
+export function createRebuildQueue(options) {
+    const delayMs = options.delayMs ?? defaultDelayMs;
+    const report = options.onError ??
+        ((error) => {
+            console.error(messageOf(error));
+        });
+    let timer;
+    let isRunning = false;
+    let isPending = false;
+    async function drain() {
+        isRunning = true;
+        try {
+            await options.run();
+        }
+        catch (error) {
+            // A failed build must not take the watcher with it. The mistake is
+            // usually in the file that was just saved, so the fix is the next save.
+            report(error);
+        }
+        isRunning = false;
+        if (isPending) {
+            isPending = false;
+            // Called rather than awaited, so `drain` does not recurse into a chain
+            // of promises that a long watch session would hold open.
+            void drain();
+        }
+    }
+    return {
+        touch() {
+            if (isRunning) {
+                isPending = true;
+                return;
+            }
+            clearTimeout(timer);
+            timer = setTimeout(() => {
+                void drain();
+            }, delayMs);
+        },
+    };
+}
+//# sourceMappingURL=queue.js.map

package/dist/cli/watch/queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.js","sourceRoot":"","sources":["../../../src/cli/watch/queue.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAgB1C;;;GAGG;AACH,MAAM,cAAc,GAAG,EAAE,CAAC;AAE1B;;;;;;;;;GASG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAqB;IACtD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,cAAc,CAAC;IAClD,MAAM,MAAM,GACV,OAAO,CAAC,OAAO;QACf,CAAC,CAAC,KAAc,EAAQ,EAAE;YACxB,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;QAClC,CAAC,CAAC,CAAC;IAEL,IAAI,KAAiC,CAAC;IACtC,IAAI,SAAS,GAAG,KAAK,CAAC;IACtB,IAAI,SAAS,GAAG,KAAK,CAAC;IAEtB,KAAK,UAAU,KAAK;QAClB,SAAS,GAAG,IAAI,CAAC;QAEjB,IAAI,CAAC;YACH,MAAM,OAAO,CAAC,GAAG,EAAE,CAAC;QACtB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,mEAAmE;YACnE,wEAAwE;YACxE,MAAM,CAAC,KAAK,CAAC,CAAC;QAChB,CAAC;QAED,SAAS,GAAG,KAAK,CAAC;QAElB,IAAI,SAAS,EAAE,CAAC;YACd,SAAS,GAAG,KAAK,CAAC;YAClB,uEAAuE;YACvE,yDAAyD;YACzD,KAAK,KAAK,EAAE,CAAC;QACf,CAAC;IACH,CAAC;IAED,OAAO;QACL,KAAK;YACH,IAAI,SAAS,EAAE,CAAC;gBACd,SAAS,GAAG,IAAI,CAAC;gBACjB,OAAO;YACT,CAAC;YAED,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;gBACtB,KAAK,KAAK,EAAE,CAAC;YACf,CAAC,EAAE,OAAO,CAAC,CAAC;QACd,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/config/defaults.d.ts

@@ -1,4 +1,4 @@
-import type { BrandColors, CodeStyle, OutputSize } from "../types.js";
+import type { BrandColors, CodeStyle, OutputFormat, OutputSize } from "../types.js";
 /**
  * Named output-size presets covering the common social-image standards. Each
  * `name` becomes the filename suffix (e.g. `my-post-og.png`).
@@ -42,6 +42,44 @@ export declare const DEFAULT_SIZES: readonly OutputSize[];
  * avoid: supply a font file and the output stops depending on the machine.
  */
 export declare const DEFAULT_FONT_FAMILY = "Arial, Helvetica, sans-serif";
+/**
+ * Default zlib level for the rendered PNG: the strongest there is.
+ *
+ * A meta image is written once and then served for as long as the post is up,
+ * so the trade is a hundred milliseconds of build time against bytes every
+ * reader pays for. The stamps mean even that time is paid once per image rather
+ * than once per build. See `png/recompress.ts` for what the level does and does
+ * not change.
+ */
+export declare const DEFAULT_COMPRESSION_LEVEL = 9;
+/**
+ * Default output format: PNG, which is what Colophon wrote before there was a
+ * choice and what every platform has always accepted.
+ */
+export declare const DEFAULT_FORMAT: OutputFormat;
+/**
+ * Default encoding quality for the lossy formats.
+ *
+ * `80` is where JPEG, WebP and AVIF are conventionally set, and on a meta image
+ * it is hard to tell from the original. Gradients are what these pictures are
+ * mostly made of and they are the first thing to band, so this is deliberately
+ * not lower.
+ */
+export declare const DEFAULT_QUALITY = 80;
+/**
+ * The lowest quality `maxBytes` will step down to.
+ *
+ * Below this the banding is obvious enough that the image is no longer doing
+ * its job, and an unreadable image under the cap is not what a cap was for.
+ */
+export declare const MINIMUM_QUALITY = 30;
+/**
+ * How far quality drops on each attempt at `maxBytes`.
+ *
+ * Ten points is a step a reader can predict from the setting they wrote, and
+ * from 80 it reaches the floor in five encodings.
+ */
+export declare const QUALITY_STEP = 10;
 /** Neutral default palette, used when no `colors.brand` is supplied. */
 export declare const DEFAULT_COLORS: Required<BrandColors>;
 /**

package/dist/config/defaults.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/config/defaults.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEtE;;;;;;;;;GASG;AACH,eAAO,MAAM,YAAY;;iBACjB,IAAI,EAAE,IAAI;iBAAE,KAAK,EAAE,IAAI;iBAAE,MAAM,EAAE,GAAG;;;iBAChC,IAAI,EAAE,QAAQ;iBAAE,KAAK,EAAE,IAAI;iBAAE,MAAM,EAAE,IAAI;;;iBACxC,IAAI,EAAE,SAAS;iBAAE,KAAK,EAAE,IAAI;iBAAE,MAAM,EAAE,GAAG;;;iBACvC,IAAI,EAAE,WAAW;iBAAE,KAAK,EAAE,IAAI;iBAAE,MAAM,EAAE,IAAI;;CACZ,CAAC;AAEhD;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,SAAS,UAAU,EAG9C,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,iCAAiC,CAAC;AAElE,wEAAwE;AACxE,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,WAAW,CAKhD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,8FACkD,CAAC;AAExF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,kBAAkB,EAAE,QAAQ,CAAC,SAAS,CAQlD,CAAC"}
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/config/defaults.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,SAAS,EACT,YAAY,EACZ,UAAU,EACX,MAAM,aAAa,CAAC;AAErB;;;;;;;;;GASG;AACH,eAAO,MAAM,YAAY;;iBACjB,IAAI,EAAE,IAAI;iBAAE,KAAK,EAAE,IAAI;iBAAE,MAAM,EAAE,GAAG;;;iBAChC,IAAI,EAAE,QAAQ;iBAAE,KAAK,EAAE,IAAI;iBAAE,MAAM,EAAE,IAAI;;;iBACxC,IAAI,EAAE,SAAS;iBAAE,KAAK,EAAE,IAAI;iBAAE,MAAM,EAAE,GAAG;;;iBACvC,IAAI,EAAE,WAAW;iBAAE,KAAK,EAAE,IAAI;iBAAE,MAAM,EAAE,IAAI;;CACZ,CAAC;AAEhD;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,SAAS,UAAU,EAG9C,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,iCAAiC,CAAC;AAElE;;;;;;;;GAQG;AACH,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAE3C;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,YAAoB,CAAC;AAElD;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,KAAK,CAAC;AAElC;;;;;GAKG;AACH,eAAO,MAAM,eAAe,KAAK,CAAC;AAElC;;;;;GAKG;AACH,eAAO,MAAM,YAAY,KAAK,CAAC;AAE/B,wEAAwE;AACxE,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,WAAW,CAKhD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,8FACkD,CAAC;AAExF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,kBAAkB,EAAE,QAAQ,CAAC,SAAS,CAQlD,CAAC"}

package/dist/config/defaults.js

@@ -28,6 +28,44 @@ export const DEFAULT_SIZES = [
  * avoid: supply a font file and the output stops depending on the machine.
  */
 export const DEFAULT_FONT_FAMILY = "Arial, Helvetica, sans-serif";
+/**
+ * Default zlib level for the rendered PNG: the strongest there is.
+ *
+ * A meta image is written once and then served for as long as the post is up,
+ * so the trade is a hundred milliseconds of build time against bytes every
+ * reader pays for. The stamps mean even that time is paid once per image rather
+ * than once per build. See `png/recompress.ts` for what the level does and does
+ * not change.
+ */
+export const DEFAULT_COMPRESSION_LEVEL = 9;
+/**
+ * Default output format: PNG, which is what Colophon wrote before there was a
+ * choice and what every platform has always accepted.
+ */
+export const DEFAULT_FORMAT = "png";
+/**
+ * Default encoding quality for the lossy formats.
+ *
+ * `80` is where JPEG, WebP and AVIF are conventionally set, and on a meta image
+ * it is hard to tell from the original. Gradients are what these pictures are
+ * mostly made of and they are the first thing to band, so this is deliberately
+ * not lower.
+ */
+export const DEFAULT_QUALITY = 80;
+/**
+ * The lowest quality `maxBytes` will step down to.
+ *
+ * Below this the banding is obvious enough that the image is no longer doing
+ * its job, and an unreadable image under the cap is not what a cap was for.
+ */
+export const MINIMUM_QUALITY = 30;
+/**
+ * How far quality drops on each attempt at `maxBytes`.
+ *
+ * Ten points is a step a reader can predict from the setting they wrote, and
+ * from 80 it reaches the floor in five encodings.
+ */
+export const QUALITY_STEP = 10;
 /** Neutral default palette, used when no `colors.brand` is supplied. */
 export const DEFAULT_COLORS = {
     brand: "#4f46e5",

package/dist/config/defaults.js.map

@@ -1 +1 @@
-{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../../src/config/defaults.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE;IAC5C,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE;IACrD,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE;IACtD,SAAS,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE;CACd,CAAC;AAEhD;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAA0B;IAClD,YAAY,CAAC,EAAE;IACf,YAAY,CAAC,MAAM;CACpB,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,8BAA8B,CAAC;AAElE,wEAAwE;AACxE,MAAM,CAAC,MAAM,cAAc,GAA0B;IACnD,KAAK,EAAE,SAAS;IAChB,SAAS,EAAE,SAAS;IACpB,SAAS,EAAE,SAAS;IACpB,UAAU,EAAE,SAAS;CACtB,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,wBAAwB,GACnC,qFAAqF,CAAC;AAExF;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAwB;IACrD,KAAK,EAAE,aAAa;IACpB,UAAU,EAAE,wBAAwB;IACpC,UAAU,EAAE,IAAI;IAChB,OAAO,EAAE,CAAC;IACV,WAAW,EAAE,KAAK;IAClB,YAAY,EAAE,KAAK;IACnB,YAAY,EAAE,KAAK;CACpB,CAAC"}
+{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../../src/config/defaults.ts"],"names":[],"mappings":"AAOA;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE;IAC5C,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE;IACrD,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE;IACtD,SAAS,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE;CACd,CAAC;AAEhD;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAA0B;IAClD,YAAY,CAAC,EAAE;IACf,YAAY,CAAC,MAAM;CACpB,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,8BAA8B,CAAC;AAElE;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC;AAE3C;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAiB,KAAK,CAAC;AAElD;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,EAAE,CAAC;AAElC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,EAAE,CAAC;AAElC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,EAAE,CAAC;AAE/B,wEAAwE;AACxE,MAAM,CAAC,MAAM,cAAc,GAA0B;IACnD,KAAK,EAAE,SAAS;IAChB,SAAS,EAAE,SAAS;IACpB,SAAS,EAAE,SAAS;IACpB,UAAU,EAAE,SAAS;CACtB,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,wBAAwB,GACnC,qFAAqF,CAAC;AAExF;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAwB;IACrD,KAAK,EAAE,aAAa;IACpB,UAAU,EAAE,wBAAwB;IACpC,UAAU,EAAE,IAAI;IAChB,OAAO,EAAE,CAAC;IACV,WAAW,EAAE,KAAK;IAClB,YAAY,EAAE,KAAK;IACnB,YAAY,EAAE,KAAK;CACpB,CAAC"}

package/dist/config/index.d.ts

@@ -1,5 +1,5 @@
 import type { ColophonConfig, ColophonConfigFactory, ResolvedConfig } from "../types.js";
-export { DEFAULT_CODE_FONT_FAMILY, DEFAULT_CODE_STYLE, DEFAULT_COLORS, DEFAULT_FONT_FAMILY, DEFAULT_SIZES, SIZE_PRESETS, } from "./defaults.js";
+export { DEFAULT_CODE_FONT_FAMILY, DEFAULT_CODE_STYLE, DEFAULT_COLORS, DEFAULT_COMPRESSION_LEVEL, DEFAULT_FONT_FAMILY, DEFAULT_FORMAT, DEFAULT_QUALITY, DEFAULT_SIZES, SIZE_PRESETS, } from "./defaults.js";
 /**
  * Identity helper that returns its argument typed as {@link ColophonConfig}.
  * Use it in a config module to get editor completion and type-checking.
@@ -18,5 +18,5 @@ export declare function defineConfig(factory: ColophonConfigFactory): ColophonCo
  * written against a different version of the package is a build error rather
  * than a set of images quietly rendered with the defaults.
  */
-export declare function resolveConfig(config?: ColophonConfig): ResolvedConfig;
+export declare function resolveConfig(input?: ColophonConfig): ResolvedConfig;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,cAAc,EACd,qBAAqB,EAErB,cAAc,EACf,MAAM,aAAa,CAAC;AAYrB,OAAO,EACL,wBAAwB,EACxB,kBAAkB,EAClB,cAAc,EACd,mBAAmB,EACnB,aAAa,EACb,YAAY,GACb,MAAM,eAAe,CAAC;AAcvB;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,cAAc,GAAG,cAAc,CAAC;AACrE;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,qBAAqB,GAC7B,qBAAqB,CAAC;AAUzB;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,MAAM,GAAE,cAAmB,GAAG,cAAc,CAsBzE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACV,cAAc,EACd,qBAAqB,EAErB,cAAc,EACf,MAAM,aAAa,CAAC;AAcrB,OAAO,EACL,wBAAwB,EACxB,kBAAkB,EAClB,cAAc,EACd,yBAAyB,EACzB,mBAAmB,EACnB,cAAc,EACd,eAAe,EACf,aAAa,EACb,YAAY,GACb,MAAM,eAAe,CAAC;AAcvB;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,cAAc,GAAG,cAAc,CAAC;AACrE;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,qBAAqB,GAC7B,qBAAqB,CAAC;AAUzB;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,KAAK,GAAE,cAAmB,GAAG,cAAc,CAqCxE"}

package/dist/config/index.js

@@ -1,10 +1,16 @@
-import { resolveFonts } from "../fonts/index.js";
+// From `resolve.js` rather than the barrel, which also exports the font
+// materialising that only a path-taking rasteriser needs.
+import { resolveFonts } from "../fonts/resolve.js";
 import { resolveOptionalImage } from "../image/index.js";
+import { defaultRasteriser } from "../platform/rasteriser.node.js";
 import { builtinTemplates } from "../templates/index.js";
+import { applyTheme } from "../theme/index.js";
+import { resolveTexture } from "../texture/index.js";
 import { validateConfig } from "../validate/index.js";
-import { DEFAULT_FONT_FAMILY } from "./defaults.js";
-import { defaultBackground, resolveBackground, resolveCode, resolveColors, resolveSizes, shouldLoadSystemFonts, } from "./resolve.js";
-export { DEFAULT_CODE_FONT_FAMILY, DEFAULT_CODE_STYLE, DEFAULT_COLORS, DEFAULT_FONT_FAMILY, DEFAULT_SIZES, SIZE_PRESETS, } from "./defaults.js";
+import { DEFAULT_FONT_FAMILY, DEFAULT_FORMAT } from "./defaults.js";
+import { resolveMaxBytes, resolveQuality } from "./output.js";
+import { defaultBackground, resolveBackground, resolveCode, resolveColors, resolveCompressionLevel, resolveSizes, shouldLoadSystemFonts, } from "./resolve.js";
+export { DEFAULT_CODE_FONT_FAMILY, DEFAULT_CODE_STYLE, DEFAULT_COLORS, DEFAULT_COMPRESSION_LEVEL, DEFAULT_FONT_FAMILY, DEFAULT_FORMAT, DEFAULT_QUALITY, DEFAULT_SIZES, SIZE_PRESETS, } from "./defaults.js";
 /**
  * Default warning handler. Colophon runs at build time, so a compromise the
  * renderer had to make belongs in the build log by default. Silence is opt-in
@@ -31,13 +37,18 @@ export function defineConfig(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);
+export function resolveConfig(input = {}) {
+    validateConfig(input);
+    // The theme is folded in before anything is resolved, so the rest of this
+    // sees a config that happens to name a background and a palette, and nothing
+    // downstream has to know a theme was involved.
+    const config = applyTheme(input);
     const colors = resolveColors(config.colors);
     const fonts = resolveFonts(config.fonts);
     return {
         colors,
         background: resolveBackground(config.background) ?? defaultBackground(colors),
+        texture: resolveTexture(config.texture, colors),
         fonts,
         systemFonts: shouldLoadSystemFonts(config.systemFonts, fonts),
         // A project that supplies one font should not have to name it twice.
@@ -49,6 +60,16 @@ export function resolveConfig(config = {}) {
         onWarning: config.onWarning ?? warnToConsole,
         sizes: resolveSizes(config.sizes),
         templates: { ...builtinTemplates, ...config.templates },
+        // Through `platform/`, for two reasons. Naming `render/index.js` would pull
+        // `render/png.js` back round to this module, and naming resvg directly
+        // would put a native binary in the graph of every build that resolves a
+        // config, including one for a browser.
+        rasteriser: config.rasteriser ?? defaultRasteriser,
+        compressionLevel: resolveCompressionLevel(config.compressionLevel),
+        format: config.format ?? DEFAULT_FORMAT,
+        quality: resolveQuality(config.quality),
+        maxBytes: resolveMaxBytes(config.maxBytes),
+        emitSvg: config.emitSvg ?? false,
     };
 }
 //# sourceMappingURL=index.js.map

package/dist/config/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAOzD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,WAAW,EACX,aAAa,EACb,YAAY,EACZ,qBAAqB,GACtB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,wBAAwB,EACxB,kBAAkB,EAClB,cAAc,EACd,mBAAmB,EACnB,aAAa,EACb,YAAY,GACb,MAAM,eAAe,CAAC;AAEvB;;;;GAIG;AACH,SAAS,aAAa,CAAC,OAAe;IACpC,4EAA4E;IAC5E,iCAAiC;IACjC,sCAAsC;IACtC,OAAO,CAAC,IAAI,CAAC,aAAa,OAAO,EAAE,CAAC,CAAC;AACvC,CAAC;AAeD;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,MAA2B;IACtD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,MAAM,GAAmB,EAAE;IACvD,cAAc,CAAC,MAAM,CAAC,CAAC;IAEvB,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC5C,MAAM,KAAK,GAAG,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAEzC,OAAO;QACL,MAAM;QACN,UAAU,EACR,iBAAiB,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,iBAAiB,CAAC,MAAM,CAAC;QACnE,KAAK;QACL,WAAW,EAAE,qBAAqB,CAAC,MAAM,CAAC,WAAW,EAAE,KAAK,CAAC;QAC7D,qEAAqE;QACrE,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,MAAM,IAAI,mBAAmB;QACxE,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,IAAI,EAAE,oBAAoB,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC;QAC/C,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC;QAC9B,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,aAAa;QAC5C,KAAK,EAAE,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC;QACjC,SAAS,EAAE,EAAE,GAAG,gBAAgB,EAAE,GAAG,MAAM,CAAC,SAAS,EAAE;KACxD,CAAC;AACJ,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"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"}

package/dist/config/output.d.ts

@@ -0,0 +1,26 @@
+/**
+ * The settings for how a finished picture is encoded, checked here rather than
+ * in `validate/`, which checks keys and the names of closed sets.
+ *
+ * They are in a file of their own rather than beside the other resolvers
+ * because `resolve.ts` is already close enough to the FTA threshold that the
+ * next thing added to it would push it over.
+ */
+/**
+ * Encoding quality, `1` to `100`.
+ *
+ * Out of range is rejected rather than clamped, for the reason
+ * `compressionLevel` is: a config asking for `120` has something in mind that
+ * no encoder here can give it, and quietly encoding at `100` would leave
+ * somebody believing they had asked for more than they had.
+ */
+export declare function resolveQuality(quality: number | undefined): number;
+/**
+ * The cap on one image, in bytes, or `undefined` for none.
+ *
+ * A cap of zero or less can never be met, so it is a mistake rather than a very
+ * strict setting: every image would be written at the lowest quality there is
+ * and every one of them would be reported as too big.
+ */
+export declare function resolveMaxBytes(maxBytes: number | undefined): number | undefined;
+//# sourceMappingURL=output.d.ts.map

package/dist/config/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/config/output.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AAEH;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAalE;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,GAAG,SAAS,GAC3B,MAAM,GAAG,SAAS,CAapB"}

package/dist/config/output.js

@@ -0,0 +1,45 @@
+import { DEFAULT_QUALITY } from "./defaults.js";
+/**
+ * The settings for how a finished picture is encoded, checked here rather than
+ * in `validate/`, which checks keys and the names of closed sets.
+ *
+ * They are in a file of their own rather than beside the other resolvers
+ * because `resolve.ts` is already close enough to the FTA threshold that the
+ * next thing added to it would push it over.
+ */
+/**
+ * Encoding quality, `1` to `100`.
+ *
+ * Out of range is rejected rather than clamped, for the reason
+ * `compressionLevel` is: a config asking for `120` has something in mind that
+ * no encoder here can give it, and quietly encoding at `100` would leave
+ * somebody believing they had asked for more than they had.
+ */
+export function resolveQuality(quality) {
+    if (quality === undefined) {
+        return DEFAULT_QUALITY;
+    }
+    if (!Number.isSafeInteger(quality) || quality < 1 || quality > 100) {
+        throw new Error(`Invalid quality ${String(quality)}; expected a whole number from 1` +
+            ` (smallest) to 100 (best).`);
+    }
+    return quality;
+}
+/**
+ * The cap on one image, in bytes, or `undefined` for none.
+ *
+ * A cap of zero or less can never be met, so it is a mistake rather than a very
+ * strict setting: every image would be written at the lowest quality there is
+ * and every one of them would be reported as too big.
+ */
+export function resolveMaxBytes(maxBytes) {
+    if (maxBytes === undefined) {
+        return undefined;
+    }
+    if (!Number.isSafeInteger(maxBytes) || maxBytes < 1) {
+        throw new Error(`Invalid maxBytes ${String(maxBytes)}; expected a whole number of bytes` +
+            ` above zero, such as 5_000_000 for X's 5MB limit.`);
+    }
+    return maxBytes;
+}
+//# sourceMappingURL=output.js.map

package/dist/config/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../../src/config/output.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD;;;;;;;GAOG;AAEH;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAAC,OAA2B;IACxD,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,OAAO,eAAe,CAAC;IACzB,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,IAAI,OAAO,GAAG,CAAC,IAAI,OAAO,GAAG,GAAG,EAAE,CAAC;QACnE,MAAM,IAAI,KAAK,CACb,mBAAmB,MAAM,CAAC,OAAO,CAAC,kCAAkC;YAClE,4BAA4B,CAC/B,CAAC;IACJ,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAC7B,QAA4B;IAE5B,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;QACpD,MAAM,IAAI,KAAK,CACb,oBAAoB,MAAM,CAAC,QAAQ,CAAC,oCAAoC;YACtE,mDAAmD,CACtD,CAAC;IACJ,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}