npm - blume - Versions diffs - 0.6.7 → 0.8.0 - Mend

blume 0.6.7 → 0.8.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 (211) hide show

package/CHANGELOG.md +618 -0
package/LICENSE +21 -0
package/README.md +107 -0
package/dist/cli/index.js +2609 -1041
package/dist/cli/index.js.map +110 -103
package/dist/types/ai/component-markdown.d.ts +34 -0
package/dist/types/components/content/youtube.d.ts +18 -0
package/dist/types/core/base-path.d.ts +47 -0
package/dist/types/core/config-input.d.ts +110 -12
package/dist/types/core/config.d.ts +6 -4
package/dist/types/core/data.d.ts +4 -0
package/dist/types/core/i18n-ui.d.ts +477 -135
package/dist/types/core/schema.d.ts +309 -195
package/dist/types/core/sources/types.d.ts +2 -0
package/dist/types/core/types.d.ts +6 -1
package/dist/types/index.d.ts +1 -0
package/dist/types/openapi/references.d.ts +60 -0
package/docs/01-quickstart.mdx +5 -2
package/docs/02-deployment.mdx +24 -9
package/docs/03-faq.mdx +46 -16
package/docs/advanced/custom-pages.mdx +1 -1
package/docs/advanced/skills.mdx +1 -1
package/docs/configuration/ai.mdx +49 -10
package/docs/configuration/customization.mdx +11 -0
package/docs/configuration/index.mdx +33 -3
package/docs/configuration/seo.mdx +2 -2
package/docs/content/components.mdx +30 -3
package/docs/content/i18n.mdx +1 -1
package/docs/content/islands.mdx +8 -0
package/docs/content/navigation.mdx +3 -3
package/docs/content/sources.mdx +1 -1
package/docs/content/syntax.mdx +17 -2
package/docs/index.mdx +2 -2
package/docs/reference/cli.mdx +8 -6
package/package.json +15 -4
package/skills/blume/SKILL.md +5 -3
package/skills/blume-update-docs/SKILL.md +3 -2
package/src/ai/agent-readability.ts +11 -5
package/src/ai/ask-context.ts +7 -2
package/src/ai/ask-data.ts +3 -0
package/src/ai/ask.ts +12 -7
package/src/ai/component-markdown.ts +461 -0
package/src/ai/llms.ts +143 -23
package/src/ai/markdown.ts +35 -6
package/src/ai/mcp/data.ts +33 -8
package/src/ai/mcp/discovery.ts +10 -3
package/src/ai/mcp/server.ts +24 -7
package/src/ai/visibility.ts +74 -0
package/src/astro/component-slots.ts +16 -4
package/src/astro/examples.ts +12 -7
package/src/astro/generate.ts +393 -189
package/src/astro/index.ts +5 -1
package/src/astro/integration.ts +9 -5
package/src/astro/islands.ts +11 -5
package/src/astro/markdown-negotiation.ts +2 -2
package/src/astro/pages.ts +89 -22
package/src/astro/templates.ts +259 -25
package/src/blume-modules.d.ts +8 -0
package/src/cli/commands/build.ts +131 -38
package/src/cli/commands/check.ts +1 -1
package/src/cli/commands/dev.ts +71 -17
package/src/cli/commands/doctor.ts +2 -2
package/src/cli/commands/eject.ts +47 -19
package/src/cli/commands/init.ts +120 -180
package/src/cli/commands/preview.ts +4 -1
package/src/cli/commands/validate.ts +44 -2
package/src/cli/dev-lock.ts +34 -19
package/src/cli/eject-scripts.ts +72 -0
package/src/cli/env.ts +15 -5
package/src/cli/init/questions.ts +158 -0
package/src/cli/init/scaffold.ts +380 -0
package/src/cli/required-secrets.ts +2 -1
package/src/components/content/AccordionItem.astro +23 -4
package/src/components/content/Badge.astro +3 -1
package/src/components/content/Card.astro +4 -2
package/src/components/content/CodeBlock.astro +3 -0
package/src/components/content/Component.astro +30 -16
package/src/components/content/Diff.astro +3 -1
package/src/components/content/Step.astro +10 -1
package/src/components/content/Tabs.astro +15 -3
package/src/components/content/Tile.astro +2 -1
package/src/components/content/Tooltip.astro +3 -1
package/src/components/content/Update.astro +9 -2
package/src/components/content/auto-type-table.ts +25 -9
package/src/components/content/base-href.ts +33 -0
package/src/components/content/changelog-element.ts +9 -2
package/src/components/content/diff.ts +12 -6
package/src/components/content/mermaid-element.ts +10 -2
package/src/components/index.ts +23 -1
package/src/components/islands/AskAI.astro +5 -2
package/src/components/islands/ask-ai.tsx +68 -12
package/src/components/islands/base-path.ts +28 -0
package/src/components/islands/hooks.ts +44 -9
package/src/components/layout/Banner.astro +12 -3
package/src/components/layout/Breadcrumbs.astro +2 -1
package/src/components/layout/Favicon.astro +3 -2
package/src/components/layout/Header.astro +15 -5
package/src/components/layout/LanguageSwitcher.astro +2 -1
package/src/components/layout/Logo.astro +13 -4
package/src/components/layout/NavSelector.astro +2 -1
package/src/components/layout/NavTree.astro +22 -7
package/src/components/layout/PageActions.astro +25 -10
package/src/components/layout/PageFeedback.astro +4 -1
package/src/components/layout/PageLayout.astro +51 -9
package/src/components/layout/Pagination.astro +3 -2
package/src/components/layout/ReferenceLayout.astro +8 -1
package/src/components/layout/RootLayout.astro +74 -13
package/src/components/layout/Search.astro +107 -27
package/src/components/layout/nav-utils.ts +18 -10
package/src/components/layout/search/algolia.ts +11 -2
package/src/components/layout/search/endpoint.ts +11 -5
package/src/components/layout/search/orama-cloud.ts +8 -2
package/src/components/layout/search/pagefind.ts +3 -0
package/src/components/layout/search/types.ts +5 -1
package/src/components/layout/search/typesense.ts +4 -1
package/src/components/layout/toc-element.ts +8 -2
package/src/components/openapi/ApiTagOperations.astro +2 -1
package/src/components/openapi/Operation.astro +47 -40
package/src/components/openapi/RequestPanel.astro +8 -2
package/src/components/openapi/helpers.ts +71 -3
package/src/components/openapi/panel.ts +1 -1
package/src/components/openapi/snippets.ts +25 -11
package/src/core/base-path.ts +94 -0
package/src/core/builtin-tags.ts +2 -0
package/src/core/component-overrides.ts +103 -74
package/src/core/config-input.ts +118 -17
package/src/core/config.ts +8 -5
package/src/core/content.ts +2 -0
package/src/core/data.ts +4 -0
package/src/core/diagnostics.ts +54 -34
package/src/core/gitignore.ts +4 -1
package/src/core/graph.ts +166 -88
package/src/core/i18n-ui.ts +63 -3
package/src/core/last-modified.ts +15 -6
package/src/core/links.ts +69 -25
package/src/core/manifest.ts +62 -45
package/src/core/nav-diagnostics.ts +1 -1
package/src/core/navigation.ts +144 -58
package/src/core/package-json.ts +17 -2
package/src/core/project-graph.ts +25 -15
package/src/core/schema.ts +605 -620
package/src/core/sources/assets.ts +6 -1
package/src/core/sources/filesystem.ts +4 -0
package/src/core/sources/github-releases.ts +2 -1
package/src/core/sources/mdx-remote.ts +76 -63
package/src/core/sources/normalize.ts +236 -91
package/src/core/sources/notion.ts +27 -18
package/src/core/sources/types.ts +2 -0
package/src/core/tsconfig-aliases.ts +59 -30
package/src/core/types.ts +6 -1
package/src/core/ui-packs/ar.ts +1 -0
package/src/core/ui-packs/bg.ts +1 -0
package/src/core/ui-packs/bn.ts +1 -0
package/src/core/ui-packs/ca.ts +1 -0
package/src/core/ui-packs/cs.ts +1 -0
package/src/core/ui-packs/da.ts +1 -0
package/src/core/ui-packs/de.ts +1 -0
package/src/core/ui-packs/el.ts +1 -0
package/src/core/ui-packs/es.ts +1 -0
package/src/core/ui-packs/fa.ts +1 -0
package/src/core/ui-packs/fi.ts +1 -0
package/src/core/ui-packs/fr.ts +2 -1
package/src/core/ui-packs/he.ts +1 -0
package/src/core/ui-packs/hi.ts +1 -0
package/src/core/ui-packs/hr.ts +1 -0
package/src/core/ui-packs/hu.ts +1 -0
package/src/core/ui-packs/id.ts +1 -0
package/src/core/ui-packs/it.ts +1 -0
package/src/core/ui-packs/ja.ts +1 -0
package/src/core/ui-packs/ko.ts +1 -0
package/src/core/ui-packs/nl.ts +1 -0
package/src/core/ui-packs/no.ts +1 -0
package/src/core/ui-packs/pl.ts +1 -0
package/src/core/ui-packs/pt-br.ts +1 -0
package/src/core/ui-packs/pt.ts +1 -0
package/src/core/ui-packs/ro.ts +1 -0
package/src/core/ui-packs/ru.ts +1 -0
package/src/core/ui-packs/sk.ts +1 -0
package/src/core/ui-packs/sr.ts +1 -0
package/src/core/ui-packs/sv.ts +1 -0
package/src/core/ui-packs/th.ts +1 -0
package/src/core/ui-packs/tr.ts +1 -0
package/src/core/ui-packs/uk.ts +1 -0
package/src/core/ui-packs/vi.ts +1 -0
package/src/core/ui-packs/zh-tw.ts +1 -0
package/src/core/ui-packs/zh.ts +1 -0
package/src/deploy/adapter-output.ts +18 -8
package/src/deploy/redirects.ts +25 -2
package/src/deploy/robots.ts +6 -1
package/src/deploy/rss.ts +10 -3
package/src/deploy/sitemap.ts +59 -13
package/src/index.ts +5 -0
package/src/markdown/base-links.ts +60 -0
package/src/markdown/code-title.ts +11 -14
package/src/markdown/index.ts +46 -9
package/src/markdown/inline-code.ts +14 -4
package/src/markdown/package-commands.ts +10 -4
package/src/markdown/themes.ts +24 -0
package/src/openapi/model.ts +15 -5
package/src/openapi/parse.ts +21 -0
package/src/openapi/references.ts +75 -21
package/src/openapi/render-mdx.ts +11 -6
package/src/openapi/scalar.ts +32 -16
package/src/openapi/source.ts +59 -10
package/src/registry/eject.ts +247 -19
package/src/registry/registry.ts +0 -3
package/src/search/build.ts +3 -0
package/src/search/documents.ts +36 -4
package/src/search/sync/typesense.ts +6 -4
package/src/seo/jsonld.ts +28 -17
package/src/theme/entry.ts +85 -20

package/src/theme/entry.ts CHANGED Viewed

@@ -12,25 +12,16 @@ interface TailwindEntryOptions {
   twoslashCss?: string;
 }
+/** Dark mode is driven by `data-theme` on the root element (both sheets). */
+const DARK_VARIANT = `/* Dark mode is driven by data-theme on the <html> element. */
+@custom-variant dark (&:where([data-theme="dark"], [data-theme="dark"] *));`;
 /**
- * Build the single Tailwind v4 entry stylesheet for the generated runtime.
- *
- * Everything flows through one Tailwind-processed file so utilities are
- * generated and design tokens cascade deterministically:
- * base defaults -> config tokens -> user theme.css.
+ * The default `--blume-*` design tokens (light + dark), shared by the app
+ * sheet and the isolated example-preview sheet so previews inherit the site's
+ * palette by default.
  */
-export const tailwindEntryTemplate = (options: TailwindEntryOptions): string =>
-  `/* Generated by Blume. Do not edit. */
-@import "tailwindcss";
-@plugin "@tailwindcss/typography";
-/* Scan Blume's components and the user's project for utility classes. */
-${options.sources.map((source) => `@source "${source}";`).join("\n")}
-/* Dark mode is driven by data-theme on the <html> element. */
-@custom-variant dark (&:where([data-theme="dark"], [data-theme="dark"] *));
-:root {
+const TOKEN_DEFAULTS = `:root {
   --blume-background: oklch(1 0 0);
   --blume-background-image: none;
   --blume-background-image-repeat: no-repeat;
@@ -108,9 +99,15 @@ ${options.sources.map((source) => `@source "${source}";`).join("\n")}
   --blume-code-remove-border: oklch(0.7 0.2 22 / 0.7);
   --blume-code-word: oklch(0.7 0.14 255 / 0.22);
   --blume-code-word-border: oklch(0.7 0.14 255 / 0.55);
-}
+}`;
-@theme inline {
+/**
+ * Tailwind theme mapping from `--blume-*` tokens to utility-facing names
+ * (`bg-background`, `border-border`, `rounded-blume`, the font stacks).
+ * Shared by both sheets so example code written against Blume's utility
+ * vocabulary renders identically inside the isolated preview frame.
+ */
+const THEME_MAPPING = `@theme inline {
   --color-background: var(--blume-background);
   --color-foreground: var(--blume-foreground);
   --color-muted: var(--blume-muted);
@@ -125,7 +122,28 @@ ${options.sources.map((source) => `@source "${source}";`).join("\n")}
   --font-sans: var(--blume-font-body);
   --font-mono: var(--blume-font-mono);
   --font-display: var(--blume-font-display);
-}
+}`;
+/**
+ * Build the single Tailwind v4 entry stylesheet for the generated runtime.
+ *
+ * Everything flows through one Tailwind-processed file so utilities are
+ * generated and design tokens cascade deterministically:
+ * base defaults -> config tokens -> user theme.css.
+ */
+export const tailwindEntryTemplate = (options: TailwindEntryOptions): string =>
+  `/* Generated by Blume. Do not edit. */
+@import "tailwindcss";
+@plugin "@tailwindcss/typography";
+/* Scan Blume's components and the user's project for utility classes. */
+${options.sources.map((source) => `@source "${source}";`).join("\n")}
+${DARK_VARIANT}
+${TOKEN_DEFAULTS}
+${THEME_MAPPING}
 @layer base {
   /* Nothing refuses to shrink below its intrinsic content width. This global
@@ -670,3 +688,50 @@ ${options.twoslashCss ?? ""}
 ${options.configTokens}
 ${options.userTheme}
 `;
+interface ExamplesEntryOptions {
+  /** Config-derived token overrides (`:root { --blume-accent: ... }`). */
+  configTokens: string;
+  /** Globs to scan for utility classes (example files and their imports). */
+  sources: string[];
+  /** Raw contents of the configured `examples.css`, if any. */
+  userCss: string;
+}
+/**
+ * Build the Tailwind entry for `<Component />` preview frames. Each example
+ * renders in its own iframe so none of the app sheet above — prose typography,
+ * component chrome, base overrides — can reach it. This sheet provides only
+ * what an example needs to look like it does in an app: Tailwind (preflight +
+ * utilities scanned from the example sources), the `--blume-*` tokens and
+ * their utility mapping (so `bg-background`-style classes keep working and
+ * previews follow the site palette by default), and the user's example CSS
+ * (shadcn variables, `@theme` mappings, custom styles) last so it wins.
+ */
+export const examplesEntryTemplate = (options: ExamplesEntryOptions): string =>
+  `/* Generated by Blume. Do not edit. */
+@import "tailwindcss";
+/* Scan the example files and the project sources they import. */
+${options.sources.map((source) => `@source "${source}";`).join("\n")}
+${DARK_VARIANT}
+${TOKEN_DEFAULTS}
+${THEME_MAPPING}
+/* Frame defaults: readable text in both modes, transparent so the docs pane's
+   surface shows through. Base layer, so any user/example CSS wins. */
+@layer base {
+  body {
+    background: transparent;
+    color: var(--blume-foreground);
+  }
+}
+/* Token overrides: config first, then the configured examples css (highest
+   priority) — the place for shadcn variables and other component tokens. */
+${options.configTokens}
+${options.userCss}
+`;