blume 2.2.2 → 2.2.3

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # blume
 
+## 2.2.3
+
+### Patch Changes
+
+- 528f95e: The assistant now reads a page's links to other pages (`[Install](./install)`, `[Setup](../setup.md)`, `[Setup](/guides/setup.md)`) as the routes they mean, as the `.md` mirrors, `llms-full.txt`, and MCP `get_page` already did, so the links it cites in an answer land on the page they mean. A link on a translated page to a page that isn't translated yet points at the page the assistant can read. Pages from a remote or CMS source, such as `mdxRemote()`, now get that rewrite on every agent surface too. Before, the assistant read such links as written and could cite `../setup.md`, a link that led nowhere from the answer, and a remote page's links stayed as written on the agent surfaces, though the rendered page and `blume validate` resolved them. A relative link in a raw HTML `<a href>` now points on the agent surfaces where it goes on the rendered page, resolved against the page's URL as the browser resolves it, rather than the way a Markdown link resolves.
+- 87cb8c4: The assistant cites pages as links more reliably on smaller models. Each documentation excerpt it reads, and each `search_docs` and `read_page` result, is now headed by the Markdown link to cite (`## [Page Title](/route)`), and the model is asked to copy that link. A page whose route has a space, a parenthesis, or a percent sign is cited with those characters percent-encoded (`%20`, `%28`, `%29`, `%25`), so its link works too. Before, the heading was `## Page Title (/route)`, and a model that copied it wrote `[Page Title (/route)]`, `[[Page Title (/route)]]`, or `[/route]`, which showed in the answer as raw text instead of a link.
+- e41c71f: Search now keeps words whole whatever Latin letters they hold. Orama's default tokenizer split words at any letter beyond ASCII and a few accented vowels, so Swedish "när" was indexed as "n" and "r" and matched unrelated pages, and German "Prüfung" as "pr" and "fung". Blume now keeps every Latin letter, folding accents the way Orama already folded "café" and spelling ø, ł and ß as o, l and ss, in the default Orama search dialog, the MCP server's `search_docs`, and the assistant. A soft hyphen (`&shy;`) no longer splits the word it sits in, and a result found by folding is highlighted and excerpted at the accented word. ASCII text is tokenized exactly as before.
+- 2a0628c: The language switcher keeps the reader's place: the chosen link carries the current URL fragment.
+- 34b3e0f: Add SEO options for docs that live inside another site: shared JSON-LD entity ids and attribution (`seo.jsonLd`), a default social image in place of generated cards (`seo.og.image`), publication dates from git for pages without a front matter `date` (`seo.datePublished: "git"`), and hreflang alternates in the sitemap (`seo.sitemap: { alternates: true }`). Page JSON-LD now also carries the page's social image and credits its front matter `authors`, and hreflang links leave out `noindex`, hidden, and canonical-elsewhere translations.
+
 ## 2.2.2
 
 ### Patch Changes

package/dist/cli/{chunk-080mfch6.js → chunk-0wt5amrk.js}

@@ -3,7 +3,7 @@ import {
   resolveRuntimeDir,
   resolveProjectContext,
   loadConfig
-} from "./chunk-r5nm9w0c.js";
+} from "./chunk-hwjspffr.js";
 import"./chunk-zccbjcj0.js";
 import {
   commandMeta,
@@ -11,24 +11,24 @@ import {
 } from "./index.js";
 import {
   readDevLock
-} from "./chunk-h0qwdbem.js";
-import"./chunk-k45sq16q.js";
+} from "./chunk-r5ajrw1g.js";
+import"./chunk-0xyedh7k.js";
 import {
   refuseIfEjected
-} from "./chunk-e1n41w9m.js";
-import"./chunk-hktq4j5r.js";
-import"./chunk-zxd5jrgx.js";
-import"./chunk-b680sv30.js";
-import"./chunk-rtvgmg2j.js";
-import"./chunk-j4nfgn2j.js";
+} from "./chunk-1ay3hzn0.js";
+import"./chunk-pxp1y6yz.js";
+import"./chunk-gc7knd2s.js";
+import"./chunk-2f6btenb.js";
+import"./chunk-8h2t2vyj.js";
+import"./chunk-znwhf37a.js";
 import"./chunk-jq5n4avg.js";
-import"./chunk-487b95qy.js";
-import"./chunk-9h8mh2tk.js";
+import"./chunk-88q28zav.js";
+import"./chunk-5f96yq2c.js";
 import {
   prepareProject
-} from "./chunk-t2h8pwy1.js";
-import"./chunk-gwy55cx3.js";
-import"./chunk-q1wwrxzw.js";
+} from "./chunk-9emfspcp.js";
+import"./chunk-426rytg6.js";
+import"./chunk-rc2qk3qx.js";
 
 // src/cli/commands/sync.ts
 import { rm } from "node:fs/promises";
@@ -74,4 +74,4 @@ export {
 };
 
 //# debugId=67B7B6A961A6206764756E2164756E21
-//# sourceMappingURL=chunk-080mfch6.js.map
+//# sourceMappingURL=chunk-0wt5amrk.js.map

package/dist/cli/{chunk-k45sq16q.js → chunk-0xyedh7k.js}

@@ -18,7 +18,7 @@ import {
   distDir,
   adapterRoot,
   deployPlatform
-} from "./chunk-r5nm9w0c.js";
+} from "./chunk-hwjspffr.js";
 import {
   trimChar,
   normalizeBasePath
@@ -1704,6 +1704,7 @@ 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 { resolveLocalizable } from "blume/core/localizable.ts";
 import { resolveSlot } from "blume/components/layout/overrides.ts";
 ${componentImports}
 import data from "blume:data";
@@ -1728,8 +1729,10 @@ export function getStaticPaths() {
       editUrl: route.editUrl,
       entryId: route.entryId,
       fallback: route.fallback,
+      hreflang: route.hreflang,
       indexable: route.indexable,
       lastModified: route.lastModified,
+      published: route.published,
       locale: route.locale,
       monolingual: route.monolingual,
       route: route.path,
@@ -1740,7 +1743,7 @@ export function getStaticPaths() {
   }));
 }
 
-const { entryId, collection, route, title, indexable, editUrl, lastModified, locale, alternates, fallback, monolingual, version, versionAlternates } = Astro.props;
+const { entryId, collection, route, title, indexable, editUrl, lastModified, published, locale, alternates, hreflang, fallback, monolingual, version, versionAlternates } = Astro.props;
 const entry = await getEntry(collection as CollectionKey, entryId);
 if (!entry) {
   return new Response(null, { status: 404 });
@@ -1790,19 +1793,23 @@ const base = data.config.site ? data.config.site.replace(/\\/$/, "") : null;
 const ogPath = data.config.og.enabled
   ? encodeURI(\`/og/\${route === "/" ? "index" : route.slice(1)}.png\`)
   : null;
-// Absolute URLs also carry the deployment base (the page is served under it):
-// \`site + base + path\`. Only absolutize root-relative paths: \`seo.image\` may be
+// Root-relative paths carry the deployment base (the page is served under it),
+// and the site too once it's known: \`site + base + path\`. \`seo.image\` may be
 // an external URL, which passes through verbatim (mirrors PageLayout). An
-// authored \`seo.image\` keeps a base written by hand; the generated card is
-// always mounted under it.
+// authored image keeps a base written by hand; the generated card is always
+// mounted under it.
 const absoluteOg = (path: string, based: (path: string) => string) =>
-  base && path.startsWith("/") ? \`\${base}\${based(path)}\` : path;
-const ogImage = seo.image
-  ? absoluteOg(seo.image, withBase)
+  path.startsWith("/") ? \`\${base ?? ""}\${based(path)}\` : path;
+// The page's own image, else the site's default for its locale.
+const selectedOgImage =
+  seo.image ??
+  (data.config.og.image && resolveLocalizable(data.config.og.image, locale, data.config.i18n?.defaultLocale));
+const ogImage = selectedOgImage
+  ? absoluteOg(selectedOgImage, withBase)
   : ogPath && absoluteOg(ogPath, withMountedBase);
-// Blume's generated card has known dimensions the layout can declare; a user's
-// \`seo.image\` could be any size or format, so it gets none.
-const ogGenerated = !seo.image && Boolean(ogPath);
+// Blume's generated card has known dimensions the layout can declare; an
+// authored image could be any size or format, so it gets none.
+const ogGenerated = !selectedOgImage && Boolean(ogPath);
 
 // X attribution: the site's account, plus a creator the page can claim for
 // itself (a guest post crediting its own author) over the configured default.
@@ -1898,11 +1905,12 @@ const canonical =
       : null);
 const effectiveNoindex = Boolean(seo.noindex) || (archived?.noindex ?? false);
 
+// hreflang names only indexable translations (see \`hreflangAlternates\`).
 const localeAlternates =
   i18n && base
-    ? (alternates ?? []).map((alt) => ({ hreflang: alt.locale, href: absolute(alt.path) }))
+    ? (hreflang ?? []).map((alt) => ({ hreflang: alt.locale, href: absolute(alt.path) }))
     : [];
-const defaultAlt = i18n ? (alternates ?? []).find((alt) => alt.locale === i18n.defaultLocale) : null;
+const defaultAlt = i18n ? (hreflang ?? []).find((alt) => alt.locale === i18n.defaultLocale) : null;
 const xDefault = defaultAlt && base ? absolute(defaultAlt.path) : null;
 
 // \`route\` arrives with \`basePath\` already applied, so the locale segment it
@@ -2062,7 +2070,8 @@ const LayoutComponent = resolveSlot(layoutOverrides.Layout, RootLayout);
   pageType={frontmatter.type}
   apiRail={remarkPluginFrontmatter?.${API_RAIL_KEY} === true}
   pageMode={frontmatter.mode}
-  published={frontmatter.date ?? frontmatter.changelog?.date ?? null}
+  published={frontmatter.date ?? frontmatter.changelog?.date ?? published}
+  authors={frontmatter.authors}
   lastModified={lastModified}
   noindex={effectiveNoindex}
   structuredDataEnabled={data.config.structuredData}
@@ -2092,8 +2101,9 @@ var changelogIndexTemplate = (options) => {
 // Generated by Blume. Do not edit.
 import RootLayout from "blume/components/layout/RootLayout.astro";
 import Changelog from "blume/components/content/Changelog.astro";
-import { withMountedBase } from "blume/components/islands/base-path.ts";
+import { withBase, withMountedBase } from "blume/components/islands/base-path.ts";
 import { resolveSlot } from "blume/components/layout/overrides.ts";
+import { resolveLocalizable } from "blume/core/localizable.ts";
 import { layoutOverrides } from "../generated/components.ts";
 import data from "blume:data";
 
@@ -2115,11 +2125,17 @@ const base = data.config.site ? data.config.site.replace(/\\/$/, "") : null;
 const basedRoute = withMountedBase("/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.
+// The site's default image, else 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 defaultOgImage =
+  data.config.og.image && resolveLocalizable(data.config.og.image, htmlLang, i18n?.defaultLocale);
 const ogPath = data.config.og.enabled ? withMountedBase("/og/changelog.png") : null;
-const ogImage = ogPath && base ? base + ogPath : ogPath;
+const ogImage = defaultOgImage
+  ? defaultOgImage.startsWith("/")
+    ? (base ?? "") + withBase(defaultOgImage)
+    : defaultOgImage
+  : ogPath && base ? base + ogPath : ogPath;
 
 // The page chrome (h1, title, description) comes from the translatable
 // \`changelog\` group, which carries the \`changelog\` config's title and
@@ -2167,7 +2183,7 @@ const LayoutComponent = resolveSlot(layoutOverrides.Layout, RootLayout);
   searchEnabled={data.config.search.enabled}
   indexable={true}
   ogImage={ogImage}
-  ogGenerated={Boolean(ogImage)}
+  ogGenerated={!defaultOgImage && Boolean(ogImage)}
   x={data.config.x}
   canonical={canonical}
   exportPdf={${options.exportPdf}}
@@ -2692,5 +2708,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=89A234A45FD2077E64756E2164756E21
-//# sourceMappingURL=chunk-k45sq16q.js.map
+//# debugId=56680ACE26D883A964756E2164756E21
+//# sourceMappingURL=chunk-0xyedh7k.js.map