blume 1.6.5 → 1.7.0

package/dist/cli/chunk-ckh3a410.js

@@ -0,0 +1,277 @@
+#!/usr/bin/env node
+import {
+  reportInternalError
+} from "./chunk-btfr9yvw.js";
+import {
+  writeTextAtomic
+} from "./chunk-ev67ycx0.js";
+import {
+  VERSION_LIKE,
+  isWithin,
+  localizeRoute,
+  nextFenceState,
+  scanProject,
+  versionizeRoute
+} from "./chunk-s102bysw.js";
+import {
+  VERSION_ID,
+  loadConfig
+} from "./chunk-xv91q4nm.js";
+import {
+  stripBasePath
+} from "./chunk-27gtm2ym.js";
+import"./chunk-4xyggvgf.js";
+import"./chunk-6kzzpsx8.js";
+import {
+  BlumeError,
+  logger
+} from "./chunk-ey89bjj1.js";
+import {
+  commandMeta
+} from "./chunk-2aj8ddew.js";
+
+// src/cli/commands/version.ts
+import { defineCommand } from "citty";
+
+// src/core/version-cut.ts
+import { existsSync } from "node:fs";
+import { cp, readdir, readFile, rm } from "node:fs/promises";
+import { join, relative } from "pathe";
+class CutError extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "CutError";
+  }
+}
+var INLINE_CODE = /`[^`]*`/gu;
+var ROOT_LINK = /(?<prefix>\]\(|href="|src=")(?<target>\/[^\s"')]*)/gu;
+var buildRouteRewrites = (project, id) => {
+  const { basePath, i18n } = project.config;
+  const { contentRoot } = project.context;
+  const rewrites = new Map;
+  for (const page of project.graph.pages) {
+    const { sourcePath } = page;
+    if (page.version !== "" || page.collection === "staged" || !sourcePath || relative(contentRoot, sourcePath).startsWith("..")) {
+      continue;
+    }
+    const logical = versionizeRoute(page.versionKey, id);
+    rewrites.set(stripBasePath(basePath, page.route), i18n ? localizeRoute(logical, page.locale, i18n) : logical);
+  }
+  return rewrites;
+};
+var rewriteLine = (line, rewrites) => {
+  const masked = line.replaceAll(INLINE_CODE, (span) => " ".repeat(span.length));
+  let out = "";
+  let cursor = 0;
+  let count = 0;
+  for (const match of masked.matchAll(ROOT_LINK)) {
+    const target = match.groups?.target ?? "";
+    const hash = target.search(/[#?]/u);
+    const path = hash === -1 ? target : target.slice(0, hash);
+    const suffix = hash === -1 ? "" : target.slice(hash);
+    const bare = path !== "/" && path.endsWith("/") ? path.slice(0, -1) : path;
+    const replacement = rewrites.get(bare);
+    if (replacement === undefined) {
+      continue;
+    }
+    const offset = (match.index ?? 0) + (match.groups?.prefix?.length ?? 0);
+    out += line.slice(cursor, offset) + replacement + suffix;
+    cursor = offset + target.length;
+    count += 1;
+  }
+  return count === 0 ? line : out + line.slice(cursor);
+};
+var rewriteSnapshotLinks = (source, rewrites) => {
+  let fence = null;
+  let count = 0;
+  const lines = source.split(`
+`).map((line) => {
+    const next = nextFenceState(line, fence);
+    const inFence = fence !== null || next !== null;
+    fence = next;
+    if (inFence) {
+      return line;
+    }
+    const rewrittenLine = rewriteLine(line, rewrites);
+    if (rewrittenLine !== line) {
+      count += 1;
+    }
+    return rewrittenLine;
+  });
+  return { count, text: lines.join(`
+`) };
+};
+var snippetFor = (id, hasVersions) => hasVersions ? `Add to versions.archived in blume.config.ts (newest first):
+
+  { id: "${id}" },
+` : `Add to blume.config.ts:
+
+  versions: {
+    archived: [{ id: "${id}" }],
+    current: { label: "…" },
+  },
+`;
+var insertArchivedVersion = async (configPath, id) => {
+  let text;
+  try {
+    text = await readFile(configPath, "utf-8");
+  } catch {
+    return false;
+  }
+  const match = text.match(/(?<lead>archived:\s*\[)/u);
+  if (!match || match.index === undefined) {
+    return false;
+  }
+  const insertAt = match.index + (match.groups?.lead?.length ?? 0);
+  const lineStart = text.lastIndexOf(`
+`, match.index) + 1;
+  const indent = text.slice(lineStart).match(/^\s*/u)?.[0] ?? "";
+  const rest = text.slice(insertAt);
+  const eol = /^\r?\n/u.exec(rest)?.[0];
+  let entry;
+  if (rest.trimStart().startsWith("]")) {
+    entry = `{ id: "${id}" }`;
+  } else if (eol) {
+    entry = `${eol}${indent}  { id: "${id}" },`;
+  } else {
+    entry = `{ id: "${id}" }, `;
+  }
+  await writeTextAtomic(configPath, text.slice(0, insertAt) + entry + rest);
+  return true;
+};
+var cutVersion = async (root, id, options = {}) => {
+  if (!VERSION_ID.test(id)) {
+    throw new CutError(`Version ids must start with a letter (e.g. "v1.0") and contain only letters, digits, dots, hyphens, and underscores — got "${id}".`);
+  }
+  const project = await scanProject(root);
+  const errors = project.diagnostics.filter((diagnostic) => diagnostic.severity === "error");
+  if (errors.length > 0) {
+    throw new CutError(`The project has ${errors.length} error diagnostic(s) — fix them before cutting a version (run \`blume validate\`).`);
+  }
+  const { contentRoot } = project.context;
+  if (project.config.versions?.archived.some((version) => version.id === id)) {
+    throw new CutError(`Version "${id}" is already registered in versions.archived.`);
+  }
+  const dir = join(contentRoot, id);
+  if (existsSync(dir)) {
+    if (!options.force) {
+      throw new CutError(`${dir} already exists — pass --force to overwrite the snapshot.`);
+    }
+    await rm(dir, { force: true, recursive: true });
+  }
+  const excluded = new Set([
+    id,
+    "node_modules",
+    ...project.config.versions?.archived.map((version) => version.id) ?? []
+  ]);
+  const foreignRoots = project.sources.flatMap((source) => source.staged && source.contentRoot ? [source.contentRoot] : []).filter((tree) => isWithin(contentRoot, tree));
+  const isForeign = (path) => foreignRoots.some((tree) => isWithin(tree, path));
+  const entries = await readdir(contentRoot, { withFileTypes: true });
+  let copied = 0;
+  await Promise.all(entries.map(async (entry) => {
+    if (excluded.has(entry.name) || entry.name.startsWith(".") || entry.isDirectory() && VERSION_LIKE.test(entry.name)) {
+      return;
+    }
+    await cp(join(contentRoot, entry.name), join(dir, entry.name), {
+      filter: (source) => !isForeign(source),
+      recursive: true
+    });
+  }));
+  const rewrites = buildRouteRewrites(project, id);
+  const rewritten = [];
+  const walk = async (current) => {
+    const children = await readdir(current, { withFileTypes: true });
+    await Promise.all(children.map(async (child) => {
+      const abs = join(current, child.name);
+      if (child.isDirectory()) {
+        await walk(abs);
+        return;
+      }
+      copied += 1;
+      if (!/\.mdx?$/u.test(child.name)) {
+        return;
+      }
+      const source = await readFile(abs, "utf-8");
+      const { text, count } = rewriteSnapshotLinks(source, rewrites);
+      if (count > 0) {
+        await writeTextAtomic(abs, text);
+        rewritten.push({ count, file: relative(dir, abs) });
+      }
+    }));
+  };
+  await walk(dir);
+  const configPath = join(root, "blume.config.ts");
+  const configUpdated = project.config.versions !== undefined && await insertArchivedVersion(configPath, id);
+  return {
+    configSnippet: configUpdated ? null : snippetFor(id, project.config.versions !== undefined),
+    configUpdated,
+    copied,
+    dir,
+    rewritten
+  };
+};
+
+// src/cli/commands/version.ts
+var versionCommand = defineCommand({
+  args: {
+    force: {
+      description: "Overwrite an existing snapshot directory.",
+      type: "boolean"
+    },
+    id: {
+      description: 'Version id to cut (e.g. "v1.0").',
+      required: false,
+      type: "positional"
+    }
+  },
+  meta: commandMeta.version,
+  async run({ args }) {
+    const root = process.cwd();
+    if (!args.id) {
+      const { config } = await loadConfig(root);
+      if (!config.versions) {
+        logger.info("Versioning is not configured. Cut the first version with `blume version <id>` (e.g. `blume version v1.0`).");
+        return;
+      }
+      const { current, archived } = config.versions;
+      process.stdout.write(`  ${current.label} (current)${current.badge ? ` — ${current.badge}` : ""}
+`);
+      for (const version of archived) {
+        process.stdout.write(`  ${version.label ?? version.id} — ${version.id}/
+`);
+      }
+      return;
+    }
+    try {
+      const result = await cutVersion(root, args.id, { force: args.force });
+      logger.success(`Snapshot ${result.dir} (${result.copied} file(s) copied)`);
+      const totalRewrites = result.rewritten.reduce((sum, entry) => sum + entry.count, 0);
+      if (totalRewrites > 0) {
+        logger.info(`Rewrote root-absolute links in ${result.rewritten.length} page(s) (${totalRewrites} line(s)).`);
+      }
+      if (result.configUpdated) {
+        logger.success(`Added "${args.id}" to versions.archived in blume.config.ts`);
+      } else if (result.configSnippet) {
+        logger.info(result.configSnippet);
+      }
+      logger.info("Archived versions are frozen — future edits belong in the live tree. Restart `blume dev` to pick up the snapshot.");
+    } catch (error) {
+      if (error instanceof CutError) {
+        logger.error(error.message);
+        process.exit(1);
+      }
+      if (error instanceof BlumeError) {
+        logger.error(error.diagnostic.message);
+        process.exit(1);
+      }
+      reportInternalError(error);
+      process.exit(1);
+    }
+  }
+});
+export {
+  versionCommand
+};
+
+//# debugId=D706C6D39089651F64756E2164756E21
+//# sourceMappingURL=chunk-ckh3a410.js.map

package/dist/cli/chunk-ckh3a410.js.map

@@ -0,0 +1,11 @@
+{
+  "version": 3,
+  "sources": ["../src/cli/commands/version.ts", "../src/core/version-cut.ts"],
+  "sourcesContent": [
+    "import { defineCommand } from \"citty\";\n\nimport { loadConfig } from \"../../core/config.ts\";\nimport { BlumeError } from \"../../core/diagnostics.ts\";\nimport { CutError, cutVersion } from \"../../core/version-cut.ts\";\nimport { commandMeta } from \"../command-meta.ts\";\nimport { reportInternalError } from \"../internal-error.ts\";\nimport { logger } from \"../log.ts\";\n\nexport const versionCommand = defineCommand({\n  args: {\n    force: {\n      description: \"Overwrite an existing snapshot directory.\",\n      type: \"boolean\",\n    },\n    id: {\n      description: 'Version id to cut (e.g. \"v1.0\").',\n      required: false,\n      type: \"positional\",\n    },\n  },\n  meta: commandMeta.version,\n  async run({ args }) {\n    const root = process.cwd();\n\n    if (!args.id) {\n      const { config } = await loadConfig(root);\n      if (!config.versions) {\n        logger.info(\n          \"Versioning is not configured. Cut the first version with `blume version <id>` (e.g. `blume version v1.0`).\"\n        );\n        return;\n      }\n      const { current, archived } = config.versions;\n      process.stdout.write(\n        `  ${current.label} (current)${current.badge ? ` — ${current.badge}` : \"\"}\\n`\n      );\n      for (const version of archived) {\n        process.stdout.write(\n          `  ${version.label ?? version.id} — ${version.id}/\\n`\n        );\n      }\n      return;\n    }\n\n    try {\n      const result = await cutVersion(root, args.id, { force: args.force });\n      logger.success(\n        `Snapshot ${result.dir} (${result.copied} file(s) copied)`\n      );\n      const totalRewrites = result.rewritten.reduce(\n        (sum, entry) => sum + entry.count,\n        0\n      );\n      if (totalRewrites > 0) {\n        logger.info(\n          `Rewrote root-absolute links in ${result.rewritten.length} page(s) (${totalRewrites} line(s)).`\n        );\n      }\n      if (result.configUpdated) {\n        logger.success(\n          `Added \"${args.id}\" to versions.archived in blume.config.ts`\n        );\n      } else if (result.configSnippet) {\n        logger.info(result.configSnippet);\n      }\n      logger.info(\n        \"Archived versions are frozen — future edits belong in the live tree. Restart `blume dev` to pick up the snapshot.\"\n      );\n    } catch (error) {\n      if (error instanceof CutError) {\n        logger.error(error.message);\n        process.exit(1);\n      }\n      if (error instanceof BlumeError) {\n        logger.error(error.diagnostic.message);\n        process.exit(1);\n      }\n      reportInternalError(error);\n      process.exit(1);\n    }\n  },\n});\n",
+    "import { existsSync } from \"node:fs\";\nimport { cp, readdir, readFile, rm } from \"node:fs/promises\";\n\nimport { join, relative } from \"pathe\";\n\nimport { stripBasePath } from \"./base-path.ts\";\nimport { nextFenceState } from \"./code-fences.ts\";\nimport type { FenceState } from \"./code-fences.ts\";\nimport { writeTextAtomic } from \"./fs-atomic.ts\";\nimport { localizeRoute } from \"./i18n.ts\";\nimport type { BlumeProject } from \"./project-graph.ts\";\nimport { isWithin, scanProject } from \"./project-graph.ts\";\nimport { VERSION_ID } from \"./schema.ts\";\nimport { VERSION_LIKE, versionizeRoute } from \"./versions.ts\";\n\n/** What `cutVersion` did, for the CLI to report. */\nexport interface CutResult {\n  /** Files copied into the snapshot. */\n  copied: number;\n  /** Markdown pages whose root-absolute links were rewritten, with counts. */\n  rewritten: { file: string; count: number }[];\n  /** Whether `blume.config.ts` was updated in place. */\n  configUpdated: boolean;\n  /** Ready-to-paste config snippet when in-place update was not possible. */\n  configSnippet: string | null;\n  /** Absolute path of the created snapshot directory. */\n  dir: string;\n}\n\n/** A `cutVersion` failure the CLI reports as a user error, not a crash. */\nexport class CutError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = \"CutError\";\n  }\n}\n\n// Inline code spans are syntax being *shown*, not links — blank them before\n// matching so replacements can splice into the real line by index (the mask\n// preserves length). Mirrors the content-assets rewriter.\nconst INLINE_CODE = /`[^`]*`/gu;\n// A markdown link/image target or an HTML href/src attribute whose value is\n// root-absolute. Named groups carry the prefix (kept) and target (rewritten).\nconst ROOT_LINK = /(?<prefix>\\]\\(|href=\"|src=\")(?<target>\\/[^\\s\"')]*)/gu;\n\n/**\n * Build the link-rewrite table: every current-version route (basePath\n * stripped, since authors write root-absolute links as if mounted at root)\n * mapped to the same page's route inside the new snapshot. Only pages the\n * snapshot actually contains qualify — filesystem pages under the content\n * root. Spec-rendered references (`/api`, `/events`) and remote sources\n * aren't copied, so links to them keep pointing at the live pages instead of\n * a 404 inside the snapshot.\n */\nconst buildRouteRewrites = (\n  project: BlumeProject,\n  id: string\n): Map<string, string> => {\n  const { basePath, i18n } = project.config;\n  const { contentRoot } = project.context;\n  const rewrites = new Map<string, string>();\n  for (const page of project.graph.pages) {\n    // `sourcePath` marks a page backed by a local file, which excludes\n    // generated and remote pages; the content-root check below excludes local\n    // files that live outside the tree a version snapshot copies. A staged\n    // page (an Obsidian note) is served from its source, not from the copied\n    // tree, so it keeps publishing as current even when its file sits under\n    // the content root.\n    const { sourcePath } = page;\n    if (\n      page.version !== \"\" ||\n      page.collection === \"staged\" ||\n      !sourcePath ||\n      relative(contentRoot, sourcePath).startsWith(\"..\")\n    ) {\n      continue;\n    }\n    const logical = versionizeRoute(page.versionKey, id);\n    rewrites.set(\n      stripBasePath(basePath, page.route),\n      i18n ? localizeRoute(logical, page.locale, i18n) : logical\n    );\n  }\n  return rewrites;\n};\n\n/** Rewrite one line's root-absolute internal links via the rewrite table. */\nconst rewriteLine = (line: string, rewrites: Map<string, string>): string => {\n  const masked = line.replaceAll(INLINE_CODE, (span) =>\n    \" \".repeat(span.length)\n  );\n  let out = \"\";\n  let cursor = 0;\n  let count = 0;\n  for (const match of masked.matchAll(ROOT_LINK)) {\n    const target = match.groups?.target ?? \"\";\n    // An anchor or query stays attached to the rewritten path.\n    const hash = target.search(/[#?]/u);\n    const path = hash === -1 ? target : target.slice(0, hash);\n    const suffix = hash === -1 ? \"\" : target.slice(hash);\n    const bare = path !== \"/\" && path.endsWith(\"/\") ? path.slice(0, -1) : path;\n    const replacement = rewrites.get(bare);\n    if (replacement === undefined) {\n      continue;\n    }\n    const offset = (match.index ?? 0) + (match.groups?.prefix?.length ?? 0);\n    out += line.slice(cursor, offset) + replacement + suffix;\n    cursor = offset + target.length;\n    count += 1;\n  }\n  return count === 0 ? line : out + line.slice(cursor);\n};\n\n/** A page's link-rewritten text and how many of its lines changed. */\nexport interface SnapshotRewrite {\n  text: string;\n  count: number;\n}\n\n/**\n * Rewrite a copied page's root-absolute internal links to their snapshot\n * equivalents, skipping fenced and inline code. Relative links need no\n * rewriting — the whole tree copies together, so they stay self-contained.\n */\nexport const rewriteSnapshotLinks = (\n  source: string,\n  rewrites: Map<string, string>\n): SnapshotRewrite => {\n  let fence: FenceState = null;\n  let count = 0;\n  const lines = source.split(\"\\n\").map((line) => {\n    const next = nextFenceState(line, fence);\n    const inFence = fence !== null || next !== null;\n    fence = next;\n    if (inFence) {\n      return line;\n    }\n    const rewrittenLine = rewriteLine(line, rewrites);\n    if (rewrittenLine !== line) {\n      count += 1;\n    }\n    return rewrittenLine;\n  });\n  return { count, text: lines.join(\"\\n\") };\n};\n\n/** The config entry to add, as a paste-ready snippet for the fallback path. */\nconst snippetFor = (id: string, hasVersions: boolean): string =>\n  hasVersions\n    ? `Add to versions.archived in blume.config.ts (newest first):\\n\\n  { id: \"${id}\" },\\n`\n    : `Add to blume.config.ts:\\n\\n  versions: {\\n    archived: [{ id: \"${id}\" }],\\n    current: { label: \"…\" },\\n  },\\n`;\n\n/**\n * Best-effort in-place config update: insert the new id at the head of an\n * existing \\`archived: [\\` array literal, preserving indentation. Anything\n * fancier (computed arrays, config spread across files) falls back to a\n * printed snippet — the config is user-authored TypeScript, and string-level\n * surgery beyond this simple shape risks corrupting it.\n */\nexport const insertArchivedVersion = async (\n  configPath: string,\n  id: string\n): Promise<boolean> => {\n  let text: string;\n  try {\n    text = await readFile(configPath, \"utf-8\");\n  } catch {\n    return false;\n  }\n  const match = text.match(/(?<lead>archived:\\s*\\[)/u);\n  if (!match || match.index === undefined) {\n    return false;\n  }\n  const insertAt = match.index + (match.groups?.lead?.length ?? 0);\n  // Indentation: one level deeper than the line holding `archived:`.\n  const lineStart = text.lastIndexOf(\"\\n\", match.index) + 1;\n  const indent = text.slice(lineStart).match(/^\\s*/u)?.[0] ?? \"\";\n  const rest = text.slice(insertAt);\n  // Match the array's authored shape: empty stays bare, an inline array gets\n  // an inline entry, a multiline array gets its own indented line — on the\n  // file's own line ending, so a CRLF config doesn't gain a lone LF.\n  const eol = /^\\r?\\n/u.exec(rest)?.[0];\n  let entry: string;\n  if (rest.trimStart().startsWith(\"]\")) {\n    entry = `{ id: \"${id}\" }`;\n  } else if (eol) {\n    entry = `${eol}${indent}  { id: \"${id}\" },`;\n  } else {\n    entry = `{ id: \"${id}\" }, `;\n  }\n  await writeTextAtomic(configPath, text.slice(0, insertAt) + entry + rest);\n  return true;\n};\n\n/**\n * Freeze the current docs as an archived version: copy the content tree into\n * `<contentRoot>/<id>/` (excluding existing snapshots), rewrite root-absolute\n * internal links so the copy is self-contained, and register the id in\n * `blume.config.ts` (or print the snippet to paste).\n */\nexport const cutVersion = async (\n  root: string,\n  id: string,\n  options: { force?: boolean } = {}\n): Promise<CutResult> => {\n  if (!VERSION_ID.test(id)) {\n    throw new CutError(\n      `Version ids must start with a letter (e.g. \"v1.0\") and contain only letters, digits, dots, hyphens, and underscores — got \"${id}\".`\n    );\n  }\n\n  const project = await scanProject(root);\n  const errors = project.diagnostics.filter(\n    (diagnostic) => diagnostic.severity === \"error\"\n  );\n  if (errors.length > 0) {\n    throw new CutError(\n      `The project has ${errors.length} error diagnostic(s) — fix them before cutting a version (run \\`blume validate\\`).`\n    );\n  }\n  // A missing content root already fails inside `scanProject` (the filesystem\n  // source's own validation), so only the version-level checks remain here.\n  const { contentRoot } = project.context;\n  if (project.config.versions?.archived.some((version) => version.id === id)) {\n    throw new CutError(\n      `Version \"${id}\" is already registered in versions.archived.`\n    );\n  }\n\n  const dir = join(contentRoot, id);\n  if (existsSync(dir)) {\n    if (!options.force) {\n      throw new CutError(\n        `${dir} already exists — pass --force to overwrite the snapshot.`\n      );\n    }\n    await rm(dir, { force: true, recursive: true });\n  }\n\n  // Existing snapshots must not nest inside the new one: configured ids, plus\n  // any version-shaped directory (`v1.0/`) that never made it into the config —\n  // e.g. a prior cut whose config update fell back to a printed snippet. A\n  // genuine content folder that merely looks like a version already draws the\n  // rename-or-register diagnostic, so skipping it here is consistent.\n  const excluded = new Set([\n    id,\n    \"node_modules\",\n    ...(project.config.versions?.archived.map((version) => version.id) ?? []),\n  ]);\n  // Another local source's tree under the content root — an Obsidian vault the\n  // filesystem source excludes — is that source's to publish. Copying it would\n  // republish its raw notes (wikilinks and `%%comments%%` intact) as\n  // filesystem pages of the snapshot, while the source itself keeps serving\n  // them as current.\n  const foreignRoots = project.sources\n    .flatMap((source) =>\n      source.staged && source.contentRoot ? [source.contentRoot] : []\n    )\n    .filter((tree) => isWithin(contentRoot, tree));\n  const isForeign = (path: string): boolean =>\n    foreignRoots.some((tree) => isWithin(tree, path));\n  const entries = await readdir(contentRoot, { withFileTypes: true });\n  let copied = 0;\n  await Promise.all(\n    entries.map(async (entry) => {\n      if (\n        excluded.has(entry.name) ||\n        entry.name.startsWith(\".\") ||\n        (entry.isDirectory() && VERSION_LIKE.test(entry.name))\n      ) {\n        return;\n      }\n      await cp(join(contentRoot, entry.name), join(dir, entry.name), {\n        filter: (source) => !isForeign(source),\n        recursive: true,\n      });\n    })\n  );\n\n  // Rewrite root-absolute internal links in every copied markdown page.\n  const rewrites = buildRouteRewrites(project, id);\n  const rewritten: { file: string; count: number }[] = [];\n  const walk = async (current: string): Promise<void> => {\n    const children = await readdir(current, { withFileTypes: true });\n    await Promise.all(\n      children.map(async (child) => {\n        const abs = join(current, child.name);\n        if (child.isDirectory()) {\n          await walk(abs);\n          return;\n        }\n        copied += 1;\n        if (!/\\.mdx?$/u.test(child.name)) {\n          return;\n        }\n        const source = await readFile(abs, \"utf-8\");\n        const { text, count } = rewriteSnapshotLinks(source, rewrites);\n        if (count > 0) {\n          await writeTextAtomic(abs, text);\n          rewritten.push({ count, file: relative(dir, abs) });\n        }\n      })\n    );\n  };\n  await walk(dir);\n\n  const configPath = join(root, \"blume.config.ts\");\n  const configUpdated =\n    project.config.versions !== undefined &&\n    (await insertArchivedVersion(configPath, id));\n\n  return {\n    configSnippet: configUpdated\n      ? null\n      : snippetFor(id, project.config.versions !== undefined),\n    configUpdated,\n    copied,\n    dir,\n    rewritten,\n  };\n};\n"
+  ],
+  "mappings": "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",
+  "debugId": "D706C6D39089651F64756E2164756E21",
+  "names": []
+}

package/dist/cli/chunk-drke6t0h.js

@@ -0,0 +1,259 @@
+#!/usr/bin/env node
+import {
+  ensureGitignore
+} from "./chunk-5hs6gb7n.js";
+import {
+  PACKAGE_MANAGERS,
+  TEMPLATES,
+  applyPlan,
+  buildPlan,
+  commandsFor,
+  detectPackageManager,
+  eject,
+  nextSteps,
+  titleize,
+  updatePackageScripts,
+  validateContentDir
+} from "./chunk-s5dsk8bj.js";
+import"./chunk-5d4q7121.js";
+import"./chunk-ynacq3ev.js";
+import"./chunk-pxj10x8y.js";
+import"./chunk-sbdqrjbb.js";
+import"./chunk-v5mm027v.js";
+import"./chunk-ev67ycx0.js";
+import"./chunk-vt8fgygt.js";
+import"./chunk-3r94j3tc.js";
+import"./chunk-agy5rzxy.js";
+import"./chunk-j6pxe0dt.js";
+import"./chunk-vxv4x1n8.js";
+import"./chunk-wd27zjcz.js";
+import"./chunk-s102bysw.js";
+import"./chunk-xv91q4nm.js";
+import"./chunk-27gtm2ym.js";
+import"./chunk-4xyggvgf.js";
+import"./chunk-6kzzpsx8.js";
+import {
+  logger
+} from "./chunk-ey89bjj1.js";
+import {
+  commandMeta
+} from "./chunk-2aj8ddew.js";
+
+// src/cli/commands/init.ts
+import * as clack from "@clack/prompts";
+import { defineCommand } from "citty";
+import { resolve as resolve2 } from "pathe";
+
+// src/cli/init/questions.ts
+import { basename, resolve } from "pathe";
+var cancelled = (value) => typeof value === "symbol";
+var collectAnswers = async (prompter, flags, defaults) => {
+  const directory = flags.directory ?? await prompter.text({
+    defaultValue: ".",
+    message: "Where should we create your project?",
+    placeholder: "./my-docs"
+  });
+  if (cancelled(directory)) {
+    return null;
+  }
+  const root = resolve(defaults.cwd, directory);
+  const title = await prompter.text({
+    initialValue: titleize(basename(root)),
+    message: "What's your docs site called?",
+    validate: (value) => value?.trim() ? undefined : "Give your docs site a name."
+  });
+  if (cancelled(title)) {
+    return null;
+  }
+  const template = flags.template ?? await prompter.select({
+    message: "Which template?",
+    options: [
+      { hint: "Markdown docs site", label: "docs", value: "docs" },
+      { hint: "OpenAPI reference at /api", label: "api", value: "api" },
+      { hint: "SDK docs with an install page", label: "sdk", value: "sdk" },
+      {
+        hint: "Docs plus a changelog tab",
+        label: "changelog",
+        value: "changelog"
+      }
+    ]
+  });
+  if (cancelled(template)) {
+    return null;
+  }
+  const picked = await prompter.multiselect({
+    initialValues: ["filesystem"],
+    message: "Where does your content live?",
+    options: [
+      { hint: "Local .mdx files", label: "filesystem", value: "filesystem" },
+      { hint: "An Obsidian vault", label: "obsidian", value: "obsidian" },
+      {
+        hint: "Changelog from GitHub Releases",
+        label: "github-releases",
+        value: "github-releases"
+      },
+      { hint: "A Notion database", label: "notion", value: "notion" },
+      { hint: "A Sanity dataset", label: "sanity", value: "sanity" },
+      {
+        hint: "MDX fetched from a GitHub repo",
+        label: "mdx-remote",
+        value: "mdx-remote"
+      }
+    ],
+    required: false
+  });
+  if (cancelled(picked)) {
+    return null;
+  }
+  const sources = picked.length === 0 ? ["filesystem"] : picked;
+  let contentDir = flags.contentDir ?? "docs";
+  if (flags.contentDir === undefined && sources.includes("filesystem")) {
+    const answer = await prompter.text({
+      defaultValue: "docs",
+      message: "Content directory?",
+      placeholder: "docs",
+      validate: (value) => validateContentDir(root, value || "docs")
+    });
+    if (cancelled(answer)) {
+      return null;
+    }
+    contentDir = answer;
+  }
+  return {
+    contentDir,
+    directory,
+    packageManager: flags.packageManager ?? detectPackageManager(defaults.userAgent),
+    sources,
+    template,
+    title
+  };
+};
+
+// src/cli/commands/init.ts
+var ejectScaffold = async (root, answers) => {
+  const commands = commandsFor(answers.packageManager);
+  const cd = answers.directory === "." ? [] : [`cd ${answers.directory}`];
+  try {
+    await eject(root);
+    await updatePackageScripts(root);
+    logger.success("Ejected to a standalone Astro project.");
+    const steps = [...cd, commands.install, commands.dev];
+    logger.box(`Next steps:
+
+  ${steps.join(`
+  `)}
+`);
+  } catch (error) {
+    logger.warn(`Scaffolded, but eject needs the project's dependencies installed to load blume.config.ts: ${error.message}`);
+    const steps = [
+      ...cd,
+      commands.install,
+      `${commands.exec} blume eject --yes`
+    ];
+    logger.box(`Next steps:
+
+  ${steps.join(`
+  `)}
+`);
+  }
+};
+var initCommand = defineCommand({
+  args: {
+    "content-dir": {
+      description: "Content directory.",
+      type: "string"
+    },
+    dir: {
+      description: "Directory to scaffold into (default: current directory).",
+      required: false,
+      type: "positional"
+    },
+    eject: {
+      description: "Eject to a standalone Astro project after scaffolding.",
+      type: "boolean"
+    },
+    "package-manager": {
+      description: "Package manager for the next-steps hint (npm|pnpm|yarn|bun).",
+      type: "string"
+    },
+    template: {
+      description: "Starter template: docs | api | sdk | changelog.",
+      type: "string"
+    },
+    yes: {
+      description: "Skip prompts and scaffold with defaults.",
+      type: "boolean"
+    }
+  },
+  meta: commandMeta.init,
+  async run({ args }) {
+    const cwd = process.cwd();
+    const template = TEMPLATES.find((candidate) => candidate === args.template);
+    if (args.template !== undefined && template === undefined) {
+      logger.error(`Unknown template "${args.template}" (use ${TEMPLATES.join(" | ")}).`);
+      process.exit(1);
+    }
+    const pm = PACKAGE_MANAGERS.find((candidate) => candidate === args["package-manager"]);
+    if (args["package-manager"] !== undefined && pm === undefined) {
+      logger.error(`Unknown package manager "${args["package-manager"]}" (use ${PACKAGE_MANAGERS.join(" | ")}).`);
+      process.exit(1);
+    }
+    const interactive = !args.yes && process.stdin.isTTY === true && clack.isTTY(process.stdout) && !clack.isCI();
+    let answers;
+    if (interactive) {
+      clack.intro("blume init");
+      const collected = await collectAnswers(clack, {
+        contentDir: args["content-dir"],
+        directory: args.dir,
+        packageManager: pm,
+        template
+      }, { cwd, userAgent: process.env.npm_config_user_agent });
+      if (collected === null) {
+        clack.cancel("Cancelled — nothing was written.");
+        process.exit(0);
+      }
+      answers = collected;
+    } else {
+      answers = {
+        contentDir: args["content-dir"] ?? "docs",
+        directory: args.dir ?? ".",
+        packageManager: pm ?? detectPackageManager(process.env.npm_config_user_agent),
+        sources: ["filesystem"],
+        template: template ?? "docs",
+        title: "My Docs"
+      };
+    }
+    const root = resolve2(cwd, answers.directory);
+    if (validateContentDir(root, answers.contentDir) !== undefined) {
+      logger.error(`Invalid --content-dir "${answers.contentDir}" (must be a path inside the project).`);
+      process.exit(1);
+    }
+    const sink = interactive ? clack.log : logger;
+    const { createdPackage } = await applyPlan(buildPlan(root, answers), sink);
+    const ignored = await ensureGitignore(root, [
+      "node_modules/",
+      ".blume/",
+      "dist/"
+    ]);
+    if (ignored.length > 0) {
+      sink.success(`Added ${ignored.join(", ")} to .gitignore`);
+    }
+    if (args.eject) {
+      await ejectScaffold(root, answers);
+      return;
+    }
+    const steps = nextSteps(answers, createdPackage);
+    if (interactive) {
+      clack.note(steps.trimEnd());
+      clack.outro("You're all set.");
+    } else {
+      logger.box(steps);
+    }
+  }
+});
+export {
+  initCommand
+};
+
+//# debugId=E1A6E93028E72EA864756E2164756E21
+//# sourceMappingURL=chunk-drke6t0h.js.map

package/dist/cli/chunk-drke6t0h.js.map

@@ -0,0 +1,11 @@
+{
+  "version": 3,
+  "sources": ["../src/cli/commands/init.ts", "../src/cli/init/questions.ts"],
+  "sourcesContent": [
+    "import * as clack from \"@clack/prompts\";\nimport { defineCommand } from \"citty\";\nimport { resolve } from \"pathe\";\n\nimport { ensureGitignore } from \"../../core/gitignore.ts\";\nimport { eject } from \"../../registry/eject.ts\";\nimport { commandMeta } from \"../command-meta.ts\";\nimport { updatePackageScripts } from \"../eject-scripts.ts\";\nimport { collectAnswers } from \"../init/questions.ts\";\nimport {\n  applyPlan,\n  buildPlan,\n  commandsFor,\n  detectPackageManager,\n  nextSteps,\n  PACKAGE_MANAGERS,\n  TEMPLATES,\n  validateContentDir,\n} from \"../init/scaffold.ts\";\nimport type { InitAnswers } from \"../init/scaffold.ts\";\nimport { logger } from \"../log.ts\";\n\n/**\n * Eject the freshly scaffolded project, or print the install-then-eject path.\n * Eject jiti-loads the scaffolded blume.config.ts, whose `import { defineConfig }\n * from \"blume\"` only resolves once dependencies are installed (or blume is\n * hoisted from an ancestor node_modules, as in a monorepo) — so on a fresh\n * scaffold the fallback below is the common path.\n */\nconst ejectScaffold = async (\n  root: string,\n  answers: InitAnswers\n): Promise<void> => {\n  const commands = commandsFor(answers.packageManager);\n  const cd = answers.directory === \".\" ? [] : [`cd ${answers.directory}`];\n  try {\n    await eject(root);\n    // The scaffolded scripts point at the Blume CLI; the ejected app runs\n    // Astro directly (mirroring the standalone `blume eject` command).\n    await updatePackageScripts(root);\n    logger.success(\"Ejected to a standalone Astro project.\");\n    const steps = [...cd, commands.install, commands.dev];\n    logger.box(`Next steps:\\n\\n  ${steps.join(\"\\n  \")}\\n`);\n  } catch (error) {\n    // SAFETY: eject and the script rewrite throw Error instances; only the\n    // message is surfaced in the fallback hint.\n    logger.warn(\n      `Scaffolded, but eject needs the project's dependencies installed to load blume.config.ts: ${(error as Error).message}`\n    );\n    const steps = [\n      ...cd,\n      commands.install,\n      `${commands.exec} blume eject --yes`,\n    ];\n    logger.box(`Next steps:\\n\\n  ${steps.join(\"\\n  \")}\\n`);\n  }\n};\n\nexport const initCommand = defineCommand({\n  args: {\n    \"content-dir\": {\n      description: \"Content directory.\",\n      type: \"string\",\n    },\n    dir: {\n      description: \"Directory to scaffold into (default: current directory).\",\n      required: false,\n      type: \"positional\",\n    },\n    eject: {\n      description: \"Eject to a standalone Astro project after scaffolding.\",\n      type: \"boolean\",\n    },\n    \"package-manager\": {\n      description:\n        \"Package manager for the next-steps hint (npm|pnpm|yarn|bun).\",\n      type: \"string\",\n    },\n    template: {\n      description: \"Starter template: docs | api | sdk | changelog.\",\n      type: \"string\",\n    },\n    yes: {\n      description: \"Skip prompts and scaffold with defaults.\",\n      type: \"boolean\",\n    },\n  },\n  meta: commandMeta.init,\n  async run({ args }) {\n    const cwd = process.cwd();\n\n    const template = TEMPLATES.find((candidate) => candidate === args.template);\n    if (args.template !== undefined && template === undefined) {\n      logger.error(\n        `Unknown template \"${args.template}\" (use ${TEMPLATES.join(\" | \")}).`\n      );\n      process.exit(1);\n    }\n    const pm = PACKAGE_MANAGERS.find(\n      (candidate) => candidate === args[\"package-manager\"]\n    );\n    if (args[\"package-manager\"] !== undefined && pm === undefined) {\n      logger.error(\n        `Unknown package manager \"${args[\"package-manager\"]}\" (use ${PACKAGE_MANAGERS.join(\" | \")}).`\n      );\n      process.exit(1);\n    }\n\n    const interactive =\n      !args.yes &&\n      process.stdin.isTTY === true &&\n      clack.isTTY(process.stdout) &&\n      !clack.isCI();\n\n    let answers: InitAnswers;\n    if (interactive) {\n      clack.intro(\"blume init\");\n      const collected = await collectAnswers(\n        clack,\n        {\n          contentDir: args[\"content-dir\"],\n          directory: args.dir,\n          packageManager: pm,\n          template,\n        },\n        { cwd, userAgent: process.env.npm_config_user_agent }\n      );\n      if (collected === null) {\n        clack.cancel(\"Cancelled — nothing was written.\");\n        process.exit(0);\n      }\n      answers = collected;\n    } else {\n      answers = {\n        contentDir: args[\"content-dir\"] ?? \"docs\",\n        directory: args.dir ?? \".\",\n        packageManager:\n          pm ?? detectPackageManager(process.env.npm_config_user_agent),\n        sources: [\"filesystem\"],\n        template: template ?? \"docs\",\n        title: \"My Docs\",\n      };\n    }\n\n    const root = resolve(cwd, answers.directory);\n    // Interactive runs validate this inline, but an explicit --content-dir\n    // flag skips that prompt, so guard here in both modes.\n    if (validateContentDir(root, answers.contentDir) !== undefined) {\n      logger.error(\n        `Invalid --content-dir \"${answers.contentDir}\" (must be a path inside the project).`\n      );\n      process.exit(1);\n    }\n\n    const sink = interactive ? clack.log : logger;\n    const { createdPackage } = await applyPlan(buildPlan(root, answers), sink);\n\n    // Keep installed dependencies, Blume's generated runtime (`.blume/`), and\n    // build output (`dist/`) out of version control. Idempotent: creates\n    // `.gitignore` when absent and skips entries already present\n    // (trailing-slash agnostic).\n    const ignored = await ensureGitignore(root, [\n      \"node_modules/\",\n      \".blume/\",\n      \"dist/\",\n    ]);\n    if (ignored.length > 0) {\n      sink.success(`Added ${ignored.join(\", \")} to .gitignore`);\n    }\n\n    if (args.eject) {\n      await ejectScaffold(root, answers);\n      return;\n    }\n\n    const steps = nextSteps(answers, createdPackage);\n    if (interactive) {\n      clack.note(steps.trimEnd());\n      clack.outro(\"You're all set.\");\n    } else {\n      logger.box(steps);\n    }\n  },\n});\n",
+    "import { basename, resolve } from \"pathe\";\n\nimport {\n  detectPackageManager,\n  titleize,\n  validateContentDir,\n} from \"./scaffold.ts\";\nimport type {\n  InitAnswers,\n  PackageManager,\n  SourceKind,\n  Template,\n} from \"./scaffold.ts\";\n\n/** One prompt option: value plus display label and optional hint. */\ninterface PromptOption<Value> {\n  hint?: string;\n  label: string;\n  value: Value;\n}\n\n/**\n * The prompt surface `collectAnswers` needs — structurally satisfied by the\n * `@clack/prompts` module itself, and by plain fakes in tests. Every prompt\n * resolves to a cancel symbol when the user aborts.\n */\nexport interface Prompter {\n  multiselect: (opts: {\n    initialValues?: SourceKind[];\n    message: string;\n    options: PromptOption<SourceKind>[];\n    required?: boolean;\n  }) => Promise<SourceKind[] | symbol>;\n  select: (opts: {\n    message: string;\n    options: PromptOption<Template>[];\n  }) => Promise<Template | symbol>;\n  text: (opts: {\n    defaultValue?: string;\n    initialValue?: string;\n    message: string;\n    placeholder?: string;\n    validate?: (value: string | undefined) => string | undefined;\n  }) => Promise<string | symbol>;\n}\n\n/** Flag values the user passed explicitly; each one skips its question. */\nexport interface InitFlags {\n  contentDir?: string;\n  directory?: string;\n  packageManager?: PackageManager;\n  template?: Template;\n}\n\nconst cancelled = (value: string | string[] | symbol): value is symbol =>\n  typeof value === \"symbol\";\n\n/**\n * Run the interactive init flow, returning the collected answers or `null`\n * when the user cancels. All questions run before anything is written, so a\n * cancel never leaves a partial scaffold behind.\n */\nexport const collectAnswers = async (\n  prompter: Prompter,\n  flags: InitFlags,\n  defaults: { cwd: string; userAgent?: string }\n): Promise<InitAnswers | null> => {\n  const directory =\n    flags.directory ??\n    (await prompter.text({\n      defaultValue: \".\",\n      message: \"Where should we create your project?\",\n      placeholder: \"./my-docs\",\n    }));\n  if (cancelled(directory)) {\n    return null;\n  }\n\n  const root = resolve(defaults.cwd, directory);\n  const title = await prompter.text({\n    initialValue: titleize(basename(root)),\n    message: \"What's your docs site called?\",\n    validate: (value) =>\n      value?.trim() ? undefined : \"Give your docs site a name.\",\n  });\n  if (cancelled(title)) {\n    return null;\n  }\n\n  const template =\n    flags.template ??\n    (await prompter.select({\n      message: \"Which template?\",\n      options: [\n        { hint: \"Markdown docs site\", label: \"docs\", value: \"docs\" },\n        { hint: \"OpenAPI reference at /api\", label: \"api\", value: \"api\" },\n        { hint: \"SDK docs with an install page\", label: \"sdk\", value: \"sdk\" },\n        {\n          hint: \"Docs plus a changelog tab\",\n          label: \"changelog\",\n          value: \"changelog\",\n        },\n      ],\n    }));\n  if (cancelled(template)) {\n    return null;\n  }\n\n  const picked = await prompter.multiselect({\n    initialValues: [\"filesystem\"],\n    message: \"Where does your content live?\",\n    options: [\n      { hint: \"Local .mdx files\", label: \"filesystem\", value: \"filesystem\" },\n      { hint: \"An Obsidian vault\", label: \"obsidian\", value: \"obsidian\" },\n      {\n        hint: \"Changelog from GitHub Releases\",\n        label: \"github-releases\",\n        value: \"github-releases\",\n      },\n      { hint: \"A Notion database\", label: \"notion\", value: \"notion\" },\n      { hint: \"A Sanity dataset\", label: \"sanity\", value: \"sanity\" },\n      {\n        hint: \"MDX fetched from a GitHub repo\",\n        label: \"mdx-remote\",\n        value: \"mdx-remote\",\n      },\n    ],\n    required: false,\n  });\n  if (cancelled(picked)) {\n    return null;\n  }\n  // No selection desugars to the implicit local source, same as the schema.\n  const sources: SourceKind[] = picked.length === 0 ? [\"filesystem\"] : picked;\n\n  let contentDir = flags.contentDir ?? \"docs\";\n  if (flags.contentDir === undefined && sources.includes(\"filesystem\")) {\n    const answer = await prompter.text({\n      defaultValue: \"docs\",\n      message: \"Content directory?\",\n      placeholder: \"docs\",\n      validate: (value) => validateContentDir(root, value || \"docs\"),\n    });\n    if (cancelled(answer)) {\n      return null;\n    }\n    contentDir = answer;\n  }\n\n  return {\n    contentDir,\n    directory,\n    packageManager:\n      flags.packageManager ?? detectPackageManager(defaults.userAgent),\n    sources,\n    template,\n    title,\n  };\n};\n"
+  ],
+  "mappings": "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",
+  "debugId": "E1A6E93028E72EA864756E2164756E21",
+  "names": []
+}

package/dist/cli/chunk-ev67ycx0.js

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+
+// src/core/fs-atomic.ts
+import { mkdir } from "node:fs/promises";
+import { dirname } from "pathe";
+import writeFileAtomic from "write-file-atomic";
+var writeTextAtomic = async (path, text) => {
+  await mkdir(dirname(path), { recursive: true });
+  await writeFileAtomic(path, text, { encoding: "utf-8", fsync: false });
+};
+
+export { writeTextAtomic };
+
+//# debugId=33DFD366D208CE0864756E2164756E21
+//# sourceMappingURL=chunk-ev67ycx0.js.map

package/dist/cli/chunk-ev67ycx0.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/core/fs-atomic.ts"],
+  "sourcesContent": [
+    "import { mkdir } from \"node:fs/promises\";\n\nimport { dirname } from \"pathe\";\nimport writeFileAtomic from \"write-file-atomic\";\n\n/**\n * Write text to `path` atomically (unique temp file + rename) after ensuring\n * the parent directory exists, so a concurrent reader or file watcher never\n * observes a missing or half-written file. write-file-atomic's temp names are\n * unique per call — a pid-suffixed temp name is not, and two concurrent\n * writers to the same target in one process (translate lanes, staged-content\n * writes) would interleave through a shared temp file. `fsync` is off to\n * match the previous behavior: the point is watcher atomicity, not crash\n * durability, and a per-file fsync would slow dev regeneration.\n */\nexport const writeTextAtomic = async (\n  path: string,\n  text: string\n): Promise<void> => {\n  await mkdir(dirname(path), { recursive: true });\n  await writeFileAtomic(path, text, { encoding: \"utf-8\", fsync: false });\n};\n"
+  ],
+  "mappings": ";;;AAAA;AAEA;AACA;AAYO,IAAM,kBAAkB,OAC7B,MACA,SACkB;AAAA,EAClB,MAAM,MAAM,QAAQ,IAAI,GAAG,EAAE,WAAW,KAAK,CAAC;AAAA,EAC9C,MAAM,gBAAgB,MAAM,MAAM,EAAE,UAAU,SAAS,OAAO,MAAM,CAAC;AAAA;",
+  "debugId": "33DFD366D208CE0864756E2164756E21",
+  "names": []
+}