@flowtomic/ui 0.1.14 → 0.2.0

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

@@ -1,8 +1,56 @@
 /**
- * Dialog Component - Flowtomic UI
+ * # Dialog Component
  *
- * Componente Dialog próprio do design-system baseado em Radix UI
- * Implementação direta sem dependência de componentes externos
+ * O componente `Dialog` é usado para exibir conteúdo em uma modal overlay.
+ * É baseado em Radix UI para garantir acessibilidade completa.
+ *
+ * ## Características Principais
+ *
+ * - **Acessível**: Baseado em Radix UI com suporte completo a leitores de tela
+ * - **Composição**: Múltiplos sub-componentes para flexibilidade
+ * - **Foco Gerenciado**: Foco e navegação por teclado gerenciados automaticamente
+ * - **Overlay**: Overlay escuro por padrão
+ * - **Fechamento**: Suporta fechamento via Escape, clique no overlay ou botão de fechar
+ *
+ * ## Componentes
+ *
+ * - **Dialog**: Container principal
+ * - **DialogTrigger**: Trigger para abrir o dialog
+ * - **DialogContent**: Conteúdo do dialog
+ * - **DialogHeader**: Cabeçalho do dialog (título e descrição)
+ * - **DialogFooter**: Rodapé do dialog (botões de ação)
+ * - **DialogTitle**: Título do dialog
+ * - **DialogDescription**: Descrição do dialog
+ * - **DialogClose**: Botão de fechar
+ *
+ * ## Uso Básico
+ *
+ * ```tsx
+ * import { Dialog, DialogTrigger, DialogContent, DialogHeader, DialogTitle } from "@flowtomic/ui/components/atoms/feedback/dialog";
+ *
+ * function MyComponent() {
+ *   return (
+ *     <Dialog>
+ *       <DialogTrigger>Open Dialog</DialogTrigger>
+ *       <DialogContent>
+ *         <DialogHeader>
+ *           <DialogTitle>Title</DialogTitle>
+ *         </DialogHeader>
+ *       </DialogContent>
+ *     </Dialog>
+ *   );
+ * }
+ * ```
+ *
+ * ## 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 DialogPrimitive from "@radix-ui/react-dialog";
 import * as React from "react";
@@ -14,23 +62,33 @@ export type DialogFooterProps = React.HTMLAttributes<HTMLDivElement>;
 export type DialogTitleProps = React.ComponentPropsWithoutRef<typeof DialogPrimitive.Title>;
 export type DialogDescriptionProps = React.ComponentPropsWithoutRef<typeof DialogPrimitive.Description>;
 /**
- * Dialog - Container principal do dialog
+ * Dialog - Container principal do dialog.
+ *
+ * Componente usado para gerenciar o estado do dialog.
  */
 declare const Dialog: React.FC<DialogPrimitive.DialogProps>;
 /**
- * DialogTrigger - Trigger do dialog
+ * DialogTrigger - Trigger do dialog.
+ *
+ * Componente usado como trigger para abrir o dialog.
  */
 declare const DialogTrigger: React.ForwardRefExoticComponent<DialogPrimitive.DialogTriggerProps & React.RefAttributes<HTMLButtonElement>>;
 /**
- * DialogPortal - Portal do dialog
+ * DialogPortal - Portal do dialog.
+ *
+ * Componente usado para renderizar o dialog em um portal.
  */
 declare const DialogPortal: React.FC<DialogPrimitive.DialogPortalProps>;
 /**
- * DialogClose - Botão de fechar do dialog
+ * DialogClose - Botão de fechar do dialog.
+ *
+ * Componente usado para fechar o dialog.
  */
 declare const DialogClose: React.ForwardRefExoticComponent<DialogPrimitive.DialogCloseProps & React.RefAttributes<HTMLButtonElement>>;
 /**
- * DialogOverlay - Overlay do dialog
+ * DialogOverlay - Overlay do dialog.
+ *
+ * Componente usado para exibir o overlay escuro atrás do dialog.
  */
 declare const DialogOverlay: React.ForwardRefExoticComponent<Omit<DialogPrimitive.DialogOverlayProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"dialog.d.ts","sourceRoot":"","sources":["../../../../../src/components/atoms/feedback/dialog/dialog.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,eAAe,MAAM,wBAAwB,CAAC;AAE1D,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,MAAM,MAAM,WAAW,GAAG,KAAK,CAAC,wBAAwB,CAAC,OAAO,eAAe,CAAC,IAAI,CAAC,CAAC;AACtF,MAAM,MAAM,kBAAkB,GAAG,KAAK,CAAC,wBAAwB,CAAC,OAAO,eAAe,CAAC,OAAO,CAAC,CAAC;AAChG,MAAM,MAAM,kBAAkB,GAAG,KAAK,CAAC,wBAAwB,CAAC,OAAO,eAAe,CAAC,OAAO,CAAC,CAAC;AAChG,MAAM,MAAM,iBAAiB,GAAG,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,CAAC;AACrE,MAAM,MAAM,iBAAiB,GAAG,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,CAAC;AACrE,MAAM,MAAM,gBAAgB,GAAG,KAAK,CAAC,wBAAwB,CAAC,OAAO,eAAe,CAAC,KAAK,CAAC,CAAC;AAC5F,MAAM,MAAM,sBAAsB,GAAG,KAAK,CAAC,wBAAwB,CACjE,OAAO,eAAe,CAAC,WAAW,CACnC,CAAC;AAEF;;GAEG;AACH,QAAA,MAAM,MAAM,uCAAuB,CAAC;AAGpC;;GAEG;AACH,QAAA,MAAM,aAAa,8GAA0B,CAAC;AAG9C;;GAEG;AACH,QAAA,MAAM,YAAY,6CAAyB,CAAC;AAG5C;;GAEG;AACH,QAAA,MAAM,WAAW,4GAAwB,CAAC;AAG1C;;GAEG;AACH,QAAA,MAAM,aAAa,8JAYjB,CAAC;AAGH;;GAEG;AACH,QAAA,MAAM,aAAa,8JAqBjB,CAAC;AAGH;;GAEG;AACH,QAAA,MAAM,YAAY;8BAA6B,iBAAiB;;CAE/D,CAAC;AAGF;;GAEG;AACH,QAAA,MAAM,YAAY;8BAA6B,iBAAiB;;CAK/D,CAAC;AAGF;;GAEG;AACH,QAAA,MAAM,WAAW,oKASf,CAAC;AAGH;;GAEG;AACH,QAAA,MAAM,iBAAiB,8KASrB,CAAC;AAGH,OAAO,EACL,MAAM,EACN,YAAY,EACZ,aAAa,EACb,aAAa,EACb,WAAW,EACX,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,iBAAiB,GAClB,CAAC"}
+{"version":3,"file":"dialog.d.ts","sourceRoot":"","sources":["../../../../../src/components/atoms/feedback/dialog/dialog.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AAEH,OAAO,KAAK,eAAe,MAAM,wBAAwB,CAAC;AAE1D,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,MAAM,MAAM,WAAW,GAAG,KAAK,CAAC,wBAAwB,CAAC,OAAO,eAAe,CAAC,IAAI,CAAC,CAAC;AACtF,MAAM,MAAM,kBAAkB,GAAG,KAAK,CAAC,wBAAwB,CAAC,OAAO,eAAe,CAAC,OAAO,CAAC,CAAC;AAChG,MAAM,MAAM,kBAAkB,GAAG,KAAK,CAAC,wBAAwB,CAAC,OAAO,eAAe,CAAC,OAAO,CAAC,CAAC;AAChG,MAAM,MAAM,iBAAiB,GAAG,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,CAAC;AACrE,MAAM,MAAM,iBAAiB,GAAG,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,CAAC;AACrE,MAAM,MAAM,gBAAgB,GAAG,KAAK,CAAC,wBAAwB,CAAC,OAAO,eAAe,CAAC,KAAK,CAAC,CAAC;AAC5F,MAAM,MAAM,sBAAsB,GAAG,KAAK,CAAC,wBAAwB,CACjE,OAAO,eAAe,CAAC,WAAW,CACnC,CAAC;AAEF;;;;GAIG;AACH,QAAA,MAAM,MAAM,uCAAuB,CAAC;AAGpC;;;;GAIG;AACH,QAAA,MAAM,aAAa,8GAA0B,CAAC;AAG9C;;;;GAIG;AACH,QAAA,MAAM,YAAY,6CAAyB,CAAC;AAG5C;;;;GAIG;AACH,QAAA,MAAM,WAAW,4GAAwB,CAAC;AAG1C;;;;GAIG;AACH,QAAA,MAAM,aAAa,8JAYjB,CAAC;AAGH;;GAEG;AACH,QAAA,MAAM,aAAa,8JAqBjB,CAAC;AAGH;;GAEG;AACH,QAAA,MAAM,YAAY;8BAA6B,iBAAiB;;CAE/D,CAAC;AAGF;;GAEG;AACH,QAAA,MAAM,YAAY;8BAA6B,iBAAiB;;CAK/D,CAAC;AAGF;;GAEG;AACH,QAAA,MAAM,WAAW,oKASf,CAAC;AAGH;;GAEG;AACH,QAAA,MAAM,iBAAiB,8KASrB,CAAC;AAGH,OAAO,EACL,MAAM,EACN,YAAY,EACZ,aAAa,EACb,aAAa,EACb,WAAW,EACX,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,iBAAiB,GAClB,CAAC"}

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

@@ -1,36 +1,94 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 /**
- * Dialog Component - Flowtomic UI
+ * # Dialog Component
  *
- * Componente Dialog próprio do design-system baseado em Radix UI
- * Implementação direta sem dependência de componentes externos
+ * O componente `Dialog` é usado para exibir conteúdo em uma modal overlay.
+ * É baseado em Radix UI para garantir acessibilidade completa.
+ *
+ * ## Características Principais
+ *
+ * - **Acessível**: Baseado em Radix UI com suporte completo a leitores de tela
+ * - **Composição**: Múltiplos sub-componentes para flexibilidade
+ * - **Foco Gerenciado**: Foco e navegação por teclado gerenciados automaticamente
+ * - **Overlay**: Overlay escuro por padrão
+ * - **Fechamento**: Suporta fechamento via Escape, clique no overlay ou botão de fechar
+ *
+ * ## Componentes
+ *
+ * - **Dialog**: Container principal
+ * - **DialogTrigger**: Trigger para abrir o dialog
+ * - **DialogContent**: Conteúdo do dialog
+ * - **DialogHeader**: Cabeçalho do dialog (título e descrição)
+ * - **DialogFooter**: Rodapé do dialog (botões de ação)
+ * - **DialogTitle**: Título do dialog
+ * - **DialogDescription**: Descrição do dialog
+ * - **DialogClose**: Botão de fechar
+ *
+ * ## Uso Básico
+ *
+ * ```tsx
+ * import { Dialog, DialogTrigger, DialogContent, DialogHeader, DialogTitle } from "@flowtomic/ui/components/atoms/feedback/dialog";
+ *
+ * function MyComponent() {
+ *   return (
+ *     <Dialog>
+ *       <DialogTrigger>Open Dialog</DialogTrigger>
+ *       <DialogContent>
+ *         <DialogHeader>
+ *           <DialogTitle>Title</DialogTitle>
+ *         </DialogHeader>
+ *       </DialogContent>
+ *     </Dialog>
+ *   );
+ * }
+ * ```
+ *
+ * ## 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 DialogPrimitive from "@radix-ui/react-dialog";
 import { X } from "lucide-react";
 import * as React from "react";
 import { cn } from "@/lib/utils";
 /**
- * Dialog - Container principal do dialog
+ * Dialog - Container principal do dialog.
+ *
+ * Componente usado para gerenciar o estado do dialog.
  */
 const Dialog = DialogPrimitive.Root;
 Dialog.displayName = "Dialog";
 /**
- * DialogTrigger - Trigger do dialog
+ * DialogTrigger - Trigger do dialog.
+ *
+ * Componente usado como trigger para abrir o dialog.
  */
 const DialogTrigger = DialogPrimitive.Trigger;
 DialogTrigger.displayName = "DialogTrigger";
 /**
- * DialogPortal - Portal do dialog
+ * DialogPortal - Portal do dialog.
+ *
+ * Componente usado para renderizar o dialog em um portal.
  */
 const DialogPortal = DialogPrimitive.Portal;
 DialogPortal.displayName = "DialogPortal";
 /**
- * DialogClose - Botão de fechar do dialog
+ * DialogClose - Botão de fechar do dialog.
+ *
+ * Componente usado para fechar o dialog.
  */
 const DialogClose = DialogPrimitive.Close;
 DialogClose.displayName = "DialogClose";
 /**
- * DialogOverlay - Overlay do dialog
+ * DialogOverlay - Overlay do dialog.
+ *
+ * Componente usado para exibir o overlay escuro atrás do dialog.
  */
 const DialogOverlay = React.forwardRef(({ className, ...props }, ref) => (_jsx(DialogPrimitive.Overlay, { ref: ref, className: cn("fixed inset-0 z-50 bg-black/80 data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0", className), ...props })));
 DialogOverlay.displayName = DialogPrimitive.Overlay.displayName;

package/dist/components/atoms/feedback/hover-card/hover-card.d.ts

@@ -1,7 +1,41 @@
 /**
- * HoverCard Component - Flowtomic UI
+ * # HoverCard Component
  *
- * Componente HoverCard baseado em Radix UI
+ * O componente `HoverCard` é usado para exibir conteúdo flutuante quando o usuário
+ * passa o mouse sobre um elemento. É baseado em Radix UI para garantir acessibilidade completa.
+ *
+ * ## Características Principais
+ *
+ * - **Acessível**: Baseado em Radix UI com suporte completo a leitores de tela
+ * - **Hover**: Abre automaticamente ao passar o mouse
+ * - **Composição**: HoverCard + HoverCardTrigger + HoverCardContent para flexibilidade
+ * - **Foco Gerenciado**: Foco e navegação por teclado gerenciados automaticamente
+ *
+ * ## Uso Básico
+ *
+ * ```tsx
+ * import { HoverCard, HoverCardTrigger, HoverCardContent } from "@flowtomic/ui/components/atoms/feedback/hover-card";
+ *
+ * function MyComponent() {
+ *   return (
+ *     <HoverCard>
+ *       <HoverCardTrigger>Hover me</HoverCardTrigger>
+ *       <HoverCardContent>
+ *         <p>Conteúdo do hover card</p>
+ *       </HoverCardContent>
+ *     </HoverCard>
+ *   );
+ * }
+ * ```
+ *
+ * ## Acessibilidade
+ *
+ * - Suporta navegação por teclado (Tab, Enter, Espaço)
+ * - Segue padrões WAI-ARIA via Radix UI
+ * - Suporta leitores de tela
+ * - Foco gerenciado automaticamente
+ *
+ * @see [Radix UI Hover Card](https://www.radix-ui.com/primitives/docs/components/hover-card) para mais detalhes
  */
 import * as HoverCardPrimitive from "@radix-ui/react-hover-card";
 import * as React from "react";
@@ -9,15 +43,21 @@ export type HoverCardProps = React.ComponentPropsWithoutRef<typeof HoverCardPrim
 export type HoverCardTriggerProps = React.ComponentPropsWithoutRef<typeof HoverCardPrimitive.Trigger>;
 export type HoverCardContentProps = React.ComponentPropsWithoutRef<typeof HoverCardPrimitive.Content>;
 /**
- * HoverCard - Container principal do hover card
+ * HoverCard - Container principal do hover card.
+ *
+ * Componente usado para gerenciar o estado do hover card.
  */
 declare const HoverCard: React.FC<HoverCardPrimitive.HoverCardProps>;
 /**
- * HoverCardTrigger - Trigger do hover card
+ * HoverCardTrigger - Trigger do hover card.
+ *
+ * Componente usado como trigger para abrir o hover card ao passar o mouse.
  */
 declare const HoverCardTrigger: React.ForwardRefExoticComponent<HoverCardPrimitive.HoverCardTriggerProps & React.RefAttributes<HTMLAnchorElement>>;
 /**
- * HoverCardContent - Conteúdo do hover card
+ * HoverCardContent - Conteúdo do hover card.
+ *
+ * Componente usado para exibir o conteúdo do hover card.
  */
 declare const HoverCardContent: React.ForwardRefExoticComponent<Omit<HoverCardPrimitive.HoverCardContentProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
 export { HoverCard, HoverCardTrigger, HoverCardContent };

package/dist/components/atoms/feedback/hover-card/hover-card.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hover-card.d.ts","sourceRoot":"","sources":["../../../../../src/components/atoms/feedback/hover-card/hover-card.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,kBAAkB,MAAM,4BAA4B,CAAC;AACjE,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,MAAM,MAAM,cAAc,GAAG,KAAK,CAAC,wBAAwB,CAAC,OAAO,kBAAkB,CAAC,IAAI,CAAC,CAAC;AAC5F,MAAM,MAAM,qBAAqB,GAAG,KAAK,CAAC,wBAAwB,CAChE,OAAO,kBAAkB,CAAC,OAAO,CAClC,CAAC;AACF,MAAM,MAAM,qBAAqB,GAAG,KAAK,CAAC,wBAAwB,CAChE,OAAO,kBAAkB,CAAC,OAAO,CAClC,CAAC;AAEF;;GAEG;AACH,QAAA,MAAM,SAAS,6CAA0B,CAAC;AAG1C;;GAEG;AACH,QAAA,MAAM,gBAAgB,oHAA6B,CAAC;AAGpD;;GAEG;AACH,QAAA,MAAM,gBAAgB,oKAcpB,CAAC;AAGH,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,CAAC"}
+{"version":3,"file":"hover-card.d.ts","sourceRoot":"","sources":["../../../../../src/components/atoms/feedback/hover-card/hover-card.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAEH,OAAO,KAAK,kBAAkB,MAAM,4BAA4B,CAAC;AACjE,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,MAAM,MAAM,cAAc,GAAG,KAAK,CAAC,wBAAwB,CAAC,OAAO,kBAAkB,CAAC,IAAI,CAAC,CAAC;AAC5F,MAAM,MAAM,qBAAqB,GAAG,KAAK,CAAC,wBAAwB,CAChE,OAAO,kBAAkB,CAAC,OAAO,CAClC,CAAC;AACF,MAAM,MAAM,qBAAqB,GAAG,KAAK,CAAC,wBAAwB,CAChE,OAAO,kBAAkB,CAAC,OAAO,CAClC,CAAC;AAEF;;;;GAIG;AACH,QAAA,MAAM,SAAS,6CAA0B,CAAC;AAG1C;;;;GAIG;AACH,QAAA,MAAM,gBAAgB,oHAA6B,CAAC;AAGpD;;;;GAIG;AACH,QAAA,MAAM,gBAAgB,oKAcpB,CAAC;AAGH,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/components/atoms/feedback/hover-card/hover-card.js

@@ -1,24 +1,64 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 /**
- * HoverCard Component - Flowtomic UI
+ * # HoverCard Component
  *
- * Componente HoverCard baseado em Radix UI
+ * O componente `HoverCard` é usado para exibir conteúdo flutuante quando o usuário
+ * passa o mouse sobre um elemento. É baseado em Radix UI para garantir acessibilidade completa.
+ *
+ * ## Características Principais
+ *
+ * - **Acessível**: Baseado em Radix UI com suporte completo a leitores de tela
+ * - **Hover**: Abre automaticamente ao passar o mouse
+ * - **Composição**: HoverCard + HoverCardTrigger + HoverCardContent para flexibilidade
+ * - **Foco Gerenciado**: Foco e navegação por teclado gerenciados automaticamente
+ *
+ * ## Uso Básico
+ *
+ * ```tsx
+ * import { HoverCard, HoverCardTrigger, HoverCardContent } from "@flowtomic/ui/components/atoms/feedback/hover-card";
+ *
+ * function MyComponent() {
+ *   return (
+ *     <HoverCard>
+ *       <HoverCardTrigger>Hover me</HoverCardTrigger>
+ *       <HoverCardContent>
+ *         <p>Conteúdo do hover card</p>
+ *       </HoverCardContent>
+ *     </HoverCard>
+ *   );
+ * }
+ * ```
+ *
+ * ## Acessibilidade
+ *
+ * - Suporta navegação por teclado (Tab, Enter, Espaço)
+ * - Segue padrões WAI-ARIA via Radix UI
+ * - Suporta leitores de tela
+ * - Foco gerenciado automaticamente
+ *
+ * @see [Radix UI Hover Card](https://www.radix-ui.com/primitives/docs/components/hover-card) para mais detalhes
  */
 import * as HoverCardPrimitive from "@radix-ui/react-hover-card";
 import * as React from "react";
 import { cn } from "@/lib/utils";
 /**
- * HoverCard - Container principal do hover card
+ * HoverCard - Container principal do hover card.
+ *
+ * Componente usado para gerenciar o estado do hover card.
  */
 const HoverCard = HoverCardPrimitive.Root;
 HoverCard.displayName = "HoverCard";
 /**
- * HoverCardTrigger - Trigger do hover card
+ * HoverCardTrigger - Trigger do hover card.
+ *
+ * Componente usado como trigger para abrir o hover card ao passar o mouse.
  */
 const HoverCardTrigger = HoverCardPrimitive.Trigger;
 HoverCardTrigger.displayName = "HoverCardTrigger";
 /**
- * HoverCardContent - Conteúdo do hover card
+ * HoverCardContent - Conteúdo do hover card.
+ *
+ * Componente usado para exibir o conteúdo do hover card.
  */
 const HoverCardContent = React.forwardRef(({ className, align = "center", sideOffset = 4, ...props }, ref) => (_jsx(HoverCardPrimitive.Content, { ref: ref, align: align, sideOffset: sideOffset, className: cn("z-50 w-64 rounded-md border bg-popover p-4 text-popover-foreground shadow-md outline-none 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", className), ...props })));
 HoverCardContent.displayName = HoverCardPrimitive.Content.displayName;

package/dist/components/atoms/feedback/inline-citation/inline-citation.d.ts

@@ -1,7 +1,58 @@
 /**
- * InlineCitation Component - Flowtomic UI
+ * # InlineCitation Component
  *
- * Componente de citação inline com hover card
+ * O componente `InlineCitation` é usado para exibir citações inline com hover card
+ * que mostra informações detalhadas sobre as fontes. É útil para documentos acadêmicos,
+ * artigos e conteúdo que requer referências.
+ *
+ * ## Características Principais
+ *
+ * - **Hover Card**: Exibe informações detalhadas ao passar o mouse
+ * - **Múltiplas Fontes**: Suporta múltiplas fontes com badge
+ * - **Composição**: Múltiplos sub-componentes para flexibilidade
+ * - **Acessível**: Baseado em HoverCard (Radix UI) para acessibilidade
+ *
+ * ## Componentes
+ *
+ * - **InlineCitation**: Container principal
+ * - **InlineCitationText**: Texto da citação
+ * - **InlineCitationCard**: Card com hover (wrapper do HoverCard)
+ * - **InlineCitationCardTrigger**: Trigger com badge mostrando fonte
+ * - **InlineCitationCardBody**: Corpo do card
+ * - **InlineCitationSource**: Fonte individual com título, URL e descrição
+ * - **InlineCitationQuote**: Citação em formato blockquote
+ *
+ * ## Uso Básico
+ *
+ * ```tsx
+ * import { InlineCitation, InlineCitationText, InlineCitationCard, InlineCitationCardTrigger, InlineCitationCardBody, InlineCitationSource } from "@flowtomic/ui/components/atoms/feedback/inline-citation";
+ *
+ * function MyComponent() {
+ *   return (
+ *     <InlineCitation>
+ *       <InlineCitationText>Texto com citação</InlineCitationText>
+ *       <InlineCitationCard>
+ *         <InlineCitationCardTrigger sources={["https://example.com"]} />
+ *         <InlineCitationCardBody>
+ *           <InlineCitationSource
+ *             title="Título da Fonte"
+ *             url="https://example.com"
+ *             description="Descrição da fonte"
+ *           />
+ *         </InlineCitationCardBody>
+ *       </InlineCitationCard>
+ *     </InlineCitation>
+ *   );
+ * }
+ * ```
+ *
+ * ## Acessibilidade
+ *
+ * - Baseado em HoverCard (Radix UI) para acessibilidade
+ * - Suporta leitores de tela
+ * - Navegação por teclado
+ *
+ * @see [HoverCard Component](../hover-card/hover-card.tsx) para mais detalhes sobre o hover card
  */
 import * as React from "react";
 import { Badge } from "../../actions/badge";

package/dist/components/atoms/feedback/inline-citation/inline-citation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"inline-citation.d.ts","sourceRoot":"","sources":["../../../../../src/components/atoms/feedback/inline-citation/inline-citation.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAsC,MAAM,eAAe,CAAC;AAE9E,MAAM,MAAM,mBAAmB,GAAG,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;AAE/D,eAAO,MAAM,cAAc,sKAI1B,CAAC;AAGF,MAAM,MAAM,uBAAuB,GAAG,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;AAEnE,eAAO,MAAM,kBAAkB,sKAQ9B,CAAC;AAGF,MAAM,MAAM,uBAAuB,GAAG,KAAK,CAAC,cAAc,CAAC,OAAO,SAAS,CAAC,CAAC;AAE7E,eAAO,MAAM,kBAAkB;YAAW,uBAAuB;;CAEhE,CAAC;AAGF,MAAM,MAAM,8BAA8B,GAAG,KAAK,CAAC,cAAc,CAAC,OAAO,KAAK,CAAC,GAAG;IAChF,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC;AAEF,eAAO,MAAM,yBAAyB,oHAepC,CAAC;AAGH,MAAM,MAAM,2BAA2B,GAAG,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;AAEtE,eAAO,MAAM,sBAAsB,mKAIlC,CAAC;AAGF,MAAM,MAAM,yBAAyB,GAAG,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,GAAG;IACpE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,eAAO,MAAM,oBAAoB,+GAWhC,CAAC;AAGF,MAAM,MAAM,wBAAwB,GAAG,KAAK,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC;AAE1E,eAAO,MAAM,mBAAmB,mLAU/B,CAAC"}
+{"version":3,"file":"inline-citation.d.ts","sourceRoot":"","sources":["../../../../../src/components/atoms/feedback/inline-citation/inline-citation.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuDG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAsC,MAAM,eAAe,CAAC;AAE9E,MAAM,MAAM,mBAAmB,GAAG,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;AAE/D,eAAO,MAAM,cAAc,sKAI1B,CAAC;AAGF,MAAM,MAAM,uBAAuB,GAAG,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;AAEnE,eAAO,MAAM,kBAAkB,sKAQ9B,CAAC;AAGF,MAAM,MAAM,uBAAuB,GAAG,KAAK,CAAC,cAAc,CAAC,OAAO,SAAS,CAAC,CAAC;AAE7E,eAAO,MAAM,kBAAkB;YAAW,uBAAuB;;CAEhE,CAAC;AAGF,MAAM,MAAM,8BAA8B,GAAG,KAAK,CAAC,cAAc,CAAC,OAAO,KAAK,CAAC,GAAG;IAChF,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC;AAEF,eAAO,MAAM,yBAAyB,oHAepC,CAAC;AAGH,MAAM,MAAM,2BAA2B,GAAG,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;AAEtE,eAAO,MAAM,sBAAsB,mKAIlC,CAAC;AAGF,MAAM,MAAM,yBAAyB,GAAG,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,GAAG;IACpE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,eAAO,MAAM,oBAAoB,+GAWhC,CAAC;AAGF,MAAM,MAAM,wBAAwB,GAAG,KAAK,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC;AAE1E,eAAO,MAAM,mBAAmB,mLAU/B,CAAC"}

package/dist/components/atoms/feedback/inline-citation/inline-citation.js

@@ -1,8 +1,59 @@
 import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
 /**
- * InlineCitation Component - Flowtomic UI
+ * # InlineCitation Component
  *
- * Componente de citação inline com hover card
+ * O componente `InlineCitation` é usado para exibir citações inline com hover card
+ * que mostra informações detalhadas sobre as fontes. É útil para documentos acadêmicos,
+ * artigos e conteúdo que requer referências.
+ *
+ * ## Características Principais
+ *
+ * - **Hover Card**: Exibe informações detalhadas ao passar o mouse
+ * - **Múltiplas Fontes**: Suporta múltiplas fontes com badge
+ * - **Composição**: Múltiplos sub-componentes para flexibilidade
+ * - **Acessível**: Baseado em HoverCard (Radix UI) para acessibilidade
+ *
+ * ## Componentes
+ *
+ * - **InlineCitation**: Container principal
+ * - **InlineCitationText**: Texto da citação
+ * - **InlineCitationCard**: Card com hover (wrapper do HoverCard)
+ * - **InlineCitationCardTrigger**: Trigger com badge mostrando fonte
+ * - **InlineCitationCardBody**: Corpo do card
+ * - **InlineCitationSource**: Fonte individual com título, URL e descrição
+ * - **InlineCitationQuote**: Citação em formato blockquote
+ *
+ * ## Uso Básico
+ *
+ * ```tsx
+ * import { InlineCitation, InlineCitationText, InlineCitationCard, InlineCitationCardTrigger, InlineCitationCardBody, InlineCitationSource } from "@flowtomic/ui/components/atoms/feedback/inline-citation";
+ *
+ * function MyComponent() {
+ *   return (
+ *     <InlineCitation>
+ *       <InlineCitationText>Texto com citação</InlineCitationText>
+ *       <InlineCitationCard>
+ *         <InlineCitationCardTrigger sources={["https://example.com"]} />
+ *         <InlineCitationCardBody>
+ *           <InlineCitationSource
+ *             title="Título da Fonte"
+ *             url="https://example.com"
+ *             description="Descrição da fonte"
+ *           />
+ *         </InlineCitationCardBody>
+ *       </InlineCitationCard>
+ *     </InlineCitation>
+ *   );
+ * }
+ * ```
+ *
+ * ## Acessibilidade
+ *
+ * - Baseado em HoverCard (Radix UI) para acessibilidade
+ * - Suporta leitores de tela
+ * - Navegação por teclado
+ *
+ * @see [HoverCard Component](../hover-card/hover-card.tsx) para mais detalhes sobre o hover card
  */
 import * as React from "react";
 import { cn } from "@/lib/utils";

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

@@ -1,21 +1,99 @@
+/**
+ * # 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 type * as React from "react";
+/**
+ * Props do componente Popover.
+ */
 export interface PopoverProps extends React.ComponentProps<typeof PopoverPrimitive.Root> {
 }
+/**
+ * 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
+ */
 declare function Popover({ ...props }: PopoverProps): import("react/jsx-runtime").JSX.Element;
 declare namespace Popover {
     var displayName: string;
 }
+/**
+ * Props do componente PopoverTrigger.
+ */
 export interface PopoverTriggerProps extends React.ComponentProps<typeof PopoverPrimitive.Trigger> {
 }
+/**
+ * PopoverTrigger - Trigger do popover.
+ *
+ * Componente usado como trigger para abrir o popover.
+ *
+ * @param {PopoverTriggerProps} props - Props do componente
+ * @returns {JSX.Element} Componente PopoverTrigger
+ */
 declare function PopoverTrigger({ ...props }: PopoverTriggerProps): import("react/jsx-runtime").JSX.Element;
 declare namespace PopoverTrigger {
     var displayName: string;
 }
+/**
+ * Props do componente PopoverContent.
+ *
+ * @property {'start' | 'center' | 'end'} [align='center'] - Alinhamento do popover
+ * @property {number} [sideOffset=4] - Offset em pixels do lado do popover
+ */
 export interface PopoverContentProps extends React.ComponentProps<typeof PopoverPrimitive.Content> {
+    /** Alinhamento do popover */
     align?: "start" | "center" | "end";
+    /** Offset em pixels do lado do popover */
     sideOffset?: number;
 }
+/**
+ * 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
+ */
 declare function PopoverContent({ className, align, sideOffset, ...props }: PopoverContentProps): import("react/jsx-runtime").JSX.Element;
 declare namespace PopoverContent {
     var displayName: string;

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

@@ -1 +1 @@
-{"version":3,"file":"popover.d.ts","sourceRoot":"","sources":["../../../../../src/components/atoms/feedback/popover/popover.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,gBAAgB,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AAGpC,MAAM,WAAW,YAAa,SAAQ,KAAK,CAAC,cAAc,CAAC,OAAO,gBAAgB,CAAC,IAAI,CAAC;CAAG;AAE3F,iBAAS,OAAO,CAAC,EAAE,GAAG,KAAK,EAAE,EAAE,YAAY,2CAE1C;kBAFQ,OAAO;;;AAMhB,MAAM,WAAW,mBACf,SAAQ,KAAK,CAAC,cAAc,CAAC,OAAO,gBAAgB,CAAC,OAAO,CAAC;CAAG;AAElE,iBAAS,cAAc,CAAC,EAAE,GAAG,KAAK,EAAE,EAAE,mBAAmB,2CAExD;kBAFQ,cAAc;;;AAMvB,MAAM,WAAW,mBAAoB,SAAQ,KAAK,CAAC,cAAc,CAAC,OAAO,gBAAgB,CAAC,OAAO,CAAC;IAChG,KAAK,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,iBAAS,cAAc,CAAC,EACtB,SAAS,EACT,KAAgB,EAChB,UAAc,EACd,GAAG,KAAK,EACT,EAAE,mBAAmB,2CAerB;kBApBQ,cAAc;;;AAwBvB,MAAM,WAAW,kBAAmB,SAAQ,KAAK,CAAC,cAAc,CAAC,OAAO,gBAAgB,CAAC,MAAM,CAAC;CAAG;AAEnG,iBAAS,aAAa,CAAC,EAAE,GAAG,KAAK,EAAE,EAAE,kBAAkB,2CAEtD;kBAFQ,aAAa;;;AAMtB,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,aAAa,EAAE,CAAC"}
+{"version":3,"file":"popover.d.ts","sourceRoot":"","sources":["../../../../../src/components/atoms/feedback/popover/popover.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAEH,OAAO,KAAK,gBAAgB,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AAGpC;;GAEG;AACH,MAAM,WAAW,YAAa,SAAQ,KAAK,CAAC,cAAc,CAAC,OAAO,gBAAgB,CAAC,IAAI,CAAC;CAAG;AAE3F;;;;;;;GAOG;AACH,iBAAS,OAAO,CAAC,EAAE,GAAG,KAAK,EAAE,EAAE,YAAY,2CAE1C;kBAFQ,OAAO;;;AAMhB;;GAEG;AACH,MAAM,WAAW,mBACf,SAAQ,KAAK,CAAC,cAAc,CAAC,OAAO,gBAAgB,CAAC,OAAO,CAAC;CAAG;AAElE;;;;;;;GAOG;AACH,iBAAS,cAAc,CAAC,EAAE,GAAG,KAAK,EAAE,EAAE,mBAAmB,2CAExD;kBAFQ,cAAc;;;AAMvB;;;;;GAKG;AACH,MAAM,WAAW,mBAAoB,SAAQ,KAAK,CAAC,cAAc,CAAC,OAAO,gBAAgB,CAAC,OAAO,CAAC;IAChG,6BAA6B;IAC7B,KAAK,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;IACnC,0CAA0C;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,iBAAS,cAAc,CAAC,EACtB,SAAS,EACT,KAAgB,EAChB,UAAc,EACd,GAAG,KAAK,EACT,EAAE,mBAAmB,2CAerB;kBApBQ,cAAc;;;AAwBvB,MAAM,WAAW,kBAAmB,SAAQ,KAAK,CAAC,cAAc,CAAC,OAAO,gBAAgB,CAAC,MAAM,CAAC;CAAG;AAEnG,iBAAS,aAAa,CAAC,EAAE,GAAG,KAAK,EAAE,EAAE,kBAAkB,2CAEtD;kBAFQ,aAAa;;;AAMtB,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,aAAa,EAAE,CAAC"}