@ama-pt/agora-design-system 0.4.0 → 0.6.0

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as React$1 from 'react';
-import React__default, { ComponentPropsWithRef, ReactNode, FC, SVGProps, HTMLProps, ComponentPropsWithoutRef, ReactElement, HtmlHTMLAttributes, ChangeEvent, RefObject, AnchorHTMLAttributes, ImgHTMLAttributes } from 'react';
+import React__default, { ComponentPropsWithRef, ReactNode, FC, SVGProps, HTMLProps, ComponentPropsWithoutRef, ReactElement, ForwardRefRenderFunction, HtmlHTMLAttributes, ChangeEvent, RefObject, AnchorHTMLAttributes, ImgHTMLAttributes } from 'react';
 
 type BooleanProp = boolean | 'true' | 'false';
 
@@ -76,7 +76,7 @@ declare const Accordion: React__default.ForwardRefExoticComponent<Omit<Accordion
 /**
  * The available variants of the anchors. This variants will define the background and border color of the anchors.
  */
-type AnchorVariant = 'primary' | 'neutral' | 'white' | 'success' | 'warning' | 'danger';
+type AnchorVariant = 'primary' | 'informative' | 'neutral' | 'white' | 'success' | 'warning' | 'danger';
 /**
  * The available anchor appearances. Defines the anchor shape.
  */
@@ -244,7 +244,7 @@ declare const Breadcrumb: FC<BreadcrumbProps>;
 /**
  * The available variants of the button. This variants will define the background and border color of the button.
  */
-type ButtonVariant = 'primary' | 'neutral' | 'white' | 'success' | 'warning' | 'danger';
+type ButtonVariant = 'primary' | 'informative' | 'neutral' | 'white' | 'success' | 'warning' | 'danger';
 /**
  * The available button appearances. Defines the button shape.
  */
@@ -595,12 +595,25 @@ interface RangeProps extends Omit<ComponentPropsWithRef<'input'>, 'value' | 'onC
 }
 declare const InputRange: React__default.ForwardRefExoticComponent<Omit<RangeProps, "ref"> & React__default.RefAttributes<HTMLDivElement | HTMLInputElement | (HTMLInputElement | null)[]>>;
 
-type ListType = 'default' | 'unordered' | 'ordered';
+type ListType = 'unordered' | 'ordered';
+type ListStyle = 'none' | 'bullet' | 'number' | 'icon';
 interface ListProps extends ComponentPropsWithoutRef<'ul'> {
     /**
      * Type list.
      */
     type?: ListType;
+    /**
+     * Style of the list depending on the chosen type.
+     */
+    listStyle?: ListStyle;
+    /**
+     * Choose the starting number of an ordered number list.
+     */
+    startNumber?: number;
+    /**
+     * Choose the icon for an unordered list.
+     */
+    icon?: string;
     /**
      * Children content.
      */
@@ -646,47 +659,6 @@ interface MenuItemRef {
 type ExtendedInterfaceMenu = HTMLButtonElement | HTMLAnchorElement | MenuItemRef | AvatarProps;
 declare const MenuItem: React__default.ForwardRefExoticComponent<((BaseProps & AvatarProps) | Omit<BaseProps & React__default.HTMLProps<HTMLDivElement>, "ref"> | Omit<BaseProps & React__default.HTMLProps<HTMLAnchorElement>, "ref"> | Omit<BaseProps & React__default.HTMLProps<HTMLButtonElement>, "ref">) & React__default.RefAttributes<ExtendedInterfaceMenu>>;
 
-interface ModalProps extends ComponentPropsWithoutRef<'dialog'> {
-    /**
-     * Title text for the close button.
-     */
-    closeButtonText: string;
-    /**
-     * Children content.
-     */
-    children: ReactNode;
-    /**
-     * Show or hide close button title.
-     */
-    hideCloseButtonText?: BooleanProp;
-}
-declare const Modal: FC<ModalProps>;
-
-declare const useModal: () => {
-    showModal: (params: ReactNode, props: ModalProps) => void;
-    closeModal: () => void;
-    isOpen: boolean;
-    modalContent: ReactNode;
-    modalProps: ModalProps;
-};
-
-interface ModalContextProps {
-    isOpen?: boolean;
-    showModal: (params: ReactNode, modalProps: ModalProps) => void;
-    closeModal: () => void;
-    modalContent?: ReactNode | null;
-}
-declare const ModalContext: React$1.Context<ModalContextProps>;
-declare const useModalContext: () => ModalContextProps;
-
-interface ModalProviderProps {
-    /**
-     * Children content.
-     */
-    children: ReactNode;
-}
-declare const ModalProvider: FC<ModalProviderProps>;
-
 /**
  * The available variants of the pill. This variants will define the background and border color of the pill.
  */
@@ -799,12 +771,14 @@ interface ScribblesProps extends SuperScribblesProps {
 }
 declare const Scribbles: FC<ScribblesProps>;
 
+declare const SkipNavigation: React__default.ForwardRefExoticComponent<React__default.HTMLAttributes<HTMLAnchorElement> & React__default.RefAttributes<HTMLAnchorElement>>;
+
 type StatusCardType = 'info' | 'success' | 'warning' | 'danger';
 interface StatusCardProps extends ComponentPropsWithoutRef<'div'> {
     /**
      * Status card description content
      */
-    description: string;
+    description: ReactNode;
     /**
      * The available Status card types. Defines the appearance of the cards.
      */
@@ -995,38 +969,120 @@ type TooltipPosition = 'top' | 'bottom' | 'left' | 'right';
  * The available alignments of the Tooltip. This alignments will define the alignment of the Tooltip.
  */
 type TooltipAlignment = 'start' | 'center' | 'end';
-interface TooltipProps extends ComponentPropsWithRef<'div'> {
+interface TooltipProps extends Omit<ComponentPropsWithRef<'div'>, 'title'> {
     /**
      * The variant of the Tooltip.
      */
-    variant: TooltipVariant;
+    variant?: TooltipVariant;
     /**
      * The position of the Tooltip.
      */
-    position: TooltipPosition;
+    position?: TooltipPosition;
     /**
      * The alignment of the Tooltip.
      */
-    alignment: TooltipAlignment;
+    alignment?: TooltipAlignment;
     /**
      * The title of the Tooltip.
      */
-    title?: string;
+    title?: ReactNode;
     /**
      * If the Tooltip has a title.
      */
-    hasTitle?: boolean;
+    hasTitle?: BooleanProp;
     /**
      * The description of the Tooltip.
      */
-    description: string;
+    description: ReactNode;
     /**
      * The children of the Tooltip.
      */
-    children?: React__default.ReactNode;
+    children?: ReactNode;
 }
 declare const Tooltip: React__default.ForwardRefExoticComponent<Omit<TooltipProps, "ref"> & React__default.RefAttributes<HTMLDivElement>>;
 
+interface DialogElementRef {
+    /** Reference to the dialog container HTMLDivElement */
+    current?: HTMLDivElement;
+    /** Flag that tells if the dialog is visible or not */
+    visible?: boolean;
+    /** Show the dialog  */
+    show: () => void;
+    /** Hide the dialog  */
+    hide: () => void;
+}
+interface DialogProps extends ComponentPropsWithRef<'div'> {
+    /**
+     * Initial visibility state of the dialog
+     * */
+    visible?: BooleanProp;
+    /**
+     * Renders the dialog content as full screen without a backdrop
+     */
+    fullScreen?: BooleanProp;
+    /**
+     * If not a fullscreen dialog, allows the user to dismiss the dialog by clicking in the backdrop
+     */
+    dismissOnBackdropClick?: BooleanProp;
+    /**
+     * Allows the dialog to be closed by pressing Escape key.
+     */
+    dismissOnEscape?: BooleanProp;
+}
+declare const Dialog: React__default.ForwardRefExoticComponent<Omit<DialogProps, "ref"> & React__default.RefAttributes<DialogElementRef>>;
+
+interface InputFileProps extends ComponentPropsWithRef<'input'> {
+    /**
+     * The maxSize of the file in bytes
+     */
+    maxSize: number;
+    /**
+     * The extensionsBlackList of the uploader
+     */
+    extensionsBlackList: string[];
+    /**
+     * The addedLabel of the uploader
+     */
+    addedLabel: string;
+    /**
+     * The announceRemovedFileLabel of the uploader
+     */
+    announceRemovedFileLabel: string;
+    /**
+     * The removeFileLabel of the uploader
+     */
+    removeFileLabel: string;
+    /**
+     * The fileListLabel of the uploader
+     */
+    fileListLabel: string;
+    /**
+     * The fileDropZoneAriaLabel of the uploader
+     */
+    fileDropZoneAriaLabel: string;
+    /**
+     * The dropYourFilesHereLabel of the uploader
+     */
+    dropYourFilesHereLabel: string;
+    /**
+     * The allowedFilesAriaLabel of the uploader
+     */
+    allowedFilesAriaLabel: string;
+    /**
+     * The uploadFilesLabel of the uploader
+     */
+    uploadFilesLabel: string;
+    /**
+     * The id of the uploader
+     */
+    id?: string;
+    /**
+     * The fileLabel of the uploader
+     */
+    fileLabel: string;
+}
+declare const InputFile: ForwardRefRenderFunction<HTMLInputElement, InputFileProps>;
+
 type AccordionGroupType = 'single' | 'multiple';
 interface AccordionGroupProps extends ComponentPropsWithRef<'div'> {
     /**
@@ -1057,6 +1113,34 @@ interface AvatarGroupProps extends HtmlHTMLAttributes<HTMLDivElement> {
 }
 declare const AvatarGroup: FC<AvatarGroupProps>;
 
+interface BackToTopProps extends ComponentPropsWithRef<'button'> {
+    /**
+     * The variant of the Tooltip.
+     */
+    tooltipVariant?: TooltipVariant;
+    /**
+     * Position of the tooltip to shows when the user focus or hovers the component.
+     */
+    tooltipPosition?: TooltipPosition;
+    /**
+     * Alignment of the tooltip shown whenever the user focus or hovers the component.
+     */
+    tooltipAlignment?: TooltipAlignment;
+    /**
+     * If the Tooltip has a title.
+     */
+    hasTooltipTitle?: BooleanProp;
+    /**
+     * The title of the Tooltip.
+     */
+    tooltipTitle?: ReactNode;
+    /**
+     * Tooltip description to show when user focus or hovers the component.
+     */
+    tooltipDescription: ReactNode;
+}
+declare const BackToTop: React__default.ForwardRefExoticComponent<Omit<BackToTopProps, "ref"> & React__default.RefAttributes<HTMLButtonElement>>;
+
 interface ButtonGroupProps extends Omit<HtmlHTMLAttributes<HTMLDivElement>, 'onChange'> {
     /**
      *  button variant.
@@ -1090,10 +1174,30 @@ interface CheckboxGroupProps extends Omit<HtmlHTMLAttributes<HTMLDivElement>, 'o
      *  Input label text.
      */
     label?: string;
+    /**
+     * Decides if display/hide label.
+     */
+    hideLabel?: BooleanProp;
     /**
      *  List of checkboxes props to generate as checkboxes.
      */
     items?: CheckboxProps[];
+    /**
+     * Sets the checkbox in a error state. This also affects the feedback state.
+     */
+    hasError?: BooleanProp;
+    /**
+     * Show or hide the feedback status text.
+     */
+    hasFeedback?: BooleanProp;
+    /**
+     * Defines the state of the feedback text. This param will change the feedback icon and dye it.
+     */
+    feedbackState?: FeedbackState;
+    /**
+     * Feedback text displayed below checkbox-group.
+     */
+    feedbackText?: string;
     /**
      *  List of checkbox components to use as children of the group.
      */
@@ -1180,7 +1284,7 @@ interface DropdownListProps extends Omit<React.ComponentPropsWithRef<'select'>,
      */
     searchDebounceTimeout?: number;
     /**
-     *  Event triggered whenever the input search bar value changes.
+     *  Event triggered whenever the input search value changes.
      */
     onInputSearchChange?: (value: string) => void;
 }
@@ -1223,10 +1327,30 @@ interface RadioButtonGroupProps extends Omit<HtmlHTMLAttributes<HTMLDivElement>,
      *  Input label text.
      */
     label?: string;
+    /**
+     * Decides if display/hide label.
+     */
+    hideLabel?: BooleanProp;
     /**
      * Group name
      */
     name: string;
+    /**
+     * Sets the radio button in a error state. This also affects the feedback state.
+     */
+    hasError?: BooleanProp;
+    /**
+     * Show or hide the feedback status text.
+     */
+    hasFeedback?: BooleanProp;
+    /**
+     * Defines the state of the feedback text. This param will change the feedback icon and dye it.
+     */
+    feedbackState?: FeedbackState;
+    /**
+     * Feedback text displayed below radio-button.
+     */
+    feedbackText?: string;
     /**
      *  List of radiobutton props to generate as radio buttons.
      */
@@ -1242,6 +1366,114 @@ interface RadioButtonGroupProps extends Omit<HtmlHTMLAttributes<HTMLDivElement>,
 }
 declare const RadioButtonGroup: FC<RadioButtonGroupProps>;
 
+type PopupDimensions = 's' | 'm' | 'l';
+interface PopupDialogProps extends Omit<ComponentPropsWithRef<'div'>, 'title'> {
+    /**
+     * Available popup sizes. Can be small (S), medium (M), and large (L) dimensions.
+     */
+    dimensions?: PopupDimensions;
+    /**
+     * Title of the popup dialog.
+     */
+    title: ReactNode;
+    /**
+     * Close button alternative text.
+     */
+    closeAriaLabel: string;
+    /**
+     * Children content.
+     */
+    children: ReactNode;
+}
+declare const PopupDialog: FC<PopupDialogProps>;
+
+interface PopupContextProps {
+    current: DialogElementRef | null;
+    visibility?: boolean;
+    show: (children: ReactNode, popupProps: PopupDialogProps) => void;
+    hide: () => void;
+}
+declare const PopupContext: React$1.Context<PopupContextProps>;
+declare const usePopupContext: () => PopupContextProps;
+
+interface PopupProviderProps {
+    /**
+     * If not a fullscreen dialog, allows the user to dismiss the dialog by clicking in the backdrop
+     */
+    dismissOnBackdropClick?: BooleanProp;
+    /**
+     * Allows the dialog to be closed by pressing Escape key.
+     */
+    dismissOnEscape?: BooleanProp;
+    /**
+     * Children content.
+     */
+    children: ReactNode;
+}
+declare const PopupProvider: FC<PopupProviderProps>;
+
+interface LoaderDialogProps extends Omit<ComponentPropsWithoutRef<'div'>, 'title'> {
+    /**
+     * The title of the loader.
+     */
+    title?: string;
+    /**
+     * The subtitle of the loader.
+     */
+    subtitle?: string;
+}
+declare const LoaderDialog: FC<LoaderDialogProps>;
+
+interface LoaderDialogContextProps {
+    current: DialogElementRef | null;
+    visibility?: boolean;
+    showLoader: (props: LoaderDialogProps) => void;
+    hideLoader: () => void;
+}
+declare const LoaderDialogContext: React$1.Context<LoaderDialogContextProps>;
+declare const useLoaderDialogContext: () => LoaderDialogContextProps;
+
+interface LoaderDialogProviderProps {
+    /**
+     * Children content.
+     */
+    children: ReactNode;
+}
+declare const LoaderDialogProvider: FC<LoaderDialogProviderProps>;
+
+interface ModalDialogProps extends Omit<ComponentPropsWithRef<'div'>, 'title'> {
+    /**
+     * Close button text.
+     */
+    closeButtonLabel: string;
+    /**
+     * Children content.
+     */
+    children: ReactNode;
+}
+declare const ModalDialog: FC<ModalDialogProps>;
+
+interface ModalContextProps {
+    current: DialogElementRef | null;
+    visibility?: boolean;
+    show: (children: ReactNode, popupProps: ModalDialogProps) => void;
+    hide: () => void;
+}
+declare const ModalContext: React$1.Context<ModalContextProps>;
+declare const useModalContext: () => ModalContextProps;
+
+interface ModalProviderProps {
+    /**
+     * Allows the dialog to be closed by pressing Escape key.
+     */
+    dismissOnEscape?: BooleanProp;
+    /**
+     * Children content.
+     */
+    children: ReactNode;
+}
+declare const ModalProvider: FC<ModalProviderProps>;
+
 interface WeekDays {
     sun: string;
     mon: string;
@@ -1285,6 +1517,18 @@ interface InputDateProps extends ComponentPropsWithRef<'input'> {
      * Name of the icon leading icon to be displayed.
      */
     icon?: string;
+    /**
+     * The placeholder to apply in the input day part
+     */
+    dayInputPlaceholder?: string;
+    /**
+     * The placeholder to apply in the input month part
+     */
+    monthInputPlaceholder?: string;
+    /**
+     * The placeholder to apply in the input year part
+     */
+    yearInputPlaceholder?: string;
     /**
      * Accessible text to apply to the trailing calendar icon.
      */
@@ -1493,6 +1737,10 @@ interface InputSelectProps extends Omit<ComponentPropsWithRef<'select'>, 'option
      *  Accessible text for the input search bar.
      */
     searchInputAriaLabel?: string;
+    /**
+     *  Event triggered whenever the input search value changes.
+     */
+    onSearchInputChange?: (value: string) => void;
     /**
      *  Text to show when filtering presents no results.
      */
@@ -1658,6 +1906,16 @@ declare const AgoraTailwindConfig: {
                 16: string;
                 32: string;
             };
+            zIndex: {
+                dropdown: string;
+                backdrop: string;
+                sticky: string;
+                fixed: string;
+                drawer: string;
+                dialog: string;
+                toast: string;
+                tooltip: string;
+            };
         };
         screens: {
             xs: string;
@@ -1981,4 +2239,4 @@ declare const AgoraTailwindConfig: {
     plugins: (({ addComponents }: any) => void)[];
 };
 
-export { Accordion, AccordionGroup, type AccordionGroupProps, type AccordionGroupType, type AccordionProps, type AccordionRef, AgoraTailwindConfig, Anchor, type AnchorAppearance, type AnchorProps, type AnchorVariant, Avatar, type AvatarBadgePosition, type AvatarBadgeVariant, AvatarGroup, type AvatarGroupProps, type AvatarProps, type AvatarType, type BooleanProp, Breadcrumb, type BreadcrumbLink, type BreadcrumbProps, Button, type ButtonAppearance, ButtonGroup, type ButtonGroupProps, type ButtonProps, type ButtonVariant, type CardFooterProps, type CardLinksFooterProps, Checkbox, CheckboxGroup, type CheckboxGroupProps, type CheckboxProps, type ContactsFooterProps, Drawer, type DrawerPosition, type DrawerProps, type DrawerRef, DropdownList, type DropdownListProps, DropdownSection, DropdownSectionOption, type DropdownSectionOptionProps, type DropdownSectionProps, type DropdownSectionType, FederatedFooter, type FederatedFooterProps, type FeedbackState, type GlossaryLetter, GlossaryLetters, type GlossaryLettersProps, Icon, type IconDimensions, type IconName, type IconPosition, type IconProps, InputDate, type InputDateProps, InputNumber, type InputNumberProps, InputPassword, type InputPasswordProps, InputPhone, type InputPhoneProps, type InputPhoneRef, InputRange, InputSearch, type InputSearchProps, InputSelect, type InputSelectProps, InputText, InputTextArea, type InputTextAreaProps, type InputTextProps, type LetterStatus, type LinkableIconsProps, type LinkableImagesProps, List, type ListProps, type ListType, MenuItem, type MenuItemProps, type MenuItemRef, type MenuItemType, Modal, ModalContext, type ModalContextProps, type ModalProps, ModalProvider, type ModalProviderProps, type Months, type PhoneCountryCode, PhoneCountryCodes, type PhoneCountryISO, PhoneCountryISOs, Pill, type PillAppearance, type PillProps, type PillVariant, ProgressBar, ProgressBarGroup, type ProgressBarGroupProps, type ProgressBarProps, PublicFooter, type PublicFooterProps, RadioButton, RadioButtonGroup, type RadioButtonGroupProps, type RadioButtonProps, type RangeOrientation, type RangeProps, type RangeType, Scribbles, type ScribblesName, type ScribblesProps, StatusCard, type StatusCardProps, type StatusCardType, StepList, type StepListProps, Switch, type SwitchPosition, type SwitchProps, Tab, TabBody, type TabBodyProps, TabHeader, type TabHeaderProps, type TabProps, Tabs, type TabsProps, Tag, type TagProps, type TagVariant, Toast, ToastContext, type ToastContextProps, type ToastPositions, type ToastProps, ToastProvider, type ToastProviderProps, type ToastType, Tooltip, type TooltipAlignment, type TooltipPosition, type TooltipProps, type TooltipVariant, TypedEventEmitter, allIcons, allScribbles, debounce, normalizeText, stringToBoolean, useModal, useModalContext, useToast, useToastContext, useWindowSize };
+export { Accordion, AccordionGroup, type AccordionGroupProps, type AccordionGroupType, type AccordionProps, type AccordionRef, AgoraTailwindConfig, Anchor, type AnchorAppearance, type AnchorProps, type AnchorVariant, Avatar, type AvatarBadgePosition, type AvatarBadgeVariant, AvatarGroup, type AvatarGroupProps, type AvatarProps, type AvatarType, BackToTop, type BackToTopProps, type BooleanProp, Breadcrumb, type BreadcrumbLink, type BreadcrumbProps, Button, type ButtonAppearance, ButtonGroup, type ButtonGroupProps, type ButtonProps, type ButtonVariant, type CardFooterProps, type CardLinksFooterProps, Checkbox, CheckboxGroup, type CheckboxGroupProps, type CheckboxProps, type ContactsFooterProps, Dialog, type DialogElementRef, type DialogProps, Drawer, type DrawerPosition, type DrawerProps, type DrawerRef, DropdownList, type DropdownListProps, DropdownSection, DropdownSectionOption, type DropdownSectionOptionProps, type DropdownSectionProps, type DropdownSectionType, FederatedFooter, type FederatedFooterProps, type FeedbackState, type GlossaryLetter, GlossaryLetters, type GlossaryLettersProps, Icon, type IconDimensions, type IconName, type IconPosition, type IconProps, InputDate, type InputDateProps, InputFile, type InputFileProps, InputNumber, type InputNumberProps, InputPassword, type InputPasswordProps, InputPhone, type InputPhoneProps, type InputPhoneRef, InputRange, InputSearch, type InputSearchProps, InputSelect, type InputSelectProps, InputText, InputTextArea, type InputTextAreaProps, type InputTextProps, type LetterStatus, type LinkableIconsProps, type LinkableImagesProps, List, type ListProps, type ListStyle, type ListType, LoaderDialog, LoaderDialogContext, type LoaderDialogContextProps, type LoaderDialogProps, LoaderDialogProvider, type LoaderDialogProviderProps, MenuItem, type MenuItemProps, type MenuItemRef, type MenuItemType, ModalContext, type ModalContextProps, ModalDialog, type ModalDialogProps, ModalProvider, type ModalProviderProps, type Months, type PhoneCountryCode, PhoneCountryCodes, type PhoneCountryISO, PhoneCountryISOs, Pill, type PillAppearance, type PillProps, type PillVariant, PopupContext, type PopupContextProps, PopupDialog, type PopupDialogProps, type PopupDimensions, PopupProvider, type PopupProviderProps, ProgressBar, ProgressBarGroup, type ProgressBarGroupProps, type ProgressBarProps, PublicFooter, type PublicFooterProps, RadioButton, RadioButtonGroup, type RadioButtonGroupProps, type RadioButtonProps, type RangeOrientation, type RangeProps, type RangeType, Scribbles, type ScribblesName, type ScribblesProps, SkipNavigation, StatusCard, type StatusCardProps, type StatusCardType, StepList, type StepListProps, Switch, type SwitchPosition, type SwitchProps, Tab, TabBody, type TabBodyProps, TabHeader, type TabHeaderProps, type TabProps, Tabs, type TabsProps, Tag, type TagProps, type TagVariant, Toast, ToastContext, type ToastContextProps, type ToastPositions, type ToastProps, ToastProvider, type ToastProviderProps, type ToastType, Tooltip, type TooltipAlignment, type TooltipPosition, type TooltipProps, type TooltipVariant, TypedEventEmitter, allIcons, allScribbles, debounce, normalizeText, stringToBoolean, useLoaderDialogContext, useModalContext, usePopupContext, useToast, useToastContext, useWindowSize };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ama-pt/agora-design-system",
   "description": "Ágora Design system",
-  "version": "0.4.0",
+  "version": "0.6.0",
   "engines": {
     "node": "18.17.1"
   },