analytica-frontend-lib 1.0.27 → 1.0.28

package/dist/index.d.mts

@@ -1,507 +1,18 @@
-import * as react_jsx_runtime from 'react/jsx-runtime';
-import * as react from 'react';
-import react__default, { ElementType, ReactNode, ComponentPropsWithoutRef, ButtonHTMLAttributes, HTMLAttributes, InputHTMLAttributes } from 'react';
-import * as zustand from 'zustand';
-
-/**
- * Base text component props
- */
-type BaseTextProps = {
-    /** Content to be displayed */
-    children?: ReactNode;
-    /** Text size variant */
-    size?: '2xs' | 'xs' | 'sm' | 'md' | 'lg' | 'xl' | '2xl' | '3xl' | '4xl' | '5xl' | '6xl';
-    /** Font weight variant */
-    weight?: 'hairline' | 'light' | 'normal' | 'medium' | 'semibold' | 'bold' | 'extrabold' | 'black';
-    /** Color variant - white for light backgrounds, black for dark backgrounds */
-    color?: string;
-    /** Additional CSS classes to apply */
-    className?: string;
-};
-/**
- * Polymorphic text component props that ensures type safety based on the 'as' prop
- */
-type TextProps<T extends ElementType = 'p'> = BaseTextProps & {
-    /** HTML tag to render */
-    as?: T;
-} & Omit<ComponentPropsWithoutRef<T>, keyof BaseTextProps>;
-/**
- * Text component for Analytica Ensino platforms
- *
- * A flexible polymorphic text component with multiple sizes, weights, and colors.
- * Automatically adapts to dark and light themes with full type safety.
- * Fully compatible with Next.js 15 and React 19.
- *
- * @param children - The content to display
- * @param size - The text size variant (2xs, xs, sm, md, lg, xl, 2xl, 3xl, 4xl, 5xl, 6xl)
- * @param weight - The font weight variant (hairline, light, normal, medium, semibold, bold, extrabold, black)
- * @param color - The color variant - adapts to theme
- * @param as - The HTML tag to render - determines allowed attributes via TypeScript
- * @param className - Additional CSS classes
- * @param props - HTML attributes valid for the chosen tag only
- * @returns A styled text element with type-safe attributes
- *
- * @example
- * ```tsx
- * <Text size="lg" weight="bold" color="text-info-800">
- *   This is a large, bold text
- * </Text>
- *
- * <Text as="a" href="/link" target="_blank">
- *   Link with type-safe anchor attributes
- * </Text>
- *
- * <Text as="button" onClick={handleClick} disabled>
- *   Button with type-safe button attributes
- * </Text>
- * ```
- */
-declare const Text: <T extends ElementType = "p">({ children, size, weight, color, as, className, ...props }: TextProps<T>) => react_jsx_runtime.JSX.Element;
-
-/**
- * Button component props interface
- */
-type ButtonProps = {
-    /** Content to be displayed inside the button */
-    children: ReactNode;
-    /** Ícone à esquerda do texto */
-    iconLeft?: ReactNode;
-    /** Ícone à direita do texto */
-    iconRight?: ReactNode;
-    /** Size of the button */
-    size?: 'extra-small' | 'small' | 'medium' | 'large' | 'extra-large';
-    /** Visual variant of the button */
-    variant?: 'solid' | 'outline' | 'link';
-    /** Action type of the button */
-    action?: 'primary' | 'positive' | 'negative';
-    /** Additional CSS classes to apply */
-    className?: string;
-} & ButtonHTMLAttributes<HTMLButtonElement>;
-/**
- * Button component for Analytica Ensino platforms
- *
- * A flexible button component with multiple variants, sizes and actions.
- * Fully compatible with Next.js 15 and React 19.
- *
- * @param children - The content to display inside the button
- * @param size - The size variant (extra-small, small, medium, large, extra-large)
- * @param variant - The visual style variant (solid, outline, link)
- * @param action - The action type (primary, positive, negative)
- * @param className - Additional CSS classes
- * @param props - All other standard button HTML attributes
- * @returns A styled button element
- *
- * @example
- * ```tsx
- * <Button variant="solid" action="primary" size="medium" onClick={() => console.log('clicked')}>
- *   Click me
- * </Button>
- * ```
- */
-declare const Button: ({ children, iconLeft, iconRight, size, variant, action, className, disabled, type, ...props }: ButtonProps) => react_jsx_runtime.JSX.Element;
-
-/**
- * Badge component props interface
- */
-type BadgeProps = {
-    /** Content to be displayed inside the badge */
-    children?: ReactNode;
-    /** Ícone à direita do texto */
-    iconRight?: ReactNode;
-    /** Ícone à esquerda do texto */
-    iconLeft?: ReactNode;
-    /** Size of the badge */
-    size?: 'small' | 'medium' | 'large';
-    /** Visual variant of the badge */
-    variant?: 'solid' | 'outlined' | 'exams' | 'resultStatus' | 'notification';
-    /** Action type of the badge  */
-    action?: 'error' | 'warning' | 'success' | 'info' | 'muted' | 'exam1' | 'exam2' | 'exam3' | 'exam4' | 'positive' | 'negative';
-    /** Additional CSS classes to apply */
-    className?: string;
-    notificationActive?: boolean;
-} & HTMLAttributes<HTMLDivElement>;
-/**
- * Badge component for Analytica Ensino platforms
- *
- * A flexible button component with multiple variants, sizes and actions.
- * Fully compatible with Next.js 15 and React 19.
- *
- * @param children - The content to display inside the badge
- * @param size - The size variant (extra-small, small, medium, large, extra-large)
- * @param variant - The visual style variant (solid, outline, link)
- * @param action - The action type (primary, positive, negative)
- * @param className - Additional CSS classes
- * @param props - All other standard div HTML attributes
- * @returns A styled badge element
- *
- * @example
- * ```tsx
- * <Badge variant="solid" action="info" size="medium">
- *   Information
- * </Badge>
- * ```
- */
-declare const Badge: ({ children, iconLeft, iconRight, size, variant, action, className, notificationActive, ...props }: BadgeProps) => react_jsx_runtime.JSX.Element;
-
-type AlertProps = {
-    title?: string;
-    description: string;
-    variant?: 'solid' | 'outline';
-    action?: 'default' | 'info' | 'success' | 'warning' | 'error';
-    className?: string;
-} & HTMLAttributes<HTMLDivElement>;
-declare const Alert: ({ variant, title, description, action, className, ...props }: AlertProps) => react_jsx_runtime.JSX.Element;
-
-/**
- * IconButton component for Analytica Ensino platforms
- *
- * Um botão compacto apenas com ícone, ideal para menus dropdown,
- * barras de ferramentas e ações secundárias.
- * Oferece dois tamanhos com estilo consistente.
- * Estado ativo permanece até ser clicado novamente ou outro botão ser ativado.
- * Compatível com Next.js 15 e React 19.
- * Suporta forwardRef para acesso programático ao elemento DOM.
- *
- * @param icon - O ícone a ser exibido no botão
- * @param size - Tamanho do botão (sm, md)
- * @param active - Estado ativo/selecionado do botão
- * @param className - Classes CSS adicionais
- * @param props - Todos os outros atributos HTML padrão de button
- * @returns Um elemento button compacto estilizado apenas com ícone
- *
- * @example
- * ```tsx
- * <IconButton
- *   icon={<MoreVerticalIcon />}
- *   size="sm"
- *   onClick={() => openMenu()}
- * />
- * ```
- *
- * @example
- * ```tsx
- * // Botão ativo em uma barra de ferramentas - permanece ativo até outro clique
- * <IconButton
- *   icon={<BoldIcon />}
- *   active={isBold}
- *   onClick={toggleBold}
- * />
- * ```
- *
- * @example
- * ```tsx
- * // Usando ref para controle programático
- * const buttonRef = useRef<HTMLButtonElement>(null);
- *
- * <IconButton
- *   ref={buttonRef}
- *   icon={<EditIcon />}
- *   size="md"
- *   onClick={() => startEditing()}
- * />
- * ```
- */
-declare const IconButton: react.ForwardRefExoticComponent<{
-    /** Ícone a ser exibido no botão */
-    icon: ReactNode;
-    /** Tamanho do botão */
-    size?: "sm" | "md";
-    /** Estado de seleção/ativo do botão - permanece ativo até ser clicado novamente ou outro botão ser ativado */
-    active?: boolean;
-    /** Additional CSS classes to apply */
-    className?: string;
-} & ButtonHTMLAttributes<HTMLButtonElement> & react.RefAttributes<HTMLButtonElement>>;
-
-/**
- * IconRoundedButton component props interface
- */
-type IconRoundedButtonProps = {
-    /** Ícone a ser exibido no botão */
-    icon: ReactNode;
-    /** Additional CSS classes to apply */
-    className?: string;
-} & ButtonHTMLAttributes<HTMLButtonElement>;
-/**
- * IconRoundedButton component for Analytica Ensino platforms
- *
- * Um botão redondo simples que exibe apenas um ícone.
- * Ideal para ações como navegação, fechar, editar, etc.
- * Compatível com Next.js 15 e React 19.
- *
- * @param icon - O ícone a ser exibido no botão
- * @param className - Classes CSS adicionais
- * @param props - Todos os outros atributos HTML padrão de button
- * @returns Um elemento button estilizado e redondo
- *
- * @example
- * ```tsx
- * <IconRoundedButton
- *   icon={<ChevronRightIcon />}
- *   onClick={() => console.log('clicked')}
- * />
- * ```
- */
-declare const IconRoundedButton: ({ icon, className, disabled, ...props }: IconRoundedButtonProps) => react_jsx_runtime.JSX.Element;
-
-/**
- * NavButton component for Analytica Ensino platforms
- *
- * Um botão de navegação com ícone e texto para navegação principal.
- * Ideal para menus de navegação, sidebar, tabs de navegação, etc.
- * Compatível com Next.js 15 e React 19.
- * Suporta forwardRef para acesso programático ao elemento DOM.
- *
- * @param icon - O ícone a ser exibido no botão
- * @param label - O texto/label a ser exibido
- * @param selected - Estado de seleção do botão
- * @param className - Classes CSS adicionais
- * @param props - Todos os outros atributos HTML padrão de button
- * @returns Um elemento button estilizado para navegação
- *
- * @example
- * ```tsx
- * <NavButton
- *   icon={<HomeIcon />}
- *   label="Início"
- *   selected={false}
- *   onClick={() => navigate('/')}
- * />
- * ```
- *
- * @example
- * ```tsx
- * // Usando ref para foco programático
- * const buttonRef = useRef<HTMLButtonElement>(null);
- *
- * const handleFocus = () => {
- *   buttonRef.current?.focus();
- * };
- *
- * <NavButton
- *   ref={buttonRef}
- *   icon={<HomeIcon />}
- *   label="Dashboard"
- *   selected={isActive}
- *   onClick={() => setActiveTab('dashboard')}
- * />
- * ```
- */
-declare const NavButton: react.ForwardRefExoticComponent<{
-    /** Ícone a ser exibido no botão */
-    icon: ReactNode;
-    /** Texto/label a ser exibido ao lado do ícone */
-    label: string;
-    /** Estado de seleção do botão */
-    selected?: boolean;
-    /** Additional CSS classes to apply */
-    className?: string;
-} & ButtonHTMLAttributes<HTMLButtonElement> & react.RefAttributes<HTMLButtonElement>>;
-
-/**
- * SelectionButton component for Analytica Ensino platforms
- *
- * Um botão com ícone e texto para ações e navegação com estado de seleção.
- * Ideal para filtros, tags, categorias, seleção de tipos, etc.
- * Compatível com Next.js 15 e React 19.
- * Suporta forwardRef para acesso programático ao elemento DOM.
- *
- * @param icon - O ícone a ser exibido no botão
- * @param label - O texto/label a ser exibido
- * @param selected - Estado de seleção do botão
- * @param className - Classes CSS adicionais
- * @param props - Todos os outros atributos HTML padrão de button
- * @returns Um elemento button estilizado
- *
- * @example
- * ```tsx
- * <SelectionButton
- *   icon={<TagIcon />}
- *   label="Categoria"
- *   selected={false}
- *   onClick={() => handleSelection()}
- * />
- * ```
- *
- * @example
- * ```tsx
- * // Usando ref para foco programático
- * const buttonRef = useRef<HTMLButtonElement>(null);
- *
- * const handleFocus = () => {
- *   buttonRef.current?.focus();
- * };
- *
- * <SelectionButton
- *   ref={buttonRef}
- *   icon={<TagIcon />}
- *   label="Categoria"
- *   selected={isSelected}
- *   onClick={() => setSelected(!isSelected)}
- * />
- * ```
- */
-declare const SelectionButton: react.ForwardRefExoticComponent<{
-    /** Ícone a ser exibido no botão */
-    icon: ReactNode;
-    /** Texto/label a ser exibido ao lado do ícone */
-    label: string;
-    /** Estado de seleção do botão */
-    selected?: boolean;
-    /** Additional CSS classes to apply */
-    className?: string;
-} & ButtonHTMLAttributes<HTMLButtonElement> & react.RefAttributes<HTMLButtonElement>>;
-
-declare const Table: react.ForwardRefExoticComponent<HTMLAttributes<HTMLTableElement> & react.RefAttributes<HTMLTableElement>>;
-
-/**
- * CheckBox size variants
- */
-type CheckBoxSize = 'small' | 'medium' | 'large';
-/**
- * CheckBox visual state
- */
-type CheckBoxState = 'default' | 'hovered' | 'focused' | 'invalid' | 'disabled';
-/**
- * CheckBox component for Analytica Ensino platforms
- *
- * A checkbox component with essential states, sizes and themes.
- * Uses the Analytica Ensino Design System colors from styles.css with automatic
- * light/dark mode support. Includes Text component integration for consistent typography.
- *
- * @example
- * ```tsx
- * // Basic checkbox
- * <CheckBox label="Option" />
- *
- * // Small size
- * <CheckBox size="small" label="Small option" />
- *
- * // Invalid state
- * <CheckBox state="invalid" label="Required field" />
- *
- * // Disabled state
- * <CheckBox disabled label="Disabled option" />
- * ```
- */
-declare const CheckBox: react.ForwardRefExoticComponent<{
-    /** Label text to display next to the checkbox */
-    label?: ReactNode;
-    /** Size variant of the checkbox */
-    size?: CheckBoxSize;
-    /** Visual state of the checkbox */
-    state?: CheckBoxState;
-    /** Indeterminate state for partial selections */
-    indeterminate?: boolean;
-    /** Error message to display */
-    errorMessage?: string;
-    /** Helper text to display */
-    helperText?: string;
-    /** Additional CSS classes */
-    className?: string;
-    /** Label CSS classes */
-    labelClassName?: string;
-} & Omit<InputHTMLAttributes<HTMLInputElement>, "size" | "type"> & react.RefAttributes<HTMLInputElement>>;
-
-/**
- * TextArea size variants
- */
-type TextAreaSize = 'small' | 'medium' | 'large' | 'extraLarge';
-/**
- * TextArea visual state
- */
-type TextAreaState = 'default' | 'hovered' | 'focused' | 'invalid' | 'disabled';
-/**
- * TextArea component for Analytica Ensino platforms
- *
- * A textarea component with essential states, sizes and themes.
- * Uses exact design specifications with 288px width, 96px height, and specific
- * color values. Includes Text component integration for consistent typography.
- *
- * @example
- * ```tsx
- * // Basic textarea
- * <TextArea label="Description" placeholder="Enter description..." />
- *
- * // Small size
- * <TextArea size="small" label="Comment" />
- *
- * // Invalid state
- * <TextArea state="invalid" label="Required field" errorMessage="This field is required" />
- *
- * // Disabled state
- * <TextArea disabled label="Read-only field" />
- * ```
- */
-declare const TextArea: react__default.ForwardRefExoticComponent<{
-    /** Label text to display above the textarea */
-    label?: ReactNode;
-    /** Size variant of the textarea */
-    size?: TextAreaSize;
-    /** Visual state of the textarea */
-    state?: TextAreaState;
-    /** Error message to display */
-    errorMessage?: string;
-    /** Helper text to display */
-    helperMessage?: string;
-    /** Additional CSS classes */
-    className?: string;
-    /** Label CSS classes */
-    labelClassName?: string;
-} & Omit<react__default.TextareaHTMLAttributes<HTMLTextAreaElement>, "size"> & react__default.RefAttributes<HTMLTextAreaElement>>;
-
-interface DropdownMenuProps {
-    children: ReactNode;
-    open?: boolean;
-    onOpenChange?: (open: boolean) => void;
-}
-declare const DropdownMenu: ({ children, open, onOpenChange }: DropdownMenuProps) => react_jsx_runtime.JSX.Element;
-declare const DropdownMenuTrigger: react.ForwardRefExoticComponent<ButtonHTMLAttributes<HTMLButtonElement> & react.RefAttributes<HTMLButtonElement>>;
-declare const MenuLabel: react.ForwardRefExoticComponent<HTMLAttributes<HTMLFieldSetElement> & {
-    inset?: boolean;
-} & react.RefAttributes<HTMLFieldSetElement>>;
-declare const MenuContent: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & {
-    align?: "start" | "center" | "end";
-    side?: "top" | "right" | "bottom" | "left";
-    sideOffset?: number;
-} & react.RefAttributes<HTMLDivElement>>;
-declare const MenuItem: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & {
-    inset?: boolean;
-    size?: "small" | "medium";
-    iconLeft?: ReactNode;
-    iconRight?: ReactNode;
-    disabled?: boolean;
-} & react.RefAttributes<HTMLDivElement>>;
-declare const MenuSeparator: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & react.RefAttributes<HTMLDivElement>>;
-
-type ToastPosition$1 = 'top-left' | 'top-center' | 'top-right' | 'bottom-left' | 'bottom-center' | 'bottom-right' | 'default';
-type ToastProps = {
-    title: string;
-    description?: string;
-    onClose: () => void;
-    /** Visual variant of the badge */
-    variant?: 'solid' | 'outlined';
-    /** Action type of the badge  */
-    action?: 'warning' | 'success' | 'info';
-    position?: ToastPosition$1;
-} & HTMLAttributes<HTMLDivElement>;
-declare const Toast: ({ variant, action, className, onClose, title, description, position, ...props }: ToastProps) => react_jsx_runtime.JSX.Element;
-
-declare const Toaster: () => react_jsx_runtime.JSX.Element;
-
-type ToastPosition = 'top-left' | 'top-center' | 'top-right' | 'bottom-left' | 'bottom-center' | 'bottom-right' | 'default';
-type ToastData = {
-    id: string;
-    title: string;
-    description?: string;
-    variant?: 'solid' | 'outlined';
-    action?: 'warning' | 'success' | 'info';
-    position?: ToastPosition;
-};
-type ToastStore = {
-    toasts: ToastData[];
-    addToast: (toast: Omit<ToastData, 'id'>) => void;
-    removeToast: (id: string) => void;
-};
-declare const useToastStore: zustand.UseBoundStore<zustand.StoreApi<ToastStore>>;
-
-export { Alert, Badge, Button, CheckBox, DropdownMenu, MenuContent as DropdownMenuContent, MenuItem as DropdownMenuItem, MenuLabel as DropdownMenuLabel, MenuSeparator as DropdownMenuSeparator, DropdownMenuTrigger, IconButton, IconRoundedButton, NavButton, SelectionButton, Table, Text, TextArea, Toast, Toaster, useToastStore };
+export { default as Text } from './Text/index.mjs';
+export { default as Button } from './Button/index.mjs';
+export { default as Badge } from './Badge/index.mjs';
+export { default as Alert } from './Alert/index.mjs';
+export { default as IconButton } from './IconButton/index.mjs';
+export { default as IconRoundedButton } from './IconRoundedButton/index.mjs';
+export { default as NavButton } from './NavButton/index.mjs';
+export { default as SelectionButton } from './SelectionButton/index.mjs';
+export { default as Table } from './Table/index.mjs';
+export { default as CheckBox } from './CheckBox/index.mjs';
+export { default as TextArea } from './TextArea/index.mjs';
+export { default as Toast } from './Toast/index.mjs';
+export { default as Toaster } from './Toast/Toaster/index.mjs';
+export { default as useToastStore } from './Toast/ToastStore/index.mjs';
+export { default as DropdownMenu, MenuContent as DropdownMenuContent, MenuItem as DropdownMenuItem, MenuLabel as DropdownMenuLabel, MenuSeparator as DropdownMenuSeparator, DropdownMenuTrigger } from './DropdownMenu/index.mjs';
+import 'react/jsx-runtime';
+import 'react';
+import 'zustand';