forlogic-core 3.0.10 → 4.0.0

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

@@ -0,0 +1,108 @@
+import * as SheetPrimitive from "@radix-ui/react-dialog";
+import { type VariantProps } from "class-variance-authority";
+import * as React from "react";
+/**
+ * Componente `Sheet` da lib.
+ * @example
+ * <Sheet />
+ */
+declare const Sheet: React.FC<SheetPrimitive.DialogProps>;
+/**
+ * Componente `SheetTrigger` da lib.
+ * @example
+ * <SheetTrigger />
+ */
+declare const SheetTrigger: React.ForwardRefExoticComponent<SheetPrimitive.DialogTriggerProps & React.RefAttributes<HTMLButtonElement>>;
+/**
+ * Componente `SheetClose` da lib.
+ * @example
+ * <SheetClose />
+ */
+declare const SheetClose: React.ForwardRefExoticComponent<SheetPrimitive.DialogCloseProps & React.RefAttributes<HTMLButtonElement>>;
+/**
+ * Componente `SheetPortal` da lib.
+ * @example
+ * <SheetPortal />
+ */
+declare const SheetPortal: React.FC<SheetPrimitive.DialogPortalProps>;
+/**
+ * Componente `SheetOverlay` da lib.
+ * @example
+ * <SheetOverlay />
+ */
+declare const SheetOverlay: React.ForwardRefExoticComponent<Omit<SheetPrimitive.DialogOverlayProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+declare const sheetVariants: (props?: {
+    side?: "bottom" | "left" | "right" | "top";
+} & import("class-variance-authority/types").ClassProp) => string;
+interface SheetContentProps extends React.ComponentPropsWithoutRef<typeof SheetPrimitive.Content>, VariantProps<typeof sheetVariants> {
+}
+/**
+ * Container principal do Sheet. Define o lado de origem da animação via prop `side`
+ * (`right` default, `left`, `top`, `bottom`). Já inclui Portal + Overlay + botão `X`.
+ *
+ * @example
+ * <SheetContent side="right" className="sm:max-w-md">
+ *   <SheetHeader><SheetTitle>Detalhes</SheetTitle></SheetHeader>
+ *   <SheetBody>...</SheetBody>
+ * </SheetContent>
+ */
+declare const SheetContent: React.ForwardRefExoticComponent<SheetContentProps & React.RefAttributes<HTMLDivElement>>;
+interface SheetHeaderProps extends React.HTMLAttributes<HTMLDivElement> {
+    showSeparator?: boolean;
+}
+/**
+ * Header fixo do Sheet (não rola). Contém `SheetTitle` e opcionalmente `SheetDescription`.
+ * Use `showSeparator` para adicionar um divisor visual antes do `SheetBody`.
+ *
+ * @example
+ * <SheetHeader showSeparator>
+ *   <SheetTitle>Filtros</SheetTitle>
+ *   <SheetDescription>Refine sua busca.</SheetDescription>
+ * </SheetHeader>
+ */
+declare const SheetHeader: {
+    ({ className, showSeparator, children, ...props }: SheetHeaderProps): React.JSX.Element;
+    displayName: string;
+};
+/**
+ * Container scrollável do Sheet (área entre header e footer).
+ * **Obrigatório quando há `SheetFooter`** — sem ele o footer pode sair do viewport.
+ *
+ * @example
+ * <SheetBody>
+ *   {items.map(it => <Card key={it.id}>{it.name}</Card>)}
+ * </SheetBody>
+ */
+declare const SheetBody: {
+    ({ className, ...props }: React.HTMLAttributes<HTMLDivElement>): React.JSX.Element;
+    displayName: string;
+};
+/**
+ * Footer fixo do Sheet com separador automático e alinhamento à direita.
+ *
+ * @example
+ * <SheetFooter>
+ *   <Button variant="outline" onClick={() => setOpen(false)}>Cancelar</Button>
+ *   <Button onClick={save}>Salvar</Button>
+ * </SheetFooter>
+ */
+declare const SheetFooter: {
+    ({ className, children, ...props }: React.HTMLAttributes<HTMLDivElement>): React.JSX.Element;
+    displayName: string;
+};
+/**
+ * Título do Sheet. **Obrigatório por acessibilidade** (`aria-labelledby`).
+ * Use `className="sr-only"` se precisar ocultar visualmente.
+ *
+ * @example
+ * <SheetTitle>Editar perfil</SheetTitle>
+ */
+declare const SheetTitle: React.ForwardRefExoticComponent<Omit<SheetPrimitive.DialogTitleProps & React.RefAttributes<HTMLHeadingElement>, "ref"> & React.RefAttributes<HTMLHeadingElement>>;
+/**
+ * Descrição opcional do Sheet (subtítulo). Mapeada para `aria-describedby`.
+ *
+ * @example
+ * <SheetDescription>Altere as configurações da sua conta.</SheetDescription>
+ */
+declare const SheetDescription: React.ForwardRefExoticComponent<Omit<SheetPrimitive.DialogDescriptionProps & React.RefAttributes<HTMLParagraphElement>, "ref"> & React.RefAttributes<HTMLParagraphElement>>;
+export { Sheet, SheetBody, SheetClose, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetOverlay, SheetPortal, SheetTitle, SheetTrigger };

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

@@ -0,0 +1,269 @@
+import * as React from "react";
+import { VariantProps } from "class-variance-authority";
+import { TooltipContent } from "./tooltip";
+type SidebarContext = {
+    state: "expanded" | "collapsed";
+    open: boolean;
+    setOpen: (open: boolean) => void;
+    openMobile: boolean;
+    setOpenMobile: (open: boolean) => void;
+    isMobile: boolean;
+    toggleSidebar: () => void;
+};
+declare const SidebarContext: React.Context<SidebarContext>;
+/**
+ * Hook que expõe o estado da sidebar atual: `state` (`expanded`/`collapsed`),
+ * `open`, `setOpen`, `isMobile`, `openMobile`, `setOpenMobile`, `toggleSidebar`.
+ * Deve ser usado **dentro** de um `SidebarProvider` (lança erro caso contrário).
+ *
+ * @example
+ * function CollapseButton() {
+ *   const { toggleSidebar, state } = useSidebar();
+ *   return <Button onClick={toggleSidebar}>{state === 'expanded' ? 'Recolher' : 'Expandir'}</Button>;
+ * }
+ */
+declare function useSidebar(): SidebarContext;
+/**
+ * Provider obrigatório no topo da árvore que usa qualquer componente de Sidebar.
+ * Persiste o estado em `localStorage` (`sidebar:state`) e adiciona o atalho
+ * `Cmd/Ctrl+B` para alternar a sidebar.
+ *
+ * @example
+ * <SidebarProvider defaultOpen>
+ *   <Sidebar>...</Sidebar>
+ *   <SidebarInset>{children}</SidebarInset>
+ * </SidebarProvider>
+ */
+declare const SidebarProvider: React.ForwardRefExoticComponent<Omit<React.ClassAttributes<HTMLDivElement> & React.HTMLAttributes<HTMLDivElement> & {
+    defaultOpen?: boolean;
+    open?: boolean;
+    onOpenChange?: (open: boolean) => void;
+}, "ref"> & React.RefAttributes<HTMLDivElement>>;
+/**
+ * Sidebar lateral colapsável. Configurável por `side` (`left`/`right`),
+ * `variant` (`sidebar`/`floating`/`inset`) e `collapsible` (`offcanvas`/`icon`/`none`).
+ * Em mobile, vira automaticamente um `Sheet` deslizante.
+ *
+ * @example
+ * <Sidebar side="left" variant="inset" collapsible="icon">
+ *   <SidebarHeader>{logo}</SidebarHeader>
+ *   <SidebarContent>
+ *     <SidebarMenu>{items.map(it => <SidebarMenuItem key={it.id}>...</SidebarMenuItem>)}</SidebarMenu>
+ *   </SidebarContent>
+ *   <SidebarFooter>{userMenu}</SidebarFooter>
+ * </Sidebar>
+ */
+declare const Sidebar: React.ForwardRefExoticComponent<Omit<React.ClassAttributes<HTMLDivElement> & React.HTMLAttributes<HTMLDivElement> & {
+    side?: "left" | "right";
+    variant?: "sidebar" | "floating" | "inset";
+    collapsible?: "offcanvas" | "icon" | "none";
+}, "ref"> & React.RefAttributes<HTMLDivElement>>;
+/**
+ * Botão `PanelLeft` que alterna a sidebar (chama `toggleSidebar`).
+ * Tipicamente colocado no header da aplicação.
+ *
+ * @example
+ * <SidebarTrigger className="md:hidden" />
+ */
+declare const SidebarTrigger: React.ForwardRefExoticComponent<Omit<import("./button").ButtonProps & React.RefAttributes<HTMLButtonElement>, "ref"> & React.RefAttributes<HTMLButtonElement>>;
+/**
+ * Linha vertical fina na borda externa da sidebar que serve como handle
+ * de toggle (clicar nela colapsa/expande). Adicionada automaticamente em
+ * variantes colapsáveis em desktop.
+ *
+ * @example
+ * <Sidebar>...<SidebarRail /></Sidebar>
+ */
+declare const SidebarRail: React.ForwardRefExoticComponent<Omit<React.DetailedHTMLProps<React.ButtonHTMLAttributes<HTMLButtonElement>, HTMLButtonElement>, "ref"> & React.RefAttributes<HTMLButtonElement>>;
+/**
+ * `<main>` que recebe o conteúdo da página ao lado da `Sidebar`. Aplica margens
+ * e bordas apropriadas para a variante `inset`.
+ *
+ * @example
+ * <SidebarProvider>
+ *   <Sidebar>...</Sidebar>
+ *   <SidebarInset><Outlet /></SidebarInset>
+ * </SidebarProvider>
+ */
+declare const SidebarInset: React.ForwardRefExoticComponent<Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLElement>, HTMLElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+/**
+ * Input estilizado para uso dentro da sidebar (ex.: campo de busca de itens).
+ *
+ * @example
+ * <SidebarHeader><SidebarInput placeholder="Buscar..." /></SidebarHeader>
+ */
+declare const SidebarInput: React.ForwardRefExoticComponent<Omit<Omit<import("./input").InputProps, "ref"> & React.RefAttributes<HTMLInputElement>, "ref"> & React.RefAttributes<HTMLInputElement>>;
+/**
+ * Topo da sidebar (logo, busca, perfil). Não rola.
+ *
+ * @example
+ * <SidebarHeader><Logo /></SidebarHeader>
+ */
+declare const SidebarHeader: React.ForwardRefExoticComponent<Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+/**
+ * Rodapé fixo da sidebar (menu do usuário, versão do app, etc).
+ *
+ * @example
+ * <SidebarFooter><UserMenu /></SidebarFooter>
+ */
+declare const SidebarFooter: React.ForwardRefExoticComponent<Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+/**
+ * Linha divisória horizontal dentro da sidebar.
+ *
+ * @example
+ * <SidebarSeparator />
+ */
+declare const SidebarSeparator: React.ForwardRefExoticComponent<Omit<Omit<import("@radix-ui/react-separator").SeparatorProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+/**
+ * Área principal scrollável da sidebar (entre Header e Footer).
+ * No modo `collapsible="icon"` esconde o overflow para preservar layout.
+ *
+ * @example
+ * <SidebarContent>
+ *   <SidebarGroup>...</SidebarGroup>
+ * </SidebarContent>
+ */
+declare const SidebarContent: React.ForwardRefExoticComponent<Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+/**
+ * Agrupamento lógico de itens (ex.: "Operacional", "Configurações").
+ * Combine com `SidebarGroupLabel` + `SidebarGroupContent`.
+ *
+ * @example
+ * <SidebarGroup>
+ *   <SidebarGroupLabel>Operacional</SidebarGroupLabel>
+ *   <SidebarGroupContent><SidebarMenu>...</SidebarMenu></SidebarGroupContent>
+ * </SidebarGroup>
+ */
+declare const SidebarGroup: React.ForwardRefExoticComponent<Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+/**
+ * Título de um `SidebarGroup` (some no modo `collapsible="icon"`).
+ * Use `asChild` para renderizar como link/botão.
+ *
+ * @example
+ * <SidebarGroupLabel>Configurações</SidebarGroupLabel>
+ */
+declare const SidebarGroupLabel: React.ForwardRefExoticComponent<Omit<React.ClassAttributes<HTMLDivElement> & React.HTMLAttributes<HTMLDivElement> & {
+    asChild?: boolean;
+}, "ref"> & React.RefAttributes<HTMLDivElement>>;
+/**
+ * Botão de ação no canto superior direito de um `SidebarGroup` (ex.: "+ Adicionar").
+ *
+ * @example
+ * <SidebarGroup>
+ *   <SidebarGroupLabel>Projetos</SidebarGroupLabel>
+ *   <SidebarGroupAction onClick={createProject}><Plus /></SidebarGroupAction>
+ * </SidebarGroup>
+ */
+declare const SidebarGroupAction: React.ForwardRefExoticComponent<Omit<React.ClassAttributes<HTMLButtonElement> & React.ButtonHTMLAttributes<HTMLButtonElement> & {
+    asChild?: boolean;
+}, "ref"> & React.RefAttributes<HTMLButtonElement>>;
+/**
+ * Container do conteúdo de um `SidebarGroup` (tipicamente envolve um `SidebarMenu`).
+ *
+ * @example
+ * <SidebarGroupContent><SidebarMenu>...</SidebarMenu></SidebarGroupContent>
+ */
+declare const SidebarGroupContent: React.ForwardRefExoticComponent<Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+/**
+ * `<ul>` raiz da lista de itens do menu. Filhos devem ser `SidebarMenuItem`.
+ *
+ * @example
+ * <SidebarMenu>
+ *   <SidebarMenuItem><SidebarMenuButton>Início</SidebarMenuButton></SidebarMenuItem>
+ * </SidebarMenu>
+ */
+declare const SidebarMenu: React.ForwardRefExoticComponent<Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLUListElement>, HTMLUListElement>, "ref"> & React.RefAttributes<HTMLUListElement>>;
+/**
+ * `<li>` que envolve um `SidebarMenuButton` e suas ações/badges/submenus.
+ *
+ * @example
+ * <SidebarMenuItem>
+ *   <SidebarMenuButton isActive>Início</SidebarMenuButton>
+ *   <SidebarMenuBadge>3</SidebarMenuBadge>
+ * </SidebarMenuItem>
+ */
+declare const SidebarMenuItem: React.ForwardRefExoticComponent<Omit<React.DetailedHTMLProps<React.LiHTMLAttributes<HTMLLIElement>, HTMLLIElement>, "ref"> & React.RefAttributes<HTMLLIElement>>;
+/**
+ * Botão clicável principal de cada item de menu. Use `isActive` para destacar a rota
+ * atual e `tooltip` para mostrar o nome quando a sidebar está colapsada (`icon`).
+ * Use `asChild` para integrar com `<Link>` do react-router.
+ *
+ * @example
+ * <SidebarMenuButton asChild isActive={pathname === '/home'} tooltip="Início">
+ *   <Link to="/home"><Home className="h-4 w-4" /><span>Início</span></Link>
+ * </SidebarMenuButton>
+ */
+declare const SidebarMenuButton: React.ForwardRefExoticComponent<Omit<React.ClassAttributes<HTMLButtonElement> & React.ButtonHTMLAttributes<HTMLButtonElement> & {
+    asChild?: boolean;
+    isActive?: boolean;
+    tooltip?: string | React.ComponentProps<typeof TooltipContent>;
+} & VariantProps<(props?: {
+    variant?: "default" | "outline";
+    size?: "sm" | "lg" | "default";
+} & import("class-variance-authority/types").ClassProp) => string>, "ref"> & React.RefAttributes<HTMLButtonElement>>;
+/**
+ * Botão de ação secundária no canto direito de um `SidebarMenuItem` (ex.: "...", "+").
+ * Use `showOnHover` para revelar somente no hover do item.
+ *
+ * @example
+ * <SidebarMenuItem>
+ *   <SidebarMenuButton>Projeto X</SidebarMenuButton>
+ *   <SidebarMenuAction showOnHover><MoreHorizontal /></SidebarMenuAction>
+ * </SidebarMenuItem>
+ */
+declare const SidebarMenuAction: React.ForwardRefExoticComponent<Omit<React.ClassAttributes<HTMLButtonElement> & React.ButtonHTMLAttributes<HTMLButtonElement> & {
+    asChild?: boolean;
+    showOnHover?: boolean;
+}, "ref"> & React.RefAttributes<HTMLButtonElement>>;
+/**
+ * Badge numérico/textual no canto direito de um `SidebarMenuItem`
+ * (ex.: contadores de notificações).
+ *
+ * @example
+ * <SidebarMenuBadge>12</SidebarMenuBadge>
+ */
+declare const SidebarMenuBadge: React.ForwardRefExoticComponent<Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+/**
+ * Skeleton placeholder de um item da sidebar enquanto os dados carregam.
+ * `showIcon` adiciona o quadrado do ícone à esquerda.
+ *
+ * @example
+ * {isLoading && Array.from({ length: 5 }).map((_, i) => <SidebarMenuSkeleton key={i} showIcon />)}
+ */
+declare const SidebarMenuSkeleton: React.ForwardRefExoticComponent<Omit<React.ClassAttributes<HTMLDivElement> & React.HTMLAttributes<HTMLDivElement> & {
+    showIcon?: boolean;
+}, "ref"> & React.RefAttributes<HTMLDivElement>>;
+/**
+ * Submenu (`<ul>`) aninhado dentro de um `SidebarMenuItem`. Esconde-se no
+ * modo `collapsible="icon"`. Filhos devem ser `SidebarMenuSubItem`.
+ *
+ * @example
+ * <SidebarMenuItem>
+ *   <SidebarMenuButton>Configurações</SidebarMenuButton>
+ *   <SidebarMenuSub>
+ *     <SidebarMenuSubItem><SidebarMenuSubButton>Geral</SidebarMenuSubButton></SidebarMenuSubItem>
+ *   </SidebarMenuSub>
+ * </SidebarMenuItem>
+ */
+declare const SidebarMenuSub: React.ForwardRefExoticComponent<Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLUListElement>, HTMLUListElement>, "ref"> & React.RefAttributes<HTMLUListElement>>;
+/**
+ * `<li>` de um item dentro de `SidebarMenuSub`.
+ *
+ * @example
+ * <SidebarMenuSubItem><SidebarMenuSubButton href="/x">Opção</SidebarMenuSubButton></SidebarMenuSubItem>
+ */
+declare const SidebarMenuSubItem: React.ForwardRefExoticComponent<Omit<React.DetailedHTMLProps<React.LiHTMLAttributes<HTMLLIElement>, HTMLLIElement>, "ref"> & React.RefAttributes<HTMLLIElement>>;
+/**
+ * Link (`<a>`) clicável de um item de submenu. Use `asChild` para integrar com `<Link>`.
+ *
+ * @example
+ * <SidebarMenuSubButton asChild isActive={pathname === '/x'}>
+ *   <Link to="/x">Detalhes</Link>
+ * </SidebarMenuSubButton>
+ */
+declare const SidebarMenuSubButton: React.ForwardRefExoticComponent<Omit<React.ClassAttributes<HTMLAnchorElement> & React.AnchorHTMLAttributes<HTMLAnchorElement> & {
+    asChild?: boolean;
+    size?: "sm" | "md";
+    isActive?: boolean;
+}, "ref"> & React.RefAttributes<HTMLAnchorElement>>;
+export { Sidebar, SidebarContent, SidebarFooter, SidebarGroup, SidebarGroupAction, SidebarGroupContent, SidebarGroupLabel, SidebarHeader, SidebarInput, SidebarInset, SidebarMenu, SidebarMenuAction, SidebarMenuBadge, SidebarMenuButton, SidebarMenuItem, SidebarMenuSkeleton, SidebarMenuSub, SidebarMenuSubButton, SidebarMenuSubItem, SidebarProvider, SidebarRail, SidebarSeparator, SidebarTrigger, useSidebar };

package/dist/legacy/components/ui/skeleton-variants.d.ts

@@ -0,0 +1,41 @@
+interface TableSkeletonProps {
+    rows?: number;
+    columns?: number;
+}
+interface CardSkeletonProps {
+    count?: number;
+}
+interface FormSkeletonProps {
+    fields?: number;
+}
+/**
+ * Função utilitária `TableSkeleton`.
+ * @example
+ * TableSkeleton();
+ */
+export declare function TableSkeleton({ rows, columns }: TableSkeletonProps): import("react").JSX.Element;
+/**
+ * Função utilitária `CardSkeleton`.
+ * @example
+ * CardSkeleton();
+ */
+export declare function CardSkeleton({ count }: CardSkeletonProps): import("react").JSX.Element;
+/**
+ * Função utilitária `FormSkeleton`.
+ * @example
+ * FormSkeleton();
+ */
+export declare function FormSkeleton({ fields }: FormSkeletonProps): import("react").JSX.Element;
+/**
+ * Função utilitária `HeaderSkeleton`.
+ * @example
+ * HeaderSkeleton();
+ */
+export declare function HeaderSkeleton(): import("react").JSX.Element;
+/**
+ * Função utilitária `SidebarSkeleton`.
+ * @example
+ * SidebarSkeleton();
+ */
+export declare function SidebarSkeleton(): import("react").JSX.Element;
+export {};

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

@@ -0,0 +1,14 @@
+/**
+ * Bloco de carregamento animado (pulse). Use para placeholders de conteúdo durante fetch.
+ *
+ * Para padrões compostos prontos (tabela, card, formulário, header, sidebar), prefira
+ * `TableSkeleton`, `CardSkeleton`, `FormSkeleton`, `HeaderSkeleton`, `SidebarSkeleton`
+ * de `./skeleton-variants`.
+ *
+ * @example
+ * ```tsx
+ * {isLoading ? <Skeleton className="h-4 w-32" /> : <span>{name}</span>}
+ * ```
+ */
+declare function Skeleton({ className, ...props }: React.HTMLAttributes<HTMLDivElement>): import("react").JSX.Element;
+export { Skeleton };

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

@@ -0,0 +1,8 @@
+import { ToasterProps, toast } from "sonner";
+/**
+ * Componente `Toaster` da lib.
+ * @example
+ * <Toaster />
+ */
+declare const Toaster: ({ ...props }: ToasterProps) => import("react").JSX.Element;
+export { Toaster, toast };

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

@@ -0,0 +1,11 @@
+interface SpinnerProps {
+    size?: "sm" | "md" | "lg";
+    className?: string;
+}
+/**
+ * Função utilitária `Spinner`.
+ * @example
+ * Spinner();
+ */
+export declare function Spinner({ size, className }: SpinnerProps): import("react").JSX.Element;
+export {};

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

@@ -0,0 +1,77 @@
+import * as React from 'react';
+import { buttonVariants } from './button';
+import type { VariantProps } from 'class-variance-authority';
+import type { LucideIcon } from 'lucide-react';
+/**
+ * Representa uma ação secundária no menu do Split Button
+ *
+ * @example
+ * const value: SplitButtonAction = {} as SplitButtonAction;
+ */
+export interface SplitButtonAction {
+    /** Identificador único da ação */
+    id: string;
+    /** Texto exibido no menu */
+    label: string;
+    /** Ícone opcional (componente Lucide) */
+    icon?: LucideIcon;
+    /** Callback executado ao clicar */
+    onClick: () => void;
+    /** Se true, a ação fica desabilitada */
+    disabled?: boolean;
+    /** Variante visual da ação */
+    variant?: 'default' | 'destructive';
+}
+/**
+ * Props do componente SplitButton
+ *
+ * @example
+ * const value: SplitButtonProps = {} as SplitButtonProps;
+ */
+export interface SplitButtonProps extends Omit<VariantProps<typeof buttonVariants>, 'variant' | 'size'> {
+    /** Texto do botão principal */
+    label: string;
+    /** Callback executado ao clicar no botão principal */
+    onClick: () => void;
+    /** Ícone opcional do botão principal (componente Lucide) */
+    icon?: LucideIcon;
+    /** Lista de ações secundárias exibidas no menu dropdown */
+    actions?: SplitButtonAction[];
+    /** Variante visual do botão */
+    variant?: 'default' | 'secondary' | 'outline' | 'ghost';
+    /** Tamanho do botão */
+    size?: 'sm' | 'default' | 'lg';
+    /** Se true, desabilita todo o componente */
+    disabled?: boolean;
+    /** Se true, exibe estado de loading no botão principal */
+    loading?: boolean;
+    /** Alinhamento do menu dropdown */
+    menuAlign?: 'start' | 'end';
+    /** Classes CSS adicionais */
+    className?: string;
+}
+/**
+ * SplitButton - Componente que combina uma ação principal com ações secundárias em um menu dropdown.
+ *
+ * @description
+ * O Split Button é ideal para fluxos onde existe uma ação principal clara acompanhada de
+ * ações secundárias relacionadas. Ele destaca visualmente a ação prioritária enquanto
+ * mantém as alternativas acessíveis.
+ *
+ * @example
+ * ```tsx
+ * <SplitButton
+ *   label="Salvar"
+ *   onClick={() => handleSave()}
+ *   icon={Save}
+ *   actions={[
+ *     { id: 'save-draft', label: t('save_as_draft'), onClick: handleSaveDraft },
+ *     { id: 'save-template', label: t('save_as_template'), onClick: handleSaveTemplate },
+ *   ]}
+ * />
+ * ```
+ *
+ * @see {@link https://ui.shadcn.com/docs/components/button Button}
+ * @see {@link https://ui.shadcn.com/docs/components/dropdown-menu DropdownMenu}
+ */
+export declare function SplitButton({ label, onClick, icon: Icon, actions, variant, size, disabled, loading, menuAlign, className, }: SplitButtonProps): React.JSX.Element;

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

@@ -0,0 +1,17 @@
+import { ReactNode } from "react";
+interface StackProps {
+    children: ReactNode;
+    direction?: "row" | "column";
+    gap?: "xs" | "sm" | "md" | "lg" | "xl";
+    align?: "start" | "center" | "end" | "stretch";
+    justify?: "start" | "center" | "end" | "between" | "around" | "evenly";
+    wrap?: boolean;
+    className?: string;
+}
+/**
+ * Função utilitária `Stack`.
+ * @example
+ * Stack();
+ */
+export declare function Stack({ children, direction, gap, align, justify, wrap, className }: StackProps): import("react").JSX.Element;
+export {};

package/dist/legacy/components/ui/stat-card.d.ts

@@ -0,0 +1,95 @@
+/**
+ * @module StatCard
+ * Cartões de métrica (KPI) oficiais do Design System.
+ *
+ * Duas anatomias homologadas:
+ * - `StatCardStrict` (V2 · geometria estrita): marca flutuante e gráfico de linha.
+ * - `StatCardCorporate` (V6 · geometria corporativa): marca em blocos + área preenchida.
+ * - `StatCard`: alias da anatomia padrão (V6).
+ */
+import * as React from 'react';
+import { type LucideIcon } from 'lucide-react';
+/** Tons semânticos suportados pelos stat cards. */
+export type StatCardTone = 'brand' | 'warning' | 'danger' | 'success';
+/** Ponto da série (sparkline) do stat card. */
+export interface StatCardSeriesPoint {
+    label?: string;
+    value: number;
+}
+/** Série aceita pelos stat cards (números ou pontos rotulados). */
+export type StatCardSeries = Array<number | StatCardSeriesPoint>;
+interface BaseStatCardProps extends Omit<React.HTMLAttributes<HTMLElement>, 'title'> {
+    /** Título da métrica. */
+    title: string;
+    /** Valor principal exibido. */
+    value: React.ReactNode;
+    /** Ícone Lucide da métrica. */
+    icon?: LucideIcon;
+    /** Tom semântico. Default: `brand`. */
+    tone?: StatCardTone;
+    /** Variação percentual (positiva, negativa ou zero). */
+    delta?: number;
+    /** Série histórica para o mini-gráfico. */
+    series?: StatCardSeries;
+    /** Torna o card interativo (foco + cursor). */
+    onClick?: React.MouseEventHandler<HTMLElement>;
+}
+declare function ChartTooltip({ active, payload, unit, points, index: indexProp, }: {
+    active?: boolean;
+    payload?: Array<{
+        value: number;
+        payload?: StatCardSeriesPoint;
+    }>;
+    unit?: string;
+    /** Série completa, para cruzar o ponto com o período anterior (referência de base). */
+    points?: StatCardSeriesPoint[];
+    /** Índice controlado (navegação por teclado). */
+    index?: number;
+}): React.JSX.Element;
+/** Props da anatomia V2 (geometria estrita). */
+export interface StatCardStrictProps extends BaseStatCardProps {
+    /** Categoria exibida sob o título. */
+    category?: string;
+    /** Unidade do valor (ex.: `%`, `dias`). */
+    unit?: string;
+    /** `solid` pinta o card inteiro com o tom. Default: `plain`. */
+    fill?: 'solid' | 'plain';
+}
+/**
+ * Stat card V2 — geometria estrita: losango da marca flutuando e gráfico de linha na base.
+ *
+ * @example
+ * ```tsx
+ * <StatCardStrict title="NPS" category="Trimestre" value={72} unit="pts" delta={4.2} series={[60,65,70,72]} />
+ * ```
+ */
+export declare const StatCardStrict: React.ForwardRefExoticComponent<StatCardStrictProps & React.RefAttributes<HTMLElement>>;
+/** Props da anatomia V6 (geometria corporativa). */
+export interface StatCardCorporateProps extends BaseStatCardProps {
+    /** Periodicidade da métrica (ex.: `Mensal`). */
+    frequency?: string;
+    /** Texto de comparação (ex.: `vs. mês anterior`). */
+    comparison?: string;
+    /** Direção considerada positiva para o `delta`. Default: `up`. */
+    goodDirection?: 'up' | 'down';
+}
+/**
+ * Stat card V6 — geometria corporativa: marca em blocos com revelação animada e área preenchida.
+ * Anatomia padrão do Design System (exportada também como `StatCard`).
+ *
+ * @example
+ * ```tsx
+ * <StatCard title="Ocorrências abertas" frequency="Mensal" value={128} delta={-8.4} goodDirection="down" series={[180,164,150,128]} />
+ * ```
+ */
+export declare const StatCardCorporate: React.ForwardRefExoticComponent<StatCardCorporateProps & React.RefAttributes<HTMLElement>>;
+/** Anatomia padrão do Design System (V6). */
+export declare const StatCard: React.ForwardRefExoticComponent<StatCardCorporateProps & React.RefAttributes<HTMLElement>>;
+export type StatCardProps = StatCardCorporateProps;
+/** Internos expostos apenas para testes automatizados. Não usar em aplicações. */
+export declare const __statCardInternals: {
+    ChartTooltip: typeof ChartTooltip;
+    formatMonthLabel: (label?: string) => string | undefined;
+    normalizeSeries: (series?: StatCardSeries) => StatCardSeriesPoint[];
+};
+export {};