rn-gamekit 0.1.0 → 0.2.0

package/lib/module/camera2d/transform.js

@@ -0,0 +1,151 @@
+"use strict";
+
+/**
+ * Camera2D transforms (T12.1).
+ *
+ * The frozen transform model (T12.0):
+ *
+ *     world point -> camera transform -> logical view point -> viewport -> surface
+ *     logical = L + rotate(P - C, -R) * Z
+ *     world   = C + rotate((logical - L) / Z, R)
+ *
+ * where C is the camera center, Z the zoom, R the rotation, and L the
+ * center of the authored logical view rect. Rotation follows the Skia
+ * convention (positive radians in the y-down screen plane); zoom is
+ * uniform and greater than zero. The convenience surface functions derive
+ * the logical view from the resolved viewport's visible bounds, so
+ * rendering and pointer input share one composition.
+ */
+
+import { GeometryError } from "../geometry/validation.js";
+import { surfaceToWorld, worldToSurface } from "../viewport2d/math.js";
+import { rotatedHalfExtents2D } from "./extents.js";
+import { assertFinitePoint2D, assertValidCamera2D, assertValidLogicalView } from "./validation.js";
+
+/** Rotate a point by an angle (Skia y-down convention). */
+export function rotatePoint2D(point, radians) {
+  const cos = Math.cos(radians);
+  const sin = Math.sin(radians);
+  return Object.freeze({
+    x: point.x * cos - point.y * sin,
+    y: point.x * sin + point.y * cos
+  });
+}
+
+/** The center of the camera's authored logical view. */
+export function logicalViewCenter2D(logicalView) {
+  return Object.freeze({
+    x: logicalView.x + logicalView.width / 2,
+    y: logicalView.y + logicalView.height / 2
+  });
+}
+
+/**
+ * Create a camera from optional partial values; missing fields default to
+ * the identity camera (`center` origin, `zoom` 1, no rotation).
+ */
+export function createCamera2D(value) {
+  if (value !== undefined && (typeof value !== 'object' || value === null || Array.isArray(value))) {
+    throw new GeometryError('GEOMETRY_INVALID_NUMBER', 'camera', `expected a camera record, got ${value === null ? 'null' : typeof value}`);
+  }
+  const camera = {
+    center: value?.center ?? {
+      x: 0,
+      y: 0
+    },
+    zoom: value?.zoom ?? 1,
+    rotationRadians: value?.rotationRadians ?? 0
+  };
+  assertValidCamera2D(camera);
+  return Object.freeze({
+    center: Object.freeze({
+      x: camera.center.x,
+      y: camera.center.y
+    }),
+    zoom: camera.zoom,
+    rotationRadians: camera.rotationRadians
+  });
+}
+
+/** World -> logical view: `L + rotate(P - C, -R) * Z`. */
+export function worldToLogical2D(point, camera, logicalView) {
+  assertValidCamera2D(camera);
+  assertFinitePoint2D(point, 'point');
+  assertValidLogicalView(logicalView);
+  const {
+    center,
+    zoom,
+    rotationRadians
+  } = camera;
+  const logical = logicalViewCenter2D(logicalView);
+  const delta = {
+    x: point.x - center.x,
+    y: point.y - center.y
+  };
+  const rotated = rotatePoint2D(delta, -rotationRadians);
+  return Object.freeze({
+    x: logical.x + rotated.x * zoom,
+    y: logical.y + rotated.y * zoom
+  });
+}
+
+/** Logical view -> world: `C + rotate((logical - L) / Z, R)`. */
+export function logicalToWorld2D(point, camera, logicalView) {
+  assertValidCamera2D(camera);
+  assertFinitePoint2D(point, 'point');
+  assertValidLogicalView(logicalView);
+  const {
+    center,
+    zoom,
+    rotationRadians
+  } = camera;
+  const logical = logicalViewCenter2D(logicalView);
+  const scaled = {
+    x: (point.x - logical.x) / zoom,
+    y: (point.y - logical.y) / zoom
+  };
+  const rotated = rotatePoint2D(scaled, rotationRadians);
+  return Object.freeze({
+    x: center.x + rotated.x,
+    y: center.y + rotated.y
+  });
+}
+
+/** The conservative world-space AABB visible through the camera. */
+export function getCameraVisibleBounds2D(camera, logicalView) {
+  assertValidCamera2D(camera);
+  assertValidLogicalView(logicalView);
+  const halfWidth = logicalView.width / 2 / camera.zoom;
+  const halfHeight = logicalView.height / 2 / camera.zoom;
+  const extent = rotatedHalfExtents2D(halfWidth, halfHeight, camera.rotationRadians);
+  const extentX = extent.x;
+  const extentY = extent.y;
+  return Object.freeze({
+    x: camera.center.x - extentX,
+    y: camera.center.y - extentY,
+    width: extentX * 2,
+    height: extentY * 2
+  });
+}
+
+/**
+ * World -> surface through the camera and the resolved viewport.
+ *
+ * The camera's logical view is the viewport's visible logical bounds, so
+ * this composes exactly the transform the renderer draws with.
+ */
+export function worldToSurface2D(point, viewport, camera) {
+  assertValidCamera2D(camera);
+  assertFinitePoint2D(point, 'point');
+  const logical = worldToLogical2D(point, camera, viewport.visibleLogicalBounds);
+  return worldToSurface(viewport, logical);
+}
+
+/** Surface -> world through the viewport and the presented camera. */
+export function surfaceToWorld2D(point, viewport, camera) {
+  assertValidCamera2D(camera);
+  assertFinitePoint2D(point, 'point');
+  const logical = surfaceToWorld(viewport, point);
+  return logicalToWorld2D(logical, camera, viewport.visibleLogicalBounds);
+}
+//# sourceMappingURL=transform.js.map

package/lib/module/camera2d/transform.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["GeometryError","surfaceToWorld","worldToSurface","rotatedHalfExtents2D","assertFinitePoint2D","assertValidCamera2D","assertValidLogicalView","rotatePoint2D","point","radians","cos","Math","sin","Object","freeze","x","y","logicalViewCenter2D","logicalView","width","height","createCamera2D","value","undefined","Array","isArray","camera","center","zoom","rotationRadians","worldToLogical2D","logical","delta","rotated","logicalToWorld2D","scaled","getCameraVisibleBounds2D","halfWidth","halfHeight","extent","extentX","extentY","worldToSurface2D","viewport","visibleLogicalBounds","surfaceToWorld2D"],"sourceRoot":"../../../src","sources":["camera2d/transform.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/camera2d/types.js

@@ -0,0 +1,4 @@
+"use strict";
+
+export {};
+//# sourceMappingURL=types.js.map

package/lib/module/camera2d/types.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../../src","sources":["camera2d/types.ts"],"mappings":"","ignoreList":[]}

package/lib/module/camera2d/validation.js

@@ -0,0 +1,98 @@
+"use strict";
+
+/**
+ * Camera2D validation (T12.1, T12-F6).
+ *
+ * Reuses the Task 11 structured `GeometryError` codes so failures identify
+ * the operation and the invalid field. Validation happens at public
+ * operation boundaries; values are never coerced. Outer shapes are checked
+ * BEFORE field dereferencing, so null, arrays, and missing nested objects
+ * produce structured errors instead of incidental `TypeError`s.
+ */
+
+import { assertFiniteNumber, assertNonnegativeSize, GeometryError } from "../geometry/validation.js";
+function isRecord(value) {
+  return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+
+/** Assert the outer shape of a camera before dereferencing fields. */
+export function assertCameraShape(camera, field) {
+  if (!isRecord(camera)) {
+    throw new GeometryError('GEOMETRY_INVALID_NUMBER', field, `expected a camera record, got ${camera === null ? 'null' : typeof camera}`);
+  }
+  if (!isRecord(camera.center)) {
+    throw new GeometryError('GEOMETRY_INVALID_NUMBER', `${field}.center`, `expected a point record, got ${camera.center === null ? 'null' : typeof camera.center}`);
+  }
+}
+
+/** Assert a valid camera value (shape + fields). */
+export function assertValidCamera2D(camera) {
+  assertCameraShape(camera, 'camera');
+  assertFiniteNumber(camera.center.x, 'camera.center.x');
+  assertFiniteNumber(camera.center.y, 'camera.center.y');
+  assertFiniteNumber(camera.zoom, 'camera.zoom');
+  if (!(camera.zoom > 0)) {
+    throw new GeometryError('GEOMETRY_INVALID_NUMBER', 'camera.zoom', `expected a finite zoom greater than zero, got ${String(camera.zoom)}`);
+  }
+  assertFiniteNumber(camera.rotationRadians, 'camera.rotationRadians');
+}
+
+/** Assert a finite point (shape first). */
+export function assertFinitePoint2D(point, field) {
+  if (!isRecord(point)) {
+    throw new GeometryError('GEOMETRY_INVALID_NUMBER', field, `expected a point record, got ${point === null ? 'null' : typeof point}`);
+  }
+  const typed = point;
+  assertFiniteNumber(typed.x, `${field}.x`);
+  assertFiniteNumber(typed.y, `${field}.y`);
+}
+
+/** Assert a valid logical view rect (shape + finite positive size). */
+export function assertValidLogicalView(view) {
+  if (!isRecord(view)) {
+    throw new GeometryError('GEOMETRY_INVALID_NUMBER', 'logicalView', `expected a rect record, got ${view === null ? 'null' : typeof view}`);
+  }
+  const typed = view;
+  assertFiniteNumber(typed.x, 'logicalView.x');
+  assertFiniteNumber(typed.y, 'logicalView.y');
+  assertNonnegativeSize(typed.width, 'logicalView.width');
+  assertNonnegativeSize(typed.height, 'logicalView.height');
+  if (!(typed.width > 0) || !(typed.height > 0)) {
+    throw new GeometryError('GEOMETRY_INVALID_SIZE', 'logicalView', `expected a positive logical view size, got ${view.width} x ${view.height}`);
+  }
+}
+
+/** Assert a nonnegative padding. */
+export function assertNonnegativePadding(padding) {
+  assertNonnegativeSize(padding, 'padding');
+}
+
+/**
+ * Strict full-camera clone (T12-SF3): validates a COMPLETE runtime camera —
+ * every required field present and finite — and returns an owned frozen
+ * copy. Unlike `createCamera2D` (which fills partial authored options with
+ * identity defaults), a missing field is rejected. Used at publication
+ * boundaries where a partial value must never be silently completed.
+ */
+export function cloneValidCamera2D(camera, field = 'camera') {
+  assertCameraShape(camera, field);
+  const typed = camera;
+  const centerField = `${field}.center`;
+  assertFiniteNumber(typed.center.x, `${centerField}.x`);
+  assertFiniteNumber(typed.center.y, `${centerField}.y`);
+  if (typeof typed.zoom !== 'number' || !Number.isFinite(typed.zoom) || !(typed.zoom > 0)) {
+    throw new GeometryError('GEOMETRY_INVALID_NUMBER', `${field}.zoom`, `expected a finite zoom greater than zero, got ${String(typed.zoom)}`);
+  }
+  if (typeof typed.rotationRadians !== 'number' || !Number.isFinite(typed.rotationRadians)) {
+    throw new GeometryError('GEOMETRY_INVALID_NUMBER', `${field}.rotationRadians`, `expected a finite rotation, got ${String(typed.rotationRadians)}`);
+  }
+  return Object.freeze({
+    center: Object.freeze({
+      x: typed.center.x,
+      y: typed.center.y
+    }),
+    zoom: typed.zoom,
+    rotationRadians: typed.rotationRadians
+  });
+}
+//# sourceMappingURL=validation.js.map

package/lib/module/camera2d/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["assertFiniteNumber","assertNonnegativeSize","GeometryError","isRecord","value","Array","isArray","assertCameraShape","camera","field","center","assertValidCamera2D","x","y","zoom","String","rotationRadians","assertFinitePoint2D","point","typed","assertValidLogicalView","view","width","height","assertNonnegativePadding","padding","cloneValidCamera2D","centerField","Number","isFinite","Object","freeze"],"sourceRoot":"../../../src","sources":["camera2d/validation.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/camera2d/visibility.js

@@ -0,0 +1,138 @@
+"use strict";
+
+/**
+ * Camera2D visibility (T12.6).
+ *
+ * Presentation-only culling: computes what the camera can see and filters
+ * render records without changing simulation. An off-screen entity keeps
+ * simulating, colliding, and re-entering view. For rotated cameras the
+ * broad test uses the conservative visible AABB (a superset of the actual
+ * view polygon), so false positives are possible but false negatives are
+ * not — a visible object can never pop out.
+ */
+
+import { assertFiniteNumber, assertNonnegativeSize, GeometryError } from "../geometry/validation.js";
+import { intersectsAabbAabb2D, intersectsCircleAabb2D, pointInAabb2D } from "../collision2d/index.js";
+import { getCameraVisibleBounds2D } from "./transform.js";
+import { assertValidCamera2D, assertValidLogicalView, assertNonnegativePadding } from "./validation.js";
+function assertPointPayload(value, field) {
+  if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+    throw new GeometryError('GEOMETRY_INVALID_NUMBER', field, `expected a point record, got ${value === null ? 'null' : typeof value}`);
+  }
+  const typed = value;
+  assertFiniteNumber(typed.x, `${field}.x`);
+  assertFiniteNumber(typed.y, `${field}.y`);
+}
+function assertShapeRecord(shape) {
+  if (typeof shape !== 'object' || shape === null || Array.isArray(shape)) {
+    throw new GeometryError('GEOMETRY_INVALID_NUMBER', 'shape', `expected a visibility shape record, got ${shape === null ? 'null' : typeof shape}`);
+  }
+  const kind = shape.kind;
+  // T12-SF3: the payload is validated with Camera2D-prefixed nested paths
+  // BEFORE any Collision2D predicate dereferences it.
+  switch (kind) {
+    case 'aabb':
+      assertItemBounds(shape.bounds, 'shape.bounds');
+      return;
+    case 'circle':
+      {
+        const circle = shape.circle;
+        if (typeof circle !== 'object' || circle === null || Array.isArray(circle)) {
+          throw new GeometryError('GEOMETRY_INVALID_NUMBER', 'shape.circle', `expected a circle record, got ${circle === null ? 'null' : typeof circle}`);
+        }
+        const typed = circle;
+        assertFiniteNumber(typed.x, 'shape.circle.x');
+        assertFiniteNumber(typed.y, 'shape.circle.y');
+        assertNonnegativeSize(typed.radius, 'shape.circle.radius');
+        return;
+      }
+    case 'point':
+      assertPointPayload(shape.point, 'shape.point');
+      return;
+    default:
+      throw new GeometryError('GEOMETRY_INVALID_NUMBER', 'shape.kind', `expected 'aabb' | 'circle' | 'point', got ${String(kind)}`);
+  }
+}
+function assertItemBounds(bounds, field = 'items.bounds') {
+  if (typeof bounds !== 'object' || bounds === null || Array.isArray(bounds)) {
+    throw new GeometryError('GEOMETRY_INVALID_NUMBER', field, `expected a rect record, got ${bounds === null ? 'null' : typeof bounds}`);
+  }
+  const typed = bounds;
+  assertFiniteNumber(typed.x, `${field}.x`);
+  assertFiniteNumber(typed.y, `${field}.y`);
+  assertNonnegativeSize(typed.width, `${field}.width`);
+  assertNonnegativeSize(typed.height, `${field}.height`);
+}
+function assertItemsArray(items) {
+  if (!Array.isArray(items)) {
+    throw new GeometryError('GEOMETRY_INVALID_NUMBER', 'items', `expected an array of indexed records, got ${items === null ? 'null' : typeof items}`);
+  }
+  for (const item of items) {
+    if (typeof item !== 'object' || item === null || Array.isArray(item)) {
+      throw new GeometryError('GEOMETRY_INVALID_NUMBER', 'items', 'expected item records');
+    }
+    const typed = item;
+    if (typeof typed.id !== 'string') {
+      throw new GeometryError('GEOMETRY_INVALID_NUMBER', 'items.id', 'expected a string id');
+    }
+    assertItemBounds(typed.bounds);
+  }
+}
+
+/** A shape queryable against the camera view. */
+
+/** The visible world bounds expanded by an optional padding. */
+export function paddedCameraBounds2D(camera, logicalView, padding = 0) {
+  assertValidCamera2D(camera);
+  assertValidLogicalView(logicalView);
+  assertNonnegativePadding(padding);
+  const bounds = getCameraVisibleBounds2D(camera, logicalView);
+  return Object.freeze({
+    x: bounds.x - padding,
+    y: bounds.y - padding,
+    width: bounds.width + padding * 2,
+    height: bounds.height + padding * 2
+  });
+}
+
+/**
+ * Whether a shape intersects the camera's visible region.
+ *
+ * The test is conservative: it uses the visible world AABB (exact for
+ * unrotated cameras, a superset for rotated ones). `padding` extends the
+ * region in world units for sprites and effects that draw outside their
+ * logical bounds.
+ */
+export function intersectsCameraView2D(shape, camera, logicalView, padding = 0) {
+  assertShapeRecord(shape);
+  const visible = paddedCameraBounds2D(camera, logicalView, padding);
+  switch (shape.kind) {
+    case 'aabb':
+      return intersectsAabbAabb2D(shape.bounds, visible);
+    case 'circle':
+      return intersectsCircleAabb2D(shape.circle, visible);
+    case 'point':
+      return pointInAabb2D(shape.point, visible);
+  }
+}
+
+/**
+ * Filter indexed render records, preserving stable order.
+ *
+ * Returns a frozen copy containing only the records whose world bounds
+ * intersect the visible region (plus `padding`). Off-screen records keep
+ * their identity and order in the caller's array; nothing here mutates
+ * them or changes simulation.
+ */
+export function filterCameraVisible2D(items, camera, logicalView, padding = 0) {
+  assertItemsArray(items);
+  const visible = paddedCameraBounds2D(camera, logicalView, padding);
+  const kept = [];
+  for (const item of items) {
+    if (intersectsAabbAabb2D(item.bounds, visible)) {
+      kept.push(item);
+    }
+  }
+  return Object.freeze(kept);
+}
+//# sourceMappingURL=visibility.js.map

package/lib/module/camera2d/visibility.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["assertFiniteNumber","assertNonnegativeSize","GeometryError","intersectsAabbAabb2D","intersectsCircleAabb2D","pointInAabb2D","getCameraVisibleBounds2D","assertValidCamera2D","assertValidLogicalView","assertNonnegativePadding","assertPointPayload","value","field","Array","isArray","typed","x","y","assertShapeRecord","shape","kind","assertItemBounds","bounds","circle","radius","point","String","width","height","assertItemsArray","items","item","id","paddedCameraBounds2D","camera","logicalView","padding","Object","freeze","intersectsCameraView2D","visible","filterCameraVisible2D","kept","push"],"sourceRoot":"../../../src","sources":["camera2d/visibility.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/camera2d.js

@@ -0,0 +1,9 @@
+"use strict";
+
+/**
+ * Subpath entry for `rn-gamekit/camera2d`.
+ *
+ * Headless camera math — no React hooks, Skia, or native peers.
+ */
+export * from "./camera2d/index.js";
+//# sourceMappingURL=camera2d.js.map

package/lib/module/camera2d.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../src","sources":["camera2d.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA,cAAc,qBAAkB","ignoreList":[]}