npm - blume - Versions diffs - 0.6.0 → 0.6.2 - Mend

blume 0.6.0 → 0.6.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (65) hide show

package/dist/cli/index.js +6070 -5718
package/dist/cli/index.js.map +41 -40
package/dist/types/core/config-input.d.ts +749 -0
package/dist/types/core/config.d.ts +126 -3
package/dist/types/core/schema.d.ts +10 -27
package/dist/types/core/sources/types.d.ts +6 -0
package/dist/types/index.d.ts +2 -1
package/docs/advanced/changelog.mdx +10 -2
package/docs/configuration/index.mdx +0 -2
package/docs/content/syntax.mdx +4 -8
package/package.json +1 -1
package/src/astro/generate.ts +59 -24
package/src/astro/markdown-negotiation.ts +12 -3
package/src/astro/templates.ts +94 -12
package/src/cli/commands/build.ts +26 -1
package/src/cli/commands/dev.ts +30 -14
package/src/cli/commands/doctor.ts +35 -7
package/src/cli/commands/sync.ts +14 -2
package/src/cli/dev-lock.ts +40 -10
package/src/cli/env.ts +5 -1
package/src/components/content/Update.astro +12 -2
package/src/components/content/changelog-element.ts +62 -0
package/src/components/islands/ask-ai.tsx +3 -1
package/src/components/islands/hooks.ts +5 -1
package/src/components/layout/Header.astro +10 -2
package/src/components/layout/NavSelector.astro +5 -3
package/src/components/layout/PageLayout.astro +2 -1
package/src/components/layout/ReferenceLayout.astro +1 -0
package/src/components/layout/RootLayout.astro +47 -10
package/src/components/layout/Search.astro +8 -3
package/src/components/layout/nav-utils.ts +7 -3
package/src/core/config-input.ts +923 -0
package/src/core/config.ts +126 -3
package/src/core/i18n.ts +6 -5
package/src/core/links.ts +16 -1
package/src/core/meta.ts +112 -52
package/src/core/navigation.ts +15 -5
package/src/core/project-graph.ts +68 -2
package/src/core/schema.ts +8 -14
package/src/core/sources/assets.ts +21 -5
package/src/core/sources/cache.ts +19 -1
package/src/core/sources/github-releases.ts +9 -3
package/src/core/sources/mdx-remote.ts +14 -4
package/src/core/sources/normalize.ts +13 -1
package/src/core/sources/notion.ts +43 -7
package/src/core/sources/resolve.ts +44 -1
package/src/core/sources/sanity.ts +9 -3
package/src/core/sources/types.ts +6 -0
package/src/deploy/adapter-output.ts +82 -0
package/src/deploy/rss.ts +3 -1
package/src/index.ts +1 -1
package/src/markdown/code-title.ts +11 -4
package/src/markdown/index.ts +28 -30
package/src/markdown/math.ts +3 -2
package/src/markdown/package-commands.ts +13 -0
package/src/og/card.ts +3 -1
package/src/openapi/model.ts +2 -1
package/src/openapi/parse.ts +9 -1
package/src/openapi/references.ts +11 -1
package/src/openapi/render-mdx.ts +30 -3
package/src/openapi/source.ts +3 -1
package/src/registry/eject.ts +21 -14
package/src/search/documents.ts +4 -1
package/src/theme/entry.ts +10 -3
package/src/theme/icons.ts +7 -11

package/src/components/layout/NavSelector.astro CHANGED Viewed

@@ -5,6 +5,7 @@
 // <details>/<summary> like the language switcher.
 import type { NavSelector } from "../../core/types.ts";
 import Icon from "../Icon.astro";
+import { isUnderPath } from "./nav-utils.ts";
 interface Props {
   selector: NavSelector;
@@ -13,12 +14,13 @@ interface Props {
 const { selector, route } = Astro.props;
-// The active item is the deepest path that prefixes the current route, falling
-// back to the first item so the summary always shows something meaningful.
+// The active item is the deepest path the current route sits under (on a path
+// boundary, so `/api` never claims `/api-reference` routes), falling back to
+// the first item so the summary always shows something meaningful.
 const active =
   selector.items.find((item) => item.path === route) ??
   selector.items
-    .filter((item) => route.startsWith(item.path))
+    .filter((item) => isUnderPath(route, item.path))
     .toSorted((a, b) => b.path.length - a.path.length)[0] ??
   selector.items[0];

package/src/components/layout/PageLayout.astro CHANGED Viewed

@@ -32,6 +32,7 @@ import Favicon from "./Favicon.astro";
 import Fonts from "./Fonts.astro";
 import { bannerInitScript, themeInitScript } from "./head-scripts.ts";
 import Header from "./Header.astro";
+import { isUnderPath } from "./nav-utils.ts";
 interface Props {
   site: { title: string; description?: string };
@@ -209,7 +210,7 @@ const bannerScript = banner?.dismissible
                     <a
                       aria-current={
                         route === tab.path ||
-                        (tab.path !== "/" && route.startsWith(tab.path))
+                        (tab.path !== "/" && isUnderPath(route, tab.path))
                           ? "page"
                           : undefined
                       }

package/src/components/layout/ReferenceLayout.astro CHANGED Viewed

@@ -92,6 +92,7 @@ const bannerScript = banner?.dismissible
   <body class="bg-background font-sans text-foreground antialiased">
     <Banner banner={banner} />
     <Header
+      hasDrawer={false}
       hasSidebar={false}
       logo={logo}
       navigation={navigation}

package/src/components/layout/RootLayout.astro CHANGED Viewed

@@ -23,6 +23,7 @@ import {
   findBreadcrumbs,
   flattenPages,
   getPagination,
+  isUnderPath,
   sidebarForRoute,
 } from "./nav-utils.ts";
 import NavTree from "./NavTree.astro";
@@ -126,6 +127,12 @@ interface Props {
   clientData?: BlumeClientData | null;
   /** Table-of-contents settings (`toc` config): visibility + heading range. */
   toc?: { enabled: boolean; maxLevel: number; minLevel: number };
+  /**
+   * Content-column preset. `"bare"` (the generated changelog index) drops both
+   * the sidebar and the table of contents and centers a single wide column;
+   * everything else uses the standard sidebar + content + TOC grid.
+   */
+  contentLayout?: "default" | "bare";
 }
 const {
@@ -169,6 +176,7 @@ const {
   layout = {},
   clientData,
   toc = { enabled: true, maxLevel: 3, minLevel: 2 },
+  contentLayout = "default",
 } = Astro.props;
 // Serialized once for island hooks; `<` escaped so content can't break the tag.
@@ -205,16 +213,28 @@ const searchLocale =
 // API operation pages own a two-column body (docs + request panel) and their own
 // right rail, so they drop the table of contents and widen the content column.
 const isApiOperation = pageType === "openapi-operation";
+// A "bare" page (the changelog index) is a standalone landing: no sidebar, no
+// TOC, just a wider centered column of content.
+const isBare = contentLayout === "bare";
+const showSidebar = !isBare;
+const showToc = !(isApiOperation || isBare);
 const tocHeadings =
-  toc.enabled && !isApiOperation
+  toc.enabled && showToc
     ? headings.filter((h) => h.depth >= toc.minLevel && h.depth <= toc.maxLevel)
     : [];
-const gridClass = isApiOperation
-  ? "lg:grid-cols-[17.5rem_minmax(0,1fr)]"
-  : "lg:grid-cols-[17.5rem_minmax(0,1fr)] xl:grid-cols-[17.5rem_minmax(0,1fr)_17.5rem]";
-const articleClass = isApiOperation
-  ? "prose max-w-none"
-  : "prose mx-auto max-w-[42rem]";
+let gridClass =
+  "lg:grid-cols-[17.5rem_minmax(0,1fr)] xl:grid-cols-[17.5rem_minmax(0,1fr)_17.5rem]";
+if (isBare) {
+  gridClass = "";
+} else if (isApiOperation) {
+  gridClass = "lg:grid-cols-[17.5rem_minmax(0,1fr)]";
+}
+let articleClass = "prose mx-auto max-w-[42rem]";
+if (isBare) {
+  articleClass = "prose mx-auto max-w-[54rem]";
+} else if (isApiOperation) {
+  articleClass = "prose max-w-none";
+}
 const pageTitle = page.title ? `${page.title} - ${site.title}` : site.title;
 const description = page.description ?? site.description;
@@ -347,6 +367,8 @@ const bannerScript = banner?.dismissible
       class:list={["mx-auto grid grid-cols-1 items-start", gridClass]}
       data-blume-doc-grid
     >
+      {
+        showSidebar && (
       <aside
         aria-label="Primary"
         class="fixed top-[var(--blume-drawer-top,4rem)] start-0 z-[35] h-[calc(100dvh-var(--blume-drawer-top,4rem))] w-64 max-w-[80vw] -translate-x-[105%] overflow-y-auto border-border border-e bg-background px-5 pt-4 pb-6 transition-transform rtl:translate-x-[105%] [:where([data-blume-nav-open])_&]:translate-x-0! lg:sticky lg:top-16 lg:z-auto lg:h-[calc(100dvh-4rem)] lg:w-auto lg:max-w-none lg:translate-x-0! lg:border-e-0 lg:bg-transparent lg:px-4"
@@ -406,7 +428,7 @@ const bannerScript = banner?.dismissible
                     <a
                       aria-current={
                         page.route === tab.path ||
-                        (tab.path !== "/" && page.route.startsWith(tab.path))
+                        (tab.path !== "/" && isUnderPath(page.route, tab.path))
                           ? "page"
                           : undefined
                       }
@@ -438,6 +460,8 @@ const bannerScript = banner?.dismissible
           }
         </nav>
       </aside>
+        )
+      }
       <main class="px-6 pt-6 pb-10 lg:px-8 xl:px-10" id="blume-content">
         <BreadcrumbsSlot crumbs={crumbs} wide={isApiOperation} />
         <TableOfContentsSlot
@@ -469,7 +493,7 @@ const bannerScript = banner?.dismissible
         }
       </main>
       {
-        !isApiOperation && (
+        showToc && (
           <aside
             aria-label={strings.toc.title}
             class="sticky top-16 hidden h-[calc(100dvh-4rem)] overflow-y-auto px-4 pt-6 pb-10 text-sm xl:block"
@@ -578,7 +602,20 @@ const bannerScript = banner?.dismissible
         button.setAttribute("aria-label", "Copy code");
         button.innerHTML = svg("copy");
         button.addEventListener("click", async () => {
-          const text = pre.querySelector("code")?.textContent ?? "";
+          const code = pre.querySelector("code");
+          let text = code?.textContent ?? "";
+          // Twoslash nests each hover popup's type signature and docs inside
+          // the <code>; copying textContent verbatim would interleave them
+          // with the source. Strip the popups from a clone first.
+          if (code?.querySelector(".twoslash-popup-container")) {
+            const clone = code.cloneNode(true) as HTMLElement;
+            for (const popup of clone.querySelectorAll(
+              ".twoslash-popup-container"
+            )) {
+              popup.remove();
+            }
+            text = clone.textContent ?? "";
+          }
           try {
             await navigator.clipboard.writeText(text);
           } catch {

package/src/components/layout/Search.astro CHANGED Viewed

@@ -133,7 +133,7 @@ const kbd = "rounded border border-border bg-muted px-1 py-0.5 font-mono";
   <script
     data-blume-search-popular
     is:inline
-    set:html={JSON.stringify(popular)}
+    set:html={JSON.stringify(popular).replaceAll("<", "\\u003c")}
     type="application/json"
   />
@@ -190,6 +190,7 @@ const kbd = "rounded border border-border bg-muted px-1 py-0.5 font-mono";
       selectables: Selectable[] = [];
       selectedIndex = -1;
       activeSection: string | null = null;
+      renderGeneration = 0;
       previewOn = true;
       devOnlyMsg = "Search is available in the production build.";
       noResultsMsg = "No results found.";
@@ -339,6 +340,8 @@ const kbd = "rounded border border-border bg-muted px-1 py-0.5 font-mono";
       async render() {
         const query = this.input.value.trim();
+        this.renderGeneration += 1;
+        const generation = this.renderGeneration;
         this.selectables = [];
         this.selectedIndex = -1;
         this.results.replaceChildren();
@@ -364,8 +367,10 @@ const kbd = "rounded border border-border bg-muted px-1 py-0.5 font-mono";
           locale: localeFilter,
           section: this.activeSection ?? undefined,
         });
-        // A later keystroke may have superseded this query mid-await.
-        if (this.input.value.trim() !== query) {
+        // Any newer render — a keystroke, a section pill, a locale toggle —
+        // supersedes this one mid-await, even for the same query text;
+        // appending the stale hits would duplicate rows and desync selection.
+        if (generation !== this.renderGeneration) {
           return;
         }

package/src/components/layout/nav-utils.ts CHANGED Viewed

@@ -71,9 +71,13 @@ export const findBreadcrumbs = (nodes: NavNode[], route: string): Crumb[] => {
   return search(nodes, []) ?? [];
 };
-/** Whether `route` is the section root `base` or nested beneath it. */
-const isUnderPath = (route: string, base: string): boolean =>
-  route === base || route.startsWith(`${base}/`);
+/**
+ * Whether `route` is the section root `base` or nested beneath it. Requires a
+ * path boundary, so `/api-reference` is not under `/api`. The root `/` spans
+ * every route.
+ */
+export const isUnderPath = (route: string, base: string): boolean =>
+  base === "/" || route === base || route.startsWith(`${base}/`);
 /**
  * The tab whose `path` is the longest prefix of `route`, mirroring the header's