@gusto/embedded-react-sdk 0.47.0 → 0.48.0

package/dist/components/Common/EmptyData/EmptyData.js.map

@@ -1 +1 @@
-{"version":3,"file":"EmptyData.js","sources":["../../../../src/components/Common/EmptyData/EmptyData.tsx"],"sourcesContent":["import { useTranslation } from 'react-i18next'\nimport { Flex } from '../Flex/Flex'\nimport styles from './EmptyData.module.scss'\nimport magnifyingGlass from '@/assets/icons/magnifyingGlass.png'\nimport { useComponentContext } from '@/contexts/ComponentAdapter/useComponentContext'\n\ntype EmptyDataProps = {\n  title?: string\n  description?: string\n  children?: React.ReactNode\n  /**\n   * When set, replaces the default search (magnifying glass) illustration.\n   */\n  icon?: React.ReactNode\n}\nexport function EmptyData({ title, description, children, icon }: EmptyDataProps) {\n  const { t } = useTranslation()\n  const { Text } = useComponentContext()\n  return (\n    <div className={styles.emptyData} data-testid=\"emptydata\">\n      <Flex flexDirection=\"column\" alignItems=\"center\">\n        {icon ? (\n          <span className={styles.iconSlot}>{icon}</span>\n        ) : (\n          <img src={magnifyingGlass} alt={t('icons.magnifyingGlass')} className={styles.image} />\n        )}\n        <div className={styles.textContent}>\n          {title && (\n            <Text weight=\"bold\" className={styles.title}>\n              {title}\n            </Text>\n          )}\n          {description && <Text>{description}</Text>}\n        </div>\n        {children && children}\n      </Flex>\n    </div>\n  )\n}\n"],"names":["EmptyData","title","description","children","icon","t","useTranslation","Text","useComponentContext","jsx","styles","jsxs","Flex","magnifyingGlass"],"mappings":";;;;;;AAeO,SAASA,EAAU,EAAE,OAAAC,GAAO,aAAAC,GAAa,UAAAC,GAAU,MAAAC,KAAwB;AAChF,QAAM,EAAE,GAAAC,EAAA,IAAMC,EAAA,GACR,EAAE,MAAAC,EAAA,IAASC,EAAA;AACjB,SACE,gBAAAC,EAAC,OAAA,EAAI,WAAWC,EAAO,WAAW,eAAY,aAC5C,UAAA,gBAAAC,EAACC,GAAA,EAAK,eAAc,UAAS,YAAW,UACrC,UAAA;AAAA,IAAAR,sBACE,QAAA,EAAK,WAAWM,EAAO,UAAW,aAAK,IAExC,gBAAAD,EAAC,OAAA,EAAI,KAAKI,GAAiB,KAAKR,EAAE,uBAAuB,GAAG,WAAWK,EAAO,OAAO;AAAA,IAEvF,gBAAAC,EAAC,OAAA,EAAI,WAAWD,EAAO,aACpB,UAAA;AAAA,MAAAT,uBACEM,GAAA,EAAK,QAAO,QAAO,WAAWG,EAAO,OACnC,UAAAT,EAAA,CACH;AAAA,MAEDC,KAAe,gBAAAO,EAACF,GAAA,EAAM,UAAAL,EAAA,CAAY;AAAA,IAAA,GACrC;AAAA,IACCC,KAAYA;AAAA,EAAA,EAAA,CACf,EAAA,CACF;AAEJ;"}
+{"version":3,"file":"EmptyData.js","sources":["../../../../src/components/Common/EmptyData/EmptyData.tsx"],"sourcesContent":["import { useTranslation } from 'react-i18next'\nimport { Flex } from '../Flex/Flex'\nimport styles from './EmptyData.module.scss'\nimport magnifyingGlass from '@/assets/icons/magnifyingGlass.png'\nimport { useComponentContext } from '@/contexts/ComponentAdapter/useComponentContext'\n\ntype EmptyDataProps = {\n  title?: string\n  description?: string\n  children?: React.ReactNode\n  /**\n   * When set, replaces the default search (magnifying glass) illustration.\n   */\n  icon?: React.ReactNode\n}\n/** @internal */\nexport function EmptyData({ title, description, children, icon }: EmptyDataProps) {\n  const { t } = useTranslation()\n  const { Text } = useComponentContext()\n  return (\n    <div className={styles.emptyData} data-testid=\"emptydata\">\n      <Flex flexDirection=\"column\" alignItems=\"center\">\n        {icon ? (\n          <span className={styles.iconSlot}>{icon}</span>\n        ) : (\n          <img src={magnifyingGlass} alt={t('icons.magnifyingGlass')} className={styles.image} />\n        )}\n        <div className={styles.textContent}>\n          {title && (\n            <Text weight=\"bold\" className={styles.title}>\n              {title}\n            </Text>\n          )}\n          {description && <Text>{description}</Text>}\n        </div>\n        {children && children}\n      </Flex>\n    </div>\n  )\n}\n"],"names":["EmptyData","title","description","children","icon","t","useTranslation","Text","useComponentContext","jsx","styles","jsxs","Flex","magnifyingGlass"],"mappings":";;;;;;AAgBO,SAASA,EAAU,EAAE,OAAAC,GAAO,aAAAC,GAAa,UAAAC,GAAU,MAAAC,KAAwB;AAChF,QAAM,EAAE,GAAAC,EAAA,IAAMC,EAAA,GACR,EAAE,MAAAC,EAAA,IAASC,EAAA;AACjB,SACE,gBAAAC,EAAC,OAAA,EAAI,WAAWC,EAAO,WAAW,eAAY,aAC5C,UAAA,gBAAAC,EAACC,GAAA,EAAK,eAAc,UAAS,YAAW,UACrC,UAAA;AAAA,IAAAR,sBACE,QAAA,EAAK,WAAWM,EAAO,UAAW,aAAK,IAExC,gBAAAD,EAAC,OAAA,EAAI,KAAKI,GAAiB,KAAKR,EAAE,uBAAuB,GAAG,WAAWK,EAAO,OAAO;AAAA,IAEvF,gBAAAC,EAAC,OAAA,EAAI,WAAWD,EAAO,aACpB,UAAA;AAAA,MAAAT,uBACEM,GAAA,EAAK,QAAO,QAAO,WAAWG,EAAO,OACnC,UAAAT,EAAA,CACH;AAAA,MAEDC,KAAe,gBAAAO,EAACF,GAAA,EAAM,UAAAL,EAAA,CAAY;AAAA,IAAA,GACrC;AAAA,IACCC,KAAYA;AAAA,EAAA,EAAA,CACf,EAAA,CACF;AAEJ;"}

package/dist/components/Common/FadeIn/FadeIn.d.ts

@@ -1,4 +1,5 @@
 import { FC, ReactNode } from 'react';
+/** @internal */
 export declare const FadeIn: FC<{
     children: ReactNode;
 }>;

package/dist/components/Common/FadeIn/FadeIn.js.map

@@ -1 +1 @@
-{"version":3,"file":"FadeIn.js","sources":["../../../../src/components/Common/FadeIn/FadeIn.tsx"],"sourcesContent":["import type { FC, ReactNode } from 'react'\nimport { useState, useEffect } from 'react'\nimport styles from './FadeIn.module.scss'\n\nexport const FadeIn: FC<{ children: ReactNode }> = ({ children }) => {\n  const [visible, setVisible] = useState(false)\n\n  useEffect(() => {\n    const timeout = requestAnimationFrame(() => {\n      setVisible(true)\n    })\n    return () => {\n      cancelAnimationFrame(timeout)\n    }\n  }, [])\n\n  return <div className={`${styles.fade} ${visible ? styles.fadeIn : ''}`}>{children}</div>\n}\n"],"names":["FadeIn","children","visible","setVisible","useState","useEffect","timeout","jsx","styles"],"mappings":";;;AAIO,MAAMA,IAAsC,CAAC,EAAE,UAAAC,QAAe;AACnE,QAAM,CAACC,GAASC,CAAU,IAAIC,EAAS,EAAK;AAE5C,SAAAC,EAAU,MAAM;AACd,UAAMC,IAAU,sBAAsB,MAAM;AAC1C,MAAAH,EAAW,EAAI;AAAA,IACjB,CAAC;AACD,WAAO,MAAM;AACX,2BAAqBG,CAAO;AAAA,IAC9B;AAAA,EACF,GAAG,CAAA,CAAE,GAEE,gBAAAC,EAAC,OAAA,EAAI,WAAW,GAAGC,EAAO,IAAI,IAAIN,IAAUM,EAAO,SAAS,EAAE,IAAK,UAAAP,EAAA,CAAS;AACrF;"}
+{"version":3,"file":"FadeIn.js","sources":["../../../../src/components/Common/FadeIn/FadeIn.tsx"],"sourcesContent":["import type { FC, ReactNode } from 'react'\nimport { useState, useEffect } from 'react'\nimport styles from './FadeIn.module.scss'\n\n/** @internal */\nexport const FadeIn: FC<{ children: ReactNode }> = ({ children }) => {\n  const [visible, setVisible] = useState(false)\n\n  useEffect(() => {\n    const timeout = requestAnimationFrame(() => {\n      setVisible(true)\n    })\n    return () => {\n      cancelAnimationFrame(timeout)\n    }\n  }, [])\n\n  return <div className={`${styles.fade} ${visible ? styles.fadeIn : ''}`}>{children}</div>\n}\n"],"names":["FadeIn","children","visible","setVisible","useState","useEffect","timeout","jsx","styles"],"mappings":";;;AAKO,MAAMA,IAAsC,CAAC,EAAE,UAAAC,QAAe;AACnE,QAAM,CAACC,GAASC,CAAU,IAAIC,EAAS,EAAK;AAE5C,SAAAC,EAAU,MAAM;AACd,UAAMC,IAAU,sBAAsB,MAAM;AAC1C,MAAAH,EAAW,EAAI;AAAA,IACjB,CAAC;AACD,WAAO,MAAM;AACX,2BAAqBG,CAAO;AAAA,IAC9B;AAAA,EACF,GAAG,CAAA,CAAE,GAEE,gBAAAC,EAAC,OAAA,EAAI,WAAW,GAAGC,EAAO,IAAI,IAAIN,IAAUM,EAAO,SAAS,EAAE,IAAK,UAAAP,EAAA,CAAS;AACrF;"}

package/dist/components/Common/FieldCaption/FieldCaption.d.ts

@@ -1,9 +1,17 @@
+/** @internal */
 export interface FieldCaptionProps {
+    /** Caption content rendered inside the label or legend element. */
     children: React.ReactNode;
+    /** HTML element to render as — `label` for individual inputs, `legend` for fieldsets. */
     as?: 'label' | 'legend';
+    /** Associates a `label` with an input by id. Ignored when `as` is `legend`. */
     htmlFor?: string;
+    /** When false, appends a localized optional indicator after the caption. */
     isRequired?: boolean;
+    /** Visually hides the caption while keeping it available to assistive technology. */
     isVisuallyHidden?: boolean;
+    /** Additional class names appended to the root element. */
     className?: string;
 }
+/** @internal */
 export declare const FieldCaption: React.FC<FieldCaptionProps>;

package/dist/components/Common/FieldCaption/FieldCaption.js.map

@@ -1 +1 @@
-{"version":3,"file":"FieldCaption.js","sources":["../../../../src/components/Common/FieldCaption/FieldCaption.tsx"],"sourcesContent":["import { useTranslation } from 'react-i18next'\nimport classNames from 'classnames'\nimport { VisuallyHidden } from '../VisuallyHidden'\nimport styles from './FieldCaption.module.scss'\n\nexport interface FieldCaptionProps {\n  children: React.ReactNode\n  as?: 'label' | 'legend'\n  htmlFor?: string\n  isRequired?: boolean\n  isVisuallyHidden?: boolean\n  className?: string\n}\n\nexport const FieldCaption: React.FC<FieldCaptionProps> = ({\n  children,\n  as = 'label',\n  htmlFor,\n  isRequired = false,\n  isVisuallyHidden = false,\n  className,\n}: FieldCaptionProps) => {\n  const { t } = useTranslation('common')\n  const Component = as\n\n  const content = (\n    <Component\n      className={classNames(styles.root, className)}\n      htmlFor={as === 'label' ? htmlFor : undefined}\n    >\n      {children}\n      {!isRequired && <span className={styles.optionalLabel}> {t('optionalLabel')}</span>}\n    </Component>\n  )\n\n  return isVisuallyHidden ? <VisuallyHidden>{content}</VisuallyHidden> : content\n}\n"],"names":["FieldCaption","children","as","htmlFor","isRequired","isVisuallyHidden","className","t","useTranslation","content","jsxs","classNames","styles","jsx","VisuallyHidden"],"mappings":";;;;;AAcO,MAAMA,IAA4C,CAAC;AAAA,EACxD,UAAAC;AAAA,EACA,IAAAC,IAAK;AAAA,EACL,SAAAC;AAAA,EACA,YAAAC,IAAa;AAAA,EACb,kBAAAC,IAAmB;AAAA,EACnB,WAAAC;AACF,MAAyB;AACvB,QAAM,EAAE,GAAAC,EAAA,IAAMC,EAAe,QAAQ,GAG/BC,IACJ,gBAAAC;AAAA,IAHgBR;AAAA,IAGf;AAAA,MACC,WAAWS,EAAWC,EAAO,MAAMN,CAAS;AAAA,MAC5C,SAASJ,MAAO,UAAUC,IAAU;AAAA,MAEnC,UAAA;AAAA,QAAAF;AAAA,QACA,CAACG,KAAc,gBAAAM,EAAC,QAAA,EAAK,WAAWE,EAAO,eAAe,UAAA;AAAA,UAAA;AAAA,UAAEL,EAAE,eAAe;AAAA,QAAA,EAAA,CAAE;AAAA,MAAA;AAAA,IAAA;AAAA,EAAA;AAIhF,SAAOF,IAAmB,gBAAAQ,EAACC,GAAA,EAAgB,UAAAL,EAAA,CAAQ,IAAoBA;AACzE;"}
+{"version":3,"file":"FieldCaption.js","sources":["../../../../src/components/Common/FieldCaption/FieldCaption.tsx"],"sourcesContent":["import { useTranslation } from 'react-i18next'\nimport classNames from 'classnames'\nimport { VisuallyHidden } from '../VisuallyHidden'\nimport styles from './FieldCaption.module.scss'\n\n/** @internal */\nexport interface FieldCaptionProps {\n  /** Caption content rendered inside the label or legend element. */\n  children: React.ReactNode\n  /** HTML element to render as — `label` for individual inputs, `legend` for fieldsets. */\n  as?: 'label' | 'legend'\n  /** Associates a `label` with an input by id. Ignored when `as` is `legend`. */\n  htmlFor?: string\n  /** When false, appends a localized optional indicator after the caption. */\n  isRequired?: boolean\n  /** Visually hides the caption while keeping it available to assistive technology. */\n  isVisuallyHidden?: boolean\n  /** Additional class names appended to the root element. */\n  className?: string\n}\n\n/** @internal */\nexport const FieldCaption: React.FC<FieldCaptionProps> = ({\n  children,\n  as = 'label',\n  htmlFor,\n  isRequired = false,\n  isVisuallyHidden = false,\n  className,\n}: FieldCaptionProps) => {\n  const { t } = useTranslation('common')\n  const Component = as\n\n  const content = (\n    <Component\n      className={classNames(styles.root, className)}\n      htmlFor={as === 'label' ? htmlFor : undefined}\n    >\n      {children}\n      {!isRequired && <span className={styles.optionalLabel}> {t('optionalLabel')}</span>}\n    </Component>\n  )\n\n  return isVisuallyHidden ? <VisuallyHidden>{content}</VisuallyHidden> : content\n}\n"],"names":["FieldCaption","children","as","htmlFor","isRequired","isVisuallyHidden","className","t","useTranslation","content","jsxs","classNames","styles","jsx","VisuallyHidden"],"mappings":";;;;;AAsBO,MAAMA,IAA4C,CAAC;AAAA,EACxD,UAAAC;AAAA,EACA,IAAAC,IAAK;AAAA,EACL,SAAAC;AAAA,EACA,YAAAC,IAAa;AAAA,EACb,kBAAAC,IAAmB;AAAA,EACnB,WAAAC;AACF,MAAyB;AACvB,QAAM,EAAE,GAAAC,EAAA,IAAMC,EAAe,QAAQ,GAG/BC,IACJ,gBAAAC;AAAA,IAHgBR;AAAA,IAGf;AAAA,MACC,WAAWS,EAAWC,EAAO,MAAMN,CAAS;AAAA,MAC5C,SAASJ,MAAO,UAAUC,IAAU;AAAA,MAEnC,UAAA;AAAA,QAAAF;AAAA,QACA,CAACG,KAAc,gBAAAM,EAAC,QAAA,EAAK,WAAWE,EAAO,eAAe,UAAA;AAAA,UAAA;AAAA,UAAEL,EAAE,eAAe;AAAA,QAAA,EAAA,CAAE;AAAA,MAAA;AAAA,IAAA;AAAA,EAAA;AAIhF,SAAOF,IAAmB,gBAAAQ,EAACC,GAAA,EAAgB,UAAAL,EAAA,CAAQ,IAAoBA;AACzE;"}

package/dist/components/Common/FieldDescription/FieldDescription.d.ts

@@ -3,5 +3,10 @@ interface FieldDescriptionProps {
     className?: string;
     id?: string;
 }
+/**
+ * Renders a field's helper description text beneath its label.
+ *
+ * @internal
+ */
 export declare const FieldDescription: React.FC<FieldDescriptionProps>;
 export {};

package/dist/components/Common/FieldDescription/FieldDescription.js.map

@@ -1 +1 @@
-{"version":3,"file":"FieldDescription.js","sources":["../../../../src/components/Common/FieldDescription/FieldDescription.tsx"],"sourcesContent":["import classNames from 'classnames'\nimport styles from './FieldDescription.module.scss'\n\ninterface FieldDescriptionProps {\n  children: React.ReactNode\n  className?: string\n  id?: string\n}\n\nexport const FieldDescription: React.FC<FieldDescriptionProps> = ({\n  children,\n  className,\n  ...props\n}: FieldDescriptionProps) => {\n  return (\n    children && (\n      <div {...props} className={classNames(styles.root, className)}>\n        {children}\n      </div>\n    )\n  )\n}\n"],"names":["FieldDescription","children","className","props","jsx","classNames","styles"],"mappings":";;;AASO,MAAMA,IAAoD,CAAC;AAAA,EAChE,UAAAC;AAAA,EACA,WAAAC;AAAA,EACA,GAAGC;AACL,MAEIF,KACE,gBAAAG,EAAC,OAAA,EAAK,GAAGD,GAAO,WAAWE,EAAWC,EAAO,MAAMJ,CAAS,GACzD,UAAAD,EAAA,CACH;"}
+{"version":3,"file":"FieldDescription.js","sources":["../../../../src/components/Common/FieldDescription/FieldDescription.tsx"],"sourcesContent":["import classNames from 'classnames'\nimport styles from './FieldDescription.module.scss'\n\ninterface FieldDescriptionProps {\n  children: React.ReactNode\n  className?: string\n  id?: string\n}\n\n/**\n * Renders a field's helper description text beneath its label.\n *\n * @internal\n */\nexport const FieldDescription: React.FC<FieldDescriptionProps> = ({\n  children,\n  className,\n  ...props\n}: FieldDescriptionProps) => {\n  return (\n    children && (\n      <div {...props} className={classNames(styles.root, className)}>\n        {children}\n      </div>\n    )\n  )\n}\n"],"names":["FieldDescription","children","className","props","jsx","classNames","styles"],"mappings":";;;AAcO,MAAMA,IAAoD,CAAC;AAAA,EAChE,UAAAC;AAAA,EACA,WAAAC;AAAA,EACA,GAAGC;AACL,MAEIF,KACE,gBAAAG,EAAC,OAAA,EAAK,GAAGD,GAAO,WAAWE,EAAWC,EAAO,MAAMJ,CAAS,GACzD,UAAAD,EAAA,CACH;"}

package/dist/components/Common/FieldErrorMessage/FieldErrorMessage.d.ts

@@ -2,5 +2,10 @@ import { HTMLAttributes } from 'react';
 interface FieldErrorMessageProps extends HTMLAttributes<HTMLParagraphElement> {
     withErrorIcon?: boolean;
 }
+/**
+ * Renders a field's validation error message via the component adapter's `Text` primitive.
+ *
+ * @internal
+ */
 export declare function FieldErrorMessage({ children, id, className, withErrorIcon, ...props }: FieldErrorMessageProps): false | "" | 0 | 0n | import("react").JSX.Element | null | undefined;
 export {};

package/dist/components/Common/FieldErrorMessage/FieldErrorMessage.js.map

@@ -1 +1 @@
-{"version":3,"file":"FieldErrorMessage.js","sources":["../../../../src/components/Common/FieldErrorMessage/FieldErrorMessage.tsx"],"sourcesContent":["import type { HTMLAttributes } from 'react'\nimport classNames from 'classnames'\nimport styles from './FieldErrorMessage.module.scss'\nimport { useComponentContext } from '@/contexts/ComponentAdapter/useComponentContext'\n\ninterface FieldErrorMessageProps extends HTMLAttributes<HTMLParagraphElement> {\n  withErrorIcon?: boolean\n}\n\nexport function FieldErrorMessage({\n  children,\n  id,\n  className,\n  withErrorIcon = true,\n  ...props\n}: FieldErrorMessageProps) {\n  const { Text } = useComponentContext()\n\n  return (\n    children && (\n      <Text\n        id={id}\n        className={classNames(styles.root, className, {\n          [styles.withErrorIcon as string]: withErrorIcon,\n        })}\n        {...props}\n      >\n        {children}\n      </Text>\n    )\n  )\n}\n"],"names":["FieldErrorMessage","children","id","className","withErrorIcon","props","Text","useComponentContext","jsx","classNames","styles"],"mappings":";;;;AASO,SAASA,EAAkB;AAAA,EAChC,UAAAC;AAAA,EACA,IAAAC;AAAA,EACA,WAAAC;AAAA,EACA,eAAAC,IAAgB;AAAA,EAChB,GAAGC;AACL,GAA2B;AACzB,QAAM,EAAE,MAAAC,EAAA,IAASC,EAAA;AAEjB,SACEN,KACE,gBAAAO;AAAA,IAACF;AAAA,IAAA;AAAA,MACC,IAAAJ;AAAA,MACA,WAAWO,EAAWC,EAAO,MAAMP,GAAW;AAAA,QAC5C,CAACO,EAAO,aAAuB,GAAGN;AAAA,MAAA,CACnC;AAAA,MACA,GAAGC;AAAA,MAEH,UAAAJ;AAAA,IAAA;AAAA,EAAA;AAIT;"}
+{"version":3,"file":"FieldErrorMessage.js","sources":["../../../../src/components/Common/FieldErrorMessage/FieldErrorMessage.tsx"],"sourcesContent":["import type { HTMLAttributes } from 'react'\nimport classNames from 'classnames'\nimport styles from './FieldErrorMessage.module.scss'\nimport { useComponentContext } from '@/contexts/ComponentAdapter/useComponentContext'\n\ninterface FieldErrorMessageProps extends HTMLAttributes<HTMLParagraphElement> {\n  withErrorIcon?: boolean\n}\n\n/**\n * Renders a field's validation error message via the component adapter's `Text` primitive.\n *\n * @internal\n */\nexport function FieldErrorMessage({\n  children,\n  id,\n  className,\n  withErrorIcon = true,\n  ...props\n}: FieldErrorMessageProps) {\n  const { Text } = useComponentContext()\n\n  return (\n    children && (\n      <Text\n        id={id}\n        className={classNames(styles.root, className, {\n          [styles.withErrorIcon as string]: withErrorIcon,\n        })}\n        {...props}\n      >\n        {children}\n      </Text>\n    )\n  )\n}\n"],"names":["FieldErrorMessage","children","id","className","withErrorIcon","props","Text","useComponentContext","jsx","classNames","styles"],"mappings":";;;;AAcO,SAASA,EAAkB;AAAA,EAChC,UAAAC;AAAA,EACA,IAAAC;AAAA,EACA,WAAAC;AAAA,EACA,eAAAC,IAAgB;AAAA,EAChB,GAAGC;AACL,GAA2B;AACzB,QAAM,EAAE,MAAAC,EAAA,IAASC,EAAA;AAEjB,SACEN,KACE,gBAAAO;AAAA,IAACF;AAAA,IAAA;AAAA,MACC,IAAAJ;AAAA,MACA,WAAWO,EAAWC,EAAO,MAAMP,GAAW;AAAA,QAC5C,CAACO,EAAO,aAAuB,GAAGN;AAAA,MAAA,CACnC;AAAA,MACA,GAAGC;AAAA,MAEH,UAAAJ;AAAA,IAAA;AAAA,EAAA;AAIT;"}

package/dist/components/Common/FieldLayout/FieldLayout.d.ts

@@ -1,2 +1,7 @@
 import { FieldLayoutProps } from './FieldLayoutTypes';
+/**
+ * Wraps a form control with its label, description, and error message in a consistent vertical layout.
+ *
+ * @internal
+ */
 export declare const FieldLayout: React.FC<FieldLayoutProps>;

package/dist/components/Common/FieldLayout/FieldLayout.js.map

@@ -1 +1 @@
-{"version":3,"file":"FieldLayout.js","sources":["../../../../src/components/Common/FieldLayout/FieldLayout.tsx"],"sourcesContent":["import classNames from 'classnames'\nimport { FieldDescription } from '../FieldDescription'\nimport { FieldErrorMessage } from '../FieldErrorMessage'\nimport { FieldCaption } from '../FieldCaption/FieldCaption'\nimport styles from './FieldLayout.module.scss'\nimport type { FieldLayoutProps } from './FieldLayoutTypes'\nimport { getDataProps } from '@/helpers/getDataProps'\n\nexport const FieldLayout: React.FC<FieldLayoutProps> = ({\n  label,\n  description,\n  descriptionId,\n  errorMessage,\n  errorMessageId,\n  children,\n  isRequired = false,\n  htmlFor,\n  shouldVisuallyHideLabel = false,\n  className,\n  withErrorIcon = true,\n  ...props\n}: FieldLayoutProps) => {\n  return (\n    <div className={classNames(styles.root, className)} {...getDataProps(props)}>\n      <div\n        className={classNames(styles.labelAndDescription, {\n          [styles.withVisibleLabel as string]: !shouldVisuallyHideLabel,\n          [styles.withDescription as string]: Boolean(description),\n        })}\n      >\n        <FieldCaption\n          htmlFor={htmlFor}\n          isRequired={isRequired}\n          isVisuallyHidden={shouldVisuallyHideLabel}\n        >\n          {label}\n        </FieldCaption>\n        <FieldDescription id={descriptionId}>{description}</FieldDescription>\n      </div>\n      {children}\n      <FieldErrorMessage\n        id={errorMessageId}\n        className={styles.errorMessage}\n        withErrorIcon={withErrorIcon}\n      >\n        {errorMessage}\n      </FieldErrorMessage>\n    </div>\n  )\n}\n"],"names":["FieldLayout","label","description","descriptionId","errorMessage","errorMessageId","children","isRequired","htmlFor","shouldVisuallyHideLabel","className","withErrorIcon","props","jsxs","classNames","styles","getDataProps","jsx","FieldCaption","FieldDescription","FieldErrorMessage"],"mappings":";;;;;;;AAQO,MAAMA,IAA0C,CAAC;AAAA,EACtD,OAAAC;AAAA,EACA,aAAAC;AAAA,EACA,eAAAC;AAAA,EACA,cAAAC;AAAA,EACA,gBAAAC;AAAA,EACA,UAAAC;AAAA,EACA,YAAAC,IAAa;AAAA,EACb,SAAAC;AAAA,EACA,yBAAAC,IAA0B;AAAA,EAC1B,WAAAC;AAAA,EACA,eAAAC,IAAgB;AAAA,EAChB,GAAGC;AACL,MAEI,gBAAAC,EAAC,OAAA,EAAI,WAAWC,EAAWC,EAAO,MAAML,CAAS,GAAI,GAAGM,EAAaJ,CAAK,GACxE,UAAA;AAAA,EAAA,gBAAAC;AAAA,IAAC;AAAA,IAAA;AAAA,MACC,WAAWC,EAAWC,EAAO,qBAAqB;AAAA,QAChD,CAACA,EAAO,gBAA0B,GAAG,CAACN;AAAA,QACtC,CAACM,EAAO,eAAyB,GAAG,EAAQb;AAAA,MAAW,CACxD;AAAA,MAED,UAAA;AAAA,QAAA,gBAAAe;AAAA,UAACC;AAAA,UAAA;AAAA,YACC,SAAAV;AAAA,YACA,YAAAD;AAAA,YACA,kBAAkBE;AAAA,YAEjB,UAAAR;AAAA,UAAA;AAAA,QAAA;AAAA,QAEH,gBAAAgB,EAACE,GAAA,EAAiB,IAAIhB,GAAgB,UAAAD,EAAA,CAAY;AAAA,MAAA;AAAA,IAAA;AAAA,EAAA;AAAA,EAEnDI;AAAA,EACD,gBAAAW;AAAA,IAACG;AAAA,IAAA;AAAA,MACC,IAAIf;AAAA,MACJ,WAAWU,EAAO;AAAA,MAClB,eAAAJ;AAAA,MAEC,UAAAP;AAAA,IAAA;AAAA,EAAA;AACH,GACF;"}
+{"version":3,"file":"FieldLayout.js","sources":["../../../../src/components/Common/FieldLayout/FieldLayout.tsx"],"sourcesContent":["import classNames from 'classnames'\nimport { FieldDescription } from '../FieldDescription'\nimport { FieldErrorMessage } from '../FieldErrorMessage'\nimport { FieldCaption } from '../FieldCaption/FieldCaption'\nimport styles from './FieldLayout.module.scss'\nimport type { FieldLayoutProps } from './FieldLayoutTypes'\nimport { getDataProps } from '@/helpers/getDataProps'\n\n/**\n * Wraps a form control with its label, description, and error message in a consistent vertical layout.\n *\n * @internal\n */\nexport const FieldLayout: React.FC<FieldLayoutProps> = ({\n  label,\n  description,\n  descriptionId,\n  errorMessage,\n  errorMessageId,\n  children,\n  isRequired = false,\n  htmlFor,\n  shouldVisuallyHideLabel = false,\n  className,\n  withErrorIcon = true,\n  ...props\n}: FieldLayoutProps) => {\n  return (\n    <div className={classNames(styles.root, className)} {...getDataProps(props)}>\n      <div\n        className={classNames(styles.labelAndDescription, {\n          [styles.withVisibleLabel as string]: !shouldVisuallyHideLabel,\n          [styles.withDescription as string]: Boolean(description),\n        })}\n      >\n        <FieldCaption\n          htmlFor={htmlFor}\n          isRequired={isRequired}\n          isVisuallyHidden={shouldVisuallyHideLabel}\n        >\n          {label}\n        </FieldCaption>\n        <FieldDescription id={descriptionId}>{description}</FieldDescription>\n      </div>\n      {children}\n      <FieldErrorMessage\n        id={errorMessageId}\n        className={styles.errorMessage}\n        withErrorIcon={withErrorIcon}\n      >\n        {errorMessage}\n      </FieldErrorMessage>\n    </div>\n  )\n}\n"],"names":["FieldLayout","label","description","descriptionId","errorMessage","errorMessageId","children","isRequired","htmlFor","shouldVisuallyHideLabel","className","withErrorIcon","props","jsxs","classNames","styles","getDataProps","jsx","FieldCaption","FieldDescription","FieldErrorMessage"],"mappings":";;;;;;;AAaO,MAAMA,IAA0C,CAAC;AAAA,EACtD,OAAAC;AAAA,EACA,aAAAC;AAAA,EACA,eAAAC;AAAA,EACA,cAAAC;AAAA,EACA,gBAAAC;AAAA,EACA,UAAAC;AAAA,EACA,YAAAC,IAAa;AAAA,EACb,SAAAC;AAAA,EACA,yBAAAC,IAA0B;AAAA,EAC1B,WAAAC;AAAA,EACA,eAAAC,IAAgB;AAAA,EAChB,GAAGC;AACL,MAEI,gBAAAC,EAAC,OAAA,EAAI,WAAWC,EAAWC,EAAO,MAAML,CAAS,GAAI,GAAGM,EAAaJ,CAAK,GACxE,UAAA;AAAA,EAAA,gBAAAC;AAAA,IAAC;AAAA,IAAA;AAAA,MACC,WAAWC,EAAWC,EAAO,qBAAqB;AAAA,QAChD,CAACA,EAAO,gBAA0B,GAAG,CAACN;AAAA,QACtC,CAACM,EAAO,eAAyB,GAAG,EAAQb;AAAA,MAAW,CACxD;AAAA,MAED,UAAA;AAAA,QAAA,gBAAAe;AAAA,UAACC;AAAA,UAAA;AAAA,YACC,SAAAV;AAAA,YACA,YAAAD;AAAA,YACA,kBAAkBE;AAAA,YAEjB,UAAAR;AAAA,UAAA;AAAA,QAAA;AAAA,QAEH,gBAAAgB,EAACE,GAAA,EAAiB,IAAIhB,GAAgB,UAAAD,EAAA,CAAY;AAAA,MAAA;AAAA,IAAA;AAAA,EAAA;AAAA,EAEnDI;AAAA,EACD,gBAAAW;AAAA,IAACG;AAAA,IAAA;AAAA,MACC,IAAIf;AAAA,MACJ,WAAWU,EAAO;AAAA,MAClB,eAAAJ;AAAA,MAEC,UAAAP;AAAA,IAAA;AAAA,EAAA;AACH,GACF;"}

package/dist/components/Common/FieldLayout/FieldLayoutTypes.d.ts

@@ -1,5 +1,14 @@
 import { ReactNode } from 'react';
 import { DataAttributes } from '../../../types/Helpers';
+/**
+ * Common layout props shared by form controls — label, description, error message, required state, and visual label hiding.
+ *
+ * @remarks
+ * Extended by the props interfaces of UI primitive components (such as `TextInputProps`, `SelectProps`, and `CheckboxGroupProps`)
+ * so each control exposes a consistent surface for labeling, helper text, and validation messaging.
+ *
+ * @public
+ */
 export interface SharedFieldLayoutProps extends DataAttributes {
     /**
      * Optional description text for the field
@@ -22,6 +31,9 @@ export interface SharedFieldLayoutProps extends DataAttributes {
      */
     shouldVisuallyHideLabel?: boolean;
 }
+/**
+ * @internal
+ */
 export interface InternalFieldLayoutProps {
     /**
      * Content to be rendered inside the field layout
@@ -48,5 +60,8 @@ export interface InternalFieldLayoutProps {
      */
     withErrorIcon?: boolean;
 }
+/**
+ * @internal
+ */
 export interface FieldLayoutProps extends SharedFieldLayoutProps, InternalFieldLayoutProps {
 }

package/dist/components/Common/Fieldset/Fieldset.d.ts

@@ -1,4 +1,5 @@
 import { SharedFieldLayoutProps } from '../FieldLayout/FieldLayoutTypes';
+/** @internal */
 export interface FieldsetProps extends Omit<SharedFieldLayoutProps, 'label' | 'shouldVisuallyHideLabel'> {
     children: React.ReactNode;
     description?: React.ReactNode;
@@ -8,4 +9,5 @@ export interface FieldsetProps extends Omit<SharedFieldLayoutProps, 'label' | 's
     shouldVisuallyHideLegend?: boolean;
     className?: string;
 }
+/** @internal */
 export declare const Fieldset: React.FC<FieldsetProps>;

package/dist/components/Common/Fieldset/Fieldset.js.map

@@ -1 +1 @@
-{"version":3,"file":"Fieldset.js","sources":["../../../../src/components/Common/Fieldset/Fieldset.tsx"],"sourcesContent":["import { useId } from 'react'\nimport classNames from 'classnames'\nimport { FieldDescription } from '../FieldDescription'\nimport { FieldErrorMessage } from '../FieldErrorMessage'\nimport { FieldCaption } from '../FieldCaption'\nimport type { SharedFieldLayoutProps } from '../FieldLayout/FieldLayoutTypes'\nimport styles from './Fieldset.module.scss'\nimport { getDataProps } from '@/helpers/getDataProps'\n\nexport interface FieldsetProps extends Omit<\n  SharedFieldLayoutProps,\n  'label' | 'shouldVisuallyHideLabel'\n> {\n  children: React.ReactNode\n  description?: React.ReactNode\n  errorMessage?: string\n  isRequired?: boolean\n  legend: React.ReactNode\n  shouldVisuallyHideLegend?: boolean\n  className?: string\n}\n\nexport const Fieldset: React.FC<FieldsetProps> = ({\n  children,\n  description,\n  errorMessage,\n  isRequired = false,\n  legend,\n  shouldVisuallyHideLegend = false,\n  className,\n  ...props\n}: FieldsetProps) => {\n  const generatedErrorMessageId = useId()\n  const errorMessageId = `error-message-${generatedErrorMessageId}`\n\n  return (\n    <fieldset\n      className={classNames(styles.root, className)}\n      aria-describedby={errorMessage ? errorMessageId : undefined}\n      {...getDataProps(props)}\n    >\n      <div\n        className={classNames(styles.legendAndDescription, {\n          [styles.withVisibleLegend as string]: !shouldVisuallyHideLegend,\n          [styles.withDescription as string]: Boolean(description),\n        })}\n      >\n        <FieldCaption\n          as=\"legend\"\n          isRequired={isRequired}\n          isVisuallyHidden={shouldVisuallyHideLegend}\n        >\n          {legend}\n        </FieldCaption>\n        <FieldDescription>{description}</FieldDescription>\n      </div>\n      {children}\n      <FieldErrorMessage\n        id={errorMessageId}\n        className={styles.errorMessage}\n        aria-live=\"polite\"\n        role=\"alert\"\n      >\n        {errorMessage}\n      </FieldErrorMessage>\n    </fieldset>\n  )\n}\n"],"names":["Fieldset","children","description","errorMessage","isRequired","legend","shouldVisuallyHideLegend","className","props","errorMessageId","useId","jsxs","classNames","styles","getDataProps","jsx","FieldCaption","FieldDescription","FieldErrorMessage"],"mappings":";;;;;;;;AAsBO,MAAMA,IAAoC,CAAC;AAAA,EAChD,UAAAC;AAAA,EACA,aAAAC;AAAA,EACA,cAAAC;AAAA,EACA,YAAAC,IAAa;AAAA,EACb,QAAAC;AAAA,EACA,0BAAAC,IAA2B;AAAA,EAC3B,WAAAC;AAAA,EACA,GAAGC;AACL,MAAqB;AAEnB,QAAMC,IAAiB,iBADSC,EAAA,CAC+B;AAE/D,SACE,gBAAAC;AAAA,IAAC;AAAA,IAAA;AAAA,MACC,WAAWC,EAAWC,EAAO,MAAMN,CAAS;AAAA,MAC5C,oBAAkBJ,IAAeM,IAAiB;AAAA,MACjD,GAAGK,EAAaN,CAAK;AAAA,MAEtB,UAAA;AAAA,QAAA,gBAAAG;AAAA,UAAC;AAAA,UAAA;AAAA,YACC,WAAWC,EAAWC,EAAO,sBAAsB;AAAA,cACjD,CAACA,EAAO,iBAA2B,GAAG,CAACP;AAAA,cACvC,CAACO,EAAO,eAAyB,GAAG,EAAQX;AAAA,YAAW,CACxD;AAAA,YAED,UAAA;AAAA,cAAA,gBAAAa;AAAA,gBAACC;AAAA,gBAAA;AAAA,kBACC,IAAG;AAAA,kBACH,YAAAZ;AAAA,kBACA,kBAAkBE;AAAA,kBAEjB,UAAAD;AAAA,gBAAA;AAAA,cAAA;AAAA,cAEH,gBAAAU,EAACE,KAAkB,UAAAf,EAAA,CAAY;AAAA,YAAA;AAAA,UAAA;AAAA,QAAA;AAAA,QAEhCD;AAAA,QACD,gBAAAc;AAAA,UAACG;AAAA,UAAA;AAAA,YACC,IAAIT;AAAA,YACJ,WAAWI,EAAO;AAAA,YAClB,aAAU;AAAA,YACV,MAAK;AAAA,YAEJ,UAAAV;AAAA,UAAA;AAAA,QAAA;AAAA,MACH;AAAA,IAAA;AAAA,EAAA;AAGN;"}
+{"version":3,"file":"Fieldset.js","sources":["../../../../src/components/Common/Fieldset/Fieldset.tsx"],"sourcesContent":["import { useId } from 'react'\nimport classNames from 'classnames'\nimport { FieldDescription } from '../FieldDescription'\nimport { FieldErrorMessage } from '../FieldErrorMessage'\nimport { FieldCaption } from '../FieldCaption'\nimport type { SharedFieldLayoutProps } from '../FieldLayout/FieldLayoutTypes'\nimport styles from './Fieldset.module.scss'\nimport { getDataProps } from '@/helpers/getDataProps'\n\n/** @internal */\nexport interface FieldsetProps extends Omit<\n  SharedFieldLayoutProps,\n  'label' | 'shouldVisuallyHideLabel'\n> {\n  children: React.ReactNode\n  description?: React.ReactNode\n  errorMessage?: string\n  isRequired?: boolean\n  legend: React.ReactNode\n  shouldVisuallyHideLegend?: boolean\n  className?: string\n}\n\n/** @internal */\nexport const Fieldset: React.FC<FieldsetProps> = ({\n  children,\n  description,\n  errorMessage,\n  isRequired = false,\n  legend,\n  shouldVisuallyHideLegend = false,\n  className,\n  ...props\n}: FieldsetProps) => {\n  const generatedErrorMessageId = useId()\n  const errorMessageId = `error-message-${generatedErrorMessageId}`\n\n  return (\n    <fieldset\n      className={classNames(styles.root, className)}\n      aria-describedby={errorMessage ? errorMessageId : undefined}\n      {...getDataProps(props)}\n    >\n      <div\n        className={classNames(styles.legendAndDescription, {\n          [styles.withVisibleLegend as string]: !shouldVisuallyHideLegend,\n          [styles.withDescription as string]: Boolean(description),\n        })}\n      >\n        <FieldCaption\n          as=\"legend\"\n          isRequired={isRequired}\n          isVisuallyHidden={shouldVisuallyHideLegend}\n        >\n          {legend}\n        </FieldCaption>\n        <FieldDescription>{description}</FieldDescription>\n      </div>\n      {children}\n      <FieldErrorMessage\n        id={errorMessageId}\n        className={styles.errorMessage}\n        aria-live=\"polite\"\n        role=\"alert\"\n      >\n        {errorMessage}\n      </FieldErrorMessage>\n    </fieldset>\n  )\n}\n"],"names":["Fieldset","children","description","errorMessage","isRequired","legend","shouldVisuallyHideLegend","className","props","errorMessageId","useId","jsxs","classNames","styles","getDataProps","jsx","FieldCaption","FieldDescription","FieldErrorMessage"],"mappings":";;;;;;;;AAwBO,MAAMA,IAAoC,CAAC;AAAA,EAChD,UAAAC;AAAA,EACA,aAAAC;AAAA,EACA,cAAAC;AAAA,EACA,YAAAC,IAAa;AAAA,EACb,QAAAC;AAAA,EACA,0BAAAC,IAA2B;AAAA,EAC3B,WAAAC;AAAA,EACA,GAAGC;AACL,MAAqB;AAEnB,QAAMC,IAAiB,iBADSC,EAAA,CAC+B;AAE/D,SACE,gBAAAC;AAAA,IAAC;AAAA,IAAA;AAAA,MACC,WAAWC,EAAWC,EAAO,MAAMN,CAAS;AAAA,MAC5C,oBAAkBJ,IAAeM,IAAiB;AAAA,MACjD,GAAGK,EAAaN,CAAK;AAAA,MAEtB,UAAA;AAAA,QAAA,gBAAAG;AAAA,UAAC;AAAA,UAAA;AAAA,YACC,WAAWC,EAAWC,EAAO,sBAAsB;AAAA,cACjD,CAACA,EAAO,iBAA2B,GAAG,CAACP;AAAA,cACvC,CAACO,EAAO,eAAyB,GAAG,EAAQX;AAAA,YAAW,CACxD;AAAA,YAED,UAAA;AAAA,cAAA,gBAAAa;AAAA,gBAACC;AAAA,gBAAA;AAAA,kBACC,IAAG;AAAA,kBACH,YAAAZ;AAAA,kBACA,kBAAkBE;AAAA,kBAEjB,UAAAD;AAAA,gBAAA;AAAA,cAAA;AAAA,cAEH,gBAAAU,EAACE,KAAkB,UAAAf,EAAA,CAAY;AAAA,YAAA;AAAA,UAAA;AAAA,QAAA;AAAA,QAEhCD;AAAA,QACD,gBAAAc;AAAA,UAACG;AAAA,UAAA;AAAA,YACC,IAAIT;AAAA,YACJ,WAAWI,EAAO;AAAA,YAClB,aAAU;AAAA,YACV,MAAK;AAAA,YAEJ,UAAAV;AAAA,UAAA;AAAA,QAAA;AAAA,MACH;AAAA,IAAA;AAAA,EAAA;AAGN;"}

package/dist/components/Common/Flex/Flex.d.ts

@@ -1,4 +1,5 @@
 import { Responsive, CustomPropertyValue } from '../../../helpers/responsive';
+/** @internal */
 export interface FlexProps {
     children: React.ReactNode;
     flexDirection?: Responsive<'row' | 'column'>;
@@ -7,9 +8,12 @@ export interface FlexProps {
     flexWrap?: Responsive<'wrap' | 'nowrap' | 'wrap-reverse'>;
     gap?: Responsive<CustomPropertyValue>;
 }
+/** @internal */
 export declare function Flex({ children, flexDirection, justifyContent, alignItems, flexWrap, gap, }: FlexProps): import("react").JSX.Element;
+/** @internal */
 export interface FlexItemProps {
     flexGrow?: number | 'initial';
     children: React.ReactNode;
 }
+/** @internal */
 export declare function FlexItem({ flexGrow, children }: FlexItemProps): import("react").JSX.Element;

package/dist/components/Common/Flex/Flex.js.map

@@ -1 +1 @@
-{"version":3,"file":"Flex.js","sources":["../../../../src/components/Common/Flex/Flex.tsx"],"sourcesContent":["import style from './Flex.module.scss'\nimport {\n  setResponsiveCustomProperties,\n  type Responsive,\n  type CustomPropertyValue,\n} from '@/helpers/responsive'\n\nexport interface FlexProps {\n  children: React.ReactNode\n  flexDirection?: Responsive<'row' | 'column'>\n  justifyContent?: Responsive<\n    | 'space-between'\n    | 'center'\n    | 'flex-start'\n    | 'flex-end'\n    | 'space-around'\n    | 'space-evenly'\n    | 'normal'\n  >\n  alignItems?: Responsive<'center' | 'flex-start' | 'flex-end' | 'stretch'>\n  flexWrap?: Responsive<'wrap' | 'nowrap' | 'wrap-reverse'>\n  gap?: Responsive<CustomPropertyValue>\n}\n\nexport function Flex({\n  children,\n  flexDirection = 'row',\n  justifyContent = 'normal',\n  alignItems = 'flex-start',\n  flexWrap,\n  gap = 24,\n}: FlexProps) {\n  const properties = setResponsiveCustomProperties({\n    'flex-direction': flexDirection,\n    'justify-content': justifyContent,\n    'align-items': alignItems,\n    'flex-wrap': flexWrap,\n    gap,\n  })\n\n  return (\n    <div className={style.flexContainer}>\n      <div className={style.flex} style={properties}>\n        {children}\n      </div>\n    </div>\n  )\n}\n\nexport interface FlexItemProps {\n  flexGrow?: number | 'initial'\n  children: React.ReactNode\n}\n\nexport function FlexItem({ flexGrow = 'initial', children }: FlexItemProps) {\n  return <div style={{ flexGrow: flexGrow }}>{children}</div>\n}\n"],"names":["Flex","children","flexDirection","justifyContent","alignItems","flexWrap","gap","properties","setResponsiveCustomProperties","jsx","style","FlexItem","flexGrow"],"mappings":";;;AAwBO,SAASA,EAAK;AAAA,EACnB,UAAAC;AAAA,EACA,eAAAC,IAAgB;AAAA,EAChB,gBAAAC,IAAiB;AAAA,EACjB,YAAAC,IAAa;AAAA,EACb,UAAAC;AAAA,EACA,KAAAC,IAAM;AACR,GAAc;AACZ,QAAMC,IAAaC,EAA8B;AAAA,IAC/C,kBAAkBN;AAAA,IAClB,mBAAmBC;AAAA,IACnB,eAAeC;AAAA,IACf,aAAaC;AAAA,IACb,KAAAC;AAAA,EAAA,CACD;AAED,SACE,gBAAAG,EAAC,OAAA,EAAI,WAAWC,EAAM,eACpB,UAAA,gBAAAD,EAAC,OAAA,EAAI,WAAWC,EAAM,MAAM,OAAOH,GAChC,UAAAN,GACH,GACF;AAEJ;AAOO,SAASU,EAAS,EAAE,UAAAC,IAAW,WAAW,UAAAX,KAA2B;AAC1E,2BAAQ,OAAA,EAAI,OAAO,EAAE,UAAAW,EAAA,GAAuB,UAAAX,GAAS;AACvD;"}
+{"version":3,"file":"Flex.js","sources":["../../../../src/components/Common/Flex/Flex.tsx"],"sourcesContent":["import style from './Flex.module.scss'\nimport {\n  setResponsiveCustomProperties,\n  type Responsive,\n  type CustomPropertyValue,\n} from '@/helpers/responsive'\n\n/** @internal */\nexport interface FlexProps {\n  children: React.ReactNode\n  flexDirection?: Responsive<'row' | 'column'>\n  justifyContent?: Responsive<\n    | 'space-between'\n    | 'center'\n    | 'flex-start'\n    | 'flex-end'\n    | 'space-around'\n    | 'space-evenly'\n    | 'normal'\n  >\n  alignItems?: Responsive<'center' | 'flex-start' | 'flex-end' | 'stretch'>\n  flexWrap?: Responsive<'wrap' | 'nowrap' | 'wrap-reverse'>\n  gap?: Responsive<CustomPropertyValue>\n}\n\n/** @internal */\nexport function Flex({\n  children,\n  flexDirection = 'row',\n  justifyContent = 'normal',\n  alignItems = 'flex-start',\n  flexWrap,\n  gap = 24,\n}: FlexProps) {\n  const properties = setResponsiveCustomProperties({\n    'flex-direction': flexDirection,\n    'justify-content': justifyContent,\n    'align-items': alignItems,\n    'flex-wrap': flexWrap,\n    gap,\n  })\n\n  return (\n    <div className={style.flexContainer}>\n      <div className={style.flex} style={properties}>\n        {children}\n      </div>\n    </div>\n  )\n}\n\n/** @internal */\nexport interface FlexItemProps {\n  flexGrow?: number | 'initial'\n  children: React.ReactNode\n}\n\n/** @internal */\nexport function FlexItem({ flexGrow = 'initial', children }: FlexItemProps) {\n  return <div style={{ flexGrow: flexGrow }}>{children}</div>\n}\n"],"names":["Flex","children","flexDirection","justifyContent","alignItems","flexWrap","gap","properties","setResponsiveCustomProperties","jsx","style","FlexItem","flexGrow"],"mappings":";;;AA0BO,SAASA,EAAK;AAAA,EACnB,UAAAC;AAAA,EACA,eAAAC,IAAgB;AAAA,EAChB,gBAAAC,IAAiB;AAAA,EACjB,YAAAC,IAAa;AAAA,EACb,UAAAC;AAAA,EACA,KAAAC,IAAM;AACR,GAAc;AACZ,QAAMC,IAAaC,EAA8B;AAAA,IAC/C,kBAAkBN;AAAA,IAClB,mBAAmBC;AAAA,IACnB,eAAeC;AAAA,IACf,aAAaC;AAAA,IACb,KAAAC;AAAA,EAAA,CACD;AAED,SACE,gBAAAG,EAAC,OAAA,EAAI,WAAWC,EAAM,eACpB,UAAA,gBAAAD,EAAC,OAAA,EAAI,WAAWC,EAAM,MAAM,OAAOH,GAChC,UAAAN,GACH,GACF;AAEJ;AASO,SAASU,EAAS,EAAE,UAAAC,IAAW,WAAW,UAAAX,KAA2B;AAC1E,2BAAQ,OAAA,EAAI,OAAO,EAAE,UAAAW,EAAA,GAAuB,UAAAX,GAAS;AACvD;"}

package/dist/components/Common/FlowBreadcrumbs/FlowBreadcrumbs.d.ts

@@ -1,2 +1,22 @@
 import { FlowBreadcrumbsProps } from './FlowBreadcrumbsTypes';
+/**
+ * Renders the breadcrumb trail for a multi-step flow.
+ *
+ * @remarks
+ * Translates each breadcrumb's label via i18next using the optional `namespace`
+ * and `variables`, formats `startDate`/`endDate` variables through the locale's
+ * short-with-year date formatter, and emits a `breadcrumb/navigate` event when
+ * a clickable breadcrumb is selected. A breadcrumb is clickable when
+ * `isNavigable` is true, or when `isNavigable` is omitted and `onNavigate` is
+ * defined. Switches to a condensed mobile layout when the container only
+ * contains the base breakpoint.
+ *
+ * | Event | Description | Data |
+ * | ----- | ----------- | ---- |
+ * | `breadcrumb/navigate` | Emitted when a clickable breadcrumb is selected | `{ key: string; onNavigate: (ctx: unknown) => unknown }` |
+ *
+ * @param props - See {@link FlowBreadcrumbsProps}.
+ * @returns The breadcrumb trail rendered through the component adapter.
+ * @internal
+ */
 export declare function FlowBreadcrumbs({ breadcrumbs, currentBreadcrumbId, onEvent, }: FlowBreadcrumbsProps): import("react").JSX.Element;

package/dist/components/Common/FlowBreadcrumbs/FlowBreadcrumbs.js.map

@@ -1 +1 @@
-{"version":3,"file":"FlowBreadcrumbs.js","sources":["../../../../src/components/Common/FlowBreadcrumbs/FlowBreadcrumbs.tsx"],"sourcesContent":["import type { CustomTypeOptions } from 'i18next'\nimport { useTranslation } from 'react-i18next'\nimport { useMemo, useRef } from 'react'\nimport type { FlowBreadcrumbsProps } from './FlowBreadcrumbsTypes'\nimport { useComponentContext } from '@/contexts/ComponentAdapter/useComponentContext'\nimport { componentEvents } from '@/shared/constants'\nimport { useI18n } from '@/i18n/I18n'\nimport { useLocale } from '@/contexts/LocaleProvider/useLocale'\nimport { useContainerBreakpoints } from '@/hooks/useContainerBreakpoints/useContainerBreakpoints'\nimport { useDateFormatter } from '@/hooks/useDateFormatter'\n\nexport function FlowBreadcrumbs({\n  breadcrumbs,\n  currentBreadcrumbId,\n  onEvent,\n}: FlowBreadcrumbsProps) {\n  const breadcrumbContainerRef = useRef<HTMLDivElement | null>(null)\n  const breakpoints = useContainerBreakpoints({ ref: breadcrumbContainerRef })\n  // Small if we only contain the base breakpoint\n  const isSmallContainer = breakpoints.length === 1\n\n  const { Breadcrumbs } = useComponentContext()\n  const { locale } = useLocale()\n  const dateFormatter = useDateFormatter()\n  const namespaces = breadcrumbs.reduce<Array<keyof CustomTypeOptions['resources']>>(\n    (acc, breadcrumb) => {\n      if (breadcrumb.namespace) {\n        acc.push(breadcrumb.namespace as keyof CustomTypeOptions['resources'])\n      }\n      return acc\n    },\n    [],\n  )\n  useI18n(namespaces)\n  const { t } = useTranslation()\n  const parsedBreadcrumbs = useMemo(\n    () =>\n      breadcrumbs.map(breadcrumb => {\n        const formattedVariables = breadcrumb.variables\n          ? {\n              ...breadcrumb.variables,\n              startDate:\n                typeof breadcrumb.variables.startDate === 'string'\n                  ? dateFormatter.formatShortWithYear(breadcrumb.variables.startDate)\n                  : breadcrumb.variables.startDate,\n              endDate:\n                typeof breadcrumb.variables.endDate === 'string'\n                  ? dateFormatter.formatShortWithYear(breadcrumb.variables.endDate)\n                  : breadcrumb.variables.endDate,\n            }\n          : undefined\n\n        const translatedLabel = breadcrumb.namespace\n          ? (t(breadcrumb.label, {\n              ns: breadcrumb.namespace,\n              defaultValue: breadcrumb.label,\n              ...formattedVariables,\n            } as never) as unknown as string)\n          : (t(breadcrumb.label, {\n              defaultValue: breadcrumb.label,\n              ...formattedVariables,\n            } as never) as unknown as string)\n        const isClickable =\n          breadcrumb.isNavigable !== undefined ? breadcrumb.isNavigable : !!breadcrumb.onNavigate\n\n        return {\n          id: breadcrumb.id,\n          label: translatedLabel,\n          isClickable,\n        }\n      }),\n    [breadcrumbs, t, locale],\n  )\n\n  const handleBreadcrumbClick = (breadcrumbId: string) => {\n    const breadcrumb = breadcrumbs.find(breadcrumb => breadcrumb.id === breadcrumbId)\n    if (onEvent && breadcrumb?.onNavigate) {\n      onEvent(componentEvents.BREADCRUMB_NAVIGATE, {\n        key: breadcrumbId,\n        onNavigate: breadcrumb.onNavigate,\n      })\n    }\n  }\n  return (\n    <div ref={breadcrumbContainerRef}>\n      <Breadcrumbs\n        isSmallContainer={isSmallContainer}\n        breadcrumbs={parsedBreadcrumbs}\n        currentBreadcrumbId={currentBreadcrumbId}\n        onClick={handleBreadcrumbClick}\n      />\n    </div>\n  )\n}\n"],"names":["FlowBreadcrumbs","breadcrumbs","currentBreadcrumbId","onEvent","breadcrumbContainerRef","useRef","isSmallContainer","useContainerBreakpoints","Breadcrumbs","useComponentContext","locale","useLocale","dateFormatter","useDateFormatter","namespaces","acc","breadcrumb","useI18n","t","useTranslation","parsedBreadcrumbs","useMemo","formattedVariables","translatedLabel","isClickable","jsx","breadcrumbId","componentEvents"],"mappings":";;;;;;;;;AAWO,SAASA,EAAgB;AAAA,EAC9B,aAAAC;AAAA,EACA,qBAAAC;AAAA,EACA,SAAAC;AACF,GAAyB;AACvB,QAAMC,IAAyBC,EAA8B,IAAI,GAG3DC,IAFcC,EAAwB,EAAE,KAAKH,GAAwB,EAEtC,WAAW,GAE1C,EAAE,aAAAI,EAAA,IAAgBC,EAAA,GAClB,EAAE,QAAAC,EAAA,IAAWC,EAAA,GACbC,IAAgBC,EAAA,GAChBC,IAAab,EAAY;AAAA,IAC7B,CAACc,GAAKC,OACAA,EAAW,aACbD,EAAI,KAAKC,EAAW,SAAiD,GAEhED;AAAA,IAET,CAAA;AAAA,EAAC;AAEH,EAAAE,EAAQH,CAAU;AAClB,QAAM,EAAE,GAAAI,EAAA,IAAMC,EAAA,GACRC,IAAoBC;AAAA,IACxB,MACEpB,EAAY,IAAI,CAAAe,MAAc;AAC5B,YAAMM,IAAqBN,EAAW,YAClC;AAAA,QACE,GAAGA,EAAW;AAAA,QACd,WACE,OAAOA,EAAW,UAAU,aAAc,WACtCJ,EAAc,oBAAoBI,EAAW,UAAU,SAAS,IAChEA,EAAW,UAAU;AAAA,QAC3B,SACE,OAAOA,EAAW,UAAU,WAAY,WACpCJ,EAAc,oBAAoBI,EAAW,UAAU,OAAO,IAC9DA,EAAW,UAAU;AAAA,MAAA,IAE7B,QAEEO,IAAkBP,EAAW,YAC9BE,EAAEF,EAAW,OAAO;AAAA,QACnB,IAAIA,EAAW;AAAA,QACf,cAAcA,EAAW;AAAA,QACzB,GAAGM;AAAA,MAAA,CACK,IACTJ,EAAEF,EAAW,OAAO;AAAA,QACnB,cAAcA,EAAW;AAAA,QACzB,GAAGM;AAAA,MAAA,CACK,GACRE,IACJR,EAAW,gBAAgB,SAAYA,EAAW,cAAc,CAAC,CAACA,EAAW;AAE/E,aAAO;AAAA,QACL,IAAIA,EAAW;AAAA,QACf,OAAOO;AAAA,QACP,aAAAC;AAAA,MAAA;AAAA,IAEJ,CAAC;AAAA,IACH,CAACvB,GAAaiB,GAAGR,CAAM;AAAA,EAAA;AAYzB,SACE,gBAAAe,EAAC,OAAA,EAAI,KAAKrB,GACR,UAAA,gBAAAqB;AAAA,IAACjB;AAAA,IAAA;AAAA,MACC,kBAAAF;AAAA,MACA,aAAac;AAAA,MACb,qBAAAlB;AAAA,MACA,SAfwB,CAACwB,MAAyB;AACtD,cAAMV,IAAaf,EAAY,KAAK,CAAAe,MAAcA,EAAW,OAAOU,CAAY;AAChF,QAAIvB,KAAWa,GAAY,cACzBb,EAAQwB,EAAgB,qBAAqB;AAAA,UAC3C,KAAKD;AAAA,UACL,YAAYV,EAAW;AAAA,QAAA,CACxB;AAAA,MAEL;AAAA,IAOe;AAAA,EAAA,GAEb;AAEJ;"}
+{"version":3,"file":"FlowBreadcrumbs.js","sources":["../../../../src/components/Common/FlowBreadcrumbs/FlowBreadcrumbs.tsx"],"sourcesContent":["import type { CustomTypeOptions } from 'i18next'\nimport { useTranslation } from 'react-i18next'\nimport { useMemo, useRef } from 'react'\nimport type { FlowBreadcrumbsProps } from './FlowBreadcrumbsTypes'\nimport { useComponentContext } from '@/contexts/ComponentAdapter/useComponentContext'\nimport { componentEvents } from '@/shared/constants'\nimport { useI18n } from '@/i18n/I18n'\nimport { useLocale } from '@/contexts/LocaleProvider/useLocale'\nimport { useContainerBreakpoints } from '@/hooks/useContainerBreakpoints/useContainerBreakpoints'\nimport { useDateFormatter } from '@/hooks/useDateFormatter'\n\n/**\n * Renders the breadcrumb trail for a multi-step flow.\n *\n * @remarks\n * Translates each breadcrumb's label via i18next using the optional `namespace`\n * and `variables`, formats `startDate`/`endDate` variables through the locale's\n * short-with-year date formatter, and emits a `breadcrumb/navigate` event when\n * a clickable breadcrumb is selected. A breadcrumb is clickable when\n * `isNavigable` is true, or when `isNavigable` is omitted and `onNavigate` is\n * defined. Switches to a condensed mobile layout when the container only\n * contains the base breakpoint.\n *\n * | Event | Description | Data |\n * | ----- | ----------- | ---- |\n * | `breadcrumb/navigate` | Emitted when a clickable breadcrumb is selected | `{ key: string; onNavigate: (ctx: unknown) => unknown }` |\n *\n * @param props - See {@link FlowBreadcrumbsProps}.\n * @returns The breadcrumb trail rendered through the component adapter.\n * @internal\n */\nexport function FlowBreadcrumbs({\n  breadcrumbs,\n  currentBreadcrumbId,\n  onEvent,\n}: FlowBreadcrumbsProps) {\n  const breadcrumbContainerRef = useRef<HTMLDivElement | null>(null)\n  const breakpoints = useContainerBreakpoints({ ref: breadcrumbContainerRef })\n  // Small if we only contain the base breakpoint\n  const isSmallContainer = breakpoints.length === 1\n\n  const { Breadcrumbs } = useComponentContext()\n  const { locale } = useLocale()\n  const dateFormatter = useDateFormatter()\n  const namespaces = breadcrumbs.reduce<Array<keyof CustomTypeOptions['resources']>>(\n    (acc, breadcrumb) => {\n      if (breadcrumb.namespace) {\n        acc.push(breadcrumb.namespace as keyof CustomTypeOptions['resources'])\n      }\n      return acc\n    },\n    [],\n  )\n  useI18n(namespaces)\n  const { t } = useTranslation()\n  const parsedBreadcrumbs = useMemo(\n    () =>\n      breadcrumbs.map(breadcrumb => {\n        const formattedVariables = breadcrumb.variables\n          ? {\n              ...breadcrumb.variables,\n              startDate:\n                typeof breadcrumb.variables.startDate === 'string'\n                  ? dateFormatter.formatShortWithYear(breadcrumb.variables.startDate)\n                  : breadcrumb.variables.startDate,\n              endDate:\n                typeof breadcrumb.variables.endDate === 'string'\n                  ? dateFormatter.formatShortWithYear(breadcrumb.variables.endDate)\n                  : breadcrumb.variables.endDate,\n            }\n          : undefined\n\n        const translatedLabel = breadcrumb.namespace\n          ? (t(breadcrumb.label, {\n              ns: breadcrumb.namespace,\n              defaultValue: breadcrumb.label,\n              ...formattedVariables,\n            } as never) as unknown as string)\n          : (t(breadcrumb.label, {\n              defaultValue: breadcrumb.label,\n              ...formattedVariables,\n            } as never) as unknown as string)\n        const isClickable =\n          breadcrumb.isNavigable !== undefined ? breadcrumb.isNavigable : !!breadcrumb.onNavigate\n\n        return {\n          id: breadcrumb.id,\n          label: translatedLabel,\n          isClickable,\n        }\n      }),\n    [breadcrumbs, t, locale],\n  )\n\n  const handleBreadcrumbClick = (breadcrumbId: string) => {\n    const breadcrumb = breadcrumbs.find(breadcrumb => breadcrumb.id === breadcrumbId)\n    if (onEvent && breadcrumb?.onNavigate) {\n      onEvent(componentEvents.BREADCRUMB_NAVIGATE, {\n        key: breadcrumbId,\n        onNavigate: breadcrumb.onNavigate,\n      })\n    }\n  }\n  return (\n    <div ref={breadcrumbContainerRef}>\n      <Breadcrumbs\n        isSmallContainer={isSmallContainer}\n        breadcrumbs={parsedBreadcrumbs}\n        currentBreadcrumbId={currentBreadcrumbId}\n        onClick={handleBreadcrumbClick}\n      />\n    </div>\n  )\n}\n"],"names":["FlowBreadcrumbs","breadcrumbs","currentBreadcrumbId","onEvent","breadcrumbContainerRef","useRef","isSmallContainer","useContainerBreakpoints","Breadcrumbs","useComponentContext","locale","useLocale","dateFormatter","useDateFormatter","namespaces","acc","breadcrumb","useI18n","t","useTranslation","parsedBreadcrumbs","useMemo","formattedVariables","translatedLabel","isClickable","jsx","breadcrumbId","componentEvents"],"mappings":";;;;;;;;;AA+BO,SAASA,EAAgB;AAAA,EAC9B,aAAAC;AAAA,EACA,qBAAAC;AAAA,EACA,SAAAC;AACF,GAAyB;AACvB,QAAMC,IAAyBC,EAA8B,IAAI,GAG3DC,IAFcC,EAAwB,EAAE,KAAKH,GAAwB,EAEtC,WAAW,GAE1C,EAAE,aAAAI,EAAA,IAAgBC,EAAA,GAClB,EAAE,QAAAC,EAAA,IAAWC,EAAA,GACbC,IAAgBC,EAAA,GAChBC,IAAab,EAAY;AAAA,IAC7B,CAACc,GAAKC,OACAA,EAAW,aACbD,EAAI,KAAKC,EAAW,SAAiD,GAEhED;AAAA,IAET,CAAA;AAAA,EAAC;AAEH,EAAAE,EAAQH,CAAU;AAClB,QAAM,EAAE,GAAAI,EAAA,IAAMC,EAAA,GACRC,IAAoBC;AAAA,IACxB,MACEpB,EAAY,IAAI,CAAAe,MAAc;AAC5B,YAAMM,IAAqBN,EAAW,YAClC;AAAA,QACE,GAAGA,EAAW;AAAA,QACd,WACE,OAAOA,EAAW,UAAU,aAAc,WACtCJ,EAAc,oBAAoBI,EAAW,UAAU,SAAS,IAChEA,EAAW,UAAU;AAAA,QAC3B,SACE,OAAOA,EAAW,UAAU,WAAY,WACpCJ,EAAc,oBAAoBI,EAAW,UAAU,OAAO,IAC9DA,EAAW,UAAU;AAAA,MAAA,IAE7B,QAEEO,IAAkBP,EAAW,YAC9BE,EAAEF,EAAW,OAAO;AAAA,QACnB,IAAIA,EAAW;AAAA,QACf,cAAcA,EAAW;AAAA,QACzB,GAAGM;AAAA,MAAA,CACK,IACTJ,EAAEF,EAAW,OAAO;AAAA,QACnB,cAAcA,EAAW;AAAA,QACzB,GAAGM;AAAA,MAAA,CACK,GACRE,IACJR,EAAW,gBAAgB,SAAYA,EAAW,cAAc,CAAC,CAACA,EAAW;AAE/E,aAAO;AAAA,QACL,IAAIA,EAAW;AAAA,QACf,OAAOO;AAAA,QACP,aAAAC;AAAA,MAAA;AAAA,IAEJ,CAAC;AAAA,IACH,CAACvB,GAAaiB,GAAGR,CAAM;AAAA,EAAA;AAYzB,SACE,gBAAAe,EAAC,OAAA,EAAI,KAAKrB,GACR,UAAA,gBAAAqB;AAAA,IAACjB;AAAA,IAAA;AAAA,MACC,kBAAAF;AAAA,MACA,aAAac;AAAA,MACb,qBAAAlB;AAAA,MACA,SAfwB,CAACwB,MAAyB;AACtD,cAAMV,IAAaf,EAAY,KAAK,CAAAe,MAAcA,EAAW,OAAOU,CAAY;AAChF,QAAIvB,KAAWa,GAAY,cACzBb,EAAQwB,EAAgB,qBAAqB;AAAA,UAC3C,KAAKD;AAAA,UACL,YAAYV,EAAW;AAAA,QAAA,CACxB;AAAA,MAEL;AAAA,IAOe;AAAA,EAAA,GAEb;AAEJ;"}

package/dist/components/Common/FlowBreadcrumbs/FlowBreadcrumbsTypes.d.ts

@@ -1,32 +1,53 @@
 import { OnEventType } from '../../Base/useBase';
 import { EventType } from '../../../types/Helpers';
+/**
+ * A single step in a flow's breadcrumb trail.
+ *
+ * @remarks
+ * Labels are resolved through i18next. When `namespace` is set, the label is
+ * looked up in that namespace; otherwise the global namespace is used. The
+ * label string itself is also used as the i18n key, with the raw value as a
+ * fallback when no translation is registered. Date-typed `variables` (the
+ * `startDate` and `endDate` keys) are auto-formatted with the active locale's
+ * short-with-year date format before interpolation.
+ *
+ * @public
+ */
 export interface FlowBreadcrumb {
     /**
-     * Unique key for the breadcrumb step
+     * Unique identifier for the breadcrumb step. Matched against the current
+     * breadcrumb to mark the active entry and passed to `onNavigate` when the
+     * breadcrumb is selected.
      */
     id: string;
     /**
-     * Translation key for the breadcrumb label
+     * i18next translation key for the breadcrumb label. Falls back to the raw
+     * string when no translation is registered.
      */
     label: string;
     /**
-     * Optional translation namespace
+     * Optional i18next namespace to resolve `label` against. Defaults to the
+     * global namespace when omitted.
      */
     namespace?: string;
     /**
-     * Optional variables for the breadcrumb label
+     * Optional interpolation variables for the translated label. `startDate` and
+     * `endDate` values typed as strings are auto-formatted with the active
+     * locale's short-with-year date format before interpolation.
      */
     variables?: Record<string, unknown>;
     /**
-     * Event handler for breadcrumb navigation
+     * Callback invoked when the breadcrumb is selected. Receives the current
+     * flow context and returns the next context.
      */
     onNavigate?: (context: unknown) => unknown;
     /**
-     * When false, the breadcrumb is rendered as non-clickable even if onNavigate is defined.
-     * Defaults to true when onNavigate is present, false otherwise.
+     * Overrides the default clickability of the breadcrumb. When omitted, the
+     * breadcrumb is clickable iff `onNavigate` is defined.
      */
     isNavigable?: boolean;
 }
+/** @internal */
 export interface BreadcrumbNode {
     /**
      * Parent node key (null for root nodes)
@@ -37,10 +58,15 @@ export interface BreadcrumbNode {
      */
     item: FlowBreadcrumb;
 }
+/** @internal */
 export type BreadcrumbNodes = Record<string, BreadcrumbNode>;
+/** @internal */
 export type BreadcrumbTrail = Record<string, FlowBreadcrumb[]>;
+/** @internal */
 export interface FlowBreadcrumbsProps {
+    /** Breadcrumb steps to render, in order. */
     breadcrumbs: FlowBreadcrumb[];
+    /** Identifier of the active breadcrumb step. */
     currentBreadcrumbId?: string;
     /**
      * Event handler for breadcrumb navigation

package/dist/components/Common/FlowBreadcrumbs/breadcrumbTransitionHelpers.d.ts

@@ -1 +1,17 @@
+/**
+ * Builds a factory that produces robot3 transitions handling a
+ * `breadcrumb/navigate` event for a given target state.
+ *
+ * @remarks
+ * The returned factory takes a target state name and an optional `canNavigate`
+ * guard. The resulting transition only fires when the event payload's `key`
+ * matches the target state and the guard (if provided) returns true, then
+ * reduces the machine context by invoking the breadcrumb's `onNavigate`. The
+ * outer generic is used purely to anchor `TContext` for the inner closures.
+ *
+ * @typeParam TContext - The state machine context shape.
+ * @returns A factory `(targetState, canNavigate?) => transition` that emits a
+ * guarded robot3 transition for the `breadcrumb/navigate` event.
+ * @internal
+ */
 export declare const createBreadcrumbNavigateTransition: <TContext>() => (targetState: string, canNavigate?: (ctx: TContext) => boolean) => import('robot3').Transition<"breadcrumb/navigate">;

package/dist/components/Common/FlowBreadcrumbs/breadcrumbTransitionHelpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"breadcrumbTransitionHelpers.js","sources":["../../../../src/components/Common/FlowBreadcrumbs/breadcrumbTransitionHelpers.ts"],"sourcesContent":["import { guard, reduce, transition } from 'robot3'\nimport { componentEvents } from '@/shared/constants'\n\ntype BreadcrumbNavigateEvent<TContext> = {\n  payload: {\n    key: string\n    onNavigate: (ctx: TContext) => TContext\n  }\n}\n\n// eslint-disable-next-line @typescript-eslint/no-unnecessary-type-parameters\nexport const createBreadcrumbNavigateTransition = <TContext>() => {\n  return (targetState: string, canNavigate?: (ctx: TContext) => boolean) =>\n    transition(\n      componentEvents.BREADCRUMB_NAVIGATE,\n      targetState,\n      guard(\n        (ctx: TContext, ev: { payload: { key: string } }) =>\n          ev.payload.key === targetState && (canNavigate?.(ctx) ?? true),\n      ),\n      reduce(\n        (ctx: TContext, ev: BreadcrumbNavigateEvent<TContext>): TContext =>\n          ev.payload.onNavigate(ctx),\n      ),\n    )\n}\n"],"names":["createBreadcrumbNavigateTransition","targetState","canNavigate","transition","componentEvents","guard","ctx","ev","reduce"],"mappings":";;AAWO,MAAMA,IAAqC,MACzC,CAACC,GAAqBC,MAC3BC;AAAA,EACEC,EAAgB;AAAA,EAChBH;AAAA,EACAI;AAAA,IACE,CAACC,GAAeC,MACdA,EAAG,QAAQ,QAAQN,MAAgBC,IAAcI,CAAG,KAAK;AAAA,EAAA;AAAA,EAE7DE;AAAA,IACE,CAACF,GAAeC,MACdA,EAAG,QAAQ,WAAWD,CAAG;AAAA,EAAA;AAC7B;"}
+{"version":3,"file":"breadcrumbTransitionHelpers.js","sources":["../../../../src/components/Common/FlowBreadcrumbs/breadcrumbTransitionHelpers.ts"],"sourcesContent":["import { guard, reduce, transition } from 'robot3'\nimport { componentEvents } from '@/shared/constants'\n\ntype BreadcrumbNavigateEvent<TContext> = {\n  payload: {\n    key: string\n    onNavigate: (ctx: TContext) => TContext\n  }\n}\n\n/* eslint-disable @typescript-eslint/no-unnecessary-type-parameters */\n/**\n * Builds a factory that produces robot3 transitions handling a\n * `breadcrumb/navigate` event for a given target state.\n *\n * @remarks\n * The returned factory takes a target state name and an optional `canNavigate`\n * guard. The resulting transition only fires when the event payload's `key`\n * matches the target state and the guard (if provided) returns true, then\n * reduces the machine context by invoking the breadcrumb's `onNavigate`. The\n * outer generic is used purely to anchor `TContext` for the inner closures.\n *\n * @typeParam TContext - The state machine context shape.\n * @returns A factory `(targetState, canNavigate?) => transition` that emits a\n * guarded robot3 transition for the `breadcrumb/navigate` event.\n * @internal\n */\nexport const createBreadcrumbNavigateTransition = <TContext>() => {\n  /* eslint-enable @typescript-eslint/no-unnecessary-type-parameters */\n  return (targetState: string, canNavigate?: (ctx: TContext) => boolean) =>\n    transition(\n      componentEvents.BREADCRUMB_NAVIGATE,\n      targetState,\n      guard(\n        (ctx: TContext, ev: { payload: { key: string } }) =>\n          ev.payload.key === targetState && (canNavigate?.(ctx) ?? true),\n      ),\n      reduce(\n        (ctx: TContext, ev: BreadcrumbNavigateEvent<TContext>): TContext =>\n          ev.payload.onNavigate(ctx),\n      ),\n    )\n}\n"],"names":["createBreadcrumbNavigateTransition","targetState","canNavigate","transition","componentEvents","guard","ctx","ev","reduce"],"mappings":";;AA2BO,MAAMA,IAAqC,MAEzC,CAACC,GAAqBC,MAC3BC;AAAA,EACEC,EAAgB;AAAA,EAChBH;AAAA,EACAI;AAAA,IACE,CAACC,GAAeC,MACdA,EAAG,QAAQ,QAAQN,MAAgBC,IAAcI,CAAG,KAAK;AAAA,EAAA;AAAA,EAE7DE;AAAA,IACE,CAACF,GAAeC,MACdA,EAAG,QAAQ,WAAWD,CAAG;AAAA,EAAA;AAC7B;"}

package/dist/components/Common/Form/Form.d.ts

@@ -1,2 +1,4 @@
+/** @internal */
 export type FormProps = React.FormHTMLAttributes<HTMLFormElement>;
+/** @internal */
 export declare const Form: ({ children, className, onSubmit, ...props }: FormProps) => import("react").JSX.Element;

package/dist/components/Common/Form/Form.js.map

@@ -1 +1 @@
-{"version":3,"file":"Form.js","sources":["../../../../src/components/Common/Form/Form.tsx"],"sourcesContent":["import classNames from 'classnames'\nimport styles from './Form.module.scss'\n\nexport type FormProps = React.FormHTMLAttributes<HTMLFormElement>\n\nexport const Form = ({ children, className, onSubmit, ...props }: FormProps) => {\n  return (\n    <form\n      className={classNames(styles.form, className)}\n      onSubmit={e => {\n        e.preventDefault()\n        onSubmit?.(e)\n      }}\n      {...props}\n    >\n      {children}\n    </form>\n  )\n}\n"],"names":["Form","children","className","onSubmit","props","jsx","classNames","styles","e"],"mappings":";;;AAKO,MAAMA,IAAO,CAAC,EAAE,UAAAC,GAAU,WAAAC,GAAW,UAAAC,GAAU,GAAGC,QAErD,gBAAAC;AAAA,EAAC;AAAA,EAAA;AAAA,IACC,WAAWC,EAAWC,EAAO,MAAML,CAAS;AAAA,IAC5C,UAAU,CAAAM,MAAK;AACb,MAAAA,EAAE,eAAA,GACFL,IAAWK,CAAC;AAAA,IACd;AAAA,IACC,GAAGJ;AAAA,IAEH,UAAAH;AAAA,EAAA;AAAA;"}
+{"version":3,"file":"Form.js","sources":["../../../../src/components/Common/Form/Form.tsx"],"sourcesContent":["import classNames from 'classnames'\nimport styles from './Form.module.scss'\n\n/** @internal */\nexport type FormProps = React.FormHTMLAttributes<HTMLFormElement>\n\n/** @internal */\nexport const Form = ({ children, className, onSubmit, ...props }: FormProps) => {\n  return (\n    <form\n      className={classNames(styles.form, className)}\n      onSubmit={e => {\n        e.preventDefault()\n        onSubmit?.(e)\n      }}\n      {...props}\n    >\n      {children}\n    </form>\n  )\n}\n"],"names":["Form","children","className","onSubmit","props","jsx","classNames","styles","e"],"mappings":";;;AAOO,MAAMA,IAAO,CAAC,EAAE,UAAAC,GAAU,WAAAC,GAAW,UAAAC,GAAU,GAAGC,QAErD,gBAAAC;AAAA,EAAC;AAAA,EAAA;AAAA,IACC,WAAWC,EAAWC,EAAO,MAAML,CAAS;AAAA,IAC5C,UAAU,CAAAM,MAAK;AACb,MAAAA,EAAE,eAAA,GACFL,IAAWK,CAAC;AAAA,IACd;AAAA,IACC,GAAGJ;AAAA,IAEH,UAAAH;AAAA,EAAA;AAAA;"}

package/dist/components/Common/Grid/Grid.d.ts

@@ -2,6 +2,7 @@ import { ReactNode } from 'react';
 import { CustomPropertyValue, Responsive } from '../../../helpers/responsive';
 type Flow = 'row' | 'column' | 'row dense' | 'column dense';
 type Alignment = 'start' | 'end' | 'center' | 'stretch';
+/** @internal */
 export interface GridProps {
     children: ReactNode;
     gap?: Responsive<CustomPropertyValue>;
@@ -14,5 +15,6 @@ export interface GridProps {
     justifyContent?: Responsive<'start' | 'end' | 'center' | 'stretch' | 'space-between' | 'space-around' | 'space-evenly'>;
     className?: string;
 }
+/** @internal */
 export declare function Grid({ children, gap, gridTemplateColumns, gridTemplateRows, gridTemplateAreas, gridAutoFlow, alignItems, justifyItems, justifyContent, className, }: GridProps): import("react").JSX.Element;
 export {};

package/dist/components/Common/Grid/Grid.js.map

@@ -1 +1 @@
-{"version":3,"file":"Grid.js","sources":["../../../../src/components/Common/Grid/Grid.tsx"],"sourcesContent":["import type { ReactNode } from 'react'\nimport cn from 'classnames'\nimport styles from './Grid.module.scss'\nimport {\n  setResponsiveCustomProperties,\n  type CustomPropertyValue,\n  type Responsive,\n} from '@/helpers/responsive'\n\ntype Flow = 'row' | 'column' | 'row dense' | 'column dense'\ntype Alignment = 'start' | 'end' | 'center' | 'stretch'\n\nexport interface GridProps {\n  children: ReactNode\n  gap?: Responsive<CustomPropertyValue>\n  gridTemplateColumns?: Responsive<CustomPropertyValue | CustomPropertyValue[]>\n  gridTemplateRows?: Responsive<CustomPropertyValue | CustomPropertyValue[]>\n  gridTemplateAreas?: Responsive<string>\n  gridAutoFlow?: Responsive<Flow>\n  alignItems?: Responsive<Alignment>\n  justifyItems?: Responsive<Alignment>\n  justifyContent?: Responsive<\n    'start' | 'end' | 'center' | 'stretch' | 'space-between' | 'space-around' | 'space-evenly'\n  >\n  className?: string\n}\n\nexport function Grid({\n  children,\n  gap = 24,\n  gridTemplateColumns = ['1fr'],\n  gridTemplateRows,\n  gridTemplateAreas,\n  gridAutoFlow,\n  alignItems,\n  justifyItems,\n  justifyContent,\n  className,\n}: GridProps) {\n  const properties = setResponsiveCustomProperties({\n    gap,\n    'grid-template-columns': gridTemplateColumns,\n    'grid-template-rows': gridTemplateRows,\n    'grid-template-areas': gridTemplateAreas,\n    'grid-auto-flow': gridAutoFlow,\n    'align-items': alignItems,\n    'justify-items': justifyItems,\n    'justify-content': justifyContent,\n  })\n\n  return (\n    <div className={cn(styles.gridContainer, className)}>\n      <div className={styles.grid} style={properties}>\n        {children}\n      </div>\n    </div>\n  )\n}\n"],"names":["Grid","children","gap","gridTemplateColumns","gridTemplateRows","gridTemplateAreas","gridAutoFlow","alignItems","justifyItems","justifyContent","className","properties","setResponsiveCustomProperties","cn","styles","jsx"],"mappings":";;;;AA2BO,SAASA,EAAK;AAAA,EACnB,UAAAC;AAAA,EACA,KAAAC,IAAM;AAAA,EACN,qBAAAC,IAAsB,CAAC,KAAK;AAAA,EAC5B,kBAAAC;AAAA,EACA,mBAAAC;AAAA,EACA,cAAAC;AAAA,EACA,YAAAC;AAAA,EACA,cAAAC;AAAA,EACA,gBAAAC;AAAA,EACA,WAAAC;AACF,GAAc;AACZ,QAAMC,IAAaC,EAA8B;AAAA,IAC/C,KAAAV;AAAA,IACA,yBAAyBC;AAAA,IACzB,sBAAsBC;AAAA,IACtB,uBAAuBC;AAAA,IACvB,kBAAkBC;AAAA,IAClB,eAAeC;AAAA,IACf,iBAAiBC;AAAA,IACjB,mBAAmBC;AAAA,EAAA,CACpB;AAED,2BACG,OAAA,EAAI,WAAWI,EAAGC,EAAO,eAAeJ,CAAS,GAChD,UAAA,gBAAAK,EAAC,OAAA,EAAI,WAAWD,EAAO,MAAM,OAAOH,GACjC,UAAAV,GACH,GACF;AAEJ;"}
+{"version":3,"file":"Grid.js","sources":["../../../../src/components/Common/Grid/Grid.tsx"],"sourcesContent":["import type { ReactNode } from 'react'\nimport cn from 'classnames'\nimport styles from './Grid.module.scss'\nimport {\n  setResponsiveCustomProperties,\n  type CustomPropertyValue,\n  type Responsive,\n} from '@/helpers/responsive'\n\ntype Flow = 'row' | 'column' | 'row dense' | 'column dense'\ntype Alignment = 'start' | 'end' | 'center' | 'stretch'\n\n/** @internal */\nexport interface GridProps {\n  children: ReactNode\n  gap?: Responsive<CustomPropertyValue>\n  gridTemplateColumns?: Responsive<CustomPropertyValue | CustomPropertyValue[]>\n  gridTemplateRows?: Responsive<CustomPropertyValue | CustomPropertyValue[]>\n  gridTemplateAreas?: Responsive<string>\n  gridAutoFlow?: Responsive<Flow>\n  alignItems?: Responsive<Alignment>\n  justifyItems?: Responsive<Alignment>\n  justifyContent?: Responsive<\n    'start' | 'end' | 'center' | 'stretch' | 'space-between' | 'space-around' | 'space-evenly'\n  >\n  className?: string\n}\n\n/** @internal */\nexport function Grid({\n  children,\n  gap = 24,\n  gridTemplateColumns = ['1fr'],\n  gridTemplateRows,\n  gridTemplateAreas,\n  gridAutoFlow,\n  alignItems,\n  justifyItems,\n  justifyContent,\n  className,\n}: GridProps) {\n  const properties = setResponsiveCustomProperties({\n    gap,\n    'grid-template-columns': gridTemplateColumns,\n    'grid-template-rows': gridTemplateRows,\n    'grid-template-areas': gridTemplateAreas,\n    'grid-auto-flow': gridAutoFlow,\n    'align-items': alignItems,\n    'justify-items': justifyItems,\n    'justify-content': justifyContent,\n  })\n\n  return (\n    <div className={cn(styles.gridContainer, className)}>\n      <div className={styles.grid} style={properties}>\n        {children}\n      </div>\n    </div>\n  )\n}\n"],"names":["Grid","children","gap","gridTemplateColumns","gridTemplateRows","gridTemplateAreas","gridAutoFlow","alignItems","justifyItems","justifyContent","className","properties","setResponsiveCustomProperties","cn","styles","jsx"],"mappings":";;;;AA6BO,SAASA,EAAK;AAAA,EACnB,UAAAC;AAAA,EACA,KAAAC,IAAM;AAAA,EACN,qBAAAC,IAAsB,CAAC,KAAK;AAAA,EAC5B,kBAAAC;AAAA,EACA,mBAAAC;AAAA,EACA,cAAAC;AAAA,EACA,YAAAC;AAAA,EACA,cAAAC;AAAA,EACA,gBAAAC;AAAA,EACA,WAAAC;AACF,GAAc;AACZ,QAAMC,IAAaC,EAA8B;AAAA,IAC/C,KAAAV;AAAA,IACA,yBAAyBC;AAAA,IACzB,sBAAsBC;AAAA,IACtB,uBAAuBC;AAAA,IACvB,kBAAkBC;AAAA,IAClB,eAAeC;AAAA,IACf,iBAAiBC;AAAA,IACjB,mBAAmBC;AAAA,EAAA,CACpB;AAED,2BACG,OAAA,EAAI,WAAWI,EAAGC,EAAO,eAAeJ,CAAS,GAChD,UAAA,gBAAAK,EAAC,OAAA,EAAI,WAAWD,EAAO,MAAM,OAAOH,GACjC,UAAAV,GACH,GACF;AAEJ;"}

package/dist/components/Common/HamburgerMenu/HamburgerMenu.d.ts

@@ -1,2 +1,9 @@
 import { HamburgerMenuProps } from './HamburgerMenuTypes';
+/**
+ * Hamburger icon button that opens a menu of actions when activated.
+ *
+ * @param props - See {@link HamburgerMenuProps}.
+ * @returns A button-and-menu pair rendered through the components context.
+ * @internal
+ */
 export declare function HamburgerMenu({ items, triggerLabel, menuLabel, onClose, isLoading, placement, ...props }: HamburgerMenuProps): import("react").JSX.Element;

package/dist/components/Common/HamburgerMenu/HamburgerMenu.js.map

@@ -1 +1 @@
-{"version":3,"file":"HamburgerMenu.js","sources":["../../../../src/components/Common/HamburgerMenu/HamburgerMenu.tsx"],"sourcesContent":["import { useTranslation } from 'react-i18next'\nimport { type HamburgerMenuProps } from './HamburgerMenuTypes'\nimport { useComponentContext } from '@/contexts/ComponentAdapter/useComponentContext'\nimport HamburgerIcon from '@/assets/icons/hamburger.svg?react'\nimport { useMenu } from '@/hooks/useMenu'\n\nexport function HamburgerMenu({\n  items,\n  triggerLabel,\n  menuLabel,\n  onClose,\n  isLoading = false,\n  placement = 'bottom end',\n  ...props\n}: HamburgerMenuProps) {\n  const { t } = useTranslation('common')\n  const Components = useComponentContext()\n  const { triggerProps, menuProps } = useMenu()\n\n  const { ref, ...restTriggerProps } = triggerProps\n\n  return (\n    <>\n      <Components.ButtonIcon\n        isLoading={isLoading}\n        aria-label={triggerLabel || t('labels.openMenu')}\n        buttonRef={ref}\n        {...restTriggerProps}\n      >\n        <HamburgerIcon />\n      </Components.ButtonIcon>\n      <Components.Menu\n        {...menuProps}\n        items={items}\n        aria-label={menuLabel || t('labels.menuLabel')}\n        onClose={onClose || menuProps.onClose}\n        placement={placement}\n        {...props}\n      />\n    </>\n  )\n}\n"],"names":["HamburgerMenu","items","triggerLabel","menuLabel","onClose","isLoading","placement","props","t","useTranslation","Components","useComponentContext","triggerProps","menuProps","useMenu","ref","restTriggerProps","jsxs","Fragment","jsx","HamburgerIcon"],"mappings":";;;;;AAMO,SAASA,EAAc;AAAA,EAC5B,OAAAC;AAAA,EACA,cAAAC;AAAA,EACA,WAAAC;AAAA,EACA,SAAAC;AAAA,EACA,WAAAC,IAAY;AAAA,EACZ,WAAAC,IAAY;AAAA,EACZ,GAAGC;AACL,GAAuB;AACrB,QAAM,EAAE,GAAAC,EAAA,IAAMC,EAAe,QAAQ,GAC/BC,IAAaC,EAAA,GACb,EAAE,cAAAC,GAAc,WAAAC,EAAA,IAAcC,EAAA,GAE9B,EAAE,KAAAC,GAAK,GAAGC,EAAA,IAAqBJ;AAErC,SACE,gBAAAK,EAAAC,GAAA,EACE,UAAA;AAAA,IAAA,gBAAAC;AAAA,MAACT,EAAW;AAAA,MAAX;AAAA,QACC,WAAAL;AAAA,QACA,cAAYH,KAAgBM,EAAE,iBAAiB;AAAA,QAC/C,WAAWO;AAAA,QACV,GAAGC;AAAA,QAEJ,4BAACI,GAAA,CAAA,CAAc;AAAA,MAAA;AAAA,IAAA;AAAA,IAEjB,gBAAAD;AAAA,MAACT,EAAW;AAAA,MAAX;AAAA,QACE,GAAGG;AAAA,QACJ,OAAAZ;AAAA,QACA,cAAYE,KAAaK,EAAE,kBAAkB;AAAA,QAC7C,SAASJ,KAAWS,EAAU;AAAA,QAC9B,WAAAP;AAAA,QACC,GAAGC;AAAA,MAAA;AAAA,IAAA;AAAA,EACN,GACF;AAEJ;"}
+{"version":3,"file":"HamburgerMenu.js","sources":["../../../../src/components/Common/HamburgerMenu/HamburgerMenu.tsx"],"sourcesContent":["import { useTranslation } from 'react-i18next'\nimport { type HamburgerMenuProps } from './HamburgerMenuTypes'\nimport { useComponentContext } from '@/contexts/ComponentAdapter/useComponentContext'\nimport HamburgerIcon from '@/assets/icons/hamburger.svg?react'\nimport { useMenu } from '@/hooks/useMenu'\n\n/**\n * Hamburger icon button that opens a menu of actions when activated.\n *\n * @param props - See {@link HamburgerMenuProps}.\n * @returns A button-and-menu pair rendered through the components context.\n * @internal\n */\nexport function HamburgerMenu({\n  items,\n  triggerLabel,\n  menuLabel,\n  onClose,\n  isLoading = false,\n  placement = 'bottom end',\n  ...props\n}: HamburgerMenuProps) {\n  const { t } = useTranslation('common')\n  const Components = useComponentContext()\n  const { triggerProps, menuProps } = useMenu()\n\n  const { ref, ...restTriggerProps } = triggerProps\n\n  return (\n    <>\n      <Components.ButtonIcon\n        isLoading={isLoading}\n        aria-label={triggerLabel || t('labels.openMenu')}\n        buttonRef={ref}\n        {...restTriggerProps}\n      >\n        <HamburgerIcon />\n      </Components.ButtonIcon>\n      <Components.Menu\n        {...menuProps}\n        items={items}\n        aria-label={menuLabel || t('labels.menuLabel')}\n        onClose={onClose || menuProps.onClose}\n        placement={placement}\n        {...props}\n      />\n    </>\n  )\n}\n"],"names":["HamburgerMenu","items","triggerLabel","menuLabel","onClose","isLoading","placement","props","t","useTranslation","Components","useComponentContext","triggerProps","menuProps","useMenu","ref","restTriggerProps","jsxs","Fragment","jsx","HamburgerIcon"],"mappings":";;;;;AAaO,SAASA,EAAc;AAAA,EAC5B,OAAAC;AAAA,EACA,cAAAC;AAAA,EACA,WAAAC;AAAA,EACA,SAAAC;AAAA,EACA,WAAAC,IAAY;AAAA,EACZ,WAAAC,IAAY;AAAA,EACZ,GAAGC;AACL,GAAuB;AACrB,QAAM,EAAE,GAAAC,EAAA,IAAMC,EAAe,QAAQ,GAC/BC,IAAaC,EAAA,GACb,EAAE,cAAAC,GAAc,WAAAC,EAAA,IAAcC,EAAA,GAE9B,EAAE,KAAAC,GAAK,GAAGC,EAAA,IAAqBJ;AAErC,SACE,gBAAAK,EAAAC,GAAA,EACE,UAAA;AAAA,IAAA,gBAAAC;AAAA,MAACT,EAAW;AAAA,MAAX;AAAA,QACC,WAAAL;AAAA,QACA,cAAYH,KAAgBM,EAAE,iBAAiB;AAAA,QAC/C,WAAWO;AAAA,QACV,GAAGC;AAAA,QAEJ,4BAACI,GAAA,CAAA,CAAc;AAAA,MAAA;AAAA,IAAA;AAAA,IAEjB,gBAAAD;AAAA,MAACT,EAAW;AAAA,MAAX;AAAA,QACE,GAAGG;AAAA,QACJ,OAAAZ;AAAA,QACA,cAAYE,KAAaK,EAAE,kBAAkB;AAAA,QAC7C,SAASJ,KAAWS,EAAU;AAAA,QAC9B,WAAAP;AAAA,QACC,GAAGC;AAAA,MAAA;AAAA,IAAA;AAAA,EACN,GACF;AAEJ;"}

package/dist/components/Common/HamburgerMenu/HamburgerMenuTypes.d.ts

@@ -1,10 +1,21 @@
 import { MenuProps } from '../UI/Menu/MenuTypes';
 import { DataAttributes } from '../../../types/Helpers';
+/**
+ * Props for the {@link HamburgerMenu} component.
+ *
+ * @internal
+ */
 export interface HamburgerMenuProps extends DataAttributes {
+    /** Accessible label for the trigger button. Defaults to a localized "Open menu" string. */
     triggerLabel?: string;
+    /** Accessible label for the menu popover. Defaults to a localized menu label. */
     menuLabel?: string;
+    /** Items rendered inside the menu popover. */
     items: MenuProps['items'];
+    /** Called when the menu is dismissed. */
     onClose?: () => void;
+    /** Renders the trigger button in a loading state when true. */
     isLoading?: boolean;
+    /** Placement of the menu popover relative to the trigger. Defaults to `'bottom end'`. */
     placement?: MenuProps['placement'];
 }

package/dist/components/Common/HorizontalFieldLayout/HorizontalFieldLayout.d.ts

@@ -1,2 +1,9 @@
 import { HorizontalFieldLayoutProps } from './HorizontalFieldLayoutTypes';
+/**
+ * Layout that positions a form control's children alongside its label, description, and error message.
+ *
+ * @param props - See {@link HorizontalFieldLayoutProps}.
+ * @returns The control's children laid out horizontally with associated label and helper text.
+ * @internal
+ */
 export declare const HorizontalFieldLayout: React.FC<HorizontalFieldLayoutProps>;

package/dist/components/Common/HorizontalFieldLayout/HorizontalFieldLayout.js.map

@@ -1 +1 @@
-{"version":3,"file":"HorizontalFieldLayout.js","sources":["../../../../src/components/Common/HorizontalFieldLayout/HorizontalFieldLayout.tsx"],"sourcesContent":["import classNames from 'classnames'\nimport { VisuallyHidden } from '../VisuallyHidden'\nimport { FieldErrorMessage } from '../FieldErrorMessage'\nimport { FieldDescription } from '../FieldDescription'\nimport styles from './HorizontalFieldLayout.module.scss'\nimport type { HorizontalFieldLayoutProps } from './HorizontalFieldLayoutTypes'\nimport { getDataProps } from '@/helpers/getDataProps'\n\nexport const HorizontalFieldLayout: React.FC<HorizontalFieldLayoutProps> = ({\n  label,\n  description,\n  descriptionId,\n  errorMessage,\n  errorMessageId,\n  children,\n  htmlFor,\n  className,\n  shouldVisuallyHideLabel,\n  ...props\n}: HorizontalFieldLayoutProps) => {\n  const labelContent = (\n    <label className={styles.label} htmlFor={htmlFor}>\n      {label}\n    </label>\n  )\n\n  const withDescriptionOrErrorMessage = description || errorMessage\n\n  return (\n    <div\n      className={classNames(\n        styles.root,\n        {\n          [styles.withoutVisibleLabel as string]:\n            shouldVisuallyHideLabel && withDescriptionOrErrorMessage,\n          [styles.withOnlyChildren as string]:\n            shouldVisuallyHideLabel && !withDescriptionOrErrorMessage,\n        },\n        className,\n      )}\n      {...getDataProps(props)}\n    >\n      <div className={styles.children}>{children}</div>\n      {shouldVisuallyHideLabel ? <VisuallyHidden>{labelContent}</VisuallyHidden> : labelContent}\n      <FieldDescription id={descriptionId} className={styles.description}>\n        {description}\n      </FieldDescription>\n      <FieldErrorMessage id={errorMessageId} className={styles.errorMessage}>\n        {errorMessage}\n      </FieldErrorMessage>\n    </div>\n  )\n}\n"],"names":["HorizontalFieldLayout","label","description","descriptionId","errorMessage","errorMessageId","children","htmlFor","className","shouldVisuallyHideLabel","props","labelContent","jsx","styles","withDescriptionOrErrorMessage","jsxs","classNames","getDataProps","VisuallyHidden","FieldDescription","FieldErrorMessage"],"mappings":";;;;;;;AAQO,MAAMA,IAA8D,CAAC;AAAA,EAC1E,OAAAC;AAAA,EACA,aAAAC;AAAA,EACA,eAAAC;AAAA,EACA,cAAAC;AAAA,EACA,gBAAAC;AAAA,EACA,UAAAC;AAAA,EACA,SAAAC;AAAA,EACA,WAAAC;AAAA,EACA,yBAAAC;AAAA,EACA,GAAGC;AACL,MAAkC;AAChC,QAAMC,IACJ,gBAAAC,EAAC,SAAA,EAAM,WAAWC,EAAO,OAAO,SAAAN,GAC7B,UAAAN,GACH,GAGIa,IAAgCZ,KAAeE;AAErD,SACE,gBAAAW;AAAA,IAAC;AAAA,IAAA;AAAA,MACC,WAAWC;AAAA,QACTH,EAAO;AAAA,QACP;AAAA,UACE,CAACA,EAAO,mBAA6B,GACnCJ,KAA2BK;AAAA,UAC7B,CAACD,EAAO,gBAA0B,GAChCJ,KAA2B,CAACK;AAAA,QAAA;AAAA,QAEhCN;AAAA,MAAA;AAAA,MAED,GAAGS,EAAaP,CAAK;AAAA,MAEtB,UAAA;AAAA,QAAA,gBAAAE,EAAC,OAAA,EAAI,WAAWC,EAAO,UAAW,UAAAP,GAAS;AAAA,QAC1CG,IAA0B,gBAAAG,EAACM,GAAA,EAAgB,UAAAP,EAAA,CAAa,IAAoBA;AAAA,0BAC5EQ,GAAA,EAAiB,IAAIhB,GAAe,WAAWU,EAAO,aACpD,UAAAX,GACH;AAAA,0BACCkB,GAAA,EAAkB,IAAIf,GAAgB,WAAWQ,EAAO,cACtD,UAAAT,EAAA,CACH;AAAA,MAAA;AAAA,IAAA;AAAA,EAAA;AAGN;"}
+{"version":3,"file":"HorizontalFieldLayout.js","sources":["../../../../src/components/Common/HorizontalFieldLayout/HorizontalFieldLayout.tsx"],"sourcesContent":["import classNames from 'classnames'\nimport { VisuallyHidden } from '../VisuallyHidden'\nimport { FieldErrorMessage } from '../FieldErrorMessage'\nimport { FieldDescription } from '../FieldDescription'\nimport styles from './HorizontalFieldLayout.module.scss'\nimport type { HorizontalFieldLayoutProps } from './HorizontalFieldLayoutTypes'\nimport { getDataProps } from '@/helpers/getDataProps'\n\n/**\n * Layout that positions a form control's children alongside its label, description, and error message.\n *\n * @param props - See {@link HorizontalFieldLayoutProps}.\n * @returns The control's children laid out horizontally with associated label and helper text.\n * @internal\n */\nexport const HorizontalFieldLayout: React.FC<HorizontalFieldLayoutProps> = ({\n  label,\n  description,\n  descriptionId,\n  errorMessage,\n  errorMessageId,\n  children,\n  htmlFor,\n  className,\n  shouldVisuallyHideLabel,\n  ...props\n}: HorizontalFieldLayoutProps) => {\n  const labelContent = (\n    <label className={styles.label} htmlFor={htmlFor}>\n      {label}\n    </label>\n  )\n\n  const withDescriptionOrErrorMessage = description || errorMessage\n\n  return (\n    <div\n      className={classNames(\n        styles.root,\n        {\n          [styles.withoutVisibleLabel as string]:\n            shouldVisuallyHideLabel && withDescriptionOrErrorMessage,\n          [styles.withOnlyChildren as string]:\n            shouldVisuallyHideLabel && !withDescriptionOrErrorMessage,\n        },\n        className,\n      )}\n      {...getDataProps(props)}\n    >\n      <div className={styles.children}>{children}</div>\n      {shouldVisuallyHideLabel ? <VisuallyHidden>{labelContent}</VisuallyHidden> : labelContent}\n      <FieldDescription id={descriptionId} className={styles.description}>\n        {description}\n      </FieldDescription>\n      <FieldErrorMessage id={errorMessageId} className={styles.errorMessage}>\n        {errorMessage}\n      </FieldErrorMessage>\n    </div>\n  )\n}\n"],"names":["HorizontalFieldLayout","label","description","descriptionId","errorMessage","errorMessageId","children","htmlFor","className","shouldVisuallyHideLabel","props","labelContent","jsx","styles","withDescriptionOrErrorMessage","jsxs","classNames","getDataProps","VisuallyHidden","FieldDescription","FieldErrorMessage"],"mappings":";;;;;;;AAeO,MAAMA,IAA8D,CAAC;AAAA,EAC1E,OAAAC;AAAA,EACA,aAAAC;AAAA,EACA,eAAAC;AAAA,EACA,cAAAC;AAAA,EACA,gBAAAC;AAAA,EACA,UAAAC;AAAA,EACA,SAAAC;AAAA,EACA,WAAAC;AAAA,EACA,yBAAAC;AAAA,EACA,GAAGC;AACL,MAAkC;AAChC,QAAMC,IACJ,gBAAAC,EAAC,SAAA,EAAM,WAAWC,EAAO,OAAO,SAAAN,GAC7B,UAAAN,GACH,GAGIa,IAAgCZ,KAAeE;AAErD,SACE,gBAAAW;AAAA,IAAC;AAAA,IAAA;AAAA,MACC,WAAWC;AAAA,QACTH,EAAO;AAAA,QACP;AAAA,UACE,CAACA,EAAO,mBAA6B,GACnCJ,KAA2BK;AAAA,UAC7B,CAACD,EAAO,gBAA0B,GAChCJ,KAA2B,CAACK;AAAA,QAAA;AAAA,QAEhCN;AAAA,MAAA;AAAA,MAED,GAAGS,EAAaP,CAAK;AAAA,MAEtB,UAAA;AAAA,QAAA,gBAAAE,EAAC,OAAA,EAAI,WAAWC,EAAO,UAAW,UAAAP,GAAS;AAAA,QAC1CG,IAA0B,gBAAAG,EAACM,GAAA,EAAgB,UAAAP,EAAA,CAAa,IAAoBA;AAAA,0BAC5EQ,GAAA,EAAiB,IAAIhB,GAAe,WAAWU,EAAO,aACpD,UAAAX,GACH;AAAA,0BACCkB,GAAA,EAAkB,IAAIf,GAAgB,WAAWQ,EAAO,cACtD,UAAAT,EAAA,CACH;AAAA,MAAA;AAAA,IAAA;AAAA,EAAA;AAGN;"}

package/dist/components/Common/HorizontalFieldLayout/HorizontalFieldLayoutTypes.d.ts

@@ -1,3 +1,17 @@
 import { InternalFieldLayoutProps, SharedFieldLayoutProps } from '../FieldLayout/FieldLayoutTypes';
+/**
+ * Shared layout props consumed by horizontally-laid-out form controls — label, description, error message, required state, and visual label hiding.
+ *
+ * @remarks
+ * Extended by props interfaces for inline controls such as `CheckboxProps`, `RadioProps`, and `SwitchProps`.
+ * Alias of {@link SharedFieldLayoutProps} — exposed as a distinct name to mirror the horizontal layout used by these controls.
+ *
+ * @public
+ */
 export type SharedHorizontalFieldLayoutProps = SharedFieldLayoutProps;
+/**
+ * Props for the {@link HorizontalFieldLayout} component.
+ *
+ * @internal
+ */
 export type HorizontalFieldLayoutProps = SharedHorizontalFieldLayoutProps & InternalFieldLayoutProps;

package/dist/components/Common/InlineSpinner/InlineSpinner.d.ts

@@ -2,5 +2,6 @@ interface InlineSpinnerProps {
     ariaLabel?: string;
     size?: 'small' | 'medium' | 'large';
 }
+/** @internal */
 export declare const InlineSpinner: ({ ariaLabel, size }: InlineSpinnerProps) => import("react").JSX.Element;
 export {};

package/dist/components/Common/InlineSpinner/InlineSpinner.js.map

@@ -1 +1 @@
-{"version":3,"file":"InlineSpinner.js","sources":["../../../../src/components/Common/InlineSpinner/InlineSpinner.tsx"],"sourcesContent":["import { useTranslation } from 'react-i18next'\nimport styles from './InlineSpinner.module.scss'\nimport SpinnerIcon from '@/assets/icons/spinner_small.svg?react'\n\ninterface InlineSpinnerProps {\n  ariaLabel?: string\n  size?: 'small' | 'medium' | 'large'\n}\n\nexport const InlineSpinner = ({ ariaLabel, size = 'small' }: InlineSpinnerProps) => {\n  const { t } = useTranslation('common')\n  const defaultAriaLabel = t('status.loading')\n\n  const sizeMap = {\n    small: 16,\n    medium: 20,\n    large: 24,\n  }\n\n  const iconSize = sizeMap[size]\n\n  return (\n    <span\n      className={styles.inlineSpinner}\n      aria-label={ariaLabel || defaultAriaLabel}\n      aria-live=\"polite\"\n      role=\"status\"\n    >\n      <SpinnerIcon className={styles.spinnerIcon} width={iconSize} height={iconSize} />\n    </span>\n  )\n}\n"],"names":["InlineSpinner","ariaLabel","size","t","useTranslation","defaultAriaLabel","iconSize","jsx","styles","SpinnerIcon"],"mappings":";;;;AASO,MAAMA,IAAgB,CAAC,EAAE,WAAAC,GAAW,MAAAC,IAAO,cAAkC;AAClF,QAAM,EAAE,GAAAC,EAAA,IAAMC,EAAe,QAAQ,GAC/BC,IAAmBF,EAAE,gBAAgB,GAQrCG,IANU;AAAA,IACd,OAAO;AAAA,IACP,QAAQ;AAAA,IACR,OAAO;AAAA,EAAA,EAGgBJ,CAAI;AAE7B,SACE,gBAAAK;AAAA,IAAC;AAAA,IAAA;AAAA,MACC,WAAWC,EAAO;AAAA,MAClB,cAAYP,KAAaI;AAAA,MACzB,aAAU;AAAA,MACV,MAAK;AAAA,MAEL,UAAA,gBAAAE,EAACE,KAAY,WAAWD,EAAO,aAAa,OAAOF,GAAU,QAAQA,EAAA,CAAU;AAAA,IAAA;AAAA,EAAA;AAGrF;"}
+{"version":3,"file":"InlineSpinner.js","sources":["../../../../src/components/Common/InlineSpinner/InlineSpinner.tsx"],"sourcesContent":["import { useTranslation } from 'react-i18next'\nimport styles from './InlineSpinner.module.scss'\nimport SpinnerIcon from '@/assets/icons/spinner_small.svg?react'\n\ninterface InlineSpinnerProps {\n  ariaLabel?: string\n  size?: 'small' | 'medium' | 'large'\n}\n\n/** @internal */\nexport const InlineSpinner = ({ ariaLabel, size = 'small' }: InlineSpinnerProps) => {\n  const { t } = useTranslation('common')\n  const defaultAriaLabel = t('status.loading')\n\n  const sizeMap = {\n    small: 16,\n    medium: 20,\n    large: 24,\n  }\n\n  const iconSize = sizeMap[size]\n\n  return (\n    <span\n      className={styles.inlineSpinner}\n      aria-label={ariaLabel || defaultAriaLabel}\n      aria-live=\"polite\"\n      role=\"status\"\n    >\n      <SpinnerIcon className={styles.spinnerIcon} width={iconSize} height={iconSize} />\n    </span>\n  )\n}\n"],"names":["InlineSpinner","ariaLabel","size","t","useTranslation","defaultAriaLabel","iconSize","jsx","styles","SpinnerIcon"],"mappings":";;;;AAUO,MAAMA,IAAgB,CAAC,EAAE,WAAAC,GAAW,MAAAC,IAAO,cAAkC;AAClF,QAAM,EAAE,GAAAC,EAAA,IAAMC,EAAe,QAAQ,GAC/BC,IAAmBF,EAAE,gBAAgB,GAQrCG,IANU;AAAA,IACd,OAAO;AAAA,IACP,QAAQ;AAAA,IACR,OAAO;AAAA,EAAA,EAGgBJ,CAAI;AAE7B,SACE,gBAAAK;AAAA,IAAC;AAAA,IAAA;AAAA,MACC,WAAWC,EAAO;AAAA,MAClB,cAAYP,KAAaI;AAAA,MACzB,aAAU;AAAA,MACV,MAAK;AAAA,MAEL,UAAA,gBAAAE,EAACE,KAAY,WAAWD,EAAO,aAAa,OAAOF,GAAU,QAAQA,EAAA,CAAU;AAAA,IAAA;AAAA,EAAA;AAGrF;"}

package/dist/components/Common/InternalError/InternalError.d.ts

@@ -1,2 +1,3 @@
 import { FallbackProps } from 'react-error-boundary';
+/** @internal */
 export declare const InternalError: ({ error, resetErrorBoundary }: FallbackProps) => import("react").JSX.Element;

package/dist/components/Common/InternalError/InternalError.js.map

@@ -1 +1 @@
-{"version":3,"file":"InternalError.js","sources":["../../../../src/components/Common/InternalError/InternalError.tsx"],"sourcesContent":["import type { FallbackProps } from 'react-error-boundary'\nimport { Trans, useTranslation } from 'react-i18next'\nimport styles from './InternalError.module.scss'\nimport { useComponentContext } from '@/contexts/ComponentAdapter/useComponentContext'\n\nexport const InternalError = ({ error, resetErrorBoundary }: FallbackProps) => {\n  const { t } = useTranslation('common')\n  const Components = useComponentContext()\n  const errorMessage =\n    typeof error === 'string'\n      ? error\n      : error instanceof Error\n        ? error.message\n        : t('errors.unknownError')\n  return (\n    <div className={styles.internalErrorCard} role=\"alert\" data-testid=\"internal-error-card\">\n      <div>\n        <Components.Heading className={styles.internalErrorCardTitle} as=\"h1\" styledAs=\"h3\">\n          {t('errors.errorHeading')}\n        </Components.Heading>\n        <Components.Text className={styles.errorMessage}>\n          <Trans\n            t={t}\n            i18nKey=\"errors.globalReactError\"\n            values={{ error: errorMessage }}\n            shouldUnescape={true}\n          />\n        </Components.Text>\n      </div>\n      <div>\n        <Components.Button variant=\"secondary\" onClick={resetErrorBoundary}>\n          {t('errors.resetGlobalError')}\n        </Components.Button>\n      </div>\n    </div>\n  )\n}\n"],"names":["InternalError","error","resetErrorBoundary","t","useTranslation","Components","useComponentContext","errorMessage","jsxs","styles","jsx","Trans"],"mappings":";;;;AAKO,MAAMA,IAAgB,CAAC,EAAE,OAAAC,GAAO,oBAAAC,QAAwC;AAC7E,QAAM,EAAE,GAAAC,EAAA,IAAMC,EAAe,QAAQ,GAC/BC,IAAaC,EAAA,GACbC,IACJ,OAAON,KAAU,WACbA,IACAA,aAAiB,QACfA,EAAM,UACNE,EAAE,qBAAqB;AAC/B,SACE,gBAAAK,EAAC,SAAI,WAAWC,EAAO,mBAAmB,MAAK,SAAQ,eAAY,uBACjE,UAAA;AAAA,IAAA,gBAAAD,EAAC,OAAA,EACC,UAAA;AAAA,MAAA,gBAAAE,EAACL,EAAW,SAAX,EAAmB,WAAWI,EAAO,wBAAwB,IAAG,MAAK,UAAS,MAC5E,UAAAN,EAAE,qBAAqB,EAAA,CAC1B;AAAA,wBACCE,EAAW,MAAX,EAAgB,WAAWI,EAAO,cACjC,UAAA,gBAAAC;AAAA,QAACC;AAAA,QAAA;AAAA,UACC,GAAAR;AAAA,UACA,SAAQ;AAAA,UACR,QAAQ,EAAE,OAAOI,EAAA;AAAA,UACjB,gBAAgB;AAAA,QAAA;AAAA,MAAA,EAClB,CACF;AAAA,IAAA,GACF;AAAA,IACA,gBAAAG,EAAC,OAAA,EACC,UAAA,gBAAAA,EAACL,EAAW,QAAX,EAAkB,SAAQ,aAAY,SAASH,GAC7C,UAAAC,EAAE,yBAAyB,GAC9B,EAAA,CACF;AAAA,EAAA,GACF;AAEJ;"}
+{"version":3,"file":"InternalError.js","sources":["../../../../src/components/Common/InternalError/InternalError.tsx"],"sourcesContent":["import type { FallbackProps } from 'react-error-boundary'\nimport { Trans, useTranslation } from 'react-i18next'\nimport styles from './InternalError.module.scss'\nimport { useComponentContext } from '@/contexts/ComponentAdapter/useComponentContext'\n\n/** @internal */\nexport const InternalError = ({ error, resetErrorBoundary }: FallbackProps) => {\n  const { t } = useTranslation('common')\n  const Components = useComponentContext()\n  const errorMessage =\n    typeof error === 'string'\n      ? error\n      : error instanceof Error\n        ? error.message\n        : t('errors.unknownError')\n  return (\n    <div className={styles.internalErrorCard} role=\"alert\" data-testid=\"internal-error-card\">\n      <div>\n        <Components.Heading className={styles.internalErrorCardTitle} as=\"h1\" styledAs=\"h3\">\n          {t('errors.errorHeading')}\n        </Components.Heading>\n        <Components.Text className={styles.errorMessage}>\n          <Trans\n            t={t}\n            i18nKey=\"errors.globalReactError\"\n            values={{ error: errorMessage }}\n            shouldUnescape={true}\n          />\n        </Components.Text>\n      </div>\n      <div>\n        <Components.Button variant=\"secondary\" onClick={resetErrorBoundary}>\n          {t('errors.resetGlobalError')}\n        </Components.Button>\n      </div>\n    </div>\n  )\n}\n"],"names":["InternalError","error","resetErrorBoundary","t","useTranslation","Components","useComponentContext","errorMessage","jsxs","styles","jsx","Trans"],"mappings":";;;;AAMO,MAAMA,IAAgB,CAAC,EAAE,OAAAC,GAAO,oBAAAC,QAAwC;AAC7E,QAAM,EAAE,GAAAC,EAAA,IAAMC,EAAe,QAAQ,GAC/BC,IAAaC,EAAA,GACbC,IACJ,OAAON,KAAU,WACbA,IACAA,aAAiB,QACfA,EAAM,UACNE,EAAE,qBAAqB;AAC/B,SACE,gBAAAK,EAAC,SAAI,WAAWC,EAAO,mBAAmB,MAAK,SAAQ,eAAY,uBACjE,UAAA;AAAA,IAAA,gBAAAD,EAAC,OAAA,EACC,UAAA;AAAA,MAAA,gBAAAE,EAACL,EAAW,SAAX,EAAmB,WAAWI,EAAO,wBAAwB,IAAG,MAAK,UAAS,MAC5E,UAAAN,EAAE,qBAAqB,EAAA,CAC1B;AAAA,wBACCE,EAAW,MAAX,EAAgB,WAAWI,EAAO,cACjC,UAAA,gBAAAC;AAAA,QAACC;AAAA,QAAA;AAAA,UACC,GAAAR;AAAA,UACA,SAAQ;AAAA,UACR,QAAQ,EAAE,OAAOI,EAAA;AAAA,UACjB,gBAAgB;AAAA,QAAA;AAAA,MAAA,EAClB,CACF;AAAA,IAAA,GACF;AAAA,IACA,gBAAAG,EAAC,OAAA,EACC,UAAA,gBAAAA,EAACL,EAAW,QAAX,EAAkB,SAAQ,aAAY,SAASH,GAC7C,UAAAC,EAAE,yBAAyB,GAC9B,EAAA,CACF;AAAA,EAAA,GACF;AAEJ;"}