@yewdiel21/motion-kit 0.16.0 → 0.18.0

package/dist/{reveal-DRpNO4KP.d.ts → engine-t8d7brjn.d.ts}

@@ -57,6 +57,346 @@ interface MenuInstance extends DialogInstance {
 }
 declare function createMenu(dialog: HTMLElement | null, options?: MenuOptions): MenuInstance;
 
+interface NotFoundOptions {
+    brand?: string;
+    title?: string;
+    description?: string;
+    homeHref?: string;
+    homeLabel?: string;
+    backLabel?: string;
+    showBack?: boolean;
+    /** A router may own Back. Without this callback it calls history.back(). */
+    onBack?: () => void;
+}
+interface NotFoundInstance extends Instance {
+    replay(): void;
+}
+declare function createNotFound(root: HTMLElement | null, options?: NotFoundOptions): NotFoundInstance;
+
+interface MorphingPageDotsOptions {
+    count?: number;
+    value?: number;
+    label?: string;
+    /** Accessible page names; by default "Página 1 de 5". */
+    labels?: string[];
+    /** Optional ids of the real carousel slides controlled by each dot. */
+    pageIds?: string[];
+    disabled?: boolean;
+    onChange?: (index: number) => void;
+}
+interface MorphingPageDotsInstance extends Instance {
+    setValue(index: number, notify?: boolean): void;
+    readonly value: number;
+}
+declare function createMorphingPageDots(root: HTMLElement | null, options?: MorphingPageDotsOptions): MorphingPageDotsInstance;
+
+interface BadgeButtonOptions {
+    label?: string;
+    count?: number;
+    /** Increment requested by an activation; use 0 for a host-owned count. Default 1. */
+    step?: number;
+    /** Hide the badge when its count is zero (default true). */
+    hideZero?: boolean;
+    max?: number;
+    onChange?: (count: number) => void;
+}
+interface BadgeButtonInstance extends Instance {
+    setCount(count: number, notify?: boolean): void;
+    readonly count: number;
+}
+declare function createBadgeButton(root: HTMLElement | null, options?: BadgeButtonOptions): BadgeButtonInstance;
+
+interface MagnetizeButtonOptions {
+    label?: string;
+    /** Discrete particles, clamped to 4–24. No idle ticker. */
+    count?: number;
+    /** Distance outside the button where the particles rest, default 42px. */
+    reach?: number;
+    onAction?: () => void;
+}
+interface MagnetizeButtonInstance extends Instance {
+    attract(): void;
+    release(): void;
+    readonly attracted: boolean;
+}
+declare function createMagnetizeButton(root: HTMLElement | null, options?: MagnetizeButtonOptions): MagnetizeButtonInstance;
+
+interface ParticleButtonOptions {
+    /** Used only when the control has no authored content. */
+    label?: string;
+    /** Number of particle pairs, clamped to 3–16. */
+    count?: number;
+    distance?: number;
+    onAction?: () => void;
+}
+interface ParticleButtonInstance extends Instance {
+    burst(): void;
+}
+declare function createParticleButton(root: HTMLElement | null, options?: ParticleButtonOptions): ParticleButtonInstance;
+
+interface HandwritingTextOptions {
+    text?: string;
+    /** Duration of the complete pen drawing in seconds, default 2.4. */
+    duration?: number;
+    autoplay?: boolean;
+    onComplete?: () => void;
+}
+interface HandwritingTextInstance extends Instance {
+    setText(text: string, animate?: boolean): void;
+    replay(): void;
+    readonly text: string;
+}
+declare function createHandwritingText(root: HTMLElement | null, options?: HandwritingTextOptions): HandwritingTextInstance;
+
+interface StickyHeaderOptions {
+    /** Own scrolling container; window by default. */
+    scroller?: HTMLElement | string | null;
+    expandedHeight?: number;
+    compactHeight?: number;
+    /** Start compacting after this scroll position, in pixels. */
+    threshold?: number;
+    /** Pixels of scroll over which geometry changes. */
+    range?: number;
+    top?: number;
+    disabled?: boolean;
+    onChange?: (compact: boolean) => void;
+}
+interface StickyHeaderInstance extends Instance {
+    update(): void;
+    setOptions(options: Partial<StickyHeaderOptions>): void;
+    readonly compact: boolean;
+    readonly progress: number;
+}
+/** The authored surface changes geometry inside a stable, expanded-height sticky slot. */
+declare function createStickyHeader(root: HTMLElement | null, options?: StickyHeaderOptions): StickyHeaderInstance;
+
+interface ScrollPreviewDockItem {
+    id: string;
+    label: string;
+    description?: string;
+    thumbnail?: string;
+    /** A section element or selector. Defaults to the element with this item's id. */
+    section?: HTMLElement | string;
+    disabled?: boolean;
+}
+interface ScrollPreviewDockOptions {
+    items?: ScrollPreviewDockItem[];
+    scroller?: HTMLElement | string | null;
+    offset?: number;
+    label?: string;
+    disabled?: boolean;
+    onChange?: (id: string) => void;
+}
+interface ScrollPreviewDockInstance extends Instance {
+    select(id: string): void;
+    update(): void;
+    setOptions(options: Partial<ScrollPreviewDockOptions>): void;
+    readonly value: string;
+}
+/** Native section links, a travelling selection pill, and a focus/hover preview. */
+declare function createScrollPreviewDock(root: HTMLElement | null, options?: ScrollPreviewDockOptions): ScrollPreviewDockInstance;
+
+interface BentoGridOptions {
+    columns?: number;
+    gap?: number;
+    /** Matches a whitespace-separated data-mk-category. Null shows every item. */
+    filter?: string | null;
+    duration?: number;
+    onChange?: (keys: string[]) => void;
+}
+interface BentoGridInstance extends Instance {
+    refresh(): void;
+    setFilter(filter: string | null): void;
+    reorder(keys: string[]): void;
+    /** Capture before an authored DOM mutation (add/remove/replace), then animate to its layout. */
+    mutate(change: () => void): void;
+    setOptions(options: Partial<BentoGridOptions>): void;
+    readonly filter: string | null;
+    readonly keys: string[];
+}
+/** Authored direct children are the grid items. Spans live in data-mk-col-span / data-mk-row-span. */
+declare function createBentoGrid(root: HTMLElement | null, options?: BentoGridOptions): BentoGridInstance;
+
+interface NotificationStackItem {
+    id: string;
+    title: string;
+    description?: string;
+    tone?: 'neutral' | 'success' | 'error' | 'info';
+    /** Milliseconds; zero keeps the notification until dismissed. */
+    duration?: number;
+    dismissible?: boolean;
+    action?: {
+        label: string;
+        onClick?: () => void;
+    };
+}
+type NotificationStackDirection = 'down' | 'up' | 'side';
+interface NotificationStackOptions {
+    items?: NotificationStackItem[];
+    expanded?: boolean;
+    /** Where the deck opens: below its front card (default), above it, or into a sideways strip. */
+    direction?: NotificationStackDirection;
+    duration?: number;
+    disabled?: boolean;
+    label?: string;
+    labels?: {
+        expand?: string;
+        collapse?: string;
+        dismiss?: string;
+        empty?: string;
+    };
+    onDismiss?: (id: string) => void;
+    onAction?: (id: string) => void;
+    onExpandedChange?: (expanded: boolean) => void;
+}
+interface NotificationStackInstance extends Instance {
+    push(item: NotificationStackItem): void;
+    dismiss(id: string): void;
+    clear(): void;
+    expand(): void;
+    collapse(): void;
+    toggle(): void;
+    setOptions(options: Partial<NotificationStackOptions>): void;
+    readonly items: readonly NotificationStackItem[];
+    readonly expanded: boolean;
+}
+/** An isolated notification deck. It deliberately does not subscribe to the global toast store. */
+declare function createNotificationStack(root: HTMLElement | null, options?: NotificationStackOptions): NotificationStackInstance;
+
+interface RatingScaleOptions {
+    /** Inclusive numeric scale; defaults to 0…10, or 1…5 for sentiment. */
+    min?: number;
+    max?: number;
+    value?: number | null;
+    defaultValue?: number | null;
+    variant?: 'numbered' | 'sentiment';
+    labels?: string[];
+    label?: string;
+    name?: string;
+    disabled?: boolean;
+    required?: boolean;
+    error?: string;
+    onChange?: (value: number | null) => void;
+}
+interface RatingScaleInstance extends Instance {
+    readonly value: number | null;
+    setValue(value: number | null, notify?: boolean): void;
+    reset(notify?: boolean): void;
+}
+declare function createRatingScale(root: HTMLElement | null, options?: RatingScaleOptions): RatingScaleInstance;
+
+interface NumericOptions {
+    min?: number;
+    max?: number;
+    step?: number;
+    value?: number;
+    defaultValue?: number;
+    label?: string;
+    name?: string;
+    disabled?: boolean;
+    error?: string;
+    formatValue?: (value: number) => string;
+    onInput?: (value: number) => void;
+    onChange?: (value: number) => void;
+}
+interface NumericInstance extends Instance {
+    readonly value: number;
+    setValue(value: number, notify?: boolean): void;
+    reset(notify?: boolean): void;
+}
+
+type TemperatureUnit = 'C' | 'F';
+interface TemperatureSliderOptions extends NumericOptions {
+    unit?: TemperatureUnit;
+}
+interface TemperatureSliderInstance extends NumericInstance {
+    readonly unit: TemperatureUnit;
+    /** Converts the value into `unit` and glides to it. `min`/`max` default to the unit's comfort range. */
+    setUnit(unit: TemperatureUnit, range?: {
+        min?: number;
+        max?: number;
+        step?: number;
+    }, notify?: boolean): void;
+}
+declare function createTemperatureSlider(root: HTMLElement | null, options?: TemperatureSliderOptions): TemperatureSliderInstance;
+
+interface EqualizerSliderOptions extends NumericOptions {
+    /** Static waveform heights 0…1. This control does not analyze or play audio. */
+    waveform?: number[];
+    /** Number of decorative bars, 12…72; default 40. */
+    bars?: number;
+}
+interface EqualizerSliderInstance extends NumericInstance {
+}
+declare function createEqualizerSlider(root: HTMLElement | null, options?: EqualizerSliderOptions): EqualizerSliderInstance;
+
+interface ChoiceItem {
+    value: string;
+    label: string;
+    description?: string;
+    disabled?: boolean;
+    symbol?: string;
+}
+interface ChoiceOptions {
+    items?: ChoiceItem[];
+    value?: string | null;
+    defaultValue?: string | null;
+    name?: string;
+    label?: string;
+    disabled?: boolean;
+    required?: boolean;
+    error?: string;
+    variant?: string;
+    caption?: (value: string | null) => string;
+    eventValue?: (value: string | null) => unknown;
+    onChange?: (value: string | null) => void;
+    /** Private: decorates the options after each paint; `animate` is true only for live changes. */
+    decorate?: (labels: HTMLLabelElement[], index: number, previous: number, animate: boolean, keep: (effect: gsap.core.Animation | null) => void) => void;
+}
+interface ChoiceInstance extends Instance {
+    readonly value: string | null;
+    setValue(value: string | null, notify?: boolean): void;
+    reset(notify?: boolean): void;
+}
+
+interface RadioGroupItem extends ChoiceItem {
+}
+interface RadioGroupOptions extends Omit<ChoiceOptions, 'variant' | 'caption' | 'eventValue'> {
+    /** Pill selectors, descriptive cards, or compact settings rows. */
+    variant?: 'pill' | 'card' | 'list';
+}
+interface RadioGroupInstance extends ChoiceInstance {
+}
+declare function createRadioGroup(root: HTMLElement | null, options?: RadioGroupOptions): RadioGroupInstance;
+
+interface StepperItem {
+    label: string;
+    description?: string;
+    disabled?: boolean;
+    completed?: boolean;
+    error?: boolean;
+}
+interface StepperOptions {
+    items?: StepperItem[];
+    value?: number;
+    defaultValue?: number;
+    label?: string;
+    name?: string;
+    variant?: 'horizontal' | 'vertical' | 'compact' | 'dots';
+    /** Only the next unfinished step can be entered with the navigation buttons. */
+    linear?: boolean;
+    disabled?: boolean;
+    onChange?: (value: number) => void;
+}
+interface StepperInstance extends Instance {
+    readonly value: number;
+    setValue(value: number, notify?: boolean): void;
+    next(notify?: boolean): void;
+    previous(notify?: boolean): void;
+    reset(notify?: boolean): void;
+}
+declare function createStepper(root: HTMLElement | null, options?: StepperOptions): StepperInstance;
+
 interface QuantityOptions {
     min?: number;
     max?: number;
@@ -2483,4 +2823,197 @@ interface RevealHandle {
 }
 declare function revealFrom(target: HTMLElement, options?: RevealOptions): RevealHandle | null;
 
-export { createRichTextEditor as $, createColorArea as A, createColorField as B, createColorPicker as C, createTimeField as D, createRangeCalendar as E, createDateRangePicker as F, createTooltip as G, createPopover as H, createLoadingButton as I, createBreadcrumb as J, createEmptyState as K, createStatCard as L, createChartTooltip as M, createMultiSelect as N, createTagInput as O, createDateTimePicker as P, createFilterBuilder as Q, createTimeline as R, createActivityFeed as S, createTreeView as T, createFileExplorer as U, createJsonViewer as V, createVirtualList as W, createResizablePanel as X, createSplitView as Y, createDataTable as Z, createEditableTable as _, createTrailer as a, type DataAction as a$, createSelect as a0, createAddToCart as a1, createScrollIsland as a2, type RevealHandle as a3, type DateInput as a4, type ActivityActor as a5, type ActivityFeedInstance as a6, type ActivityFeedOptions as a7, type ActivityItem as a8, type ActivityKind as a9, type ChartTooltipInstance as aA, type ChartTooltipOptions as aB, type ChartTooltipSeries as aC, type ChartType as aD, type CheckState as aE, type CodeBlockInstance as aF, type CodeBlockOptions as aG, type ColorAreaInstance as aH, type ColorAreaOptions as aI, type ColorChannel as aJ, type ColorFieldInstance as aK, type ColorFieldOptions as aL, type ColorFormat as aM, type ColorPickerInstance as aN, type ColorPickerOptions as aO, type ColorSliderInstance as aP, type ColorSliderOptions as aQ, type CommandItem as aR, type CommandSearchInstance as aS, type CommandSearchOptions as aT, type ContextMenuInstance as aU, type ContextMenuOptions as aV, type CreditCardField as aW, type CreditCardInstance as aX, type CreditCardLabels as aY, type CreditCardOptions as aZ, type CreditCardValues as a_, type AddToCartInstance as aa, type AddToCartOptions as ab, type AttachmentFile as ac, type AttachmentInstance as ad, type AttachmentLabels as ae, type AttachmentOptions as af, type AttachmentRejectCode as ag, type AttachmentRejection as ah, type AttachmentStatus as ai, BRAND_LABELS as aj, type BreadcrumbInstance as ak, type BreadcrumbItem as al, type BreadcrumbOptions as am, CHANNEL_LABELS as an, type CalendarEvent as ao, type CalendarEventStatus as ap, type CalendarInstance as aq, type CalendarLabels as ar, type CalendarOptions as as, type CalendarRange as at, type CalendarView as au, type CardBrand as av, type ChartInstance as aw, type ChartOptions as ax, type ChartPoint as ay, type ChartSeries as az, createQuantity as b, type MultiSelectOptions as b$, type DataColumn as b0, type DataColumnType as b1, type DataRow as b2, type DataSort as b3, type DataTableInstance as b4, type DataTableOptions as b5, type DateRange as b6, type DateRangePickerInstance as b7, type DateRangePickerOptions as b8, type DateTimePickerInstance as b9, type FilterGroup as bA, type FilterNode as bB, type FilterRule as bC, type FilterValue as bD, type HoldConfirmInstance as bE, type HoldConfirmOptions as bF, type HoverCardInstance as bG, type HoverCardOptions as bH, type Hsla as bI, type Hsva as bJ, type ImagePreviewInstance as bK, type ImagePreviewOptions as bL, type InputOtpInstance as bM, type InputOtpOptions as bN, type JsonType as bO, type JsonViewerInstance as bP, type JsonViewerOptions as bQ, type LinkPreviewInstance as bR, type LinkPreviewOptions as bS, type LinkPreviewVariant as bT, type LoadingButtonInstance as bU, type LoadingButtonOptions as bV, type LoadingState as bW, type MenuInstance as bX, type MenuOptions as bY, type MultiSelectInstance as bZ, type MultiSelectOption as b_, type DateTimePickerOptions as ba, type DialogInstance as bb, type DialogLabels as bc, type DialogOptions as bd, type DialogPlacement as be, type DialogVariant as bf, type EditableColumn as bg, type EditableTableInstance as bh, type EditableTableOptions as bi, type EditorKind as bj, type EmptyAction as bk, type EmptyIllustration as bl, type EmptyStateInstance as bm, type EmptyStateOptions as bn, type Expiry as bo, type FileChange as bp, type FileEntry as bq, type FileExplorerInstance as br, type FileExplorerOptions as bs, type FileFamily as bt, type FileSort as bu, type FileView as bv, type FilterBuilderInstance as bw, type FilterBuilderOptions as bx, type FilterField as by, type FilterFieldType as bz, createStudioDock as c, type StatCardOptions as c$, type NotificationBellInstance as c0, type NotificationBellOptions as c1, OPERATORS as c2, type PaginationInstance as c3, type PaginationOptions as c4, type PanelOrientation as c5, type PasswordChecks as c6, type PasswordScore as c7, type PasswordStrengthInstance as c8, type PasswordStrengthOptions as c9, type RowChange as cA, type RowId as cB, STRENGTH_LABELS as cC, type ScratchCardInstance as cD, type ScratchCardOptions as cE, type ScrollIslandInstance as cF, type ScrollIslandOptions as cG, type SelectInstance as cH, type SelectOption as cI, type SelectOptions as cJ, type Side as cK, type SkeletonAnimation as cL, type SkeletonInstance as cM, type SkeletonOptions as cN, type SkeletonShape as cO, type SlotPickerInstance as cP, type SlotPickerLabels as cQ, type SlotPickerOptions as cR, type SlotSource as cS, type SlotValue as cT, type SortDirection as cU, type SplitSide as cV, type SplitViewInstance as cW, type SplitViewOptions as cX, type StarRatingInstance as cY, type StarRatingOptions as cZ, type StatCardInstance as c_, type Placed as ca, type Placement as cb, type PopoverInstance as cc, type PopoverOptions as cd, type ProgressInstance as ce, type ProgressOptions as cf, type ProgressVariant as cg, type QuantityInstance as ch, type QuantityOptions as ci, type QuestionnaireAnswers as cj, type QuestionnaireInstance as ck, type QuestionnaireLabels as cl, type QuestionnaireOptions as cm, type RangeCalendarInstance as cn, type RangeCalendarOptions as co, type RangeSliderInstance as cp, type RangeSliderOptions as cq, type RangeValue as cr, type ResizablePanelInstance as cs, type ResizablePanelOptions as ct, type RevealOptions as cu, type RevealSpeed as cv, type Rgba as cw, type RichCommand as cx, type RichTextEditorInstance as cy, type RichTextEditorOptions as cz, createPagination as d, rangeKeys as d$, type StudioDockInstance as d0, type StudioDockOptions as d1, type StudioDockState as d2, type StudioDockView as d3, TIMING as d4, type TagInputInstance as d5, type TagInputOptions as d6, type TimeFieldInstance as d7, type TimeFieldOptions as d8, type TimeInput as d9, createSizes as dA, cvcLength as dB, dateTimeKey as dC, dayKey as dD, dayLabel as dE, describeAccept as dF, describeFilter as dG, detectBrand as dH, emptyFilter as dI, fileFamily as dJ, findNode as dK, formatBytes as dL, formatColor as dM, formatNumber as dN, formatSize as dO, getChannel as dP, hasConditions as dQ, hsvToRgb as dR, jsonPath as dS, linkDomain as dT, luhn as dU, luminance as dV, matchesFilter as dW, normaliseSizes as dX, parseColor as dY, parseExpiry as dZ, place as d_, type TimelineEvent as da, type TimelineInstance as db, type TimelineOptions as dc, type TimelineStatus as dd, type TooltipInstance as de, type TooltipOptions as df, type TrailerInstance as dg, type TrailerOptions as dh, type TreeNode as di, type TreeViewInstance as dj, type TreeViewOptions as dk, type VirtualKey as dl, type VirtualListInstance as dm, type VirtualListOptions as dn, type VirtualRange as dp, type VirtualScrollOptions as dq, type VirtualSizes as dr, acceptsFile as ds, bandDuration as dt, cardLength as du, channelText as dv, checkStates as dw, codeLines as dx, createDialog as dy, createMenu as dz, createHoverCard as e, rangeLength as e0, readAnswers as e1, relativeTime as e2, revealFrom as e3, rgbToHsv as e4, safeHref as e5, safeImage as e6, sanitizeHtml as e7, scorePassword as e8, searchTree as e9, setChannel as ea, skeletonBones as eb, sortEntries as ec, toDate as ed, toDateTimeValue as ee, toHex as ef, toHsva as eg, toRange as eh, toggleCheck as ei, createInputOtp as f, createCalendar as g, createSlotPicker as h, createCreditCard as i, createCommandSearch as j, createHoldConfirm as k, createImagePreview as l, createNotificationBell as m, createPasswordStrength as n, createScratchCard as o, createStarRating as p, createAttachment as q, createSkeleton as r, createQuestionnaire as s, createCodeBlock as t, createContextMenu as u, createLinkPreview as v, createProgress as w, createRangeSlider as x, createChart as y, createColorSlider as z };
+/** Coordinates are fractions of the drawing area, independent of its size. */
+interface SignaturePoint {
+    x: number;
+    y: number;
+}
+interface SignatureStroke {
+    points: SignaturePoint[];
+    color: string;
+    width: number;
+}
+interface SignatureData {
+    version: 1;
+    strokes: SignatureStroke[];
+}
+type SignaturePadChangeReason = 'draw' | 'undo' | 'redo' | 'clear' | 'import' | 'reset';
+interface SignaturePadChangeDetail {
+    data: SignatureData;
+    reason: SignaturePadChangeReason;
+    isEmpty: boolean;
+    canUndo: boolean;
+    canRedo: boolean;
+}
+interface SignatureExportOptions {
+    /** CSS pixels; default is the current drawing area, or 640 × 240 before layout. */
+    width?: number;
+    height?: number;
+    /** Omit for transparency. Accepts a literal CSS color, without variables or URLs. */
+    background?: string;
+}
+interface SignaturePNGOptions extends SignatureExportOptions {
+    /** Raster resolution multiplier, clamped to 1–4 (default 2). */
+    scale?: number;
+}
+interface SignaturePadOptions {
+    data?: SignatureData;
+    label?: string;
+    hint?: string;
+    placeholder?: string;
+    /** Literal CSS ink color; defaults to the theme's text color. */
+    color?: string;
+    /** Ink width in CSS pixels, default 2.4. */
+    width?: number;
+    disabled?: boolean;
+    readOnly?: boolean;
+    /** Include native undo, redo and clear buttons (default true). */
+    toolbar?: boolean;
+    /** Adds a hidden input containing the versioned JSON data. */
+    name?: string;
+    /** Maximum undo steps, clamped to 1–100 (default 50). */
+    historyLimit?: number;
+    onChange?: (data: SignatureData, detail: SignaturePadChangeDetail) => void;
+}
+interface SignaturePadInstance extends Instance {
+    readonly data: SignatureData;
+    readonly isEmpty: boolean;
+    readonly canUndo: boolean;
+    readonly canRedo: boolean;
+    undo(): void;
+    redo(): void;
+    clear(): void;
+    /** Invalid input returns false and leaves the signature untouched. Import resets history. */
+    importData(data: unknown, notify?: boolean): boolean;
+    exportData(): SignatureData;
+    exportSVG(options?: SignatureExportOptions): string;
+    /** Returns null when rasterization is unavailable or fails. */
+    exportPNG(options?: SignaturePNGOptions): Promise<Blob | null>;
+    setDisabled(disabled: boolean): void;
+    setReadOnly(readOnly: boolean): void;
+}
+/** A responsive SVG drawing pad. Drawing is immediate; only toolbar feedback uses motion. */
+declare function createSignaturePad(root: HTMLElement | null, options?: SignaturePadOptions): SignaturePadInstance;
+
+type WaveformPlayerStatus = 'idle' | 'loading' | 'ready' | 'playing' | 'paused' | 'ended' | 'error';
+interface WaveformPlayerState {
+    status: WaveformPlayerStatus;
+    currentTime: number;
+    /** 0 until finite metadata is available. Live streams cannot be sought. */
+    duration: number;
+    playbackRate: number;
+    error: string | null;
+}
+interface WaveformPlayerOptions {
+    src?: string;
+    /** Normalized amplitudes (0…1), supplied by your application, not audio analysis. */
+    peaks?: readonly number[];
+    label?: string;
+    disabled?: boolean;
+    /** Defaults to [1, 1.5, 2]. false hides the rate button. */
+    playbackRates?: readonly number[] | false;
+    /** Status transitions (time changes have their own callback). */
+    onStateChange?: (state: WaveformPlayerState) => void;
+    onTimeUpdate?: (state: WaveformPlayerState) => void;
+    onPlay?: (state: WaveformPlayerState) => void;
+    onPause?: (state: WaveformPlayerState) => void;
+    onEnded?: (state: WaveformPlayerState) => void;
+    onError?: (state: WaveformPlayerState) => void;
+}
+interface WaveformPlayerInstance extends Instance {
+    /** Resolves false when unavailable, cancelled, or rejected. Never rejects for media errors. */
+    play(): Promise<boolean>;
+    pause(): void;
+    /** Seconds, clamped to the finite duration; ignored until metadata is available. */
+    seek(seconds: number): void;
+    /** Updates presentation/callbacks in place. A different src pauses and resets playback. */
+    update(options: Partial<WaveformPlayerOptions>): void;
+    readonly state: WaveformPlayerState;
+    readonly audio: HTMLAudioElement | null;
+}
+declare function createWaveformPlayer(root: HTMLElement | null, options?: WaveformPlayerOptions): WaveformPlayerInstance;
+
+type VoiceMessageStatus = 'sending' | 'sent' | 'delivered' | 'read' | 'failed';
+interface VoiceMessageBubbleOptions extends WaveformPlayerOptions {
+    direction?: 'incoming' | 'outgoing';
+    author?: string;
+    timestamp?: string;
+    /** Optional machine-readable timestamp for the time element. */
+    dateTime?: string;
+    status?: VoiceMessageStatus;
+}
+interface VoiceMessageBubbleInstance extends WaveformPlayerInstance {
+    update(options: Partial<VoiceMessageBubbleOptions>): void;
+}
+/** A message presentation around the real waveform audio player. Never records audio. */
+declare function createVoiceMessageBubble(root: HTMLElement | null, options?: VoiceMessageBubbleOptions): VoiceMessageBubbleInstance;
+
+interface DrilldownMenuItem {
+    /** Unique among siblings; IDs form the navigation path. */
+    id: string;
+    label: string;
+    description?: string;
+    disabled?: boolean;
+    /** Present (even an empty array) for a level; absent for an action. */
+    children?: DrilldownMenuItem[];
+}
+interface DrilldownMenuOptions {
+    items?: DrilldownMenuItem[];
+    /** IDs of branches from the root to the initial level. */
+    path?: string[];
+    /** Root heading and accessible name (default 'Actions'). */
+    label?: string;
+    backLabel?: string;
+    emptyText?: string;
+    /** An action's complete path, including the action's ID. */
+    onSelect?: (item: DrilldownMenuItem, path: string[]) => void;
+    /** Navigation only; the path contains branch IDs. */
+    onPathChange?: (path: string[]) => void;
+}
+interface DrilldownMenuInstance extends Instance {
+    /** Open a branch in the current level; false for missing, disabled or leaf items. */
+    open(id: string): boolean;
+    back(): boolean;
+    root(): void;
+    reset(): void;
+    /** Invalid, disabled or non-branch IDs truncate the requested path safely. */
+    setPath(path: string[], notify?: boolean): void;
+    setItems(items: DrilldownMenuItem[]): void;
+    update(options: Partial<DrilldownMenuOptions>): void;
+    focusItem(id: string): void;
+    readonly path: string[];
+    /** Items in the current level. */
+    readonly items: DrilldownMenuItem[];
+    readonly element: HTMLElement;
+}
+/** A single live level: directional slide + blur, roving menu focus, and reversible DOM ownership. */
+declare function createDrilldownMenu(root: HTMLElement | null, options?: DrilldownMenuOptions): DrilldownMenuInstance;
+
+interface WheelPickerItem {
+    value: string;
+    label: string;
+    disabled?: boolean;
+}
+type WheelPickerEntry = string | WheelPickerItem;
+interface WheelPickerOptions {
+    items?: WheelPickerEntry[];
+    value?: string;
+    name?: string;
+    label?: string;
+    disabled?: boolean;
+    /** Odd number of visible rows, 3…9 (default 5). */
+    visibleItems?: number;
+    /** Height per row in px, at least 44 (default 44). */
+    itemHeight?: number;
+    onInput?: (value: string) => void;
+    onChange?: (value: string) => void;
+}
+interface WheelPickerInstance extends Instance {
+    setValue(value: string, notify?: boolean): void;
+    setItems(items: WheelPickerEntry[], notify?: boolean): void;
+    readonly value: string;
+}
+/** Native scrolling and inertia with a centred snap row, roving selection and a real form value. */
+declare function createWheelPicker(root: HTMLElement | null, options?: WheelPickerOptions): WheelPickerInstance;
+
+export { createPopover as $, createCalendar as A, createSlotPicker as B, createCreditCard as C, createCommandSearch as D, createHoldConfirm as E, createImagePreview as F, createNotificationBell as G, createPasswordStrength as H, createScratchCard as I, createStarRating as J, createAttachment as K, createSkeleton as L, createQuestionnaire as M, createCodeBlock as N, createContextMenu as O, createLinkPreview as P, createProgress as Q, createRangeSlider as R, createChart as S, createColorSlider as T, createColorArea as U, createColorField as V, createColorPicker as W, createTimeField as X, createRangeCalendar as Y, createDateRangePicker as Z, createTooltip as _, createRadioGroup as a, type ChartType as a$, createLoadingButton as a0, createBreadcrumb as a1, createEmptyState as a2, createStatCard as a3, createChartTooltip as a4, createMultiSelect as a5, createTagInput as a6, createDateTimePicker as a7, createFilterBuilder as a8, createTimeline as a9, type AttachmentRejectCode as aA, type AttachmentRejection as aB, type AttachmentStatus as aC, BRAND_LABELS as aD, type BadgeButtonInstance as aE, type BadgeButtonOptions as aF, type BentoGridInstance as aG, type BentoGridOptions as aH, type BreadcrumbInstance as aI, type BreadcrumbItem as aJ, type BreadcrumbOptions as aK, CHANNEL_LABELS as aL, type CalendarEvent as aM, type CalendarEventStatus as aN, type CalendarInstance as aO, type CalendarLabels as aP, type CalendarOptions as aQ, type CalendarRange as aR, type CalendarView as aS, type CardBrand as aT, type ChartInstance as aU, type ChartOptions as aV, type ChartPoint as aW, type ChartSeries as aX, type ChartTooltipInstance as aY, type ChartTooltipOptions as aZ, type ChartTooltipSeries as a_, createActivityFeed as aa, createTreeView as ab, createFileExplorer as ac, createJsonViewer as ad, createVirtualList as ae, createResizablePanel as af, createSplitView as ag, createDataTable as ah, createEditableTable as ai, createRichTextEditor as aj, createSelect as ak, createAddToCart as al, createScrollIsland as am, type RevealHandle as an, type DateInput as ao, type ActivityActor as ap, type ActivityFeedInstance as aq, type ActivityFeedOptions as ar, type ActivityItem as as, type ActivityKind as at, type AddToCartInstance as au, type AddToCartOptions as av, type AttachmentFile as aw, type AttachmentInstance as ax, type AttachmentLabels as ay, type AttachmentOptions as az, createEqualizerSlider as b, type FilterField as b$, type CheckState as b0, type CodeBlockInstance as b1, type CodeBlockOptions as b2, type ColorAreaInstance as b3, type ColorAreaOptions as b4, type ColorChannel as b5, type ColorFieldInstance as b6, type ColorFieldOptions as b7, type ColorFormat as b8, type ColorPickerInstance as b9, type DialogLabels as bA, type DialogOptions as bB, type DialogPlacement as bC, type DialogVariant as bD, type DrilldownMenuInstance as bE, type DrilldownMenuItem as bF, type DrilldownMenuOptions as bG, type EditableColumn as bH, type EditableTableInstance as bI, type EditableTableOptions as bJ, type EditorKind as bK, type EmptyAction as bL, type EmptyIllustration as bM, type EmptyStateInstance as bN, type EmptyStateOptions as bO, type EqualizerSliderInstance as bP, type EqualizerSliderOptions as bQ, type Expiry as bR, type FileChange as bS, type FileEntry as bT, type FileExplorerInstance as bU, type FileExplorerOptions as bV, type FileFamily as bW, type FileSort as bX, type FileView as bY, type FilterBuilderInstance as bZ, type FilterBuilderOptions as b_, type ColorPickerOptions as ba, type ColorSliderInstance as bb, type ColorSliderOptions as bc, type CommandItem as bd, type CommandSearchInstance as be, type CommandSearchOptions as bf, type ContextMenuInstance as bg, type ContextMenuOptions as bh, type CreditCardField as bi, type CreditCardInstance as bj, type CreditCardLabels as bk, type CreditCardOptions as bl, type CreditCardValues as bm, type DataAction as bn, type DataColumn as bo, type DataColumnType as bp, type DataRow as bq, type DataSort as br, type DataTableInstance as bs, type DataTableOptions as bt, type DateRange as bu, type DateRangePickerInstance as bv, type DateRangePickerOptions as bw, type DateTimePickerInstance as bx, type DateTimePickerOptions as by, type DialogInstance as bz, createStepper as c, type QuestionnaireInstance as c$, type FilterFieldType as c0, type FilterGroup as c1, type FilterNode as c2, type FilterRule as c3, type FilterValue as c4, type HandwritingTextInstance as c5, type HandwritingTextOptions as c6, type HoldConfirmInstance as c7, type HoldConfirmOptions as c8, type HoverCardInstance as c9, type NotFoundOptions as cA, type NotificationBellInstance as cB, type NotificationBellOptions as cC, type NotificationStackDirection as cD, type NotificationStackInstance as cE, type NotificationStackItem as cF, type NotificationStackOptions as cG, OPERATORS as cH, type PaginationInstance as cI, type PaginationOptions as cJ, type PanelOrientation as cK, type ParticleButtonInstance as cL, type ParticleButtonOptions as cM, type PasswordChecks as cN, type PasswordScore as cO, type PasswordStrengthInstance as cP, type PasswordStrengthOptions as cQ, type Placed as cR, type Placement as cS, type PopoverInstance as cT, type PopoverOptions as cU, type ProgressInstance as cV, type ProgressOptions as cW, type ProgressVariant as cX, type QuantityInstance as cY, type QuantityOptions as cZ, type QuestionnaireAnswers as c_, type HoverCardOptions as ca, type Hsla as cb, type Hsva as cc, type ImagePreviewInstance as cd, type ImagePreviewOptions as ce, type InputOtpInstance as cf, type InputOtpOptions as cg, type JsonType as ch, type JsonViewerInstance as ci, type JsonViewerOptions as cj, type LinkPreviewInstance as ck, type LinkPreviewOptions as cl, type LinkPreviewVariant as cm, type LoadingButtonInstance as cn, type LoadingButtonOptions as co, type LoadingState as cp, type MagnetizeButtonInstance as cq, type MagnetizeButtonOptions as cr, type MenuInstance as cs, type MenuOptions as ct, type MorphingPageDotsInstance as cu, type MorphingPageDotsOptions as cv, type MultiSelectInstance as cw, type MultiSelectOption as cx, type MultiSelectOptions as cy, type NotFoundInstance as cz, createTemperatureSlider as d, type StepperOptions as d$, type QuestionnaireLabels as d0, type QuestionnaireOptions as d1, type RadioGroupInstance as d2, type RadioGroupItem as d3, type RadioGroupOptions as d4, type RangeCalendarInstance as d5, type RangeCalendarOptions as d6, type RangeSliderInstance as d7, type RangeSliderOptions as d8, type RangeValue as d9, type SignatureExportOptions as dA, type SignaturePNGOptions as dB, type SignaturePadChangeDetail as dC, type SignaturePadChangeReason as dD, type SignaturePadInstance as dE, type SignaturePadOptions as dF, type SignaturePoint as dG, type SignatureStroke as dH, type SkeletonAnimation as dI, type SkeletonInstance as dJ, type SkeletonOptions as dK, type SkeletonShape as dL, type SlotPickerInstance as dM, type SlotPickerLabels as dN, type SlotPickerOptions as dO, type SlotSource as dP, type SlotValue as dQ, type SortDirection as dR, type SplitSide as dS, type SplitViewInstance as dT, type SplitViewOptions as dU, type StarRatingInstance as dV, type StarRatingOptions as dW, type StatCardInstance as dX, type StatCardOptions as dY, type StepperInstance as dZ, type StepperItem as d_, type RatingScaleInstance as da, type RatingScaleOptions as db, type ResizablePanelInstance as dc, type ResizablePanelOptions as dd, type RevealOptions as de, type RevealSpeed as df, type Rgba as dg, type RichCommand as dh, type RichTextEditorInstance as di, type RichTextEditorOptions as dj, type RowChange as dk, type RowId as dl, STRENGTH_LABELS as dm, type ScratchCardInstance as dn, type ScratchCardOptions as dp, type ScrollIslandInstance as dq, type ScrollIslandOptions as dr, type ScrollPreviewDockInstance as ds, type ScrollPreviewDockItem as dt, type ScrollPreviewDockOptions as du, type SelectInstance as dv, type SelectOption as dw, type SelectOptions as dx, type Side as dy, type SignatureData as dz, createRatingScale as e, formatColor as e$, type StickyHeaderInstance as e0, type StickyHeaderOptions as e1, type StudioDockInstance as e2, type StudioDockOptions as e3, type StudioDockState as e4, type StudioDockView as e5, TIMING as e6, type TagInputInstance as e7, type TagInputOptions as e8, type TemperatureSliderInstance as e9, type WaveformPlayerOptions as eA, type WaveformPlayerState as eB, type WaveformPlayerStatus as eC, type WheelPickerEntry as eD, type WheelPickerInstance as eE, type WheelPickerItem as eF, type WheelPickerOptions as eG, acceptsFile as eH, bandDuration as eI, cardLength as eJ, channelText as eK, checkStates as eL, codeLines as eM, createDialog as eN, createMenu as eO, createSizes as eP, cvcLength as eQ, dateTimeKey as eR, dayKey as eS, dayLabel as eT, describeAccept as eU, describeFilter as eV, detectBrand as eW, emptyFilter as eX, fileFamily as eY, findNode as eZ, formatBytes as e_, type TemperatureSliderOptions as ea, type TemperatureUnit as eb, type TimeFieldInstance as ec, type TimeFieldOptions as ed, type TimeInput as ee, type TimelineEvent as ef, type TimelineInstance as eg, type TimelineOptions as eh, type TimelineStatus as ei, type TooltipInstance as ej, type TooltipOptions as ek, type TrailerInstance as el, type TrailerOptions as em, type TreeNode as en, type TreeViewInstance as eo, type TreeViewOptions as ep, type VirtualKey as eq, type VirtualListInstance as er, type VirtualListOptions as es, type VirtualRange as et, type VirtualScrollOptions as eu, type VirtualSizes as ev, type VoiceMessageBubbleInstance as ew, type VoiceMessageBubbleOptions as ex, type VoiceMessageStatus as ey, type WaveformPlayerInstance as ez, createNotificationStack as f, formatNumber as f0, formatSize as f1, getChannel as f2, hasConditions as f3, hsvToRgb as f4, jsonPath as f5, linkDomain as f6, luhn as f7, luminance as f8, matchesFilter as f9, normaliseSizes as fa, parseColor as fb, parseExpiry as fc, place as fd, rangeKeys as fe, rangeLength as ff, readAnswers as fg, relativeTime as fh, revealFrom as fi, rgbToHsv as fj, safeHref as fk, safeImage as fl, sanitizeHtml as fm, scorePassword as fn, searchTree as fo, setChannel as fp, skeletonBones as fq, sortEntries as fr, toDate as fs, toDateTimeValue as ft, toHex as fu, toHsva as fv, toRange as fw, toggleCheck as fx, createBentoGrid as g, createScrollPreviewDock as h, createStickyHeader as i, createHandwritingText as j, createParticleButton as k, createMagnetizeButton as l, createBadgeButton as m, createMorphingPageDots as n, createNotFound as o, createWheelPicker as p, createDrilldownMenu as q, createVoiceMessageBubble as r, createWaveformPlayer as s, createSignaturePad as t, createStudioDock as u, createTrailer as v, createQuantity as w, createPagination as x, createHoverCard as y, createInputOtp as z };