@kensio/colophon 2.4.0 → 2.6.0

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"}

package/dist/render/rasterise.d.ts

@@ -0,0 +1,15 @@
+import type { Rasteriser } from "../types.js";
+/**
+ * The default rasteriser: resvg, scaled to `dimensions.width`.
+ *
+ * Text is drawn with the fonts named by `config`, which is what keeps the
+ * output the same on a laptop, in CI and in a container. Height follows the
+ * SVG's own aspect ratio; `buildSvg` sizes it to match.
+ *
+ * It lives here rather than in `png.ts` so that `resolveConfig` can name it as
+ * the default without importing the module that dispatches to it. Nothing here
+ * reads config beyond the fonts, which is the whole of what a rasteriser is
+ * given to work with.
+ */
+export declare const resvgRasteriser: Rasteriser;
+//# sourceMappingURL=rasterise.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rasterise.d.ts","sourceRoot":"","sources":["../../src/render/rasterise.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAkB,MAAM,aAAa,CAAC;AAkB9D;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,eAAe,EAAE,UAO7B,CAAC"}

package/dist/render/rasterise.js

@@ -0,0 +1,34 @@
+import { renderAsync } from "@resvg/resvg-js";
+import { fallbackFamily, fontFilePaths } from "../fonts/index.js";
+/**
+ * Font options for resvg: 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 }),
+    };
+}
+/**
+ * The default rasteriser: resvg, scaled to `dimensions.width`.
+ *
+ * Text is drawn with the fonts named by `config`, which is what keeps the
+ * output the same on a laptop, in CI and in a container. Height follows the
+ * SVG's own aspect ratio; `buildSvg` sizes it to match.
+ *
+ * It lives here rather than in `png.ts` so that `resolveConfig` can name it as
+ * the default without importing the module that dispatches to it. Nothing here
+ * reads config beyond the fonts, which is the whole of what a rasteriser is
+ * given to work with.
+ */
+export const resvgRasteriser = async (svg, dimensions, config) => {
+    const rendered = await renderAsync(svg, {
+        fitTo: { mode: "width", value: dimensions.width },
+        font: await fontOptions(config),
+    });
+    return rendered.asPng();
+};
+//# sourceMappingURL=rasterise.js.map

package/dist/render/rasterise.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rasterise.js","sourceRoot":"","sources":["../../src/render/rasterise.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE9C,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;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,eAAe,GAAe,KAAK,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE;IAC3E,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,CAAC"}

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

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

package/dist/render/svg.js

@@ -1,8 +1,10 @@
-import { backgroundSvg } from "../background.js";
+import { backgroundSvg } from "../background/index.js";
 import { loadImages } from "../image/index.js";
 import { createMeasurer } from "../measure/index.js";
+import { textureSvg } from "../texture/index.js";
 import { selectTemplate } from "./template.js";
 const backgroundId = "colophon-bg";
+const textureId = "colophon-texture";
 /**
  * Build the complete SVG document for one image: the enclosing `<svg>` root,
  * the config-driven background, and the template's foreground content.
@@ -19,6 +21,11 @@ export async function buildSvg(props, config, dimensions) {
         loadImages(config, props),
     ]);
     const background = backgroundSvg(config.background, dimensions, backgroundId, images.background);
+    // Over the background and under the template, so that a treatment gives the
+    // background some surface without ever coming between text and reader.
+    const texture = config.texture === undefined
+        ? ""
+        : textureSvg(config.texture, dimensions, textureId);
     const body = await template.render({
         props,
         config,
@@ -26,10 +33,11 @@ export async function buildSvg(props, config, dimensions) {
         measure,
         logo: images.logo,
         avatar: images.avatar,
+        picture: images.picture,
     });
     const { width, height } = dimensions;
     return (`<svg width="${String(width)}" height="${String(height)}"` +
         ` viewBox="0 0 ${String(width)} ${String(height)}"` +
-        ` xmlns="http://www.w3.org/2000/svg">${background}${body}</svg>`);
+        ` xmlns="http://www.w3.org/2000/svg">${background}${texture}${body}</svg>`);
 }
 //# sourceMappingURL=svg.js.map

package/dist/render/svg.js.map

@@ -1 +1 @@
-{"version":3,"file":"svg.js","sourceRoot":"","sources":["../../src/render/svg.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C,MAAM,YAAY,GAAG,aAAa,CAAC;AAEnC;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,KAAqB,EACrB,MAAsB,EACtB,UAAsB;IAEtB,MAAM,QAAQ,GAAG,cAAc,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;IACxD,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC1C,cAAc,CAAC,MAAM,CAAC;QACtB,UAAU,CAAC,MAAM,EAAE,KAAK,CAAC;KAC1B,CAAC,CAAC;IAEH,MAAM,UAAU,GAAG,aAAa,CAC9B,MAAM,CAAC,UAAU,EACjB,UAAU,EACV,YAAY,EACZ,MAAM,CAAC,UAAU,CAClB,CAAC;IACF,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC;QACjC,KAAK;QACL,MAAM;QACN,UAAU;QACV,OAAO;QACP,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,MAAM,EAAE,MAAM,CAAC,MAAM;KACtB,CAAC,CAAC;IACH,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC;IAErC,OAAO,CACL,eAAe,MAAM,CAAC,KAAK,CAAC,aAAa,MAAM,CAAC,MAAM,CAAC,GAAG;QAC1D,iBAAiB,MAAM,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,GAAG;QACnD,uCAAuC,UAAU,GAAG,IAAI,QAAQ,CACjE,CAAC;AACJ,CAAC"}
+{"version":3,"file":"svg.js","sourceRoot":"","sources":["../../src/render/svg.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C,MAAM,YAAY,GAAG,aAAa,CAAC;AACnC,MAAM,SAAS,GAAG,kBAAkB,CAAC;AAErC;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,KAAqB,EACrB,MAAsB,EACtB,UAAsB;IAEtB,MAAM,QAAQ,GAAG,cAAc,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;IACxD,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC1C,cAAc,CAAC,MAAM,CAAC;QACtB,UAAU,CAAC,MAAM,EAAE,KAAK,CAAC;KAC1B,CAAC,CAAC;IAEH,MAAM,UAAU,GAAG,aAAa,CAC9B,MAAM,CAAC,UAAU,EACjB,UAAU,EACV,YAAY,EACZ,MAAM,CAAC,UAAU,CAClB,CAAC;IACF,4EAA4E;IAC5E,uEAAuE;IACvE,MAAM,OAAO,GACX,MAAM,CAAC,OAAO,KAAK,SAAS;QAC1B,CAAC,CAAC,EAAE;QACJ,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,OAAO,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;IACxD,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC;QACjC,KAAK;QACL,MAAM;QACN,UAAU;QACV,OAAO;QACP,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,OAAO,EAAE,MAAM,CAAC,OAAO;KACxB,CAAC,CAAC;IACH,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC;IAErC,OAAO,CACL,eAAe,MAAM,CAAC,KAAK,CAAC,aAAa,MAAM,CAAC,MAAM,CAAC,GAAG;QAC1D,iBAAiB,MAAM,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,GAAG;QACnD,uCAAuC,UAAU,GAAG,OAAO,GAAG,IAAI,QAAQ,CAC3E,CAAC;AACJ,CAAC"}

package/dist/sign/base64url.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Base64url, which is what a signature has to be to travel in a URL.
+ *
+ * It is ordinary base64 with two characters swapped and the padding dropped,
+ * so the encoding itself comes from `platform/base64.ts` and this is only the
+ * alphabet. `+`, `/` and `=` all mean something in a query string, and a
+ * signature carrying them would depend on every proxy between the two ends
+ * escaping them the same way.
+ */
+export declare function toBase64Url(bytes: Uint8Array): string;
+/**
+ * The reverse. The padding `toBase64Url` dropped is not needed to decode, since
+ * the length of the input says where the bytes end.
+ */
+export declare function fromBase64Url(text: string): Uint8Array<ArrayBuffer>;
+//# sourceMappingURL=base64url.d.ts.map

package/dist/sign/base64url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base64url.d.ts","sourceRoot":"","sources":["../../src/sign/base64url.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAKrD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAAC,WAAW,CAAC,CAEnE"}