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)
2.2 KiB
2.2 KiB
@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
npm install @pulse-libs/core zod react vue
// 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
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 mudar1.0.0— primeiro release estável, API congelada
🤝 Contribuir
Ver CONTRIBUTING.md.