@giro-ds/react 4.0.0 → 5.0.1

package/dist/components/Toast/Toast.types.d.ts

@@ -1,57 +0,0 @@
-import { Toast } from 'radix-ui';
-import * as React from 'react';
-import { BaseProps } from '../../types';
-/**
- * Props do componente individual de notificação `Toast`.
- *
- * Estende {@link BaseProps} e os atributos nativos do `Toast.Root` do Radix UI,
- * excluindo as propriedades controladas internamente (`open`, `onOpenChange`,
- * `duration`, `className`).
- *
- * @example
- * ```tsx
- * showToast({
- *   title: 'Sucesso!',
- *   iconType: 'Success',
- *   duration: 3000,
- * });
- * ```
- */
-export interface ToastProps extends BaseProps, Omit<React.ComponentPropsWithoutRef<typeof Toast.Root>, 'open' | 'onOpenChange' | 'duration' | 'className'> {
-    /**
-     * Título principal exibido no toast.
-     */
-    title: string;
-    /**
-     * Define se o toast fecha automaticamente após o tempo definido em `duration`.
-     * @default true
-     */
-    automaticClose?: boolean;
-    /**
-     * Tempo em milissegundos até o toast fechar automaticamente.
-     * Só tem efeito quando `automaticClose` é `true`.
-     * @default 5000
-     */
-    duration?: number;
-    /**
-     * Ícone customizado exibido no toast.
-     * Quando fornecido, substitui o ícone gerado automaticamente por `iconType`.
-     */
-    icon?: React.ReactNode;
-    /**
-     * Ícone exibido no botão de fechar o toast.
-     * @default <Dismiss16Filled />
-     */
-    iconClosed?: React.ReactNode;
-    /**
-     * Tipo do ícone exibido automaticamente no toast.
-     *
-     * - `'Info'` → ícone informativo (`Info20Filled`)
-     * - `'Success'` → ícone de sucesso (`CheckmarkCircle20Filled`)
-     * - `'Alert'` → ícone de alerta/erro (`Warning20Filled`)
-     *
-     * Ignorado quando a prop `icon` for fornecida.
-     * @default 'Info'
-     */
-    iconType?: 'Info' | 'Success' | 'Alert';
-}

package/dist/components/Toast/__tests__/Toast.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/components/Toast/components/ToastContainer.d.ts

@@ -1,22 +0,0 @@
-import * as React from 'react';
-/**
- * Componente responsável por renderizar todos os toasts ativos na tela.
- *
- * Lê a lista de toasts do contexto fornecido pelo `ToastProvider` e os
- * renderiza individualmente. Configura o `Toast.Provider` do Radix UI com
- * direção de swipe para a esquerda.
- *
- * @remarks
- * - Deve ser posicionado **dentro** do `ToastProvider`.
- * - Geralmente é colocado próximo à raiz da aplicação, após os demais filhos.
- * - Toasts sem `id` são ignorados automaticamente.
- *
- * @example
- * ```tsx
- * <ToastProvider>
- *   <App />
- *   <ToastContainer /> {/* Deve estar aqui *\/}
- * </ToastProvider>
- * ```
- */
-export declare const ToastContainer: React.FC;

package/dist/components/Toast/components/ToastProvider.d.ts

@@ -1,35 +0,0 @@
-import * as React from 'react';
-/**
- * Provider que gerencia o estado global dos toasts na aplicação.
- *
- * Deve envolver toda a árvore de componentes que precisará exibir toasts.
- * Disponibiliza o contexto com `showToast` e `dismissToast` para todos os
- * componentes filhos via `useToast()`.
- *
- * @remarks
- * O `ToastContainer` deve ser renderizado **dentro** do `ToastProvider`.
- *
- * @example
- * ```tsx
- * // App.tsx ou layout principal
- * import { ToastProvider, ToastContainer } from '@giro-ds/react';
- *
- * function App() {
- *   return (
- *     <ToastProvider maxToasts={5}>
- *       <Routes />
- *       <ToastContainer />
- *     </ToastProvider>
- *   );
- * }
- * ```
- *
- * @param children - Árvore de componentes filhos da aplicação.
- * @param maxToasts - Número máximo de toasts exibidos simultaneamente.
- *   Quando o limite é excedido, o toast mais antigo é removido automaticamente.
- *   @default 5
- */
-export declare const ToastProvider: React.FC<{
-    children: React.ReactNode;
-    maxToasts?: number;
-}>;

package/dist/components/Toast/index.d.ts

@@ -1,5 +0,0 @@
-export { default as Toast } from './Toast';
-export { ToastProvider } from './components/ToastProvider';
-export { ToastContainer } from './components/ToastContainer';
-export { useToast } from '../../hooks/useToast';
-export type { ToastProps } from './Toast.types';

package/dist/components/Tooltip/Tooltip.d.ts

@@ -1,4 +0,0 @@
-import React from 'react';
-import { TooltipProps } from './Tooltip.types';
-declare const Tooltip: React.FC<TooltipProps>;
-export default Tooltip;

package/dist/components/Tooltip/Tooltip.types.d.ts

@@ -1,14 +0,0 @@
-import React from 'react';
-import { BaseProps, Side, Align } from '@/types';
-export interface TooltipProps extends BaseProps {
-    text: React.ReactNode;
-    side?: Side;
-    align?: Align;
-    sideOffset?: number;
-    /** Deslocamento em pixels no eixo de alinhamento */
-    alignOffset?: number;
-    /** Largura máxima do tooltip em pixels */
-    maxWidth?: number;
-    /** Elemento que dispara o tooltip ao hover */
-    children: React.ReactNode;
-}

package/dist/components/Tooltip/__tests__/Tooltip.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/components/Tooltip/index.d.ts

@@ -1,2 +0,0 @@
-export { default } from './Tooltip';
-export type { TooltipProps } from './Tooltip.types';

package/dist/components/VerificationCode/VerificationCode.d.ts

@@ -1,20 +0,0 @@
-import React from 'react';
-import type { VerificationCodeProps } from './VerificationCode.types';
-/**
- * Componente VerificationCode para entrada de códigos de verificação
- *
- * @description Permite entrada de códigos com múltiplos dígitos,
- * suportando diferentes tipos de caracteres e navegação por teclado.
- *
- * @example
- * ```tsx
- * <VerificationCode
- *   length={6}
- *   inputType="numeric"
- *   onComplete={(code) => console.log('Código:', code)}
- *   hasError={false}
- * />
- * ```
- */
-declare const VerificationCode: React.FC<VerificationCodeProps>;
-export default VerificationCode;

package/dist/components/VerificationCode/VerificationCode.types.d.ts

@@ -1,39 +0,0 @@
-import { BaseProps } from '../../types/common.types';
-/** Tipos de entrada suportados pelo VerificationCode */
-export type InputType = 'numeric' | 'alpha' | 'alphanumeric';
-/**
- * Props do componente VerificationCode
- * @example
- * ```tsx
- * <VerificationCode
- *   length={6}
- *   inputType="numeric"
- *   onComplete={(code) => handleVerification(code)}
- * />
- * ```
- * @example
- * ```tsx
- * <VerificationCode
- *   length={4}
- *   inputType="alphanumeric"
- *   onComplete={handleCode}
- *   hasError={!!error}
- *   errorMessage="Código inválido"
- *   disabled={isVerifying}
- * />
- * ```
- */
-export interface VerificationCodeProps extends BaseProps {
-    /** Número de dígitos do código (padrão: 6) */
-    length?: number;
-    /** Tipo de entrada permitida (padrão: "numeric") */
-    inputType?: InputType;
-    /** Callback executado quando todos os campos são preenchidos: (value) => void */
-    onComplete?: (value: string) => void;
-    /** Define se o campo está em estado de erro */
-    hasError?: boolean;
-    /** Mensagem de erro exibida abaixo do componente */
-    errorMessage?: string;
-    /** Props adicionais passadas para os inputs */
-    [key: string]: any;
-}

package/dist/components/VerificationCode/index.d.ts

@@ -1,2 +0,0 @@
-export { default } from './VerificationCode';
-export type { VerificationCodeProps } from './VerificationCode.types';

package/dist/components/index.d.ts

@@ -1,59 +0,0 @@
-export { default as Avatar } from './Avatar';
-export { type AvatarProps } from './Avatar/Avatar.types';
-export { default as Badge } from './Badge';
-export { type BadgeProps } from './Badge/Badge.types';
-export { default as Button } from './Button';
-export { type ButtonProps } from './Button/Button.types';
-export { default as Calendar } from './Calendar';
-export { type CalendarProps } from './Calendar/Calendar.types';
-export { default as Callout } from './Callout';
-export { type CalloutProps } from './Callout/Callout.types';
-export { default as Checkbox } from './Checkbox';
-export { type CheckboxProps } from './Checkbox/Checkbox.types';
-export { default as Chips } from './Chips';
-export { type ChipsProps } from './Chips/Chips.types';
-export { default as Container } from './Container/Container';
-export { type ContainerProps } from './Container/Container.types';
-export { default as DatePicker } from './DatePicker';
-export { type DatePickerProps } from './DatePicker/DatePicker.types';
-export { default as Dialog } from './Dialog';
-export { type DialogProps } from './Dialog/Dialog.types';
-export { default as Drawer } from './Drawer';
-export { type DrawerProps } from './Drawer/Drawer.types';
-export { default as Dropdown } from './Dropdown';
-export { type DropdownProps, type DropdownItem, type DropdownType } from './Dropdown/Dropdown.types';
-export { default as Filter } from './Filter';
-export { type FilterProps } from './Filter/Filter.types';
-export { default as ListItem } from './ListItem';
-export { type ListItemProps } from './ListItem/ListItem.types';
-export { default as Menu } from './Menu';
-export { type MenuProps } from './Menu/Menu.types';
-export { default as Popover } from './Popover';
-export { type PopoverProps } from './Popover/Popover.types';
-export { default as Quantity } from './Quantity';
-export { type QuantityProps } from './Quantity/Quantity.types';
-export { default as Radio } from './Radio';
-export { type RadioGroupProps, type RadioProps } from './Radio/Radio.types';
-export { default as Search } from './Search';
-export { type SearchProps } from './Search/Search.types';
-export { default as Select } from './Select';
-export { type SelectProps } from './Select/Select.types';
-export { default as Table } from './Table';
-export { default as TableHeader } from './Table/TableHeader';
-export { default as TablePagination } from './Table/TablePagination';
-export { type TableProps } from './Table/Table.types';
-export { type TablePaginationProps } from './Table/TablePagination';
-export { type TableHeaderProps, type FilterItem } from './Table/TableHeader';
-export { default as TextField } from './TextField';
-export { type TextFieldProps } from './TextField/TextField.types';
-export { Toast, ToastProvider, ToastContainer, useToast } from './Toast';
-export { type ToastProps } from './Toast/Toast.types';
-export { default as Tooltip } from './Tooltip';
-export { type TooltipProps } from './Tooltip/Tooltip.types';
-export { default as Switch } from './Switch';
-export { type SwitchProps } from './Switch/Switch.types';
-export { default as VerificationCode } from './VerificationCode';
-export { type VerificationCodeProps } from './VerificationCode/VerificationCode.types';
-export { default as useApiSimulation } from '../hooks/ApiSimulation';
-export { useInfiniteScroll } from '../hooks/InfiniteScroll';
-export { normalizeText } from '../hooks/NormalizeText';

package/dist/contexts/ToastContext.d.ts

@@ -1,43 +0,0 @@
-import * as React from 'react';
-import { ToastProps } from '../components/Toast/Toast.types';
-/**
- * Valor disponibilizado pelo contexto do sistema de Toast.
- *
- * Acessível via `useToast()` em componentes filhos do `ToastProvider`.
- *
- * @see {@link useToast}
- */
-export interface ToastContextValue {
-    /** Lista de toasts atualmente visíveis na tela. */
-    toasts: ToastProps[];
-    /**
-     * Exibe um novo toast na tela.
-     *
-     * Gera um `id` único automaticamente e adiciona o toast à fila.
-     * Quando o limite de `maxToasts` é atingido, o toast mais antigo é removido.
-     *
-     * @param toast - Propriedades do toast a ser exibido (sem `id`).
-     */
-    showToast: (toast: Omit<ToastProps, 'id'>) => void;
-    /**
-     * Remove um toast específico da tela pelo seu `id`.
-     *
-     * @remarks
-     * Geralmente não é necessário chamar este método manualmente, pois os toasts
-     * se fecham automaticamente (via `duration`) ou pelo botão de fechar do usuário.
-     *
-     * @param id - ID único do toast a ser removido.
-     */
-    dismissToast: (id: string) => void;
-}
-/**
- * Contexto React que armazena o estado e as ações do sistema de Toast.
- *
- * @remarks
- * Não consuma este contexto diretamente. Utilize o hook `useToast()` para
- * acessar as funcionalidades de forma segura e com verificação de provider.
- *
- * @see {@link ToastContextValue}
- * @see {@link useToast}
- */
-export declare const ToastContext: React.Context<ToastContextValue | undefined>;

package/dist/hooks/ApiSimulation.d.ts

@@ -1,53 +0,0 @@
-/**
- * Configurações para simulação de API
- */
-export interface ApiSimulationConfig {
-    /** Items por página */
-    itemsPerPage?: number;
-    /** Total de items no dataset */
-    totalItems?: number;
-    /** Delay em ms para simular latência */
-    delay?: number;
-    /** Taxa de erro (0-1) para simular falhas */
-    errorRate?: number;
-    /** Função geradora de items customizada */
-    itemGenerator?: (index: number, searchQuery?: string) => any;
-    /** Debug mode */
-    debug?: boolean;
-}
-/**
- * Estado da simulação de API
- */
-export interface ApiSimulationState<T> {
-    /** Items carregados */
-    items: T[];
-    /** Página atual */
-    currentPage: number;
-    /** Total de páginas */
-    totalPages: number;
-    /** Status do carregamento */
-    status: 'idle' | 'loading' | 'succeeded' | 'failed';
-    /** Erro atual (se houver) */
-    error: string | null;
-    /** Query de busca atual */
-    searchQuery: string;
-    /** Se há próxima página */
-    hasNextPage: boolean;
-    /** Se é a primeira página */
-    isFirstPage: boolean;
-}
-export interface ApiSimulationActions {
-    /** Carregar próxima página */
-    loadNextPage: () => Promise<void>;
-    /** Realizar nova busca */
-    search: (query: string) => Promise<void>;
-    /** Reset completo */
-    reset: () => void;
-    /** Retry da última operação */
-    retry: () => Promise<void>;
-}
-export interface UseApiSimulationReturn<T> extends ApiSimulationState<T> {
-    actions: ApiSimulationActions;
-}
-export declare function useApiSimulation<T = any>(config?: ApiSimulationConfig): UseApiSimulationReturn<T>;
-export default useApiSimulation;

package/dist/hooks/InfiniteScroll.d.ts

@@ -1,41 +0,0 @@
-/**
- * Props para o hook useInfiniteScroll
- */
-interface UseInfiniteScrollProps {
-    /** Status atual do carregamento */
-    status: 'idle' | 'loading' | 'succeeded' | 'failed';
-    /** Página atual */
-    page: number;
-    /** Última página disponível */
-    lastPage: number;
-    /** Callback para carregar próxima página */
-    onLoadMore: () => void;
-    /** Threshold para IntersectionObserver (0-1) */
-    threshold?: number;
-    /** Margem raiz para IntersectionObserver */
-    rootMargin?: string;
-    /** Habilita/desabilita o hook */
-    enabled?: boolean;
-    /** Debug mode - logs no console */
-    debug?: boolean;
-}
-/**
- * Retorno do hook useInfiniteScroll
- */
-interface UseInfiniteScrollReturn {
-    /** Ref para o elemento observador */
-    observerRef: React.RefObject<HTMLDivElement | null>;
-    /** Se o elemento está visível */
-    isIntersecting: boolean;
-    /** Se há próxima página */
-    hasNextPage: boolean;
-    /** Se todas as páginas foram carregadas */
-    isCompleted: boolean;
-    /** Função para reset manual */
-    reset: () => void;
-}
-/**
- * Hook otimizado para scroll infinito usando IntersectionObserver
- */
-export declare function useInfiniteScroll({ status, page, lastPage, onLoadMore, threshold, rootMargin, enabled, debug }: UseInfiniteScrollProps): UseInfiniteScrollReturn;
-export {};

package/dist/hooks/NormalizeText.d.ts

@@ -1 +0,0 @@
-export declare const normalizeText: (text: React.ReactNode) => string;

package/dist/hooks/useToast.d.ts

@@ -1,46 +0,0 @@
-import { ToastProps } from '../components/Toast/Toast.types';
-/**
- * Hook interno que acessa o `ToastContext` diretamente.
- *
- * @throws {Error} Lança um erro se utilizado fora de um `ToastProvider`:
- * *"useToastContext deve ser usado dentro de ToastProvider"*
- *
- * @returns O valor completo do contexto — `toasts`, `showToast` e `dismissToast`.
- *
- * @internal
- */
-export declare const useToastContext: () => import("../contexts/ToastContext").ToastContextValue;
-/**
- * Hook para exibir e remover toasts na aplicação.
- *
- * O componente que usa este hook deve ser filho de um `ToastProvider`.
- *
- * @throws {Error} Lança um erro se utilizado fora de um `ToastProvider`:
- * *"useToastContext deve ser usado dentro de ToastProvider"*
- *
- * @returns Objeto com os métodos `showToast` e `dismissToast`.
- *
- * @example
- * ```tsx
- * import { useToast } from '@giro-ds/react';
- *
- * function MeuComponente() {
- *   const { showToast } = useToast();
- *
- *   const handleSalvar = async () => {
- *     try {
- *       await salvarDados();
- *       showToast({ title: 'Sucesso!', iconType: 'Success', duration: 3000 });
- *     } catch (err) {
- *       showToast({ title: 'Erro ao salvar', iconType: 'Alert', automaticClose: false });
- *     }
- *   };
- *
- *   return <button onClick={handleSalvar}>Salvar</button>;
- * }
- * ```
- */
-export declare const useToast: () => {
-    showToast: (toast: Omit<ToastProps, "id">) => void;
-    dismissToast: (id: string) => void;
-};

package/dist/shared/Label/index.d.ts

@@ -1,15 +0,0 @@
-import * as React from 'react';
-interface LabelProps {
-    children: React.ReactNode;
-    htmlFor: string;
-    required?: boolean;
-    className?: string;
-    tooltipText?: string;
-    tooltip?: boolean;
-    side?: "top" | "right" | "bottom" | "left";
-    align?: "start" | "center" | "end";
-    error?: boolean;
-    disabled?: boolean;
-}
-declare const LabelComponent: ({ children, htmlFor, required, tooltip, tooltipText, side, align, className, error, disabled }: LabelProps) => import("react/jsx-runtime").JSX.Element;
-export default LabelComponent;

package/dist/shared/icons/CheckHalf.d.ts

@@ -1,10 +0,0 @@
-import React from 'react';
-export interface CheckHalfProps {
-    className?: string;
-    width?: number | string;
-    height?: number | string;
-    fill?: string;
-    [key: string]: any;
-}
-declare const CheckHalf: React.FC<CheckHalfProps>;
-export default CheckHalf;

package/dist/shared/icons/CheckSmall.d.ts

@@ -1,10 +0,0 @@
-import React from 'react';
-export interface CheckSmallProps {
-    className?: string;
-    width?: number | string;
-    height?: number | string;
-    fill?: string;
-    [key: string]: any;
-}
-declare const CheckSmall: React.FC<CheckSmallProps>;
-export default CheckSmall;

package/dist/shared/icons/index.d.ts

@@ -1,4 +0,0 @@
-export { default as CheckSmall } from './CheckSmall';
-export { default as CheckHalf } from './CheckHalf';
-export type { CheckSmallProps } from './CheckSmall';
-export type { CheckHalfProps } from './CheckHalf';

package/dist/types/common.types.d.ts

@@ -1,12 +0,0 @@
-export type Size = 'sm' | 'lg';
-export type Variant = 'filled' | 'outlined' | 'text';
-export type TextVariant = 'neutral' | 'brand' | 'color' | 'success' | 'alert';
-export type Side = 'top' | 'right' | 'bottom' | 'left';
-export type Align = 'start' | 'center' | 'end';
-export type Position = 'right' | 'left' | 'both';
-export type Locale = 'pt-br' | 'en-us';
-export interface BaseProps {
-    id?: string;
-    className?: string;
-    disabled?: boolean;
-}

package/dist/types/index.d.ts

@@ -1 +0,0 @@
-export type * from './common.types';