blume 1.1.2 → 1.1.3

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # blume
 
+## 1.1.3
+
+### Patch Changes
+
+- 42522fc: Downlevel `<Component>` to its example's source in agent-facing Markdown. The `/<route>.md` mirror, `llms-full.txt`, and the MCP `get_page` tool now render `<Component path="…" />` as a fenced code block of the example's source (the same code the on-page "Code" tab shows) instead of leaving the raw JSX tag, so agents reading a page get the component's code rather than an opaque element. An unknown path (or a missing `path`) is left verbatim, and a same-name `ai.markdownComponents` serializer still overrides the built-in.
+- a71f70e: Add a `dateFormat` config option for the "last updated" stamp and the changelog timeline. Both surfaces previously hardcoded `dateStyle: "long"`; they now share a configurable pass-through to `Intl.DateTimeFormat` options, defaulting to `{ dateStyle: "long" }` so existing sites are unchanged. Set a preset (`dateFormat: { dateStyle: "medium" }`) or a numeric house style (`dateFormat: { year: "numeric", month: "2-digit", day: "2-digit" }`); dates still render in the site's locale and in UTC unless a `timeZone` is given.
+- 68fc939: Harden the agent-facing code-fence helper against a polynomial-time regex (ReDoS). Trailing newlines are now stripped with an unambiguous pattern, so example source with many interior blank lines can't force quadratic backtracking.
+- ee77cfd: Stop long OpenAPI routes from overflowing the native API reference layout. An operation's heading now wraps a long `METHOD /path` title instead of clipping it off the content column, and the overview list rows stack the summary over the route (each getting the full row width) and wrap a long route inside the card — dropping the duplicate path that overlapped the label when a spec sets no summary.
+- 93a94a2: Fix two responsive/mobile layout issues. Twoslash code blocks now wrap their lines on narrow screens instead of pushing the page sideways (hover popups still escape as before), and a long site title in the header now truncates on one line instead of wrapping into the fixed-height bar.
+- a27c543: Add a `scalar` passthrough object to the `openapi` and `asyncapi` config blocks (Scalar renderer). Any [Scalar configuration](https://github.com/scalar/scalar/blob/main/documentation/configuration.md) set there is forwarded verbatim to the embedded `<ScalarComponent>` — `localization` (to translate Scalar's own UI), `agent`, `hideTestRequestButton`, `orderSchemaPropertiesBy`, and the rest. Options in the `scalar` object win over Blume's derived spec/theme config, making it a full escape hatch to Scalar's API; the dedicated `theme` field remains the ergonomic shorthand.
+- fa07dc4: Create the `.blume/node_modules` dependency junction when an isolated linker (Bun's `isolated` mode, pnpm) dedupes the workspace's own `astro` dependency to Blume's copy. The walk from `.blume/` found the "correct" astro through the workspace's direct-dep symlink — in a directory holding none of Blume's integrations — so the junction was skipped and the build died on `Cannot find module '@astrojs/mdx'`.
+
 ## 1.1.2
 
 ### Patch Changes

package/dist/cli/index.js

@@ -3106,6 +3106,7 @@ var referencesFor = (kind, block, defaultLabel, renderer, display, basePath) =>
       label,
       renderer,
       route,
+      scalar: block.scalar,
       slug: routeSlug(route),
       spec: source.spec,
       theme: block.theme
@@ -4327,6 +4328,7 @@ const LayoutComponent = resolveSlot(layoutOverrides.Layout, RootLayout);
   page={{ title: seo.title ?? title, description: seo.description ?? frontmatter.description, route }}
   headings={headings}
   toc={data.config.toc}
+  dateFormat={data.config.dateFormat}
   themeMode={data.config.theme.mode}
   fontCssVars={data.fontCssVars}
   searchEnabled={data.config.search.enabled}
@@ -4365,6 +4367,7 @@ import RootLayout from "blume/components/layout/RootLayout.astro";
 import Update from "blume/components/content/Update.astro";
 import { withBase } from "blume/components/islands/base-path.ts";
 import { resolveSlot } from "blume/components/layout/overrides.ts";
+import { resolveDateFormatOptions } from "blume/core/date-format.ts";
 import { layoutOverrides } from "../generated/components.ts";
 import data from "blume:data";
 
@@ -4392,8 +4395,9 @@ const localeMeta = i18n
 const dir = localeMeta?.dir ?? "ltr";
 const htmlLang = i18n ? i18n.defaultLocale : "en";
 
-// Formatted in the same locale as the chrome, and in UTC, to match the
-// per-page "last updated" stamp.
+// Formatted in the same locale as the chrome, and with the configured
+// \`dateFormat\` (UTC by default), to match the per-page "last updated" stamp.
+const dateFormatOptions = resolveDateFormatOptions(data.config.dateFormat);
 const formatDate = (value: string | null | undefined) => {
   if (!value) {
     return;
@@ -4401,10 +4405,7 @@ const formatDate = (value: string | null | undefined) => {
   const date = new Date(value);
   return Number.isNaN(date.getTime())
     ? undefined
-    : new Intl.DateTimeFormat(htmlLang, {
-        dateStyle: "long",
-        timeZone: "UTC",
-      }).format(date);
+    : new Intl.DateTimeFormat(htmlLang, dateFormatOptions).format(date);
 };
 
 const slugify = (text: string) =>
@@ -7994,6 +7995,19 @@ var lastModifiedConfigSchema = z2.union([
   z2.boolean(),
   z2.strictObject({ type: z2.enum(["git", "frontmatter"]).default("git") })
 ]);
+var dateFormatConfigSchema = z2.strictObject({
+  calendar: z2.string().optional(),
+  dateStyle: z2.enum(["full", "long", "medium", "short"]).optional(),
+  day: z2.enum(["numeric", "2-digit"]).optional(),
+  era: z2.enum(["long", "short", "narrow"]).optional(),
+  month: z2.enum(["numeric", "2-digit", "long", "short", "narrow"]).optional(),
+  numberingSystem: z2.string().optional(),
+  timeZone: z2.string().optional(),
+  weekday: z2.enum(["long", "short", "narrow"]).optional(),
+  year: z2.enum(["numeric", "2-digit"]).optional()
+}).refine((value) => value.dateStyle === undefined || value.weekday === undefined && value.era === undefined && value.year === undefined && value.month === undefined && value.day === undefined, {
+  message: "dateFormat.dateStyle can't be combined with weekday/era/year/month/day; use one or the other."
+});
 var codeConfigSchema = z2.strictObject({
   icons: z2.boolean().default(true),
   wrap: z2.boolean().default(false)
@@ -8012,12 +8026,14 @@ var openapiSourceSchema = z2.strictObject({
   route: z2.string().optional(),
   spec: z2.string()
 });
+var scalarConfigSchema = z2.record(z2.string(), z2.unknown()).optional();
 var openapiConfigSchema = z2.strictObject({
   codeSamples: z2.array(z2.string()).default(["curl", "js", "python"]),
   enabled: z2.boolean().default(false),
   expandSchemas: z2.boolean().default(false),
   renderer: z2.enum(["blume", "scalar"]).default("blume"),
   route: z2.string().default("/reference"),
+  scalar: scalarConfigSchema,
   sources: z2.array(openapiSourceSchema).default([]),
   spec: z2.string().optional(),
   theme: z2.string().optional()
@@ -8025,6 +8041,7 @@ var openapiConfigSchema = z2.strictObject({
 var asyncapiConfigSchema = z2.strictObject({
   enabled: z2.boolean().default(false),
   route: z2.string().default("/events"),
+  scalar: scalarConfigSchema,
   sources: z2.array(openapiSourceSchema).default([]),
   spec: z2.string().optional(),
   theme: z2.string().optional()
@@ -8069,6 +8086,7 @@ var blumeConfigSchema = z2.strictObject({
   banner: bannerConfigSchema.optional(),
   basePath: z2.string().optional().transform((value) => normalizeBasePath(value)),
   content: contentConfigSchema.default({}),
+  dateFormat: dateFormatConfigSchema.default({ dateStyle: "long" }),
   deployment: deploymentConfigSchema.default({}),
   description: z2.string().optional(),
   examples: examplesConfigSchema.default("examples"),
@@ -11734,6 +11752,22 @@ var youtube = ({ props }) => {
   const title = typeof props.title === "string" && props.title !== "" ? props.title : "Watch on YouTube";
   return `[${title}](https://www.youtube.com/watch?v=${videoId}${start})`;
 };
+var fencedBlock = (lang, code) => {
+  const trimmed = code.replace(/(?<!\n)\n+$/u, "");
+  const runs = trimmed.match(/`+/gu);
+  const longest = runs ? Math.max(...runs.map((run) => run.length)) : 0;
+  const fence = "`".repeat(Math.max(3, longest + 1));
+  return `${fence}${lang}
+${trimmed}
+${fence}`;
+};
+var exampleComponentSerializers = (examples) => ({
+  Component: ({ props }) => {
+    const path = typeof props.path === "string" ? props.path : undefined;
+    const example = path === undefined ? undefined : examples[path];
+    return example ? fencedBlock(example.lang, example.source) : null;
+  }
+});
 var SERIALIZERS = {
   Callout: callout,
   Steps: steps,
@@ -11929,10 +11963,14 @@ var buildIndex = (project) => {
 var buildFull = async (project) => {
   const { config } = project;
   const pages = eligiblePages(project).toSorted((a, b) => a.route.localeCompare(b.route));
+  const components = {
+    ...exampleComponentSerializers(project.examples ?? {}),
+    ...config.ai.markdownComponents
+  };
   const sections = await Promise.all(pages.map(async (page) => {
     const raw = await readEntryText(project, page);
     const parsed = frontmatter_default(raw);
-    const body = downlevelComponents(applyAgentVisibility(parsed.content), config.ai.markdownComponents, parsed.data).trim();
+    const body = downlevelComponents(applyAgentVisibility(parsed.content), components, parsed.data).trim();
     const url = pageUrl(page.route, config.deployment.site, normalizeBasePath(config.deployment.base));
     return [`# ${page.title}`, `Source: ${url}`, "", body].join(`
 `);
@@ -12574,6 +12612,10 @@ import { readFile as readFile10 } from "node:fs/promises";
 var agentMarkdown = (entry) => entry.md ?? entry.mdx;
 var buildRawMarkdown = async (project) => {
   const pageById = new Map(project.graph.pages.map((page) => [page.id, page]));
+  const components = {
+    ...exampleComponentSerializers(project.examples ?? {}),
+    ...project.config.ai.markdownComponents
+  };
   const readRoute = async (route) => {
     const page = pageById.get(route.id);
     if (page) {
@@ -12583,7 +12625,7 @@ var buildRawMarkdown = async (project) => {
   };
   const entries = await Promise.all(project.manifest.routes.map(async (route) => {
     const source = applyAgentVisibility(await readRoute(route));
-    const md = downlevelComponents(source, project.config.ai.markdownComponents, frontmatter_default(source).data);
+    const md = downlevelComponents(source, components, frontmatter_default(source).data);
     const entry = md === source ? { mdx: source } : { md, mdx: source };
     return [route.path, entry];
   }));
@@ -13351,7 +13393,8 @@ var buildReferenceFiles = async (options) => {
       content: scalarReferenceTemplate({
         configuration: {
           ...spec.config,
-          ...themeConfiguration(config, ref.theme)
+          ...themeConfiguration(config, ref.theme),
+          ...ref.scalar
         },
         dataImport: `${"../".repeat(depth + 1)}generated/data.json`,
         route: ref.route,
@@ -13582,6 +13625,13 @@ ${THEME_MAPPING}
   letter-spacing: 0;
 }
 
+/* A heading can carry one long unbreakable token — an OpenAPI operation's title
+   is \`METHOD /very/long/{path}\` when the spec sets no summary — which would run
+   off the content column. Break it across lines instead of overflowing. */
+.prose :where(h1, h2, h3, h4, h5, h6) {
+  overflow-wrap: break-word;
+}
+
 .prose :where(h1) {
   font-size: 3rem;
   line-height: 1.1;
@@ -14132,6 +14182,16 @@ var OVERRIDES = `
   padding-right: 1.25rem;
 }
 
+/* Twoslash blocks keep \`overflow: visible\` so popups can escape, which means
+   long lines can't scroll — they'd push past the viewport on narrow screens.
+   Wrap them on mobile instead; hover popups still position against the token. */
+@media (max-width: 640px) {
+  .prose pre.twoslash code {
+    white-space: pre-wrap;
+    overflow-wrap: anywhere;
+  }
+}
+
 /* The rich renderer renders each popup's type signature as a nested Shiki
    pre. Strip the code-block chrome (border, radius, padding, background) so it
    sits flush inside the popup, which owns the frame. */
@@ -14410,6 +14470,10 @@ var discoverExamples = async (root, pattern = "examples") => {
   }
   return { examples, warnings };
 };
+var exampleMarkdownLookup = (examples) => Object.fromEntries(examples.map((example) => [
+  example.path,
+  { lang: example.lang, source: example.source }
+]));
 
 // src/astro/generate.ts
 var BLUME_SRC = join26(packageRoot(), "src");
@@ -14441,12 +14505,13 @@ var resolveAstroPackageJson = (modulesDir) => {
     return null;
   }
 };
-var resolvedAstroPath = (fromDir) => {
+var resolvedAstroHit = (fromDir) => {
   let dir = normalize3(fromDir);
   while (true) {
-    const resolved = resolveAstroPackageJson(join26(dir, "node_modules"));
-    if (resolved) {
-      return resolved;
+    const modulesDir = join26(dir, "node_modules");
+    const pkg = resolveAstroPackageJson(modulesDir);
+    if (pkg) {
+      return { modulesDir, pkg };
     }
     const parent = dirname9(dir);
     if (parent === dir) {
@@ -14455,6 +14520,13 @@ var resolvedAstroPath = (fromDir) => {
     dir = parent;
   }
 };
+var sameRealDir = (a, b) => {
+  try {
+    return realpathSync(a) === realpathSync(b);
+  } catch {
+    return false;
+  }
+};
 var depsCandidates = (pkgDir) => [
   join26(pkgDir, "node_modules"),
   dirname9(pkgDir)
@@ -14523,16 +14595,17 @@ var ensureDepsLink = async (outDir, pkgDir = packageRoot()) => {
   const mdxDir = candidateHolding(pkgDir, "@astrojs", "mdx");
   const blumeAstro = resolveAstroPackageJson(astroDir);
   await dropStaleDepsLink(join26(outDir, "node_modules"), pkgDir);
-  const outDirAstro = resolvedAstroPath(outDir);
-  const astroCorrect = blumeAstro !== null && outDirAstro === blumeAstro;
-  if (astroCorrect && mdxDir === astroDir) {
+  const outDirHit = resolvedAstroHit(outDir);
+  const astroCorrect = blumeAstro !== null && outDirHit?.pkg === blumeAstro;
+  const walkLandsInDeps = astroCorrect && outDirHit !== null && sameRealDir(outDirHit.modulesDir, astroDir);
+  if (walkLandsInDeps && mdxDir === astroDir) {
     return null;
   }
   if (mdxDir && (mdxDir === astroDir || astroCorrect)) {
     await linkDepsJunction(join26(outDir, "node_modules"), mdxDir);
     return null;
   }
-  return astroConflictWarning(blumeAstro, outDirAstro);
+  return astroConflictWarning(blumeAstro, outDirHit?.pkg ?? null);
 };
 var ISLAND_FRAMEWORK_DEPS = {
   svelte: "@astrojs/svelte",
@@ -15018,6 +15091,7 @@ var generateRuntime = async (project) => {
     tags: overrideTags,
     warnings: overrideWarnings
   } = componentSlots;
+  project.examples = exampleMarkdownLookup(exampleDiscovery.examples);
   const frameworks = new Set([
     ...islandDiscovery.islands.map((island) => island.framework),
     ...exampleDiscovery.examples.map((example) => example.framework),
@@ -16112,6 +16186,8 @@ var eject = async (root) => {
   const askEnabled = config.ai.ask?.enabled ?? false;
   const exportPdf = config.export.pdf;
   const exportEpub = config.export.epub;
+  const examples = await discoverExamples(root, config.examples.source);
+  project.examples = exampleMarkdownLookup(examples.examples);
   const [
     pages,
     needsReactRaw,
@@ -16119,8 +16195,7 @@ var eject = async (root) => {
     userTheme,
     userExamplesCss,
     rawMarkdown,
-    islands,
-    examples
+    islands
   ] = await Promise.all([
     context.pagesRoot ? discoverPages(context.pagesRoot) : Promise.resolve([]),
     detectNeedsReact(root),
@@ -16128,8 +16203,7 @@ var eject = async (root) => {
     context.themeFile ? readFile15(context.themeFile, "utf-8") : Promise.resolve(""),
     readExamplesCss(root, config.examples.css),
     buildRawMarkdown(project),
-    discoverIslands(root),
-    discoverExamples(root, config.examples.source)
+    discoverIslands(root)
   ]);
   const frameworks = new Set([
     ...islands.islands.map((island) => island.framework),
@@ -17299,5 +17373,5 @@ process.on("unhandledRejection", (error) => {
 });
 runMain(main);
 
-//# debugId=7D02660AA9B8797064756E2164756E21
+//# debugId=74F150F28E9B859A64756E2164756E21
 //# sourceMappingURL=index.js.map