use-scroll-animate 2.2.0 → 2.4.0

package/dist/components.d.ts

@@ -721,6 +721,286 @@ declare global {
     }
 }
 
+declare const SPRING_EFFECTS: readonly ["bounce-in", "pop", "drop", "jelly", "rubber-band"];
+type SpringEffect = (typeof SPRING_EFFECTS)[number];
+/** Keyframes of a spring effect (entrances use spring timing, attention effects fixed frames). */
+declare function springEffectKeyframes(effect: string, reduced?: boolean): Keyframe[];
+/**
+ * `<usa-spring>` — spring / bounce effects on its content.
+ *
+ * Attributes: `effect` (`bounce-in` default, `pop`, `drop`, `jelly`,
+ * `rubber-band`), `trigger` (`view` default, `hover`, `click`, `manual`),
+ * `preset` (`gentle`, `wobbly`, `stiff`, `bouncy`, …) or `stiffness` /
+ * `damping` / `mass`, `delay` (ms), `duration` (ms, attention effects; 900),
+ * `repeat` (replay every time it re-enters the view), `block`.
+ * Events: `usa:complete`. Reduced motion: entrances fade, attention effects do nothing.
+ */
+interface UsaSpringElement extends UsaElement {
+    effect: string;
+    play(): Promise<void>;
+    reset(): void;
+}
+declare function defineSpring(tag?: string): CustomElementConstructor | undefined;
+
+/**
+ * `<usa-draggable>` — drag its content with the pointer (mouse, touch, pen)
+ * or the arrow keys; physics on release.
+ *
+ * Attributes: `axis` (`both` default, `x`, `y`), `spring-back` (return to
+ * the origin with a spring), `inertia` (keep gliding after a flick),
+ * `snap` (grid size like `80`, or points like `0,120,240`), `bounds`
+ * (`parent` = stay inside the parent box, rubber-banding past its edges),
+ * `preset` (spring, default `wobbly`), `step` (arrow-key step, px, 16),
+ * `disabled`. Methods: `moveTo(x, y, animate?)`, `reset()`. Events:
+ * `usa:drag-start`, `usa:drag-end` (`{ x, y, vx, vy }`), `usa:settle`.
+ * Reduced motion: positions change instantly (no spring or inertia).
+ */
+interface UsaDraggableElement extends UsaElement {
+    readonly x: number;
+    readonly y: number;
+    readonly dragging: boolean;
+    moveTo(x: number, y: number, animate?: boolean): void;
+    reset(): void;
+}
+declare function defineDraggable(tag?: string): CustomElementConstructor | undefined;
+
+/**
+ * `<usa-overscroll>` — an elastic scroll container: pulling past the top or
+ * bottom (touch, trackpad or wheel) stretches the content with iOS-style
+ * rubber-band resistance and it springs back on release.
+ *
+ * Attributes: `axis` (`y` default, `x`), `max` (largest stretch in px, 120),
+ * `preset` (spring, default `default`), `disabled`. CSS variable
+ * `--usa-overscroll` holds the current offset. Reduced motion: no stretch
+ * (a plain scroll container with `overscroll-behavior: contain`).
+ */
+interface UsaOverscrollElement extends UsaElement {
+    /** Current stretch in px (negative = pulled past the end). */
+    readonly offset: number;
+}
+declare function defineOverscroll(tag?: string): CustomElementConstructor | undefined;
+
+/**
+ * Spring physics core (v2.3). A damped harmonic oscillator integrated in
+ * 1 ms steps: `stiffness` (k, N/m), `damping` (c) and `mass` (m). Used by
+ * the `<usa-spring>`, `<usa-draggable>` and `<usa-overscroll>` elements and
+ * exported for your own animations:
+ *
+ * - `springEasing()` turns a spring into a CSS `linear()` easing + duration
+ *   for WAAPI / CSS (falls back to a cubic-bezier overshoot where `linear()`
+ *   is unsupported);
+ * - `spring(el, keyframes, cfg)` animates with it;
+ * - `createSpring()` is an interruptible, velocity-preserving value for
+ *   gestures (drag, inertia, snap).
+ */
+interface SpringConfig {
+    /** Spring stiffness (default 170). Higher = faster, snappier. */
+    stiffness?: number;
+    /** Damping / friction (default 26). Lower = more bounces. */
+    damping?: number;
+    /** Mass (default 1). Higher = slower, heavier. */
+    mass?: number;
+    /** Initial velocity in progress units per second (default 0). */
+    velocity?: number;
+    /** Rest threshold (default 0.001). */
+    precision?: number;
+}
+type SpringPreset = 'default' | 'gentle' | 'wobbly' | 'stiff' | 'bouncy' | 'slow' | 'molasses';
+declare const SPRING_PRESETS: Record<SpringPreset, Required<Pick<SpringConfig, 'stiffness' | 'damping' | 'mass'>>>;
+type SpringInput = SpringPreset | SpringConfig | string | undefined;
+/** Resolve a preset name or a partial config to a full config. */
+declare function resolveSpring(input?: SpringInput): Required<SpringConfig>;
+/** One integration step (semi-implicit Euler) towards `to`. Returns [x, v]. */
+declare function stepSpring(cfg: Required<SpringConfig>, x: number, v: number, to: number, dt: number): [number, number];
+/**
+ * Sample the spring from 0 to 1 at `fps` (default 60). `values` may exceed 1
+ * (overshoot); `duration` is the time to rest, in ms (max 10 s).
+ */
+declare function springSamples(input?: SpringInput, fps?: number): {
+    values: number[];
+    duration: number;
+};
+/** `true` when CSS `linear()` easing is supported. */
+declare function supportsLinearEasing(): boolean;
+/**
+ * The spring as `{ easing, duration }` for `el.animate()` / CSS. `easing` is
+ * a `linear(…)` function with at most `points` stops (default 48), or a
+ * cubic-bezier overshoot where `linear()` is unsupported.
+ */
+declare function springEasing(input?: SpringInput, points?: number): {
+    easing: string;
+    duration: number;
+};
+/** Build a CSS `linear()` easing from samples (down-sampled to `points`). */
+declare function linearEasing(values: number[], points?: number): string;
+/**
+ * Animate `el` between keyframes with spring timing (WAAPI). Under reduced
+ * motion the final frame is applied immediately. Returns the Animation (or
+ * `null` without WAAPI / under reduced motion).
+ */
+declare function spring(el: Element, keyframes: Keyframe[], input?: SpringInput, options?: KeyframeAnimationOptions): Animation | null;
+interface SpringValueOptions {
+    /** Start value (default 0). */
+    value?: number;
+    /** Spring config or preset (default `'default'`). */
+    spring?: SpringInput;
+    /** Called with the value every frame (and on `jump()`). */
+    onUpdate?: (value: number, velocity: number) => void;
+    /** Called when the value comes to rest at its target. */
+    onRest?: (value: number) => void;
+}
+interface SpringValue {
+    readonly value: number;
+    /** Units per second. */
+    readonly velocity: number;
+    readonly target: number;
+    readonly animating: boolean;
+    /** Animate to `target`, optionally with a new initial velocity (units/s). */
+    set(target: number, velocity?: number): void;
+    /** Jump to `value` with no animation. */
+    jump(value: number): void;
+    /** Stop where it is. */
+    stop(): void;
+    /** Change the spring config. */
+    configure(spring: SpringInput): void;
+}
+/**
+ * An interruptible spring-animated number: call `set()` as often as you like,
+ * the motion keeps its velocity (like iOS / Framer springs). Reduced motion
+ * jumps straight to the target.
+ */
+declare function createSpring(opts?: SpringValueOptions): SpringValue;
+/**
+ * Where a flick at `velocity` (units/s) comes to rest with exponential
+ * decay: `value + velocity · timeConstant` (default 0.325 s, iOS-like).
+ */
+declare function projectInertia(value: number, velocity: number, timeConstant?: number): number;
+/** Snap to a grid (`number`) or the nearest of a list of points. */
+declare function snapTo(value: number, to: number | number[] | null | undefined): number;
+/** iOS-style rubber-band resistance: how far content moves when pulled `distance` past an edge. */
+declare function rubberBand(distance: number, dimension: number, constant?: number): number;
+
+/**
+ * use-scroll-animate/components/physics — spring & bounce physics (v2.3).
+ * `<usa-spring>` (bounce-in, pop, drop, jelly, rubber-band), `<usa-draggable>`
+ * (spring-back, inertia, snap) and `<usa-overscroll>` (elastic edges), plus
+ * the spring core: `spring()`, `springEasing()`, `createSpring()`,
+ * `SPRING_PRESETS`, `projectInertia()`, `snapTo()`, `rubberBand()`.
+ */
+
+/** Register every component of this category under its default tag. */
+declare function definePhysicsComponents(): void;
+declare global {
+    interface HTMLElementTagNameMap {
+        'usa-spring': UsaSpringElement;
+        'usa-draggable': UsaDraggableElement;
+        'usa-overscroll': UsaOverscrollElement;
+    }
+}
+
+declare const CARD_EFFECTS: readonly ["flip", "holo", "glass", "border-glow", "conic-border", "lift", "spotlight", "sheen", "parallax-layers", "expand"];
+type CardEffect = (typeof CARD_EFFECTS)[number];
+/**
+ * `<usa-card>` — card effects, combinable: `effect="lift sheen"`.
+ *
+ * - `flip` — front/back (`[data-front]` / `[data-back]` children) flip on
+ *   hover or `trigger="click"`, `axis="y"` (default, horizontal flip) or `x`.
+ * - `holo` — holographic foil that shifts with the pointer.
+ * - `glass` — frosted glass surface (backdrop blur).
+ * - `border-glow` — a glow on the border that follows the pointer.
+ * - `conic-border` — a rotating conic-gradient border.
+ * - `lift` — rises with a deeper shadow and a slight pointer tilt.
+ * - `spotlight` — a soft light that follows the pointer.
+ * - `sheen` — a light sweep across the card on hover / focus.
+ * - `parallax-layers` — children with `data-depth="0.2…1"` move at different depths.
+ * - `expand` — click to grow into a full detail view (`[data-detail]`
+ *   content is shown), FLIP + spring; Esc, `[data-close]` or the backdrop closes.
+ *
+ * Attributes: `effect`, `axis`, `trigger`, `depth` (parallax px, 16),
+ * `color` (glow / spotlight colour), `flipped`, `expanded`, `disabled`.
+ * CSS variables: `--usa-card-x/-y` (pointer %, 0–100), `--usa-card-nx/-ny` (−1…1).
+ * Methods: `flip(force?)`, `expand()`, `collapse()`. Events: `usa:flip`,
+ * `usa:expand`, `usa:collapse`. Reduced motion: no tilt / parallax / sweep;
+ * flips and expansions cross-fade.
+ */
+interface UsaCardElement extends UsaElement {
+    readonly effects: string[];
+    flipped: boolean;
+    readonly expanded: boolean;
+    flip(force?: boolean): void;
+    expand(): Promise<void>;
+    collapse(): Promise<void>;
+}
+declare function defineCard(tag?: string): CustomElementConstructor | undefined;
+
+/**
+ * `<usa-card-stack>` — a deck of cards (its element children). The top card
+ * can be swiped away left or right (pointer, touch or arrow keys); the rest
+ * fan out behind it and move up with a spring.
+ *
+ * Attributes: `threshold` (px to dismiss, 90), `visible` (cards fanned
+ * behind, 3), `offset` (px between cards, 10), `loop` (swiped cards go back
+ * to the bottom), `disabled`. Methods: `swipe(direction)`, `top`. Events:
+ * `usa:swipe` (`{ direction: 'left' | 'right', card }`), `usa:empty`.
+ * Reduced motion: cards are removed instantly, no rotation.
+ */
+interface UsaCardStackElement extends UsaElement {
+    readonly top: HTMLElement | null;
+    swipe(direction: 'left' | 'right'): Promise<void>;
+}
+declare function defineCardStack(tag?: string): CustomElementConstructor | undefined;
+
+/**
+ * `<usa-sticky-stack>` — cards (element children) stick to the top while
+ * scrolling and the ones underneath scale down and dim as the next card
+ * slides over them, like a deck building up.
+ *
+ * Attributes: `top` (px from the viewport top, 80), `gap` (px each card
+ * peeks below the previous, 16), `scale` (how much a covered card shrinks,
+ * 0.06). Reduced motion: cards still stack (sticky) but do not scale.
+ */
+interface UsaStickyStackElement extends UsaElement {
+    update(): void;
+}
+declare function defineStickyStack(tag?: string): CustomElementConstructor | undefined;
+
+/**
+ * `<usa-carousel-3d>` — its element children on a 3D ring. Rotate with the
+ * arrow keys, a drag/swipe, the wheel (shift) or `next()` / `prev()`; the
+ * front item is `aria-current`. Spring-driven rotation.
+ *
+ * Attributes: `radius` (px, auto from item width), `autoplay` (ms between
+ * steps, pauses on hover/focus), `perspective` (px, 1200), `index`.
+ * Events: `usa:change` (`{ index }`). Reduced motion: a flat, instant
+ * switch (only the current item is shown, others dimmed).
+ */
+interface UsaCarousel3dElement extends UsaElement {
+    index: number;
+    next(): void;
+    prev(): void;
+    goTo(i: number): void;
+}
+declare function defineCarousel3d(tag?: string): CustomElementConstructor | undefined;
+
+/**
+ * use-scroll-animate/components/cards — card effects (v2.4).
+ * `<usa-card effect="flip | holo | glass | border-glow | conic-border | lift |
+ * spotlight | sheen | parallax-layers | expand">` (combinable),
+ * `<usa-card-stack>` (swipeable deck), `<usa-sticky-stack>` (stacking on
+ * scroll) and `<usa-carousel-3d>`.
+ */
+
+/** Register every component of this category under its default tag. */
+declare function defineCardComponents(): void;
+declare global {
+    interface HTMLElementTagNameMap {
+        'usa-card': UsaCardElement;
+        'usa-card-stack': UsaCardStackElement;
+        'usa-sticky-stack': UsaStickyStackElement;
+        'usa-carousel-3d': UsaCarousel3dElement;
+    }
+}
+
 /** The component categories and their default tags. */
 declare const COMPONENT_CATEGORIES: {
     readonly reveal: readonly ["usa-reveal", "usa-stagger", "usa-scroll-progress", "usa-scrolly"];
@@ -729,6 +1009,8 @@ declare const COMPONENT_CATEGORIES: {
     readonly feedback: readonly ["usa-spinner", "usa-skeleton", "usa-progress", "usa-toaster", "usa-check"];
     readonly background: readonly ["usa-aurora", "usa-particles", "usa-grain", "usa-marquee", "usa-acrylic"];
     readonly transitions: readonly ["usa-dialog", "usa-accordion", "usa-flip-list", "usa-view-switch"];
+    readonly physics: readonly ["usa-spring", "usa-draggable", "usa-overscroll"];
+    readonly cards: readonly ["usa-card", "usa-card-stack", "usa-sticky-stack", "usa-carousel-3d"];
 };
 type ComponentCategory = keyof typeof COMPONENT_CATEGORIES;
 /**
@@ -737,5 +1019,5 @@ type ComponentCategory = keyof typeof COMPONENT_CATEGORIES;
  */
 declare function defineComponents(categories?: ComponentCategory[]): void;
 
-export { COMPONENT_CATEGORIES, REVEAL_EFFECTS, SPINNER_VARIANTS, configureComponents, connectedAnimation, defineAccordion, defineAcrylic, defineAurora, defineBackgroundComponents, defineCheck, defineComponents, defineCounter, defineDialog, defineFeedbackComponents, defineFlipList, defineGrain, defineInteractionComponents, defineMagnetic, defineMarquee, defineParticles, definePress, defineProgress, defineReveal, defineRevealComponents, defineRipple, defineScramble, defineScrollProgress, defineScrolly, defineShimmerText, defineSkeleton, defineSpinner, defineSplitText, defineSpotlight, defineStagger, defineTextComponents, defineTextRotate, defineTilt, defineToaster, defineToggle, defineTransitionComponents, defineTypewriter, defineViewSwitch, easeOutExpo, flip, prefersReducedMotion, readScrollProgress, revealKeyframes, scrambleFrame, toast, viewTransition };
-export type { ComponentCategory, ComponentsConfig, ConnectedOptions, DialogVariant, FlipOptions, RevealEffect, SpinnerVariant, ToastHandle, ToastOptions, ToastType, UsaAccordionElement, UsaAcrylicElement, UsaAuroraElement, UsaCheckElement, UsaCounterElement, UsaDialogElement, UsaElement, UsaFlipListElement, UsaGrainElement, UsaMagneticElement, UsaMarqueeElement, UsaParticlesElement, UsaPressElement, UsaProgressElement, UsaRevealElement, UsaRippleElement, UsaScrambleElement, UsaScrollProgressElement, UsaScrollyElement, UsaShimmerTextElement, UsaSkeletonElement, UsaSpinnerElement, UsaSplitTextElement, UsaSpotlightElement, UsaStaggerElement, UsaTextRotateElement, UsaTiltElement, UsaToasterElement, UsaToggleElement, UsaTypewriterElement, UsaViewSwitchElement, ViewTransitionOptions };
+export { CARD_EFFECTS, COMPONENT_CATEGORIES, REVEAL_EFFECTS, SPINNER_VARIANTS, SPRING_EFFECTS, SPRING_PRESETS, configureComponents, connectedAnimation, createSpring, defineAccordion, defineAcrylic, defineAurora, defineBackgroundComponents, defineCard, defineCardComponents, defineCardStack, defineCarousel3d, defineCheck, defineComponents, defineCounter, defineDialog, defineDraggable, defineFeedbackComponents, defineFlipList, defineGrain, defineInteractionComponents, defineMagnetic, defineMarquee, defineOverscroll, defineParticles, definePhysicsComponents, definePress, defineProgress, defineReveal, defineRevealComponents, defineRipple, defineScramble, defineScrollProgress, defineScrolly, defineShimmerText, defineSkeleton, defineSpinner, defineSplitText, defineSpotlight, defineSpring, defineStagger, defineStickyStack, defineTextComponents, defineTextRotate, defineTilt, defineToaster, defineToggle, defineTransitionComponents, defineTypewriter, defineViewSwitch, easeOutExpo, flip, linearEasing, prefersReducedMotion, projectInertia, readScrollProgress, resolveSpring, revealKeyframes, rubberBand, scrambleFrame, snapTo, spring, springEasing, springEffectKeyframes, springSamples, stepSpring, supportsLinearEasing, toast, viewTransition };
+export type { CardEffect, ComponentCategory, ComponentsConfig, ConnectedOptions, DialogVariant, FlipOptions, RevealEffect, SpinnerVariant, SpringConfig, SpringEffect, SpringInput, SpringPreset, SpringValue, SpringValueOptions, ToastHandle, ToastOptions, ToastType, UsaAccordionElement, UsaAcrylicElement, UsaAuroraElement, UsaCardElement, UsaCardStackElement, UsaCarousel3dElement, UsaCheckElement, UsaCounterElement, UsaDialogElement, UsaDraggableElement, UsaElement, UsaFlipListElement, UsaGrainElement, UsaMagneticElement, UsaMarqueeElement, UsaOverscrollElement, UsaParticlesElement, UsaPressElement, UsaProgressElement, UsaRevealElement, UsaRippleElement, UsaScrambleElement, UsaScrollProgressElement, UsaScrollyElement, UsaShimmerTextElement, UsaSkeletonElement, UsaSpinnerElement, UsaSplitTextElement, UsaSpotlightElement, UsaSpringElement, UsaStaggerElement, UsaStickyStackElement, UsaTextRotateElement, UsaTiltElement, UsaToasterElement, UsaToggleElement, UsaTypewriterElement, UsaViewSwitchElement, ViewTransitionOptions };

package/dist/components.js

@@ -10,7 +10,12 @@ import { defineBackgroundComponents } from './components/background.js';
 export { defineAcrylic, defineAurora, defineGrain, defineMarquee, defineParticles } from './components/background.js';
 import { defineTransitionComponents } from './components/transitions.js';
 export { connectedAnimation, defineAccordion, defineDialog, defineFlipList, defineViewSwitch, flip, viewTransition } from './components/transitions.js';
-export { c as configureComponents, p as prefersReducedMotion } from './chunks/base-CFtnmfli.js';
+import { definePhysicsComponents } from './components/physics.js';
+export { SPRING_EFFECTS, defineDraggable, defineOverscroll, defineSpring, springEffectKeyframes } from './components/physics.js';
+import { defineCardComponents } from './components/cards.js';
+export { CARD_EFFECTS, defineCard, defineCardStack, defineCarousel3d, defineStickyStack } from './components/cards.js';
+export { S as SPRING_PRESETS, c as createSpring, l as linearEasing, p as projectInertia, r as resolveSpring, a as rubberBand, s as snapTo, b as spring, d as springEasing, e as springSamples, f as stepSpring, g as supportsLinearEasing } from './chunks/spring-BKUU7-Xm.js';
+export { c as configureComponents, p as prefersReducedMotion } from './chunks/base-CuvCgqLy.js';
 
 /**
  * use-scroll-animate/components
@@ -40,6 +45,8 @@ const COMPONENT_CATEGORIES = {
     feedback: ['usa-spinner', 'usa-skeleton', 'usa-progress', 'usa-toaster', 'usa-check'],
     background: ['usa-aurora', 'usa-particles', 'usa-grain', 'usa-marquee', 'usa-acrylic'],
     transitions: ['usa-dialog', 'usa-accordion', 'usa-flip-list', 'usa-view-switch'],
+    physics: ['usa-spring', 'usa-draggable', 'usa-overscroll'],
+    cards: ['usa-card', 'usa-card-stack', 'usa-sticky-stack', 'usa-carousel-3d'],
 };
 const BY_CATEGORY = {
     reveal: defineRevealComponents,
@@ -48,6 +55,8 @@ const BY_CATEGORY = {
     feedback: defineFeedbackComponents,
     background: defineBackgroundComponents,
     transitions: defineTransitionComponents,
+    physics: definePhysicsComponents,
+    cards: defineCardComponents,
 };
 /**
  * Register every `<usa-*>` component (or only the given categories).
@@ -57,5 +66,5 @@ function defineComponents(categories) {
     (categories || Object.keys(BY_CATEGORY)).forEach((c) => BY_CATEGORY[c]?.());
 }
 
-export { COMPONENT_CATEGORIES, defineBackgroundComponents, defineComponents, defineFeedbackComponents, defineInteractionComponents, defineRevealComponents, defineTextComponents, defineTransitionComponents };
+export { COMPONENT_CATEGORIES, defineBackgroundComponents, defineCardComponents, defineComponents, defineFeedbackComponents, defineInteractionComponents, definePhysicsComponents, defineRevealComponents, defineTextComponents, defineTransitionComponents };
 //# sourceMappingURL=components.js.map

package/dist/components.js.map

@@ -1 +1 @@
-{"version":3,"file":"components.js","sources":["../src/components/index.ts"],"sourcesContent":["/**\n * use-scroll-animate/components\n *\n * Framework-agnostic, dependency-free animated UI components built on\n * Custom Elements + CSS + the Web Animations API. They run in any browser\n * and in Windows desktop apps that render with a web view: Electron, Tauri\n * (WebView2), WinUI 3 / WPF / WinForms with WebView2, and installed PWAs.\n *\n * ```js\n * import { defineComponents } from 'use-scroll-animate/components';\n * defineComponents(); // registers every <usa-*> element\n * // or only what you use (tree-shakable):\n * import { defineTypewriter } from 'use-scroll-animate/components/text';\n * ```\n *\n * Importing has no side effects and is SSR-safe; nothing is registered\n * until a `define*()` function runs in a browser.\n *\n * @license MIT\n */\nimport { defineRevealComponents } from './reveal/index';\nimport { defineTextComponents } from './text/index';\nimport { defineInteractionComponents } from './interaction/index';\nimport { defineFeedbackComponents } from './feedback/index';\nimport { defineBackgroundComponents } from './background/index';\nimport { defineTransitionComponents } from './transitions/index';\n\nexport * from './reveal/index';\nexport * from './text/index';\nexport * from './interaction/index';\nexport * from './feedback/index';\nexport * from './background/index';\nexport * from './transitions/index';\n\n/** The component categories and their default tags. */\nexport const COMPONENT_CATEGORIES = {\n  reveal: ['usa-reveal', 'usa-stagger', 'usa-scroll-progress', 'usa-scrolly'],\n  text: ['usa-typewriter', 'usa-split-text', 'usa-scramble', 'usa-counter', 'usa-shimmer-text', 'usa-text-rotate'],\n  interaction: ['usa-ripple', 'usa-magnetic', 'usa-tilt', 'usa-spotlight', 'usa-press', 'usa-toggle'],\n  feedback: ['usa-spinner', 'usa-skeleton', 'usa-progress', 'usa-toaster', 'usa-check'],\n  background: ['usa-aurora', 'usa-particles', 'usa-grain', 'usa-marquee', 'usa-acrylic'],\n  transitions: ['usa-dialog', 'usa-accordion', 'usa-flip-list', 'usa-view-switch'],\n} as const;\n\nexport type ComponentCategory = keyof typeof COMPONENT_CATEGORIES;\n\nconst BY_CATEGORY: Record<ComponentCategory, () => void> = {\n  reveal: defineRevealComponents,\n  text: defineTextComponents,\n  interaction: defineInteractionComponents,\n  feedback: defineFeedbackComponents,\n  background: defineBackgroundComponents,\n  transitions: defineTransitionComponents,\n};\n\n/**\n * Register every `<usa-*>` component (or only the given categories).\n * Safe to call more than once and on the server (no-op without DOM).\n */\nexport function defineComponents(categories?: ComponentCategory[]): void {\n  (categories || (Object.keys(BY_CATEGORY) as ComponentCategory[])).forEach((c) => BY_CATEGORY[c]?.());\n}\n"],"names":[],"mappings":";;;;;;;;;;;;;;AAAA;;;;;;;;;;;;;;;;;;;AAmBG;AAeH;AACO,MAAM,oBAAoB,GAAG;IAClC,MAAM,EAAE,CAAC,YAAY,EAAE,aAAa,EAAE,qBAAqB,EAAE,aAAa,CAAC;AAC3E,IAAA,IAAI,EAAE,CAAC,gBAAgB,EAAE,gBAAgB,EAAE,cAAc,EAAE,aAAa,EAAE,kBAAkB,EAAE,iBAAiB,CAAC;AAChH,IAAA,WAAW,EAAE,CAAC,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,eAAe,EAAE,WAAW,EAAE,YAAY,CAAC;IACnG,QAAQ,EAAE,CAAC,aAAa,EAAE,cAAc,EAAE,cAAc,EAAE,aAAa,EAAE,WAAW,CAAC;IACrF,UAAU,EAAE,CAAC,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,aAAa,EAAE,aAAa,CAAC;IACtF,WAAW,EAAE,CAAC,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,iBAAiB,CAAC;;AAKlF,MAAM,WAAW,GAA0C;AACzD,IAAA,MAAM,EAAE,sBAAsB;AAC9B,IAAA,IAAI,EAAE,oBAAoB;AAC1B,IAAA,WAAW,EAAE,2BAA2B;AACxC,IAAA,QAAQ,EAAE,wBAAwB;AAClC,IAAA,UAAU,EAAE,0BAA0B;AACtC,IAAA,WAAW,EAAE,0BAA0B;CACxC;AAED;;;AAGG;AACG,SAAU,gBAAgB,CAAC,UAAgC,EAAA;IAC/D,CAAC,UAAU,IAAK,MAAM,CAAC,IAAI,CAAC,WAAW,CAAyB,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC;AACtG;;;;"}
+{"version":3,"file":"components.js","sources":["../src/components/index.ts"],"sourcesContent":["/**\n * use-scroll-animate/components\n *\n * Framework-agnostic, dependency-free animated UI components built on\n * Custom Elements + CSS + the Web Animations API. They run in any browser\n * and in Windows desktop apps that render with a web view: Electron, Tauri\n * (WebView2), WinUI 3 / WPF / WinForms with WebView2, and installed PWAs.\n *\n * ```js\n * import { defineComponents } from 'use-scroll-animate/components';\n * defineComponents(); // registers every <usa-*> element\n * // or only what you use (tree-shakable):\n * import { defineTypewriter } from 'use-scroll-animate/components/text';\n * ```\n *\n * Importing has no side effects and is SSR-safe; nothing is registered\n * until a `define*()` function runs in a browser.\n *\n * @license MIT\n */\nimport { defineRevealComponents } from './reveal/index';\nimport { defineTextComponents } from './text/index';\nimport { defineInteractionComponents } from './interaction/index';\nimport { defineFeedbackComponents } from './feedback/index';\nimport { defineBackgroundComponents } from './background/index';\nimport { defineTransitionComponents } from './transitions/index';\nimport { definePhysicsComponents } from './physics/index';\nimport { defineCardComponents } from './cards/index';\n\nexport * from './reveal/index';\nexport * from './text/index';\nexport * from './interaction/index';\nexport * from './feedback/index';\nexport * from './background/index';\nexport * from './transitions/index';\nexport * from './physics/index';\nexport * from './cards/index';\n\n/** The component categories and their default tags. */\nexport const COMPONENT_CATEGORIES = {\n  reveal: ['usa-reveal', 'usa-stagger', 'usa-scroll-progress', 'usa-scrolly'],\n  text: ['usa-typewriter', 'usa-split-text', 'usa-scramble', 'usa-counter', 'usa-shimmer-text', 'usa-text-rotate'],\n  interaction: ['usa-ripple', 'usa-magnetic', 'usa-tilt', 'usa-spotlight', 'usa-press', 'usa-toggle'],\n  feedback: ['usa-spinner', 'usa-skeleton', 'usa-progress', 'usa-toaster', 'usa-check'],\n  background: ['usa-aurora', 'usa-particles', 'usa-grain', 'usa-marquee', 'usa-acrylic'],\n  transitions: ['usa-dialog', 'usa-accordion', 'usa-flip-list', 'usa-view-switch'],\n  physics: ['usa-spring', 'usa-draggable', 'usa-overscroll'],\n  cards: ['usa-card', 'usa-card-stack', 'usa-sticky-stack', 'usa-carousel-3d'],\n} as const;\n\nexport type ComponentCategory = keyof typeof COMPONENT_CATEGORIES;\n\nconst BY_CATEGORY: Record<ComponentCategory, () => void> = {\n  reveal: defineRevealComponents,\n  text: defineTextComponents,\n  interaction: defineInteractionComponents,\n  feedback: defineFeedbackComponents,\n  background: defineBackgroundComponents,\n  transitions: defineTransitionComponents,\n  physics: definePhysicsComponents,\n  cards: defineCardComponents,\n};\n\n/**\n * Register every `<usa-*>` component (or only the given categories).\n * Safe to call more than once and on the server (no-op without DOM).\n */\nexport function defineComponents(categories?: ComponentCategory[]): void {\n  (categories || (Object.keys(BY_CATEGORY) as ComponentCategory[])).forEach((c) => BY_CATEGORY[c]?.());\n}\n"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;AAAA;;;;;;;;;;;;;;;;;;;AAmBG;AAmBH;AACO,MAAM,oBAAoB,GAAG;IAClC,MAAM,EAAE,CAAC,YAAY,EAAE,aAAa,EAAE,qBAAqB,EAAE,aAAa,CAAC;AAC3E,IAAA,IAAI,EAAE,CAAC,gBAAgB,EAAE,gBAAgB,EAAE,cAAc,EAAE,aAAa,EAAE,kBAAkB,EAAE,iBAAiB,CAAC;AAChH,IAAA,WAAW,EAAE,CAAC,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,eAAe,EAAE,WAAW,EAAE,YAAY,CAAC;IACnG,QAAQ,EAAE,CAAC,aAAa,EAAE,cAAc,EAAE,cAAc,EAAE,aAAa,EAAE,WAAW,CAAC;IACrF,UAAU,EAAE,CAAC,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,aAAa,EAAE,aAAa,CAAC;IACtF,WAAW,EAAE,CAAC,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,iBAAiB,CAAC;AAChF,IAAA,OAAO,EAAE,CAAC,YAAY,EAAE,eAAe,EAAE,gBAAgB,CAAC;IAC1D,KAAK,EAAE,CAAC,UAAU,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,iBAAiB,CAAC;;AAK9E,MAAM,WAAW,GAA0C;AACzD,IAAA,MAAM,EAAE,sBAAsB;AAC9B,IAAA,IAAI,EAAE,oBAAoB;AAC1B,IAAA,WAAW,EAAE,2BAA2B;AACxC,IAAA,QAAQ,EAAE,wBAAwB;AAClC,IAAA,UAAU,EAAE,0BAA0B;AACtC,IAAA,WAAW,EAAE,0BAA0B;AACvC,IAAA,OAAO,EAAE,uBAAuB;AAChC,IAAA,KAAK,EAAE,oBAAoB;CAC5B;AAED;;;AAGG;AACG,SAAU,gBAAgB,CAAC,UAAgC,EAAA;IAC/D,CAAC,UAAU,IAAK,MAAM,CAAC,IAAI,CAAC,WAAW,CAAyB,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC;AACtG;;;;"}