# @oshun/ui

Shared OSHUN UI primitives and theme contracts.

## Exports

- `@oshun/ui` all exports
- `@oshun/ui/components` primitives (`Box`, `Stack`, `Text`, `Button`, `IconButton`, `Card`)
- `@oshun/ui/components` data-display (`ListRow`, `StatTile`, `Badge`, `Chip`)
- `@oshun/ui/components` feedback (`Toast`, `Banner`, `EmptyState`, `ErrorState`)
- `@oshun/ui/components` overlays (`BottomSheet`, `Modal`, `ActionSheet`, `CommandPalette`)
- `@oshun/ui/components` navigation (`BottomNav`, `TopBar`, `DomainSwitcher`)
- `@oshun/ui/motion` page transition and card reveal helpers for web and React Native
- `@oshun/ui/theme` theme contract and helpers

## Storybook Stories

- `libs/oshun/ui/src/components/primitives.stories.tsx`
- `libs/oshun/ui/src/components/data-display.stories.tsx`
- `libs/oshun/ui/src/components/feedback.stories.tsx`
- `libs/oshun/ui/src/components/overlays.stories.tsx`
- `libs/oshun/ui/src/components/navigation.stories.tsx`

## Accessibility Regression Coverage

- `libs/oshun/ui/src/components/accessibility-snapshots.test.tsx` captures role and ARIA snapshots for critical interactive components.

## Motion Regression Coverage

- `libs/oshun/ui/src/motion/transitions.test.ts` verifies page transition and card reveal helper contracts.

## Nx Targets

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