forlogic-core 1.16.10 → 1.16.12

package/.note/memory/features/crud-defaults-batteries-included.md

@@ -0,0 +1,14 @@
+# Memory: features/crud-defaults-batteries-included
+
+Todos os CRUDs (CrudTable, createCrudPage) agora incluem por padrão:
+- **Column resize** (`enableColumnResize=true`) — já era default
+- **Column manager** (`enableColumnManager=true`) — botão ⋮ no header da coluna "Ações"
+- **Sort** — já era suportado via `sortable` nas colunas
+- **Busca** — por padrão usa a busca global do header (não a action bar). Para busca na action bar, usar `showSearch=true`
+- **Storage keys** — `createCrudPage` gera automaticamente `columnManagerStorageKey` e `resizeStorageKey` a partir do `entityName`
+
+**NÃO vem por padrão:**
+- **Agrupamento** (`enableGrouping=false`) — precisa ser habilitado explicitamente com `enableGrouping={true}`
+- **Busca na action bar** (`showSearch=false`) — padrão é busca no header
+
+**Paginação:** padrão de 25 itens por página.

package/.note/memory/patterns/alias-url-resolution.md

@@ -0,0 +1,39 @@
+# Alias via URL — Resolução de Unidade por Rota
+
+## Padrão
+
+O alias da unidade ativa deve **sempre** estar presente na URL como primeiro segmento de rota (`/:alias/...`). O `AliasRouteGuard` garante sincronização bidirecional entre URL e sessão.
+
+## Componentes
+
+### `useAliasFromUrl(options?)`
+Hook que extrai o alias do param de rota e valida contra `companies` do `useAuth()`.
+
+Retorna: `{ urlAlias, isAliasMismatch, isValidAlias, isMissing, matchedCompany }`
+
+### `AliasRouteGuard`
+Wrapper de rota que sincroniza alias da URL com a sessão. Comportamento:
+
+| Cenário | Ação |
+|---------|------|
+| Alias ausente na URL | Redireciona para `/{aliasAtivo}/{path}` |
+| Alias diferente do ativo | Chama `switchUnit()` + loading |
+| Alias correto | Renderiza children |
+| Alias inválido | Redireciona para `/{aliasDefault}/{path}` |
+| Troca via seletor de unidades | Atualiza URL automaticamente |
+
+## Uso nos Consumidores
+
+```tsx
+<Route element={<ProtectedRoute><AliasRouteGuard><Outlet /></AliasRouteGuard></ProtectedRoute>}>
+  <Route path="/:alias/documents" element={<DocumentsPage />} />
+  <Route path="/:alias/documents/:id" element={<DocumentDetailPage />} />
+</Route>
+```
+
+## Regras
+- Guard só age após `isLoading=false && isAuthenticated=true`
+- Usa `replace: true` para evitar poluir o histórico
+- Se `switchUnit` falha, mantém alias atual (sem loop)
+- `switchUnit` já faz `queryClient.clear()` — cache é limpo automaticamente
+- Navegação inter-módulos já usa `{alias}` nas URLs (`modulesData.ts`)

package/.note/memory/{rules → patterns}/doc-sync-rule.md

@@ -29,4 +29,4 @@ lib/services/<Service>.ts         → src/design-system/docs/ServicesDoc.tsx
 lib/components/layout/<comp>.tsx  → src/design-system/docs/components/layout/<Comp>Doc.tsx
 ```
 
-Consultar `.note/memory/documentation/consolidated-components-registry.md` para componentes agrupados sob uma única doc.
+Consultar `.note/memory/patterns/components-registry.md` para componentes agrupados sob uma única doc.

package/.note/memory/patterns/dynamic-supabase-config.md

@@ -0,0 +1,4 @@
+# Memory: patterns/dynamic-supabase-config
+Updated: 2026-03-24
+
+As credenciais do Supabase vêm exclusivamente do `.env` (auto-populado pelo Lovable ao trocar banco). O Vite injeta automaticamente variáveis `VITE_*` em `import.meta.env` — não há bloco `define` manual nem extração de `client.ts`. O `vite.config.ts` usa `loadEnv()` apenas para ler o project ID no contexto Node (CSP headers). O `SupabaseSingleton` lê `import.meta.env.VITE_SUPABASE_URL` e `VITE_SUPABASE_PUBLISHABLE_KEY` em runtime no browser.

package/.note/memory/patterns/environment-detection-logic.md

@@ -0,0 +1,35 @@
+# Memory: patterns/environment-detection-logic
+Updated: 2026-03-24
+
+O sistema separa duas preocupações independentes de ambiente:
+
+## 1. Método de autenticação (`shouldUseDevTokens()` / `isLovablePreview()`)
+Detecta se o app roda em contexto de desenvolvimento (preview Lovable via iframe, `*.lovable.dev`, localhost ou `import.meta.env.DEV`). Quando true, usa a edge function `dev-tokens` do Supabase conectado para autenticar. Quando false (app publicado), usa OAuth padrão do Qualiex.
+
+## 2. Qual API usar (`getEnvironmentConfig()` / `isDevSupabaseProject()`)
+Compara o project ID do Supabase conectado com `PROD_PROJECT_ID` (`ccjfvpnndclajkleyqkc`). Se igual → config PROD (API prod, OAuth prod). Se diferente → config DEV (API dev, OAuth dev).
+
+## Fonte de verdade do Project ID
+O project ID vem do `.env` (auto-populado pelo Lovable ao trocar banco), que o Vite injeta automaticamente em `import.meta.env.VITE_SUPABASE_PROJECT_ID`. **Não** é extraído de `src/integrations/supabase/client.ts`. O `vite.config.ts` usa `loadEnv()` apenas no contexto Node para configurar CSP headers.
+
+## Tabela de regras
+
+| Cenário                      | API  | Auth       |
+|------------------------------|------|------------|
+| Preview + Prod Supabase      | Prod | dev-tokens |
+| Preview + Dev Supabase       | Dev  | dev-tokens |
+| Publicado + Prod Supabase    | Prod | OAuth      |
+| Publicado + Dev Supabase     | Dev  | OAuth      |
+
+## Guard de troca de projeto (`TokenManager.checkProjectMismatch()`)
+Ao inicializar (`AuthService.initialize()`), o sistema compara `import.meta.env.VITE_SUPABASE_PROJECT_ID` com o valor armazenado em `localStorage('supabase_project_id')`. Se diferente, limpa todos os tokens stale automaticamente antes de qualquer chamada a `validate-token`, evitando 401 desnecessários. Após a limpeza, armazena o novo project ID. Isso garante transição limpa ao trocar de banco Supabase sem erros ou blank screen.
+
+## Funções (lib/config/index.ts)
+- `isLovablePreview()` — detecta contexto de preview/localhost
+- `shouldUseDevTokens()` — wrapper semântico sobre `isLovablePreview()`
+- `isDevEnvironment` — alias deprecated, mantido para compatibilidade
+- `getEnvironmentConfig()` — retorna config PROD ou DEV baseado no project ID
+- `isDevSupabaseProject()` — true se project ID ≠ PROD_PROJECT_ID
+
+## Funções (lib/auth/services/TokenManager.ts)
+- `checkProjectMismatch()` — detecta troca de projeto Supabase e limpa tokens stale

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

@@ -0,0 +1,25 @@
+import React from 'react';
+export interface AliasRouteGuardProps {
+    children: React.ReactNode;
+    /** Nome do param de rota (default: "alias") */
+    paramName?: string;
+}
+/**
+ * Guard de rota que sincroniza o alias da URL com a sessão de autenticação.
+ *
+ * Comportamento:
+ * - **Alias ausente na URL** → Redireciona para `/{aliasAtivo}/{restoDoPath}` (replace)
+ * - **Alias presente mas diferente do ativo** → Chama `switchUnit()` + loading
+ * - **Alias presente e correto** → Renderiza children
+ * - **Alias inválido (não existe em companies)** → Redireciona para `/{aliasDefault}/{restoDoPath}`
+ * - **Troca via seletor de unidades** → Atualiza URL automaticamente
+ *
+ * @example
+ * ```tsx
+ * <Route element={<AliasRouteGuard><Outlet /></AliasRouteGuard>}>
+ *   <Route path="/:alias/documents" element={<DocumentsPage />} />
+ *   <Route path="/:alias/documents/:id" element={<DocumentDetailPage />} />
+ * </Route>
+ * ```
+ */
+export declare function AliasRouteGuard({ children, paramName }: AliasRouteGuardProps): import("react/jsx-runtime").JSX.Element;

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

@@ -20,7 +20,7 @@ export declare class AuthService {
     /**
      * Logout do usuário
      */
-    static logout(): void;
+    static logout(): Promise<void>;
     /**
      * Decodifica um token JWT usando TokenService robusto
      */

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

@@ -16,6 +16,12 @@ export declare const TokenManager: {
     generateOAuthState: () => string;
     generateOAuthNonce: () => string;
     hasAllTokens: () => boolean;
+    /**
+     * Detecta troca de projeto Supabase e limpa tokens stale automaticamente.
+     * Deve ser chamado ANTES de qualquer validação de token.
+     * Retorna true se houve troca (tokens foram limpos).
+     */
+    checkProjectMismatch: () => boolean;
     setSupabaseToken: (token: string) => void;
     areAllTokensValid: () => boolean;
     clearExpiredTokens: () => boolean;

package/dist/bin/pull-docs.js

@@ -29,26 +29,73 @@ function copyFile(src, dest) {
   fs.copyFileSync(src, dest);
   return true;
 }
-function copyDirRecursive(src, dest) {
-  if (!fs.existsSync(src)) {
-    return 0;
-  }
-  let count = 0;
-  if (!fs.existsSync(dest)) {
-    fs.mkdirSync(dest, { recursive: true });
-  }
-  const entries = fs.readdirSync(src, { withFileTypes: true });
-  for (const entry of entries) {
-    const srcPath = path.join(src, entry.name);
-    const destPath = path.join(dest, entry.name);
-    if (entry.isDirectory()) {
-      count += copyDirRecursive(srcPath, destPath);
-    } else {
-      fs.copyFileSync(srcPath, destPath);
-      count++;
+const README_MARKER = "<!-- managed by lib-update -->";
+function generateProjectReadme(readmePath, projectName, coreVersion) {
+  const template = `${README_MARKER}
+# ${projectName}
+
+> Projeto baseado em [forlogic-core](https://www.npmjs.com/package/forlogic-core) v${coreVersion}
+
+## Setup
+
+\`\`\`bash
+# Instalar depend\xEAncias
+npm install
+
+# Rodar em desenvolvimento
+npm run dev
+
+# Build de produ\xE7\xE3o
+npm run build
+\`\`\`
+
+## Scripts Dispon\xEDveis
+
+| Comando | Descri\xE7\xE3o |
+|---------|-----------|
+| \`npm run dev\` | Servidor de desenvolvimento (Vite) |
+| \`npm run build\` | Build de produ\xE7\xE3o |
+| \`npm run preview\` | Preview do build |
+| \`npx lib-update\` | Sincronizar regras e docs do forlogic-core |
+
+## Documenta\xE7\xE3o
+
+- \u{1F4D6} **Regras do projeto**: \`docs/KNOWLEDGE.md\`
+- \u{1F916} **Mem\xF3rias da IA**: \`.note/memory/\`
+- \u{1F3A8} **Design System**: Rota \`/ds\` no app (projeto Admin)
+- \u{1F4E6} **forlogic-core**: [README no npm](https://www.npmjs.com/package/forlogic-core)
+
+## Conven\xE7\xF5es
+
+- Schema Supabase: \`common\` (nunca \`public\`)
+- Soft delete obrigat\xF3rio (coluna \`deleted_at\`)
+- Sempre usar componentes do \`forlogic-core\` antes de criar novos
+- RLS policies: nunca \`FOR DELETE\`
+
+---
+*Gerado automaticamente por \`lib-update\`. \xDAltima sync: forlogic-core v${coreVersion}*
+${README_MARKER}`;
+  if (fs.existsSync(readmePath)) {
+    const existing = fs.readFileSync(readmePath, "utf-8");
+    if (existing.includes(README_MARKER)) {
+      const markerRegex = new RegExp(
+        `${README_MARKER.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}[\\s\\S]*?${README_MARKER.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}`,
+        "m"
+      );
+      const updated2 = existing.replace(markerRegex, template);
+      fs.writeFileSync(readmePath, updated2, "utf-8");
+      return true;
     }
+    const updated = template + "\n\n" + existing;
+    fs.writeFileSync(readmePath, updated, "utf-8");
+    return true;
+  }
+  const destDir = path.dirname(readmePath);
+  if (!fs.existsSync(destDir)) {
+    fs.mkdirSync(destDir, { recursive: true });
   }
-  return count;
+  fs.writeFileSync(readmePath, template, "utf-8");
+  return true;
 }
 async function syncDocs() {
   console.log("\u{1F4E5} Sincronizando regras e conven\xE7\xF5es do forlogic-core...\n");
@@ -79,15 +126,46 @@ async function syncDocs() {
       errorCount++;
     }
   }
-  const rulesSrc = path.join(pkgPath, ".note", "memory", "rules");
-  const rulesDest = path.join(projectRoot, ".note", "memory", "rules");
-  if (fs.existsSync(rulesSrc)) {
-    const filesCopied = copyDirRecursive(rulesSrc, rulesDest);
-    console.log(`\u2705 .note/memory/rules/ (${filesCopied} arquivos)`);
+  const obsoleteFiles = [
+    "docs/DESIGN_SYSTEM.md",
+    "docs/COMPONENTS.md",
+    "docs/PATTERNS.md",
+    ".note/memory/rules/supabase-schema-rule.md",
+    ".note/memory/rules/supabase-import-rule.md",
+    ".note/memory/rules/lib-first-rule.md",
+    ".note/memory/rules/no-auto-index-rule.md",
+    ".note/memory/rules/no-delete-policy-rule.md",
+    ".note/memory/rules/no-env-modification-rule.md",
+    ".note/memory/rules/rls-syntax-rule.md",
+    ".note/memory/rules/sql-naming-rule.md",
+    ".note/memory/rules/i18n-import-rule.md",
+    ".note/memory/patterns/deprecated-patterns.md",
+    ".note/memory/patterns/spa-navigation-pattern.md",
+    ".note/memory/architecture/documentation-strategy.md",
+    // Pastas reestruturadas (v2 — padronização 3 pastas)
+    ".note/memory/rules/doc-sync-rule.md",
+    ".note/memory/ui/components/combo-tree.md",
+    ".note/memory/ui/design-system/documentation-standard.md",
+    ".note/memory/documentation/consolidated-components-registry.md"
+  ];
+  let cleanedCount = 0;
+  for (const relPath of obsoleteFiles) {
+    const fullPath = path.join(projectRoot, relPath);
+    if (fs.existsSync(fullPath)) {
+      fs.unlinkSync(fullPath);
+      console.log(`\u{1F5D1}\uFE0F  ${relPath} (removido \u2014 obsoleto)`);
+      cleanedCount++;
+    }
+  }
+  if (cleanedCount > 0) {
+    successCount++;
+  }
+  const projectReadmePath = path.join(projectRoot, "README.md");
+  const projectName = path.basename(projectRoot);
+  const readmeGenerated = generateProjectReadme(projectReadmePath, projectName, pkgJson.version);
+  if (readmeGenerated) {
+    console.log(`\u2705 README.md (gerado/atualizado)`);
     successCount++;
-  } else {
-    console.warn("\u26A0\uFE0F .note/memory/rules/ \u2014 n\xE3o encontrado no pacote");
-    errorCount++;
   }
   console.log("\n\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501");
   console.log(`\u{1F389} Sincroniza\xE7\xE3o conclu\xEDda!`);
@@ -98,8 +176,8 @@ async function syncDocs() {
   console.log("");
   if (successCount > 0) {
     console.log("\u{1F4A1} Arquivos sincronizados:");
-    console.log("   docs/KNOWLEDGE.md \u2014 Regras cr\xEDticas + mapa de m\xF3dulos");
-    console.log("   .note/memory/rules/ \u2014 Regras de schema, RLS, \xEDndices, .env");
+    console.log("   docs/KNOWLEDGE.md \u2014 Regras cr\xEDticas + mapa de m\xF3dulos (fonte \xFAnica de verdade)");
+    console.log("   README.md \u2014 Template com setup, scripts e links");
     console.log("");
     console.log("\u{1F4D6} Documenta\xE7\xE3o de componentes, props e padr\xF5es s\xE3o lidos");
     console.log("   diretamente do forlogic-core via cross-project.\n");

package/dist/config/index.d.ts

@@ -19,6 +19,14 @@ export declare const CRUD_CONFIG: {
 export declare const SEARCH_CONFIG: {
     readonly debounceDelay: 500;
 };
+export declare const isLovablePreview: () => boolean;
+/**
+ * Determines auth method: true → use dev-tokens edge function, false → use OAuth.
+ * This is independent of which API environment (prod/dev) is used — that's decided
+ * by getEnvironmentConfig() based on the Supabase project ID.
+ */
+export declare const shouldUseDevTokens: () => boolean;
+/** @deprecated Use `isLovablePreview()` or `shouldUseDevTokens()` instead */
 export declare const isDevEnvironment: () => boolean;
 export { isDevSupabaseProject } from './environments';
 export declare const getQualiexApiUrl: () => string;

package/dist/crud/components/ColumnSettingsPopover.d.ts

@@ -5,6 +5,7 @@ export interface ColumnSettingsPopoverProps<T> {
     isColumnHidden: (key: string) => boolean;
     toggleColumn: (key: string) => void;
     showAllColumns: () => void;
+    resetColumns?: () => void;
     reorderColumns: (fromIndex: number, toIndex: number) => void;
     /** @deprecated Use groupByColumns + addGroupByColumn + removeGroupByColumn */
     groupByColumn?: string | null;
@@ -14,4 +15,4 @@ export interface ColumnSettingsPopoverProps<T> {
     addGroupByColumn?: (key: string) => void;
     removeGroupByColumn?: (key: string) => void;
 }
-export declare function ColumnSettingsPopover<T extends BaseEntity>({ columns, columnOrder, isColumnHidden, toggleColumn, showAllColumns, reorderColumns, groupByColumn, setGroupByColumn, groupByColumns, addGroupByColumn, removeGroupByColumn, }: ColumnSettingsPopoverProps<T>): import("react/jsx-runtime").JSX.Element;
+export declare function ColumnSettingsPopover<T extends BaseEntity>({ columns, columnOrder, isColumnHidden, toggleColumn, showAllColumns, reorderColumns, groupByColumn, setGroupByColumn, groupByColumns, addGroupByColumn, removeGroupByColumn, resetColumns, }: ColumnSettingsPopoverProps<T>): import("react/jsx-runtime").JSX.Element;

package/dist/crud/components/CrudTable.d.ts

@@ -40,6 +40,8 @@ export interface CrudTableProps<T extends BaseEntity & {
     resizeStorageKey?: string;
     enableColumnManager?: boolean;
     columnManagerStorageKey?: string;
+    /** Habilita agrupamento de colunas (GroupDropZone + opções de grupo no ColumnSettings). Default: false */
+    enableGrouping?: boolean;
 }
-export declare const CrudTable: <T extends BaseEntity>({ manager, columns, onEdit, onView, onToggleStatus, onDelete, renderActions, customRowActions, enableBulkActions, rowActionsVariant, onNew, newButtonLabel, showNewButton, customActions, hideActionBar, showActionBar, showSearch, searchValue, onSearchChange, searchPlaceholder, bulkActions, onBulkDelete, filters, viewMode, onViewModeChange, showViewToggle, enableColumnResize, resizeStorageKey, enableColumnManager, columnManagerStorageKey, }: CrudTableProps<T>) => import("react/jsx-runtime").JSX.Element;
+export declare const CrudTable: <T extends BaseEntity>({ manager, columns, onEdit, onView, onToggleStatus, onDelete, renderActions, customRowActions, enableBulkActions, rowActionsVariant, onNew, newButtonLabel, showNewButton, customActions, hideActionBar, showActionBar, showSearch, searchValue, onSearchChange, searchPlaceholder, bulkActions, onBulkDelete, filters, viewMode, onViewModeChange, showViewToggle, enableColumnResize, resizeStorageKey, enableColumnManager, columnManagerStorageKey, enableGrouping, }: CrudTableProps<T>) => import("react/jsx-runtime").JSX.Element;
 export default CrudTable;

package/dist/crud/hooks/useColumnManager.d.ts

@@ -20,6 +20,8 @@ export interface UseColumnManagerReturn<T> {
     toggleColumn: (key: string) => void;
     /** Show all columns */
     showAllColumns: () => void;
+    /** Reset columns to default order and visibility */
+    resetColumns: () => void;
     /** Current column order (keys) */
     columnOrder: string[];
     /** Reorder columns */

package/dist/crud/primitives/TreeTable.d.ts

@@ -1,2 +1,2 @@
 import type { TreeNode, TreeTableProps } from './types';
-export declare function TreeTable<T extends TreeNode>({ data, columns, nameKey, nameHeader, iconComponent, expandedIds, onToggleExpand, onRowClick, renderActions, actionsHeader, rowActionsVariant, isLoading, emptyMessage, className, }: TreeTableProps<T>): import("react/jsx-runtime").JSX.Element;
+export declare function TreeTable<T extends TreeNode>({ data, columns, nameKey, nameHeader, iconComponent, expandedIds, onToggleExpand, onRowClick, renderActions, actionsHeader, rowActionsVariant, isLoading, emptyMessage, className, enableSelection, selectedIds: selectedIdsArray, onSelectItem, onSelectAll, isAllSelected, enableRowDrag, onMoveNode, onMoveNodes, }: TreeTableProps<T>): import("react/jsx-runtime").JSX.Element;

package/dist/crud/primitives/types.d.ts

@@ -98,6 +98,17 @@ export interface TreeTableProps<T extends TreeNode = TreeNode> {
     isLoading?: boolean;
     emptyMessage?: string;
     className?: string;
+    enableSelection?: boolean;
+    selectedIds?: string[];
+    onSelectItem?: (id: string) => void;
+    onSelectAll?: () => void;
+    isAllSelected?: boolean;
+    /** Habilita drag-and-drop de linhas para reordenar a hierarquia */
+    enableRowDrag?: boolean;
+    /** Callback ao mover um nó: targetId=null significa tornar raiz */
+    onMoveNode?: (draggedId: string, targetId: string | null) => void;
+    /** Callback ao mover múltiplos nós (seleção em lote): targetId=null significa tornar raiz */
+    onMoveNodes?: (draggedIds: string[], targetId: string | null) => void;
 }
 export interface FilterBarProps {
     searchValue?: string;

package/dist/docs/KNOWLEDGE.md

@@ -98,10 +98,12 @@ supabase.from('tabela').select('*');
 
 ## 6. Fontes de Contexto
 
-| Fonte | Caminho |
-|-------|---------|
-| Memory rules | `.note/memory/rules/` |
-| Memory patterns | `.note/memory/patterns/` |
-| Memory components | `.note/memory/components/` |
-| Código-fonte da lib | Cross-project → projeto **Admin** (forlogic-core) |
-| Design System (visual) | Rota `/ds` no app do projeto **Admin** |
+| Fonte | Caminho | Conteúdo |
+|-------|---------|----------|
+| Memory components | `.note/memory/components/` | Props, variantes e exemplos de componentes |
+| Memory patterns | `.note/memory/patterns/` | Layouts, setup, convenções, regras do projeto |
+| Memory features | `.note/memory/features/` | Contexto de features específicas do projeto |
+| Código-fonte da lib | Cross-project → projeto **Admin** (forlogic-core) | Props, tipos, implementação |
+| Design System (visual) | Rota `/ds` no app do projeto **Admin** | Documentação interativa |
+
+> ℹ️ `.note/memory/` usa 3 pastas padronizadas: `components/`, `patterns/`, `features/`. `KNOWLEDGE.md` é a fonte única de verdade para regras e convenções.

package/dist/hooks/useAliasFromUrl.d.ts

@@ -0,0 +1,33 @@
+export interface UseAliasFromUrlOptions {
+    /** Nome do param de rota (default: "alias") */
+    paramName?: string;
+}
+export interface UseAliasFromUrlReturn {
+    /** Alias extraído da URL (ou null se ausente) */
+    urlAlias: string | null;
+    /** true se há alias na URL e é diferente do alias ativo */
+    isAliasMismatch: boolean;
+    /** true se o alias da URL existe nas companies do usuário */
+    isValidAlias: boolean;
+    /** true se não há alias na URL */
+    isMissing: boolean;
+    /** Company correspondente ao alias da URL (ou null) */
+    matchedCompany: {
+        id: string;
+        alias: string;
+        name: string;
+    } | null;
+}
+/**
+ * Hook para extrair e validar o alias da URL contra as companies do usuário.
+ *
+ * Lê o param `:alias` do React Router e verifica se é um alias válido
+ * (presente na lista de companies do token de autenticação).
+ *
+ * @example
+ * ```tsx
+ * // Rota: /:alias/documents
+ * const { urlAlias, isAliasMismatch, isValidAlias, isMissing } = useAliasFromUrl();
+ * ```
+ */
+export declare function useAliasFromUrl(options?: UseAliasFromUrlOptions): UseAliasFromUrlReturn;