@kensio/colophon 2.2.0 → 2.4.0

package/dist/stamp.js

@@ -0,0 +1,198 @@
+import { createHash } from "node:crypto";
+import { open, readFile } from "node:fs/promises";
+import { crc32 } from "node:zlib";
+/**
+ * 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.
+ */
+const stampKeyword = "colophon";
+/**
+ * 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;
+const pngSignature = Buffer.from([
+    0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a,
+]);
+/** Signature + the whole `IHDR` chunk: length, type, 13 bytes of data, CRC. */
+const afterHeader = pngSignature.length + 4 + 4 + 13 + 4;
+function sha256(value) {
+    return createHash("sha256").update(value).digest("hex");
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/**
+ * `JSON.stringify` with object keys sorted, so that reordering frontmatter
+ * without changing it does not look like a change.
+ */
+function stableStringify(value) {
+    return JSON.stringify(value, (_key, raw) => isRecord(raw)
+        ? Object.fromEntries(Object.keys(raw)
+            .toSorted((a, b) => a.localeCompare(b))
+            .map((key) => [key, raw[key]]))
+        : raw);
+}
+/**
+ * The installed Colophon version. The built-in templates ship in this package,
+ * so an upgrade can change what an image looks like without anything in the
+ * project changing; folding the version into the stamp makes that upgrade
+ * re-render rather than leave the old images in place.
+ */
+async function packageVersion() {
+    const manifest = await readFile(new URL("../package.json", import.meta.url), "utf8");
+    return JSON.parse(manifest).version;
+}
+/**
+ * Digest one configured font by its contents, not its path: replacing the file
+ * at the same path changes every image drawn with it.
+ */
+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 the config fields that affect what an image looks like.
+ *
+ * `onWarning` is left out because it cannot change a pixel. So are `sizes` and
+ * `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.
+ */
+async function configDigest(config) {
+    const fonts = await Promise.all(config.fonts.map(async (font) => fontDigest(font)));
+    return sha256(stableStringify({
+        version: await packageVersion(),
+        colors: config.colors,
+        background: config.background,
+        fonts,
+        systemFonts: config.systemFonts,
+        fontFamily: config.fontFamily,
+        footer: config.footer,
+        badge: config.badge,
+        code: config.code,
+    }));
+}
+/**
+ * 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.
+ */
+export async function createStamper(config) {
+    const base = await configDigest(config);
+    const templateDigests = new Map();
+    // 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.
+    const templateDigest = (name) => {
+        const cached = templateDigests.get(name);
+        if (cached !== undefined) {
+            return cached;
+        }
+        const template = config.templates[name];
+        const digest = template === undefined ? "" : sha256(template.render.toString());
+        templateDigests.set(name, digest);
+        return digest;
+    };
+    return {
+        stamp(props, size) {
+            return sha256(stableStringify([
+                base,
+                templateDigest(props.template),
+                // The whole size, not just its dimensions: a size carries its own
+                // config overrides, and changing one has to re-render that image.
+                size,
+                props,
+            ]));
+        },
+    };
+}
+/**
+ * A PNG `tEXt` chunk: length, type, `keyword\0text`, CRC over type and data.
+ */
+function textChunk(keyword, text) {
+    const data = 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
+ * after the header so it can be read back without decoding the image.
+ */
+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.");
+    }
+    return Buffer.concat([
+        png.subarray(0, afterHeader),
+        textChunk(stampKeyword, stamp),
+        png.subarray(afterHeader),
+    ]);
+}
+/**
+ * Find the stamp in the leading bytes of a PNG, or `undefined` if there is
+ * none — 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;
+    }
+    return undefined;
+}
+/**
+ * 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.
+ */
+export async function readPngStamp(file) {
+    let handle;
+    try {
+        handle = await open(file, "r");
+    }
+    catch {
+        return undefined;
+    }
+    try {
+        const buffer = Buffer.alloc(headBytes);
+        const { bytesRead } = await handle.read(buffer, 0, headBytes, 0);
+        return findStamp(buffer.subarray(0, bytesRead));
+    }
+    finally {
+        await handle.close();
+    }
+}
+//# sourceMappingURL=stamp.js.map

package/dist/stamp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stamp.js","sourceRoot":"","sources":["../src/stamp.ts"],"names":[],"mappings":"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"}

package/dist/templates/attribution.d.ts

@@ -0,0 +1,17 @@
+import type { ImageAsset, MeasureText, ResolvedConfig } from "../types.js";
+import type { FooterPlacement } from "./footer.js";
+/** Where the attribution line goes: a footer placement, plus room to lay it out. */
+export interface AttributionPlacement extends FooterPlacement {
+    /** Left edge and width of the content area the line is set within. */
+    readonly left: number;
+    readonly width: number;
+}
+/**
+ * The footer line, with the post's avatar before it.
+ *
+ * Both belong to the same idea, which is who made this, so they are drawn as
+ * one line rather than tucked into separate corners. Without an avatar this is
+ * the footer exactly as it was, down to the byte.
+ */
+export declare function attribution(config: ResolvedConfig, placement: AttributionPlacement, avatar: ImageAsset | undefined, measure: MeasureText): string;
+//# sourceMappingURL=attribution.d.ts.map

package/dist/templates/attribution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attribution.d.ts","sourceRoot":"","sources":["../../src/templates/attribution.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC3E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAYnD,oFAAoF;AACpF,MAAM,WAAW,oBAAqB,SAAQ,eAAe;IAC3D,sEAAsE;IACtE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,cAAc,EACtB,SAAS,EAAE,oBAAoB,EAC/B,MAAM,EAAE,UAAU,GAAG,SAAS,EAC9B,OAAO,EAAE,WAAW,GACnB,MAAM,CAqCR"}

package/dist/templates/attribution.js

@@ -0,0 +1,39 @@
+import { image, measureIn, row } from "../layout/index.js";
+import { footerElement, hasFooter } from "./footer.js";
+/** The avatar's diameter, as a multiple of the footer's font size. */
+const avatarScale = 1.9;
+/** Where a circular avatar's centre sits above the footer's baseline. */
+const avatarRise = 0.34;
+/** Unique within one image, which is as many avatars as there are. */
+const avatarId = "colophon-avatar";
+/**
+ * The footer line, with the post's avatar before it.
+ *
+ * Both belong to the same idea, which is who made this, so they are drawn as
+ * one line rather than tucked into separate corners. Without an avatar this is
+ * the footer exactly as it was, down to the byte.
+ */
+export function attribution(config, placement, avatar, measure) {
+    if (avatar === undefined) {
+        return footerElement(config, placement);
+    }
+    const { fontSize } = placement;
+    const size = Math.round(fontSize * avatarScale);
+    const text = hasFooter(config) ? (config.footer ?? "") : "";
+    const gap = text === "" ? 0 : Math.round(fontSize * 0.5);
+    const textWidth = text === ""
+        ? 0
+        : measureIn(measure, config.fontFamily, 500)(text, fontSize);
+    // Only the horizontal placement comes from the row. The baseline is the one
+    // the template asked for, so a footer with no avatar and a footer with one
+    // sit at the same height.
+    const [portrait, label] = row([{ size }, { size: Math.round(textWidth), gapBefore: gap }], { x: placement.left, y: placement.y, width: placement.width, height: size }, placement.anchor === "middle" ? "centre" : "start");
+    const top = Math.round(placement.y - fontSize * avatarRise - size / 2);
+    return (image({ x: portrait?.x ?? placement.left, y: top, width: size, height: size }, avatar.href, { fit: "cover", radius: Math.round(size / 2), id: avatarId }) +
+        footerElement(config, {
+            ...placement,
+            x: label?.x ?? placement.left,
+            anchor: "start",
+        }));
+}
+//# sourceMappingURL=attribution.js.map

package/dist/templates/attribution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attribution.js","sourceRoot":"","sources":["../../src/templates/attribution.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AAG3D,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAEvD,sEAAsE;AACtE,MAAM,WAAW,GAAG,GAAG,CAAC;AAExB,yEAAyE;AACzE,MAAM,UAAU,GAAG,IAAI,CAAC;AAExB,sEAAsE;AACtE,MAAM,QAAQ,GAAG,iBAAiB,CAAC;AASnC;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CACzB,MAAsB,EACtB,SAA+B,EAC/B,MAA8B,EAC9B,OAAoB;IAEpB,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,aAAa,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAC1C,CAAC;IAED,MAAM,EAAE,QAAQ,EAAE,GAAG,SAAS,CAAC;IAC/B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,WAAW,CAAC,CAAC;IAChD,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5D,MAAM,GAAG,GAAG,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,GAAG,CAAC,CAAC;IACzD,MAAM,SAAS,GACb,IAAI,KAAK,EAAE;QACT,CAAC,CAAC,CAAC;QACH,CAAC,CAAC,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAEjE,4EAA4E;IAC5E,2EAA2E;IAC3E,0BAA0B;IAC1B,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,GAAG,GAAG,CAC3B,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,EAC3D,EAAE,CAAC,EAAE,SAAS,CAAC,IAAI,EAAE,CAAC,EAAE,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,EAC3E,SAAS,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CACnD,CAAC;IAEF,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,GAAG,QAAQ,GAAG,UAAU,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC;IAEvE,OAAO,CACL,KAAK,CACH,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,IAAI,SAAS,CAAC,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,EACvE,MAAM,CAAC,IAAI,EACX,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,CAC7D;QACD,aAAa,CAAC,MAAM,EAAE;YACpB,GAAG,SAAS;YACZ,CAAC,EAAE,KAAK,EAAE,CAAC,IAAI,SAAS,CAAC,IAAI;YAC7B,MAAM,EAAE,OAAO;SAChB,CAAC,CACH,CAAC;AACJ,CAAC"}

package/dist/templates/banner/badge.d.ts

@@ -0,0 +1,7 @@
+import type { Badge } from "../../types.js";
+/**
+ * The corner badge: a rounded plate with the badge text on it, sized from the
+ * plate height so it scales with the image rather than the text length.
+ */
+export declare function renderBadge(badge: Badge, fontFamily: string, brand: string, pad: number, height: number): string;
+//# sourceMappingURL=badge.d.ts.map

package/dist/templates/banner/badge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"badge.d.ts","sourceRoot":"","sources":["../../../src/templates/banner/badge.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAE5C;;;GAGG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,KAAK,EACZ,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,GACb,MAAM,CAoBR"}

package/dist/templates/banner/badge.js

@@ -0,0 +1,21 @@
+import { box, textElement } from "../../layout/index.js";
+/**
+ * The corner badge: a rounded plate with the badge text on it, sized from the
+ * plate height so it scales with the image rather than the text length.
+ */
+export function renderBadge(badge, fontFamily, brand, pad, height) {
+    const fontSize = Math.round(height * 0.6);
+    const padX = Math.round(height * 0.36);
+    const width = Math.round(badge.text.length * fontSize * 0.64 + padX * 2);
+    const plate = box({ x: pad, y: pad, width, height }, { radius: Math.round(height * 0.1), fill: badge.background ?? "#ffffff" });
+    const text = textElement(badge.text, {
+        x: pad + padX,
+        y: pad + Math.round(height * 0.72),
+        fontFamily,
+        fontSize,
+        fontWeight: 900,
+        fill: badge.color ?? brand,
+    });
+    return plate + text;
+}
+//# sourceMappingURL=badge.js.map

package/dist/templates/banner/badge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"badge.js","sourceRoot":"","sources":["../../../src/templates/banner/badge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAGzD;;;GAGG;AACH,MAAM,UAAU,WAAW,CACzB,KAAY,EACZ,UAAkB,EAClB,KAAa,EACb,GAAW,EACX,MAAc;IAEd,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC;IAC1C,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACvC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,QAAQ,GAAG,IAAI,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC;IAEzE,MAAM,KAAK,GAAG,GAAG,CACf,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,EACjC,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,GAAG,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,UAAU,IAAI,SAAS,EAAE,CAC1E,CAAC;IAEF,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,CAAC,IAAI,EAAE;QACnC,CAAC,EAAE,GAAG,GAAG,IAAI;QACb,CAAC,EAAE,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC;QAClC,UAAU;QACV,QAAQ;QACR,UAAU,EAAE,GAAG;QACf,IAAI,EAAE,KAAK,CAAC,KAAK,IAAI,KAAK;KAC3B,CAAC,CAAC;IAEH,OAAO,KAAK,GAAG,IAAI,CAAC;AACtB,CAAC"}

package/dist/templates/banner/index.d.ts

@@ -0,0 +1,12 @@
+import type { Template } from "../../types.js";
+/**
+ * Generalised "banner" template: a left-aligned title with an optional
+ * version and wrapped subtitle, an optional corner badge, and an optional
+ * footer. This is the configurable descendant of the original `npm_package`
+ * layout.
+ *
+ * A logo goes in the opposite corner to the badge, which is the corner the
+ * left-aligned text leaves free, and the avatar sits with the footer.
+ */
+export declare const bannerTemplate: Template;
+//# sourceMappingURL=index.d.ts.map

package/dist/templates/banner/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/templates/banner/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAmB,MAAM,gBAAgB,CAAC;AAOhE;;;;;;;;GAQG;AACH,eAAO,MAAM,cAAc,EAAE,QAmF5B,CAAC"}

package/dist/templates/banner/index.js

@@ -0,0 +1,68 @@
+import { drawLines, inset } from "../../layout/index.js";
+import { optionalString } from "../../props.js";
+import { attribution } from "../attribution.js";
+import { footerBaseline, hasFooter } from "../footer.js";
+import { logoElement, logoRect } from "../logo.js";
+import { renderBadge } from "./badge.js";
+import { bannerLines } from "./lines.js";
+/**
+ * Generalised "banner" template: a left-aligned title with an optional
+ * version and wrapped subtitle, an optional corner badge, and an optional
+ * footer. This is the configurable descendant of the original `npm_package`
+ * layout.
+ *
+ * A logo goes in the opposite corner to the badge, which is the corner the
+ * left-aligned text leaves free, and the avatar sits with the footer.
+ */
+export const bannerTemplate = {
+    name: "banner",
+    render({ props, config, dimensions, measure, logo, avatar, }) {
+        const { width, height } = dimensions;
+        const { fontFamily } = config;
+        const pad = Math.round(width * 0.075);
+        const footerFs = Math.round(height * 0.034);
+        const badgeHeight = Math.round(height * 0.072);
+        const mark = logoRect(logo, dimensions, pad, "start");
+        const subtitle = optionalString(props.subtitle);
+        const hasSubtitle = subtitle !== undefined && subtitle !== "";
+        // The text sits between whatever the marks along the top and the footer
+        // along the bottom leave behind.
+        const topMark = Math.max(config.badge === undefined ? 0 : badgeHeight, mark?.height ?? 0);
+        const area = inset({ x: 0, y: 0, width, height }, {
+            top: pad + (topMark === 0 ? 0 : topMark + Math.round(height * 0.03)),
+            right: pad,
+            left: pad,
+            bottom: pad +
+                (hasFooter(config) || avatar !== undefined
+                    ? footerFs + Math.round(height * 0.02)
+                    : 0),
+        });
+        const lines = bannerLines(props, {
+            height,
+            contentWidth: area.width,
+            titleFs: Math.round(height * (hasSubtitle ? 0.078 : 0.092)),
+            versionFs: Math.round(height * 0.04),
+            subFs: Math.round(height * 0.05),
+            measure,
+            fontFamily,
+        });
+        const body = drawLines(lines, area, {
+            fontFamily,
+            fill: config.colors.foreground,
+            lineHeight: 1.28,
+        });
+        const badge = config.badge === undefined
+            ? ""
+            : renderBadge(config.badge, fontFamily, config.colors.brand, pad, badgeHeight);
+        const footer = attribution(config, {
+            x: pad,
+            y: footerBaseline(height, pad, footerFs),
+            fontSize: footerFs,
+            opacity: 0.78,
+            left: pad,
+            width: width - pad * 2,
+        }, avatar, measure);
+        return badge + logoElement(logo, mark) + body + footer;
+    },
+};
+//# sourceMappingURL=index.js.map

package/dist/templates/banner/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/templates/banner/index.ts"],"names":[],"mappings":"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"}

package/dist/templates/banner/lines.d.ts

@@ -0,0 +1,22 @@
+import type { MeasureText, MetaImageProps } from "../../types.js";
+import type { TextLine } from "../../layout/index.js";
+/**
+ * The font sizes the banner's text is drawn at, all keyed to image height,
+ * along with the space it has and how to measure text into it.
+ */
+export interface BannerSizes {
+    readonly height: number;
+    readonly contentWidth: number;
+    readonly titleFs: number;
+    readonly versionFs: number;
+    readonly subFs: number;
+    readonly measure: MeasureText;
+    readonly fontFamily: string;
+}
+/**
+ * The banner's text block: the wrapped title, an optional version, and the
+ * wrapped subtitle. Extra breathing room goes before the version and subtitle
+ * groups so the three do not read as one squashed block.
+ */
+export declare function bannerLines(props: MetaImageProps, sizes: BannerSizes): TextLine[];
+//# sourceMappingURL=lines.d.ts.map

package/dist/templates/banner/lines.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lines.d.ts","sourceRoot":"","sources":["../../../src/templates/banner/lines.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAClE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAStD;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,cAAc,EACrB,KAAK,EAAE,WAAW,GACjB,QAAQ,EAAE,CAuBZ"}

package/dist/templates/banner/lines.js

@@ -0,0 +1,35 @@
+import { blockLines } from "../../layout/index.js";
+import { versionLines } from "./version.js";
+const maxTitleLines = 3;
+const maxSubtitleLines = 4;
+const titleFloor = 0.62;
+const subtitleFloor = 0.8;
+/**
+ * The banner's text block: the wrapped title, an optional version, and the
+ * wrapped subtitle. Extra breathing room goes before the version and subtitle
+ * groups so the three do not read as one squashed block.
+ */
+export function bannerLines(props, sizes) {
+    const { height, contentWidth, measure, fontFamily } = sizes;
+    return [
+        ...blockLines(props.title, measure, fontFamily, {
+            maxWidth: contentWidth,
+            maxLines: maxTitleLines,
+            fontSize: sizes.titleFs,
+            floor: titleFloor,
+            fontWeight: 800,
+            opacity: 0.98,
+        }),
+        ...versionLines(props, sizes),
+        ...blockLines(props.subtitle, measure, fontFamily, {
+            maxWidth: contentWidth,
+            maxLines: maxSubtitleLines,
+            fontSize: sizes.subFs,
+            floor: subtitleFloor,
+            fontWeight: 500,
+            opacity: 0.86,
+            gapBefore: Math.round(height * 0.045),
+        }),
+    ];
+}
+//# sourceMappingURL=lines.js.map

package/dist/templates/banner/lines.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lines.js","sourceRoot":"","sources":["../../../src/templates/banner/lines.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,MAAM,aAAa,GAAG,CAAC,CAAC;AACxB,MAAM,gBAAgB,GAAG,CAAC,CAAC;AAC3B,MAAM,UAAU,GAAG,IAAI,CAAC;AACxB,MAAM,aAAa,GAAG,GAAG,CAAC;AAgB1B;;;;GAIG;AACH,MAAM,UAAU,WAAW,CACzB,KAAqB,EACrB,KAAkB;IAElB,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,KAAK,CAAC;IAE5D,OAAO;QACL,GAAG,UAAU,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE;YAC9C,QAAQ,EAAE,YAAY;YACtB,QAAQ,EAAE,aAAa;YACvB,QAAQ,EAAE,KAAK,CAAC,OAAO;YACvB,KAAK,EAAE,UAAU;YACjB,UAAU,EAAE,GAAG;YACf,OAAO,EAAE,IAAI;SACd,CAAC;QACF,GAAG,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC;QAC7B,GAAG,UAAU,CAAC,KAAK,CAAC,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE;YACjD,QAAQ,EAAE,YAAY;YACtB,QAAQ,EAAE,gBAAgB;YAC1B,QAAQ,EAAE,KAAK,CAAC,KAAK;YACrB,KAAK,EAAE,aAAa;YACpB,UAAU,EAAE,GAAG;YACf,OAAO,EAAE,IAAI;YACb,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC;SACtC,CAAC;KACH,CAAC;AACJ,CAAC"}

package/dist/templates/banner/version.d.ts

@@ -0,0 +1,9 @@
+import type { MetaImageProps } from "../../types.js";
+import type { TextLine } from "../../layout/index.js";
+import type { BannerSizes } from "./lines.js";
+/**
+ * The version line, or nothing where there is no version. It is never wrapped
+ * or shrunk: a version string that needed either would not be one.
+ */
+export declare function versionLines(props: MetaImageProps, sizes: BannerSizes): readonly TextLine[];
+//# sourceMappingURL=version.d.ts.map

package/dist/templates/banner/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../../src/templates/banner/version.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,cAAc,EACrB,KAAK,EAAE,WAAW,GACjB,SAAS,QAAQ,EAAE,CAgBrB"}

package/dist/templates/banner/version.js

@@ -0,0 +1,21 @@
+import { optionalString } from "../../props.js";
+/**
+ * The version line, or nothing where there is no version. It is never wrapped
+ * or shrunk: a version string that needed either would not be one.
+ */
+export function versionLines(props, sizes) {
+    const version = optionalString(props.version);
+    if (version === undefined || version === "") {
+        return [];
+    }
+    return [
+        {
+            text: `v${version}`,
+            fontSize: sizes.versionFs,
+            fontWeight: 700,
+            opacity: 0.85,
+            gapBefore: Math.round(sizes.height * 0.03),
+        },
+    ];
+}
+//# sourceMappingURL=version.js.map

package/dist/templates/banner/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../../src/templates/banner/version.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAIhD;;;GAGG;AACH,MAAM,UAAU,YAAY,CAC1B,KAAqB,EACrB,KAAkB;IAElB,MAAM,OAAO,GAAG,cAAc,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAE9C,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,EAAE,EAAE,CAAC;QAC5C,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO;QACL;YACE,IAAI,EAAE,IAAI,OAAO,EAAE;YACnB,QAAQ,EAAE,KAAK,CAAC,SAAS;YACzB,UAAU,EAAE,GAAG;YACf,OAAO,EAAE,IAAI;YACb,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC;SAC3C;KACF,CAAC;AACJ,CAAC"}

package/dist/templates/card/index.d.ts

@@ -0,0 +1,10 @@
+import type { Template } from "../../types.js";
+/**
+ * Minimal "card" template: a centred title with an optional subtitle. No
+ * badge or version, so it is a quieter alternative to `banner`.
+ *
+ * A logo goes above the title, centred like everything else here, and the
+ * avatar sits with the footer along the bottom.
+ */
+export declare const cardTemplate: Template;
+//# sourceMappingURL=index.d.ts.map

package/dist/templates/card/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/templates/card/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAmB,MAAM,gBAAgB,CAAC;AAMhE;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,EAAE,QA8D1B,CAAC"}

package/dist/templates/card/index.js

@@ -0,0 +1,55 @@
+import { drawLines, inset } from "../../layout/index.js";
+import { attribution } from "../attribution.js";
+import { footerBaseline, hasFooter } from "../footer.js";
+import { logoElement, logoRect } from "../logo.js";
+import { cardLines } from "./lines.js";
+/**
+ * Minimal "card" template: a centred title with an optional subtitle. No
+ * badge or version, so it is a quieter alternative to `banner`.
+ *
+ * A logo goes above the title, centred like everything else here, and the
+ * avatar sits with the footer along the bottom.
+ */
+export const cardTemplate = {
+    name: "card",
+    render({ props, config, dimensions, measure, logo, avatar, }) {
+        const { width, height } = dimensions;
+        const pad = Math.round(width * 0.09);
+        const footerFs = Math.round(height * 0.032);
+        const mark = logoRect(logo, dimensions, pad, "middle");
+        const area = inset({ x: 0, y: 0, width, height }, {
+            top: pad + (mark === undefined ? 0 : mark.height + pad / 2),
+            right: pad,
+            left: pad,
+            bottom: pad +
+                (hasFooter(config) || avatar !== undefined
+                    ? footerFs + Math.round(height * 0.02)
+                    : 0),
+        });
+        const lines = cardLines(props, {
+            measure,
+            fontFamily: config.fontFamily,
+            contentWidth: area.width,
+            titleFs: Math.round(height * 0.1),
+            subFs: Math.round(height * 0.045),
+            height,
+        });
+        const body = drawLines(lines, area, {
+            fontFamily: config.fontFamily,
+            fill: config.colors.foreground,
+            lineHeight: 1.28,
+            anchor: "middle",
+        });
+        const footer = attribution(config, {
+            x: Math.round(width / 2),
+            y: footerBaseline(height, pad, footerFs),
+            fontSize: footerFs,
+            opacity: 0.75,
+            anchor: "middle",
+            left: pad,
+            width: width - pad * 2,
+        }, avatar, measure);
+        return logoElement(logo, mark) + body + footer;
+    },
+};
+//# sourceMappingURL=index.js.map

package/dist/templates/card/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/templates/card/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAEzD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,YAAY,GAAa;IACpC,IAAI,EAAE,MAAM;IACZ,MAAM,CAAC,EACL,KAAK,EACL,MAAM,EACN,UAAU,EACV,OAAO,EACP,IAAI,EACJ,MAAM,GACU;QAChB,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC;QACrC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC;QACrC,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC;QAC5C,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC;QAEvD,MAAM,IAAI,GAAG,KAAK,CAChB,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAC7B;YACE,GAAG,EAAE,GAAG,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC;YAC3D,KAAK,EAAE,GAAG;YACV,IAAI,EAAE,GAAG;YACT,MAAM,EACJ,GAAG;gBACH,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,MAAM,KAAK,SAAS;oBACxC,CAAC,CAAC,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC;oBACtC,CAAC,CAAC,CAAC,CAAC;SACT,CACF,CAAC;QAEF,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,EAAE;YAC7B,OAAO;YACP,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,YAAY,EAAE,IAAI,CAAC,KAAK;YACxB,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,GAAG,CAAC;YACjC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC;YACjC,MAAM;SACP,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE;YAClC,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,UAAU;YAC9B,UAAU,EAAE,IAAI;YAChB,MAAM,EAAE,QAAQ;SACjB,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,WAAW,CACxB,MAAM,EACN;YACE,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC;YACxB,CAAC,EAAE,cAAc,CAAC,MAAM,EAAE,GAAG,EAAE,QAAQ,CAAC;YACxC,QAAQ,EAAE,QAAQ;YAClB,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,QAAQ;YAChB,IAAI,EAAE,GAAG;YACT,KAAK,EAAE,KAAK,GAAG,GAAG,GAAG,CAAC;SACvB,EACD,MAAM,EACN,OAAO,CACR,CAAC;QAEF,OAAO,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,IAAI,GAAG,MAAM,CAAC;IACjD,CAAC;CACF,CAAC"}

package/dist/templates/card/lines.d.ts

@@ -0,0 +1,21 @@
+import type { MeasureText, MetaImageProps } from "../../types.js";
+import type { TextLine } from "../../layout/index.js";
+/** The space the card's text has, and how to measure text into it. */
+export interface CardText {
+    readonly measure: MeasureText;
+    readonly fontFamily: string;
+    readonly contentWidth: number;
+    readonly titleFs: number;
+    readonly subFs: number;
+    readonly height: number;
+}
+/**
+ * The card's text block: the wrapped title, then the wrapped subtitle.
+ *
+ * The gap before the subtitle is smaller than the banner's, because the card
+ * has only the two groups and they belong together. It is not nothing, though:
+ * a title that wraps ends on a line the subtitle would otherwise sit straight
+ * underneath, and the change of size and weight alone does not separate them.
+ */
+export declare function cardLines(props: MetaImageProps, text: CardText): TextLine[];
+//# sourceMappingURL=lines.d.ts.map

package/dist/templates/card/lines.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lines.d.ts","sourceRoot":"","sources":["../../../src/templates/card/lines.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAClE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAQtD,sEAAsE;AACtE,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,QAAQ,GAAG,QAAQ,EAAE,CAsB3E"}