bmad-method 6.0.5-next.8 → 6.1.0

package/website/src/components/Header.astro

@@ -1,96 +0,0 @@
----
-import config from 'virtual:starlight/user-config';
-import type { Props } from '@astrojs/starlight/props';
-
-import LanguageSelect from 'virtual:starlight/components/LanguageSelect';
-import Search from 'virtual:starlight/components/Search';
-import SiteTitle from 'virtual:starlight/components/SiteTitle';
-import SocialIcons from 'virtual:starlight/components/SocialIcons';
-import ThemeSelect from 'virtual:starlight/components/ThemeSelect';
-
-import Banner from './Banner.astro';
-
-/**
- * Render the `Search` component if Pagefind is enabled or the default search component has been overridden.
- */
-const shouldRenderSearch =
-	config.pagefind || config.components.Search !== '@astrojs/starlight/components/Search.astro';
----
-
-<Banner />
-<div class="header sl-flex">
-	<div class="title-wrapper sl-flex">
-		<SiteTitle {...Astro.props} />
-	</div>
-	<div class="sl-flex print:hidden">
-		{shouldRenderSearch && <Search {...Astro.props} />}
-	</div>
-	<div class="sl-hidden md:sl-flex print:hidden right-group">
-		<div class="sl-flex social-icons">
-			<SocialIcons {...Astro.props} />
-		</div>
-		<ThemeSelect {...Astro.props} />
-		<LanguageSelect {...Astro.props} />
-	</div>
-</div>
-
-<style>
-	.header {
-		gap: var(--sl-nav-gap);
-		justify-content: space-between;
-		align-items: center;
-		height: 100%;
-	}
-
-	.title-wrapper {
-		/* Prevent long titles overflowing and covering the search and menu buttons on narrow viewports. */
-		overflow: clip;
-		/* Avoid clipping focus ring around link inside title wrapper. */
-		padding: 0.25rem;
-		margin: -0.25rem;
-		min-width: 0;
-	}
-
-	.right-group,
-	.social-icons {
-		gap: 1rem;
-		align-items: center;
-	}
-
-	.social-icons::after {
-		content: '';
-		height: 2rem;
-		border-inline-end: 1px solid var(--sl-color-gray-5);
-	}
-
-	@media (min-width: 50rem) {
-		:global(:root[data-has-sidebar]) {
-			--__sidebar-pad: calc(2 * var(--sl-nav-pad-x));
-		}
-		:global(:root:not([data-has-toc])) {
-			--__toc-width: 0rem;
-		}
-		.header {
-			--__sidebar-width: max(0rem, var(--sl-content-inline-start, 0rem) - var(--sl-nav-pad-x));
-			--__main-column-fr: calc(
-				(
-						100% + var(--__sidebar-pad, 0rem) - var(--__toc-width, var(--sl-sidebar-width)) -
-							(2 * var(--__toc-width, var(--sl-nav-pad-x))) - var(--sl-content-inline-start, 0rem) -
-							var(--sl-content-width)
-					) / 2
-			);
-			display: grid;
-			grid-template-columns:
-        /* 1 (site title): runs up until the main content column’s left edge or the width of the title, whichever is the largest  */
-				minmax(
-					calc(var(--__sidebar-width) + max(0rem, var(--__main-column-fr) - var(--sl-nav-gap))),
-					auto
-				)
-				/* 2 (search box): all free space that is available. */
-				1fr
-				/* 3 (right items): use the space that these need. */
-				auto;
-			align-content: center;
-		}
-	}
-</style>

package/website/src/components/MobileMenuFooter.astro

@@ -1,33 +0,0 @@
----
-import LanguageSelect from 'virtual:starlight/components/LanguageSelect';
-import SocialIcons from 'virtual:starlight/components/SocialIcons';
-import ThemeSelect from 'virtual:starlight/components/ThemeSelect';
-import type { Props } from '@astrojs/starlight/props';
----
-
-<div class="mobile-preferences sl-flex">
-	<div class="sl-flex social-icons">
-		<SocialIcons {...Astro.props} />
-	</div>
-	<ThemeSelect {...Astro.props} />
-	<LanguageSelect {...Astro.props} />
-</div>
-
-<style>
-	.social-icons {
-		gap: 1rem;
-		align-items: center;
-		padding-block: 1rem;
-	}
-	.social-icons:empty {
-		display: none;
-	}
-	.mobile-preferences {
-		justify-content: space-between;
-		flex-wrap: wrap;
-		border-top: 1px solid var(--sl-color-gray-6);
-		column-gap: 1rem;
-		padding: 0.5rem 0;
-		align-items: center;
-	}
-</style>

package/website/src/content/config.ts

@@ -1,7 +0,0 @@
-import { defineCollection } from 'astro:content';
-import { docsSchema, i18nSchema } from '@astrojs/starlight/schema';
-
-export const collections = {
-  docs: defineCollection({ schema: docsSchema() }),
-  i18n: defineCollection({ type: 'data', schema: i18nSchema() }),
-};

package/website/src/content/i18n/zh-CN.json

@@ -1,28 +0,0 @@
-{
-  "skipLink.label": "跳转到内容",
-  "search.label": "搜索",
-  "search.ctrlKey": "Ctrl",
-  "search.cancelLabel": "取消",
-  "themeSelect.accessibleLabel": "选择主题",
-  "themeSelect.dark": "深色",
-  "themeSelect.light": "浅色",
-  "themeSelect.auto": "自动",
-  "languageSelect.accessibleLabel": "选择语言",
-  "menuButton.accessibleLabel": "菜单",
-  "sidebarNav.accessibleLabel": "主导航",
-  "tableOfContents.onThisPage": "本页内容",
-  "tableOfContents.overview": "概述",
-  "i18n.untranslatedContent": "此内容尚未提供中文翻译。",
-  "page.editLink": "编辑页面",
-  "page.lastUpdated": "最后更新：",
-  "page.previousLink": "上一页",
-  "page.nextLink": "下一页",
-  "page.draft": "此内容为草稿，不会包含在正式版本中。",
-  "404.text": "页面未找到。请检查 URL 或尝试使用搜索。",
-  "aside.note": "注意",
-  "aside.tip": "提示",
-  "aside.caution": "警告",
-  "aside.danger": "危险",
-  "fileTree.directory": "目录",
-  "builtWithStarlight.label": "使用 Starlight 构建"
-}

package/website/src/lib/site-url.mjs

@@ -1,25 +0,0 @@
-/**
- * Resolve the site's base URL using cascading environment defaults.
- *
- * Preference order: use SITE_URL if set; otherwise derive a GitHub Pages URL from GITHUB_REPOSITORY; otherwise use the local development URL.
- * @returns {string} The resolved site URL (SITE_URL override, or `https://{owner}.github.io/{repo}`, or `http://localhost:3000`).
- */
-export function getSiteUrl() {
-  // Explicit override (works in both local and GitHub Actions)
-  if (process.env.SITE_URL) {
-    return process.env.SITE_URL;
-  }
-
-  // GitHub Actions: compute from repository context
-  if (process.env.GITHUB_REPOSITORY) {
-    const parts = process.env.GITHUB_REPOSITORY.split('/');
-    if (parts.length !== 2 || !parts[0] || !parts[1]) {
-      throw new Error(`Invalid GITHUB_REPOSITORY format: "${process.env.GITHUB_REPOSITORY}". Expected "owner/repo".`);
-    }
-    const [owner, repo] = parts;
-    return `https://${owner}.github.io/${repo}`;
-  }
-
-  // Local development: use dev server
-  return 'http://localhost:3000';
-}

package/website/src/pages/404.astro

@@ -1,11 +0,0 @@
----
-import StarlightPage from '@astrojs/starlight/components/StarlightPage.astro';
-import { getEntry } from 'astro:content';
-
-const entry = await getEntry('docs', '404');
-const { Content } = await entry.render();
----
-
-<StarlightPage frontmatter={{ title: entry.data.title, template: entry.data.template }}>
-  <Content />
-</StarlightPage>

package/website/src/pages/robots.txt.ts

@@ -1,48 +0,0 @@
-import type { APIRoute } from 'astro';
-
-export const GET: APIRoute = ({ site }) => {
-  const siteUrl = site?.href.replace(/\/$/, '') ?? '';
-
-  const body = `# BMAD Method Documentation
-# ${siteUrl}/
-#
-# This file controls web crawler access to the documentation site.
-
-User-agent: *
-Allow: /
-
-# LLM-friendly documentation files
-# These are specifically designed for AI consumption
-# llms.txt - Concise overview with navigation
-# llms-full.txt - Complete documentation in plain text
-
-# AI Crawlers - Welcome!
-User-agent: GPTBot
-Allow: /
-
-User-agent: ChatGPT-User
-Allow: /
-
-User-agent: Google-Extended
-Allow: /
-
-User-agent: CCBot
-Allow: /
-
-User-agent: anthropic-ai
-Allow: /
-
-User-agent: Claude-Web
-Allow: /
-
-User-agent: cohere-ai
-Allow: /
-
-# Sitemap
-Sitemap: ${siteUrl}/sitemap-index.xml
-`;
-
-  return new Response(body, {
-    headers: { 'Content-Type': 'text/plain; charset=utf-8' },
-  });
-};

package/website/src/rehype-base-paths.js

@@ -1,112 +0,0 @@
-/**
- * Rehype plugin to prepend base path to absolute URLs
- *
- * Transforms:
- *   /img/foo.png → /BMAD-METHOD/img/foo.png (when base is /BMAD-METHOD/)
- *   /llms.txt → /BMAD-METHOD/llms.txt
- *
- * Supported elements:
- *   - img[src], iframe[src], video[src], source[src], audio[src]
- *   - a[href], link[href]
- *
- * Only affects absolute paths (/) - relative paths and external URLs are unchanged.
- * Does NOT process .md links (those are handled by rehype-markdown-links).
- */
-
-import { visit } from 'unist-util-visit';
-
-/**
- * Create a rehype plugin that prepends the base path to absolute URLs.
- *
- * @param {Object} options - Plugin options
- * @param {string} options.base - The base path to prepend (e.g., '/BMAD-METHOD/')
- * @returns {function} A HAST tree transformer
- */
-export default function rehypeBasePaths(options = {}) {
-  const base = options.base || '/';
-
-  // Normalize base: ensure trailing slash so concatenation with path.slice(1) (no leading /)
-  // produces correct paths like /BMAD-METHOD/img/foo.png.
-  // Note: rehype-markdown-links uses the opposite convention (strips trailing slash) because
-  // it concatenates with paths that start with /.
-  const normalizedBase = base === '/' ? '/' : base.endsWith('/') ? base : base + '/';
-
-  /**
-   * Prepend base path to an absolute URL attribute if needed.
-   * Skips protocol-relative URLs (//) and paths that already include the base.
-   *
-   * @param {object} node - HAST element node
-   * @param {string} attr - Attribute name ('src' or 'href')
-   */
-  function prependBase(node, attr) {
-    const value = node.properties?.[attr];
-    if (typeof value !== 'string' || !value.startsWith('/') || value.startsWith('//')) {
-      return;
-    }
-    if (normalizedBase !== '/' && !value.startsWith(normalizedBase)) {
-      node.properties[attr] = normalizedBase + value.slice(1);
-    }
-  }
-
-  return (tree) => {
-    // Handle raw HTML blocks (inline HTML in markdown that isn't parsed into HAST elements)
-    if (normalizedBase !== '/') {
-      visit(tree, 'raw', (node) => {
-        // Replace absolute src="/..." and href="/..." attributes, skipping protocol-relative
-        // and paths that already have the base prefix
-        node.value = node.value.replace(/(?<attr>\b(?:src|href))="(?<path>\/(?!\/)[^"]*)"/g, (match, attr, pathValue) => {
-          if (pathValue.startsWith(normalizedBase)) return match;
-          return `${attr}="${normalizedBase}${pathValue.slice(1)}"`;
-        });
-      });
-    }
-
-    visit(tree, 'element', (node) => {
-      const tag = node.tagName;
-
-      // Tags with src attribute
-      if (['img', 'iframe', 'video', 'source', 'audio'].includes(tag)) {
-        prependBase(node, 'src');
-      }
-
-      // Link tags with href attribute (stylesheets, preloads, etc.)
-      if (tag === 'link') {
-        prependBase(node, 'href');
-      }
-
-      // Anchor tags need special handling - skip .md links
-      if (tag === 'a' && node.properties?.href) {
-        const href = node.properties.href;
-
-        if (typeof href !== 'string') {
-          return;
-        }
-
-        // Only transform absolute paths starting with / (but not //)
-        if (!href.startsWith('/') || href.startsWith('//')) {
-          return;
-        }
-
-        // Skip if already has the base path
-        if (normalizedBase !== '/' && href.startsWith(normalizedBase)) {
-          return;
-        }
-
-        // Skip .md links - those are handled by rehype-markdown-links
-        // Extract path portion (before ? and #)
-        const firstDelimiter = Math.min(
-          href.indexOf('?') === -1 ? Infinity : href.indexOf('?'),
-          href.indexOf('#') === -1 ? Infinity : href.indexOf('#'),
-        );
-        const pathPortion = firstDelimiter === Infinity ? href : href.substring(0, firstDelimiter);
-
-        if (pathPortion.endsWith('.md')) {
-          return; // Let rehype-markdown-links handle this
-        }
-
-        // Prepend base path
-        node.properties.href = normalizedBase + href.slice(1);
-      }
-    });
-  };
-}

package/website/src/rehype-markdown-links.js

@@ -1,119 +0,0 @@
-/**
- * Rehype plugin to transform relative .md links into correct site URLs.
- *
- * Uses the source file's disk path (via vfile) to resolve the link target,
- * then computes the output URL relative to the content root directory.
- * This correctly handles Starlight's directory-per-page URL structure
- * where ./sibling.md from reference/testing.md must become /reference/sibling/
- * (not ./sibling/ which would resolve to /reference/testing/sibling/).
- *
- * Supports: ./sibling.md, ../other/page.md, bare.md, /docs/absolute.md
- * Preserves: query strings, hash anchors
- * Skips: external URLs, non-.md links
- */
-
-import { visit } from 'unist-util-visit';
-import path from 'node:path';
-
-/**
- * @param {Object} options
- * @param {string} options.base - Site base path (e.g., '/BMAD-METHOD/')
- * @param {string} [options.contentDir] - Absolute path to content root; auto-detected if omitted
- */
-export default function rehypeMarkdownLinks(options = {}) {
-  const base = options.base || '/';
-  const normalizedBase = base === '/' ? '' : base.replace(/\/$/, '');
-
-  return (tree, file) => {
-    // The current file's absolute path on disk, set by Astro's markdown pipeline
-    const currentFilePath = file.path;
-    if (!currentFilePath) return;
-
-    // Auto-detect content root: walk up from current file to find src/content/docs
-    const contentDir = options.contentDir || detectContentDir(currentFilePath);
-    if (!contentDir) {
-      throw new Error(`[rehype-markdown-links] Could not detect content directory for: ${currentFilePath}`);
-    }
-
-    visit(tree, 'element', (node) => {
-      if (node.tagName !== 'a' || typeof node.properties?.href !== 'string') {
-        return;
-      }
-
-      const href = node.properties.href;
-
-      // Skip external links (including protocol-relative URLs like //cdn.example.com)
-      if (href.includes('://') || href.startsWith('//') || href.startsWith('mailto:') || href.startsWith('tel:')) {
-        return;
-      }
-
-      // Split href into path vs query+fragment suffix
-      const delimIdx = findFirstDelimiter(href);
-      const linkPath = delimIdx === -1 ? href : href.substring(0, delimIdx);
-      const suffix = delimIdx === -1 ? '' : href.substring(delimIdx);
-
-      // Only process .md links
-      if (!linkPath.endsWith('.md')) return;
-
-      // Resolve the target file's absolute path on disk
-      let targetPath;
-      if (linkPath.startsWith('/docs/')) {
-        // Absolute /docs/ path — resolve from content root
-        targetPath = path.join(contentDir, linkPath.slice(5)); // strip '/docs'
-      } else if (linkPath.startsWith('/')) {
-        // Other absolute paths — resolve from content root
-        targetPath = path.join(contentDir, linkPath);
-      } else {
-        // Relative path (./sibling.md, ../other.md, bare.md) — resolve from current file
-        targetPath = path.resolve(path.dirname(currentFilePath), linkPath);
-      }
-
-      // Compute the target's path relative to content root
-      const relativeToContent = path.relative(contentDir, targetPath);
-
-      // Safety: skip if target resolves outside content root
-      if (relativeToContent.startsWith('..')) return;
-
-      // Convert file path to URL: strip .md, handle index, ensure leading/trailing slashes
-      let urlPath = relativeToContent.replace(/\.md$/, '');
-
-      // index.md becomes the directory root
-      if (urlPath.endsWith('/index') || urlPath === 'index') {
-        urlPath = urlPath.slice(0, -'index'.length);
-      }
-
-      // Build absolute URL with base path, normalizing any double slashes
-      const raw = normalizedBase + '/' + urlPath.replace(/\/?$/, '/') + suffix;
-      node.properties.href = raw.replace(/\/\/+/g, '/');
-    });
-  };
-}
-
-/** Find the index of the first ? or # in a string, or -1 if neither exists. */
-export function findFirstDelimiter(str) {
-  const q = str.indexOf('?');
-  const h = str.indexOf('#');
-  if (q === -1) return h;
-  if (h === -1) return q;
-  return Math.min(q, h);
-}
-
-/** Walk up from a file path to find the content docs directory. */
-export function detectContentDir(filePath) {
-  const segments = filePath.split(path.sep);
-  // Look for src/content/docs in the path (standard Astro)
-  for (let i = segments.length - 1; i >= 2; i--) {
-    if (segments[i - 2] === 'src' && segments[i - 1] === 'content' && segments[i] === 'docs') {
-      return segments.slice(0, i + 1).join(path.sep);
-    }
-  }
-  // Also check for a standalone 'docs' directory (BMAD project structure)
-  // Path format: .../bmm/docs/file.mdx or .../bmm/website/...
-  for (let i = segments.length - 1; i >= 0; i--) {
-    if (segments[i] === 'docs') {
-      // Found docs directory - use its parent as the content root
-      return segments.slice(0, i + 1).join(path.sep);
-    }
-  }
-  return null;
-}