@kushagradhawan/kookie-ui 0.1.70 → 0.1.72

package/dist/esm/components/toggle-button.js

@@ -1,2 +1,2 @@
-import*as o from"react";import{Toggle as f}from"radix-ui";import{Button as m}from"./button.js";import{useLiveAnnouncer as c}from"../hooks/use-live-announcer.js";const l=o.forwardRef(({pressed:n,onPressedChange:t,defaultPressed:u,children:e,...p},g)=>{const s=c(),r=o.useCallback(()=>typeof e=="string"?e:o.isValidElement(e)&&typeof e.props?.children=="string"?e.props.children:"Toggle button",[e]),d=o.useCallback(a=>{const i=r();s(`${i} ${a?"pressed":"unpressed"}`),t?.(a)},[s,t,r]);return o.useEffect(()=>{},[n,t]),o.createElement(f.Root,{pressed:n,onPressedChange:d,defaultPressed:u,asChild:!0},o.createElement(m,{...p,ref:g},e))});l.displayName="ToggleButton";export{l as ToggleButton};
+import*as o from"react";import{Toggle as u}from"radix-ui";import{Button as f}from"./button.js";import{useToggleState as m}from"../hooks/use-toggle-state.js";const n=o.forwardRef(({pressed:t,onPressedChange:s,defaultPressed:r,children:e,...g},a)=>{const p=o.useCallback(()=>typeof e=="string"?e:o.isValidElement(e)&&typeof e.props?.children=="string"?e.props.children:"Toggle button",[e]),{handlePressedChange:l}=m({pressed:t,onPressedChange:s,getAccessibleName:p,componentName:"ToggleButton"});return o.createElement(u.Root,{pressed:t,onPressedChange:l,defaultPressed:r,asChild:!0},o.createElement(f,{...g,ref:a},e))});n.displayName="ToggleButton";export{n as ToggleButton};
 //# sourceMappingURL=toggle-button.js.map

package/dist/esm/components/toggle-button.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/components/toggle-button.tsx"],
-  "sourcesContent": ["import * as React from 'react';\nimport { Toggle } from 'radix-ui';\nimport { Button } from './button.js';\nimport { useLiveAnnouncer } from '../hooks/use-live-announcer.js';\n\n/**\n * ToggleButton props that extend Button with toggle-specific functionality\n *\n * The ToggleButton component provides a button that can be pressed/unpressed\n * with proper accessibility announcements and state management.\n */\ninterface ToggleButtonProps extends React.ComponentPropsWithoutRef<typeof Button> {\n  /** Controlled pressed state */\n  pressed?: boolean;\n  /** Callback when pressed state changes */\n  onPressedChange?: (pressed: boolean) => void;\n  /** Default pressed state for uncontrolled usage */\n  defaultPressed?: boolean;\n}\n\ntype ToggleButtonElement = React.ElementRef<typeof Button>;\n\n/**\n * ToggleButton component for buttons that can be pressed/unpressed\n *\n * The ToggleButton component extends Button with toggle functionality using\n * Radix UI's Toggle primitive. It provides proper accessibility announcements,\n * controlled/uncontrolled state management, and seamless integration with\n * the existing Button component.\n *\n * Key features:\n * - Controlled and uncontrolled state management\n * - Live accessibility announcements for screen readers\n * - Automatic state validation and warnings\n * - Seamless integration with Button props and styling\n * - Proper ARIA attributes for toggle functionality\n *\n * @example\n * ```tsx\n * // Uncontrolled toggle button\n * <ToggleButton defaultPressed={false}>\n *   Toggle Me\n * </ToggleButton>\n *\n * // Controlled toggle button\n * const [pressed, setPressed] = React.useState(false);\n * <ToggleButton\n *   pressed={pressed}\n *   onPressedChange={setPressed}\n * >\n *   {pressed ? 'On' : 'Off'}\n * </ToggleButton>\n *\n * // Toggle button with all Button props\n * <ToggleButton\n *   variant=\"solid\"\n *   size=\"3\"\n *   color=\"blue\"\n *   pressed={isActive}\n *   onPressedChange={setIsActive}\n * >\n *   {isActive ? 'Active' : 'Inactive'}\n * </ToggleButton>\n * ```\n */\nconst ToggleButton = React.forwardRef<ToggleButtonElement, ToggleButtonProps>(\n  ({ pressed, onPressedChange, defaultPressed, children, ...buttonProps }, forwardedRef) => {\n    // Get the live announcer for accessibility announcements\n    const announce = useLiveAnnouncer();\n\n    /**\n     * Extract accessible name from button content for announcements\n     * This ensures screen readers announce meaningful state changes\n     */\n    const getAccessibleName = React.useCallback(() => {\n      if (typeof children === 'string') return children;\n      if (React.isValidElement(children) && typeof (children.props as any)?.children === 'string') {\n        return (children.props as any).children;\n      }\n      return 'Toggle button';\n    }, [children]);\n\n    /**\n     * Memoized handler for state changes with accessibility announcements\n     * This ensures screen readers announce the new state immediately\n     */\n    const handlePressedChange = React.useCallback(\n      (newPressed: boolean) => {\n        const accessibleName = getAccessibleName();\n        // Announce the state change for screen readers\n        announce(`${accessibleName} ${newPressed ? 'pressed' : 'unpressed'}`);\n        // Call the user's change handler\n        onPressedChange?.(newPressed);\n      },\n      [announce, onPressedChange, getAccessibleName],\n    );\n\n    // Development-only warning for controlled/uncontrolled pattern\n    // This helps developers avoid common state management mistakes\n    React.useEffect(() => {\n      if (process.env.NODE_ENV === 'development' && pressed !== undefined && onPressedChange === undefined) {\n        console.warn(\n          'ToggleButton: You provided a `pressed` prop without an `onPressedChange` handler. ' +\n            'This will result in a read-only toggle button. If you want the button to be interactive, ' +\n            'you should provide an `onPressedChange` handler.',\n        );\n      }\n    }, [pressed, onPressedChange]);\n\n    // Render the toggle button using Radix UI's Toggle primitive\n    // This provides proper ARIA attributes and keyboard navigation\n    return (\n      <Toggle.Root\n        pressed={pressed}\n        onPressedChange={handlePressedChange}\n        defaultPressed={defaultPressed}\n        asChild\n      >\n        <Button {...buttonProps} ref={forwardedRef}>\n          {children}\n        </Button>\n      </Toggle.Root>\n    );\n  },\n);\nToggleButton.displayName = 'ToggleButton';\n\nexport { ToggleButton };\nexport type { ToggleButtonProps };\n"],
-  "mappings": "AAAA,UAAYA,MAAW,QACvB,OAAS,UAAAC,MAAc,WACvB,OAAS,UAAAC,MAAc,cACvB,OAAS,oBAAAC,MAAwB,iCA8DjC,MAAMC,EAAeJ,EAAM,WACzB,CAAC,CAAE,QAAAK,EAAS,gBAAAC,EAAiB,eAAAC,EAAgB,SAAAC,EAAU,GAAGC,CAAY,EAAGC,IAAiB,CAExF,MAAMC,EAAWR,EAAiB,EAM5BS,EAAoBZ,EAAM,YAAY,IACtC,OAAOQ,GAAa,SAAiBA,EACrCR,EAAM,eAAeQ,CAAQ,GAAK,OAAQA,EAAS,OAAe,UAAa,SACzEA,EAAS,MAAc,SAE1B,gBACN,CAACA,CAAQ,CAAC,EAMPK,EAAsBb,EAAM,YAC/Bc,GAAwB,CACvB,MAAMC,EAAiBH,EAAkB,EAEzCD,EAAS,GAAGI,CAAc,IAAID,EAAa,UAAY,WAAW,EAAE,EAEpER,IAAkBQ,CAAU,CAC9B,EACA,CAACH,EAAUL,EAAiBM,CAAiB,CAC/C,EAIA,OAAAZ,EAAM,UAAU,IAAM,CAQtB,EAAG,CAACK,EAASC,CAAe,CAAC,EAK3BN,EAAA,cAACC,EAAO,KAAP,CACC,QAASI,EACT,gBAAiBQ,EACjB,eAAgBN,EAChB,QAAO,IAEPP,EAAA,cAACE,EAAA,CAAQ,GAAGO,EAAa,IAAKC,GAC3BF,CACH,CACF,CAEJ,CACF,EACAJ,EAAa,YAAc",
-  "names": ["React", "Toggle", "Button", "useLiveAnnouncer", "ToggleButton", "pressed", "onPressedChange", "defaultPressed", "children", "buttonProps", "forwardedRef", "announce", "getAccessibleName", "handlePressedChange", "newPressed", "accessibleName"]
+  "sourcesContent": ["import * as React from 'react';\nimport { Toggle } from 'radix-ui';\nimport { Button } from './button.js';\nimport { useToggleState } from '../hooks/use-toggle-state.js';\n\n/**\n * ToggleButton props that extend Button with toggle-specific functionality\n *\n * The ToggleButton component provides a button that can be pressed/unpressed\n * with proper accessibility announcements and state management.\n */\ninterface ToggleButtonProps extends React.ComponentPropsWithoutRef<typeof Button> {\n  /** Controlled pressed state */\n  pressed?: boolean;\n  /** Callback when pressed state changes */\n  onPressedChange?: (pressed: boolean) => void;\n  /** Default pressed state for uncontrolled usage */\n  defaultPressed?: boolean;\n}\n\ntype ToggleButtonElement = React.ElementRef<typeof Button>;\n\n/**\n * ToggleButton component for buttons that can be pressed/unpressed\n *\n * The ToggleButton component extends Button with toggle functionality using\n * Radix UI's Toggle primitive. It provides proper accessibility announcements,\n * controlled/uncontrolled state management, and seamless integration with\n * the existing Button component.\n *\n * Key features:\n * - Controlled and uncontrolled state management\n * - Live accessibility announcements for screen readers\n * - Automatic state validation and warnings\n * - Seamless integration with Button props and styling\n * - Proper ARIA attributes for toggle functionality\n *\n * @example\n * ```tsx\n * // Uncontrolled toggle button\n * <ToggleButton defaultPressed={false}>\n *   Toggle Me\n * </ToggleButton>\n *\n * // Controlled toggle button\n * const [pressed, setPressed] = React.useState(false);\n * <ToggleButton\n *   pressed={pressed}\n *   onPressedChange={setPressed}\n * >\n *   {pressed ? 'On' : 'Off'}\n * </ToggleButton>\n *\n * // Toggle button with all Button props\n * <ToggleButton\n *   variant=\"solid\"\n *   size=\"3\"\n *   color=\"blue\"\n *   pressed={isActive}\n *   onPressedChange={setIsActive}\n * >\n *   {isActive ? 'Active' : 'Inactive'}\n * </ToggleButton>\n * ```\n */\nconst ToggleButton = React.forwardRef<ToggleButtonElement, ToggleButtonProps>(({ pressed, onPressedChange, defaultPressed, children, ...buttonProps }, forwardedRef) => {\n  /**\n   * Extract accessible name from button content for announcements.\n   * This ensures screen readers announce meaningful state changes.\n   */\n  const getAccessibleName = React.useCallback(() => {\n    if (typeof children === 'string') return children;\n    if (React.isValidElement(children) && typeof (children.props as any)?.children === 'string') {\n      return (children.props as any).children;\n    }\n    return 'Toggle button';\n  }, [children]);\n\n  // Use shared toggle state hook for accessibility announcements and warnings\n  const { handlePressedChange } = useToggleState({\n    pressed,\n    onPressedChange,\n    getAccessibleName,\n    componentName: 'ToggleButton',\n  });\n\n  // Render the toggle button using Radix UI's Toggle primitive\n  // This provides proper ARIA attributes and keyboard navigation\n  return (\n    <Toggle.Root pressed={pressed} onPressedChange={handlePressedChange} defaultPressed={defaultPressed} asChild>\n      <Button {...buttonProps} ref={forwardedRef}>\n        {children}\n      </Button>\n    </Toggle.Root>\n  );\n});\nToggleButton.displayName = 'ToggleButton';\n\nexport { ToggleButton };\nexport type { ToggleButtonProps };\n"],
+  "mappings": "AAAA,UAAYA,MAAW,QACvB,OAAS,UAAAC,MAAc,WACvB,OAAS,UAAAC,MAAc,cACvB,OAAS,kBAAAC,MAAsB,+BA8D/B,MAAMC,EAAeJ,EAAM,WAAmD,CAAC,CAAE,QAAAK,EAAS,gBAAAC,EAAiB,eAAAC,EAAgB,SAAAC,EAAU,GAAGC,CAAY,EAAGC,IAAiB,CAKtK,MAAMC,EAAoBX,EAAM,YAAY,IACtC,OAAOQ,GAAa,SAAiBA,EACrCR,EAAM,eAAeQ,CAAQ,GAAK,OAAQA,EAAS,OAAe,UAAa,SACzEA,EAAS,MAAc,SAE1B,gBACN,CAACA,CAAQ,CAAC,EAGP,CAAE,oBAAAI,CAAoB,EAAIT,EAAe,CAC7C,QAAAE,EACA,gBAAAC,EACA,kBAAAK,EACA,cAAe,cACjB,CAAC,EAID,OACEX,EAAA,cAACC,EAAO,KAAP,CAAY,QAASI,EAAS,gBAAiBO,EAAqB,eAAgBL,EAAgB,QAAO,IAC1GP,EAAA,cAACE,EAAA,CAAQ,GAAGO,EAAa,IAAKC,GAC3BF,CACH,CACF,CAEJ,CAAC,EACDJ,EAAa,YAAc",
+  "names": ["React", "Toggle", "Button", "useToggleState", "ToggleButton", "pressed", "onPressedChange", "defaultPressed", "children", "buttonProps", "forwardedRef", "getAccessibleName", "handlePressedChange"]
 }

package/dist/esm/components/toggle-icon-button.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"toggle-icon-button.d.ts","sourceRoot":"","sources":["../../../src/components/toggle-icon-button.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAIlC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAIxD;;;GAGG;AACH,KAAK,WAAW,GAAG,KAAK,CAAC,wBAAwB,CAAC,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC;AAEtE;;;;;;;;GAQG;AACH,KAAK,kBAAkB,GACnB;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,iBAAiB,CAAC,EAAE,KAAK,CAAA;CAAE,GACnD;IAAE,YAAY,CAAC,EAAE,KAAK,CAAC;IAAC,iBAAiB,EAAE,MAAM,CAAA;CAAE,GACnD;IAAE,YAAY,CAAC,EAAE,KAAK,CAAC;IAAC,iBAAiB,CAAC,EAAE,KAAK,CAAC;IAAC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAAE,CAAC;AAEnF;;;GAGG;AACH,UAAU,qBAAsB,SAAQ,IAAI,CAAC,eAAe,EAAE,IAAI,CAAC;IACjE,+BAA+B;IAC/B,OAAO,CAAC,EAAE,WAAW,CAAC,SAAS,CAAC,CAAC;IACjC,0CAA0C;IAC1C,eAAe,CAAC,EAAE,WAAW,CAAC,iBAAiB,CAAC,CAAC;IACjD,mDAAmD;IACnD,cAAc,CAAC,EAAE,WAAW,CAAC,gBAAgB,CAAC,CAAC;CAChD;AAED;;;GAGG;AACH,KAAK,sCAAsC,GAAG,qBAAqB,GAAG,kBAAkB,CAAC;AAEzF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyDG;AACH,QAAA,MAAM,gBAAgB,kHA8EpB,CAAC;AAGH,OAAO,EAAE,gBAAgB,EAAE,CAAC;AAC5B,YAAY,EAAE,sCAAsC,IAAI,qBAAqB,EAAE,CAAC"}
+{"version":3,"file":"toggle-icon-button.d.ts","sourceRoot":"","sources":["../../../src/components/toggle-icon-button.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAIlC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAIxD;;;GAGG;AACH,KAAK,WAAW,GAAG,KAAK,CAAC,wBAAwB,CAAC,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC;AAEtE;;;;;;;;GAQG;AACH,KAAK,kBAAkB,GACnB;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,iBAAiB,CAAC,EAAE,KAAK,CAAA;CAAE,GACnD;IAAE,YAAY,CAAC,EAAE,KAAK,CAAC;IAAC,iBAAiB,EAAE,MAAM,CAAA;CAAE,GACnD;IAAE,YAAY,CAAC,EAAE,KAAK,CAAC;IAAC,iBAAiB,CAAC,EAAE,KAAK,CAAC;IAAC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAAE,CAAC;AAEnF;;;GAGG;AACH,UAAU,qBAAsB,SAAQ,IAAI,CAAC,eAAe,EAAE,IAAI,CAAC;IACjE,+BAA+B;IAC/B,OAAO,CAAC,EAAE,WAAW,CAAC,SAAS,CAAC,CAAC;IACjC,0CAA0C;IAC1C,eAAe,CAAC,EAAE,WAAW,CAAC,iBAAiB,CAAC,CAAC;IACjD,mDAAmD;IACnD,cAAc,CAAC,EAAE,WAAW,CAAC,gBAAgB,CAAC,CAAC;CAChD;AAED;;;GAGG;AACH,KAAK,sCAAsC,GAAG,qBAAqB,GAAG,kBAAkB,CAAC;AAEzF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyDG;AACH,QAAA,MAAM,gBAAgB,kHAwDpB,CAAC;AAGH,OAAO,EAAE,gBAAgB,EAAE,CAAC;AAC5B,YAAY,EAAE,sCAAsC,IAAI,qBAAqB,EAAE,CAAC"}

package/dist/esm/components/toggle-icon-button.js

@@ -1,2 +1,2 @@
-import*as e from"react";import{Toggle as u}from"radix-ui";import{IconButton as b}from"./icon-button.js";import"./_internal/base-button.js";import{useLiveAnnouncer as f}from"../hooks/use-live-announcer.js";const c=e.forwardRef(({pressed:l,onPressedChange:r,defaultPressed:g,...s},p)=>{const a=f(),i=e.useCallback(()=>{const{"aria-label":o,"aria-labelledby":n,children:t}=s;return o||(n?document.getElementById(n)?.textContent||"Toggle icon button":typeof t=="string"?t:e.isValidElement(t)&&typeof t.props?.children=="string"?t.props.children:"Toggle icon button")},[s]),d=e.useCallback(o=>{const n=i();a(`${n} ${o?"pressed":"unpressed"}`),r?.(o)},[a,r,i]);return e.useEffect(()=>{},[l,r]),e.createElement(u.Root,{pressed:l,onPressedChange:d,defaultPressed:g,asChild:!0},e.createElement(b,{...s,ref:p}))});c.displayName="ToggleIconButton";export{c as ToggleIconButton};
+import*as e from"react";import{Toggle as f}from"radix-ui";import{IconButton as b}from"./icon-button.js";import"./_internal/base-button.js";import{useToggleState as m}from"../hooks/use-toggle-state.js";const a=e.forwardRef(({pressed:l,onPressedChange:i,defaultPressed:g,...s},c)=>{const{"aria-label":r,"aria-labelledby":o,children:t}=s,n=e.useRef(null);e.useEffect(()=>{n.current=null},[o]);const p=e.useCallback(()=>{if(r)return r;if(o){if(n.current===null){const d=document.getElementById(o);n.current=d?.textContent||"Toggle icon button"}return n.current}return typeof t=="string"?t:e.isValidElement(t)&&typeof t.props?.children=="string"?t.props.children:"Toggle icon button"},[r,o,t]),{handlePressedChange:u}=m({pressed:l,onPressedChange:i,getAccessibleName:p,componentName:"ToggleIconButton"});return e.createElement(f.Root,{pressed:l,onPressedChange:u,defaultPressed:g,asChild:!0},e.createElement(b,{...s,ref:c}))});a.displayName="ToggleIconButton";export{a as ToggleIconButton};
 //# sourceMappingURL=toggle-icon-button.js.map

package/dist/esm/components/toggle-icon-button.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/components/toggle-icon-button.tsx"],
-  "sourcesContent": ["import * as React from 'react';\nimport { Toggle } from 'radix-ui';\nimport { IconButton } from './icon-button.js';\nimport { BaseButton } from './_internal/base-button.js';\nimport { useLiveAnnouncer } from '../hooks/use-live-announcer.js';\nimport type { IconButtonProps } from './icon-button.js';\n\ntype ToggleIconButtonElement = React.ElementRef<typeof BaseButton>;\n\n/**\n * Extract toggle-specific props from Radix Toggle\n * These props control the toggle state and behavior\n */\ntype ToggleProps = React.ComponentPropsWithoutRef<typeof Toggle.Root>;\n\n/**\n * Required accessibility props for icon buttons (same as IconButton)\n * Icon buttons must have an accessible name to meet WCAG guidelines\n *\n * Three ways to provide accessibility:\n * 1. aria-label: Direct descriptive text\n * 2. aria-labelledby: Reference to a label element\n * 3. children: Visible text content (fallback)\n */\ntype AccessibilityProps =\n  | { 'aria-label': string; 'aria-labelledby'?: never }\n  | { 'aria-label'?: never; 'aria-labelledby': string }\n  | { 'aria-label'?: never; 'aria-labelledby'?: never; children: React.ReactNode };\n\n/**\n * Combine IconButton props with Toggle-specific props\n * Includes tooltip props from IconButton for comprehensive functionality\n */\ninterface ToggleIconButtonProps extends Omit<IconButtonProps, 'as'> {\n  /** Controlled pressed state */\n  pressed?: ToggleProps['pressed'];\n  /** Callback when pressed state changes */\n  onPressedChange?: ToggleProps['onPressedChange'];\n  /** Default pressed state for uncontrolled usage */\n  defaultPressed?: ToggleProps['defaultPressed'];\n}\n\n/**\n * Intersection with accessibility props to ensure compliance\n * This type ensures all ToggleIconButton instances have proper accessibility\n */\ntype ToggleIconButtonPropsWithAccessibility = ToggleIconButtonProps & AccessibilityProps;\n\n/**\n * ToggleIconButton component for icon buttons that can be pressed/unpressed\n *\n * The ToggleIconButton component extends IconButton with toggle functionality\n * using Radix UI's Toggle primitive. It provides proper accessibility announcements,\n * controlled/uncontrolled state management, and seamless integration with\n * the existing IconButton component.\n *\n * Key features:\n * - Controlled and uncontrolled state management\n * - Live accessibility announcements for screen readers\n * - Enforced accessibility requirements (aria-label, aria-labelledby, or children)\n * - Automatic state validation and warnings\n * - Seamless integration with IconButton props and styling\n * - Proper ARIA attributes for toggle functionality\n * - Built-in tooltip support from IconButton\n *\n * @example\n * ```tsx\n * // Uncontrolled toggle icon button\n * <ToggleIconButton defaultPressed={false} aria-label=\"Toggle notifications\">\n *   <Bell />\n * </ToggleIconButton>\n *\n * // Controlled toggle icon button\n * const [pressed, setPressed] = React.useState(false);\n * <ToggleIconButton\n *   pressed={pressed}\n *   onPressedChange={setPressed}\n *   aria-label=\"Toggle notifications\"\n * >\n *   <Bell />\n * </ToggleIconButton>\n *\n * // Toggle icon button with tooltip\n * <ToggleIconButton\n *   variant=\"solid\"\n *   size=\"3\"\n *   color=\"blue\"\n *   pressed={isActive}\n *   onPressedChange={setIsActive}\n *   aria-label=\"Toggle feature\"\n *   tooltip=\"Toggle this feature on/off\"\n * >\n *   <Star />\n * </ToggleIconButton>\n *\n * // Toggle icon button with aria-labelledby\n * <ToggleIconButton\n *   aria-labelledby=\"notifications-label\"\n *   pressed={notificationsEnabled}\n *   onPressedChange={setNotificationsEnabled}\n * >\n *   <Bell />\n * </ToggleIconButton>\n * <span id=\"notifications-label\">Toggle notifications</span>\n * ```\n */\nconst ToggleIconButton = React.forwardRef<\n  ToggleIconButtonElement,\n  ToggleIconButtonPropsWithAccessibility\n>(({ pressed, onPressedChange, defaultPressed, ...iconButtonProps }, forwardedRef) => {\n  // Get the live announcer for accessibility announcements\n  const announce = useLiveAnnouncer();\n\n  /**\n   * Extract accessible name from various sources for announcements\n   * This ensures screen readers announce meaningful state changes\n   * Priority: aria-label > aria-labelledby > children > fallback\n   */\n  const getAccessibleName = React.useCallback(() => {\n    const {\n      'aria-label': ariaLabel,\n      'aria-labelledby': ariaLabelledBy,\n      children,\n    } = iconButtonProps;\n\n    // First priority: direct aria-label\n    if (ariaLabel) return ariaLabel;\n\n    // Second priority: referenced label element\n    if (ariaLabelledBy) {\n      const labelElement = document.getElementById(ariaLabelledBy);\n      return labelElement?.textContent || 'Toggle icon button';\n    }\n\n    // Third priority: visible text children\n    if (typeof children === 'string') return children;\n    if (React.isValidElement(children) && typeof (children.props as any)?.children === 'string') {\n      return (children.props as any).children;\n    }\n\n    // Fallback for edge cases\n    return 'Toggle icon button';\n  }, [iconButtonProps]);\n\n  /**\n   * Memoized handler for state changes with accessibility announcements\n   * This ensures screen readers announce the new state immediately\n   */\n  const handlePressedChange = React.useCallback(\n    (newPressed: boolean) => {\n      const accessibleName = getAccessibleName();\n      // Announce the state change for screen readers\n      announce(`${accessibleName} ${newPressed ? 'pressed' : 'unpressed'}`);\n      // Call the user's change handler\n      onPressedChange?.(newPressed);\n    },\n    [announce, onPressedChange, getAccessibleName],\n  );\n\n  // Development-only warning for controlled/uncontrolled pattern\n  // This helps developers avoid common state management mistakes\n  React.useEffect(() => {\n    if (process.env.NODE_ENV === 'development' && pressed !== undefined && onPressedChange === undefined) {\n      console.warn(\n        'ToggleIconButton: You provided a `pressed` prop without an `onPressedChange` handler. ' +\n          'This will result in a read-only toggle button. If you want the button to be interactive, ' +\n          'you should provide an `onPressedChange` handler.',\n      );\n    }\n  }, [pressed, onPressedChange]);\n\n  // Render the toggle icon button using Radix UI's Toggle primitive\n  // This provides proper ARIA attributes and keyboard navigation\n  // The IconButton component handles accessibility validation internally\n  return (\n    <Toggle.Root\n      pressed={pressed}\n      onPressedChange={handlePressedChange}\n      defaultPressed={defaultPressed}\n      asChild\n    >\n      <IconButton {...iconButtonProps} ref={forwardedRef} />\n    </Toggle.Root>\n  );\n});\nToggleIconButton.displayName = 'ToggleIconButton';\n\nexport { ToggleIconButton };\nexport type { ToggleIconButtonPropsWithAccessibility as ToggleIconButtonProps };\n"],
-  "mappings": "AAAA,UAAYA,MAAW,QACvB,OAAS,UAAAC,MAAc,WACvB,OAAS,cAAAC,MAAkB,mBAC3B,MAA2B,6BAC3B,OAAS,oBAAAC,MAAwB,iCAsGjC,MAAMC,EAAmBJ,EAAM,WAG7B,CAAC,CAAE,QAAAK,EAAS,gBAAAC,EAAiB,eAAAC,EAAgB,GAAGC,CAAgB,EAAGC,IAAiB,CAEpF,MAAMC,EAAWP,EAAiB,EAO5BQ,EAAoBX,EAAM,YAAY,IAAM,CAChD,KAAM,CACJ,aAAcY,EACd,kBAAmBC,EACnB,SAAAC,CACF,EAAIN,EAGJ,OAAII,IAGAC,EACmB,SAAS,eAAeA,CAAc,GACtC,aAAe,qBAIlC,OAAOC,GAAa,SAAiBA,EACrCd,EAAM,eAAec,CAAQ,GAAK,OAAQA,EAAS,OAAe,UAAa,SACzEA,EAAS,MAAc,SAI1B,qBACT,EAAG,CAACN,CAAe,CAAC,EAMdO,EAAsBf,EAAM,YAC/BgB,GAAwB,CACvB,MAAMC,EAAiBN,EAAkB,EAEzCD,EAAS,GAAGO,CAAc,IAAID,EAAa,UAAY,WAAW,EAAE,EAEpEV,IAAkBU,CAAU,CAC9B,EACA,CAACN,EAAUJ,EAAiBK,CAAiB,CAC/C,EAIA,OAAAX,EAAM,UAAU,IAAM,CAQtB,EAAG,CAACK,EAASC,CAAe,CAAC,EAM3BN,EAAA,cAACC,EAAO,KAAP,CACC,QAASI,EACT,gBAAiBU,EACjB,eAAgBR,EAChB,QAAO,IAEPP,EAAA,cAACE,EAAA,CAAY,GAAGM,EAAiB,IAAKC,EAAc,CACtD,CAEJ,CAAC,EACDL,EAAiB,YAAc",
-  "names": ["React", "Toggle", "IconButton", "useLiveAnnouncer", "ToggleIconButton", "pressed", "onPressedChange", "defaultPressed", "iconButtonProps", "forwardedRef", "announce", "getAccessibleName", "ariaLabel", "ariaLabelledBy", "children", "handlePressedChange", "newPressed", "accessibleName"]
+  "sourcesContent": ["import * as React from 'react';\nimport { Toggle } from 'radix-ui';\nimport { IconButton } from './icon-button.js';\nimport { BaseButton } from './_internal/base-button.js';\nimport { useToggleState } from '../hooks/use-toggle-state.js';\nimport type { IconButtonProps } from './icon-button.js';\n\ntype ToggleIconButtonElement = React.ElementRef<typeof BaseButton>;\n\n/**\n * Extract toggle-specific props from Radix Toggle\n * These props control the toggle state and behavior\n */\ntype ToggleProps = React.ComponentPropsWithoutRef<typeof Toggle.Root>;\n\n/**\n * Required accessibility props for icon buttons (same as IconButton)\n * Icon buttons must have an accessible name to meet WCAG guidelines\n *\n * Three ways to provide accessibility:\n * 1. aria-label: Direct descriptive text\n * 2. aria-labelledby: Reference to a label element\n * 3. children: Visible text content (fallback)\n */\ntype AccessibilityProps =\n  | { 'aria-label': string; 'aria-labelledby'?: never }\n  | { 'aria-label'?: never; 'aria-labelledby': string }\n  | { 'aria-label'?: never; 'aria-labelledby'?: never; children: React.ReactNode };\n\n/**\n * Combine IconButton props with Toggle-specific props\n * Includes tooltip props from IconButton for comprehensive functionality\n */\ninterface ToggleIconButtonProps extends Omit<IconButtonProps, 'as'> {\n  /** Controlled pressed state */\n  pressed?: ToggleProps['pressed'];\n  /** Callback when pressed state changes */\n  onPressedChange?: ToggleProps['onPressedChange'];\n  /** Default pressed state for uncontrolled usage */\n  defaultPressed?: ToggleProps['defaultPressed'];\n}\n\n/**\n * Intersection with accessibility props to ensure compliance\n * This type ensures all ToggleIconButton instances have proper accessibility\n */\ntype ToggleIconButtonPropsWithAccessibility = ToggleIconButtonProps & AccessibilityProps;\n\n/**\n * ToggleIconButton component for icon buttons that can be pressed/unpressed\n *\n * The ToggleIconButton component extends IconButton with toggle functionality\n * using Radix UI's Toggle primitive. It provides proper accessibility announcements,\n * controlled/uncontrolled state management, and seamless integration with\n * the existing IconButton component.\n *\n * Key features:\n * - Controlled and uncontrolled state management\n * - Live accessibility announcements for screen readers\n * - Enforced accessibility requirements (aria-label, aria-labelledby, or children)\n * - Automatic state validation and warnings\n * - Seamless integration with IconButton props and styling\n * - Proper ARIA attributes for toggle functionality\n * - Built-in tooltip support from IconButton\n *\n * @example\n * ```tsx\n * // Uncontrolled toggle icon button\n * <ToggleIconButton defaultPressed={false} aria-label=\"Toggle notifications\">\n *   <Bell />\n * </ToggleIconButton>\n *\n * // Controlled toggle icon button\n * const [pressed, setPressed] = React.useState(false);\n * <ToggleIconButton\n *   pressed={pressed}\n *   onPressedChange={setPressed}\n *   aria-label=\"Toggle notifications\"\n * >\n *   <Bell />\n * </ToggleIconButton>\n *\n * // Toggle icon button with tooltip\n * <ToggleIconButton\n *   variant=\"solid\"\n *   size=\"3\"\n *   color=\"blue\"\n *   pressed={isActive}\n *   onPressedChange={setIsActive}\n *   aria-label=\"Toggle feature\"\n *   tooltip=\"Toggle this feature on/off\"\n * >\n *   <Star />\n * </ToggleIconButton>\n *\n * // Toggle icon button with aria-labelledby\n * <ToggleIconButton\n *   aria-labelledby=\"notifications-label\"\n *   pressed={notificationsEnabled}\n *   onPressedChange={setNotificationsEnabled}\n * >\n *   <Bell />\n * </ToggleIconButton>\n * <span id=\"notifications-label\">Toggle notifications</span>\n * ```\n */\nconst ToggleIconButton = React.forwardRef<ToggleIconButtonElement, ToggleIconButtonPropsWithAccessibility>(({ pressed, onPressedChange, defaultPressed, ...iconButtonProps }, forwardedRef) => {\n  // Extract specific props for stable dependency array\n  const { 'aria-label': ariaLabel, 'aria-labelledby': ariaLabelledBy, children } = iconButtonProps;\n\n  // Cache the label lookup from aria-labelledby to avoid repeated DOM queries\n  const cachedLabelRef = React.useRef<string | null>(null);\n\n  // Clear cached label when ariaLabelledBy changes\n  React.useEffect(() => {\n    cachedLabelRef.current = null;\n  }, [ariaLabelledBy]);\n\n  /**\n   * Extract accessible name from various sources for announcements.\n   * This ensures screen readers announce meaningful state changes.\n   * Priority: aria-label > aria-labelledby > children > fallback\n   */\n  const getAccessibleName = React.useCallback(() => {\n    // First priority: direct aria-label\n    if (ariaLabel) return ariaLabel;\n\n    // Second priority: referenced label element (cached)\n    if (ariaLabelledBy) {\n      if (cachedLabelRef.current === null) {\n        const labelElement = document.getElementById(ariaLabelledBy);\n        cachedLabelRef.current = labelElement?.textContent || 'Toggle icon button';\n      }\n      return cachedLabelRef.current;\n    }\n\n    // Third priority: visible text children\n    if (typeof children === 'string') return children;\n    if (React.isValidElement(children) && typeof (children.props as any)?.children === 'string') {\n      return (children.props as any).children;\n    }\n\n    // Fallback for edge cases\n    return 'Toggle icon button';\n  }, [ariaLabel, ariaLabelledBy, children]);\n\n  // Use shared toggle state hook for accessibility announcements and warnings\n  const { handlePressedChange } = useToggleState({\n    pressed,\n    onPressedChange,\n    getAccessibleName,\n    componentName: 'ToggleIconButton',\n  });\n\n  // Render the toggle icon button using Radix UI's Toggle primitive\n  // This provides proper ARIA attributes and keyboard navigation\n  // The IconButton component handles accessibility validation internally\n  return (\n    <Toggle.Root pressed={pressed} onPressedChange={handlePressedChange} defaultPressed={defaultPressed} asChild>\n      <IconButton {...iconButtonProps} ref={forwardedRef} />\n    </Toggle.Root>\n  );\n});\nToggleIconButton.displayName = 'ToggleIconButton';\n\nexport { ToggleIconButton };\nexport type { ToggleIconButtonPropsWithAccessibility as ToggleIconButtonProps };\n"],
+  "mappings": "AAAA,UAAYA,MAAW,QACvB,OAAS,UAAAC,MAAc,WACvB,OAAS,cAAAC,MAAkB,mBAC3B,MAA2B,6BAC3B,OAAS,kBAAAC,MAAsB,+BAsG/B,MAAMC,EAAmBJ,EAAM,WAA4E,CAAC,CAAE,QAAAK,EAAS,gBAAAC,EAAiB,eAAAC,EAAgB,GAAGC,CAAgB,EAAGC,IAAiB,CAE7L,KAAM,CAAE,aAAcC,EAAW,kBAAmBC,EAAgB,SAAAC,CAAS,EAAIJ,EAG3EK,EAAiBb,EAAM,OAAsB,IAAI,EAGvDA,EAAM,UAAU,IAAM,CACpBa,EAAe,QAAU,IAC3B,EAAG,CAACF,CAAc,CAAC,EAOnB,MAAMG,EAAoBd,EAAM,YAAY,IAAM,CAEhD,GAAIU,EAAW,OAAOA,EAGtB,GAAIC,EAAgB,CAClB,GAAIE,EAAe,UAAY,KAAM,CACnC,MAAME,EAAe,SAAS,eAAeJ,CAAc,EAC3DE,EAAe,QAAUE,GAAc,aAAe,oBACxD,CACA,OAAOF,EAAe,OACxB,CAGA,OAAI,OAAOD,GAAa,SAAiBA,EACrCZ,EAAM,eAAeY,CAAQ,GAAK,OAAQA,EAAS,OAAe,UAAa,SACzEA,EAAS,MAAc,SAI1B,oBACT,EAAG,CAACF,EAAWC,EAAgBC,CAAQ,CAAC,EAGlC,CAAE,oBAAAI,CAAoB,EAAIb,EAAe,CAC7C,QAAAE,EACA,gBAAAC,EACA,kBAAAQ,EACA,cAAe,kBACjB,CAAC,EAKD,OACEd,EAAA,cAACC,EAAO,KAAP,CAAY,QAASI,EAAS,gBAAiBW,EAAqB,eAAgBT,EAAgB,QAAO,IAC1GP,EAAA,cAACE,EAAA,CAAY,GAAGM,EAAiB,IAAKC,EAAc,CACtD,CAEJ,CAAC,EACDL,EAAiB,YAAc",
+  "names": ["React", "Toggle", "IconButton", "useToggleState", "ToggleIconButton", "pressed", "onPressedChange", "defaultPressed", "iconButtonProps", "forwardedRef", "ariaLabel", "ariaLabelledBy", "children", "cachedLabelRef", "getAccessibleName", "labelElement", "handlePressedChange"]
 }

package/dist/esm/hooks/index.d.ts

@@ -1,3 +1,5 @@
 export { useLiveAnnouncer } from './use-live-announcer.js';
 export { useBodyPointerEventsCleanup } from './use-body-pointer-events-cleanup.js';
+export { useTooltipWrapper } from './use-tooltip-wrapper.js';
+export { useToggleState } from './use-toggle-state.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/esm/hooks/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,2BAA2B,EAAE,MAAM,sCAAsC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,2BAA2B,EAAE,MAAM,sCAAsC,CAAC;AACnF,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/esm/hooks/index.js

@@ -1,2 +1,2 @@
-import{useLiveAnnouncer as n}from"./use-live-announcer.js";import{useBodyPointerEventsCleanup as t}from"./use-body-pointer-events-cleanup.js";export{t as useBodyPointerEventsCleanup,n as useLiveAnnouncer};
+import{useLiveAnnouncer as r}from"./use-live-announcer.js";import{useBodyPointerEventsCleanup as p}from"./use-body-pointer-events-cleanup.js";import{useTooltipWrapper as u}from"./use-tooltip-wrapper.js";import{useToggleState as f}from"./use-toggle-state.js";export{p as useBodyPointerEventsCleanup,r as useLiveAnnouncer,f as useToggleState,u as useTooltipWrapper};
 //# sourceMappingURL=index.js.map

package/dist/esm/hooks/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/hooks/index.ts"],
-  "sourcesContent": ["export { useLiveAnnouncer } from './use-live-announcer.js';\nexport { useBodyPointerEventsCleanup } from './use-body-pointer-events-cleanup.js';\n"],
-  "mappings": "AAAA,OAAS,oBAAAA,MAAwB,0BACjC,OAAS,+BAAAC,MAAmC",
-  "names": ["useLiveAnnouncer", "useBodyPointerEventsCleanup"]
+  "sourcesContent": ["export { useLiveAnnouncer } from './use-live-announcer.js';\nexport { useBodyPointerEventsCleanup } from './use-body-pointer-events-cleanup.js';\nexport { useTooltipWrapper } from './use-tooltip-wrapper.js';\nexport { useToggleState } from './use-toggle-state.js';\n"],
+  "mappings": "AAAA,OAAS,oBAAAA,MAAwB,0BACjC,OAAS,+BAAAC,MAAmC,uCAC5C,OAAS,qBAAAC,MAAyB,2BAClC,OAAS,kBAAAC,MAAsB",
+  "names": ["useLiveAnnouncer", "useBodyPointerEventsCleanup", "useTooltipWrapper", "useToggleState"]
 }

package/dist/esm/hooks/use-live-announcer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-live-announcer.d.ts","sourceRoot":"","sources":["../../../src/hooks/use-live-announcer.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,gBAAgB,cA+Be,MAAM,UAcpD"}
+{"version":3,"file":"use-live-announcer.d.ts","sourceRoot":"","sources":["../../../src/hooks/use-live-announcer.ts"],"names":[],"mappings":"AAQA;;;GAGG;AACH,wBAAgB,gBAAgB,cA+Ce,MAAM,UAmBpD"}

package/dist/esm/hooks/use-live-announcer.js

@@ -1,4 +1,4 @@
-import*as n from"react";function o(){return n.useEffect(()=>{let e=document.getElementById("rt-live-announcer");return e||(e=document.createElement("div"),e.id="rt-live-announcer",e.setAttribute("aria-live","polite"),e.setAttribute("aria-atomic","true"),e.style.cssText=`
+import*as i from"react";let o=0;function u(){const n=i.useRef(void 0);return i.useEffect(()=>{let e=document.getElementById("rt-live-announcer");return e||(e=document.createElement("div"),e.id="rt-live-announcer",e.setAttribute("aria-live","polite"),e.setAttribute("aria-atomic","true"),e.style.cssText=`
         position: absolute;
         left: -10000px;
         width: 1px;
@@ -6,5 +6,5 @@ import*as n from"react";function o(){return n.useEffect(()=>{let e=document.getE
         overflow: hidden;
         clip: rect(0, 0, 0, 0);
         white-space: nowrap;
-      `,document.body.appendChild(e)),()=>{e&&!e.hasChildNodes()&&e.remove()}},[]),n.useCallback(e=>{const t=document.getElementById("rt-live-announcer");t&&(t.textContent="",setTimeout(()=>{t.textContent=e},100))},[])}export{o as useLiveAnnouncer};
+      `,document.body.appendChild(e)),o++,()=>{if(o--,n.current&&clearTimeout(n.current),o===0){const t=document.getElementById("rt-live-announcer");t&&t.remove()}}},[]),i.useCallback(e=>{const t=document.getElementById("rt-live-announcer");t&&(n.current&&clearTimeout(n.current),t.textContent="",n.current=setTimeout(()=>{t.textContent=e},100))},[])}export{u as useLiveAnnouncer};
 //# sourceMappingURL=use-live-announcer.js.map

package/dist/esm/hooks/use-live-announcer.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/hooks/use-live-announcer.ts"],
-  "sourcesContent": ["import * as React from 'react';\n\n/**\n * Hook for making live announcements to screen readers\n * Creates a hidden aria-live region for announcing dynamic content changes\n */\nexport function useLiveAnnouncer() {\n\n  // Create aria-live region if it doesn't exist\n  React.useEffect(() => {\n    let liveRegion = document.getElementById('rt-live-announcer');\n    \n    if (!liveRegion) {\n      liveRegion = document.createElement('div');\n      liveRegion.id = 'rt-live-announcer';\n      liveRegion.setAttribute('aria-live', 'polite');\n      liveRegion.setAttribute('aria-atomic', 'true');\n      liveRegion.style.cssText = `\n        position: absolute;\n        left: -10000px;\n        width: 1px;\n        height: 1px;\n        overflow: hidden;\n        clip: rect(0, 0, 0, 0);\n        white-space: nowrap;\n      `;\n      document.body.appendChild(liveRegion);\n    }\n\n    return () => {\n      // Clean up on unmount if no other components are using it\n      if (liveRegion && !liveRegion.hasChildNodes()) {\n        liveRegion.remove();\n      }\n    };\n  }, []);\n\n  const announce = React.useCallback((message: string) => {\n    const liveRegion = document.getElementById('rt-live-announcer');\n    if (liveRegion) {\n      // Clear previous announcements\n      liveRegion.textContent = '';\n      \n      // Add new announcement with a small delay to ensure it's announced\n      setTimeout(() => {\n        liveRegion.textContent = message;\n      }, 100);\n    }\n  }, []);\n\n  return announce;\n} "],
-  "mappings": "AAAA,UAAYA,MAAW,QAMhB,SAASC,GAAmB,CAGjC,OAAAD,EAAM,UAAU,IAAM,CACpB,IAAIE,EAAa,SAAS,eAAe,mBAAmB,EAE5D,OAAKA,IACHA,EAAa,SAAS,cAAc,KAAK,EACzCA,EAAW,GAAK,oBAChBA,EAAW,aAAa,YAAa,QAAQ,EAC7CA,EAAW,aAAa,cAAe,MAAM,EAC7CA,EAAW,MAAM,QAAU;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,QAS3B,SAAS,KAAK,YAAYA,CAAU,GAG/B,IAAM,CAEPA,GAAc,CAACA,EAAW,cAAc,GAC1CA,EAAW,OAAO,CAEtB,CACF,EAAG,CAAC,CAAC,EAEYF,EAAM,YAAaG,GAAoB,CACtD,MAAMD,EAAa,SAAS,eAAe,mBAAmB,EAC1DA,IAEFA,EAAW,YAAc,GAGzB,WAAW,IAAM,CACfA,EAAW,YAAcC,CAC3B,EAAG,GAAG,EAEV,EAAG,CAAC,CAAC,CAGP",
-  "names": ["React", "useLiveAnnouncer", "liveRegion", "message"]
+  "sourcesContent": ["import * as React from 'react';\n\n/**\n * Reference counter to track how many components are using the live region.\n * Only remove the live region when no components are using it.\n */\nlet liveRegionRefCount = 0;\n\n/**\n * Hook for making live announcements to screen readers\n * Creates a hidden aria-live region for announcing dynamic content changes\n */\nexport function useLiveAnnouncer() {\n  // Track the timeout so we can clean it up on unmount\n  const timeoutRef = React.useRef<ReturnType<typeof setTimeout> | undefined>(undefined);\n\n  // Create aria-live region if it doesn't exist\n  React.useEffect(() => {\n    let liveRegion = document.getElementById('rt-live-announcer');\n\n    if (!liveRegion) {\n      liveRegion = document.createElement('div');\n      liveRegion.id = 'rt-live-announcer';\n      liveRegion.setAttribute('aria-live', 'polite');\n      liveRegion.setAttribute('aria-atomic', 'true');\n      liveRegion.style.cssText = `\n        position: absolute;\n        left: -10000px;\n        width: 1px;\n        height: 1px;\n        overflow: hidden;\n        clip: rect(0, 0, 0, 0);\n        white-space: nowrap;\n      `;\n      document.body.appendChild(liveRegion);\n    }\n\n    // Increment ref count when component mounts\n    liveRegionRefCount++;\n\n    return () => {\n      // Decrement ref count when component unmounts\n      liveRegionRefCount--;\n\n      // Clean up timeout on unmount\n      if (timeoutRef.current) {\n        clearTimeout(timeoutRef.current);\n      }\n\n      // Only remove the live region if no components are using it\n      if (liveRegionRefCount === 0) {\n        const region = document.getElementById('rt-live-announcer');\n        if (region) {\n          region.remove();\n        }\n      }\n    };\n  }, []);\n\n  const announce = React.useCallback((message: string) => {\n    const liveRegion = document.getElementById('rt-live-announcer');\n    if (liveRegion) {\n      // Clear any pending timeout\n      if (timeoutRef.current) {\n        clearTimeout(timeoutRef.current);\n      }\n\n      // Clear previous announcements\n      liveRegion.textContent = '';\n\n      // Add new announcement with a small delay to ensure it's announced\n      timeoutRef.current = setTimeout(() => {\n        liveRegion.textContent = message;\n      }, 100);\n    }\n  }, []);\n\n  return announce;\n}\n"],
+  "mappings": "AAAA,UAAYA,MAAW,QAMvB,IAAIC,EAAqB,EAMlB,SAASC,GAAmB,CAEjC,MAAMC,EAAaH,EAAM,OAAkD,MAAS,EAGpF,OAAAA,EAAM,UAAU,IAAM,CACpB,IAAII,EAAa,SAAS,eAAe,mBAAmB,EAE5D,OAAKA,IACHA,EAAa,SAAS,cAAc,KAAK,EACzCA,EAAW,GAAK,oBAChBA,EAAW,aAAa,YAAa,QAAQ,EAC7CA,EAAW,aAAa,cAAe,MAAM,EAC7CA,EAAW,MAAM,QAAU;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,QAS3B,SAAS,KAAK,YAAYA,CAAU,GAItCH,IAEO,IAAM,CAUX,GARAA,IAGIE,EAAW,SACb,aAAaA,EAAW,OAAO,EAI7BF,IAAuB,EAAG,CAC5B,MAAMI,EAAS,SAAS,eAAe,mBAAmB,EACtDA,GACFA,EAAO,OAAO,CAElB,CACF,CACF,EAAG,CAAC,CAAC,EAEYL,EAAM,YAAaM,GAAoB,CACtD,MAAMF,EAAa,SAAS,eAAe,mBAAmB,EAC1DA,IAEED,EAAW,SACb,aAAaA,EAAW,OAAO,EAIjCC,EAAW,YAAc,GAGzBD,EAAW,QAAU,WAAW,IAAM,CACpCC,EAAW,YAAcE,CAC3B,EAAG,GAAG,EAEV,EAAG,CAAC,CAAC,CAGP",
+  "names": ["React", "liveRegionRefCount", "useLiveAnnouncer", "timeoutRef", "liveRegion", "region", "message"]
 }

package/dist/esm/hooks/use-toggle-state.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Options for the useToggleState hook
+ */
+interface UseToggleStateOptions {
+    /** Controlled pressed state */
+    pressed?: boolean;
+    /** Callback when pressed state changes */
+    onPressedChange?: (pressed: boolean) => void;
+    /** Function to get the accessible name for announcements */
+    getAccessibleName: () => string;
+    /** Component name for warning messages */
+    componentName: string;
+}
+/**
+ * Hook for shared toggle button state management.
+ * Provides accessibility announcements and controlled/uncontrolled warnings.
+ *
+ * @param options - Configuration options for the toggle state
+ * @returns Object containing the handlePressedChange callback
+ *
+ * @example
+ * ```tsx
+ * const getAccessibleName = React.useCallback(() => 'Toggle button', []);
+ *
+ * const { handlePressedChange } = useToggleState({
+ *   pressed,
+ *   onPressedChange,
+ *   getAccessibleName,
+ *   componentName: 'ToggleButton',
+ * });
+ * ```
+ */
+export declare function useToggleState({ pressed, onPressedChange, getAccessibleName, componentName }: UseToggleStateOptions): {
+    handlePressedChange: (newPressed: boolean) => void;
+};
+export {};
+//# sourceMappingURL=use-toggle-state.d.ts.map

package/dist/esm/hooks/use-toggle-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-toggle-state.d.ts","sourceRoot":"","sources":["../../../src/hooks/use-toggle-state.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,UAAU,qBAAqB;IAC7B,+BAA+B;IAC/B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,0CAA0C;IAC1C,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IAC7C,4DAA4D;IAC5D,iBAAiB,EAAE,MAAM,MAAM,CAAC;IAChC,0CAA0C;IAC1C,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,cAAc,CAAC,EAAE,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,aAAa,EAAE,EAAE,qBAAqB;sCAWnG,OAAO;EAwBvB"}

package/dist/esm/hooks/use-toggle-state.js

@@ -0,0 +1,2 @@
+import*as n from"react";import{useLiveAnnouncer as i}from"./use-live-announcer.js";function p({pressed:r,onPressedChange:e,getAccessibleName:o,componentName:a}){const s=i(),l=n.useRef(!1),d=n.useCallback(t=>{const u=o();s(`${u} ${t?"pressed":"unpressed"}`),e?.(t)},[s,e,o]);return n.useEffect(()=>{},[r,e,a]),{handlePressedChange:d}}export{p as useToggleState};
+//# sourceMappingURL=use-toggle-state.js.map

package/dist/esm/hooks/use-toggle-state.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/hooks/use-toggle-state.ts"],
+  "sourcesContent": ["import * as React from 'react';\nimport { useLiveAnnouncer } from './use-live-announcer.js';\n\n/**\n * Options for the useToggleState hook\n */\ninterface UseToggleStateOptions {\n  /** Controlled pressed state */\n  pressed?: boolean;\n  /** Callback when pressed state changes */\n  onPressedChange?: (pressed: boolean) => void;\n  /** Function to get the accessible name for announcements */\n  getAccessibleName: () => string;\n  /** Component name for warning messages */\n  componentName: string;\n}\n\n/**\n * Hook for shared toggle button state management.\n * Provides accessibility announcements and controlled/uncontrolled warnings.\n *\n * @param options - Configuration options for the toggle state\n * @returns Object containing the handlePressedChange callback\n *\n * @example\n * ```tsx\n * const getAccessibleName = React.useCallback(() => 'Toggle button', []);\n *\n * const { handlePressedChange } = useToggleState({\n *   pressed,\n *   onPressedChange,\n *   getAccessibleName,\n *   componentName: 'ToggleButton',\n * });\n * ```\n */\nexport function useToggleState({ pressed, onPressedChange, getAccessibleName, componentName }: UseToggleStateOptions) {\n  const announce = useLiveAnnouncer();\n\n  // Track if we've already warned about controlled without handler\n  const warnedRef = React.useRef(false);\n\n  /**\n   * Memoized handler for state changes with accessibility announcements.\n   * Announces the new state immediately for screen readers.\n   */\n  const handlePressedChange = React.useCallback(\n    (newPressed: boolean) => {\n      const accessibleName = getAccessibleName();\n      // Announce the state change for screen readers\n      announce(`${accessibleName} ${newPressed ? 'pressed' : 'unpressed'}`);\n      // Call the user's change handler\n      onPressedChange?.(newPressed);\n    },\n    [announce, onPressedChange, getAccessibleName],\n  );\n\n  // Development-only warning for controlled/uncontrolled pattern\n  // Only warns once to avoid console spam\n  React.useEffect(() => {\n    if (process.env.NODE_ENV === 'development' && pressed !== undefined && onPressedChange === undefined && !warnedRef.current) {\n      warnedRef.current = true;\n      console.warn(\n        `${componentName}: You provided a \\`pressed\\` prop without an \\`onPressedChange\\` handler. ` +\n          'This will result in a read-only toggle button. If you want the button to be interactive, ' +\n          'you should provide an `onPressedChange` handler.',\n      );\n    }\n  }, [pressed, onPressedChange, componentName]);\n\n  return { handlePressedChange };\n}\n"],
+  "mappings": "AAAA,UAAYA,MAAW,QACvB,OAAS,oBAAAC,MAAwB,0BAmC1B,SAASC,EAAe,CAAE,QAAAC,EAAS,gBAAAC,EAAiB,kBAAAC,EAAmB,cAAAC,CAAc,EAA0B,CACpH,MAAMC,EAAWN,EAAiB,EAG5BO,EAAYR,EAAM,OAAO,EAAK,EAM9BS,EAAsBT,EAAM,YAC/BU,GAAwB,CACvB,MAAMC,EAAiBN,EAAkB,EAEzCE,EAAS,GAAGI,CAAc,IAAID,EAAa,UAAY,WAAW,EAAE,EAEpEN,IAAkBM,CAAU,CAC9B,EACA,CAACH,EAAUH,EAAiBC,CAAiB,CAC/C,EAIA,OAAAL,EAAM,UAAU,IAAM,CAStB,EAAG,CAACG,EAASC,EAAiBE,CAAa,CAAC,EAErC,CAAE,oBAAAG,CAAoB,CAC/B",
+  "names": ["React", "useLiveAnnouncer", "useToggleState", "pressed", "onPressedChange", "getAccessibleName", "componentName", "announce", "warnedRef", "handlePressedChange", "newPressed", "accessibleName"]
+}

package/dist/esm/hooks/use-tooltip-wrapper.d.ts

@@ -0,0 +1,29 @@
+import * as React from 'react';
+/**
+ * Hook for managing tooltip accessibility props and conditional rendering.
+ * Encapsulates tooltip ID generation and aria-describedby binding.
+ *
+ * @param tooltip - The tooltip content (if any)
+ * @returns Object containing tooltipId, hasTooltip flag, and accessibility props
+ *
+ * @example
+ * ```tsx
+ * const { tooltipId, hasTooltip, accessibilityProps } = useTooltipWrapper(tooltip);
+ *
+ * const button = <button {...accessibilityProps}>Click me</button>;
+ *
+ * if (!hasTooltip) return button;
+ *
+ * return <Tooltip id={tooltipId} content={tooltip}>{button}</Tooltip>;
+ * ```
+ */
+export declare function useTooltipWrapper(tooltip: React.ReactNode): {
+    tooltipId: string;
+    hasTooltip: boolean;
+    accessibilityProps: {
+        'aria-describedby': string;
+    } | {
+        'aria-describedby'?: undefined;
+    };
+};
+//# sourceMappingURL=use-tooltip-wrapper.d.ts.map

package/dist/esm/hooks/use-tooltip-wrapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-tooltip-wrapper.d.ts","sourceRoot":"","sources":["../../../src/hooks/use-tooltip-wrapper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,KAAK,CAAC,SAAS;;;;;;;;EAOzD"}

package/dist/esm/hooks/use-tooltip-wrapper.js

@@ -0,0 +1,2 @@
+import*as t from"react";function c(s){const o=t.useId(),e=!!s,a=t.useMemo(()=>e?{"aria-describedby":o}:{},[e,o]);return{tooltipId:o,hasTooltip:e,accessibilityProps:a}}export{c as useTooltipWrapper};
+//# sourceMappingURL=use-tooltip-wrapper.js.map

package/dist/esm/hooks/use-tooltip-wrapper.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/hooks/use-tooltip-wrapper.ts"],
+  "sourcesContent": ["import * as React from 'react';\n\n/**\n * Hook for managing tooltip accessibility props and conditional rendering.\n * Encapsulates tooltip ID generation and aria-describedby binding.\n *\n * @param tooltip - The tooltip content (if any)\n * @returns Object containing tooltipId, hasTooltip flag, and accessibility props\n *\n * @example\n * ```tsx\n * const { tooltipId, hasTooltip, accessibilityProps } = useTooltipWrapper(tooltip);\n *\n * const button = <button {...accessibilityProps}>Click me</button>;\n *\n * if (!hasTooltip) return button;\n *\n * return <Tooltip id={tooltipId} content={tooltip}>{button}</Tooltip>;\n * ```\n */\nexport function useTooltipWrapper(tooltip: React.ReactNode) {\n  const tooltipId = React.useId();\n  const hasTooltip = Boolean(tooltip);\n\n  const accessibilityProps = React.useMemo(() => (hasTooltip ? { 'aria-describedby': tooltipId } : {}), [hasTooltip, tooltipId]);\n\n  return { tooltipId, hasTooltip, accessibilityProps };\n}\n"],
+  "mappings": "AAAA,UAAYA,MAAW,QAoBhB,SAASC,EAAkBC,EAA0B,CAC1D,MAAMC,EAAYH,EAAM,MAAM,EACxBI,EAAa,EAAQF,EAErBG,EAAqBL,EAAM,QAAQ,IAAOI,EAAa,CAAE,mBAAoBD,CAAU,EAAI,CAAC,EAAI,CAACC,EAAYD,CAAS,CAAC,EAE7H,MAAO,CAAE,UAAAA,EAAW,WAAAC,EAAY,mBAAAC,CAAmB,CACrD",
+  "names": ["React", "useTooltipWrapper", "tooltip", "tooltipId", "hasTooltip", "accessibilityProps"]
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kushagradhawan/kookie-ui",
-  "version": "0.1.70",
+  "version": "0.1.72",
   "description": "A modern React component library with beautiful design tokens, flexible theming, and comprehensive docs",
   "keywords": [
     "react",
@@ -193,12 +193,12 @@
     "typescript-eslint": "^8.18.1",
     "vitest": "^2.1.9"
   },
-  "homepage": "https://github.com/kushagradhawan/kookie-ui",
+  "homepage": "https://github.com/KushagraDhawan1997/kookie-ui",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/kushagradhawan/kookie-ui.git"
+    "url": "git+https://github.com/KushagraDhawan1997/kookie-ui.git"
   },
   "bugs": {
-    "url": "https://github.com/kushagradhawan/kookie-ui/issues"
+    "url": "https://github.com/KushagraDhawan1997/kookie-ui/issues"
   }
 }

package/schemas/base-button.json

@@ -279,6 +279,6 @@
   "title": "Base-button Component Props",
   "description": "Props schema for the base-button component in Kookie UI",
   "version": "1.0.0",
-  "generatedAt": "2025-12-06T17:47:26.225Z",
+  "generatedAt": "2025-12-23T11:05:44.037Z",
   "source": "Zod schema"
 }

package/schemas/button.json

@@ -530,6 +530,6 @@
   "title": "Button Component Props",
   "description": "Props schema for the button component in Kookie UI",
   "version": "1.0.0",
-  "generatedAt": "2025-12-06T17:47:26.230Z",
+  "generatedAt": "2025-12-23T11:05:44.044Z",
   "source": "Zod schema"
 }

package/schemas/icon-button.json

@@ -313,6 +313,6 @@
   "title": "Icon-button Component Props",
   "description": "Props schema for the icon-button component in Kookie UI",
   "version": "1.0.0",
-  "generatedAt": "2025-12-06T17:47:26.232Z",
+  "generatedAt": "2025-12-23T11:05:44.045Z",
   "source": "Zod schema"
 }

package/schemas/index.json

@@ -3,7 +3,7 @@
   "title": "Kookie UI Button Components",
   "description": "Complete JSON Schema collection for all button components in Kookie UI",
   "version": "1.0.0",
-  "generatedAt": "2025-12-06T17:47:26.234Z",
+  "generatedAt": "2025-12-23T11:05:44.048Z",
   "source": "Zod schemas",
   "components": {
     "base-button": {
@@ -287,7 +287,7 @@
       "title": "Base-button Component Props",
       "description": "Props schema for the base-button component in Kookie UI",
       "version": "1.0.0",
-      "generatedAt": "2025-12-06T17:47:26.225Z",
+      "generatedAt": "2025-12-23T11:05:44.037Z",
       "source": "Zod schema"
     },
     "button": {
@@ -822,7 +822,7 @@
       "title": "Button Component Props",
       "description": "Props schema for the button component in Kookie UI",
       "version": "1.0.0",
-      "generatedAt": "2025-12-06T17:47:26.230Z",
+      "generatedAt": "2025-12-23T11:05:44.044Z",
       "source": "Zod schema"
     },
     "icon-button": {
@@ -1140,7 +1140,7 @@
       "title": "Icon-button Component Props",
       "description": "Props schema for the icon-button component in Kookie UI",
       "version": "1.0.0",
-      "generatedAt": "2025-12-06T17:47:26.232Z",
+      "generatedAt": "2025-12-23T11:05:44.045Z",
       "source": "Zod schema"
     },
     "toggle-button": {
@@ -1683,7 +1683,7 @@
       "title": "Toggle-button Component Props",
       "description": "Props schema for the toggle-button component in Kookie UI",
       "version": "1.0.0",
-      "generatedAt": "2025-12-06T17:47:26.233Z",
+      "generatedAt": "2025-12-23T11:05:44.047Z",
       "source": "Zod schema"
     },
     "toggle-icon-button": {
@@ -2009,7 +2009,7 @@
       "title": "Toggle-icon-button Component Props",
       "description": "Props schema for the toggle-icon-button component in Kookie UI",
       "version": "1.0.0",
-      "generatedAt": "2025-12-06T17:47:26.234Z",
+      "generatedAt": "2025-12-23T11:05:44.048Z",
       "source": "Zod schema"
     }
   }

package/schemas/toggle-button.json

@@ -538,6 +538,6 @@
   "title": "Toggle-button Component Props",
   "description": "Props schema for the toggle-button component in Kookie UI",
   "version": "1.0.0",
-  "generatedAt": "2025-12-06T17:47:26.233Z",
+  "generatedAt": "2025-12-23T11:05:44.047Z",
   "source": "Zod schema"
 }

package/schemas/toggle-icon-button.json

@@ -321,6 +321,6 @@
   "title": "Toggle-icon-button Component Props",
   "description": "Props schema for the toggle-icon-button component in Kookie UI",
   "version": "1.0.0",
-  "generatedAt": "2025-12-06T17:47:26.234Z",
+  "generatedAt": "2025-12-23T11:05:44.048Z",
   "source": "Zod schema"
 }