@accelint/design-toolkit 9.3.0 → 9.4.0

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

@@ -14,45 +14,96 @@ import { SearchFieldProps } from "../search-field/types.js";
 import { FormEvent, PropsWithChildren, ReactNode } from "react";
 
 //#region src/components/kanban/types.d.ts
+/**
+ * Data structure for a Kanban column.
+ */
 type KanbanColumnData = {
+  /** Display title of the column. */
   title: string;
+  /** Unique identifier for the column. */
   id: string;
+  /** Cards contained in this column. */
   cards: KanbanCardData[];
+  /** Whether cards can be dropped into this column. */
   canDrop?: boolean;
 };
+/**
+ * Base props for Kanban components.
+ */
 interface KanbanComponentProps extends PropsWithChildren {
+  /** Optional CSS class name. */
   className?: string;
 }
+/**
+ * Props for KanbanColumn component.
+ */
 interface KanbanColProps extends KanbanComponentProps {
+  /** Column data including cards. */
   column: KanbanColumnData;
 }
+/**
+ * Props for the root Kanban component.
+ */
 interface KanbanProps extends KanbanComponentProps {
+  /** Column elements to render. */
   columns?: ReactNode[];
 }
+/**
+ * Props for Kanban menu components.
+ */
 interface KanbanMenuProps extends KanbanComponentProps {
+  /** Number of cards to display in badge. */
   cardCount?: number;
 }
+/**
+ * Props for KanbanHeaderSearch component.
+ */
 interface KanbanSearchProps extends SearchFieldProps {
+  /** Handler for input events. */
   onInput?: (e: FormEvent<HTMLInputElement>) => void;
 }
+/**
+ * Props for KanbanColumnActions component.
+ */
 interface KanbanColContentActionProps extends KanbanComponentProps {
+  /** Callback when add card button is pressed. */
   onAddCard?: () => void;
 }
+/**
+ * Props for KanbanColumnContent component.
+ */
 interface KanbanColContentProps {
+  /** Card elements to render. */
   children?: ReactNode | ReactNode[];
+  /** Optional CSS class name. */
   className?: string;
+  /** Column data for sortable context. */
   column: KanbanColumnData;
 }
+/**
+ * Data structure for a Kanban card.
+ */
 type KanbanCardData = {
+  /** Card body content. */
   body: ReactNode | string;
+  /** Card title. */
   title: string;
+  /** Whether this card is currently active/selected. */
   isActive?: boolean;
+  /** Unique identifier for the card. */
   id: string;
+  /** ID of the column containing this card. */
   columnId: string;
+  /** Position index within the column. */
   position: number;
 };
+/**
+ * Props for KanbanCard component.
+ */
 interface KanbanCardProps extends KanbanComponentProps {
+  /** Whether this card is currently active/selected. */
   isActive?: boolean;
+  /** Card data. */
   card: KanbanCardData;
 }
 //#endregion

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

@@ -13,16 +13,37 @@
 import { ProviderProps } from "../../lib/types.js";
 import { LabelProps as LabelProps$1 } from "./types.js";
 import "client-only";
-import * as react27 from "react";
+import * as react26 from "react";
 import { ContextValue } from "react-aria-components";
-import * as react_jsx_runtime85 from "react/jsx-runtime";
+import * as react_jsx_runtime89 from "react/jsx-runtime";
 
 //#region src/components/label/context.d.ts
-declare const LabelContext: react27.Context<ContextValue<LabelProps$1, HTMLLabelElement>>;
+/**
+ * Context for sharing Label props across component tree.
+ */
+declare const LabelContext: react26.Context<ContextValue<LabelProps$1, HTMLLabelElement>>;
+/**
+ * LabelProvider - Context provider for setting default Label props.
+ *
+ * Use this to configure shared isRequired and isDisabled states
+ * across multiple Label components.
+ *
+ * @param props - ProviderProps<LabelProps>
+ * @param props.children - Child components to receive context.
+ * @returns The rendered LabelProvider component.
+ *
+ * @example
+ * ```tsx
+ * <LabelProvider isRequired>
+ *   <Label>First Name</Label>
+ *   <Label>Last Name</Label>
+ * </LabelProvider>
+ * ```
+ */
 declare function LabelProvider({
   children,
   ...props
-}: ProviderProps<LabelProps$1>): react_jsx_runtime85.JSX.Element;
+}: ProviderProps<LabelProps$1>): react_jsx_runtime89.JSX.Element;
 //#endregion
 export { LabelContext, LabelProvider };
 //# sourceMappingURL=context.d.ts.map

package/dist/components/label/context.js

@@ -18,7 +18,28 @@ import { createContext } from "react";
 import { jsx } from "react/jsx-runtime";
 
 //#region src/components/label/context.tsx
+/**
+* Context for sharing Label props across component tree.
+*/
 const LabelContext = createContext(null);
+/**
+* LabelProvider - Context provider for setting default Label props.
+*
+* Use this to configure shared isRequired and isDisabled states
+* across multiple Label components.
+*
+* @param props - ProviderProps<LabelProps>
+* @param props.children - Child components to receive context.
+* @returns The rendered LabelProvider component.
+*
+* @example
+* ```tsx
+* <LabelProvider isRequired>
+*   <Label>First Name</Label>
+*   <Label>Last Name</Label>
+* </LabelProvider>
+* ```
+*/
 function LabelProvider({ children, ...props }) {
 	return /* @__PURE__ */ jsx(LabelContext.Provider, {
 		value: props,

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

@@ -1 +1 @@
-{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/label/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 { LabelProps } from './types';\n\nexport const LabelContext =\n  createContext<ContextValue<LabelProps, HTMLLabelElement>>(null);\n\nexport function LabelProvider({\n  children,\n  ...props\n}: ProviderProps<LabelProps>) {\n  return (\n    <LabelContext.Provider value={props}>{children}</LabelContext.Provider>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAmBA,MAAa,eACX,cAA0D,KAAK;AAEjE,SAAgB,cAAc,EAC5B,UACA,GAAG,SACyB;AAC5B,QACE,oBAAC,aAAa;EAAS,OAAO;EAAQ;GAAiC"}
+{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/label/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 { LabelProps } from './types';\n\n/**\n * Context for sharing Label props across component tree.\n */\nexport const LabelContext =\n  createContext<ContextValue<LabelProps, HTMLLabelElement>>(null);\n\n/**\n * LabelProvider - Context provider for setting default Label props.\n *\n * Use this to configure shared isRequired and isDisabled states\n * across multiple Label components.\n *\n * @param props - ProviderProps<LabelProps>\n * @param props.children - Child components to receive context.\n * @returns The rendered LabelProvider component.\n *\n * @example\n * ```tsx\n * <LabelProvider isRequired>\n *   <Label>First Name</Label>\n *   <Label>Last Name</Label>\n * </LabelProvider>\n * ```\n */\nexport function LabelProvider({\n  children,\n  ...props\n}: ProviderProps<LabelProps>) {\n  return (\n    <LabelContext.Provider value={props}>{children}</LabelContext.Provider>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAsBA,MAAa,eACX,cAA0D,KAAK;;;;;;;;;;;;;;;;;;;AAoBjE,SAAgB,cAAc,EAC5B,UACA,GAAG,SACyB;AAC5B,QACE,oBAAC,aAAa;EAAS,OAAO;EAAQ;GAAiC"}

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

@@ -12,7 +12,7 @@
 
 import { LabelProps } from "./types.js";
 import "client-only";
-import * as react_jsx_runtime87 from "react/jsx-runtime";
+import * as react_jsx_runtime90 from "react/jsx-runtime";
 
 //#region src/components/label/index.d.ts
 
@@ -23,22 +23,36 @@ import * as react_jsx_runtime87 from "react/jsx-runtime";
  * required/optional states. Integrates with React Aria form components to
  * ensure proper accessibility and screen reader support.
  *
+ * @param props - {@link LabelProps}
+ * @param props.ref - Ref to the label element.
+ * @param props.children - Label text content.
+ * @param props.className - Optional CSS class name.
+ * @param props.isDisabled - Whether the label is in a disabled state.
+ * @param props.isRequired - Whether the associated field is required.
+ * @returns The rendered Label component.
+ *
  * @example
+ * ```tsx
  * // Basic label
  * <Label>Username</Label>
+ * ```
  *
  * @example
+ * ```tsx
  * // Required field label
  * <Label isRequired>Email Address</Label>
+ * ```
  *
  * @example
+ * ```tsx
  * // Disabled label
  * <Label isDisabled>Inactive Field</Label>
+ * ```
  */
 declare function Label({
   ref,
   ...props
-}: LabelProps): react_jsx_runtime87.JSX.Element;
+}: LabelProps): react_jsx_runtime90.JSX.Element;
 //#endregion
 export { Label };
 //# sourceMappingURL=index.d.ts.map

package/dist/components/label/index.js

@@ -28,17 +28,31 @@ import styles from "./styles.module.css";
 * required/optional states. Integrates with React Aria form components to
 * ensure proper accessibility and screen reader support.
 *
+* @param props - {@link LabelProps}
+* @param props.ref - Ref to the label element.
+* @param props.children - Label text content.
+* @param props.className - Optional CSS class name.
+* @param props.isDisabled - Whether the label is in a disabled state.
+* @param props.isRequired - Whether the associated field is required.
+* @returns The rendered Label component.
+*
 * @example
+* ```tsx
 * // Basic label
 * <Label>Username</Label>
+* ```
 *
 * @example
+* ```tsx
 * // Required field label
 * <Label isRequired>Email Address</Label>
+* ```
 *
 * @example
+* ```tsx
 * // Disabled label
 * <Label isDisabled>Inactive Field</Label>
+* ```
 */
 function Label({ ref, ...props }) {
 	[props, ref] = useContextProps(props, ref ?? null, LabelContext$1);

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["LabelContext","AriaLabel"],"sources":["../../../src/components/label/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 { Label as AriaLabel, useContextProps } from 'react-aria-components';\nimport { LabelContext } from './context';\nimport styles from './styles.module.css';\nimport type { LabelProps } from './types';\n\n/**\n * Label - A semantic label component for form elements and content\n *\n * Provides accessible labeling for form controls with automatic handling of\n * required/optional states. Integrates with React Aria form components to\n * ensure proper accessibility and screen reader support.\n *\n * @example\n * // Basic label\n * <Label>Username</Label>\n *\n * @example\n * // Required field label\n * <Label isRequired>Email Address</Label>\n *\n * @example\n * // Disabled label\n * <Label isDisabled>Inactive Field</Label>\n */\nexport function Label({ ref, ...props }: LabelProps) {\n  [props, ref] = useContextProps(props, ref ?? null, LabelContext);\n\n  const { children, className, isDisabled, isRequired, ...rest } = props;\n\n  return (\n    <AriaLabel\n      {...rest}\n      className={clsx('group/label', styles.label, className)}\n      data-disabled={isDisabled || null}\n      data-required={isRequired || null}\n    >\n      {children}\n      {!isRequired && ' (optional)'}\n    </AriaLabel>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuCA,SAAgB,MAAM,EAAE,KAAK,GAAG,SAAqB;AACnD,EAAC,OAAO,OAAO,gBAAgB,OAAO,OAAO,MAAMA,eAAa;CAEhE,MAAM,EAAE,UAAU,WAAW,YAAY,YAAY,GAAG,SAAS;AAEjE,QACE,qBAACC;EACC,GAAI;EACJ,WAAW,KAAK,eAAe,OAAO,OAAO,UAAU;EACvD,iBAAe,cAAc;EAC7B,iBAAe,cAAc;aAE5B,UACA,CAAC,cAAc;GACN"}
+{"version":3,"file":"index.js","names":["LabelContext","AriaLabel"],"sources":["../../../src/components/label/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 { Label as AriaLabel, useContextProps } from 'react-aria-components';\nimport { LabelContext } from './context';\nimport styles from './styles.module.css';\nimport type { LabelProps } from './types';\n\n/**\n * Label - A semantic label component for form elements and content\n *\n * Provides accessible labeling for form controls with automatic handling of\n * required/optional states. Integrates with React Aria form components to\n * ensure proper accessibility and screen reader support.\n *\n * @param props - {@link LabelProps}\n * @param props.ref - Ref to the label element.\n * @param props.children - Label text content.\n * @param props.className - Optional CSS class name.\n * @param props.isDisabled - Whether the label is in a disabled state.\n * @param props.isRequired - Whether the associated field is required.\n * @returns The rendered Label component.\n *\n * @example\n * ```tsx\n * // Basic label\n * <Label>Username</Label>\n * ```\n *\n * @example\n * ```tsx\n * // Required field label\n * <Label isRequired>Email Address</Label>\n * ```\n *\n * @example\n * ```tsx\n * // Disabled label\n * <Label isDisabled>Inactive Field</Label>\n * ```\n */\nexport function Label({ ref, ...props }: LabelProps) {\n  [props, ref] = useContextProps(props, ref ?? null, LabelContext);\n\n  const { children, className, isDisabled, isRequired, ...rest } = props;\n\n  return (\n    <AriaLabel\n      {...rest}\n      className={clsx('group/label', styles.label, className)}\n      data-disabled={isDisabled || null}\n      data-required={isRequired || null}\n    >\n      {children}\n      {!isRequired && ' (optional)'}\n    </AriaLabel>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqDA,SAAgB,MAAM,EAAE,KAAK,GAAG,SAAqB;AACnD,EAAC,OAAO,OAAO,gBAAgB,OAAO,OAAO,MAAMA,eAAa;CAEhE,MAAM,EAAE,UAAU,WAAW,YAAY,YAAY,GAAG,SAAS;AAEjE,QACE,qBAACC;EACC,GAAI;EACJ,WAAW,KAAK,eAAe,OAAO,OAAO,UAAU;EACvD,iBAAe,cAAc;EAC7B,iBAAe,cAAc;aAE5B,UACA,CAAC,cAAc;GACN"}

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

@@ -14,8 +14,13 @@ import { RefAttributes } from "react";
 import { LabelProps as LabelProps$1 } from "react-aria-components";
 
 //#region src/components/label/types.d.ts
+/**
+ * Props for the Label component.
+ */
 type LabelProps = LabelProps$1 & RefAttributes<HTMLLabelElement> & {
+  /** Whether the label is in a disabled state. */
   isDisabled?: boolean;
+  /** Whether the associated field is required. */
   isRequired?: boolean;
 };
 //#endregion

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

@@ -14,14 +14,24 @@ import { LinesProps } from "./types.js";
 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,

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_runtime88 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_runtime88.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_runtime94 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_runtime94.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 react28 from "react";
+import * as react0 from "react";
 import { ContextValue } from "react-aria-components";
 
 //#region src/components/list/context.d.ts
-declare const ListContext: react28.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_runtime97 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_runtime97 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_runtime97 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_runtime97.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);