blume 1.6.5 → 1.6.6

package/dist/cli/chunk-ag1zyr5x.js

@@ -0,0 +1,176 @@
+#!/usr/bin/env node
+import {
+  parsePort
+} from "./chunk-x66c5yjn.js";
+import {
+  normalizeHost
+} from "./chunk-bcy492zc.js";
+import {
+  prepareProject
+} from "./chunk-nyqzjdhj.js";
+import"./chunk-9sh49q0h.js";
+import"./chunk-btfr9yvw.js";
+import {
+  DevLockHeldError,
+  acquireDevLock,
+  describeDevLock,
+  updateDevLockPort
+} from "./chunk-tc89yh2r.js";
+import {
+  generateRuntime,
+  refreshBlumeContent,
+  showBlumeErrorOverlay
+} from "./chunk-62qsssnh.js";
+import"./chunk-n4qjabmt.js";
+import"./chunk-pxj10x8y.js";
+import"./chunk-sbdqrjbb.js";
+import"./chunk-5yvt556e.js";
+import"./chunk-ev67ycx0.js";
+import"./chunk-vt8fgygt.js";
+import"./chunk-3r94j3tc.js";
+import"./chunk-aerwpe14.js";
+import"./chunk-3k0kzs6d.js";
+import"./chunk-vxv4x1n8.js";
+import"./chunk-wd27zjcz.js";
+import {
+  scanProject
+} from "./chunk-etsqspj6.js";
+import {
+  resolveRuntimeDir
+} from "./chunk-vv3f8mb6.js";
+import"./chunk-27gtm2ym.js";
+import"./chunk-4xyggvgf.js";
+import"./chunk-6kzzpsx8.js";
+import {
+  logger,
+  reportDiagnostics
+} from "./chunk-ey89bjj1.js";
+import {
+  commandMeta
+} from "./chunk-2aj8ddew.js";
+
+// src/cli/commands/dev.ts
+import { dev } from "astro";
+import { watch } from "chokidar";
+import { defineCommand } from "citty";
+import { debounce } from "perfect-debounce";
+var routeSignature = (routes) => routes.map((route) => `${route.path} ${route.entryId}`).toSorted().join(`
+`);
+var devCommand = defineCommand({
+  args: {
+    "content-dir": {
+      description: "Content folder to scan, overriding config (content.root).",
+      type: "string"
+    },
+    debug: {
+      description: "Verbose Astro/Vite logging for troubleshooting.",
+      type: "boolean"
+    },
+    host: { description: "Network host to bind.", type: "string" },
+    open: { description: "Open the browser on start.", type: "boolean" },
+    port: { description: "Port to listen on.", type: "string" },
+    preview: {
+      description: "Include drafts and unpublished CMS content.",
+      type: "boolean"
+    },
+    strict: { description: "Fail on diagnostics.", type: "boolean" }
+  },
+  meta: commandMeta.dev,
+  async run({ args }) {
+    const root = process.cwd();
+    const preview = args.preview ?? false;
+    const overrides = args["content-dir"] ? { contentRoot: args["content-dir"] } : undefined;
+    const explicitPort = parsePort(args.port);
+    const port = explicitPort ?? 4321;
+    let devServerUrl = `http://localhost:${port}`;
+    const outDir = resolveRuntimeDir(root);
+    let releaseLock;
+    try {
+      releaseLock = acquireDevLock(outDir, port);
+    } catch (error) {
+      if (error instanceof DevLockHeldError) {
+        logger.error(`A \`blume dev\` server is already running${describeDevLock(error.lock)} in this project. Reuse that server instead of starting a second one — two dev servers would corrupt the shared .blume dir. If it crashed, delete .blume/dev.lock.`);
+        process.exit(1);
+      }
+      throw error;
+    }
+    process.on("exit", releaseLock);
+    const project = await prepareProject({
+      devServerUrl,
+      mode: "dev",
+      overrides,
+      preview,
+      root,
+      strict: args.strict
+    });
+    const createServer = (listenPort, open) => dev({
+      logLevel: args.debug ? "debug" : "info",
+      root: project.context.outDir,
+      server: { host: normalizeHost(args.host), open, port: listenPort }
+    });
+    let server = await createServer(explicitPort, args.open ?? false);
+    const boundPort = server.address.port;
+    if (boundPort !== port) {
+      updateDevLockPort(outDir, boundPort);
+      devServerUrl = `http://localhost:${boundPort}`;
+    }
+    showBlumeErrorOverlay(project.diagnostics);
+    let lastSignature = routeSignature(project.manifest.routes);
+    const regenerate = debounce(async () => {
+      try {
+        const next = await scanProject(root, {
+          devServerUrl,
+          mode: "dev",
+          overrides,
+          preview
+        });
+        const nextSignature = routeSignature(next.manifest.routes);
+        const structural = nextSignature !== lastSignature;
+        await generateRuntime(next);
+        if (structural && !await refreshBlumeContent()) {
+          await server.stop();
+          server = await createServer(boundPort, false);
+        }
+        lastSignature = nextSignature;
+        reportDiagnostics(next.diagnostics, root);
+        showBlumeErrorOverlay(next.diagnostics);
+      } catch (error) {
+        logger.error(`Regeneration failed: ${error.message}`);
+      }
+    }, 80);
+    if (boundPort !== port) {
+      regenerate();
+    }
+    const dirTargets = [project.context.pagesRoot].filter((target) => target !== null);
+    const fileTargets = [
+      project.context.configFile,
+      project.context.themeFile,
+      project.context.componentsFile
+    ].filter((target) => target !== null);
+    const projectWatcher = watch([...dirTargets, ...fileTargets], {
+      ignoreInitial: true
+    }).on("all", regenerate);
+    const disposers = [
+      ...project.sources.map((source) => source.watch?.(regenerate)),
+      () => {
+        projectWatcher.close();
+      }
+    ].filter((dispose) => dispose !== undefined);
+    const shutdown = async () => {
+      for (const dispose of disposers) {
+        dispose();
+      }
+      releaseLock();
+      await server.stop();
+      process.exit(0);
+    };
+    process.on("SIGINT", shutdown);
+    process.on("SIGTERM", shutdown);
+  }
+});
+export {
+  devCommand
+};
+
+//# debugId=EE16C622AD2E2BB164756E2164756E21
+//# sourceMappingURL=chunk-ag1zyr5x.js.map

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

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/cli/commands/dev.ts"],
+  "sourcesContent": [
+    "import { dev } from \"astro\";\nimport { watch } from \"chokidar\";\nimport { defineCommand } from \"citty\";\nimport { debounce } from \"perfect-debounce\";\n\nimport { generateRuntime } from \"../../astro/generate.ts\";\nimport {\n  refreshBlumeContent,\n  showBlumeErrorOverlay,\n} from \"../../astro/integration.ts\";\nimport { scanProject } from \"../../core/project-graph.ts\";\nimport { resolveRuntimeDir } from \"../../core/project.ts\";\nimport { parsePort } from \"../args.ts\";\nimport { commandMeta } from \"../command-meta.ts\";\nimport {\n  acquireDevLock,\n  describeDevLock,\n  DevLockHeldError,\n  updateDevLockPort,\n} from \"../dev-lock.ts\";\nimport { normalizeHost } from \"../host-args.ts\";\nimport { logger, reportDiagnostics } from \"../log.ts\";\nimport { prepareProject } from \"../prepare.ts\";\n\n/**\n * A fingerprint of the route set: the sorted `path entryId` pairs. It changes\n * when a page is added, removed, or renamed (a folder rename shifts many at\n * once) but stays equal across pure body edits — so the dev loop can tell a\n * \"structural\" change (needs a content re-sync) from a hot-reloadable one.\n */\nconst routeSignature = (\n  routes: readonly { entryId: string; path: string }[]\n): string =>\n  routes\n    .map((route) => `${route.path} ${route.entryId}`)\n    .toSorted()\n    .join(\"\\n\");\n\nexport const devCommand = defineCommand({\n  args: {\n    \"content-dir\": {\n      description: \"Content folder to scan, overriding config (content.root).\",\n      type: \"string\",\n    },\n    debug: {\n      description: \"Verbose Astro/Vite logging for troubleshooting.\",\n      type: \"boolean\",\n    },\n    host: { description: \"Network host to bind.\", type: \"string\" },\n    open: { description: \"Open the browser on start.\", type: \"boolean\" },\n    port: { description: \"Port to listen on.\", type: \"string\" },\n    preview: {\n      description: \"Include drafts and unpublished CMS content.\",\n      type: \"boolean\",\n    },\n    strict: { description: \"Fail on diagnostics.\", type: \"boolean\" },\n  },\n  meta: commandMeta.dev,\n  async run({ args }) {\n    const root = process.cwd();\n    const preview = args.preview ?? false;\n    const overrides = args[\"content-dir\"]\n      ? { contentRoot: args[\"content-dir\"] }\n      : undefined;\n    // Astro's dev server defaults to 4321 when no port is passed. Feeding the\n    // resolved URL in as the `deployment.site` fallback lets site-gated features\n    // (OG images, canonicals, sitemap) work locally without configuring a site.\n    const explicitPort = parsePort(args.port);\n    const port = explicitPort ?? 4321;\n    let devServerUrl = `http://localhost:${port}`;\n\n    // Claim the shared `.blume` dir BEFORE preparing: `prepareProject`\n    // regenerates the runtime, so even a refused second dev server would\n    // otherwise clobber the running one's generated tree (with this\n    // invocation's port baked in) on its way out. The claim is atomic, so two\n    // simultaneous starts can't both win. Dev never relocates the runtime dir,\n    // so the lock always lives at `<root>/.blume`.\n    const outDir = resolveRuntimeDir(root);\n    let releaseLock: () => void;\n    try {\n      releaseLock = acquireDevLock(outDir, port);\n    } catch (error) {\n      if (error instanceof DevLockHeldError) {\n        logger.error(\n          `A \\`blume dev\\` server is already running${describeDevLock(error.lock)} in this project. Reuse that server instead of starting a second one — two dev servers would corrupt the shared .blume dir. If it crashed, delete .blume/dev.lock.`\n        );\n        process.exit(1);\n      }\n      throw error;\n    }\n    process.on(\"exit\", releaseLock);\n\n    const project = await prepareProject({\n      devServerUrl,\n      mode: \"dev\",\n      overrides,\n      preview,\n      root,\n      strict: args.strict,\n    });\n\n    // A factory so the regenerate loop can recreate the server when a\n    // structural (route-set) change can't be re-synced in place (see below).\n    // `open` is honored on first boot only — a restart must not reopen the\n    // browser.\n    const createServer = (listenPort: number | undefined, open: boolean) =>\n      dev({\n        logLevel: args.debug ? \"debug\" : \"info\",\n        root: project.context.outDir,\n        server: { host: normalizeHost(args.host), open, port: listenPort },\n      });\n\n    let server = await createServer(explicitPort, args.open ?? false);\n\n    // Vite bumps to the next free port when the default is taken, so record\n    // the port the server actually bound — the lock's URL is what a refused\n    // second invocation tells its caller to reuse. The site fallback baked\n    // into the runtime also carries the port, so it must follow suit (below,\n    // once the regeneration closure exists).\n    const boundPort = server.address.port;\n    if (boundPort !== port) {\n      updateDevLockPort(outDir, boundPort);\n      devServerUrl = `http://localhost:${boundPort}`;\n    }\n\n    // Mirror any initial diagnostics into the browser overlay now the server\n    // (and its HMR channel) is up.\n    showBlumeErrorOverlay(project.diagnostics);\n\n    let lastSignature = routeSignature(project.manifest.routes);\n\n    // Watch user inputs and regenerate the runtime data on change. A body edit\n    // hot-reloads via Vite (fast path). A route-set change also needs Astro's\n    // content store re-synced: its glob watcher misses directory renames, so a\n    // renamed page would 404 (`getEntry` reads a stale store). Astro hands the\n    // integration `refreshContent` for exactly that — a full loader run\n    // against the live server, after which Astro's own store watcher clears\n    // the route cache and reloads the browser. Only a server that registered\n    // no refresh (none since Astro 5) falls back to a cold restart: stop,\n    // then bring up a fresh container whose cold sync re-globs everything.\n    // perfect-debounce both debounces the watch burst (80ms) and\n    // single-flights the scan: a\n    // trigger during a run never starts a second run, only marks one trailing\n    // rerun after the current settles. Both halves are load-bearing — a plain\n    // debounce once let bursts stack overlapping scans until the heap was\n    // exhausted (observed as an OOM after minutes of looping). The contract is\n    // pinned by test/dev-debounce.test.ts. The task must not reject (the\n    // library re-invokes it from an unhandled .finally), so the body catches\n    // its own errors and always resolves.\n    const regenerate = debounce(async () => {\n      try {\n        const next = await scanProject(root, {\n          devServerUrl,\n          mode: \"dev\",\n          overrides,\n          preview,\n        });\n        const nextSignature = routeSignature(next.manifest.routes);\n        const structural = nextSignature !== lastSignature;\n        // Generate first: the new runtime data (and any staged remote content)\n        // is on disk and published before the store re-syncs against it.\n        await generateRuntime(next);\n        if (structural && !(await refreshBlumeContent())) {\n          await server.stop();\n          server = await createServer(boundPort, false);\n        }\n        // Commit the signature only after the (re)generation succeeded. If the\n        // re-sync or restart above throws mid-sequence, the signature stays\n        // stale so the next watch event retries the structural path.\n        lastSignature = nextSignature;\n        // Surface any content/config errors in the terminal AND the browser\n        // overlay. The terminal report is not redundant: the overlay only\n        // shows once the browser has connected, and it clears on the next HMR\n        // update.\n        reportDiagnostics(next.diagnostics, root);\n        showBlumeErrorOverlay(next.diagnostics);\n      } catch (error) {\n        // SAFETY: regeneration failures come from the generator and Astro's\n        // server API, which raise Error instances; only the message is shown.\n        logger.error(`Regeneration failed: ${(error as Error).message}`);\n      }\n    }, 80);\n\n    // The runtime prepared above baked the *requested* port into the site\n    // fallback; if Vite bumped it, regenerate so OG images, canonicals, and\n    // other site-gated URLs point at the port actually serving.\n    if (boundPort !== port) {\n      void regenerate();\n    }\n\n    // Content is watched per source (filesystem uses fs.watch; remote sources\n    // are frozen for the session). The remaining project inputs — user pages,\n    // config, theme, and component overrides — are watched directly.\n    const dirTargets = [project.context.pagesRoot].filter(\n      (target) => target !== null\n    );\n    const fileTargets = [\n      project.context.configFile,\n      project.context.themeFile,\n      project.context.componentsFile,\n    ].filter((target) => target !== null);\n\n    // chokidar handles what raw fs.watch made us hand-roll: recursive\n    // directory watching on every platform, and single files surviving a\n    // rename-replace save (vim and most \"atomic save\" editors), which orphans\n    // an inode-tracking fs.watch watcher after the first write.\n    const projectWatcher = watch([...dirTargets, ...fileTargets], {\n      ignoreInitial: true,\n    }).on(\"all\", regenerate);\n    const disposers = [\n      ...project.sources.map((source) => source.watch?.(regenerate)),\n      () => {\n        void projectWatcher.close();\n      },\n    ].filter((dispose) => dispose !== undefined);\n\n    const shutdown = async () => {\n      for (const dispose of disposers) {\n        dispose();\n      }\n      releaseLock();\n      await server.stop();\n      process.exit(0);\n    };\n\n    process.on(\"SIGINT\", shutdown);\n    process.on(\"SIGTERM\", shutdown);\n  },\n});\n"
+  ],
+  "mappings": "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",
+  "debugId": "EE16C622AD2E2BB164756E2164756E21",
+  "names": []
+}

package/dist/cli/chunk-bawgnt8x.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-etsqspj6.js";
+import {
+  VERSION_ID,
+  loadConfig
+} from "./chunk-vv3f8mb6.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-bawgnt8x.js.map

package/dist/cli/chunk-bawgnt8x.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-bcy492zc.js

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+
+// src/cli/host-args.ts
+var normalizeHostArgs = (rawArgs) => rawArgs.map((arg, index) => {
+  if (arg !== "--host") {
+    return arg;
+  }
+  const next = rawArgs[index + 1];
+  return next === undefined || next.startsWith("-") ? "--host=" : arg;
+});
+var normalizeHost = (host) => host === "" ? true : host ?? false;
+
+export { normalizeHostArgs, normalizeHost };
+
+//# debugId=CBDF4CDAEA11C19764756E2164756E21
+//# sourceMappingURL=chunk-bcy492zc.js.map

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

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/cli/host-args.ts"],
+  "sourcesContent": [
+    "/**\n * Rewrite a bare `--host` in the raw argv to `--host=` before citty parses it.\n *\n * `host` is a string arg (citty has no mixed string/boolean type), and citty\n * 0.2 parses with `node:util.parseArgs`, where a string option consumes the\n * next token as its value even when that token is another flag: `blume dev\n * --host --open` would bind the literal hostname \"--open\" and drop `--open`.\n * The `--host=` spelling parses as `\"\"` without touching its neighbor, which\n * `normalizeHost` then maps to Astro's \"bind all interfaces\".\n */\nexport const normalizeHostArgs = (rawArgs: readonly string[]): string[] =>\n  rawArgs.map((arg, index) => {\n    if (arg !== \"--host\") {\n      return arg;\n    }\n    const next = rawArgs[index + 1];\n    return next === undefined || next.startsWith(\"-\") ? \"--host=\" : arg;\n  });\n\n/**\n * Resolve a `--host` flag value into what Astro/Vite's `server.host` expects.\n * citty has no mixed string/boolean arg type, so `host` is declared as a\n * string and a bare `--host` parses as `\"\"` (`normalizeHostArgs` rewrites it\n * to `--host=` first) — Node would bind all interfaces for `\"\"`, but Vite's\n * `resolveHostname` treats it as a literal hostname and prints malformed URLs\n * like `http://:4321/`. Match Astro's own `--host` semantics instead: bare\n * flag → `true` (bind all interfaces), `--host 10.0.0.1` → that address,\n * absent → `false` (localhost only).\n *\n * Lives beside `normalizeHostArgs` rather than in `commands/dev.ts` so\n * `preview` can share it without importing the whole dev command graph.\n */\nexport const normalizeHost = (host?: string): boolean | string =>\n  host === \"\" ? true : (host ?? false);\n"
+  ],
+  "mappings": ";;;AAUO,IAAM,oBAAoB,CAAC,YAChC,QAAQ,IAAI,CAAC,KAAK,UAAU;AAAA,EAC1B,IAAI,QAAQ,UAAU;AAAA,IACpB,OAAO;AAAA,EACT;AAAA,EACA,MAAM,OAAO,QAAQ,QAAQ;AAAA,EAC7B,OAAO,SAAS,aAAa,KAAK,WAAW,GAAG,IAAI,YAAY;AAAA,CACjE;AAeI,IAAM,gBAAgB,CAAC,SAC5B,SAAS,KAAK,OAAQ,QAAQ;",
+  "debugId": "CBDF4CDAEA11C19764756E2164756E21",
+  "names": []
+}

package/dist/cli/chunk-btfr9yvw.js

@@ -0,0 +1,41 @@
+#!/usr/bin/env node
+import {
+  getBlumeVersion
+} from "./chunk-4xyggvgf.js";
+
+// src/cli/internal-error.ts
+import { colors } from "consola/utils";
+var ISSUES_URL = "https://github.com/haydenbleasel/blume/issues";
+var BLUME_FRAME = /(?<abs>(?:\/[^\s()]*\/|[A-Za-z]:\\[^\s()]*\\)\.blume[/\\][^\s()]*)/gu;
+var BLUME_MARKER = /[/\\]\.blume[/\\]/u;
+var remapBlumeStack = (stack) => stack.replaceAll(BLUME_FRAME, (match) => {
+  const marker = match.search(BLUME_MARKER);
+  return `${match.slice(marker + 1)} (generated)`;
+});
+var reportInternalError = (error) => {
+  const err = error instanceof Error ? error : new Error(String(error));
+  const lines = [
+    `${colors.red(colors.bold("BLUME_INTERNAL"))} An unexpected error occurred.`,
+    `  ${err.message}`
+  ];
+  const stack = remapBlumeStack(err.stack ?? "").split(`
+`).slice(1, 5).map((line) => line.trim()).filter(Boolean);
+  if (stack.length > 0) {
+    lines.push("", colors.dim(stack.join(`
+`)));
+  }
+  lines.push("", "This is likely a bug in Blume. Please report it with the details below:", colors.dim([
+    `  Blume:    ${getBlumeVersion()}`,
+    `  Node:     ${process.version}`,
+    `  Platform: ${process.platform} ${process.arch}`
+  ].join(`
+`)), `  ${ISSUES_URL}`);
+  process.stderr.write(`${lines.join(`
+`)}
+`);
+};
+
+export { reportInternalError };
+
+//# debugId=D59E08D04AAEFF1964756E2164756E21
+//# sourceMappingURL=chunk-btfr9yvw.js.map

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

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/cli/internal-error.ts"],
+  "sourcesContent": [
+    "import { colors } from \"consola/utils\";\n\nimport { getBlumeVersion } from \"../core/version.ts\";\n\nconst ISSUES_URL = \"https://github.com/haydenbleasel/blume/issues\";\n\n// Absolute paths into the hidden generated runtime — POSIX (`…/.blume/…`) or\n// Windows drive-letter (`C:\\…\\.blume\\…`) — including any trailing `:line:col`,\n// stopping at whitespace or a closing paren.\nconst BLUME_FRAME =\n  /(?<abs>(?:\\/[^\\s()]*\\/|[A-Za-z]:\\\\[^\\s()]*\\\\)\\.blume[/\\\\][^\\s()]*)/gu;\n\n// The separator immediately before `.blume/` (or `.blume\\`) in a matched path.\nconst BLUME_MARKER = /[/\\\\]\\.blume[/\\\\]/u;\n\n/**\n * Rewrite `.blume/` frames in a stack so the generated runtime reads clearly:\n * the machine-absolute prefix is dropped to a project-relative `.blume/…` path\n * and tagged `(generated)`, keeping the reader oriented instead of staring at a\n * long path into a hidden directory. Frames in the user's own source (custom\n * pages keep their real location; wrappers import user files by their real path)\n * are untouched, so the actionable frame stays intact.\n */\nexport const remapBlumeStack = (stack: string): string =>\n  stack.replaceAll(BLUME_FRAME, (match) => {\n    const marker = match.search(BLUME_MARKER);\n    return `${match.slice(marker + 1)} (generated)`;\n  });\n\n/**\n * Print an unexpected (non-{@link BlumeError}) failure in a stable, reportable\n * shape instead of a bare stack trace: a fixed `BLUME_INTERNAL` code, the\n * message, a trimmed stack, and an environment dump for bug reports. Callers\n * exit after this — it doesn't exit itself, so it's testable.\n */\n// oxlint-disable-next-line anti-slop/no-unknown-parameters -- last-resort handler for whatever a catch clause caught; anything narrower would force casts at every call site\nexport const reportInternalError = (error: unknown): void => {\n  const err = error instanceof Error ? error : new Error(String(error));\n  const lines = [\n    `${colors.red(colors.bold(\"BLUME_INTERNAL\"))} An unexpected error occurred.`,\n    `  ${err.message}`,\n  ];\n\n  // A few frames are enough to locate the fault without burying the report;\n  // `.blume/` frames are relativized so the hidden runtime reads clearly.\n  const stack = remapBlumeStack(err.stack ?? \"\")\n    .split(\"\\n\")\n    .slice(1, 5)\n    .map((line) => line.trim())\n    .filter(Boolean);\n  if (stack.length > 0) {\n    lines.push(\"\", colors.dim(stack.join(\"\\n\")));\n  }\n\n  lines.push(\n    \"\",\n    \"This is likely a bug in Blume. Please report it with the details below:\",\n    colors.dim(\n      [\n        `  Blume:    ${getBlumeVersion()}`,\n        `  Node:     ${process.version}`,\n        `  Platform: ${process.platform} ${process.arch}`,\n      ].join(\"\\n\")\n    ),\n    `  ${ISSUES_URL}`\n  );\n\n  process.stderr.write(`${lines.join(\"\\n\")}\\n`);\n};\n"
+  ],
+  "mappings": ";;;;;;AAAA;AAIA,IAAM,aAAa;AAKnB,IAAM,cACJ;AAGF,IAAM,eAAe;AAUd,IAAM,kBAAkB,CAAC,UAC9B,MAAM,WAAW,aAAa,CAAC,UAAU;AAAA,EACvC,MAAM,SAAS,MAAM,OAAO,YAAY;AAAA,EACxC,OAAO,GAAG,MAAM,MAAM,SAAS,CAAC;AAAA,CACjC;AASI,IAAM,sBAAsB,CAAC,UAAyB;AAAA,EAC3D,MAAM,MAAM,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,OAAO,KAAK,CAAC;AAAA,EACpE,MAAM,QAAQ;AAAA,IACZ,GAAG,OAAO,IAAI,OAAO,KAAK,gBAAgB,CAAC;AAAA,IAC3C,KAAK,IAAI;AAAA,EACX;AAAA,EAIA,MAAM,QAAQ,gBAAgB,IAAI,SAAS,EAAE,EAC1C,MAAM;AAAA,CAAI,EACV,MAAM,GAAG,CAAC,EACV,IAAI,CAAC,SAAS,KAAK,KAAK,CAAC,EACzB,OAAO,OAAO;AAAA,EACjB,IAAI,MAAM,SAAS,GAAG;AAAA,IACpB,MAAM,KAAK,IAAI,OAAO,IAAI,MAAM,KAAK;AAAA,CAAI,CAAC,CAAC;AAAA,EAC7C;AAAA,EAEA,MAAM,KACJ,IACA,2EACA,OAAO,IACL;AAAA,IACE,eAAe,gBAAgB;AAAA,IAC/B,eAAe,QAAQ;AAAA,IACvB,eAAe,QAAQ,YAAY,QAAQ;AAAA,EAC7C,EAAE,KAAK;AAAA,CAAI,CACb,GACA,KAAK,YACP;AAAA,EAEA,QAAQ,OAAO,MAAM,GAAG,MAAM,KAAK;AAAA,CAAI;AAAA,CAAK;AAAA;",
+  "debugId": "D59E08D04AAEFF1964756E2164756E21",
+  "names": []
+}