@cosmictraveler002/anim-kit 1.4.0 → 1.6.0

package/dist/three/wordmark-wave.js

@@ -0,0 +1,461 @@
+/**
+ * Wordmark wave — the giant wordmark that ripples under the pointer and
+ * throws red/cyan chromatic fringes while it deforms.
+ *
+ * The whole effect is one deformable plane textured with the wordmark drawn
+ * from the target's own text and font — no bundled typeface, no baked mesh:
+ *
+ * - **The sim runs on the CPU, per vertex** (a ~5 k-vertex grid is nothing
+ *   at 60 Hz), stepping the reference's frame constants verbatim: pointer
+ *   falloff `1/(1 + d/0.05) − 0.1`, a `0.02` pointer-velocity "drag" term,
+ *   a `0.1` spring back to rest, `0.9` damping, `0.1` integration scale.
+ *   The step is fixed at 1/60 s (accumulated, max 4 per frame) so the
+ *   physics are identical on 60/120/144 Hz displays; pointer velocity is
+ *   measured per frame, folded to 1/60 s after a stall and zeroed above
+ *   10 units/s (teleport guard).
+ * - **The chroma is three additive draws, not a post effect.** The same
+ *   geometry renders once per channel with the displacement scaled
+ *   0.9 / 1.0 / 1.1 — at rest the passes coincide and the wordmark is solid;
+ *   wherever the mesh moves the channels separate into red/cyan fringes.
+ *   (Light base colours only — a saturated colour kills its own channels.)
+ * - **Normalized space.** Positions, cursor and falloff live in half-width
+ *   units (x ∈ [−1, 1], y ∈ [−h/w, h/w]) so waves stay circles on screen at
+ *   any element aspect; the vertex shader converts y to NDC with one aspect
+ *   multiply.
+ * - **Silent no-op ladder.** Missing target / empty text → no-op. No WebGL
+ *   (SSR, jsdom, disabled) → no-op before any context is requested.
+ *   Renderer construction throws → no-op. Off-screen → the ticker idles
+ *   (IntersectionObserver) and a settled wordmark stops stepping entirely.
+ *   Under `prefers-reduced-motion` nothing mounts — the real text simply
+ *   stays visible (it is only hidden while the effect owns it).
+ * - **Fidelity.** `destroy()` restores the text colour and the inline
+ *   position, removes the canvas, listeners and observers, and disposes
+ *   geometry, materials, texture and renderer.
+ *
+ *   wordmarkWave("[data-wordmark]", { outline: 3, tracking: 8 });
+ *
+ * CSS: the target holds a single line of text; it is hidden (colour
+ * transparent) while mounted and re-drawn centred in its own box. Style the
+ * font there — the effect inherits it.
+ */
+import * as THREE from "three";
+import { gsap, initGSAP } from "../core/gsap.js";
+import { guard } from "../core/guard.js";
+import { one } from "../core/util.js";
+/* Reference frame constants — the sim is stepped at a fixed 60 Hz so these
+   stay exactly as measured, whatever the display's refresh rate. */
+const FALLOFF = 0.05; // pointer falloff radius, half-width units
+const FLOOR = 0.1; // strength = 1/(1+d/FALLOFF) − FLOOR, clamped
+const REACH = FALLOFF * (1 / FLOOR - 1); // where strength hits 0 → 0.45
+const DRAG_K = 0.02; // pointer-velocity term
+const SPRING = 0.1; // return-to-rest term
+const DAMP = 0.9; // velocity damping per step
+const INTEG = 0.1; // displacement per velocity per step
+const STEP = 1 / 60; // fixed sim step, seconds
+const MAX_STEPS = 4; // accumulated steps allowed per frame
+const V_CLAMP = 10; // pointer speed above which the delta is discarded
+const SETTLE_EPS = 1e-4; // |disp|/|vel| below which the sim sleeps
+const VERT = /* glsl */ `
+attribute vec2 aDisp;     // sim displacement, half-width units
+uniform float uDispScale; // chroma pass multiplier: 0.9 / 1.0 / 1.1
+uniform float uAspect;    // w/h — sim y to NDC (y extent is h/w)
+varying vec2 vUv;
+
+void main() {
+  vUv = uv;
+  vec2 p = position.xy + aDisp * uDispScale;
+  gl_Position = vec4(p.x, p.y * uAspect, 0.0, 1.0);
+}
+`;
+/* Chroma pass: premultiplied rgb, alpha = opacity/3. The three passes add up
+   to base * coverage * opacity at rest; where only one channel reaches, the
+   fringe sits at a third of the coverage — brighter than its alpha says,
+   which is exactly the additive look the reference has. */
+const CHROMA_FRAG = /* glsl */ `
+precision highp float;
+uniform sampler2D uMap;
+uniform vec3 uPass; // channel * base colour
+uniform float uOpacity;
+varying vec2 vUv;
+
+void main() {
+  float a = texture2D(uMap, vUv).a;
+  if (a <= 0.002) discard;
+  gl_FragColor = vec4(uPass * a * uOpacity, a * uOpacity / 3.0);
+}
+`;
+/* Single pass (chroma: false): straight alpha, like every other overlay. */
+const PLAIN_FRAG = /* glsl */ `
+precision highp float;
+uniform sampler2D uMap;
+uniform vec3 uPass;
+uniform float uOpacity;
+varying vec2 vUv;
+
+void main() {
+  float a = texture2D(uMap, vUv).a;
+  if (a <= 0.002) discard;
+  gl_FragColor = vec4(uPass, a * uOpacity);
+}
+`;
+export function wordmarkWave(target, options = {}) {
+    initGSAP();
+    const host = one(target);
+    if (!host)
+        return () => { };
+    const text = (options.text ?? host.textContent ?? "").trim().replace(/\s+/g, " ");
+    if (!text)
+        return () => { };
+    const { color, opacity = 1, outline = 0, tracking = 0, drag = 1, push = 0, chroma = true, dpr = 2, segments = 0, z = 1, } = options;
+    return guard(options, () => {
+        /* ---------------- availability ladder (silent, no probes) ---------------- */
+        if (typeof window === "undefined" || !("WebGLRenderingContext" in window))
+            return () => { };
+        let renderer;
+        try {
+            renderer = new THREE.WebGLRenderer({ alpha: true, antialias: false });
+        }
+        catch {
+            return () => { }; // context refused — the plain text simply stays
+        }
+        /* --------------- the font + colour live on the element ------------------ */
+        const computed = getComputedStyle(host);
+        const family = computed.fontFamily;
+        const weight = computed.fontWeight;
+        const style = computed.fontStyle;
+        const variant = computed.fontVariant;
+        const size0 = parseFloat(computed.fontSize) || 16;
+        const baseColor = color || computed.color || "#ffffff";
+        const pass = new THREE.Color(baseColor);
+        /* ---------------- layout + styles we must restore ---------------- */
+        const prevPosition = host.style.position;
+        if (!prevPosition && computed.position === "static")
+            host.style.position = "relative";
+        const prevColor = host.style.color;
+        host.style.color = "transparent"; // the canvas owns the pixels now
+        let w = Math.max(1, host.clientWidth);
+        let h = Math.max(1, host.clientHeight);
+        renderer.setPixelRatio(Math.min(window.devicePixelRatio || 1, dpr));
+        renderer.setSize(w, h, false);
+        renderer.setClearColor(0x000000, 0);
+        const canvas = renderer.domElement;
+        canvas.style.cssText = `position:absolute;inset:0;width:100%;height:100%;display:block;pointer-events:none;z-index:${z};`;
+        const scene = new THREE.Scene();
+        const camera = new THREE.OrthographicCamera(-1, 1, 1, -1, -1, 1);
+        /* ---------------- the wordmark texture ---------------- */
+        const texCanvas = document.createElement("canvas");
+        const ctx = texCanvas.getContext("2d");
+        let texture = null;
+        /* The font: the target's computed shorthand by default; options.font
+           verbatim when the canvas accepts it (px sizes are never rewritten —
+           a rejected value falls back to the computed one). */
+        const applyFont = () => {
+            const fallback = `${style} ${variant} ${weight} ${size0}px ${family}`;
+            const cand = options.font || fallback;
+            ctx.font = "1px monospace"; // sentinel: survives a rejected assignment
+            ctx.font = cand;
+            if (ctx.font === "1px monospace")
+                ctx.font = fallback;
+        };
+        const drawText = () => {
+            const capDpr = Math.min(window.devicePixelRatio || 1, dpr);
+            texCanvas.width = Math.max(1, Math.round(w * capDpr));
+            texCanvas.height = Math.max(1, Math.round(h * capDpr));
+            ctx.setTransform(capDpr, 0, 0, capDpr, 0, 0);
+            ctx.clearRect(0, 0, w, h);
+            applyFont();
+            ctx.textBaseline = "middle";
+            ctx.fillStyle = "#ffffff";
+            ctx.strokeStyle = "#ffffff";
+            ctx.lineWidth = outline;
+            /* Letter spacing: native where it exists (Chromium 99+, FF 128+),
+               manual elsewhere. typeof keeps this a runtime probe — an `in` check
+               would narrow ctx to never (the property is in the type lib). */
+            const canTrack = typeof ctx.letterSpacing === "string";
+            if (tracking && canTrack)
+                ctx.letterSpacing = `${tracking}px`;
+            const chars = [...text];
+            const manual = tracking > 0 && !canTrack;
+            const trackW = manual ? tracking * (chars.length - 1) : 0;
+            const m = ctx.measureText(text);
+            const inkH = isFinite(m.actualBoundingBoxAscent) && isFinite(m.actualBoundingBoxDescent)
+                ? m.actualBoundingBoxAscent + m.actualBoundingBoxDescent
+                : size0 * 1.2;
+            /* Fit-to-box on both axes: scale the whole drawing (font, stroke,
+               tracking) rather than parsing sizes out of arbitrary shorthands.
+               Padding leaves the stroke room to breathe at the edges. */
+            const padW = Math.min(16, w * 0.06) + outline;
+            const padH = Math.min(12, h * 0.06) + outline;
+            const fw = m.width + trackW > 0 ? (w - padW) / (m.width + trackW) : 1;
+            const fh = inkH > 0 ? (h - padH) / inkH : 1;
+            const f = Math.max(0.05, Math.min(1, fw, fh));
+            ctx.save();
+            ctx.translate(w / 2, h / 2);
+            ctx.scale(f, f);
+            const paint = () => (outline > 0 ? ctx.strokeText(text, 0, 0) : ctx.fillText(text, 0, 0));
+            if (!manual) {
+                ctx.textAlign = "center";
+                paint();
+            }
+            else {
+                /* Manual tracking: left-align each glyph on a running cursor. */
+                const widths = chars.map((c) => ctx.measureText(c).width);
+                const total = widths.reduce((a, b) => a + b, 0) + trackW;
+                ctx.textAlign = "left";
+                let x = -total / 2;
+                chars.forEach((c, i) => {
+                    if (outline > 0)
+                        ctx.strokeText(c, x, 0);
+                    else
+                        ctx.fillText(c, x, 0);
+                    x += widths[i] + tracking;
+                });
+            }
+            ctx.restore();
+        };
+        const buildTexture = () => {
+            drawText();
+            if (texture)
+                texture.dispose();
+            texture = new THREE.CanvasTexture(texCanvas);
+            texture.minFilter = THREE.LinearFilter;
+            texture.magFilter = THREE.LinearFilter;
+            texture.generateMipmaps = false;
+            /* Uniform values are read every render — no material.needsUpdate,
+               which would recompile the program on every resize. */
+            for (const m of materials) {
+                m.uniforms.uMap.value = texture;
+                m.uniforms.uAspect.value = w / Math.max(1, h);
+            }
+        };
+        /* ---------------- materials + the three chroma passes ---------------- */
+        const passColors = chroma
+            ? [new THREE.Color(pass.r, 0, 0), new THREE.Color(0, pass.g, 0), new THREE.Color(0, 0, pass.b)]
+            : [pass];
+        const passScales = chroma ? [0.9, 1, 1.1] : [1];
+        const materials = passColors.map((pc, i) => new THREE.ShaderMaterial({
+            vertexShader: VERT,
+            fragmentShader: chroma ? CHROMA_FRAG : PLAIN_FRAG,
+            uniforms: {
+                uMap: { value: null },
+                uPass: { value: pc },
+                uOpacity: { value: opacity },
+                uDispScale: { value: passScales[i] },
+                uAspect: { value: w / Math.max(1, h) },
+            },
+            transparent: true,
+            depthTest: false,
+            depthWrite: false,
+            blending: chroma ? THREE.CustomBlending : THREE.NormalBlending,
+            blendSrc: THREE.OneFactor,
+            blendDst: THREE.OneFactor,
+            blendEquation: THREE.AddEquation,
+        }));
+        /* ---------------- grid + sim state ---------------- */
+        let geometry;
+        let meshes = [];
+        let disp = new Float32Array(0); // x,y displacement
+        let vel = new Float32Array(0); // x,y velocity
+        let verts = 0;
+        const buildGrid = () => {
+            geometry?.dispose();
+            for (const m of meshes)
+                scene.remove(m);
+            const cols = segments > 0 ? Math.round(segments) : Math.min(160, Math.max(40, Math.round(w / 10)));
+            const cell = w / cols;
+            const rows = Math.min(96, Math.max(8, Math.round(h / cell)));
+            /* Half-width space: x spans ±1, y spans ±h/w (isotropic units). */
+            geometry = new THREE.PlaneGeometry(2, (2 * h) / w, cols, rows);
+            verts = geometry.attributes.position.count;
+            disp = new Float32Array(verts * 2);
+            vel = new Float32Array(verts * 2);
+            const attr = new THREE.BufferAttribute(disp, 2);
+            attr.setUsage(THREE.DynamicDrawUsage);
+            geometry.setAttribute("aDisp", attr);
+            meshes = passColors.map((_, i) => {
+                const mesh = new THREE.Mesh(geometry, materials[i]);
+                mesh.frustumCulled = false; // the shader moves the verts
+                scene.add(mesh);
+                return mesh;
+            });
+        };
+        buildTexture();
+        buildGrid();
+        host.appendChild(canvas);
+        /* ---------------- pointer + sim ---------------- */
+        const cursor = { x: 0, y: 0 };
+        const prevCursor = { x: 0, y: 0 };
+        let hasCursor = false;
+        let settled = true;
+        let needsRender = true;
+        let acc = 0;
+        const toSim = (cx, cy, rect) => {
+            const rw = Math.max(1, rect.width);
+            const rh = Math.max(1, rect.height);
+            return { x: (cx / rw) * 2 - 1, y: (1 - (cy / rh) * 2) * (rh / rw) };
+        };
+        const onMove = (e) => {
+            const rect = host.getBoundingClientRect();
+            const p = toSim(e.clientX - rect.left, e.clientY - rect.top, rect);
+            if (!hasCursor) {
+                prevCursor.x = p.x; // first sighting: no delta from the origin
+                prevCursor.y = p.y;
+                hasCursor = true;
+            }
+            cursor.x = p.x;
+            cursor.y = p.y;
+            /* Outside the box + reach nothing can move — don't wake the sim. */
+            const dx = Math.max(0, Math.abs(p.x) - 1);
+            const dy = Math.max(0, Math.abs(p.y) - h / Math.max(1, w));
+            if (Math.hypot(dx, dy) < REACH + 0.05)
+                settled = false;
+        };
+        window.addEventListener("pointermove", onMove, { passive: true });
+        /* One fixed 1/60 s step — mirrors the reference's transform-feedback
+           shader: velocity += drag + spring + push, damping, integrate, clamp. */
+        const step = (vx, vy) => {
+            const rest = geometry.attributes.position.array;
+            const stride = geometry.attributes.position.itemSize; // 3: x,y,z
+            let maxD = 0;
+            let maxV = 0;
+            for (let i = 0; i < verts; i++) {
+                const ix = i * 2;
+                const iy = ix + 1;
+                const rx = i * stride;
+                /* cursorToPos: from the cursor to the vertex's current position */
+                const ox = rest[rx] + disp[ix] - cursor.x;
+                const oy = rest[rx + 1] + disp[iy] - cursor.y;
+                const dist = Math.hypot(ox, oy);
+                let strength = 1 / (1 + dist / FALLOFF) - FLOOR;
+                if (strength <= 0)
+                    strength = 0;
+                else if (strength > 1)
+                    strength = 1;
+                vel[ix] =
+                    (vel[ix] + vx * DRAG_K * strength * drag - disp[ix] * SPRING + ox * strength * push) * DAMP;
+                vel[iy] =
+                    (vel[iy] + vy * DRAG_K * strength * drag - disp[iy] * SPRING + oy * strength * push) * DAMP;
+                disp[ix] += vel[ix] * INTEG;
+                disp[iy] += vel[iy] * INTEG;
+                disp[ix] = disp[ix] > 1 ? 1 : disp[ix] < -1 ? -1 : disp[ix];
+                disp[iy] = disp[iy] > 1 ? 1 : disp[iy] < -1 ? -1 : disp[iy];
+                vel[ix] = vel[ix] > 1 ? 1 : vel[ix] < -1 ? -1 : vel[ix];
+                vel[iy] = vel[iy] > 1 ? 1 : vel[iy] < -1 ? -1 : vel[iy];
+                const ad = Math.abs(disp[ix]) + Math.abs(disp[iy]);
+                const av = Math.abs(vel[ix]) + Math.abs(vel[iy]);
+                if (ad > maxD)
+                    maxD = ad;
+                if (av > maxV)
+                    maxV = av;
+            }
+            /* Asleep only when every vertex is back at rest: strength is 0 beyond
+               REACH anyway, so a pointer moving elsewhere can't wake it — onMove
+               does that when it comes back within reach. */
+            if (maxD < SETTLE_EPS && maxV < SETTLE_EPS)
+                settled = true;
+        };
+        const render = () => {
+            geometry.attributes.aDisp.needsUpdate = true;
+            renderer.render(scene, camera);
+            needsRender = false;
+        };
+        /* ---------------- visibility gate ---------------- */
+        let visible = true;
+        let io = null;
+        if (typeof IntersectionObserver === "function") {
+            io = new IntersectionObserver(([entry]) => {
+                const was = visible;
+                visible = entry.isIntersecting;
+                if (visible && !was)
+                    needsRender = true;
+            }, { rootMargin: "80px" });
+            io.observe(host);
+        }
+        /* ---------------- ticker: frame velocity + fixed-step sim ---------------- */
+        const tick = (_t, deltaMs) => {
+            let dt = deltaMs / 1000;
+            if (!(dt > 0))
+                dt = STEP;
+            if (dt > 0.2)
+                dt = STEP; // a stalled tab folds into one clean step
+            /* Pointer velocity is a per-frame quantity: cursor - last frame's.
+               Consumed every frame — even off-screen — so a delta accumulated
+               while hidden never lands as one phantom impulse on re-entry. */
+            let vx = 0;
+            let vy = 0;
+            if (hasCursor) {
+                vx = (cursor.x - prevCursor.x) / dt;
+                vy = (cursor.y - prevCursor.y) / dt;
+                if (Math.hypot(vx, vy) > V_CLAMP) {
+                    vx = 0;
+                    vy = 0;
+                }
+                prevCursor.x = cursor.x;
+                prevCursor.y = cursor.y;
+            }
+            if (!visible) {
+                needsRender = true;
+                return;
+            }
+            if (settled) {
+                if (needsRender)
+                    render();
+                return;
+            }
+            acc += dt;
+            let n = Math.floor(acc / STEP);
+            if (n > MAX_STEPS)
+                n = MAX_STEPS;
+            acc -= n * STEP;
+            if (n <= 0) {
+                if (needsRender)
+                    render();
+                return;
+            }
+            for (let i = 0; i < n; i++)
+                step(vx, vy);
+            render();
+        };
+        gsap.ticker.add(tick);
+        /* ---------------- resize ---------------- */
+        let ro = null;
+        const resize = () => {
+            const rw = Math.max(1, host.clientWidth);
+            const rh = Math.max(1, host.clientHeight);
+            if (rw === w && rh === h)
+                return;
+            w = rw;
+            h = rh;
+            renderer.setSize(w, h, false);
+            buildTexture();
+            buildGrid();
+            settled = false;
+            needsRender = true;
+        };
+        /* ResizeObserver alone: a vw-sized host reflows on window resize too,
+           so the box change is always what actually needs the rebuild. */
+        if (typeof ResizeObserver === "function") {
+            ro = new ResizeObserver(resize);
+            ro.observe(host);
+        }
+        render(); // the rest state, before the pointer ever arrives
+        /* ---------------- teardown ---------------- */
+        return () => {
+            gsap.ticker.remove(tick);
+            window.removeEventListener("pointermove", onMove);
+            io?.disconnect();
+            ro?.disconnect();
+            for (const m of meshes)
+                scene.remove(m);
+            geometry.dispose();
+            for (const m of materials)
+                m.dispose();
+            texture?.dispose();
+            renderer.dispose();
+            canvas.remove();
+            host.style.color = prevColor;
+            host.style.position = prevPosition;
+        };
+    });
+}
+//# sourceMappingURL=wordmark-wave.js.map

package/dist/three/wordmark-wave.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wordmark-wave.js","sourceRoot":"","sources":["../../src/three/wordmark-wave.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmictraveler002/anim-kit",
-  "version": "1.4.0",
+  "version": "1.6.0",
   "description": "Modular, framework-agnostic animation library — GSAP + ScrollTrigger + Lenis effects packaged as composable ES modules.",
   "type": "module",
   "main": "./dist/index.js",

package/src/core/smooth-scroll.ts

@@ -4,10 +4,14 @@
  * Uses the canonical Lenis + GSAP recipe:
  *   lenis.on("scroll", ScrollTrigger.update)
  *   gsap.ticker.add(t => lenis.raf(t * 1000))
- *   gsap.ticker.lagSmoothing(0)
  *
  * Driving Lenis from GSAP's ticker (rather than its own rAF) keeps both
  * clocks on the same frame, which is what stops ScrollTrigger from stuttering.
+ * Those ticker callbacks receive the *same* adjusted clock the tweens run on,
+ * so GSAP's lag smoothing is deliberately left on: a stalled frame (GC pause,
+ * buffer tick) advances one short step everywhere instead of snapping the
+ * scroll and every scroll-linked tween to a new time at once. See
+ * SmoothScrollOptions.lagSmoothing to retune it or restore the old opt-out.
  *
  * `useScrollerProxy: true` additionally proxies `document.documentElement`,
  * matching kalakritico.in's setup — only needed if you scroll a nested
@@ -31,6 +35,27 @@ export interface SmoothScrollOptions extends CommonOptions {
   initialScroll?: number;
   /** Proxy documentElement through ScrollTrigger (nested scrollers). @default false */
   useScrollerProxy?: boolean;
+  /** Touch-drag sensitivity — forwarded to Lenis `touchMultiplier`. @default 1 */
+  touchMultiplier?: number;
+  /** Mouse-wheel sensitivity — forwarded to Lenis `wheelMultiplier`. @default 1 */
+  wheelMultiplier?: number;
+  /**
+   * GSAP lag smoothing on the shared ticker: a frame longer than `threshold`
+   * advances only `adjustedLag` ms, so a hitch can't teleport the scroll and
+   * every scroll-linked tween in one jump.
+   *
+   * - `undefined` — leave GSAP's setup alone; its built-in compensation
+   *   (500ms → 33ms) stays active.
+   * - `false` — disable lag smoothing (anim-kit ≤1.4 behaviour, what the
+   *   Lenis README recipe asks for): timing stays exactly wall-clock, but
+   *   every frame longer than the threshold snaps.
+   * - `{ threshold, adjustedLag }` — retune it. Lower the threshold (e.g.
+   *   `150`) to smooth short mobile hitches; raise it if slow devices should
+   *   keep real-time speed instead of briefly running slow-motion.
+   *
+   * `destroy()` restores GSAP's default (500/33) whenever this was set.
+   */
+  lagSmoothing?: false | { threshold?: number; adjustedLag?: number };
 }
 
 export interface SmoothScrollHandle {
@@ -61,6 +86,9 @@ export function smoothScroll(options: SmoothScrollOptions = {}): SmoothScrollHan
     orientation = "vertical",
     initialScroll = 0,
     useScrollerProxy = false,
+    touchMultiplier,
+    wheelMultiplier,
+    lagSmoothing,
   } = options;
 
   if (typeof window === "undefined") return INERT;
@@ -74,6 +102,9 @@ export function smoothScroll(options: SmoothScrollOptions = {}): SmoothScrollHan
     syncTouch: smoothTouch,
     orientation,
     autoRaf: false,
+    // undefined falls through to Lenis's own defaults (1 / 1).
+    touchMultiplier,
+    wheelMultiplier,
   });
 
   if (initialScroll) lenis.scrollTo(initialScroll, { immediate: true });
@@ -85,7 +116,17 @@ export function smoothScroll(options: SmoothScrollOptions = {}): SmoothScrollHan
   // 2. Run Lenis off GSAP's ticker so both share one frame clock.
   const tick = (time: number) => lenis.raf(time * 1000);
   gsap.ticker.add(tick);
-  gsap.ticker.lagSmoothing(0);
+
+  // Lag smoothing drives *one* clock — the tweens' and this ticker's alike —
+  // so leaving GSAP's compensation on turns a stalled frame into one short
+  // step everywhere instead of a snap. Only touch the ticker when asked, so a
+  // host page's own setup is never clobbered.
+  let lagTouched = false;
+  if (lagSmoothing !== undefined) {
+    lagTouched = true;
+    if (lagSmoothing === false) gsap.ticker.lagSmoothing(0);
+    else gsap.ticker.lagSmoothing(lagSmoothing.threshold ?? 500, lagSmoothing.adjustedLag ?? 33);
+  }
 
   // 3. Optional: proxy the scroller (for nested/element scrollers).
   if (useScrollerProxy) {
@@ -126,6 +167,7 @@ export function smoothScroll(options: SmoothScrollOptions = {}): SmoothScrollHan
     window.removeEventListener("resize", onResize);
     window.removeEventListener("load", refresh);
     gsap.ticker.remove(tick);
+    if (lagTouched) gsap.ticker.lagSmoothing(500, 33); // undo our change — GSAP's default
     lenis.off("scroll", onScroll);
     if (useScrollerProxy) {
       ScrollTrigger.scrollerProxy(document.documentElement, {} as never);

package/src/effects/horizontal-scroll.ts

@@ -68,6 +68,9 @@ export function horizontalScroll(
       scrollTrigger: {
         trigger: section,
         pin: true,
+        // Refresh pins first (creation order ≠ document order): our spacer must
+        // exist before triggers below us measure, or they start ~9k px early.
+        refreshPriority: 1,
         scrub,
         end: () => "+=" + travel(),
         invalidateOnRefresh: true,