import type { JSX } from 'solid-js'; import { createComponent, mergeProps } from 'solid-js'; import { omitProps } from 'solid-use/props'; import type { CheckStateRenderProps } from '../../states/create-check-state'; import { CheckStateChild, useCheckState } from '../../states/create-check-state'; import createDynamic from '../../utils/create-dynamic'; import type { DynamicProps, HeadlessProps, ValidConstructor } from '../../utils/dynamic-prop'; import { createCheckedState, createDisabledState } from '../../utils/state-props'; import { useCheckboxContext } from './CheckboxContext'; import { CHECKBOX_DESCRIPTION } from './tags'; export type CheckboxDescriptionProps = HeadlessProps< T, CheckStateRenderProps >; /** * The accessible description of a `Checkbox`, wired up through `aria- * describedby`. * * Renders a `

` by default. * * @see {@link https://github.com/lxsmnsyc/terracotta/blob/main/docs/components/checkbox.md} */ export function CheckboxDescription( props: CheckboxDescriptionProps, ): JSX.Element { const context = useCheckboxContext('CheckboxDescription'); const state = useCheckState(); return createDynamic( () => props.as ?? ('p' as T), mergeProps( omitProps(props, ['as', 'children']), CHECKBOX_DESCRIPTION, { id: context.descriptionID, get children() { return createComponent(CheckStateChild, { get children() { return props.children; }, }); }, }, createDisabledState(() => state.disabled()), createCheckedState(() => state.checked()), ) as DynamicProps, ); }