# @oshun/design-tokens

Centralized design tokens and semantic theme objects for OSHUN.

## Includes

- Schema-first token model (`oshunTokenSchema`) for colors, spacing, radius,
  typography, motion
- Canonical `oshun-v1-foundation` bundle for color, typography, spacing,
  elevation, and motion
- Canonical shell domain-accent behavior contract for Tara, Arete, Veritas, Nyx,
  and Nisaba
- Canonical grounded-evidence behavior contract for grounded answers, evidence
  packs, citation trails, claim checks, source summaries, and passage excerpts
- Canonical disclosure and synthetic-indicator behavior contract for assistant
  identity, memory state, voice/avatar sessions, and generated media
- Canonical assistant-persona-switching behavior contract for active persona,
  recommended context matches, preview/restricted personas, and continuity notes
  across assistant and Studio surfaces
- Canonical avatar-and-voice-identity behavior contract for named synthetic
  voice profiles, avatar packs, linked personas, readiness state, live
  escalation, and lineage notes across assistant and Studio surfaces
- Canonical review-and-approval behavior contract for pending/in-review workflow
  posture, clean approvals, changes requested, rejection, escalation, approved
  exceptions, and adjacent governance evidence across Studio surfaces
- Canonical trust-signal behavior contract for confidence, provenance, and
  watermark badges across claim cards, queues, source summaries, and operator
  provenance review surfaces
- Canonical admin-state behavior contract for operator severity, queue posture,
  timer escalation, and dense governance badges across Studio workspaces
- Shared spacing scale, typography ramp, elevation ladder, and motion token
  exports for app adapters
- Primitive compatibility tokens for shared UI packages
- Grouped semantic tokens (`surface`, `text`, `accent`, `status`) per theme
  variant
- Semantic theme variants: `light`, `dark`, `highContrastLight`,
  `highContrastDark`
- CSS variable generation helper

## Nx Targets

- `pnpm nx run @oshun/design-tokens:build`
- `pnpm nx run @oshun/design-tokens:lint`
- `pnpm nx run @oshun/design-tokens:typecheck`
- `pnpm nx run @oshun/design-tokens:test`