@kensio/colophon 2.2.0 → 2.3.0

package/dist/highlight/index.d.ts

@@ -0,0 +1,12 @@
+import type { HighlightedCode, HighlightOptions } from "./types.js";
+export { dedent, expandTabs } from "./normalise.js";
+export { resolveLanguage, resolveTheme } from "./language.js";
+export type { CodeToken, HighlightedCode, HighlightOptions } from "./types.js";
+/**
+ * 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.
+ */
+export declare function highlightCode(code: string, options: HighlightOptions): Promise<HighlightedCode>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/highlight/index.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEpE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC9D,YAAY,EAAE,SAAS,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE/E;;;;;GAKG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,eAAe,CAAC,CAoB1B"}

package/dist/highlight/index.js

@@ -0,0 +1,31 @@
+import { codeToTokens } from "shiki";
+import { gridLine } from "./grid.js";
+import { resolveLanguage, resolveTheme } from "./language.js";
+import { normaliseSnippet } from "./normalise.js";
+export { dedent, expandTabs } from "./normalise.js";
+export { resolveLanguage, resolveTheme } from "./language.js";
+/**
+ * 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.
+ */
+export async function highlightCode(code, options) {
+    const result = await codeToTokens(normaliseSnippet(code, options.tabSize), {
+        lang: resolveLanguage(options.language),
+        theme: resolveTheme(options.theme),
+    });
+    let longestLine = 0;
+    const lines = result.tokens.map((tokens) => {
+        const { line, width } = gridLine(tokens);
+        longestLine = Math.max(longestLine, width);
+        return line;
+    });
+    return {
+        lines,
+        foreground: result.fg ?? "#ffffff",
+        background: result.bg ?? "#000000",
+        longestLine,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/highlight/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/highlight/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAErC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAGlD,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAG9D;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,IAAY,EACZ,OAAyB;IAEzB,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,gBAAgB,CAAC,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,EAAE;QACzE,IAAI,EAAE,eAAe,CAAC,OAAO,CAAC,QAAQ,CAAC;QACvC,KAAK,EAAE,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC;KACnC,CAAC,CAAC;IAEH,IAAI,WAAW,GAAG,CAAC,CAAC;IAEpB,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;QACzC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;QACzC,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;QAC3C,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,KAAK;QACL,UAAU,EAAE,MAAM,CAAC,EAAE,IAAI,SAAS;QAClC,UAAU,EAAE,MAAM,CAAC,EAAE,IAAI,SAAS;QAClC,WAAW;KACZ,CAAC;AACJ,CAAC"}

package/dist/highlight/language.d.ts

@@ -0,0 +1,14 @@
+import type { BundledLanguage, BundledTheme, SpecialLanguage } from "shiki";
+/**
+ * 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;
+//# sourceMappingURL=language.d.ts.map

package/dist/highlight/language.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"language.d.ts","sourceRoot":"","sources":["../../src/highlight/language.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,OAAO,CAAC;AAsB5E;;;;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"}

package/dist/highlight/language.js

@@ -0,0 +1,42 @@
+import { bundledLanguages, bundledThemes } 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";
+/**
+ * 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;
+}
+//# sourceMappingURL=language.js.map

package/dist/highlight/language.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"language.js","sourceRoot":"","sources":["../../src/highlight/language.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAExD;;;;;GAKG;AACH,MAAM,eAAe,GAAgC,IAAI,GAAG,CAAC;IAC3D,CAAC,iBAAiB,EAAE,YAAY,CAAC;IACjC,CAAC,aAAa,EAAE,YAAY,CAAC;IAC7B,CAAC,YAAY,EAAE,YAAY,CAAC;IAC5B,CAAC,UAAU,EAAE,KAAK,CAAC;IACnB,CAAC,SAAS,EAAE,cAAc,CAAC;IAC3B,CAAC,eAAe,EAAE,cAAc,CAAC;IACjC,CAAC,MAAM,EAAE,WAAW,CAAC;IACrB,CAAC,OAAO,EAAE,WAAW,CAAC;CACvB,CAAC,CAAC;AAEH,MAAM,SAAS,GAAoB,WAAW,CAAC;AAE/C;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAC7B,QAAgB;IAEhB,MAAM,UAAU,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACjD,MAAM,OAAO,GAAG,eAAe,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,UAAU,CAAC;IAE9D,OAAO,MAAM,CAAC,MAAM,CAAC,gBAAgB,EAAE,OAAO,CAAC;QAC7C,CAAC,CAAE,OAA2B;QAC9B,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CACb,uBAAuB,KAAK,4DAA4D,CACzF,CAAC;IACJ,CAAC;IAED,OAAO,KAAqB,CAAC;AAC/B,CAAC"}

package/dist/highlight/normalise.d.ts

@@ -0,0 +1,17 @@
+/**
+ * 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;
+/**
+ * Normalise a snippet for layout: line endings unified, surrounding blank
+ * lines trimmed, tabs expanded and common leading indentation removed.
+ */
+export declare function normaliseSnippet(code: string, tabSize: number): string;
+//# sourceMappingURL=normalise.d.ts.map

package/dist/highlight/normalise.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalise.d.ts","sourceRoot":"","sources":["../../src/highlight/normalise.ts"],"names":[],"mappings":"AAAA;;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;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAMtE"}

package/dist/highlight/normalise.js

@@ -0,0 +1,37 @@
+/**
+ * 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");
+}
+/**
+ * Normalise a snippet for layout: line endings unified, surrounding blank
+ * lines trimmed, tabs expanded and common leading indentation removed.
+ */
+export function normaliseSnippet(code, tabSize) {
+    return dedent(expandTabs(code.replaceAll("\r\n", "\n"), tabSize)
+        .replace(/\n+$/, "")
+        .replace(/^\n+/, ""));
+}
+//# sourceMappingURL=normalise.js.map

package/dist/highlight/normalise.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalise.js","sourceRoot":"","sources":["../../src/highlight/normalise.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,OAAe;IACtD,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAC5D,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,CAAC;AAC7C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,MAAM,CAAC,IAAY;IACjC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC/B,IAAI,MAAM,GAAG,QAAQ,CAAC;IAEtB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YACvB,SAAS;QACX,CAAC;QAED,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC,MAAM,CAAC,CAAC;IACnE,CAAC;IAED,IAAI,MAAM,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAC7C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC5D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,OAAe;IAC5D,OAAO,MAAM,CACX,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC;SAC/C,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;SACnB,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CACvB,CAAC;AACJ,CAAC"}

package/dist/highlight/types.d.ts

@@ -0,0 +1,40 @@
+/**
+ * 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 `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;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/highlight/types.d.ts.map

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

package/dist/highlight/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/highlight/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/highlight/types.ts"],"names":[],"mappings":""}

package/dist/index.d.ts

@@ -1,13 +1,19 @@
-export type { Background, Badge, BrandColors, CodeStyle, ColophonConfig, Dimensions, GradientStop, MetaImageProps, OutputSize, RenderedMetaImage, ResolvedConfig, Template, TemplateContext, WarningHandler, } from "./types.js";
-export { DEFAULT_CODE_FONT_FAMILY, DEFAULT_CODE_STYLE, DEFAULT_COLORS, DEFAULT_FONT_FAMILY, DEFAULT_SIZES, defineConfig, resolveConfig, SIZE_PRESETS, } from "./config.js";
+export type { Background, Badge, BrandColors, CodeStyle, ColophonConfig, ColophonConfigFactory, ColophonConfigInput, ContentFile, ContentOptions, Dimensions, ExtraImage, FontSource, GradientStop, Manifest, ManifestImage, ManifestPage, MetaImageProps, MetaTag, MetaTagOptions, OutputSize, Placement, PropsFromFrontmatter, RenderedMetaImage, SlugStrategy, SizeOverrides, ResolvedConfig, Template, TemplateContext, WarningHandler, } from "./types.js";
+export { DEFAULT_CODE_FONT_FAMILY, DEFAULT_CODE_STYLE, DEFAULT_COLORS, DEFAULT_FONT_FAMILY, DEFAULT_SIZES, defineConfig, resolveConfig, SIZE_PRESETS, } from "./config/index.js";
+export { resolveConfigForSize } from "./config/size.js";
 export { backgroundSvg } from "./background.js";
-export { buildSvg, renderMetaImages, renderSvgToPng } from "./render.js";
+export { buildSvg, renderMetaImages, renderSvgToPng } from "./render/index.js";
 export { bannerTemplate, builtinTemplates, cardTemplate, codeTemplate, } from "./templates/index.js";
-export { dedent, expandTabs, highlightCode, resolveLanguage, } from "./highlight.js";
-export type { CodeToken, HighlightedCode, HighlightOptions, } from "./highlight.js";
-export { defaultOutputPath, generate } from "./generate.js";
-export type { GeneratedImage, GenerateOptions } from "./generate.js";
-export { escapeXml, wrapText } from "./text.js";
+export { dedent, expandTabs, highlightCode, resolveLanguage, } from "./highlight/index.js";
+export type { CodeToken, HighlightedCode, HighlightOptions, } from "./highlight/index.js";
+export { defaultOutputPath, generate } from "./generate/index.js";
+export type { GeneratedImage, GenerateOptions } from "./generate/index.js";
+export { createStamper, readPngStamp, stampPng } from "./stamp/index.js";
+export type { Stamper } from "./stamp/index.js";
+export { escapeXml, wrapText } from "./text/index.js";
 export { extractProps, slugFromPath, walkContent } from "./content/index.js";
-export type { ContentFile, WalkOptions } from "./content/index.js";
+export type { WalkOptions } from "./content/index.js";
+export { metaTags, metaTagsHtml } from "./meta/index.js";
+export { createPlacer } from "./placement/index.js";
+export type { PlacedImage, Placer } from "./placement/index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,UAAU,EACV,KAAK,EACL,WAAW,EACX,SAAS,EACT,cAAc,EACd,UAAU,EACV,YAAY,EACZ,cAAc,EACd,UAAU,EACV,iBAAiB,EACjB,cAAc,EACd,QAAQ,EACR,eAAe,EACf,cAAc,GACf,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,wBAAwB,EACxB,kBAAkB,EAClB,cAAc,EACd,mBAAmB,EACnB,aAAa,EACb,YAAY,EACZ,aAAa,EACb,YAAY,GACb,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACzE,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,YAAY,GACb,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,MAAM,EACN,UAAU,EACV,aAAa,EACb,eAAe,GAChB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,SAAS,EACT,eAAe,EACf,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC5D,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAErE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAEhD,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAC7E,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,UAAU,EACV,KAAK,EACL,WAAW,EACX,SAAS,EACT,cAAc,EACd,qBAAqB,EACrB,mBAAmB,EACnB,WAAW,EACX,cAAc,EACd,UAAU,EACV,UAAU,EACV,UAAU,EACV,YAAY,EACZ,QAAQ,EACR,aAAa,EACb,YAAY,EACZ,cAAc,EACd,OAAO,EACP,cAAc,EACd,UAAU,EACV,SAAS,EACT,oBAAoB,EACpB,iBAAiB,EACjB,YAAY,EACZ,aAAa,EACb,cAAc,EACd,QAAQ,EACR,eAAe,EACf,cAAc,GACf,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,wBAAwB,EACxB,kBAAkB,EAClB,cAAc,EACd,mBAAmB,EACnB,aAAa,EACb,YAAY,EACZ,aAAa,EACb,YAAY,GACb,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAExD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAC/E,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,YAAY,GACb,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,MAAM,EACN,UAAU,EACV,aAAa,EACb,eAAe,GAChB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,SAAS,EACT,eAAe,EACf,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAClE,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3E,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACzE,YAAY,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAEhD,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAEtD,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAC7E,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEzD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,YAAY,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -1,9 +1,13 @@
-export { DEFAULT_CODE_FONT_FAMILY, DEFAULT_CODE_STYLE, DEFAULT_COLORS, DEFAULT_FONT_FAMILY, DEFAULT_SIZES, defineConfig, resolveConfig, SIZE_PRESETS, } from "./config.js";
+export { DEFAULT_CODE_FONT_FAMILY, DEFAULT_CODE_STYLE, DEFAULT_COLORS, DEFAULT_FONT_FAMILY, DEFAULT_SIZES, defineConfig, resolveConfig, SIZE_PRESETS, } from "./config/index.js";
+export { resolveConfigForSize } from "./config/size.js";
 export { backgroundSvg } from "./background.js";
-export { buildSvg, renderMetaImages, renderSvgToPng } from "./render.js";
+export { buildSvg, renderMetaImages, renderSvgToPng } from "./render/index.js";
 export { bannerTemplate, builtinTemplates, cardTemplate, codeTemplate, } from "./templates/index.js";
-export { dedent, expandTabs, highlightCode, resolveLanguage, } from "./highlight.js";
-export { defaultOutputPath, generate } from "./generate.js";
-export { escapeXml, wrapText } from "./text.js";
+export { dedent, expandTabs, highlightCode, resolveLanguage, } from "./highlight/index.js";
+export { defaultOutputPath, generate } from "./generate/index.js";
+export { createStamper, readPngStamp, stampPng } from "./stamp/index.js";
+export { escapeXml, wrapText } from "./text/index.js";
 export { extractProps, slugFromPath, walkContent } from "./content/index.js";
+export { metaTags, metaTagsHtml } from "./meta/index.js";
+export { createPlacer } from "./placement/index.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAiBA,OAAO,EACL,wBAAwB,EACxB,kBAAkB,EAClB,cAAc,EACd,mBAAmB,EACnB,aAAa,EACb,YAAY,EACZ,aAAa,EACb,YAAY,GACb,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACzE,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,YAAY,GACb,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,MAAM,EACN,UAAU,EACV,aAAa,EACb,eAAe,GAChB,MAAM,gBAAgB,CAAC;AAOxB,OAAO,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAG5D,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAEhD,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAgCA,OAAO,EACL,wBAAwB,EACxB,kBAAkB,EAClB,cAAc,EACd,mBAAmB,EACnB,aAAa,EACb,YAAY,EACZ,aAAa,EACb,YAAY,GACb,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAExD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAC/E,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,YAAY,GACb,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,MAAM,EACN,UAAU,EACV,aAAa,EACb,eAAe,GAChB,MAAM,sBAAsB,CAAC;AAO9B,OAAO,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAGlE,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAGzE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAEtD,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAG7E,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEzD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/manifest/build.d.ts

@@ -0,0 +1,14 @@
+import type { RenderJob } from "../generate/job.js";
+import type { Manifest } from "../types.js";
+/**
+ * Build the manifest for a planned build.
+ *
+ * It is built from the jobs rather than from what was written, so a rebuild
+ * that skips every image still describes the whole site — the manifest says
+ * what exists, not what happened this time.
+ *
+ * Pages are sorted by slug, and each page's images by size name, so a manifest
+ * committed to a repository changes only when the build does.
+ */
+export declare function buildManifest(jobs: readonly RenderJob[]): Manifest;
+//# sourceMappingURL=build.d.ts.map

package/dist/manifest/build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/manifest/build.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAgC5C;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,SAAS,EAAE,GAAG,QAAQ,CASlE"}

package/dist/manifest/build.js

@@ -0,0 +1,43 @@
+import { byName } from "./order.js";
+import { addToPage, startPage, toPage } from "./page.js";
+/**
+ * Collect the jobs of each page, keyed by the slug a site addresses it by.
+ *
+ * Extras are dropped: the manifest is a map of pages, and an extra image has
+ * no page behind it. A project that named the path of one already knows where
+ * it is, which is the question this file answers for everything else.
+ */
+function drafts(jobs) {
+    const pages = new Map();
+    for (const job of jobs) {
+        if (job.slug === undefined) {
+            continue;
+        }
+        const page = pages.get(job.slug);
+        if (page === undefined) {
+            pages.set(job.slug, startPage(job));
+        }
+        else {
+            addToPage(page, job);
+        }
+    }
+    return pages;
+}
+/**
+ * Build the manifest for a planned build.
+ *
+ * It is built from the jobs rather than from what was written, so a rebuild
+ * that skips every image still describes the whole site — the manifest says
+ * what exists, not what happened this time.
+ *
+ * Pages are sorted by slug, and each page's images by size name, so a manifest
+ * committed to a repository changes only when the build does.
+ */
+export function buildManifest(jobs) {
+    const pages = [...drafts(jobs)].toSorted(([a], [b]) => byName(a, b));
+    return {
+        version: 1,
+        pages: Object.fromEntries(pages.map(([slug, page]) => [slug, toPage(slug, page)])),
+    };
+}
+//# sourceMappingURL=build.js.map

package/dist/manifest/build.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.js","sourceRoot":"","sources":["../../src/manifest/build.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEpC,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAEzD;;;;;;GAMG;AACH,SAAS,MAAM,CAAC,IAA0B;IACxC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAqB,CAAC;IAE3C,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC3B,SAAS;QACX,CAAC;QAED,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAEjC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;QACtC,CAAC;aAAM,CAAC;YACN,SAAS,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,aAAa,CAAC,IAA0B;IACtD,MAAM,KAAK,GAAG,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAErE,OAAO;QACL,OAAO,EAAE,CAAC;QACV,KAAK,EAAE,MAAM,CAAC,WAAW,CACvB,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CACxD;KACF,CAAC;AACJ,CAAC"}

package/dist/manifest/index.d.ts

@@ -0,0 +1,27 @@
+import type { Manifest } from "../types.js";
+import type { RenderJob } from "../generate/job.js";
+export { buildManifest } from "./build.js";
+/**
+ * A manifest and where it goes, or nothing when the config asked for none.
+ */
+export interface PlannedManifest {
+    readonly path: string;
+    readonly data: Manifest;
+}
+/**
+ * Work out the manifest a build will write, if any.
+ *
+ * Built while planning rather than from the results, so that a site with two
+ * pages sharing a slug hears about it before rendering the tree rather than
+ * after — the same reason the output paths are checked up front.
+ */
+export declare function planManifest(manifestPath: string | undefined, jobs: readonly RenderJob[]): PlannedManifest | undefined;
+/**
+ * Write the manifest, creating whatever directories its path needs.
+ *
+ * Indented, with a trailing newline: it is written into a site's data
+ * directory, where it is read by people as well as by templates, and a diff of
+ * one long line says nothing about what changed.
+ */
+export declare function writeManifest(manifest: PlannedManifest | undefined): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/manifest/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAGpD,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;CACzB;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,IAAI,EAAE,SAAS,SAAS,EAAE,GACzB,eAAe,GAAG,SAAS,CAI7B;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,eAAe,GAAG,SAAS,GACpC,OAAO,CAAC,IAAI,CAAC,CAUf"}

package/dist/manifest/index.js

@@ -0,0 +1,31 @@
+import { mkdir, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { buildManifest } from "./build.js";
+export { buildManifest } from "./build.js";
+/**
+ * Work out the manifest a build will write, if any.
+ *
+ * Built while planning rather than from the results, so that a site with two
+ * pages sharing a slug hears about it before rendering the tree rather than
+ * after — the same reason the output paths are checked up front.
+ */
+export function planManifest(manifestPath, jobs) {
+    return manifestPath === undefined
+        ? undefined
+        : { path: manifestPath, data: buildManifest(jobs) };
+}
+/**
+ * Write the manifest, creating whatever directories its path needs.
+ *
+ * Indented, with a trailing newline: it is written into a site's data
+ * directory, where it is read by people as well as by templates, and a diff of
+ * one long line says nothing about what changed.
+ */
+export async function writeManifest(manifest) {
+    if (manifest === undefined) {
+        return;
+    }
+    await mkdir(path.dirname(manifest.path), { recursive: true });
+    await writeFile(manifest.path, `${JSON.stringify(manifest.data, undefined, 2)}\n`);
+}
+//# sourceMappingURL=index.js.map

package/dist/manifest/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/manifest/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,IAAI,MAAM,WAAW,CAAC;AAK7B,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAU3C;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAC1B,YAAgC,EAChC,IAA0B;IAE1B,OAAO,YAAY,KAAK,SAAS;QAC/B,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC;AACxD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,QAAqC;IAErC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,OAAO;IACT,CAAC;IAED,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9D,MAAM,SAAS,CACb,QAAQ,CAAC,IAAI,EACb,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,IAAI,CACnD,CAAC;AACJ,CAAC"}

package/dist/manifest/order.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Order two names by code unit, rather than by whatever the machine's locale
+ * would say.
+ *
+ * The manifest is written into a site's repository and committed, so the order
+ * has to be the same on a laptop and on CI. `localeCompare` reads the default
+ * locale, and locales disagree about case and accented letters — a slug of
+ * `Über` or `MyPost` could sort one way in development and another in the
+ * build, leaving a diff that says nothing happened.
+ */
+export declare function byName(a: string, b: string): number;
+//# sourceMappingURL=order.d.ts.map

package/dist/manifest/order.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"order.d.ts","sourceRoot":"","sources":["../../src/manifest/order.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAMnD"}

package/dist/manifest/order.js

@@ -0,0 +1,17 @@
+/**
+ * Order two names by code unit, rather than by whatever the machine's locale
+ * would say.
+ *
+ * The manifest is written into a site's repository and committed, so the order
+ * has to be the same on a laptop and on CI. `localeCompare` reads the default
+ * locale, and locales disagree about case and accented letters — a slug of
+ * `Über` or `MyPost` could sort one way in development and another in the
+ * build, leaving a diff that says nothing happened.
+ */
+export function byName(a, b) {
+    if (a === b) {
+        return 0;
+    }
+    return a < b ? -1 : 1;
+}
+//# sourceMappingURL=order.js.map

package/dist/manifest/order.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"order.js","sourceRoot":"","sources":["../../src/manifest/order.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,UAAU,MAAM,CAAC,CAAS,EAAE,CAAS;IACzC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACZ,OAAO,CAAC,CAAC;IACX,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACxB,CAAC"}

package/dist/manifest/page.d.ts

@@ -0,0 +1,24 @@
+import type { RenderJob } from "../generate/job.js";
+import type { ManifestPage } from "../types.js";
+/**
+ * One page as it is collected: the jobs that draw it, and the most landscape
+ * of them so far.
+ *
+ * A page is created from its first job rather than from an empty list, so
+ * there is never a page without images to explain away — `widest` has to name
+ * one of them.
+ */
+export interface PageDraft {
+    readonly jobs: RenderJob[];
+    widest: RenderJob;
+}
+/** Start a page off from the first job that draws it. */
+export declare function startPage(job: RenderJob): PageDraft;
+/**
+ * Add another size of the same page. Ties keep the size configured first,
+ * since `>` leaves the incumbent in place.
+ */
+export declare function addToPage(page: PageDraft, job: RenderJob): void;
+/** Finish a page: its images by size name, sorted, plus what they add up to. */
+export declare function toPage(slug: string, page: PageDraft): ManifestPage;
+//# sourceMappingURL=page.d.ts.map

package/dist/manifest/page.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page.d.ts","sourceRoot":"","sources":["../../src/manifest/page.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,KAAK,EAAiB,YAAY,EAAE,MAAM,aAAa,CAAC;AAG/D;;;;;;;GAOG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC;IAC3B,MAAM,EAAE,SAAS,CAAC;CACnB;AAOD,yDAAyD;AACzD,wBAAgB,SAAS,CAAC,GAAG,EAAE,SAAS,GAAG,SAAS,CAEnD;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,GAAG,IAAI,CAM/D;AA8BD,gFAAgF;AAChF,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,YAAY,CAclE"}

package/dist/manifest/page.js

@@ -0,0 +1,55 @@
+import { byName } from "./order.js";
+/** How landscape an image is. The most landscape one is what `widest` names. */
+function ratio(job) {
+    return job.size.width / job.size.height;
+}
+/** Start a page off from the first job that draws it. */
+export function startPage(job) {
+    return { jobs: [job], widest: job };
+}
+/**
+ * Add another size of the same page. Ties keep the size configured first,
+ * since `>` leaves the incumbent in place.
+ */
+export function addToPage(page, job) {
+    page.jobs.push(job);
+    if (ratio(job) > ratio(page.widest)) {
+        page.widest = job;
+    }
+}
+/**
+ * Reject two pages sharing a slug.
+ *
+ * The manifest is keyed by slug, so a site looking a page up would find
+ * whichever was written last — an image quietly belonging to the wrong post,
+ * which is worse than no manifest at all. Their images may well be distinct on
+ * disk, so nothing else in the build has any reason to complain.
+ */
+function assertOnePage(slug, page) {
+    const paths = [...new Set(page.jobs.map((job) => job.contentPath))];
+    if (paths.length > 1) {
+        throw new Error(`Two pages share the slug "${slug}": ${paths.join(" and ")}. The` +
+            ` manifest is keyed by slug, so they cannot both be found. Give one a` +
+            ` slug of its own, or use slugStrategy: "route".`);
+    }
+}
+function toImage(job) {
+    return {
+        ...(job.url !== undefined && { url: job.url }),
+        width: job.size.width,
+        height: job.size.height,
+    };
+}
+/** Finish a page: its images by size name, sorted, plus what they add up to. */
+export function toPage(slug, page) {
+    assertOnePage(slug, page);
+    const title = page.widest.props.title;
+    return {
+        images: Object.fromEntries(page.jobs
+            .map((job) => [job.size.name, toImage(job)])
+            .toSorted(([a], [b]) => byName(a, b))),
+        widest: page.widest.size.name,
+        ...(typeof title === "string" && title !== "" && { alt: title }),
+    };
+}
+//# sourceMappingURL=page.js.map

package/dist/manifest/page.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"page.js","sourceRoot":"","sources":["../../src/manifest/page.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAepC,gFAAgF;AAChF,SAAS,KAAK,CAAC,GAAc;IAC3B,OAAO,GAAG,CAAC,IAAI,CAAC,KAAK,GAAG,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC;AAC1C,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,SAAS,CAAC,GAAc;IACtC,OAAO,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;AACtC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,IAAe,EAAE,GAAc;IACvD,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAEpB,IAAI,KAAK,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACpC,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC;IACpB,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,aAAa,CAAC,IAAY,EAAE,IAAe;IAClD,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IAEpE,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CACb,6BAA6B,IAAI,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO;YAC/D,sEAAsE;YACtE,iDAAiD,CACpD,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,OAAO,CAAC,GAAc;IAC7B,OAAO;QACL,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,SAAS,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC;QAC9C,KAAK,EAAE,GAAG,CAAC,IAAI,CAAC,KAAK;QACrB,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,MAAM;KACxB,CAAC;AACJ,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,MAAM,CAAC,IAAY,EAAE,IAAe;IAClD,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAE1B,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC;IAEtC,OAAO;QACL,MAAM,EAAE,MAAM,CAAC,WAAW,CACxB,IAAI,CAAC,IAAI;aACN,GAAG,CAAC,CAAC,GAAG,EAA2B,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;aACpE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CACxC;QACD,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI;QAC7B,GAAG,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;KACjE,CAAC;AACJ,CAAC"}

package/dist/meta/html.d.ts

@@ -0,0 +1,14 @@
+import type { Manifest, MetaTagOptions } from "../types.js";
+/**
+ * The social meta tags for one page, rendered as HTML.
+ *
+ * The same tags as {@link metaTags}, for a template that writes strings rather
+ * than a component that spreads attributes. Content is escaped: alt text comes
+ * from a post's title, and a title containing an apostrophe or an ampersand is
+ * ordinary rather than exotic.
+ *
+ * Newline-separated and with no trailing newline, so it drops into a `<head>`
+ * at whatever indentation the template is already using.
+ */
+export declare function metaTagsHtml(manifest: Manifest, slug: string, options?: MetaTagOptions): string;
+//# sourceMappingURL=html.d.ts.map

package/dist/meta/html.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html.d.ts","sourceRoot":"","sources":["../../src/meta/html.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAW,cAAc,EAAE,MAAM,aAAa,CAAC;AAWrE;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,cAAc,GACvB,MAAM,CAIR"}

package/dist/meta/html.js

@@ -0,0 +1,24 @@
+import { escapeXml } from "../text/escape.js";
+import { metaTags } from "./tags.js";
+/** One tag as HTML, with whichever naming attribute it carries. */
+function toHtml(tag) {
+    const [attribute, name] = "property" in tag ? ["property", tag.property] : ["name", tag.name];
+    return `<meta ${attribute}="${escapeXml(name)}" content="${escapeXml(tag.content)}">`;
+}
+/**
+ * The social meta tags for one page, rendered as HTML.
+ *
+ * The same tags as {@link metaTags}, for a template that writes strings rather
+ * than a component that spreads attributes. Content is escaped: alt text comes
+ * from a post's title, and a title containing an apostrophe or an ampersand is
+ * ordinary rather than exotic.
+ *
+ * Newline-separated and with no trailing newline, so it drops into a `<head>`
+ * at whatever indentation the template is already using.
+ */
+export function metaTagsHtml(manifest, slug, options) {
+    return metaTags(manifest, slug, options)
+        .map((tag) => toHtml(tag))
+        .join("\n");
+}
+//# sourceMappingURL=html.js.map

package/dist/meta/html.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"html.js","sourceRoot":"","sources":["../../src/meta/html.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE9C,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAErC,mEAAmE;AACnE,SAAS,MAAM,CAAC,GAAY;IAC1B,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,GACrB,UAAU,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;IAEtE,OAAO,SAAS,SAAS,KAAK,SAAS,CAAC,IAAI,CAAC,cAAc,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC;AACxF,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,YAAY,CAC1B,QAAkB,EAClB,IAAY,EACZ,OAAwB;IAExB,OAAO,QAAQ,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC;SACrC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;SACzB,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC"}