@kensio/colophon 2.3.0 → 2.4.0

package/dist/measure/faces.js

@@ -0,0 +1,70 @@
+import { create, open } from "fontkit";
+/**
+ * Parsed faces, keyed by the font file's path. A build renders many images
+ * from one config, so without this every image would parse every font again.
+ */
+const byPath = new Map();
+/**
+ * The same for fonts supplied as bytes, keyed by the array itself. A config
+ * holds one of these and hands it to every render, so identity is enough here
+ * and hashing the bytes would cost more than the parse it saves.
+ */
+const byData = new WeakMap();
+/**
+ * What a face declares about itself. The types say both of these are always
+ * there, and a font file is data: one missing its name or its `OS/2` table
+ * would otherwise take the build down inside `selectFace`, rather than being
+ * measured as well as it can be. A face with no family name matches no stack,
+ * so it is only ever reached as the fallback that the first configured font is.
+ */
+function toFace(font) {
+    const declared = font;
+    return {
+        family: declared.familyName ?? "",
+        weight: declared["OS/2"]?.usWeightClass ?? 400,
+        font,
+    };
+}
+/** A collection file holds several faces; a plain font file holds one. */
+function facesOf(loaded) {
+    return "fonts" in loaded
+        ? loaded.fonts.map((font) => toFace(font))
+        : [toFace(loaded)];
+}
+/**
+ * Parse one configured font for measurement, or report that it could not be.
+ *
+ * A file the rasteriser accepts and this cannot is rare, but it is not fatal:
+ * the image still renders, and its text is laid out from estimates instead. It
+ * is worth saying so, because wrapping that is quietly approximate is exactly
+ * what supplying a font file was meant to stop. The warning goes through the
+ * cache below, so a build says it once per file rather than once per image.
+ */
+async function load(font, onWarning) {
+    try {
+        return facesOf("data" in font ? create(Buffer.from(font.data)) : await open(font.path));
+    }
+    catch (error) {
+        const name = "data" in font ? (font.family ?? "font data") : font.path;
+        const reason = error instanceof Error ? error.message : String(error);
+        onWarning(`could not read ${name} for text measurement, so text drawn in it is` +
+            ` wrapped from estimates instead: ${reason}`);
+        return [];
+    }
+}
+function cached(font, onWarning) {
+    if ("data" in font) {
+        const pending = byData.get(font.data) ?? load(font, onWarning);
+        byData.set(font.data, pending);
+        return pending;
+    }
+    const pending = byPath.get(font.path) ?? load(font, onWarning);
+    byPath.set(font.path, pending);
+    return pending;
+}
+/** Every face the configured fonts hold, in the order they were configured. */
+export async function loadFaces(fonts, onWarning) {
+    const loaded = await Promise.all(fonts.map(async (font) => cached(font, onWarning)));
+    return loaded.flat();
+}
+//# sourceMappingURL=faces.js.map

package/dist/measure/faces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"faces.js","sourceRoot":"","sources":["../../src/measure/faces.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAevC;;;GAGG;AACH,MAAM,MAAM,GAAG,IAAI,GAAG,EAAoC,CAAC;AAE3D;;;;GAIG;AACH,MAAM,MAAM,GAAG,IAAI,OAAO,EAAwC,CAAC;AAEnE;;;;;;GAMG;AACH,SAAS,MAAM,CAAC,IAAU;IACxB,MAAM,QAAQ,GAAG,IAKhB,CAAC;IAEF,OAAO;QACL,MAAM,EAAE,QAAQ,CAAC,UAAU,IAAI,EAAE;QACjC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,aAAa,IAAI,GAAG;QAC9C,IAAI;KACL,CAAC;AACJ,CAAC;AAED,0EAA0E;AAC1E,SAAS,OAAO,CAAC,MAAyC;IACxD,OAAO,OAAO,IAAI,MAAM;QACtB,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC1C,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;AACvB,CAAC;AAED;;;;;;;;GAQG;AACH,KAAK,UAAU,IAAI,CACjB,IAAgB,EAChB,SAAyB;IAEzB,IAAI,CAAC;QACH,OAAO,OAAO,CACZ,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CACxE,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,GAAG,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,IAAI,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QACvE,MAAM,MAAM,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACtE,SAAS,CACP,kBAAkB,IAAI,+CAA+C;YACnE,oCAAoC,MAAM,EAAE,CAC/C,CAAC;QACF,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,SAAS,MAAM,CACb,IAAgB,EAChB,SAAyB;IAEzB,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;QACnB,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QAC/D,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC/B,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAC/D,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC/B,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,+EAA+E;AAC/E,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,KAA4B,EAC5B,SAAyB;IAEzB,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAC9B,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CACnD,CAAC;IAEF,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;AACvB,CAAC"}

package/dist/measure/index.d.ts

@@ -0,0 +1,16 @@
+import type { MeasureText, ResolvedConfig } from "../types.js";
+export type { Face } from "./faces.js";
+/**
+ * A {@link MeasureText} for the fonts a build is rendering with.
+ *
+ * Widths are held per em and multiplied by the font size on the way out, which
+ * is what makes fitting text affordable: choosing a size means wrapping the
+ * same words several times over, and only the last multiplication differs.
+ * Text is unhinted at these sizes, so the scaling is exact rather than close.
+ *
+ * The cache lives for as long as the measurer, which is one image. Titles
+ * repeat across the sizes of an image and rarely between images, so a longer
+ * life would hold a build's worth of strings to save very little.
+ */
+export declare function createMeasurer(config: ResolvedConfig): Promise<MeasureText>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/measure/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAa,MAAM,aAAa,CAAC;AAO1E,YAAY,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AA8CvC;;;;;;;;;;;GAWG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,cAAc,GACrB,OAAO,CAAC,WAAW,CAAC,CAgBtB"}

package/dist/measure/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/measure/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE9C,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAIzC;;;;;;;;GAQG;AACH,SAAS,OAAO,CACd,KAAsB,EACtB,KAAgB,EAChB,cAAuB;IAEvB,MAAM,MAAM,GAAG,KAAK,CAAC,UAAU,IAAI,GAAG,CAAC;IAEvC,OAAO,CACL,UAAU,CAAC,KAAK,EAAE,KAAK,CAAC,UAAU,EAAE,MAAM,CAAC;QAC3C,CAAC,cAAc,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CACxC,CAAC;AACJ,CAAC;AAED,gEAAgE;AAChE,SAAS,SAAS,CAChB,IAAY,EACZ,KAAgB,EAChB,KAAsB,EACtB,cAAuB;IAEvB,MAAM,MAAM,GAAG,KAAK,CAAC,UAAU,IAAI,GAAG,CAAC;IACvC,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC;IAEtD,IAAI,GAAG,GAAG,CAAC,CAAC;IAEZ,KAAK,MAAM,GAAG,IAAI,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC;QACrD,GAAG;YACD,GAAG,CAAC,IAAI,KAAK,SAAS;gBACpB,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,aAAa,CAAC;gBACzD,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,MAAsB;IAEtB,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;IAC9D,MAAM,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAC;IAExC,OAAO,CAAC,IAAY,EAAE,KAAgB,EAAU,EAAE;QAChD,MAAM,GAAG,GAAG,GAAG,KAAK,CAAC,UAAU,IAAI,MAAM,CAAC,KAAK,CAAC,UAAU,IAAI,GAAG,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,aAAa,IAAI,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC;QAClH,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAE7B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,OAAO,KAAK,GAAG,KAAK,CAAC,QAAQ,CAAC;QAChC,CAAC;QAED,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;QAC9D,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QACpB,OAAO,GAAG,GAAG,KAAK,CAAC,QAAQ,CAAC;IAC9B,CAAC,CAAC;AACJ,CAAC"}

package/dist/measure/runs.d.ts

@@ -0,0 +1,17 @@
+import type { Face } from "./faces.js";
+/**
+ * A stretch of text and the face that will draw it, or no face where nothing
+ * loaded covers it and the width has to be estimated.
+ */
+export interface TextRun {
+    readonly text: string;
+    readonly face: Face | undefined;
+}
+/** Advance width of `text` in `face`, as a multiple of the font size. */
+export declare function emWidth(text: string, face: Face): number;
+/**
+ * Split `text` into the longest runs that one face can draw. Text a build has
+ * supplied fonts for comes back as a single run, which is the common case.
+ */
+export declare function coverageRuns(text: string, primary: Face | undefined, faces: readonly Face[]): readonly TextRun[];
+//# sourceMappingURL=runs.d.ts.map

package/dist/measure/runs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runs.d.ts","sourceRoot":"","sources":["../../src/measure/runs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC;;;GAGG;AACH,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,SAAS,CAAC;CACjC;AAED,yEAAyE;AACzE,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,MAAM,CAExD;AA0BD;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,IAAI,GAAG,SAAS,EACzB,KAAK,EAAE,SAAS,IAAI,EAAE,GACrB,SAAS,OAAO,EAAE,CAepB"}

package/dist/measure/runs.js

@@ -0,0 +1,39 @@
+/** Advance width of `text` in `face`, as a multiple of the font size. */
+export function emWidth(text, face) {
+    return face.font.layout(text).advanceWidth / face.font.unitsPerEm;
+}
+/**
+ * The face that will draw one character: the one the style resolved to, or the
+ * first other loaded face holding a glyph for it. This is what the rasteriser
+ * does with a missing glyph, and measuring a Japanese title against a Latin
+ * face that has none of it would be worse than not measuring at all.
+ */
+function coveringFace(character, primary, faces) {
+    const point = character.codePointAt(0);
+    if (point === undefined) {
+        return primary;
+    }
+    if (primary?.font.hasGlyphForCodePoint(point) === true) {
+        return primary;
+    }
+    return faces.find((face) => face.font.hasGlyphForCodePoint(point));
+}
+/**
+ * Split `text` into the longest runs that one face can draw. Text a build has
+ * supplied fonts for comes back as a single run, which is the common case.
+ */
+export function coverageRuns(text, primary, faces) {
+    const runs = [];
+    for (const character of text) {
+        const face = coveringFace(character, primary, faces);
+        const last = runs.at(-1);
+        if (last === undefined || last.face !== face) {
+            runs.push({ text: character, face });
+        }
+        else {
+            runs[runs.length - 1] = { text: last.text + character, face };
+        }
+    }
+    return runs;
+}
+//# sourceMappingURL=runs.js.map

package/dist/measure/runs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runs.js","sourceRoot":"","sources":["../../src/measure/runs.ts"],"names":[],"mappings":"AAWA,yEAAyE;AACzE,MAAM,UAAU,OAAO,CAAC,IAAY,EAAE,IAAU;IAC9C,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC;AACpE,CAAC;AAED;;;;;GAKG;AACH,SAAS,YAAY,CACnB,SAAiB,EACjB,OAAyB,EACzB,KAAsB;IAEtB,MAAM,KAAK,GAAG,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IAEvC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,IAAI,OAAO,EAAE,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC;QACvD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC,CAAC;AACrE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAC1B,IAAY,EACZ,OAAyB,EACzB,KAAsB;IAEtB,MAAM,IAAI,GAAc,EAAE,CAAC;IAE3B,KAAK,MAAM,SAAS,IAAI,IAAI,EAAE,CAAC;QAC7B,MAAM,IAAI,GAAG,YAAY,CAAC,SAAS,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;QACrD,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAEzB,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;YAC7C,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACvC,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,GAAG,SAAS,EAAE,IAAI,EAAE,CAAC;QAChE,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/measure/select.d.ts

@@ -0,0 +1,13 @@
+import type { Face } from "./faces.js";
+/**
+ * The families named by a CSS-style stack, in order and unquoted, so that
+ * `'"JetBrains Mono", Menlo, monospace'` becomes three names to try.
+ */
+export declare function familyNames(stack: string): readonly string[];
+/**
+ * The face a style resolves to, or `undefined` when the stack names nothing
+ * that was loaded. Families are tried in the order the stack lists them, which
+ * is what a stack means.
+ */
+export declare function selectFace(faces: readonly Face[], stack: string, weight: number): Face | undefined;
+//# sourceMappingURL=select.d.ts.map

package/dist/measure/select.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"select.d.ts","sourceRoot":"","sources":["../../src/measure/select.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAU5D;AA4BD;;;;GAIG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,SAAS,IAAI,EAAE,EACtB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,IAAI,GAAG,SAAS,CAUlB"}

package/dist/measure/select.js

@@ -0,0 +1,47 @@
+/**
+ * The families named by a CSS-style stack, in order and unquoted, so that
+ * `'"JetBrains Mono", Menlo, monospace'` becomes three names to try.
+ */
+export function familyNames(stack) {
+    return stack
+        .split(",")
+        .map((name) => name
+        .trim()
+        .replaceAll(/^["']|["']$/g, "")
+        .trim())
+        .filter((name) => name !== "");
+}
+/** Faces belonging to one family, matched as the rasteriser matches them. */
+function inFamily(faces, family) {
+    const wanted = family.toLowerCase();
+    return faces.filter((face) => face.family.toLowerCase() === wanted);
+}
+/**
+ * The face nearest the requested weight. A family supplying only a regular cut
+ * is drawn in that cut by the rasteriser rather than being emboldened, so
+ * measuring the nearest weight is measuring what will actually appear.
+ */
+function nearestWeight(faces, weight) {
+    let best = faces[0];
+    for (const face of faces) {
+        if (Math.abs(face.weight - weight) < Math.abs(best.weight - weight)) {
+            best = face;
+        }
+    }
+    return best;
+}
+/**
+ * The face a style resolves to, or `undefined` when the stack names nothing
+ * that was loaded. Families are tried in the order the stack lists them, which
+ * is what a stack means.
+ */
+export function selectFace(faces, stack, weight) {
+    for (const family of familyNames(stack)) {
+        const [first, ...rest] = inFamily(faces, family);
+        if (first !== undefined) {
+            return nearestWeight([first, ...rest], weight);
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=select.js.map

package/dist/measure/select.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"select.js","sourceRoot":"","sources":["../../src/measure/select.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,OAAO,KAAK;SACT,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CACZ,IAAI;SACD,IAAI,EAAE;SACN,UAAU,CAAC,cAAc,EAAE,EAAE,CAAC;SAC9B,IAAI,EAAE,CACV;SACA,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC;AACnC,CAAC;AAED,6EAA6E;AAC7E,SAAS,QAAQ,CAAC,KAAsB,EAAE,MAAc;IACtD,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;IACpC,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,KAAK,MAAM,CAAC,CAAC;AACtE,CAAC;AAED;;;;GAIG;AACH,SAAS,aAAa,CACpB,KAAiC,EACjC,MAAc;IAEd,IAAI,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IAEpB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;YACpE,IAAI,GAAG,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,UAAU,CACxB,KAAsB,EACtB,KAAa,EACb,MAAc;IAEd,KAAK,MAAM,MAAM,IAAI,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;QACxC,MAAM,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,GAAG,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAEjD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,OAAO,aAAa,CAAC,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;QACjD,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/meta/tags.d.ts

@@ -3,14 +3,14 @@ import type { Manifest, MetaTag, MetaTagOptions } from "../types.js";
  * The social meta tags for one page of a {@link Manifest}.
  *
  * Generating the image is half the job: a site still has to write the tags,
- * and every site ends up with slightly different results — a missing width, a
- * relative URL a crawler cannot resolve, a large card promising an image that
- * is square.
+ * and every site ends up with slightly different results: a missing width, a
+ * relative URL a crawler cannot resolve, or a large card promising an image
+ * that is square.
  *
  * A page the manifest does not have gets no tags rather than an error. Not
- * every page has a share image — a props mapper returning `undefined` is how a
- * site says so — and a template asking about one should not have to know in
- * advance.
+ * every page has a share image, and a props mapper returning `undefined` is
+ * how a site says so, so a template asking about one should not have to know
+ * in advance.
  *
  * Alt text is emitted for both platforms when the page has any. Twitter reads
  * its own `twitter:image:alt` rather than falling back to the Open Graph one,

package/dist/meta/tags.js

@@ -30,14 +30,14 @@ function imageUrl(slug, image, options) {
  * The social meta tags for one page of a {@link Manifest}.
  *
  * Generating the image is half the job: a site still has to write the tags,
- * and every site ends up with slightly different results — a missing width, a
- * relative URL a crawler cannot resolve, a large card promising an image that
- * is square.
+ * and every site ends up with slightly different results: a missing width, a
+ * relative URL a crawler cannot resolve, or a large card promising an image
+ * that is square.
  *
  * A page the manifest does not have gets no tags rather than an error. Not
- * every page has a share image — a props mapper returning `undefined` is how a
- * site says so — and a template asking about one should not have to know in
- * advance.
+ * every page has a share image, and a props mapper returning `undefined` is
+ * how a site says so, so a template asking about one should not have to know
+ * in advance.
  *
  * Alt text is emitted for both platforms when the page has any. Twitter reads
  * its own `twitter:image:alt` rather than falling back to the Open Graph one,

package/dist/meta/url.d.ts

@@ -6,10 +6,10 @@
  * the placement's `urlBase` said, which is usually site-relative, so this is
  * where the two halves meet.
  *
- * A URL that names its own scheme is returned untouched — a placement pointing
- * at a CDN has said everything there is to say. A scheme-relative one (`//cdn`)
- * has not: it is relative to the page's scheme, which is exactly what a crawler
- * reading the tag elsewhere does not have, so it borrows the base's.
+ * A URL that names its own scheme is returned untouched, since a placement
+ * pointing at a CDN has said everything there is to say. A scheme-relative one
+ * (`//cdn`) has not: it is relative to the page's scheme, which is exactly what
+ * a crawler reading the tag elsewhere does not have, so it borrows the base's.
  */
 export declare function absoluteUrl(url: string, baseUrl: string | undefined): string;
 //# sourceMappingURL=url.d.ts.map

package/dist/meta/url.js

@@ -15,10 +15,10 @@ function schemeOf(url) {
  * the placement's `urlBase` said, which is usually site-relative, so this is
  * where the two halves meet.
  *
- * A URL that names its own scheme is returned untouched — a placement pointing
- * at a CDN has said everything there is to say. A scheme-relative one (`//cdn`)
- * has not: it is relative to the page's scheme, which is exactly what a crawler
- * reading the tag elsewhere does not have, so it borrows the base's.
+ * A URL that names its own scheme is returned untouched, since a placement
+ * pointing at a CDN has said everything there is to say. A scheme-relative one
+ * (`//cdn`) has not: it is relative to the page's scheme, which is exactly what
+ * a crawler reading the tag elsewhere does not have, so it borrows the base's.
  */
 export function absoluteUrl(url, baseUrl) {
     if (baseUrl === undefined || schemed.test(url)) {

package/dist/placement/check.d.ts

@@ -6,7 +6,7 @@ import type { Placement } from "../types.js";
  * JavaScript with nothing checking it, and none of these omissions fails
  * anywhere near the config: a missing `dir` surfaces as a complaint about an
  * argument to `path`, and the rest as something not being a function. Key
- * validation is no help either — it is the option that is not there.
+ * validation is no help either, since it is the option that is not there.
  *
  * This sits here rather than in `validate/`, which checks keys and the names
  * of closed sets, for the reason `fonts/resolve.ts` does: what a value has to

package/dist/placement/check.js

@@ -5,7 +5,7 @@
  * JavaScript with nothing checking it, and none of these omissions fails
  * anywhere near the config: a missing `dir` surfaces as a complaint about an
  * argument to `path`, and the rest as something not being a function. Key
- * validation is no help either — it is the option that is not there.
+ * validation is no help either, since it is the option that is not there.
  *
  * This sits here rather than in `validate/`, which checks keys and the names
  * of closed sets, for the reason `fonts/resolve.ts` does: what a value has to

package/dist/placement/index.js

@@ -5,7 +5,7 @@ export { besideContent, imageName } from "./relative.js";
 /**
  * Prefix a `urlBase` onto an image's path under the root that placed it.
  *
- * No base, no URL: a directory on disk does not say how — or whether — it is
+ * No base, no URL: a directory on disk does not say how, or whether, it is
  * served, and a URL Colophon invented would be worse than the gap it fills,
  * since the whole point of writing one down is that a site can trust it.
  */

package/dist/placement/relative.d.ts

@@ -5,9 +5,9 @@ import type { ContentFile, OutputSize } from "../types.js";
  * carries the post's keywords, and the size name keeps every image of a post
  * distinct (`my-post-og.png`, `my-post-square.png`).
  *
- * A slug carrying directories of its own — what the `route` strategy produces,
- * and what a frontmatter `slug` of `docs/intro` means — puts them in the name,
- * so the image's path mirrors the route wherever it is placed.
+ * A slug carrying directories of its own puts them in the name, so the image's
+ * path mirrors the route wherever it is placed. That is what the `route`
+ * strategy produces, and what a frontmatter `slug` of `docs/intro` means.
  *
  * The digest is the image's rebuild stamp: the props, the config and the size
  * it is drawn from. Hashing the rendered bytes would be a truer name, but they

package/dist/placement/relative.js

@@ -13,9 +13,9 @@ const hashLength = 8;
  * carries the post's keywords, and the size name keeps every image of a post
  * distinct (`my-post-og.png`, `my-post-square.png`).
  *
- * A slug carrying directories of its own — what the `route` strategy produces,
- * and what a frontmatter `slug` of `docs/intro` means — puts them in the name,
- * so the image's path mirrors the route wherever it is placed.
+ * A slug carrying directories of its own puts them in the name, so the image's
+ * path mirrors the route wherever it is placed. That is what the `route`
+ * strategy produces, and what a frontmatter `slug` of `docs/intro` means.
  *
  * The digest is the image's rebuild stamp: the props, the config and the size
  * it is drawn from. Hashing the rendered bytes would be a truer name, but they

package/dist/pool.d.ts

@@ -9,8 +9,8 @@
  * flight stays bounded however large the input is.
  *
  * The first rejection propagates, as it would from `Promise.all`. Items
- * already in flight run to completion — there is no cancelling a render — but
- * no further ones are started.
+ * already in flight run to completion, since there is no cancelling a render,
+ * but no further ones are started.
  *
  * Throws if `limit` is not a positive integer.
  */

package/dist/pool.js

@@ -9,14 +9,14 @@
  * flight stays bounded however large the input is.
  *
  * The first rejection propagates, as it would from `Promise.all`. Items
- * already in flight run to completion — there is no cancelling a render — but
- * no further ones are started.
+ * already in flight run to completion, since there is no cancelling a render,
+ * but no further ones are started.
  *
  * Throws if `limit` is not a positive integer.
  */
 export async function mapConcurrent(items, limit, worker) {
     // A limit below one starts no workers at all, and an empty `Promise.all`
-    // resolves happily — so the caller would get an empty result back as though
+    // resolves happily, so the caller would get an empty result back as though
     // there had been nothing to do. A build reporting success having rendered
     // nothing is the failure worth being loud about.
     if (!Number.isSafeInteger(limit) || limit < 1) {

package/dist/pool.js.map

@@ -1 +1 @@
-{"version":3,"file":"pool.js","sourceRoot":"","sources":["../src/pool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,KAAsB,EACtB,KAAa,EACb,MAAsD;IAEtD,yEAAyE;IACzE,4EAA4E;IAC5E,0EAA0E;IAC1E,iDAAiD;IACjD,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QAC9C,MAAM,IAAI,KAAK,CACb,6BAA6B,MAAM,CAAC,KAAK,CAAC,gCAAgC,CAC3E,CAAC;IACJ,CAAC;IAED,4EAA4E;IAC5E,kCAAkC;IAClC,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,6EAA6E;IAC7E,4EAA4E;IAC5E,YAAY;IACZ,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC;IAC9B,IAAI,SAAS,GAAG,KAAK,CAAC;IAEtB,KAAK,UAAU,GAAG;QAChB,KAAK,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,KAAK,EAAE,CAAC;YAClC,IAAI,SAAS,EAAE,CAAC;gBACd,OAAO;YACT,CAAC;YACD,wEAAwE;YACxE,oEAAoE;YACpE,4CAA4C;YAC5C,OAAO,CAAC,KAAK,CAAC,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,EAAE,CACzE,GAAG,EAAE,CACN,CAAC;IAEF,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,yEAAyE;QACzE,qEAAqE;QACrE,SAAS,GAAG,IAAI,CAAC;QACjB,MAAM,KAAK,CAAC;IACd,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}
+{"version":3,"file":"pool.js","sourceRoot":"","sources":["../src/pool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,KAAsB,EACtB,KAAa,EACb,MAAsD;IAEtD,yEAAyE;IACzE,2EAA2E;IAC3E,0EAA0E;IAC1E,iDAAiD;IACjD,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QAC9C,MAAM,IAAI,KAAK,CACb,6BAA6B,MAAM,CAAC,KAAK,CAAC,gCAAgC,CAC3E,CAAC;IACJ,CAAC;IAED,4EAA4E;IAC5E,kCAAkC;IAClC,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,6EAA6E;IAC7E,4EAA4E;IAC5E,YAAY;IACZ,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC;IAC9B,IAAI,SAAS,GAAG,KAAK,CAAC;IAEtB,KAAK,UAAU,GAAG;QAChB,KAAK,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,KAAK,EAAE,CAAC;YAClC,IAAI,SAAS,EAAE,CAAC;gBACd,OAAO;YACT,CAAC;YACD,wEAAwE;YACxE,oEAAoE;YACpE,4CAA4C;YAC5C,OAAO,CAAC,KAAK,CAAC,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,EAAE,CACzE,GAAG,EAAE,CACN,CAAC;IAEF,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,yEAAyE;QACzE,qEAAqE;QACrE,SAAS,GAAG,IAAI,CAAC;QACjB,MAAM,KAAK,CAAC;IACd,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/props.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Read a prop as a string, coercing the scalar types YAML frontmatter yields
+ * (numbers, booleans) and returning `undefined` for anything else, since
+ * templates treat "not a usable string" and "absent" the same way.
+ */
+export declare function optionalString(value: unknown): string | undefined;
+//# sourceMappingURL=props.d.ts.map

package/dist/props.d.ts.map

@@ -0,0 +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"}

package/dist/props.js

@@ -0,0 +1,17 @@
+/**
+ * Read a prop as a string, coercing the scalar types YAML frontmatter yields
+ * (numbers, booleans) and returning `undefined` for anything else, since
+ * templates treat "not a usable string" and "absent" the same way.
+ */
+export function optionalString(value) {
+    if (typeof value === "string") {
+        return value;
+    }
+    if (typeof value === "number" ||
+        typeof value === "boolean" ||
+        typeof value === "bigint") {
+        return String(value);
+    }
+    return undefined;
+}
+//# sourceMappingURL=props.js.map

package/dist/props.js.map

@@ -0,0 +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"}

package/dist/render/svg.d.ts

@@ -3,8 +3,10 @@ import type { Dimensions, MetaImageProps, ResolvedConfig } from "../types.js";
  * Build the complete SVG document for one image: the enclosing `<svg>` root,
  * the config-driven background, and the template's foreground content.
  *
- * Asynchronous because a template may need to load resources — the `code`
- * template fetches syntax grammars and themes on demand.
+ * Asynchronous because a template may need to load resources. The `code`
+ * template fetches syntax grammars and themes on demand, the fonts the text is
+ * measured against have to be read before a template can lay it out, and so do
+ * the logo, the avatar and any background photo.
  */
 export declare function buildSvg(props: MetaImageProps, config: ResolvedConfig, dimensions: Dimensions): Promise<string>;
 //# sourceMappingURL=svg.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"svg.d.ts","sourceRoot":"","sources":["../../src/render/svg.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAK9E;;;;;;GAMG;AACH,wBAAsB,QAAQ,CAC5B,KAAK,EAAE,cAAc,EACrB,MAAM,EAAE,cAAc,EACtB,UAAU,EAAE,UAAU,GACrB,OAAO,CAAC,MAAM,CAAC,CAWjB"}
+{"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"}

package/dist/render/svg.js

@@ -1,17 +1,32 @@
 import { backgroundSvg } from "../background.js";
+import { loadImages } from "../image/index.js";
+import { createMeasurer } from "../measure/index.js";
 import { selectTemplate } from "./template.js";
 const backgroundId = "colophon-bg";
 /**
  * Build the complete SVG document for one image: the enclosing `<svg>` root,
  * the config-driven background, and the template's foreground content.
  *
- * Asynchronous because a template may need to load resources — the `code`
- * template fetches syntax grammars and themes on demand.
+ * Asynchronous because a template may need to load resources. The `code`
+ * template fetches syntax grammars and themes on demand, the fonts the text is
+ * measured against have to be read before a template can lay it out, and so do
+ * the logo, the avatar and any background photo.
  */
 export async function buildSvg(props, config, dimensions) {
     const template = selectTemplate(config, props.template);
-    const background = backgroundSvg(config.background, dimensions, backgroundId);
-    const body = await template.render({ props, config, dimensions });
+    const [measure, images] = await Promise.all([
+        createMeasurer(config),
+        loadImages(config, props),
+    ]);
+    const background = backgroundSvg(config.background, dimensions, backgroundId, images.background);
+    const body = await template.render({
+        props,
+        config,
+        dimensions,
+        measure,
+        logo: images.logo,
+        avatar: images.avatar,
+    });
     const { width, height } = dimensions;
     return (`<svg width="${String(width)}" height="${String(height)}"` +
         ` viewBox="0 0 ${String(width)} ${String(height)}"` +

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;AAEjD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C,MAAM,YAAY,GAAG,aAAa,CAAC;AAEnC;;;;;;GAMG;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,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,UAAU,EAAE,UAAU,EAAE,YAAY,CAAC,CAAC;IAC9E,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;IAClE,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,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"}

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,EAAc,cAAc,EAAE,MAAM,aAAa,CAAC;AA0B9D;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAkB1E"}
+{"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,CAqB1E"}

package/dist/stamp/config-digest.js

@@ -18,6 +18,23 @@ async function fontDigest(font) {
     const bytes = "data" in font ? font.data : await readFile(font.path);
     return sha256(stableStringify({ family: font.family, bytes: sha256(bytes) }));
 }
+/**
+ * Digest an image by its contents, for the reason a font is digested that way:
+ * a logo replaced at the same path is a different logo, and every image drawn
+ * with it wants rendering again.
+ */
+async function imageDigest(source) {
+    return sha256("data" in source ? source.data : await readFile(source.path));
+}
+/**
+ * A background, with any image it draws replaced by a digest of that image's
+ * bytes. Everything else about a background is already a value.
+ */
+async function backgroundDigest(background) {
+    return background.type === "image"
+        ? { ...background, source: await imageDigest(background.source) }
+        : background;
+}
 /**
  * Digest the config fields that affect what an image looks like.
  *
@@ -28,11 +45,13 @@ async function fontDigest(font) {
  */
 export async function configDigest(config) {
     const fonts = await Promise.all(config.fonts.map(async (font) => fontDigest(font)));
+    const logo = config.logo === undefined ? undefined : await imageDigest(config.logo);
     return sha256(stableStringify({
         version: await packageVersion(),
         colors: config.colors,
-        background: config.background,
+        background: await backgroundDigest(config.background),
         fonts,
+        logo,
         systemFonts: config.systemFonts,
         fontFamily: config.fontFamily,
         footer: config.footer,

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;AAG5C,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;;;;;;;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;IAEF,OAAO,MAAM,CACX,eAAe,CAAC;QACd,OAAO,EAAE,MAAM,cAAc,EAAE;QAC/B,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,KAAK;QACL,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;;;;;;;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,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"}

package/dist/stamp/index.js

@@ -12,8 +12,8 @@ export async function createStamper(config) {
     // A custom template is config the project controls, so its source counts as
     // part of the input. Built-in templates are covered by the package version.
     // Source text is all there is to go on: a template that reads something its
-    // own code does not name — a closed-over value, a file — can change without
-    // the stamp noticing, and needs `overwrite` to pick it up.
+    // own code does not name, such as a closed-over value or a file it loads,
+    // can change without the stamp noticing, and needs `overwrite` to pick it up.
     const templateDigest = (name) => {
         const cached = templateDigests.get(name);
         if (cached !== undefined) {

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,4EAA4E;IAC5E,2DAA2D;IAC3D,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,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"}

package/dist/stamp/read.d.ts

@@ -1,6 +1,6 @@
 /**
  * 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
+ * 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.
  */
 export declare function readPngStamp(file: string): Promise<string | undefined>;