blume 0.5.1 → 0.5.2

package/dist/cli/index.js

@@ -2917,7 +2917,7 @@ import {
 } from "node:fs/promises";
 import { createRequire as createRequire5 } from "node:module";
 import { pathToFileURL as pathToFileURL2 } from "node:url";
-import { basename as basename2, dirname as dirname7, join as join17, normalize as normalize3, relative as relative6 } from "pathe";
+import { basename as basename2, dirname as dirname7, join as join17, normalize as normalize3, relative as relative7 } from "pathe";
 import { glob as glob4 } from "tinyglobby";
 
 // src/ai/ask-data.ts
@@ -4019,11 +4019,11 @@ var hasScalarReferences = (config) => resolveReferences(config).some((ref) => re
 
 // src/openapi/scalar.ts
 import { readFile as readFile5 } from "node:fs/promises";
-import { isAbsolute as isAbsolute4, join as join12 } from "pathe";
+import { isAbsolute as isAbsolute5, join as join12 } from "pathe";
 
 // src/astro/templates.ts
 import { existsSync as existsSync8, readFileSync as readFileSync4 } from "node:fs";
-import { dirname as dirname6, join as join11 } from "pathe";
+import { dirname as dirname6, isAbsolute as isAbsolute4, join as join11, relative as relative4 } from "pathe";
 
 // src/core/assets.ts
 import { join as join10 } from "pathe";
@@ -4396,10 +4396,15 @@ var stagedContentDir = (outDir) => join11(outDir, "content");
 var contentConfigTemplate = (options) => {
   const { context, config } = options;
   const stagedBase = options.stagedBase ?? stagedContentDir(context.outDir);
-  const docsPattern = [
+  const outDirRel = relative4(context.contentRoot, context.outDir);
+  const outDirIgnore = outDirRel && !outDirRel.startsWith("..") && !isAbsolute4(outDirRel) ? [`!${outDirRel}/**`] : [];
+  const filesystem = options.filesystem ?? true;
+  const docsPattern = filesystem ? [
     ...config.content.include,
-    ...(config.content.exclude ?? []).map((pattern) => `!${pattern}`)
-  ];
+    ...(config.content.exclude ?? []).map((pattern) => `!${pattern}`),
+    "!**/node_modules/**",
+    ...outDirIgnore
+  ] : [];
   const stagedBlock = options.staged ? `
 const staged = defineCollection({
   loader: glob({
@@ -5404,7 +5409,7 @@ var specConfiguration = async (spec, root) => {
   if (URL_SPEC.test(spec)) {
     return { config: { url: spec } };
   }
-  const absolute = isAbsolute4(spec) ? spec : join12(root, spec);
+  const absolute = isAbsolute5(spec) ? spec : join12(root, spec);
   try {
     return { config: { content: await readFile5(absolute, "utf-8") } };
   } catch {
@@ -5607,7 +5612,7 @@ var extractOperations = (document, baseRoute) => {
 // src/openapi/parse.ts
 import { readFile as readFile7 } from "node:fs/promises";
 import { normalize as normalize2, upgrade } from "@scalar/openapi-parser";
-import { isAbsolute as isAbsolute5, join as join14 } from "pathe";
+import { isAbsolute as isAbsolute6, join as join14 } from "pathe";
 var URL_SPEC2 = /^https?:\/\//u;
 var readSpecText = async (spec, root) => {
   if (URL_SPEC2.test(spec)) {
@@ -5617,7 +5622,7 @@ var readSpecText = async (spec, root) => {
     }
     return await response.text();
   }
-  const absolute = isAbsolute5(spec) ? spec : join14(root, spec);
+  const absolute = isAbsolute6(spec) ? spec : join14(root, spec);
   return await readFile7(absolute, "utf-8");
 };
 var parseSpec = async (spec, root) => {
@@ -6523,7 +6528,7 @@ export const layoutOverrides = { ...(overrides.layout ?? {})${layoutEntries.leng
 
 // src/astro/examples.ts
 import { readFile as readFile9 } from "node:fs/promises";
-import { join as join16, relative as relative4 } from "pathe";
+import { join as join16, relative as relative5 } from "pathe";
 import { glob as glob2 } from "tinyglobby";
 
 // src/astro/islands.ts
@@ -6637,7 +6642,7 @@ var discoverExamples = async (root, pattern = "examples") => {
     if (!(ext && framework)) {
       continue;
     }
-    const path = relative4(dir, file).slice(0, -(ext.length + 1));
+    const path = relative5(dir, file).slice(0, -(ext.length + 1));
     const existing = seen.get(path);
     if (existing) {
       warnings.push(`Two examples both resolve to "${path}" ("${existing}" and "${file}"); ignoring the second. Give them distinct paths.`);
@@ -6658,7 +6663,7 @@ var discoverExamples = async (root, pattern = "examples") => {
 };
 
 // src/astro/pages.ts
-import { extname as extname2, relative as relative5 } from "pathe";
+import { extname as extname2, relative as relative6 } from "pathe";
 import { glob as glob3 } from "tinyglobby";
 var discoverPages = async (pagesRoot) => {
   const files = await glob3(["**/*.astro"], {
@@ -6668,7 +6673,7 @@ var discoverPages = async (pagesRoot) => {
   });
   files.sort();
   return files.map((file) => {
-    const rel = relative5(pagesRoot, file);
+    const rel = relative6(pagesRoot, file);
     const withoutExt = rel.slice(0, rel.length - extname2(rel).length);
     const parts = withoutExt.split("/");
     if (parts.at(-1) === "index") {
@@ -6942,7 +6947,7 @@ var buildRuntimeData = (project) => {
     if (!(editBase && sourcePath)) {
       return null;
     }
-    const rel = relative6(context.root, sourcePath).split("\\").join("/");
+    const rel = relative7(context.root, sourcePath).split("\\").join("/");
     return `${editBase}/${github?.dir ? `${github.dir}/${rel}` : rel}`;
   };
   const { i18n } = config;
@@ -7166,6 +7171,7 @@ var generateRuntime = async (project) => {
   pages.push(...mcp.discoveryPages);
   const staged = collectStaged(project);
   const hasStaged = staged.size > 0;
+  const hasFilesystemSource = project.sources.some((source) => !source.staged);
   const structural = await Promise.all([
     write(join17(out, "astro.config.mjs"), astroConfigTemplate({
       aliases: resolveTsconfigAliases(context.root),
@@ -7185,7 +7191,12 @@ var generateRuntime = async (project) => {
     write(join17(out, "package.json"), runtimePackageTemplate(runtimeDependencies({ config, needsReact, needsSvelte, needsVue }))),
     write(join17(out, "tsconfig.json"), runtimeTsconfigTemplate()),
     write(join17(srcDir, "env.d.ts"), envTemplate()),
-    write(join17(srcDir, "content.config.ts"), contentConfigTemplate({ config, context, staged: hasStaged })),
+    write(join17(srcDir, "content.config.ts"), contentConfigTemplate({
+      config,
+      context,
+      filesystem: hasFilesystemSource,
+      staged: hasStaged
+    })),
     write(join17(srcDir, "pages", "[...slug].astro"), catchAllPageTemplate({
       askEnabled,
       exportEpub,
@@ -7339,7 +7350,7 @@ var assetSegments = (config) => {
 
 // src/migrate/mintlify/config.ts
 import { readFile as readFile11 } from "node:fs/promises";
-import { dirname as dirname8, relative as relative7, resolve as resolve5 } from "pathe";
+import { dirname as dirname8, relative as relative8, resolve as resolve5 } from "pathe";
 var MINTLIFY_DEFAULT_IGNORES = [
   "**/_*",
   "**/.*",
@@ -7375,7 +7386,7 @@ var asDirectoryMode = (value) => value === "accordion" || value === "card" || va
 var withoutUndefined = (value) => Object.fromEntries(Object.entries(value).filter(([, item]) => item !== undefined));
 var hasOwn = (object, key) => Object.hasOwn(object, key);
 var isInsideRoot = (root, candidate) => {
-  const rel = relative7(root, candidate);
+  const rel = relative8(root, candidate);
   return rel === "" || !rel.startsWith("..") && !rel.startsWith("/");
 };
 var readJsonFile = async (file) => {
@@ -9065,7 +9076,7 @@ var buildContentGraph = (pages, options) => {
 
 // src/core/last-modified.ts
 import { execFileSync } from "node:child_process";
-import { relative as relative8 } from "pathe";
+import { relative as relative9 } from "pathe";
 var resolveLastModifiedConfig = (value) => {
   if (value === false) {
     return { enabled: false, source: "git" };
@@ -9105,7 +9116,7 @@ var gitLastModifiedTimes = (root, contentRoot, sourcePaths) => {
     const byRepoPath = parseGitLog(output);
     const result = new Map;
     for (const sourcePath of sourcePaths) {
-      const iso = byRepoPath.get(relative8(gitRoot, sourcePath));
+      const iso = byRepoPath.get(relative9(gitRoot, sourcePath));
       if (iso) {
         result.set(sourcePath, iso);
       }
@@ -9117,7 +9128,7 @@ var gitLastModifiedTimes = (root, contentRoot, sourcePaths) => {
 };
 
 // src/core/meta.ts
-import { basename as basename3, dirname as dirname9, relative as relative9 } from "pathe";
+import { basename as basename3, dirname as dirname9, relative as relative10 } from "pathe";
 import { glob as glob5 } from "tinyglobby";
 var META_FILES = [
   "**/meta.ts",
@@ -9147,7 +9158,7 @@ var discoverFolderMeta = async (contentRoot) => {
   const shared = new Map;
   const diagnostics = [];
   for (const entry of loaded) {
-    const dir = relative9(contentRoot, dirname9(entry.file));
+    const dir = relative10(contentRoot, dirname9(entry.file));
     if (!entry.ok) {
       diagnostics.push({
         code: "BLUME_META_LOAD_FAILED",
@@ -9352,10 +9363,10 @@ import { join as join26 } from "pathe";
 // src/core/sources/filesystem.ts
 import { existsSync as existsSync13, watch as fsWatch } from "node:fs";
 import { readFile as readFile13 } from "node:fs/promises";
-import { extname as extname5, isAbsolute as isAbsolute6, join as join19, relative as relative10, resolve as resolve6 } from "pathe";
+import { extname as extname5, isAbsolute as isAbsolute7, join as join19, relative as relative11, resolve as resolve6 } from "pathe";
 import { glob as glob6 } from "tinyglobby";
 var filesystemSource = (options) => {
-  const contentRoot = isAbsolute6(options.root) ? options.root : join19(resolve6(options.projectRoot), options.root);
+  const contentRoot = isAbsolute7(options.root) ? options.root : join19(resolve6(options.projectRoot), options.root);
   const load2 = async () => {
     const files = await glob6(options.include, {
       absolute: true,
@@ -9372,7 +9383,7 @@ var filesystemSource = (options) => {
       return {
         body: { format, text: parsed.content },
         data: parsed.data,
-        ref: relative10(contentRoot, file),
+        ref: relative11(contentRoot, file),
         sourcePath: file
       };
     }));
@@ -9680,16 +9691,35 @@ var mdxRemoteSource = (options, ctx) => {
 // src/core/sources/mintlify.ts
 import { existsSync as existsSync15, watch as fsWatch2 } from "node:fs";
 import { readFile as readFile15 } from "node:fs/promises";
-import { isAbsolute as isAbsolute8, join as join22, relative as relative14, resolve as resolve8 } from "pathe";
+import { isAbsolute as isAbsolute9, join as join22, relative as relative15, resolve as resolve8 } from "pathe";
 import { glob as glob7 } from "tinyglobby";
 
 // src/migrate/shared.ts
 import { existsSync as existsSync14 } from "node:fs";
 import { readFile as readFile14, writeFile as writeFile5 } from "node:fs/promises";
-import { isAbsolute as isAbsolute7, join as join20, relative as relative11 } from "pathe";
+import { basename as basename4, isAbsolute as isAbsolute8, join as join20, relative as relative12 } from "pathe";
+
+// src/core/package-json.ts
+var toPackageName = (raw) => raw.toLowerCase().replaceAll(/[^a-z0-9._-]+/gu, "-").replaceAll(/^[-_.]+|[-_.]+$/gu, "") || "docs";
+var blumePackageJson = (name) => `{
+  "name": ${JSON.stringify(name)},
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "blume dev",
+    "build": "blume build",
+    "doctor": "blume doctor"
+  },
+  "dependencies": {
+    "blume": "^${getBlumeVersion()}"
+  }
+}
+`;
+
+// src/migrate/shared.ts
 var isInsideRoot2 = (root, candidate) => {
-  const rel = relative11(root, candidate);
-  return rel === "" || !rel.startsWith("..") && !isAbsolute7(rel);
+  const rel = relative12(root, candidate);
+  return rel === "" || !rel.startsWith("..") && !isAbsolute8(rel);
 };
 var writeBlumeConfig = async (root, config) => {
   const body = `import { defineConfig } from "blume";
@@ -9739,6 +9769,14 @@ var rewriteFrameworkScripts = async (root, cli, remove) => {
   return changed;
 };
 var leftoverFiles = (root, candidates) => candidates.filter((candidate) => existsSync14(join20(root, candidate)));
+var ensurePackageJson = async (root) => {
+  const pkgPath = join20(root, "package.json");
+  if (existsSync14(pkgPath)) {
+    return false;
+  }
+  await writeFile5(pkgPath, blumePackageJson(toPackageName(basename4(root))), "utf-8");
+  return true;
+};
 var attribute = (attrs, name) => {
   const match = attrs.match(new RegExp(`\\b${name}=(?:"(?<dq>[^"]*)"|'(?<sq>[^']*)')`, "u"));
   return match?.groups?.dq ?? match?.groups?.sq;
@@ -10135,7 +10173,7 @@ var isLiteralObject = (value) => typeof value === "object" && value !== null &&
 var asLiteralArray = (value) => Array.isArray(value) ? value : undefined;
 
 // src/migrate/mintlify/content.ts
-import { dirname as dirname10, join as join21, relative as relative12 } from "pathe";
+import { dirname as dirname10, join as join21, relative as relative13 } from "pathe";
 var CALLOUT_DIRECTIVES = {
   Check: "success",
   Danger: "danger",
@@ -10174,7 +10212,7 @@ var rewriteSnippetImports = (source, options) => {
     }
     const target = join21(options.root, importSource.replace(/^\/+/u, ""));
     components.push(importSource.replace(/^\/+/u, ""));
-    let rel = relative12(dirname10(options.filePath), target);
+    let rel = relative13(dirname10(options.filePath), target);
     if (!rel.startsWith(".")) {
       rel = `./${rel}`;
     }
@@ -10364,7 +10402,7 @@ var rewriteMintlifySvgIconProps = (source) => {
 
 // src/migrate/mintlify/snippets.ts
 import { readFile as readFileFromDisk } from "node:fs/promises";
-import { dirname as dirname11, relative as relative13, resolve as resolve7 } from "pathe";
+import { dirname as dirname11, relative as relative14, resolve as resolve7 } from "pathe";
 var MARKDOWN_SNIPPET_IMPORT = /^import\s+(?<name>[$A-Z_a-z][$\w]*)\s+from\s+["'](?<source>[^"']+\.mdx?)["'];?\s*$/gmu;
 var NAMED_SNIPPET_IMPORT = /^import\s+\{(?<names>[^}]+)\}\s+from\s+["'](?<source>[^"']+\.mdx?)["'];?\s*$/gmu;
 var EXPORTED_STRING_CONST = /^export\s+const\s+(?<name>[$A-Z_a-z][$\w]*)\s*=\s*(?:"(?<double>(?:\\.|[^"\\])*)"|'(?<single>(?:\\.|[^'\\])*)'|`(?<template>(?:\\.|[^`\\])*)`)\s*;?\s*$/gmu;
@@ -10374,14 +10412,14 @@ var GLOBAL_VARIABLE = /\{\{\s*(?<name>[A-Za-z0-9-]+)\s*\}\}/gu;
 var FRONTMATTER_BLOCK = /^---\r?\n[\s\S]*?\r?\n---\r?\n?/u;
 var USER_EXPORT = /^(?:export\s+)?(?:const|let|var)\s+user\s*=|^import\s+\{\s*user\s*\}/mu;
 var isInsideRoot3 = (root, candidate) => {
-  const rel = relative13(root, candidate);
+  const rel = relative14(root, candidate);
   return rel === "" || !rel.startsWith("..") && !rel.startsWith("/");
 };
 var escapeRegExp2 = (value) => value.replaceAll(/[.*+?^${}()|[\]\\]/gu, "\\$&");
 var snippetSelfClosingTagPattern = (name) => new RegExp(`<${escapeRegExp2(name)}(?<attrs>[^>]*?)\\s*/>`, "gu");
 var snippetPairedTagPattern = (name) => new RegExp(`<${escapeRegExp2(name)}(?<attrs>[^>]*?)>[\\s\\S]*?</${escapeRegExp2(name)}>`, "gu");
 var rootRelativePath = (root, file) => {
-  const rel = relative13(root, file);
+  const rel = relative14(root, file);
   return rel ? `/${rel}` : "/";
 };
 var snippetCycleMessage = (root, file, trail) => {
@@ -10584,8 +10622,18 @@ var MINTLIFY_SOURCE_IGNORES = [
   "public/**",
   "snippets/**"
 ];
+var WATCH_IGNORE_DIRS = new Set([
+  ...MINTLIFY_SOURCE_IGNORES.map((pattern) => pattern.replace(/\/\*\*$/u, "")),
+  ".git"
+]);
+var mintlifyWatchListener = (onChange) => (_event, filename) => {
+  if (typeof filename === "string" && filename.split(/[/\\]/u).some((segment) => WATCH_IGNORE_DIRS.has(segment))) {
+    return;
+  }
+  onChange();
+};
 var mintlifySource = (options) => {
-  const contentRoot = isAbsolute8(options.root) ? options.root : join22(resolve8(options.projectRoot), options.root);
+  const contentRoot = isAbsolute9(options.root) ? options.root : join22(resolve8(options.projectRoot), options.root);
   const ignore = [...new Set([...options.exclude, ...MINTLIFY_SOURCE_IGNORES])];
   const transform = (raw, file) => transformMintlifyContent(raw, {
     filePath: file,
@@ -10611,7 +10659,7 @@ var mintlifySource = (options) => {
         body: { format: "mdx", text: parsed.content },
         data: parsed.data,
         raw: result.content,
-        ref: relative14(contentRoot, file),
+        ref: relative15(contentRoot, file),
         sourcePath: file
       };
     }));
@@ -10638,7 +10686,7 @@ var mintlifySource = (options) => {
   const watch = (onChange) => {
     const disposers = [];
     if (existsSync15(contentRoot)) {
-      const watcher = fsWatch2(contentRoot, { recursive: true }, onChange);
+      const watcher = fsWatch2(contentRoot, { recursive: true }, mintlifyWatchListener(onChange));
       disposers.push(() => watcher.close());
     }
     if (options.configFile && existsSync15(options.configFile)) {
@@ -11845,7 +11893,7 @@ import { dev } from "astro";
 import { defineCommand as defineCommand4 } from "citty";
 
 // src/astro/static-assets.ts
-import { extname as extname7, join as join30, relative as relative15, resolve as resolve10, sep } from "pathe";
+import { extname as extname7, join as join30, relative as relative16, resolve as resolve10, sep } from "pathe";
 
 // src/astro/integration.ts
 var overlayServer = null;
@@ -12073,12 +12121,12 @@ var doctorCommand = defineCommand5({
 // src/cli/commands/eject.ts
 import { readFile as readFile17, writeFile as writeFile9 } from "node:fs/promises";
 import { defineCommand as defineCommand6 } from "citty";
-import { join as join32, relative as relative17 } from "pathe";
+import { join as join32, relative as relative18 } from "pathe";
 
 // src/registry/eject.ts
 import { existsSync as existsSync19 } from "node:fs";
 import { cp, mkdir as mkdir5, readFile as readFile16, rm as rm2, writeFile as writeFile8 } from "node:fs/promises";
-import { join as join31, relative as relative16 } from "pathe";
+import { join as join31, relative as relative17 } from "pathe";
 var POSIX = (path) => path.split("\\").join("/");
 var ejectOpenApiData = (project) => {
   const source = project.sources.find(isOpenApiSource);
@@ -12130,13 +12178,13 @@ var eject = async (root) => {
   const needsSvelte = frameworks.has("svelte");
   const relContext = {
     ...context,
-    contentRoot: POSIX(relative16(root, context.contentRoot)),
+    contentRoot: POSIX(relative17(root, context.contentRoot)),
     outDir: ".",
     root: "."
   };
-  const componentsImport = context.componentsFile ? `../../${POSIX(relative16(root, context.componentsFile))}` : null;
+  const componentsImport = context.componentsFile ? `../../${POSIX(relative17(root, context.componentsFile))}` : null;
   const relPages = pages.map((page) => ({
-    entrypoint: POSIX(relative16(root, page.entrypoint)),
+    entrypoint: POSIX(relative17(root, page.entrypoint)),
     pattern: page.pattern
   }));
   const staged = collectStaged(project);
@@ -12354,7 +12402,7 @@ var ejectCommand = defineCommand6({
     await updatePackageScripts(root);
     logger.success(`Ejected ${files.length} file(s):`);
     for (const file of files) {
-      process.stdout.write(`  ${relative17(root, file)}
+      process.stdout.write(`  ${relative18(root, file)}
 `);
     }
     logger.box(`Your project is now a standalone Astro app.
@@ -12370,22 +12418,7 @@ The blume package remains importable.`);
 import { existsSync as existsSync20 } from "node:fs";
 import { mkdir as mkdir6, writeFile as writeFile10 } from "node:fs/promises";
 import { defineCommand as defineCommand7 } from "citty";
-import { basename as basename4, dirname as dirname13, isAbsolute as isAbsolute9, join as join33, relative as relative18 } from "pathe";
-var toPackageName = (raw) => raw.toLowerCase().replaceAll(/[^a-z0-9._-]+/gu, "-").replaceAll(/^[-_.]+|[-_.]+$/gu, "") || "docs";
-var packageTemplate = (name, version) => `{
-  "name": ${JSON.stringify(name)},
-  "private": true,
-  "type": "module",
-  "scripts": {
-    "dev": "blume dev",
-    "build": "blume build",
-    "doctor": "blume doctor"
-  },
-  "dependencies": {
-    "blume": "^${version}"
-  }
-}
-`;
+import { basename as basename5, dirname as dirname13, isAbsolute as isAbsolute10, join as join33, relative as relative19 } from "pathe";
 var TEMPLATES = ["docs", "api", "sdk", "changelog"];
 var PACKAGE_MANAGERS = ["npm", "pnpm", "yarn", "bun"];
 var configFor = (extra) => `import { defineConfig } from "blume";
@@ -12519,7 +12552,7 @@ var initCommand = defineCommand7({
   async run({ args }) {
     const root = process.cwd();
     const contentDir = args["content-dir"] ?? "docs";
-    if (isAbsolute9(contentDir) || relative18(root, join33(root, contentDir)).startsWith("..")) {
+    if (isAbsolute10(contentDir) || relative19(root, join33(root, contentDir)).startsWith("..")) {
       logger.error(`Invalid --content-dir "${contentDir}" (must be a path inside the project).`);
       process.exit(1);
     }
@@ -12534,7 +12567,7 @@ var initCommand = defineCommand7({
       process.exit(1);
     }
     const starter = STARTERS[template];
-    const createdPackage = await writeFileSafe(join33(root, "package.json"), packageTemplate(toPackageName(basename4(root)), getBlumeVersion()));
+    const createdPackage = await writeFileSafe(join33(root, "package.json"), blumePackageJson(toPackageName(basename5(root))));
     await writeFileSafe(join33(root, "blume.config.ts"), starter.config);
     await Promise.all(starter.files(contentDir).map((file) => writeFileSafe(join33(root, file.path), file.content)));
     const ignored = await ensureGitignore(root, [".blume/", "dist/"]);
@@ -12579,13 +12612,13 @@ import { defineCommand as defineCommand8 } from "citty";
 // src/migrate/fumadocs/index.ts
 import { existsSync as existsSync24 } from "node:fs";
 import { mkdir as mkdir8, readFile as readFile19, rename as rename3, rm as rm3, writeFile as writeFile12 } from "node:fs/promises";
-import { dirname as dirname16, join as join36, relative as relative19 } from "pathe";
+import { dirname as dirname16, join as join36, relative as relative20 } from "pathe";
 import { glob as glob8 } from "tinyglobby";
 
 // src/migrate/fumadocs/config.ts
 import { existsSync as existsSync21 } from "node:fs";
 import { readFile as readFile18 } from "node:fs/promises";
-import { basename as basename5, dirname as dirname14, join as join34 } from "pathe";
+import { basename as basename6, dirname as dirname14, join as join34 } from "pathe";
 var SOURCE_FILES = [
   "lib/source.ts",
   "app/source.ts",
@@ -12640,7 +12673,7 @@ var readTitle = async (root) => {
     if (GENERIC_NAMES.has(bareName(name).toLowerCase())) {
       const repoRoot = gitRepoRoot(root);
       if (repoRoot && repoRoot !== root) {
-        const repoTitle = prettifyTitle(basename5(repoRoot));
+        const repoTitle = prettifyTitle(basename6(repoRoot));
         if (repoTitle !== "Documentation") {
           return repoTitle;
         }
@@ -12932,7 +12965,7 @@ var normalizeFumadocsPageMeta = (value) => {
 // src/migrate/fumadocs/groups.ts
 import { existsSync as existsSync23, statSync as statSync2 } from "node:fs";
 import { mkdir as mkdir7, rename as rename2, writeFile as writeFile11 } from "node:fs/promises";
-import { basename as basename6, join as join35 } from "pathe";
+import { basename as basename7, join as join35 } from "pathe";
 
 // src/migrate/fumadocs/meta.ts
 var SEPARATOR = /^---(?<label>.*)---$/u;
@@ -13121,7 +13154,7 @@ var moveItemIntoGroup = async (item, docsDir, groupDir, label, warnings) => {
     warnings.push(`Sidebar entry "${item.name}" in section "${label}" matched no page or folder; skipped.`);
     return null;
   }
-  const dest = join35(groupDir, basename6(resolved.path));
+  const dest = join35(groupDir, basename7(resolved.path));
   if (existsSync23(dest)) {
     warnings.push(`Skipped moving "${item.name}" into section "${label}" (target already exists).`);
     return null;
@@ -13194,7 +13227,7 @@ var FUMADOCS_LEFTOVERS = [
   "app"
 ];
 var movePage = async (abs, base, root) => {
-  const rel = relative19(base, abs);
+  const rel = relative20(base, abs);
   const dest = join36(root, "docs", rel);
   if (existsSync24(dest)) {
     return {
@@ -13241,7 +13274,7 @@ var writeMeta = async (dest, meta, rel, warnings) => {
   return warnings;
 };
 var convertMeta = async (abs, base, root) => {
-  const rel = relative19(base, abs);
+  const rel = relative20(base, abs);
   const raw = await readFile19(abs, "utf-8");
   let parsed;
   try {
@@ -13491,6 +13524,15 @@ var applyRelocatedAssets = (config, assets, warnings) => {
     warnings.push(`Moved assets into public/: ${assets.moved.join(", ")}.`);
   }
 };
+var scaffoldProjectFiles = async (root, warnings) => {
+  if (await ensurePackageJson(root)) {
+    warnings.push("Created a package.json with blume as a dependency; run `npm install`, then `npm run dev`.");
+  }
+  const ignored = await ensureGitignore(root, [".blume/", "dist/"]);
+  if (ignored.length > 0) {
+    warnings.push(`Added ${ignored.join(", ")} to .gitignore.`);
+  }
+};
 var cleanupSnippets = async (root, kept, warnings) => {
   const dir = join37(root, "snippets");
   if (!existsSync25(dir)) {
@@ -13582,6 +13624,7 @@ var migrateMintlifyProject = async (root) => {
   }
   applyRelocatedAssets(config, assets, warnings);
   await writeBlumeConfig2(root, config);
+  await scaffoldProjectFiles(root, warnings);
   if (Object.keys(variables).length > 0) {
     warnings.push(`Inlined ${Object.keys(variables).length} docs.json variable(s) into content; Blume has no runtime variable substitution.`);
   }
@@ -13598,7 +13641,7 @@ var migrateMintlifyProject = async (root) => {
 // src/migrate/nextra/index.ts
 import { existsSync as existsSync26 } from "node:fs";
 import { mkdir as mkdir10, readFile as readFile21, rename as rename5, rm as rm5, writeFile as writeFile14 } from "node:fs/promises";
-import { basename as basename7, dirname as dirname18, extname as extname8, join as join38, relative as relative20 } from "pathe";
+import { basename as basename8, dirname as dirname18, extname as extname8, join as join38, relative as relative21 } from "pathe";
 import { glob as glob10 } from "tinyglobby";
 
 // src/migrate/nextra/content.ts
@@ -13833,16 +13876,16 @@ var indexFolders = (base, pageFiles, metaFiles) => {
     }
   };
   for (const abs of pageFiles) {
-    const rel = relative20(base, abs);
+    const rel = relative21(base, abs);
     const dir = normalizeDir(dirname18(rel));
-    const slug = basename7(rel).replace(/\.mdx?$/u, "");
+    const slug = basename8(rel).replace(/\.mdx?$/u, "");
     const folder = pagesByDir.get(dir) ?? new Map;
     folder.set(slug, abs);
     pagesByDir.set(dir, folder);
     registerDir(dir);
   }
   for (const abs of metaFiles) {
-    registerDir(normalizeDir(dirname18(relative20(base, abs))));
+    registerDir(normalizeDir(dirname18(relative21(base, abs))));
   }
   const childDirs = new Map;
   for (const dir of allDirs) {
@@ -13851,7 +13894,7 @@ var indexFolders = (base, pageFiles, metaFiles) => {
     }
     const parent = normalizeDir(dirname18(dir));
     const children = childDirs.get(parent) ?? new Set;
-    children.add(basename7(dir));
+    children.add(basename8(dir));
     childDirs.set(parent, children);
   }
   return { childDirs, pagesByDir };
@@ -13904,7 +13947,7 @@ var planMetas = (metas, index) => {
   return plan;
 };
 var movePage2 = async (abs, options) => {
-  const rel = relative20(options.base, abs);
+  const rel = relative21(options.base, abs);
   const dest = join38(options.root, "docs", rel);
   if (existsSync26(dest)) {
     return { moved: 0, removed: [], skipped: rel, unsupported: [] };
@@ -14008,7 +14051,7 @@ var migrateNextraProject = async (root) => {
     abs,
     ext: extname8(abs),
     raw: await readFile21(abs, "utf-8"),
-    rel: relative20(base, abs)
+    rel: relative21(base, abs)
   })));
   const plan = planMetas(metas, index);
   const moves = await Promise.all(pageFiles.map((abs) => movePage2(abs, { base, overrides: plan.pageOverrides, root })));
@@ -14668,7 +14711,7 @@ import { join as join44 } from "pathe";
 
 // src/core/links.ts
 import { existsSync as existsSync30 } from "node:fs";
-import { basename as basename8, join as join43 } from "pathe";
+import { basename as basename9, join as join43 } from "pathe";
 var HTTP = /^https?:\/\//iu;
 var PROTOCOL_RELATIVE = /^\/\//u;
 var SCHEME = /^[a-z][a-z0-9+.-]*:/iu;
@@ -14688,7 +14731,7 @@ var assetIsPresent = (resolved, ctx) => {
 };
 var isIndexPage = (page2) => {
   const ref = page2.source?.ref ?? page2.sourcePath ?? "";
-  return /^index\.(?:md|mdx)$/iu.test(basename8(ref));
+  return /^index\.(?:md|mdx)$/iu.test(basename9(ref));
 };
 var resolveRelative = (pageRoute, target, isIndex) => {
   const segments = pageRoute.split("/").filter(Boolean);
@@ -14994,5 +15037,5 @@ process.on("unhandledRejection", (error) => {
 });
 runMain(main);
 
-//# debugId=A4775073F9612C8B64756E2164756E21
+//# debugId=19E77FB94468BA6064756E2164756E21
 //# sourceMappingURL=index.js.map