import { n as CollectionItemOptions } from "../collection-item-DRA-Dc3W.js";
import { t as FormStore } from "../form-store-C15msSpw.js";
import { Props } from "@ariakit/react-utils";
import { ElementType } from "react";
import { StringLike } from "@ariakit/components/form/types";
//#region src/form/form-description.d.ts
declare const TagName = "div";
type TagName = typeof TagName;
/**
 * Returns props to create a `FormDescription` component.
 * @see https://ariakit.com/components/form
 * @example
 * ```jsx
 * const store = useFormStore({ defaultValues: { password: "" } });
 * const props = useFormDescription({ store, name: store.names.password });
 * <Form store={store}>
 *   <FormLabel name={store.names.password}>Password</FormLabel>
 *   <FormInput name={store.names.password} type="password" />
 *   <Role {...props}>Password with at least 8 characters.</Role>
 * </Form>
 * ```
 */
declare const useFormDescription: import("@ariakit/react-utils").Hook<"div", FormDescriptionOptions<"div">>;
/**
 * Renders a description element for a form field, which will automatically
 * receive an `aria-describedby` attribute pointing to this element.
 * @see https://ariakit.com/components/form
 * @example
 * ```jsx {10-12}
 * const form = useFormStore({
 *   defaultValues: {
 *     password: "",
 *   },
 * });
 *
 * <Form store={form}>
 *   <FormLabel name={form.names.password}>Password</FormLabel>
 *   <FormInput name={form.names.password} type="password" />
 *   <FormDescription name={form.names.password}>
 *     Password with at least 8 characters.
 *   </FormDescription>
 * </Form>
 * ```
 */
declare const FormDescription: (props: FormDescriptionProps) => import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>>;
interface FormDescriptionOptions<T extends ElementType = TagName> extends CollectionItemOptions<T> {
  /**
   * Object returned by the
   * [`useFormStore`](https://ariakit.com/reference/use-form-store) hook. If not
   * provided, the closest [`Form`](https://ariakit.com/reference/form) or
   * [`FormProvider`](https://ariakit.com/reference/form-provider) components'
   * context will be used.
   */
  store?: FormStore;
  /**
   * Name of the field described by this element. This can either be a string or
   * a reference to a field name from the
   * [`names`](https://ariakit.com/reference/use-form-store#names) object in the
   * store, for type safety.
   * @example
   * ```jsx
   * <FormDescription name="password">
   *   Password with at least 8 characters.
   * </FormDescription>
   * ```
   */
  name: StringLike;
}
type FormDescriptionProps<T extends ElementType = TagName> = Props<T, FormDescriptionOptions<T>>;
//#endregion
export { FormDescription, FormDescriptionOptions, FormDescriptionProps, useFormDescription };
//# sourceMappingURL=form-description.d.ts.map