@kensio/colophon 2.5.0 → 2.7.0

package/dist/fonts.js

@@ -1,102 +0,0 @@
-import { createHash } from "node:crypto";
-import { existsSync, statSync } from "node:fs";
-import { mkdir, writeFile } from "node:fs/promises";
-import os from "node:os";
-import path from "node:path";
-/**
- * Directory in-memory fonts are written to. The rasteriser takes file paths
- * only, so a font supplied as bytes has to land on disk somewhere; the temp
- * directory keeps it out of the user's project.
- */
-const materialisedDir = path.join(os.tmpdir(), "colophon-fonts");
-/**
- * In-flight and completed writes of in-memory fonts, keyed by content hash.
- * A build renders many images from one config, so the same bytes would
- * otherwise be written once per image.
- */
-const materialised = new Map();
-function label(index) {
-    return `fonts[${String(index)}]`;
-}
-/**
- * Validate one font source and make its path absolute.
- *
- * The rasteriser ignores a font file it cannot read and renders the text in
- * whatever else it has loaded — or, with system fonts off, renders no text at
- * all. A typo in a path would therefore show up as a blank image rather than
- * an error, so the path is checked here instead.
- */
-function resolveFont(font, index) {
-    const source = font;
-    const hasPath = source.path !== undefined;
-    const hasData = source.data !== undefined;
-    if (hasPath && hasData) {
-        throw new Error(`${label(index)} has both "path" and "data"; give one or the other.`);
-    }
-    if (source.data !== undefined) {
-        if (source.data.byteLength === 0) {
-            throw new Error(`${label(index)} has empty font data.`);
-        }
-        return font;
-    }
-    if (source.path === undefined || source.path === "") {
-        throw new Error(`${label(index)} needs a "path" to a font file, or its bytes as "data".`);
-    }
-    const absolute = path.resolve(source.path);
-    if (!existsSync(absolute) || !statSync(absolute).isFile()) {
-        throw new Error(`${label(index)}: font file not found at ${absolute}` +
-            ` (from "${source.path}"). Relative paths resolve from the working directory.`);
-    }
-    return {
-        ...(source.family !== undefined && { family: source.family }),
-        path: absolute,
-    };
-}
-/**
- * Validate the configured fonts and make their paths absolute. Safe to call
- * with no fonts, which is the default.
- */
-export function resolveFonts(fonts) {
-    if (fonts === undefined || fonts.length === 0) {
-        return [];
-    }
-    return fonts.map((font, index) => resolveFont(font, index));
-}
-/**
- * Write font bytes to a temp file and return its path, reusing the file for
- * identical bytes. The name is the content hash, so a rebuild reuses whatever
- * an earlier run left behind and nothing has to be cleaned up.
- */
-async function materialise(data) {
-    const hash = createHash("sha256").update(data).digest("hex").slice(0, 32);
-    const pending = materialised.get(hash);
-    if (pending !== undefined) {
-        return pending;
-    }
-    const write = (async () => {
-        const file = path.join(materialisedDir, `${hash}.font`);
-        if (!existsSync(file)) {
-            await mkdir(materialisedDir, { recursive: true });
-            await writeFile(file, data);
-        }
-        return file;
-    })();
-    materialised.set(hash, write);
-    return write;
-}
-/**
- * File paths for the configured fonts, in order, writing any supplied as
- * bytes to a temp file first.
- */
-export async function fontFilePaths(fonts) {
-    return Promise.all(fonts.map(async (font) => "data" in font ? materialise(font.data) : font.path));
-}
-/**
- * The family the rasteriser should fall back to when a `font-family` names
- * something it has not loaded — the first declared family, so the fallback is
- * the same wherever the build runs rather than whichever font loaded first.
- */
-export function fallbackFamily(fonts) {
-    return fonts.find((font) => font.family !== undefined)?.family;
-}
-//# sourceMappingURL=fonts.js.map

package/dist/fonts.js.map

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

package/dist/generate.d.ts

@@ -1,63 +0,0 @@
-import type { ContentFile, WalkOptions } from "./content/index.js";
-import type { ColophonConfig, OutputSize } from "./types.js";
-/**
- * Outcome for one generated (or skipped) image.
- */
-export interface GeneratedImage {
-    readonly contentPath: string;
-    readonly size: OutputSize;
-    readonly outputPath: string;
-    /** True when an up-to-date image was left in place (no `overwrite`). */
-    readonly skipped: boolean;
-}
-/**
- * Options for {@link generate}.
- */
-export interface GenerateOptions {
-    /** Root content directory to walk. */
-    readonly contentDir: string;
-    readonly config?: ColophonConfig;
-    /** Extra walk options (props key, template field, slug field, extensions). */
-    readonly walk?: Omit<WalkOptions, "dir">;
-    /** Override where each image is written. */
-    readonly outputPath?: (file: ContentFile, size: OutputSize) => string;
-    /**
-     * Re-render every image, ignoring the stamps that would otherwise mark them
-     * as up to date. Default `false`.
-     */
-    readonly overwrite?: boolean;
-    /**
-     * How many images to render at once. Defaults to the number of CPUs the
-     * process can use. Must be a positive integer.
-     */
-    readonly concurrency?: number;
-    /** Called after each image is written or skipped. */
-    readonly onResult?: (result: GeneratedImage) => void;
-}
-/**
- * Default output path: named `<slug>-<size>.png`, alongside the content file.
- * The slug carries the post's keywords into the filename and the size name
- * keeps every image distinct (e.g. `my-post-og.png`, `my-post-square.png`).
- *
- * A slug carrying directories of its own — what the `route` strategy produces,
- * and what a frontmatter `slug` of `docs/intro` means — is written from the
- * content root instead, so its path mirrors the route. Resolving it beside the
- * file would repeat the directories that are already in the slug, putting
- * `services/iam` under `content/services/iam/`.
- */
-export declare function defaultOutputPath(file: ContentFile, size: OutputSize): string;
-/**
- * Walk a content tree and render meta images for every file that declares
- * props, writing PNGs to disk.
- *
- * Each image is stamped with a digest of the props, config and size it came
- * from, so a rebuild renders only what has actually changed: an image whose
- * stamp still matches is left alone, and one whose title, colours or template
- * has moved on is rendered again. `overwrite` ignores the stamps and renders
- * everything. Sizes with no image to render are never rasterised.
- *
- * Rendering runs `concurrency` images at a time rather than all of them, so a
- * large tree does not start hundreds of rasterisations at once.
- */
-export declare function generate(options: GenerateOptions): Promise<GeneratedImage[]>;
-//# sourceMappingURL=generate.d.ts.map

package/dist/generate.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../src/generate.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAKnE,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,wEAAwE;IACxE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,sCAAsC;IACtC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,cAAc,CAAC;IACjC,8EAA8E;IAC9E,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;IACzC,4CAA4C;IAC5C,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,UAAU,KAAK,MAAM,CAAC;IACtE;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,qDAAqD;IACrD,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,IAAI,CAAC;CACtD;AAsBD;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,UAAU,GAAG,MAAM,CAc7E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,QAAQ,CAC5B,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,cAAc,EAAE,CAAC,CA2D3B"}

package/dist/generate.js

@@ -1,109 +0,0 @@
-import { mkdir, writeFile } from "node:fs/promises";
-import { availableParallelism } from "node:os";
-import path from "node:path";
-import { resolveConfig, resolveConfigForSize } from "./config.js";
-import { walkContent } from "./content/index.js";
-import { mapConcurrent } from "./pool.js";
-import { buildSvg, renderSvgToPng } from "./render.js";
-import { createStamper, readPngStamp, stampPng } from "./stamp.js";
-/**
- * How many images to render at once when nothing is configured: one per CPU
- * the process can actually use. Rasterising is CPU-bound, so starting more
- * than that only queues the work up while holding every pending image in
- * memory.
- */
-function resolveConcurrency(concurrency) {
-    if (concurrency === undefined) {
-        return availableParallelism();
-    }
-    if (!Number.isSafeInteger(concurrency) || concurrency < 1) {
-        throw new Error(`Invalid concurrency ${String(concurrency)}; expected a positive integer.`);
-    }
-    return concurrency;
-}
-/**
- * Default output path: named `<slug>-<size>.png`, alongside the content file.
- * The slug carries the post's keywords into the filename and the size name
- * keeps every image distinct (e.g. `my-post-og.png`, `my-post-square.png`).
- *
- * A slug carrying directories of its own — what the `route` strategy produces,
- * and what a frontmatter `slug` of `docs/intro` means — is written from the
- * content root instead, so its path mirrors the route. Resolving it beside the
- * file would repeat the directories that are already in the slug, putting
- * `services/iam` under `content/services/iam/`.
- */
-export function defaultOutputPath(file, size) {
-    const name = `${file.slug}-${size.name}.png`;
-    if (!file.slug.includes("/")) {
-        return path.join(path.dirname(file.absolutePath), name);
-    }
-    // `absolutePath` ends with `contentPath` by construction, so dropping it
-    // leaves the directory the walk started from.
-    const root = file.absolutePath.slice(0, file.absolutePath.length - file.contentPath.length);
-    return path.join(root, name);
-}
-/**
- * Walk a content tree and render meta images for every file that declares
- * props, writing PNGs to disk.
- *
- * Each image is stamped with a digest of the props, config and size it came
- * from, so a rebuild renders only what has actually changed: an image whose
- * stamp still matches is left alone, and one whose title, colours or template
- * has moved on is rendered again. `overwrite` ignores the stamps and renders
- * everything. Sizes with no image to render are never rasterised.
- *
- * Rendering runs `concurrency` images at a time rather than all of them, so a
- * large tree does not start hundreds of rasterisations at once.
- */
-export async function generate(options) {
-    const resolved = resolveConfig(options.config);
-    const concurrency = resolveConcurrency(options.concurrency);
-    const toOutputPath = options.outputPath ?? defaultOutputPath;
-    // Resolved once per size rather than once per image: the overrides are the
-    // same for every post, and resolving re-reads the configured font files.
-    const configBySize = new Map(resolved.sizes.map((size) => [
-        size.name,
-        resolveConfigForSize(options.config, size),
-    ]));
-    const [stamper, files] = await Promise.all([
-        createStamper(resolved),
-        // Content options can come from the config module, which is the only route
-        // a CLI user has to them; `walk` is the programmatic override and wins.
-        walkContent({
-            dir: options.contentDir,
-            ...options.config?.content,
-            ...options.walk,
-        }),
-    ]);
-    const jobs = files.flatMap((file) => resolved.sizes.map((size) => ({ file, size })));
-    return mapConcurrent(jobs, concurrency, async ({ file, size }) => {
-        const outputPath = toOutputPath(file, size);
-        const stamp = stamper.stamp(file.props, size);
-        const isSkipped = options.overwrite !== true && (await readPngStamp(outputPath)) === stamp;
-        if (!isSkipped) {
-            const dimensions = { width: size.width, height: size.height };
-            const sizeConfig = configBySize.get(size.name) ?? resolved;
-            // Warnings name the post they came from: a build renders many images,
-            // and "shorten the sample" is no use without knowing which sample.
-            const config = {
-                ...sizeConfig,
-                onWarning: (message) => {
-                    resolved.onWarning(`${file.contentPath}: ${message}`);
-                },
-            };
-            const svg = await buildSvg(file.props, config, dimensions);
-            const png = await renderSvgToPng(svg, dimensions, config);
-            await mkdir(path.dirname(outputPath), { recursive: true });
-            await writeFile(outputPath, stampPng(png, stamp));
-        }
-        const result = {
-            contentPath: file.contentPath,
-            size,
-            outputPath,
-            skipped: isSkipped,
-        };
-        options.onResult?.(result);
-        return result;
-    });
-}
-//# sourceMappingURL=generate.js.map

package/dist/generate.js.map

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

package/dist/highlight.d.ts

@@ -1,75 +0,0 @@
-import type { BundledLanguage, BundledTheme, SpecialLanguage } from "shiki";
-/**
- * One highlighted run of text on a line, positioned by character column so the
- * renderer can lay it out on a fixed monospace grid.
- */
-export interface CodeToken {
-    readonly text: string;
-    /** Zero-based character column where this run starts. */
-    readonly column: number;
-    /** Token colour as `#rrggbb`, or `undefined` to use the theme foreground. */
-    readonly color: string | undefined;
-    /** Opacity implied by an `#rrggbbaa` token colour, if any. */
-    readonly opacity: number | undefined;
-    readonly bold: boolean;
-    readonly italic: boolean;
-}
-/**
- * A tokenised snippet ready for layout: the grid of lines, the theme's own
- * colours, and its longest line in characters.
- */
-export interface HighlightedCode {
-    readonly lines: readonly (readonly CodeToken[])[];
-    /** Theme foreground, used for tokens the grammar gives no colour. */
-    readonly foreground: string;
-    /** Theme background, used to fill the code panel. */
-    readonly background: string;
-    /** Length in characters of the longest line, for width fitting. */
-    readonly longestLine: number;
-}
-/**
- * Options for {@link highlightCode}.
- */
-export interface HighlightOptions {
-    /** Language name; unknown names fall back to plain text. */
-    readonly language: string;
-    /** Shiki theme name. */
-    readonly theme: string;
-    /** Spaces a tab expands to. */
-    readonly tabSize: number;
-}
-/**
- * Map a frontmatter language name onto one Shiki understands, falling back to
- * plain text so an unrecognised language still produces a readable image
- * rather than throwing mid-build.
- */
-export declare function resolveLanguage(language: string): BundledLanguage | SpecialLanguage;
-/**
- * Validate a configured theme name. Unlike languages — which come from post
- * frontmatter and fall back quietly — a bad theme is a config mistake worth
- * failing on.
- */
-export declare function resolveTheme(theme: string): BundledTheme;
-/**
- * Expand tabs to spaces so every character occupies one monospace cell.
- */
-export declare function expandTabs(text: string, tabSize: number): string;
-/**
- * Strip the indentation common to every non-blank line. A snippet lifted out
- * of a nested block would otherwise spend its width — the scarce dimension on
- * the landscape sizes — on indentation that carries no meaning once the
- * surrounding code is gone.
- */
-export declare function dedent(text: string): string;
-/**
- * Tokenise a snippet with Shiki and flatten it onto a character grid.
- *
- * The snippet is first normalised: surrounding blank lines trimmed, tabs
- * expanded, and common leading indentation removed.
- *
- * Whitespace-only runs are dropped and each remaining run keeps its starting
- * column, so the renderer can position every run absolutely instead of relying
- * on SVG text flow to preserve indentation.
- */
-export declare function highlightCode(code: string, options: HighlightOptions): Promise<HighlightedCode>;
-//# sourceMappingURL=highlight.d.ts.map

package/dist/highlight.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"highlight.d.ts","sourceRoot":"","sources":["../src/highlight.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,OAAO,CAAC;AAG5E;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,yDAAyD;IACzD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,6EAA6E;IAC7E,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,8DAA8D;IAC9D,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,SAAS,SAAS,EAAE,CAAC,EAAE,CAAC;IAClD,qEAAqE;IACrE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,qDAAqD;IACrD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,mEAAmE;IACnE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,4DAA4D;IAC5D,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,wBAAwB;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,+BAA+B;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAyBD;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,GACf,eAAe,GAAG,eAAe,CAOnC;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,CAQxD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAGhE;AAED;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAiB3C;AAsBD;;;;;;;;;GASG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,eAAe,CAAC,CAoD1B"}

package/dist/highlight.js

@@ -1,137 +0,0 @@
-import { bundledLanguages, bundledThemes, codeToTokens } from "shiki";
-/**
- * Language names that differ between Pygments (which the original Python
- * script used) and Shiki. Everything else is passed through — Shiki already
- * understands `bash`, `python`, `typescript`, `yaml`, `toml`, `sql`, `json`,
- * `js` and `text`.
- */
-const languageAliases = new Map([
-    ["html+handlebars", "handlebars"],
-    ["html+django", "jinja-html"],
-    ["html+jinja", "jinja-html"],
-    ["html+php", "php"],
-    ["console", "shellsession"],
-    ["shell-session", "shellsession"],
-    ["text", "plaintext"],
-    ["plain", "plaintext"],
-]);
-const plainText = "plaintext";
-// Shiki's font-style bit flags (`FontStyle` in `@shikijs/types`).
-const italicFlag = 1;
-const boldFlag = 2;
-/**
- * Map a frontmatter language name onto one Shiki understands, falling back to
- * plain text so an unrecognised language still produces a readable image
- * rather than throwing mid-build.
- */
-export function resolveLanguage(language) {
-    const normalised = language.trim().toLowerCase();
-    const aliased = languageAliases.get(normalised) ?? normalised;
-    return Object.hasOwn(bundledLanguages, aliased)
-        ? aliased
-        : plainText;
-}
-/**
- * Validate a configured theme name. Unlike languages — which come from post
- * frontmatter and fall back quietly — a bad theme is a config mistake worth
- * failing on.
- */
-export function resolveTheme(theme) {
-    if (!Object.hasOwn(bundledThemes, theme)) {
-        throw new Error(`Unknown code theme "${theme}". See https://shiki.style/themes for the available names.`);
-    }
-    return theme;
-}
-/**
- * Expand tabs to spaces so every character occupies one monospace cell.
- */
-export function expandTabs(text, tabSize) {
-    const spaces = " ".repeat(Math.max(1, Math.floor(tabSize)));
-    return text.replaceAll("\t", () => spaces);
-}
-/**
- * Strip the indentation common to every non-blank line. A snippet lifted out
- * of a nested block would otherwise spend its width — the scarce dimension on
- * the landscape sizes — on indentation that carries no meaning once the
- * surrounding code is gone.
- */
-export function dedent(text) {
-    const lines = text.split("\n");
-    let common = Infinity;
-    for (const line of lines) {
-        if (line.trim() === "") {
-            continue;
-        }
-        common = Math.min(common, line.length - line.trimStart().length);
-    }
-    if (common === 0 || !Number.isFinite(common)) {
-        return text;
-    }
-    return lines.map((line) => line.slice(common)).join("\n");
-}
-/**
- * Split an `#rrggbb` or `#rrggbbaa` colour into a fill and an optional opacity,
- * since SVG 1.1 `fill` does not accept an alpha channel.
- */
-function splitColor(color) {
-    if (color === undefined || color === "") {
-        return { color: undefined, opacity: undefined };
-    }
-    if (!/^#[0-9a-f]{8}$/i.test(color)) {
-        return { color, opacity: undefined };
-    }
-    const alpha = Number.parseInt(color.slice(7, 9), 16) / 255;
-    return { color: color.slice(0, 7), opacity: Math.round(alpha * 100) / 100 };
-}
-/**
- * Tokenise a snippet with Shiki and flatten it onto a character grid.
- *
- * The snippet is first normalised: surrounding blank lines trimmed, tabs
- * expanded, and common leading indentation removed.
- *
- * Whitespace-only runs are dropped and each remaining run keeps its starting
- * column, so the renderer can position every run absolutely instead of relying
- * on SVG text flow to preserve indentation.
- */
-export async function highlightCode(code, options) {
-    const source = dedent(expandTabs(code.replaceAll("\r\n", "\n"), options.tabSize)
-        .replace(/\n+$/, "")
-        .replace(/^\n+/, ""));
-    const result = await codeToTokens(source, {
-        lang: resolveLanguage(options.language),
-        theme: resolveTheme(options.theme),
-    });
-    let longestLine = 0;
-    const lines = result.tokens.map((tokens) => {
-        let column = 0;
-        const line = [];
-        for (const token of tokens) {
-            const start = column;
-            column += token.content.length;
-            const leading = token.content.length - token.content.trimStart().length;
-            const text = token.content.trim();
-            if (text === "") {
-                continue;
-            }
-            const { color, opacity } = splitColor(token.color);
-            const fontStyle = token.fontStyle ?? 0;
-            line.push({
-                text,
-                column: start + leading,
-                color,
-                opacity,
-                bold: (fontStyle & boldFlag) !== 0,
-                italic: (fontStyle & italicFlag) !== 0,
-            });
-        }
-        longestLine = Math.max(longestLine, column);
-        return line;
-    });
-    return {
-        lines,
-        foreground: result.fg ?? "#ffffff",
-        background: result.bg ?? "#000000",
-        longestLine,
-    };
-}
-//# sourceMappingURL=highlight.js.map

package/dist/highlight.js.map

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

package/dist/render.d.ts

@@ -1,24 +0,0 @@
-import type { ColophonConfig, Dimensions, MetaImageProps, RenderedMetaImage, ResolvedConfig } from "./types.js";
-/**
- * Build the complete SVG document for one image: the enclosing `<svg>` root,
- * the config-driven background, and the template's foreground content.
- *
- * Asynchronous because a template may need to load resources — the `code`
- * template fetches syntax grammars and themes on demand.
- */
-export declare function buildSvg(props: MetaImageProps, config: ResolvedConfig, dimensions: Dimensions): Promise<string>;
-/**
- * Rasterise an SVG string to a PNG buffer, scaled to `dimensions.width`.
- *
- * Text is drawn with the fonts named by `config`, which is what keeps the
- * output the same on a laptop, in CI and in a container. Height follows the
- * SVG's own aspect ratio; {@link buildSvg} sizes it to match.
- */
-export declare function renderSvgToPng(svg: string, dimensions: Dimensions, config?: ResolvedConfig): Promise<Buffer>;
-/**
- * Render an image for every configured output size from a single set of props.
- * This is the reusable core: it takes props and config and returns rendered
- * bytes, with no filesystem or content-discovery concerns.
- */
-export declare function renderMetaImages(props: MetaImageProps, config?: ColophonConfig): Promise<RenderedMetaImage[]>;
-//# sourceMappingURL=render.d.ts.map

package/dist/render.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../src/render.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,cAAc,EACd,UAAU,EACV,cAAc,EACd,iBAAiB,EACjB,cAAc,EAEf,MAAM,YAAY,CAAC;AAmBpB;;;;;;GAMG;AACH,wBAAsB,QAAQ,CAC5B,KAAK,EAAE,cAAc,EACrB,MAAM,EAAE,cAAc,EACtB,UAAU,EAAE,UAAU,GACrB,OAAO,CAAC,MAAM,CAAC,CAWjB;AAkBD;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,UAAU,EACtB,MAAM,GAAE,cAAgC,GACvC,OAAO,CAAC,MAAM,CAAC,CAOjB;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,cAAc,EACrB,MAAM,CAAC,EAAE,cAAc,GACtB,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAiB9B"}

package/dist/render.js

@@ -1,77 +0,0 @@
-import { renderAsync } from "@resvg/resvg-js";
-import { backgroundSvg } from "./background.js";
-import { resolveConfig, resolveConfigForSize } from "./config.js";
-import { fallbackFamily, fontFilePaths } from "./fonts.js";
-const backgroundId = "colophon-bg";
-function selectTemplate(config, name) {
-    const template = config.templates[name];
-    if (template === undefined) {
-        const available = Object.keys(config.templates)
-            .toSorted((a, b) => a.localeCompare(b))
-            .join(", ");
-        throw new Error(`Unknown template "${name}". Available templates: ${available}.`);
-    }
-    return template;
-}
-/**
- * Build the complete SVG document for one image: the enclosing `<svg>` root,
- * the config-driven background, and the template's foreground content.
- *
- * Asynchronous because a template may need to load resources — the `code`
- * template fetches syntax grammars and themes on demand.
- */
-export async function buildSvg(props, config, dimensions) {
-    const template = selectTemplate(config, props.template);
-    const background = backgroundSvg(config.background, dimensions, backgroundId);
-    const body = await template.render({ props, config, dimensions });
-    const { width, height } = dimensions;
-    return (`<svg width="${String(width)}" height="${String(height)}"` +
-        ` viewBox="0 0 ${String(width)} ${String(height)}"` +
-        ` xmlns="http://www.w3.org/2000/svg">${background}${body}</svg>`);
-}
-/**
- * Font options for the rasteriser: the configured font files, and whether to
- * fall back to the machine's own.
- */
-async function fontOptions(config) {
-    const fallback = fallbackFamily(config.fonts);
-    return {
-        loadSystemFonts: config.systemFonts,
-        fontFiles: await fontFilePaths(config.fonts),
-        ...(fallback !== undefined && { defaultFontFamily: fallback }),
-    };
-}
-/**
- * Rasterise an SVG string to a PNG buffer, scaled to `dimensions.width`.
- *
- * Text is drawn with the fonts named by `config`, which is what keeps the
- * output the same on a laptop, in CI and in a container. Height follows the
- * SVG's own aspect ratio; {@link buildSvg} sizes it to match.
- */
-export async function renderSvgToPng(svg, dimensions, config = resolveConfig()) {
-    const rendered = await renderAsync(svg, {
-        fitTo: { mode: "width", value: dimensions.width },
-        font: await fontOptions(config),
-    });
-    return rendered.asPng();
-}
-/**
- * Render an image for every configured output size from a single set of props.
- * This is the reusable core: it takes props and config and returns rendered
- * bytes, with no filesystem or content-discovery concerns.
- */
-export async function renderMetaImages(props, config) {
-    const resolved = resolveConfig(config);
-    // Validate the template once up front so a bad name fails fast.
-    selectTemplate(resolved, props.template);
-    return Promise.all(resolved.sizes.map(async (size) => {
-        // Each size renders with its own overrides folded in, so one size wanting
-        // a smaller minimum font does not mean a second pass over everything.
-        const sizeConfig = resolveConfigForSize(config, size);
-        const dimensions = { width: size.width, height: size.height };
-        const svg = await buildSvg(props, sizeConfig, dimensions);
-        const png = await renderSvgToPng(svg, dimensions, sizeConfig);
-        return { name: size.name, dimensions, svg, png };
-    }));
-}
-//# sourceMappingURL=render.js.map

package/dist/render.js.map

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