@gusto/embedded-react-sdk 0.46.3 → 0.47.0

package/dist/components/Common/UI/FileInput/FileInputTypes.d.ts

@@ -1,4 +1,10 @@
 import { SharedFieldLayoutProps } from '../../FieldLayout/FieldLayoutTypes';
+/**
+ * Props your `FileInput` implementation must accept from the component adapter.
+ * Renders a form field wrapping an `<input type="file" />` with a label, description, error message, and optional file type restrictions.
+ *
+ * @public
+ */
 export interface FileInputProps extends Omit<SharedFieldLayoutProps, 'shouldVisuallyHideLabel'> {
     /**
      * ID for the file input element
@@ -24,10 +30,12 @@ export interface FileInputProps extends Omit<SharedFieldLayoutProps, 'shouldVisu
     accept?: string[];
     /**
      * Indicates that the field has an error
+     * @defaultValue `false`
      */
     isInvalid?: boolean;
     /**
      * Disables the input and prevents interaction
+     * @defaultValue `false`
      */
     isDisabled?: boolean;
     /**
@@ -39,6 +47,11 @@ export interface FileInputProps extends Omit<SharedFieldLayoutProps, 'shouldVisu
      */
     'aria-describedby'?: string;
 }
+/**
+ * Default prop values for the FileInput component.
+ *
+ * @internal
+ */
 export declare const FileInputDefaults: {
     readonly isInvalid: false;
     readonly isDisabled: false;

package/dist/components/Common/UI/FileInput/FileInputTypes.js.map

@@ -1 +1 @@
-{"version":3,"file":"FileInputTypes.js","sources":["../../../../../src/components/Common/UI/FileInput/FileInputTypes.ts"],"sourcesContent":["import type { SharedFieldLayoutProps } from '@/components/Common/FieldLayout/FieldLayoutTypes'\n\nexport interface FileInputProps extends Omit<SharedFieldLayoutProps, 'shouldVisuallyHideLabel'> {\n  /**\n   * ID for the file input element\n   */\n  id?: string\n  /**\n   * Currently selected file\n   */\n  value: File | null\n  /**\n   * Callback when file selection changes\n   */\n  onChange: (file: File | null) => void\n  /**\n   * Handler for blur events\n   */\n  onBlur?: () => void\n  /**\n   * Accepted file types (MIME types or extensions)\n   * @example ['image/jpeg', 'image/png', 'application/pdf']\n   * @example ['.jpg', '.png', '.pdf']\n   */\n  accept?: string[]\n  /**\n   * Indicates that the field has an error\n   */\n  isInvalid?: boolean\n  /**\n   * Disables the input and prevents interaction\n   */\n  isDisabled?: boolean\n  /**\n   * Additional CSS class name\n   */\n  className?: string\n  /**\n   * Aria-describedby attribute for accessibility\n   */\n  'aria-describedby'?: string\n}\n\nexport const FileInputDefaults = {\n  isInvalid: false,\n  isDisabled: false,\n} as const satisfies Partial<FileInputProps>\n"],"names":["FileInputDefaults"],"mappings":"AA2CO,MAAMA,IAAoB;AAAA,EAC/B,WAAW;AAAA,EACX,YAAY;AACd;"}
+{"version":3,"file":"FileInputTypes.js","sources":["../../../../../src/components/Common/UI/FileInput/FileInputTypes.ts"],"sourcesContent":["import type { SharedFieldLayoutProps } from '@/components/Common/FieldLayout/FieldLayoutTypes'\n\n/**\n * Props your `FileInput` implementation must accept from the component adapter.\n * Renders a form field wrapping an `<input type=\"file\" />` with a label, description, error message, and optional file type restrictions.\n *\n * @public\n */\nexport interface FileInputProps extends Omit<SharedFieldLayoutProps, 'shouldVisuallyHideLabel'> {\n  /**\n   * ID for the file input element\n   */\n  id?: string\n  /**\n   * Currently selected file\n   */\n  value: File | null\n  /**\n   * Callback when file selection changes\n   */\n  onChange: (file: File | null) => void\n  /**\n   * Handler for blur events\n   */\n  onBlur?: () => void\n  /**\n   * Accepted file types (MIME types or extensions)\n   * @example ['image/jpeg', 'image/png', 'application/pdf']\n   * @example ['.jpg', '.png', '.pdf']\n   */\n  accept?: string[]\n  /**\n   * Indicates that the field has an error\n   * @defaultValue `false`\n   */\n  isInvalid?: boolean\n  /**\n   * Disables the input and prevents interaction\n   * @defaultValue `false`\n   */\n  isDisabled?: boolean\n  /**\n   * Additional CSS class name\n   */\n  className?: string\n  /**\n   * Aria-describedby attribute for accessibility\n   */\n  'aria-describedby'?: string\n}\n\n/**\n * Default prop values for the FileInput component.\n *\n * @internal\n */\nexport const FileInputDefaults = {\n  isInvalid: false,\n  isDisabled: false,\n} as const satisfies Partial<FileInputProps>\n"],"names":["FileInputDefaults"],"mappings":"AAwDO,MAAMA,IAAoB;AAAA,EAC/B,WAAW;AAAA,EACX,YAAY;AACd;"}

package/dist/components/Common/UI/FileInput/index.d.ts

@@ -1,4 +1,2 @@
 import "./types/i18next.d.ts"
 export { FileInput } from './FileInput';
-export type { FileInputProps } from './FileInputTypes';
-export { FileInputDefaults } from './FileInputTypes';

package/dist/components/Common/UI/Heading/Heading.d.ts

@@ -1,2 +1,15 @@
 import { HeadingProps } from './HeadingTypes';
-export declare const Heading: ({ as: Component, styledAs, textAlign, className, children, id, }: HeadingProps) => import("react/jsx-runtime").JSX.Element;
+/**
+ * Semantic heading element (h1–h6) with optional independent visual styling.
+ *
+ * @remarks
+ * The `as` prop chooses the semantic heading level for accessibility and document
+ * outline; the optional `styledAs` prop applies a different visual size without
+ * changing the rendered tag. Use this when you need an h2 for document structure
+ * but want it to look like an h1, for example.
+ *
+ * @param props - Heading configuration including the semantic level, optional visual styling, alignment, and content.
+ * @returns The rendered heading element.
+ * @internal
+ */
+export declare const Heading: ({ as: Component, styledAs, textAlign, className, children, id, }: HeadingProps) => import("react").JSX.Element;

package/dist/components/Common/UI/Heading/Heading.js.map

@@ -1 +1 @@
-{"version":3,"file":"Heading.js","sources":["../../../../../src/components/Common/UI/Heading/Heading.tsx"],"sourcesContent":["import classNames from 'classnames'\nimport type { HeadingProps } from './HeadingTypes'\nimport styles from './Heading.module.scss'\n\nexport const Heading = ({\n  as: Component,\n  styledAs,\n  textAlign,\n  className,\n  children,\n  id,\n}: HeadingProps) => {\n  const levelStyles = styledAs ?? Component\n\n  return (\n    <Component\n      id={id}\n      className={classNames(\n        className,\n        styles.root,\n        styles[levelStyles as string],\n        styles[`textAlign-${textAlign}`],\n      )}\n    >\n      {children}\n    </Component>\n  )\n}\n"],"names":["Heading","Component","styledAs","textAlign","className","children","id","levelStyles","jsx","classNames","styles"],"mappings":";;;AAIO,MAAMA,IAAU,CAAC;AAAA,EACtB,IAAIC;AAAA,EACJ,UAAAC;AAAA,EACA,WAAAC;AAAA,EACA,WAAAC;AAAA,EACA,UAAAC;AAAA,EACA,IAAAC;AACF,MAAoB;AAClB,QAAMC,IAAcL,KAAYD;AAEhC,SACE,gBAAAO;AAAA,IAACP;AAAA,IAAA;AAAA,MACC,IAAAK;AAAA,MACA,WAAWG;AAAA,QACTL;AAAA,QACAM,EAAO;AAAA,QACPA,EAAOH,CAAqB;AAAA,QAC5BG,EAAO,aAAaP,CAAS,EAAE;AAAA,MAAA;AAAA,MAGhC,UAAAE;AAAA,IAAA;AAAA,EAAA;AAGP;"}
+{"version":3,"file":"Heading.js","sources":["../../../../../src/components/Common/UI/Heading/Heading.tsx"],"sourcesContent":["import classNames from 'classnames'\nimport type { HeadingProps } from './HeadingTypes'\nimport styles from './Heading.module.scss'\n\n/**\n * Semantic heading element (h1–h6) with optional independent visual styling.\n *\n * @remarks\n * The `as` prop chooses the semantic heading level for accessibility and document\n * outline; the optional `styledAs` prop applies a different visual size without\n * changing the rendered tag. Use this when you need an h2 for document structure\n * but want it to look like an h1, for example.\n *\n * @param props - Heading configuration including the semantic level, optional visual styling, alignment, and content.\n * @returns The rendered heading element.\n * @internal\n */\nexport const Heading = ({\n  as: Component,\n  styledAs,\n  textAlign,\n  className,\n  children,\n  id,\n}: HeadingProps) => {\n  const levelStyles = styledAs ?? Component\n\n  return (\n    <Component\n      id={id}\n      className={classNames(\n        className,\n        styles.root,\n        styles[levelStyles as string],\n        styles[`textAlign-${textAlign}`],\n      )}\n    >\n      {children}\n    </Component>\n  )\n}\n"],"names":["Heading","Component","styledAs","textAlign","className","children","id","levelStyles","jsx","classNames","styles"],"mappings":";;;AAiBO,MAAMA,IAAU,CAAC;AAAA,EACtB,IAAIC;AAAA,EACJ,UAAAC;AAAA,EACA,WAAAC;AAAA,EACA,WAAAC;AAAA,EACA,UAAAC;AAAA,EACA,IAAAC;AACF,MAAoB;AAClB,QAAMC,IAAcL,KAAYD;AAEhC,SACE,gBAAAO;AAAA,IAACP;AAAA,IAAA;AAAA,MACC,IAAAK;AAAA,MACA,WAAWG;AAAA,QACTL;AAAA,QACAM,EAAO;AAAA,QACPA,EAAOH,CAAqB;AAAA,QAC5BG,EAAO,aAAaP,CAAS,EAAE;AAAA,MAAA;AAAA,MAGhC,UAAAE;AAAA,IAAA;AAAA,EAAA;AAGP;"}

package/dist/components/Common/UI/Heading/HeadingTypes.d.ts

@@ -1,4 +1,10 @@
 import { HTMLAttributes, ReactNode } from 'react';
+/**
+ * Props your `Heading` implementation must accept from the component adapter.
+ * Renders an HTML heading (`<h1>`–`<h6>`) whose visual style level is controlled independently from its semantic level.
+ *
+ * @public
+ */
 export interface HeadingProps extends Pick<HTMLAttributes<HTMLHeadingElement>, 'className' | 'id'> {
     /**
      * The HTML heading element to render (h1-h6)

package/dist/components/Common/UI/Heading/index.d.ts

@@ -1,3 +1,2 @@
 import "./types/i18next.d.ts"
 export { Heading } from './Heading';
-export type { HeadingProps } from './HeadingTypes';

package/dist/components/Common/UI/Input/Input.d.ts

@@ -1,2 +1,11 @@
 import { InputProps } from './InputTypes';
-export declare function Input(rawProps: InputProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Low-level text input primitive with optional start and end adornments.
+ *
+ * @remarks
+ * The building block used by higher-level field components such as TextInput
+ * and NumberInput. Most consumers should reach for those instead.
+ *
+ * @internal
+ */
+export declare function Input(rawProps: InputProps): import("react").JSX.Element;

package/dist/components/Common/UI/Input/Input.js.map

@@ -1 +1 @@
-{"version":3,"file":"Input.js","sources":["../../../../../src/components/Common/UI/Input/Input.tsx"],"sourcesContent":["import { Input as AriaInput } from 'react-aria-components'\nimport classNames from 'classnames'\nimport styles from './Input.module.scss'\nimport type { InputProps } from './InputTypes'\nimport { InputDefaults } from './InputTypes'\nimport { applyMissingDefaults } from '@/helpers/applyMissingDefaults'\nimport AlertCircle from '@/assets/icons/alert-circle.svg?react'\n\nexport function Input(rawProps: InputProps) {\n  const resolvedProps = applyMissingDefaults(rawProps, InputDefaults)\n  const {\n    className,\n    adornmentStart,\n    adornmentEnd,\n    inputRef,\n    isDisabled,\n    'aria-invalid': ariaInvalid,\n    ...otherProps\n  } = resolvedProps\n\n  return (\n    <div\n      className={classNames(\n        styles.container,\n        {\n          [styles.hasAdornmentStart as string]: !!adornmentStart,\n          [styles.hasAdornmentEnd as string]: !!adornmentEnd,\n        },\n        className,\n      )}\n      data-disabled={isDisabled}\n    >\n      {adornmentStart && <div className={styles.adornmentStart}>{adornmentStart}</div>}\n      <div className={styles.inputContainer}>\n        <AriaInput\n          ref={inputRef}\n          disabled={isDisabled}\n          aria-invalid={ariaInvalid}\n          {...otherProps}\n        />\n        <div className={styles.invalidIcon}>\n          <AlertCircle fontSize={16} />\n        </div>\n      </div>\n      {adornmentEnd && <div className={styles.adornmentEnd}>{adornmentEnd}</div>}\n    </div>\n  )\n}\n"],"names":["Input","rawProps","resolvedProps","applyMissingDefaults","InputDefaults","className","adornmentStart","adornmentEnd","inputRef","isDisabled","ariaInvalid","otherProps","jsxs","classNames","styles","jsx","AriaInput","AlertCircle"],"mappings":";;;;;;;AAQO,SAASA,EAAMC,GAAsB;AAC1C,QAAMC,IAAgBC,EAAqBF,GAAUG,CAAa,GAC5D;AAAA,IACJ,WAAAC;AAAA,IACA,gBAAAC;AAAA,IACA,cAAAC;AAAA,IACA,UAAAC;AAAA,IACA,YAAAC;AAAA,IACA,gBAAgBC;AAAA,IAChB,GAAGC;AAAA,EAAA,IACDT;AAEJ,SACE,gBAAAU;AAAA,IAAC;AAAA,IAAA;AAAA,MACC,WAAWC;AAAA,QACTC,EAAO;AAAA,QACP;AAAA,UACE,CAACA,EAAO,iBAA2B,GAAG,CAAC,CAACR;AAAA,UACxC,CAACQ,EAAO,eAAyB,GAAG,CAAC,CAACP;AAAA,QAAA;AAAA,QAExCF;AAAA,MAAA;AAAA,MAEF,iBAAeI;AAAA,MAEd,UAAA;AAAA,QAAAH,KAAkB,gBAAAS,EAAC,OAAA,EAAI,WAAWD,EAAO,gBAAiB,UAAAR,GAAe;AAAA,QAC1E,gBAAAM,EAAC,OAAA,EAAI,WAAWE,EAAO,gBACrB,UAAA;AAAA,UAAA,gBAAAC;AAAA,YAACC;AAAAA,YAAA;AAAA,cACC,KAAKR;AAAA,cACL,UAAUC;AAAA,cACV,gBAAcC;AAAA,cACb,GAAGC;AAAA,YAAA;AAAA,UAAA;AAAA,UAEN,gBAAAI,EAAC,SAAI,WAAWD,EAAO,aACrB,UAAA,gBAAAC,EAACE,GAAA,EAAY,UAAU,GAAA,CAAI,EAAA,CAC7B;AAAA,QAAA,GACF;AAAA,QACCV,KAAgB,gBAAAQ,EAAC,OAAA,EAAI,WAAWD,EAAO,cAAe,UAAAP,EAAA,CAAa;AAAA,MAAA;AAAA,IAAA;AAAA,EAAA;AAG1E;"}
+{"version":3,"file":"Input.js","sources":["../../../../../src/components/Common/UI/Input/Input.tsx"],"sourcesContent":["import { Input as AriaInput } from 'react-aria-components'\nimport classNames from 'classnames'\nimport styles from './Input.module.scss'\nimport type { InputProps } from './InputTypes'\nimport { InputDefaults } from './InputTypes'\nimport { applyMissingDefaults } from '@/helpers/applyMissingDefaults'\nimport AlertCircle from '@/assets/icons/alert-circle.svg?react'\n\n/**\n * Low-level text input primitive with optional start and end adornments.\n *\n * @remarks\n * The building block used by higher-level field components such as TextInput\n * and NumberInput. Most consumers should reach for those instead.\n *\n * @internal\n */\nexport function Input(rawProps: InputProps) {\n  const resolvedProps = applyMissingDefaults(rawProps, InputDefaults)\n  const {\n    className,\n    adornmentStart,\n    adornmentEnd,\n    inputRef,\n    isDisabled,\n    'aria-invalid': ariaInvalid,\n    ...otherProps\n  } = resolvedProps\n\n  return (\n    <div\n      className={classNames(\n        styles.container,\n        {\n          [styles.hasAdornmentStart as string]: !!adornmentStart,\n          [styles.hasAdornmentEnd as string]: !!adornmentEnd,\n        },\n        className,\n      )}\n      data-disabled={isDisabled}\n    >\n      {adornmentStart && <div className={styles.adornmentStart}>{adornmentStart}</div>}\n      <div className={styles.inputContainer}>\n        <AriaInput\n          ref={inputRef}\n          disabled={isDisabled}\n          aria-invalid={ariaInvalid}\n          {...otherProps}\n        />\n        <div className={styles.invalidIcon}>\n          <AlertCircle fontSize={16} />\n        </div>\n      </div>\n      {adornmentEnd && <div className={styles.adornmentEnd}>{adornmentEnd}</div>}\n    </div>\n  )\n}\n"],"names":["Input","rawProps","resolvedProps","applyMissingDefaults","InputDefaults","className","adornmentStart","adornmentEnd","inputRef","isDisabled","ariaInvalid","otherProps","jsxs","classNames","styles","jsx","AriaInput","AlertCircle"],"mappings":";;;;;;;AAiBO,SAASA,EAAMC,GAAsB;AAC1C,QAAMC,IAAgBC,EAAqBF,GAAUG,CAAa,GAC5D;AAAA,IACJ,WAAAC;AAAA,IACA,gBAAAC;AAAA,IACA,cAAAC;AAAA,IACA,UAAAC;AAAA,IACA,YAAAC;AAAA,IACA,gBAAgBC;AAAA,IAChB,GAAGC;AAAA,EAAA,IACDT;AAEJ,SACE,gBAAAU;AAAA,IAAC;AAAA,IAAA;AAAA,MACC,WAAWC;AAAA,QACTC,EAAO;AAAA,QACP;AAAA,UACE,CAACA,EAAO,iBAA2B,GAAG,CAAC,CAACR;AAAA,UACxC,CAACQ,EAAO,eAAyB,GAAG,CAAC,CAACP;AAAA,QAAA;AAAA,QAExCF;AAAA,MAAA;AAAA,MAEF,iBAAeI;AAAA,MAEd,UAAA;AAAA,QAAAH,KAAkB,gBAAAS,EAAC,OAAA,EAAI,WAAWD,EAAO,gBAAiB,UAAAR,GAAe;AAAA,QAC1E,gBAAAM,EAAC,OAAA,EAAI,WAAWE,EAAO,gBACrB,UAAA;AAAA,UAAA,gBAAAC;AAAA,YAACC;AAAAA,YAAA;AAAA,cACC,KAAKR;AAAA,cACL,UAAUC;AAAA,cACV,gBAAcC;AAAA,cACb,GAAGC;AAAA,YAAA;AAAA,UAAA;AAAA,UAEN,gBAAAI,EAAC,SAAI,WAAWD,EAAO,aACrB,UAAA,gBAAAC,EAACE,GAAA,EAAY,UAAU,GAAA,CAAI,EAAA,CAC7B;AAAA,QAAA,GACF;AAAA,QACCV,KAAgB,gBAAAQ,EAAC,OAAA,EAAI,WAAWD,EAAO,cAAe,UAAAP,EAAA,CAAa;AAAA,MAAA;AAAA,IAAA;AAAA,EAAA;AAG1E;"}

package/dist/components/Common/UI/Input/InputTypes.d.ts

@@ -1,4 +1,13 @@
 import { InputHTMLAttributes, ReactNode, Ref } from 'react';
+/**
+ * Base text-input primitive used internally by `TextInput` and `NumberInput`.
+ *
+ * @remarks
+ * Higher-level field components like TextInput and NumberInput reuse the
+ * `adornmentStart` and `adornmentEnd` slots from this interface.
+ *
+ * @public
+ */
 export interface InputProps extends Pick<InputHTMLAttributes<HTMLInputElement>, 'className' | 'id' | 'name' | 'placeholder' | 'type' | 'value' | 'onChange' | 'onBlur' | 'onFocus' | 'aria-describedby' | 'aria-labelledby' | 'aria-invalid' | 'min' | 'max' | 'maxLength'> {
     /**
      * Ref for the input element
@@ -14,12 +23,14 @@ export interface InputProps extends Pick<InputHTMLAttributes<HTMLInputElement>,
     adornmentEnd?: ReactNode;
     /**
      * Whether the input is disabled
+     * @defaultValue `false`
      */
     isDisabled?: boolean;
 }
 /**
- * Default prop values for Input component.
- * These are used by the component adapter to automatically provide defaults.
+ * Default prop values for the Input primitive, applied through the component adapter.
+ *
+ * @internal
  */
 export declare const InputDefaults: {
     readonly isDisabled: false;

package/dist/components/Common/UI/Input/InputTypes.js.map

@@ -1 +1 @@
-{"version":3,"file":"InputTypes.js","sources":["../../../../../src/components/Common/UI/Input/InputTypes.ts"],"sourcesContent":["import type { InputHTMLAttributes, ReactNode, Ref } from 'react'\n\nexport interface InputProps extends Pick<\n  InputHTMLAttributes<HTMLInputElement>,\n  | 'className'\n  | 'id'\n  | 'name'\n  | 'placeholder'\n  | 'type'\n  | 'value'\n  | 'onChange'\n  | 'onBlur'\n  | 'onFocus'\n  | 'aria-describedby'\n  | 'aria-labelledby'\n  | 'aria-invalid'\n  | 'min'\n  | 'max'\n  | 'maxLength'\n> {\n  /**\n   * Ref for the input element\n   */\n  inputRef?: Ref<HTMLInputElement>\n\n  /**\n   * Content to display at the start of the input\n   */\n  adornmentStart?: ReactNode\n\n  /**\n   * Content to display at the end of the input\n   */\n  adornmentEnd?: ReactNode\n\n  /**\n   * Whether the input is disabled\n   */\n  isDisabled?: boolean\n}\n\n/**\n * Default prop values for Input component.\n * These are used by the component adapter to automatically provide defaults.\n */\nexport const InputDefaults = {\n  isDisabled: false,\n} as const satisfies Partial<InputProps>\n"],"names":["InputDefaults"],"mappings":"AA6CO,MAAMA,IAAgB;AAAA,EAC3B,YAAY;AACd;"}
+{"version":3,"file":"InputTypes.js","sources":["../../../../../src/components/Common/UI/Input/InputTypes.ts"],"sourcesContent":["import type { InputHTMLAttributes, ReactNode, Ref } from 'react'\n\n/**\n * Base text-input primitive used internally by `TextInput` and `NumberInput`.\n *\n * @remarks\n * Higher-level field components like TextInput and NumberInput reuse the\n * `adornmentStart` and `adornmentEnd` slots from this interface.\n *\n * @public\n */\nexport interface InputProps extends Pick<\n  InputHTMLAttributes<HTMLInputElement>,\n  | 'className'\n  | 'id'\n  | 'name'\n  | 'placeholder'\n  | 'type'\n  | 'value'\n  | 'onChange'\n  | 'onBlur'\n  | 'onFocus'\n  | 'aria-describedby'\n  | 'aria-labelledby'\n  | 'aria-invalid'\n  | 'min'\n  | 'max'\n  | 'maxLength'\n> {\n  /**\n   * Ref for the input element\n   */\n  inputRef?: Ref<HTMLInputElement>\n\n  /**\n   * Content to display at the start of the input\n   */\n  adornmentStart?: ReactNode\n\n  /**\n   * Content to display at the end of the input\n   */\n  adornmentEnd?: ReactNode\n\n  /**\n   * Whether the input is disabled\n   * @defaultValue `false`\n   */\n  isDisabled?: boolean\n}\n\n/**\n * Default prop values for the Input primitive, applied through the component adapter.\n *\n * @internal\n */\nexport const InputDefaults = {\n  isDisabled: false,\n} as const satisfies Partial<InputProps>\n"],"names":["InputDefaults"],"mappings":"AAwDO,MAAMA,IAAgB;AAAA,EAC3B,YAAY;AACd;"}

package/dist/components/Common/UI/Input/index.d.ts

@@ -1,3 +1,2 @@
 import "./types/i18next.d.ts"
 export { Input } from './Input';
-export type { InputProps } from './InputTypes';

package/dist/components/Common/UI/Link/Link.d.ts

@@ -1,2 +1,9 @@
 import { LinkProps } from './LinkTypes';
-export declare function Link({ className, ...props }: LinkProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Anchor element styled as a link, with accessible keyboard and focus behavior.
+ *
+ * @param props - Link configuration, accepting the standard anchor attributes plus content as `children`.
+ * @returns The rendered anchor element.
+ * @internal
+ */
+export declare function Link({ className, ...props }: LinkProps): import("react").JSX.Element;

package/dist/components/Common/UI/Link/Link.js.map

@@ -1 +1 @@
-{"version":3,"file":"Link.js","sources":["../../../../../src/components/Common/UI/Link/Link.tsx"],"sourcesContent":["import { Link as AriaLink } from 'react-aria-components'\nimport classNames from 'classnames'\nimport type { LinkProps } from './LinkTypes'\nimport styles from './Link.module.scss'\n\nexport function Link({ className, ...props }: LinkProps) {\n  return <AriaLink className={classNames(styles.root, className)} {...props} />\n}\n"],"names":["Link","className","props","jsx","AriaLink","classNames","styles"],"mappings":";;;;AAKO,SAASA,EAAK,EAAE,WAAAC,GAAW,GAAGC,KAAoB;AACvD,SAAO,gBAAAC,EAACC,KAAS,WAAWC,EAAWC,EAAO,MAAML,CAAS,GAAI,GAAGC,GAAO;AAC7E;"}
+{"version":3,"file":"Link.js","sources":["../../../../../src/components/Common/UI/Link/Link.tsx"],"sourcesContent":["import { Link as AriaLink } from 'react-aria-components'\nimport classNames from 'classnames'\nimport type { LinkProps } from './LinkTypes'\nimport styles from './Link.module.scss'\n\n/**\n * Anchor element styled as a link, with accessible keyboard and focus behavior.\n *\n * @param props - Link configuration, accepting the standard anchor attributes plus content as `children`.\n * @returns The rendered anchor element.\n * @internal\n */\nexport function Link({ className, ...props }: LinkProps) {\n  return <AriaLink className={classNames(styles.root, className)} {...props} />\n}\n"],"names":["Link","className","props","jsx","AriaLink","classNames","styles"],"mappings":";;;;AAYO,SAASA,EAAK,EAAE,WAAAC,GAAW,GAAGC,KAAoB;AACvD,SAAO,gBAAAC,EAACC,KAAS,WAAWC,EAAWC,EAAO,MAAML,CAAS,GAAI,GAAGC,GAAO;AAC7E;"}

package/dist/components/Common/UI/Link/LinkTypes.d.ts

@@ -1,4 +1,10 @@
 import { AnchorHTMLAttributes, ReactNode } from 'react';
+/**
+ * Props your `Link` implementation must accept from the component adapter.
+ * Renders an HTML anchor (`<a>`) for inline navigation.
+ *
+ * @public
+ */
 export type LinkProps = Pick<AnchorHTMLAttributes<HTMLAnchorElement>, 
 /**
  * URL that the link points to

package/dist/components/Common/UI/List/ListTypes.d.ts

@@ -1,5 +1,5 @@
 import { ReactNode } from 'react';
-export interface BaseListProps {
+interface BaseListProps {
     /**
      * The list items to render
      */
@@ -21,5 +21,18 @@ export interface BaseListProps {
      */
     'aria-describedby'?: string;
 }
+/**
+ * Props your `UnorderedList` implementation must accept from the component adapter.
+ * Renders an unordered (bulleted) list of items.
+ *
+ * @public
+ */
 export type UnorderedListProps = BaseListProps;
+/**
+ * Props your `OrderedList` implementation must accept from the component adapter.
+ * Renders an ordered (numbered) list of items.
+ *
+ * @public
+ */
 export type OrderedListProps = BaseListProps;
+export {};

package/dist/components/Common/UI/List/OrderedList.d.ts

@@ -1,2 +1,9 @@
 import { OrderedListProps } from './ListTypes';
-export declare function OrderedList({ items, className, ...props }: OrderedListProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Renders an ordered (numbered) list from an array of item nodes.
+ *
+ * @param props - See {@link OrderedListProps}.
+ * @returns The rendered ordered list element.
+ * @internal
+ */
+export declare function OrderedList({ items, className, ...props }: OrderedListProps): import("react").JSX.Element;

package/dist/components/Common/UI/List/OrderedList.js.map

@@ -1 +1 @@
-{"version":3,"file":"OrderedList.js","sources":["../../../../../src/components/Common/UI/List/OrderedList.tsx"],"sourcesContent":["import classnames from 'classnames'\nimport type { OrderedListProps } from './ListTypes'\nimport styles from './List.module.scss'\n\nexport function OrderedList({ items, className, ...props }: OrderedListProps) {\n  return (\n    <ol className={classnames(styles.list, className)} data-variant=\"ordered\" {...props}>\n      {items.map((item, index) => {\n        // Simple key generation - use index-based key\n        // which is completely fine for static lists\n        const key = `item-${index}`\n\n        return (\n          <li key={key} className={styles.item}>\n            {item}\n          </li>\n        )\n      })}\n    </ol>\n  )\n}\n"],"names":["OrderedList","items","className","props","classnames","styles","item","index","key"],"mappings":";;;AAIO,SAASA,EAAY,EAAE,OAAAC,GAAO,WAAAC,GAAW,GAAGC,KAA2B;AAC5E,2BACG,MAAA,EAAG,WAAWC,EAAWC,EAAO,MAAMH,CAAS,GAAG,gBAAa,WAAW,GAAGC,GAC3E,UAAAF,EAAM,IAAI,CAACK,GAAMC,MAAU;AAG1B,UAAMC,IAAM,QAAQD,CAAK;AAEzB,6BACG,MAAA,EAAa,WAAWF,EAAO,MAC7B,eADMG,CAET;AAAA,EAEJ,CAAC,EAAA,CACH;AAEJ;"}
+{"version":3,"file":"OrderedList.js","sources":["../../../../../src/components/Common/UI/List/OrderedList.tsx"],"sourcesContent":["import classnames from 'classnames'\nimport type { OrderedListProps } from './ListTypes'\nimport styles from './List.module.scss'\n\n/**\n * Renders an ordered (numbered) list from an array of item nodes.\n *\n * @param props - See {@link OrderedListProps}.\n * @returns The rendered ordered list element.\n * @internal\n */\nexport function OrderedList({ items, className, ...props }: OrderedListProps) {\n  return (\n    <ol className={classnames(styles.list, className)} data-variant=\"ordered\" {...props}>\n      {items.map((item, index) => {\n        // Simple key generation - use index-based key\n        // which is completely fine for static lists\n        const key = `item-${index}`\n\n        return (\n          <li key={key} className={styles.item}>\n            {item}\n          </li>\n        )\n      })}\n    </ol>\n  )\n}\n"],"names":["OrderedList","items","className","props","classnames","styles","item","index","key"],"mappings":";;;AAWO,SAASA,EAAY,EAAE,OAAAC,GAAO,WAAAC,GAAW,GAAGC,KAA2B;AAC5E,2BACG,MAAA,EAAG,WAAWC,EAAWC,EAAO,MAAMH,CAAS,GAAG,gBAAa,WAAW,GAAGC,GAC3E,UAAAF,EAAM,IAAI,CAACK,GAAMC,MAAU;AAG1B,UAAMC,IAAM,QAAQD,CAAK;AAEzB,6BACG,MAAA,EAAa,WAAWF,EAAO,MAC7B,eADMG,CAET;AAAA,EAEJ,CAAC,EAAA,CACH;AAEJ;"}

package/dist/components/Common/UI/List/UnorderedList.d.ts

@@ -1,2 +1,9 @@
 import { UnorderedListProps } from './ListTypes';
-export declare function UnorderedList({ items, className, ...props }: UnorderedListProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Renders an unordered (bulleted) list from an array of item nodes.
+ *
+ * @param props - See {@link UnorderedListProps}.
+ * @returns The rendered unordered list element.
+ * @internal
+ */
+export declare function UnorderedList({ items, className, ...props }: UnorderedListProps): import("react").JSX.Element;

package/dist/components/Common/UI/List/UnorderedList.js.map

@@ -1 +1 @@
-{"version":3,"file":"UnorderedList.js","sources":["../../../../../src/components/Common/UI/List/UnorderedList.tsx"],"sourcesContent":["import classnames from 'classnames'\nimport type { UnorderedListProps } from './ListTypes'\nimport styles from './List.module.scss'\n\nexport function UnorderedList({ items, className, ...props }: UnorderedListProps) {\n  return (\n    <ul className={classnames(styles.list, className)} data-variant=\"unordered\" {...props}>\n      {items.map((item, index) => {\n        // Simple key generation - use index-based key\n        // which is completely fine for static lists\n        const key = `item-${index}`\n\n        return (\n          <li key={key} className={styles.item}>\n            {item}\n          </li>\n        )\n      })}\n    </ul>\n  )\n}\n"],"names":["UnorderedList","items","className","props","classnames","styles","item","index","key"],"mappings":";;;AAIO,SAASA,EAAc,EAAE,OAAAC,GAAO,WAAAC,GAAW,GAAGC,KAA6B;AAChF,2BACG,MAAA,EAAG,WAAWC,EAAWC,EAAO,MAAMH,CAAS,GAAG,gBAAa,aAAa,GAAGC,GAC7E,UAAAF,EAAM,IAAI,CAACK,GAAMC,MAAU;AAG1B,UAAMC,IAAM,QAAQD,CAAK;AAEzB,6BACG,MAAA,EAAa,WAAWF,EAAO,MAC7B,eADMG,CAET;AAAA,EAEJ,CAAC,EAAA,CACH;AAEJ;"}
+{"version":3,"file":"UnorderedList.js","sources":["../../../../../src/components/Common/UI/List/UnorderedList.tsx"],"sourcesContent":["import classnames from 'classnames'\nimport type { UnorderedListProps } from './ListTypes'\nimport styles from './List.module.scss'\n\n/**\n * Renders an unordered (bulleted) list from an array of item nodes.\n *\n * @param props - See {@link UnorderedListProps}.\n * @returns The rendered unordered list element.\n * @internal\n */\nexport function UnorderedList({ items, className, ...props }: UnorderedListProps) {\n  return (\n    <ul className={classnames(styles.list, className)} data-variant=\"unordered\" {...props}>\n      {items.map((item, index) => {\n        // Simple key generation - use index-based key\n        // which is completely fine for static lists\n        const key = `item-${index}`\n\n        return (\n          <li key={key} className={styles.item}>\n            {item}\n          </li>\n        )\n      })}\n    </ul>\n  )\n}\n"],"names":["UnorderedList","items","className","props","classnames","styles","item","index","key"],"mappings":";;;AAWO,SAASA,EAAc,EAAE,OAAAC,GAAO,WAAAC,GAAW,GAAGC,KAA6B;AAChF,2BACG,MAAA,EAAG,WAAWC,EAAWC,EAAO,MAAMH,CAAS,GAAG,gBAAa,aAAa,GAAGC,GAC7E,UAAAF,EAAM,IAAI,CAACK,GAAMC,MAAU;AAG1B,UAAMC,IAAM,QAAQD,CAAK;AAEzB,6BACG,MAAA,EAAa,WAAWF,EAAO,MAC7B,eADMG,CAET;AAAA,EAEJ,CAAC,EAAA,CACH;AAEJ;"}

package/dist/components/Common/UI/List/index.d.ts

@@ -1,4 +1,4 @@
 import "./types/i18next.d.ts"
 export { OrderedList } from './OrderedList';
 export { UnorderedList } from './UnorderedList';
-export type { BaseListProps, OrderedListProps, UnorderedListProps } from './ListTypes';
+export type { OrderedListProps, UnorderedListProps } from './ListTypes';

package/dist/components/Common/UI/LoadingSpinner/LoadingSpinner.d.ts

@@ -1,3 +1,10 @@
 import { default as React } from 'react';
 import { LoadingSpinnerProps } from './LoadingSpinnerTypes';
+/**
+ * Indeterminate loading indicator with a built-in `role="status"` and accessible label.
+ *
+ * @param rawProps - See {@link LoadingSpinnerProps}.
+ * @returns The rendered spinner element.
+ * @internal
+ */
 export declare const LoadingSpinner: React.FC<LoadingSpinnerProps>;

package/dist/components/Common/UI/LoadingSpinner/LoadingSpinner.js.map

@@ -1 +1 @@
-{"version":3,"file":"LoadingSpinner.js","sources":["../../../../../src/components/Common/UI/LoadingSpinner/LoadingSpinner.tsx"],"sourcesContent":["import type React from 'react'\nimport classnames from 'classnames'\nimport styles from './LoadingSpinner.module.scss'\nimport type { LoadingSpinnerProps } from './LoadingSpinnerTypes'\nimport { LoadingSpinnerDefaults } from './LoadingSpinnerTypes'\nimport { applyMissingDefaults } from '@/helpers/applyMissingDefaults'\nimport SpinnerIcon from '@/assets/icons/spinner_large.svg?react'\n\nexport const LoadingSpinner: React.FC<LoadingSpinnerProps> = rawProps => {\n  const resolvedProps = applyMissingDefaults(rawProps, LoadingSpinnerDefaults)\n  const { className, size, style, ...otherProps } = resolvedProps\n\n  return (\n    <div\n      {...otherProps}\n      className={classnames(styles.loadingSpinner, className)}\n      data-size={size}\n      data-style={style}\n      role=\"status\"\n      aria-label={otherProps['aria-label'] || 'Loading'}\n    >\n      <SpinnerIcon className={styles.spinnerIcon} aria-hidden=\"true\" />\n    </div>\n  )\n}\n"],"names":["LoadingSpinner","rawProps","resolvedProps","applyMissingDefaults","LoadingSpinnerDefaults","className","size","style","otherProps","jsx","classnames","styles","SpinnerIcon"],"mappings":";;;;;;AAQO,MAAMA,IAAgD,CAAAC,MAAY;AACvE,QAAMC,IAAgBC,EAAqBF,GAAUG,CAAsB,GACrE,EAAE,WAAAC,GAAW,MAAAC,GAAM,OAAAC,GAAO,GAAGC,MAAeN;AAElD,SACE,gBAAAO;AAAA,IAAC;AAAA,IAAA;AAAA,MACE,GAAGD;AAAA,MACJ,WAAWE,EAAWC,EAAO,gBAAgBN,CAAS;AAAA,MACtD,aAAWC;AAAA,MACX,cAAYC;AAAA,MACZ,MAAK;AAAA,MACL,cAAYC,EAAW,YAAY,KAAK;AAAA,MAExC,4BAACI,GAAA,EAAY,WAAWD,EAAO,aAAa,eAAY,OAAA,CAAO;AAAA,IAAA;AAAA,EAAA;AAGrE;"}
+{"version":3,"file":"LoadingSpinner.js","sources":["../../../../../src/components/Common/UI/LoadingSpinner/LoadingSpinner.tsx"],"sourcesContent":["import type React from 'react'\nimport classnames from 'classnames'\nimport styles from './LoadingSpinner.module.scss'\nimport type { LoadingSpinnerProps } from './LoadingSpinnerTypes'\nimport { LoadingSpinnerDefaults } from './LoadingSpinnerTypes'\nimport { applyMissingDefaults } from '@/helpers/applyMissingDefaults'\nimport SpinnerIcon from '@/assets/icons/spinner_large.svg?react'\n\n/**\n * Indeterminate loading indicator with a built-in `role=\"status\"` and accessible label.\n *\n * @param rawProps - See {@link LoadingSpinnerProps}.\n * @returns The rendered spinner element.\n * @internal\n */\nexport const LoadingSpinner: React.FC<LoadingSpinnerProps> = rawProps => {\n  const resolvedProps = applyMissingDefaults(rawProps, LoadingSpinnerDefaults)\n  const { className, size, style, ...otherProps } = resolvedProps\n\n  return (\n    <div\n      {...otherProps}\n      className={classnames(styles.loadingSpinner, className)}\n      data-size={size}\n      data-style={style}\n      role=\"status\"\n      aria-label={otherProps['aria-label'] || 'Loading'}\n    >\n      <SpinnerIcon className={styles.spinnerIcon} aria-hidden=\"true\" />\n    </div>\n  )\n}\n"],"names":["LoadingSpinner","rawProps","resolvedProps","applyMissingDefaults","LoadingSpinnerDefaults","className","size","style","otherProps","jsx","classnames","styles","SpinnerIcon"],"mappings":";;;;;;AAeO,MAAMA,IAAgD,CAAAC,MAAY;AACvE,QAAMC,IAAgBC,EAAqBF,GAAUG,CAAsB,GACrE,EAAE,WAAAC,GAAW,MAAAC,GAAM,OAAAC,GAAO,GAAGC,MAAeN;AAElD,SACE,gBAAAO;AAAA,IAAC;AAAA,IAAA;AAAA,MACE,GAAGD;AAAA,MACJ,WAAWE,EAAWC,EAAO,gBAAgBN,CAAS;AAAA,MACtD,aAAWC;AAAA,MACX,cAAYC;AAAA,MACZ,MAAK;AAAA,MACL,cAAYC,EAAW,YAAY,KAAK;AAAA,MAExC,4BAACI,GAAA,EAAY,WAAWD,EAAO,aAAa,eAAY,OAAA,CAAO;AAAA,IAAA;AAAA,EAAA;AAGrE;"}

package/dist/components/Common/UI/LoadingSpinner/LoadingSpinnerTypes.d.ts

@@ -1,16 +1,28 @@
 import { HTMLAttributes } from 'react';
+/**
+ * Props your `LoadingSpinner` implementation must accept from the component adapter.
+ * Renders a spinner indicating that content is loading.
+ *
+ * @public
+ */
 export interface LoadingSpinnerProps extends Pick<HTMLAttributes<HTMLDivElement>, 'className' | 'id' | 'aria-label'> {
     /**
      * Size of the spinner
+     *
+     * @defaultValue `'lg'`
      */
     size?: 'lg' | 'sm';
     /**
      * Display style of the spinner
+     *
+     * @defaultValue `'block'`
      */
     style?: 'inline' | 'block';
 }
 /**
- * Default prop values for LoadingSpinner component.
+ * Default prop values for the {@link LoadingSpinner} component.
+ *
+ * @internal
  */
 export declare const LoadingSpinnerDefaults: {
     readonly size: "lg";

package/dist/components/Common/UI/LoadingSpinner/LoadingSpinnerTypes.js.map

@@ -1 +1 @@
-{"version":3,"file":"LoadingSpinnerTypes.js","sources":["../../../../../src/components/Common/UI/LoadingSpinner/LoadingSpinnerTypes.ts"],"sourcesContent":["import type { HTMLAttributes } from 'react'\n\nexport interface LoadingSpinnerProps extends Pick<\n  HTMLAttributes<HTMLDivElement>,\n  'className' | 'id' | 'aria-label'\n> {\n  /**\n   * Size of the spinner\n   */\n  size?: 'lg' | 'sm'\n  /**\n   * Display style of the spinner\n   */\n  style?: 'inline' | 'block'\n}\n\n/**\n * Default prop values for LoadingSpinner component.\n */\nexport const LoadingSpinnerDefaults = {\n  size: 'lg',\n  style: 'block',\n} as const satisfies Partial<LoadingSpinnerProps>\n"],"names":["LoadingSpinnerDefaults"],"mappings":"AAmBO,MAAMA,IAAyB;AAAA,EACpC,MAAM;AAAA,EACN,OAAO;AACT;"}
+{"version":3,"file":"LoadingSpinnerTypes.js","sources":["../../../../../src/components/Common/UI/LoadingSpinner/LoadingSpinnerTypes.ts"],"sourcesContent":["import type { HTMLAttributes } from 'react'\n\n/**\n * Props your `LoadingSpinner` implementation must accept from the component adapter.\n * Renders a spinner indicating that content is loading.\n *\n * @public\n */\nexport interface LoadingSpinnerProps extends Pick<\n  HTMLAttributes<HTMLDivElement>,\n  'className' | 'id' | 'aria-label'\n> {\n  /**\n   * Size of the spinner\n   *\n   * @defaultValue `'lg'`\n   */\n  size?: 'lg' | 'sm'\n  /**\n   * Display style of the spinner\n   *\n   * @defaultValue `'block'`\n   */\n  style?: 'inline' | 'block'\n}\n\n/**\n * Default prop values for the {@link LoadingSpinner} component.\n *\n * @internal\n */\nexport const LoadingSpinnerDefaults = {\n  size: 'lg',\n  style: 'block',\n} as const satisfies Partial<LoadingSpinnerProps>\n"],"names":["LoadingSpinnerDefaults"],"mappings":"AA+BO,MAAMA,IAAyB;AAAA,EACpC,MAAM;AAAA,EACN,OAAO;AACT;"}

package/dist/components/Common/UI/LoadingSpinner/index.d.ts

@@ -1,4 +1,2 @@
 import "./types/i18next.d.ts"
 export { LoadingSpinner } from './LoadingSpinner';
-export type { LoadingSpinnerProps } from './LoadingSpinnerTypes';
-export { LoadingSpinnerDefaults } from './LoadingSpinnerTypes';

package/dist/components/Common/UI/Menu/Menu.d.ts

@@ -1,2 +1,9 @@
 import { MenuProps } from './MenuTypes';
-export declare function Menu(rawProps: MenuProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Popover menu anchored to a trigger element, with a configurable list of actions.
+ *
+ * @param rawProps - See {@link MenuProps}.
+ * @returns The rendered menu popover, or `null` content when closed.
+ * @internal
+ */
+export declare function Menu(rawProps: MenuProps): import("react").JSX.Element;

package/dist/components/Common/UI/Menu/Menu.js.map

@@ -1 +1 @@
-{"version":3,"file":"Menu.js","sources":["../../../../../src/components/Common/UI/Menu/Menu.tsx"],"sourcesContent":["import { Menu as AriaMenu, MenuItem as AriaMenuItem, Popover } from 'react-aria-components'\nimport styles from './Menu.module.scss'\nimport { type MenuProps, MenuDefaults } from './MenuTypes'\nimport { applyMissingDefaults } from '@/helpers/applyMissingDefaults'\nimport { useTheme } from '@/contexts/ThemeProvider'\n\nexport function Menu(rawProps: MenuProps) {\n  const resolvedProps = applyMissingDefaults(rawProps, MenuDefaults)\n  const {\n    triggerRef,\n    items,\n    isOpen,\n    onClose,\n    placement,\n    portalContainer,\n    'aria-label': ariaLabel,\n    ...otherProps\n  } = resolvedProps\n  const { container } = useTheme()\n\n  const handleOpenChange = (isOpen: boolean) => {\n    if (!isOpen) {\n      onClose?.()\n    }\n  }\n\n  return (\n    <Popover\n      UNSTABLE_portalContainer={portalContainer ?? container.current ?? undefined}\n      onOpenChange={handleOpenChange}\n      isOpen={isOpen}\n      triggerRef={triggerRef}\n      placement={placement}\n      offset={8}\n      shouldUpdatePosition={true}\n    >\n      <AriaMenu onClose={onClose} aria-label={ariaLabel} className={styles.root} {...otherProps}>\n        {items?.map(({ onClick, isDisabled, href, icon, label, ...itemProps }, index) => (\n          <AriaMenuItem\n            key={index}\n            onAction={() => {\n              onClick()\n            }}\n            isDisabled={isDisabled}\n            href={href}\n            className={styles.menuItem}\n            {...itemProps}\n          >\n            {icon && <div className={styles.menuIcon}>{icon}</div>}\n            {label}\n          </AriaMenuItem>\n        ))}\n      </AriaMenu>\n    </Popover>\n  )\n}\n"],"names":["Menu","rawProps","resolvedProps","applyMissingDefaults","MenuDefaults","triggerRef","items","isOpen","onClose","placement","portalContainer","ariaLabel","otherProps","container","useTheme","handleOpenChange","jsx","Popover","AriaMenu","styles","onClick","isDisabled","href","icon","label","itemProps","index","jsxs","AriaMenuItem"],"mappings":";;;;;;;;AAMO,SAASA,EAAKC,GAAqB;AACxC,QAAMC,IAAgBC,EAAqBF,GAAUG,CAAY,GAC3D;AAAA,IACJ,YAAAC;AAAA,IACA,OAAAC;AAAA,IACA,QAAAC;AAAA,IACA,SAAAC;AAAA,IACA,WAAAC;AAAA,IACA,iBAAAC;AAAA,IACA,cAAcC;AAAA,IACd,GAAGC;AAAA,EAAA,IACDV,GACE,EAAE,WAAAW,EAAA,IAAcC,EAAA,GAEhBC,IAAmB,CAACR,MAAoB;AAC5C,IAAKA,KACHC,IAAA;AAAA,EAEJ;AAEA,SACE,gBAAAQ;AAAA,IAACC;AAAA,IAAA;AAAA,MACC,0BAA0BP,KAAmBG,EAAU,WAAW;AAAA,MAClE,cAAcE;AAAA,MACd,QAAAR;AAAA,MACA,YAAAF;AAAA,MACA,WAAAI;AAAA,MACA,QAAQ;AAAA,MACR,sBAAsB;AAAA,MAEtB,UAAA,gBAAAO,EAACE,KAAS,SAAAV,GAAkB,cAAYG,GAAW,WAAWQ,EAAO,MAAO,GAAGP,GAC5E,UAAAN,GAAO,IAAI,CAAC,EAAE,SAAAc,GAAS,YAAAC,GAAY,MAAAC,GAAM,MAAAC,GAAM,OAAAC,GAAO,GAAGC,EAAA,GAAaC,MACrE,gBAAAC;AAAA,QAACC;AAAAA,QAAA;AAAA,UAEC,UAAU,MAAM;AACd,YAAAR,EAAA;AAAA,UACF;AAAA,UACA,YAAAC;AAAA,UACA,MAAAC;AAAA,UACA,WAAWH,EAAO;AAAA,UACjB,GAAGM;AAAA,UAEH,UAAA;AAAA,YAAAF,KAAQ,gBAAAP,EAAC,OAAA,EAAI,WAAWG,EAAO,UAAW,UAAAI,GAAK;AAAA,YAC/CC;AAAA,UAAA;AAAA,QAAA;AAAA,QAVIE;AAAA,MAAA,CAYR,EAAA,CACH;AAAA,IAAA;AAAA,EAAA;AAGN;"}
+{"version":3,"file":"Menu.js","sources":["../../../../../src/components/Common/UI/Menu/Menu.tsx"],"sourcesContent":["import { Menu as AriaMenu, MenuItem as AriaMenuItem, Popover } from 'react-aria-components'\nimport styles from './Menu.module.scss'\nimport { type MenuProps, MenuDefaults } from './MenuTypes'\nimport { applyMissingDefaults } from '@/helpers/applyMissingDefaults'\nimport { useTheme } from '@/contexts/ThemeProvider'\n\n/**\n * Popover menu anchored to a trigger element, with a configurable list of actions.\n *\n * @param rawProps - See {@link MenuProps}.\n * @returns The rendered menu popover, or `null` content when closed.\n * @internal\n */\nexport function Menu(rawProps: MenuProps) {\n  const resolvedProps = applyMissingDefaults(rawProps, MenuDefaults)\n  const {\n    triggerRef,\n    items,\n    isOpen,\n    onClose,\n    placement,\n    portalContainer,\n    'aria-label': ariaLabel,\n    ...otherProps\n  } = resolvedProps\n  const { container } = useTheme()\n\n  const handleOpenChange = (isOpen: boolean) => {\n    if (!isOpen) {\n      onClose?.()\n    }\n  }\n\n  return (\n    <Popover\n      UNSTABLE_portalContainer={portalContainer ?? container.current ?? undefined}\n      onOpenChange={handleOpenChange}\n      isOpen={isOpen}\n      triggerRef={triggerRef}\n      placement={placement}\n      offset={8}\n      shouldUpdatePosition={true}\n    >\n      <AriaMenu onClose={onClose} aria-label={ariaLabel} className={styles.root} {...otherProps}>\n        {items?.map(({ onClick, isDisabled, href, icon, label, ...itemProps }, index) => (\n          <AriaMenuItem\n            key={index}\n            onAction={() => {\n              onClick()\n            }}\n            isDisabled={isDisabled}\n            href={href}\n            className={styles.menuItem}\n            {...itemProps}\n          >\n            {icon && <div className={styles.menuIcon}>{icon}</div>}\n            {label}\n          </AriaMenuItem>\n        ))}\n      </AriaMenu>\n    </Popover>\n  )\n}\n"],"names":["Menu","rawProps","resolvedProps","applyMissingDefaults","MenuDefaults","triggerRef","items","isOpen","onClose","placement","portalContainer","ariaLabel","otherProps","container","useTheme","handleOpenChange","jsx","Popover","AriaMenu","styles","onClick","isDisabled","href","icon","label","itemProps","index","jsxs","AriaMenuItem"],"mappings":";;;;;;;;AAaO,SAASA,EAAKC,GAAqB;AACxC,QAAMC,IAAgBC,EAAqBF,GAAUG,CAAY,GAC3D;AAAA,IACJ,YAAAC;AAAA,IACA,OAAAC;AAAA,IACA,QAAAC;AAAA,IACA,SAAAC;AAAA,IACA,WAAAC;AAAA,IACA,iBAAAC;AAAA,IACA,cAAcC;AAAA,IACd,GAAGC;AAAA,EAAA,IACDV,GACE,EAAE,WAAAW,EAAA,IAAcC,EAAA,GAEhBC,IAAmB,CAACR,MAAoB;AAC5C,IAAKA,KACHC,IAAA;AAAA,EAEJ;AAEA,SACE,gBAAAQ;AAAA,IAACC;AAAA,IAAA;AAAA,MACC,0BAA0BP,KAAmBG,EAAU,WAAW;AAAA,MAClE,cAAcE;AAAA,MACd,QAAAR;AAAA,MACA,YAAAF;AAAA,MACA,WAAAI;AAAA,MACA,QAAQ;AAAA,MACR,sBAAsB;AAAA,MAEtB,UAAA,gBAAAO,EAACE,KAAS,SAAAV,GAAkB,cAAYG,GAAW,WAAWQ,EAAO,MAAO,GAAGP,GAC5E,UAAAN,GAAO,IAAI,CAAC,EAAE,SAAAc,GAAS,YAAAC,GAAY,MAAAC,GAAM,MAAAC,GAAM,OAAAC,GAAO,GAAGC,EAAA,GAAaC,MACrE,gBAAAC;AAAA,QAACC;AAAAA,QAAA;AAAA,UAEC,UAAU,MAAM;AACd,YAAAR,EAAA;AAAA,UACF;AAAA,UACA,YAAAC;AAAA,UACA,MAAAC;AAAA,UACA,WAAWH,EAAO;AAAA,UACjB,GAAGM;AAAA,UAEH,UAAA;AAAA,YAAAF,KAAQ,gBAAAP,EAAC,OAAA,EAAI,WAAWG,EAAO,UAAW,UAAAI,GAAK;AAAA,YAC/CC;AAAA,UAAA;AAAA,QAAA;AAAA,QAVIE;AAAA,MAAA,CAYR,EAAA,CACH;AAAA,IAAA;AAAA,EAAA;AAGN;"}

package/dist/components/Common/UI/Menu/MenuTypes.d.ts

@@ -1,5 +1,11 @@
 import { ReactNode, RefObject } from 'react';
 import { DataAttributes } from '../../../../types/Helpers';
+/**
+ * Action entry your `Menu` implementation must accept for each entry in its `items` array
+ * from the component adapter.
+ *
+ * @public
+ */
 export interface MenuItem extends DataAttributes {
     /**
      * Text label for the menu item
@@ -22,6 +28,12 @@ export interface MenuItem extends DataAttributes {
      */
     href?: string;
 }
+/**
+ * Props your `Menu` implementation must accept from the component adapter.
+ * Renders a popover menu of actions anchored to a trigger element.
+ *
+ * @public
+ */
 export interface MenuProps extends DataAttributes {
     /**
      * Reference to the element that triggers the menu
@@ -33,6 +45,8 @@ export interface MenuProps extends DataAttributes {
     items?: MenuItem[];
     /**
      * Controls whether the menu is currently open
+     *
+     * @defaultValue `false`
      */
     isOpen?: boolean;
     /**
@@ -50,11 +64,15 @@ export interface MenuProps extends DataAttributes {
     portalContainer?: HTMLElement;
     /**
      * Controls the placement of the menu popover relative to the trigger
+     *
+     * @defaultValue `'bottom start'`
      */
     placement?: 'top' | 'top start' | 'top end' | 'bottom' | 'bottom start' | 'bottom end' | 'left' | 'right';
 }
 /**
- * Default prop values for Menu component.
+ * Default prop values for the {@link Menu} component.
+ *
+ * @internal
  */
 export declare const MenuDefaults: {
     readonly isOpen: false;

package/dist/components/Common/UI/Menu/MenuTypes.js.map

@@ -1 +1 @@
-{"version":3,"file":"MenuTypes.js","sources":["../../../../../src/components/Common/UI/Menu/MenuTypes.ts"],"sourcesContent":["import type { ReactNode, RefObject } from 'react'\nimport type { DataAttributes } from '@/types/Helpers'\n\nexport interface MenuItem extends DataAttributes {\n  /**\n   * Text label for the menu item\n   */\n  label: string\n  /**\n   * Optional icon to display before the label\n   */\n  icon?: ReactNode\n  /**\n   * Callback function when the menu item is clicked\n   */\n  onClick: () => void\n  /**\n   * Disables the menu item and prevents interaction\n   */\n  isDisabled?: boolean\n  /**\n   * Optional URL to navigate to when clicked\n   */\n  href?: string\n}\n\nexport interface MenuProps extends DataAttributes {\n  /**\n   * Reference to the element that triggers the menu\n   */\n  triggerRef?: RefObject<Element | null>\n  /**\n   * Array of menu items to display\n   */\n  items?: MenuItem[]\n  /**\n   * Controls whether the menu is currently open\n   */\n  isOpen?: boolean\n  /**\n   * Callback when the menu is closed\n   */\n  onClose?: () => void\n  /**\n   * Accessible label describing the menu's purpose\n   */\n  'aria-label': string\n  /**\n   * Element to use as the portal container for the menu popover.\n   * Overrides the default SDK root container from context.\n   */\n  portalContainer?: HTMLElement\n  /**\n   * Controls the placement of the menu popover relative to the trigger\n   */\n  placement?:\n    | 'top'\n    | 'top start'\n    | 'top end'\n    | 'bottom'\n    | 'bottom start'\n    | 'bottom end'\n    | 'left'\n    | 'right'\n}\n\n/**\n * Default prop values for Menu component.\n */\nexport const MenuDefaults = {\n  isOpen: false,\n  placement: 'bottom start',\n} as const satisfies Partial<MenuProps>\n"],"names":["MenuDefaults"],"mappings":"AAqEO,MAAMA,IAAe;AAAA,EAC1B,QAAQ;AAAA,EACR,WAAW;AACb;"}
+{"version":3,"file":"MenuTypes.js","sources":["../../../../../src/components/Common/UI/Menu/MenuTypes.ts"],"sourcesContent":["import type { ReactNode, RefObject } from 'react'\nimport type { DataAttributes } from '@/types/Helpers'\n\n/**\n * Action entry your `Menu` implementation must accept for each entry in its `items` array\n * from the component adapter.\n *\n * @public\n */\nexport interface MenuItem extends DataAttributes {\n  /**\n   * Text label for the menu item\n   */\n  label: string\n  /**\n   * Optional icon to display before the label\n   */\n  icon?: ReactNode\n  /**\n   * Callback function when the menu item is clicked\n   */\n  onClick: () => void\n  /**\n   * Disables the menu item and prevents interaction\n   */\n  isDisabled?: boolean\n  /**\n   * Optional URL to navigate to when clicked\n   */\n  href?: string\n}\n\n/**\n * Props your `Menu` implementation must accept from the component adapter.\n * Renders a popover menu of actions anchored to a trigger element.\n *\n * @public\n */\nexport interface MenuProps extends DataAttributes {\n  /**\n   * Reference to the element that triggers the menu\n   */\n  triggerRef?: RefObject<Element | null>\n  /**\n   * Array of menu items to display\n   */\n  items?: MenuItem[]\n  /**\n   * Controls whether the menu is currently open\n   *\n   * @defaultValue `false`\n   */\n  isOpen?: boolean\n  /**\n   * Callback when the menu is closed\n   */\n  onClose?: () => void\n  /**\n   * Accessible label describing the menu's purpose\n   */\n  'aria-label': string\n  /**\n   * Element to use as the portal container for the menu popover.\n   * Overrides the default SDK root container from context.\n   */\n  portalContainer?: HTMLElement\n  /**\n   * Controls the placement of the menu popover relative to the trigger\n   *\n   * @defaultValue `'bottom start'`\n   */\n  placement?:\n    | 'top'\n    | 'top start'\n    | 'top end'\n    | 'bottom'\n    | 'bottom start'\n    | 'bottom end'\n    | 'left'\n    | 'right'\n}\n\n/**\n * Default prop values for the {@link Menu} component.\n *\n * @internal\n */\nexport const MenuDefaults = {\n  isOpen: false,\n  placement: 'bottom start',\n} as const satisfies Partial<MenuProps>\n"],"names":["MenuDefaults"],"mappings":"AAuFO,MAAMA,IAAe;AAAA,EAC1B,QAAQ;AAAA,EACR,WAAW;AACb;"}

package/dist/components/Common/UI/Modal/Modal.d.ts

@@ -1,2 +1,12 @@
 import { ModalProps } from './ModalTypes';
-export declare function Modal(rawProps: ModalProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Native `<dialog>`-backed modal with backdrop dismissal, Escape-key support, and a fixed footer.
+ *
+ * @remarks
+ * Used as the base primitive for higher-level surfaces like {@link DialogProps | Dialog}. Body and footer content scroll independently when the body overflows.
+ *
+ * @param rawProps - See {@link ModalProps}.
+ * @returns The rendered modal element.
+ * @internal
+ */
+export declare function Modal(rawProps: ModalProps): import("react").JSX.Element;

package/dist/components/Common/UI/Modal/Modal.js.map

@@ -1 +1 @@
-{"version":3,"file":"Modal.js","sources":["../../../../../src/components/Common/UI/Modal/Modal.tsx"],"sourcesContent":["import { useLayoutEffect, useRef, useState } from 'react'\nimport classNames from 'classnames'\nimport { type ModalProps, ModalDefaults } from './ModalTypes'\nimport styles from './Modal.module.scss'\nimport { applyMissingDefaults } from '@/helpers/applyMissingDefaults'\nimport { useContainerBreakpoints } from '@/hooks/useContainerBreakpoints/useContainerBreakpoints'\nimport { useOverflowDetection } from '@/hooks/useOverflowDetection/useOverflowDetection'\nimport { useForkRef } from '@/hooks/useForkRef/useForkRef'\nimport { transitionDuration } from '@/contexts/ThemeProvider/theme'\n\nexport function Modal(rawProps: ModalProps) {\n  const resolvedProps = applyMissingDefaults(rawProps, ModalDefaults)\n  const { isOpen, onClose, shouldCloseOnBackdropClick, children, footer, containerRef } =\n    resolvedProps\n\n  const dialogRef = useRef<HTMLDialogElement>(null)\n  const internalBackdropRef = useRef<HTMLDivElement>(null)\n  const modalRef = useRef<HTMLDivElement>(null)\n  const contentRef = useRef<HTMLDivElement>(null)\n\n  // Use callback ref to sync both internal and external refs\n  const backdropCallbackRef = useForkRef(internalBackdropRef, containerRef)\n\n  const breakpoints = useContainerBreakpoints({\n    ref: internalBackdropRef,\n  })\n\n  const isOverflowing = useOverflowDetection({\n    ref: contentRef,\n  })\n\n  const [isExiting, setIsExiting] = useState(false)\n  const transitionTimeoutRef = useRef<NodeJS.Timeout | null>(null)\n  const isSmallOrLarger = breakpoints.includes('small')\n\n  useLayoutEffect(() => {\n    const dialog = dialogRef.current\n    if (!dialog) return\n\n    if (transitionTimeoutRef.current) {\n      clearTimeout(transitionTimeoutRef.current)\n    }\n\n    if (isOpen && !dialog.open) {\n      dialog.showModal()\n      requestAnimationFrame(() => {\n        dialog.setAttribute('data-show', 'true')\n      })\n    } else if (!isOpen && dialog.open) {\n      setIsExiting(true)\n      transitionTimeoutRef.current = setTimeout(() => {\n        dialog.close()\n        dialog.removeAttribute('data-show')\n        setIsExiting(false)\n      }, transitionDuration)\n    }\n\n    return () => {\n      if (transitionTimeoutRef.current) {\n        clearTimeout(transitionTimeoutRef.current)\n      }\n    }\n  }, [isOpen])\n\n  const handleBackdropClick = (event: React.MouseEvent<HTMLDivElement>) => {\n    if (event.target === event.currentTarget && shouldCloseOnBackdropClick) {\n      onClose?.()\n    }\n  }\n\n  const handleKeyDown = (event: React.KeyboardEvent<HTMLDivElement>) => {\n    if (event.key === 'Escape') {\n      onClose?.()\n    }\n  }\n\n  const handleClose = () => {\n    if (onClose) {\n      onClose()\n    }\n  }\n\n  return (\n    <dialog\n      ref={dialogRef}\n      className={styles.dialog}\n      onClose={handleClose}\n      data-exiting={isExiting || undefined}\n    >\n      <div\n        ref={backdropCallbackRef}\n        className={classNames(styles.backdrop, {\n          [styles.backdropSmall as string]: isSmallOrLarger,\n        })}\n        onClick={handleBackdropClick}\n        onKeyDown={handleKeyDown}\n        role=\"presentation\"\n      >\n        <div\n          ref={modalRef}\n          className={classNames(styles.modal, {\n            [styles.modalSmall as string]: isSmallOrLarger,\n            [styles.modalOverflowing as string]: isOverflowing,\n          })}\n        >\n          {children && (\n            <div\n              ref={contentRef}\n              className={classNames(styles.content, {\n                [styles.contentScrollable as string]: isOverflowing,\n              })}\n            >\n              {children}\n            </div>\n          )}\n          {footer && (\n            <div\n              className={classNames(styles.footer, {\n                [styles.footerFixed as string]: isOverflowing,\n              })}\n            >\n              {footer}\n            </div>\n          )}\n        </div>\n      </div>\n    </dialog>\n  )\n}\n"],"names":["Modal","rawProps","resolvedProps","applyMissingDefaults","ModalDefaults","isOpen","onClose","shouldCloseOnBackdropClick","children","footer","containerRef","dialogRef","useRef","internalBackdropRef","modalRef","contentRef","backdropCallbackRef","useForkRef","breakpoints","useContainerBreakpoints","isOverflowing","useOverflowDetection","isExiting","setIsExiting","useState","transitionTimeoutRef","isSmallOrLarger","useLayoutEffect","dialog","transitionDuration","handleBackdropClick","event","handleKeyDown","handleClose","jsx","styles","classNames","jsxs"],"mappings":"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"}
+{"version":3,"file":"Modal.js","sources":["../../../../../src/components/Common/UI/Modal/Modal.tsx"],"sourcesContent":["import { useLayoutEffect, useRef, useState } from 'react'\nimport classNames from 'classnames'\nimport { type ModalProps, ModalDefaults } from './ModalTypes'\nimport styles from './Modal.module.scss'\nimport { applyMissingDefaults } from '@/helpers/applyMissingDefaults'\nimport { useContainerBreakpoints } from '@/hooks/useContainerBreakpoints/useContainerBreakpoints'\nimport { useOverflowDetection } from '@/hooks/useOverflowDetection/useOverflowDetection'\nimport { useForkRef } from '@/hooks/useForkRef/useForkRef'\nimport { transitionDuration } from '@/contexts/ThemeProvider/theme'\n\n/**\n * Native `<dialog>`-backed modal with backdrop dismissal, Escape-key support, and a fixed footer.\n *\n * @remarks\n * Used as the base primitive for higher-level surfaces like {@link DialogProps | Dialog}. Body and footer content scroll independently when the body overflows.\n *\n * @param rawProps - See {@link ModalProps}.\n * @returns The rendered modal element.\n * @internal\n */\nexport function Modal(rawProps: ModalProps) {\n  const resolvedProps = applyMissingDefaults(rawProps, ModalDefaults)\n  const { isOpen, onClose, shouldCloseOnBackdropClick, children, footer, containerRef } =\n    resolvedProps\n\n  const dialogRef = useRef<HTMLDialogElement>(null)\n  const internalBackdropRef = useRef<HTMLDivElement>(null)\n  const modalRef = useRef<HTMLDivElement>(null)\n  const contentRef = useRef<HTMLDivElement>(null)\n\n  // Use callback ref to sync both internal and external refs\n  const backdropCallbackRef = useForkRef(internalBackdropRef, containerRef)\n\n  const breakpoints = useContainerBreakpoints({\n    ref: internalBackdropRef,\n  })\n\n  const isOverflowing = useOverflowDetection({\n    ref: contentRef,\n  })\n\n  const [isExiting, setIsExiting] = useState(false)\n  const transitionTimeoutRef = useRef<NodeJS.Timeout | null>(null)\n  const isSmallOrLarger = breakpoints.includes('small')\n\n  useLayoutEffect(() => {\n    const dialog = dialogRef.current\n    if (!dialog) return\n\n    if (transitionTimeoutRef.current) {\n      clearTimeout(transitionTimeoutRef.current)\n    }\n\n    if (isOpen && !dialog.open) {\n      dialog.showModal()\n      requestAnimationFrame(() => {\n        dialog.setAttribute('data-show', 'true')\n      })\n    } else if (!isOpen && dialog.open) {\n      setIsExiting(true)\n      transitionTimeoutRef.current = setTimeout(() => {\n        dialog.close()\n        dialog.removeAttribute('data-show')\n        setIsExiting(false)\n      }, transitionDuration)\n    }\n\n    return () => {\n      if (transitionTimeoutRef.current) {\n        clearTimeout(transitionTimeoutRef.current)\n      }\n    }\n  }, [isOpen])\n\n  const handleBackdropClick = (event: React.MouseEvent<HTMLDivElement>) => {\n    if (event.target === event.currentTarget && shouldCloseOnBackdropClick) {\n      onClose?.()\n    }\n  }\n\n  const handleKeyDown = (event: React.KeyboardEvent<HTMLDivElement>) => {\n    if (event.key === 'Escape') {\n      onClose?.()\n    }\n  }\n\n  const handleClose = () => {\n    if (onClose) {\n      onClose()\n    }\n  }\n\n  return (\n    <dialog\n      ref={dialogRef}\n      className={styles.dialog}\n      onClose={handleClose}\n      data-exiting={isExiting || undefined}\n    >\n      <div\n        ref={backdropCallbackRef}\n        className={classNames(styles.backdrop, {\n          [styles.backdropSmall as string]: isSmallOrLarger,\n        })}\n        onClick={handleBackdropClick}\n        onKeyDown={handleKeyDown}\n        role=\"presentation\"\n      >\n        <div\n          ref={modalRef}\n          className={classNames(styles.modal, {\n            [styles.modalSmall as string]: isSmallOrLarger,\n            [styles.modalOverflowing as string]: isOverflowing,\n          })}\n        >\n          {children && (\n            <div\n              ref={contentRef}\n              className={classNames(styles.content, {\n                [styles.contentScrollable as string]: isOverflowing,\n              })}\n            >\n              {children}\n            </div>\n          )}\n          {footer && (\n            <div\n              className={classNames(styles.footer, {\n                [styles.footerFixed as string]: isOverflowing,\n              })}\n            >\n              {footer}\n            </div>\n          )}\n        </div>\n      </div>\n    </dialog>\n  )\n}\n"],"names":["Modal","rawProps","resolvedProps","applyMissingDefaults","ModalDefaults","isOpen","onClose","shouldCloseOnBackdropClick","children","footer","containerRef","dialogRef","useRef","internalBackdropRef","modalRef","contentRef","backdropCallbackRef","useForkRef","breakpoints","useContainerBreakpoints","isOverflowing","useOverflowDetection","isExiting","setIsExiting","useState","transitionTimeoutRef","isSmallOrLarger","useLayoutEffect","dialog","transitionDuration","handleBackdropClick","event","handleKeyDown","handleClose","jsx","styles","classNames","jsxs"],"mappings":"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"}

package/dist/components/Common/UI/Modal/ModalTypes.d.ts

@@ -1,7 +1,15 @@
 import { ReactNode } from 'react';
+/**
+ * Props your `Modal` implementation must accept from the component adapter.
+ * Renders a modal overlay with body and footer content.
+ *
+ * @public
+ */
 export interface ModalProps {
     /**
      * Controls whether the modal is open or closed
+     *
+     * @defaultValue `false`
      */
     isOpen?: boolean;
     /**
@@ -10,6 +18,8 @@ export interface ModalProps {
     onClose?: () => void;
     /**
      * Whether clicking the backdrop should close the modal
+     *
+     * @defaultValue `false`
      */
     shouldCloseOnBackdropClick?: boolean;
     /**
@@ -26,7 +36,9 @@ export interface ModalProps {
     containerRef?: React.RefObject<HTMLDivElement | null>;
 }
 /**
- * Default prop values for Modal component.
+ * Default prop values for the {@link Modal} component.
+ *
+ * @internal
  */
 export declare const ModalDefaults: {
     readonly isOpen: false;

package/dist/components/Common/UI/Modal/ModalTypes.js.map

@@ -1 +1 @@
-{"version":3,"file":"ModalTypes.js","sources":["../../../../../src/components/Common/UI/Modal/ModalTypes.ts"],"sourcesContent":["import type { ReactNode } from 'react'\n\nexport interface ModalProps {\n  /**\n   * Controls whether the modal is open or closed\n   */\n  isOpen?: boolean\n  /**\n   * Callback function called when the modal should be closed\n   */\n  onClose?: () => void\n  /**\n   * Whether clicking the backdrop should close the modal\n   */\n  shouldCloseOnBackdropClick?: boolean\n  /**\n   * Main content to be rendered in the modal body\n   */\n  children?: ReactNode\n  /**\n   * Footer content to be rendered at the bottom of the modal\n   */\n  footer?: ReactNode\n  /**\n   * Optional ref to the backdrop container\n   */\n  containerRef?: React.RefObject<HTMLDivElement | null>\n}\n\n/**\n * Default prop values for Modal component.\n */\nexport const ModalDefaults = {\n  isOpen: false,\n  shouldCloseOnBackdropClick: false,\n} as const satisfies Partial<ModalProps>\n"],"names":["ModalDefaults"],"mappings":"AAgCO,MAAMA,IAAgB;AAAA,EAC3B,QAAQ;AAAA,EACR,4BAA4B;AAC9B;"}
+{"version":3,"file":"ModalTypes.js","sources":["../../../../../src/components/Common/UI/Modal/ModalTypes.ts"],"sourcesContent":["import type { ReactNode } from 'react'\n\n/**\n * Props your `Modal` implementation must accept from the component adapter.\n * Renders a modal overlay with body and footer content.\n *\n * @public\n */\nexport interface ModalProps {\n  /**\n   * Controls whether the modal is open or closed\n   *\n   * @defaultValue `false`\n   */\n  isOpen?: boolean\n  /**\n   * Callback function called when the modal should be closed\n   */\n  onClose?: () => void\n  /**\n   * Whether clicking the backdrop should close the modal\n   *\n   * @defaultValue `false`\n   */\n  shouldCloseOnBackdropClick?: boolean\n  /**\n   * Main content to be rendered in the modal body\n   */\n  children?: ReactNode\n  /**\n   * Footer content to be rendered at the bottom of the modal\n   */\n  footer?: ReactNode\n  /**\n   * Optional ref to the backdrop container\n   */\n  containerRef?: React.RefObject<HTMLDivElement | null>\n}\n\n/**\n * Default prop values for the {@link Modal} component.\n *\n * @internal\n */\nexport const ModalDefaults = {\n  isOpen: false,\n  shouldCloseOnBackdropClick: false,\n} as const satisfies Partial<ModalProps>\n"],"names":["ModalDefaults"],"mappings":"AA4CO,MAAMA,IAAgB;AAAA,EAC3B,QAAQ;AAAA,EACR,4BAA4B;AAC9B;"}

package/dist/components/Common/UI/Modal/index.d.ts

@@ -1,3 +1,2 @@
 import "./types/i18next.d.ts"
 export { Modal } from './Modal';
-export type { ModalProps } from './ModalTypes';

package/dist/components/Common/UI/MultiSelectComboBox/MultiSelectComboBox.d.ts

@@ -1,2 +1,9 @@
 import { MultiSelectComboBoxProps } from './MultiSelectComboBoxTypes';
-export declare function MultiSelectComboBox({ className, description, errorMessage, id, inputRef: inputRefFromProps, isDisabled, isInvalid, isLoading, isRequired, label, name, onBlur, onChange, options, placeholder, value: selectedValues, shouldVisuallyHideLabel, }: MultiSelectComboBoxProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Combo box that lets the user pick multiple options, rendering each selection as a dismissable chip below the input.
+ *
+ * @param props - See {@link MultiSelectComboBoxProps}.
+ * @returns The rendered multi-select combo box field.
+ * @internal
+ */
+export declare function MultiSelectComboBox({ className, description, errorMessage, id, inputRef: inputRefFromProps, isDisabled, isInvalid, isLoading, isRequired, label, name, onBlur, onChange, options, placeholder, value: selectedValues, shouldVisuallyHideLabel, }: MultiSelectComboBoxProps): import("react").JSX.Element;