@hypoth-ui/wc 0.1.1

package/dist/overlays.d.ts

@@ -0,0 +1,1291 @@
+import * as lit from 'lit';
+import { nothing } from 'lit';
+import { D as DSElement } from './ds-element-Db0LMfxI.js';
+import { Placement } from '@hypoth-ui/primitives-dom';
+
+type DialogContentSize = "sm" | "md" | "lg" | "xl" | "full";
+type DialogContentState = "open" | "closed";
+/**
+ * Dialog content container component.
+ *
+ * Contains the dialog's content including title, description, and actions.
+ * Receives accessibility attributes from parent ds-dialog.
+ *
+ * @element ds-dialog-content
+ *
+ * @slot - Dialog content (title, description, body, actions)
+ *
+ * @csspart container - The content container element
+ *
+ * @attr {string} data-state - Animation state ("open" or "closed")
+ *
+ * @example
+ * ```html
+ * <ds-dialog-content size="lg">
+ *   <ds-dialog-title>Large Dialog</ds-dialog-title>
+ *   <p>Dialog body content here.</p>
+ *   <div class="ds-dialog__footer">
+ *     <button>Cancel</button>
+ *     <button>Confirm</button>
+ *   </div>
+ * </ds-dialog-content>
+ * ```
+ */
+declare class DsDialogContent extends DSElement {
+    /** Size variant of the dialog */
+    size: DialogContentSize;
+    /** Animation state (open or closed) - set by parent ds-dialog */
+    dataState: DialogContentState;
+    render(): lit.TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        "ds-dialog-content": DsDialogContent;
+    }
+}
+
+/**
+ * Dialog title component.
+ *
+ * Renders the dialog's accessible title. The parent ds-dialog
+ * automatically connects this to the dialog content via aria-labelledby.
+ *
+ * @element ds-dialog-title
+ *
+ * @csspart title - The title element
+ *
+ * @example
+ * ```html
+ * <ds-dialog-title>Confirm Deletion</ds-dialog-title>
+ * ```
+ */
+declare class DsDialogTitle extends DSElement {
+    /** Preserved text content from initial children */
+    private titleText;
+    connectedCallback(): void;
+    render(): typeof nothing | lit.TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        "ds-dialog-title": DsDialogTitle;
+    }
+}
+
+/**
+ * Dialog description component.
+ *
+ * Renders the dialog's accessible description. The parent ds-dialog
+ * automatically connects this to the dialog content via aria-describedby.
+ *
+ * @element ds-dialog-description
+ *
+ * @csspart description - The description element
+ *
+ * @example
+ * ```html
+ * <ds-dialog-description>
+ *   This action cannot be undone.
+ * </ds-dialog-description>
+ * ```
+ */
+declare class DsDialogDescription extends DSElement {
+    /** Preserved text content from initial children */
+    private descriptionText;
+    connectedCallback(): void;
+    render(): typeof nothing | lit.TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        "ds-dialog-description": DsDialogDescription;
+    }
+}
+
+type DialogRole = "dialog" | "alertdialog";
+/**
+ * Modal dialog component with accessibility and focus management.
+ *
+ * Provides a modal overlay with backdrop, focus trap, and dismissal handling.
+ * Follows WAI-ARIA Dialog (Modal) pattern.
+ *
+ * @element ds-dialog
+ *
+ * @slot trigger - Button or element that opens the dialog
+ * @slot - Dialog content (ds-dialog-content)
+ *
+ * @fires ds:open-change - Fired when open state changes (detail: { open, reason })
+ *
+ * @example
+ * ```html
+ * <ds-dialog>
+ *   <button slot="trigger">Open Dialog</button>
+ *   <ds-dialog-content>
+ *     <ds-dialog-title>Confirm Action</ds-dialog-title>
+ *     <ds-dialog-description>Are you sure?</ds-dialog-description>
+ *     <button>Yes</button>
+ *     <button>No</button>
+ *   </ds-dialog-content>
+ * </ds-dialog>
+ * ```
+ */
+declare class DsDialog extends DSElement {
+    /** Whether the dialog is open */
+    open: boolean;
+    /** Whether Escape key closes the dialog */
+    closeOnEscape: boolean;
+    /** Whether clicking the backdrop closes the dialog */
+    closeOnBackdrop: boolean;
+    /** Whether to animate open/close transitions */
+    animated: boolean;
+    /** Dialog role - stored internally, read from attribute */
+    private dialogRole;
+    /** Whether the dialog is closing (for animation) */
+    private isClosing;
+    private dialogBehavior;
+    private presence;
+    private attributeObserver;
+    private backdropElement;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    /**
+     * Initializes the dialog behavior primitive.
+     */
+    private initDialogBehavior;
+    /**
+     * Handles close triggered by the behavior (escape/outside click).
+     */
+    private handleBehaviorClose;
+    /** Tracks the reason for closing (for animation completion) */
+    private _closeReason;
+    /**
+     * Opens the dialog.
+     */
+    show(): void;
+    /**
+     * Closes the dialog.
+     * @param reason - The reason for closing (default: "programmatic")
+     */
+    close(reason?: "escape" | "outside-click" | "trigger" | "programmatic"): void;
+    /**
+     * Completes the close after exit animation.
+     * Note: The open-change event was already emitted before animation started.
+     */
+    private completeClose;
+    private handleTriggerClick;
+    private handleBackdropClick;
+    private cleanup;
+    updated(changedProperties: Map<string, unknown>): Promise<void>;
+    /**
+     * Updates accessibility attributes on dialog content.
+     */
+    private updateContentAccessibility;
+    render(): lit.TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        "ds-dialog": DsDialog;
+    }
+}
+
+type PopoverContentState = "open" | "closed";
+/**
+ * Popover content container.
+ *
+ * @element ds-popover-content
+ *
+ * @slot - Content to display in the popover
+ *
+ * @attr {string} data-state - Animation state ("open" or "closed")
+ *
+ * @example
+ * ```html
+ * <ds-popover>
+ *   <button slot="trigger">Open</button>
+ *   <ds-popover-content>
+ *     <p>Popover content here</p>
+ *     <button>Action</button>
+ *   </ds-popover-content>
+ * </ds-popover>
+ * ```
+ */
+declare class DsPopoverContent extends DSElement {
+    /** Unique ID for ARIA association */
+    id: string;
+    /** Animation state (open or closed) - set by parent ds-popover */
+    dataState: PopoverContentState;
+    connectedCallback(): void;
+    render(): lit.TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        "ds-popover-content": DsPopoverContent;
+    }
+}
+
+/**
+ * Non-modal popover component with anchor positioning.
+ *
+ * Unlike Dialog, Popover does not trap focus and allows Tab to exit.
+ * Positioned relative to its trigger using anchor positioning.
+ *
+ * @element ds-popover
+ *
+ * @slot trigger - Button or element that opens the popover
+ * @slot - Popover content (ds-popover-content)
+ *
+ * @fires ds:open - Fired when popover opens
+ * @fires ds:close - Fired when popover closes
+ *
+ * @example
+ * ```html
+ * <ds-popover>
+ *   <button slot="trigger">Open Menu</button>
+ *   <ds-popover-content>
+ *     <button>Option 1</button>
+ *     <button>Option 2</button>
+ *   </ds-popover-content>
+ * </ds-popover>
+ * ```
+ */
+declare class DsPopover extends DSElement {
+    /** Whether the popover is open */
+    open: boolean;
+    /** Placement relative to trigger */
+    placement: Placement;
+    /** Offset distance from trigger in pixels */
+    offset: number;
+    /** Whether to flip placement when near viewport edge */
+    flip: boolean;
+    /** Whether Escape key closes the popover */
+    closeOnEscape: boolean;
+    /** Whether clicking outside closes the popover */
+    closeOnOutsideClick: boolean;
+    /** Whether to animate open/close transitions */
+    animated: boolean;
+    private anchorPosition;
+    private dismissLayer;
+    private presence;
+    private triggerElement;
+    private resizeObserver;
+    private scrollHandler;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    /**
+     * Opens the popover.
+     */
+    show(): void;
+    /**
+     * Closes the popover.
+     */
+    close(): void;
+    /**
+     * Completes the close after exit animation.
+     */
+    private completeClose;
+    /**
+     * Toggles the popover open/closed state.
+     */
+    toggle(): void;
+    private handleTriggerClick;
+    private handleDismiss;
+    private setupTriggerAccessibility;
+    private updateTriggerAria;
+    private setupPositioning;
+    private setupDismissLayer;
+    private cleanup;
+    updated(changedProperties: Map<string, unknown>): Promise<void>;
+    render(): lit.TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        "ds-popover": DsPopover;
+    }
+}
+
+type TooltipContentState = "open" | "closed";
+/**
+ * Tooltip content container.
+ *
+ * @element ds-tooltip-content
+ *
+ * @slot - Content to display in the tooltip
+ *
+ * @attr {string} data-state - Animation state ("open" or "closed")
+ *
+ * @example
+ * ```html
+ * <ds-tooltip>
+ *   <button slot="trigger">Hover me</button>
+ *   <ds-tooltip-content>Helpful information</ds-tooltip-content>
+ * </ds-tooltip>
+ * ```
+ */
+declare class DsTooltipContent extends DSElement {
+    /** Unique ID for ARIA association */
+    id: string;
+    /** Animation state (open or closed) - set by parent ds-tooltip */
+    dataState: TooltipContentState;
+    connectedCallback(): void;
+    render(): lit.TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        "ds-tooltip-content": DsTooltipContent;
+    }
+}
+
+/**
+ * Tooltip component with hover/focus trigger and configurable delays.
+ *
+ * Shows informational content on hover or focus with positioning
+ * relative to the trigger element.
+ *
+ * @element ds-tooltip
+ *
+ * @slot trigger - Element that triggers the tooltip
+ * @slot - Tooltip content (ds-tooltip-content)
+ *
+ * @example
+ * ```html
+ * <ds-tooltip>
+ *   <button slot="trigger">Hover for info</button>
+ *   <ds-tooltip-content>Additional information here</ds-tooltip-content>
+ * </ds-tooltip>
+ * ```
+ */
+declare class DsTooltip extends DSElement {
+    /** Whether the tooltip is open */
+    open: boolean;
+    /** Placement relative to trigger */
+    placement: Placement;
+    /** Offset distance from trigger in pixels */
+    offset: number;
+    /** Delay before showing tooltip (ms) */
+    showDelay: number;
+    /** Delay before hiding tooltip (ms) */
+    hideDelay: number;
+    /** Whether to animate open/close transitions */
+    animated: boolean;
+    private anchorPosition;
+    private presence;
+    private showTimeout;
+    private hideTimeout;
+    private escapeHandler;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    /**
+     * Shows the tooltip immediately.
+     */
+    show(): void;
+    /**
+     * Hides the tooltip immediately.
+     */
+    hide(): void;
+    private clearTimeouts;
+    private scheduleShow;
+    private scheduleHide;
+    private handleTriggerMouseEnter;
+    private handleTriggerMouseLeave;
+    private handleTriggerFocusIn;
+    private handleTriggerFocusOut;
+    private handleContentMouseEnter;
+    private handleContentMouseLeave;
+    private setupTriggerListeners;
+    private setupContentListeners;
+    private setupTriggerAccessibility;
+    private setupEscapeHandler;
+    private removeEscapeHandler;
+    private setupPositioning;
+    private cleanup;
+    updated(changedProperties: Map<string, unknown>): Promise<void>;
+    render(): lit.TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        "ds-tooltip": DsTooltip;
+    }
+}
+
+type MenuContentState = "open" | "closed";
+/**
+ * Menu content container with role="menu".
+ *
+ * @element ds-menu-content
+ *
+ * @slot - Menu items (ds-menu-item elements)
+ *
+ * @attr {string} data-state - Animation state ("open" or "closed")
+ *
+ * @example
+ * ```html
+ * <ds-menu>
+ *   <button slot="trigger">Actions</button>
+ *   <ds-menu-content>
+ *     <ds-menu-item>Edit</ds-menu-item>
+ *     <ds-menu-item>Delete</ds-menu-item>
+ *   </ds-menu-content>
+ * </ds-menu>
+ * ```
+ */
+declare class DsMenuContent extends DSElement {
+    /** Unique ID for ARIA association */
+    id: string;
+    /** Animation state (open or closed) - set by parent ds-menu */
+    dataState: MenuContentState;
+    connectedCallback(): void;
+    render(): lit.TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        "ds-menu-content": DsMenuContent;
+    }
+}
+
+/**
+ * Menu item with role="menuitem".
+ *
+ * @element ds-menu-item
+ *
+ * @slot - Item content (text, icon, etc.)
+ *
+ * @fires ds:select - Fired when item is selected via click, Enter, or Space
+ *
+ * @example
+ * ```html
+ * <ds-menu-item value="edit">Edit</ds-menu-item>
+ * <ds-menu-item value="delete" disabled>Delete</ds-menu-item>
+ * ```
+ */
+declare class DsMenuItem extends DSElement {
+    /** Whether the item is disabled */
+    disabled: boolean;
+    /** Value associated with this item (used in ds:select event) */
+    value: string;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    private updateAriaDisabled;
+    private handleClick;
+    private handleKeyDown;
+    /**
+     * Triggers selection of this item.
+     * Emits ds:select event and notifies parent menu to close.
+     */
+    select(): void;
+    updated(changedProperties: Map<string, unknown>): void;
+    render(): lit.TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        "ds-menu-item": DsMenuItem;
+    }
+}
+
+/**
+ * Menu component with roving focus and type-ahead.
+ *
+ * Implements WAI-ARIA Menu Button pattern with:
+ * - Arrow key navigation between items
+ * - Type-ahead search to jump to items
+ * - Enter/Space/Click to select items
+ * - Escape to close
+ *
+ * @element ds-menu
+ *
+ * @slot trigger - Button that opens the menu
+ * @slot - Menu content (ds-menu-content with ds-menu-item children)
+ *
+ * @fires ds:open - Fired when menu opens
+ * @fires ds:close - Fired when menu closes
+ * @fires ds:select - Fired when a menu item is selected (bubbles from ds-menu-item)
+ *
+ * @example
+ * ```html
+ * <ds-menu>
+ *   <button slot="trigger">Actions</button>
+ *   <ds-menu-content>
+ *     <ds-menu-item value="edit">Edit</ds-menu-item>
+ *     <ds-menu-item value="delete">Delete</ds-menu-item>
+ *   </ds-menu-content>
+ * </ds-menu>
+ * ```
+ */
+declare class DsMenu extends DSElement {
+    /** Whether the menu is open */
+    open: boolean;
+    /** Placement relative to trigger */
+    placement: Placement;
+    /** Offset distance from trigger in pixels */
+    offset: number;
+    /** Whether to flip placement when near viewport edge */
+    flip: boolean;
+    /** Whether to animate open/close transitions */
+    animated: boolean;
+    private anchorPosition;
+    private dismissLayer;
+    private presence;
+    private rovingFocus;
+    private typeAhead;
+    private triggerElement;
+    private resizeObserver;
+    private scrollHandler;
+    private focusFirstOnOpen;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    /**
+     * Opens the menu.
+     */
+    show(): void;
+    /**
+     * Closes the menu.
+     */
+    close(): void;
+    /**
+     * Completes the close after exit animation.
+     */
+    private completeClose;
+    /**
+     * Toggles the menu open/closed state.
+     */
+    toggle(): void;
+    private handleTriggerClick;
+    private handleTriggerKeyDown;
+    private handleItemSelect;
+    private handleDismiss;
+    private setupTriggerAccessibility;
+    private updateTriggerAria;
+    private setupPositioning;
+    private setupDismissLayer;
+    private setupRovingFocus;
+    private setupTypeAhead;
+    private handleTypeAheadKeyDown;
+    private focusInitialItem;
+    private cleanup;
+    updated(changedProperties: Map<string, unknown>): Promise<void>;
+    render(): lit.TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        "ds-menu": DsMenu;
+    }
+}
+
+type AlertDialogContentSize = "sm" | "md" | "lg" | "xl" | "full";
+declare class DsAlertDialogContent extends DSElement {
+    /** Size of the alert dialog content */
+    size: AlertDialogContentSize;
+    /** Data state for animations */
+    dataState: "open" | "closed";
+    connectedCallback(): void;
+    render(): lit.TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        "ds-alert-dialog-content": DsAlertDialogContent;
+    }
+}
+
+declare class DsAlertDialogHeader extends DSElement {
+    render(): lit.TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        "ds-alert-dialog-header": DsAlertDialogHeader;
+    }
+}
+
+declare class DsAlertDialogFooter extends DSElement {
+    render(): lit.TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        "ds-alert-dialog-footer": DsAlertDialogFooter;
+    }
+}
+
+declare class DsAlertDialogTitle extends DSElement {
+    connectedCallback(): void;
+    render(): lit.TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        "ds-alert-dialog-title": DsAlertDialogTitle;
+    }
+}
+
+declare class DsAlertDialogDescription extends DSElement {
+    connectedCallback(): void;
+    render(): lit.TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        "ds-alert-dialog-description": DsAlertDialogDescription;
+    }
+}
+
+declare class DsAlertDialogAction extends DSElement {
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    private handleClick;
+    render(): lit.TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        "ds-alert-dialog-action": DsAlertDialogAction;
+    }
+}
+
+declare class DsAlertDialogCancel extends DSElement {
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    private handleClick;
+    render(): lit.TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        "ds-alert-dialog-cancel": DsAlertDialogCancel;
+    }
+}
+
+declare class DsAlertDialog extends DSElement {
+    /** Whether the alert dialog is open */
+    open: boolean;
+    /** Whether to animate open/close transitions */
+    animated: boolean;
+    /** Whether the alert dialog is closing (for animation) */
+    private isClosing;
+    private dialogBehavior;
+    private presence;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    /**
+     * Initializes the dialog behavior primitive.
+     * AlertDialog uses role="alertdialog" and disables dismiss on escape/outside click.
+     */
+    private initDialogBehavior;
+    /**
+     * Opens the alert dialog.
+     */
+    show(): void;
+    /**
+     * Closes the alert dialog.
+     */
+    close(): void;
+    /**
+     * Completes the close after exit animation.
+     */
+    private completeClose;
+    private handleTriggerClick;
+    private handleAction;
+    private handleCancel;
+    private cleanup;
+    updated(changedProperties: Map<string, unknown>): Promise<void>;
+    /**
+     * Updates accessibility attributes on alert dialog content.
+     */
+    private updateContentAccessibility;
+    render(): lit.TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        "ds-alert-dialog": DsAlertDialog;
+    }
+}
+
+declare class DsAlertDialogTrigger extends DSElement {
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    private handleClick;
+    render(): lit.TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        "ds-alert-dialog-trigger": DsAlertDialogTrigger;
+    }
+}
+
+type SheetSide = "top" | "right" | "bottom" | "left";
+type SheetContentSize = "sm" | "md" | "lg" | "xl" | "full";
+declare class DsSheetContent extends DSElement {
+    /** Side of the screen the sheet appears from */
+    side: SheetSide;
+    /** Size of the sheet content */
+    size: SheetContentSize;
+    /** Data state for animations */
+    dataState: "open" | "closed";
+    connectedCallback(): void;
+    render(): lit.TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        "ds-sheet-content": DsSheetContent;
+    }
+}
+
+declare class DsSheetOverlay extends DSElement {
+    render(): lit.TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        "ds-sheet-overlay": DsSheetOverlay;
+    }
+}
+
+declare class DsSheetHeader extends DSElement {
+    render(): lit.TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        "ds-sheet-header": DsSheetHeader;
+    }
+}
+
+declare class DsSheetFooter extends DSElement {
+    render(): lit.TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        "ds-sheet-footer": DsSheetFooter;
+    }
+}
+
+declare class DsSheetTitle extends DSElement {
+    connectedCallback(): void;
+    render(): lit.TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        "ds-sheet-title": DsSheetTitle;
+    }
+}
+
+declare class DsSheetDescription extends DSElement {
+    connectedCallback(): void;
+    render(): lit.TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        "ds-sheet-description": DsSheetDescription;
+    }
+}
+
+declare class DsSheetClose extends DSElement {
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    private handleClick;
+    render(): lit.TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        "ds-sheet-close": DsSheetClose;
+    }
+}
+
+declare class DsSheet extends DSElement {
+    /** Whether the sheet is open */
+    open: boolean;
+    /** Whether Escape key closes the sheet */
+    closeOnEscape: boolean;
+    /** Whether clicking the overlay closes the sheet */
+    closeOnOverlay: boolean;
+    /** Whether to animate open/close transitions */
+    animated: boolean;
+    /** Whether the sheet is closing (for animation) */
+    private isClosing;
+    private dialogBehavior;
+    private presence;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    /**
+     * Initializes the dialog behavior primitive.
+     */
+    private initDialogBehavior;
+    /**
+     * Handles close triggered by the behavior (escape/outside click).
+     */
+    private handleBehaviorClose;
+    /**
+     * Opens the sheet.
+     */
+    show(): void;
+    /**
+     * Closes the sheet.
+     */
+    close(): void;
+    /**
+     * Completes the close after exit animation.
+     */
+    private completeClose;
+    private handleTriggerClick;
+    private handleCloseRequest;
+    private cleanup;
+    updated(changedProperties: Map<string, unknown>): Promise<void>;
+    /**
+     * Updates accessibility attributes on sheet content.
+     */
+    private updateContentAccessibility;
+    render(): lit.TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        "ds-sheet": DsSheet;
+    }
+}
+
+declare class DsDrawerContent extends DSElement {
+    /** Side of the screen the drawer appears from (set by parent) */
+    side: DrawerSide;
+    /** Data state for animations */
+    dataState: "open" | "closed";
+    /** Whether swipe-to-dismiss is enabled (set by parent) */
+    swipeDismiss: boolean;
+    /** Current swipe offset during drag */
+    private swipeOffset;
+    /** Whether currently dragging */
+    private isDragging;
+    private startY;
+    private startX;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    private handleTouchStart;
+    private handleTouchMove;
+    private handleTouchEnd;
+    private updateSwipeTransform;
+    render(): lit.TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        "ds-drawer-content": DsDrawerContent;
+    }
+}
+
+declare class DsDrawerHeader extends DSElement {
+    render(): lit.TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        "ds-drawer-header": DsDrawerHeader;
+    }
+}
+
+declare class DsDrawerFooter extends DSElement {
+    render(): lit.TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        "ds-drawer-footer": DsDrawerFooter;
+    }
+}
+
+declare class DsDrawerTitle extends DSElement {
+    connectedCallback(): void;
+    render(): lit.TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        "ds-drawer-title": DsDrawerTitle;
+    }
+}
+
+declare class DsDrawerDescription extends DSElement {
+    connectedCallback(): void;
+    render(): lit.TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        "ds-drawer-description": DsDrawerDescription;
+    }
+}
+
+type DrawerSide = "top" | "right" | "bottom" | "left";
+declare class DsDrawer extends DSElement {
+    /** Whether the drawer is open */
+    open: boolean;
+    /** Side of the screen the drawer appears from */
+    side: DrawerSide;
+    /** Whether swipe-to-dismiss is enabled */
+    swipeDismiss: boolean;
+    /** Whether Escape key closes the drawer */
+    closeOnEscape: boolean;
+    /** Whether clicking the overlay closes the drawer */
+    closeOnOverlay: boolean;
+    /** Whether to animate open/close transitions */
+    animated: boolean;
+    /** Whether the drawer is closing (for animation) */
+    private isClosing;
+    private dialogBehavior;
+    private presence;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    /**
+     * Initializes the dialog behavior primitive.
+     */
+    private initDialogBehavior;
+    /**
+     * Handles close triggered by the behavior (escape/outside click).
+     */
+    private handleBehaviorClose;
+    /**
+     * Opens the drawer.
+     */
+    show(): void;
+    /**
+     * Closes the drawer.
+     */
+    close(): void;
+    /**
+     * Completes the close after exit animation.
+     */
+    private completeClose;
+    private handleTriggerClick;
+    private handleCloseRequest;
+    private handleOverlayClick;
+    private cleanup;
+    updated(changedProperties: Map<string, unknown>): Promise<void>;
+    /**
+     * Updates accessibility attributes on drawer content.
+     */
+    private updateContentAccessibility;
+    render(): lit.TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        "ds-drawer": DsDrawer;
+    }
+}
+
+declare class DsDropdownMenuContent extends DSElement {
+    /** Data state for animations */
+    dataState: "open" | "closed";
+    connectedCallback(): void;
+    render(): lit.TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        "ds-dropdown-menu-content": DsDropdownMenuContent;
+    }
+}
+
+type DropdownMenuItemVariant = "default" | "destructive";
+declare class DsDropdownMenuItem extends DSElement {
+    /** Value for selection events */
+    value: string;
+    /** Visual variant */
+    variant: DropdownMenuItemVariant;
+    /** Disabled state */
+    disabled: boolean;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    private handleSelect;
+    private handleKeyDown;
+    updated(changedProperties: Map<string, unknown>): void;
+    render(): lit.TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        "ds-dropdown-menu-item": DsDropdownMenuItem;
+    }
+}
+
+declare class DsDropdownMenuSeparator extends DSElement {
+    connectedCallback(): void;
+    render(): lit.TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        "ds-dropdown-menu-separator": DsDropdownMenuSeparator;
+    }
+}
+
+declare class DsDropdownMenuLabel extends DSElement {
+    connectedCallback(): void;
+    render(): lit.TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        "ds-dropdown-menu-label": DsDropdownMenuLabel;
+    }
+}
+
+declare class DsDropdownMenuCheckboxItem extends DSElement {
+    /** Whether the checkbox is checked */
+    checked: boolean;
+    /** Disabled state */
+    disabled: boolean;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    private handleToggle;
+    private handleKeyDown;
+    private updateAriaChecked;
+    updated(changedProperties: Map<string, unknown>): void;
+    render(): lit.TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        "ds-dropdown-menu-checkbox-item": DsDropdownMenuCheckboxItem;
+    }
+}
+
+declare class DsDropdownMenuRadioGroup extends DSElement {
+    /** Currently selected value */
+    value: string;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    private handleRadioSelect;
+    private updateRadioItems;
+    updated(changedProperties: Map<string, unknown>): void;
+    render(): lit.TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        "ds-dropdown-menu-radio-group": DsDropdownMenuRadioGroup;
+    }
+}
+
+declare class DsDropdownMenuRadioItem extends DSElement {
+    /** Value for selection */
+    value: string;
+    /** Whether the radio is selected */
+    checked: boolean;
+    /** Disabled state */
+    disabled: boolean;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    private handleSelect;
+    private handleKeyDown;
+    private updateAriaChecked;
+    updated(changedProperties: Map<string, unknown>): void;
+    render(): lit.TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        "ds-dropdown-menu-radio-item": DsDropdownMenuRadioItem;
+    }
+}
+
+declare class DsDropdownMenu extends DSElement {
+    /** Whether the menu is open */
+    open: boolean;
+    /** Placement relative to trigger */
+    placement: Placement;
+    /** Offset distance from trigger in pixels */
+    offset: number;
+    /** Whether to flip placement when near viewport edge */
+    flip: boolean;
+    /** Whether to animate open/close transitions */
+    animated: boolean;
+    /** Modal behavior - blocks interaction outside menu */
+    modal: boolean;
+    private menuBehavior;
+    private presence;
+    private focusFirstOnOpen;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    /**
+     * Initializes the menu behavior primitive.
+     */
+    private initMenuBehavior;
+    /**
+     * Handles close triggered by the behavior (escape/outside click).
+     */
+    private handleBehaviorClose;
+    /**
+     * Opens the menu.
+     */
+    show(): void;
+    /**
+     * Closes the menu.
+     */
+    close(): void;
+    private completeClose;
+    toggle(): void;
+    private handleTriggerClick;
+    private handleTriggerKeyDown;
+    private handleItemSelect;
+    private setupTriggerAccessibility;
+    private updateTriggerAria;
+    private registerMenuItems;
+    private cleanup;
+    updated(changedProperties: Map<string, unknown>): Promise<void>;
+    render(): lit.TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        "ds-dropdown-menu": DsDropdownMenu;
+    }
+}
+
+declare class DsContextMenuContent extends DSElement {
+    /** Data state for animations */
+    dataState: "open" | "closed";
+    connectedCallback(): void;
+    render(): lit.TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        "ds-context-menu-content": DsContextMenuContent;
+    }
+}
+
+type ContextMenuItemVariant = "default" | "destructive";
+declare class DsContextMenuItem extends DSElement {
+    /** Value for selection events */
+    value: string;
+    /** Visual variant */
+    variant: ContextMenuItemVariant;
+    /** Disabled state */
+    disabled: boolean;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    private handleSelect;
+    private handleKeyDown;
+    updated(changedProperties: Map<string, unknown>): void;
+    render(): lit.TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        "ds-context-menu-item": DsContextMenuItem;
+    }
+}
+
+declare class DsContextMenuSeparator extends DSElement {
+    connectedCallback(): void;
+    render(): lit.TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        "ds-context-menu-separator": DsContextMenuSeparator;
+    }
+}
+
+declare class DsContextMenuLabel extends DSElement {
+    connectedCallback(): void;
+    render(): lit.TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        "ds-context-menu-label": DsContextMenuLabel;
+    }
+}
+
+declare class DsContextMenu extends DSElement {
+    /** Whether the menu is open */
+    open: boolean;
+    /** Whether to animate open/close transitions */
+    animated: boolean;
+    /** Position X for menu */
+    private pointerX;
+    /** Position Y for menu */
+    private pointerY;
+    private menuBehavior;
+    private presence;
+    private longPressTimer;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    /**
+     * Initializes the menu behavior primitive.
+     */
+    private initMenuBehavior;
+    /**
+     * Handles close triggered by the behavior (escape/outside click).
+     */
+    private handleBehaviorClose;
+    /**
+     * Opens the menu at the specified position.
+     */
+    show(x: number, y: number): void;
+    /**
+     * Closes the menu.
+     */
+    close(): void;
+    private completeClose;
+    private handleContextMenu;
+    private handleTouchStart;
+    private handleTouchEnd;
+    private handleTouchMove;
+    private handleItemSelect;
+    private positionContent;
+    private registerMenuItems;
+    private cleanup;
+    updated(changedProperties: Map<string, unknown>): Promise<void>;
+    render(): lit.TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        "ds-context-menu": DsContextMenu;
+    }
+}
+
+type HoverCardContentState = "open" | "closed";
+declare class DsHoverCardContent extends DSElement {
+    /** Unique ID for ARIA association */
+    id: string;
+    /** Animation state (open or closed) - set by parent */
+    dataState: HoverCardContentState;
+    connectedCallback(): void;
+    render(): lit.TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        "ds-hover-card-content": DsHoverCardContent;
+    }
+}
+
+declare class DsHoverCard extends DSElement {
+    /** Whether the hover card is open */
+    open: boolean;
+    /** Placement relative to trigger */
+    placement: Placement;
+    /** Offset distance from trigger in pixels */
+    offset: number;
+    /** Whether to flip placement when near viewport edge */
+    flip: boolean;
+    /** Delay in ms before showing on hover */
+    openDelay: number;
+    /** Delay in ms before hiding after hover leaves */
+    closeDelay: number;
+    /** Whether to animate open/close transitions */
+    animated: boolean;
+    private anchorPosition;
+    private dismissLayer;
+    private presence;
+    private resizeObserver;
+    private scrollHandler;
+    private openTimer;
+    private closeTimer;
+    private isHoveringTrigger;
+    private isHoveringContent;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    /**
+     * Opens the hover card.
+     */
+    show(): void;
+    /**
+     * Closes the hover card.
+     */
+    close(): void;
+    private completeClose;
+    private clearTimers;
+    private handleTriggerMouseEnter;
+    private handleTriggerMouseLeave;
+    private handleFocusIn;
+    private handleFocusOut;
+    private scheduleOpen;
+    private scheduleClose;
+    private cancelOpen;
+    private cancelClose;
+    private handleDismiss;
+    private setupTriggerAccessibility;
+    private updateTriggerAria;
+    private setupPositioning;
+    private setupDismissLayer;
+    private cleanup;
+    updated(changedProperties: Map<string, unknown>): Promise<void>;
+    render(): lit.TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        "ds-hover-card": DsHoverCard;
+    }
+}
+
+export { type AlertDialogContentSize, type ContextMenuItemVariant, type DialogContentSize, type DialogRole, type DrawerSide, type DropdownMenuItemVariant, DsAlertDialog, DsAlertDialogAction, DsAlertDialogCancel, DsAlertDialogContent, DsAlertDialogDescription, DsAlertDialogFooter, DsAlertDialogHeader, DsAlertDialogTitle, DsAlertDialogTrigger, DsContextMenu, DsContextMenuContent, DsContextMenuItem, DsContextMenuLabel, DsContextMenuSeparator, DsDialog, DsDialogContent, DsDialogDescription, DsDialogTitle, DsDrawer, DsDrawerContent, DsDrawerDescription, DsDrawerFooter, DsDrawerHeader, DsDrawerTitle, DsDropdownMenu, DsDropdownMenuCheckboxItem, DsDropdownMenuContent, DsDropdownMenuItem, DsDropdownMenuLabel, DsDropdownMenuRadioGroup, DsDropdownMenuRadioItem, DsDropdownMenuSeparator, DsHoverCard, DsHoverCardContent, DsMenu, DsMenuContent, DsMenuItem, DsPopover, DsPopoverContent, DsSheet, DsSheetClose, DsSheetContent, DsSheetDescription, DsSheetFooter, DsSheetHeader, DsSheetOverlay, DsSheetTitle, DsTooltip, DsTooltipContent, type HoverCardContentState, type SheetContentSize, type SheetSide };