@cosmictraveler002/anim-kit 1.4.0 → 1.6.0

package/dist/three/tear-reveal.js

@@ -0,0 +1,269 @@
+/**
+ * Tear reveal — a torn-edge sheet that sweeps a section in (or out).
+ *
+ * A noise-displaced boundary travels across the overlay: the fbm is added to
+ * the field *before* thresholding, so patches of the sheet tear away ahead of
+ * the front and ride across as separate shards. A barrel warp (`lens`) bows
+ * the boundary so it arrives as a curve — flat in the middle, sweeping at the
+ * edges — instead of a straight line wobbling in place.
+ *
+ * The sheet paints a flat colour or a two-stop gradient and can run
+ * `mix-blend-mode` (multiply tints the section's own artwork darker-red;
+ * normal covers it outright).
+ *
+ * Modes mirror clipWipe:
+ *   mode "scroll"   plays once when the section enters (default)
+ *   scrub           progress follows the scroll, so stopping half way leaves
+ *                   a half-torn screen — a real place to be, not a glitch
+ *
+ * Works as a page-sized overlay too: give it `document.body` with
+ * `position: fixed` styling via the `fixed` option for a fullscreen sweep.
+ *
+ * No WebGL (SSR, jsdom, disabled) → silent no-op; destroy() removes the
+ * canvas and restores the host's styles.
+ */
+import * as THREE from "three";
+import { gsap, ScrollTrigger, initGSAP } from "../core/gsap.js";
+import { guard } from "../core/guard.js";
+import { one } from "../core/util.js";
+const VERT = /* glsl */ `
+varying vec2 vUv;
+void main() {
+  vUv = uv;
+  gl_Position = projectionMatrix * modelViewMatrix * vec4(position, 1.0);
+}
+`;
+const FRAG = /* glsl */ `
+precision highp float;
+varying vec2 vUv;
+uniform float uP, uTime, uAspect, uOut, uLens, uDir;
+uniform float uDispAmp, uDispScale, uDispDrift, uSoft;
+uniform int uDetail;
+uniform vec3 uTop, uFoot;
+
+float hash(vec2 p){ return fract(sin(dot(p, vec2(127.1, 311.7))) * 43758.5453); }
+float vnoise(vec2 p){
+  vec2 i = floor(p), f = fract(p);
+  vec2 u = f * f * (3.0 - 2.0 * f);
+  return mix(mix(hash(i), hash(i + vec2(1,0)), u.x),
+             mix(hash(i + vec2(0,1)), hash(i + vec2(1,1)), u.x), u.y);
+}
+float fbm(vec2 p, int oct){
+  float v = 0.0, a = 0.5;
+  for (int i = 0; i < 6; i++){
+    if (i >= oct) break;
+    v += a * vnoise(p); p *= 2.03; a *= 0.5;
+  }
+  return v;
+}
+
+/* Canonical sweep space: "along" grows toward the travel direction,
+   "cross" runs along the boundary. uDir: 0 up, 1 down, 2 left, 3 right. */
+vec2 sweepSpace(vec2 uv){
+  if (uDir < 0.5) return vec2(uv.x, uv.y);            /* up    : along = y  */
+  if (uDir < 1.5) return vec2(uv.x, 1.0 - uv.y);      /* down  : along = 1-y*/
+  if (uDir < 2.5) return vec2(uv.y, uv.x);            /* right : along = x  */
+  return vec2(uv.y, 1.0 - uv.x);                      /* left  : along = 1-x*/
+}
+
+void main(){
+  bool outside = false;
+  vec2 uv = vUv;
+  if (uLens != 0.0) {
+    vec2 d = uv - 0.5;
+    vec2 w = 0.5 + d * (1.0 + uLens * dot(d, d) * 4.0);
+    if (w.x < 0.0 || w.x > 1.0 || w.y < 0.0 || w.y > 1.0) outside = true;
+    uv = w;
+  }
+  /* Corners the warp threw out of frame clamp back in: a hole here would be
+     a see-through patch in a sheet meant to be closed. */
+  if (outside) uv = clamp(uv, 0.0, 1.0);
+
+  vec2 sc = sweepSpace(uv);
+  float along = sc.y;          /* 0 = where the sheet starts, 1 = far side  */
+  float cross = sc.x;
+
+  /* The torn boundary: noise joins the field before the threshold, so
+     patches cross zero early and ride ahead as detached shards. */
+  float edge = mix(-uDispAmp, 1.0 + uDispAmp, uP);
+  float n = fbm(vec2(cross * uAspect, along) * uDispScale +
+                vec2(0.0, uTime * uDispDrift), uDetail) - 0.5;
+  float field = (edge - along) + n * uDispAmp * 2.0;
+  /* field > 0 is the covered side; both ends of the travel are sealed so the
+     last half-covered pixels never read as speckle or leftover haze. */
+  float a = smoothstep(-uSoft, uSoft, field);
+  a = max(a, smoothstep(0.985, 1.0, uP));
+  a = max(a, step(0.999, uP));
+  /* uOut = 1 makes the sheet the part that is LEAVING: the same rising edge
+     goes on rising and clears the screen instead of reversing downhill. */
+  a = mix(a, 1.0 - a, uOut);
+  if (a <= 0.001) discard;
+
+  vec3 col = mix(uFoot, uTop, clamp(vUv.y, 0.0, 1.0));
+  gl_FragColor = vec4(col, a);
+}
+`;
+export function tearReveal(target, options = {}) {
+    initGSAP();
+    const host = one(target);
+    if (!host)
+        return () => { };
+    const { color = "#111111", blend = "none", direction = "up", dispAmp = 0.175, dispScale = 12.2, dispDetail = 5, dispDrift = 0, soft = 0.001, lens = -0.275, duration = 1, ease = "power2.inOut", mode = "scroll", start = "top 85%", end = "top 25%", replay = false, scrub, fixed = false, z = 1, dpr = 2, } = 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 section simply stays as it is
+        }
+        /* ---------------- layout + styles we must restore ---------------- */
+        const prevPosition = host.style.position;
+        if (!fixed && !prevPosition && getComputedStyle(host).position === "static") {
+            host.style.position = "relative";
+        }
+        const w = Math.max(1, fixed ? window.innerWidth : host.clientWidth);
+        const h = Math.max(1, fixed ? window.innerHeight : 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 = fixed
+            ? `position:fixed;inset:0;width:100%;height:100%;display:block;pointer-events:none;z-index:${z};`
+            : `position:absolute;inset:0;width:100%;height:100%;display:block;pointer-events:none;z-index:${z};`;
+        const stops = Array.isArray(color) ? color : [color, color];
+        const scene = new THREE.Scene();
+        const camera = new THREE.OrthographicCamera(-w / 2, w / 2, h / 2, -h / 2, -100, 100);
+        camera.position.z = 10;
+        const geometry = new THREE.PlaneGeometry(1, 1, 1, 1);
+        const uniforms = {
+            uP: { value: 0 },
+            uTime: { value: 0 },
+            uAspect: { value: direction === "up" || direction === "down" ? w / Math.max(1, h) : h / Math.max(1, w) },
+            uOut: { value: 0 },
+            uLens: { value: lens },
+            uDir: { value: direction === "up" ? 0 : direction === "down" ? 1 : direction === "right" ? 2 : 3 },
+            uDispAmp: { value: dispAmp },
+            uDispScale: { value: dispScale },
+            uDispDrift: { value: dispDrift },
+            uSoft: { value: soft },
+            uDetail: { value: dispDetail },
+            uTop: { value: new THREE.Color(stops[1]) },
+            uFoot: { value: new THREE.Color(stops[0]) },
+        };
+        const material = new THREE.ShaderMaterial({
+            vertexShader: VERT,
+            fragmentShader: FRAG,
+            uniforms,
+            transparent: true,
+            depthTest: false,
+            depthWrite: false,
+        });
+        const mesh = new THREE.Mesh(geometry, material);
+        mesh.scale.set(w, h, 1);
+        scene.add(mesh);
+        host.appendChild(canvas);
+        if (blend && blend !== "none")
+            canvas.style.mixBlendMode = blend;
+        const render = () => renderer.render(scene, camera);
+        /* ---------------- progress control (clipWipe's modes) ---------------- */
+        let tween = null;
+        let st = null;
+        let disposed = false;
+        const setP = (v) => {
+            uniforms.uP.value = v;
+            render();
+        };
+        if (scrub !== undefined) {
+            st = ScrollTrigger.create({
+                trigger: host,
+                start: fixed ? "top top" : start,
+                end: fixed ? "bottom bottom" : end,
+                scrub: scrub === true ? true : scrub,
+                onUpdate: (self) => setP(self.progress),
+            });
+            setP(st.progress);
+        }
+        else if (mode === "immediate") {
+            tween = gsap.to(uniforms.uP, {
+                value: 1,
+                duration,
+                ease,
+                onUpdate: render,
+            });
+        }
+        else {
+            st = ScrollTrigger.create({
+                trigger: host,
+                start,
+                end,
+                toggleActions: replay ? "play reverse play reverse" : "play none none none",
+                onEnter: () => {
+                    tween?.kill();
+                    tween = gsap.to(uniforms.uP, { value: 1, duration, ease, overwrite: true, onUpdate: render });
+                },
+                onLeaveBack: () => {
+                    if (!replay)
+                        return;
+                    tween?.kill();
+                    tween = gsap.to(uniforms.uP, { value: 0, duration, ease, overwrite: true, onUpdate: render });
+                },
+            });
+            render();
+        }
+        /* Drift only costs something when the pattern should crawl. */
+        const renderTime = () => {
+            uniforms.uTime.value = gsap.ticker.time;
+            render();
+        };
+        if (dispDrift > 0)
+            gsap.ticker.add(renderTime);
+        /* ---------------- resize ---------------- */
+        let ro = null;
+        const resize = () => {
+            const rw = Math.max(1, fixed ? window.innerWidth : host.clientWidth);
+            const rh = Math.max(1, fixed ? window.innerHeight : host.clientHeight);
+            renderer.setSize(rw, rh, false);
+            camera.left = -rw / 2;
+            camera.right = rw / 2;
+            camera.top = rh / 2;
+            camera.bottom = -rh / 2;
+            camera.updateProjectionMatrix();
+            mesh.scale.set(rw, rh, 1);
+            uniforms.uAspect.value =
+                direction === "up" || direction === "down" ? rw / Math.max(1, rh) : rh / Math.max(1, rw);
+            render();
+        };
+        if (typeof ResizeObserver === "function") {
+            ro = new ResizeObserver(resize);
+            ro.observe(fixed ? document.body : host);
+        }
+        if (fixed)
+            window.addEventListener("resize", resize);
+        ScrollTrigger.refresh();
+        /* ---------------- teardown ---------------- */
+        return () => {
+            if (disposed)
+                return;
+            disposed = true;
+            if (dispDrift > 0)
+                gsap.ticker.remove(renderTime);
+            tween?.kill();
+            gsap.killTweensOf(uniforms.uP);
+            st?.kill();
+            ro?.disconnect();
+            if (fixed)
+                window.removeEventListener("resize", resize);
+            geometry.dispose();
+            material.dispose();
+            renderer.dispose();
+            canvas.remove();
+            host.style.position = prevPosition;
+            ScrollTrigger.refresh();
+        };
+    });
+}
+//# sourceMappingURL=tear-reveal.js.map

package/dist/three/tear-reveal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tear-reveal.js","sourceRoot":"","sources":["../../src/three/tear-reveal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AAwDtC,MAAM,IAAI,GAAG,UAAU,CAAC;;;;;;CAMvB,CAAC;AAEF,MAAM,IAAI,GAAG,UAAU,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqEvB,CAAC;AAEF,MAAM,UAAU,UAAU,CAAC,MAAkB,EAAE,UAA6B,EAAE;IAC5E,QAAQ,EAAE,CAAC;IAEX,MAAM,IAAI,GAAG,GAAG,CAAc,MAAM,CAAC,CAAC;IACtC,IAAI,CAAC,IAAI;QAAE,OAAO,GAAG,EAAE,GAAE,CAAC,CAAC;IAE3B,MAAM,EACJ,KAAK,GAAG,SAAS,EACjB,KAAK,GAAG,MAAM,EACd,SAAS,GAAG,IAAI,EAChB,OAAO,GAAG,KAAK,EACf,SAAS,GAAG,IAAI,EAChB,UAAU,GAAG,CAAC,EACd,SAAS,GAAG,CAAC,EACb,IAAI,GAAG,KAAK,EACZ,IAAI,GAAG,CAAC,KAAK,EACb,QAAQ,GAAG,CAAC,EACZ,IAAI,GAAG,cAAc,EACrB,IAAI,GAAG,QAAQ,EACf,KAAK,GAAG,SAAS,EACjB,GAAG,GAAG,SAAS,EACf,MAAM,GAAG,KAAK,EACd,KAAK,EACL,KAAK,GAAG,KAAK,EACb,CAAC,GAAG,CAAC,EACL,GAAG,GAAG,CAAC,GACR,GAAG,OAAO,CAAC;IAEZ,OAAO,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE;QACzB,+EAA+E;QAC/E,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,CAAC,CAAC,uBAAuB,IAAI,MAAM,CAAC;YAAE,OAAO,GAAG,EAAE,GAAE,CAAC,CAAC;QAE3F,IAAI,QAA6B,CAAC;QAClC,IAAI,CAAC;YACH,QAAQ,GAAG,IAAI,KAAK,CAAC,aAAa,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;QACxE,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC,sDAAsD;QACzE,CAAC;QAED,uEAAuE;QACvE,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;QACzC,IAAI,CAAC,KAAK,IAAI,CAAC,YAAY,IAAI,gBAAgB,CAAC,IAAI,CAAC,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAC5E,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,UAAU,CAAC;QACnC,CAAC;QAED,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACpE,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAEtE,QAAQ,CAAC,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,gBAAgB,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;QACpE,QAAQ,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC;QAC9B,QAAQ,CAAC,aAAa,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;QACpC,MAAM,MAAM,GAAG,QAAQ,CAAC,UAAU,CAAC;QACnC,MAAM,CAAC,KAAK,CAAC,OAAO,GAAG,KAAK;YAC1B,CAAC,CAAC,2FAA2F,CAAC,GAAG;YACjG,CAAC,CAAC,8FAA8F,CAAC,GAAG,CAAC;QAEvG,MAAM,KAAK,GAAqB,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAC9E,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAChC,MAAM,MAAM,GAAG,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QACrF,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG,EAAE,CAAC;QAEvB,MAAM,QAAQ,GAAG,IAAI,KAAK,CAAC,aAAa,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QACrD,MAAM,QAAQ,GAAG;YACf,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE;YAChB,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE;YACnB,OAAO,EAAE,EAAE,KAAK,EAAE,SAAS,KAAK,IAAI,IAAI,SAAS,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE;YACxG,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE;YAClB,KAAK,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE;YACtB,IAAI,EAAE,EAAE,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE;YAClG,QAAQ,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE;YAC5B,UAAU,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE;YAChC,UAAU,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE;YAChC,KAAK,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE;YACtB,OAAO,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE;YAC9B,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE;YAC1C,KAAK,EAAE,EAAE,KAAK,EAAE,IAAI,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE;SAC5C,CAAC;QACF,MAAM,QAAQ,GAAG,IAAI,KAAK,CAAC,cAAc,CAAC;YACxC,YAAY,EAAE,IAAI;YAClB,cAAc,EAAE,IAAI;YACpB,QAAQ;YACR,WAAW,EAAE,IAAI;YACjB,SAAS,EAAE,KAAK;YAChB,UAAU,EAAE,KAAK;SAClB,CAAC,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAChD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QACxB,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAChB,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QACzB,IAAI,KAAK,IAAI,KAAK,KAAK,MAAM;YAAE,MAAM,CAAC,KAAK,CAAC,YAAY,GAAG,KAAK,CAAC;QAEjE,MAAM,MAAM,GAAG,GAAG,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAEpD,2EAA2E;QAE3E,IAAI,KAAK,GAA2B,IAAI,CAAC;QACzC,IAAI,EAAE,GAAyB,IAAI,CAAC;QACpC,IAAI,QAAQ,GAAG,KAAK,CAAC;QAErB,MAAM,IAAI,GAAG,CAAC,CAAS,EAAE,EAAE;YACzB,QAAQ,CAAC,EAAE,CAAC,KAAK,GAAG,CAAC,CAAC;YACtB,MAAM,EAAE,CAAC;QACX,CAAC,CAAC;QAEF,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,EAAE,GAAG,aAAa,CAAC,MAAM,CAAC;gBACxB,OAAO,EAAE,IAAI;gBACb,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK;gBAChC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,GAAG;gBAClC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK;gBACpC,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC;aACxC,CAAC,CAAC;YACH,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC;QACpB,CAAC;aAAM,IAAI,IAAI,KAAK,WAAW,EAAE,CAAC;YAChC,KAAK,GAAG,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,EAAE;gBAC3B,KAAK,EAAE,CAAC;gBACR,QAAQ;gBACR,IAAI;gBACJ,QAAQ,EAAE,MAAM;aACjB,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,EAAE,GAAG,aAAa,CAAC,MAAM,CAAC;gBACxB,OAAO,EAAE,IAAI;gBACb,KAAK;gBACL,GAAG;gBACH,aAAa,EAAE,MAAM,CAAC,CAAC,CAAC,2BAA2B,CAAC,CAAC,CAAC,qBAAqB;gBAC3E,OAAO,EAAE,GAAG,EAAE;oBACZ,KAAK,EAAE,IAAI,EAAE,CAAC;oBACd,KAAK,GAAG,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;gBAChG,CAAC;gBACD,WAAW,EAAE,GAAG,EAAE;oBAChB,IAAI,CAAC,MAAM;wBAAE,OAAO;oBACpB,KAAK,EAAE,IAAI,EAAE,CAAC;oBACd,KAAK,GAAG,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;gBAChG,CAAC;aACF,CAAC,CAAC;YACH,MAAM,EAAE,CAAC;QACX,CAAC;QAED,+DAA+D;QAC/D,MAAM,UAAU,GAAG,GAAG,EAAE;YACtB,QAAQ,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;YACxC,MAAM,EAAE,CAAC;QACX,CAAC,CAAC;QACF,IAAI,SAAS,GAAG,CAAC;YAAE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAE/C,8CAA8C;QAC9C,IAAI,EAAE,GAA0B,IAAI,CAAC;QACrC,MAAM,MAAM,GAAG,GAAG,EAAE;YAClB,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YACrE,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YACvE,QAAQ,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC;YAChC,MAAM,CAAC,IAAI,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;YACtB,MAAM,CAAC,KAAK,GAAG,EAAE,GAAG,CAAC,CAAC;YACtB,MAAM,CAAC,GAAG,GAAG,EAAE,GAAG,CAAC,CAAC;YACpB,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;YACxB,MAAM,CAAC,sBAAsB,EAAE,CAAC;YAChC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;YAC1B,QAAQ,CAAC,OAAO,CAAC,KAAK;gBACpB,SAAS,KAAK,IAAI,IAAI,SAAS,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC3F,MAAM,EAAE,CAAC;QACX,CAAC,CAAC;QACF,IAAI,OAAO,cAAc,KAAK,UAAU,EAAE,CAAC;YACzC,EAAE,GAAG,IAAI,cAAc,CAAC,MAAM,CAAC,CAAC;YAChC,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC3C,CAAC;QACD,IAAI,KAAK;YAAE,MAAM,CAAC,gBAAgB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAErD,aAAa,CAAC,OAAO,EAAE,CAAC;QAExB,gDAAgD;QAChD,OAAO,GAAG,EAAE;YACV,IAAI,QAAQ;gBAAE,OAAO;YACrB,QAAQ,GAAG,IAAI,CAAC;YAChB,IAAI,SAAS,GAAG,CAAC;gBAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;YAClD,KAAK,EAAE,IAAI,EAAE,CAAC;YACd,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;YAC/B,EAAE,EAAE,IAAI,EAAE,CAAC;YACX,EAAE,EAAE,UAAU,EAAE,CAAC;YACjB,IAAI,KAAK;gBAAE,MAAM,CAAC,mBAAmB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YACxD,QAAQ,CAAC,OAAO,EAAE,CAAC;YACnB,QAAQ,CAAC,OAAO,EAAE,CAAC;YACnB,QAAQ,CAAC,OAAO,EAAE,CAAC;YACnB,MAAM,CAAC,MAAM,EAAE,CAAC;YAChB,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,YAAY,CAAC;YACnC,aAAa,CAAC,OAAO,EAAE,CAAC;QAC1B,CAAC,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/three/wordmark-wave.d.ts

@@ -0,0 +1,29 @@
+import type { CommonOptions, Destroy, TargetLike } from "../core/types.js";
+export interface WordmarkWaveOptions extends CommonOptions {
+    /** Text to draw — defaults to the target's own (trimmed) text. */
+    text?: string;
+    /** CSS font shorthand; defaults to the target's computed font. */
+    font?: string;
+    /** Base colour; defaults to the target's computed colour. */
+    color?: string;
+    /** Overall opacity. @default 1 */
+    opacity?: number;
+    /** Stroke width, px, for an outlined wordmark — 0 = filled. @default 0 */
+    outline?: number;
+    /** Extra letter spacing, px. @default 0 */
+    tracking?: number;
+    /** Pointer-velocity ("drag") term of the sim. @default 1 */
+    drag?: number;
+    /** Radial push term — vertices flee the cursor while it sits still. @default 0 */
+    push?: number;
+    /** Red/cyan chromatic split while deforming. @default true */
+    chroma?: boolean;
+    /** Device-pixel-ratio cap for both canvases. @default 2 */
+    dpr?: number;
+    /** Horizontal grid columns — auto (≈10 px cells) when omitted. */
+    segments?: number;
+    /** Canvas stacking order. @default 1 */
+    z?: number;
+}
+export declare function wordmarkWave(target: TargetLike, options?: WordmarkWaveOptions): Destroy;
+//# sourceMappingURL=wordmark-wave.d.ts.map

package/dist/three/wordmark-wave.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wordmark-wave.d.ts","sourceRoot":"","sources":["../../src/three/wordmark-wave.ts"],"names":[],"mappings":"AA4CA,OAAO,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE3E,MAAM,WAAW,mBAAoB,SAAQ,aAAa;IACxD,kEAAkE;IAClE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kEAAkE;IAClE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6DAA6D;IAC7D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0EAA0E;IAC1E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4DAA4D;IAC5D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kFAAkF;IAClF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8DAA8D;IAC9D,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,2DAA2D;IAC3D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,CAAC,CAAC,EAAE,MAAM,CAAC;CACZ;AA8DD,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,GAAE,mBAAwB,GAAG,OAAO,CA+X3F"}