forlogic-core 3.0.11 → 4.0.0

package/dist/legacy/components/layout/SidebarLogo.d.ts

@@ -0,0 +1,5 @@
+interface SidebarLogoProps {
+    appName?: string;
+}
+export declare function SidebarLogo({ appName }: SidebarLogoProps): import("react").JSX.Element;
+export {};

package/dist/legacy/components/modules/AccessDeniedDialog.d.ts

@@ -0,0 +1,43 @@
+import { ReactNode } from "react";
+import { Module } from "./types";
+export interface AccessDeniedUnit {
+    alias: string;
+    name: string;
+}
+export interface AccessDeniedDialogProps {
+    open: boolean;
+    onOpenChange?: (open: boolean) => void;
+    /** Callback ao clicar em módulo no grid */
+    onModuleClick?: (module: Module) => void;
+    /** Lista de nomes de módulos contratados */
+    contractedModules?: string[];
+    /** Callback quando usuário mostra interesse em módulo não contratado */
+    onModuleInterest?: (module: Module) => void;
+    /** Nome do usuário logado */
+    userName?: string;
+    /** Nome da unidade atual */
+    unitName?: string;
+    /** Lista de unidades disponíveis */
+    units?: AccessDeniedUnit[];
+    /** Alias da unidade atual */
+    currentAlias?: string;
+    /** Callback ao trocar de unidade */
+    onUnitChange?: (unit: AccessDeniedUnit) => void;
+    /** Callback ao fazer logout */
+    onLogout?: () => void;
+    /** URL do Forlogic Educa */
+    educaUrl?: string;
+    /** URL do Saber Gestão */
+    saberGestaoUrl?: string;
+    /** URL da Wiki */
+    wikiUrl?: string;
+    /** Se true, impede fechar o dialog (padrão: true) */
+    blocking?: boolean;
+    /** Tamanho do dialog (padrão: "lg") */
+    size?: "sm" | "md" | "lg";
+    /** Conteúdo customizado que substitui o ModulesContent (grid de módulos). Header e footer são mantidos. */
+    children?: ReactNode;
+    /** Identificador do módulo de origem. Usado em analytics. */
+    sourceModule?: string;
+}
+export declare function AccessDeniedDialog({ open, onOpenChange, onModuleClick, contractedModules, onModuleInterest, userName, unitName, units, currentAlias, onUnitChange, onLogout, educaUrl, saberGestaoUrl, wikiUrl, blocking, size, children, sourceModule, }: AccessDeniedDialogProps): import("react").JSX.Element;

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

@@ -0,0 +1,61 @@
+import { type ReactNode } from "react";
+import { Module } from "./types";
+export interface ModuleAccessGuardProps {
+    children: ReactNode;
+    /** Lista de nomes de módulos contratados */
+    contractedModules?: string[];
+    /** Callback ao clicar em módulo no grid */
+    onModuleClick?: (module: Module) => void;
+    /** Callback quando usuário mostra interesse em módulo não contratado */
+    onModuleInterest?: (module: Module) => void;
+    /** URL do Forlogic Educa */
+    educaUrl?: string;
+    /** URL do Saber Gestão */
+    saberGestaoUrl?: string;
+    /** URL da Wiki */
+    wikiUrl?: string;
+    /**
+     * Rotas que ignoram o guard (bypass).
+     * Suporta glob simples com `*` no final: `/public/*` faz match com `/public/qualquer-coisa`.
+     * Sem `bypassPaths` → comportamento padrão (todas as rotas protegidas).
+     */
+    bypassPaths?: string[];
+    /**
+     * Path para redirecionar usuários autenticados SEM acesso ao módulo, em vez
+     * de exibir a tela de bloqueio. Útil quando há uma rota pública (ex.: `/fe`)
+     * que deve receber esses usuários.
+     *
+     * Combine com `noAccessRedirectMode='always'` para redirecionar em qualquer
+     * rota privada acessada. Se o path começar com `/` e a URL atual tiver um
+     * alias na primeira posição, o alias é prefixado automaticamente.
+     *
+     * Sem `noAccessRedirectPath` → mantém o comportamento padrão (AccessDeniedDialog).
+     */
+    noAccessRedirectPath?: string;
+    /**
+     * Quando deve disparar o redirect:
+     * - `'always'` (default quando `noAccessRedirectPath` é definido): redireciona
+     *   em qualquer rota privada onde o usuário não tem acesso.
+     * - `'never'`: nunca redireciona (mantém AccessDeniedDialog).
+     */
+    noAccessRedirectMode?: 'always' | 'never';
+    /**
+     * Mapa declarativo de rotas → conteúdo customizado no dialog de acesso negado.
+     * As chaves são paths (suportam glob com `*` no final).
+     * Se a rota atual faz match, o conteúdo substitui o grid de módulos.
+     * Se nenhuma rota faz match → grid padrão.
+     *
+     * Defina em arquivo separado para manter o App.tsx limpo:
+     * ```tsx
+     * // src/config/accessDeniedRoutes.tsx
+     * export const accessDeniedRoutes = {
+     *   '/docs/matrix-link': <ModuleOfferContent title={t('know_staff')} ... />,
+     *   '/reports/*': <ModuleOfferContent title="Relatórios" ... />,
+     * };
+     * ```
+     */
+    accessDeniedRoutes?: Record<string, ReactNode>;
+    /** Identificador do módulo de origem. Usado em analytics. */
+    sourceModule?: string;
+}
+export declare function ModuleAccessGuard({ children, contractedModules, onModuleClick, onModuleInterest, educaUrl, saberGestaoUrl, wikiUrl, bypassPaths, noAccessRedirectPath, noAccessRedirectMode, accessDeniedRoutes, sourceModule, }: ModuleAccessGuardProps): import("react").JSX.Element;

package/dist/legacy/components/modules/ModuleGrid.d.ts

@@ -0,0 +1,9 @@
+import { Module } from "./types";
+interface ModuleGridProps {
+    modules: Module[];
+    onModuleClick?: (module: Module) => void;
+    contractedModules?: string[];
+    onModuleInterest?: (module: Module) => void;
+}
+export declare function ModuleGrid({ modules, onModuleClick, contractedModules, onModuleInterest, }: ModuleGridProps): import("react").JSX.Element;
+export {};

package/dist/legacy/components/modules/ModuleOfferContent.d.ts

@@ -0,0 +1,20 @@
+import React, { ReactNode } from "react";
+export interface ModuleOfferContentProps {
+    /** Título da oferta — ex: "Conheça o módulo Educação, da suíte SABER." */
+    title: string;
+    /** Descrição da oferta */
+    description: string;
+    /** URL de imagem/ilustração */
+    image?: string;
+    /** Ícone alternativo à imagem */
+    icon?: React.ComponentType<{
+        className?: string;
+    }>;
+    /** Texto do botão CTA */
+    ctaLabel?: string;
+    /** Ação do botão CTA */
+    onCtaClick?: () => void;
+    /** Conteúdo 100% livre — substitui image + CTA quando fornecido */
+    children?: ReactNode;
+}
+export declare function ModuleOfferContent({ title, description, image, icon: Icon, ctaLabel, onCtaClick, children, }: ModuleOfferContentProps): React.JSX.Element;

package/dist/legacy/components/modules/ModulesContent.d.ts

@@ -0,0 +1,23 @@
+import { Module } from "./types";
+export interface ModulesContentProps {
+    onModuleClick?: (module: Module) => void;
+    /** Lista de nomes de módulos contratados. Se não fornecido, todos aparecem como contratados. */
+    contractedModules?: string[];
+    /** Callback quando usuário mostra interesse em módulo não contratado */
+    onModuleInterest?: (module: Module) => void;
+    /** URL para redirecionar quando clicar em módulo não contratado */
+    nonContractedUrl?: string;
+    /** URL do Forlogic Educa (suporta placeholder {alias}) */
+    educaUrl?: string;
+    /** URL do Saber Gestão */
+    saberGestaoUrl?: string;
+    /** URL da Wiki */
+    wikiUrl?: string;
+    /** Alias ativo para resolver placeholders {alias} nas URLs */
+    alias?: string;
+    /** Identificador do módulo de origem (de onde o menu foi aberto). Usado em analytics. */
+    sourceModule?: string;
+    /** Exibe o grupo "Backoffice" no menu. Restrito a usuários SysAdmin. */
+    showAdminGroup?: boolean;
+}
+export declare function ModulesContent({ onModuleClick, contractedModules, onModuleInterest, nonContractedUrl, educaUrl, saberGestaoUrl, wikiUrl, alias, sourceModule, showAdminGroup, }: ModulesContentProps): import("react").JSX.Element;

package/dist/legacy/components/modules/ModulesDialog.d.ts

@@ -0,0 +1,3 @@
+import { ModulesDialogProps } from "./types";
+export declare function ModulesDialog({ open, onOpenChange, onModuleClick, contractedModules, onModuleInterest, educaUrl, saberGestaoUrl, wikiUrl, sourceModule, showAdminGroup, }: ModulesDialogProps): import("react").JSX.Element;
+export default ModulesDialog;

package/dist/legacy/components/modules/ModulesFooterCards.d.ts

@@ -0,0 +1,10 @@
+export interface ModulesFooterCardsProps {
+    educaUrl?: string;
+    saberGestaoUrl?: string;
+    wikiUrl?: string;
+    /** Alias ativo para resolver placeholders {alias} nas URLs */
+    alias?: string;
+    /** Identificador do módulo de origem. Usado em analytics. */
+    sourceModule?: string;
+}
+export declare function ModulesFooterCards({ educaUrl, saberGestaoUrl, wikiUrl, alias, sourceModule, }: ModulesFooterCardsProps): import("react").JSX.Element;

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

@@ -0,0 +1,20 @@
+import React from "react";
+interface IconProps {
+    className?: string;
+}
+/**
+ * Ícone outline do Qualiex para marca d'água
+ * Usado no card t('learn_qualiex')
+ */
+export declare function QualiexOutlineIcon({ className }: IconProps): React.JSX.Element;
+/**
+ * Ícone outline do Saber Gestão para marca d'água
+ * Usado no card t('know_saber_gestao')
+ */
+export declare function SaberGestaoOutlineIcon({ className }: IconProps): React.JSX.Element;
+/**
+ * Ícone de livro/wiki para marca d'água
+ * Usado no card "Dúvidas sobre os módulos?"
+ */
+export declare function WikiOutlineIcon({ className }: IconProps): React.JSX.Element;
+export {};

package/dist/legacy/components/modules/types.d.ts

@@ -0,0 +1,45 @@
+import React from "react";
+import { OnboardingStep } from "../ui/onboarding-dialog";
+export interface Module {
+    name: string;
+    description?: string;
+    color: string;
+    icon?: React.ComponentType<{
+        className?: string;
+    }>;
+    url?: string;
+    /** Alias do software no SOFTWARES_MAP para mapeamento dinâmico de contratação */
+    softwareAlias?: string;
+    /** Steps do onboarding para módulos não contratados */
+    onboardingSteps?: OnboardingStep[];
+    /** Quando true, o módulo é sempre tratado como contratado (não passa pelo filtro de contractedModules). */
+    alwaysContracted?: boolean;
+}
+export interface ModuleGroup {
+    id: string;
+    label: string;
+    modules: Module[];
+}
+export interface ModulesDialogProps {
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    onModuleClick?: (module: Module) => void;
+    /** Lista de nomes de módulos contratados. Se não fornecido, todos aparecem como contratados. */
+    contractedModules?: string[];
+    /** Callback quando usuário mostra interesse em módulo não contratado (após onboarding) */
+    onModuleInterest?: (module: Module) => void;
+    /** URL para redirecionar quando clicar em módulo não contratado */
+    nonContractedUrl?: string;
+    /** URL do Forlogic Educa (suporta placeholder {alias}) */
+    educaUrl?: string;
+    /** URL do Saber Gestão */
+    saberGestaoUrl?: string;
+    /** @deprecated Use educaUrl. URL da wiki (mantido para compatibilidade) */
+    wikiUrl?: string;
+    /** @deprecated Não mais utilizado no novo layout */
+    allModulesUrl?: string;
+    /** Identificador do módulo de origem (de onde o menu foi aberto). Usado em analytics. */
+    sourceModule?: string;
+    /** Quando true, inclui o card "Backoffice" ao final da aba Qualiex. Restrito a SysAdmin. Quando omitido, o ModulesDialog deriva de `user.isSysAdmin`. */
+    showAdminGroup?: boolean;
+}

package/dist/legacy/components/ui/alert-dialog.d.ts

@@ -0,0 +1,102 @@
+/**
+ * @module AlertDialog
+ * Diálogo modal **não-dismissable** para confirmação de ações destrutivas/irreversíveis
+ * (excluir, descartar). Difere de `Dialog`: não pode ser fechado clicando fora ou ESC sem
+ * uma escolha explícita (`AlertDialogAction` ou `AlertDialogCancel`).
+ *
+ * Para diálogos de formulário, edição ou exibição livre de conteúdo, use `Dialog`.
+ *
+ * @example
+ * ```tsx
+ * <AlertDialog>
+ *   <AlertDialogTrigger asChild><Button variant="danger">Excluir</Button></AlertDialogTrigger>
+ *   <AlertDialogContent>
+ *     <AlertDialogHeader>
+ *       <AlertDialogTitle>Confirmar exclusão</AlertDialogTitle>
+ *       <AlertDialogDescription>Esta ação não pode ser desfeita.</AlertDialogDescription>
+ *     </AlertDialogHeader>
+ *     <AlertDialogFooter>
+ *       <AlertDialogCancel>Cancelar</AlertDialogCancel>
+ *       <AlertDialogAction onClick={onDelete}>Excluir</AlertDialogAction>
+ *     </AlertDialogFooter>
+ *   </AlertDialogContent>
+ * </AlertDialog>
+ * ```
+ *
+ * @see `docs/design-system/dialogs.md`
+ */
+import * as React from "react";
+import * as AlertDialogPrimitive from "@radix-ui/react-alert-dialog";
+/**
+ * Raiz do AlertDialog. Controla estado open/onOpenChange.
+ * @example
+ * <AlertDialog open={open} onOpenChange={setOpen}>...</AlertDialog>
+ */
+declare const AlertDialog: React.FC<AlertDialogPrimitive.AlertDialogProps>;
+/**
+ * Elemento que dispara a abertura do AlertDialog. Use `asChild` para customizar.
+ * @example
+ * <AlertDialogTrigger asChild><Button variant="danger">Excluir</Button></AlertDialogTrigger>
+ */
+declare const AlertDialogTrigger: React.ForwardRefExoticComponent<AlertDialogPrimitive.AlertDialogTriggerProps & React.RefAttributes<HTMLButtonElement>>;
+/**
+ * Portal que renderiza o conteúdo fora da árvore DOM atual.
+ * @example
+ * <AlertDialogPortal><AlertDialogOverlay /><AlertDialogContent>...</AlertDialogContent></AlertDialogPortal>
+ */
+declare const AlertDialogPortal: React.FC<AlertDialogPrimitive.AlertDialogPortalProps>;
+/**
+ * Overlay escuro renderizado atrás do conteúdo. Usado internamente por `AlertDialogContent`.
+ * @example
+ * <AlertDialogPortal><AlertDialogOverlay /></AlertDialogPortal>
+ */
+declare const AlertDialogOverlay: React.ForwardRefExoticComponent<Omit<AlertDialogPrimitive.AlertDialogOverlayProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+/**
+ * Container do conteúdo modal centralizado. Inclui automaticamente Portal e Overlay.
+ * @example
+ * <AlertDialogContent><AlertDialogHeader>...</AlertDialogHeader></AlertDialogContent>
+ */
+declare const AlertDialogContent: React.ForwardRefExoticComponent<Omit<AlertDialogPrimitive.AlertDialogContentProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+/**
+ * Cabeçalho do AlertDialog. Agrupa `AlertDialogTitle` e `AlertDialogDescription`.
+ * @example
+ * <AlertDialogHeader><AlertDialogTitle>Confirmar</AlertDialogTitle></AlertDialogHeader>
+ */
+declare const AlertDialogHeader: {
+    ({ className, ...props }: React.HTMLAttributes<HTMLDivElement>): React.JSX.Element;
+    displayName: string;
+};
+/**
+ * Rodapé do AlertDialog. Alinha botões de ação à direita em desktop.
+ * @example
+ * <AlertDialogFooter><AlertDialogCancel>Cancelar</AlertDialogCancel><AlertDialogAction>OK</AlertDialogAction></AlertDialogFooter>
+ */
+declare const AlertDialogFooter: {
+    ({ className, ...props }: React.HTMLAttributes<HTMLDivElement>): React.JSX.Element;
+    displayName: string;
+};
+/**
+ * Título do AlertDialog (text-lg, font-semibold).
+ * @example
+ * <AlertDialogTitle>Confirmar exclusão</AlertDialogTitle>
+ */
+declare const AlertDialogTitle: React.ForwardRefExoticComponent<Omit<AlertDialogPrimitive.AlertDialogTitleProps & React.RefAttributes<HTMLHeadingElement>, "ref"> & React.RefAttributes<HTMLHeadingElement>>;
+/**
+ * Descrição/contexto da ação (text-sm, muted).
+ * @example
+ * <AlertDialogDescription>Esta ação não pode ser desfeita.</AlertDialogDescription>
+ */
+declare const AlertDialogDescription: React.ForwardRefExoticComponent<Omit<AlertDialogPrimitive.AlertDialogDescriptionProps & React.RefAttributes<HTMLParagraphElement>, "ref"> & React.RefAttributes<HTMLParagraphElement>>;
+/**
+ * Botão de ação confirmatória. Estiliza com `buttonVariants()` padrão.
+ * @example
+ * <AlertDialogAction onClick={onDelete}>Excluir</AlertDialogAction>
+ */
+declare const AlertDialogAction: React.ForwardRefExoticComponent<Omit<AlertDialogPrimitive.AlertDialogActionProps & React.RefAttributes<HTMLButtonElement>, "ref"> & React.RefAttributes<HTMLButtonElement>>;
+/**
+ * Botão de cancelamento (variante outline). Fecha o dialog sem confirmar.
+ * @example
+ * <AlertDialogCancel>Cancelar</AlertDialogCancel>
+ */
+declare const AlertDialogCancel: React.ForwardRefExoticComponent<Omit<AlertDialogPrimitive.AlertDialogCancelProps & React.RefAttributes<HTMLButtonElement>, "ref"> & React.RefAttributes<HTMLButtonElement>>;
+export { AlertDialog, AlertDialogPortal, AlertDialogOverlay, AlertDialogTrigger, AlertDialogContent, AlertDialogHeader, AlertDialogFooter, AlertDialogTitle, AlertDialogDescription, AlertDialogAction, AlertDialogCancel, };

package/dist/legacy/components/ui/alert.d.ts

@@ -0,0 +1,44 @@
+import * as React from "react";
+import { type VariantProps } from "class-variance-authority";
+declare const alertVariants: (props?: {
+    variant?: "danger" | "info" | "success" | "warning";
+} & import("class-variance-authority/types").ClassProp) => string;
+interface AlertProps extends React.HTMLAttributes<HTMLDivElement>, VariantProps<typeof alertVariants> {
+    /** Exibe o ícone semântico automático da variante (default `true`). */
+    showIcon?: boolean;
+}
+/**
+ * Bloco de mensagem semântica com ícone automático por variante.
+ *
+ * Variantes (todas com tokens dedicados em `index.css`):
+ * - `info` (default): Info azul — informações neutras.
+ * - `warning`: Atenção amarela — atenção sem bloqueio.
+ * - `danger`: AlertTriangle vermelho — erro ou ação destrutiva. **Use `danger`, não `destructive`.**
+ * - `success`: CheckCircle verde — confirmação.
+ *
+ * Composição: `Alert` (raiz) + `AlertTitle` (opcional) + `AlertDescription`.
+ *
+ * @example
+ * ```tsx
+ * <Alert variant="warning">
+ *   <AlertTitle>Atenção</AlertTitle>
+ *   <AlertDescription>Existem alterações não salvas.</AlertDescription>
+ * </Alert>
+ * ```
+ *
+ * @see `docs/design-system/notifications-feedback.md`
+ */
+declare const Alert: React.ForwardRefExoticComponent<AlertProps & React.RefAttributes<HTMLDivElement>>;
+/**
+ * Componente `AlertTitle` da lib.
+ * @example
+ * <AlertTitle />
+ */
+declare const AlertTitle: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLHeadingElement> & React.RefAttributes<HTMLParagraphElement>>;
+/**
+ * Componente `AlertDescription` da lib.
+ * @example
+ * <AlertDescription />
+ */
+declare const AlertDescription: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLParagraphElement> & React.RefAttributes<HTMLParagraphElement>>;
+export { Alert, AlertTitle, AlertDescription };

package/dist/legacy/components/ui/badge.d.ts

@@ -0,0 +1,41 @@
+import * as React from "react";
+import { type VariantProps } from "class-variance-authority";
+/**
+ * CVA com variantes do `Badge`. Exportado para compor estilos em outros componentes.
+ * @example
+ * <div className={badgeVariants({ variant: 'success' })}>Custom</div>
+ */
+declare const badgeVariants: (props?: {
+    variant?: "default" | "secondary" | "outline" | "danger" | "info" | "success" | "warning" | "sharp";
+} & import("class-variance-authority/types").ClassProp) => string;
+/**
+ * Tipo `BadgeProps` exportado pela lib.
+ * @example
+ * const value: BadgeProps = {} as BadgeProps;
+ */
+export interface BadgeProps extends React.HTMLAttributes<HTMLDivElement>, VariantProps<typeof badgeVariants> {
+}
+/**
+ * Etiqueta visual compacta para metadados, contagens ou estados estáticos.
+ *
+ * Variantes:
+ * - `default`: marca primária (azul).
+ * - `secondary`: neutro suave.
+ * - `danger`: erros / ações destrutivas. **Use `danger`, não `destructive`** (padrão da lib).
+ * - `outline`: apenas borda, sem fundo.
+ * - `success` / `warning` / `info`: feedback semântico.
+ * - `sharp`: variante verde-limão de destaque (uso pontual).
+ *
+ * Para estados dinâmicos de processo (Ativo, Pendente, Concluído), prefira
+ * `StatusBadge` da lib (gera cor pastel automaticamente).
+ *
+ * @example
+ * ```tsx
+ * <Badge variant="success">Aprovado</Badge>
+ * <Badge variant="info">Novo</Badge>
+ * ```
+ *
+ * @see Documentação: `docs/design-system/data-display.md`
+ */
+declare const Badge: React.ForwardRefExoticComponent<BadgeProps & React.RefAttributes<HTMLDivElement>>;
+export { Badge, badgeVariants };

package/dist/legacy/components/ui/breadcrumb.d.ts

@@ -0,0 +1,73 @@
+/**
+ * @module Breadcrumb
+ * Trilha de navegação hierárquica. Composto por `Breadcrumb` > `BreadcrumbList` >
+ * `BreadcrumbItem` (com `BreadcrumbLink` ou `BreadcrumbPage`) intercalados por
+ * `BreadcrumbSeparator`. Use `BreadcrumbEllipsis` para colapsar níveis intermediários.
+ *
+ * @example
+ * ```tsx
+ * <Breadcrumb>
+ *   <BreadcrumbList>
+ *     <BreadcrumbItem><BreadcrumbLink href="/">Home</BreadcrumbLink></BreadcrumbItem>
+ *     <BreadcrumbSeparator />
+ *     <BreadcrumbItem><BreadcrumbPage>Atual</BreadcrumbPage></BreadcrumbItem>
+ *   </BreadcrumbList>
+ * </Breadcrumb>
+ * ```
+ *
+ * @see `docs/design-system/navigation.md`
+ */
+import * as React from "react";
+/**
+ * Raiz `<nav aria-label="breadcrumb">`. Aceite separator customizado via prop.
+ * @example
+ * <Breadcrumb><BreadcrumbList>...</BreadcrumbList></Breadcrumb>
+ */
+declare const Breadcrumb: React.ForwardRefExoticComponent<Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLElement>, HTMLElement>, "ref"> & {
+    separator?: React.ReactNode;
+} & React.RefAttributes<HTMLElement>>;
+/**
+ * Lista ordenada `<ol>` que envolve os items.
+ * @example
+ * <BreadcrumbList><BreadcrumbItem>...</BreadcrumbItem></BreadcrumbList>
+ */
+declare const BreadcrumbList: React.ForwardRefExoticComponent<Omit<React.DetailedHTMLProps<React.OlHTMLAttributes<HTMLOListElement>, HTMLOListElement>, "ref"> & React.RefAttributes<HTMLOListElement>>;
+/**
+ * Item individual `<li>`. Contém um `BreadcrumbLink` ou `BreadcrumbPage`.
+ * @example
+ * <BreadcrumbItem><BreadcrumbLink href="/users">Usuários</BreadcrumbLink></BreadcrumbItem>
+ */
+declare const BreadcrumbItem: React.ForwardRefExoticComponent<Omit<React.DetailedHTMLProps<React.LiHTMLAttributes<HTMLLIElement>, HTMLLIElement>, "ref"> & React.RefAttributes<HTMLLIElement>>;
+/**
+ * Link clicável do breadcrumb. Use `asChild` para integrar com React Router.
+ * @example
+ * <BreadcrumbLink asChild><Link to="/users">Usuários</Link></BreadcrumbLink>
+ */
+declare const BreadcrumbLink: React.ForwardRefExoticComponent<Omit<React.DetailedHTMLProps<React.AnchorHTMLAttributes<HTMLAnchorElement>, HTMLAnchorElement>, "ref"> & {
+    asChild?: boolean;
+} & React.RefAttributes<HTMLAnchorElement>>;
+/**
+ * Página atual (não clicável). Marca semanticamente com `aria-current="page"`.
+ * @example
+ * <BreadcrumbPage>Editar usuário</BreadcrumbPage>
+ */
+declare const BreadcrumbPage: React.ForwardRefExoticComponent<Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLSpanElement>, HTMLSpanElement>, "ref"> & React.RefAttributes<HTMLSpanElement>>;
+/**
+ * Separador entre items (default: ChevronRight). Aceita ícone customizado como children.
+ * @example
+ * <BreadcrumbSeparator><Slash /></BreadcrumbSeparator>
+ */
+declare const BreadcrumbSeparator: {
+    ({ children, className, ...props }: React.ComponentProps<"li">): React.JSX.Element;
+    displayName: string;
+};
+/**
+ * Indicador "..." para colapsar níveis intermediários em trilhas longas.
+ * @example
+ * <BreadcrumbItem><BreadcrumbEllipsis /></BreadcrumbItem>
+ */
+declare const BreadcrumbEllipsis: {
+    ({ className, ...props }: React.ComponentProps<"span">): React.JSX.Element;
+    displayName: string;
+};
+export { Breadcrumb, BreadcrumbList, BreadcrumbItem, BreadcrumbLink, BreadcrumbPage, BreadcrumbSeparator, BreadcrumbEllipsis, };

package/dist/legacy/components/ui/button.d.ts

@@ -0,0 +1,66 @@
+import * as React from "react";
+import { type VariantProps } from "class-variance-authority";
+/**
+ * Variantes de estilo do componente {@link Button}.
+ *
+ * Variantes ativas:
+ * - `primary` (default): Ação principal (bg azul). Use para CTA único na tela.
+ * - `secondary`: Ação secundária com borda.
+ * - `tertiary`: Borda suave + bg neutro.
+ * - `outline` / `ghost` / `subtle`: Variações de baixa ênfase.
+ * - `destructive` / `danger`: Ações irreversíveis (excluir). Aliases entre si — prefira `danger` (padrão da lib).
+ * - `link`: Aparência de hyperlink, sem fundo.
+ * - `icon`: Botão quadrado para apenas ícone (use `size="icon"`).
+ *
+ * Variantes legadas (mantidas por compatibilidade — evite em código novo):
+ * `default`, `action`, `icon-only`, `external-link`, `action-primary`, `action-secondary`.
+ *
+ * @see {@link Button}
+ *
+ * @example
+ * buttonVariants;
+ */
+declare const buttonVariants: (props?: {
+    variant?: "link" | "icon" | "default" | "primary" | "secondary" | "tertiary" | "outline" | "ghost" | "subtle" | "danger" | "destructive" | "loading" | "action" | "icon-only" | "external-link" | "action-primary" | "action-secondary";
+    size?: "icon" | "sm" | "md" | "lg" | "xl" | "default" | "icon-sm" | "icon-xs";
+} & import("class-variance-authority/types").ClassProp) => string;
+/**
+ * Tipo `ButtonProps` exportado pela lib.
+ * @example
+ * const value: ButtonProps = {} as ButtonProps;
+ */
+export interface ButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement>, VariantProps<typeof buttonVariants> {
+    /**
+     * Quando `true`, renderiza o filho ao invés de um `<button>`, repassando todos os estilos.
+     * Útil para combinar com `<Link>` do React Router ou outros wrappers.
+     *
+     * @example
+     * ```tsx
+     * <Button asChild><Link to="/home">Início</Link></Button>
+     * ```
+     */
+    asChild?: boolean;
+}
+/**
+ * Botão padrão da Forlogic Core. Suporta variantes semânticas, tamanhos, ícones (SVG inline)
+ * e composição via `asChild`.
+ *
+ * @example Ação primária
+ * ```tsx
+ * <Button variant="primary" size="md">Salvar</Button>
+ * ```
+ *
+ * @example Ação destrutiva com ícone
+ * ```tsx
+ * <Button variant="danger"><Trash2 /> Excluir</Button>
+ * ```
+ *
+ * @example Botão de ícone apenas
+ * ```tsx
+ * <Button variant="icon" size="icon" aria-label="Editar"><Pencil /></Button>
+ * ```
+ *
+ * @see Documentação completa: `docs/design-system/buttons-actions.md`
+ */
+declare const Button: React.ForwardRefExoticComponent<ButtonProps & React.RefAttributes<HTMLButtonElement>>;
+export { Button, buttonVariants };

package/dist/legacy/components/ui/calendar.d.ts

@@ -0,0 +1,27 @@
+import * as React from "react";
+import { DayPicker } from "react-day-picker";
+/**
+ * Props do `Calendar`. Estende todas as props de `react-day-picker`.
+ * @example
+ * const props: CalendarProps = { mode: 'single', selected: date, onSelect: setDate };
+ */
+export type CalendarProps = React.ComponentProps<typeof DayPicker>;
+/**
+ * Calendário pt-BR (via date-fns/locale). Wrapper estilizado de `react-day-picker`.
+ *
+ * @example
+ * ```tsx
+ * <Calendar mode="single" selected={date} onSelect={setDate} />
+ * <Calendar mode="range" selected={range} onSelect={setRange} />
+ * ```
+ *
+ * @see `docs/design-system/inputs.md`
+ */
+declare function Calendar({ className, classNames, showOutsideDays, captionLayout, fromYear, toYear, startMonth, endMonth, ...props }: CalendarProps & {
+    fromYear?: number;
+    toYear?: number;
+}): React.JSX.Element;
+declare namespace Calendar {
+    var displayName: string;
+}
+export { Calendar };