@kensio/colophon 2.2.0 → 2.3.0

package/dist/templates/code/clip.js

@@ -0,0 +1,44 @@
+import { ellipsis } from "./ellipsis.js";
+/**
+ * Clip a line to the columns that fit, ending it with an ellipsis. The font
+ * size is floored for legibility, so a wide enough snippet can still overrun
+ * the panel — clipping keeps it inside instead of bleeding off the image.
+ *
+ * Returns the line unchanged when it already fits, so the caller can count the
+ * clipped lines by identity.
+ */
+export function clipLine(tokens, maxColumns) {
+    const last = tokens.at(-1);
+    if (last === undefined || last.column + last.text.length <= maxColumns) {
+        return tokens;
+    }
+    const clipped = [];
+    for (const token of tokens) {
+        if (token.column >= maxColumns) {
+            break;
+        }
+        const room = maxColumns - token.column;
+        if (token.text.length <= room) {
+            clipped.push(token);
+            continue;
+        }
+        clipped.push({ ...token, text: token.text.slice(0, room - 1) + ellipsis });
+        break;
+    }
+    return clipped;
+}
+/**
+ * Clip every line to the panel width, and count how many had to give ground.
+ */
+export function clipLines(lines, maxColumns) {
+    let clipped = 0;
+    const fitted = lines.map((tokens) => {
+        const line = clipLine(tokens, maxColumns);
+        if (line !== tokens) {
+            clipped += 1;
+        }
+        return line;
+    });
+    return { lines: fitted, clipped };
+}
+//# sourceMappingURL=clip.js.map

package/dist/templates/code/clip.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clip.js","sourceRoot":"","sources":["../../../src/templates/code/clip.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC;;;;;;;GAOG;AACH,MAAM,UAAU,QAAQ,CACtB,MAA4B,EAC5B,UAAkB;IAElB,MAAM,IAAI,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAE3B,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,UAAU,EAAE,CAAC;QACvE,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,OAAO,GAAgB,EAAE,CAAC;IAEhC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,KAAK,CAAC,MAAM,IAAI,UAAU,EAAE,CAAC;YAC/B,MAAM;QACR,CAAC;QAED,MAAM,IAAI,GAAG,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC;QAEvC,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,IAAI,IAAI,EAAE,CAAC;YAC9B,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACpB,SAAS;QACX,CAAC;QAED,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,GAAG,CAAC,CAAC,GAAG,QAAQ,EAAE,CAAC,CAAC;QAC3E,MAAM;IACR,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CACvB,KAAwC,EACxC,UAAkB;IAElB,IAAI,OAAO,GAAG,CAAC,CAAC;IAEhB,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;QAClC,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QAE1C,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;YACpB,OAAO,IAAI,CAAC,CAAC;QACf,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;IAEH,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AACpC,CAAC"}

package/dist/templates/code/ellipsis.d.ts

@@ -0,0 +1,3 @@
+/** The mark a truncated line or block ends with. */
+export declare const ellipsis = "\u2026";
+//# sourceMappingURL=ellipsis.d.ts.map

package/dist/templates/code/ellipsis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ellipsis.d.ts","sourceRoot":"","sources":["../../../src/templates/code/ellipsis.ts"],"names":[],"mappings":"AAAA,oDAAoD;AACpD,eAAO,MAAM,QAAQ,WAAM,CAAC"}

package/dist/templates/code/ellipsis.js

@@ -0,0 +1,3 @@
+/** The mark a truncated line or block ends with. */
+export const ellipsis = "…";
+//# sourceMappingURL=ellipsis.js.map

package/dist/templates/code/ellipsis.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ellipsis.js","sourceRoot":"","sources":["../../../src/templates/code/ellipsis.ts"],"names":[],"mappings":"AAAA,oDAAoD;AACpD,MAAM,CAAC,MAAM,QAAQ,GAAG,GAAG,CAAC"}

package/dist/templates/code/fit.d.ts

@@ -0,0 +1,27 @@
+import type { CodeToken, HighlightedCode } from "../../highlight/index.js";
+import type { ResolvedConfig } from "../../types.js";
+/**
+ * Pick the largest font size that fits the snippet in the panel on both axes,
+ * clamped to the configured bounds.
+ *
+ * The bounds are fractions of the image *width*, not its height: a share image
+ * is scaled to fit the width of whatever feed shows it, so width is what
+ * decides whether the code ends up legible. Keying the floor to height would
+ * let a landscape image render the same snippet at half the size of its square
+ * counterpart.
+ */
+export declare function fitFontSize(highlighted: HighlightedCode, codeWidth: number, codeHeight: number, imageWidth: number, config: ResolvedConfig): number;
+/**
+ * Width of the laid-out block in characters, measured from the lines actually
+ * being drawn. Narrower than the snippet's longest line whenever that line was
+ * dropped or clipped, which keeps the panel hugged tight to what is visible.
+ */
+export declare function blockColumns(lines: readonly (readonly CodeToken[])[]): number;
+/**
+ * Drop lines that cannot fit at the chosen font size, marking the truncation
+ * with an ellipsis line so the image never silently misrepresents the snippet.
+ * The marker takes the indentation of the first dropped line, so it reads as
+ * part of the block rather than as a stray mark in the left margin.
+ */
+export declare function fitLines(lines: readonly (readonly CodeToken[])[], codeHeight: number, step: number): readonly (readonly CodeToken[])[];
+//# sourceMappingURL=fit.d.ts.map

package/dist/templates/code/fit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fit.d.ts","sourceRoot":"","sources":["../../../src/templates/code/fit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAGrD;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CACzB,WAAW,EAAE,eAAe,EAC5B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,cAAc,GACrB,MAAM,CAWR;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,CAAC,SAAS,SAAS,EAAE,CAAC,EAAE,GAAG,MAAM,CAY7E;AAaD;;;;;GAKG;AACH,wBAAgB,QAAQ,CACtB,KAAK,EAAE,SAAS,CAAC,SAAS,SAAS,EAAE,CAAC,EAAE,EACxC,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,GACX,SAAS,CAAC,SAAS,SAAS,EAAE,CAAC,EAAE,CAWnC"}

package/dist/templates/code/fit.js

@@ -0,0 +1,59 @@
+import { ellipsis } from "./ellipsis.js";
+/**
+ * Pick the largest font size that fits the snippet in the panel on both axes,
+ * clamped to the configured bounds.
+ *
+ * The bounds are fractions of the image *width*, not its height: a share image
+ * is scaled to fit the width of whatever feed shows it, so width is what
+ * decides whether the code ends up legible. Keying the floor to height would
+ * let a landscape image render the same snippet at half the size of its square
+ * counterpart.
+ */
+export function fitFontSize(highlighted, codeWidth, codeHeight, imageWidth, config) {
+    const { charWidthRatio, lineHeight, maxFontScale, minFontScale } = config.code;
+    const byWidth = codeWidth / (Math.max(1, highlighted.longestLine) * charWidthRatio);
+    const byHeight = codeHeight / (Math.max(1, highlighted.lines.length) * lineHeight);
+    const fitted = Math.min(byWidth, byHeight, imageWidth * maxFontScale);
+    return Math.max(1, Math.floor(Math.max(fitted, imageWidth * minFontScale)));
+}
+/**
+ * Width of the laid-out block in characters, measured from the lines actually
+ * being drawn. Narrower than the snippet's longest line whenever that line was
+ * dropped or clipped, which keeps the panel hugged tight to what is visible.
+ */
+export function blockColumns(lines) {
+    let columns = 0;
+    for (const tokens of lines) {
+        const last = tokens.at(-1);
+        if (last !== undefined) {
+            columns = Math.max(columns, last.column + last.text.length);
+        }
+    }
+    return columns;
+}
+function ellipsisToken(column) {
+    return {
+        text: ellipsis,
+        column,
+        color: undefined,
+        opacity: 0.6,
+        bold: false,
+        italic: false,
+    };
+}
+/**
+ * Drop lines that cannot fit at the chosen font size, marking the truncation
+ * with an ellipsis line so the image never silently misrepresents the snippet.
+ * The marker takes the indentation of the first dropped line, so it reads as
+ * part of the block rather than as a stray mark in the left margin.
+ */
+export function fitLines(lines, codeHeight, step) {
+    const maxLines = Math.max(1, Math.floor(codeHeight / step));
+    if (lines.length <= maxLines) {
+        return lines;
+    }
+    const kept = lines.slice(0, maxLines - 1);
+    const dropped = lines.slice(maxLines - 1).find((line) => line.length > 0);
+    return [...kept, [ellipsisToken(dropped?.[0]?.column ?? 0)]];
+}
+//# sourceMappingURL=fit.js.map

package/dist/templates/code/fit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fit.js","sourceRoot":"","sources":["../../../src/templates/code/fit.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC;;;;;;;;;GASG;AACH,MAAM,UAAU,WAAW,CACzB,WAA4B,EAC5B,SAAiB,EACjB,UAAkB,EAClB,UAAkB,EAClB,MAAsB;IAEtB,MAAM,EAAE,cAAc,EAAE,UAAU,EAAE,YAAY,EAAE,YAAY,EAAE,GAC9D,MAAM,CAAC,IAAI,CAAC;IAEd,MAAM,OAAO,GACX,SAAS,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,WAAW,CAAC,WAAW,CAAC,GAAG,cAAc,CAAC,CAAC;IACtE,MAAM,QAAQ,GACZ,UAAU,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,UAAU,CAAC,CAAC;IAEpE,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,UAAU,GAAG,YAAY,CAAC,CAAC;IACtE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,UAAU,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;AAC9E,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,KAAwC;IACnE,IAAI,OAAO,GAAG,CAAC,CAAC;IAEhB,KAAK,MAAM,MAAM,IAAI,KAAK,EAAE,CAAC;QAC3B,MAAM,IAAI,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAE3B,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,aAAa,CAAC,MAAc;IACnC,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,MAAM;QACN,KAAK,EAAE,SAAS;QAChB,OAAO,EAAE,GAAG;QACZ,IAAI,EAAE,KAAK;QACX,MAAM,EAAE,KAAK;KACd,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,QAAQ,CACtB,KAAwC,EACxC,UAAkB,EAClB,IAAY;IAEZ,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC,CAAC;IAE5D,IAAI,KAAK,CAAC,MAAM,IAAI,QAAQ,EAAE,CAAC;QAC7B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,GAAG,CAAC,CAAC,CAAC;IAC1C,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAE1E,OAAO,CAAC,GAAG,IAAI,EAAE,CAAC,aAAa,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AAC/D,CAAC"}

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

@@ -0,0 +1,12 @@
+import type { Template } from "../../types.js";
+/**
+ * Syntax-highlighted code snippet on a rounded panel over the configured
+ * background. Reads `code` and `language` from the props (as the original
+ * `image_text` / `image_lexer` frontmatter did), with an optional `title`
+ * above the panel and the configured footer below it.
+ *
+ * Highlighting uses Shiki, so token colours come from a real VS Code theme
+ * rather than being approximated.
+ */
+export declare const codeTemplate: Template;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/templates/code/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAW/C;;;;;;;;GAQG;AACH,eAAO,MAAM,YAAY,EAAE,QAuE1B,CAAC"}

package/dist/templates/code/index.js

@@ -0,0 +1,64 @@
+import { highlightCode } from "../../highlight/index.js";
+import { hasFooter } from "../footer.js";
+import { optionalString } from "../props.js";
+import { codeFooter, codeHeading } from "./chrome.js";
+import { blockColumns } from "./fit.js";
+import { fitSnippet } from "./layout.js";
+import { layoutPanel } from "./panel.js";
+import { hugPanel, panelSvg } from "./plate.js";
+import { codeBody } from "./spans.js";
+import { warnIfTruncated } from "./warn.js";
+/**
+ * Syntax-highlighted code snippet on a rounded panel over the configured
+ * background. Reads `code` and `language` from the props (as the original
+ * `image_text` / `image_lexer` frontmatter did), with an optional `title`
+ * above the panel and the configured footer below it.
+ *
+ * Highlighting uses Shiki, so token colours come from a real VS Code theme
+ * rather than being approximated.
+ */
+export const codeTemplate = {
+    name: "code",
+    async render({ props, config, dimensions }) {
+        const { width, height } = dimensions;
+        const title = optionalString(props.title);
+        const titleFs = Math.round(height * 0.045);
+        const footerFs = Math.round(height * 0.032);
+        const highlighted = await highlightCode(optionalString(props["code"]) ?? "", {
+            language: optionalString(props["language"]) ?? "text",
+            theme: optionalString(props["theme"]) ?? config.code.theme,
+            tabSize: config.code.tabSize,
+        });
+        const available = layoutPanel(dimensions, config, titleFs, footerFs, title !== undefined && title !== "", hasFooter(config));
+        const fitted = fitSnippet(highlighted, available, width, config);
+        warnIfTruncated(config, dimensions, {
+            dropped: highlighted.lines.length - fitted.lines.length,
+            clipped: fitted.clipped,
+        }, highlighted.lines.length);
+        // Shrink the panel down onto the snippet so it isn't left floating in dead
+        // space — on a landscape image especially, a wide panel holding a narrow
+        // block leaves the code marooned off to one side.
+        const panel = hugPanel(available, {
+            width: blockColumns(fitted.lines) * fitted.charWidth + fitted.padding * 2,
+            height: fitted.lines.length * fitted.step + fitted.padding * 2,
+        });
+        const body = codeBody(fitted.lines, {
+            // Code reads from the left edge, as it does in an editor. Indentation is
+            // carried by each token's column, so the snippet keeps its shape.
+            originX: panel.x + fitted.padding,
+            originY: panel.y + (panel.height - fitted.lines.length * fitted.step) / 2,
+            fontSize: fitted.fontSize,
+            charWidth: fitted.charWidth,
+            step: fitted.step,
+            fontFamily: config.code.fontFamily,
+            foreground: highlighted.foreground,
+        });
+        const shadowOffset = Math.round(Math.min(width, height) * 0.01);
+        const plate = panelSvg(panel, highlighted.background, Math.max(1, shadowOffset));
+        return (codeHeading(title, panel, titleFs, width, config) +
+            plate +
+            body +
+            codeFooter(dimensions, footerFs, config));
+    },
+};
+//# sourceMappingURL=index.js.map

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

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

package/dist/templates/code/layout.d.ts

@@ -0,0 +1,21 @@
+import type { CodeToken, HighlightedCode } from "../../highlight/index.js";
+import type { ResolvedConfig } from "../../types.js";
+import type { Panel } from "./panel.js";
+/**
+ * A snippet sized to the space it has: the lines that survived, the grid they
+ * are drawn on, and how many of them had to be clipped to get there.
+ */
+export interface FittedCode {
+    readonly lines: readonly (readonly CodeToken[])[];
+    readonly clipped: number;
+    readonly fontSize: number;
+    readonly charWidth: number;
+    readonly step: number;
+    readonly padding: number;
+}
+/**
+ * Fit a highlighted snippet into the panel it has been allotted: choose the
+ * font size, then drop and clip whatever still does not fit.
+ */
+export declare function fitSnippet(highlighted: HighlightedCode, available: Panel, imageWidth: number, config: ResolvedConfig): FittedCode;
+//# sourceMappingURL=layout.d.ts.map

package/dist/templates/code/layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../../src/templates/code/layout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAGrD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,SAAS,SAAS,EAAE,CAAC,EAAE,CAAC;IAClD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;;GAGG;AACH,wBAAgB,UAAU,CACxB,WAAW,EAAE,eAAe,EAC5B,SAAS,EAAE,KAAK,EAChB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,cAAc,GACrB,UAAU,CA6BZ"}

package/dist/templates/code/layout.js

@@ -0,0 +1,21 @@
+import { clipLines } from "./clip.js";
+import { fitFontSize, fitLines } from "./fit.js";
+/**
+ * Fit a highlighted snippet into the panel it has been allotted: choose the
+ * font size, then drop and clip whatever still does not fit.
+ */
+export function fitSnippet(highlighted, available, imageWidth, config) {
+    const inner = Math.round(Math.min(available.width, available.height) * 0.07);
+    const codeWidth = Math.max(1, available.width - inner * 2);
+    const codeHeight = Math.max(1, available.height - inner * 2);
+    const fontSize = fitFontSize(highlighted, codeWidth, codeHeight, imageWidth, config);
+    const charWidth = fontSize * config.code.charWidthRatio;
+    const step = fontSize * config.code.lineHeight;
+    const { lines, clipped } = clipLines(fitLines(highlighted.lines, codeHeight, step), Math.max(1, Math.floor(codeWidth / charWidth)));
+    // Padding reads best proportional to the text, not the panel — a snippet
+    // fitted down to a small size wants tighter margins. Only ever shrink, so
+    // the code area the font was fitted against stays valid.
+    const padding = Math.max(Math.min(inner, Math.round(fontSize * 1.6)), Math.round(inner * 0.35));
+    return { lines, clipped, fontSize, charWidth, step, padding };
+}
+//# sourceMappingURL=layout.js.map

package/dist/templates/code/layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.js","sourceRoot":"","sources":["../../../src/templates/code/layout.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAgBjD;;;GAGG;AACH,MAAM,UAAU,UAAU,CACxB,WAA4B,EAC5B,SAAgB,EAChB,UAAkB,EAClB,MAAsB;IAEtB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,EAAE,SAAS,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC;IAC7E,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,CAAC,KAAK,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC;IAC3D,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,CAAC,MAAM,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC;IAE7D,MAAM,QAAQ,GAAG,WAAW,CAC1B,WAAW,EACX,SAAS,EACT,UAAU,EACV,UAAU,EACV,MAAM,CACP,CAAC;IACF,MAAM,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC;IACxD,MAAM,IAAI,GAAG,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC;IAE/C,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,SAAS,CAClC,QAAQ,CAAC,WAAW,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,CAAC,EAC7C,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,SAAS,CAAC,CAAC,CAC/C,CAAC;IAEF,yEAAyE;IACzE,0EAA0E;IAC1E,yDAAyD;IACzD,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CACtB,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,GAAG,CAAC,CAAC,EAC3C,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,CACzB,CAAC;IAEF,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AAChE,CAAC"}

package/dist/templates/code/panel.d.ts

@@ -0,0 +1,17 @@
+import type { Dimensions, ResolvedConfig } from "../../types.js";
+/**
+ * The rounded plate the snippet is drawn on.
+ */
+export interface Panel {
+    readonly x: number;
+    readonly y: number;
+    readonly width: number;
+    readonly height: number;
+    readonly radius: number;
+}
+/**
+ * Place the code panel within the image, leaving room above for a title and
+ * below for a footer when either is present.
+ */
+export declare function layoutPanel(dimensions: Dimensions, config: ResolvedConfig, titleFontSize: number, footerFontSize: number, hasTitle: boolean, hasFooter: boolean): Panel;
+//# sourceMappingURL=panel.d.ts.map

package/dist/templates/code/panel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"panel.d.ts","sourceRoot":"","sources":["../../../src/templates/code/panel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEjE;;GAEG;AACH,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CACzB,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,cAAc,EACtB,aAAa,EAAE,MAAM,EACrB,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,OAAO,EACjB,SAAS,EAAE,OAAO,GACjB,KAAK,CAgBP"}

package/dist/templates/code/panel.js

@@ -0,0 +1,20 @@
+/**
+ * Place the code panel within the image, leaving room above for a title and
+ * below for a footer when either is present.
+ */
+export function layoutPanel(dimensions, config, titleFontSize, footerFontSize, hasTitle, hasFooter) {
+    const { width, height } = dimensions;
+    const shorter = Math.min(width, height);
+    const pad = Math.round(shorter * 0.05);
+    const gap = Math.round(shorter * 0.028);
+    const top = pad + (hasTitle ? titleFontSize + gap : 0);
+    const bottom = height - pad - (hasFooter ? footerFontSize + gap : 0);
+    return {
+        x: pad,
+        y: top,
+        width: width - pad * 2,
+        height: Math.max(1, bottom - top),
+        radius: Math.round(shorter * config.code.cornerScale),
+    };
+}
+//# sourceMappingURL=panel.js.map

package/dist/templates/code/panel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"panel.js","sourceRoot":"","sources":["../../../src/templates/code/panel.ts"],"names":[],"mappings":"AAaA;;;GAGG;AACH,MAAM,UAAU,WAAW,CACzB,UAAsB,EACtB,MAAsB,EACtB,aAAqB,EACrB,cAAsB,EACtB,QAAiB,EACjB,SAAkB;IAElB,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC;IACrC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACxC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IACvC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,KAAK,CAAC,CAAC;IAExC,MAAM,GAAG,GAAG,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,aAAa,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACvD,MAAM,MAAM,GAAG,MAAM,GAAG,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,cAAc,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAErE,OAAO;QACL,CAAC,EAAE,GAAG;QACN,CAAC,EAAE,GAAG;QACN,KAAK,EAAE,KAAK,GAAG,GAAG,GAAG,CAAC;QACtB,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC;QACjC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC;KACtD,CAAC;AACJ,CAAC"}

package/dist/templates/code/plate.d.ts

@@ -0,0 +1,15 @@
+import type { Panel } from "./panel.js";
+/**
+ * Shrink a panel onto its content, keeping it centred in the space it was
+ * allotted. Both axes are floored so a small snippet still gets a panel with
+ * presence rather than a letterbox slot or a narrow strip.
+ */
+export declare function hugPanel(available: Panel, wanted: {
+    readonly width: number;
+    readonly height: number;
+}): Panel;
+/**
+ * The panel itself: a drop shadow, then the theme-coloured surface it sits on.
+ */
+export declare function panelSvg(panel: Panel, background: string, shadowOffset: number): string;
+//# sourceMappingURL=plate.d.ts.map

package/dist/templates/code/plate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plate.d.ts","sourceRoot":"","sources":["../../../src/templates/code/plate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC;;;;GAIG;AACH,wBAAgB,QAAQ,CACtB,SAAS,EAAE,KAAK,EAChB,MAAM,EAAE;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC1D,KAAK,CAmBP;AAED;;GAEG;AACH,wBAAgB,QAAQ,CACtB,KAAK,EAAE,KAAK,EACZ,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,GACnB,MAAM,CAaR"}

package/dist/templates/code/plate.js

@@ -0,0 +1,32 @@
+/**
+ * Shrink a panel onto its content, keeping it centred in the space it was
+ * allotted. Both axes are floored so a small snippet still gets a panel with
+ * presence rather than a letterbox slot or a narrow strip.
+ */
+export function hugPanel(available, wanted) {
+    const width = Math.min(available.width, Math.max(Math.round(wanted.width), Math.round(available.width * 0.55)));
+    // Floor relative to the panel's own width, so shrinking never leaves a
+    // sliver, and never taller than the space the font was fitted against.
+    const height = Math.min(available.height, Math.max(Math.round(wanted.height), Math.round(width * 0.25)));
+    return {
+        ...available,
+        x: available.x + Math.round((available.width - width) / 2),
+        y: available.y + Math.round((available.height - height) / 2),
+        width,
+        height,
+    };
+}
+/**
+ * The panel itself: a drop shadow, then the theme-coloured surface it sits on.
+ */
+export function panelSvg(panel, background, shadowOffset) {
+    const shadow = `<rect x="${String(panel.x)}" y="${String(panel.y + shadowOffset)}"` +
+        ` width="${String(panel.width)}" height="${String(panel.height)}"` +
+        ` rx="${String(panel.radius)}" fill="#000000" fill-opacity="0.22"/>`;
+    const surface = `<rect x="${String(panel.x)}" y="${String(panel.y)}"` +
+        ` width="${String(panel.width)}" height="${String(panel.height)}"` +
+        ` rx="${String(panel.radius)}" fill="${background}"` +
+        ` stroke="#ffffff" stroke-opacity="0.12"/>`;
+    return shadow + surface;
+}
+//# sourceMappingURL=plate.js.map

package/dist/templates/code/plate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plate.js","sourceRoot":"","sources":["../../../src/templates/code/plate.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CACtB,SAAgB,EAChB,MAA2D;IAE3D,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CACpB,SAAS,CAAC,KAAK,EACf,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,CACvE,CAAC;IACF,uEAAuE;IACvE,uEAAuE;IACvE,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CACrB,SAAS,CAAC,MAAM,EAChB,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,CAC9D,CAAC;IAEF,OAAO;QACL,GAAG,SAAS;QACZ,CAAC,EAAE,SAAS,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;QAC1D,CAAC,EAAE,SAAS,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAC5D,KAAK;QACL,MAAM;KACP,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,QAAQ,CACtB,KAAY,EACZ,UAAkB,EAClB,YAAoB;IAEpB,MAAM,MAAM,GACV,YAAY,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,YAAY,CAAC,GAAG;QACpE,WAAW,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,aAAa,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG;QAClE,QAAQ,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,wCAAwC,CAAC;IAEvE,MAAM,OAAO,GACX,YAAY,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG;QACrD,WAAW,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,aAAa,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG;QAClE,QAAQ,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,WAAW,UAAU,GAAG;QACpD,2CAA2C,CAAC;IAE9C,OAAO,MAAM,GAAG,OAAO,CAAC;AAC1B,CAAC"}

package/dist/templates/code/spans.d.ts

@@ -0,0 +1,19 @@
+import type { CodeToken } from "../../highlight/index.js";
+/**
+ * Where and how the snippet's character grid is drawn.
+ */
+export interface GridMetrics {
+    readonly originX: number;
+    readonly originY: number;
+    readonly fontSize: number;
+    readonly charWidth: number;
+    readonly step: number;
+    readonly fontFamily: string;
+    readonly foreground: string;
+}
+/**
+ * The snippet as one `<text>` element per line, each token positioned
+ * absolutely from its character column so indentation survives SVG text flow.
+ */
+export declare function codeBody(lines: readonly (readonly CodeToken[])[], metrics: GridMetrics): string;
+//# sourceMappingURL=spans.d.ts.map

package/dist/templates/code/spans.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spans.d.ts","sourceRoot":"","sources":["../../../src/templates/code/spans.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AA2B1D;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CACtB,KAAK,EAAE,SAAS,CAAC,SAAS,SAAS,EAAE,CAAC,EAAE,EACxC,OAAO,EAAE,WAAW,GACnB,MAAM,CAyBR"}

package/dist/templates/code/spans.js

@@ -0,0 +1,36 @@
+import { escapeXml } from "../../text/index.js";
+/** Fraction of the font size the baseline sits below the glyph box top. */
+const ascentRatio = 0.78;
+function tokenSpan(token, x, charWidth, foreground) {
+    const fill = token.color ?? foreground;
+    const opacity = token.opacity === undefined
+        ? ""
+        : ` fill-opacity="${String(token.opacity)}"`;
+    const weight = token.bold ? ` font-weight="700"` : "";
+    const style = token.italic ? ` font-style="italic"` : "";
+    return (`<tspan x="${String(Math.round(x + token.column * charWidth))}"` +
+        ` fill="${fill}"${opacity}${weight}${style}>` +
+        `${escapeXml(token.text)}</tspan>`);
+}
+/**
+ * The snippet as one `<text>` element per line, each token positioned
+ * absolutely from its character column so indentation survives SVG text flow.
+ */
+export function codeBody(lines, metrics) {
+    const { originX, originY, fontSize, charWidth, step } = metrics;
+    return lines
+        .map((tokens, index) => {
+        if (tokens.length === 0) {
+            return "";
+        }
+        const baseline = Math.round(originY + index * step + (step - fontSize) / 2 + fontSize * ascentRatio);
+        const spans = tokens
+            .map((token) => tokenSpan(token, originX, charWidth, metrics.foreground))
+            .join("");
+        return (`<text y="${String(baseline)}" xml:space="preserve"` +
+            ` font-family="${escapeXml(metrics.fontFamily)}"` +
+            ` font-size="${String(fontSize)}">${spans}</text>`);
+    })
+        .join("");
+}
+//# sourceMappingURL=spans.js.map

package/dist/templates/code/spans.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spans.js","sourceRoot":"","sources":["../../../src/templates/code/spans.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEhD,2EAA2E;AAC3E,MAAM,WAAW,GAAG,IAAI,CAAC;AAEzB,SAAS,SAAS,CAChB,KAAgB,EAChB,CAAS,EACT,SAAiB,EACjB,UAAkB;IAElB,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,IAAI,UAAU,CAAC;IACvC,MAAM,OAAO,GACX,KAAK,CAAC,OAAO,KAAK,SAAS;QACzB,CAAC,CAAC,EAAE;QACJ,CAAC,CAAC,kBAAkB,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;IACjD,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,EAAE,CAAC;IACtD,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,EAAE,CAAC;IAEzD,OAAO,CACL,aAAa,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC,GAAG;QAChE,UAAU,IAAI,IAAI,OAAO,GAAG,MAAM,GAAG,KAAK,GAAG;QAC7C,GAAG,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CACnC,CAAC;AACJ,CAAC;AAeD;;;GAGG;AACH,MAAM,UAAU,QAAQ,CACtB,KAAwC,EACxC,OAAoB;IAEpB,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC;IAEhE,OAAO,KAAK;SACT,GAAG,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE;QACrB,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CACzB,OAAO,GAAG,KAAK,GAAG,IAAI,GAAG,CAAC,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,QAAQ,GAAG,WAAW,CACxE,CAAC;QACF,MAAM,KAAK,GAAG,MAAM;aACjB,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CACb,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,UAAU,CAAC,CACzD;aACA,IAAI,CAAC,EAAE,CAAC,CAAC;QAEZ,OAAO,CACL,YAAY,MAAM,CAAC,QAAQ,CAAC,wBAAwB;YACpD,iBAAiB,SAAS,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG;YACjD,eAAe,MAAM,CAAC,QAAQ,CAAC,KAAK,KAAK,SAAS,CACnD,CAAC;IACJ,CAAC,CAAC;SACD,IAAI,CAAC,EAAE,CAAC,CAAC;AACd,CAAC"}

package/dist/templates/code/warn.d.ts

@@ -0,0 +1,11 @@
+import type { Dimensions, ResolvedConfig } from "../../types.js";
+/**
+ * Tell the author when the snippet did not fit. Nothing in a finished image
+ * says the sample continued, so silent truncation is how a half-a-function
+ * share card ends up on someone else's timeline.
+ */
+export declare function warnIfTruncated(config: ResolvedConfig, dimensions: Dimensions, counts: {
+    readonly dropped: number;
+    readonly clipped: number;
+}, total: number): void;
+//# sourceMappingURL=warn.d.ts.map

package/dist/templates/code/warn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"warn.d.ts","sourceRoot":"","sources":["../../../src/templates/code/warn.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAMjE;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,cAAc,EACtB,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE;IAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EAC9D,KAAK,EAAE,MAAM,GACZ,IAAI,CAoBN"}

package/dist/templates/code/warn.js

@@ -0,0 +1,24 @@
+function plural(count, noun) {
+    return `${String(count)} ${noun}${count === 1 ? "" : "s"}`;
+}
+/**
+ * Tell the author when the snippet did not fit. Nothing in a finished image
+ * says the sample continued, so silent truncation is how a half-a-function
+ * share card ends up on someone else's timeline.
+ */
+export function warnIfTruncated(config, dimensions, counts, total) {
+    const parts = [];
+    if (counts.dropped > 0) {
+        parts.push(`${String(counts.dropped)} of ${plural(total, "line")} dropped`);
+    }
+    if (counts.clipped > 0) {
+        parts.push(`${plural(counts.clipped, "line")} clipped to the panel width`);
+    }
+    if (parts.length === 0) {
+        return;
+    }
+    config.onWarning(`code snippet does not fit the ${String(dimensions.width)}x${String(dimensions.height)}` +
+        ` image at a legible size: ${parts.join(", ")}.` +
+        ` Shorten the sample, or lower code.minFontScale to fit it in smaller.`);
+}
+//# sourceMappingURL=warn.js.map

package/dist/templates/code/warn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"warn.js","sourceRoot":"","sources":["../../../src/templates/code/warn.ts"],"names":[],"mappings":"AAEA,SAAS,MAAM,CAAC,KAAa,EAAE,IAAY;IACzC,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,IAAI,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;AAC7D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAC7B,MAAsB,EACtB,UAAsB,EACtB,MAA8D,EAC9D,KAAa;IAEb,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,IAAI,MAAM,CAAC,OAAO,GAAG,CAAC,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;IAC9E,CAAC;IAED,IAAI,MAAM,CAAC,OAAO,GAAG,CAAC,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,6BAA6B,CAAC,CAAC;IAC7E,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO;IACT,CAAC;IAED,MAAM,CAAC,SAAS,CACd,iCAAiC,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE;QACtF,6BAA6B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;QAChD,uEAAuE,CAC1E,CAAC;AACJ,CAAC"}

package/dist/templates/footer.d.ts

@@ -0,0 +1,21 @@
+import type { ResolvedConfig } from "../types.js";
+/**
+ * Where and how a template wants its footer drawn. Every template places the
+ * footer differently; what they share is that a config with no footer, or an
+ * empty one, draws nothing at all.
+ */
+export interface FooterPlacement {
+    readonly x: number;
+    readonly y: number;
+    readonly fontSize: number;
+    readonly opacity: number;
+    readonly anchor?: "start" | "middle" | "end";
+}
+/** Whether the config carries a footer worth drawing. */
+export declare function hasFooter(config: ResolvedConfig): boolean;
+/**
+ * The configured footer as a `<text>` element, or an empty string when there
+ * is none. Templates call this unconditionally and let it decide.
+ */
+export declare function footerElement(config: ResolvedConfig, placement: FooterPlacement): string;
+//# sourceMappingURL=footer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"footer.d.ts","sourceRoot":"","sources":["../../src/templates/footer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;CAC9C;AAED,yDAAyD;AACzD,wBAAgB,SAAS,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAEzD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,cAAc,EACtB,SAAS,EAAE,eAAe,GACzB,MAAM,CAeR"}

package/dist/templates/footer.js

@@ -0,0 +1,25 @@
+import { textElement } from "../text/index.js";
+/** Whether the config carries a footer worth drawing. */
+export function hasFooter(config) {
+    return config.footer !== undefined && config.footer !== "";
+}
+/**
+ * The configured footer as a `<text>` element, or an empty string when there
+ * is none. Templates call this unconditionally and let it decide.
+ */
+export function footerElement(config, placement) {
+    if (!hasFooter(config)) {
+        return "";
+    }
+    return textElement(config.footer ?? "", {
+        x: placement.x,
+        y: placement.y,
+        fontFamily: config.fontFamily,
+        fontSize: placement.fontSize,
+        fontWeight: 500,
+        fill: config.colors.foreground,
+        fillOpacity: placement.opacity,
+        ...(placement.anchor !== undefined && { anchor: placement.anchor }),
+    });
+}
+//# sourceMappingURL=footer.js.map

package/dist/templates/footer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"footer.js","sourceRoot":"","sources":["../../src/templates/footer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAgB/C,yDAAyD;AACzD,MAAM,UAAU,SAAS,CAAC,MAAsB;IAC9C,OAAO,MAAM,CAAC,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,MAAM,KAAK,EAAE,CAAC;AAC7D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAC3B,MAAsB,EACtB,SAA0B;IAE1B,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;QACvB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,WAAW,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,EAAE;QACtC,CAAC,EAAE,SAAS,CAAC,CAAC;QACd,CAAC,EAAE,SAAS,CAAC,CAAC;QACd,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,QAAQ,EAAE,SAAS,CAAC,QAAQ;QAC5B,UAAU,EAAE,GAAG;QACf,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,UAAU;QAC9B,WAAW,EAAE,SAAS,CAAC,OAAO;QAC9B,GAAG,CAAC,SAAS,CAAC,MAAM,KAAK,SAAS,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,CAAC;KACpE,CAAC,CAAC;AACL,CAAC"}

package/dist/templates/index.d.ts

@@ -4,8 +4,8 @@ import type { Template } from "../types.js";
  * via `config.templates`.
  */
 export declare const builtinTemplates: Readonly<Record<string, Template>>;
-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.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/templates/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAK5C;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAI/D,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.d.ts","sourceRoot":"","sources":["../../src/templates/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAK5C;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAI/D,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"}