npm - blume - Versions diffs - 0.0.0 → 0.1.0 - Mend

blume 0.0.0 → 0.1.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 (263) hide show

package/bin/blume.mjs +18 -0
package/dist/cli/index.js +11989 -0
package/dist/cli/index.js.map +141 -0
package/docs/01-quickstart.mdx +99 -0
package/docs/02-deployment.mdx +129 -0
package/docs/advanced/api-reference.mdx +114 -0
package/docs/advanced/blog.mdx +121 -0
package/docs/advanced/changelog.mdx +113 -0
package/docs/advanced/custom-pages.mdx +187 -0
package/docs/advanced/meta.ts +7 -0
package/docs/changelog/v0-1-0.mdx +12 -0
package/docs/changelog/v0-2-0.mdx +16 -0
package/docs/configuration/ai.mdx +228 -0
package/docs/configuration/analytics.mdx +98 -0
package/docs/configuration/customization.mdx +91 -0
package/docs/configuration/export.mdx +70 -0
package/docs/configuration/index.mdx +271 -0
package/docs/configuration/meta.ts +15 -0
package/docs/configuration/search.mdx +172 -0
package/docs/configuration/seo.mdx +196 -0
package/docs/configuration/theming.mdx +178 -0
package/docs/content/components.mdx +565 -0
package/docs/content/i18n.mdx +205 -0
package/docs/content/index.mdx +161 -0
package/docs/content/islands.mdx +94 -0
package/docs/content/meta.mdx +119 -0
package/docs/content/meta.ts +15 -0
package/docs/content/navigation.mdx +168 -0
package/docs/content/sources.mdx +216 -0
package/docs/content/syntax.mdx +445 -0
package/docs/index.mdx +112 -0
package/docs/reference/cli.mdx +43 -0
package/docs/reference/frontmatter.mdx +74 -0
package/docs/reference/meta.ts +7 -0
package/package.json +140 -6
package/src/ai/ask.ts +93 -0
package/src/ai/llms.ts +65 -0
package/src/ai/markdown.ts +31 -0
package/src/ai/mcp/data.ts +74 -0
package/src/ai/mcp/discovery.ts +49 -0
package/src/ai/mcp/server.ts +225 -0
package/src/ai/mcp/tools.ts +47 -0
package/src/assets/icon.png +0 -0
package/src/astro/generate.ts +878 -0
package/src/astro/index.ts +4 -0
package/src/astro/integration.ts +74 -0
package/src/astro/islands.ts +131 -0
package/src/astro/markdown-negotiation.ts +68 -0
package/src/astro/pages.ts +28 -0
package/src/astro/templates.ts +1199 -0
package/src/cli/commands/add.ts +81 -0
package/src/cli/commands/build.ts +103 -0
package/src/cli/commands/dev.ts +108 -0
package/src/cli/commands/doctor.ts +74 -0
package/src/cli/commands/eject.ts +57 -0
package/src/cli/commands/init.ts +98 -0
package/src/cli/commands/migrate.ts +39 -0
package/src/cli/commands/preview.ts +39 -0
package/src/cli/commands/sync.ts +52 -0
package/src/cli/commands/validate.ts +60 -0
package/src/cli/index.ts +35 -0
package/src/cli/log.ts +37 -0
package/src/cli/prepare.ts +80 -0
package/src/components/Icon.astro +99 -0
package/src/components/content/Accordion.astro +8 -0
package/src/components/content/AccordionItem.astro +121 -0
package/src/components/content/AutoTypeTable.astro +51 -0
package/src/components/content/Badge.astro +124 -0
package/src/components/content/Callout.astro +73 -0
package/src/components/content/Card.astro +104 -0
package/src/components/content/CardGroup.astro +14 -0
package/src/components/content/CodeGroup.astro +13 -0
package/src/components/content/Color.astro +15 -0
package/src/components/content/ColorItem.astro +87 -0
package/src/components/content/ColorRow.astro +10 -0
package/src/components/content/Column.astro +6 -0
package/src/components/content/Columns.astro +9 -0
package/src/components/content/Expandable.astro +11 -0
package/src/components/content/FileTree.astro +8 -0
package/src/components/content/Frame.astro +70 -0
package/src/components/content/GithubInfo.astro +110 -0
package/src/components/content/Math.astro +24 -0
package/src/components/content/Panel.astro +20 -0
package/src/components/content/Prompt.astro +129 -0
package/src/components/content/Step.astro +34 -0
package/src/components/content/Steps.astro +20 -0
package/src/components/content/Tab.astro +40 -0
package/src/components/content/Tabs.astro +273 -0
package/src/components/content/Tile.astro +42 -0
package/src/components/content/Tooltip.astro +68 -0
package/src/components/content/Tree.astro +300 -0
package/src/components/content/TreeFile.astro +15 -0
package/src/components/content/TreeFolder.astro +62 -0
package/src/components/content/TypeTable.astro +106 -0
package/src/components/content/Update.astro +66 -0
package/src/components/content/Visibility.astro +12 -0
package/src/components/content/Warning.astro +9 -0
package/src/components/content/auto-type-table.ts +141 -0
package/src/components/content/github-info.ts +79 -0
package/src/components/content/mermaid-element.ts +68 -0
package/src/components/github-mark.ts +9 -0
package/src/components/index.ts +14 -0
package/src/components/islands/AskAI.astro +12 -0
package/src/components/islands/ask-ai.tsx +156 -0
package/src/components/layout/Analytics.astro +63 -0
package/src/components/layout/Banner.astro +50 -0
package/src/components/layout/Breadcrumbs.astro +31 -0
package/src/components/layout/Favicon.astro +15 -0
package/src/components/layout/Fonts.astro +14 -0
package/src/components/layout/Header.astro +188 -0
package/src/components/layout/LanguageSwitcher.astro +56 -0
package/src/components/layout/NavTree.astro +462 -0
package/src/components/layout/PageActions.astro +438 -0
package/src/components/layout/PageFeedback.astro +58 -0
package/src/components/layout/Pagination.astro +56 -0
package/src/components/layout/ReferenceLayout.astro +102 -0
package/src/components/layout/RootLayout.astro +533 -0
package/src/components/layout/Search.astro +608 -0
package/src/components/layout/TableOfContents.astro +68 -0
package/src/components/layout/analytics-client.ts +38 -0
package/src/components/layout/nav-utils.ts +87 -0
package/src/components/layout/overrides.ts +32 -0
package/src/components/layout/search/algolia.ts +43 -0
package/src/components/layout/search/endpoint.ts +22 -0
package/src/components/layout/search/flexsearch.ts +52 -0
package/src/components/layout/search/orama-cloud.ts +41 -0
package/src/components/layout/search/orama.ts +26 -0
package/src/components/layout/search/pagefind.ts +43 -0
package/src/components/layout/search/types.ts +163 -0
package/src/components/layout/search/typesense.ts +60 -0
package/src/components/layout/toc-element.ts +108 -0
package/src/core/bridge.ts +92 -0
package/src/core/config.ts +112 -0
package/src/core/content.ts +50 -0
package/src/core/define-components.ts +34 -0
package/src/core/define-meta.ts +20 -0
package/src/core/deployment-env.ts +73 -0
package/src/core/diagnostics.ts +104 -0
package/src/core/graph.ts +128 -0
package/src/core/i18n-ui.ts +171 -0
package/src/core/i18n.ts +169 -0
package/src/core/last-modified.ts +88 -0
package/src/core/links.ts +336 -0
package/src/core/load-module.ts +15 -0
package/src/core/manifest.ts +126 -0
package/src/core/meta.ts +97 -0
package/src/core/navigation.ts +392 -0
package/src/core/package-root.ts +37 -0
package/src/core/project-graph.ts +153 -0
package/src/core/project.ts +56 -0
package/src/core/schema.ts +1057 -0
package/src/core/server-features.ts +23 -0
package/src/core/sources/assets.ts +77 -0
package/src/core/sources/cache.ts +122 -0
package/src/core/sources/filesystem.ts +99 -0
package/src/core/sources/mdx-remote.ts +216 -0
package/src/core/sources/mintlify.ts +161 -0
package/src/core/sources/normalize.ts +227 -0
package/src/core/sources/notion.ts +440 -0
package/src/core/sources/portable-text.ts +143 -0
package/src/core/sources/read.ts +36 -0
package/src/core/sources/resolve.ts +158 -0
package/src/core/sources/sanity.ts +218 -0
package/src/core/sources/types.ts +105 -0
package/src/core/types.ts +261 -0
package/src/core/ui-packs/ar.ts +47 -0
package/src/core/ui-packs/bg.ts +47 -0
package/src/core/ui-packs/bn.ts +47 -0
package/src/core/ui-packs/ca.ts +47 -0
package/src/core/ui-packs/cs.ts +47 -0
package/src/core/ui-packs/da.ts +47 -0
package/src/core/ui-packs/de.ts +47 -0
package/src/core/ui-packs/el.ts +47 -0
package/src/core/ui-packs/es.ts +47 -0
package/src/core/ui-packs/fa.ts +47 -0
package/src/core/ui-packs/fi.ts +47 -0
package/src/core/ui-packs/fr.ts +47 -0
package/src/core/ui-packs/he.ts +47 -0
package/src/core/ui-packs/hi.ts +47 -0
package/src/core/ui-packs/hr.ts +47 -0
package/src/core/ui-packs/hu.ts +47 -0
package/src/core/ui-packs/id.ts +47 -0
package/src/core/ui-packs/index.ts +87 -0
package/src/core/ui-packs/it.ts +47 -0
package/src/core/ui-packs/ja.ts +47 -0
package/src/core/ui-packs/ko.ts +47 -0
package/src/core/ui-packs/nl.ts +47 -0
package/src/core/ui-packs/no.ts +47 -0
package/src/core/ui-packs/pl.ts +47 -0
package/src/core/ui-packs/pt-br.ts +47 -0
package/src/core/ui-packs/pt.ts +47 -0
package/src/core/ui-packs/ro.ts +47 -0
package/src/core/ui-packs/ru.ts +47 -0
package/src/core/ui-packs/sk.ts +47 -0
package/src/core/ui-packs/sr.ts +47 -0
package/src/core/ui-packs/sv.ts +47 -0
package/src/core/ui-packs/th.ts +47 -0
package/src/core/ui-packs/tr.ts +47 -0
package/src/core/ui-packs/uk.ts +47 -0
package/src/core/ui-packs/vi.ts +47 -0
package/src/core/ui-packs/zh-tw.ts +47 -0
package/src/core/ui-packs/zh.ts +47 -0
package/src/core/version.ts +23 -0
package/src/deploy/robots.ts +20 -0
package/src/deploy/rss.ts +128 -0
package/src/deploy/sitemap.ts +28 -0
package/src/index.ts +27 -0
package/src/markdown/code-title.ts +71 -0
package/src/markdown/directives.ts +83 -0
package/src/markdown/heading-anchors.ts +137 -0
package/src/markdown/index.ts +159 -0
package/src/markdown/inline-code.ts +108 -0
package/src/markdown/language-icon.ts +172 -0
package/src/markdown/math.ts +32 -0
package/src/markdown/mdast.ts +48 -0
package/src/markdown/mermaid.ts +37 -0
package/src/markdown/package-commands.ts +159 -0
package/src/markdown/package-install.ts +40 -0
package/src/migrate/fumadocs/config.ts +106 -0
package/src/migrate/fumadocs/content.ts +365 -0
package/src/migrate/fumadocs/frontmatter.ts +18 -0
package/src/migrate/fumadocs/index.ts +252 -0
package/src/migrate/fumadocs/meta.ts +114 -0
package/src/migrate/migrate.ts +53 -0
package/src/migrate/mintlify/config.ts +1040 -0
package/src/migrate/mintlify/content.ts +98 -0
package/src/migrate/mintlify/frontmatter.ts +126 -0
package/src/migrate/mintlify/i18n.ts +51 -0
package/src/migrate/mintlify/icons.ts +128 -0
package/src/migrate/mintlify/index.ts +266 -0
package/src/migrate/mintlify/snippets.ts +305 -0
package/src/migrate/mintlify/transform.ts +81 -0
package/src/migrate/nextra/content.ts +46 -0
package/src/migrate/nextra/frontmatter.ts +40 -0
package/src/migrate/nextra/index.ts +374 -0
package/src/migrate/nextra/meta.ts +266 -0
package/src/migrate/shared.ts +623 -0
package/src/migrate/starlight/config.ts +459 -0
package/src/migrate/starlight/content.ts +78 -0
package/src/migrate/starlight/frontmatter.ts +111 -0
package/src/migrate/starlight/i18n.ts +54 -0
package/src/migrate/starlight/index.ts +131 -0
package/src/og/card.ts +92 -0
package/src/og/index.ts +2 -0
package/src/openapi/scalar.ts +246 -0
package/src/registry/eject.ts +263 -0
package/src/registry/registry.ts +100 -0
package/src/registry/rewrite-imports.ts +39 -0
package/src/runtime/index.ts +14 -0
package/src/search/build.ts +23 -0
package/src/search/documents.ts +165 -0
package/src/search/orama-index.ts +66 -0
package/src/search/providers.ts +91 -0
package/src/search/sync/algolia.ts +30 -0
package/src/search/sync/index.ts +50 -0
package/src/search/sync/orama-cloud.ts +40 -0
package/src/search/sync/typesense.ts +65 -0
package/src/seo/jsonld.ts +113 -0
package/src/theme/entry.ts +608 -0
package/src/theme/fonts.ts +198 -0
package/src/theme/icons.ts +184 -0
package/src/theme/palette.ts +143 -0
package/src/theme/twoslash.ts +81 -0

package/docs/configuration/seo.mdx ADDED Viewed

@@ -0,0 +1,196 @@
+---
+title: SEO
+description: Metadata, Open Graph images, RSS feeds, and JSON-LD — Blume's discoverability layer, grouped under one seo config.
+sidebar:
+  label: SEO
+---
+Blume handles the discoverability layer for you: page metadata, social share
+images, feeds, and structured data. The three configurable features live under
+the `seo` key in `blume.config.ts`; metadata is driven by your content.
+```ts blume.config.ts lineNumbers
+seo: {
+  og: { enabled: true },
+  rss: { enabled: true, types: ["blog", "changelog"] },
+  sitemap: true,
+  robots: true,
+  structuredData: true,
+}
+```
+Most of this is sharper with an absolute site URL — set
+[`deployment.site`](/docs/deployment) so feeds, OG images, canonicals, the sitemap,
+and JSON-LD can emit full URLs.
+## Metadata
+Every page renders the standard `<head>` tags from your config and frontmatter:
+- `<title>` — the page title plus your site `title`.
+- `<meta name="description">` and `og:description` — the page `description`,
+  falling back to the site `description`.
+- `og:title` — the page title.
+- `<link rel="canonical">` — the page's absolute URL (when `deployment.site` is
+  set).
+Override any of these per page with `seo` frontmatter:
+```yaml lineNumbers
+---
+title: Pricing
+description: Plans and pricing for every team size.
+seo:
+  title: Pricing — Acme
+  canonical: https://acme.com/pricing
+  noindex: false
+---
+```
+<TypeTable
+  type={{
+    "seo.title": {
+      type: "string",
+      description: "Override the <title> and og:title for this page.",
+    },
+    "seo.description": {
+      type: "string",
+      description: "Override the meta + og:description.",
+    },
+    "seo.image": {
+      type: "string",
+      description: "Custom social image (see Open Graph).",
+    },
+    "seo.canonical": {
+      type: "string",
+      description: "Override the canonical URL.",
+    },
+    "seo.noindex": {
+      type: "boolean",
+      description: "Emit robots noindex and skip structured data.",
+    },
+  }}
+/>
+## Open Graph images
+Blume can render a 1200×630 social card for every page at build time — no
+headless browser, thanks to [Takumi](https://takumi.kane.tw), so builds stay
+fast. On by default once [`deployment.site`](/docs/deployment) is set or
+auto-detected (the `og:image` URL has to be absolute to be useful to crawlers),
+and off otherwise. Set `enabled` to override that either way:
+```ts blume.config.ts lineNumbers
+seo: {
+  og: { enabled: true }, // or false to opt out even with a site set
+}
+```
+Each card is derived from your content and theme — the **page title** as the
+headline, your **site title** as the eyebrow, and your theme **accent** for the
+mark. Images are served at `/og/<slug>.png`, mirroring each route, and are
+prerendered as static files even in server mode:
+| Page route          | Image URL                  |
+| ------------------- | -------------------------- |
+| `/`                 | `/og/index.png`            |
+| `/quickstart`       | `/og/quickstart.png`       |
+| `/configuration/ai` | `/og/configuration/ai.png` |
+Override the generated card for any page with `seo.image` — a file in `public/`
+or an external URL. It takes precedence over the generated card and works even
+when `og` is off, so you can mix custom images with generated ones:
+```yaml lineNumbers
+---
+title: Pricing
+seo:
+  image: /og/pricing-custom.png
+---
+```
+:::note
+OG rendering uses hex internally, so an `oklch` custom accent falls back to the
+default. Use a named accent (`blue`, `teal`, …) or a hex value for custom cards.
+:::
+## RSS feeds
+Blume builds an RSS feed for each content type in `rss.types` — `blog` and
+`changelog` by default — that has pages, served at `/<type>/rss.xml`. See
+[Feeds](/docs/content#feeds) for authoring blog and changelog entries with dates.
+```ts blume.config.ts lineNumbers
+seo: {
+  rss: {
+    enabled: true,
+    types: ["blog", "changelog"],
+    limit: 50,
+  },
+}
+```
+| Option    | Default                 | Description                           |
+| --------- | ----------------------- | ------------------------------------- |
+| `enabled` | `true`                  | Generate feeds.                       |
+| `types`   | `["blog", "changelog"]` | Content types that each get a feed.   |
+| `limit`   | `50`                    | Maximum items per feed, newest first. |
+Blume injects `<link rel="alternate">` tags so browsers and feed readers discover
+the feeds automatically.
+## Structured data
+Blume emits [schema.org](https://schema.org) JSON-LD in every page's `<head>` so
+search engines understand your content. On by default:
+```ts blume.config.ts lineNumbers
+seo: {
+  structuredData: true,
+}
+```
+Each page includes:
+- a **WebSite** node for site identity,
+- the page as an **article** — `BlogPosting` for blog posts, `TechArticle` for
+  changelog and docs — with its description and publish date,
+- a **BreadcrumbList** built from the navigation trail.
+URLs are absolute when `deployment.site` is set. Pages marked `seo.noindex` are
+skipped.
+## Sitemap
+Blume writes a `sitemap.xml` of every indexable page at build time. It needs an
+absolute [`deployment.site`](/docs/deployment) and lists every page except drafts,
+hidden, and `noindex` pages. On by default:
+```ts blume.config.ts lineNumbers
+seo: {
+  sitemap: true,
+}
+```
+Ship your own `public/sitemap.xml` to take over — Blume never overwrites a file
+you place in `public/`.
+## Robots
+Blume writes a `robots.txt` that allows all crawlers and adds a `Sitemap:` line
+pointing to the sitemap when one is available. On by default:
+```ts blume.config.ts lineNumbers
+seo: {
+  robots: true,
+}
+```
+```txt robots.txt
+User-agent: *
+Allow: /
+Sitemap: https://docs.example.com/sitemap.xml
+```
+Ship your own `public/robots.txt` to take over.

package/docs/configuration/theming.mdx ADDED Viewed

@@ -0,0 +1,178 @@
+---
+title: Theming
+description: Tune the look with config tokens, override any CSS variable in theme.css, or use Tailwind utilities.
+---
+Blume's theme is token-driven and works in light and dark mode out of the box.
+Reach for as little or as much as you need: a few config tokens for the common
+cases, a `theme.css` to override any design token, or Tailwind utilities for
+custom components.
+## Config tokens
+The everyday knobs live under `theme` in your config:
+```ts blume.config.ts lineNumbers
+theme: {
+  accent: "teal",   // a named preset or any CSS color
+  radius: "md",     // none | sm | md | lg
+  mode: "system",   // system | light | dark
+  fonts: {          // self-hosted Google Fonts
+    display: "inter-tight",
+    body: "inter",
+    mono: "ibm-plex-mono",
+  },
+}
+```
+### Accent
+The accent color tints interactive and highlighted elements — step markers,
+active tabs, badges, card hovers, and more. Use a named preset or any CSS color:
+```ts blume.config.ts lineNumbers
+theme: {
+  accent: "#ff0066", // hex, oklch(), rgb()… anything CSS understands
+}
+```
+Named presets: `blue` (default), `green`, `orange`, `pink`, `purple`, `red`, and
+`teal`.
+### Radius
+`radius` sets the corner rounding shared by cards, code blocks, callouts, and
+inputs — `none`, `sm`, `md` (default), or `lg`.
+### Color mode
+`mode` sets the initial color scheme:
+- **`system`** (default) — follow the reader's OS preference
+- **`light`** / **`dark`** — default to one scheme
+A toggle in the header always lets readers switch, and their choice is remembered
+across visits. Dark mode is applied with a `data-theme="dark"` attribute on the
+`<html>` element.
+### Fonts
+`fonts` sets the typefaces for three roles:
+- **`display`** — headings (`h1`–`h6`)
+- **`body`** — body text, UI, and prose
+- **`mono`** — code blocks and inline code
+Each defaults to a curated Google Font, so Blume looks intentional out of the box:
+```ts blume.config.ts lineNumbers
+theme: {
+  fonts: {
+    display: "inter-tight",   // default
+    body: "inter",            // default
+    mono: "ibm-plex-mono",    // default
+  },
+}
+```
+Set only the roles you want to change — the rest keep their defaults:
+```ts blume.config.ts lineNumbers
+theme: {
+  fonts: { display: "geist" }, // body + mono stay Inter / IBM Plex Mono
+}
+```
+Fonts are **self-hosted**: Blume downloads them at build time and serves them from
+your own site, so there's no runtime request to Google and no layout shift (Astro
+generates fallback-metric faces automatically).
+Each value is a Google Fonts slug from the curated set below:
+| Category | Slugs                                                                                                                                                            |
+| -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Sans     | `dm-sans` `figtree` `geist` `ibm-plex-sans` `inter` `inter-tight` `manrope` `open-sans` `plus-jakarta-sans` `roboto` `source-sans-3` `space-grotesk` `work-sans` |
+| Serif    | `ibm-plex-serif` `lora` `merriweather` `playfair-display` `source-serif-4`                                                                                       |
+| Mono     | `fira-code` `geist-mono` `ibm-plex-mono` `jetbrains-mono` `roboto-mono` `source-code-pro` `space-mono`                                                           |
+Need a font that isn't listed, or want to drop back to the system stack? Override
+the `--blume-font-*` tokens directly in [`theme.css`](#theme-css).
+## theme.css
+Drop a `theme.css` in your project root to override any design token. It's the
+last layer in the cascade, so it wins over the defaults and config tokens:
+```css theme.css lineNumbers
+:root {
+  --blume-accent: oklch(0.68 0.14 180);
+  --blume-radius: 0.5rem;
+}
+:root[data-theme="dark"] {
+  --blume-background: oklch(0.16 0 0);
+}
+```
+Set a token under `:root` for light mode and under `:root[data-theme="dark"]` for
+dark mode.
+### Design tokens
+| Token                       | Controls                                  |
+| --------------------------- | ----------------------------------------- |
+| `--blume-background`        | Page background                           |
+| `--blume-foreground`        | Body text                                 |
+| `--blume-muted`             | Subtle surfaces — callouts, table headers |
+| `--blume-muted-foreground`  | Secondary text                            |
+| `--blume-border`            | Borders and dividers                      |
+| `--blume-accent`            | Accent color                              |
+| `--blume-accent-foreground` | Text and icons on an accent background    |
+| `--blume-code-background`   | Code block surface                        |
+| `--blume-radius`            | Corner radius                             |
+| `--blume-font-display`      | Heading font                              |
+| `--blume-font-body`         | Body / UI font                            |
+| `--blume-font-mono`         | Code font                                 |
+Set a `--blume-font-*` token to any font stack to use a font outside the curated
+list, or to fall back to the system stack:
+```css theme.css lineNumbers
+:root {
+  --blume-font-body: ui-sans-serif, system-ui, sans-serif;
+}
+```
+## Tailwind utilities
+Blume's theme is built with Tailwind v4 internally, and your project's `.astro`,
+`.tsx`, and `.jsx` files are scanned too — so you can style custom components and
+pages with utility classes, no Tailwind setup required. Every token is exposed as
+a utility, so your components track the theme automatically:
+| Token                       | Utilities                  |
+| --------------------------- | -------------------------- |
+| `--blume-background`        | `bg-background`            |
+| `--blume-foreground`        | `text-foreground`          |
+| `--blume-muted`             | `bg-muted`                 |
+| `--blume-muted-foreground`  | `text-muted-foreground`    |
+| `--blume-border`            | `border-border`            |
+| `--blume-accent`            | `bg-accent`, `text-accent` |
+| `--blume-accent-foreground` | `text-accent-foreground`   |
+| `--blume-radius`            | `rounded-blume`            |
+| `--blume-font-display`      | `font-display`             |
+| `--blume-font-body`         | `font-sans`                |
+| `--blume-font-mono`         | `font-mono`                |
+## Cascade order
+Styles resolve in three layers, each overriding the last:
+<Steps>
+  <Step title="Base">Blume's reset, default tokens, and component styles.</Step>
+  <Step title="Config tokens">
+    `--blume-accent`, `--blume-radius`, and the `--blume-font-*` tokens from
+    `theme`.
+  </Step>
+  <Step title="theme.css">Your token overrides — the final word.</Step>
+</Steps>