@react-three-dom/cypress 0.1.0

package/dist/index.cjs

@@ -0,0 +1,290 @@
+'use strict';
+
+// src/commands.ts
+function getR3F(win) {
+  const api = win.__R3F_DOM__;
+  if (!api) {
+    throw new Error(
+      "react-three-dom bridge not found. Is <ThreeDom> mounted in your app?"
+    );
+  }
+  return api;
+}
+function registerCommands() {
+  Cypress.Commands.add("r3fClick", (idOrUuid) => {
+    cy.window({ log: false }).then((win) => {
+      getR3F(win).click(idOrUuid);
+    });
+  });
+  Cypress.Commands.add("r3fDoubleClick", (idOrUuid) => {
+    cy.window({ log: false }).then((win) => {
+      getR3F(win).doubleClick(idOrUuid);
+    });
+  });
+  Cypress.Commands.add("r3fContextMenu", (idOrUuid) => {
+    cy.window({ log: false }).then((win) => {
+      getR3F(win).contextMenu(idOrUuid);
+    });
+  });
+  Cypress.Commands.add("r3fHover", (idOrUuid) => {
+    cy.window({ log: false }).then((win) => {
+      getR3F(win).hover(idOrUuid);
+    });
+  });
+  Cypress.Commands.add(
+    "r3fDrag",
+    (idOrUuid, delta) => {
+      cy.window({ log: false }).then((win) => {
+        getR3F(win).drag(idOrUuid, delta);
+      });
+    }
+  );
+  Cypress.Commands.add(
+    "r3fWheel",
+    (idOrUuid, options) => {
+      cy.window({ log: false }).then((win) => {
+        getR3F(win).wheel(idOrUuid, options);
+      });
+    }
+  );
+  Cypress.Commands.add("r3fPointerMiss", () => {
+    cy.window({ log: false }).then((win) => {
+      getR3F(win).pointerMiss();
+    });
+  });
+  Cypress.Commands.add("r3fSelect", (idOrUuid) => {
+    cy.window({ log: false }).then((win) => {
+      getR3F(win).select(idOrUuid);
+    });
+  });
+  Cypress.Commands.add("r3fClearSelection", () => {
+    cy.window({ log: false }).then((win) => {
+      getR3F(win).clearSelection();
+    });
+  });
+  Cypress.Commands.add("r3fGetObject", (idOrUuid) => {
+    return cy.window({ log: false }).then((win) => {
+      const api = getR3F(win);
+      return api.getByTestId(idOrUuid) ?? api.getByUuid(idOrUuid) ?? null;
+    });
+  });
+  Cypress.Commands.add("r3fInspect", (idOrUuid) => {
+    return cy.window({ log: false }).then((win) => {
+      return getR3F(win).inspect(idOrUuid);
+    });
+  });
+  Cypress.Commands.add("r3fSnapshot", () => {
+    return cy.window({ log: false }).then((win) => {
+      return getR3F(win).snapshot();
+    });
+  });
+  Cypress.Commands.add("r3fGetCount", () => {
+    return cy.window({ log: false }).then((win) => {
+      return getR3F(win).getCount();
+    });
+  });
+}
+
+// src/assertions.ts
+function getR3FFromWindow() {
+  const win = cy.state("window");
+  const api = win?.__R3F_DOM__;
+  if (!api) {
+    throw new Error("react-three-dom bridge not found. Is <ThreeDom> mounted?");
+  }
+  return api;
+}
+function resolveObject(api, idOrUuid) {
+  return api.getByTestId(idOrUuid) ?? api.getByUuid(idOrUuid) ?? null;
+}
+function registerAssertions() {
+  chai.use((_chai) => {
+    const { Assertion } = _chai;
+    Assertion.addMethod("r3fExist", function(idOrUuid) {
+      const api = getR3FFromWindow();
+      const meta = resolveObject(api, idOrUuid);
+      this.assert(
+        meta !== null,
+        `expected 3D object "${idOrUuid}" to exist in the scene`,
+        `expected 3D object "${idOrUuid}" to NOT exist in the scene`,
+        "exists",
+        meta === null ? "not found" : "found"
+      );
+    });
+    Assertion.addMethod("r3fVisible", function(idOrUuid) {
+      const api = getR3FFromWindow();
+      const meta = resolveObject(api, idOrUuid);
+      if (!meta) {
+        throw new Error(`3D object "${idOrUuid}" not found in the scene`);
+      }
+      this.assert(
+        meta.visible,
+        `expected 3D object "${idOrUuid}" to be visible`,
+        `expected 3D object "${idOrUuid}" to NOT be visible`,
+        true,
+        meta.visible
+      );
+    });
+    Assertion.addMethod("r3fInFrustum", function(idOrUuid) {
+      const api = getR3FFromWindow();
+      const inspection = api.inspect(idOrUuid);
+      if (!inspection) {
+        throw new Error(`3D object "${idOrUuid}" not found in the scene`);
+      }
+      const { bounds } = inspection;
+      const isFinite = (v) => v.every(Number.isFinite);
+      const inFrustum = isFinite(bounds.min) && isFinite(bounds.max);
+      this.assert(
+        inFrustum,
+        `expected 3D object "${idOrUuid}" to be in the camera frustum`,
+        `expected 3D object "${idOrUuid}" to NOT be in the camera frustum`,
+        "in frustum",
+        inFrustum ? "in frustum" : "out of frustum / invalid bounds"
+      );
+    });
+    Assertion.addMethod(
+      "r3fPosition",
+      function(idOrUuid, expected, tolerance = 0.01) {
+        const api = getR3FFromWindow();
+        const meta = resolveObject(api, idOrUuid);
+        if (!meta) {
+          throw new Error(`3D object "${idOrUuid}" not found in the scene`);
+        }
+        const [ex, ey, ez] = expected;
+        const [ax, ay, az] = meta.position;
+        const pass = Math.abs(ax - ex) <= tolerance && Math.abs(ay - ey) <= tolerance && Math.abs(az - ez) <= tolerance;
+        this.assert(
+          pass,
+          `expected 3D object "${idOrUuid}" to be at [${expected}] (\xB1${tolerance}), but was at [${meta.position}]`,
+          `expected 3D object "${idOrUuid}" to NOT be at [${expected}] (\xB1${tolerance})`,
+          expected,
+          meta.position
+        );
+      }
+    );
+    Assertion.addMethod(
+      "r3fInstanceCount",
+      function(idOrUuid, expectedCount) {
+        const api = getR3FFromWindow();
+        const meta = resolveObject(api, idOrUuid);
+        if (!meta) {
+          throw new Error(`3D object "${idOrUuid}" not found in the scene`);
+        }
+        const actual = meta.instanceCount ?? 0;
+        this.assert(
+          actual === expectedCount,
+          `expected 3D object "${idOrUuid}" to have instance count ${expectedCount}, but had ${actual}`,
+          `expected 3D object "${idOrUuid}" to NOT have instance count ${expectedCount}`,
+          expectedCount,
+          actual
+        );
+      }
+    );
+    Assertion.addMethod(
+      "r3fBounds",
+      function(idOrUuid, expected, tolerance = 0.1) {
+        const api = getR3FFromWindow();
+        const inspection = api.inspect(idOrUuid);
+        if (!inspection) {
+          throw new Error(`3D object "${idOrUuid}" not found in the scene`);
+        }
+        const { bounds } = inspection;
+        const withinTol = (a, b) => a.every((v, i) => Math.abs(v - b[i]) <= tolerance);
+        const pass = withinTol(bounds.min, expected.min) && withinTol(bounds.max, expected.max);
+        this.assert(
+          pass,
+          `expected 3D object "${idOrUuid}" bounds to be min:${JSON.stringify(expected.min)} max:${JSON.stringify(expected.max)} (\xB1${tolerance}), but got min:${JSON.stringify(bounds.min)} max:${JSON.stringify(bounds.max)}`,
+          `expected 3D object "${idOrUuid}" bounds to NOT match`,
+          expected,
+          bounds
+        );
+      }
+    );
+  });
+}
+
+// src/waiters.ts
+function registerWaiters() {
+  Cypress.Commands.add(
+    "r3fWaitForSceneReady",
+    (options = {}) => {
+      const {
+        stableChecks = 3,
+        pollIntervalMs = 100,
+        timeout = 1e4
+      } = options;
+      const startTime = Date.now();
+      let lastCount = -1;
+      let stableRuns = 0;
+      function poll() {
+        if (Date.now() - startTime > timeout) {
+          throw new Error(
+            `r3fWaitForSceneReady timed out after ${timeout}ms. Last count: ${lastCount}, stable runs: ${stableRuns}/${stableChecks}`
+          );
+        }
+        return cy.window({ log: false }).then((win) => {
+          const api = win.__R3F_DOM__;
+          if (!api) {
+            return cy.wait(pollIntervalMs, { log: false }).then(() => poll());
+          }
+          const count = api.getCount();
+          if (count === lastCount && count > 0) {
+            stableRuns++;
+            if (stableRuns >= stableChecks) {
+              return;
+            }
+          } else {
+            stableRuns = 0;
+          }
+          lastCount = count;
+          return cy.wait(pollIntervalMs, { log: false }).then(() => poll());
+        });
+      }
+      return poll();
+    }
+  );
+  Cypress.Commands.add(
+    "r3fWaitForIdle",
+    (options = {}) => {
+      const {
+        idleChecks = 10,
+        pollIntervalMs = 50,
+        timeout = 1e4
+      } = options;
+      const startTime = Date.now();
+      let lastJson = "";
+      let stableCount = 0;
+      function poll() {
+        if (Date.now() - startTime > timeout) {
+          throw new Error(`r3fWaitForIdle timed out after ${timeout}ms`);
+        }
+        return cy.window({ log: false }).then((win) => {
+          const api = win.__R3F_DOM__;
+          if (!api) {
+            return cy.wait(pollIntervalMs, { log: false }).then(() => poll());
+          }
+          const snap = api.snapshot();
+          const json = JSON.stringify(snap.tree);
+          if (json === lastJson && json !== "") {
+            stableCount++;
+            if (stableCount >= idleChecks) {
+              return;
+            }
+          } else {
+            stableCount = 0;
+          }
+          lastJson = json;
+          return cy.wait(pollIntervalMs, { log: false }).then(() => poll());
+        });
+      }
+      return poll();
+    }
+  );
+}
+
+// src/index.ts
+registerCommands();
+registerAssertions();
+registerWaiters();
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands.ts","../src/assertions.ts","../src/waiters.ts","../src/index.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["/// <reference types=\"cypress\" />\nimport type { R3FDOM } from './types';\n\n// ---------------------------------------------------------------------------\n// Helper to get the R3F DOM bridge from the current window\n// ---------------------------------------------------------------------------\n\nfunction getR3F(win: Cypress.AUTWindow): R3FDOM {\n  const api = (win as Window & { __R3F_DOM__?: R3FDOM }).__R3F_DOM__;\n  if (!api) {\n    throw new Error(\n      'react-three-dom bridge not found. Is <ThreeDom> mounted in your app?',\n    );\n  }\n  return api;\n}\n\n// ---------------------------------------------------------------------------\n// Custom commands — all prefixed with `r3f` for clarity\n// ---------------------------------------------------------------------------\n\nexport function registerCommands(): void {\n  Cypress.Commands.add('r3fClick', (idOrUuid: string) => {\n    cy.window({ log: false }).then((win) => {\n      getR3F(win).click(idOrUuid);\n    });\n  });\n\n  Cypress.Commands.add('r3fDoubleClick', (idOrUuid: string) => {\n    cy.window({ log: false }).then((win) => {\n      getR3F(win).doubleClick(idOrUuid);\n    });\n  });\n\n  Cypress.Commands.add('r3fContextMenu', (idOrUuid: string) => {\n    cy.window({ log: false }).then((win) => {\n      getR3F(win).contextMenu(idOrUuid);\n    });\n  });\n\n  Cypress.Commands.add('r3fHover', (idOrUuid: string) => {\n    cy.window({ log: false }).then((win) => {\n      getR3F(win).hover(idOrUuid);\n    });\n  });\n\n  Cypress.Commands.add(\n    'r3fDrag',\n    (idOrUuid: string, delta: { x: number; y: number; z: number }) => {\n      cy.window({ log: false }).then((win) => {\n        getR3F(win).drag(idOrUuid, delta);\n      });\n    },\n  );\n\n  Cypress.Commands.add(\n    'r3fWheel',\n    (idOrUuid: string, options?: { deltaY?: number; deltaX?: number }) => {\n      cy.window({ log: false }).then((win) => {\n        getR3F(win).wheel(idOrUuid, options);\n      });\n    },\n  );\n\n  Cypress.Commands.add('r3fPointerMiss', () => {\n    cy.window({ log: false }).then((win) => {\n      getR3F(win).pointerMiss();\n    });\n  });\n\n  Cypress.Commands.add('r3fSelect', (idOrUuid: string) => {\n    cy.window({ log: false }).then((win) => {\n      getR3F(win).select(idOrUuid);\n    });\n  });\n\n  Cypress.Commands.add('r3fClearSelection', () => {\n    cy.window({ log: false }).then((win) => {\n      getR3F(win).clearSelection();\n    });\n  });\n\n  Cypress.Commands.add('r3fGetObject', (idOrUuid: string) => {\n    return cy.window({ log: false }).then((win) => {\n      const api = getR3F(win);\n      return api.getByTestId(idOrUuid) ?? api.getByUuid(idOrUuid) ?? null;\n    });\n  });\n\n  Cypress.Commands.add('r3fInspect', (idOrUuid: string) => {\n    return cy.window({ log: false }).then((win) => {\n      return getR3F(win).inspect(idOrUuid);\n    });\n  });\n\n  Cypress.Commands.add('r3fSnapshot', () => {\n    return cy.window({ log: false }).then((win) => {\n      return getR3F(win).snapshot();\n    });\n  });\n\n  Cypress.Commands.add('r3fGetCount', () => {\n    return cy.window({ log: false }).then((win) => {\n      return getR3F(win).getCount();\n    });\n  });\n}\n","/// <reference types=\"cypress\" />\nimport type { R3FDOM, ObjectMetadata } from './types';\n\n// ---------------------------------------------------------------------------\n// Chai-based custom assertions for 3D scene testing\n// ---------------------------------------------------------------------------\n\nfunction getR3FFromWindow(): R3FDOM {\n  const win = (cy as unknown as { state: (key: string) => { document: Document } })\n    .state('window') as unknown as Window & { __R3F_DOM__?: R3FDOM };\n  const api = win?.__R3F_DOM__;\n  if (!api) {\n    throw new Error('react-three-dom bridge not found. Is <ThreeDom> mounted?');\n  }\n  return api;\n}\n\nfunction resolveObject(api: R3FDOM, idOrUuid: string): ObjectMetadata | null {\n  return api.getByTestId(idOrUuid) ?? api.getByUuid(idOrUuid) ?? null;\n}\n\nexport function registerAssertions(): void {\n  chai.use((_chai) => {\n    const { Assertion } = _chai;\n\n    // -------------------------------------------------------------------\n    // r3fExist — assert that a 3D object with the given id exists\n    // -------------------------------------------------------------------\n    Assertion.addMethod('r3fExist', function (this: Chai.AssertionStatic, idOrUuid: string) {\n      const api = getR3FFromWindow();\n      const meta = resolveObject(api, idOrUuid);\n\n      (this as unknown as Chai.Assertion).assert(\n        meta !== null,\n        `expected 3D object \"${idOrUuid}\" to exist in the scene`,\n        `expected 3D object \"${idOrUuid}\" to NOT exist in the scene`,\n        'exists',\n        meta === null ? 'not found' : 'found',\n      );\n    });\n\n    // -------------------------------------------------------------------\n    // r3fVisible — assert that a 3D object is visible\n    // -------------------------------------------------------------------\n    Assertion.addMethod('r3fVisible', function (this: Chai.AssertionStatic, idOrUuid: string) {\n      const api = getR3FFromWindow();\n      const meta = resolveObject(api, idOrUuid);\n\n      if (!meta) {\n        throw new Error(`3D object \"${idOrUuid}\" not found in the scene`);\n      }\n\n      (this as unknown as Chai.Assertion).assert(\n        meta.visible,\n        `expected 3D object \"${idOrUuid}\" to be visible`,\n        `expected 3D object \"${idOrUuid}\" to NOT be visible`,\n        true,\n        meta.visible,\n      );\n    });\n\n    // -------------------------------------------------------------------\n    // r3fInFrustum — assert that a 3D object is in the camera frustum\n    // -------------------------------------------------------------------\n    Assertion.addMethod('r3fInFrustum', function (this: Chai.AssertionStatic, idOrUuid: string) {\n      const api = getR3FFromWindow();\n      const inspection = api.inspect(idOrUuid);\n\n      if (!inspection) {\n        throw new Error(`3D object \"${idOrUuid}\" not found in the scene`);\n      }\n\n      const { bounds } = inspection;\n      const isFinite = (v: number[]) => v.every(Number.isFinite);\n      const inFrustum = isFinite(bounds.min) && isFinite(bounds.max);\n\n      (this as unknown as Chai.Assertion).assert(\n        inFrustum,\n        `expected 3D object \"${idOrUuid}\" to be in the camera frustum`,\n        `expected 3D object \"${idOrUuid}\" to NOT be in the camera frustum`,\n        'in frustum',\n        inFrustum ? 'in frustum' : 'out of frustum / invalid bounds',\n      );\n    });\n\n    // -------------------------------------------------------------------\n    // r3fPosition — assert object position within tolerance\n    // -------------------------------------------------------------------\n    Assertion.addMethod(\n      'r3fPosition',\n      function (\n        this: Chai.AssertionStatic,\n        idOrUuid: string,\n        expected: [number, number, number],\n        tolerance = 0.01,\n      ) {\n        const api = getR3FFromWindow();\n        const meta = resolveObject(api, idOrUuid);\n\n        if (!meta) {\n          throw new Error(`3D object \"${idOrUuid}\" not found in the scene`);\n        }\n\n        const [ex, ey, ez] = expected;\n        const [ax, ay, az] = meta.position;\n        const pass =\n          Math.abs(ax - ex) <= tolerance &&\n          Math.abs(ay - ey) <= tolerance &&\n          Math.abs(az - ez) <= tolerance;\n\n        (this as unknown as Chai.Assertion).assert(\n          pass,\n          `expected 3D object \"${idOrUuid}\" to be at [${expected}] (±${tolerance}), but was at [${meta.position}]`,\n          `expected 3D object \"${idOrUuid}\" to NOT be at [${expected}] (±${tolerance})`,\n          expected,\n          meta.position,\n        );\n      },\n    );\n\n    // -------------------------------------------------------------------\n    // r3fInstanceCount — assert InstancedMesh instance count\n    // -------------------------------------------------------------------\n    Assertion.addMethod(\n      'r3fInstanceCount',\n      function (this: Chai.AssertionStatic, idOrUuid: string, expectedCount: number) {\n        const api = getR3FFromWindow();\n        const meta = resolveObject(api, idOrUuid);\n\n        if (!meta) {\n          throw new Error(`3D object \"${idOrUuid}\" not found in the scene`);\n        }\n\n        const actual = meta.instanceCount ?? 0;\n\n        (this as unknown as Chai.Assertion).assert(\n          actual === expectedCount,\n          `expected 3D object \"${idOrUuid}\" to have instance count ${expectedCount}, but had ${actual}`,\n          `expected 3D object \"${idOrUuid}\" to NOT have instance count ${expectedCount}`,\n          expectedCount,\n          actual,\n        );\n      },\n    );\n\n    // -------------------------------------------------------------------\n    // r3fBounds — assert world-space bounding box within tolerance\n    // -------------------------------------------------------------------\n    Assertion.addMethod(\n      'r3fBounds',\n      function (\n        this: Chai.AssertionStatic,\n        idOrUuid: string,\n        expected: { min: [number, number, number]; max: [number, number, number] },\n        tolerance = 0.1,\n      ) {\n        const api = getR3FFromWindow();\n        const inspection = api.inspect(idOrUuid);\n\n        if (!inspection) {\n          throw new Error(`3D object \"${idOrUuid}\" not found in the scene`);\n        }\n\n        const { bounds } = inspection;\n        const withinTol = (a: number[], b: number[]) =>\n          a.every((v, i) => Math.abs(v - b[i]) <= tolerance);\n        const pass = withinTol(bounds.min, expected.min) && withinTol(bounds.max, expected.max);\n\n        (this as unknown as Chai.Assertion).assert(\n          pass,\n          `expected 3D object \"${idOrUuid}\" bounds to be min:${JSON.stringify(expected.min)} max:${JSON.stringify(expected.max)} (±${tolerance}), but got min:${JSON.stringify(bounds.min)} max:${JSON.stringify(bounds.max)}`,\n          `expected 3D object \"${idOrUuid}\" bounds to NOT match`,\n          expected,\n          bounds,\n        );\n      },\n    );\n  });\n}\n","/// <reference types=\"cypress\" />\nimport type { R3FDOM } from './types';\n\n// ---------------------------------------------------------------------------\n// r3fWaitForSceneReady — wait until the bridge is ready and object count\n// has stabilised across several consecutive polls.\n// ---------------------------------------------------------------------------\n\nexport interface WaitForSceneReadyOptions {\n  /** How many consecutive stable polls are required. Default: 3 */\n  stableChecks?: number;\n  /** Interval between polls in ms. Default: 100 */\n  pollIntervalMs?: number;\n  /** Overall timeout in ms. Default: 10_000 */\n  timeout?: number;\n}\n\nexport function registerWaiters(): void {\n  Cypress.Commands.add(\n    'r3fWaitForSceneReady',\n    (options: WaitForSceneReadyOptions = {}) => {\n      const {\n        stableChecks = 3,\n        pollIntervalMs = 100,\n        timeout = 10_000,\n      } = options;\n\n      const startTime = Date.now();\n      let lastCount = -1;\n      let stableRuns = 0;\n\n      function poll(): Cypress.Chainable<void> {\n        if (Date.now() - startTime > timeout) {\n          throw new Error(\n            `r3fWaitForSceneReady timed out after ${timeout}ms. Last count: ${lastCount}, stable runs: ${stableRuns}/${stableChecks}`,\n          );\n        }\n\n        return cy.window({ log: false }).then((win) => {\n          const api = (win as Window & { __R3F_DOM__?: R3FDOM }).__R3F_DOM__;\n          if (!api) {\n            // Bridge not yet available, keep polling\n            return cy.wait(pollIntervalMs, { log: false }).then(() => poll());\n          }\n\n          const count = api.getCount();\n\n          if (count === lastCount && count > 0) {\n            stableRuns++;\n            if (stableRuns >= stableChecks) {\n              return; // Done — scene is ready\n            }\n          } else {\n            stableRuns = 0;\n          }\n\n          lastCount = count;\n          return cy.wait(pollIntervalMs, { log: false }).then(() => poll());\n        });\n      }\n\n      return poll();\n    },\n  );\n\n  // -----------------------------------------------------------------------\n  // r3fWaitForIdle — wait until no property changes for N polls\n  // -----------------------------------------------------------------------\n\n  Cypress.Commands.add(\n    'r3fWaitForIdle',\n    (options: { idleChecks?: number; pollIntervalMs?: number; timeout?: number } = {}) => {\n      const {\n        idleChecks = 10,\n        pollIntervalMs = 50,\n        timeout = 10_000,\n      } = options;\n\n      const startTime = Date.now();\n      let lastJson = '';\n      let stableCount = 0;\n\n      function poll(): Cypress.Chainable<void> {\n        if (Date.now() - startTime > timeout) {\n          throw new Error(`r3fWaitForIdle timed out after ${timeout}ms`);\n        }\n\n        return cy.window({ log: false }).then((win) => {\n          const api = (win as Window & { __R3F_DOM__?: R3FDOM }).__R3F_DOM__;\n          if (!api) {\n            return cy.wait(pollIntervalMs, { log: false }).then(() => poll());\n          }\n\n          const snap = api.snapshot();\n          const json = JSON.stringify(snap.tree);\n\n          if (json === lastJson && json !== '') {\n            stableCount++;\n            if (stableCount >= idleChecks) {\n              return; // Done — scene is idle\n            }\n          } else {\n            stableCount = 0;\n          }\n\n          lastJson = json;\n          return cy.wait(pollIntervalMs, { log: false }).then(() => poll());\n        });\n      }\n\n      return poll();\n    },\n  );\n}\n","// @react-three-dom/cypress\n// Cypress E2E testing SDK for React Three Fiber apps\n//\n// Usage in cypress/support/e2e.ts:\n//   import '@react-three-dom/cypress';\n//\n// This auto-registers all custom commands and Chai assertions.\n\n/// <reference types=\"cypress\" />\n\nimport { registerCommands } from './commands';\nimport { registerAssertions } from './assertions';\nimport { registerWaiters } from './waiters';\n\n// Auto-register on import\nregisterCommands();\nregisterAssertions();\nregisterWaiters();\n\n// Re-export types for programmatic use\nexport type {\n  ObjectMetadata,\n  ObjectInspection,\n  SceneSnapshot,\n  SnapshotNode,\n  R3FDOM,\n} from './types';\n"]}

package/dist/index.d.cts

@@ -0,0 +1,151 @@
+interface ObjectMetadata {
+    uuid: string;
+    name: string;
+    type: string;
+    visible: boolean;
+    testId?: string;
+    geometryType?: string;
+    materialType?: string;
+    vertexCount?: number;
+    triangleCount?: number;
+    instanceCount?: number;
+    position: [number, number, number];
+    rotation: [number, number, number];
+    scale: [number, number, number];
+    parentUuid: string | null;
+    childrenUuids: string[];
+    boundsDirty: boolean;
+}
+interface ObjectInspection {
+    metadata: ObjectMetadata;
+    worldMatrix: number[];
+    bounds: {
+        min: [number, number, number];
+        max: [number, number, number];
+    };
+    geometry?: {
+        type: string;
+        attributes: Record<string, {
+            itemSize: number;
+            count: number;
+        }>;
+        index?: {
+            count: number;
+        };
+        boundingSphere?: {
+            center: [number, number, number];
+            radius: number;
+        };
+    };
+    material?: {
+        type: string;
+        color?: string;
+        map?: string;
+        uniforms?: Record<string, unknown>;
+        transparent?: boolean;
+        opacity?: number;
+        side?: number;
+    };
+    userData: Record<string, unknown>;
+}
+interface SnapshotNode {
+    uuid: string;
+    name: string;
+    type: string;
+    testId?: string;
+    visible: boolean;
+    position: [number, number, number];
+    rotation: [number, number, number];
+    scale: [number, number, number];
+    children: SnapshotNode[];
+}
+interface SceneSnapshot {
+    timestamp: number;
+    objectCount: number;
+    tree: SnapshotNode;
+}
+
+// ---------------------------------------------------------------------------
+// TypeScript declarations for @react-three-dom/cypress
+// Extends Cypress.Chainable and Cypress.Assertion for full type safety.
+//
+// Usage: add to your cypress/support/e2e.ts:
+//   import '@react-three-dom/cypress';
+// ---------------------------------------------------------------------------
+
+
+
+declare global {
+  namespace Cypress {
+    interface Chainable {
+      // ---- Interactions ----
+      /** Click a 3D object by testId or uuid. */
+      r3fClick(idOrUuid: string): Chainable<void>;
+      /** Double-click a 3D object by testId or uuid. */
+      r3fDoubleClick(idOrUuid: string): Chainable<void>;
+      /** Right-click / context-menu a 3D object by testId or uuid. */
+      r3fContextMenu(idOrUuid: string): Chainable<void>;
+      /** Hover over a 3D object by testId or uuid. */
+      r3fHover(idOrUuid: string): Chainable<void>;
+      /** Drag a 3D object with a world-space delta vector. */
+      r3fDrag(idOrUuid: string, delta: { x: number; y: number; z: number }): Chainable<void>;
+      /** Dispatch a wheel/scroll event on a 3D object. */
+      r3fWheel(idOrUuid: string, options?: { deltaY?: number; deltaX?: number }): Chainable<void>;
+      /** Click empty space to trigger onPointerMissed handlers. */
+      r3fPointerMiss(): Chainable<void>;
+
+      // ---- Selection ----
+      /** Select a 3D object (highlights in scene). */
+      r3fSelect(idOrUuid: string): Chainable<void>;
+      /** Clear the current selection. */
+      r3fClearSelection(): Chainable<void>;
+
+      // ---- Queries ----
+      /** Get object metadata by testId or uuid. */
+      r3fGetObject(idOrUuid: string): Chainable<ObjectMetadata | null>;
+      /** Get heavy inspection data (Tier 2) by testId or uuid. */
+      r3fInspect(idOrUuid: string): Chainable<ObjectInspection | null>;
+      /** Take a full scene snapshot. */
+      r3fSnapshot(): Chainable<SceneSnapshot>;
+      /** Get the total number of tracked objects. */
+      r3fGetCount(): Chainable<number>;
+
+      // ---- Waiters ----
+      /** Wait until the scene is ready (bridge available, object count stable). */
+      r3fWaitForSceneReady(options?: {
+        stableChecks?: number;
+        pollIntervalMs?: number;
+        timeout?: number;
+      }): Chainable<void>;
+      /** Wait until no property changes for N consecutive polls. */
+      r3fWaitForIdle(options?: {
+        idleChecks?: number;
+        pollIntervalMs?: number;
+        timeout?: number;
+      }): Chainable<void>;
+    }
+
+    interface Assertion {
+      /** Assert that a 3D object with the given testId/uuid exists. */
+      r3fExist(idOrUuid: string): Assertion;
+      /** Assert that a 3D object is visible. */
+      r3fVisible(idOrUuid: string): Assertion;
+      /** Assert that a 3D object is in the camera frustum. */
+      r3fInFrustum(idOrUuid: string): Assertion;
+      /** Assert object position within tolerance. */
+      r3fPosition(
+        idOrUuid: string,
+        expected: [number, number, number],
+        tolerance?: number,
+      ): Assertion;
+      /** Assert InstancedMesh instance count. */
+      r3fInstanceCount(idOrUuid: string, expectedCount: number): Assertion;
+      /** Assert world-space bounding box within tolerance. */
+      r3fBounds(
+        idOrUuid: string,
+        expected: { min: [number, number, number]; max: [number, number, number] },
+        tolerance?: number,
+      ): Assertion;
+    }
+  }
+}

package/dist/index.d.ts

@@ -0,0 +1,151 @@
+interface ObjectMetadata {
+    uuid: string;
+    name: string;
+    type: string;
+    visible: boolean;
+    testId?: string;
+    geometryType?: string;
+    materialType?: string;
+    vertexCount?: number;
+    triangleCount?: number;
+    instanceCount?: number;
+    position: [number, number, number];
+    rotation: [number, number, number];
+    scale: [number, number, number];
+    parentUuid: string | null;
+    childrenUuids: string[];
+    boundsDirty: boolean;
+}
+interface ObjectInspection {
+    metadata: ObjectMetadata;
+    worldMatrix: number[];
+    bounds: {
+        min: [number, number, number];
+        max: [number, number, number];
+    };
+    geometry?: {
+        type: string;
+        attributes: Record<string, {
+            itemSize: number;
+            count: number;
+        }>;
+        index?: {
+            count: number;
+        };
+        boundingSphere?: {
+            center: [number, number, number];
+            radius: number;
+        };
+    };
+    material?: {
+        type: string;
+        color?: string;
+        map?: string;
+        uniforms?: Record<string, unknown>;
+        transparent?: boolean;
+        opacity?: number;
+        side?: number;
+    };
+    userData: Record<string, unknown>;
+}
+interface SnapshotNode {
+    uuid: string;
+    name: string;
+    type: string;
+    testId?: string;
+    visible: boolean;
+    position: [number, number, number];
+    rotation: [number, number, number];
+    scale: [number, number, number];
+    children: SnapshotNode[];
+}
+interface SceneSnapshot {
+    timestamp: number;
+    objectCount: number;
+    tree: SnapshotNode;
+}
+
+// ---------------------------------------------------------------------------
+// TypeScript declarations for @react-three-dom/cypress
+// Extends Cypress.Chainable and Cypress.Assertion for full type safety.
+//
+// Usage: add to your cypress/support/e2e.ts:
+//   import '@react-three-dom/cypress';
+// ---------------------------------------------------------------------------
+
+
+
+declare global {
+  namespace Cypress {
+    interface Chainable {
+      // ---- Interactions ----
+      /** Click a 3D object by testId or uuid. */
+      r3fClick(idOrUuid: string): Chainable<void>;
+      /** Double-click a 3D object by testId or uuid. */
+      r3fDoubleClick(idOrUuid: string): Chainable<void>;
+      /** Right-click / context-menu a 3D object by testId or uuid. */
+      r3fContextMenu(idOrUuid: string): Chainable<void>;
+      /** Hover over a 3D object by testId or uuid. */
+      r3fHover(idOrUuid: string): Chainable<void>;
+      /** Drag a 3D object with a world-space delta vector. */
+      r3fDrag(idOrUuid: string, delta: { x: number; y: number; z: number }): Chainable<void>;
+      /** Dispatch a wheel/scroll event on a 3D object. */
+      r3fWheel(idOrUuid: string, options?: { deltaY?: number; deltaX?: number }): Chainable<void>;
+      /** Click empty space to trigger onPointerMissed handlers. */
+      r3fPointerMiss(): Chainable<void>;
+
+      // ---- Selection ----
+      /** Select a 3D object (highlights in scene). */
+      r3fSelect(idOrUuid: string): Chainable<void>;
+      /** Clear the current selection. */
+      r3fClearSelection(): Chainable<void>;
+
+      // ---- Queries ----
+      /** Get object metadata by testId or uuid. */
+      r3fGetObject(idOrUuid: string): Chainable<ObjectMetadata | null>;
+      /** Get heavy inspection data (Tier 2) by testId or uuid. */
+      r3fInspect(idOrUuid: string): Chainable<ObjectInspection | null>;
+      /** Take a full scene snapshot. */
+      r3fSnapshot(): Chainable<SceneSnapshot>;
+      /** Get the total number of tracked objects. */
+      r3fGetCount(): Chainable<number>;
+
+      // ---- Waiters ----
+      /** Wait until the scene is ready (bridge available, object count stable). */
+      r3fWaitForSceneReady(options?: {
+        stableChecks?: number;
+        pollIntervalMs?: number;
+        timeout?: number;
+      }): Chainable<void>;
+      /** Wait until no property changes for N consecutive polls. */
+      r3fWaitForIdle(options?: {
+        idleChecks?: number;
+        pollIntervalMs?: number;
+        timeout?: number;
+      }): Chainable<void>;
+    }
+
+    interface Assertion {
+      /** Assert that a 3D object with the given testId/uuid exists. */
+      r3fExist(idOrUuid: string): Assertion;
+      /** Assert that a 3D object is visible. */
+      r3fVisible(idOrUuid: string): Assertion;
+      /** Assert that a 3D object is in the camera frustum. */
+      r3fInFrustum(idOrUuid: string): Assertion;
+      /** Assert object position within tolerance. */
+      r3fPosition(
+        idOrUuid: string,
+        expected: [number, number, number],
+        tolerance?: number,
+      ): Assertion;
+      /** Assert InstancedMesh instance count. */
+      r3fInstanceCount(idOrUuid: string, expectedCount: number): Assertion;
+      /** Assert world-space bounding box within tolerance. */
+      r3fBounds(
+        idOrUuid: string,
+        expected: { min: [number, number, number]; max: [number, number, number] },
+        tolerance?: number,
+      ): Assertion;
+    }
+  }
+}

package/dist/index.js

@@ -0,0 +1,288 @@
+// src/commands.ts
+function getR3F(win) {
+  const api = win.__R3F_DOM__;
+  if (!api) {
+    throw new Error(
+      "react-three-dom bridge not found. Is <ThreeDom> mounted in your app?"
+    );
+  }
+  return api;
+}
+function registerCommands() {
+  Cypress.Commands.add("r3fClick", (idOrUuid) => {
+    cy.window({ log: false }).then((win) => {
+      getR3F(win).click(idOrUuid);
+    });
+  });
+  Cypress.Commands.add("r3fDoubleClick", (idOrUuid) => {
+    cy.window({ log: false }).then((win) => {
+      getR3F(win).doubleClick(idOrUuid);
+    });
+  });
+  Cypress.Commands.add("r3fContextMenu", (idOrUuid) => {
+    cy.window({ log: false }).then((win) => {
+      getR3F(win).contextMenu(idOrUuid);
+    });
+  });
+  Cypress.Commands.add("r3fHover", (idOrUuid) => {
+    cy.window({ log: false }).then((win) => {
+      getR3F(win).hover(idOrUuid);
+    });
+  });
+  Cypress.Commands.add(
+    "r3fDrag",
+    (idOrUuid, delta) => {
+      cy.window({ log: false }).then((win) => {
+        getR3F(win).drag(idOrUuid, delta);
+      });
+    }
+  );
+  Cypress.Commands.add(
+    "r3fWheel",
+    (idOrUuid, options) => {
+      cy.window({ log: false }).then((win) => {
+        getR3F(win).wheel(idOrUuid, options);
+      });
+    }
+  );
+  Cypress.Commands.add("r3fPointerMiss", () => {
+    cy.window({ log: false }).then((win) => {
+      getR3F(win).pointerMiss();
+    });
+  });
+  Cypress.Commands.add("r3fSelect", (idOrUuid) => {
+    cy.window({ log: false }).then((win) => {
+      getR3F(win).select(idOrUuid);
+    });
+  });
+  Cypress.Commands.add("r3fClearSelection", () => {
+    cy.window({ log: false }).then((win) => {
+      getR3F(win).clearSelection();
+    });
+  });
+  Cypress.Commands.add("r3fGetObject", (idOrUuid) => {
+    return cy.window({ log: false }).then((win) => {
+      const api = getR3F(win);
+      return api.getByTestId(idOrUuid) ?? api.getByUuid(idOrUuid) ?? null;
+    });
+  });
+  Cypress.Commands.add("r3fInspect", (idOrUuid) => {
+    return cy.window({ log: false }).then((win) => {
+      return getR3F(win).inspect(idOrUuid);
+    });
+  });
+  Cypress.Commands.add("r3fSnapshot", () => {
+    return cy.window({ log: false }).then((win) => {
+      return getR3F(win).snapshot();
+    });
+  });
+  Cypress.Commands.add("r3fGetCount", () => {
+    return cy.window({ log: false }).then((win) => {
+      return getR3F(win).getCount();
+    });
+  });
+}
+
+// src/assertions.ts
+function getR3FFromWindow() {
+  const win = cy.state("window");
+  const api = win?.__R3F_DOM__;
+  if (!api) {
+    throw new Error("react-three-dom bridge not found. Is <ThreeDom> mounted?");
+  }
+  return api;
+}
+function resolveObject(api, idOrUuid) {
+  return api.getByTestId(idOrUuid) ?? api.getByUuid(idOrUuid) ?? null;
+}
+function registerAssertions() {
+  chai.use((_chai) => {
+    const { Assertion } = _chai;
+    Assertion.addMethod("r3fExist", function(idOrUuid) {
+      const api = getR3FFromWindow();
+      const meta = resolveObject(api, idOrUuid);
+      this.assert(
+        meta !== null,
+        `expected 3D object "${idOrUuid}" to exist in the scene`,
+        `expected 3D object "${idOrUuid}" to NOT exist in the scene`,
+        "exists",
+        meta === null ? "not found" : "found"
+      );
+    });
+    Assertion.addMethod("r3fVisible", function(idOrUuid) {
+      const api = getR3FFromWindow();
+      const meta = resolveObject(api, idOrUuid);
+      if (!meta) {
+        throw new Error(`3D object "${idOrUuid}" not found in the scene`);
+      }
+      this.assert(
+        meta.visible,
+        `expected 3D object "${idOrUuid}" to be visible`,
+        `expected 3D object "${idOrUuid}" to NOT be visible`,
+        true,
+        meta.visible
+      );
+    });
+    Assertion.addMethod("r3fInFrustum", function(idOrUuid) {
+      const api = getR3FFromWindow();
+      const inspection = api.inspect(idOrUuid);
+      if (!inspection) {
+        throw new Error(`3D object "${idOrUuid}" not found in the scene`);
+      }
+      const { bounds } = inspection;
+      const isFinite = (v) => v.every(Number.isFinite);
+      const inFrustum = isFinite(bounds.min) && isFinite(bounds.max);
+      this.assert(
+        inFrustum,
+        `expected 3D object "${idOrUuid}" to be in the camera frustum`,
+        `expected 3D object "${idOrUuid}" to NOT be in the camera frustum`,
+        "in frustum",
+        inFrustum ? "in frustum" : "out of frustum / invalid bounds"
+      );
+    });
+    Assertion.addMethod(
+      "r3fPosition",
+      function(idOrUuid, expected, tolerance = 0.01) {
+        const api = getR3FFromWindow();
+        const meta = resolveObject(api, idOrUuid);
+        if (!meta) {
+          throw new Error(`3D object "${idOrUuid}" not found in the scene`);
+        }
+        const [ex, ey, ez] = expected;
+        const [ax, ay, az] = meta.position;
+        const pass = Math.abs(ax - ex) <= tolerance && Math.abs(ay - ey) <= tolerance && Math.abs(az - ez) <= tolerance;
+        this.assert(
+          pass,
+          `expected 3D object "${idOrUuid}" to be at [${expected}] (\xB1${tolerance}), but was at [${meta.position}]`,
+          `expected 3D object "${idOrUuid}" to NOT be at [${expected}] (\xB1${tolerance})`,
+          expected,
+          meta.position
+        );
+      }
+    );
+    Assertion.addMethod(
+      "r3fInstanceCount",
+      function(idOrUuid, expectedCount) {
+        const api = getR3FFromWindow();
+        const meta = resolveObject(api, idOrUuid);
+        if (!meta) {
+          throw new Error(`3D object "${idOrUuid}" not found in the scene`);
+        }
+        const actual = meta.instanceCount ?? 0;
+        this.assert(
+          actual === expectedCount,
+          `expected 3D object "${idOrUuid}" to have instance count ${expectedCount}, but had ${actual}`,
+          `expected 3D object "${idOrUuid}" to NOT have instance count ${expectedCount}`,
+          expectedCount,
+          actual
+        );
+      }
+    );
+    Assertion.addMethod(
+      "r3fBounds",
+      function(idOrUuid, expected, tolerance = 0.1) {
+        const api = getR3FFromWindow();
+        const inspection = api.inspect(idOrUuid);
+        if (!inspection) {
+          throw new Error(`3D object "${idOrUuid}" not found in the scene`);
+        }
+        const { bounds } = inspection;
+        const withinTol = (a, b) => a.every((v, i) => Math.abs(v - b[i]) <= tolerance);
+        const pass = withinTol(bounds.min, expected.min) && withinTol(bounds.max, expected.max);
+        this.assert(
+          pass,
+          `expected 3D object "${idOrUuid}" bounds to be min:${JSON.stringify(expected.min)} max:${JSON.stringify(expected.max)} (\xB1${tolerance}), but got min:${JSON.stringify(bounds.min)} max:${JSON.stringify(bounds.max)}`,
+          `expected 3D object "${idOrUuid}" bounds to NOT match`,
+          expected,
+          bounds
+        );
+      }
+    );
+  });
+}
+
+// src/waiters.ts
+function registerWaiters() {
+  Cypress.Commands.add(
+    "r3fWaitForSceneReady",
+    (options = {}) => {
+      const {
+        stableChecks = 3,
+        pollIntervalMs = 100,
+        timeout = 1e4
+      } = options;
+      const startTime = Date.now();
+      let lastCount = -1;
+      let stableRuns = 0;
+      function poll() {
+        if (Date.now() - startTime > timeout) {
+          throw new Error(
+            `r3fWaitForSceneReady timed out after ${timeout}ms. Last count: ${lastCount}, stable runs: ${stableRuns}/${stableChecks}`
+          );
+        }
+        return cy.window({ log: false }).then((win) => {
+          const api = win.__R3F_DOM__;
+          if (!api) {
+            return cy.wait(pollIntervalMs, { log: false }).then(() => poll());
+          }
+          const count = api.getCount();
+          if (count === lastCount && count > 0) {
+            stableRuns++;
+            if (stableRuns >= stableChecks) {
+              return;
+            }
+          } else {
+            stableRuns = 0;
+          }
+          lastCount = count;
+          return cy.wait(pollIntervalMs, { log: false }).then(() => poll());
+        });
+      }
+      return poll();
+    }
+  );
+  Cypress.Commands.add(
+    "r3fWaitForIdle",
+    (options = {}) => {
+      const {
+        idleChecks = 10,
+        pollIntervalMs = 50,
+        timeout = 1e4
+      } = options;
+      const startTime = Date.now();
+      let lastJson = "";
+      let stableCount = 0;
+      function poll() {
+        if (Date.now() - startTime > timeout) {
+          throw new Error(`r3fWaitForIdle timed out after ${timeout}ms`);
+        }
+        return cy.window({ log: false }).then((win) => {
+          const api = win.__R3F_DOM__;
+          if (!api) {
+            return cy.wait(pollIntervalMs, { log: false }).then(() => poll());
+          }
+          const snap = api.snapshot();
+          const json = JSON.stringify(snap.tree);
+          if (json === lastJson && json !== "") {
+            stableCount++;
+            if (stableCount >= idleChecks) {
+              return;
+            }
+          } else {
+            stableCount = 0;
+          }
+          lastJson = json;
+          return cy.wait(pollIntervalMs, { log: false }).then(() => poll());
+        });
+      }
+      return poll();
+    }
+  );
+}
+
+// src/index.ts
+registerCommands();
+registerAssertions();
+registerWaiters();
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands.ts","../src/assertions.ts","../src/waiters.ts","../src/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/// <reference types=\"cypress\" />\nimport type { R3FDOM } from './types';\n\n// ---------------------------------------------------------------------------\n// Helper to get the R3F DOM bridge from the current window\n// ---------------------------------------------------------------------------\n\nfunction getR3F(win: Cypress.AUTWindow): R3FDOM {\n  const api = (win as Window & { __R3F_DOM__?: R3FDOM }).__R3F_DOM__;\n  if (!api) {\n    throw new Error(\n      'react-three-dom bridge not found. Is <ThreeDom> mounted in your app?',\n    );\n  }\n  return api;\n}\n\n// ---------------------------------------------------------------------------\n// Custom commands — all prefixed with `r3f` for clarity\n// ---------------------------------------------------------------------------\n\nexport function registerCommands(): void {\n  Cypress.Commands.add('r3fClick', (idOrUuid: string) => {\n    cy.window({ log: false }).then((win) => {\n      getR3F(win).click(idOrUuid);\n    });\n  });\n\n  Cypress.Commands.add('r3fDoubleClick', (idOrUuid: string) => {\n    cy.window({ log: false }).then((win) => {\n      getR3F(win).doubleClick(idOrUuid);\n    });\n  });\n\n  Cypress.Commands.add('r3fContextMenu', (idOrUuid: string) => {\n    cy.window({ log: false }).then((win) => {\n      getR3F(win).contextMenu(idOrUuid);\n    });\n  });\n\n  Cypress.Commands.add('r3fHover', (idOrUuid: string) => {\n    cy.window({ log: false }).then((win) => {\n      getR3F(win).hover(idOrUuid);\n    });\n  });\n\n  Cypress.Commands.add(\n    'r3fDrag',\n    (idOrUuid: string, delta: { x: number; y: number; z: number }) => {\n      cy.window({ log: false }).then((win) => {\n        getR3F(win).drag(idOrUuid, delta);\n      });\n    },\n  );\n\n  Cypress.Commands.add(\n    'r3fWheel',\n    (idOrUuid: string, options?: { deltaY?: number; deltaX?: number }) => {\n      cy.window({ log: false }).then((win) => {\n        getR3F(win).wheel(idOrUuid, options);\n      });\n    },\n  );\n\n  Cypress.Commands.add('r3fPointerMiss', () => {\n    cy.window({ log: false }).then((win) => {\n      getR3F(win).pointerMiss();\n    });\n  });\n\n  Cypress.Commands.add('r3fSelect', (idOrUuid: string) => {\n    cy.window({ log: false }).then((win) => {\n      getR3F(win).select(idOrUuid);\n    });\n  });\n\n  Cypress.Commands.add('r3fClearSelection', () => {\n    cy.window({ log: false }).then((win) => {\n      getR3F(win).clearSelection();\n    });\n  });\n\n  Cypress.Commands.add('r3fGetObject', (idOrUuid: string) => {\n    return cy.window({ log: false }).then((win) => {\n      const api = getR3F(win);\n      return api.getByTestId(idOrUuid) ?? api.getByUuid(idOrUuid) ?? null;\n    });\n  });\n\n  Cypress.Commands.add('r3fInspect', (idOrUuid: string) => {\n    return cy.window({ log: false }).then((win) => {\n      return getR3F(win).inspect(idOrUuid);\n    });\n  });\n\n  Cypress.Commands.add('r3fSnapshot', () => {\n    return cy.window({ log: false }).then((win) => {\n      return getR3F(win).snapshot();\n    });\n  });\n\n  Cypress.Commands.add('r3fGetCount', () => {\n    return cy.window({ log: false }).then((win) => {\n      return getR3F(win).getCount();\n    });\n  });\n}\n","/// <reference types=\"cypress\" />\nimport type { R3FDOM, ObjectMetadata } from './types';\n\n// ---------------------------------------------------------------------------\n// Chai-based custom assertions for 3D scene testing\n// ---------------------------------------------------------------------------\n\nfunction getR3FFromWindow(): R3FDOM {\n  const win = (cy as unknown as { state: (key: string) => { document: Document } })\n    .state('window') as unknown as Window & { __R3F_DOM__?: R3FDOM };\n  const api = win?.__R3F_DOM__;\n  if (!api) {\n    throw new Error('react-three-dom bridge not found. Is <ThreeDom> mounted?');\n  }\n  return api;\n}\n\nfunction resolveObject(api: R3FDOM, idOrUuid: string): ObjectMetadata | null {\n  return api.getByTestId(idOrUuid) ?? api.getByUuid(idOrUuid) ?? null;\n}\n\nexport function registerAssertions(): void {\n  chai.use((_chai) => {\n    const { Assertion } = _chai;\n\n    // -------------------------------------------------------------------\n    // r3fExist — assert that a 3D object with the given id exists\n    // -------------------------------------------------------------------\n    Assertion.addMethod('r3fExist', function (this: Chai.AssertionStatic, idOrUuid: string) {\n      const api = getR3FFromWindow();\n      const meta = resolveObject(api, idOrUuid);\n\n      (this as unknown as Chai.Assertion).assert(\n        meta !== null,\n        `expected 3D object \"${idOrUuid}\" to exist in the scene`,\n        `expected 3D object \"${idOrUuid}\" to NOT exist in the scene`,\n        'exists',\n        meta === null ? 'not found' : 'found',\n      );\n    });\n\n    // -------------------------------------------------------------------\n    // r3fVisible — assert that a 3D object is visible\n    // -------------------------------------------------------------------\n    Assertion.addMethod('r3fVisible', function (this: Chai.AssertionStatic, idOrUuid: string) {\n      const api = getR3FFromWindow();\n      const meta = resolveObject(api, idOrUuid);\n\n      if (!meta) {\n        throw new Error(`3D object \"${idOrUuid}\" not found in the scene`);\n      }\n\n      (this as unknown as Chai.Assertion).assert(\n        meta.visible,\n        `expected 3D object \"${idOrUuid}\" to be visible`,\n        `expected 3D object \"${idOrUuid}\" to NOT be visible`,\n        true,\n        meta.visible,\n      );\n    });\n\n    // -------------------------------------------------------------------\n    // r3fInFrustum — assert that a 3D object is in the camera frustum\n    // -------------------------------------------------------------------\n    Assertion.addMethod('r3fInFrustum', function (this: Chai.AssertionStatic, idOrUuid: string) {\n      const api = getR3FFromWindow();\n      const inspection = api.inspect(idOrUuid);\n\n      if (!inspection) {\n        throw new Error(`3D object \"${idOrUuid}\" not found in the scene`);\n      }\n\n      const { bounds } = inspection;\n      const isFinite = (v: number[]) => v.every(Number.isFinite);\n      const inFrustum = isFinite(bounds.min) && isFinite(bounds.max);\n\n      (this as unknown as Chai.Assertion).assert(\n        inFrustum,\n        `expected 3D object \"${idOrUuid}\" to be in the camera frustum`,\n        `expected 3D object \"${idOrUuid}\" to NOT be in the camera frustum`,\n        'in frustum',\n        inFrustum ? 'in frustum' : 'out of frustum / invalid bounds',\n      );\n    });\n\n    // -------------------------------------------------------------------\n    // r3fPosition — assert object position within tolerance\n    // -------------------------------------------------------------------\n    Assertion.addMethod(\n      'r3fPosition',\n      function (\n        this: Chai.AssertionStatic,\n        idOrUuid: string,\n        expected: [number, number, number],\n        tolerance = 0.01,\n      ) {\n        const api = getR3FFromWindow();\n        const meta = resolveObject(api, idOrUuid);\n\n        if (!meta) {\n          throw new Error(`3D object \"${idOrUuid}\" not found in the scene`);\n        }\n\n        const [ex, ey, ez] = expected;\n        const [ax, ay, az] = meta.position;\n        const pass =\n          Math.abs(ax - ex) <= tolerance &&\n          Math.abs(ay - ey) <= tolerance &&\n          Math.abs(az - ez) <= tolerance;\n\n        (this as unknown as Chai.Assertion).assert(\n          pass,\n          `expected 3D object \"${idOrUuid}\" to be at [${expected}] (±${tolerance}), but was at [${meta.position}]`,\n          `expected 3D object \"${idOrUuid}\" to NOT be at [${expected}] (±${tolerance})`,\n          expected,\n          meta.position,\n        );\n      },\n    );\n\n    // -------------------------------------------------------------------\n    // r3fInstanceCount — assert InstancedMesh instance count\n    // -------------------------------------------------------------------\n    Assertion.addMethod(\n      'r3fInstanceCount',\n      function (this: Chai.AssertionStatic, idOrUuid: string, expectedCount: number) {\n        const api = getR3FFromWindow();\n        const meta = resolveObject(api, idOrUuid);\n\n        if (!meta) {\n          throw new Error(`3D object \"${idOrUuid}\" not found in the scene`);\n        }\n\n        const actual = meta.instanceCount ?? 0;\n\n        (this as unknown as Chai.Assertion).assert(\n          actual === expectedCount,\n          `expected 3D object \"${idOrUuid}\" to have instance count ${expectedCount}, but had ${actual}`,\n          `expected 3D object \"${idOrUuid}\" to NOT have instance count ${expectedCount}`,\n          expectedCount,\n          actual,\n        );\n      },\n    );\n\n    // -------------------------------------------------------------------\n    // r3fBounds — assert world-space bounding box within tolerance\n    // -------------------------------------------------------------------\n    Assertion.addMethod(\n      'r3fBounds',\n      function (\n        this: Chai.AssertionStatic,\n        idOrUuid: string,\n        expected: { min: [number, number, number]; max: [number, number, number] },\n        tolerance = 0.1,\n      ) {\n        const api = getR3FFromWindow();\n        const inspection = api.inspect(idOrUuid);\n\n        if (!inspection) {\n          throw new Error(`3D object \"${idOrUuid}\" not found in the scene`);\n        }\n\n        const { bounds } = inspection;\n        const withinTol = (a: number[], b: number[]) =>\n          a.every((v, i) => Math.abs(v - b[i]) <= tolerance);\n        const pass = withinTol(bounds.min, expected.min) && withinTol(bounds.max, expected.max);\n\n        (this as unknown as Chai.Assertion).assert(\n          pass,\n          `expected 3D object \"${idOrUuid}\" bounds to be min:${JSON.stringify(expected.min)} max:${JSON.stringify(expected.max)} (±${tolerance}), but got min:${JSON.stringify(bounds.min)} max:${JSON.stringify(bounds.max)}`,\n          `expected 3D object \"${idOrUuid}\" bounds to NOT match`,\n          expected,\n          bounds,\n        );\n      },\n    );\n  });\n}\n","/// <reference types=\"cypress\" />\nimport type { R3FDOM } from './types';\n\n// ---------------------------------------------------------------------------\n// r3fWaitForSceneReady — wait until the bridge is ready and object count\n// has stabilised across several consecutive polls.\n// ---------------------------------------------------------------------------\n\nexport interface WaitForSceneReadyOptions {\n  /** How many consecutive stable polls are required. Default: 3 */\n  stableChecks?: number;\n  /** Interval between polls in ms. Default: 100 */\n  pollIntervalMs?: number;\n  /** Overall timeout in ms. Default: 10_000 */\n  timeout?: number;\n}\n\nexport function registerWaiters(): void {\n  Cypress.Commands.add(\n    'r3fWaitForSceneReady',\n    (options: WaitForSceneReadyOptions = {}) => {\n      const {\n        stableChecks = 3,\n        pollIntervalMs = 100,\n        timeout = 10_000,\n      } = options;\n\n      const startTime = Date.now();\n      let lastCount = -1;\n      let stableRuns = 0;\n\n      function poll(): Cypress.Chainable<void> {\n        if (Date.now() - startTime > timeout) {\n          throw new Error(\n            `r3fWaitForSceneReady timed out after ${timeout}ms. Last count: ${lastCount}, stable runs: ${stableRuns}/${stableChecks}`,\n          );\n        }\n\n        return cy.window({ log: false }).then((win) => {\n          const api = (win as Window & { __R3F_DOM__?: R3FDOM }).__R3F_DOM__;\n          if (!api) {\n            // Bridge not yet available, keep polling\n            return cy.wait(pollIntervalMs, { log: false }).then(() => poll());\n          }\n\n          const count = api.getCount();\n\n          if (count === lastCount && count > 0) {\n            stableRuns++;\n            if (stableRuns >= stableChecks) {\n              return; // Done — scene is ready\n            }\n          } else {\n            stableRuns = 0;\n          }\n\n          lastCount = count;\n          return cy.wait(pollIntervalMs, { log: false }).then(() => poll());\n        });\n      }\n\n      return poll();\n    },\n  );\n\n  // -----------------------------------------------------------------------\n  // r3fWaitForIdle — wait until no property changes for N polls\n  // -----------------------------------------------------------------------\n\n  Cypress.Commands.add(\n    'r3fWaitForIdle',\n    (options: { idleChecks?: number; pollIntervalMs?: number; timeout?: number } = {}) => {\n      const {\n        idleChecks = 10,\n        pollIntervalMs = 50,\n        timeout = 10_000,\n      } = options;\n\n      const startTime = Date.now();\n      let lastJson = '';\n      let stableCount = 0;\n\n      function poll(): Cypress.Chainable<void> {\n        if (Date.now() - startTime > timeout) {\n          throw new Error(`r3fWaitForIdle timed out after ${timeout}ms`);\n        }\n\n        return cy.window({ log: false }).then((win) => {\n          const api = (win as Window & { __R3F_DOM__?: R3FDOM }).__R3F_DOM__;\n          if (!api) {\n            return cy.wait(pollIntervalMs, { log: false }).then(() => poll());\n          }\n\n          const snap = api.snapshot();\n          const json = JSON.stringify(snap.tree);\n\n          if (json === lastJson && json !== '') {\n            stableCount++;\n            if (stableCount >= idleChecks) {\n              return; // Done — scene is idle\n            }\n          } else {\n            stableCount = 0;\n          }\n\n          lastJson = json;\n          return cy.wait(pollIntervalMs, { log: false }).then(() => poll());\n        });\n      }\n\n      return poll();\n    },\n  );\n}\n","// @react-three-dom/cypress\n// Cypress E2E testing SDK for React Three Fiber apps\n//\n// Usage in cypress/support/e2e.ts:\n//   import '@react-three-dom/cypress';\n//\n// This auto-registers all custom commands and Chai assertions.\n\n/// <reference types=\"cypress\" />\n\nimport { registerCommands } from './commands';\nimport { registerAssertions } from './assertions';\nimport { registerWaiters } from './waiters';\n\n// Auto-register on import\nregisterCommands();\nregisterAssertions();\nregisterWaiters();\n\n// Re-export types for programmatic use\nexport type {\n  ObjectMetadata,\n  ObjectInspection,\n  SceneSnapshot,\n  SnapshotNode,\n  R3FDOM,\n} from './types';\n"]}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@react-three-dom/cypress",
+  "version": "0.1.0",
+  "description": "Cypress E2E testing SDK for React Three Fiber apps",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": ["dist", "src/index.d.ts"],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "clean": "rm -rf dist"
+  },
+  "peerDependencies": {
+    "cypress": ">=12.0.0"
+  },
+  "devDependencies": {
+    "cypress": "^13",
+    "typescript": "^5.7",
+    "tsup": "^8",
+    "vitest": "^3"
+  }
+}

package/src/index.d.ts

@@ -0,0 +1,84 @@
+// ---------------------------------------------------------------------------
+// TypeScript declarations for @react-three-dom/cypress
+// Extends Cypress.Chainable and Cypress.Assertion for full type safety.
+//
+// Usage: add to your cypress/support/e2e.ts:
+//   import '@react-three-dom/cypress';
+// ---------------------------------------------------------------------------
+
+import type { ObjectMetadata, ObjectInspection, SceneSnapshot } from './types';
+
+declare global {
+  namespace Cypress {
+    interface Chainable {
+      // ---- Interactions ----
+      /** Click a 3D object by testId or uuid. */
+      r3fClick(idOrUuid: string): Chainable<void>;
+      /** Double-click a 3D object by testId or uuid. */
+      r3fDoubleClick(idOrUuid: string): Chainable<void>;
+      /** Right-click / context-menu a 3D object by testId or uuid. */
+      r3fContextMenu(idOrUuid: string): Chainable<void>;
+      /** Hover over a 3D object by testId or uuid. */
+      r3fHover(idOrUuid: string): Chainable<void>;
+      /** Drag a 3D object with a world-space delta vector. */
+      r3fDrag(idOrUuid: string, delta: { x: number; y: number; z: number }): Chainable<void>;
+      /** Dispatch a wheel/scroll event on a 3D object. */
+      r3fWheel(idOrUuid: string, options?: { deltaY?: number; deltaX?: number }): Chainable<void>;
+      /** Click empty space to trigger onPointerMissed handlers. */
+      r3fPointerMiss(): Chainable<void>;
+
+      // ---- Selection ----
+      /** Select a 3D object (highlights in scene). */
+      r3fSelect(idOrUuid: string): Chainable<void>;
+      /** Clear the current selection. */
+      r3fClearSelection(): Chainable<void>;
+
+      // ---- Queries ----
+      /** Get object metadata by testId or uuid. */
+      r3fGetObject(idOrUuid: string): Chainable<ObjectMetadata | null>;
+      /** Get heavy inspection data (Tier 2) by testId or uuid. */
+      r3fInspect(idOrUuid: string): Chainable<ObjectInspection | null>;
+      /** Take a full scene snapshot. */
+      r3fSnapshot(): Chainable<SceneSnapshot>;
+      /** Get the total number of tracked objects. */
+      r3fGetCount(): Chainable<number>;
+
+      // ---- Waiters ----
+      /** Wait until the scene is ready (bridge available, object count stable). */
+      r3fWaitForSceneReady(options?: {
+        stableChecks?: number;
+        pollIntervalMs?: number;
+        timeout?: number;
+      }): Chainable<void>;
+      /** Wait until no property changes for N consecutive polls. */
+      r3fWaitForIdle(options?: {
+        idleChecks?: number;
+        pollIntervalMs?: number;
+        timeout?: number;
+      }): Chainable<void>;
+    }
+
+    interface Assertion {
+      /** Assert that a 3D object with the given testId/uuid exists. */
+      r3fExist(idOrUuid: string): Assertion;
+      /** Assert that a 3D object is visible. */
+      r3fVisible(idOrUuid: string): Assertion;
+      /** Assert that a 3D object is in the camera frustum. */
+      r3fInFrustum(idOrUuid: string): Assertion;
+      /** Assert object position within tolerance. */
+      r3fPosition(
+        idOrUuid: string,
+        expected: [number, number, number],
+        tolerance?: number,
+      ): Assertion;
+      /** Assert InstancedMesh instance count. */
+      r3fInstanceCount(idOrUuid: string, expectedCount: number): Assertion;
+      /** Assert world-space bounding box within tolerance. */
+      r3fBounds(
+        idOrUuid: string,
+        expected: { min: [number, number, number]; max: [number, number, number] },
+        tolerance?: number,
+      ): Assertion;
+    }
+  }
+}