@sonordev/site-kit 5.0.0 → 5.3.0

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"]}

package/dist/motion/three.mjs

@@ -0,0 +1,145 @@
+'use client';
+import { prefersReducedMotion, refreshScenes, registerScene } from '../chunk-MLXUMVBK.mjs';
+import '../chunk-BEXTDHO4.mjs';
+import { useRef, useEffect } from 'react';
+import { WebGLRenderer, Scene, PerspectiveCamera, TextureLoader, SRGBColorSpace } from 'three';
+
+var webglProbe = null;
+function canRunWebGL() {
+  if (typeof window === "undefined") return false;
+  if (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 = useRef(options);
+  optsRef.current = options;
+  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 WebGLRenderer({
+        canvas,
+        alpha: o.alpha ?? true,
+        antialias: o.antialias ?? true,
+        powerPreference: "high-performance"
+      });
+    } catch {
+      canvas.remove();
+      return;
+    }
+    const scene = new Scene();
+    const camera = new 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;
+      refreshScenes();
+    };
+    canvas.addEventListener("webglcontextlost", onLost);
+    canvas.addEventListener("webglcontextrestored", onRestored);
+    const ro = new ResizeObserver(() => {
+      size();
+      refreshScenes();
+    });
+    ro.observe(host);
+    const cleanupReady = optsRef.current.onReady?.(stage);
+    const unregister = 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 TextureLoader();
+    loader.setCrossOrigin(options.crossOrigin ?? "anonymous");
+    loader.load(
+      url,
+      (t) => {
+        t.colorSpace = options.colorSpace ?? 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();
+    }
+  });
+}
+
+export { canRunWebGL, disposeObject, loadTexture, useThreeStage };
+//# sourceMappingURL=three.mjs.map
+//# sourceMappingURL=three.mjs.map

package/dist/motion/three.mjs.map

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

package/dist/search/index.js

@@ -2,9 +2,9 @@
 'use strict';
 
 var chunkG2WC3CXW_js = require('../chunk-G2WC3CXW.js');
-var chunk4D2G5ZNP_js = require('../chunk-4D2G5ZNP.js');
-require('../chunk-FQ3JQV3M.js');
-require('../chunk-S65JSRWW.js');
+var chunkRMLRZOVE_js = require('../chunk-RMLRZOVE.js');
+require('../chunk-7NMI7M56.js');
+require('../chunk-BIZT7AYK.js');
 require('../chunk-SNAQBZPT.js');
 var react = require('react');
 var jsxRuntime = require('react/jsx-runtime');
@@ -39,7 +39,7 @@ function useSiteSearch(options = {}) {
         const apiUrl = typeof window !== "undefined" ? window.__SITE_KIT_API_URL__ || "https://api.sonor.io" : "https://api.sonor.io";
         const apiKey = typeof window !== "undefined" ? window.__SITE_KIT_API_KEY__ : void 0;
         const resolvedSite = site ?? (typeof window !== "undefined" ? window.__SITE_KIT_SITE__ : void 0);
-        const res = await chunk4D2G5ZNP_js.sonorFetch(
+        const res = await chunkRMLRZOVE_js.sonorFetch(
           `${apiUrl}${chunkG2WC3CXW_js.SEARCH_ENDPOINT}`,
           {
             method: "POST",

package/dist/search/index.mjs

@@ -1,9 +1,9 @@
 'use client';
 import { SEARCH_ENDPOINT } from '../chunk-75A4KY4X.mjs';
 export { SEARCH_ENDPOINT } from '../chunk-75A4KY4X.mjs';
-import { sonorFetch } from '../chunk-4UHO6DPJ.mjs';
-import '../chunk-FDWDXMJL.mjs';
-import '../chunk-JPTJGLKS.mjs';
+import { sonorFetch } from '../chunk-F4DZH4E5.mjs';
+import '../chunk-HHX72A2B.mjs';
+import '../chunk-3PTKHSF7.mjs';
 import '../chunk-BEXTDHO4.mjs';
 import { useState, useRef, useCallback, useEffect } from 'react';
 import { jsxs, jsx } from 'react/jsx-runtime';

package/dist/seo/client.js

@@ -1,18 +1,18 @@
 'use client';
 'use strict';
 
-var chunkOGPS3DKE_js = require('../chunk-OGPS3DKE.js');
+var chunkB7FHRTBA_js = require('../chunk-B7FHRTBA.js');
 require('../chunk-JEOKDUPQ.js');
-require('../chunk-4D2G5ZNP.js');
-require('../chunk-FQ3JQV3M.js');
-require('../chunk-S65JSRWW.js');
+require('../chunk-RMLRZOVE.js');
+require('../chunk-7NMI7M56.js');
+require('../chunk-BIZT7AYK.js');
 require('../chunk-SNAQBZPT.js');
 
 
 
 Object.defineProperty(exports, "SitemapSync", {
   enumerable: true,
-  get: function () { return chunkOGPS3DKE_js.SitemapSync; }
+  get: function () { return chunkB7FHRTBA_js.SitemapSync; }
 });
 //# sourceMappingURL=client.js.map
 //# sourceMappingURL=client.js.map

package/dist/seo/client.mjs

@@ -1,9 +1,9 @@
 'use client';
-export { SitemapSync } from '../chunk-J4JXAFSW.mjs';
+export { SitemapSync } from '../chunk-XRONA2QL.mjs';
 import '../chunk-QJU6HBSK.mjs';
-import '../chunk-4UHO6DPJ.mjs';
-import '../chunk-FDWDXMJL.mjs';
-import '../chunk-JPTJGLKS.mjs';
+import '../chunk-F4DZH4E5.mjs';
+import '../chunk-HHX72A2B.mjs';
+import '../chunk-3PTKHSF7.mjs';
 import '../chunk-BEXTDHO4.mjs';
 //# sourceMappingURL=client.mjs.map
 //# sourceMappingURL=client.mjs.map

package/dist/seo/index.js

@@ -3,14 +3,14 @@
 var chunkDV2LJYFD_js = require('../chunk-DV2LJYFD.js');
 var chunkH6AU3WKF_js = require('../chunk-H6AU3WKF.js');
 var chunkJ7QI3GDX_js = require('../chunk-J7QI3GDX.js');
-var chunkOGPS3DKE_js = require('../chunk-OGPS3DKE.js');
+var chunkB7FHRTBA_js = require('../chunk-B7FHRTBA.js');
 var chunkL2LJQIM3_js = require('../chunk-L2LJQIM3.js');
 var chunk3TXX5KIN_js = require('../chunk-3TXX5KIN.js');
 require('../chunk-O5GHP7UO.js');
 require('../chunk-JEOKDUPQ.js');
-require('../chunk-4D2G5ZNP.js');
-require('../chunk-FQ3JQV3M.js');
-require('../chunk-S65JSRWW.js');
+require('../chunk-RMLRZOVE.js');
+require('../chunk-7NMI7M56.js');
+require('../chunk-BIZT7AYK.js');
 require('../chunk-SNAQBZPT.js');
 var react = require('react');
 var jsxRuntime = require('react/jsx-runtime');
@@ -687,7 +687,7 @@ Object.defineProperty(exports, "ManagedScripts", {
 });
 Object.defineProperty(exports, "SitemapSync", {
   enumerable: true,
-  get: function () { return chunkOGPS3DKE_js.SitemapSync; }
+  get: function () { return chunkB7FHRTBA_js.SitemapSync; }
 });
 Object.defineProperty(exports, "generateSitemap", {
   enumerable: true,

package/dist/seo/index.mjs

@@ -1,16 +1,16 @@
 export { ManagedNoScripts, ManagedScripts } from '../chunk-6PJTLBRR.mjs';
 import { pickManagedLlmSchemaForJsonLd } from '../chunk-PENNTSJE.mjs';
 import { safeJsonLd } from '../chunk-662YHKWW.mjs';
-export { SitemapSync } from '../chunk-J4JXAFSW.mjs';
+export { SitemapSync } from '../chunk-XRONA2QL.mjs';
 import { getManagedMetadata } from '../chunk-B4BFQSSS.mjs';
 export { generateSitemap, getABVariant, getManagedMetadata, getManagedMetadataWithAB, getRedirect, getRobotsDirective, isIndexable } from '../chunk-B4BFQSSS.mjs';
 import { getContentBlock, getSchemaMarkups, getSEOPageData, getEntityEnhancedSchema, getFAQData, getInternalLinks, getEntities } from '../chunk-UOTXSWKZ.mjs';
 export { getABTest, getContentBlock, getEntities, getEntityEnhancedSchema, getFAQData, getInternalLinks, getManagedScripts, getPrimaryEntity, getRedirectData, getRobotsData, getSEOPageData, getSchemaMarkups, getSitemapEntries, getVisibilityScore, getVisibilitySummary, recordABImpression, registerSitemap } from '../chunk-UOTXSWKZ.mjs';
 import '../chunk-6XNEGG5B.mjs';
 import '../chunk-QJU6HBSK.mjs';
-import '../chunk-4UHO6DPJ.mjs';
-import '../chunk-FDWDXMJL.mjs';
-import '../chunk-JPTJGLKS.mjs';
+import '../chunk-F4DZH4E5.mjs';
+import '../chunk-HHX72A2B.mjs';
+import '../chunk-3PTKHSF7.mjs';
 import '../chunk-BEXTDHO4.mjs';
 import { cache, Suspense } from 'react';
 import { jsx, jsxs, Fragment } from 'react/jsx-runtime';

package/dist/server/index.js

@@ -1,15 +1,15 @@
 'use strict';
 
-var chunkDX6D7HDI_js = require('../chunk-DX6D7HDI.js');
+var chunkXZI6KUB3_js = require('../chunk-XZI6KUB3.js');
 var chunkO5GHP7UO_js = require('../chunk-O5GHP7UO.js');
-require('../chunk-S65JSRWW.js');
+require('../chunk-BIZT7AYK.js');
 require('../chunk-SNAQBZPT.js');
 
 
 
 Object.defineProperty(exports, "resolveClientCredential", {
   enumerable: true,
-  get: function () { return chunkDX6D7HDI_js.resolveClientCredential; }
+  get: function () { return chunkXZI6KUB3_js.resolveClientCredential; }
 });
 Object.defineProperty(exports, "requireServerApiConfig", {
   enumerable: true,

package/dist/server/index.mjs

@@ -1,6 +1,6 @@
-export { resolveClientCredential } from '../chunk-SW6KWUNI.mjs';
+export { resolveClientCredential } from '../chunk-6RYCAW5B.mjs';
 export { requireServerApiConfig, resolveApiOrigin, resolveServerApiConfig, serverApiFetch } from '../chunk-6XNEGG5B.mjs';
-import '../chunk-JPTJGLKS.mjs';
+import '../chunk-3PTKHSF7.mjs';
 import '../chunk-BEXTDHO4.mjs';
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map

package/dist/shared/build-entries.d.ts

@@ -98,6 +98,12 @@ export declare const entry: {
     readonly 'cms/index': 'src/cms/index.ts';
     readonly 'cms/server': 'src/cms/server.ts';
     readonly 'maps/index': 'src/maps/index.ts';
+    /** Tier 0: zero-dep Reveal / Parallax / ScrollScene on the scroll engine */
+    readonly 'motion/index': 'src/motion/index.ts';
+    /** Tier 1: GSAP, lazy-loaded — optional peer `gsap`; only this file may import it */
+    readonly 'motion/gsap': 'src/motion/gsap.ts';
+    /** Tier 2: three.js stages on the engine — optional peer `three`; only this file may import it */
+    readonly 'motion/three': 'src/motion/three.ts';
     readonly 'cli/index': 'src/cli/index.ts';
 };
 /**
@@ -114,7 +120,7 @@ export declare const entry: {
  * `server-only` module. Add new client entries HERE — that keeps the stamp and
  * the guard reading the same list.
  */
-export declare const CLIENT_ENTRIES: readonly ["forms/index", "search/index", "analytics/index", "seo/client", "engage/index", "signal/index", "commerce/index", "layout/client", "client/index", "fleet/index", "blog/index", "maps/index", "mcp/client"];
+export declare const CLIENT_ENTRIES: readonly ["forms/index", "search/index", "analytics/index", "seo/client", "engage/index", "signal/index", "commerce/index", "layout/client", "client/index", "fleet/index", "blog/index", "maps/index", "mcp/client", "motion/index", "motion/gsap", "motion/three"];
 /**
  * CLI binaries are consumed via `bin`/`npx`, never imported as typed modules, so they
  * don't ship `.d.ts`. Everything else in `entry` gets declarations.