@kensio/colophon 2.5.0 → 2.6.0

package/dist/stamp/carrier/riff.js

@@ -0,0 +1,54 @@
+import { findPayload, stampFromPayload } from "../payload.js";
+/**
+ * The chunk type the stamp is stored under. The WebP container says a reader
+ * should skip a chunk it does not know, which is what makes an invented one
+ * safe; there is no registered type for a note of one's own.
+ */
+const stampChunk = "CLPH";
+/** Four characters of type and a four-byte length, little-endian. */
+const header = 8;
+function isWebp(head) {
+    return (head.length >= 12 &&
+        head.toString("latin1", 0, 4) === "RIFF" &&
+        head.toString("latin1", 8, 12) === "WEBP");
+}
+/**
+ * The file with the stamp chunk on the end of it, and the RIFF length, which
+ * counts everything after itself, brought up to match.
+ *
+ * Appended rather than inserted because a plain WebP is `RIFF`, `WEBP` and then
+ * the bitstream, with no room declared for anything else: libwebp reads the
+ * chunk straight after `WEBP` as the image and refuses a file where it is
+ * something else. Only the extended layout tolerates chunks in front of the
+ * picture, and a build cannot know which layout it has been handed.
+ */
+function write(webp, payload) {
+    // RIFF chunks are padded to an even length; the padding is not counted.
+    const chunk = Buffer.alloc(header + payload.length + (payload.length % 2));
+    chunk.write(stampChunk, 0, "latin1");
+    chunk.writeUInt32LE(payload.length, 4);
+    payload.copy(chunk, header);
+    const stamped = Buffer.concat([webp, chunk]);
+    stamped.writeUInt32LE(stamped.length - 8, 4);
+    return stamped;
+}
+function read(tail) {
+    const at = findPayload(tail);
+    const start = at - header;
+    if (start < 0 || tail.toString("latin1", start, at - 4) !== stampChunk) {
+        return undefined;
+    }
+    const end = at + tail.readUInt32LE(at - 4);
+    return end > tail.length
+        ? undefined
+        : stampFromPayload(tail.subarray(at, end));
+}
+/** WebP, where the stamp is a chunk of its own on the end of the RIFF file. */
+export const riffCarrier = {
+    format: "WebP",
+    end: "tail",
+    matches: isWebp,
+    write,
+    read,
+};
+//# sourceMappingURL=riff.js.map

package/dist/stamp/carrier/riff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"riff.js","sourceRoot":"","sources":["../../../src/stamp/carrier/riff.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAG9D;;;;GAIG;AACH,MAAM,UAAU,GAAG,MAAM,CAAC;AAE1B,qEAAqE;AACrE,MAAM,MAAM,GAAG,CAAC,CAAC;AAEjB,SAAS,MAAM,CAAC,IAAY;IAC1B,OAAO,CACL,IAAI,CAAC,MAAM,IAAI,EAAE;QACjB,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC,KAAK,MAAM;QACxC,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,MAAM,CAC1C,CAAC;AACJ,CAAC;AAED;;;;;;;;;GASG;AACH,SAAS,KAAK,CAAC,IAAY,EAAE,OAAe;IAC1C,wEAAwE;IACxE,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;IAE3E,KAAK,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC,EAAE,QAAQ,CAAC,CAAC;IACrC,KAAK,CAAC,aAAa,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IACvC,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAE5B,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;IAC7C,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IAC7C,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,IAAI,CAAC,IAAY;IACxB,MAAM,EAAE,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IAC7B,MAAM,KAAK,GAAG,EAAE,GAAG,MAAM,CAAC;IAE1B,IAAI,KAAK,GAAG,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,KAAK,EAAE,EAAE,GAAG,CAAC,CAAC,KAAK,UAAU,EAAE,CAAC;QACvE,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,GAAG,GAAG,EAAE,GAAG,IAAI,CAAC,YAAY,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;IAC3C,OAAO,GAAG,GAAG,IAAI,CAAC,MAAM;QACtB,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,gBAAgB,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC;AAC/C,CAAC;AAED,+EAA+E;AAC/E,MAAM,CAAC,MAAM,WAAW,GAAiB;IACvC,MAAM,EAAE,MAAM;IACd,GAAG,EAAE,MAAM;IACX,OAAO,EAAE,MAAM;IACf,KAAK;IACL,IAAI;CACL,CAAC"}

package/dist/stamp/carrier/types.d.ts

@@ -0,0 +1,25 @@
+/**
+ * One image container the rebuild stamp can be written into and read back out
+ * of again.
+ */
+export interface StampCarrier {
+    /** What to call the container in a message. */
+    readonly format: string;
+    /**
+     * Which end of the file the stamp is written to, and so read back from.
+     *
+     * PNG and JPEG both define a place near the front for a note in text, so the
+     * stamp goes there and a build decides whether to skip a file having read
+     * only its head. RIFF and ISO base media have no such place, and both keep
+     * offsets that inserting bytes ahead of the image data would move, so the
+     * stamp is appended and the window comes off the end instead.
+     */
+    readonly end: "head" | "tail";
+    /** Whether the leading bytes of a file are this container. */
+    matches(head: Buffer): boolean;
+    /** `image` with `payload` embedded, leaving every pixel of it alone. */
+    write(image: Buffer, payload: Buffer): Buffer;
+    /** The stamp in a window taken from this carrier's `end`, if it is there. */
+    read(window: Buffer): string | undefined;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/stamp/carrier/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/stamp/carrier/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,+CAA+C;IAC/C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB;;;;;;;;OAQG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IAC9B,8DAA8D;IAC9D,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAC/B,wEAAwE;IACxE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IAC9C,6EAA6E;IAC7E,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CAC1C"}

package/dist/stamp/carrier/types.js

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

package/dist/stamp/carrier/types.js.map

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

package/dist/stamp/chunk.d.ts

@@ -4,8 +4,6 @@
  * its stamp with it.
  */
 export declare const stampKeyword = "colophon";
-/** The eight bytes every PNG file starts with. */
-export declare const pngSignature: Buffer<ArrayBuffer>;
 /** Signature + the whole `IHDR` chunk: length, type, 13 bytes of data, CRC. */
 export declare const afterHeader: number;
 /**

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

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

package/dist/stamp/chunk.js

@@ -1,31 +1,19 @@
-import { crc32 } from "node:zlib";
+import { chunkBytes, pngSignature } from "../png/chunk.js";
 /**
  * PNG `tEXt` keyword the stamp is stored under. Keeping it in the image means
  * there is no sidecar file to fall out of sync, and deleting an image deletes
  * its stamp with it.
  */
 export const stampKeyword = "colophon";
-/** The eight bytes every PNG file starts with. */
-export const pngSignature = Buffer.from([
-    0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a,
-]);
 /** Signature + the whole `IHDR` chunk: length, type, 13 bytes of data, CRC. */
 export const afterHeader = pngSignature.length + 4 + 4 + 13 + 4;
-/**
- * A PNG `tEXt` chunk: length, type, `keyword\0text`, CRC over type and data.
- */
-function textChunk(keyword, text) {
-    const data = Buffer.concat([
+/** What a `tEXt` chunk carries: `keyword\0text`. */
+function textData(keyword, text) {
+    return Buffer.concat([
         Buffer.from(keyword, "latin1"),
         Buffer.from([0]),
         Buffer.from(text, "latin1"),
     ]);
-    const chunk = Buffer.alloc(4 + 4 + data.length + 4);
-    chunk.writeUInt32BE(data.length, 0);
-    chunk.write("tEXt", 4, "latin1");
-    data.copy(chunk, 8);
-    chunk.writeUInt32BE(crc32(chunk.subarray(4, 8 + data.length)), 8 + data.length);
-    return chunk;
 }
 /**
  * Return `png` with the stamp embedded as a `tEXt` chunk, inserted straight
@@ -35,11 +23,15 @@ export function stampPng(png, stamp) {
     if (png.length < afterHeader ||
         !png.subarray(0, pngSignature.length).equals(pngSignature) ||
         png.toString("latin1", 12, 16) !== "IHDR") {
-        throw new Error("Cannot stamp: not a PNG image.");
+        // Reachable in practice only through a configured rasteriser, since resvg
+        // writes nothing else. Saying why beats leaving someone to work out that
+        // the stamp is the reason their WebP backend cannot be used yet.
+        throw new Error("Cannot stamp: not a PNG image. The rebuild stamp is a PNG chunk, so a" +
+            " rasteriser has to produce PNG for a build to be able to skip it.");
     }
     return Buffer.concat([
         png.subarray(0, afterHeader),
-        textChunk(stampKeyword, stamp),
+        chunkBytes("tEXt", textData(stampKeyword, stamp)),
         png.subarray(afterHeader),
     ]);
 }

package/dist/stamp/chunk.js.map

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

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

@@ -6,6 +6,24 @@ import type { ResolvedConfig } from "../types.js";
  * `templates`: the one size and the one template an image actually uses go into
  * its own stamp, so adding a third size or an unrelated custom template does
  * not invalidate everything already on disk.
+ *
+ * `compressionLevel` is in even though it cannot change a pixel, which is the
+ * rule `onWarning` is left out under. What it changes is every byte of every
+ * file, and a project turning it up wants the images it already has rewritten:
+ * without this the setting would appear to do nothing until each post next
+ * changed, which is the sort of gap that gets reported as a bug.
+ *
+ * `format`, `quality` and `maxBytes` are in for the same reason, and `emitSvg`
+ * for a version of it: turning it on has to write the documents for images that
+ * are already on disk, and without this it would write them only for the posts
+ * that happened to change next.
+ *
+ * The rasteriser is in, by its source, since swapping the backend is one of the
+ * few config changes that alters every pixel of every image. It is hashed the
+ * way a custom template is, with the same gap: source text cannot see a value
+ * the function closed over, so a rasteriser configured by something outside
+ * itself needs `--force`. For the default it adds nothing the package version
+ * was not already saying, which is why there is no special case for it.
  */
 export declare function configDigest(config: ResolvedConfig): Promise<string>;
 //# sourceMappingURL=config-digest.d.ts.map

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

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

package/dist/stamp/config-digest.js

@@ -42,6 +42,24 @@ async function backgroundDigest(background) {
  * `templates`: the one size and the one template an image actually uses go into
  * its own stamp, so adding a third size or an unrelated custom template does
  * not invalidate everything already on disk.
+ *
+ * `compressionLevel` is in even though it cannot change a pixel, which is the
+ * rule `onWarning` is left out under. What it changes is every byte of every
+ * file, and a project turning it up wants the images it already has rewritten:
+ * without this the setting would appear to do nothing until each post next
+ * changed, which is the sort of gap that gets reported as a bug.
+ *
+ * `format`, `quality` and `maxBytes` are in for the same reason, and `emitSvg`
+ * for a version of it: turning it on has to write the documents for images that
+ * are already on disk, and without this it would write them only for the posts
+ * that happened to change next.
+ *
+ * The rasteriser is in, by its source, since swapping the backend is one of the
+ * few config changes that alters every pixel of every image. It is hashed the
+ * way a custom template is, with the same gap: source text cannot see a value
+ * the function closed over, so a rasteriser configured by something outside
+ * itself needs `--force`. For the default it adds nothing the package version
+ * was not already saying, which is why there is no special case for it.
  */
 export async function configDigest(config) {
     const fonts = await Promise.all(config.fonts.map(async (font) => fontDigest(font)));
@@ -58,6 +76,12 @@ export async function configDigest(config) {
         footer: config.footer,
         badge: config.badge,
         code: config.code,
+        rasteriser: config.rasteriser.toString(),
+        compressionLevel: config.compressionLevel,
+        format: config.format,
+        quality: config.quality,
+        maxBytes: config.maxBytes,
+        emitSvg: config.emitSvg,
     }));
 }
 //# sourceMappingURL=config-digest.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"config-digest.js","sourceRoot":"","sources":["../../src/stamp/config-digest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAQ5C,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEtD;;;;;GAKG;AACH,KAAK,UAAU,cAAc;IAC3B,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAC7B,IAAI,GAAG,CAAC,oBAAoB,EAAE,OAAO,IAAI,CAAC,GAAG,CAAC,EAC9C,MAAM,CACP,CAAC;IACF,OAAQ,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAyB,CAAC,OAAO,CAAC;AAC/D,CAAC;AAED;;;GAGG;AACH,KAAK,UAAU,UAAU,CAAC,IAAgB;IACxC,MAAM,KAAK,GAAG,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACrE,OAAO,MAAM,CAAC,eAAe,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;AAChF,CAAC;AAED;;;;GAIG;AACH,KAAK,UAAU,WAAW,CAAC,MAAmB;IAC5C,OAAO,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;AAC9E,CAAC;AAED;;;GAGG;AACH,KAAK,UAAU,gBAAgB,CAAC,UAAsB;IACpD,OAAO,UAAU,CAAC,IAAI,KAAK,OAAO;QAChC,CAAC,CAAC,EAAE,GAAG,UAAU,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE;QACjE,CAAC,CAAC,UAAU,CAAC;AACjB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,MAAsB;IACvD,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,GAAG,CAC7B,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CACnD,CAAC;IACF,MAAM,IAAI,GACR,MAAM,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAEzE,OAAO,MAAM,CACX,eAAe,CAAC;QACd,OAAO,EAAE,MAAM,cAAc,EAAE;QAC/B,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,UAAU,EAAE,MAAM,gBAAgB,CAAC,MAAM,CAAC,UAAU,CAAC;QACrD,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,KAAK;QACL,IAAI;QACJ,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,IAAI,EAAE,MAAM,CAAC,IAAI;KAClB,CAAC,CACH,CAAC;AACJ,CAAC"}
+{"version":3,"file":"config-digest.js","sourceRoot":"","sources":["../../src/stamp/config-digest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAQ5C,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEtD;;;;;GAKG;AACH,KAAK,UAAU,cAAc;IAC3B,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAC7B,IAAI,GAAG,CAAC,oBAAoB,EAAE,OAAO,IAAI,CAAC,GAAG,CAAC,EAC9C,MAAM,CACP,CAAC;IACF,OAAQ,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAyB,CAAC,OAAO,CAAC;AAC/D,CAAC;AAED;;;GAGG;AACH,KAAK,UAAU,UAAU,CAAC,IAAgB;IACxC,MAAM,KAAK,GAAG,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACrE,OAAO,MAAM,CAAC,eAAe,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;AAChF,CAAC;AAED;;;;GAIG;AACH,KAAK,UAAU,WAAW,CAAC,MAAmB;IAC5C,OAAO,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;AAC9E,CAAC;AAED;;;GAGG;AACH,KAAK,UAAU,gBAAgB,CAAC,UAAsB;IACpD,OAAO,UAAU,CAAC,IAAI,KAAK,OAAO;QAChC,CAAC,CAAC,EAAE,GAAG,UAAU,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE;QACjE,CAAC,CAAC,UAAU,CAAC;AACjB,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,MAAsB;IACvD,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,GAAG,CAC7B,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CACnD,CAAC;IACF,MAAM,IAAI,GACR,MAAM,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAEzE,OAAO,MAAM,CACX,eAAe,CAAC;QACd,OAAO,EAAE,MAAM,cAAc,EAAE;QAC/B,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,UAAU,EAAE,MAAM,gBAAgB,CAAC,MAAM,CAAC,UAAU,CAAC;QACrD,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,KAAK;QACL,IAAI;QACJ,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE;QACxC,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;QACzC,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,OAAO,EAAE,MAAM,CAAC,OAAO;KACxB,CAAC,CACH,CAAC;AACJ,CAAC"}

package/dist/stamp/index.d.ts

@@ -1,6 +1,6 @@
 import type { MetaImageProps, OutputSize, ResolvedConfig } from "../types.js";
-export { stampPng } from "./chunk.js";
-export { readPngStamp } from "./read.js";
+export { stampImage } from "./write.js";
+export { readImageStamp } from "./read.js";
 /**
  * Computes stamps for the images rendered from one resolved config.
  */

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/stamp/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAI9E,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEzC;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB;;;;OAIG;IACH,KAAK,CAAC,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,UAAU,GAAG,MAAM,CAAC;CACxD;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,CAqC5E"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/stamp/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAI9E,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAE3C;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB;;;;OAIG;IACH,KAAK,CAAC,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,UAAU,GAAG,MAAM,CAAC;CACxD;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,CAqC5E"}

package/dist/stamp/index.js

@@ -1,7 +1,7 @@
 import { configDigest } from "./config-digest.js";
 import { sha256, stableStringify } from "./digest.js";
-export { stampPng } from "./chunk.js";
-export { readPngStamp } from "./read.js";
+export { stampImage } from "./write.js";
+export { readImageStamp } from "./read.js";
 /**
  * Build a {@link Stamper} for a resolved config. Asynchronous because it reads
  * the configured font files; do it once per run rather than once per image.

package/dist/stamp/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/stamp/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEtD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAczC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,MAAsB;IACxD,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,MAAM,CAAC,CAAC;IACxC,MAAM,eAAe,GAAG,IAAI,GAAG,EAAkB,CAAC;IAElD,4EAA4E;IAC5E,4EAA4E;IAC5E,4EAA4E;IAC5E,0EAA0E;IAC1E,8EAA8E;IAC9E,MAAM,cAAc,GAAG,CAAC,IAAY,EAAU,EAAE;QAC9C,MAAM,MAAM,GAAG,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAEzC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACxC,MAAM,MAAM,GACV,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;QACnE,eAAe,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAClC,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;IAEF,OAAO;QACL,KAAK,CAAC,KAAK,EAAE,IAAI;YACf,OAAO,MAAM,CACX,eAAe,CAAC;gBACd,IAAI;gBACJ,cAAc,CAAC,KAAK,CAAC,QAAQ,CAAC;gBAC9B,kEAAkE;gBAClE,kEAAkE;gBAClE,IAAI;gBACJ,KAAK;aACN,CAAC,CACH,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/stamp/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEtD,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAc3C;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,MAAsB;IACxD,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,MAAM,CAAC,CAAC;IACxC,MAAM,eAAe,GAAG,IAAI,GAAG,EAAkB,CAAC;IAElD,4EAA4E;IAC5E,4EAA4E;IAC5E,4EAA4E;IAC5E,0EAA0E;IAC1E,8EAA8E;IAC9E,MAAM,cAAc,GAAG,CAAC,IAAY,EAAU,EAAE;QAC9C,MAAM,MAAM,GAAG,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAEzC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACxC,MAAM,MAAM,GACV,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;QACnE,eAAe,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAClC,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;IAEF,OAAO;QACL,KAAK,CAAC,KAAK,EAAE,IAAI;YACf,OAAO,MAAM,CACX,eAAe,CAAC;gBACd,IAAI;gBACJ,cAAc,CAAC,KAAK,CAAC,QAAQ,CAAC;gBAC9B,kEAAkE;gBAClE,kEAAkE;gBAClE,IAAI;gBACJ,KAAK;aACN,CAAC,CACH,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/stamp/payload.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Keyword the stamp is stored under, in whichever container it goes into.
+ * Keeping the stamp in the image means there is no sidecar file to fall out of
+ * sync, and deleting an image deletes its stamp with it.
+ */
+export declare const stampKeyword = "colophon";
+/**
+ * What a carrier stores: `keyword\0text`.
+ *
+ * That is the shape of a PNG `tEXt` chunk, which is where the stamp started,
+ * and the other containers reuse it rather than each inventing one. The keyword
+ * is what tells Colophon's own note from somebody else's, and where a container
+ * has the stamp appended to it, it is also what finds it again.
+ */
+export declare function stampPayload(stamp: string): Buffer;
+/** The stamp in `payload`, or `undefined` where the note is somebody else's. */
+export declare function stampFromPayload(payload: Buffer): string | undefined;
+/**
+ * Where the payload starts in a window taken from the end of a file, or `-1`.
+ *
+ * Searched backwards because the stamp is the last thing an appending carrier
+ * writes, so the last match is Colophon's own and anything earlier is the same
+ * eight letters happening to turn up in compressed image data. The header in
+ * front of it is then checked, which is what turns a likely match into a
+ * certain one.
+ */
+export declare function findPayload(window: Buffer): number;
+//# sourceMappingURL=payload.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"payload.d.ts","sourceRoot":"","sources":["../../src/stamp/payload.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,YAAY,aAAa,CAAC;AAEvC;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMlD;AAED,gFAAgF;AAChF,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAOpE;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAElD"}

package/dist/stamp/payload.js

@@ -0,0 +1,42 @@
+/**
+ * Keyword the stamp is stored under, in whichever container it goes into.
+ * Keeping the stamp in the image means there is no sidecar file to fall out of
+ * sync, and deleting an image deletes its stamp with it.
+ */
+export const stampKeyword = "colophon";
+/**
+ * What a carrier stores: `keyword\0text`.
+ *
+ * That is the shape of a PNG `tEXt` chunk, which is where the stamp started,
+ * and the other containers reuse it rather than each inventing one. The keyword
+ * is what tells Colophon's own note from somebody else's, and where a container
+ * has the stamp appended to it, it is also what finds it again.
+ */
+export function stampPayload(stamp) {
+    return Buffer.concat([
+        Buffer.from(stampKeyword, "latin1"),
+        Buffer.from([0]),
+        Buffer.from(stamp, "latin1"),
+    ]);
+}
+/** The stamp in `payload`, or `undefined` where the note is somebody else's. */
+export function stampFromPayload(payload) {
+    const separator = payload.indexOf(0);
+    return separator !== -1 &&
+        payload.toString("latin1", 0, separator) === stampKeyword
+        ? payload.toString("latin1", separator + 1)
+        : undefined;
+}
+/**
+ * Where the payload starts in a window taken from the end of a file, or `-1`.
+ *
+ * Searched backwards because the stamp is the last thing an appending carrier
+ * writes, so the last match is Colophon's own and anything earlier is the same
+ * eight letters happening to turn up in compressed image data. The header in
+ * front of it is then checked, which is what turns a likely match into a
+ * certain one.
+ */
+export function findPayload(window) {
+    return window.lastIndexOf(Buffer.from(stampKeyword, "latin1"));
+}
+//# sourceMappingURL=payload.js.map

package/dist/stamp/payload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payload.js","sourceRoot":"","sources":["../../src/stamp/payload.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,UAAU,CAAC;AAEvC;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,MAAM,CAAC,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC;QACnC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QAChB,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC;KAC7B,CAAC,CAAC;AACL,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC9C,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAErC,OAAO,SAAS,KAAK,CAAC,CAAC;QACrB,OAAO,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,EAAE,SAAS,CAAC,KAAK,YAAY;QACzD,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,EAAE,SAAS,GAAG,CAAC,CAAC;QAC3C,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,WAAW,CAAC,MAAc;IACxC,OAAO,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC,CAAC;AACjE,CAAC"}

package/dist/stamp/read.d.ts

@@ -1,7 +1,8 @@
 /**
- * Read the stamp out of a PNG file. Returns `undefined` when the file is
- * missing, unreadable, not a PNG, or carries no stamp, all of which mean the
- * image cannot be shown to be up to date, so it should be rendered again.
+ * Read the stamp out of an image file. Returns `undefined` when the file is
+ * missing, unreadable, in a format no carrier knows, or carries no stamp, all
+ * of which mean the image cannot be shown to be up to date, so it should be
+ * rendered again.
  */
-export declare function readPngStamp(file: string): Promise<string | undefined>;
+export declare function readImageStamp(file: string): Promise<string | undefined>;
 //# sourceMappingURL=read.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../src/stamp/read.ts"],"names":[],"mappings":"AAqDA;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAgB5E"}
+{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../src/stamp/read.ts"],"names":[],"mappings":"AAwCA;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAc7B"}

package/dist/stamp/read.js

@@ -1,48 +1,33 @@
 import { open } from "node:fs/promises";
-import { pngSignature, stampKeyword } from "./chunk.js";
-/**
- * How much of a PNG to read when looking for a stamp. The stamp goes in
- * immediately after `IHDR`, so this only has to cover the header. Reading
- * whole images just to compare a hash would defeat the point of skipping them.
- */
-const headBytes = 4096;
-/**
- * Find the stamp in the leading bytes of a PNG, or `undefined` if there is
- * none, meaning the image was written by something else, or by a Colophon
- * that did not stamp yet.
- */
-function findStamp(head) {
-    if (!head.subarray(0, pngSignature.length).equals(pngSignature)) {
-        return undefined;
-    }
-    let offset = pngSignature.length;
-    while (offset + 8 <= head.length) {
-        const length = head.readUInt32BE(offset);
-        const type = head.toString("latin1", offset + 4, offset + 8);
-        const start = offset + 8;
-        const end = start + length;
-        // Image data starts here; anything past it is not worth reading for a hash.
-        if (type === "IDAT" || type === "IEND" || end > head.length) {
-            return undefined;
-        }
-        if (type === "tEXt") {
-            const data = head.subarray(start, end);
-            const separator = data.indexOf(0);
-            if (separator !== -1 &&
-                data.toString("latin1", 0, separator) === stampKeyword) {
-                return data.toString("latin1", separator + 1);
-            }
-        }
-        offset = end + 4;
+import { carrierFor } from "./carrier/index.js";
+import { stampWindow } from "./window.js";
+async function readAt(handle, position, length) {
+    const buffer = Buffer.alloc(length);
+    const { bytesRead } = await handle.read(buffer, 0, length, position);
+    return buffer.subarray(0, bytesRead);
+}
+/** The window a carrier reads from; for a short file that is the whole of it. */
+async function windowFor(carrier, handle, head) {
+    if (carrier.end === "head" || head.length < stampWindow) {
+        return head;
     }
-    return undefined;
+    const { size } = await handle.stat();
+    return readAt(handle, size - stampWindow, stampWindow);
+}
+async function stampIn(handle) {
+    const head = await readAt(handle, 0, stampWindow);
+    const carrier = carrierFor(head);
+    return carrier === undefined
+        ? undefined
+        : carrier.read(await windowFor(carrier, handle, head));
 }
 /**
- * Read the stamp out of a PNG file. Returns `undefined` when the file is
- * missing, unreadable, not a PNG, or carries no stamp, all of which mean the
- * image cannot be shown to be up to date, so it should be rendered again.
+ * Read the stamp out of an image file. Returns `undefined` when the file is
+ * missing, unreadable, in a format no carrier knows, or carries no stamp, all
+ * of which mean the image cannot be shown to be up to date, so it should be
+ * rendered again.
  */
-export async function readPngStamp(file) {
+export async function readImageStamp(file) {
     let handle;
     try {
         handle = await open(file, "r");
@@ -51,9 +36,7 @@ export async function readPngStamp(file) {
         return undefined;
     }
     try {
-        const buffer = Buffer.alloc(headBytes);
-        const { bytesRead } = await handle.read(buffer, 0, headBytes, 0);
-        return findStamp(buffer.subarray(0, bytesRead));
+        return await stampIn(handle);
     }
     finally {
         await handle.close();

package/dist/stamp/read.js.map

@@ -1 +1 @@
-{"version":3,"file":"read.js","sourceRoot":"","sources":["../../src/stamp/read.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAExC,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAExD;;;;GAIG;AACH,MAAM,SAAS,GAAG,IAAI,CAAC;AAEvB;;;;GAIG;AACH,SAAS,SAAS,CAAC,IAAY;IAC7B,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC;QAChE,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC;IAEjC,OAAO,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QACjC,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;QACzC,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,CAAC;QAC7D,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,CAAC;QACzB,MAAM,GAAG,GAAG,KAAK,GAAG,MAAM,CAAC;QAE3B,4EAA4E;QAC5E,IAAI,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,MAAM,IAAI,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;YAC5D,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;YACpB,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;YACvC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YAElC,IACE,SAAS,KAAK,CAAC,CAAC;gBAChB,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,EAAE,SAAS,CAAC,KAAK,YAAY,EACtD,CAAC;gBACD,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,SAAS,GAAG,CAAC,CAAC,CAAC;YAChD,CAAC;QACH,CAAC;QAED,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC;IACnB,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAY;IAC7C,IAAI,MAAkB,CAAC;IAEvB,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACjC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QACvC,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC;QACjE,OAAO,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC;IAClD,CAAC;YAAS,CAAC;QACT,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;AACH,CAAC"}
+{"version":3,"file":"read.js","sourceRoot":"","sources":["../../src/stamp/read.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAGxC,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,KAAK,UAAU,MAAM,CACnB,MAAkB,EAClB,QAAgB,EAChB,MAAc;IAEd,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACpC,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;IACrE,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;AACvC,CAAC;AAED,iFAAiF;AACjF,KAAK,UAAU,SAAS,CACtB,OAAqB,EACrB,MAAkB,EAClB,IAAY;IAEZ,IAAI,OAAO,CAAC,GAAG,KAAK,MAAM,IAAI,IAAI,CAAC,MAAM,GAAG,WAAW,EAAE,CAAC;QACxD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;IACrC,OAAO,MAAM,CAAC,MAAM,EAAE,IAAI,GAAG,WAAW,EAAE,WAAW,CAAC,CAAC;AACzD,CAAC;AAED,KAAK,UAAU,OAAO,CAAC,MAAkB;IACvC,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,WAAW,CAAC,CAAC;IAClD,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IAEjC,OAAO,OAAO,KAAK,SAAS;QAC1B,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,IAAY;IAEZ,IAAI,MAAkB,CAAC;IAEvB,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACjC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,CAAC;QACH,OAAO,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/B,CAAC;YAAS,CAAC;QACT,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;AACH,CAAC"}

package/dist/stamp/window.d.ts

@@ -0,0 +1,11 @@
+/**
+ * How close to one end of a file a stamp has to sit.
+ *
+ * A build reads this much and stops, at the front for a carrier that writes
+ * near the header and at the back for one that appends, so deciding to skip an
+ * image never means reading the whole of it. Both halves need the number: the
+ * reader to know how much to take, and a carrier that chooses where to write to
+ * keep inside it.
+ */
+export declare const stampWindow = 4096;
+//# sourceMappingURL=window.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"window.d.ts","sourceRoot":"","sources":["../../src/stamp/window.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,eAAO,MAAM,WAAW,OAAO,CAAC"}

package/dist/stamp/window.js

@@ -0,0 +1,11 @@
+/**
+ * How close to one end of a file a stamp has to sit.
+ *
+ * A build reads this much and stops, at the front for a carrier that writes
+ * near the header and at the back for one that appends, so deciding to skip an
+ * image never means reading the whole of it. Both halves need the number: the
+ * reader to know how much to take, and a carrier that chooses where to write to
+ * keep inside it.
+ */
+export const stampWindow = 4096;
+//# sourceMappingURL=window.js.map

package/dist/stamp/window.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"window.js","sourceRoot":"","sources":["../../src/stamp/window.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,CAAC"}

package/dist/stamp/write.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Return `image` with `stamp` embedded, so that the build after this one can
+ * read it back and leave the file alone.
+ *
+ * The stamp goes inside the image rather than into a file beside it, which is
+ * what keeps the two from parting company: an image carries its stamp when it
+ * is copied, and loses it when it is deleted or rewritten by something else,
+ * both of which are the answer a build wants.
+ *
+ * Nothing about the picture changes. A PNG gains a `tEXt` chunk and a JPEG a
+ * `COM` segment, both among the metadata before the image data; a WebP gains a
+ * chunk and an AVIF a `uuid` box, both on the end, since those two locate their
+ * picture by an offset that inserting bytes earlier would move.
+ *
+ * A format none of the carriers knows throws rather than being written
+ * unstamped, because an image no build can ever skip is a worse thing to hand
+ * back quietly than an error naming what went wrong. Reachable only through a
+ * configured rasteriser, since resvg writes PNG and nothing else.
+ */
+export declare function stampImage(image: Buffer, stamp: string): Buffer;
+//# sourceMappingURL=write.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"write.d.ts","sourceRoot":"","sources":["../../src/stamp/write.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAY/D"}

package/dist/stamp/write.js

@@ -0,0 +1,31 @@
+import { carrierFor, carrierFormats } from "./carrier/index.js";
+import { stampPayload } from "./payload.js";
+/**
+ * Return `image` with `stamp` embedded, so that the build after this one can
+ * read it back and leave the file alone.
+ *
+ * The stamp goes inside the image rather than into a file beside it, which is
+ * what keeps the two from parting company: an image carries its stamp when it
+ * is copied, and loses it when it is deleted or rewritten by something else,
+ * both of which are the answer a build wants.
+ *
+ * Nothing about the picture changes. A PNG gains a `tEXt` chunk and a JPEG a
+ * `COM` segment, both among the metadata before the image data; a WebP gains a
+ * chunk and an AVIF a `uuid` box, both on the end, since those two locate their
+ * picture by an offset that inserting bytes earlier would move.
+ *
+ * A format none of the carriers knows throws rather than being written
+ * unstamped, because an image no build can ever skip is a worse thing to hand
+ * back quietly than an error naming what went wrong. Reachable only through a
+ * configured rasteriser, since resvg writes PNG and nothing else.
+ */
+export function stampImage(image, stamp) {
+    const carrier = carrierFor(image);
+    if (carrier === undefined) {
+        throw new Error("Cannot stamp: unrecognised image format. The rebuild stamp goes inside" +
+            " the image, so a rasteriser has to produce one of" +
+            ` ${carrierFormats()} for a build to be able to skip it.`);
+    }
+    return carrier.write(image, stampPayload(stamp));
+}
+//# sourceMappingURL=write.js.map

package/dist/stamp/write.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write.js","sourceRoot":"","sources":["../../src/stamp/write.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,UAAU,CAAC,KAAa,EAAE,KAAa;IACrD,MAAM,OAAO,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;IAElC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CACb,wEAAwE;YACtE,mDAAmD;YACnD,IAAI,cAAc,EAAE,qCAAqC,CAC5D,CAAC;IACJ,CAAC;IAED,OAAO,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;AACnD,CAAC"}

package/dist/templates/article/bottom.d.ts

@@ -0,0 +1,15 @@
+import type { ImageAsset, MeasureText, ResolvedConfig } from "../../types.js";
+import type { Frame } from "../frame.js";
+/**
+ * The bottom line: who wrote the post at the left, whose site it is at the
+ * right.
+ *
+ * The two are measured against each other rather than drawn and hoped for. A
+ * byline is a person's name and a date, a footer is a domain, and both are as
+ * long as they are, so on a landscape image they meet in the middle and
+ * overlap. The site's footer keeps its room, since it is the same on every
+ * image and a build can be sure it fits, and the byline takes what is left and
+ * is cut to it.
+ */
+export declare function articleBottom(said: readonly string[], config: ResolvedConfig, frame: Frame, imageWidth: number, avatar: ImageAsset | undefined, measure: MeasureText): string;
+//# sourceMappingURL=bottom.d.ts.map

package/dist/templates/article/bottom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bottom.d.ts","sourceRoot":"","sources":["../../../src/templates/article/bottom.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAG9E,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAyBzC;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,MAAM,EAAE,cAAc,EACtB,KAAK,EAAE,KAAK,EACZ,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,UAAU,GAAG,SAAS,EAC9B,OAAO,EAAE,WAAW,GACnB,MAAM,CA+CR"}