@kensio/colophon 2.1.0 → 2.3.0

package/dist/cli/args.d.ts

@@ -0,0 +1,14 @@
+/**
+ * The parsed command line.
+ */
+export interface CliArgs {
+    readonly contentDir: string;
+    readonly configPath: string | undefined;
+    readonly overwrite: boolean;
+    readonly concurrency: number | undefined;
+}
+/** Help text for `--help`, and for a run that asks for nothing else. */
+export declare const usage = "colophon \u2014 generate social meta images from frontmatter\n\nUsage:\n  colophon [contentDir] [options]\n\nImages carry a stamp of the props, config and size they came from, so a rebuild\nrenders only the ones that have actually changed.\n\nOptions:\n  -c, --config <path>   Load a config module. Its default export is either a\n                        ColophonConfig or a function (async or not) returning\n                        one, for a config that has to compute something.\n  -f, --force           Re-render every image, ignoring the stamps\n  -o, --overwrite       Alias for --force\n  --concurrency <n>     How many images to render at once\n  -h, --help            Show this help\n\nDefaults:\n  contentDir            content\n  --concurrency         one per available CPU";
+/** Read the command line into the options `generate` takes. */
+export declare function parseCliArgs(argv: readonly string[]): CliArgs;
+//# sourceMappingURL=args.d.ts.map

package/dist/cli/args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../../src/cli/args.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1C;AAED,wEAAwE;AACxE,eAAO,MAAM,KAAK,sxBAmB4B,CAAC;AAwB/C,+DAA+D;AAC/D,wBAAgB,YAAY,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CA4B7D"}

package/dist/cli/args.js

@@ -0,0 +1,67 @@
+/** Help text for `--help`, and for a run that asks for nothing else. */
+export 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. Its default export is either a
+                        ColophonConfig or a function (async or not) returning
+                        one, for a config that has to compute something.
+  -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
+  --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;
+}
+/** Read the command line into the options `generate` takes. */
+export 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 !== undefined && valueFlags.has(arg)) {
+            index += 1;
+            const value = argv[index];
+            if (value === undefined) {
+                throw new Error(`Missing value for ${arg}`);
+            }
+            if (arg === "--concurrency") {
+                concurrency = parseConcurrency(value);
+            }
+            else {
+                configPath = value;
+            }
+        }
+        else if (arg !== undefined && forceFlags.has(arg)) {
+            shouldOverwrite = true;
+        }
+        else if (arg !== undefined && !arg.startsWith("-")) {
+            contentDir = arg;
+        }
+    }
+    return { contentDir, configPath, overwrite: shouldOverwrite, concurrency };
+}
+//# sourceMappingURL=args.js.map

package/dist/cli/args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.js","sourceRoot":"","sources":["../../src/cli/args.ts"],"names":[],"mappings":"AAUA,wEAAwE;AACxE,MAAM,CAAC,MAAM,KAAK,GAAG;;;;;;;;;;;;;;;;;;;8CAmByB,CAAC;AAE/C,gFAAgF;AAChF,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC;AAEnE,wDAAwD;AACxD,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,EAAE,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC;AAEhE;;;GAGG;AACH,SAAS,gBAAgB,CAAC,KAAa;IACrC,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAE7B,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;QAChD,MAAM,IAAI,KAAK,CACb,qCAAqC,KAAK,iCAAiC,CAC5E,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,YAAY,CAAC,IAAuB;IAClD,IAAI,UAAU,GAAG,SAAS,CAAC;IAC3B,IAAI,UAA8B,CAAC;IACnC,IAAI,eAAe,GAAG,KAAK,CAAC;IAC5B,IAAI,WAA+B,CAAC;IAEpC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACpD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;QAExB,IAAI,GAAG,KAAK,SAAS,IAAI,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAC7C,KAAK,IAAI,CAAC,CAAC;YACX,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;YAC1B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,MAAM,IAAI,KAAK,CAAC,qBAAqB,GAAG,EAAE,CAAC,CAAC;YAC9C,CAAC;YACD,IAAI,GAAG,KAAK,eAAe,EAAE,CAAC;gBAC5B,WAAW,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;YACxC,CAAC;iBAAM,CAAC;gBACN,UAAU,GAAG,KAAK,CAAC;YACrB,CAAC;QACH,CAAC;aAAM,IAAI,GAAG,KAAK,SAAS,IAAI,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACpD,eAAe,GAAG,IAAI,CAAC;QACzB,CAAC;aAAM,IAAI,GAAG,KAAK,SAAS,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACrD,UAAU,GAAG,GAAG,CAAC;QACnB,CAAC;IACH,CAAC;IAED,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,eAAe,EAAE,WAAW,EAAE,CAAC;AAC7E,CAAC"}

package/dist/cli/config.d.ts

@@ -0,0 +1,12 @@
+import type { ColophonConfig } from "../types.js";
+/**
+ * Load the config module named by `--config`.
+ *
+ * The default export may be the config itself or a function returning one,
+ * possibly async. A config that has to compute something cannot be written as
+ * a literal, and without the function form such a project has to abandon the
+ * CLI and call `generate` from a script of its own — reimplementing the
+ * reporting the CLI already does along the way.
+ */
+export declare function loadConfig(configPath: string | undefined): Promise<ColophonConfig | undefined>;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/cli/config.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAuB,MAAM,aAAa,CAAC;AAwBvE;;;;;;;;GAQG;AACH,wBAAsB,UAAU,CAC9B,UAAU,EAAE,MAAM,GAAG,SAAS,GAC7B,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAiBrC"}

package/dist/cli/config.js

@@ -0,0 +1,43 @@
+import path from "node:path";
+import { pathToFileURL } from "node:url";
+/**
+ * A module that exports nothing usable is a mistake rather than a config that
+ * happens to be empty: the run named the file on the command line, so falling
+ * back to the defaults would render a whole tree with none of what it asked
+ * for and say nothing about it.
+ *
+ * An array is rejected for that reason and not for its own: `validateConfig`
+ * reads the keys of what it is given, and an empty one has none, so it is the
+ * one non-config that would otherwise pass as an empty config.
+ */
+function assertConfig(value, source) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        throw new Error(`${source} is not a config object.` +
+            ` Export a ColophonConfig, or a function returning one.`);
+    }
+}
+/**
+ * Load the config module named by `--config`.
+ *
+ * The default export may be the config itself or a function returning one,
+ * possibly async. A config that has to compute something cannot be written as
+ * a literal, and without the function form such a project has to abandon the
+ * CLI and call `generate` from a script of its own — reimplementing the
+ * reporting the CLI already does along the way.
+ */
+export async function loadConfig(configPath) {
+    if (configPath === undefined) {
+        return undefined;
+    }
+    const url = pathToFileURL(path.resolve(configPath)).href;
+    const module = (await import(url));
+    const exported = module.default;
+    if (typeof exported === "function") {
+        const config = await exported();
+        assertConfig(config, `The function exported by ${configPath}`);
+        return config;
+    }
+    assertConfig(exported, `The default export of ${configPath}`);
+    return exported;
+}
+//# sourceMappingURL=config.js.map

package/dist/cli/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/cli/config.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAIzC;;;;;;;;;GASG;AACH,SAAS,YAAY,CACnB,KAAc,EACd,MAAc;IAEd,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACxE,MAAM,IAAI,KAAK,CACb,GAAG,MAAM,0BAA0B;YACjC,wDAAwD,CAC3D,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,UAA8B;IAE9B,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC7B,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,GAAG,GAAG,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC;IACzD,MAAM,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,GAAG,CAAC,CAAsC,CAAC;IACxE,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC;IAEhC,IAAI,OAAO,QAAQ,KAAK,UAAU,EAAE,CAAC;QACnC,MAAM,MAAM,GAAG,MAAM,QAAQ,EAAE,CAAC;QAChC,YAAY,CAAC,MAAM,EAAE,4BAA4B,UAAU,EAAE,CAAC,CAAC;QAC/D,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,YAAY,CAAC,QAAQ,EAAE,yBAAyB,UAAU,EAAE,CAAC,CAAC;IAC9D,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/cli/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":""}

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,64 @@
+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. `charWidthRatio` and `lineHeight` drive the
+ * monospace grid the snippet is laid out on; 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;;;;;;;;;GASG;AACH,eAAO,MAAM,kBAAkB,EAAE,QAAQ,CAAC,SAAS,CASlD,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. `charWidthRatio` and `lineHeight` drive the
+ * monospace grid the snippet is laid out on; 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,
+    charWidthRatio: 0.6,
+    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;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAwB;IACrD,KAAK,EAAE,aAAa;IACpB,UAAU,EAAE,wBAAwB;IACpC,cAAc,EAAE,GAAG;IACnB,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":"AAEA,OAAO,KAAK,EACV,cAAc,EACd,qBAAqB,EAErB,cAAc,EACf,MAAM,aAAa,CAAC;AAWrB,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,CAoBzE"}

package/dist/config/index.js

@@ -0,0 +1,52 @@
+import { resolveFonts } from "../fonts/index.js";
+import { builtinTemplates } from "../templates/index.js";
+import { validateConfig } from "../validate/index.js";
+import { DEFAULT_FONT_FAMILY } from "./defaults.js";
+import { defaultBackground, 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: 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,
+        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,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,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,EAAE,MAAM,CAAC,UAAU,IAAI,iBAAiB,CAAC,MAAM,CAAC;QAC1D,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,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,24 @@
+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>;
+/** 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;AAOrB;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,WAAW,GAAG,SAAS,GAC9B,QAAQ,CAAC,WAAW,CAAC,CAWvB;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,66 @@
+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,
+    };
+}
+/** 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,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,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"}