@accelint/design-toolkit 2.5.0 → 3.0.0

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

@@ -3,6 +3,52 @@ import { TabsProps as TabsProps$1, TabListProps as TabListProps$1, TabProps as T
 
 interface TabsProps extends TabsProps$1 {
 }
+/**
+ * Tabs - A tab navigation component for organizing content into sections
+ *
+ * Provides accessible tab navigation with keyboard support and proper ARIA implementation.
+ * Supports both horizontal and vertical orientations with icon and text variants.
+ * Perfect for organizing related content into separate, focusable sections.
+ *
+ * @example
+ * // Basic horizontal tabs
+ * <Tabs>
+ *   <Tabs.List>
+ *     <Tabs.Tab id="overview">Overview</Tabs.Tab>
+ *     <Tabs.Tab id="details">Details</Tabs.Tab>
+ *     <Tabs.Tab id="settings">Settings</Tabs.Tab>
+ *   </Tabs.List>
+ *   <Tabs.Panel id="overview">Overview content</Tabs.Panel>
+ *   <Tabs.Panel id="details">Details content</Tabs.Panel>
+ *   <Tabs.Panel id="settings">Settings content</Tabs.Panel>
+ * </Tabs>
+ *
+ * @example
+ * // Vertical tabs
+ * <Tabs orientation="vertical">
+ *   <Tabs.List>
+ *     <Tabs.Tab id="profile">Profile</Tabs.Tab>
+ *     <Tabs.Tab id="account">Account</Tabs.Tab>
+ *   </Tabs.List>
+ *   <Tabs.Panel id="profile">Profile settings</Tabs.Panel>
+ *   <Tabs.Panel id="account">Account settings</Tabs.Panel>
+ * </Tabs>
+ *
+ * @example
+ * // Icon tabs
+ * <Tabs>
+ *   <Tabs.List variant="icons">
+ *     <Tabs.Tab id="home">
+ *       <Icon><Home /></Icon>
+ *     </Tabs.Tab>
+ *     <Tabs.Tab id="search">
+ *       <Icon><Search /></Icon>
+ *     </Tabs.Tab>
+ *   </Tabs.List>
+ *   <Tabs.Panel id="home">Home content</Tabs.Panel>
+ *   <Tabs.Panel id="search">Search content</Tabs.Panel>
+ * </Tabs>
+ */
 declare const Tabs: {
     ({ children, className, orientation, isDisabled, ...rest }: TabsProps): react_jsx_runtime.JSX.Element;
     displayName: string;

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/components/tabs/index.tsx"],"names":["rest","p","jsx","AriaTabs","orientation","l","v","i","Tabs","b","variant","drawer","containsExactChildren","AriaTabList","cn","tabListStyles","m","children","TabList","id","T","tabStyles","isSelected","isDisabled","Tab","P","TabPanel"],"mappings":"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","file":"index.js","sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\n'use client';\nimport { containsExactChildren } from '@/lib/react';\nimport { cn } from '@/lib/utils';\nimport 'client-only';\nimport { cva } from 'class-variance-authority';\nimport {\n  Tab as AriaTab,\n  TabList as AriaTabList,\n  type TabListProps as AriaTabListProps,\n  TabPanel as AriaTabPanel,\n  type TabPanelProps as AriaTabPanelProps,\n  type TabProps as AriaTabProps,\n  Tabs as AriaTabs,\n  type TabsProps as AriaTabsProps,\n} from 'react-aria-components';\n\nexport interface TabsProps extends AriaTabsProps {}\n\nexport const Tabs = ({\n  children,\n  className,\n  orientation = 'horizontal',\n  isDisabled = false,\n  ...rest\n}: TabsProps) => {\n  containsExactChildren({\n    children,\n    componentName: Tabs.displayName,\n    restrictions: [[TabList, { min: 1, max: 1 }]],\n  });\n\n  return (\n    <AriaTabs\n      orientation={orientation}\n      isDisabled={isDisabled}\n      className={cn(\n        'group flex w-content flex-row orientation-horizontal:flex-col',\n        className,\n      )}\n      {...rest}\n    >\n      {children}\n    </AriaTabs>\n  );\n};\n\nTabs.displayName = 'Tabs';\n\nexport interface TabListProps extends AriaTabListProps<object> {\n  /** Whether the tabs are displaying iconography or text. */\n  variant?: 'default' | 'icons';\n  /** Whether the tabs are used as drawer controls. */\n  drawer?: 'left' | 'right' | 'top' | 'bottom';\n}\n\nconst tabListStyles = cva('flex orientation-horizontal:flex-row flex-col', {\n  variants: {\n    variant: {\n      icons:\n        '[&>*]:p-xs orientation-horizontal:[&>*]:pr-s orientation-horizontal:[&>*]:pl-s [&>*]:leading-[0]',\n      default: '[&>*]:p-s [&>*]:text-header-m',\n    },\n    drawer: {\n      left: 'orientation-vertical:gap-xs rounded-r-large bg-surface-default p-s',\n      right:\n        'orientation-vertical:gap-xs rounded-l-large bg-surface-default p-s',\n      top: 'orientation-vertical:gap-xs rounded-b-large bg-surface-default p-s',\n      bottom:\n        'orientation-vertical:gap-xs rounded-t-large bg-surface-default p-s',\n    },\n  },\n});\n\nconst TabList = ({\n  children,\n  className,\n  variant = 'default',\n  drawer = undefined,\n  ...rest\n}: TabListProps) => {\n  containsExactChildren({\n    children,\n    componentName: TabList.displayName,\n    restrictions: [[Tab, { min: 1 }]],\n  });\n\n  return (\n    <AriaTabList\n      className={cn(tabListStyles({ variant, drawer }), className)}\n      {...rest}\n    >\n      {children}\n    </AriaTabList>\n  );\n};\n\nTabList.displayName = 'Tabs.List';\nTabs.List = TabList;\n\nconst tabBaseStyles = cn(\n  'fg-default-dark cursor-pointer p-s outline-none',\n  'rounded-medium group-orientation-horizontal:rounded-small group-orientation-horizontal:rounded-b-none',\n  'group-orientation-horizontal:border-static-light group-orientation-horizontal:border-b',\n  'group-orientation-vertical:border group-orientation-vertical:border-transparent',\n);\n\nconst tabStyles = cva(tabBaseStyles, {\n  variants: {\n    isSelected: {\n      true: 'fg-highlight bg-highlight-subtle group-orientation-horizontal:border-highlight',\n    },\n    isHovered: {\n      true: 'fg-default-light group-orientation-horizontal:border-interactive-hover',\n    },\n    isFocused: {\n      true: 'fg-default-light group-orientation-horizontal:border-interactive-hover',\n    },\n    isDisabled: {\n      true: 'fg-disabled cursor-not-allowed group-orientation-horizontal:border-interactive-disabled',\n    },\n  },\n  compoundVariants: [\n    {\n      isSelected: true,\n      isHovered: true,\n      className: 'fg-highlight group-orientation-horizontal:border-highlight',\n    },\n    {\n      isSelected: true,\n      isFocused: true,\n      className:\n        'fg-highlight group-orientation-horizontal:border-interactive-hover group-orientation-vertical:border-interactive-hover',\n    },\n    {\n      isDisabled: true,\n      isSelected: true,\n      className:\n        'fg-disabled bg-interactive-disabled group-orientation-horizontal:border-interactive-disabled',\n    },\n  ],\n});\n\nexport interface TabProps extends AriaTabProps {}\n\nconst Tab = ({\n  id,\n  children,\n  className,\n  isDisabled = false,\n  ...rest\n}: TabProps) => {\n  return (\n    <AriaTab\n      id={id}\n      className={({ isSelected, isHovered, isFocused, isDisabled }) =>\n        cn(\n          tabStyles({ isSelected, isHovered, isFocused, isDisabled }),\n          className,\n        )\n      }\n      isDisabled={isDisabled}\n      {...rest}\n    >\n      {children}\n    </AriaTab>\n  );\n};\n\nTab.displayName = 'Tabs.Tab';\nTabs.Tab = Tab;\n\nexport interface TabPanelProps extends AriaTabPanelProps {}\n\nconst TabPanel = ({ id, children, className, ...rest }: TabPanelProps) => {\n  return (\n    <AriaTabPanel\n      id={id}\n      className={cn(\n        'fg-default-light p-s group-orientation-vertical:pt-0 group-orientation-horizontal:pl-0',\n        className,\n      )}\n      {...rest}\n    >\n      {children}\n    </AriaTabPanel>\n  );\n};\n\nTabPanel.displayName = 'Tabs.Panel';\nTabs.Panel = TabPanel;\n"]}
+{"version":3,"sources":["../../../src/components/tabs/index.tsx"],"names":["rest","p","jsx","AriaTabs","orientation","l","v","i","Tabs","b","variant","drawer","containsExactChildren","AriaTabList","cn","tabListStyles","m","children","TabList","id","T","tabStyles","isSelected","isDisabled","Tab","P","TabPanel"],"mappings":"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","file":"index.js","sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\n'use client';\nimport { containsExactChildren } from '@/lib/react';\nimport { cn } from '@/lib/utils';\nimport 'client-only';\nimport { cva } from 'class-variance-authority';\nimport {\n  Tab as AriaTab,\n  TabList as AriaTabList,\n  type TabListProps as AriaTabListProps,\n  TabPanel as AriaTabPanel,\n  type TabPanelProps as AriaTabPanelProps,\n  type TabProps as AriaTabProps,\n  Tabs as AriaTabs,\n  type TabsProps as AriaTabsProps,\n} from 'react-aria-components';\n\nexport interface TabsProps extends AriaTabsProps {}\n\n/**\n * Tabs - A tab navigation component for organizing content into sections\n *\n * Provides accessible tab navigation with keyboard support and proper ARIA implementation.\n * Supports both horizontal and vertical orientations with icon and text variants.\n * Perfect for organizing related content into separate, focusable sections.\n *\n * @example\n * // Basic horizontal tabs\n * <Tabs>\n *   <Tabs.List>\n *     <Tabs.Tab id=\"overview\">Overview</Tabs.Tab>\n *     <Tabs.Tab id=\"details\">Details</Tabs.Tab>\n *     <Tabs.Tab id=\"settings\">Settings</Tabs.Tab>\n *   </Tabs.List>\n *   <Tabs.Panel id=\"overview\">Overview content</Tabs.Panel>\n *   <Tabs.Panel id=\"details\">Details content</Tabs.Panel>\n *   <Tabs.Panel id=\"settings\">Settings content</Tabs.Panel>\n * </Tabs>\n *\n * @example\n * // Vertical tabs\n * <Tabs orientation=\"vertical\">\n *   <Tabs.List>\n *     <Tabs.Tab id=\"profile\">Profile</Tabs.Tab>\n *     <Tabs.Tab id=\"account\">Account</Tabs.Tab>\n *   </Tabs.List>\n *   <Tabs.Panel id=\"profile\">Profile settings</Tabs.Panel>\n *   <Tabs.Panel id=\"account\">Account settings</Tabs.Panel>\n * </Tabs>\n *\n * @example\n * // Icon tabs\n * <Tabs>\n *   <Tabs.List variant=\"icons\">\n *     <Tabs.Tab id=\"home\">\n *       <Icon><Home /></Icon>\n *     </Tabs.Tab>\n *     <Tabs.Tab id=\"search\">\n *       <Icon><Search /></Icon>\n *     </Tabs.Tab>\n *   </Tabs.List>\n *   <Tabs.Panel id=\"home\">Home content</Tabs.Panel>\n *   <Tabs.Panel id=\"search\">Search content</Tabs.Panel>\n * </Tabs>\n */\nexport const Tabs = ({\n  children,\n  className,\n  orientation = 'horizontal',\n  isDisabled = false,\n  ...rest\n}: TabsProps) => {\n  containsExactChildren({\n    children,\n    componentName: Tabs.displayName,\n    restrictions: [[TabList, { min: 1, max: 1 }]],\n  });\n\n  return (\n    <AriaTabs\n      orientation={orientation}\n      isDisabled={isDisabled}\n      className={cn(\n        'group flex w-content flex-row orientation-horizontal:flex-col',\n        className,\n      )}\n      {...rest}\n    >\n      {children}\n    </AriaTabs>\n  );\n};\n\nTabs.displayName = 'Tabs';\n\nexport interface TabListProps extends AriaTabListProps<object> {\n  /** Whether the tabs are displaying iconography or text. */\n  variant?: 'default' | 'icons';\n  /** Whether the tabs are used as drawer controls. */\n  drawer?: 'left' | 'right' | 'top' | 'bottom';\n}\n\nconst tabListStyles = cva('flex orientation-horizontal:flex-row flex-col', {\n  variants: {\n    variant: {\n      icons:\n        '[&>*]:p-xs orientation-horizontal:[&>*]:pr-s orientation-horizontal:[&>*]:pl-s [&>*]:leading-[0]',\n      default: '[&>*]:p-s [&>*]:text-header-m',\n    },\n    drawer: {\n      left: 'orientation-vertical:gap-xs rounded-r-large bg-surface-default p-s',\n      right:\n        'orientation-vertical:gap-xs rounded-l-large bg-surface-default p-s',\n      top: 'orientation-vertical:gap-xs rounded-b-large bg-surface-default p-s',\n      bottom:\n        'orientation-vertical:gap-xs rounded-t-large bg-surface-default p-s',\n    },\n  },\n});\n\nconst TabList = ({\n  children,\n  className,\n  variant = 'default',\n  drawer = undefined,\n  ...rest\n}: TabListProps) => {\n  containsExactChildren({\n    children,\n    componentName: TabList.displayName,\n    restrictions: [[Tab, { min: 1 }]],\n  });\n\n  return (\n    <AriaTabList\n      className={cn(tabListStyles({ variant, drawer }), className)}\n      {...rest}\n    >\n      {children}\n    </AriaTabList>\n  );\n};\n\nTabList.displayName = 'Tabs.List';\nTabs.List = TabList;\n\nconst tabBaseStyles = cn(\n  'fg-default-dark cursor-pointer p-s outline-none',\n  'rounded-medium group-orientation-horizontal:rounded-small group-orientation-horizontal:rounded-b-none',\n  'group-orientation-horizontal:border-static-light group-orientation-horizontal:border-b',\n  'group-orientation-vertical:border group-orientation-vertical:border-transparent',\n);\n\nconst tabStyles = cva(tabBaseStyles, {\n  variants: {\n    isSelected: {\n      true: 'fg-highlight bg-highlight-subtle group-orientation-horizontal:border-highlight',\n    },\n    isHovered: {\n      true: 'fg-default-light group-orientation-horizontal:border-interactive-hover',\n    },\n    isFocused: {\n      true: 'fg-default-light group-orientation-horizontal:border-interactive-hover',\n    },\n    isDisabled: {\n      true: 'fg-disabled cursor-not-allowed group-orientation-horizontal:border-interactive-disabled',\n    },\n  },\n  compoundVariants: [\n    {\n      isSelected: true,\n      isHovered: true,\n      className: 'fg-highlight group-orientation-horizontal:border-highlight',\n    },\n    {\n      isSelected: true,\n      isFocused: true,\n      className:\n        'fg-highlight group-orientation-horizontal:border-interactive-hover group-orientation-vertical:border-interactive-hover',\n    },\n    {\n      isDisabled: true,\n      isSelected: true,\n      className:\n        'fg-disabled bg-interactive-disabled group-orientation-horizontal:border-interactive-disabled',\n    },\n  ],\n});\n\nexport interface TabProps extends AriaTabProps {}\n\nconst Tab = ({\n  id,\n  children,\n  className,\n  isDisabled = false,\n  ...rest\n}: TabProps) => {\n  return (\n    <AriaTab\n      id={id}\n      className={({ isSelected, isHovered, isFocused, isDisabled }) =>\n        cn(\n          tabStyles({ isSelected, isHovered, isFocused, isDisabled }),\n          className,\n        )\n      }\n      isDisabled={isDisabled}\n      {...rest}\n    >\n      {children}\n    </AriaTab>\n  );\n};\n\nTab.displayName = 'Tabs.Tab';\nTabs.Tab = Tab;\n\nexport interface TabPanelProps extends AriaTabPanelProps {}\n\nconst TabPanel = ({ id, children, className, ...rest }: TabPanelProps) => {\n  return (\n    <AriaTabPanel\n      id={id}\n      className={cn(\n        'fg-default-light p-s group-orientation-vertical:pt-0 group-orientation-horizontal:pl-0',\n        className,\n      )}\n      {...rest}\n    >\n      {children}\n    </AriaTabPanel>\n  );\n};\n\nTabPanel.displayName = 'Tabs.Panel';\nTabs.Panel = TabPanel;\n"]}

package/dist/components/text-area-field/index.d.ts

@@ -9,6 +9,26 @@ declare function TextAreaFieldProvider({ children, ...props }: ProviderProps<Tex
 declare namespace TextAreaFieldProvider {
     var displayName: string;
 }
+/**
+ * TextAreaField - A multi-line text input component with label and validation
+ *
+ * Provides a complete form field experience for longer text content with integrated
+ * label, description, and error message components. Handles validation states and
+ * accessibility automatically while supporting resizable text areas.
+ *
+ * @example
+ * // Basic text area field
+ * <TextAreaField label="Comments" />
+ *
+ * @example
+ * // Text area with validation
+ * <TextAreaField
+ *   isInvalid={true}
+ *   errorMessage='Message is required'
+ *   label='Foo'
+ *   isRequired
+ *   />
+ */
 declare function TextAreaField({ ref, ...props }: TextAreaFieldProps): react_jsx_runtime.JSX.Element;
 declare namespace TextAreaField {
     var displayName: string;

package/dist/components/text-area-field/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/components/text-area-field/index.tsx"],"names":["label","input","description","TextAreaFieldContext","E","b","props","jsx","e","TextAreaFieldProvider","useContextProps","ref","M","descriptionProp","errorMessageProp","inputProps","isSmall","size","L","composeRenderProps","classNames","className","field","isInvalidProp","errorMessage","isDisabled","isInvalid","isRequired","k","V","labelProp","Label","C","Text","y","error"],"mappings":"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","file":"index.js","sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\n'use client';\n\nimport 'client-only';\nimport type { ProviderProps } from '@/lib/types';\nimport { createContext } from 'react';\nimport {\n  type ContextValue,\n  FieldError,\n  Text,\n  TextArea,\n  TextField,\n  composeRenderProps,\n  useContextProps,\n} from 'react-aria-components';\nimport { Label } from '../label';\nimport { TextAreaStyles } from './styles';\nimport type { TextAreaFieldProps } from './types';\n\nconst { field, label, input, description, error } = TextAreaStyles();\n\nexport const TextAreaFieldContext =\n  createContext<ContextValue<TextAreaFieldProps, HTMLDivElement>>(null);\n\nfunction TextAreaFieldProvider({\n  children,\n  ...props\n}: ProviderProps<TextAreaFieldProps>) {\n  return (\n    <TextAreaFieldContext.Provider value={props}>\n      {children}\n    </TextAreaFieldContext.Provider>\n  );\n}\nTextAreaFieldProvider.displayName = 'TextAreaField.Provider';\n\nexport function TextAreaField({ ref, ...props }: TextAreaFieldProps) {\n  [props, ref] = useContextProps(props, ref ?? null, TextAreaFieldContext);\n\n  const {\n    classNames,\n    description: descriptionProp,\n    errorMessage: errorMessageProp,\n    label: labelProp,\n    inputProps,\n    size = 'medium',\n    isInvalid: isInvalidProp,\n    ...rest\n  } = props;\n  const errorMessage = errorMessageProp || null; // Protect against empty string\n  const isSmall = size === 'small';\n\n  return (\n    <TextField\n      {...rest}\n      ref={ref}\n      className={composeRenderProps(classNames?.field, (className) =>\n        field({ className }),\n      )}\n      isInvalid={isInvalidProp || (errorMessage ? true : undefined)} // Leave uncontrolled if possible to fallback to validation state\n      data-size={size}\n    >\n      {(\n        { isDisabled, isInvalid, isRequired }, // Rely on internal state, not props, since state could differ from props\n      ) => (\n        <>\n          {!!labelProp && !isSmall && (\n            <Label\n              className={label({ className: classNames?.label })}\n              isDisabled={isDisabled}\n              isRequired={isRequired}\n            >\n              {labelProp}\n            </Label>\n          )}\n          <TextArea\n            {...inputProps}\n            className={composeRenderProps(classNames?.input, (className) =>\n              input({ className }),\n            )}\n          />\n          {!!descriptionProp && !(isSmall || isInvalid) && (\n            <Text\n              slot='description'\n              className={description({ className: classNames?.description })}\n            >\n              {descriptionProp}\n            </Text>\n          )}\n          <FieldError\n            className={composeRenderProps(classNames?.error, (className) =>\n              error({ className }),\n            )}\n          >\n            {errorMessage}\n          </FieldError>\n        </>\n      )}\n    </TextField>\n  );\n}\nTextAreaField.displayName = 'TextAreaField';\nTextAreaField.Provider = TextAreaFieldProvider;\n"]}
+{"version":3,"sources":["../../../src/components/text-area-field/index.tsx"],"names":["label","input","description","TextAreaFieldContext","E","b","props","jsx","e","TextAreaFieldProvider","useContextProps","ref","M","descriptionProp","errorMessageProp","inputProps","isSmall","size","L","composeRenderProps","classNames","className","field","isInvalidProp","errorMessage","isDisabled","isInvalid","isRequired","k","V","labelProp","Label","C","Text","y","error"],"mappings":"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","file":"index.js","sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\n'use client';\n\nimport 'client-only';\nimport type { ProviderProps } from '@/lib/types';\nimport { createContext } from 'react';\nimport {\n  type ContextValue,\n  FieldError,\n  Text,\n  TextArea,\n  TextField,\n  composeRenderProps,\n  useContextProps,\n} from 'react-aria-components';\nimport { Label } from '../label';\nimport { TextAreaStyles } from './styles';\nimport type { TextAreaFieldProps } from './types';\n\nconst { field, label, input, description, error } = TextAreaStyles();\n\nexport const TextAreaFieldContext =\n  createContext<ContextValue<TextAreaFieldProps, HTMLDivElement>>(null);\n\nfunction TextAreaFieldProvider({\n  children,\n  ...props\n}: ProviderProps<TextAreaFieldProps>) {\n  return (\n    <TextAreaFieldContext.Provider value={props}>\n      {children}\n    </TextAreaFieldContext.Provider>\n  );\n}\nTextAreaFieldProvider.displayName = 'TextAreaField.Provider';\n\n/**\n * TextAreaField - A multi-line text input component with label and validation\n *\n * Provides a complete form field experience for longer text content with integrated\n * label, description, and error message components. Handles validation states and\n * accessibility automatically while supporting resizable text areas.\n *\n * @example\n * // Basic text area field\n * <TextAreaField label=\"Comments\" />\n *\n * @example\n * // Text area with validation\n * <TextAreaField\n *   isInvalid={true}\n *   errorMessage='Message is required'\n *   label='Foo'\n *   isRequired\n *   />\n */\nexport function TextAreaField({ ref, ...props }: TextAreaFieldProps) {\n  [props, ref] = useContextProps(props, ref ?? null, TextAreaFieldContext);\n\n  const {\n    classNames,\n    description: descriptionProp,\n    errorMessage: errorMessageProp,\n    label: labelProp,\n    inputProps,\n    size = 'medium',\n    isInvalid: isInvalidProp,\n    ...rest\n  } = props;\n  const errorMessage = errorMessageProp || null; // Protect against empty string\n  const isSmall = size === 'small';\n\n  return (\n    <TextField\n      {...rest}\n      ref={ref}\n      className={composeRenderProps(classNames?.field, (className) =>\n        field({ className }),\n      )}\n      isInvalid={isInvalidProp || (errorMessage ? true : undefined)} // Leave uncontrolled if possible to fallback to validation state\n      data-size={size}\n    >\n      {(\n        { isDisabled, isInvalid, isRequired }, // Rely on internal state, not props, since state could differ from props\n      ) => (\n        <>\n          {!!labelProp && !isSmall && (\n            <Label\n              className={label({ className: classNames?.label })}\n              isDisabled={isDisabled}\n              isRequired={isRequired}\n            >\n              {labelProp}\n            </Label>\n          )}\n          <TextArea\n            {...inputProps}\n            className={composeRenderProps(classNames?.input, (className) =>\n              input({ className }),\n            )}\n          />\n          {!!descriptionProp && !(isSmall || isInvalid) && (\n            <Text\n              slot='description'\n              className={description({ className: classNames?.description })}\n            >\n              {descriptionProp}\n            </Text>\n          )}\n          <FieldError\n            className={composeRenderProps(classNames?.error, (className) =>\n              error({ className }),\n            )}\n          >\n            {errorMessage}\n          </FieldError>\n        </>\n      )}\n    </TextField>\n  );\n}\nTextAreaField.displayName = 'TextAreaField';\nTextAreaField.Provider = TextAreaFieldProvider;\n"]}

package/dist/components/text-area-field/styles.d.ts

@@ -6,9 +6,9 @@ declare const TextAreaStyles: tailwind_variants.TVReturnType<{
         [key: string]: tailwind_merge.ClassNameValue | {
             input?: tailwind_merge.ClassNameValue;
             label?: tailwind_merge.ClassNameValue;
-            error?: tailwind_merge.ClassNameValue;
             description?: tailwind_merge.ClassNameValue;
             field?: tailwind_merge.ClassNameValue;
+            error?: tailwind_merge.ClassNameValue;
         };
     };
 } | {
@@ -16,9 +16,9 @@ declare const TextAreaStyles: tailwind_variants.TVReturnType<{
         [x: string]: tailwind_merge.ClassNameValue | {
             input?: tailwind_merge.ClassNameValue;
             label?: tailwind_merge.ClassNameValue;
-            error?: tailwind_merge.ClassNameValue;
             description?: tailwind_merge.ClassNameValue;
             field?: tailwind_merge.ClassNameValue;
+            error?: tailwind_merge.ClassNameValue;
         };
     };
 } | {}, {
@@ -32,9 +32,9 @@ declare const TextAreaStyles: tailwind_variants.TVReturnType<{
         [key: string]: tailwind_merge.ClassNameValue | {
             input?: tailwind_merge.ClassNameValue;
             label?: tailwind_merge.ClassNameValue;
-            error?: tailwind_merge.ClassNameValue;
             description?: tailwind_merge.ClassNameValue;
             field?: tailwind_merge.ClassNameValue;
+            error?: tailwind_merge.ClassNameValue;
         };
     };
 } | {}, {

package/dist/components/text-area-field/styles.js

@@ -1,2 +1,2 @@
-import {tv}from'./../../lib/utils.js';const l=tv({slots:{field:"group/text-area-field flex flex-col gap-xs",label:"",input:["block w-full rounded-medium p-s font-display text-default-light outline outline-interactive placeholder:text-default-dark","group-size-medium/text-area-field:text-body-s group-size-small/text-area-field:text-body-xs","group-enabled/text-area-field:focus:outline-highlight","group-enabled/text-area-field:hover:outline-interactive-hover","group-enabled/text-area-field:group-invalid/text-area-field:outline-serious","group-disabled/text-area-field:text-disabled group-disabled/text-area-field:outline-interactive-disabled group-disabled/text-area-field:placeholder:text-disabled"],description:["fg-default-dark text-body-xs","group-disabled/text-area-field:fg-disabled"],error:"fg-serious text-body-xs"}});export{l as TextAreaStyles};//# sourceMappingURL=styles.js.map
+import {tv}from'./../../lib/utils.js';const l=tv({slots:{field:"group/text-area-field flex flex-col gap-xs",label:"",input:["block w-full rounded-medium p-s font-display text-default-light outline outline-interactive placeholder:text-default-dark","group-size-medium/text-area-field:text-body-s group-size-small/text-area-field:text-body-xs","group-enabled/text-area-field:focus-visible:outline-highlight","group-enabled/text-area-field:hover:outline-interactive-hover","group-enabled/text-area-field:group-invalid/text-area-field:outline-serious","group-disabled/text-area-field:text-disabled group-disabled/text-area-field:outline-interactive-disabled group-disabled/text-area-field:placeholder:text-disabled"],description:["fg-default-dark text-body-xs","group-disabled/text-area-field:fg-disabled"],error:"fg-serious text-body-xs"}});export{l as TextAreaStyles};//# sourceMappingURL=styles.js.map
 //# sourceMappingURL=styles.js.map

package/dist/components/text-area-field/styles.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/components/text-area-field/styles.ts"],"names":["e"],"mappings":"sCAeE,MAAA,CAAO,CACLA,EAAA,CAAA,CAAA,KAAO,CAAA,CAAA,KAAA,CAAA,4CAEP,CAAA,KAAO,CACL,EAAA,CAAA,KAAA,CAAA,CAAA,2HACA,CAAA,6FACA,CAAA,uDACA,CAAA,+DACA,CAAA,6EACA,CAAA,mKAEF,CAAA,CAAA,WACE,CAAA,CAAA,8BACA,CAAA,4CAEK,CAAA,CAAA,KAAA,CAAA,yBAEV,CAAA,CAAA","file":"styles.js","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 { tv } from '@/lib/utils';\n\nexport const TextAreaStyles = tv({\n  slots: {\n    field: 'group/text-area-field flex flex-col gap-xs',\n    label: '',\n    input: [\n      'block w-full rounded-medium p-s font-display text-default-light outline outline-interactive placeholder:text-default-dark',\n      'group-size-medium/text-area-field:text-body-s group-size-small/text-area-field:text-body-xs',\n      'group-enabled/text-area-field:focus:outline-highlight',\n      'group-enabled/text-area-field:hover:outline-interactive-hover',\n      'group-enabled/text-area-field:group-invalid/text-area-field:outline-serious',\n      'group-disabled/text-area-field:text-disabled group-disabled/text-area-field:outline-interactive-disabled group-disabled/text-area-field:placeholder:text-disabled',\n    ],\n    description: [\n      'fg-default-dark text-body-xs',\n      'group-disabled/text-area-field:fg-disabled',\n    ],\n    error: 'fg-serious text-body-xs',\n  },\n});\n"]}
+{"version":3,"sources":["../../../src/components/text-area-field/styles.ts"],"names":["e"],"mappings":"sCAeE,MAAA,CAAO,CACLA,EAAA,CAAA,CAAA,KAAO,CAAA,CAAA,KAAA,CAAA,4CAEP,CAAA,KAAO,CACL,EAAA,CAAA,KAAA,CAAA,CAAA,2HACA,CAAA,6FACA,CAAA,+DACA,CAAA,+DACA,CAAA,6EACA,CAAA,mKAEF,CAAA,CAAA,WACE,CAAA,CAAA,8BACA,CAAA,4CAEK,CAAA,CAAA,KAAA,CAAA,yBAEV,CAAA,CAAA","file":"styles.js","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 { tv } from '@/lib/utils';\n\nexport const TextAreaStyles = tv({\n  slots: {\n    field: 'group/text-area-field flex flex-col gap-xs',\n    label: '',\n    input: [\n      'block w-full rounded-medium p-s font-display text-default-light outline outline-interactive placeholder:text-default-dark',\n      'group-size-medium/text-area-field:text-body-s group-size-small/text-area-field:text-body-xs',\n      'group-enabled/text-area-field:focus-visible:outline-highlight',\n      'group-enabled/text-area-field:hover:outline-interactive-hover',\n      'group-enabled/text-area-field:group-invalid/text-area-field:outline-serious',\n      'group-disabled/text-area-field:text-disabled group-disabled/text-area-field:outline-interactive-disabled group-disabled/text-area-field:placeholder:text-disabled',\n    ],\n    description: [\n      'fg-default-dark text-body-xs',\n      'group-disabled/text-area-field:fg-disabled',\n    ],\n    error: 'fg-serious text-body-xs',\n  },\n});\n"]}

package/dist/components/text-field/index.d.ts

@@ -16,6 +16,68 @@ declare function TextFieldProvider({ children, ...props }: ProviderProps<TextFie
 declare namespace TextFieldProvider {
     var displayName: string;
 }
+/**
+ * TextField - A complete form field component with label, input, and validation
+ *
+ * Provides a comprehensive form field experience combining label, input, description,
+ * and error message components. Handles validation states and accessibility
+ * automatically while supporting extensive customization through styling props.
+ *
+ * @example
+ * // Basic text field with label and required validation
+ * <TextField label='Full Name' isRequired defaultValue='John Doe' />
+ *
+ * @example
+ * // Text field with placeholder and description
+ * <TextField
+ *   label='Email Address'
+ *   inputProps={{ placeholder: 'Enter your email address', type: 'email' }}
+ *   description='We will never share your email with third parties'
+ * />
+ *
+ * @example
+ * // Text field with error state
+ * <TextField
+ *   label='Username'
+ *   isInvalid
+ *   errorMessage='Username must be at least 3 characters long'
+ *   inputProps={{ placeholder: 'Enter username' }}
+ * />
+ *
+ * @example
+ * // Small size text field with clearable input
+ * <TextField
+ *   label='Search'
+ *   size='small'
+ *   inputProps={{
+ *     placeholder: 'Type to search...',
+ *     isClearable: true,
+ *     type: 'search'
+ *   }}
+ * />
+ *
+ * @example
+ * // Disabled text field
+ * <TextField
+ *   label='Status'
+ *   isDisabled
+ *   defaultValue='Inactive'
+ *   description='This field cannot be edited'
+ * />
+ *
+ * @example
+ * // Password field with validation
+ * <TextField
+ *   label='Password'
+ *   isRequired
+ *   inputProps={{
+ *     type: 'password',
+ *     placeholder: 'Enter a secure password',
+ *     minLength: 8
+ *   }}
+ *   description='Password must be at least 8 characters'
+ * />
+ */
 declare function TextField({ ref, ...props }: TextFieldProps): react_jsx_runtime.JSX.Element;
 declare namespace TextField {
     var displayName: string;

package/dist/components/text-field/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/components/text-field/index.tsx"],"names":["description","TextFieldStyles","TextFieldProvider","N","children","e","props","ref","L","rest","errorMessageProp","size","AriaTextField","composeRenderProps","classNames","className","field","c","isDisabled","isInvalid","isRequired","labelProp","isSmall","jsx","Label","label","g","inputProps","M","descriptionProp","I","error","errorMessage","TextField"],"mappings":"+TA8BsB,MAAA,CAAA,KAAAA,CAAa,CAAA,CAAA,KAAM,CAAA,CAAIC,CAAAA,WAGqB,CAAA,CAElE,CAAA,KAAA,CAAA,CAAA,CAASC,CAAAA,eAAkB,EACzB,CAAA,CAAA,CAAAC,aAAA,CAAA,IAAAC,EACA,SAEA,CAAA,CAAA,CAAA,QACoB,CAAA,CAAA,CAAA,GAAjB,CAA0B,CAAA,CAAA,CAAA,OACxBC,GAAA,CAAA,CAAA,CAAA,QAIPH,CAAkB,CAAA,KAAA,CAAA,CAAA,CAAA,QAAc,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,WAEzB,CAAA,oBAAmC,CAAmB,SAC5BI,CAAAA,CAAOC,CAAAA,GAAO,CAAA,CAAA,CAAA,GAAsB,CAEnE,CAAA,CAAA,CAAA,CAAA,CAAM,CACJ,CAAA,CAAA,CAAAC,eAAA,CAAA,CAAA,CAAA,CAAA,EAAA,IACA,CAAA,CAAA,CAAA,CAAA,KAAA,CAAA,UACA,CAAA,CAAA,CAAA,WACA,CAAA,CAAA,CAAA,YAEA,CAAA,CAAA,CAAA,UAAO,CAAA,CAAA,CACP,KAAA,CAAA,CAAA,CAAA,IACA,CAAA,CAAA,CAAGC,QAEgBC,CAAAA,SACLC,CAAAA,CAAAA,CAAS,GAAA,CAAA,CAAA,CAAA,CAAA,CAEzB,CAAA,CAAA,CAAA,EAAA,IACGC,CAAAA,CAAA,CACE,CAAA,GAAGH,OAEJ,CAAA,OAAAJ,GAAA,CAAWQ,SAAAA,CAAmBC,CAAAA,GAAY,CAAA,CAAA,GAAQC,CAAAA,CAAAA,CAChDC,SAAQ,CAAAC,kBAAA,CAAA,CAAAF,EAAW,KAErB,CAAA,CAAA,EAAA,CAAA,CAAA,CAAA,SAA4C,CAAO,CAAA,CAAA,CAAA,CAAA,CAAA,SACnD,CAAA,CAAA,GAAA,CAAWJ,CAAAA,IAEV,CAAA,MAAA,CAAA,CACC,WAAE,CAAAO,CAAAA,CAAY,QAAA,CAAA,CAAAC,CAAAA,UAAW,CAAA,CAAAC,CAAW,SAGjC,CAAA,CAAA,CAAA,UAAEC,CAAAA,CAAa,CAACC,GACfC,IAAAA,CAACC,QAAAA,CAAA,CACC,QAAA,CAAA,CAAWC,CAAAA,CAAM,CAAE,EAAA,CAAA,CAAA,EAAApB,GAAA,CAAAqB,KAAA,CAAWZ,CAAAA,SAAmB,CACjD,CAAA,CAAA,CAAA,SAAYI,CACZ,CAAA,EAAA,KAAA,CAAA,CAAA,CAAYE,UAEX,CAAAC,CAAAA,CACH,UAGIM,CAAAA,CACJ,CAAA,QAAA,CAAA,CAAYb,CAAAA,CAAAA,CAAYT,GAAA,CAAAuB,KAAA,CAAA,CAAA,GACxB,CAAA,CAAA,UACA,CAAA,CAAA,EAAA,KACA,CAAA,QACA,CAAA,CAAA,CAAA,QAED,CAAC,CAACC,CAAAA,IAAqBP,CAAAA,CAAAA,CAAWH,SAE/B,CAAA,CAAA,CAAA,CAAA,CAAK,CAAA,CAAA,CAAA,EAAA,EAAA,CAAA,EAAA,CAAA,CAAA,EACLd,GAAA,CAAAyB,IAAA,CAAA,CAAA,IAAA,CAAW9B,aAAyBc,CAAAA,SAAY,CAAA,CAAA,CAAA,CAAY,SAE3D,CAAA,CAAA,EAAAe,WAIH,CAAA,CAAA,CAAA,QAA8Bf,CAAY,CAAA,CAAA,CAAA,CAAAT,GAAA,CAAQU,UAAAA,CAAAA,CAChDgB,SAAQ,CAAAd,kBAAA,CAAA,CAAAF,EAAW,KAGpB,CAAA,CAAA,EAAA,CAAA,CAAA,CAAAiB,SAObC,CAAAA,CAAU,CAAA,CAAA,CAAA,CAAA,QAAc,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CACxBA,WAAqB/B,CAAAA,WAAAA,CAAAA,CAAAA,CAAAA,QAAAA,CAAAA,CAAAA","file":"index.js","sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n'use client';\n\nimport 'client-only';\nimport { createContext } from 'react';\nimport {\n  TextField as AriaTextField,\n  type ContextValue,\n  FieldError,\n  Text,\n  composeRenderProps,\n  useContextProps,\n} from 'react-aria-components';\n\nimport type { ProviderProps } from '@/lib/types';\nimport { Input } from '../input';\nimport { Label } from '../label';\nimport { TextFieldStyles } from './styles';\nimport type { TextFieldProps } from './types';\n\nconst { field, label, description, error } = TextFieldStyles();\n\nexport const TextFieldContext =\n  createContext<ContextValue<TextFieldProps, HTMLDivElement>>(null);\n\nfunction TextFieldProvider({\n  children,\n  ...props\n}: ProviderProps<TextFieldProps>) {\n  return (\n    <TextFieldContext.Provider value={props}>\n      {children}\n    </TextFieldContext.Provider>\n  );\n}\nTextFieldProvider.displayName = 'TextField.Provider';\n\nexport function TextField({ ref, ...props }: TextFieldProps) {\n  [props, ref] = useContextProps(props, ref ?? null, TextFieldContext);\n\n  const {\n    classNames,\n    description: descriptionProp,\n    errorMessage: errorMessageProp,\n    inputProps,\n    label: labelProp,\n    size = 'medium',\n    isInvalid: isInvalidProp,\n    ...rest\n  } = props;\n  const errorMessage = errorMessageProp || null; // Protect against empty string\n  const isSmall = size === 'small';\n\n  return (\n    <AriaTextField\n      {...rest}\n      ref={ref}\n      className={composeRenderProps(classNames?.field, (className) =>\n        field({ className }),\n      )}\n      isInvalid={isInvalidProp || (errorMessage ? true : undefined)} // Leave uncontrolled if possible to fallback to validation state\n      data-size={size}\n    >\n      {(\n        { isDisabled, isInvalid, isRequired }, // Rely on internal state, not props, since state could differ from props\n      ) => (\n        <>\n          {!!labelProp && !isSmall && (\n            <Label\n              className={label({ className: classNames?.label })}\n              isDisabled={isDisabled}\n              isRequired={isRequired}\n            >\n              {labelProp}\n            </Label>\n          )}\n          <Input\n            {...inputProps}\n            classNames={classNames?.input}\n            disabled={isDisabled}\n            required={isRequired}\n            size={size}\n            isInvalid={isInvalid}\n          />\n          {!!descriptionProp && !(isSmall || isInvalid) && (\n            <Text\n              slot='description'\n              className={description({ className: classNames?.description })}\n            >\n              {descriptionProp}\n            </Text>\n          )}\n          <FieldError\n            className={composeRenderProps(classNames?.error, (className) =>\n              error({ className }),\n            )}\n          >\n            {errorMessage}\n          </FieldError>\n        </>\n      )}\n    </AriaTextField>\n  );\n}\nTextField.displayName = 'TextField';\nTextField.Provider = TextFieldProvider;\n"]}
+{"version":3,"sources":["../../../src/components/text-field/index.tsx"],"names":["description","TextFieldStyles","TextFieldProvider","N","children","e","props","ref","L","rest","errorMessageProp","size","AriaTextField","composeRenderProps","classNames","className","field","c","isDisabled","isInvalid","isRequired","labelProp","isSmall","jsx","Label","label","g","inputProps","M","descriptionProp","I","error","errorMessage","TextField"],"mappings":"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","file":"index.js","sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n'use client';\n\nimport 'client-only';\nimport { createContext } from 'react';\nimport {\n  TextField as AriaTextField,\n  type ContextValue,\n  FieldError,\n  Text,\n  composeRenderProps,\n  useContextProps,\n} from 'react-aria-components';\n\nimport type { ProviderProps } from '@/lib/types';\nimport { Input } from '../input';\nimport { Label } from '../label';\nimport { TextFieldStyles } from './styles';\nimport type { TextFieldProps } from './types';\n\nconst { field, label, description, error } = TextFieldStyles();\n\nexport const TextFieldContext =\n  createContext<ContextValue<TextFieldProps, HTMLDivElement>>(null);\n\nfunction TextFieldProvider({\n  children,\n  ...props\n}: ProviderProps<TextFieldProps>) {\n  return (\n    <TextFieldContext.Provider value={props}>\n      {children}\n    </TextFieldContext.Provider>\n  );\n}\nTextFieldProvider.displayName = 'TextField.Provider';\n\n/**\n * TextField - A complete form field component with label, input, and validation\n *\n * Provides a comprehensive form field experience combining label, input, description,\n * and error message components. Handles validation states and accessibility\n * automatically while supporting extensive customization through styling props.\n *\n * @example\n * // Basic text field with label and required validation\n * <TextField label='Full Name' isRequired defaultValue='John Doe' />\n *\n * @example\n * // Text field with placeholder and description\n * <TextField\n *   label='Email Address'\n *   inputProps={{ placeholder: 'Enter your email address', type: 'email' }}\n *   description='We will never share your email with third parties'\n * />\n *\n * @example\n * // Text field with error state\n * <TextField\n *   label='Username'\n *   isInvalid\n *   errorMessage='Username must be at least 3 characters long'\n *   inputProps={{ placeholder: 'Enter username' }}\n * />\n *\n * @example\n * // Small size text field with clearable input\n * <TextField\n *   label='Search'\n *   size='small'\n *   inputProps={{\n *     placeholder: 'Type to search...',\n *     isClearable: true,\n *     type: 'search'\n *   }}\n * />\n *\n * @example\n * // Disabled text field\n * <TextField\n *   label='Status'\n *   isDisabled\n *   defaultValue='Inactive'\n *   description='This field cannot be edited'\n * />\n *\n * @example\n * // Password field with validation\n * <TextField\n *   label='Password'\n *   isRequired\n *   inputProps={{\n *     type: 'password',\n *     placeholder: 'Enter a secure password',\n *     minLength: 8\n *   }}\n *   description='Password must be at least 8 characters'\n * />\n */\nexport function TextField({ ref, ...props }: TextFieldProps) {\n  [props, ref] = useContextProps(props, ref ?? null, TextFieldContext);\n\n  const {\n    classNames,\n    description: descriptionProp,\n    errorMessage: errorMessageProp,\n    inputProps,\n    label: labelProp,\n    size = 'medium',\n    isInvalid: isInvalidProp,\n    ...rest\n  } = props;\n  const errorMessage = errorMessageProp || null; // Protect against empty string\n  const isSmall = size === 'small';\n\n  return (\n    <AriaTextField\n      {...rest}\n      ref={ref}\n      className={composeRenderProps(classNames?.field, (className) =>\n        field({ className }),\n      )}\n      isInvalid={isInvalidProp || (errorMessage ? true : undefined)} // Leave uncontrolled if possible to fallback to validation state\n      data-size={size}\n    >\n      {(\n        { isDisabled, isInvalid, isRequired }, // Rely on internal state, not props, since state could differ from props\n      ) => (\n        <>\n          {!!labelProp && !isSmall && (\n            <Label\n              className={label({ className: classNames?.label })}\n              isDisabled={isDisabled}\n              isRequired={isRequired}\n            >\n              {labelProp}\n            </Label>\n          )}\n          <Input\n            {...inputProps}\n            classNames={classNames?.input}\n            disabled={isDisabled}\n            required={isRequired}\n            size={size}\n            isInvalid={isInvalid}\n          />\n          {!!descriptionProp && !(isSmall || isInvalid) && (\n            <Text\n              slot='description'\n              className={description({ className: classNames?.description })}\n            >\n              {descriptionProp}\n            </Text>\n          )}\n          <FieldError\n            className={composeRenderProps(classNames?.error, (className) =>\n              error({ className }),\n            )}\n          >\n            {errorMessage}\n          </FieldError>\n        </>\n      )}\n    </AriaTextField>\n  );\n}\nTextField.displayName = 'TextField';\nTextField.Provider = TextFieldProvider;\n"]}

package/dist/components/text-field/styles.d.ts

@@ -6,9 +6,9 @@ declare const TextFieldStyles: tailwind_variants.TVReturnType<{
         [key: string]: tailwind_merge.ClassNameValue | {
             input?: tailwind_merge.ClassNameValue;
             label?: tailwind_merge.ClassNameValue;
-            error?: tailwind_merge.ClassNameValue;
             description?: tailwind_merge.ClassNameValue;
             field?: tailwind_merge.ClassNameValue;
+            error?: tailwind_merge.ClassNameValue;
         };
     };
 } | {
@@ -16,9 +16,9 @@ declare const TextFieldStyles: tailwind_variants.TVReturnType<{
         [x: string]: tailwind_merge.ClassNameValue | {
             input?: tailwind_merge.ClassNameValue;
             label?: tailwind_merge.ClassNameValue;
-            error?: tailwind_merge.ClassNameValue;
             description?: tailwind_merge.ClassNameValue;
             field?: tailwind_merge.ClassNameValue;
+            error?: tailwind_merge.ClassNameValue;
         };
     };
 } | {}, {
@@ -32,9 +32,9 @@ declare const TextFieldStyles: tailwind_variants.TVReturnType<{
         [key: string]: tailwind_merge.ClassNameValue | {
             input?: tailwind_merge.ClassNameValue;
             label?: tailwind_merge.ClassNameValue;
-            error?: tailwind_merge.ClassNameValue;
             description?: tailwind_merge.ClassNameValue;
             field?: tailwind_merge.ClassNameValue;
+            error?: tailwind_merge.ClassNameValue;
         };
     };
 } | {}, {

package/dist/components/text-field/types.d.ts

@@ -4,6 +4,7 @@ import { InputProps } from '../input/types.js';
 import { LabelProps } from '../label/types.js';
 import 'tailwind-variants';
 import '../button/types.js';
+import '../../lib/types.js';
 import '../button/styles.js';
 import 'tailwind-merge';
 import '../input/styles.js';

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

@@ -4,6 +4,48 @@ import { ContextValue } from 'react-aria-components';
 import { TooltipProps, TooltipTriggerProps, TooltipBodyProps } from './types.js';
 
 declare const TooltipContext: react.Context<ContextValue<TooltipProps, HTMLDivElement>>;
+/**
+ * Tooltip - A contextual popup component for providing additional information
+ *
+ * Displays helpful information when users hover over or focus on an element.
+ * Provides accessible tooltip functionality with proper positioning, keyboard
+ * navigation, and screen reader support for enhanced user experience.
+ *
+ * @example
+ * // Basic tooltip
+ * <Tooltip>
+ *   <Tooltip.Trigger>
+ *     <Button>Hover me</Button>
+ *   </Tooltip.Trigger>
+ *   <Tooltip.Body>
+ *     This is helpful information
+ *   </Tooltip.Body>
+ * </Tooltip>
+ *
+ * @example
+ * // Tooltip with custom positioning
+ * <Tooltip>
+ *   <Tooltip.Trigger>
+ *     <Button>Hover for info</Button>
+ *   </Tooltip.Trigger>
+ *   <Tooltip.Body placement="top" offset={10}>
+ *     Positioned above with custom offset
+ *   </Tooltip.Body>
+ * </Tooltip>
+ *
+ * @example
+ * // Icon with tooltip
+ * <Tooltip>
+ *   <Tooltip.Trigger>
+ *     <Button variant="icon">
+ *       <Icon><Info /></Icon>
+ *     </Button>
+ *   </Tooltip.Trigger>
+ *   <Tooltip.Body>
+ *     Additional context for this action
+ *   </Tooltip.Body>
+ * </Tooltip>
+ */
 declare function Tooltip({ ref, ...props }: TooltipProps): react_jsx_runtime.JSX.Element;
 declare namespace Tooltip {
     var displayName: string;

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/components/tooltip/index.tsx"],"names":["props","useContextProps","ref","TooltipContext","d","rest","m","Tooltip","jsx","AriaTooltipTrigger","n","g","children","u","TooltipTrigger","className","placement","c","y","f","offset","TooltipBody"],"mappings":"6TAiC0B,WAAc,CAAiB,CACvD,CAACA,GAAU,CAAA,CAAIC,CAAAA,GAAuBC,CAAAA,CAAAA,CAAO,CAAA,CAAA,CAAA,CAAA,CAAMC,CAAc,CAAAC,eAEjE,CAAA,CAAA,CAAA,CAAA,EAAQ,IAAA,CAAA,CAAA,CAAA,CAAA,KAAU,CAAGC,QAErB,CAAA,CAAA,CAAA,GAAsB,CACpB,CAAA,CAAA,CAAA,CAAA,OACAC,qBAAA,CAAA,CAAA,QAAA,CAAA,CAAA,CAAeC,aAAQ,CACvB,CAAA,CAAA,WAAc,CACZ,cAAgC,CAAE,CAAC,EACnC,GAAc,CAAE,CAAA,CAAA,GAAK,CAAG,IAAK,CAAE,CAAC,CAClC,CACF,GAEOC,CAAAA,CAACC,IAAoB,CAAA,CAAGJ,EAAO,CAAA,CAAA,CAAA,CAAAK,GAAA,CAAAC,cAAA,CAAA,CAAAC,GACxC,CACAL,SAAQ,CAAA,CAAA,CAAA,CAAA,CAAc,CAAA,CAAA,+BAEc,CAAA,CAAA,CAAGP,QACrC,CAAA,CAAA,CAAOQ,IAAC,CAAW,CAAA,CAAA,OAAWE,GAAA,CAAAG,SAAA,CAAA,CAAAD,GAChC,CACAE,SAAe,CAAA,CAAA,CAAA,CAAA,CAAc,CAAA,CAAA,WAAA,CAAA,2BAI3B,CAAA,CAAA,CAAA,QAAAC,CACA,CAAA,CAAA,SACA,CAAA,CAAA,CAAA,MAAA,CAAAC,EAAY,CAAA,CAAA,SACZ,CAAGhB,CACL,CAAA,QACE,CACEQ,IAAC,CACE,CAAA,CAAA,OACDE,GAAA,CAAAO,OAAA,CAAA,CAAA,GAA8BF,EAAYA,SACxB,CAAAG,kBAAA,CAAA,CAAA,CAAA,CAAA,EAAUC,aAAC,CAC7B,UACQC,CACR,WAAWJ,CAEV,CAAA,CAAA,SACH,CAEJ,CACAK,SAAY,CAAA,CAAA,CAAA,CAAA,CAAc,CAAA,CAAA,WAAA,CAAA,eAGlB,CAAA,CAAA,OAAOA,CAAAA,CAAAA,CAAAA,CAAAA,CAAAA,IAAAA,CAAAA,CAAAA","file":"index.js","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 { createContext } from 'react';\nimport 'client-only';\nimport { containsExactChildren } from '@/lib/react';\nimport {\n  Tooltip as AriaTooltip,\n  TooltipTrigger as AriaTooltipTrigger,\n  type ContextValue,\n  Focusable,\n  composeRenderProps,\n  useContextProps,\n} from 'react-aria-components';\nimport { TooltipStyles } from './styles';\nimport type {\n  TooltipBodyProps,\n  TooltipProps,\n  TooltipTriggerProps,\n} from './types';\n\nexport const TooltipContext =\n  createContext<ContextValue<TooltipProps, HTMLDivElement>>(null);\n\nexport function Tooltip({ ref, ...props }: TooltipProps) {\n  [props, ref] = useContextProps(props, ref ?? null, TooltipContext);\n\n  const { children, ...rest } = props;\n\n  containsExactChildren({\n    children,\n    componentName: Tooltip.displayName,\n    restrictions: [\n      [TooltipTrigger, { min: 1, max: 1 }],\n      [TooltipBody, { min: 1, max: 1 }],\n    ],\n  });\n\n  return <AriaTooltipTrigger {...rest}>{children}</AriaTooltipTrigger>;\n}\nTooltip.displayName = 'Tooltip';\n\nfunction TooltipTrigger({ children, ...props }: TooltipTriggerProps) {\n  return <Focusable {...props}>{children}</Focusable>;\n}\nTooltipTrigger.displayName = 'Tooltip.Trigger';\n\nfunction TooltipBody({\n  children,\n  className,\n  offset = 5,\n  placement = 'bottom',\n  ...props\n}: TooltipBodyProps) {\n  return (\n    <AriaTooltip\n      {...props}\n      className={composeRenderProps(className, (className) =>\n        TooltipStyles({ className }),\n      )}\n      offset={offset}\n      placement={placement}\n    >\n      {children}\n    </AriaTooltip>\n  );\n}\nTooltipBody.displayName = 'Tooltip.Body';\n\nTooltip.Trigger = TooltipTrigger;\nTooltip.Body = TooltipBody;\n"]}
+{"version":3,"sources":["../../../src/components/tooltip/index.tsx"],"names":["props","useContextProps","ref","TooltipContext","d","rest","m","Tooltip","jsx","AriaTooltipTrigger","n","g","children","u","TooltipTrigger","className","placement","c","y","f","offset","TooltipBody"],"mappings":"6TA2E0B,WAAc,CAAiB,CACvD,CAACA,GAAU,CAAA,CAAIC,CAAAA,GAAuBC,CAAAA,CAAAA,CAAO,CAAA,CAAA,CAAA,CAAA,CAAMC,CAAc,CAAAC,eAEjE,CAAA,CAAA,CAAA,CAAA,EAAQ,IAAA,CAAA,CAAA,CAAA,CAAA,KAAU,CAAGC,QAErB,CAAA,CAAA,CAAA,GAAsB,CACpB,CAAA,CAAA,CAAA,CAAA,OACAC,qBAAA,CAAA,CAAA,QAAA,CAAA,CAAA,CAAeC,aAAQ,CACvB,CAAA,CAAA,WAAc,CACZ,cAAgC,CAAE,CAAC,EACnC,GAAc,CAAE,CAAA,CAAA,GAAK,CAAG,IAAK,CAAE,CAAC,CAClC,CACF,GAEOC,CAAAA,CAACC,IAAoB,CAAA,CAAGJ,EAAO,CAAA,CAAA,CAAA,CAAAK,GAAA,CAAAC,cAAA,CAAA,CAAAC,GACxC,CACAL,SAAQ,CAAA,CAAA,CAAA,CAAA,CAAc,CAAA,CAAA,+BAEc,CAAA,CAAA,CAAGP,QACrC,CAAA,CAAA,CAAOQ,IAAC,CAAW,CAAA,CAAA,OAAWE,GAAA,CAAAG,SAAA,CAAA,CAAAD,GAChC,CACAE,SAAe,CAAA,CAAA,CAAA,CAAA,CAAc,CAAA,CAAA,WAAA,CAAA,2BAI3B,CAAA,CAAA,CAAA,QAAAC,CACA,CAAA,CAAA,SACA,CAAA,CAAA,CAAA,MAAA,CAAAC,EAAY,CAAA,CAAA,SACZ,CAAGhB,CACL,CAAA,QACE,CACEQ,IAAC,CACE,CAAA,CAAA,OACDE,GAAA,CAAAO,OAAA,CAAA,CAAA,GAA8BF,EAAYA,SACxB,CAAAG,kBAAA,CAAA,CAAA,CAAA,CAAA,EAAUC,aAAC,CAC7B,UACQC,CACR,WAAWJ,CAEV,CAAA,CAAA,SACH,CAEJ,CACAK,SAAY,CAAA,CAAA,CAAA,CAAA,CAAc,CAAA,CAAA,WAAA,CAAA,eAGlB,CAAA,CAAA,OAAOA,CAAAA,CAAAA,CAAAA,CAAAA,CAAAA,IAAAA,CAAAA,CAAAA","file":"index.js","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 { createContext } from 'react';\nimport 'client-only';\nimport { containsExactChildren } from '@/lib/react';\nimport {\n  Tooltip as AriaTooltip,\n  TooltipTrigger as AriaTooltipTrigger,\n  type ContextValue,\n  Focusable,\n  composeRenderProps,\n  useContextProps,\n} from 'react-aria-components';\nimport { TooltipStyles } from './styles';\nimport type {\n  TooltipBodyProps,\n  TooltipProps,\n  TooltipTriggerProps,\n} from './types';\n\nexport const TooltipContext =\n  createContext<ContextValue<TooltipProps, HTMLDivElement>>(null);\n\n/**\n * Tooltip - A contextual popup component for providing additional information\n *\n * Displays helpful information when users hover over or focus on an element.\n * Provides accessible tooltip functionality with proper positioning, keyboard\n * navigation, and screen reader support for enhanced user experience.\n *\n * @example\n * // Basic tooltip\n * <Tooltip>\n *   <Tooltip.Trigger>\n *     <Button>Hover me</Button>\n *   </Tooltip.Trigger>\n *   <Tooltip.Body>\n *     This is helpful information\n *   </Tooltip.Body>\n * </Tooltip>\n *\n * @example\n * // Tooltip with custom positioning\n * <Tooltip>\n *   <Tooltip.Trigger>\n *     <Button>Hover for info</Button>\n *   </Tooltip.Trigger>\n *   <Tooltip.Body placement=\"top\" offset={10}>\n *     Positioned above with custom offset\n *   </Tooltip.Body>\n * </Tooltip>\n *\n * @example\n * // Icon with tooltip\n * <Tooltip>\n *   <Tooltip.Trigger>\n *     <Button variant=\"icon\">\n *       <Icon><Info /></Icon>\n *     </Button>\n *   </Tooltip.Trigger>\n *   <Tooltip.Body>\n *     Additional context for this action\n *   </Tooltip.Body>\n * </Tooltip>\n */\nexport function Tooltip({ ref, ...props }: TooltipProps) {\n  [props, ref] = useContextProps(props, ref ?? null, TooltipContext);\n\n  const { children, ...rest } = props;\n\n  containsExactChildren({\n    children,\n    componentName: Tooltip.displayName,\n    restrictions: [\n      [TooltipTrigger, { min: 1, max: 1 }],\n      [TooltipBody, { min: 1, max: 1 }],\n    ],\n  });\n\n  return <AriaTooltipTrigger {...rest}>{children}</AriaTooltipTrigger>;\n}\nTooltip.displayName = 'Tooltip';\n\nfunction TooltipTrigger({ children, ...props }: TooltipTriggerProps) {\n  return <Focusable {...props}>{children}</Focusable>;\n}\nTooltipTrigger.displayName = 'Tooltip.Trigger';\n\nfunction TooltipBody({\n  children,\n  className,\n  offset = 5,\n  placement = 'bottom',\n  ...props\n}: TooltipBodyProps) {\n  return (\n    <AriaTooltip\n      {...props}\n      className={composeRenderProps(className, (className) =>\n        TooltipStyles({ className }),\n      )}\n      offset={offset}\n      placement={placement}\n    >\n      {children}\n    </AriaTooltip>\n  );\n}\nTooltipBody.displayName = 'Tooltip.Body';\n\nTooltip.Trigger = TooltipTrigger;\nTooltip.Body = TooltipBody;\n"]}

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

@@ -0,0 +1,9 @@
+declare const ViewStackEventNamespace = "ViewStack";
+declare const ViewStackEventTypes: {
+    readonly back: "ViewStack:back";
+    readonly clear: "ViewStack:clear";
+    readonly reset: "ViewStack:reset";
+    readonly push: "ViewStack:push";
+};
+
+export { ViewStackEventNamespace, ViewStackEventTypes };

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

@@ -0,0 +1,2 @@
+const e="ViewStack",t={back:`${e}:back`,clear:`${e}:clear`,reset:`${e}:reset`,push:`${e}:push`};export{e as ViewStackEventNamespace,t as ViewStackEventTypes};//# sourceMappingURL=events.js.map
+//# sourceMappingURL=events.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/components/view-stack/events.ts"],"names":["ViewStackEventNamespace","ViewStackEventTypes"],"mappings":"AAYO,MAAMA,EAA0B,WAAA,CAE1BC,CAAAA,CAAsB,CACjC,IAAA,CAAM,CAAA,EAAGD,CAAuB,CAAA,KAAA,CAAA,CAChC,KAAA,CAAO,GAAGA,CAAuB,CAAA,MAAA,CAAA,CACjC,MAAO,CAAA,EAAGA,CAAuB,SACjC,IAAA,CAAM,CAAA,EAAGA,CAAuB,CAAA,KAAA,CAClC","file":"events.js","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\nexport const ViewStackEventNamespace = 'ViewStack';\n\nexport const ViewStackEventTypes = {\n  back: `${ViewStackEventNamespace}:back`,\n  clear: `${ViewStackEventNamespace}:clear`,\n  reset: `${ViewStackEventNamespace}:reset`,\n  push: `${ViewStackEventNamespace}:push`,\n} as const;\n"]}

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

@@ -0,0 +1,31 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as react from 'react';
+import { UniqueId } from '@accelint/core';
+import { ViewStackProps, ViewStackViewProps, ViewStackTriggerProps, ViewStackContextValue } from './types.js';
+import '@accelint/bus';
+import 'react-aria-components';
+import './events.js';
+
+declare const ViewStackContext: react.Context<ViewStackContextValue>;
+declare const ViewStackEventHandlers: {
+    readonly back: (stack: UniqueId) => void;
+    readonly clear: (stack: UniqueId) => void;
+    readonly push: (view: UniqueId) => void;
+    readonly reset: (stack: UniqueId) => void;
+};
+declare function ViewStackTrigger({ children, for: types }: ViewStackTriggerProps): react_jsx_runtime.JSX.Element;
+declare namespace ViewStackTrigger {
+    var displayName: string;
+}
+declare function ViewStackView({ id, children }: ViewStackViewProps): react.ReactNode;
+declare namespace ViewStackView {
+    var displayName: string;
+}
+declare function ViewStack({ id, children, defaultView, onChange, }: ViewStackProps): react_jsx_runtime.JSX.Element;
+declare namespace ViewStack {
+    var displayName: string;
+    var View: typeof ViewStackView;
+    var Trigger: typeof ViewStackTrigger;
+}
+
+export { ViewStack, ViewStackContext, ViewStackEventHandlers };

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

@@ -0,0 +1,2 @@
+import {jsx}from'react/jsx-runtime';import'client-only';import {Broadcast}from'@accelint/bus';import {isUUID}from'@accelint/core';import {createContext,useRef,useState,useCallback,useEffect,useContext}from'react';import {Pressable}from'react-aria-components';import {ViewStackEventTypes}from'./events.js';const u=Broadcast.getInstance(),p=createContext({parent:null,stack:[],view:null,register:()=>{},unregister:()=>{}}),T={back:e=>u.emit(ViewStackEventTypes.back,{stack:e}),clear:e=>u.emit(ViewStackEventTypes.clear,{stack:e}),push:e=>u.emit(ViewStackEventTypes.push,{view:e}),reset:e=>u.emit(ViewStackEventTypes.reset,{stack:e})};function P({children:e,for:k}){const{parent:r}=useContext(p);function i(){for(const n of Array.isArray(k)?k:[k]){let[s,a]=isUUID(n)?["push",n]:n.split(":");a??=r,a&&T[s](a);}}return jsx(Pressable,{onPress:i,children:e})}P.displayName="ViewStack.Trigger";function y({id:e,children:k}){const{parent:r,view:i,register:n,unregister:s}=useContext(p);if(!r)throw new Error("ViewStack.View must be implemented within a ViewStack");if(!isUUID(e))throw new Error("ViewStack.View's id must be a UniqueId");return useEffect(()=>{n(e);},[n,s,e]),i===e?k:null}y.displayName="ViewStack.View";function S({id:e,children:k,defaultView:r,onChange:i}){if(!isUUID(e))throw new Error("ViewStack's id must be a UniqueId");const n=useRef(new Set),[s,a]=useState(r?[r]:[]),U=s.at(-1)??null,V=useCallback(t=>{if(e===t?.payload?.stack){const c=s.slice(0,-1);!c.length&&r&&c.push(r),a(c),i?.(c.at(-1)??null);}},[e,r,i,s]),f=useCallback(t=>{e===t?.payload?.stack&&(a([]),i?.(null));},[e,i]),m=useCallback(t=>{n.current.has(t?.payload?.view)&&(a(c=>[...c,t?.payload?.view]),i?.(t?.payload?.view));},[i]),v=useCallback(t=>{e===t?.payload?.stack&&(a(r?[r]:[]),i?.(r??null));},[e,r,i]);return useEffect(()=>{const t=[u.on(ViewStackEventTypes.back,V),u.on(ViewStackEventTypes.clear,f),u.on(ViewStackEventTypes.push,m),u.on(ViewStackEventTypes.reset,v)];return ()=>{for(const c of t)c();}},[V,f,m,v]),jsx(p.Provider,{value:{parent:e,stack:s,view:U,register:t=>n.current.add(t),unregister:t=>n.current.delete(t)},children:k})}S.displayName="ViewStack",S.View=y,S.Trigger=P;export{S as ViewStack,p as ViewStackContext,T as ViewStackEventHandlers};//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/components/view-stack/index.tsx"],"names":["Broadcast","h","ViewStackContext","createContext","q","ViewStackEventHandlers","bus","o","types","useContext","d","type","event","isUUID","l","id","parent","I","x","ViewStackTrigger","E","register","unregister","view","b","stack","setStack","useState","defaultView","g","useCallback","data","next","onChange","handleClear","handlePush","views","prev","handleReset","ViewStackEventTypes","off","listeners","handleBack","jsx","ViewStack"],"mappings":"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","file":"index.js","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 { Broadcast } from '@accelint/bus';\nimport { type UniqueId, isUUID } from '@accelint/core';\nimport {\n  createContext,\n  useCallback,\n  useContext,\n  useEffect,\n  useRef,\n  useState,\n} from 'react';\nimport { Pressable } from 'react-aria-components';\nimport { ViewStackEventTypes } from './events';\nimport type {\n  ViewStackBackEvent,\n  ViewStackClearEvent,\n  ViewStackContextValue,\n  ViewStackEvent,\n  ViewStackProps,\n  ViewStackPushEvent,\n  ViewStackResetEvent,\n  ViewStackTriggerProps,\n  ViewStackViewProps,\n} from './types';\n\nconst bus = Broadcast.getInstance<ViewStackEvent>();\n\nexport const ViewStackContext = createContext<ViewStackContextValue>({\n  parent: null,\n  stack: [],\n  view: null,\n  register: () => undefined,\n  unregister: () => undefined,\n});\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\nfunction ViewStackTrigger({ children, for: types }: ViewStackTriggerProps) {\n  const { parent } = useContext(ViewStackContext);\n\n  function handlePress() {\n    for (const type of Array.isArray(types) ? types : [types]) {\n      let [event, id] = (isUUID(type) ? ['push', type] : type.split(':')) as [\n        'back' | 'clear' | 'reset' | 'push',\n        UniqueId | undefined | null,\n      ];\n\n      id ??= parent;\n\n      if (!id) {\n        continue;\n      }\n\n      ViewStackEventHandlers[event](id);\n    }\n  }\n\n  return <Pressable onPress={handlePress}>{children}</Pressable>;\n}\nViewStackTrigger.displayName = 'ViewStack.Trigger';\n\nfunction ViewStackView({ id, children }: ViewStackViewProps) {\n  const { parent, view, register, unregister } = useContext(ViewStackContext);\n\n  if (!parent) {\n    throw new Error('ViewStack.View must be implemented within a ViewStack');\n  }\n\n  if (!isUUID(id)) {\n    throw new Error(`ViewStack.View's id must be a UniqueId`);\n  }\n\n  useEffect(() => {\n    register(id);\n\n    () => unregister(id);\n  }, [register, unregister, id]);\n\n  return view === id ? children : null;\n}\nViewStackView.displayName = 'ViewStack.View';\n\nexport function ViewStack({\n  id,\n  children,\n  defaultView,\n  onChange,\n}: ViewStackProps) {\n  if (!isUUID(id)) {\n    throw new Error(`ViewStack's id must be a UniqueId`);\n  }\n\n  const views = useRef(new Set<UniqueId>());\n  const [stack, setStack] = useState<UniqueId[]>(\n    defaultView ? [defaultView] : [],\n  );\n  const view = stack.at(-1) ?? null;\n\n  const handleBack = useCallback(\n    (data: ViewStackBackEvent) => {\n      if (id === data?.payload?.stack) {\n        const next = stack.slice(0, -1);\n\n        if (!next.length && defaultView) {\n          next.push(defaultView);\n        }\n\n        setStack(next);\n        onChange?.(next.at(-1) ?? null);\n      }\n    },\n    [id, defaultView, onChange, stack],\n  );\n\n  const handleClear = useCallback(\n    (data: ViewStackClearEvent) => {\n      if (id === data?.payload?.stack) {\n        setStack([]);\n        onChange?.(null);\n      }\n    },\n    [id, onChange],\n  );\n\n  const handlePush = useCallback(\n    (data: ViewStackPushEvent) => {\n      if (views.current.has(data?.payload?.view)) {\n        setStack((prev) => [...prev, data?.payload?.view]);\n        onChange?.(data?.payload?.view);\n      }\n    },\n    [onChange],\n  );\n\n  const handleReset = useCallback(\n    (data: ViewStackResetEvent) => {\n      if (id === data?.payload?.stack) {\n        setStack(defaultView ? [defaultView] : []);\n        onChange?.(defaultView ?? null);\n      }\n    },\n    [id, defaultView, onChange],\n  );\n\n  useEffect(() => {\n    const listeners = [\n      bus.on(ViewStackEventTypes.back, handleBack),\n      bus.on(ViewStackEventTypes.clear, handleClear),\n      bus.on(ViewStackEventTypes.push, handlePush),\n      bus.on(ViewStackEventTypes.reset, handleReset),\n    ];\n\n    return () => {\n      for (const off of listeners) {\n        off();\n      }\n    };\n  }, [handleBack, handleClear, handlePush, handleReset]);\n\n  return (\n    <ViewStackContext.Provider\n      value={{\n        parent: id,\n        stack,\n        view,\n        register: (view: UniqueId) => views.current.add(view),\n        unregister: (view: UniqueId) => views.current.delete(view),\n      }}\n    >\n      {children}\n    </ViewStackContext.Provider>\n  );\n}\nViewStack.displayName = 'ViewStack';\nViewStack.View = ViewStackView;\nViewStack.Trigger = ViewStackTrigger;\n"]}

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

@@ -0,0 +1,62 @@
+import { Payload } from '@accelint/bus';
+import { UniqueId } from '@accelint/core';
+import { RefAttributes, PropsWithChildren, ComponentProps } from 'react';
+import { Pressable } from 'react-aria-components';
+import { ViewStackEventTypes } from './events.js';
+
+type ViewStackProps = RefAttributes<HTMLDivElement> & PropsWithChildren<{
+    id: UniqueId;
+    defaultView?: UniqueId;
+    onChange?: (view: UniqueId | null) => void;
+}>;
+type ViewStackViewProps = RefAttributes<HTMLDivElement> & PropsWithChildren<{
+    id: UniqueId;
+}>;
+type ViewStackBackEvent = Payload<typeof ViewStackEventTypes.back, {
+    stack: UniqueId;
+}>;
+type ViewStackClearEvent = Payload<typeof ViewStackEventTypes.clear, {
+    stack: UniqueId;
+}>;
+type ViewStackResetEvent = Payload<typeof ViewStackEventTypes.reset, {
+    stack: UniqueId;
+}>;
+type ViewStackPushEvent = Payload<typeof ViewStackEventTypes.push, {
+    view: UniqueId;
+}>;
+type ViewStackEvent = ViewStackBackEvent | ViewStackClearEvent | ViewStackResetEvent | ViewStackPushEvent;
+type SimpleEvents = 'back' | 'clear' | 'reset' | UniqueId;
+type TargetedEvents = `back:${UniqueId}` | `clear:${UniqueId}` | `reset:${UniqueId}`;
+type ChainedEvents = (SimpleEvents | TargetedEvents)[];
+type ViewStackTriggerProps = {
+    children: ComponentProps<typeof Pressable>['children'];
+    /**
+     * __SimpleEvents__ allow the easiest implementation of events, but come with some restrictions:
+     * - The literal commands `back | clear | reset` will only work inside of the context of a ViewStack
+     * - When passing a view's UniqueId the behavior is always to push that id onto it's parent's stack
+     *
+     * __TargetedEvents__ allow for external control of a ViewStack, the UniqueId of a Stack is passed to know which stack to affect
+     *
+     * __ChainedEvents__ allow a list of events from a single control to enable multiple behaviors
+     *
+     * @example
+     * // Clear a stack and then push a view on:
+     * ['clear', myViewId]
+     *
+     * // Reset multiple stacks:
+     * [`reset:${stackOneId}`, `reset:${stackTwoId}`]
+     *
+     * // Hydrate a stack with multiple views:
+     * [viewOneId, viewTwoId, viewThreeId]
+     */
+    for: SimpleEvents | TargetedEvents | ChainedEvents;
+};
+type ViewStackContextValue = {
+    parent: UniqueId | null;
+    stack: string[];
+    view: UniqueId | null;
+    register: (view: UniqueId) => void;
+    unregister: (view: UniqueId) => void;
+};
+
+export type { ViewStackBackEvent, ViewStackClearEvent, ViewStackContextValue, ViewStackEvent, ViewStackProps, ViewStackPushEvent, ViewStackResetEvent, ViewStackTriggerProps, ViewStackViewProps };

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

@@ -0,0 +1,2 @@
+//# sourceMappingURL=types.js.map
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"types.js"}