@accelint/design-toolkit 9.2.0 → 9.4.0

package/dist/components/kanban/header-actions.d.ts

@@ -12,14 +12,22 @@
 
 import { KanbanComponentProps } from "./types.js";
 import "client-only";
-import * as react_jsx_runtime88 from "react/jsx-runtime";
+import * as react_jsx_runtime83 from "react/jsx-runtime";
 
 //#region src/components/kanban/header-actions.d.ts
+/**
+ * KanbanHeaderActions - Container for header action buttons
+ *
+ * @param props - {@link KanbanComponentProps}
+ * @param props.children - Action button elements.
+ * @param props.className - Optional CSS class name.
+ * @returns The rendered KanbanHeaderActions component.
+ */
 declare function KanbanHeaderActions({
   children,
   className,
   ...rest
-}: KanbanComponentProps): react_jsx_runtime88.JSX.Element;
+}: KanbanComponentProps): react_jsx_runtime83.JSX.Element;
 //#endregion
 export { KanbanHeaderActions };
 //# sourceMappingURL=header-actions.d.ts.map

package/dist/components/kanban/header-actions.js

@@ -19,6 +19,14 @@ import { jsx } from "react/jsx-runtime";
 import styles from "./styles.module.css";
 
 //#region src/components/kanban/header-actions.tsx
+/**
+* KanbanHeaderActions - Container for header action buttons
+*
+* @param props - {@link KanbanComponentProps}
+* @param props.children - Action button elements.
+* @param props.className - Optional CSS class name.
+* @returns The rendered KanbanHeaderActions component.
+*/
 function KanbanHeaderActions({ children, className, ...rest }) {
 	return /* @__PURE__ */ jsx("div", {
 		...rest,

package/dist/components/kanban/header-actions.js.map

@@ -1 +1 @@
-{"version":3,"file":"header-actions.js","names":[],"sources":["../../../src/components/kanban/header-actions.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';\nimport 'client-only';\n\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport styles from './styles.module.css';\nimport type { KanbanComponentProps } from './types';\n\nexport function KanbanHeaderActions({\n  children,\n  className,\n  ...rest\n}: KanbanComponentProps) {\n  return (\n    <div {...rest} className={clsx(styles.headerActions, className)}>\n      {children}\n    </div>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAkBA,SAAgB,oBAAoB,EAClC,UACA,WACA,GAAG,QACoB;AACvB,QACE,oBAAC;EAAI,GAAI;EAAM,WAAW,KAAK,OAAO,eAAe,UAAU;EAC5D;GACG"}
+{"version":3,"file":"header-actions.js","names":[],"sources":["../../../src/components/kanban/header-actions.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';\nimport 'client-only';\n\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport styles from './styles.module.css';\nimport type { KanbanComponentProps } from './types';\n\n/**\n * KanbanHeaderActions - Container for header action buttons\n *\n * @param props - {@link KanbanComponentProps}\n * @param props.children - Action button elements.\n * @param props.className - Optional CSS class name.\n * @returns The rendered KanbanHeaderActions component.\n */\nexport function KanbanHeaderActions({\n  children,\n  className,\n  ...rest\n}: KanbanComponentProps) {\n  return (\n    <div {...rest} className={clsx(styles.headerActions, className)}>\n      {children}\n    </div>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0BA,SAAgB,oBAAoB,EAClC,UACA,WACA,GAAG,QACoB;AACvB,QACE,oBAAC;EAAI,GAAI;EAAM,WAAW,KAAK,OAAO,eAAe,UAAU;EAC5D;GACG"}

package/dist/components/kanban/header-search.d.ts

@@ -12,13 +12,20 @@
 
 import { KanbanSearchProps } from "./types.js";
 import "client-only";
-import * as react_jsx_runtime89 from "react/jsx-runtime";
+import * as react_jsx_runtime84 from "react/jsx-runtime";
 
 //#region src/components/kanban/header-search.d.ts
+/**
+ * KanbanHeaderSearch - Search field for filtering cards
+ *
+ * @param props - {@link KanbanSearchProps}
+ * @param props.classNames - CSS class names for the search field.
+ * @returns The rendered KanbanHeaderSearch component.
+ */
 declare function KanbanHeaderSearch({
   classNames,
   ...rest
-}: KanbanSearchProps): react_jsx_runtime89.JSX.Element;
+}: KanbanSearchProps): react_jsx_runtime84.JSX.Element;
 //#endregion
 export { KanbanHeaderSearch };
 //# sourceMappingURL=header-search.d.ts.map

package/dist/components/kanban/header-search.js

@@ -18,6 +18,13 @@ import "client-only";
 import { jsx } from "react/jsx-runtime";
 
 //#region src/components/kanban/header-search.tsx
+/**
+* KanbanHeaderSearch - Search field for filtering cards
+*
+* @param props - {@link KanbanSearchProps}
+* @param props.classNames - CSS class names for the search field.
+* @returns The rendered KanbanHeaderSearch component.
+*/
 function KanbanHeaderSearch({ classNames, ...rest }) {
 	return /* @__PURE__ */ jsx(SearchField, {
 		...rest,

package/dist/components/kanban/header-search.js.map

@@ -1 +1 @@
-{"version":3,"file":"header-search.js","names":[],"sources":["../../../src/components/kanban/header-search.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';\nimport 'client-only';\n\nimport { SearchField } from '../search-field';\nimport type { KanbanSearchProps } from './types';\n\nexport function KanbanHeaderSearch({ classNames, ...rest }: KanbanSearchProps) {\n  return (\n    <SearchField\n      {...rest}\n      variant='outline'\n      classNames={classNames}\n      aria-label='Search'\n    />\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAiBA,SAAgB,mBAAmB,EAAE,YAAY,GAAG,QAA2B;AAC7E,QACE,oBAAC;EACC,GAAI;EACJ,SAAQ;EACI;EACZ,cAAW;GACX"}
+{"version":3,"file":"header-search.js","names":[],"sources":["../../../src/components/kanban/header-search.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';\nimport 'client-only';\n\nimport { SearchField } from '../search-field';\nimport type { KanbanSearchProps } from './types';\n\n/**\n * KanbanHeaderSearch - Search field for filtering cards\n *\n * @param props - {@link KanbanSearchProps}\n * @param props.classNames - CSS class names for the search field.\n * @returns The rendered KanbanHeaderSearch component.\n */\nexport function KanbanHeaderSearch({ classNames, ...rest }: KanbanSearchProps) {\n  return (\n    <SearchField\n      {...rest}\n      variant='outline'\n      classNames={classNames}\n      aria-label='Search'\n    />\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AAwBA,SAAgB,mBAAmB,EAAE,YAAY,GAAG,QAA2B;AAC7E,QACE,oBAAC;EACC,GAAI;EACJ,SAAQ;EACI;EACZ,cAAW;GACX"}

package/dist/components/kanban/header-title.d.ts

@@ -12,14 +12,22 @@
 
 import { KanbanComponentProps } from "./types.js";
 import "client-only";
-import * as react_jsx_runtime90 from "react/jsx-runtime";
+import * as react_jsx_runtime85 from "react/jsx-runtime";
 
 //#region src/components/kanban/header-title.d.ts
+/**
+ * KanbanHeaderTitle - Heading element for the board title
+ *
+ * @param props - {@link KanbanComponentProps}
+ * @param props.children - Title text content.
+ * @param props.className - Optional CSS class name.
+ * @returns The rendered KanbanHeaderTitle component.
+ */
 declare function KanbanHeaderTitle({
   children,
   className,
   ...rest
-}: KanbanComponentProps): react_jsx_runtime90.JSX.Element;
+}: KanbanComponentProps): react_jsx_runtime85.JSX.Element;
 //#endregion
 export { KanbanHeaderTitle };
 //# sourceMappingURL=header-title.d.ts.map

package/dist/components/kanban/header-title.js

@@ -20,6 +20,14 @@ import { jsx } from "react/jsx-runtime";
 import styles from "./styles.module.css";
 
 //#region src/components/kanban/header-title.tsx
+/**
+* KanbanHeaderTitle - Heading element for the board title
+*
+* @param props - {@link KanbanComponentProps}
+* @param props.children - Title text content.
+* @param props.className - Optional CSS class name.
+* @returns The rendered KanbanHeaderTitle component.
+*/
 function KanbanHeaderTitle({ children, className, ...rest }) {
 	return /* @__PURE__ */ jsx(Heading, {
 		...rest,

package/dist/components/kanban/header-title.js.map

@@ -1 +1 @@
-{"version":3,"file":"header-title.js","names":[],"sources":["../../../src/components/kanban/header-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';\nimport 'client-only';\n\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport { Heading } from 'react-aria-components';\nimport styles from './styles.module.css';\nimport type { KanbanComponentProps } from './types';\n\nexport function KanbanHeaderTitle({\n  children,\n  className,\n  ...rest\n}: KanbanComponentProps) {\n  return (\n    <Heading {...rest} className={clsx(styles.headerTitle, className)}>\n      {children}\n    </Heading>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAmBA,SAAgB,kBAAkB,EAChC,UACA,WACA,GAAG,QACoB;AACvB,QACE,oBAAC;EAAQ,GAAI;EAAM,WAAW,KAAK,OAAO,aAAa,UAAU;EAC9D;GACO"}
+{"version":3,"file":"header-title.js","names":[],"sources":["../../../src/components/kanban/header-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';\nimport 'client-only';\n\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport { Heading } from 'react-aria-components';\nimport styles from './styles.module.css';\nimport type { KanbanComponentProps } from './types';\n\n/**\n * KanbanHeaderTitle - Heading element for the board title\n *\n * @param props - {@link KanbanComponentProps}\n * @param props.children - Title text content.\n * @param props.className - Optional CSS class name.\n * @returns The rendered KanbanHeaderTitle component.\n */\nexport function KanbanHeaderTitle({\n  children,\n  className,\n  ...rest\n}: KanbanComponentProps) {\n  return (\n    <Heading {...rest} className={clsx(styles.headerTitle, className)}>\n      {children}\n    </Heading>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA2BA,SAAgB,kBAAkB,EAChC,UACA,WACA,GAAG,QACoB;AACvB,QACE,oBAAC;EAAQ,GAAI;EAAM,WAAW,KAAK,OAAO,aAAa,UAAU;EAC9D;GACO"}

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

@@ -12,14 +12,24 @@
 
 import { KanbanComponentProps } from "./types.js";
 import "client-only";
-import * as react_jsx_runtime92 from "react/jsx-runtime";
+import * as react_jsx_runtime87 from "react/jsx-runtime";
 
 //#region src/components/kanban/header.d.ts
+/**
+ * KanbanHeader - Header section for the kanban board
+ *
+ * Contains title, search, and action buttons.
+ *
+ * @param props - {@link KanbanComponentProps}
+ * @param props.children - Header content (title, search, actions).
+ * @param props.className - Optional CSS class name.
+ * @returns The rendered KanbanHeader component.
+ */
 declare function KanbanHeader({
   children,
   className,
   ...rest
-}: KanbanComponentProps): react_jsx_runtime92.JSX.Element;
+}: KanbanComponentProps): react_jsx_runtime87.JSX.Element;
 //#endregion
 export { KanbanHeader };
 //# sourceMappingURL=header.d.ts.map

package/dist/components/kanban/header.js

@@ -19,6 +19,16 @@ import { jsx } from "react/jsx-runtime";
 import styles from "./styles.module.css";
 
 //#region src/components/kanban/header.tsx
+/**
+* KanbanHeader - Header section for the kanban board
+*
+* Contains title, search, and action buttons.
+*
+* @param props - {@link KanbanComponentProps}
+* @param props.children - Header content (title, search, actions).
+* @param props.className - Optional CSS class name.
+* @returns The rendered KanbanHeader component.
+*/
 function KanbanHeader({ children, className, ...rest }) {
 	return /* @__PURE__ */ jsx("div", {
 		...rest,

package/dist/components/kanban/header.js.map

@@ -1 +1 @@
-{"version":3,"file":"header.js","names":[],"sources":["../../../src/components/kanban/header.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';\nimport 'client-only';\n\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport styles from './styles.module.css';\nimport type { KanbanComponentProps } from './types';\n\nexport function KanbanHeader({\n  children,\n  className,\n  ...rest\n}: KanbanComponentProps) {\n  return (\n    <div {...rest} className={clsx(styles.header, className)}>\n      {children}\n    </div>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAkBA,SAAgB,aAAa,EAC3B,UACA,WACA,GAAG,QACoB;AACvB,QACE,oBAAC;EAAI,GAAI;EAAM,WAAW,KAAK,OAAO,QAAQ,UAAU;EACrD;GACG"}
+{"version":3,"file":"header.js","names":[],"sources":["../../../src/components/kanban/header.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';\nimport 'client-only';\n\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport styles from './styles.module.css';\nimport type { KanbanComponentProps } from './types';\n\n/**\n * KanbanHeader - Header section for the kanban board\n *\n * Contains title, search, and action buttons.\n *\n * @param props - {@link KanbanComponentProps}\n * @param props.children - Header content (title, search, actions).\n * @param props.className - Optional CSS class name.\n * @returns The rendered KanbanHeader component.\n */\nexport function KanbanHeader({\n  children,\n  className,\n  ...rest\n}: KanbanComponentProps) {\n  return (\n    <div {...rest} className={clsx(styles.header, className)}>\n      {children}\n    </div>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4BA,SAAgB,aAAa,EAC3B,UACA,WACA,GAAG,QACoB;AACvB,QACE,oBAAC;EAAI,GAAI;EAAM,WAAW,KAAK,OAAO,QAAQ,UAAU;EACrD;GACG"}

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

@@ -12,21 +12,50 @@
 
 import { KanbanProps } from "./types.js";
 import "client-only";
-import * as react23 from "react";
-import * as react_jsx_runtime93 from "react/jsx-runtime";
+import * as react25 from "react";
+import * as react_jsx_runtime88 from "react/jsx-runtime";
 
 //#region src/components/kanban/kanban.d.ts
-declare const DragContext: react23.Context<{
+/**
+ * Context for sharing active drag state across Kanban components.
+ */
+declare const DragContext: react25.Context<{
   activeId: string | null;
 } | null>;
+/**
+ * Hook to access the active drag state.
+ * Must be used within a Kanban component.
+ * @returns The drag context with activeId.
+ */
 declare const useDragContext: () => {
   activeId: string | null;
 };
+/**
+ * Kanban - Root container for the drag-and-drop kanban board
+ *
+ * Provides DnD context and manages drag state for cards and columns.
+ * Must be wrapped in a KanbanProvider.
+ *
+ * @param props - {@link KanbanProps}
+ * @param props.children - Child components (columns, header, etc.).
+ * @param props.className - Optional CSS class name.
+ * @returns The rendered Kanban component.
+ *
+ * @example
+ * ```tsx
+ * <KanbanProvider columns={columns} updateColumnState={setColumns}>
+ *   <Kanban>
+ *     <KanbanHeader>...</KanbanHeader>
+ *     <KanbanColumnContainer>...</KanbanColumnContainer>
+ *   </Kanban>
+ * </KanbanProvider>
+ * ```
+ */
 declare function Kanban({
   children,
   className,
   ...rest
-}: KanbanProps): react_jsx_runtime93.JSX.Element;
+}: KanbanProps): react_jsx_runtime88.JSX.Element;
 //#endregion
 export { DragContext, Kanban, useDragContext };
 //# sourceMappingURL=kanban.d.ts.map

package/dist/components/kanban/kanban.js

@@ -22,13 +22,42 @@ import styles from "./styles.module.css";
 import { DndContext, DragOverlay, PointerSensor, closestCenter, pointerWithin, rectIntersection, useSensor, useSensors } from "@dnd-kit/core";
 
 //#region src/components/kanban/kanban.tsx
+/**
+* Context for sharing active drag state across Kanban components.
+*/
 const DragContext = createContext(null);
+/**
+* Hook to access the active drag state.
+* Must be used within a Kanban component.
+* @returns The drag context with activeId.
+*/
 const useDragContext = () => {
 	const context = useContext(DragContext);
 	if (!context) throw new Error("useDragContext must be used within Kanban component");
 	return context;
 };
 const ACTIVATION_DISTANCE = 8;
+/**
+* Kanban - Root container for the drag-and-drop kanban board
+*
+* Provides DnD context and manages drag state for cards and columns.
+* Must be wrapped in a KanbanProvider.
+*
+* @param props - {@link KanbanProps}
+* @param props.children - Child components (columns, header, etc.).
+* @param props.className - Optional CSS class name.
+* @returns The rendered Kanban component.
+*
+* @example
+* ```tsx
+* <KanbanProvider columns={columns} updateColumnState={setColumns}>
+*   <Kanban>
+*     <KanbanHeader>...</KanbanHeader>
+*     <KanbanColumnContainer>...</KanbanColumnContainer>
+*   </Kanban>
+* </KanbanProvider>
+* ```
+*/
 function Kanban({ children, className, ...rest }) {
 	const { moveCard, cardMap } = useKanban();
 	const [activeId, setActiveId] = useState(null);

package/dist/components/kanban/kanban.js.map

@@ -1 +1 @@
-{"version":3,"file":"kanban.js","names":["collisionDetectionStrategy: CollisionDetection"],"sources":["../../../src/components/kanban/kanban.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';\nimport 'client-only';\n\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport {\n  type CollisionDetection,\n  closestCenter,\n  DndContext,\n  type DragEndEvent,\n  DragOverlay,\n  type DragStartEvent,\n  PointerSensor,\n  pointerWithin,\n  rectIntersection,\n  useSensor,\n  useSensors,\n} from '@dnd-kit/core';\nimport { createContext, useContext, useState } from 'react';\nimport { parseDropTarget, useKanban } from '@/components/kanban/context';\nimport styles from './styles.module.css';\nimport type { KanbanProps } from './types';\n\n// Context for sharing active drag state\n\nexport const DragContext = createContext<{ activeId: string | null } | null>(\n  null,\n);\n\nexport const useDragContext = () => {\n  const context = useContext(DragContext);\n  if (!context) {\n    throw new Error('useDragContext must be used within Kanban component');\n  }\n  return context;\n};\n\nconst ACTIVATION_DISTANCE = 8;\n\nexport function Kanban({ children, className, ...rest }: KanbanProps) {\n  const { moveCard, cardMap } = useKanban();\n  const [activeId, setActiveId] = useState<string | null>(null);\n\n  const sensors = useSensors(\n    useSensor(PointerSensor, {\n      activationConstraint: {\n        distance: ACTIVATION_DISTANCE,\n      },\n    }),\n  );\n\n  const collisionDetectionStrategy: CollisionDetection = (args) => {\n    // First, try pointer within for direct pointer detection\n    const pointerCollisions = pointerWithin(args);\n    if (pointerCollisions.length > 0) {\n      return pointerCollisions;\n    }\n\n    // Then try rectangle intersection for better coverage\n    const rectCollisions = rectIntersection(args);\n    if (rectCollisions.length > 0) {\n      return rectCollisions;\n    }\n\n    // Fall back to closest center\n    return closestCenter(args);\n  };\n\n  const handleDragStart = (event: DragStartEvent) => {\n    setActiveId(event.active.id as string);\n  };\n\n  const handleDragEnd = (event: DragEndEvent) => {\n    setActiveId(null);\n\n    const dropTarget = parseDropTarget(event);\n    if (!dropTarget) {\n      return;\n    }\n\n    moveCard(\n      event.active.id as string,\n      dropTarget.columnId,\n      dropTarget.position,\n      dropTarget.edge,\n    );\n  };\n\n  // Find the active card for the drag overlay\n  const activeCard = activeId ? cardMap.get(activeId)?.card : null;\n\n  return (\n    <DragContext.Provider value={{ activeId }}>\n      <DndContext\n        sensors={sensors}\n        collisionDetection={collisionDetectionStrategy}\n        onDragStart={handleDragStart}\n        onDragEnd={handleDragEnd}\n      >\n        <div className={clsx(styles.kanban, className)} {...rest}>\n          {children}\n        </div>\n        <DragOverlay>\n          {activeCard ? (\n            <div data-current className={clsx(styles.card)}>\n              <div className={styles.cardHeader}>\n                <span className={styles.cardTitle}>{activeCard.title}</span>\n              </div>\n              <div className={styles.cardBody}>{activeCard.body}</div>\n            </div>\n          ) : null}\n        </DragOverlay>\n      </DndContext>\n    </DragContext.Provider>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAmCA,MAAa,cAAc,cACzB,KACD;AAED,MAAa,uBAAuB;CAClC,MAAM,UAAU,WAAW,YAAY;AACvC,KAAI,CAAC,QACH,OAAM,IAAI,MAAM,sDAAsD;AAExE,QAAO;;AAGT,MAAM,sBAAsB;AAE5B,SAAgB,OAAO,EAAE,UAAU,WAAW,GAAG,QAAqB;CACpE,MAAM,EAAE,UAAU,YAAY,WAAW;CACzC,MAAM,CAAC,UAAU,eAAe,SAAwB,KAAK;CAE7D,MAAM,UAAU,WACd,UAAU,eAAe,EACvB,sBAAsB,EACpB,UAAU,qBACX,EACF,CAAC,CACH;CAED,MAAMA,8BAAkD,SAAS;EAE/D,MAAM,oBAAoB,cAAc,KAAK;AAC7C,MAAI,kBAAkB,SAAS,EAC7B,QAAO;EAIT,MAAM,iBAAiB,iBAAiB,KAAK;AAC7C,MAAI,eAAe,SAAS,EAC1B,QAAO;AAIT,SAAO,cAAc,KAAK;;CAG5B,MAAM,mBAAmB,UAA0B;AACjD,cAAY,MAAM,OAAO,GAAa;;CAGxC,MAAM,iBAAiB,UAAwB;AAC7C,cAAY,KAAK;EAEjB,MAAM,aAAa,gBAAgB,MAAM;AACzC,MAAI,CAAC,WACH;AAGF,WACE,MAAM,OAAO,IACb,WAAW,UACX,WAAW,UACX,WAAW,KACZ;;CAIH,MAAM,aAAa,WAAW,QAAQ,IAAI,SAAS,EAAE,OAAO;AAE5D,QACE,oBAAC,YAAY;EAAS,OAAO,EAAE,UAAU;YACvC,qBAAC;GACU;GACT,oBAAoB;GACpB,aAAa;GACb,WAAW;cAEX,oBAAC;IAAI,WAAW,KAAK,OAAO,QAAQ,UAAU;IAAE,GAAI;IACjD;KACG,EACN,oBAAC,yBACE,aACC,qBAAC;IAAI;IAAa,WAAW,KAAK,OAAO,KAAK;eAC5C,oBAAC;KAAI,WAAW,OAAO;eACrB,oBAAC;MAAK,WAAW,OAAO;gBAAY,WAAW;OAAa;MACxD,EACN,oBAAC;KAAI,WAAW,OAAO;eAAW,WAAW;MAAW;KACpD,GACJ,OACQ;IACH;GACQ"}
+{"version":3,"file":"kanban.js","names":["collisionDetectionStrategy: CollisionDetection"],"sources":["../../../src/components/kanban/kanban.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';\nimport 'client-only';\n\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport {\n  type CollisionDetection,\n  closestCenter,\n  DndContext,\n  type DragEndEvent,\n  DragOverlay,\n  type DragStartEvent,\n  PointerSensor,\n  pointerWithin,\n  rectIntersection,\n  useSensor,\n  useSensors,\n} from '@dnd-kit/core';\nimport { createContext, useContext, useState } from 'react';\nimport { parseDropTarget, useKanban } from '@/components/kanban/context';\nimport styles from './styles.module.css';\nimport type { KanbanProps } from './types';\n\n/**\n * Context for sharing active drag state across Kanban components.\n */\nexport const DragContext = createContext<{ activeId: string | null } | null>(\n  null,\n);\n\n/**\n * Hook to access the active drag state.\n * Must be used within a Kanban component.\n * @returns The drag context with activeId.\n */\nexport const useDragContext = () => {\n  const context = useContext(DragContext);\n  if (!context) {\n    throw new Error('useDragContext must be used within Kanban component');\n  }\n  return context;\n};\n\nconst ACTIVATION_DISTANCE = 8;\n\n/**\n * Kanban - Root container for the drag-and-drop kanban board\n *\n * Provides DnD context and manages drag state for cards and columns.\n * Must be wrapped in a KanbanProvider.\n *\n * @param props - {@link KanbanProps}\n * @param props.children - Child components (columns, header, etc.).\n * @param props.className - Optional CSS class name.\n * @returns The rendered Kanban component.\n *\n * @example\n * ```tsx\n * <KanbanProvider columns={columns} updateColumnState={setColumns}>\n *   <Kanban>\n *     <KanbanHeader>...</KanbanHeader>\n *     <KanbanColumnContainer>...</KanbanColumnContainer>\n *   </Kanban>\n * </KanbanProvider>\n * ```\n */\nexport function Kanban({ children, className, ...rest }: KanbanProps) {\n  const { moveCard, cardMap } = useKanban();\n  const [activeId, setActiveId] = useState<string | null>(null);\n\n  const sensors = useSensors(\n    useSensor(PointerSensor, {\n      activationConstraint: {\n        distance: ACTIVATION_DISTANCE,\n      },\n    }),\n  );\n\n  const collisionDetectionStrategy: CollisionDetection = (args) => {\n    // First, try pointer within for direct pointer detection\n    const pointerCollisions = pointerWithin(args);\n    if (pointerCollisions.length > 0) {\n      return pointerCollisions;\n    }\n\n    // Then try rectangle intersection for better coverage\n    const rectCollisions = rectIntersection(args);\n    if (rectCollisions.length > 0) {\n      return rectCollisions;\n    }\n\n    // Fall back to closest center\n    return closestCenter(args);\n  };\n\n  const handleDragStart = (event: DragStartEvent) => {\n    setActiveId(event.active.id as string);\n  };\n\n  const handleDragEnd = (event: DragEndEvent) => {\n    setActiveId(null);\n\n    const dropTarget = parseDropTarget(event);\n    if (!dropTarget) {\n      return;\n    }\n\n    moveCard(\n      event.active.id as string,\n      dropTarget.columnId,\n      dropTarget.position,\n      dropTarget.edge,\n    );\n  };\n\n  // Find the active card for the drag overlay\n  const activeCard = activeId ? cardMap.get(activeId)?.card : null;\n\n  return (\n    <DragContext.Provider value={{ activeId }}>\n      <DndContext\n        sensors={sensors}\n        collisionDetection={collisionDetectionStrategy}\n        onDragStart={handleDragStart}\n        onDragEnd={handleDragEnd}\n      >\n        <div className={clsx(styles.kanban, className)} {...rest}>\n          {children}\n        </div>\n        <DragOverlay>\n          {activeCard ? (\n            <div data-current className={clsx(styles.card)}>\n              <div className={styles.cardHeader}>\n                <span className={styles.cardTitle}>{activeCard.title}</span>\n              </div>\n              <div className={styles.cardBody}>{activeCard.body}</div>\n            </div>\n          ) : null}\n        </DragOverlay>\n      </DndContext>\n    </DragContext.Provider>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AAoCA,MAAa,cAAc,cACzB,KACD;;;;;;AAOD,MAAa,uBAAuB;CAClC,MAAM,UAAU,WAAW,YAAY;AACvC,KAAI,CAAC,QACH,OAAM,IAAI,MAAM,sDAAsD;AAExE,QAAO;;AAGT,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;AAuB5B,SAAgB,OAAO,EAAE,UAAU,WAAW,GAAG,QAAqB;CACpE,MAAM,EAAE,UAAU,YAAY,WAAW;CACzC,MAAM,CAAC,UAAU,eAAe,SAAwB,KAAK;CAE7D,MAAM,UAAU,WACd,UAAU,eAAe,EACvB,sBAAsB,EACpB,UAAU,qBACX,EACF,CAAC,CACH;CAED,MAAMA,8BAAkD,SAAS;EAE/D,MAAM,oBAAoB,cAAc,KAAK;AAC7C,MAAI,kBAAkB,SAAS,EAC7B,QAAO;EAIT,MAAM,iBAAiB,iBAAiB,KAAK;AAC7C,MAAI,eAAe,SAAS,EAC1B,QAAO;AAIT,SAAO,cAAc,KAAK;;CAG5B,MAAM,mBAAmB,UAA0B;AACjD,cAAY,MAAM,OAAO,GAAa;;CAGxC,MAAM,iBAAiB,UAAwB;AAC7C,cAAY,KAAK;EAEjB,MAAM,aAAa,gBAAgB,MAAM;AACzC,MAAI,CAAC,WACH;AAGF,WACE,MAAM,OAAO,IACb,WAAW,UACX,WAAW,UACX,WAAW,KACZ;;CAIH,MAAM,aAAa,WAAW,QAAQ,IAAI,SAAS,EAAE,OAAO;AAE5D,QACE,oBAAC,YAAY;EAAS,OAAO,EAAE,UAAU;YACvC,qBAAC;GACU;GACT,oBAAoB;GACpB,aAAa;GACb,WAAW;cAEX,oBAAC;IAAI,WAAW,KAAK,OAAO,QAAQ,UAAU;IAAE,GAAI;IACjD;KACG,EACN,oBAAC,yBACE,aACC,qBAAC;IAAI;IAAa,WAAW,KAAK,OAAO,KAAK;eAC5C,oBAAC;KAAI,WAAW,OAAO;eACrB,oBAAC;MAAK,WAAW,OAAO;gBAAY,WAAW;OAAa;MACxD,EACN,oBAAC;KAAI,WAAW,OAAO;eAAW,WAAW;MAAW;KACpD,GACJ,OACQ;IACH;GACQ"}

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 react25 from "react";
+import * as react26 from "react";
 import { ContextValue } from "react-aria-components";
-import * as react_jsx_runtime106 from "react/jsx-runtime";
+import * as react_jsx_runtime89 from "react/jsx-runtime";
 
 //#region src/components/label/context.d.ts
-declare const LabelContext: react25.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_runtime106.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_runtime107 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_runtime107 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_runtime107.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