@mieweb/ui 0.6.1 → 0.7.0-dev.179

package/dist/types-CBh8Zlje.d.cts

@@ -0,0 +1,240 @@
+import * as React from 'react';
+import { A as AIMessageContent, a as AIMessageStatus } from './types-BYnLjEFg.cjs';
+
+/**
+ * SuperChat Types
+ *
+ * A multi-participant chat model that generalizes the AI module's
+ * `user`/`assistant` roles and the standalone `chat-component`'s
+ * `external`/`internal`/`system` roles into a single **participant** concept,
+ * plus the pluggable Markdown render pipeline contracts.
+ *
+ * See `MAINTAINERS.md` (Mission → Decisions 2 & 3) for the design rationale.
+ */
+
+/** What kind of actor a participant is. */
+type ParticipantKind = 'human' | 'agent' | 'system';
+/** Presence/activity status for a participant. */
+type ParticipantStatus = 'online' | 'offline' | 'busy' | 'typing';
+/**
+ * A single actor in a conversation. Any mix of multiple agents and multiple
+ * humans can participate in one conversation.
+ */
+interface Participant {
+    /** Stable unique id, referenced by `SuperChatMessage.participantId`. */
+    id: string;
+    /** Whether this is a human, an AI agent, or the system. */
+    kind: ParticipantKind;
+    /** Display name. */
+    name: string;
+    /** Optional avatar image URL. */
+    avatar?: string;
+    /**
+     * Optional accent color (any CSS color) used as a visual cue so concurrent /
+     * interleaved replies from multiple agents stay legible.
+     */
+    color?: string;
+    /** Optional sub-label, e.g. "Triage agent" or "Front desk". */
+    role?: string;
+    /** Optional presence indicator. */
+    status?: ParticipantStatus;
+}
+/** Channel a message arrived/was sent on (healthcare-messaging compatible). */
+type SuperChatChannel = 'portal' | 'sms' | 'voicemail' | 'auto' | (string & {});
+/** Reference attachment carried by a `ref` thread item. */
+interface SuperChatRef {
+    /** Kind of referenced entity. */
+    refType: 'doc' | 'rx' | 'appt' | (string & {});
+    /** Id of the referenced entity. */
+    refId: string;
+    /** Display title for the reference. */
+    title: string;
+}
+/** Kind of thread item. */
+type SuperChatItemType = 'message' | 'ref' | 'system';
+/**
+ * A single thread item. Preserves the `chat-component` thread-item shape
+ * (`senderId`/`sender_name`/`channel`/`time`/`text`) while adding a
+ * `participantId` (Decision 2) and optional rich `content` blocks reused from
+ * the AI module.
+ */
+interface SuperChatMessage {
+    /** Unique identifier. */
+    id: string;
+    /** Item type. Defaults to `'message'`. */
+    type?: SuperChatItemType;
+    /** Participant who authored the item. */
+    participantId: string;
+    /** Plain-text body (rendered through the Markdown pipeline). */
+    text?: string;
+    /**
+     * Optional rich content blocks (text / tool_use / tool_result / thinking /
+     * code), reused from the AI module for tool-call visualization etc.
+     */
+    content?: AIMessageContent[];
+    /** Timestamp; the thread is append-only and ordered by `time`. */
+    time: Date | string;
+    /**
+     * Timestamp of the most recent edit, if the message has been edited. When
+     * set, surfaces an "(edited)" indicator next to the message time.
+     */
+    editedAt?: Date | string;
+    /** Delivery/generation status. */
+    status?: AIMessageStatus;
+    /** Channel the item belongs to. */
+    channel?: SuperChatChannel;
+    /** Reference payload when `type === 'ref'`. */
+    ref?: SuperChatRef;
+    /** Participant ids addressed via `@`-mention. */
+    mentions?: string[];
+    /** Custom metadata. */
+    metadata?: Record<string, unknown>;
+    /** @deprecated use `participantId`. */
+    senderId?: string;
+    /** @deprecated derive from the participant. */
+    sender_name?: string;
+}
+/**
+ * A file (typically an image) the local user pasted or attached in the
+ * composer, surfaced to the host via the send callback so it can be embedded,
+ * uploaded, or otherwise added to the conversation.
+ */
+interface ComposerAttachment {
+    /** Stable id for the attachment (unique within a single draft). */
+    id: string;
+    /** File name, derived from the pasted file or a generated fallback. */
+    name: string;
+    /** MIME type, e.g. `image/png`. */
+    type: string;
+    /** Base64 `data:` URL of the file contents. */
+    dataUrl: string;
+}
+/**
+ * Categories of files the composer can accept. Developers pick which kinds are
+ * allowed via `acceptedFileTypes`; each maps to an `<input accept>` token and a
+ * MIME matcher used to filter pastes and file-picker selections.
+ * - `image` → `image/*`
+ * - `video` → `video/*`
+ * - `audio` → `audio/*`
+ * - `pdf` → `application/pdf`
+ */
+type AttachmentKind = 'image' | 'video' | 'audio' | 'pdf';
+/** A conversation: participants + an ordered thread. */
+interface SuperChatConversation {
+    /** Unique identifier. */
+    id: string;
+    /** Display title. */
+    title: string;
+    /** Optional external reference id (e.g. patient/chart id). */
+    reference_id?: string;
+    /** Whether the conversation is currently open. */
+    open?: boolean;
+    /** Unread message count. */
+    unread?: number;
+    /** Timestamp of the last activity (used for sidebar ordering). */
+    lastActivity?: Date | string;
+    /** Everyone taking part in this conversation. */
+    participants: Participant[];
+    /** Ordered thread items. */
+    thread: SuperChatMessage[];
+}
+/** Builds an href for a reference item (e.g. doc/rx/appt deep link). */
+type SuperChatLinkBuilder = (ref: SuperChatRef) => string | undefined;
+/**
+ * A unified remark/rehype plugin entry. Kept dependency-light here (the public
+ * type surface stays zero-dep); the composer casts to the concrete
+ * `react-markdown` `PluggableList` type.
+ */
+type SuperChatPluggable = unknown;
+type SuperChatPluggableList = SuperChatPluggable[];
+/**
+ * A render plugin contributes remark/rehype plugins, custom node components,
+ * and/or GenUI widgets to the Markdown pipeline. Plugins are composed into a
+ * single `renderTextContent` implementation.
+ */
+interface SuperChatRenderPlugin {
+    /** Unique plugin name. */
+    name: string;
+    /** remark plugins to add (operate on the Markdown AST). */
+    remarkPlugins?: SuperChatPluggableList;
+    /** rehype plugins to add (operate on the HTML AST). */
+    rehypePlugins?: SuperChatPluggableList;
+    /** Custom React components keyed by node/tag name. */
+    components?: Record<string, React.ComponentType<Record<string, unknown>>>;
+    /** Named interactive widgets for fenced ```genui blocks. */
+    widgets?: GenUIRegistry;
+    /**
+     * Optional contribution to the `rehype-sanitize` allow-list schema, merged by
+     * the composer so token classNames / KaTeX markup survive sanitization.
+     */
+    sanitizeSchema?: Record<string, unknown>;
+}
+/** When to prefetch a GenUI widget's code/data. */
+type GenUIPrefetchPolicy = 'eager' | 'visible' | 'idle';
+/**
+ * Minimal subset of the Standard Schema (https://standardschema.dev) interface,
+ * implemented by zod v4 and others, used to validate untrusted widget payloads.
+ */
+interface StandardSchemaV1<Output = unknown, Input = Output> {
+    readonly '~standard': {
+        readonly version: 1;
+        readonly vendor: string;
+        readonly validate: (value: unknown) => {
+            readonly value: Output;
+        } | {
+            readonly issues: ReadonlyArray<{
+                readonly message: string;
+            }>;
+        } | Promise<{
+            readonly value: Output;
+        } | {
+            readonly issues: ReadonlyArray<{
+                readonly message: string;
+            }>;
+        }>;
+        readonly types?: {
+            readonly input: Input;
+            readonly output: Output;
+        };
+    };
+}
+/** Props passed to a host-registered GenUI widget. */
+interface GenUIWidgetProps<T = unknown> {
+    /** Payload, validated against the entry's `schema` when provided. */
+    data: T;
+    /** Render-time metadata. */
+    meta: {
+        name: string;
+        version?: number;
+        messageId: string;
+        streaming: boolean;
+    };
+}
+/** A single registry entry: lazy code + optional schema/prefetch policy. */
+interface GenUIWidgetEntry<T = unknown> {
+    /** Lazy chunk — keeps the widget out of the base bundle. */
+    component: () => Promise<{
+        default: React.ComponentType<GenUIWidgetProps<T>>;
+    }>;
+    /** Optional runtime validation of the untrusted payload. */
+    schema?: StandardSchemaV1<T>;
+    /** Default policy if the wire payload omits one. */
+    prefetch?: GenUIPrefetchPolicy;
+    /** Optional data prefetch, distinct from loading the component code. */
+    prefetchData?: (data: T) => Promise<unknown>;
+}
+/** Map of widget base-name → entry. Versions are resolved explicitly. */
+type GenUIRegistry = Record<string, GenUIWidgetEntry>;
+/** Parsed body of a fenced ```genui block. */
+interface GenUIBlockPayload {
+    /** Widget base name (resolved against the registry). */
+    widget: string;
+    /** Explicit version selector. */
+    version?: number;
+    /** Wire-level prefetch hint (registry policy overrides this). */
+    prefetch?: GenUIPrefetchPolicy;
+    /** Arbitrary widget props. */
+    props?: unknown;
+}
+
+export type { AttachmentKind as A, ComposerAttachment as C, GenUIBlockPayload as G, Participant as P, SuperChatConversation as S, SuperChatRenderPlugin as a, SuperChatLinkBuilder as b, SuperChatRef as c, GenUIPrefetchPolicy as d, GenUIRegistry as e, GenUIWidgetEntry as f, GenUIWidgetProps as g, ParticipantKind as h, ParticipantStatus as i, StandardSchemaV1 as j, SuperChatChannel as k, SuperChatItemType as l, SuperChatMessage as m, SuperChatPluggable as n, SuperChatPluggableList as o };

package/dist/types-CyCwYBlr.d.ts

@@ -0,0 +1,240 @@
+import * as React from 'react';
+import { A as AIMessageContent, a as AIMessageStatus } from './types-BYnLjEFg.js';
+
+/**
+ * SuperChat Types
+ *
+ * A multi-participant chat model that generalizes the AI module's
+ * `user`/`assistant` roles and the standalone `chat-component`'s
+ * `external`/`internal`/`system` roles into a single **participant** concept,
+ * plus the pluggable Markdown render pipeline contracts.
+ *
+ * See `MAINTAINERS.md` (Mission → Decisions 2 & 3) for the design rationale.
+ */
+
+/** What kind of actor a participant is. */
+type ParticipantKind = 'human' | 'agent' | 'system';
+/** Presence/activity status for a participant. */
+type ParticipantStatus = 'online' | 'offline' | 'busy' | 'typing';
+/**
+ * A single actor in a conversation. Any mix of multiple agents and multiple
+ * humans can participate in one conversation.
+ */
+interface Participant {
+    /** Stable unique id, referenced by `SuperChatMessage.participantId`. */
+    id: string;
+    /** Whether this is a human, an AI agent, or the system. */
+    kind: ParticipantKind;
+    /** Display name. */
+    name: string;
+    /** Optional avatar image URL. */
+    avatar?: string;
+    /**
+     * Optional accent color (any CSS color) used as a visual cue so concurrent /
+     * interleaved replies from multiple agents stay legible.
+     */
+    color?: string;
+    /** Optional sub-label, e.g. "Triage agent" or "Front desk". */
+    role?: string;
+    /** Optional presence indicator. */
+    status?: ParticipantStatus;
+}
+/** Channel a message arrived/was sent on (healthcare-messaging compatible). */
+type SuperChatChannel = 'portal' | 'sms' | 'voicemail' | 'auto' | (string & {});
+/** Reference attachment carried by a `ref` thread item. */
+interface SuperChatRef {
+    /** Kind of referenced entity. */
+    refType: 'doc' | 'rx' | 'appt' | (string & {});
+    /** Id of the referenced entity. */
+    refId: string;
+    /** Display title for the reference. */
+    title: string;
+}
+/** Kind of thread item. */
+type SuperChatItemType = 'message' | 'ref' | 'system';
+/**
+ * A single thread item. Preserves the `chat-component` thread-item shape
+ * (`senderId`/`sender_name`/`channel`/`time`/`text`) while adding a
+ * `participantId` (Decision 2) and optional rich `content` blocks reused from
+ * the AI module.
+ */
+interface SuperChatMessage {
+    /** Unique identifier. */
+    id: string;
+    /** Item type. Defaults to `'message'`. */
+    type?: SuperChatItemType;
+    /** Participant who authored the item. */
+    participantId: string;
+    /** Plain-text body (rendered through the Markdown pipeline). */
+    text?: string;
+    /**
+     * Optional rich content blocks (text / tool_use / tool_result / thinking /
+     * code), reused from the AI module for tool-call visualization etc.
+     */
+    content?: AIMessageContent[];
+    /** Timestamp; the thread is append-only and ordered by `time`. */
+    time: Date | string;
+    /**
+     * Timestamp of the most recent edit, if the message has been edited. When
+     * set, surfaces an "(edited)" indicator next to the message time.
+     */
+    editedAt?: Date | string;
+    /** Delivery/generation status. */
+    status?: AIMessageStatus;
+    /** Channel the item belongs to. */
+    channel?: SuperChatChannel;
+    /** Reference payload when `type === 'ref'`. */
+    ref?: SuperChatRef;
+    /** Participant ids addressed via `@`-mention. */
+    mentions?: string[];
+    /** Custom metadata. */
+    metadata?: Record<string, unknown>;
+    /** @deprecated use `participantId`. */
+    senderId?: string;
+    /** @deprecated derive from the participant. */
+    sender_name?: string;
+}
+/**
+ * A file (typically an image) the local user pasted or attached in the
+ * composer, surfaced to the host via the send callback so it can be embedded,
+ * uploaded, or otherwise added to the conversation.
+ */
+interface ComposerAttachment {
+    /** Stable id for the attachment (unique within a single draft). */
+    id: string;
+    /** File name, derived from the pasted file or a generated fallback. */
+    name: string;
+    /** MIME type, e.g. `image/png`. */
+    type: string;
+    /** Base64 `data:` URL of the file contents. */
+    dataUrl: string;
+}
+/**
+ * Categories of files the composer can accept. Developers pick which kinds are
+ * allowed via `acceptedFileTypes`; each maps to an `<input accept>` token and a
+ * MIME matcher used to filter pastes and file-picker selections.
+ * - `image` → `image/*`
+ * - `video` → `video/*`
+ * - `audio` → `audio/*`
+ * - `pdf` → `application/pdf`
+ */
+type AttachmentKind = 'image' | 'video' | 'audio' | 'pdf';
+/** A conversation: participants + an ordered thread. */
+interface SuperChatConversation {
+    /** Unique identifier. */
+    id: string;
+    /** Display title. */
+    title: string;
+    /** Optional external reference id (e.g. patient/chart id). */
+    reference_id?: string;
+    /** Whether the conversation is currently open. */
+    open?: boolean;
+    /** Unread message count. */
+    unread?: number;
+    /** Timestamp of the last activity (used for sidebar ordering). */
+    lastActivity?: Date | string;
+    /** Everyone taking part in this conversation. */
+    participants: Participant[];
+    /** Ordered thread items. */
+    thread: SuperChatMessage[];
+}
+/** Builds an href for a reference item (e.g. doc/rx/appt deep link). */
+type SuperChatLinkBuilder = (ref: SuperChatRef) => string | undefined;
+/**
+ * A unified remark/rehype plugin entry. Kept dependency-light here (the public
+ * type surface stays zero-dep); the composer casts to the concrete
+ * `react-markdown` `PluggableList` type.
+ */
+type SuperChatPluggable = unknown;
+type SuperChatPluggableList = SuperChatPluggable[];
+/**
+ * A render plugin contributes remark/rehype plugins, custom node components,
+ * and/or GenUI widgets to the Markdown pipeline. Plugins are composed into a
+ * single `renderTextContent` implementation.
+ */
+interface SuperChatRenderPlugin {
+    /** Unique plugin name. */
+    name: string;
+    /** remark plugins to add (operate on the Markdown AST). */
+    remarkPlugins?: SuperChatPluggableList;
+    /** rehype plugins to add (operate on the HTML AST). */
+    rehypePlugins?: SuperChatPluggableList;
+    /** Custom React components keyed by node/tag name. */
+    components?: Record<string, React.ComponentType<Record<string, unknown>>>;
+    /** Named interactive widgets for fenced ```genui blocks. */
+    widgets?: GenUIRegistry;
+    /**
+     * Optional contribution to the `rehype-sanitize` allow-list schema, merged by
+     * the composer so token classNames / KaTeX markup survive sanitization.
+     */
+    sanitizeSchema?: Record<string, unknown>;
+}
+/** When to prefetch a GenUI widget's code/data. */
+type GenUIPrefetchPolicy = 'eager' | 'visible' | 'idle';
+/**
+ * Minimal subset of the Standard Schema (https://standardschema.dev) interface,
+ * implemented by zod v4 and others, used to validate untrusted widget payloads.
+ */
+interface StandardSchemaV1<Output = unknown, Input = Output> {
+    readonly '~standard': {
+        readonly version: 1;
+        readonly vendor: string;
+        readonly validate: (value: unknown) => {
+            readonly value: Output;
+        } | {
+            readonly issues: ReadonlyArray<{
+                readonly message: string;
+            }>;
+        } | Promise<{
+            readonly value: Output;
+        } | {
+            readonly issues: ReadonlyArray<{
+                readonly message: string;
+            }>;
+        }>;
+        readonly types?: {
+            readonly input: Input;
+            readonly output: Output;
+        };
+    };
+}
+/** Props passed to a host-registered GenUI widget. */
+interface GenUIWidgetProps<T = unknown> {
+    /** Payload, validated against the entry's `schema` when provided. */
+    data: T;
+    /** Render-time metadata. */
+    meta: {
+        name: string;
+        version?: number;
+        messageId: string;
+        streaming: boolean;
+    };
+}
+/** A single registry entry: lazy code + optional schema/prefetch policy. */
+interface GenUIWidgetEntry<T = unknown> {
+    /** Lazy chunk — keeps the widget out of the base bundle. */
+    component: () => Promise<{
+        default: React.ComponentType<GenUIWidgetProps<T>>;
+    }>;
+    /** Optional runtime validation of the untrusted payload. */
+    schema?: StandardSchemaV1<T>;
+    /** Default policy if the wire payload omits one. */
+    prefetch?: GenUIPrefetchPolicy;
+    /** Optional data prefetch, distinct from loading the component code. */
+    prefetchData?: (data: T) => Promise<unknown>;
+}
+/** Map of widget base-name → entry. Versions are resolved explicitly. */
+type GenUIRegistry = Record<string, GenUIWidgetEntry>;
+/** Parsed body of a fenced ```genui block. */
+interface GenUIBlockPayload {
+    /** Widget base name (resolved against the registry). */
+    widget: string;
+    /** Explicit version selector. */
+    version?: number;
+    /** Wire-level prefetch hint (registry policy overrides this). */
+    prefetch?: GenUIPrefetchPolicy;
+    /** Arbitrary widget props. */
+    props?: unknown;
+}
+
+export type { AttachmentKind as A, ComposerAttachment as C, GenUIBlockPayload as G, Participant as P, SuperChatConversation as S, SuperChatRenderPlugin as a, SuperChatLinkBuilder as b, SuperChatRef as c, GenUIPrefetchPolicy as d, GenUIRegistry as e, GenUIWidgetEntry as f, GenUIWidgetProps as g, ParticipantKind as h, ParticipantStatus as i, StandardSchemaV1 as j, SuperChatChannel as k, SuperChatItemType as l, SuperChatMessage as m, SuperChatPluggable as n, SuperChatPluggableList as o };

package/dist/useAnchoredPosition-nXdSFKHf.d.cts

@@ -0,0 +1,65 @@
+import * as React from 'react';
+
+type AnchoredPlacement = 'bottom-start' | 'bottom-end' | 'bottom' | 'top-start' | 'top-end' | 'top';
+interface UseAnchoredPositionOptions {
+    /** Whether the floating element is currently shown */
+    open: boolean;
+    /** Preferred placement relative to the anchor (flips when out of space) */
+    placement?: AnchoredPlacement;
+    /** Gap between the anchor and the floating element, in px */
+    offset?: number;
+    /** Force the floating element to the anchor's width */
+    matchWidth?: boolean;
+    /** Use the anchor's width as the floating element's minimum width */
+    matchMinWidth?: boolean;
+    /** Minimum distance from the viewport edges, in px */
+    viewportPadding?: number;
+    /**
+     * Additional cap on the floating element's height, in px. The height is
+     * always clamped to the available viewport space; this only lowers that
+     * limit further (omitting it does not remove the viewport constraint).
+     */
+    maxHeight?: number;
+}
+interface UseAnchoredPositionReturn<TAnchor extends HTMLElement, TFloating extends HTMLElement> {
+    /** Attach to the element the popup is anchored to (trigger/input) */
+    anchorRef: React.RefObject<TAnchor | null>;
+    /** Attach to the floating element (menu/listbox/panel) */
+    floatingRef: React.RefObject<TFloating | null>;
+    /** Fixed-position style for the floating element — spread onto it */
+    style: React.CSSProperties;
+    /** Vertical side in use after flipping ('top' or 'bottom') */
+    actualSide: 'top' | 'bottom';
+    /** Recompute the position (e.g. after async content loads) */
+    update: () => void;
+}
+/**
+ * Positions a floating element (dropdown menu, autocomplete listbox,
+ * date-picker calendar, …) relative to an anchor using `position: fixed`,
+ * so it is never clipped by `overflow: hidden` ancestors.
+ *
+ * Render the floating element through `createPortal(..., document.body)`
+ * and spread the returned `style` onto it. The hook:
+ * - flips vertically when there is not enough space on the preferred side
+ * - clamps horizontally to the viewport
+ * - constrains `maxHeight` to the available space (add `overflow-auto`)
+ * - tracks scroll, resize, and anchor/content size changes while open
+ *
+ * @example
+ * ```tsx
+ * const { anchorRef, floatingRef, style } = useAnchoredPosition<
+ *   HTMLButtonElement,
+ *   HTMLDivElement
+ * >({ open, placement: 'bottom-start' });
+ *
+ * <button ref={anchorRef} onClick={() => setOpen(!open)}>Open</button>
+ * {open &&
+ *   createPortal(
+ *     <div ref={floatingRef} style={style} className="overflow-auto …">…</div>,
+ *     document.body
+ *   )}
+ * ```
+ */
+declare function useAnchoredPosition<TAnchor extends HTMLElement = HTMLElement, TFloating extends HTMLElement = HTMLElement>({ open, placement, offset, matchWidth, matchMinWidth, viewportPadding, maxHeight, }: UseAnchoredPositionOptions): UseAnchoredPositionReturn<TAnchor, TFloating>;
+
+export { type AnchoredPlacement as A, type UseAnchoredPositionOptions as U, type UseAnchoredPositionReturn as a, useAnchoredPosition as u };

package/dist/useAnchoredPosition-nXdSFKHf.d.ts

@@ -0,0 +1,65 @@
+import * as React from 'react';
+
+type AnchoredPlacement = 'bottom-start' | 'bottom-end' | 'bottom' | 'top-start' | 'top-end' | 'top';
+interface UseAnchoredPositionOptions {
+    /** Whether the floating element is currently shown */
+    open: boolean;
+    /** Preferred placement relative to the anchor (flips when out of space) */
+    placement?: AnchoredPlacement;
+    /** Gap between the anchor and the floating element, in px */
+    offset?: number;
+    /** Force the floating element to the anchor's width */
+    matchWidth?: boolean;
+    /** Use the anchor's width as the floating element's minimum width */
+    matchMinWidth?: boolean;
+    /** Minimum distance from the viewport edges, in px */
+    viewportPadding?: number;
+    /**
+     * Additional cap on the floating element's height, in px. The height is
+     * always clamped to the available viewport space; this only lowers that
+     * limit further (omitting it does not remove the viewport constraint).
+     */
+    maxHeight?: number;
+}
+interface UseAnchoredPositionReturn<TAnchor extends HTMLElement, TFloating extends HTMLElement> {
+    /** Attach to the element the popup is anchored to (trigger/input) */
+    anchorRef: React.RefObject<TAnchor | null>;
+    /** Attach to the floating element (menu/listbox/panel) */
+    floatingRef: React.RefObject<TFloating | null>;
+    /** Fixed-position style for the floating element — spread onto it */
+    style: React.CSSProperties;
+    /** Vertical side in use after flipping ('top' or 'bottom') */
+    actualSide: 'top' | 'bottom';
+    /** Recompute the position (e.g. after async content loads) */
+    update: () => void;
+}
+/**
+ * Positions a floating element (dropdown menu, autocomplete listbox,
+ * date-picker calendar, …) relative to an anchor using `position: fixed`,
+ * so it is never clipped by `overflow: hidden` ancestors.
+ *
+ * Render the floating element through `createPortal(..., document.body)`
+ * and spread the returned `style` onto it. The hook:
+ * - flips vertically when there is not enough space on the preferred side
+ * - clamps horizontally to the viewport
+ * - constrains `maxHeight` to the available space (add `overflow-auto`)
+ * - tracks scroll, resize, and anchor/content size changes while open
+ *
+ * @example
+ * ```tsx
+ * const { anchorRef, floatingRef, style } = useAnchoredPosition<
+ *   HTMLButtonElement,
+ *   HTMLDivElement
+ * >({ open, placement: 'bottom-start' });
+ *
+ * <button ref={anchorRef} onClick={() => setOpen(!open)}>Open</button>
+ * {open &&
+ *   createPortal(
+ *     <div ref={floatingRef} style={style} className="overflow-auto …">…</div>,
+ *     document.body
+ *   )}
+ * ```
+ */
+declare function useAnchoredPosition<TAnchor extends HTMLElement = HTMLElement, TFloating extends HTMLElement = HTMLElement>({ open, placement, offset, matchWidth, matchMinWidth, viewportPadding, maxHeight, }: UseAnchoredPositionOptions): UseAnchoredPositionReturn<TAnchor, TFloating>;
+
+export { type AnchoredPlacement as A, type UseAnchoredPositionOptions as U, type UseAnchoredPositionReturn as a, useAnchoredPosition as u };