feat(lib-core): biblioteca atomica @pulse-libs/core v1.0.0-beta.1

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)
This commit is contained in:
pulse-agent
2026-05-19 21:43:03 -03:00
parent ae39e45460
commit bbdb68a6de
7030 changed files with 2040595 additions and 0 deletions
+68
View File
@@ -0,0 +1,68 @@
# @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).