@gusto/embedded-react-sdk 0.46.2 → 0.47.0

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

@@ -1,2 +1,14 @@
 import { FileInputProps } from './FileInputTypes';
-export declare function FileInput(rawProps: FileInputProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * File upload input with drag-and-drop, file type filtering, and a preview of the selected file.
+ *
+ * @remarks
+ * Renders a drop zone with click-to-upload until a file is selected, then swaps to a
+ * preview row showing the file name, size, and a remove button. Wraps `react-aria-components`'
+ * `FileTrigger` and `DropZone` to provide accessible keyboard and screen reader support.
+ *
+ * @param rawProps - File input configuration including value, change handler, accepted types, and field layout props.
+ * @returns The rendered file input element.
+ * @internal
+ */
+export declare function FileInput(rawProps: FileInputProps): import("react").JSX.Element;

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

@@ -1 +1 @@
-{"version":3,"file":"FileInput.js","sources":["../../../../../src/components/Common/UI/FileInput/FileInput.tsx"],"sourcesContent":["import {\n  FileTrigger,\n  Button as AriaButton,\n  DropZone,\n  type DropItem,\n  type FileDropItem,\n} from 'react-aria-components'\nimport classNames from 'classnames'\nimport { Trans, useTranslation } from 'react-i18next'\nimport { useFieldIds } from '../hooks/useFieldIds'\nimport type { FileInputProps } from './FileInputTypes'\nimport { FileInputDefaults } from './FileInputTypes'\nimport styles from './FileInput.module.scss'\nimport { applyMissingDefaults } from '@/helpers/applyMissingDefaults'\nimport { FieldLayout } from '@/components/Common/FieldLayout'\nimport { Flex } from '@/components/Common/Flex'\nimport { ButtonIcon } from '@/components/Common/UI/Button/ButtonIcon'\nimport TrashCanIcon from '@/assets/icons/icon-trashcan.svg?react'\nimport FileIcon from '@/assets/icons/icon-file-outline.svg?react'\nimport PdfIcon from '@/assets/icons/icon-file-pdf.svg?react'\nimport PngIcon from '@/assets/icons/icon-file-png.svg?react'\nimport JpgIcon from '@/assets/icons/icon-file-jpg.svg?react'\n\nfunction getFileIcon(mimeType: string) {\n  if (mimeType === 'application/pdf') {\n    return PdfIcon\n  }\n\n  if (mimeType === 'image/png') {\n    return PngIcon\n  }\n\n  if (mimeType === 'image/jpeg' || mimeType === 'image/jpg') {\n    return JpgIcon\n  }\n\n  return FileIcon\n}\n\nfunction isFileDropItem(item: DropItem): item is FileDropItem {\n  return item.kind === 'file'\n}\n\nfunction formatFileSize(bytes: number): string {\n  if (bytes === 0) return '0 Bytes'\n  const k = 1024\n  const sizes = ['Bytes', 'KB', 'MB', 'GB'] as const\n  const i = Math.floor(Math.log(bytes) / Math.log(k))\n  const size = parseFloat((bytes / Math.pow(k, i)).toFixed(0))\n  return `${size} ${sizes[i]}`\n}\n\nconst mimeToExtension: Record<string, string> = {\n  'image/jpeg': 'JPG',\n  'image/jpg': 'JPG',\n  'image/png': 'PNG',\n  'application/pdf': 'PDF',\n}\n\nfunction formatAcceptedTypes(accept: string[] | undefined): string | null {\n  if (!accept || accept.length === 0 || accept.includes('*/*')) return null\n\n  const extensions = accept\n    .map(type => {\n      if (type.startsWith('.')) {\n        return type.slice(1).toUpperCase()\n      }\n      return mimeToExtension[type]\n    })\n    .filter(Boolean)\n\n  if (extensions.length === 0) return null\n\n  const uniqueExtensions = [...new Set(extensions)]\n  return uniqueExtensions.join(', ')\n}\n\nexport function FileInput(rawProps: FileInputProps) {\n  const { t } = useTranslation('common')\n  const resolvedProps = applyMissingDefaults(rawProps, FileInputDefaults)\n  const {\n    label,\n    description,\n    errorMessage,\n    isRequired,\n    isInvalid,\n    isDisabled,\n    id,\n    value,\n    onChange,\n    onBlur,\n    accept,\n    className,\n    'aria-describedby': ariaDescribedByFromProps,\n  } = resolvedProps\n\n  const { inputId, errorMessageId, descriptionId, ariaDescribedBy } = useFieldIds({\n    inputId: id,\n    errorMessage,\n    description,\n    ariaDescribedBy: ariaDescribedByFromProps,\n  })\n\n  const handleSelect = (files: FileList | null) => {\n    const file = files?.[0] ?? null\n    onChange(file)\n  }\n\n  const handleDrop = async (e: { items: DropItem[] }) => {\n    const fileItem = e.items.find(isFileDropItem)\n    if (fileItem) {\n      const file = await fileItem.getFile()\n      onChange(file)\n    }\n  }\n\n  const getDropOperation = (types: { has: (type: string) => boolean }) => {\n    const acceptedTypes = accept ?? ['*/*']\n    const hasAcceptedType = acceptedTypes.some(type => {\n      if (type === '*/*') return true\n      if (type.startsWith('.')) {\n        return types.has('application/octet-stream') || types.has('Files')\n      }\n      return types.has(type)\n    })\n    return hasAcceptedType ? 'copy' : 'cancel'\n  }\n\n  const handleRemove = () => {\n    onChange(null)\n  }\n\n  const FileTypeIcon = value ? getFileIcon(value.type) : null\n\n  return (\n    <FieldLayout\n      label={label}\n      errorMessage={errorMessage}\n      isRequired={isRequired}\n      htmlFor={inputId}\n      errorMessageId={errorMessageId}\n      descriptionId={descriptionId}\n      className={className}\n      shouldVisuallyHideLabel\n      withErrorIcon={false}\n    >\n      <div\n        className={styles.root}\n        data-disabled={isDisabled || undefined}\n        data-invalid={isInvalid || undefined}\n      >\n        {value ? (\n          <div\n            className={classNames(styles.filePreview, { [styles.disabled as string]: isDisabled })}\n          >\n            <Flex alignItems=\"center\" gap={12}>\n              <div className={styles.fileIcon}>\n                {FileTypeIcon && <FileTypeIcon aria-hidden=\"true\" />}\n              </div>\n              <div className={styles.fileInfo}>\n                <Flex flexDirection=\"column\" gap={0}>\n                  <span className={styles.fileName}>{value.name}</span>\n                  <span className={styles.fileSize}>{formatFileSize(value.size)}</span>\n                </Flex>\n              </div>\n              <ButtonIcon\n                aria-label={t('fileInput.removeFile')}\n                onClick={handleRemove}\n                isDisabled={isDisabled}\n              >\n                <TrashCanIcon aria-hidden=\"true\" className={styles.removeButton} />\n              </ButtonIcon>\n            </Flex>\n          </div>\n        ) : (\n          <DropZone\n            onDrop={handleDrop}\n            getDropOperation={getDropOperation}\n            className={styles.dropZone}\n          >\n            <FileTrigger onSelect={handleSelect} acceptedFileTypes={accept}>\n              <AriaButton\n                id={inputId}\n                isDisabled={isDisabled}\n                aria-describedby={ariaDescribedBy}\n                onBlur={onBlur}\n                className={styles.trigger}\n              >\n                <span className={styles.triggerContent}>\n                  <span className={styles.triggerText}>\n                    <Trans\n                      i18nKey=\"fileInput.uploadInstructions\"\n                      ns=\"common\"\n                      components={{ clickToUpload: <span className={styles.clickToUpload} /> }}\n                    />\n                  </span>\n                  {(formatAcceptedTypes(accept) || description) && (\n                    <span className={styles.hintContainer}>\n                      {formatAcceptedTypes(accept) && (\n                        <span className={styles.hint}>\n                          {t('fileInput.acceptedTypes', { types: formatAcceptedTypes(accept) })}\n                        </span>\n                      )}\n                      {description && (\n                        <span id={descriptionId} className={styles.hint}>\n                          {description}\n                        </span>\n                      )}\n                    </span>\n                  )}\n                </span>\n              </AriaButton>\n            </FileTrigger>\n          </DropZone>\n        )}\n      </div>\n    </FieldLayout>\n  )\n}\n"],"names":["getFileIcon","mimeType","PdfIcon","PngIcon","JpgIcon","FileIcon","isFileDropItem","item","formatFileSize","bytes","k","sizes","i","mimeToExtension","formatAcceptedTypes","accept","extensions","type","FileInput","rawProps","t","useTranslation","resolvedProps","applyMissingDefaults","FileInputDefaults","label","description","errorMessage","isRequired","isInvalid","isDisabled","id","value","onChange","onBlur","className","ariaDescribedByFromProps","inputId","errorMessageId","descriptionId","ariaDescribedBy","useFieldIds","handleSelect","files","file","handleDrop","e","fileItem","getDropOperation","types","handleRemove","FileTypeIcon","jsx","FieldLayout","styles","classNames","jsxs","Flex","ButtonIcon","TrashCanIcon","DropZone","FileTrigger","AriaButton","Trans"],"mappings":"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"}
+{"version":3,"file":"FileInput.js","sources":["../../../../../src/components/Common/UI/FileInput/FileInput.tsx"],"sourcesContent":["import {\n  FileTrigger,\n  Button as AriaButton,\n  DropZone,\n  type DropItem,\n  type FileDropItem,\n} from 'react-aria-components'\nimport classNames from 'classnames'\nimport { Trans, useTranslation } from 'react-i18next'\nimport { useFieldIds } from '../hooks/useFieldIds'\nimport type { FileInputProps } from './FileInputTypes'\nimport { FileInputDefaults } from './FileInputTypes'\nimport styles from './FileInput.module.scss'\nimport { applyMissingDefaults } from '@/helpers/applyMissingDefaults'\nimport { FieldLayout } from '@/components/Common/FieldLayout'\nimport { Flex } from '@/components/Common/Flex'\nimport { ButtonIcon } from '@/components/Common/UI/Button/ButtonIcon'\nimport TrashCanIcon from '@/assets/icons/icon-trashcan.svg?react'\nimport FileIcon from '@/assets/icons/icon-file-outline.svg?react'\nimport PdfIcon from '@/assets/icons/icon-file-pdf.svg?react'\nimport PngIcon from '@/assets/icons/icon-file-png.svg?react'\nimport JpgIcon from '@/assets/icons/icon-file-jpg.svg?react'\n\nfunction getFileIcon(mimeType: string) {\n  if (mimeType === 'application/pdf') {\n    return PdfIcon\n  }\n\n  if (mimeType === 'image/png') {\n    return PngIcon\n  }\n\n  if (mimeType === 'image/jpeg' || mimeType === 'image/jpg') {\n    return JpgIcon\n  }\n\n  return FileIcon\n}\n\nfunction isFileDropItem(item: DropItem): item is FileDropItem {\n  return item.kind === 'file'\n}\n\nfunction formatFileSize(bytes: number): string {\n  if (bytes === 0) return '0 Bytes'\n  const k = 1024\n  const sizes = ['Bytes', 'KB', 'MB', 'GB'] as const\n  const i = Math.floor(Math.log(bytes) / Math.log(k))\n  const size = parseFloat((bytes / Math.pow(k, i)).toFixed(0))\n  return `${size} ${sizes[i]}`\n}\n\nconst mimeToExtension: Record<string, string> = {\n  'image/jpeg': 'JPG',\n  'image/jpg': 'JPG',\n  'image/png': 'PNG',\n  'application/pdf': 'PDF',\n}\n\nfunction formatAcceptedTypes(accept: string[] | undefined): string | null {\n  if (!accept || accept.length === 0 || accept.includes('*/*')) return null\n\n  const extensions = accept\n    .map(type => {\n      if (type.startsWith('.')) {\n        return type.slice(1).toUpperCase()\n      }\n      return mimeToExtension[type]\n    })\n    .filter(Boolean)\n\n  if (extensions.length === 0) return null\n\n  const uniqueExtensions = [...new Set(extensions)]\n  return uniqueExtensions.join(', ')\n}\n\n/**\n * File upload input with drag-and-drop, file type filtering, and a preview of the selected file.\n *\n * @remarks\n * Renders a drop zone with click-to-upload until a file is selected, then swaps to a\n * preview row showing the file name, size, and a remove button. Wraps `react-aria-components`'\n * `FileTrigger` and `DropZone` to provide accessible keyboard and screen reader support.\n *\n * @param rawProps - File input configuration including value, change handler, accepted types, and field layout props.\n * @returns The rendered file input element.\n * @internal\n */\nexport function FileInput(rawProps: FileInputProps) {\n  const { t } = useTranslation('common')\n  const resolvedProps = applyMissingDefaults(rawProps, FileInputDefaults)\n  const {\n    label,\n    description,\n    errorMessage,\n    isRequired,\n    isInvalid,\n    isDisabled,\n    id,\n    value,\n    onChange,\n    onBlur,\n    accept,\n    className,\n    'aria-describedby': ariaDescribedByFromProps,\n  } = resolvedProps\n\n  const { inputId, errorMessageId, descriptionId, ariaDescribedBy } = useFieldIds({\n    inputId: id,\n    errorMessage,\n    description,\n    ariaDescribedBy: ariaDescribedByFromProps,\n  })\n\n  const handleSelect = (files: FileList | null) => {\n    const file = files?.[0] ?? null\n    onChange(file)\n  }\n\n  const handleDrop = async (e: { items: DropItem[] }) => {\n    const fileItem = e.items.find(isFileDropItem)\n    if (fileItem) {\n      const file = await fileItem.getFile()\n      onChange(file)\n    }\n  }\n\n  const getDropOperation = (types: { has: (type: string) => boolean }) => {\n    const acceptedTypes = accept ?? ['*/*']\n    const hasAcceptedType = acceptedTypes.some(type => {\n      if (type === '*/*') return true\n      if (type.startsWith('.')) {\n        return types.has('application/octet-stream') || types.has('Files')\n      }\n      return types.has(type)\n    })\n    return hasAcceptedType ? 'copy' : 'cancel'\n  }\n\n  const handleRemove = () => {\n    onChange(null)\n  }\n\n  const FileTypeIcon = value ? getFileIcon(value.type) : null\n\n  return (\n    <FieldLayout\n      label={label}\n      errorMessage={errorMessage}\n      isRequired={isRequired}\n      htmlFor={inputId}\n      errorMessageId={errorMessageId}\n      descriptionId={descriptionId}\n      className={className}\n      shouldVisuallyHideLabel\n      withErrorIcon={false}\n    >\n      <div\n        className={styles.root}\n        data-disabled={isDisabled || undefined}\n        data-invalid={isInvalid || undefined}\n      >\n        {value ? (\n          <div\n            className={classNames(styles.filePreview, { [styles.disabled as string]: isDisabled })}\n          >\n            <Flex alignItems=\"center\" gap={12}>\n              <div className={styles.fileIcon}>\n                {FileTypeIcon && <FileTypeIcon aria-hidden=\"true\" />}\n              </div>\n              <div className={styles.fileInfo}>\n                <Flex flexDirection=\"column\" gap={0}>\n                  <span className={styles.fileName}>{value.name}</span>\n                  <span className={styles.fileSize}>{formatFileSize(value.size)}</span>\n                </Flex>\n              </div>\n              <ButtonIcon\n                aria-label={t('fileInput.removeFile')}\n                onClick={handleRemove}\n                isDisabled={isDisabled}\n              >\n                <TrashCanIcon aria-hidden=\"true\" className={styles.removeButton} />\n              </ButtonIcon>\n            </Flex>\n          </div>\n        ) : (\n          <DropZone\n            onDrop={handleDrop}\n            getDropOperation={getDropOperation}\n            className={styles.dropZone}\n          >\n            <FileTrigger onSelect={handleSelect} acceptedFileTypes={accept}>\n              <AriaButton\n                id={inputId}\n                isDisabled={isDisabled}\n                aria-describedby={ariaDescribedBy}\n                onBlur={onBlur}\n                className={styles.trigger}\n              >\n                <span className={styles.triggerContent}>\n                  <span className={styles.triggerText}>\n                    <Trans\n                      i18nKey=\"fileInput.uploadInstructions\"\n                      ns=\"common\"\n                      components={{ clickToUpload: <span className={styles.clickToUpload} /> }}\n                    />\n                  </span>\n                  {(formatAcceptedTypes(accept) || description) && (\n                    <span className={styles.hintContainer}>\n                      {formatAcceptedTypes(accept) && (\n                        <span className={styles.hint}>\n                          {t('fileInput.acceptedTypes', { types: formatAcceptedTypes(accept) })}\n                        </span>\n                      )}\n                      {description && (\n                        <span id={descriptionId} className={styles.hint}>\n                          {description}\n                        </span>\n                      )}\n                    </span>\n                  )}\n                </span>\n              </AriaButton>\n            </FileTrigger>\n          </DropZone>\n        )}\n      </div>\n    </FieldLayout>\n  )\n}\n"],"names":["getFileIcon","mimeType","PdfIcon","PngIcon","JpgIcon","FileIcon","isFileDropItem","item","formatFileSize","bytes","k","sizes","i","mimeToExtension","formatAcceptedTypes","accept","extensions","type","FileInput","rawProps","t","useTranslation","resolvedProps","applyMissingDefaults","FileInputDefaults","label","description","errorMessage","isRequired","isInvalid","isDisabled","id","value","onChange","onBlur","className","ariaDescribedByFromProps","inputId","errorMessageId","descriptionId","ariaDescribedBy","useFieldIds","handleSelect","files","file","handleDrop","e","fileItem","getDropOperation","types","handleRemove","FileTypeIcon","jsx","FieldLayout","styles","classNames","jsxs","Flex","ButtonIcon","TrashCanIcon","DropZone","FileTrigger","AriaButton","Trans"],"mappings":"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"}

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,5 +1,14 @@
 import { InputHTMLAttributes, ReactNode, Ref } from 'react';
-export interface InputProps extends Pick<InputHTMLAttributes<HTMLInputElement>, 'className' | 'id' | 'name' | 'placeholder' | 'type' | 'value' | 'onChange' | 'onBlur' | 'aria-describedby' | 'aria-labelledby' | 'aria-invalid' | 'min' | 'max' | 'maxLength'> {
+/**
+ * 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  | '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":"AA4CO,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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"}