forlogic-core 2.2.8 → 2.3.1

package/dist/places/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?: "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";
+    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/places/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-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/places/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-runtime").JSX.Element;
+export { Skeleton };

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

@@ -0,0 +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/places/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-runtime").JSX.Element;
+export { Toaster, toast };

package/dist/places/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-runtime").JSX.Element;
+export {};

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

@@ -0,0 +1,76 @@
+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): import("react/jsx-runtime").JSX.Element;

package/dist/places/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-runtime").JSX.Element;
+export {};

package/dist/places/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/places/components/ui/step-selector.d.ts

@@ -0,0 +1,46 @@
+/**
+ * @deprecated Use `DialogWizard` para wizards em dialogs. O `StepSelector` será removido em versão futura.
+ * Para wizards dentro de Dialog, use o componente `DialogWizard` que implementa o padrão v2
+ * com stepper vertical lateral.
+ *
+ * StepSelector - Componente de navegação para Wizards multi-etapas (legacy)
+ *
+ * Combina um DropdownMenu para seleção de etapas com uma barra de Progress
+ * para indicação visual do progresso.
+ *
+ * @example
+ * ```tsx
+ * // ✅ Novo padrão — use DialogWizard
+ * <DialogWizard steps={['Tipo', 'Dados', 'Config']} currentStep={step} ... />
+ *
+ * // ⚠️ Legacy — ainda funciona mas será removido
+ * <StepSelector currentStep={step} totalSteps={4} onStepChange={setStep} />
+ * ```
+ */
+export interface StepSelectorProps {
+    /** Etapa atual (1-indexed) */
+    currentStep: number;
+    /** Total de etapas */
+    totalSteps: number;
+    /** Callback chamado quando uma etapa é selecionada */
+    onStepChange: (step: number) => void;
+    /** Labels customizados para cada etapa (opcional) */
+    stepLabels?: string[];
+    /**
+     * Função que valida se pode navegar para uma etapa específica.
+     * Retornar etapas anteriores é sempre permitido.
+     * Se não fornecida, todas as etapas são acessíveis.
+     */
+    canGoToStep?: (targetStep: number) => boolean;
+    /** Classes CSS adicionais */
+    className?: string;
+    /** 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/places/components/ui/stimulsoft-viewer.d.ts

@@ -0,0 +1,28 @@
+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;
+    /**
+     * Parameters passed as query-string to the viewer.
+     * Common keys: Lang, Image, ImageFooter, plus report-specific ones.
+     */
+    parameters?: Record<string, string>;
+    /** Min height for the iframe area (default: 80vh) */
+    minHeight?: string;
+}
+/**
+ * Stimulsoft report viewer — wraps IframeDialog pointing to a
+ * 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/places/components/ui/switch.d.ts

@@ -0,0 +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/places/components/ui/tab-page-layout.d.ts

@@ -0,0 +1,52 @@
+/**
+ * @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;
+    className?: string;
+}
+interface TabPageHeaderProps {
+    title: string | ReactNode;
+    description?: string;
+    actions?: ReactNode;
+    className?: string;
+}
+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 {};