@sdaia-ds/mcp 0.0.0-stage → 3.1.0

package/README.md

@@ -1,3 +1,213 @@
-# Temporary Holding Version
+# @sdaia-ds/mcp
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+> Published from the `sdaia-dga` npm account, like `sdaia-ui` and `@sdaia-ds/tokens`.
+
+MCP server for the [SDAIA Design System](https://ds.nacew.com) — gives AI coding agents (Claude Code, Claude Desktop, GitHub Copilot, Cursor, …) **accurate, source-derived** knowledge of the `sdaia-ui` components and `@sdaia-ds/tokens`.
+
+Instead of hallucinating component APIs, the agent looks them up — and what it gets is parsed straight from the design system's own TypeScript source and token package, not guessed from a rendered web page.
+
+**Transport:** stdio (works with any MCP-compatible client)
+
+---
+
+## Why this exists
+
+The knowledge base is **generated from the authoritative sources the `sdaia-ui` CLI itself uses**:
+
+- The **live registry** (`GET https://ds.nacew.com/api/registry`) → the exact set of installable components and their valid `npx sdaia-ui@latest add <slug>` ids.
+- Each component's raw **`.types.ts` / `.variants.ts`** (served by the registry) → real props, allowed option values (variant/size/color/…), and the `--ds-*` tokens it uses, parsed with the TypeScript compiler.
+- Each component's **`<Name>.tsx`** → the runtime default of every prop (the destructuring defaults), so docs show e.g. Modal `showTertiary` = `false`.
+- The pinned **`@sdaia-ds/tokens`** npm package (2.0.1, the version `sdaia-ui` pins) → every design token with its CSS variable and light/dark value.
+- The design system's accessibility test suite → the per-component "Accessibility" section lists only behaviour a keyboard spec or the axe scan verifies (`scripts/lib/a11yNotes.ts`).
+
+No HTML scraping, no heuristics. Every fact a tool returns is traceable to source, so `npx sdaia-ui@latest add <slug>` commands always work and prop/variant APIs are always correct.
+
+> **Hard rule the tools enforce for generated projects:** `sdaia-ui` is a source-copying CLI, **not** a runtime package. Agents are told to **never** run `npm install sdaia-ui` and **never** `import … from 'sdaia-ui'` — only `npx sdaia-ui@latest init` (once) + `npx sdaia-ui@latest add <slug>`, then import from `@/components/ui/<Name>` — the same flow as the docs site's Installation guide (Next.js App Router or Pages Router, Vite + React).
+
+---
+
+## Tools
+
+| Tool | Description |
+|---|---|
+| `setup_project` | Step-by-step setup for using `sdaia-ui` in a React project (CLI init, Tailwind v4 + tokens, `.theme-dark` bridge, icons). Call first when scaffolding. |
+| `list_components` | All installable components grouped by category (`general`, `actions`, `form`, `feedback`, `patterns`, `ai`), each with its exact install command. |
+| `search_components` | Find a component slug by keyword (name or slug). |
+| `get_component_docs` | Accurate docs for one component: real props, allowed option values, accessibility, the tokens it uses, and AI usage guidance. |
+| `get_foundations` | Foundation guidance by topic: `colors`, `spacing`, `radius`, `icons`, `icon-usage`, `motion`, `typography`, `theme` (dark mode + the six brands), `responsive`, `rtl`, `figma`, `accessibility`. |
+| `get_tokens` | Structured design tokens with CSS variable + light/dark values. Filter by `category` (`colors`, `palette`, `spacing`, `radius`, `typography`, `icons`, `motion`, `all`) and optional `query`. |
+
+---
+
+## Prerequisites
+
+- Node.js >= 18
+
+---
+
+## Add it to your AI client
+
+### Claude Code (CLI)
+
+After publishing (uses `npx`):
+
+```bash
+# available in the current project (writes .mcp.json)
+claude mcp add sdaia-ds -s project -- npx -y @sdaia-ds/mcp
+
+# or available in every project
+claude mcp add sdaia-ds -s user -- npx -y @sdaia-ds/mcp
+```
+
+Running from a local clone (not published yet):
+
+```bash
+claude mcp add sdaia-ds -s project -- node <path-to-your-clone>/dist/index.js
+# (run `npm install && npm run build` in the clone first)
+```
+
+Verify with `claude mcp list`, then in a session: `/mcp`.
+
+### Claude Desktop
+
+Edit `~/Library/Application Support/Claude/claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "sdaia-ds": {
+      "command": "npx",
+      "args": ["-y", "@sdaia-ds/mcp"]
+    }
+  }
+}
+```
+
+Local clone instead of npx:
+
+```json
+{
+  "mcpServers": {
+    "sdaia-ds": {
+      "command": "node",
+      "args": ["<path-to-your-clone>/dist/index.js"]
+    }
+  }
+}
+```
+
+### VS Code (GitHub Copilot agent mode)
+
+`.vscode/mcp.json` in your workspace:
+
+```json
+{
+  "servers": {
+    "sdaia-ds": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "@sdaia-ds/mcp"]
+    }
+  }
+}
+```
+
+### Cursor
+
+`.cursor/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "sdaia-ds": { "command": "npx", "args": ["-y", "@sdaia-ds/mcp"] }
+  }
+}
+```
+
+Restart the client after editing config.
+
+### Example prompts
+
+```
+Use the sdaia-ds tools to scaffold a React page with a NavBar and a DataTable.
+What are the allowed variants and sizes for the Button component?
+Give me the SDAIA color tokens and their dark-mode values.
+```
+
+---
+
+## Development
+
+```bash
+git clone https://github.com/Ewwwolution-L-L-C/sdaia_mcp.git
+cd sdaia_mcp
+npm install
+npm test           # starts the server over stdio and calls every tool; lints knowledge/
+npm start          # runs the server via tsx (no build) → "… running on stdio"
+npm run build      # compiles index.ts → dist/
+```
+
+The committed [`.vscode/mcp.json`](.vscode/mcp.json) (VS Code) and [`.mcp.json`](.mcp.json) (Claude Code) run the local `index.ts` with `tsx` from the repo root — no machine-specific paths — so opening this repo wires up the server automatically.
+
+### Regenerate the knowledge base
+
+`knowledge/` is generated. To rebuild it from the live registry + tokens package:
+
+```bash
+npm run generate
+```
+
+This fetches the registry, parses each top-level component's source, parses `@sdaia-ds/tokens`, and writes `knowledge/<category>/<slug>.md`, `knowledge/manifest.json`, and `knowledge/foundations/*`. It **fails loudly** if any configured slug is no longer a valid registry slug, so broken install commands can never ship.
+
+To generate from a design-system-platform checkout instead of the live site (same content once master is deployed, and no requests to production):
+
+```bash
+# in design-system-platform
+REGISTRY_OUT_DIR=/tmp/sdaia-registry node scripts/build-registry.mjs
+node --input-type=module -e "import { startRegistryServer } from './scripts/ci/serve-registry.mjs'; await startRegistryServer({ port: 4874, dir: '/tmp/sdaia-registry' })"
+# in sdaia_mcp
+SDAIA_REGISTRY_URL=http://127.0.0.1:4874/api/registry npm run generate
+```
+
+Environment overrides:
+
+| Var | Default | Purpose |
+|---|---|---|
+| `SDAIA_REGISTRY_URL` | `https://ds.nacew.com/api/registry` | Registry manifest + raw source |
+| `SDAIA_DOCS_URL` | `https://ds.nacew.com` | Docs base for source links |
+
+The set of components covered is curated in [`components.config.ts`](components.config.ts): one entry per component page in the docs sidebar (registry slug, docs page name when it differs, category). To add one, add it there and re-run `npm run generate`. Docs of components that leave the list are deleted by the generator.
+
+Hand-written guides (`knowledge/setup.md`, `knowledge/foundations/{typography,theme,responsive,rtl,figma,accessibility,icon-usage}.md` and the two AI pattern docs) follow the docs site pages of the same name; update them when those pages change.
+
+---
+
+## How it's wired
+
+```
+components.config.ts ──┐
+                       ├─►  scripts/generate.ts  ─►  knowledge/**  (committed, shipped)
+live /api/registry  ───┤        │
+@sdaia-ds/tokens (npm) ─┘        └─ parsers: scripts/lib/{parseTypes,tokens,renderDoc}.ts
+
+index.ts (MCP server)  ─►  reads knowledge/** at runtime  ─►  6 stdio tools
+```
+
+---
+
+## Publishing
+
+```bash
+npm run generate   # refresh knowledge from source
+npm test           # must pass
+npm run build      # prepublishOnly also runs this
+npm publish --access public
+```
+
+The published package ships `dist/` + `knowledge/` (see `files` in package.json).
+
+---
+
+## License
+
+ISC

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,291 @@
+#!/usr/bin/env node
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
+import { readFileSync, existsSync } from "node:fs";
+import { join } from "node:path";
+import { fileURLToPath } from "node:url";
+const __dirname = fileURLToPath(new URL(".", import.meta.url));
+const CATEGORY_ORDER = ["general", "actions", "form", "feedback", "patterns", "ai"];
+// Display labels for categories where naive capitalization is wrong (e.g. "Ai" → "AI").
+const CATEGORY_LABELS = {
+    general: "General",
+    actions: "Actions",
+    form: "Form",
+    feedback: "Feedback",
+    patterns: "Patterns",
+    ai: "AI",
+};
+const FOUNDATION_TOPICS = [
+    "typography", "colors", "spacing", "radius", "icons", "icon-usage", "motion", "theme", "responsive", "rtl", "figma", "accessibility",
+];
+const TOKEN_CATEGORIES = ["colors", "palette", "spacing", "radius", "typography", "icons", "motion", "all"];
+// Resolve the knowledge dir for both dev (`tsx index.ts` → __dirname = repo
+// root) and prod (`node dist/index.js` → __dirname = dist/). The package ships
+// `knowledge/` at the root (see package.json "files"), so prod falls back to
+// `../knowledge`.
+function resolveKnowledgeDir() {
+    const candidates = [join(__dirname, "knowledge"), join(__dirname, "..", "knowledge")];
+    for (const dir of candidates) {
+        if (existsSync(join(dir, "manifest.json")))
+            return dir;
+    }
+    return candidates[0];
+}
+const KNOWLEDGE_DIR = resolveKnowledgeDir();
+const manifest = JSON.parse(readFileSync(join(KNOWLEDGE_DIR, "manifest.json"), "utf-8"));
+function loadKnowledge(relativePath) {
+    const fullPath = join(KNOWLEDGE_DIR, relativePath);
+    if (!existsSync(fullPath))
+        return null;
+    try {
+        return readFileSync(fullPath, "utf-8");
+    }
+    catch {
+        return null;
+    }
+}
+function loadTokens() {
+    const raw = loadKnowledge("foundations/tokens.json");
+    return raw ? JSON.parse(raw) : [];
+}
+const server = new Server({ name: "sdaia-design-system-mcp", version: "3.1.0" }, { capabilities: { tools: {} } });
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+    tools: [
+        {
+            name: "setup_project",
+            description: "Returns the step-by-step setup for using the SDAIA Design System (`sdaia-ui`) in a Next.js (App Router or Pages Router) or Vite + React project, matching the docs site's Installation guide: " +
+                "what `npx sdaia-ui@latest init` sets up (Tailwind v4, tokens, IBM Plex Sans Arabic, dark-mode variant, `@/` alias), adding and importing components (`@/components/ui/<Name>`), Arabic / dark mode / brands on `<html>`, icons (DgaIcon + `@platformscode/icons`), and keeping components up to date with `diff` / `update`. " +
+                "HARD RULE: `sdaia-ui` is a source-copying CLI — NEVER `npm install sdaia-ui` and NEVER import from it; run `npx sdaia-ui@latest init` then `npx sdaia-ui@latest add <slug>`. " +
+                "ALWAYS call this before get_component_docs when scaffolding a new project or installing components for the first time.",
+            inputSchema: { type: "object", properties: {}, required: [] },
+        },
+        {
+            name: "list_components",
+            description: "Lists all installable SDAIA components by category (general, actions, form, feedback, patterns, ai), each with its exact " +
+                "`npx sdaia-ui@latest add <slug>` command. Every slug is validated against the live CLI registry, so install commands are guaranteed valid. " +
+                "Call this first to discover component slugs before get_component_docs.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    category: {
+                        type: "string",
+                        enum: ["all", ...CATEGORY_ORDER],
+                        description: "Filter by docs category. Omit or pass 'all' for the complete list.",
+                    },
+                },
+                required: [],
+            },
+        },
+        {
+            name: "search_components",
+            description: "Find component slugs by keyword (matches name or slug). Use when you know what a component does but not its exact slug.",
+            inputSchema: {
+                type: "object",
+                properties: { query: { type: "string", description: "Keyword, e.g. 'date', 'upload', 'nav'." } },
+                required: ["query"],
+            },
+        },
+        {
+            name: "get_component_docs",
+            description: "Returns accurate, source-derived docs for one SDAIA component: real props (parsed from the component's TypeScript), allowed option " +
+                "values (variant/size/color/etc.), accessibility notes, the design tokens it uses, and AI usage guidance. " +
+                "Install via `npx sdaia-ui@latest add <slug>` — NEVER `npm install sdaia-ui` or import from it (it is a source-copying CLI). Use list_components / search_components to find the slug. " +
+                "Icons are NOT a component — do not pass 'icon'/'icons'; call setup_project for icon usage.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    componentId: {
+                        type: "string",
+                        description: "Component slug, e.g. 'button', 'text-input', 'card', 'nav-bar', or an AI component like 'ai-message', 'tool-call-card', 'reasoning-trace'.",
+                    },
+                },
+                required: ["componentId"],
+            },
+        },
+        {
+            name: "get_foundations",
+            description: "Returns SDAIA foundation guidance by topic. Token topics (colors, spacing, radius, icons, motion) are generated from " +
+                "`@sdaia-ds/tokens` with light + dark values; typography/theme (dark mode + the six brands)/responsive (breakpoints 768 / 1280)/icon-usage/rtl/figma/accessibility are authored guides that follow the docs site. " +
+                "Call `icon-usage` before any UI with icons (DgaIcon + @platformscode/icons — never emoji or invented icons). For exact token lookups use get_tokens.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    topic: { type: "string", enum: [...FOUNDATION_TOPICS], description: "Foundation topic to fetch." },
+                },
+                required: ["topic"],
+            },
+        },
+        {
+            name: "get_tokens",
+            description: "Returns structured SDAIA design tokens with their CSS variable and light + dark values, so you never hardcode or invent colors. " +
+                "Filter by category and optionally a keyword. Use these `--ds-*` tokens (via Tailwind utilities or var()) for any custom layout around DS components.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    category: {
+                        type: "string",
+                        enum: [...TOKEN_CATEGORIES],
+                        description: "colors = semantic color tokens; palette = raw color primitives; or spacing | radius | typography | icons | motion | all.",
+                    },
+                    query: { type: "string", description: "Optional substring filter on token key, CSS var, or description." },
+                },
+                required: ["category"],
+            },
+        },
+    ],
+}));
+function listComponents(category) {
+    const tiers = category === "all" ? CATEGORY_ORDER : [category];
+    let out = "# SDAIA Design System — Component Library\n\n";
+    for (const tier of tiers) {
+        const components = Object.values(manifest)
+            .filter((e) => e.category === tier)
+            .sort((a, b) => a.slug.localeCompare(b.slug));
+        if (!components.length)
+            continue;
+        const label = CATEGORY_LABELS[tier] ?? tier.charAt(0).toUpperCase() + tier.slice(1);
+        out += `## ${label} (${components.length})\n\n`;
+        out += "| Component | Slug | Install command |\n|---|---|---|\n";
+        for (const e of components)
+            out += `| ${e.name} | \`${e.slug}\` | \`${e.install}\` |\n`;
+        out += "\n";
+    }
+    out += "> Install with `npx sdaia-ui@latest add <slug>` (after `npx sdaia-ui@latest init`). NEVER `npm install sdaia-ui` or import from it — it is a source-copying CLI.\n";
+    out += "> Use `get_component_docs` with a slug for full props + options.\n";
+    out += "> Use `get_foundations` / `get_tokens` for theming, tokens, RTL, and accessibility.";
+    return out;
+}
+function searchComponents(query) {
+    const q = query.toLowerCase();
+    const hits = Object.values(manifest)
+        .filter((e) => e.slug.includes(q) || e.name.toLowerCase().includes(q))
+        .sort((a, b) => a.slug.localeCompare(b.slug));
+    if (!hits.length)
+        return `No components match "${query}". Try list_components to browse all.`;
+    let out = `# Components matching "${query}"\n\n| Component | Slug | Install command |\n|---|---|---|\n`;
+    for (const e of hits)
+        out += `| ${e.name} | \`${e.slug}\` | \`${e.install}\` |\n`;
+    return out;
+}
+const TOKEN_CATEGORY_MAP = {
+    colors: ["Colors"],
+    palette: ["Primitives"],
+    spacing: ["Spacing"],
+    radius: ["Radius"],
+    typography: ["Typography"],
+    icons: ["Icons"],
+    motion: ["Motion"],
+};
+const MAX_TOKEN_ROWS = 250;
+function getTokens(category, query) {
+    const all = loadTokens();
+    if (!all.length)
+        return "Token data not found. Run `npm run generate` to build it.";
+    const cats = category === "all" ? null : TOKEN_CATEGORY_MAP[category];
+    const q = query?.toLowerCase();
+    let rows = all.filter((t) => (!cats || cats.includes(t.category)));
+    if (q)
+        rows = rows.filter((t) => t.key.toLowerCase().includes(q) || t.cssVar.toLowerCase().includes(q) || t.description.toLowerCase().includes(q));
+    if (!rows.length)
+        return `No tokens match category="${category}"${query ? ` query="${query}"` : ""}.`;
+    const truncated = rows.length > MAX_TOKEN_ROWS;
+    const shown = rows.slice(0, MAX_TOKEN_ROWS);
+    const byGroup = new Map();
+    for (const t of shown) {
+        if (!byGroup.has(t.group))
+            byGroup.set(t.group, []);
+        byGroup.get(t.group).push(t);
+    }
+    let out = `# SDAIA Tokens — ${category}${query ? ` (filter: "${query}")` : ""}\n\n`;
+    out += "> Apply via Tailwind utilities (e.g. `bg-[var(--ds-color-bg-default)]`, `p-spacing-md`) or `var(--ds-…)`. Dark values switch automatically under `.theme-dark`.\n";
+    out += "> **Brand:** `sdaia-dga` is the default (no class). Other brands are a class on `<html>`: `brand-spectrum`, `brand-canvas`, `brand-dessert`, `brand-dune`, `brand-carbon` (see `get_foundations` topic `theme`). Prefer semantic `brand-*` / `color-*` tokens — they resolve per brand + theme. Never hardcode a palette hex.\n";
+    out += "> **Values** are the `@sdaia-ds/tokens` defaults (sdaia-dga). The core CSS that `sdaia-ui init` installs corrects a few of them for contrast, and brands override others — so write `var(--ds-…)`, never the literal value.\n\n";
+    for (const [group, list] of byGroup) {
+        out += `## ${group}\n\n| Token | CSS variable | Light | Dark |\n|---|---|---|---|\n`;
+        for (const t of list) {
+            out += `| \`${t.key}\` | \`var(${t.cssVar})\` | \`${t.lightValue}\` | ${t.hasDarkVariant ? `\`${t.darkValue}\`` : "—"} |\n`;
+        }
+        out += "\n";
+    }
+    if (truncated)
+        out += `> Showing ${MAX_TOKEN_ROWS} of ${rows.length}. Narrow with a \`query\`.\n`;
+    return out;
+}
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args = {} } = request.params;
+    if (name === "setup_project") {
+        const content = loadKnowledge("setup.md");
+        return { content: [{ type: "text", text: content ?? "Setup guide not found. Run `npm run generate`." }] };
+    }
+    if (name === "list_components") {
+        const { category = "all" } = args;
+        return { content: [{ type: "text", text: listComponents(category) }] };
+    }
+    if (name === "search_components") {
+        const { query } = args;
+        return { content: [{ type: "text", text: searchComponents(query ?? "") }] };
+    }
+    if (name === "get_foundations") {
+        const { topic } = args;
+        const local = loadKnowledge(`foundations/${topic}.md`);
+        if (local)
+            return { content: [{ type: "text", text: local }] };
+        return {
+            content: [{ type: "text", text: `Unknown or missing topic '${topic}'. Valid: ${FOUNDATION_TOPICS.join(", ")}. Run \`npm run generate\` if a token topic is missing.` }],
+            isError: true,
+        };
+    }
+    if (name === "get_tokens") {
+        const { category, query } = args;
+        return { content: [{ type: "text", text: getTokens(category, query) }] };
+    }
+    if (name === "get_component_docs") {
+        const { componentId } = args;
+        // "icon" / "icons" → the icon section of setup.md (Step 6).
+        if (componentId === "icon" || componentId === "icons") {
+            const setup = loadKnowledge("setup.md");
+            const idx = setup?.indexOf("## Step 6") ?? -1;
+            const iconDocs = setup && idx !== -1 ? setup.slice(idx) : setup;
+            return {
+                content: [{
+                        type: "text",
+                        text: "# Icons — @platformscode/icons + DgaIcon\n\n" +
+                            "> `DgaIcon` comes with any component that uses icons, or on its own with `npx sdaia-ui@latest add dga-icon` (it lives at `@/components/ui/DgaIcon`); " +
+                            "icon data comes from `@platformscode/icons`, installed by `npx sdaia-ui@latest init`. Use two imports:\n" +
+                            "> ```tsx\n" +
+                            "> import { DgaIcon } from '@/components/ui/DgaIcon';\n" +
+                            "> import { search01Stroke } from '@platformscode/icons';\n" +
+                            "> // <span className=\"size-icon-sm\"><DgaIcon data={search01Stroke} /></span>\n" +
+                            "> ```\n\n" +
+                            (iconDocs ?? "Run `npm run generate` to restore setup docs."),
+                    }],
+            };
+        }
+        const entry = manifest[componentId];
+        if (!entry) {
+            return {
+                content: [{ type: "text", text: `Unknown component '${componentId}'. Use list_components or search_components to find a valid slug.` }],
+                isError: true,
+            };
+        }
+        const local = loadKnowledge(`${entry.category}/${componentId}.md`);
+        if (local)
+            return { content: [{ type: "text", text: local }] };
+        return {
+            content: [{ type: "text", text: `Docs for '${componentId}' are missing. Run \`npm run generate\`.` }],
+            isError: true,
+        };
+    }
+    throw new Error(`Unknown tool: ${name}`);
+});
+const transport = new StdioServerTransport();
+await server.connect(transport);
+console.error("SDAIA Design System MCP Server v3.1.0 running on stdio");
+// Self-terminate when the parent (generate.py) goes away. The MCP SDK's stdio transport
+// does NOT watch for stdin EOF, so without this an orphaned server keeps its event loop
+// alive forever (the leak we saw when the studio's Stop button kills the parent). When the
+// parent dies, our stdin pipe closes — exit immediately.
+process.stdin.on("end", () => process.exit(0));
+process.stdin.on("close", () => process.exit(0));
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/knowledge/actions/breadcrumb.md

@@ -0,0 +1,50 @@
+# Breadcrumb
+
+## Metadata
+- Component: Breadcrumb
+- Slug: `breadcrumb`
+- Category: Actions
+- Install: `npx sdaia-ui@latest add breadcrumb`
+- Import: `import { Breadcrumb } from '@/components/ui/Breadcrumb'`
+- Installed files: `Breadcrumb.tsx`, `Breadcrumb.types.ts`, `Breadcrumb.variants.ts`, `BreadcrumbItem.tsx`, `BreadcrumbItem.types.ts`, `BreadcrumbItem.variants.ts`, `index.ts`
+- Docs: https://ds.nacew.com/components/breadcrumb
+
+> **Hard rule:** `sdaia-ui` is a CLI, not a runtime package — NEVER run `npm install sdaia-ui` and NEVER `import … from 'sdaia-ui'`. Run `npx sdaia-ui@latest init` once per project (Tailwind CSS v4, tokens, the IBM Plex Sans Arabic font, the `@/` alias on Vite, `cn`), then `npx sdaia-ui@latest add breadcrumb`. It copies the source into your components folder (`components/ui/Breadcrumb/`, under `src/` when the project has one); import it as `@/components/ui/Breadcrumb`. The files are yours: prefer props and composition over editing them. `npx sdaia-ui@latest update` never overwrites a file you changed: it keeps it and says it has updates; `diff` shows them and `update --force` takes them.
+
+## Props
+| Prop | Type | Default | Description |
+| --- | --- | --- | --- |
+| `items` | `BreadcrumbItem[]` | — | Breadcrumb trail. The first item is the home link (icon + label); remaining items render after the home slot. The last item is the current page (`aria-current="page"`). |
+| `homeLabel?` | `string` | — | Home label — takes precedence over `items[0].label` and `labels.home`. |
+| `divider?` | `'chevron' \| 'slash'` | 'chevron' | Divider style between items |
+| `homeIcon?` | `ReactNode` | — | Custom home icon |
+| `homeDisplay?` | `'icon-and-text' \| 'icon'` | 'icon-and-text' | How the home item shows: the icon with its label (default), or the icon alone (Figma Breadcrumb, LTR: `_Breadcrumb Item` Type=Icon), with the label kept for assistive tech. |
+| `chevronIcon?` | `ReactNode` | — | Custom chevron icon (used when divider="chevron"). Mirrored in RTL. |
+| `labels?` | `Partial<BreadcrumbLabels>` | — | Translatable built-in strings. |
+| `dir?` | `'ltr' \| 'rtl'` | — | Layout direction applied to the root. Inherits when omitted. |
+
+Also accepts standard `<div>` HTML attributes (`className`, `style`, `onClick`, `aria-*`, …).
+
+## Options (allowed values)
+- `divider`: `'chevron'` \| `'slash'` — Divider style between items
+- `homeDisplay`: `'icon-and-text'` \| `'icon'` — Home item display: icon + label, or the icon alone (label for assistive tech).
+- `dir`: `'ltr'` \| `'rtl'` — Layout direction applied to the root. Inherits when omitted.
+
+## Accessibility
+- Built-in strings (button names, announcements) come from `labels`; pass translated strings for Arabic or other languages.
+- Don't remove the focus ring or replace interactive elements with `div`s; keep the control keyboard-operable.
+- For contrast, keyboard patterns and RTL rules, call `get_foundations` (`accessibility`, `rtl`).
+
+## Design tokens used
+Keep these consistent (resolve values with `get_tokens`):
+- `var(--ds-color-icon-default-400)`
+- `var(--ds-spacing-xs)`
+- `var(--ds-text-leading-line-heights-text-sm)`
+
+## AI usage guidance
+When generating UI:
+- Install with `npx sdaia-ui@latest add breadcrumb` (after `npx sdaia-ui@latest init`), then import `{ Breadcrumb }` from `@/components/ui/Breadcrumb`.
+- NEVER run `npm install sdaia-ui` and NEVER `import` from the `sdaia-ui` package — it is a source-copying CLI, not a component library.
+- Use only the documented option values listed under "Options".
+- Pass icons via `<DgaIcon data={…} className="size-icon-sm" />` from `@platformscode/icons` only — see `get_foundations` (`icon-usage`). Never emoji, Lucide, or random icons (e.g. `pizza01Stroke` for dark mode).
+- Pick one theme per screen: dark is `.theme-dark` (or `.dark`) on `<html>`; style surrounding layout with DS tokens (`get_tokens`), never hardcoded colors.