blume 1.5.0 → 1.5.1

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # blume
 
+## 1.5.1
+
+### Patch Changes
+
+- ca28fb8: Generate an Open Graph card for the changelog index. The `/changelog` page previously shipped no `og:image` (and fell back to X's compact summary card); it now gets the same generated card every other page has, served at `/og/changelog.png`.
+- ca28fb8: Stop doubling the site title in the changelog index's document title. The page passed "{site title} {Changelog}" to a layout that suffixes "- {site title}" itself, producing titles like "Acme Changelog - Acme"; it now reads "Changelog - Acme".
+- 8db1ecb: The default display font is now Inter, matching the body font — default sites download one text family instead of two (Inter Tight's files alone were ~190 KB per page). To keep the tightened display look, headings now get `letter-spacing: -0.05em` from the theme itself, which also means any font you configure for `display` reads correctly at heading sizes instead of depending on tracking built into the font. Inter Tight remains available as the `inter-tight` slug.
+- ca28fb8: Let a user-supplied `ogImage` on `PageLayout` declare its alt text and pixel size via the new `ogImageAlt` and `ogImageSize` props, emitted as `og:image:alt` / `og:image:width` / `og:image:height` — the metadata Blume's generated cards already declare automatically.
+- ca28fb8: Emit schema.org JSON-LD from `PageLayout`, so custom pages — most importantly a custom home page — carry the same `WebSite` structured-data graph the docs pages do. On by default; pass `structuredDataEnabled={false}` to opt a page out.
+- ca28fb8: Keep the trailing slash on the home page's canonical, `og:url`, and hreflang URLs (`https://site/` instead of `https://site`), so they byte-match the sitemap's `<loc>` for the root route.
+- ca28fb8: Warn when `lastModified` runs in a shallow git clone. CI platforms usually check out limited history, which silently dropped most git-derived dates — sitemap `<lastmod>` and "Last updated" stamps vanished in production while working locally. The build now emits a `BLUME_SHALLOW_GIT_HISTORY` warning pointing at the fix (`VERCEL_DEEP_CLONE=true` on Vercel, `fetch-depth: 0` for actions/checkout).
+- bad025f: Smooth out page navigation: every link now prefetches on hover/viewport, and same-origin navigations opt into cross-document view transitions in supporting browsers, replacing the hard flash between pages with a crossfade. Respects `prefers-reduced-motion`.
+- 8db1ecb: Preload only the font weights above-the-fold text actually renders in (body 400/500, display 500/600, mono 400) instead of every configured face. On a default site this cuts the per-page font preloads from ten files (~260 KB) to a handful (~50 KB), bandwidth that was competing with the critical CSS and pushing out mobile LCP. All other faces still load on demand through their `@font-face` rules with `font-display: swap`.
+- ca28fb8: Redirect trailing-slash URLs to their slashless twins on Vercel with a 308. `/docs/` and `/docs` previously both served 200 as duplicate URLs; the routing config now collapses the slashed form onto the canonical slashless one (the root `/` is untouched).
+
 ## 1.5.0
 
 ### Minor Changes

package/README.md

@@ -49,18 +49,22 @@ Blume works with any package manager and never requires you to set up Astro or T
 
 ## CLI
 
-| Command            | Description                                           |
-| ------------------ | ----------------------------------------------------- |
-| `blume init [dir]` | Scaffold a project (interactive by default).          |
-| `blume dev`        | Start the dev server with hot reload.                 |
-| `blume build`      | Build the static (or server) site.                    |
-| `blume preview`    | Preview the last build.                               |
-| `blume add <item>` | Install a source component from the registry.         |
-| `blume sync`       | Re-fetch remote content sources and regenerate.       |
-| `blume eject`      | Promote the runtime into a standalone Astro app.      |
-| `blume check`      | Type-check the docs site with `astro check`.          |
-| `blume validate`   | Validate internal, anchor, asset, and external links. |
-| `blume doctor`     | Diagnose config and content problems.                 |
+| Command | Description |
+| --- | --- |
+| `blume init [dir]` | Scaffold a project (interactive by default). |
+| `blume dev` | Start the dev server with hot reload. |
+| `blume build` | Build the static (or server) site. |
+| `blume preview` | Preview the last build. |
+| `blume add <item>` | Install a source component from the registry. |
+| `blume sync` | Re-fetch remote content sources and regenerate. |
+| `blume eject` | Promote the runtime into a standalone Astro app. |
+| `blume check` | Type-check the docs site with `astro check`. |
+| `blume validate` | Validate internal, anchor, asset, and external links. |
+| `blume doctor` | Diagnose config and content problems. |
+| `blume audit` | Audit the built site for SEO and health issues. |
+| `blume eval` | Test the docs: an agent answers your questions using only the documentation. |
+| `blume translate` | Translate docs into the configured locales with a local agent CLI. |
+| `blume version [id]` | Freeze the current docs as an archived version (no id lists configured versions). |
 
 See the [CLI reference](https://useblume.dev/docs/reference/cli) for every flag.
 

package/dist/cli/index.js

@@ -3607,7 +3607,47 @@ ${lines.join(`
 }
 ` : "";
 };
-var configuredCssVars = (fonts) => buildFontEntries(fonts).map((entry) => entry.cssVariable);
+var PRELOAD_WEIGHTS = {
+  body: [400, 500],
+  display: [500, 600],
+  mono: [400]
+};
+var entryWeights = (entry) => entry.kind === "remote" ? entry.weights : entry.variants.map((variant) => variant.weight);
+var preloadWeightsFor = (slot, entry) => {
+  const preferred = PRELOAD_WEIGHTS[slot];
+  const weights = entryWeights(entry);
+  const numeric = weights.filter((weight) => typeof weight === "number");
+  const hits = preferred.filter((weight) => numeric.includes(weight));
+  if (hits.length > 0) {
+    return hits;
+  }
+  return numeric.length === weights.length ? numeric : preferred;
+};
+var configuredFonts = (fonts) => {
+  if (!fonts) {
+    return [];
+  }
+  const heads = new Map;
+  for (const slot of SLOTS) {
+    const value = fonts[slot];
+    if (value === undefined) {
+      continue;
+    }
+    const entry = resolveFontValue(slot, value);
+    if (!entry) {
+      continue;
+    }
+    const weights = heads.get(entry.cssVariable) ?? new Set;
+    for (const weight of preloadWeightsFor(slot, entry)) {
+      weights.add(weight);
+    }
+    heads.set(entry.cssVariable, weights);
+  }
+  return [...heads].map(([cssVariable, weights]) => ({
+    cssVariable,
+    preloadWeights: [...weights].toSorted((a, b) => a - b)
+  }));
+};
 
 // src/astro/templates.ts
 var WORKSPACE_MARKERS = [
@@ -3936,6 +3976,11 @@ ${userConfigSetup}export default defineConfig({
     },
   },
   devToolbar: { enabled: false },
+  // Navigations are full document loads (no client router), so the next page's
+  // HTML is fetched on hover/viewport to hide the request latency behind the
+  // user's intent. Pairs with the cross-document view-transition rule in the
+  // theme sheet, which smooths the swap itself.
+  prefetch: { prefetchAll: true },
   vite: {
     plugins: [tailwindcss(), prerenderDepsPlugin(), serverAppResolvePlugin()],
     // Everything hydration can reach must be part of the dev dep optimizer's
@@ -4444,7 +4489,7 @@ export function GET({ props }: { props: { section: string } }) {
   });
 }
 `;
-var ogEndpointTemplate = (customRoutes = [], og = {}) => `// Generated by Blume. Do not edit.
+var ogEndpointTemplate = (customRoutes = [], og = {}, includeChangelog = false) => `// Generated by Blume. Do not edit.
 import { renderOgImage } from "blume/og";
 import type { OgFont, OgFontFamilies } from "blume/og";
 import data from "blume:data";
@@ -4479,7 +4524,10 @@ export function getStaticPaths() {
   }
   for (const route of data.routes) {
     add(route.path === "/" ? "index" : route.path.slice(1), route.title);
-  }
+  }${includeChangelog ? `
+  // The generated changelog index is not a content route, so it needs its own
+  // card. Added last: a custom page or content route owning /changelog wins.
+  add("changelog", data.ui.changelog?.title ?? "Changelog");` : ""}
   return paths;
 }
 
@@ -4753,10 +4801,9 @@ const contentLocale =
 const contentDir = i18n
   ? (i18n.locales.find((l) => l.code === contentLocale)?.dir ?? "ltr")
   : "ltr";
-const absolute = (path: string) => {
-  const p = withBase(path);
-  return base + (p === "/" ? "" : p);
-};
+// The root route keeps its trailing slash (\`https://site/\`) so canonical and
+// hreflang URLs byte-match the sitemap's <loc> for the home page.
+const absolute = (path: string) => base + withBase(path);
 
 // An archived page defaults its canonical to the same page in the latest docs
 // when that page still exists — search engines treat the live page as
@@ -4767,7 +4814,7 @@ const canonical =
   (archived && archived.canonical === "latest" && latestVersionAlt && base
     ? absolute(latestVersionAlt.path)
     : base
-      ? \`\${base}\${basedRoute === "/" ? "" : encodeURI(basedRoute)}\`
+      ? \`\${base}\${basedRoute === "/" ? "/" : encodeURI(basedRoute)}\`
       : null);
 const effectiveNoindex = Boolean(seo.noindex) || (archived?.noindex ?? false);
 
@@ -5061,6 +5108,12 @@ const base = data.config.site ? data.config.site.replace(/\\/$/, "") : null;
 const basedRoute = withBase("/changelog");
 const canonical = base ? base + basedRoute : null;
 
+// The generated OG card for this route (the /og endpoint emits it alongside
+// the content-route cards), absolutized like the catch-all's so crawlers get
+// a full URL when the site is known.
+const ogPath = data.config.og.enabled ? withBase("/og/changelog.png") : null;
+const ogImage = ogPath && base ? base + ogPath : ogPath;
+
 // The page chrome (h1, title, description) comes from the same translatable
 // \`changelog\` group as the reveal button; optional chaining tolerates a
 // not-yet-regenerated data snapshot from before these keys existed.
@@ -5068,7 +5121,10 @@ const changelogTitle = data.ui.changelog?.title ?? "Changelog";
 const changelogDescription =
   data.ui.changelog?.description ??
   "Product updates, new features, and fixes from every release.";
-const pageTitle = data.config.title + " " + changelogTitle;
+// 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").
+const pageTitle = changelogTitle;
 
 const LayoutComponent = resolveSlot(layoutOverrides.Layout, RootLayout);
 ---
@@ -5100,7 +5156,8 @@ const LayoutComponent = resolveSlot(layoutOverrides.Layout, RootLayout);
   fontCssVars={data.fontCssVars}
   searchEnabled={data.config.search.enabled}
   indexable={true}
-  ogImage={null}
+  ogImage={ogImage}
+  ogGenerated={Boolean(ogImage)}
   x={data.config.x}
   canonical={canonical}
   exportPdf={${options.exportPdf}}
@@ -9861,7 +9918,7 @@ var themeConfigSchema = z2.strictObject({
   backgroundImage: perModeValueSchema,
   fonts: z2.strictObject({
     body: fontValueSchema.default("inter"),
-    display: fontValueSchema.default("inter-tight"),
+    display: fontValueSchema.default("inter"),
     mono: fontValueSchema.default("ibm-plex-mono")
   }).prefault({}),
   layout: z2.enum(["sidebar"]).default("sidebar"),
@@ -11458,6 +11515,26 @@ var gitLastModifiedTimes = (root, contentRoots, sourcePaths) => {
     return new Map;
   }
 };
+var isShallowGitRepository = (root) => {
+  try {
+    return execFileSync("git", ["-C", root, "rev-parse", "--is-shallow-repository"], { encoding: "utf-8", stdio: ["ignore", "pipe", "ignore"] }).trim() === "true";
+  } catch {
+    return false;
+  }
+};
+var lastModifiedShallowWarning = (root, undatedCount) => {
+  if (undatedCount === 0 || !isShallowGitRepository(root)) {
+    return [];
+  }
+  return [
+    {
+      code: "BLUME_SHALLOW_GIT_HISTORY",
+      message: `lastModified is on, but this build runs in a shallow git clone, so ${undatedCount} page(s) have no git-derived date — their sitemap <lastmod> and "Last updated" stamps are omitted.`,
+      severity: "warning",
+      suggestion: "Fetch full history in CI: set the VERCEL_DEEP_CLONE=true environment variable on Vercel, or fetch-depth: 0 for actions/checkout."
+    }
+  ];
+};
 
 // src/core/manifest.ts
 var versionAlternateKey = (versionKey, locale) => `${versionKey}\x00${locale}`;
@@ -14029,6 +14106,7 @@ var scanProject = async (root, options = {}) => {
   } = normalizeLoadedEntries(loaded, config);
   const pages = mode === "build" && !preview ? allPages.filter((page) => !page.meta.draft) : allPages;
   const lastModified = resolveLastModifiedConfig(config.lastModified);
+  const lastModifiedWarnings = [];
   if (lastModified.enabled && lastModified.source === "git") {
     const fsPaths = pages.map((page) => page.sourcePath).filter((path) => path !== undefined);
     const contentRoots = sources.flatMap((source) => source.staged || !source.contentRoot ? [] : [source.contentRoot]);
@@ -14038,6 +14116,8 @@ var scanProject = async (root, options = {}) => {
         page.lastModified = gitTimes.get(page.sourcePath);
       }
     }
+    const undated = pages.filter((page) => page.sourcePath && !page.lastModified).length;
+    lastModifiedWarnings.push(...lastModifiedShallowWarning(context.root, undated));
   }
   const graph = buildContentGraph(pages, {
     basePath: config.basePath,
@@ -14059,7 +14139,8 @@ var scanProject = async (root, options = {}) => {
       ...entryIdDiagnostics(pages, resolveDocsCollection(config, context).base),
       ...graph.diagnostics,
       ...i18nWarnings,
-      ...versionWarnings
+      ...versionWarnings,
+      ...lastModifiedWarnings
     ],
     droppedPages,
     graph,
@@ -15818,12 +15899,14 @@ var buildNegotiationRoutes = (routePaths, homeTokens) => {
   return { headerRoutes, rewriteRoutes };
 };
 var HOME_SRC = "^/$";
-var isNegotiationRoute = (route) => route.has?.some((condition) => condition.value === ACCEPT_MARKDOWN_HEADER_VALUE) === true || route.continue === true && route.headers?.vary === "Accept" && isString6(route.src) && Object.keys(route).length === 3 || route.continue === true && isString6(route.headers?.link) && route.src === HOME_SRC && Object.keys(route).length === 3;
+var TRAILING_SLASH_REDIRECT = {
+  headers: { Location: "/$1" },
+  src: "^/(.+)/$",
+  status: 308
+};
+var isNegotiationRoute = (route) => route.has?.some((condition) => condition.value === ACCEPT_MARKDOWN_HEADER_VALUE) === true || route.continue === true && route.headers?.vary === "Accept" && isString6(route.src) && Object.keys(route).length === 3 || route.continue === true && isString6(route.headers?.link) && route.src === HOME_SRC && Object.keys(route).length === 3 || route.status === TRAILING_SLASH_REDIRECT.status && route.src === TRAILING_SLASH_REDIRECT.src;
 var injectNegotiationRoutes = (configText, routePaths, homeLinkHeader, contentTypeOverrides, homeTokens) => {
   const overrideEntries = Object.entries(contentTypeOverrides ?? {});
-  if (routePaths.length === 0 && !homeLinkHeader && overrideEntries.length === 0) {
-    return null;
-  }
   let config;
   try {
     config = JSON.parse(configText);
@@ -15849,7 +15932,7 @@ var injectNegotiationRoutes = (configText, routePaths, homeLinkHeader, contentTy
       src: HOME_SRC
     });
   }
-  routes.splice(filesystemIndex, 0, ...headerRoutes, ...rewriteRoutes);
+  routes.splice(filesystemIndex, 0, ...headerRoutes, ...rewriteRoutes, TRAILING_SLASH_REDIRECT);
   config.routes = routes;
   return `${JSON.stringify(config, null, "\t")}
 `;
@@ -17319,7 +17402,11 @@ ${THEME_MAPPING}
     scroll-padding-top: 4.5rem;
     text-rendering: optimizeLegibility;
   }
-  /* Headings use the display font (defaults to the body font when unset). */
+  /* Headings use the display font (defaults to the body font when unset).
+     The tightened tracking is part of the theme, not the font: display-tuned
+     families bake it into their metrics, but a text family promoted to
+     headings (including the Inter default) reads loose without it. -0.05em
+     was matched visually against Inter Tight, the previous display default. */
   h1,
   h2,
   h3,
@@ -17327,6 +17414,7 @@ ${THEME_MAPPING}
   h5,
   h6 {
     font-family: var(--font-display);
+    letter-spacing: -0.05em;
   }
   :focus-visible {
     outline: 2px solid var(--blume-accent);
@@ -17347,6 +17435,22 @@ ${THEME_MAPPING}
   }
 }
 
+/* Same-origin navigations are full document loads (no client router); opting
+   into cross-document view transitions has the browser crossfade between the
+   old and new page instead of hard-swapping, in browsers that support it.
+   Pairs with the prefetch option in the generated Astro config. */
+@view-transition {
+  navigation: auto;
+}
+
+@media (prefers-reduced-motion: reduce) {
+  ::view-transition-group(*),
+  ::view-transition-old(*),
+  ::view-transition-new(*) {
+    animation: none !important;
+  }
+}
+
 /* Code reads left-to-right regardless of page direction; only the surrounding
    chrome mirrors for RTL. Inline code is isolated so LTR identifiers don't
    disturb the bidi flow of right-to-left prose. */
@@ -17382,9 +17486,10 @@ ${THEME_MAPPING}
   line-height: 1.7;
 }
 
+/* No letter-spacing here: prose headings inherit the base h1-h6 rule's
+   display tracking, same as headings outside the prose column. */
 .prose :where(h1, h2, h3, h4) {
   font-weight: 500;
-  letter-spacing: 0;
 }
 
 /* A heading can carry one long unbreakable token — an OpenAPI operation's title
@@ -18793,7 +18898,7 @@ var buildRuntimeData = (project) => {
       href: feed.path,
       title: feed.title
     })),
-    fontCssVars: configuredCssVars(config.theme.fonts),
+    fontCssVars: configuredFonts(config.theme.fonts),
     navigation: withRepoUrl(graph.navigation),
     navigationByLocale,
     navigationByVersion: Object.fromEntries(Object.entries(graph.navigationByVersion).map(([id2, byLocale]) => [
@@ -18987,6 +19092,7 @@ var generateRuntime = async (project) => {
   const needsSvelte = frameworks.has("svelte");
   const reactCompilerPath = resolveReactCompiler(config, needsReact);
   const ogRoutes = customOgRoutes(pages, config.title, config.seo.og.titles);
+  const changelogIndex = hasGeneratedChangelog(project, pages);
   const mcp = planMcp(project, srcDir, pages);
   pages.push(...mcp.discoveryPages);
   const hasStaged = staged.size > 0;
@@ -19056,9 +19162,9 @@ var generateRuntime = async (project) => {
     writeMcpFiles(project, mcp, write)
   ]);
   if (config.seo.og.enabled) {
-    await write(join28(srcDir, "pages", "og", "[...slug].png.ts"), ogEndpointTemplate(ogRoutes, projectOgFonts(project)));
+    await write(join28(srcDir, "pages", "og", "[...slug].png.ts"), ogEndpointTemplate(ogRoutes, projectOgFonts(project), changelogIndex));
   }
-  if (hasGeneratedChangelog(project, pages)) {
+  if (changelogIndex) {
     await write(join28(srcDir, "pages", "changelog.astro"), changelogIndexTemplate({
       exportEpub,
       exportPdf,
@@ -19120,7 +19226,7 @@ var generateRuntime = async (project) => {
     ...pages.map((page) => page.pattern),
     ...referenceRoutes(config)
   ]);
-  if (hasGeneratedChangelog(project, pages)) {
+  if (changelogIndex) {
     navTargetRoutes.add("/changelog");
   }
   warnings.push(...[
@@ -23753,5 +23859,5 @@ process.on("unhandledRejection", (error) => {
 });
 runMain(main);
 
-//# debugId=6377B095BFD3F5AE64756E2164756E21
+//# debugId=A01DCE54DD00393164756E2164756E21
 //# sourceMappingURL=index.js.map