@kensio/colophon 2.5.0 → 2.6.0

package/dist/cli/build.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.js","sourceRoot":"","sources":["../../src/cli/build.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAEhD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD,iEAAiE;AACjE,MAAM,iBAAiB,GAAG,SAAS,CAAC;AAEpC;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,IAAa;IAC1C,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACjD,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,iBAAiB,CAAC;IAExD,MAAM,KAAK,GAAG,KAAK,IAAmB,EAAE;QACtC,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC;YAC7B,UAAU;YACV,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,GAAG,CAAC,MAAM,KAAK,SAAS,IAAI,EAAE,MAAM,EAAE,CAAC;YACvC,GAAG,CAAC,IAAI,CAAC,WAAW,KAAK,SAAS,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC;YACxE,QAAQ,EAAE,CAAC,MAAM,EAAE,EAAE;gBACnB,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;YACnC,CAAC;SACF,CAAC,CAAC;QAEH,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACtC,CAAC,CAAC;IAEF,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;QAChB,MAAM,KAAK,EAAE,CAAC;QACd,OAAO;IACT,CAAC;IAED,MAAM,YAAY,CAAC;QACjB,GAAG,EAAE,UAAU;QACf,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,IAAI,wBAAwB;QACnE,KAAK;KACN,CAAC,CAAC;AACL,CAAC"}

package/dist/cli/eject/adapters.d.ts

@@ -0,0 +1,20 @@
+/** A template a site can have written into it, and where it goes. */
+export interface Adapter {
+    /** Path the file is written to, relative to the site root. */
+    readonly file: string;
+    readonly contents: string;
+    /** What to do with it once it is there. */
+    readonly usage: string;
+}
+/**
+ * The adapters `colophon eject` knows about.
+ *
+ * One so far. It is a record rather than a special case for Hugo because the
+ * command has to name the ones it does know when asked for one it does not,
+ * and because the next generator is a second entry rather than a second
+ * command.
+ */
+export declare const adapters: Readonly<Record<string, Adapter>>;
+/** The adapter names, for the help text and for a run that misspells one. */
+export declare const adapterNames: readonly string[];
+//# sourceMappingURL=adapters.d.ts.map

package/dist/cli/eject/adapters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapters.d.ts","sourceRoot":"","sources":["../../../src/cli/eject/adapters.ts"],"names":[],"mappings":"AAGA,qEAAqE;AACrE,MAAM,WAAW,OAAO;IACtB,8DAA8D;IAC9D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,2CAA2C;IAC3C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAiBtD,CAAC;AAEF,6EAA6E;AAC7E,eAAO,MAAM,YAAY,EAAE,SAAS,MAAM,EAA0B,CAAC"}

package/dist/cli/eject/adapters.js

@@ -0,0 +1,29 @@
+import { astroComponent } from "./astro.js";
+import { hugoPartial } from "./hugo.js";
+/**
+ * The adapters `colophon eject` knows about.
+ *
+ * One so far. It is a record rather than a special case for Hugo because the
+ * command has to name the ones it does know when asked for one it does not,
+ * and because the next generator is a second entry rather than a second
+ * command.
+ */
+export const adapters = {
+    astro: {
+        file: "src/components/ColophonMeta.astro",
+        contents: astroComponent,
+        usage: `Use it in your layout's head:\n` +
+            `  <ColophonMeta />\n` +
+            `and point the config's manifest option at src/data/colophon.json.`,
+    },
+    hugo: {
+        file: "layouts/partials/colophon.html",
+        contents: hugoPartial,
+        usage: `Call it from your head:\n` +
+            `  {{ partial "colophon.html" . }}\n` +
+            `and point the config's manifest option at data/colophon.json.`,
+    },
+};
+/** The adapter names, for the help text and for a run that misspells one. */
+export const adapterNames = Object.keys(adapters);
+//# sourceMappingURL=adapters.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"adapters.js","sourceRoot":"","sources":["../../../src/cli/eject/adapters.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAWxC;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAsC;IACzD,KAAK,EAAE;QACL,IAAI,EAAE,mCAAmC;QACzC,QAAQ,EAAE,cAAc;QACxB,KAAK,EACH,iCAAiC;YACjC,sBAAsB;YACtB,mEAAmE;KACtE;IACD,IAAI,EAAE;QACJ,IAAI,EAAE,gCAAgC;QACtC,QAAQ,EAAE,WAAW;QACrB,KAAK,EACH,2BAA2B;YAC3B,qCAAqC;YACrC,+DAA+D;KAClE;CACF,CAAC;AAEF,6EAA6E;AAC7E,MAAM,CAAC,MAAM,YAAY,GAAsB,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC"}

package/dist/cli/eject/astro.d.ts

@@ -0,0 +1,13 @@
+/**
+ * The Astro component `colophon eject astro` writes.
+ *
+ * Ejected rather than exported, for the reason the Hugo partial is: a `<head>`
+ * is something a site owns. A shipped component would also be a `.astro` file
+ * in the published package, which nothing in this build compiles or typechecks,
+ * and which would then have to be kept working across Astro versions.
+ *
+ * The route is mapped to a manifest key by `metaTagsForPath`, which is in the
+ * package and tested there, so what is ejected stays small enough to read.
+ */
+export declare const astroComponent = "---\n/**\n * Social meta tags for the current route, from the images Colophon generated.\n *\n * Use it in your layout's <head>:\n *\n *     <ColophonMeta />\n *\n * The manifest import path is where the config's `manifest` option points.\n * The cast is because a JSON import types \"version\" as number rather than as\n * the literal 1 the Manifest type asks for.\n */\nimport { metaTagsForPath } from \"@kensio/colophon/meta\";\nimport type { Manifest } from \"@kensio/colophon\";\nimport manifest from \"../data/colophon.json\";\n\nconst tags = metaTagsForPath(manifest as Manifest, Astro.url.pathname, {\n  baseUrl: Astro.site?.href,\n});\n---\n\n{tags.map((tag) => <meta {...tag} />)}\n";
+//# sourceMappingURL=astro.d.ts.map

package/dist/cli/eject/astro.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"astro.d.ts","sourceRoot":"","sources":["../../../src/cli/eject/astro.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,eAAO,MAAM,cAAc,yrBAsB1B,CAAC"}

package/dist/cli/eject/astro.js

@@ -0,0 +1,35 @@
+/**
+ * The Astro component `colophon eject astro` writes.
+ *
+ * Ejected rather than exported, for the reason the Hugo partial is: a `<head>`
+ * is something a site owns. A shipped component would also be a `.astro` file
+ * in the published package, which nothing in this build compiles or typechecks,
+ * and which would then have to be kept working across Astro versions.
+ *
+ * The route is mapped to a manifest key by `metaTagsForPath`, which is in the
+ * package and tested there, so what is ejected stays small enough to read.
+ */
+export const astroComponent = `---
+/**
+ * Social meta tags for the current route, from the images Colophon generated.
+ *
+ * Use it in your layout's <head>:
+ *
+ *     <ColophonMeta />
+ *
+ * The manifest import path is where the config's \`manifest\` option points.
+ * The cast is because a JSON import types "version" as number rather than as
+ * the literal 1 the Manifest type asks for.
+ */
+import { metaTagsForPath } from "@kensio/colophon/meta";
+import type { Manifest } from "@kensio/colophon";
+import manifest from "../data/colophon.json";
+
+const tags = metaTagsForPath(manifest as Manifest, Astro.url.pathname, {
+  baseUrl: Astro.site?.href,
+});
+---
+
+{tags.map((tag) => <meta {...tag} />)}
+`;
+//# sourceMappingURL=astro.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"astro.js","sourceRoot":"","sources":["../../../src/cli/eject/astro.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;;;;;;;;;;;;;;;;;;;;;;CAsB7B,CAAC"}

package/dist/cli/eject/hugo.d.ts

@@ -0,0 +1,19 @@
+/**
+ * The Hugo partial `colophon eject hugo` writes.
+ *
+ * It is a lookup in the manifest a build wrote, which is the whole point: the
+ * two Hugo sites this was taken from spent 50 and 58 lines respectively globbing
+ * for `*-og.png` and hardcoding the dimensions, because nothing told them what
+ * had been generated.
+ *
+ * Ejected rather than imported. A partial shipped in `node_modules` would have
+ * to be mounted into the site's own `layouts`, and a site that wants to change
+ * the fallback chain, or emit one more tag, should be able to just edit it.
+ *
+ * Verified against Hugo 0.162 over a site covering each branch: a route key, a
+ * basename key, a frontmatter slug, a page bundle, a manifest entry with no
+ * URL, a page override, a page the manifest does not have, a page with no file
+ * at all, and a site with no manifest.
+ */
+export declare const hugoPartial = "{{- /*\n  Colophon: social meta tags for the current page, from the image manifest.\n\n  Call it from your <head>, passing the page:\n\n      {{ partial \"colophon.html\" . }}\n\n  It reads the manifest as site data, so point the config's `manifest` option\n  at `data/colophon.json`.\n\n  Needs Hugo 0.156 or newer for `hugo.Data`. On an older Hugo, change the two\n  references below to `site.Data`.\n\n  Colophon writes this file for you and then leaves it alone: it is yours to\n  edit. Re-running `colophon eject hugo --force` replaces it.\n*/ -}}\n\n{{- $pages := dict -}}\n{{- with hugo.Data.colophon -}}\n  {{- with .pages -}}\n    {{- $pages = . -}}\n  {{- end -}}\n{{- end -}}\n\n{{- /* The manifest is keyed by slug, and which slug depends on the\n       `slugStrategy` the build used. The route key is tried first and the\n       basename second, so one partial covers both without being told which. */ -}}\n{{- $keys := slice -}}\n{{- with .Params.colophon_key -}}\n  {{- $keys = $keys | append . -}}\n{{- end -}}\n{{- with .Slug -}}\n  {{- $keys = $keys | append . -}}\n{{- end -}}\n{{- $route := strings.TrimPrefix \"/\" .Path -}}\n{{- $keys = $keys | append (cond (eq $route \"\") \"index\" $route) -}}\n{{- with .File -}}\n  {{- $keys = $keys | append .ContentBaseName -}}\n{{- end -}}\n\n{{- $entry := dict -}}\n{{- range $keys -}}\n  {{- if not $entry -}}\n    {{- with index $pages . -}}\n      {{- $entry = . -}}\n    {{- end -}}\n  {{- end -}}\n{{- end -}}\n\n{{- /* The generated image, where the manifest has one with an address. A\n       placement without `urlBase` records dimensions and no URL, which is\n       nothing to point a crawler at. */ -}}\n{{- $image := false -}}\n{{- with $entry.images -}}\n  {{- $widest := index . $entry.widest -}}\n  {{- if $widest -}}\n    {{- if $widest.url -}}\n      {{- $image = $widest -}}\n    {{- end -}}\n  {{- end -}}\n{{- end -}}\n\n{{- /* An explicit page override wins, then the generated image, then whatever\n       the site falls back to. Width, height and alt describe the generated\n       image, so they go only with that one. */ -}}\n{{- $url := \"\" -}}\n{{- with .Params.images -}}\n  {{- $url = index . 0 -}}\n  {{- $image = false -}}\n{{- else -}}\n  {{- with $image -}}\n    {{- $url = .url -}}\n  {{- else -}}\n    {{- with site.Params.images -}}\n      {{- $url = index . 0 -}}\n    {{- end -}}\n  {{- end -}}\n{{- end -}}\n\n{{- with $url -}}\n  {{- $alt := \"\" -}}\n  {{- if $image -}}\n    {{- with $entry.alt -}}\n      {{- $alt = . -}}\n    {{- end -}}\n  {{- end -}}\n  {{- /* `summary_large_image` is specified for 2:1 and the Open Graph\n         landscape is 1.91:1, so both clear this; a square is shown better by\n         a plain summary card. Only a generated image has dimensions to judge\n         by, so anything else is assumed to be a landscape share image. */ -}}\n  {{- $large := true -}}\n  {{- with $image -}}\n    {{- $large = ge (div (float .width) (float .height)) 1.5 -}}\n  {{- end -}}\n<meta property=\"og:image\" content=\"{{ . | absURL }}\" />\n  {{- with $image }}\n<meta property=\"og:image:width\" content=\"{{ .width }}\" />\n<meta property=\"og:image:height\" content=\"{{ .height }}\" />\n  {{- end }}\n  {{- with $alt }}\n<meta property=\"og:image:alt\" content=\"{{ . }}\" />\n  {{- end }}\n<meta name=\"twitter:card\" content=\"{{ cond $large \"summary_large_image\" \"summary\" }}\" />\n<meta name=\"twitter:image\" content=\"{{ $url | absURL }}\" />\n  {{- with $alt }}\n<meta name=\"twitter:image:alt\" content=\"{{ . }}\" />\n  {{- end }}\n{{- end -}}\n";
+//# sourceMappingURL=hugo.d.ts.map

package/dist/cli/eject/hugo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hugo.d.ts","sourceRoot":"","sources":["../../../src/cli/eject/hugo.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,WAAW,sgHA4GvB,CAAC"}

package/dist/cli/eject/hugo.js

@@ -0,0 +1,127 @@
+/**
+ * The Hugo partial `colophon eject hugo` writes.
+ *
+ * It is a lookup in the manifest a build wrote, which is the whole point: the
+ * two Hugo sites this was taken from spent 50 and 58 lines respectively globbing
+ * for `*-og.png` and hardcoding the dimensions, because nothing told them what
+ * had been generated.
+ *
+ * Ejected rather than imported. A partial shipped in `node_modules` would have
+ * to be mounted into the site's own `layouts`, and a site that wants to change
+ * the fallback chain, or emit one more tag, should be able to just edit it.
+ *
+ * Verified against Hugo 0.162 over a site covering each branch: a route key, a
+ * basename key, a frontmatter slug, a page bundle, a manifest entry with no
+ * URL, a page override, a page the manifest does not have, a page with no file
+ * at all, and a site with no manifest.
+ */
+export const hugoPartial = `{{- /*
+  Colophon: social meta tags for the current page, from the image manifest.
+
+  Call it from your <head>, passing the page:
+
+      {{ partial "colophon.html" . }}
+
+  It reads the manifest as site data, so point the config's \`manifest\` option
+  at \`data/colophon.json\`.
+
+  Needs Hugo 0.156 or newer for \`hugo.Data\`. On an older Hugo, change the two
+  references below to \`site.Data\`.
+
+  Colophon writes this file for you and then leaves it alone: it is yours to
+  edit. Re-running \`colophon eject hugo --force\` replaces it.
+*/ -}}
+
+{{- $pages := dict -}}
+{{- with hugo.Data.colophon -}}
+  {{- with .pages -}}
+    {{- $pages = . -}}
+  {{- end -}}
+{{- end -}}
+
+{{- /* The manifest is keyed by slug, and which slug depends on the
+       \`slugStrategy\` the build used. The route key is tried first and the
+       basename second, so one partial covers both without being told which. */ -}}
+{{- $keys := slice -}}
+{{- with .Params.colophon_key -}}
+  {{- $keys = $keys | append . -}}
+{{- end -}}
+{{- with .Slug -}}
+  {{- $keys = $keys | append . -}}
+{{- end -}}
+{{- $route := strings.TrimPrefix "/" .Path -}}
+{{- $keys = $keys | append (cond (eq $route "") "index" $route) -}}
+{{- with .File -}}
+  {{- $keys = $keys | append .ContentBaseName -}}
+{{- end -}}
+
+{{- $entry := dict -}}
+{{- range $keys -}}
+  {{- if not $entry -}}
+    {{- with index $pages . -}}
+      {{- $entry = . -}}
+    {{- end -}}
+  {{- end -}}
+{{- end -}}
+
+{{- /* The generated image, where the manifest has one with an address. A
+       placement without \`urlBase\` records dimensions and no URL, which is
+       nothing to point a crawler at. */ -}}
+{{- $image := false -}}
+{{- with $entry.images -}}
+  {{- $widest := index . $entry.widest -}}
+  {{- if $widest -}}
+    {{- if $widest.url -}}
+      {{- $image = $widest -}}
+    {{- end -}}
+  {{- end -}}
+{{- end -}}
+
+{{- /* An explicit page override wins, then the generated image, then whatever
+       the site falls back to. Width, height and alt describe the generated
+       image, so they go only with that one. */ -}}
+{{- $url := "" -}}
+{{- with .Params.images -}}
+  {{- $url = index . 0 -}}
+  {{- $image = false -}}
+{{- else -}}
+  {{- with $image -}}
+    {{- $url = .url -}}
+  {{- else -}}
+    {{- with site.Params.images -}}
+      {{- $url = index . 0 -}}
+    {{- end -}}
+  {{- end -}}
+{{- end -}}
+
+{{- with $url -}}
+  {{- $alt := "" -}}
+  {{- if $image -}}
+    {{- with $entry.alt -}}
+      {{- $alt = . -}}
+    {{- end -}}
+  {{- end -}}
+  {{- /* \`summary_large_image\` is specified for 2:1 and the Open Graph
+         landscape is 1.91:1, so both clear this; a square is shown better by
+         a plain summary card. Only a generated image has dimensions to judge
+         by, so anything else is assumed to be a landscape share image. */ -}}
+  {{- $large := true -}}
+  {{- with $image -}}
+    {{- $large = ge (div (float .width) (float .height)) 1.5 -}}
+  {{- end -}}
+<meta property="og:image" content="{{ . | absURL }}" />
+  {{- with $image }}
+<meta property="og:image:width" content="{{ .width }}" />
+<meta property="og:image:height" content="{{ .height }}" />
+  {{- end }}
+  {{- with $alt }}
+<meta property="og:image:alt" content="{{ . }}" />
+  {{- end }}
+<meta name="twitter:card" content="{{ cond $large "summary_large_image" "summary" }}" />
+<meta name="twitter:image" content="{{ $url | absURL }}" />
+  {{- with $alt }}
+<meta name="twitter:image:alt" content="{{ . }}" />
+  {{- end }}
+{{- end -}}
+`;
+//# sourceMappingURL=hugo.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hugo.js","sourceRoot":"","sources":["../../../src/cli/eject/hugo.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4G1B,CAAC"}

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

@@ -0,0 +1,15 @@
+import type { CliArgs } from "../args/index.js";
+/**
+ * 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 declare function runEject(args: CliArgs, dir?: string): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/eject/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AA6BhD;;;;;;;;;;;GAWG;AACH,wBAAsB,QAAQ,CAC5B,IAAI,EAAE,OAAO,EACb,GAAG,SAAgB,GAClB,OAAO,CAAC,IAAI,CAAC,CAgBf"}

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