# @solibo/solibo-ui

A React 19 + TypeScript component library built with Vite. Ships typed, tree‑shakeable components, CSS Modules styling, and Storybook docs.

- Package: `@solibo/solibo-ui`
- Node: 22
- Package manager: pnpm

## Installation

```bash
pnpm add @solibo/solibo-ui
# peer dependencies
pnpm add react@^19 react-dom@^19 -D
```

## Quick usage

```tsx
import { Figure } from '@solibo/solibo-ui';

export const Example = () => (
  <Figure
    accessibleLabel='Example'
    offset='left'
  >
    <img
      src='/path/to/image.jpg'
      alt=''
    />
  </Figure>
);
```

## Development

```bash
pnpm install
pnpm storybook
```

### Generate component

```bash
./generate <name>
```

### Scripts

```bash
pnpm dev            # vite build --watch (library build)
pnpm build          # type-check + library build
pnpm test           # vitest (UI mode by default via script)
pnpm lint           # eslint
pnpm stylelint      # stylelint for CSS modules
pnpm format         # prettier check
pnpm format:fix     # prettier fix
pnpm tokens:build   # generate design tokens CSS
pnpm tokens:audit   # report potential issues
pnpm tokens:figma   # import Figma token export
```

### Design tokens

Published builds expose `@solibo/solibo-ui/tokens.css` and `@solibo/solibo-ui/tokens.json`.

### CI/CD

- GitHub Actions handle builds, tests, and publishing.

### Contributing

- Follow the conventions in `AGENTS.md` and `.github/copilot-instructions.md`.
- Prefer small, focused PRs with tests and stories.
