@accelint/design-toolkit 9.2.0 → 9.4.0

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

@@ -11,24 +11,34 @@
  */
 
 import { LinesProps } from "./types.js";
-import * as react_jsx_runtime109 from "react/jsx-runtime";
+import * as react_jsx_runtime91 from "react/jsx-runtime";
 
 //#region src/components/lines/index.d.ts
+
 /**
  * Lines - Decorative rule/connector lines used by components like Tree
  *
  * Renders horizontal or vertical rule lines used for visual grouping and
  * tree branch connectors. Visibility and variant control the appearance.
  *
+ * @param props - {@link LinesProps}
+ * @param props.className - Optional CSS class name.
+ * @param props.size - Size variant for the lines.
+ * @param props.variant - Visual style variant for the connector line.
+ * @param props.isVisible - Whether the lines are visible.
+ * @returns The rendered Lines component.
+ *
  * @example
+ * ```tsx
  * <Lines variant="branch" />
+ * ```
  */
 declare function Lines({
   className,
   size,
   variant,
   isVisible
-}: LinesProps): react_jsx_runtime109.JSX.Element;
+}: LinesProps): react_jsx_runtime91.JSX.Element;
 //#endregion
 export { Lines };
 //# sourceMappingURL=index.d.ts.map

package/dist/components/lines/index.js

@@ -22,8 +22,17 @@ import styles from "./styles.module.css";
 * Renders horizontal or vertical rule lines used for visual grouping and
 * tree branch connectors. Visibility and variant control the appearance.
 *
+* @param props - {@link LinesProps}
+* @param props.className - Optional CSS class name.
+* @param props.size - Size variant for the lines.
+* @param props.variant - Visual style variant for the connector line.
+* @param props.isVisible - Whether the lines are visible.
+* @returns The rendered Lines component.
+*
 * @example
+* ```tsx
 * <Lines variant="branch" />
+* ```
 */
 function Lines({ className, size = "medium", variant = "branch", isVisible = true }) {
 	return /* @__PURE__ */ jsx("div", {

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../src/components/lines/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\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport styles from './styles.module.css';\nimport type { LinesProps } from './types';\n\n/**\n * Lines - Decorative rule/connector lines used by components like Tree\n *\n * Renders horizontal or vertical rule lines used for visual grouping and\n * tree branch connectors. Visibility and variant control the appearance.\n *\n * @example\n * <Lines variant=\"branch\" />\n */\nexport function Lines({\n  className,\n  size = 'medium',\n  variant = 'branch',\n  isVisible = true,\n}: LinesProps) {\n  return (\n    <div\n      className={clsx(styles.lines, styles[variant], className)}\n      data-size={size}\n      data-visible={isVisible || null}\n    />\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AAyBA,SAAgB,MAAM,EACpB,WACA,OAAO,UACP,UAAU,UACV,YAAY,QACC;AACb,QACE,oBAAC;EACC,WAAW,KAAK,OAAO,OAAO,OAAO,UAAU,UAAU;EACzD,aAAW;EACX,gBAAc,aAAa;GAC3B"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/components/lines/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\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport styles from './styles.module.css';\nimport type { LinesProps } from './types';\n\n/**\n * Lines - Decorative rule/connector lines used by components like Tree\n *\n * Renders horizontal or vertical rule lines used for visual grouping and\n * tree branch connectors. Visibility and variant control the appearance.\n *\n * @param props - {@link LinesProps}\n * @param props.className - Optional CSS class name.\n * @param props.size - Size variant for the lines.\n * @param props.variant - Visual style variant for the connector line.\n * @param props.isVisible - Whether the lines are visible.\n * @returns The rendered Lines component.\n *\n * @example\n * ```tsx\n * <Lines variant=\"branch\" />\n * ```\n */\nexport function Lines({\n  className,\n  size = 'medium',\n  variant = 'branch',\n  isVisible = true,\n}: LinesProps) {\n  return (\n    <div\n      className={clsx(styles.lines, styles[variant], className)}\n      data-size={size}\n      data-visible={isVisible || null}\n    />\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkCA,SAAgB,MAAM,EACpB,WACA,OAAO,UACP,UAAU,UACV,YAAY,QACC;AACb,QACE,oBAAC;EACC,WAAW,KAAK,OAAO,OAAO,OAAO,UAAU,UAAU;EACzD,aAAW;EACX,gBAAc,aAAa;GAC3B"}

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

@@ -13,9 +13,15 @@
 import { ComponentProps } from "react";
 
 //#region src/components/lines/types.d.ts
+/**
+ * Props for the Lines component.
+ */
 type LinesProps = Omit<ComponentProps<'div'>, 'size'> & {
+  /** Size variant for the lines. */
   size?: 'large' | 'medium' | 'small';
+  /** Visual style variant for the connector line. */
   variant?: 'branch' | 'vert' | 'last';
+  /** Whether the lines are visible. */
   isVisible?: boolean;
 };
 //#endregion

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

@@ -13,13 +13,32 @@
 import { ProviderProps } from "../../lib/types.js";
 import { LinkProps } from "./types.js";
 import "client-only";
-import * as react_jsx_runtime111 from "react/jsx-runtime";
+import * as react_jsx_runtime92 from "react/jsx-runtime";
 
 //#region src/components/link/context.d.ts
+
+/**
+ * LinkProvider - Context provider for setting default Link props.
+ *
+ * Use this to configure shared allowsVisited and className across
+ * multiple Link components.
+ *
+ * @param props - ProviderProps<LinkProps>
+ * @param props.children - Child components to receive context.
+ * @returns The rendered LinkProvider component.
+ *
+ * @example
+ * ```tsx
+ * <LinkProvider allowsVisited className="visited:underline">
+ *   <Link href="/link1">Link One</Link>
+ *   <Link href="/link2">Link Two</Link>
+ * </LinkProvider>
+ * ```
+ */
 declare function LinkProvider({
   children,
   ...props
-}: ProviderProps<LinkProps>): react_jsx_runtime111.JSX.Element;
+}: ProviderProps<LinkProps>): react_jsx_runtime92.JSX.Element;
 //#endregion
 export { LinkProvider };
 //# sourceMappingURL=context.d.ts.map

package/dist/components/link/context.js

@@ -18,6 +18,24 @@ import { LinkContext } from "react-aria-components";
 import { jsx } from "react/jsx-runtime";
 
 //#region src/components/link/context.tsx
+/**
+* LinkProvider - Context provider for setting default Link props.
+*
+* Use this to configure shared allowsVisited and className across
+* multiple Link components.
+*
+* @param props - ProviderProps<LinkProps>
+* @param props.children - Child components to receive context.
+* @returns The rendered LinkProvider component.
+*
+* @example
+* ```tsx
+* <LinkProvider allowsVisited className="visited:underline">
+*   <Link href="/link1">Link One</Link>
+*   <Link href="/link2">Link Two</Link>
+* </LinkProvider>
+* ```
+*/
 function LinkProvider({ children, ...props }) {
 	return /* @__PURE__ */ jsx(LinkContext.Provider, {
 		value: props,

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

@@ -1 +1 @@
-{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/link/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 'client-only';\nimport { LinkContext } from 'react-aria-components';\nimport type { ProviderProps } from '@/lib/types';\nimport type { LinkProps } from './types';\n\nexport function LinkProvider({ children, ...props }: ProviderProps<LinkProps>) {\n  return <LinkContext.Provider value={props}>{children}</LinkContext.Provider>;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAkBA,SAAgB,aAAa,EAAE,UAAU,GAAG,SAAmC;AAC7E,QAAO,oBAAC,YAAY;EAAS,OAAO;EAAQ;GAAgC"}
+{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/link/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 'client-only';\nimport { LinkContext } from 'react-aria-components';\nimport type { ProviderProps } from '@/lib/types';\nimport type { LinkProps } from './types';\n\n/**\n * LinkProvider - Context provider for setting default Link props.\n *\n * Use this to configure shared allowsVisited and className across\n * multiple Link components.\n *\n * @param props - ProviderProps<LinkProps>\n * @param props.children - Child components to receive context.\n * @returns The rendered LinkProvider component.\n *\n * @example\n * ```tsx\n * <LinkProvider allowsVisited className=\"visited:underline\">\n *   <Link href=\"/link1\">Link One</Link>\n *   <Link href=\"/link2\">Link Two</Link>\n * </LinkProvider>\n * ```\n */\nexport function LinkProvider({ children, ...props }: ProviderProps<LinkProps>) {\n  return <LinkContext.Provider value={props}>{children}</LinkContext.Provider>;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoCA,SAAgB,aAAa,EAAE,UAAU,GAAG,SAAmC;AAC7E,QAAO,oBAAC,YAAY;EAAS,OAAO;EAAQ;GAAgC"}

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

@@ -12,22 +12,32 @@
 
 import { LinkProps } from "./types.js";
 import "client-only";
-import * as react_jsx_runtime113 from "react/jsx-runtime";
+import * as react_jsx_runtime93 from "react/jsx-runtime";
 
 //#region src/components/link/index.d.ts
+
 /**
  * Link - Accessible anchor/link component with optional visited state
  *
  * A flexible link component that handles visited state, external anchors, and
  * icon integration while providing ARIA-compatible behavior.
  *
+ * @param props - {@link LinkProps}
+ * @param props.ref - Ref to the anchor element.
+ * @param props.allowsVisited - Whether the link shows visited styling when visited.
+ * @param props.className - Optional CSS class name.
+ * @param props.isVisited - Whether the link is in a visited state.
+ * @returns The rendered Link component.
+ *
  * @example
+ * ```tsx
  * <Link href="/dashboard">Go to Dashboard</Link>
+ * ```
  */
 declare function Link({
   ref,
   ...props
-}: LinkProps): react_jsx_runtime113.JSX.Element;
+}: LinkProps): react_jsx_runtime93.JSX.Element;
 //#endregion
 export { Link };
 //# sourceMappingURL=index.d.ts.map

package/dist/components/link/index.js

@@ -26,8 +26,17 @@ import styles from "./styles.module.css";
 * A flexible link component that handles visited state, external anchors, and
 * icon integration while providing ARIA-compatible behavior.
 *
+* @param props - {@link LinkProps}
+* @param props.ref - Ref to the anchor element.
+* @param props.allowsVisited - Whether the link shows visited styling when visited.
+* @param props.className - Optional CSS class name.
+* @param props.isVisited - Whether the link is in a visited state.
+* @returns The rendered Link component.
+*
 * @example
+* ```tsx
 * <Link href="/dashboard">Go to Dashboard</Link>
+* ```
 */
 function Link({ ref, ...props }) {
 	[props, ref] = useContextProps(props, ref ?? null, LinkContext);

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["AriaLink","className"],"sources":["../../../src/components/link/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 {\n  Link as AriaLink,\n  composeRenderProps,\n  LinkContext,\n  useContextProps,\n} from 'react-aria-components';\nimport styles from './styles.module.css';\nimport type { LinkProps } from './types';\n\n/**\n * Link - Accessible anchor/link component with optional visited state\n *\n * A flexible link component that handles visited state, external anchors, and\n * icon integration while providing ARIA-compatible behavior.\n *\n * @example\n * <Link href=\"/dashboard\">Go to Dashboard</Link>\n */\nexport function Link({ ref, ...props }: LinkProps) {\n  [props, ref] = useContextProps(props, ref ?? null, LinkContext);\n\n  const {\n    allowsVisited = false,\n    className,\n    isVisited = false,\n    ...rest\n  } = props;\n\n  return (\n    <AriaLink\n      {...rest}\n      ref={ref}\n      className={composeRenderProps(className, (className) =>\n        clsx(styles.link, className),\n      )}\n      data-visited={(allowsVisited && isVisited) || null}\n    />\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiCA,SAAgB,KAAK,EAAE,KAAK,GAAG,SAAoB;AACjD,EAAC,OAAO,OAAO,gBAAgB,OAAO,OAAO,MAAM,YAAY;CAE/D,MAAM,EACJ,gBAAgB,OAChB,WACA,YAAY,OACZ,GAAG,SACD;AAEJ,QACE,oBAACA;EACC,GAAI;EACC;EACL,WAAW,mBAAmB,YAAY,gBACxC,KAAK,OAAO,MAAMC,YAAU,CAC7B;EACD,gBAAe,iBAAiB,aAAc;GAC9C"}
+{"version":3,"file":"index.js","names":["AriaLink","className"],"sources":["../../../src/components/link/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 {\n  Link as AriaLink,\n  composeRenderProps,\n  LinkContext,\n  useContextProps,\n} from 'react-aria-components';\nimport styles from './styles.module.css';\nimport type { LinkProps } from './types';\n\n/**\n * Link - Accessible anchor/link component with optional visited state\n *\n * A flexible link component that handles visited state, external anchors, and\n * icon integration while providing ARIA-compatible behavior.\n *\n * @param props - {@link LinkProps}\n * @param props.ref - Ref to the anchor element.\n * @param props.allowsVisited - Whether the link shows visited styling when visited.\n * @param props.className - Optional CSS class name.\n * @param props.isVisited - Whether the link is in a visited state.\n * @returns The rendered Link component.\n *\n * @example\n * ```tsx\n * <Link href=\"/dashboard\">Go to Dashboard</Link>\n * ```\n */\nexport function Link({ ref, ...props }: LinkProps) {\n  [props, ref] = useContextProps(props, ref ?? null, LinkContext);\n\n  const {\n    allowsVisited = false,\n    className,\n    isVisited = false,\n    ...rest\n  } = props;\n\n  return (\n    <AriaLink\n      {...rest}\n      ref={ref}\n      className={composeRenderProps(className, (className) =>\n        clsx(styles.link, className),\n      )}\n      data-visited={(allowsVisited && isVisited) || null}\n    />\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0CA,SAAgB,KAAK,EAAE,KAAK,GAAG,SAAoB;AACjD,EAAC,OAAO,OAAO,gBAAgB,OAAO,OAAO,MAAM,YAAY;CAE/D,MAAM,EACJ,gBAAgB,OAChB,WACA,YAAY,OACZ,GAAG,SACD;AAEJ,QACE,oBAACA;EACC,GAAI;EACC;EACL,WAAW,mBAAmB,YAAY,gBACxC,KAAK,OAAO,MAAMC,YAAU,CAC7B;EACD,gBAAe,iBAAiB,aAAc;GAC9C"}

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

@@ -14,8 +14,13 @@ import { RefAttributes } from "react";
 import { LinkProps as LinkProps$1 } from "react-aria-components";
 
 //#region src/components/link/types.d.ts
+/**
+ * Props for the Link component.
+ */
 type LinkProps = LinkProps$1 & RefAttributes<HTMLAnchorElement> & {
+  /** Whether the link shows visited styling when visited. */
   allowsVisited?: boolean;
+  /** Whether the link is in a visited state. */
   isVisited?: boolean;
 };
 //#endregion

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

@@ -12,11 +12,20 @@
 
 import { ListItemVariant, ListProps } from "./types.js";
 import "client-only";
-import * as react27 from "react";
+import * as react0 from "react";
 import { ContextValue } from "react-aria-components";
 
 //#region src/components/list/context.d.ts
-declare const ListContext: react27.Context<ContextValue<ListProps<object>, HTMLDivElement>>;
+/**
+ * Context for sharing List variant across component tree.
+ */
+declare const ListContext: react0.Context<ContextValue<ListProps<object>, HTMLDivElement>>;
+/**
+ * Hook to get the current list item variant from context.
+ * Used internally by ListItemTitle and ListItemDescription for sizing.
+ *
+ * @returns The current list item variant from context, or 'cozy' as the default.
+ */
 declare const useListItemVariant: () => ListItemVariant;
 //#endregion
 export { ListContext, useListItemVariant };

package/dist/components/list/context.js

@@ -18,7 +18,16 @@ import { createContext, useContext } from "react";
 
 //#region src/components/list/context.tsx
 const ListStylesDefaults = { variant: "cozy" };
+/**
+* Context for sharing List variant across component tree.
+*/
 const ListContext = createContext({ variant: ListStylesDefaults.variant });
+/**
+* Hook to get the current list item variant from context.
+* Used internally by ListItemTitle and ListItemDescription for sizing.
+*
+* @returns The current list item variant from context, or 'cozy' as the default.
+*/
 const useListItemVariant = () => {
 	const context = useContext(ListContext);
 	if (typeof context === "object" && context !== null) {

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

@@ -1 +1 @@
-{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/list/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 'client-only';\nimport { createContext, useContext } from 'react';\nimport type { ContextValue } from 'react-aria-components';\nimport type { ListProps } from './types';\n\nconst ListStylesDefaults = {\n  variant: 'cozy',\n} as const;\n\nexport const ListContext = createContext<\n  ContextValue<ListProps<object>, HTMLDivElement>\n>({ variant: ListStylesDefaults.variant });\n\nexport const useListItemVariant = () => {\n  const context = useContext(ListContext);\n\n  if (typeof context === 'object' && context !== null) {\n    if ('variant' in context && context.variant) {\n      return context.variant;\n    }\n  }\n\n  return ListStylesDefaults.variant;\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAkBA,MAAM,qBAAqB,EACzB,SAAS,QACV;AAED,MAAa,cAAc,cAEzB,EAAE,SAAS,mBAAmB,SAAS,CAAC;AAE1C,MAAa,2BAA2B;CACtC,MAAM,UAAU,WAAW,YAAY;AAEvC,KAAI,OAAO,YAAY,YAAY,YAAY,MAC7C;MAAI,aAAa,WAAW,QAAQ,QAClC,QAAO,QAAQ;;AAInB,QAAO,mBAAmB"}
+{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/list/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 'client-only';\nimport { createContext, useContext } from 'react';\nimport type { ContextValue } from 'react-aria-components';\nimport type { ListProps } from './types';\n\nconst ListStylesDefaults = {\n  variant: 'cozy',\n} as const;\n\n/**\n * Context for sharing List variant across component tree.\n */\nexport const ListContext = createContext<\n  ContextValue<ListProps<object>, HTMLDivElement>\n>({ variant: ListStylesDefaults.variant });\n\n/**\n * Hook to get the current list item variant from context.\n * Used internally by ListItemTitle and ListItemDescription for sizing.\n *\n * @returns The current list item variant from context, or 'cozy' as the default.\n */\nexport const useListItemVariant = () => {\n  const context = useContext(ListContext);\n\n  if (typeof context === 'object' && context !== null) {\n    if ('variant' in context && context.variant) {\n      return context.variant;\n    }\n  }\n\n  return ListStylesDefaults.variant;\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAkBA,MAAM,qBAAqB,EACzB,SAAS,QACV;;;;AAKD,MAAa,cAAc,cAEzB,EAAE,SAAS,mBAAmB,SAAS,CAAC;;;;;;;AAQ1C,MAAa,2BAA2B;CACtC,MAAM,UAAU,WAAW,YAAY;AAEvC,KAAI,OAAO,YAAY,YAAY,YAAY,MAC7C;MAAI,aAAa,WAAW,QAAQ,QAClC,QAAO,QAAQ;;AAInB,QAAO,mBAAmB"}

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

@@ -12,7 +12,7 @@
 
 import { ListProps } from "./types.js";
 import "client-only";
-import * as react_jsx_runtime115 from "react/jsx-runtime";
+import * as react_jsx_runtime95 from "react/jsx-runtime";
 
 //#region src/components/list/index.d.ts
 
@@ -24,6 +24,7 @@ import * as react_jsx_runtime115 from "react/jsx-runtime";
  * data tables, file lists, or any selectable grid interface.
  *
  * @example
+ * ```tsx
  * // Basic list view with sizing
  * <div className='h-[400px] w-[300px]'>
  *   <List className='h-full' aria-label='Items'>
@@ -34,11 +35,19 @@ import * as react_jsx_runtime115 from "react/jsx-runtime";
  *     </ListItem>
  *   </List>
  * </div>
+ * ```
+ *
+ * @param props - {@link ListProps}
+ * @param props.ref - Forwarded ref to the underlying GridList element.
+ * @param props.children - List item elements to render.
+ * @param props.className - Optional CSS class name.
+ * @param props.variant - Visual density variant for list items.
+ * @returns The rendered List component.
  */
 declare function List<T extends object>({
   ref,
   ...props
-}: ListProps<T>): react_jsx_runtime115.JSX.Element;
+}: ListProps<T>): react_jsx_runtime95.JSX.Element;
 //#endregion
 export { List };
 //# sourceMappingURL=index.d.ts.map

package/dist/components/list/index.js

@@ -30,6 +30,7 @@ import styles from "./styles.module.css";
 * data tables, file lists, or any selectable grid interface.
 *
 * @example
+* ```tsx
 * // Basic list view with sizing
 * <div className='h-[400px] w-[300px]'>
 *   <List className='h-full' aria-label='Items'>
@@ -40,6 +41,14 @@ import styles from "./styles.module.css";
 *     </ListItem>
 *   </List>
 * </div>
+* ```
+*
+* @param props - {@link ListProps}
+* @param props.ref - Forwarded ref to the underlying GridList element.
+* @param props.children - List item elements to render.
+* @param props.className - Optional CSS class name.
+* @param props.variant - Visual density variant for list items.
+* @returns The rendered List component.
 */
 function List({ ref, ...props }) {
 	[props, ref] = useContextProps(props, ref ?? null, ListContext);

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["className"],"sources":["../../../src/components/list/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 {\n  composeRenderProps,\n  GridList,\n  useContextProps,\n} from 'react-aria-components';\nimport { IconProvider } from '../icon/context';\nimport { ListContext } from './context';\nimport styles from './styles.module.css';\nimport type { ListProps } from './types';\n\n/**\n * List - A flexible grid list component for selectable items with rich content\n *\n * Provides accessible grid list functionality with support for selection,\n * and rich item content including labels, descriptions, icons, and actions. Perfect for\n * data tables, file lists, or any selectable grid interface.\n *\n * @example\n * // Basic list view with sizing\n * <div className='h-[400px] w-[300px]'>\n *   <List className='h-full' aria-label='Items'>\n *     <ListItem>\n *       <ListItemContent>\n *         <ListItemTitle>Item 1</ListItemTitle>\n *       </ListItemContent>\n *     </ListItem>\n *   </List>\n * </div>\n */\nexport function List<T extends object>({ ref, ...props }: ListProps<T>) {\n  [props, ref] = useContextProps(props, ref ?? null, ListContext);\n\n  const { children, className, variant, ...rest } = props;\n\n  return (\n    <ListContext.Provider value={{ variant }}>\n      <IconProvider size={variant === 'cozy' ? 'large' : 'small'}>\n        <GridList<T>\n          {...rest}\n          ref={ref}\n          className={composeRenderProps(className, (className) =>\n            clsx('group/list', styles.list, className),\n          )}\n        >\n          {children}\n        </GridList>\n      </IconProvider>\n    </ListContext.Provider>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4CA,SAAgB,KAAuB,EAAE,KAAK,GAAG,SAAuB;AACtE,EAAC,OAAO,OAAO,gBAAgB,OAAO,OAAO,MAAM,YAAY;CAE/D,MAAM,EAAE,UAAU,WAAW,SAAS,GAAG,SAAS;AAElD,QACE,oBAAC,YAAY;EAAS,OAAO,EAAE,SAAS;YACtC,oBAAC;GAAa,MAAM,YAAY,SAAS,UAAU;aACjD,oBAAC;IACC,GAAI;IACC;IACL,WAAW,mBAAmB,YAAY,gBACxC,KAAK,cAAc,OAAO,MAAMA,YAAU,CAC3C;IAEA;KACQ;IACE;GACM"}
+{"version":3,"file":"index.js","names":["className"],"sources":["../../../src/components/list/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 {\n  composeRenderProps,\n  GridList,\n  useContextProps,\n} from 'react-aria-components';\nimport { IconProvider } from '../icon/context';\nimport { ListContext } from './context';\nimport styles from './styles.module.css';\nimport type { ListProps } from './types';\n\n/**\n * List - A flexible grid list component for selectable items with rich content\n *\n * Provides accessible grid list functionality with support for selection,\n * and rich item content including labels, descriptions, icons, and actions. Perfect for\n * data tables, file lists, or any selectable grid interface.\n *\n * @example\n * ```tsx\n * // Basic list view with sizing\n * <div className='h-[400px] w-[300px]'>\n *   <List className='h-full' aria-label='Items'>\n *     <ListItem>\n *       <ListItemContent>\n *         <ListItemTitle>Item 1</ListItemTitle>\n *       </ListItemContent>\n *     </ListItem>\n *   </List>\n * </div>\n * ```\n *\n * @param props - {@link ListProps}\n * @param props.ref - Forwarded ref to the underlying GridList element.\n * @param props.children - List item elements to render.\n * @param props.className - Optional CSS class name.\n * @param props.variant - Visual density variant for list items.\n * @returns The rendered List component.\n */\nexport function List<T extends object>({ ref, ...props }: ListProps<T>) {\n  [props, ref] = useContextProps(props, ref ?? null, ListContext);\n\n  const { children, className, variant, ...rest } = props;\n\n  return (\n    <ListContext.Provider value={{ variant }}>\n      <IconProvider size={variant === 'cozy' ? 'large' : 'small'}>\n        <GridList<T>\n          {...rest}\n          ref={ref}\n          className={composeRenderProps(className, (className) =>\n            clsx('group/list', styles.list, className),\n          )}\n        >\n          {children}\n        </GridList>\n      </IconProvider>\n    </ListContext.Provider>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqDA,SAAgB,KAAuB,EAAE,KAAK,GAAG,SAAuB;AACtE,EAAC,OAAO,OAAO,gBAAgB,OAAO,OAAO,MAAM,YAAY;CAE/D,MAAM,EAAE,UAAU,WAAW,SAAS,GAAG,SAAS;AAElD,QACE,oBAAC,YAAY;EAAS,OAAO,EAAE,SAAS;YACtC,oBAAC;GAAa,MAAM,YAAY,SAAS,UAAU;aACjD,oBAAC;IACC,GAAI;IACC;IACL,WAAW,mBAAmB,YAAY,gBACxC,KAAK,cAAc,OAAO,MAAMA,YAAU,CAC3C;IAEA;KACQ;IACE;GACM"}

package/dist/components/list/item-content.d.ts

@@ -12,9 +12,10 @@
 
 import { ListItemContentProps } from "./types.js";
 import "client-only";
-import * as react_jsx_runtime120 from "react/jsx-runtime";
+import * as react_jsx_runtime97 from "react/jsx-runtime";
 
 //#region src/components/list/item-content.d.ts
+
 /**
  * ListItemContent - Container for list item title and description
  *
@@ -22,15 +23,21 @@ import * as react_jsx_runtime120 from "react/jsx-runtime";
  * Should contain ListItemTitle and optionally ListItemDescription components.
  *
  * @example
+ * ```tsx
  * <ListItemContent>
  *   <ListItemTitle>Item Title</ListItemTitle>
  *   <ListItemDescription>Optional description text</ListItemDescription>
  * </ListItemContent>
+ * ```
+ *
+ * @param props - {@link ListItemContentProps}
+ * @param props.className - Optional CSS class name.
+ * @returns The rendered ListItemContent component.
  */
 declare function ListItemContent({
   className,
   ...rest
-}: ListItemContentProps): react_jsx_runtime120.JSX.Element;
+}: ListItemContentProps): react_jsx_runtime97.JSX.Element;
 //#endregion
 export { ListItemContent };
 //# sourceMappingURL=item-content.d.ts.map

package/dist/components/list/item-content.js

@@ -26,10 +26,16 @@ import styles from "./styles.module.css";
 * Should contain ListItemTitle and optionally ListItemDescription components.
 *
 * @example
+* ```tsx
 * <ListItemContent>
 *   <ListItemTitle>Item Title</ListItemTitle>
 *   <ListItemDescription>Optional description text</ListItemDescription>
 * </ListItemContent>
+* ```
+*
+* @param props - {@link ListItemContentProps}
+* @param props.className - Optional CSS class name.
+* @returns The rendered ListItemContent component.
 */
 function ListItemContent({ className, ...rest }) {
 	return /* @__PURE__ */ jsx("div", {

package/dist/components/list/item-content.js.map

@@ -1 +1 @@
-{"version":3,"file":"item-content.js","names":[],"sources":["../../../src/components/list/item-content.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 styles from './styles.module.css';\nimport type { ListItemContentProps } from './types';\n\n/**\n * ListItemContent - Container for list item title and description\n *\n * Provides consistent spacing and layout for text content within list items.\n * Should contain ListItemTitle and optionally ListItemDescription components.\n *\n * @example\n * <ListItemContent>\n *   <ListItemTitle>Item Title</ListItemTitle>\n *   <ListItemDescription>Optional description text</ListItemDescription>\n * </ListItemContent>\n */\nexport function ListItemContent({ className, ...rest }: ListItemContentProps) {\n  return <div {...rest} className={clsx(styles.content, className)} />;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8BA,SAAgB,gBAAgB,EAAE,WAAW,GAAG,QAA8B;AAC5E,QAAO,oBAAC;EAAI,GAAI;EAAM,WAAW,KAAK,OAAO,SAAS,UAAU;GAAI"}
+{"version":3,"file":"item-content.js","names":[],"sources":["../../../src/components/list/item-content.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 styles from './styles.module.css';\nimport type { ListItemContentProps } from './types';\n\n/**\n * ListItemContent - Container for list item title and description\n *\n * Provides consistent spacing and layout for text content within list items.\n * Should contain ListItemTitle and optionally ListItemDescription components.\n *\n * @example\n * ```tsx\n * <ListItemContent>\n *   <ListItemTitle>Item Title</ListItemTitle>\n *   <ListItemDescription>Optional description text</ListItemDescription>\n * </ListItemContent>\n * ```\n *\n * @param props - {@link ListItemContentProps}\n * @param props.className - Optional CSS class name.\n * @returns The rendered ListItemContent component.\n */\nexport function ListItemContent({ className, ...rest }: ListItemContentProps) {\n  return <div {...rest} className={clsx(styles.content, className)} />;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoCA,SAAgB,gBAAgB,EAAE,WAAW,GAAG,QAA8B;AAC5E,QAAO,oBAAC;EAAI,GAAI;EAAM,WAAW,KAAK,OAAO,SAAS,UAAU;GAAI"}

package/dist/components/list/item-description.d.ts

@@ -12,7 +12,7 @@
 
 import { ListItemDescriptionProps } from "./types.js";
 import "client-only";
-import * as react_jsx_runtime121 from "react/jsx-runtime";
+import * as react_jsx_runtime99 from "react/jsx-runtime";
 
 //#region src/components/list/item-description.d.ts
 /**
@@ -22,13 +22,20 @@ import * as react_jsx_runtime121 from "react/jsx-runtime";
  * Automatically adjusts font size for cozy (body-s) and compact (body-xs) variants.
  *
  * @example
+ * ```tsx
  * <ListItemDescription>Software Engineer</ListItemDescription>
+ * ```
+ *
+ * @param props - {@link ListItemDescriptionProps}
+ * @param props.children - Description text content.
+ * @param props.className - Optional CSS class name.
+ * @returns The rendered ListItemDescription component.
  */
 declare function ListItemDescription({
   children,
   className,
   ...rest
-}: ListItemDescriptionProps): react_jsx_runtime121.JSX.Element;
+}: ListItemDescriptionProps): react_jsx_runtime99.JSX.Element;
 //#endregion
 export { ListItemDescription };
 //# sourceMappingURL=item-description.d.ts.map

package/dist/components/list/item-description.js

@@ -27,7 +27,14 @@ import styles from "./styles.module.css";
 * Automatically adjusts font size for cozy (body-s) and compact (body-xs) variants.
 *
 * @example
+* ```tsx
 * <ListItemDescription>Software Engineer</ListItemDescription>
+* ```
+*
+* @param props - {@link ListItemDescriptionProps}
+* @param props.children - Description text content.
+* @param props.className - Optional CSS class name.
+* @returns The rendered ListItemDescription component.
 */
 function ListItemDescription({ children, className, ...rest }) {
 	const variant = useListItemVariant();

package/dist/components/list/item-description.js.map

@@ -1 +1 @@
-{"version":3,"file":"item-description.js","names":[],"sources":["../../../src/components/list/item-description.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 { useListItemVariant } from './context';\nimport styles from './styles.module.css';\nimport type { ListItemDescriptionProps } from './types';\n\n/**\n * ListItemDescription - Secondary descriptive text for list items\n *\n * Renders supplementary information below the title with muted styling.\n * Automatically adjusts font size for cozy (body-s) and compact (body-xs) variants.\n *\n * @example\n * <ListItemDescription>Software Engineer</ListItemDescription>\n */\nexport function ListItemDescription({\n  children,\n  className,\n  ...rest\n}: ListItemDescriptionProps) {\n  const variant = useListItemVariant();\n\n  return (\n    <div\n      {...rest}\n      className={clsx(styles.description, styles[variant], className)}\n    >\n      {children}\n    </div>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4BA,SAAgB,oBAAoB,EAClC,UACA,WACA,GAAG,QACwB;CAC3B,MAAM,UAAU,oBAAoB;AAEpC,QACE,oBAAC;EACC,GAAI;EACJ,WAAW,KAAK,OAAO,aAAa,OAAO,UAAU,UAAU;EAE9D;GACG"}
+{"version":3,"file":"item-description.js","names":[],"sources":["../../../src/components/list/item-description.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 { useListItemVariant } from './context';\nimport styles from './styles.module.css';\nimport type { ListItemDescriptionProps } from './types';\n\n/**\n * ListItemDescription - Secondary descriptive text for list items\n *\n * Renders supplementary information below the title with muted styling.\n * Automatically adjusts font size for cozy (body-s) and compact (body-xs) variants.\n *\n * @example\n * ```tsx\n * <ListItemDescription>Software Engineer</ListItemDescription>\n * ```\n *\n * @param props - {@link ListItemDescriptionProps}\n * @param props.children - Description text content.\n * @param props.className - Optional CSS class name.\n * @returns The rendered ListItemDescription component.\n */\nexport function ListItemDescription({\n  children,\n  className,\n  ...rest\n}: ListItemDescriptionProps) {\n  const variant = useListItemVariant();\n\n  return (\n    <div\n      {...rest}\n      className={clsx(styles.description, styles[variant], className)}\n    >\n      {children}\n    </div>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmCA,SAAgB,oBAAoB,EAClC,UACA,WACA,GAAG,QACwB;CAC3B,MAAM,UAAU,oBAAoB;AAEpC,QACE,oBAAC;EACC,GAAI;EACJ,WAAW,KAAK,OAAO,aAAa,OAAO,UAAU,UAAU;EAE9D;GACG"}

package/dist/components/list/item-title.d.ts

@@ -12,7 +12,7 @@
 
 import { ListItemTitleProps } from "./types.js";
 import "client-only";
-import * as react_jsx_runtime122 from "react/jsx-runtime";
+import * as react_jsx_runtime135 from "react/jsx-runtime";
 
 //#region src/components/list/item-title.d.ts
 /**
@@ -22,13 +22,20 @@ import * as react_jsx_runtime122 from "react/jsx-runtime";
  * Automatically adjusts font size for cozy (header-m) and compact (header-s) variants.
  *
  * @example
+ * ```tsx
  * <ListItemTitle>John Doe</ListItemTitle>
+ * ```
+ *
+ * @param props - {@link ListItemTitleProps}
+ * @param props.children - Title text content.
+ * @param props.className - Optional CSS class name.
+ * @returns The rendered ListItemTitle component.
  */
 declare function ListItemTitle({
   children,
   className,
   ...rest
-}: ListItemTitleProps): react_jsx_runtime122.JSX.Element;
+}: ListItemTitleProps): react_jsx_runtime135.JSX.Element;
 //#endregion
 export { ListItemTitle };
 //# sourceMappingURL=item-title.d.ts.map

package/dist/components/list/item-title.js

@@ -27,7 +27,14 @@ import styles from "./styles.module.css";
 * Automatically adjusts font size for cozy (header-m) and compact (header-s) variants.
 *
 * @example
+* ```tsx
 * <ListItemTitle>John Doe</ListItemTitle>
+* ```
+*
+* @param props - {@link ListItemTitleProps}
+* @param props.children - Title text content.
+* @param props.className - Optional CSS class name.
+* @returns The rendered ListItemTitle component.
 */
 function ListItemTitle({ children, className, ...rest }) {
 	const variant = useListItemVariant();

package/dist/components/list/item-title.js.map

@@ -1 +1 @@
-{"version":3,"file":"item-title.js","names":[],"sources":["../../../src/components/list/item-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 { clsx } from '@accelint/design-foundation/lib/utils';\nimport { useListItemVariant } from './context';\nimport styles from './styles.module.css';\nimport type { ListItemTitleProps } from './types';\n\n/**\n * ListItemTitle - Primary text label for list items\n *\n * Renders the main title text with appropriate typography based on the list variant.\n * Automatically adjusts font size for cozy (header-m) and compact (header-s) variants.\n *\n * @example\n * <ListItemTitle>John Doe</ListItemTitle>\n */\nexport function ListItemTitle({\n  children,\n  className,\n  ...rest\n}: ListItemTitleProps) {\n  const variant = useListItemVariant();\n\n  return (\n    <div {...rest} className={clsx(styles.title, styles[variant], className)}>\n      {children}\n    </div>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4BA,SAAgB,cAAc,EAC5B,UACA,WACA,GAAG,QACkB;CACrB,MAAM,UAAU,oBAAoB;AAEpC,QACE,oBAAC;EAAI,GAAI;EAAM,WAAW,KAAK,OAAO,OAAO,OAAO,UAAU,UAAU;EACrE;GACG"}
+{"version":3,"file":"item-title.js","names":[],"sources":["../../../src/components/list/item-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 { clsx } from '@accelint/design-foundation/lib/utils';\nimport { useListItemVariant } from './context';\nimport styles from './styles.module.css';\nimport type { ListItemTitleProps } from './types';\n\n/**\n * ListItemTitle - Primary text label for list items\n *\n * Renders the main title text with appropriate typography based on the list variant.\n * Automatically adjusts font size for cozy (header-m) and compact (header-s) variants.\n *\n * @example\n * ```tsx\n * <ListItemTitle>John Doe</ListItemTitle>\n * ```\n *\n * @param props - {@link ListItemTitleProps}\n * @param props.children - Title text content.\n * @param props.className - Optional CSS class name.\n * @returns The rendered ListItemTitle component.\n */\nexport function ListItemTitle({\n  children,\n  className,\n  ...rest\n}: ListItemTitleProps) {\n  const variant = useListItemVariant();\n\n  return (\n    <div {...rest} className={clsx(styles.title, styles[variant], className)}>\n      {children}\n    </div>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmCA,SAAgB,cAAc,EAC5B,UACA,WACA,GAAG,QACkB;CACrB,MAAM,UAAU,oBAAoB;AAEpC,QACE,oBAAC;EAAI,GAAI;EAAM,WAAW,KAAK,OAAO,OAAO,OAAO,UAAU,UAAU;EACrE;GACG"}

package/dist/components/list/item.d.ts

@@ -12,7 +12,7 @@
 
 import { ListItemProps } from "./types.js";
 import "client-only";
-import * as react_jsx_runtime125 from "react/jsx-runtime";
+import * as react_jsx_runtime138 from "react/jsx-runtime";
 
 //#region src/components/list/item.d.ts
 
@@ -25,6 +25,7 @@ import * as react_jsx_runtime125 from "react/jsx-runtime";
  * wrapped in a ListItemTitle.
  *
  * @example
+ * ```tsx
  * <ListItem textValue="User item">
  *   <Icon><Avatar /></Icon>
  *   <ListItemContent>
@@ -32,13 +33,20 @@ import * as react_jsx_runtime125 from "react/jsx-runtime";
  *     <ListItemDescription>Software Engineer</ListItemDescription>
  *   </ListItemContent>
  * </ListItem>
+ * ```
+ *
+ * @param props - {@link ListItemProps}
+ * @param props.children - Content to render inside the list item.
+ * @param props.classNames - CSS class names for list item elements.
+ * @param props.textValue - Accessible text value for the item.
+ * @returns The rendered ListItem component.
  */
 declare function ListItem<T extends object>({
   children,
   classNames,
   textValue,
   ...rest
-}: ListItemProps<T>): react_jsx_runtime125.JSX.Element;
+}: ListItemProps<T>): react_jsx_runtime138.JSX.Element;
 //#endregion
 export { ListItem };
 //# sourceMappingURL=item.d.ts.map

package/dist/components/list/item.js

@@ -30,6 +30,7 @@ import styles from "./styles.module.css";
 * wrapped in a ListItemTitle.
 *
 * @example
+* ```tsx
 * <ListItem textValue="User item">
 *   <Icon><Avatar /></Icon>
 *   <ListItemContent>
@@ -37,6 +38,13 @@ import styles from "./styles.module.css";
 *     <ListItemDescription>Software Engineer</ListItemDescription>
 *   </ListItemContent>
 * </ListItem>
+* ```
+*
+* @param props - {@link ListItemProps}
+* @param props.children - Content to render inside the list item.
+* @param props.classNames - CSS class names for list item elements.
+* @param props.textValue - Accessible text value for the item.
+* @returns The rendered ListItem component.
 */
 function ListItem({ children, classNames, textValue = typeof children === "string" ? children : "", ...rest }) {
 	return /* @__PURE__ */ jsx(GridListItem, {