blume 2.1.0 → 2.1.1

package/dist/cli/{chunk-yxmk4pec.js → chunk-fdrkhpjy.js}

@@ -16,31 +16,31 @@ import {
   applyPlan,
   readExistingPackage,
   nextSteps
-} from "./chunk-xkz5xbtv.js";
+} from "./chunk-ehweg4fr.js";
 import"./chunk-zccbjcj0.js";
-import"./chunk-zf748avv.js";
+import"./chunk-ep6nd0rn.js";
 import {
   commandMeta,
   logger
 } from "./index.js";
-import"./chunk-2f3ndkpw.js";
-import"./chunk-43zcf4gz.js";
-import"./chunk-4h8z9vv5.js";
-import"./chunk-amrb6hgh.js";
-import"./chunk-ta27feev.js";
+import"./chunk-n0v7m8ry.js";
+import"./chunk-ncj7w596.js";
+import"./chunk-gb420vvz.js";
+import"./chunk-66w9j7p6.js";
+import"./chunk-54ztw1nj.js";
 import"./chunk-jq5n4avg.js";
 import"./chunk-cm89scdv.js";
-import"./chunk-2f7n4qzt.js";
+import"./chunk-c1y538kd.js";
 import {
   eject
-} from "./chunk-rekqz4qg.js";
+} from "./chunk-313vnn40.js";
 import {
   updatePackageScripts
-} from "./chunk-py62fewh.js";
+} from "./chunk-mrcccgnh.js";
 import {
   installDependencies
-} from "./chunk-gp84za0h.js";
-import"./chunk-6bm0xpgd.js";
+} from "./chunk-3v3ffbrj.js";
+import"./chunk-w1r4vase.js";
 
 // src/cli/commands/init.ts
 import * as clack from "@clack/prompts";
@@ -301,7 +301,8 @@ var initCommand = defineCommand({
     const ignored = await ensureGitignore(root, [
       "node_modules/",
       ".blume/",
-      "dist/"
+      "dist/",
+      ".env.local"
     ]);
     if (ignored.length > 0) {
       sink.success(`Added ${ignored.join(", ")} to .gitignore`);
@@ -330,5 +331,5 @@ export {
   initCommand
 };
 
-//# debugId=E14485B14C8DBCED64756E2164756E21
-//# sourceMappingURL=chunk-yxmk4pec.js.map
+//# debugId=937A77D93EDC0DE164756E2164756E21
+//# sourceMappingURL=chunk-fdrkhpjy.js.map

package/dist/cli/{chunk-yxmk4pec.js.map → chunk-fdrkhpjy.js.map}

@@ -2,10 +2,10 @@
   "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 { installDependencies } from \"../init/install.ts\";\nimport { collectAnswers } from \"../init/questions.ts\";\nimport {\n  applyPlan,\n  buildPlan,\n  cdCommand,\n  commandsFor,\n  detectPackageManager,\n  nextSteps,\n  outsidePnpmWorkspace,\n  PACKAGE_MANAGERS,\n  readExistingPackage,\n  TEMPLATES,\n  validateContentDir,\n  workspaceNote,\n} from \"../init/scaffold.ts\";\nimport type { InitAnswers } from \"../init/scaffold.ts\";\nimport { logger } from \"../log.ts\";\n\n/** The `cd` line that opens every next-steps hint, when one is needed. */\nconst cdStep = (answers: InitAnswers): string[] =>\n  answers.directory === \".\" ? [] : [cdCommand(answers.directory)];\n\n/**\n * Install the scaffolded project's dependencies. Interactive runs hide the\n * package manager's output behind a spinner; `--yes`/CI runs stream it. On\n * failure the scaffold is left intact and the exact retry command is printed\n * before exiting non-zero, so a CI wrapper can tell the two outcomes apart.\n */\nconst installScaffold = async (\n  root: string,\n  answers: InitAnswers,\n  interactive: boolean\n): Promise<void> => {\n  const command = commandsFor(answers.packageManager).install;\n  const spinner = interactive ? clack.spinner() : undefined;\n  if (spinner) {\n    spinner.start(`Installing dependencies (${command})`);\n  } else {\n    logger.info(`Installing dependencies (${command})…`);\n  }\n  const outcome = await installDependencies(root, answers.packageManager, {\n    quiet: interactive,\n  });\n  if (outcome.failure === undefined) {\n    if (spinner) {\n      spinner.stop(\"Installed dependencies\");\n    } else {\n      logger.success(\"Installed dependencies\");\n    }\n    return;\n  }\n  const retry = [...cdStep(answers), command];\n  const hint = `Project created successfully, but dependency installation failed.\\n\\nRetry with:\\n\\n  ${retry.join(\"\\n  \")}\\n`;\n  if (spinner) {\n    spinner.stop(\"Dependency installation failed\");\n    clack.log.error(outcome.failure);\n    clack.note(hint.trimEnd());\n    clack.outro(\"Scaffolded without dependencies.\");\n  } else {\n    logger.error(outcome.failure);\n    logger.box(hint.trimEnd());\n  }\n  process.exit(1);\n};\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 the fallback\n * below is the common path when the install step was skipped.\n */\nconst ejectScaffold = async (\n  root: string,\n  answers: InitAnswers,\n  needsInstall: boolean\n): Promise<void> => {\n  const commands = commandsFor(answers.packageManager);\n  const cd = cdStep(answers);\n  const install = needsInstall ? [commands.install] : [];\n  try {\n    const { dependencies } = 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    const added = await updatePackageScripts(root, dependencies);\n    logger.success(\"Ejected to a standalone Astro project.\");\n    // The packages eject added aren't installed yet, even when the scaffold's\n    // own install already ran, so install comes first either way.\n    const ejectInstall = added.length > 0 ? [commands.install] : install;\n    const steps = [...cd, ...ejectInstall, commands.dev];\n    logger.box(`Next steps:\\n\\n  ${steps.join(\"\\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    const { message } = error as Error;\n    // Only a skipped install explains the failure; after an install that ran,\n    // the error itself is the reason.\n    logger.warn(\n      needsInstall\n        ? `Scaffolded, but eject needs the project's dependencies installed to load blume.config.ts: ${message}`\n        : `Scaffolded, but eject failed: ${message}`\n    );\n    const steps = [...cd, ...install, `${commands.exec} blume eject --yes`];\n    logger.box(`Next steps:\\n\\n  ${steps.join(\"\\n  \")}`);\n  }\n};\n\n/**\n * Print the closing next steps. An existing package.json was left alone, so\n * the steps add what it lacks; a workspace `note` already printed ahead of an\n * install that ran, so it closes the steps only when the install is still the\n * user's to run.\n */\nconst printNextSteps = async (\n  root: string,\n  answers: InitAnswers,\n  outcome: {\n    createdPackage: boolean;\n    interactive: boolean;\n    needsInstall: boolean;\n    note: string | undefined;\n  }\n): Promise<void> => {\n  const existing = outcome.createdPackage\n    ? undefined\n    : await readExistingPackage(root);\n  const steps = nextSteps(\n    answers,\n    outcome.needsInstall,\n    existing,\n    outcome.needsInstall ? outcome.note : undefined\n  );\n  if (outcome.interactive) {\n    clack.note(steps.trimEnd());\n    clack.outro(\"You're all set.\");\n  } else {\n    // consola's box pads its content itself; a trailing newline would add\n    // blank rows at the bottom.\n    logger.box(steps.trimEnd());\n  }\n};\n\n/**\n * Validate the enum-valued flags up front, exiting with the accepted values\n * on a typo so a bad flag never reaches the prompts.\n */\nconst resolveFlags = (args: {\n  \"package-manager\"?: string;\n  template?: string;\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  return { pm, template };\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    install: {\n      default: true,\n      description: \"Install dependencies after scaffolding.\",\n      negativeDescription: \"Skip installing dependencies after scaffolding.\",\n      type: \"boolean\",\n    },\n    \"package-manager\": {\n      description:\n        \"Package manager to install with and print in the next steps (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    const { pm, template } = resolveFlags(args);\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(\"Canceled — 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 env = { userAgent: process.env.npm_config_user_agent };\n    const { createdPackage } = await applyPlan(\n      buildPlan(root, answers, env),\n      sink\n    );\n    // A workspace the project joins keeps its own package-manager config,\n    // which `init` leaves alone; say what it still needs before installing.\n    const note = workspaceNote(root, answers, env);\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    // A newly written package.json is the only one `init` knows lists blume;\n    // an existing one is left alone, and so are its dependencies. In a pnpm\n    // workspace that doesn't list the folder, an install would exit 0 without\n    // installing it, so that one waits until the note's change is made.\n    const shouldInstall =\n      createdPackage && args.install && !outsidePnpmWorkspace(root, answers);\n    if (note) {\n      (interactive ? clack.log : logger).warn(note);\n    }\n    if (shouldInstall) {\n      await installScaffold(root, answers, interactive);\n    }\n    const needsInstall = createdPackage && !shouldInstall;\n\n    if (args.eject) {\n      await ejectScaffold(root, answers, needsInstall);\n      return;\n    }\n\n    await printNextSteps(root, answers, {\n      createdPackage,\n      interactive,\n      needsInstall,\n      note,\n    });\n  },\n});\n",
+    "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 { installDependencies } from \"../init/install.ts\";\nimport { collectAnswers } from \"../init/questions.ts\";\nimport {\n  applyPlan,\n  buildPlan,\n  cdCommand,\n  commandsFor,\n  detectPackageManager,\n  nextSteps,\n  outsidePnpmWorkspace,\n  PACKAGE_MANAGERS,\n  readExistingPackage,\n  TEMPLATES,\n  validateContentDir,\n  workspaceNote,\n} from \"../init/scaffold.ts\";\nimport type { InitAnswers } from \"../init/scaffold.ts\";\nimport { logger } from \"../log.ts\";\n\n/** The `cd` line that opens every next-steps hint, when one is needed. */\nconst cdStep = (answers: InitAnswers): string[] =>\n  answers.directory === \".\" ? [] : [cdCommand(answers.directory)];\n\n/**\n * Install the scaffolded project's dependencies. Interactive runs hide the\n * package manager's output behind a spinner; `--yes`/CI runs stream it. On\n * failure the scaffold is left intact and the exact retry command is printed\n * before exiting non-zero, so a CI wrapper can tell the two outcomes apart.\n */\nconst installScaffold = async (\n  root: string,\n  answers: InitAnswers,\n  interactive: boolean\n): Promise<void> => {\n  const command = commandsFor(answers.packageManager).install;\n  const spinner = interactive ? clack.spinner() : undefined;\n  if (spinner) {\n    spinner.start(`Installing dependencies (${command})`);\n  } else {\n    logger.info(`Installing dependencies (${command})…`);\n  }\n  const outcome = await installDependencies(root, answers.packageManager, {\n    quiet: interactive,\n  });\n  if (outcome.failure === undefined) {\n    if (spinner) {\n      spinner.stop(\"Installed dependencies\");\n    } else {\n      logger.success(\"Installed dependencies\");\n    }\n    return;\n  }\n  const retry = [...cdStep(answers), command];\n  const hint = `Project created successfully, but dependency installation failed.\\n\\nRetry with:\\n\\n  ${retry.join(\"\\n  \")}\\n`;\n  if (spinner) {\n    spinner.stop(\"Dependency installation failed\");\n    clack.log.error(outcome.failure);\n    clack.note(hint.trimEnd());\n    clack.outro(\"Scaffolded without dependencies.\");\n  } else {\n    logger.error(outcome.failure);\n    logger.box(hint.trimEnd());\n  }\n  process.exit(1);\n};\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 the fallback\n * below is the common path when the install step was skipped.\n */\nconst ejectScaffold = async (\n  root: string,\n  answers: InitAnswers,\n  needsInstall: boolean\n): Promise<void> => {\n  const commands = commandsFor(answers.packageManager);\n  const cd = cdStep(answers);\n  const install = needsInstall ? [commands.install] : [];\n  try {\n    const { dependencies } = 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    const added = await updatePackageScripts(root, dependencies);\n    logger.success(\"Ejected to a standalone Astro project.\");\n    // The packages eject added aren't installed yet, even when the scaffold's\n    // own install already ran, so install comes first either way.\n    const ejectInstall = added.length > 0 ? [commands.install] : install;\n    const steps = [...cd, ...ejectInstall, commands.dev];\n    logger.box(`Next steps:\\n\\n  ${steps.join(\"\\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    const { message } = error as Error;\n    // Only a skipped install explains the failure; after an install that ran,\n    // the error itself is the reason.\n    logger.warn(\n      needsInstall\n        ? `Scaffolded, but eject needs the project's dependencies installed to load blume.config.ts: ${message}`\n        : `Scaffolded, but eject failed: ${message}`\n    );\n    const steps = [...cd, ...install, `${commands.exec} blume eject --yes`];\n    logger.box(`Next steps:\\n\\n  ${steps.join(\"\\n  \")}`);\n  }\n};\n\n/**\n * Print the closing next steps. An existing package.json was left alone, so\n * the steps add what it lacks; a workspace `note` already printed ahead of an\n * install that ran, so it closes the steps only when the install is still the\n * user's to run.\n */\nconst printNextSteps = async (\n  root: string,\n  answers: InitAnswers,\n  outcome: {\n    createdPackage: boolean;\n    interactive: boolean;\n    needsInstall: boolean;\n    note: string | undefined;\n  }\n): Promise<void> => {\n  const existing = outcome.createdPackage\n    ? undefined\n    : await readExistingPackage(root);\n  const steps = nextSteps(\n    answers,\n    outcome.needsInstall,\n    existing,\n    outcome.needsInstall ? outcome.note : undefined\n  );\n  if (outcome.interactive) {\n    clack.note(steps.trimEnd());\n    clack.outro(\"You're all set.\");\n  } else {\n    // consola's box pads its content itself; a trailing newline would add\n    // blank rows at the bottom.\n    logger.box(steps.trimEnd());\n  }\n};\n\n/**\n * Validate the enum-valued flags up front, exiting with the accepted values\n * on a typo so a bad flag never reaches the prompts.\n */\nconst resolveFlags = (args: {\n  \"package-manager\"?: string;\n  template?: string;\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  return { pm, template };\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    install: {\n      default: true,\n      description: \"Install dependencies after scaffolding.\",\n      negativeDescription: \"Skip installing dependencies after scaffolding.\",\n      type: \"boolean\",\n    },\n    \"package-manager\": {\n      description:\n        \"Package manager to install with and print in the next steps (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    const { pm, template } = resolveFlags(args);\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(\"Canceled — 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 env = { userAgent: process.env.npm_config_user_agent };\n    const { createdPackage } = await applyPlan(\n      buildPlan(root, answers, env),\n      sink\n    );\n    // A workspace the project joins keeps its own package-manager config,\n    // which `init` leaves alone; say what it still needs before installing.\n    const note = workspaceNote(root, answers, env);\n\n    // Keep installed dependencies, Blume's generated runtime (`.blume/`),\n    // build output (`dist/`), and local secrets (`.env.local`, where every\n    // missing-secret warning says to put them) out of version control.\n    // Idempotent: creates `.gitignore` when absent and skips entries already\n    // present (trailing-slash agnostic).\n    const ignored = await ensureGitignore(root, [\n      \"node_modules/\",\n      \".blume/\",\n      \"dist/\",\n      \".env.local\",\n    ]);\n    if (ignored.length > 0) {\n      sink.success(`Added ${ignored.join(\", \")} to .gitignore`);\n    }\n\n    // A newly written package.json is the only one `init` knows lists blume;\n    // an existing one is left alone, and so are its dependencies. In a pnpm\n    // workspace that doesn't list the folder, an install would exit 0 without\n    // installing it, so that one waits until the note's change is made.\n    const shouldInstall =\n      createdPackage && args.install && !outsidePnpmWorkspace(root, answers);\n    if (note) {\n      (interactive ? clack.log : logger).warn(note);\n    }\n    if (shouldInstall) {\n      await installScaffold(root, answers, interactive);\n    }\n    const needsInstall = createdPackage && !shouldInstall;\n\n    if (args.eject) {\n      await ejectScaffold(root, answers, needsInstall);\n      return;\n    }\n\n    await printNextSteps(root, answers, {\n      createdPackage,\n      interactive,\n      needsInstall,\n      note,\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: \"A Contentful content type\",\n        label: \"contentful\",\n        value: \"contentful\",\n      },\n      { hint: \"A Payload collection\", label: \"payload\", value: \"payload\" },\n      { hint: \"A Strapi content type\", label: \"strapi\", value: \"strapi\" },\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": "E14485B14C8DBCED64756E2164756E21",
+  "mappings": "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",
+  "debugId": "937A77D93EDC0DE164756E2164756E21",
   "names": []
 }

package/dist/cli/{chunk-5wj2qwn2.js → chunk-ft9vfys6.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   loadConfig
-} from "./chunk-xkz5xbtv.js";
+} from "./chunk-ehweg4fr.js";
 import"./chunk-zccbjcj0.js";
 import {
   commandMeta,
@@ -11,11 +11,11 @@ import {
   reportDiagnostics
 } from "./index.js";
 import"./chunk-jq5n4avg.js";
-import"./chunk-43zcf4gz.js";
+import"./chunk-ncj7w596.js";
 import {
   CutError,
   cutVersion
-} from "./chunk-e7vvk5ya.js";
+} from "./chunk-sds923fa.js";
 
 // src/cli/commands/version.ts
 import { defineCommand } from "citty";
@@ -88,4 +88,4 @@ export {
 };
 
 //# debugId=86F69482E9E3E55264756E2164756E21
-//# sourceMappingURL=chunk-5wj2qwn2.js.map
+//# sourceMappingURL=chunk-ft9vfys6.js.map

package/dist/cli/{chunk-4h8z9vv5.js → chunk-gb420vvz.js}

@@ -8,14 +8,15 @@ import {
   fontLocaleCodes,
   buildFontEntries,
   isPatternPath,
-  compileRedirects,
+  compileEveryRedirect,
   hasVariables,
   SVG_ASSET_HEADERS,
   applyBaseToAstroRedirects,
+  withMirrorRedirects,
   distDir,
   adapterRoot,
   deployPlatform
-} from "./chunk-xkz5xbtv.js";
+} from "./chunk-ehweg4fr.js";
 import {
   trimChar,
   normalizeBasePath
@@ -34,7 +35,7 @@ var deployOutputDir = (config, context) => {
 };
 var deployStaticDir = (config, context) => {
   const { deployment } = config;
-  return deployment.options.output === "server" ? deployPlatform(deployment).serverStaticDir(context) : distDir(context);
+  return deployment.options.output === "server" ? deployPlatform(deployment).serverStaticDir(context, normalizeBasePath(deployment.options.base)) : distDir(context);
 };
 var surfaceAdapterOutput = async (config, context) => {
   const { deployment } = config;
@@ -219,6 +220,10 @@ import { existsSync as existsSync2, readFileSync } from "node:fs";
 import { pathToFileURL } from "node:url";
 import { dirname as dirname2, isAbsolute as isAbsolute2, join as join3, relative as relative2 } from "pathe";
 
+// src/ai/ask-limits.ts
+var ASK_MAX_MESSAGES = 40;
+var ASK_MAX_MESSAGES_CHARS = 24000;
+
 // src/consent/clients.ts
 var CONSENT_CLIENT_MODULES = new Map([
   ["native", "blume/components/layout/consent/native.ts"]
@@ -273,13 +278,13 @@ var renderAstroAdapter = (deployment, context, ejected) => {
   const { astro } = platform;
   const args = {
     ...astro.options(context),
-    ...deployPassthrough(deployment.options)
+    ...deployPassthrough(deployment.options, astro.configOptions)
   };
   const argsLiteral = Object.keys(args).length > 0 ? JSON.stringify(args) : "";
   const construct = `adapter(${argsLiteral})`;
   const expression = platform.hiddenRuntime.showProjectRoot && !ejected ? `withAdapterRoot(${construct}, ${JSON.stringify(adapterRoot(context))})` : construct;
   return {
-    configEntries: Object.entries(astro.config).map(([key, value]) => `
+    configEntries: Object.entries(astro.config(deployment.options)).map(([key, value]) => `
   ${key}: ${JSON.stringify(value)},`).join(""),
     importLine: `import adapter from "${astro.package}";
 `,
@@ -338,7 +343,7 @@ var RENDER_EXTERNAL_DEPS = [
 ];
 var renderUserAliases = (aliases) => Object.entries(aliases ?? {}).toSorted(([a], [b]) => b.length - a.length).map(([find, replacement]) => `
         ${JSON.stringify(find)}: ${JSON.stringify(replacement)},`).join("");
-var REACT_EXCLUDE = String.raw`exclude: [/\/node_modules\/\.vite\//, /\/\.cache\/vite\//]`;
+var REACT_EXCLUDE = String.raw`exclude: [/\/\.cache\/vite\//]`;
 var runtimeCacheOptions = (context, generatedModulesDir) => {
   if (generatedModulesDir !== undefined) {
     return { astro: "", vite: "" };
@@ -350,7 +355,7 @@ var runtimeCacheOptions = (context, generatedModulesDir) => {
     cacheDir: ${JSON.stringify(`${context.outDir}/.cache/vite`)},`
   };
 };
-var reactIntegration = (compilerPath) => compilerPath ? `react({ babel: { plugins: [[${JSON.stringify(compilerPath)}, { target: "19" }]] }, ${REACT_EXCLUDE} })` : `react({ ${REACT_EXCLUDE} })`;
+var reactIntegration = (compiler) => compiler ? `react({ compiler: true, ${REACT_EXCLUDE} })` : `react({ ${REACT_EXCLUDE} })`;
 var renderIntegrationBridge = (bridge) => {
   if (!bridge) {
     return {
@@ -396,7 +401,7 @@ var resolveOptimizeDeps = (options) => {
     ...features.mermaid ? ["blume > mermaid"] : [],
     ...features.epub ? ["blume > epub-gen-memory/bundle"] : [],
     ...searchDep ? [`blume > ${searchDep}`] : [],
-    ...options.needsReact && options.reactCompilerPath ? ["react/compiler-runtime"] : []
+    ...options.needsReact && options.reactCompiler ? ["react/compiler-runtime"] : []
   ];
   return { optimizeDepsEntries, optimizeDepsInclude };
 };
@@ -465,7 +470,7 @@ var astroConfigTemplate = (options) => {
     context,
     features,
     needsReact,
-    reactCompilerPath: options.reactCompilerPath,
+    reactCompiler: options.reactCompiler,
     searchKind: config.search.provider.kind
   });
   const {
@@ -486,7 +491,8 @@ var astroConfigTemplate = (options) => {
       prefixDefaultLocale: !config.i18n.hideDefaultLocalePrefix
     }
   })},` : "";
-  const basedRedirects = applyBaseToAstroRedirects(config.redirects, config.basePath, deployment.options.base ?? "", new Set(contentRoutes));
+  const redirectPages = new Set(contentRoutes);
+  const basedRedirects = withMirrorRedirects(applyBaseToAstroRedirects(config.redirects, config.basePath, deployment.options.base ?? "", redirectPages), redirectPages, { from: "", to: normalizeBasePath(deployment.options.base) });
   const exactRedirects = basedRedirects.filter((redirect) => !isPatternPath(redirect.from));
   const redirectsOption = exactRedirects.length > 0 ? `
   redirects: ${JSON.stringify(Object.fromEntries(exactRedirects.map((redirect) => [
@@ -547,7 +553,7 @@ var astroConfigTemplate = (options) => {
     `mdx({ processor: blumeMdxProcessor(${processorOptions}) })`
   ];
   if (needsReact) {
-    integrations.push(reactIntegration(options.reactCompilerPath));
+    integrations.push(reactIntegration(options.reactCompiler));
   }
   if (needsVue) {
     integrations.push("vue()");
@@ -560,7 +566,7 @@ var astroConfigTemplate = (options) => {
     contentRoutes,
     ejected,
     pages,
-    redirects: compileRedirects(basedRedirects)
+    redirects: compileEveryRedirect(basedRedirects)
   }))})`);
   const {
     configSourceMarker,
@@ -625,8 +631,8 @@ ${userConfigSetup}export default defineConfig({
     // Everything hydration can reach must be part of the dev dep optimizer's
     // FIRST run. The Vite root is the generated runtime, so user pages,
     // islands, and aliased components live outside it and are only crawled
-    // when first requested — and \`react/compiler-runtime\` is Babel-injected,
-    // so no source scan can ever see it. A dependency discovered after
+    // when first requested — and \`react/compiler-runtime\` is injected by the
+    // React Compiler, so no source scan can ever see it. A dependency discovered after
     // hydration begins triggers a mid-session re-optimization whose new
     // generation imports React through new \`?v=\` URLs; the browser then
     // evaluates a second React copy and every island tears down with
@@ -880,7 +886,7 @@ ${limit.check}  const text = await readCappedText(request, ${ASK_BODY_LIMIT_BYTE
   const valid =
     Array.isArray(raw) &&
     raw.length > 0 &&
-    raw.length <= 40 &&
+    raw.length <= ${ASK_MAX_MESSAGES} &&
     raw.every(
       (m: unknown) =>
         typeof m === "object" &&
@@ -888,10 +894,10 @@ ${limit.check}  const text = await readCappedText(request, ${ASK_BODY_LIMIT_BYTE
         ("role" in m && (m.role === "user" || m.role === "assistant")) &&
         ("content" in m && typeof m.content === "string")
     ) &&
-    JSON.stringify(raw).length <= 24_000;
+    JSON.stringify(raw).length <= ${ASK_MAX_MESSAGES_CHARS};
   if (!valid) {
     return new Response(
-      "Invalid request: send 1-40 user/assistant messages with string content.",
+      "Invalid request: send 1-${ASK_MAX_MESSAGES} user/assistant messages with string content.",
       { status: 400 }
     );
   }
@@ -1034,10 +1040,11 @@ var searchClientTemplate = (config) => {
       return hostedSearchClient(provider);
     }
     case "server": {
-      return `${SEARCH_CLIENT_HEADER}${searchClientImport("endpoint")}${SEARCH_BASE_IMPORT}
+      return `${SEARCH_CLIENT_HEADER}${searchClientImport("endpoint")}${SEARCH_BASE_IMPORT}import type { SearchClientOptions } from "blume/components/layout/search/types.ts";
 const api = joinBase(import.meta.env.BASE_URL, "api/search");
 
-export const createSearch = () => create({ api });
+export const createSearch = (options: SearchClientOptions = {}) =>
+  create({ ...options, api });
 `;
     }
     case "pagefind": {
@@ -1054,7 +1061,8 @@ export const createSearch = () => create({ url });
     }
   }
 };
-var mixedbreadSearchEndpointTemplate = (options, rateLimit) => {
+var mixedbreadSearchEndpointTemplate = (options, pages, rateLimit) => {
+  const { search_options: tuning, storeId, ...searchOptions } = options;
   const limit = rateLimitTemplate(rateLimit, "search");
   const imports = [
     'import type { APIRoute } from "astro";',
@@ -1070,9 +1078,26 @@ ${imports.join(`
 export const prerender = false;
 
 const client = new Mixedbread({ apiKey: getSecret("MIXEDBREAD_API_KEY") ?? "" });
-const OPTIONS = ${JSON.stringify(options)};
-// Every option besides the store reaches the search call verbatim.
-const { storeId: STORE_ID, ...SEARCH_OPTIONS } = OPTIONS;
+const STORE_ID = ${JSON.stringify(storeId)};
+// Every other option reaches the search call verbatim.
+const SEARCH_OPTIONS = ${JSON.stringify(searchOptions)};
+const SEARCH_TUNING = ${JSON.stringify(tuning ?? {})};
+// Each page's source file, relative to the project root, and the page it renders.
+const PAGES = new Map<string, { title: string; url: string }>(${JSON.stringify(pages)});
+
+// The page a synced file renders. \`mxbai store sync\` records the path
+// relative to where it ran (the project root, or a monorepo root above it), so
+// the longest trailing run of that path that names a page's file wins.
+const pageFor = (path: string) => {
+  const segments = path.replaceAll("\\\\", "/").split("/");
+  for (let start = 0; start < segments.length; start += 1) {
+    const page = PAGES.get(segments.slice(start).join("/"));
+    if (page) {
+      return page;
+    }
+  }
+  return undefined;
+};
 ${limit.setup}
 export const POST: APIRoute = async (context) => {
   const { request } = context;
@@ -1098,23 +1123,32 @@ ${limit.check}  // A search body is one short query: read it under a 16 KB cap,
     });
   }
   // \`top_k\` defaults to 8 unless an option sets it; the query and store
-  // always come from the request and \`storeId\`.
+  // always come from the request and \`storeId\`. File metadata is always
+  // returned: it holds the path \`mxbai store sync\` recorded for the file.
   const response = await client.stores.search({
     top_k: 8,
     ...SEARCH_OPTIONS,
     query,
+    search_options: { ...SEARCH_TUNING, return_metadata: true },
     store_identifiers: [STORE_ID],
   });
-  const hits = (response.data ?? []).map((chunk) => {
+  const seen = new Set<string>();
+  const hits = (response.data ?? []).flatMap((chunk) => {
+    const { file_path: path } = (chunk.metadata ?? {}) as { file_path?: unknown };
+    const page = typeof path === "string" ? pageFor(path) : undefined;
+    // A file no page renders has nowhere to link, and a page's later chunks
+    // would repeat it: one hit per page, at its best chunk.
+    if (!page || seen.has(page.url)) {
+      return [];
+    }
+    seen.add(page.url);
     const meta = chunk.generated_metadata ?? {};
     // Only a text chunk carries \`text\`; image, audio, and video chunks fall
     // back to the excerpt the store generated for them.
     const text = "text" in chunk ? chunk.text : undefined;
-    return {
-      excerpt: text ?? meta.excerpt ?? "",
-      title: meta.title ?? chunk.filename ?? "",
-      url: meta.url ?? "",
-    };
+    return [
+      { excerpt: text ?? meta.excerpt ?? "", title: page.title, url: page.url },
+    ];
   });
   return new Response(JSON.stringify(hits), {
     headers: { "Content-Type": "application/json" },
@@ -1629,6 +1663,7 @@ import type { CollectionKey } from "astro:content";
 import RootLayout from "blume/components/layout/RootLayout.astro";
 import { withBase, withMountedBase } from "blume/components/islands/base-path.ts";
 import { mountBasePath, stripBasePath } from "blume/core/base-path.ts";
+import { routeSetFor, servesRoute } from "blume/core/locale-links.ts";
 import { resolveSlot } from "blume/components/layout/overrides.ts";
 ${componentImports}
 import data from "blume:data";
@@ -1832,18 +1867,24 @@ const logicalRoute = i18n
   ? stripLocale(stripBasePath(data.config.basePath, route), locale)
   : route;
 // A page from a one-language source (GitHub Releases) gets no switcher: every
-// other locale would only repeat the same text.
+// other locale would only repeat the same text. A locale with no real
+// translation links the page's fallback copy, which exists only while
+// fallbacks are on; where nothing is served at that URL (\`fallbackLocale:
+// null\`), the locale is left out rather than linked to a 404.
 const localeSwitch = i18n && !monolingual
-  ? i18n.locales.map((l) => {
+  ? i18n.locales.flatMap((l) => {
       const alt = (alternates ?? []).find((x) => x.locale === l.code);
-      return {
-        code: l.code,
-        current: l.code === locale,
-        dir: l.dir,
-        href: alt ? alt.path : mountLocalized(logicalRoute, l.code),
-        label: l.label,
-        untranslated: !alt,
-      };
+      const href = alt ? alt.path : mountLocalized(logicalRoute, l.code);
+      return alt || servesRoute(routeSetFor(data.routes), href)
+        ? [{
+            code: l.code,
+            current: l.code === locale,
+            dir: l.dir,
+            href,
+            label: l.label,
+            untranslated: !alt,
+          }]
+        : [];
     })
   : [];
 
@@ -2143,13 +2184,15 @@ const canonical = base ? base + basedRoute : null;
 const ogPath = data.config.og.enabled ? withMountedBase("/og/changelog.png") : null;
 const ogImage = ogPath && base ? base + ogPath : ogPath;
 
-// The page chrome (h1, title, description) comes from the translatable
-// \`changelog\` group; optional chaining tolerates a not-yet-regenerated data
-// snapshot from before these keys existed.
+// The page chrome (h1, title, description, empty state) comes from the
+// translatable \`changelog\` group, which carries the \`changelog\` config's title and
+// description when it sets them; optional chaining tolerates a
+// not-yet-regenerated data snapshot from before these keys existed.
 const changelogTitle = data.ui.changelog?.title ?? "Changelog";
 const changelogDescription =
   data.ui.changelog?.description ??
   "Product updates, new features, and fixes from every release.";
+const changelogEmpty = data.ui.changelog?.empty ?? "No changelog entries yet.";
 // The layout suffixes "- {site title}" itself, so the page title is just the
 // changelog's own name — prefixing the site title too would double it
 // ("Acme Changelog - Acme").
@@ -2202,7 +2245,7 @@ const LayoutComponent = resolveSlot(layoutOverrides.Layout, RootLayout);
   <p class="text-lg text-muted-foreground">{changelogDescription}</p>
   {
     items.length === 0 ? (
-      <p>No changelog entries yet.</p>
+      <p>{changelogEmpty}</p>
     ) : (
       <div class="not-prose mt-10 divide-y divide-border border-border border-y">
         {groups.map((group) => (
@@ -2755,5 +2798,5 @@ var runtimeTsconfigTemplate = () => `${JSON.stringify({
 
 export { deployOutputDir, deployStaticDir, surfaceAdapterOutput, planComponentSlots, publishRuntimeModules, runtimeDependencies, EJECTED_CONFIG_HEADER, astroConfigTemplate, stagedContentDir, contentConfigTemplate, askEndpointTemplate, askComponentTemplate, searchEndpointTemplate, featuresTemplate, consentClientTemplate, searchClientTemplate, mixedbreadSearchEndpointTemplate, rawMarkdownEndpointTemplate, contentAssetsEndpointTemplate, mcpPageFile, mcpEndpointTemplate, playgroundProxyTemplate, staticJsonEndpointTemplate, rssEndpointTemplate, navFragmentTemplate, ogEndpointTemplate, scalarReferenceTemplate, catchAllPageTemplate, changelogIndexTemplate, notFoundPageTemplate, notFoundMarkdownTemplate, notFoundJsonTemplate, apiPagesIndexTemplate, apiPageTemplate, apiNavigationTemplate, apiSearchTemplate, apiNotFoundTemplate, exampleSlug, exampleWrapperTemplate, examplesRouteBase, exampleMapTemplate, examplesPageTemplate, runtimePackageTemplate, runtimeTsconfigTemplate };
 
-//# debugId=F21B5F971981289464756E2164756E21
-//# sourceMappingURL=chunk-4h8z9vv5.js.map
+//# debugId=5E4553A34E0C7B9D64756E2164756E21
+//# sourceMappingURL=chunk-gb420vvz.js.map