use-scroll-animate 4.7.0 → 4.9.0

package/dist/components/lite.cjs

@@ -14,6 +14,13 @@ const MOTION_SCALE = { off: 0, low: 0.6, normal: 1, high: 1.25 };
 const config = { injectStyles: true, reducedMotion: 'user', motionIntensity: 'normal', motionSensitivity: 'full' };
 /** Change global component settings (call before `define*()` for `injectStyles`). */
 function configureComponents(options) {
+    if (!quiet) {
+        // 4.9: removed in 5.0 (see docs/upgrading-5.md, `npx usa-codemod-5`)
+        if (options.motionIntensity === 'off')
+            deprecate('intensity-off', "motionIntensity: 'off' is deprecated and will be removed in 5.0 — use motionSensitivity: 'minimal' (setMotionSensitivity('minimal')) instead.");
+        if (options.reducedMotion === 'no-preference')
+            deprecate('reduced-no-preference', "reducedMotion: 'no-preference' is deprecated and will be removed in 5.0 — the OS setting is always respected; use 'user' (default) or 'reduce'.");
+    }
     Object.assign(config, options);
     if (options.motionIntensity && typeof document !== 'undefined') {
         document.documentElement.style.setProperty('--usa-motion', String(MOTION_SCALE[options.motionIntensity] ?? 1));
@@ -58,6 +65,17 @@ function adaptKeyframes(frames, level = config.motionSensitivity) {
         return out;
     });
 }
+let quiet = 0;
+/** Run `fn` without 4.9 deprecation warnings (library-internal calls). */
+function withoutDeprecations(fn) {
+    quiet++;
+    try {
+        return fn();
+    }
+    finally {
+        quiet--;
+    }
+}
 /** The current global motion intensity. */
 function getMotionIntensity() {
     return config.motionIntensity;
@@ -361,6 +379,15 @@ const EASE_OUT = 'cubic-bezier(0.22, 1, 0.36, 1)';
 const EASE_SPRING = 'cubic-bezier(0.34, 1.56, 0.64, 1)';
 /** Windows Fluent "decelerate" / "point-to-point" curves. */
 const FLUENT_DECELERATE = 'cubic-bezier(0.1, 0.9, 0.2, 1)';
+const warned = new Set();
+/** Log a deprecation once per key (console.warn). */
+function deprecate(key, message) {
+    if (warned.has(key))
+        return;
+    warned.add(key);
+    if (typeof console !== 'undefined')
+        console.warn(`[use-scroll-animate] ${message}`);
+}
 /**
  * The `kind` attribute of `<usa-spinner>`, `<usa-check>`, `<usa-dialog>` and
  * `<usa-acrylic>` (3.0: `variant` only selects a style variant).
@@ -388,7 +415,7 @@ const COMPONENT_CATEGORIES = {
     timeline: ['usa-timeline'],
     gesture: ['usa-swipeable', 'usa-pinch-zoom'],
     svg: ['usa-draw', 'usa-morph', 'usa-mask-reveal', 'usa-anim-icon'],
-    webgl: ['usa-shader', 'usa-distort', 'usa-liquid'],
+    webgl: ['usa-shader', 'usa-distort', 'usa-liquid', 'usa-post-fx'],
     depth: ['usa-cube', 'usa-depth'],
     layout: ['usa-auto-animate', 'usa-masonry'],
     packs: ['usa-pack'],
@@ -7946,6 +7973,7 @@ var css$7 = "";
 
 const LEVELS = ['off', 'low', 'normal', 'high'];
 const KEY$1 = 'usa:motion';
+let fromSwitch = false;
 /**
  * Set the global motion intensity for every `<usa-*>` component:
  * `'off'` (like reduced motion), `'low'`, `'normal'` (default), `'high'`.
@@ -7955,7 +7983,9 @@ const KEY$1 = 'usa:motion';
 function setMotionIntensity(level, persist = false) {
     if (!LEVELS.includes(level))
         return;
-    configureComponents({ motionIntensity: level });
+    if (level === 'off' && !fromSwitch)
+        deprecate('set-intensity-off', "setMotionIntensity('off') is deprecated and will be removed in 5.0 — use setMotionSensitivity('minimal') from use-scroll-animate/components/a11y.");
+    withoutDeprecations(() => configureComponents({ motionIntensity: level }));
     if (persist) {
         try {
             localStorage.setItem(KEY$1, level);
@@ -7971,12 +8001,15 @@ function setMotionIntensity(level, persist = false) {
 function restoreMotionIntensity() {
     try {
         const v = localStorage.getItem(KEY$1);
-        if (v && LEVELS.includes(v))
+        if (v && LEVELS.includes(v)) {
+            fromSwitch = true;
             setMotionIntensity(v);
+        }
     }
     catch {
         /* ignore */
     }
+    fromSwitch = false;
     return getMotionIntensity();
 }
 function defineMotionSwitch(tag = 'usa-motion-switch') {
@@ -7985,7 +8018,9 @@ function defineMotionSwitch(tag = 'usa-motion-switch') {
             return getMotionIntensity();
         }
         set value(v) {
+            fromSwitch = true;
             setMotionIntensity(v, true);
+            fromSwitch = false;
             this.sync();
         }
         mount() {
@@ -8176,6 +8211,8 @@ function defineTimeline(tag = 'usa-timeline') {
                 // (0–0.95) or `scrub="js"` opt into the JS engine, `scrub="scroll"`
                 // follows this element's own scroll position.
                 const v = this.str('scrub');
+                if (v === 'js')
+                    deprecate('timeline-scrub-js', '<usa-timeline scrub="js"> is deprecated and will be removed in 5.0 — the JS engine is picked automatically where native scroll timelines are missing; add smooth="…" to opt into smoothing.');
                 const stop = tl.scrub(this, { smooth: this.num('smooth', 0), engine: v === 'js' ? 'js' : 'auto', source: v === 'scroll' ? 'scroll' : 'view' });
                 this.toggleAttribute('data-native', stop.native);
                 this.onCleanup(stop);
@@ -8953,6 +8990,12 @@ const SHADERS = {
     waves: 'void main(){vec2 u=v_uv;float t=u_time*.4;float w=0.;for(int i=0;i<4;i++){float f=float(i)+1.;w+=sin(u.x*6.*f+t*f)*.08/f;}float l=smoothstep(.0,.02,abs(u.y-.5-w));vec3 col=mix(vec3(.2,.5,1.),vec3(.04,.06,.15),l)+vec3(.1,.0,.2)*u.y;gl_FragColor=vec4(col,1.);}',
     aurora: 'void main(){vec2 u=v_uv;float t=u_time*.2;float b=0.;for(int i=0;i<3;i++){float f=float(i);b+=.4/abs((u.y-.6+.15*sin(u.x*3.+t+f*1.7))*(8.+f*4.));}vec3 col=vec3(.02,.03,.08)+b*mix(vec3(.1,.9,.6),vec3(.6,.3,1.),u.x)*.35;gl_FragColor=vec4(col,1.);}',
     distort: 'void main(){vec2 u=v_uv;vec2 d=u-u_mouse;float r=length(d);float k=u_hover*.08*exp(-r*r*18.);u-=normalize(d+1e-4)*k;float s=u_hover*.006;vec3 col=vec3(texture2D(u_tex,u+vec2(s,0.)).r,texture2D(u_tex,u).g,texture2D(u_tex,u-vec2(s,0.)).b);gl_FragColor=vec4(col,1.);}',
+    // 4.8 particle presets (procedural, one quad: no buffers, no per-particle JS)
+    snow: 'float h(vec2 p){return fract(sin(dot(p,vec2(127.1,311.7)))*43758.5453);}void main(){vec2 u=v_uv;u.x*=u_resolution.x/max(u_resolution.y,1.);vec3 col=mix(vec3(.05,.08,.16),vec3(.12,.16,.3),v_uv.y);for(int l=0;l<3;l++){float s=8.+float(l)*7.;vec2 q=u*s;q.y+=u_time*(.6+float(l)*.35);q.x+=sin(q.y*.7+float(l))*.3;vec2 id=floor(q);vec2 f=fract(q)-.5;float r=h(id);if(r>.6){vec2 o=vec2(h(id+3.)-.5,h(id+7.)-.5)*.6;float d=length(f-o);col+=smoothstep(.09-float(l)*.02,0.,d)*(.5+.5*r);}}gl_FragColor=vec4(col,1.);}',
+    fireflies: 'float h(vec2 p){return fract(sin(dot(p,vec2(127.1,311.7)))*43758.5453);}void main(){vec2 u=v_uv;u.x*=u_resolution.x/max(u_resolution.y,1.);vec3 col=vec3(.02,.04,.03);for(int l=0;l<2;l++){vec2 q=u*(5.+float(l)*4.);vec2 id=floor(q);vec2 f=fract(q)-.5;float r=h(id+float(l)*13.);vec2 o=.35*vec2(sin(u_time*(.4+r)+r*6.28),cos(u_time*(.3+r)+r*12.));float d=length(f-o);float tw=.5+.5*sin(u_time*3.*r+r*20.);col+=vec3(1.,.85,.3)*smoothstep(.12,0.,d)*tw*step(.45,r);}gl_FragColor=vec4(col,1.);}',
+    stars: 'float h(vec2 p){return fract(sin(dot(p,vec2(127.1,311.7)))*43758.5453);}void main(){vec2 c=v_uv-.5;c.x*=u_resolution.x/max(u_resolution.y,1.);vec3 col=vec3(.01,.01,.04);for(int l=0;l<4;l++){float z=fract(float(l)*.25+u_time*.05);float sc=mix(20.,.5,z);vec2 q=c*sc+float(l)*7.;vec2 id=floor(q);vec2 f=fract(q)-.5;float r=h(id);float d=length(f-(vec2(h(id+1.),h(id+2.))-.5)*.7);col+=vec3(.8,.9,1.)*smoothstep(.06,0.,d)*step(.8,r)*smoothstep(0.,.5,z)*smoothstep(1.,.8,z)*2.;}gl_FragColor=vec4(col,1.);}',
+    bokeh: 'float h(vec2 p){return fract(sin(dot(p,vec2(127.1,311.7)))*43758.5453);}void main(){vec2 u=v_uv;u.x*=u_resolution.x/max(u_resolution.y,1.);vec3 col=mix(vec3(.08,.03,.12),vec3(.02,.05,.12),v_uv.y);for(int l=0;l<3;l++){vec2 q=u*(2.5+float(l)*1.5);q.y-=u_time*.05*(1.+float(l));vec2 id=floor(q);vec2 f=fract(q)-.5;float r=h(id+float(l)*5.);float d=length(f-(vec2(h(id+4.),h(id+9.))-.5)*.5);vec3 tint=.5+.5*cos(r*6.28+vec3(0.,2.,4.));col+=tint*smoothstep(.3,.26,d)*.18*step(.35,r);}gl_FragColor=vec4(col,1.);}',
+    rain: 'float h(float n){return fract(sin(n)*43758.5453);}void main(){vec2 u=v_uv;vec3 col=mix(vec3(.04,.06,.1),vec3(.1,.13,.2),u.y);float n=floor(u.x*120.);float sp=.8+h(n)*1.2;float y=fract(u.y+u_time*sp+h(n+1.));float drop=smoothstep(.0,.08,y)*smoothstep(.16,.08,y)*step(.7,h(n+2.));col+=vec3(.5,.6,.8)*drop*.6;gl_FragColor=vec4(col,1.);}',
     liquid: 'void main(){vec2 u=v_uv;vec2 o=vec2(0.);for(int i=0;i<4;i++){vec4 r=u_ripples[i];if(r.w>0.){float d=distance(u,r.xy);float w=sin(d*60.-r.z*12.)*exp(-d*6.)*exp(-r.z*1.6)*r.w*.02;o+=normalize(u-r.xy+1e-4)*w;}}o+=vec2(sin(u.y*10.+u_time),cos(u.x*10.+u_time))*.002*u_hover;gl_FragColor=texture2D(u_tex,u+o);}',
 };
 /** Full fragment source for a preset or custom body (adds the shared header). */
@@ -9012,9 +9055,10 @@ function glQuad(canvas, frag) {
     const U = (n) => g.getUniformLocation(prog, n);
     const uT = U('u_time'), uR = U('u_resolution'), uM = U('u_mouse'), uH = U('u_hover'), uRp = U('u_ripples');
     let tex = null;
+    const extraLoc = {};
     const quad = {
-        resize() {
-            const dpr = Math.min(2, (typeof devicePixelRatio === 'number' && devicePixelRatio) || 1);
+        resize(scale = 1) {
+            const dpr = Math.min(2, (typeof devicePixelRatio === 'number' && devicePixelRatio) || 1) * Math.min(1, Math.max(0.25, scale));
             const w = Math.max(1, Math.round((canvas.clientWidth || 300) * dpr));
             const h = Math.max(1, Math.round((canvas.clientHeight || 150) * dpr));
             if (canvas.width !== w || canvas.height !== h)
@@ -9037,6 +9081,9 @@ function glQuad(canvas, frag) {
             g.uniform1f(uH, u.hover ?? 0);
             if (uRp)
                 g.uniform4fv(uRp, new Float32Array((u.ripples ?? []).concat(Array(16).fill(0)).slice(0, 16)));
+            if (u.extra)
+                for (const [k, v] of Object.entries(u.extra))
+                    g.uniform1f((extraLoc[k] ?? (extraLoc[k] = U(k))), v);
             g.drawArrays(g.TRIANGLES, 0, 6);
         },
         dispose() {
@@ -9051,6 +9098,131 @@ function glQuad(canvas, frag) {
     return quad;
 }
 
+/**
+ * 4.8 — WebGL preset library on `glQuad()`: particle presets (`snow`,
+ * `fireflies`, `stars`, `bokeh`, `rain` — usable as `<usa-shader preset>`),
+ * chainable post-processing passes for images (`<usa-post-fx>`), one CSS
+ * fallback per preset, and an adaptive quality governor (fps + battery).
+ */
+const PARTICLE_PRESETS = ['snow', 'fireflies', 'stars', 'bokeh', 'rain'];
+/** Post-processing passes: `vec3 fx(vec3 c, vec2 uv)` bodies, applied in order. `u_intensity` 0–1. */
+const POST_EFFECTS = {
+    vignette: 'c*=mix(1.,smoothstep(.85,.25,length(uv-.5)),u_intensity);',
+    grain: 'c+=(fract(sin(dot(uv*u_resolution+u_time,vec2(12.9898,78.233)))*43758.5453)-.5)*.18*u_intensity;',
+    chromatic: 'float s=.008*u_intensity;c=vec3(texture2D(u_tex,uv+vec2(s,0.)).r,c.g,texture2D(u_tex,uv-vec2(s,0.)).b);',
+    scanlines: 'c*=1.-.25*u_intensity*step(.5,fract(uv.y*u_resolution.y*.5));',
+    crt: 'vec2 d=uv-.5;float r=dot(d,d);c*=1.-.6*u_intensity*r;c*=.92+.08*sin(uv.y*u_resolution.y*3.14159);c.r*=1.+.05*u_intensity;',
+    bloom: 'vec3 b=vec3(0.);for(int i=0;i<8;i++){float a=float(i)*.785;b+=max(texture2D(u_tex,uv+vec2(cos(a),sin(a))*.012).rgb-.6,0.);}c+=b*.35*u_intensity;',
+    pixelate: 'float px=mix(1.,48.,u_intensity);vec2 g=floor(uv*u_resolution/px)*px/u_resolution;c=texture2D(u_tex,g+.5*px/u_resolution).rgb;',
+    duotone: 'float l=dot(c,vec3(.299,.587,.114));c=mix(c,mix(vec3(.12,.05,.35),vec3(1.,.55,.4),l),u_intensity);',
+    glitch: 'float k=step(.97,fract(sin(floor(uv.y*24.)+floor(u_time*6.))*4375.5));c=mix(c,texture2D(u_tex,uv+vec2(k*.04*u_intensity,0.)).rgb,k);',
+};
+/** One fragment shader running the passes in order over `u_tex` (pixel-sampling passes read the source). */
+function postFxShader(effects) {
+    const list = effects.filter((e) => POST_EFFECTS[e]);
+    const body = list.map((e) => `{${POST_EFFECTS[e]}}`).join('');
+    return `uniform float u_intensity;void main(){vec2 uv=v_uv;vec3 c=texture2D(u_tex,uv).rgb;${body}gl_FragColor=vec4(clamp(c,0.,1.),1.);}`;
+}
+/** The unified CSS fallback (no WebGL / reduced data): a still background or image filter per preset. */
+const GL_FALLBACKS = {
+    gradient: 'linear-gradient(120deg,#6366f1,#ec4899 50%,#22d3ee)',
+    plasma: 'conic-gradient(from 90deg,#f43f5e,#a855f7,#06b6d4,#f43f5e)',
+    waves: 'linear-gradient(#0a0f26,#1e3a8a)',
+    aurora: 'radial-gradient(120% 60% at 30% 40%,#10b98155,transparent),radial-gradient(100% 50% at 70% 50%,#8b5cf655,transparent),#05070f',
+    snow: 'radial-gradient(2px 2px at 20% 30%,#fff,transparent),radial-gradient(2px 2px at 70% 60%,#fff,transparent),radial-gradient(1.5px 1.5px at 40% 80%,#fff,transparent),linear-gradient(#0d1428,#1f2a4d)',
+    fireflies: 'radial-gradient(3px 3px at 25% 40%,#fde68a,transparent),radial-gradient(3px 3px at 65% 70%,#fde68a,transparent),#05090a',
+    stars: 'radial-gradient(1px 1px at 10% 20%,#fff,transparent),radial-gradient(1px 1px at 80% 30%,#fff,transparent),radial-gradient(1.5px 1.5px at 50% 70%,#cfe0ff,transparent),#02020a',
+    bokeh: 'radial-gradient(40px 40px at 30% 40%,#f472b633,transparent),radial-gradient(60px 60px at 70% 60%,#60a5fa33,transparent),#140820',
+    rain: 'repeating-linear-gradient(100deg,#ffffff10 0 1px,transparent 1px 14px),linear-gradient(#0a0f1a,#1a2133)',
+    // post-fx fallbacks are CSS filters on the <img>
+    'post:duotone': 'grayscale(1) sepia(.6) hue-rotate(220deg) saturate(2)',
+    'post:vignette': 'brightness(.95) contrast(1.05)',
+    'post:crt': 'contrast(1.15) saturate(1.2)',
+    'post:bloom': 'brightness(1.08) saturate(1.15)',
+};
+/** CSS fallback for a shader preset / post effect list. */
+function glFallbackCss(preset, post = false) {
+    if (post)
+        return preset.split(/\s+/).map((e) => GL_FALLBACKS[`post:${e}`]).filter(Boolean).join(' ');
+    return GL_FALLBACKS[preset] || GL_FALLBACKS.gradient;
+}
+/**
+ * Adaptive quality for GL loops: measures fps, steps the resolution scale
+ * down (1 → 0.5 → 0.35) after two slow seconds and back up after five good
+ * ones, and caps the frame rate in battery-saver mode. Pure — feed it times.
+ */
+function glGovernor(options = {}) {
+    const { minFps = 40, saverFps = 30 } = options;
+    const STEPS = [1, 0.5, 0.35];
+    let step = 0;
+    let frames = 0;
+    let winStart = -1;
+    let last = -Infinity;
+    let slow = 0;
+    let good = 0;
+    let fps = 60;
+    const g = {
+        saver: false,
+        get scale() {
+            return Math.min(STEPS[step], g.saver ? 0.6 : 1);
+        },
+        get fps() {
+            return fps;
+        },
+        tick(t) {
+            if (winStart < 0)
+                winStart = t;
+            if (g.saver && t - last < 1000 / saverFps - 1)
+                return false;
+            last = t;
+            frames++;
+            if (t - winStart >= 1000) {
+                fps = Math.round((frames * 1000) / (t - winStart));
+                frames = 0;
+                winStart = t;
+                const before = g.scale;
+                if (fps < minFps && !g.saver) {
+                    good = 0;
+                    if (++slow >= 2 && step < STEPS.length - 1)
+                        ((step++), (slow = 0));
+                }
+                else {
+                    slow = 0;
+                    if (++good >= 5 && step > 0)
+                        ((step--), (good = 0));
+                }
+                if (g.scale !== before)
+                    g.onScale?.(g.scale);
+            }
+            return true;
+        },
+    };
+    return g;
+}
+/** Watch the Battery Status API (where available) and Save-Data; calls `cb(true)` in saver conditions. Returns a stop function. */
+function watchPowerSaver(cb) {
+    let stopped = false;
+    const nav = (typeof navigator !== 'undefined' ? navigator : {});
+    const saveData = !!nav.connection?.saveData;
+    if (saveData)
+        cb(true);
+    if (typeof nav.getBattery !== 'function')
+        return () => undefined;
+    let battery = null;
+    const update = () => !stopped && cb(saveData || (!!battery && !battery.charging && battery.level <= 0.2));
+    nav.getBattery().then((b) => {
+        battery = b;
+        update();
+        b.addEventListener?.('levelchange', update);
+        b.addEventListener?.('chargingchange', update);
+    }, () => undefined);
+    return () => {
+        stopped = true;
+        battery?.removeEventListener?.('levelchange', update);
+        battery?.removeEventListener?.('chargingchange', update);
+    };
+}
+
 var css$2 = "";
 
 function make(kind) {
@@ -9064,15 +9236,23 @@ function make(kind) {
             this._hover = 0;
             this._hoverTo = 0;
             this._ripples = [];
+            this._scale = 1;
         }
         static get observedAttributes() {
-            return kind === 'shader' ? ['preset', 'speed'] : ['src'];
+            return kind === 'shader' ? ['preset', 'speed', 'quality'] : kind === 'post' ? ['effects', 'intensity', 'quality'] : ['src'];
         }
         get active() {
             return !!this._q;
         }
         fallback(reason) {
             this.setAttribute('data-fallback', reason);
+            // 4.8 unified fallback: a still CSS rendering of the preset / effects
+            if (reason !== 'off') {
+                if (kind === 'shader')
+                    this.style.setProperty('--usa-gl-fallback', glFallbackCss(this.str('preset', 'gradient')));
+                if (kind === 'post')
+                    this.style.setProperty('--usa-gl-filter', glFallbackCss(this.str('effects', 'vignette grain'), true) || 'none');
+            }
             this._c?.remove();
             this._c = null;
             this._q?.dispose();
@@ -9090,12 +9270,13 @@ function make(kind) {
                 mouse: this._mouse,
                 hover: this._hover,
                 ripples: this._ripples.flatMap((r) => [r.x, r.y, (t - r.t) / 1000, this.num('strength', 1)]),
+                extra: kind === 'post' ? { u_intensity: clamp(this.num('intensity', 0.6), 0, 1) } : undefined,
             });
         }
         mount() {
             this.removeAttribute('data-fallback');
             const custom = this.querySelector('script[type="x-shader/x-fragment"]');
-            const frag = kind === 'shader' ? custom?.textContent || this.str('preset', 'gradient') : kind;
+            const frag = kind === 'shader' ? custom?.textContent || this.str('preset', 'gradient') : kind === 'post' ? postFxShader(this.str('effects', 'vignette grain').split(/[\s,]+/)) : kind;
             const img = kind === 'shader' ? null : this.querySelector('img');
             if (kind !== 'shader' && !img)
                 return this.fallback('no-image');
@@ -9120,7 +9301,7 @@ function make(kind) {
                 }
             };
             const draw = () => {
-                q.resize();
+                q.resize(this._scale);
                 this.frame();
             };
             if (img && !(img.complete && img.naturalWidth)) {
@@ -9134,7 +9315,7 @@ function make(kind) {
             this.setAttribute('data-active', '');
             this.onCleanup(() => this.removeAttribute('data-active'));
             draw();
-            if (kind !== 'shader') {
+            if (kind === 'distort' || kind === 'liquid') {
                 const pos = (e) => {
                     const r = this.getBoundingClientRect();
                     this._mouse = [clamp((e.clientX - r.left) / (r.width || 1), 0, 1), clamp(1 - (e.clientY - r.top) / (r.height || 1), 0, 1)];
@@ -9151,7 +9332,7 @@ function make(kind) {
             // 4.0.1: also follow the element's own size (grid reflow, card expand…)
             if (typeof ResizeObserver !== 'undefined') {
                 const ro = new ResizeObserver(() => {
-                    q.resize();
+                    q.resize(this._scale);
                     if (!this._id)
                         this.frame();
                 });
@@ -9160,9 +9341,20 @@ function make(kind) {
             }
             if (this.reduced)
                 return; // one static frame, no loop
+            // 4.8 adaptive quality: fps-driven resolution steps + battery saver frame cap
+            const gov = glGovernor();
+            const auto = this.str('quality', 'auto') !== 'high';
+            gov.onScale = (sc) => {
+                this._scale = sc;
+                this.setAttribute('data-quality', String(sc));
+                q.resize(sc);
+            };
+            if (auto)
+                this.onCleanup(watchPowerSaver((saver) => ((gov.saver = saver), gov.onScale?.(gov.scale))));
             let visible = false;
             const loop = () => {
-                this.frame();
+                if (!auto || gov.tick(now()))
+                    this.frame();
                 this._id = raf(loop);
             };
             const sync = () => {
@@ -9173,7 +9365,7 @@ function make(kind) {
             };
             this.inView((v) => ((visible = v), sync()));
             this.listen(document, 'visibilitychange', sync);
-            this.listen(window, 'resize', () => q.resize(), { passive: true });
+            this.listen(window, 'resize', () => q.resize(this._scale), { passive: true });
             this.onCleanup(() => caf(this._id));
         }
     };
@@ -9201,6 +9393,16 @@ function defineDistort(tag = 'usa-distort') {
 function defineLiquid(tag = 'usa-liquid') {
     return defineElement(tag, make('liquid'), { id: 'webgl', text: css$2 });
 }
+/**
+ * `<usa-post-fx effects="vignette grain crt" intensity="0.6">` — GPU
+ * post-processing over the `<img>` inside (4.8): `vignette` · `grain` ·
+ * `chromatic` · `scanlines` · `crt` · `bloom` · `pixelate` · `duotone` ·
+ * `glitch`, chained in order. `quality="high"` disables adaptive quality.
+ * Fallback: the image with an approximate CSS filter.
+ */
+function definePostFx(tag = 'usa-post-fx') {
+    return defineElement(tag, make('post'), { id: 'webgl', text: css$2 });
+}
 
 /**
  * use-scroll-animate/components/webgl — lightweight canvas / WebGL (v3.4).
@@ -9213,6 +9415,7 @@ function defineWebglComponents() {
     defineShader();
     defineDistort();
     defineLiquid();
+    definePostFx();
 }
 
 var css$1 = "";
@@ -9876,6 +10079,40 @@ function definePacksComponents() {
     definePack();
 }
 
+/**
+ * 4.9 — the 5.0 modern-browser baseline. `baselineReport()` lists which
+ * required / progressive features this browser has; `warnBaseline()` logs
+ * once in development when a required one is missing.
+ */
+/** Required in 5.0: Custom Elements, WAAPI, IntersectionObserver, ResizeObserver, adoptedStyleSheets. Progressive: View Transitions, scroll-driven animations, WebGL. */
+function baselineReport() {
+    const w = (typeof window !== 'undefined' ? window : {});
+    const d = (typeof document !== 'undefined' ? document : {});
+    const css = (q) => typeof w.CSS?.supports === 'function' && w.CSS.supports(q);
+    return [
+        { id: 'custom-elements', required: true, supported: !!w.customElements },
+        { id: 'web-animations', required: true, supported: typeof w.Element?.prototype?.animate === 'function' },
+        { id: 'intersection-observer', required: true, supported: typeof w.IntersectionObserver === 'function' },
+        { id: 'resize-observer', required: true, supported: typeof w.ResizeObserver === 'function' },
+        { id: 'adopted-stylesheets', required: true, supported: 'adoptedStyleSheets' in d },
+        { id: 'view-transitions', required: false, supported: typeof d.startViewTransition === 'function' },
+        { id: 'scroll-driven-animations', required: false, supported: css('animation-timeline: view()') },
+        { id: 'webgl', required: false, supported: !!(d.createElement && (() => { try {
+                return d.createElement('canvas').getContext('webgl');
+            }
+            catch {
+                return null;
+            } })()) },
+    ];
+}
+/** Log (once) which required 5.0 features are missing here. Returns the missing ids. */
+function warnBaseline() {
+    const missing = baselineReport().filter((f) => f.required && !f.supported).map((f) => f.id);
+    if (missing.length)
+        deprecate('baseline', `this browser lacks ${missing.join(', ')}; use-scroll-animate 5.0 requires them (modern-browser baseline, see docs/upgrading-5.md).`);
+    return missing;
+}
+
 /**
  * use-scroll-animate/components/a11y — accessibility toolkit (4.4).
  *
@@ -10312,6 +10549,7 @@ exports.CARD_EFFECTS = CARD_EFFECTS;
 exports.CLICK_EFFECTS = CLICK_EFFECTS;
 exports.COMPONENT_CATEGORIES = COMPONENT_CATEGORIES;
 exports.CURSOR_MODES = CURSOR_MODES;
+exports.GL_FALLBACKS = GL_FALLBACKS;
 exports.JOINING_SCRIPT = JOINING_SCRIPT;
 exports.LIVE_REGION_IDS = LIVE_REGION_IDS;
 exports.MASK_SHAPES = MASK_SHAPES;
@@ -10323,6 +10561,8 @@ exports.MOTION_TOKENS = MOTION_TOKENS;
 exports.PACKS = PACKS;
 exports.PACK_PRIMITIVES = PACK_PRIMITIVES;
 exports.PAGE_EFFECTS = PAGE_EFFECTS;
+exports.PARTICLE_PRESETS = PARTICLE_PRESETS;
+exports.POST_EFFECTS = POST_EFFECTS;
 exports.REVEAL_EFFECTS = REVEAL_EFFECTS;
 exports.SENSITIVITY_CSS = SENSITIVITY_CSS;
 exports.SHADERS = SHADERS;
@@ -10344,6 +10584,7 @@ exports.applyPack = applyPack;
 exports.auditMotionA11y = auditMotionA11y;
 exports.autoAnimate = autoAnimate;
 exports.autoDegrade = autoDegrade;
+exports.baselineReport = baselineReport;
 exports.burst = burst;
 exports.categoryOf = categoryOf;
 exports.confetti = confetti;
@@ -10417,6 +10658,7 @@ exports.defineParticles = defineParticles;
 exports.definePhysicsComponents = definePhysicsComponents;
 exports.definePinchZoom = definePinchZoom;
 exports.definePopover = definePopover;
+exports.definePostFx = definePostFx;
 exports.definePress = definePress;
 exports.defineProgress = defineProgress;
 exports.definePullRefresh = definePullRefresh;
@@ -10471,6 +10713,8 @@ exports.gesture = gesture;
 exports.getMotionIntensity = getMotionIntensity;
 exports.getMotionSensitivity = getMotionSensitivity;
 exports.getMotionTokens = getMotionTokens;
+exports.glFallbackCss = glFallbackCss;
+exports.glGovernor = glGovernor;
 exports.glQuad = glQuad;
 exports.graphemes = graphemes;
 exports.haptic = haptic;
@@ -10500,6 +10744,7 @@ exports.parseEasing = parseEasing;
 exports.parseNativeSettings = parseNativeSettings;
 exports.pathsCompatible = pathsCompatible;
 exports.pinchScale = pinchScale;
+exports.postFxShader = postFxShader;
 exports.postToNative = postToNative;
 exports.prefersReducedMotion = prefersReducedMotion;
 exports.projectInertia = projectInertia;
@@ -10544,4 +10789,6 @@ exports.themeTransition = themeTransition;
 exports.timeline = timeline;
 exports.toast = toast;
 exports.viewTransition = viewTransition;
+exports.warnBaseline = warnBaseline;
+exports.watchPowerSaver = watchPowerSaver;
 //# sourceMappingURL=lite.cjs.map