@accelint/design-toolkit 9.3.0 → 9.4.1

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

@@ -12,7 +12,7 @@
 
 import { HotkeyProps } from "./types.js";
 import "client-only";
-import * as react_jsx_runtime50 from "react/jsx-runtime";
+import * as react_jsx_runtime101 from "react/jsx-runtime";
 
 //#region src/components/hotkey/index.d.ts
 
@@ -24,34 +24,49 @@ import * as react_jsx_runtime50 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_runtime50.JSX.Element;
+}: HotkeyProps): react_jsx_runtime101.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_runtime51 from "react/jsx-runtime";
+import * as react_jsx_runtime102 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_runtime51.JSX.Element;
+}: ComponentPropsWithRef<'div'>): react_jsx_runtime102.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 react22 from "react";
+import * as react25 from "react";
 import { ContextValue } from "react-aria-components";
-import * as react_jsx_runtime53 from "react/jsx-runtime";
+import * as react_jsx_runtime103 from "react/jsx-runtime";
 
 //#region src/components/icon/context.d.ts
-declare const IconContext: react22.Context<ContextValue<IconProps, HTMLSpanElement>>;
+/**
+ * Context for sharing Icon props across component tree.
+ */
+declare const IconContext: react25.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_runtime53.JSX.Element;
+}: ProviderProps<IconProps>): react_jsx_runtime103.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_runtime59 from "react/jsx-runtime";
+import * as react_jsx_runtime104 from "react/jsx-runtime";
 
 //#region src/components/icon/index.d.ts
 
@@ -23,13 +23,23 @@ import * as react_jsx_runtime59 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_runtime59 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_runtime59.JSX.Element;
+}: IconProps): react_jsx_runtime104.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

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

@@ -12,11 +12,15 @@
 
 import { InputProps as InputProps$1 } from "./types.js";
 import "client-only";
-import * as react23 from "react";
+import * as react34 from "react";
 import { ContextValue } from "react-aria-components";
 
 //#region src/components/input/context.d.ts
-declare const InputContext: react23.Context<ContextValue<InputProps$1, HTMLInputElement>>;
+/**
+ * Context for sharing Input props across component tree.
+ * Used internally by field components to pass props to Input.
+ */
+declare const InputContext: react34.Context<ContextValue<InputProps$1, HTMLInputElement>>;
 //#endregion
 export { InputContext };
 //# sourceMappingURL=context.d.ts.map

package/dist/components/input/context.js

@@ -17,6 +17,10 @@ import "client-only";
 import { createContext } from "react";
 
 //#region src/components/input/context.tsx
+/**
+* Context for sharing Input props across component tree.
+* Used internally by field components to pass props to Input.
+*/
 const InputContext = createContext(null);
 
 //#endregion

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

@@ -1 +1 @@
-{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/input/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 'client-only';\nimport { createContext } from 'react';\nimport type { ContextValue } from 'react-aria-components';\nimport type { InputProps } from './types';\n\nexport const InputContext =\n  createContext<ContextValue<InputProps, HTMLInputElement>>(null);\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAmBA,MAAa,eACX,cAA0D,KAAK"}
+{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/input/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 'client-only';\nimport { createContext } from 'react';\nimport type { ContextValue } from 'react-aria-components';\nimport type { InputProps } from './types';\n\n/**\n * Context for sharing Input props across component tree.\n * Used internally by field components to pass props to Input.\n */\nexport const InputContext =\n  createContext<ContextValue<InputProps, HTMLInputElement>>(null);\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAuBA,MAAa,eACX,cAA0D,KAAK"}

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

@@ -12,7 +12,7 @@
 
 import { InputProps } from "./types.js";
 import "client-only";
-import * as react_jsx_runtime95 from "react/jsx-runtime";
+import * as react_jsx_runtime107 from "react/jsx-runtime";
 
 //#region src/components/input/index.d.ts
 
@@ -23,21 +23,36 @@ import * as react_jsx_runtime95 from "react/jsx-runtime";
  * and integrated validation states. Supports various styling options and integrates
  * seamlessly with form field components for comprehensive form experiences.
  *
+ * @param props - {@link InputProps}
+ * @param props.ref - Ref to the input element.
+ * @param props.classNames - CSS class names for input subcomponents.
+ * @param props.autoSize - Whether the input should auto-size to its content.
+ * @param props.prefix - Content to display before the input.
+ * @param props.size - Size variant for the input.
+ * @param props.suffix - Content to display after the input.
+ * @param props.isClearable - Whether the input shows a clear button.
+ * @param props.isInvalid - Whether the input is in an invalid state.
+ * @returns The rendered Input component.
+ *
  * @example
+ * ```tsx
  * // Basic input
  * <Input placeholder="Enter text..." />
+ * ```
  *
  * @example
+ * ```tsx
  * // Input with clear button
  * <Input
  *   defaultValue="Clearable text"
  *   classNames={{ clear: "hover:bg-info-bold" }}
  * />
+ * ```
  */
 declare function Input({
   ref,
   ...props
-}: InputProps): react_jsx_runtime95.JSX.Element;
+}: InputProps): react_jsx_runtime107.JSX.Element;
 //#endregion
 export { Input };
 //# sourceMappingURL=index.d.ts.map

package/dist/components/input/index.js

@@ -21,7 +21,7 @@ import "client-only";
 import { clsx } from "@accelint/design-foundation/lib/utils";
 import { Input as Input$1, InputContext, composeRenderProps, useContextProps } from "react-aria-components";
 import { jsx, jsxs } from "react/jsx-runtime";
-import { CancelFill } from "@accelint/icons";
+import CancelFill from "@accelint/icons/cancel-fill";
 import { useControlledState } from "@react-stately/utils";
 import styles from "./styles.module.css";
 
@@ -34,16 +34,31 @@ const clearInputEvent = { target: { value: "" } };
 * and integrated validation states. Supports various styling options and integrates
 * seamlessly with form field components for comprehensive form experiences.
 *
+* @param props - {@link InputProps}
+* @param props.ref - Ref to the input element.
+* @param props.classNames - CSS class names for input subcomponents.
+* @param props.autoSize - Whether the input should auto-size to its content.
+* @param props.prefix - Content to display before the input.
+* @param props.size - Size variant for the input.
+* @param props.suffix - Content to display after the input.
+* @param props.isClearable - Whether the input shows a clear button.
+* @param props.isInvalid - Whether the input is in an invalid state.
+* @returns The rendered Input component.
+*
 * @example
+* ```tsx
 * // Basic input
 * <Input placeholder="Enter text..." />
+* ```
 *
 * @example
+* ```tsx
 * // Input with clear button
 * <Input
 *   defaultValue="Clearable text"
 *   classNames={{ clear: "hover:bg-info-bold" }}
 * />
+* ```
 */
 function Input({ ref = null, ...props }) {
 	/**

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["AriaInputContext","InputContext","AriaInput","Button"],"sources":["../../../src/components/input/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 { CancelFill } from '@accelint/icons';\nimport { useControlledState } from '@react-stately/utils';\nimport {\n  Input as AriaInput,\n  InputContext as AriaInputContext,\n  composeRenderProps,\n  useContextProps,\n} from 'react-aria-components';\nimport { Button } from '../button';\nimport { Icon } from '../icon';\nimport { IconProvider } from '../icon/context';\nimport { InputContext } from './context';\nimport styles from './styles.module.css';\nimport type { ChangeEvent } from 'react';\nimport type { InputProps } from './types';\n\n// TODO: Improve this implementation so it is more of a realistic event\nconst clearInputEvent = {\n  target: { value: '' },\n} as ChangeEvent<HTMLInputElement>;\n\n/**\n * Input - A flexible text input component with enhanced features\n *\n * Provides a customizable text input with automatic sizing, clear functionality,\n * and integrated validation states. Supports various styling options and integrates\n * seamlessly with form field components for comprehensive form experiences.\n *\n * @example\n * // Basic input\n * <Input placeholder=\"Enter text...\" />\n *\n * @example\n * // Input with clear button\n * <Input\n *   defaultValue=\"Clearable text\"\n *   classNames={{ clear: \"hover:bg-info-bold\" }}\n * />\n */\n\n// biome-ignore lint/complexity/noExcessiveCognitiveComplexity: just a little bit over, not worth refactoring\nexport function Input({ ref = null, ...props }: InputProps) {\n  /**\n   * It is necessary to pull in the AriaInputContext to capture defaultValue,\n   * value & onChange props that may be supplied by a Field component\n   *\n   * These are necessary due to the implementation of useControlledState for\n   * the purposes of supporting the clear button and to capture the length\n   * of the current value for the autoSize feature\n   */\n  [props, ref] = useContextProps(props, ref, AriaInputContext);\n  [props, ref] = useContextProps({ ...props }, ref, InputContext);\n\n  const {\n    classNames,\n    autoSize,\n    defaultValue = '',\n    disabled,\n    placeholder,\n    prefix: prefixProp,\n    readOnly,\n    required,\n    size = 'medium',\n    suffix: suffixProp,\n    type = 'text',\n    value: valueProp,\n    isClearable = true,\n    isInvalid,\n    onChange,\n    onKeyDown,\n    ...rest\n  } = props;\n\n  const [value, setValue] = useControlledState(valueProp, defaultValue);\n  const length = (`${value ?? ''}`.length || placeholder?.length) ?? 0;\n  const prefix = !!prefixProp && styles.hasPrefix;\n  const suffix = !!suffixProp && styles.hasSuffix;\n  const clear = isClearable && styles.isClearable;\n  const isEmpty = value == null || value === '';\n\n  function handleChange(event: ChangeEvent<HTMLInputElement>) {\n    onChange?.(event);\n\n    if (!event.defaultPrevented) {\n      setValue(event.target.value);\n    }\n  }\n\n  return (\n    <IconProvider size='small'>\n      <div\n        className={clsx(\n          'group/input',\n          styles.container,\n          prefix,\n          suffix,\n          clear,\n          classNames?.container,\n        )}\n        data-disabled={disabled || null}\n        data-empty={isEmpty || null}\n        data-invalid={isInvalid || null}\n        data-length={length}\n        data-placeholder={(!!placeholder && isEmpty) || null}\n        data-readonly={readOnly || null}\n        data-required={required || null}\n        data-size={size}\n      >\n        {prefix && (\n          <span className={clsx(styles.prefix, classNames?.prefix)}>\n            {prefixProp}\n          </span>\n        )}\n        <div\n          className={clsx(\n            styles.sizer,\n            classNames?.sizer,\n            autoSize && styles.autoSize,\n          )}\n        >\n          <AriaInput\n            {...rest}\n            ref={ref}\n            className={composeRenderProps(classNames?.input, (className) =>\n              clsx(styles.input, className),\n            )}\n            title={value ? String(value) : ''}\n            disabled={disabled}\n            placeholder={placeholder}\n            readOnly={readOnly}\n            required={required}\n            type={type}\n            value={value}\n            onChange={handleChange}\n            onKeyDown={(event) => {\n              onKeyDown?.(event);\n\n              if (\n                isClearable &&\n                !event.defaultPrevented &&\n                event.key === 'Escape'\n              ) {\n                handleChange(clearInputEvent);\n              }\n            }}\n          />\n        </div>\n        {suffix && (\n          <span\n            className={clsx(\n              styles.suffix,\n              prefix,\n              suffix,\n              clear,\n              classNames?.suffix,\n            )}\n          >\n            {suffixProp}\n          </span>\n        )}\n        {!readOnly && isClearable && (\n          <Button\n            className={composeRenderProps(classNames?.clear, (className) =>\n              clsx(styles.clear, prefix, suffix, clear, className),\n            )}\n            excludeFromTabOrder\n            size='small'\n            variant='icon'\n            isDisabled={disabled}\n            onPress={() => {\n              handleChange(clearInputEvent);\n\n              ref?.current?.focus();\n            }}\n          >\n            <Icon>\n              <CancelFill />\n            </Icon>\n          </Button>\n        )}\n      </div>\n    </IconProvider>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiCA,MAAM,kBAAkB,EACtB,QAAQ,EAAE,OAAO,IAAI,EACtB;;;;;;;;;;;;;;;;;;;AAsBD,SAAgB,MAAM,EAAE,MAAM,MAAM,GAAG,SAAqB;;;;;;;;;AAS1D,EAAC,OAAO,OAAO,gBAAgB,OAAO,KAAKA,aAAiB;AAC5D,EAAC,OAAO,OAAO,gBAAgB,EAAE,GAAG,OAAO,EAAE,KAAKC,eAAa;CAE/D,MAAM,EACJ,YACA,UACA,eAAe,IACf,UACA,aACA,QAAQ,YACR,UACA,UACA,OAAO,UACP,QAAQ,YACR,OAAO,QACP,OAAO,WACP,cAAc,MACd,WACA,UACA,WACA,GAAG,SACD;CAEJ,MAAM,CAAC,OAAO,YAAY,mBAAmB,WAAW,aAAa;CACrE,MAAM,UAAU,GAAG,SAAS,KAAK,UAAU,aAAa,WAAW;CACnE,MAAM,SAAS,CAAC,CAAC,cAAc,OAAO;CACtC,MAAM,SAAS,CAAC,CAAC,cAAc,OAAO;CACtC,MAAM,QAAQ,eAAe,OAAO;CACpC,MAAM,UAAU,SAAS,QAAQ,UAAU;CAE3C,SAAS,aAAa,OAAsC;AAC1D,aAAW,MAAM;AAEjB,MAAI,CAAC,MAAM,iBACT,UAAS,MAAM,OAAO,MAAM;;AAIhC,QACE,oBAAC;EAAa,MAAK;YACjB,qBAAC;GACC,WAAW,KACT,eACA,OAAO,WACP,QACA,QACA,OACA,YAAY,UACb;GACD,iBAAe,YAAY;GAC3B,cAAY,WAAW;GACvB,gBAAc,aAAa;GAC3B,eAAa;GACb,oBAAmB,CAAC,CAAC,eAAe,WAAY;GAChD,iBAAe,YAAY;GAC3B,iBAAe,YAAY;GAC3B,aAAW;;IAEV,UACC,oBAAC;KAAK,WAAW,KAAK,OAAO,QAAQ,YAAY,OAAO;eACrD;MACI;IAET,oBAAC;KACC,WAAW,KACT,OAAO,OACP,YAAY,OACZ,YAAY,OAAO,SACpB;eAED,oBAACC;MACC,GAAI;MACC;MACL,WAAW,mBAAmB,YAAY,QAAQ,cAChD,KAAK,OAAO,OAAO,UAAU,CAC9B;MACD,OAAO,QAAQ,OAAO,MAAM,GAAG;MACrB;MACG;MACH;MACA;MACJ;MACC;MACP,UAAU;MACV,YAAY,UAAU;AACpB,mBAAY,MAAM;AAElB,WACE,eACA,CAAC,MAAM,oBACP,MAAM,QAAQ,SAEd,cAAa,gBAAgB;;OAGjC;MACE;IACL,UACC,oBAAC;KACC,WAAW,KACT,OAAO,QACP,QACA,QACA,OACA,YAAY,OACb;eAEA;MACI;IAER,CAAC,YAAY,eACZ,oBAACC;KACC,WAAW,mBAAmB,YAAY,QAAQ,cAChD,KAAK,OAAO,OAAO,QAAQ,QAAQ,OAAO,UAAU,CACrD;KACD;KACA,MAAK;KACL,SAAQ;KACR,YAAY;KACZ,eAAe;AACb,mBAAa,gBAAgB;AAE7B,WAAK,SAAS,OAAO;;eAGvB,oBAAC,kBACC,oBAAC,eAAa,GACT;MACA;;IAEP;GACO"}
+{"version":3,"file":"index.js","names":["AriaInputContext","InputContext","AriaInput","Button"],"sources":["../../../src/components/input/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 CancelFill from '@accelint/icons/cancel-fill';\nimport { useControlledState } from '@react-stately/utils';\nimport {\n  Input as AriaInput,\n  InputContext as AriaInputContext,\n  composeRenderProps,\n  useContextProps,\n} from 'react-aria-components';\nimport { Button } from '../button';\nimport { Icon } from '../icon';\nimport { IconProvider } from '../icon/context';\nimport { InputContext } from './context';\nimport styles from './styles.module.css';\nimport type { ChangeEvent } from 'react';\nimport type { InputProps } from './types';\n\n// TODO: Improve this implementation so it is more of a realistic event\nconst clearInputEvent = {\n  target: { value: '' },\n} as ChangeEvent<HTMLInputElement>;\n\n/**\n * Input - A flexible text input component with enhanced features\n *\n * Provides a customizable text input with automatic sizing, clear functionality,\n * and integrated validation states. Supports various styling options and integrates\n * seamlessly with form field components for comprehensive form experiences.\n *\n * @param props - {@link InputProps}\n * @param props.ref - Ref to the input element.\n * @param props.classNames - CSS class names for input subcomponents.\n * @param props.autoSize - Whether the input should auto-size to its content.\n * @param props.prefix - Content to display before the input.\n * @param props.size - Size variant for the input.\n * @param props.suffix - Content to display after the input.\n * @param props.isClearable - Whether the input shows a clear button.\n * @param props.isInvalid - Whether the input is in an invalid state.\n * @returns The rendered Input component.\n *\n * @example\n * ```tsx\n * // Basic input\n * <Input placeholder=\"Enter text...\" />\n * ```\n *\n * @example\n * ```tsx\n * // Input with clear button\n * <Input\n *   defaultValue=\"Clearable text\"\n *   classNames={{ clear: \"hover:bg-info-bold\" }}\n * />\n * ```\n */\n\n// biome-ignore lint/complexity/noExcessiveCognitiveComplexity: just a little bit over, not worth refactoring\nexport function Input({ ref = null, ...props }: InputProps) {\n  /**\n   * It is necessary to pull in the AriaInputContext to capture defaultValue,\n   * value & onChange props that may be supplied by a Field component\n   *\n   * These are necessary due to the implementation of useControlledState for\n   * the purposes of supporting the clear button and to capture the length\n   * of the current value for the autoSize feature\n   */\n  [props, ref] = useContextProps(props, ref, AriaInputContext);\n  [props, ref] = useContextProps({ ...props }, ref, InputContext);\n\n  const {\n    classNames,\n    autoSize,\n    defaultValue = '',\n    disabled,\n    placeholder,\n    prefix: prefixProp,\n    readOnly,\n    required,\n    size = 'medium',\n    suffix: suffixProp,\n    type = 'text',\n    value: valueProp,\n    isClearable = true,\n    isInvalid,\n    onChange,\n    onKeyDown,\n    ...rest\n  } = props;\n\n  const [value, setValue] = useControlledState(valueProp, defaultValue);\n  const length = (`${value ?? ''}`.length || placeholder?.length) ?? 0;\n  const prefix = !!prefixProp && styles.hasPrefix;\n  const suffix = !!suffixProp && styles.hasSuffix;\n  const clear = isClearable && styles.isClearable;\n  const isEmpty = value == null || value === '';\n\n  function handleChange(event: ChangeEvent<HTMLInputElement>) {\n    onChange?.(event);\n\n    if (!event.defaultPrevented) {\n      setValue(event.target.value);\n    }\n  }\n\n  return (\n    <IconProvider size='small'>\n      <div\n        className={clsx(\n          'group/input',\n          styles.container,\n          prefix,\n          suffix,\n          clear,\n          classNames?.container,\n        )}\n        data-disabled={disabled || null}\n        data-empty={isEmpty || null}\n        data-invalid={isInvalid || null}\n        data-length={length}\n        data-placeholder={(!!placeholder && isEmpty) || null}\n        data-readonly={readOnly || null}\n        data-required={required || null}\n        data-size={size}\n      >\n        {prefix && (\n          <span className={clsx(styles.prefix, classNames?.prefix)}>\n            {prefixProp}\n          </span>\n        )}\n        <div\n          className={clsx(\n            styles.sizer,\n            classNames?.sizer,\n            autoSize && styles.autoSize,\n          )}\n        >\n          <AriaInput\n            {...rest}\n            ref={ref}\n            className={composeRenderProps(classNames?.input, (className) =>\n              clsx(styles.input, className),\n            )}\n            title={value ? String(value) : ''}\n            disabled={disabled}\n            placeholder={placeholder}\n            readOnly={readOnly}\n            required={required}\n            type={type}\n            value={value}\n            onChange={handleChange}\n            onKeyDown={(event) => {\n              onKeyDown?.(event);\n\n              if (\n                isClearable &&\n                !event.defaultPrevented &&\n                event.key === 'Escape'\n              ) {\n                handleChange(clearInputEvent);\n              }\n            }}\n          />\n        </div>\n        {suffix && (\n          <span\n            className={clsx(\n              styles.suffix,\n              prefix,\n              suffix,\n              clear,\n              classNames?.suffix,\n            )}\n          >\n            {suffixProp}\n          </span>\n        )}\n        {!readOnly && isClearable && (\n          <Button\n            className={composeRenderProps(classNames?.clear, (className) =>\n              clsx(styles.clear, prefix, suffix, clear, className),\n            )}\n            excludeFromTabOrder\n            size='small'\n            variant='icon'\n            isDisabled={disabled}\n            onPress={() => {\n              handleChange(clearInputEvent);\n\n              ref?.current?.focus();\n            }}\n          >\n            <Icon>\n              <CancelFill />\n            </Icon>\n          </Button>\n        )}\n      </div>\n    </IconProvider>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiCA,MAAM,kBAAkB,EACtB,QAAQ,EAAE,OAAO,IAAI,EACtB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqCD,SAAgB,MAAM,EAAE,MAAM,MAAM,GAAG,SAAqB;;;;;;;;;AAS1D,EAAC,OAAO,OAAO,gBAAgB,OAAO,KAAKA,aAAiB;AAC5D,EAAC,OAAO,OAAO,gBAAgB,EAAE,GAAG,OAAO,EAAE,KAAKC,eAAa;CAE/D,MAAM,EACJ,YACA,UACA,eAAe,IACf,UACA,aACA,QAAQ,YACR,UACA,UACA,OAAO,UACP,QAAQ,YACR,OAAO,QACP,OAAO,WACP,cAAc,MACd,WACA,UACA,WACA,GAAG,SACD;CAEJ,MAAM,CAAC,OAAO,YAAY,mBAAmB,WAAW,aAAa;CACrE,MAAM,UAAU,GAAG,SAAS,KAAK,UAAU,aAAa,WAAW;CACnE,MAAM,SAAS,CAAC,CAAC,cAAc,OAAO;CACtC,MAAM,SAAS,CAAC,CAAC,cAAc,OAAO;CACtC,MAAM,QAAQ,eAAe,OAAO;CACpC,MAAM,UAAU,SAAS,QAAQ,UAAU;CAE3C,SAAS,aAAa,OAAsC;AAC1D,aAAW,MAAM;AAEjB,MAAI,CAAC,MAAM,iBACT,UAAS,MAAM,OAAO,MAAM;;AAIhC,QACE,oBAAC;EAAa,MAAK;YACjB,qBAAC;GACC,WAAW,KACT,eACA,OAAO,WACP,QACA,QACA,OACA,YAAY,UACb;GACD,iBAAe,YAAY;GAC3B,cAAY,WAAW;GACvB,gBAAc,aAAa;GAC3B,eAAa;GACb,oBAAmB,CAAC,CAAC,eAAe,WAAY;GAChD,iBAAe,YAAY;GAC3B,iBAAe,YAAY;GAC3B,aAAW;;IAEV,UACC,oBAAC;KAAK,WAAW,KAAK,OAAO,QAAQ,YAAY,OAAO;eACrD;MACI;IAET,oBAAC;KACC,WAAW,KACT,OAAO,OACP,YAAY,OACZ,YAAY,OAAO,SACpB;eAED,oBAACC;MACC,GAAI;MACC;MACL,WAAW,mBAAmB,YAAY,QAAQ,cAChD,KAAK,OAAO,OAAO,UAAU,CAC9B;MACD,OAAO,QAAQ,OAAO,MAAM,GAAG;MACrB;MACG;MACH;MACA;MACJ;MACC;MACP,UAAU;MACV,YAAY,UAAU;AACpB,mBAAY,MAAM;AAElB,WACE,eACA,CAAC,MAAM,oBACP,MAAM,QAAQ,SAEd,cAAa,gBAAgB;;OAGjC;MACE;IACL,UACC,oBAAC;KACC,WAAW,KACT,OAAO,QACP,QACA,QACA,OACA,YAAY,OACb;eAEA;MACI;IAER,CAAC,YAAY,eACZ,oBAACC;KACC,WAAW,mBAAmB,YAAY,QAAQ,cAChD,KAAK,OAAO,OAAO,QAAQ,QAAQ,OAAO,UAAU,CACrD;KACD;KACA,MAAK;KACL,SAAQ;KACR,YAAY;KACZ,eAAe;AACb,mBAAa,gBAAgB;AAE7B,WAAK,SAAS,OAAO;;eAGvB,oBAAC,kBACC,oBAAC,eAAa,GACT;MACA;;IAEP;GACO"}

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

@@ -15,20 +15,36 @@ import { ReactNode, RefAttributes } from "react";
 import { InputProps as InputProps$1 } from "react-aria-components";
 
 //#region src/components/input/types.d.ts
+/**
+ * Props for the Input component.
+ */
 type InputProps = Omit<InputProps$1, 'className' | 'size'> & RefAttributes<HTMLInputElement> & {
+  /** CSS class names for input subcomponents. */
   classNames?: {
+    /** Class name for the outer container. */
     container?: string;
+    /** Class name for the sizer wrapper. */
     sizer?: string;
+    /** Class name for the input element. */
     input?: InputProps$1['className'];
+    /** Class name for the clear button. */
     clear?: ButtonProps$1['className'];
+    /** Class name for the prefix element. */
     prefix?: string;
+    /** Class name for the suffix element. */
     suffix?: string;
   };
+  /** Whether the input should auto-size to its content. */
   autoSize?: boolean;
+  /** Content to display before the input. */
   prefix?: ReactNode;
+  /** Size variant for the input. */
   size?: 'medium' | 'small';
+  /** Content to display after the input. */
   suffix?: ReactNode;
+  /** Whether the input shows a clear button. */
   isClearable?: boolean;
+  /** Whether the input is in an invalid state. */
   isInvalid?: boolean;
 };
 //#endregion