blume 2.0.1 → 2.0.2

package/dist/cli/{chunk-fz5wtpmh.js → chunk-w4bxdvsa.js}

@@ -3,28 +3,30 @@ import {
   resolveRuntimeDir,
   resolveProjectContext,
   loadConfig
-} from "./chunk-qkqwkpte.js";
-import"./chunk-jts8mvcz.js";
+} from "./chunk-v6ya5kcb.js";
+import"./chunk-gs7r695n.js";
 import {
   commandMeta,
   logger
 } from "./index.js";
 import {
   readDevLock
-} from "./chunk-27g6wdth.js";
-import"./chunk-wgm7m9qk.js";
-import"./chunk-6crbhc3x.js";
-import"./chunk-fs23ddbb.js";
-import"./chunk-vtk4a6dg.js";
+} from "./chunk-wdrt2k2v.js";
+import"./chunk-hr8ne106.js";
+import {
+  refuseIfEjected
+} from "./chunk-4e9b9ra6.js";
+import"./chunk-xh43dwgw.js";
+import"./chunk-ddndchfr.js";
+import"./chunk-00gs3wqs.js";
 import"./chunk-jq5n4avg.js";
-import"./chunk-2hn4b8z7.js";
-import"./chunk-zxcczpyx.js";
-import"./chunk-wm7js3j9.js";
-import"./chunk-82bbrxdn.js";
+import"./chunk-5r8g91qn.js";
+import"./chunk-fsmrqk8a.js";
+import"./chunk-sqw4ekg1.js";
 import {
   prepareProject
-} from "./chunk-zxh4d9vy.js";
-import"./chunk-ah61y8py.js";
+} from "./chunk-h2ez8dzb.js";
+import"./chunk-mqc662a6.js";
 
 // src/cli/commands/sync.ts
 import { rm } from "node:fs/promises";
@@ -45,6 +47,7 @@ var syncCommand = defineCommand({
   meta: commandMeta.sync,
   async run({ args }) {
     const root = process.cwd();
+    await refuseIfEjected(root, "sync");
     if (args.force) {
       const { config } = await loadConfig(root);
       const context = resolveProjectContext(root, config);
@@ -68,5 +71,5 @@ export {
   syncCommand
 };
 
-//# debugId=A65A4348F141B1A664756E2164756E21
-//# sourceMappingURL=chunk-fz5wtpmh.js.map
+//# debugId=F5C42A750ABEF23664756E2164756E21
+//# sourceMappingURL=chunk-w4bxdvsa.js.map

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

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/cli/commands/sync.ts"],
+  "sourcesContent": [
+    "import { rm } from \"node:fs/promises\";\n\nimport { defineCommand } from \"citty\";\nimport { join } from \"pathe\";\n\nimport { loadConfig } from \"../../core/config.ts\";\nimport {\n  resolveProjectContext,\n  resolveRuntimeDir,\n} from \"../../core/project.ts\";\nimport { commandMeta } from \"../command-meta.ts\";\nimport { readDevLock } from \"../dev-lock.ts\";\nimport { refuseIfEjected } from \"../eject-scripts.ts\";\nimport { logger } from \"../log.ts\";\nimport { prepareProject } from \"../prepare.ts\";\n\nexport const syncCommand = defineCommand({\n  args: {\n    force: {\n      description: \"Clear the source cache before refetching.\",\n      type: \"boolean\",\n    },\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.sync,\n  async run({ args }) {\n    const root = process.cwd();\n    await refuseIfEjected(root, \"sync\");\n\n    // `--force` drops the snapshots so a stale or corrupt cache can't be served;\n    // scoped to `.blume/cache`, so a running dev server's runtime is untouched.\n    if (args.force) {\n      const { config } = await loadConfig(root);\n      const context = resolveProjectContext(root, config);\n      await rm(join(context.outDir, \"cache\"), { force: true, recursive: true });\n      logger.info(\"Cleared source cache.\");\n    }\n\n    // Dev mode keeps drafts and skips the static-build gate; `refresh` forces\n    // remote sources to re-fetch rather than serve their cached snapshot. A\n    // running dev server hot-reloads from the regenerated runtime — so when one\n    // is live, regenerate with the same site fallback (its URL) it used, else\n    // its astro.config loses `site` (dropping OG and canonicals) and Astro\n    // restarts cold.\n    const lock = readDevLock(resolveRuntimeDir(root));\n    const devServerUrl = lock?.port\n      ? `http://localhost:${lock.port}`\n      : undefined;\n    await prepareProject({\n      devServerUrl,\n      mode: \"dev\",\n      preview: args.preview,\n      refresh: true,\n      root,\n      strict: args.strict,\n    });\n\n    logger.success(\"Synced content sources.\");\n  },\n});\n"
+  ],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAEA;AACA;AAaO,IAAM,cAAc,cAAc;AAAA,EACvC,MAAM;AAAA,IACJ,OAAO;AAAA,MACL,aAAa;AAAA,MACb,MAAM;AAAA,IACR;AAAA,IACA,SAAS;AAAA,MACP,aAAa;AAAA,MACb,MAAM;AAAA,IACR;AAAA,IACA,QAAQ,EAAE,aAAa,wBAAwB,MAAM,UAAU;AAAA,EACjE;AAAA,EACA,MAAM,YAAY;AAAA,OACZ,IAAG,GAAG,QAAQ;AAAA,IAClB,MAAM,OAAO,QAAQ,IAAI;AAAA,IACzB,MAAM,gBAAgB,MAAM,MAAM;AAAA,IAIlC,IAAI,KAAK,OAAO;AAAA,MACd,QAAQ,WAAW,MAAM,WAAW,IAAI;AAAA,MACxC,MAAM,UAAU,sBAAsB,MAAM,MAAM;AAAA,MAClD,MAAM,GAAG,KAAK,QAAQ,QAAQ,OAAO,GAAG,EAAE,OAAO,MAAM,WAAW,KAAK,CAAC;AAAA,MACxE,OAAO,KAAK,uBAAuB;AAAA,IACrC;AAAA,IAQA,MAAM,OAAO,YAAY,kBAAkB,IAAI,CAAC;AAAA,IAChD,MAAM,eAAe,MAAM,OACvB,oBAAoB,KAAK,SACzB;AAAA,IACJ,MAAM,eAAe;AAAA,MACnB;AAAA,MACA,MAAM;AAAA,MACN,SAAS,KAAK;AAAA,MACd,SAAS;AAAA,MACT;AAAA,MACA,QAAQ,KAAK;AAAA,IACf,CAAC;AAAA,IAED,OAAO,QAAQ,yBAAyB;AAAA;AAE5C,CAAC;",
+  "debugId": "F5C42A750ABEF23664756E2164756E21",
+  "names": []
+}

package/dist/cli/{chunk-27g6wdth.js → chunk-wdrt2k2v.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   resolveRuntimeDir
-} from "./chunk-qkqwkpte.js";
+} from "./chunk-v6ya5kcb.js";
 import {
   logger
 } from "./index.js";
@@ -133,4 +133,4 @@ var refuseIfDevRunning = (root, action, options = {}) => {
 export { readDevLock, DevLockHeldError, acquireDevLock, updateDevLockPort, describeDevLock, refuseIfDevRunning };
 
 //# debugId=1007843429DAE30664756E2164756E21
-//# sourceMappingURL=chunk-27g6wdth.js.map
+//# sourceMappingURL=chunk-wdrt2k2v.js.map

package/dist/cli/{chunk-wgm7m9qk.js → chunk-xh43dwgw.js}

@@ -31,6 +31,7 @@ import {
   GOOGLE_FONTS,
   isFontSlug,
   fontLocaleCodes,
+  localeFontSubsets,
   buildFontsCss,
   configuredFonts,
   repoUrl,
@@ -43,32 +44,27 @@ import {
   collectContentAssets,
   buildRssFeeds,
   renderRssFeed,
+  HTTP_METHODS,
+  withServerDefaults,
   isOpenApiSource,
   buildRawMarkdown,
   markdownRoutePaths
-} from "./chunk-qkqwkpte.js";
+} from "./chunk-v6ya5kcb.js";
 import {
   trimChar,
   normalizeBasePath,
   withBasePath,
   siteRoot,
   absoluteUrl2
-} from "./chunk-jts8mvcz.js";
+} from "./chunk-gs7r695n.js";
 import {
   validateSearchPopularIcons,
   validateNavTargets
-} from "./chunk-fs23ddbb.js";
+} from "./chunk-5r8g91qn.js";
 import {
   buildSearchDocuments,
   buildMcpData
-} from "./chunk-6crbhc3x.js";
-import {
-  emptyComponentOverrides,
-  analyzeComponentOverrides
-} from "./chunk-vtk4a6dg.js";
-import {
-  writeTextAtomic
-} from "./chunk-jq5n4avg.js";
+} from "./chunk-ddndchfr.js";
 import {
   planComponentSlots,
   publishRuntimeModules,
@@ -108,15 +104,22 @@ import {
   examplesPageTemplate,
   runtimePackageTemplate,
   runtimeTsconfigTemplate
-} from "./chunk-2hn4b8z7.js";
+} from "./chunk-hr8ne106.js";
+import {
+  emptyComponentOverrides,
+  analyzeComponentOverrides
+} from "./chunk-00gs3wqs.js";
+import {
+  writeTextAtomic
+} from "./chunk-jq5n4avg.js";
 import {
   registry
-} from "./chunk-zxcczpyx.js";
+} from "./chunk-fsmrqk8a.js";
 import {
   readClientMode,
   discoverIslands,
   missingDependencyDiagnostic
-} from "./chunk-wm7js3j9.js";
+} from "./chunk-sqw4ekg1.js";
 
 // src/astro/integration.ts
 import { join as join3, relative, resolve as resolve2 } from "pathe";
@@ -261,6 +264,7 @@ var PROBLEM_TYPE = "application/problem+json";
 
 // src/ai/api/spec.ts
 var JSON_TYPE = "application/json";
+var EVENT_STREAM_TYPE = "text/event-stream";
 var MARKDOWN_TYPE = "text/markdown";
 var TEXT_TYPE = "text/plain";
 var ref = (name) => ({
@@ -717,14 +721,21 @@ var buildApiSpec = (input) => {
       input.mcpRoute,
       {
         post: {
-          description: "The Model Context Protocol server (Streamable HTTP, stateless, JSON responses). Tools: `search_docs`, `get_page`, `list_pages`, `get_navigation` — the same operations this API exposes — plus every page as a `text/markdown` resource. Discovery document at `/.well-known/mcp.json`.",
+          description: "The Model Context Protocol server (Streamable HTTP, stateless, JSON responses). Send `Accept: application/json, text/event-stream`: the Streamable HTTP transport requires a client to accept both and answers `406` otherwise, though this server always replies with JSON. Tools: `search_docs`, `get_page`, `list_pages`, `get_navigation` — the same operations this API exposes — plus every page as a `text/markdown` resource. Discovery document at `/.well-known/mcp.json`.",
           operationId: "mcp",
           requestBody: {
             content: { [JSON_TYPE]: { schema: ref("JsonRpcRequest") } },
             required: true
           },
           responses: {
-            "200": jsonResponse("The JSON-RPC response.", "JsonRpcResponse")
+            "200": {
+              content: {
+                [JSON_TYPE]: { schema: ref("JsonRpcResponse") },
+                [EVENT_STREAM_TYPE]: { schema: { type: "string" } }
+              },
+              description: "The JSON-RPC response."
+            },
+            "406": jsonResponse("The request's `Accept` header doesn't list both `application/json` and `text/event-stream`.", "JsonRpcResponse")
           },
           summary: "Call the MCP server",
           tags: ["MCP"]
@@ -776,17 +787,28 @@ var buildAskData = async (project) => {
     content: "markdown",
     includeWhenDisabled: true
   });
-  return {
+  const versioned = Boolean(project.config.versions);
+  const data = {
     defaultLocale: project.config.i18n?.defaultLocale,
-    documents: documents.map((doc) => ({
-      content: doc.content,
-      description: doc.description,
-      locale: doc.locale,
-      route: doc.route,
-      title: doc.title
-    })),
+    documents: documents.map((doc) => {
+      const document = {
+        content: doc.content,
+        description: doc.description,
+        locale: doc.locale,
+        route: doc.route,
+        title: doc.title
+      };
+      if (versioned) {
+        document.version = doc.version;
+      }
+      return document;
+    }),
     site: project.config.deployment.options.site ?? null
   };
+  if (versioned) {
+    data.versioned = true;
+  }
+  return data;
 };
 
 // src/components/layout/nav-utils.ts
@@ -1201,12 +1223,86 @@ var deriveOgFonts = (fonts, root) => {
   }
   return result;
 };
+var BUILT_IN_FAMILY = "Geist";
+var SCRIPT_FAMILIES = {
+  am: "Noto Sans Ethiopic",
+  ar: "Noto Sans Arabic",
+  as: "Noto Sans Bengali",
+  bn: "Noto Sans Bengali",
+  ckb: "Noto Sans Arabic",
+  fa: "Noto Sans Arabic",
+  gu: "Noto Sans Gujarati",
+  he: "Noto Sans Hebrew",
+  hi: "Noto Sans Devanagari",
+  hy: "Noto Sans Armenian",
+  ja: "Noto Sans JP",
+  ka: "Noto Sans Georgian",
+  km: "Noto Sans Khmer",
+  kn: "Noto Sans Kannada",
+  ko: "Noto Sans KR",
+  lo: "Noto Sans Lao",
+  ml: "Noto Sans Malayalam",
+  mr: "Noto Sans Devanagari",
+  my: "Noto Sans Myanmar",
+  ne: "Noto Sans Devanagari",
+  or: "Noto Sans Oriya",
+  pa: "Noto Sans Gurmukhi",
+  ps: "Noto Sans Arabic",
+  sa: "Noto Sans Devanagari",
+  si: "Noto Sans Sinhala",
+  ta: "Noto Sans Tamil",
+  te: "Noto Sans Telugu",
+  th: "Noto Sans Thai",
+  ti: "Noto Sans Ethiopic",
+  ur: "Noto Sans Arabic",
+  yi: "Noto Sans Hebrew",
+  zh: "Noto Sans SC"
+};
+var isScriptLanguage = (language) => Object.hasOwn(SCRIPT_FAMILIES, language);
+var TRADITIONAL_CHINESE = new Set(["hant", "hk", "mo", "tw"]);
+var localeFamily = (locale) => {
+  const [language = "", ...subtags] = locale.toLowerCase().split("-");
+  if (language === "zh" && subtags.some((tag) => TRADITIONAL_CHINESE.has(tag))) {
+    return "Noto Sans TC";
+  }
+  if (isScriptLanguage(language)) {
+    return SCRIPT_FAMILIES[language];
+  }
+  return localeFontSubsets([locale]).length > 1 ? "Noto Sans" : null;
+};
+var localeOgFonts = (locales) => {
+  const names = new Set;
+  for (const locale of locales) {
+    const family = localeFamily(locale);
+    if (family) {
+      names.add(family);
+    }
+  }
+  return [...names].map((name) => ({ name, weight: CARD_WEIGHTS }));
+};
+var isGoogleFamilyName = (font) => typeof font === "string";
+var ogFontName = (font) => isGoogleFamilyName(font) ? font : font.name;
+var withLocaleFonts = (derived, locales) => {
+  const loaded = new Set(derived.fonts.map(ogFontName));
+  const fallbacks = localeOgFonts(locales).filter((font) => !loaded.has(ogFontName(font)));
+  if (fallbacks.length === 0) {
+    return derived;
+  }
+  return {
+    families: derived.families ?? {
+      body: BUILT_IN_FAMILY,
+      title: BUILT_IN_FAMILY
+    },
+    fonts: [...derived.fonts, ...fallbacks]
+  };
+};
 var resolveOgFontSources = (fonts, root) => fonts.map((font) => isLocalOgFont(font) ? { ...font, src: absoluteSrc(root, font.src) } : font);
 var resolveOgFonts = (options, root) => {
   if (options.ogFonts) {
     return { fonts: resolveOgFontSources(options.ogFonts, root) };
   }
-  return options.themeFontsConfigured ? deriveOgFonts(options.themeFonts, root) : { fonts: [] };
+  const derived = options.themeFontsConfigured ? deriveOgFonts(options.themeFonts, root) : { fonts: [] };
+  return withLocaleFonts(derived, options.locales ?? []);
 };
 var missingFontFiles = (options, root) => {
   const sources = [];
@@ -1635,7 +1731,7 @@ ${THEME_MAPPING}
   @apply block rounded-[0.65rem] px-2.5 py-1.5 text-muted-foreground text-sm transition-colors hover:bg-muted hover:text-foreground aria-[current=page]:bg-muted aria-[current=page]:font-medium aria-[current=page]:text-foreground;
 }
 @utility blume-nav-drill {
-  @apply flex w-full items-center gap-2 rounded-[0.65rem] px-2.5 py-1.5 text-left font-medium text-foreground text-sm transition-colors hover:bg-muted;
+  @apply flex w-full items-center gap-2 rounded-[0.65rem] px-2.5 py-1.5 text-start font-medium text-foreground text-sm transition-colors hover:bg-muted;
 }
 @utility blume-nav-summary {
   @apply flex cursor-pointer list-none items-center gap-1.5 rounded-[0.65rem] px-2.5 py-1.5 text-muted-foreground text-sm transition-colors hover:bg-muted hover:text-foreground [&::-webkit-details-marker]:hidden;
@@ -2251,11 +2347,18 @@ pre:has(.line.focused):hover .line:not(.focused) {
 }
 
 /* Print / "Save as PDF" (the page-actions Export → PDF runs window.print()).
-   Strip the surrounding chrome so the printout is just the article. */
+   Strip the surrounding chrome so the printout is just the article. Scoped to
+   the chrome itself, never bare \`header\`/\`aside\`: content renders those too
+   (every Callout and Panel is an <aside>, every changelog Update has a
+   <header>), and they belong in the printout. \`body > header\` keeps a
+   \`layout.Header\` override out as well. */
 @media print {
   [data-blume-banner],
-  header,
-  aside,
+  [data-blume-header],
+  body > header,
+  [data-blume-nav-drawer],
+  [data-blume-toc],
+  [data-blume-assistant-panel],
   [data-blume-page-actions],
   #blume-content > nav,
   #blume-content > details {
@@ -3205,10 +3308,12 @@ var writeApiFiles = async (project, plan, write, data, mcp) => {
   }
   await Promise.all(writes);
 };
+var PLAYGROUND_PROXY_ENTRY = join11("blume-openapi", "api-proxy.ts");
+var playgroundProxyPattern = (config) => withBasePath(config.basePath, "/_api-proxy");
 var planPlaygroundProxy = (config, srcDir) => ({
   enabled: needsPlaygroundProxy(config),
-  entrypoint: join11(srcDir, "blume-openapi", "api-proxy.ts"),
-  pattern: "/_api-proxy"
+  entrypoint: join11(srcDir, PLAYGROUND_PROXY_ENTRY),
+  pattern: playgroundProxyPattern(config)
 });
 var specOriginsOf = (spec) => {
   const origins = new Set;
@@ -3217,15 +3322,24 @@ var specOriginsOf = (spec) => {
       origins.add(new URL(spec.endpoint).origin);
     } catch {}
   }
-  const { servers } = spec.document;
-  for (const server of Array.isArray(servers) ? servers : []) {
-    const url = server.url ?? "";
-    if (url.includes("{")) {
-      continue;
+  const document = spec.document;
+  const lists = [document.servers];
+  for (const item of Object.values(document.paths ?? {})) {
+    lists.push(item?.servers);
+    for (const method of HTTP_METHODS) {
+      lists.push(item?.[method]?.servers);
+    }
+  }
+  for (const servers of lists) {
+    for (const server of Array.isArray(servers) ? servers : []) {
+      const url = withServerDefaults(server.url ?? "", server.variables);
+      if (url.includes("{")) {
+        continue;
+      }
+      try {
+        origins.add(new URL(url).origin);
+      } catch {}
     }
-    try {
-      origins.add(new URL(url).origin);
-    } catch {}
   }
   return [...origins];
 };
@@ -3237,7 +3351,7 @@ var proxyAllowlistWarnings = (config, data) => {
     if (!proxied.has(spec.slug) || specOriginsOf(spec).length > 0) {
       continue;
     }
-    warnings.push(spec.kind === "graphql" ? `The "${spec.label}" GraphQL reference (${spec.route}) has playground.proxy: true, but no absolute endpoint is configured for it, so the built-in proxy has no origin to allow and will refuse every request its playground sends. Set \`endpoint\` on the graphql() adapter (or the source) to the live GraphQL URL, or point playground.proxy at an external proxy URL.` : `The "${spec.label}" reference (${spec.route}) has playground.proxy: true, but its spec declares no absolute servers[].url (relative and templated URLs carry no origin), so the built-in proxy has no origin to allow and will refuse every request its playground sends. Add an absolute server URL to the spec, or point playground.proxy at an external proxy URL.`);
+    warnings.push(spec.kind === "graphql" ? `The "${spec.label}" GraphQL reference (${spec.route}) has playground.proxy: true, but no absolute endpoint is configured for it, so the built-in proxy has no origin to allow and will refuse every request its playground sends. Set \`endpoint\` on the graphql() adapter (or the source) to the live GraphQL URL, or point playground.proxy at an external proxy URL.` : `The "${spec.label}" reference (${spec.route}) has playground.proxy: true, but its spec declares no absolute servers[].url (relative URLs, and templated ones with a variable missing its default, carry no origin), so the built-in proxy has no origin to allow and will refuse every request its playground sends. Add an absolute server URL to the spec, or point playground.proxy at an external proxy URL.`);
   }
   return warnings;
 };
@@ -3280,6 +3394,7 @@ var dependencyPreflight = async (project, frameworks) => {
 };
 var analyzeComponentsFile = async (componentsFile) => componentsFile ? analyzeComponentOverrides(await readFile4(componentsFile, "utf-8"), componentsFile) : emptyComponentOverrides();
 var projectOgFonts = (project) => resolveOgFonts({
+  locales: fontLocaleCodes(project.config.i18n),
   ogFonts: project.config.seo.og.fonts,
   themeFonts: project.config.theme.fonts,
   themeFontsConfigured: project.themeFontsConfigured
@@ -3558,7 +3673,7 @@ var generateRuntime = async (project) => {
   return { structuralChange: structural.some(Boolean), warnings };
 };
 
-export { publishBuildProject, refreshBlumeContent, showBlumeErrorOverlay, ogCacheDir, pruneCardCache, cardCacheTally, buildAskData, buildThemeCss, buildReferenceFiles, tailwindEntryTemplate, examplesEntryTemplate, rebaseSourceDirectives, twoslashCss, EXAMPLE_SCAN_GLOB, exampleScanRoots, discoverExamples, exampleMarkdownLookup, packageDirFrom, detectNeedsReact, detectUsesMath, collectStaged, buildRuntimeData, analyzeComponentsFile, languageIconCssFor, clientFeaturesFor, generateRuntime };
+export { publishBuildProject, refreshBlumeContent, showBlumeErrorOverlay, ogCacheDir, pruneCardCache, cardCacheTally, buildAskData, buildThemeCss, buildReferenceFiles, tailwindEntryTemplate, examplesEntryTemplate, rebaseSourceDirectives, twoslashCss, EXAMPLE_SCAN_GLOB, exampleScanRoots, discoverExamples, exampleMarkdownLookup, packageDirFrom, detectNeedsReact, detectUsesMath, collectStaged, buildRuntimeData, PLAYGROUND_PROXY_ENTRY, playgroundProxyPattern, specOrigins, proxyAllowlistWarnings, analyzeComponentsFile, languageIconCssFor, clientFeaturesFor, generateRuntime };
 
-//# debugId=35E2A04C63CD05BF64756E2164756E21
-//# sourceMappingURL=chunk-wgm7m9qk.js.map
+//# debugId=0D8B04D4ECFE76CE64756E2164756E21
+//# sourceMappingURL=chunk-xh43dwgw.js.map