@kensio/colophon 2.2.0 → 2.4.0

package/dist/cli/index.js

@@ -0,0 +1,35 @@
+#!/usr/bin/env node
+import { generate } from "../generate/index.js";
+import { parseCliArgs, usage } from "./args.js";
+import { loadConfig } from "./config.js";
+async function main() {
+    const argv = process.argv.slice(2);
+    if (argv.includes("-h") || argv.includes("--help")) {
+        console.log(usage);
+        return;
+    }
+    const args = parseCliArgs(argv);
+    const config = await loadConfig(args.configPath);
+    const results = await generate({
+        contentDir: args.contentDir,
+        overwrite: args.overwrite,
+        ...(config !== undefined && { config }),
+        ...(args.concurrency !== undefined && { concurrency: args.concurrency }),
+        onResult: (result) => {
+            // The URL is the half of a placement nothing else on the command line
+            // would show, and the quickest way to see a `urlBase` is wrong.
+            const served = result.url === undefined ? "" : ` -> ${result.url}`;
+            console.log(`${result.skipped ? "skip " : "wrote"} ${result.outputPath}${served}`);
+        },
+    });
+    const written = results.filter((result) => !result.skipped).length;
+    console.log(`Done: ${String(written)} written, ${String(results.length - written)} skipped.`);
+}
+try {
+    await main();
+}
+catch (error) {
+    console.error(error instanceof Error ? error.message : String(error));
+    process.exitCode = 1;
+}
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,KAAK,UAAU,IAAI;IACjB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAEnC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QACnD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACnB,OAAO;IACT,CAAC;IAED,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IAChC,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAEjD,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC;QAC7B,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,GAAG,CAAC,MAAM,KAAK,SAAS,IAAI,EAAE,MAAM,EAAE,CAAC;QACvC,GAAG,CAAC,IAAI,CAAC,WAAW,KAAK,SAAS,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC;QACxE,QAAQ,EAAE,CAAC,MAAM,EAAE,EAAE;YACnB,sEAAsE;YACtE,gEAAgE;YAChE,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,MAAM,CAAC,GAAG,EAAE,CAAC;YACnE,OAAO,CAAC,GAAG,CACT,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,IAAI,MAAM,CAAC,UAAU,GAAG,MAAM,EAAE,CACtE,CAAC;QACJ,CAAC;KACF,CAAC,CAAC;IAEH,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;IACnE,OAAO,CAAC,GAAG,CACT,SAAS,MAAM,CAAC,OAAO,CAAC,aAAa,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,OAAO,CAAC,WAAW,CACjF,CAAC;AACJ,CAAC;AAED,IAAI,CAAC;IACH,MAAM,IAAI,EAAE,CAAC;AACf,CAAC;AAAC,OAAO,KAAK,EAAE,CAAC;IACf,OAAO,CAAC,KAAK,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IACtE,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC"}

package/dist/cli.js

@@ -7,35 +7,62 @@ const usage = `colophon — generate social meta images from frontmatter
 Usage:
   colophon [contentDir] [options]
 
+Images carry a stamp of the props, config and size they came from, so a rebuild
+renders only the ones that have actually changed.
+
 Options:
   -c, --config <path>   Load a config module (default export = ColophonConfig)
-  -o, --overwrite       Re-render images even if the output file exists
+  -f, --force           Re-render every image, ignoring the stamps
+  -o, --overwrite       Alias for --force
+  --concurrency <n>     How many images to render at once
   -h, --help            Show this help
 
 Defaults:
-  contentDir            content`;
+  contentDir            content
+  --concurrency         one per available CPU`;
+/** `--overwrite` is kept as an alias so existing build scripts keep working. */
+const forceFlags = new Set(["-f", "--force", "-o", "--overwrite"]);
+/** Flags that take the next argument as their value. */
+const valueFlags = new Set(["-c", "--config", "--concurrency"]);
+/**
+ * A mistyped count would otherwise reach `generate` as `NaN` and be reported
+ * without naming the flag it came from, so it is rejected here instead.
+ */
+function parseConcurrency(value) {
+    const parsed = Number(value);
+    if (!Number.isSafeInteger(parsed) || parsed < 1) {
+        throw new Error(`Invalid value for --concurrency: "${value}"; expected a positive integer.`);
+    }
+    return parsed;
+}
 function parseCliArgs(argv) {
     let contentDir = "content";
     let configPath;
     let shouldOverwrite = false;
+    let concurrency;
     for (let index = 0; index < argv.length; index += 1) {
         const arg = argv[index];
-        if (arg === "-c" || arg === "--config") {
+        if (arg !== undefined && valueFlags.has(arg)) {
             index += 1;
             const value = argv[index];
             if (value === undefined) {
                 throw new Error(`Missing value for ${arg}`);
             }
-            configPath = value;
+            if (arg === "--concurrency") {
+                concurrency = parseConcurrency(value);
+            }
+            else {
+                configPath = value;
+            }
         }
-        else if (arg === "-o" || arg === "--overwrite") {
+        else if (arg !== undefined && forceFlags.has(arg)) {
             shouldOverwrite = true;
         }
         else if (arg !== undefined && !arg.startsWith("-")) {
             contentDir = arg;
         }
     }
-    return { contentDir, configPath, overwrite: shouldOverwrite };
+    return { contentDir, configPath, overwrite: shouldOverwrite, concurrency };
 }
 async function loadConfig(configPath) {
     if (configPath === undefined) {
@@ -57,6 +84,7 @@ async function main() {
         contentDir: args.contentDir,
         overwrite: args.overwrite,
         ...(config !== undefined && { config }),
+        ...(args.concurrency !== undefined && { concurrency: args.concurrency }),
         onResult: (result) => {
             console.log(`${result.skipped ? "skip " : "wrote"} ${result.outputPath}`);
         },

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/config/defaults.d.ts

@@ -0,0 +1,65 @@
+import type { BrandColors, CodeStyle, OutputSize } from "../types.js";
+/**
+ * Named output-size presets covering the common social-image standards. Each
+ * `name` becomes the filename suffix (e.g. `my-post-og.png`).
+ *
+ * - `og`: 1.91:1, the Open Graph standard (`og:image`). Facebook, LinkedIn,
+ *   Slack, Discord, WhatsApp, Mastodon, and the usual `twitter:image` reuse.
+ * - `square`: 1:1, X/Twitter `summary` card and a universal fallback.
+ * - `twitter`: 2:1, X/Twitter `summary_large_image` card.
+ * - `pinterest`: 2:3 tall pin.
+ */
+export declare const SIZE_PRESETS: {
+    readonly og: {
+        readonly name: "og";
+        readonly width: 1200;
+        readonly height: 630;
+    };
+    readonly square: {
+        readonly name: "square";
+        readonly width: 1200;
+        readonly height: 1200;
+    };
+    readonly twitter: {
+        readonly name: "twitter";
+        readonly width: 1200;
+        readonly height: 600;
+    };
+    readonly pinterest: {
+        readonly name: "pinterest";
+        readonly width: 1000;
+        readonly height: 1500;
+    };
+};
+/**
+ * Default output sizes: the Open Graph landscape plus a square. Between them
+ * they satisfy `og:image` and both `twitter:image` card types.
+ */
+export declare const DEFAULT_SIZES: readonly OutputSize[];
+/**
+ * Default font stack, used when no fonts are configured. It names families and
+ * hopes the machine has them, which is exactly what `config.fonts` exists to
+ * avoid: supply a font file and the output stops depending on the machine.
+ */
+export declare const DEFAULT_FONT_FAMILY = "Arial, Helvetica, sans-serif";
+/** Neutral default palette, used when no `colors.brand` is supplied. */
+export declare const DEFAULT_COLORS: Required<BrandColors>;
+/**
+ * Default monospace stack for the `code` template. It ends in the generic
+ * `monospace` family so it always resolves to something, whatever fonts the
+ * machine running the build happens to have.
+ */
+export declare const DEFAULT_CODE_FONT_FAMILY = "\"JetBrains Mono\", \"Source Code Pro\", \"DejaVu Sans Mono\", Menlo, Consolas, monospace";
+/**
+ * Default `code` template styling. `lineHeight` sets the monospace grid the
+ * snippet is laid out on, along with the character width, which is measured
+ * from the font rather than configured. The font-size bounds are fractions of
+ * the image width so they hold at every output size.
+ *
+ * `minFontScale` of `0.025` is roughly 30px on a 1200px-wide image, which
+ * still reads when a feed shows that image at half size. A snippet too long to
+ * fit at that size is truncated rather than shrunk, so a long sample loses
+ * lines on the shorter landscape formats.
+ */
+export declare const DEFAULT_CODE_STYLE: Required<CodeStyle>;
+//# sourceMappingURL=defaults.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/config/defaults.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEtE;;;;;;;;;GASG;AACH,eAAO,MAAM,YAAY;;iBACjB,IAAI,EAAE,IAAI;iBAAE,KAAK,EAAE,IAAI;iBAAE,MAAM,EAAE,GAAG;;;iBAChC,IAAI,EAAE,QAAQ;iBAAE,KAAK,EAAE,IAAI;iBAAE,MAAM,EAAE,IAAI;;;iBACxC,IAAI,EAAE,SAAS;iBAAE,KAAK,EAAE,IAAI;iBAAE,MAAM,EAAE,GAAG;;;iBACvC,IAAI,EAAE,WAAW;iBAAE,KAAK,EAAE,IAAI;iBAAE,MAAM,EAAE,IAAI;;CACZ,CAAC;AAEhD;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,SAAS,UAAU,EAG9C,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,iCAAiC,CAAC;AAElE,wEAAwE;AACxE,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,WAAW,CAKhD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,8FACkD,CAAC;AAExF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,kBAAkB,EAAE,QAAQ,CAAC,SAAS,CAQlD,CAAC"}

package/dist/config/defaults.js

@@ -0,0 +1,64 @@
+/**
+ * Named output-size presets covering the common social-image standards. Each
+ * `name` becomes the filename suffix (e.g. `my-post-og.png`).
+ *
+ * - `og`: 1.91:1, the Open Graph standard (`og:image`). Facebook, LinkedIn,
+ *   Slack, Discord, WhatsApp, Mastodon, and the usual `twitter:image` reuse.
+ * - `square`: 1:1, X/Twitter `summary` card and a universal fallback.
+ * - `twitter`: 2:1, X/Twitter `summary_large_image` card.
+ * - `pinterest`: 2:3 tall pin.
+ */
+export const SIZE_PRESETS = {
+    og: { name: "og", width: 1200, height: 630 },
+    square: { name: "square", width: 1200, height: 1200 },
+    twitter: { name: "twitter", width: 1200, height: 600 },
+    pinterest: { name: "pinterest", width: 1000, height: 1500 },
+};
+/**
+ * Default output sizes: the Open Graph landscape plus a square. Between them
+ * they satisfy `og:image` and both `twitter:image` card types.
+ */
+export const DEFAULT_SIZES = [
+    SIZE_PRESETS.og,
+    SIZE_PRESETS.square,
+];
+/**
+ * Default font stack, used when no fonts are configured. It names families and
+ * hopes the machine has them, which is exactly what `config.fonts` exists to
+ * avoid: supply a font file and the output stops depending on the machine.
+ */
+export const DEFAULT_FONT_FAMILY = "Arial, Helvetica, sans-serif";
+/** Neutral default palette, used when no `colors.brand` is supplied. */
+export const DEFAULT_COLORS = {
+    brand: "#4f46e5",
+    brandDark: "#3730a3",
+    brandWarm: "#db2777",
+    foreground: "#ffffff",
+};
+/**
+ * Default monospace stack for the `code` template. It ends in the generic
+ * `monospace` family so it always resolves to something, whatever fonts the
+ * machine running the build happens to have.
+ */
+export const DEFAULT_CODE_FONT_FAMILY = '"JetBrains Mono", "Source Code Pro", "DejaVu Sans Mono", Menlo, Consolas, monospace';
+/**
+ * Default `code` template styling. `lineHeight` sets the monospace grid the
+ * snippet is laid out on, along with the character width, which is measured
+ * from the font rather than configured. The font-size bounds are fractions of
+ * the image width so they hold at every output size.
+ *
+ * `minFontScale` of `0.025` is roughly 30px on a 1200px-wide image, which
+ * still reads when a feed shows that image at half size. A snippet too long to
+ * fit at that size is truncated rather than shrunk, so a long sample loses
+ * lines on the shorter landscape formats.
+ */
+export const DEFAULT_CODE_STYLE = {
+    theme: "github-dark",
+    fontFamily: DEFAULT_CODE_FONT_FAMILY,
+    lineHeight: 1.55,
+    tabSize: 2,
+    cornerScale: 0.025,
+    maxFontScale: 0.075,
+    minFontScale: 0.025,
+};
+//# sourceMappingURL=defaults.js.map

package/dist/config/defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../../src/config/defaults.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE;IAC5C,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE;IACrD,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE;IACtD,SAAS,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE;CACd,CAAC;AAEhD;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAA0B;IAClD,YAAY,CAAC,EAAE;IACf,YAAY,CAAC,MAAM;CACpB,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,8BAA8B,CAAC;AAElE,wEAAwE;AACxE,MAAM,CAAC,MAAM,cAAc,GAA0B;IACnD,KAAK,EAAE,SAAS;IAChB,SAAS,EAAE,SAAS;IACpB,SAAS,EAAE,SAAS;IACpB,UAAU,EAAE,SAAS;CACtB,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,wBAAwB,GACnC,qFAAqF,CAAC;AAExF;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAwB;IACrD,KAAK,EAAE,aAAa;IACpB,UAAU,EAAE,wBAAwB;IACpC,UAAU,EAAE,IAAI;IAChB,OAAO,EAAE,CAAC;IACV,WAAW,EAAE,KAAK;IAClB,YAAY,EAAE,KAAK;IACnB,YAAY,EAAE,KAAK;CACpB,CAAC"}

package/dist/config/index.d.ts

@@ -0,0 +1,22 @@
+import type { ColophonConfig, ColophonConfigFactory, ResolvedConfig } from "../types.js";
+export { DEFAULT_CODE_FONT_FAMILY, DEFAULT_CODE_STYLE, DEFAULT_COLORS, DEFAULT_FONT_FAMILY, DEFAULT_SIZES, SIZE_PRESETS, } from "./defaults.js";
+/**
+ * Identity helper that returns its argument typed as {@link ColophonConfig}.
+ * Use it in a config module to get editor completion and type-checking.
+ */
+export declare function defineConfig(config: ColophonConfig): ColophonConfig;
+/**
+ * Overload for a config module that computes its config rather than declaring
+ * it. The function is typed, not called: this is still just an identity
+ * helper, and whoever loads the module is the one who runs it.
+ */
+export declare function defineConfig(factory: ColophonConfigFactory): ColophonConfigFactory;
+/**
+ * Apply defaults to a user config. Safe to call with no argument.
+ *
+ * Unknown options are rejected before anything is resolved, so a config
+ * written against a different version of the package is a build error rather
+ * than a set of images quietly rendered with the defaults.
+ */
+export declare function resolveConfig(config?: ColophonConfig): ResolvedConfig;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,cAAc,EACd,qBAAqB,EAErB,cAAc,EACf,MAAM,aAAa,CAAC;AAYrB,OAAO,EACL,wBAAwB,EACxB,kBAAkB,EAClB,cAAc,EACd,mBAAmB,EACnB,aAAa,EACb,YAAY,GACb,MAAM,eAAe,CAAC;AAcvB;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,cAAc,GAAG,cAAc,CAAC;AACrE;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,qBAAqB,GAC7B,qBAAqB,CAAC;AAUzB;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,MAAM,GAAE,cAAmB,GAAG,cAAc,CAsBzE"}

package/dist/config/index.js

@@ -0,0 +1,54 @@
+import { resolveFonts } from "../fonts/index.js";
+import { resolveOptionalImage } from "../image/index.js";
+import { builtinTemplates } from "../templates/index.js";
+import { validateConfig } from "../validate/index.js";
+import { DEFAULT_FONT_FAMILY } from "./defaults.js";
+import { defaultBackground, resolveBackground, resolveCode, resolveColors, resolveSizes, shouldLoadSystemFonts, } from "./resolve.js";
+export { DEFAULT_CODE_FONT_FAMILY, DEFAULT_CODE_STYLE, DEFAULT_COLORS, DEFAULT_FONT_FAMILY, DEFAULT_SIZES, SIZE_PRESETS, } from "./defaults.js";
+/**
+ * Default warning handler. Colophon runs at build time, so a compromise the
+ * renderer had to make belongs in the build log by default. Silence is opt-in
+ * via `config.onWarning`.
+ */
+function warnToConsole(message) {
+    // The console is the point: this is the default sink, replaced wholesale by
+    // a caller-supplied `onWarning`.
+    // eslint-disable-next-line no-console
+    console.warn(`colophon: ${message}`);
+}
+/**
+ * Implementation signature. Two overloads rather than one union parameter, so
+ * an object literal is still checked against {@link ColophonConfig} for
+ * misspelled keys before it ever reaches `validateConfig`.
+ */
+export function defineConfig(config) {
+    return config;
+}
+/**
+ * Apply defaults to a user config. Safe to call with no argument.
+ *
+ * Unknown options are rejected before anything is resolved, so a config
+ * written against a different version of the package is a build error rather
+ * than a set of images quietly rendered with the defaults.
+ */
+export function resolveConfig(config = {}) {
+    validateConfig(config);
+    const colors = resolveColors(config.colors);
+    const fonts = resolveFonts(config.fonts);
+    return {
+        colors,
+        background: resolveBackground(config.background) ?? defaultBackground(colors),
+        fonts,
+        systemFonts: shouldLoadSystemFonts(config.systemFonts, fonts),
+        // A project that supplies one font should not have to name it twice.
+        fontFamily: config.fontFamily ?? fonts[0]?.family ?? DEFAULT_FONT_FAMILY,
+        footer: config.footer,
+        badge: config.badge,
+        logo: resolveOptionalImage(config.logo, "logo"),
+        code: resolveCode(config.code),
+        onWarning: config.onWarning ?? warnToConsole,
+        sizes: resolveSizes(config.sizes),
+        templates: { ...builtinTemplates, ...config.templates },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAOzD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,WAAW,EACX,aAAa,EACb,YAAY,EACZ,qBAAqB,GACtB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,wBAAwB,EACxB,kBAAkB,EAClB,cAAc,EACd,mBAAmB,EACnB,aAAa,EACb,YAAY,GACb,MAAM,eAAe,CAAC;AAEvB;;;;GAIG;AACH,SAAS,aAAa,CAAC,OAAe;IACpC,4EAA4E;IAC5E,iCAAiC;IACjC,sCAAsC;IACtC,OAAO,CAAC,IAAI,CAAC,aAAa,OAAO,EAAE,CAAC,CAAC;AACvC,CAAC;AAeD;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,MAA2B;IACtD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,MAAM,GAAmB,EAAE;IACvD,cAAc,CAAC,MAAM,CAAC,CAAC;IAEvB,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC5C,MAAM,KAAK,GAAG,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAEzC,OAAO;QACL,MAAM;QACN,UAAU,EACR,iBAAiB,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,iBAAiB,CAAC,MAAM,CAAC;QACnE,KAAK;QACL,WAAW,EAAE,qBAAqB,CAAC,MAAM,CAAC,WAAW,EAAE,KAAK,CAAC;QAC7D,qEAAqE;QACrE,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,MAAM,IAAI,mBAAmB;QACxE,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,IAAI,EAAE,oBAAoB,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC;QAC/C,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC;QAC9B,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,aAAa;QAC5C,KAAK,EAAE,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC;QACjC,SAAS,EAAE,EAAE,GAAG,gBAAgB,EAAE,GAAG,MAAM,CAAC,SAAS,EAAE;KACxD,CAAC;AACJ,CAAC"}

package/dist/config/resolve.d.ts

@@ -0,0 +1,31 @@
+import type { Background, BrandColors, CodeStyle, FontSource, OutputSize } from "../types.js";
+/**
+ * Fill in the palette a project did not name.
+ *
+ * When a project supplies only `brand`, use it for the whole gradient rather
+ * than mixing in the neutral defaults, which would clash.
+ */
+export declare function resolveColors(colors: BrandColors | undefined): Required<BrandColors>;
+/**
+ * Check a background's image up front, the way `fonts` and `logo` are checked.
+ * A background that cannot be read is every image in the build rendered as a
+ * flat colour, which is a failure worth hearing about before the build runs
+ * rather than after looking at the output.
+ */
+export declare function resolveBackground(background: Background | undefined): Background | undefined;
+/** The gradient a config with no background of its own is drawn on. */
+export declare function defaultBackground(colors: Required<BrandColors>): Background;
+/** Fill in the `code` styling a project did not name. */
+export declare function resolveCode(code: CodeStyle | undefined): Required<CodeStyle>;
+/**
+ * The sizes to render, rejecting a duplicate name: each size names a file, so
+ * two sizes sharing a name would have one overwrite the other.
+ */
+export declare function resolveSizes(sizes: readonly OutputSize[] | undefined): readonly OutputSize[];
+/**
+ * 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
+ * unless the project asks for them back.
+ */
+export declare function shouldLoadSystemFonts(systemFonts: boolean | undefined, fonts: readonly FontSource[]): boolean;
+//# sourceMappingURL=resolve.d.ts.map

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

@@ -0,0 +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"}

package/dist/config/resolve.js

@@ -0,0 +1,82 @@
+import { resolveImageSource } from "../image/index.js";
+import { DEFAULT_CODE_STYLE, DEFAULT_COLORS, DEFAULT_SIZES, } from "./defaults.js";
+/**
+ * Fill in the palette a project did not name.
+ *
+ * When a project supplies only `brand`, use it for the whole gradient rather
+ * than mixing in the neutral defaults, which would clash.
+ */
+export function resolveColors(colors) {
+    if (colors === undefined) {
+        return DEFAULT_COLORS;
+    }
+    return {
+        brand: colors.brand,
+        brandDark: colors.brandDark ?? colors.brand,
+        brandWarm: colors.brandWarm ?? colors.brand,
+        foreground: colors.foreground ?? DEFAULT_COLORS.foreground,
+    };
+}
+/**
+ * Check a background's image up front, the way `fonts` and `logo` are checked.
+ * A background that cannot be read is every image in the build rendered as a
+ * flat colour, which is a failure worth hearing about before the build runs
+ * rather than after looking at the output.
+ */
+export function resolveBackground(background) {
+    if (background?.type !== "image") {
+        return background;
+    }
+    return {
+        ...background,
+        source: resolveImageSource(background.source, "background.source"),
+    };
+}
+/** The gradient a config with no background of its own is drawn on. */
+export function defaultBackground(colors) {
+    return {
+        type: "gradient",
+        stops: [
+            { offset: "0%", color: colors.brandDark },
+            { offset: "55%", color: colors.brand },
+            { offset: "100%", color: colors.brandWarm },
+        ],
+    };
+}
+/** Fill in the `code` styling a project did not name. */
+export function resolveCode(code) {
+    return { ...DEFAULT_CODE_STYLE, ...code };
+}
+/**
+ * The sizes to render, rejecting a duplicate name: each size names a file, so
+ * two sizes sharing a name would have one overwrite the other.
+ */
+export function resolveSizes(sizes) {
+    if (sizes === undefined || sizes.length === 0) {
+        return DEFAULT_SIZES;
+    }
+    const seen = new Set();
+    for (const size of sizes) {
+        if (seen.has(size.name)) {
+            throw new Error(`Duplicate output size name "${size.name}"; names must be unique so each image gets a distinct filename.`);
+        }
+        seen.add(size.name);
+    }
+    return sizes;
+}
+/**
+ * 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
+ * unless the project asks for them back.
+ */
+export function shouldLoadSystemFonts(systemFonts, fonts) {
+    if (systemFonts === undefined) {
+        return fonts.length === 0;
+    }
+    if (!systemFonts && fonts.length === 0) {
+        throw new Error("systemFonts is false and no fonts are configured, so no text could be" +
+            " rendered. Add fonts, or leave systemFonts unset.");
+    }
+    return systemFonts;
+}
+//# sourceMappingURL=resolve.js.map

package/dist/config/resolve.js.map

@@ -0,0 +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"}

package/dist/config/size.d.ts

@@ -0,0 +1,20 @@
+import type { ColophonConfig, OutputSize, ResolvedConfig } from "../types.js";
+/**
+ * Apply a size's own overrides to a config and resolve the result: the config
+ * one image is actually rendered with.
+ *
+ * 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
+ * default gradient rebuilt around its brand, exactly as a config setting the
+ * same colour at the top level would.
+ *
+ * `colors` and `code` merge over their config-level counterparts, because both
+ * are bags of independent settings and the point of the feature is to change
+ * one of them. The rest replace: a `background` is a union whose variants have
+ * 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.
+ */
+export declare function resolveConfigForSize(config: ColophonConfig | undefined, size: OutputSize): ResolvedConfig;
+//# sourceMappingURL=size.d.ts.map

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

@@ -0,0 +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"}

package/dist/config/size.js

@@ -0,0 +1,47 @@
+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.
+ */
+function mergeColors(base, overrides) {
+    return { ...(base ?? DEFAULT_COLORS), ...overrides };
+}
+/**
+ * Apply a size's own overrides to a config and resolve the result: the config
+ * one image is actually rendered with.
+ *
+ * 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
+ * default gradient rebuilt around its brand, exactly as a config setting the
+ * same colour at the top level would.
+ *
+ * `colors` and `code` merge over their config-level counterparts, because both
+ * are bags of independent settings and the point of the feature is to change
+ * one of them. The rest replace: a `background` is a union whose variants have
+ * 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.
+ */
+export function resolveConfigForSize(config, size) {
+    const base = config ?? {};
+    return resolveConfig({
+        ...base,
+        ...(size.colors !== undefined && {
+            colors: mergeColors(base.colors, size.colors),
+        }),
+        ...(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

@@ -0,0 +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"}

package/dist/config.d.ts

@@ -36,7 +36,11 @@ export declare const SIZE_PRESETS: {
  * they satisfy `og:image` and both `twitter:image` card types.
  */
 export declare const DEFAULT_SIZES: readonly OutputSize[];
-/** Default font stack. Override via `config.fontFamily` for branded fonts. */
+/**
+ * Default font stack, used when no fonts are configured. It names families and
+ * hopes the machine has them, which is exactly what `config.fonts` exists to
+ * avoid: supply a font file and the output stops depending on the machine.
+ */
 export declare const DEFAULT_FONT_FAMILY = "Arial, Helvetica, sans-serif";
 /** Neutral default palette, used when no `colors.brand` is supplied. */
 export declare const DEFAULT_COLORS: Required<BrandColors>;
@@ -64,6 +68,28 @@ export declare const DEFAULT_CODE_STYLE: Required<CodeStyle>;
 export declare function defineConfig(config: ColophonConfig): ColophonConfig;
 /**
  * Apply defaults to a user config. Safe to call with no argument.
+ *
+ * Unknown options are rejected before anything is resolved, so a config
+ * written against a different version of the package is a build error rather
+ * than a set of images quietly rendered with the defaults.
  */
 export declare function resolveConfig(config?: ColophonConfig): ResolvedConfig;
+/**
+ * Apply a size's own overrides to a config and resolve the result: the config
+ * one image is actually rendered with.
+ *
+ * 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
+ * default gradient rebuilt around its brand, exactly as a config setting the
+ * same colour at the top level would.
+ *
+ * `colors` and `code` merge over their config-level counterparts, because both
+ * are bags of independent settings and the point of the feature is to change
+ * one of them. The rest replace: a `background` is a union whose variants have
+ * 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.
+ */
+export declare function resolveConfigForSize(config: ColophonConfig | undefined, size: OutputSize): ResolvedConfig;
 //# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,WAAW,EACX,SAAS,EACT,cAAc,EACd,UAAU,EACV,cAAc,EACf,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;GASG;AACH,eAAO,MAAM,YAAY;;iBACjB,IAAI,EAAE,IAAI;iBAAE,KAAK,EAAE,IAAI;iBAAE,MAAM,EAAE,GAAG;;;iBAChC,IAAI,EAAE,QAAQ;iBAAE,KAAK,EAAE,IAAI;iBAAE,MAAM,EAAE,IAAI;;;iBACxC,IAAI,EAAE,SAAS;iBAAE,KAAK,EAAE,IAAI;iBAAE,MAAM,EAAE,GAAG;;;iBACvC,IAAI,EAAE,WAAW;iBAAE,KAAK,EAAE,IAAI;iBAAE,MAAM,EAAE,IAAI;;CACZ,CAAC;AAEhD;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,SAAS,UAAU,EAG9C,CAAC;AAEF,8EAA8E;AAC9E,eAAO,MAAM,mBAAmB,iCAAiC,CAAC;AAElE,wEAAwE;AACxE,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,WAAW,CAKhD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,8FACkD,CAAC;AAExF;;;;;;;;;GASG;AACH,eAAO,MAAM,kBAAkB,EAAE,QAAQ,CAAC,SAAS,CASlD,CAAC;AAWF;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,cAAc,GAAG,cAAc,CAEnE;AAoDD;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,GAAE,cAAmB,GAAG,cAAc,CAczE"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAEV,WAAW,EACX,SAAS,EACT,cAAc,EAEd,UAAU,EACV,cAAc,EACf,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;GASG;AACH,eAAO,MAAM,YAAY;;iBACjB,IAAI,EAAE,IAAI;iBAAE,KAAK,EAAE,IAAI;iBAAE,MAAM,EAAE,GAAG;;;iBAChC,IAAI,EAAE,QAAQ;iBAAE,KAAK,EAAE,IAAI;iBAAE,MAAM,EAAE,IAAI;;;iBACxC,IAAI,EAAE,SAAS;iBAAE,KAAK,EAAE,IAAI;iBAAE,MAAM,EAAE,GAAG;;;iBACvC,IAAI,EAAE,WAAW;iBAAE,KAAK,EAAE,IAAI;iBAAE,MAAM,EAAE,IAAI;;CACZ,CAAC;AAEhD;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,SAAS,UAAU,EAG9C,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,iCAAiC,CAAC;AAElE,wEAAwE;AACxE,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,WAAW,CAKhD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,8FACkD,CAAC;AAExF;;;;;;;;;GASG;AACH,eAAO,MAAM,kBAAkB,EAAE,QAAQ,CAAC,SAAS,CASlD,CAAC;AAcF;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,cAAc,GAAG,cAAc,CAEnE;AA2ED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,MAAM,GAAE,cAAmB,GAAG,cAAc,CAoBzE;AAkBD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,cAAc,GAAG,SAAS,EAClC,IAAI,EAAE,UAAU,GACf,cAAc,CAchB"}