@kensio/colophon 2.3.0 → 2.5.0

package/dist/config/size.js

@@ -1,16 +1,20 @@
+import { themePalette } from "../theme/index.js";
 import { DEFAULT_COLORS } from "./defaults.js";
 import { resolveConfig } from "./index.js";
 /**
  * Merge a size's colour overrides onto the config's.
  *
- * A size may name any single shade, so the merge starts from the full default
- * palette when the config sets no colours of its own. Starting from nothing
- * instead would hand `resolveColors` a lone `foreground`, and its rule that a
- * bare `brand` colours the whole gradient would then flatten the default
- * gradient — a size asking only for darker text would silently lose it.
+ * A size may name any single shade, so the merge starts from a full palette:
+ * the config's, else the theme in force, else the neutral default. Starting
+ * from nothing instead would hand `resolveColors` a lone `foreground`, and its
+ * rule that a bare `brand` colours the whole gradient would then flatten the
+ * default gradient, so a size asking only for darker text would silently lose
+ * it. Taking the theme's palette matters for the same reason: without it a
+ * size changing one shade of a themed config would drop the other three back
+ * to the default indigo.
  */
-function mergeColors(base, overrides) {
-    return { ...(base ?? DEFAULT_COLORS), ...overrides };
+function mergeColors(base, theme, overrides) {
+    return { ...(base ?? themePalette(theme) ?? DEFAULT_COLORS), ...overrides };
 }
 /**
  * Apply a size's own overrides to a config and resolve the result: the config
@@ -18,7 +22,7 @@ function mergeColors(base, overrides) {
  *
  * The overrides are folded into the user config and the whole thing resolved
  * again, rather than patched onto an already-resolved config, so that anything
- * derived stays consistent — a size that overrides `colors.brand` gets the
+ * derived stays consistent. A size that overrides `colors.brand` gets the
  * default gradient rebuilt around its brand, exactly as a config setting the
  * same colour at the top level would.
  *
@@ -28,19 +32,28 @@ function mergeColors(base, overrides) {
  * different keys, so half of one over half of another is not a background at
  * all, and `badge` carries a required `text` that a partial override could not
  * supply.
+ *
+ * A size's `theme` replaces the config's, and then applies exactly as it would
+ * at the top level: as defaults, under anything the config names outright. So
+ * a config with its own `background` keeps it whatever theme a size asks for,
+ * and a size wanting the whole look of one has the same answer a config does,
+ * which is to stop naming the fields it wants the theme to fill in.
  */
 export function resolveConfigForSize(config, size) {
     const base = config ?? {};
     return resolveConfig({
         ...base,
+        ...(size.theme !== undefined && { theme: size.theme }),
         ...(size.colors !== undefined && {
-            colors: mergeColors(base.colors, size.colors),
+            colors: mergeColors(base.colors, size.theme ?? base.theme, size.colors),
         }),
+        ...(size.texture !== undefined && { texture: size.texture }),
         ...(size.code !== undefined && { code: { ...base.code, ...size.code } }),
         ...(size.background !== undefined && { background: size.background }),
         ...(size.fontFamily !== undefined && { fontFamily: size.fontFamily }),
         ...(size.footer !== undefined && { footer: size.footer }),
         ...(size.badge !== undefined && { badge: size.badge }),
+        ...(size.logo !== undefined && { logo: size.logo }),
     });
 }
 //# sourceMappingURL=size.js.map

package/dist/config/size.js.map

@@ -1 +1 @@
-{"version":3,"file":"size.js","sourceRoot":"","sources":["../../src/config/size.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C;;;;;;;;GAQG;AACH,SAAS,WAAW,CAClB,IAA6B,EAC7B,SAA+B;IAE/B,OAAO,EAAE,GAAG,CAAC,IAAI,IAAI,cAAc,CAAC,EAAE,GAAG,SAAS,EAAE,CAAC;AACvD,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,oBAAoB,CAClC,MAAkC,EAClC,IAAgB;IAEhB,MAAM,IAAI,GAAG,MAAM,IAAI,EAAE,CAAC;IAE1B,OAAO,aAAa,CAAC;QACnB,GAAG,IAAI;QACP,GAAG,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI;YAC/B,MAAM,EAAE,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC;SAC9C,CAAC;QACF,GAAG,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,EAAE,IAAI,EAAE,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;QACxE,GAAG,CAAC,IAAI,CAAC,UAAU,KAAK,SAAS,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC;QACrE,GAAG,CAAC,IAAI,CAAC,UAAU,KAAK,SAAS,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC;QACrE,GAAG,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;QACzD,GAAG,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;KACvD,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"size.js","sourceRoot":"","sources":["../../src/config/size.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C;;;;;;;;;;;GAWG;AACH,SAAS,WAAW,CAClB,IAA6B,EAC7B,KAA4B,EAC5B,SAA+B;IAE/B,OAAO,EAAE,GAAG,CAAC,IAAI,IAAI,YAAY,CAAC,KAAK,CAAC,IAAI,cAAc,CAAC,EAAE,GAAG,SAAS,EAAE,CAAC;AAC9E,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,oBAAoB,CAClC,MAAkC,EAClC,IAAgB;IAEhB,MAAM,IAAI,GAAG,MAAM,IAAI,EAAE,CAAC;IAE1B,OAAO,aAAa,CAAC;QACnB,GAAG,IAAI;QACP,GAAG,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;QACtD,GAAG,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI;YAC/B,MAAM,EAAE,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC;SACxE,CAAC;QACF,GAAG,CAAC,IAAI,CAAC,OAAO,KAAK,SAAS,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC;QAC5D,GAAG,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,EAAE,IAAI,EAAE,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;QACxE,GAAG,CAAC,IAAI,CAAC,UAAU,KAAK,SAAS,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC;QACrE,GAAG,CAAC,IAAI,CAAC,UAAU,KAAK,SAAS,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC;QACrE,GAAG,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;QACzD,GAAG,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;QACtD,GAAG,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;KACpD,CAAC,CAAC;AACL,CAAC"}

package/dist/content/props.d.ts

@@ -4,11 +4,11 @@ export declare function coerceString(value: unknown): string | undefined;
 /**
  * Extract {@link MetaImageProps} from a parsed frontmatter object, or return
  * `undefined` if this file should be skipped (nothing to build props from, or
- * no usable template). Pure — no filesystem access.
+ * no usable template). Pure, with no filesystem access.
  *
  * Props can come from two places: the post's own props object, and a project's
  * `props` mapper reading the frontmatter it already has. Where both speak the
- * post wins, field by field — the mapper describes the site's usual shape, and
+ * post wins, field by field. The mapper describes the site's usual shape, and
  * a post that says otherwise is saying so on purpose.
  */
 export declare function extractProps(frontmatter: Record<string, unknown>, options?: Pick<ContentOptions, "propsKey" | "templateField" | "defaultTemplate" | "props">): MetaImageProps | undefined;

package/dist/content/props.js

@@ -20,11 +20,11 @@ const namedFields = new Set(["template", "title", "subtitle", "version"]);
 /**
  * Extract {@link MetaImageProps} from a parsed frontmatter object, or return
  * `undefined` if this file should be skipped (nothing to build props from, or
- * no usable template). Pure — no filesystem access.
+ * no usable template). Pure, with no filesystem access.
  *
  * Props can come from two places: the post's own props object, and a project's
  * `props` mapper reading the frontmatter it already has. Where both speak the
- * post wins, field by field — the mapper describes the site's usual shape, and
+ * post wins, field by field. The mapper describes the site's usual shape, and
  * a post that says otherwise is saying so on purpose.
  */
 export function extractProps(frontmatter, options = {}) {

package/dist/content/slug.d.ts

@@ -3,9 +3,9 @@ import type { SlugStrategy } from "../types.js";
  * Derive a slug from a content file's path, relative to the root of the walk.
  *
  * `basename` gives the filename without extension, or the parent directory for
- * `index.*` — the page-bundle convention, where an image sits beside its post.
- * `route` keeps the directories, so a site addressed by route gets a slug that
- * matches the address rather than just its last segment.
+ * `index.*`, which is the page-bundle convention where an image sits beside its
+ * post. `route` keeps the directories, so a site addressed by route gets a slug
+ * that matches the address rather than just its last segment.
  *
  * The path must be relative to the content root for `route` to mean anything;
  * `basename` reads the same either way.
@@ -14,8 +14,8 @@ export declare function slugFromPath(contentPath: string, strategy?: SlugStrateg
 /**
  * Reject a slug that would name a file outside the tree it came from.
  *
- * A slug is a filename, and may carry directories under the `route` strategy —
- * but a declared one is written by hand, and `slug: ../../../tmp/x` would have
+ * A slug is a filename, and may carry directories under the `route` strategy.
+ * But a declared one is written by hand, and `slug: ../../../tmp/x` would have
  * `generate` create directories and write an image there. Nothing derived from
  * a path can look like this, so the check only ever fires on frontmatter.
  */

package/dist/content/slug.js

@@ -3,9 +3,9 @@ import path from "node:path";
  * Derive a slug from a content file's path, relative to the root of the walk.
  *
  * `basename` gives the filename without extension, or the parent directory for
- * `index.*` — the page-bundle convention, where an image sits beside its post.
- * `route` keeps the directories, so a site addressed by route gets a slug that
- * matches the address rather than just its last segment.
+ * `index.*`, which is the page-bundle convention where an image sits beside its
+ * post. `route` keeps the directories, so a site addressed by route gets a slug
+ * that matches the address rather than just its last segment.
  *
  * The path must be relative to the content root for `route` to mean anything;
  * `basename` reads the same either way.
@@ -25,15 +25,15 @@ export function slugFromPath(contentPath, strategy = "basename") {
     }
     const route = base === "index" ? directory : path.join(directory, base);
     // `path.dirname` of a root-level file is ".", which as a route is the site
-    // root — and the one place there is no directory name to fall back on.
+    // root, and the one place there is no directory name to fall back on.
     const normalised = route === "." ? "index" : route.split(path.sep).join("/");
     return normalised;
 }
 /**
  * Reject a slug that would name a file outside the tree it came from.
  *
- * A slug is a filename, and may carry directories under the `route` strategy —
- * but a declared one is written by hand, and `slug: ../../../tmp/x` would have
+ * A slug is a filename, and may carry directories under the `route` strategy.
+ * But a declared one is written by hand, and `slug: ../../../tmp/x` would have
  * `generate` create directories and write an image there. Nothing derived from
  * a path can look like this, so the check only ever fires on frontmatter.
  */

package/dist/content/slug.js.map

@@ -1 +1 @@
-{"version":3,"file":"slug.js","sourceRoot":"","sources":["../../src/content/slug.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAI7B;;;;;;;;;;GAUG;AACH,MAAM,UAAU,YAAY,CAC1B,WAAmB,EACnB,QAAQ,GAAiB,UAAU;IAEnC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAC5C,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;IACnD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAE5C,IAAI,QAAQ,KAAK,UAAU,EAAE,CAAC;QAC5B,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;YACrB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,0EAA0E;QAC1E,0EAA0E;QAC1E,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QACxC,OAAO,MAAM,KAAK,EAAE,IAAI,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC;IACzD,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IACxE,2EAA2E;IAC3E,uEAAuE;IACvE,MAAM,UAAU,GAAG,KAAK,KAAK,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC7E,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAY,EAAE,WAAmB;IACrE,0EAA0E;IAC1E,yDAAyD;IACzD,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,CAAC,EAAE,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC;IACzC,MAAM,UAAU,GACd,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC3D,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAE1B,IAAI,UAAU,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,iBAAiB,IAAI,QAAQ,WAAW,gCAAgC;YACtE,mEAAmE;YACnE,YAAY,CACf,CAAC;IACJ,CAAC;AACH,CAAC"}
+{"version":3,"file":"slug.js","sourceRoot":"","sources":["../../src/content/slug.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAI7B;;;;;;;;;;GAUG;AACH,MAAM,UAAU,YAAY,CAC1B,WAAmB,EACnB,QAAQ,GAAiB,UAAU;IAEnC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAC5C,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;IACnD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAE5C,IAAI,QAAQ,KAAK,UAAU,EAAE,CAAC;QAC5B,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;YACrB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,0EAA0E;QAC1E,0EAA0E;QAC1E,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QACxC,OAAO,MAAM,KAAK,EAAE,IAAI,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC;IACzD,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IACxE,2EAA2E;IAC3E,sEAAsE;IACtE,MAAM,UAAU,GAAG,KAAK,KAAK,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC7E,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAY,EAAE,WAAmB;IACrE,0EAA0E;IAC1E,yDAAyD;IACzD,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,CAAC,EAAE,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC;IACzC,MAAM,UAAU,GACd,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC3D,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAE1B,IAAI,UAAU,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,iBAAiB,IAAI,QAAQ,WAAW,gCAAgC;YACtE,mEAAmE;YACnE,YAAY,CACf,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/content/walk.d.ts

@@ -10,7 +10,7 @@ export interface WalkOptions extends ContentOptions {
 /**
  * Walk a content tree, read each file's frontmatter with `gray-matter`, and
  * return the files that image props can be built for. This is the host-project
- * concern — finding content and reading frontmatter — kept separate from
+ * concern of finding content and reading frontmatter, kept separate from
  * rendering.
  */
 export declare function walkContent(options: WalkOptions): Promise<ContentFile[]>;

package/dist/content/walk.js

@@ -24,7 +24,7 @@ async function collectContentFiles(dir, extensions) {
 /**
  * Walk a content tree, read each file's frontmatter with `gray-matter`, and
  * return the files that image props can be built for. This is the host-project
- * concern — finding content and reading frontmatter — kept separate from
+ * concern of finding content and reading frontmatter, kept separate from
  * rendering.
  */
 export async function walkContent(options) {

package/dist/fonts/index.d.ts

@@ -3,8 +3,9 @@ export { fontFilePaths } from "./materialise.js";
 export { resolveFonts } from "./resolve.js";
 /**
  * The family the rasteriser should fall back to when a `font-family` names
- * something it has not loaded — the first declared family, so the fallback is
- * the same wherever the build runs rather than whichever font loaded first.
+ * something it has not loaded. It is the first declared family, so the
+ * fallback is the same wherever the build runs rather than whichever font
+ * loaded first.
  */
 export declare function fallbackFamily(fonts: readonly FontSource[]): string | undefined;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/fonts/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,SAAS,UAAU,EAAE,GAC3B,MAAM,GAAG,SAAS,CAEpB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/fonts/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,SAAS,UAAU,EAAE,GAC3B,MAAM,GAAG,SAAS,CAEpB"}

package/dist/fonts/index.js

@@ -2,8 +2,9 @@ export { fontFilePaths } from "./materialise.js";
 export { resolveFonts } from "./resolve.js";
 /**
  * The family the rasteriser should fall back to when a `font-family` names
- * something it has not loaded — the first declared family, so the fallback is
- * the same wherever the build runs rather than whichever font loaded first.
+ * something it has not loaded. It is the first declared family, so the
+ * fallback is the same wherever the build runs rather than whichever font
+ * loaded first.
  */
 export function fallbackFamily(fonts) {
     return fonts.find((font) => font.family !== undefined)?.family;

package/dist/fonts/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/fonts/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAC5B,KAA4B;IAE5B,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,EAAE,MAAM,CAAC;AACjE,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/fonts/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAC5B,KAA4B;IAE5B,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,EAAE,MAAM,CAAC;AACjE,CAAC"}

package/dist/fonts/resolve.js

@@ -7,7 +7,7 @@ function label(index) {
  * Validate one font source and make its path absolute.
  *
  * The rasteriser ignores a font file it cannot read and renders the text in
- * whatever else it has loaded — or, with system fonts off, renders no text at
+ * whatever else it has loaded, or, with system fonts off, renders no text at
  * all. A typo in a path would therefore show up as a blank image rather than
  * an error, so the path is checked here instead.
  */

package/dist/generate/extra.js

@@ -8,7 +8,7 @@ import { isRecord } from "../validate/check.js";
  * JavaScript with nothing checking it, and neither omission fails anywhere
  * near the config: a missing `output` surfaces as a complaint about an
  * argument to `path`, and missing props as a property read on `undefined`.
- * Key validation is no help either — it is the option that is not there.
+ * Key validation is no help either, since it is the option that is not there.
  */
 function checkImage(image, index) {
     // The types say what should be here; this exists for when it is not.
@@ -48,9 +48,9 @@ export function extraJobs(config, resolved, stamper) {
             // relative path against the working directory anyway, and the build log
             // reads better saying what the config said.
             outputPath: image.output,
-            // An extra names its own path, so the placement — which maps posts to
-            // paths — has nothing to say about where this one is served, nor about
-            // hashing a filename it did not choose.
+            // An extra names its own path, and the placement maps posts to paths, so
+            // it has nothing to say about where this one is served, nor about hashing
+            // a filename it did not choose.
             url: undefined,
             stamp: stamper.stamp(image.props, size),
             config: resolveConfigForSize(config, size),

package/dist/generate/extra.js.map

@@ -1 +1 @@
-{"version":3,"file":"extra.js","sourceRoot":"","sources":["../../src/generate/extra.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAGzD,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAGhD;;;;;;;;GAQG;AACH,SAAS,UAAU,CAAC,KAAiB,EAAE,KAAa;IAClD,qEAAqE;IACrE,MAAM,QAAQ,GAAG,KAGhB,CAAC;IACF,MAAM,KAAK,GAAG,SAAS,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC;IAExC,IAAI,OAAO,QAAQ,CAAC,MAAM,KAAK,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;QAClE,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,gDAAgD,CAAC,CAAC;IAC5E,CAAC;IAED,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,+CAA+C,CAAC,CAAC;IAC3E,CAAC;AACH,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,SAAS,CACvB,MAAkC,EAClC,QAAwB,EACxB,OAAgB;IAEhB,2EAA2E;IAC3E,MAAM,CAAC,SAAS,GAAG,YAAY,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC;IAErD,OAAO,CAAC,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;QAChD,UAAU,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QACzB,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,IAAI,SAAS,CAAC;QAErC,OAAO;YACL,WAAW,EAAE,SAAS;YACtB,wDAAwD;YACxD,IAAI,EAAE,SAAS;YACf,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,IAAI;YACJ,wEAAwE;YACxE,wEAAwE;YACxE,4CAA4C;YAC5C,UAAU,EAAE,KAAK,CAAC,MAAM;YACxB,sEAAsE;YACtE,uEAAuE;YACvE,wCAAwC;YACxC,GAAG,EAAE,SAAS;YACd,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC;YACvC,MAAM,EAAE,oBAAoB,CAAC,MAAM,EAAE,IAAI,CAAC;SAC3C,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"extra.js","sourceRoot":"","sources":["../../src/generate/extra.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAGzD,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAGhD;;;;;;;;GAQG;AACH,SAAS,UAAU,CAAC,KAAiB,EAAE,KAAa;IAClD,qEAAqE;IACrE,MAAM,QAAQ,GAAG,KAGhB,CAAC;IACF,MAAM,KAAK,GAAG,SAAS,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC;IAExC,IAAI,OAAO,QAAQ,CAAC,MAAM,KAAK,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;QAClE,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,gDAAgD,CAAC,CAAC;IAC5E,CAAC;IAED,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,+CAA+C,CAAC,CAAC;IAC3E,CAAC;AACH,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,SAAS,CACvB,MAAkC,EAClC,QAAwB,EACxB,OAAgB;IAEhB,2EAA2E;IAC3E,MAAM,CAAC,SAAS,GAAG,YAAY,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC;IAErD,OAAO,CAAC,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;QAChD,UAAU,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QACzB,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,IAAI,SAAS,CAAC;QAErC,OAAO;YACL,WAAW,EAAE,SAAS;YACtB,wDAAwD;YACxD,IAAI,EAAE,SAAS;YACf,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,IAAI;YACJ,wEAAwE;YACxE,wEAAwE;YACxE,4CAA4C;YAC5C,UAAU,EAAE,KAAK,CAAC,MAAM;YACxB,yEAAyE;YACzE,0EAA0E;YAC1E,gCAAgC;YAChC,GAAG,EAAE,SAAS;YACd,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC;YACvC,MAAM,EAAE,oBAAoB,CAAC,MAAM,EAAE,IAAI,CAAC;SAC3C,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/generate/options.d.ts

@@ -7,7 +7,7 @@ export interface GeneratedImage {
     /**
      * The content file this image came from, relative to the content root.
      * `undefined` for a config `extra` image: there is no post behind it, and
-     * naming one — the output path, say — would quietly break anything grouping
+     * naming one after its output path would quietly break anything grouping
      * results by the post they belong to.
      */
     readonly contentPath: string | undefined;

package/dist/generate/outputs.d.ts

@@ -2,8 +2,8 @@ import type { RenderJob } from "./job.js";
 /**
  * Reject a manifest written over one of the images it describes.
  *
- * The manifest is written last, so it wins: the image is replaced by JSON, and
- * — its stamp gone with it — rendered again on every build afterwards. It is
+ * The manifest is written last, so it wins: the image is replaced by JSON,
+ * losing its stamp with it, and rendered again on every build afterwards. It is
  * the same collision as two images sharing a path, so it is answered here,
  * where a path is already compared the way the filesystem would.
  */
@@ -16,8 +16,8 @@ export declare function assertManifestIsNotAnImage(manifestPath: string | undefi
  * renders both again, for ever.
  *
  * Every job is checked, posts included. That used to be older ground worth
- * leaving alone — two posts collided only if they shared a directory and a
- * slug — but `public-dir` gathers a whole tree into one directory, where every
+ * leaving alone, since two posts collided only if they shared a directory and
+ * a slug. But `public-dir` gathers a whole tree into one directory, where every
  * post sharing a basename with another lands on it. Naming both sides is what
  * makes that worth reporting: the path alone does not say which two posts.
  *

package/dist/generate/outputs.js

@@ -22,8 +22,8 @@ function describe(job) {
 /**
  * Reject a manifest written over one of the images it describes.
  *
- * The manifest is written last, so it wins: the image is replaced by JSON, and
- * — its stamp gone with it — rendered again on every build afterwards. It is
+ * The manifest is written last, so it wins: the image is replaced by JSON,
+ * losing its stamp with it, and rendered again on every build afterwards. It is
  * the same collision as two images sharing a path, so it is answered here,
  * where a path is already compared the way the filesystem would.
  */
@@ -47,8 +47,8 @@ export function assertManifestIsNotAnImage(manifestPath, jobs) {
  * renders both again, for ever.
  *
  * Every job is checked, posts included. That used to be older ground worth
- * leaving alone — two posts collided only if they shared a directory and a
- * slug — but `public-dir` gathers a whole tree into one directory, where every
+ * leaving alone, since two posts collided only if they shared a directory and
+ * a slug. But `public-dir` gathers a whole tree into one directory, where every
  * post sharing a basename with another lands on it. Naming both sides is what
  * makes that worth reporting: the path alone does not say which two posts.
  *

package/dist/highlight/language.d.ts

@@ -6,9 +6,8 @@ import type { BundledLanguage, BundledTheme, SpecialLanguage } from "shiki";
  */
 export declare function resolveLanguage(language: string): BundledLanguage | SpecialLanguage;
 /**
- * Validate a configured theme name. Unlike languages — which come from post
- * frontmatter and fall back quietly — a bad theme is a config mistake worth
- * failing on.
+ * 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 declare function resolveTheme(theme: string): BundledTheme;
 //# sourceMappingURL=language.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"language.d.ts","sourceRoot":"","sources":["../../src/highlight/language.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,OAAO,CAAC;AAsB5E;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,GACf,eAAe,GAAG,eAAe,CAOnC;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,CAQxD"}
+{"version":3,"file":"language.d.ts","sourceRoot":"","sources":["../../src/highlight/language.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,OAAO,CAAC;AAsB5E;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,GACf,eAAe,GAAG,eAAe,CAOnC;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,CAQxD"}

package/dist/highlight/language.js

@@ -1,7 +1,7 @@
 import { bundledLanguages, bundledThemes } from "shiki";
 /**
  * Language names that differ between Pygments (which the original Python
- * script used) and Shiki. Everything else is passed through — Shiki already
+ * script used) and Shiki. Everything else is passed through, since Shiki
  * understands `bash`, `python`, `typescript`, `yaml`, `toml`, `sql`, `json`,
  * `js` and `text`.
  */
@@ -29,9 +29,8 @@ export function resolveLanguage(language) {
         : plainText;
 }
 /**
- * Validate a configured theme name. Unlike languages — which come from post
- * frontmatter and fall back quietly — a bad theme is a config mistake worth
- * failing on.
+ * 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)) {

package/dist/highlight/language.js.map

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

@@ -4,8 +4,8 @@
 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
+ * 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;

package/dist/highlight/normalise.js

@@ -7,8 +7,8 @@ export function expandTabs(text, tabSize) {
 }
 /**
  * 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
+ * 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) {

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