@kensio/colophon 2.2.0 → 2.4.0

package/dist/meta/url.js

@@ -0,0 +1,34 @@
+/**
+ * A URL that names its own scheme. Schemes are case-insensitive, so `HTTPS://`
+ * is as absolute as `https://` and prefixing it would produce nonsense.
+ */
+const schemed = /^[a-z][a-z\d+.-]*:\/\//i;
+/** The scheme a base URL is served over, `https:` included. */
+function schemeOf(url) {
+    return /^[a-z][a-z\d+.-]*:/i.exec(url)?.[0];
+}
+/**
+ * Resolve an image URL against the site's base.
+ *
+ * Open Graph wants an absolute URL: a crawler reads the tag out of the page
+ * and has nothing to resolve a relative one against. A manifest holds whatever
+ * the placement's `urlBase` said, which is usually site-relative, so this is
+ * where the two halves meet.
+ *
+ * A URL that names its own scheme is returned untouched, since a placement
+ * pointing at a CDN has said everything there is to say. A scheme-relative one
+ * (`//cdn`) has not: it is relative to the page's scheme, which is exactly what
+ * a crawler reading the tag elsewhere does not have, so it borrows the base's.
+ */
+export function absoluteUrl(url, baseUrl) {
+    if (baseUrl === undefined || schemed.test(url)) {
+        return url;
+    }
+    if (url.startsWith("//")) {
+        const scheme = schemeOf(baseUrl);
+        return scheme === undefined ? url : `${scheme}${url}`;
+    }
+    const base = baseUrl.replace(/\/+$/, "");
+    return url.startsWith("/") ? `${base}${url}` : `${base}/${url}`;
+}
+//# sourceMappingURL=url.js.map

package/dist/meta/url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.js","sourceRoot":"","sources":["../../src/meta/url.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,OAAO,GAAG,yBAAyB,CAAC;AAE1C,+DAA+D;AAC/D,SAAS,QAAQ,CAAC,GAAW;IAC3B,OAAO,qBAAqB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AAC9C,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,WAAW,CAAC,GAAW,EAAE,OAA2B;IAClE,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/C,OAAO,GAAG,CAAC;IACb,CAAC;IAED,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;QACjC,OAAO,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,MAAM,GAAG,GAAG,EAAE,CAAC;IACxD,CAAC;IAED,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAEzC,OAAO,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,GAAG,EAAE,CAAC;AAClE,CAAC"}

package/dist/placement/check.d.ts

@@ -0,0 +1,16 @@
+import type { Placement } from "../types.js";
+/**
+ * Reject a placement that cannot place anything.
+ *
+ * The types require all of this, but a CLI user's config module is plain
+ * JavaScript with nothing checking it, and none of these omissions fails
+ * anywhere near the config: a missing `dir` surfaces as a complaint about an
+ * argument to `path`, and the rest as something not being a function. Key
+ * validation is no help either, since it is the option that is not there.
+ *
+ * This sits here rather than in `validate/`, which checks keys and the names
+ * of closed sets, for the reason `fonts/resolve.ts` does: what a value has to
+ * be is known by whatever is about to use it.
+ */
+export declare function assertPlacement(placement: Placement): void;
+//# sourceMappingURL=check.d.ts.map

package/dist/placement/check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../../src/placement/check.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI,CA+C1D"}

package/dist/placement/check.js

@@ -0,0 +1,40 @@
+/**
+ * Reject a placement that cannot place anything.
+ *
+ * The types require all of this, but a CLI user's config module is plain
+ * JavaScript with nothing checking it, and none of these omissions fails
+ * anywhere near the config: a missing `dir` surfaces as a complaint about an
+ * argument to `path`, and the rest as something not being a function. Key
+ * validation is no help either, since it is the option that is not there.
+ *
+ * This sits here rather than in `validate/`, which checks keys and the names
+ * of closed sets, for the reason `fonts/resolve.ts` does: what a value has to
+ * be is known by whatever is about to use it.
+ */
+export function assertPlacement(placement) {
+    const declared = placement;
+    if (declared.urlBase !== undefined && typeof declared.urlBase !== "string") {
+        throw new TypeError(`placement urlBase must be a string; it is prefixed to each image's path.`);
+    }
+    if (declared.hash !== undefined && typeof declared.hash !== "boolean") {
+        throw new TypeError(`placement hash must be true or false. Anything else reads as neither,` +
+            ` so the images would be written unhashed without a word about it.`);
+    }
+    if (placement.strategy === "public-dir") {
+        if (typeof declared.dir !== "string" || declared.dir === "") {
+            throw new TypeError(`placement "public-dir" needs a "dir" to write the images into.`);
+        }
+        return;
+    }
+    if (placement.strategy !== "custom") {
+        return;
+    }
+    if (typeof declared.path !== "function") {
+        throw new TypeError(`placement "custom" needs a "path" function saying where each image goes.`);
+    }
+    if (declared.url !== undefined && typeof declared.url !== "function") {
+        throw new TypeError(`placement "custom" takes a "url" function, or none at all for images` +
+            ` that are written but not served.`);
+    }
+}
+//# sourceMappingURL=check.js.map

package/dist/placement/check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.js","sourceRoot":"","sources":["../../src/placement/check.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,eAAe,CAAC,SAAoB;IAClD,MAAM,QAAQ,GAAG,SAMhB,CAAC;IAEF,IAAI,QAAQ,CAAC,OAAO,KAAK,SAAS,IAAI,OAAO,QAAQ,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QAC3E,MAAM,IAAI,SAAS,CACjB,0EAA0E,CAC3E,CAAC;IACJ,CAAC;IAED,IAAI,QAAQ,CAAC,IAAI,KAAK,SAAS,IAAI,OAAO,QAAQ,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QACtE,MAAM,IAAI,SAAS,CACjB,uEAAuE;YACrE,mEAAmE,CACtE,CAAC;IACJ,CAAC;IAED,IAAI,SAAS,CAAC,QAAQ,KAAK,YAAY,EAAE,CAAC;QACxC,IAAI,OAAO,QAAQ,CAAC,GAAG,KAAK,QAAQ,IAAI,QAAQ,CAAC,GAAG,KAAK,EAAE,EAAE,CAAC;YAC5D,MAAM,IAAI,SAAS,CACjB,gEAAgE,CACjE,CAAC;QACJ,CAAC;QACD,OAAO;IACT,CAAC;IAED,IAAI,SAAS,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACpC,OAAO;IACT,CAAC;IAED,IAAI,OAAO,QAAQ,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QACxC,MAAM,IAAI,SAAS,CACjB,0EAA0E,CAC3E,CAAC;IACJ,CAAC;IAED,IAAI,QAAQ,CAAC,GAAG,KAAK,SAAS,IAAI,OAAO,QAAQ,CAAC,GAAG,KAAK,UAAU,EAAE,CAAC;QACrE,MAAM,IAAI,SAAS,CACjB,sEAAsE;YACpE,mCAAmC,CACtC,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/placement/index.d.ts

@@ -0,0 +1,29 @@
+import type { ContentFile, OutputSize, Placement } from "../types.js";
+export { besideContent, imageName } from "./relative.js";
+/**
+ * Where one image ends up: the path its bytes are written to, and the URL it
+ * is served at, if the placement knows one.
+ */
+export interface PlacedImage {
+    readonly path: string;
+    readonly url: string | undefined;
+}
+/**
+ * Places each image of a build.
+ *
+ * The stamp is handed over whether or not the placement wants it: it is what a
+ * hashed filename is built from, and a placement that does not hash simply
+ * ignores it.
+ */
+export type Placer = (file: ContentFile, size: OutputSize, stamp: string) => PlacedImage;
+/**
+ * Build the function that places every image of a build.
+ *
+ * The strategies differ only in the root an image is placed under and whether
+ * it keeps the directories its post sits in: `beside-content` keeps them,
+ * which is the page-bundle convention, and `public-dir` drops them so that a
+ * flat directory can be served as one. Either way the same relative path
+ * makes the disk path and the URL, so the two cannot drift apart.
+ */
+export declare function createPlacer(placement: Placement | undefined, contentDir: string): Placer;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/placement/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAItE,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAEzD;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;CAClC;AAED;;;;;;GAMG;AACH,MAAM,MAAM,MAAM,GAAG,CACnB,IAAI,EAAE,WAAW,EACjB,IAAI,EAAE,UAAU,EAChB,KAAK,EAAE,MAAM,KACV,WAAW,CAAC;AAyBjB;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAC1B,SAAS,EAAE,SAAS,GAAG,SAAS,EAChC,UAAU,EAAE,MAAM,GACjB,MAAM,CAkCR"}

package/dist/placement/index.js

@@ -0,0 +1,61 @@
+import path from "node:path";
+import { assertPlacement } from "./check.js";
+import { besideContent, imageName } from "./relative.js";
+export { besideContent, imageName } from "./relative.js";
+/**
+ * Prefix a `urlBase` onto an image's path under the root that placed it.
+ *
+ * No base, no URL: a directory on disk does not say how, or whether, it is
+ * served, and a URL Colophon invented would be worse than the gap it fills,
+ * since the whole point of writing one down is that a site can trust it.
+ */
+function toUrl(urlBase, relative) {
+    if (urlBase === undefined) {
+        return undefined;
+    }
+    return `${urlBase.replace(/\/+$/, "")}/${relative}`;
+}
+/** Join a path that uses URL separators back into a platform path. */
+function under(root, relative) {
+    return path.join(root, ...relative.split("/"));
+}
+/**
+ * Build the function that places every image of a build.
+ *
+ * The strategies differ only in the root an image is placed under and whether
+ * it keeps the directories its post sits in: `beside-content` keeps them,
+ * which is the page-bundle convention, and `public-dir` drops them so that a
+ * flat directory can be served as one. Either way the same relative path
+ * makes the disk path and the URL, so the two cannot drift apart.
+ */
+export function createPlacer(placement, contentDir) {
+    if (placement !== undefined) {
+        assertPlacement(placement);
+    }
+    if (placement === undefined || placement.strategy === "beside-content") {
+        const urlBase = placement?.urlBase;
+        const isHashes = placement?.hash === true;
+        return (file, size, stamp) => {
+            const relative = besideContent(file, size, isHashes ? stamp : undefined);
+            return {
+                path: under(contentDir, relative),
+                url: toUrl(urlBase, relative),
+            };
+        };
+    }
+    if (placement.strategy === "public-dir") {
+        const isHashes = placement.hash === true;
+        return (file, size, stamp) => {
+            const relative = imageName(file, size, isHashes ? stamp : undefined);
+            return {
+                path: under(placement.dir, relative),
+                url: toUrl(placement.urlBase, relative),
+            };
+        };
+    }
+    return (file, size) => ({
+        path: placement.path(file, size),
+        url: placement.url?.(file, size),
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/placement/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/placement/index.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAEzD,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAwBzD;;;;;;GAMG;AACH,SAAS,KAAK,CACZ,OAA2B,EAC3B,QAAgB;IAEhB,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,QAAQ,EAAE,CAAC;AACtD,CAAC;AAED,sEAAsE;AACtE,SAAS,KAAK,CAAC,IAAY,EAAE,QAAgB;IAC3C,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;AACjD,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,YAAY,CAC1B,SAAgC,EAChC,UAAkB;IAElB,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC5B,eAAe,CAAC,SAAS,CAAC,CAAC;IAC7B,CAAC;IAED,IAAI,SAAS,KAAK,SAAS,IAAI,SAAS,CAAC,QAAQ,KAAK,gBAAgB,EAAE,CAAC;QACvE,MAAM,OAAO,GAAG,SAAS,EAAE,OAAO,CAAC;QACnC,MAAM,QAAQ,GAAG,SAAS,EAAE,IAAI,KAAK,IAAI,CAAC;QAE1C,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;YAC3B,MAAM,QAAQ,GAAG,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;YACzE,OAAO;gBACL,IAAI,EAAE,KAAK,CAAC,UAAU,EAAE,QAAQ,CAAC;gBACjC,GAAG,EAAE,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC;aAC9B,CAAC;QACJ,CAAC,CAAC;IACJ,CAAC;IAED,IAAI,SAAS,CAAC,QAAQ,KAAK,YAAY,EAAE,CAAC;QACxC,MAAM,QAAQ,GAAG,SAAS,CAAC,IAAI,KAAK,IAAI,CAAC;QAEzC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;YAC3B,MAAM,QAAQ,GAAG,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;YACrE,OAAO;gBACL,IAAI,EAAE,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE,QAAQ,CAAC;gBACpC,GAAG,EAAE,KAAK,CAAC,SAAS,CAAC,OAAO,EAAE,QAAQ,CAAC;aACxC,CAAC;QACJ,CAAC,CAAC;IACJ,CAAC;IAED,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;QACtB,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC;QAChC,GAAG,EAAE,SAAS,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC;KACjC,CAAC,CAAC;AACL,CAAC"}

package/dist/placement/relative.d.ts

@@ -0,0 +1,31 @@
+import type { ContentFile, OutputSize } from "../types.js";
+/**
+ * The filename one image is written under: `<slug>-<size>.png`, or
+ * `<slug>-<size>.<hash>.png` where the placement asks for a hash. The slug
+ * carries the post's keywords, and the size name keeps every image of a post
+ * distinct (`my-post-og.png`, `my-post-square.png`).
+ *
+ * A slug carrying directories of its own puts them in the name, so the image's
+ * path mirrors the route wherever it is placed. That is what the `route`
+ * strategy produces, and what a frontmatter `slug` of `docs/intro` means.
+ *
+ * The digest is the image's rebuild stamp: the props, the config and the size
+ * it is drawn from. Hashing the rendered bytes would be a truer name, but they
+ * are not known until the image has been rendered, and the point of the stamp
+ * is not rendering the ones that have not changed.
+ */
+export declare function imageName(file: ContentFile, size: OutputSize, hash: string | undefined): string;
+/**
+ * Where an image goes relative to the content root, in URL form.
+ *
+ * Slashes rather than the platform's separator, because this is also what a
+ * URL is built from: a Windows build must not serve `posts\my-post\a.png`.
+ * The disk path is joined back up per platform by whoever places it.
+ *
+ * A slug with directories of its own is placed from the content root, so its
+ * path mirrors the route. Resolving it beside the file would repeat the
+ * directories already in the slug, putting `services/iam` under
+ * `content/services/iam/`.
+ */
+export declare function besideContent(file: ContentFile, size: OutputSize, hash: string | undefined): string;
+//# sourceMappingURL=relative.d.ts.map

package/dist/placement/relative.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relative.d.ts","sourceRoot":"","sources":["../../src/placement/relative.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAW3D;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,WAAW,EACjB,IAAI,EAAE,UAAU,EAChB,IAAI,EAAE,MAAM,GAAG,SAAS,GACvB,MAAM,CAMR;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,WAAW,EACjB,IAAI,EAAE,UAAU,EAChB,IAAI,EAAE,MAAM,GAAG,SAAS,GACvB,MAAM,CAYR"}

package/dist/placement/relative.js

@@ -0,0 +1,53 @@
+import path from "node:path";
+/**
+ * How much of an image's digest goes in its filename.
+ *
+ * Eight hex characters is what the asset pipelines settle on, and it is the
+ * length at which a site would need tens of thousands of images before two of
+ * them were likely to collide.
+ */
+const hashLength = 8;
+/**
+ * The filename one image is written under: `<slug>-<size>.png`, or
+ * `<slug>-<size>.<hash>.png` where the placement asks for a hash. The slug
+ * carries the post's keywords, and the size name keeps every image of a post
+ * distinct (`my-post-og.png`, `my-post-square.png`).
+ *
+ * A slug carrying directories of its own puts them in the name, so the image's
+ * path mirrors the route wherever it is placed. That is what the `route`
+ * strategy produces, and what a frontmatter `slug` of `docs/intro` means.
+ *
+ * The digest is the image's rebuild stamp: the props, the config and the size
+ * it is drawn from. Hashing the rendered bytes would be a truer name, but they
+ * are not known until the image has been rendered, and the point of the stamp
+ * is not rendering the ones that have not changed.
+ */
+export function imageName(file, size, hash) {
+    const stem = `${file.slug}-${size.name}`;
+    return hash === undefined
+        ? `${stem}.png`
+        : `${stem}.${hash.slice(0, hashLength)}.png`;
+}
+/**
+ * Where an image goes relative to the content root, in URL form.
+ *
+ * Slashes rather than the platform's separator, because this is also what a
+ * URL is built from: a Windows build must not serve `posts\my-post\a.png`.
+ * The disk path is joined back up per platform by whoever places it.
+ *
+ * A slug with directories of its own is placed from the content root, so its
+ * path mirrors the route. Resolving it beside the file would repeat the
+ * directories already in the slug, putting `services/iam` under
+ * `content/services/iam/`.
+ */
+export function besideContent(file, size, hash) {
+    const name = imageName(file, size, hash);
+    if (file.slug.includes("/")) {
+        return name;
+    }
+    const directory = path.dirname(file.contentPath);
+    return directory === "." || directory === ""
+        ? name
+        : `${directory.split(path.sep).join("/")}/${name}`;
+}
+//# sourceMappingURL=relative.js.map

package/dist/placement/relative.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"relative.js","sourceRoot":"","sources":["../../src/placement/relative.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAI7B;;;;;;GAMG;AACH,MAAM,UAAU,GAAG,CAAC,CAAC;AAErB;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,SAAS,CACvB,IAAiB,EACjB,IAAgB,EAChB,IAAwB;IAExB,MAAM,IAAI,GAAG,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;IAEzC,OAAO,IAAI,KAAK,SAAS;QACvB,CAAC,CAAC,GAAG,IAAI,MAAM;QACf,CAAC,CAAC,GAAG,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,MAAM,CAAC;AACjD,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,aAAa,CAC3B,IAAiB,EACjB,IAAgB,EAChB,IAAwB;IAExB,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAEzC,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAEjD,OAAO,SAAS,KAAK,GAAG,IAAI,SAAS,KAAK,EAAE;QAC1C,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,GAAG,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC;AACvD,CAAC"}

package/dist/pool.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Map over `items` with at most `limit` calls to `worker` in flight at once,
+ * returning the results in input order.
+ *
+ * `Promise.all` over a mapped array starts everything at once, which for a
+ * few hundred images means a few hundred rasterisations queued on the thread
+ * pool with every pending bitmap held in memory. This starts `limit` workers
+ * instead and lets each pull the next item as it finishes, so the work in
+ * flight stays bounded however large the input is.
+ *
+ * The first rejection propagates, as it would from `Promise.all`. Items
+ * already in flight run to completion, since there is no cancelling a render,
+ * but no further ones are started.
+ *
+ * Throws if `limit` is not a positive integer.
+ */
+export declare function mapConcurrent<Item, Result>(items: readonly Item[], limit: number, worker: (item: Item, index: number) => Promise<Result>): Promise<Result[]>;
+//# sourceMappingURL=pool.d.ts.map

package/dist/pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pool.d.ts","sourceRoot":"","sources":["../src/pool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAC9C,KAAK,EAAE,SAAS,IAAI,EAAE,EACtB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,GACrD,OAAO,CAAC,MAAM,EAAE,CAAC,CA8CnB"}

package/dist/pool.js

@@ -0,0 +1,56 @@
+/**
+ * Map over `items` with at most `limit` calls to `worker` in flight at once,
+ * returning the results in input order.
+ *
+ * `Promise.all` over a mapped array starts everything at once, which for a
+ * few hundred images means a few hundred rasterisations queued on the thread
+ * pool with every pending bitmap held in memory. This starts `limit` workers
+ * instead and lets each pull the next item as it finishes, so the work in
+ * flight stays bounded however large the input is.
+ *
+ * The first rejection propagates, as it would from `Promise.all`. Items
+ * already in flight run to completion, since there is no cancelling a render,
+ * but no further ones are started.
+ *
+ * Throws if `limit` is not a positive integer.
+ */
+export async function mapConcurrent(items, limit, worker) {
+    // A limit below one starts no workers at all, and an empty `Promise.all`
+    // resolves happily, so the caller would get an empty result back as though
+    // there had been nothing to do. A build reporting success having rendered
+    // nothing is the failure worth being loud about.
+    if (!Number.isSafeInteger(limit) || limit < 1) {
+        throw new Error(`Invalid concurrency limit ${String(limit)}; expected a positive integer.`);
+    }
+    // Assigned by index rather than pushed, so results come back in input order
+    // however the workers interleave.
+    const results = [];
+    // One shared iterator is the queue: each worker pulls the next entry when it
+    // is free, so a slow item holds up only itself rather than a fixed share of
+    // the work.
+    const queue = items.entries();
+    let isStopped = false;
+    async function run() {
+        for (const [index, item] of queue) {
+            if (isStopped) {
+                return;
+            }
+            // Awaiting in the loop is the whole point: a worker takes one item at a
+            // time, and the parallelism comes from there being several of them.
+            // eslint-disable-next-line no-await-in-loop
+            results[index] = await worker(item, index);
+        }
+    }
+    const workers = Array.from({ length: Math.min(limit, items.length) }, () => run());
+    try {
+        await Promise.all(workers);
+    }
+    catch (error) {
+        // The run is already lost, so stop feeding it: a build that fails on the
+        // first file should not render the rest of the tree before it exits.
+        isStopped = true;
+        throw error;
+    }
+    return results;
+}
+//# sourceMappingURL=pool.js.map

package/dist/pool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pool.js","sourceRoot":"","sources":["../src/pool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,KAAsB,EACtB,KAAa,EACb,MAAsD;IAEtD,yEAAyE;IACzE,2EAA2E;IAC3E,0EAA0E;IAC1E,iDAAiD;IACjD,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QAC9C,MAAM,IAAI,KAAK,CACb,6BAA6B,MAAM,CAAC,KAAK,CAAC,gCAAgC,CAC3E,CAAC;IACJ,CAAC;IAED,4EAA4E;IAC5E,kCAAkC;IAClC,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,6EAA6E;IAC7E,4EAA4E;IAC5E,YAAY;IACZ,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC;IAC9B,IAAI,SAAS,GAAG,KAAK,CAAC;IAEtB,KAAK,UAAU,GAAG;QAChB,KAAK,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,KAAK,EAAE,CAAC;YAClC,IAAI,SAAS,EAAE,CAAC;gBACd,OAAO;YACT,CAAC;YACD,wEAAwE;YACxE,oEAAoE;YACpE,4CAA4C;YAC5C,OAAO,CAAC,KAAK,CAAC,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,EAAE,CACzE,GAAG,EAAE,CACN,CAAC;IAEF,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,yEAAyE;QACzE,qEAAqE;QACrE,SAAS,GAAG,IAAI,CAAC;QACjB,MAAM,KAAK,CAAC;IACd,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/props.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Read a prop as a string, coercing the scalar types YAML frontmatter yields
+ * (numbers, booleans) and returning `undefined` for anything else, since
+ * templates treat "not a usable string" and "absent" the same way.
+ */
+export declare function optionalString(value: unknown): string | undefined;
+//# sourceMappingURL=props.d.ts.map

package/dist/props.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"props.d.ts","sourceRoot":"","sources":["../src/props.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAcjE"}

package/dist/props.js

@@ -0,0 +1,17 @@
+/**
+ * Read a prop as a string, coercing the scalar types YAML frontmatter yields
+ * (numbers, booleans) and returning `undefined` for anything else, since
+ * templates treat "not a usable string" and "absent" the same way.
+ */
+export function optionalString(value) {
+    if (typeof value === "string") {
+        return value;
+    }
+    if (typeof value === "number" ||
+        typeof value === "boolean" ||
+        typeof value === "bigint") {
+        return String(value);
+    }
+    return undefined;
+}
+//# sourceMappingURL=props.js.map

package/dist/props.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"props.js","sourceRoot":"","sources":["../src/props.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IACE,OAAO,KAAK,KAAK,QAAQ;QACzB,OAAO,KAAK,KAAK,SAAS;QAC1B,OAAO,KAAK,KAAK,QAAQ,EACzB,CAAC;QACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/render/index.d.ts

@@ -0,0 +1,10 @@
+import type { ColophonConfig, MetaImageProps, RenderedMetaImage } from "../types.js";
+export { buildSvg } from "./svg.js";
+export { renderSvgToPng } from "./png.js";
+/**
+ * Render an image for every configured output size from a single set of props.
+ * This is the reusable core: it takes props and config and returns rendered
+ * bytes, with no filesystem or content-discovery concerns.
+ */
+export declare function renderMetaImages(props: MetaImageProps, config?: ColophonConfig): Promise<RenderedMetaImage[]>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/render/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EACd,iBAAiB,EAClB,MAAM,aAAa,CAAC;AAKrB,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpC,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE1C;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,cAAc,EACrB,MAAM,CAAC,EAAE,cAAc,GACtB,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAiB9B"}

package/dist/render/index.js

@@ -0,0 +1,27 @@
+import { resolveConfig } from "../config/index.js";
+import { resolveConfigForSize } from "../config/size.js";
+import { renderSvgToPng } from "./png.js";
+import { buildSvg } from "./svg.js";
+import { selectTemplate } from "./template.js";
+export { buildSvg } from "./svg.js";
+export { renderSvgToPng } from "./png.js";
+/**
+ * Render an image for every configured output size from a single set of props.
+ * This is the reusable core: it takes props and config and returns rendered
+ * bytes, with no filesystem or content-discovery concerns.
+ */
+export async function renderMetaImages(props, config) {
+    const resolved = resolveConfig(config);
+    // Validate the template once up front so a bad name fails fast.
+    selectTemplate(resolved, props.template);
+    return Promise.all(resolved.sizes.map(async (size) => {
+        // Each size renders with its own overrides folded in, so one size wanting
+        // a smaller minimum font does not mean a second pass over everything.
+        const sizeConfig = resolveConfigForSize(config, size);
+        const dimensions = { width: size.width, height: size.height };
+        const svg = await buildSvg(props, sizeConfig, dimensions);
+        const png = await renderSvgToPng(svg, dimensions, sizeConfig);
+        return { name: size.name, dimensions, svg, png };
+    }));
+}
+//# sourceMappingURL=index.js.map

package/dist/render/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/render/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAMzD,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpC,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpC,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE1C;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,KAAqB,EACrB,MAAuB;IAEvB,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IAEvC,gEAAgE;IAChE,cAAc,CAAC,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;IAEzC,OAAO,OAAO,CAAC,GAAG,CAChB,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QAChC,0EAA0E;QAC1E,sEAAsE;QACtE,MAAM,UAAU,GAAG,oBAAoB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QACtD,MAAM,UAAU,GAAG,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;QAC9D,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,KAAK,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;QAC1D,MAAM,GAAG,GAAG,MAAM,cAAc,CAAC,GAAG,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;QAC9D,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;IACnD,CAAC,CAAC,CACH,CAAC;AACJ,CAAC"}

package/dist/render/png.d.ts

@@ -0,0 +1,10 @@
+import type { Dimensions, ResolvedConfig } from "../types.js";
+/**
+ * Rasterise an SVG string to a PNG buffer, scaled to `dimensions.width`.
+ *
+ * Text is drawn with the fonts named by `config`, which is what keeps the
+ * output the same on a laptop, in CI and in a container. Height follows the
+ * SVG's own aspect ratio; `buildSvg` sizes it to match.
+ */
+export declare function renderSvgToPng(svg: string, dimensions: Dimensions, config?: ResolvedConfig): Promise<Buffer>;
+//# sourceMappingURL=png.d.ts.map

package/dist/render/png.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"png.d.ts","sourceRoot":"","sources":["../../src/render/png.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAkB9D;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,UAAU,EACtB,MAAM,GAAE,cAAgC,GACvC,OAAO,CAAC,MAAM,CAAC,CAOjB"}

package/dist/render/png.js

@@ -0,0 +1,30 @@
+import { renderAsync } from "@resvg/resvg-js";
+import { resolveConfig } from "../config/index.js";
+import { fallbackFamily, fontFilePaths } from "../fonts/index.js";
+/**
+ * Font options for the rasteriser: the configured font files, and whether to
+ * fall back to the machine's own.
+ */
+async function fontOptions(config) {
+    const fallback = fallbackFamily(config.fonts);
+    return {
+        loadSystemFonts: config.systemFonts,
+        fontFiles: await fontFilePaths(config.fonts),
+        ...(fallback !== undefined && { defaultFontFamily: fallback }),
+    };
+}
+/**
+ * Rasterise an SVG string to a PNG buffer, scaled to `dimensions.width`.
+ *
+ * Text is drawn with the fonts named by `config`, which is what keeps the
+ * output the same on a laptop, in CI and in a container. Height follows the
+ * SVG's own aspect ratio; `buildSvg` sizes it to match.
+ */
+export async function renderSvgToPng(svg, dimensions, config = resolveConfig()) {
+    const rendered = await renderAsync(svg, {
+        fitTo: { mode: "width", value: dimensions.width },
+        font: await fontOptions(config),
+    });
+    return rendered.asPng();
+}
+//# sourceMappingURL=png.js.map

package/dist/render/png.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"png.js","sourceRoot":"","sources":["../../src/render/png.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE9C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGlE;;;GAGG;AACH,KAAK,UAAU,WAAW,CACxB,MAAsB;IAEtB,MAAM,QAAQ,GAAG,cAAc,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAE9C,OAAO;QACL,eAAe,EAAE,MAAM,CAAC,WAAW;QACnC,SAAS,EAAE,MAAM,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC;QAC5C,GAAG,CAAC,QAAQ,KAAK,SAAS,IAAI,EAAE,iBAAiB,EAAE,QAAQ,EAAE,CAAC;KAC/D,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,GAAW,EACX,UAAsB,EACtB,MAAM,GAAmB,aAAa,EAAE;IAExC,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,GAAG,EAAE;QACtC,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,CAAC,KAAK,EAAE;QACjD,IAAI,EAAE,MAAM,WAAW,CAAC,MAAM,CAAC;KAChC,CAAC,CAAC;IAEH,OAAO,QAAQ,CAAC,KAAK,EAAE,CAAC;AAC1B,CAAC"}

package/dist/render/svg.d.ts

@@ -0,0 +1,12 @@
+import type { Dimensions, MetaImageProps, ResolvedConfig } from "../types.js";
+/**
+ * Build the complete SVG document for one image: the enclosing `<svg>` root,
+ * the config-driven background, and the template's foreground content.
+ *
+ * Asynchronous because a template may need to load resources. The `code`
+ * template fetches syntax grammars and themes on demand, the fonts the text is
+ * measured against have to be read before a template can lay it out, and so do
+ * the logo, the avatar and any background photo.
+ */
+export declare function buildSvg(props: MetaImageProps, config: ResolvedConfig, dimensions: Dimensions): Promise<string>;
+//# sourceMappingURL=svg.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"svg.d.ts","sourceRoot":"","sources":["../../src/render/svg.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAK9E;;;;;;;;GAQG;AACH,wBAAsB,QAAQ,CAC5B,KAAK,EAAE,cAAc,EACrB,MAAM,EAAE,cAAc,EACtB,UAAU,EAAE,UAAU,GACrB,OAAO,CAAC,MAAM,CAAC,CA4BjB"}

package/dist/render/svg.js

@@ -0,0 +1,35 @@
+import { backgroundSvg } from "../background.js";
+import { loadImages } from "../image/index.js";
+import { createMeasurer } from "../measure/index.js";
+import { selectTemplate } from "./template.js";
+const backgroundId = "colophon-bg";
+/**
+ * Build the complete SVG document for one image: the enclosing `<svg>` root,
+ * the config-driven background, and the template's foreground content.
+ *
+ * Asynchronous because a template may need to load resources. The `code`
+ * template fetches syntax grammars and themes on demand, the fonts the text is
+ * measured against have to be read before a template can lay it out, and so do
+ * the logo, the avatar and any background photo.
+ */
+export async function buildSvg(props, config, dimensions) {
+    const template = selectTemplate(config, props.template);
+    const [measure, images] = await Promise.all([
+        createMeasurer(config),
+        loadImages(config, props),
+    ]);
+    const background = backgroundSvg(config.background, dimensions, backgroundId, images.background);
+    const body = await template.render({
+        props,
+        config,
+        dimensions,
+        measure,
+        logo: images.logo,
+        avatar: images.avatar,
+    });
+    const { width, height } = dimensions;
+    return (`<svg width="${String(width)}" height="${String(height)}"` +
+        ` viewBox="0 0 ${String(width)} ${String(height)}"` +
+        ` xmlns="http://www.w3.org/2000/svg">${background}${body}</svg>`);
+}
+//# sourceMappingURL=svg.js.map

package/dist/render/svg.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"svg.js","sourceRoot":"","sources":["../../src/render/svg.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C,MAAM,YAAY,GAAG,aAAa,CAAC;AAEnC;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,KAAqB,EACrB,MAAsB,EACtB,UAAsB;IAEtB,MAAM,QAAQ,GAAG,cAAc,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;IACxD,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC1C,cAAc,CAAC,MAAM,CAAC;QACtB,UAAU,CAAC,MAAM,EAAE,KAAK,CAAC;KAC1B,CAAC,CAAC;IAEH,MAAM,UAAU,GAAG,aAAa,CAC9B,MAAM,CAAC,UAAU,EACjB,UAAU,EACV,YAAY,EACZ,MAAM,CAAC,UAAU,CAClB,CAAC;IACF,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC;QACjC,KAAK;QACL,MAAM;QACN,UAAU;QACV,OAAO;QACP,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,MAAM,EAAE,MAAM,CAAC,MAAM;KACtB,CAAC,CAAC;IACH,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC;IAErC,OAAO,CACL,eAAe,MAAM,CAAC,KAAK,CAAC,aAAa,MAAM,CAAC,MAAM,CAAC,GAAG;QAC1D,iBAAiB,MAAM,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,GAAG;QACnD,uCAAuC,UAAU,GAAG,IAAI,QAAQ,CACjE,CAAC;AACJ,CAAC"}

package/dist/render/template.d.ts

@@ -0,0 +1,9 @@
+import type { ResolvedConfig, Template } from "../types.js";
+/**
+ * Look up the template a set of props asks for, failing with the names that
+ * are actually available. A template name comes from frontmatter, so getting
+ * it wrong is routine, and "unknown template" alone leaves the author guessing
+ * at what the project registered.
+ */
+export declare function selectTemplate(config: ResolvedConfig, name: string): Template;
+//# sourceMappingURL=template.d.ts.map

package/dist/render/template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../../src/render/template.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5D;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,QAAQ,CAa7E"}

package/dist/render/template.js

@@ -0,0 +1,17 @@
+/**
+ * Look up the template a set of props asks for, failing with the names that
+ * are actually available. A template name comes from frontmatter, so getting
+ * it wrong is routine, and "unknown template" alone leaves the author guessing
+ * at what the project registered.
+ */
+export function selectTemplate(config, name) {
+    const template = config.templates[name];
+    if (template === undefined) {
+        const available = Object.keys(config.templates)
+            .toSorted((a, b) => a.localeCompare(b))
+            .join(", ");
+        throw new Error(`Unknown template "${name}". Available templates: ${available}.`);
+    }
+    return template;
+}
+//# sourceMappingURL=template.js.map

package/dist/render/template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.js","sourceRoot":"","sources":["../../src/render/template.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,MAAsB,EAAE,IAAY;IACjE,MAAM,QAAQ,GAAG,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAExC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC;aAC5C,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;aACtC,IAAI,CAAC,IAAI,CAAC,CAAC;QACd,MAAM,IAAI,KAAK,CACb,qBAAqB,IAAI,2BAA2B,SAAS,GAAG,CACjE,CAAC;IACJ,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}