@kensio/colophon 2.3.0 → 2.5.0

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"}

package/dist/image/svg.js

@@ -0,0 +1,61 @@
+/**
+ * The attributes of the root `<svg>` element that say how big it is. Written
+ * out rather than built from a name, since there are three of them and a
+ * pattern assembled from a string is harder to read than the three patterns.
+ */
+const attributes = {
+    width: /\swidth\s*=\s*"([^"]*)"/i,
+    height: /\sheight\s*=\s*"([^"]*)"/i,
+    viewBox: /\sviewBox\s*=\s*"([^"]*)"/i,
+};
+/** The value of one of them, where the root element carries it. */
+function attribute(head, name) {
+    return attributes[name].exec(head)?.[1];
+}
+/**
+ * A length such as `120`, `120px` or `7.5em`, as far as its number goes.
+ *
+ * A percentage is not one of them. `width="100%"` is the commonest way an
+ * export states that it scales to its container, and reading it as 100 units
+ * would make every such file square whatever its `viewBox` says.
+ */
+function length(value) {
+    if (value?.trim().endsWith("%") === true) {
+        return undefined;
+    }
+    // Deliberately parseFloat rather than Number: a length may carry a unit,
+    // and `6em` is six of something rather than not a number.
+    // eslint-disable-next-line unicorn/prefer-number-coercion
+    const number = Number.parseFloat(value ?? "");
+    return Number.isFinite(number) && number > 0 ? number : undefined;
+}
+/**
+ * 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 function svgExtent(bytes) {
+    const head = new TextDecoder().decode(bytes.slice(0, 4096));
+    const root = /<svg[\s>][^>]*/i.exec(head)?.[0] ?? "";
+    const width = length(attribute(root, "width"));
+    const height = length(attribute(root, "height"));
+    if (width !== undefined && height !== undefined) {
+        return { width, height };
+    }
+    const box = attribute(root, "viewBox")
+        ?.trim()
+        .split(/[\s,]+/);
+    if (box?.length !== 4) {
+        return undefined;
+    }
+    const boxWidth = length(box[2]);
+    const boxHeight = length(box[3]);
+    return boxWidth === undefined || boxHeight === undefined
+        ? undefined
+        : { width: boxWidth, height: boxHeight };
+}
+//# sourceMappingURL=svg.js.map

package/dist/image/svg.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"svg.js","sourceRoot":"","sources":["../../src/image/svg.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,UAAU,GAAG;IACjB,KAAK,EAAE,0BAA0B;IACjC,MAAM,EAAE,2BAA2B;IACnC,OAAO,EAAE,4BAA4B;CAC7B,CAAC;AAEX,mEAAmE;AACnE,SAAS,SAAS,CAChB,IAAY,EACZ,IAA6B;IAE7B,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AAC1C,CAAC;AAED;;;;;;GAMG;AACH,SAAS,MAAM,CAAC,KAAyB;IACvC,IAAI,KAAK,EAAE,IAAI,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC;QACzC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,yEAAyE;IACzE,0DAA0D;IAC1D,0DAA0D;IAC1D,MAAM,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;IAC9C,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;AACpE,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,SAAS,CAAC,KAAiB;IACzC,MAAM,IAAI,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;IAC5D,MAAM,IAAI,GAAG,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAErD,MAAM,KAAK,GAAG,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;IAC/C,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC;IAEjD,IAAI,KAAK,KAAK,SAAS,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QAChD,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAC3B,CAAC;IAED,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC;QACpC,EAAE,IAAI,EAAE;SACP,KAAK,CAAC,QAAQ,CAAC,CAAC;IAEnB,IAAI,GAAG,EAAE,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAChC,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAEjC,OAAO,QAAQ,KAAK,SAAS,IAAI,SAAS,KAAK,SAAS;QACtD,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;AAC7C,CAAC"}

package/dist/image/uri.d.ts

@@ -0,0 +1,9 @@
+/**
+ * The bytes behind a `data:` URI, so that an image already inline is measured
+ * and checked on the same terms as one read from disk.
+ *
+ * A prop can carry either, since frontmatter written by hand names a file and
+ * frontmatter written by a props mapper may have the image already.
+ */
+export declare function bytesFromDataUri(uri: string, label: string): Uint8Array;
+//# sourceMappingURL=uri.d.ts.map

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

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

package/dist/image/uri.js

@@ -0,0 +1,22 @@
+/**
+ * The bytes behind a `data:` URI, so that an image already inline is measured
+ * and checked on the same terms as one read from disk.
+ *
+ * A prop can carry either, since frontmatter written by hand names a file and
+ * frontmatter written by a props mapper may have the image already.
+ */
+export function bytesFromDataUri(uri, label) {
+    const comma = uri.indexOf(",");
+    const head = comma === -1 ? "" : uri.slice(0, comma);
+    const body = comma === -1 ? "" : uri.slice(comma + 1);
+    if (comma === -1) {
+        throw new Error(`${label} is a "data:" URI with no comma in it.`);
+    }
+    if (head.endsWith(";base64")) {
+        // `Uint8Array.fromBase64` is not on the oldest Node this package supports.
+        // eslint-disable-next-line unicorn/prefer-uint8array-base64
+        return Buffer.from(body, "base64");
+    }
+    return new TextEncoder().encode(decodeURIComponent(body));
+}
+//# sourceMappingURL=uri.js.map

package/dist/image/uri.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uri.js","sourceRoot":"","sources":["../../src/image/uri.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAW,EAAE,KAAa;IACzD,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC/B,MAAM,IAAI,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IACrD,MAAM,IAAI,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;IAEtD,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,wCAAwC,CAAC,CAAC;IACpE,CAAC;IAED,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QAC7B,2EAA2E;QAC3E,4DAA4D;QAC5D,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IACrC,CAAC;IAED,OAAO,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC;AAC5D,CAAC"}

package/dist/index.d.ts

@@ -1,7 +1,8 @@
-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 type { Background, Badge, BrandColors, CodeStyle, ColophonConfig, ColophonConfigFactory, ColophonConfigInput, ContentFile, ContentOptions, Dimensions, ExtraImage, FontSource, GradientStop, Manifest, ManifestImage, ManifestPage, MeshBlob, MetaImageProps, MeasureText, MetaTag, MetaTagOptions, OutputSize, Placement, PropsFromFrontmatter, RenderedMetaImage, SlugStrategy, SizeOverrides, ResolvedConfig, Template, TemplateContext, Texture, TextStyle, ThemeName, 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 { backgroundSvg } from "./background/index.js";
+export { textureSvg } from "./texture/index.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/index.js";
@@ -10,7 +11,11 @@ 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 { createMeasurer } from "./measure/index.js";
+export { escapeXml, fitText, textElement, wrapText } from "./text/index.js";
+export type { FitOptions, FittedText, MeasureAt, MeasureLine, TextAttributes, } from "./text/index.js";
+export { blockLines, box, distribute, drawLines, image, inset, measureIn, optionalString, panel, placeLines, row, scrim, stack, } from "./layout/index.js";
+export type { Align, BoxStyle, Extent, ImageOptions, LinesStyle, Placed, PlacedLine, PanelStyle, Rect, RowRect, ScrimOptions, Span, StackedRect, StyledBlock, TextBlock, TextLine, } from "./layout/index.js";
 export { extractProps, slugFromPath, walkContent } from "./content/index.js";
 export type { WalkOptions } from "./content/index.js";
 export { metaTags, metaTagsHtml } from "./meta/index.js";

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,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"}
+{"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,QAAQ,EACR,cAAc,EACd,WAAW,EACX,OAAO,EACP,cAAc,EACd,UAAU,EACV,SAAS,EACT,oBAAoB,EACpB,iBAAiB,EACjB,YAAY,EACZ,aAAa,EACb,cAAc,EACd,QAAQ,EACR,eAAe,EACf,OAAO,EACP,SAAS,EACT,SAAS,EACT,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,uBAAuB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,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,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpD,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC5E,YAAY,EACV,UAAU,EACV,UAAU,EACV,SAAS,EACT,WAAW,EACX,cAAc,GACf,MAAM,iBAAiB,CAAC;AAIzB,OAAO,EACL,UAAU,EACV,GAAG,EACH,UAAU,EACV,SAAS,EACT,KAAK,EACL,KAAK,EACL,SAAS,EACT,cAAc,EACd,KAAK,EACL,UAAU,EACV,GAAG,EACH,KAAK,EACL,KAAK,GACN,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,KAAK,EACL,QAAQ,EACR,MAAM,EACN,YAAY,EACZ,UAAU,EACV,MAAM,EACN,UAAU,EACV,UAAU,EACV,IAAI,EACJ,OAAO,EACP,YAAY,EACZ,IAAI,EACJ,WAAW,EACX,WAAW,EACX,SAAS,EACT,QAAQ,GACT,MAAM,mBAAmB,CAAC;AAE3B,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,12 +1,17 @@
 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 { backgroundSvg } from "./background/index.js";
+export { textureSvg } from "./texture/index.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/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 { createMeasurer } from "./measure/index.js";
+export { escapeXml, fitText, textElement, wrapText } from "./text/index.js";
+// The layout toolkit, which also has its own `@kensio/colophon/layout` subpath
+// for a template that would rather not pull the rasteriser in with it.
+export { blockLines, box, distribute, drawLines, image, inset, measureIn, optionalString, panel, placeLines, row, scrim, stack, } from "./layout/index.js";
 export { extractProps, slugFromPath, walkContent } from "./content/index.js";
 export { metaTags, metaTagsHtml } from "./meta/index.js";
 export { createPlacer } from "./placement/index.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAqCA,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,uBAAuB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,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,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpD,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAS5E,+EAA+E;AAC/E,uEAAuE;AACvE,OAAO,EACL,UAAU,EACV,GAAG,EACH,UAAU,EACV,SAAS,EACT,KAAK,EACL,KAAK,EACL,SAAS,EACT,cAAc,EACd,KAAK,EACL,UAAU,EACV,GAAG,EACH,KAAK,EACL,KAAK,GACN,MAAM,mBAAmB,CAAC;AAoB3B,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/layout/block.d.ts

@@ -0,0 +1,37 @@
+import type { MeasureText } from "../types.js";
+/** One group of a template's text: the space it has and how it is drawn. */
+export interface TextBlock {
+    readonly maxWidth: number;
+    readonly maxLines: number;
+    readonly fontSize: number;
+    /**
+     * Fraction of `fontSize` this group may shrink to before it is cut instead.
+     * The title of a layout has the furthest to fall, because it is the line
+     * worth keeping whole; a subtitle that has shrunk much has stopped being
+     * readable in a feed, so it may as well lose its tail.
+     */
+    readonly floor: number;
+    readonly fontWeight: number;
+}
+/** A block along with how the lines it produces are drawn. */
+export interface StyledBlock extends TextBlock {
+    readonly opacity: number;
+    /** Space inserted before the group's first line, to separate it from the last. */
+    readonly gapBefore?: number;
+}
+/** One line of a template's text block, ready to be stacked and drawn. */
+export interface TextLine {
+    readonly text: string;
+    readonly fontSize: number;
+    readonly fontWeight: number;
+    readonly opacity: number;
+    readonly gapBefore?: number;
+}
+/**
+ * Fit one group of a template's text, from a prop that may not be there, and
+ * return its lines. Each group is fitted on its own, so a long title shrinking
+ * does not drag the subtitle down with it. A group whose prop is absent or
+ * empty produces no lines at all.
+ */
+export declare function blockLines(value: unknown, measure: MeasureText, fontFamily: string, block: StyledBlock): TextLine[];
+//# sourceMappingURL=block.d.ts.map

package/dist/layout/block.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"block.d.ts","sourceRoot":"","sources":["../../src/layout/block.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG/C,4EAA4E;AAC5E,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,8DAA8D;AAC9D,MAAM,WAAW,WAAY,SAAQ,SAAS;IAC5C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,kFAAkF;IAClF,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,0EAA0E;AAC1E,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,WAAW,EACpB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,WAAW,GACjB,QAAQ,EAAE,CAoBZ"}

package/dist/layout/block.js

@@ -0,0 +1,26 @@
+import { fitText } from "../text/index.js";
+import { optionalString } from "../props.js";
+import { measureIn } from "./measure.js";
+/**
+ * Fit one group of a template's text, from a prop that may not be there, and
+ * return its lines. Each group is fitted on its own, so a long title shrinking
+ * does not drag the subtitle down with it. A group whose prop is absent or
+ * empty produces no lines at all.
+ */
+export function blockLines(value, measure, fontFamily, block) {
+    const fitted = fitText(optionalString(value) ?? "", measureIn(measure, fontFamily, block.fontWeight), {
+        maxWidth: block.maxWidth,
+        maxLines: block.maxLines,
+        fontSize: block.fontSize,
+        minFontSize: Math.round(block.fontSize * block.floor),
+    });
+    return fitted.lines.map((text, index) => ({
+        text,
+        fontSize: fitted.fontSize,
+        fontWeight: block.fontWeight,
+        opacity: block.opacity,
+        ...(index === 0 &&
+            block.gapBefore !== undefined && { gapBefore: block.gapBefore }),
+    }));
+}
+//# sourceMappingURL=block.js.map

package/dist/layout/block.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"block.js","sourceRoot":"","sources":["../../src/layout/block.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAiCzC;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CACxB,KAAc,EACd,OAAoB,EACpB,UAAkB,EAClB,KAAkB;IAElB,MAAM,MAAM,GAAe,OAAO,CAChC,cAAc,CAAC,KAAK,CAAC,IAAI,EAAE,EAC3B,SAAS,CAAC,OAAO,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,CAAC,EAChD;QACE,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC;KACtD,CACF,CAAC;IAEF,OAAO,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;QACxC,IAAI;QACJ,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,GAAG,CAAC,KAAK,KAAK,CAAC;YACb,KAAK,CAAC,SAAS,KAAK,SAAS,IAAI,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC;KACnE,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/layout/box.d.ts

@@ -0,0 +1,20 @@
+import type { BoxStyle, Rect } from "./types.js";
+/**
+ * A rectangle: the plate a badge sits on, the surface of a panel, a rule along
+ * an edge. Everything in a template that is not text or an image is one of
+ * these.
+ *
+ * Attributes a style does not name are left out rather than written as their
+ * defaults, so the output says only what the template decided.
+ */
+export declare function box(rect: Rect, style?: BoxStyle): string;
+/**
+ * Shrink a rectangle inwards, which is how a template gets its margins. One
+ * number insets every edge; a partial one insets the edges it names.
+ *
+ * An inset larger than the rectangle collapses it to nothing rather than
+ * turning it inside out, since a negative width draws nothing anyway and an
+ * empty rectangle is easier to reason about than one with its corners crossed.
+ */
+export declare function inset(rect: Rect, amount: number | Partial<Record<"top" | "right" | "bottom" | "left", number>>): Rect;
+//# sourceMappingURL=box.d.ts.map

package/dist/layout/box.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"box.d.ts","sourceRoot":"","sources":["../../src/layout/box.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAejD;;;;;;;GAOG;AACH,wBAAgB,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,GAAE,QAAa,GAAG,MAAM,CAe5D;AAED;;;;;;;GAOG;AACH,wBAAgB,KAAK,CACnB,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,EAAE,MAAM,CAAC,CAAC,GAC5E,IAAI,CAgBN"}