@primer/brand-mcp 0.69.0 → 0.70.0-rc.11ae3568

package/README.md

@@ -6,15 +6,16 @@ It is a version-aware, `stdio` (local) server which reads the docs and metadata
 
 ## Tools
 
-| Tool                     | What it does                                                                                                                      |
-| ------------------------ | --------------------------------------------------------------------------------------------------------------------------------- |
-| `primer_brand_setup`     | Framework-aware setup (Auto-installs `ThemeProvider`, Mona Sans fonts, styles, `'use client'` for RSC) - the parts agents forget. |
-| `primer_brand_component` | List components, or get one component's API: props, allowed values, sub-components, and examples.                                 |
-| `primer_brand_examples`  | Ranked, copy-and-adapt examples for a goal, taken from the library's own tested stories. Falls back to a default set.             |
-| `primer_brand_tokens`    | Resolve design tokens by intent (color, space, typography) to CSS variables and values.                                           |
-| `primer_brand_asset`     | Find Octicons (`@primer/octicons-react`) and Octovisuals (`@primer/octovisuals-react`) as code imports.                           |
-| `primer_brand_docs`      | Search and read Primer Brand guidance (principles, accessibility, getting started).                                               |
-| `primer_brand_review`    | Check generated JSX/CSS against the design system: unknown components, invalid props, hardcoded values, off-brand tells.          |
+| Tool                       | What it does                                                                                                                                         |
+| -------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `primer_brand_setup`       | Configures Primer Brand first-time. Includes `ThemeProvider`, Mona Sans and RSC-directive configuration among other things                           |
+| `primer_brand_page_design` | Page-design conventions (header/footer, hero media, gridline aesthetic, card grids, labels) and the current-brand reference templates to start from. |
+| `primer_brand_component`   | Get a component API information like props, allowed values and named sub-components.                                                                 |
+| `primer_brand_examples`    | Reference examples taken from our Storybook.                                                                                                         |
+| `primer_brand_tokens`      | Resolve design tokens by intent (color, space, typography) to CSS variables and values.                                                              |
+| `primer_brand_asset`       | Find Octicons (`@primer/octicons-react`) and Octovisuals (`@primer/octovisuals-react`) more easily                                                   |
+| `primer_brand_docs`        | Search and read Primer Brand guidance, including principles, accessibility and getting started.                                                      |
+| `primer_brand_review`      | Check generated JSX and CSS against the design system for unknown components, invalid props, hardcoded values                                        |
 
 ## Getting started
 

package/content/page-design.md

@@ -0,0 +1,76 @@
+# Page design patterns
+
+These are the page design guidelines for GitHub marketing and landing pages, beyond what the component APIs or documentation guidelines recommend. Apply these by default unless the brief says otherwise. These are **design conventions** and the `primer_brand_review` tool does not flag them, so consult this before composing a page.
+
+Learn individual component APIs and usage with `primer_brand_docs` and `primer_brand_component`. This guide is the step after: how to lay out an entire page and use those components alongside your custom ones correctly.
+
+## Start here
+
+The Flexsuite recipe templates are the current canonical source of truth for what GitHub web pages should look like today. Every component in them reflects the latest brand, unlike many older standalone examples. Use them as your
+starting point and reference, and mirror their composition and section order:
+
+- **Overview / landing page** — `FlexSuiteAIOverview` (hero with media, logo suite, gridline card
+  grids, rivers, pricing, FAQ, footer).
+- **Category page** — `FlexSuiteSecurityCategory`.
+- **Details page** — `FlexSuiteAIDetailsPlaylist`.
+
+Pull adaptable component snippets with `primer_brand_examples`.
+
+## Aesthetic: prefer the gridline look
+
+`@primer/react-brand` spans multiple generations of GitHub's design language, and many components expose that choice as a variant or prop. **Gridline** is the current brand direction. It's a connected, ruled-line aesthetic, as seen throughout the Flexsuite templates. Bias toward it.
+
+- **Do** — when a component offers a gridline-family option, choose it over the older or default look. "Expressive" gridline options are a more pronounced sub-variant of the same aesthetic, not a competing style; reach for them where a section wants extra emphasis.
+- **Don't** — settle for a component's plainest or legacy variant, or borrow section layouts from an older brand generation, when a gridline equivalent exists.
+
+Confirm the exact options with `primer_brand_component` rather than assuming which variants a component has — the specific names evolve over time.
+
+## Page structure
+
+### Frame every page with a header and footer
+
+Every full page should be framed top and bottom, unless the user has requested a custom implementation.
+
+- **Do** — use `SubdomainNavBar` at the top and `MinimalFooter` at the bottom (APIs via `primer_brand_component`).
+- **Don't** — hand-roll a `<header>`, `<nav>`, or `<footer>` unless user has a separate plan for it.
+
+### Spacing
+
+Generous spacing is what lets a layout breathe; the Flexsuite recipes are a good reference for the rhythm to aim for.
+
+- **Do** — use `Box` and `Stack` (both have responsive spacing props) to add consistent rhythm between sections.
+- **Don't** — pack sections edge-to-edge or hand-roll ad-hoc margins.
+
+## Component & element patterns
+
+### Heroes carry media
+
+A text-only hero reads as unfinished; heroes should carry a visual.
+
+- **Do** — give `Hero` a `Hero.Image` (or `Hero.Video`); source imagery from `primer_brand_asset` (Octovisuals) or generate it with the Asset Generator MCP (see _Generated imagery_ below).
+- **Don't** — ship a bare, text-only hero.
+
+### Generated imagery adds color and interest
+
+Bring on-brand color and life to the page with the Asset Generator MCP (when installed) instead of leaving large areas flat — most pages want at least one generated visual.
+
+- **Do** — use **`create_product_landscape`** when the visual demos a product or feature (a hero or section showing the thing itself), and **`create_wallpaper`** for everything else, to add a colorful on-brand backdrop or accent. Browse the current set with `list_templates` / `list_themes` and pick a theme that fits the page's topic.
+- **Don't** — reach for social media-specific templates like `create_social_square` or `create_landscape` when a product shot or wallpaper fits better.
+
+### Group cards inside gridlines
+
+A grid of items (features, pathways, plans) uses the connected **gridline** grid, not floating cards.
+
+- **Do** — render a `Grid` with `columnGap="none" rowGap="none" enableGutters={false}` inside a bordered frame and let the frame draw the shared lines. Refer to the Flexsuite recipes for an example of this.
+- **Don't** — output separate bordered `Card`s with gaps between them.
+
+### Labels hug their content
+
+Eyebrow/section labels are intrinsic width; stretching them reads as off-brand.
+
+- **Do** — let `Hero.Label` / `SectionIntro.Label` / `EyebrowText` size to their content; alignment follows the section (start by default, or centered inside a centered `SectionIntro`).
+- **Don't** — set a label full-width or give it a block/full-bleed background.
+
+## General guidance
+
+- If browser tooling (e.g. the Playwright MCP) is available, verify your work visually before finishing: serve the page locally, open it, and take screenshots across different breakpoints. Review the screenshots against this guidance and automatically fix obvious defects like clipped or overflowing content, cramped spacing, stretched/full-width labels that should preserve their intrinsic width, low-contrast text, a text-only hero, broken images, and off-brand tells (glows, purple gradients, pill buttons, glassmorphism, placeholder copy). Re-screenshot to confirm the fixes.

package/dist/brand/detect-asset-generator.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Returns true when the `asset-generator-mcp` CLI is resolvable on PATH
+ */
+export declare function detectAssetGenerator(env?: NodeJS.ProcessEnv): {
+    available: boolean;
+};

package/dist/brand/detect-asset-generator.js

@@ -0,0 +1,21 @@
+import { existsSync } from 'node:fs';
+import { delimiter, join } from 'node:path';
+const BIN_NAME = 'asset-generator-mcp';
+/**
+ * Returns true when the `asset-generator-mcp` CLI is resolvable on PATH
+ */
+export function detectAssetGenerator(env = process.env) {
+    const pathValue = env.PATH ?? env.Path ?? '';
+    if (!pathValue)
+        return { available: false };
+    const windowsExtensions = (env.PATHEXT ?? '').split(';').filter(Boolean);
+    const candidates = [BIN_NAME, ...windowsExtensions.map(extension => `${BIN_NAME}${extension.toLowerCase()}`)];
+    for (const directory of pathValue.split(delimiter)) {
+        if (!directory)
+            continue;
+        if (candidates.some(name => existsSync(join(directory, name))))
+            return { available: true };
+    }
+    return { available: false };
+}
+//# sourceMappingURL=detect-asset-generator.js.map

package/dist/brand/detect-asset-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-asset-generator.js","sourceRoot":"","sources":["../../src/brand/detect-asset-generator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,UAAU,EAAC,MAAM,SAAS,CAAA;AAClC,OAAO,EAAC,SAAS,EAAE,IAAI,EAAC,MAAM,WAAW,CAAA;AAEzC,MAAM,QAAQ,GAAG,qBAAqB,CAAA;AAEtC;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAyB,OAAO,CAAC,GAAG;IAGvE,MAAM,SAAS,GAAG,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,EAAE,CAAA;IAC5C,IAAI,CAAC,SAAS;QAAE,OAAO,EAAC,SAAS,EAAE,KAAK,EAAC,CAAA;IAEzC,MAAM,iBAAiB,GAAG,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IACxE,MAAM,UAAU,GAAG,CAAC,QAAQ,EAAE,GAAG,iBAAiB,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC,GAAG,QAAQ,GAAG,SAAS,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,CAAA;IAE7G,KAAK,MAAM,SAAS,IAAI,SAAS,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;QACnD,IAAI,CAAC,SAAS;YAAE,SAAQ;QACxB,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC;YAAE,OAAO,EAAC,SAAS,EAAE,IAAI,EAAC,CAAA;IAC1F,CAAC;IACD,OAAO,EAAC,SAAS,EAAE,KAAK,EAAC,CAAA;AAC3B,CAAC"}

package/dist/brand/detect-framework.d.ts

@@ -1,13 +1,12 @@
 export type FrameworkId = 'next-app' | 'next-pages' | 'vite' | 'astro' | 'remix' | 'unknown';
-export interface FrameworkInfo {
+export type FrameworkInfo = {
     id: FrameworkId;
     label: string;
     /** Uses React Server Components, so providers need a `'use client'` boundary. */
     rsc: boolean;
     projectDir: string | null;
-}
+};
 /**
- * Best-effort detection of the consumer's framework so setup guidance can be tailored
- * (where providers go, whether a `'use client'` boundary is required, which style import to use).
+ * A best-effort detection of the consumer's UI framework so setup guidance can be tailored
  */
 export declare function detectFramework(fromDir?: string): FrameworkInfo;

package/dist/brand/detect-framework.js

@@ -1,35 +1,32 @@
 import { existsSync, readFileSync } from 'node:fs';
 import { dirname, join, sep } from 'node:path';
-/** Nearest `package.json` above `fromDir` that isn't inside `node_modules`. */
-function findProjectDir(fromDir) {
-    let dir = fromDir;
-    for (;;) {
-        if (!dir.split(sep).includes('node_modules') && existsSync(join(dir, 'package.json')))
-            return dir;
+/**
+ * A best-effort detection of the consumer's UI framework so setup guidance can be tailored
+ */
+export function detectFramework(fromDir = process.cwd()) {
+    // Walk up from `fromDir` to the nearest package.json, ignoring any inside node_modules.
+    let projectDir = null;
+    for (let dir = fromDir;;) {
+        if (!dir.split(sep).includes('node_modules') && existsSync(join(dir, 'package.json'))) {
+            projectDir = dir;
+            break;
+        }
         const parent = dirname(dir);
         if (parent === dir)
-            return null;
+            break;
         dir = parent;
     }
-}
-function readDependencies(projectDir) {
+    if (!projectDir)
+        return { id: 'unknown', label: 'a React project', rsc: false, projectDir: null };
+    // Merge direct + dev dependencies; an unreadable or invalid package.json yields no deps.
+    let deps = {};
     try {
         const parsed = JSON.parse(readFileSync(join(projectDir, 'package.json'), 'utf8'));
-        return { ...parsed.dependencies, ...parsed.devDependencies };
+        deps = { ...parsed.dependencies, ...parsed.devDependencies };
     }
     catch {
-        return {};
+        // ignore — treat as no deps
     }
-}
-/**
- * Best-effort detection of the consumer's framework so setup guidance can be tailored
- * (where providers go, whether a `'use client'` boundary is required, which style import to use).
- */
-export function detectFramework(fromDir = process.cwd()) {
-    const projectDir = findProjectDir(fromDir);
-    if (!projectDir)
-        return { id: 'unknown', label: 'a React project', rsc: false, projectDir: null };
-    const deps = readDependencies(projectDir);
     if (deps.next) {
         const appRouter = existsSync(join(projectDir, 'app')) || existsSync(join(projectDir, 'src', 'app'));
         return appRouter

package/dist/brand/detect-framework.js.map

@@ -1 +1 @@
-{"version":3,"file":"detect-framework.js","sourceRoot":"","sources":["../../src/brand/detect-framework.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,UAAU,EAAE,YAAY,EAAC,MAAM,SAAS,CAAA;AAChD,OAAO,EAAC,OAAO,EAAE,IAAI,EAAE,GAAG,EAAC,MAAM,WAAW,CAAA;AAY5C,+EAA+E;AAC/E,SAAS,cAAc,CAAC,OAAe;IACrC,IAAI,GAAG,GAAG,OAAO,CAAA;IACjB,SAAS,CAAC;QACR,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;YAAE,OAAO,GAAG,CAAA;QACjG,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAA;QAC3B,IAAI,MAAM,KAAK,GAAG;YAAE,OAAO,IAAI,CAAA;QAC/B,GAAG,GAAG,MAAM,CAAA;IACd,CAAC;AACH,CAAC;AAED,SAAS,gBAAgB,CAAC,UAAkB;IAC1C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAG/E,CAAA;QACD,OAAO,EAAC,GAAG,MAAM,CAAC,YAAY,EAAE,GAAG,MAAM,CAAC,eAAe,EAAC,CAAA;IAC5D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAA;IACX,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,UAAkB,OAAO,CAAC,GAAG,EAAE;IAC7D,MAAM,UAAU,GAAG,cAAc,CAAC,OAAO,CAAC,CAAA;IAC1C,IAAI,CAAC,UAAU;QAAE,OAAO,EAAC,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,iBAAiB,EAAE,GAAG,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAC,CAAA;IAE/F,MAAM,IAAI,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAA;IACzC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,MAAM,SAAS,GAAG,UAAU,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAA;QACnG,OAAO,SAAS;YACd,CAAC,CAAC,EAAC,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,sBAAsB,EAAE,GAAG,EAAE,IAAI,EAAE,UAAU,EAAC;YACxE,CAAC,CAAC,EAAC,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,wBAAwB,EAAE,GAAG,EAAE,KAAK,EAAE,UAAU,EAAC,CAAA;IACjF,CAAC;IACD,IAAI,IAAI,CAAC,kBAAkB,CAAC,IAAI,IAAI,CAAC,iBAAiB,CAAC,EAAE,CAAC;QACxD,OAAO,EAAC,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,UAAU,EAAC,CAAA;IAC9D,CAAC;IACD,IAAI,IAAI,CAAC,KAAK;QAAE,OAAO,EAAC,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,UAAU,EAAC,CAAA;IAC5E,IAAI,IAAI,CAAC,IAAI;QAAE,OAAO,EAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,GAAG,EAAE,KAAK,EAAE,UAAU,EAAC,CAAA;IACjF,OAAO,EAAC,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,iBAAiB,EAAE,GAAG,EAAE,KAAK,EAAE,UAAU,EAAC,CAAA;AAC1E,CAAC"}
+{"version":3,"file":"detect-framework.js","sourceRoot":"","sources":["../../src/brand/detect-framework.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,UAAU,EAAE,YAAY,EAAC,MAAM,SAAS,CAAA;AAChD,OAAO,EAAC,OAAO,EAAE,IAAI,EAAE,GAAG,EAAC,MAAM,WAAW,CAAA;AAY5C;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,UAAkB,OAAO,CAAC,GAAG,EAAE;IAC7D,wFAAwF;IACxF,IAAI,UAAU,GAAkB,IAAI,CAAA;IACpC,KAAK,IAAI,GAAG,GAAG,OAAO,IAAM,CAAC;QAC3B,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC;YACtF,UAAU,GAAG,GAAG,CAAA;YAChB,MAAK;QACP,CAAC;QACD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAA;QAC3B,IAAI,MAAM,KAAK,GAAG;YAAE,MAAK;QACzB,GAAG,GAAG,MAAM,CAAA;IACd,CAAC;IACD,IAAI,CAAC,UAAU;QAAE,OAAO,EAAC,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,iBAAiB,EAAE,GAAG,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAC,CAAA;IAE/F,yFAAyF;IACzF,IAAI,IAAI,GAA2B,EAAE,CAAA;IACrC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAG/E,CAAA;QACD,IAAI,GAAG,EAAC,GAAG,MAAM,CAAC,YAAY,EAAE,GAAG,MAAM,CAAC,eAAe,EAAC,CAAA;IAC5D,CAAC;IAAC,MAAM,CAAC;QACP,4BAA4B;IAC9B,CAAC;IAED,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,MAAM,SAAS,GAAG,UAAU,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAA;QACnG,OAAO,SAAS;YACd,CAAC,CAAC,EAAC,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,sBAAsB,EAAE,GAAG,EAAE,IAAI,EAAE,UAAU,EAAC;YACxE,CAAC,CAAC,EAAC,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,wBAAwB,EAAE,GAAG,EAAE,KAAK,EAAE,UAAU,EAAC,CAAA;IACjF,CAAC;IACD,IAAI,IAAI,CAAC,kBAAkB,CAAC,IAAI,IAAI,CAAC,iBAAiB,CAAC,EAAE,CAAC;QACxD,OAAO,EAAC,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,UAAU,EAAC,CAAA;IAC9D,CAAC;IACD,IAAI,IAAI,CAAC,KAAK;QAAE,OAAO,EAAC,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,UAAU,EAAC,CAAA;IAC5E,IAAI,IAAI,CAAC,IAAI;QAAE,OAAO,EAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,GAAG,EAAE,KAAK,EAAE,UAAU,EAAC,CAAA;IACjF,OAAO,EAAC,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,iBAAiB,EAAE,GAAG,EAAE,KAAK,EAAE,UAAU,EAAC,CAAA;AAC1E,CAAC"}

package/dist/brand/docs-source.d.ts

@@ -3,38 +3,26 @@ import type { BrandInstall } from './resolve-install.js';
 /**
  * One entry in the documentation table of contents (parsed from `llms.txt`).
  */
-export interface DocEntry {
+export type DocEntry = {
     label: string;
     /** Path relative to the docs root, e.g. `docs/components/Hero/index.md`. */
     path: string;
     description?: string;
-}
+};
 export type DocOrigin = 'installed' | 'live' | 'none';
-export interface DocResult {
+export type DocResult = {
     text: string;
     origin: DocOrigin;
     version: string | null;
-}
+};
 /**
- * Tiered documentation source.
- *
- * Resolution order, by design:
- *   1. The bundled, version-pinned docs of the installed `@primer/react-brand` (authoritative,
- *      offline, matches the consumer's version).
- *   2. The live site's `llms.txt` / pages — best-effort enrichment for guidance that is not
- *      bundled, bounded by a short timeout and cached.
- *
- * Version-sensitive facts never depend on the network; this only covers prose guidance.
+ * Docs source is either user-installed (bundled with the installed `@primer/react-brand`), or live from the site. The
+ * MCP client will always try the installed docs first, and fall back to the live site if not found.
  */
-export interface DocsSource {
+export type DocsSource = {
     origin: DocOrigin;
     version: string | null;
     index(): Promise<DocEntry[]>;
     read(path: string): Promise<DocResult | null>;
-}
+};
 export declare function createDocsSource(brand: BrandInstall, logger: Logger): DocsSource;
-/**
- * Parse the `llms.txt` markdown table of contents into structured entries.
- * Lines look like: `- [Hero](docs/components/Hero/index.md): A prominent banner...`
- */
-export declare function parseToc(markdown: string): DocEntry[];

package/dist/brand/docs-source.js

@@ -1,17 +1,44 @@
 import { existsSync, readFileSync, realpathSync } from 'node:fs';
 import { dirname, join, normalize, resolve, sep } from 'node:path';
-const SITE = 'https://primer.style/brand';
-const FETCH_TIMEOUT_MS = 2500;
+const prodURL = 'https://primer.style/brand';
 export function createDocsSource(brand, logger) {
     const cache = new Map();
     const hasLocalDocs = Boolean(brand.llmsPath && brand.docsDir);
     const docsRoot = brand.docsDir ? dirname(brand.docsDir) : null;
-    async function fetchText(url) {
+    /**
+     * Prevents path traversal (e.g. `../../etc/passwd`) reaching the filesystem.
+     */
+    const safeJoin = (root, path) => {
+        const target = resolve(join(root, normalize(path)));
+        const realRoot = realpathSync(root);
+        const prefix = realRoot.endsWith(sep) ? realRoot : `${realRoot}${sep}`;
+        if (target !== realRoot && !target.startsWith(prefix))
+            return null;
+        return target;
+    };
+    /**
+     * Parse the `llms.txt` markdown table of contents into structured entries.
+     */
+    const parseToc = (markdown) => {
+        const entries = [];
+        const linkLine = /^- \[(.+?)\]\((.+?)\)(?::\s*(.*))?$/;
+        for (const raw of markdown.split('\n')) {
+            const match = linkLine.exec(raw.trim());
+            if (!match)
+                continue;
+            const [, label, path, description] = match;
+            if (!label || !path)
+                continue;
+            entries.push({ label, path, description: description?.trim() || undefined });
+        }
+        return entries;
+    };
+    const fetchText = async (url) => {
         const cached = cache.get(url);
         if (cached !== undefined)
             return cached;
         try {
-            const response = await fetch(url, { signal: AbortSignal.timeout(FETCH_TIMEOUT_MS) });
+            const response = await fetch(url, { signal: AbortSignal.timeout(2500) });
             if (!response.ok)
                 return null;
             const text = await response.text();
@@ -22,26 +49,26 @@ export function createDocsSource(brand, logger) {
             logger.debug(`live fetch failed for ${url}: ${error.message}`);
             return null;
         }
-    }
-    async function index() {
+    };
+    const index = async () => {
         if (hasLocalDocs && brand.llmsPath) {
             return parseToc(readFileSync(brand.llmsPath, 'utf8'));
         }
-        const live = await fetchText(`${SITE}/llms.txt`);
+        const live = await fetchText(`${prodURL}/llms.txt`);
         return live ? parseToc(live) : [];
-    }
-    async function read(path) {
+    };
+    const read = async (path) => {
         if (hasLocalDocs && docsRoot) {
             const safe = safeJoin(docsRoot, path);
             if (safe && existsSync(safe)) {
                 return { text: readFileSync(safe, 'utf8'), origin: 'installed', version: brand.version };
             }
         }
-        const live = await fetchText(`${SITE}/${path.replace(/^docs\//, '').replace(/\.md$/, '')}`);
+        const live = await fetchText(`${prodURL}/${path.replace(/^docs\//, '').replace(/\.md$/, '')}`);
         if (live)
             return { text: live, origin: 'live', version: null };
         return null;
-    }
+    };
     return {
         origin: hasLocalDocs ? 'installed' : 'live',
         version: brand.version,
@@ -49,34 +76,4 @@ export function createDocsSource(brand, logger) {
         read,
     };
 }
-/**
- * Parse the `llms.txt` markdown table of contents into structured entries.
- * Lines look like: `- [Hero](docs/components/Hero/index.md): A prominent banner...`
- */
-export function parseToc(markdown) {
-    const entries = [];
-    const linkLine = /^- \[(.+?)\]\((.+?)\)(?::\s*(.*))?$/;
-    for (const raw of markdown.split('\n')) {
-        const match = linkLine.exec(raw.trim());
-        if (!match)
-            continue;
-        const [, label, path, description] = match;
-        if (!label || !path)
-            continue;
-        entries.push({ label, path, description: description?.trim() || undefined });
-    }
-    return entries;
-}
-/**
- * Join a user-supplied doc path onto the docs root, refusing anything that escapes it.
- * Prevents path traversal (e.g. `../../etc/passwd`) reaching the filesystem.
- */
-function safeJoin(root, path) {
-    const target = resolve(join(root, normalize(path)));
-    const realRoot = realpathSync(root);
-    const prefix = realRoot.endsWith(sep) ? realRoot : `${realRoot}${sep}`;
-    if (target !== realRoot && !target.startsWith(prefix))
-        return null;
-    return target;
-}
 //# sourceMappingURL=docs-source.js.map

package/dist/brand/docs-source.js.map

@@ -1 +1 @@
-{"version":3,"file":"docs-source.js","sourceRoot":"","sources":["../../src/brand/docs-source.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"docs-source.js","sourceRoot":"","sources":["../../src/brand/docs-source.ts"],"names":[],"mappings":"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"}

package/dist/brand/resolve-assets.d.ts

@@ -1,14 +1,13 @@
 import type { CatalogAsset } from '../catalog/types.js';
-export interface InstalledAssets {
+export type InstalledAssets = {
     assets: CatalogAsset[];
     sources: Array<{
         module: string;
         version: string | null;
     }>;
-}
+};
 /**
- * Resolve the icon/illustration packages installed in the consumer's project and extract their
- * exported names. This makes `primer_brand_asset` version-accurate: it reflects the Octicons/Octovisuals
- * the project actually has, rather than the snapshot baked into the catalog at build time.
+ * Resolves the icon/illustration packages installed in the consumer's project and extract their
+ * exported names. This makes `primer_brand_asset` version-accurate.
  */
 export declare function resolveInstalledAssets(fromDir?: string): InstalledAssets;

package/dist/brand/resolve-assets.js

@@ -1,92 +1,84 @@
 import { existsSync, readdirSync, readFileSync } from 'node:fs';
 import { dirname, join } from 'node:path';
-const ASSET_PACKAGES = [
+const iconPackages = [
     { module: '@primer/octicons-react', kind: 'icon' },
     { module: '@primer/octovisuals-react', kind: 'illustration' },
 ];
-/** Walk up from `fromDir` to find an installed package directory. */
-function findPackageDir(packageName, fromDir) {
-    let dir = fromDir;
-    for (;;) {
-        const candidate = join(dir, 'node_modules', ...packageName.split('/'));
-        if (existsSync(join(candidate, 'package.json')))
-            return candidate;
-        const parent = dirname(dir);
-        if (parent === dir)
-            return null;
-        dir = parent;
-    }
-}
-function readVersion(packageDir) {
-    try {
-        return JSON.parse(readFileSync(join(packageDir, 'package.json'), 'utf8')).version ?? null;
-    }
-    catch {
-        return null;
-    }
-}
 /**
- * Collect exported PascalCase const names from a package's `.d.ts` type declarations. Octicons
- * declare their icons as `declare const AlertIcon: Icon` in a sibling file, so all `.d.ts` files
- * in the package's output directory are scanned, not just `index.d.ts`.
+ * Resolves the icon/illustration packages installed in the consumer's project and extract their
+ * exported names. This makes `primer_brand_asset` version-accurate.
  */
-function exportedNames(packageDir) {
-    const names = new Set();
-    for (const sub of ['dist', 'lib', '.']) {
-        let entries;
+export function resolveInstalledAssets(fromDir = process.cwd()) {
+    /** Walk up from `fromDir` to find an installed package directory. */
+    const findPackageDir = (packageName) => {
+        let dir = fromDir;
+        for (;;) {
+            const candidate = join(dir, 'node_modules', ...packageName.split('/'));
+            if (existsSync(join(candidate, 'package.json')))
+                return candidate;
+            const parent = dirname(dir);
+            if (parent === dir)
+                return null;
+            dir = parent;
+        }
+    };
+    const readVersion = (packageDir) => {
         try {
-            entries = readdirSync(join(packageDir, sub));
+            return JSON.parse(readFileSync(join(packageDir, 'package.json'), 'utf8')).version ?? null;
         }
         catch {
-            continue;
+            return null;
         }
-        for (const entry of entries) {
-            if (!entry.endsWith('.d.ts'))
-                continue;
-            let source;
+    };
+    /** Collects exported PascalCase const names from a package's `.d.ts` type declarations. */
+    const exportedNames = (packageDir) => {
+        const names = new Set();
+        for (const subDir of ['dist', 'lib', '.']) {
+            let entries;
             try {
-                source = readFileSync(join(packageDir, sub, entry), 'utf8');
+                entries = readdirSync(join(packageDir, subDir));
             }
             catch {
                 continue;
             }
-            for (const match of source.matchAll(/(?:export\s+)?declare\s+const\s+([A-Z]\w+)/g)) {
-                if (match[1])
-                    names.add(match[1]);
-            }
-            for (const match of source.matchAll(/export\s+const\s+([A-Z]\w+)/g)) {
-                if (match[1])
-                    names.add(match[1]);
-            }
-            for (const match of source.matchAll(/export\s*\{([^}]*)\}/g)) {
-                for (const part of (match[1] ?? '').split(',')) {
-                    const ident = part
-                        .trim()
-                        .split(/\s+as\s+/)
-                        .pop()
-                        ?.trim();
-                    if (ident && /^[A-Z]\w+$/.test(ident))
-                        names.add(ident);
+            for (const entry of entries) {
+                if (!entry.endsWith('.d.ts'))
+                    continue;
+                let source;
+                try {
+                    source = readFileSync(join(packageDir, subDir, entry), 'utf8');
+                }
+                catch {
+                    continue;
+                }
+                for (const match of source.matchAll(/(?:export\s+)?declare\s+const\s+([A-Z]\w+)/g)) {
+                    if (match[1])
+                        names.add(match[1]);
+                }
+                for (const match of source.matchAll(/export\s+const\s+([A-Z]\w+)/g)) {
+                    if (match[1])
+                        names.add(match[1]);
+                }
+                for (const match of source.matchAll(/export\s*\{([^}]*)\}/g)) {
+                    for (const part of (match[1] ?? '').split(',')) {
+                        const ident = part
+                            .trim()
+                            .split(/\s+as\s+/)
+                            .pop()
+                            ?.trim();
+                        if (ident && /^[A-Z]\w+$/.test(ident))
+                            names.add(ident);
+                    }
                 }
             }
         }
-    }
-    return [...names];
-}
-function keepName(name, kind) {
-    // Octovisuals components are also named `...Icon`, so they are kept by package, not suffix.
-    return kind === 'icon' ? name.endsWith('Icon') : /^[A-Z]/.test(name) && !/(Props|Type|Metadata)$/.test(name);
-}
-/**
- * Resolve the icon/illustration packages installed in the consumer's project and extract their
- * exported names. This makes `primer_brand_asset` version-accurate: it reflects the Octicons/Octovisuals
- * the project actually has, rather than the snapshot baked into the catalog at build time.
- */
-export function resolveInstalledAssets(fromDir = process.cwd()) {
+        return [...names];
+    };
+    const keepName = (name, kind) => kind === 'icon' ? name.endsWith('Icon') : /^[A-Z]/.test(name) && !/(Props|Type|Metadata)$/.test(name);
     const assets = [];
     const sources = [];
-    for (const { module, kind } of ASSET_PACKAGES) {
-        const packageDir = findPackageDir(module, fromDir);
+    for (const { module, kind } of iconPackages) {
+        const packageDir = findPackageDir(module);
         if (!packageDir)
             continue;
         const names = exportedNames(packageDir).filter(name => keepName(name, kind));

package/dist/brand/resolve-assets.js.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-assets.js","sourceRoot":"","sources":["../../src/brand/resolve-assets.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"resolve-assets.js","sourceRoot":"","sources":["../../src/brand/resolve-assets.ts"],"names":[],"mappings":"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"}

package/dist/brand/resolve-install.d.ts

@@ -3,15 +3,13 @@
  * This is what makes the server version-aware: tools prefer the docs and version of the
  * package the project actually depends on.
  */
-export interface BrandInstall {
+export type BrandInstall = {
     found: boolean;
     version: string | null;
     packageDir: string | null;
-    /** Bundled version-pinned docs directory, when the installed version ships one. */
     docsDir: string | null;
-    /** Bundled `llms.txt` table of contents, when present. */
     llmsPath: string | null;
-}
+};
 /**
  * Walk up from `fromDir` looking for `node_modules/@primer/react-brand`. We resolve from the
  * working directory (not from this server's own location) so that, when launched inside a