@accelint/design-toolkit 9.2.0 → 9.4.0

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

@@ -11,17 +11,31 @@
  */
 
 import { TreeItemContentProps } from "./types.js";
-import * as react_jsx_runtime150 from "react/jsx-runtime";
+import * as react_jsx_runtime173 from "react/jsx-runtime";
 
 //#region src/components/tree/item-content.d.ts
+
 /**
- * ItemContent - Content of a tree item
+ * TreeItemContent - Renders the display content of a tree node
+ *
+ * @example
+ * ```tsx
+ * <TreeItem id="node" textValue="Node">
+ *   <TreeItemContent>
+ *     <TreeItemPrefixIcon><Folder /></TreeItemPrefixIcon>
+ *     <TreeItemLabel>Folder Name</TreeItemLabel>
+ *     <TreeItemDescription>Contains 5 items</TreeItemDescription>
+ *   </TreeItemContent>
+ * </TreeItem>
+ * ```
  *
- * Renders the content of a tree item with proper styling
+ * @param props - {@link TreeItemContentProps}
+ * @param props.children - Content to render, or a render function receiving TreeItemContentRenderProps.
+ * @returns The rendered TreeItemContent component.
  */
 declare function TreeItemContent({
   children
-}: TreeItemContentProps): react_jsx_runtime150.JSX.Element;
+}: TreeItemContentProps): react_jsx_runtime173.JSX.Element;
 //#endregion
 export { TreeItemContent };
 //# sourceMappingURL=item-content.d.ts.map

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

@@ -21,14 +21,31 @@ import { useContext } from "react";
 import { clsx } from "@accelint/design-foundation/lib/utils";
 import { TreeItemContent as TreeItemContent$1 } from "react-aria-components";
 import { jsx, jsxs } from "react/jsx-runtime";
-import { ChevronDown, ChevronUp, DragVert, Hide, Show } from "@accelint/icons";
+import ChevronDown from "@accelint/icons/chevron-down";
+import DragVert from "@accelint/icons/drag-vert";
 import styles from "./styles.module.css";
+import ChevronUp from "@accelint/icons/chevron-up";
+import Hide from "@accelint/icons/hide";
+import Show from "@accelint/icons/show";
 
 //#region src/components/tree/item-content.tsx
 /**
-* ItemContent - Content of a tree item
+* TreeItemContent - Renders the display content of a tree node
 *
-* Renders the content of a tree item with proper styling
+* @example
+* ```tsx
+* <TreeItem id="node" textValue="Node">
+*   <TreeItemContent>
+*     <TreeItemPrefixIcon><Folder /></TreeItemPrefixIcon>
+*     <TreeItemLabel>Folder Name</TreeItemLabel>
+*     <TreeItemDescription>Contains 5 items</TreeItemDescription>
+*   </TreeItemContent>
+* </TreeItem>
+* ```
+*
+* @param props - {@link TreeItemContentProps}
+* @param props.children - Content to render, or a render function receiving TreeItemContentRenderProps.
+* @returns The rendered TreeItemContent component.
 */
 function TreeItemContent({ children }) {
 	const { showVisibility, variant, visibleKeys, onVisibilityChange } = useContext(TreeContext);

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

@@ -1 +1 @@
-{"version":3,"file":"item-content.js","names":["AriaTreeItemContent","Button","Checkbox"],"sources":["../../../src/components/tree/item-content.tsx"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport { ChevronDown, ChevronUp, DragVert, Hide, Show } from '@accelint/icons';\nimport { useContext } from 'react';\nimport { TreeItemContent as AriaTreeItemContent } from 'react-aria-components';\nimport { Button } from '../button';\nimport { Checkbox } from '../checkbox';\nimport { Icon } from '../icon';\nimport { IconProvider } from '../icon/context';\nimport { TreeContext, TreeItemContext } from './context';\nimport { TreeLines } from './lines';\nimport styles from './styles.module.css';\nimport type { Key } from '@react-types/shared';\nimport type { TreeItemContentProps } from './types';\n\n/**\n * ItemContent - Content of a tree item\n *\n * Renders the content of a tree item with proper styling\n */\nexport function TreeItemContent({ children }: TreeItemContentProps) {\n  const { showVisibility, variant, visibleKeys, onVisibilityChange } =\n    useContext(TreeContext);\n  const { isVisible, isViewable } = useContext(TreeItemContext);\n  const size = variant === 'cozy' ? 'medium' : 'small';\n\n  return (\n    <AriaTreeItemContent>\n      {(renderProps) => {\n        const {\n          id,\n          allowsDragging,\n          hasChildItems,\n          level,\n          selectionBehavior,\n          selectionMode,\n          state,\n          isDisabled,\n          isExpanded,\n          isSelected,\n        } = renderProps;\n\n        const isLastOfSet = !(\n          state.collection.getItem(id)?.nextKey || hasChildItems\n        );\n        const shouldShowSelection =\n          selectionBehavior === 'toggle' && selectionMode !== 'none';\n\n        const handlePress = () => {\n          const keys = new Set<Key>(visibleKeys);\n          visibleKeys?.has(id) ? keys.delete(id) : keys.add(id);\n          onVisibilityChange?.(keys);\n        };\n\n        return (\n          <IconProvider size={size}>\n            <div\n              className={clsx('group', styles.content, styles[variant])}\n              data-last-of-set={isLastOfSet}\n            >\n              {showVisibility && (\n                <Button\n                  variant='icon'\n                  color='mono-bold'\n                  size={size}\n                  onPress={handlePress}\n                  isDisabled={isDisabled}\n                  className={styles.visibility}\n                >\n                  <Icon>{isVisible ? <Show /> : <Hide />}</Icon>\n                </Button>\n              )}\n              {level > 1 && (\n                <TreeLines level={level} isLastOfSet={isLastOfSet} />\n              )}\n              {hasChildItems ? (\n                <Button\n                  slot='chevron'\n                  variant='icon'\n                  size={size}\n                  className={styles.expansion}\n                >\n                  <Icon>{isExpanded ? <ChevronDown /> : <ChevronUp />}</Icon>\n                </Button>\n              ) : (\n                <div className={clsx(styles.spacing, styles[variant])} />\n              )}\n              <div className={clsx(styles.display, styles[variant])}>\n                {typeof children === 'function'\n                  ? children({\n                      ...renderProps,\n                      variant,\n                      isVisible,\n                      isViewable: isViewable,\n                      defaultChildren: null,\n                    })\n                  : children}\n              </div>\n              {shouldShowSelection && (\n                <Checkbox\n                  slot='selection'\n                  isSelected={isSelected}\n                  isDisabled={isDisabled}\n                />\n              )}\n              {allowsDragging && (\n                <Button\n                  slot='drag'\n                  variant='icon'\n                  size={size}\n                  isDisabled={isDisabled}\n                  className={styles.drag}\n                >\n                  <Icon>\n                    <DragVert />\n                  </Icon>\n                </Button>\n              )}\n            </div>\n          </IconProvider>\n        );\n      }}\n    </AriaTreeItemContent>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+BA,SAAgB,gBAAgB,EAAE,YAAkC;CAClE,MAAM,EAAE,gBAAgB,SAAS,aAAa,uBAC5C,WAAW,YAAY;CACzB,MAAM,EAAE,WAAW,eAAe,WAAW,gBAAgB;CAC7D,MAAM,OAAO,YAAY,SAAS,WAAW;AAE7C,QACE,oBAACA,gCACG,gBAAgB;EAChB,MAAM,EACJ,IACA,gBACA,eACA,OACA,mBACA,eACA,OACA,YACA,YACA,eACE;EAEJ,MAAM,cAAc,EAClB,MAAM,WAAW,QAAQ,GAAG,EAAE,WAAW;EAE3C,MAAM,sBACJ,sBAAsB,YAAY,kBAAkB;EAEtD,MAAM,oBAAoB;GACxB,MAAM,OAAO,IAAI,IAAS,YAAY;AACtC,gBAAa,IAAI,GAAG,GAAG,KAAK,OAAO,GAAG,GAAG,KAAK,IAAI,GAAG;AACrD,wBAAqB,KAAK;;AAG5B,SACE,oBAAC;GAAmB;aAClB,qBAAC;IACC,WAAW,KAAK,SAAS,OAAO,SAAS,OAAO,SAAS;IACzD,oBAAkB;;KAEjB,kBACC,oBAACC;MACC,SAAQ;MACR,OAAM;MACA;MACN,SAAS;MACG;MACZ,WAAW,OAAO;gBAElB,oBAAC,kBAAM,YAAY,oBAAC,SAAO,GAAG,oBAAC,SAAO,GAAQ;OACvC;KAEV,QAAQ,KACP,oBAAC;MAAiB;MAAoB;OAAe;KAEtD,gBACC,oBAACA;MACC,MAAK;MACL,SAAQ;MACF;MACN,WAAW,OAAO;gBAElB,oBAAC,kBAAM,aAAa,oBAAC,gBAAc,GAAG,oBAAC,cAAY,GAAQ;OACpD,GAET,oBAAC,SAAI,WAAW,KAAK,OAAO,SAAS,OAAO,SAAS,GAAI;KAE3D,oBAAC;MAAI,WAAW,KAAK,OAAO,SAAS,OAAO,SAAS;gBAClD,OAAO,aAAa,aACjB,SAAS;OACP,GAAG;OACH;OACA;OACY;OACZ,iBAAiB;OAClB,CAAC,GACF;OACA;KACL,uBACC,oBAACC;MACC,MAAK;MACO;MACA;OACZ;KAEH,kBACC,oBAACD;MACC,MAAK;MACL,SAAQ;MACF;MACM;MACZ,WAAW,OAAO;gBAElB,oBAAC,kBACC,oBAAC,aAAW,GACP;OACA;;KAEP;IACO;KAGC"}
+{"version":3,"file":"item-content.js","names":["AriaTreeItemContent","Button","Checkbox"],"sources":["../../../src/components/tree/item-content.tsx"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport ChevronDown from '@accelint/icons/chevron-down';\nimport ChevronUp from '@accelint/icons/chevron-up';\nimport DragVert from '@accelint/icons/drag-vert';\nimport Hide from '@accelint/icons/hide';\nimport Show from '@accelint/icons/show';\nimport { useContext } from 'react';\nimport { TreeItemContent as AriaTreeItemContent } from 'react-aria-components';\nimport { Button } from '../button';\nimport { Checkbox } from '../checkbox';\nimport { Icon } from '../icon';\nimport { IconProvider } from '../icon/context';\nimport { TreeContext, TreeItemContext } from './context';\nimport { TreeLines } from './lines';\nimport styles from './styles.module.css';\nimport type { Key } from '@react-types/shared';\nimport type { TreeItemContentProps } from './types';\n\n/**\n * TreeItemContent - Renders the display content of a tree node\n *\n * @example\n * ```tsx\n * <TreeItem id=\"node\" textValue=\"Node\">\n *   <TreeItemContent>\n *     <TreeItemPrefixIcon><Folder /></TreeItemPrefixIcon>\n *     <TreeItemLabel>Folder Name</TreeItemLabel>\n *     <TreeItemDescription>Contains 5 items</TreeItemDescription>\n *   </TreeItemContent>\n * </TreeItem>\n * ```\n *\n * @param props - {@link TreeItemContentProps}\n * @param props.children - Content to render, or a render function receiving TreeItemContentRenderProps.\n * @returns The rendered TreeItemContent component.\n */\nexport function TreeItemContent({ children }: TreeItemContentProps) {\n  const { showVisibility, variant, visibleKeys, onVisibilityChange } =\n    useContext(TreeContext);\n  const { isVisible, isViewable } = useContext(TreeItemContext);\n  const size = variant === 'cozy' ? 'medium' : 'small';\n\n  return (\n    <AriaTreeItemContent>\n      {(renderProps) => {\n        const {\n          id,\n          allowsDragging,\n          hasChildItems,\n          level,\n          selectionBehavior,\n          selectionMode,\n          state,\n          isDisabled,\n          isExpanded,\n          isSelected,\n        } = renderProps;\n\n        const isLastOfSet = !(\n          state.collection.getItem(id)?.nextKey || hasChildItems\n        );\n        const shouldShowSelection =\n          selectionBehavior === 'toggle' && selectionMode !== 'none';\n\n        const handlePress = () => {\n          const keys = new Set<Key>(visibleKeys);\n          visibleKeys?.has(id) ? keys.delete(id) : keys.add(id);\n          onVisibilityChange?.(keys);\n        };\n\n        return (\n          <IconProvider size={size}>\n            <div\n              className={clsx('group', styles.content, styles[variant])}\n              data-last-of-set={isLastOfSet}\n            >\n              {showVisibility && (\n                <Button\n                  variant='icon'\n                  color='mono-bold'\n                  size={size}\n                  onPress={handlePress}\n                  isDisabled={isDisabled}\n                  className={styles.visibility}\n                >\n                  <Icon>{isVisible ? <Show /> : <Hide />}</Icon>\n                </Button>\n              )}\n              {level > 1 && (\n                <TreeLines level={level} isLastOfSet={isLastOfSet} />\n              )}\n              {hasChildItems ? (\n                <Button\n                  slot='chevron'\n                  variant='icon'\n                  size={size}\n                  className={styles.expansion}\n                >\n                  <Icon>{isExpanded ? <ChevronDown /> : <ChevronUp />}</Icon>\n                </Button>\n              ) : (\n                <div className={clsx(styles.spacing, styles[variant])} />\n              )}\n              <div className={clsx(styles.display, styles[variant])}>\n                {typeof children === 'function'\n                  ? children({\n                      ...renderProps,\n                      variant,\n                      isVisible,\n                      isViewable: isViewable,\n                      defaultChildren: null,\n                    })\n                  : children}\n              </div>\n              {shouldShowSelection && (\n                <Checkbox\n                  slot='selection'\n                  isSelected={isSelected}\n                  isDisabled={isDisabled}\n                />\n              )}\n              {allowsDragging && (\n                <Button\n                  slot='drag'\n                  variant='icon'\n                  size={size}\n                  isDisabled={isDisabled}\n                  className={styles.drag}\n                >\n                  <Icon>\n                    <DragVert />\n                  </Icon>\n                </Button>\n              )}\n            </div>\n          </IconProvider>\n        );\n      }}\n    </AriaTreeItemContent>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgDA,SAAgB,gBAAgB,EAAE,YAAkC;CAClE,MAAM,EAAE,gBAAgB,SAAS,aAAa,uBAC5C,WAAW,YAAY;CACzB,MAAM,EAAE,WAAW,eAAe,WAAW,gBAAgB;CAC7D,MAAM,OAAO,YAAY,SAAS,WAAW;AAE7C,QACE,oBAACA,gCACG,gBAAgB;EAChB,MAAM,EACJ,IACA,gBACA,eACA,OACA,mBACA,eACA,OACA,YACA,YACA,eACE;EAEJ,MAAM,cAAc,EAClB,MAAM,WAAW,QAAQ,GAAG,EAAE,WAAW;EAE3C,MAAM,sBACJ,sBAAsB,YAAY,kBAAkB;EAEtD,MAAM,oBAAoB;GACxB,MAAM,OAAO,IAAI,IAAS,YAAY;AACtC,gBAAa,IAAI,GAAG,GAAG,KAAK,OAAO,GAAG,GAAG,KAAK,IAAI,GAAG;AACrD,wBAAqB,KAAK;;AAG5B,SACE,oBAAC;GAAmB;aAClB,qBAAC;IACC,WAAW,KAAK,SAAS,OAAO,SAAS,OAAO,SAAS;IACzD,oBAAkB;;KAEjB,kBACC,oBAACC;MACC,SAAQ;MACR,OAAM;MACA;MACN,SAAS;MACG;MACZ,WAAW,OAAO;gBAElB,oBAAC,kBAAM,YAAY,oBAAC,SAAO,GAAG,oBAAC,SAAO,GAAQ;OACvC;KAEV,QAAQ,KACP,oBAAC;MAAiB;MAAoB;OAAe;KAEtD,gBACC,oBAACA;MACC,MAAK;MACL,SAAQ;MACF;MACN,WAAW,OAAO;gBAElB,oBAAC,kBAAM,aAAa,oBAAC,gBAAc,GAAG,oBAAC,cAAY,GAAQ;OACpD,GAET,oBAAC,SAAI,WAAW,KAAK,OAAO,SAAS,OAAO,SAAS,GAAI;KAE3D,oBAAC;MAAI,WAAW,KAAK,OAAO,SAAS,OAAO,SAAS;gBAClD,OAAO,aAAa,aACjB,SAAS;OACP,GAAG;OACH;OACA;OACY;OACZ,iBAAiB;OAClB,CAAC,GACF;OACA;KACL,uBACC,oBAACC;MACC,MAAK;MACO;MACA;OACZ;KAEH,kBACC,oBAACD;MACC,MAAK;MACL,SAAQ;MACF;MACM;MACZ,WAAW,OAAO;gBAElB,oBAAC,kBACC,oBAAC,aAAW,GACP;OACA;;KAEP;IACO;KAGC"}

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

@@ -11,18 +11,29 @@
  */
 
 import { TextProps } from "react-aria-components";
-import * as react_jsx_runtime149 from "react/jsx-runtime";
+import * as react_jsx_runtime174 from "react/jsx-runtime";
 
 //#region src/components/tree/item-description.d.ts
 /**
- * ItemDescription - Description for a tree item
+ * TreeItemDescription - Secondary descriptive text for a tree item
  *
- * Renders secondary descriptive text for a tree item
+ * @example
+ * ```tsx
+ * <TreeItemContent>
+ *   <TreeItemLabel>Project Files</TreeItemLabel>
+ *   <TreeItemDescription>Last modified 2 hours ago</TreeItemDescription>
+ * </TreeItemContent>
+ * ```
+ *
+ * @param props - TextProps from react-aria-components.
+ * @param props.children - Description text content.
+ * @param props.className - CSS class for the description.
+ * @returns The rendered TreeItemDescription component, or null if variant is 'crammed'.
  */
 declare function TreeItemDescription({
   children,
   className
-}: TextProps): react_jsx_runtime149.JSX.Element | null;
+}: TextProps): react_jsx_runtime174.JSX.Element | null;
 //#endregion
 export { TreeItemDescription };
 //# sourceMappingURL=item-description.d.ts.map

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

@@ -20,9 +20,20 @@ import styles from "./styles.module.css";
 
 //#region src/components/tree/item-description.tsx
 /**
-* ItemDescription - Description for a tree item
+* TreeItemDescription - Secondary descriptive text for a tree item
 *
-* Renders secondary descriptive text for a tree item
+* @example
+* ```tsx
+* <TreeItemContent>
+*   <TreeItemLabel>Project Files</TreeItemLabel>
+*   <TreeItemDescription>Last modified 2 hours ago</TreeItemDescription>
+* </TreeItemContent>
+* ```
+*
+* @param props - TextProps from react-aria-components.
+* @param props.children - Description text content.
+* @param props.className - CSS class for the description.
+* @returns The rendered TreeItemDescription component, or null if variant is 'crammed'.
 */
 function TreeItemDescription({ children, className }) {
 	const { variant } = useContext(TreeContext);

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

@@ -1 +1 @@
-{"version":3,"file":"item-description.js","names":[],"sources":["../../../src/components/tree/item-description.tsx"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport { useContext } from 'react';\nimport { Text, type TextProps } from 'react-aria-components';\nimport { TreeContext } from './context';\nimport styles from './styles.module.css';\n\n/**\n * ItemDescription - Description for a tree item\n *\n * Renders secondary descriptive text for a tree item\n */\nexport function TreeItemDescription({ children, className }: TextProps) {\n  const { variant } = useContext(TreeContext);\n\n  return variant !== 'crammed' ? (\n    <Text\n      data-slot='description'\n      className={clsx(styles.description, className)}\n    >\n      {children}\n    </Text>\n  ) : null;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAuBA,SAAgB,oBAAoB,EAAE,UAAU,aAAwB;CACtE,MAAM,EAAE,YAAY,WAAW,YAAY;AAE3C,QAAO,YAAY,YACjB,oBAAC;EACC,aAAU;EACV,WAAW,KAAK,OAAO,aAAa,UAAU;EAE7C;GACI,GACL"}
+{"version":3,"file":"item-description.js","names":[],"sources":["../../../src/components/tree/item-description.tsx"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport { useContext } from 'react';\nimport { Text, type TextProps } from 'react-aria-components';\nimport { TreeContext } from './context';\nimport styles from './styles.module.css';\n\n/**\n * TreeItemDescription - Secondary descriptive text for a tree item\n *\n * @example\n * ```tsx\n * <TreeItemContent>\n *   <TreeItemLabel>Project Files</TreeItemLabel>\n *   <TreeItemDescription>Last modified 2 hours ago</TreeItemDescription>\n * </TreeItemContent>\n * ```\n *\n * @param props - TextProps from react-aria-components.\n * @param props.children - Description text content.\n * @param props.className - CSS class for the description.\n * @returns The rendered TreeItemDescription component, or null if variant is 'crammed'.\n */\nexport function TreeItemDescription({ children, className }: TextProps) {\n  const { variant } = useContext(TreeContext);\n\n  return variant !== 'crammed' ? (\n    <Text\n      data-slot='description'\n      className={clsx(styles.description, className)}\n    >\n      {children}\n    </Text>\n  ) : null;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkCA,SAAgB,oBAAoB,EAAE,UAAU,aAAwB;CACtE,MAAM,EAAE,YAAY,WAAW,YAAY;AAE3C,QAAO,YAAY,YACjB,oBAAC;EACC,aAAU;EACV,WAAW,KAAK,OAAO,aAAa,UAAU;EAE7C;GACI,GACL"}

package/dist/components/tree/item-label.d.ts

@@ -11,18 +11,29 @@
  */
 
 import { TextProps } from "react-aria-components";
-import * as react_jsx_runtime152 from "react/jsx-runtime";
+import * as react_jsx_runtime176 from "react/jsx-runtime";
 
 //#region src/components/tree/item-label.d.ts
 /**
- * ItemLabel - Label for a tree item
+ * TreeItemLabel - Primary text label for a tree item
  *
- * Renders the primary text label for a tree item
+ * @example
+ * ```tsx
+ * <TreeItemContent>
+ *   <TreeItemLabel>Documents</TreeItemLabel>
+ *   <TreeItemDescription>Folder</TreeItemDescription>
+ * </TreeItemContent>
+ * ```
+ *
+ * @param props - TextProps from react-aria-components.
+ * @param props.children - Label text content.
+ * @param props.className - CSS class for the label.
+ * @returns The rendered TreeItemLabel component.
  */
 declare function TreeItemLabel({
   children,
   className
-}: TextProps): react_jsx_runtime152.JSX.Element;
+}: TextProps): react_jsx_runtime176.JSX.Element;
 //#endregion
 export { TreeItemLabel };
 //# sourceMappingURL=item-label.d.ts.map

package/dist/components/tree/item-label.js

@@ -18,9 +18,20 @@ import styles from "./styles.module.css";
 
 //#region src/components/tree/item-label.tsx
 /**
-* ItemLabel - Label for a tree item
+* TreeItemLabel - Primary text label for a tree item
 *
-* Renders the primary text label for a tree item
+* @example
+* ```tsx
+* <TreeItemContent>
+*   <TreeItemLabel>Documents</TreeItemLabel>
+*   <TreeItemDescription>Folder</TreeItemDescription>
+* </TreeItemContent>
+* ```
+*
+* @param props - TextProps from react-aria-components.
+* @param props.children - Label text content.
+* @param props.className - CSS class for the label.
+* @returns The rendered TreeItemLabel component.
 */
 function TreeItemLabel({ children, className }) {
 	return /* @__PURE__ */ jsx(Text, {

package/dist/components/tree/item-label.js.map

@@ -1 +1 @@
-{"version":3,"file":"item-label.js","names":[],"sources":["../../../src/components/tree/item-label.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 { Text, type TextProps } from 'react-aria-components';\nimport styles from './styles.module.css';\n\n/**\n * ItemLabel - Label for a tree item\n *\n * Renders the primary text label for a tree item\n */\nexport function TreeItemLabel({ children, className }: TextProps) {\n  return <Text className={clsx(styles.label, className)}>{children}</Text>;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAqBA,SAAgB,cAAc,EAAE,UAAU,aAAwB;AAChE,QAAO,oBAAC;EAAK,WAAW,KAAK,OAAO,OAAO,UAAU;EAAG;GAAgB"}
+{"version":3,"file":"item-label.js","names":[],"sources":["../../../src/components/tree/item-label.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 { Text, type TextProps } from 'react-aria-components';\nimport styles from './styles.module.css';\n\n/**\n * TreeItemLabel - Primary text label for a tree item\n *\n * @example\n * ```tsx\n * <TreeItemContent>\n *   <TreeItemLabel>Documents</TreeItemLabel>\n *   <TreeItemDescription>Folder</TreeItemDescription>\n * </TreeItemContent>\n * ```\n *\n * @param props - TextProps from react-aria-components.\n * @param props.children - Label text content.\n * @param props.className - CSS class for the label.\n * @returns The rendered TreeItemLabel component.\n */\nexport function TreeItemLabel({ children, className }: TextProps) {\n  return <Text className={clsx(styles.label, className)}>{children}</Text>;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgCA,SAAgB,cAAc,EAAE,UAAU,aAAwB;AAChE,QAAO,oBAAC;EAAK,WAAW,KAAK,OAAO,OAAO,UAAU;EAAG;GAAgB"}

package/dist/components/tree/item-prefix-icon.d.ts

@@ -11,18 +11,29 @@
  */
 
 import { IconProps } from "../icon/types.js";
-import * as react_jsx_runtime172 from "react/jsx-runtime";
+import * as react_jsx_runtime177 from "react/jsx-runtime";
 
 //#region src/components/tree/item-prefix-icon.d.ts
 /**
- * ItemIcon - Icon for a tree item
+ * TreeItemPrefixIcon - Icon displayed before the tree item label
  *
- * Renders an icon for a tree item
+ * @example
+ * ```tsx
+ * <TreeItemContent>
+ *   <TreeItemPrefixIcon><Folder /></TreeItemPrefixIcon>
+ *   <TreeItemLabel>My Documents</TreeItemLabel>
+ * </TreeItemContent>
+ * ```
+ *
+ * @param props - {@link IconProps}
+ * @param props.children - Icon element to render.
+ * @param props.className - CSS class for the icon container.
+ * @returns The rendered TreeItemPrefixIcon component.
  */
 declare function TreeItemPrefixIcon({
   children,
   className
-}: IconProps): react_jsx_runtime172.JSX.Element;
+}: IconProps): react_jsx_runtime177.JSX.Element;
 //#endregion
 export { TreeItemPrefixIcon };
 //# sourceMappingURL=item-prefix-icon.d.ts.map

package/dist/components/tree/item-prefix-icon.js

@@ -18,9 +18,20 @@ import styles from "./styles.module.css";
 
 //#region src/components/tree/item-prefix-icon.tsx
 /**
-* ItemIcon - Icon for a tree item
+* TreeItemPrefixIcon - Icon displayed before the tree item label
 *
-* Renders an icon for a tree item
+* @example
+* ```tsx
+* <TreeItemContent>
+*   <TreeItemPrefixIcon><Folder /></TreeItemPrefixIcon>
+*   <TreeItemLabel>My Documents</TreeItemLabel>
+* </TreeItemContent>
+* ```
+*
+* @param props - {@link IconProps}
+* @param props.children - Icon element to render.
+* @param props.className - CSS class for the icon container.
+* @returns The rendered TreeItemPrefixIcon component.
 */
 function TreeItemPrefixIcon({ children, className }) {
 	return /* @__PURE__ */ jsx(Icon, {

package/dist/components/tree/item-prefix-icon.js.map

@@ -1 +1 @@
-{"version":3,"file":"item-prefix-icon.js","names":[],"sources":["../../../src/components/tree/item-prefix-icon.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 { Icon } from '../icon';\nimport styles from './styles.module.css';\nimport type { IconProps } from '../icon/types';\n\n/**\n * ItemIcon - Icon for a tree item\n *\n * Renders an icon for a tree item\n */\nexport function TreeItemPrefixIcon({ children, className }: IconProps) {\n  return <Icon className={clsx(styles.icon, className)}>{children}</Icon>;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAsBA,SAAgB,mBAAmB,EAAE,UAAU,aAAwB;AACrE,QAAO,oBAAC;EAAK,WAAW,KAAK,OAAO,MAAM,UAAU;EAAG;GAAgB"}
+{"version":3,"file":"item-prefix-icon.js","names":[],"sources":["../../../src/components/tree/item-prefix-icon.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 { Icon } from '../icon';\nimport styles from './styles.module.css';\nimport type { IconProps } from '../icon/types';\n\n/**\n * TreeItemPrefixIcon - Icon displayed before the tree item label\n *\n * @example\n * ```tsx\n * <TreeItemContent>\n *   <TreeItemPrefixIcon><Folder /></TreeItemPrefixIcon>\n *   <TreeItemLabel>My Documents</TreeItemLabel>\n * </TreeItemContent>\n * ```\n *\n * @param props - {@link IconProps}\n * @param props.children - Icon element to render.\n * @param props.className - CSS class for the icon container.\n * @returns The rendered TreeItemPrefixIcon component.\n */\nexport function TreeItemPrefixIcon({ children, className }: IconProps) {\n  return <Icon className={clsx(styles.icon, className)}>{children}</Icon>;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiCA,SAAgB,mBAAmB,EAAE,UAAU,aAAwB;AACrE,QAAO,oBAAC;EAAK,WAAW,KAAK,OAAO,MAAM,UAAU;EAAG;GAAgB"}

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

@@ -12,19 +12,39 @@
 
 import { TreeItemProps } from "./types.js";
 import "client-only";
-import * as react_jsx_runtime173 from "react/jsx-runtime";
+import * as react_jsx_runtime179 from "react/jsx-runtime";
 
 //#region src/components/tree/item.d.ts
+
 /**
- * TreeItem - Individual node in a tree
+ * TreeItem - Individual node in the tree hierarchy
+ *
+ * @example
+ * ```tsx
+ * <Tree>
+ *   <TreeItem id="root" textValue="Root">
+ *     <TreeItemContent>
+ *       <TreeItemLabel>Root Node</TreeItemLabel>
+ *     </TreeItemContent>
+ *     <TreeItem id="child" textValue="Child">
+ *       <TreeItemContent>
+ *         <TreeItemLabel>Child Node</TreeItemLabel>
+ *       </TreeItemContent>
+ *     </TreeItem>
+ *   </TreeItem>
+ * </Tree>
+ * ```
  *
- * Represents a single item in the tree structure
+ * @param props - {@link TreeItemProps}
+ * @param props.className - CSS class for the tree item.
+ * @param props.id - Unique identifier for the tree item.
+ * @returns The rendered TreeItem component.
  */
 declare function TreeItem({
   className,
   id,
   ...rest
-}: TreeItemProps): react_jsx_runtime173.JSX.Element;
+}: TreeItemProps): react_jsx_runtime179.JSX.Element;
 //#endregion
 export { TreeItem };
 //# sourceMappingURL=item.d.ts.map

package/dist/components/tree/item.js

@@ -23,9 +23,28 @@ import styles from "./styles.module.css";
 
 //#region src/components/tree/item.tsx
 /**
-* TreeItem - Individual node in a tree
+* TreeItem - Individual node in the tree hierarchy
 *
-* Represents a single item in the tree structure
+* @example
+* ```tsx
+* <Tree>
+*   <TreeItem id="root" textValue="Root">
+*     <TreeItemContent>
+*       <TreeItemLabel>Root Node</TreeItemLabel>
+*     </TreeItemContent>
+*     <TreeItem id="child" textValue="Child">
+*       <TreeItemContent>
+*         <TreeItemLabel>Child Node</TreeItemLabel>
+*       </TreeItemContent>
+*     </TreeItem>
+*   </TreeItem>
+* </Tree>
+* ```
+*
+* @param props - {@link TreeItemProps}
+* @param props.className - CSS class for the tree item.
+* @param props.id - Unique identifier for the tree item.
+* @returns The rendered TreeItem component.
 */
 function TreeItem({ className, id, ...rest }) {
 	const { visibilityComputedKeys, visibleKeys, isStatic } = useContext(TreeContext);

package/dist/components/tree/item.js.map

@@ -1 +1 @@
-{"version":3,"file":"item.js","names":["AriaTreeItem","className"],"sources":["../../../src/components/tree/item.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 { useContext } from 'react';\nimport {\n  TreeItem as AriaTreeItem,\n  composeRenderProps,\n} from 'react-aria-components';\nimport { TreeContext, TreeItemContext } from './context';\nimport styles from './styles.module.css';\nimport type { TreeItemProps } from './types';\n\n/**\n * TreeItem - Individual node in a tree\n *\n * Represents a single item in the tree structure\n */\nexport function TreeItem({ className, id, ...rest }: TreeItemProps) {\n  const { visibilityComputedKeys, visibleKeys, isStatic } =\n    useContext(TreeContext);\n  const { ancestors } = useContext(TreeItemContext);\n  const isViewable =\n    visibilityComputedKeys?.has(id) ||\n    (isStatic && ancestors.every((key) => visibleKeys?.has(key)));\n  const isVisible = visibleKeys?.has(id);\n\n  return (\n    <TreeItemContext.Provider\n      value={{\n        isVisible,\n        isViewable,\n        ancestors: [...ancestors, id],\n      }}\n    >\n      <AriaTreeItem\n        {...rest}\n        id={id}\n        className={composeRenderProps(className, (className) =>\n          clsx('group/tree-item', styles.item, className),\n        )}\n        data-viewable={isViewable || null}\n        data-visible={isVisible || null}\n      />\n    </TreeItemContext.Provider>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6BA,SAAgB,SAAS,EAAE,WAAW,IAAI,GAAG,QAAuB;CAClE,MAAM,EAAE,wBAAwB,aAAa,aAC3C,WAAW,YAAY;CACzB,MAAM,EAAE,cAAc,WAAW,gBAAgB;CACjD,MAAM,aACJ,wBAAwB,IAAI,GAAG,IAC9B,YAAY,UAAU,OAAO,QAAQ,aAAa,IAAI,IAAI,CAAC;CAC9D,MAAM,YAAY,aAAa,IAAI,GAAG;AAEtC,QACE,oBAAC,gBAAgB;EACf,OAAO;GACL;GACA;GACA,WAAW,CAAC,GAAG,WAAW,GAAG;GAC9B;YAED,oBAACA;GACC,GAAI;GACA;GACJ,WAAW,mBAAmB,YAAY,gBACxC,KAAK,mBAAmB,OAAO,MAAMC,YAAU,CAChD;GACD,iBAAe,cAAc;GAC7B,gBAAc,aAAa;IAC3B;GACuB"}
+{"version":3,"file":"item.js","names":["AriaTreeItem","className"],"sources":["../../../src/components/tree/item.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 { useContext } from 'react';\nimport {\n  TreeItem as AriaTreeItem,\n  composeRenderProps,\n} from 'react-aria-components';\nimport { TreeContext, TreeItemContext } from './context';\nimport styles from './styles.module.css';\nimport type { TreeItemProps } from './types';\n\n/**\n * TreeItem - Individual node in the tree hierarchy\n *\n * @example\n * ```tsx\n * <Tree>\n *   <TreeItem id=\"root\" textValue=\"Root\">\n *     <TreeItemContent>\n *       <TreeItemLabel>Root Node</TreeItemLabel>\n *     </TreeItemContent>\n *     <TreeItem id=\"child\" textValue=\"Child\">\n *       <TreeItemContent>\n *         <TreeItemLabel>Child Node</TreeItemLabel>\n *       </TreeItemContent>\n *     </TreeItem>\n *   </TreeItem>\n * </Tree>\n * ```\n *\n * @param props - {@link TreeItemProps}\n * @param props.className - CSS class for the tree item.\n * @param props.id - Unique identifier for the tree item.\n * @returns The rendered TreeItem component.\n */\nexport function TreeItem({ className, id, ...rest }: TreeItemProps) {\n  const { visibilityComputedKeys, visibleKeys, isStatic } =\n    useContext(TreeContext);\n  const { ancestors } = useContext(TreeItemContext);\n  const isViewable =\n    visibilityComputedKeys?.has(id) ||\n    (isStatic && ancestors.every((key) => visibleKeys?.has(key)));\n  const isVisible = visibleKeys?.has(id);\n\n  return (\n    <TreeItemContext.Provider\n      value={{\n        isVisible,\n        isViewable,\n        ancestors: [...ancestors, id],\n      }}\n    >\n      <AriaTreeItem\n        {...rest}\n        id={id}\n        className={composeRenderProps(className, (className) =>\n          clsx('group/tree-item', styles.item, className),\n        )}\n        data-viewable={isViewable || null}\n        data-visible={isVisible || null}\n      />\n    </TreeItemContext.Provider>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgDA,SAAgB,SAAS,EAAE,WAAW,IAAI,GAAG,QAAuB;CAClE,MAAM,EAAE,wBAAwB,aAAa,aAC3C,WAAW,YAAY;CACzB,MAAM,EAAE,cAAc,WAAW,gBAAgB;CACjD,MAAM,aACJ,wBAAwB,IAAI,GAAG,IAC9B,YAAY,UAAU,OAAO,QAAQ,aAAa,IAAI,IAAI,CAAC;CAC9D,MAAM,YAAY,aAAa,IAAI,GAAG;AAEtC,QACE,oBAAC,gBAAgB;EACf,OAAO;GACL;GACA;GACA,WAAW,CAAC,GAAG,WAAW,GAAG;GAC9B;YAED,oBAACA;GACC,GAAI;GACA;GACJ,WAAW,mBAAmB,YAAY,gBACxC,KAAK,mBAAmB,OAAO,MAAMC,YAAU,CAChD;GACD,iBAAe,cAAc;GAC7B,gBAAc,aAAa;IAC3B;GACuB"}

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

@@ -10,10 +10,18 @@
  * governing permissions and limitations under the License.
  */
 
-import * as react38 from "react";
+import * as react43 from "react";
 
 //#region src/components/tree/lines.d.ts
-declare const TreeLines: react38.NamedExoticComponent<{
+/**
+ * TreeLines - Renders connecting lines for tree hierarchy visualization.
+ *
+ * @param props - Component props.
+ * @param props.level - The nesting level of the tree item.
+ * @param props.isLastOfSet - Whether this item is the last in its sibling group.
+ * @returns An array of Line components representing the tree structure.
+ */
+declare const TreeLines: react43.NamedExoticComponent<{
   level: number;
   isLastOfSet: boolean;
 }>;

package/dist/components/tree/lines.js

@@ -19,6 +19,14 @@ import { jsx } from "react/jsx-runtime";
 import styles from "./styles.module.css";
 
 //#region src/components/tree/lines.tsx
+/**
+* TreeLines - Renders connecting lines for tree hierarchy visualization.
+*
+* @param props - Component props.
+* @param props.level - The nesting level of the tree item.
+* @param props.isLastOfSet - Whether this item is the last in its sibling group.
+* @returns An array of Line components representing the tree structure.
+*/
 const TreeLines = memo(function TreeLines$1({ level, isLastOfSet }) {
 	const { showRuleLines, variant } = useContext(TreeContext);
 	return Array.from({ length: level }).map((_, i) => {

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

@@ -1 +1 @@
-{"version":3,"file":"lines.js","names":["TreeLines"],"sources":["../../../src/components/tree/lines.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 { memo, useContext } from 'react';\nimport { Lines } from '../lines';\nimport { TreeContext } from './context';\nimport styles from './styles.module.css';\n\nexport const TreeLines = memo(function TreeLines({\n  level,\n  isLastOfSet,\n}: {\n  level: number;\n  isLastOfSet: boolean;\n}) {\n  const { showRuleLines, variant } = useContext(TreeContext);\n\n  return Array.from({ length: level }).map((_, i) => {\n    const type = i === level - 1 ? 'branch' : 'vert';\n    const line = isLastOfSet && i > 0 ? 'last' : type;\n    const size = variant === 'crammed' ? 'medium' : 'large';\n\n    return (\n      <Lines\n        // biome-ignore lint/suspicious/noArrayIndexKey: index should be the key, only count matters\n        key={i}\n        variant={line}\n        size={size}\n        isVisible={showRuleLines}\n        className={clsx(styles.spacing, styles[variant])}\n      />\n    );\n  });\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAkBA,MAAa,YAAY,KAAK,SAASA,YAAU,EAC/C,OACA,eAIC;CACD,MAAM,EAAE,eAAe,YAAY,WAAW,YAAY;AAE1D,QAAO,MAAM,KAAK,EAAE,QAAQ,OAAO,CAAC,CAAC,KAAK,GAAG,MAAM;EACjD,MAAM,OAAO,MAAM,QAAQ,IAAI,WAAW;AAI1C,SACE,oBAAC;GAGC,SAPS,eAAe,IAAI,IAAI,SAAS;GAQzC,MAPS,YAAY,YAAY,WAAW;GAQ5C,WAAW;GACX,WAAW,KAAK,OAAO,SAAS,OAAO,SAAS;KAJ3C,EAKL;GAEJ;EACF"}
+{"version":3,"file":"lines.js","names":["TreeLines"],"sources":["../../../src/components/tree/lines.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 { memo, useContext } from 'react';\nimport { Lines } from '../lines';\nimport { TreeContext } from './context';\nimport styles from './styles.module.css';\n\n/**\n * TreeLines - Renders connecting lines for tree hierarchy visualization.\n *\n * @param props - Component props.\n * @param props.level - The nesting level of the tree item.\n * @param props.isLastOfSet - Whether this item is the last in its sibling group.\n * @returns An array of Line components representing the tree structure.\n */\nexport const TreeLines = memo(function TreeLines({\n  level,\n  isLastOfSet,\n}: {\n  level: number;\n  isLastOfSet: boolean;\n}) {\n  const { showRuleLines, variant } = useContext(TreeContext);\n\n  return Array.from({ length: level }).map((_, i) => {\n    const type = i === level - 1 ? 'branch' : 'vert';\n    const line = isLastOfSet && i > 0 ? 'last' : type;\n    const size = variant === 'crammed' ? 'medium' : 'large';\n\n    return (\n      <Lines\n        // biome-ignore lint/suspicious/noArrayIndexKey: index should be the key, only count matters\n        key={i}\n        variant={line}\n        size={size}\n        isVisible={showRuleLines}\n        className={clsx(styles.spacing, styles[variant])}\n      />\n    );\n  });\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0BA,MAAa,YAAY,KAAK,SAASA,YAAU,EAC/C,OACA,eAIC;CACD,MAAM,EAAE,eAAe,YAAY,WAAW,YAAY;AAE1D,QAAO,MAAM,KAAK,EAAE,QAAQ,OAAO,CAAC,CAAC,KAAK,GAAG,MAAM;EACjD,MAAM,OAAO,MAAM,QAAQ,IAAI,WAAW;AAI1C,SACE,oBAAC;GAGC,SAPS,eAAe,IAAI,IAAI,SAAS;GAQzC,MAPS,YAAY,YAAY,WAAW;GAQ5C,WAAW;GACX,WAAW,KAAK,OAAO,SAAS,OAAO,SAAS;KAJ3C,EAKL;GAEJ;EACF"}

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

@@ -15,7 +15,11 @@ import { RenderProps, TreeItemContentRenderProps as TreeItemContentRenderProps$1
 import { Key as Key$1 } from "@react-types/shared";
 
 //#region src/components/tree/types.d.ts
+/** Visual density variant for Tree components. */
 type TreeStyleVariant = 'cozy' | 'compact' | 'crammed';
+/**
+ * Props for the Tree component.
+ */
 type TreeProps<T> = Omit<TreeProps$1<TreeNode<T>>, 'defaultExpandedKeys' | 'defaultSelectedKeys' | 'disabledKeys' | 'expandedKeys' | 'selectedKeys' | 'onSelectionChange'> & {
   disabledKeys?: Set<Key$1>;
   dragAndDropConfig?: DragAndDropConfig;
@@ -28,15 +32,31 @@ type TreeProps<T> = Omit<TreeProps$1<TreeNode<T>>, 'defaultExpandedKeys' | 'defa
   onSelectionChange?: (keys: Set<Key$1>) => void;
   variant?: TreeStyleVariant;
 };
+/**
+ * Props for the TreeItem component.
+ */
 type TreeItemProps = Omit<TreeItemProps$1, 'id'> & {
+  /** Unique identifier for the tree item. */
   id: Key$1;
 };
+/**
+ * Props for the TreeItemContent component.
+ */
 type TreeItemContentProps = Pick<RenderProps<TreeItemContentRenderProps>, 'children'>;
+/**
+ * Render props passed to TreeItemContent children.
+ */
 type TreeItemContentRenderProps = TreeItemContentRenderProps$1 & {
+  /** Whether the item is viewable based on ancestor visibility. */
   isViewable?: boolean;
+  /** Whether the item is currently visible. */
   isVisible?: boolean;
+  /** Visual density variant. */
   variant?: TreeStyleVariant;
 };
+/**
+ * Context value for the Tree component.
+ */
 type TreeContextValue = Required<Pick<TreeProps<unknown>, 'showRuleLines' | 'showVisibility' | 'variant' | 'onVisibilityChange'>> & {
   disabledKeys?: Set<Key$1>;
   expandedKeys?: Set<Key$1>;
@@ -45,9 +65,15 @@ type TreeContextValue = Required<Pick<TreeProps<unknown>, 'showRuleLines' | 'sho
   visibilityComputedKeys?: Set<Key$1>;
   isStatic: boolean;
 };
+/**
+ * Context value for a TreeItem component.
+ */
 type TreeItemContextValue = {
+  /** Whether the item is currently visible. */
   isVisible?: boolean;
+  /** Whether the item is viewable based on ancestor visibility. */
   isViewable?: boolean;
+  /** Array of ancestor item keys. */
   ancestors: Key$1[];
 };
 //#endregion

package/dist/components/view-stack/context.d.ts

@@ -12,17 +12,13 @@
 
 import { ViewStackContextValue } from "./types.js";
 import "client-only";
-import * as react39 from "react";
+import * as react40 from "react";
 import { UniqueId } from "@accelint/core";
 
 //#region src/components/view-stack/context.d.ts
-/**
- * Context for ViewStack component
- */
-declare const ViewStackContext: react39.Context<ViewStackContextValue>;
-/**
- * Event handlers for ViewStack events
- */
+/** Context for sharing state across ViewStack components */
+declare const ViewStackContext: react40.Context<ViewStackContextValue>;
+/** Event handlers for ViewStack events */
 declare const ViewStackEventHandlers: {
   readonly back: (stack: UniqueId) => void;
   readonly clear: (stack: UniqueId) => void;
@@ -30,7 +26,22 @@ declare const ViewStackEventHandlers: {
   readonly reset: (stack: UniqueId) => void;
 };
 /**
- * Hook for emitting ViewStack events
+ * Hook for programmatic ViewStack control from anywhere in the application
+ *
+ * @example
+ * ```tsx
+ * function MyComponent() {
+ *   const viewStack = useViewStackEmit();
+ *
+ *   return (
+ *     <Button onPress={() => viewStack.push('view-id')}>
+ *       Navigate to View
+ *     </Button>
+ *   );
+ * }
+ * ```
+ *
+ * @returns Object with emit functions for back, clear, push, and reset actions.
  */
 declare function useViewStackEmit(): {
   readonly back: (stack: UniqueId) => void;

package/dist/components/view-stack/context.js

@@ -21,9 +21,7 @@ import { useEmit } from "@accelint/bus/react";
 
 //#region src/components/view-stack/context.tsx
 const bus = Broadcast.getInstance();
-/**
-* Context for ViewStack component
-*/
+/** Context for sharing state across ViewStack components */
 const ViewStackContext = createContext({
 	parent: null,
 	stack: [],
@@ -31,9 +29,7 @@ const ViewStackContext = createContext({
 	register: () => void 0,
 	unregister: () => void 0
 });
-/**
-* Event handlers for ViewStack events
-*/
+/** Event handlers for ViewStack events */
 const ViewStackEventHandlers = {
 	back: (stack) => bus.emit(ViewStackEventTypes.back, { stack }),
 	clear: (stack) => bus.emit(ViewStackEventTypes.clear, { stack }),
@@ -41,7 +37,22 @@ const ViewStackEventHandlers = {
 	reset: (stack) => bus.emit(ViewStackEventTypes.reset, { stack })
 };
 /**
-* Hook for emitting ViewStack events
+* Hook for programmatic ViewStack control from anywhere in the application
+*
+* @example
+* ```tsx
+* function MyComponent() {
+*   const viewStack = useViewStackEmit();
+*
+*   return (
+*     <Button onPress={() => viewStack.push('view-id')}>
+*       Navigate to View
+*     </Button>
+*   );
+* }
+* ```
+*
+* @returns Object with emit functions for back, clear, push, and reset actions.
 */
 function useViewStackEmit() {
 	const emitBack = useEmit(ViewStackEventTypes.back);

package/dist/components/view-stack/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/view-stack/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 { Broadcast } from '@accelint/bus';\nimport { useEmit } from '@accelint/bus/react';\nimport type { UniqueId } from '@accelint/core';\nimport 'client-only';\nimport { createContext } from 'react';\nimport { ViewStackEventTypes } from './events';\nimport type { ViewStackContextValue, ViewStackEvent } from './types';\n\nconst bus = Broadcast.getInstance<ViewStackEvent>();\n\n/**\n * Context for ViewStack component\n */\nexport const ViewStackContext = createContext<ViewStackContextValue>({\n  parent: null,\n  stack: [],\n  view: null,\n  register: () => undefined,\n  unregister: () => undefined,\n});\n\n/**\n * Event handlers for ViewStack events\n */\nexport const ViewStackEventHandlers = {\n  back: (stack: UniqueId) => bus.emit(ViewStackEventTypes.back, { stack }),\n  clear: (stack: UniqueId) => bus.emit(ViewStackEventTypes.clear, { stack }),\n  push: (view: UniqueId) => bus.emit(ViewStackEventTypes.push, { view }),\n  reset: (stack: UniqueId) => bus.emit(ViewStackEventTypes.reset, { stack }),\n} as const;\n\n/**\n * Hook for emitting ViewStack events\n */\nexport function useViewStackEmit() {\n  const emitBack = useEmit<ViewStackEvent>(ViewStackEventTypes.back);\n  const emitClear = useEmit<ViewStackEvent>(ViewStackEventTypes.clear);\n  const emitPush = useEmit<ViewStackEvent>(ViewStackEventTypes.push);\n  const emitReset = useEmit<ViewStackEvent>(ViewStackEventTypes.reset);\n\n  return {\n    back: (stack: UniqueId) => emitBack({ stack }),\n    clear: (stack: UniqueId) => emitClear({ stack }),\n    push: (view: UniqueId) => emitPush({ view }),\n    reset: (stack: UniqueId) => emitReset({ stack }),\n  } as const;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAqBA,MAAM,MAAM,UAAU,aAA6B;;;;AAKnD,MAAa,mBAAmB,cAAqC;CACnE,QAAQ;CACR,OAAO,EAAE;CACT,MAAM;CACN,gBAAgB;CAChB,kBAAkB;CACnB,CAAC;;;;AAKF,MAAa,yBAAyB;CACpC,OAAO,UAAoB,IAAI,KAAK,oBAAoB,MAAM,EAAE,OAAO,CAAC;CACxE,QAAQ,UAAoB,IAAI,KAAK,oBAAoB,OAAO,EAAE,OAAO,CAAC;CAC1E,OAAO,SAAmB,IAAI,KAAK,oBAAoB,MAAM,EAAE,MAAM,CAAC;CACtE,QAAQ,UAAoB,IAAI,KAAK,oBAAoB,OAAO,EAAE,OAAO,CAAC;CAC3E;;;;AAKD,SAAgB,mBAAmB;CACjC,MAAM,WAAW,QAAwB,oBAAoB,KAAK;CAClE,MAAM,YAAY,QAAwB,oBAAoB,MAAM;CACpE,MAAM,WAAW,QAAwB,oBAAoB,KAAK;CAClE,MAAM,YAAY,QAAwB,oBAAoB,MAAM;AAEpE,QAAO;EACL,OAAO,UAAoB,SAAS,EAAE,OAAO,CAAC;EAC9C,QAAQ,UAAoB,UAAU,EAAE,OAAO,CAAC;EAChD,OAAO,SAAmB,SAAS,EAAE,MAAM,CAAC;EAC5C,QAAQ,UAAoB,UAAU,EAAE,OAAO,CAAC;EACjD"}
+{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/view-stack/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 { Broadcast } from '@accelint/bus';\nimport { useEmit } from '@accelint/bus/react';\nimport type { UniqueId } from '@accelint/core';\nimport 'client-only';\nimport { createContext } from 'react';\nimport { ViewStackEventTypes } from './events';\nimport type { ViewStackContextValue, ViewStackEvent } from './types';\n\nconst bus = Broadcast.getInstance<ViewStackEvent>();\n\n/** Context for sharing state across ViewStack components */\nexport const ViewStackContext = createContext<ViewStackContextValue>({\n  parent: null,\n  stack: [],\n  view: null,\n  register: () => undefined,\n  unregister: () => undefined,\n});\n\n/** Event handlers for ViewStack events */\nexport const ViewStackEventHandlers = {\n  back: (stack: UniqueId) => bus.emit(ViewStackEventTypes.back, { stack }),\n  clear: (stack: UniqueId) => bus.emit(ViewStackEventTypes.clear, { stack }),\n  push: (view: UniqueId) => bus.emit(ViewStackEventTypes.push, { view }),\n  reset: (stack: UniqueId) => bus.emit(ViewStackEventTypes.reset, { stack }),\n} as const;\n\n/**\n * Hook for programmatic ViewStack control from anywhere in the application\n *\n * @example\n * ```tsx\n * function MyComponent() {\n *   const viewStack = useViewStackEmit();\n *\n *   return (\n *     <Button onPress={() => viewStack.push('view-id')}>\n *       Navigate to View\n *     </Button>\n *   );\n * }\n * ```\n *\n * @returns Object with emit functions for back, clear, push, and reset actions.\n */\nexport function useViewStackEmit() {\n  const emitBack = useEmit<ViewStackEvent>(ViewStackEventTypes.back);\n  const emitClear = useEmit<ViewStackEvent>(ViewStackEventTypes.clear);\n  const emitPush = useEmit<ViewStackEvent>(ViewStackEventTypes.push);\n  const emitReset = useEmit<ViewStackEvent>(ViewStackEventTypes.reset);\n\n  return {\n    back: (stack: UniqueId) => emitBack({ stack }),\n    clear: (stack: UniqueId) => emitClear({ stack }),\n    push: (view: UniqueId) => emitPush({ view }),\n    reset: (stack: UniqueId) => emitReset({ stack }),\n  } as const;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAqBA,MAAM,MAAM,UAAU,aAA6B;;AAGnD,MAAa,mBAAmB,cAAqC;CACnE,QAAQ;CACR,OAAO,EAAE;CACT,MAAM;CACN,gBAAgB;CAChB,kBAAkB;CACnB,CAAC;;AAGF,MAAa,yBAAyB;CACpC,OAAO,UAAoB,IAAI,KAAK,oBAAoB,MAAM,EAAE,OAAO,CAAC;CACxE,QAAQ,UAAoB,IAAI,KAAK,oBAAoB,OAAO,EAAE,OAAO,CAAC;CAC1E,OAAO,SAAmB,IAAI,KAAK,oBAAoB,MAAM,EAAE,MAAM,CAAC;CACtE,QAAQ,UAAoB,IAAI,KAAK,oBAAoB,OAAO,EAAE,OAAO,CAAC;CAC3E;;;;;;;;;;;;;;;;;;;AAoBD,SAAgB,mBAAmB;CACjC,MAAM,WAAW,QAAwB,oBAAoB,KAAK;CAClE,MAAM,YAAY,QAAwB,oBAAoB,MAAM;CACpE,MAAM,WAAW,QAAwB,oBAAoB,KAAK;CAClE,MAAM,YAAY,QAAwB,oBAAoB,MAAM;AAEpE,QAAO;EACL,OAAO,UAAoB,SAAS,EAAE,OAAO,CAAC;EAC9C,QAAQ,UAAoB,UAAU,EAAE,OAAO,CAAC;EAChD,OAAO,SAAmB,SAAS,EAAE,MAAM,CAAC;EAC5C,QAAQ,UAAoB,UAAU,EAAE,OAAO,CAAC;EACjD"}