@kensio/colophon 2.2.0 → 2.3.0

package/dist/templates/index.js

@@ -1,6 +1,6 @@
-import { bannerTemplate } from "./banner.js";
-import { cardTemplate } from "./card.js";
-import { codeTemplate } from "./code.js";
+import { bannerTemplate } from "./banner/index.js";
+import { cardTemplate } from "./card/index.js";
+import { codeTemplate } from "./code/index.js";
 /**
  * Templates registered out of the box. Projects can add to or override these
  * via `config.templates`.
@@ -10,8 +10,8 @@ export const builtinTemplates = {
     [cardTemplate.name]: cardTemplate,
     [codeTemplate.name]: codeTemplate,
 };
-export { bannerTemplate } from "./banner.js";
-export { cardTemplate } from "./card.js";
-export { codeTemplate } from "./code.js";
+export { bannerTemplate } from "./banner/index.js";
+export { cardTemplate } from "./card/index.js";
+export { codeTemplate } from "./code/index.js";
 export { optionalString } from "./props.js";
 //# sourceMappingURL=index.js.map

package/dist/templates/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/templates/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEzC;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAuC;IAClE,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,cAAc;IACrC,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,YAAY;IACjC,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,YAAY;CAClC,CAAC;AAEF,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/templates/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAuC;IAClE,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,cAAc;IACrC,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,YAAY;IACjC,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,YAAY;CAClC,CAAC;AAEF,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}

package/dist/text/element.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Attributes accepted by {@link textElement}. Colour and opacity are optional.
+ */
+export interface TextAttributes {
+    readonly x: number;
+    readonly y: number;
+    readonly fontFamily: string;
+    readonly fontSize: number;
+    readonly fontWeight: number;
+    readonly fill: string;
+    readonly fillOpacity?: number;
+    readonly anchor?: "start" | "middle" | "end";
+}
+/**
+ * Build a single `<text>` element. The content is XML-escaped.
+ */
+export declare function textElement(content: string, attributes: TextAttributes): string;
+//# sourceMappingURL=element.d.ts.map

package/dist/text/element.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"element.d.ts","sourceRoot":"","sources":["../../src/text/element.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;CAC9C;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,cAAc,GACzB,MAAM,CAkBR"}

package/dist/text/element.js

@@ -0,0 +1,19 @@
+import { escapeXml } from "./escape.js";
+/**
+ * Build a single `<text>` element. The content is XML-escaped.
+ */
+export function textElement(content, attributes) {
+    const opacity = attributes.fillOpacity === undefined
+        ? ""
+        : ` fill-opacity="${String(attributes.fillOpacity)}"`;
+    const anchor = attributes.anchor === undefined
+        ? ""
+        : ` text-anchor="${attributes.anchor}"`;
+    return (`<text x="${String(attributes.x)}" y="${String(attributes.y)}"` +
+        ` font-family="${escapeXml(attributes.fontFamily)}"` +
+        ` font-size="${String(attributes.fontSize)}"` +
+        ` font-weight="${String(attributes.fontWeight)}"` +
+        ` fill="${attributes.fill}"${opacity}${anchor}>` +
+        `${escapeXml(content)}</text>`);
+}
+//# sourceMappingURL=element.js.map

package/dist/text/element.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"element.js","sourceRoot":"","sources":["../../src/text/element.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAgBxC;;GAEG;AACH,MAAM,UAAU,WAAW,CACzB,OAAe,EACf,UAA0B;IAE1B,MAAM,OAAO,GACX,UAAU,CAAC,WAAW,KAAK,SAAS;QAClC,CAAC,CAAC,EAAE;QACJ,CAAC,CAAC,kBAAkB,MAAM,CAAC,UAAU,CAAC,WAAW,CAAC,GAAG,CAAC;IAC1D,MAAM,MAAM,GACV,UAAU,CAAC,MAAM,KAAK,SAAS;QAC7B,CAAC,CAAC,EAAE;QACJ,CAAC,CAAC,iBAAiB,UAAU,CAAC,MAAM,GAAG,CAAC;IAE5C,OAAO,CACL,YAAY,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG;QAC/D,iBAAiB,SAAS,CAAC,UAAU,CAAC,UAAU,CAAC,GAAG;QACpD,eAAe,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,GAAG;QAC7C,iBAAiB,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC,GAAG;QACjD,UAAU,UAAU,CAAC,IAAI,IAAI,OAAO,GAAG,MAAM,GAAG;QAChD,GAAG,SAAS,CAAC,OAAO,CAAC,SAAS,CAC/B,CAAC;AACJ,CAAC"}

package/dist/text/escape.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Escape a string for safe inclusion in SVG/XML text content or attributes.
+ */
+export declare function escapeXml(value: string): string;
+//# sourceMappingURL=escape.d.ts.map

package/dist/text/escape.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"escape.d.ts","sourceRoot":"","sources":["../../src/text/escape.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAO/C"}

package/dist/text/escape.js

@@ -0,0 +1,12 @@
+/**
+ * Escape a string for safe inclusion in SVG/XML text content or attributes.
+ */
+export function escapeXml(value) {
+    return value
+        .replaceAll("&", "&")
+        .replaceAll("<", "&lt;")
+        .replaceAll(">", "&gt;")
+        .replaceAll('"', "&quot;")
+        .replaceAll("'", "&apos;");
+}
+//# sourceMappingURL=escape.js.map

package/dist/text/escape.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"escape.js","sourceRoot":"","sources":["../../src/text/escape.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,KAAa;IACrC,OAAO,KAAK;SACT,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC;SACxB,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC;SACvB,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC;SACvB,UAAU,CAAC,GAAG,EAAE,QAAQ,CAAC;SACzB,UAAU,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;AAC/B,CAAC"}

package/dist/text/index.d.ts

@@ -0,0 +1,7 @@
+export { escapeXml } from "./escape.js";
+export { textElement } from "./element.js";
+export type { TextAttributes } from "./element.js";
+export { layoutStack } from "./stack.js";
+export type { PlacedLine, StackLine } from "./stack.js";
+export { estimateCharsPerLine, wrapText } from "./wrap.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/text/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC"}

package/dist/text/index.js

@@ -0,0 +1,5 @@
+export { escapeXml } from "./escape.js";
+export { textElement } from "./element.js";
+export { layoutStack } from "./stack.js";
+export { estimateCharsPerLine, wrapText } from "./wrap.js";
+//# sourceMappingURL=index.js.map

package/dist/text/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/text/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC,OAAO,EAAE,oBAAoB,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC"}

package/dist/text/stack.d.ts

@@ -0,0 +1,24 @@
+/**
+ * A single line to place in a vertical stack.
+ */
+export interface StackLine {
+    readonly fontSize: number;
+    /** Multiplier applied to `fontSize` for this line's total advance. */
+    readonly lineHeight?: number;
+    /** Extra space, in pixels, inserted before this line. Defaults to `0`. */
+    readonly gapBefore?: number;
+}
+/**
+ * A stack line with its computed text baseline `y` coordinate.
+ */
+export interface PlacedLine {
+    readonly y: number;
+    readonly index: number;
+}
+/**
+ * Vertically centre a stack of lines within `[top, bottom]` and return the
+ * text baseline for each. The block is centred as a whole; if it is taller
+ * than the available area it simply starts at `top`.
+ */
+export declare function layoutStack(lines: readonly StackLine[], top: number, bottom: number): PlacedLine[];
+//# sourceMappingURL=stack.d.ts.map

package/dist/text/stack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stack.d.ts","sourceRoot":"","sources":["../../src/text/stack.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,sEAAsE;IACtE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,0EAA0E;IAC1E,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,SAAS,SAAS,EAAE,EAC3B,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,GACb,UAAU,EAAE,CAed"}

package/dist/text/stack.js

@@ -0,0 +1,18 @@
+/**
+ * Vertically centre a stack of lines within `[top, bottom]` and return the
+ * text baseline for each. The block is centred as a whole; if it is taller
+ * than the available area it simply starts at `top`.
+ */
+export function layoutStack(lines, top, bottom) {
+    const advances = lines.map((line) => (line.gapBefore ?? 0) + line.fontSize * (line.lineHeight ?? 1.2));
+    const total = advances.reduce((sum, advance) => sum + advance, 0);
+    let cursor = top + Math.max(0, (bottom - top - total) / 2);
+    return lines.map((line, index) => {
+        // Approximate the ascent as 80% of the font size to sit the baseline
+        // sensibly within each line's advance box, after any leading gap.
+        const baseline = cursor + (line.gapBefore ?? 0) + line.fontSize * 0.8;
+        cursor += advances[index] ?? 0;
+        return { y: Math.round(baseline), index };
+    });
+}
+//# sourceMappingURL=stack.js.map

package/dist/text/stack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stack.js","sourceRoot":"","sources":["../../src/text/stack.ts"],"names":[],"mappings":"AAmBA;;;;GAIG;AACH,MAAM,UAAU,WAAW,CACzB,KAA2B,EAC3B,GAAW,EACX,MAAc;IAEd,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CACxB,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,QAAQ,GAAG,CAAC,IAAI,CAAC,UAAU,IAAI,GAAG,CAAC,CAC3E,CAAC;IACF,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE,CAAC,GAAG,GAAG,OAAO,EAAE,CAAC,CAAC,CAAC;IAElE,IAAI,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,MAAM,GAAG,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;IAE3D,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QAC/B,qEAAqE;QACrE,kEAAkE;QAClE,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,QAAQ,GAAG,GAAG,CAAC;QACtE,MAAM,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC/B,OAAO,EAAE,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,CAAC;IAC5C,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/text/wrap.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Naive greedy word-wrap by character count. Words longer than the limit are
+ * kept intact on their own line rather than being split.
+ */
+export declare function wrapText(text: string, charactersPerLine: number): string[];
+/**
+ * Estimate how many characters of the given font size fit within `widthPx`.
+ * The `widthFactor` approximates average glyph width as a fraction of the font
+ * size (bolder/wider faces want a larger factor).
+ */
+export declare function estimateCharsPerLine(widthPx: number, fontSize: number, widthFactor?: number): number;
+//# sourceMappingURL=wrap.d.ts.map

package/dist/text/wrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrap.d.ts","sourceRoot":"","sources":["../../src/text/wrap.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,GAAG,MAAM,EAAE,CAsB1E;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,WAAW,SAAO,GACjB,MAAM,CAER"}

package/dist/text/wrap.js

@@ -0,0 +1,33 @@
+/**
+ * Naive greedy word-wrap by character count. Words longer than the limit are
+ * kept intact on their own line rather than being split.
+ */
+export function wrapText(text, charactersPerLine) {
+    const limit = Math.max(1, Math.floor(charactersPerLine));
+    const words = text.split(/\s+/).filter((word) => word !== "");
+    const lines = [];
+    let currentLine = "";
+    for (const word of words) {
+        const nextLine = currentLine === "" ? word : `${currentLine} ${word}`;
+        if (nextLine.length > limit && currentLine !== "") {
+            lines.push(currentLine);
+            currentLine = word;
+        }
+        else {
+            currentLine = nextLine;
+        }
+    }
+    if (currentLine !== "") {
+        lines.push(currentLine);
+    }
+    return lines;
+}
+/**
+ * Estimate how many characters of the given font size fit within `widthPx`.
+ * The `widthFactor` approximates average glyph width as a fraction of the font
+ * size (bolder/wider faces want a larger factor).
+ */
+export function estimateCharsPerLine(widthPx, fontSize, widthFactor = 0.58) {
+    return Math.max(1, Math.floor(widthPx / (fontSize * widthFactor)));
+}
+//# sourceMappingURL=wrap.js.map

package/dist/text/wrap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrap.js","sourceRoot":"","sources":["../../src/text/wrap.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAY,EAAE,iBAAyB;IAC9D,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,CAAC;IACzD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC;IAC9D,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,WAAW,GAAG,EAAE,CAAC;IAErB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,QAAQ,GAAG,WAAW,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,WAAW,IAAI,IAAI,EAAE,CAAC;QAEtE,IAAI,QAAQ,CAAC,MAAM,GAAG,KAAK,IAAI,WAAW,KAAK,EAAE,EAAE,CAAC;YAClD,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YACxB,WAAW,GAAG,IAAI,CAAC;QACrB,CAAC;aAAM,CAAC;YACN,WAAW,GAAG,QAAQ,CAAC;QACzB,CAAC;IACH,CAAC;IAED,IAAI,WAAW,KAAK,EAAE,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC1B,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAClC,OAAe,EACf,QAAgB,EAChB,WAAW,GAAG,IAAI;IAElB,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,QAAQ,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;AACrE,CAAC"}

package/dist/types.d.ts

@@ -9,8 +9,10 @@ export interface Dimensions {
  * A named output size. The `name` identifies the size in output filenames
  * (e.g. `og`, `square`) and must be unique within a config, so every
  * generated image gets a distinct, descriptive filename.
+ *
+ * A size may also carry {@link SizeOverrides}, applied only when rendering it.
  */
-export interface OutputSize {
+export interface OutputSize extends SizeOverrides {
     readonly name: string;
     readonly width: number;
     readonly height: number;
@@ -75,7 +77,10 @@ export interface Badge {
 export interface CodeStyle {
     /** Shiki theme name, e.g. `github-dark`, `monokai`, `catppuccin-mocha`. */
     readonly theme?: string;
-    /** Monospace font stack. Must resolve to a font available to `sharp`. */
+    /**
+     * Monospace font stack. Must resolve to a configured font, or to an
+     * installed one when `systemFonts` is on.
+     */
     readonly fontFamily?: string;
     /**
      * Glyph advance width as a fraction of the font size. `0.6` matches most
@@ -100,6 +105,31 @@ export interface CodeStyle {
      */
     readonly minFontScale?: number;
 }
+/**
+ * A font to load into the rasteriser, given either as a file path or as the
+ * font's bytes. Supply one entry per font file: weight and style are read from
+ * the file itself, so a bold and a regular face are two entries, and the SVG's
+ * `font-weight` picks between them.
+ *
+ * `family` is optional and does not affect matching — the family name in the
+ * font file does that. When given on the first font it seeds `fontFamily`,
+ * which saves repeating the name for the common single-font case.
+ */
+export type FontSource = {
+    readonly family?: string;
+    /**
+     * Path to a `.ttf`, `.otf`, `.ttc` or `.otc` file, resolved from the
+     * current working directory when relative.
+     */
+    readonly path: string;
+} | {
+    readonly family?: string;
+    /**
+     * The font file's bytes, for fonts loaded from a bundle or fetched at
+     * build time rather than read from disk.
+     */
+    readonly data: Uint8Array;
+};
 /**
  * Image properties, typically read from a post's frontmatter. The schema is
  * intentionally open: templates read whatever fields they understand, so a
@@ -113,6 +143,192 @@ export interface MetaImageProps {
     readonly version?: string | number;
     readonly [key: string]: unknown;
 }
+/**
+ * Build image props from a post's whole frontmatter, so a project can use the
+ * fields it already has rather than adding a props block to every file.
+ *
+ * Return `undefined` to leave a post without images. That is the filter for
+ * drafts, section indexes and anything else in the tree that is not a page
+ * worth sharing — without it, mapping frontmatter would mean an image for every
+ * markdown file there is. It only settles posts that say nothing for
+ * themselves, though: one declaring a props block is rendered either way, since
+ * asking for an image outright beats a blanket rule.
+ *
+ * The returned fields need not be complete: they are merged under whatever the
+ * post declares explicitly, and a missing template falls back to
+ * {@link ContentOptions.defaultTemplate}.
+ */
+export type PropsFromFrontmatter = (frontmatter: Record<string, unknown>) => Record<string, unknown> | undefined;
+/**
+ * How a post's slug — the base name for its images — is derived from its path
+ * when the frontmatter does not declare one.
+ *
+ * - `basename`: the filename without extension, or the parent directory for
+ *   `index.*`. Suits page bundles, where the image sits beside the content.
+ * - `route`: the whole path without extension, with `index.*` standing for its
+ *   directory, so `services/iam/index.md` becomes `services/iam` and a root
+ *   `index.md` becomes `index`. Suits a site addressed by route.
+ */
+export type SlugStrategy = "basename" | "route";
+/**
+ * How to read image props out of a content tree. Every field is optional.
+ *
+ * This is the host-project half of the job — finding posts and understanding
+ * their frontmatter — and is deliberately absent from {@link ResolvedConfig}:
+ * a template is handed the resolved config, and where the props came from is
+ * none of its business.
+ */
+export interface ContentOptions {
+    /** Frontmatter key holding the image props object. Default `meta_img_props`. */
+    readonly propsKey?: string;
+    /** Field within the props object naming the template. Default `template`. */
+    readonly templateField?: string;
+    /** Template to use when the template field is absent. */
+    readonly defaultTemplate?: string;
+    /**
+     * Derive props from a post's existing frontmatter, for a site whose posts
+     * already carry the fields an image needs under different names. An explicit
+     * props object still wins field by field, so per-post overrides keep working.
+     */
+    readonly props?: PropsFromFrontmatter;
+    /**
+     * Top-level frontmatter field to read the post slug from (used as the base
+     * filename). Default `slug`; falls back to the file/directory name.
+     */
+    readonly slugField?: string;
+    /**
+     * How to derive a slug from a post's path when its frontmatter declares
+     * none. Default `basename`.
+     */
+    readonly slugStrategy?: SlugStrategy;
+    /** File extensions to include. Default `.md` and `.markdown`. */
+    readonly extensions?: readonly string[];
+}
+/**
+ * A discovered content file with the image props read from its frontmatter.
+ *
+ * It lives here rather than with the walker so that {@link Placement} can name
+ * it without the config module depending on the content module, for the reason
+ * {@link ContentOptions} does.
+ */
+export interface ContentFile {
+    /** Path relative to the walk `dir`. */
+    readonly contentPath: string;
+    /** Absolute path on disk. */
+    readonly absolutePath: string;
+    /** Base filename for this post's images (frontmatter slug, or path-derived). */
+    readonly slug: string;
+    readonly props: MetaImageProps;
+}
+/**
+ * Where an image is written, and the URL it is served at once it is.
+ *
+ * `outputPath` alone says where the bytes go and nothing about how anyone
+ * reaches them, so every site ends up rebuilding that mapping in its own
+ * templates — from information Colophon had at generate time and threw away.
+ *
+ * - `beside-content`: next to the post, which is the page-bundle convention
+ *   and what Colophon has always done. Still the default.
+ * - `public-dir`: gathered into one directory, as Astro, Eleventy and Vite
+ *   expect. A slug carrying directories keeps them underneath it.
+ * - `custom`: for a site whose mapping is its own — images under a dated
+ *   directory, say.
+ *
+ * `urlBase` is what makes a URL: it is prefixed to the image's path under the
+ * root that placed it, and without one there is no URL, because no directory
+ * on disk says by itself how it is served. It can be a site-relative path
+ * (`/og`) or an absolute one, for images served from a CDN.
+ *
+ * `hash` puts a digest of the image's inputs in its filename, so that changing
+ * a post gives its image a URL nobody has cached yet. It is opt-in because it
+ * also means the filename moves whenever the image does, which not every setup
+ * wants. `custom` has no say in it: a placement naming its own paths is the
+ * one that can hash them itself.
+ */
+export type Placement = {
+    readonly strategy: "beside-content";
+    readonly urlBase?: string;
+    readonly hash?: boolean;
+} | {
+    readonly strategy: "public-dir";
+    /** Directory to gather images into, relative to the working directory. */
+    readonly dir: string;
+    readonly urlBase?: string;
+    readonly hash?: boolean;
+} | {
+    readonly strategy: "custom";
+    readonly path: (file: ContentFile, size: OutputSize) => string;
+    /** Omit for images that are written but not served. */
+    readonly url?: (file: ContentFile, size: OutputSize) => string | undefined;
+};
+/**
+ * One image in the manifest.
+ *
+ * The dimensions are the ones it was actually rendered at, which is the point:
+ * sites hardcode 1200 and 630 into their meta tags because nothing told them
+ * otherwise, and a size they later change leaves the tags behind.
+ */
+export interface ManifestImage {
+    /** Absent where the placement knows no URL — see {@link Placement}. */
+    readonly url?: string;
+    readonly width: number;
+    readonly height: number;
+}
+/** One page's images, keyed by output size name. */
+export interface ManifestPage {
+    readonly images: Readonly<Record<string, ManifestImage>>;
+    /**
+     * The name of the most landscape image, by aspect ratio, with ties going to
+     * the first size configured. It is what a `summary_large_image` card wants,
+     * and picking it is a check every site currently writes for itself.
+     */
+    readonly widest: string;
+    /** Alt text, from the props' title. Absent for a page that has no title. */
+    readonly alt?: string;
+}
+/**
+ * What a build generated, for the site to read back: a JSON file listing every
+ * page's images, their URLs and the dimensions they were rendered at.
+ *
+ * Without it a site reconstructs all of that in template code — globbing for
+ * `*-og.png` to find the landscape variant, or writing image paths back into
+ * each post's frontmatter. All of it is known while generating.
+ *
+ * Pages are keyed by slug, which is what a site addresses a page by: with
+ * `slugStrategy: "route"` that is the route itself.
+ */
+export interface Manifest {
+    /** Schema version, so a reader can tell what it is holding. */
+    readonly version: 1;
+    readonly pages: Readonly<Record<string, ManifestPage>>;
+}
+/**
+ * One `<meta>` tag, as the attributes it carries.
+ *
+ * Open Graph names its tags with `property` and Twitter with `name`, which is
+ * a distinction sites get wrong routinely. Keeping them apart in the type
+ * means a component can spread a tag — `<meta {...tag} />` — and be right
+ * either way.
+ */
+export type MetaTag = {
+    readonly property: string;
+    readonly content: string;
+} | {
+    readonly name: string;
+    readonly content: string;
+};
+/** Options for {@link MetaTag} generation. */
+export interface MetaTagOptions {
+    /**
+     * Absolute base for a site-relative image URL, e.g. `https://example.com`.
+     *
+     * Open Graph wants an absolute URL — a crawler has no page to resolve a
+     * relative one against — and a manifest records whatever the placement's
+     * `urlBase` said, which is usually site-relative. A URL that is already
+     * absolute is left alone, so a CDN base needs nothing here.
+     */
+    readonly baseUrl?: string;
+}
 /**
  * Reports something a template had to compromise on — code truncated to stay
  * legible, so far. Rendering carries on regardless: a share image is worth
@@ -149,6 +365,24 @@ export interface ColophonConfig {
     readonly colors?: BrandColors;
     /** Explicit background, overriding the gradient derived from `colors`. */
     readonly background?: Background;
+    /**
+     * Fonts to load into the rasteriser, so the output does not depend on what
+     * the build machine happens to have installed. Supplying any font turns
+     * {@link ColophonConfig.systemFonts} off by default, which is the point:
+     * a laptop, CI and a Docker image then render the same image.
+     */
+    readonly fonts?: readonly FontSource[];
+    /**
+     * Whether to also load the machine's installed fonts. Defaults to `true`
+     * when no `fonts` are configured (nothing else would render) and `false`
+     * when they are. Turn it on alongside `fonts` to fall back to system fonts
+     * for families you have not supplied — at the cost of determinism.
+     */
+    readonly systemFonts?: boolean;
+    /**
+     * Font stack for template text. Defaults to the `family` of the first
+     * configured font, or to `DEFAULT_FONT_FAMILY` when there is none.
+     */
     readonly fontFamily?: string;
     /** Footer text drawn along the bottom edge. Omit (the default) for none. */
     readonly footer?: string;
@@ -168,6 +402,93 @@ export interface ColophonConfig {
     readonly sizes?: readonly OutputSize[];
     /** Extra templates, merged over (and able to override) the built-ins. */
     readonly templates?: Readonly<Record<string, Template>>;
+    /**
+     * How to read props out of the content tree. Used by `generate` and the CLI;
+     * the render core never sees it.
+     */
+    readonly content?: ContentOptions;
+    /**
+     * Where images are written and what URL they end up at. Defaults to
+     * `beside-content`, which is what Colophon did before there was a choice.
+     */
+    readonly placement?: Placement;
+    /**
+     * Where to write a {@link Manifest} of everything the build generated,
+     * relative to the working directory. Omit (the default) to write none.
+     *
+     * Somewhere the site reads data from: `data/colophon.json` for Hugo,
+     * `src/data/` for Astro, `_data/` for Eleventy and Jekyll.
+     */
+    readonly manifest?: string;
+    /**
+     * One-off images that belong to the project rather than to any post — a
+     * package card, a repository social preview. Rendered by the same build, and
+     * skipped or re-rendered on the same stamps.
+     */
+    readonly extra?: readonly ExtraImage[];
+}
+/**
+ * A function a config module may export instead of a config object, so that a
+ * config which has to compute something — brand colours read out of the site's
+ * own stylesheet, say — can still be a config module rather than a script.
+ *
+ * It takes no arguments. Anything it might be handed is either already on the
+ * command line or a decision the config itself is making.
+ */
+export type ColophonConfigFactory = () => ColophonConfig | Promise<ColophonConfig>;
+/** What a config module's default export may be. */
+export type ColophonConfigInput = ColophonConfig | ColophonConfigFactory;
+/**
+ * Config an {@link OutputSize} may override for itself.
+ *
+ * Some settings only make sense per size: `code.minFontScale` is the clearest
+ * case, because a 1:1 square and a 1.91:1 landscape have very different amounts
+ * of vertical room for the same snippet. Without this the only way to vary one
+ * is a `generate` pass per size, which walks and parses the whole content tree
+ * again for each.
+ *
+ * Only what a template reads while drawing is overridable. `fonts`,
+ * `systemFonts` and `templates` are shared build inputs rather than part of the
+ * picture; `onWarning` is where messages go, not what they say; and `sizes`
+ * inside a size would be nonsense.
+ */
+export interface SizeOverrides {
+    /**
+     * Merged over the config's `colors`, so a size can change one shade on its
+     * own — `brand` is optional here precisely because the rest are kept.
+     */
+    readonly colors?: Partial<BrandColors>;
+    /** Replaces the config's background outright — see the note on merging. */
+    readonly background?: Background;
+    readonly fontFamily?: string;
+    readonly footer?: string;
+    readonly badge?: Badge;
+    /** Merged over the config's `code`, so a size can change one setting. */
+    readonly code?: CodeStyle;
+}
+/**
+ * A single image that is not tied to a content file: props, somewhere to write
+ * it, and the size to draw it at.
+ *
+ * The alternative is a script that calls `renderMetaImages` and writes the
+ * bytes itself, which is a lot of machinery for one card — and one that keeps
+ * neither the rebuild stamps nor the build log a content image gets.
+ */
+export interface ExtraImage {
+    readonly props: MetaImageProps;
+    /**
+     * Where to write the PNG, resolved from the current working directory when
+     * relative. This image has no post to sit beside, so there is nothing to
+     * derive a path from and `generate`'s `outputPath` is not consulted.
+     */
+    readonly output: string;
+    /**
+     * The size to render at, {@link SizeOverrides} and all — an inline size is
+     * how a one-off image gets its own footer or palette without a whole entry
+     * in `sizes`. Defaults to the first configured size, since a one-off card
+     * usually wants to match the site's primary share format.
+     */
+    readonly size?: OutputSize;
 }
 /**
  * Fully-resolved configuration with all defaults applied.
@@ -175,6 +496,9 @@ export interface ColophonConfig {
 export interface ResolvedConfig {
     readonly colors: Required<BrandColors>;
     readonly background: Background;
+    /** Configured fonts, with every `path` made absolute. */
+    readonly fonts: readonly FontSource[];
+    readonly systemFonts: boolean;
     readonly fontFamily: string;
     readonly footer: string | undefined;
     readonly badge: Badge | undefined;

package/dist/types.d.ts.map

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