use-scroll-animate 2.7.0 → 2.9.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +34 -0
- package/README.md +4 -4
- package/README_ja.md +2 -2
- package/README_zh.md +3 -3
- package/dist/chunks/{base-BR6fYLBA.cjs → base-BkQcvoSG.cjs} +29 -1
- package/dist/chunks/{base-BR6fYLBA.cjs.map → base-BkQcvoSG.cjs.map} +1 -1
- package/dist/chunks/{base-D6zLiNGH.js → base-CB8gChoe.js} +29 -2
- package/dist/chunks/{base-D6zLiNGH.js.map → base-CB8gChoe.js.map} +1 -1
- package/dist/chunks/{core-B_J4rXbC.cjs → core-C1cEwjJj.cjs} +11 -2
- package/dist/chunks/core-C1cEwjJj.cjs.map +1 -0
- package/dist/chunks/{core-BP-a1iNc.js → core-J_KM443q.js} +12 -3
- package/dist/chunks/core-J_KM443q.js.map +1 -0
- package/dist/chunks/index-tags-BEM98giN.cjs +20 -0
- package/dist/chunks/index-tags-BEM98giN.cjs.map +1 -0
- package/dist/chunks/index-tags-f37txHmb.js +18 -0
- package/dist/chunks/index-tags-f37txHmb.js.map +1 -0
- package/dist/chunks/{spring-DyHe1Hfa.cjs → spring-7U9MC6yQ.cjs} +2 -2
- package/dist/chunks/{spring-DyHe1Hfa.cjs.map → spring-7U9MC6yQ.cjs.map} +1 -1
- package/dist/chunks/{spring-C2Megtcf.js → spring-ka0YJ_ZR.js} +2 -2
- package/dist/chunks/{spring-C2Megtcf.js.map → spring-ka0YJ_ZR.js.map} +1 -1
- package/dist/chunks/{stagger-DTv_WiUQ.js → stagger-CGF18oNs.js} +2 -2
- package/dist/chunks/{stagger-DTv_WiUQ.js.map → stagger-CGF18oNs.js.map} +1 -1
- package/dist/chunks/{stagger-DHw0ExuR.cjs → stagger-DtKKS6GP.cjs} +2 -2
- package/dist/chunks/{stagger-DHw0ExuR.cjs.map → stagger-DtKKS6GP.cjs.map} +1 -1
- package/dist/chunks/variants-Ce9CboVc.js +35 -0
- package/dist/chunks/variants-Ce9CboVc.js.map +1 -0
- package/dist/chunks/variants-PsCXbQ5h.cjs +39 -0
- package/dist/chunks/variants-PsCXbQ5h.cjs.map +1 -0
- package/dist/components/background.cjs +277 -11
- package/dist/components/background.cjs.map +1 -1
- package/dist/components/background.css +3 -1
- package/dist/components/background.d.cts +64 -3
- package/dist/components/background.d.ts +64 -3
- package/dist/components/background.js +274 -13
- package/dist/components/background.js.map +1 -1
- package/dist/components/cards.cjs +2 -2
- package/dist/components/cards.js +3 -3
- package/dist/components/click.cjs +2 -2
- package/dist/components/click.js +3 -3
- package/dist/components/feedback.cjs +15 -8
- package/dist/components/feedback.cjs.map +1 -1
- package/dist/components/feedback.d.cts +4 -1
- package/dist/components/feedback.d.ts +4 -1
- package/dist/components/feedback.js +16 -9
- package/dist/components/feedback.js.map +1 -1
- package/dist/components/interaction.cjs +1 -1
- package/dist/components/interaction.js +2 -2
- package/dist/components/jsx.cjs +3 -0
- package/dist/components/jsx.cjs.map +1 -0
- package/dist/components/jsx.d.cts +45 -0
- package/dist/components/jsx.d.ts +45 -0
- package/dist/components/jsx.js +2 -0
- package/dist/components/jsx.js.map +1 -0
- package/dist/components/lazy.cjs +84 -0
- package/dist/components/lazy.cjs.map +1 -0
- package/dist/components/lazy.d.cts +40 -0
- package/dist/components/lazy.d.ts +40 -0
- package/dist/components/lazy.js +79 -0
- package/dist/components/lazy.js.map +1 -0
- package/dist/components/page.cjs +2 -2
- package/dist/components/page.js +3 -3
- package/dist/components/physics.cjs +2 -2
- package/dist/components/physics.js +4 -4
- package/dist/components/react.cjs +96 -0
- package/dist/components/react.cjs.map +1 -0
- package/dist/components/react.d.cts +18 -0
- package/dist/components/react.d.ts +18 -0
- package/dist/components/react.js +91 -0
- package/dist/components/react.js.map +1 -0
- package/dist/components/reveal.cjs +1 -1
- package/dist/components/reveal.js +2 -2
- package/dist/components/text.cjs +180 -11
- package/dist/components/text.cjs.map +1 -1
- package/dist/components/text.css +1 -0
- package/dist/components/text.d.cts +54 -2
- package/dist/components/text.d.ts +54 -2
- package/dist/components/text.js +177 -13
- package/dist/components/text.js.map +1 -1
- package/dist/components/transitions.cjs +3 -4
- package/dist/components/transitions.cjs.map +1 -1
- package/dist/components/transitions.js +4 -5
- package/dist/components/transitions.js.map +1 -1
- package/dist/components/ui.cjs +18 -48
- package/dist/components/ui.cjs.map +1 -1
- package/dist/components/ui.js +6 -35
- package/dist/components/ui.js.map +1 -1
- package/dist/components/vue.cjs +51 -0
- package/dist/components/vue.cjs.map +1 -0
- package/dist/components/vue.d.cts +1344 -0
- package/dist/components/vue.d.ts +1344 -0
- package/dist/components/vue.js +48 -0
- package/dist/components/vue.js.map +1 -0
- package/dist/components.cjs +19 -21
- package/dist/components.cjs.map +1 -1
- package/dist/components.css +4 -1
- package/dist/components.d.cts +123 -6
- package/dist/components.d.ts +123 -6
- package/dist/components.js +11 -22
- package/dist/components.js.map +1 -1
- package/dist/components.umd.js +2 -2
- package/dist/components.umd.js.map +1 -1
- package/dist/element.cjs +1 -1
- package/dist/element.js +1 -1
- package/dist/element.umd.js +1 -1
- package/dist/element.umd.js.map +1 -1
- package/dist/index.cjs +2 -2
- package/dist/index.js +3 -3
- package/dist/index.umd.js +2 -2
- package/dist/index.umd.js.map +1 -1
- package/dist/react.cjs +2 -2
- package/dist/react.js +2 -2
- package/dist/solid.cjs +2 -2
- package/dist/solid.js +2 -2
- package/dist/svelte.cjs +2 -2
- package/dist/svelte.js +2 -2
- package/dist/vue.cjs +2 -2
- package/dist/vue.js +2 -2
- package/docs/accessibility.md +32 -0
- package/docs/components.md +45 -6
- package/docs/frameworks-ssr.md +64 -0
- package/docs/upgrading-3.md +20 -0
- package/docs/windows-apps.md +13 -2
- package/package.json +42 -1
- package/dist/chunks/core-BP-a1iNc.js.map +0 -1
- package/dist/chunks/core-B_J4rXbC.cjs.map +0 -1
package/dist/components.d.ts
CHANGED
|
@@ -245,6 +245,53 @@ interface UsaTextRotateElement extends UsaElement {
|
|
|
245
245
|
}
|
|
246
246
|
declare function defineTextRotate(tag?: string): CustomElementConstructor | undefined;
|
|
247
247
|
|
|
248
|
+
/**
|
|
249
|
+
* `<usa-wave-text>` — letters bob in a travelling wave.
|
|
250
|
+
* Attributes: `amplitude` (em, 0.25), `speed` (s per cycle, 1.6), `stagger`
|
|
251
|
+
* (s between letters, 0.06). Reduced motion: still text.
|
|
252
|
+
*/
|
|
253
|
+
interface UsaWaveTextElement extends UsaElement {
|
|
254
|
+
}
|
|
255
|
+
declare function defineWaveText(tag?: string): CustomElementConstructor | undefined;
|
|
256
|
+
/**
|
|
257
|
+
* `<usa-glitch>` — an RGB-split glitch on its text (`trigger="always"`
|
|
258
|
+
* default, or `hover`). Attributes: `intensity` (px, 3), `trigger`.
|
|
259
|
+
* Reduced motion: no animation (plain text).
|
|
260
|
+
*/
|
|
261
|
+
interface UsaGlitchElement extends UsaElement {
|
|
262
|
+
}
|
|
263
|
+
declare function defineGlitch(tag?: string): CustomElementConstructor | undefined;
|
|
264
|
+
/**
|
|
265
|
+
* `<usa-gradient-text>` — text filled with a flowing multi-colour gradient.
|
|
266
|
+
* Attributes: `colors` (comma list), `speed` (s, 6), `angle` (deg, 90).
|
|
267
|
+
* Reduced motion: a static gradient.
|
|
268
|
+
*/
|
|
269
|
+
interface UsaGradientTextElement extends UsaElement {
|
|
270
|
+
}
|
|
271
|
+
declare function defineGradientText(tag?: string): CustomElementConstructor | undefined;
|
|
272
|
+
/**
|
|
273
|
+
* `<usa-handwriting>` — the text draws itself stroke by stroke (SVG text
|
|
274
|
+
* outline), then fills in, when it scrolls into view.
|
|
275
|
+
* Attributes: `text`, `duration` (ms, 2400), `stroke` (colour), `size` (px,
|
|
276
|
+
* 64), `font` (family; a script font looks best). Events: `usa:complete`.
|
|
277
|
+
* Reduced motion: the filled text appears at once.
|
|
278
|
+
*/
|
|
279
|
+
interface UsaHandwritingElement extends UsaElement {
|
|
280
|
+
play(): void;
|
|
281
|
+
}
|
|
282
|
+
declare function defineHandwriting(tag?: string): CustomElementConstructor | undefined;
|
|
283
|
+
/**
|
|
284
|
+
* `<usa-scroll-highlight>` — reading highlight: words light up one by one
|
|
285
|
+
* as the paragraph scrolls through the viewport (`mode="words"`, default),
|
|
286
|
+
* or a highlighter marker sweeps behind the text on enter (`mode="marker"`).
|
|
287
|
+
* Attributes: `mode`, `color` (marker), `dim` (opacity of unread words,
|
|
288
|
+
* 0.2). Reduced motion: fully highlighted text.
|
|
289
|
+
*/
|
|
290
|
+
interface UsaScrollHighlightElement extends UsaElement {
|
|
291
|
+
readonly progress: number;
|
|
292
|
+
}
|
|
293
|
+
declare function defineScrollHighlight(tag?: string): CustomElementConstructor | undefined;
|
|
294
|
+
|
|
248
295
|
/**
|
|
249
296
|
* use-scroll-animate/components/text — text effects.
|
|
250
297
|
* `<usa-typewriter>`, `<usa-split-text>`, `<usa-scramble>`, `<usa-counter>`,
|
|
@@ -255,6 +302,11 @@ declare function defineTextRotate(tag?: string): CustomElementConstructor | unde
|
|
|
255
302
|
declare function defineTextComponents(): void;
|
|
256
303
|
declare global {
|
|
257
304
|
interface HTMLElementTagNameMap {
|
|
305
|
+
'usa-wave-text': UsaWaveTextElement;
|
|
306
|
+
'usa-glitch': UsaGlitchElement;
|
|
307
|
+
'usa-gradient-text': UsaGradientTextElement;
|
|
308
|
+
'usa-handwriting': UsaHandwritingElement;
|
|
309
|
+
'usa-scroll-highlight': UsaScrollHighlightElement;
|
|
258
310
|
'usa-typewriter': UsaTypewriterElement;
|
|
259
311
|
'usa-split-text': UsaSplitTextElement;
|
|
260
312
|
'usa-scramble': UsaScrambleElement;
|
|
@@ -373,7 +425,7 @@ type SpinnerVariant = (typeof SPINNER_VARIANTS)[number];
|
|
|
373
425
|
* `<usa-spinner>` — indeterminate loading indicators, pure CSS animations
|
|
374
426
|
* of `transform` / `opacity` (plus an SVG stroke for `fluent`).
|
|
375
427
|
*
|
|
376
|
-
*
|
|
428
|
+
* Kinds (`kind`; `variant` is a deprecated alias until 3.0): `fluent` (default — the WinUI / Windows 11
|
|
377
429
|
* ProgressRing arc), `windows` (the Windows 10 boot "orbiting dots"),
|
|
378
430
|
* `ring` (classic border spinner), `dots` (three bouncing dots / typing
|
|
379
431
|
* indicator), `pulse` (expanding ripple), `bars` (equalizer).
|
|
@@ -383,6 +435,9 @@ type SpinnerVariant = (typeof SPINNER_VARIANTS)[number];
|
|
|
383
435
|
* a slow opacity pulse instead of movement.
|
|
384
436
|
*/
|
|
385
437
|
interface UsaSpinnerElement extends UsaElement {
|
|
438
|
+
/** Spinner kind (`kind` attribute). */
|
|
439
|
+
kind: SpinnerVariant;
|
|
440
|
+
/** @deprecated alias of `kind`, removed in 3.0. */
|
|
386
441
|
variant: SpinnerVariant;
|
|
387
442
|
}
|
|
388
443
|
declare function defineSpinner(tag?: string): CustomElementConstructor | undefined;
|
|
@@ -564,7 +619,7 @@ declare function defineMarquee(tag?: string): CustomElementConstructor | undefin
|
|
|
564
619
|
* tints from `--usa-mica-source`, a gradient you control). Optional
|
|
565
620
|
* `shimmer` adds a light sweep when it appears or on hover.
|
|
566
621
|
*
|
|
567
|
-
* Attributes: `
|
|
622
|
+
* Attributes: `kind` (`acrylic` default | `mica`; `variant` is a deprecated alias until 3.0), `tint` (colour),
|
|
568
623
|
* `tint-opacity` (0–1, 0.55), `blur` (px, 30), `shimmer`
|
|
569
624
|
* (`hover` | `load` | `none`, default `none`). Falls back to a solid tint
|
|
570
625
|
* without `backdrop-filter` and under `prefers-reduced-transparency` or
|
|
@@ -573,6 +628,63 @@ declare function defineMarquee(tag?: string): CustomElementConstructor | undefin
|
|
|
573
628
|
type UsaAcrylicElement = UsaElement;
|
|
574
629
|
declare function defineAcrylic(tag?: string): CustomElementConstructor | undefined;
|
|
575
630
|
|
|
631
|
+
/**
|
|
632
|
+
* `<usa-grid-glow>` — a line grid behind its content that lights up around
|
|
633
|
+
* the pointer. Attributes: `size` (cell px, 32), `color`, `radius` (px, 220).
|
|
634
|
+
* Reduced motion: the grid stays, a soft static glow in the centre.
|
|
635
|
+
*/
|
|
636
|
+
interface UsaGridGlowElement extends UsaElement {
|
|
637
|
+
}
|
|
638
|
+
declare function defineGridGlow(tag?: string): CustomElementConstructor | undefined;
|
|
639
|
+
/**
|
|
640
|
+
* `<usa-blobs>` — soft, slowly morphing colour blobs (fluid gradient
|
|
641
|
+
* backdrop). Attributes: `colors` (comma list), `speed` (1), `blur` (px, 60).
|
|
642
|
+
* Reduced motion: still blobs.
|
|
643
|
+
*/
|
|
644
|
+
interface UsaBlobsElement extends UsaElement {
|
|
645
|
+
}
|
|
646
|
+
declare function defineBlobs(tag?: string): CustomElementConstructor | undefined;
|
|
647
|
+
/**
|
|
648
|
+
* `<usa-water-ripple>` — interactive water ripples on a canvas over its
|
|
649
|
+
* content (pointer moves and taps disturb the surface). Low-resolution height
|
|
650
|
+
* map, paused off-screen. Attributes: `damping` (0.96), `strength` (1),
|
|
651
|
+
* `color` (highlight). Reduced motion: nothing is drawn.
|
|
652
|
+
*/
|
|
653
|
+
interface UsaWaterRippleElement extends UsaElement {
|
|
654
|
+
drop(x: number, y: number, strength?: number): void;
|
|
655
|
+
}
|
|
656
|
+
declare function defineWaterRipple(tag?: string): CustomElementConstructor | undefined;
|
|
657
|
+
/**
|
|
658
|
+
* `<usa-dot-network>` — a grid of dots that swell and link up with lines
|
|
659
|
+
* around the pointer (a living network backdrop). Attributes: `gap` (px,
|
|
660
|
+
* 28), `color`, `radius` (px of influence, 140). Reduced motion: a static
|
|
661
|
+
* dot grid.
|
|
662
|
+
*/
|
|
663
|
+
interface UsaDotNetworkElement extends UsaElement {
|
|
664
|
+
}
|
|
665
|
+
declare function defineDotNetwork(tag?: string): CustomElementConstructor | undefined;
|
|
666
|
+
|
|
667
|
+
interface FluentPresetOptions {
|
|
668
|
+
/** Root to apply to (default `document.documentElement`). */
|
|
669
|
+
root?: HTMLElement;
|
|
670
|
+
/** Reveal highlight on interactive elements (default `true`). */
|
|
671
|
+
reveal?: boolean;
|
|
672
|
+
/** Reveal targets (default buttons, links, `[data-fluent-reveal]`). */
|
|
673
|
+
selector?: string;
|
|
674
|
+
/** Mica-style tinted window background on `<body>` (default `true`). */
|
|
675
|
+
mica?: boolean;
|
|
676
|
+
}
|
|
677
|
+
/**
|
|
678
|
+
* Windows 11 **Fluent preset** (v2.8): applies the `fluent` variant
|
|
679
|
+
* (Segoe UI Variable, Windows accent, 8 px radii), a Mica-style tinted
|
|
680
|
+
* window background, Acrylic on `.usa-acrylic` / `[data-acrylic]`, and
|
|
681
|
+
* Reveal highlight (a light following the pointer on borders and
|
|
682
|
+
* backgrounds of interactive elements). Ideal for WebView2 / Electron /
|
|
683
|
+
* Tauri apps on Windows. Returns a function that removes it.
|
|
684
|
+
* Respects reduced motion / transparency (no Reveal tracking; solid materials).
|
|
685
|
+
*/
|
|
686
|
+
declare function fluentPreset(options?: FluentPresetOptions): () => void;
|
|
687
|
+
|
|
576
688
|
/**
|
|
577
689
|
* use-scroll-animate/components/background — backgrounds & decoration.
|
|
578
690
|
* `<usa-aurora>`, `<usa-particles>`, `<usa-grain>`, `<usa-marquee>`,
|
|
@@ -583,6 +695,10 @@ declare function defineAcrylic(tag?: string): CustomElementConstructor | undefin
|
|
|
583
695
|
declare function defineBackgroundComponents(): void;
|
|
584
696
|
declare global {
|
|
585
697
|
interface HTMLElementTagNameMap {
|
|
698
|
+
'usa-grid-glow': UsaGridGlowElement;
|
|
699
|
+
'usa-blobs': UsaBlobsElement;
|
|
700
|
+
'usa-water-ripple': UsaWaterRippleElement;
|
|
701
|
+
'usa-dot-network': UsaDotNetworkElement;
|
|
586
702
|
'usa-aurora': UsaAuroraElement;
|
|
587
703
|
'usa-particles': UsaParticlesElement;
|
|
588
704
|
'usa-grain': UsaGrainElement;
|
|
@@ -1663,10 +1779,10 @@ declare global {
|
|
|
1663
1779
|
/** The component categories and their default tags. */
|
|
1664
1780
|
declare const COMPONENT_CATEGORIES: {
|
|
1665
1781
|
readonly reveal: readonly ["usa-reveal", "usa-stagger", "usa-scroll-progress", "usa-scrolly"];
|
|
1666
|
-
readonly text: readonly ["usa-typewriter", "usa-split-text", "usa-scramble", "usa-counter", "usa-shimmer-text", "usa-text-rotate"];
|
|
1782
|
+
readonly text: readonly ["usa-typewriter", "usa-split-text", "usa-scramble", "usa-counter", "usa-shimmer-text", "usa-text-rotate", "usa-wave-text", "usa-glitch", "usa-gradient-text", "usa-handwriting", "usa-scroll-highlight"];
|
|
1667
1783
|
readonly interaction: readonly ["usa-ripple", "usa-magnetic", "usa-tilt", "usa-spotlight", "usa-press", "usa-toggle"];
|
|
1668
1784
|
readonly feedback: readonly ["usa-spinner", "usa-skeleton", "usa-progress", "usa-toaster", "usa-check"];
|
|
1669
|
-
readonly background: readonly ["usa-aurora", "usa-particles", "usa-grain", "usa-marquee", "usa-acrylic"];
|
|
1785
|
+
readonly background: readonly ["usa-aurora", "usa-particles", "usa-grain", "usa-marquee", "usa-acrylic", "usa-grid-glow", "usa-blobs", "usa-water-ripple", "usa-dot-network"];
|
|
1670
1786
|
readonly transitions: readonly ["usa-dialog", "usa-accordion", "usa-flip-list", "usa-view-switch"];
|
|
1671
1787
|
readonly physics: readonly ["usa-spring", "usa-draggable", "usa-overscroll"];
|
|
1672
1788
|
readonly cards: readonly ["usa-card", "usa-card-stack", "usa-sticky-stack", "usa-carousel-3d"];
|
|
@@ -1675,11 +1791,12 @@ declare const COMPONENT_CATEGORIES: {
|
|
|
1675
1791
|
readonly page: readonly ["usa-cursor", "usa-fullpage", "usa-loading-bar", "usa-back-to-top", "usa-ambient", "usa-splash", "usa-auto-skeleton", "usa-motion-switch"];
|
|
1676
1792
|
};
|
|
1677
1793
|
type ComponentCategory = keyof typeof COMPONENT_CATEGORIES;
|
|
1794
|
+
|
|
1678
1795
|
/**
|
|
1679
1796
|
* Register every `<usa-*>` component (or only the given categories).
|
|
1680
1797
|
* Safe to call more than once and on the server (no-op without DOM).
|
|
1681
1798
|
*/
|
|
1682
1799
|
declare function defineComponents(categories?: ComponentCategory[]): void;
|
|
1683
1800
|
|
|
1684
|
-
export { AMBIENT_EFFECTS, BUTTON_DEFORMS, CARD_EFFECTS, CLICK_EFFECTS, COMPONENT_CATEGORIES, CURSOR_MODES, MORPH_ICONS, MOTION_SCALE, PAGE_EFFECTS, REVEAL_EFFECTS, SPINNER_VARIANTS, SPRING_EFFECTS, SPRING_PRESETS, VARIANTS, adoptVariants, burst, confetti, configureComponents, connectedAnimation, createSpring, defineAccordion, defineAcrylic, defineAmbient, defineAurora, defineAutoSkeleton, defineAvatarStack, defineBackToTop, defineBackgroundComponents, defineBadge, defineBottomSheet, defineButton, defineCard, defineCardComponents, defineCardStack, defineCarousel3d, defineCheck, defineCheckbox, defineClick, defineClickComponents, defineComponents, defineCounter, defineCursor, defineDialog, defineDoubleTap, defineDraggable, defineDrawer, defineFab, defineFeedbackComponents, defineFlipList, defineFullpage, defineGrain, defineHold, defineIconMorph, defineInteractionComponents, defineLike, defineLoadingBar, defineMagnetic, defineMarquee, defineMotionSwitch, defineNavbar, defineOverscroll, definePageComponents, defineParticles, definePhysicsComponents, definePopover, definePress, defineProgress, definePullRefresh, defineRating, defineReveal, defineRevealComponents, defineRipple, defineScramble, defineScrollProgress, defineScrolly, defineShimmerText, defineSkeleton, defineSlider, defineSpinner, defineSplash, defineSplitText, defineSpotlight, defineSpring, defineStagger, defineStickyStack, defineTabs, defineTextComponents, defineTextRotate, defineTilt, defineToaster, defineToggle, defineTooltip, defineTransitionComponents, defineTypewriter, defineUiComponents, defineViewSwitch, easeOutExpo, enableMpaTransitions, flip, getMotionIntensity, haptic, linearEasing, loadingBar, morphPath, pageTransition, prefersReducedMotion, projectInertia, readScrollProgress, resolveSpring, restoreMotionIntensity, revealKeyframes, rubberBand, scrambleFrame, scrollToTarget, setMotionIntensity, setVariant, shake, smoothScroll, snapTo, spring, springEasing, springEffectKeyframes, springSamples, stepSpring, supportsLinearEasing, supportsViewTransitions, themeTransition, toast, viewTransition };
|
|
1685
|
-
export type { AmbientEffect, BurstOptions, ButtonDeform, ButtonShape, ButtonState, CardEffect, ClickEffect, ComponentCategory, ComponentsConfig, ConfettiOptions, ConnectedOptions, CursorMode, DialogVariant, FlipOptions, MotionIntensity, PageEffect, PageTransitionOptions, Placement, RevealEffect, SmoothScrollOptions, SpinnerVariant, SpringConfig, SpringEffect, SpringInput, SpringPreset, SpringValue, SpringValueOptions, ToastHandle, ToastOptions, ToastType, UsaAccordionElement, UsaAcrylicElement, UsaAmbientElement, UsaAuroraElement, UsaAutoSkeletonElement, UsaAvatarStackElement, UsaBackToTopElement, UsaBadgeElement, UsaBottomSheetElement, UsaButtonElement, UsaCardElement, UsaCardStackElement, UsaCarousel3dElement, UsaCheckElement, UsaCheckboxElement, UsaClickElement, UsaCounterElement, UsaCursorElement, UsaDialogElement, UsaDoubleTapElement, UsaDraggableElement, UsaDrawerElement, UsaElement, UsaFabElement, UsaFlipListElement, UsaFullpageElement, UsaGrainElement, UsaHoldElement, UsaIconMorphElement, UsaLikeElement, UsaLoadingBarElement, UsaMagneticElement, UsaMarqueeElement, UsaMotionSwitchElement, UsaNavbarElement, UsaOverscrollElement, UsaParticlesElement, UsaPopoverElement, UsaPressElement, UsaProgressElement, UsaPullRefreshElement, UsaRatingElement, UsaRevealElement, UsaRippleElement, UsaScrambleElement, UsaScrollProgressElement, UsaScrollyElement, UsaShimmerTextElement, UsaSkeletonElement, UsaSliderElement, UsaSpinnerElement, UsaSplashElement, UsaSplitTextElement, UsaSpotlightElement, UsaSpringElement, UsaStaggerElement, UsaStickyStackElement, UsaTabsElement, UsaTextRotateElement, UsaTiltElement, UsaToasterElement, UsaToggleElement, UsaTooltipElement, UsaTypewriterElement, UsaViewSwitchElement, Variant, ViewTransitionOptions };
|
|
1801
|
+
export { AMBIENT_EFFECTS, BUTTON_DEFORMS, CARD_EFFECTS, CLICK_EFFECTS, COMPONENT_CATEGORIES, CURSOR_MODES, MORPH_ICONS, MOTION_SCALE, PAGE_EFFECTS, REVEAL_EFFECTS, SPINNER_VARIANTS, SPRING_EFFECTS, SPRING_PRESETS, VARIANTS, adoptVariants, burst, confetti, configureComponents, connectedAnimation, createSpring, defineAccordion, defineAcrylic, defineAmbient, defineAurora, defineAutoSkeleton, defineAvatarStack, defineBackToTop, defineBackgroundComponents, defineBadge, defineBlobs, defineBottomSheet, defineButton, defineCard, defineCardComponents, defineCardStack, defineCarousel3d, defineCheck, defineCheckbox, defineClick, defineClickComponents, defineComponents, defineCounter, defineCursor, defineDialog, defineDotNetwork, defineDoubleTap, defineDraggable, defineDrawer, defineFab, defineFeedbackComponents, defineFlipList, defineFullpage, defineGlitch, defineGradientText, defineGrain, defineGridGlow, defineHandwriting, defineHold, defineIconMorph, defineInteractionComponents, defineLike, defineLoadingBar, defineMagnetic, defineMarquee, defineMotionSwitch, defineNavbar, defineOverscroll, definePageComponents, defineParticles, definePhysicsComponents, definePopover, definePress, defineProgress, definePullRefresh, defineRating, defineReveal, defineRevealComponents, defineRipple, defineScramble, defineScrollHighlight, defineScrollProgress, defineScrolly, defineShimmerText, defineSkeleton, defineSlider, defineSpinner, defineSplash, defineSplitText, defineSpotlight, defineSpring, defineStagger, defineStickyStack, defineTabs, defineTextComponents, defineTextRotate, defineTilt, defineToaster, defineToggle, defineTooltip, defineTransitionComponents, defineTypewriter, defineUiComponents, defineViewSwitch, defineWaterRipple, defineWaveText, easeOutExpo, enableMpaTransitions, flip, fluentPreset, getMotionIntensity, haptic, linearEasing, loadingBar, morphPath, pageTransition, prefersReducedMotion, projectInertia, readScrollProgress, resolveSpring, restoreMotionIntensity, revealKeyframes, rubberBand, scrambleFrame, scrollToTarget, setMotionIntensity, setVariant, shake, smoothScroll, snapTo, spring, springEasing, springEffectKeyframes, springSamples, stepSpring, supportsLinearEasing, supportsViewTransitions, themeTransition, toast, viewTransition };
|
|
1802
|
+
export type { AmbientEffect, BurstOptions, ButtonDeform, ButtonShape, ButtonState, CardEffect, ClickEffect, ComponentCategory, ComponentsConfig, ConfettiOptions, ConnectedOptions, CursorMode, DialogVariant, FlipOptions, FluentPresetOptions, MotionIntensity, PageEffect, PageTransitionOptions, Placement, RevealEffect, SmoothScrollOptions, SpinnerVariant, SpringConfig, SpringEffect, SpringInput, SpringPreset, SpringValue, SpringValueOptions, ToastHandle, ToastOptions, ToastType, UsaAccordionElement, UsaAcrylicElement, UsaAmbientElement, UsaAuroraElement, UsaAutoSkeletonElement, UsaAvatarStackElement, UsaBackToTopElement, UsaBadgeElement, UsaBlobsElement, UsaBottomSheetElement, UsaButtonElement, UsaCardElement, UsaCardStackElement, UsaCarousel3dElement, UsaCheckElement, UsaCheckboxElement, UsaClickElement, UsaCounterElement, UsaCursorElement, UsaDialogElement, UsaDotNetworkElement, UsaDoubleTapElement, UsaDraggableElement, UsaDrawerElement, UsaElement, UsaFabElement, UsaFlipListElement, UsaFullpageElement, UsaGlitchElement, UsaGradientTextElement, UsaGrainElement, UsaGridGlowElement, UsaHandwritingElement, UsaHoldElement, UsaIconMorphElement, UsaLikeElement, UsaLoadingBarElement, UsaMagneticElement, UsaMarqueeElement, UsaMotionSwitchElement, UsaNavbarElement, UsaOverscrollElement, UsaParticlesElement, UsaPopoverElement, UsaPressElement, UsaProgressElement, UsaPullRefreshElement, UsaRatingElement, UsaRevealElement, UsaRippleElement, UsaScrambleElement, UsaScrollHighlightElement, UsaScrollProgressElement, UsaScrollyElement, UsaShimmerTextElement, UsaSkeletonElement, UsaSliderElement, UsaSpinnerElement, UsaSplashElement, UsaSplitTextElement, UsaSpotlightElement, UsaSpringElement, UsaStaggerElement, UsaStickyStackElement, UsaTabsElement, UsaTextRotateElement, UsaTiltElement, UsaToasterElement, UsaToggleElement, UsaTooltipElement, UsaTypewriterElement, UsaViewSwitchElement, UsaWaterRippleElement, UsaWaveTextElement, Variant, ViewTransitionOptions };
|
package/dist/components.js
CHANGED
|
@@ -1,13 +1,13 @@
|
|
|
1
1
|
import { defineRevealComponents } from './components/reveal.js';
|
|
2
2
|
export { REVEAL_EFFECTS, defineReveal, defineScrollProgress, defineScrolly, defineStagger, readScrollProgress, revealKeyframes } from './components/reveal.js';
|
|
3
3
|
import { defineTextComponents } from './components/text.js';
|
|
4
|
-
export { defineCounter, defineScramble, defineShimmerText, defineSplitText, defineTextRotate, defineTypewriter, easeOutExpo, scrambleFrame } from './components/text.js';
|
|
4
|
+
export { defineCounter, defineGlitch, defineGradientText, defineHandwriting, defineScramble, defineScrollHighlight, defineShimmerText, defineSplitText, defineTextRotate, defineTypewriter, defineWaveText, easeOutExpo, scrambleFrame } from './components/text.js';
|
|
5
5
|
import { defineInteractionComponents } from './components/interaction.js';
|
|
6
6
|
export { defineMagnetic, definePress, defineRipple, defineSpotlight, defineTilt, defineToggle } from './components/interaction.js';
|
|
7
7
|
import { defineFeedbackComponents } from './components/feedback.js';
|
|
8
8
|
export { SPINNER_VARIANTS, defineCheck, defineProgress, defineSkeleton, defineSpinner, defineToaster, toast } from './components/feedback.js';
|
|
9
9
|
import { defineBackgroundComponents } from './components/background.js';
|
|
10
|
-
export { defineAcrylic, defineAurora, defineGrain, defineMarquee, defineParticles } from './components/background.js';
|
|
10
|
+
export { defineAcrylic, defineAurora, defineBlobs, defineDotNetwork, defineGrain, defineGridGlow, defineMarquee, defineParticles, defineWaterRipple, fluentPreset } from './components/background.js';
|
|
11
11
|
import { defineTransitionComponents } from './components/transitions.js';
|
|
12
12
|
export { connectedAnimation, defineAccordion, defineDialog, defineFlipList, defineViewSwitch, flip, viewTransition } from './components/transitions.js';
|
|
13
13
|
import { definePhysicsComponents } from './components/physics.js';
|
|
@@ -16,13 +16,16 @@ import { defineCardComponents } from './components/cards.js';
|
|
|
16
16
|
export { CARD_EFFECTS, defineCard, defineCardStack, defineCarousel3d, defineStickyStack } from './components/cards.js';
|
|
17
17
|
import { defineClickComponents } from './components/click.js';
|
|
18
18
|
export { BUTTON_DEFORMS, CLICK_EFFECTS, MORPH_ICONS, burst, confetti, defineButton, defineCheckbox, defineClick, defineDoubleTap, defineHold, defineIconMorph, defineLike, haptic, morphPath, shake } from './components/click.js';
|
|
19
|
-
import {
|
|
20
|
-
export {
|
|
19
|
+
import { defineUiComponents } from './components/ui.js';
|
|
20
|
+
export { defineAvatarStack, defineBadge, defineBottomSheet, defineDrawer, defineFab, defineNavbar, definePopover, definePullRefresh, defineRating, defineSlider, defineTabs, defineTooltip } from './components/ui.js';
|
|
21
21
|
import { definePageComponents } from './components/page.js';
|
|
22
22
|
export { AMBIENT_EFFECTS, CURSOR_MODES, PAGE_EFFECTS, defineAmbient, defineAutoSkeleton, defineBackToTop, defineCursor, defineFullpage, defineLoadingBar, defineMotionSwitch, defineSplash, enableMpaTransitions, loadingBar, pageTransition, restoreMotionIntensity, scrollToTarget, setMotionIntensity, smoothScroll, supportsViewTransitions, themeTransition } from './components/page.js';
|
|
23
|
-
import {
|
|
24
|
-
export {
|
|
25
|
-
|
|
23
|
+
import { a as adoptVariants } from './chunks/variants-Ce9CboVc.js';
|
|
24
|
+
export { V as VARIANTS, s as setVariant } from './chunks/variants-Ce9CboVc.js';
|
|
25
|
+
import { c as canDefine } from './chunks/base-CB8gChoe.js';
|
|
26
|
+
export { M as MOTION_SCALE, a as configureComponents, g as getMotionIntensity, p as prefersReducedMotion } from './chunks/base-CB8gChoe.js';
|
|
27
|
+
export { C as COMPONENT_CATEGORIES } from './chunks/index-tags-f37txHmb.js';
|
|
28
|
+
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-ka0YJ_ZR.js';
|
|
26
29
|
|
|
27
30
|
/**
|
|
28
31
|
* use-scroll-animate/components
|
|
@@ -44,20 +47,6 @@ export { S as SPRING_PRESETS, c as createSpring, l as linearEasing, p as project
|
|
|
44
47
|
*
|
|
45
48
|
* @license MIT
|
|
46
49
|
*/
|
|
47
|
-
/** The component categories and their default tags. */
|
|
48
|
-
const COMPONENT_CATEGORIES = {
|
|
49
|
-
reveal: ['usa-reveal', 'usa-stagger', 'usa-scroll-progress', 'usa-scrolly'],
|
|
50
|
-
text: ['usa-typewriter', 'usa-split-text', 'usa-scramble', 'usa-counter', 'usa-shimmer-text', 'usa-text-rotate'],
|
|
51
|
-
interaction: ['usa-ripple', 'usa-magnetic', 'usa-tilt', 'usa-spotlight', 'usa-press', 'usa-toggle'],
|
|
52
|
-
feedback: ['usa-spinner', 'usa-skeleton', 'usa-progress', 'usa-toaster', 'usa-check'],
|
|
53
|
-
background: ['usa-aurora', 'usa-particles', 'usa-grain', 'usa-marquee', 'usa-acrylic'],
|
|
54
|
-
transitions: ['usa-dialog', 'usa-accordion', 'usa-flip-list', 'usa-view-switch'],
|
|
55
|
-
physics: ['usa-spring', 'usa-draggable', 'usa-overscroll'],
|
|
56
|
-
cards: ['usa-card', 'usa-card-stack', 'usa-sticky-stack', 'usa-carousel-3d'],
|
|
57
|
-
click: ['usa-click', 'usa-button', 'usa-icon-morph', 'usa-like', 'usa-hold', 'usa-double-tap', 'usa-checkbox'],
|
|
58
|
-
ui: ['usa-tabs', 'usa-drawer', 'usa-bottom-sheet', 'usa-pull-refresh', 'usa-fab', 'usa-navbar', 'usa-slider', 'usa-rating', 'usa-tooltip', 'usa-popover', 'usa-badge', 'usa-avatar-stack'],
|
|
59
|
-
page: ['usa-cursor', 'usa-fullpage', 'usa-loading-bar', 'usa-back-to-top', 'usa-ambient', 'usa-splash', 'usa-auto-skeleton', 'usa-motion-switch'],
|
|
60
|
-
};
|
|
61
50
|
const BY_CATEGORY = {
|
|
62
51
|
reveal: defineRevealComponents,
|
|
63
52
|
text: defineTextComponents,
|
|
@@ -81,5 +70,5 @@ function defineComponents(categories) {
|
|
|
81
70
|
(categories || Object.keys(BY_CATEGORY)).forEach((c) => BY_CATEGORY[c]?.());
|
|
82
71
|
}
|
|
83
72
|
|
|
84
|
-
export {
|
|
73
|
+
export { adoptVariants, defineBackgroundComponents, defineCardComponents, defineClickComponents, defineComponents, defineFeedbackComponents, defineInteractionComponents, definePageComponents, definePhysicsComponents, defineRevealComponents, defineTextComponents, defineTransitionComponents, defineUiComponents };
|
|
85
74
|
//# sourceMappingURL=components.js.map
|
package/dist/components.js.map
CHANGED
|
@@ -1 +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';\nimport { definePhysicsComponents } from './physics/index';\nimport { defineCardComponents } from './cards/index';\nimport { defineClickComponents } from './click/index';\nimport { defineUiComponents } from './ui/index';\nimport { definePageComponents } from './page/index';\nimport { adoptVariants } from './ui/variants';\nimport { canDefine } from './base';\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';\nexport * from './click/index';\nexport * from './ui/index';\nexport * from './page/index';\n\
|
|
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';\nimport { definePhysicsComponents } from './physics/index';\nimport { defineCardComponents } from './cards/index';\nimport { defineClickComponents } from './click/index';\nimport { defineUiComponents } from './ui/index';\nimport { definePageComponents } from './page/index';\nimport { adoptVariants } from './ui/variants';\nimport { canDefine } from './base';\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';\nexport * from './click/index';\nexport * from './ui/index';\nexport * from './page/index';\n\nexport { COMPONENT_CATEGORIES } from './index-tags';\nexport type { ComponentCategory } from './index-tags';\nimport { COMPONENT_CATEGORIES, type ComponentCategory } from './index-tags';\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 click: defineClickComponents,\n ui: defineUiComponents,\n page: definePageComponents,\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 if (canDefine()) adoptVariants();\n (categories || (Object.keys(BY_CATEGORY) as ComponentCategory[])).forEach((c) => BY_CATEGORY[c]?.());\n}\n"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;;;;;;;;;;;;;;;;;;;AAmBG;AA+BH,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;AAC3B,IAAA,KAAK,EAAE,qBAAqB;AAC5B,IAAA,EAAE,EAAE,kBAAkB;AACtB,IAAA,IAAI,EAAE,oBAAoB;CAC3B;AAED;;;AAGG;AACG,SAAU,gBAAgB,CAAC,UAAgC,EAAA;AAC/D,IAAA,IAAI,SAAS,EAAE;AAAE,QAAA,aAAa,EAAE;IAChC,CAAC,UAAU,IAAK,MAAM,CAAC,IAAI,CAAC,WAAW,CAAyB,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC;AACtG;;;;"}
|