@adgytec/adgytec-web-ui-components 2.3.0 → 2.3.1

package/dist/components/Button/LinkButton/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["renderProps","icon","iconSize","handlePress"],"sources":["../../../../src/components/Button/LinkButton/LinkButton.tsx"],"sourcesContent":["import { clsx } from \"clsx\";\nimport { Link } from \"react-aria-components\";\nimport { Icon } from \"@/components/Icon\";\nimport { Splash } from \"@/components/Splash/Splash\";\nimport { useSplash } from \"@/components/Splash/useSplash\";\nimport { TapTarget } from \"@/utils/tapTarget\";\nimport {\n    ButtonCore,\n    ButtonIconSizeMapping,\n    ButtonLabelTextMapping,\n    ButtonReset,\n    ButtonSizeBase,\n    buttonColorBase,\n    buttonColorConfig,\n    buttonSizeConfig,\n    newButtonBaseDataAttrs,\n    useButtonConfig,\n    withTooltip,\n} from \"../core\";\nimport type { LinkButtonProps } from \"./types\";\n\nexport const LinkButton: React.FC<LinkButtonProps> = ({\n    size,\n    shape,\n    color,\n    tooltip,\n    icon,\n    children,\n    onPress,\n    className,\n    iconPlacement,\n    ...props\n}) => {\n    const { buttonColor, buttonShape, buttonSize, buttonIconPlacement } =\n        useButtonConfig({\n            size,\n            shape,\n            color,\n            iconPlacement,\n        });\n\n    const { splashInfo, handlePress } = useSplash(onPress);\n    const isChildFunc = typeof children === \"function\";\n\n    const baseButtonDataAttrs = newButtonBaseDataAttrs({\n        shape: buttonShape,\n        size: buttonSize,\n        color: buttonColor,\n    });\n\n    return withTooltip(\n        <Link\n            onPress={handlePress}\n            className={(renderProps) =>\n                clsx(\n                    ButtonReset,\n                    TapTarget,\n                    buttonSizeConfig(buttonSize),\n                    buttonColorConfig(buttonColor),\n                    typeof className === \"function\"\n                        ? className(renderProps)\n                        : className\n                )\n            }\n            {...props}\n            {...baseButtonDataAttrs}\n            data-button\n            data-link-button\n        >\n            {(renderProps) => {\n                const {\n                    isDisabled,\n                    isFocusVisible,\n                    isFocused,\n                    isPressed,\n                    isHovered,\n                } = renderProps;\n\n                const dataAttrs = {\n                    ...baseButtonDataAttrs,\n                    \"data-hovered\": isHovered || undefined,\n                    \"data-disabled\": isDisabled || undefined,\n                    \"data-focused\": isFocused || undefined,\n                    \"data-focus-visible\": isFocusVisible || undefined,\n                    \"data-pressed\": isPressed || undefined,\n                    \"data-visual-button\": true,\n                };\n\n                const iconSize = ButtonIconSizeMapping[buttonSize];\n                const iconComp = icon && <Icon icon={icon} size={iconSize} />;\n\n                return (\n                    <span\n                        className={clsx(\n                            ButtonCore,\n                            buttonColorBase,\n                            ButtonSizeBase,\n                            ButtonLabelTextMapping[buttonSize]\n                        )}\n                        {...dataAttrs}\n                    >\n                        {splashInfo && <Splash {...splashInfo} />}\n\n                        {buttonIconPlacement === \"start\" && iconComp}\n\n                        {isChildFunc ? children(renderProps) : children}\n\n                        {buttonIconPlacement === \"end\" && iconComp}\n                    </span>\n                );\n            }}\n        </Link>,\n        tooltip\n    );\n};\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":["renderProps","icon","iconSize","handlePress","_c","require_compiler_runtime","Icon","Splash","useSplash","buttonSizeConfig","ButtonCore","ButtonReset","ButtonIconSizeMapping","buttonColorBase","useButtonConfig","ButtonSizeBase","withTooltip","buttonColorConfig","import_compiler_runtime","LinkButton","$","children","className","color","icon","iconPlacement","onPress","props","shape","size","tooltip","t0","t1","isChildFunc","t2","buttonColor","buttonShape","buttonSize","newButtonBaseDataAttrs","baseButtonDataAttrs","t3","clsx","TapTarget","renderProps","t4","buttonIconPlacement","splashInfo","renderProps_0","dataAttrs","isHovered","isDisabled","isFocused","isFocusVisible","isPressed","iconSize","iconComp","ButtonLabelTextMapping","t5","handlePress","Link","t6"],"sources":["../../../../src/components/Button/LinkButton/LinkButton.tsx"],"sourcesContent":["import { clsx } from \"clsx\";\nimport { Link } from \"react-aria-components\";\nimport { Icon } from \"@/components/Icon\";\nimport { Splash } from \"@/components/Splash/Splash\";\nimport { useSplash } from \"@/components/Splash/useSplash\";\nimport { TapTarget } from \"@/utils/tapTarget\";\nimport {\n    ButtonCore,\n    ButtonIconSizeMapping,\n    ButtonLabelTextMapping,\n    ButtonReset,\n    ButtonSizeBase,\n    buttonColorBase,\n    buttonColorConfig,\n    buttonSizeConfig,\n    newButtonBaseDataAttrs,\n    useButtonConfig,\n    withTooltip,\n} from \"../core\";\nimport type { LinkButtonProps } from \"./types\";\n\n/**\n * A link component styled to look and behave like a Material Design 3 button.\n *\n * Used for navigation actions that should visually appear as standard buttons.\n * Renders an accessible anchor element underneath via React Aria's `Link`,\n * supporting native link behaviors (`href`, `target`, `rel`), keyboard activation,\n * ripple splash animations, icons, and tooltips.\n *\n * @example\n * ```tsx\n * <LinkButton href=\"https://example.com\" target=\"_blank\" icon={ExternalLink} iconPlacement=\"end\">\n *     Visit Website\n * </LinkButton>\n * ```\n */\nexport const LinkButton: React.FC<LinkButtonProps> = ({\n    size,\n    shape,\n    color,\n    tooltip,\n    icon,\n    children,\n    onPress,\n    className,\n    iconPlacement,\n    ...props\n}) => {\n    const { buttonColor, buttonShape, buttonSize, buttonIconPlacement } =\n        useButtonConfig({\n            size,\n            shape,\n            color,\n            iconPlacement,\n        });\n\n    const { splashInfo, handlePress } = useSplash(onPress);\n    const isChildFunc = typeof children === \"function\";\n\n    const baseButtonDataAttrs = newButtonBaseDataAttrs({\n        shape: buttonShape,\n        size: buttonSize,\n        color: buttonColor,\n    });\n\n    return withTooltip(\n        <Link\n            onPress={handlePress}\n            className={(renderProps) =>\n                clsx(\n                    ButtonReset,\n                    TapTarget,\n                    buttonSizeConfig(buttonSize),\n                    buttonColorConfig(buttonColor),\n                    typeof className === \"function\"\n                        ? className(renderProps)\n                        : className\n                )\n            }\n            {...props}\n            {...baseButtonDataAttrs}\n            data-button\n            data-link-button\n        >\n            {(renderProps) => {\n                const {\n                    isDisabled,\n                    isFocusVisible,\n                    isFocused,\n                    isPressed,\n                    isHovered,\n                } = renderProps;\n\n                const dataAttrs = {\n                    ...baseButtonDataAttrs,\n                    \"data-hovered\": isHovered || undefined,\n                    \"data-disabled\": isDisabled || undefined,\n                    \"data-focused\": isFocused || undefined,\n                    \"data-focus-visible\": isFocusVisible || undefined,\n                    \"data-pressed\": isPressed || undefined,\n                    \"data-visual-button\": true,\n                };\n\n                const iconSize = ButtonIconSizeMapping[buttonSize];\n                const iconComp = icon && <Icon icon={icon} size={iconSize} />;\n\n                return (\n                    <span\n                        className={clsx(\n                            ButtonCore,\n                            buttonColorBase,\n                            ButtonSizeBase,\n                            ButtonLabelTextMapping[buttonSize]\n                        )}\n                        {...dataAttrs}\n                    >\n                        {splashInfo && <Splash {...splashInfo} />}\n\n                        {buttonIconPlacement === \"start\" && iconComp}\n\n                        {isChildFunc ? children(renderProps) : children}\n\n                        {buttonIconPlacement === \"end\" && iconComp}\n                    </span>\n                );\n            }}\n        </Link>,\n        tooltip\n    );\n};\n"],"mappings":"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"}

package/dist/components/Button/LinkButton/types.d.ts

@@ -1,4 +1,8 @@
 import { Link } from 'react-aria-components';
 import { ButtonBaseProps } from '../core';
+/**
+ * Props for the {@link LinkButton} component.
+ * Combines React Aria's {@link Link} props with shared {@link ButtonBaseProps}.
+ */
 export interface LinkButtonProps extends React.ComponentPropsWithRef<typeof Link>, ButtonBaseProps {
 }

package/dist/components/Button/LinkIconButton/LinkIconButton.d.ts

@@ -1,2 +1,21 @@
 import { LinkIconButtonProps } from './types';
+/**
+ * A link component styled as a compact Material Design 3 icon button.
+ *
+ * Used for icon-only navigation actions (such as external social links, repository links,
+ * or compact icon navigation). Built on top of React Aria's `Link`.
+ *
+ * Always provide an accessible `aria-label` or `aria-labelledby` attribute for screen reader accessibility.
+ *
+ * @example
+ * ```tsx
+ * <LinkIconButton
+ *     href="https://github.com"
+ *     target="_blank"
+ *     icon={Github}
+ *     tooltip="GitHub Profile"
+ *     aria-label="GitHub Profile"
+ * />
+ * ```
+ */
 export declare const LinkIconButton: React.FC<LinkIconButtonProps>;

package/dist/components/Button/LinkIconButton/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../../src/components/Button/LinkIconButton/LinkIconButton.tsx"],"sourcesContent":["import { clsx } from \"clsx\";\nimport { Link } from \"react-aria-components\";\nimport { Icon } from \"@/components/Icon\";\nimport { Splash } from \"@/components/Splash/Splash\";\nimport { useSplash } from \"@/components/Splash/useSplash\";\nimport { TapTarget } from \"@/utils/tapTarget\";\nimport {\n    ButtonCore,\n    ButtonReset,\n    ButtonSizeBase,\n    buttonColorBase,\n    buttonColorConfig,\n    buttonSizeConfig,\n    IconButtonIconSizeMapping,\n    newButtonBaseDataAttrs,\n    useButtonConfig,\n    withTooltip,\n} from \"../core\";\nimport type { LinkIconButtonProps } from \"./types\";\n\nexport const LinkIconButton: React.FC<LinkIconButtonProps> = ({\n    size,\n    shape,\n    color,\n    width = \"default\",\n    tooltip,\n    icon,\n    onPress,\n    className,\n    ...props\n}) => {\n    const { buttonColor, buttonShape, buttonSize } = useButtonConfig({\n        size,\n        shape,\n        color,\n    });\n\n    const { splashInfo, handlePress } = useSplash(onPress);\n\n    const baseButtonDataAttrs = newButtonBaseDataAttrs({\n        shape: buttonShape,\n        size: buttonSize,\n        color: buttonColor,\n    });\n\n    const iconButtonDataAttrs = {\n        ...baseButtonDataAttrs,\n        \"data-width\": width,\n        \"data-icon-button\": true,\n    };\n\n    return withTooltip(\n        <Link\n            onPress={handlePress}\n            className={(renderProps) =>\n                clsx(\n                    ButtonReset,\n                    TapTarget,\n                    buttonSizeConfig(buttonSize),\n                    buttonColorConfig(buttonColor),\n                    typeof className === \"function\"\n                        ? className(renderProps)\n                        : className\n                )\n            }\n            {...props}\n            {...iconButtonDataAttrs}\n            data-button\n            data-link-button\n        >\n            {({\n                isDisabled,\n                isFocusVisible,\n                isFocused,\n                isPressed,\n                isHovered,\n            }) => {\n                const dataAttrs = {\n                    ...iconButtonDataAttrs,\n                    \"data-hovered\": isHovered || undefined,\n                    \"data-disabled\": isDisabled || undefined,\n                    \"data-focused\": isFocused || undefined,\n                    \"data-focus-visible\": isFocusVisible || undefined,\n                    \"data-pressed\": isPressed || undefined,\n                    \"data-visual-button\": true,\n                };\n\n                const iconSize = IconButtonIconSizeMapping[buttonSize];\n                return (\n                    <span\n                        className={clsx(\n                            ButtonCore,\n                            buttonColorBase,\n                            ButtonSizeBase\n                        )}\n                        {...dataAttrs}\n                    >\n                        {splashInfo && <Splash {...splashInfo} />}\n                        {icon && <Icon icon={icon} size={iconSize} />}\n                    </span>\n                );\n            }}\n        </Link>,\n        tooltip\n    );\n};\n"],"mappings":";;;;;;;;AAoBA,IAAa,KAAiD,EAC1D,SACA,UACA,UACA,WAAQ,WACR,YACA,SACA,YACA,cACA,GAAG,QACD;CACF,IAAM,EAAE,gBAAa,gBAAa,kBAAe,EAAgB;EAC7D;EACA;EACA;CACJ,CAAC,GAEK,EAAE,eAAY,mBAAgB,EAAU,CAAO,GAQ/C,IAAsB;EACxB,GAPwB,EAAuB;GAC/C,OAAO;GACP,MAAM;GACN,OAAO;EACX,CAGO;EACH,cAAc;EACd,oBAAoB;CACxB;CAEA,OAAO,EACH,kBAAC,GAAD;EACI,SAAS;EACT,YAAY,MACR,EACI,GACA,GACA,EAAiB,CAAU,GAC3B,EAAkB,CAAW,GAC7B,OAAO,KAAc,aACf,EAAU,CAAW,IACrB,CACV;EAEJ,GAAI;EACJ,GAAI;EACJ,eAAA;EACA,oBAAA;aAEE,EACE,eACA,mBACA,cACA,cACA,mBACE;GACF,IAAM,IAAY;IACd,GAAG;IACH,gBAAgB,KAAa,KAAA;IAC7B,iBAAiB,KAAc,KAAA;IAC/B,gBAAgB,KAAa,KAAA;IAC7B,sBAAsB,KAAkB,KAAA;IACxC,gBAAgB,KAAa,KAAA;IAC7B,sBAAsB;GAC1B,GAEM,IAAW,EAA0B;GAC3C,OACI,kBAAC,QAAD;IACI,WAAW,EACP,GACA,GACA,CACJ;IACA,GAAI;cANR,CAQK,KAAc,kBAAC,GAAD,EAAQ,GAAI,EAAW,CAAA,GACrC,KAAQ,kBAAC,GAAD;KAAY;KAAM,MAAM;IAAS,CAAA,CACxC;;EAEd;CACE,CAAA,GACN,CACJ;AACJ"}
+{"version":3,"file":"index.js","names":["TapTarget","useSplash","buttonSizeConfig","ButtonCore","ButtonReset","buttonColorBase","useButtonConfig","ButtonSizeBase","newButtonBaseDataAttrs","IconButtonIconSizeMapping","withTooltip","buttonColorConfig","LinkIconButton","props","onPress","iconButtonDataAttrs","buttonShape","buttonSize","buttonColor","width","Link","handlePress","clsx","className","renderProps","dataAttrs","isHovered","isDisabled","isFocused","isFocusVisible","isPressed","iconSize","splashInfo","Splash","icon","Icon","tooltip"],"sources":["../../../../src/components/Button/LinkIconButton/LinkIconButton.tsx"],"sourcesContent":["import { clsx } from \"clsx\";\nimport { Link } from \"react-aria-components\";\nimport { Icon } from \"@/components/Icon\";\nimport { Splash } from \"@/components/Splash/Splash\";\nimport { useSplash } from \"@/components/Splash/useSplash\";\nimport { TapTarget } from \"@/utils/tapTarget\";\nimport {\n    ButtonCore,\n    ButtonReset,\n    ButtonSizeBase,\n    buttonColorBase,\n    buttonColorConfig,\n    buttonSizeConfig,\n    IconButtonIconSizeMapping,\n    newButtonBaseDataAttrs,\n    useButtonConfig,\n    withTooltip,\n} from \"../core\";\nimport type { LinkIconButtonProps } from \"./types\";\n\n/**\n * A link component styled as a compact Material Design 3 icon button.\n *\n * Used for icon-only navigation actions (such as external social links, repository links,\n * or compact icon navigation). Built on top of React Aria's `Link`.\n *\n * Always provide an accessible `aria-label` or `aria-labelledby` attribute for screen reader accessibility.\n *\n * @example\n * ```tsx\n * <LinkIconButton\n *     href=\"https://github.com\"\n *     target=\"_blank\"\n *     icon={Github}\n *     tooltip=\"GitHub Profile\"\n *     aria-label=\"GitHub Profile\"\n * />\n * ```\n */\nexport const LinkIconButton: React.FC<LinkIconButtonProps> = ({\n    size,\n    shape,\n    color,\n    width = \"default\",\n    tooltip,\n    icon,\n    onPress,\n    className,\n    ...props\n}) => {\n    const { buttonColor, buttonShape, buttonSize } = useButtonConfig({\n        size,\n        shape,\n        color,\n    });\n\n    const { splashInfo, handlePress } = useSplash(onPress);\n\n    const baseButtonDataAttrs = newButtonBaseDataAttrs({\n        shape: buttonShape,\n        size: buttonSize,\n        color: buttonColor,\n    });\n\n    const iconButtonDataAttrs = {\n        ...baseButtonDataAttrs,\n        \"data-width\": width,\n        \"data-icon-button\": true,\n    };\n\n    return withTooltip(\n        <Link\n            onPress={handlePress}\n            className={(renderProps) =>\n                clsx(\n                    ButtonReset,\n                    TapTarget,\n                    buttonSizeConfig(buttonSize),\n                    buttonColorConfig(buttonColor),\n                    typeof className === \"function\"\n                        ? className(renderProps)\n                        : className\n                )\n            }\n            {...props}\n            {...iconButtonDataAttrs}\n            data-button\n            data-link-button\n        >\n            {({\n                isDisabled,\n                isFocusVisible,\n                isFocused,\n                isPressed,\n                isHovered,\n            }) => {\n                const dataAttrs = {\n                    ...iconButtonDataAttrs,\n                    \"data-hovered\": isHovered || undefined,\n                    \"data-disabled\": isDisabled || undefined,\n                    \"data-focused\": isFocused || undefined,\n                    \"data-focus-visible\": isFocusVisible || undefined,\n                    \"data-pressed\": isPressed || undefined,\n                    \"data-visual-button\": true,\n                };\n\n                const iconSize = IconButtonIconSizeMapping[buttonSize];\n                return (\n                    <span\n                        className={clsx(\n                            ButtonCore,\n                            buttonColorBase,\n                            ButtonSizeBase\n                        )}\n                        {...dataAttrs}\n                    >\n                        {splashInfo && <Splash {...splashInfo} />}\n                        {icon && <Icon icon={icon} size={iconSize} />}\n                    </span>\n                );\n            }}\n        </Link>,\n        tooltip\n    );\n};\n"],"mappings":";;;;;;;;AAuCA,IAAaY,KAAiD,EAC1D,SACA,UACA,UACA,WAAQ,WACR,YACA,SACA,YACA,cACA,GAAGC,QACD;CACF,IAAM,EAAE,gBAAa,gBAAa,kBAAeP,EAAgB;EAC7D;EACA;EACA;CACJ,CAAC,GAEK,EAAE,eAAY,mBAAgBL,EAAUa,CAAO,GAQ/CC,IAAsB;EACxB,GAPwBP,EAAuB;GAC/C,OAAOQ;GACP,MAAMC;GACN,OAAOC;EACX,CAGO;EACH,cAAcC;EACd,oBAAoB;CACxB;CAEA,OAAOT,EACH,kBAACU,GAAD;EACI,SAASC;EACT,YAAY,MACRC,EACIlB,GACAJ,GACAE,EAAiBe,CAAU,GAC3BN,EAAkBO,CAAW,GAC7B,OAAOK,KAAc,aACfA,EAAUC,CAAW,IACrBD,CACV;EAEJ,GAAIV;EACJ,GAAIE;EACJ,eAAA;EACA,oBAAA;EAEE,WAAA,EACE,eACA,mBACA,cACA,cACA,mBACE;GACF,IAAMU,IAAY;IACd,GAAGV;IACH,gBAAgBW,KAAa,KAAA;IAC7B,iBAAiBC,KAAc,KAAA;IAC/B,gBAAgBC,KAAa,KAAA;IAC7B,sBAAsBC,KAAkB,KAAA;IACxC,gBAAgBC,KAAa,KAAA;IAC7B,sBAAsB;GAC1B,GAEMC,IAAWtB,EAA0BQ;GAC3C,OACI,kBAAC,QAAD;IACI,WAAWK,EACPnB,GACAE,GACAE,CACJ;IACA,GAAIkB;IANR,UAAA,CAQKO,KAAc,kBAACC,GAAD,EAAQ,GAAID,EAAW,CAAA,GACrCE,KAAQ,kBAACC,GAAD;KAAY;KAAM,MAAMJ;IAAS,CAAA,CACxC;;EAEd;CACE,CAAA,GACNK,CACJ;AACJ"}

package/dist/components/Button/LinkIconButton/types.d.ts

@@ -1,4 +1,8 @@
 import { Link } from 'react-aria-components';
 import { IconButtonBaseProps } from '../core';
+/**
+ * Props for the {@link LinkIconButton} component.
+ * Combines React Aria's {@link Link} props (omitting `children`) with {@link IconButtonBaseProps}.
+ */
 export interface LinkIconButtonProps extends Omit<React.ComponentPropsWithRef<typeof Link>, "children">, IconButtonBaseProps {
 }

package/dist/components/Button/SplitButton/SplitButton/SplitButton.d.ts

@@ -1,2 +1,26 @@
 import { SplitButtonProps } from './types';
+/**
+ * A composite button container implementing Material Design 3 Split Buttons.
+ *
+ * Couples a primary action button ({@link SplitButtonPrimary}) with an adjacent dropdown menu trigger
+ * ({@link SplitButtonTrigger}) inside an accessible React Aria `Toolbar`.
+ * Synchronizes size, color variant, disabled, and pending states across both button parts via context.
+ *
+ * @example
+ * ```tsx
+ * <SplitButton color="tonal">
+ *     <SplitButtonPrimary icon={Save} onPress={handleSave}>
+ *         Save
+ *     </SplitButtonPrimary>
+ *     <MenuTrigger>
+ *         <SplitButtonTrigger aria-label="More save options" />
+ *         <MenuPopover>
+ *             <Menu>
+ *                 <MenuItem label="Save as draft" />
+ *             </Menu>
+ *         </MenuPopover>
+ *     </MenuTrigger>
+ * </SplitButton>
+ * ```
+ */
 export declare const SplitButton: React.FC<SplitButtonProps>;

package/dist/components/Button/SplitButton/SplitButton/types.d.ts

@@ -1,12 +1,35 @@
 import { CSSProperties, ReactNode } from 'react';
 import { Toolbar } from 'react-aria-components';
 import { ButtonSize, SplitButtonColor } from '../../core';
+/**
+ * Props for the {@link SplitButton} container component.
+ * Extends React Aria's {@link Toolbar} props with split button styling and shared state.
+ */
 export interface SplitButtonProps extends Omit<React.ComponentPropsWithRef<typeof Toolbar>, "orientation" | "children" | "className" | "style"> {
+    /**
+     * Visual color style variant applied to both primary and trigger buttons.
+     *
+     * @default "filled"
+     */
     color?: SplitButtonColor;
+    /**
+     * Size preset applied to both primary and trigger buttons.
+     *
+     * @default "small"
+     */
     size?: ButtonSize;
+    /**
+     * Global loading state applied to both primary and trigger buttons.
+     */
     isPending?: boolean;
+    /**
+     * Global disabled state applied to both primary and trigger buttons.
+     */
     isDisabled?: boolean;
+    /** Primary button and menu trigger components. */
     children?: ReactNode;
+    /** Optional CSS class name for the container element. */
     className?: string;
+    /** Optional inline styles for the container element. */
     style?: CSSProperties;
 }

package/dist/components/Button/SplitButton/SplitButtonContext/context.d.ts

@@ -1,8 +1,19 @@
 import { ButtonSize, SplitButtonColor } from '../../core';
+/**
+ * Context state shared across all components of a {@link SplitButton}.
+ */
 export type SplitButtonState = {
+    /** Whether both primary action and trigger buttons are currently in a pending state. */
     isPending?: boolean;
+    /** Whether both primary action and trigger buttons are currently disabled. */
     isDisabled?: boolean;
+    /** Uniform size preset for the split button pair. */
     size: ButtonSize;
+    /** Visual color style variant applied to both split button parts. */
     color: SplitButtonColor;
 };
+/**
+ * React Context providing size, color, pending, and disabled state from
+ * a parent `SplitButton` container to `SplitButtonPrimary` and `SplitButtonTrigger`.
+ */
 export declare const SplitButtonContext: import('react').Context<SplitButtonState>;

package/dist/components/Button/SplitButton/SplitButtonContext/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../../../src/components/Button/SplitButton/SplitButtonContext/context.ts","../../../../../src/components/Button/SplitButton/SplitButtonContext/useSplitButtonContext.ts"],"sourcesContent":["import { createContext } from \"react\";\nimport type { ButtonSize, SplitButtonColor } from \"../../core\";\n\nexport type SplitButtonState = {\n    isPending?: boolean;\n    isDisabled?: boolean;\n\n    size: ButtonSize;\n    color: SplitButtonColor;\n};\n\nexport const SplitButtonContext = createContext<SplitButtonState>({\n    size: \"small\",\n    color: \"filled\",\n});\n","import { useContext } from \"react\";\nimport { SplitButtonContext } from \"./context\";\n\nexport function useSplitButtonContext() {\n    return useContext(SplitButtonContext);\n}\n"],"mappings":";;AAWA,IAAa,IAAqB,EAAgC;CAC9D,MAAM;CACN,OAAO;AACX,CAAC;;;ACXD,SAAO,IAAA;CAAA,OACI,EAAW,CAAkB;AAAC"}
+{"version":3,"file":"index.js","names":["SplitButtonContext","createContext","useSplitButtonContext","useContext"],"sources":["../../../../../src/components/Button/SplitButton/SplitButtonContext/context.ts","../../../../../src/components/Button/SplitButton/SplitButtonContext/useSplitButtonContext.ts"],"sourcesContent":["import { createContext } from \"react\";\nimport type { ButtonSize, SplitButtonColor } from \"../../core\";\n\n/**\n * Context state shared across all components of a {@link SplitButton}.\n */\nexport type SplitButtonState = {\n    /** Whether both primary action and trigger buttons are currently in a pending state. */\n    isPending?: boolean;\n    /** Whether both primary action and trigger buttons are currently disabled. */\n    isDisabled?: boolean;\n\n    /** Uniform size preset for the split button pair. */\n    size: ButtonSize;\n    /** Visual color style variant applied to both split button parts. */\n    color: SplitButtonColor;\n};\n\n/**\n * React Context providing size, color, pending, and disabled state from\n * a parent `SplitButton` container to `SplitButtonPrimary` and `SplitButtonTrigger`.\n */\nexport const SplitButtonContext = createContext<SplitButtonState>({\n    size: \"small\",\n    color: \"filled\",\n});\n","import { useContext } from \"react\";\nimport { SplitButtonContext } from \"./context\";\n\n/**\n * Accesses the enclosing {@link SplitButtonContext} state.\n *\n * @returns The configuration and state provided by the nearest parent `SplitButton`. Defaults to small/filled if unnested.\n */\nexport function useSplitButtonContext() {\n    return useContext(SplitButtonContext);\n}\n"],"mappings":";;AAsBA,IAAaA,IAAqBC,EAAgC;CAC9D,MAAM;CACN,OAAO;AACX,CAAC;;;ACjBD,SAAOC,IAAA;CAAA,OACIC,EAAWH,CAAkB;AAAC"}

package/dist/components/Button/SplitButton/SplitButtonContext/useSplitButtonContext.d.ts

@@ -1 +1,6 @@
+/**
+ * Accesses the enclosing {@link SplitButtonContext} state.
+ *
+ * @returns The configuration and state provided by the nearest parent `SplitButton`. Defaults to small/filled if unnested.
+ */
 export declare function useSplitButtonContext(): import('./context').SplitButtonState;

package/dist/components/Button/SplitButton/SplitButtonPrimary/SplitButtonPrimary.d.ts

@@ -1,2 +1,17 @@
 import { SplitButtonPrimaryProps } from './types';
+/**
+ * The primary action button within a {@link SplitButton}.
+ *
+ * Inherits visual styling (size and color) and states (disabled, pending)
+ * from the parent `SplitButtonContext`.
+ * Extends React Aria's `Button` and supports ripple splash animations, icons,
+ * loading spinner substitution when pending, and tooltips.
+ *
+ * @example
+ * ```tsx
+ * <SplitButtonPrimary icon={Save} onPress={() => handleSave()}>
+ *     Save
+ * </SplitButtonPrimary>
+ * ```
+ */
 export declare const SplitButtonPrimary: React.FC<SplitButtonPrimaryProps>;

package/dist/components/Button/SplitButton/SplitButtonPrimary/index.js

@@ -10,10 +10,10 @@ import { jsx as g, jsxs as _ } from "react/jsx-runtime";
 import { Button as v } from "react-aria-components";
 //#region src/components/Button/SplitButton/SplitButtonPrimary/SplitButtonPrimary.tsx
 var y = ({ tooltip: y, icon: b, children: x, onPress: S, isDisabled: C, isPending: w, className: T, iconPlacement: E = "start", ...D }) => {
-	let O = m(), { splashInfo: k, handlePress: A } = i(S), j = typeof x == "function", M = w || O.isPending;
+	let O = m(), { splashInfo: k, handlePress: A } = i(S), j = typeof x == "function", M = w || O.isPending, N = C || O.isDisabled;
 	return u(/* @__PURE__ */ g(v, {
 		onPress: A,
-		isDisabled: C || O.isDisabled,
+		isDisabled: N,
 		isPending: M,
 		...D,
 		className: (t) => h(s, e, p, d(O.color), typeof T == "function" ? T(t) : T),

package/dist/components/Button/SplitButton/SplitButtonPrimary/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["renderProps","isDisabled"],"sources":["../../../../../src/components/Button/SplitButton/SplitButtonPrimary/SplitButtonPrimary.tsx"],"sourcesContent":["import { clsx } from \"clsx\";\nimport { Button as AriaButton } from \"react-aria-components\";\nimport { Icon } from \"@/components/Icon\";\nimport { Loader } from \"@/components/Loader\";\nimport { Splash } from \"@/components/Splash/Splash\";\nimport { useSplash } from \"@/components/Splash/useSplash\";\nimport { TapTarget } from \"@/utils/tapTarget\";\nimport {\n    ButtonCore,\n    ButtonIconSizeMapping,\n    ButtonLabelTextMapping,\n    ButtonReset,\n    buttonColorBase,\n    buttonColorConfig,\n    withTooltip,\n} from \"../../core\";\nimport { SplitButtonPrimaryBase, SplitButtonVariantBase } from \"../core\";\nimport { useSplitButtonContext } from \"../SplitButtonContext\";\nimport type { SplitButtonPrimaryProps } from \"./types\";\n\nexport const SplitButtonPrimary: React.FC<SplitButtonPrimaryProps> = ({\n    tooltip,\n    icon,\n    children,\n    onPress,\n    isDisabled,\n    isPending,\n    className,\n    iconPlacement = \"start\",\n    ...props\n}) => {\n    const splitButtonState = useSplitButtonContext();\n\n    const { splashInfo, handlePress } = useSplash(onPress);\n    const isChildFunc = typeof children === \"function\";\n\n    const pending = isPending || splitButtonState.isPending;\n    const disabled = isDisabled || splitButtonState.isDisabled;\n\n    return withTooltip(\n        <AriaButton\n            onPress={handlePress}\n            isDisabled={disabled}\n            isPending={pending}\n            {...props}\n            className={(renderProps) =>\n                clsx(\n                    ButtonReset,\n                    TapTarget,\n                    SplitButtonPrimaryBase,\n                    buttonColorConfig(splitButtonState.color),\n                    typeof className === \"function\"\n                        ? className(renderProps)\n                        : className\n                )\n            }\n            data-button\n            data-split-button-primary\n        >\n            {(renderProps) => {\n                const {\n                    isDisabled,\n                    isFocusVisible,\n                    isFocused,\n                    isPressed,\n                    isHovered,\n                } = renderProps;\n\n                const dataAttrs = {\n                    \"data-hovered\": isHovered || undefined,\n                    \"data-disabled\": isDisabled || undefined,\n                    \"data-focused\": isFocused || undefined,\n                    \"data-focus-visible\": isFocusVisible || undefined,\n                    \"data-pressed\": isPressed || undefined,\n                    \"data-visual-button\": true,\n                };\n\n                const iconSize = ButtonIconSizeMapping[splitButtonState.size];\n                const iconComp = renderProps.isPending ? (\n                    <Loader size={iconSize} />\n                ) : (\n                    icon && <Icon icon={icon} size={iconSize} />\n                );\n\n                return (\n                    <span\n                        className={clsx(\n                            ButtonCore,\n                            buttonColorBase,\n                            SplitButtonVariantBase,\n                            ButtonLabelTextMapping[splitButtonState.size]\n                        )}\n                        {...dataAttrs}\n                    >\n                        {splashInfo && <Splash {...splashInfo} />}\n\n                        {iconPlacement === \"start\" && iconComp}\n\n                        {isChildFunc ? children(renderProps) : children}\n\n                        {iconPlacement === \"end\" && iconComp}\n                    </span>\n                );\n            }}\n        </AriaButton>,\n        tooltip\n    );\n};\n"],"mappings":";;;;;;;;;;;AAoBA,IAAa,KAAyD,EAClE,YACA,SACA,aACA,YACA,eACA,cACA,cACA,mBAAgB,SAChB,GAAG,QACD;CACF,IAAM,IAAmB,EAAsB,GAEzC,EAAE,eAAY,mBAAgB,EAAU,CAAO,GAC/C,IAAc,OAAO,KAAa,YAElC,IAAU,KAAa,EAAiB;CAG9C,OAAO,EACH,kBAAC,GAAD;EACI,SAAS;EACT,YALS,KAAc,EAAiB;EAMxC,WAAW;EACX,GAAI;EACJ,YAAY,MACR,EACI,GACA,GACA,GACA,EAAkB,EAAiB,KAAK,GACxC,OAAO,KAAc,aACf,EAAU,CAAW,IACrB,CACV;EAEJ,eAAA;EACA,6BAAA;aAEEA,MAAgB;GACd,IAAM,EACF,YAAAC,GACA,mBACA,cACA,cACA,iBACAD,GAEE,IAAY;IACd,gBAAgB,KAAa,KAAA;IAC7B,iBAAiBC,KAAc,KAAA;IAC/B,gBAAgB,KAAa,KAAA;IAC7B,sBAAsB,KAAkB,KAAA;IACxC,gBAAgB,KAAa,KAAA;IAC7B,sBAAsB;GAC1B,GAEM,IAAW,EAAsB,EAAiB,OAClD,IAAWD,EAAY,YACzB,kBAAC,GAAD,EAAQ,MAAM,EAAS,CAAA,IAEvB,KAAQ,kBAAC,GAAD;IAAY;IAAM,MAAM;GAAS,CAAA;GAG7C,OACI,kBAAC,QAAD;IACI,WAAW,EACP,GACA,GACA,GACA,EAAuB,EAAiB,KAC5C;IACA,GAAI;cAPR;KASK,KAAc,kBAAC,GAAD,EAAQ,GAAI,EAAW,CAAA;KAErC,MAAkB,WAAW;KAE7B,IAAc,EAASA,CAAW,IAAI;KAEtC,MAAkB,SAAS;IAC1B;;EAEd;CACQ,CAAA,GACZ,CACJ;AACJ"}
+{"version":3,"file":"index.js","names":["renderProps","isDisabled","AriaButton","TapTarget","Loader","Splash","useSplash","ButtonCore","ButtonReset","ButtonIconSizeMapping","withTooltip","buttonColorConfig","SplitButtonVariantBase","SplitButtonPrimaryBase","SplitButtonPrimary","props","splitButtonState","useSplitButtonContext","onPress","isChildFunc","children","pending","isPending","disabled","isDisabled","Button","handlePress","clsx","className","renderProps","isDisabled_0","renderProps_0","dataAttrs","isHovered","isFocused","isFocusVisible","isPressed","iconSize","iconComp","icon","Icon","buttonColorBase","ButtonLabelTextMapping","splashInfo","iconPlacement","tooltip"],"sources":["../../../../../src/components/Button/SplitButton/SplitButtonPrimary/SplitButtonPrimary.tsx"],"sourcesContent":["import { clsx } from \"clsx\";\nimport { Button as AriaButton } from \"react-aria-components\";\nimport { Icon } from \"@/components/Icon\";\nimport { Loader } from \"@/components/Loader\";\nimport { Splash } from \"@/components/Splash/Splash\";\nimport { useSplash } from \"@/components/Splash/useSplash\";\nimport { TapTarget } from \"@/utils/tapTarget\";\nimport {\n    ButtonCore,\n    ButtonIconSizeMapping,\n    ButtonLabelTextMapping,\n    ButtonReset,\n    buttonColorBase,\n    buttonColorConfig,\n    withTooltip,\n} from \"../../core\";\nimport { SplitButtonPrimaryBase, SplitButtonVariantBase } from \"../core\";\nimport { useSplitButtonContext } from \"../SplitButtonContext\";\nimport type { SplitButtonPrimaryProps } from \"./types\";\n\n/**\n * The primary action button within a {@link SplitButton}.\n *\n * Inherits visual styling (size and color) and states (disabled, pending)\n * from the parent `SplitButtonContext`.\n * Extends React Aria's `Button` and supports ripple splash animations, icons,\n * loading spinner substitution when pending, and tooltips.\n *\n * @example\n * ```tsx\n * <SplitButtonPrimary icon={Save} onPress={() => handleSave()}>\n *     Save\n * </SplitButtonPrimary>\n * ```\n */\nexport const SplitButtonPrimary: React.FC<SplitButtonPrimaryProps> = ({\n    tooltip,\n    icon,\n    children,\n    onPress,\n    isDisabled,\n    isPending,\n    className,\n    iconPlacement = \"start\",\n    ...props\n}) => {\n    const splitButtonState = useSplitButtonContext();\n\n    const { splashInfo, handlePress } = useSplash(onPress);\n    const isChildFunc = typeof children === \"function\";\n\n    const pending = isPending || splitButtonState.isPending;\n    const disabled = isDisabled || splitButtonState.isDisabled;\n\n    return withTooltip(\n        <AriaButton\n            onPress={handlePress}\n            isDisabled={disabled}\n            isPending={pending}\n            {...props}\n            className={(renderProps) =>\n                clsx(\n                    ButtonReset,\n                    TapTarget,\n                    SplitButtonPrimaryBase,\n                    buttonColorConfig(splitButtonState.color),\n                    typeof className === \"function\"\n                        ? className(renderProps)\n                        : className\n                )\n            }\n            data-button\n            data-split-button-primary\n        >\n            {(renderProps) => {\n                const {\n                    isDisabled,\n                    isFocusVisible,\n                    isFocused,\n                    isPressed,\n                    isHovered,\n                } = renderProps;\n\n                const dataAttrs = {\n                    \"data-hovered\": isHovered || undefined,\n                    \"data-disabled\": isDisabled || undefined,\n                    \"data-focused\": isFocused || undefined,\n                    \"data-focus-visible\": isFocusVisible || undefined,\n                    \"data-pressed\": isPressed || undefined,\n                    \"data-visual-button\": true,\n                };\n\n                const iconSize = ButtonIconSizeMapping[splitButtonState.size];\n                const iconComp = renderProps.isPending ? (\n                    <Loader size={iconSize} />\n                ) : (\n                    icon && <Icon icon={icon} size={iconSize} />\n                );\n\n                return (\n                    <span\n                        className={clsx(\n                            ButtonCore,\n                            buttonColorBase,\n                            SplitButtonVariantBase,\n                            ButtonLabelTextMapping[splitButtonState.size]\n                        )}\n                        {...dataAttrs}\n                    >\n                        {splashInfo && <Splash {...splashInfo} />}\n\n                        {iconPlacement === \"start\" && iconComp}\n\n                        {isChildFunc ? children(renderProps) : children}\n\n                        {iconPlacement === \"end\" && iconComp}\n                    </span>\n                );\n            }}\n        </AriaButton>,\n        tooltip\n    );\n};\n"],"mappings":";;;;;;;;;;;AAmCA,IAAac,KAAyD,EAClE,YACA,SACA,aACA,YACA,eACA,cACA,cACA,mBAAgB,SAChB,GAAGC,QACD;CACF,IAAMC,IAAmBC,EAAsB,GAEzC,EAAE,eAAY,mBAAgBX,EAAUY,CAAO,GAC/CC,IAAc,OAAOC,KAAa,YAElCC,IAAUC,KAAaN,EAAiB,WACxCO,IAAWC,KAAcR,EAAiB;CAEhD,OAAON,EACH,kBAACR,GAAD;EACI,SAASwB;EACT,YAAYH;EACZ,WAAWF;EACX,GAAIN;EACJ,YAAY,MACRY,EACInB,GACAL,GACAU,GACAF,EAAkBK,EAAiB,KAAK,GACxC,OAAOY,KAAc,aACfA,EAAUC,CAAW,IACrBD,CACV;EAEJ,eAAA;EACA,6BAAA;EAEE5B,WAAAA,MAAgB;GACd,IAAM,EACF,YAAAC,GACA,mBACA,cACA,cACA,iBACAD,GAEEgC,IAAY;IACd,gBAAgBC,KAAa,KAAA;IAC7B,iBAAiBhC,KAAc,KAAA;IAC/B,gBAAgBiC,KAAa,KAAA;IAC7B,sBAAsBC,KAAkB,KAAA;IACxC,gBAAgBC,KAAa,KAAA;IAC7B,sBAAsB;GAC1B,GAEMC,IAAW5B,EAAsBO,EAAiB,OAClDsB,IAAWtC,EAAY,YACzB,kBAACI,GAAD,EAAQ,MAAMiC,EAAS,CAAA,IAEvBE,KAAQ,kBAACC,GAAD;IAAY;IAAM,MAAMH;GAAS,CAAA;GAG7C,OACI,kBAAC,QAAD;IACI,WAAWV,EACPpB,GACAkC,GACA7B,GACA8B,EAAuB1B,EAAiB,KAC5C;IACA,GAAIgB;IAPR,UAAA;KASKW,KAAc,kBAACtC,GAAD,EAAQ,GAAIsC,EAAW,CAAA;KAErCC,MAAkB,WAAWN;KAE7BnB,IAAcC,EAASpB,CAAW,IAAIoB;KAEtCwB,MAAkB,SAASN;IAC1B;;EAEd;CACQ,CAAA,GACZO,CACJ;AACJ"}

package/dist/components/Button/SplitButton/SplitButtonPrimary/types.d.ts

@@ -1,7 +1,18 @@
 import { LucideIcon } from 'lucide-react';
 import { Button } from 'react-aria-components';
+/**
+ * Props for the {@link SplitButtonPrimary} component.
+ * Extends React Aria's {@link Button} props with tooltip, icon, and icon placement.
+ */
 export interface SplitButtonPrimaryProps extends React.ComponentPropsWithRef<typeof Button> {
+    /** Optional tooltip text displayed on hover. */
     tooltip?: string;
+    /** An optional icon to display within the button. */
     icon?: LucideIcon;
+    /**
+     * The position of the icon relative to the text.
+     *
+     * @default "start"
+     */
     iconPlacement?: "start" | "end";
 }

package/dist/components/Button/SplitButton/SplitButtonTrigger/SplitButtonTrigger.d.ts

@@ -1,2 +1,21 @@
 import { SplitButtonTriggerProps } from './types';
+/**
+ * The dropdown menu trigger button within a {@link SplitButton}.
+ *
+ * Renders a chevron icon indicating that more actions are available in an adjacent menu.
+ * Inherits visual styling (size and color) and states (disabled, pending) from the parent `SplitButtonContext`.
+ * Typically wrapped inside a `MenuTrigger` component alongside a `MenuPopover`.
+ *
+ * @example
+ * ```tsx
+ * <MenuTrigger>
+ *     <SplitButtonTrigger aria-label="More options" />
+ *     <MenuPopover>
+ *         <Menu>
+ *             <MenuItem label="Export" />
+ *         </Menu>
+ *     </MenuPopover>
+ * </MenuTrigger>
+ * ```
+ */
 export declare const SplitButtonTrigger: React.FC<SplitButtonTriggerProps>;

package/dist/components/Button/SplitButton/SplitButtonTrigger/types.d.ts

@@ -1,4 +1,9 @@
 import { Button } from 'react-aria-components';
+/**
+ * Props for the {@link SplitButtonTrigger} component.
+ * Extends React Aria's {@link Button} props (omitting `children`) with tooltip support.
+ */
 export interface SplitButtonTriggerProps extends Omit<React.ComponentPropsWithRef<typeof Button>, "children"> {
+    /** Optional tooltip text displayed on hover. */
     tooltip?: string;
 }

package/dist/components/Button/SplitButton/core/size.d.ts

@@ -1,6 +1,19 @@
 import { ButtonSize } from '../../core';
+/**
+ * Maps each {@link ButtonSize} preset to its corresponding chevron icon size in pixels
+ * for {@link SplitButtonTrigger}.
+ */
 export declare const SplitButtonTriggerIconSize: Record<ButtonSize, number>;
+/**
+ * Resolves the CSS module class name for a given split button size preset.
+ *
+ * @param size - The button size preset.
+ * @returns The CSS module class name for the split button container size.
+ */
 export declare const splitButtonSizeConfig: (size: ButtonSize) => string;
+/** Base CSS module class name for split button container sizing. */
 export declare const SplitButtonVariantBase: string;
+/** Base CSS module class name for the primary action button part of a split button. */
 export declare const SplitButtonPrimaryBase: string;
+/** Base CSS module class name for the menu trigger button part of a split button. */
 export declare const SplitButtonTriggerBase: string;

package/dist/components/Button/ToggleButton/ToggleButton.d.ts

@@ -1,2 +1,23 @@
 import { ToggleButtonProps } from './types';
+/**
+ * A two-state toggle button implementing Material Design 3 Toggle Button guidelines.
+ *
+ * Allows users to toggle between active/selected and inactive/unselected states.
+ * Supports swapping between `icon` and `selectedIcon` based on current selection state,
+ * flexible sizing, shapes, and Material 3 toggle button color variants.
+ *
+ * Built on top of React Aria's `ToggleButton`.
+ *
+ * @example
+ * ```tsx
+ * <ToggleButton
+ *     icon={Bookmark}
+ *     selectedIcon={BookmarkCheck}
+ *     isSelected={isBookmarked}
+ *     onChange={setIsBookmarked}
+ * >
+ *     Bookmark
+ * </ToggleButton>
+ * ```
+ */
 export declare const ToggleButton: React.FC<ToggleButtonProps>;

package/dist/components/Button/ToggleButton/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["renderProps","iconToRender","iconSize","handlePress"],"sources":["../../../../src/components/Button/ToggleButton/ToggleButton.tsx"],"sourcesContent":["import { clsx } from \"clsx\";\nimport { ToggleButton as AriaToggleButton } from \"react-aria-components\";\nimport { Icon } from \"@/components/Icon\";\nimport { Splash } from \"@/components/Splash/Splash\";\nimport { useSplash } from \"@/components/Splash/useSplash\";\nimport { TapTarget } from \"@/utils/tapTarget\";\nimport {\n    ButtonCore,\n    ButtonIconSizeMapping,\n    ButtonLabelTextMapping,\n    ButtonReset,\n    ButtonSizeBase,\n    buttonColorBase,\n    buttonColorConfig,\n    buttonSizeConfig,\n    newButtonBaseDataAttrs,\n    useButtonConfig,\n    withTooltip,\n} from \"../core\";\nimport type { ToggleButtonProps } from \"./types\";\n\nexport const ToggleButton: React.FC<ToggleButtonProps> = ({\n    size,\n    shape,\n    color,\n    tooltip,\n    selectedIcon,\n    icon,\n    children,\n    onPress,\n    className,\n    iconPlacement,\n    ...props\n}) => {\n    const { buttonColor, buttonShape, buttonSize, buttonIconPlacement } =\n        useButtonConfig({\n            size,\n            shape,\n            color,\n            iconPlacement,\n        });\n\n    const { splashInfo, handlePress } = useSplash(onPress);\n    const isChildFunc = typeof children === \"function\";\n\n    const baseButtonDataAttrs = newButtonBaseDataAttrs({\n        shape: buttonShape,\n        size: buttonSize,\n        color: buttonColor,\n    });\n\n    const toggleButtonDataAttrs = {\n        ...baseButtonDataAttrs,\n        \"data-toggle-button\": true,\n    };\n\n    return withTooltip(\n        <AriaToggleButton\n            onPress={handlePress}\n            className={(renderProps) =>\n                clsx(\n                    ButtonReset,\n                    TapTarget,\n                    buttonSizeConfig(buttonSize),\n                    buttonColorConfig(buttonColor),\n                    typeof className === \"function\"\n                        ? className(renderProps)\n                        : className\n                )\n            }\n            {...props}\n            {...toggleButtonDataAttrs}\n            data-button\n        >\n            {(renderProps) => {\n                const {\n                    isSelected,\n                    isDisabled,\n                    isFocusVisible,\n                    isFocused,\n                    isPressed,\n                    isHovered,\n                } = renderProps;\n\n                const dataAttrs = {\n                    ...toggleButtonDataAttrs,\n                    \"data-hovered\": isHovered || undefined,\n                    \"data-disabled\": isDisabled || undefined,\n                    \"data-focused\": isFocused || undefined,\n                    \"data-focus-visible\": isFocusVisible || undefined,\n                    \"data-pressed\": isPressed || undefined,\n                    \"data-selected\": isSelected || undefined,\n                    \"data-visual-button\": true,\n                };\n\n                let iconToRender = icon;\n                if (isSelected && selectedIcon) iconToRender = selectedIcon;\n\n                const iconSize = ButtonIconSizeMapping[buttonSize];\n\n                const iconComp = iconToRender && (\n                    <Icon icon={iconToRender} size={iconSize} />\n                );\n\n                return (\n                    <span\n                        className={clsx(\n                            ButtonCore,\n                            buttonColorBase,\n                            ButtonSizeBase,\n                            ButtonLabelTextMapping[buttonSize]\n                        )}\n                        {...dataAttrs}\n                    >\n                        {splashInfo && <Splash {...splashInfo} />}\n\n                        {buttonIconPlacement === \"start\" && iconComp}\n\n                        {isChildFunc ? children(renderProps) : children}\n\n                        {buttonIconPlacement === \"end\" && iconComp}\n                    </span>\n                );\n            }}\n        </AriaToggleButton>,\n        tooltip\n    );\n};\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":["renderProps","iconToRender","iconSize","handlePress","_c","AriaToggleButton","require_compiler_runtime","Icon","Splash","useSplash","buttonSizeConfig","ButtonCore","ButtonReset","ButtonIconSizeMapping","buttonColorBase","useButtonConfig","ButtonSizeBase","withTooltip","buttonColorConfig","ToggleButton$1","import_compiler_runtime","ToggleButton","$","children","className","color","icon","iconPlacement","onPress","props","selectedIcon","shape","size","tooltip","t0","t1","isChildFunc","t2","buttonColor","buttonShape","buttonSize","newButtonBaseDataAttrs","baseButtonDataAttrs","t3","toggleButtonDataAttrs","t4","clsx","TapTarget","renderProps","t5","buttonIconPlacement","splashInfo","renderProps_0","dataAttrs","isHovered","isDisabled","isFocused","isFocusVisible","isPressed","isSelected","iconToRender","iconSize","iconComp","ButtonLabelTextMapping","t6","handlePress","t7"],"sources":["../../../../src/components/Button/ToggleButton/ToggleButton.tsx"],"sourcesContent":["import { clsx } from \"clsx\";\nimport { ToggleButton as AriaToggleButton } from \"react-aria-components\";\nimport { Icon } from \"@/components/Icon\";\nimport { Splash } from \"@/components/Splash/Splash\";\nimport { useSplash } from \"@/components/Splash/useSplash\";\nimport { TapTarget } from \"@/utils/tapTarget\";\nimport {\n    ButtonCore,\n    ButtonIconSizeMapping,\n    ButtonLabelTextMapping,\n    ButtonReset,\n    ButtonSizeBase,\n    buttonColorBase,\n    buttonColorConfig,\n    buttonSizeConfig,\n    newButtonBaseDataAttrs,\n    useButtonConfig,\n    withTooltip,\n} from \"../core\";\nimport type { ToggleButtonProps } from \"./types\";\n\n/**\n * A two-state toggle button implementing Material Design 3 Toggle Button guidelines.\n *\n * Allows users to toggle between active/selected and inactive/unselected states.\n * Supports swapping between `icon` and `selectedIcon` based on current selection state,\n * flexible sizing, shapes, and Material 3 toggle button color variants.\n *\n * Built on top of React Aria's `ToggleButton`.\n *\n * @example\n * ```tsx\n * <ToggleButton\n *     icon={Bookmark}\n *     selectedIcon={BookmarkCheck}\n *     isSelected={isBookmarked}\n *     onChange={setIsBookmarked}\n * >\n *     Bookmark\n * </ToggleButton>\n * ```\n */\nexport const ToggleButton: React.FC<ToggleButtonProps> = ({\n    size,\n    shape,\n    color,\n    tooltip,\n    selectedIcon,\n    icon,\n    children,\n    onPress,\n    className,\n    iconPlacement,\n    ...props\n}) => {\n    const { buttonColor, buttonShape, buttonSize, buttonIconPlacement } =\n        useButtonConfig({\n            size,\n            shape,\n            color,\n            iconPlacement,\n        });\n\n    const { splashInfo, handlePress } = useSplash(onPress);\n    const isChildFunc = typeof children === \"function\";\n\n    const baseButtonDataAttrs = newButtonBaseDataAttrs({\n        shape: buttonShape,\n        size: buttonSize,\n        color: buttonColor,\n    });\n\n    const toggleButtonDataAttrs = {\n        ...baseButtonDataAttrs,\n        \"data-toggle-button\": true,\n    };\n\n    return withTooltip(\n        <AriaToggleButton\n            onPress={handlePress}\n            className={(renderProps) =>\n                clsx(\n                    ButtonReset,\n                    TapTarget,\n                    buttonSizeConfig(buttonSize),\n                    buttonColorConfig(buttonColor),\n                    typeof className === \"function\"\n                        ? className(renderProps)\n                        : className\n                )\n            }\n            {...props}\n            {...toggleButtonDataAttrs}\n            data-button\n        >\n            {(renderProps) => {\n                const {\n                    isSelected,\n                    isDisabled,\n                    isFocusVisible,\n                    isFocused,\n                    isPressed,\n                    isHovered,\n                } = renderProps;\n\n                const dataAttrs = {\n                    ...toggleButtonDataAttrs,\n                    \"data-hovered\": isHovered || undefined,\n                    \"data-disabled\": isDisabled || undefined,\n                    \"data-focused\": isFocused || undefined,\n                    \"data-focus-visible\": isFocusVisible || undefined,\n                    \"data-pressed\": isPressed || undefined,\n                    \"data-selected\": isSelected || undefined,\n                    \"data-visual-button\": true,\n                };\n\n                let iconToRender = icon;\n                if (isSelected && selectedIcon) iconToRender = selectedIcon;\n\n                const iconSize = ButtonIconSizeMapping[buttonSize];\n\n                const iconComp = iconToRender && (\n                    <Icon icon={iconToRender} size={iconSize} />\n                );\n\n                return (\n                    <span\n                        className={clsx(\n                            ButtonCore,\n                            buttonColorBase,\n                            ButtonSizeBase,\n                            ButtonLabelTextMapping[buttonSize]\n                        )}\n                        {...dataAttrs}\n                    >\n                        {splashInfo && <Splash {...splashInfo} />}\n\n                        {buttonIconPlacement === \"start\" && iconComp}\n\n                        {isChildFunc ? children(renderProps) : children}\n\n                        {buttonIconPlacement === \"end\" && iconComp}\n                    </span>\n                );\n            }}\n        </AriaToggleButton>,\n        tooltip\n    );\n};\n"],"mappings":"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"}

package/dist/components/Button/ToggleButton/types.d.ts

@@ -1,7 +1,21 @@
 import { LucideIcon } from 'lucide-react';
 import { ToggleButton } from 'react-aria-components';
 import { ButtonBaseProps, ToggleButtonColor } from '../core';
+/**
+ * Props for the {@link ToggleButton} component.
+ * Extends React Aria's {@link ToggleButton} props with customized color options and toggle state icon support.
+ */
 export interface ToggleButtonProps extends React.ComponentPropsWithRef<typeof ToggleButton>, Omit<ButtonBaseProps, "color"> {
+    /**
+     * Optional icon to render when the toggle button is in the selected (`isSelected = true`) state.
+     * If omitted, {@link ButtonBaseProps.icon} is used for both selected and unselected states.
+     */
     selectedIcon?: LucideIcon;
+    /**
+     * Visual color style variant for the toggle button.
+     * Note: Does not include `"text"` since toggle buttons require visual container state changes.
+     *
+     * @default "filled"
+     */
     color?: ToggleButtonColor;
 }

package/dist/components/Button/ToggleIconButton/ToggleIconButton.d.ts

@@ -1,2 +1,23 @@
 import { ToggleIconButtonProps } from './types';
+/**
+ * A compact, icon-only toggle button implementing Material Design 3 Toggle Icon Buttons.
+ *
+ * Allows users to toggle between two states using a single icon button (e.g. mute/unmute, bookmark/unbookmark).
+ * Switches between `icon` and `selectedIcon` based on the current selection state.
+ *
+ * Built on top of React Aria's `ToggleButton`. Always provide an accessible `aria-label`
+ * or `aria-labelledby` attribute for screen reader accessibility.
+ *
+ * @example
+ * ```tsx
+ * <ToggleIconButton
+ *     icon={Volume2}
+ *     selectedIcon={VolumeX}
+ *     isSelected={isMuted}
+ *     onChange={setIsMuted}
+ *     tooltip={isMuted ? "Unmute" : "Mute"}
+ *     aria-label={isMuted ? "Unmute" : "Mute"}
+ * />
+ * ```
+ */
 export declare const ToggleIconButton: React.FC<ToggleIconButtonProps>;

package/dist/components/Button/ToggleIconButton/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../../src/components/Button/ToggleIconButton/ToggleIconButton.tsx"],"sourcesContent":["import { clsx } from \"clsx\";\nimport { ToggleButton as AriaToggleButton } from \"react-aria-components\";\nimport { Icon } from \"@/components/Icon\";\nimport { Splash } from \"@/components/Splash/Splash\";\nimport { useSplash } from \"@/components/Splash/useSplash\";\nimport { TapTarget } from \"@/utils/tapTarget\";\nimport {\n    ButtonCore,\n    ButtonReset,\n    ButtonSizeBase,\n    buttonColorBase,\n    buttonColorConfig,\n    buttonSizeConfig,\n    IconButtonIconSizeMapping,\n    newButtonBaseDataAttrs,\n    useButtonConfig,\n    withTooltip,\n} from \"../core\";\nimport type { ToggleIconButtonProps } from \"./types\";\n\nexport const ToggleIconButton: React.FC<ToggleIconButtonProps> = ({\n    size,\n    shape,\n    color,\n    width = \"default\",\n    tooltip,\n    selectedIcon,\n    icon,\n    onPress,\n    className,\n    ...props\n}) => {\n    const { buttonColor, buttonShape, buttonSize } = useButtonConfig({\n        size,\n        shape,\n        color,\n    });\n\n    const { splashInfo, handlePress } = useSplash(onPress);\n\n    const baseButtonDataAttrs = newButtonBaseDataAttrs({\n        shape: buttonShape,\n        size: buttonSize,\n        color: buttonColor,\n    });\n\n    const iconButtonDataAttrs = {\n        ...baseButtonDataAttrs,\n        \"data-width\": width,\n        \"data-icon-button\": true,\n        \"data-toggle-button\": true,\n    };\n\n    return withTooltip(\n        <AriaToggleButton\n            onPress={handlePress}\n            className={(renderProps) =>\n                clsx(\n                    ButtonReset,\n                    TapTarget,\n                    buttonSizeConfig(buttonSize),\n                    buttonColorConfig(buttonColor),\n                    typeof className === \"function\"\n                        ? className(renderProps)\n                        : className\n                )\n            }\n            {...props}\n            {...iconButtonDataAttrs}\n            data-button\n        >\n            {({\n                isSelected,\n                isDisabled,\n                isFocusVisible,\n                isFocused,\n                isPressed,\n                isHovered,\n            }) => {\n                const dataAttrs = {\n                    ...iconButtonDataAttrs,\n                    \"data-hovered\": isHovered || undefined,\n                    \"data-disabled\": isDisabled || undefined,\n                    \"data-focused\": isFocused || undefined,\n                    \"data-focus-visible\": isFocusVisible || undefined,\n                    \"data-pressed\": isPressed || undefined,\n                    \"data-selected\": isSelected || undefined,\n                    \"data-visual-button\": true,\n                };\n\n                let iconToRender = icon;\n                if (isSelected && selectedIcon) iconToRender = selectedIcon;\n\n                const iconSize = IconButtonIconSizeMapping[buttonSize];\n                return (\n                    <span\n                        className={clsx(\n                            ButtonCore,\n                            buttonColorBase,\n                            ButtonSizeBase\n                        )}\n                        {...dataAttrs}\n                    >\n                        {splashInfo && <Splash {...splashInfo} />}\n\n                        {iconToRender && (\n                            <Icon icon={iconToRender} size={iconSize} />\n                        )}\n                    </span>\n                );\n            }}\n        </AriaToggleButton>,\n        tooltip\n    );\n};\n"],"mappings":";;;;;;;;AAoBA,IAAa,KAAqD,EAC9D,SACA,UACA,UACA,WAAQ,WACR,YACA,iBACA,SACA,YACA,cACA,GAAG,QACD;CACF,IAAM,EAAE,gBAAa,gBAAa,kBAAe,EAAgB;EAC7D;EACA;EACA;CACJ,CAAC,GAEK,EAAE,eAAY,mBAAgB,EAAU,CAAO,GAQ/C,IAAsB;EACxB,GAPwB,EAAuB;GAC/C,OAAO;GACP,MAAM;GACN,OAAO;EACX,CAGO;EACH,cAAc;EACd,oBAAoB;EACpB,sBAAsB;CAC1B;CAEA,OAAO,EACH,kBAAC,GAAD;EACI,SAAS;EACT,YAAY,MACR,EACI,GACA,GACA,EAAiB,CAAU,GAC3B,EAAkB,CAAW,GAC7B,OAAO,KAAc,aACf,EAAU,CAAW,IACrB,CACV;EAEJ,GAAI;EACJ,GAAI;EACJ,eAAA;aAEE,EACE,eACA,eACA,mBACA,cACA,cACA,mBACE;GACF,IAAM,IAAY;IACd,GAAG;IACH,gBAAgB,KAAa,KAAA;IAC7B,iBAAiB,KAAc,KAAA;IAC/B,gBAAgB,KAAa,KAAA;IAC7B,sBAAsB,KAAkB,KAAA;IACxC,gBAAgB,KAAa,KAAA;IAC7B,iBAAiB,KAAc,KAAA;IAC/B,sBAAsB;GAC1B,GAEI,IAAe;GACnB,AAAI,KAAc,MAAc,IAAe;GAE/C,IAAM,IAAW,EAA0B;GAC3C,OACI,kBAAC,QAAD;IACI,WAAW,EACP,GACA,GACA,CACJ;IACA,GAAI;cANR,CAQK,KAAc,kBAAC,GAAD,EAAQ,GAAI,EAAW,CAAA,GAErC,KACG,kBAAC,GAAD;KAAM,MAAM;KAAc,MAAM;IAAS,CAAA,CAE3C;;EAEd;CACc,CAAA,GAClB,CACJ;AACJ"}
+{"version":3,"file":"index.js","names":["AriaToggleButton","TapTarget","useSplash","buttonSizeConfig","ButtonCore","ButtonReset","buttonColorBase","useButtonConfig","ButtonSizeBase","newButtonBaseDataAttrs","IconButtonIconSizeMapping","withTooltip","buttonColorConfig","ToggleIconButton","props","onPress","iconButtonDataAttrs","buttonShape","buttonSize","buttonColor","width","ToggleButton","handlePress","clsx","className","renderProps","dataAttrs","isHovered","isDisabled","isFocused","isFocusVisible","isPressed","isSelected","iconToRender","icon","selectedIcon","iconSize","splashInfo","Splash","Icon","tooltip"],"sources":["../../../../src/components/Button/ToggleIconButton/ToggleIconButton.tsx"],"sourcesContent":["import { clsx } from \"clsx\";\nimport { ToggleButton as AriaToggleButton } from \"react-aria-components\";\nimport { Icon } from \"@/components/Icon\";\nimport { Splash } from \"@/components/Splash/Splash\";\nimport { useSplash } from \"@/components/Splash/useSplash\";\nimport { TapTarget } from \"@/utils/tapTarget\";\nimport {\n    ButtonCore,\n    ButtonReset,\n    ButtonSizeBase,\n    buttonColorBase,\n    buttonColorConfig,\n    buttonSizeConfig,\n    IconButtonIconSizeMapping,\n    newButtonBaseDataAttrs,\n    useButtonConfig,\n    withTooltip,\n} from \"../core\";\nimport type { ToggleIconButtonProps } from \"./types\";\n\n/**\n * A compact, icon-only toggle button implementing Material Design 3 Toggle Icon Buttons.\n *\n * Allows users to toggle between two states using a single icon button (e.g. mute/unmute, bookmark/unbookmark).\n * Switches between `icon` and `selectedIcon` based on the current selection state.\n *\n * Built on top of React Aria's `ToggleButton`. Always provide an accessible `aria-label`\n * or `aria-labelledby` attribute for screen reader accessibility.\n *\n * @example\n * ```tsx\n * <ToggleIconButton\n *     icon={Volume2}\n *     selectedIcon={VolumeX}\n *     isSelected={isMuted}\n *     onChange={setIsMuted}\n *     tooltip={isMuted ? \"Unmute\" : \"Mute\"}\n *     aria-label={isMuted ? \"Unmute\" : \"Mute\"}\n * />\n * ```\n */\nexport const ToggleIconButton: React.FC<ToggleIconButtonProps> = ({\n    size,\n    shape,\n    color,\n    width = \"default\",\n    tooltip,\n    selectedIcon,\n    icon,\n    onPress,\n    className,\n    ...props\n}) => {\n    const { buttonColor, buttonShape, buttonSize } = useButtonConfig({\n        size,\n        shape,\n        color,\n    });\n\n    const { splashInfo, handlePress } = useSplash(onPress);\n\n    const baseButtonDataAttrs = newButtonBaseDataAttrs({\n        shape: buttonShape,\n        size: buttonSize,\n        color: buttonColor,\n    });\n\n    const iconButtonDataAttrs = {\n        ...baseButtonDataAttrs,\n        \"data-width\": width,\n        \"data-icon-button\": true,\n        \"data-toggle-button\": true,\n    };\n\n    return withTooltip(\n        <AriaToggleButton\n            onPress={handlePress}\n            className={(renderProps) =>\n                clsx(\n                    ButtonReset,\n                    TapTarget,\n                    buttonSizeConfig(buttonSize),\n                    buttonColorConfig(buttonColor),\n                    typeof className === \"function\"\n                        ? className(renderProps)\n                        : className\n                )\n            }\n            {...props}\n            {...iconButtonDataAttrs}\n            data-button\n        >\n            {({\n                isSelected,\n                isDisabled,\n                isFocusVisible,\n                isFocused,\n                isPressed,\n                isHovered,\n            }) => {\n                const dataAttrs = {\n                    ...iconButtonDataAttrs,\n                    \"data-hovered\": isHovered || undefined,\n                    \"data-disabled\": isDisabled || undefined,\n                    \"data-focused\": isFocused || undefined,\n                    \"data-focus-visible\": isFocusVisible || undefined,\n                    \"data-pressed\": isPressed || undefined,\n                    \"data-selected\": isSelected || undefined,\n                    \"data-visual-button\": true,\n                };\n\n                let iconToRender = icon;\n                if (isSelected && selectedIcon) iconToRender = selectedIcon;\n\n                const iconSize = IconButtonIconSizeMapping[buttonSize];\n                return (\n                    <span\n                        className={clsx(\n                            ButtonCore,\n                            buttonColorBase,\n                            ButtonSizeBase\n                        )}\n                        {...dataAttrs}\n                    >\n                        {splashInfo && <Splash {...splashInfo} />}\n\n                        {iconToRender && (\n                            <Icon icon={iconToRender} size={iconSize} />\n                        )}\n                    </span>\n                );\n            }}\n        </AriaToggleButton>,\n        tooltip\n    );\n};\n"],"mappings":";;;;;;;;AAyCA,IAAaa,KAAqD,EAC9D,SACA,UACA,UACA,WAAQ,WACR,YACA,iBACA,SACA,YACA,cACA,GAAGC,QACD;CACF,IAAM,EAAE,gBAAa,gBAAa,kBAAeP,EAAgB;EAC7D;EACA;EACA;CACJ,CAAC,GAEK,EAAE,eAAY,mBAAgBL,EAAUa,CAAO,GAQ/CC,IAAsB;EACxB,GAPwBP,EAAuB;GAC/C,OAAOQ;GACP,MAAMC;GACN,OAAOC;EACX,CAGO;EACH,cAAcC;EACd,oBAAoB;EACpB,sBAAsB;CAC1B;CAEA,OAAOT,EACH,kBAACX,GAAD;EACI,SAASsB;EACT,YAAY,MACRC,EACIlB,GACAJ,GACAE,EAAiBe,CAAU,GAC3BN,EAAkBO,CAAW,GAC7B,OAAOK,KAAc,aACfA,EAAUC,CAAW,IACrBD,CACV;EAEJ,GAAIV;EACJ,GAAIE;EACJ,eAAA;EAEE,WAAA,EACE,eACA,eACA,mBACA,cACA,cACA,mBACE;GACF,IAAMU,IAAY;IACd,GAAGV;IACH,gBAAgBW,KAAa,KAAA;IAC7B,iBAAiBC,KAAc,KAAA;IAC/B,gBAAgBC,KAAa,KAAA;IAC7B,sBAAsBC,KAAkB,KAAA;IACxC,gBAAgBC,KAAa,KAAA;IAC7B,iBAAiBC,KAAc,KAAA;IAC/B,sBAAsB;GAC1B,GAEIC,IAAeC;GACnB,AAAIF,KAAcG,MAAc,IAAeA;GAE/C,IAAMC,IAAW1B,EAA0BQ;GAC3C,OACI,kBAAC,QAAD;IACI,WAAWK,EACPnB,GACAE,GACAE,CACJ;IACA,GAAIkB;IANR,UAAA,CAQKW,KAAc,kBAACC,GAAD,EAAQ,GAAID,EAAW,CAAA,GAErCJ,KACG,kBAACM,GAAD;KAAM,MAAMN;KAAc,MAAMG;IAAS,CAAA,CAE3C;;EAEd;CACc,CAAA,GAClBI,CACJ;AACJ"}

package/dist/components/Button/ToggleIconButton/types.d.ts

@@ -1,6 +1,15 @@
 import { LucideIcon } from 'lucide-react';
 import { ToggleButton } from 'react-aria-components';
 import { IconButtonBaseProps } from '../core';
+/**
+ * Props for the {@link ToggleIconButton} component.
+ * Extends React Aria's {@link ToggleButton} props (omitting `children`) with {@link IconButtonBaseProps}
+ * and support for a distinct icon in the selected state.
+ */
 export interface ToggleIconButtonProps extends Omit<React.ComponentPropsWithRef<typeof ToggleButton>, "children">, IconButtonBaseProps {
+    /**
+     * Optional icon to render when the toggle button is in the selected (`isSelected = true`) state.
+     * If omitted, {@link IconButtonBaseProps.icon} is used for both selected and unselected states.
+     */
     selectedIcon?: LucideIcon;
 }

package/dist/components/Button/core/button.d.ts

@@ -3,25 +3,58 @@ import { AllButtonColor, ButtonColor, IconButtonColor } from './color';
 import { ButtonShape } from './shape';
 import { ButtonSize } from './sizes';
 import { IconButtonWidth } from './width';
+/**
+ * Determines whether an icon inside a button is rendered before or after the text label.
+ *
+ * - `"start"`: Renders icon at the leading edge (before text).
+ * - `"end"`: Renders icon at the trailing edge (after text).
+ */
 export type ButtonIconPlacement = "start" | "end";
+/**
+ * Core props shared across standard text/label button components (e.g. `Button`, `LinkButton`).
+ */
 export interface ButtonBaseProps {
+    /** Visual style and color scheme of the button. Defaults to `"filled"`. */
     color?: ButtonColor;
+    /** Size scale of the button. Defaults to `"small"`. */
     size?: ButtonSize;
+    /** Corner rounding style (`"round"` or `"square"`). Defaults to `"round"`. */
     shape?: ButtonShape;
+    /** Optional tooltip text displayed on hover/focus. */
     tooltip?: string;
+    /** Optional Lucide icon component displayed alongside label text. */
     icon?: LucideIcon;
+    /** Icon placement relative to label text (`"start"` or `"end"`). Defaults to `"start"`. */
     iconPlacement?: ButtonIconPlacement;
 }
+/**
+ * Core props shared across icon-only button components (e.g. `IconButton`, `LinkIconButton`).
+ */
 export interface IconButtonBaseProps {
+    /** Visual style and color scheme of the icon button. Defaults to `"standard"`. */
     color?: IconButtonColor;
+    /** Size scale of the icon button. Defaults to `"small"`. */
     size?: ButtonSize;
+    /** Corner rounding style (`"round"` or `"square"`). Defaults to `"round"`. */
     shape?: ButtonShape;
+    /** Width variation (`"narrow"`, `"default"`, or `"wide"`). Defaults to `"default"`. */
     width?: IconButtonWidth;
+    /** Optional tooltip text displayed on hover/focus. */
     tooltip?: string;
+    /** Required Lucide icon component rendered inside the button. */
     icon: LucideIcon;
 }
+/** CSS class resetting default button/link styling (outlines, borders, backgrounds). */
 export declare const ButtonReset: string;
+/** CSS class providing the core layout and flex alignment for button internals. */
 export declare const ButtonCore: string;
+/**
+ * Generates standard data attributes (`data-shape`, `data-size`, `data-color`)
+ * applied to button DOM nodes for CSS attribute styling.
+ *
+ * @param options - Shape, size, and color configuration.
+ * @returns Object with data attributes for spreading onto elements.
+ */
 export declare function newButtonBaseDataAttrs({ shape, size, color, }: {
     shape: ButtonShape;
     color: AllButtonColor;