forlogic-core 2.2.8 → 2.3.0

package/dist/sign/components/ui/avatar.d.ts

@@ -0,0 +1,36 @@
+/**
+ * @module Avatar
+ * Avatar circular com fallback automático. Composto por `Avatar` (raiz) +
+ * `AvatarImage` (imagem) + `AvatarFallback` (iniciais quando imagem falha).
+ *
+ * @example
+ * ```tsx
+ * <Avatar>
+ *   <AvatarImage src={user.photoUrl} alt={user.name} />
+ *   <AvatarFallback>{getInitials(user.name)}</AvatarFallback>
+ * </Avatar>
+ * ```
+ *
+ * @see `docs/design-system/data-display.md`
+ */
+import * as React from "react";
+import * as AvatarPrimitive from "@radix-ui/react-avatar";
+/**
+ * Container circular do avatar (default 40x40, `rounded-full`).
+ * @example
+ * <Avatar><AvatarFallback>JD</AvatarFallback></Avatar>
+ */
+declare const Avatar: React.ForwardRefExoticComponent<Omit<AvatarPrimitive.AvatarProps & React.RefAttributes<HTMLSpanElement>, "ref"> & React.RefAttributes<HTMLSpanElement>>;
+/**
+ * Imagem do avatar. Se falhar ao carregar, exibe automaticamente o `AvatarFallback`.
+ * @example
+ * <AvatarImage src="/users/joao.jpg" alt="João" />
+ */
+declare const AvatarImage: React.ForwardRefExoticComponent<Omit<AvatarPrimitive.AvatarImageProps & React.RefAttributes<HTMLImageElement>, "ref"> & React.RefAttributes<HTMLImageElement>>;
+/**
+ * Fallback exibido quando `AvatarImage` falha. Use iniciais ou ícone.
+ * @example
+ * <AvatarFallback>JD</AvatarFallback>
+ */
+declare const AvatarFallback: React.ForwardRefExoticComponent<Omit<AvatarPrimitive.AvatarFallbackProps & React.RefAttributes<HTMLSpanElement>, "ref"> & React.RefAttributes<HTMLSpanElement>>;
+export { Avatar, AvatarImage, AvatarFallback };

package/dist/sign/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?: "secondary" | "outline" | "danger" | "default" | "success" | "warning" | "info" | "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/sign/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">): import("react/jsx-runtime").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">): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};
+export { Breadcrumb, BreadcrumbList, BreadcrumbItem, BreadcrumbLink, BreadcrumbPage, BreadcrumbSeparator, BreadcrumbEllipsis, };

package/dist/sign/components/ui/button-group.d.ts

@@ -0,0 +1,24 @@
+import * as React from "react";
+import { type VariantProps } from "class-variance-authority";
+/**
+ * `buttonGroupVariants` exportado pela lib.
+ * @example
+ * buttonGroupVariants;
+ */
+declare const buttonGroupVariants: (props?: {
+    orientation?: "horizontal" | "vertical";
+} & import("class-variance-authority/types").ClassProp) => string;
+/**
+ * Tipo `ButtonGroupProps` exportado pela lib.
+ * @example
+ * const value: ButtonGroupProps = {} as ButtonGroupProps;
+ */
+export interface ButtonGroupProps extends React.HTMLAttributes<HTMLDivElement>, VariantProps<typeof buttonGroupVariants> {
+}
+/**
+ * Componente `ButtonGroup` da lib.
+ * @example
+ * <ButtonGroup />
+ */
+declare const ButtonGroup: React.ForwardRefExoticComponent<ButtonGroupProps & React.RefAttributes<HTMLDivElement>>;
+export { ButtonGroup, buttonGroupVariants };

package/dist/sign/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" | "primary" | "secondary" | "tertiary" | "outline" | "ghost" | "subtle" | "destructive" | "danger" | "loading" | "default" | "action" | "icon-only" | "external-link" | "action-primary" | "action-secondary";
+    size?: "icon" | "default" | "sm" | "md" | "lg" | "xl" | "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/sign/components/ui/calendar.d.ts

@@ -0,0 +1,24 @@
+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, ...props }: CalendarProps): import("react/jsx-runtime").JSX.Element;
+declare namespace Calendar {
+    var displayName: string;
+}
+export { Calendar };

package/dist/sign/components/ui/card.d.ts

@@ -0,0 +1,57 @@
+/**
+ * @module Card
+ * Container visual com borda e sombra suave. Composto por:
+ * `Card` (raiz) → `CardHeader` (com `CardTitle` + `CardDescription`) → `CardContent` → `CardFooter`.
+ *
+ * @example
+ * ```tsx
+ * <Card>
+ *   <CardHeader>
+ *     <CardTitle>Resumo do mês</CardTitle>
+ *     <CardDescription>Indicadores de abril</CardDescription>
+ *   </CardHeader>
+ *   <CardContent>{children}</CardContent>
+ *   <CardFooter><Button>Ver detalhes</Button></CardFooter>
+ * </Card>
+ * ```
+ *
+ * @see `docs/design-system/data-display.md`
+ */
+import * as React from "react";
+/**
+ * Raiz do card (`rounded-lg border bg-card shadow-sm`).
+ * @example
+ * <Card><CardHeader>...</CardHeader></Card>
+ */
+declare const Card: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & React.RefAttributes<HTMLDivElement>>;
+/**
+ * Cabeçalho do card (padding 6, espaçamento vertical entre título/descrição).
+ * @example
+ * <CardHeader><CardTitle>Vendas</CardTitle></CardHeader>
+ */
+declare const CardHeader: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & React.RefAttributes<HTMLDivElement>>;
+/**
+ * Título do card (`<h3>`, text-2xl, semibold).
+ * @example
+ * <CardTitle>Resumo</CardTitle>
+ */
+declare const CardTitle: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLHeadingElement> & React.RefAttributes<HTMLParagraphElement>>;
+/**
+ * Descrição/subtítulo do card (text-sm muted).
+ * @example
+ * <CardDescription>Últimos 30 dias</CardDescription>
+ */
+declare const CardDescription: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLParagraphElement> & React.RefAttributes<HTMLParagraphElement>>;
+/**
+ * Corpo principal do card. Padding sem top (continua do header).
+ * @example
+ * <CardContent><p>Conteúdo</p></CardContent>
+ */
+declare const CardContent: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & React.RefAttributes<HTMLDivElement>>;
+/**
+ * Rodapé do card. Padrão flex-row alinhado ao centro vertical.
+ * @example
+ * <CardFooter><Button>Ver mais</Button></CardFooter>
+ */
+declare const CardFooter: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & React.RefAttributes<HTMLDivElement>>;
+export { Card, CardHeader, CardFooter, CardTitle, CardDescription, CardContent };

package/dist/sign/components/ui/chart.d.ts

@@ -0,0 +1,97 @@
+import * as React from "react";
+import * as RechartsPrimitive from "recharts";
+declare const THEMES: {
+    readonly light: "";
+    readonly dark: ".dark";
+};
+/**
+ * Tipo `ChartConfig` exportado pela lib.
+ * @example
+ * const value: ChartConfig = {} as ChartConfig;
+ */
+export type ChartConfig = {
+    [k in string]: {
+        label?: React.ReactNode;
+        icon?: React.ComponentType;
+    } & ({
+        color?: string;
+        theme?: never;
+    } | {
+        color?: never;
+        theme: Record<keyof typeof THEMES, string>;
+    });
+};
+/**
+ * Componente `ChartContainer` da lib.
+ * @example
+ * <ChartContainer />
+ */
+declare const ChartContainer: React.ForwardRefExoticComponent<Omit<React.ClassAttributes<HTMLDivElement> & React.HTMLAttributes<HTMLDivElement> & {
+    config: ChartConfig;
+    children: React.ComponentProps<typeof RechartsPrimitive.ResponsiveContainer>["children"];
+}, "ref"> & React.RefAttributes<HTMLDivElement>>;
+/**
+ * Componente `ChartStyle` da lib.
+ * @example
+ * <ChartStyle />
+ */
+declare const ChartStyle: ({ id, config }: {
+    id: string;
+    config: ChartConfig;
+}) => import("react/jsx-runtime").JSX.Element;
+/**
+ * Componente `ChartTooltip` da lib.
+ * @example
+ * <ChartTooltip />
+ */
+declare const ChartTooltip: typeof RechartsPrimitive.Tooltip;
+interface ChartTooltipContentProps extends React.ComponentProps<"div"> {
+    active?: boolean;
+    payload?: Array<{
+        value?: number | string;
+        name?: string;
+        dataKey?: string;
+        color?: string;
+        fill?: string;
+        payload?: Record<string, unknown>;
+    }>;
+    label?: string;
+    labelFormatter?: (value: unknown, payload: unknown[]) => React.ReactNode;
+    formatter?: (value: unknown, name: unknown, item: unknown, index: number, payload: unknown) => React.ReactNode;
+    hideLabel?: boolean;
+    hideIndicator?: boolean;
+    indicator?: "line" | "dot" | "dashed";
+    nameKey?: string;
+    labelKey?: string;
+    labelClassName?: string;
+    color?: string;
+}
+/**
+ * Componente `ChartTooltipContent` da lib.
+ * @example
+ * <ChartTooltipContent />
+ */
+declare const ChartTooltipContent: React.ForwardRefExoticComponent<Omit<ChartTooltipContentProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
+/**
+ * Componente `ChartLegend` da lib.
+ * @example
+ * <ChartLegend />
+ */
+declare const ChartLegend: React.MemoExoticComponent<(outsideProps: RechartsPrimitive.LegendProps) => React.ReactPortal | null>;
+interface ChartLegendContentProps extends React.ComponentProps<"div"> {
+    payload?: Array<{
+        value?: string;
+        dataKey?: string;
+        color?: string;
+    }>;
+    verticalAlign?: "top" | "bottom";
+    hideIcon?: boolean;
+    nameKey?: string;
+}
+/**
+ * Componente `ChartLegendContent` da lib.
+ * @example
+ * <ChartLegendContent />
+ */
+declare const ChartLegendContent: React.ForwardRefExoticComponent<Omit<ChartLegendContentProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
+export { ChartContainer, ChartTooltip, ChartTooltipContent, ChartLegend, ChartLegendContent, ChartStyle, };

package/dist/sign/components/ui/checkbox.d.ts

@@ -0,0 +1,15 @@
+import * as React from "react";
+import * as CheckboxPrimitive from "@radix-ui/react-checkbox";
+/**
+ * Caixa de seleção binária (16x16). Suporta estados controlado/não controlado e indeterminate.
+ *
+ * @example
+ * ```tsx
+ * <Checkbox checked={agreed} onCheckedChange={setAgreed} id="terms" />
+ * <Label htmlFor="terms">Aceito os termos</Label>
+ * ```
+ *
+ * @see `docs/design-system/inputs.md`
+ */
+declare const Checkbox: React.ForwardRefExoticComponent<Omit<CheckboxPrimitive.CheckboxProps & React.RefAttributes<HTMLButtonElement>, "ref"> & React.RefAttributes<HTMLButtonElement>>;
+export { Checkbox };

package/dist/sign/components/ui/collapsible.d.ts

@@ -0,0 +1,20 @@
+import * as CollapsiblePrimitive from "@radix-ui/react-collapsible";
+/**
+ * Componente `Collapsible` da lib.
+ * @example
+ * <Collapsible />
+ */
+declare const Collapsible: import("react").ForwardRefExoticComponent<CollapsiblePrimitive.CollapsibleProps & import("react").RefAttributes<HTMLDivElement>>;
+/**
+ * Componente `CollapsibleTrigger` da lib.
+ * @example
+ * <CollapsibleTrigger />
+ */
+declare const CollapsibleTrigger: import("react").ForwardRefExoticComponent<CollapsiblePrimitive.CollapsibleTriggerProps & import("react").RefAttributes<HTMLButtonElement>>;
+/**
+ * Componente `CollapsibleContent` da lib.
+ * @example
+ * <CollapsibleContent />
+ */
+declare const CollapsibleContent: import("react").ForwardRefExoticComponent<CollapsiblePrimitive.CollapsibleContentProps & import("react").RefAttributes<HTMLDivElement>>;
+export { Collapsible, CollapsibleTrigger, CollapsibleContent };

package/dist/sign/components/ui/color-picker.d.ts

@@ -0,0 +1,19 @@
+import React from 'react';
+interface ColorPickerProps {
+    value?: string;
+    onChange?: (color: string) => void;
+    label?: string;
+    /** i18n: Label for custom color input (default: t('custom_color')) */
+    customColorLabel?: string;
+    /** i18n: Label for preset colors section (default: t('preset_colors')) */
+    presetColorsLabel?: string;
+    /** Mostra o valor hexadecimal ao lado do swatch (default: true) */
+    showHexValue?: boolean;
+}
+/**
+ * Componente `ColorPicker` da lib.
+ * @example
+ * <ColorPicker />
+ */
+export declare const ColorPicker: React.FC<ColorPickerProps>;
+export {};

package/dist/sign/components/ui/combo-tree.d.ts

@@ -0,0 +1,103 @@
+import React from 'react';
+/**
+ * ComboTree Component
+ *
+ * Componente para seleção de itens hierárquicos (tree view) com busca recursiva.
+ * Baseado no Combobox, adaptado para exibir níveis de profundidade com expansão
+ * controlada por chevron e seleção por label.
+ *
+ * @example
+ * ```tsx
+ * const options: ComboTreeOption[] = [
+ *   {
+ *     value: 'quality',
+ *     label: 'Qualidade',
+ *     children: [
+ *       { value: 'docs', label: 'Documentos' },
+ *       { value: 'occurrences', label: 'Ocorrências' },
+ *     ],
+ *   },
+ *   { value: 'hr', label: 'RH' },
+ * ];
+ *
+ * <ComboTree
+ *   options={options}
+ *   value={selected}
+ *   onChange={setSelected}
+ *   placeholder="Selecione..."
+ * />
+ * ```
+ *
+ * ## Comportamento
+ * - **Chevron**: expande/recolhe subgrupos (não seleciona)
+ * - **Label**: seleciona o item (não expande)
+ * - **Busca**: filtra recursivamente, mantém ancestrais visíveis e auto-expande
+ */
+export interface ComboTreeOption {
+    value: string;
+    label: string;
+    icon?: React.ComponentType<{
+        className?: string;
+    }>;
+    /** Icon shown when this node is expanded (falls back to `icon`) */
+    iconOpen?: React.ComponentType<{
+        className?: string;
+    }>;
+    /** Icon shown when this node is selected (falls back to `icon`) */
+    iconSelected?: React.ComponentType<{
+        className?: string;
+    }>;
+    /** Custom className for the icon (e.g. color) */
+    iconClassName?: string;
+    children?: ComboTreeOption[];
+}
+export interface ComboTreeProps {
+    multiple?: boolean;
+    options: ComboTreeOption[];
+    value?: string | string[];
+    onChange?: (value: string | string[]) => void;
+    placeholder?: string;
+    label?: string;
+    icon?: React.ComponentType<{
+        className?: string;
+    }>;
+    emptyMessage?: string;
+    searchPlaceholder?: string;
+    disabled?: boolean;
+    required?: boolean;
+    isLoading?: boolean;
+    error?: string | boolean | Error | null;
+    className?: string;
+    maxDisplayedBadges?: number;
+    popoverContainer?: HTMLElement | null;
+    onOpen?: () => void;
+    onClose?: () => void;
+    /** Whether parent nodes start expanded. Defaults to true. */
+    defaultExpanded?: boolean;
+    /** When true, shows a check icon on the left of selected items. Defaults to false. */
+    showCheck?: boolean;
+}
+/**
+ * ComboTree — Combobox para dados hierárquicos (tree view). Chevron expande/colapsa
+ * subgrupos, label seleciona o item. Busca filtra recursivamente preservando ancestrais
+ * e auto-expande os ramos com matches.
+ *
+ * Alias disponível: `TreeSelect` (padrão Ant Design / Syncfusion).
+ *
+ * @example
+ * const options: ComboTreeOption[] = [
+ *   { value: 'qa', label: 'Qualidade', children: [
+ *     { value: 'docs', label: 'Documentos' },
+ *     { value: 'occ',  label: 'Ocorrências' },
+ *   ]},
+ *   { value: 'hr', label: 'RH' },
+ * ];
+ *
+ * <ComboTree
+ *   options={options}
+ *   value={selectedNode}
+ *   onChange={setSelectedNode}
+ *   placeholder="Selecionar módulo..."
+ * />
+ */
+export declare function ComboTree({ multiple, options, value, onChange, placeholder, label, icon: Icon, emptyMessage, searchPlaceholder, disabled, required, isLoading, error, className, maxDisplayedBadges, popoverContainer, onOpen, onClose, defaultExpanded, showCheck, }: ComboTreeProps): import("react/jsx-runtime").JSX.Element;

package/dist/sign/components/ui/combobox.d.ts

@@ -0,0 +1,64 @@
+import React from 'react';
+export interface ComboboxProps<T = any> {
+    multiple?: boolean;
+    options: T[];
+    value?: string | string[];
+    onChange?: (value: string | string[]) => void;
+    getOptionValue?: (option: T) => string;
+    getOptionLabel?: (option: T) => string;
+    placeholder?: string;
+    label?: string;
+    icon?: React.ComponentType<{
+        className?: string;
+    }>;
+    emptyMessage?: string;
+    searchPlaceholder?: string;
+    disabled?: boolean;
+    required?: boolean;
+    isLoading?: boolean;
+    error?: string | boolean | Error | null;
+    className?: string;
+    sortOptions?: boolean;
+    maxDisplayedBadges?: number;
+    popoverContainer?: HTMLElement | null;
+    onOpen?: () => void;
+    onClose?: () => void;
+    clearable?: boolean;
+    showCheck?: boolean;
+    /** @deprecated Use `options` instead. Will be removed in a future version. */
+    items?: T[];
+    onValueChange?: (value: string | string[]) => void;
+}
+/**
+ * Combobox — componente de seleção (única ou múltipla) com busca, suporte a
+ * objetos customizados via `getOptionValue`/`getOptionLabel`, badges para
+ * valores selecionados e integração com Dialogs (use `popoverContainer`).
+ *
+ * Para a documentação completa de props e variantes, veja o JSDoc no topo
+ * deste arquivo. Aliases: `SelectSearch`, `MultiSelect`, `EntitySelect`, `AutoComplete`.
+ *
+ * @example
+ * <Combobox
+ *   options={users}
+ *   value={selectedId}
+ *   onChange={setSelectedId}
+ *   getOptionValue={(u) => u.id}
+ *   getOptionLabel={(u) => u.name}
+ *   placeholder="Selecionar responsável..."
+ * />
+ *
+ * @example
+ * // Múltipla seleção com badges
+ * <Combobox
+ *   multiple
+ *   options={tags}
+ *   value={selectedTagIds}
+ *   onChange={setSelectedTagIds}
+ *   maxDisplayedBadges={3}
+ * />
+ */
+export declare function Combobox<T = any>({ multiple, options: optionsProp, items, // alias
+value, onChange: onChangeProp, onValueChange, // alias
+getOptionValue, getOptionLabel, placeholder, label, icon, emptyMessage, searchPlaceholder, disabled, required, isLoading, error, className, sortOptions, maxDisplayedBadges, popoverContainer, onOpen, onClose, clearable, showCheck }: ComboboxProps<T>): import("react/jsx-runtime").JSX.Element;
+export type SelectSearchProps<T = any> = ComboboxProps<T>;
+export declare const SelectSearch: typeof Combobox;