import "./text_disclosure.css";
import type * as React from "react";
import { Button as Base } from "@base-ui/react/button";
import { type StyleProps } from "./style_props";
import type { TextSize } from "./text";
/**
 * It takes no `TriggerProps`: a disclosure reveals content ALREADY on the page,
 * so it never stands in for an overlay's trigger — and `onToggle` is the name
 * the DOM gives a `<details>` event, which such a prop set would collide with.
 */
export interface TextDisclosureProps extends StyleProps {
    /** Open state — controlled, because the content it reveals is the caller's. */
    expanded: boolean;
    onToggle: (expanded: boolean) => void;
    /** What is behind it, as a noun: "transcript", "3 earlier replies". The verb
     *  is supplied — a caller writing its own "Show …" ends up with two vocabularies
     *  for one control the first time somebody writes "View". */
    label: string;
    /** Matches the prose it sits in. Default "sm". */
    size?: TextSize;
    /** Announced name, when `label` alone is ambiguous on a page with several. */
    accessibilityLabel?: string;
    testID?: string;
    ref?: React.Ref<HTMLElement>;
    render?: Base.Props["render"];
}
/**
 * An in-prose DISCLOSURE: muted underlined text that reveals adjacent content in
 * place — a transcript under its player, a long value under its summary.
 *
 * The counterpart to {@link TextLink}, and the pair is the point: underlined text
 * either GOES somewhere or REVEALS something, and the INK says which.
 *
 *   blue + `role="link"` (`Link`)   → leaves this surface
 *   muted underline (this)          → reveals more of it, right here
 *
 * Both answer "show me more"; only one takes the reader away, which is the single
 * question the affordance exists to answer. Anything that MUTATES — saves, sends,
 * deletes, opens an overlay — carries a control surface instead (`Button` in
 * chrome, `InlineButton` on a field). See composition.md §"Commit & feedback surfaces".
 *
 * **Why this is a component rather than three lines at each call site.** It
 * carries a contract, and every part of it is a thing a hand-roll gets wrong:
 *
 * - **A `<button>`, never a link.** The obvious reach is `Link`, which
 *   announces a destination — so a screen-reader user is told they are leaving a
 *   page that is about to unfold under them.
 * - **Muted, never blue.** Blue is the promise of a trip. One caller passing the
 *   navigation ink is all it takes for underline to stop meaning anything.
 * - **Reveal only.** The exception to "underline navigates" is this narrow, and a
 *   named component is what keeps it narrow — the next author reaching for quiet
 *   text to hang a DELETE on finds a name that does not fit.
 *
 * **What it is not.** Not `Accordion`: that is a list-row disclosure with a header
 * and a chevron, right for a run of expandable rows and heavy furniture for a verb
 * inside one. Not `Button color="muted"`: measured, that is transparent,
 * borderless and undecorated at rest, so its affordance arrives only on hover —
 * invisible to keyboard and touch, and against a text column it reads as a label.
 */
export declare function TextDisclosure(props: TextDisclosureProps): React.JSX.Element;