@kensio/colophon 2.4.0 → 2.6.0

package/dist/cli/args/index.js

@@ -0,0 +1,75 @@
+import { commandOf } from "./command.js";
+import { assertKnownFlag, switchesFrom } from "./switches.js";
+import { valueFlags, valueOf } from "./values.js";
+export { usage } from "./usage.js";
+/** Where each command's one positional goes: a path, or a generator's name. */
+function target(command, positionals) {
+    const extra = positionals[1];
+    // Two positionals is a mistake worth naming rather than quietly resolving:
+    // taking the last would build a tree the run did not mean to name.
+    if (extra !== undefined) {
+        throw new Error(`Unexpected argument "${extra}".`);
+    }
+    const first = positionals[0];
+    const empty = { contentDir: undefined, file: undefined, adapter: undefined };
+    switch (command) {
+        case "preview": {
+            return { ...empty, file: first };
+        }
+        case "eject": {
+            return { ...empty, adapter: first };
+        }
+        case "generate":
+        case "init": {
+            return { ...empty, contentDir: first };
+        }
+    }
+}
+/**
+ * One argument split at its first `=`, so that `--config=x` and `--config x`
+ * are the same thing. A path is free to contain an `=` because the split is
+ * only believed where the part before it is a flag that takes a value.
+ */
+function splitInline(arg) {
+    const at = arg.indexOf("=");
+    return at === -1 ? [arg, undefined] : [arg.slice(0, at), arg.slice(at + 1)];
+}
+/** Read the command line into the options each command takes. */
+export function parseCliArgs(argv) {
+    const command = commandOf(argv[0]);
+    const rest = command === "generate" ? argv : argv.slice(1);
+    const positionals = [];
+    const flags = new Set();
+    let values = {};
+    for (let index = 0; index < rest.length; index += 1) {
+        const arg = rest[index] ?? "";
+        const [flag, inline] = splitInline(arg);
+        if (valueFlags.has(flag)) {
+            let value = inline;
+            if (value === undefined) {
+                index += 1;
+                value = rest[index];
+            }
+            if (value === undefined) {
+                throw new Error(`Missing value for ${flag}`);
+            }
+            values = { ...values, ...valueOf(flag, value) };
+        }
+        else if (arg.startsWith("-")) {
+            assertKnownFlag(flag);
+            flags.add(flag);
+        }
+        else {
+            positionals.push(arg);
+        }
+    }
+    return {
+        command,
+        ...target(command, positionals),
+        configPath: values.configPath,
+        concurrency: values.concurrency,
+        size: values.size,
+        ...switchesFrom(flags),
+    };
+}
+//# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,18 @@
+/** The flags that carry no value, each of which sets one boolean. */
+export interface Switches {
+    readonly overwrite: boolean;
+    readonly dryRun: boolean;
+    readonly watch: boolean;
+}
+/**
+ * Reject an option the CLI does not have, suggesting what it looks like.
+ *
+ * Ignoring it silently is worse than it sounds: `--dry-runs` would then render
+ * and write a whole tree, which is the one thing the run was asking it not to
+ * do. The suggestion comes from the same edit distance the config validation
+ * uses, since a mistyped flag is the same slip as a mistyped option.
+ */
+export declare function assertKnownFlag(flag: string): void;
+/** Read the switches out of the flags a command line carried. */
+export declare function switchesFrom(flags: ReadonlySet<string>): Switches;
+//# sourceMappingURL=switches.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"switches.d.ts","sourceRoot":"","sources":["../../../src/cli/args/switches.ts"],"names":[],"mappings":"AAGA,qEAAqE;AACrE,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAgBD;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAYlD;AAED,iEAAiE;AACjE,wBAAgB,YAAY,CAAC,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,QAAQ,CASjE"}

package/dist/cli/args/switches.js

@@ -0,0 +1,42 @@
+import { nearestName } from "../../validate/suggest.js";
+import { valueFlags } from "./values.js";
+/** `--overwrite` is kept as an alias so existing build scripts keep working. */
+const forceFlags = ["-f", "--force", "-o", "--overwrite"];
+const dryRunFlags = ["-n", "--dry-run"];
+const watchFlags = ["-w", "--watch"];
+const helpFlags = ["-h", "--help"];
+const knownFlags = new Set([
+    ...forceFlags,
+    ...dryRunFlags,
+    ...watchFlags,
+    ...helpFlags,
+    ...valueFlags,
+]);
+/**
+ * Reject an option the CLI does not have, suggesting what it looks like.
+ *
+ * Ignoring it silently is worse than it sounds: `--dry-runs` would then render
+ * and write a whole tree, which is the one thing the run was asking it not to
+ * do. The suggestion comes from the same edit distance the config validation
+ * uses, since a mistyped flag is the same slip as a mistyped option.
+ */
+export function assertKnownFlag(flag) {
+    if (knownFlags.has(flag)) {
+        return;
+    }
+    const suggestion = nearestName(flag, [...knownFlags]);
+    const advice = suggestion === undefined
+        ? "Run colophon --help for the options."
+        : `Did you mean "${suggestion}"?`;
+    throw new Error(`Unknown option "${flag}". ${advice}`);
+}
+/** Read the switches out of the flags a command line carried. */
+export function switchesFrom(flags) {
+    const hasAnyOf = (group) => group.some((flag) => flags.has(flag));
+    return {
+        overwrite: hasAnyOf(forceFlags),
+        dryRun: hasAnyOf(dryRunFlags),
+        watch: hasAnyOf(watchFlags),
+    };
+}
+//# sourceMappingURL=switches.js.map

package/dist/cli/args/switches.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"switches.js","sourceRoot":"","sources":["../../../src/cli/args/switches.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AASzC,gFAAgF;AAChF,MAAM,UAAU,GAAG,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,aAAa,CAAC,CAAC;AAC1D,MAAM,WAAW,GAAG,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;AACxC,MAAM,UAAU,GAAG,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;AACrC,MAAM,SAAS,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AAEnC,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC;IACzB,GAAG,UAAU;IACb,GAAG,WAAW;IACd,GAAG,UAAU;IACb,GAAG,SAAS;IACZ,GAAG,UAAU;CACd,CAAC,CAAC;AAEH;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,IAAI,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QACzB,OAAO;IACT,CAAC;IAED,MAAM,UAAU,GAAG,WAAW,CAAC,IAAI,EAAE,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC;IACtD,MAAM,MAAM,GACV,UAAU,KAAK,SAAS;QACtB,CAAC,CAAC,sCAAsC;QACxC,CAAC,CAAC,iBAAiB,UAAU,IAAI,CAAC;IAEtC,MAAM,IAAI,KAAK,CAAC,mBAAmB,IAAI,MAAM,MAAM,EAAE,CAAC,CAAC;AACzD,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,YAAY,CAAC,KAA0B;IACrD,MAAM,QAAQ,GAAG,CAAC,KAAwB,EAAW,EAAE,CACrD,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;IAExC,OAAO;QACL,SAAS,EAAE,QAAQ,CAAC,UAAU,CAAC;QAC/B,MAAM,EAAE,QAAQ,CAAC,WAAW,CAAC;QAC7B,KAAK,EAAE,QAAQ,CAAC,UAAU,CAAC;KAC5B,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,3 @@
+/** Help text for `--help`, and for a run that asks for nothing else. */
+export declare const usage = "colophon: generate social meta images from frontmatter\n\nUsage:\n  colophon [contentDir] [options]    Render the images for a content tree\n  colophon init [contentDir]         Write a starter config module\n  colophon preview <file> [options]  Render one post and open it\n  colophon eject hugo                Write a Hugo partial that reads the\n                                     manifest and emits the meta tags\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. For init\n                        and eject, overwrite a file that is already there\n  -o, --overwrite       Alias for --force\n  -n, --dry-run         Report what would change and write nothing\n  -w, --watch           Rebuild whenever a content file changes\n  --concurrency <n>     How many images to render at once\n  --size <name>         Which configured size preview renders\n  -h, --help            Show this help\n\nDefaults:\n  contentDir            content\n  --concurrency         one per available CPU\n  --size                the first configured size\n\nThe first argument is a command where it names one, so a content directory\ncalled init, preview or eject has to be written as ./init.";
+//# sourceMappingURL=usage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../../src/cli/args/usage.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,eAAO,MAAM,KAAK,qiDA+ByC,CAAC"}

package/dist/cli/args/usage.js

@@ -0,0 +1,34 @@
+/** 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]    Render the images for a content tree
+  colophon init [contentDir]         Write a starter config module
+  colophon preview <file> [options]  Render one post and open it
+  colophon eject hugo                Write a Hugo partial that reads the
+                                     manifest and emits the meta tags
+
+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. For init
+                        and eject, overwrite a file that is already there
+  -o, --overwrite       Alias for --force
+  -n, --dry-run         Report what would change and write nothing
+  -w, --watch           Rebuild whenever a content file changes
+  --concurrency <n>     How many images to render at once
+  --size <name>         Which configured size preview renders
+  -h, --help            Show this help
+
+Defaults:
+  contentDir            content
+  --concurrency         one per available CPU
+  --size                the first configured size
+
+The first argument is a command where it names one, so a content directory
+called init, preview or eject has to be written as ./init.`;
+//# sourceMappingURL=usage.js.map

package/dist/cli/args/usage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.js","sourceRoot":"","sources":["../../../src/cli/args/usage.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,MAAM,CAAC,MAAM,KAAK,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2DA+BsC,CAAC"}

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

@@ -0,0 +1,11 @@
+/** The options whose value is the argument after them. */
+export interface FlagValues {
+    readonly configPath?: string;
+    readonly concurrency?: number;
+    readonly size?: string;
+}
+/** Flags that take the next argument as their value. */
+export declare const valueFlags: Set<string>;
+/** The one field a value flag sets, ready to be folded into the rest. */
+export declare function valueOf(flag: string, value: string): FlagValues;
+//# sourceMappingURL=values.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"values.d.ts","sourceRoot":"","sources":["../../../src/cli/args/values.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,wDAAwD;AACxD,eAAO,MAAM,UAAU,aAKrB,CAAC;AAkBH,yEAAyE;AACzE,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,UAAU,CAU/D"}

package/dist/cli/args/values.js

@@ -0,0 +1,29 @@
+/** Flags that take the next argument as their value. */
+export const valueFlags = new Set([
+    "-c",
+    "--config",
+    "--concurrency",
+    "--size",
+]);
+/**
+ * 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;
+}
+/** The one field a value flag sets, ready to be folded into the rest. */
+export function valueOf(flag, value) {
+    if (flag === "--concurrency") {
+        return { concurrency: parseConcurrency(value) };
+    }
+    if (flag === "--size") {
+        return { size: value };
+    }
+    return { configPath: value };
+}
+//# sourceMappingURL=values.js.map

package/dist/cli/args/values.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"values.js","sourceRoot":"","sources":["../../../src/cli/args/values.ts"],"names":[],"mappings":"AAOA,wDAAwD;AACxD,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC;IAChC,IAAI;IACJ,UAAU;IACV,eAAe;IACf,QAAQ;CACT,CAAC,CAAC;AAEH;;;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,yEAAyE;AACzE,MAAM,UAAU,OAAO,CAAC,IAAY,EAAE,KAAa;IACjD,IAAI,IAAI,KAAK,eAAe,EAAE,CAAC;QAC7B,OAAO,EAAE,WAAW,EAAE,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC;IAClD,CAAC;IAED,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtB,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IACzB,CAAC;IAED,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;AAC/B,CAAC"}

package/dist/cli/build.d.ts

@@ -0,0 +1,10 @@
+import type { CliArgs } from "./args/index.js";
+/**
+ * Render the images for a content tree: the CLI's original and usual job.
+ *
+ * Under `--watch` the same build runs again on every content change. The config
+ * is loaded once, outside the loop, since a watch does not pick up changes to it
+ * in any case.
+ */
+export declare function runBuild(args: CliArgs): Promise<void>;
+//# sourceMappingURL=build.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/cli/build.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAQ/C;;;;;;GAMG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CA6B3D"}

package/dist/cli/build.js

@@ -0,0 +1,41 @@
+import { defaultContentExtensions } from "../content/index.js";
+import { generate } from "../generate/index.js";
+import { loadConfig } from "./config.js";
+import { reportImage, reportSummary } from "./report.js";
+import { watchContent } from "./watch/index.js";
+/** Where a run with no content directory named looks for one. */
+const defaultContentDir = "content";
+/**
+ * Render the images for a content tree: the CLI's original and usual job.
+ *
+ * Under `--watch` the same build runs again on every content change. The config
+ * is loaded once, outside the loop, since a watch does not pick up changes to it
+ * in any case.
+ */
+export async function runBuild(args) {
+    const config = await loadConfig(args.configPath);
+    const contentDir = args.contentDir ?? defaultContentDir;
+    const build = async () => {
+        const results = await generate({
+            contentDir,
+            overwrite: args.overwrite,
+            dryRun: args.dryRun,
+            ...(config !== undefined && { config }),
+            ...(args.concurrency !== undefined && { concurrency: args.concurrency }),
+            onResult: (result) => {
+                reportImage(result, args.dryRun);
+            },
+        });
+        reportSummary(results, args.dryRun);
+    };
+    if (!args.watch) {
+        await build();
+        return;
+    }
+    await watchContent({
+        dir: contentDir,
+        extensions: config?.content?.extensions ?? defaultContentExtensions,
+        build,
+    });
+}
+//# sourceMappingURL=build.js.map

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"}