@yewdiel21/motion-kit 0.9.0 → 0.10.0

package/dist/{reduced-BM4Ls0g5.d.ts → reduced-BmBzKH94.d.ts}

@@ -1,4 +1,4 @@
-import { e as MenuOptions, M as MenuInstance, g as RevealSpeed } from './reveal-WFUWDrei.js';
+import { x as MenuOptions, M as MenuInstance, B as RevealSpeed } from './reveal-jsX-uwUz.js';
 import { I as Instance } from './types-BkS_raL8.js';
 import { SplitText } from 'gsap/SplitText';
 
@@ -30,6 +30,203 @@ interface CurvedCarouselInstance extends Instance {
 }
 declare function createCurvedCarousel(root: HTMLElement | null, options?: CurvedCarouselOptions): CurvedCarouselInstance;
 
+interface JoinedCtaOptions {
+    duration?: number;
+}
+interface JoinedCtaInstance extends Instance {
+    expand(): void;
+    collapse(): void;
+    readonly expanded: boolean;
+}
+/** Silvia's three contact capsules joining into one. Motion is entirely CSS. */
+declare function createJoinedCta(root: HTMLElement | null, options?: JoinedCtaOptions): JoinedCtaInstance;
+
+interface ImageZoomOptions {
+    duration?: number;
+    frameScale?: number;
+    imageScale?: number;
+}
+interface ImageZoomInstance extends Instance {
+    open(active: boolean): void;
+    readonly active: boolean;
+}
+/** Counter-zoom: the clipped frame grows as the picture inside settles to 1×. */
+declare function createImageZoom(root: HTMLElement | null, options?: ImageZoomOptions): ImageZoomInstance;
+
+interface FontCycleFace {
+    /** A font supplied by the application. No font files are downloaded by this recipe. */
+    family?: string;
+    axes?: Readonly<Record<string, number>>;
+    weight?: number;
+    style?: 'normal' | 'italic' | 'oblique';
+}
+interface FontCycleOptions {
+    text?: string;
+    /** Alternated per character; the second face rolls in on hover or focus. */
+    faces?: readonly [FontCycleFace, FontCycleFace];
+    /** Seconds per character. */
+    duration?: number;
+    /** Seconds between characters. */
+    stagger?: number;
+    /** Optional decorative artwork owned by the consumer. Hidden with reduced motion. */
+    overlaySrc?: string;
+}
+interface FontCycleInstance extends Instance {
+    play(): void;
+    reset(): void;
+    readonly active: boolean;
+}
+/** Alternating variable-font faces in a masked, reversible character roll. */
+declare function createFontCycle(root: HTMLElement | null, options?: FontCycleOptions): FontCycleInstance;
+
+interface ThumbnailNavOptions {
+    index?: number;
+    label?: string;
+    /** Seconds for expansion and panel entry. */
+    duration?: number;
+    onSelect?: (index: number, item: HTMLElement) => void;
+}
+interface ThumbnailNavInstance extends Instance {
+    open(): void;
+    close(): void;
+    toggle(): void;
+    select(index: number): void;
+    readonly index: number;
+    readonly expanded: boolean;
+}
+/** A category disclosure with stacked previews, real links and complete keyboard navigation. */
+declare function createThumbnailNav(root: HTMLElement | null, options?: ThumbnailNavOptions): ThumbnailNavInstance;
+
+type ActionButtonVariant = 'primary' | 'secondary' | 'icon' | 'stepper' | 'film';
+interface ActionButtonOptions {
+    variant?: ActionButtonVariant;
+    /** Toggle aria-pressed on activation. Ordinary action buttons leave it unset. */
+    toggle?: boolean;
+    pressed?: boolean;
+    onPressedChange?: (pressed: boolean) => void;
+}
+interface ActionButtonInstance extends Instance {
+    setPressed(pressed: boolean): void;
+    readonly pressed: boolean;
+}
+/** Drawn press buttons and a masked rolling-label film variant. Uses native activation. */
+declare function createActionButton(root: HTMLElement | null, options?: ActionButtonOptions): ActionButtonInstance;
+
+interface FilmHeroOptions {
+    duration?: number;
+    stagger?: number;
+    /** Media travel as a fraction of the hero height. 0 disables parallax. */
+    parallax?: number;
+    scale?: number;
+    edge?: 'organic' | 'straight';
+    /** Scrollable demo panels and nested page shells can supply their own scroll root. */
+    scroller?: HTMLElement | Window;
+}
+interface FilmHeroInstance extends Instance {
+    replay(): void;
+    refresh(): void;
+}
+/** Editorial line reveals with scoped, scroll-driven media. Organic edge is an approximation. */
+declare function createFilmHero(root: HTMLElement | null, options?: FilmHeroOptions): FilmHeroInstance;
+
+interface EditorialRevealOptions {
+    trigger?: 'scroll' | 'load' | 'manual';
+    /** Title and staged groups, seconds. Reference default 1.2. */
+    duration?: number;
+    stagger?: number;
+    /** Title pieces' start offset, percent. Reference default 110. */
+    y?: number;
+    ease?: string;
+    hoverDuration?: number;
+    /** Duplicate label/arrow content moves by this many em. */
+    buttonShift?: number;
+    imageScale?: number;
+    parallax?: boolean;
+}
+interface EditorialRevealInstance extends Instance {
+    play(): void;
+    reset(): void;
+}
+/** Editorial composition: masked headings, staged contact groups, restrained image/card motion and keyboard-equivalent buttons. */
+declare function createEditorialReveal(root: HTMLElement | null, options?: EditorialRevealOptions): EditorialRevealInstance;
+
+interface WeightHoverOptions {
+    /** Axis value far from the pointer. */
+    rest?: number;
+    /** Axis value right under the pointer. */
+    near?: number;
+    /** Reach of the effect, px. */
+    radius?: number;
+    /** Variable-font axis tag. */
+    axis?: string;
+    /** Share of the remaining distance covered per frame (0–1). */
+    lerp?: number;
+    /** React to touch and pen too (the reference reacts to the mouse only). */
+    anyPointer?: boolean;
+}
+interface WeightHoverInstance extends Instance {
+    /** Point the effect at viewport coordinates (null releases it). */
+    pointAt(point: {
+        x: number;
+        y: number;
+    } | null): void;
+}
+declare function createWeightHover(root: HTMLElement | null, options?: WeightHoverOptions): WeightHoverInstance;
+
+interface StickerOptions {
+    /** Drag to peel the sticker off. */
+    peel?: boolean;
+    /** Pointer-driven foil and shine. */
+    holo?: boolean;
+    /** Share of the area lifted before the sticker comes off (0–1). */
+    detachAt?: number;
+    /** Drag length (px, unscaled) that takes it off whatever the area; default max(80, half the longest side). */
+    detachDistance?: number;
+    /** Time hidden after falling before it comes back, ms. */
+    returnDelay?: number;
+    onPeel?: () => void;
+    onReturn?: () => void;
+}
+interface StickerInstance extends Instance {
+    /** idle | peeling | carried | falling | away */
+    readonly state: StickerState;
+}
+type StickerState = 'idle' | 'peeling' | 'carried' | 'falling' | 'away';
+declare function createSticker(root: HTMLElement | null, options?: StickerOptions): StickerInstance;
+
+interface ScrollDockOptions {
+    /** Scroll distance before it shows, in viewport heights. */
+    threshold?: number;
+    /** Element (or selector) that sends it away when it reaches the viewport bottom. */
+    hideWhen?: Element | string | null;
+    /** px above the bottom edge at which `hideWhen` counts as reached. */
+    hideOffset?: number;
+    /** Scrolling element (or selector, looked up from the dock outwards); the window by default. */
+    scroller?: HTMLElement | string | null;
+    onChange?: (visible: boolean) => void;
+}
+interface ScrollDockInstance extends Instance {
+    readonly visible: boolean;
+    /** Re-read the scroll position (after layout changes). */
+    update(): void;
+}
+declare function createScrollDock(root: HTMLElement | null, options?: ScrollDockOptions): ScrollDockInstance;
+
+interface LocalClockOptions {
+    /** IANA zone, e.g. "America/Mexico_City". The visitor's zone by default. */
+    timeZone?: string;
+    locale?: string;
+    hour12?: boolean;
+    seconds?: boolean;
+    /** Full control over the format (overrides hour12/seconds). */
+    format?: Intl.DateTimeFormatOptions;
+}
+interface LocalClockInstance extends Instance {
+    /** Text currently shown. */
+    readonly text: string;
+}
+declare function createLocalClock(root: HTMLElement | null, options?: LocalClockOptions): LocalClockInstance;
+
 interface SpringCardsOptions {
     /** Cards inside the root. */
     selector?: string;
@@ -58,7 +255,7 @@ interface PileLayer {
     offsetX: number;
     offsetY: number;
 }
-/** Spencer's stack transforms, seeded so SSR output is stable. Layer 0 is the back. */
+/** stack transforms, seeded so SSR output is stable. Layer 0 is the back. */
 declare function pileLayers(count: number, seed: number): PileLayer[];
 
 interface PileOptions {
@@ -123,7 +320,7 @@ declare function flowIn(targets: gsap.TweenTarget, options?: FlowInOptions): gsa
 /** Flow items out (down into a blur). They stay hidden afterwards; flowIn brings them back. */
 declare function flowOut(targets: gsap.TweenTarget, options?: FlowOutOptions): gsap.core.Tween | null;
 /**
- * Stepbro's step change: the current children flow out, `mutate` swaps the
+ * step change: the current children flow out, `mutate` swaps the
  * content (render the next step there), and after a frame the new children flow in.
  */
 declare function stepChange(container: HTMLElement, mutate: () => void | Promise<void>, { duration }?: {
@@ -283,7 +480,7 @@ interface SortableOptions {
     /** Drag only from [data-mk-sort-handle] (always so on touch screens). */
     handle?: boolean;
     autoScroll?: boolean;
-    /** The floating copy's spring (Stepbro: 1100 / 38). */
+    /** The floating copy's spring (default: 1100 / 38). */
     follow?: {
         stiffness?: number;
         damping?: number;
@@ -299,7 +496,7 @@ interface ReorderDetail {
     fromIndex: number;
     toIndex: number;
     groupChanged: boolean;
-    /** Neighbours at the destination (Stepbro sends one to its API as the anchor). */
+    /** Neighbours at the destination. */
     afterId: string | null;
     beforeId: string | null;
 }
@@ -314,7 +511,7 @@ declare function moveItem<T>(list: readonly T[], from: number, to: number): T[];
 
 interface MaskTextOptions {
     by?: 'lines' | 'words' | 'chars';
-    /** Start offset in % of each piece (Siena's case titles: 120). */
+    /** Start offset in % of each piece. */
     y?: number;
     duration?: number;
     ease?: string;
@@ -322,12 +519,12 @@ interface MaskTextOptions {
     stagger?: number;
     /** 'scroll' (default) plays when 80 % is visible; 'load' now; 'manual' waits for play(). */
     trigger?: 'scroll' | 'load' | 'manual';
-    /** Play once and stay (OFFFICE's data-a-mod). */
+    /** Play once and stay. */
     once?: boolean;
 }
 interface MaskTextInstance extends Instance {
     play(): void;
-    /** OFFFICE's exit: back down into the clips, 2 ms apart. */
+    /** exit: back down into the clips, 2 ms apart. */
     hide(): void;
     readonly split: SplitText | null;
 }
@@ -344,7 +541,7 @@ interface CascadeOptions {
 }
 interface CascadeInstance extends Instance {
     play(): void;
-    /** Every child back to its start state (what Siena does when the block leaves). */
+    /** Every child back to its start state. */
     reset(): void;
 }
 declare function createCascade(root: HTMLElement | null, options?: CascadeOptions): CascadeInstance;
@@ -352,12 +549,12 @@ declare function createCascade(root: HTMLElement | null, options?: CascadeOption
 interface TextRollOptions {
     duration?: number;
     stagger?: number;
-    /** [min, max] repeats of each letter's turn (Siena: 8–14). */
+    /** [min, max] repeats of each letter's turn (default: 8–14). */
     turns?: readonly [number, number];
     /** 'load' (default) after `delay`; 'scroll' when it shows; 'hover'; 'manual'. */
     trigger?: 'load' | 'scroll' | 'hover' | 'manual';
     delay?: number;
-    /** Replay every n ms while visible and not scrolling (Siena: 6000). 0: off. */
+    /** Replay every n ms while visible and not scrolling (default: 6000). 0: off. */
     interval?: number;
 }
 interface TextRollInstance extends Instance {
@@ -368,7 +565,7 @@ declare function createTextRoll(el: HTMLElement | null, options?: TextRollOption
 
 interface LettersOptions {
     effect?: 'scale' | 'blink';
-    /** Blink colours (default Dousan's pastels). */
+    /** Blink colours. */
     colors?: string[];
     /** Blink once 0.6 s after start (default true). */
     autoplay?: boolean;
@@ -432,7 +629,7 @@ interface ContrastInstance extends Instance {
 declare function createContrast(target: HTMLElement | null, options?: ContrastOptions): ContrastInstance;
 
 interface MarqueeOptions {
-    /** 'x' (default) or 'y' (Siena's vertical strip). */
+    /** 'x' (default) or 'y'. */
     axis?: 'x' | 'y';
     /** Seconds per item. */
     speed?: number;
@@ -445,7 +642,7 @@ interface MarqueeInstance extends Instance {
 declare function createMarquee(root: HTMLElement | null, options?: MarqueeOptions): MarqueeInstance;
 
 interface CardDockOptions {
-    /** Milliseconds the cards stay spread out on load before stacking (iyo: 1600; 0 skips it). */
+    /** Milliseconds the cards stay spread out on load before stacking (default: 1600; 0 skips it). */
     intro?: number;
 }
 interface CardDockInstance extends Instance {
@@ -457,11 +654,11 @@ declare function createCardDock(root: HTMLElement | null, options?: CardDockOpti
 
 interface SnapStripOptions {
     autoplay?: boolean;
-    /** Milliseconds between cards (iyo: 5000). */
+    /** Milliseconds between cards (default: 5000). */
     interval?: number;
-    /** Milliseconds to wait after the reader touches it (iyo: 2000). */
+    /** Milliseconds to wait after the reader touches it (default: 2000). */
     resume?: number;
-    /** Milliseconds after it shows before autoplay starts (iyo's data-delay: 500). */
+    /** Milliseconds after it shows before autoplay starts. */
     delay?: number;
 }
 interface SnapStripInstance extends Instance {
@@ -563,4 +760,4 @@ declare function entrances(): boolean;
  */
 declare const MK_HEAD_SCRIPT = "(function(){var r=document.documentElement;r.classList.add('mk-js');setTimeout(function(){if(!r.classList.contains('mk-ready'))r.classList.add('mk-failed')},2500)})();";
 
-export { type FitTextOptions as $, type TicketMenuInstance as A, createInfiniteReel as B, type CurvedCarouselInstance as C, createRepelBento as D, createRotator as E, createDragRuler as F, createDockPill as G, type CardDockInstance as H, type CardDockOptions as I, type CascadeInstance as J, type CascadeOptions as K, type ContrastInstance as L, MK_HEAD_SCRIPT as M, type ContrastOptions as N, type CounterInstance as O, type CounterOptions as P, type CurvedCarouselOptions as Q, type DepthGridInstance as R, type DepthGridOptions as S, type TicketMenuOptions as T, type DockPillInstance as U, type DockPillOptions as V, type DragRulerInstance as W, type DragRulerOptions as X, type FillTextInstance as Y, type FillTextOptions as Z, type FitTextInstance as _, createPile as a, type FlowInOptions as a0, type FlowInstance as a1, type FlowOptions as a2, type FlowOutOptions as a3, type FrameZoomInstance as a4, type FrameZoomOptions as a5, type InfiniteReelInstance as a6, type InfiniteReelOptions as a7, type LettersInstance as a8, type LettersOptions as a9, type SortableInstance as aA, type SortableLabels as aB, type SortableOptions as aC, type SpringCardsInstance as aD, type SpringCardsOptions as aE, type StretchFooterInstance as aF, type StretchFooterOptions as aG, type TabsInstance as aH, type TabsOptions as aI, type TextRollInstance as aJ, type TextRollOptions as aK, type WordsInstance as aL, type WordsOptions as aM, createCurvedCarousel as aN, createTicketMenu as aO, entrances as aP, flowIn as aQ, flowOut as aR, moveItem as aS, pileLayers as aT, pileStyle as aU, reduced as aV, stepChange as aW, type MarqueeInstance as aa, type MarqueeOptions as ab, type MaskTextInstance as ac, type MaskTextOptions as ad, type ParallaxInstance as ae, type ParallaxOptions as af, type PileInstance as ag, type PileLayer as ah, type PileOptions as ai, type PopInstance as aj, type PopOptions as ak, type RadialMenuInstance as al, type RadialMenuOptions as am, type ReflowInstance as an, type ReflowOptions as ao, type ReorderDetail as ap, type RepelBentoInstance as aq, type RepelBentoOptions as ar, type RevealInstance as as, type RevealRecipeOptions as at, type RotatorInstance as au, type RotatorOptions as av, type SlotTextInstance as aw, type SlotTextOptions as ax, type SnapStripInstance as ay, type SnapStripOptions as az, createWords as b, createSpringCards as c, createFlow as d, createPop as e, createFitText as f, createStretchFooter as g, createRadialMenu as h, createTabs as i, createCounter as j, createReveal as k, createReflow as l, createSlotText as m, createSortable as n, createMaskText as o, createCascade as p, createTextRoll as q, createLetters as r, createParallax as s, createDepthGrid as t, createFrameZoom as u, createContrast as v, createMarquee as w, createCardDock as x, createSnapStrip as y, createFillText as z };
+export { type ContrastInstance as $, createCascade as A, createTextRoll as B, type CurvedCarouselInstance as C, createLetters as D, createParallax as E, createDepthGrid as F, createFrameZoom as G, createContrast as H, createMarquee as I, createCardDock as J, createSnapStrip as K, createFillText as L, type TicketMenuInstance as M, createInfiniteReel as N, createRepelBento as O, createRotator as P, createDragRuler as Q, createDockPill as R, MK_HEAD_SCRIPT as S, type TicketMenuOptions as T, type ActionButtonInstance as U, type ActionButtonOptions as V, type ActionButtonVariant as W, type CardDockInstance as X, type CardDockOptions as Y, type CascadeInstance as Z, type CascadeOptions as _, createImageZoom as a, type SnapStripInstance as a$, type ContrastOptions as a0, type CounterInstance as a1, type CounterOptions as a2, type CurvedCarouselOptions as a3, type DepthGridInstance as a4, type DepthGridOptions as a5, type DockPillInstance as a6, type DockPillOptions as a7, type DragRulerInstance as a8, type DragRulerOptions as a9, type LocalClockOptions as aA, type MarqueeInstance as aB, type MarqueeOptions as aC, type MaskTextInstance as aD, type MaskTextOptions as aE, type ParallaxInstance as aF, type ParallaxOptions as aG, type PileInstance as aH, type PileLayer as aI, type PileOptions as aJ, type PopInstance as aK, type PopOptions as aL, type RadialMenuInstance as aM, type RadialMenuOptions as aN, type ReflowInstance as aO, type ReflowOptions as aP, type ReorderDetail as aQ, type RepelBentoInstance as aR, type RepelBentoOptions as aS, type RevealInstance as aT, type RevealRecipeOptions as aU, type RotatorInstance as aV, type RotatorOptions as aW, type ScrollDockInstance as aX, type ScrollDockOptions as aY, type SlotTextInstance as aZ, type SlotTextOptions as a_, type EditorialRevealInstance as aa, type EditorialRevealOptions as ab, type FillTextInstance as ac, type FillTextOptions as ad, type FilmHeroInstance as ae, type FilmHeroOptions as af, type FitTextInstance as ag, type FitTextOptions as ah, type FlowInOptions as ai, type FlowInstance as aj, type FlowOptions as ak, type FlowOutOptions as al, type FontCycleFace as am, type FontCycleInstance as an, type FontCycleOptions as ao, type FrameZoomInstance as ap, type FrameZoomOptions as aq, type ImageZoomInstance as ar, type ImageZoomOptions as as, type InfiniteReelInstance as at, type InfiniteReelOptions as au, type JoinedCtaInstance as av, type JoinedCtaOptions as aw, type LettersInstance as ax, type LettersOptions as ay, type LocalClockInstance as az, createFontCycle as b, type SnapStripOptions as b0, type SortableInstance as b1, type SortableLabels as b2, type SortableOptions as b3, type SpringCardsInstance as b4, type SpringCardsOptions as b5, type StickerInstance as b6, type StickerOptions as b7, type StickerState as b8, type StretchFooterInstance as b9, type StretchFooterOptions as ba, type TabsInstance as bb, type TabsOptions as bc, type TextRollInstance as bd, type TextRollOptions as be, type ThumbnailNavInstance as bf, type ThumbnailNavOptions as bg, type WeightHoverInstance as bh, type WeightHoverOptions as bi, type WordsInstance as bj, type WordsOptions as bk, createCurvedCarousel as bl, createTicketMenu as bm, entrances as bn, flowIn as bo, flowOut as bp, moveItem as bq, pileLayers as br, pileStyle as bs, reduced as bt, stepChange as bu, createJoinedCta as c, createThumbnailNav as d, createActionButton as e, createFilmHero as f, createEditorialReveal as g, createWeightHover as h, createSticker as i, createScrollDock as j, createLocalClock as k, createSpringCards as l, createPile as m, createWords as n, createFlow as o, createPop as p, createFitText as q, createStretchFooter as r, createRadialMenu as s, createTabs as t, createCounter as u, createReveal as v, createReflow as w, createSlotText as x, createSortable as y, createMaskText as z };