import * as class_variance_authority_types from 'class-variance-authority/types';
import * as React from 'react';
import { VariantProps } from 'class-variance-authority';

/**
 * Term/detail pairs — metadata strips, summary rows, key–value facts.
 *
 * **This name shipped once before and was removed.** `DescriptionList` was
 * dropped from the public API as a BREAKING CHANGE in v3 (commit 09d6db3),
 * incidentally, inside a commit whose subject was adding ten unrelated
 * components; its registry item then outlived it by three releases until
 * `check:registry-resolves` caught the orphan. Consumers were told to migrate
 * off it, so this is a deliberate re-introduction rather than a revert, and it
 * is not source-compatible with the old one:
 *
 * - The old markup was a single hardcoded grid
 *   (`sm:grid-cols-[min(50%,--spacing(80))_auto]`) with no way to opt out.
 *   Layout is now a variant.
 * - The old classes were cascade-unsafe in exactly the way `check:cascade`
 *   now fails a build for — `text-base/6 sm:text-sm/6` and
 *   `border-t … sm:border-t` are bare utilities paired with responsive
 *   overrides of the same property, so an npm consumer's own Tailwind build
 *   could outrank them. Every responsive step here is a mutually exclusive
 *   range instead.
 * - The old type ramp dropped to 14px from `sm` up. Body copy holds at 16px.
 */
declare const descriptionListVariants: (props?: ({
    layout?: "inline" | "stacked" | "columns" | null | undefined;
} & class_variance_authority_types.ClassProp) | undefined) => string;
type DescriptionListProps = React.ComponentPropsWithoutRef<'dl'> & VariantProps<typeof descriptionListVariants> & {
    ref?: React.Ref<HTMLDListElement>;
};
/**
 * A `<dl>` of term/detail pairs.
 *
 * **`columns` and `inline` place their own children, so each pair must be
 * wrapped in a single element.** A `<dl>` may contain `<div>` wrappers around
 * `<dt>`/`<dd>` groups — that is valid HTML and preserves the list semantics —
 * and it is what keeps a term with its detail when the grid wraps. Without the
 * wrapper the grid places every `<dt>` and `<dd>` independently and pairs come
 * apart at the wrap point:
 *
 * ```tsx
 * <DescriptionList layout='inline'>
 *   <div>
 *     <DescriptionTerm>Version</DescriptionTerm>
 *     <DescriptionDetails>2.001</DescriptionDetails>
 *   </div>
 * </DescriptionList>
 * ```
 *
 * `stacked` has no such requirement — wrap or don't, it reads the same.
 */
declare function DescriptionList({ className, layout, ref, ...props }: DescriptionListProps): React.JSX.Element;
type DescriptionTermProps = React.ComponentPropsWithoutRef<'dt'> & {
    ref?: React.Ref<HTMLElement>;
};
/** The term half of a pair — the label. */
declare function DescriptionTerm({ className, ref, ...props }: DescriptionTermProps): React.JSX.Element;
type DescriptionDetailsProps = React.ComponentPropsWithoutRef<'dd'> & {
    ref?: React.Ref<HTMLElement>;
};
/**
 * The detail half of a pair — the value.
 *
 * `ms-0` is deliberate: browsers give `<dd>` a 40px `margin-inline-start` by
 * default, which the grid layouts would otherwise indent every value by. It is
 * an unconditional reset, so it does not fight the responsive ramp.
 */
declare function DescriptionDetails({ className, ref, ...props }: DescriptionDetailsProps): React.JSX.Element;

export { DescriptionDetails, type DescriptionDetailsProps, DescriptionList, type DescriptionListProps, DescriptionTerm, type DescriptionTermProps, descriptionListVariants };