@chassis-ui/react 0.2.0 → 0.3.0

package/src/components/collapse/Collapse.tsx

@@ -1,128 +0,0 @@
-import React, { forwardRef, HTMLAttributes, useRef, useState } from 'react'
-import classNames from 'classnames'
-import { CSSTransition } from 'react-transition-group'
-
-import { useForkedRef } from '../../hooks'
-
-export interface CollapseProps extends HTMLAttributes<HTMLDivElement> {
-  /**
-   * A string of all className you want applied to the base component.
-   */
-  className?: string
-  /**
-   * Set horizontal collapsing to transition the width instead of height.
-   */
-  horizontal?: boolean
-  /**
-   * Callback fired when the component requests to be hidden.
-   */
-  onHide?: () => void
-  /**
-   * Callback fired when the component requests to be shown.
-   */
-  onShow?: () => void
-  /**
-   * Toggle the visibility of component.
-   */
-  visible?: boolean
-}
-
-export const Collapse = forwardRef<HTMLDivElement, CollapseProps>(
-  ({ children, className, horizontal, onHide, onShow, visible, ...rest }, ref) => {
-    const [height, setHeight] = useState<number>()
-    const [width, setWidth] = useState<number>()
-    const collapseRef = useRef<HTMLDivElement>(null)
-    const forkedRef = useForkedRef(ref, collapseRef)
-
-    const getTransitionClass = (state: string) => {
-      return state === 'entering'
-        ? 'collapsing'
-        : state === 'entered'
-          ? 'collapse show'
-          : state === 'exiting'
-            ? 'collapsing'
-            : 'collapse'
-    }
-
-    const onEntering = () => {
-      onShow && onShow()
-
-      if (horizontal) {
-        collapseRef.current && setWidth(collapseRef.current.scrollWidth)
-        return
-      }
-      collapseRef.current && setHeight(collapseRef.current.scrollHeight)
-    }
-
-    const onEntered = () => {
-      if (horizontal) {
-        setWidth(0)
-        return
-      }
-      setHeight(0)
-    }
-
-    const onExit = () => {
-      if (horizontal) {
-        collapseRef.current && setWidth(collapseRef.current.scrollWidth)
-        return
-      }
-      collapseRef.current && setHeight(collapseRef.current.scrollHeight)
-    }
-
-    const onExiting = () => {
-      onHide && onHide()
-      if (horizontal) {
-        setWidth(0)
-        return
-      }
-      setHeight(0)
-    }
-
-    const onExited = () => {
-      if (horizontal) {
-        setWidth(0)
-        return
-      }
-      setHeight(0)
-    }
-
-    const _className = classNames(
-      {
-        'collapse-horizontal': horizontal
-      },
-      className
-    )
-
-    return (
-      <CSSTransition
-        in={visible}
-        nodeRef={collapseRef}
-        onEntering={onEntering}
-        onEntered={onEntered}
-        onExit={onExit}
-        onExiting={onExiting}
-        onExited={onExited}
-        timeout={350}
-      >
-        {(state) => {
-          const transitionClass = getTransitionClass(state)
-          const currentHeight = height === 0 ? null : { height }
-          const currentWidth = width === 0 ? null : { width }
-          return (
-            <div
-              className={classNames(_className, transitionClass)}
-              style={{ ...currentHeight, ...currentWidth }}
-              {...rest}
-              ref={forkedRef}
-            >
-              {children}
-            </div>
-          )
-        }}
-      </CSSTransition>
-    )
-  }
-)
-
-Collapse.displayName = 'Collapse'

package/src/components/collapse/index.ts

@@ -1,6 +0,0 @@
-'use client'
-
-import '../../utils/suppressFocusRingGlobally'
-
-export { Collapse } from './Collapse'
-export type { CollapseProps } from './Collapse'

package/src/components/color-input/ColorInput.tsx

@@ -1,106 +0,0 @@
-import React, { ChangeEventHandler, forwardRef, InputHTMLAttributes, ReactNode } from 'react'
-import classNames from 'classnames'
-
-import { useFormField } from '../../hooks'
-import { validationClassName } from '../../utils/validationClassName'
-import { renderFormField } from '../form-field/renderFormField'
-
-export interface ColorInputProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'size'> {
-  /**
-   * A string of all className you want applied to the component.
-   */
-  className?: string
-  /**
-   * The value of the input, uncontrolled.
-   */
-  defaultValue?: string
-  /**
-   * Toggle the disabled state for the component.
-   */
-  disabled?: boolean
-  /**
-   * A description for the field, rendered below the input.
-   */
-  help?: ReactNode
-  /**
-   * Set component validation state to invalid.
-   */
-  invalid?: boolean
-  /**
-   * An error message for the field, rendered below the input when `invalid` is set.
-   */
-  invalidFeedback?: ReactNode
-  /**
-   * The field's caption, rendered as a `FormLabel` associated with this input.
-   */
-  label?: ReactNode
-  /**
-   * Method called immediately after the `value` prop changes.
-   */
-  onChange?: ChangeEventHandler<HTMLInputElement>
-  /**
-   * Size the component sm or lg.
-   */
-  size?: 'sm' | 'lg'
-  /**
-   * Set component validation state to valid.
-   */
-  valid?: boolean
-  /**
-   * A success message for the field, rendered below the input when `valid` is set.
-   */
-  validFeedback?: ReactNode
-  /**
-   * The `value` attribute of component.
-   *
-   * @controllable onChange
-   * */
-  value?: string
-}
-
-export const ColorInput = forwardRef<HTMLInputElement, ColorInputProps>(
-  (
-    { className, help, id, invalid, invalidFeedback, label, size, valid, validFeedback, ...rest },
-    ref
-  ) => {
-    const { describedBy, feedbackId, helpId, inputId } = useFormField({
-      ariaDescribedBy: rest['aria-describedby'],
-      help,
-      id,
-      invalid,
-      invalidFeedback,
-      valid,
-      validFeedback
-    })
-
-    const _className = classNames(
-      'form-input',
-      size,
-      validationClassName(invalid, valid),
-      className
-    )
-
-    return renderFormField({
-      children: (
-        <input
-          {...rest}
-          aria-describedby={describedBy}
-          aria-invalid={invalid || undefined}
-          className={_className}
-          id={inputId}
-          ref={ref}
-          type="color"
-        />
-      ),
-      help,
-      ids: { feedback: feedbackId, help: helpId, input: inputId },
-      invalid,
-      invalidFeedback,
-      label,
-      valid,
-      validFeedback
-    })
-  }
-)
-
-ColorInput.displayName = 'ColorInput'

package/src/components/color-input/index.ts

@@ -1,6 +0,0 @@
-'use client'
-
-import '../../utils/suppressFocusRingGlobally'
-
-export { ColorInput } from './ColorInput'
-export type { ColorInputProps } from './ColorInput'

package/src/components/combobox/Combobox.tsx

@@ -1,320 +0,0 @@
-import React, {
-  forwardRef,
-  HTMLAttributes,
-  InputHTMLAttributes,
-  ReactNode,
-  useId,
-  useMemo,
-  useRef
-} from 'react'
-import { createPortal } from 'react-dom'
-import classNames from 'classnames'
-import { useComboBox, useFilter, useOverlayPosition } from 'react-aria'
-import { Key, useComboBoxState } from 'react-stately'
-
-import { useFloatingOverlay, useForkedRef, useFormField } from '../../hooks'
-import {
-  buildEntriesFromChildren,
-  buildEntriesFromItemsDef,
-  ComboboxEntry,
-  comboboxCollectionChildren,
-  getDisabledKeys
-} from '../../utils/comboboxCollection'
-import {
-  COMBOBOX_MENU_OVERLAY_STYLE,
-  resolveMenuOverlayPositioning,
-  toAriaPlacement
-} from '../../utils/overlayPlacement'
-import { validationClassName } from '../../utils/validationClassName'
-import { renderFormField } from '../form-field/renderFormField'
-import { MenuItemsDef } from '../menu/MenuItemDef'
-import { ComboboxGroup } from './ComboboxGroup'
-import { ComboboxItem } from './ComboboxItem'
-import { ComboboxListBox } from './ComboboxListBox'
-
-export interface ComboboxProps extends Omit<
-  HTMLAttributes<HTMLDivElement>,
-  'onChange' | 'defaultValue'
-> {
-  /**
-   * An accessible label for the combobox, used when there's no visible `<label>`.
-   */
-  'aria-label'?: string
-  /**
-   * Identifies a visible `<label>` element for the combobox.
-   */
-  'aria-labelledby'?: string
-  /**
-   * `ComboboxItem` elements, optionally wrapped in `ComboboxGroup` — read as data by
-   * `Combobox` to build the option list. Not rendered directly. Ignored when `items` is set.
-   */
-  children?: ReactNode
-  /**
-   * A string of all className you want applied to the base component.
-   */
-  className?: string
-  /**
-   * The initial selected option's id (uncontrolled).
-   */
-  defaultValue?: Key | null
-  /**
-   * Prevents the combobox from being focused or interacted with.
-   */
-  disabled?: boolean
-  /**
-   * A description for the field, rendered below the combobox.
-   */
-  help?: ReactNode
-  /**
-   * `id` forwarded to the input element — useful for pairing with a `<label for>`.
-   */
-  id?: string
-  /**
-   * Set component validation state to invalid.
-   */
-  invalid?: boolean
-  /**
-   * An error message for the field, rendered below the combobox when `invalid` is set.
-   */
-  invalidFeedback?: ReactNode
-  /**
-   * Array of item/header/divider definitions for data-driven rendering. When provided, children
-   * are ignored. A `'header'` entry starts a group that all following items join until the next
-   * header or the end of the array. `'divider'` entries are a no-op here (dividers aren't
-   * meaningful for a listbox/option collection) — use `ComboboxGroup` composition instead if
-   * you need finer control over grouping. An entry's `href`/`onClick` are `Menu`-only and are not
-   * read here — use `onChange` to react to the selection instead.
-   */
-  items?: MenuItemsDef
-  /**
-   * The field's caption, rendered as a `FormLabel` associated with the input.
-   */
-  label?: ReactNode
-  /**
-   * `name` of an auto-created hidden input, kept in sync with the selection, for native form
-   * submission. Omit to skip creating one.
-   */
-  name?: string
-  /**
-   * Text shown in the listbox when no options match the current query.
-   */
-  noResultsText?: ReactNode
-  /**
-   * Callback fired when the selected option changes.
-   */
-  onChange?: (value: Key | null) => void
-  /**
-   * Placeholder shown in the input when nothing is selected.
-   */
-  placeholder?: string
-  /**
-   * Size the component sm or lg.
-   */
-  size?: 'sm' | 'lg'
-  /**
-   * Set component validation state to valid.
-   */
-  valid?: boolean
-  /**
-   * A success message for the field, rendered below the combobox when `valid` is set.
-   */
-  validFeedback?: ReactNode
-  /**
-   * The selected option's id (controlled).
-   */
-  value?: Key | null
-}
-
-export const Combobox = forwardRef<HTMLDivElement, ComboboxProps>(
-  (
-    {
-      'aria-describedby': ariaDescribedBy,
-      'aria-label': ariaLabel,
-      'aria-labelledby': ariaLabelledBy,
-      children,
-      className,
-      defaultValue,
-      disabled,
-      help,
-      id,
-      invalid,
-      invalidFeedback,
-      items,
-      label,
-      name,
-      noResultsText = 'No results found',
-      onChange,
-      placeholder,
-      size,
-      valid,
-      validFeedback,
-      value,
-      ...rest
-    }: ComboboxProps,
-    ref
-  ): ReactNode => {
-    // `entries`/`disabledKeys` only need to change when the data driving them does — without this,
-    // both re-derive from scratch on every render, including every keystroke while typing.
-    const entries = useMemo(
-      () =>
-        items
-          ? buildEntriesFromItemsDef(items)
-          : buildEntriesFromChildren(children, { Group: ComboboxGroup, Item: ComboboxItem }),
-      [items, children]
-    )
-    const disabledKeys = useMemo(() => getDisabledKeys(entries), [entries])
-
-    // Case- and accent-insensitive substring matching, mirroring chassis-css's own
-    // always-case-insensitive combobox.js filtering.
-    const { contains } = useFilter({ sensitivity: 'base' })
-
-    const state = useComboBoxState<ComboboxEntry>({
-      children: comboboxCollectionChildren,
-      defaultItems: entries,
-      disabledKeys,
-      defaultFilter: contains,
-      defaultValue,
-      value,
-      onChange,
-      allowsEmptyCollection: true,
-      // Matches chassis-css's vanilla combobox.js: the menu opens on focus, not only once the
-      // user starts typing.
-      menuTrigger: 'focus'
-    })
-
-    const wrapperRef = useRef<HTMLDivElement>(null)
-    const forkedWrapperRef = useForkedRef(ref, wrapperRef)
-    const inputRef = useRef<HTMLInputElement>(null)
-    const listBoxRef = useRef<HTMLElement>(null)
-    const popoverRef = useRef<HTMLDivElement>(null)
-    const noResultsId = useId()
-
-    const { describedBy, feedbackId, helpId, inputId, labelId, labelledBy } = useFormField({
-      ariaDescribedBy,
-      ariaLabelledBy,
-      help,
-      id,
-      invalid,
-      invalidFeedback,
-      label,
-      valid,
-      validFeedback
-    })
-
-    const { inputProps, listBoxProps } = useComboBox<ComboboxEntry>(
-      {
-        'aria-label': ariaLabel,
-        'aria-labelledby': labelledBy,
-        id: inputId,
-        inputRef,
-        listBoxRef,
-        popoverRef,
-        isDisabled: disabled,
-        placeholder
-      },
-      state
-    )
-
-    const { overlayProps, placement: resolvedPlacement } = useOverlayPosition({
-      targetRef: wrapperRef,
-      overlayRef: popoverRef,
-      placement: toAriaPlacement('bottom-start'),
-      offset: 2,
-      isOpen: state.isOpen,
-      // Leaving `onClose` unset doesn't actually disable react-aria's close-on-scroll listener —
-      // only an explicit `null` does. Matches the fix already applied to `Autocomplete`'s identical
-      // positioning call.
-      onClose: null
-    })
-
-    // Portals the panel to `document.body` (or an enclosing open `<dialog>`) instead of rendering
-    // it inline, matching `Popover`/`Tooltip` — an inline-rendered panel gets clipped by any
-    // ancestor with `overflow: hidden`/`auto` (a `ModalBody`, a scrollable card, a table cell), and
-    // `Combobox` is commonly composed inside exactly those. See `COMBOBOX_MENU_OVERLAY_STYLE` for
-    // the styling this trades away by leaving the DOM position `.combobox + .menu` relies on.
-    const portalContainer = useFloatingOverlay({
-      close: state.close,
-      isOpen: state.isOpen,
-      open: state.open,
-      triggerRef: wrapperRef
-    })
-
-    const { menuStyle, placementAttr } = resolveMenuOverlayPositioning(
-      overlayProps.style,
-      'bottom-start',
-      resolvedPlacement
-    )
-    const overlayStyle: React.CSSProperties = { ...COMBOBOX_MENU_OVERLAY_STYLE, ...menuStyle }
-
-    const inputHtmlProps = inputProps as InputHTMLAttributes<HTMLInputElement>
-    const showNoResults = state.collection.size === 0
-    // Merges the no-results message into the input's own description (for AT that reads
-    // descriptions on demand) in addition to the `aria-live` region below (for AT that announces
-    // live-region changes proactively as the user types) — belt and braces, since screen reader
-    // support for announcing a freshly-mounted live region is inconsistent.
-    const inputDescribedBy =
-      [describedBy, showNoResults && noResultsId].filter(Boolean).join(' ') || undefined
-
-    return renderFormField({
-      children: (
-        <>
-          <div
-            className={classNames(
-              'form-input',
-              'combobox',
-              size,
-              { disabled },
-              validationClassName(invalid, valid),
-              className
-            )}
-            ref={forkedWrapperRef}
-            {...rest}
-          >
-            <input
-              autoComplete="off"
-              className="combobox-value"
-              {...inputHtmlProps}
-              aria-describedby={inputDescribedBy}
-              aria-invalid={invalid || undefined}
-              ref={inputRef}
-            />
-          </div>
-          {typeof window !== 'undefined' &&
-            createPortal(
-              <div
-                className={classNames('menu', { show: state.isOpen })}
-                data-cx-placement={placementAttr}
-                style={overlayStyle}
-                hidden={!state.isOpen}
-                ref={popoverRef}
-              >
-                <ComboboxListBox
-                  state={state}
-                  listBoxProps={listBoxProps}
-                  listBoxRef={listBoxRef}
-                />
-                {showNoResults && (
-                  <div className="combobox-no-results" id={noResultsId} role="status">
-                    {noResultsText}
-                  </div>
-                )}
-              </div>,
-              portalContainer ?? document.body
-            )}
-          {name && (
-            <input type="hidden" name={name} value={state.value ?? ''} disabled={disabled} />
-          )}
-        </>
-      ),
-      help,
-      ids: { feedback: feedbackId, help: helpId, input: inputId, label: labelId },
-      invalid,
-      invalidFeedback,
-      label,
-      valid,
-      validFeedback
-    })
-  }
-)
-
-Combobox.displayName = 'Combobox'

package/src/components/combobox/ComboboxGroup.tsx

@@ -1,27 +0,0 @@
-import { ReactNode } from 'react'
-
-export interface ComboboxGroupProps {
-  /**
-   * Items belonging to this group.
-   */
-  children: ReactNode
-  /**
-   * Header content for the group (`.menu-header`).
-   */
-  label: ReactNode
-}
-
-// `ComboboxGroup` is never actually mounted — like `ComboboxItem`, it's read as data by
-// `Combobox`, which splits its top-level children into groups (wrapping react-stately
-// `Section` nodes) and bare items. Groups and bare items can be mixed at the top level:
-//
-//   <Combobox aria-label="Language">
-//     <ComboboxGroup label="Frontend">
-//       <ComboboxItem id="html">HTML</ComboboxItem>
-//       <ComboboxItem id="css">CSS</ComboboxItem>
-//     </ComboboxGroup>
-//     <ComboboxItem id="python">Python</ComboboxItem>
-//   </Combobox>
-export const ComboboxGroup = (_props: ComboboxGroupProps): null => null
-
-ComboboxGroup.displayName = 'ComboboxGroup'

package/src/components/combobox/ComboboxItem.tsx

@@ -1,44 +0,0 @@
-import { ReactNode } from 'react'
-import { Key } from 'react-stately'
-
-export interface ComboboxItemProps {
-  /**
-   * Content of the option. Used as the filter/typeahead text when `textValue` isn't set — pass
-   * `textValue` explicitly whenever `children` isn't a plain string (e.g. it wraps an icon or
-   * other rich markup), since it can't otherwise be derived from rich content.
-   */
-  children: ReactNode
-  /**
-   * Secondary line of text rendered below `children` (`.menu-item-description`).
-   */
-  description?: ReactNode
-  /**
-   * Prevents the option from being selected, focused, or otherwise interacted with.
-   */
-  disabled?: boolean
-  /**
-   * Icon rendered at the option's leading edge (`.menu-item-icon`).
-   */
-  icon?: ReactNode
-  /**
-   * Identifies this option. Submitted as the value when this option is selected.
-   */
-  id: Key
-  /**
-   * Text used for filtering and typeahead. Required when `children` isn't a plain string —
-   * falls back to `children` itself when omitted and `children` is a string.
-   */
-  textValue?: string
-}
-
-// `ComboboxItem` is never actually mounted — like `Tab`, it's read as data by `Combobox`,
-// which builds react-aria's listbox collection from each item's `id` and `children`. This keeps
-// the public authoring shape as plain composed JSX:
-//
-//   <Combobox aria-label="Fruit">
-//     <ComboboxItem id="apple">Apple</ComboboxItem>
-//     <ComboboxItem id="banana">Banana</ComboboxItem>
-//   </Combobox>
-export const ComboboxItem = (_props: ComboboxItemProps): null => null
-
-ComboboxItem.displayName = 'ComboboxItem'