npx shadcn@latest add button card input textarea select dialog sheet tabs badge separator checkbox switch slider tooltip dropdown-menu table

:root {
  --background: #F6F7F5;
  --foreground: #202421;
  --card: #FFFFFF;
  --card-foreground: #202421;
  --popover: #FFFFFF;
  --popover-foreground: #202421;
  --primary: #162B45;
  --primary-foreground: #ffffff;
  --secondary: #f4f4f5;
  --secondary-foreground: #111111;
  --muted: #6B716D;
  --muted-foreground: #202421;
  --accent: #C75B2A;
  --accent-foreground: #ffffff;
  --destructive: #A44A43;
  --border: #DADDD8;
  --input: #DADDD8;
  --ring: #C75B2A;
  --chart-1: #162B45;
  --chart-2: #f4f4f5;
  --chart-3: #C75B2A;
  --chart-4: #4F7661;
  --chart-5: #9B6A2F;
  --sidebar: #FFFFFF;
  --sidebar-foreground: #202421;
  --sidebar-primary: #162B45;
  --sidebar-primary-foreground: #ffffff;
  --sidebar-accent: #456B8D;
  --sidebar-accent-foreground: #ffffff;
  --sidebar-border: #DADDD8;
  --sidebar-ring: #C75B2A;
  --radius: 6px;
}

.dark {
  --background: #0f1115;
  --foreground: #f8fafc;
  --card: #181b22;
  --card-foreground: #f8fafc;
  --popover: #181b22;
  --popover-foreground: #f8fafc;
  --primary: #162B45;
  --primary-foreground: #ffffff;
  --secondary: #252a33;
  --secondary-foreground: #f8fafc;
  --muted: #252a33;
  --muted-foreground: #a1a1aa;
  --accent: #C75B2A;
  --accent-foreground: #ffffff;
  --destructive: #A44A43;
  --border: #303642;
  --input: #303642;
  --ring: #C75B2A;
  --chart-1: #162B45;
  --chart-2: #f4f4f5;
  --chart-3: #C75B2A;
  --chart-4: #4F7661;
  --chart-5: #9B6A2F;
  --sidebar: #181b22;
  --sidebar-foreground: #f8fafc;
  --sidebar-primary: #162B45;
  --sidebar-primary-foreground: #ffffff;
  --sidebar-accent: #C75B2A;
  --sidebar-accent-foreground: #ffffff;
  --sidebar-border: #303642;
  --sidebar-ring: #C75B2A;
  --radius: 6px;
}

import { Badge } from "@/components/ui/badge";
import { Button } from "@/components/ui/button";
import {
  Card,
  CardContent,
  CardDescription,
  CardFooter,
  CardHeader,
  CardTitle,
} from "@/components/ui/card";
import { Input } from "@/components/ui/input";
import { Tabs, TabsList, TabsTrigger } from "@/components/ui/tabs";

export function KatagamiContextMapSystemShadcnKit() {
  return (
    <section className="grid gap-4 rounded-[var(--radius)] border bg-background p-4 text-foreground">
      <div className="flex items-start justify-between gap-4">
        <div>
          <Badge variant="outline">shadcn/ui</Badge>
          <h2 className="mt-3 text-2xl font-semibold tracking-tight">Katagami Context Map System</h2>
          <p className="mt-1 max-w-xl text-sm text-muted-foreground">
            Use the Katagami registry theme, then compose these shadcn primitives
            with the language-specific component recipes.
          </p>
        </div>
        <Button>Apply theme</Button>
      </div>

      <Tabs defaultValue="components">
        <TabsList>
          <TabsTrigger value="components">Components</TabsTrigger>
          <TabsTrigger value="states">States</TabsTrigger>
          <TabsTrigger value="export">Export</TabsTrigger>
        </TabsList>
      </Tabs>

      <Card>
        <CardHeader>
          <CardTitle>Component recipe</CardTitle>
          <CardDescription>
            Replace this starter content with the agent-authored product scene
            from components.md and preview-shots.json.
          </CardDescription>
        </CardHeader>
        <CardContent className="grid gap-3 sm:grid-cols-[1fr_auto]">
          <Input defaultValue="Tokenized shadcn surface" aria-label="Recipe name" />
          <Button variant="secondary">Preview state</Button>
        </CardContent>
        <CardFooter className="justify-between">
          <Badge>Ready</Badge>
          <Button variant="outline">Copy recipe</Button>
        </CardFooter>
      </Card>
    </section>
  );
}

{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "katagami-context-map-system",
  "type": "registry:theme",
  "title": "Katagami Context Map System shadcn Theme",
  "cssVars": {
    "theme": {},
    "light": {
      "background": "#F6F7F5",
      "foreground": "#202421",
      "card": "#FFFFFF",
      "card-foreground": "#202421",
      "popover": "#FFFFFF",
      "popover-foreground": "#202421",
      "primary": "#162B45",
      "primary-foreground": "#ffffff",
      "secondary": "#f4f4f5",
      "secondary-foreground": "#111111",
      "muted": "#6B716D",
      "muted-foreground": "#202421",
      "accent": "#C75B2A",
      "accent-foreground": "#ffffff",
      "destructive": "#A44A43",
      "border": "#DADDD8",
      "input": "#DADDD8",
      "ring": "#C75B2A",
      "chart-1": "#162B45",
      "chart-2": "#f4f4f5",
      "chart-3": "#C75B2A",
      "chart-4": "#4F7661",
      "chart-5": "#9B6A2F",
      "sidebar": "#FFFFFF",
      "sidebar-foreground": "#202421",
      "sidebar-primary": "#162B45",
      "sidebar-primary-foreground": "#ffffff",
      "sidebar-accent": "#456B8D",
      "sidebar-accent-foreground": "#ffffff",
      "sidebar-border": "#DADDD8",
      "sidebar-ring": "#C75B2A",
      "radius": "6px"
    },
    "dark": {
      "background": "#0f1115",
      "foreground": "#f8fafc",
      "card": "#181b22",
      "card-foreground": "#f8fafc",
      "popover": "#181b22",
      "popover-foreground": "#f8fafc",
      "primary": "#162B45",
      "primary-foreground": "#ffffff",
      "secondary": "#252a33",
      "secondary-foreground": "#f8fafc",
      "muted": "#252a33",
      "muted-foreground": "#a1a1aa",
      "accent": "#C75B2A",
      "accent-foreground": "#ffffff",
      "destructive": "#A44A43",
      "border": "#303642",
      "input": "#303642",
      "ring": "#C75B2A",
      "chart-1": "#162B45",
      "chart-2": "#f4f4f5",
      "chart-3": "#C75B2A",
      "chart-4": "#4F7661",
      "chart-5": "#9B6A2F",
      "sidebar": "#181b22",
      "sidebar-foreground": "#f8fafc",
      "sidebar-primary": "#162B45",
      "sidebar-primary-foreground": "#ffffff",
      "sidebar-accent": "#C75B2A",
      "sidebar-accent-foreground": "#ffffff",
      "sidebar-border": "#303642",
      "sidebar-ring": "#C75B2A",
      "radius": "6px"
    }
  },
  "meta": {
    "source": "katagami",
    "languageId": "katagami-context-map-system",
    "slug": "katagami-context-map-system",
    "componentManifest": [
      "button",
      "card",
      "input",
      "textarea",
      "select",
      "dialog",
      "sheet",
      "tabs",
      "badge",
      "separator",
      "checkbox",
      "switch",
      "slider",
      "tooltip",
      "dropdown-menu",
      "table"
    ],
    "installCommand": "npx shadcn@latest add button card input textarea select dialog sheet tabs badge separator checkbox switch slider tooltip dropdown-menu table",
    "nativeTokenNames": {
      "borders": [
        "accent_width",
        "character",
        "default_width",
        "style"
      ],
      "colors": [
        "accent",
        "background",
        "border",
        "border_faint",
        "error",
        "info",
        "muted",
        "primary",
        "primary_soft",
        "selection",
        "subtle",
        "success",
        "surface",
        "surface_washi",
        "text",
        "warning"
      ],
      "motion": [
        "duration",
        "easing",
        "philosophy"
      ],
      "radii": [
        "full",
        "lg",
        "md",
        "none",
        "sm",
        "xl"
      ],
      "shadows": [
        "lg",
        "md",
        "sm"
      ],
      "spacing": [
        "base",
        "scale"
      ],
      "surfaces": [
        "bg_pattern",
        "card_style",
        "treatment"
      ],
      "typography": [
        "base_size",
        "body_font",
        "google_fonts_url",
        "heading_font",
        "letter_spacing",
        "line_height",
        "mono_font",
        "scale_ratio",
        "ui_font"
      ]
    }
  }
}

# Katagami Context Map System shadcn/ui Components

Artifact: `component-recipes-v1`
Author: `katagami-ui-projection`
Language ID: `katagami-context-map-system`
Slug: `katagami-context-map-system`

## Intent

A calm, light, text-first workspace language for AYA where navigation behaves like a context map rather than a dashboard. The system translates katagami craft, washi restraint, weaving, negative space, and rhythm into product-grade structure: fine hairline dividers, deliberate apertures for reading, woven trails between threads and documents, and quiet marginal signals that show state without taking over the canvas. Japanese inspiration stays abstract and operational: precision cuts, layered context, proportion, material restraint, and attentive whitespace. The result is a crisp gray-white reading environment with charcoal sumi typography, blue-black indigo selection logic, low-chroma semantic status, and tiny persimmon attention marks used only for change or urgency.

## Required primitives

- button
- card
- input
- textarea
- select
- dialog
- sheet
- tabs
- badge
- separator
- checkbox
- switch
- slider
- tooltip
- dropdown-menu
- table

Install with `npx shadcn@latest add button card input textarea select dialog sheet tabs badge separator checkbox switch slider tooltip dropdown-menu table`.

## Token cues

Colors:

{
  "accent": "#C75B2A",
  "background": "#F6F7F5",
  "border": "#DADDD8",
  "border_faint": "#ECEEEA",
  "error": "#A44A43",
  "info": "#456B8D",
  "muted": "#6B716D",
  "primary": "#162B45",
  "primary_soft": "#E8EEF5",
  "selection": "#203D63",
  "subtle": "#8D948F",
  "success": "#4F7661",
  "surface": "#FFFFFF",
  "surface_washi": "#FAFAF7",
  "text": "#202421",
  "warning": "#9B6A2F"
}

Typography:

{
  "base_size": "16px",
  "body_font": "Source Serif 4",
  "google_fonts_url": "https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&family=Source+Serif+4:wght@400;500;600&family=IBM+Plex+Mono:wght@400;500;600&display=swap",
  "heading_font": "Inter",
  "letter_spacing": "-0.01em",
  "line_height": 1.58,
  "mono_font": "IBM Plex Mono",
  "scale_ratio": 1.18,
  "ui_font": "Inter"
}

## Visual character to preserve

- A gray-white canvas supports long reading with charcoal text, disciplined measures, and faint paper-like tonal shifts that never become texture decoration.
- Context relationships are shown by indentation, vertical thread lines, soft rails, breadcrumbs, reference chips, and marginal annotations.
- Cards are mostly flat white or warm-white sheets separated by 1px hairlines; shadows are almost absent and used only for active overlays.
- Compact metrics appear beside documents as small text rows, counters, deltas, or marginal capsules instead of a dashboard grid.
- Interaction states feel cut and placed: indigo edge marks, inset outlines, thin selected rails, and tiny persimmon change badges.

## ShadSync visual profile

{
  "family": "paper-collage",
  "material": "paper",
  "contour": "default",
  "border": "solid",
  "underlay": false,
  "grain": true,
  "stickerBadges": true,
  "motion": "still",
  "density": "dense",
  "accents": [
    "primary",
    "accent",
    "secondary",
    "muted"
  ]
}

## Signature component recipes

### Button
Use `Button` for primary, secondary, outline, and ghost actions. Primary actions must expose the language's strongest contrast pair, while secondary and ghost actions should preserve the surface treatment instead of falling back to default neutral SaaS styling.

### Card
Use `Card`, `CardHeader`, `CardContent`, `CardFooter`, and `CardAction` as the main composition frame. Cards should demonstrate the language's surface, border, hierarchy, and density rules rather than appearing as generic rounded rectangles.

### Input and Textarea
Use `Input` and `Textarea` with visible focus rings, field labels, validation states, and the language's rhythm. Forms should show real product content, not placeholder-only controls.

### Select, Tabs, and Table
Use `Select`, `Tabs`, and `Table` to prove navigation, filtering, and dense data states. The table should show row rhythm, separators, hover/focus states, and an empty or status state when the language calls for it.

### Dialog and Sheet
Use `Dialog` for centered decisions and `Sheet` for contextual editing. Both should inherit the language's spacing, border, overlay, and motion rules.

## Preview shots

- `application-shell`: dashboard or workspace shell with navigation, cards, forms, and state badges.
- `detail-editor`: focused editing flow using input, textarea, select, switch/checkbox, dialog or sheet, and action buttons.
- `data-operations`: table-heavy operational view with tabs, dropdown menu affordances, badges, and destructive/empty states.
- Each preview shot must include a renderable `scene` payload with concrete headline, description, actions, and rows/fields/stats for the UI preview.

## Implementation contract

- Start from local `ui/src/components/ui` shadcn-style primitives; do not create a second component system.
- Apply `/katagami/shadcn/katagami-context-map-system/registry-theme.json` variables, then use these recipes for composition and state design.
- Preserve Katagami token names as source metadata; shadcn semantic names are only the export surface.
- Do: Make reading the center of gravity; place analytics as marginal or inline context.; Use indigo consistently for location, active route, selected object, focus, and thread continuation.; Express katagami through precise cut edges, apertures, layering, and craft restraint rather than patterns.; Use whitespace as structure: generous document gutters, disciplined indentation, and clear negative space around active text.; Keep status low-chroma and text-labeled; let semantic color support hierarchy, not dominate it.; Design hover/selected/active states with rails, outlines, slight tonal fills, and marginal markers.; Style all controls deliberately with custom borders, focus rings, and readable labels.
- Do not: Do not use literal Japanese motifs, tourist cliches, stencil flowers, waves, cranes, torii, seals, or faux calligraphy.; Do not lead with KPI cards, chart grids, or a dashboard homepage when the product task is reading and synthesis.; Do not turn katagami into a decorative background pattern or lace overlay.; Do not use indigo as a large brand wash; keep it as a navigation and state instrument.; Do not make persimmon a second primary color; use it only as micro-attention.; Do not rely on shadows to separate core surfaces when hairlines and spacing are enough.; Do not compress the reading column for the sake of showing every metric at once.

## Copy-paste component example

This generated starter proves the import shape. Production Katagami agents should replace it with a language-specific product composition.

```tsx
import { Badge } from "@/components/ui/badge";
import { Button } from "@/components/ui/button";
import {
  Card,
  CardContent,
  CardDescription,
  CardFooter,
  CardHeader,
  CardTitle,
} from "@/components/ui/card";
import { Input } from "@/components/ui/input";
import { Tabs, TabsList, TabsTrigger } from "@/components/ui/tabs";

export function KatagamiContextMapSystemShadcnKit() {
  return (
    <section className="grid gap-4 rounded-[var(--radius)] border bg-background p-4 text-foreground">
      <div className="flex items-start justify-between gap-4">
        <div>
          <Badge variant="outline">shadcn/ui</Badge>
          <h2 className="mt-3 text-2xl font-semibold tracking-tight">Katagami Context Map System</h2>
          <p className="mt-1 max-w-xl text-sm text-muted-foreground">
            Use the Katagami registry theme, then compose these shadcn primitives
            with the language-specific component recipes.
          </p>
        </div>
        <Button>Apply theme</Button>
      </div>

      <Tabs defaultValue="components">
        <TabsList>
          <TabsTrigger value="components">Components</TabsTrigger>
          <TabsTrigger value="states">States</TabsTrigger>
          <TabsTrigger value="export">Export</TabsTrigger>
        </TabsList>
      </Tabs>

      <Card>
        <CardHeader>
          <CardTitle>Component recipe</CardTitle>
          <CardDescription>
            Replace this starter content with the agent-authored product scene
            from components.md and preview-shots.json.
          </CardDescription>
        </CardHeader>
        <CardContent className="grid gap-3 sm:grid-cols-[1fr_auto]">
          <Input defaultValue="Tokenized shadcn surface" aria-label="Recipe name" />
          <Button variant="secondary">Preview state</Button>
        </CardContent>
        <CardFooter className="justify-between">
          <Badge>Ready</Badge>
          <Button variant="outline">Copy recipe</Button>
        </CardFooter>
      </Card>
    </section>
  );
}
```

## Layout notes

{
  "breakpoints": "Mobile <= 640px collapses the context map into a top breadcrumb stack and hides marginalia behind inline disclosure. Tablet 641-1024px keeps document plus collapsible context drawer. Desktop >= 1025px shows context map, reading pane, and optional marginalia rail.",
  "density": "Compact in navigation and metadata, relaxed in prose. Use 28-36px nav rows, 12-16px chip height/padding rhythm, 20-24px document section spacing, and 40-64px breathing room at major transitions.",
  "grid": "Desktop uses a 12-column shell: 232-280px context map, flexible 680-820px reading/work pane, and 220-300px marginalia rail. All modules align to a 4px base with 8px row rhythm and 24-32px page gutters.",
  "responsive": "Preserve reading order first. Navigation becomes a context trail above the document; marginal metrics become inline summary rows below relevant headings; secondary references collapse into labeled disclosure groups.",
  "whitespace": "Whitespace is active negative space: it separates layers, gives documents room, and prevents context from feeling like dashboard clutter. Prefer empty margins with a few signals over filled sidebars."
}

{
  "artifact": "katagami:shadcn-preview-shots",
  "version": "preview-shots-v1",
  "generator": "katagami-ui-compatibility-projection",
  "generatedBy": "katagami-ui-projection",
  "requiresVisualProfile": true,
  "schema": "katagami:shadcn-preview-shots/renderable-v1",
  "renderable": true,
  "language": {
    "id": "katagami-context-map-system",
    "name": "Katagami Context Map System",
    "slug": "katagami-context-map-system"
  },
  "installCommand": "npx shadcn@latest add button card input textarea select dialog sheet tabs badge separator checkbox switch slider tooltip dropdown-menu table",
  "primitives": [
    "button",
    "card",
    "input",
    "textarea",
    "select",
    "dialog",
    "sheet",
    "tabs",
    "badge",
    "separator",
    "checkbox",
    "switch",
    "slider",
    "tooltip",
    "dropdown-menu",
    "table"
  ],
  "identityNotes": [
    "A gray-white canvas supports long reading with charcoal text, disciplined measures, and faint paper-like tonal shifts that never become texture decoration.",
    "Context relationships are shown by indentation, vertical thread lines, soft rails, breadcrumbs, reference chips, and marginal annotations.",
    "Cards are mostly flat white or warm-white sheets separated by 1px hairlines; shadows are almost absent and used only for active overlays.",
    "Compact metrics appear beside documents as small text rows, counters, deltas, or marginal capsules instead of a dashboard grid.",
    "Interaction states feel cut and placed: indigo edge marks, inset outlines, thin selected rails, and tiny persimmon change badges."
  ],
  "visualProfile": {
    "family": "paper-collage",
    "material": "paper",
    "contour": "default",
    "border": "solid",
    "underlay": false,
    "grain": true,
    "stickerBadges": true,
    "motion": "still",
    "density": "dense",
    "accents": [
      "primary",
      "accent",
      "secondary",
      "muted"
    ]
  },
  "shots": [
    {
      "id": "application-shell",
      "title": "Application shell",
      "viewport": "desktop",
      "primitives": [
        "button",
        "card",
        "input",
        "select",
        "tabs",
        "badge",
        "separator",
        "table"
      ],
      "composition": "A real product workspace with navigation, summary cards, filtering controls, and one dense content region.",
      "mustShow": [
        "primary and secondary actions",
        "card hierarchy",
        "filterable state",
        "table or list density"
      ],
      "avoid": [
        "component inventory walls",
        "placeholder-only content",
        "generic rounded SaaS chrome"
      ],
      "scene": {
        "eyebrow": "workspace spread",
        "headline": "Katagami Context Map System launch room",
        "description": "A product team workspace where navigation, filters, metrics, and dense rows carry the language's visible structure.",
        "primaryAction": "Apply theme",
        "secondaryAction": "Review states",
        "stats": [
          {
            "label": "components",
            "value": "16",
            "tone": "accent"
          },
          {
            "label": "states",
            "value": "ready"
          },
          {
            "label": "density",
            "value": "balanced",
            "tone": "warning"
          }
        ],
        "rows": [
          {
            "label": "Primary flow",
            "value": "mapped",
            "status": "active"
          },
          {
            "label": "Token coverage",
            "value": "semantic",
            "status": "synced"
          },
          {
            "label": "Responsive proof",
            "value": "queued",
            "status": "review"
          }
        ],
        "statuses": [
          "Active",
          "Synced",
          "Draft"
        ]
      }
    },
    {
      "id": "detail-editor",
      "title": "Detail editor",
      "viewport": "tablet",
      "primitives": [
        "button",
        "card",
        "input",
        "textarea",
        "select",
        "checkbox",
        "switch",
        "slider",
        "dialog",
        "sheet"
      ],
      "composition": "A focused editing flow with form fields, validation, confirmation, and a contextual side panel.",
      "mustShow": [
        "focus ring",
        "error or destructive state",
        "dialog or sheet treatment",
        "written guidance content"
      ],
      "avoid": [
        "unstyled browser controls",
        "floating cards inside cards",
        "missing labels"
      ],
      "scene": {
        "eyebrow": "editing flow",
        "headline": "Language recipe editor",
        "description": "A focused form proving labels, validation, toggles, panel rhythm, and action hierarchy.",
        "primaryAction": "Save recipe",
        "secondaryAction": "Open sheet",
        "fields": [
          {
            "label": "Component family",
            "value": "Narrative cards"
          },
          {
            "label": "State treatment",
            "value": "Visible focus + validation"
          },
          {
            "label": "Motion",
            "value": "Small lift, no opacity-only fade"
          }
        ],
        "statuses": [
          "Focus",
          "Invalid",
          "Confirmed"
        ]
      }
    },
    {
      "id": "data-operations",
      "title": "Data operations",
      "viewport": "mobile",
      "primitives": [
        "button",
        "tabs",
        "badge",
        "dropdown-menu",
        "table",
        "tooltip",
        "separator"
      ],
      "composition": "A compact operational view proving row rhythm, stacked actions, menu states, badges, and empty/destructive states.",
      "mustShow": [
        "responsive reflow",
        "dense row styling",
        "menu affordance",
        "status badge system"
      ],
      "avoid": [
        "desktop-only tables",
        "text overflow",
        "default shadcn spacing without Katagami character"
      ],
      "scene": {
        "eyebrow": "operations",
        "headline": "Compact review queue",
        "description": "A narrow viewport scene with rows, menus, tooltips, badges, and destructive affordances.",
        "primaryAction": "Resolve",
        "secondaryAction": "Filter",
        "rows": [
          {
            "label": "Button hierarchy",
            "value": "approved",
            "status": "ok"
          },
          {
            "label": "Table rhythm",
            "value": "needs pass",
            "status": "watch"
          },
          {
            "label": "Empty state",
            "value": "designed",
            "status": "done"
          }
        ],
        "statuses": [
          "Queued",
          "Blocked",
          "Done"
        ]
      }
    }
  ],
  "componentRecipes": [
    {
      "primitive": "button",
      "intent": "Prove action hierarchy, focus, disabled, and destructive states."
    },
    {
      "primitive": "card",
      "intent": "Carry the language surface, border, elevation, and density rules."
    },
    {
      "primitive": "input",
      "intent": "Show labels, focus rings, validation, and spacing rhythm."
    },
    {
      "primitive": "textarea",
      "intent": "Show longer guidance, validation copy, and writing density."
    },
    {
      "primitive": "select",
      "intent": "Show filtering, selection contrast, and menu trigger styling."
    },
    {
      "primitive": "dialog",
      "intent": "Show centered decision states and overlay treatment."
    },
    {
      "primitive": "sheet",
      "intent": "Show contextual side panels and responsive editing."
    },
    {
      "primitive": "tabs",
      "intent": "Show navigational structure and active/inactive contrast."
    },
    {
      "primitive": "badge",
      "intent": "Show compact status vocabulary and semantic colors."
    },
    {
      "primitive": "separator",
      "intent": "Show section rhythm without generic gray dividers."
    },
    {
      "primitive": "checkbox",
      "intent": "Show binary selection with visible focus and checked states."
    },
    {
      "primitive": "switch",
      "intent": "Show settings toggles and on/off contrast."
    },
    {
      "primitive": "slider",
      "intent": "Show numeric adjustment with track/thumb styling."
    },
    {
      "primitive": "tooltip",
      "intent": "Show concise explanation styling above compact controls."
    },
    {
      "primitive": "dropdown-menu",
      "intent": "Show action menus, destructive items, and grouped choices."
    },
    {
      "primitive": "table",
      "intent": "Show dense operational data, separators, row states, and responsive behavior."
    }
  ],
  "qualityRules": {
    "do": [
      "Make reading the center of gravity; place analytics as marginal or inline context.",
      "Use indigo consistently for location, active route, selected object, focus, and thread continuation.",
      "Express katagami through precise cut edges, apertures, layering, and craft restraint rather than patterns.",
      "Use whitespace as structure: generous document gutters, disciplined indentation, and clear negative space around active text.",
      "Keep status low-chroma and text-labeled; let semantic color support hierarchy, not dominate it.",
      "Design hover/selected/active states with rails, outlines, slight tonal fills, and marginal markers.",
      "Style all controls deliberately with custom borders, focus rings, and readable labels."
    ],
    "dont": [
      "Do not use literal Japanese motifs, tourist cliches, stencil flowers, waves, cranes, torii, seals, or faux calligraphy.",
      "Do not lead with KPI cards, chart grids, or a dashboard homepage when the product task is reading and synthesis.",
      "Do not turn katagami into a decorative background pattern or lace overlay.",
      "Do not use indigo as a large brand wash; keep it as a navigation and state instrument.",
      "Do not make persimmon a second primary color; use it only as micro-attention.",
      "Do not rely on shadows to separate core surfaces when hairlines and spacing are enough.",
      "Do not compress the reading column for the sake of showing every metric at once."
    ]
  }
}