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

package/build/modern/_tsup-dts-rollup.d.ts

@@ -130,6 +130,7 @@ import { TdVariantProps } from '@cerberus/styled-system/recipes';
 import type { TextareaHTMLAttributes } from 'react';
 import { ThVariantProps } from '@cerberus/styled-system/recipes';
 import { ToggleVariantProps } from '@cerberus/styled-system/recipes';
+import { TooltipContentProps } from '@ark-ui/react/tooltip';
 import { TouchSensor } from '@dnd-kit/core';
 import { TouchSensorOptions } from '@dnd-kit/core';
 import { Translate } from '@dnd-kit/core';
@@ -579,6 +580,21 @@ export { Data }
 
 export { DataRef }
 
+/**
+ * Date formatting options
+ * @example
+ * ```tsx
+ * const date = new Date()
+ * const formatted = date.format(DateFormats.USMilitary)
+ */
+declare const DateFormats: {
+    readonly ISO: string;
+    readonly USMilitary: string;
+    readonly Months: string[];
+};
+export { DateFormats }
+export { DateFormats as DateFormats_alias_1 }
+
 export { defaultAnnouncements }
 
 export { defaultCoordinates }
@@ -1015,6 +1031,24 @@ declare interface FileUploaderProps extends InputHTMLAttributes<HTMLInputElement
 export { FileUploaderProps }
 export { FileUploaderProps as FileUploaderProps_alias_1 }
 
+/**
+ * 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)
+ */
+declare function formatMilitaryDate(input: string): string;
+export { formatMilitaryDate }
+export { formatMilitaryDate as formatMilitaryDate_alias_1 }
+
+/**
+ * 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)
+ */
+declare function formatMilitaryToISO(input: string): string;
+export { formatMilitaryToISO }
+export { formatMilitaryToISO as formatMilitaryToISO_alias_1 }
+
 /**
  * This module contains utility functions that are used across your app.
  * @module Utils
@@ -1821,8 +1855,21 @@ export { pointerWithin }
  * 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>
+ *   )
+ * }
  */
-declare function Portal(props: PropsWithChildren<PortalProps>): ReactPortal | null;
+declare function Portal(props: PropsWithChildren<PortalProps>): ReactPortal;
 export { Portal }
 export { Portal as Portal_alias_1 }
 
@@ -2718,6 +2765,36 @@ declare type ToggleProps = ToggleBase & ToggleVariantProps;
 export { ToggleProps }
 export { ToggleProps as ToggleProps_alias_1 }
 
+/**
+ * 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>
+ */
+declare function Tooltip(props: TooltipProps & TooltipContentProps): JSX_2.Element;
+export { Tooltip }
+export { Tooltip as Tooltip_alias_1 }
+
+/**
+ * This module contains the Tooltip component.
+ * @module Tooltip
+ */
+declare 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';
+}
+export { TooltipProps }
+export { TooltipProps as TooltipProps_alias_1 }
+
 export { TouchSensor }
 
 export { TouchSensorOptions }
@@ -2758,6 +2835,54 @@ declare function useCTAModal(): CTAModalValue;
 export { useCTAModal }
 export { useCTAModal as useCTAModal_alias_1 }
 
+/**
+ * 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} />
+ * }
+ */
+declare function useDate(options?: UseDateOptions): UseDateReturn;
+export { useDate }
+export { useDate as useDate_alias_1 }
+
+declare interface UseDateBase {
+    /**
+     * The format of the date input
+     */
+    format?: string;
+    /**
+     * The callback to run when the date input changes
+     */
+    onChange?: InputHTMLAttributes<HTMLInputElement>['onChange'];
+}
+export { UseDateBase }
+export { UseDateBase as UseDateBase_alias_1 }
+
+declare interface UseDateOptions extends UseDateBase {
+    /**
+     * The initial value of the date input
+     */
+    initialValue?: string;
+}
+export { UseDateOptions }
+export { UseDateOptions as UseDateOptions_alias_1 }
+
+declare interface UseDateReturn extends UseDateBase {
+    /**
+     * The ISO formatted date string
+     */
+    ISO: string;
+    /**
+     * The value of the date input
+     */
+    value: string;
+}
+export { UseDateReturn }
+export { UseDateReturn as UseDateReturn_alias_1 }
+
 export { useDndContext }
 
 export { UseDndContextReturnValue }
@@ -2825,6 +2950,8 @@ declare interface UseModalReturnValue {
      */
     isOpen: boolean;
 }
+export { UseModalReturnValue }
+export { UseModalReturnValue as UseModalReturnValue_alias_1 }
 
 /**
  * Used to access the nav menu context.

package/build/modern/{chunk-ZBMA5G54.js → chunk-7MM5KYEX.js}

@@ -7,12 +7,12 @@ import {
 import {
   FieldMessage
 } from "./chunk-JWIJHSI6.js";
-import {
-  Avatar
-} from "./chunk-SPZYPRZ6.js";
 import {
   Field
 } from "./chunk-UZDVOIW5.js";
+import {
+  Avatar
+} from "./chunk-SPZYPRZ6.js";
 import {
   $cerberusIcons
 } from "./chunk-VERRHMW4.js";
@@ -225,4 +225,4 @@ export {
   processStatus,
   FileStatus
 };
-//# sourceMappingURL=chunk-ZBMA5G54.js.map
+//# sourceMappingURL=chunk-7MM5KYEX.js.map

package/build/modern/chunk-CZND26FC.js

@@ -0,0 +1,98 @@
+// src/hooks/useDate.ts
+import {
+  useState,
+  useCallback,
+  useMemo
+} from "react";
+function useDate(options) {
+  const initialValue = options?.initialValue ?? "";
+  const format = options?.format ?? DateFormats.USMilitary;
+  const onChange = options?.onChange;
+  const [value, setValue] = useState(initialValue);
+  const handleChange = useCallback(
+    (e) => {
+      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]
+  );
+}
+function formatMilitaryToISO(input) {
+  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"
+  )}`;
+}
+function formatMilitaryDate(input) {
+  let formatted = input.toUpperCase().replace(/[^0-9A-Z]/g, "");
+  let day = "";
+  let month = "";
+  let year = "";
+  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);
+  }
+  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);
+  }
+  if (formatted.length > 0) {
+    year = formatted.slice(0, 4);
+  }
+  return [day, month, year].filter(Boolean).join(" ");
+}
+var DateFormats = {
+  get ISO() {
+    return "YYYY-MM-DD";
+  },
+  get USMilitary() {
+    return "DD MMM YYYY";
+  },
+  get Months() {
+    return MONTHS;
+  }
+};
+var MONTHS = [
+  "JAN",
+  "FEB",
+  "MAR",
+  "APR",
+  "MAY",
+  "JUN",
+  "JUL",
+  "AUG",
+  "SEP",
+  "OCT",
+  "NOV",
+  "DEC"
+];
+
+export {
+  useDate,
+  formatMilitaryToISO,
+  formatMilitaryDate,
+  DateFormats
+};
+//# sourceMappingURL=chunk-CZND26FC.js.map

package/build/modern/chunk-CZND26FC.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/hooks/useDate.ts"],"sourcesContent":["'use client'\n\nimport {\n  useState,\n  useCallback,\n  ChangeEvent,\n  useMemo,\n  type InputHTMLAttributes,\n} from 'react'\n\nexport interface UseDateBase {\n  /**\n   * The format of the date input\n   */\n  format?: string\n  /**\n   * The callback to run when the date input changes\n   */\n  onChange?: InputHTMLAttributes<HTMLInputElement>['onChange']\n}\n\nexport interface UseDateOptions extends UseDateBase {\n  /**\n   * The initial value of the date input\n   */\n  initialValue?: string\n}\n\nexport interface UseDateReturn extends UseDateBase {\n  /**\n   * The ISO formatted date string\n   */\n  ISO: string\n  /**\n   * The value of the date input\n   */\n  value: string\n}\n\n/**\n * A hook for formatting and validating date inputs. The date format defaults to US Military format.\n * @example\n * ```tsx\n * const MyComponent = () => {\n *  const date = useDate({ initialValue: '01 JAN 2024' })\n *  return <input onChange={date.onChange} type=\"text\" value={date.value} />\n * }\n */\nexport function useDate(options?: UseDateOptions): UseDateReturn {\n  const initialValue = options?.initialValue ?? ''\n  const format = options?.format ?? DateFormats.USMilitary\n  const onChange = options?.onChange\n  const [value, setValue] = useState(initialValue)\n\n  const handleChange = useCallback(\n    (e: ChangeEvent<HTMLInputElement>) => {\n      const newValue = formatMilitaryDate(e.currentTarget.value)\n      if (onChange) onChange(e)\n      setValue(newValue)\n    },\n    [onChange],\n  )\n\n  return useMemo(\n    () => ({\n      format,\n      value,\n      ISO: formatMilitaryToISO(value),\n      onChange: handleChange,\n    }),\n    [format, value, handleChange],\n  )\n}\n\n// helpers\n\n/**\n * Converts a string in US Military format to ISO format. Used within the `useDate` hook.\n * @param input The string to format\n * @returns The formatted string in ISO format (YYYY-MM-DD)\n */\nexport function formatMilitaryToISO(input: string) {\n  const [day, month, year] = input.split(' ')\n  const monthIndex = MONTHS.findIndex((m) => m.startsWith(month))\n  const monthNum = monthIndex + 1\n  return `${year ?? '0000'}-${monthNum.toString().padStart(2, '0')}-${day.padStart(\n    2,\n    '0',\n  )}`\n}\n\n/**\n * Converts a string to US Military format. Used within the `useDate` hook.\n * @param input The string to format\n * @returns The formatted string in US Military format (DD MMM YYYY)\n */\nexport function formatMilitaryDate(input: string): string {\n  let formatted = input.toUpperCase().replace(/[^0-9A-Z]/g, '')\n  let day = ''\n  let month = ''\n  let year = ''\n\n  // Format day\n  if (formatted.length >= 2) {\n    day = formatted.replace(/[^0-9]/g, '').slice(0, 2)\n    const dayNum = parseInt(day, 10)\n    if (dayNum > 31) day = '31'\n    else if (dayNum === 0) day = '01'\n    formatted = formatted.slice(2)\n  }\n\n  // Format month\n  if (formatted.length >= 3) {\n    month = formatted.slice(0, 3)\n    const monthIndex = MONTHS.findIndex((m) => m.startsWith(month))\n    if (monthIndex !== -1) {\n      month = MONTHS[monthIndex]\n    } else {\n      month = month.replace(/[^A-Z]/g, '')\n    }\n    formatted = formatted.slice(3)\n  }\n\n  // Format year\n  if (formatted.length > 0) {\n    year = formatted.slice(0, 4)\n  }\n\n  return [day, month, year].filter(Boolean).join(' ')\n}\n\n/**\n * Date formatting options\n * @example\n * ```tsx\n * const date = new Date()\n * const formatted = date.format(DateFormats.USMilitary)\n */\nexport const DateFormats = {\n  get ISO() {\n    return 'YYYY-MM-DD'\n  },\n  get USMilitary() {\n    return 'DD MMM YYYY'\n  },\n  get Months() {\n    return MONTHS\n  },\n}\n\nconst MONTHS = [\n  'JAN',\n  'FEB',\n  'MAR',\n  'APR',\n  'MAY',\n  'JUN',\n  'JUL',\n  'AUG',\n  'SEP',\n  'OCT',\n  'NOV',\n  'DEC',\n]\n"],"mappings":";AAEA;AAAA,EACE;AAAA,EACA;AAAA,EAEA;AAAA,OAEK;AAwCA,SAAS,QAAQ,SAAyC;AAC/D,QAAM,eAAe,SAAS,gBAAgB;AAC9C,QAAM,SAAS,SAAS,UAAU,YAAY;AAC9C,QAAM,WAAW,SAAS;AAC1B,QAAM,CAAC,OAAO,QAAQ,IAAI,SAAS,YAAY;AAE/C,QAAM,eAAe;AAAA,IACnB,CAAC,MAAqC;AACpC,YAAM,WAAW,mBAAmB,EAAE,cAAc,KAAK;AACzD,UAAI,SAAU,UAAS,CAAC;AACxB,eAAS,QAAQ;AAAA,IACnB;AAAA,IACA,CAAC,QAAQ;AAAA,EACX;AAEA,SAAO;AAAA,IACL,OAAO;AAAA,MACL;AAAA,MACA;AAAA,MACA,KAAK,oBAAoB,KAAK;AAAA,MAC9B,UAAU;AAAA,IACZ;AAAA,IACA,CAAC,QAAQ,OAAO,YAAY;AAAA,EAC9B;AACF;AASO,SAAS,oBAAoB,OAAe;AACjD,QAAM,CAAC,KAAK,OAAO,IAAI,IAAI,MAAM,MAAM,GAAG;AAC1C,QAAM,aAAa,OAAO,UAAU,CAAC,MAAM,EAAE,WAAW,KAAK,CAAC;AAC9D,QAAM,WAAW,aAAa;AAC9B,SAAO,GAAG,QAAQ,MAAM,IAAI,SAAS,SAAS,EAAE,SAAS,GAAG,GAAG,CAAC,IAAI,IAAI;AAAA,IACtE;AAAA,IACA;AAAA,EACF,CAAC;AACH;AAOO,SAAS,mBAAmB,OAAuB;AACxD,MAAI,YAAY,MAAM,YAAY,EAAE,QAAQ,cAAc,EAAE;AAC5D,MAAI,MAAM;AACV,MAAI,QAAQ;AACZ,MAAI,OAAO;AAGX,MAAI,UAAU,UAAU,GAAG;AACzB,UAAM,UAAU,QAAQ,WAAW,EAAE,EAAE,MAAM,GAAG,CAAC;AACjD,UAAM,SAAS,SAAS,KAAK,EAAE;AAC/B,QAAI,SAAS,GAAI,OAAM;AAAA,aACd,WAAW,EAAG,OAAM;AAC7B,gBAAY,UAAU,MAAM,CAAC;AAAA,EAC/B;AAGA,MAAI,UAAU,UAAU,GAAG;AACzB,YAAQ,UAAU,MAAM,GAAG,CAAC;AAC5B,UAAM,aAAa,OAAO,UAAU,CAAC,MAAM,EAAE,WAAW,KAAK,CAAC;AAC9D,QAAI,eAAe,IAAI;AACrB,cAAQ,OAAO,UAAU;AAAA,IAC3B,OAAO;AACL,cAAQ,MAAM,QAAQ,WAAW,EAAE;AAAA,IACrC;AACA,gBAAY,UAAU,MAAM,CAAC;AAAA,EAC/B;AAGA,MAAI,UAAU,SAAS,GAAG;AACxB,WAAO,UAAU,MAAM,GAAG,CAAC;AAAA,EAC7B;AAEA,SAAO,CAAC,KAAK,OAAO,IAAI,EAAE,OAAO,OAAO,EAAE,KAAK,GAAG;AACpD;AASO,IAAM,cAAc;AAAA,EACzB,IAAI,MAAM;AACR,WAAO;AAAA,EACT;AAAA,EACA,IAAI,aAAa;AACf,WAAO;AAAA,EACT;AAAA,EACA,IAAI,SAAS;AACX,WAAO;AAAA,EACT;AACF;AAEA,IAAM,SAAS;AAAA,EACb;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;","names":[]}

package/build/modern/{chunk-T6LS5P5W.js → chunk-J4LOSTEP.js}

@@ -1,39 +1,39 @@
+import {
+  Portal
+} from "./chunk-K2PSHGS7.js";
+import {
+  ModalHeader
+} from "./chunk-ZFAIE47A.js";
 import {
   ModalHeading
 } from "./chunk-2UXE5PDG.js";
-import {
-  Portal
-} from "./chunk-GLY7GU5S.js";
 import {
   Modal
 } from "./chunk-BE4EOU2P.js";
 import {
   ModalDescription
 } from "./chunk-Q7BRMIBR.js";
-import {
-  ModalHeader
-} from "./chunk-ZFAIE47A.js";
 import {
   IconButton
 } from "./chunk-APD6IX5R.js";
+import {
+  useModal
+} from "./chunk-KGQG5JGW.js";
 import {
   Avatar
 } from "./chunk-SPZYPRZ6.js";
-import {
-  Button
-} from "./chunk-EXGKZGML.js";
 import {
   Show
 } from "./chunk-BUVVRQLZ.js";
+import {
+  Button
+} from "./chunk-EXGKZGML.js";
 import {
   trapFocus
 } from "./chunk-JIZQFTW6.js";
 import {
   $cerberusIcons
 } from "./chunk-VERRHMW4.js";
-import {
-  useModal
-} from "./chunk-7T3JIGM7.js";
 
 // src/context/cta-modal.tsx
 import {
@@ -152,4 +152,4 @@ export {
   CTAModal,
   useCTAModal
 };
-//# sourceMappingURL=chunk-T6LS5P5W.js.map
+//# sourceMappingURL=chunk-J4LOSTEP.js.map

package/build/modern/chunk-K2PSHGS7.js

@@ -0,0 +1,11 @@
+// src/components/Portal.tsx
+import { createPortal } from "react-dom";
+function Portal(props) {
+  const container = props.container || document.body;
+  return createPortal(props.children, container, props.key);
+}
+
+export {
+  Portal
+};
+//# sourceMappingURL=chunk-K2PSHGS7.js.map

package/build/modern/chunk-K2PSHGS7.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/components/Portal.tsx"],"sourcesContent":["'use client'\n\nimport type { PropsWithChildren } from 'react'\nimport { createPortal } from 'react-dom'\n\n/**\n * This module is the Portal component.\n * @module\n */\n\nexport interface PortalProps {\n  /**\n   * The root container to render the children into.\n   * @default document.body\n   */\n  container?: Element | DocumentFragment\n  /**\n   * An optional key to use for the Portal component.\n   */\n  key?: null | string\n}\n\n/**\n * The Portal component is used to render children into a DOM node that exists outside the DOM hierarchy of the parent component.\n * @see https://cerberus.digitalu.design/react/portal\n * @definition [React Portal Docs](https://react.dev/reference/react-dom/createPortal)\n * @example\n * ```tsx\n * 'use client'\n *\n * import { Portal } from '@cerberus/react'\n *\n * function SomeFeatureWithinSSRPage() {\n *   return (\n *     <Portal>\n *       <div>Portal Content outside of the React VDom tree</div>\n *     </Portal>\n *   )\n * }\n */\nexport function Portal(props: PropsWithChildren<PortalProps>) {\n  const container = props.container || document.body\n  return createPortal(props.children, container, props.key)\n}\n"],"mappings":";AAGA,SAAS,oBAAoB;AAqCtB,SAAS,OAAO,OAAuC;AAC5D,QAAM,YAAY,MAAM,aAAa,SAAS;AAC9C,SAAO,aAAa,MAAM,UAAU,WAAW,MAAM,GAAG;AAC1D;","names":[]}

package/build/modern/{chunk-CSEHDNMJ.js → chunk-KFGI37CO.js}

@@ -1,9 +1,12 @@
+import {
+  Portal
+} from "./chunk-K2PSHGS7.js";
+import {
+  ModalHeader
+} from "./chunk-ZFAIE47A.js";
 import {
   ModalHeading
 } from "./chunk-2UXE5PDG.js";
-import {
-  Portal
-} from "./chunk-GLY7GU5S.js";
 import {
   Modal
 } from "./chunk-BE4EOU2P.js";
@@ -11,26 +14,23 @@ import {
   ModalDescription
 } from "./chunk-Q7BRMIBR.js";
 import {
-  ModalHeader
-} from "./chunk-ZFAIE47A.js";
+  useModal
+} from "./chunk-KGQG5JGW.js";
 import {
   Avatar
 } from "./chunk-SPZYPRZ6.js";
-import {
-  Button
-} from "./chunk-EXGKZGML.js";
 import {
   Show
 } from "./chunk-BUVVRQLZ.js";
+import {
+  Button
+} from "./chunk-EXGKZGML.js";
 import {
   trapFocus
 } from "./chunk-JIZQFTW6.js";
 import {
   $cerberusIcons
 } from "./chunk-VERRHMW4.js";
-import {
-  useModal
-} from "./chunk-7T3JIGM7.js";
 
 // src/context/confirm-modal.tsx
 import {
@@ -176,4 +176,4 @@ export {
   ConfirmModal,
   useConfirmModal
 };
-//# sourceMappingURL=chunk-CSEHDNMJ.js.map
+//# sourceMappingURL=chunk-KFGI37CO.js.map

package/build/modern/{chunk-7T3JIGM7.js → chunk-KGQG5JGW.js}

@@ -24,4 +24,4 @@ function useModal() {
 export {
   useModal
 };
-//# sourceMappingURL=chunk-7T3JIGM7.js.map
+//# sourceMappingURL=chunk-KGQG5JGW.js.map

package/build/modern/chunk-KGQG5JGW.js.map

@@ -0,0 +1 @@
+{"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\nexport interface 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":[]}

package/build/modern/chunk-KML4CTMK.js

@@ -0,0 +1,33 @@
+// src/components/Tooltip.tsx
+import {
+  Tooltip as ArkTooltip
+} from "@ark-ui/react/tooltip";
+import { cx } from "@cerberus/styled-system/css";
+import { tooltip } from "@cerberus/styled-system/recipes";
+import { jsx, jsxs } from "react/jsx-runtime";
+function Tooltip(props) {
+  const { content, children, ...nativeProps } = props;
+  const styles = tooltip();
+  const position = {
+    placement: props.position || "top"
+  };
+  return /* @__PURE__ */ jsxs(ArkTooltip.Root, { openDelay: 400, positioning: position, children: [
+    /* @__PURE__ */ jsx(ArkTooltip.Trigger, { className: styles.trigger, children }),
+    /* @__PURE__ */ jsx(ArkTooltip.Positioner, { children: /* @__PURE__ */ jsxs(
+      ArkTooltip.Content,
+      {
+        ...nativeProps,
+        className: cx(nativeProps.className, styles.content),
+        children: [
+          /* @__PURE__ */ jsx(ArkTooltip.Arrow, { className: styles.arrow, children: /* @__PURE__ */ jsx(ArkTooltip.ArrowTip, { className: styles.arrowTip }) }),
+          content
+        ]
+      }
+    ) })
+  ] });
+}
+
+export {
+  Tooltip
+};
+//# sourceMappingURL=chunk-KML4CTMK.js.map

package/build/modern/chunk-KML4CTMK.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/components/Tooltip.tsx"],"sourcesContent":["import {\n  Tooltip as ArkTooltip,\n  type TooltipContentProps,\n} from '@ark-ui/react/tooltip'\nimport { cx } from '@cerberus/styled-system/css'\nimport { tooltip } from '@cerberus/styled-system/recipes'\nimport type { ReactNode } from 'react'\n\n/**\n * This module contains the Tooltip component.\n * @module Tooltip\n */\n\nexport interface TooltipProps {\n  /**\n   * The text content to display in the tooltip.\n   */\n  content: ReactNode\n  /**\n   * The position of the tooltip relative to the trigger element.\n   */\n  position?: 'top' | 'right' | 'bottom' | 'left'\n}\n\n/**\n * The Tooltip component is used to provide additional information about an element when it is hovered over.\n * @definition [Tooltip docs](https://cerberus.digitalu.design/react/tooltip)\n * @example\n * ```tsx\n * <Tooltip content=\"This is a tooltip\">\n *   <Information />\n * </Tooltip>\n */\nexport function Tooltip(props: TooltipProps & TooltipContentProps) {\n  const { content, children, ...nativeProps } = props\n  const styles = tooltip()\n  const position = {\n    placement: props.position || 'top',\n  }\n\n  return (\n    <ArkTooltip.Root openDelay={400} positioning={position}>\n      <ArkTooltip.Trigger className={styles.trigger}>\n        {children}\n      </ArkTooltip.Trigger>\n\n      <ArkTooltip.Positioner>\n        <ArkTooltip.Content\n          {...nativeProps}\n          className={cx(nativeProps.className, styles.content)}\n        >\n          <ArkTooltip.Arrow className={styles.arrow}>\n            <ArkTooltip.ArrowTip className={styles.arrowTip} />\n          </ArkTooltip.Arrow>\n\n          {content}\n        </ArkTooltip.Content>\n      </ArkTooltip.Positioner>\n    </ArkTooltip.Root>\n  )\n}\n"],"mappings":";AAAA;AAAA,EACE,WAAW;AAAA,OAEN;AACP,SAAS,UAAU;AACnB,SAAS,eAAe;AAqClB,cAKE,YALF;AATC,SAAS,QAAQ,OAA2C;AACjE,QAAM,EAAE,SAAS,UAAU,GAAG,YAAY,IAAI;AAC9C,QAAM,SAAS,QAAQ;AACvB,QAAM,WAAW;AAAA,IACf,WAAW,MAAM,YAAY;AAAA,EAC/B;AAEA,SACE,qBAAC,WAAW,MAAX,EAAgB,WAAW,KAAK,aAAa,UAC5C;AAAA,wBAAC,WAAW,SAAX,EAAmB,WAAW,OAAO,SACnC,UACH;AAAA,IAEA,oBAAC,WAAW,YAAX,EACC;AAAA,MAAC,WAAW;AAAA,MAAX;AAAA,QACE,GAAG;AAAA,QACJ,WAAW,GAAG,YAAY,WAAW,OAAO,OAAO;AAAA,QAEnD;AAAA,8BAAC,WAAW,OAAX,EAAiB,WAAW,OAAO,OAClC,8BAAC,WAAW,UAAX,EAAoB,WAAW,OAAO,UAAU,GACnD;AAAA,UAEC;AAAA;AAAA;AAAA,IACH,GACF;AAAA,KACF;AAEJ;","names":[]}

package/build/modern/{chunk-5OSUZUR4.js → chunk-KUT2YEEQ.js}

@@ -1,3 +1,6 @@
+import {
+  Portal
+} from "./chunk-K2PSHGS7.js";
 import {
   Notification
 } from "./chunk-7SGPJM66.js";
@@ -8,14 +11,11 @@ import {
   NotificationHeading
 } from "./chunk-SXIXDXG3.js";
 import {
-  Portal
-} from "./chunk-GLY7GU5S.js";
+  Show
+} from "./chunk-BUVVRQLZ.js";
 import {
   Button
 } from "./chunk-EXGKZGML.js";
-import {
-  Show
-} from "./chunk-BUVVRQLZ.js";
 
 // src/context/notification-center.tsx
 import {
@@ -72,7 +72,7 @@ function NotificationCenter(props) {
           palette: "action",
           shape: "rounded",
           size: "sm",
-          usage: "text",
+          usage: "ghost",
           children: "Close all"
         }
       ) }),
@@ -159,4 +159,4 @@ export {
   NotificationCenter,
   useNotificationCenter
 };
-//# sourceMappingURL=chunk-5OSUZUR4.js.map
+//# sourceMappingURL=chunk-KUT2YEEQ.js.map

package/build/modern/chunk-KUT2YEEQ.js.map

@@ -0,0 +1 @@
+{"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=\"ghost\"\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-VP5ERLAY.js → chunk-NCUHRVW2.js}

@@ -1,9 +1,12 @@
+import {
+  Portal
+} from "./chunk-K2PSHGS7.js";
+import {
+  ModalHeader
+} from "./chunk-ZFAIE47A.js";
 import {
   ModalHeading
 } from "./chunk-2UXE5PDG.js";
-import {
-  Portal
-} from "./chunk-GLY7GU5S.js";
 import {
   Input
 } from "./chunk-NKM6PISB.js";
@@ -17,29 +20,26 @@ import {
   ModalDescription
 } from "./chunk-Q7BRMIBR.js";
 import {
-  ModalHeader
-} from "./chunk-ZFAIE47A.js";
+  Field
+} from "./chunk-UZDVOIW5.js";
+import {
+  useModal
+} from "./chunk-KGQG5JGW.js";
 import {
   Avatar
 } from "./chunk-SPZYPRZ6.js";
-import {
-  Button
-} from "./chunk-EXGKZGML.js";
-import {
-  Field
-} from "./chunk-UZDVOIW5.js";
 import {
   Show
 } from "./chunk-BUVVRQLZ.js";
+import {
+  Button
+} from "./chunk-EXGKZGML.js";
 import {
   trapFocus
 } from "./chunk-JIZQFTW6.js";
 import {
   $cerberusIcons
 } from "./chunk-VERRHMW4.js";
-import {
-  useModal
-} from "./chunk-7T3JIGM7.js";
 
 // src/context/prompt-modal.tsx
 import {
@@ -240,4 +240,4 @@ export {
   PromptModal,
   usePromptModal
 };
-//# sourceMappingURL=chunk-VP5ERLAY.js.map
+//# sourceMappingURL=chunk-NCUHRVW2.js.map

package/build/modern/components/FileStatus.js

@@ -2,12 +2,12 @@
 import {
   FileStatus,
   processStatus
-} from "../chunk-ZBMA5G54.js";
+} from "../chunk-7MM5KYEX.js";
 import "../chunk-KCANMM64.js";
 import "../chunk-APD6IX5R.js";
 import "../chunk-JWIJHSI6.js";
-import "../chunk-SPZYPRZ6.js";
 import "../chunk-UZDVOIW5.js";
+import "../chunk-SPZYPRZ6.js";
 import "../chunk-BUVVRQLZ.js";
 import "../chunk-VERRHMW4.js";
 import "../chunk-F27AAKQ3.js";

package/build/modern/components/Portal.js

@@ -1,6 +1,7 @@
+"use client";
 import {
   Portal
-} from "../chunk-GLY7GU5S.js";
+} from "../chunk-K2PSHGS7.js";
 export {
   Portal
 };

package/build/modern/components/Tooltip.js

@@ -0,0 +1,7 @@
+import {
+  Tooltip
+} from "../chunk-KML4CTMK.js";
+export {
+  Tooltip
+};
+//# sourceMappingURL=Tooltip.js.map

package/build/modern/components/Tooltip.js.map

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