forlogic-core 2.0.6 → 2.0.8

package/.note/memory/patterns/admin-i18n-policy.md

@@ -0,0 +1,20 @@
+# Política de Idioma — Admin, Design System e Lib
+
+## Decisão
+
+| Camada | Idioma | i18n (useTranslation) |
+|--------|--------|-----------------------|
+| **Projeto Admin (`src/`)** | Português (Brasil) — hardcoded | ❌ Não usa |
+| **Design System (`src/design-system/`)** | Português (Brasil) — hardcoded | ❌ Não usa |
+| **Lib (`lib/`)** | Multi-idioma (pt-BR, en-US, es-ES) | ✅ Usa `t()` + JSONs |
+
+## Regras
+
+1. **Nenhum arquivo em `src/`** deve importar `useTranslation` ou usar `t()` — todos os textos são strings fixas em português.
+2. **A documentação interativa do Design System** (páginas `*Doc.tsx`, sidebar, home) é escrita diretamente em português, sem chaves de tradução.
+3. **A lib (`lib/`)** mantém o sistema completo de i18n com namespaces, JSONs por idioma e integração com Tolgee, pois é consumida por projetos que precisam de múltiplos idiomas.
+4. **Arquivos de tradução da lib** (`lib/i18n/locales/`) contêm apenas chaves usadas pelos componentes internos da lib.
+
+## Contexto
+
+O Admin é um painel interno da Forlogic usado exclusivamente em português. Manter i18n no Admin adiciona complexidade sem benefício. A lib, por outro lado, é distribuída para projetos consumidores que operam em múltiplos idiomas.

package/.note/memory/patterns/i18n-architecture.md

@@ -0,0 +1,3 @@
+# i18n Architecture
+
+A internacionalização utiliza namespaces 'core' (lib) e 'app' (consumidor). Traduções do consumidor são modularizadas em arquivos JSON por feature e mescladas via `mergeTranslationFiles`. Usa apenas i18next + JSONs estáticos (sem serviço externo de tradução). É mandatório o uso do hook `useTranslation` da biblioteca, garantindo fallback e suporte a flags de depuração. Os arquivos de tradução da biblioteca (`lib/i18n/locales/`) são restritos exclusivamente a chaves utilizadas por seus componentes internos; chaves órfãs ou termos de domínio de negócio devem ser geridos e traduzidos nos projetos consumidores no namespace 'app'.

package/README.md

@@ -1,277 +1,63 @@
-# forlogic-core — Knowledge Base
+# forlogic-core
 
-> **Documento de referência** para projetos que consomem `forlogic-core`.
-> Cole este conteúdo como Custom Knowledge no Lovable ou use como README.md com Claude Code.
+> Biblioteca compartilhada de componentes, hooks, serviços e configuração para projetos Forlogic/Qualiex.
 
 ---
 
-## 🔗 Cross-Project: Projeto Admin (DS + Lib)
+## Schema do Projeto
 
-> **Para consultar componentes, props, tipos, exemplos e implementação**: use cross-project (`@Admin`) para ler arquivos do projeto **"Admin"** (`qualiex-admin`).
-
-### Caminhos úteis no projeto Admin
-
-| O que procurar | Caminho no Admin |
-|----------------|------------------|
-| Código-fonte dos componentes UI | `lib/components/ui/` |
-| Sistema CRUD | `lib/crud/` |
-| Barrel exports (lista completa) | `lib/exports/ui.ts`, `lib/exports/index.ts` |
-| Documentação MD do Design System | `docs/design-system/` |
-| Docs interativos (código-fonte) | `src/design-system/docs/` |
-| Hooks compartilhados | `lib/hooks/` |
-| Providers (CoreProviders) | `lib/providers/` |
-| Serviços (Base, Email, Error) | `lib/services/` |
-| Config Vite/Tailwind | `lib/vite/`, `lib/tailwind/` |
-
----
-
-## 0. Schema do Projeto
-
-> ⚠️ **Substitua `SCHEMA_PADRAO` pelo schema do SEU projeto.**
+> ⚠️ **SCHEMA = `common`**
+>
+> Este é o **único local** onde o schema é definido. Toda query Supabase **DEVE** usar `.schema('common')`.
 
 ```ts
 // ✅ CORRETO
-supabase.schema('SCHEMA_PADRAO').from('tabela').select('*');
+supabase.schema('common').from('tabela').select('*');
 
-// ❌ ERRADO (vai falhar)
+// ❌ ERRADO (vai falhar em produção)
 supabase.from('tabela').select('*');
 ```
 
 ---
 
-## 1. Regras Invioláveis
-
-| Regra | Detalhe |
-|-------|---------|
-| Schema obrigatório | `.schema('SCHEMA_PADRAO')` em toda query Supabase |
-| Sem DELETE físico | Soft delete com `deleted_at` + policy `FOR UPDATE` |
-| Sem índices automáticos | Apenas com aprovação explícita + EXPLAIN ANALYZE |
-| Sem modificar `.env` | Apenas com autorização do usuário |
-| Sem hardcoded admin | Nunca localStorage/sessionStorage para roles |
-| Lib-first | Usar `forlogic-core` antes de criar componente |
-| Import do Supabase | Sempre `getSupabaseClient()` de `forlogic-core` |
-| Import de i18n | Sempre `useTranslation` de `forlogic-core`, nunca de `react-i18next` |
-
----
-
-## 2. RLS — Políticas de Segurança
-
-### Sintaxe obrigatória
-
-- `SELECT` → `USING` | `INSERT` → `WITH CHECK` | `UPDATE` → `USING` + `WITH CHECK`
-- **Nunca** `FOR DELETE`
-- **Sempre** `(SELECT auth.jwt())` com parênteses (evita re-execução por linha)
-
-### Padrão JWT alias (multi-tenancy)
-
-```sql
-CREATE POLICY "table_select" ON SCHEMA_PADRAO.tabela
-FOR SELECT USING (
-  ((SELECT auth.jwt()) ->> 'alias'::text) = alias
-);
-
-CREATE POLICY "table_insert" ON SCHEMA_PADRAO.tabela
-FOR INSERT WITH CHECK (
-  ((SELECT auth.jwt()) ->> 'alias'::text) = alias
-);
-
-CREATE POLICY "table_update" ON SCHEMA_PADRAO.tabela
-FOR UPDATE
-USING (((SELECT auth.jwt()) ->> 'alias'::text) = alias)
-WITH CHECK (((SELECT auth.jwt()) ->> 'alias'::text) = alias);
-```
-
-### Soft delete (padrão obrigatório)
-
-```sql
-ALTER TABLE SCHEMA_PADRAO.tabela ADD COLUMN deleted_at TIMESTAMP WITH TIME ZONE;
-
-CREATE POLICY "table_select" ON SCHEMA_PADRAO.tabela
-FOR SELECT USING (
-  deleted_at IS NULL
-  AND ((SELECT auth.jwt()) ->> 'alias'::text) = alias
-);
-```
-
----
-
-## 3. Convenções SQL
-
-| Tipo | Padrão | Exemplo |
-|------|--------|---------|
-| FK | `id_<singular>` | `id_process`, `id_user` |
-| Boolean | `is_` / `has_` | `is_active`, `has_access` |
-| Timestamps | `created_at`, `updated_at`, `deleted_at` | — |
-| Tabelas | plural, snake_case | `processes`, `user_roles` |
-
----
-
-## 4. Lib-First — forlogic-core
-
-> Antes de criar qualquer componente, verificar se já existe em `forlogic-core`.
-
-### Import correto
-
-```ts
-import {
-  Button, Dialog, Input, Combobox, SplitButton, RichTextEditor,
-  createCrudPage, CrudTable, CrudActionBar, BaseForm,
-  ActionButton, EmptyState, LoadingState, StepSelector,
-  cn, formatDatetime, useTranslation
-} from 'forlogic-core';
-```
-
-### Checklist
-
-- [ ] Pesquisei se existe na forlogic-core?
-- [ ] Verifiquei o Design System (`@Admin docs/design-system/`)?
-- [ ] Pode ser alcançado com props/variantes existentes?
-
-### Exceções (pode criar localmente)
-
-1. Componente específico de negócio (ex: `InvoiceCard`)
-2. Composição de componentes da lib (wrapper Dialog + Form)
-3. Protótipo temporário que será migrado para a lib
-
----
-
-## 5. Design System — Categorias
-
-> Para ver props e exemplos: `@Admin docs/design-system/<arquivo>.md`
-
-| Categoria | Arquivo |
-|-----------|---------|
-| Fundação | `foundation.md` |
-| Botões & Ações | `buttons-actions.md` |
-| Inputs | `inputs.md` |
-| Seletores | `selectors.md` |
-| Data Display | `data-display.md` |
-| Data Grid | `tables-grids.md` |
-| Gráficos & Dashboards | `charts-dashboards.md` |
-| Navegação | `navigation.md` |
-| Dialogs | `dialogs.md` |
-| Notifications & Feedback | `notifications-feedback.md` |
-| Layout | `layout.md` |
-| CRUD | `crud.md` |
-| Plataforma | `platform.md` |
-| Business Components | `domain.md` |
-| Developer Tools | `infra-utils.md` |
-
-### Aliases disponíveis
-
-| Original | Alias(es) |
-|----------|-----------|
-| Combobox | SelectSearch, MultiSelect, EntitySelect, AutoComplete |
-| ComboTree | TreeSelect |
-| StepSelector | Stepper |
-| ActionButton | ActionMenu, RowActions |
-| TruncatedCell | EllipsisText |
-| CrudPrimitiveTable | DataTable |
-| CrudPrimitivePagination | DataPagination |
-| CrudPrimitiveFilterBar | DataFilterBar |
-
----
-
-## 6. Padrões CRUD
-
-### Toolbar — Layout obrigatório de 3 zonas
-
-| Zona | Posição | Conteúdo |
-|------|---------|----------|
-| Esquerda | `justify-start` | Botão "Novo" + Dropdown ações em lote |
-| Centro | `flex-1 max-w-md` | Campo de busca |
-| Direita | `justify-end` | Filtros + Toggle view |
-
-### Defaults
-
-- Column resize/manager: ativados por padrão
-- Paginação: 25 itens/página
-- Busca: no header (na action bar com `showSearch=true`)
-- Ações de linha: sempre usar `ActionButton` da lib
-
----
-
-## 7. Padrões Deprecated
-
-| ❌ Não usar | ✅ Usar |
-|------------|--------|
-| `BulkActionBar` separado | Dropdown no `CrudActionBar` |
-| `<MoreHorizontal>` genérico | `ActionButton` |
-| Paginação manual | `CrudPrimitivePagination` |
-| `StatusSelect` | `Combobox` |
-| `DeleteConfirmationDialog` | `Dialog` |
-| `Searchbar` | `Input` com ícone |
-| `public` schema | `.schema('SCHEMA_PADRAO')` |
-
----
-
-## 8. Configuração — Vite
-
-```ts
-import { createSecurityHeadersPlugin } from 'forlogic-core/vite';
-
-export default defineConfig(({ mode }) => ({
-  plugins: [
-    react(),
-    createSecurityHeadersPlugin(mode === 'development', {
-      supabaseUrls: ['https://SEU_PROJETO.supabase.co'],
-      additionalConnectSrc: ['https://*.qualiex.com'],
-    }),
-  ],
-  resolve: { alias: { '@': path.resolve(__dirname, './src') } },
-  optimizeDeps: { force: true },
-}));
-```
-
----
-
-## 9. Configuração — Tailwind
+## Documentação
 
-```ts
-import { forlogicTailwindPreset, forlogicContentPaths } from 'forlogic-core/tailwind';
-
-export default {
-  presets: [forlogicTailwindPreset],
-  content: [...forlogicContentPaths],
-} satisfies Config;
-```
+| Documento | Caminho | Conteúdo |
+|-----------|---------|----------|
+| **Constituição** | [`spec/constitution.md`](spec/constitution.md) | Regras, convenções e melhores práticas obrigatórias |
+| **Design System** | `docs/design-system/` | Documentação de componentes, props e exemplos |
+| **Design System (visual)** | Rota `/ds` no app | Documentação interativa |
 
 ---
 
-## 10. Configuração — CoreProviders
+## Cross-Project: Projeto Admin (DS + Lib)
 
-```tsx
-import { CoreProviders } from 'forlogic-core';
-import ptBR from './i18n/pt-BR.json';
+> Para consultar componentes, props, tipos, exemplos e implementação: use cross-project (`@Admin`).
 
-function App() {
-  return (
-    <CoreProviders moduleAlias="seu-modulo" appTranslations={{ 'pt-BR': ptBR }}>
-      <BrowserRouter><Routes>{/* ... */}</Routes></BrowserRouter>
-    </CoreProviders>
-  );
-}
-```
-
-### i18n — Resolução: `t('key')` → app → core → fallback
-
----
-
-## 11. Feature Flags
-
-| Variável | Descrição |
-|----------|-----------|
-| `VITE_SHOW_USER_PREFERENCES` | Preferências no menu do usuário |
-| `VITE_I18N_DEBUG_MODE` | Debug de i18n (mostra chaves) |
-| `VITE_IS_QUALIEX` | Logos Qualiex vs Forlogic |
+| O que procurar | Caminho no Admin |
+|----------------|------------------|
+| Código-fonte dos componentes UI | `lib/components/ui/` |
+| Sistema CRUD | `lib/crud/` |
+| Barrel exports (lista completa) | `lib/exports/ui.ts`, `lib/exports/index.ts` |
+| Documentação MD do Design System | `docs/design-system/` |
+| Docs interativos (código-fonte) | `src/design-system/docs/` |
+| Hooks compartilhados | `lib/hooks/` |
+| Providers (CoreProviders) | `lib/providers/` |
+| Serviços (Base, Email, Error) | `lib/services/` |
+| Config Vite/Tailwind | `lib/vite/`, `lib/tailwind/` |
+| Prompt template | `docs/PROMPT_TEMPLATE.md` |
+| Project Knowledge template | `docs/PROJECT_KNOWLEDGE_TEMPLATE.md` |
+| Starter template | `docs/STARTER_TEMPLATE.md` |
+| Prompt de auditoria | `docs/AUDIT_PROMPT.md` |
+| Golden snippets | `docs/design-system/examples.md` |
 
 ---
 
-## 12. Instrução para IA
+## Instrução para IA
 
 **QUANDO** criar ou modificar qualquer arquivo `.tsx` com JSX:
 
-- **SE** contém tabela, listagem ou CRUD → **LER** `@Admin docs/design-system/crud.md` e `@Admin docs/design-system/tables-grids.md` ANTES de gerar código
+- **SE** contém tabela, listagem ou CRUD → **LER** `@Admin docs/design-system/crud.md` e `@Admin docs/design-system/tables-grids.md` ANTES
 - **SE** contém formulário, input ou campo → **LER** `@Admin docs/design-system/inputs.md` e `@Admin docs/design-system/selectors.md` ANTES
 - **SE** contém modal ou confirmação → **LER** `@Admin docs/design-system/dialogs.md` ANTES
 - **SE** contém botões ou ações de linha → **LER** `@Admin docs/design-system/buttons-actions.md` ANTES
@@ -279,25 +65,4 @@ function App() {
 
 **SEMPRE** consultar `@Admin docs/design-system/examples.md` como referência de implementação.
 
-**PROIBIDO** gerar JSX sem ter lido a documentação aplicável acima.
-
 **VALIDAÇÃO pós-geração**: Todo import de componente visual DEVE vir de `forlogic-core`. Se criou componente local que existe na lib, refatore imediatamente.
-
----
-
-## 13. Fontes de Contexto (Cross-Project)
-
-| O que | Onde buscar via `@Admin` |
-|-------|--------------------------|
-| Props e tipos de componentes | `lib/components/ui/<componente>.tsx` |
-| Implementação CRUD | `lib/crud/` |
-| Documentação MD (para IA) | `docs/design-system/*.md` |
-| Exemplos interativos (código) | `src/design-system/docs/*Doc.tsx` |
-| Design System visual | Rota `/ds` no app Admin |
-| Hooks compartilhados | `lib/hooks/` |
-| Configuração de exports | `lib/exports/` |
-| Prompt template | `docs/PROMPT_TEMPLATE.md` |
-| Project Knowledge template | `docs/PROJECT_KNOWLEDGE_TEMPLATE.md` |
-| Starter template | `docs/STARTER_TEMPLATE.md` |
-| Prompt de auditoria | `docs/AUDIT_PROMPT.md` |
-| Golden snippets | `docs/design-system/examples.md` |

package/dist/action-plans/constants.d.ts

@@ -14,18 +14,38 @@ export declare const STATUS_TEXT_COLORS: Record<ETaskPlanStatus, string>;
  */
 export declare const STATUS_MAP: Record<ETaskPlanStatus, string>;
 /**
- * Labels padrão para status (pt-BR)
+ * Labels para status (i18n)
+ * Retorna um objeto traduzido — deve ser chamado em tempo de renderização.
+ */
+export declare function getStatusLabels(): Record<ETaskPlanStatus, string>;
+/**
+ * @deprecated Use getStatusLabels() instead
  */
 export declare const STATUS_LABELS: Record<ETaskPlanStatus, string>;
 /**
- * Tipos de ação padrão
+ * Tipos de ação (i18n)
+ */
+export declare function getActionTypes(): {
+    id: string;
+    label: string;
+}[];
+/**
+ * @deprecated Use getActionTypes() instead
  */
 export declare const DEFAULT_ACTION_TYPES: {
     id: string;
     label: string;
 }[];
 /**
- * Prioridades padrão
+ * Prioridades (i18n)
+ */
+export declare function getPriorities(): {
+    id: ETaskPlanPriority;
+    label: string;
+    color: string;
+}[];
+/**
+ * @deprecated Use getPriorities() instead
  */
 export declare const PRIORITIES: {
     id: ETaskPlanPriority;

package/dist/audit-trail/utils.d.ts

@@ -18,18 +18,18 @@ export declare function camelToDash(str: string): string;
 declare const DEFAULT_LABELS: {
     readonly event: "Evento";
     readonly entityName: "Item";
-    readonly description: "Descrição";
+    readonly description: string;
     readonly justification: "Justificativa";
     readonly status: "Status";
     readonly type: "Tipo";
-    readonly references: "Referências";
-    readonly security: "Segurança";
-    readonly electronicSigned: "Assinatura Eletrônica";
+    readonly references: string;
+    readonly security: string;
+    readonly electronicSigned: string;
     readonly accomplishedBy: "Realizado por";
     readonly accomplishedIn: "Realizado em";
     readonly changedFrom: "de";
     readonly changedTo: "para";
-    readonly uninformed: "Não informado";
+    readonly uninformed: string;
     readonly stateAdded: "(adicionado)";
     readonly stateModified: "(modificado)";
     readonly stateRemoved: "(removido)";

package/dist/auth/components/EditProfileDialog.d.ts

@@ -0,0 +1,12 @@
+import React from 'react';
+interface EditProfileDialogProps {
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    user: {
+        name?: string | null;
+    };
+    userPhotoUrl: string | null;
+    userInitials: string;
+}
+declare const EditProfileDialog: React.FC<EditProfileDialogProps>;
+export default EditProfileDialog;

package/dist/auth/contexts/AuthContext.d.ts

@@ -37,7 +37,7 @@ export declare const AuthProvider: React.FC<{
  *   } = useAuth();
  *
  *   if (isLoading) return <div>Carregando...</div>;
- *   if (!isAuthenticated) return <div>Não autenticado</div>;
+ *   if (!isAuthenticated) return <div>{t('not_authenticated')}</div>;
  *
  *   return (
  *     <div>

package/dist/auth/services/AuthService.d.ts

@@ -26,7 +26,7 @@ export declare class AuthService {
      */
     private static decodeToken;
     /**
-     * Extrai informações do usuário do ID token
+     * Extrai informações do usuário do ID token + access token
      */
     private static extractUserFromIdToken;
     /**

package/dist/components/dashboards/panels/panel-header.d.ts

@@ -7,7 +7,7 @@ export interface PanelHeaderProps {
     /** Extra content to render in a specific slot */
     complement?: ReactNode;
     complementPosition?: 'before-title' | 'after-title' | 'before-options' | 'after-options';
-    /** URL builder for the "Open query" link */
+    /** URL builder for the t('dashboard_open_query') link */
     queryUrlBuilder?: (config: PanelConfig) => string;
     onRefresh?: () => void;
     onExport?: () => void;

package/dist/components/layout/SidebarActionTrigger.d.ts

@@ -23,7 +23,7 @@ export interface SidebarActionTriggerProps {
  *   config={{
  *     triggerLabel: 'Criar',
  *     actions: [
- *       { id: 'new-item', label: 'Novo Item', onClick: () => openDialog() }
+ *       { id: 'new-item', label: t('new_item'), onClick: () => openDialog() }
  *     ]
  *   }}
  *   isCollapsed={!open}
@@ -34,8 +34,8 @@ export interface SidebarActionTriggerProps {
  *   config={{
  *     variant: 'split-button',
  *     actions: [
- *       { id: 'new-doc', label: 'Novo Documento', icon: FilePlus, onClick: handleNewDoc },
- *       { id: 'new-folder', label: 'Nova Pasta', icon: FolderPlus, onClick: handleNewFolder },
+ *       { id: 'new-doc', label: t('new_document'), icon: FilePlus, onClick: handleNewDoc },
+ *       { id: 'new-folder', label: t('new_folder'), icon: FolderPlus, onClick: handleNewFolder },
  *     ]
  *   }}
  *   isCollapsed={!open}

package/dist/components/modules/ModuleAccessGuard.d.ts

@@ -30,7 +30,7 @@ export interface ModuleAccessGuardProps {
      * ```tsx
      * // src/config/accessDeniedRoutes.tsx
      * export const accessDeniedRoutes = {
-     *   '/docs/matrix-link': <ModuleOfferContent title="Conheça Staff" ... />,
+     *   '/docs/matrix-link': <ModuleOfferContent title={t('know_staff')} ... />,
      *   '/reports/*': <ModuleOfferContent title="Relatórios" ... />,
      * };
      * ```

package/dist/components/modules/icons/ModulesCardIcons.d.ts

@@ -3,12 +3,12 @@ interface IconProps {
 }
 /**
  * Ícone outline do Qualiex para marca d'água
- * Usado no card "Aprenda a usar o Qualiex"
+ * Usado no card t('learn_qualiex')
  */
 export declare function QualiexOutlineIcon({ className }: IconProps): import("react/jsx-runtime").JSX.Element;
 /**
  * Ícone outline do Saber Gestão para marca d'água
- * Usado no card "Conheça o Saber Gestão"
+ * Usado no card t('know_saber_gestao')
  */
 export declare function SaberGestaoOutlineIcon({ className }: IconProps): import("react/jsx-runtime").JSX.Element;
 /**

package/dist/components/ui/color-picker.d.ts

@@ -3,9 +3,9 @@ interface ColorPickerProps {
     value?: string;
     onChange?: (color: string) => void;
     label?: string;
-    /** i18n: Label for custom color input (default: "Cor personalizada") */
+    /** i18n: Label for custom color input (default: t('custom_color')) */
     customColorLabel?: string;
-    /** i18n: Label for preset colors section (default: "Cores predefinidas") */
+    /** i18n: Label for preset colors section (default: t('preset_colors')) */
     presetColorsLabel?: string;
 }
 export declare const ColorPicker: React.FC<ColorPickerProps>;

package/dist/components/ui/combo-tree.d.ts

@@ -72,5 +72,7 @@ export interface ComboTreeProps {
     popoverContainer?: HTMLElement | null;
     onOpen?: () => void;
     onClose?: () => void;
+    /** Whether parent nodes start expanded. Defaults to true. */
+    defaultExpanded?: boolean;
 }
-export declare function ComboTree({ multiple, options, value, onChange, placeholder, label, icon: Icon, emptyMessage, searchPlaceholder, disabled, required, isLoading, error, className, maxDisplayedBadges, popoverContainer, onOpen, onClose, }: ComboTreeProps): import("react/jsx-runtime").JSX.Element;
+export declare function ComboTree({ multiple, options, value, onChange, placeholder, label, icon: Icon, emptyMessage, searchPlaceholder, disabled, required, isLoading, error, className, maxDisplayedBadges, popoverContainer, onOpen, onClose, defaultExpanded, }: ComboTreeProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/ui/data-list.d.ts

@@ -56,12 +56,12 @@ declare function DataListField({ label, value, className }: DataListFieldProps):
  * ```tsx
  * <DataList.Root>
  *   <DataList.Item onClick={() => console.log('clicked')}>
- *     <DataList.Field label="Nome" value="João Silva" />
+ *     <DataList.Field label=t('ap_name') value="João Silva" />
  *     <DataList.Field label="Email" value="joao@exemplo.com" />
  *     <DataList.Field label="Status" value={<Badge>Ativo</Badge>} />
  *   </DataList.Item>
  *   <DataList.Item>
- *     <DataList.Field label="Nome" value="Maria Santos" />
+ *     <DataList.Field label=t('ap_name') value="Maria Santos" />
  *     <DataList.Field label="Email" value="maria@exemplo.com" />
  *   </DataList.Item>
  * </DataList.Root>

package/dist/components/ui/dialog-wizard.d.ts

@@ -15,7 +15,7 @@ import { type DialogVariant, type DialogSize } from './dialog';
  *   currentStep={step}
  *   onStepChange={setStep}
  *   steps={['Geral', 'Formulário', 'Configuração']}
- *   title="Novo Documento"
+ *   title={t('new_document')}
  *   onSave={handleSave}
  * >
  *   {step === 1 && <StepOneContent />}

package/dist/components/ui/dialog.d.ts

@@ -17,7 +17,7 @@ interface DialogContentProps extends React.ComponentPropsWithoutRef<typeof Dialo
     customHeight?: string;
     customMinHeight?: string;
     customMaxHeight?: string;
-    /** i18n: Title for unsaved changes alert (default: "Alterações não salvas") */
+    /** i18n: Title for unsaved changes alert (default: t('unsaved_changes')) */
     unsavedChangesTitle?: string;
     /** i18n: Description for unsaved changes alert */
     unsavedChangesDescription?: string;

package/dist/components/ui/disabled-menu-item.d.ts

@@ -15,7 +15,7 @@ interface DisabledMenuItemProps {
  *
  * @example
  * ```tsx
- * <DisabledMenuItem disabledReason="Selecione ao menos um item">
+ * <DisabledMenuItem disabledReason=t('select_at_least_one_item')>
  *   <Download className="mr-2 h-4 w-4" />
  *   Exportar Selecionados
  * </DisabledMenuItem>

package/dist/components/ui/empty-state.d.ts

@@ -31,10 +31,10 @@ interface EmptyStateProps {
  * ```tsx
  * // Estado vazio padrão
  * <EmptyState
- *   title="Nenhum item encontrado"
- *   description="Adicione seu primeiro item para começar"
+ *   title={t('no_items_found_empty')}
+ *   description=t('add_first_item')
  *   action={{
- *     label: "Adicionar Item",
+ *     label: t('add_item'),
  *     onClick: () => handleAddItem()
  *   }}
  * />
@@ -42,17 +42,17 @@ interface EmptyStateProps {
  * // Sem resultados de busca
  * <EmptyState
  *   variant="search"
- *   title="Nenhum resultado encontrado"
- *   description="Tente ajustar sua busca"
+ *   title={t('no_results')}
+ *   description=t('try_adjust_search')
  * />
  *
  * // Estado de erro
  * <EmptyState
  *   variant="error"
- *   title="Erro ao carregar dados"
- *   description="Não foi possível carregar as informações"
+ *   title={t('error_loading_data')}
+ *   description=t('could_not_load_info')
  *   action={{
- *     label: "Tentar Novamente",
+ *     label: t('try_again'),
  *     onClick: () => refetch()
  *   }}
  * />
@@ -60,7 +60,7 @@ interface EmptyStateProps {
  * // Ícone customizado
  * <EmptyState
  *   icon={<Package className="h-8 w-8" />}
- *   title="Sem produtos"
+ *   title={t('no_products')}
  * />
  * ```
  *

package/dist/components/ui/onboarding-dialog.d.ts

@@ -26,7 +26,7 @@ export interface OnboardingDialogProps {
     backButtonText?: string;
     /** Texto do botão finalizar (default: "Concluir") */
     finishButtonText?: string;
-    /** Texto do label de etapa (default: "Etapa") */
+    /** Texto do label de etapa (default: t('approval_step_label')) */
     stepLabel?: string;
     /** Tamanho do dialog */
     size?: "sm" | "md" | "lg";

package/dist/components/ui/popover.d.ts

@@ -9,7 +9,7 @@ import * as PopoverPrimitive from "@radix-ui/react-popover";
  * ```tsx
  * <Popover>
  *   <PopoverTrigger asChild>
- *     <Button variant="outline">Abrir Popover</Button>
+ *     <Button variant="outline">{t('open_popover')}</Button>
  *   </PopoverTrigger>
  *   <PopoverContent>
  *     <div className="space-y-2">