@sonordev/site-kit 5.1.0 → 5.3.0

package/dist/motion/index.mjs

@@ -0,0 +1,230 @@
+'use client';
+import { prefersReducedMotion, registerScene } from '../chunk-MLXUMVBK.mjs';
+export { prefersReducedMotion, refreshScenes, registerScene, sceneProgress } from '../chunk-MLXUMVBK.mjs';
+import '../chunk-BEXTDHO4.mjs';
+import { useRef, useEffect } from 'react';
+import { jsx } from 'react/jsx-runtime';
+
+// src/motion/failsafe.ts
+var scrolled = false;
+var armed = false;
+function arm() {
+  if (armed || typeof window === "undefined") return;
+  armed = true;
+  window.addEventListener(
+    "scroll",
+    () => {
+      scrolled = true;
+    },
+    { passive: true, once: true }
+  );
+}
+function onNoScroll(fn, ms = 2500) {
+  if (typeof window === "undefined") return () => {
+  };
+  arm();
+  const t = setTimeout(() => {
+    if (!scrolled) fn();
+  }, ms);
+  return () => clearTimeout(t);
+}
+var DEFAULT_EASING = "cubic-bezier(0.22, 1, 0.36, 1)";
+var DEFAULT_STAGGER = 0.08;
+function hiddenTransform(from, distance, scale) {
+  let t = "";
+  if (from === "up") t = `translate3d(0, ${distance}px, 0)`;
+  else if (from === "down") t = `translate3d(0, ${-distance}px, 0)`;
+  else if (from === "left") t = `translate3d(${-distance}px, 0, 0)`;
+  else if (from === "right") t = `translate3d(${distance}px, 0, 0)`;
+  if (scale !== void 0) t = `${t} scale(${scale})`.trim();
+  return t;
+}
+function Reveal({
+  children,
+  as = "div",
+  className,
+  style,
+  id,
+  from = "up",
+  distance = 24,
+  delay = 0,
+  duration = 0.7,
+  stagger = false,
+  once = true,
+  threshold = 0.15,
+  scale,
+  opacity = 0,
+  easing = DEFAULT_EASING
+}) {
+  const ref = useRef(null);
+  const Tag = as;
+  useEffect(() => {
+    const el = ref.current;
+    if (!el) return;
+    if (prefersReducedMotion()) return;
+    const step = stagger === true ? DEFAULT_STAGGER : stagger || 0;
+    const targets = () => step > 0 && el.children.length > 0 ? Array.from(el.children) : [el];
+    const hiddenOpacity = String(opacity);
+    const transform = hiddenTransform(from, distance, scale);
+    let clearTimer;
+    let animObserver = null;
+    let cancelFailsafe;
+    let shown = false;
+    const hide = (animated) => {
+      clearTimeout(clearTimer);
+      for (const t of targets()) {
+        t.style.transition = animated ? `opacity ${duration * 0.5}s ${easing}, transform ${duration * 0.5}s ${easing}` : "none";
+        t.style.opacity = hiddenOpacity;
+        t.style.transform = transform;
+      }
+    };
+    const show = () => {
+      const list = targets();
+      let total = 0;
+      list.forEach((t, i) => {
+        const d = delay + step * i;
+        total = Math.max(total, d + duration);
+        t.style.transition = `opacity ${duration}s ${easing} ${d}s, transform ${duration}s ${easing} ${d}s`;
+        t.style.opacity = "";
+        t.style.transform = "";
+      });
+      clearTimeout(clearTimer);
+      clearTimer = setTimeout(() => {
+        for (const t of list) t.style.transition = "";
+      }, total * 1e3 + 100);
+    };
+    const restore = () => {
+      clearTimeout(clearTimer);
+      for (const t of targets()) {
+        t.style.transition = "";
+        t.style.opacity = "";
+        t.style.transform = "";
+      }
+    };
+    const foldObserver = new IntersectionObserver(([entry]) => {
+      foldObserver.disconnect();
+      if (!el.isConnected || entry?.isIntersecting) return;
+      hide(false);
+      cancelFailsafe = onNoScroll(() => {
+        animObserver?.disconnect();
+        restore();
+      });
+      animObserver = new IntersectionObserver(
+        ([e]) => {
+          if (!e) return;
+          if (e.isIntersecting) {
+            shown = true;
+            if (once) animObserver?.disconnect();
+            show();
+          } else if (shown && !once) {
+            hide(true);
+          }
+        },
+        // Fire when the element's top crosses `threshold` up from the
+        // bottom edge — the same trigger line as GSAP's "top 85%", and it
+        // works for elements taller than the viewport.
+        { rootMargin: `0px 0px -${Math.round(threshold * 100)}% 0px`, threshold: 0 }
+      );
+      animObserver.observe(el);
+    });
+    foldObserver.observe(el);
+    return () => {
+      foldObserver.disconnect();
+      animObserver?.disconnect();
+      cancelFailsafe?.();
+      clearTimeout(clearTimer);
+    };
+  }, [from, distance, delay, duration, stagger, once, threshold, scale, opacity, easing]);
+  return /* @__PURE__ */ jsx(Tag, { ref, id, className, style, "data-sk-reveal": "", children });
+}
+function useParallax(ref, options = {}) {
+  const { y = [40, -40], x, scale, opacity, rotate } = options;
+  const easeRef = useRef(options.ease);
+  easeRef.current = options.ease;
+  const key = JSON.stringify([y, x, scale, opacity, rotate]);
+  useEffect(() => {
+    const el = ref.current;
+    if (!el) return;
+    if (prefersReducedMotion()) return;
+    const between = (r, q) => r[0] + (r[1] - r[0]) * q;
+    return registerScene(
+      el,
+      (p, info) => {
+        const q = easeRef.current ? easeRef.current(p) : p;
+        let t = `translate3d(${x ? between(x, q) : 0}px, ${between(y, q)}px, 0)`;
+        if (scale) t += ` scale(${between(scale, q)})`;
+        if (rotate) t += ` rotate(${between(rotate, q)}deg)`;
+        el.style.transform = t;
+        if (opacity) el.style.opacity = String(between(opacity, q));
+        el.style.willChange = info.visible ? "transform" : "";
+      },
+      { mode: "view", lerp: 1 }
+    );
+  }, [ref, key]);
+}
+function Parallax({ children, as = "div", className, style, id, ...options }) {
+  const ref = useRef(null);
+  const Tag = as;
+  useParallax(ref, options);
+  return /* @__PURE__ */ jsx(Tag, { ref, id, className, style, "data-sk-parallax": "", children });
+}
+function useScrollScene(ref, onProgress, options = {}) {
+  const cbRef = useRef(onProgress);
+  cbRef.current = onProgress;
+  const { continuous, reducedP, mode, lerp, cssVar } = options;
+  useEffect(() => {
+    const el = ref.current;
+    if (!el) return;
+    const prop = cssVar === false ? null : cssVar ?? "--sk-p";
+    return registerScene(
+      el,
+      (p, info) => {
+        if (prop) el.style.setProperty(prop, p.toFixed(4));
+        cbRef.current?.(p, info);
+      },
+      { continuous, reducedP, mode, lerp }
+    );
+  }, [ref, continuous, reducedP, mode, lerp, cssVar]);
+}
+function ScrollScene({
+  children,
+  length = "300vh",
+  as = "section",
+  className,
+  style,
+  id,
+  stageClassName,
+  stageStyle,
+  onProgress,
+  continuous,
+  reducedP,
+  lerp,
+  cssVar
+}) {
+  const ref = useRef(null);
+  const Tag = as;
+  useScrollScene(ref, onProgress, { continuous, reducedP, lerp, cssVar, mode: "pin" });
+  return /* @__PURE__ */ jsx(
+    Tag,
+    {
+      ref,
+      id,
+      className,
+      style: { position: "relative", height: length, ...style },
+      "data-sk-scene": "",
+      children: /* @__PURE__ */ jsx(
+        "div",
+        {
+          className: stageClassName,
+          style: { position: "sticky", top: 0, height: "100svh", overflow: "hidden", ...stageStyle },
+          "data-sk-stage": "",
+          children
+        }
+      )
+    }
+  );
+}
+
+export { Parallax, Reveal, ScrollScene, onNoScroll, useParallax, useScrollScene };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/motion/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/motion/failsafe.ts","../../src/motion/Reveal.tsx","../../src/motion/Parallax.tsx","../../src/motion/ScrollScene.tsx"],"names":["useRef","useEffect","jsx"],"mappings":"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","file":"index.mjs","sourcesContent":["/**\n * Renderer failsafe for scroll-entrance reveals.\n *\n * Headless renderers — Google's Web Rendering Service included — execute\n * JavaScript but never scroll, so a scroll-triggered reveal would leave\n * below-the-fold content transparent in the rendered snapshot that gets\n * indexed. (Measured at ~85 transparent elements on one page before this\n * guard existed.) If the visitor hasn't scrolled shortly after a reveal\n * arms, we assume nobody is going to and show the content. Real visitors\n * scroll well inside the window, so animations are unaffected.\n *\n * Single source of truth for every reveal system in the kit. Ported from\n * upforge.io's lib/reveal-failsafe.\n */\n\nlet scrolled = false\nlet armed = false\n\nfunction arm() {\n  if (armed || typeof window === 'undefined') return\n  armed = true\n  window.addEventListener(\n    'scroll',\n    () => {\n      scrolled = true\n    },\n    { passive: true, once: true },\n  )\n}\n\n/**\n * Run `fn` after `ms` milliseconds unless the visitor scrolls first.\n * Returns a cancel function for effect cleanups.\n */\nexport function onNoScroll(fn: () => void, ms = 2500): () => void {\n  if (typeof window === 'undefined') return () => {}\n  arm()\n  const t = setTimeout(() => {\n    if (!scrolled) fn()\n  }, ms)\n  return () => clearTimeout(t)\n}\n","'use client'\n\nimport { useEffect, useRef, type CSSProperties, type ElementType, type ReactNode } from 'react'\nimport { prefersReducedMotion } from './engine'\nimport { onNoScroll } from './failsafe'\n\n/**\n * <Reveal> — scroll-entrance reveal with no animation library.\n *\n * The SEO contract, in order of importance:\n *\n * 1. The server HTML is fully visible. Nothing is hidden by a stylesheet or\n *    an inline style at render time, so crawlers, no-JS visitors, and the\n *    LCP measurement all see the finished page.\n * 2. Above-the-fold content is never touched. On mount, one\n *    IntersectionObserver pass asks whether the element is already on\n *    screen; if it is, this component does nothing at all.\n * 3. Only below-the-fold content is hidden (offscreen, so nobody sees the\n *    swap) and revealed with a compositor-only CSS transition on opacity\n *    and transform as it scrolls in.\n * 4. A headless renderer that never scrolls gets the content back after\n *    2.5s (see ./failsafe), so the indexed snapshot is never transparent.\n * 5. prefers-reduced-motion disables all of it.\n *\n * Replaces the per-site Reveal / ScrollReveal / RevealOnScroll components.\n */\n\nexport type RevealDirection = 'up' | 'down' | 'left' | 'right' | 'none'\n\nexport interface RevealProps {\n  children?: ReactNode\n  /** Element to render. Default \"div\". */\n  as?: ElementType\n  className?: string\n  style?: CSSProperties\n  id?: string\n  /** Where the element travels in from. Default \"up\" (starts lower). */\n  from?: RevealDirection\n  /** Travel distance in px. Default 24. */\n  distance?: number\n  /** Seconds before the transition starts. Default 0. */\n  delay?: number\n  /** Transition length in seconds. Default 0.7. */\n  duration?: number\n  /**\n   * Reveal the element's direct children one after another instead of the\n   * element itself. `true` = 0.08s apart; a number = that many seconds.\n   */\n  stagger?: boolean | number\n  /** Play once (default) or re-hide when the element scrolls back out. */\n  once?: boolean\n  /**\n   * How far up the viewport the element's top must travel before it\n   * reveals, as a fraction of viewport height. 0.15 (default) = reveal when\n   * the top crosses 85% down the screen.\n   */\n  threshold?: number\n  /** Starting scale, e.g. 0.96. Off by default. */\n  scale?: number\n  /** Starting opacity. Default 0. */\n  opacity?: number\n  /** CSS easing. Default an ease-out-quint curve. */\n  easing?: string\n}\n\nconst DEFAULT_EASING = 'cubic-bezier(0.22, 1, 0.36, 1)'\nconst DEFAULT_STAGGER = 0.08\n\nfunction hiddenTransform(from: RevealDirection, distance: number, scale?: number): string {\n  let t = ''\n  if (from === 'up') t = `translate3d(0, ${distance}px, 0)`\n  else if (from === 'down') t = `translate3d(0, ${-distance}px, 0)`\n  else if (from === 'left') t = `translate3d(${-distance}px, 0, 0)`\n  else if (from === 'right') t = `translate3d(${distance}px, 0, 0)`\n  if (scale !== undefined) t = `${t} scale(${scale})`.trim()\n  return t\n}\n\nexport function Reveal({\n  children,\n  as = 'div',\n  className,\n  style,\n  id,\n  from = 'up',\n  distance = 24,\n  delay = 0,\n  duration = 0.7,\n  stagger = false,\n  once = true,\n  threshold = 0.15,\n  scale,\n  opacity = 0,\n  easing = DEFAULT_EASING,\n}: RevealProps) {\n  const ref = useRef<HTMLElement>(null)\n  const Tag = as as ElementType\n\n  useEffect(() => {\n    const el = ref.current\n    if (!el) return\n    if (prefersReducedMotion()) return\n\n    const step = stagger === true ? DEFAULT_STAGGER : stagger || 0\n    const targets = (): HTMLElement[] =>\n      step > 0 && el.children.length > 0\n        ? (Array.from(el.children) as HTMLElement[])\n        : [el]\n    const hiddenOpacity = String(opacity)\n    const transform = hiddenTransform(from, distance, scale)\n\n    let clearTimer: ReturnType<typeof setTimeout> | undefined\n    let animObserver: IntersectionObserver | null = null\n    let cancelFailsafe: (() => void) | undefined\n    let shown = false\n\n    const hide = (animated: boolean) => {\n      clearTimeout(clearTimer)\n      for (const t of targets()) {\n        t.style.transition = animated\n          ? `opacity ${duration * 0.5}s ${easing}, transform ${duration * 0.5}s ${easing}`\n          : 'none'\n        t.style.opacity = hiddenOpacity\n        t.style.transform = transform\n      }\n    }\n\n    const show = () => {\n      const list = targets()\n      let total = 0\n      list.forEach((t, i) => {\n        const d = delay + step * i\n        total = Math.max(total, d + duration)\n        t.style.transition = `opacity ${duration}s ${easing} ${d}s, transform ${duration}s ${easing} ${d}s`\n        t.style.opacity = ''\n        t.style.transform = ''\n      })\n      // Once the transition has run, drop the inline transition too, so the\n      // element is back to exactly what the stylesheet says.\n      clearTimeout(clearTimer)\n      clearTimer = setTimeout(() => {\n        for (const t of list) t.style.transition = ''\n      }, total * 1000 + 100)\n    }\n\n    const restore = () => {\n      clearTimeout(clearTimer)\n      for (const t of targets()) {\n        t.style.transition = ''\n        t.style.opacity = ''\n        t.style.transform = ''\n      }\n    }\n\n    // Pass 1: one observation with no margin tells us above-vs-below fold\n    // without a forced layout read. Above the fold: leave the static render\n    // alone. Below: hide (offscreen, unseen) and arm the reveal.\n    const foldObserver = new IntersectionObserver(([entry]) => {\n      foldObserver.disconnect()\n      if (!el.isConnected || entry?.isIntersecting) return\n\n      hide(false)\n\n      cancelFailsafe = onNoScroll(() => {\n        animObserver?.disconnect()\n        restore()\n      })\n\n      animObserver = new IntersectionObserver(\n        ([e]) => {\n          if (!e) return\n          if (e.isIntersecting) {\n            shown = true\n            if (once) animObserver?.disconnect()\n            show()\n          } else if (shown && !once) {\n            hide(true)\n          }\n        },\n        // Fire when the element's top crosses `threshold` up from the\n        // bottom edge — the same trigger line as GSAP's \"top 85%\", and it\n        // works for elements taller than the viewport.\n        { rootMargin: `0px 0px -${Math.round(threshold * 100)}% 0px`, threshold: 0 },\n      )\n      animObserver.observe(el)\n    })\n    foldObserver.observe(el)\n\n    return () => {\n      foldObserver.disconnect()\n      animObserver?.disconnect()\n      cancelFailsafe?.()\n      clearTimeout(clearTimer)\n    }\n  }, [from, distance, delay, duration, stagger, once, threshold, scale, opacity, easing])\n\n  return (\n    <Tag ref={ref} id={id} className={className} style={style} data-sk-reveal=\"\">\n      {children}\n    </Tag>\n  )\n}\n","'use client'\n\nimport {\n  useEffect,\n  useRef,\n  type CSSProperties,\n  type ElementType,\n  type ReactNode,\n  type RefObject,\n} from 'react'\nimport { prefersReducedMotion, registerScene } from './engine'\n\n/**\n * Scroll-linked parallax with no animation library.\n *\n * The element's progress through the viewport (0 as its top enters at the\n * bottom, 1 as its bottom leaves at the top) is mapped onto transform and\n * opacity — compositor-only properties, so a page full of these never\n * triggers layout or paint. Driven by the shared engine, so thirty of them\n * cost one requestAnimationFrame.\n *\n * Server-rendered exactly as authored: no offset, no hidden state. Under\n * prefers-reduced-motion nothing registers and the element stays put.\n *\n * Replaces the per-site ParallaxImage / ParallaxY components: wrap the\n * image in an overflow-hidden frame and give <Parallax> a scale so the\n * travel never shows the frame's edges.\n */\n\nexport interface ParallaxOptions {\n  /** Vertical travel in px as [at p=0, at p=1]. Default [40, -40]. */\n  y?: [number, number]\n  /** Horizontal travel in px. */\n  x?: [number, number]\n  /** Scale as [from, to]. */\n  scale?: [number, number]\n  /** Opacity as [from, to]. */\n  opacity?: [number, number]\n  /** Rotation in degrees as [from, to]. */\n  rotate?: [number, number]\n  /** Remap progress before it's applied (e.g. an ease-in-out). */\n  ease?: (p: number) => number\n}\n\nexport function useParallax(ref: RefObject<HTMLElement | null>, options: ParallaxOptions = {}): void {\n  const { y = [40, -40], x, scale, opacity, rotate } = options\n  const easeRef = useRef(options.ease)\n  easeRef.current = options.ease\n  // Ranges are small tuples; a string key keeps the effect stable across\n  // renders that pass a fresh array literal with the same values.\n  const key = JSON.stringify([y, x, scale, opacity, rotate])\n\n  useEffect(() => {\n    const el = ref.current\n    if (!el) return\n    if (prefersReducedMotion()) return\n\n    const between = (r: [number, number], q: number) => r[0] + (r[1] - r[0]) * q\n\n    return registerScene(\n      el,\n      (p, info) => {\n        const q = easeRef.current ? easeRef.current(p) : p\n        let t = `translate3d(${x ? between(x, q) : 0}px, ${between(y, q)}px, 0)`\n        if (scale) t += ` scale(${between(scale, q)})`\n        if (rotate) t += ` rotate(${between(rotate, q)}deg)`\n        el.style.transform = t\n        if (opacity) el.style.opacity = String(between(opacity, q))\n        // Promote to its own layer only while it's actually moving on screen.\n        el.style.willChange = info.visible ? 'transform' : ''\n      },\n      { mode: 'view', lerp: 1 },\n    )\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [ref, key])\n}\n\nexport interface ParallaxProps extends ParallaxOptions {\n  children?: ReactNode\n  /** Element to render. Default \"div\". */\n  as?: ElementType\n  className?: string\n  style?: CSSProperties\n  id?: string\n}\n\nexport function Parallax({ children, as = 'div', className, style, id, ...options }: ParallaxProps) {\n  const ref = useRef<HTMLElement>(null)\n  const Tag = as as ElementType\n  useParallax(ref, options)\n  return (\n    <Tag ref={ref} id={id} className={className} style={style} data-sk-parallax=\"\">\n      {children}\n    </Tag>\n  )\n}\n","'use client'\n\nimport {\n  useEffect,\n  useRef,\n  type CSSProperties,\n  type ElementType,\n  type ReactNode,\n  type RefObject,\n} from 'react'\nimport { registerScene, type SceneInfo, type SceneOptions } from './engine'\n\n/**\n * A pinned scene: a tall wrapper with a sticky, viewport-sized stage inside\n * it. As the visitor scrolls the wrapper's height, the stage stays put and\n * the scene's progress runs 0 → 1. This is the unit of scroll cinema.\n *\n * What it does for you on every frame:\n *   - writes progress to a CSS custom property on the wrapper (`--sk-p` by\n *     default), so choreography can be pure CSS: `opacity: var(--sk-p)`,\n *     `transform: translateX(calc(var(--sk-p) * -40vw))` — no per-frame JS.\n *   - calls `onProgress(p, info)` for anything that needs code (canvas\n *     frame-scrub, three.js, DOM measured moves).\n *\n * The children are server-rendered. A \"use client\" component still renders\n * its children on the server when they arrive as props, so the copy inside\n * a scene is in the HTML for crawlers and for first paint. What you must\n * NOT do is load this (or a component containing it) through\n * `dynamic(..., { ssr: false })` — that de-opts the whole subtree to client\n * rendering and the copy disappears from the HTML.\n */\n\nexport interface UseScrollSceneOptions extends SceneOptions {\n  /** CSS custom property to write progress to. Default \"--sk-p\"; false to skip. */\n  cssVar?: string | false\n}\n\nexport function useScrollScene(\n  ref: RefObject<HTMLElement | null>,\n  onProgress?: (p: number, info: SceneInfo) => void,\n  options: UseScrollSceneOptions = {},\n): void {\n  const cbRef = useRef(onProgress)\n  cbRef.current = onProgress\n  const { continuous, reducedP, mode, lerp, cssVar } = options\n\n  useEffect(() => {\n    const el = ref.current\n    if (!el) return\n    const prop = cssVar === false ? null : (cssVar ?? '--sk-p')\n    return registerScene(\n      el,\n      (p, info) => {\n        if (prop) el.style.setProperty(prop, p.toFixed(4))\n        cbRef.current?.(p, info)\n      },\n      { continuous, reducedP, mode, lerp },\n    )\n  }, [ref, continuous, reducedP, mode, lerp, cssVar])\n}\n\nexport interface ScrollSceneProps extends Omit<UseScrollSceneOptions, 'mode'> {\n  children?: ReactNode\n  /** Scroll length of the scene — the wrapper's height. Default \"300vh\". */\n  length?: string\n  /** Wrapper element. Default \"section\". */\n  as?: ElementType\n  className?: string\n  style?: CSSProperties\n  id?: string\n  /** Class/style for the sticky stage that holds the children. */\n  stageClassName?: string\n  stageStyle?: CSSProperties\n  onProgress?: (p: number, info: SceneInfo) => void\n}\n\nexport function ScrollScene({\n  children,\n  length = '300vh',\n  as = 'section',\n  className,\n  style,\n  id,\n  stageClassName,\n  stageStyle,\n  onProgress,\n  continuous,\n  reducedP,\n  lerp,\n  cssVar,\n}: ScrollSceneProps) {\n  const ref = useRef<HTMLElement>(null)\n  const Tag = as as ElementType\n  useScrollScene(ref, onProgress, { continuous, reducedP, lerp, cssVar, mode: 'pin' })\n  return (\n    <Tag\n      ref={ref}\n      id={id}\n      className={className}\n      style={{ position: 'relative', height: length, ...style }}\n      data-sk-scene=\"\"\n    >\n      <div\n        className={stageClassName}\n        style={{ position: 'sticky', top: 0, height: '100svh', overflow: 'hidden', ...stageStyle }}\n        data-sk-stage=\"\"\n      >\n        {children}\n      </div>\n    </Tag>\n  )\n}\n"]}

package/dist/motion/motion.test.d.ts

@@ -0,0 +1,16 @@
+/**
+ * The motion module's contracts:
+ *
+ * 1. Server HTML never hides content. Every primitive renders its children
+ *    fully visible with no opacity/transform in the markup — that is the
+ *    whole reason this module exists instead of the per-site reveals it
+ *    replaces (crawlers, no-JS visitors, and LCP all read the server HTML).
+ * 2. The progress math is exact.
+ * 3. The tiers are real: nothing outside src/motion/gsap.ts imports gsap,
+ *    nothing outside src/motion/three.ts imports three. A stray import in
+ *    the zero-dep tier would force every consumer of ./motion to install a
+ *    library it never asked for — bundlers resolve even dynamic import()
+ *    at build time.
+ */
+export {};
+//# sourceMappingURL=motion.test.d.ts.map

package/dist/motion/motion.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"motion.test.d.ts","sourceRoot":"","sources":["../../src/motion/motion.test.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG"}

package/dist/motion/three.d.ts

@@ -0,0 +1,105 @@
+/**
+ * @sonordev/site-kit/motion/three — the Upforge motion standard, tier 2.
+ *
+ * WebGL stages driven by the scroll engine. Requires the optional peer
+ * `three` (~180KB gzipped — flagship builds only):
+ *
+ *     npm i three && npm i -D @types/three
+ *
+ * A site that never imports this subpath never installs three. NOTHING
+ * outside this file may import from 'three' (src/motion/motion.test.tsx
+ * enforces it).
+ *
+ * How it must be used, so the page still ranks and still paints fast:
+ *
+ *   - The scene component that calls `useThreeStage` is loaded with
+ *     `dynamic(() => import('./Scene'), { ssr: false })` and mounted as a
+ *     CHILDLESS sibling next to the server-rendered stage — never wrapping
+ *     it. The copy stays in the HTML; three arrives as its own chunk, on
+ *     approach.
+ *   - The canvas is created here at runtime and slotted behind the stage's
+ *     content. Give that content `position: relative` (and a z-index if
+ *     needed) so it paints above the canvas.
+ *   - Every word of copy lives in the DOM, never in the canvas.
+ *   - `canRunWebGL()` is false under reduced motion, Save-Data, or without
+ *     WebGL; the hook then mounts nothing and the visitor keeps the
+ *     server-rendered still. Mobile gets composed stills by design.
+ *   - Byte budget: ≤5MB of models/textures per scene, fetched on approach.
+ *
+ * upforgelabs.com is the reference build (components/cinema/SiteScene.tsx).
+ */
+import { type RefObject } from 'react';
+import { PerspectiveCamera, Scene, WebGLRenderer, type Object3D, type Texture } from 'three';
+import { type SceneInfo, type SceneOptions } from './engine';
+/**
+ * Whether a WebGL scene should run for this visitor at all. False under
+ * prefers-reduced-motion, Save-Data, or when the browser has no WebGL.
+ * Always false on the server.
+ */
+export declare function canRunWebGL(): boolean;
+export interface ThreeStage {
+    renderer: WebGLRenderer;
+    scene: Scene;
+    camera: PerspectiveCamera;
+    canvas: HTMLCanvasElement;
+    /** CSS pixel size of the stage. */
+    width: number;
+    height: number;
+    dpr: number;
+}
+export interface UseThreeStageOptions extends Pick<SceneOptions, 'continuous' | 'reducedP' | 'lerp'> {
+    /** Draw the frame for progress p. Called only while the scene is near the viewport. */
+    render: (p: number, stage: ThreeStage, info: SceneInfo) => void;
+    /** Build the scene. May return a cleanup for anything it allocated outside the scene graph. */
+    onReady?: (stage: ThreeStage) => void | (() => void);
+    /** Called after every resize, with the camera already updated. */
+    onResize?: (stage: ThreeStage) => void;
+    /**
+     * Element the canvas fills and is sized to. Default: the pin's
+     * `[data-sk-stage]` child (what <ScrollScene> renders), else the pin.
+     */
+    mount?: RefObject<HTMLElement | null>;
+    /** Cap on devicePixelRatio. Default 1.75. */
+    maxDpr?: number;
+    alpha?: boolean;
+    antialias?: boolean;
+    fov?: number;
+    near?: number;
+    far?: number;
+    /** DOM event dispatched on the pin once the stage is ready. Default "sk:scene-ready"; false to skip. */
+    readyEvent?: string | false;
+    /** Override the canRunWebGL() gate. */
+    enabled?: boolean;
+}
+/**
+ * Mount a three.js renderer on a pinned scene and drive it from scroll.
+ * Owns the canvas, sizing, DPR, context loss, and disposal.
+ *
+ * @example
+ *   // Scene.tsx — loaded with dynamic(..., { ssr: false }) as a childless sibling
+ *   'use client'
+ *   export default function Scene({ pin }: { pin: RefObject<HTMLElement | null> }) {
+ *     useThreeStage(pin, {
+ *       onReady: ({ scene, camera }) => { camera.position.z = 5; scene.add(mesh) },
+ *       render: (p, { renderer, scene, camera }) => {
+ *         camera.position.z = 5 - p * 4
+ *         renderer.render(scene, camera)
+ *       },
+ *     })
+ *     return null
+ *   }
+ */
+export declare function useThreeStage(pin: RefObject<HTMLElement | null>, options: UseThreeStageOptions): void;
+/**
+ * Load a texture and never throw: resolves null on any failure (a
+ * cross-origin image without CORS headers, a 404), so one bad asset can't
+ * take a whole scene down. sRGB by default, which is right for photographs
+ * and screenshots.
+ */
+export declare function loadTexture(url: string, options?: {
+    crossOrigin?: string;
+    colorSpace?: Texture['colorSpace'];
+}): Promise<Texture | null>;
+/** Dispose every geometry, material, and texture under `root`. */
+export declare function disposeObject(root: Object3D): void;
+//# sourceMappingURL=three.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"three.d.ts","sourceRoot":"","sources":["../../src/motion/three.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAIH,OAAO,EAAqB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AACzD,OAAO,EACL,iBAAiB,EACjB,KAAK,EAGL,aAAa,EACb,KAAK,QAAQ,EACb,KAAK,OAAO,EACb,MAAM,OAAO,CAAA;AACd,OAAO,EAAsD,KAAK,SAAS,EAAE,KAAK,YAAY,EAAE,MAAM,UAAU,CAAA;AAIhH;;;;GAIG;AACH,wBAAgB,WAAW,IAAI,OAAO,CAcrC;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,aAAa,CAAA;IACvB,KAAK,EAAE,KAAK,CAAA;IACZ,MAAM,EAAE,iBAAiB,CAAA;IACzB,MAAM,EAAE,iBAAiB,CAAA;IACzB,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,GAAG,EAAE,MAAM,CAAA;CACZ;AAED,MAAM,WAAW,oBAAqB,SAAQ,IAAI,CAAC,YAAY,EAAE,YAAY,GAAG,UAAU,GAAG,MAAM,CAAC;IAClG,uFAAuF;IACvF,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,KAAK,IAAI,CAAA;IAC/D,+FAA+F;IAC/F,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,CAAA;IACpD,kEAAkE;IAClE,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAA;IACtC;;;OAGG;IACH,KAAK,CAAC,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,CAAA;IACrC,6CAA6C;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,wGAAwG;IACxG,UAAU,CAAC,EAAE,MAAM,GAAG,KAAK,CAAA;IAC3B,uCAAuC;IACvC,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,EAAE,OAAO,EAAE,oBAAoB,GAAG,IAAI,CAuGrG;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CACzB,GAAG,EAAE,MAAM,EACX,OAAO,GAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAA;CAAO,GACzE,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAczB;AAED,kEAAkE;AAClE,wBAAgB,aAAa,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,CAiBlD"}

package/dist/motion/three.js

@@ -0,0 +1,150 @@
+'use client';
+'use strict';
+
+var chunkAEW7EFYU_js = require('../chunk-AEW7EFYU.js');
+require('../chunk-SNAQBZPT.js');
+var react = require('react');
+var three = require('three');
+
+var webglProbe = null;
+function canRunWebGL() {
+  if (typeof window === "undefined") return false;
+  if (chunkAEW7EFYU_js.prefersReducedMotion()) return false;
+  const nav = navigator;
+  if (nav.connection?.saveData) return false;
+  if (webglProbe === null) {
+    try {
+      const c = document.createElement("canvas");
+      webglProbe = !!(c.getContext("webgl2") || c.getContext("webgl"));
+    } catch {
+      webglProbe = false;
+    }
+  }
+  return webglProbe;
+}
+function useThreeStage(pin, options) {
+  const optsRef = react.useRef(options);
+  optsRef.current = options;
+  react.useEffect(() => {
+    const pinEl = pin.current;
+    if (!pinEl) return;
+    const o = optsRef.current;
+    if (o.enabled === false || o.enabled === void 0 && !canRunWebGL()) return;
+    const host = o.mount?.current ?? pinEl.querySelector("[data-sk-stage]") ?? pinEl;
+    const canvas = document.createElement("canvas");
+    Object.assign(canvas.style, {
+      position: "absolute",
+      inset: "0",
+      width: "100%",
+      height: "100%",
+      display: "block",
+      pointerEvents: "none"
+    });
+    canvas.setAttribute("data-sk-three", "");
+    canvas.setAttribute("aria-hidden", "true");
+    if (getComputedStyle(host).position === "static") host.style.position = "relative";
+    host.prepend(canvas);
+    let renderer;
+    try {
+      renderer = new three.WebGLRenderer({
+        canvas,
+        alpha: o.alpha ?? true,
+        antialias: o.antialias ?? true,
+        powerPreference: "high-performance"
+      });
+    } catch {
+      canvas.remove();
+      return;
+    }
+    const scene = new three.Scene();
+    const camera = new three.PerspectiveCamera(o.fov ?? 50, 1, o.near ?? 0.1, o.far ?? 1e3);
+    const stage = { renderer, scene, camera, canvas, width: 1, height: 1, dpr: 1 };
+    const size = () => {
+      const w = host.clientWidth || 1;
+      const h = host.clientHeight || 1;
+      stage.width = w;
+      stage.height = h;
+      stage.dpr = Math.min(window.devicePixelRatio || 1, optsRef.current.maxDpr ?? 1.75);
+      renderer.setPixelRatio(stage.dpr);
+      renderer.setSize(w, h, false);
+      camera.aspect = w / h;
+      camera.updateProjectionMatrix();
+      optsRef.current.onResize?.(stage);
+    };
+    size();
+    let lost = false;
+    const onLost = (e) => {
+      e.preventDefault();
+      lost = true;
+    };
+    const onRestored = () => {
+      lost = false;
+      chunkAEW7EFYU_js.refreshScenes();
+    };
+    canvas.addEventListener("webglcontextlost", onLost);
+    canvas.addEventListener("webglcontextrestored", onRestored);
+    const ro = new ResizeObserver(() => {
+      size();
+      chunkAEW7EFYU_js.refreshScenes();
+    });
+    ro.observe(host);
+    const cleanupReady = optsRef.current.onReady?.(stage);
+    const unregister = chunkAEW7EFYU_js.registerScene(
+      pinEl,
+      (p, info) => {
+        if (lost) return;
+        optsRef.current.render(p, stage, info);
+      },
+      { continuous: o.continuous, reducedP: o.reducedP, lerp: o.lerp, mode: "pin" }
+    );
+    const evt = o.readyEvent === false ? null : o.readyEvent ?? "sk:scene-ready";
+    if (evt) pinEl.dispatchEvent(new CustomEvent(evt, { bubbles: true }));
+    return () => {
+      unregister();
+      ro.disconnect();
+      canvas.removeEventListener("webglcontextlost", onLost);
+      canvas.removeEventListener("webglcontextrestored", onRestored);
+      if (typeof cleanupReady === "function") cleanupReady();
+      disposeObject(scene);
+      renderer.dispose();
+      canvas.remove();
+    };
+  }, [pin]);
+}
+function loadTexture(url, options = {}) {
+  return new Promise((resolve) => {
+    const loader = new three.TextureLoader();
+    loader.setCrossOrigin(options.crossOrigin ?? "anonymous");
+    loader.load(
+      url,
+      (t) => {
+        t.colorSpace = options.colorSpace ?? three.SRGBColorSpace;
+        resolve(t);
+      },
+      void 0,
+      () => resolve(null)
+    );
+  });
+}
+function disposeObject(root) {
+  root.traverse((obj) => {
+    const mesh = obj;
+    mesh.geometry?.dispose();
+    const mats = Array.isArray(mesh.material) ? mesh.material : mesh.material ? [mesh.material] : [];
+    for (const m of mats) {
+      for (const v of Object.values(m)) {
+        if (v && typeof v === "object" && v.isTexture) {
+          v.dispose();
+        }
+      }
+      m.dispose();
+    }
+  });
+}
+
+exports.canRunWebGL = canRunWebGL;
+exports.disposeObject = disposeObject;
+exports.loadTexture = loadTexture;
+exports.useThreeStage = useThreeStage;
+//# sourceMappingURL=three.js.map
+//# sourceMappingURL=three.js.map

package/dist/motion/three.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/motion/three.ts"],"names":["prefersReducedMotion","useRef","useEffect","WebGLRenderer","Scene","PerspectiveCamera","refreshScenes","registerScene","TextureLoader","SRGBColorSpace"],"mappings":"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","file":"three.js","sourcesContent":["/**\n * @sonordev/site-kit/motion/three — the Upforge motion standard, tier 2.\n *\n * WebGL stages driven by the scroll engine. Requires the optional peer\n * `three` (~180KB gzipped — flagship builds only):\n *\n *     npm i three && npm i -D @types/three\n *\n * A site that never imports this subpath never installs three. NOTHING\n * outside this file may import from 'three' (src/motion/motion.test.tsx\n * enforces it).\n *\n * How it must be used, so the page still ranks and still paints fast:\n *\n *   - The scene component that calls `useThreeStage` is loaded with\n *     `dynamic(() => import('./Scene'), { ssr: false })` and mounted as a\n *     CHILDLESS sibling next to the server-rendered stage — never wrapping\n *     it. The copy stays in the HTML; three arrives as its own chunk, on\n *     approach.\n *   - The canvas is created here at runtime and slotted behind the stage's\n *     content. Give that content `position: relative` (and a z-index if\n *     needed) so it paints above the canvas.\n *   - Every word of copy lives in the DOM, never in the canvas.\n *   - `canRunWebGL()` is false under reduced motion, Save-Data, or without\n *     WebGL; the hook then mounts nothing and the visitor keeps the\n *     server-rendered still. Mobile gets composed stills by design.\n *   - Byte budget: ≤5MB of models/textures per scene, fetched on approach.\n *\n * upforgelabs.com is the reference build (components/cinema/SiteScene.tsx).\n */\n\n'use client'\n\nimport { useEffect, useRef, type RefObject } from 'react'\nimport {\n  PerspectiveCamera,\n  Scene,\n  SRGBColorSpace,\n  TextureLoader,\n  WebGLRenderer,\n  type Object3D,\n  type Texture,\n} from 'three'\nimport { prefersReducedMotion, refreshScenes, registerScene, type SceneInfo, type SceneOptions } from './engine'\n\nlet webglProbe: boolean | null = null\n\n/**\n * Whether a WebGL scene should run for this visitor at all. False under\n * prefers-reduced-motion, Save-Data, or when the browser has no WebGL.\n * Always false on the server.\n */\nexport function canRunWebGL(): boolean {\n  if (typeof window === 'undefined') return false\n  if (prefersReducedMotion()) return false\n  const nav = navigator as Navigator & { connection?: { saveData?: boolean } }\n  if (nav.connection?.saveData) return false\n  if (webglProbe === null) {\n    try {\n      const c = document.createElement('canvas')\n      webglProbe = !!(c.getContext('webgl2') || c.getContext('webgl'))\n    } catch {\n      webglProbe = false\n    }\n  }\n  return webglProbe\n}\n\nexport interface ThreeStage {\n  renderer: WebGLRenderer\n  scene: Scene\n  camera: PerspectiveCamera\n  canvas: HTMLCanvasElement\n  /** CSS pixel size of the stage. */\n  width: number\n  height: number\n  dpr: number\n}\n\nexport interface UseThreeStageOptions extends Pick<SceneOptions, 'continuous' | 'reducedP' | 'lerp'> {\n  /** Draw the frame for progress p. Called only while the scene is near the viewport. */\n  render: (p: number, stage: ThreeStage, info: SceneInfo) => void\n  /** Build the scene. May return a cleanup for anything it allocated outside the scene graph. */\n  onReady?: (stage: ThreeStage) => void | (() => void)\n  /** Called after every resize, with the camera already updated. */\n  onResize?: (stage: ThreeStage) => void\n  /**\n   * Element the canvas fills and is sized to. Default: the pin's\n   * `[data-sk-stage]` child (what <ScrollScene> renders), else the pin.\n   */\n  mount?: RefObject<HTMLElement | null>\n  /** Cap on devicePixelRatio. Default 1.75. */\n  maxDpr?: number\n  alpha?: boolean\n  antialias?: boolean\n  fov?: number\n  near?: number\n  far?: number\n  /** DOM event dispatched on the pin once the stage is ready. Default \"sk:scene-ready\"; false to skip. */\n  readyEvent?: string | false\n  /** Override the canRunWebGL() gate. */\n  enabled?: boolean\n}\n\n/**\n * Mount a three.js renderer on a pinned scene and drive it from scroll.\n * Owns the canvas, sizing, DPR, context loss, and disposal.\n *\n * @example\n *   // Scene.tsx — loaded with dynamic(..., { ssr: false }) as a childless sibling\n *   'use client'\n *   export default function Scene({ pin }: { pin: RefObject<HTMLElement | null> }) {\n *     useThreeStage(pin, {\n *       onReady: ({ scene, camera }) => { camera.position.z = 5; scene.add(mesh) },\n *       render: (p, { renderer, scene, camera }) => {\n *         camera.position.z = 5 - p * 4\n *         renderer.render(scene, camera)\n *       },\n *     })\n *     return null\n *   }\n */\nexport function useThreeStage(pin: RefObject<HTMLElement | null>, options: UseThreeStageOptions): void {\n  const optsRef = useRef(options)\n  optsRef.current = options\n\n  useEffect(() => {\n    const pinEl = pin.current\n    if (!pinEl) return\n    const o = optsRef.current\n    if (o.enabled === false || (o.enabled === undefined && !canRunWebGL())) return\n\n    const host =\n      o.mount?.current ??\n      (pinEl.querySelector('[data-sk-stage]') as HTMLElement | null) ??\n      pinEl\n\n    const canvas = document.createElement('canvas')\n    Object.assign(canvas.style, {\n      position: 'absolute',\n      inset: '0',\n      width: '100%',\n      height: '100%',\n      display: 'block',\n      pointerEvents: 'none',\n    } satisfies Partial<CSSStyleDeclaration>)\n    canvas.setAttribute('data-sk-three', '')\n    canvas.setAttribute('aria-hidden', 'true')\n    if (getComputedStyle(host).position === 'static') host.style.position = 'relative'\n    host.prepend(canvas)\n\n    let renderer: WebGLRenderer\n    try {\n      renderer = new WebGLRenderer({\n        canvas,\n        alpha: o.alpha ?? true,\n        antialias: o.antialias ?? true,\n        powerPreference: 'high-performance',\n      })\n    } catch {\n      canvas.remove()\n      return\n    }\n\n    const scene = new Scene()\n    const camera = new PerspectiveCamera(o.fov ?? 50, 1, o.near ?? 0.1, o.far ?? 1000)\n    const stage: ThreeStage = { renderer, scene, camera, canvas, width: 1, height: 1, dpr: 1 }\n\n    const size = () => {\n      const w = host.clientWidth || 1\n      const h = host.clientHeight || 1\n      stage.width = w\n      stage.height = h\n      stage.dpr = Math.min(window.devicePixelRatio || 1, optsRef.current.maxDpr ?? 1.75)\n      renderer.setPixelRatio(stage.dpr)\n      renderer.setSize(w, h, false)\n      camera.aspect = w / h\n      camera.updateProjectionMatrix()\n      optsRef.current.onResize?.(stage)\n    }\n    size()\n\n    let lost = false\n    const onLost = (e: Event) => {\n      e.preventDefault()\n      lost = true\n    }\n    const onRestored = () => {\n      lost = false\n      refreshScenes()\n    }\n    canvas.addEventListener('webglcontextlost', onLost)\n    canvas.addEventListener('webglcontextrestored', onRestored)\n\n    const ro = new ResizeObserver(() => {\n      size()\n      refreshScenes()\n    })\n    ro.observe(host)\n\n    const cleanupReady = optsRef.current.onReady?.(stage)\n\n    const unregister = registerScene(\n      pinEl,\n      (p, info) => {\n        if (lost) return\n        optsRef.current.render(p, stage, info)\n      },\n      { continuous: o.continuous, reducedP: o.reducedP, lerp: o.lerp, mode: 'pin' },\n    )\n\n    const evt = o.readyEvent === false ? null : (o.readyEvent ?? 'sk:scene-ready')\n    if (evt) pinEl.dispatchEvent(new CustomEvent(evt, { bubbles: true }))\n\n    return () => {\n      unregister()\n      ro.disconnect()\n      canvas.removeEventListener('webglcontextlost', onLost)\n      canvas.removeEventListener('webglcontextrestored', onRestored)\n      if (typeof cleanupReady === 'function') cleanupReady()\n      disposeObject(scene)\n      renderer.dispose()\n      canvas.remove()\n    }\n  }, [pin])\n}\n\n/**\n * Load a texture and never throw: resolves null on any failure (a\n * cross-origin image without CORS headers, a 404), so one bad asset can't\n * take a whole scene down. sRGB by default, which is right for photographs\n * and screenshots.\n */\nexport function loadTexture(\n  url: string,\n  options: { crossOrigin?: string; colorSpace?: Texture['colorSpace'] } = {},\n): Promise<Texture | null> {\n  return new Promise((resolve) => {\n    const loader = new TextureLoader()\n    loader.setCrossOrigin(options.crossOrigin ?? 'anonymous')\n    loader.load(\n      url,\n      (t) => {\n        t.colorSpace = options.colorSpace ?? SRGBColorSpace\n        resolve(t)\n      },\n      undefined,\n      () => resolve(null),\n    )\n  })\n}\n\n/** Dispose every geometry, material, and texture under `root`. */\nexport function disposeObject(root: Object3D): void {\n  root.traverse((obj) => {\n    const mesh = obj as Object3D & {\n      geometry?: { dispose(): void }\n      material?: unknown\n    }\n    mesh.geometry?.dispose()\n    const mats = Array.isArray(mesh.material) ? mesh.material : mesh.material ? [mesh.material] : []\n    for (const m of mats as Array<Record<string, unknown> & { dispose(): void }>) {\n      for (const v of Object.values(m)) {\n        if (v && typeof v === 'object' && (v as { isTexture?: boolean }).isTexture) {\n          ;(v as Texture).dispose()\n        }\n      }\n      m.dispose()\n    }\n  })\n}\n"]}