@accelint/design-toolkit 9.2.0 → 9.4.0

package/dist/components/hero/subtitle.d.ts

@@ -11,11 +11,26 @@
  */
 
 import "client-only";
-import * as react0 from "react";
+import * as react21 from "react";
 import * as react_aria_components0 from "react-aria-components";
 
 //#region src/components/hero/subtitle.d.ts
-declare const HeroSubtitle: react0.ForwardRefExoticComponent<react_aria_components0.TextProps & react0.RefAttributes<HTMLElement>>;
+/**
+ * HeroSubtitle - Secondary text content for the Hero component.
+ *
+ * Zero or more allowed per Hero for displaying additional metadata.
+ *
+ * @example
+ * ```tsx
+ * <Hero>
+ *   <Icon><User /></Icon>
+ *   <HeroTitle>John Doe</HeroTitle>
+ *   <HeroSubtitle>Software Engineer</HeroSubtitle>
+ *   <HeroSubtitle>San Francisco, CA</HeroSubtitle>
+ * </Hero>
+ * ```
+ */
+declare const HeroSubtitle: react21.ForwardRefExoticComponent<react_aria_components0.TextProps & react21.RefAttributes<HTMLElement>>;
 //#endregion
 export { HeroSubtitle };
 //# sourceMappingURL=subtitle.d.ts.map

package/dist/components/hero/subtitle.js

@@ -17,6 +17,21 @@ import "client-only";
 import { Text } from "react-aria-components";
 
 //#region src/components/hero/subtitle.tsx
+/**
+* HeroSubtitle - Secondary text content for the Hero component.
+*
+* Zero or more allowed per Hero for displaying additional metadata.
+*
+* @example
+* ```tsx
+* <Hero>
+*   <Icon><User /></Icon>
+*   <HeroTitle>John Doe</HeroTitle>
+*   <HeroSubtitle>Software Engineer</HeroSubtitle>
+*   <HeroSubtitle>San Francisco, CA</HeroSubtitle>
+* </Hero>
+* ```
+*/
 const HeroSubtitle = Text;
 
 //#endregion

package/dist/components/hero/subtitle.js.map

@@ -1 +1 @@
-{"version":3,"file":"subtitle.js","names":[],"sources":["../../../src/components/hero/subtitle.tsx"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n'use client';\n\nimport 'client-only';\nimport { Text } from 'react-aria-components';\n\nexport const HeroSubtitle = Text;\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAgBA,MAAa,eAAe"}
+{"version":3,"file":"subtitle.js","names":[],"sources":["../../../src/components/hero/subtitle.tsx"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n'use client';\n\nimport 'client-only';\nimport { Text } from 'react-aria-components';\n\n/**\n * HeroSubtitle - Secondary text content for the Hero component.\n *\n * Zero or more allowed per Hero for displaying additional metadata.\n *\n * @example\n * ```tsx\n * <Hero>\n *   <Icon><User /></Icon>\n *   <HeroTitle>John Doe</HeroTitle>\n *   <HeroSubtitle>Software Engineer</HeroSubtitle>\n *   <HeroSubtitle>San Francisco, CA</HeroSubtitle>\n * </Hero>\n * ```\n */\nexport const HeroSubtitle = Text;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+BA,MAAa,eAAe"}

package/dist/components/hero/title.d.ts

@@ -11,11 +11,24 @@
  */
 
 import "client-only";
-import * as react9 from "react";
+import * as react18 from "react";
 import * as react_aria_components0 from "react-aria-components";
 
 //#region src/components/hero/title.d.ts
-declare const HeroTitle: react9.ForwardRefExoticComponent<react_aria_components0.HeadingProps & react9.RefAttributes<HTMLHeadingElement>>;
+/**
+ * HeroTitle - Primary heading for the Hero component.
+ *
+ * Renders as an `<h2>` element. Exactly one required per Hero.
+ *
+ * @example
+ * ```tsx
+ * <Hero>
+ *   <Icon><Placeholder /></Icon>
+ *   <HeroTitle>Primary Title</HeroTitle>
+ * </Hero>
+ * ```
+ */
+declare const HeroTitle: react18.ForwardRefExoticComponent<react_aria_components0.HeadingProps & react18.RefAttributes<HTMLHeadingElement>>;
 //#endregion
 export { HeroTitle };
 //# sourceMappingURL=title.d.ts.map

package/dist/components/hero/title.js

@@ -17,6 +17,19 @@ import "client-only";
 import { Heading } from "react-aria-components";
 
 //#region src/components/hero/title.tsx
+/**
+* HeroTitle - Primary heading for the Hero component.
+*
+* Renders as an `<h2>` element. Exactly one required per Hero.
+*
+* @example
+* ```tsx
+* <Hero>
+*   <Icon><Placeholder /></Icon>
+*   <HeroTitle>Primary Title</HeroTitle>
+* </Hero>
+* ```
+*/
 const HeroTitle = Heading;
 
 //#endregion

package/dist/components/hero/title.js.map

@@ -1 +1 @@
-{"version":3,"file":"title.js","names":[],"sources":["../../../src/components/hero/title.tsx"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n'use client';\n\nimport 'client-only';\nimport { Heading } from 'react-aria-components';\n\nexport const HeroTitle = Heading;\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAgBA,MAAa,YAAY"}
+{"version":3,"file":"title.js","names":[],"sources":["../../../src/components/hero/title.tsx"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n'use client';\n\nimport 'client-only';\nimport { Heading } from 'react-aria-components';\n\n/**\n * HeroTitle - Primary heading for the Hero component.\n *\n * Renders as an `<h2>` element. Exactly one required per Hero.\n *\n * @example\n * ```tsx\n * <Hero>\n *   <Icon><Placeholder /></Icon>\n *   <HeroTitle>Primary Title</HeroTitle>\n * </Hero>\n * ```\n */\nexport const HeroTitle = Heading;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6BA,MAAa,YAAY"}

package/dist/components/hero/types.d.ts

@@ -13,13 +13,22 @@
 import { ComponentPropsWithRef } from "react";
 
 //#region src/components/hero/types.d.ts
+/**
+ * Props for the Hero component.
+ */
 type HeroProps = Omit<ComponentPropsWithRef<'header'>, 'className'> & {
+  /** Class names for Hero sub-elements. */
   classNames?: {
+    /** Class name for the hero container. */
     hero?: string;
+    /** Class name for the icon. */
     icon?: string;
+    /** Class name for the title. */
     title?: string;
+    /** Class name for the subtitle. */
     subtitle?: string;
   };
+  /** Whether to use compact grid layout instead of stacked layout. */
   compact?: boolean;
 };
 //#endregion

package/dist/components/hotkey/context.d.ts

@@ -13,16 +13,36 @@
 import { ProviderProps } from "../../lib/types.js";
 import { HotkeyProps } from "./types.js";
 import "client-only";
-import * as react16 from "react";
+import * as react20 from "react";
 import { ContextValue } from "react-aria-components";
-import * as react_jsx_runtime58 from "react/jsx-runtime";
+import * as react_jsx_runtime52 from "react/jsx-runtime";
 
 //#region src/components/hotkey/context.d.ts
-declare const HotkeyContext: react16.Context<ContextValue<HotkeyProps, HTMLElement>>;
+/**
+ * Context for sharing Hotkey props across component tree.
+ */
+declare const HotkeyContext: react20.Context<ContextValue<HotkeyProps, HTMLElement>>;
+/**
+ * HotkeyProvider - Context provider for setting default Hotkey props.
+ *
+ * Use this to configure shared variant across multiple Hotkey components.
+ *
+ * @param props - ProviderProps<HotkeyProps>
+ * @param props.children - Child components to receive context.
+ * @returns The rendered HotkeyProvider component.
+ *
+ * @example
+ * ```tsx
+ * <HotkeyProvider variant="flat">
+ *   <Hotkey>Ctrl</Hotkey>
+ *   <Hotkey>C</Hotkey>
+ * </HotkeyProvider>
+ * ```
+ */
 declare function HotkeyProvider({
   children,
   ...props
-}: ProviderProps<HotkeyProps>): react_jsx_runtime58.JSX.Element;
+}: ProviderProps<HotkeyProps>): react_jsx_runtime52.JSX.Element;
 //#endregion
 export { HotkeyContext, HotkeyProvider };
 //# sourceMappingURL=context.d.ts.map

package/dist/components/hotkey/context.js

@@ -18,7 +18,27 @@ import { createContext } from "react";
 import { jsx } from "react/jsx-runtime";
 
 //#region src/components/hotkey/context.tsx
+/**
+* Context for sharing Hotkey props across component tree.
+*/
 const HotkeyContext = createContext(null);
+/**
+* HotkeyProvider - Context provider for setting default Hotkey props.
+*
+* Use this to configure shared variant across multiple Hotkey components.
+*
+* @param props - ProviderProps<HotkeyProps>
+* @param props.children - Child components to receive context.
+* @returns The rendered HotkeyProvider component.
+*
+* @example
+* ```tsx
+* <HotkeyProvider variant="flat">
+*   <Hotkey>Ctrl</Hotkey>
+*   <Hotkey>C</Hotkey>
+* </HotkeyProvider>
+* ```
+*/
 function HotkeyProvider({ children, ...props }) {
 	return /* @__PURE__ */ jsx(HotkeyContext.Provider, {
 		value: props,

package/dist/components/hotkey/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/hotkey/context.tsx"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\n'use client';\n\nimport type { ProviderProps } from '@/lib/types';\nimport 'client-only';\nimport { createContext } from 'react';\nimport type { ContextValue } from 'react-aria-components';\nimport type { HotkeyProps } from './types';\n\nexport const HotkeyContext =\n  createContext<ContextValue<HotkeyProps, HTMLElement>>(null);\n\nexport function HotkeyProvider({\n  children,\n  ...props\n}: ProviderProps<HotkeyProps>) {\n  return (\n    <HotkeyContext.Provider value={props}>{children}</HotkeyContext.Provider>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAoBA,MAAa,gBACX,cAAsD,KAAK;AAE7D,SAAgB,eAAe,EAC7B,UACA,GAAG,SAC0B;AAC7B,QACE,oBAAC,cAAc;EAAS,OAAO;EAAQ;GAAkC"}
+{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/hotkey/context.tsx"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\n'use client';\n\nimport type { ProviderProps } from '@/lib/types';\nimport 'client-only';\nimport { createContext } from 'react';\nimport type { ContextValue } from 'react-aria-components';\nimport type { HotkeyProps } from './types';\n\n/**\n * Context for sharing Hotkey props across component tree.\n */\nexport const HotkeyContext =\n  createContext<ContextValue<HotkeyProps, HTMLElement>>(null);\n\n/**\n * HotkeyProvider - Context provider for setting default Hotkey props.\n *\n * Use this to configure shared variant across multiple Hotkey components.\n *\n * @param props - ProviderProps<HotkeyProps>\n * @param props.children - Child components to receive context.\n * @returns The rendered HotkeyProvider component.\n *\n * @example\n * ```tsx\n * <HotkeyProvider variant=\"flat\">\n *   <Hotkey>Ctrl</Hotkey>\n *   <Hotkey>C</Hotkey>\n * </HotkeyProvider>\n * ```\n */\nexport function HotkeyProvider({\n  children,\n  ...props\n}: ProviderProps<HotkeyProps>) {\n  return (\n    <HotkeyContext.Provider value={props}>{children}</HotkeyContext.Provider>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAuBA,MAAa,gBACX,cAAsD,KAAK;;;;;;;;;;;;;;;;;;AAmB7D,SAAgB,eAAe,EAC7B,UACA,GAAG,SAC0B;AAC7B,QACE,oBAAC,cAAc;EAAS,OAAO;EAAQ;GAAkC"}

package/dist/components/hotkey/index.d.ts

@@ -12,7 +12,7 @@
 
 import { HotkeyProps } from "./types.js";
 import "client-only";
-import * as react_jsx_runtime59 from "react/jsx-runtime";
+import * as react_jsx_runtime55 from "react/jsx-runtime";
 
 //#region src/components/hotkey/index.d.ts
 
@@ -24,34 +24,49 @@ import * as react_jsx_runtime59 from "react/jsx-runtime";
  * keyboard shortcuts. Supports multiple visual styles including outlined keys,
  * flat presentation, and icon-specific formatting.
  *
+ * @param props - {@link HotkeyProps}
+ * @param props.ref - Ref to the kbd element.
+ * @param props.children - Key text or icon to display.
+ * @param props.className - Optional CSS class name.
+ * @param props.variant - Visual style variant.
+ * @returns The rendered Hotkey component.
+ *
  * @example
+ * ```tsx
  * // Basic hotkey display
  * <Hotkey>Ctrl</Hotkey>
+ * ```
  *
  * @example
+ * ```tsx
  * // Hotkey combination with different variants
  * <HotkeySet>
  *   <Hotkey variant="outline">Cmd</Hotkey>
  *   <span>+</span>
  *   <Hotkey variant="outline">K</Hotkey>
  * </HotkeySet>
+ * ```
  *
  * @example
+ * ```tsx
  * // Flat style for inline text
  * <p>Press <Hotkey variant="flat">Enter</Hotkey> to submit</p>
+ * ```
  *
  * @example
+ * ```tsx
  * // Icon variant for special keys
  * <HotkeySet>
  *   <Hotkey variant="icon">⌘</Hotkey>
  *   <Hotkey>Space</Hotkey>
  * </HotkeySet>
+ * ```
  */
 declare function Hotkey({
   ref,
   children,
   ...props
-}: HotkeyProps): react_jsx_runtime59.JSX.Element;
+}: HotkeyProps): react_jsx_runtime55.JSX.Element;
 //#endregion
 export { Hotkey };
 //# sourceMappingURL=index.d.ts.map

package/dist/components/hotkey/index.js

@@ -29,28 +29,43 @@ import styles from "./styles.module.css";
 * keyboard shortcuts. Supports multiple visual styles including outlined keys,
 * flat presentation, and icon-specific formatting.
 *
+* @param props - {@link HotkeyProps}
+* @param props.ref - Ref to the kbd element.
+* @param props.children - Key text or icon to display.
+* @param props.className - Optional CSS class name.
+* @param props.variant - Visual style variant.
+* @returns The rendered Hotkey component.
+*
 * @example
+* ```tsx
 * // Basic hotkey display
 * <Hotkey>Ctrl</Hotkey>
+* ```
 *
 * @example
+* ```tsx
 * // Hotkey combination with different variants
 * <HotkeySet>
 *   <Hotkey variant="outline">Cmd</Hotkey>
 *   <span>+</span>
 *   <Hotkey variant="outline">K</Hotkey>
 * </HotkeySet>
+* ```
 *
 * @example
+* ```tsx
 * // Flat style for inline text
 * <p>Press <Hotkey variant="flat">Enter</Hotkey> to submit</p>
+* ```
 *
 * @example
+* ```tsx
 * // Icon variant for special keys
 * <HotkeySet>
 *   <Hotkey variant="icon">⌘</Hotkey>
 *   <Hotkey>Space</Hotkey>
 * </HotkeySet>
+* ```
 */
 function Hotkey({ ref, children, ...props }) {
 	[props, ref] = useContextProps(props, ref ?? null, HotkeyContext);

package/dist/components/hotkey/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../src/components/hotkey/index.tsx"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\n'use client';\n\nimport 'client-only';\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport { Keyboard, useContextProps } from 'react-aria-components';\nimport { HotkeyContext } from './context';\nimport styles from './styles.module.css';\nimport type { HotkeyProps } from './types';\n\n/**\n * Hotkey - A visual representation of keyboard shortcuts and key combinations\n *\n * Displays keyboard keys and shortcuts in a consistent, accessible format.\n * Perfect for documentation, help systems, or UI elements that need to show\n * keyboard shortcuts. Supports multiple visual styles including outlined keys,\n * flat presentation, and icon-specific formatting.\n *\n * @example\n * // Basic hotkey display\n * <Hotkey>Ctrl</Hotkey>\n *\n * @example\n * // Hotkey combination with different variants\n * <HotkeySet>\n *   <Hotkey variant=\"outline\">Cmd</Hotkey>\n *   <span>+</span>\n *   <Hotkey variant=\"outline\">K</Hotkey>\n * </HotkeySet>\n *\n * @example\n * // Flat style for inline text\n * <p>Press <Hotkey variant=\"flat\">Enter</Hotkey> to submit</p>\n *\n * @example\n * // Icon variant for special keys\n * <HotkeySet>\n *   <Hotkey variant=\"icon\">⌘</Hotkey>\n *   <Hotkey>Space</Hotkey>\n * </HotkeySet>\n */\nexport function Hotkey({ ref, children, ...props }: HotkeyProps) {\n  [props, ref] = useContextProps(props, ref ?? null, HotkeyContext);\n\n  const { className, variant = 'outline', ...rest } = props;\n\n  return (\n    <Keyboard\n      {...rest}\n      ref={ref}\n      className={clsx(styles.key, styles[variant], className)}\n    >\n      {children}\n    </Keyboard>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoDA,SAAgB,OAAO,EAAE,KAAK,UAAU,GAAG,SAAsB;AAC/D,EAAC,OAAO,OAAO,gBAAgB,OAAO,OAAO,MAAM,cAAc;CAEjE,MAAM,EAAE,WAAW,UAAU,WAAW,GAAG,SAAS;AAEpD,QACE,oBAAC;EACC,GAAI;EACC;EACL,WAAW,KAAK,OAAO,KAAK,OAAO,UAAU,UAAU;EAEtD;GACQ"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/components/hotkey/index.tsx"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\n'use client';\n\nimport 'client-only';\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport { Keyboard, useContextProps } from 'react-aria-components';\nimport { HotkeyContext } from './context';\nimport styles from './styles.module.css';\nimport type { HotkeyProps } from './types';\n\n/**\n * Hotkey - A visual representation of keyboard shortcuts and key combinations\n *\n * Displays keyboard keys and shortcuts in a consistent, accessible format.\n * Perfect for documentation, help systems, or UI elements that need to show\n * keyboard shortcuts. Supports multiple visual styles including outlined keys,\n * flat presentation, and icon-specific formatting.\n *\n * @param props - {@link HotkeyProps}\n * @param props.ref - Ref to the kbd element.\n * @param props.children - Key text or icon to display.\n * @param props.className - Optional CSS class name.\n * @param props.variant - Visual style variant.\n * @returns The rendered Hotkey component.\n *\n * @example\n * ```tsx\n * // Basic hotkey display\n * <Hotkey>Ctrl</Hotkey>\n * ```\n *\n * @example\n * ```tsx\n * // Hotkey combination with different variants\n * <HotkeySet>\n *   <Hotkey variant=\"outline\">Cmd</Hotkey>\n *   <span>+</span>\n *   <Hotkey variant=\"outline\">K</Hotkey>\n * </HotkeySet>\n * ```\n *\n * @example\n * ```tsx\n * // Flat style for inline text\n * <p>Press <Hotkey variant=\"flat\">Enter</Hotkey> to submit</p>\n * ```\n *\n * @example\n * ```tsx\n * // Icon variant for special keys\n * <HotkeySet>\n *   <Hotkey variant=\"icon\">⌘</Hotkey>\n *   <Hotkey>Space</Hotkey>\n * </HotkeySet>\n * ```\n */\nexport function Hotkey({ ref, children, ...props }: HotkeyProps) {\n  [props, ref] = useContextProps(props, ref ?? null, HotkeyContext);\n\n  const { className, variant = 'outline', ...rest } = props;\n\n  return (\n    <Keyboard\n      {...rest}\n      ref={ref}\n      className={clsx(styles.key, styles[variant], className)}\n    >\n      {children}\n    </Keyboard>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmEA,SAAgB,OAAO,EAAE,KAAK,UAAU,GAAG,SAAsB;AAC/D,EAAC,OAAO,OAAO,gBAAgB,OAAO,OAAO,MAAM,cAAc;CAEjE,MAAM,EAAE,WAAW,UAAU,WAAW,GAAG,SAAS;AAEpD,QACE,oBAAC;EACC,GAAI;EACC;EACL,WAAW,KAAK,OAAO,KAAK,OAAO,UAAU,UAAU;EAEtD;GACQ"}

package/dist/components/hotkey/set.d.ts

@@ -12,13 +12,32 @@
 
 import "client-only";
 import { ComponentPropsWithRef } from "react";
-import * as react_jsx_runtime61 from "react/jsx-runtime";
+import * as react_jsx_runtime96 from "react/jsx-runtime";
 
 //#region src/components/hotkey/set.d.ts
+
+/**
+ * HotkeySet - Container for grouping multiple Hotkey components.
+ *
+ * Automatically sizes icons via IconProvider.
+ *
+ * @param props - ComponentPropsWithRef<'div'>
+ * @param props.className - Optional CSS class name.
+ * @returns The rendered HotkeySet component.
+ *
+ * @example
+ * ```tsx
+ * <HotkeySet>
+ *   <Hotkey>CMD</Hotkey>
+ *   <span>+</span>
+ *   <Hotkey>K</Hotkey>
+ * </HotkeySet>
+ * ```
+ */
 declare function HotkeySet({
   className,
   ...rest
-}: ComponentPropsWithRef<'div'>): react_jsx_runtime61.JSX.Element;
+}: ComponentPropsWithRef<'div'>): react_jsx_runtime96.JSX.Element;
 //#endregion
 export { HotkeySet };
 //# sourceMappingURL=set.d.ts.map

package/dist/components/hotkey/set.js

@@ -20,6 +20,24 @@ import { jsx } from "react/jsx-runtime";
 import styles from "./styles.module.css";
 
 //#region src/components/hotkey/set.tsx
+/**
+* HotkeySet - Container for grouping multiple Hotkey components.
+*
+* Automatically sizes icons via IconProvider.
+*
+* @param props - ComponentPropsWithRef<'div'>
+* @param props.className - Optional CSS class name.
+* @returns The rendered HotkeySet component.
+*
+* @example
+* ```tsx
+* <HotkeySet>
+*   <Hotkey>CMD</Hotkey>
+*   <span>+</span>
+*   <Hotkey>K</Hotkey>
+* </HotkeySet>
+* ```
+*/
 function HotkeySet({ className, ...rest }) {
 	return /* @__PURE__ */ jsx(IconProvider, {
 		size: "large",

package/dist/components/hotkey/set.js.map

@@ -1 +1 @@
-{"version":3,"file":"set.js","names":[],"sources":["../../../src/components/hotkey/set.tsx"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\n'use client';\n\nimport 'client-only';\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport { IconProvider } from '../icon/context';\nimport styles from './styles.module.css';\nimport type { ComponentPropsWithRef } from 'react';\n\nexport function HotkeySet({\n  className,\n  ...rest\n}: ComponentPropsWithRef<'div'>) {\n  return (\n    <IconProvider size='large'>\n      <div {...rest} className={clsx(styles.set, className)} />\n    </IconProvider>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAoBA,SAAgB,UAAU,EACxB,WACA,GAAG,QAC4B;AAC/B,QACE,oBAAC;EAAa,MAAK;YACjB,oBAAC;GAAI,GAAI;GAAM,WAAW,KAAK,OAAO,KAAK,UAAU;IAAI;GAC5C"}
+{"version":3,"file":"set.js","names":[],"sources":["../../../src/components/hotkey/set.tsx"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\n'use client';\n\nimport 'client-only';\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport { IconProvider } from '../icon/context';\nimport styles from './styles.module.css';\nimport type { ComponentPropsWithRef } from 'react';\n\n/**\n * HotkeySet - Container for grouping multiple Hotkey components.\n *\n * Automatically sizes icons via IconProvider.\n *\n * @param props - ComponentPropsWithRef<'div'>\n * @param props.className - Optional CSS class name.\n * @returns The rendered HotkeySet component.\n *\n * @example\n * ```tsx\n * <HotkeySet>\n *   <Hotkey>CMD</Hotkey>\n *   <span>+</span>\n *   <Hotkey>K</Hotkey>\n * </HotkeySet>\n * ```\n */\nexport function HotkeySet({\n  className,\n  ...rest\n}: ComponentPropsWithRef<'div'>) {\n  return (\n    <IconProvider size='large'>\n      <div {...rest} className={clsx(styles.set, className)} />\n    </IconProvider>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsCA,SAAgB,UAAU,EACxB,WACA,GAAG,QAC4B;AAC/B,QACE,oBAAC;EAAa,MAAK;YACjB,oBAAC;GAAI,GAAI;GAAM,WAAW,KAAK,OAAO,KAAK,UAAU;IAAI;GAC5C"}

package/dist/components/hotkey/types.d.ts

@@ -13,7 +13,11 @@
 import { ComponentPropsWithRef } from "react";
 
 //#region src/components/hotkey/types.d.ts
+/**
+ * Props for the Hotkey component.
+ */
 type HotkeyProps = ComponentPropsWithRef<'kbd'> & {
+  /** Visual style variant for the hotkey display. */
   variant?: 'flat' | 'icon' | 'outline';
 };
 //#endregion

package/dist/components/icon/context.d.ts

@@ -13,16 +13,36 @@
 import { ProviderProps } from "../../lib/types.js";
 import { IconProps } from "./types.js";
 import "client-only";
-import * as react18 from "react";
+import * as react29 from "react";
 import { ContextValue } from "react-aria-components";
-import * as react_jsx_runtime63 from "react/jsx-runtime";
+import * as react_jsx_runtime98 from "react/jsx-runtime";
 
 //#region src/components/icon/context.d.ts
-declare const IconContext: react18.Context<ContextValue<IconProps, HTMLSpanElement>>;
+/**
+ * Context for sharing Icon props across component tree.
+ */
+declare const IconContext: react29.Context<ContextValue<IconProps, HTMLSpanElement>>;
+/**
+ * IconProvider - Context provider for setting default Icon props.
+ *
+ * Use this to configure shared size across multiple Icon components.
+ *
+ * @param props - ProviderProps<IconProps>
+ * @param props.children - Child components to receive context.
+ * @returns The rendered IconProvider component.
+ *
+ * @example
+ * ```tsx
+ * <IconProvider size="small">
+ *   <Icon><Home /></Icon>
+ *   <Icon><Search /></Icon>
+ * </IconProvider>
+ * ```
+ */
 declare function IconProvider({
   children,
   ...props
-}: ProviderProps<IconProps>): react_jsx_runtime63.JSX.Element;
+}: ProviderProps<IconProps>): react_jsx_runtime98.JSX.Element;
 //#endregion
 export { IconContext, IconProvider };
 //# sourceMappingURL=context.d.ts.map

package/dist/components/icon/context.js

@@ -18,7 +18,27 @@ import { createContext } from "react";
 import { jsx } from "react/jsx-runtime";
 
 //#region src/components/icon/context.tsx
+/**
+* Context for sharing Icon props across component tree.
+*/
 const IconContext = createContext(null);
+/**
+* IconProvider - Context provider for setting default Icon props.
+*
+* Use this to configure shared size across multiple Icon components.
+*
+* @param props - ProviderProps<IconProps>
+* @param props.children - Child components to receive context.
+* @returns The rendered IconProvider component.
+*
+* @example
+* ```tsx
+* <IconProvider size="small">
+*   <Icon><Home /></Icon>
+*   <Icon><Search /></Icon>
+* </IconProvider>
+* ```
+*/
 function IconProvider({ children, ...props }) {
 	return /* @__PURE__ */ jsx(IconContext.Provider, {
 		value: props,

package/dist/components/icon/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/icon/context.tsx"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n'use client';\n\nimport type { ProviderProps } from '@/lib/types';\nimport 'client-only';\nimport { createContext } from 'react';\nimport type { ContextValue } from 'react-aria-components';\nimport type { IconProps } from './types';\n\nexport const IconContext =\n  createContext<ContextValue<IconProps, HTMLSpanElement>>(null);\n\nexport function IconProvider({ children, ...props }: ProviderProps<IconProps>) {\n  return <IconContext.Provider value={props}>{children}</IconContext.Provider>;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAmBA,MAAa,cACX,cAAwD,KAAK;AAE/D,SAAgB,aAAa,EAAE,UAAU,GAAG,SAAmC;AAC7E,QAAO,oBAAC,YAAY;EAAS,OAAO;EAAQ;GAAgC"}
+{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/icon/context.tsx"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n'use client';\n\nimport type { ProviderProps } from '@/lib/types';\nimport 'client-only';\nimport { createContext } from 'react';\nimport type { ContextValue } from 'react-aria-components';\nimport type { IconProps } from './types';\n\n/**\n * Context for sharing Icon props across component tree.\n */\nexport const IconContext =\n  createContext<ContextValue<IconProps, HTMLSpanElement>>(null);\n\n/**\n * IconProvider - Context provider for setting default Icon props.\n *\n * Use this to configure shared size across multiple Icon components.\n *\n * @param props - ProviderProps<IconProps>\n * @param props.children - Child components to receive context.\n * @returns The rendered IconProvider component.\n *\n * @example\n * ```tsx\n * <IconProvider size=\"small\">\n *   <Icon><Home /></Icon>\n *   <Icon><Search /></Icon>\n * </IconProvider>\n * ```\n */\nexport function IconProvider({ children, ...props }: ProviderProps<IconProps>) {\n  return <IconContext.Provider value={props}>{children}</IconContext.Provider>;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAsBA,MAAa,cACX,cAAwD,KAAK;;;;;;;;;;;;;;;;;;AAmB/D,SAAgB,aAAa,EAAE,UAAU,GAAG,SAAmC;AAC7E,QAAO,oBAAC,YAAY;EAAS,OAAO;EAAQ;GAAgC"}

package/dist/components/icon/index.d.ts

@@ -12,7 +12,7 @@
 
 import { IconProps } from "./types.js";
 import "client-only";
-import * as react_jsx_runtime65 from "react/jsx-runtime";
+import * as react_jsx_runtime56 from "react/jsx-runtime";
 
 //#region src/components/icon/index.d.ts
 
@@ -23,13 +23,23 @@ import * as react_jsx_runtime65 from "react/jsx-runtime";
  * proper accessibility support. Works seamlessly with the Accelint icon library
  * and supports custom SVG elements with consistent styling and alignment.
  *
+ * @param props - {@link IconProps}
+ * @param props.ref - Ref to the span element.
+ * @param props.children - SVG icon element to display.
+ * @param props.className - Optional CSS class name.
+ * @param props.size - Size variant for the icon.
+ * @returns The rendered Icon component.
+ *
  * @example
+ * ```tsx
  * // Basic icon usage
  * <Icon>
  *   <Settings />
  * </Icon>
+ * ```
  *
  * @example
+ * ```tsx
  * // Icon with different sizes
  * <Icon size="small">
  *   <User />
@@ -37,18 +47,21 @@ import * as react_jsx_runtime65 from "react/jsx-runtime";
  * <Icon size="large">
  *   <Dashboard />
  * </Icon>
+ * ```
  *
  * @example
+ * ```tsx
  * // Icon in button context (automatically inherits sizing)
  * <Button>
  *   <Icon><Plus /></Icon>
  *   Add Item
  * </Button>
+ * ```
  */
 declare function Icon({
   ref,
   ...props
-}: IconProps): react_jsx_runtime65.JSX.Element;
+}: IconProps): react_jsx_runtime56.JSX.Element;
 //#endregion
 export { Icon };
 //# sourceMappingURL=index.d.ts.map

package/dist/components/icon/index.js

@@ -28,13 +28,23 @@ import styles from "./styles.module.css";
 * proper accessibility support. Works seamlessly with the Accelint icon library
 * and supports custom SVG elements with consistent styling and alignment.
 *
+* @param props - {@link IconProps}
+* @param props.ref - Ref to the span element.
+* @param props.children - SVG icon element to display.
+* @param props.className - Optional CSS class name.
+* @param props.size - Size variant for the icon.
+* @returns The rendered Icon component.
+*
 * @example
+* ```tsx
 * // Basic icon usage
 * <Icon>
 *   <Settings />
 * </Icon>
+* ```
 *
 * @example
+* ```tsx
 * // Icon with different sizes
 * <Icon size="small">
 *   <User />
@@ -42,13 +52,16 @@ import styles from "./styles.module.css";
 * <Icon size="large">
 *   <Dashboard />
 * </Icon>
+* ```
 *
 * @example
+* ```tsx
 * // Icon in button context (automatically inherits sizing)
 * <Button>
 *   <Icon><Plus /></Icon>
 *   Add Item
 * </Button>
+* ```
 */
 function Icon({ ref, ...props }) {
 	[props, ref] = useContextProps(props, ref ?? null, IconContext);

package/dist/components/icon/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../src/components/icon/index.tsx"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n'use client';\n\nimport 'client-only';\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport { useContextProps } from 'react-aria-components';\nimport { IconContext } from './context';\nimport styles from './styles.module.css';\nimport type { IconProps } from './types';\n\n/**\n * Icon - A wrapper component for displaying SVG icons with consistent sizing\n *\n * Provides a standardized container for SVG icons with built-in size variants and\n * proper accessibility support. Works seamlessly with the Accelint icon library\n * and supports custom SVG elements with consistent styling and alignment.\n *\n * @example\n * // Basic icon usage\n * <Icon>\n *   <Settings />\n * </Icon>\n *\n * @example\n * // Icon with different sizes\n * <Icon size=\"small\">\n *   <User />\n * </Icon>\n * <Icon size=\"large\">\n *   <Dashboard />\n * </Icon>\n *\n * @example\n * // Icon in button context (automatically inherits sizing)\n * <Button>\n *   <Icon><Plus /></Icon>\n *   Add Item\n * </Button>\n */\nexport function Icon({ ref, ...props }: IconProps) {\n  [props, ref] = useContextProps(props, ref ?? null, IconContext);\n\n  const { children, className, size = 'medium', ...rest } = props;\n\n  return (\n    <span\n      {...rest}\n      ref={ref}\n      className={clsx(styles.icon, className)}\n      data-size={size}\n    >\n      {children}\n    </span>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiDA,SAAgB,KAAK,EAAE,KAAK,GAAG,SAAoB;AACjD,EAAC,OAAO,OAAO,gBAAgB,OAAO,OAAO,MAAM,YAAY;CAE/D,MAAM,EAAE,UAAU,WAAW,OAAO,UAAU,GAAG,SAAS;AAE1D,QACE,oBAAC;EACC,GAAI;EACC;EACL,WAAW,KAAK,OAAO,MAAM,UAAU;EACvC,aAAW;EAEV;GACI"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/components/icon/index.tsx"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n'use client';\n\nimport 'client-only';\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport { useContextProps } from 'react-aria-components';\nimport { IconContext } from './context';\nimport styles from './styles.module.css';\nimport type { IconProps } from './types';\n\n/**\n * Icon - A wrapper component for displaying SVG icons with consistent sizing\n *\n * Provides a standardized container for SVG icons with built-in size variants and\n * proper accessibility support. Works seamlessly with the Accelint icon library\n * and supports custom SVG elements with consistent styling and alignment.\n *\n * @param props - {@link IconProps}\n * @param props.ref - Ref to the span element.\n * @param props.children - SVG icon element to display.\n * @param props.className - Optional CSS class name.\n * @param props.size - Size variant for the icon.\n * @returns The rendered Icon component.\n *\n * @example\n * ```tsx\n * // Basic icon usage\n * <Icon>\n *   <Settings />\n * </Icon>\n * ```\n *\n * @example\n * ```tsx\n * // Icon with different sizes\n * <Icon size=\"small\">\n *   <User />\n * </Icon>\n * <Icon size=\"large\">\n *   <Dashboard />\n * </Icon>\n * ```\n *\n * @example\n * ```tsx\n * // Icon in button context (automatically inherits sizing)\n * <Button>\n *   <Icon><Plus /></Icon>\n *   Add Item\n * </Button>\n * ```\n */\nexport function Icon({ ref, ...props }: IconProps) {\n  [props, ref] = useContextProps(props, ref ?? null, IconContext);\n\n  const { children, className, size = 'medium', ...rest } = props;\n\n  return (\n    <span\n      {...rest}\n      ref={ref}\n      className={clsx(styles.icon, className)}\n      data-size={size}\n    >\n      {children}\n    </span>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8DA,SAAgB,KAAK,EAAE,KAAK,GAAG,SAAoB;AACjD,EAAC,OAAO,OAAO,gBAAgB,OAAO,OAAO,MAAM,YAAY;CAE/D,MAAM,EAAE,UAAU,WAAW,OAAO,UAAU,GAAG,SAAS;AAE1D,QACE,oBAAC;EACC,GAAI;EACC;EACL,WAAW,KAAK,OAAO,MAAM,UAAU;EACvC,aAAW;EAEV;GACI"}

package/dist/components/icon/types.d.ts

@@ -13,7 +13,11 @@
 import { ComponentPropsWithRef } from "react";
 
 //#region src/components/icon/types.d.ts
+/**
+ * Props for the Icon component.
+ */
 type IconProps = ComponentPropsWithRef<'span'> & {
+  /** Size variant for the icon. */
   size?: 'large' | 'medium' | 'small' | 'xsmall';
 };
 //#endregion