forlogic-core 2.1.4 → 2.2.0

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

@@ -11,35 +11,188 @@ type SidebarContext = {
     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;
@@ -48,16 +201,66 @@ declare const SidebarMenuButton: React.ForwardRefExoticComponent<Omit<React.Clas
     variant?: "outline" | "default";
     size?: "default" | "sm" | "lg";
 } & 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";

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

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

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

@@ -1,2 +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-runtime").JSX.Element;
 export { Skeleton };

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

@@ -1,4 +1,9 @@
 import * as React from "react";
 import * as SliderPrimitive from "@radix-ui/react-slider";
+/**
+ * Componente `Slider` da lib.
+ * @example
+ * <Slider />
+ */
 declare const Slider: React.ForwardRefExoticComponent<Omit<SliderPrimitive.SliderProps & React.RefAttributes<HTMLSpanElement>, "ref"> & React.RefAttributes<HTMLSpanElement>>;
 export { Slider };

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

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

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

@@ -2,5 +2,10 @@ 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-runtime").JSX.Element;
 export {};

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

@@ -3,6 +3,9 @@ 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 */
@@ -20,6 +23,9 @@ export interface SplitButtonAction {
 }
 /**
  * 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 */

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

@@ -8,5 +8,10 @@ interface StackProps {
     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-runtime").JSX.Element;
 export {};

package/dist/components/ui/status-badge.d.ts

@@ -0,0 +1,52 @@
+import { type LucideIcon } from 'lucide-react';
+export interface StatusBadgeProps {
+    /** Texto exibido no badge */
+    label: string;
+    /** Cor semântica (hex) — gera fundo pastel automaticamente */
+    color: string;
+    /** Ícone Lucide exibido à esquerda do texto */
+    icon?: LucideIcon;
+    /** Exibe o ícone (default: true quando icon fornecido) */
+    showIcon?: boolean;
+    /** Tamanho do badge */
+    size?: 'sm' | 'md' | 'lg';
+    /** Variante visual */
+    variant?: 'filled' | 'outline' | 'ghost';
+    /** Override do fundo pastel automático */
+    backgroundColor?: string;
+    /** Classes adicionais */
+    className?: string;
+}
+export interface StatusConfig {
+    label: string;
+    color: string;
+    icon?: LucideIcon;
+    tooltipText?: string;
+}
+/**
+ * Badge de status genérico e reutilizável.
+ * Aceita cor semântica e gera fundo pastel automaticamente.
+ * Pode ser usado em qualquer CRUD, tabela ou card.
+ *
+ * @example
+ * StatusBadge();
+ */
+export declare function StatusBadge({ label, color, icon: Icon, showIcon, size, variant, backgroundColor, className, }: StatusBadgeProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Cria um lookup type-safe de configuração de status.
+ * Útil para mapear enums de domínio para props do StatusBadge.
+ *
+ * @example
+ * ```ts
+ * const getOrderStatus = createStatusConfig({
+ *   pending: { label: 'Pendente', color: '#8B7355', icon: Clock },
+ *   approved: { label: 'Aprovado', color: '#3D7A40', icon: CheckCircle2 },
+ *   rejected: { label: 'Rejeitado', color: '#B44A4A', icon: X },
+ * });
+ *
+ * // Uso:
+ * const config = getOrderStatus('pending');
+ * <StatusBadge {...config} />
+ * ```
+ */
+export declare function createStatusConfig<T extends string | number>(statuses: Record<T, StatusConfig>): (status: T) => StatusConfig;

package/dist/components/ui/step-selector.d.ts

@@ -37,5 +37,10 @@ export interface StepSelectorProps {
     /** Largura da barra de progresso */
     progressWidth?: string;
 }
+/**
+ * Função utilitária `StepSelector`.
+ * @example
+ * StepSelector();
+ */
 declare function StepSelector({ currentStep, totalSteps, onStepChange, stepLabels, canGoToStep, className, progressWidth, }: StepSelectorProps): import("react/jsx-runtime").JSX.Element;
 export { StepSelector };

package/dist/components/ui/stimulsoft-viewer.d.ts

@@ -1,4 +1,9 @@
 import { type IframeDialogProps } from './iframe-dialog';
+/**
+ * Tipo `StimulsoftViewerProps` exportado pela lib.
+ * @example
+ * const value: StimulsoftViewerProps = {} as StimulsoftViewerProps;
+ */
 export interface StimulsoftViewerProps extends Omit<IframeDialogProps, 'url' | 'minHeight'> {
     /** Base URL of the report API (e.g. environment.reportApiUrl) */
     reportApiUrl: string;
@@ -15,6 +20,9 @@ export interface StimulsoftViewerProps extends Omit<IframeDialogProps, 'url' | '
  * Stimulsoft Viewer endpoint with the given parameters.
  *
  * Ported from legacy `qex-stimulsoft-viewer`.
+ *
+ * @example
+ * StimulsoftViewer();
  */
 export declare function StimulsoftViewer({ reportApiUrl, parameters, minHeight, ...dialogProps }: StimulsoftViewerProps): import("react/jsx-runtime").JSX.Element;
 export default StimulsoftViewer;

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

@@ -1,4 +1,25 @@
 import * as React from "react";
 import * as SwitchPrimitives from "@radix-ui/react-switch";
+/**
+ * Toggle binário on/off. Use controlado (`checked` + `onCheckedChange`) para integrar com
+ * formulários ou estado externo, ou não controlado (`defaultChecked`) para casos simples.
+ *
+ * @example Controlado
+ * ```tsx
+ * <Switch checked={isActive} onCheckedChange={setIsActive} />
+ * ```
+ *
+ * @example Em formulário
+ * ```tsx
+ * <FormField control={form.control} name="active" render={({ field }) => (
+ *   <FormItem>
+ *     <FormLabel>Ativo</FormLabel>
+ *     <FormControl>
+ *       <Switch checked={field.value} onCheckedChange={field.onChange} />
+ *     </FormControl>
+ *   </FormItem>
+ * )} />
+ * ```
+ */
 declare const Switch: React.ForwardRefExoticComponent<Omit<SwitchPrimitives.SwitchProps & React.RefAttributes<HTMLButtonElement>, "ref"> & React.RefAttributes<HTMLButtonElement>>;
 export { Switch };

package/dist/components/ui/tab-page-layout.d.ts

@@ -1,3 +1,21 @@
+/**
+ * @module TabPageLayout
+ * Layout padrão da Forlogic Core para o conteúdo interno de uma aba (`TabsContent`).
+ * **Não é shadcn** — composição custom da lib. Use a tríade
+ * `TabPageLayout` (raiz com scroll) → `TabPageHeader` (título + ações) → `TabPageContent`.
+ *
+ * @example
+ * ```tsx
+ * <TabsContent value="config">
+ *   <TabPageLayout>
+ *     <TabPageHeader title="Configurações" description="Ajustes gerais" actions={<Button>Salvar</Button>} />
+ *     <TabPageContent>{children}</TabPageContent>
+ *   </TabPageLayout>
+ * </TabsContent>
+ * ```
+ *
+ * @see `docs/design-system/layout.md`
+ */
 import { ReactNode } from "react";
 interface TabPageLayoutProps {
     children: ReactNode;
@@ -13,7 +31,22 @@ interface TabPageContentProps {
     children: ReactNode;
     className?: string;
 }
+/**
+ * Função utilitária `TabPageLayout`.
+ * @example
+ * TabPageLayout();
+ */
 export declare function TabPageLayout({ children, className }: TabPageLayoutProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Função utilitária `TabPageHeader`.
+ * @example
+ * TabPageHeader();
+ */
 export declare function TabPageHeader({ title, description, actions, className }: TabPageHeaderProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Função utilitária `TabPageContent`.
+ * @example
+ * TabPageContent();
+ */
 export declare function TabPageContent({ children, className }: TabPageContentProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/components/ui/table-resize-handle.d.ts

@@ -6,10 +6,17 @@ interface TableResizeHandleProps {
     className?: string;
 }
 /**
- * TableResizeHandle
- *
  * Handle visual para resize de colunas (horizontal) ou linhas (vertical) em tabelas.
- * Segue o padrão visual do ResizableHandle do Design System.
+ * Segue o padrão visual do `ResizableHandle` do Design System. Use junto de
+ * `useColumnResize` ou `useRowResize`.
+ *
+ * @example
+ * ```tsx
+ * <th className="relative">
+ *   Coluna
+ *   <TableResizeHandle direction="horizontal" onMouseDown={handleMouseDown} isDragging={isDragging} />
+ * </th>
+ * ```
  */
 export declare const TableResizeHandle: React.ForwardRefExoticComponent<TableResizeHandleProps & React.RefAttributes<HTMLDivElement>>;
 export { TableResizeHandle as default };

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

@@ -1,10 +1,112 @@
+/**
+ * @module Table
+ * Componente primitivo de tabela com customizações Forlogic sobre o shadcn base:
+ * - `table-fixed` obrigatório (preserva integridade do layout em drag-and-drop e resize).
+ * - `TableHeader` é **sticky** por padrão (`sticky top-0 z-[1]`) — funciona com scroll do contêiner.
+ * - Densidade visual aumentada: `text-[13px]`, `TableHead h-9`, `TableCell py-2`.
+ * - Linhas zebradas via `even:bg-table-stripe`.
+ *
+ * Para CRUDs com filtros, paginação e column manager, use `CrudTable` ou `DataTable`
+ * (aliases) ao invés deste primitivo.
+ *
+ * @see `docs/design-system/tables-grids.md`
+ */
 import * as React from "react";
+/**
+ * Raiz da tabela. Aplica `w-full table-fixed text-[13px]`.
+ *
+ * @example
+ * ```tsx
+ * <Table>
+ *   <TableHeader>...</TableHeader>
+ *   <TableBody>...</TableBody>
+ * </Table>
+ * ```
+ */
 declare const Table: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLTableElement> & React.RefAttributes<HTMLTableElement>>;
+/**
+ * Cabeçalho da tabela (`<thead>`). Sticky por padrão (`sticky top-0 z-[1]`),
+ * funciona quando o contêiner pai possui `overflow-y-auto`.
+ *
+ * @example
+ * ```tsx
+ * <TableHeader>
+ *   <TableRow>
+ *     <TableHead>Nome</TableHead>
+ *     <TableHead>Email</TableHead>
+ *   </TableRow>
+ * </TableHeader>
+ * ```
+ */
 declare const TableHeader: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLTableSectionElement> & React.RefAttributes<HTMLTableSectionElement>>;
+/**
+ * Corpo da tabela (`<tbody>`). Remove a borda inferior da última linha automaticamente.
+ *
+ * @example
+ * ```tsx
+ * <TableBody>
+ *   {rows.map(r => <TableRow key={r.id}>...</TableRow>)}
+ * </TableBody>
+ * ```
+ */
 declare const TableBody: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLTableSectionElement> & React.RefAttributes<HTMLTableSectionElement>>;
+/**
+ * Rodapé da tabela (`<tfoot>`). Útil para linhas de totalização.
+ *
+ * @example
+ * ```tsx
+ * <TableFooter>
+ *   <TableRow>
+ *     <TableCell colSpan={2}>Total</TableCell>
+ *     <TableCell>{total}</TableCell>
+ *   </TableRow>
+ * </TableFooter>
+ * ```
+ */
 declare const TableFooter: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLTableSectionElement> & React.RefAttributes<HTMLTableSectionElement>>;
+/**
+ * Linha (`<tr>`). Aplica zebra automática (`even:bg-table-stripe`) e estado
+ * `data-[state=selected]` para seleção via checkbox.
+ *
+ * @example
+ * ```tsx
+ * <TableRow data-state={selected ? 'selected' : undefined}>
+ *   <TableCell>...</TableCell>
+ * </TableRow>
+ * ```
+ */
 declare const TableRow: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLTableRowElement> & React.RefAttributes<HTMLTableRowElement>>;
+/**
+ * Célula de cabeçalho (`<th>`). Altura `h-9` e padding `py-2 px-4` por padrão
+ * (densidade visual da lib).
+ *
+ * @example
+ * ```tsx
+ * <TableHead className="w-[200px]">Nome</TableHead>
+ * ```
+ */
 declare const TableHead: React.ForwardRefExoticComponent<React.ThHTMLAttributes<HTMLTableCellElement> & React.RefAttributes<HTMLTableCellElement>>;
+/**
+ * Célula de dado (`<td>`). Padding `py-2 px-4` e `overflow-hidden`
+ * (combinar com `TruncatedCell` para texto longo).
+ *
+ * @example
+ * ```tsx
+ * <TableCell>{user.name}</TableCell>
+ * <TableCell><TruncatedCell>{user.bio}</TruncatedCell></TableCell>
+ * ```
+ */
 declare const TableCell: React.ForwardRefExoticComponent<React.TdHTMLAttributes<HTMLTableCellElement> & React.RefAttributes<HTMLTableCellElement>>;
+/**
+ * Legenda da tabela (`<caption>`). Renderiza abaixo (`caption-bottom`).
+ *
+ * @example
+ * ```tsx
+ * <Table>
+ *   <TableCaption>Lista de usuários ativos no sistema.</TableCaption>
+ *   ...
+ * </Table>
+ * ```
+ */
 declare const TableCaption: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLTableCaptionElement> & React.RefAttributes<HTMLTableCaptionElement>>;
 export { Table, TableHeader, TableBody, TableFooter, TableHead, TableRow, TableCell, TableCaption, };