forlogic-core 3.0.11 → 4.0.0

package/docs/design-system/notifications-feedback.md

@@ -1,139 +0,0 @@
-<!-- ⚠️ ARQUIVO GERADO AUTOMATICAMENTE — NÃO EDITAR MANUALMENTE -->
-<!-- Fonte: src/design-system/docs/ | Regenerar: npx tsx scripts/generate-ds-docs.ts -->
-
-# Notifications & Feedback
-
-Categoria: **Notifications & Feedback** | 4 componentes
-
-### Toast
-
-Componente de notificação toast usando Sonner. Feedback temporário e não bloqueante que informa rapidamente o usuário sem competir visualmente com outros Toasts.
-
-**Uso:**
-```tsx
-import { toast } from "sonner"
-
-// Informativo (BG #FFFFFF)
-toast("Mensagem simples")
-toast.info("Informação importante")
-
-// Sucesso (BG #E0FBE8)
-toast.success("Operação concluída")
-
-// Alerta (BG #FEF3C8)
-toast.warning("Atenção necessária")
-
-// Erro (BG #FEE1E1)
-toast.error("Algo deu errado")
-```
-
-**Props:**
-| Prop | Tipo | Padrão | Descrição |
-|------|------|--------|-----------|
-| `message` | `string | ReactNode` | - | Texto principal ou conteúdo do toast. |
-| `description` | `string | ReactNode` | - | Descrição adicional exibida abaixo do título. |
-| `action` | `{ label: string, onClick: () => void }` | - | Botão de ação principal. |
-| `cancel` | `{ label: string, onClick: () => void }` | - | Botão de cancelamento secundário. |
-| `duration` | `number` | 4000 | Duração em ms antes de dispensar. Use Infinity para persistir. |
-| `closeButton` | `boolean` | false | Exibe botão X para fechar o toast. |
-| `icon` | `ReactNode` | - | Ícone personalizado para o toast. |
-| `id` | `string | number` | - | ID único para atualizar ou dispensar o toast. |
-| `onDismiss` | `(toast) => void` | - | Callback executado quando o toast é dispensado. |
-| `onAutoClose` | `(toast) => void` | - | Callback executado quando o toast fecha automaticamente. |
-
-**Exemplos:**
-```tsx
-// Toast é um feedback temporário e não bloqueante
-// - Informa rapidamente o usuário
-// - Não compete visualmente com outros Toasts
-// - Empilhamento vertical sem sobreposição
-// - Ordem previsível: mais recente no topo
-```
-```tsx
-// Empilhamento vertical com espaçamento consistente
-toast.success(
-```
-```tsx
-// Configuração de posição no Toaster:
-<Sonner
-  position=
-```
-
-**Acessibilidade:**
-- Utiliza ARIA live regions para anunciar toasts aos leitores de tela
-- Dispensável via tecla Escape
-- Auto-dispensa com duração configurável respeitando usabilidade
-- Suporte a swipe para dispensar em dispositivos touch
-- Respeita prefers-reduced-motion do sistema operacional
-- Foco gerenciado corretamente quando toast contém elementos interativos
-
-**Notas:**
-- Informativo (#FFFFFF): toast() e toast.info() - Para informações contextuais e notificações neutras
-- Sucesso (#E0FBE8): toast.success() - Para feedback de operações bem-sucedidas
-- Alerta (#FEF3C8): toast.warning() - Para alertas que requerem atenção do usuário
-- Erro (#FEE1E1): toast.error() - Para erros e falhas, considere incluir ação de retry
-- Use toast.promise() para operações assíncronas com feedback de loading
-- Mantenha mensagens curtas e objetivas (máximo 2 linhas)
-- Forneça ação de 
--  para operações destrutivas quando possível
-- Evite usar duration: Infinity sem closeButton ou action para dispensar
-- 🎨 **Padrão v2**: Toasts possuem 
--  como identidade visual herdada da v2.
-
-> Fonte: `src\design-system\docs\components\ToastDoc.tsx`
-
----
-
-### Updates Notification
-
-Botão com popover para exibir notificações de atualização das aplicações. Possui dois modos: automático (self-contained, busca dados da API sozinho) e controlado (recebe dados via props).
-
-**Uso:**
-```tsx
-// Modo automático — basta importar e usar, sem props
-// O componente busca dados da API internamente usando useAuth() e useUpdatesNotification()
-import { UpdatesNotification } from 'forlogic-core';
-
-<UpdatesNotification />
-
-// Modo controlado — para testes, docs ou lógica customizada
-<UpdatesNotification
-  updates={[{ id: '1', title: 'Nova versão', text: 'Descrição' }]}
-  badgeCount={1}
-  onOpen={() => markAsViewed()}
-  onViewAll={() => navigate(\`/\${alias}/up/view\`)}
-/>
-```
-
-**Exemplos:**
-```tsx
-import { UpdatesNotification } from
-```
-
-**Notas:**
-- O componente possui dois modos: automático (sem props) e controlado (com props). O modo é determinado pela presença da prop updates.
-- No modo automático, o componente usa useAuth() para obter o alias e useUpdatesNotification() para buscar dados da API.
-- No modo controlado, todas as props são fornecidas externamente — útil para testes e documentação.
-- O tipo canônico é UpdateNotificationItem (id, title, text), exportado do hook. UpdateNotification é um alias deprecated.
-- No modo automático, onOpen chama markAsVisualized (POST Updates/userVisualized/3/undefined) e onViewAll abre o app Common V5 em nova aba ({commonV5AppUrl}{alias}/up/view), único app que hospeda a página de atualizações. Apps que tenham a própria rota podem passar viewAllPath para navegar internamente.
-- O ícone utilizado é Coffee do Lucide React — não requer fontes externas nos projetos consumidores.
-- O hook useUpdatesNotification também é exportado separadamente para uso avançado.
-- Todas as chamadas à API incluem o header x-waf-rate (base64 do campo sub do JWT), exigido pelo WAF da API legada.
-- Em caso de 401, o hook faz retry automático regenerando o token via QualiexErrorInterceptor.
-- Em produção, o componente deve ser colocado no AppHeader — já está integrado no forlogic-core.
-
-> Fonte: `src\design-system\docs\components\UpdatesNotificationDoc.tsx`
-
----
-
-### Electronic Signature
-
-*Documentação não extraída automaticamente. Consulte o Design System interativo em `/ds`.*
-
----
-
-### ErrorBoundary
-
-*Documentação não extraída automaticamente. Consulte o Design System interativo em `/ds`.*
-
----

package/docs/design-system/patterns/README.md

@@ -1,53 +0,0 @@
-# Design System — Padrões Universais
-
-> Padrões obrigatórios para todos os projetos que consomem `forlogic-core`.
-> Acessível via cross-project: `@Admin docs/design-system/patterns/`
-
-## Índice
-
-### Componentes
-
-| Arquivo | Descrição |
-|---------|-----------|
-| [action-button.md](action-button.md) | Uso obrigatório do ActionButton em tabelas |
-| [alertdialog-deletion.md](alertdialog-deletion.md) | AlertDialog para exclusões permanentes |
-| [baseform-usage.md](baseform-usage.md) | BaseForm — formulário dinâmico CRUD |
-| [baseform-custom-fields.md](baseform-custom-fields.md) | Campos customizados no BaseForm |
-| [combo-tree.md](combo-tree.md) | ComboTree — seleção hierárquica |
-| [delete-confirmation.md](delete-confirmation.md) | Dialog de confirmação de exclusão |
-| [dialog-structure.md](dialog-structure.md) | Tamanhos e estrutura obrigatória do Dialog |
-| [dialog-variants.md](dialog-variants.md) | Variantes semânticas do Dialog |
-| [pagination.md](pagination.md) | Paginação padronizada |
-
-### Padrões de Layout & Scroll
-
-| Arquivo | Descrição |
-|---------|-----------|
-| [dialog-body-scroll.md](dialog-body-scroll.md) | Scroll interno em Dialogs |
-| [body-content-scroll.md](body-content-scroll.md) | Scroll em páginas (BodyContent) |
-| [single-scroll.md](single-scroll.md) | Padrão de scroll único no viewport |
-
-### Padrões CRUD
-
-| Arquivo | Descrição |
-|---------|-----------|
-| [crud-toolbar.md](crud-toolbar.md) | Layout 3 zonas da toolbar |
-| [crud-bulk-actions.md](crud-bulk-actions.md) | Ações em lote via dropdown |
-| [crud-defaults.md](crud-defaults.md) | Defaults obrigatórios (resize, sort, etc.) |
-| [crud-config-props.md](crud-config-props.md) | Props padronizadas de configuração |
-
-### Setup & Configuração
-
-| Arquivo | Descrição |
-|---------|-----------|
-| [core-providers.md](core-providers.md) | Setup obrigatório do CoreProviders |
-| [vite-tailwind-setup.md](vite-tailwind-setup.md) | Configuração Vite + Tailwind |
-| [i18n-setup.md](i18n-setup.md) | Setup de internacionalização |
-| [feature-flags.md](feature-flags.md) | Feature flags disponíveis |
-| [header-metadata.md](header-metadata.md) | Padrão de título/subtítulo via header |
-
-### Referência
-
-| Arquivo | Descrição |
-|---------|-----------|
-| [components-registry.md](components-registry.md) | Registry de componentes consolidados |

package/docs/design-system/patterns/action-button.md

@@ -1,22 +0,0 @@
-# Padrão: ActionButton para Tabelas
-
-Uso de `ActionButton` é **OBRIGATÓRIO** para menus de ação em linhas de tabela.
-
-```tsx
-// ❌ PROIBIDO - botão genérico com ícone manual
-<Button variant="ghost" size="icon">
-  <MoreHorizontal className="h-4 w-4" />
-</Button>
-
-// ✅ CORRETO - ActionButton padronizado
-import { ActionButton } from 'forlogic-core';
-
-<ActionButton
-  items={[
-    { label: 'Editar', icon: Edit, onClick: handleEdit },
-    { label: 'Excluir', icon: Trash, onClick: handleDelete, variant: 'destructive' }
-  ]}
-/>
-```
-
-**Motivo**: Garante mesma estética e comportamento em todas as tabelas do sistema.

package/docs/design-system/patterns/alertdialog-deletion.md

@@ -1,46 +0,0 @@
-# Padrão: AlertDialog para Exclusão Permanente
-
-AlertDialog é usado **apenas** para exclusões permanentes que requerem digitação de confirmação:
-
-```tsx
-<AlertDialog open={open} onOpenChange={setOpen}>
-  <AlertDialogContent>
-    <AlertDialogHeader className="border-b pb-4">
-      <AlertDialogTitle className="text-center">
-        Exclusão Permanente
-      </AlertDialogTitle>
-    </AlertDialogHeader>
-    
-    <div className="py-4 space-y-4">
-      <div className="flex justify-center">
-        <AlertTriangle className="h-12 w-12 text-destructive" />
-      </div>
-      <AlertDialogDescription className="text-center">
-        Esta ação é irreversível. Digite <strong>EXCLUIR</strong> para confirmar.
-      </AlertDialogDescription>
-      <Input
-        value={confirmation}
-        onChange={(e) => setConfirmation(e.target.value)}
-        placeholder="Digite EXCLUIR"
-        className="text-center"
-      />
-    </div>
-    
-    <AlertDialogFooter>
-      <AlertDialogCancel>Cancelar</AlertDialogCancel>
-      <AlertDialogAction
-        disabled={confirmation !== 'EXCLUIR'}
-        onClick={handlePermanentDelete}
-        className="bg-destructive hover:bg-destructive/90"
-      >
-        Excluir Permanentemente
-      </AlertDialogAction>
-    </AlertDialogFooter>
-  </AlertDialogContent>
-</AlertDialog>
-```
-
-**Quando usar:**
-- ✅ Exclusão de dados sem possibilidade de recuperação
-- ✅ Ações destrutivas em massa críticas
-- ❌ NÃO usar para soft deletes (usar Dialog padrão)

package/docs/design-system/patterns/baseform-custom-fields.md

@@ -1,59 +0,0 @@
-# Padrão: BaseForm — Campos Customizados
-
-Campos customizados no BaseForm usam `type: 'custom'` com `component` ou `render`:
-
-```tsx
-// Opção 1: Componente externo
-{
-  name: 'module_id',
-  label: 'Módulo',
-  type: 'custom',
-  required: true,
-  component: ModuleCombobox,
-  componentProps: {
-    placeholder: 'Selecione...',
-  },
-}
-
-// Opção 2: Props dinâmicas baseadas em formData
-{
-  name: 'file',
-  label: 'Arquivo',
-  type: 'custom',
-  component: FileUpload,
-  componentProps: (formData) => ({
-    required: !formData?.id,
-    accept: '.pdf,.doc',
-  }),
-}
-
-// Opção 3: Render function inline
-{
-  name: 'priority',
-  label: 'Prioridade',
-  type: 'custom',
-  render: ({ value, onChange, error }) => (
-    <div className="flex gap-2">
-      {['low', 'medium', 'high'].map(p => (
-        <Button
-          key={p}
-          variant={value === p ? 'default' : 'outline'}
-          onClick={() => onChange(p)}
-        >
-          {p}
-        </Button>
-      ))}
-    </div>
-  ),
-}
-```
-
-**Interface do componente customizado:**
-```tsx
-interface CustomFieldProps {
-  value: any;
-  onChange: (value: any) => void;
-  error?: string;
-  disabled?: boolean;
-}
-```

package/docs/design-system/patterns/baseform-usage.md

@@ -1,42 +0,0 @@
-# Padrão: BaseForm — Formulário Dinâmico
-
-BaseForm é o formulário dinâmico do sistema CRUD, configurado via `sections` e `fields`.
-
-```tsx
-import BaseForm from 'forlogic-core/crud/components/BaseForm';
-
-const sections: FormSection[] = [
-  {
-    id: 'basic',
-    title: 'Informações Básicas',
-    fields: [
-      { name: 'title', label: 'Título', type: 'text', required: true },
-      { name: 'email', label: 'E-mail', type: 'email' },
-      { name: 'is_active', label: 'Ativo', type: 'switch' },
-    ],
-  },
-];
-
-<BaseForm
-  title="Novo Item"
-  sections={sections}
-  initialData={data}
-  open={isOpen}
-  onSubmit={handleSubmit}
-  onCancel={() => setIsOpen(false)}
-/>
-```
-
-**Tipos de campo suportados:**
-`text`, `email`, `password`, `number`, `textarea`, `select`, `multiselect`, `date`, `datetime-local`, `switch`, `checkbox`, `color`, `color-picker`, `icon-picker`, `user-select`, `custom`
-
-**Grupos de campos:**
-```tsx
-{
-  name: 'row1',
-  type: 'group',
-  layout: 'horizontal', // ou 'vertical'
-  wrapperClassName: 'col-span-full',
-  fields: [...]
-}
-```

package/docs/design-system/patterns/body-content-scroll.md

@@ -1,56 +0,0 @@
-# Padrão: Scroll em Páginas (BodyContent)
-
-## Quando Usar Cada Abordagem
-
-| Cenário | Componente | Classes |
-|---------|------------|---------|
-| **Página nova (Design System)** | `BodyContent` + `ContentContainer` | Padrão, sem classes extras |
-| **Página legada (design próprio)** | `BodyContent` | `className="bg-transparent p-0"` |
-| **Módulo customizado** | `div` simples | `className="h-full overflow-y-auto"` |
-
-## Exemplos
-
-### ✅ Página Nova (Design System Completo)
-```tsx
-import { BodyContent, ContentContainer } from 'forlogic-core';
-
-<BodyContent breadcrumbs={[{ label: 'Home', href: '/' }, { label: 'Página' }]}>
-  <ContentContainer title="Título" subtitle="Descrição">
-    {/* Conteúdo */}
-  </ContentContainer>
-</BodyContent>
-```
-
-### ✅ Página Legada (Preservar Design Original)
-```tsx
-import { BodyContent } from 'forlogic-core';
-
-<BodyContent className="bg-transparent p-0">
-  {/* Conteúdo original mantido sem alterações */}
-  <div className="p-6">
-    <h1>Título Original</h1>
-  </div>
-</BodyContent>
-```
-
-### ✅ Container Mínimo (Sem BodyContent)
-```tsx
-<div className="h-full overflow-y-auto">
-  {/* Conteúdo original */}
-</div>
-```
-
-## ❌ Erro Comum
-```tsx
-// ERRADO: ContentContainer em página com design próprio
-<BodyContent>
-  <ContentContainer>
-    {/* Resultado: fundo branco, bordas, padding extra indesejados */}
-  </ContentContainer>
-</BodyContent>
-```
-
-## Regra de Ouro
-- `ContentContainer` adiciona: fundo branco, borda, sombra, padding
-- Use apenas quando o design da página DEVE seguir esse padrão
-- Para páginas legadas: `BodyContent className="bg-transparent p-0"`

package/docs/design-system/patterns/combo-tree.md

@@ -1,23 +0,0 @@
-# Padrão: ComboTree — Seleção Hierárquica
-
-O componente `ComboTree` permite a seleção de dados hierárquicos com busca recursiva e separação entre expansão (chevron) e seleção (label).
-
-## Layout
-- O **chevron** (▶/▼) fica no **final da linha** (à direita), indicando que o nó tem filhos
-- O **check** (✓) e o **ícone** ficam no início, seguidos pelo label
-- Nós sem filhos não exibem chevron
-
-## Ícones customizados por nó
-
-- `icon` — ícone padrão (nó colapsado e não selecionado)
-- `iconOpen` — ícone quando o nó está **expandido** (fallback para `icon`)
-- `iconSelected` — ícone quando o nó está **selecionado** (fallback para `iconOpen` se expandido, senão `icon`)
-- `iconClassName` — classe CSS para cor/estilo do ícone (fallback: `text-muted-foreground`)
-
-Prioridade de resolução:
-- Selecionado + Expandido → `iconSelected ?? iconOpen ?? icon`
-- Selecionado + Colapsado → `iconSelected ?? icon`
-- Não selecionado + Expandido → `iconOpen ?? icon`
-- Não selecionado + Colapsado → `icon`
-
-A busca preserva e auto-expande o caminho dos ancestrais para os itens encontrados.

package/docs/design-system/patterns/components-registry.md

@@ -1,17 +0,0 @@
-# Referência: Registry de Componentes Consolidados
-
-Design System mantém um registro de componentes documentados em conjunto sob entradas únicas:
-
-- **Breadcrumb** (documenta Breadcrumb e PageBreadcrumb)
-- **Calendar & Date Picker** (documenta Calendar e DatePicker)
-- **Combobox** (documenta Combobox com Command usado internamente)
-- **Toggle & Group** (documenta Toggle e ToggleGroup)
-- **Skeleton** (documenta base Skeleton e todas as variantes)
-- **AppSidebar** (documenta AppSidebar, Sidebar base, SidebarProvider, SidebarMenu*, Collapsible)
-- **Accordion** (documenta Accordion e Collapsible)
-- **Input** (documenta Input, InputGroup, InputGroupAddon, InputGroupButton)
-- **Grid & Stack** (documenta Grid e Stack layout components)
-- **Dialog** (documenta Dialog, AlertDialog, Sheet, Drawer)
-- **Tabs** (documenta Tabs e TabPageLayout)
-
-Este registro deve ser consultado antes de criar nova documentação para evitar duplicatas.