forlogic-core 3.0.10 → 4.0.0

package/dist/versioning/registry.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Registro de/para entre o DS legado (v1) e o DS novo (v2).
+ *
+ * Este arquivo é a ÚNICA fonte de verdade do mapeamento. Ele é usado para:
+ *   - montar os barrels versionados,
+ *   - gerar a documentação de migração,
+ *   - alimentar o codemod de imports no app hospedeiro.
+ *
+ * status:
+ *   'same'      → mesmo nome, mesma API (troca transparente)
+ *   'renamed'   → nome mudou (from → to)
+ *   'reshaped'  → mesmo nome, contrato de props mudou (ver `notes`)
+ *   'merged'    → vários componentes v1 viraram um único v2
+ *   'removed'   → não existe em v2; só disponível ao voltar para v1
+ *   'new'       → só existe em v2
+ */
+export type MappingStatus = 'same' | 'renamed' | 'reshaped' | 'merged' | 'removed' | 'new';
+export interface MappingEntry {
+    /** Nome exportado no DS legado (v1). Ausente quando status = 'new'. */
+    from?: string | string[];
+    /** Nome exportado no DS novo (v2). Ausente quando status = 'removed'. */
+    to?: string;
+    status: MappingStatus;
+    notes?: string;
+}
+export declare const DS_MIGRATION_REGISTRY: MappingEntry[];
+/** Índice rápido por nome legado — usado pelo codemod. */
+export declare const LEGACY_INDEX: Record<string, MappingEntry>;

package/dist/versioning/resolve-versioned.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Resolução de componente por versão — ponto ÚNICO de decisão.
+ *
+ * Uso no barrel público da lib:
+ *
+ *   import { Button as ButtonV2 } from '../components/ui/button';
+ *   import { Button as ButtonV1 } from '../legacy/components/ui/button';
+ *   export const Button = versioned('Button', ButtonV2, ButtonV1);
+ *
+ * Comportamento determinístico:
+ *   - v2 ativo  → renderiza a implementação nova
+ *   - v1 ativo  → renderiza a legada
+ *   - sem par legado → sempre a nova (e um aviso único em dev)
+ */
+import * as React from 'react';
+export declare function versioned<P extends object>(name: string, v2: React.ComponentType<P>, v1?: React.ComponentType<P>): React.ComponentType<P>;
+/** Resolve valores não-componentes (hooks, utils, tokens) pela versão ativa. */
+export declare function useVersionedValue<T>(v2: T, v1?: T): T;
+/** Renderiza filhos apenas na versão indicada. */
+export declare function DsVersionGate({ version: target, children, }: {
+    version: 'v1' | 'v2';
+    children: React.ReactNode;
+}): React.JSX.Element;

package/dist/versioning/version-context.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Contexto único de versão do Design System.
+ *
+ * Regra dura: existe UM e apenas UM estado de versão em toda a lib.
+ * Nenhum componente pode decidir versão por conta própria — todos leem daqui.
+ *
+ * Versões:
+ *   'v2'  → Design System atual (beta publicado como padrão)
+ *   'v1'  → Design System legado (main anterior, preservado integralmente)
+ */
+import * as React from 'react';
+export type DsVersion = 'v1' | 'v2';
+export declare const DS_VERSION_STORAGE_KEY = "forlogic-ds:version";
+export declare const DS_VERSION_ATTRIBUTE = "data-ds-version";
+export interface DsVersionState {
+    /** Versão ativa neste momento. */
+    version: DsVersion;
+    /** Versão padrão do pacote (fallback quando não há preferência salva). */
+    defaultVersion: DsVersion;
+    /** true quando o usuário está fora da versão padrão. */
+    isLegacy: boolean;
+    /** Define a versão explicitamente (persistida). */
+    setVersion: (next: DsVersion) => void;
+    /** Alterna entre v2 e v1. */
+    toggleVersion: () => void;
+    /** Volta para a versão padrão do pacote e limpa a preferência salva. */
+    resetVersion: () => void;
+}
+export interface DsVersionProviderProps {
+    children: React.ReactNode;
+    /** Versão padrão do pacote. Padrão: 'v2' (DS novo). */
+    defaultVersion?: DsVersion;
+    /** Trava a versão (ignora preferência salva e desabilita a troca). */
+    forcedVersion?: DsVersion;
+    /** Persistir a escolha em localStorage. Padrão: true. */
+    persist?: boolean;
+    /** Notificado a cada troca — útil para telemetria do app hospedeiro. */
+    onVersionChange?: (version: DsVersion) => void;
+}
+export declare function DsVersionProvider({ children, defaultVersion, forcedVersion, persist, onVersionChange, }: DsVersionProviderProps): React.JSX.Element;
+/**
+ * Lê a versão ativa. Fora do provider devolve o padrão estático ('v2'),
+ * garantindo que a lib nunca quebre em apps que ainda não montaram o provider.
+ */
+export declare function useDsVersion(): DsVersionState;

package/dist/versioning/versioned-components.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Componentes com par legado (v1) declarado em `registry.ts`.
+ *
+ * Cada export aqui resolve em runtime pela versão ativa do DS:
+ *   - v2 (default) → implementação nova em `lib/components/**`
+ *   - v1 (Retornar versão) → implementação legada em `lib/legacy/components/**`
+ *
+ * Só entram nesta lista os nomes cujo contrato mudou (`merged`, `reshaped`),
+ * garantindo que apps já em produção possam voltar ao comportamento antigo
+ * sem downgrade de pacote.
+ */
+import type * as React from 'react';
+import { type BadgeProps } from '../components/ui/badge';
+import { type StatusBadgeProps } from '../components/ui/status-badge';
+import { type AccordionProps } from '../components/ui/accordion';
+import { type PageHeaderProps } from '../components/layout/PageHeader';
+export declare const Badge: React.ComponentType<BadgeProps>;
+export declare const StatusBadge: React.ComponentType<StatusBadgeProps>;
+export declare const Accordion: React.ComponentType<AccordionProps>;
+export declare const PageHeader: React.ComponentType<PageHeaderProps>;

package/docs/DS_KNOWLEDGE.md

@@ -0,0 +1,385 @@
+<!-- ⚠️ ARQUIVO GERADO — NÃO EDITAR MANUALMENTE -->
+<!-- Regras: docs/design-system/knowledge/RULES.md | Regenerar: npm run ds:knowledge -->
+
+# forlogic-core — DS Knowledge (padrão para novos projetos)
+
+> Cole este arquivo inteiro no **Workspace Knowledge** do projeto consumidor.
+> Ele é a fonte única de verdade para construir uma aplicação fiel ao Design System.
+> Fonte das regras: `@Admin docs/design-system/knowledge/RULES.md`.
+> Detalhes por componente: `@Admin docs/design-system/<categoria>.md` e `.../patterns/<padrão>.md`.
+
+---
+
+## 1. Regras invioláveis
+
+| # | Regra |
+|---|-------|
+| 1 | **Lib-first** — antes de criar qualquer componente visual, procurar em `forlogic-core`. Criar novo só se não existir equivalente. |
+| 2 | **Todo import visual vem de `forlogic-core`** — nunca de `@radix-ui/*`, `react-day-picker`, `recharts`, `cmdk` diretamente. |
+| 3 | **Zero cor literal** — proibido `text-white`, `bg-black`, `bg-[#...]`, `text-gray-500`. Somente tokens semânticos (`bg-background`, `text-muted-foreground`, `border-border`). |
+| 4 | **Variante de erro = `danger`**, nunca `destructive`, em Button/Badge/Alert/Dialog. |
+| 5 | **Ícones = `lucide-react`**. Exceção única: `IconPicker` (Material Symbols). |
+| 6 | **i18n** — `useTranslation` importado de `forlogic-core`, nunca de `react-i18next`. |
+| 7 | **Supabase** — cliente via `getSupabaseClient()` de `forlogic-core`; toda query com `.schema('<schema-do-projeto>')` explícito. |
+| 8 | **Sem DELETE físico** — soft delete com `deleted_at`. |
+| 9 | **RLS `TO authenticated`** — nunca conceder `anon` sem justificativa comentada na migration (`-- ANON: motivo`) e registrada no security memory. |
+| 10 | **Sem role em client storage** — nunca localStorage/sessionStorage para permissão; roles em tabela separada + função `SECURITY DEFINER`. |
+| 11 | **Scroll único** — root `h-screen overflow-hidden`; um só container rolável (`flex-1 min-h-0 overflow-y-auto`). |
+| 12 | **`VITE_SUPABASE_PK_OVERRIDE`** obrigatória no `.env` quando `backend="supabase"` — nunca remover. |
+| 13 | **Variantes de componente** seguem `patterns/variant-naming.md`: id `<família>-<variante>` kebab-case, rótulo em inglês Title Case sem parênteses, grupo do vocabulário fechado (`Start here`/`Default`/`Variants`/`Parts`/`Reference`/`Legacy`), situação via `status`, link sempre por `variantHref()`. |
+
+
+---
+
+## 2. Setup do projeto
+
+### 2.1 Dependência
+
+```bash
+npm i forlogic-core
+```
+
+### 2.2 `src/main.tsx` / `App.tsx`
+
+```tsx
+import { CoreProviders } from 'forlogic-core';
+import pt from './locales/pt-BR.json';
+import './index.css';
+
+<CoreProviders
+  backend="supabase"        // ou "dotnet" quando não há Supabase
+  appTranslations={{ 'pt-BR': pt }}
+>
+  <BrowserRouter>{/* rotas */}</BrowserRouter>
+</CoreProviders>
+```
+
+`CoreProviders` já monta: QueryClient, i18n + LanguageBootstrap, tema/essência,
+Tooltip, Toaster, Auth, Navigation, Module, PageMetadata e ModalState.
+**Não** duplicar nenhum desses providers no app.
+
+### 2.3 `src/index.css`
+
+```css
+@import 'forlogic-core/index.css';
+@import 'forlogic-core/legacy.css'; /* só se o app expõe o switch de versão */
+```
+
+Overrides do projeto entram **depois** do import, sempre em HSL e como token.
+
+### 2.4 `tailwind.config.ts`
+
+```ts
+import { forlogicTailwindPreset, forlogicContentPaths } from 'forlogic-core/tailwind';
+
+export default {
+  presets: [forlogicTailwindPreset],
+  content: [...forlogicContentPaths, './src/**/*.{ts,tsx}'],
+};
+```
+
+### 2.5 `vite.config.ts`
+
+```ts
+import { createForlogicConfig } from 'forlogic-core/vite';
+export default createForlogicConfig({ /* opções do projeto */ });
+```
+
+Já aplica alias `@`, headers de segurança/CSP, `resolveSupabaseEnv()` e o plugin
+que externaliza `forlogic-core` nos subpaths (evita duplicar React Context).
+
+### 2.6 `.env` mínimo
+
+```
+VITE_APP_ENV="PROD"            # ou "DEV" — única fonte de verdade de ambiente
+SUPABASE_URL=...
+SUPABASE_PUBLISHABLE_KEY=...
+VITE_SUPABASE_PK_OVERRIDE=...
+```
+
+---
+
+## 3. Layout obrigatório
+
+```tsx
+<AppLayout>            {/* h-screen overflow-hidden */}
+  <AppHeader />        {/* fixo; expõe --app-header-height */}
+  <AppSidebar />       {/* estado persistido por usuário */}
+  <BodyContent>        {/* flex-1 min-h-0 overflow-y-auto */}
+    {/* conteúdo da página */}
+  </BodyContent>
+</AppLayout>
+```
+
+- Título/subtítulo/breadcrumb **sempre** via `usePageMetadata()` — nunca `<h1>` solto na página.
+- `BodyContent` usa `overflow-visible` internamente para permitir popovers.
+- Rotas multi-tenant: `/:alias/<modulo>/...` é a única fonte de verdade de tenant.
+
+---
+
+## 4. Formulários e inputs
+
+- Base: `BaseForm` com config declarativa (`fields`, `sections`, `columns`).
+- Campos: `Input`, `Textarea`, `NumberInput`, `Combobox` (aliases `SelectSearch`,
+  `MultiSelect`, `EntitySelect`), `ComboTree` (`TreeSelect`), `DatePicker`,
+  `TimePicker`, `Switch`, `Checkbox`, `RadioGroup`, `IconPicker`, `SingleFileUpload`.
+- Contrato de borda: neutra `border-border`, hover `--control-surface-hover`,
+  foco `ring-[--control-ring]`. Raio base `rounded-lg` (8px).
+- Densidade: fonte base 13px (**Roobert Pro**), `px-3 py-2` em controles, `gap-2` entre elementos.
+- Tipografia: `Roobert Pro` (sans, empacotada na lib via `@font-face` em `forlogic-core/index.css`) e `Roboto Mono` (mono). Nunca declarar `font-family` fixo em componentes — usar `font-sans` / `font-mono` ou `var(--font-sans)`. Pesos: 400, 400 itálico e 700 (500 = Regular, 600+ = Bold).
+- Validação com `zod` + schemas de `forlogic-core/validation`.
+
+---
+
+## 5. Tabelas e CRUD
+
+- Página CRUD completa: `createCrudPage({ ... })` (memoizar config — obrigatório).
+- Tabela: `CrudTable` / `CrudPrimitiveTable` (alias `DataTable`).
+- **Defaults ligados por padrão**: sort, resize de colunas, column manager,
+  drag-and-drop de colunas, paginação, filtro.
+- Cabeçalhos: **uma palavra** por coluna (`columnTitle`), sem wrap; conteúdo longo
+  usa `TruncatedCell` (`EllipsisText`) com tooltip.
+- Densidade: header `h-9`, células `py-2`, `vertical-align: middle`.
+- Ações de linha: `RowActions` (hover-to-reveal, pill sticky no scroll horizontal)
+  + `RowContextMenu` com os mesmos comandos.
+- Ações em massa: `SelectionToolbar`.
+- Exclusão permanente: `AlertDialog`; exclusão lógica: dialog de confirmação padrão.
+- Read-only: passar `readOnly` ao `CrudTable` (esconde `+ Novo`, menus e ações).
+
+---
+
+## 6. Dialogs
+
+```tsx
+<Dialog>
+  <DialogContent size="md">      {/* sm | md | lg | xl | full */}
+    <DialogHeader />
+    <DialogBody className="px-2 -mx-2">  {/* OBRIGATÓRIO antes do footer */}
+      ...
+    </DialogBody>
+    <DialogFooter />
+  </DialogContent>
+</Dialog>
+```
+
+- `DialogBody` é obrigatório (scroll interno + focus ring visível).
+- Variantes semânticas: `default`, `danger`, `warning`, `success`, `info`.
+- Wizard multi-step: stepper vertical.
+- Alterações não salvas: interceptar o fechamento do Radix programaticamente
+  (`closeBtnRef`), nunca confiar no fechamento nativo.
+
+---
+
+## 7. Feedback
+
+- Toasts: `toast()` do `forlogic-core` (fundo sólido, nunca translúcido).
+- Estados vazios: `EmptyState`. Carregamento: `Skeleton` (não spinner solto).
+- Erros de serviço: `ErrorService` centraliza a mensagem exibida.
+
+---
+
+## 8. Tema
+
+- Modos: light / dark (navy) + **essências** de marca (`ESSENCES`, `buildEssenceTheme`).
+- Estado persistido em `localStorage` (`forlogic-ds:theme` / `:essence`) e refletido em `<html>`.
+- Trocar via `applyThemeState` / `setEssence`; nunca escrever CSS var direto no app.
+- Versionamento do DS: `DsVersionProvider` + `DsVersionSwitch` de `forlogic-core/versioning`
+  (v2 padrão; v1 apenas via `forlogic-core/legacy`).
+
+---
+
+## 9. Checklist antes de abrir PR no app consumidor
+
+- [ ] Nenhum import visual fora de `forlogic-core`.
+- [ ] Nenhuma cor/spacing hardcoded; só tokens.
+- [ ] `danger` em vez de `destructive`.
+- [ ] Ícones Lucide.
+- [ ] Um único scroll na tela.
+- [ ] Título/breadcrumb via `usePageMetadata`.
+- [ ] Toda query com `.schema()`.
+- [ ] Policies `TO authenticated`.
+- [ ] Textos via `t()` quando o módulo é multi-idioma.
+- [ ] Tabelas com header de uma palavra, resize e column manager ativos.
+
+---
+
+## 10. Como manter este knowledge atualizado
+
+Este arquivo é **gerado**: `docs/DS_KNOWLEDGE.md` = estas regras + seções
+dinâmicas extraídas do código (versão, subpaths, exports, tokens, padrões).
+
+```bash
+npm run ds:knowledge     # regenera docs/DS_KNOWLEDGE.md
+```
+
+- Roda automaticamente em `npm run build:lib` (antes do build da lib).
+- Alterou regra/padrão? Edite **este** `RULES.md` e regenere.
+- Adicionou/removeu componente, token, subpath ou padrão? Só regenerar — o
+  conteúdo dinâmico se atualiza sozinho.
+- No projeto consumidor: substitua o Workspace Knowledge pelo conteúdo novo de
+  `docs/DS_KNOWLEDGE.md`, ou referencie `@Admin docs/DS_KNOWLEDGE.md`.
+
+---
+
+## Versão da lib (gerado)
+
+| Campo | Valor |
+|-------|-------|
+| Pacote | `forlogic-core` |
+| Versão | `4.0.0` |
+| Gerado em | 2026-09-08 |
+
+### Subpaths publicados
+
+- `forlogic-core`
+- `forlogic-core/index.css`
+- `forlogic-core/tokens`
+- `forlogic-core/vite`
+- `forlogic-core/tailwind`
+- `forlogic-core/sign`
+- `forlogic-core/audit-trail`
+- `forlogic-core/action-plans`
+- `forlogic-core/leadership`
+- `forlogic-core/places`
+- `forlogic-core/edge`
+- `forlogic-core/storage`
+- `forlogic-core/validation`
+- `forlogic-core/legacy`
+- `forlogic-core/versioning`
+- `forlogic-core/legacy.css`
+- `forlogic-core/knowledge`
+- `forlogic-core/knowledge/compact`
+- `forlogic-core/knowledge/rules`
+
+> Módulos de domínio (`/sign`, `/audit-trail`, `/action-plans`, `/leadership`, `/places`)
+> **não** estão no barrel principal — importe pelo subpath.
+
+---
+
+## Componentes exportados (gerado)
+
+### UI — 34 exports
+
+`ActionMenu`, `AutoComplete`, `BADGE_BASE_CLASSES`, `BADGE_TONE_CLASSES`, `CardSelectDialog`, `Collapsible`, `CollapsibleContent`, `CollapsibleTrigger`, `Combobox`, `ComboTree`, `ConfirmDialog`, `createStatusConfig`, `DeleteAccountDialog`, `DialogSignal`, `dialogToneConfig`, `EllipsisText`, `EntitySelect`, `FeatureAnnouncementDialog`, `LoadingState`, `MultiSelect`, `SelectSearch`, `ShareLinkDialog`, `SidePanel`, `sonnerToast`, `SonnerToaster`, `StatusBadge`, `StatusBadgeV2`, `Stepper`, `TableDialog`, `TableResizeHandle`, `toast`, `TreeSelect`, `UpdatesNotification`, `useUpdatesNotification`
+
+### CRUD — 40 exports
+
+`abbreviate`, `ActionMenuItems`, `BaseForm`, `ColumnManagerMenu`, `ColumnSettingsPopover`, `ColumnTitle`, `createCrudPage`, `createSimpleSaveHandler`, `createSimpleService`, `CrudActionBar`, `CrudActionMenu`, `CrudGrid`, `CrudPageInternal`, `CrudPagination`, `CrudPrimitiveFilterBar`, `CrudPrimitivePagination`, `CrudPrimitiveTable`, `CrudTable`, `DataFilterBar`, `DataPagination`, `DataTable`, `FilterBar`, `generateCrudConfig`, `GROUPED_MENU_THRESHOLD`, `InlineRowActions`, `KanbanActionBar`, `MAX_QUICK_ACTIONS`, `MAX_TOOLBAR_ACTIONS`, `renderColumnHeader`, `RowActions`, `RowActionsMenuItems`, `RowContextMenu`, `SelectionToolbar`, `shortenColumnTitle`, `TableRowActions`, `TreeTable`, `useBaseForm`, `useColumnManager`, `useCrud`, `useRowActions`
+
+### Action Plans — 28 exports
+
+`ActionPlanAttachmentsTab`, `ActionPlanCommentsTab`, `ActionPlanCostTab`, `ActionPlanGeneralTab`, `ActionPlanHistoryTab`, `ActionPlanPage`, `ActionPlanPredecessorsTab`, `ActionPlanProgressDialog`, `ActionPlanProgressTab`, `ActionPlanStatusBadge`, `CLOSED_STATUSES`, `DEFAULT_ACTION_TYPES`, `EAttachmentItemStatus`, `ETaskPlanAssociationType`, `ETaskPlanPriority`, `ETaskPlanStatus`, `ETaskPlanTypeProgress`, `formatTime`, `formatTimeProgress`, `getProgressColor`, `PRIORITIES`, `PROGRESS_ALLOWED_STATUSES`, `STATUS_COLORS`, `STATUS_LABELS`, `STATUS_MAP`, `STATUS_TEXT_COLORS`, `useActionPlan`, `useActionPlanProgress`
+
+### Custom Form Fields — 18 exports
+
+`CustomFormFields`, `ECustomFormFieldType`, `EFieldViewMode`, `ESelectionFieldDataSource`, `FormDateField`, `FormMultiSelectionField`, `FormNumericField`, `FormQuestionsField`, `FormSingleSelectionField`, `FormTextField`, `FormTimeField`, `FormUrlField`, `getFieldValue`, `getFormFieldValues`, `ReadOnlyTextField`, `setFormFieldValues`, `shouldShowField`, `validateFields`
+
+### File Upload — 4 exports
+
+`FORBIDDEN_FILE_TYPES`, `formatBytes`, `getFileExtension`, `SingleFileUpload`
+
+### Integrações — 2 exports
+
+`getSupabaseClient`, `TokenManager`
+
+---
+
+## Tokens de design (gerado)
+
+Total de 274 custom properties em `lib/index.css`. **Nunca** use cor literal
+(`text-white`, `bg-[#fff]`) — sempre o token semântico.
+
+| Grupo | Tokens |
+|-------|--------|
+| `--accent*` | 2 |
+| `--alert*` | 12 |
+| `--behavioral*` | 3 |
+| `--border*` | 2 |
+| `--brand*` | 7 |
+| `--button*` | 68 |
+| `--card*` | 2 |
+| `--control*` | 21 |
+| `--destructive*` | 3 |
+| `--ds-accordion*` | 24 |
+| `--ds-assembly*` | 2 |
+| `--ds-icon*` | 11 |
+| `--ds-mark*` | 4 |
+| `--ds-motion*` | 4 |
+| `--focus*` | 2 |
+| `--font*` | 3 |
+| `--info*` | 3 |
+| `--input*` | 3 |
+| `--interaction*` | 3 |
+| `--menu*` | 8 |
+| `--muted*` | 2 |
+| `--navy*` | 10 |
+| `--popover*` | 2 |
+| `--primary*` | 4 |
+| `--secondary*` | 3 |
+| `--shadow*` | 19 |
+| `--sidebar*` | 10 |
+| `--stat*` | 9 |
+| `--success*` | 3 |
+| `--surface*` | 7 |
+| `--technical*` | 3 |
+| `--tw*` | 2 |
+| `--warning*` | 3 |
+
+---
+
+## Documentação por categoria (gerado)
+
+- `docs/design-system/accordion-tokens.md`
+- `docs/design-system/buttons-actions.md`
+- `docs/design-system/charts-dashboards.md`
+- `docs/design-system/crud.md`
+- `docs/design-system/dark-mode-navy.md`
+- `docs/design-system/data-display.md`
+- `docs/design-system/dialogs.md`
+- `docs/design-system/domain.md`
+- `docs/design-system/examples.md`
+- `docs/design-system/foundation.md`
+- `docs/design-system/infra-utils.md`
+- `docs/design-system/inputs.md`
+- `docs/design-system/layout.md`
+- `docs/design-system/navigation.md`
+- `docs/design-system/notifications-feedback.md`
+- `docs/design-system/platform.md`
+- `docs/design-system/selectors.md`
+- `docs/design-system/tables-grids.md`
+
+## Padrões normativos (gerado)
+
+- `docs/design-system/patterns/action-button.md`
+- `docs/design-system/patterns/alertdialog-deletion.md`
+- `docs/design-system/patterns/baseform-custom-fields.md`
+- `docs/design-system/patterns/baseform-usage.md`
+- `docs/design-system/patterns/body-content-scroll.md`
+- `docs/design-system/patterns/border-states.md`
+- `docs/design-system/patterns/combo-tree.md`
+- `docs/design-system/patterns/components-registry.md`
+- `docs/design-system/patterns/core-providers.md`
+- `docs/design-system/patterns/crud-bulk-actions.md`
+- `docs/design-system/patterns/crud-config-props.md`
+- `docs/design-system/patterns/crud-defaults.md`
+- `docs/design-system/patterns/crud-toolbar.md`
+- `docs/design-system/patterns/delete-confirmation.md`
+- `docs/design-system/patterns/dialog-body-scroll.md`
+- `docs/design-system/patterns/dialog-structure.md`
+- `docs/design-system/patterns/dialog-variants.md`
+- `docs/design-system/patterns/feature-flags.md`
+- `docs/design-system/patterns/header-metadata.md`
+- `docs/design-system/patterns/i18n-setup.md`
+- `docs/design-system/patterns/module-access.md`
+- `docs/design-system/patterns/page-skeleton.md`
+- `docs/design-system/patterns/pagination.md`
+- `docs/design-system/patterns/row-actions.md`
+- `docs/design-system/patterns/single-scroll.md`
+- `docs/design-system/patterns/typography.md`
+- `docs/design-system/patterns/user-avatar-upload.md`
+- `docs/design-system/patterns/variant-naming.md`
+- `docs/design-system/patterns/vite-tailwind-setup.md`
+
+---
+
+<!-- Fim das seções geradas. Regenerar com: npm run ds:knowledge -->

package/docs/DS_KNOWLEDGE_COMPACT.md

@@ -0,0 +1,75 @@
+<!-- ⚠️ ARQUIVO GERADO — NÃO EDITAR MANUALMENTE -->
+<!-- Versão compacta (<10k chars) para Workspace Knowledge. Regenerar: npm run ds:knowledge -->
+
+# forlogic-core — DS Knowledge Compact
+
+Use este arquivo único quando o Workspace Knowledge limitar conteúdo a 10k caracteres. Para detalhes, consulte `@Admin docs/DS_KNOWLEDGE.md`.
+
+## Regras invioláveis
+
+1. Lib-first: antes de criar UI, procurar em `forlogic-core`; imports visuais devem vir de `forlogic-core`.
+2. Não importar Radix, DayPicker, Recharts, cmdk ou react-i18next direto no app; usar wrappers/`useTranslation` da lib.
+3. Zero cor literal: proibido `text-white`, `bg-black`, `bg-[#...]`, `text-gray-*`; usar tokens semânticos.
+4. Erros usam variante `danger`, nunca `destructive`.
+5. Ícones: `lucide-react`; exceção: `IconPicker` usa Material Symbols.
+6. Supabase: `getSupabaseClient()`; toda query com `.schema('<schema-do-projeto>')`; sem DELETE físico, usar `deleted_at`.
+7. RLS: policies `TO authenticated`; `anon` só com comentário `-- ANON: motivo` e registro no security memory.
+8. Roles/permissões nunca em localStorage/sessionStorage; usar tabela separada + função `SECURITY DEFINER`.
+9. Layout com scroll único: root `h-screen overflow-hidden`; conteúdo `flex-1 min-h-0 overflow-y-auto`.
+10. `VITE_SUPABASE_PK_OVERRIDE` é obrigatória quando `backend="supabase"`; nunca remover.
+11. Rotas multi-tenant: `/:alias/<modulo>/...` é a fonte única do tenant.
+12. Admin hardcoded em pt-BR; componentes compartilhados/lib usam `t()`.
+
+## Setup padrão
+
+`npm i forlogic-core`.
+
+`CoreProviders` deve envolver o app e já monta QueryClient, i18n, tema/essência, Tooltip, Toaster, Auth, Navigation, Module, PageMetadata e ModalState. Não duplicar providers.
+
+`src/index.css`: importar `forlogic-core/index.css`; importar `forlogic-core/legacy.css` apenas se houver switch de versão. Overrides depois, como tokens HSL.
+
+`tailwind.config.ts`: usar `forlogicTailwindPreset` e `forlogicContentPaths` de `forlogic-core/tailwind`.
+
+`vite.config.ts`: preferir `createForlogicConfig` de `forlogic-core/vite`.
+
+`.env`: `VITE_APP_ENV="PROD"|"DEV"`, `SUPABASE_URL`, `SUPABASE_PUBLISHABLE_KEY`, `VITE_SUPABASE_PK_OVERRIDE`.
+
+## Layout e navegação
+
+Usar `AppLayout`, `AppHeader`, `AppSidebar`, `BodyContent`. Título, subtítulo e breadcrumbs sempre via `usePageMetadata()`, nunca `h1` solto. `BodyContent` mantém overflow interno compatível com popovers.
+
+## Formulários
+
+Preferir `BaseForm` declarativo. Campos padrão: `Input`, `Textarea`, `NumberInput`, `Combobox`/`SelectSearch`/`MultiSelect`/`EntitySelect`, `ComboTree`/`TreeSelect`, `DatePicker`, `TimePicker`, `Switch`, `Checkbox`, `RadioGroup`, `IconPicker`, `SingleFileUpload`. Densidade: Inter 13px, `rounded-lg`, `px-3 py-2`, `gap-2`, foco com token de ring. Validar com zod + `forlogic-core/validation`.
+
+## Tabelas e CRUD
+
+Página CRUD: `createCrudPage({ ... })` com config memoizada. Tabela: `CrudTable`/`CrudPrimitiveTable`/`DataTable`. Defaults: sort, resize, column manager, drag-and-drop, paginação e filtro. Cabeçalho de coluna com uma palavra; conteúdo longo via `TruncatedCell`/`EllipsisText`. Densidade: header `h-9`, células `py-2`. Ações: `RowActions` + `RowContextMenu`; massa: `SelectionToolbar`. Read-only: `readOnly` esconde novo, menus e ações.
+
+## Dialogs e feedback
+
+`DialogFooter` deve ser precedido por `DialogBody className="px-2 -mx-2"`. Tamanhos: `sm|md|lg|xl|full`. Variantes: `default|danger|warning|success|info`. Alterações não salvas devem interceptar fechamento Radix programaticamente (`closeBtnRef`). Feedback: `toast()`, `EmptyState`, `Skeleton`, `ErrorService`.
+
+## Tema e DS versioning
+
+Temas light/dark navy + essências via `ESSENCES`/`buildEssenceTheme`. Persistência: `forlogic-ds:theme` e `:essence`; aplicar por `applyThemeState`/`setEssence`, nunca escrevendo CSS vars direto. Versionamento: `DsVersionProvider` + `DsVersionSwitch`; v2 padrão, v1 só via legacy.
+
+## Imports e subpaths
+
+Pacote: `forlogic-core@4.0.0`. Subpaths publicados: `forlogic-core`, `forlogic-core/index.css`, `forlogic-core/tokens`, `forlogic-core/vite`, `forlogic-core/tailwind`, `forlogic-core/sign`, `forlogic-core/audit-trail`, `forlogic-core/action-plans`, `forlogic-core/leadership`, `forlogic-core/places`, `forlogic-core/edge`, `forlogic-core/storage`, `forlogic-core/validation`, `forlogic-core/legacy`, `forlogic-core/versioning`, `forlogic-core/legacy.css`, `forlogic-core/knowledge`, `forlogic-core/knowledge/compact`, `forlogic-core/knowledge/rules`.
+
+Domínios com runtime próprio devem usar subpath: `/sign`, `/audit-trail`, `/action-plans`, `/leadership`, `/places`.
+
+Exports principais por área: UI: 34; CRUD: 40; Action Plans: 28; Custom Form Fields: 18; File Upload: 4; Integrações: 2.
+
+## Tokens
+
+`lib/index.css` possui 274 custom properties. Grupos: --accent*=2, --alert*=12, --behavioral*=3, --border*=2, --brand*=7, --button*=68, --card*=2, --control*=21, --destructive*=3, --ds-accordion*=24, --ds-assembly*=2, --ds-icon*=11, --ds-mark*=4, --ds-motion*=4, --focus*=2, --font*=3, --info*=3, --input*=3, --interaction*=3, --menu*=8, --muted*=2, --navy*=10, --popover*=2, --primary*=4, --secondary*=3, --shadow*=19, --sidebar*=10, --stat*=9, --success*=3, --surface*=7, --technical*=3, --tw*=2, --warning*=3. Usar tokens semânticos para cor, borda, ring, surface, shadow e estados.
+
+## Checklist PR
+
+Sem import visual fora da lib; sem cor literal; `danger` em erro; Lucide; scroll único; metadata via hook; Supabase com `.schema()`; RLS authenticated; textos via `t()` quando multi-idioma; tabelas com header de uma palavra, resize e column manager.
+
+## Atualização
+
+Este arquivo é gerado junto do completo por `npm run ds:knowledge`. Em projeto consumidor, rode `npx forlogic-ds-knowledge --compact` e cole `docs/forlogic-core/DS_KNOWLEDGE_COMPACT.md` no Workspace Knowledge.

package/docs/design-system/README.md

@@ -4,7 +4,7 @@
 # Design System — forlogic-core
 
 > Gerado automaticamente
-> Total: 94 componentes documentados em 15 categorias
+> Total: 105 componentes documentados em 15 categorias
 
 ## Categorias