@bitrise/bitkit-v2 0.3.220 → 0.3.222

package/AGENTS.md

@@ -91,6 +91,21 @@ Bitkit components use consistent prop names across the library:
   <BitkitButton icon={IconCheck}>Save</BitkitButton>
   <BitkitAccordion.ItemTrigger suffix={<Badge>3</Badge>}>Files</BitkitAccordion.ItemTrigger>
   ```
+- **Buttons can render as links** — `BitkitButton`, `BitkitIconButton`, and `BitkitControlButton` render an `<a>` when `href` is passed. The button-recipe styles apply to the anchor. Pass `isExternal` to auto-add `target="_blank" rel="noreferrer noopener"`. For routing libraries (Next.js, React Router), use `asChild` with your own anchor element:
+  ```tsx
+  <BitkitButton href="/internal">Internal link</BitkitButton>
+  <BitkitButton href="https://example.com" isExternal>External</BitkitButton>
+  <BitkitButton asChild icon={IconCheck}>
+    <NextLink href="/route">Routed</NextLink>
+  </BitkitButton>
+  ```
+  `state="loading"` is button-only — not valid in anchor mode.
+- **`BitkitLink` external convenience** — `BitkitLink` accepts `isExternal` for the same auto target+rel behavior.
+- **`BitkitActionMenu.Item` as a link** — pass `href` to make a menu item render as an anchor; `target`, `rel`, and `isExternal` work the same way as on the button family. Without `href` it stays a normal menu item:
+  ```tsx
+  <BitkitActionMenu.Item href="/settings" value="settings">Settings</BitkitActionMenu.Item>
+  <BitkitActionMenu.Item href="https://example.com" isExternal value="docs">Open docs</BitkitActionMenu.Item>
+  ```
 - **Form components are flat** — `BitkitTextInput`, `BitkitSelect`, `BitkitCombobox`, etc. expose `label`, `errorText`, `helperText`, etc. directly as props. No need to wrap in a separate field component.
 - **`BitkitDialog` non-dismissible + post-close callback** — pass `closable={false}` to make the dialog fully non-dismissible: the close button is rendered but disabled (kept for layout consistency), ESC is blocked, and outside clicks are ignored. The only way out is an explicit footer action. Pass `onExitComplete` to run code after the close animation finishes (navigation, focus restoration, cleanup):
   ```tsx

package/dist/components/BitkitActionMenu/BitkitActionMenu.d.ts

@@ -5,11 +5,24 @@ interface BitkitMenuRootProps extends Omit<MenuRootProps, 'children'> {
     trigger: ReactNode;
     children?: ReactNode;
 }
-export interface BitkitMenuItemProps extends MenuItemProps {
+interface BitkitMenuItemCommonProps extends MenuItemProps {
     danger?: boolean;
-    secondaryText?: ReactNode;
     icon?: BitkitIconComponent;
+    secondaryText?: ReactNode;
+}
+interface BitkitMenuItemAsButtonProps extends BitkitMenuItemCommonProps {
+    href?: undefined;
+    isExternal?: undefined;
+    rel?: undefined;
+    target?: undefined;
+}
+interface BitkitMenuItemAsAnchorProps extends BitkitMenuItemCommonProps {
+    href: string;
+    isExternal?: boolean;
+    rel?: string;
+    target?: string;
 }
+export type BitkitMenuItemProps = BitkitMenuItemAsButtonProps | BitkitMenuItemAsAnchorProps;
 export interface BitkitMenuGroupProps extends MenuItemGroupProps {
     label: ReactNode;
 }
@@ -22,7 +35,7 @@ declare const BitkitActionMenu: {
         (): import("react/jsx-runtime").JSX.Element;
         displayName: string;
     };
-    Item: import('react').ForwardRefExoticComponent<BitkitMenuItemProps & import('react').RefAttributes<HTMLDivElement>>;
+    Item: import('react').ForwardRefExoticComponent<BitkitMenuItemProps & import('react').RefAttributes<HTMLElement>>;
     Group: import('react').ForwardRefExoticComponent<BitkitMenuGroupProps & import('react').RefAttributes<HTMLDivElement>>;
 };
 export default BitkitActionMenu;

package/dist/components/BitkitActionMenu/BitkitActionMenu.js

@@ -1,7 +1,7 @@
 import { Box } from "@chakra-ui/react/box";
 import { Text } from "@chakra-ui/react/text";
 import { createContext, forwardRef, useContext } from "react";
-import { jsx, jsxs } from "react/jsx-runtime";
+import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
 import { Portal } from "@chakra-ui/react/portal";
 import { Menu, useMenuStyles } from "@chakra-ui/react/menu";
 import { Separator } from "@chakra-ui/react/separator";
@@ -20,20 +20,40 @@ var Root = ({ trigger, children, ...props }) => {
 	});
 };
 Root.displayName = "BitkitActionMenu.Root";
-var Item = forwardRef(({ danger, secondaryText, icon: Icon, children, ...props }, ref) => {
+var Item = forwardRef((props, ref) => {
+	const { children, danger, icon: Icon, secondaryText } = props;
 	const style = useMenuStyles();
 	const menuCtx = useContext(BitkitMenuContext);
-	return /* @__PURE__ */ jsxs(Menu.Item, {
+	const content = /* @__PURE__ */ jsxs(Fragment$1, { children: [Icon && /* @__PURE__ */ jsx(Icon, { size: menuCtx === "lg" ? "24" : "16" }), /* @__PURE__ */ jsxs(Box, {
+		flex: "1",
+		children: [/* @__PURE__ */ jsx(Text, { children }), secondaryText && /* @__PURE__ */ jsx(Text, {
+			css: style.itemHelper,
+			children: secondaryText
+		})]
+	})] });
+	if (props.href !== void 0) {
+		const { children: _children, danger: _danger, href, icon: _icon, isExternal, rel, secondaryText: _secondaryText, target, ...rest } = props;
+		const effectiveTarget = isExternal ? "_blank" : target;
+		const effectiveRel = isExternal ? rel ? `${rel} noreferrer noopener` : "noreferrer noopener" : rel;
+		return /* @__PURE__ */ jsx(Menu.Item, {
+			asChild: true,
+			"data-danger": danger,
+			...rest,
+			children: /* @__PURE__ */ jsx("a", {
+				ref,
+				href,
+				rel: effectiveRel,
+				target: effectiveTarget,
+				children: content
+			})
+		});
+	}
+	const { children: _children, danger: _danger, icon: _icon, secondaryText: _secondaryText, ...rest } = props;
+	return /* @__PURE__ */ jsx(Menu.Item, {
 		"data-danger": danger,
 		ref,
-		...props,
-		children: [Icon && /* @__PURE__ */ jsx(Icon, { size: menuCtx === "lg" ? "24" : "16" }), /* @__PURE__ */ jsxs(Box, {
-			flex: "1",
-			children: [/* @__PURE__ */ jsx(Text, { children }), secondaryText && /* @__PURE__ */ jsx(Text, {
-				css: style.itemHelper,
-				children: secondaryText
-			})]
-		})]
+		...rest,
+		children: content
 	});
 });
 Item.displayName = "BitkitActionMenu.Item";

package/dist/components/BitkitActionMenu/BitkitActionMenu.js.map

@@ -1 +1 @@
-{"version":3,"file":"BitkitActionMenu.js","names":[],"sources":["../../../lib/components/BitkitActionMenu/BitkitActionMenu.tsx"],"sourcesContent":["import { Box } from '@chakra-ui/react/box';\nimport {\n  Menu,\n  type MenuItemGroupProps,\n  type MenuItemProps,\n  type MenuRootProps,\n  useMenuStyles,\n} from '@chakra-ui/react/menu';\nimport { Portal } from '@chakra-ui/react/portal';\nimport { Separator as ChakraSeparator } from '@chakra-ui/react/separator';\nimport { Text } from '@chakra-ui/react/text';\nimport { createContext, forwardRef, type ReactNode, useContext } from 'react';\n\nimport { type BitkitIconComponent } from '../../icons';\n\nconst BitkitMenuContext = createContext<MenuRootProps['size']>('lg');\n\ninterface BitkitMenuRootProps extends Omit<MenuRootProps, 'children'> {\n  trigger: ReactNode;\n  children?: ReactNode;\n}\n\nconst Root = ({ trigger, children, ...props }: BitkitMenuRootProps) => {\n  return (\n    <Menu.Root {...props}>\n      <Menu.Trigger asChild>{trigger}</Menu.Trigger>\n      <Portal>\n        <Menu.Positioner>\n          <BitkitMenuContext.Provider value={props.size}>\n            <Menu.Content>{children}</Menu.Content>\n          </BitkitMenuContext.Provider>\n        </Menu.Positioner>\n      </Portal>\n    </Menu.Root>\n  );\n};\nRoot.displayName = 'BitkitActionMenu.Root';\n\nexport interface BitkitMenuItemProps extends MenuItemProps {\n  danger?: boolean;\n  secondaryText?: ReactNode;\n  icon?: BitkitIconComponent;\n}\nconst Item = forwardRef<HTMLDivElement, BitkitMenuItemProps>(\n  ({ danger, secondaryText, icon: Icon, children, ...props }, ref) => {\n    const style = useMenuStyles();\n    const menuCtx = useContext(BitkitMenuContext);\n    return (\n      <Menu.Item data-danger={danger} ref={ref} {...props}>\n        {Icon && <Icon size={menuCtx === 'lg' ? '24' : '16'} />}\n        <Box flex=\"1\">\n          <Text>{children}</Text>\n          {secondaryText && <Text css={style.itemHelper}>{secondaryText}</Text>}\n        </Box>\n      </Menu.Item>\n    );\n  },\n);\nItem.displayName = 'BitkitActionMenu.Item';\n\nexport interface BitkitMenuGroupProps extends MenuItemGroupProps {\n  label: ReactNode;\n}\nconst Group = forwardRef<HTMLDivElement, BitkitMenuGroupProps>(({ label, children, ...props }, ref) => {\n  return (\n    <Menu.ItemGroup ref={ref} {...props}>\n      <Menu.ItemGroupLabel>\n        <Text>{label}</Text>\n        <ChakraSeparator flex=\"1\" />\n      </Menu.ItemGroupLabel>\n      {children}\n    </Menu.ItemGroup>\n  );\n});\nGroup.displayName = 'BitkitActionMenu.Group';\n\nconst Separator = () => {\n  return <Menu.Separator />;\n};\nSeparator.displayName = 'BitkitActionMenu.Separator';\n\nconst BitkitActionMenu = {\n  Root,\n  Separator,\n  Item,\n  Group,\n};\n\nexport default BitkitActionMenu;\n"],"mappings":";;;;;;;;AAeA,IAAM,oBAAoB,cAAqC,IAAI;AAOnE,IAAM,QAAQ,EAAE,SAAS,UAAU,GAAG,YAAiC;CACrE,OACE,qBAAC,KAAK,MAAN;EAAW,GAAI;YAAf,CACE,oBAAC,KAAK,SAAN;GAAc,SAAA;aAAS;EAAsB,CAAA,GAC7C,oBAAC,QAAD,EAAA,UACE,oBAAC,KAAK,YAAN,EAAA,UACE,oBAAC,kBAAkB,UAAnB;GAA4B,OAAO,MAAM;aACvC,oBAAC,KAAK,SAAN,EAAe,SAAuB,CAAA;EACZ,CAAA,EACb,CAAA,EACX,CAAA,CACC;;AAEf;AACA,KAAK,cAAc;AAOnB,IAAM,OAAO,YACV,EAAE,QAAQ,eAAe,MAAM,MAAM,UAAU,GAAG,SAAS,QAAQ;CAClE,MAAM,QAAQ,cAAc;CAC5B,MAAM,UAAU,WAAW,iBAAiB;CAC5C,OACE,qBAAC,KAAK,MAAN;EAAW,eAAa;EAAa;EAAK,GAAI;YAA9C,CACG,QAAQ,oBAAC,MAAD,EAAM,MAAM,YAAY,OAAO,OAAO,KAAO,CAAA,GACtD,qBAAC,KAAD;GAAK,MAAK;aAAV,CACE,oBAAC,MAAD,EAAO,SAAe,CAAA,GACrB,iBAAiB,oBAAC,MAAD;IAAM,KAAK,MAAM;cAAa;GAAoB,CAAA,CACjE;IACI;;AAEf,CACF;AACA,KAAK,cAAc;AAKnB,IAAM,QAAQ,YAAkD,EAAE,OAAO,UAAU,GAAG,SAAS,QAAQ;CACrG,OACE,qBAAC,KAAK,WAAN;EAAqB;EAAK,GAAI;YAA9B,CACE,qBAAC,KAAK,gBAAN,EAAA,UAAA,CACE,oBAAC,MAAD,EAAA,UAAO,MAAY,CAAA,GACnB,oBAAC,WAAD,EAAiB,MAAK,IAAK,CAAA,CACR,EAAA,CAAA,GACpB,QACa;;AAEpB,CAAC;AACD,MAAM,cAAc;AAEpB,IAAM,oBAAkB;CACtB,OAAO,oBAAC,KAAK,WAAN,CAAiB,CAAA;AAC1B;AACA,YAAU,cAAc;AAExB,IAAM,mBAAmB;CACvB;CACA,WAAA;CACA;CACA;AACF"}
+{"version":3,"file":"BitkitActionMenu.js","names":[],"sources":["../../../lib/components/BitkitActionMenu/BitkitActionMenu.tsx"],"sourcesContent":["import { Box } from '@chakra-ui/react/box';\nimport {\n  Menu,\n  type MenuItemGroupProps,\n  type MenuItemProps,\n  type MenuRootProps,\n  useMenuStyles,\n} from '@chakra-ui/react/menu';\nimport { Portal } from '@chakra-ui/react/portal';\nimport { Separator as ChakraSeparator } from '@chakra-ui/react/separator';\nimport { Text } from '@chakra-ui/react/text';\nimport { createContext, forwardRef, type ReactNode, type Ref, useContext } from 'react';\n\nimport { type BitkitIconComponent } from '../../icons';\n\nconst BitkitMenuContext = createContext<MenuRootProps['size']>('lg');\n\ninterface BitkitMenuRootProps extends Omit<MenuRootProps, 'children'> {\n  trigger: ReactNode;\n  children?: ReactNode;\n}\n\nconst Root = ({ trigger, children, ...props }: BitkitMenuRootProps) => {\n  return (\n    <Menu.Root {...props}>\n      <Menu.Trigger asChild>{trigger}</Menu.Trigger>\n      <Portal>\n        <Menu.Positioner>\n          <BitkitMenuContext.Provider value={props.size}>\n            <Menu.Content>{children}</Menu.Content>\n          </BitkitMenuContext.Provider>\n        </Menu.Positioner>\n      </Portal>\n    </Menu.Root>\n  );\n};\nRoot.displayName = 'BitkitActionMenu.Root';\n\ninterface BitkitMenuItemCommonProps extends MenuItemProps {\n  danger?: boolean;\n  icon?: BitkitIconComponent;\n  secondaryText?: ReactNode;\n}\n\ninterface BitkitMenuItemAsButtonProps extends BitkitMenuItemCommonProps {\n  href?: undefined;\n  isExternal?: undefined;\n  rel?: undefined;\n  target?: undefined;\n}\n\ninterface BitkitMenuItemAsAnchorProps extends BitkitMenuItemCommonProps {\n  href: string;\n  isExternal?: boolean;\n  rel?: string;\n  target?: string;\n}\n\nexport type BitkitMenuItemProps = BitkitMenuItemAsButtonProps | BitkitMenuItemAsAnchorProps;\n\nconst Item = forwardRef<HTMLElement, BitkitMenuItemProps>((props, ref) => {\n  const { children, danger, icon: Icon, secondaryText } = props;\n  const style = useMenuStyles();\n  const menuCtx = useContext(BitkitMenuContext);\n\n  const content = (\n    <>\n      {Icon && <Icon size={menuCtx === 'lg' ? '24' : '16'} />}\n      <Box flex=\"1\">\n        <Text>{children}</Text>\n        {secondaryText && <Text css={style.itemHelper}>{secondaryText}</Text>}\n      </Box>\n    </>\n  );\n\n  if (props.href !== undefined) {\n    const {\n      children: _children,\n      danger: _danger,\n      href,\n      icon: _icon,\n      isExternal,\n      rel,\n      secondaryText: _secondaryText,\n      target,\n      ...rest\n    } = props;\n    const effectiveTarget = isExternal ? '_blank' : target;\n    const effectiveRel = isExternal ? (rel ? `${rel} noreferrer noopener` : 'noreferrer noopener') : rel;\n    return (\n      <Menu.Item asChild data-danger={danger} {...rest}>\n        <a ref={ref as Ref<HTMLAnchorElement>} href={href} rel={effectiveRel} target={effectiveTarget}>\n          {content}\n        </a>\n      </Menu.Item>\n    );\n  }\n\n  const { children: _children, danger: _danger, icon: _icon, secondaryText: _secondaryText, ...rest } = props;\n  return (\n    <Menu.Item data-danger={danger} ref={ref as Ref<HTMLDivElement>} {...rest}>\n      {content}\n    </Menu.Item>\n  );\n});\nItem.displayName = 'BitkitActionMenu.Item';\n\nexport interface BitkitMenuGroupProps extends MenuItemGroupProps {\n  label: ReactNode;\n}\nconst Group = forwardRef<HTMLDivElement, BitkitMenuGroupProps>(({ label, children, ...props }, ref) => {\n  return (\n    <Menu.ItemGroup ref={ref} {...props}>\n      <Menu.ItemGroupLabel>\n        <Text>{label}</Text>\n        <ChakraSeparator flex=\"1\" />\n      </Menu.ItemGroupLabel>\n      {children}\n    </Menu.ItemGroup>\n  );\n});\nGroup.displayName = 'BitkitActionMenu.Group';\n\nconst Separator = () => {\n  return <Menu.Separator />;\n};\nSeparator.displayName = 'BitkitActionMenu.Separator';\n\nconst BitkitActionMenu = {\n  Root,\n  Separator,\n  Item,\n  Group,\n};\n\nexport default BitkitActionMenu;\n"],"mappings":";;;;;;;;AAeA,IAAM,oBAAoB,cAAqC,IAAI;AAOnE,IAAM,QAAQ,EAAE,SAAS,UAAU,GAAG,YAAiC;CACrE,OACE,qBAAC,KAAK,MAAN;EAAW,GAAI;YAAf,CACE,oBAAC,KAAK,SAAN;GAAc,SAAA;aAAS;EAAsB,CAAA,GAC7C,oBAAC,QAAD,EAAA,UACE,oBAAC,KAAK,YAAN,EAAA,UACE,oBAAC,kBAAkB,UAAnB;GAA4B,OAAO,MAAM;aACvC,oBAAC,KAAK,SAAN,EAAe,SAAuB,CAAA;EACZ,CAAA,EACb,CAAA,EACX,CAAA,CACC;;AAEf;AACA,KAAK,cAAc;AAwBnB,IAAM,OAAO,YAA8C,OAAO,QAAQ;CACxE,MAAM,EAAE,UAAU,QAAQ,MAAM,MAAM,kBAAkB;CACxD,MAAM,QAAQ,cAAc;CAC5B,MAAM,UAAU,WAAW,iBAAiB;CAE5C,MAAM,UACJ,qBAAA,YAAA,EAAA,UAAA,CACG,QAAQ,oBAAC,MAAD,EAAM,MAAM,YAAY,OAAO,OAAO,KAAO,CAAA,GACtD,qBAAC,KAAD;EAAK,MAAK;YAAV,CACE,oBAAC,MAAD,EAAO,SAAe,CAAA,GACrB,iBAAiB,oBAAC,MAAD;GAAM,KAAK,MAAM;aAAa;EAAoB,CAAA,CACjE;GACL,EAAA,CAAA;CAGJ,IAAI,MAAM,SAAS,KAAA,GAAW;EAC5B,MAAM,EACJ,UAAU,WACV,QAAQ,SACR,MACA,MAAM,OACN,YACA,KACA,eAAe,gBACf,QACA,GAAG,SACD;EACJ,MAAM,kBAAkB,aAAa,WAAW;EAChD,MAAM,eAAe,aAAc,MAAM,GAAG,IAAI,wBAAwB,wBAAyB;EACjG,OACE,oBAAC,KAAK,MAAN;GAAW,SAAA;GAAQ,eAAa;GAAQ,GAAI;aAC1C,oBAAC,KAAD;IAAQ;IAAqC;IAAM,KAAK;IAAc,QAAQ;cAC3E;GACA,CAAA;EACM,CAAA;CAEf;CAEA,MAAM,EAAE,UAAU,WAAW,QAAQ,SAAS,MAAM,OAAO,eAAe,gBAAgB,GAAG,SAAS;CACtG,OACE,oBAAC,KAAK,MAAN;EAAW,eAAa;EAAa;EAA4B,GAAI;YAClE;CACQ,CAAA;AAEf,CAAC;AACD,KAAK,cAAc;AAKnB,IAAM,QAAQ,YAAkD,EAAE,OAAO,UAAU,GAAG,SAAS,QAAQ;CACrG,OACE,qBAAC,KAAK,WAAN;EAAqB;EAAK,GAAI;YAA9B,CACE,qBAAC,KAAK,gBAAN,EAAA,UAAA,CACE,oBAAC,MAAD,EAAA,UAAO,MAAY,CAAA,GACnB,oBAAC,WAAD,EAAiB,MAAK,IAAK,CAAA,CACR,EAAA,CAAA,GACpB,QACa;;AAEpB,CAAC;AACD,MAAM,cAAc;AAEpB,IAAM,oBAAkB;CACtB,OAAO,oBAAC,KAAK,WAAN,CAAiB,CAAA;AAC1B;AACA,YAAU,cAAc;AAExB,IAAM,mBAAmB;CACvB;CACA,WAAA;CACA;CACA;AACF"}

package/dist/components/BitkitButton/BitkitButton.d.ts

@@ -1,10 +1,33 @@
 import { ButtonProps } from '@chakra-ui/react/button';
+import { HTMLChakraProps, RecipeProps } from '@chakra-ui/react/styled-system';
+import { ReactElement } from 'react';
 import { BitkitIconComponent } from '../../icons';
-export interface BitkitButtonProps extends Omit<ButtonProps, 'children' | 'colorPalette' | 'disabled' | 'loading' | 'loadingText' | 'spinner' | 'spinnerPlacement'> {
-    children: string;
+type BitkitButtonOmittedFromButton = 'asChild' | 'children' | 'colorPalette' | 'disabled' | 'loading' | 'loadingText' | 'spinner' | 'spinnerPlacement';
+interface BitkitButtonCommonProps {
     icon?: BitkitIconComponent;
-    state?: 'disabled' | 'loading' | 'skeleton';
     suffixIcon?: BitkitIconComponent;
 }
-declare const BitkitButton: import('react').ForwardRefExoticComponent<BitkitButtonProps & import('react').RefAttributes<HTMLButtonElement>>;
+export interface BitkitButtonAsButtonProps extends BitkitButtonCommonProps, Omit<ButtonProps, BitkitButtonOmittedFromButton> {
+    asChild?: false;
+    children: string;
+    href?: undefined;
+    isExternal?: undefined;
+    state?: 'disabled' | 'loading' | 'skeleton';
+}
+export interface BitkitButtonAsAnchorProps extends BitkitButtonCommonProps, Omit<HTMLChakraProps<'a'>, 'children' | 'colorPalette'>, RecipeProps<'button'> {
+    asChild?: false;
+    children: string;
+    href: string;
+    isExternal?: boolean;
+    state?: 'disabled' | 'skeleton';
+}
+interface BitkitButtonAsChildProps extends BitkitButtonCommonProps, Omit<ButtonProps, BitkitButtonOmittedFromButton> {
+    asChild: true;
+    children: ReactElement;
+    href?: undefined;
+    isExternal?: undefined;
+    state?: 'disabled' | 'loading' | 'skeleton';
+}
+export type BitkitButtonProps = BitkitButtonAsButtonProps | BitkitButtonAsAnchorProps | BitkitButtonAsChildProps;
+declare const BitkitButton: import('react').ForwardRefExoticComponent<BitkitButtonProps & import('react').RefAttributes<HTMLElement>>;
 export default BitkitButton;

package/dist/components/BitkitButton/BitkitButton.js

@@ -1,20 +1,97 @@
-import { forwardRef } from "react";
-import { jsx, jsxs } from "react/jsx-runtime";
+import { chakra, useRecipe } from "@chakra-ui/react/styled-system";
+import { Children, cloneElement, forwardRef } from "react";
+import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
 import { Skeleton } from "@chakra-ui/react/skeleton";
 import { Button } from "@chakra-ui/react/button";
 //#region lib/components/BitkitButton/BitkitButton.tsx
 var BitkitButton = forwardRef((props, ref) => {
-	const { children, icon: Icon, size, state, suffixIcon: SuffixIcon, ...rest } = props;
-	const iconSize = size === "sm" ? "16" : "24";
+	const buttonRecipe = useRecipe({ key: "button" });
+	const Icon = props.icon;
+	const SuffixIcon = props.suffixIcon;
+	const iconSize = props.size === "sm" ? "16" : "24";
+	const isDisabled = props.state === "disabled";
+	const isSkeleton = props.state === "skeleton";
+	if (props.asChild) {
+		const { asChild: _asChild, children, icon: _icon, state, suffixIcon: _suffixIcon, ...buttonRest } = props;
+		const onlyChild = Children.only(children);
+		const buttonElement = /* @__PURE__ */ jsx(Button, {
+			asChild: true,
+			disabled: isDisabled,
+			loading: state === "loading",
+			ref,
+			...buttonRest,
+			children: cloneElement(onlyChild, void 0, /* @__PURE__ */ jsxs(Fragment$1, { children: [
+				Icon && /* @__PURE__ */ jsx(Icon, {
+					marginInlineStart: "-4",
+					size: iconSize
+				}),
+				onlyChild.props.children,
+				SuffixIcon && /* @__PURE__ */ jsx(SuffixIcon, {
+					marginInlineEnd: "-4",
+					size: iconSize
+				})
+			] }))
+		});
+		return isSkeleton ? /* @__PURE__ */ jsx(Skeleton, {
+			asChild: true,
+			loading: true,
+			children: buttonElement
+		}) : buttonElement;
+	}
+	if (props.href !== void 0) {
+		const { children, css, href, icon: _icon, isExternal, onClick, onKeyDown, rel, size, state: _state, suffixIcon: _suffixIcon, target, variant, ...anchorRest } = props;
+		const effectiveTarget = isExternal ? "_blank" : target;
+		const effectiveRel = isExternal ? rel ? `${rel} noreferrer noopener` : "noreferrer noopener" : rel;
+		const handleClick = isDisabled ? (e) => {
+			e.preventDefault();
+			e.stopPropagation();
+		} : onClick;
+		const handleKeyDown = isDisabled ? (e) => {
+			if (e.key === "Enter" || e.key === " ") {
+				e.preventDefault();
+				e.stopPropagation();
+			}
+		} : onKeyDown;
+		const anchorElement = /* @__PURE__ */ jsxs(chakra.a, {
+			ref,
+			...anchorRest,
+			"aria-disabled": isDisabled || void 0,
+			css: [buttonRecipe({
+				size,
+				variant
+			}), css],
+			href: isDisabled ? void 0 : href,
+			onClick: handleClick,
+			onKeyDown: handleKeyDown,
+			rel: effectiveRel,
+			target: effectiveTarget,
+			children: [
+				Icon && /* @__PURE__ */ jsx(Icon, {
+					marginInlineStart: "-4",
+					size: iconSize
+				}),
+				children,
+				SuffixIcon && /* @__PURE__ */ jsx(SuffixIcon, {
+					marginInlineEnd: "-4",
+					size: iconSize
+				})
+			]
+		});
+		return isSkeleton ? /* @__PURE__ */ jsx(Skeleton, {
+			asChild: true,
+			loading: true,
+			children: anchorElement
+		}) : anchorElement;
+	}
+	const { children, icon: _icon, state, suffixIcon: _suffixIcon, ...buttonRest } = props;
 	return /* @__PURE__ */ jsx(Skeleton, {
 		asChild: true,
-		loading: state === "skeleton",
+		loading: isSkeleton,
 		children: /* @__PURE__ */ jsxs(Button, {
-			disabled: state === "disabled",
+			disabled: isDisabled,
 			loading: state === "loading",
 			ref,
-			size,
-			...rest,
+			...buttonRest,
 			children: [
 				Icon && /* @__PURE__ */ jsx(Icon, {
 					marginInlineStart: "-4",

package/dist/components/BitkitButton/BitkitButton.js.map

@@ -1 +1 @@
-{"version":3,"file":"BitkitButton.js","names":[],"sources":["../../../lib/components/BitkitButton/BitkitButton.tsx"],"sourcesContent":["import { Button, type ButtonProps } from '@chakra-ui/react/button';\nimport { Skeleton } from '@chakra-ui/react/skeleton';\nimport { forwardRef } from 'react';\n\nimport { type BitkitIconComponent } from '../../icons';\n\nexport interface BitkitButtonProps extends Omit<\n  ButtonProps,\n  'children' | 'colorPalette' | 'disabled' | 'loading' | 'loadingText' | 'spinner' | 'spinnerPlacement'\n> {\n  children: string;\n  icon?: BitkitIconComponent;\n  state?: 'disabled' | 'loading' | 'skeleton';\n  suffixIcon?: BitkitIconComponent;\n}\n\nconst BitkitButton = forwardRef<HTMLButtonElement, BitkitButtonProps>((props, ref) => {\n  const { children, icon: Icon, size, state, suffixIcon: SuffixIcon, ...rest } = props;\n\n  const iconSize = size === 'sm' ? '16' : '24';\n\n  return (\n    <Skeleton asChild loading={state === 'skeleton'}>\n      <Button disabled={state === 'disabled'} loading={state === 'loading'} ref={ref} size={size} {...rest}>\n        {Icon && <Icon marginInlineStart=\"-4\" size={iconSize} />}\n        {children}\n        {SuffixIcon && <SuffixIcon marginInlineEnd=\"-4\" size={iconSize} />}\n      </Button>\n    </Skeleton>\n  );\n});\n\nBitkitButton.displayName = 'BitkitButton';\n\nexport default BitkitButton;\n"],"mappings":";;;;;AAgBA,IAAM,eAAe,YAAkD,OAAO,QAAQ;CACpF,MAAM,EAAE,UAAU,MAAM,MAAM,MAAM,OAAO,YAAY,YAAY,GAAG,SAAS;CAE/E,MAAM,WAAW,SAAS,OAAO,OAAO;CAExC,OACE,oBAAC,UAAD;EAAU,SAAA;EAAQ,SAAS,UAAU;YACnC,qBAAC,QAAD;GAAQ,UAAU,UAAU;GAAY,SAAS,UAAU;GAAgB;GAAW;GAAM,GAAI;aAAhG;IACG,QAAQ,oBAAC,MAAD;KAAM,mBAAkB;KAAK,MAAM;IAAW,CAAA;IACtD;IACA,cAAc,oBAAC,YAAD;KAAY,iBAAgB;KAAK,MAAM;IAAW,CAAA;GAC3D;;CACA,CAAA;AAEd,CAAC;AAED,aAAa,cAAc"}
+{"version":3,"file":"BitkitButton.js","names":[],"sources":["../../../lib/components/BitkitButton/BitkitButton.tsx"],"sourcesContent":["import { Button, type ButtonProps } from '@chakra-ui/react/button';\nimport { Skeleton } from '@chakra-ui/react/skeleton';\nimport { chakra, type HTMLChakraProps, type RecipeProps, useRecipe } from '@chakra-ui/react/styled-system';\nimport {\n  Children,\n  cloneElement,\n  forwardRef,\n  type KeyboardEvent,\n  type MouseEvent,\n  type ReactElement,\n  type ReactNode,\n  type Ref,\n} from 'react';\n\nimport { type BitkitIconComponent } from '../../icons';\n\ntype BitkitButtonOmittedFromButton =\n  | 'asChild'\n  | 'children'\n  | 'colorPalette'\n  | 'disabled'\n  | 'loading'\n  | 'loadingText'\n  | 'spinner'\n  | 'spinnerPlacement';\n\ninterface BitkitButtonCommonProps {\n  icon?: BitkitIconComponent;\n  suffixIcon?: BitkitIconComponent;\n}\n\nexport interface BitkitButtonAsButtonProps\n  extends BitkitButtonCommonProps, Omit<ButtonProps, BitkitButtonOmittedFromButton> {\n  asChild?: false;\n  children: string;\n  href?: undefined;\n  isExternal?: undefined;\n  state?: 'disabled' | 'loading' | 'skeleton';\n}\n\nexport interface BitkitButtonAsAnchorProps\n  extends BitkitButtonCommonProps, Omit<HTMLChakraProps<'a'>, 'children' | 'colorPalette'>, RecipeProps<'button'> {\n  asChild?: false;\n  children: string;\n  href: string;\n  isExternal?: boolean;\n  state?: 'disabled' | 'skeleton';\n}\n\ninterface BitkitButtonAsChildProps extends BitkitButtonCommonProps, Omit<ButtonProps, BitkitButtonOmittedFromButton> {\n  asChild: true;\n  children: ReactElement;\n  href?: undefined;\n  isExternal?: undefined;\n  state?: 'disabled' | 'loading' | 'skeleton';\n}\n\nexport type BitkitButtonProps = BitkitButtonAsButtonProps | BitkitButtonAsAnchorProps | BitkitButtonAsChildProps;\n\n// The forwarded ref is typed as HTMLElement to cover all three modes (button, anchor, slot/asChild),\n// since asChild can render any element (router Link, custom wrappers, etc.). Inner narrow casts\n// satisfy the wrapped Chakra components without affecting the consumer-visible ref shape.\nconst BitkitButton = forwardRef<HTMLElement, BitkitButtonProps>((props, ref) => {\n  const buttonRecipe = useRecipe({ key: 'button' });\n  const Icon = props.icon;\n  const SuffixIcon = props.suffixIcon;\n  const iconSize = props.size === 'sm' ? '16' : '24';\n  const isDisabled = props.state === 'disabled';\n  const isSkeleton = props.state === 'skeleton';\n\n  // --- Slot mode (asChild) ---\n  if (props.asChild) {\n    const { asChild: _asChild, children, icon: _icon, state, suffixIcon: _suffixIcon, ...buttonRest } = props;\n    const onlyChild = Children.only(children) as ReactElement<{ children?: ReactNode }>;\n    const buttonElement = (\n      <Button\n        asChild\n        disabled={isDisabled}\n        loading={state === 'loading'}\n        ref={ref as Ref<HTMLButtonElement>}\n        {...buttonRest}\n      >\n        {cloneElement(\n          onlyChild,\n          undefined,\n          <>\n            {Icon && <Icon marginInlineStart=\"-4\" size={iconSize} />}\n            {onlyChild.props.children}\n            {SuffixIcon && <SuffixIcon marginInlineEnd=\"-4\" size={iconSize} />}\n          </>,\n        )}\n      </Button>\n    );\n    return isSkeleton ? (\n      <Skeleton asChild loading>\n        {buttonElement}\n      </Skeleton>\n    ) : (\n      buttonElement\n    );\n  }\n\n  // --- Anchor mode (href) ---\n  if (props.href !== undefined) {\n    const {\n      children,\n      css,\n      href,\n      icon: _icon,\n      isExternal,\n      onClick,\n      onKeyDown,\n      rel,\n      size,\n      state: _state,\n      suffixIcon: _suffixIcon,\n      target,\n      variant,\n      ...anchorRest\n    } = props;\n    const effectiveTarget = isExternal ? '_blank' : target;\n    const effectiveRel = isExternal ? (rel ? `${rel} noreferrer noopener` : 'noreferrer noopener') : rel;\n    const handleClick = isDisabled\n      ? (e: MouseEvent<HTMLAnchorElement>) => {\n          e.preventDefault();\n          e.stopPropagation();\n        }\n      : onClick;\n    const handleKeyDown = isDisabled\n      ? (e: KeyboardEvent<HTMLAnchorElement>) => {\n          if (e.key === 'Enter' || e.key === ' ') {\n            e.preventDefault();\n            e.stopPropagation();\n          }\n        }\n      : onKeyDown;\n    const anchorElement = (\n      <chakra.a\n        ref={ref as Ref<HTMLAnchorElement>}\n        {...anchorRest}\n        aria-disabled={isDisabled || undefined}\n        css={[buttonRecipe({ size, variant }), css]}\n        href={isDisabled ? undefined : href}\n        onClick={handleClick}\n        onKeyDown={handleKeyDown}\n        rel={effectiveRel}\n        target={effectiveTarget}\n      >\n        {Icon && <Icon marginInlineStart=\"-4\" size={iconSize} />}\n        {children}\n        {SuffixIcon && <SuffixIcon marginInlineEnd=\"-4\" size={iconSize} />}\n      </chakra.a>\n    );\n    return isSkeleton ? (\n      <Skeleton asChild loading>\n        {anchorElement}\n      </Skeleton>\n    ) : (\n      anchorElement\n    );\n  }\n\n  // --- Button mode (default) ---\n  const { children, icon: _icon, state, suffixIcon: _suffixIcon, ...buttonRest } = props;\n  return (\n    <Skeleton asChild loading={isSkeleton}>\n      <Button disabled={isDisabled} loading={state === 'loading'} ref={ref as Ref<HTMLButtonElement>} {...buttonRest}>\n        {Icon && <Icon marginInlineStart=\"-4\" size={iconSize} />}\n        {children}\n        {SuffixIcon && <SuffixIcon marginInlineEnd=\"-4\" size={iconSize} />}\n      </Button>\n    </Skeleton>\n  );\n});\n\nBitkitButton.displayName = 'BitkitButton';\n\nexport default BitkitButton;\n"],"mappings":";;;;;;AA8DA,IAAM,eAAe,YAA4C,OAAO,QAAQ;CAC9E,MAAM,eAAe,UAAU,EAAE,KAAK,SAAS,CAAC;CAChD,MAAM,OAAO,MAAM;CACnB,MAAM,aAAa,MAAM;CACzB,MAAM,WAAW,MAAM,SAAS,OAAO,OAAO;CAC9C,MAAM,aAAa,MAAM,UAAU;CACnC,MAAM,aAAa,MAAM,UAAU;CAGnC,IAAI,MAAM,SAAS;EACjB,MAAM,EAAE,SAAS,UAAU,UAAU,MAAM,OAAO,OAAO,YAAY,aAAa,GAAG,eAAe;EACpG,MAAM,YAAY,SAAS,KAAK,QAAQ;EACxC,MAAM,gBACJ,oBAAC,QAAD;GACE,SAAA;GACA,UAAU;GACV,SAAS,UAAU;GACd;GACL,GAAI;aAEH,aACC,WACA,KAAA,GACA,qBAAA,YAAA,EAAA,UAAA;IACG,QAAQ,oBAAC,MAAD;KAAM,mBAAkB;KAAK,MAAM;IAAW,CAAA;IACtD,UAAU,MAAM;IAChB,cAAc,oBAAC,YAAD;KAAY,iBAAgB;KAAK,MAAM;IAAW,CAAA;GACjE,EAAA,CAAA,CACJ;EACM,CAAA;EAEV,OAAO,aACL,oBAAC,UAAD;GAAU,SAAA;GAAQ,SAAA;aACf;EACO,CAAA,IAEV;CAEJ;CAGA,IAAI,MAAM,SAAS,KAAA,GAAW;EAC5B,MAAM,EACJ,UACA,KACA,MACA,MAAM,OACN,YACA,SACA,WACA,KACA,MACA,OAAO,QACP,YAAY,aACZ,QACA,SACA,GAAG,eACD;EACJ,MAAM,kBAAkB,aAAa,WAAW;EAChD,MAAM,eAAe,aAAc,MAAM,GAAG,IAAI,wBAAwB,wBAAyB;EACjG,MAAM,cAAc,cACf,MAAqC;GACpC,EAAE,eAAe;GACjB,EAAE,gBAAgB;EACpB,IACA;EACJ,MAAM,gBAAgB,cACjB,MAAwC;GACvC,IAAI,EAAE,QAAQ,WAAW,EAAE,QAAQ,KAAK;IACtC,EAAE,eAAe;IACjB,EAAE,gBAAgB;GACpB;EACF,IACA;EACJ,MAAM,gBACJ,qBAAC,OAAO,GAAR;GACO;GACL,GAAI;GACJ,iBAAe,cAAc,KAAA;GAC7B,KAAK,CAAC,aAAa;IAAE;IAAM;GAAQ,CAAC,GAAG,GAAG;GAC1C,MAAM,aAAa,KAAA,IAAY;GAC/B,SAAS;GACT,WAAW;GACX,KAAK;GACL,QAAQ;aATV;IAWG,QAAQ,oBAAC,MAAD;KAAM,mBAAkB;KAAK,MAAM;IAAW,CAAA;IACtD;IACA,cAAc,oBAAC,YAAD;KAAY,iBAAgB;KAAK,MAAM;IAAW,CAAA;GACzD;;EAEZ,OAAO,aACL,oBAAC,UAAD;GAAU,SAAA;GAAQ,SAAA;aACf;EACO,CAAA,IAEV;CAEJ;CAGA,MAAM,EAAE,UAAU,MAAM,OAAO,OAAO,YAAY,aAAa,GAAG,eAAe;CACjF,OACE,oBAAC,UAAD;EAAU,SAAA;EAAQ,SAAS;YACzB,qBAAC,QAAD;GAAQ,UAAU;GAAY,SAAS,UAAU;GAAgB;GAA+B,GAAI;aAApG;IACG,QAAQ,oBAAC,MAAD;KAAM,mBAAkB;KAAK,MAAM;IAAW,CAAA;IACtD;IACA,cAAc,oBAAC,YAAD;KAAY,iBAAgB;KAAK,MAAM;IAAW,CAAA;GAC3D;;CACA,CAAA;AAEd,CAAC;AAED,aAAa,cAAc"}

package/dist/components/BitkitCheckboxGroup/BitkitCheckboxGroup.d.ts

@@ -5,8 +5,12 @@ export interface BitkitCheckboxGroupProps extends Fieldset.RootProps {
     checkboxGroupProps?: CheckboxGroupProps;
     children: ReactNode;
     errorText?: string;
+    /**
+     * Visible legend rendered above the group. Optional — if you omit it, pass `aria-label` or
+     * `aria-labelledby` instead so the fieldset still has an accessible name.
+     */
+    groupLabel?: string;
     helperText?: string;
-    label: string;
     name?: CheckboxGroupProps['name'];
     onValueChange: CheckboxGroupProps['onValueChange'];
     value: CheckboxGroupProps['value'];

package/dist/components/BitkitCheckboxGroup/BitkitCheckboxGroup.js

@@ -4,19 +4,20 @@ import { CheckboxGroup } from "@chakra-ui/react/checkbox";
 import { Fieldset } from "@chakra-ui/react/fieldset";
 //#region lib/components/BitkitCheckboxGroup/BitkitCheckboxGroup.tsx
 var BitkitCheckboxGroup = forwardRef((props, ref) => {
-	const { checkboxGroupProps, children, errorText, helperText, label, name, onValueChange, value, ...rest } = props;
+	const { checkboxGroupProps, children, errorText, helperText, groupLabel, name, onValueChange, value, ...rest } = props;
+	const hasHeader = !!groupLabel || !!helperText;
 	return /* @__PURE__ */ jsxs(Fieldset.Root, {
 		ref,
 		...rest,
 		invalid: rest.invalid || !!errorText,
 		children: [
-			/* @__PURE__ */ jsx(Fieldset.Legend, { children: label }),
+			groupLabel && /* @__PURE__ */ jsx(Fieldset.Legend, { children: groupLabel }),
 			!!helperText && /* @__PURE__ */ jsx(Fieldset.HelperText, { children: helperText }),
 			/* @__PURE__ */ jsx(Fieldset.Content, {
 				display: "flex",
 				flexDirection: "column",
 				gap: "12",
-				marginBlockStart: "12",
+				marginBlockStart: hasHeader ? "12" : void 0,
 				asChild: true,
 				children: /* @__PURE__ */ jsx(CheckboxGroup, {
 					name,

package/dist/components/BitkitCheckboxGroup/BitkitCheckboxGroup.js.map

@@ -1 +1 @@
-{"version":3,"file":"BitkitCheckboxGroup.js","names":[],"sources":["../../../lib/components/BitkitCheckboxGroup/BitkitCheckboxGroup.tsx"],"sourcesContent":["import { CheckboxGroup, type CheckboxGroupProps } from '@chakra-ui/react/checkbox';\nimport { Fieldset } from '@chakra-ui/react/fieldset';\nimport { forwardRef, type ReactNode } from 'react';\n\nexport interface BitkitCheckboxGroupProps extends Fieldset.RootProps {\n  checkboxGroupProps?: CheckboxGroupProps;\n  children: ReactNode;\n  errorText?: string;\n  helperText?: string;\n  label: string;\n  name?: CheckboxGroupProps['name'];\n  onValueChange: CheckboxGroupProps['onValueChange'];\n  value: CheckboxGroupProps['value'];\n}\n\nconst BitkitCheckboxGroup = forwardRef<HTMLFieldSetElement, BitkitCheckboxGroupProps>((props, ref) => {\n  const { checkboxGroupProps, children, errorText, helperText, label, name, onValueChange, value, ...rest } = props;\n  return (\n    <Fieldset.Root ref={ref} {...rest} invalid={rest.invalid || !!errorText}>\n      <Fieldset.Legend>{label}</Fieldset.Legend>\n      {!!helperText && <Fieldset.HelperText>{helperText}</Fieldset.HelperText>}\n      <Fieldset.Content display=\"flex\" flexDirection=\"column\" gap=\"12\" marginBlockStart=\"12\" asChild>\n        <CheckboxGroup name={name} onValueChange={onValueChange} value={value} {...checkboxGroupProps}>\n          {children}\n        </CheckboxGroup>\n      </Fieldset.Content>\n      {!!errorText && <Fieldset.ErrorText>{errorText}</Fieldset.ErrorText>}\n    </Fieldset.Root>\n  );\n});\n\nBitkitCheckboxGroup.displayName = 'BitkitCheckboxGroup';\n\nexport default BitkitCheckboxGroup;\n"],"mappings":";;;;;AAeA,IAAM,sBAAsB,YAA2D,OAAO,QAAQ;CACpG,MAAM,EAAE,oBAAoB,UAAU,WAAW,YAAY,OAAO,MAAM,eAAe,OAAO,GAAG,SAAS;CAC5G,OACE,qBAAC,SAAS,MAAV;EAAoB;EAAK,GAAI;EAAM,SAAS,KAAK,WAAW,CAAC,CAAC;YAA9D;GACE,oBAAC,SAAS,QAAV,EAAA,UAAkB,MAAuB,CAAA;GACxC,CAAC,CAAC,cAAc,oBAAC,SAAS,YAAV,EAAA,UAAsB,WAAgC,CAAA;GACvE,oBAAC,SAAS,SAAV;IAAkB,SAAQ;IAAO,eAAc;IAAS,KAAI;IAAK,kBAAiB;IAAK,SAAA;cACrF,oBAAC,eAAD;KAAqB;KAAqB;KAAsB;KAAO,GAAI;KACxE;IACY,CAAA;GACC,CAAA;GACjB,CAAC,CAAC,aAAa,oBAAC,SAAS,WAAV,EAAA,UAAqB,UAA8B,CAAA;EACtD;;AAEnB,CAAC;AAED,oBAAoB,cAAc"}
+{"version":3,"file":"BitkitCheckboxGroup.js","names":[],"sources":["../../../lib/components/BitkitCheckboxGroup/BitkitCheckboxGroup.tsx"],"sourcesContent":["import { CheckboxGroup, type CheckboxGroupProps } from '@chakra-ui/react/checkbox';\nimport { Fieldset } from '@chakra-ui/react/fieldset';\nimport { forwardRef, type ReactNode } from 'react';\n\nexport interface BitkitCheckboxGroupProps extends Fieldset.RootProps {\n  checkboxGroupProps?: CheckboxGroupProps;\n  children: ReactNode;\n  errorText?: string;\n  /**\n   * Visible legend rendered above the group. Optional — if you omit it, pass `aria-label` or\n   * `aria-labelledby` instead so the fieldset still has an accessible name.\n   */\n  groupLabel?: string;\n  helperText?: string;\n  name?: CheckboxGroupProps['name'];\n  onValueChange: CheckboxGroupProps['onValueChange'];\n  value: CheckboxGroupProps['value'];\n}\n\nconst BitkitCheckboxGroup = forwardRef<HTMLFieldSetElement, BitkitCheckboxGroupProps>((props, ref) => {\n  const { checkboxGroupProps, children, errorText, helperText, groupLabel, name, onValueChange, value, ...rest } =\n    props;\n  const hasHeader = !!groupLabel || !!helperText;\n  return (\n    <Fieldset.Root ref={ref} {...rest} invalid={rest.invalid || !!errorText}>\n      {groupLabel && <Fieldset.Legend>{groupLabel}</Fieldset.Legend>}\n      {!!helperText && <Fieldset.HelperText>{helperText}</Fieldset.HelperText>}\n      <Fieldset.Content\n        display=\"flex\"\n        flexDirection=\"column\"\n        gap=\"12\"\n        marginBlockStart={hasHeader ? '12' : undefined}\n        asChild\n      >\n        <CheckboxGroup name={name} onValueChange={onValueChange} value={value} {...checkboxGroupProps}>\n          {children}\n        </CheckboxGroup>\n      </Fieldset.Content>\n      {!!errorText && <Fieldset.ErrorText>{errorText}</Fieldset.ErrorText>}\n    </Fieldset.Root>\n  );\n});\n\nBitkitCheckboxGroup.displayName = 'BitkitCheckboxGroup';\n\nexport default BitkitCheckboxGroup;\n"],"mappings":";;;;;AAmBA,IAAM,sBAAsB,YAA2D,OAAO,QAAQ;CACpG,MAAM,EAAE,oBAAoB,UAAU,WAAW,YAAY,YAAY,MAAM,eAAe,OAAO,GAAG,SACtG;CACF,MAAM,YAAY,CAAC,CAAC,cAAc,CAAC,CAAC;CACpC,OACE,qBAAC,SAAS,MAAV;EAAoB;EAAK,GAAI;EAAM,SAAS,KAAK,WAAW,CAAC,CAAC;YAA9D;GACG,cAAc,oBAAC,SAAS,QAAV,EAAA,UAAkB,WAA4B,CAAA;GAC5D,CAAC,CAAC,cAAc,oBAAC,SAAS,YAAV,EAAA,UAAsB,WAAgC,CAAA;GACvE,oBAAC,SAAS,SAAV;IACE,SAAQ;IACR,eAAc;IACd,KAAI;IACJ,kBAAkB,YAAY,OAAO,KAAA;IACrC,SAAA;cAEA,oBAAC,eAAD;KAAqB;KAAqB;KAAsB;KAAO,GAAI;KACxE;IACY,CAAA;GACC,CAAA;GACjB,CAAC,CAAC,aAAa,oBAAC,SAAS,WAAV,EAAA,UAAqB,UAA8B,CAAA;EACtD;;AAEnB,CAAC;AAED,oBAAoB,cAAc"}

package/dist/components/BitkitControlButton/BitkitControlButton.d.ts

@@ -2,7 +2,7 @@ import { HTMLChakraProps } from '@chakra-ui/react/styled-system';
 import { BitkitIconComponent } from '../../icons';
 import { BitkitLabelTooltipProps } from '../BitkitLabelTooltip/BitkitLabelTooltip';
 type ControlButtonSize = 'xxs' | 'xs' | 'sm' | 'md' | 'lg';
-export interface BitkitControlButtonProps extends Omit<HTMLChakraProps<'button'>, 'children' | 'disabled' | 'size'> {
+interface BitkitControlButtonCommonProps {
     icon: BitkitIconComponent;
     isDanger?: boolean;
     label: string;
@@ -10,5 +10,14 @@ export interface BitkitControlButtonProps extends Omit<HTMLChakraProps<'button'>
     state?: 'disabled' | 'skeleton';
     tooltipProps?: Partial<Omit<BitkitLabelTooltipProps, 'children' | 'text'>>;
 }
-declare const BitkitControlButton: import('react').ForwardRefExoticComponent<BitkitControlButtonProps & import('react').RefAttributes<HTMLButtonElement>>;
+interface BitkitControlButtonAsButtonProps extends BitkitControlButtonCommonProps, Omit<HTMLChakraProps<'button'>, 'children' | 'disabled' | 'size'> {
+    href?: undefined;
+    isExternal?: undefined;
+}
+interface BitkitControlButtonAsAnchorProps extends BitkitControlButtonCommonProps, Omit<HTMLChakraProps<'a'>, 'children' | 'size'> {
+    href: string;
+    isExternal?: boolean;
+}
+export type BitkitControlButtonProps = BitkitControlButtonAsButtonProps | BitkitControlButtonAsAnchorProps;
+declare const BitkitControlButton: import('react').ForwardRefExoticComponent<BitkitControlButtonProps & import('react').RefAttributes<HTMLButtonElement | HTMLAnchorElement>>;
 export default BitkitControlButton;

package/dist/components/BitkitControlButton/BitkitControlButton.js

@@ -5,9 +5,52 @@ import { jsx } from "react/jsx-runtime";
 import { Skeleton } from "@chakra-ui/react/skeleton";
 //#region lib/components/BitkitControlButton/BitkitControlButton.tsx
 var BitkitControlButton = forwardRef((props, ref) => {
-	const { icon: Icon, isDanger, label, size = "sm", state, tooltipProps, ...rest } = props;
+	const Icon = props.icon;
+	const size = props.size ?? "sm";
 	const recipe = useRecipe({ key: "controlButton" });
 	const iconSize = size === "xxs" || size === "xs" ? "16" : "24";
+	const isDisabled = props.state === "disabled";
+	const isSkeleton = props.state === "skeleton";
+	const inertOnClick = isDisabled || isSkeleton;
+	if (props.href !== void 0) {
+		const { href, icon: _icon, isDanger, isExternal, label, onClick, onKeyDown, rel, size: _size, state: _state, target, tooltipProps, ...anchorRest } = props;
+		const effectiveTarget = isExternal ? "_blank" : target;
+		const effectiveRel = isExternal ? rel ? `${rel} noreferrer noopener` : "noreferrer noopener" : rel;
+		const handleClick = inertOnClick ? (e) => {
+			e.preventDefault();
+			e.stopPropagation();
+		} : onClick;
+		const handleKeyDown = inertOnClick ? (e) => {
+			if (e.key === "Enter" || e.key === " ") {
+				e.preventDefault();
+				e.stopPropagation();
+			}
+		} : onKeyDown;
+		return /* @__PURE__ */ jsx(BitkitLabelTooltip, {
+			text: label,
+			...tooltipProps,
+			children: /* @__PURE__ */ jsx(chakra.a, {
+				ref,
+				"aria-disabled": inertOnClick || void 0,
+				"aria-label": label,
+				...anchorRest,
+				css: recipe({
+					isDanger,
+					size
+				}),
+				href: inertOnClick ? void 0 : href,
+				onClick: handleClick,
+				onKeyDown: handleKeyDown,
+				rel: effectiveRel,
+				target: effectiveTarget,
+				children: /* @__PURE__ */ jsx(Skeleton, {
+					loading: isSkeleton,
+					children: /* @__PURE__ */ jsx(Icon, { size: iconSize })
+				})
+			})
+		});
+	}
+	const { icon: _icon, isDanger, label, size: _size, state, tooltipProps, ...buttonRest } = props;
 	return /* @__PURE__ */ jsx(BitkitLabelTooltip, {
 		text: label,
 		...tooltipProps,
@@ -15,13 +58,13 @@ var BitkitControlButton = forwardRef((props, ref) => {
 			ref,
 			"aria-label": label,
 			disabled: state === "disabled" || state === "skeleton",
-			...rest,
+			...buttonRest,
 			css: recipe({
 				isDanger,
 				size
 			}),
 			children: /* @__PURE__ */ jsx(Skeleton, {
-				loading: state === "skeleton",
+				loading: isSkeleton,
 				children: /* @__PURE__ */ jsx(Icon, { size: iconSize })
 			})
 		})

package/dist/components/BitkitControlButton/BitkitControlButton.js.map

@@ -1 +1 @@
-{"version":3,"file":"BitkitControlButton.js","names":[],"sources":["../../../lib/components/BitkitControlButton/BitkitControlButton.tsx"],"sourcesContent":["import { Skeleton } from '@chakra-ui/react/skeleton';\nimport { chakra, type HTMLChakraProps, useRecipe } from '@chakra-ui/react/styled-system';\nimport { forwardRef } from 'react';\n\nimport { type BitkitIconComponent } from '../../icons';\nimport BitkitLabelTooltip, { type BitkitLabelTooltipProps } from '../BitkitLabelTooltip/BitkitLabelTooltip';\n\ntype ControlButtonSize = 'xxs' | 'xs' | 'sm' | 'md' | 'lg';\n\nexport interface BitkitControlButtonProps extends Omit<HTMLChakraProps<'button'>, 'children' | 'disabled' | 'size'> {\n  icon: BitkitIconComponent;\n  isDanger?: boolean;\n  label: string;\n  size?: ControlButtonSize;\n  state?: 'disabled' | 'skeleton';\n  tooltipProps?: Partial<Omit<BitkitLabelTooltipProps, 'children' | 'text'>>;\n}\n\nconst BitkitControlButton = forwardRef<HTMLButtonElement, BitkitControlButtonProps>((props, ref) => {\n  const { icon: Icon, isDanger, label, size = 'sm', state, tooltipProps, ...rest } = props;\n\n  const recipe = useRecipe({ key: 'controlButton' });\n  const iconSize = size === 'xxs' || size === 'xs' ? '16' : '24';\n\n  return (\n    <BitkitLabelTooltip text={label} {...tooltipProps}>\n      <chakra.button\n        ref={ref}\n        aria-label={label}\n        disabled={state === 'disabled' || state === 'skeleton'}\n        {...rest}\n        css={recipe({ isDanger, size })}\n      >\n        <Skeleton loading={state === 'skeleton'}>\n          <Icon size={iconSize} />\n        </Skeleton>\n      </chakra.button>\n    </BitkitLabelTooltip>\n  );\n});\n\nBitkitControlButton.displayName = 'BitkitControlButton';\n\nexport default BitkitControlButton;\n"],"mappings":";;;;;;AAkBA,IAAM,sBAAsB,YAAyD,OAAO,QAAQ;CAClG,MAAM,EAAE,MAAM,MAAM,UAAU,OAAO,OAAO,MAAM,OAAO,cAAc,GAAG,SAAS;CAEnF,MAAM,SAAS,UAAU,EAAE,KAAK,gBAAgB,CAAC;CACjD,MAAM,WAAW,SAAS,SAAS,SAAS,OAAO,OAAO;CAE1D,OACE,oBAAC,oBAAD;EAAoB,MAAM;EAAO,GAAI;YACnC,oBAAC,OAAO,QAAR;GACO;GACL,cAAY;GACZ,UAAU,UAAU,cAAc,UAAU;GAC5C,GAAI;GACJ,KAAK,OAAO;IAAE;IAAU;GAAK,CAAC;aAE9B,oBAAC,UAAD;IAAU,SAAS,UAAU;cAC3B,oBAAC,MAAD,EAAM,MAAM,SAAW,CAAA;GACf,CAAA;EACG,CAAA;CACG,CAAA;AAExB,CAAC;AAED,oBAAoB,cAAc"}
+{"version":3,"file":"BitkitControlButton.js","names":[],"sources":["../../../lib/components/BitkitControlButton/BitkitControlButton.tsx"],"sourcesContent":["import { Skeleton } from '@chakra-ui/react/skeleton';\nimport { chakra, type HTMLChakraProps, useRecipe } from '@chakra-ui/react/styled-system';\nimport { forwardRef, type KeyboardEvent, type MouseEvent, type Ref } from 'react';\n\nimport { type BitkitIconComponent } from '../../icons';\nimport BitkitLabelTooltip, { type BitkitLabelTooltipProps } from '../BitkitLabelTooltip/BitkitLabelTooltip';\n\ntype ControlButtonSize = 'xxs' | 'xs' | 'sm' | 'md' | 'lg';\n\ninterface BitkitControlButtonCommonProps {\n  icon: BitkitIconComponent;\n  isDanger?: boolean;\n  label: string;\n  size?: ControlButtonSize;\n  state?: 'disabled' | 'skeleton';\n  tooltipProps?: Partial<Omit<BitkitLabelTooltipProps, 'children' | 'text'>>;\n}\n\ninterface BitkitControlButtonAsButtonProps\n  extends BitkitControlButtonCommonProps, Omit<HTMLChakraProps<'button'>, 'children' | 'disabled' | 'size'> {\n  href?: undefined;\n  isExternal?: undefined;\n}\n\ninterface BitkitControlButtonAsAnchorProps\n  extends BitkitControlButtonCommonProps, Omit<HTMLChakraProps<'a'>, 'children' | 'size'> {\n  href: string;\n  isExternal?: boolean;\n}\n\nexport type BitkitControlButtonProps = BitkitControlButtonAsButtonProps | BitkitControlButtonAsAnchorProps;\n\nconst BitkitControlButton = forwardRef<HTMLButtonElement | HTMLAnchorElement, BitkitControlButtonProps>(\n  (props, ref) => {\n    const Icon = props.icon;\n    const size = props.size ?? 'sm';\n    const recipe = useRecipe({ key: 'controlButton' });\n    const iconSize = size === 'xxs' || size === 'xs' ? '16' : '24';\n    const isDisabled = props.state === 'disabled';\n    const isSkeleton = props.state === 'skeleton';\n    const inertOnClick = isDisabled || isSkeleton;\n\n    // --- Anchor mode (href) ---\n    if (props.href !== undefined) {\n      const {\n        href,\n        icon: _icon,\n        isDanger,\n        isExternal,\n        label,\n        onClick,\n        onKeyDown,\n        rel,\n        size: _size,\n        state: _state,\n        target,\n        tooltipProps,\n        ...anchorRest\n      } = props;\n      const effectiveTarget = isExternal ? '_blank' : target;\n      const effectiveRel = isExternal ? (rel ? `${rel} noreferrer noopener` : 'noreferrer noopener') : rel;\n      const handleClick = inertOnClick\n        ? (e: MouseEvent<HTMLAnchorElement>) => {\n            e.preventDefault();\n            e.stopPropagation();\n          }\n        : onClick;\n      const handleKeyDown = inertOnClick\n        ? (e: KeyboardEvent<HTMLAnchorElement>) => {\n            if (e.key === 'Enter' || e.key === ' ') {\n              e.preventDefault();\n              e.stopPropagation();\n            }\n          }\n        : onKeyDown;\n      return (\n        <BitkitLabelTooltip text={label} {...tooltipProps}>\n          <chakra.a\n            ref={ref as Ref<HTMLAnchorElement>}\n            aria-disabled={inertOnClick || undefined}\n            aria-label={label}\n            {...anchorRest}\n            css={recipe({ isDanger, size })}\n            href={inertOnClick ? undefined : href}\n            onClick={handleClick}\n            onKeyDown={handleKeyDown}\n            rel={effectiveRel}\n            target={effectiveTarget}\n          >\n            <Skeleton loading={isSkeleton}>\n              <Icon size={iconSize} />\n            </Skeleton>\n          </chakra.a>\n        </BitkitLabelTooltip>\n      );\n    }\n\n    // --- Button mode (default) ---\n    const { icon: _icon, isDanger, label, size: _size, state, tooltipProps, ...buttonRest } = props;\n    return (\n      <BitkitLabelTooltip text={label} {...tooltipProps}>\n        <chakra.button\n          ref={ref as Ref<HTMLButtonElement>}\n          aria-label={label}\n          disabled={state === 'disabled' || state === 'skeleton'}\n          {...buttonRest}\n          css={recipe({ isDanger, size })}\n        >\n          <Skeleton loading={isSkeleton}>\n            <Icon size={iconSize} />\n          </Skeleton>\n        </chakra.button>\n      </BitkitLabelTooltip>\n    );\n  },\n);\n\nBitkitControlButton.displayName = 'BitkitControlButton';\n\nexport default BitkitControlButton;\n"],"mappings":";;;;;;AAgCA,IAAM,sBAAsB,YACzB,OAAO,QAAQ;CACd,MAAM,OAAO,MAAM;CACnB,MAAM,OAAO,MAAM,QAAQ;CAC3B,MAAM,SAAS,UAAU,EAAE,KAAK,gBAAgB,CAAC;CACjD,MAAM,WAAW,SAAS,SAAS,SAAS,OAAO,OAAO;CAC1D,MAAM,aAAa,MAAM,UAAU;CACnC,MAAM,aAAa,MAAM,UAAU;CACnC,MAAM,eAAe,cAAc;CAGnC,IAAI,MAAM,SAAS,KAAA,GAAW;EAC5B,MAAM,EACJ,MACA,MAAM,OACN,UACA,YACA,OACA,SACA,WACA,KACA,MAAM,OACN,OAAO,QACP,QACA,cACA,GAAG,eACD;EACJ,MAAM,kBAAkB,aAAa,WAAW;EAChD,MAAM,eAAe,aAAc,MAAM,GAAG,IAAI,wBAAwB,wBAAyB;EACjG,MAAM,cAAc,gBACf,MAAqC;GACpC,EAAE,eAAe;GACjB,EAAE,gBAAgB;EACpB,IACA;EACJ,MAAM,gBAAgB,gBACjB,MAAwC;GACvC,IAAI,EAAE,QAAQ,WAAW,EAAE,QAAQ,KAAK;IACtC,EAAE,eAAe;IACjB,EAAE,gBAAgB;GACpB;EACF,IACA;EACJ,OACE,oBAAC,oBAAD;GAAoB,MAAM;GAAO,GAAI;aACnC,oBAAC,OAAO,GAAR;IACO;IACL,iBAAe,gBAAgB,KAAA;IAC/B,cAAY;IACZ,GAAI;IACJ,KAAK,OAAO;KAAE;KAAU;IAAK,CAAC;IAC9B,MAAM,eAAe,KAAA,IAAY;IACjC,SAAS;IACT,WAAW;IACX,KAAK;IACL,QAAQ;cAER,oBAAC,UAAD;KAAU,SAAS;eACjB,oBAAC,MAAD,EAAM,MAAM,SAAW,CAAA;IACf,CAAA;GACF,CAAA;EACQ,CAAA;CAExB;CAGA,MAAM,EAAE,MAAM,OAAO,UAAU,OAAO,MAAM,OAAO,OAAO,cAAc,GAAG,eAAe;CAC1F,OACE,oBAAC,oBAAD;EAAoB,MAAM;EAAO,GAAI;YACnC,oBAAC,OAAO,QAAR;GACO;GACL,cAAY;GACZ,UAAU,UAAU,cAAc,UAAU;GAC5C,GAAI;GACJ,KAAK,OAAO;IAAE;IAAU;GAAK,CAAC;aAE9B,oBAAC,UAAD;IAAU,SAAS;cACjB,oBAAC,MAAD,EAAM,MAAM,SAAW,CAAA;GACf,CAAA;EACG,CAAA;CACG,CAAA;AAExB,CACF;AAEA,oBAAoB,cAAc"}

package/dist/components/BitkitIconButton/BitkitIconButton.d.ts

@@ -1,11 +1,33 @@
 import { IconButtonProps } from '@chakra-ui/react/button';
+import { HTMLChakraProps, RecipeProps } from '@chakra-ui/react/styled-system';
+import { ReactElement } from 'react';
 import { BitkitIconComponent } from '../../icons';
 import { BitkitLabelTooltipProps } from '../BitkitLabelTooltip/BitkitLabelTooltip';
-export interface BitkitIconButtonProps extends Omit<IconButtonProps, 'aria-label' | 'children' | 'colorPalette' | 'disabled' | 'loading' | 'loadingText' | 'spinner' | 'spinnerPlacement'> {
+type BitkitIconButtonOmittedFromButton = 'aria-label' | 'asChild' | 'children' | 'colorPalette' | 'disabled' | 'loading' | 'loadingText' | 'spinner' | 'spinnerPlacement';
+interface BitkitIconButtonCommonProps {
     icon: BitkitIconComponent;
     label: string;
-    state?: 'disabled' | 'loading' | 'skeleton';
     tooltipProps?: Partial<Omit<BitkitLabelTooltipProps, 'children' | 'text'>>;
 }
-declare const BitkitIconButton: import('react').ForwardRefExoticComponent<BitkitIconButtonProps & import('react').RefAttributes<HTMLButtonElement>>;
+interface BitkitIconButtonAsButtonProps extends BitkitIconButtonCommonProps, Omit<IconButtonProps, BitkitIconButtonOmittedFromButton> {
+    asChild?: false;
+    href?: undefined;
+    isExternal?: undefined;
+    state?: 'disabled' | 'loading' | 'skeleton';
+}
+interface BitkitIconButtonAsAnchorProps extends BitkitIconButtonCommonProps, Omit<HTMLChakraProps<'a'>, 'aria-label' | 'children' | 'colorPalette'>, RecipeProps<'button'> {
+    asChild?: false;
+    href: string;
+    isExternal?: boolean;
+    state?: 'disabled' | 'skeleton';
+}
+interface BitkitIconButtonAsChildProps extends BitkitIconButtonCommonProps, Omit<IconButtonProps, BitkitIconButtonOmittedFromButton> {
+    asChild: true;
+    children: ReactElement;
+    href?: undefined;
+    isExternal?: undefined;
+    state?: 'disabled' | 'loading' | 'skeleton';
+}
+export type BitkitIconButtonProps = BitkitIconButtonAsButtonProps | BitkitIconButtonAsAnchorProps | BitkitIconButtonAsChildProps;
+declare const BitkitIconButton: import('react').ForwardRefExoticComponent<BitkitIconButtonProps & import('react').RefAttributes<HTMLElement>>;
 export default BitkitIconButton;

package/dist/components/BitkitIconButton/BitkitIconButton.js

@@ -1,25 +1,98 @@
 import BitkitLabelTooltip from "../BitkitLabelTooltip/BitkitLabelTooltip.js";
-import { forwardRef } from "react";
+import { chakra, useRecipe } from "@chakra-ui/react/styled-system";
+import { Children, cloneElement, forwardRef } from "react";
 import { jsx } from "react/jsx-runtime";
 import { Skeleton } from "@chakra-ui/react/skeleton";
 import { IconButton } from "@chakra-ui/react/button";
 //#region lib/components/BitkitIconButton/BitkitIconButton.tsx
 var BitkitIconButton = forwardRef((props, ref) => {
-	const { icon: Icon, label, size, state, tooltipProps, ...rest } = props;
-	const iconSize = size === "lg" ? "24" : "16";
+	const buttonRecipe = useRecipe({ key: "button" });
+	const Icon = props.icon;
+	const iconSize = props.size === "lg" ? "24" : "16";
+	const isDisabled = props.state === "disabled";
+	const isSkeleton = props.state === "skeleton";
+	if (props.asChild) {
+		const { asChild: _asChild, children, icon: _icon, label, state, tooltipProps, ...buttonRest } = props;
+		const onlyChild = Children.only(children);
+		const iconButtonElement = /* @__PURE__ */ jsx(IconButton, {
+			asChild: true,
+			"aria-label": label,
+			disabled: isDisabled,
+			loading: state === "loading",
+			ref,
+			...buttonRest,
+			children: cloneElement(onlyChild, { "aria-label": onlyChild.props["aria-label"] ?? label }, /* @__PURE__ */ jsx(Icon, { size: iconSize }))
+		});
+		return /* @__PURE__ */ jsx(BitkitLabelTooltip, {
+			text: label,
+			...tooltipProps,
+			children: isSkeleton ? /* @__PURE__ */ jsx(Skeleton, {
+				asChild: true,
+				loading: true,
+				children: iconButtonElement
+			}) : iconButtonElement
+		});
+	}
+	if (props.href !== void 0) {
+		const { css, href, icon: _icon, isExternal, label, onClick, onKeyDown, rel, size, state: _state, target, tooltipProps, variant, ...anchorRest } = props;
+		const effectiveTarget = isExternal ? "_blank" : target;
+		const effectiveRel = isExternal ? rel ? `${rel} noreferrer noopener` : "noreferrer noopener" : rel;
+		const handleClick = isDisabled ? (e) => {
+			e.preventDefault();
+			e.stopPropagation();
+		} : onClick;
+		const handleKeyDown = isDisabled ? (e) => {
+			if (e.key === "Enter" || e.key === " ") {
+				e.preventDefault();
+				e.stopPropagation();
+			}
+		} : onKeyDown;
+		const anchorElement = /* @__PURE__ */ jsx(chakra.a, {
+			ref,
+			...anchorRest,
+			"aria-disabled": isDisabled || void 0,
+			"aria-label": label,
+			css: [
+				buttonRecipe({
+					size,
+					variant
+				}),
+				{
+					paddingBlock: 0,
+					paddingInline: 0
+				},
+				css
+			],
+			href: isDisabled ? void 0 : href,
+			onClick: handleClick,
+			onKeyDown: handleKeyDown,
+			rel: effectiveRel,
+			target: effectiveTarget,
+			children: /* @__PURE__ */ jsx(Icon, { size: iconSize })
+		});
+		return /* @__PURE__ */ jsx(BitkitLabelTooltip, {
+			text: label,
+			...tooltipProps,
+			children: isSkeleton ? /* @__PURE__ */ jsx(Skeleton, {
+				asChild: true,
+				loading: true,
+				children: anchorElement
+			}) : anchorElement
+		});
+	}
+	const { icon: _icon, label, state, tooltipProps, ...buttonRest } = props;
 	return /* @__PURE__ */ jsx(BitkitLabelTooltip, {
 		text: label,
 		...tooltipProps,
 		children: /* @__PURE__ */ jsx(Skeleton, {
 			asChild: true,
-			loading: state === "skeleton",
+			loading: isSkeleton,
 			children: /* @__PURE__ */ jsx(IconButton, {
 				"aria-label": label,
-				disabled: state === "disabled",
+				disabled: isDisabled,
 				loading: state === "loading",
 				ref,
-				size,
-				...rest,
+				...buttonRest,
 				children: /* @__PURE__ */ jsx(Icon, { size: iconSize })
 			})
 		})

package/dist/components/BitkitIconButton/BitkitIconButton.js.map

@@ -1 +1 @@
-{"version":3,"file":"BitkitIconButton.js","names":[],"sources":["../../../lib/components/BitkitIconButton/BitkitIconButton.tsx"],"sourcesContent":["import { IconButton, type IconButtonProps } from '@chakra-ui/react/button';\nimport { Skeleton } from '@chakra-ui/react/skeleton';\nimport { forwardRef } from 'react';\n\nimport { type BitkitIconComponent } from '../../icons';\nimport BitkitLabelTooltip, { type BitkitLabelTooltipProps } from '../BitkitLabelTooltip/BitkitLabelTooltip';\n\nexport interface BitkitIconButtonProps extends Omit<\n  IconButtonProps,\n  'aria-label' | 'children' | 'colorPalette' | 'disabled' | 'loading' | 'loadingText' | 'spinner' | 'spinnerPlacement'\n> {\n  icon: BitkitIconComponent;\n  label: string;\n  state?: 'disabled' | 'loading' | 'skeleton';\n  tooltipProps?: Partial<Omit<BitkitLabelTooltipProps, 'children' | 'text'>>;\n}\n\nconst BitkitIconButton = forwardRef<HTMLButtonElement, BitkitIconButtonProps>((props, ref) => {\n  const { icon: Icon, label, size, state, tooltipProps, ...rest } = props;\n  const iconSize = size === 'lg' ? '24' : '16';\n\n  return (\n    <BitkitLabelTooltip text={label} {...tooltipProps}>\n      <Skeleton asChild loading={state === 'skeleton'}>\n        <IconButton\n          aria-label={label}\n          disabled={state === 'disabled'}\n          loading={state === 'loading'}\n          ref={ref}\n          size={size}\n          {...rest}\n        >\n          <Icon size={iconSize} />\n        </IconButton>\n      </Skeleton>\n    </BitkitLabelTooltip>\n  );\n});\n\nBitkitIconButton.displayName = 'BitkitIconButton';\n\nexport default BitkitIconButton;\n"],"mappings":";;;;;;AAiBA,IAAM,mBAAmB,YAAsD,OAAO,QAAQ;CAC5F,MAAM,EAAE,MAAM,MAAM,OAAO,MAAM,OAAO,cAAc,GAAG,SAAS;CAClE,MAAM,WAAW,SAAS,OAAO,OAAO;CAExC,OACE,oBAAC,oBAAD;EAAoB,MAAM;EAAO,GAAI;YACnC,oBAAC,UAAD;GAAU,SAAA;GAAQ,SAAS,UAAU;aACnC,oBAAC,YAAD;IACE,cAAY;IACZ,UAAU,UAAU;IACpB,SAAS,UAAU;IACd;IACC;IACN,GAAI;cAEJ,oBAAC,MAAD,EAAM,MAAM,SAAW,CAAA;GACb,CAAA;EACJ,CAAA;CACQ,CAAA;AAExB,CAAC;AAED,iBAAiB,cAAc"}
+{"version":3,"file":"BitkitIconButton.js","names":[],"sources":["../../../lib/components/BitkitIconButton/BitkitIconButton.tsx"],"sourcesContent":["import { IconButton, type IconButtonProps } from '@chakra-ui/react/button';\nimport { Skeleton } from '@chakra-ui/react/skeleton';\nimport { chakra, type HTMLChakraProps, type RecipeProps, useRecipe } from '@chakra-ui/react/styled-system';\nimport {\n  Children,\n  cloneElement,\n  forwardRef,\n  type KeyboardEvent,\n  type MouseEvent,\n  type ReactElement,\n  type Ref,\n} from 'react';\n\nimport { type BitkitIconComponent } from '../../icons';\nimport BitkitLabelTooltip, { type BitkitLabelTooltipProps } from '../BitkitLabelTooltip/BitkitLabelTooltip';\n\ntype BitkitIconButtonOmittedFromButton =\n  | 'aria-label'\n  | 'asChild'\n  | 'children'\n  | 'colorPalette'\n  | 'disabled'\n  | 'loading'\n  | 'loadingText'\n  | 'spinner'\n  | 'spinnerPlacement';\n\ninterface BitkitIconButtonCommonProps {\n  icon: BitkitIconComponent;\n  label: string;\n  tooltipProps?: Partial<Omit<BitkitLabelTooltipProps, 'children' | 'text'>>;\n}\n\ninterface BitkitIconButtonAsButtonProps\n  extends BitkitIconButtonCommonProps, Omit<IconButtonProps, BitkitIconButtonOmittedFromButton> {\n  asChild?: false;\n  href?: undefined;\n  isExternal?: undefined;\n  state?: 'disabled' | 'loading' | 'skeleton';\n}\n\ninterface BitkitIconButtonAsAnchorProps\n  extends\n    BitkitIconButtonCommonProps,\n    Omit<HTMLChakraProps<'a'>, 'aria-label' | 'children' | 'colorPalette'>,\n    RecipeProps<'button'> {\n  asChild?: false;\n  href: string;\n  isExternal?: boolean;\n  state?: 'disabled' | 'skeleton';\n}\n\ninterface BitkitIconButtonAsChildProps\n  extends BitkitIconButtonCommonProps, Omit<IconButtonProps, BitkitIconButtonOmittedFromButton> {\n  asChild: true;\n  children: ReactElement;\n  href?: undefined;\n  isExternal?: undefined;\n  state?: 'disabled' | 'loading' | 'skeleton';\n}\n\nexport type BitkitIconButtonProps =\n  | BitkitIconButtonAsButtonProps\n  | BitkitIconButtonAsAnchorProps\n  | BitkitIconButtonAsChildProps;\n\n// The forwarded ref is typed as HTMLElement to cover all three modes (button, anchor, slot/asChild),\n// since asChild can render any element (router Link, custom wrappers, etc.). Inner narrow casts\n// satisfy the wrapped Chakra components without affecting the consumer-visible ref shape.\nconst BitkitIconButton = forwardRef<HTMLElement, BitkitIconButtonProps>((props, ref) => {\n  const buttonRecipe = useRecipe({ key: 'button' });\n  const Icon = props.icon;\n  const iconSize = props.size === 'lg' ? '24' : '16';\n  const isDisabled = props.state === 'disabled';\n  const isSkeleton = props.state === 'skeleton';\n\n  // --- Slot mode (asChild) ---\n  if (props.asChild) {\n    const { asChild: _asChild, children, icon: _icon, label, state, tooltipProps, ...buttonRest } = props;\n    const onlyChild = Children.only(children) as ReactElement<{ 'aria-label'?: string }>;\n    const iconButtonElement = (\n      <IconButton\n        asChild\n        aria-label={label}\n        disabled={isDisabled}\n        loading={state === 'loading'}\n        ref={ref as Ref<HTMLButtonElement>}\n        {...buttonRest}\n      >\n        {cloneElement(onlyChild, { 'aria-label': onlyChild.props['aria-label'] ?? label }, <Icon size={iconSize} />)}\n      </IconButton>\n    );\n    return (\n      <BitkitLabelTooltip text={label} {...tooltipProps}>\n        {isSkeleton ? (\n          <Skeleton asChild loading>\n            {iconButtonElement}\n          </Skeleton>\n        ) : (\n          iconButtonElement\n        )}\n      </BitkitLabelTooltip>\n    );\n  }\n\n  // --- Anchor mode (href) ---\n  if (props.href !== undefined) {\n    const {\n      css,\n      href,\n      icon: _icon,\n      isExternal,\n      label,\n      onClick,\n      onKeyDown,\n      rel,\n      size,\n      state: _state,\n      target,\n      tooltipProps,\n      variant,\n      ...anchorRest\n    } = props;\n    const effectiveTarget = isExternal ? '_blank' : target;\n    const effectiveRel = isExternal ? (rel ? `${rel} noreferrer noopener` : 'noreferrer noopener') : rel;\n    const handleClick = isDisabled\n      ? (e: MouseEvent<HTMLAnchorElement>) => {\n          e.preventDefault();\n          e.stopPropagation();\n        }\n      : onClick;\n    const handleKeyDown = isDisabled\n      ? (e: KeyboardEvent<HTMLAnchorElement>) => {\n          if (e.key === 'Enter' || e.key === ' ') {\n            e.preventDefault();\n            e.stopPropagation();\n          }\n        }\n      : onKeyDown;\n    const anchorElement = (\n      <chakra.a\n        ref={ref as Ref<HTMLAnchorElement>}\n        {...anchorRest}\n        aria-disabled={isDisabled || undefined}\n        aria-label={label}\n        css={[buttonRecipe({ size, variant }), { paddingBlock: 0, paddingInline: 0 }, css]}\n        href={isDisabled ? undefined : href}\n        onClick={handleClick}\n        onKeyDown={handleKeyDown}\n        rel={effectiveRel}\n        target={effectiveTarget}\n      >\n        <Icon size={iconSize} />\n      </chakra.a>\n    );\n    return (\n      <BitkitLabelTooltip text={label} {...tooltipProps}>\n        {isSkeleton ? (\n          <Skeleton asChild loading>\n            {anchorElement}\n          </Skeleton>\n        ) : (\n          anchorElement\n        )}\n      </BitkitLabelTooltip>\n    );\n  }\n\n  // --- Button mode (default) ---\n  const { icon: _icon, label, state, tooltipProps, ...buttonRest } = props;\n  return (\n    <BitkitLabelTooltip text={label} {...tooltipProps}>\n      <Skeleton asChild loading={isSkeleton}>\n        <IconButton\n          aria-label={label}\n          disabled={isDisabled}\n          loading={state === 'loading'}\n          ref={ref as Ref<HTMLButtonElement>}\n          {...buttonRest}\n        >\n          <Icon size={iconSize} />\n        </IconButton>\n      </Skeleton>\n    </BitkitLabelTooltip>\n  );\n});\n\nBitkitIconButton.displayName = 'BitkitIconButton';\n\nexport default BitkitIconButton;\n"],"mappings":";;;;;;;AAqEA,IAAM,mBAAmB,YAAgD,OAAO,QAAQ;CACtF,MAAM,eAAe,UAAU,EAAE,KAAK,SAAS,CAAC;CAChD,MAAM,OAAO,MAAM;CACnB,MAAM,WAAW,MAAM,SAAS,OAAO,OAAO;CAC9C,MAAM,aAAa,MAAM,UAAU;CACnC,MAAM,aAAa,MAAM,UAAU;CAGnC,IAAI,MAAM,SAAS;EACjB,MAAM,EAAE,SAAS,UAAU,UAAU,MAAM,OAAO,OAAO,OAAO,cAAc,GAAG,eAAe;EAChG,MAAM,YAAY,SAAS,KAAK,QAAQ;EACxC,MAAM,oBACJ,oBAAC,YAAD;GACE,SAAA;GACA,cAAY;GACZ,UAAU;GACV,SAAS,UAAU;GACd;GACL,GAAI;aAEH,aAAa,WAAW,EAAE,cAAc,UAAU,MAAM,iBAAiB,MAAM,GAAG,oBAAC,MAAD,EAAM,MAAM,SAAW,CAAA,CAAC;EACjG,CAAA;EAEd,OACE,oBAAC,oBAAD;GAAoB,MAAM;GAAO,GAAI;aAClC,aACC,oBAAC,UAAD;IAAU,SAAA;IAAQ,SAAA;cACf;GACO,CAAA,IAEV;EAEgB,CAAA;CAExB;CAGA,IAAI,MAAM,SAAS,KAAA,GAAW;EAC5B,MAAM,EACJ,KACA,MACA,MAAM,OACN,YACA,OACA,SACA,WACA,KACA,MACA,OAAO,QACP,QACA,cACA,SACA,GAAG,eACD;EACJ,MAAM,kBAAkB,aAAa,WAAW;EAChD,MAAM,eAAe,aAAc,MAAM,GAAG,IAAI,wBAAwB,wBAAyB;EACjG,MAAM,cAAc,cACf,MAAqC;GACpC,EAAE,eAAe;GACjB,EAAE,gBAAgB;EACpB,IACA;EACJ,MAAM,gBAAgB,cACjB,MAAwC;GACvC,IAAI,EAAE,QAAQ,WAAW,EAAE,QAAQ,KAAK;IACtC,EAAE,eAAe;IACjB,EAAE,gBAAgB;GACpB;EACF,IACA;EACJ,MAAM,gBACJ,oBAAC,OAAO,GAAR;GACO;GACL,GAAI;GACJ,iBAAe,cAAc,KAAA;GAC7B,cAAY;GACZ,KAAK;IAAC,aAAa;KAAE;KAAM;IAAQ,CAAC;IAAG;KAAE,cAAc;KAAG,eAAe;IAAE;IAAG;GAAG;GACjF,MAAM,aAAa,KAAA,IAAY;GAC/B,SAAS;GACT,WAAW;GACX,KAAK;GACL,QAAQ;aAER,oBAAC,MAAD,EAAM,MAAM,SAAW,CAAA;EACf,CAAA;EAEZ,OACE,oBAAC,oBAAD;GAAoB,MAAM;GAAO,GAAI;aAClC,aACC,oBAAC,UAAD;IAAU,SAAA;IAAQ,SAAA;cACf;GACO,CAAA,IAEV;EAEgB,CAAA;CAExB;CAGA,MAAM,EAAE,MAAM,OAAO,OAAO,OAAO,cAAc,GAAG,eAAe;CACnE,OACE,oBAAC,oBAAD;EAAoB,MAAM;EAAO,GAAI;YACnC,oBAAC,UAAD;GAAU,SAAA;GAAQ,SAAS;aACzB,oBAAC,YAAD;IACE,cAAY;IACZ,UAAU;IACV,SAAS,UAAU;IACd;IACL,GAAI;cAEJ,oBAAC,MAAD,EAAM,MAAM,SAAW,CAAA;GACb,CAAA;EACJ,CAAA;CACQ,CAAA;AAExB,CAAC;AAED,iBAAiB,cAAc"}

package/dist/components/BitkitLink/BitkitLink.d.ts

@@ -2,6 +2,7 @@ import { LinkProps } from '@chakra-ui/react/link';
 import { ComponentPropsWithoutRef } from 'react';
 import { BitkitIconComponent } from '../../icons';
 export interface BitkitLinkProps extends LinkProps {
+    isExternal?: boolean;
     suffixIcon?: BitkitIconComponent;
     suffixIconSize?: ComponentPropsWithoutRef<BitkitIconComponent>['size'];
     state?: 'disabled';

package/dist/components/BitkitLink/BitkitLink.js

@@ -3,11 +3,26 @@ import { jsx, jsxs } from "react/jsx-runtime";
 import { Link } from "@chakra-ui/react/link";
 //#region lib/components/BitkitLink/BitkitLink.tsx
 var BitkitLink = forwardRef((props, ref) => {
-	const { children, href, suffixIcon: SuffixIcon, suffixIconSize, state, ...rest } = props;
+	const { children, href, isExternal, onClick, onKeyDown, rel, suffixIcon: SuffixIcon, suffixIconSize, state, target, ...rest } = props;
+	const isDisabled = state === "disabled";
+	const effectiveTarget = isExternal ? "_blank" : target;
+	const effectiveRel = isExternal ? rel ? `${rel} noreferrer noopener` : "noreferrer noopener" : rel;
 	return /* @__PURE__ */ jsxs(Link, {
-		"aria-disabled": state === "disabled" ? true : void 0,
-		href: state === "disabled" ? void 0 : href,
+		"aria-disabled": isDisabled || void 0,
+		href: isDisabled ? void 0 : href,
+		onClick: isDisabled ? (e) => {
+			e.preventDefault();
+			e.stopPropagation();
+		} : onClick,
+		onKeyDown: isDisabled ? (e) => {
+			if (e.key === "Enter" || e.key === " ") {
+				e.preventDefault();
+				e.stopPropagation();
+			}
+		} : onKeyDown,
 		ref,
+		rel: effectiveRel,
+		target: effectiveTarget,
 		...rest,
 		children: [children, SuffixIcon && (suffixIconSize ? /* @__PURE__ */ jsx(SuffixIcon, { size: suffixIconSize }) : /* @__PURE__ */ jsx(SuffixIcon, { css: {
 			height: "1lh",

package/dist/components/BitkitLink/BitkitLink.js.map

@@ -1 +1 @@
-{"version":3,"file":"BitkitLink.js","names":[],"sources":["../../../lib/components/BitkitLink/BitkitLink.tsx"],"sourcesContent":["import { Link, type LinkProps } from '@chakra-ui/react/link';\nimport { type ComponentPropsWithoutRef, forwardRef } from 'react';\n\nimport { type BitkitIconComponent } from '../../icons';\n\nexport interface BitkitLinkProps extends LinkProps {\n  suffixIcon?: BitkitIconComponent;\n  suffixIconSize?: ComponentPropsWithoutRef<BitkitIconComponent>['size'];\n  state?: 'disabled';\n}\n\nconst BitkitLink = forwardRef<HTMLAnchorElement, BitkitLinkProps>((props, ref) => {\n  const { children, href, suffixIcon: SuffixIcon, suffixIconSize, state, ...rest } = props;\n\n  return (\n    <Link\n      aria-disabled={state === 'disabled' ? true : undefined}\n      href={state === 'disabled' ? undefined : href}\n      ref={ref}\n      {...rest}\n    >\n      {children}\n      {SuffixIcon &&\n        (suffixIconSize ? <SuffixIcon size={suffixIconSize} /> : <SuffixIcon css={{ height: '1lh', width: '1lh' }} />)}\n    </Link>\n  );\n});\n\nBitkitLink.displayName = 'BitkitLink';\n\nexport default BitkitLink;\n"],"mappings":";;;;AAWA,IAAM,aAAa,YAAgD,OAAO,QAAQ;CAChF,MAAM,EAAE,UAAU,MAAM,YAAY,YAAY,gBAAgB,OAAO,GAAG,SAAS;CAEnF,OACE,qBAAC,MAAD;EACE,iBAAe,UAAU,aAAa,OAAO,KAAA;EAC7C,MAAM,UAAU,aAAa,KAAA,IAAY;EACpC;EACL,GAAI;YAJN,CAMG,UACA,eACE,iBAAiB,oBAAC,YAAD,EAAY,MAAM,eAAiB,CAAA,IAAI,oBAAC,YAAD,EAAY,KAAK;GAAE,QAAQ;GAAO,OAAO;EAAM,EAAI,CAAA,EAC1G;;AAEV,CAAC;AAED,WAAW,cAAc"}
+{"version":3,"file":"BitkitLink.js","names":[],"sources":["../../../lib/components/BitkitLink/BitkitLink.tsx"],"sourcesContent":["import { Link, type LinkProps } from '@chakra-ui/react/link';\nimport { type ComponentPropsWithoutRef, forwardRef, type KeyboardEvent, type MouseEvent } from 'react';\n\nimport { type BitkitIconComponent } from '../../icons';\n\nexport interface BitkitLinkProps extends LinkProps {\n  isExternal?: boolean;\n  suffixIcon?: BitkitIconComponent;\n  suffixIconSize?: ComponentPropsWithoutRef<BitkitIconComponent>['size'];\n  state?: 'disabled';\n}\n\nconst BitkitLink = forwardRef<HTMLAnchorElement, BitkitLinkProps>((props, ref) => {\n  const {\n    children,\n    href,\n    isExternal,\n    onClick,\n    onKeyDown,\n    rel,\n    suffixIcon: SuffixIcon,\n    suffixIconSize,\n    state,\n    target,\n    ...rest\n  } = props;\n  const isDisabled = state === 'disabled';\n  const effectiveTarget = isExternal ? '_blank' : target;\n  const effectiveRel = isExternal ? (rel ? `${rel} noreferrer noopener` : 'noreferrer noopener') : rel;\n  const handleClick = isDisabled\n    ? (e: MouseEvent<HTMLAnchorElement>) => {\n        e.preventDefault();\n        e.stopPropagation();\n      }\n    : onClick;\n  const handleKeyDown = isDisabled\n    ? (e: KeyboardEvent<HTMLAnchorElement>) => {\n        if (e.key === 'Enter' || e.key === ' ') {\n          e.preventDefault();\n          e.stopPropagation();\n        }\n      }\n    : onKeyDown;\n\n  return (\n    <Link\n      aria-disabled={isDisabled || undefined}\n      href={isDisabled ? undefined : href}\n      onClick={handleClick}\n      onKeyDown={handleKeyDown}\n      ref={ref}\n      rel={effectiveRel}\n      target={effectiveTarget}\n      {...rest}\n    >\n      {children}\n      {SuffixIcon &&\n        (suffixIconSize ? <SuffixIcon size={suffixIconSize} /> : <SuffixIcon css={{ height: '1lh', width: '1lh' }} />)}\n    </Link>\n  );\n});\n\nBitkitLink.displayName = 'BitkitLink';\n\nexport default BitkitLink;\n"],"mappings":";;;;AAYA,IAAM,aAAa,YAAgD,OAAO,QAAQ;CAChF,MAAM,EACJ,UACA,MACA,YACA,SACA,WACA,KACA,YAAY,YACZ,gBACA,OACA,QACA,GAAG,SACD;CACJ,MAAM,aAAa,UAAU;CAC7B,MAAM,kBAAkB,aAAa,WAAW;CAChD,MAAM,eAAe,aAAc,MAAM,GAAG,IAAI,wBAAwB,wBAAyB;CAgBjG,OACE,qBAAC,MAAD;EACE,iBAAe,cAAc,KAAA;EAC7B,MAAM,aAAa,KAAA,IAAY;EAC/B,SAnBgB,cACf,MAAqC;GACpC,EAAE,eAAe;GACjB,EAAE,gBAAgB;EACpB,IACA;EAeA,WAdkB,cACjB,MAAwC;GACvC,IAAI,EAAE,QAAQ,WAAW,EAAE,QAAQ,KAAK;IACtC,EAAE,eAAe;IACjB,EAAE,gBAAgB;GACpB;EACF,IACA;EAQK;EACL,KAAK;EACL,QAAQ;EACR,GAAI;YARN,CAUG,UACA,eACE,iBAAiB,oBAAC,YAAD,EAAY,MAAM,eAAiB,CAAA,IAAI,oBAAC,YAAD,EAAY,KAAK;GAAE,QAAQ;GAAO,OAAO;EAAM,EAAI,CAAA,EAC1G;;AAEV,CAAC;AAED,WAAW,cAAc"}

package/dist/components/BitkitNoteCard/BitkitNoteCard.js

@@ -32,19 +32,22 @@ var BitkitNoteCard = forwardRef((props, ref) => {
 					css: title ? styles.message : styles.messageSolo,
 					children: message
 				})]
-			}), action && /* @__PURE__ */ jsx(BitkitButton, {
+			}), action && (action.href !== void 0 ? /* @__PURE__ */ jsx(BitkitButton, {
 				css: styles.actionArea,
+				href: action.href,
+				onClick: action.onClick,
+				rel: action.target === "_blank" ? "noopener noreferrer" : void 0,
 				size: "sm",
+				target: action.target,
 				variant: "tertiary",
-				...action.href && {
-					as: "a",
-					href: action.href,
-					rel: action.target === "_blank" ? "noopener noreferrer" : void 0,
-					target: action.target
-				},
+				children: action.label
+			}) : /* @__PURE__ */ jsx(BitkitButton, {
+				css: styles.actionArea,
 				onClick: action.onClick,
+				size: "sm",
+				variant: "tertiary",
 				children: action.label
-			})]
+			}))]
 		})]
 	});
 });

package/dist/components/BitkitNoteCard/BitkitNoteCard.js.map

@@ -1 +1 @@
-{"version":3,"file":"BitkitNoteCard.js","names":[],"sources":["../../../lib/components/BitkitNoteCard/BitkitNoteCard.tsx"],"sourcesContent":["import { Box, type BoxProps } from '@chakra-ui/react/box';\nimport { useSlotRecipe } from '@chakra-ui/react/styled-system';\nimport { Text } from '@chakra-ui/react/text';\nimport { type ElementType, forwardRef, type ReactNode } from 'react';\n\nimport { type NotificationVariant } from '../../theme/common/AlertAndToast.common';\nimport BitkitButton from '../BitkitButton/BitkitButton';\nimport { ICON_COMPONENTS_MAP, type NotificationAction } from '../common/notificationMaps';\n\n// ----- Props -----\n\nexport type BitkitNoteCardProps = Omit<BoxProps, 'children' | 'title'> & {\n  action?: NotificationAction;\n  message: ReactNode;\n  status?: NotificationVariant;\n  title?: string;\n};\n\n// ----- Component -----\n\nconst BitkitNoteCard = forwardRef<HTMLDivElement, BitkitNoteCardProps>((props, ref) => {\n  const { action, message, status = 'info', title, ...rest } = props;\n\n  const recipe = useSlotRecipe({ key: 'noteCard' });\n  const styles = recipe({ status });\n\n  const IconComponent: ElementType = ICON_COMPONENTS_MAP[status];\n  const isProgress = status === 'progress';\n\n  return (\n    <Box ref={ref} css={styles.root} {...rest}>\n      <Box css={styles.iconBar}>\n        <Box css={styles.iconWrapper}>{isProgress ? <IconComponent size=\"lg\" /> : <IconComponent size=\"24\" />}</Box>\n      </Box>\n      <Box css={styles.content}>\n        <Box css={styles.messageBlock}>\n          {title && <Text css={styles.title}>{title}</Text>}\n          <Text css={title ? styles.message : styles.messageSolo}>{message}</Text>\n        </Box>\n        {action && (\n          <BitkitButton\n            css={styles.actionArea}\n            size=\"sm\"\n            variant=\"tertiary\"\n            {...(action.href && {\n              as: 'a' as const,\n              href: action.href,\n              rel: action.target === '_blank' ? 'noopener noreferrer' : undefined,\n              target: action.target,\n            })}\n            onClick={action.onClick}\n          >\n            {action.label}\n          </BitkitButton>\n        )}\n      </Box>\n    </Box>\n  );\n});\n\nBitkitNoteCard.displayName = 'BitkitNoteCard';\n\nexport default BitkitNoteCard;\n"],"mappings":";;;;;;;;AAoBA,IAAM,iBAAiB,YAAiD,OAAO,QAAQ;CACrF,MAAM,EAAE,QAAQ,SAAS,SAAS,QAAQ,OAAO,GAAG,SAAS;CAG7D,MAAM,SADS,cAAc,EAAE,KAAK,WAAW,CAChC,EAAO,EAAE,OAAO,CAAC;CAEhC,MAAM,gBAA6B,oBAAoB;CACvD,MAAM,aAAa,WAAW;CAE9B,OACE,qBAAC,KAAD;EAAU;EAAK,KAAK,OAAO;EAAM,GAAI;YAArC,CACE,oBAAC,KAAD;GAAK,KAAK,OAAO;aACf,oBAAC,KAAD;IAAK,KAAK,OAAO;cAAc,aAAa,oBAAC,eAAD,EAAe,MAAK,KAAM,CAAA,IAAI,oBAAC,eAAD,EAAe,MAAK,KAAM,CAAA;GAAO,CAAA;EACxG,CAAA,GACL,qBAAC,KAAD;GAAK,KAAK,OAAO;aAAjB,CACE,qBAAC,KAAD;IAAK,KAAK,OAAO;cAAjB,CACG,SAAS,oBAAC,MAAD;KAAM,KAAK,OAAO;eAAQ;IAAY,CAAA,GAChD,oBAAC,MAAD;KAAM,KAAK,QAAQ,OAAO,UAAU,OAAO;eAAc;IAAc,CAAA,CACpE;OACJ,UACC,oBAAC,cAAD;IACE,KAAK,OAAO;IACZ,MAAK;IACL,SAAQ;IACR,GAAK,OAAO,QAAQ;KAClB,IAAI;KACJ,MAAM,OAAO;KACb,KAAK,OAAO,WAAW,WAAW,wBAAwB,KAAA;KAC1D,QAAQ,OAAO;IACjB;IACA,SAAS,OAAO;cAEf,OAAO;GACI,CAAA,CAEb;IACF;;AAET,CAAC;AAED,eAAe,cAAc"}
+{"version":3,"file":"BitkitNoteCard.js","names":[],"sources":["../../../lib/components/BitkitNoteCard/BitkitNoteCard.tsx"],"sourcesContent":["import { Box, type BoxProps } from '@chakra-ui/react/box';\nimport { useSlotRecipe } from '@chakra-ui/react/styled-system';\nimport { Text } from '@chakra-ui/react/text';\nimport { type ElementType, forwardRef, type ReactNode } from 'react';\n\nimport { type NotificationVariant } from '../../theme/common/AlertAndToast.common';\nimport BitkitButton from '../BitkitButton/BitkitButton';\nimport { ICON_COMPONENTS_MAP, type NotificationAction } from '../common/notificationMaps';\n\n// ----- Props -----\n\nexport type BitkitNoteCardProps = Omit<BoxProps, 'children' | 'title'> & {\n  action?: NotificationAction;\n  message: ReactNode;\n  status?: NotificationVariant;\n  title?: string;\n};\n\n// ----- Component -----\n\nconst BitkitNoteCard = forwardRef<HTMLDivElement, BitkitNoteCardProps>((props, ref) => {\n  const { action, message, status = 'info', title, ...rest } = props;\n\n  const recipe = useSlotRecipe({ key: 'noteCard' });\n  const styles = recipe({ status });\n\n  const IconComponent: ElementType = ICON_COMPONENTS_MAP[status];\n  const isProgress = status === 'progress';\n\n  return (\n    <Box ref={ref} css={styles.root} {...rest}>\n      <Box css={styles.iconBar}>\n        <Box css={styles.iconWrapper}>{isProgress ? <IconComponent size=\"lg\" /> : <IconComponent size=\"24\" />}</Box>\n      </Box>\n      <Box css={styles.content}>\n        <Box css={styles.messageBlock}>\n          {title && <Text css={styles.title}>{title}</Text>}\n          <Text css={title ? styles.message : styles.messageSolo}>{message}</Text>\n        </Box>\n        {action &&\n          (action.href !== undefined ? (\n            <BitkitButton\n              css={styles.actionArea}\n              href={action.href}\n              onClick={action.onClick}\n              rel={action.target === '_blank' ? 'noopener noreferrer' : undefined}\n              size=\"sm\"\n              target={action.target}\n              variant=\"tertiary\"\n            >\n              {action.label}\n            </BitkitButton>\n          ) : (\n            <BitkitButton css={styles.actionArea} onClick={action.onClick} size=\"sm\" variant=\"tertiary\">\n              {action.label}\n            </BitkitButton>\n          ))}\n      </Box>\n    </Box>\n  );\n});\n\nBitkitNoteCard.displayName = 'BitkitNoteCard';\n\nexport default BitkitNoteCard;\n"],"mappings":";;;;;;;;AAoBA,IAAM,iBAAiB,YAAiD,OAAO,QAAQ;CACrF,MAAM,EAAE,QAAQ,SAAS,SAAS,QAAQ,OAAO,GAAG,SAAS;CAG7D,MAAM,SADS,cAAc,EAAE,KAAK,WAAW,CAChC,EAAO,EAAE,OAAO,CAAC;CAEhC,MAAM,gBAA6B,oBAAoB;CACvD,MAAM,aAAa,WAAW;CAE9B,OACE,qBAAC,KAAD;EAAU;EAAK,KAAK,OAAO;EAAM,GAAI;YAArC,CACE,oBAAC,KAAD;GAAK,KAAK,OAAO;aACf,oBAAC,KAAD;IAAK,KAAK,OAAO;cAAc,aAAa,oBAAC,eAAD,EAAe,MAAK,KAAM,CAAA,IAAI,oBAAC,eAAD,EAAe,MAAK,KAAM,CAAA;GAAO,CAAA;EACxG,CAAA,GACL,qBAAC,KAAD;GAAK,KAAK,OAAO;aAAjB,CACE,qBAAC,KAAD;IAAK,KAAK,OAAO;cAAjB,CACG,SAAS,oBAAC,MAAD;KAAM,KAAK,OAAO;eAAQ;IAAY,CAAA,GAChD,oBAAC,MAAD;KAAM,KAAK,QAAQ,OAAO,UAAU,OAAO;eAAc;IAAc,CAAA,CACpE;OACJ,WACE,OAAO,SAAS,KAAA,IACf,oBAAC,cAAD;IACE,KAAK,OAAO;IACZ,MAAM,OAAO;IACb,SAAS,OAAO;IAChB,KAAK,OAAO,WAAW,WAAW,wBAAwB,KAAA;IAC1D,MAAK;IACL,QAAQ,OAAO;IACf,SAAQ;cAEP,OAAO;GACI,CAAA,IAEd,oBAAC,cAAD;IAAc,KAAK,OAAO;IAAY,SAAS,OAAO;IAAS,MAAK;IAAK,SAAQ;cAC9E,OAAO;GACI,CAAA,EAEf;IACF;;AAET,CAAC;AAED,eAAe,cAAc"}

package/dist/components/BitkitRadioGroup/BitkitRadioGroup.d.ts

@@ -4,8 +4,12 @@ import { ReactNode } from 'react';
 export interface BitkitRadioGroupProps extends Fieldset.RootProps {
     children: ReactNode;
     errorText?: string;
+    /**
+     * Visible legend rendered above the group. Optional — if you omit it, pass `aria-label` or
+     * `aria-labelledby` instead so the fieldset still has an accessible name.
+     */
+    groupLabel?: string;
     helperText?: string;
-    label: string;
     layout?: RadioGroupRootProps['orientation'];
     name?: RadioGroupRootProps['name'];
     onValueChange: RadioGroupRootProps['onValueChange'];

package/dist/components/BitkitRadioGroup/BitkitRadioGroup.js

@@ -4,16 +4,17 @@ import { Fieldset } from "@chakra-ui/react/fieldset";
 import { RadioGroup } from "@chakra-ui/react/radio-group";
 //#region lib/components/BitkitRadioGroup/BitkitRadioGroup.tsx
 var BitkitRadioGroup = forwardRef((props, ref) => {
-	const { children, errorText, helperText, label, layout, name, onValueChange, radioGroupRootProps, size, value, ...rest } = props;
+	const { children, errorText, helperText, groupLabel, layout, name, onValueChange, radioGroupRootProps, size, value, ...rest } = props;
+	const hasHeader = !!groupLabel || !!helperText;
 	return /* @__PURE__ */ jsxs(Fieldset.Root, {
 		ref,
 		...rest,
 		invalid: rest.invalid || !!errorText,
 		children: [
-			/* @__PURE__ */ jsx(Fieldset.Legend, { children: label }),
+			groupLabel && /* @__PURE__ */ jsx(Fieldset.Legend, { children: groupLabel }),
 			!!helperText && /* @__PURE__ */ jsx(Fieldset.HelperText, { children: helperText }),
 			/* @__PURE__ */ jsx(Fieldset.Content, {
-				marginBlockStart: "12",
+				marginBlockStart: hasHeader ? "12" : void 0,
 				asChild: true,
 				children: /* @__PURE__ */ jsx(RadioGroup.Root, {
 					name,

package/dist/components/BitkitRadioGroup/BitkitRadioGroup.js.map

@@ -1 +1 @@
-{"version":3,"file":"BitkitRadioGroup.js","names":[],"sources":["../../../lib/components/BitkitRadioGroup/BitkitRadioGroup.tsx"],"sourcesContent":["import { Fieldset } from '@chakra-ui/react/fieldset';\nimport { RadioGroup, type RadioGroupRootProps } from '@chakra-ui/react/radio-group';\nimport { forwardRef, type ReactNode } from 'react';\n\nexport interface BitkitRadioGroupProps extends Fieldset.RootProps {\n  children: ReactNode;\n  errorText?: string;\n  helperText?: string;\n  label: string;\n  layout?: RadioGroupRootProps['orientation'];\n  name?: RadioGroupRootProps['name'];\n  onValueChange: RadioGroupRootProps['onValueChange'];\n  radioGroupRootProps?: RadioGroupRootProps;\n  size?: RadioGroupRootProps['size'];\n  value: RadioGroupRootProps['value'];\n}\n\nconst BitkitRadioGroup = forwardRef<HTMLFieldSetElement, BitkitRadioGroupProps>((props, ref) => {\n  const {\n    children,\n    errorText,\n    helperText,\n    label,\n    layout,\n    name,\n    onValueChange,\n    radioGroupRootProps,\n    size,\n    value,\n    ...rest\n  } = props;\n  return (\n    <Fieldset.Root ref={ref} {...rest} invalid={rest.invalid || !!errorText}>\n      <Fieldset.Legend>{label}</Fieldset.Legend>\n      {!!helperText && <Fieldset.HelperText>{helperText}</Fieldset.HelperText>}\n      <Fieldset.Content marginBlockStart=\"12\" asChild>\n        <RadioGroup.Root\n          name={name}\n          size={size}\n          orientation={layout}\n          onValueChange={onValueChange}\n          value={value}\n          {...radioGroupRootProps}\n        >\n          {children}\n        </RadioGroup.Root>\n      </Fieldset.Content>\n      {!!errorText && <Fieldset.ErrorText>{errorText}</Fieldset.ErrorText>}\n    </Fieldset.Root>\n  );\n});\n\nBitkitRadioGroup.displayName = 'BitkitRadioGroup';\n\nexport default BitkitRadioGroup;\n"],"mappings":";;;;;AAiBA,IAAM,mBAAmB,YAAwD,OAAO,QAAQ;CAC9F,MAAM,EACJ,UACA,WACA,YACA,OACA,QACA,MACA,eACA,qBACA,MACA,OACA,GAAG,SACD;CACJ,OACE,qBAAC,SAAS,MAAV;EAAoB;EAAK,GAAI;EAAM,SAAS,KAAK,WAAW,CAAC,CAAC;YAA9D;GACE,oBAAC,SAAS,QAAV,EAAA,UAAkB,MAAuB,CAAA;GACxC,CAAC,CAAC,cAAc,oBAAC,SAAS,YAAV,EAAA,UAAsB,WAAgC,CAAA;GACvE,oBAAC,SAAS,SAAV;IAAkB,kBAAiB;IAAK,SAAA;cACtC,oBAAC,WAAW,MAAZ;KACQ;KACA;KACN,aAAa;KACE;KACR;KACP,GAAI;KAEH;IACc,CAAA;GACD,CAAA;GACjB,CAAC,CAAC,aAAa,oBAAC,SAAS,WAAV,EAAA,UAAqB,UAA8B,CAAA;EACtD;;AAEnB,CAAC;AAED,iBAAiB,cAAc"}
+{"version":3,"file":"BitkitRadioGroup.js","names":[],"sources":["../../../lib/components/BitkitRadioGroup/BitkitRadioGroup.tsx"],"sourcesContent":["import { Fieldset } from '@chakra-ui/react/fieldset';\nimport { RadioGroup, type RadioGroupRootProps } from '@chakra-ui/react/radio-group';\nimport { forwardRef, type ReactNode } from 'react';\n\nexport interface BitkitRadioGroupProps extends Fieldset.RootProps {\n  children: ReactNode;\n  errorText?: string;\n  /**\n   * Visible legend rendered above the group. Optional — if you omit it, pass `aria-label` or\n   * `aria-labelledby` instead so the fieldset still has an accessible name.\n   */\n  groupLabel?: string;\n  helperText?: string;\n  layout?: RadioGroupRootProps['orientation'];\n  name?: RadioGroupRootProps['name'];\n  onValueChange: RadioGroupRootProps['onValueChange'];\n  radioGroupRootProps?: RadioGroupRootProps;\n  size?: RadioGroupRootProps['size'];\n  value: RadioGroupRootProps['value'];\n}\n\nconst BitkitRadioGroup = forwardRef<HTMLFieldSetElement, BitkitRadioGroupProps>((props, ref) => {\n  const {\n    children,\n    errorText,\n    helperText,\n    groupLabel,\n    layout,\n    name,\n    onValueChange,\n    radioGroupRootProps,\n    size,\n    value,\n    ...rest\n  } = props;\n  const hasHeader = !!groupLabel || !!helperText;\n  return (\n    <Fieldset.Root ref={ref} {...rest} invalid={rest.invalid || !!errorText}>\n      {groupLabel && <Fieldset.Legend>{groupLabel}</Fieldset.Legend>}\n      {!!helperText && <Fieldset.HelperText>{helperText}</Fieldset.HelperText>}\n      <Fieldset.Content marginBlockStart={hasHeader ? '12' : undefined} asChild>\n        <RadioGroup.Root\n          name={name}\n          size={size}\n          orientation={layout}\n          onValueChange={onValueChange}\n          value={value}\n          {...radioGroupRootProps}\n        >\n          {children}\n        </RadioGroup.Root>\n      </Fieldset.Content>\n      {!!errorText && <Fieldset.ErrorText>{errorText}</Fieldset.ErrorText>}\n    </Fieldset.Root>\n  );\n});\n\nBitkitRadioGroup.displayName = 'BitkitRadioGroup';\n\nexport default BitkitRadioGroup;\n"],"mappings":";;;;;AAqBA,IAAM,mBAAmB,YAAwD,OAAO,QAAQ;CAC9F,MAAM,EACJ,UACA,WACA,YACA,YACA,QACA,MACA,eACA,qBACA,MACA,OACA,GAAG,SACD;CACJ,MAAM,YAAY,CAAC,CAAC,cAAc,CAAC,CAAC;CACpC,OACE,qBAAC,SAAS,MAAV;EAAoB;EAAK,GAAI;EAAM,SAAS,KAAK,WAAW,CAAC,CAAC;YAA9D;GACG,cAAc,oBAAC,SAAS,QAAV,EAAA,UAAkB,WAA4B,CAAA;GAC5D,CAAC,CAAC,cAAc,oBAAC,SAAS,YAAV,EAAA,UAAsB,WAAgC,CAAA;GACvE,oBAAC,SAAS,SAAV;IAAkB,kBAAkB,YAAY,OAAO,KAAA;IAAW,SAAA;cAChE,oBAAC,WAAW,MAAZ;KACQ;KACA;KACN,aAAa;KACE;KACR;KACP,GAAI;KAEH;IACc,CAAA;GACD,CAAA;GACjB,CAAC,CAAC,aAAa,oBAAC,SAAS,WAAV,EAAA,UAAqB,UAA8B,CAAA;EACtD;;AAEnB,CAAC;AAED,iBAAiB,cAAc"}

package/dist/components/BitkitSplitButton/BitkitSplitButton.d.ts

@@ -1,10 +1,10 @@
 import { GroupProps } from '@chakra-ui/react/group';
 import { PropsWithChildren, ReactNode } from 'react';
-import { BitkitButtonProps } from '../BitkitButton/BitkitButton';
+import { BitkitButtonAsAnchorProps, BitkitButtonAsButtonProps } from '../BitkitButton/BitkitButton';
 type Size = 'lg' | 'md' | 'sm';
 type Variant = 'primary' | 'secondary';
 type State = 'disabled' | 'loading' | 'skeleton';
-type BitkitSplitButtonActionProps = Omit<BitkitButtonProps, 'size' | 'variant' | 'state'>;
+type BitkitSplitButtonActionProps = Omit<BitkitButtonAsButtonProps | BitkitButtonAsAnchorProps, 'size' | 'variant' | 'state'>;
 export type BitkitSplitButtonProps = PropsWithChildren<Omit<GroupProps, 'attached' | 'children' | 'display'> & {
     size?: Size;
     variant?: Variant;
@@ -17,9 +17,9 @@ declare const _default: import('react').ForwardRefExoticComponent<Omit<GroupProp
 } & {
     children?: ReactNode | undefined;
 } & import('react').RefAttributes<HTMLDivElement>> & {
-    Action: import('react').ForwardRefExoticComponent<BitkitSplitButtonActionProps & import('react').RefAttributes<HTMLButtonElement>>;
+    Action: import('react').ForwardRefExoticComponent<BitkitSplitButtonActionProps & import('react').RefAttributes<HTMLElement>>;
     Group: import('react').ForwardRefExoticComponent<import('..').BitkitMenuGroupProps & import('react').RefAttributes<HTMLDivElement>>;
-    Item: import('react').ForwardRefExoticComponent<import('..').BitkitMenuItemProps & import('react').RefAttributes<HTMLDivElement>>;
+    Item: import('react').ForwardRefExoticComponent<import('..').BitkitMenuItemProps & import('react').RefAttributes<HTMLElement>>;
     Separator: {
         (): import("react/jsx-runtime").JSX.Element;
         displayName: string;

package/dist/components/BitkitSplitButton/BitkitSplitButton.js

@@ -22,13 +22,21 @@ var [SplitButtonProvider, useSplitButtonContext] = createContext$1({
 });
 var BitkitSplitButtonAction = forwardRef((props, ref) => {
 	const { size, state, styles, variant } = useSplitButtonContext();
-	return /* @__PURE__ */ jsx(BitkitButton, {
+	if (props.href !== void 0) return /* @__PURE__ */ jsx(BitkitButton, {
+		...props,
+		css: styles.action,
 		ref,
+		size,
+		state: state === "loading" ? "disabled" : state,
+		variant
+	});
+	return /* @__PURE__ */ jsx(BitkitButton, {
+		...props,
 		css: styles.action,
+		ref,
 		size,
-		variant,
 		state,
-		...props
+		variant
 	});
 });
 BitkitSplitButtonAction.displayName = "BitkitSplitButtonAction";

package/dist/components/BitkitSplitButton/BitkitSplitButton.js.map

@@ -1 +1 @@
-{"version":3,"file":"BitkitSplitButton.js","names":[],"sources":["../../../lib/components/BitkitSplitButton/BitkitSplitButton.tsx"],"sourcesContent":["// eslint-disable-next-line no-restricted-imports\nimport { createContext } from '@chakra-ui/react';\nimport { Group, type GroupProps } from '@chakra-ui/react/group';\nimport { Skeleton } from '@chakra-ui/react/skeleton';\nimport { type SystemStyleObject, useSlotRecipe } from '@chakra-ui/react/styled-system';\nimport { Children, forwardRef, isValidElement, type PropsWithChildren, type ReactElement, type ReactNode } from 'react';\n\nimport { IconChevronDown } from '../../icons';\nimport BitkitActionMenu from '../BitkitActionMenu/BitkitActionMenu';\nimport BitkitButton, { type BitkitButtonProps } from '../BitkitButton/BitkitButton';\nimport BitkitIconButton from '../BitkitIconButton/BitkitIconButton';\n\ntype Size = 'lg' | 'md' | 'sm';\ntype Variant = 'primary' | 'secondary';\ntype State = 'disabled' | 'loading' | 'skeleton';\n\nconst isValidActionItem = (child: ReactNode): child is ReactElement => {\n  return isValidElement(child) && child.type === BitkitSplitButtonAction;\n};\n\nconst isValidMenuItem = (child: ReactNode): child is ReactElement => {\n  return (\n    isValidElement(child) &&\n    (child.type === BitkitActionMenu.Group ||\n      child.type === BitkitActionMenu.Item ||\n      child.type === BitkitActionMenu.Separator)\n  );\n};\n\n// --- Context ---\ninterface SplitButtonContext {\n  size: Size;\n  variant: Variant;\n  state: State | undefined;\n  styles: Record<string, SystemStyleObject>;\n}\n\nconst [SplitButtonProvider, useSplitButtonContext] = createContext<SplitButtonContext>({\n  name: 'SplitButtonContext',\n  hookName: 'useSplitButtonContext',\n  providerName: '<BitkitSplitButton />',\n});\n\n// --- Action ---\ntype BitkitSplitButtonActionProps = Omit<BitkitButtonProps, 'size' | 'variant' | 'state'>;\n\nconst BitkitSplitButtonAction = forwardRef<HTMLButtonElement, BitkitSplitButtonActionProps>((props, ref) => {\n  const { size, state, styles, variant } = useSplitButtonContext();\n\n  return <BitkitButton ref={ref} css={styles.action} size={size} variant={variant} state={state} {...props} />;\n});\n\nBitkitSplitButtonAction.displayName = 'BitkitSplitButtonAction';\n\n// --- Root ---\nexport type BitkitSplitButtonProps = PropsWithChildren<\n  Omit<GroupProps, 'attached' | 'children' | 'display'> & {\n    size?: Size;\n    variant?: Variant;\n    state?: State;\n  }\n>;\n\nconst BitkitSplitButton = forwardRef<HTMLDivElement, BitkitSplitButtonProps>((props, ref) => {\n  const { children, size = 'lg', state, variant = 'primary', ...rest } = props;\n\n  const childArray = Children.toArray(children);\n  const actionChild = childArray.find(isValidActionItem);\n  const menuItems = childArray.filter(isValidMenuItem);\n\n  const menuSize = size === 'lg' ? 'lg' : 'md';\n  const recipe = useSlotRecipe({ key: 'splitButton' });\n  const styles = recipe({ variant });\n\n  return (\n    <SplitButtonProvider value={{ size, state, styles, variant }}>\n      <Skeleton asChild loading={state === 'skeleton'}>\n        <Group ref={ref} {...rest} attached display=\"inline-flex\">\n          {actionChild}\n          <BitkitActionMenu.Root\n            size={menuSize}\n            trigger={\n              <BitkitIconButton\n                css={styles.trigger}\n                icon={IconChevronDown}\n                label=\"Toggle menu\"\n                size={size}\n                state={state === 'loading' ? 'disabled' : state}\n                variant={variant}\n              />\n            }\n            positioning={{ placement: 'bottom-end' }}\n          >\n            {menuItems}\n          </BitkitActionMenu.Root>\n        </Group>\n      </Skeleton>\n    </SplitButtonProvider>\n  );\n});\nBitkitSplitButton.displayName = 'BitkitSplitButton';\n\nexport default Object.assign(BitkitSplitButton, {\n  Action: BitkitSplitButtonAction,\n  Group: BitkitActionMenu.Group,\n  Item: BitkitActionMenu.Item,\n  Separator: BitkitActionMenu.Separator,\n});\n"],"mappings":";;;;;;;;;;;AAgBA,IAAM,qBAAqB,UAA4C;CACrE,OAAO,eAAe,KAAK,KAAK,MAAM,SAAS;AACjD;AAEA,IAAM,mBAAmB,UAA4C;CACnE,OACE,eAAe,KAAK,MACnB,MAAM,SAAS,iBAAiB,SAC/B,MAAM,SAAS,iBAAiB,QAChC,MAAM,SAAS,iBAAiB;AAEtC;AAUA,IAAM,CAAC,qBAAqB,yBAAyB,gBAAkC;CACrF,MAAM;CACN,UAAU;CACV,cAAc;AAChB,CAAC;AAKD,IAAM,0BAA0B,YAA6D,OAAO,QAAQ;CAC1G,MAAM,EAAE,MAAM,OAAO,QAAQ,YAAY,sBAAsB;CAE/D,OAAO,oBAAC,cAAD;EAAmB;EAAK,KAAK,OAAO;EAAc;EAAe;EAAgB;EAAO,GAAI;CAAQ,CAAA;AAC7G,CAAC;AAED,wBAAwB,cAAc;AAWtC,IAAM,oBAAoB,YAAoD,OAAO,QAAQ;CAC3F,MAAM,EAAE,UAAU,OAAO,MAAM,OAAO,UAAU,WAAW,GAAG,SAAS;CAEvE,MAAM,aAAa,SAAS,QAAQ,QAAQ;CAC5C,MAAM,cAAc,WAAW,KAAK,iBAAiB;CACrD,MAAM,YAAY,WAAW,OAAO,eAAe;CAEnD,MAAM,WAAW,SAAS,OAAO,OAAO;CAExC,MAAM,SADS,cAAc,EAAE,KAAK,cAAc,CACnC,EAAO,EAAE,QAAQ,CAAC;CAEjC,OACE,oBAAC,qBAAD;EAAqB,OAAO;GAAE;GAAM;GAAO;GAAQ;EAAQ;YACzD,oBAAC,UAAD;GAAU,SAAA;GAAQ,SAAS,UAAU;aACnC,qBAAC,OAAD;IAAY;IAAK,GAAI;IAAM,UAAA;IAAS,SAAQ;cAA5C,CACG,aACD,oBAAC,iBAAiB,MAAlB;KACE,MAAM;KACN,SACE,oBAAC,kBAAD;MACE,KAAK,OAAO;MACZ,MAAM;MACN,OAAM;MACA;MACN,OAAO,UAAU,YAAY,aAAa;MACjC;KACV,CAAA;KAEH,aAAa,EAAE,WAAW,aAAa;eAEtC;IACoB,CAAA,CAClB;;EACC,CAAA;CACS,CAAA;AAEzB,CAAC;AACD,kBAAkB,cAAc;AAEhC,IAAA,4BAAe,OAAO,OAAO,mBAAmB;CAC9C,QAAQ;CACR,OAAO,iBAAiB;CACxB,MAAM,iBAAiB;CACvB,WAAW,iBAAiB;AAC9B,CAAC"}
+{"version":3,"file":"BitkitSplitButton.js","names":[],"sources":["../../../lib/components/BitkitSplitButton/BitkitSplitButton.tsx"],"sourcesContent":["// eslint-disable-next-line no-restricted-imports\nimport { createContext } from '@chakra-ui/react';\nimport { Group, type GroupProps } from '@chakra-ui/react/group';\nimport { Skeleton } from '@chakra-ui/react/skeleton';\nimport { type SystemStyleObject, useSlotRecipe } from '@chakra-ui/react/styled-system';\nimport { Children, forwardRef, isValidElement, type PropsWithChildren, type ReactElement, type ReactNode } from 'react';\n\nimport { IconChevronDown } from '../../icons';\nimport BitkitActionMenu from '../BitkitActionMenu/BitkitActionMenu';\nimport BitkitButton, {\n  type BitkitButtonAsAnchorProps,\n  type BitkitButtonAsButtonProps,\n} from '../BitkitButton/BitkitButton';\nimport BitkitIconButton from '../BitkitIconButton/BitkitIconButton';\n\ntype Size = 'lg' | 'md' | 'sm';\ntype Variant = 'primary' | 'secondary';\ntype State = 'disabled' | 'loading' | 'skeleton';\n\nconst isValidActionItem = (child: ReactNode): child is ReactElement => {\n  return isValidElement(child) && child.type === BitkitSplitButtonAction;\n};\n\nconst isValidMenuItem = (child: ReactNode): child is ReactElement => {\n  return (\n    isValidElement(child) &&\n    (child.type === BitkitActionMenu.Group ||\n      child.type === BitkitActionMenu.Item ||\n      child.type === BitkitActionMenu.Separator)\n  );\n};\n\n// --- Context ---\ninterface SplitButtonContext {\n  size: Size;\n  variant: Variant;\n  state: State | undefined;\n  styles: Record<string, SystemStyleObject>;\n}\n\nconst [SplitButtonProvider, useSplitButtonContext] = createContext<SplitButtonContext>({\n  name: 'SplitButtonContext',\n  hookName: 'useSplitButtonContext',\n  providerName: '<BitkitSplitButton />',\n});\n\n// --- Action ---\n// Split-button action can be a button (default) or anchor (when href is set). asChild is intentionally\n// not part of the API — routing-library elements don't fit cleanly into the Group attached layout.\n// The forwarded ref is HTMLElement so it covers both <button> and <a>.\ntype BitkitSplitButtonActionProps = Omit<\n  BitkitButtonAsButtonProps | BitkitButtonAsAnchorProps,\n  'size' | 'variant' | 'state'\n>;\n\nconst BitkitSplitButtonAction = forwardRef<HTMLElement, BitkitSplitButtonActionProps>((props, ref) => {\n  const { size, state, styles, variant } = useSplitButtonContext();\n\n  if (props.href !== undefined) {\n    // Anchor branch: BitkitButton's anchor variant doesn't allow state=\"loading\". Coerce to \"disabled\"\n    // so a SplitButton-wide loading state still surfaces visually on a link-mode action.\n    return (\n      <BitkitButton\n        {...(props as BitkitButtonAsAnchorProps)}\n        css={styles.action}\n        ref={ref}\n        size={size}\n        state={state === 'loading' ? 'disabled' : state}\n        variant={variant}\n      />\n    );\n  }\n\n  return (\n    <BitkitButton\n      {...(props as BitkitButtonAsButtonProps)}\n      css={styles.action}\n      ref={ref}\n      size={size}\n      state={state}\n      variant={variant}\n    />\n  );\n});\n\nBitkitSplitButtonAction.displayName = 'BitkitSplitButtonAction';\n\n// --- Root ---\nexport type BitkitSplitButtonProps = PropsWithChildren<\n  Omit<GroupProps, 'attached' | 'children' | 'display'> & {\n    size?: Size;\n    variant?: Variant;\n    state?: State;\n  }\n>;\n\nconst BitkitSplitButton = forwardRef<HTMLDivElement, BitkitSplitButtonProps>((props, ref) => {\n  const { children, size = 'lg', state, variant = 'primary', ...rest } = props;\n\n  const childArray = Children.toArray(children);\n  const actionChild = childArray.find(isValidActionItem);\n  const menuItems = childArray.filter(isValidMenuItem);\n\n  const menuSize = size === 'lg' ? 'lg' : 'md';\n  const recipe = useSlotRecipe({ key: 'splitButton' });\n  const styles = recipe({ variant });\n\n  return (\n    <SplitButtonProvider value={{ size, state, styles, variant }}>\n      <Skeleton asChild loading={state === 'skeleton'}>\n        <Group ref={ref} {...rest} attached display=\"inline-flex\">\n          {actionChild}\n          <BitkitActionMenu.Root\n            size={menuSize}\n            trigger={\n              <BitkitIconButton\n                css={styles.trigger}\n                icon={IconChevronDown}\n                label=\"Toggle menu\"\n                size={size}\n                state={state === 'loading' ? 'disabled' : state}\n                variant={variant}\n              />\n            }\n            positioning={{ placement: 'bottom-end' }}\n          >\n            {menuItems}\n          </BitkitActionMenu.Root>\n        </Group>\n      </Skeleton>\n    </SplitButtonProvider>\n  );\n});\nBitkitSplitButton.displayName = 'BitkitSplitButton';\n\nexport default Object.assign(BitkitSplitButton, {\n  Action: BitkitSplitButtonAction,\n  Group: BitkitActionMenu.Group,\n  Item: BitkitActionMenu.Item,\n  Separator: BitkitActionMenu.Separator,\n});\n"],"mappings":";;;;;;;;;;;AAmBA,IAAM,qBAAqB,UAA4C;CACrE,OAAO,eAAe,KAAK,KAAK,MAAM,SAAS;AACjD;AAEA,IAAM,mBAAmB,UAA4C;CACnE,OACE,eAAe,KAAK,MACnB,MAAM,SAAS,iBAAiB,SAC/B,MAAM,SAAS,iBAAiB,QAChC,MAAM,SAAS,iBAAiB;AAEtC;AAUA,IAAM,CAAC,qBAAqB,yBAAyB,gBAAkC;CACrF,MAAM;CACN,UAAU;CACV,cAAc;AAChB,CAAC;AAWD,IAAM,0BAA0B,YAAuD,OAAO,QAAQ;CACpG,MAAM,EAAE,MAAM,OAAO,QAAQ,YAAY,sBAAsB;CAE/D,IAAI,MAAM,SAAS,KAAA,GAGjB,OACE,oBAAC,cAAD;EACE,GAAK;EACL,KAAK,OAAO;EACP;EACC;EACN,OAAO,UAAU,YAAY,aAAa;EACjC;CACV,CAAA;CAIL,OACE,oBAAC,cAAD;EACE,GAAK;EACL,KAAK,OAAO;EACP;EACC;EACC;EACE;CACV,CAAA;AAEL,CAAC;AAED,wBAAwB,cAAc;AAWtC,IAAM,oBAAoB,YAAoD,OAAO,QAAQ;CAC3F,MAAM,EAAE,UAAU,OAAO,MAAM,OAAO,UAAU,WAAW,GAAG,SAAS;CAEvE,MAAM,aAAa,SAAS,QAAQ,QAAQ;CAC5C,MAAM,cAAc,WAAW,KAAK,iBAAiB;CACrD,MAAM,YAAY,WAAW,OAAO,eAAe;CAEnD,MAAM,WAAW,SAAS,OAAO,OAAO;CAExC,MAAM,SADS,cAAc,EAAE,KAAK,cAAc,CACnC,EAAO,EAAE,QAAQ,CAAC;CAEjC,OACE,oBAAC,qBAAD;EAAqB,OAAO;GAAE;GAAM;GAAO;GAAQ;EAAQ;YACzD,oBAAC,UAAD;GAAU,SAAA;GAAQ,SAAS,UAAU;aACnC,qBAAC,OAAD;IAAY;IAAK,GAAI;IAAM,UAAA;IAAS,SAAQ;cAA5C,CACG,aACD,oBAAC,iBAAiB,MAAlB;KACE,MAAM;KACN,SACE,oBAAC,kBAAD;MACE,KAAK,OAAO;MACZ,MAAM;MACN,OAAM;MACA;MACN,OAAO,UAAU,YAAY,aAAa;MACjC;KACV,CAAA;KAEH,aAAa,EAAE,WAAW,aAAa;eAEtC;IACoB,CAAA,CAClB;;EACC,CAAA;CACS,CAAA;AAEzB,CAAC;AACD,kBAAkB,cAAc;AAEhC,IAAA,4BAAe,OAAO,OAAO,mBAAmB;CAC9C,QAAQ;CACR,OAAO,iBAAiB;CACxB,MAAM,iBAAiB;CACvB,WAAW,iBAAiB;AAC9B,CAAC"}

package/docs/v1-to-v2-migration-guide.md

@@ -63,11 +63,43 @@ Chakra v2 → v3 prop changes on primitives:
 |----|----|
 | `Button` | `BitkitButton` |
 | `IconButton` | `BitkitIconButton` |
+| `ControlButton` | `BitkitControlButton` |
+| `Button as="a" href="..."` | `BitkitButton href="..."` (renders `<a>`) |
+| `IconButton as="a" href="..."` | `BitkitIconButton href="..."` |
+| `<Link isExternal>` | `BitkitLink isExternal` |
 | `leftIconName` | `icon` |
 | `isDisabled` | `state="disabled"` |
 | `isLoading` | `state="loading"` |
 
-**Gotcha**: `BitkitButton` requires `children` to be a `string`. If a button contains complex layout (icon + text, conditional content, custom JSX), use `chakra.button` from `@chakra-ui/react/styled-system` instead of forcing it into `BitkitButton`.
+**Polymorphism**: `BitkitButton`, `BitkitIconButton`, and `BitkitControlButton` all render as `<a>` when `href` is passed — the button recipe styles apply to the anchor. The `state` prop's `'loading'` value is not valid in anchor mode (semantically a button thing).
+
+```tsx
+// Renders <button>
+<BitkitButton onClick={save}>Save</BitkitButton>
+
+// Renders <a href="/details"> with the button visual style
+<BitkitButton href="/details">View details</BitkitButton>
+
+// External link — auto-adds target="_blank" rel="noreferrer noopener"
+<BitkitButton href="https://example.com" isExternal>External</BitkitButton>
+```
+
+**Routing library integration** — for routers that render their own `<a>` (Next.js Link, React Router Link), use `asChild`:
+
+```tsx
+<BitkitButton asChild icon={IconCheck}>
+  <NextLink href="/route">Navigate</NextLink>
+</BitkitButton>
+```
+
+`BitkitLink` also supports `isExternal` for the same target+rel convenience. `BitkitActionMenu.Item` accepts `href` (with optional `target`, `rel`, and `isExternal`) for link-style menu items:
+
+```tsx
+<BitkitActionMenu.Item href="/internal" value="v1">Go to settings</BitkitActionMenu.Item>
+<BitkitActionMenu.Item href="https://example.com" isExternal value="v2">Open docs</BitkitActionMenu.Item>
+```
+
+**Gotcha**: `BitkitButton` requires `children` to be a `string` in button/anchor modes. For complex layout (multiple text nodes, conditional JSX), use `asChild` mode with your own element, or compose with `chakra.button` from `@chakra-ui/react/styled-system` for full freedom.
 
 ### Badge / Tag
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@bitrise/bitkit-v2",
   "private": false,
-  "version": "0.3.220",
+  "version": "0.3.222",
   "description": "Bitrise Design System Components built with Chakra UI V3",
   "keywords": [
     "react",