@flowtomic/ui 0.1.14 → 0.2.0

package/dist/components/atoms/feedback/popover/popover.js

@@ -1,14 +1,78 @@
 import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * # Popover Component
+ *
+ * O componente `Popover` é usado para exibir conteúdo flutuante que aparece
+ * quando o usuário clica em um trigger. É baseado em Radix UI para garantir
+ * acessibilidade completa.
+ *
+ * ## Características Principais
+ *
+ * - **Acessível**: Baseado em Radix UI com suporte completo a leitores de tela
+ * - **Posicionamento**: Suporta alinhamento e offset customizáveis
+ * - **Composição**: Popover + PopoverTrigger + PopoverContent para flexibilidade
+ * - **Foco Gerenciado**: Foco e navegação por teclado gerenciados automaticamente
+ *
+ * ## Uso Básico
+ *
+ * ```tsx
+ * import { Popover, PopoverTrigger, PopoverContent } from "@flowtomic/ui/components/atoms/feedback/popover";
+ *
+ * function MyComponent() {
+ *   return (
+ *     <Popover>
+ *       <PopoverTrigger>Open</PopoverTrigger>
+ *       <PopoverContent>
+ *         <p>Conteúdo do popover</p>
+ *       </PopoverContent>
+ *     </Popover>
+ *   );
+ * }
+ * ```
+ *
+ * ## Acessibilidade
+ *
+ * - Suporta navegação por teclado (Tab, Escape)
+ * - Segue padrões WAI-ARIA via Radix UI
+ * - Suporta leitores de tela
+ * - Foco gerenciado automaticamente
+ *
+ * @see [Radix UI Popover](https://www.radix-ui.com/primitives/docs/components/popover) para mais detalhes
+ */
 import * as PopoverPrimitive from "@radix-ui/react-popover";
 import { cn } from "@/lib/utils";
+/**
+ * Popover - Container principal do popover.
+ *
+ * Componente usado para exibir conteúdo flutuante quando o usuário clica em um trigger.
+ *
+ * @param {PopoverProps} props - Props do componente
+ * @returns {JSX.Element} Componente Popover
+ */
 function Popover({ ...props }) {
     return _jsx(PopoverPrimitive.Root, { "data-slot": "popover", ...props });
 }
 Popover.displayName = "Popover";
+/**
+ * PopoverTrigger - Trigger do popover.
+ *
+ * Componente usado como trigger para abrir o popover.
+ *
+ * @param {PopoverTriggerProps} props - Props do componente
+ * @returns {JSX.Element} Componente PopoverTrigger
+ */
 function PopoverTrigger({ ...props }) {
     return _jsx(PopoverPrimitive.Trigger, { "data-slot": "popover-trigger", ...props });
 }
 PopoverTrigger.displayName = "PopoverTrigger";
+/**
+ * PopoverContent - Conteúdo do popover.
+ *
+ * Componente usado para exibir o conteúdo do popover.
+ *
+ * @param {PopoverContentProps} props - Props do componente
+ * @returns {JSX.Element} Componente PopoverContent
+ */
 function PopoverContent({ className, align = "center", sideOffset = 4, ...props }) {
     return (_jsx(PopoverPrimitive.Portal, { children: _jsx(PopoverPrimitive.Content, { "data-slot": "popover-content", align: align, sideOffset: sideOffset, className: cn("bg-popover text-popover-foreground data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95 data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2 z-50 w-72 origin-(--radix-popover-content-transform-origin) rounded-md border p-4 shadow-md outline-hidden", className), ...props }) }));
 }

package/dist/components/atoms/feedback/sheet/sheet.d.ts

@@ -1,13 +1,89 @@
+/**
+ * # Sheet Component
+ *
+ * O componente `Sheet` é usado para exibir conteúdo em um painel lateral deslizante.
+ * É baseado em Radix UI Dialog para garantir acessibilidade completa.
+ *
+ * ## Características Principais
+ *
+ * - **Acessível**: Baseado em Radix UI Dialog com suporte completo a leitores de tela
+ * - **Lados**: Suporta abertura de qualquer lado (top, right, bottom, left)
+ * - **Composição**: Múltiplos sub-componentes para flexibilidade
+ * - **Foco Gerenciado**: Foco e navegação por teclado gerenciados automaticamente
+ * - **Overlay**: Overlay escuro por padrão
+ *
+ * ## Componentes
+ *
+ * - **Sheet**: Container principal
+ * - **SheetTrigger**: Trigger para abrir o sheet
+ * - **SheetContent**: Conteúdo do sheet
+ * - **SheetHeader**: Cabeçalho do sheet
+ * - **SheetFooter**: Rodapé do sheet
+ * - **SheetTitle**: Título do sheet
+ * - **SheetDescription**: Descrição do sheet
+ * - **SheetClose**: Botão de fechar
+ *
+ * ## Uso Básico
+ *
+ * ```tsx
+ * import { Sheet, SheetTrigger, SheetContent, SheetHeader, SheetTitle } from "@flowtomic/ui/components/atoms/feedback/sheet";
+ *
+ * function MyComponent() {
+ *   return (
+ *     <Sheet>
+ *       <SheetTrigger>Open Sheet</SheetTrigger>
+ *       <SheetContent>
+ *         <SheetHeader>
+ *           <SheetTitle>Sheet Title</SheetTitle>
+ *         </SheetHeader>
+ *       </SheetContent>
+ *     </Sheet>
+ *   );
+ * }
+ * ```
+ *
+ * ## Acessibilidade
+ *
+ * - Suporta navegação por teclado (Tab, Escape)
+ * - Segue padrões WAI-ARIA via Radix UI
+ * - Suporta leitores de tela
+ * - Foco gerenciado automaticamente
+ * - Foco retorna ao trigger quando fechado
+ *
+ * @see [Radix UI Dialog](https://www.radix-ui.com/primitives/docs/components/dialog) para mais detalhes
+ */
 import * as SheetPrimitive from "@radix-ui/react-dialog";
 import type * as React from "react";
+/**
+ * Props do componente Sheet.
+ */
 export interface SheetProps extends React.ComponentProps<typeof SheetPrimitive.Root> {
 }
+/**
+ * Sheet - Container principal do sheet.
+ *
+ * Componente usado para gerenciar o estado do sheet.
+ *
+ * @param {SheetProps} props - Props do componente
+ * @returns {JSX.Element} Componente Sheet
+ */
 declare function Sheet({ ...props }: SheetProps): import("react/jsx-runtime").JSX.Element;
 declare namespace Sheet {
     var displayName: string;
 }
+/**
+ * Props do componente SheetTrigger.
+ */
 export interface SheetTriggerProps extends React.ComponentProps<typeof SheetPrimitive.Trigger> {
 }
+/**
+ * SheetTrigger - Trigger do sheet.
+ *
+ * Componente usado como trigger para abrir o sheet.
+ *
+ * @param {SheetTriggerProps} props - Props do componente
+ * @returns {JSX.Element} Componente SheetTrigger
+ */
 declare function SheetTrigger({ ...props }: SheetTriggerProps): import("react/jsx-runtime").JSX.Element;
 declare namespace SheetTrigger {
     var displayName: string;
@@ -30,9 +106,23 @@ declare function SheetOverlay({ className, ...props }: SheetOverlayProps): impor
 declare namespace SheetOverlay {
     var displayName: string;
 }
+/**
+ * Props do componente SheetContent.
+ *
+ * @property {'top' | 'right' | 'bottom' | 'left'} [side='right'] - Lado de onde o sheet abre
+ */
 export interface SheetContentProps extends React.ComponentProps<typeof SheetPrimitive.Content> {
+    /** Lado de onde o sheet abre */
     side?: "top" | "right" | "bottom" | "left";
 }
+/**
+ * SheetContent - Conteúdo do sheet.
+ *
+ * Componente usado para exibir o conteúdo do sheet.
+ *
+ * @param {SheetContentProps} props - Props do componente
+ * @returns {JSX.Element} Componente SheetContent
+ */
 declare function SheetContent({ className, children, side, ...props }: SheetContentProps): import("react/jsx-runtime").JSX.Element;
 declare namespace SheetContent {
     var displayName: string;

package/dist/components/atoms/feedback/sheet/sheet.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sheet.d.ts","sourceRoot":"","sources":["../../../../../src/components/atoms/feedback/sheet/sheet.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,cAAc,MAAM,wBAAwB,CAAC;AAEzD,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AAGpC,MAAM,WAAW,UAAW,SAAQ,KAAK,CAAC,cAAc,CAAC,OAAO,cAAc,CAAC,IAAI,CAAC;CAAG;AAEvF,iBAAS,KAAK,CAAC,EAAE,GAAG,KAAK,EAAE,EAAE,UAAU,2CAEtC;kBAFQ,KAAK;;;AAMd,MAAM,WAAW,iBAAkB,SAAQ,KAAK,CAAC,cAAc,CAAC,OAAO,cAAc,CAAC,OAAO,CAAC;CAAG;AAEjG,iBAAS,YAAY,CAAC,EAAE,GAAG,KAAK,EAAE,EAAE,iBAAiB,2CAEpD;kBAFQ,YAAY;;;AAMrB,MAAM,WAAW,eAAgB,SAAQ,KAAK,CAAC,cAAc,CAAC,OAAO,cAAc,CAAC,KAAK,CAAC;CAAG;AAE7F,iBAAS,UAAU,CAAC,EAAE,GAAG,KAAK,EAAE,EAAE,eAAe,2CAEhD;kBAFQ,UAAU;;;AAMnB,MAAM,WAAW,gBAAiB,SAAQ,KAAK,CAAC,cAAc,CAAC,OAAO,cAAc,CAAC,MAAM,CAAC;CAAG;AAE/F,iBAAS,WAAW,CAAC,EAAE,GAAG,KAAK,EAAE,EAAE,gBAAgB,2CAElD;kBAFQ,WAAW;;;AAMpB,MAAM,WAAW,iBAAkB,SAAQ,KAAK,CAAC,cAAc,CAAC,OAAO,cAAc,CAAC,OAAO,CAAC;CAAG;AAEjG,iBAAS,YAAY,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,iBAAiB,2CAW/D;kBAXQ,YAAY;;;AAerB,MAAM,WAAW,iBAAkB,SAAQ,KAAK,CAAC,cAAc,CAAC,OAAO,cAAc,CAAC,OAAO,CAAC;IAC5F,IAAI,CAAC,EAAE,KAAK,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;CAC5C;AAED,iBAAS,YAAY,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAc,EAAE,GAAG,KAAK,EAAE,EAAE,iBAAiB,2CA4BzF;kBA5BQ,YAAY;;;AAgCrB,MAAM,WAAW,gBAAiB,SAAQ,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC;CAAG;AAExE,iBAAS,WAAW,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,gBAAgB,2CAQ7D;kBARQ,WAAW;;;AAYpB,MAAM,WAAW,gBAAiB,SAAQ,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC;CAAG;AAExE,iBAAS,WAAW,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,gBAAgB,2CAQ7D;kBARQ,WAAW;;;AAYpB,MAAM,WAAW,eAAgB,SAAQ,KAAK,CAAC,cAAc,CAAC,OAAO,cAAc,CAAC,KAAK,CAAC;CAAG;AAE7F,iBAAS,UAAU,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,eAAe,2CAQ3D;kBARQ,UAAU;;;AAYnB,MAAM,WAAW,qBACf,SAAQ,KAAK,CAAC,cAAc,CAAC,OAAO,cAAc,CAAC,WAAW,CAAC;CAAG;AAEpE,iBAAS,gBAAgB,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,qBAAqB,2CAQvE;kBARQ,gBAAgB;;;AAYzB,OAAO,EACL,KAAK,EACL,YAAY,EACZ,UAAU,EACV,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,WAAW,EACX,UAAU,EACV,gBAAgB,GACjB,CAAC"}
+{"version":3,"file":"sheet.d.ts","sourceRoot":"","sources":["../../../../../src/components/atoms/feedback/sheet/sheet.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AAEH,OAAO,KAAK,cAAc,MAAM,wBAAwB,CAAC;AAEzD,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AAGpC;;GAEG;AACH,MAAM,WAAW,UAAW,SAAQ,KAAK,CAAC,cAAc,CAAC,OAAO,cAAc,CAAC,IAAI,CAAC;CAAG;AAEvF;;;;;;;GAOG;AACH,iBAAS,KAAK,CAAC,EAAE,GAAG,KAAK,EAAE,EAAE,UAAU,2CAEtC;kBAFQ,KAAK;;;AAMd;;GAEG;AACH,MAAM,WAAW,iBAAkB,SAAQ,KAAK,CAAC,cAAc,CAAC,OAAO,cAAc,CAAC,OAAO,CAAC;CAAG;AAEjG;;;;;;;GAOG;AACH,iBAAS,YAAY,CAAC,EAAE,GAAG,KAAK,EAAE,EAAE,iBAAiB,2CAEpD;kBAFQ,YAAY;;;AAMrB,MAAM,WAAW,eAAgB,SAAQ,KAAK,CAAC,cAAc,CAAC,OAAO,cAAc,CAAC,KAAK,CAAC;CAAG;AAE7F,iBAAS,UAAU,CAAC,EAAE,GAAG,KAAK,EAAE,EAAE,eAAe,2CAEhD;kBAFQ,UAAU;;;AAMnB,MAAM,WAAW,gBAAiB,SAAQ,KAAK,CAAC,cAAc,CAAC,OAAO,cAAc,CAAC,MAAM,CAAC;CAAG;AAE/F,iBAAS,WAAW,CAAC,EAAE,GAAG,KAAK,EAAE,EAAE,gBAAgB,2CAElD;kBAFQ,WAAW;;;AAMpB,MAAM,WAAW,iBAAkB,SAAQ,KAAK,CAAC,cAAc,CAAC,OAAO,cAAc,CAAC,OAAO,CAAC;CAAG;AAEjG,iBAAS,YAAY,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,iBAAiB,2CAW/D;kBAXQ,YAAY;;;AAerB;;;;GAIG;AACH,MAAM,WAAW,iBAAkB,SAAQ,KAAK,CAAC,cAAc,CAAC,OAAO,cAAc,CAAC,OAAO,CAAC;IAC5F,gCAAgC;IAChC,IAAI,CAAC,EAAE,KAAK,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;CAC5C;AAED;;;;;;;GAOG;AACH,iBAAS,YAAY,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAc,EAAE,GAAG,KAAK,EAAE,EAAE,iBAAiB,2CA4BzF;kBA5BQ,YAAY;;;AAgCrB,MAAM,WAAW,gBAAiB,SAAQ,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC;CAAG;AAExE,iBAAS,WAAW,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,gBAAgB,2CAQ7D;kBARQ,WAAW;;;AAYpB,MAAM,WAAW,gBAAiB,SAAQ,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC;CAAG;AAExE,iBAAS,WAAW,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,gBAAgB,2CAQ7D;kBARQ,WAAW;;;AAYpB,MAAM,WAAW,eAAgB,SAAQ,KAAK,CAAC,cAAc,CAAC,OAAO,cAAc,CAAC,KAAK,CAAC;CAAG;AAE7F,iBAAS,UAAU,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,eAAe,2CAQ3D;kBARQ,UAAU;;;AAYnB,MAAM,WAAW,qBACf,SAAQ,KAAK,CAAC,cAAc,CAAC,OAAO,cAAc,CAAC,WAAW,CAAC;CAAG;AAEpE,iBAAS,gBAAgB,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,qBAAqB,2CAQvE;kBARQ,gBAAgB;;;AAYzB,OAAO,EACL,KAAK,EACL,YAAY,EACZ,UAAU,EACV,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,WAAW,EACX,UAAU,EACV,gBAAgB,GACjB,CAAC"}

package/dist/components/atoms/feedback/sheet/sheet.js

@@ -1,11 +1,81 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * # Sheet Component
+ *
+ * O componente `Sheet` é usado para exibir conteúdo em um painel lateral deslizante.
+ * É baseado em Radix UI Dialog para garantir acessibilidade completa.
+ *
+ * ## Características Principais
+ *
+ * - **Acessível**: Baseado em Radix UI Dialog com suporte completo a leitores de tela
+ * - **Lados**: Suporta abertura de qualquer lado (top, right, bottom, left)
+ * - **Composição**: Múltiplos sub-componentes para flexibilidade
+ * - **Foco Gerenciado**: Foco e navegação por teclado gerenciados automaticamente
+ * - **Overlay**: Overlay escuro por padrão
+ *
+ * ## Componentes
+ *
+ * - **Sheet**: Container principal
+ * - **SheetTrigger**: Trigger para abrir o sheet
+ * - **SheetContent**: Conteúdo do sheet
+ * - **SheetHeader**: Cabeçalho do sheet
+ * - **SheetFooter**: Rodapé do sheet
+ * - **SheetTitle**: Título do sheet
+ * - **SheetDescription**: Descrição do sheet
+ * - **SheetClose**: Botão de fechar
+ *
+ * ## Uso Básico
+ *
+ * ```tsx
+ * import { Sheet, SheetTrigger, SheetContent, SheetHeader, SheetTitle } from "@flowtomic/ui/components/atoms/feedback/sheet";
+ *
+ * function MyComponent() {
+ *   return (
+ *     <Sheet>
+ *       <SheetTrigger>Open Sheet</SheetTrigger>
+ *       <SheetContent>
+ *         <SheetHeader>
+ *           <SheetTitle>Sheet Title</SheetTitle>
+ *         </SheetHeader>
+ *       </SheetContent>
+ *     </Sheet>
+ *   );
+ * }
+ * ```
+ *
+ * ## Acessibilidade
+ *
+ * - Suporta navegação por teclado (Tab, Escape)
+ * - Segue padrões WAI-ARIA via Radix UI
+ * - Suporta leitores de tela
+ * - Foco gerenciado automaticamente
+ * - Foco retorna ao trigger quando fechado
+ *
+ * @see [Radix UI Dialog](https://www.radix-ui.com/primitives/docs/components/dialog) para mais detalhes
+ */
 import * as SheetPrimitive from "@radix-ui/react-dialog";
 import { XIcon } from "lucide-react";
 import { cn } from "@/lib/utils";
+/**
+ * Sheet - Container principal do sheet.
+ *
+ * Componente usado para gerenciar o estado do sheet.
+ *
+ * @param {SheetProps} props - Props do componente
+ * @returns {JSX.Element} Componente Sheet
+ */
 function Sheet({ ...props }) {
     return _jsx(SheetPrimitive.Root, { "data-slot": "sheet", ...props });
 }
 Sheet.displayName = "Sheet";
+/**
+ * SheetTrigger - Trigger do sheet.
+ *
+ * Componente usado como trigger para abrir o sheet.
+ *
+ * @param {SheetTriggerProps} props - Props do componente
+ * @returns {JSX.Element} Componente SheetTrigger
+ */
 function SheetTrigger({ ...props }) {
     return _jsx(SheetPrimitive.Trigger, { "data-slot": "sheet-trigger", ...props });
 }
@@ -22,6 +92,14 @@ function SheetOverlay({ className, ...props }) {
     return (_jsx(SheetPrimitive.Overlay, { "data-slot": "sheet-overlay", className: cn("data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 fixed inset-0 z-50 bg-black/50", className), ...props }));
 }
 SheetOverlay.displayName = "SheetOverlay";
+/**
+ * SheetContent - Conteúdo do sheet.
+ *
+ * Componente usado para exibir o conteúdo do sheet.
+ *
+ * @param {SheetContentProps} props - Props do componente
+ * @returns {JSX.Element} Componente SheetContent
+ */
 function SheetContent({ className, children, side = "right", ...props }) {
     return (_jsxs(SheetPortal, { children: [_jsx(SheetOverlay, {}), _jsxs(SheetPrimitive.Content, { "data-slot": "sheet-content", className: cn("bg-background data-[state=open]:animate-in data-[state=closed]:animate-out fixed z-50 flex flex-col gap-4 shadow-lg transition ease-in-out data-[state=closed]:duration-300 data-[state=open]:duration-500", side === "right" &&
                     "data-[state=closed]:slide-out-to-right data-[state=open]:slide-in-from-right inset-y-0 right-0 h-full w-3/4 border-l sm:max-w-sm", side === "left" &&

package/dist/components/atoms/feedback/sonner/sonner.d.ts

@@ -1,12 +1,72 @@
 /**
- * Sonner Component - Flowtomic UI
+ * # Sonner Component (Toaster)
  *
- * Componente Sonner próprio do design-system
- * Implementação padronizada seguindo os padrões do design system
- * Baseado em: https://ui.shadcn.com/docs/components/sonner
+ * O componente `Toaster` (Sonner) é usado para exibir notificações toast
+ * na aplicação. Fornece feedback visual para ações do usuário com diferentes
+ * tipos de mensagens (success, error, warning, info, loading).
  *
- * NOTA: Este componente requer que o tema seja passado como prop
- * ou que o projeto use um hook de tema compatível
+ * ## Características Principais
+ *
+ * - **Múltiplos Tipos**: Suporta success, error, warning, info e loading
+ * - **Posicionamento**: Configurável (padrão: top-right)
+ * - **Tema**: Suporta light e dark
+ * - **Ícones**: Ícones customizados para cada tipo
+ * - **Ações**: Suporta botões de ação e cancelamento
+ *
+ * ## Tipos de Toast
+ *
+ * - **success**: Mensagens de sucesso (verde)
+ * - **error**: Mensagens de erro (vermelho)
+ * - **warning**: Avisos (amarelo)
+ * - **info**: Informações (azul)
+ * - **loading**: Carregamento (spinner)
+ *
+ * ## Uso Básico
+ *
+ * ```tsx
+ * import { Toaster, toast } from "@flowtomic/ui/components/atoms/feedback/sonner";
+ *
+ * function App() {
+ *   return (
+ *     <>
+ *       <Toaster />
+ *       <button onClick={() => toast.success("Operação realizada com sucesso!")}>
+ *         Mostrar Toast
+ *       </button>
+ *     </>
+ *   );
+ * }
+ * ```
+ *
+ * ## Exemplos de Uso
+ *
+ * ```tsx
+ * // Success
+ * toast.success("Operação realizada com sucesso!");
+ *
+ * // Error
+ * toast.error("Erro ao processar requisição");
+ *
+ * // Warning
+ * toast.warning("Atenção: ação irreversível");
+ *
+ * // Info
+ * toast.info("Nova atualização disponível");
+ *
+ * // Loading
+ * const toastId = toast.loading("Processando...");
+ * // Depois atualizar para success
+ * toast.success("Concluído!", { id: toastId });
+ * ```
+ *
+ * ## Acessibilidade
+ *
+ * - Suporta leitores de tela
+ * - Navegação por teclado
+ * - Foco gerenciado automaticamente
+ *
+ * @see [Sonner Documentation](https://sonner.emilkowal.ski/) para mais detalhes
+ * @see [shadcn/ui Sonner](https://ui.shadcn.com/docs/components/sonner) para referência
  */
 import { type ToasterProps as SonnerToasterProps } from "sonner";
 export interface ToasterProps extends Omit<SonnerToasterProps, "theme"> {

package/dist/components/atoms/feedback/sonner/sonner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sonner.d.ts","sourceRoot":"","sources":["../../../../../src/components/atoms/feedback/sonner/sonner.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAWH,OAAO,EAA4B,KAAK,YAAY,IAAI,kBAAkB,EAAE,MAAM,QAAQ,CAAC;AAE3F,MAAM,WAAW,YAAa,SAAQ,IAAI,CAAC,kBAAkB,EAAE,OAAO,CAAC;IACrE;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;CAC1B;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,EAAE,KAAe,EAAE,GAAG,KAAK,EAAE,EAAE,YAAY,2CAsClE;AAGD,OAAO,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC"}
+{"version":3,"file":"sonner.d.ts","sourceRoot":"","sources":["../../../../../src/components/atoms/feedback/sonner/sonner.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqEG;AAWH,OAAO,EAA4B,KAAK,YAAY,IAAI,kBAAkB,EAAE,MAAM,QAAQ,CAAC;AAE3F,MAAM,WAAW,YAAa,SAAQ,IAAI,CAAC,kBAAkB,EAAE,OAAO,CAAC;IACrE;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;CAC1B;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,EAAE,KAAe,EAAE,GAAG,KAAK,EAAE,EAAE,YAAY,2CAsClE;AAGD,OAAO,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC"}

package/dist/components/atoms/feedback/sonner/sonner.js

@@ -1,12 +1,72 @@
 /**
- * Sonner Component - Flowtomic UI
+ * # Sonner Component (Toaster)
  *
- * Componente Sonner próprio do design-system
- * Implementação padronizada seguindo os padrões do design system
- * Baseado em: https://ui.shadcn.com/docs/components/sonner
+ * O componente `Toaster` (Sonner) é usado para exibir notificações toast
+ * na aplicação. Fornece feedback visual para ações do usuário com diferentes
+ * tipos de mensagens (success, error, warning, info, loading).
  *
- * NOTA: Este componente requer que o tema seja passado como prop
- * ou que o projeto use um hook de tema compatível
+ * ## Características Principais
+ *
+ * - **Múltiplos Tipos**: Suporta success, error, warning, info e loading
+ * - **Posicionamento**: Configurável (padrão: top-right)
+ * - **Tema**: Suporta light e dark
+ * - **Ícones**: Ícones customizados para cada tipo
+ * - **Ações**: Suporta botões de ação e cancelamento
+ *
+ * ## Tipos de Toast
+ *
+ * - **success**: Mensagens de sucesso (verde)
+ * - **error**: Mensagens de erro (vermelho)
+ * - **warning**: Avisos (amarelo)
+ * - **info**: Informações (azul)
+ * - **loading**: Carregamento (spinner)
+ *
+ * ## Uso Básico
+ *
+ * ```tsx
+ * import { Toaster, toast } from "@flowtomic/ui/components/atoms/feedback/sonner";
+ *
+ * function App() {
+ *   return (
+ *     <>
+ *       <Toaster />
+ *       <button onClick={() => toast.success("Operação realizada com sucesso!")}>
+ *         Mostrar Toast
+ *       </button>
+ *     </>
+ *   );
+ * }
+ * ```
+ *
+ * ## Exemplos de Uso
+ *
+ * ```tsx
+ * // Success
+ * toast.success("Operação realizada com sucesso!");
+ *
+ * // Error
+ * toast.error("Erro ao processar requisição");
+ *
+ * // Warning
+ * toast.warning("Atenção: ação irreversível");
+ *
+ * // Info
+ * toast.info("Nova atualização disponível");
+ *
+ * // Loading
+ * const toastId = toast.loading("Processando...");
+ * // Depois atualizar para success
+ * toast.success("Concluído!", { id: toastId });
+ * ```
+ *
+ * ## Acessibilidade
+ *
+ * - Suporta leitores de tela
+ * - Navegação por teclado
+ * - Foco gerenciado automaticamente
+ *
+ * @see [Sonner Documentation](https://sonner.emilkowal.ski/) para mais detalhes
+ * @see [shadcn/ui Sonner](https://ui.shadcn.com/docs/components/sonner) para referência
  */
 "use client";
 import { jsx as _jsx } from "react/jsx-runtime";

package/dist/components/atoms/feedback/tooltip/tooltip.d.ts

@@ -1,9 +1,59 @@
 /**
- * Tooltip Component - Flowtomic UI
+ * # Tooltip Component
  *
- * Componente Tooltip baseado em Radix UI (padrão) ou React Aria (followMouse)
- * com seguimento do mouse e posicionamento inteligente
- * Baseado no Aceternity UI Tooltip Card para animações
+ * O componente `Tooltip` é usado para exibir informações adicionais quando o usuário
+ * passa o mouse sobre um elemento. Suporta dois modos: padrão (Radix UI) e com
+ * seguimento do mouse (React Aria).
+ *
+ * ## Características Principais
+ *
+ * - **Dois Modos**: Padrão (Radix UI) ou com seguimento do mouse (React Aria)
+ * - **Posicionamento Inteligente**: Ajusta automaticamente para não sair da viewport
+ * - **Acessível**: Suporta leitores de tela e navegação por teclado
+ * - **Animações**: Animações suaves via Framer Motion no modo followMouse
+ * - **Composição**: TooltipProvider + Tooltip + TooltipTrigger + TooltipContent
+ *
+ * ## Modos de Uso
+ *
+ * ### Modo Padrão (Radix UI)
+ *
+ * ```tsx
+ * import { TooltipProvider, Tooltip, TooltipTrigger, TooltipContent } from "@flowtomic/ui/components/atoms/feedback/tooltip";
+ *
+ * <TooltipProvider>
+ *   <Tooltip>
+ *     <TooltipTrigger asChild>
+ *       <Button>Hover me</Button>
+ *     </TooltipTrigger>
+ *     <TooltipContent>
+ *       <p>Informação do tooltip</p>
+ *     </TooltipContent>
+ *   </Tooltip>
+ * </TooltipProvider>
+ * ```
+ *
+ * ### Modo com Seguimento do Mouse
+ *
+ * ```tsx
+ * import { TooltipWithMouseFollow } from "@flowtomic/ui/components/atoms/feedback/tooltip";
+ *
+ * <TooltipWithMouseFollow
+ *   content={<p>Este tooltip segue o mouse!</p>}
+ *   minWidth={240}
+ * >
+ *   <Button>Hover and move</Button>
+ * </TooltipWithMouseFollow>
+ * ```
+ *
+ * ## Acessibilidade
+ *
+ * - Suporta leitores de tela via React Aria
+ * - Navegação por teclado (Tab, Enter, Espaço)
+ * - Suporte a touch em dispositivos móveis
+ * - Posicionamento inteligente para não sair da viewport
+ *
+ * @see [Radix UI Tooltip](https://www.radix-ui.com/primitives/docs/components/tooltip) para mais detalhes
+ * @see [React Aria Tooltip](https://react-spectrum.adobe.com/react-aria/useTooltip.html) para mais detalhes
  */
 import * as TooltipPrimitive from "@radix-ui/react-tooltip";
 import * as React from "react";

package/dist/components/atoms/feedback/tooltip/tooltip.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tooltip.d.ts","sourceRoot":"","sources":["../../../../../src/components/atoms/feedback/tooltip/tooltip.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,gBAAgB,MAAM,yBAAyB,CAAC;AAI5D,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,MAAM,MAAM,YAAY,GAAG,KAAK,CAAC,wBAAwB,CAAC,OAAO,gBAAgB,CAAC,IAAI,CAAC,CAAC;AACxF,MAAM,MAAM,mBAAmB,GAAG,KAAK,CAAC,wBAAwB,CAAC,OAAO,gBAAgB,CAAC,OAAO,CAAC,CAAC;AAClG,MAAM,MAAM,mBAAmB,GAAG,KAAK,CAAC,wBAAwB,CAC9D,OAAO,gBAAgB,CAAC,OAAO,CAChC,GAAG;IACF;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;GAEG;AACH,QAAA,MAAM,eAAe,iDAA4B,CAAC;AAGlD;;GAEG;AACH,QAAA,MAAM,OAAO,yCAAwB,CAAC;AAGtC;;GAEG;AACH,QAAA,MAAM,cAAc;0BAGM,OAAO;2CAW/B,CAAC;AAGH;;GAEG;AACH,QAAA,MAAM,aAAa,+CAA0B,CAAC;AAG9C;;GAEG;AACH,QAAA,MAAM,cAAc;IArDlB;;;OAGG;kBACW,OAAO;IACrB;;;OAGG;eACQ,MAAM;wCA6EjB,CAAC;AAmBH;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,EACrC,OAAO,EACP,QAAQ,EACR,kBAAkB,EAClB,SAAS,EACT,QAAc,GACf,EAAE;IACD,OAAO,EAAE,MAAM,GAAG,KAAK,CAAC,SAAS,CAAC;IAClC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,2CA0NA;AAED,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,eAAe,EAAE,aAAa,EAAE,CAAC"}
+{"version":3,"file":"tooltip.d.ts","sourceRoot":"","sources":["../../../../../src/components/atoms/feedback/tooltip/tooltip.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDG;AAIH,OAAO,KAAK,gBAAgB,MAAM,yBAAyB,CAAC;AAI5D,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,MAAM,MAAM,YAAY,GAAG,KAAK,CAAC,wBAAwB,CAAC,OAAO,gBAAgB,CAAC,IAAI,CAAC,CAAC;AACxF,MAAM,MAAM,mBAAmB,GAAG,KAAK,CAAC,wBAAwB,CAAC,OAAO,gBAAgB,CAAC,OAAO,CAAC,CAAC;AAClG,MAAM,MAAM,mBAAmB,GAAG,KAAK,CAAC,wBAAwB,CAC9D,OAAO,gBAAgB,CAAC,OAAO,CAChC,GAAG;IACF;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;GAEG;AACH,QAAA,MAAM,eAAe,iDAA4B,CAAC;AAGlD;;GAEG;AACH,QAAA,MAAM,OAAO,yCAAwB,CAAC;AAGtC;;GAEG;AACH,QAAA,MAAM,cAAc;0BAGM,OAAO;2CAW/B,CAAC;AAGH;;GAEG;AACH,QAAA,MAAM,aAAa,+CAA0B,CAAC;AAG9C;;GAEG;AACH,QAAA,MAAM,cAAc;IArDlB;;;OAGG;kBACW,OAAO;IACrB;;;OAGG;eACQ,MAAM;wCA6EjB,CAAC;AAmBH;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,EACrC,OAAO,EACP,QAAQ,EACR,kBAAkB,EAClB,SAAS,EACT,QAAc,GACf,EAAE;IACD,OAAO,EAAE,MAAM,GAAG,KAAK,CAAC,SAAS,CAAC;IAClC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,2CAkOA;AAED,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,eAAe,EAAE,aAAa,EAAE,CAAC"}

package/dist/components/atoms/feedback/tooltip/tooltip.js

@@ -1,9 +1,59 @@
 /**
- * Tooltip Component - Flowtomic UI
+ * # Tooltip Component
  *
- * Componente Tooltip baseado em Radix UI (padrão) ou React Aria (followMouse)
- * com seguimento do mouse e posicionamento inteligente
- * Baseado no Aceternity UI Tooltip Card para animações
+ * O componente `Tooltip` é usado para exibir informações adicionais quando o usuário
+ * passa o mouse sobre um elemento. Suporta dois modos: padrão (Radix UI) e com
+ * seguimento do mouse (React Aria).
+ *
+ * ## Características Principais
+ *
+ * - **Dois Modos**: Padrão (Radix UI) ou com seguimento do mouse (React Aria)
+ * - **Posicionamento Inteligente**: Ajusta automaticamente para não sair da viewport
+ * - **Acessível**: Suporta leitores de tela e navegação por teclado
+ * - **Animações**: Animações suaves via Framer Motion no modo followMouse
+ * - **Composição**: TooltipProvider + Tooltip + TooltipTrigger + TooltipContent
+ *
+ * ## Modos de Uso
+ *
+ * ### Modo Padrão (Radix UI)
+ *
+ * ```tsx
+ * import { TooltipProvider, Tooltip, TooltipTrigger, TooltipContent } from "@flowtomic/ui/components/atoms/feedback/tooltip";
+ *
+ * <TooltipProvider>
+ *   <Tooltip>
+ *     <TooltipTrigger asChild>
+ *       <Button>Hover me</Button>
+ *     </TooltipTrigger>
+ *     <TooltipContent>
+ *       <p>Informação do tooltip</p>
+ *     </TooltipContent>
+ *   </Tooltip>
+ * </TooltipProvider>
+ * ```
+ *
+ * ### Modo com Seguimento do Mouse
+ *
+ * ```tsx
+ * import { TooltipWithMouseFollow } from "@flowtomic/ui/components/atoms/feedback/tooltip";
+ *
+ * <TooltipWithMouseFollow
+ *   content={<p>Este tooltip segue o mouse!</p>}
+ *   minWidth={240}
+ * >
+ *   <Button>Hover and move</Button>
+ * </TooltipWithMouseFollow>
+ * ```
+ *
+ * ## Acessibilidade
+ *
+ * - Suporta leitores de tela via React Aria
+ * - Navegação por teclado (Tab, Enter, Espaço)
+ * - Suporte a touch em dispositivos móveis
+ * - Posicionamento inteligente para não sair da viewport
+ *
+ * @see [Radix UI Tooltip](https://www.radix-ui.com/primitives/docs/components/tooltip) para mais detalhes
+ * @see [React Aria Tooltip](https://react-spectrum.adobe.com/react-aria/useTooltip.html) para mais detalhes
  */
 "use client";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
@@ -197,7 +247,15 @@ export function TooltipWithMouseFollow({ content, children, containerClassName,
             });
         }
     }, [isVisible, mouse.x, mouse.y, calculatePosition]);
-    return (_jsxs("div", { ref: containerRef, className: cn("relative inline-block", containerClassName), onMouseEnter: handleMouseEnter, onMouseLeave: handleMouseLeave, onMouseMove: handleMouseMove, onTouchStart: handleTouchStart, onTouchEnd: handleTouchEnd, onClick: handleClick, children: [children, _jsx(AnimatePresence, { children: isVisible && (_jsx(motion.div, { initial: { height: 0, opacity: 0 }, animate: { height, opacity: 1 }, exit: { height: 0, opacity: 0 }, transition: {
+    return (
+    // biome-ignore lint/a11y/noStaticElementInteractions: Trigger flexível
+    // biome-ignore lint/a11y/useKeyWithClickEvents: Comportamento de trigger customizado
+    _jsxs("div", { ref: containerRef, className: cn("relative inline-block", containerClassName), onMouseEnter: handleMouseEnter, onMouseLeave: handleMouseLeave, onMouseMove: handleMouseMove, onTouchStart: handleTouchStart, onTouchEnd: handleTouchEnd, onClick: handleClick, onKeyDown: (e) => {
+            if (e.key === "Enter" || e.key === " ") {
+                e.preventDefault();
+                handleClick?.(e);
+            }
+        }, children: [children, _jsx(AnimatePresence, { children: isVisible && (_jsx(motion.div, { initial: { height: 0, opacity: 0 }, animate: { height, opacity: 1 }, exit: { height: 0, opacity: 0 }, transition: {
                         type: "spring",
                         stiffness: 200,
                         damping: 20,