@coreui/react-pro 5.0.0-rc.3 → 5.1.0-alpha.0

package/src/components/calendar/CCalendar.tsx

@@ -122,7 +122,7 @@ export interface CCalendarProps {
   /**
    * Set whether to display week numbers in the calendar.
    *
-   * @since 5.0.0-rc.3
+   * @since 5.0.0
    */
   showWeekNumber?: boolean
   /**
@@ -132,7 +132,7 @@ export interface CCalendarProps {
   /**
    * Specify the type of date selection as day, week, month, or year.
    *
-   * @since 5.0.0-rc.3
+   * @since 5.0.0
    */
   selectionType?: 'day' | 'week' | 'month' | 'year'
   /**
@@ -148,7 +148,7 @@ export interface CCalendarProps {
   /**
    * Label displayed over week numbers in the calendar.
    *
-   * @since 5.0.0-rc.3
+   * @since 5.0.0
    */
   weekNumbersLabel?: string
   /**

package/src/components/card/CCard.tsx

@@ -26,7 +26,7 @@ export interface CCardProps extends HTMLAttributes<HTMLDivElement> {
    * Sets the component's color scheme to one of CoreUI's themed colors, ensuring the text color contrast adheres to the WCAG 4.5:1 contrast ratio standard for accessibility.
    *
    * @type 'primary' | 'secondary' | 'success' | 'danger' | 'warning' | 'info' | 'dark' | 'light' | string
-   * @since 5.0.0-rc.3
+   * @since 5.0.0
    */
   textBgColor?: Colors
 }

package/src/components/date-range-picker/CDateRangePicker.tsx

@@ -99,19 +99,19 @@ export interface CDateRangePickerProps
   /**
    * Custom function to format the selected date into a string according to a custom format.
    *
-   * @since v5.0.0-rc.3
+   * @since 5.0.0
    */
   inputDateFormat?: (date: Date) => string
   /**
    * Custom function to parse the input value into a valid Date object.
    *
-   * @since v5.0.0-rc.3
+   * @since 5.0.0
    */
   inputDateParse?: (date: string | Date) => Date
   /**
    * Defines the delay (in milliseconds) for the input field's onChange event.
    *
-   * @since v5.0.0-rc.3
+   * @since 5.0.0
    */
   inputOnChangeDelay?: number
   /**

package/src/components/dropdown/CDropdownToggle.tsx

@@ -21,7 +21,7 @@ export interface CDropdownToggleProps extends Omit<CButtonProps, 'type'> {
   /**
    * If a dropdown `variant` is set to `nav-item` then render the toggler as a link instead of a button.
    *
-   * @since v5.0.0-rc.3
+   * @since 5.0.0
    */
   navLink?: boolean
   /**

package/src/components/index.ts

@@ -33,6 +33,7 @@ export * from './pagination'
 export * from './placeholder'
 export * from './progress'
 export * from './popover'
+export * from './rating'
 export * from './smart-table'
 export * from './smart-pagination'
 export * from './sidebar'

package/src/components/nav/CNavGroup.tsx

@@ -22,7 +22,7 @@ export interface CNavGroupProps extends HTMLAttributes<HTMLDivElement | HTMLLIEl
   /**
    * Component used for the root node. Either a string to use a HTML element or a component.
    *
-   * @since 5.0.0-rc.3
+   * @since 5.0.0
    */
   as?: ElementType
   /**

package/src/components/nav/CNavGroupItems.tsx

@@ -8,7 +8,7 @@ export interface CNavGroupItemsProps extends HTMLAttributes<HTMLDivElement | HTM
   /**
    * Component used for the root node. Either a string to use a HTML element or a component.
    *
-   * @since 5.0.0-rc.3
+   * @since 5.0.0
    */
   as?: ElementType
   /**

package/src/components/nav/CNavItem.tsx

@@ -10,7 +10,7 @@ export interface CNavItemProps extends Omit<CNavLinkProps, 'component'> {
   /**
    * Component used for the root node. Either a string to use a HTML element or a component.
    *
-   * @since 5.0.0-rc.3
+   * @since 5.0.0
    */
   as?: ElementType
 }

package/src/components/popover/CPopover.tsx

@@ -1,13 +1,12 @@
 import React, { forwardRef, HTMLAttributes, ReactNode, useRef, useEffect, useState } from 'react'
 import classNames from 'classnames'
 import PropTypes from 'prop-types'
-import { Transition } from 'react-transition-group'
 
 import { CConditionalPortal } from '../conditional-portal'
 import { useForkedRef, usePopper } from '../../hooks'
 import { fallbackPlacementsPropType, triggerPropType } from '../../props'
 import type { Placements, Triggers } from '../../types'
-import { getRTLPlacement, getTransitionDurationFromElement } from '../../utils'
+import { executeAfterTransition, getRTLPlacement } from '../../utils'
 
 export interface CPopoverProps extends Omit<HTMLAttributes<HTMLDivElement>, 'title' | 'content'> {
   /**
@@ -101,6 +100,7 @@ export const CPopover = forwardRef<HTMLDivElement, CPopoverProps>(
     const uID = useRef(`popover${Math.floor(Math.random() * 1_000_000)}`)
 
     const { initPopper, destroyPopper } = usePopper()
+    const [mounted, setMounted] = useState(false)
     const [_visible, setVisible] = useState(visible)
 
     const _delay = typeof delay === 'number' ? { show: delay, hide: delay } : delay
@@ -133,14 +133,39 @@ export const CPopover = forwardRef<HTMLDivElement, CPopoverProps>(
       setVisible(visible)
     }, [visible])
 
-    const toggleVisible = (visible: boolean) => {
-      if (visible) {
-        setTimeout(() => setVisible(true), _delay.show)
-        return
+    useEffect(() => {
+      if (_visible) {
+        setMounted(true)
+
+        if (popoverRef.current) {
+          popoverRef.current.classList.remove('fade', 'show')
+          destroyPopper()
+        }
+
+        setTimeout(() => {
+          if (togglerRef.current && popoverRef.current) {
+            if (animation) {
+              popoverRef.current.classList.add('fade')
+            }
+
+            initPopper(togglerRef.current, popoverRef.current, popperConfig)
+            popoverRef.current.classList.add('show')
+            onShow && onShow()
+          }
+        }, _delay.show)
       }
 
-      setTimeout(() => setVisible(false), _delay.hide)
-    }
+      return () => {
+        if (popoverRef.current) {
+          popoverRef.current.classList.remove('show')
+          onHide && onHide()
+          executeAfterTransition(() => {
+            destroyPopper()
+            setMounted(false)
+          }, popoverRef.current)
+        }
+      }
+    }, [_visible])
 
     return (
       <>
@@ -150,71 +175,31 @@ export const CPopover = forwardRef<HTMLDivElement, CPopoverProps>(
           }),
           ref: togglerRef,
           ...((trigger === 'click' || trigger.includes('click')) && {
-            onClick: () => toggleVisible(!_visible),
+            onClick: () => setVisible(!_visible),
           }),
           ...((trigger === 'focus' || trigger.includes('focus')) && {
-            onFocus: () => toggleVisible(true),
-            onBlur: () => toggleVisible(false),
+            onFocus: () => setVisible(true),
+            onBlur: () => setVisible(false),
           }),
           ...((trigger === 'hover' || trigger.includes('hover')) && {
-            onMouseEnter: () => toggleVisible(true),
-            onMouseLeave: () => toggleVisible(false),
+            onMouseEnter: () => setVisible(true),
+            onMouseLeave: () => setVisible(false),
           }),
         })}
         <CConditionalPortal container={container} portal={true}>
-          <Transition
-            in={_visible}
-            mountOnEnter
-            nodeRef={popoverRef}
-            onEnter={() => {
-              if (togglerRef.current && popoverRef.current) {
-                initPopper(togglerRef.current, popoverRef.current, popperConfig)
-              }
-
-              onShow
-            }}
-            onEntering={() => {
-              if (togglerRef.current && popoverRef.current) {
-                popoverRef.current.style.display = 'initial'
-              }
-            }}
-            onExit={onHide}
-            onExited={() => {
-              destroyPopper()
-            }}
-            timeout={{
-              enter: 0,
-              exit: popoverRef.current
-                ? getTransitionDurationFromElement(popoverRef.current) + 50
-                : 200,
-            }}
-            unmountOnExit
-          >
-            {(state) => (
-              <div
-                className={classNames(
-                  'popover',
-                  'bs-popover-auto',
-                  {
-                    fade: animation,
-                    show: state === 'entered',
-                  },
-                  className,
-                )}
-                id={uID.current}
-                ref={forkedRef}
-                role="tooltip"
-                style={{
-                  display: 'none',
-                }}
-                {...rest}
-              >
-                <div className="popover-arrow"></div>
-                <div className="popover-header">{title}</div>
-                <div className="popover-body">{content}</div>
-              </div>
-            )}
-          </Transition>
+          {mounted && (
+            <div
+              className={classNames('popover', 'bs-popover-auto', className)}
+              id={uID.current}
+              ref={forkedRef}
+              role="tooltip"
+              {...rest}
+            >
+              <div className="popover-arrow"></div>
+              <div className="popover-header">{title}</div>
+              <div className="popover-body">{content}</div>
+            </div>
+          )}
         </CConditionalPortal>
       </>
     )

package/src/components/rating/CRating.tsx

@@ -0,0 +1,291 @@
+import React, { forwardRef, Fragment, HTMLAttributes, ReactNode, useId, useState } from 'react'
+import PropTypes from 'prop-types'
+import classNames from 'classnames'
+import { CTooltip } from '../tooltip'
+
+type Icon = {
+  [key: number]: JSX.Element
+}
+
+export interface CRatingProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onChange'> {
+  /**
+   * The default icon to display when the item is selected.
+   */
+  activeIcon?: string | JSX.Element | Icon
+  /**
+   * Enables the clearing upon clicking the selected item again.
+   */
+  allowClear?: boolean
+  /**
+   * A string of all className you want applied to the component.
+   */
+  className?: string
+  /**
+   * Toggle the disabled state for the component.
+   */
+  disabled?: boolean
+  /**
+   * If enabled, only the currently selected icon will be visibly highlighted.
+   */
+  highlightOnlySelected?: boolean
+  /**
+   * The default icon to display when the item is not selected.
+   */
+  icon?: string | JSX.Element | Icon
+  /**
+   * The maximum value the user can select.
+   */
+  max?: number
+  /**
+   * The name attribute of the radio input elements.
+   */
+  name?: string
+  /**
+   * Execute a function when a user changes the selected element.
+   */
+  onChange?: (value: number | null) => void
+  /**
+   * Execute a function when a user hover the element.
+   */
+  onHover?: (value: number) => void
+  /**
+   * Minimum increment value change allowed.
+   */
+  precision?: number
+  /**
+   * Toggle the readonly state for the component.
+   */
+  readOnly?: boolean
+  /**
+   * Size the component small, large, or custom if you define custom icons with custom height.
+   */
+  size?: 'sm' | 'lg' | 'custom'
+  /**
+   * Enable tooltips with default values or set specific labels for each icon.
+   */
+  tooltips?: boolean | string[]
+  /**
+   * The `value` attribute of component.
+   *
+   * @controllable onChange
+   * */
+  value?: number
+}
+
+const CConditionalTooltip = ({
+  children,
+  content,
+  tooltip,
+}: {
+  children: ReactNode
+  content?: ReactNode
+  tooltip?: boolean
+}) => {
+  return tooltip ? (
+    <CTooltip content={content}>
+      <span>{children}</span>
+    </CTooltip>
+  ) : (
+    children
+  )
+}
+
+export const CRating = forwardRef<HTMLDivElement, CRatingProps>(
+  (
+    {
+      activeIcon,
+      allowClear,
+      className,
+      disabled,
+      highlightOnlySelected,
+      icon,
+      max = 5,
+      name,
+      onChange,
+      onHover,
+      precision = 1,
+      readOnly,
+      size,
+      tooltips,
+      value,
+      ...rest
+    },
+    ref,
+  ) => {
+    const [cleared, setCleared] = useState(false)
+    const [currentValue, setCurrentValue] = useState(value ?? null)
+    const [hoverValue, setHoverValue] = useState<number | null>(null)
+    const [tooltipValue, setTooltipValue] = useState<number | string | null>(null)
+    const _name = name || useId()
+
+    const handleMouseEnter = (value: number) => {
+      if (disabled || readOnly) {
+        return
+      }
+
+      onHover && onHover(value)
+      setHoverValue(value)
+      value && setTooltipValue(value)
+    }
+
+    const handleOnChange = (value: number) => {
+      if (disabled || readOnly) {
+        return
+      }
+
+      if (cleared) {
+        setCleared(false)
+        return
+      }
+
+      setCurrentValue(value)
+      onChange && onChange(value)
+    }
+
+    const handleOnClick = (value: number) => {
+      if (disabled || readOnly) {
+        return
+      }
+
+      if (allowClear && value === currentValue) {
+        setCleared(true)
+        onChange && onChange(null)
+        setCurrentValue(null)
+        setHoverValue(null)
+      }
+    }
+
+    return (
+      <div
+        className={classNames(
+          'rating',
+          {
+            [`rating-${size}`]: size,
+            disabled: disabled,
+            readonly: readOnly,
+          },
+          className,
+        )}
+        onMouseLeave={() => !disabled && !readOnly && setHoverValue(null)}
+        role="radiogroup"
+        {...rest}
+        ref={ref}
+      >
+        {Array.from({ length: max }, (_, index) => {
+          const numberOfRadios = 1 / precision
+
+          return (
+            <CConditionalTooltip
+              key={index}
+              {...(tooltips && {
+                content: Array.isArray(tooltips)
+                  ? tooltips[index]
+                  : precision
+                    ? tooltipValue
+                    : index + 1,
+                tooltip: true,
+              })}
+            >
+              <div className="rating-item">
+                {Array.from({ length: numberOfRadios }, (_, _index) => {
+                  const isNotLastItem = _index + 1 < numberOfRadios
+                  const value =
+                    numberOfRadios === 1 ? index + 1 : index + (_index + 1) * (1 * precision)
+                  const id = useId()
+
+                  const isItemChecked = () => value === currentValue
+
+                  const isItemActive = () => {
+                    if (
+                      highlightOnlySelected
+                        ? hoverValue === value
+                        : hoverValue && hoverValue >= value
+                    ) {
+                      return true
+                    }
+
+                    if (
+                      hoverValue === null &&
+                      (highlightOnlySelected
+                        ? isItemChecked()
+                        : currentValue && currentValue >= value)
+                    ) {
+                      return true
+                    }
+
+                    return false
+                  }
+
+                  return (
+                    <Fragment key={value}>
+                      <label
+                        className={classNames('rating-item-label', {
+                          active: isItemActive(),
+                        })}
+                        htmlFor={id}
+                        onClick={() => handleOnClick(value)}
+                        onMouseEnter={() => handleMouseEnter(value)}
+                        {...(isNotLastItem && {
+                          style: {
+                            zIndex: 1 / precision - _index,
+                            position: 'absolute',
+                            width: `${precision * (_index + 1) * 100}%`,
+                            overflow: 'hidden',
+                            opacity: 0,
+                          },
+                        })}
+                      >
+                        {icon ? (
+                          <div className="rating-item-custom-icon">
+                            {(icon as Icon)[value] ?? icon}
+                          </div>
+                        ) : (
+                          <div className="rating-item-icon"></div>
+                        )}
+                        {activeIcon && (
+                          <div className="rating-item-custom-icon-active">
+                            {(activeIcon as Icon)[value] ?? activeIcon}
+                          </div>
+                        )}
+                      </label>
+                      <input
+                        className="rating-item-input"
+                        checked={isItemChecked()}
+                        disabled={disabled || readOnly}
+                        id={id}
+                        name={_name}
+                        onChange={() => handleOnChange(value)}
+                        onFocus={() => handleMouseEnter(value)}
+                        type="radio"
+                        value={value}
+                      />
+                    </Fragment>
+                  )
+                })}
+              </div>
+            </CConditionalTooltip>
+          )
+        })}
+      </div>
+    )
+  },
+)
+
+CRating.propTypes = {
+  children: PropTypes.node,
+  activeIcon: PropTypes.any,
+  allowClear: PropTypes.bool,
+  disabled: PropTypes.bool,
+  highlightOnlySelected: PropTypes.bool,
+  icon: PropTypes.any,
+  max: PropTypes.number,
+  name: PropTypes.string,
+  onChange: PropTypes.func,
+  onHover: PropTypes.func,
+  precision: PropTypes.number,
+  readOnly: PropTypes.bool,
+  size: PropTypes.oneOf(['sm', 'lg', 'custom']),
+  value: PropTypes.number,
+}
+
+CRating.displayName = 'CRating'

package/src/components/rating/index.ts

@@ -0,0 +1,3 @@
+import { CRating } from './CRating'
+
+export { CRating }

package/src/components/sidebar/CSidebarBrand.tsx

@@ -8,7 +8,7 @@ export interface CSidebarBrandProps extends HTMLAttributes<HTMLAnchorElement | H
   /**
    * Component used for the root node. Either a string to use a HTML element or a component.
    *
-   * @since 5.0.0-rc.3
+   * @since 5.0.0
    */
   as?: ElementType
   /**

package/src/components/sidebar/CSidebarNav.tsx

@@ -16,7 +16,7 @@ export interface CSidebarNavProps extends HTMLAttributes<HTMLUListElement> {
   /**
    * Component used for the root node. Either a string to use a HTML element or a component.
    *
-   * @since 5.0.0-rc.3
+   * @since 5.0.0
    */
   as?: ElementType
   /**

package/src/components/time-picker/CTimePicker.tsx

@@ -81,7 +81,7 @@ export interface CTimePickerProps
   /**
    * Specify a list of available hours using an array, or customize the filtering of hours through a function.
    *
-   * @since 5.0.0-rc.3
+   * @since 5.0.0
    */
   hours?: number[] | ((hour: number) => number[])
   /**
@@ -91,7 +91,7 @@ export interface CTimePickerProps
   /**
    * Defines the delay (in milliseconds) for the input field's onChange event.
    *
-   * @since v5.0.0-rc.3
+   * @since 5.0.0
    */
   inputOnChangeDelay?: number
   /**
@@ -105,7 +105,7 @@ export interface CTimePickerProps
   /**
    * Toggle the display of minutes, specify a list of available minutes using an array, or customize the filtering of minutes through a function.
    *
-   * @since 5.0.0-rc.3
+   * @since 5.0.0
    */
   minutes?: boolean | number[] | ((minute: number) => number[])
   /**