@kensio/colophon 2.4.0 → 2.6.0

package/dist/cli/eject/index.js

@@ -0,0 +1,46 @@
+import { mkdir, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { nearestName } from "../../validate/suggest.js";
+import { isFile } from "../init/fs.js";
+import { adapterNames, adapters } from "./adapters.js";
+/** The adapter a run named, or a complaint naming the ones there are. */
+function selectAdapter(name) {
+    if (name === undefined) {
+        throw new Error(`colophon eject needs something to eject: ${adapterNames.join(", ")}.`);
+    }
+    const adapter = adapters[name];
+    if (adapter !== undefined) {
+        return adapter;
+    }
+    // The same slip, and the same answer, as a mistyped config option.
+    const suggestion = nearestName(name, adapterNames);
+    const help = suggestion === undefined
+        ? `Try one of: ${adapterNames.join(", ")}.`
+        : `Did you mean "${suggestion}"?`;
+    throw new Error(`Cannot eject "${name}". ${help}`);
+}
+/**
+ * Write a generator's template into the site, and say how to use it.
+ *
+ * Ejecting rather than importing is the point. The file lands in the site's own
+ * tree, where a project can read it, change the fallback chain and add a tag,
+ * without Colophon having to grow an option for every decision a site makes
+ * about its own head. What it replaces is 50-odd lines of globbing for images
+ * that the build already knew the names of.
+ *
+ * `dir` is the site root, the working directory by default, and a parameter
+ * because a test cannot `chdir`.
+ */
+export async function runEject(args, dir = process.cwd()) {
+    const adapter = selectAdapter(args.adapter);
+    const target = path.join(dir, adapter.file);
+    if ((await isFile(target)) && !args.overwrite) {
+        throw new Error(`${adapter.file} is already there. Pass --force to replace it,` +
+            ` remembering that it is a file you were meant to edit.`);
+    }
+    await mkdir(path.dirname(target), { recursive: true });
+    await writeFile(target, adapter.contents, "utf8");
+    console.log(`Wrote ${adapter.file}.`);
+    console.log(adapter.usage);
+}
+//# sourceMappingURL=index.js.map

package/dist/cli/eject/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cli/eject/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAExD,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAEvC,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEvD,yEAAyE;AACzE,SAAS,aAAa,CAAC,IAAwB;IAC7C,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CACb,4CAA4C,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CACvE,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAE/B,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,mEAAmE;IACnE,MAAM,UAAU,GAAG,WAAW,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IACnD,MAAM,IAAI,GACR,UAAU,KAAK,SAAS;QACtB,CAAC,CAAC,eAAe,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;QAC3C,CAAC,CAAC,iBAAiB,UAAU,IAAI,CAAC;IAEtC,MAAM,IAAI,KAAK,CAAC,iBAAiB,IAAI,MAAM,IAAI,EAAE,CAAC,CAAC;AACrD,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,IAAa,EACb,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE;IAEnB,MAAM,OAAO,GAAG,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC5C,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5C,IAAI,CAAC,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;QAC9C,MAAM,IAAI,KAAK,CACb,GAAG,OAAO,CAAC,IAAI,gDAAgD;YAC7D,wDAAwD,CAC3D,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACvD,MAAM,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAElD,OAAO,CAAC,GAAG,CAAC,SAAS,OAAO,CAAC,IAAI,GAAG,CAAC,CAAC;IACtC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC7B,CAAC"}

package/dist/cli/index.js

@@ -1,35 +1,40 @@
 #!/usr/bin/env node
-import { generate } from "../generate/index.js";
-import { parseCliArgs, usage } from "./args.js";
-import { loadConfig } from "./config.js";
+import { parseCliArgs, usage } from "./args/index.js";
+import { runBuild } from "./build.js";
+import { runEject } from "./eject/index.js";
+import { runInit } from "./init/index.js";
+import { messageOf } from "./message.js";
+import { runPreview } from "./preview/index.js";
+/** Run whichever command the arguments asked for. */
+async function run(args) {
+    switch (args.command) {
+        case "init": {
+            return runInit(args);
+        }
+        case "preview": {
+            return runPreview(args);
+        }
+        case "eject": {
+            return runEject(args);
+        }
+        case "generate": {
+            return runBuild(args);
+        }
+    }
+}
 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.`);
+    await run(parseCliArgs(argv));
 }
 try {
     await main();
 }
 catch (error) {
-    console.error(error instanceof Error ? error.message : String(error));
+    console.error(messageOf(error));
     process.exitCode = 1;
 }
 //# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -1 +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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhD,qDAAqD;AACrD,KAAK,UAAU,GAAG,CAAC,IAAa;IAC9B,QAAQ,IAAI,CAAC,OAAO,EAAE,CAAC;QACrB,KAAK,MAAM,EAAE,CAAC;YACZ,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC;QACvB,CAAC;QACD,KAAK,SAAS,EAAE,CAAC;YACf,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;QACD,KAAK,OAAO,EAAE,CAAC;YACb,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC;QACxB,CAAC;QACD,KAAK,UAAU,EAAE,CAAC;YAChB,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;AACH,CAAC;AAED,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,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC;AAChC,CAAC;AAED,IAAI,CAAC;IACH,MAAM,IAAI,EAAE,CAAC;AACf,CAAC;AAAC,OAAO,KAAK,EAAE,CAAC;IACf,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;IAChC,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC"}

package/dist/cli/init/fs.d.ts

@@ -0,0 +1,5 @@
+/** Whether a file is there to be read. */
+export declare function isFile(target: string): Promise<boolean>;
+/** Whether a directory is there to be walked. */
+export declare function isDirectory(target: string): Promise<boolean>;
+//# sourceMappingURL=fs.d.ts.map

package/dist/cli/init/fs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../../src/cli/init/fs.ts"],"names":[],"mappings":"AAeA,0CAA0C;AAC1C,wBAAsB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAE7D;AAED,iDAAiD;AACjD,wBAAsB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAElE"}

package/dist/cli/init/fs.js

@@ -0,0 +1,19 @@
+import { stat } from "node:fs/promises";
+/** Anything unreadable counts as absent, which is all these callers need. */
+async function statMatches(target, isWanted) {
+    try {
+        return isWanted(await stat(target));
+    }
+    catch {
+        return false;
+    }
+}
+/** Whether a file is there to be read. */
+export async function isFile(target) {
+    return statMatches(target, (stats) => stats.isFile());
+}
+/** Whether a directory is there to be walked. */
+export async function isDirectory(target) {
+    return statMatches(target, (stats) => stats.isDirectory());
+}
+//# sourceMappingURL=fs.js.map

package/dist/cli/init/fs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.js","sourceRoot":"","sources":["../../../src/cli/init/fs.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAExC,6EAA6E;AAC7E,KAAK,UAAU,WAAW,CACxB,MAAc,EACd,QAAmC;IAEnC,IAAI,CAAC;QACH,OAAO,QAAQ,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,0CAA0C;AAC1C,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,MAAc;IACzC,OAAO,WAAW,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;AACxD,CAAC;AAED,iDAAiD;AACjD,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,MAAc;IAC9C,OAAO,WAAW,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;AAC7D,CAAC"}

package/dist/cli/init/guess.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Guess which directory holds the content, or return `undefined` where none of
+ * the usual ones is there.
+ *
+ * The guess only ever reaches the command line this prints for the project to
+ * run next, so being wrong costs a corrected argument rather than a wrong build.
+ */
+export declare function guessContentDir(dir: string): Promise<string | undefined>;
+//# sourceMappingURL=guess.d.ts.map

package/dist/cli/init/guess.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guess.d.ts","sourceRoot":"","sources":["../../../src/cli/init/guess.ts"],"names":[],"mappings":"AAkBA;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAQ7B"}

package/dist/cli/init/guess.js

@@ -0,0 +1,27 @@
+import path from "node:path";
+import { isDirectory } from "./fs.js";
+/**
+ * Where a static site usually keeps its posts, in the order to prefer them.
+ * The list is short on purpose: a directory that is not on it is one the run
+ * can name itself, and guessing further would be guessing wrongly.
+ */
+const candidates = [
+    "content",
+    "src/content",
+    "posts",
+    "src/posts",
+    "_posts",
+    "src/pages",
+];
+/**
+ * Guess which directory holds the content, or return `undefined` where none of
+ * the usual ones is there.
+ *
+ * The guess only ever reaches the command line this prints for the project to
+ * run next, so being wrong costs a corrected argument rather than a wrong build.
+ */
+export async function guessContentDir(dir) {
+    const found = await Promise.all(candidates.map(async (candidate) => (await isDirectory(path.join(dir, candidate))) ? candidate : undefined));
+    return found.find((candidate) => candidate !== undefined);
+}
+//# sourceMappingURL=guess.js.map

package/dist/cli/init/guess.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guess.js","sourceRoot":"","sources":["../../../src/cli/init/guess.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAEtC;;;;GAIG;AACH,MAAM,UAAU,GAAG;IACjB,SAAS;IACT,aAAa;IACb,OAAO;IACP,WAAW;IACX,QAAQ;IACR,WAAW;CACZ,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,GAAW;IAEX,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,GAAG,CAC7B,UAAU,CAAC,GAAG,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,CACjC,CAAC,MAAM,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CACvE,CACF,CAAC;IAEF,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC;AAC5D,CAAC"}

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

@@ -0,0 +1,11 @@
+import type { CliArgs } from "../args/index.js";
+/**
+ * Write a starter config module into `dir`, the working directory by default,
+ * and say what to run against it.
+ *
+ * A config that is already there is replaced only under `--force`, and then at
+ * its own path rather than at the one this would have chosen: a project that
+ * settled on a TypeScript config should not end up holding two.
+ */
+export declare function runInit(args: CliArgs, dir?: string): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/init/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAiBhD;;;;;;;GAOG;AACH,wBAAsB,OAAO,CAC3B,IAAI,EAAE,OAAO,EACb,GAAG,SAAgB,GAClB,OAAO,CAAC,IAAI,CAAC,CAkBf"}

package/dist/cli/init/index.js

@@ -0,0 +1,36 @@
+import { writeFile } from "node:fs/promises";
+import path from "node:path";
+import { guessContentDir } from "./guess.js";
+import { configFilename, existingConfig } from "./module.js";
+import { scaffold } from "./scaffold.js";
+/** The command to run next, which is the whole point of the guess. */
+function nextStep(config, contentDir) {
+    if (contentDir === undefined) {
+        return (`No content directory found. Point the CLI at yours:\n` +
+            `  colophon <contentDir> --config ${config}`);
+    }
+    return `Then render the images:\n  colophon ${contentDir} --config ${config}`;
+}
+/**
+ * Write a starter config module into `dir`, the working directory by default,
+ * and say what to run against it.
+ *
+ * A config that is already there is replaced only under `--force`, and then at
+ * its own path rather than at the one this would have chosen: a project that
+ * settled on a TypeScript config should not end up holding two.
+ */
+export async function runInit(args, dir = process.cwd()) {
+    const [existing, chosen, guessed] = await Promise.all([
+        existingConfig(dir),
+        configFilename(dir),
+        guessContentDir(dir),
+    ]);
+    if (existing !== undefined && !args.overwrite) {
+        throw new Error(`${existing} is already there. Pass --force to replace it.`);
+    }
+    const config = existing ?? chosen;
+    await writeFile(path.join(dir, config), scaffold, "utf8");
+    console.log(`Wrote ${config}.`);
+    console.log(nextStep(config, args.contentDir ?? guessed));
+}
+//# sourceMappingURL=index.js.map

package/dist/cli/init/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cli/init/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,sEAAsE;AACtE,SAAS,QAAQ,CAAC,MAAc,EAAE,UAA8B;IAC9D,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC7B,OAAO,CACL,uDAAuD;YACvD,oCAAoC,MAAM,EAAE,CAC7C,CAAC;IACJ,CAAC;IAED,OAAO,uCAAuC,UAAU,aAAa,MAAM,EAAE,CAAC;AAChF,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,IAAa,EACb,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE;IAEnB,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACpD,cAAc,CAAC,GAAG,CAAC;QACnB,cAAc,CAAC,GAAG,CAAC;QACnB,eAAe,CAAC,GAAG,CAAC;KACrB,CAAC,CAAC;IAEH,IAAI,QAAQ,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;QAC9C,MAAM,IAAI,KAAK,CACb,GAAG,QAAQ,gDAAgD,CAC5D,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,QAAQ,IAAI,MAAM,CAAC;IAClC,MAAM,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IAE1D,OAAO,CAAC,GAAG,CAAC,SAAS,MAAM,GAAG,CAAC,CAAC;IAChC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,IAAI,OAAO,CAAC,CAAC,CAAC;AAC5D,CAAC"}

package/dist/cli/init/module.d.ts

@@ -0,0 +1,12 @@
+/** The config module a project already has, whatever it chose to call it. */
+export declare function existingConfig(dir: string): Promise<string | undefined>;
+/**
+ * What to call the config this command writes.
+ *
+ * A Colophon config is an ES module: `defineConfig` is imported and the config
+ * is the default export. In a project without `"type": "module"` a `.js` file
+ * is CommonJS, so `--config` would fail to import the very file `init` had just
+ * written. `.mjs` is that case's way out, and `.js` is right everywhere else.
+ */
+export declare function configFilename(dir: string): Promise<string>;
+//# sourceMappingURL=module.d.ts.map

package/dist/cli/init/module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../../../src/cli/init/module.ts"],"names":[],"mappings":"AAiBA,6EAA6E;AAC7E,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAQ7E;AAcD;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAIjE"}

package/dist/cli/init/module.js

@@ -0,0 +1,45 @@
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import { isFile } from "./fs.js";
+/**
+ * The names a config module is written under, in the order a project is
+ * likeliest to have chosen. A `.ts` config works on a Node that strips types,
+ * and the docs use one, so it is the first thing to look for.
+ */
+const configNames = [
+    "colophon.config.ts",
+    "colophon.config.mts",
+    "colophon.config.js",
+    "colophon.config.mjs",
+];
+/** The config module a project already has, whatever it chose to call it. */
+export async function existingConfig(dir) {
+    const found = await Promise.all(configNames.map(async (name) => (await isFile(path.join(dir, name))) ? name : undefined));
+    return found.find((name) => name !== undefined);
+}
+/** Whether the project has already declared itself an ES module. */
+async function isModuleProject(dir) {
+    try {
+        const raw = await readFile(path.join(dir, "package.json"), "utf8");
+        return JSON.parse(raw).type === "module";
+    }
+    catch {
+        // No package.json, or one that is not JSON. Either way there is nothing
+        // saying the project is ESM, so the safe extension is the one to write.
+        return false;
+    }
+}
+/**
+ * What to call the config this command writes.
+ *
+ * A Colophon config is an ES module: `defineConfig` is imported and the config
+ * is the default export. In a project without `"type": "module"` a `.js` file
+ * is CommonJS, so `--config` would fail to import the very file `init` had just
+ * written. `.mjs` is that case's way out, and `.js` is right everywhere else.
+ */
+export async function configFilename(dir) {
+    return (await isModuleProject(dir))
+        ? "colophon.config.js"
+        : "colophon.config.mjs";
+}
+//# sourceMappingURL=module.js.map

package/dist/cli/init/module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.js","sourceRoot":"","sources":["../../../src/cli/init/module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEjC;;;;GAIG;AACH,MAAM,WAAW,GAAG;IAClB,oBAAoB;IACpB,qBAAqB;IACrB,oBAAoB;IACpB,qBAAqB;CACtB,CAAC;AAEF,6EAA6E;AAC7E,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,GAAW;IAC9C,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,GAAG,CAC7B,WAAW,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAC7B,CAAC,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CACxD,CACF,CAAC;IAEF,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;AAClD,CAAC;AAED,oEAAoE;AACpE,KAAK,UAAU,eAAe,CAAC,GAAW;IACxC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAAC;QACnE,OAAQ,IAAI,CAAC,KAAK,CAAC,GAAG,CAAuB,CAAC,IAAI,KAAK,QAAQ,CAAC;IAClE,CAAC;IAAC,MAAM,CAAC;QACP,wEAAwE;QACxE,wEAAwE;QACxE,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,GAAW;IAC9C,OAAO,CAAC,MAAM,eAAe,CAAC,GAAG,CAAC,CAAC;QACjC,CAAC,CAAC,oBAAoB;QACtB,CAAC,CAAC,qBAAqB,CAAC;AAC5B,CAAC"}

package/dist/cli/init/scaffold.d.ts

@@ -0,0 +1,10 @@
+/**
+ * The config module `colophon init` writes.
+ *
+ * Most of it is commented out on purpose. What is left renders something
+ * recognisable straight away, and the comments say where the next decision goes
+ * rather than making every decision for the project up front. It is valid
+ * TypeScript as well as JavaScript, so it can be written to either extension.
+ */
+export declare const scaffold = "// Colophon config. Every field is optional.\n// Full documentation: https://colophonjs.dev/\nimport { defineConfig } from \"@kensio/colophon\";\n\nexport default defineConfig({\n  // Brand colours. The default background is a gradient built from these.\n  colors: {\n    brand: \"#4f46e5\",\n    brandDark: \"#3730a3\",\n    brandWarm: \"#db2777\",\n  },\n\n  // Or start from a named look, which brings its own colours, background and\n  // texture: aurora, bloom, ember, forest, midnight, paper, sandstone, slate.\n  // theme: \"midnight\",\n\n  // Drawn along the bottom of every image.\n  footer: \"example.com\",\n\n  // A small label above the title, on the banner template.\n  // badge: { text: \"npm\" },\n\n  // The sizes rendered for each post. This is the default pair.\n  // sizes: [\n  //   { name: \"og\", width: 1200, height: 630 },\n  //   { name: \"square\", width: 1200, height: 1200 },\n  // ],\n\n  // Handing the renderer font files, rather than hoping the machine has the\n  // family installed, is what makes a build render the same image everywhere.\n  // fonts: [{ family: \"Inter\", path: \"fonts/Inter-Bold.ttf\" }],\n\n  // Build image props from the frontmatter your posts already carry, so there\n  // is no props block to add to every file.\n  // content: {\n  //   defaultTemplate: \"banner\",\n  //   props: (frontmatter) => ({\n  //     title: frontmatter.title,\n  //     subtitle: frontmatter.description,\n  //   }),\n  // },\n});\n";
+//# sourceMappingURL=scaffold.d.ts.map

package/dist/cli/init/scaffold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../../../src/cli/init/scaffold.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,eAAO,MAAM,QAAQ,m8CA0CpB,CAAC"}

package/dist/cli/init/scaffold.js

@@ -0,0 +1,52 @@
+/**
+ * The config module `colophon init` writes.
+ *
+ * Most of it is commented out on purpose. What is left renders something
+ * recognisable straight away, and the comments say where the next decision goes
+ * rather than making every decision for the project up front. It is valid
+ * TypeScript as well as JavaScript, so it can be written to either extension.
+ */
+export const scaffold = `// Colophon config. Every field is optional.
+// Full documentation: https://colophonjs.dev/
+import { defineConfig } from "@kensio/colophon";
+
+export default defineConfig({
+  // Brand colours. The default background is a gradient built from these.
+  colors: {
+    brand: "#4f46e5",
+    brandDark: "#3730a3",
+    brandWarm: "#db2777",
+  },
+
+  // Or start from a named look, which brings its own colours, background and
+  // texture: aurora, bloom, ember, forest, midnight, paper, sandstone, slate.
+  // theme: "midnight",
+
+  // Drawn along the bottom of every image.
+  footer: "example.com",
+
+  // A small label above the title, on the banner template.
+  // badge: { text: "npm" },
+
+  // The sizes rendered for each post. This is the default pair.
+  // sizes: [
+  //   { name: "og", width: 1200, height: 630 },
+  //   { name: "square", width: 1200, height: 1200 },
+  // ],
+
+  // Handing the renderer font files, rather than hoping the machine has the
+  // family installed, is what makes a build render the same image everywhere.
+  // fonts: [{ family: "Inter", path: "fonts/Inter-Bold.ttf" }],
+
+  // Build image props from the frontmatter your posts already carry, so there
+  // is no props block to add to every file.
+  // content: {
+  //   defaultTemplate: "banner",
+  //   props: (frontmatter) => ({
+  //     title: frontmatter.title,
+  //     subtitle: frontmatter.description,
+  //   }),
+  // },
+});
+`;
+//# sourceMappingURL=scaffold.js.map

package/dist/cli/init/scaffold.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.js","sourceRoot":"","sources":["../../../src/cli/init/scaffold.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0CvB,CAAC"}

package/dist/cli/message.d.ts

@@ -0,0 +1,7 @@
+/**
+ * What to print when something has gone wrong. A stack trace is noise for the
+ * mistakes this CLI reports, which are nearly all a bad path, a bad flag or a
+ * config that does not add up.
+ */
+export declare function messageOf(error: unknown): string;
+//# sourceMappingURL=message.d.ts.map

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

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

package/dist/cli/message.js

@@ -0,0 +1,9 @@
+/**
+ * What to print when something has gone wrong. A stack trace is noise for the
+ * mistakes this CLI reports, which are nearly all a bad path, a bad flag or a
+ * config that does not add up.
+ */
+export function messageOf(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=message.js.map

package/dist/cli/message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message.js","sourceRoot":"","sources":["../../src/cli/message.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,KAAc;IACtC,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAChE,CAAC"}

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

@@ -0,0 +1,13 @@
+import type { CliArgs } from "../args/index.js";
+export { previewImage } from "./render.js";
+export type { PreviewOptions } from "./render.js";
+/**
+ * Render one post and open the image.
+ *
+ * Tuning a template, a palette or a snippet otherwise means running the whole
+ * build and finding the one image it produced that was the point. The path is
+ * printed as well as opened, so a shell that would rather do its own thing with
+ * the file can.
+ */
+export declare function runPreview(args: CliArgs): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/preview/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAKhD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD;;;;;;;GAOG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAiB7D"}

package/dist/cli/preview/index.js

@@ -0,0 +1,27 @@
+import { loadConfig } from "../config.js";
+import { openFile } from "./open.js";
+import { previewImage } from "./render.js";
+export { previewImage } from "./render.js";
+/**
+ * Render one post and open the image.
+ *
+ * Tuning a template, a palette or a snippet otherwise means running the whole
+ * build and finding the one image it produced that was the point. The path is
+ * printed as well as opened, so a shell that would rather do its own thing with
+ * the file can.
+ */
+export async function runPreview(args) {
+    if (args.file === undefined) {
+        throw new Error("colophon preview needs a content file, as in" +
+            " `colophon preview content/post/index.md`.");
+    }
+    const config = await loadConfig(args.configPath);
+    const output = await previewImage({
+        file: args.file,
+        config,
+        size: args.size,
+    });
+    console.log(output);
+    openFile(output);
+}
+//# sourceMappingURL=index.js.map

package/dist/cli/preview/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cli/preview/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAa;IAC5C,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CACb,8CAA8C;YAC5C,4CAA4C,CAC/C,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACjD,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC;QAChC,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,MAAM;QACN,IAAI,EAAE,IAAI,CAAC,IAAI;KAChB,CAAC,CAAC;IAEH,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACpB,QAAQ,CAAC,MAAM,CAAC,CAAC;AACnB,CAAC"}

package/dist/cli/preview/open.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Open a file in whatever the desktop uses for it, detached so that the CLI
+ * exits rather than waiting for a picture viewer to be closed.
+ *
+ * A failure is reported and no more. The path has already been printed, and a
+ * machine with nothing to open an image with, such as a build server, is not a
+ * mistake worth failing the command over.
+ */
+export declare function openFile(file: string): void;
+//# sourceMappingURL=open.d.ts.map

package/dist/cli/preview/open.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"open.d.ts","sourceRoot":"","sources":["../../../src/cli/preview/open.ts"],"names":[],"mappings":"AAsBA;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAY3C"}

package/dist/cli/preview/open.js

@@ -0,0 +1,32 @@
+import { spawn } from "node:child_process";
+function opener() {
+    if (process.platform === "darwin") {
+        return { command: "open", args: [] };
+    }
+    if (process.platform === "win32") {
+        // `start` takes a window title first, and an empty one keeps a path with
+        // spaces in it from being read as the title.
+        return { command: "cmd", args: ["/c", "start", ""] };
+    }
+    return { command: "xdg-open", args: [] };
+}
+/**
+ * Open a file in whatever the desktop uses for it, detached so that the CLI
+ * exits rather than waiting for a picture viewer to be closed.
+ *
+ * A failure is reported and no more. The path has already been printed, and a
+ * machine with nothing to open an image with, such as a build server, is not a
+ * mistake worth failing the command over.
+ */
+export function openFile(file) {
+    const { command, args } = opener();
+    const child = spawn(command, [...args, file], {
+        detached: true,
+        stdio: "ignore",
+    });
+    child.on("error", () => {
+        console.log(`Could not open ${file}; open it yourself.`);
+    });
+    child.unref();
+}
+//# sourceMappingURL=open.js.map

package/dist/cli/preview/open.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"open.js","sourceRoot":"","sources":["../../../src/cli/preview/open.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAQ3C,SAAS,MAAM;IACb,IAAI,OAAO,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAClC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;IACvC,CAAC;IAED,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QACjC,yEAAyE;QACzE,6CAA6C;QAC7C,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC,EAAE,CAAC;IACvD,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;AAC3C,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,MAAM,EAAE,CAAC;IACnC,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,IAAI,CAAC,EAAE;QAC5C,QAAQ,EAAE,IAAI;QACd,KAAK,EAAE,QAAQ;KAChB,CAAC,CAAC;IAEH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;QACrB,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,qBAAqB,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;IAEH,KAAK,CAAC,KAAK,EAAE,CAAC;AAChB,CAAC"}

package/dist/cli/preview/render.d.ts

@@ -0,0 +1,23 @@
+import type { ColophonConfig } from "../../types.js";
+/** What a preview renders: one post, at one size, with one config. */
+export interface PreviewOptions {
+    readonly file: string;
+    readonly config: ColophonConfig | undefined;
+    /** Which configured size, or the first of them. */
+    readonly size: string | undefined;
+}
+/**
+ * Render one post to a temporary image and return where it landed.
+ *
+ * The image goes to the system temp directory rather than into the tree,
+ * because a preview is not a build output. Beside the post it would land on the
+ * real image, which the next build would then find unstamped and render again,
+ * so tuning a template would quietly invalidate the tree it was tuned against.
+ * Nothing is stamped either, for the matching reason: a preview was asked for,
+ * so there is never anything to skip.
+ *
+ * Only one image is rendered, since the point is to look at it. Every other
+ * size the config declares is a `--size` away.
+ */
+export declare function previewImage(options: PreviewOptions): Promise<string>;
+//# sourceMappingURL=render.d.ts.map

package/dist/cli/preview/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../../src/cli/preview/render.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAIrD,sEAAsE;AACtE,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,SAAS,CAAC;IAC5C,mDAAmD;IACnD,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;CACnC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CA8B3E"}

package/dist/cli/preview/render.js

@@ -0,0 +1,40 @@
+import { mkdir, writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import path from "node:path";
+import { resolveConfig } from "../../config/index.js";
+import { resolveConfigForSize } from "../../config/size.js";
+import { readContentFile } from "../../content/index.js";
+import { extensionFor } from "../../encode/index.js";
+import { buildSvg, renderSvgToImage } from "../../render/index.js";
+import { contentRootFor } from "./root.js";
+import { pickSize } from "./size.js";
+/**
+ * Render one post to a temporary image and return where it landed.
+ *
+ * The image goes to the system temp directory rather than into the tree,
+ * because a preview is not a build output. Beside the post it would land on the
+ * real image, which the next build would then find unstamped and render again,
+ * so tuning a template would quietly invalidate the tree it was tuned against.
+ * Nothing is stamped either, for the matching reason: a preview was asked for,
+ * so there is never anything to skip.
+ *
+ * Only one image is rendered, since the point is to look at it. Every other
+ * size the config declares is a `--size` away.
+ */
+export async function previewImage(options) {
+    const resolved = resolveConfig(options.config);
+    const size = pickSize(resolved.sizes, options.size);
+    const file = await readContentFile(options.file, contentRootFor(options.file), options.config?.content);
+    if (file === undefined) {
+        throw new Error(`${options.file} declares no image props, so there is nothing to preview.`);
+    }
+    const config = resolveConfigForSize(options.config, size);
+    const dimensions = { width: size.width, height: size.height };
+    const svg = await buildSvg(file.props, config, dimensions);
+    const image = await renderSvgToImage(svg, dimensions, config);
+    const output = path.join(tmpdir(), "colophon-preview", `${file.slug}-${size.name}${extensionFor(config.format)}`);
+    await mkdir(path.dirname(output), { recursive: true });
+    await writeFile(output, image);
+    return output;
+}
+//# sourceMappingURL=render.js.map

package/dist/cli/preview/render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../../../src/cli/preview/render.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEnE,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAUrC;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAAuB;IACxD,MAAM,QAAQ,GAAG,aAAa,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/C,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpD,MAAM,IAAI,GAAG,MAAM,eAAe,CAChC,OAAO,CAAC,IAAI,EACZ,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC,EAC5B,OAAO,CAAC,MAAM,EAAE,OAAO,CACxB,CAAC;IAEF,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CACb,GAAG,OAAO,CAAC,IAAI,2DAA2D,CAC3E,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,oBAAoB,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC1D,MAAM,UAAU,GAAG,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;IAC9D,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;IAC3D,MAAM,KAAK,GAAG,MAAM,gBAAgB,CAAC,GAAG,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;IAE9D,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CACtB,MAAM,EAAE,EACR,kBAAkB,EAClB,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAC1D,CAAC;IACF,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACvD,MAAM,SAAS,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAE/B,OAAO,MAAM,CAAC;AAChB,CAAC"}