@seniorsistemas/components-ai 0.0.0-master-d4a804fe

package/CHANGELOG.md

@@ -0,0 +1,101 @@
+# Changelog
+
+Todas as mudanças notáveis neste projeto serão documentadas neste arquivo.
+
+O formato é baseado em [Keep a Changelog](https://keepachangelog.com/pt-BR/1.0.0/),
+e este projeto adere ao [Semantic Versioning](https://semver.org/lang/pt-BR/).
+
+## [1.0.0] - 2026-02-13
+
+### 🎉 Lançamento Inicial
+
+Primeira versão da biblioteca `@seniorsistemas/components-ia`.
+
+### ✨ Adicionado
+
+#### Componentes
+- **DynamicFormComponent** - Formulário dinâmico com suporte a:
+  - Múltiplos tipos de campo (text, number, date, select, lookup, etc)
+  - Modos: create, edit, filter, inline-edit
+  - Display modes: inline, dialog, drawer
+  - Suporte a seções colapsáveis
+  - Validações customizadas
+  - Máscaras de input
+  
+- **ExportDialogComponent** - Exportação de dados em Excel e PDF
+- **BulkDeleteDialogComponent** - Exclusão em massa com confirmação
+- **BreadcrumbComponent** - Navegação breadcrumb
+
+#### Serviços
+- **EntityService<T>** - Serviço base genérico para CRUD
+  - `list()` - Listagem com paginação
+  - `getById()` - Buscar por ID
+  - `insert()` - Criar registro
+  - `update()` - Atualizar registro
+  - `delete()` - Excluir registro
+  - `bulkDelete()` - Exclusão em massa
+
+- **TranslationService** - Internacionalização (i18n)
+- **ThemeService** - Gerenciamento de temas light/dark
+- **AuthService** - Autenticação e tokens
+- **PermissionService** - Controle de permissões
+- **CookieService** - Gerenciamento de cookies
+- **SeniorTokenService** - Tokens Senior
+- **MaskService** - Máscaras de input
+
+#### Diretivas
+- **CepMaskDirective** - Máscara de CEP (00000-000)
+- **DocumentMaskDirective** - Máscara de CPF/CNPJ
+- **PhoneMaskDirective** - Máscara de telefone
+
+#### Pipes
+- **TranslatePipe** - Pipe de tradução
+
+#### Interceptors
+- **apiInterceptor** - Interceptor HTTP para API
+
+#### Modelos
+- **BaseEntity** - Interface base para entidades
+- **DynamicFormFieldConfig** - Configuração de campos
+- **DynamicFormSection** - Configuração de seções
+- **FieldType** - Enum de tipos de campo
+- **ColumnOption** - Configuração de colunas
+
+#### Documentação
+- **COMPONENTS.md** - Documentação completa de componentes
+- **EXAMPLES.md** - Exemplos práticos
+- **API.md** - Referência da API
+- **MIGRATION.md** - Guia de migração
+- **README.md** - Documentação principal
+
+### 📦 Configuração
+- Suporte a Angular 18.2+
+- Integração com PrimeNG 18.0+
+- Prefixo de componentes: `sia-`
+- Build otimizado com ng-packagr
+- Assets incluem estilos SCSS e documentação
+
+### 🎨 Estilos
+- Estilos compartilhados para listagens
+- Suporte a temas PrimeNG
+- Responsividade mobile-first
+- Acessibilidade (ARIA)
+
+---
+
+## Tipos de Mudanças
+
+- `✨ Adicionado` - Novas funcionalidades
+- `🔄 Modificado` - Mudanças em funcionalidades existentes
+- `🗑️ Removido` - Funcionalidades removidas
+- `🐛 Corrigido` - Correções de bugs
+- `🔒 Segurança` - Correções de vulnerabilidades
+- `⚠️ Descontinuado` - Funcionalidades que serão removidas
+
+---
+
+## Links
+
+- [Documentação](./docs/COMPONENTS.md)
+- [Exemplos](./docs/EXAMPLES.md)
+- [API Reference](./docs/API.md)

package/CONTRIBUTING.md

@@ -0,0 +1,317 @@
+# Guia de Contribuição
+
+Obrigado por considerar contribuir com `@seniorsistemas/components-ia`! 🎉
+
+## 📋 Índice
+
+- [Código de Conduta](#código-de-conduta)
+- [Como Contribuir](#como-contribuir)
+- [Padrões de Código](#padrões-de-código)
+- [Processo de Pull Request](#processo-de-pull-request)
+- [Estrutura do Projeto](#estrutura-do-projeto)
+
+---
+
+## 📜 Código de Conduta
+
+Este projeto adere a um código de conduta. Ao participar, você concorda em manter um ambiente respeitoso e colaborativo.
+
+---
+
+## 🤝 Como Contribuir
+
+### Reportar Bugs
+
+Se encontrar um bug, por favor abra uma issue com:
+
+- Descrição clara do problema
+- Passos para reproduzir
+- Comportamento esperado vs atual
+- Versão da biblioteca e Angular
+- Screenshots (se aplicável)
+
+### Sugerir Melhorias
+
+Para sugerir novas funcionalidades:
+
+- Descreva o caso de uso
+- Explique por que seria útil
+- Forneça exemplos de uso
+- Considere alternativas
+
+### Contribuir com Código
+
+1. **Fork o repositório**
+2. **Clone seu fork**
+   ```bash
+   git clone https://github.com/seu-usuario/components-ia.git
+   ```
+3. **Crie uma branch**
+   ```bash
+   git checkout -b feature/minha-feature
+   ```
+4. **Faça suas alterações**
+5. **Commit suas mudanças**
+   ```bash
+   git commit -m "feat: adiciona nova funcionalidade"
+   ```
+6. **Push para o GitHub**
+   ```bash
+   git push origin feature/minha-feature
+   ```
+7. **Abra um Pull Request**
+
+---
+
+## 💻 Padrões de Código
+
+### Convenções de Nomenclatura
+
+- **Componentes**: PascalCase (ex: `DynamicFormComponent`)
+- **Serviços**: PascalCase com sufixo Service (ex: `EntityService`)
+- **Interfaces**: PascalCase (ex: `DynamicFormFieldConfig`)
+- **Enums**: PascalCase (ex: `FieldType`)
+- **Variáveis**: camelCase (ex: `formFields`)
+- **Constantes**: UPPER_SNAKE_CASE (ex: `DEFAULT_PAGE_SIZE`)
+
+### Estrutura de Arquivos
+
+```
+component-name/
+├── component-name.component.ts
+├── component-name.component.html
+├── component-name.component.scss
+├── component-name.component.spec.ts
+└── README.md (opcional)
+```
+
+### TypeScript
+
+- Use tipos explícitos sempre que possível
+- Evite `any` (use `unknown` se necessário)
+- Use interfaces para objetos complexos
+- Documente funções públicas com JSDoc
+
+```typescript
+/**
+ * Cria um novo registro
+ * @param entity - Dados da entidade
+ * @returns Observable com a entidade criada
+ */
+insert(entity: Partial<T>): Observable<T> {
+  return this.http.post<T>(this.apiUrl, entity);
+}
+```
+
+### HTML/Templates
+
+- Use formatação consistente
+- Prefira `*ngIf` e `*ngFor` ao invés de `ng-template`
+- Use `trackBy` em `*ngFor` para performance
+- Mantenha templates simples (lógica no component)
+
+### SCSS
+
+- Use variáveis para cores e espaçamentos
+- Siga a metodologia BEM quando apropriado
+- Evite seletores profundos
+- Use mixins para código reutilizável
+
+### Commits
+
+Siga o padrão [Conventional Commits](https://www.conventionalcommits.org/):
+
+```
+<tipo>(<escopo>): <descrição>
+
+[corpo opcional]
+
+[rodapé opcional]
+```
+
+**Tipos:**
+- `feat`: Nova funcionalidade
+- `fix`: Correção de bug
+- `docs`: Documentação
+- `style`: Formatação (não afeta código)
+- `refactor`: Refatoração
+- `test`: Testes
+- `chore`: Manutenção
+
+**Exemplos:**
+```
+feat(dynamic-form): adiciona suporte a validação assíncrona
+fix(export-dialog): corrige exportação de datas
+docs(readme): atualiza exemplos de uso
+refactor(entity-service): melhora tipagem genérica
+test(breadcrumb): adiciona testes unitários
+```
+
+---
+
+## 🔄 Processo de Pull Request
+
+### Checklist
+
+Antes de submeter um PR, verifique:
+
+- [ ] Código segue os padrões do projeto
+- [ ] Testes foram adicionados/atualizados
+- [ ] Documentação foi atualizada
+- [ ] Build passa sem erros
+- [ ] Testes passam
+- [ ] Commit messages seguem o padrão
+- [ ] Branch está atualizada com main
+
+### Revisão
+
+- PRs serão revisados por mantenedores
+- Feedback será fornecido via comentários
+- Mudanças podem ser solicitadas
+- Após aprovação, o PR será merged
+
+### Após o Merge
+
+- Sua contribuição será incluída no próximo release
+- Você será creditado no CHANGELOG
+- Obrigado pela contribuição! 🎉
+
+---
+
+## 📁 Estrutura do Projeto
+
+```
+components-ia/
+├── projects/
+│   └── seniorsistemas/
+│       └── components-ia/
+│           ├── src/
+│           │   ├── lib/
+│           │   │   ├── components/     # Componentes
+│           │   │   ├── services/       # Serviços
+│           │   │   ├── directives/     # Diretivas
+│           │   │   ├── pipes/          # Pipes
+│           │   │   ├── models/         # Interfaces/Types
+│           │   │   ├── interceptors/   # Interceptors
+│           │   │   ├── config/         # Configurações
+│           │   │   └── styles/         # Estilos globais
+│           │   └── public-api.ts       # API pública
+│           ├── docs/                   # Documentação
+│           ├── package.json
+│           ├── README.md
+│           ├── CHANGELOG.md
+│           └── CONTRIBUTING.md
+├── angular.json
+├── package.json
+└── tsconfig.json
+```
+
+---
+
+## 🧪 Testes
+
+### Executar Testes
+
+```bash
+npm run test
+```
+
+### Cobertura
+
+```bash
+npm run test:coverage
+```
+
+### Escrever Testes
+
+- Teste comportamento, não implementação
+- Use mocks para dependências
+- Teste casos de sucesso e erro
+- Mantenha testes simples e legíveis
+
+```typescript
+describe('DynamicFormComponent', () => {
+  it('should create form with fields', () => {
+    const fields: DynamicFormFieldConfig[] = [
+      { name: 'name', label: 'Nome', type: FieldType.TEXT, cols: 12 }
+    ];
+    component.formFields = fields;
+    component.ngOnInit();
+    expect(component.getForm().get('name')).toBeDefined();
+  });
+});
+```
+
+---
+
+## 📖 Documentação
+
+### Atualizar Documentação
+
+Ao adicionar/modificar funcionalidades:
+
+1. Atualize `docs/COMPONENTS.md`
+2. Adicione exemplos em `docs/EXAMPLES.md`
+3. Atualize `docs/API.md` se necessário
+4. Atualize `CHANGELOG.md`
+5. Atualize `README.md` se relevante
+
+### Escrever Documentação
+
+- Use linguagem clara e objetiva
+- Forneça exemplos práticos
+- Inclua casos de uso comuns
+- Documente parâmetros e retornos
+- Adicione screenshots quando útil
+
+---
+
+## 🚀 Build e Publicação
+
+### Build Local
+
+```bash
+npm run build
+```
+
+### Testar Localmente
+
+```bash
+# Na biblioteca
+cd dist/seniorsistemas/components-ia
+npm link
+
+# No projeto de teste
+npm link @seniorsistemas/components-ia
+```
+
+### Publicação
+
+Apenas mantenedores podem publicar:
+
+```bash
+npm run build:prod
+cd dist/seniorsistemas/components-ia
+npm publish
+```
+
+---
+
+## 💡 Dicas
+
+- Comece com issues marcadas como `good first issue`
+- Pergunte se tiver dúvidas
+- Mantenha PRs focados e pequenos
+- Seja paciente durante a revisão
+- Aprenda com o feedback
+
+---
+
+## 📞 Contato
+
+- Issues: [GitHub Issues](https://github.com/senior-sistemas/components-ia/issues)
+- Discussões: [GitHub Discussions](https://github.com/senior-sistemas/components-ia/discussions)
+
+---
+
+Obrigado por contribuir! 🙏

package/README.md

@@ -0,0 +1,161 @@
+# @seniorsistemas/components-ia
+
+Biblioteca de componentes reutilizáveis com inteligência artificial para aplicações da Senior Sistemas.
+
+## 📦 Instalação
+
+```bash
+npm install @seniorsistemas/components-ia
+```
+
+## 🎯 Objetivo
+
+Esta biblioteca fornece componentes, serviços e utilitários comuns para acelerar o desenvolvimento de aplicações, eliminando duplicação de código e garantindo consistência entre projetos.
+
+## 🚀 Recursos
+
+### Componentes
+- **DynamicFormComponent** - Formulário dinâmico com múltiplos modos e tipos de campo
+- **ExportDialogComponent** - Exportação de dados (Excel, PDF)
+- **BulkDeleteDialogComponent** - Exclusão em massa
+- **BreadcrumbComponent** - Navegação breadcrumb
+
+### Serviços
+- **EntityService** - Serviço base genérico para CRUD
+- **AuthService** - Autenticação
+- **TranslationService** - Internacionalização
+- **ThemeService** - Gerenciamento de temas
+- **PermissionService** - Controle de permissões
+
+### Diretivas
+- **CepMaskDirective** - Máscara de CEP
+- **DocumentMaskDirective** - Máscara de CPF/CNPJ
+- **PhoneMaskDirective** - Máscara de telefone
+
+### Pipes
+- **TranslatePipe** - Pipe de tradução
+
+## 📖 Uso Básico
+
+### Importar o módulo
+
+```typescript
+import { AngularComponentsModule } from '@seniorsistemas/components-ia';
+
+@NgModule({
+  imports: [
+    AngularComponentsModule
+  ]
+})
+export class AppModule { }
+```
+
+### Exemplo: Formulário Dinâmico
+
+```typescript
+import { Component } from '@angular/core';
+import { DynamicFormFieldConfig, FieldType } from '@seniorsistemas/components-ia';
+
+@Component({
+  selector: 'app-product-form',
+  template: `
+    <sia-dynamic-form
+      [formFields]="formFields"
+      [mode]="'create'"
+      (onSubmit)="handleSubmit($event)"
+    ></sia-dynamic-form>
+  `
+})
+export class ProductFormComponent {
+  formFields: DynamicFormFieldConfig[] = [
+    {
+      name: 'name',
+      label: 'Nome do Produto',
+      type: FieldType.TEXT,
+      required: true,
+      cols: 12
+    },
+    {
+      name: 'price',
+      label: 'Preço',
+      type: FieldType.NUMBER,
+      required: true,
+      cols: 6
+    }
+  ];
+
+  handleSubmit(formValue: any): void {
+    console.log('Produto criado:', formValue);
+  }
+}
+```
+
+### Exemplo: Formulário em Dialog
+
+```typescript
+<sia-dynamic-form
+  [(visible)]="showDialog"
+  [formFields]="formFields"
+  [entity]="selectedEntity"
+  [mode]="selectedEntity ? 'edit' : 'create'"
+  [displayMode]="'dialog'"
+  [dialogHeader]="'Novo Produto'"
+  (onSubmit)="handleSubmit($event)"
+></sia-dynamic-form>
+```
+
+## 📚 Documentação Completa
+
+A biblioteca inclui documentação detalhada na pasta `docs/`:
+
+- **[COMPONENTS.md](./docs/COMPONENTS.md)** - Documentação completa de cada componente
+- **[EXAMPLES.md](./docs/EXAMPLES.md)** - Exemplos práticos de uso
+- **[API.md](./docs/API.md)** - Referência completa da API
+- **[MIGRATION.md](./docs/MIGRATION.md)** - Guia de migração
+
+### Acessando a Documentação
+
+Após instalar a biblioteca, a documentação estará disponível em:
+```
+node_modules/@seniorsistemas/components-ia/docs/
+```
+
+Você pode abrir os arquivos diretamente no seu editor:
+```bash
+code node_modules/@seniorsistemas/components-ia/docs/COMPONENTS.md
+code node_modules/@seniorsistemas/components-ia/docs/EXAMPLES.md
+```
+
+## 🛠️ Desenvolvimento
+
+### Build
+
+```bash
+npm run build
+```
+
+### Testes
+
+```bash
+npm run test
+```
+
+## 📋 Requisitos
+
+- Angular 18.2+
+- PrimeNG 18.0+
+- RxJS 7.8+
+
+## 🤝 Contribuindo
+
+Contribuições são bem-vindas! Por favor, leia o [guia de contribuição](./CONTRIBUTING.md) antes de submeter PRs.
+
+## 📄 Licença
+
+MIT © Senior Sistemas
+
+## 🔗 Links
+
+- [Documentação Completa](./docs/COMPONENTS.md)
+- [Exemplos](./docs/EXAMPLES.md)
+- [Changelog](./CHANGELOG.md)