npm - blume - Versions diffs - 1.6.5 → 1.7.0 - Mend

blume 1.6.5 → 1.7.0

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 (179) hide show

package/CHANGELOG.md +39 -0
package/bin/blume.mjs +3 -2
package/dist/cli/chunk-0qhq7b8q.js +111 -0
package/dist/cli/chunk-0qhq7b8q.js.map +11 -0
package/dist/cli/chunk-18tjv4f7.js +96 -0
package/dist/cli/chunk-18tjv4f7.js.map +10 -0
package/dist/cli/chunk-27gtm2ym.js +69 -0
package/dist/cli/chunk-27gtm2ym.js.map +11 -0
package/dist/cli/chunk-2aj8ddew.js +72 -0
package/dist/cli/chunk-2aj8ddew.js.map +10 -0
package/dist/cli/chunk-3r94j3tc.js +221 -0
package/dist/cli/chunk-3r94j3tc.js.map +10 -0
package/dist/cli/chunk-4trphnvy.js +102 -0
package/dist/cli/chunk-4trphnvy.js.map +11 -0
package/dist/cli/chunk-4xyggvgf.js +21 -0
package/dist/cli/chunk-4xyggvgf.js.map +10 -0
package/dist/cli/chunk-5d4q7121.js +4064 -0
package/dist/cli/chunk-5d4q7121.js.map +40 -0
package/dist/cli/chunk-5hs6gb7n.js +32 -0
package/dist/cli/chunk-5hs6gb7n.js.map +10 -0
package/dist/cli/chunk-6kzzpsx8.js +26 -0
package/dist/cli/chunk-6kzzpsx8.js.map +10 -0
package/dist/cli/chunk-8gnpdsn1.js +952 -0
package/dist/cli/chunk-8gnpdsn1.js.map +12 -0
package/dist/cli/chunk-9qs6acpw.js +176 -0
package/dist/cli/chunk-9qs6acpw.js.map +10 -0
package/dist/cli/chunk-agy5rzxy.js +2453 -0
package/dist/cli/chunk-agy5rzxy.js.map +15 -0
package/dist/cli/chunk-bcy492zc.js +16 -0
package/dist/cli/chunk-bcy492zc.js.map +10 -0
package/dist/cli/chunk-btfr9yvw.js +41 -0
package/dist/cli/chunk-btfr9yvw.js.map +10 -0
package/dist/cli/chunk-cbjnx4s8.js +73 -0
package/dist/cli/chunk-cbjnx4s8.js.map +10 -0
package/dist/cli/chunk-cfw6x4rm.js +1967 -0
package/dist/cli/chunk-cfw6x4rm.js.map +34 -0
package/dist/cli/chunk-ckh3a410.js +277 -0
package/dist/cli/chunk-ckh3a410.js.map +11 -0
package/dist/cli/chunk-drke6t0h.js +259 -0
package/dist/cli/chunk-drke6t0h.js.map +11 -0
package/dist/cli/chunk-ev67ycx0.js +15 -0
package/dist/cli/chunk-ev67ycx0.js.map +10 -0
package/dist/cli/chunk-ey89bjj1.js +209 -0
package/dist/cli/chunk-ey89bjj1.js.map +11 -0
package/dist/cli/chunk-j6pxe0dt.js +69 -0
package/dist/cli/chunk-j6pxe0dt.js.map +11 -0
package/dist/cli/chunk-jk1zwka1.js +387 -0
package/dist/cli/chunk-jk1zwka1.js.map +12 -0
package/dist/cli/chunk-jtb45atp.js +467 -0
package/dist/cli/chunk-jtb45atp.js.map +14 -0
package/dist/cli/chunk-jxkxjsc1.js +76 -0
package/dist/cli/chunk-jxkxjsc1.js.map +10 -0
package/dist/cli/chunk-kwx90v78.js +81 -0
package/dist/cli/chunk-kwx90v78.js.map +10 -0
package/dist/cli/chunk-n0nyat6g.js +30 -0
package/dist/cli/chunk-n0nyat6g.js.map +10 -0
package/dist/cli/chunk-pxj10x8y.js +35 -0
package/dist/cli/chunk-pxj10x8y.js.map +10 -0
package/dist/cli/chunk-qq9nm3qd.js +1141 -0
package/dist/cli/chunk-qq9nm3qd.js.map +19 -0
package/dist/cli/chunk-s102bysw.js +5170 -0
package/dist/cli/chunk-s102bysw.js.map +47 -0
package/dist/cli/chunk-s5dsk8bj.js +769 -0
package/dist/cli/chunk-s5dsk8bj.js.map +13 -0
package/dist/cli/chunk-s5e5jt53.js +227 -0
package/dist/cli/chunk-s5e5jt53.js.map +11 -0
package/dist/cli/chunk-sbdqrjbb.js +81 -0
package/dist/cli/chunk-sbdqrjbb.js.map +10 -0
package/dist/cli/chunk-tnskyrej.js +117 -0
package/dist/cli/chunk-tnskyrej.js.map +10 -0
package/dist/cli/chunk-v2ymm99c.js +1016 -0
package/dist/cli/chunk-v2ymm99c.js.map +13 -0
package/dist/cli/chunk-v5mm027v.js +185 -0
package/dist/cli/chunk-v5mm027v.js.map +11 -0
package/dist/cli/chunk-vt8fgygt.js +23 -0
package/dist/cli/chunk-vt8fgygt.js.map +10 -0
package/dist/cli/chunk-vxv4x1n8.js +17 -0
package/dist/cli/chunk-vxv4x1n8.js.map +10 -0
package/dist/cli/chunk-wd27zjcz.js +60 -0
package/dist/cli/chunk-wd27zjcz.js.map +10 -0
package/dist/cli/chunk-x66c5yjn.js +23 -0
package/dist/cli/chunk-x66c5yjn.js.map +10 -0
package/dist/cli/chunk-xv91q4nm.js +5314 -0
package/dist/cli/chunk-xv91q4nm.js.map +58 -0
package/dist/cli/chunk-y3g15rvv.js +679 -0
package/dist/cli/chunk-y3g15rvv.js.map +15 -0
package/dist/cli/chunk-ye9zdkgv.js +136 -0
package/dist/cli/chunk-ye9zdkgv.js.map +10 -0
package/dist/cli/chunk-ynacq3ev.js +1062 -0
package/dist/cli/chunk-ynacq3ev.js.map +25 -0
package/dist/cli/chunk-zr3ygrq3.js +54 -0
package/dist/cli/chunk-zr3ygrq3.js.map +10 -0
package/dist/cli/index.js +55 -27597
package/dist/cli/index.js.map +5 -243
package/dist/types/ai/ask-context.d.ts +26 -0
package/dist/types/components/layout/nav-utils.d.ts +33 -1
package/dist/types/core/code-fences.d.ts +11 -0
package/dist/types/core/package-root.d.ts +1 -1
package/dist/types/core/schema.d.ts +70 -0
package/dist/types/theme/fonts.d.ts +22 -22
package/docs/02-deployment.mdx +22 -1
package/docs/configuration/ask-ai.mdx +1 -1
package/docs/configuration/customization.mdx +2 -9
package/docs/content/navigation.mdx +2 -0
package/docs/content/syntax.mdx +1 -1
package/docs/discoverability/open-graph.mdx +4 -0
package/docs/reference/cli.mdx +1 -1
package/package.json +4 -2
package/src/ai/api/handlers.ts +4 -7
package/src/ai/api/paths.ts +8 -0
package/src/ai/api/spec.ts +2 -1
package/src/ai/ask-context.ts +378 -22
package/src/astro/generate.ts +161 -28
package/src/astro/include-hmr.ts +10 -13
package/src/astro/include-refresh.ts +0 -0
package/src/astro/index.ts +6 -1
package/src/astro/integration.ts +280 -53
package/src/astro/module-types.ts +83 -0
package/src/astro/templates.ts +256 -108
package/src/audit/image-size.ts +10 -8
package/src/cli/command-meta.ts +77 -0
package/src/cli/commands/add.ts +2 -4
package/src/cli/commands/audit.ts +2 -4
package/src/cli/commands/build.ts +70 -346
package/src/cli/commands/check.ts +2 -4
package/src/cli/commands/dev.ts +31 -42
package/src/cli/commands/doctor.ts +2 -4
package/src/cli/commands/eject.ts +3 -41
package/src/cli/commands/eval.ts +2 -5
package/src/cli/commands/init.ts +2 -4
package/src/cli/commands/mcp-stdio.ts +2 -5
package/src/cli/commands/preview.ts +3 -5
package/src/cli/commands/sync.ts +2 -4
package/src/cli/commands/translate.ts +2 -5
package/src/cli/commands/validate.ts +2 -4
package/src/cli/commands/version.ts +2 -4
package/src/cli/eject-scripts.ts +0 -45
package/src/cli/host-args.ts +16 -0
package/src/cli/index.ts +84 -35
package/src/cli/lazy-command.ts +47 -0
package/src/components/Icon.astro +24 -0
package/src/components/content/GithubInfo.astro +4 -1
package/src/components/icon-sprite-middleware.ts +41 -0
package/src/components/icon-sprite.ts +93 -0
package/src/components/layout/IconSprite.astro +11 -0
package/src/components/layout/NavTree.astro +156 -188
package/src/components/layout/NavTreeCache.astro +45 -0
package/src/components/layout/NavTreeScript.astro +256 -0
package/src/components/layout/PageActions.astro +11 -5
package/src/components/layout/PageLayout.astro +21 -3
package/src/components/layout/ReferenceLayout.astro +21 -4
package/src/components/layout/RootLayout.astro +44 -6
package/src/components/layout/nav-cache.ts +49 -0
package/src/components/layout/nav-utils.ts +69 -1
package/src/components/layout/page-locale.ts +29 -0
package/src/core/api-name.ts +18 -0
package/src/core/code-fences.ts +48 -0
package/src/core/content-assets.ts +3 -7
package/src/core/includes.ts +3 -7
package/src/core/package-root.ts +1 -1
package/src/core/schema.ts +19 -0
package/src/core/sources/normalize.ts +2 -37
package/src/core/sources/obsidian.ts +3 -2
package/src/core/svg-dimensions.ts +97 -0
package/src/core/version-cut.ts +2 -2
package/src/deploy/artifacts.ts +370 -0
package/src/deploy/cloudflare-negotiation.ts +97 -32
package/src/deploy/function-bundle.ts +66 -20
package/src/deploy/sitemap.ts +6 -0
package/src/deploy/vercel-negotiation.ts +8 -30
package/src/markdown/language-icon.ts +64 -20
package/src/markdown/mermaid.ts +11 -0
package/src/og/cache.ts +236 -0
package/src/og/card.ts +18 -16
package/src/og/index.ts +8 -1
package/src/openapi/render-mdx.ts +9 -5
package/src/registry/eject.ts +23 -10
package/src/theme/entry.ts +41 -7
package/src/theme/fonts.ts +30 -23

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

@@ -1,5 +1,5 @@
 import { isRootTab, isUnderPath } from "../../core/navigation.ts";
-import type { NavNode, NavTab } from "../../core/types.ts";
+import type { NavNode, NavTab, Navigation } from "../../core/types.ts";
 /** A flat, ordered page reference used for previous/next pagination. */
 export interface FlatPage {
@@ -238,3 +238,71 @@ export const getPagination = (flat: FlatPage[], route: string) => {
     prev: index > 0 ? (flat[index - 1] ?? null) : null,
   };
 };
+/**
+ * A stable id for every group in a sidebar — `g<n>` by pre-order position in
+ * the full tree. The layout hands `NavTree` a scoped view of that tree (a
+ * tab's section, or the sidebar minus the tab sections), so positions within
+ * the rendered slice differ from page to page; these ids name the same group
+ * everywhere, which the drill-in panels and the deferred-section fragments
+ * (`/blume-nav/…`) rely on. Keyed by node identity: the scoped views reuse
+ * the full tree's node objects.
+ */
+export const navGroupIds = (sidebar: NavNode[]): Map<NavNode, string> => {
+  const ids = new Map<NavNode, string>();
+  const walk = (nodes: NavNode[]): void => {
+    for (const node of nodes) {
+      if (node.kind === "group") {
+        ids.set(node, `g${ids.size}`);
+        walk(node.children);
+      }
+    }
+  };
+  walk(sidebar);
+  return ids;
+};
+/** Whether any group in a sidebar renders as a disclosure or a drill-in panel. */
+export const hasDeferrableGroups = (sidebar: NavNode[]): boolean =>
+  sidebar.some(
+    (node) =>
+      node.kind === "group" &&
+      ((node.display ?? "flat") !== "flat" ||
+        hasDeferrableGroups(node.children))
+  );
+/** One of the navigation trees a site renders, by URL segment. */
+export interface NavVariant {
+  /** `current`, or an archived version id. */
+  version: string;
+  /** `default`, or a locale code. */
+  locale: string;
+  navigation: Navigation;
+}
+/**
+ * Every navigation tree the runtime data holds — the default, each locale's,
+ * and each archived version's per locale — keyed the way the deferred
+ * sidebar fragments' URLs are (`/blume-nav/<version>/<locale>/…`). An
+ * unlocalized version tree is keyed by `""` in the data; it maps to
+ * `default` here.
+ */
+export const navVariants = (data: {
+  navigation: Navigation;
+  navigationByLocale: Record<string, Navigation>;
+  navigationByVersion: Record<string, Record<string, Navigation>>;
+}): NavVariant[] => [
+  { locale: "default", navigation: data.navigation, version: "current" },
+  ...Object.entries(data.navigationByLocale).map(([locale, navigation]) => ({
+    locale,
+    navigation,
+    version: "current",
+  })),
+  ...Object.entries(data.navigationByVersion).flatMap(([version, byLocale]) =>
+    Object.entries(byLocale).map(([locale, navigation]) => ({
+      locale: locale || "default",
+      navigation,
+      version,
+    }))
+  ),
+];

package/src/components/layout/page-locale.ts ADDED Viewed

@@ -0,0 +1,29 @@
+/**
+ * Locale defaults for the document shells (`RootLayout`, `PageLayout`,
+ * `ReferenceLayout`) when the page doesn't pass `locale`/`dir` itself.
+ *
+ * The content catch-all always passes both, resolved from the route manifest
+ * (which also knows about fallback pages). Custom `.astro` pages, the 404
+ * page, and the reference shell don't have that data, so they fall back to
+ * what Astro's own i18n routing resolved for the request — `Astro.currentLocale`
+ * — which the generated config enables with Blume's locale list. Before this,
+ * a custom page under `/fr/` rendered `<html lang="en">` unless it threaded
+ * the locale through by hand.
+ */
+/**
+ * The page's locale: the caller's explicit value, else the one Astro resolved
+ * from the URL, else the site's default locale, else `en` (no i18n).
+ */
+export const pageLocale = (
+  i18n: { defaultLocale: string } | null,
+  explicit?: string,
+  current?: string
+): string => explicit ?? current ?? i18n?.defaultLocale ?? "en";
+/** The configured text direction of a locale; `ltr` when unknown. */
+export const pageDirection = (
+  i18n: { locales: { code: string; dir: "ltr" | "rtl" }[] } | null,
+  locale: string
+): "ltr" | "rtl" =>
+  i18n?.locales.find((entry) => entry.code === locale)?.dir ?? "ltr";

package/src/core/api-name.ts ADDED Viewed

@@ -0,0 +1,18 @@
+/**
+ * Whether a name already reads as an API's name: it contains `API` or `APIs`
+ * as a whole word, anywhere. Word-bounded on both sides, so "OpenAPI" and
+ * "AsyncAPI" are product names rather than API names and still take the
+ * suffix; unanchored at the end, so "Petstore API v2" is left alone too.
+ */
+const NAMES_AN_API = /\bAPIs?\b/iu;
+/**
+ * `name` as the phrase "the ___" in generated prose — the spec title or
+ * reference label, followed by ` API` unless it already says so. Keeps
+ * "Petstore" reading as "Petstore API" without turning "Petstore API" into
+ * "Petstore API API".
+ */
+export const apiNamePhrase = (name: string): string => {
+  const trimmed = name.trim();
+  return NAMES_AN_API.test(trimmed) ? trimmed : `${trimmed} API`;
+};

package/src/core/code-fences.ts ADDED Viewed

@@ -0,0 +1,48 @@
+/**
+ * Fenced-code state for line scanners. Kept free of imports so request-time
+ * code (the Ask AI grounding excerpts) can share it with the build-time source
+ * scanners without pulling the filesystem and schema modules along.
+ *
+ * CommonMark allows backtick *and* tilde fences, three or more characters
+ * long. The scanners track which delimiter opened the current fence and how
+ * long its run was (`null` when outside one), so a ``` line inside a ~~~
+ * block — or inside a ````-delimited block (the wrapper `codeBlockLines`
+ * emits around code that contains its own ``` fence) — is content, not a
+ * toggle.
+ */
+const CODE_FENCE = /^(?<run>`{3,}|~{3,})/u;
+/** The open fence's delimiter char and run length, or null outside one. */
+export type FenceState = { delimiter: "`" | "~"; length: number } | null;
+/**
+ * Advance the fenced-code state for one line: an opening fence records its
+ * delimiter and run length, only a bare run of the same character at least as
+ * long closes it (CommonMark), and any other line leaves the state untouched.
+ */
+export const nextFenceState = (line: string, fence: FenceState): FenceState => {
+  const trimmed = line.trimStart();
+  const run = trimmed.match(CODE_FENCE)?.groups?.run;
+  if (run === undefined) {
+    return fence;
+  }
+  const rest = trimmed.slice(run.length);
+  const delimiter = run.startsWith("`") ? ("`" as const) : ("~" as const);
+  if (fence === null) {
+    // A backtick fence's info string cannot itself contain a backtick
+    // (CommonMark) — a line-leading ```inline``` span is a paragraph, and
+    // opening a phantom fence on it would swallow every heading and link
+    // after it. Tilde fences carry no such rule.
+    if (delimiter === "`" && rest.includes("`")) {
+      return fence;
+    }
+    return { delimiter, length: run.length };
+  }
+  // A closing fence may be followed only by whitespace: a same-length
+  // ```js line inside an open ``` block is content, not a closer.
+  return fence.delimiter === delimiter &&
+    run.length >= fence.length &&
+    rest.trim() === ""
+    ? null
+    : fence;
+};

package/src/core/content-assets.ts CHANGED Viewed

@@ -11,14 +11,10 @@ import {
 } from "pathe";
 import { normalizeBasePath } from "./base-path.ts";
+import { nextFenceState } from "./code-fences.ts";
+import type { FenceState } from "./code-fences.ts";
 import { hashText } from "./sources/cache.ts";
-import type { FenceState } from "./sources/normalize.ts";
-import {
-  INLINE_CODE,
-  MD_IMAGE,
-  nextFenceState,
-  targetOffsetIn,
-} from "./sources/normalize.ts";
+import { INLINE_CODE, MD_IMAGE, targetOffsetIn } from "./sources/normalize.ts";
 import { readExpandedEntryText } from "./sources/read.ts";
 import type { ContentSource } from "./sources/types.ts";
 import type { PageRecord } from "./types.ts";

package/src/core/includes.ts CHANGED Viewed

@@ -2,14 +2,10 @@ import { readFile } from "node:fs/promises";
 import { dirname, extname, join, relative, resolve } from "pathe";
+import { nextFenceState } from "./code-fences.ts";
+import type { FenceState } from "./code-fences.ts";
 import matter from "./frontmatter.ts";
-import type { FenceState } from "./sources/normalize.ts";
-import {
-  INLINE_CODE,
-  MD_IMAGE,
-  nextFenceState,
-  targetOffsetIn,
-} from "./sources/normalize.ts";
+import { INLINE_CODE, MD_IMAGE, targetOffsetIn } from "./sources/normalize.ts";
 import type { Diagnostic } from "./types.ts";
 /**

package/src/core/package-root.ts CHANGED Viewed

@@ -28,7 +28,7 @@ let cached: string | undefined;
  * Anchoring here — rather than at a fixed offset from `import.meta` — keeps the
  * package's own `src/`, assets, and `node_modules` locatable whether the code
  * runs from source under Bun (`src/...`) or from the published, bundled CLI
- * (`dist/cli/index.js`). The two layouts sit at different depths, so a relative
+ * (`dist/cli/*.js`). The two layouts sit at different depths, so a relative
  * `../..` resolves to different places; locating `package.json` does not.
  */
 export const packageRoot = (): string => {

package/src/core/schema.ts CHANGED Viewed

@@ -176,6 +176,25 @@ export const pageMetaSchema = pageMetaBaseSchema;
 export type PageMeta = z.infer<typeof pageMetaBaseSchema>;
 export type PageMetaInput = z.input<typeof pageMetaBaseSchema>;
+/** The fully-defaulted front matter of a page that declares nothing. */
+const EMPTY_PAGE_META: PageMeta = pageMetaBaseSchema.parse({});
+/**
+ * The page schema as the generated content collections declare it, so
+ * `entry.data` is typed and normalized (dates as ISO strings, X handles with
+ * their `@`) the same way the scan's `PageMeta` is. Two deliberate loosenings
+ * over {@link pageMetaSchema}: custom keys (`frontmatter.extend`, per-type
+ * maps) pass through instead of failing the strict parse, and a page the
+ * strict parse rejects resolves to the empty defaults instead of throwing.
+ * The scan has already dropped such a page with a `BLUME_FRONTMATTER_INVALID`
+ * diagnostic — Blume continues without it unless `--strict` — so the
+ * collection must not turn that dropped page into a failed content sync.
+ */
+export const pageCollectionSchema = pageMetaBaseSchema
+  .loose()
+  // oxlint-disable-next-line promise/prefer-await-to-then -- zod's catch, not a promise
+  .catch(() => EMPTY_PAGE_META);
 /** Built-in page frontmatter keys; custom keys must never redeclare one. */
 const BUILT_IN_PAGE_META_KEYS = new Set<string>(
   pageMetaBaseSchema.keyof().options

package/src/core/sources/normalize.ts CHANGED Viewed

@@ -4,6 +4,8 @@ import GithubSlugger from "github-slugger";
 import { extname } from "pathe";
 import { withBasePath } from "../base-path.ts";
+import { nextFenceState } from "../code-fences.ts";
+import type { FenceState } from "../code-fences.ts";
 import { diagnosticsFromIssues, diagnosticsFromZod } from "../diagnostics.ts";
 import { occupySlug, parseHeadingMarkers } from "../heading-markers.ts";
 import { localePlacement, localizeRoute } from "../i18n.ts";
@@ -139,43 +141,6 @@ const mapRoute = (relativePath: string): MappedRoute => {
   return { groups, route, segments };
 };
-// CommonMark allows backtick *and* tilde fences, three or more characters
-// long. The scanners track which delimiter opened the current fence and how
-// long its run was (`null` when outside one), so a ``` line inside a ~~~
-// block — or inside a ````-delimited block (the wrapper `codeBlockLines`
-// emits around code that contains its own ``` fence) — is content, not a
-// toggle. See `nextFenceState`.
-const CODE_FENCE = /^(?<run>`{3,}|~{3,})/u;
-/** The open fence's delimiter char and run length, or null outside one. */
-export type FenceState = { delimiter: "`" | "~"; length: number } | null;
-/**
- * Advance the fenced-code state for one line: an opening fence records its
- * delimiter and run length, only a run of the same character at least as long
- * closes it (CommonMark), and any other line leaves the state untouched.
- */
-export const nextFenceState = (line: string, fence: FenceState): FenceState => {
-  const trimmed = line.trimStart();
-  const run = trimmed.match(CODE_FENCE)?.groups?.run;
-  if (run === undefined) {
-    return fence;
-  }
-  const delimiter = run.startsWith("`") ? ("`" as const) : ("~" as const);
-  if (fence === null) {
-    // A backtick fence's info string cannot itself contain a backtick
-    // (CommonMark) — a line-leading ```inline``` span is a paragraph, and
-    // opening a phantom fence on it would swallow every heading and link
-    // after it. Tilde fences carry no such rule.
-    if (delimiter === "`" && trimmed.slice(run.length).includes("`")) {
-      return fence;
-    }
-    return { delimiter, length: run.length };
-  }
-  return fence.delimiter === delimiter && run.length >= fence.length
-    ? null
-    : fence;
-};
 // A closing hash sequence must be preceded by whitespace (CommonMark), so a
 // heading like `## What is C#` keeps its trailing `#`. Up to 3 leading spaces
 // are allowed; 4+ is an indented code block.

package/src/core/sources/obsidian.ts CHANGED Viewed

@@ -4,18 +4,19 @@ import { readdir, readFile, stat } from "node:fs/promises";
 import { basename, isAbsolute, join, relative, resolve } from "pathe";
+import { nextFenceState } from "../code-fences.ts";
+import type { FenceState } from "../code-fences.ts";
 import { BlumeError } from "../diagnostics.ts";
 import matter from "../frontmatter.ts";
 import { pageMetaSchema } from "../schema.ts";
 import type { ResolvedI18nConfig, ResolvedVersionsConfig } from "../schema.ts";
 import type { Diagnostic } from "../types.ts";
 import { hashText } from "./cache.ts";
-import type { EntryPlacement, FenceState } from "./normalize.ts";
+import type { EntryPlacement } from "./normalize.ts";
 import {
   extractHeadings,
   isStringValue,
   localizedRoute,
-  nextFenceState,
   placeEntryRef,
   resolveEntryRoute,
   slugifyPath,

package/src/core/svg-dimensions.ts ADDED Viewed

@@ -0,0 +1,97 @@
+/**
+ * Pixel dimensions declared by an SVG document's root element.
+ *
+ * Blume needs an SVG's size in two places — the header logo's reserved
+ * `<img>` box and the OG card's brand mark — and both read it through this
+ * one parser so the header and the card can't disagree about one logo. It
+ * inspects the root `<svg …>` tag only: explicit `width`/`height` win, a
+ * `viewBox` fills in whatever is missing (scaled to a lone explicit length
+ * when there is one), and lengths carry CSS units at 96dpi. Percentages have
+ * no pixel meaning and are ignored, so a percent-sized SVG measures by its
+ * viewBox alone.
+ */
+export interface SvgDimensions {
+  height: number;
+  width: number;
+}
+/** The root tag, tolerating `>` inside a quoted attribute value. */
+const ROOT = /<svg\s(?:[^>"']|"[^"]*"|'[^']*')*>/u;
+const WIDTH = /\swidth=(?<quote>['"])(?<value>[^%]+?)\k<quote>/u;
+const HEIGHT = /\sheight=(?<quote>['"])(?<value>[^%]+?)\k<quote>/u;
+const VIEWBOX = /\sviewBox=(?<quote>['"])(?<value>.+?)\k<quote>/iu;
+/** Pixels per CSS unit at 96dpi; an omitted unit means pixels. */
+const INCH_CM = 2.54;
+const UNITS = new Map([
+  ["cm", 96 / INCH_CM],
+  ["em", 16],
+  ["ex", 8],
+  ["in", 96],
+  ["m", (96 / INCH_CM) * 100],
+  ["mm", 96 / INCH_CM / 10],
+  ["pc", (96 / 72) * 12],
+  ["pt", 96 / 72],
+  ["px", 1],
+]);
+const LENGTH =
+  /^(?<number>[0-9.]+(?:e\d+)?)(?<unit>in|cm|em|ex|m|mm|pc|pt|px)?$/u;
+/** A CSS length as whole pixels, or undefined when it isn't one. */
+const parseLength = (value: string | undefined): number | undefined => {
+  const groups = value === undefined ? undefined : LENGTH.exec(value)?.groups;
+  if (!groups) {
+    return;
+  }
+  const pixels = Math.round(
+    Number(groups.number) * (UNITS.get(groups.unit ?? "px") ?? 1)
+  );
+  return pixels > 0 ? pixels : undefined;
+};
+/** An attribute's raw value on the root tag, or undefined when absent. */
+const attribute = (root: string, pattern: RegExp): string | undefined =>
+  pattern.exec(root)?.groups?.value;
+/** The viewBox's own width and height (its third and fourth numbers). */
+const viewBoxSize = (root: string): SvgDimensions | null => {
+  const raw = attribute(root, VIEWBOX);
+  if (raw === undefined) {
+    return null;
+  }
+  const bounds = raw.split(" ");
+  const width = parseLength(bounds[2]);
+  const height = parseLength(bounds[3]);
+  return width && height ? { height, width } : null;
+};
+/**
+ * The SVG's pixel size, or null when the root carries no usable size: no
+ * root tag, neither explicit dimensions nor a viewBox, a viewBox that isn't
+ * space-separated, or a zero or unparsable length.
+ */
+export const svgDimensions = (svg: string): SvgDimensions | null => {
+  const root = ROOT.exec(svg)?.[0];
+  if (root === undefined) {
+    return null;
+  }
+  const width = parseLength(attribute(root, WIDTH));
+  const height = parseLength(attribute(root, HEIGHT));
+  if (width && height) {
+    return { height, width };
+  }
+  const box = viewBoxSize(root);
+  if (!box) {
+    return null;
+  }
+  const ratio = box.width / box.height;
+  if (width) {
+    const scaled = Math.floor(width / ratio);
+    return scaled > 0 ? { height: scaled, width } : null;
+  }
+  if (height) {
+    const scaled = Math.floor(height * ratio);
+    return scaled > 0 ? { height, width: scaled } : null;
+  }
+  return box;
+};

package/src/core/version-cut.ts CHANGED Viewed

@@ -4,13 +4,13 @@ import { cp, readdir, readFile, rm } from "node:fs/promises";
 import { join, relative } from "pathe";
 import { stripBasePath } from "./base-path.ts";
+import { nextFenceState } from "./code-fences.ts";
+import type { FenceState } from "./code-fences.ts";
 import { writeTextAtomic } from "./fs-atomic.ts";
 import { localizeRoute } from "./i18n.ts";
 import type { BlumeProject } from "./project-graph.ts";
 import { isWithin, scanProject } from "./project-graph.ts";
 import { VERSION_ID } from "./schema.ts";
-import { nextFenceState } from "./sources/normalize.ts";
-import type { FenceState } from "./sources/normalize.ts";
 import { VERSION_LIKE, versionizeRoute } from "./versions.ts";
 /** What `cutVersion` did, for the CLI to report. */