@kensio/colophon 2.5.0 → 2.6.0

package/dist/platform/rasteriser.node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rasteriser.node.d.ts","sourceRoot":"","sources":["../../src/platform/rasteriser.node.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,IAAI,iBAAiB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/platform/rasteriser.node.js

@@ -0,0 +1,2 @@
+export { resvgRasteriser as defaultRasteriser } from "../render/rasterise.js";
+//# sourceMappingURL=rasteriser.node.js.map

package/dist/platform/rasteriser.node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rasteriser.node.js","sourceRoot":"","sources":["../../src/platform/rasteriser.node.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,IAAI,iBAAiB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/platform/read-file.browser.d.ts

@@ -0,0 +1,17 @@
+/**
+ * The browser and edge stand-in for reading a file, which is to say there is no
+ * reading a file.
+ *
+ * A bundler picks this up through `package.json`'s `browser` field. Supplying
+ * a font or an image as a path is the one thing the core cannot do, since there
+ * is no filesystem to resolve it against, so it says so rather than failing
+ * later as a missing glyph or a blank image.
+ */
+export declare function readFileBytes(path: string): Promise<Uint8Array>;
+/**
+ * The same, and the same answer: a path names a file, and there are none here.
+ * Refused when the config is resolved rather than when the image is drawn, so
+ * that a config which cannot work here says so before anything renders.
+ */
+export declare function resolveReadablePath(given: string, label: string, kind: string): string;
+//# sourceMappingURL=read-file.browser.d.ts.map

package/dist/platform/read-file.browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-file.browser.d.ts","sourceRoot":"","sources":["../../src/platform/read-file.browser.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAO/D;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,GACX,MAAM,CAKR"}

package/dist/platform/read-file.browser.js

@@ -0,0 +1,23 @@
+/**
+ * The browser and edge stand-in for reading a file, which is to say there is no
+ * reading a file.
+ *
+ * A bundler picks this up through `package.json`'s `browser` field. Supplying
+ * a font or an image as a path is the one thing the core cannot do, since there
+ * is no filesystem to resolve it against, so it says so rather than failing
+ * later as a missing glyph or a blank image.
+ */
+export function readFileBytes(path) {
+    return Promise.reject(new Error(`Cannot read "${path}": there is no filesystem here. Supply fonts and` +
+        ` images as bytes ({ data }) rather than as paths ({ path }).`));
+}
+/**
+ * The same, and the same answer: a path names a file, and there are none here.
+ * Refused when the config is resolved rather than when the image is drawn, so
+ * that a config which cannot work here says so before anything renders.
+ */
+export function resolveReadablePath(given, label, kind) {
+    throw new Error(`${label}: cannot read the ${kind} at "${given}" here, since there is no` +
+        ` filesystem. Supply the bytes as "data" instead.`);
+}
+//# sourceMappingURL=read-file.browser.js.map

package/dist/platform/read-file.browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-file.browser.js","sourceRoot":"","sources":["../../src/platform/read-file.browser.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,OAAO,CAAC,MAAM,CACnB,IAAI,KAAK,CACP,gBAAgB,IAAI,kDAAkD;QACpE,8DAA8D,CACjE,CACF,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CACjC,KAAa,EACb,KAAa,EACb,IAAY;IAEZ,MAAM,IAAI,KAAK,CACb,GAAG,KAAK,qBAAqB,IAAI,QAAQ,KAAK,2BAA2B;QACvE,kDAAkD,CACrD,CAAC;AACJ,CAAC"}

package/dist/platform/read-file.node.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Read a file named by a path.
+ *
+ * It is a module of its own so that a bundler can swap it: `package.json`'s
+ * `browser` field points at the sibling that cannot, which is what keeps
+ * `node:fs` out of the browser build's import graph. Everything that reads a
+ * path goes through here, so there is one thing to swap rather than a check in
+ * each caller.
+ */
+export declare function readFileBytes(path: string): Promise<Uint8Array>;
+/**
+ * Make a configured path absolute and check something is there to read.
+ *
+ * Checked when the config is resolved rather than when the file is opened,
+ * because a font or an image that cannot be read shows up as a blank corner on
+ * every generated image, and a blank corner does not say which path was wrong.
+ */
+export declare function resolveReadablePath(given: string, label: string, kind: string): string;
+//# sourceMappingURL=read-file.node.d.ts.map

package/dist/platform/read-file.node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-file.node.d.ts","sourceRoot":"","sources":["../../src/platform/read-file.node.ts"],"names":[],"mappings":"AAIA;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAErE;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,GACX,MAAM,CAWR"}

package/dist/platform/read-file.node.js

@@ -0,0 +1,31 @@
+import { existsSync, statSync } from "node:fs";
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+/**
+ * Read a file named by a path.
+ *
+ * It is a module of its own so that a bundler can swap it: `package.json`'s
+ * `browser` field points at the sibling that cannot, which is what keeps
+ * `node:fs` out of the browser build's import graph. Everything that reads a
+ * path goes through here, so there is one thing to swap rather than a check in
+ * each caller.
+ */
+export async function readFileBytes(path) {
+    return new Uint8Array(await readFile(path));
+}
+/**
+ * Make a configured path absolute and check something is there to read.
+ *
+ * Checked when the config is resolved rather than when the file is opened,
+ * because a font or an image that cannot be read shows up as a blank corner on
+ * every generated image, and a blank corner does not say which path was wrong.
+ */
+export function resolveReadablePath(given, label, kind) {
+    const absolute = path.resolve(given);
+    if (!existsSync(absolute) || !statSync(absolute).isFile()) {
+        throw new Error(`${label}: ${kind} not found at ${absolute} (from "${given}").` +
+            ` Relative paths resolve from the working directory.`);
+    }
+    return absolute;
+}
+//# sourceMappingURL=read-file.node.js.map

package/dist/platform/read-file.node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-file.node.js","sourceRoot":"","sources":["../../src/platform/read-file.node.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAY;IAC9C,OAAO,IAAI,UAAU,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;AAC9C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CACjC,KAAa,EACb,KAAa,EACb,IAAY;IAEZ,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAErC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;QAC1D,MAAM,IAAI,KAAK,CACb,GAAG,KAAK,KAAK,IAAI,iBAAiB,QAAQ,WAAW,KAAK,KAAK;YAC7D,qDAAqD,CACxD,CAAC;IACJ,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/png/chunk.d.ts

@@ -0,0 +1,23 @@
+/** The eight bytes every PNG file starts with. */
+export declare const pngSignature: Buffer<ArrayBuffer>;
+/** One chunk of a PNG: its four-character type and the data it carries. */
+export interface PngChunk {
+    readonly type: string;
+    readonly data: Buffer;
+}
+/**
+ * A whole PNG chunk as bytes: its length, its type, its data, and the CRC over
+ * the type and data together.
+ */
+export declare function chunkBytes(type: string, data: Buffer): Buffer;
+/**
+ * The chunks of a PNG, in the order the file declares them.
+ *
+ * `undefined` where the bytes are not a PNG at all, or where a chunk runs past
+ * the end of them, which between them cover everything a caller can do about
+ * it: whatever this is, it is not a file to take apart and put back together.
+ * The CRCs are not checked, since nothing here is deciding whether to trust the
+ * image, only where one chunk ends and the next begins.
+ */
+export declare function readChunks(png: Buffer): PngChunk[] | undefined;
+//# sourceMappingURL=chunk.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chunk.d.ts","sourceRoot":"","sources":["../../src/png/chunk.ts"],"names":[],"mappings":"AAEA,kDAAkD;AAClD,eAAO,MAAM,YAAY,qBAEvB,CAAC;AAEH,2EAA2E;AAC3E,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAY7D;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,EAAE,GAAG,SAAS,CAyB9D"}

package/dist/png/chunk.js

@@ -0,0 +1,48 @@
+import { crc32 } from "node:zlib";
+/** The eight bytes every PNG file starts with. */
+export const pngSignature = Buffer.from([
+    0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a,
+]);
+/**
+ * A whole PNG chunk as bytes: its length, its type, its data, and the CRC over
+ * the type and data together.
+ */
+export function chunkBytes(type, data) {
+    const chunk = Buffer.alloc(4 + 4 + data.length + 4);
+    chunk.writeUInt32BE(data.length, 0);
+    chunk.write(type, 4, "latin1");
+    data.copy(chunk, 8);
+    chunk.writeUInt32BE(crc32(chunk.subarray(4, 8 + data.length)), 8 + data.length);
+    return chunk;
+}
+/**
+ * The chunks of a PNG, in the order the file declares them.
+ *
+ * `undefined` where the bytes are not a PNG at all, or where a chunk runs past
+ * the end of them, which between them cover everything a caller can do about
+ * it: whatever this is, it is not a file to take apart and put back together.
+ * The CRCs are not checked, since nothing here is deciding whether to trust the
+ * image, only where one chunk ends and the next begins.
+ */
+export function readChunks(png) {
+    if (!png.subarray(0, pngSignature.length).equals(pngSignature)) {
+        return undefined;
+    }
+    const chunks = [];
+    let offset = pngSignature.length;
+    while (offset + 12 <= png.length) {
+        const length = png.readUInt32BE(offset);
+        const end = offset + 12 + length;
+        if (end > png.length) {
+            return undefined;
+        }
+        chunks.push({
+            type: png.toString("latin1", offset + 4, offset + 8),
+            data: png.subarray(offset + 8, offset + 8 + length),
+        });
+        offset = end;
+    }
+    // Trailing bytes that are not a chunk mean this was read wrong somewhere.
+    return offset === png.length ? chunks : undefined;
+}
+//# sourceMappingURL=chunk.js.map

package/dist/png/chunk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk.js","sourceRoot":"","sources":["../../src/png/chunk.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAElC,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;AAQH;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,IAAY;IACnD,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,IAAI,EAAE,CAAC,EAAE,QAAQ,CAAC,CAAC;IAC/B,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;;;;;;;;GAQG;AACH,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC;QAC/D,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,MAAM,GAAe,EAAE,CAAC;IAC9B,IAAI,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC;IAEjC,OAAO,MAAM,GAAG,EAAE,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;QACjC,MAAM,MAAM,GAAG,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;QACxC,MAAM,GAAG,GAAG,MAAM,GAAG,EAAE,GAAG,MAAM,CAAC;QAEjC,IAAI,GAAG,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC;YACrB,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,GAAG,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC;YACpD,IAAI,EAAE,GAAG,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,MAAM,GAAG,CAAC,GAAG,MAAM,CAAC;SACpD,CAAC,CAAC;QACH,MAAM,GAAG,GAAG,CAAC;IACf,CAAC;IAED,0EAA0E;IAC1E,OAAO,MAAM,KAAK,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;AACpD,CAAC"}

package/dist/png/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Reading and rewriting the PNG container itself, as against the picture in it.
+ *
+ * Two things in the package have to open a finished PNG: the rebuild stamp,
+ * which puts a `tEXt` chunk in the header, and the recompressor, which replaces
+ * the image data with a smaller encoding of the same bytes. Both need the same
+ * chunk arithmetic, and writing a CRC in two places is how the two would come
+ * to disagree.
+ */
+export type { PngChunk } from "./chunk.js";
+export { chunkBytes, pngSignature, readChunks } from "./chunk.js";
+export { recompressPng } from "./recompress.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/png/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,YAAY,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/png/index.js

@@ -0,0 +1,3 @@
+export { chunkBytes, pngSignature, readChunks } from "./chunk.js";
+export { recompressPng } from "./recompress.js";
+//# sourceMappingURL=index.js.map

package/dist/png/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/png/index.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/png/recompress.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Re-encode a PNG's image data at zlib level `level`, returning the smaller of
+ * what that produced and what came in.
+ *
+ * This is lossless in the strongest sense available: the filtered scanlines are
+ * inflated and deflated again untouched, so not a pixel moves and not even a
+ * row filter changes. All that differs is how hard the deflater looked for
+ * matches. resvg encodes for speed, which on a 1200x1200 gradient costs about
+ * three times the file size, and these are images a site commits and then
+ * serves to everyone who shares a link.
+ *
+ * Re-filtering the rows adaptively rather than keeping resvg's fixed `Sub` was
+ * measured too, and bought about another 5% for more time again and a filter
+ * implementation to maintain, so it is not done.
+ *
+ * A `level` of `0` means leave the bytes alone, as does anything that is not a
+ * PNG this can take apart: a rasteriser other than the default may return a
+ * format with nothing in common with this, and refusing it here would be
+ * refusing it for the wrong reason. Bytes that claim to be a PNG and then fail
+ * to inflate are a broken image, and that does throw.
+ */
+export declare function recompressPng(png: Buffer, level: number): Promise<Buffer>;
+//# sourceMappingURL=recompress.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"recompress.d.ts","sourceRoot":"","sources":["../../src/png/recompress.ts"],"names":[],"mappings":"AAuDA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,aAAa,CACjC,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,MAAM,CAAC,CAmBjB"}

package/dist/png/recompress.js

@@ -0,0 +1,81 @@
+import { promisify } from "node:util";
+import { deflate, inflate } from "node:zlib";
+import { chunkBytes, pngSignature, readChunks } from "./chunk.js";
+const inflateAsync = promisify(inflate);
+const deflateAsync = promisify(deflate);
+/**
+ * Where the compression method sits in `IHDR`, after the width, the height,
+ * the bit depth and the colour type.
+ */
+const compressionMethodOffset = 10;
+/**
+ * Whether the image data is a plain zlib stream, which is the only compression
+ * method PNG defines and so the only one there is anything here to re-encode.
+ * A file whose header says otherwise is left as it is rather than guessed at.
+ */
+function isDeflated(chunks) {
+    const header = chunks[0];
+    return (header?.type === "IHDR" &&
+        header.data.length >= 13 &&
+        header.data[compressionMethodOffset] === 0);
+}
+/**
+ * The file put back together with `idat` in place of the image data it held.
+ *
+ * Every other chunk is kept, in its original order and at its original place:
+ * a rasteriser may have written a `pHYs` or a `gAMA` that says how the image is
+ * meant to be shown, and dropping one to save a few bytes would change what the
+ * image is. The new data goes where the first `IDAT` was, since the ones after
+ * it were the same stream split up.
+ */
+function rebuild(chunks, idat) {
+    const parts = [pngSignature];
+    let isWritten = false;
+    for (const chunk of chunks) {
+        if (chunk.type !== "IDAT") {
+            parts.push(chunkBytes(chunk.type, chunk.data));
+        }
+        else if (!isWritten) {
+            isWritten = true;
+            parts.push(chunkBytes("IDAT", idat));
+        }
+    }
+    return Buffer.concat(parts);
+}
+/**
+ * Re-encode a PNG's image data at zlib level `level`, returning the smaller of
+ * what that produced and what came in.
+ *
+ * This is lossless in the strongest sense available: the filtered scanlines are
+ * inflated and deflated again untouched, so not a pixel moves and not even a
+ * row filter changes. All that differs is how hard the deflater looked for
+ * matches. resvg encodes for speed, which on a 1200x1200 gradient costs about
+ * three times the file size, and these are images a site commits and then
+ * serves to everyone who shares a link.
+ *
+ * Re-filtering the rows adaptively rather than keeping resvg's fixed `Sub` was
+ * measured too, and bought about another 5% for more time again and a filter
+ * implementation to maintain, so it is not done.
+ *
+ * A `level` of `0` means leave the bytes alone, as does anything that is not a
+ * PNG this can take apart: a rasteriser other than the default may return a
+ * format with nothing in common with this, and refusing it here would be
+ * refusing it for the wrong reason. Bytes that claim to be a PNG and then fail
+ * to inflate are a broken image, and that does throw.
+ */
+export async function recompressPng(png, level) {
+    const chunks = level === 0 ? undefined : readChunks(png);
+    if (chunks === undefined || !isDeflated(chunks)) {
+        return png;
+    }
+    const image = chunks.filter((chunk) => chunk.type === "IDAT");
+    if (image.length === 0) {
+        return png;
+    }
+    const data = await inflateAsync(Buffer.concat(image.map(({ data }) => data)));
+    const rebuilt = rebuild(chunks, await deflateAsync(data, { level }));
+    // A rasteriser that already compresses well would otherwise be undone by a
+    // level that happens to suit it less than the one it chose for itself.
+    return rebuilt.length < png.length ? rebuilt : png;
+}
+//# sourceMappingURL=recompress.js.map

package/dist/png/recompress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recompress.js","sourceRoot":"","sources":["../../src/png/recompress.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAG7C,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAElE,MAAM,YAAY,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;AACxC,MAAM,YAAY,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;AAExC;;;GAGG;AACH,MAAM,uBAAuB,GAAG,EAAE,CAAC;AAEnC;;;;GAIG;AACH,SAAS,UAAU,CAAC,MAA2B;IAC7C,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IAEzB,OAAO,CACL,MAAM,EAAE,IAAI,KAAK,MAAM;QACvB,MAAM,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE;QACxB,MAAM,CAAC,IAAI,CAAC,uBAAuB,CAAC,KAAK,CAAC,CAC3C,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,SAAS,OAAO,CAAC,MAA2B,EAAE,IAAY;IACxD,MAAM,KAAK,GAAa,CAAC,YAAY,CAAC,CAAC;IACvC,IAAI,SAAS,GAAG,KAAK,CAAC;IAEtB,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC1B,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QACjD,CAAC;aAAM,IAAI,CAAC,SAAS,EAAE,CAAC;YACtB,SAAS,GAAG,IAAI,CAAC;YACjB,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC9B,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,GAAW,EACX,KAAa;IAEb,MAAM,MAAM,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IAEzD,IAAI,MAAM,KAAK,SAAS,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QAChD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;IAE9D,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,GAAG,CAAC;IACb,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC9E,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,EAAE,MAAM,YAAY,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;IAErE,2EAA2E;IAC3E,uEAAuE;IACvE,OAAO,OAAO,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;AACrD,CAAC"}

package/dist/props.d.ts

@@ -4,4 +4,15 @@
  * templates treat "not a usable string" and "absent" the same way.
  */
 export declare function optionalString(value: unknown): string | undefined;
+/**
+ * Read a prop as a list of strings: a YAML sequence as it stands, and a single
+ * value as a list of one.
+ *
+ * Taking the scalar too is what stops `tags: release` being a post with no
+ * tags. Frontmatter is hand-written, the two forms are both ordinary YAML, and
+ * a template asking for a list has nothing useful to do with the difference.
+ * Entries that are not usable strings are dropped rather than rendered as
+ * holes, which is {@link optionalString}'s rule applied item by item.
+ */
+export declare function stringList(value: unknown): readonly string[];
 //# sourceMappingURL=props.d.ts.map

package/dist/props.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"props.d.ts","sourceRoot":"","sources":["../src/props.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAcjE"}
+{"version":3,"file":"props.d.ts","sourceRoot":"","sources":["../src/props.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAcjE;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,MAAM,EAAE,CAM5D"}

package/dist/props.js

@@ -14,4 +14,20 @@ export function optionalString(value) {
     }
     return undefined;
 }
+/**
+ * Read a prop as a list of strings: a YAML sequence as it stands, and a single
+ * value as a list of one.
+ *
+ * Taking the scalar too is what stops `tags: release` being a post with no
+ * tags. Frontmatter is hand-written, the two forms are both ordinary YAML, and
+ * a template asking for a list has nothing useful to do with the difference.
+ * Entries that are not usable strings are dropped rather than rendered as
+ * holes, which is {@link optionalString}'s rule applied item by item.
+ */
+export function stringList(value) {
+    const items = Array.isArray(value) ? value : [value];
+    return items
+        .map((item) => optionalString(item))
+        .filter((item) => item !== undefined && item !== "");
+}
 //# sourceMappingURL=props.js.map

package/dist/props.js.map

@@ -1 +1 @@
-{"version":3,"file":"props.js","sourceRoot":"","sources":["../src/props.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IACE,OAAO,KAAK,KAAK,QAAQ;QACzB,OAAO,KAAK,KAAK,SAAS;QAC1B,OAAO,KAAK,KAAK,QAAQ,EACzB,CAAC;QACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}
+{"version":3,"file":"props.js","sourceRoot":"","sources":["../src/props.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IACE,OAAO,KAAK,KAAK,QAAQ;QACzB,OAAO,KAAK,KAAK,SAAS;QAC1B,OAAO,KAAK,KAAK,QAAQ,EACzB,CAAC;QACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,UAAU,CAAC,KAAc;IACvC,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAErD,OAAO,KAAK;SACT,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;SACnC,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,EAAE,CAAC,CAAC;AACzE,CAAC"}

package/dist/render/image.d.ts

@@ -0,0 +1,20 @@
+import type { Dimensions, ResolvedConfig } from "../types.js";
+/**
+ * Rasterise an SVG string to image bytes at `dimensions`.
+ *
+ * Every path that produces an image goes through here, so this is the one place
+ * the configured rasteriser has to be chosen. A project that supplies its own
+ * gets it used by `renderMetaImages`, by `generate` and by `colophon preview`
+ * alike, none of which knows there was a choice to make.
+ *
+ * It is also where the bytes are encoded as `config.format`, for the same
+ * reason and on the same terms: which format a build writes is the project's
+ * decision rather than the rasteriser's, and a caller taking the bytes away to
+ * write them itself should not have to encode them again to get what it asked
+ * for.
+ *
+ * It was `renderSvgToPng` while PNG was the only thing it could return. Now
+ * that a config chooses, that name would be wrong three times in four.
+ */
+export declare function renderSvgToImage(svg: string, dimensions: Dimensions, config?: ResolvedConfig): Promise<Buffer>;
+//# sourceMappingURL=image.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"image.d.ts","sourceRoot":"","sources":["../../src/render/image.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE9D;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,UAAU,EACtB,MAAM,GAAE,cAAgC,GACvC,OAAO,CAAC,MAAM,CAAC,CAUjB"}

package/dist/render/image.js

@@ -0,0 +1,29 @@
+import { resolveConfig } from "../config/index.js";
+import { encodeImage } from "../encode/index.js";
+/**
+ * Rasterise an SVG string to image bytes at `dimensions`.
+ *
+ * Every path that produces an image goes through here, so this is the one place
+ * the configured rasteriser has to be chosen. A project that supplies its own
+ * gets it used by `renderMetaImages`, by `generate` and by `colophon preview`
+ * alike, none of which knows there was a choice to make.
+ *
+ * It is also where the bytes are encoded as `config.format`, for the same
+ * reason and on the same terms: which format a build writes is the project's
+ * decision rather than the rasteriser's, and a caller taking the bytes away to
+ * write them itself should not have to encode them again to get what it asked
+ * for.
+ *
+ * It was `renderSvgToPng` while PNG was the only thing it could return. Now
+ * that a config chooses, that name would be wrong three times in four.
+ */
+export async function renderSvgToImage(svg, dimensions, config = resolveConfig()) {
+    const bytes = await config.rasteriser(svg, dimensions, config);
+    // A rasteriser returns bytes, since not every one of them has a `Buffer` to
+    // return. Everything downstream of here is Node, and the stamp reads the
+    // image with `Buffer`'s own methods, so this is where the two meet. A
+    // `Buffer` arrives as itself rather than being copied.
+    const raster = Buffer.isBuffer(bytes) ? bytes : Buffer.from(bytes);
+    return encodeImage(raster, config);
+}
+//# sourceMappingURL=image.js.map

package/dist/render/image.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"image.js","sourceRoot":"","sources":["../../src/render/image.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGjD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,GAAW,EACX,UAAsB,EACtB,MAAM,GAAmB,aAAa,EAAE;IAExC,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;IAE/D,4EAA4E;IAC5E,yEAAyE;IACzE,sEAAsE;IACtE,uDAAuD;IACvD,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAEnE,OAAO,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACrC,CAAC"}

package/dist/render/index.d.ts

@@ -1,6 +1,7 @@
 import type { ColophonConfig, MetaImageProps, RenderedMetaImage } from "../types.js";
 export { buildSvg } from "./svg.js";
-export { renderSvgToPng } from "./png.js";
+export { renderSvgToImage } from "./image.js";
+export { resvgRasteriser } from "./rasterise.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

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

@@ -1 +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"}
+{"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,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD;;;;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

@@ -1,10 +1,11 @@
 import { resolveConfig } from "../config/index.js";
 import { resolveConfigForSize } from "../config/size.js";
-import { renderSvgToPng } from "./png.js";
+import { renderSvgToImage } from "./image.js";
 import { buildSvg } from "./svg.js";
 import { selectTemplate } from "./template.js";
 export { buildSvg } from "./svg.js";
-export { renderSvgToPng } from "./png.js";
+export { renderSvgToImage } from "./image.js";
+export { resvgRasteriser } from "./rasterise.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
@@ -20,8 +21,8 @@ export async function renderMetaImages(props, config) {
         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 };
+        const bytes = await renderSvgToImage(svg, dimensions, sizeConfig);
+        return { name: size.name, dimensions, svg, bytes };
     }));
 }
 //# sourceMappingURL=index.js.map

package/dist/render/index.js.map

@@ -1 +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"}
+{"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,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,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,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD;;;;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,KAAK,GAAG,MAAM,gBAAgB,CAAC,GAAG,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;QAClE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;IACrD,CAAC,CAAC,CACH,CAAC;AACJ,CAAC"}

package/dist/render/png.d.ts

@@ -1,10 +1,20 @@
 import type { Dimensions, ResolvedConfig } from "../types.js";
 /**
- * Rasterise an SVG string to a PNG buffer, scaled to `dimensions.width`.
+ * Rasterise an SVG string to image bytes at `dimensions`.
  *
- * 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.
+ * Every path that produces an image goes through here, so this is the one place
+ * the configured rasteriser has to be chosen. A project that supplies its own
+ * gets it used by `renderMetaImages`, by `generate` and by `colophon preview`
+ * alike, none of which knows there was a choice to make.
+ *
+ * It is also where the bytes are compressed again, for the same reason and on
+ * the same terms: an image is worth shrinking whoever asked for it, and a
+ * caller taking the bytes away to write itself should not have to know that the
+ * rasteriser left three quarters of the saving on the table.
+ *
+ * The name is what it was before the backend became configurable. PNG is still
+ * what comes back by default, and renaming this would break every caller to say
+ * something the config already says.
  */
 export declare function renderSvgToPng(svg: string, dimensions: Dimensions, config?: ResolvedConfig): Promise<Buffer>;
 //# sourceMappingURL=png.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"png.d.ts","sourceRoot":"","sources":["../../src/render/png.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE9D;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,cAAc,CAClC,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,UAAU,EACtB,MAAM,GAAE,cAAgC,GACvC,OAAO,CAAC,MAAM,CAAC,CAUjB"}

package/dist/render/png.js

@@ -1,30 +1,29 @@
-import { renderAsync } from "@resvg/resvg-js";
 import { resolveConfig } from "../config/index.js";
-import { fallbackFamily, fontFilePaths } from "../fonts/index.js";
+import { recompressPng } from "../png/recompress.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`.
+ * Rasterise an SVG string to image bytes at `dimensions`.
+ *
+ * Every path that produces an image goes through here, so this is the one place
+ * the configured rasteriser has to be chosen. A project that supplies its own
+ * gets it used by `renderMetaImages`, by `generate` and by `colophon preview`
+ * alike, none of which knows there was a choice to make.
+ *
+ * It is also where the bytes are compressed again, for the same reason and on
+ * the same terms: an image is worth shrinking whoever asked for it, and a
+ * caller taking the bytes away to write itself should not have to know that the
+ * rasteriser left three quarters of the saving on the table.
  *
- * 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.
+ * The name is what it was before the backend became configurable. PNG is still
+ * what comes back by default, and renaming this would break every caller to say
+ * something the config already says.
  */
 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();
+    const bytes = await config.rasteriser(svg, dimensions, config);
+    // A rasteriser returns bytes, since not every one of them has a `Buffer` to
+    // return. Everything downstream of here is Node, and the stamp reads the PNG
+    // with `Buffer`'s own methods, so this is where the two meet. A `Buffer`
+    // arrives as itself rather than being copied.
+    const png = Buffer.isBuffer(bytes) ? bytes : Buffer.from(bytes);
+    return recompressPng(png, config.compressionLevel);
 }
 //# sourceMappingURL=png.js.map

package/dist/render/png.js.map

@@ -1 +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"}
+{"version":3,"file":"png.js","sourceRoot":"","sources":["../../src/render/png.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAGrD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,GAAW,EACX,UAAsB,EACtB,MAAM,GAAmB,aAAa,EAAE;IAExC,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;IAE/D,4EAA4E;IAC5E,6EAA6E;IAC7E,yEAAyE;IACzE,8CAA8C;IAC9C,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAEhE,OAAO,aAAa,CAAC,GAAG,EAAE,MAAM,CAAC,gBAAgB,CAAC,CAAC;AACrD,CAAC"}