import type { JSX } from 'solid-js'; import { createComponent, mergeProps } from 'solid-js'; import { omitProps } from 'solid-use/props'; import type { DisclosureStateRenderProps } from '../../states/create-disclosure-state'; import { DisclosureStateChild, useDisclosureState } from '../../states/create-disclosure-state'; import createDynamic from '../../utils/create-dynamic'; import type { DynamicProps, HeadlessProps, ValidConstructor } from '../../utils/dynamic-prop'; import { createDisabledState, createExpandedState } from '../../utils/state-props'; import { useCommandBarContext } from './CommandBarContext'; import { COMMAND_BAR_DESCRIPTION_TAG } from './tags'; export type CommandBarDescriptionProps = HeadlessProps< T, DisclosureStateRenderProps >; /** * The accessible description of a `CommandBar`, wired up through `aria- * describedby`. * * Renders a `

` by default. * * @see {@link https://github.com/lxsmnsyc/terracotta/blob/main/docs/components/command-bar.md} */ export function CommandBarDescription( props: CommandBarDescriptionProps, ): JSX.Element { const context = useCommandBarContext('CommandBarDescription'); const state = useDisclosureState(); return createDynamic( () => props.as ?? ('p' as T), mergeProps( COMMAND_BAR_DESCRIPTION_TAG, { id: context.descriptionID, get children() { return createComponent(DisclosureStateChild, { get children() { return props.children; }, }); }, }, createDisabledState(() => state.disabled()), omitProps(props, ['as', 'children']), createExpandedState(() => state.isOpen()), ) as DynamicProps, ); }