@cerberus-design/react 0.12.0 → 0.13.1-next-e3e9e48

package/build/modern/context/confirm-modal.js

@@ -2,21 +2,21 @@
 import {
   ConfirmModal,
   useConfirmModal
-} from "../chunk-CSEHDNMJ.js";
+} from "../chunk-KFGI37CO.js";
+import "../chunk-K2PSHGS7.js";
+import "../chunk-ZFAIE47A.js";
 import "../chunk-2UXE5PDG.js";
-import "../chunk-GLY7GU5S.js";
 import "../chunk-BE4EOU2P.js";
 import "../chunk-Q7BRMIBR.js";
-import "../chunk-ZFAIE47A.js";
+import "../chunk-KGQG5JGW.js";
 import "../chunk-SPZYPRZ6.js";
-import "../chunk-EXGKZGML.js";
 import "../chunk-BUVVRQLZ.js";
+import "../chunk-EXGKZGML.js";
 import "../chunk-JIZQFTW6.js";
 import "../chunk-VERRHMW4.js";
 import "../chunk-F27AAKQ3.js";
 import "../chunk-CP7OUC2Q.js";
 import "../chunk-HVKM54BA.js";
-import "../chunk-7T3JIGM7.js";
 export {
   ConfirmModal,
   useConfirmModal

package/build/modern/context/cta-modal.js

@@ -2,22 +2,22 @@
 import {
   CTAModal,
   useCTAModal
-} from "../chunk-T6LS5P5W.js";
+} from "../chunk-J4LOSTEP.js";
+import "../chunk-K2PSHGS7.js";
+import "../chunk-ZFAIE47A.js";
 import "../chunk-2UXE5PDG.js";
-import "../chunk-GLY7GU5S.js";
 import "../chunk-BE4EOU2P.js";
 import "../chunk-Q7BRMIBR.js";
-import "../chunk-ZFAIE47A.js";
 import "../chunk-APD6IX5R.js";
+import "../chunk-KGQG5JGW.js";
 import "../chunk-SPZYPRZ6.js";
-import "../chunk-EXGKZGML.js";
 import "../chunk-BUVVRQLZ.js";
+import "../chunk-EXGKZGML.js";
 import "../chunk-JIZQFTW6.js";
 import "../chunk-VERRHMW4.js";
 import "../chunk-F27AAKQ3.js";
 import "../chunk-CP7OUC2Q.js";
 import "../chunk-HVKM54BA.js";
-import "../chunk-7T3JIGM7.js";
 export {
   CTAModal,
   useCTAModal

package/build/modern/context/notification-center.js

@@ -2,13 +2,13 @@
 import {
   NotificationCenter,
   useNotificationCenter
-} from "../chunk-5OSUZUR4.js";
+} from "../chunk-KUT2YEEQ.js";
+import "../chunk-K2PSHGS7.js";
 import "../chunk-7SGPJM66.js";
 import "../chunk-XEW6TJJ4.js";
 import "../chunk-SXIXDXG3.js";
-import "../chunk-GLY7GU5S.js";
-import "../chunk-EXGKZGML.js";
 import "../chunk-BUVVRQLZ.js";
+import "../chunk-EXGKZGML.js";
 import "../chunk-JIZQFTW6.js";
 import "../chunk-VERRHMW4.js";
 import "../chunk-F27AAKQ3.js";

package/build/modern/context/prompt-modal.js

@@ -2,24 +2,24 @@
 import {
   PromptModal,
   usePromptModal
-} from "../chunk-VP5ERLAY.js";
+} from "../chunk-NCUHRVW2.js";
+import "../chunk-K2PSHGS7.js";
+import "../chunk-ZFAIE47A.js";
 import "../chunk-2UXE5PDG.js";
-import "../chunk-GLY7GU5S.js";
 import "../chunk-NKM6PISB.js";
 import "../chunk-NMF2HYWO.js";
 import "../chunk-BE4EOU2P.js";
 import "../chunk-Q7BRMIBR.js";
-import "../chunk-ZFAIE47A.js";
-import "../chunk-SPZYPRZ6.js";
-import "../chunk-EXGKZGML.js";
 import "../chunk-UZDVOIW5.js";
+import "../chunk-KGQG5JGW.js";
+import "../chunk-SPZYPRZ6.js";
 import "../chunk-BUVVRQLZ.js";
+import "../chunk-EXGKZGML.js";
 import "../chunk-JIZQFTW6.js";
 import "../chunk-VERRHMW4.js";
 import "../chunk-F27AAKQ3.js";
 import "../chunk-CP7OUC2Q.js";
 import "../chunk-HVKM54BA.js";
-import "../chunk-7T3JIGM7.js";
 export {
   PromptModal,
   usePromptModal

package/build/modern/hooks/useDate.js

@@ -0,0 +1,14 @@
+"use client";
+import {
+  DateFormats,
+  formatMilitaryDate,
+  formatMilitaryToISO,
+  useDate
+} from "../chunk-CZND26FC.js";
+export {
+  DateFormats,
+  formatMilitaryDate,
+  formatMilitaryToISO,
+  useDate
+};
+//# sourceMappingURL=useDate.js.map

package/build/modern/hooks/useDate.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/build/modern/hooks/useModal.js

@@ -1,7 +1,7 @@
 "use client";
 import {
   useModal
-} from "../chunk-7T3JIGM7.js";
+} from "../chunk-KGQG5JGW.js";
 export {
   useModal
 };

package/build/modern/index.js

@@ -1,23 +1,32 @@
+import {
+  PromptModal,
+  usePromptModal
+} from "./chunk-NCUHRVW2.js";
 import {
   ThemeProvider,
   useThemeContext
 } from "./chunk-EB37HRCN.js";
+import {
+  Toggle
+} from "./chunk-NMNONSHU.js";
+import {
+  Tooltip
+} from "./chunk-KML4CTMK.js";
 import {
   ConfirmModal,
   useConfirmModal
-} from "./chunk-CSEHDNMJ.js";
+} from "./chunk-KFGI37CO.js";
 import {
   CTAModal,
   useCTAModal
-} from "./chunk-T6LS5P5W.js";
+} from "./chunk-J4LOSTEP.js";
 import {
   NotificationCenter,
   useNotificationCenter
-} from "./chunk-5OSUZUR4.js";
+} from "./chunk-KUT2YEEQ.js";
 import {
-  PromptModal,
-  usePromptModal
-} from "./chunk-VP5ERLAY.js";
+  TabPanel
+} from "./chunk-AYIRV5CL.js";
 import {
   Table,
   Tr
@@ -41,8 +50,8 @@ import {
   Thead
 } from "./chunk-Y6QQCRQV.js";
 import {
-  Toggle
-} from "./chunk-NMNONSHU.js";
+  Portal
+} from "./chunk-K2PSHGS7.js";
 import {
   Radio
 } from "./chunk-FTPZHG6J.js";
@@ -60,8 +69,8 @@ import {
   TabList
 } from "./chunk-UKPF7JOB.js";
 import {
-  TabPanel
-} from "./chunk-AYIRV5CL.js";
+  ModalHeader
+} from "./chunk-ZFAIE47A.js";
 import {
   ModalHeading
 } from "./chunk-2UXE5PDG.js";
@@ -89,8 +98,8 @@ import {
   NotificationHeading
 } from "./chunk-SXIXDXG3.js";
 import {
-  Portal
-} from "./chunk-GLY7GU5S.js";
+  FileUploader
+} from "./chunk-W4DXACNV.js";
 import {
   Input
 } from "./chunk-NKM6PISB.js";
@@ -116,8 +125,8 @@ import {
   ModalDescription
 } from "./chunk-Q7BRMIBR.js";
 import {
-  ModalHeader
-} from "./chunk-ZFAIE47A.js";
+  Checkbox
+} from "./chunk-NB6DV4VA.js";
 import {
   CircularProgress
 } from "./chunk-6QHOKCV3.js";
@@ -140,7 +149,7 @@ import {
 import {
   FileStatus,
   processStatus
-} from "./chunk-ZBMA5G54.js";
+} from "./chunk-7MM5KYEX.js";
 import {
   ProgressBar
 } from "./chunk-KCANMM64.js";
@@ -151,8 +160,12 @@ import {
   FieldMessage
 } from "./chunk-JWIJHSI6.js";
 import {
-  FileUploader
-} from "./chunk-W4DXACNV.js";
+  Field,
+  useFieldContext
+} from "./chunk-UZDVOIW5.js";
+import {
+  useModal
+} from "./chunk-KGQG5JGW.js";
 import {
   MODE_KEY,
   THEME_KEY,
@@ -172,19 +185,12 @@ import {
 import {
   Avatar
 } from "./chunk-SPZYPRZ6.js";
-import {
-  Button
-} from "./chunk-EXGKZGML.js";
-import {
-  Checkbox
-} from "./chunk-NB6DV4VA.js";
-import {
-  Field,
-  useFieldContext
-} from "./chunk-UZDVOIW5.js";
 import {
   Show
 } from "./chunk-BUVVRQLZ.js";
+import {
+  Button
+} from "./chunk-EXGKZGML.js";
 import "./chunk-55J6XMHW.js";
 import {
   createNavTriggerProps
@@ -208,8 +214,11 @@ import "./chunk-F27AAKQ3.js";
 import "./chunk-CP7OUC2Q.js";
 import "./chunk-HVKM54BA.js";
 import {
-  useModal
-} from "./chunk-7T3JIGM7.js";
+  DateFormats,
+  formatMilitaryDate,
+  formatMilitaryToISO,
+  useDate
+} from "./chunk-CZND26FC.js";
 
 // src/index.ts
 export * from "@dnd-kit/core";
@@ -224,6 +233,7 @@ export {
   Checkbox,
   CircularProgress,
   ConfirmModal,
+  DateFormats,
   Droppable,
   FeatureFlag,
   FeatureFlags,
@@ -280,15 +290,19 @@ export {
   Thead,
   ThemeProvider,
   Toggle,
+  Tooltip,
   Tr,
   createNavTriggerProps,
   defineIcons,
+  formatMilitaryDate,
+  formatMilitaryToISO,
   formatNotifyCount,
   getPosition,
   processStatus,
   trapFocus,
   useCTAModal,
   useConfirmModal,
+  useDate,
   useFeatureFlags,
   useFieldContext,
   useModal,

package/build/modern/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/index.ts"],"sourcesContent":["/**\n * This module is the entry point for the Cerberus React package.\n * @module\n */\n\n// components\n\nexport * from './components/Admonition'\nexport * from './components/Avatar'\nexport * from './components/Button'\nexport * from './components/Checkbox'\nexport * from './components/CircularProgress'\nexport * from './components/Droppable'\nexport * from './components/FieldMessage'\nexport * from './components/FeatureFlag'\nexport * from './components/Fieldset'\nexport * from './components/FieldsetLabel'\nexport * from './components/FileStatus'\nexport * from './components/FileUploader'\nexport * from './components/IconButton'\nexport * from './components/Input'\nexport * from './components/Label'\nexport * from './components/Legend'\nexport * from './components/Menu'\nexport * from './components/Modal'\nexport * from './components/ModalHeader'\nexport * from './components/ModalHeading'\nexport * from './components/ModalDescription'\nexport * from './components/NavMenuTrigger'\nexport * from './components/NavMenuList'\nexport * from './components/NavMenuLink'\nexport * from './components/Notification'\nexport * from './components/NotificationHeading'\nexport * from './components/NotificationDescription'\nexport * from './components/Portal'\nexport * from './components/ProgressBar'\nexport * from './components/Radio'\nexport * from './components/Select'\nexport * from './components/Spinner'\nexport * from './components/Tab'\nexport * from './components/TabList'\nexport * from './components/TabPanel'\nexport * from './components/Table'\nexport * from './components/Thead'\nexport * from './components/Th'\nexport * from './components/Td'\nexport * from './components/Tbody'\nexport * from './components/Tag'\nexport * from './components/Textarea'\nexport * from './components/Toggle'\nexport * from './components/Show'\n\n// context\n\nexport * from './context/confirm-modal'\nexport * from './context/cta-modal'\nexport * from './context/feature-flags'\nexport * from './context/field'\nexport * from './context/navMenu'\nexport * from './context/notification-center'\nexport * from './context/prompt-modal'\nexport * from './context/tabs'\nexport * from './context/theme'\n\n// hooks\n\nexport * from './hooks/useModal'\nexport * from './hooks/useTheme'\nexport * from './hooks/useToggle'\n\n// aria-helpers\n\nexport * from './aria-helpers/nav-menu.aria'\nexport * from './aria-helpers/tabs.aria'\nexport * from './aria-helpers/trap-focus.aria'\n\n// utils\n\nexport * from './config/defineIcons'\nexport * from './utils/index'\n\n// shared types\n\nexport * from './types'\n\n// 3rd party\n\nexport * from '@dnd-kit/core'\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuFA,cAAc;","names":[]}
+{"version":3,"sources":["../../src/index.ts"],"sourcesContent":["/**\n * This module is the entry point for the Cerberus React package.\n * @module\n */\n\n// components\n\nexport * from './components/Admonition'\nexport * from './components/Avatar'\nexport * from './components/Button'\nexport * from './components/Checkbox'\nexport * from './components/CircularProgress'\nexport * from './components/Droppable'\nexport * from './components/FieldMessage'\nexport * from './components/FeatureFlag'\nexport * from './components/Fieldset'\nexport * from './components/FieldsetLabel'\nexport * from './components/FileStatus'\nexport * from './components/FileUploader'\nexport * from './components/IconButton'\nexport * from './components/Input'\nexport * from './components/Label'\nexport * from './components/Legend'\nexport * from './components/Menu'\nexport * from './components/Modal'\nexport * from './components/ModalHeader'\nexport * from './components/ModalHeading'\nexport * from './components/ModalDescription'\nexport * from './components/NavMenuTrigger'\nexport * from './components/NavMenuList'\nexport * from './components/NavMenuLink'\nexport * from './components/Notification'\nexport * from './components/NotificationHeading'\nexport * from './components/NotificationDescription'\nexport * from './components/Portal'\nexport * from './components/ProgressBar'\nexport * from './components/Radio'\nexport * from './components/Select'\nexport * from './components/Spinner'\nexport * from './components/Tab'\nexport * from './components/TabList'\nexport * from './components/TabPanel'\nexport * from './components/Table'\nexport * from './components/Thead'\nexport * from './components/Th'\nexport * from './components/Td'\nexport * from './components/Tbody'\nexport * from './components/Tag'\nexport * from './components/Textarea'\nexport * from './components/Toggle'\nexport * from './components/Tooltip'\nexport * from './components/Show'\n\n// context\n\nexport * from './context/confirm-modal'\nexport * from './context/cta-modal'\nexport * from './context/feature-flags'\nexport * from './context/field'\nexport * from './context/navMenu'\nexport * from './context/notification-center'\nexport * from './context/prompt-modal'\nexport * from './context/tabs'\nexport * from './context/theme'\n\n// hooks\n\nexport * from './hooks/useDate'\nexport * from './hooks/useModal'\nexport * from './hooks/useTheme'\nexport * from './hooks/useToggle'\n\n// aria-helpers\n\nexport * from './aria-helpers/nav-menu.aria'\nexport * from './aria-helpers/tabs.aria'\nexport * from './aria-helpers/trap-focus.aria'\n\n// utils\n\nexport * from './config/defineIcons'\nexport * from './utils/index'\n\n// shared types\n\nexport * from './types'\n\n// 3rd party\n\nexport * from '@dnd-kit/core'\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyFA,cAAc;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cerberus-design/react",
-  "version": "0.12.0",
+  "version": "0.13.1-next-e3e9e48",
   "description": "The Cerberus Design React component library.",
   "browserslist": "> 0.25%, not dead",
   "sideEffects": false,
@@ -27,7 +27,7 @@
     "react-dom": "^18",
     "tsup": "^8.1.0",
     "@cerberus-design/configs": "0.0.0",
-    "@cerberus-design/styled-system": "0.12.0"
+    "@cerberus-design/styled-system": "0.13.1-next-e3e9e48"
   },
   "publishConfig": {
     "access": "public"

package/src/components/Portal.tsx

@@ -1,3 +1,5 @@
+'use client'
+
 import type { PropsWithChildren } from 'react'
 import { createPortal } from 'react-dom'
 
@@ -22,12 +24,21 @@ export interface PortalProps {
  * The Portal component is used to render children into a DOM node that exists outside the DOM hierarchy of the parent component.
  * @see https://cerberus.digitalu.design/react/portal
  * @definition [React Portal Docs](https://react.dev/reference/react-dom/createPortal)
+ * @example
+ * ```tsx
+ * 'use client'
+ *
+ * import { Portal } from '@cerberus/react'
+ *
+ * function SomeFeatureWithinSSRPage() {
+ *   return (
+ *     <Portal>
+ *       <div>Portal Content outside of the React VDom tree</div>
+ *     </Portal>
+ *   )
+ * }
  */
 export function Portal(props: PropsWithChildren<PortalProps>) {
-  if (typeof window !== 'undefined') {
-    const container = props.container || document.body
-    return createPortal(props.children, container, props.key)
-  }
-
-  return null
+  const container = props.container || document.body
+  return createPortal(props.children, container, props.key)
 }

package/src/components/Tooltip.tsx

@@ -0,0 +1,61 @@
+import {
+  Tooltip as ArkTooltip,
+  type TooltipContentProps,
+} from '@ark-ui/react/tooltip'
+import { cx } from '@cerberus/styled-system/css'
+import { tooltip } from '@cerberus/styled-system/recipes'
+import type { ReactNode } from 'react'
+
+/**
+ * This module contains the Tooltip component.
+ * @module Tooltip
+ */
+
+export interface TooltipProps {
+  /**
+   * The text content to display in the tooltip.
+   */
+  content: ReactNode
+  /**
+   * The position of the tooltip relative to the trigger element.
+   */
+  position?: 'top' | 'right' | 'bottom' | 'left'
+}
+
+/**
+ * The Tooltip component is used to provide additional information about an element when it is hovered over.
+ * @definition [Tooltip docs](https://cerberus.digitalu.design/react/tooltip)
+ * @example
+ * ```tsx
+ * <Tooltip content="This is a tooltip">
+ *   <Information />
+ * </Tooltip>
+ */
+export function Tooltip(props: TooltipProps & TooltipContentProps) {
+  const { content, children, ...nativeProps } = props
+  const styles = tooltip()
+  const position = {
+    placement: props.position || 'top',
+  }
+
+  return (
+    <ArkTooltip.Root openDelay={400} positioning={position}>
+      <ArkTooltip.Trigger className={styles.trigger}>
+        {children}
+      </ArkTooltip.Trigger>
+
+      <ArkTooltip.Positioner>
+        <ArkTooltip.Content
+          {...nativeProps}
+          className={cx(nativeProps.className, styles.content)}
+        >
+          <ArkTooltip.Arrow className={styles.arrow}>
+            <ArkTooltip.ArrowTip className={styles.arrowTip} />
+          </ArkTooltip.Arrow>
+
+          {content}
+        </ArkTooltip.Content>
+      </ArkTooltip.Positioner>
+    </ArkTooltip.Root>
+  )
+}

package/src/context/notification-center.tsx

@@ -136,7 +136,7 @@ export function NotificationCenter(
                 palette="action"
                 shape="rounded"
                 size="sm"
-                usage="text"
+                usage="ghost"
               >
                 Close all
               </Button>

package/src/hooks/useDate.ts

@@ -0,0 +1,164 @@
+'use client'
+
+import {
+  useState,
+  useCallback,
+  ChangeEvent,
+  useMemo,
+  type InputHTMLAttributes,
+} from 'react'
+
+export interface UseDateBase {
+  /**
+   * The format of the date input
+   */
+  format?: string
+  /**
+   * The callback to run when the date input changes
+   */
+  onChange?: InputHTMLAttributes<HTMLInputElement>['onChange']
+}
+
+export interface UseDateOptions extends UseDateBase {
+  /**
+   * The initial value of the date input
+   */
+  initialValue?: string
+}
+
+export interface UseDateReturn extends UseDateBase {
+  /**
+   * The ISO formatted date string
+   */
+  ISO: string
+  /**
+   * The value of the date input
+   */
+  value: string
+}
+
+/**
+ * A hook for formatting and validating date inputs. The date format defaults to US Military format.
+ * @example
+ * ```tsx
+ * const MyComponent = () => {
+ *  const date = useDate({ initialValue: '01 JAN 2024' })
+ *  return <input onChange={date.onChange} type="text" value={date.value} />
+ * }
+ */
+export function useDate(options?: UseDateOptions): UseDateReturn {
+  const initialValue = options?.initialValue ?? ''
+  const format = options?.format ?? DateFormats.USMilitary
+  const onChange = options?.onChange
+  const [value, setValue] = useState(initialValue)
+
+  const handleChange = useCallback(
+    (e: ChangeEvent<HTMLInputElement>) => {
+      const newValue = formatMilitaryDate(e.currentTarget.value)
+      if (onChange) onChange(e)
+      setValue(newValue)
+    },
+    [onChange],
+  )
+
+  return useMemo(
+    () => ({
+      format,
+      value,
+      ISO: formatMilitaryToISO(value),
+      onChange: handleChange,
+    }),
+    [format, value, handleChange],
+  )
+}
+
+// helpers
+
+/**
+ * Converts a string in US Military format to ISO format. Used within the `useDate` hook.
+ * @param input The string to format
+ * @returns The formatted string in ISO format (YYYY-MM-DD)
+ */
+export function formatMilitaryToISO(input: string) {
+  const [day, month, year] = input.split(' ')
+  const monthIndex = MONTHS.findIndex((m) => m.startsWith(month))
+  const monthNum = monthIndex + 1
+  return `${year ?? '0000'}-${monthNum.toString().padStart(2, '0')}-${day.padStart(
+    2,
+    '0',
+  )}`
+}
+
+/**
+ * Converts a string to US Military format. Used within the `useDate` hook.
+ * @param input The string to format
+ * @returns The formatted string in US Military format (DD MMM YYYY)
+ */
+export function formatMilitaryDate(input: string): string {
+  let formatted = input.toUpperCase().replace(/[^0-9A-Z]/g, '')
+  let day = ''
+  let month = ''
+  let year = ''
+
+  // Format day
+  if (formatted.length >= 2) {
+    day = formatted.replace(/[^0-9]/g, '').slice(0, 2)
+    const dayNum = parseInt(day, 10)
+    if (dayNum > 31) day = '31'
+    else if (dayNum === 0) day = '01'
+    formatted = formatted.slice(2)
+  }
+
+  // Format month
+  if (formatted.length >= 3) {
+    month = formatted.slice(0, 3)
+    const monthIndex = MONTHS.findIndex((m) => m.startsWith(month))
+    if (monthIndex !== -1) {
+      month = MONTHS[monthIndex]
+    } else {
+      month = month.replace(/[^A-Z]/g, '')
+    }
+    formatted = formatted.slice(3)
+  }
+
+  // Format year
+  if (formatted.length > 0) {
+    year = formatted.slice(0, 4)
+  }
+
+  return [day, month, year].filter(Boolean).join(' ')
+}
+
+/**
+ * Date formatting options
+ * @example
+ * ```tsx
+ * const date = new Date()
+ * const formatted = date.format(DateFormats.USMilitary)
+ */
+export const DateFormats = {
+  get ISO() {
+    return 'YYYY-MM-DD'
+  },
+  get USMilitary() {
+    return 'DD MMM YYYY'
+  },
+  get Months() {
+    return MONTHS
+  },
+}
+
+const MONTHS = [
+  'JAN',
+  'FEB',
+  'MAR',
+  'APR',
+  'MAY',
+  'JUN',
+  'JUL',
+  'AUG',
+  'SEP',
+  'OCT',
+  'NOV',
+  'DEC',
+]

package/src/hooks/useModal.ts

@@ -7,7 +7,7 @@ import { useCallback, useMemo, useRef, useState, type RefObject } from 'react'
  * @module
  */
 
-interface UseModalReturnValue {
+export interface UseModalReturnValue {
   /**
    * The ref for the modal.
    */

package/src/index.ts

@@ -48,6 +48,7 @@ export * from './components/Tbody'
 export * from './components/Tag'
 export * from './components/Textarea'
 export * from './components/Toggle'
+export * from './components/Tooltip'
 export * from './components/Show'
 
 // context
@@ -64,6 +65,7 @@ export * from './context/theme'
 
 // hooks
 
+export * from './hooks/useDate'
 export * from './hooks/useModal'
 export * from './hooks/useTheme'
 export * from './hooks/useToggle'

package/build/modern/chunk-5OSUZUR4.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/context/notification-center.tsx"],"sourcesContent":["'use client'\n\nimport {\n  createContext,\n  useCallback,\n  useContext,\n  useMemo,\n  useState,\n  type MouseEvent,\n  type PropsWithChildren,\n  type ReactNode,\n} from 'react'\nimport { Show } from '../components/Show'\nimport { NotificationHeading } from '../components/NotificationHeading'\nimport { NotificationDescription } from '../components/NotificationDescription'\nimport { Notification } from '../components/Notification'\nimport { animateIn, vstack } from '@cerberus/styled-system/patterns'\nimport { Portal, type PortalProps } from '../components/Portal'\nimport { notification } from '@cerberus/styled-system/recipes'\nimport { Button } from '../components/Button'\nimport { cx } from '@cerberus/styled-system/css'\n\n/**\n * This module provides a context and hook for notifications.\n * @module\n */\n\nexport interface NotifyOptions {\n  /**\n   * The palette of the notification.\n   * @default 'info'\n   */\n  palette: 'info' | 'success' | 'warning' | 'danger'\n  /**\n   * The heading of the notification.\n   */\n  heading: string\n  /**\n   * The unique id of the notification.\n   */\n  id?: string\n  /**\n   * The description of the notification.\n   */\n  description?: ReactNode\n  /**\n   * The action to take when the notification is closed\n   */\n  onClose?: () => void\n}\n\nexport interface NotificationsValue {\n  notify: (options: NotifyOptions) => void\n}\n\nconst NotificationsContext = createContext<NotificationsValue | null>(null)\n\nexport interface NotificationsProviderProps extends PortalProps {}\n\n/**\n * Provides a notification center to the app.\n * @see https://cerberus.digitalu.design/react/notification\n * @example\n * ```tsx\n * // Wrap the Provider around the root of the feature.\n * <Notifications>\n *   <SomeFeatureSection />\n * </Notifications>\n *\n * // Use the hook to show a notification.\n * const notify = useNotifications()\n *\n * const handleClick = useCallback(() => {\n *  notify({\n *   palette: 'info',\n *   heading: 'New feature!',\n *   description: 'We have added a new feature to the app.',\n * })\n * }, [notify])\n * ```\n */\nexport function NotificationCenter(\n  props: PropsWithChildren<NotificationsProviderProps>,\n) {\n  const [activeNotifications, setActiveNotifications] = useState<\n    NotifyOptions[]\n  >([])\n  const styles = notification()\n\n  const handleNotify = useCallback((options: NotifyOptions) => {\n    setActiveNotifications((prev) => {\n      const id = `${options.palette}:${prev.length + 1}`\n      return [...prev, { ...options, id }]\n    })\n  }, [])\n\n  const handleClose = useCallback((e: MouseEvent<HTMLButtonElement>) => {\n    const target = e.currentTarget as HTMLButtonElement\n    setActiveNotifications((prev) => {\n      const item = prev.find((option) => option.id === target.value)\n      if (item?.onClose) item.onClose()\n      return prev.filter((option) => option.id !== target.value)\n    })\n  }, [])\n\n  const handleCloseAll = useCallback(() => {\n    setActiveNotifications((prev) => {\n      prev.forEach((item) => {\n        if (item.onClose) item.onClose()\n      })\n      return []\n    })\n  }, [])\n\n  const value = useMemo(\n    () => ({\n      notify: handleNotify,\n    }),\n    [handleNotify],\n  )\n\n  // For some reason, the vstack pattern alignItems is not registering here.\n  // So we are forcing it with the style prop.\n\n  return (\n    <NotificationsContext.Provider value={value}>\n      {props.children}\n\n      <Show when={activeNotifications.length > 0}>\n        <Portal container={props.container}>\n          <div className={styles.center}>\n            <Show when={activeNotifications.length >= 4}>\n              <Button\n                className={cx(styles.closeAll, animateIn())}\n                onClick={handleCloseAll}\n                palette=\"action\"\n                shape=\"rounded\"\n                size=\"sm\"\n                usage=\"text\"\n              >\n                Close all\n              </Button>\n            </Show>\n            <div\n              className={vstack({\n                alignItems: 'flex-end',\n                gap: '4',\n              })}\n              style={{\n                alignItems: 'flex-end',\n              }}\n            >\n              {activeNotifications.map((option) => (\n                <MatchNotification\n                  key={option.id}\n                  {...option}\n                  onClose={handleClose}\n                />\n              ))}\n            </div>\n          </div>\n        </Portal>\n      </Show>\n    </NotificationsContext.Provider>\n  )\n}\n\ninterface MatchNotificationProps extends Omit<NotifyOptions, 'onClose'> {\n  onClose: (e: MouseEvent<HTMLButtonElement>) => void\n  key: string | undefined\n}\n\nfunction MatchNotification(props: MatchNotificationProps) {\n  const { palette, id, onClose, heading, description } = props\n\n  switch (palette) {\n    case 'success':\n      return (\n        <Notification\n          id={id!}\n          key={id}\n          onClose={onClose}\n          open\n          palette=\"success\"\n        >\n          <NotificationHeading palette=\"success\">{heading}</NotificationHeading>\n          <NotificationDescription palette=\"success\">\n            {description}\n          </NotificationDescription>\n        </Notification>\n      )\n\n    case 'warning':\n      return (\n        <Notification\n          id={id!}\n          key={id}\n          onClose={onClose}\n          open\n          palette=\"warning\"\n        >\n          <NotificationHeading palette=\"warning\">{heading}</NotificationHeading>\n          <NotificationDescription palette=\"warning\">\n            {description}\n          </NotificationDescription>\n        </Notification>\n      )\n\n    case 'danger':\n      return (\n        <Notification id={id!} key={id} onClose={onClose} open palette=\"danger\">\n          <NotificationHeading palette=\"danger\">{heading}</NotificationHeading>\n          <NotificationDescription palette=\"danger\">\n            {description}\n          </NotificationDescription>\n        </Notification>\n      )\n\n    case 'info':\n    default:\n      return (\n        <Notification id={id!} key={id} onClose={onClose} open palette=\"info\">\n          <NotificationHeading palette=\"info\">{heading}</NotificationHeading>\n          <NotificationDescription palette=\"info\">\n            {description}\n          </NotificationDescription>\n        </Notification>\n      )\n  }\n}\n\n/**\n * The hook to use the NotificationCenter.\n * @returns The notify method to trigger a notification.\n * @example\n * ```tsx\n * const {notify} = useNotificationCenter()\n * notify({\n *  palette: 'info',\n *  heading: 'New feature',\n *  description: 'We have added a new feature to the app.',\n * })\n * ```\n */\nexport function useNotificationCenter(): NotificationsValue {\n  const context = useContext(NotificationsContext)\n  if (!context) {\n    throw new Error(\n      'useNotificationCenter must be used within a NotificationsProvider',\n    )\n  }\n  return context\n}\n"],"mappings":"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","names":[]}

package/build/modern/chunk-7T3JIGM7.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/hooks/useModal.ts"],"sourcesContent":["'use client'\n\nimport { useCallback, useMemo, useRef, useState, type RefObject } from 'react'\n\n/**\n * This module provides a hook for using a custom modal.\n * @module\n */\n\ninterface UseModalReturnValue {\n  /**\n   * The ref for the modal.\n   */\n  modalRef: RefObject<HTMLDialogElement>\n  /**\n   * Shows the modal.\n   */\n  show: () => void\n  /**\n   * Closes the modal.\n   */\n  close: () => void\n  /**\n   * Whether the modal is open based on the show and close methods.\n   */\n  isOpen: boolean\n}\n\n/**\n * Provides a hook for using a custom modal via the native dialog element\n * methods.\n *\n * Cerberus modals use the native dialog element. This hook\n * does not control the modal via React state but rather by calling the\n * native dialog element's `showModal` and `close` methods.\n *\n * @memberof module:Modal\n * @see https://cerberus.digitalu.design/react/modal\n * @description [Moz Dev Dialog Docs](https://developer.mozilla.org/en-US/docs/Web/API/HTMLDialogElement/showModal)\n */\nexport function useModal(): UseModalReturnValue {\n  const modalRef = useRef<HTMLDialogElement | null>(null)\n  const [isOpen, setIsOpen] = useState<boolean>(false)\n\n  const show = useCallback(() => {\n    modalRef.current?.showModal()\n    setIsOpen(true)\n  }, [])\n\n  const close = useCallback(() => {\n    modalRef.current?.close()\n    setIsOpen(false)\n  }, [])\n\n  return useMemo(() => {\n    return {\n      modalRef,\n      show,\n      close,\n      isOpen,\n    }\n  }, [modalRef, show, close, isOpen])\n}\n"],"mappings":";AAEA,SAAS,aAAa,SAAS,QAAQ,gBAAgC;AAsChE,SAAS,WAAgC;AAC9C,QAAM,WAAW,OAAiC,IAAI;AACtD,QAAM,CAAC,QAAQ,SAAS,IAAI,SAAkB,KAAK;AAEnD,QAAM,OAAO,YAAY,MAAM;AAC7B,aAAS,SAAS,UAAU;AAC5B,cAAU,IAAI;AAAA,EAChB,GAAG,CAAC,CAAC;AAEL,QAAM,QAAQ,YAAY,MAAM;AAC9B,aAAS,SAAS,MAAM;AACxB,cAAU,KAAK;AAAA,EACjB,GAAG,CAAC,CAAC;AAEL,SAAO,QAAQ,MAAM;AACnB,WAAO;AAAA,MACL;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,EACF,GAAG,CAAC,UAAU,MAAM,OAAO,MAAM,CAAC;AACpC;","names":[]}