@tonycodes-ui/mortar 0.0.0-stage → 0.12.0

package/dist/internal.d.ts

@@ -0,0 +1,514 @@
+import { type HTMLAttributes, type RefObject, type ReactNode } from "react";
+import { type ItemGroup } from "./navigation.js";
+import { type LinkAction } from "./primitives.js";
+import { type HeadingLevel } from "./heading.js";
+/**
+ * Names a catalogue component on its root: spread it on the outermost element
+ * the component renders, `<nav {...componentRoot("Pagination")}>`. A dialog
+ * marks its dialog root (portalled), and a component that renders sibling
+ * elements marks the first one it always renders. Pass `root = false` when
+ * this element is not the outermost one for the current props, e.g. a wrapper
+ * then takes the name. The attribute is a hook for tests and consumers, not
+ * for styling; the only selector on it is the internal Prose boundary.
+ */
+export declare function componentRoot(name: string, root?: boolean): {
+    "data-m-component": string | undefined;
+};
+/**
+ * Renders `children`, one `of` component, as the root of the component `name`:
+ * that root then carries `name` (SearchDialog renders a CommandPalette). Only
+ * an `of` component that reads `useComponentName` takes the name, so keep the
+ * same kind of component out of its slots.
+ */
+export declare function AsComponentRoot({ name, of, children, }: {
+    name: string;
+    of: string;
+    children: ReactNode;
+}): import("react").JSX.Element;
+/**
+ * The root name of a component that another can render as its root: `name`,
+ * or the outer component's name inside its `AsComponentRoot`.
+ */
+export declare function useComponentName(name: string): string;
+/** Joins the truthy class names with single spaces. */
+export declare function cx(...classes: (string | false | null | undefined)[]): string;
+export interface IntroProps {
+    eyebrow?: string;
+    /** Omit to render no heading. */
+    title?: string;
+    /** A phrase in `title` to emphasise; its first occurrence renders as `<em>`. */
+    emphasis?: string;
+    description?: string;
+    /** Id for the heading, e.g. the target of the section's aria-labelledby. */
+    id?: string;
+    headingLevel?: HeadingLevel;
+    /** Class on the description paragraph; `null` leaves it unstyled. */
+    descriptionClassName?: string | null;
+}
+/**
+ * The eyebrow, heading and description that open a section, as three child
+ * slots. Spread them (`{...introSlots(props)}`) when consumer content follows
+ * in the same parent: React derives useId values from each child's position,
+ * so keeping the slots flat keeps the ids of that content unchanged.
+ */
+export declare function introSlots({ eyebrow, title, emphasis, description, id, headingLevel, descriptionClassName, }: IntroProps): ReactNode[];
+/** The section intro as one element, for parents where nothing user-supplied follows it. */
+export declare function SectionIntro(props: IntroProps): import("react").JSX.Element;
+/** A row of link actions: the first primary, the rest secondary. */
+export declare function ActionLinks({ actions }: {
+    actions: LinkAction[];
+}): import("react").JSX.Element;
+export interface Term {
+    term: ReactNode;
+    details: ReactNode;
+    /** React key; defaults to the term. */
+    key?: string;
+    /** Extra content after the details, e.g. a second dd. */
+    after?: ReactNode;
+    /** Attributes for the term's wrapping div. */
+    attributes?: HTMLAttributes<HTMLDivElement> & Record<`data-${string}`, unknown>;
+}
+/** A description list whose terms each sit in a div with their details. */
+export declare function TermList({ items, children, ...props }: HTMLAttributes<HTMLDListElement> & Record<`data-${string}`, unknown> & {
+    items: Term[];
+    /** Content after the terms, e.g. a total row. */
+    children?: ReactNode;
+}): import("react").DetailedReactHTMLElement<{
+    [x: `data-${string}`]: unknown;
+    defaultChecked?: boolean | undefined;
+    defaultValue?: string | number | readonly string[] | undefined;
+    suppressContentEditableWarning?: boolean | undefined;
+    suppressHydrationWarning?: boolean | undefined;
+    accessKey?: string | undefined;
+    autoCapitalize?: "off" | "none" | "on" | "sentences" | "words" | "characters" | undefined | (string & {});
+    autoFocus?: boolean | undefined;
+    className?: string | undefined;
+    contentEditable?: (boolean | "true" | "false") | "inherit" | "plaintext-only" | undefined;
+    contextMenu?: string | undefined;
+    dir?: string | undefined;
+    draggable?: (boolean | "true" | "false") | undefined;
+    enterKeyHint?: "enter" | "done" | "go" | "next" | "previous" | "search" | "send" | undefined;
+    hidden?: boolean | undefined;
+    id?: string | undefined;
+    lang?: string | undefined;
+    nonce?: string | undefined;
+    slot?: string | undefined;
+    spellCheck?: (boolean | "true" | "false") | undefined;
+    style?: import("react").CSSProperties | undefined;
+    tabIndex?: number | undefined;
+    title?: string | undefined;
+    translate?: "yes" | "no" | undefined;
+    radioGroup?: string | undefined;
+    role?: import("react").AriaRole | undefined;
+    about?: string | undefined;
+    content?: string | undefined;
+    datatype?: string | undefined;
+    inlist?: any;
+    prefix?: string | undefined;
+    property?: string | undefined;
+    rel?: string | undefined;
+    resource?: string | undefined;
+    rev?: string | undefined;
+    typeof?: string | undefined;
+    vocab?: string | undefined;
+    autoCorrect?: string | undefined;
+    autoSave?: string | undefined;
+    color?: string | undefined;
+    itemProp?: string | undefined;
+    itemScope?: boolean | undefined;
+    itemType?: string | undefined;
+    itemID?: string | undefined;
+    itemRef?: string | undefined;
+    results?: number | undefined;
+    security?: string | undefined;
+    unselectable?: "on" | "off" | undefined;
+    popover?: "" | "auto" | "manual" | "hint" | undefined;
+    popoverTargetAction?: "toggle" | "show" | "hide" | undefined;
+    popoverTarget?: string | undefined;
+    inert?: boolean | undefined;
+    inputMode?: "none" | "text" | "tel" | "url" | "email" | "numeric" | "decimal" | "search" | undefined;
+    is?: string | undefined;
+    exportparts?: string | undefined;
+    part?: string | undefined;
+    "aria-activedescendant"?: string | undefined;
+    "aria-atomic"?: (boolean | "true" | "false") | undefined;
+    "aria-autocomplete"?: "none" | "inline" | "list" | "both" | undefined;
+    "aria-braillelabel"?: string | undefined;
+    "aria-brailleroledescription"?: string | undefined;
+    "aria-busy"?: (boolean | "true" | "false") | undefined;
+    "aria-checked"?: boolean | "false" | "mixed" | "true" | undefined;
+    "aria-colcount"?: number | undefined;
+    "aria-colindex"?: number | undefined;
+    "aria-colindextext"?: string | undefined;
+    "aria-colspan"?: number | undefined;
+    "aria-controls"?: string | undefined;
+    "aria-current"?: boolean | "false" | "true" | "page" | "step" | "location" | "date" | "time" | undefined;
+    "aria-describedby"?: string | undefined;
+    "aria-description"?: string | undefined;
+    "aria-details"?: string | undefined;
+    "aria-disabled"?: (boolean | "true" | "false") | undefined;
+    "aria-dropeffect"?: "none" | "copy" | "execute" | "link" | "move" | "popup" | undefined;
+    "aria-errormessage"?: string | undefined;
+    "aria-expanded"?: (boolean | "true" | "false") | undefined;
+    "aria-flowto"?: string | undefined;
+    "aria-grabbed"?: (boolean | "true" | "false") | undefined;
+    "aria-haspopup"?: boolean | "false" | "true" | "menu" | "listbox" | "tree" | "grid" | "dialog" | undefined;
+    "aria-hidden"?: (boolean | "true" | "false") | undefined;
+    "aria-invalid"?: boolean | "false" | "true" | "grammar" | "spelling" | undefined;
+    "aria-keyshortcuts"?: string | undefined;
+    "aria-label"?: string | undefined;
+    "aria-labelledby"?: string | undefined;
+    "aria-level"?: number | undefined;
+    "aria-live"?: "off" | "assertive" | "polite" | undefined;
+    "aria-modal"?: (boolean | "true" | "false") | undefined;
+    "aria-multiline"?: (boolean | "true" | "false") | undefined;
+    "aria-multiselectable"?: (boolean | "true" | "false") | undefined;
+    "aria-orientation"?: "horizontal" | "vertical" | undefined;
+    "aria-owns"?: string | undefined;
+    "aria-placeholder"?: string | undefined;
+    "aria-posinset"?: number | undefined;
+    "aria-pressed"?: boolean | "false" | "mixed" | "true" | undefined;
+    "aria-readonly"?: (boolean | "true" | "false") | undefined;
+    "aria-relevant"?: "additions" | "additions removals" | "additions text" | "all" | "removals" | "removals additions" | "removals text" | "text" | "text additions" | "text removals" | undefined;
+    "aria-required"?: (boolean | "true" | "false") | undefined;
+    "aria-roledescription"?: string | undefined;
+    "aria-rowcount"?: number | undefined;
+    "aria-rowindex"?: number | undefined;
+    "aria-rowindextext"?: string | undefined;
+    "aria-rowspan"?: number | undefined;
+    "aria-selected"?: (boolean | "true" | "false") | undefined;
+    "aria-setsize"?: number | undefined;
+    "aria-sort"?: "none" | "ascending" | "descending" | "other" | undefined;
+    "aria-valuemax"?: number | undefined;
+    "aria-valuemin"?: number | undefined;
+    "aria-valuenow"?: number | undefined;
+    "aria-valuetext"?: string | undefined;
+    dangerouslySetInnerHTML?: {
+        __html: string | TrustedHTML;
+    } | undefined;
+    onCopy?: import("react").ClipboardEventHandler<HTMLDListElement> | undefined;
+    onCopyCapture?: import("react").ClipboardEventHandler<HTMLDListElement> | undefined;
+    onCut?: import("react").ClipboardEventHandler<HTMLDListElement> | undefined;
+    onCutCapture?: import("react").ClipboardEventHandler<HTMLDListElement> | undefined;
+    onPaste?: import("react").ClipboardEventHandler<HTMLDListElement> | undefined;
+    onPasteCapture?: import("react").ClipboardEventHandler<HTMLDListElement> | undefined;
+    onCompositionEnd?: import("react").CompositionEventHandler<HTMLDListElement> | undefined;
+    onCompositionEndCapture?: import("react").CompositionEventHandler<HTMLDListElement> | undefined;
+    onCompositionStart?: import("react").CompositionEventHandler<HTMLDListElement> | undefined;
+    onCompositionStartCapture?: import("react").CompositionEventHandler<HTMLDListElement> | undefined;
+    onCompositionUpdate?: import("react").CompositionEventHandler<HTMLDListElement> | undefined;
+    onCompositionUpdateCapture?: import("react").CompositionEventHandler<HTMLDListElement> | undefined;
+    onFocus?: import("react").FocusEventHandler<HTMLDListElement> | undefined;
+    onFocusCapture?: import("react").FocusEventHandler<HTMLDListElement> | undefined;
+    onBlur?: import("react").FocusEventHandler<HTMLDListElement> | undefined;
+    onBlurCapture?: import("react").FocusEventHandler<HTMLDListElement> | undefined;
+    onChange?: import("react").ChangeEventHandler<HTMLDListElement, Element> | undefined;
+    onChangeCapture?: import("react").ChangeEventHandler<HTMLDListElement, Element> | undefined;
+    onBeforeInput?: import("react").InputEventHandler<HTMLDListElement> | undefined;
+    onBeforeInputCapture?: import("react").InputEventHandler<HTMLDListElement> | undefined;
+    onInput?: import("react").InputEventHandler<HTMLDListElement> | undefined;
+    onInputCapture?: import("react").InputEventHandler<HTMLDListElement> | undefined;
+    onReset?: import("react").ReactEventHandler<HTMLDListElement> | undefined;
+    onResetCapture?: import("react").ReactEventHandler<HTMLDListElement> | undefined;
+    onSubmit?: import("react").SubmitEventHandler<HTMLDListElement> | undefined;
+    onSubmitCapture?: import("react").SubmitEventHandler<HTMLDListElement> | undefined;
+    onInvalid?: import("react").ReactEventHandler<HTMLDListElement> | undefined;
+    onInvalidCapture?: import("react").ReactEventHandler<HTMLDListElement> | undefined;
+    onLoad?: import("react").ReactEventHandler<HTMLDListElement> | undefined;
+    onLoadCapture?: import("react").ReactEventHandler<HTMLDListElement> | undefined;
+    onError?: import("react").ReactEventHandler<HTMLDListElement> | undefined;
+    onErrorCapture?: import("react").ReactEventHandler<HTMLDListElement> | undefined;
+    onKeyDown?: import("react").KeyboardEventHandler<HTMLDListElement> | undefined;
+    onKeyDownCapture?: import("react").KeyboardEventHandler<HTMLDListElement> | undefined;
+    onKeyPress?: import("react").KeyboardEventHandler<HTMLDListElement> | undefined;
+    onKeyPressCapture?: import("react").KeyboardEventHandler<HTMLDListElement> | undefined;
+    onKeyUp?: import("react").KeyboardEventHandler<HTMLDListElement> | undefined;
+    onKeyUpCapture?: import("react").KeyboardEventHandler<HTMLDListElement> | undefined;
+    onAbort?: import("react").ReactEventHandler<HTMLDListElement> | undefined;
+    onAbortCapture?: import("react").ReactEventHandler<HTMLDListElement> | undefined;
+    onCanPlay?: import("react").ReactEventHandler<HTMLDListElement> | undefined;
+    onCanPlayCapture?: import("react").ReactEventHandler<HTMLDListElement> | undefined;
+    onCanPlayThrough?: import("react").ReactEventHandler<HTMLDListElement> | undefined;
+    onCanPlayThroughCapture?: import("react").ReactEventHandler<HTMLDListElement> | undefined;
+    onDurationChange?: import("react").ReactEventHandler<HTMLDListElement> | undefined;
+    onDurationChangeCapture?: import("react").ReactEventHandler<HTMLDListElement> | undefined;
+    onEmptied?: import("react").ReactEventHandler<HTMLDListElement> | undefined;
+    onEmptiedCapture?: import("react").ReactEventHandler<HTMLDListElement> | undefined;
+    onEncrypted?: import("react").ReactEventHandler<HTMLDListElement> | undefined;
+    onEncryptedCapture?: import("react").ReactEventHandler<HTMLDListElement> | undefined;
+    onEnded?: import("react").ReactEventHandler<HTMLDListElement> | undefined;
+    onEndedCapture?: import("react").ReactEventHandler<HTMLDListElement> | undefined;
+    onLoadedData?: import("react").ReactEventHandler<HTMLDListElement> | undefined;
+    onLoadedDataCapture?: import("react").ReactEventHandler<HTMLDListElement> | undefined;
+    onLoadedMetadata?: import("react").ReactEventHandler<HTMLDListElement> | undefined;
+    onLoadedMetadataCapture?: import("react").ReactEventHandler<HTMLDListElement> | undefined;
+    onLoadStart?: import("react").ReactEventHandler<HTMLDListElement> | undefined;
+    onLoadStartCapture?: import("react").ReactEventHandler<HTMLDListElement> | undefined;
+    onPause?: import("react").ReactEventHandler<HTMLDListElement> | undefined;
+    onPauseCapture?: import("react").ReactEventHandler<HTMLDListElement> | undefined;
+    onPlay?: import("react").ReactEventHandler<HTMLDListElement> | undefined;
+    onPlayCapture?: import("react").ReactEventHandler<HTMLDListElement> | undefined;
+    onPlaying?: import("react").ReactEventHandler<HTMLDListElement> | undefined;
+    onPlayingCapture?: import("react").ReactEventHandler<HTMLDListElement> | undefined;
+    onProgress?: import("react").ReactEventHandler<HTMLDListElement> | undefined;
+    onProgressCapture?: import("react").ReactEventHandler<HTMLDListElement> | undefined;
+    onRateChange?: import("react").ReactEventHandler<HTMLDListElement> | undefined;
+    onRateChangeCapture?: import("react").ReactEventHandler<HTMLDListElement> | undefined;
+    onSeeked?: import("react").ReactEventHandler<HTMLDListElement> | undefined;
+    onSeekedCapture?: import("react").ReactEventHandler<HTMLDListElement> | undefined;
+    onSeeking?: import("react").ReactEventHandler<HTMLDListElement> | undefined;
+    onSeekingCapture?: import("react").ReactEventHandler<HTMLDListElement> | undefined;
+    onStalled?: import("react").ReactEventHandler<HTMLDListElement> | undefined;
+    onStalledCapture?: import("react").ReactEventHandler<HTMLDListElement> | undefined;
+    onSuspend?: import("react").ReactEventHandler<HTMLDListElement> | undefined;
+    onSuspendCapture?: import("react").ReactEventHandler<HTMLDListElement> | undefined;
+    onTimeUpdate?: import("react").ReactEventHandler<HTMLDListElement> | undefined;
+    onTimeUpdateCapture?: import("react").ReactEventHandler<HTMLDListElement> | undefined;
+    onVolumeChange?: import("react").ReactEventHandler<HTMLDListElement> | undefined;
+    onVolumeChangeCapture?: import("react").ReactEventHandler<HTMLDListElement> | undefined;
+    onWaiting?: import("react").ReactEventHandler<HTMLDListElement> | undefined;
+    onWaitingCapture?: import("react").ReactEventHandler<HTMLDListElement> | undefined;
+    onAuxClick?: import("react").MouseEventHandler<HTMLDListElement> | undefined;
+    onAuxClickCapture?: import("react").MouseEventHandler<HTMLDListElement> | undefined;
+    onClick?: import("react").MouseEventHandler<HTMLDListElement> | undefined;
+    onClickCapture?: import("react").MouseEventHandler<HTMLDListElement> | undefined;
+    onContextMenu?: import("react").MouseEventHandler<HTMLDListElement> | undefined;
+    onContextMenuCapture?: import("react").MouseEventHandler<HTMLDListElement> | undefined;
+    onDoubleClick?: import("react").MouseEventHandler<HTMLDListElement> | undefined;
+    onDoubleClickCapture?: import("react").MouseEventHandler<HTMLDListElement> | undefined;
+    onDrag?: import("react").DragEventHandler<HTMLDListElement> | undefined;
+    onDragCapture?: import("react").DragEventHandler<HTMLDListElement> | undefined;
+    onDragEnd?: import("react").DragEventHandler<HTMLDListElement> | undefined;
+    onDragEndCapture?: import("react").DragEventHandler<HTMLDListElement> | undefined;
+    onDragEnter?: import("react").DragEventHandler<HTMLDListElement> | undefined;
+    onDragEnterCapture?: import("react").DragEventHandler<HTMLDListElement> | undefined;
+    onDragExit?: import("react").DragEventHandler<HTMLDListElement> | undefined;
+    onDragExitCapture?: import("react").DragEventHandler<HTMLDListElement> | undefined;
+    onDragLeave?: import("react").DragEventHandler<HTMLDListElement> | undefined;
+    onDragLeaveCapture?: import("react").DragEventHandler<HTMLDListElement> | undefined;
+    onDragOver?: import("react").DragEventHandler<HTMLDListElement> | undefined;
+    onDragOverCapture?: import("react").DragEventHandler<HTMLDListElement> | undefined;
+    onDragStart?: import("react").DragEventHandler<HTMLDListElement> | undefined;
+    onDragStartCapture?: import("react").DragEventHandler<HTMLDListElement> | undefined;
+    onDrop?: import("react").DragEventHandler<HTMLDListElement> | undefined;
+    onDropCapture?: import("react").DragEventHandler<HTMLDListElement> | undefined;
+    onMouseDown?: import("react").MouseEventHandler<HTMLDListElement> | undefined;
+    onMouseDownCapture?: import("react").MouseEventHandler<HTMLDListElement> | undefined;
+    onMouseEnter?: import("react").MouseEventHandler<HTMLDListElement> | undefined;
+    onMouseLeave?: import("react").MouseEventHandler<HTMLDListElement> | undefined;
+    onMouseMove?: import("react").MouseEventHandler<HTMLDListElement> | undefined;
+    onMouseMoveCapture?: import("react").MouseEventHandler<HTMLDListElement> | undefined;
+    onMouseOut?: import("react").MouseEventHandler<HTMLDListElement> | undefined;
+    onMouseOutCapture?: import("react").MouseEventHandler<HTMLDListElement> | undefined;
+    onMouseOver?: import("react").MouseEventHandler<HTMLDListElement> | undefined;
+    onMouseOverCapture?: import("react").MouseEventHandler<HTMLDListElement> | undefined;
+    onMouseUp?: import("react").MouseEventHandler<HTMLDListElement> | undefined;
+    onMouseUpCapture?: import("react").MouseEventHandler<HTMLDListElement> | undefined;
+    onSelect?: import("react").ReactEventHandler<HTMLDListElement> | undefined;
+    onSelectCapture?: import("react").ReactEventHandler<HTMLDListElement> | undefined;
+    onTouchCancel?: import("react").TouchEventHandler<HTMLDListElement> | undefined;
+    onTouchCancelCapture?: import("react").TouchEventHandler<HTMLDListElement> | undefined;
+    onTouchEnd?: import("react").TouchEventHandler<HTMLDListElement> | undefined;
+    onTouchEndCapture?: import("react").TouchEventHandler<HTMLDListElement> | undefined;
+    onTouchMove?: import("react").TouchEventHandler<HTMLDListElement> | undefined;
+    onTouchMoveCapture?: import("react").TouchEventHandler<HTMLDListElement> | undefined;
+    onTouchStart?: import("react").TouchEventHandler<HTMLDListElement> | undefined;
+    onTouchStartCapture?: import("react").TouchEventHandler<HTMLDListElement> | undefined;
+    onPointerDown?: import("react").PointerEventHandler<HTMLDListElement> | undefined;
+    onPointerDownCapture?: import("react").PointerEventHandler<HTMLDListElement> | undefined;
+    onPointerMove?: import("react").PointerEventHandler<HTMLDListElement> | undefined;
+    onPointerMoveCapture?: import("react").PointerEventHandler<HTMLDListElement> | undefined;
+    onPointerUp?: import("react").PointerEventHandler<HTMLDListElement> | undefined;
+    onPointerUpCapture?: import("react").PointerEventHandler<HTMLDListElement> | undefined;
+    onPointerCancel?: import("react").PointerEventHandler<HTMLDListElement> | undefined;
+    onPointerCancelCapture?: import("react").PointerEventHandler<HTMLDListElement> | undefined;
+    onPointerEnter?: import("react").PointerEventHandler<HTMLDListElement> | undefined;
+    onPointerLeave?: import("react").PointerEventHandler<HTMLDListElement> | undefined;
+    onPointerOver?: import("react").PointerEventHandler<HTMLDListElement> | undefined;
+    onPointerOverCapture?: import("react").PointerEventHandler<HTMLDListElement> | undefined;
+    onPointerOut?: import("react").PointerEventHandler<HTMLDListElement> | undefined;
+    onPointerOutCapture?: import("react").PointerEventHandler<HTMLDListElement> | undefined;
+    onGotPointerCapture?: import("react").PointerEventHandler<HTMLDListElement> | undefined;
+    onGotPointerCaptureCapture?: import("react").PointerEventHandler<HTMLDListElement> | undefined;
+    onLostPointerCapture?: import("react").PointerEventHandler<HTMLDListElement> | undefined;
+    onLostPointerCaptureCapture?: import("react").PointerEventHandler<HTMLDListElement> | undefined;
+    onScroll?: import("react").UIEventHandler<HTMLDListElement> | undefined;
+    onScrollCapture?: import("react").UIEventHandler<HTMLDListElement> | undefined;
+    onScrollEnd?: import("react").UIEventHandler<HTMLDListElement> | undefined;
+    onScrollEndCapture?: import("react").UIEventHandler<HTMLDListElement> | undefined;
+    onWheel?: import("react").WheelEventHandler<HTMLDListElement> | undefined;
+    onWheelCapture?: import("react").WheelEventHandler<HTMLDListElement> | undefined;
+    onAnimationStart?: import("react").AnimationEventHandler<HTMLDListElement> | undefined;
+    onAnimationStartCapture?: import("react").AnimationEventHandler<HTMLDListElement> | undefined;
+    onAnimationEnd?: import("react").AnimationEventHandler<HTMLDListElement> | undefined;
+    onAnimationEndCapture?: import("react").AnimationEventHandler<HTMLDListElement> | undefined;
+    onAnimationIteration?: import("react").AnimationEventHandler<HTMLDListElement> | undefined;
+    onAnimationIterationCapture?: import("react").AnimationEventHandler<HTMLDListElement> | undefined;
+    onToggle?: import("react").ToggleEventHandler<HTMLDListElement> | undefined;
+    onBeforeToggle?: import("react").ToggleEventHandler<HTMLDListElement> | undefined;
+    onTransitionCancel?: import("react").TransitionEventHandler<HTMLDListElement> | undefined;
+    onTransitionCancelCapture?: import("react").TransitionEventHandler<HTMLDListElement> | undefined;
+    onTransitionEnd?: import("react").TransitionEventHandler<HTMLDListElement> | undefined;
+    onTransitionEndCapture?: import("react").TransitionEventHandler<HTMLDListElement> | undefined;
+    onTransitionRun?: import("react").TransitionEventHandler<HTMLDListElement> | undefined;
+    onTransitionRunCapture?: import("react").TransitionEventHandler<HTMLDListElement> | undefined;
+    onTransitionStart?: import("react").TransitionEventHandler<HTMLDListElement> | undefined;
+    onTransitionStartCapture?: import("react").TransitionEventHandler<HTMLDListElement> | undefined;
+}, HTMLElement>;
+/**
+ * Icon, label and count inside a navigation link or tab. `prefix` picks the
+ * class family (`m-nav-*` or `m-tab-*`). A count shows whenever it is defined.
+ */
+export declare function LinkContent({ prefix, label, icon, count, marker, }: {
+    prefix: "nav" | "tab";
+    label: ReactNode;
+    icon?: ReactNode;
+    count?: number | string;
+    /** Show the dot marker when there is no icon (sidebar links). */
+    marker?: boolean;
+}): import("react").FunctionComponentElement<import("react").FragmentProps>;
+/** A generated id that is safe in CSS selectors and URL fragments. */
+export declare function useDomId(prefix: string): string;
+/** Why an animation is not running; null while it plays. */
+export type PauseReason = "user" | "motion" | "hidden" | "offscreen" | null;
+/**
+ * Shared pause and resume for decorative motion. It plays only while the
+ * user has not paused it, reduced motion is not requested, the document is
+ * visible and `ref` is on screen. The user's pause is kept apart from the
+ * automatic reasons, so returning to the page never overrides it. `paused`
+ * and `onPausedChange` make the user's choice controlled, for example one
+ * state shared by several animations. Every listener is removed on unmount.
+ */
+export declare function usePlayback(ref: RefObject<Element | null>, { paused, onPausedChange, enabled, }: {
+    paused?: boolean;
+    onPausedChange?: (paused: boolean) => void;
+    enabled?: boolean;
+}): {
+    reason: PauseReason;
+    reduced: boolean;
+    userPaused: boolean;
+    toggle: () => void;
+};
+/**
+ * Next index for arrow, Home and End keys in a horizontal set (wrapping), or
+ * null for any other key.
+ */
+export declare function rovingIndex(key: string, index: number, count: number): number | null;
+/** Colour swatch whose label is announced in place of the colour. */
+export declare function Swatch({ color, label }: {
+    color?: string;
+    label: ReactNode;
+}): import("react").JSX.Element;
+/** Ids and describedby wiring for a labelled field with a hint or error message. */
+export declare function useField({ id, hint, error, describedBy, }: {
+    id?: string;
+    hint?: string;
+    error?: string;
+    /** The consumer's own aria-describedby, kept before the message id. */
+    describedBy?: string;
+}): {
+    fieldId: string;
+    messageId: string;
+    describedBy: string | undefined;
+};
+/** The hint or error under a field; the error wins and is styled as one. */
+export declare function FieldMessage({ id, hint, error, }: {
+    id: string;
+    hint?: string;
+    error?: string;
+}): import("react").JSX.Element | null;
+/** Headless dialog root with the shared backdrop. */
+export declare function DialogFrame({ open, onClose, component, children, }: {
+    open: boolean;
+    onClose: () => void;
+    /** The catalogue component this dialog is the root of, if any. */
+    component?: string;
+    children: ReactNode;
+}): import("react").JSX.Element;
+/** Narrow-screen navigation drawer used by AppShell and DocsShell. */
+export declare function MobileNavDialog({ open, onClose, title, children, }: {
+    open: boolean;
+    onClose: () => void;
+    title: string;
+    children: ReactNode;
+}): import("react").JSX.Element;
+/** `introSlots` with the shared `m-section-title` class on the heading. */
+export declare function titledIntroSlots(props: IntroProps): ReactNode[];
+/** `data-tone` for a section surface tone; the default tone sets no attribute. */
+export declare function sectionTone(tone?: "default" | "muted" | "inverse" | "accent"): "accent" | "muted" | "inverse" | undefined;
+/** `SectionIntro` with the `m-section-title` heading class. */
+export declare function TitledIntro(props: IntroProps): import("react").JSX.Element;
+/** A navigation link with optional sub-pages (NavigationItem's shape). */
+export interface NavTreeItem {
+    label: string;
+    href: string;
+    current?: boolean;
+    icon?: ReactNode;
+    count?: number | string;
+    children?: NavTreeItem[];
+}
+/**
+ * Navigation links with icon and count. An item with children becomes a
+ * disclosure, open when it or a child is current; its own page is the first
+ * link inside.
+ */
+export declare function NavTreeLinks({ items, marker, onNavigate, }: {
+    items: NavTreeItem[];
+    /** Show the dot marker when an item has no icon (sidebar links). */
+    marker?: boolean;
+    onNavigate?: () => void;
+}): import("react").JSX.Element;
+/**
+ * Labelled groups of navigation links. Group labels are not headings, so the
+ * page's own h1 stays first in the heading outline.
+ */
+export declare function NavGroups({ groups, marker, onNavigate, }: {
+    groups: ItemGroup<NavTreeItem>[];
+    marker?: boolean;
+    onNavigate?: () => void;
+}): import("react").JSX.Element;
+/**
+ * The hint or error under a field. Unlike FieldMessage, the error is its own
+ * role="alert" element, so it is announced when it appears.
+ */
+export declare function FieldFeedback({ id, hint, error, }: {
+    id: string;
+    hint?: string;
+    error?: string;
+}): import("react").JSX.Element | null;
+/** Decorative required marker after a field label; the control itself is marked required. */
+export declare function RequiredMark(): import("react").JSX.Element;
+/**
+ * Call before `element` is removed. If focus is inside it, move focus to the
+ * next tabbable element after it (within `scope`, default the document), else
+ * the previous one, else `fallback`, so focus never drops to the body.
+ */
+export declare function focusAway(element: HTMLElement | null, { scope, fallback, }?: {
+    scope?: HTMLElement | null;
+    fallback?: HTMLElement | null;
+}): void;
+/**
+ * The data-mortar-* attributes of the nearest container-scoped ThemeProvider.
+ * Optional (undefined outside one), so it does not make dialogs depend on it.
+ */
+export declare const ThemeScopeContext: import("react").Context<Record<string, string> | undefined>;
+/**
+ * Re-applies a container-scoped theme to content rendered outside its wrapper
+ * (dialogs portal to the document body). The wrapper is display: contents, so
+ * it carries the tokens without adding a box.
+ */
+export declare function ThemeScope({ children }: {
+    children: ReactNode;
+}): import("react").JSX.Element;
+/**
+ * introSlots with a class on the heading, so a title keeps its styles at any
+ * `headingLevel` instead of only as an h2.
+ */
+export declare function classedIntroSlots(props: IntroProps, titleClassName: string): ReactNode[];
+/**
+ * Call before a consumer callback that removes `element` (e.g. a chip's
+ * remove button). Once the removal has rendered, if focus fell to the body,
+ * it moves to the nearest focusable element that took the removed one's place,
+ * or the one before it, searching up through the ancestors that remain.
+ */
+export declare function focusAfterRemoval(element: HTMLElement): void;