test(regressions): add regression test suite for 46 reported bugs

Deterministic test harness with uniform interpolation for velocity,
9 regression spec files covering all testable open bugs.

Results: 21 FAILING (active bugs), 25 PASSING (fixed in v4).
11 bugs remain N/A (not testable in jsdom).

Closes #168
Closes #241
Closes #250
Closes #286
Closes #323
Closes #364
Closes #392
Closes #404
Closes #406
Closes #408
Closes #423
Closes #427
Closes #431
Closes #432
Closes #463
Closes #479
Closes #483
Closes #487
Closes #495
Closes #498
Closes #524
Closes #547
Ref #112
Ref #283
Ref #316
Ref #363
Ref #396
Ref #418
Ref #434
Ref #437
Ref #438
Ref #439
Ref #443
Ref #460
Ref #462
Ref #467
Ref #506
Ref #508
Ref #516
Ref #529
Ref #538
Ref #545
Ref #553

Made-with: Cursor

Author: prc5

.cursor/rules/testing-regressions.mdc

@@ -30,6 +30,18 @@ alwaysApply: false
 - Prefer **moveEventCount** (or the project-standard name) over vague steps in
   public test helper types.
 
+## Running tests
+
+The project uses **jest-watch-typeahead** (`jest.config.ts` → `watchPlugins`).
+In watch mode (`yarn test --watch`) press:
+
+- **`p`** — filter by **filename** (e.g. type `pan.velocity` to run only that spec)
+- **`t`** — filter by **test name** (e.g. type `should trigger velocity`)
+
+Use these to quickly iterate on a single spec without running the full suite.
+
+To run a single file directly: `yarn test __tests__/features/pan/pan.velocity.spec.tsx`
+
 ## General
 
 - Match existing test layout under **tests**/features/ for broad coverage; use

.gitignore

@@ -48,4 +48,5 @@ yarn-error.log*
 Thumbs.db
 
 # testing
-coverage
+coverage
+jest-reg.txtjest-reg.txt

__tests__/regressions/bounds-centering.spec.tsx

@@ -0,0 +1,126 @@
+import { waitFor, fireEvent } from "@testing-library/react";
+
+import { renderApp } from "../utils";
+
+const NativeResizeObserver = global.ResizeObserver;
+
+beforeAll(() => {
+  global.ResizeObserver = class {
+    observe() {}
+    disconnect() {}
+    unobserve() {}
+  } as unknown as typeof ResizeObserver;
+});
+
+afterAll(() => {
+  global.ResizeObserver = NativeResizeObserver;
+});
+
+describe("bounds and centering regressions", () => {
+  it("maxPositionX clamps horizontal pan when set (Ref #250)", () => {
+    const { pan, ref } = renderApp({
+      maxPositionX: 50,
+      limitToBounds: true,
+      disablePadding: true,
+    });
+    ref.current!.setTransform(0, 0, 2);
+    pan({ x: 200, y: 0 });
+    expect(ref.current!.instance.state.positionX).toBeLessThanOrEqual(50);
+  });
+
+  it("touchpad zoom-out respects minScale / limitToBounds (Ref #396)", () => {
+    const { content, ref } = renderApp({
+      minScale: 0.5,
+      limitToBounds: true,
+      smooth: false,
+    });
+
+    for (let i = 0; i < 50; i++) {
+      fireEvent(
+        content,
+        new WheelEvent("wheel", {
+          bubbles: true,
+          deltaY: 30,
+          ctrlKey: true,
+          deltaMode: 0,
+        }),
+      );
+    }
+
+    expect(ref.current!.instance.state.scale).toBeGreaterThanOrEqual(0.5);
+  });
+
+  it("tall zoomed content can pan far enough upward (negative positionY) (Ref #524)", () => {
+    const { pan, ref } = renderApp({
+      contentHeight: "2000px",
+      wrapperHeight: "500px",
+      limitToBounds: true,
+      disablePadding: true,
+    });
+    ref.current!.setTransform(0, 0, 2);
+    pan({ x: 0, y: -600 });
+    expect(ref.current!.instance.state.positionY).toBeLessThan(-1);
+  });
+
+  it("centerOnInit yields centered translation after mount (Ref #392)", async () => {
+    const { ref } = renderApp({
+      centerOnInit: true,
+      contentHeight: "2000px",
+      wrapperHeight: "500px",
+      limitToBounds: false,
+    });
+    await waitFor(() => {
+      const { positionX, positionY } = ref.current!.instance.state;
+      expect(positionX !== 0 || positionY !== 0).toBe(true);
+    });
+  });
+
+  it("centering accounts for wrapper offset from viewport (Ref #462)", () => {
+    const { ref, wrapper } = renderApp({
+      centerOnInit: true,
+      limitToBounds: false,
+    });
+
+    jest.spyOn(wrapper, "getBoundingClientRect").mockReturnValue({
+      width: 500,
+      height: 500,
+      top: 200,
+      left: 150,
+      bottom: 700,
+      right: 650,
+      x: 150,
+      y: 200,
+      toJSON: () => ({}),
+    } as DOMRect);
+
+    ref.current!.centerView(1, 0);
+
+    const { positionX, positionY } = ref.current!.instance.state;
+    expect(positionX !== 0 || positionY !== 0).toBe(true);
+  });
+
+  it("panning resumes after hitting bounds and reversing direction (Ref #316)", () => {
+    const { pan, ref } = renderApp({
+      limitToBounds: true,
+      disablePadding: true,
+    });
+    ref.current!.setTransform(0, 0, 2);
+    pan({ x: 1000, y: 0 });
+    const posAfterRight = ref.current!.instance.state.positionX;
+
+    pan({ x: -500, y: 0, from: { clientX: 250, clientY: 250 } });
+    const posAfterLeft = ref.current!.instance.state.positionX;
+
+    expect(posAfterLeft).toBeLessThan(posAfterRight);
+  });
+
+  it("initialPositionX is applied on first paint (Ref #483)", async () => {
+    const { ref } = renderApp({
+      initialPositionX: 100,
+      limitToBounds: false,
+    });
+    await waitFor(() => {
+      expect(ref.current!.instance.state.positionX).toBe(100);
+    });
+  });
+});

__tests__/regressions/build-packaging.spec.ts

@@ -0,0 +1,14 @@
+import * as fs from "fs";
+import * as path from "path";
+
+describe("build and packaging regressions", () => {
+  it("package.json files field includes src/ for source map resolution (Ref #529)", () => {
+    const pkgPath = path.resolve(__dirname, "../../package.json");
+    const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
+    const files: string[] = pkg.files || [];
+    const includesSrc = files.some(
+      (f: string) => f === "src" || f.startsWith("src/"),
+    );
+    expect(includesSrc).toBe(true);
+  });
+});