{
  "generatedAt": "docs-build",
  "site": "https://designsystem.mihcm.com",
  "purpose": "Machine-readable MiHCM Design System documentation map for AI agents.",
  "rules": [
    "Read /llms.txt first for routing and /agent-map.json when machine-readable metadata is easier.",
    "Use /llms-full.txt only when broad context is needed; prefer narrow pages first.",
    "Use /agent-tooling for MCP and skill installation.",
    "Use /components/{slug}/usage before examples, then /api and /accessibility for implementation details.",
    "Use MiHCM components, MiHCM icons, standard Tailwind utilities, and MiHCM semantic token classes. Do not hardcode raw visual values.",
    "Validate AI-generated UI descriptors with Zod through @mihcm/ai-ui or mihcm_validate_descriptor before render."
  ],
  "priorityRoutes": [
    {
      "title": "Agent scan guide",
      "url": "/agent-scan",
      "source": "src/apps/docs/app/agent-scan/page.mdx",
      "purpose": "Start here when an AI agent needs to locate the right design-system context quickly.",
      "tags": [
        "agent",
        "scan",
        "orientation"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/agent-scan"
    },
    {
      "title": "Agent tooling",
      "url": "/agent-tooling",
      "source": "src/apps/docs/app/agent-tooling/page.mdx",
      "purpose": "MCP, skills, install links, hosted endpoint, workflow, and security boundary.",
      "tags": [
        "agent",
        "mcp",
        "skills"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/agent-tooling"
    },
    {
      "title": "External developers",
      "url": "/getting-started/external-developers",
      "source": "src/apps/docs/app/getting-started/external-developers/page.mdx",
      "purpose": "Consumer setup for packages, registry access, hosted MCP, and agent skills.",
      "tags": [
        "onboarding",
        "packages",
        "mcp"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/getting-started/external-developers"
    },
    {
      "title": "MiHCM-only Next.js",
      "url": "/developing/mihcm-only-nextjs",
      "source": "src/apps/docs/app/developing/mihcm-only-nextjs/page.mdx",
      "purpose": "Strict consumer-app enforcement for MiHCM components, tokens, and Tailwind classes.",
      "tags": [
        "enforcement",
        "nextjs",
        "tokens"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/developing/mihcm-only-nextjs"
    },
    {
      "title": "Components",
      "url": "/components",
      "source": "src/apps/docs/app/components/page.tsx",
      "purpose": "Human component catalog. Component-specific routes use /components/{slug}/{usage|examples|api|accessibility|configurator}.",
      "tags": [
        "components",
        "catalog"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components"
    },
    {
      "title": "Tokens",
      "url": "/tokens",
      "source": "src/apps/docs/app/tokens/page.tsx",
      "purpose": "Design token overview and routes for colors, typography, spacing, grid, and motion.",
      "tags": [
        "tokens"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/tokens"
    },
    {
      "title": "AI-UI",
      "url": "/ai-ui",
      "source": "src/apps/docs/app/ai-ui/page.mdx",
      "purpose": "Zod-validated generated UI renderer, supported components, and blocked surfaces.",
      "tags": [
        "ai-ui",
        "security"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/ai-ui"
    },
    {
      "title": "Patterns",
      "url": "/patterns",
      "source": "src/apps/docs/app/patterns/page.tsx",
      "purpose": "Production-grade application and marketing patterns built with MiHCM primitives.",
      "tags": [
        "patterns"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/patterns"
    },
    {
      "title": "Production block pattern library",
      "url": "/downloads/agent/docs/patterns/production-block-patterns.md",
      "source": "docs/patterns/production-block-patterns.md",
      "purpose": "Agent-readable rules for adapting SaaS block patterns into MiHCM components without raw visual values.",
      "tags": [
        "patterns",
        "agent",
        "components"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/patterns/production-block-patterns.md"
    },
    {
      "title": "Templates",
      "url": "/templates",
      "source": "src/apps/docs/app/templates/page.tsx",
      "purpose": "Reusable page templates and implementation examples.",
      "tags": [
        "templates"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/templates"
    },
    {
      "title": "Security",
      "url": "/downloads/agent/docs/SECURITY.md",
      "source": "docs/SECURITY.md",
      "purpose": "Quick security reference for library, registry, MCP, and AI-UI work.",
      "tags": [
        "security"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/SECURITY.md"
    },
    {
      "title": "Architecture",
      "url": "/downloads/agent/docs/ARCHITECTURE.md",
      "source": "docs/ARCHITECTURE.md",
      "purpose": "System architecture, packages, data flow, and boundaries.",
      "tags": [
        "architecture"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/ARCHITECTURE.md"
    },
    {
      "title": "Wiki index",
      "url": "/downloads/agent/docs/index.md",
      "source": "docs/index.md",
      "purpose": "Full local wiki catalog. Read before drilling into specific wiki pages.",
      "tags": [
        "wiki",
        "index"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/index.md"
    }
  ],
  "indexes": {
    "llms": "https://designsystem.mihcm.com/llms.txt",
    "llmsFull": "https://designsystem.mihcm.com/llms-full.txt",
    "agentScan": "https://designsystem.mihcm.com/agent-scan",
    "hostedMcp": "https://designsystem.mihcm.com/mcp",
    "skillPack": "https://designsystem.mihcm.com/downloads/skills/mihcm-skill-pack.json"
  },
  "counts": {
    "wiki": 133,
    "docsSite": 19,
    "componentContent": 210
  },
  "documents": [
    {
      "title": "Multi-Agent Orchestration",
      "url": "/downloads/agent/docs/AGENTS.md",
      "source": "docs/AGENTS.md",
      "purpose": "> Specialised subagents dispatched automatically based on task type. Each agent has a focused role, clear inputs/outputs, structured handoff.",
      "tags": [],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/AGENTS.md"
    },
    {
      "title": "Agent Scan Map",
      "url": "/downloads/agent/docs/AGENT_SCAN.md",
      "source": "docs/AGENT_SCAN.md",
      "purpose": "This is the local repository companion to the docs-site agent files.",
      "tags": [],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/AGENT_SCAN.md"
    },
    {
      "title": "Architecture",
      "url": "/downloads/agent/docs/ARCHITECTURE.md",
      "source": "docs/ARCHITECTURE.md",
      "purpose": "Architecture documentation.",
      "tags": [],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/ARCHITECTURE.md"
    },
    {
      "title": "Conventions",
      "url": "/downloads/agent/docs/CONVENTIONS.md",
      "source": "docs/CONVENTIONS.md",
      "purpose": "Components: `PascalCase.tsx` · Utils/hooks: `camelCase.ts` · Tests: `[name].test.ts(x)` · Stories: `[Name].stories.tsx` · Schemas: `[Name].ts` in `schemas/`.",
      "tags": [],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/CONVENTIONS.md"
    },
    {
      "title": "Security Quick Reference",
      "url": "/downloads/agent/docs/SECURITY.md",
      "source": "docs/SECURITY.md",
      "purpose": "> 32 rules. Full playbook: `docs/security-playbook.md` (100+ rules with IDs).",
      "tags": [
        "security"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/SECURITY.md"
    },
    {
      "title": "Security audit — 2026-05-23",
      "url": "/downloads/agent/docs/audits/2026-05-23-security-audit.md",
      "source": "docs/audits/2026-05-23-security-audit.md",
      "purpose": "> Full-stack security sweep across the eight `@mihcm/*` packages, the docs site, the hosted MCP server, the AI-UI renderer, and the CI/publish pipeline. Aligns with `docs/security-playbook.md` rule IDs (DEPS-*, AIUI-*, M",
      "tags": [],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/audits/2026-05-23-security-audit.md"
    },
    {
      "title": "Logo Usage",
      "url": "/downloads/agent/docs/brand/Logo.md",
      "source": "docs/brand/Logo.md",
      "purpose": "> Brand usage, clear-space rules, background guidance, and downloadable logo assets for humans and AI tools.",
      "tags": [],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/brand/Logo.md"
    },
    {
      "title": "AccessLevelGroup",
      "url": "/downloads/agent/docs/components/AccessLevelGroup.md",
      "source": "docs/components/AccessLevelGroup.md",
      "purpose": "> 4-state segmented button used to set per-module access: None / View / Edit / Full. Universal across React, Next.js, and React Native.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/components/AccessLevelGroup.md"
    },
    {
      "title": "Accordion",
      "url": "/downloads/agent/docs/components/Accordion.md",
      "source": "docs/components/Accordion.md",
      "purpose": "Vertically stacked collapsible sections. Supports single (one open) and multiple (any number open) modes with animated height transitions.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/components/Accordion.md"
    },
    {
      "title": "Alert",
      "url": "/downloads/agent/docs/components/Alert.md",
      "source": "docs/components/Alert.md",
      "purpose": "> Inline message banner for surfacing status, errors, warnings, or success feedback without interrupting the user's flow.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/components/Alert.md"
    },
    {
      "title": "AlertDialog",
      "url": "/downloads/agent/docs/components/AlertDialog.md",
      "source": "docs/components/AlertDialog.md",
      "purpose": "Non-dismissable modal requiring a user response. No backdrop dismiss, no Escape close. Composable sub-components mirror Dialog.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/components/AlertDialog.md"
    },
    {
      "title": "AspectRatio",
      "url": "/downloads/agent/docs/components/AspectRatio.md",
      "source": "docs/components/AspectRatio.md",
      "purpose": "> Locks a container to a given width-to-height ratio. Child content fills the container.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/components/AspectRatio.md"
    },
    {
      "title": "Avatar",
      "url": "/downloads/agent/docs/components/Avatar.md",
      "source": "docs/components/Avatar.md",
      "purpose": "> Composable user or entity portrait with image, fallback initials, status indicator, and group stacking.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/components/Avatar.md"
    },
    {
      "title": "AvatarGroup",
      "url": "/downloads/agent/docs/components/AvatarGroup.md",
      "source": "docs/components/AvatarGroup.md",
      "purpose": "Stacked, overlapping row of Avatar components with an overflow \"+N\" count. The `size` prop forwards to children. `max` controls the visible limit.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/components/AvatarGroup.md"
    },
    {
      "title": "Badge",
      "url": "/downloads/agent/docs/components/Badge.md",
      "source": "docs/components/Badge.md",
      "purpose": "> Small inline pill for labelling status, categories, or counts.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/components/Badge.md"
    },
    {
      "title": "Banner",
      "url": "/downloads/agent/docs/components/Banner.md",
      "source": "docs/components/Banner.md",
      "purpose": "Full-width message strip at top of page or section. Optionally dismissible.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/components/Banner.md"
    },
    {
      "title": "BarList",
      "url": "/downloads/agent/docs/components/BarList.md",
      "source": "docs/components/BarList.md",
      "purpose": "Compact ranked metric list for top modules, departments, campaigns, or usage counts.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/components/BarList.md"
    },
    {
      "title": "Breadcrumb",
      "url": "/downloads/agent/docs/components/Breadcrumb.md",
      "source": "docs/components/Breadcrumb.md",
      "purpose": "Navigation trail showing page hierarchy. Composable sub-components for flexible breadcrumb construction.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/components/Breadcrumb.md"
    },
    {
      "title": "Button",
      "url": "/downloads/agent/docs/components/Button.md",
      "source": "docs/components/Button.md",
      "purpose": "> Primary action affordance. Universal across React, Next.js, and React Native.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/components/Button.md"
    },
    {
      "title": "Calendar",
      "url": "/downloads/agent/docs/components/Calendar.md",
      "source": "docs/components/Calendar.md",
      "purpose": "> Date picker calendar grid powered by `@daypicker/react` v10. Supports the full DayPicker v10 prop surface with MiHCM tokenized defaults.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/components/Calendar.md"
    },
    {
      "title": "Card",
      "url": "/downloads/agent/docs/components/Card.md",
      "source": "docs/components/Card.md",
      "purpose": "> Composable container surface for grouping related content with a consistent border and padding structure.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/components/Card.md"
    },
    {
      "title": "Carousel",
      "url": "/downloads/agent/docs/components/Carousel.md",
      "source": "docs/components/Carousel.md",
      "purpose": "Composable carousel powered by Embla Carousel. Supports horizontal/vertical orientation, loop, responsive visible slide counts, custom pagination, and prev/next controls.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/components/Carousel.md"
    },
    {
      "title": "CategoryBar",
      "url": "/downloads/agent/docs/components/CategoryBar.md",
      "source": "docs/components/CategoryBar.md",
      "purpose": "Segmented distribution bar for status, risk, allocation, or progress mix summaries.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/components/CategoryBar.md"
    },
    {
      "title": "Chart",
      "url": "/downloads/agent/docs/components/Chart.md",
      "source": "docs/components/Chart.md",
      "purpose": "Theme-aware Recharts wrapper. Provides a context-based config system that maps data keys to labels, icons, and colours with light/dark theme support via CSS custom properties. The design-system layer intentionally stays ",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/components/Chart.md"
    },
    {
      "title": "Checkbox",
      "url": "/downloads/agent/docs/components/Checkbox.md",
      "source": "docs/components/Checkbox.md",
      "purpose": "> Three-state checkbox for binary or indeterminate selections. Controlled-only by design.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/components/Checkbox.md"
    },
    {
      "title": "CheckboxGrid",
      "url": "/downloads/agent/docs/components/CheckboxGrid.md",
      "source": "docs/components/CheckboxGrid.md",
      "purpose": "> Multi-select grid with summary, view tabs, filter, and bulk actions. Universal (web + native).",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/components/CheckboxGrid.md"
    },
    {
      "title": "Collapsible",
      "url": "/downloads/agent/docs/components/Collapsible.md",
      "source": "docs/components/Collapsible.md",
      "purpose": "> Simple expand/collapse panel powered by Radix Collapsible. Single toggle — no group/accordion semantics.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/components/Collapsible.md"
    },
    {
      "title": "Combobox",
      "url": "/downloads/agent/docs/components/Combobox.md",
      "source": "docs/components/Combobox.md",
      "purpose": "> Autocomplete search input that combines a text field with a filterable dropdown list.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/components/Combobox.md"
    },
    {
      "title": "Command",
      "url": "/downloads/agent/docs/components/Command.md",
      "source": "docs/components/Command.md",
      "purpose": "> ⌘K-style command palette powered by cmdk. Composable API with search, grouped items, and keyboard navigation.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/components/Command.md"
    },
    {
      "title": "ContextMenu",
      "url": "/downloads/agent/docs/components/ContextMenu.md",
      "source": "docs/components/ContextMenu.md",
      "purpose": "> Right-click context menu powered by Radix. Shares visual styling with DropdownMenu for consistency.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/components/ContextMenu.md"
    },
    {
      "title": "DataTable",
      "url": "/downloads/agent/docs/components/DataTable.md",
      "source": "docs/components/DataTable.md",
      "purpose": "Full-featured interactive data table built on TanStack Table v8 and rendered with MiHCM's `Table` primitives.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/components/DataTable.md"
    },
    {
      "title": "DatePicker",
      "url": "/downloads/agent/docs/components/DatePicker.md",
      "source": "docs/components/DatePicker.md",
      "purpose": "> Trigger + popover date input powered by the same `@daypicker/react` v10 calendar engine as `Calendar`. Use this for single dates, date ranges, date-time, and time-only fields without adding a second date picker depende",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/components/DatePicker.md"
    },
    {
      "title": "Dialog",
      "url": "/downloads/agent/docs/components/Dialog.md",
      "source": "docs/components/Dialog.md",
      "purpose": "> Accessible modal dialog built on native ``. Composable sub-components mirror Card's anatomy.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/components/Dialog.md"
    },
    {
      "title": "Drawer",
      "url": "/downloads/agent/docs/components/Drawer.md",
      "source": "docs/components/Drawer.md",
      "purpose": "> A mobile-friendly bottom sheet / drawer. Touch-optimised with swipe-to-dismiss.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/components/Drawer.md"
    },
    {
      "title": "DropdownMenu",
      "url": "/downloads/agent/docs/components/DropdownMenu.md",
      "source": "docs/components/DropdownMenu.md",
      "purpose": "Action menu triggered by a button click. Composable sub-components for building context-sensitive menus.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/components/DropdownMenu.md"
    },
    {
      "title": "Dropzone",
      "url": "/downloads/agent/docs/components/Dropzone.md",
      "source": "docs/components/Dropzone.md",
      "purpose": "Accessible file drop/input primitive powered by `react-dropzone`.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/components/Dropzone.md"
    },
    {
      "title": "EmptyState",
      "url": "/downloads/agent/docs/components/EmptyState.md",
      "source": "docs/components/EmptyState.md",
      "purpose": "Centered placeholder for empty sections -- optional icon, title, description, and action button.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/components/EmptyState.md"
    },
    {
      "title": "Form",
      "url": "/downloads/agent/docs/components/Form.md",
      "source": "docs/components/Form.md",
      "purpose": "Composable form field primitives integrated with TanStack React Form v1. Two layers: low-level building blocks for custom layouts, and integrated fields that wire everything together.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/components/Form.md"
    },
    {
      "title": "HoverCard",
      "url": "/downloads/agent/docs/components/HoverCard.md",
      "source": "docs/components/HoverCard.md",
      "purpose": "> Preview card that appears on hover. Powered by Radix HoverCard. Ideal for user profiles, link previews, and detail tooltips.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/components/HoverCard.md"
    },
    {
      "title": "Main Sidebar",
      "url": "/downloads/agent/docs/components/IconSidebar.md",
      "source": "docs/components/IconSidebar.md",
      "purpose": "> Figma-style main app sidebar. Compact primary rail on desktop, responsive bottom menu on mobile, horizontal tab bar on native.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/components/IconSidebar.md"
    },
    {
      "title": "Input",
      "url": "/downloads/agent/docs/components/Input.md",
      "source": "docs/components/Input.md",
      "purpose": "> Single-line text entry. Universal across React, Next.js, and React Native.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/components/Input.md"
    },
    {
      "title": "InputOTP",
      "url": "/downloads/agent/docs/components/InputOTP.md",
      "source": "docs/components/InputOTP.md",
      "purpose": "> One-time password / verification code input. Individual character slots with keyboard navigation.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/components/InputOTP.md"
    },
    {
      "title": "Label",
      "url": "/downloads/agent/docs/components/Label.md",
      "source": "docs/components/Label.md",
      "purpose": "> Text label for form fields. Renders `` on web and `` on native with a unified prop API.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/components/Label.md"
    },
    {
      "title": "Link",
      "url": "/downloads/agent/docs/components/Link.md",
      "source": "docs/components/Link.md",
      "purpose": "> Semantic navigation and reference primitive. Renders `` on web and an accessible link-like `Pressable` on native.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/components/Link.md"
    },
    {
      "title": "Logo",
      "url": "/downloads/agent/docs/components/Logo.md",
      "source": "docs/components/Logo.md",
      "purpose": "> Reusable MiHCM logo primitive. Universal (web + native). **Approved-asset only** — every rendering points at a vetted SVG from `/brand/logos`.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/components/Logo.md"
    },
    {
      "title": "MainSidebar",
      "url": "/downloads/agent/docs/components/MainSidebar.md",
      "source": "docs/components/MainSidebar.md",
      "purpose": "> Universal product navigation sidebar with five interaction models, deep nesting, mobile hamburger pattern, and full whitelabel theming. Web only (uses `motion/react`).",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/components/MainSidebar.md"
    },
    {
      "title": "Menubar",
      "url": "/downloads/agent/docs/components/Menubar.md",
      "source": "docs/components/Menubar.md",
      "purpose": "Horizontal menu bar with dropdown menus, powered by Radix. Suitable for application-style top menus (File, Edit, View).",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/components/Menubar.md"
    },
    {
      "title": "NavigationMenu",
      "url": "/downloads/agent/docs/components/NavigationMenu.md",
      "source": "docs/components/NavigationMenu.md",
      "purpose": "> Top-level site navigation bar with dropdown mega-menus. Powered by Radix.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/components/NavigationMenu.md"
    },
    {
      "title": "NotificationBadge",
      "url": "/downloads/agent/docs/components/NotificationBadge.md",
      "source": "docs/components/NotificationBadge.md",
      "purpose": "> Tiny counter dot that overlays a parent (the bell icon in the MiHCM Security TopBar). Universal across React, Next.js, and React Native.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/components/NotificationBadge.md"
    },
    {
      "title": "OrgSelector",
      "url": "/downloads/agent/docs/components/OrgSelector.md",
      "source": "docs/components/OrgSelector.md",
      "purpose": "> Form-field-shaped picker for hierarchical org structures (departments, teams, business units, cost centres, locations). Web only at v0.20.0; native variant planned.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/components/OrgSelector.md"
    },
    {
      "title": "PageShell",
      "url": "/downloads/agent/docs/components/PageShell.md",
      "source": "docs/components/PageShell.md",
      "purpose": "> Outer application scaffold: `TopBar` on top, `MainSidebar` on the left on desktop, mobile menu anchored at the bottom, scrollable content in the main region. Universal (web + native).",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/components/PageShell.md"
    },
    {
      "title": "Pagination",
      "url": "/downloads/agent/docs/components/Pagination.md",
      "source": "docs/components/Pagination.md",
      "purpose": "Page navigation with numbered links and previous/next buttons. Composable sub-components.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/components/Pagination.md"
    },
    {
      "title": "Popover",
      "url": "/downloads/agent/docs/components/Popover.md",
      "source": "docs/components/Popover.md",
      "purpose": "> Click-triggered floating panel anchored to a trigger element. Composable sub-components built on the shared `Popper` positioning layer.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/components/Popover.md"
    },
    {
      "title": "Popper",
      "url": "/downloads/agent/docs/components/Popper.md",
      "source": "docs/components/Popper.md",
      "purpose": "Low-level web positioning primitive powered by `react-popper` and `@popperjs/core`. Use it when the higher-level Tooltip, Popover, DropdownMenu, Select, or ContextMenu components do not expose enough placement control.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/components/Popper.md"
    },
    {
      "title": "Progress",
      "url": "/downloads/agent/docs/components/Progress.md",
      "source": "docs/components/Progress.md",
      "purpose": "Horizontal bar showing completion percentage. Determinate (0-100) or indeterminate (animated shimmer). Five tone variants.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/components/Progress.md"
    },
    {
      "title": "ProgressCircle",
      "url": "/downloads/agent/docs/components/ProgressCircle.md",
      "source": "docs/components/ProgressCircle.md",
      "purpose": "Circular KPI progress for compact cards and dashboard summaries.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/components/ProgressCircle.md"
    },
    {
      "title": "RadioCardGroup",
      "url": "/downloads/agent/docs/components/RadioCardGroup.md",
      "source": "docs/components/RadioCardGroup.md",
      "purpose": "Card-style single choice control built on the same radiogroup semantics as `RadioGroup`.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/components/RadioCardGroup.md"
    },
    {
      "title": "RadioGroup",
      "url": "/downloads/agent/docs/components/RadioGroup.md",
      "source": "docs/components/RadioGroup.md",
      "purpose": "Mutually exclusive option selection. Fieldset with RadioGroupItem children sharing state via React Context.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/components/RadioGroup.md"
    },
    {
      "title": "Resizable",
      "url": "/downloads/agent/docs/components/Resizable.md",
      "source": "docs/components/Resizable.md",
      "purpose": "> Resizable panel layout with draggable dividers. Split views for editors, dashboards, and admin layouts.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/components/Resizable.md"
    },
    {
      "title": "RichTextEditor",
      "url": "/downloads/agent/docs/components/RichTextEditor.md",
      "source": "docs/components/RichTextEditor.md",
      "purpose": "> Lexical-powered rich text editor styled to match the MiHCM design system. **Web only.** Native apps should use a platform-specific editor.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/components/RichTextEditor.md"
    },
    {
      "title": "ScrollArea",
      "url": "/downloads/agent/docs/components/ScrollArea.md",
      "source": "docs/components/ScrollArea.md",
      "purpose": "> Custom-styled scrollable container powered by Radix ScrollArea. Thin translucent scrollbars that appear on hover/scroll.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/components/ScrollArea.md"
    },
    {
      "title": "SearchField",
      "url": "/downloads/agent/docs/components/SearchField.md",
      "source": "docs/components/SearchField.md",
      "purpose": "> Sugar wrapper around `Input` that ships the magnifier glyph, a clear button, and `role=\"search\"`. Universal across React, Next.js, and React Native.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/components/SearchField.md"
    },
    {
      "title": "SectionHeader",
      "url": "/downloads/agent/docs/components/SectionHeader.md",
      "source": "docs/components/SectionHeader.md",
      "purpose": "> Small two-line header used inside permission editors and settings panels. Universal across React, Next.js, and React Native.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/components/SectionHeader.md"
    },
    {
      "title": "Select",
      "url": "/downloads/agent/docs/components/Select.md",
      "source": "docs/components/Select.md",
      "purpose": "Select provides a simple composable listbox API plus React Select-powered web wrappers for complex product selectors.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/components/Select.md"
    },
    {
      "title": "Separator",
      "url": "/downloads/agent/docs/components/Separator.md",
      "source": "docs/components/Separator.md",
      "purpose": "> Semantic divider line for visually and optionally structurally separating content sections.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/components/Separator.md"
    },
    {
      "title": "Sheet",
      "url": "/downloads/agent/docs/components/Sheet.md",
      "source": "docs/components/Sheet.md",
      "purpose": "Slide-out panel from a screen edge. Dismisses on backdrop click and Escape key. Composable sub-components mirror Dialog.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/components/Sheet.md"
    },
    {
      "title": "Sidebar",
      "url": "/downloads/agent/docs/components/Sidebar.md",
      "source": "docs/components/Sidebar.md",
      "purpose": "Composable, collapsible sidebar with mobile sheet support, keyboard shortcuts (Ctrl/Cmd+B), and cookie persistence.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/components/Sidebar.md"
    },
    {
      "title": "Skeleton",
      "url": "/downloads/agent/docs/components/Skeleton.md",
      "source": "docs/components/Skeleton.md",
      "purpose": "> Pulsing placeholder block for loading states. Preserves layout and communicates structure while data loads.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/components/Skeleton.md"
    },
    {
      "title": "Slider",
      "url": "/downloads/agent/docs/components/Slider.md",
      "source": "docs/components/Slider.md",
      "purpose": "> Range input powered by Radix Slider. Single value or dual-thumb range mode. Three size variants.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/components/Slider.md"
    },
    {
      "title": "SortableList",
      "url": "/downloads/agent/docs/components/SortableList.md",
      "source": "docs/components/SortableList.md",
      "purpose": "Reorderable list powered by `@dnd-kit/core` and `@dnd-kit/sortable`.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/components/SortableList.md"
    },
    {
      "title": "SparkChart",
      "url": "/downloads/agent/docs/components/SparkChart.md",
      "source": "docs/components/SparkChart.md",
      "purpose": "Small inline trend chart powered by D3 scales and shape generation.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/components/SparkChart.md"
    },
    {
      "title": "StatCard",
      "url": "/downloads/agent/docs/components/StatCard.md",
      "source": "docs/components/StatCard.md",
      "purpose": "> Single-metric tile. Seven layout variants for product KPI surfaces. Web-only — `trend` and `distribution` pull in `SparkChart` (D3) and `CategoryBar`.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/components/StatCard.md"
    },
    {
      "title": "StatusBadge",
      "url": "/downloads/agent/docs/components/StatusBadge.md",
      "source": "docs/components/StatusBadge.md",
      "purpose": "> Small inline icon + label chip. Used to mark something as \"Module enabled\" / \"No permission\" / \"Active\" / etc. Universal across React, Next.js, and React Native.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/components/StatusBadge.md"
    },
    {
      "title": "Switch",
      "url": "/downloads/agent/docs/components/Switch.md",
      "source": "docs/components/Switch.md",
      "purpose": "> Binary on/off toggle for settings with immediate effect. Controlled-only by design.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/components/Switch.md"
    },
    {
      "title": "TabNavigation",
      "url": "/downloads/agent/docs/components/TabNavigation.md",
      "source": "docs/components/TabNavigation.md",
      "purpose": "Route and action navigation for section-level product surfaces.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/components/TabNavigation.md"
    },
    {
      "title": "Table",
      "url": "/downloads/agent/docs/components/Table.md",
      "source": "docs/components/Table.md",
      "purpose": "Semantic HTML data table primitives with 5 visual variants.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/components/Table.md"
    },
    {
      "title": "Tabs",
      "url": "/downloads/agent/docs/components/Tabs.md",
      "source": "docs/components/Tabs.md",
      "purpose": "> Accessible tabbed interface with keyboard navigation. Controlled-only.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/components/Tabs.md"
    },
    {
      "title": "Tag",
      "url": "/downloads/agent/docs/components/Tag.md",
      "source": "docs/components/Tag.md",
      "purpose": "Label chip with optional remove action. Like Badge but interactive -- can be removed via the X button.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/components/Tag.md"
    },
    {
      "title": "Text",
      "url": "/downloads/agent/docs/components/Text.md",
      "source": "docs/components/Text.md",
      "purpose": "> Type primitive. Renders semantic text elements on web through `as`, and `` on native with matching API.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/components/Text.md"
    },
    {
      "title": "Textarea",
      "url": "/downloads/agent/docs/components/Textarea.md",
      "source": "docs/components/Textarea.md",
      "purpose": "> Multi-line text input. Shares the variant and invalid model with Input for consistent form styling.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/components/Textarea.md"
    },
    {
      "title": "TitleBar",
      "url": "/downloads/agent/docs/components/TitleBar.md",
      "source": "docs/components/TitleBar.md",
      "purpose": "> Sticky page heading shown under the [`TopBar`](./TopBar.md). Universal across React, Next.js, and React Native.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/components/TitleBar.md"
    },
    {
      "title": "Toast",
      "url": "/downloads/agent/docs/components/Toast.md",
      "source": "docs/components/Toast.md",
      "purpose": "> Notification surface built on [sonner](https://sonner.emilkowal.ski/), themed end-to-end with MiHCM tokens. Web only.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/components/Toast.md"
    },
    {
      "title": "Toggle",
      "url": "/downloads/agent/docs/components/Toggle.md",
      "source": "docs/components/Toggle.md",
      "purpose": "> Pressable toggle button with on/off state. `ToggleGroup` enables single- or multi-select groups.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/components/Toggle.md"
    },
    {
      "title": "Tooltip",
      "url": "/downloads/agent/docs/components/Tooltip.md",
      "source": "docs/components/Tooltip.md",
      "purpose": "> Hover/focus tooltip for supplementary labels. Non-interactive content only.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/components/Tooltip.md"
    },
    {
      "title": "TopBar",
      "url": "/downloads/agent/docs/components/TopBar.md",
      "source": "docs/components/TopBar.md",
      "purpose": "> Segmented app header with compound sub-components. Universal (web + native).",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/components/TopBar.md"
    },
    {
      "title": "Tracker",
      "url": "/downloads/agent/docs/components/Tracker.md",
      "source": "docs/components/Tracker.md",
      "purpose": "Dense status tracker for uptime windows, workflow stages, incident timelines, and allocation strips.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/components/Tracker.md"
    },
    {
      "title": "TransferList",
      "url": "/downloads/agent/docs/components/TransferList.md",
      "source": "docs/components/TransferList.md",
      "purpose": "> Dual-pane shuttle: unassigned on the left, assigned on the right, four move buttons in the middle. Universal (web + native).",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/components/TransferList.md"
    },
    {
      "title": "Contributing Agent Skills",
      "url": "/downloads/agent/docs/contributing/agent-skills.md",
      "source": "docs/contributing/agent-skills.md",
      "purpose": "Agent skills are workflow contracts. Keep them small, explicit, and safe.",
      "tags": [
        "agent"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/contributing/agent-skills.md"
    },
    {
      "title": "Contributing Components",
      "url": "/downloads/agent/docs/contributing/components.md",
      "source": "docs/contributing/components.md",
      "purpose": "Use this checklist for every new or materially changed primitive.",
      "tags": [],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/contributing/components.md"
    },
    {
      "title": "Contributing Docs",
      "url": "/downloads/agent/docs/contributing/docs.md",
      "source": "docs/contributing/docs.md",
      "purpose": "Docs are part of the product. A component is not complete until users and agents can understand it.",
      "tags": [],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/contributing/docs.md"
    },
    {
      "title": "ADR-NNN —",
      "url": "/downloads/agent/docs/decisions/000-template.md",
      "source": "docs/decisions/000-template.md",
      "purpose": "**Status**: Proposed | Accepted | Deprecated · **Date**: YYYY-MM-DD",
      "tags": [
        "adr"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/decisions/000-template.md"
    },
    {
      "title": "ADR-001 — NativeWind v4 + Tailwind 4 over Tamagui (v5 deferred — ADR-013)",
      "url": "/downloads/agent/docs/decisions/001-nativewind-over-tamagui.md",
      "source": "docs/decisions/001-nativewind-over-tamagui.md",
      "purpose": "**Status**: Accepted · **Date**: 2026-05-10",
      "tags": [
        "adr"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/decisions/001-nativewind-over-tamagui.md"
    },
    {
      "title": "ADR-002 — Monorepo: pnpm + turborepo + changesets",
      "url": "/downloads/agent/docs/decisions/002-monorepo-tooling.md",
      "source": "docs/decisions/002-monorepo-tooling.md",
      "purpose": "**Status**: Accepted · **Date**: 2026-05-10",
      "tags": [
        "adr"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/decisions/002-monorepo-tooling.md"
    },
    {
      "title": "ADR-003 — Archived GitHub Packages registry decision",
      "url": "/downloads/agent/docs/decisions/003-github-packages.md",
      "source": "docs/decisions/003-github-packages.md",
      "purpose": "**Status**: Superseded for public consumer distribution by ADR-018 · **Date**: 2026-05-10",
      "tags": [
        "adr"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/decisions/003-github-packages.md"
    },
    {
      "title": "ADR-004 — Storybook with `@storybook/react-native-web-vite`",
      "url": "/downloads/agent/docs/decisions/004-storybook-rnw-vite.md",
      "source": "docs/decisions/004-storybook-rnw-vite.md",
      "purpose": "**Status**: Accepted · **Date**: 2026-05-10",
      "tags": [
        "adr"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/decisions/004-storybook-rnw-vite.md"
    },
    {
      "title": "ADR-005 — Hybrid distribution: install + CLI copy-paste",
      "url": "/downloads/agent/docs/decisions/005-hybrid-distribution.md",
      "source": "docs/decisions/005-hybrid-distribution.md",
      "purpose": "**Status**: Accepted · **Date**: 2026-05-10",
      "tags": [
        "adr"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/decisions/005-hybrid-distribution.md"
    },
    {
      "title": "ADR-006 — Karpathy guidelines as Priority 0 in CLAUDE.md",
      "url": "/downloads/agent/docs/decisions/006-karpathy-priority-zero.md",
      "source": "docs/decisions/006-karpathy-priority-zero.md",
      "purpose": "**Status**: Accepted · **Date**: 2026-05-10",
      "tags": [
        "adr"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/decisions/006-karpathy-priority-zero.md"
    },
    {
      "title": "ADR-007 — Adopt the LLM-Wiki pattern for `docs/`",
      "url": "/downloads/agent/docs/decisions/007-llm-wiki-pattern.md",
      "source": "docs/decisions/007-llm-wiki-pattern.md",
      "purpose": "**Status**: Accepted · **Date**: 2026-05-10",
      "tags": [
        "adr"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/decisions/007-llm-wiki-pattern.md"
    },
    {
      "title": "ADR-008 — License = MIT",
      "url": "/downloads/agent/docs/decisions/008-mit-license.md",
      "source": "docs/decisions/008-mit-license.md",
      "purpose": "**Status**: Accepted · **Date**: 2026-05-10",
      "tags": [
        "adr"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/decisions/008-mit-license.md"
    },
    {
      "title": "ADR-009 — Private GitHub repo with public npm org packages",
      "url": "/downloads/agent/docs/decisions/009-personal-account-scope.md",
      "source": "docs/decisions/009-personal-account-scope.md",
      "purpose": "**Status**: Superseded by ADR-018 for registry distribution · **Date**: 2026-05-10 · **Updated**: 2026-05-22",
      "tags": [
        "adr"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/decisions/009-personal-account-scope.md"
    },
    {
      "title": "ADR-010 — Isolate project monorepo inside `src/`",
      "url": "/downloads/agent/docs/decisions/010-src-isolation.md",
      "source": "docs/decisions/010-src-isolation.md",
      "purpose": "**Status**: Accepted · **Date**: 2026-05-10",
      "tags": [
        "adr"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/decisions/010-src-isolation.md"
    },
    {
      "title": "ADR-011 — Publish gate without GitHub Environments",
      "url": "/downloads/agent/docs/decisions/011-publish-gate-without-environments.md",
      "source": "docs/decisions/011-publish-gate-without-environments.md",
      "purpose": "**Status**: Accepted · **Date**: 2026-05-10",
      "tags": [
        "adr"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/decisions/011-publish-gate-without-environments.md"
    },
    {
      "title": "ADR-012 — Archived GitHub Packages PAT guidance",
      "url": "/downloads/agent/docs/decisions/012-classic-pat-for-npm.md",
      "source": "docs/decisions/012-classic-pat-for-npm.md",
      "purpose": "**Status**: Superseded for consumer installs by ADR-018 · **Date**: 2026-05-10",
      "tags": [
        "adr"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/decisions/012-classic-pat-for-npm.md"
    },
    {
      "title": "ADR-013 — Version audit, 2026-05-10",
      "url": "/downloads/agent/docs/decisions/013-version-audit-2026-05.md",
      "source": "docs/decisions/013-version-audit-2026-05.md",
      "purpose": "**Status**: Accepted · **Date**: 2026-05-10",
      "tags": [
        "adr"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/decisions/013-version-audit-2026-05.md"
    },
    {
      "title": "ADR-014 — Pin postcss via pnpm.overrides to fix CVE-2026-41305",
      "url": "/downloads/agent/docs/decisions/014-postcss-override-fix.md",
      "source": "docs/decisions/014-postcss-override-fix.md",
      "purpose": "**Status**: Accepted · **Date**: 2026-05-10",
      "tags": [
        "adr"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/decisions/014-postcss-override-fix.md"
    },
    {
      "title": "ADR-015 — Major-bump cascade, 2026-05-10",
      "url": "/downloads/agent/docs/decisions/015-major-bump-cascade.md",
      "source": "docs/decisions/015-major-bump-cascade.md",
      "purpose": "**Status**: Accepted · **Date**: 2026-05-10",
      "tags": [
        "adr"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/decisions/015-major-bump-cascade.md"
    },
    {
      "title": "ADR-016 — Primitives roadmap & implementation rules",
      "url": "/downloads/agent/docs/decisions/016-primitives-roadmap.md",
      "source": "docs/decisions/016-primitives-roadmap.md",
      "purpose": "**Status**: Accepted · **Date**: 2026-05-11 · **Context**: ADR-001, ADR-005, ADR-013",
      "tags": [
        "adr"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/decisions/016-primitives-roadmap.md"
    },
    {
      "title": "ADR-017: External Developer Distribution Model",
      "url": "/downloads/agent/docs/decisions/017-external-developer-distribution.md",
      "source": "docs/decisions/017-external-developer-distribution.md",
      "purpose": "Accepted. Updated by ADR-018 for public npm package distribution.",
      "tags": [
        "adr"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/decisions/017-external-developer-distribution.md"
    },
    {
      "title": "ADR-018 — Public npm package distribution with private source",
      "url": "/downloads/agent/docs/decisions/018-public-npm-package-distribution.md",
      "source": "docs/decisions/018-public-npm-package-distribution.md",
      "purpose": "**Status**: Accepted · **Date**: 2026-05-21",
      "tags": [
        "adr"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/decisions/018-public-npm-package-distribution.md"
    },
    {
      "title": "MiHCM Design System — design.md",
      "url": "/downloads/agent/docs/design.md",
      "source": "docs/design.md",
      "purpose": "> **Consumer-facing AI agent guide.** This file lives in the root of a consumer project (alongside `package.json`). Any AI agent working on UI in this project MUST follow these rules. The canonical version ships in `@mih",
      "tags": [],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/design.md"
    },
    {
      "title": "Design Assets",
      "url": "/downloads/agent/docs/getting-started/design-assets.md",
      "source": "docs/getting-started/design-assets.md",
      "purpose": "Use this page to align Figma, code, docs, Storybook, MCP, and agent skills.",
      "tags": [
        "onboarding"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/getting-started/design-assets.md"
    },
    {
      "title": "External Developer Guide",
      "url": "/downloads/agent/docs/getting-started/external-developers.md",
      "source": "docs/getting-started/external-developers.md",
      "purpose": "Use this guide when building an app with the MiHCM Design System from outside the core repo.",
      "tags": [
        "onboarding"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/getting-started/external-developers.md"
    },
    {
      "title": "Registry Access",
      "url": "/downloads/agent/docs/getting-started/registry-access.md",
      "source": "docs/getting-started/registry-access.md",
      "purpose": "MiHCM packages are public npm packages under `@mihcm/*`. Consumers do not need a GitHub personal access token, package token, or project `.npmrc`.",
      "tags": [
        "onboarding"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/getting-started/registry-access.md"
    },
    {
      "title": "Wiki Index",
      "url": "/downloads/agent/docs/index.md",
      "source": "docs/index.md",
      "purpose": "> Catalog of every page in this wiki. Always read FIRST when answering a question.",
      "tags": [],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/index.md"
    },
    {
      "title": "Action Log",
      "url": "/downloads/agent/docs/log.md",
      "source": "docs/log.md",
      "purpose": "> Append-only chronological record of every meaningful change. Format: `## [YYYY-MM-DD] | `.",
      "tags": [],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/log.md"
    },
    {
      "title": "Marketing Typography",
      "url": "/downloads/agent/docs/marketing/Typography.md",
      "source": "docs/marketing/Typography.md",
      "purpose": "> Website-only typography guidance for public marketing pages, campaign pages, landing pages, and brand storytelling.",
      "tags": [],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/marketing/Typography.md"
    },
    {
      "title": "Production Block Pattern Library",
      "url": "/downloads/agent/docs/patterns/production-block-patterns.md",
      "source": "docs/patterns/production-block-patterns.md",
      "purpose": "> Agent-readable guide for translating proven SaaS block patterns into MiHCM",
      "tags": [],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/patterns/production-block-patterns.md"
    },
    {
      "title": "Component Expansion Plan",
      "url": "/downloads/agent/docs/plans/component-expansion.md",
      "source": "docs/plans/component-expansion.md",
      "purpose": "> Research-backed implementation plan for expanding MiHCM Design System with",
      "tags": [],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/plans/component-expansion.md"
    },
    {
      "title": "Add a Component",
      "url": "/downloads/agent/docs/runbooks/add-component.md",
      "source": "docs/runbooks/add-component.md",
      "purpose": "> Step-by-step for adding a new universal primitive to `@mihcm/ui`.",
      "tags": [
        "runbook"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/runbooks/add-component.md"
    },
    {
      "title": "Component Expandability Roadmap",
      "url": "/downloads/agent/docs/runbooks/component-expandability-roadmap.md",
      "source": "docs/runbooks/component-expandability-roadmap.md",
      "purpose": "> Status: planning. Use this roadmap before adding component props, examples, Storybook stories, MCP recipes, or AI-UI descriptors.",
      "tags": [
        "runbook"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/runbooks/component-expandability-roadmap.md"
    },
    {
      "title": "GitHub Repo Setup (After Initial Push)",
      "url": "/downloads/agent/docs/runbooks/github-repo-setup.md",
      "source": "docs/runbooks/github-repo-setup.md",
      "purpose": "> One-time clicks needed in the GitHub web UI before we publish v1.",
      "tags": [
        "runbook"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/runbooks/github-repo-setup.md"
    },
    {
      "title": "Install vs. Copy-Paste",
      "url": "/downloads/agent/docs/runbooks/install-vs-copy-paste.md",
      "source": "docs/runbooks/install-vs-copy-paste.md",
      "purpose": "> The MiHCM Design System ships every primitive **both ways** so a consumer can choose per-primitive. This runbook covers when to pick which and how to actually do it. Rationale: [ADR-005](../decisions/005-hybrid-distrib",
      "tags": [
        "runbook"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/runbooks/install-vs-copy-paste.md"
    },
    {
      "title": "MCP Setup",
      "url": "/downloads/agent/docs/runbooks/mcp-setup.md",
      "source": "docs/runbooks/mcp-setup.md",
      "purpose": "> First-party and external MCP servers for design-system work. Prefer the first-party `mihcm` server for repo facts, then external servers for source material or live platform state.",
      "tags": [
        "runbook",
        "agent"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/runbooks/mcp-setup.md"
    },
    {
      "title": "Next.js MiHCM-Only Enforcement",
      "url": "/downloads/agent/docs/runbooks/nextjs-mihcm-only-enforcement.md",
      "source": "docs/runbooks/nextjs-mihcm-only-enforcement.md",
      "purpose": "Use this runbook when a consumer app must build UI only from the MiHCM Design System.",
      "tags": [
        "runbook"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/runbooks/nextjs-mihcm-only-enforcement.md"
    },
    {
      "title": "Public Registry Setup (Consumer Side)",
      "url": "/downloads/agent/docs/runbooks/private-registry-setup.md",
      "source": "docs/runbooks/private-registry-setup.md",
      "purpose": "> Historical filename kept for existing links. Current consumer installs use public npm packages, not a private registry.",
      "tags": [
        "runbook"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/runbooks/private-registry-setup.md"
    },
    {
      "title": "Publish a Package",
      "url": "/downloads/agent/docs/runbooks/publish-package.md",
      "source": "docs/runbooks/publish-package.md",
      "purpose": "> CI-only with OIDC. We never run `npm publish` from a developer machine.",
      "tags": [
        "runbook"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/runbooks/publish-package.md"
    },
    {
      "title": "Remote MCP For Developers",
      "url": "/downloads/agent/docs/runbooks/remote-mcp-for-developers.md",
      "source": "docs/runbooks/remote-mcp-for-developers.md",
      "purpose": "The hosted MiHCM MCP endpoint gives agents live design-system facts without cloning the repo:",
      "tags": [
        "runbook"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/runbooks/remote-mcp-for-developers.md"
    },
    {
      "title": "Vercel deploy — docs site & Storybook",
      "url": "/downloads/agent/docs/runbooks/vercel-deploy.md",
      "source": "docs/runbooks/vercel-deploy.md",
      "purpose": "We host **two separate Vercel projects** off the same repo with GitHub integration:",
      "tags": [
        "runbook"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/runbooks/vercel-deploy.md"
    },
    {
      "title": "Security Playbook (Library & Registry Threat Model)",
      "url": "/downloads/agent/docs/security-playbook.md",
      "source": "docs/security-playbook.md",
      "purpose": "> Rules with IDs. Reference in reviews: \"Violates DEPS-02\".",
      "tags": [
        "security"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/security-playbook.md"
    },
    {
      "title": "Grid System",
      "url": "/downloads/agent/docs/tokens/Grid.md",
      "source": "docs/tokens/Grid.md",
      "purpose": "> Responsive layout rules for MiHCM screens, templates, examples, and consumer applications.",
      "tags": [
        "tokens"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/tokens/Grid.md"
    },
    {
      "title": "Design Tokens",
      "url": "/downloads/agent/docs/tokens/Tokens.md",
      "source": "docs/tokens/Tokens.md",
      "purpose": "> Centralised visual primitives — color, typography, spacing, radius, shadow, motion, and grid rules — consumed by every component.",
      "tags": [
        "tokens"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/tokens/Tokens.md"
    },
    {
      "title": "Code Review Verification - 2026-05-16",
      "url": "/downloads/agent/docs/verification/2026-05-16-code-review.md",
      "source": "docs/verification/2026-05-16-code-review.md",
      "purpose": "This pass covered the current `yashi/component-audit-fix-pass` branch across the monorepo source, documentation, generated agent assets, MCP package, AI-UI package, and Storybook/docs release surfaces.",
      "tags": [],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/verification/2026-05-16-code-review.md"
    },
    {
      "title": "Versioning And Stability",
      "url": "/downloads/agent/docs/versioning.md",
      "source": "docs/versioning.md",
      "purpose": "The design system uses semver through Changesets.",
      "tags": [],
      "absoluteUrl": "https://designsystem.mihcm.com/downloads/agent/docs/versioning.md"
    },
    {
      "title": "Agent Scan",
      "url": "/agent-scan",
      "source": "src/apps/docs/app/agent-scan/page.mdx",
      "purpose": "This page is the first stop for coding agents, documentation agents, and external AI tools that need to locate the right MiHCM Design System context quickly.",
      "tags": [
        "agent"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/agent-scan"
    },
    {
      "title": "Agent tooling",
      "url": "/agent-tooling",
      "source": "src/apps/docs/app/agent-tooling/page.mdx",
      "purpose": "MiHCM ships agent tooling in two layers:",
      "tags": [
        "agent"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/agent-tooling"
    },
    {
      "title": "Generative UI, safely",
      "url": "/ai-ui",
      "source": "src/apps/docs/app/ai-ui/page.mdx",
      "purpose": "`@mihcm/ai-ui` lets a language model return a UI as JSON. The renderer validates the descriptor, looks up each component in an explicit allowlist, caps recursion depth, and renders via the universal primitives. The same ",
      "tags": [
        "ai-ui"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/ai-ui"
    },
    {
      "title": "Contributing Agent Skills",
      "url": "/contributing/agent-skills",
      "source": "src/apps/docs/app/contributing/agent-skills/page.mdx",
      "purpose": "Agent skills are workflow contracts. Keep them small, explicit, and safe.",
      "tags": [
        "agent"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/contributing/agent-skills"
    },
    {
      "title": "Contributing Components",
      "url": "/contributing/components",
      "source": "src/apps/docs/app/contributing/components/page.mdx",
      "purpose": "Use this checklist for every new or materially changed primitive.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/contributing/components"
    },
    {
      "title": "Contributing Docs",
      "url": "/contributing/docs",
      "source": "src/apps/docs/app/contributing/docs/page.mdx",
      "purpose": "Docs are part of the product. A component is not complete until users and agents can understand it.",
      "tags": [],
      "absoluteUrl": "https://designsystem.mihcm.com/contributing/docs"
    },
    {
      "title": "Designing",
      "url": "/designing",
      "source": "src/apps/docs/app/designing/page.mdx",
      "purpose": "The design language is small on purpose. Five principles, one token set, one prop surface. Everything else falls out of those.",
      "tags": [],
      "absoluteUrl": "https://designsystem.mihcm.com/designing"
    },
    {
      "title": "Client and Server Components",
      "url": "/developing/client-server-components",
      "source": "src/apps/docs/app/developing/client-server-components/page.mdx",
      "purpose": "MiHCM UI components are browser-capable React components. In a Next.js App",
      "tags": [],
      "absoluteUrl": "https://designsystem.mihcm.com/developing/client-server-components"
    },
    {
      "title": "Component Expandability Roadmap",
      "url": "/developing/component-expandability",
      "source": "src/apps/docs/app/developing/component-expandability/page.mdx",
      "purpose": "This roadmap defines how MiHCM components should become more useful without turning the API into unbounded prop sprawl.",
      "tags": [],
      "absoluteUrl": "https://designsystem.mihcm.com/developing/component-expandability"
    },
    {
      "title": "MiHCM-only Next.js enforcement",
      "url": "/developing/mihcm-only-nextjs",
      "source": "src/apps/docs/app/developing/mihcm-only-nextjs/page.mdx",
      "purpose": "Use this setup when a Next.js app must build UI only from the MiHCM Design System.",
      "tags": [],
      "absoluteUrl": "https://designsystem.mihcm.com/developing/mihcm-only-nextjs"
    },
    {
      "title": "Developing",
      "url": "/developing",
      "source": "src/apps/docs/app/developing/page.mdx",
      "purpose": "The same packages work on three runtimes. Packages are public on npm, so start with install, pick the section that matches your project, ship.",
      "tags": [],
      "absoluteUrl": "https://designsystem.mihcm.com/developing"
    },
    {
      "title": "Design Assets",
      "url": "/getting-started/design-assets",
      "source": "src/apps/docs/app/getting-started/design-assets/page.mdx",
      "purpose": "Use this page to align Figma, code, docs, Storybook, MCP, and agent skills.",
      "tags": [
        "onboarding"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/getting-started/design-assets"
    },
    {
      "title": "External Developer Guide",
      "url": "/getting-started/external-developers",
      "source": "src/apps/docs/app/getting-started/external-developers/page.mdx",
      "purpose": "Use this guide when building an app with the MiHCM Design System from outside the core repo.",
      "tags": [
        "onboarding"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/getting-started/external-developers"
    },
    {
      "title": "Registry Access",
      "url": "/getting-started/registry-access",
      "source": "src/apps/docs/app/getting-started/registry-access/page.mdx",
      "purpose": "MiHCM packages are public npm packages under `@mihcm/*`. Consumers do not need a GitHub personal access token, package token, or project `.npmrc`.",
      "tags": [
        "onboarding"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/getting-started/registry-access"
    },
    {
      "title": "Changelog",
      "url": "/help/changelog",
      "source": "src/apps/docs/app/help/changelog/page.mdx",
      "purpose": "Each package follows semver, driven by [changesets](https://github.com/changesets/changesets). Per-package changelogs live in the repository after the Version Packages PR runs; this page summarises the release train at a",
      "tags": [],
      "absoluteUrl": "https://designsystem.mihcm.com/help/changelog"
    },
    {
      "title": "FAQ",
      "url": "/help/faq",
      "source": "src/apps/docs/app/help/faq/page.mdx",
      "purpose": "No. MiHCM packages are public on npm. If you see `401` or `403` from `npm.pkg.github.com`, remove any `@mihcm:registry=https://npm.pkg.github.com` or legacy `@yashiel:registry=https://npm.pkg.github.com` override from yo",
      "tags": [],
      "absoluteUrl": "https://designsystem.mihcm.com/help/faq"
    },
    {
      "title": "Must know",
      "url": "/must-know",
      "source": "src/apps/docs/app/must-know/page.mdx",
      "purpose": "Five things that catch most people on their first build. Read this before you reach for a primitive.",
      "tags": [],
      "absoluteUrl": "https://designsystem.mihcm.com/must-know"
    },
    {
      "title": "Code Review Verification",
      "url": "/verification/code-review",
      "source": "src/apps/docs/app/verification/code-review/page.mdx",
      "purpose": "This page records the 2026-05-16 verification pass for the current component audit branch. It covers source review, documentation coverage, MCP, skills, AI-UI descriptor policy, security checks, functional checks, and re",
      "tags": [],
      "absoluteUrl": "https://designsystem.mihcm.com/verification/code-review"
    },
    {
      "title": "Versioning And Stability",
      "url": "/versioning",
      "source": "src/apps/docs/app/versioning/page.mdx",
      "purpose": "The design system uses semver through Changesets.",
      "tags": [],
      "absoluteUrl": "https://designsystem.mihcm.com/versioning"
    },
    {
      "title": "Accessibility",
      "url": "/components/access-level-group/accessibility",
      "source": "src/apps/docs/content/components/access-level-group/accessibility.mdx",
      "purpose": "Accessibility component documentation.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/access-level-group/accessibility"
    },
    {
      "title": "Examples",
      "url": "/components/access-level-group/examples",
      "source": "src/apps/docs/content/components/access-level-group/examples.mdx",
      "purpose": "",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/access-level-group/examples"
    },
    {
      "title": "Usage",
      "url": "/components/access-level-group/usage",
      "source": "src/apps/docs/content/components/access-level-group/usage.mdx",
      "purpose": "The default four levels match the MiHCM Security prototype:",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/access-level-group/usage"
    },
    {
      "title": "Accessibility",
      "url": "/components/accordion/accessibility",
      "source": "src/apps/docs/content/components/accordion/accessibility.mdx",
      "purpose": "Accessibility component documentation.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/accordion/accessibility"
    },
    {
      "title": "Examples",
      "url": "/components/accordion/examples",
      "source": "src/apps/docs/content/components/accordion/examples.mdx",
      "purpose": "Single-open accordion with bottom borders. The classic FAQ pattern.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/accordion/examples"
    },
    {
      "title": "Accordion",
      "url": "/components/accordion/usage",
      "source": "src/apps/docs/content/components/accordion/usage.mdx",
      "purpose": "Vertically stacked collapsible sections for organizing content into expandable/collapsible panels.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/accordion/usage"
    },
    {
      "title": "AlertDialog accessibility",
      "url": "/components/alert-dialog/accessibility",
      "source": "src/apps/docs/content/components/alert-dialog/accessibility.mdx",
      "purpose": "AlertDialog accessibility component documentation.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/alert-dialog/accessibility"
    },
    {
      "title": "Examples",
      "url": "/components/alert-dialog/examples",
      "source": "src/apps/docs/content/components/alert-dialog/examples.mdx",
      "purpose": "",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/alert-dialog/examples"
    },
    {
      "title": "AlertDialog",
      "url": "/components/alert-dialog/usage",
      "source": "src/apps/docs/content/components/alert-dialog/usage.mdx",
      "purpose": "A modal dialog that interrupts the user with important content and expects a response. Unlike Dialog, AlertDialog does NOT dismiss on backdrop click or Escape — the user must explicitly choose an action.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/alert-dialog/usage"
    },
    {
      "title": "Alert accessibility",
      "url": "/components/alert/accessibility",
      "source": "src/apps/docs/content/components/alert/accessibility.mdx",
      "purpose": "Alert must satisfy these before shipping.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/alert/accessibility"
    },
    {
      "title": "Examples",
      "url": "/components/alert/examples",
      "source": "src/apps/docs/content/components/alert/examples.mdx",
      "purpose": "",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/alert/examples"
    },
    {
      "title": "Alert",
      "url": "/components/alert/usage",
      "source": "src/apps/docs/content/components/alert/usage.mdx",
      "purpose": "Inline message banner for communicating status, warnings, or errors to the user.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/alert/usage"
    },
    {
      "title": "AspectRatio -- Accessibility",
      "url": "/components/aspect-ratio/accessibility",
      "source": "src/apps/docs/content/components/aspect-ratio/accessibility.mdx",
      "purpose": "`AspectRatio` is a purely visual layout utility. It enforces a width-to-height",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/aspect-ratio/accessibility"
    },
    {
      "title": "Examples",
      "url": "/components/aspect-ratio/examples",
      "source": "src/apps/docs/content/components/aspect-ratio/examples.mdx",
      "purpose": "A 16:9 wrapper for photos and hero images. The child fills the entire container.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/aspect-ratio/examples"
    },
    {
      "title": "Usage",
      "url": "/components/aspect-ratio/usage",
      "source": "src/apps/docs/content/components/aspect-ratio/usage.mdx",
      "purpose": "Usage component documentation.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/aspect-ratio/usage"
    },
    {
      "title": "AvatarGroup accessibility",
      "url": "/components/avatar-group/accessibility",
      "source": "src/apps/docs/content/components/avatar-group/accessibility.mdx",
      "purpose": "AvatarGroup accessibility component documentation.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/avatar-group/accessibility"
    },
    {
      "title": "Examples",
      "url": "/components/avatar-group/examples",
      "source": "src/apps/docs/content/components/avatar-group/examples.mdx",
      "purpose": "Avatars stack with a negative margin overlap. Pass `max` to cap the visible count.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/avatar-group/examples"
    },
    {
      "title": "AvatarGroup",
      "url": "/components/avatar-group/usage",
      "source": "src/apps/docs/content/components/avatar-group/usage.mdx",
      "purpose": "Stacked, overlapping row of Avatar components with an overflow \"+N\" count badge. Shows at most `max` avatars, then a counter for the rest.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/avatar-group/usage"
    },
    {
      "title": "Avatar accessibility",
      "url": "/components/avatar/accessibility",
      "source": "src/apps/docs/content/components/avatar/accessibility.mdx",
      "purpose": "Avatar accessibility component documentation.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/avatar/accessibility"
    },
    {
      "title": "Examples",
      "url": "/components/avatar/examples",
      "source": "src/apps/docs/content/components/avatar/examples.mdx",
      "purpose": "",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/avatar/examples"
    },
    {
      "title": "Avatar",
      "url": "/components/avatar/usage",
      "source": "src/apps/docs/content/components/avatar/usage.mdx",
      "purpose": "A composable user or entity portrait with automatic image-to-fallback handling.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/avatar/usage"
    },
    {
      "title": "Badge accessibility",
      "url": "/components/badge/accessibility",
      "source": "src/apps/docs/content/components/badge/accessibility.mdx",
      "purpose": "Badge accessibility component documentation.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/badge/accessibility"
    },
    {
      "title": "Examples",
      "url": "/components/badge/examples",
      "source": "src/apps/docs/content/components/badge/examples.mdx",
      "purpose": "Release feed, environment status board, capability tags on a profile, and removable filter tokens.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/badge/examples"
    },
    {
      "title": "Badge",
      "url": "/components/badge/usage",
      "source": "src/apps/docs/content/components/badge/usage.mdx",
      "purpose": "A small status or labelling pill that composes inline with text.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/badge/usage"
    },
    {
      "title": "Banner accessibility",
      "url": "/components/banner/accessibility",
      "source": "src/apps/docs/content/components/banner/accessibility.mdx",
      "purpose": "Banner accessibility component documentation.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/banner/accessibility"
    },
    {
      "title": "Examples",
      "url": "/components/banner/examples",
      "source": "src/apps/docs/content/components/banner/examples.mdx",
      "purpose": "",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/banner/examples"
    },
    {
      "title": "Banner",
      "url": "/components/banner/usage",
      "source": "src/apps/docs/content/components/banner/usage.mdx",
      "purpose": "Full-width message strip at the top of a page or section. Optionally dismissible.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/banner/usage"
    },
    {
      "title": "Breadcrumb accessibility",
      "url": "/components/breadcrumb/accessibility",
      "source": "src/apps/docs/content/components/breadcrumb/accessibility.mdx",
      "purpose": "Breadcrumb accessibility component documentation.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/breadcrumb/accessibility"
    },
    {
      "title": "Examples",
      "url": "/components/breadcrumb/examples",
      "source": "src/apps/docs/content/components/breadcrumb/examples.mdx",
      "purpose": "",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/breadcrumb/examples"
    },
    {
      "title": "Breadcrumb",
      "url": "/components/breadcrumb/usage",
      "source": "src/apps/docs/content/components/breadcrumb/usage.mdx",
      "purpose": "A navigation trail showing the user's position in a page hierarchy. Composable sub-components let you build simple or complex breadcrumbs with separators, ellipsis for overflow, and current-page indicators.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/breadcrumb/usage"
    },
    {
      "title": "Accessibility",
      "url": "/components/button/accessibility",
      "source": "src/apps/docs/content/components/button/accessibility.mdx",
      "purpose": "Button must satisfy these on every render before it ships.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/button/accessibility"
    },
    {
      "title": "Examples",
      "url": "/components/button/examples",
      "source": "src/apps/docs/content/components/button/examples.mdx",
      "purpose": "A realistic showcase — page-header CTAs, form actions, semantic tonal overrides, and a hard-edge toolbar with the loading state.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/button/examples"
    },
    {
      "title": "Usage",
      "url": "/components/button/usage",
      "source": "src/apps/docs/content/components/button/usage.mdx",
      "purpose": "Usage component documentation.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/button/usage"
    },
    {
      "title": "Accessibility",
      "url": "/components/calendar/accessibility",
      "source": "src/apps/docs/content/components/calendar/accessibility.mdx",
      "purpose": "Calendar must satisfy these on every render before it ships.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/calendar/accessibility"
    },
    {
      "title": "Examples",
      "url": "/components/calendar/examples",
      "source": "src/apps/docs/content/components/calendar/examples.mdx",
      "purpose": "",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/calendar/examples"
    },
    {
      "title": "Usage",
      "url": "/components/calendar/usage",
      "source": "src/apps/docs/content/components/calendar/usage.mdx",
      "purpose": "Calendar is now powered by `@daypicker/react` v10. The MiHCM wrapper does not hide DayPicker capabilities; it forwards the full v10 `DayPicker` prop surface and only adds tokenized default class names, larger targets, an",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/calendar/usage"
    },
    {
      "title": "Card accessibility",
      "url": "/components/card/accessibility",
      "source": "src/apps/docs/content/components/card/accessibility.mdx",
      "purpose": "Card accessibility component documentation.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/card/accessibility"
    },
    {
      "title": "Examples",
      "url": "/components/card/examples",
      "source": "src/apps/docs/content/components/card/examples.mdx",
      "purpose": "",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/card/examples"
    },
    {
      "title": "Card",
      "url": "/components/card/usage",
      "source": "src/apps/docs/content/components/card/usage.mdx",
      "purpose": "A composable container surface for grouping related content and actions.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/card/usage"
    },
    {
      "title": "Accessibility",
      "url": "/components/carousel/accessibility",
      "source": "src/apps/docs/content/components/carousel/accessibility.mdx",
      "purpose": "Carousel must satisfy these on every render before it ships.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/carousel/accessibility"
    },
    {
      "title": "Examples",
      "url": "/components/carousel/examples",
      "source": "src/apps/docs/content/components/carousel/examples.mdx",
      "purpose": "Horizontal carousel with previous/next controls and 5 slides.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/carousel/examples"
    },
    {
      "title": "Carousel",
      "url": "/components/carousel/usage",
      "source": "src/apps/docs/content/components/carousel/usage.mdx",
      "purpose": "A slideshow component for cycling through a series of content panels with previous/next controls.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/carousel/usage"
    },
    {
      "title": "Accessibility",
      "url": "/components/chart/accessibility",
      "source": "src/apps/docs/content/components/chart/accessibility.mdx",
      "purpose": "Chart must satisfy these on every render before it ships.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/chart/accessibility"
    },
    {
      "title": "Examples",
      "url": "/components/chart/examples",
      "source": "src/apps/docs/content/components/chart/examples.mdx",
      "purpose": "A grouped bar chart showing desktop vs mobile visitors by month.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/chart/examples"
    },
    {
      "title": "Chart",
      "url": "/components/chart/usage",
      "source": "src/apps/docs/content/components/chart/usage.mdx",
      "purpose": "A composable charting wrapper built on Recharts with themed colors, accessible tooltips, and a legend system.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/chart/usage"
    },
    {
      "title": "Accessibility",
      "url": "/components/checkbox-grid/accessibility",
      "source": "src/apps/docs/content/components/checkbox-grid/accessibility.mdx",
      "purpose": "Accessibility component documentation.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/checkbox-grid/accessibility"
    },
    {
      "title": "Examples",
      "url": "/components/checkbox-grid/examples",
      "source": "src/apps/docs/content/components/checkbox-grid/examples.mdx",
      "purpose": "Permissions matrix, plan features comparison, supported-locale picker, and a single-column channel list.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/checkbox-grid/examples"
    },
    {
      "title": "Usage",
      "url": "/components/checkbox-grid/usage",
      "source": "src/apps/docs/content/components/checkbox-grid/usage.mdx",
      "purpose": "**Web**: multi-column grid with view tabs (All/Selected/Unselected).",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/checkbox-grid/usage"
    },
    {
      "title": "Checkbox accessibility",
      "url": "/components/checkbox/accessibility",
      "source": "src/apps/docs/content/components/checkbox/accessibility.mdx",
      "purpose": "Standard browser behaviour for `` — no custom key handling needed.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/checkbox/accessibility"
    },
    {
      "title": "Examples",
      "url": "/components/checkbox/examples",
      "source": "src/apps/docs/content/components/checkbox/examples.mdx",
      "purpose": "Four realistic surfaces — task list with strikethrough completion, terms-of-service gate, faceted filter list, and table row selection with indeterminate \"select all\".",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/checkbox/examples"
    },
    {
      "title": "Checkbox",
      "url": "/components/checkbox/usage",
      "source": "src/apps/docs/content/components/checkbox/usage.mdx",
      "purpose": "A controlled checkbox supporting checked, unchecked, and indeterminate states.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/checkbox/usage"
    },
    {
      "title": "Accessibility",
      "url": "/components/collapsible/accessibility",
      "source": "src/apps/docs/content/components/collapsible/accessibility.mdx",
      "purpose": "Collapsible must satisfy these on every render before it ships.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/collapsible/accessibility"
    },
    {
      "title": "Examples",
      "url": "/components/collapsible/examples",
      "source": "src/apps/docs/content/components/collapsible/examples.mdx",
      "purpose": "",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/collapsible/examples"
    },
    {
      "title": "Usage",
      "url": "/components/collapsible/usage",
      "source": "src/apps/docs/content/components/collapsible/usage.mdx",
      "purpose": "",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/collapsible/usage"
    },
    {
      "title": "Combobox -- Accessibility",
      "url": "/components/combobox/accessibility",
      "source": "src/apps/docs/content/components/combobox/accessibility.mdx",
      "purpose": "When the dropdown is closed, focus remains on the trigger so the user can tab to the next form control normally.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/combobox/accessibility"
    },
    {
      "title": "Examples",
      "url": "/components/combobox/examples",
      "source": "src/apps/docs/content/components/combobox/examples.mdx",
      "purpose": "Employee finder, country search across a long list, timezone picker, and a support-ticket router that adapts routing based on the chosen category.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/combobox/examples"
    },
    {
      "title": "Combobox",
      "url": "/components/combobox/usage",
      "source": "src/apps/docs/content/components/combobox/usage.mdx",
      "purpose": "Autocomplete search input that combines a text field with a filterable dropdown list.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/combobox/usage"
    },
    {
      "title": "Accessibility",
      "url": "/components/command/accessibility",
      "source": "src/apps/docs/content/components/command/accessibility.mdx",
      "purpose": "Command must satisfy these on every render before it ships.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/command/accessibility"
    },
    {
      "title": "Examples",
      "url": "/components/command/examples",
      "source": "src/apps/docs/content/components/command/examples.mdx",
      "purpose": "Embed a searchable, grouped list directly in the page.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/command/examples"
    },
    {
      "title": "Usage",
      "url": "/components/command/usage",
      "source": "src/apps/docs/content/components/command/usage.mdx",
      "purpose": "",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/command/usage"
    },
    {
      "title": "ContextMenu -- Accessibility",
      "url": "/components/context-menu/accessibility",
      "source": "src/apps/docs/content/components/context-menu/accessibility.mdx",
      "purpose": "ContextMenu -- Accessibility component documentation.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/context-menu/accessibility"
    },
    {
      "title": "Examples",
      "url": "/components/context-menu/examples",
      "source": "src/apps/docs/content/components/context-menu/examples.mdx",
      "purpose": "",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/context-menu/examples"
    },
    {
      "title": "ContextMenu",
      "url": "/components/context-menu/usage",
      "source": "src/apps/docs/content/components/context-menu/usage.mdx",
      "purpose": "Right-click context menu powered by Radix. Shares visual styling with DropdownMenu for consistency.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/context-menu/usage"
    },
    {
      "title": "DataTable accessibility",
      "url": "/components/data-table/accessibility",
      "source": "src/apps/docs/content/components/data-table/accessibility.mdx",
      "purpose": "DataTable accessibility component documentation.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/data-table/accessibility"
    },
    {
      "title": "Examples",
      "url": "/components/data-table/examples",
      "source": "src/apps/docs/content/components/data-table/examples.mdx",
      "purpose": "Click any column header to cycle through ascending, descending, and unsorted states.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/data-table/examples"
    },
    {
      "title": "DataTable",
      "url": "/components/data-table/usage",
      "source": "src/apps/docs/content/components/data-table/usage.mdx",
      "purpose": "Full-featured data table powered by TanStack Table v8, rendered with MiHCM Table primitives. Sorting, filtering, pagination, row selection, column visibility, expandable rows, column resizing, column/row pinning, groupin",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/data-table/usage"
    },
    {
      "title": "Accessibility",
      "url": "/components/date-picker/accessibility",
      "source": "src/apps/docs/content/components/date-picker/accessibility.mdx",
      "purpose": "DatePicker must satisfy these on every render before it ships.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/date-picker/accessibility"
    },
    {
      "title": "Examples",
      "url": "/components/date-picker/examples",
      "source": "src/apps/docs/content/components/date-picker/examples.mdx",
      "purpose": "Time-off single date, two-month reporting range, schedule sync with time-of-day, and a full-width form-field date with disabled-past constraint.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/date-picker/examples"
    },
    {
      "title": "Usage",
      "url": "/components/date-picker/usage",
      "source": "src/apps/docs/content/components/date-picker/usage.mdx",
      "purpose": "DatePicker now uses the same `@daypicker/react` v10 engine as `Calendar`. This keeps date, date range, date-time, and time-only UI on one dependency and one styling model.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/date-picker/usage"
    },
    {
      "title": "Accessibility",
      "url": "/components/dialog/accessibility",
      "source": "src/apps/docs/content/components/dialog/accessibility.mdx",
      "purpose": "Accessibility component documentation.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/dialog/accessibility"
    },
    {
      "title": "Examples",
      "url": "/components/dialog/examples",
      "source": "src/apps/docs/content/components/dialog/examples.mdx",
      "purpose": "",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/dialog/examples"
    },
    {
      "title": "Dialog",
      "url": "/components/dialog/usage",
      "source": "src/apps/docs/content/components/dialog/usage.mdx",
      "purpose": "Accessible modal dialog for focused interactions that require user attention.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/dialog/usage"
    },
    {
      "title": "Drawer -- Accessibility",
      "url": "/components/drawer/accessibility",
      "source": "src/apps/docs/content/components/drawer/accessibility.mdx",
      "purpose": "When the drawer is open, focus is trapped within its content. Pressing `Tab` on the last focusable element wraps focus back to the first, and `Shift+Tab` on the first element wraps to the last. Focus never escapes to the",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/drawer/accessibility"
    },
    {
      "title": "Examples",
      "url": "/components/drawer/examples",
      "source": "src/apps/docs/content/components/drawer/examples.mdx",
      "purpose": "",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/drawer/examples"
    },
    {
      "title": "Drawer",
      "url": "/components/drawer/usage",
      "source": "src/apps/docs/content/components/drawer/usage.mdx",
      "purpose": "A mobile-friendly bottom sheet / drawer with swipe-to-dismiss. Touch-optimised with spring physics.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/drawer/usage"
    },
    {
      "title": "DropdownMenu accessibility",
      "url": "/components/dropdown-menu/accessibility",
      "source": "src/apps/docs/content/components/dropdown-menu/accessibility.mdx",
      "purpose": "DropdownMenu accessibility component documentation.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/dropdown-menu/accessibility"
    },
    {
      "title": "Examples",
      "url": "/components/dropdown-menu/examples",
      "source": "src/apps/docs/content/components/dropdown-menu/examples.mdx",
      "purpose": "",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/dropdown-menu/examples"
    },
    {
      "title": "DropdownMenu",
      "url": "/components/dropdown-menu/usage",
      "source": "src/apps/docs/content/components/dropdown-menu/usage.mdx",
      "purpose": "A menu of actions triggered by a button click. Composable sub-components for maximum flexibility.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/dropdown-menu/usage"
    },
    {
      "title": "EmptyState accessibility",
      "url": "/components/empty-state/accessibility",
      "source": "src/apps/docs/content/components/empty-state/accessibility.mdx",
      "purpose": "EmptyState accessibility component documentation.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/empty-state/accessibility"
    },
    {
      "title": "Examples",
      "url": "/components/empty-state/examples",
      "source": "src/apps/docs/content/components/empty-state/examples.mdx",
      "purpose": "",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/empty-state/examples"
    },
    {
      "title": "EmptyState",
      "url": "/components/empty-state/usage",
      "source": "src/apps/docs/content/components/empty-state/usage.mdx",
      "purpose": "Placeholder shown when a section, list, or table has no data to display. Centered layout with optional icon, title, description, and action button.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/empty-state/usage"
    },
    {
      "title": "Accessibility",
      "url": "/components/form/accessibility",
      "source": "src/apps/docs/content/components/form/accessibility.mdx",
      "purpose": "Form fields satisfy these accessibility requirements out of the box.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/form/accessibility"
    },
    {
      "title": "Examples",
      "url": "/components/form/examples",
      "source": "src/apps/docs/content/components/form/examples.mdx",
      "purpose": "Email and password with `onChange` validation. Submit is disabled while the form is invalid using `form.Subscribe`.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/form/examples"
    },
    {
      "title": "Usage",
      "url": "/components/form/usage",
      "source": "src/apps/docs/content/components/form/usage.mdx",
      "purpose": "Form uses TanStack Form. Keep MiHCM form documentation, examples, and agent rules on this path; do not introduce React Hook Form for the design-system form layer.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/form/usage"
    },
    {
      "title": "Accessibility",
      "url": "/components/hover-card/accessibility",
      "source": "src/apps/docs/content/components/hover-card/accessibility.mdx",
      "purpose": "HoverCard must satisfy these on every render before it ships.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/hover-card/accessibility"
    },
    {
      "title": "Examples",
      "url": "/components/hover-card/examples",
      "source": "src/apps/docs/content/components/hover-card/examples.mdx",
      "purpose": "",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/hover-card/examples"
    },
    {
      "title": "Usage",
      "url": "/components/hover-card/usage",
      "source": "src/apps/docs/content/components/hover-card/usage.mdx",
      "purpose": "",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/hover-card/usage"
    },
    {
      "title": "Accessibility",
      "url": "/components/icon-sidebar/accessibility",
      "source": "src/apps/docs/content/components/icon-sidebar/accessibility.mdx",
      "purpose": "Accessibility component documentation.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/icon-sidebar/accessibility"
    },
    {
      "title": "Examples",
      "url": "/components/icon-sidebar/examples",
      "source": "src/apps/docs/content/components/icon-sidebar/examples.mdx",
      "purpose": "Five interaction models share the same `MainSidebarItem` tree. Pick the one that matches your shell — `drilldown` for classic app navigation, `floating` to keep content under the panel, `columns` for spatial drill-down p",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/icon-sidebar/examples"
    },
    {
      "title": "Usage",
      "url": "/components/icon-sidebar/usage",
      "source": "src/apps/docs/content/components/icon-sidebar/usage.mdx",
      "purpose": "The same `MainSidebar` renders any of five interaction models via the `variant` prop:",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/icon-sidebar/usage"
    },
    {
      "title": "InputOTP -- Accessibility",
      "url": "/components/input-otp/accessibility",
      "source": "src/apps/docs/content/components/input-otp/accessibility.mdx",
      "purpose": "By default the component only accepts numeric digits (`0-9`). If the `pattern` prop is set to a custom regex, matching characters are accepted instead.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/input-otp/accessibility"
    },
    {
      "title": "Examples",
      "url": "/components/input-otp/examples",
      "source": "src/apps/docs/content/components/input-otp/examples.mdx",
      "purpose": "Two-factor authentication code, phone verification with expiry badge, account-recovery backup code, and a long license-key entry split across five groups.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/input-otp/examples"
    },
    {
      "title": "InputOTP",
      "url": "/components/input-otp/usage",
      "source": "src/apps/docs/content/components/input-otp/usage.mdx",
      "purpose": "One-time password / verification code input with individual character slots.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/input-otp/usage"
    },
    {
      "title": "Accessibility",
      "url": "/components/input/accessibility",
      "source": "src/apps/docs/content/components/input/accessibility.mdx",
      "purpose": "Input must satisfy these on every render before it ships.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/input/accessibility"
    },
    {
      "title": "Examples",
      "url": "/components/input/examples",
      "source": "src/apps/docs/content/components/input/examples.mdx",
      "purpose": "Realistic compositions — sign-in, filter bar, profile editor with live invalid state, and a tokenized payment form.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/input/examples"
    },
    {
      "title": "Usage",
      "url": "/components/input/usage",
      "source": "src/apps/docs/content/components/input/usage.mdx",
      "purpose": "The component is a styled wrapper around the platform input. The wrapper owns the border, padding, and focus ring; the input is transparent and inherits the wrapper's text color so leading/trailing icons compose cleanly.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/input/usage"
    },
    {
      "title": "Label accessibility",
      "url": "/components/label/accessibility",
      "source": "src/apps/docs/content/components/label/accessibility.mdx",
      "purpose": "Label accessibility component documentation.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/label/accessibility"
    },
    {
      "title": "Examples",
      "url": "/components/label/examples",
      "source": "src/apps/docs/content/components/label/examples.mdx",
      "purpose": "Required + helper text, switch-style settings rows, radio choice list, and a checkbox preference grid — every control wired by `htmlFor`.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/label/examples"
    },
    {
      "title": "Label",
      "url": "/components/label/usage",
      "source": "src/apps/docs/content/components/label/usage.mdx",
      "purpose": "A form label that pairs with inputs, checkboxes, and switches for accessible field naming.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/label/usage"
    },
    {
      "title": "Accessibility",
      "url": "/components/link/accessibility",
      "source": "src/apps/docs/content/components/link/accessibility.mdx",
      "purpose": "Accessibility component documentation.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/link/accessibility"
    },
    {
      "title": "Examples",
      "url": "/components/link/examples",
      "source": "src/apps/docs/content/components/link/examples.mdx",
      "purpose": "Examples show semantic navigation links across prose, navigation, standalone actions, and external destinations.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/link/examples"
    },
    {
      "title": "Usage",
      "url": "/components/link/usage",
      "source": "src/apps/docs/content/components/link/usage.mdx",
      "purpose": "Usage component documentation.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/link/usage"
    },
    {
      "title": "Accessibility",
      "url": "/components/logo/accessibility",
      "source": "src/apps/docs/content/components/logo/accessibility.mdx",
      "purpose": "Accessibility component documentation.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/logo/accessibility"
    },
    {
      "title": "Examples",
      "url": "/components/logo/examples",
      "source": "src/apps/docs/content/components/logo/examples.mdx",
      "purpose": "",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/logo/examples"
    },
    {
      "title": "Usage",
      "url": "/components/logo/usage",
      "source": "src/apps/docs/content/components/logo/usage.mdx",
      "purpose": "> **Approved-asset only.** Earlier versions shipped an inline SVG fallback that drifted from the brand-team source. `Logo` now defaults `brand` to `'mihcm'` and renders the approved `/brand/logos/mihcm-primary.svg` direc",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/logo/usage"
    },
    {
      "title": "Accessibility",
      "url": "/components/menubar/accessibility",
      "source": "src/apps/docs/content/components/menubar/accessibility.mdx",
      "purpose": "Menubar must satisfy these on every render before it ships.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/menubar/accessibility"
    },
    {
      "title": "Examples",
      "url": "/components/menubar/examples",
      "source": "src/apps/docs/content/components/menubar/examples.mdx",
      "purpose": "A full menu bar with File, Edit, and View menus including keyboard shortcuts.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/menubar/examples"
    },
    {
      "title": "Menubar",
      "url": "/components/menubar/usage",
      "source": "src/apps/docs/content/components/menubar/usage.mdx",
      "purpose": "A horizontal menu bar with dropdown menus, modeled after desktop application menu bars.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/menubar/usage"
    },
    {
      "title": "NavigationMenu -- Accessibility",
      "url": "/components/navigation-menu/accessibility",
      "source": "src/apps/docs/content/components/navigation-menu/accessibility.mdx",
      "purpose": "implicit `role=\"navigation\"` landmark.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/navigation-menu/accessibility"
    },
    {
      "title": "Platform",
      "url": "/components/navigation-menu/examples",
      "source": "src/apps/docs/content/components/navigation-menu/examples.mdx",
      "purpose": "A flat navigation bar with no dropdowns. Apply `navigationMenuTriggerStyle()` to",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/navigation-menu/examples"
    },
    {
      "title": "NavigationMenu",
      "url": "/components/navigation-menu/usage",
      "source": "src/apps/docs/content/components/navigation-menu/usage.mdx",
      "purpose": "Top-level site navigation bar with dropdown mega-menus. Powered by Radix.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/navigation-menu/usage"
    },
    {
      "title": "Accessibility",
      "url": "/components/notification-badge/accessibility",
      "source": "src/apps/docs/content/components/notification-badge/accessibility.mdx",
      "purpose": "The badge has no transitions; nothing to honour beyond the system default.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/notification-badge/accessibility"
    },
    {
      "title": "Examples",
      "url": "/components/notification-badge/examples",
      "source": "src/apps/docs/content/components/notification-badge/examples.mdx",
      "purpose": "",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/notification-badge/examples"
    },
    {
      "title": "Usage",
      "url": "/components/notification-badge/usage",
      "source": "src/apps/docs/content/components/notification-badge/usage.mdx",
      "purpose": "The badge **absolutely-positions itself** in the chosen corner of its parent. The parent **must** be `position: relative` (web) or a wrapping `` (native):",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/notification-badge/usage"
    },
    {
      "title": "Accessibility",
      "url": "/components/org-selector/accessibility",
      "source": "src/apps/docs/content/components/org-selector/accessibility.mdx",
      "purpose": "OrgSelector implements the [WAI-ARIA Authoring Practices TreeView pattern](https://www.w3.org/WAI/ARIA/apg/patterns/treeview/). All trees expose the standard tree semantics regardless of variant.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/org-selector/accessibility"
    },
    {
      "title": "Examples",
      "url": "/components/org-selector/examples",
      "source": "src/apps/docs/content/components/org-selector/examples.mdx",
      "purpose": "The most common HR form-field shape — one node, popover trigger.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/org-selector/examples"
    },
    {
      "title": "Usage",
      "url": "/components/org-selector/usage",
      "source": "src/apps/docs/content/components/org-selector/usage.mdx",
      "purpose": "How the closed trigger renders the current selection.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/org-selector/usage"
    },
    {
      "title": "Accessibility",
      "url": "/components/page-shell/accessibility",
      "source": "src/apps/docs/content/components/page-shell/accessibility.mdx",
      "purpose": "",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/page-shell/accessibility"
    },
    {
      "title": "Examples",
      "url": "/components/page-shell/examples",
      "source": "src/apps/docs/content/components/page-shell/examples.mdx",
      "purpose": "",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/page-shell/examples"
    },
    {
      "title": "Usage",
      "url": "/components/page-shell/usage",
      "source": "src/apps/docs/content/components/page-shell/usage.mdx",
      "purpose": "**Web**: three-region scaffold with desktop sidebar column, mobile bottom-menu anchor, sticky title bar, internal scroll.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/page-shell/usage"
    },
    {
      "title": "Accessibility",
      "url": "/components/pagination/accessibility",
      "source": "src/apps/docs/content/components/pagination/accessibility.mdx",
      "purpose": "Accessibility component documentation.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/pagination/accessibility"
    },
    {
      "title": "Examples",
      "url": "/components/pagination/examples",
      "source": "src/apps/docs/content/components/pagination/examples.mdx",
      "purpose": "A standard pagination with 10 pages, the 5th page marked as active.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/pagination/examples"
    },
    {
      "title": "Pagination",
      "url": "/components/pagination/usage",
      "source": "src/apps/docs/content/components/pagination/usage.mdx",
      "purpose": "Page navigation with numbered links and previous/next buttons. Composable sub-components let you build simple or complex page navigators.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/pagination/usage"
    },
    {
      "title": "Accessibility",
      "url": "/components/popover/accessibility",
      "source": "src/apps/docs/content/components/popover/accessibility.mdx",
      "purpose": "Accessibility component documentation.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/popover/accessibility"
    },
    {
      "title": "Examples",
      "url": "/components/popover/examples",
      "source": "src/apps/docs/content/components/popover/examples.mdx",
      "purpose": "A common pattern: anchor a filter form to a toolbar button. Use `size=\"lg\"` for multi-field layouts.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/popover/examples"
    },
    {
      "title": "Usage",
      "url": "/components/popover/usage",
      "source": "src/apps/docs/content/components/popover/usage.mdx",
      "purpose": "Usage component documentation.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/popover/usage"
    },
    {
      "title": "Accessibility",
      "url": "/components/popper/accessibility",
      "source": "src/apps/docs/content/components/popper/accessibility.mdx",
      "purpose": "Popper is a positioning primitive. It handles geometry, not complete widget semantics.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/popper/accessibility"
    },
    {
      "title": "Examples",
      "url": "/components/popper/examples",
      "source": "src/apps/docs/content/components/popper/examples.mdx",
      "purpose": "Use Popper when the layer needs low-level positioning control.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/popper/examples"
    },
    {
      "title": "Usage",
      "url": "/components/popper/usage",
      "source": "src/apps/docs/content/components/popper/usage.mdx",
      "purpose": "`Popper` uses the official Popper v2 React integration:",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/popper/usage"
    },
    {
      "title": "Progress accessibility",
      "url": "/components/progress/accessibility",
      "source": "src/apps/docs/content/components/progress/accessibility.mdx",
      "purpose": "Progress accessibility component documentation.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/progress/accessibility"
    },
    {
      "title": "Examples",
      "url": "/components/progress/examples",
      "source": "src/apps/docs/content/components/progress/examples.mdx",
      "purpose": "Pass a `value` (0-100) for a fixed progress bar. The fill tracks the percentage.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/progress/examples"
    },
    {
      "title": "Usage",
      "url": "/components/progress/usage",
      "source": "src/apps/docs/content/components/progress/usage.mdx",
      "purpose": "Progress uses the fixed `primary` brand tone by default. Use `segmented` only when progress communicates health, risk, or completion bands. The fill transitions width and tone together so range changes fade smoothly:",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/progress/usage"
    },
    {
      "title": "RadioGroup accessibility",
      "url": "/components/radio-group/accessibility",
      "source": "src/apps/docs/content/components/radio-group/accessibility.mdx",
      "purpose": "RadioGroup accessibility component documentation.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/radio-group/accessibility"
    },
    {
      "title": "Examples",
      "url": "/components/radio-group/examples",
      "source": "src/apps/docs/content/components/radio-group/examples.mdx",
      "purpose": "Billing cadence with card-shaped rows, sprint feedback 1–5, role tier picker with helper text, and an equipment shipping selector.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/radio-group/examples"
    },
    {
      "title": "RadioGroup",
      "url": "/components/radio-group/usage",
      "source": "src/apps/docs/content/components/radio-group/usage.mdx",
      "purpose": "Mutually exclusive option selection. Renders a `fieldset` with `role=\"radiogroup\"` and individual `RadioGroupItem` buttons with `role=\"radio\"`.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/radio-group/usage"
    },
    {
      "title": "Resizable — Accessibility",
      "url": "/components/resizable/accessibility",
      "source": "src/apps/docs/content/components/resizable/accessibility.mdx",
      "purpose": "All arrow-key interactions respect `minSize` and `maxSize` constraints, so users",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/resizable/accessibility"
    },
    {
      "title": "Examples",
      "url": "/components/resizable/examples",
      "source": "src/apps/docs/content/components/resizable/examples.mdx",
      "purpose": "",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/resizable/examples"
    },
    {
      "title": "Resizable",
      "url": "/components/resizable/usage",
      "source": "src/apps/docs/content/components/resizable/usage.mdx",
      "purpose": "Resizable panel layout with draggable dividers for split-pane interfaces.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/resizable/usage"
    },
    {
      "title": "RichTextEditor accessibility",
      "url": "/components/rich-text-editor/accessibility",
      "source": "src/apps/docs/content/components/rich-text-editor/accessibility.mdx",
      "purpose": "RichTextEditor accessibility component documentation.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/rich-text-editor/accessibility"
    },
    {
      "title": "Examples",
      "url": "/components/rich-text-editor/examples",
      "source": "src/apps/docs/content/components/rich-text-editor/examples.mdx",
      "purpose": "",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/rich-text-editor/examples"
    },
    {
      "title": "RichTextEditor",
      "url": "/components/rich-text-editor/usage",
      "source": "src/apps/docs/content/components/rich-text-editor/usage.mdx",
      "purpose": "Lexical-powered rich text editor with four progressive toolbar variants. Web only — native apps should use a platform-specific editor.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/rich-text-editor/usage"
    },
    {
      "title": "Accessibility",
      "url": "/components/scroll-area/accessibility",
      "source": "src/apps/docs/content/components/scroll-area/accessibility.mdx",
      "purpose": "ScrollArea must satisfy these on every render before it ships.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/scroll-area/accessibility"
    },
    {
      "title": "Examples",
      "url": "/components/scroll-area/examples",
      "source": "src/apps/docs/content/components/scroll-area/examples.mdx",
      "purpose": "A fixed-height list with thin scrollbar.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/scroll-area/examples"
    },
    {
      "title": "Usage",
      "url": "/components/scroll-area/usage",
      "source": "src/apps/docs/content/components/scroll-area/usage.mdx",
      "purpose": "ScrollArea accepts all standard Radix ScrollArea root props plus `className` and `children`.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/scroll-area/usage"
    },
    {
      "title": "Accessibility",
      "url": "/components/search-field/accessibility",
      "source": "src/apps/docs/content/components/search-field/accessibility.mdx",
      "purpose": "No transitions on the field itself. Animation that depends on search results (popover open/close) lives in the host.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/search-field/accessibility"
    },
    {
      "title": "Examples",
      "url": "/components/search-field/examples",
      "source": "src/apps/docs/content/components/search-field/examples.mdx",
      "purpose": "Large workspace search with shortcut hint, live directory filter, help-center scoped search, and a `noClear` command bar.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/search-field/examples"
    },
    {
      "title": "Usage",
      "url": "/components/search-field/usage",
      "source": "src/apps/docs/content/components/search-field/usage.mdx",
      "purpose": "`SearchField` is intentionally controlled — you own the value:",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/search-field/usage"
    },
    {
      "title": "Accessibility",
      "url": "/components/section-header/accessibility",
      "source": "src/apps/docs/content/components/section-header/accessibility.mdx",
      "purpose": "Accessibility component documentation.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/section-header/accessibility"
    },
    {
      "title": "Examples",
      "url": "/components/section-header/examples",
      "source": "src/apps/docs/content/components/section-header/examples.mdx",
      "purpose": "",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/section-header/examples"
    },
    {
      "title": "Usage",
      "url": "/components/section-header/usage",
      "source": "src/apps/docs/content/components/section-header/usage.mdx",
      "purpose": "The component intentionally renders a ``, not a heading element — it doesn't know what level fits your page outline. If heading semantics matter (most cases), pass an `` / `` as the `title`:",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/section-header/usage"
    },
    {
      "title": "Select accessibility",
      "url": "/components/select/accessibility",
      "source": "src/apps/docs/content/components/select/accessibility.mdx",
      "purpose": "Select accessibility component documentation.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/select/accessibility"
    },
    {
      "title": "Examples",
      "url": "/components/select/examples",
      "source": "src/apps/docs/content/components/select/examples.mdx",
      "purpose": "Workspace region picker, inline sort selector, role assignment with destructive tone option, and a grouped tech-stack picker with section labels and separators.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/select/examples"
    },
    {
      "title": "Select",
      "url": "/components/select/usage",
      "source": "src/apps/docs/content/components/select/usage.mdx",
      "purpose": "Select supports two APIs:",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/select/usage"
    },
    {
      "title": "Separator accessibility",
      "url": "/components/separator/accessibility",
      "source": "src/apps/docs/content/components/separator/accessibility.mdx",
      "purpose": "In most cases (card sections, menu items, toolbar groups), `decorative=true` is correct.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/separator/accessibility"
    },
    {
      "title": "Examples",
      "url": "/components/separator/examples",
      "source": "src/apps/docs/content/components/separator/examples.mdx",
      "purpose": "",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/separator/examples"
    },
    {
      "title": "Separator",
      "url": "/components/separator/usage",
      "source": "src/apps/docs/content/components/separator/usage.mdx",
      "purpose": "A visual divider between sections of content. Supports horizontal and vertical orientations.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/separator/usage"
    },
    {
      "title": "Accessibility",
      "url": "/components/sheet/accessibility",
      "source": "src/apps/docs/content/components/sheet/accessibility.mdx",
      "purpose": "Accessibility component documentation.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/sheet/accessibility"
    },
    {
      "title": "Examples",
      "url": "/components/sheet/examples",
      "source": "src/apps/docs/content/components/sheet/examples.mdx",
      "purpose": "The most common pattern: a right-side panel for editing details without leaving the page.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/sheet/examples"
    },
    {
      "title": "Sheet",
      "url": "/components/sheet/usage",
      "source": "src/apps/docs/content/components/sheet/usage.mdx",
      "purpose": "A slide-out panel that appears from a screen edge, used for supplementary content that doesn't require a full page navigation.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/sheet/usage"
    },
    {
      "title": "Accessibility",
      "url": "/components/sidebar/accessibility",
      "source": "src/apps/docs/content/components/sidebar/accessibility.mdx",
      "purpose": "Sidebar must satisfy these on every render before it ships.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/sidebar/accessibility"
    },
    {
      "title": "Examples",
      "url": "/components/sidebar/examples",
      "source": "src/apps/docs/content/components/sidebar/examples.mdx",
      "purpose": "A full shell with sidebar navigation and a main content inset.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/sidebar/examples"
    },
    {
      "title": "Sidebar",
      "url": "/components/sidebar/usage",
      "source": "src/apps/docs/content/components/sidebar/usage.mdx",
      "purpose": "A composable application sidebar for persistent navigation. It handles desktop collapse state, mobile sheet rendering, keyboard toggling, and the named navigation landmark.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/sidebar/usage"
    },
    {
      "title": "Skeleton accessibility",
      "url": "/components/skeleton/accessibility",
      "source": "src/apps/docs/content/components/skeleton/accessibility.mdx",
      "purpose": "",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/skeleton/accessibility"
    },
    {
      "title": "Examples",
      "url": "/components/skeleton/examples",
      "source": "src/apps/docs/content/components/skeleton/examples.mdx",
      "purpose": "Four real loading layouts — dashboard tiles, inbox list, profile pane, and a report table — all preserving the destination layout.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/skeleton/examples"
    },
    {
      "title": "Skeleton",
      "url": "/components/skeleton/usage",
      "source": "src/apps/docs/content/components/skeleton/usage.mdx",
      "purpose": "A pulsing placeholder block for loading states. Always prefer skeletons over spinners where possible — they preserve layout and communicate structure.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/skeleton/usage"
    },
    {
      "title": "Accessibility",
      "url": "/components/slider/accessibility",
      "source": "src/apps/docs/content/components/slider/accessibility.mdx",
      "purpose": "Slider must satisfy these on every render before it ships.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/slider/accessibility"
    },
    {
      "title": "Examples",
      "url": "/components/slider/examples",
      "source": "src/apps/docs/content/components/slider/examples.mdx",
      "purpose": "Notification volume with track labels, two-thumb price-range filter, anomaly-threshold with tone Badge, and a live image-filter chain.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/slider/examples"
    },
    {
      "title": "Usage",
      "url": "/components/slider/usage",
      "source": "src/apps/docs/content/components/slider/usage.mdx",
      "purpose": "Pass two values to get a dual-thumb range slider.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/slider/usage"
    },
    {
      "title": "Accessibility",
      "url": "/components/stat-card/accessibility",
      "source": "src/apps/docs/content/components/stat-card/accessibility.mdx",
      "purpose": "Accessibility component documentation.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/stat-card/accessibility"
    },
    {
      "title": "Examples",
      "url": "/components/stat-card/examples",
      "source": "src/apps/docs/content/components/stat-card/examples.mdx",
      "purpose": "Seven layout variants in real product surfaces — `default` quick-stats, `inline` summary rows, `delta` deltas, `trend` with inline SparkChart, `progress` toward goal, `distribution` segmented breakdown, and a `hero` summ",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/stat-card/examples"
    },
    {
      "title": "Usage",
      "url": "/components/stat-card/usage",
      "source": "src/apps/docs/content/components/stat-card/usage.mdx",
      "purpose": "The card is intentionally compact (`py-4 px-3`). For higher-density dashboards, wrap multiple StatCards in a single Card and use a Separator between them.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/stat-card/usage"
    },
    {
      "title": "Accessibility",
      "url": "/components/status-badge/accessibility",
      "source": "src/apps/docs/content/components/status-badge/accessibility.mdx",
      "purpose": "Accessibility component documentation.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/status-badge/accessibility"
    },
    {
      "title": "Examples",
      "url": "/components/status-badge/examples",
      "source": "src/apps/docs/content/components/status-badge/examples.mdx",
      "purpose": "",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/status-badge/examples"
    },
    {
      "title": "Usage",
      "url": "/components/status-badge/usage",
      "source": "src/apps/docs/content/components/status-badge/usage.mdx",
      "purpose": "Usage component documentation.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/status-badge/usage"
    },
    {
      "title": "Switch accessibility",
      "url": "/components/switch/accessibility",
      "source": "src/apps/docs/content/components/switch/accessibility.mdx",
      "purpose": "Standard `` behaviour — no custom key handling needed.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/switch/accessibility"
    },
    {
      "title": "Examples",
      "url": "/components/switch/examples",
      "source": "src/apps/docs/content/components/switch/examples.mdx",
      "purpose": "Notification preferences, feature flags, third-party integrations, and a security posture checklist.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/switch/examples"
    },
    {
      "title": "Switch",
      "url": "/components/switch/usage",
      "source": "src/apps/docs/content/components/switch/usage.mdx",
      "purpose": "A binary on/off toggle for settings that take effect immediately.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/switch/usage"
    },
    {
      "title": "Table accessibility",
      "url": "/components/table/accessibility",
      "source": "src/apps/docs/content/components/table/accessibility.mdx",
      "purpose": "Table accessibility component documentation.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/table/accessibility"
    },
    {
      "title": "Examples",
      "url": "/components/table/examples",
      "source": "src/apps/docs/content/components/table/examples.mdx",
      "purpose": "",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/table/examples"
    },
    {
      "title": "Table",
      "url": "/components/table/usage",
      "source": "src/apps/docs/content/components/table/usage.mdx",
      "purpose": "Semantic data table with 5 visual variants. Variant context flows from the root `` to all sub-components automatically — no extra props needed on children.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/table/usage"
    },
    {
      "title": "Accessibility",
      "url": "/components/tabs/accessibility",
      "source": "src/apps/docs/content/components/tabs/accessibility.mdx",
      "purpose": "Accessibility component documentation.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/tabs/accessibility"
    },
    {
      "title": "Examples",
      "url": "/components/tabs/examples",
      "source": "src/apps/docs/content/components/tabs/examples.mdx",
      "purpose": "Pair an icon with text for faster scanning. The `icon` prop renders before the label.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/tabs/examples"
    },
    {
      "title": "Usage",
      "url": "/components/tabs/usage",
      "source": "src/apps/docs/content/components/tabs/usage.mdx",
      "purpose": "Usage component documentation.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/tabs/usage"
    },
    {
      "title": "Tag accessibility",
      "url": "/components/tag/accessibility",
      "source": "src/apps/docs/content/components/tag/accessibility.mdx",
      "purpose": "Tag accessibility component documentation.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/tag/accessibility"
    },
    {
      "title": "Examples",
      "url": "/components/tag/examples",
      "source": "src/apps/docs/content/components/tag/examples.mdx",
      "purpose": "Tag input, dismissible filter chips with add-affordances, a skills board, and a single-pick category strip.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/tag/examples"
    },
    {
      "title": "Tag",
      "url": "/components/tag/usage",
      "source": "src/apps/docs/content/components/tag/usage.mdx",
      "purpose": "A label chip with optional remove action. Use for filter chips, selected items, and categorisation labels.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/tag/usage"
    },
    {
      "title": "Accessibility",
      "url": "/components/text/accessibility",
      "source": "src/apps/docs/content/components/text/accessibility.mdx",
      "purpose": "Section title",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/text/accessibility"
    },
    {
      "title": "Examples",
      "url": "/components/text/examples",
      "source": "src/apps/docs/content/components/text/examples.mdx",
      "purpose": "Type scale across product surfaces, semantic tones, an editorial card, and a KPI summary using semantic-tone deltas.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/text/examples"
    },
    {
      "title": "Usage",
      "url": "/components/text/usage",
      "source": "src/apps/docs/content/components/text/usage.mdx",
      "purpose": "Body line-length is best between 45–75 characters. The component does not enforce this; your container's `max-w-prose` should.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/text/usage"
    },
    {
      "title": "Textarea accessibility",
      "url": "/components/textarea/accessibility",
      "source": "src/apps/docs/content/components/textarea/accessibility.mdx",
      "purpose": "No custom key handling needed — native `` behaviour.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/textarea/accessibility"
    },
    {
      "title": "Examples",
      "url": "/components/textarea/examples",
      "source": "src/apps/docs/content/components/textarea/examples.mdx",
      "purpose": "Comment composer, quarterly feedback with live character counter, support ticket with validation, and a long-form release notes draft.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/textarea/examples"
    },
    {
      "title": "Textarea",
      "url": "/components/textarea/usage",
      "source": "src/apps/docs/content/components/textarea/usage.mdx",
      "purpose": "Multi-line text input. Shares the variant and validation model with Input so both can be mixed in a form without restyling.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/textarea/usage"
    },
    {
      "title": "Accessibility",
      "url": "/components/title-bar/accessibility",
      "source": "src/apps/docs/content/components/title-bar/accessibility.mdx",
      "purpose": "The bar has no transitions; nothing to honour beyond the system default.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/title-bar/accessibility"
    },
    {
      "title": "Examples",
      "url": "/components/title-bar/examples",
      "source": "src/apps/docs/content/components/title-bar/examples.mdx",
      "purpose": "",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/title-bar/examples"
    },
    {
      "title": "Usage",
      "url": "/components/title-bar/usage",
      "source": "src/apps/docs/content/components/title-bar/usage.mdx",
      "purpose": "Usage component documentation.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/title-bar/usage"
    },
    {
      "title": "Toast accessibility",
      "url": "/components/toast/accessibility",
      "source": "src/apps/docs/content/components/toast/accessibility.mdx",
      "purpose": "Toast is built on [sonner](https://github.com/emilkowalski/sonner), which ships with WCAG-aware defaults. The MiHCM wrapper preserves them and adds token-based colour contrast.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/toast/accessibility"
    },
    {
      "title": "Examples",
      "url": "/components/toast/examples",
      "source": "src/apps/docs/content/components/toast/examples.mdx",
      "purpose": "Toast is built on [sonner](https://github.com/emilkowalski/sonner) by [Emil Kowalski](https://emilkowal.ski/), themed with MiHCM tokens. Each demo below mounts its own ``; in a real app you'd mount one `` at the layout r",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/toast/examples"
    },
    {
      "title": "Toast",
      "url": "/components/toast/usage",
      "source": "src/apps/docs/content/components/toast/usage.mdx",
      "purpose": "Brief, non-blocking notification that auto-dismisses. Built on top of [sonner](https://github.com/emilkowalski/sonner) ([website](https://sonner.emilkowal.ski/)) and themed end-to-end with MiHCM tokens.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/toast/usage"
    },
    {
      "title": "Accessibility",
      "url": "/components/toggle/accessibility",
      "source": "src/apps/docs/content/components/toggle/accessibility.mdx",
      "purpose": "Accessibility component documentation.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/toggle/accessibility"
    },
    {
      "title": "Examples",
      "url": "/components/toggle/examples",
      "source": "src/apps/docs/content/components/toggle/examples.mdx",
      "purpose": "Inline formatting toolbar, layout view-mode picker, paragraph alignment with live preview, and a table density selector.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/toggle/examples"
    },
    {
      "title": "Usage",
      "url": "/components/toggle/usage",
      "source": "src/apps/docs/content/components/toggle/usage.mdx",
      "purpose": "Usage component documentation.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/toggle/usage"
    },
    {
      "title": "Accessibility",
      "url": "/components/tooltip/accessibility",
      "source": "src/apps/docs/content/components/tooltip/accessibility.mdx",
      "purpose": "No activation key needed — the tooltip appears on focus automatically.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/tooltip/accessibility"
    },
    {
      "title": "Examples",
      "url": "/components/tooltip/examples",
      "source": "src/apps/docs/content/components/tooltip/examples.mdx",
      "purpose": "Position the tooltip relative to the trigger. `top` is the default.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/tooltip/examples"
    },
    {
      "title": "Usage",
      "url": "/components/tooltip/usage",
      "source": "src/apps/docs/content/components/tooltip/usage.mdx",
      "purpose": "Usage component documentation.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/tooltip/usage"
    },
    {
      "title": "Accessibility",
      "url": "/components/top-bar/accessibility",
      "source": "src/apps/docs/content/components/top-bar/accessibility.mdx",
      "purpose": "The bar has no transitions; nothing to honour beyond the system default.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/top-bar/accessibility"
    },
    {
      "title": "Examples",
      "url": "/components/top-bar/examples",
      "source": "src/apps/docs/content/components/top-bar/examples.mdx",
      "purpose": "",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/top-bar/examples"
    },
    {
      "title": "Usage",
      "url": "/components/top-bar/usage",
      "source": "src/apps/docs/content/components/top-bar/usage.mdx",
      "purpose": "**Web**: full-featured header with `Logo`, parallelogram-shaped home/back buttons, 60px height, and tokenized dark/light styling.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/top-bar/usage"
    },
    {
      "title": "Accessibility",
      "url": "/components/transfer-list/accessibility",
      "source": "src/apps/docs/content/components/transfer-list/accessibility.mdx",
      "purpose": "And matching `title` for hover tooltips.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/transfer-list/accessibility"
    },
    {
      "title": "Examples",
      "url": "/components/transfer-list/examples",
      "source": "src/apps/docs/content/components/transfer-list/examples.mdx",
      "purpose": "Workspace admins, project access, feature-flag audience cohorts, and email subscription topics.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/transfer-list/examples"
    },
    {
      "title": "Usage",
      "url": "/components/transfer-list/usage",
      "source": "src/apps/docs/content/components/transfer-list/usage.mdx",
      "purpose": "**Web**: side-by-side dual panes with four move buttons between them.",
      "tags": [
        "component"
      ],
      "absoluteUrl": "https://designsystem.mihcm.com/components/transfer-list/usage"
    }
  ]
}