@cosmictraveler002/anim-kit 1.4.0 → 1.6.0

package/dist/three/dither-reveal.d.ts

@@ -0,0 +1,36 @@
+import type { CommonOptions, Destroy, TargetLike } from "../core/types.js";
+export interface DitherRevealOptions extends CommonOptions {
+    /** Image source — defaults to the wrapper's first `<img>`. */
+    src?: string;
+    /** Reveal duration, seconds. @default 1.15 */
+    duration?: number;
+    /** GSAP ease for the reveal. @default "power4.out" */
+    ease?: string;
+    /**
+     * Flat placeholder colour shown where the mask has not opened yet
+     * (their "develop" plate). Omit to let the wrapper's own background
+     * show through the not-yet-revealed area.
+     */
+    plate?: string;
+    /** fbm frequency across the element — the lump scale of the edge. @default 50 */
+    maskScale?: number;
+    /**
+     * How far (in normalised radius) the noise can push the boundary ahead of
+     * and behind the clean circle. @default 0.35
+     */
+    spread?: number;
+    /** fbm octaves — 1 is a soft blob, 6 is gritty. @default 4 */
+    detail?: number;
+    /** Hard-edged speckle (the signature) vs a soft dissolve. @default true */
+    hard?: boolean;
+    /**
+     * When the reveal fires: on first viewport entry (default) or as soon as
+     * the texture has decoded. Falls back to `"load"` without IntersectionObserver.
+     * @default "visible"
+     */
+    play?: "load" | "visible";
+    /** Device-pixel-ratio cap. @default 2 */
+    dpr?: number;
+}
+export declare function ditherReveal(target: TargetLike, options?: DitherRevealOptions): Destroy;
+//# sourceMappingURL=dither-reveal.d.ts.map

package/dist/three/dither-reveal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dither-reveal.d.ts","sourceRoot":"","sources":["../../src/three/dither-reveal.ts"],"names":[],"mappings":"AA8CA,OAAO,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE3E,MAAM,WAAW,mBAAoB,SAAQ,aAAa;IACxD,8DAA8D;IAC9D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sDAAsD;IACtD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iFAAiF;IACjF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2EAA2E;IAC3E,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,yCAAyC;IACzC,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAsFD,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAsM3F"}

package/dist/three/dither-reveal.js

@@ -0,0 +1,292 @@
+/**
+ * Dither reveal — a photo that punches through its placeholder in a speckled
+ * ring expanding from the centre outward.
+ *
+ * The mask is the whole trick: a radial threshold displaced by fbm noise, so
+ * the boundary is lumpy at low frequency and speckled at high frequency, and
+ * every pixel on the boundary flips hard between "hole" and "not hole" — no
+ * soft dissolve, no crossfade. The noise spread ramps to zero at both ends of
+ * the travel, so progress 0 is exactly empty and progress 1 exactly solid
+ * (no half-revealed corners, no leftover speckle).
+ *
+ * The image keeps owning layout and alt text; the effect paints it onto a
+ * canvas that covers the wrapper and hands the pixels over only once its
+ * texture has decoded — a 404 or a WebGL-less browser leaves the plain `<img>`
+ * exactly where it was.
+ *
+ * - **Optional peer.** Lives behind the `@cosmictraveler002/anim-kit/three`
+ *   subpath; the core barrel stays gsap+lenis only. `three` is an optional
+ *   peer — install it to use this entry, the core never imports it.
+ * - **Silent no-op ladder.** Missing target → no-op. No
+ *   `WebGLRenderingContext` (jsdom, SSR, WebGL-disabled browsers) → no-op
+ *   *before* a context is ever requested (a probe call would itself log).
+ *   Renderer construction throws → no-op. Texture 404s → the plain `<img>`
+ *   stays visible. Under `prefers-reduced-motion` the canvas never mounts —
+ *   the image simply shows, which is the motion-reduced end state anyway.
+ * - **Cover crop in-shader.** The texture is sampled with `object-fit: cover`
+ *   maths (`scale = uRes / uTexSize`, windowed around the centre), so any
+ *   source aspect fills the card without letterboxing.
+ * - **Trigger model.** The reveal fires once, when the texture is decoded
+ *   *and* the wrapper has been on screen (`play: "visible"`, the default) —
+ *   a reveal that runs before anyone can see it is not a reveal. `play:
+ *   "load"` fires it the moment the texture lands, regardless of viewport.
+ * - **Fidelity.** `destroy()` kills the tween + observers/listeners, disposes
+ *   geometry/material/texture/renderer, removes the canvas and restores the
+ *   `<img>` opacity and wrapper position it changed.
+ *
+ *   ditherReveal("[data-reveal]", { plate: "#14140f", duration: 1.15 })
+ *
+ * Markup: a wrapper element containing `<img>` (or pass `src` explicitly):
+ *
+ *   <figure class="shot" data-reveal><img src="photo.jpg" alt="" /></figure>
+ */
+import * as THREE from "three";
+import { gsap, 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 sampler2D uTex;
+uniform vec2 uRes;
+uniform vec2 uTexSize;
+uniform vec3 uPlate;
+uniform float uPlateA;
+uniform float uProgress;
+uniform float uMaskScale;
+uniform float uSpread;
+uniform float uDetail;
+uniform float uHard;
+
+float hash(vec2 p) {
+  return fract(sin(dot(p, vec2(127.1, 311.7))) * 43758.5453123);
+}
+
+float vnoise(vec2 p) {
+  vec2 i = floor(p);
+  vec2 f = fract(p);
+  vec2 u = f * f * (3.0 - 2.0 * f);
+  return mix(
+    mix(hash(i), hash(i + vec2(1.0, 0.0)), u.x),
+    mix(hash(i + vec2(0.0, 1.0)), hash(i + vec2(1.0, 1.0)), u.x),
+    u.y);
+}
+
+/* Normalised to ~0..1 for any octave count, so spread means the same thing
+   whether detail is 1 or 6. */
+float fbm(vec2 p) {
+  float v = 0.0;
+  float a = 0.5;
+  for (int i = 0; i < 6; i++) {
+    if (float(i) >= uDetail) break;
+    v += a * vnoise(p);
+    p = p * 2.03 + 17.0;
+    a *= 0.5;
+  }
+  return v / max(1.0 - pow(0.5, uDetail), 0.0001);
+}
+
+void main() {
+  /* object-fit: cover — window the texture around its centre. */
+  vec2 scale = uRes / max(uTexSize, vec2(1.0));
+  vec2 cover = (vUv - 0.5) * (scale / max(scale.x, scale.y)) + 0.5;
+  vec3 photo = texture2D(uTex, cover).rgb;
+
+  /* Radial distance in normalised half-diagonal units: 0 centre, 1 corners. */
+  float d = length((vUv - 0.5) * uRes) / (0.5 * length(uRes));
+
+  float mask;
+  if (uProgress <= 0.0001) {
+    mask = 0.0;                                    /* exactly empty        */
+  } else if (uProgress >= 0.9999) {
+    mask = 1.0;                                    /* exactly solid        */
+  } else {
+    /* Noise spread dies off at both ends of the travel: the start stays
+       empty and the finish stays sealed however far the fbm drags. */
+    float ramp = smoothstep(0.0, 0.18, uProgress) *
+                 smoothstep(1.0, 0.82, uProgress);
+    float gap = fbm(vUv * uMaskScale);
+    float th = uProgress + (0.5 - gap) * uSpread * ramp;
+    mask = uHard > 0.5
+      ? 1.0 - step(th, d)                          /* round(): the speckle */
+      : 1.0 - smoothstep(th - 0.04, th + 0.04, d);
+  }
+
+  vec3 col = mix(uPlate, photo, mask);
+  float alpha = mix(uPlateA, 1.0, mask);
+  if (alpha < 0.003) discard;
+  gl_FragColor = vec4(col, alpha);
+}
+`;
+export function ditherReveal(target, options = {}) {
+    initGSAP();
+    const host = one(target);
+    if (!host)
+        return () => { };
+    const { src, duration = 1.15, ease = "power4.out", plate, maskScale = 50, spread = 0.35, detail = 4, hard = true, play = "visible", 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: true });
+        }
+        catch {
+            return () => { }; // context refused (disabled/blacklisted) — plain img stays
+        }
+        const img = host.tagName === "IMG" ? null : host.querySelector("img");
+        const textureSrc = src || img?.currentSrc || img?.src;
+        if (!textureSrc) {
+            renderer.dispose();
+            return () => { };
+        }
+        /* ---------------- layout + styles we must restore ---------------- */
+        const prevPosition = host.style.position;
+        if (!prevPosition && getComputedStyle(host).position === "static") {
+            host.style.position = "relative";
+        }
+        const prevImgOpacity = img?.style.opacity ?? "";
+        host.dataset.akReveal = "true";
+        const w = Math.max(1, host.clientWidth);
+        const h = Math.max(1, host.clientHeight);
+        renderer.setPixelRatio(Math.min(window.devicePixelRatio || 1, dpr));
+        renderer.setSize(w, h, false);
+        const canvas = renderer.domElement;
+        canvas.style.cssText =
+            "position:absolute;inset:0;width:100%;height:100%;display:block;pointer-events:none;";
+        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 plateColor = new THREE.Color(plate || "#000000");
+        const geometry = new THREE.PlaneGeometry(1, 1, 1, 1);
+        const uniforms = {
+            uTex: { value: null },
+            uRes: { value: new THREE.Vector2(w, h) },
+            uTexSize: { value: new THREE.Vector2(1, 1) },
+            uPlate: { value: plateColor },
+            uPlateA: { value: plate ? 1 : 0 },
+            uProgress: { value: 0 },
+            uMaskScale: { value: maskScale },
+            uSpread: { value: spread },
+            uDetail: { value: detail },
+            uHard: { value: hard ? 1 : 0 },
+        };
+        const material = new THREE.ShaderMaterial({
+            vertexShader: VERT,
+            fragmentShader: FRAG,
+            uniforms,
+            transparent: true,
+        });
+        const mesh = new THREE.Mesh(geometry, material);
+        mesh.scale.set(w, h, 1);
+        mesh.visible = false;
+        scene.add(mesh);
+        host.appendChild(canvas);
+        /* ---------------- texture + play trigger ---------------- */
+        let disposed = false;
+        let loaded = false;
+        let seen = play === "load"; // armed for "visible" once the wrapper is on screen
+        let played = false;
+        let revealTween = null;
+        const loader = new THREE.TextureLoader();
+        const tryPlay = () => {
+            if (played || !loaded || !seen || disposed)
+                return;
+            played = true;
+            /* With a plate the placeholder has been covering the <img> since the
+               texture landed; without one the <img> only steps aside now, so the
+               area is never empty before the reveal actually starts. */
+            if (img && !plate)
+                img.style.opacity = "0";
+            revealTween = gsap.fromTo(uniforms.uProgress, { value: 0 }, { value: 1, duration, ease, overwrite: true });
+        };
+        loader.load(textureSrc, (texture) => {
+            if (disposed) {
+                texture.dispose();
+                return;
+            }
+            texture.minFilter = THREE.LinearFilter;
+            texture.magFilter = THREE.LinearFilter;
+            // No sRGB decode: the raw shader passes sampled values through, so the
+            // texture must stay an ordinary RGBA8 upload (built-in colorSpace
+            // conversion only happens inside three's own material chunks).
+            uniforms.uTex.value = texture;
+            uniforms.uTexSize.value.set(texture.image.width || 1, texture.image.height || 1);
+            mesh.visible = true;
+            loaded = true;
+            if (plate && img)
+                img.style.opacity = "0"; // plate owns the pixels now
+            tryPlay();
+        }, undefined, () => {
+            /* 404 / decode failure — the plain <img> was never hidden. */
+        });
+        /* ---------------- loop / observers ---------------- */
+        let visible = true;
+        let io = null;
+        if (typeof IntersectionObserver === "function") {
+            io = new IntersectionObserver(([entry]) => {
+                visible = entry.isIntersecting;
+                if (entry.isIntersecting) {
+                    seen = true;
+                    tryPlay();
+                }
+            }, { rootMargin: "80px" });
+            io.observe(host);
+        }
+        else {
+            seen = true; // no viewport signal available — play on load instead
+            tryPlay();
+        }
+        let ro = null;
+        const resize = () => {
+            const rw = Math.max(1, host.clientWidth);
+            const rh = Math.max(1, 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.uRes.value.set(rw, rh);
+        };
+        if (typeof ResizeObserver === "function") {
+            ro = new ResizeObserver(resize);
+            ro.observe(host);
+        }
+        const render = () => {
+            if (!visible || !mesh.visible)
+                return;
+            renderer.render(scene, camera);
+        };
+        gsap.ticker.add(render);
+        /* ---------------- teardown ---------------- */
+        return () => {
+            disposed = true;
+            gsap.ticker.remove(render);
+            revealTween?.kill();
+            gsap.killTweensOf(uniforms.uProgress);
+            io?.disconnect();
+            ro?.disconnect();
+            uniforms.uTex.value?.dispose();
+            geometry.dispose();
+            material.dispose();
+            renderer.dispose();
+            canvas.remove();
+            delete host.dataset.akReveal;
+            host.style.position = prevPosition;
+            if (img)
+                img.style.opacity = prevImgOpacity;
+        };
+    });
+}
+//# sourceMappingURL=dither-reveal.js.map

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

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

package/dist/three/index.d.ts

@@ -12,4 +12,12 @@ export { webglMedia } from "./webgl-media.js";
 export type { WebglMediaOptions } from "./webgl-media.js";
 export { glRail } from "./gl-rail.js";
 export type { GlRailOptions } from "./gl-rail.js";
+export { tearReveal } from "./tear-reveal.js";
+export type { TearRevealOptions, TearRevealDirection } from "./tear-reveal.js";
+export { ditherReveal } from "./dither-reveal.js";
+export type { DitherRevealOptions } from "./dither-reveal.js";
+export { wordmarkWave } from "./wordmark-wave.js";
+export type { WordmarkWaveOptions } from "./wordmark-wave.js";
+export { coverflowWheel } from "./coverflow-wheel.js";
+export type { CoverflowWheelOptions, CoverflowWheelHandle } from "./coverflow-wheel.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/three/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/three/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/three/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,YAAY,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC/E,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,YAAY,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,YAAY,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,YAAY,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/three/index.js

@@ -10,4 +10,8 @@
  */
 export { webglMedia } from "./webgl-media.js";
 export { glRail } from "./gl-rail.js";
+export { tearReveal } from "./tear-reveal.js";
+export { ditherReveal } from "./dither-reveal.js";
+export { wordmarkWave } from "./wordmark-wave.js";
+export { coverflowWheel } from "./coverflow-wheel.js";
 //# sourceMappingURL=index.js.map

package/dist/three/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/three/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/three/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/three/tear-reveal.d.ts

@@ -0,0 +1,54 @@
+import type { CommonOptions, Destroy, TargetLike } from "../core/types.js";
+export type TearRevealDirection = "up" | "down" | "left" | "right";
+export interface TearRevealOptions extends CommonOptions {
+    /** Sheet colour — one colour or `[foot, top]` gradient stops. @default "#111111" */
+    color?: string | [string, string];
+    /**
+     * CSS `mix-blend-mode` for the canvas. `multiply` tints everything under
+     * the sheet instead of covering it; `none` = plain overlay.
+     * @default "none"
+     */
+    blend?: string;
+    /** Which way the boundary travels. @default "up" */
+    direction?: TearRevealDirection;
+    /** How far the noise drags the boundary. @default 0.175 */
+    dispAmp?: number;
+    /** Tear size — high is shrapnel, low is a wave. @default 12.2 */
+    dispScale?: number;
+    /** Noise octaves — 1 is a smooth wobble, 5 is debris. @default 5 */
+    dispDetail?: number;
+    /** How fast the noise pattern crawls (0 holds it still). @default 0 */
+    dispDrift?: number;
+    /** Threshold half-width — small keeps shards crisp. @default 0.001 */
+    soft?: number;
+    /**
+     * Barrel warp strength — negative bows the middle of the boundary up,
+     * 0 is a flat horizon. @default -0.275
+     */
+    lens?: number;
+    /** Timed-run duration, seconds (ignored when `scrub` is set). @default 1 */
+    duration?: number;
+    /** GSAP ease for the timed run. @default "power2.inOut" */
+    ease?: string;
+    /** "scroll" plays on enter, "immediate" plays at once. @default "scroll" */
+    mode?: "scroll" | "immediate";
+    /** ScrollTrigger start position. @default "top 85%" */
+    start?: string;
+    /** ScrollTrigger end position (scrub mode). @default "top 25%" */
+    end?: string;
+    /** Re-run when leaving / re-entering the viewport. @default false */
+    replay?: boolean;
+    /**
+     * Bind progress to scroll instead of playing it on enter —
+     * number = scrub smoothing seconds, `true` = immediate. unset = one-shot.
+     */
+    scrub?: number | boolean;
+    /** Mount the canvas over the viewport instead of the target box. @default false */
+    fixed?: boolean;
+    /** Canvas z-index inside its stacking context. @default 1 */
+    z?: number;
+    /** Device-pixel-ratio cap. @default 2 */
+    dpr?: number;
+}
+export declare function tearReveal(target: TargetLike, options?: TearRevealOptions): Destroy;
+//# sourceMappingURL=tear-reveal.d.ts.map

package/dist/three/tear-reveal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tear-reveal.d.ts","sourceRoot":"","sources":["../../src/three/tear-reveal.ts"],"names":[],"mappings":"AA4BA,OAAO,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE3E,MAAM,MAAM,mBAAmB,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAEnE,MAAM,WAAW,iBAAkB,SAAQ,aAAa;IACtD,oFAAoF;IACpF,KAAK,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oDAAoD;IACpD,SAAS,CAAC,EAAE,mBAAmB,CAAC;IAChC,2DAA2D;IAC3D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iEAAiE;IACjE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oEAAoE;IACpE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uEAAuE;IACvE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sEAAsE;IACtE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2DAA2D;IAC3D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,4EAA4E;IAC5E,IAAI,CAAC,EAAE,QAAQ,GAAG,WAAW,CAAC;IAC9B,uDAAuD;IACvD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,qEAAqE;IACrE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACzB,mFAAmF;IACnF,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,6DAA6D;IAC7D,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,yCAAyC;IACzC,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAiFD,wBAAgB,UAAU,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,GAAE,iBAAsB,GAAG,OAAO,CA4LvF"}