entangle-ui 0.6.3 → 0.8.0

package/dist/types/components/primitives/VisuallyHidden/VisuallyHidden.d.ts

@@ -0,0 +1,316 @@
+import { VisuallyHiddenElement } from './VisuallyHidden.types.js';
+import React from 'react';
+
+/**
+ * Hides content visually while keeping it accessible to screen readers.
+ *
+ * Implements the canonical `sr-only` / `visually-hidden` pattern. Use it for
+ * screen-reader-only labels, additional context next to icons, and
+ * skip-to-content links (with `focusable`).
+ *
+ * Don't use this to hide content from sighted users for layout reasons —
+ * that's `display: none`. This component keeps content in the accessibility
+ * tree on purpose.
+ *
+ * @example
+ * ```tsx
+ * // SR-only label next to an icon-only button
+ * <button>
+ *   <SearchIcon />
+ *   <VisuallyHidden>Search</VisuallyHidden>
+ * </button>
+ *
+ * // Skip link revealed on focus
+ * <VisuallyHidden as="a" href="#main" focusable>
+ *   Skip to content
+ * </VisuallyHidden>
+ * ```
+ */
+declare const VisuallyHidden: React.NamedExoticComponent<{
+    as?: VisuallyHiddenElement | undefined;
+    focusable?: boolean | undefined;
+    children: React.ReactNode;
+    id?: string | undefined | undefined;
+    className?: string | undefined | undefined;
+    testId?: string | undefined;
+    style?: React.CSSProperties | undefined;
+    ref?: React.Ref<HTMLSpanElement> | undefined;
+    defaultChecked?: boolean | undefined | undefined;
+    defaultValue?: string | number | readonly string[] | undefined;
+    suppressContentEditableWarning?: boolean | undefined | undefined;
+    suppressHydrationWarning?: boolean | undefined | undefined;
+    accessKey?: string | undefined | undefined;
+    autoCapitalize?: "off" | "none" | "on" | "sentences" | "words" | "characters" | undefined | (string & {}) | undefined;
+    autoFocus?: boolean | undefined | undefined;
+    contentEditable?: (boolean | "true" | "false") | "inherit" | "plaintext-only" | undefined;
+    contextMenu?: string | undefined | undefined;
+    dir?: string | undefined | undefined;
+    draggable?: (boolean | "true" | "false") | undefined;
+    enterKeyHint?: "enter" | "done" | "go" | "next" | "previous" | "search" | "send" | undefined | undefined;
+    hidden?: boolean | undefined | undefined;
+    lang?: string | undefined | undefined;
+    nonce?: string | undefined | undefined;
+    slot?: string | undefined | undefined;
+    spellCheck?: (boolean | "true" | "false") | undefined;
+    tabIndex?: number | undefined | undefined;
+    title?: string | undefined | undefined;
+    translate?: "yes" | "no" | undefined | undefined;
+    radioGroup?: string | undefined | undefined;
+    role?: React.AriaRole | undefined;
+    about?: string | undefined | undefined;
+    content?: string | undefined | undefined;
+    datatype?: string | undefined | undefined;
+    inlist?: any;
+    prefix?: string | undefined | undefined;
+    property?: string | undefined | undefined;
+    rel?: string | undefined | undefined;
+    resource?: string | undefined | undefined;
+    rev?: string | undefined | undefined;
+    typeof?: string | undefined | undefined;
+    vocab?: string | undefined | undefined;
+    autoCorrect?: string | undefined | undefined;
+    autoSave?: string | undefined | undefined;
+    color?: string | undefined | undefined;
+    itemProp?: string | undefined | undefined;
+    itemScope?: boolean | undefined | undefined;
+    itemType?: string | undefined | undefined;
+    itemID?: string | undefined | undefined;
+    itemRef?: string | undefined | undefined;
+    results?: number | undefined | undefined;
+    security?: string | undefined | undefined;
+    unselectable?: "on" | "off" | undefined | undefined;
+    popover?: "" | "auto" | "manual" | "hint" | undefined | undefined;
+    popoverTargetAction?: "toggle" | "show" | "hide" | undefined | undefined;
+    popoverTarget?: string | undefined | undefined;
+    inert?: boolean | undefined | undefined;
+    inputMode?: "none" | "text" | "tel" | "url" | "email" | "numeric" | "decimal" | "search" | undefined | undefined;
+    is?: string | undefined | undefined;
+    exportparts?: string | undefined | undefined;
+    part?: string | undefined | undefined;
+    "aria-activedescendant"?: string | undefined | undefined;
+    "aria-atomic"?: (boolean | "true" | "false") | undefined;
+    "aria-autocomplete"?: "none" | "inline" | "list" | "both" | undefined | undefined;
+    "aria-braillelabel"?: string | undefined | undefined;
+    "aria-brailleroledescription"?: string | undefined | undefined;
+    "aria-busy"?: (boolean | "true" | "false") | undefined;
+    "aria-checked"?: boolean | "false" | "mixed" | "true" | undefined | undefined;
+    "aria-colcount"?: number | undefined | undefined;
+    "aria-colindex"?: number | undefined | undefined;
+    "aria-colindextext"?: string | undefined | undefined;
+    "aria-colspan"?: number | undefined | undefined;
+    "aria-controls"?: string | undefined | undefined;
+    "aria-current"?: boolean | "false" | "true" | "page" | "step" | "location" | "date" | "time" | undefined | undefined;
+    "aria-describedby"?: string | undefined | undefined;
+    "aria-description"?: string | undefined | undefined;
+    "aria-details"?: string | undefined | undefined;
+    "aria-disabled"?: (boolean | "true" | "false") | undefined;
+    "aria-dropeffect"?: "none" | "copy" | "execute" | "link" | "move" | "popup" | undefined | undefined;
+    "aria-errormessage"?: string | undefined | undefined;
+    "aria-expanded"?: (boolean | "true" | "false") | undefined;
+    "aria-flowto"?: string | undefined | undefined;
+    "aria-grabbed"?: (boolean | "true" | "false") | undefined;
+    "aria-haspopup"?: boolean | "false" | "true" | "menu" | "listbox" | "tree" | "grid" | "dialog" | undefined | undefined;
+    "aria-hidden"?: (boolean | "true" | "false") | undefined;
+    "aria-invalid"?: boolean | "false" | "true" | "grammar" | "spelling" | undefined | undefined;
+    "aria-keyshortcuts"?: string | undefined | undefined;
+    "aria-label"?: string | undefined | undefined;
+    "aria-labelledby"?: string | undefined | undefined;
+    "aria-level"?: number | undefined | undefined;
+    "aria-live"?: "off" | "assertive" | "polite" | undefined | undefined;
+    "aria-modal"?: (boolean | "true" | "false") | undefined;
+    "aria-multiline"?: (boolean | "true" | "false") | undefined;
+    "aria-multiselectable"?: (boolean | "true" | "false") | undefined;
+    "aria-orientation"?: "horizontal" | "vertical" | undefined | undefined;
+    "aria-owns"?: string | undefined | undefined;
+    "aria-placeholder"?: string | undefined | undefined;
+    "aria-posinset"?: number | undefined | undefined;
+    "aria-pressed"?: boolean | "false" | "mixed" | "true" | undefined | 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 | undefined;
+    "aria-required"?: (boolean | "true" | "false") | undefined;
+    "aria-roledescription"?: string | undefined | undefined;
+    "aria-rowcount"?: number | undefined | undefined;
+    "aria-rowindex"?: number | undefined | undefined;
+    "aria-rowindextext"?: string | undefined | undefined;
+    "aria-rowspan"?: number | undefined | undefined;
+    "aria-selected"?: (boolean | "true" | "false") | undefined;
+    "aria-setsize"?: number | undefined | undefined;
+    "aria-sort"?: "none" | "ascending" | "descending" | "other" | undefined | undefined;
+    "aria-valuemax"?: number | undefined | undefined;
+    "aria-valuemin"?: number | undefined | undefined;
+    "aria-valuenow"?: number | undefined | undefined;
+    "aria-valuetext"?: string | undefined | undefined;
+    dangerouslySetInnerHTML?: {
+        __html: string | TrustedHTML;
+    } | undefined | undefined;
+    onCopy?: React.ClipboardEventHandler<HTMLSpanElement> | undefined;
+    onCopyCapture?: React.ClipboardEventHandler<HTMLSpanElement> | undefined;
+    onCut?: React.ClipboardEventHandler<HTMLSpanElement> | undefined;
+    onCutCapture?: React.ClipboardEventHandler<HTMLSpanElement> | undefined;
+    onPaste?: React.ClipboardEventHandler<HTMLSpanElement> | undefined;
+    onPasteCapture?: React.ClipboardEventHandler<HTMLSpanElement> | undefined;
+    onCompositionEnd?: React.CompositionEventHandler<HTMLSpanElement> | undefined;
+    onCompositionEndCapture?: React.CompositionEventHandler<HTMLSpanElement> | undefined;
+    onCompositionStart?: React.CompositionEventHandler<HTMLSpanElement> | undefined;
+    onCompositionStartCapture?: React.CompositionEventHandler<HTMLSpanElement> | undefined;
+    onCompositionUpdate?: React.CompositionEventHandler<HTMLSpanElement> | undefined;
+    onCompositionUpdateCapture?: React.CompositionEventHandler<HTMLSpanElement> | undefined;
+    onFocus?: React.FocusEventHandler<HTMLSpanElement> | undefined;
+    onFocusCapture?: React.FocusEventHandler<HTMLSpanElement> | undefined;
+    onBlur?: React.FocusEventHandler<HTMLSpanElement> | undefined;
+    onBlurCapture?: React.FocusEventHandler<HTMLSpanElement> | undefined;
+    onChange?: React.ChangeEventHandler<HTMLSpanElement, Element> | undefined;
+    onChangeCapture?: React.ChangeEventHandler<HTMLSpanElement, Element> | undefined;
+    onBeforeInput?: React.InputEventHandler<HTMLSpanElement> | undefined;
+    onBeforeInputCapture?: React.InputEventHandler<HTMLSpanElement> | undefined;
+    onInput?: React.InputEventHandler<HTMLSpanElement> | undefined;
+    onInputCapture?: React.InputEventHandler<HTMLSpanElement> | undefined;
+    onReset?: React.ReactEventHandler<HTMLSpanElement> | undefined;
+    onResetCapture?: React.ReactEventHandler<HTMLSpanElement> | undefined;
+    onSubmit?: React.SubmitEventHandler<HTMLSpanElement> | undefined;
+    onSubmitCapture?: React.SubmitEventHandler<HTMLSpanElement> | undefined;
+    onInvalid?: React.ReactEventHandler<HTMLSpanElement> | undefined;
+    onInvalidCapture?: React.ReactEventHandler<HTMLSpanElement> | undefined;
+    onLoad?: React.ReactEventHandler<HTMLSpanElement> | undefined;
+    onLoadCapture?: React.ReactEventHandler<HTMLSpanElement> | undefined;
+    onError?: React.ReactEventHandler<HTMLSpanElement> | undefined;
+    onErrorCapture?: React.ReactEventHandler<HTMLSpanElement> | undefined;
+    onKeyDown?: React.KeyboardEventHandler<HTMLSpanElement> | undefined;
+    onKeyDownCapture?: React.KeyboardEventHandler<HTMLSpanElement> | undefined;
+    onKeyPress?: React.KeyboardEventHandler<HTMLSpanElement> | undefined;
+    onKeyPressCapture?: React.KeyboardEventHandler<HTMLSpanElement> | undefined;
+    onKeyUp?: React.KeyboardEventHandler<HTMLSpanElement> | undefined;
+    onKeyUpCapture?: React.KeyboardEventHandler<HTMLSpanElement> | undefined;
+    onAbort?: React.ReactEventHandler<HTMLSpanElement> | undefined;
+    onAbortCapture?: React.ReactEventHandler<HTMLSpanElement> | undefined;
+    onCanPlay?: React.ReactEventHandler<HTMLSpanElement> | undefined;
+    onCanPlayCapture?: React.ReactEventHandler<HTMLSpanElement> | undefined;
+    onCanPlayThrough?: React.ReactEventHandler<HTMLSpanElement> | undefined;
+    onCanPlayThroughCapture?: React.ReactEventHandler<HTMLSpanElement> | undefined;
+    onDurationChange?: React.ReactEventHandler<HTMLSpanElement> | undefined;
+    onDurationChangeCapture?: React.ReactEventHandler<HTMLSpanElement> | undefined;
+    onEmptied?: React.ReactEventHandler<HTMLSpanElement> | undefined;
+    onEmptiedCapture?: React.ReactEventHandler<HTMLSpanElement> | undefined;
+    onEncrypted?: React.ReactEventHandler<HTMLSpanElement> | undefined;
+    onEncryptedCapture?: React.ReactEventHandler<HTMLSpanElement> | undefined;
+    onEnded?: React.ReactEventHandler<HTMLSpanElement> | undefined;
+    onEndedCapture?: React.ReactEventHandler<HTMLSpanElement> | undefined;
+    onLoadedData?: React.ReactEventHandler<HTMLSpanElement> | undefined;
+    onLoadedDataCapture?: React.ReactEventHandler<HTMLSpanElement> | undefined;
+    onLoadedMetadata?: React.ReactEventHandler<HTMLSpanElement> | undefined;
+    onLoadedMetadataCapture?: React.ReactEventHandler<HTMLSpanElement> | undefined;
+    onLoadStart?: React.ReactEventHandler<HTMLSpanElement> | undefined;
+    onLoadStartCapture?: React.ReactEventHandler<HTMLSpanElement> | undefined;
+    onPause?: React.ReactEventHandler<HTMLSpanElement> | undefined;
+    onPauseCapture?: React.ReactEventHandler<HTMLSpanElement> | undefined;
+    onPlay?: React.ReactEventHandler<HTMLSpanElement> | undefined;
+    onPlayCapture?: React.ReactEventHandler<HTMLSpanElement> | undefined;
+    onPlaying?: React.ReactEventHandler<HTMLSpanElement> | undefined;
+    onPlayingCapture?: React.ReactEventHandler<HTMLSpanElement> | undefined;
+    onProgress?: React.ReactEventHandler<HTMLSpanElement> | undefined;
+    onProgressCapture?: React.ReactEventHandler<HTMLSpanElement> | undefined;
+    onRateChange?: React.ReactEventHandler<HTMLSpanElement> | undefined;
+    onRateChangeCapture?: React.ReactEventHandler<HTMLSpanElement> | undefined;
+    onSeeked?: React.ReactEventHandler<HTMLSpanElement> | undefined;
+    onSeekedCapture?: React.ReactEventHandler<HTMLSpanElement> | undefined;
+    onSeeking?: React.ReactEventHandler<HTMLSpanElement> | undefined;
+    onSeekingCapture?: React.ReactEventHandler<HTMLSpanElement> | undefined;
+    onStalled?: React.ReactEventHandler<HTMLSpanElement> | undefined;
+    onStalledCapture?: React.ReactEventHandler<HTMLSpanElement> | undefined;
+    onSuspend?: React.ReactEventHandler<HTMLSpanElement> | undefined;
+    onSuspendCapture?: React.ReactEventHandler<HTMLSpanElement> | undefined;
+    onTimeUpdate?: React.ReactEventHandler<HTMLSpanElement> | undefined;
+    onTimeUpdateCapture?: React.ReactEventHandler<HTMLSpanElement> | undefined;
+    onVolumeChange?: React.ReactEventHandler<HTMLSpanElement> | undefined;
+    onVolumeChangeCapture?: React.ReactEventHandler<HTMLSpanElement> | undefined;
+    onWaiting?: React.ReactEventHandler<HTMLSpanElement> | undefined;
+    onWaitingCapture?: React.ReactEventHandler<HTMLSpanElement> | undefined;
+    onAuxClick?: React.MouseEventHandler<HTMLSpanElement> | undefined;
+    onAuxClickCapture?: React.MouseEventHandler<HTMLSpanElement> | undefined;
+    onClick?: React.MouseEventHandler<HTMLSpanElement> | undefined;
+    onClickCapture?: React.MouseEventHandler<HTMLSpanElement> | undefined;
+    onContextMenu?: React.MouseEventHandler<HTMLSpanElement> | undefined;
+    onContextMenuCapture?: React.MouseEventHandler<HTMLSpanElement> | undefined;
+    onDoubleClick?: React.MouseEventHandler<HTMLSpanElement> | undefined;
+    onDoubleClickCapture?: React.MouseEventHandler<HTMLSpanElement> | undefined;
+    onDrag?: React.DragEventHandler<HTMLSpanElement> | undefined;
+    onDragCapture?: React.DragEventHandler<HTMLSpanElement> | undefined;
+    onDragEnd?: React.DragEventHandler<HTMLSpanElement> | undefined;
+    onDragEndCapture?: React.DragEventHandler<HTMLSpanElement> | undefined;
+    onDragEnter?: React.DragEventHandler<HTMLSpanElement> | undefined;
+    onDragEnterCapture?: React.DragEventHandler<HTMLSpanElement> | undefined;
+    onDragExit?: React.DragEventHandler<HTMLSpanElement> | undefined;
+    onDragExitCapture?: React.DragEventHandler<HTMLSpanElement> | undefined;
+    onDragLeave?: React.DragEventHandler<HTMLSpanElement> | undefined;
+    onDragLeaveCapture?: React.DragEventHandler<HTMLSpanElement> | undefined;
+    onDragOver?: React.DragEventHandler<HTMLSpanElement> | undefined;
+    onDragOverCapture?: React.DragEventHandler<HTMLSpanElement> | undefined;
+    onDragStart?: React.DragEventHandler<HTMLSpanElement> | undefined;
+    onDragStartCapture?: React.DragEventHandler<HTMLSpanElement> | undefined;
+    onDrop?: React.DragEventHandler<HTMLSpanElement> | undefined;
+    onDropCapture?: React.DragEventHandler<HTMLSpanElement> | undefined;
+    onMouseDown?: React.MouseEventHandler<HTMLSpanElement> | undefined;
+    onMouseDownCapture?: React.MouseEventHandler<HTMLSpanElement> | undefined;
+    onMouseEnter?: React.MouseEventHandler<HTMLSpanElement> | undefined;
+    onMouseLeave?: React.MouseEventHandler<HTMLSpanElement> | undefined;
+    onMouseMove?: React.MouseEventHandler<HTMLSpanElement> | undefined;
+    onMouseMoveCapture?: React.MouseEventHandler<HTMLSpanElement> | undefined;
+    onMouseOut?: React.MouseEventHandler<HTMLSpanElement> | undefined;
+    onMouseOutCapture?: React.MouseEventHandler<HTMLSpanElement> | undefined;
+    onMouseOver?: React.MouseEventHandler<HTMLSpanElement> | undefined;
+    onMouseOverCapture?: React.MouseEventHandler<HTMLSpanElement> | undefined;
+    onMouseUp?: React.MouseEventHandler<HTMLSpanElement> | undefined;
+    onMouseUpCapture?: React.MouseEventHandler<HTMLSpanElement> | undefined;
+    onSelect?: React.ReactEventHandler<HTMLSpanElement> | undefined;
+    onSelectCapture?: React.ReactEventHandler<HTMLSpanElement> | undefined;
+    onTouchCancel?: React.TouchEventHandler<HTMLSpanElement> | undefined;
+    onTouchCancelCapture?: React.TouchEventHandler<HTMLSpanElement> | undefined;
+    onTouchEnd?: React.TouchEventHandler<HTMLSpanElement> | undefined;
+    onTouchEndCapture?: React.TouchEventHandler<HTMLSpanElement> | undefined;
+    onTouchMove?: React.TouchEventHandler<HTMLSpanElement> | undefined;
+    onTouchMoveCapture?: React.TouchEventHandler<HTMLSpanElement> | undefined;
+    onTouchStart?: React.TouchEventHandler<HTMLSpanElement> | undefined;
+    onTouchStartCapture?: React.TouchEventHandler<HTMLSpanElement> | undefined;
+    onPointerDown?: React.PointerEventHandler<HTMLSpanElement> | undefined;
+    onPointerDownCapture?: React.PointerEventHandler<HTMLSpanElement> | undefined;
+    onPointerMove?: React.PointerEventHandler<HTMLSpanElement> | undefined;
+    onPointerMoveCapture?: React.PointerEventHandler<HTMLSpanElement> | undefined;
+    onPointerUp?: React.PointerEventHandler<HTMLSpanElement> | undefined;
+    onPointerUpCapture?: React.PointerEventHandler<HTMLSpanElement> | undefined;
+    onPointerCancel?: React.PointerEventHandler<HTMLSpanElement> | undefined;
+    onPointerCancelCapture?: React.PointerEventHandler<HTMLSpanElement> | undefined;
+    onPointerEnter?: React.PointerEventHandler<HTMLSpanElement> | undefined;
+    onPointerLeave?: React.PointerEventHandler<HTMLSpanElement> | undefined;
+    onPointerOver?: React.PointerEventHandler<HTMLSpanElement> | undefined;
+    onPointerOverCapture?: React.PointerEventHandler<HTMLSpanElement> | undefined;
+    onPointerOut?: React.PointerEventHandler<HTMLSpanElement> | undefined;
+    onPointerOutCapture?: React.PointerEventHandler<HTMLSpanElement> | undefined;
+    onGotPointerCapture?: React.PointerEventHandler<HTMLSpanElement> | undefined;
+    onGotPointerCaptureCapture?: React.PointerEventHandler<HTMLSpanElement> | undefined;
+    onLostPointerCapture?: React.PointerEventHandler<HTMLSpanElement> | undefined;
+    onLostPointerCaptureCapture?: React.PointerEventHandler<HTMLSpanElement> | undefined;
+    onScroll?: React.UIEventHandler<HTMLSpanElement> | undefined;
+    onScrollCapture?: React.UIEventHandler<HTMLSpanElement> | undefined;
+    onScrollEnd?: React.UIEventHandler<HTMLSpanElement> | undefined;
+    onScrollEndCapture?: React.UIEventHandler<HTMLSpanElement> | undefined;
+    onWheel?: React.WheelEventHandler<HTMLSpanElement> | undefined;
+    onWheelCapture?: React.WheelEventHandler<HTMLSpanElement> | undefined;
+    onAnimationStart?: React.AnimationEventHandler<HTMLSpanElement> | undefined;
+    onAnimationStartCapture?: React.AnimationEventHandler<HTMLSpanElement> | undefined;
+    onAnimationEnd?: React.AnimationEventHandler<HTMLSpanElement> | undefined;
+    onAnimationEndCapture?: React.AnimationEventHandler<HTMLSpanElement> | undefined;
+    onAnimationIteration?: React.AnimationEventHandler<HTMLSpanElement> | undefined;
+    onAnimationIterationCapture?: React.AnimationEventHandler<HTMLSpanElement> | undefined;
+    onToggle?: React.ToggleEventHandler<HTMLSpanElement> | undefined;
+    onBeforeToggle?: React.ToggleEventHandler<HTMLSpanElement> | undefined;
+    onTransitionCancel?: React.TransitionEventHandler<HTMLSpanElement> | undefined;
+    onTransitionCancelCapture?: React.TransitionEventHandler<HTMLSpanElement> | undefined;
+    onTransitionEnd?: React.TransitionEventHandler<HTMLSpanElement> | undefined;
+    onTransitionEndCapture?: React.TransitionEventHandler<HTMLSpanElement> | undefined;
+    onTransitionRun?: React.TransitionEventHandler<HTMLSpanElement> | undefined;
+    onTransitionRunCapture?: React.TransitionEventHandler<HTMLSpanElement> | undefined;
+    onTransitionStart?: React.TransitionEventHandler<HTMLSpanElement> | undefined;
+    onTransitionStartCapture?: React.TransitionEventHandler<HTMLSpanElement> | undefined;
+}>;
+
+export { VisuallyHidden };

package/dist/types/components/primitives/VisuallyHidden/VisuallyHidden.types.d.ts

@@ -0,0 +1,29 @@
+import React from 'react';
+import { BaseComponent } from '../../../types/common.js';
+import { Prettify } from '../../../types/utilities.js';
+
+/**
+ * HTML element types that VisuallyHidden can render as.
+ *
+ * Most cases use `span` (default). Use `div` when wrapping block content,
+ * `label` for form labels, `p` for prose.
+ */
+type VisuallyHiddenElement = 'span' | 'div' | 'label' | 'p';
+interface VisuallyHiddenBaseProps extends BaseComponent<HTMLSpanElement> {
+    /**
+     * HTML element to render as.
+     * @default "span"
+     */
+    as?: VisuallyHiddenElement;
+    /**
+     * When true, the element becomes visible when it (or any descendant)
+     * receives focus. Used for skip-to-content links.
+     * @default false
+     */
+    focusable?: boolean;
+    /** Content rendered inside the hidden region. */
+    children: React.ReactNode;
+}
+type VisuallyHiddenProps = Prettify<VisuallyHiddenBaseProps>;
+
+export type { VisuallyHiddenBaseProps, VisuallyHiddenElement, VisuallyHiddenProps };

package/dist/types/hooks/useClickOutside/useClickOutside.d.ts

@@ -0,0 +1,37 @@
+import { RefObject } from 'react';
+
+interface UseClickOutsideOptions {
+    /**
+     * When false, the listener is not attached. Useful for toggling without
+     * unmount.
+     * @default true
+     */
+    enabled?: boolean;
+    /**
+     * Mouse / pointer event to listen for.
+     * @default 'mousedown'
+     */
+    event?: 'mousedown' | 'click' | 'pointerdown';
+}
+/**
+ * Fire a callback when a click occurs outside the referenced element(s).
+ *
+ * Accepts either a single ref or an array of refs. The handler fires only
+ * when the click lands outside ALL provided refs — useful for popover +
+ * trigger pairs where clicking either should be considered "inside".
+ *
+ * Defaults to `mousedown` so the handler runs before `click`. SSR-safe;
+ * cleans up on unmount and when `enabled` flips to `false`.
+ *
+ * @example
+ * ```tsx
+ * const ref = useRef<HTMLDivElement>(null);
+ * useClickOutside(ref, () => setOpen(false), { enabled: isOpen });
+ *
+ * return <div ref={ref}>...</div>;
+ * ```
+ */
+declare function useClickOutside<T extends HTMLElement = HTMLElement>(ref: RefObject<T | null> | Array<RefObject<HTMLElement | null>>, handler: (event: MouseEvent) => void, options?: UseClickOutsideOptions): void;
+
+export { useClickOutside };
+export type { UseClickOutsideOptions };

package/dist/types/hooks/useClipboard/useClipboard.d.ts

@@ -0,0 +1,24 @@
+import { UseClipboardOptions, UseClipboardReturn } from './useClipboard.types.js';
+
+/**
+ * Copy text to the clipboard with a built-in timeout-driven feedback state.
+ *
+ * Uses `navigator.clipboard.writeText` when available; falls back to
+ * `document.execCommand('copy')` only when the modern API is missing.
+ * In SSR or restricted contexts where neither path is available, `copy`
+ * resolves to `false` and `status` flips to `'error'` without throwing.
+ *
+ * @example
+ * ```tsx
+ * const { copy, copied } = useClipboard({ timeout: 1500 });
+ *
+ * return (
+ *   <Button onClick={() => copy('Hello!')}>
+ *     {copied ? 'Copied!' : 'Copy'}
+ *   </Button>
+ * );
+ * ```
+ */
+declare function useClipboard(options?: UseClipboardOptions): UseClipboardReturn;
+
+export { useClipboard };

package/dist/types/hooks/useClipboard/useClipboard.types.d.ts

@@ -0,0 +1,22 @@
+type ClipboardStatus = 'idle' | 'copied' | 'error';
+interface UseClipboardOptions {
+    /**
+     * How long the `copied` state stays before resetting to `idle`, in ms.
+     * @default 2000
+     */
+    timeout?: number;
+}
+interface UseClipboardReturn {
+    /** Current state — flips to 'copied' for `timeout` ms after a successful copy. */
+    status: ClipboardStatus;
+    /** Convenience boolean — `status === 'copied'`. */
+    copied: boolean;
+    /** Last error from a failed copy attempt, if any. */
+    error: Error | null;
+    /** Copy text to clipboard. Returns the resolved success boolean. */
+    copy: (text: string) => Promise<boolean>;
+    /** Manually reset status to 'idle'. */
+    reset: () => void;
+}
+
+export type { ClipboardStatus, UseClipboardOptions, UseClipboardReturn };

package/dist/types/hooks/useControlledState/useControlledState.d.ts

@@ -0,0 +1,38 @@
+interface UseControlledStateOptions<T> {
+    /** Controlled value — when defined, drives the returned value. */
+    value?: T;
+    /** Default value used when the hook is uncontrolled. */
+    defaultValue?: T;
+    /** Called when the consumer requests a change in either mode. */
+    onChange?: (value: T) => void;
+    /** Fallback used when both `value` and `defaultValue` are undefined. */
+    fallback: T;
+}
+/**
+ * Manage a value that may be either controlled (via prop) or uncontrolled
+ * (managed internally with a default).
+ *
+ * Returns a `[value, setValue]` tuple just like `useState`. When
+ * `options.value` is defined the state is read from there and `setValue`
+ * becomes a pure side-effect callback that calls `onChange` only — internal
+ * state is never mutated. When `options.value` is undefined the hook owns the
+ * state and `setValue` updates it as well as calls `onChange`.
+ *
+ * Switching between controlled and uncontrolled within a component's lifetime
+ * is a known pitfall (matches React's own warning for `<input value/defaultValue>`).
+ * The hook emits a development-only warning when this happens.
+ *
+ * @example
+ * ```ts
+ * const [value, setValue] = useControlledState({
+ *   value: props.value,
+ *   defaultValue: props.defaultValue,
+ *   onChange: props.onChange,
+ *   fallback: '',
+ * });
+ * ```
+ */
+declare function useControlledState<T>(options: UseControlledStateOptions<T>): [T, (next: T | ((prev: T) => T)) => void];
+
+export { useControlledState };
+export type { UseControlledStateOptions };

package/dist/types/hooks/useDisclosure/useDisclosure.d.ts

@@ -0,0 +1,25 @@
+import { UseDisclosureOptions, UseDisclosureReturn } from './useDisclosure.types.js';
+
+/**
+ * Manage an open/closed state with stable `open`, `close`, `toggle` callbacks.
+ *
+ * Supports both controlled (driven by an `open` prop) and uncontrolled
+ * (managed internally with `defaultOpen`) modes. Built on top of
+ * `useControlledState` so the same controlled / uncontrolled rules apply —
+ * including the development warning when switching modes mid-life.
+ *
+ * @example
+ * ```tsx
+ * const { isOpen, open, close, toggle } = useDisclosure();
+ *
+ * return (
+ *   <>
+ *     <Button onClick={open}>Open</Button>
+ *     <Dialog open={isOpen} onClose={close}>...</Dialog>
+ *   </>
+ * );
+ * ```
+ */
+declare function useDisclosure(options?: UseDisclosureOptions): UseDisclosureReturn;
+
+export { useDisclosure };

package/dist/types/hooks/useDisclosure/useDisclosure.types.d.ts

@@ -0,0 +1,22 @@
+interface UseDisclosureOptions {
+    /** Initial state for uncontrolled mode. @default false */
+    defaultOpen?: boolean;
+    /** Controlled value — when defined, drives the returned state. */
+    open?: boolean;
+    /** Called when state changes (from either controlled or uncontrolled paths). */
+    onOpenChange?: (open: boolean) => void;
+}
+interface UseDisclosureReturn {
+    /** Current open state. */
+    isOpen: boolean;
+    /** Set open to `true`. */
+    open: () => void;
+    /** Set open to `false`. */
+    close: () => void;
+    /** Flip current open state. */
+    toggle: () => void;
+    /** Set open to an explicit value. */
+    setOpen: (next: boolean) => void;
+}
+
+export type { UseDisclosureOptions, UseDisclosureReturn };

package/dist/types/hooks/useFocusTrap/useFocusTrap.d.ts

@@ -0,0 +1,30 @@
+import { RefObject, KeyboardEvent } from 'react';
+
+interface UseFocusTrapOptions {
+    /** Ref to the container element whose focusable descendants are trapped. */
+    containerRef: RefObject<HTMLElement | null>;
+    /**
+     * When false, the trap is bypassed (Tab works normally). Useful for toggling
+     * trap state without unmounting.
+     * @default true
+     */
+    enabled?: boolean;
+}
+/**
+ * Trap focus within a container element. Tab and Shift+Tab cycle through the
+ * focusable descendants without escaping the container.
+ *
+ * Returns a keyboard event handler to attach to the container's `onKeyDown`.
+ *
+ * @example
+ * ```tsx
+ * const ref = useRef<HTMLDivElement>(null);
+ * const handleKeyDown = useFocusTrap({ containerRef: ref, enabled: isOpen });
+ *
+ * return <div ref={ref} onKeyDown={handleKeyDown}>...</div>;
+ * ```
+ */
+declare function useFocusTrap({ containerRef, enabled, }: UseFocusTrapOptions): (event: KeyboardEvent) => void;
+
+export { useFocusTrap };
+export type { UseFocusTrapOptions };

package/dist/types/hooks/useHotkey/useHotkey.d.ts

@@ -0,0 +1,23 @@
+import { UseHotkeyOptions } from './useHotkey.types.js';
+
+/**
+ * Bind a single keyboard combo to a callback.
+ *
+ * Combos use the same `+`-separated string format as `MenuBar`'s `shortcut`
+ * prop: `"Ctrl+S"`, `"Cmd+Shift+P"`, `"Escape"`. Modifiers: `Ctrl`, `Cmd`
+ * (= Meta), `Alt` / `Option`, `Shift`. `Cmd` automatically maps to `Ctrl` on
+ * non-Mac platforms via `getPlatform()`.
+ *
+ * The handler reference is stable — passing a fresh inline function on every
+ * render is safe and does not re-subscribe the underlying listener.
+ *
+ * @example
+ * ```tsx
+ * useHotkey('Ctrl+S', e => save(), { preventDefault: true });
+ * useHotkey('Escape', () => setOpen(false));
+ * useHotkey('Cmd+K', () => openCommandPalette()); // Cmd on Mac, Ctrl elsewhere
+ * ```
+ */
+declare function useHotkey(combo: string, handler: (event: KeyboardEvent) => void, options?: UseHotkeyOptions): void;
+
+export { useHotkey };

package/dist/types/hooks/useHotkey/useHotkey.types.d.ts

@@ -0,0 +1,36 @@
+import { RefObject } from 'react';
+
+type HotkeyTarget = EventTarget | RefObject<EventTarget | null> | null;
+interface UseHotkeyOptions {
+    /**
+     * When false, the binding is not active.
+     * @default true
+     */
+    enabled?: boolean;
+    /**
+     * Whether to fire when focus is inside an editable element
+     * (`<input>`, `<textarea>`, `[contenteditable]`).
+     * @default false
+     */
+    enableInInputs?: boolean;
+    /**
+     * Call `event.preventDefault()` before invoking the handler.
+     * @default true
+     */
+    preventDefault?: boolean;
+    /**
+     * Call `event.stopPropagation()` after the handler runs.
+     * @default false
+     */
+    stopPropagation?: boolean;
+    /**
+     * Override the target element. Accepts either an `EventTarget` directly
+     * (e.g. `document`, an `HTMLElement`) or a `RefObject` whose `.current`
+     * resolves to one. The latter form re-attaches the listener once the ref
+     * mounts, so passing `ref` directly works without waiting a render. Defaults
+     * to `window`.
+     */
+    target?: HotkeyTarget;
+}
+
+export type { HotkeyTarget, UseHotkeyOptions };

package/dist/types/hooks/useKeyboard/types.d.ts

@@ -0,0 +1,14 @@
+import { LiteralUnion } from '../../types/utilities.js';
+
+type ModifierKeys = 'control' | 'shift' | 'alt' | 'meta';
+type KeyCode = string;
+type KeyboardModifierKeysState = {
+    [key in ModifierKeys]: boolean;
+};
+type KeyboardState = {
+    pressedKeys: KeyCode[];
+    modifiers: KeyboardModifierKeysState;
+};
+type AllKeys = LiteralUnion<ModifierKeys, string>;
+
+export type { AllKeys, KeyCode, KeyboardModifierKeysState, KeyboardState, ModifierKeys };