Biblioteca de **componentes de formulario para React**, desenvolvida para **padronização visual**, **reutilização** e **escalabilidade** em aplicações modernas e design systems.
npm install @pipelinesolucoes/formBiblioteca de componentes de formulario para React, desenvolvida para padronização visual, reutilização e escalabilidade em aplicações modernas e design systems.
Este pacote faz parte do ecossistema de componentes da Pipeline Soluções.
---
A biblioteca inclui os seguintes componentes:
- GoogleButton
Componente de botão que redireciona o usuário para um endpoint externo (ex: autenticação com Google).
Durante o clique, o botão entra em estado de loading e, caso ocorra algum erro, exibe uma mensagem abaixo do botão.
- FormMessage
Componente de formulário para envio de mensagem.
Faz a validação do e-mail, telefone e exibe a mensagem retornada.
- TextFieldPassword
Componente de campo de senha baseado no TextField do Material UI, com botão para alternar entre mostrar/ocultar a senha.
O componente:
- Retorna somente a senha digitada via onPasswordChange
- Valida obrigatório + formato (regex) e exibe mensagens de erro automaticamente
- Dispara um "evento" de validação via onValidationChange
- TextFieldValidate
Componente de campo de texto com validação, baseado no TextField do Material UI.
Permite personalização visual via styled e suporte a validações comuns (obrigatório, tamanho mínimo, regex) e validação customizada.
- TextFieldNumberValidate
Campo de texto numérico com suporte a validações comuns e customizadas, construído sobre o TextField do Material UI e
estilizado via Design System da Pipeline.
- TextFieldBirthDateWithAge
Campo de data de nascimento com entrada somente numérica, máscara dd/mm/yyyy,
validações comuns (required, min/maxLength, pattern) + validação customizada,
e cálculo automático de idade exibido na label.
- TextFieldCPFValidate
Campo de CPF com entrada somente numérica, máscara 000.000.000-00,
validações comuns (required, min/maxLength, pattern) + validação customizada.
- NotificationSnackbar
Componente que exibe uma notificação no topo da tela utilizando o Snackbar e Alert do Material UI.
---
- ✅ Pronto para produção
- 🎨 Integração com Material UI
- ♿ Foco em acessibilidade
- 🧩 Ideal para design systems
- 🔄 Reutilizável em múltiplos projetos
- 📦 Publicado no npm com versionamento semântico
- 🔐 Preparado para licenciamento por projeto
---
``bash
npm install @pipelinesolucoes/form
ou
yarn add @pipelinesolucoes/form
`
Este pacote foi projetado para:
- padronização de ações e navegação
- reutilização entre projetos
- evolução incremental de UI
- integração com temas e tokens de design
Pode ser utilizado de forma isolada ou como parte de um design system maior.
---
Este pacote é publicamente acessível no npm, porém:
O uso comercial é licenciado por projeto.
O que isso significa?
O pacote pode ser instalado e avaliado livremente.
Para uso em projetos comerciais, é necessária a aquisição de uma licença válida por projeto.
Definição de projeto
Projeto = 1 aplicação em produção
(ex.: site institucional, sistema interno ou aplicação SaaS).
Ambientes de desenvolvimento, staging e homologação estão incluídos no mesmo projeto.
---
✔ Uso em 1 projeto
✔ Atualizações enquanto a licença estiver ativa
✔ Correções de bugs
✔ Suporte básico
✔ Evolução contínua do pacote
---
Após adquirir a licença, você receberá um Project ID e uma License Key.
No projeto, configure as variáveis de ambiente:
PIPESOL_PROJECT_ID=meu-projeto
PIPESOL_form_LICENSE_KEY=SUA-LICENSE-KEY-AQUI
Atualmente, a validação é local e não bloqueante, servindo como preparação para automação futura.
---
Este projeto segue Semantic Versioning (SemVer):
1.0.1 – Correção de bugs
1.1.0 – Nova funcionalidade compatível
2.0.0 – Mudança incompatível
1.0.0-beta.x – Versões beta
Para listar as versões publicadas:
`
npm view @pipelinesolucoes/form versions --json
Este pacote é publicado exclusivamente via CI/CD utilizando GitHub Actions.
Características do processo:
- Publicação apenas por tags Git (vX.Y.Z)
- Autenticação via Trusted Publishing (OIDC)
- Nenhum token npm armazenado
- Tokens clássicos desabilitados
- Autenticação em dois fatores (2FA) obrigatória
- Publicações seguras, rastreáveis e reprodutíveis
---
## 📬 Aquisição de licença e contato
Para adquirir uma licença comercial ou obter mais informações:
📧 contato@pipelinesolucoes.com.br
🌐 https://www.pipelinesolucoes.com.br
---
Copyright © Pipeline Soluções
Este software está sujeito a licença comercial por projeto.
Consulte o arquivo LICENSE para mais informações.
`
Se você quiser, eu também posso gerar agora o arquivo (texto curto e claro) no mesmo padrão profissional pra você copiar e colar como LICENSE no repo.``