@kensio/colophon 2.4.0 → 2.6.0

package/dist/config/resolve.d.ts

@@ -22,6 +22,16 @@ export declare function resolveCode(code: CodeStyle | undefined): Required<CodeS
  * two sizes sharing a name would have one overwrite the other.
  */
 export declare function resolveSizes(sizes: readonly OutputSize[] | undefined): readonly OutputSize[];
+/**
+ * How hard to compress the rendered PNG, checked here rather than in
+ * `validate/`, which checks keys and the names of closed sets.
+ *
+ * Out of range is rejected rather than clamped: zlib takes 0 to 9 and nothing
+ * else, so a config asking for 10 has a number in mind that this cannot give it,
+ * and quietly rendering at 9 would leave someone believing they had asked for
+ * more than they had.
+ */
+export declare function resolveCompressionLevel(level: number | undefined): number;
 /**
  * Whether to load the machine's own fonts. Configured fonts are meant to make
  * the output the same everywhere, so supplying any turns system fonts off

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

@@ -1 +1 @@
-{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/config/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,WAAW,EACX,SAAS,EACT,UAAU,EACV,UAAU,EACX,MAAM,aAAa,CAAC;AAQrB;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,WAAW,GAAG,SAAS,GAC9B,QAAQ,CAAC,WAAW,CAAC,CAWvB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,UAAU,GAAG,SAAS,GACjC,UAAU,GAAG,SAAS,CASxB;AAED,uEAAuE;AACvE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG,UAAU,CAS3E;AAED,yDAAyD;AACzD,wBAAgB,WAAW,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC,SAAS,CAAC,CAE5E;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,SAAS,UAAU,EAAE,GAAG,SAAS,GACvC,SAAS,UAAU,EAAE,CAgBvB;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,OAAO,GAAG,SAAS,EAChC,KAAK,EAAE,SAAS,UAAU,EAAE,GAC3B,OAAO,CAaT"}
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/config/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,WAAW,EACX,SAAS,EACT,UAAU,EACV,UAAU,EACX,MAAM,aAAa,CAAC;AASrB;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,WAAW,GAAG,SAAS,GAC9B,QAAQ,CAAC,WAAW,CAAC,CAWvB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,UAAU,GAAG,SAAS,GACjC,UAAU,GAAG,SAAS,CASxB;AAED,uEAAuE;AACvE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG,UAAU,CAS3E;AAED,yDAAyD;AACzD,wBAAgB,WAAW,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC,SAAS,CAAC,CAE5E;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,SAAS,UAAU,EAAE,GAAG,SAAS,GACvC,SAAS,UAAU,EAAE,CAgBvB;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAazE;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,OAAO,GAAG,SAAS,EAChC,KAAK,EAAE,SAAS,UAAU,EAAE,GAC3B,OAAO,CAaT"}

package/dist/config/resolve.js

@@ -1,5 +1,5 @@
 import { resolveImageSource } from "../image/index.js";
-import { DEFAULT_CODE_STYLE, DEFAULT_COLORS, DEFAULT_SIZES, } from "./defaults.js";
+import { DEFAULT_CODE_STYLE, DEFAULT_COLORS, DEFAULT_COMPRESSION_LEVEL, DEFAULT_SIZES, } from "./defaults.js";
 /**
  * Fill in the palette a project did not name.
  *
@@ -64,6 +64,25 @@ export function resolveSizes(sizes) {
     }
     return sizes;
 }
+/**
+ * How hard to compress the rendered PNG, checked here rather than in
+ * `validate/`, which checks keys and the names of closed sets.
+ *
+ * Out of range is rejected rather than clamped: zlib takes 0 to 9 and nothing
+ * else, so a config asking for 10 has a number in mind that this cannot give it,
+ * and quietly rendering at 9 would leave someone believing they had asked for
+ * more than they had.
+ */
+export function resolveCompressionLevel(level) {
+    if (level === undefined) {
+        return DEFAULT_COMPRESSION_LEVEL;
+    }
+    if (!Number.isSafeInteger(level) || level < 0 || level > 9) {
+        throw new Error(`Invalid compressionLevel ${String(level)}; expected a whole number from` +
+            ` 0 (write the rasteriser's own bytes) to 9 (compress hardest).`);
+    }
+    return level;
+}
 /**
  * Whether to load the machine's own fonts. Configured fonts are meant to make
  * the output the same everywhere, so supplying any turns system fonts off

package/dist/config/resolve.js.map

@@ -1 +1 @@
-{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../../src/config/resolve.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,aAAa,GACd,MAAM,eAAe,CAAC;AAEvB;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAC3B,MAA+B;IAE/B,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,cAAc,CAAC;IACxB,CAAC;IAED,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC,KAAK;QAC3C,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC,KAAK;QAC3C,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,cAAc,CAAC,UAAU;KAC3D,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAC/B,UAAkC;IAElC,IAAI,UAAU,EAAE,IAAI,KAAK,OAAO,EAAE,CAAC;QACjC,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,OAAO;QACL,GAAG,UAAU;QACb,MAAM,EAAE,kBAAkB,CAAC,UAAU,CAAC,MAAM,EAAE,mBAAmB,CAAC;KACnE,CAAC;AACJ,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,iBAAiB,CAAC,MAA6B;IAC7D,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,KAAK,EAAE;YACL,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,SAAS,EAAE;YACzC,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE;YACtC,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,SAAS,EAAE;SAC5C;KACF,CAAC;AACJ,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,WAAW,CAAC,IAA2B;IACrD,OAAO,EAAE,GAAG,kBAAkB,EAAE,GAAG,IAAI,EAAE,CAAC;AAC5C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAC1B,KAAwC;IAExC,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9C,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CACb,+BAA+B,IAAI,CAAC,IAAI,iEAAiE,CAC1G,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtB,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CACnC,WAAgC,EAChC,KAA4B;IAE5B,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC;IAC5B,CAAC;IAED,IAAI,CAAC,WAAW,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CACb,uEAAuE;YACrE,mDAAmD,CACtD,CAAC;IACJ,CAAC;IAED,OAAO,WAAW,CAAC;AACrB,CAAC"}
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../../src/config/resolve.ts"],"names":[],"mappings":"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"}

package/dist/config/size.d.ts

@@ -15,6 +15,12 @@ import type { ColophonConfig, OutputSize, ResolvedConfig } from "../types.js";
  * 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 declare function resolveConfigForSize(config: ColophonConfig | undefined, size: OutputSize): ResolvedConfig;
 //# sourceMappingURL=size.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"size.d.ts","sourceRoot":"","sources":["../../src/config/size.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,cAAc,EACd,UAAU,EACV,cAAc,EACf,MAAM,aAAa,CAAC;AAoBrB;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,cAAc,GAAG,SAAS,EAClC,IAAI,EAAE,UAAU,GACf,cAAc,CAehB"}
+{"version":3,"file":"size.d.ts","sourceRoot":"","sources":["../../src/config/size.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,cAAc,EACd,UAAU,EACV,cAAc,EAEf,MAAM,aAAa,CAAC;AAyBrB;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,cAAc,GAAG,SAAS,EAClC,IAAI,EAAE,UAAU,GACf,cAAc,CAiBhB"}

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, so 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
@@ -28,14 +32,22 @@ 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 }),

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;QACtD,GAAG,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;KACpD,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/index.d.ts

@@ -1,4 +1,5 @@
 export { extractProps } from "./props.js";
+export { defaultContentExtensions, readContentFile } from "./read.js";
 export { slugFromPath } from "./slug.js";
 export { walkContent } from "./walk.js";
 export type { WalkOptions } from "./walk.js";

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/content/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,YAAY,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAE7C,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/content/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,wBAAwB,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,YAAY,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAE7C,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC"}

package/dist/content/index.js

@@ -1,4 +1,5 @@
 export { extractProps } from "./props.js";
+export { defaultContentExtensions, readContentFile } from "./read.js";
 export { slugFromPath } from "./slug.js";
 export { walkContent } from "./walk.js";
 //# sourceMappingURL=index.js.map

package/dist/content/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/content/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/content/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,wBAAwB,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC"}

package/dist/content/read.d.ts

@@ -0,0 +1,15 @@
+import type { ContentFile, ContentOptions } from "../types.js";
+/** File extensions a walk reads when a project names none of its own. */
+export declare const defaultContentExtensions: readonly string[];
+/**
+ * Read one content file's frontmatter and build the image props for it, or
+ * return `undefined` where the file asks for no image.
+ *
+ * `dir` is the content root the returned path and slug are taken relative to,
+ * which is what makes a `route` slug a route. It is separate from the file
+ * itself because reading one post and walking a tree of them want the same
+ * work done: `walkContent` maps this over what it found, and `preview` calls it
+ * for the single file it was pointed at.
+ */
+export declare function readContentFile(filePath: string, dir: string, options?: ContentOptions): Promise<ContentFile | undefined>;
+//# sourceMappingURL=read.d.ts.map

package/dist/content/read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../src/content/read.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAI/D,yEAAyE;AACzE,eAAO,MAAM,wBAAwB,EAAE,SAAS,MAAM,EAAyB,CAAC;AAKhF;;;;;;;;;GASG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAoBlC"}

package/dist/content/read.js

@@ -0,0 +1,36 @@
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import matter from "gray-matter";
+import { coerceString, extractProps } from "./props.js";
+import { assertSlugStaysInside, slugFromPath } from "./slug.js";
+/** File extensions a walk reads when a project names none of its own. */
+export const defaultContentExtensions = [".md", ".markdown"];
+const defaultSlugField = "slug";
+const defaultSlugStrategy = "basename";
+/**
+ * Read one content file's frontmatter and build the image props for it, or
+ * return `undefined` where the file asks for no image.
+ *
+ * `dir` is the content root the returned path and slug are taken relative to,
+ * which is what makes a `route` slug a route. It is separate from the file
+ * itself because reading one post and walking a tree of them want the same
+ * work done: `walkContent` maps this over what it found, and `preview` calls it
+ * for the single file it was pointed at.
+ */
+export async function readContentFile(filePath, dir, options = {}) {
+    const raw = await readFile(filePath, "utf8");
+    const frontmatter = matter(raw).data;
+    const props = extractProps(frontmatter, options);
+    if (props === undefined) {
+        return undefined;
+    }
+    const contentPath = path.relative(dir, filePath);
+    const slugField = options.slugField ?? defaultSlugField;
+    const declaredSlug = coerceString(frontmatter[slugField])?.trim();
+    const slug = declaredSlug !== undefined && declaredSlug !== ""
+        ? declaredSlug
+        : slugFromPath(contentPath, options.slugStrategy ?? defaultSlugStrategy);
+    assertSlugStaysInside(slug, contentPath);
+    return { contentPath, absolutePath: filePath, slug, props };
+}
+//# sourceMappingURL=read.js.map

package/dist/content/read.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read.js","sourceRoot":"","sources":["../../src/content/read.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,MAAM,MAAM,aAAa,CAAC;AAGjC,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEhE,yEAAyE;AACzE,MAAM,CAAC,MAAM,wBAAwB,GAAsB,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;AAEhF,MAAM,gBAAgB,GAAG,MAAM,CAAC;AAChC,MAAM,mBAAmB,GAAG,UAAU,CAAC;AAEvC;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,QAAgB,EAChB,GAAW,EACX,OAAO,GAAmB,EAAE;IAE5B,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC7C,MAAM,WAAW,GAA4B,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;IAC9D,MAAM,KAAK,GAAG,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IAEjD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IACjD,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,gBAAgB,CAAC;IACxD,MAAM,YAAY,GAAG,YAAY,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;IAClE,MAAM,IAAI,GACR,YAAY,KAAK,SAAS,IAAI,YAAY,KAAK,EAAE;QAC/C,CAAC,CAAC,YAAY;QACd,CAAC,CAAC,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,YAAY,IAAI,mBAAmB,CAAC,CAAC;IAE7E,qBAAqB,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IAEzC,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AAC9D,CAAC"}

package/dist/content/walk.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"walk.d.ts","sourceRoot":"","sources":["../../src/content/walk.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAQ/D;;;GAGG;AACH,MAAM,WAAW,WAAY,SAAQ,cAAc;IACjD,8DAA8D;IAC9D,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AA8BD;;;;;GAKG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,WAAW,EAAE,CAAC,CAoCxB"}
+{"version":3,"file":"walk.d.ts","sourceRoot":"","sources":["../../src/content/walk.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAG/D;;;GAGG;AACH,MAAM,WAAW,WAAY,SAAQ,cAAc;IACjD,8DAA8D;IAC9D,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AA8BD;;;;;GAKG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,WAAW,EAAE,CAAC,CAWxB"}

package/dist/content/walk.js

@@ -1,11 +1,6 @@
-import { readdir, readFile } from "node:fs/promises";
+import { readdir } from "node:fs/promises";
 import path from "node:path";
-import matter from "gray-matter";
-import { coerceString, extractProps } from "./props.js";
-import { assertSlugStaysInside, slugFromPath } from "./slug.js";
-const defaultSlugField = "slug";
-const defaultSlugStrategy = "basename";
-const defaultExtensions = [".md", ".markdown"];
+import { defaultContentExtensions, readContentFile } from "./read.js";
 async function collectContentFiles(dir, extensions) {
     const entries = await readdir(dir, { withFileTypes: true });
     const nested = await Promise.all(entries.map(async (entry) => {
@@ -28,30 +23,9 @@ async function collectContentFiles(dir, extensions) {
  * rendering.
  */
 export async function walkContent(options) {
-    const extensions = options.extensions ?? defaultExtensions;
+    const extensions = options.extensions ?? defaultContentExtensions;
     const filePaths = await collectContentFiles(options.dir, extensions);
-    const slugField = options.slugField ?? defaultSlugField;
-    const slugStrategy = options.slugStrategy ?? defaultSlugStrategy;
-    const files = await Promise.all(filePaths.map(async (filePath) => {
-        const raw = await readFile(filePath, "utf8");
-        const frontmatter = matter(raw).data;
-        const props = extractProps(frontmatter, options);
-        if (props === undefined) {
-            return;
-        }
-        const contentPath = path.relative(options.dir, filePath);
-        const declaredSlug = coerceString(frontmatter[slugField])?.trim();
-        const slug = declaredSlug !== undefined && declaredSlug !== ""
-            ? declaredSlug
-            : slugFromPath(contentPath, slugStrategy);
-        assertSlugStaysInside(slug, contentPath);
-        return {
-            contentPath,
-            absolutePath: filePath,
-            slug,
-            props,
-        };
-    }));
+    const files = await Promise.all(filePaths.map(async (filePath) => readContentFile(filePath, options.dir, options)));
     return files.filter((file) => file !== undefined);
 }
 //# sourceMappingURL=walk.js.map

package/dist/content/walk.js.map

@@ -1 +1 @@
-{"version":3,"file":"walk.js","sourceRoot":"","sources":["../../src/content/walk.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"walk.js","sourceRoot":"","sources":["../../src/content/walk.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,OAAO,EAAE,wBAAwB,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAWtE,KAAK,UAAU,mBAAmB,CAChC,GAAW,EACX,UAA6B;IAE7B,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAE5D,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAC9B,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;QAC1B,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAE7C,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,OAAO,mBAAmB,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;QACpD,CAAC;QAED,IACE,KAAK,CAAC,MAAM,EAAE;YACd,UAAU,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,EAC9D,CAAC;YACD,OAAO,CAAC,SAAS,CAAC,CAAC;QACrB,CAAC;QAED,OAAO,EAAE,CAAC;IACZ,CAAC,CAAC,CACH,CAAC;IAEF,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;AACvB,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,OAAoB;IAEpB,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,wBAAwB,CAAC;IAClE,MAAM,SAAS,GAAG,MAAM,mBAAmB,CAAC,OAAO,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;IAErE,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,GAAG,CAC7B,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,CAC/B,eAAe,CAAC,QAAQ,EAAE,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,CAChD,CACF,CAAC;IAEF,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAuB,EAAE,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;AACzE,CAAC"}

package/dist/core/index.d.ts

@@ -0,0 +1,37 @@
+/**
+ * The template layer, with nothing in it that needs Node.
+ *
+ * `buildSvg` is string building: it takes props, a config and a size, and
+ * returns an SVG document. Everything Node-shaped in this package is either
+ * side of that. Finding content and reading frontmatter comes before it, and
+ * turning the document into pixels comes after, so the middle can run in a
+ * browser or at the edge.
+ *
+ * Two things follow from that and are worth knowing before importing this.
+ *
+ * Fonts and images have to be supplied as bytes rather than as paths, since
+ * there is no filesystem to resolve a path against. A config naming one is an
+ * error when it is resolved rather than a blank corner later.
+ *
+ * There is no rasteriser. resvg is a native module, so a build for this entry
+ * point does not include it, and asking for pixels without setting
+ * `config.rasteriser` says so. Set it to a wasm build to have them here, or
+ * take the SVG and rasterise it somewhere else.
+ *
+ * The swap is `package.json`'s `browser` field, which every bundler in scope
+ * honours. Importing this entry point from Node gets the Node halves and works
+ * as the root entry point does.
+ */
+export type { Background, Badge, BrandColors, CodeStyle, ColophonConfig, Dimensions, FontSource, GradientStop, ImageSource, MeasureText, MetaImageProps, MeshBlob, OutputFormat, OutputSize, Rasteriser, RenderedMetaImage, 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 { buildSvg } from "../render/svg.js";
+export { backgroundSvg } from "../background/index.js";
+export { textureSvg } from "../texture/index.js";
+export { bannerTemplate, builtinTemplates, cardTemplate, codeTemplate, } from "../templates/index.js";
+export { createMeasurer } from "../measure/index.js";
+export { escapeXml, fitText, textElement, wrapText } from "../text/index.js";
+export { dedent, expandTabs, highlightCode, resolveLanguage, } from "../highlight/index.js";
+export { signatureParam, signParams, signedQuery, verifyParams, verifySignedQuery, } from "../sign/index.js";
+export type { SignedParams } from "../sign/index.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,YAAY,EACV,UAAU,EACV,KAAK,EACL,WAAW,EACX,SAAS,EACT,cAAc,EACd,UAAU,EACV,UAAU,EACV,YAAY,EACZ,WAAW,EACX,WAAW,EACX,cAAc,EACd,QAAQ,EACR,YAAY,EACZ,UAAU,EACV,UAAU,EACV,iBAAiB,EACjB,cAAc,EACd,QAAQ,EACR,eAAe,EACf,OAAO,EACP,SAAS,EACT,SAAS,EACT,cAAc,GACf,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,wBAAwB,EACxB,kBAAkB,EAClB,cAAc,EACd,mBAAmB,EACnB,aAAa,EACb,YAAY,EACZ,aAAa,EACb,YAAY,GACb,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAEzD,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,YAAY,GACb,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC7E,OAAO,EACL,MAAM,EACN,UAAU,EACV,aAAa,EACb,eAAe,GAChB,MAAM,uBAAuB,CAAC;AAI/B,OAAO,EACL,cAAc,EACd,UAAU,EACV,WAAW,EACX,YAAY,EACZ,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/core/index.js

@@ -0,0 +1,13 @@
+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 { buildSvg } from "../render/svg.js";
+export { backgroundSvg } from "../background/index.js";
+export { textureSvg } from "../texture/index.js";
+export { bannerTemplate, builtinTemplates, cardTemplate, codeTemplate, } from "../templates/index.js";
+export { createMeasurer } from "../measure/index.js";
+export { escapeXml, fitText, textElement, wrapText } from "../text/index.js";
+export { dedent, expandTabs, highlightCode, resolveLanguage, } from "../highlight/index.js";
+// For an endpoint that renders on demand, which is what a browser-safe core is
+// for. See `sign/index.ts` for why an unsigned one is a bad idea.
+export { signatureParam, signParams, signedQuery, verifyParams, verifySignedQuery, } from "../sign/index.js";
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAkDA,OAAO,EACL,wBAAwB,EACxB,kBAAkB,EAClB,cAAc,EACd,mBAAmB,EACnB,aAAa,EACb,YAAY,EACZ,aAAa,EACb,YAAY,GACb,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAEzD,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,YAAY,GACb,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC7E,OAAO,EACL,MAAM,EACN,UAAU,EACV,aAAa,EACb,eAAe,GAChB,MAAM,uBAAuB,CAAC;AAE/B,+EAA+E;AAC/E,kEAAkE;AAClE,OAAO,EACL,cAAc,EACd,UAAU,EACV,WAAW,EACX,YAAY,EACZ,iBAAiB,GAClB,MAAM,kBAAkB,CAAC"}

package/dist/encode/fit.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Encode at `quality`, and again lower, until the result is under `maxBytes` or
+ * quality has nowhere left to go.
+ *
+ * Stepping down in fixed increments rather than searching for the highest
+ * quality that fits is the deliberate choice. Each step costs a whole encoding,
+ * a search would cost several more of them for a difference nobody can see, and
+ * a step is a number somebody can predict from the one they configured.
+ *
+ * The floor is where a picture stops being worth having, so an image that will
+ * not fit even there is returned as it is. Saying so is `warnIfOverCap`'s job:
+ * the cap is a request, and refusing to write an image because it could not be
+ * met would be a build that failed over a file size.
+ */
+export declare function fitToBytes(encode: (quality: number) => Promise<Buffer>, quality: number, maxBytes: number): Promise<Buffer>;
+//# sourceMappingURL=fit.d.ts.map

package/dist/encode/fit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fit.d.ts","sourceRoot":"","sources":["../../src/encode/fit.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;GAaG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,EAC5C,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC,CAOjB"}

package/dist/encode/fit.js

@@ -0,0 +1,23 @@
+import { MINIMUM_QUALITY, QUALITY_STEP } from "../config/defaults.js";
+/**
+ * Encode at `quality`, and again lower, until the result is under `maxBytes` or
+ * quality has nowhere left to go.
+ *
+ * Stepping down in fixed increments rather than searching for the highest
+ * quality that fits is the deliberate choice. Each step costs a whole encoding,
+ * a search would cost several more of them for a difference nobody can see, and
+ * a step is a number somebody can predict from the one they configured.
+ *
+ * The floor is where a picture stops being worth having, so an image that will
+ * not fit even there is returned as it is. Saying so is `warnIfOverCap`'s job:
+ * the cap is a request, and refusing to write an image because it could not be
+ * met would be a build that failed over a file size.
+ */
+export async function fitToBytes(encode, quality, maxBytes) {
+    const image = await encode(quality);
+    const next = quality - QUALITY_STEP;
+    return image.length <= maxBytes || next < MINIMUM_QUALITY
+        ? image
+        : fitToBytes(encode, next, maxBytes);
+}
+//# sourceMappingURL=fit.js.map

package/dist/encode/fit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fit.js","sourceRoot":"","sources":["../../src/encode/fit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAEtE;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,MAA4C,EAC5C,OAAe,EACf,QAAgB;IAEhB,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,CAAC;IACpC,MAAM,IAAI,GAAG,OAAO,GAAG,YAAY,CAAC;IAEpC,OAAO,KAAK,CAAC,MAAM,IAAI,QAAQ,IAAI,IAAI,GAAG,eAAe;QACvD,CAAC,CAAC,KAAK;QACP,CAAC,CAAC,UAAU,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;AACzC,CAAC"}

package/dist/encode/format.d.ts

@@ -0,0 +1,12 @@
+import type { OutputFormat } from "../types.js";
+/** The extension an image of this format is written under, dot and all. */
+export declare function extensionFor(format: OutputFormat): string;
+/** The media type an image of this format carries. */
+export declare function mediaTypeFor(format: OutputFormat): string;
+/**
+ * Replace whatever extension a path ends with. Used for the SVG written
+ * alongside an image, which is the same name with a different tail, so that a
+ * hashed filename keeps its hash.
+ */
+export declare function withExtension(file: string, extension: string): string;
+//# sourceMappingURL=format.d.ts.map

package/dist/encode/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/encode/format.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AA2BhD,2EAA2E;AAC3E,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAEzD;AAED,sDAAsD;AACtD,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAEzD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAErE"}

package/dist/encode/format.js

@@ -0,0 +1,40 @@
+/**
+ * What each format is called on disk and on the wire.
+ *
+ * These are the encoder's own answers rather than `image/media.ts`'s. That
+ * module sniffs the formats a build can _draw_ with, which is a different list
+ * arrived at for a different reason: it has GIF and SVG, which nothing writes,
+ * and it has no AVIF, which this does. The stamp carriers are kept apart from
+ * it for the same reason.
+ */
+const extensions = {
+    png: ".png",
+    // `.jpg` rather than `.jpeg`, which is what the web settled on and what a
+    // reader looking at a directory of images expects to see.
+    jpeg: ".jpg",
+    webp: ".webp",
+    avif: ".avif",
+};
+const mediaTypes = {
+    png: "image/png",
+    jpeg: "image/jpeg",
+    webp: "image/webp",
+    avif: "image/avif",
+};
+/** The extension an image of this format is written under, dot and all. */
+export function extensionFor(format) {
+    return extensions[format];
+}
+/** The media type an image of this format carries. */
+export function mediaTypeFor(format) {
+    return mediaTypes[format];
+}
+/**
+ * Replace whatever extension a path ends with. Used for the SVG written
+ * alongside an image, which is the same name with a different tail, so that a
+ * hashed filename keeps its hash.
+ */
+export function withExtension(file, extension) {
+    return file.replace(/\.[^./\\]*$/, "") + extension;
+}
+//# sourceMappingURL=format.js.map

package/dist/encode/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../src/encode/format.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,MAAM,UAAU,GAA2C;IACzD,GAAG,EAAE,MAAM;IACX,0EAA0E;IAC1E,0DAA0D;IAC1D,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,OAAO;IACb,IAAI,EAAE,OAAO;CACd,CAAC;AAEF,MAAM,UAAU,GAA2C;IACzD,GAAG,EAAE,WAAW;IAChB,IAAI,EAAE,YAAY;IAClB,IAAI,EAAE,YAAY;IAClB,IAAI,EAAE,YAAY;CACnB,CAAC;AAEF,2EAA2E;AAC3E,MAAM,UAAU,YAAY,CAAC,MAAoB;IAC/C,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC;AAC5B,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,YAAY,CAAC,MAAoB;IAC/C,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC;AAC5B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,SAAiB;IAC3D,OAAO,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,GAAG,SAAS,CAAC;AACrD,CAAC"}

package/dist/encode/index.d.ts

@@ -0,0 +1,14 @@
+import type { ResolvedConfig } from "../types.js";
+export { extensionFor, mediaTypeFor, withExtension } from "./format.js";
+/**
+ * Turn the raster a {@link ResolvedConfig.rasteriser} produced into the bytes a
+ * build writes: the configured format, at the configured quality, under the
+ * configured cap where one can be met.
+ *
+ * It sits between rasterising and writing rather than inside either, for the
+ * reason the recompression it replaces did: every path to an image goes through
+ * `renderSvgToImage`, so `renderMetaImages`, `generate` and `colophon preview`
+ * all get this without knowing there was a choice to make.
+ */
+export declare function encodeImage(raster: Buffer, config: ResolvedConfig): Promise<Buffer>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/encode/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAOlD,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAyCxE;;;;;;;;;GASG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,cAAc,GACrB,OAAO,CAAC,MAAM,CAAC,CAKjB"}

package/dist/encode/index.js

@@ -0,0 +1,52 @@
+import { recompressPng } from "../png/recompress.js";
+import { fitToBytes } from "./fit.js";
+import { mediaTypeFor } from "./format.js";
+import { openRaster } from "./sharp.js";
+import { warnIfOverCap } from "./warn.js";
+export { extensionFor, mediaTypeFor, withExtension } from "./format.js";
+/**
+ * The rendered bytes as the configured format, before the cap is considered.
+ *
+ * PNG is what the rasteriser already produces, so there is nothing to convert
+ * and the lossless recompression is the whole of the work. The other three are
+ * encoded from whatever came back, which is a decode and an encode per image,
+ * paid once because an image whose rebuild stamp still matches is not rendered
+ * again.
+ *
+ * Bytes that are already in the configured format are handed straight on. A
+ * project whose rasteriser produces WebP and whose config asks for WebP means
+ * one encoding, not two, and re-encoding a lossy image is how a picture loses a
+ * generation for nothing.
+ */
+async function toFormat(raster, config) {
+    if (config.format === "png") {
+        return recompressPng(raster, config.compressionLevel);
+    }
+    // Read off the config once, so the narrowing above survives into the closure
+    // below, where TypeScript would otherwise have to assume the field had moved.
+    const format = config.format;
+    const source = await openRaster(raster);
+    if (source.mediaType === mediaTypeFor(format)) {
+        return raster;
+    }
+    const encode = async (quality) => source.encode(format, quality);
+    return config.maxBytes === undefined
+        ? encode(config.quality)
+        : fitToBytes(encode, config.quality, config.maxBytes);
+}
+/**
+ * Turn the raster a {@link ResolvedConfig.rasteriser} produced into the bytes a
+ * build writes: the configured format, at the configured quality, under the
+ * configured cap where one can be met.
+ *
+ * It sits between rasterising and writing rather than inside either, for the
+ * reason the recompression it replaces did: every path to an image goes through
+ * `renderSvgToImage`, so `renderMetaImages`, `generate` and `colophon preview`
+ * all get this without knowing there was a choice to make.
+ */
+export async function encodeImage(raster, config) {
+    const image = await toFormat(raster, config);
+    warnIfOverCap(image, config);
+    return image;
+}
+//# sourceMappingURL=index.js.map

package/dist/encode/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/encode/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE1C,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAExE;;;;;;;;;;;;;GAaG;AACH,KAAK,UAAU,QAAQ,CACrB,MAAc,EACd,MAAsB;IAEtB,IAAI,MAAM,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;QAC5B,OAAO,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,gBAAgB,CAAC,CAAC;IACxD,CAAC;IAED,6EAA6E;IAC7E,8EAA8E;IAC9E,MAAM,MAAM,GAAgB,MAAM,CAAC,MAAM,CAAC;IAC1C,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,MAAM,CAAC,CAAC;IAExC,IAAI,MAAM,CAAC,SAAS,KAAK,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC;QAC9C,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,MAAM,GAAG,KAAK,EAAE,OAAe,EAAmB,EAAE,CACxD,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEjC,OAAO,MAAM,CAAC,QAAQ,KAAK,SAAS;QAClC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC;QACxB,CAAC,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;AAC1D,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,MAAc,EACd,MAAsB;IAEtB,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7C,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAE7B,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/encode/sharp.d.ts

@@ -0,0 +1,19 @@
+import type { OutputFormat } from "../types.js";
+/**
+ * The formats an image is encoded _into_, as against PNG, which is what the
+ * rasteriser already produces and which has a lossless path of its own.
+ */
+export type LossyFormat = Exclude<OutputFormat, "png">;
+/**
+ * A raster opened for encoding: what it already is, and how to write it out
+ * again as something else.
+ */
+export interface OpenRaster {
+    /** The media type sharp read out of the bytes, e.g. `image/webp`. */
+    readonly mediaType: string | undefined;
+    /** The same picture as `format`, at `quality`. */
+    encode(format: LossyFormat, quality: number): Promise<Buffer>;
+}
+/** Open some rendered bytes for encoding. */
+export declare function openRaster(raster: Buffer): Promise<OpenRaster>;
+//# sourceMappingURL=sharp.d.ts.map

package/dist/encode/sharp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sharp.d.ts","sourceRoot":"","sources":["../../src/encode/sharp.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,OAAO,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;AAEvD;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,qEAAqE;IACrE,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,kDAAkD;IAClD,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC/D;AA6DD,6CAA6C;AAC7C,wBAAsB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAOpE"}