@kensio/colophon 2.2.0 → 2.4.0

package/dist/highlight/language.js

@@ -0,0 +1,41 @@
+import { bundledLanguages, bundledThemes } from "shiki";
+/**
+ * Language names that differ between Pygments (which the original Python
+ * script used) and Shiki. Everything else is passed through, since Shiki
+ * 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. Languages come from post frontmatter and
+ * fall back quietly, but 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;;;GAGG;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/image/index.d.ts

@@ -0,0 +1,18 @@
+import type { ImageAsset, MetaImageProps, ResolvedConfig } from "../types.js";
+export { loadImage } from "./load.js";
+export { resolveImageSource, resolveOptionalImage } from "./resolve.js";
+/** Every image one rendering needs, loaded and ready to draw. */
+export interface LoadedImages {
+    readonly logo: ImageAsset | undefined;
+    readonly avatar: ImageAsset | undefined;
+    readonly background: ImageAsset | undefined;
+}
+/**
+ * Load the logo, the background photo and the post's avatar for one image.
+ *
+ * Reading files is the renderer's job rather than the template's. A template
+ * stays a synchronous function over values it was handed, and the bytes of a
+ * logo are read once for a whole build rather than once per image.
+ */
+export declare function loadImages(config: ResolvedConfig, props: MetaImageProps): Promise<LoadedImages>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/image/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EAEV,cAAc,EACd,cAAc,EACf,MAAM,aAAa,CAAC;AAKrB,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAExE,iEAAiE;AACjE,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,UAAU,EAAE,UAAU,GAAG,SAAS,CAAC;CAC7C;AAgCD;;;;;;GAMG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,cAAc,EACtB,KAAK,EAAE,cAAc,GACpB,OAAO,CAAC,YAAY,CAAC,CAWvB"}

package/dist/image/index.js

@@ -0,0 +1,42 @@
+import { loadImage } from "./load.js";
+import { resolveImageSource } from "./resolve.js";
+import { bytesFromDataUri } from "./uri.js";
+export { loadImage } from "./load.js";
+export { resolveImageSource, resolveOptionalImage } from "./resolve.js";
+/**
+ * Load an image named by a prop, which is a `data:` URI or a path to a file.
+ *
+ * A path is resolved from the working directory, as `fonts` and `logo` are.
+ * Resolving it against the post instead would be friendlier for a page bundle
+ * and wrong for everything else, and a build has one working directory but
+ * many content directories.
+ */
+async function loadProp(value, label) {
+    if (value === undefined || value === "") {
+        return undefined;
+    }
+    const source = value.startsWith("data:")
+        ? { data: bytesFromDataUri(value, label) }
+        : resolveImageSource({ path: value }, label);
+    return loadImage(source, label);
+}
+async function loadOptional(source, label) {
+    return source === undefined ? undefined : loadImage(source, label);
+}
+/**
+ * Load the logo, the background photo and the post's avatar for one image.
+ *
+ * Reading files is the renderer's job rather than the template's. A template
+ * stays a synchronous function over values it was handed, and the bytes of a
+ * logo are read once for a whole build rather than once per image.
+ */
+export async function loadImages(config, props) {
+    const background = config.background.type === "image" ? config.background.source : undefined;
+    const [logo, avatar, backgroundImage] = await Promise.all([
+        loadOptional(config.logo, "logo"),
+        loadProp(props.avatar, "props.avatar"),
+        loadOptional(background, "background.source"),
+    ]);
+    return { logo, avatar, background: backgroundImage };
+}
+//# sourceMappingURL=index.js.map

package/dist/image/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/image/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAE5C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AASxE;;;;;;;GAOG;AACH,KAAK,UAAU,QAAQ,CACrB,KAAyB,EACzB,KAAa;IAEb,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;QACxC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,MAAM,GAAgB,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC;QACnD,CAAC,CAAC,EAAE,IAAI,EAAE,gBAAgB,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE;QAC1C,CAAC,CAAC,kBAAkB,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,KAAK,CAAC,CAAC;IAE/C,OAAO,SAAS,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAClC,CAAC;AAED,KAAK,UAAU,YAAY,CACzB,MAA+B,EAC/B,KAAa;IAEb,OAAO,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AACrE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,MAAsB,EACtB,KAAqB;IAErB,MAAM,UAAU,GACd,MAAM,CAAC,UAAU,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;IAE5E,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,eAAe,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACxD,YAAY,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC;QACjC,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,cAAc,CAAC;QACtC,YAAY,CAAC,UAAU,EAAE,mBAAmB,CAAC;KAC9C,CAAC,CAAC;IAEH,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,eAAe,EAAE,CAAC;AACvD,CAAC"}

package/dist/image/jpeg.d.ts

@@ -0,0 +1,10 @@
+import type { Extent } from "./size.js";
+/**
+ * The dimensions of a JPEG, by walking its segments to the frame header.
+ *
+ * Unlike every other format here, a JPEG does not state its size at a fixed
+ * offset: the frame header comes after however many comment, quantisation and
+ * application segments the encoder felt like writing.
+ */
+export declare function jpegExtent(bytes: Uint8Array): Extent | undefined;
+//# sourceMappingURL=jpeg.d.ts.map

package/dist/image/jpeg.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jpeg.d.ts","sourceRoot":"","sources":["../../src/image/jpeg.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAkBxC;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS,CA2ChE"}

package/dist/image/jpeg.js

@@ -0,0 +1,57 @@
+/** Markers that carry no payload, so nothing follows them to skip over. */
+const standalone = new Set([0xd8, 0xd9, 0x01]);
+/** The frame headers, which are the segments that state the image size. */
+function isFrameHeader(marker) {
+    // 0xC4, 0xC8 and 0xCC sit in the same range and are tables rather than
+    // frames, which is the whole subtlety of reading a JPEG header.
+    return (marker >= 0xc0 &&
+        marker <= 0xcf &&
+        marker !== 0xc4 &&
+        marker !== 0xc8 &&
+        marker !== 0xcc);
+}
+/**
+ * The dimensions of a JPEG, by walking its segments to the frame header.
+ *
+ * Unlike every other format here, a JPEG does not state its size at a fixed
+ * offset: the frame header comes after however many comment, quantisation and
+ * application segments the encoder felt like writing.
+ */
+export function jpegExtent(bytes) {
+    const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+    let offset = 2;
+    while (offset + 4 < bytes.length) {
+        if (bytes[offset] !== 0xff) {
+            // Anything between segments is skipped a byte at a time rather than
+            // read as a length, since a length taken from the middle of one would
+            // jump somewhere arbitrary.
+            offset += 1;
+            continue;
+        }
+        const marker = bytes[offset + 1] ?? 0;
+        if (marker === 0xff) {
+            // A marker may be preceded by any number of `0xff` fill bytes, so this
+            // is the first of them rather than a marker of its own.
+            offset += 1;
+            continue;
+        }
+        if (standalone.has(marker)) {
+            offset += 2;
+            continue;
+        }
+        if (isFrameHeader(marker)) {
+            // The dimensions run to offset + 8, further than the loop guarantees, so
+            // a file truncated inside its own frame header is unmeasurable rather
+            // than a read past the end of the buffer.
+            return offset + 8 < bytes.length
+                ? {
+                    width: view.getUint16(offset + 7),
+                    height: view.getUint16(offset + 5),
+                }
+                : undefined;
+        }
+        offset += 2 + view.getUint16(offset + 2);
+    }
+    return undefined;
+}
+//# sourceMappingURL=jpeg.js.map

package/dist/image/jpeg.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jpeg.js","sourceRoot":"","sources":["../../src/image/jpeg.ts"],"names":[],"mappings":"AAEA,2EAA2E;AAC3E,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;AAE/C,2EAA2E;AAC3E,SAAS,aAAa,CAAC,MAAc;IACnC,uEAAuE;IACvE,gEAAgE;IAChE,OAAO,CACL,MAAM,IAAI,IAAI;QACd,MAAM,IAAI,IAAI;QACd,MAAM,KAAK,IAAI;QACf,MAAM,KAAK,IAAI;QACf,MAAM,KAAK,IAAI,CAChB,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CAAC,KAAiB;IAC1C,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;IAC5E,IAAI,MAAM,GAAG,CAAC,CAAC;IAEf,OAAO,MAAM,GAAG,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;QACjC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC;YAC3B,oEAAoE;YACpE,sEAAsE;YACtE,4BAA4B;YAC5B,MAAM,IAAI,CAAC,CAAC;YACZ,SAAS;QACX,CAAC;QAED,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC;QAEtC,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;YACpB,uEAAuE;YACvE,wDAAwD;YACxD,MAAM,IAAI,CAAC,CAAC;YACZ,SAAS;QACX,CAAC;QAED,IAAI,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3B,MAAM,IAAI,CAAC,CAAC;YACZ,SAAS;QACX,CAAC;QAED,IAAI,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1B,yEAAyE;YACzE,sEAAsE;YACtE,0CAA0C;YAC1C,OAAO,MAAM,GAAG,CAAC,GAAG,KAAK,CAAC,MAAM;gBAC9B,CAAC,CAAC;oBACE,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC;oBACjC,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC;iBACnC;gBACH,CAAC,CAAC,SAAS,CAAC;QAChB,CAAC;QAED,MAAM,IAAI,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC3C,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/image/load.d.ts

@@ -0,0 +1,4 @@
+import type { ImageAsset, ImageSource } from "../types.js";
+/** Load one image source, reusing the bytes across the images of a build. */
+export declare function loadImage(source: ImageSource, label: string): Promise<ImageAsset>;
+//# sourceMappingURL=load.d.ts.map

package/dist/image/load.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load.d.ts","sourceRoot":"","sources":["../../src/image/load.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AA8D3D,6EAA6E;AAC7E,wBAAgB,SAAS,CACvB,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,UAAU,CAAC,CAUrB"}

package/dist/image/load.js

@@ -0,0 +1,60 @@
+import { readFile } from "node:fs/promises";
+import { sniffMediaType } from "./media.js";
+import { aspectOf } from "./size.js";
+/**
+ * Loaded images, keyed by the path they were read from. A build draws the same
+ * logo onto every image it generates, and the bytes are the largest thing in
+ * the SVG, so reading and encoding it once matters more here than it does for
+ * a font.
+ */
+const byPath = new Map();
+/** The same for images given as bytes, keyed by the array itself. */
+const byData = new WeakMap();
+/**
+ * `Uint8Array.toBase64` reads better and is not on the oldest Node this
+ * package supports, so the encoding goes through a Buffer.
+ */
+function base64(bytes) {
+    // eslint-disable-next-line unicorn/prefer-uint8array-base64
+    return Buffer.from(bytes.buffer, bytes.byteOffset, bytes.byteLength).toString("base64");
+}
+/**
+ * Turn bytes into something drawable: a `data:` URI and the proportions of the
+ * picture inside it.
+ *
+ * Inlining rather than referencing the file is what makes a generated image
+ * self-contained. The rasteriser would have to resolve a relative href against
+ * something, and there is nothing sensible to resolve it against when the SVG
+ * only ever exists in memory.
+ */
+function toAsset(bytes, label) {
+    const mediaType = sniffMediaType(bytes);
+    if (mediaType === undefined) {
+        throw new Error(`${label} is not an image this can read. PNG, JPEG, GIF, WebP and SVG` +
+            ` are understood, and the bytes given match none of them.`);
+    }
+    // `Uint8Array.toBase64` would read better and does not exist on the oldest
+    // Node this package supports.
+    return {
+        href: `data:${mediaType};base64,${base64(bytes)}`,
+        aspect: aspectOf(bytes, mediaType) ?? 1,
+    };
+}
+async function read(source, label) {
+    const bytes = "data" in source
+        ? source.data
+        : new Uint8Array(await readFile(source.path));
+    return toAsset(bytes, label);
+}
+/** Load one image source, reusing the bytes across the images of a build. */
+export function loadImage(source, label) {
+    if ("data" in source) {
+        const pending = byData.get(source.data) ?? read(source, label);
+        byData.set(source.data, pending);
+        return pending;
+    }
+    const pending = byPath.get(source.path) ?? read(source, label);
+    byPath.set(source.path, pending);
+    return pending;
+}
+//# sourceMappingURL=load.js.map

package/dist/image/load.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load.js","sourceRoot":"","sources":["../../src/image/load.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAG5C,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAErC;;;;;GAKG;AACH,MAAM,MAAM,GAAG,IAAI,GAAG,EAA+B,CAAC;AAEtD,qEAAqE;AACrE,MAAM,MAAM,GAAG,IAAI,OAAO,EAAmC,CAAC;AAE9D;;;GAGG;AACH,SAAS,MAAM,CAAC,KAAiB;IAC/B,4DAA4D;IAC5D,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC,QAAQ,CAC3E,QAAQ,CACT,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,SAAS,OAAO,CAAC,KAAiB,EAAE,KAAa;IAC/C,MAAM,SAAS,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;IAExC,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CACb,GAAG,KAAK,8DAA8D;YACpE,0DAA0D,CAC7D,CAAC;IACJ,CAAC;IAED,2EAA2E;IAC3E,8BAA8B;IAC9B,OAAO;QACL,IAAI,EAAE,QAAQ,SAAS,WAAW,MAAM,CAAC,KAAK,CAAC,EAAE;QACjD,MAAM,EAAE,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,IAAI,CAAC;KACxC,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,IAAI,CAAC,MAAmB,EAAE,KAAa;IACpD,MAAM,KAAK,GACT,MAAM,IAAI,MAAM;QACd,CAAC,CAAC,MAAM,CAAC,IAAI;QACb,CAAC,CAAC,IAAI,UAAU,CAAC,MAAM,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IAElD,OAAO,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AAC/B,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,SAAS,CACvB,MAAmB,EACnB,KAAa;IAEb,IAAI,MAAM,IAAI,MAAM,EAAE,CAAC;QACrB,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAC/D,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACjC,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC/D,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACjC,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/image/media.d.ts

@@ -0,0 +1,10 @@
+/** The image formats a build can draw with. */
+export type MediaType = "image/png" | "image/jpeg" | "image/gif" | "image/webp" | "image/svg+xml";
+/**
+ * The format of some bytes, read from the bytes themselves rather than from
+ * the file extension. A file named `.png` that is really a JPEG renders either
+ * way once the `data:` URI says what it is, and a rename is not the sort of
+ * thing a build should fail over.
+ */
+export declare function sniffMediaType(bytes: Uint8Array): MediaType | undefined;
+//# sourceMappingURL=media.d.ts.map

package/dist/image/media.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media.d.ts","sourceRoot":"","sources":["../../src/image/media.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,MAAM,MAAM,SAAS,GACnB,WAAW,GAAG,YAAY,GAAG,WAAW,GAAG,YAAY,GAAG,eAAe,CAAC;AAmB5E;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,GAAG,SAAS,GAAG,SAAS,CAkBvE"}

package/dist/image/media.js

@@ -0,0 +1,37 @@
+function hasSignature(bytes, signature) {
+    return signature.every((byte, index) => bytes[index] === byte);
+}
+/** Whether the bytes at `offset` spell `text` in ASCII. */
+function hasAscii(bytes, offset, text) {
+    return Array.from(text, (character, index) => [character, index]).every(([character, index]) => bytes[offset + index] === character.codePointAt(0));
+}
+/**
+ * The format of some bytes, read from the bytes themselves rather than from
+ * the file extension. A file named `.png` that is really a JPEG renders either
+ * way once the `data:` URI says what it is, and a rename is not the sort of
+ * thing a build should fail over.
+ */
+export function sniffMediaType(bytes) {
+    if (hasSignature(bytes, [0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a])) {
+        return "image/png";
+    }
+    if (hasSignature(bytes, [0xff, 0xd8, 0xff])) {
+        return "image/jpeg";
+    }
+    if (hasAscii(bytes, 0, "GIF8")) {
+        return "image/gif";
+    }
+    if (hasAscii(bytes, 0, "RIFF") && hasAscii(bytes, 8, "WEBP")) {
+        return "image/webp";
+    }
+    return isSvg(bytes) ? "image/svg+xml" : undefined;
+}
+/**
+ * SVG is text, so it has no signature to match. Look for the opening tag in
+ * the first stretch of the file, past any declaration, doctype or comment.
+ */
+function isSvg(bytes) {
+    const head = new TextDecoder().decode(bytes.slice(0, 1024));
+    return /<svg[\s>]/i.test(head);
+}
+//# sourceMappingURL=media.js.map

package/dist/image/media.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media.js","sourceRoot":"","sources":["../../src/image/media.ts"],"names":[],"mappings":"AAIA,SAAS,YAAY,CACnB,KAAiB,EACjB,SAA4B;IAE5B,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC;AACjE,CAAC;AAED,2DAA2D;AAC3D,SAAS,QAAQ,CAAC,KAAiB,EAAE,MAAc,EAAE,IAAY;IAC/D,OAAO,KAAK,CAAC,IAAI,CACf,IAAI,EACJ,CAAC,SAAS,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,SAAS,EAAE,KAAK,CAAU,CAClD,CAAC,KAAK,CACL,CAAC,CAAC,SAAS,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,KAAK,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC,CAC3E,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,KAAiB;IAC9C,IAAI,YAAY,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC;QAC1E,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,IAAI,YAAY,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC;QAC5C,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC,EAAE,MAAM,CAAC,EAAE,CAAC;QAC/B,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC,EAAE,MAAM,CAAC,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC,EAAE,MAAM,CAAC,EAAE,CAAC;QAC7D,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,SAAS,CAAC;AACpD,CAAC;AAED;;;GAGG;AACH,SAAS,KAAK,CAAC,KAAiB;IAC9B,MAAM,IAAI,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;IAC5D,OAAO,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACjC,CAAC"}

package/dist/image/resolve.d.ts

@@ -0,0 +1,13 @@
+import type { ImageSource } from "../types.js";
+/**
+ * Validate one image source and make its path absolute.
+ *
+ * Checked when the config is resolved rather than when the image is drawn, for
+ * the reason `fonts/resolve.ts` gives: an image that cannot be read is a blank
+ * corner on every generated file, and a blank corner does not say which path
+ * was wrong.
+ */
+export declare function resolveImageSource(source: ImageSource, label: string): ImageSource;
+/** The same for a source that may not be there at all. */
+export declare function resolveOptionalImage(source: ImageSource | undefined, label: string): ImageSource | undefined;
+//# sourceMappingURL=resolve.d.ts.map

package/dist/image/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/image/resolve.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE,MAAM,GACZ,WAAW,CAsCb;AAED,0DAA0D;AAC1D,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,WAAW,GAAG,SAAS,EAC/B,KAAK,EAAE,MAAM,GACZ,WAAW,GAAG,SAAS,CAEzB"}

package/dist/image/resolve.js

@@ -0,0 +1,38 @@
+import { existsSync, statSync } from "node:fs";
+import path from "node:path";
+/**
+ * Validate one image source and make its path absolute.
+ *
+ * Checked when the config is resolved rather than when the image is drawn, for
+ * the reason `fonts/resolve.ts` gives: an image that cannot be read is a blank
+ * corner on every generated file, and a blank corner does not say which path
+ * was wrong.
+ */
+export function resolveImageSource(source, label) {
+    const raw = source;
+    const hasPath = raw.path !== undefined;
+    const hasData = raw.data !== undefined;
+    if (hasPath && hasData) {
+        throw new Error(`${label} has both "path" and "data"; give one or the other.`);
+    }
+    if (raw.data !== undefined) {
+        if (raw.data.byteLength === 0) {
+            throw new Error(`${label} has empty image data.`);
+        }
+        return source;
+    }
+    if (raw.path === undefined || raw.path === "") {
+        throw new Error(`${label} needs a "path" to an image file, or its bytes as "data".`);
+    }
+    const absolute = path.resolve(raw.path);
+    if (!existsSync(absolute) || !statSync(absolute).isFile()) {
+        throw new Error(`${label}: image file not found at ${absolute} (from "${raw.path}").` +
+            ` Relative paths resolve from the working directory.`);
+    }
+    return { path: absolute };
+}
+/** The same for a source that may not be there at all. */
+export function resolveOptionalImage(source, label) {
+    return source === undefined ? undefined : resolveImageSource(source, label);
+}
+//# sourceMappingURL=resolve.js.map

package/dist/image/resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../../src/image/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,IAAI,MAAM,WAAW,CAAC;AAI7B;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAChC,MAAmB,EACnB,KAAa;IAEb,MAAM,GAAG,GAAG,MAGX,CAAC;IACF,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC;IACvC,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC;IAEvC,IAAI,OAAO,IAAI,OAAO,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CACb,GAAG,KAAK,qDAAqD,CAC9D,CAAC;IACJ,CAAC;IAED,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC3B,IAAI,GAAG,CAAC,IAAI,CAAC,UAAU,KAAK,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,wBAAwB,CAAC,CAAC;QACpD,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS,IAAI,GAAG,CAAC,IAAI,KAAK,EAAE,EAAE,CAAC;QAC9C,MAAM,IAAI,KAAK,CACb,GAAG,KAAK,2DAA2D,CACpE,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAExC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;QAC1D,MAAM,IAAI,KAAK,CACb,GAAG,KAAK,6BAA6B,QAAQ,WAAW,GAAG,CAAC,IAAI,KAAK;YACnE,qDAAqD,CACxD,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;AAC5B,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,oBAAoB,CAClC,MAA+B,EAC/B,KAAa;IAEb,OAAO,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAC9E,CAAC"}

package/dist/image/size.d.ts

@@ -0,0 +1,22 @@
+import type { MediaType } from "./media.js";
+/** How big an image is, in whatever units it states for itself. */
+export interface Extent {
+    readonly width: number;
+    readonly height: number;
+}
+/**
+ * How wide an image is against how tall, or `undefined` where the format does
+ * not say in any way this reads.
+ *
+ * Only the ratio is wanted. A template sizes a logo from the image it is
+ * drawing into rather than from the logo's own pixels, since the same logo has
+ * to work on a 1200x630 and a 1200x1200, and the ratio is what stops it being
+ * stretched or given a square of space it does not fill.
+ *
+ * WebP is deliberately absent. Its dimensions live in one of three different
+ * chunk layouts depending on how it was encoded, and a logo is a PNG or an SVG
+ * often enough that guessing at bit-packed headers is not worth the risk of
+ * getting one of them subtly wrong.
+ */
+export declare function aspectOf(bytes: Uint8Array, mediaType: MediaType): number | undefined;
+//# sourceMappingURL=size.d.ts.map

package/dist/image/size.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"size.d.ts","sourceRoot":"","sources":["../../src/image/size.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAG5C,mEAAmE;AACnE,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAuBD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,QAAQ,CACtB,KAAK,EAAE,UAAU,EACjB,SAAS,EAAE,SAAS,GACnB,MAAM,GAAG,SAAS,CAMpB"}

package/dist/image/size.js

@@ -0,0 +1,60 @@
+import { jpegExtent } from "./jpeg.js";
+import { svgExtent } from "./svg.js";
+function view(bytes) {
+    return new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+}
+/** PNG states its size in the IHDR chunk, which is always the first one. */
+function pngExtent(bytes) {
+    return bytes.length < 24
+        ? undefined
+        : { width: view(bytes).getUint32(16), height: view(bytes).getUint32(20) };
+}
+/** GIF states its screen size in the header, little-endian. */
+function gifExtent(bytes) {
+    return bytes.length < 10
+        ? undefined
+        : {
+            width: view(bytes).getUint16(6, true),
+            height: view(bytes).getUint16(8, true),
+        };
+}
+/**
+ * How wide an image is against how tall, or `undefined` where the format does
+ * not say in any way this reads.
+ *
+ * Only the ratio is wanted. A template sizes a logo from the image it is
+ * drawing into rather than from the logo's own pixels, since the same logo has
+ * to work on a 1200x630 and a 1200x1200, and the ratio is what stops it being
+ * stretched or given a square of space it does not fill.
+ *
+ * WebP is deliberately absent. Its dimensions live in one of three different
+ * chunk layouts depending on how it was encoded, and a logo is a PNG or an SVG
+ * often enough that guessing at bit-packed headers is not worth the risk of
+ * getting one of them subtly wrong.
+ */
+export function aspectOf(bytes, mediaType) {
+    const extent = extentOf(bytes, mediaType);
+    return extent === undefined || extent.height <= 0
+        ? undefined
+        : extent.width / extent.height;
+}
+function extentOf(bytes, mediaType) {
+    switch (mediaType) {
+        case "image/png": {
+            return pngExtent(bytes);
+        }
+        case "image/gif": {
+            return gifExtent(bytes);
+        }
+        case "image/jpeg": {
+            return jpegExtent(bytes);
+        }
+        case "image/svg+xml": {
+            return svgExtent(bytes);
+        }
+        case "image/webp": {
+            return undefined;
+        }
+    }
+}
+//# sourceMappingURL=size.js.map

package/dist/image/size.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"size.js","sourceRoot":"","sources":["../../src/image/size.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvC,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAQrC,SAAS,IAAI,CAAC,KAAiB;IAC7B,OAAO,IAAI,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;AACxE,CAAC;AAED,4EAA4E;AAC5E,SAAS,SAAS,CAAC,KAAiB;IAClC,OAAO,KAAK,CAAC,MAAM,GAAG,EAAE;QACtB,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,CAAC;AAC9E,CAAC;AAED,+DAA+D;AAC/D,SAAS,SAAS,CAAC,KAAiB;IAClC,OAAO,KAAK,CAAC,MAAM,GAAG,EAAE;QACtB,CAAC,CAAC,SAAS;QACX,CAAC,CAAC;YACE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,CAAC;YACrC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,CAAC;SACvC,CAAC;AACR,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,QAAQ,CACtB,KAAiB,EACjB,SAAoB;IAEpB,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IAE1C,OAAO,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,MAAM,IAAI,CAAC;QAC/C,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC;AACnC,CAAC;AAED,SAAS,QAAQ,CAAC,KAAiB,EAAE,SAAoB;IACvD,QAAQ,SAAS,EAAE,CAAC;QAClB,KAAK,WAAW,EAAE,CAAC;YACjB,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC;QAC1B,CAAC;QACD,KAAK,WAAW,EAAE,CAAC;YACjB,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC;QAC1B,CAAC;QACD,KAAK,YAAY,EAAE,CAAC;YAClB,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC;QAC3B,CAAC;QACD,KAAK,eAAe,EAAE,CAAC;YACrB,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC;QAC1B,CAAC;QACD,KAAK,YAAY,EAAE,CAAC;YAClB,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/image/svg.d.ts

@@ -0,0 +1,12 @@
+import type { Extent } from "./size.js";
+/**
+ * The proportions of an SVG, which are what a template needs: an SVG has no
+ * pixels of its own, so only the ratio between its width and height means
+ * anything here.
+ *
+ * `width` and `height` are read first and `viewBox` second, which is the order
+ * a renderer resolves them in. A document with neither is left unmeasured
+ * rather than assumed to be square, since a wordmark usually has neither.
+ */
+export declare function svgExtent(bytes: Uint8Array): Extent | undefined;
+//# sourceMappingURL=svg.d.ts.map

package/dist/image/svg.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"svg.d.ts","sourceRoot":"","sources":["../../src/image/svg.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAwCxC;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS,CAyB/D"}