pulse-agent
bbdb68a6de
Esta commit conteudo a estrutura atomica completa:
- types: Result<T,E>, AsyncState<T>, Paginated<T>, SortConfig<T>
- utils: date, str, num, cn, debounce, throttle, storage, arr, obj
- validators: Zod schemas — email, password, uuid, url, phone, CPF/CNPJ, sanitizedStr, safeParse
- hooks: useToggle, useAsync, useDebounce, useLocalStorage, useMedia, useInterval, useOnClickOutside, useClipboard, useFetch
- components: Button, Input, Alert, Card, Spinner (atomic design pattern)
- build: tsup v8 ESM+CJS + DTS + sourcemaps — 0 erros
- tests: 57 testes 100% usuarios
- docker: multi-stage Dockerfile (node 20-alpine)
- config: vitest, tsup, tsconfig strict, .npmignore
Filosofia atomica:/utils ← /types ← /validators ← /hooks ← /components
Build: npm run build | Test: npm test | Publish: npm publish
🤖 Generated with Pulse (openclaw + nova-self-improver)
69 lines
2.2 KiB
Markdown
69 lines
2.2 KiB
Markdown
# @pulse-libs/core
|
|
|
|
> Biblioteca universal componentizada — React · Vue · Hooks · Utils · Validators
|
|
> Um único pacote. Todos os projetos.
|
|
|
|
---
|
|
|
|
## 📐 Estrutura atômica
|
|
|
|
```
|
|
@pulse-libs/core
|
|
├── types/ Tipos TypeScript compartilhados (zero deps)
|
|
├── utils/ Funções puras — date, str, num, classnames, debounce, throttle
|
|
├── validators/ Schemas Zod reutilizáveis (email, password, uuid, phone)
|
|
├── hooks/ React hooks — useToggle, useAsync, useDebounce, useLocalStorage
|
|
├── components/ Componentes atômicos React — Button, Input, Alert, Card, Spinner
|
|
├── composable-vue/ Composables Vue 3
|
|
├── composables/ Composables genéricos (agnósticos de framework)
|
|
├── lib/ Helpers third-party (sem duplicar lógica)
|
|
└── constants/ Constantes comuns (status codes, mensagens, etc)
|
|
```
|
|
|
|
## 🚀 Instalação
|
|
|
|
```bash
|
|
npm install @pulse-libs/core zod react vue
|
|
```
|
|
|
|
```tsx
|
|
// React — utilitários + componentes
|
|
import { Button, Input, useAsync, date, cn } from '@pulse-libs/core';
|
|
|
|
// Validadores
|
|
import { emailSchema, passwordSchema, safeParse } from '@pulse-libs/core/validators';
|
|
|
|
// Vue — composables
|
|
import { useToggle, useLocalStorage } from '@pulse-libs/core/vue';
|
|
```
|
|
|
|
## 📦 Sub-exports
|
|
|
|
```ts
|
|
import { Button } from '@pulse-libs/core/react';
|
|
import { useFetch } from '@pulse-libs/core/hooks';
|
|
import { cn, date } from '@pulse-libs/core/utils';
|
|
```
|
|
|
|
## 🏗️ Filosofia atômica
|
|
|
|
| Camada | Exemplo | Depende de |
|
|
|--------|---------|------------|
|
|
| **Utils** | `cn()`, `debounce()`, `date.format()` | zero |
|
|
| **Types** | `Result<T>`, `AsyncState<T>` | zero |
|
|
| **Validators** | `emailSchema`, `uuidSchema` | utils, types, zod |
|
|
| **Hooks** | `useAsync()`, `useDebounce()` | utils, types, react |
|
|
| **Components** | `Button`, `Input`, `Alert` | utils, validators |
|
|
|
|
> **Regra de ouro**: uma camada nunca importa de uma camada de nível inferior.
|
|
> Utils não sabe que Hooks existem. Hooks não sabe que Components existem.
|
|
|
|
## 🔄 Versionamento
|
|
|
|
- `1.0.0-beta.x` — desenvolvimento, API pode mudar
|
|
- `1.0.0` — primeiro release estável, API congelada
|
|
|
|
## 🤝 Contribuir
|
|
|
|
Ver [CONTRIBUTING.md](CONTRIBUTING.md).
|