rn-gamekit 0.1.0 → 0.2.0

package/lib/module/events/payload.js

@@ -0,0 +1,219 @@
+"use strict";
+
+import { GameEventError } from "./errors.js";
+const MAX_PAYLOAD_NODES = 512;
+const MAX_PAYLOAD_DEPTH = 10;
+const MAX_PAYLOAD_STRING_LENGTH = 4096;
+const MAX_PAYLOAD_ARRAY_LENGTH = 256;
+
+/**
+ * Validate, clone, and deeply freeze a payload.
+ *
+ * Accepted: finite numbers, strings, booleans, `null`, `undefined` (as an
+ * optional property value), arrays, and plain records (`Object.prototype`
+ * or `Object.create(null)`). Rejected: functions, symbols, bigints,
+ * promises/thenables, sparse arrays, class instances, unsafe prototypes,
+ * native handles, React elements (`$$typeof`), cycles, accessors,
+ * non-enumerable properties, and non-finite numbers. Errors are reported
+ * with `Event "<name>" payload invalid at <path>`.
+ *
+ * The clone is frozen deeply so callers cannot mutate the staged envelope.
+ */
+export function cloneAndValidatePayload(payload, eventName, basePath = 'payload') {
+  let nodeCount = 0;
+  // Ancestry set — only the current recursion stack, not the entire visited graph.
+  // Shared acyclic references are allowed; true cycles are rejected.
+  const ancestry = new WeakSet();
+  const fail = (path, reason) => {
+    throw new GameEventError(`Event "${eventName}" payload invalid at ${path}: ${reason}`);
+  };
+  const isPlainRecord = value => {
+    const proto = Object.getPrototypeOf(value);
+    return proto === Object.prototype || proto === null;
+  };
+  const isReactElement = value => {
+    // Use descriptor to avoid invoking a getter for $$typeof.
+    const desc = Object.getOwnPropertyDescriptor(value, '$$typeof');
+    if (desc !== undefined) {
+      return true;
+    }
+    // Also check prototype chain via `in` without invoking getter? `in` can invoke proxy traps but not getters.
+    // For safety, also check `Object.prototype.hasOwnProperty` on the object and its prototype chain via `in`.
+    // If the object has a getter for $$typeof on its prototype, `in` will not invoke it, but `'$$typeof' in value` will still
+    // check presence without invoking. We use `in` as a fallback that does not execute the getter.
+    return '$$typeof' in value;
+  };
+  const clone = (value, path, depth) => {
+    if (depth > MAX_PAYLOAD_DEPTH) {
+      fail(path, `exceeds maximum depth of ${MAX_PAYLOAD_DEPTH}`);
+    }
+    nodeCount += 1;
+    if (nodeCount > MAX_PAYLOAD_NODES) {
+      fail(path, `exceeds maximum payload size of ${MAX_PAYLOAD_NODES} nodes`);
+    }
+    if (value === null || value === undefined) {
+      return value;
+    }
+    const type = typeof value;
+    if (type === 'string') {
+      const str = value;
+      if (str.length > MAX_PAYLOAD_STRING_LENGTH) {
+        fail(path, `string exceeds maximum length of ${MAX_PAYLOAD_STRING_LENGTH}`);
+      }
+      return str;
+    }
+    if (type === 'boolean') {
+      return value;
+    }
+    if (type === 'number') {
+      const num = value;
+      if (!Number.isFinite(num)) {
+        fail(path, 'number must be finite');
+      }
+      return num;
+    }
+    if (type === 'bigint') {
+      fail(path, 'bigint is not a supported payload type');
+    }
+    if (type === 'symbol') {
+      fail(path, 'symbol is not a supported payload type');
+    }
+    if (type === 'function') {
+      fail(path, 'function is not a supported payload type');
+    }
+    if (type !== 'object') {
+      fail(path, `unsupported payload type "${type}"`);
+    }
+    const obj = value;
+    if (ancestry.has(obj)) {
+      fail(path, 'cycle detected in payload');
+    }
+    ancestry.add(obj);
+
+    // Use try/finally to ensure ancestry is cleaned even when we throw.
+    try {
+      // GS-EVENT-03: thenables are rejected without invoking any user code.
+      // Only safe operations run here (instanceof, getPrototypeOf, own
+      // descriptors). A Promise fails with its useful path; every other
+      // non-plain object fails at the array/record branches below — the
+      // preliminary inherited `.then` read that could execute a getter is
+      // gone. Own `then` functions are rejected later as function values.
+      if (obj instanceof Promise) {
+        fail(path, 'promise/thenable is not a supported payload type');
+      }
+      if (isReactElement(obj)) {
+        fail(path, 'React element is not a supported payload type');
+      }
+      if (Array.isArray(obj)) {
+        const arr = obj;
+        if (Object.getPrototypeOf(arr) !== Array.prototype) {
+          fail(path, 'array subclass is not a supported payload type');
+        }
+        if (arr.length > MAX_PAYLOAD_ARRAY_LENGTH) {
+          fail(path, `array exceeds maximum length of ${MAX_PAYLOAD_ARRAY_LENGTH}`);
+        }
+
+        // Use descriptors to avoid invoking getters and to detect sparse holes.
+        const descs = Object.getOwnPropertyDescriptors(arr);
+        // Sparse check: every index < length must have an own descriptor.
+        for (let index = 0; index < arr.length; index += 1) {
+          const key = String(index);
+          if (!(key in descs)) {
+            fail(`${path}[${index}]`, 'sparse array holes are not supported');
+          }
+          const d = descs[key];
+          if (d.get !== undefined || d.set !== undefined) {
+            fail(`${path}[${index}]`, 'accessor property is not supported');
+          }
+          if (d.enumerable === false) {
+            fail(`${path}[${index}]`, 'non-enumerable property is not supported');
+          }
+        }
+
+        // Clone indices via descriptors to avoid getter invocation.
+        const cloned = new Array(arr.length);
+        for (let index = 0; index < arr.length; index += 1) {
+          const key = String(index);
+          const d = descs[key];
+          cloned[index] = clone(d.value, `${path}[${index}]`, depth + 1);
+        }
+
+        // Check for non-index own properties (including symbols).
+        for (const key of Reflect.ownKeys(descs)) {
+          if (typeof key === 'symbol') {
+            fail(`${path}[Symbol(${String(key).slice(7, -1)})]`, 'symbol-keyed property is not supported');
+          }
+          const k = key;
+          if (k === 'length') {
+            continue;
+          }
+          // Indices already handled.
+          if (/^(0|[1-9]\d*)$/.test(k)) {
+            const idx = Number(k);
+            if (idx < arr.length && String(idx) === k) {
+              continue;
+            }
+          }
+          if (k === '__proto__' || k === 'constructor' || k === 'prototype') {
+            fail(`${path}.${k}`, 'unsafe prototype key is not supported');
+          }
+          const d = descs[k];
+          if (d.get !== undefined || d.set !== undefined) {
+            fail(`${path}.${k}`, 'accessor property is not supported');
+          }
+          if (d.enumerable === false) {
+            fail(`${path}.${k}`, 'non-enumerable property is not supported');
+          }
+          fail(`${path}.${k}`, 'array extra property is not a supported payload member');
+        }
+        Object.freeze(cloned);
+        return cloned;
+      }
+
+      // Plain record
+      if (!isPlainRecord(obj)) {
+        fail(path, 'only plain records and arrays are supported (class instance, Map, Set, Date, etc. are rejected)');
+      }
+      const proto = Object.getPrototypeOf(obj);
+      const descs = Object.getOwnPropertyDescriptors(obj);
+      // Check for symbol keys and unsafe keys, and validate descriptors.
+      for (const key of Reflect.ownKeys(descs)) {
+        if (typeof key === 'symbol') {
+          fail(`${path}[Symbol(${String(key).slice(7, -1)})]`, 'symbol-keyed property is not supported');
+        }
+        const k = key;
+        if (k === '__proto__' || k === 'constructor' || k === 'prototype') {
+          fail(`${path}.${k}`, 'unsafe prototype key is not supported');
+        }
+        const d = descs[k];
+        if (d.get !== undefined || d.set !== undefined) {
+          fail(`${path}.${k}`, 'accessor property is not supported');
+        }
+        if (d.enumerable === false) {
+          fail(`${path}.${k}`, 'non-enumerable property is not supported');
+        }
+      }
+      const cloned = proto === null ? Object.create(null) : {};
+      for (const key of Object.keys(descs)) {
+        // `Object.keys` already filters to enumerable string keys, but we have already validated
+        // via `getOwnPropertyDescriptors` that all own keys are enumerable data properties.
+        // Use descriptor value without invoking getter (we already checked it's a data descriptor).
+        const d = descs[key];
+        cloned[key] = clone(d.value, `${path}.${key}`, depth + 1);
+      }
+      Object.freeze(cloned);
+      return cloned;
+    } finally {
+      ancestry.delete(obj);
+    }
+  };
+  const result = clone(payload, basePath, 0);
+  return result;
+}
+export const PAYLOAD_LIMITS = {
+  MAX_PAYLOAD_NODES,
+  MAX_PAYLOAD_DEPTH,
+  MAX_PAYLOAD_STRING_LENGTH,
+  MAX_PAYLOAD_ARRAY_LENGTH
+};
+//# sourceMappingURL=payload.js.map

package/lib/module/events/payload.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["GameEventError","MAX_PAYLOAD_NODES","MAX_PAYLOAD_DEPTH","MAX_PAYLOAD_STRING_LENGTH","MAX_PAYLOAD_ARRAY_LENGTH","cloneAndValidatePayload","payload","eventName","basePath","nodeCount","ancestry","WeakSet","fail","path","reason","isPlainRecord","value","proto","Object","getPrototypeOf","prototype","isReactElement","desc","getOwnPropertyDescriptor","undefined","clone","depth","type","str","length","num","Number","isFinite","obj","has","add","Promise","Array","isArray","arr","descs","getOwnPropertyDescriptors","index","key","String","d","get","set","enumerable","cloned","Reflect","ownKeys","slice","k","test","idx","freeze","create","keys","delete","result","PAYLOAD_LIMITS"],"sourceRoot":"../../../src","sources":["events/payload.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/events/seed.js

@@ -0,0 +1,33 @@
+"use strict";
+
+/**
+ * Derive a deterministic seed from a committed event envelope.
+ *
+ * The seed is stable within a session and across replays because it
+ * depends only on the envelope's identity `(tick, ordinal)` and name,
+ * never on wall time, React renders, or display frames.
+ *
+ * `seedGameEvent` is suitable for seeding seeded visual effects,
+ * particles, or audio variations that must replay identically.
+ */
+function hashString(value) {
+  let hash = 2166136261;
+  for (let index = 0; index < value.length; index += 1) {
+    hash ^= value.charCodeAt(index);
+    hash = Math.imul(hash, 16777619);
+  }
+  return hash >>> 0;
+}
+export function seedGameEvent(event) {
+  const nameHash = hashString(event.name);
+  // Deterministic mixing of tick, ordinal, and name hash — the documented
+  // stable identity (tick, ordinal, name). sceneTick is intentionally
+  // excluded; it is presentation-local and would make the seed disagree
+  // with its contract.
+  let seed = 17;
+  seed = Math.imul(seed, 31) + event.tick;
+  seed = Math.imul(seed, 31) + event.ordinal;
+  seed = Math.imul(seed, 31) + nameHash;
+  return seed >>> 0;
+}
+//# sourceMappingURL=seed.js.map

package/lib/module/events/seed.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["hashString","value","hash","index","length","charCodeAt","Math","imul","seedGameEvent","event","nameHash","name","seed","tick","ordinal"],"sourceRoot":"../../../src","sources":["events/seed.ts"],"mappings":";;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASA,UAAUA,CAACC,KAAa,EAAU;EACzC,IAAIC,IAAI,GAAG,UAAU;EACrB,KAAK,IAAIC,KAAK,GAAG,CAAC,EAAEA,KAAK,GAAGF,KAAK,CAACG,MAAM,EAAED,KAAK,IAAI,CAAC,EAAE;IACpDD,IAAI,IAAID,KAAK,CAACI,UAAU,CAACF,KAAK,CAAC;IAC/BD,IAAI,GAAGI,IAAI,CAACC,IAAI,CAACL,IAAI,EAAE,QAAQ,CAAC;EAClC;EACA,OAAOA,IAAI,KAAK,CAAC;AACnB;AAEA,OAAO,SAASM,aAAaA,CAACC,KAA2B,EAAU;EACjE,MAAMC,QAAQ,GAAGV,UAAU,CAACS,KAAK,CAACE,IAAI,CAAC;EACvC;EACA;EACA;EACA;EACA,IAAIC,IAAI,GAAG,EAAE;EACbA,IAAI,GAAGN,IAAI,CAACC,IAAI,CAACK,IAAI,EAAE,EAAE,CAAC,GAAGH,KAAK,CAACI,IAAI;EACvCD,IAAI,GAAGN,IAAI,CAACC,IAAI,CAACK,IAAI,EAAE,EAAE,CAAC,GAAGH,KAAK,CAACK,OAAO;EAC1CF,IAAI,GAAGN,IAAI,CAACC,IAAI,CAACK,IAAI,EAAE,EAAE,CAAC,GAAGF,QAAQ;EACrC,OAAOE,IAAI,KAAK,CAAC;AACnB","ignoreList":[]}

package/lib/module/events/types.js

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

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

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

package/lib/module/events.js

@@ -0,0 +1,13 @@
+"use strict";
+
+/**
+ * Subpath entry for `rn-gamekit/events`.
+ *
+ * Typed event definitions, envelopes, payload limits, seeding, and errors.
+ * Does not expose internal validation helpers or effect consumers.
+ */
+export { GameEventError } from "./events/errors.js";
+export { defineGameEvents, gameEvent } from "./events/defineGameEvents.js";
+export { seedGameEvent } from "./events/seed.js";
+export { PAYLOAD_LIMITS } from "./events/payload.js";
+//# sourceMappingURL=events.js.map

package/lib/module/events.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["GameEventError","defineGameEvents","gameEvent","seedGameEvent","PAYLOAD_LIMITS"],"sourceRoot":"../../src","sources":["events.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA,SAASA,cAAc,QAAQ,oBAAiB;AAChD,SAASC,gBAAgB,EAAEC,SAAS,QAAQ,8BAA2B;AACvE,SAASC,aAAa,QAAQ,kBAAe;AAC7C,SAASC,cAAc,QAAQ,qBAAkB","ignoreList":[]}

package/lib/module/geometry/helpers.js

@@ -0,0 +1,140 @@
+"use strict";
+
+/**
+ * Pure geometry helpers (T11.1): AABB centers, translation, expansion, and
+ * union, plus vector arithmetic. All functions validate their inputs,
+ * preserve them untouched, and return fresh immutable values.
+ */
+
+import { assertValidAabb2D, assertValidPoint2D, assertValidVector2D, GeometryError } from "./validation.js";
+
+/** Center of an AABB. */
+export function aabbCenter2D(aabb) {
+  assertValidAabb2D(aabb);
+  return Object.freeze({
+    x: aabb.x + aabb.width / 2,
+    y: aabb.y + aabb.height / 2
+  });
+}
+
+/** Translate an AABB by a delta vector, returning a new AABB. */
+export function translateAabb2D(aabb, delta) {
+  assertValidAabb2D(aabb);
+  assertValidVector2D(delta, 'delta');
+  return Object.freeze({
+    x: aabb.x + delta.x,
+    y: aabb.y + delta.y,
+    width: aabb.width,
+    height: aabb.height
+  });
+}
+
+/**
+ * Expand an AABB symmetrically (or per-axis) by the given amounts.
+ *
+ * A negative inset shrinks the AABB. The expanded result keeps the same
+ * width/height semantics; `inset` is the margin added on each side.
+ */
+export function expandAabb2D(aabb, inset) {
+  assertValidAabb2D(aabb);
+  const x = typeof inset === 'number' ? inset : inset.x;
+  const y = typeof inset === 'number' ? inset : inset.y;
+  assertFiniteInset(x, 'inset.x');
+  assertFiniteInset(y, 'inset.y');
+  const expanded = Object.freeze({
+    x: aabb.x - x,
+    y: aabb.y - y,
+    width: aabb.width + x * 2,
+    height: aabb.height + y * 2
+  });
+  // A negative inset may legitimately shrink the shape, but never into a
+  // malformed (negative-size) result.
+  assertValidAabb2D(expanded, 'expanded');
+  return expanded;
+}
+function assertFiniteInset(value, field) {
+  if (!Number.isFinite(value)) {
+    throw new GeometryError('GEOMETRY_INVALID_NUMBER', field, `expected a finite inset, got ${String(value)}`);
+  }
+}
+
+/** The smallest AABB containing both inputs (bounding union). */
+export function unionAabb2D(first, second) {
+  assertValidAabb2D(first, 'first');
+  assertValidAabb2D(second, 'second');
+  const minX = Math.min(first.x, second.x);
+  const minY = Math.min(first.y, second.y);
+  const maxX = Math.max(first.x + first.width, second.x + second.width);
+  const maxY = Math.max(first.y + first.height, second.y + second.height);
+  return Object.freeze({
+    x: minX,
+    y: minY,
+    width: maxX - minX,
+    height: maxY - minY
+  });
+}
+
+/** Component-wise vector addition. */
+export function addVector2D(first, second) {
+  assertValidVector2D(first, 'first');
+  assertValidVector2D(second, 'second');
+  return Object.freeze({
+    x: first.x + second.x,
+    y: first.y + second.y
+  });
+}
+
+/** Component-wise vector subtraction (`first - second`). */
+export function subtractVector2D(first, second) {
+  assertValidVector2D(first, 'first');
+  assertValidVector2D(second, 'second');
+  return Object.freeze({
+    x: first.x - second.x,
+    y: first.y - second.y
+  });
+}
+
+/** Scale a vector by a finite scalar. */
+export function scaleVector2D(vector, scalar) {
+  assertValidVector2D(vector);
+  if (!Number.isFinite(scalar)) {
+    throw new GeometryError('GEOMETRY_INVALID_NUMBER', 'scalar', `expected a finite number, got ${String(scalar)}`);
+  }
+  return Object.freeze({
+    x: vector.x * scalar,
+    y: vector.y * scalar
+  });
+}
+
+/** Euclidean length of a vector. */
+export function lengthVector2D(vector) {
+  assertValidVector2D(vector);
+  return Math.hypot(vector.x, vector.y);
+}
+
+/**
+ * Normalize a vector to unit length. The zero vector is returned unchanged
+ * (never NaN); callers that need a fallback direction choose it explicitly.
+ */
+export function normalizeVector2D(vector) {
+  assertValidVector2D(vector);
+  const length = Math.hypot(vector.x, vector.y);
+  if (length === 0) {
+    return Object.freeze({
+      x: 0,
+      y: 0
+    });
+  }
+  return Object.freeze({
+    x: vector.x / length,
+    y: vector.y / length
+  });
+}
+
+/** Euclidean distance between two points. */
+export function distancePoint2D(first, second) {
+  assertValidPoint2D(first, 'first');
+  assertValidPoint2D(second, 'second');
+  return Math.hypot(second.x - first.x, second.y - first.y);
+}
+//# sourceMappingURL=helpers.js.map

package/lib/module/geometry/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["assertValidAabb2D","assertValidPoint2D","assertValidVector2D","GeometryError","aabbCenter2D","aabb","Object","freeze","x","width","y","height","translateAabb2D","delta","expandAabb2D","inset","assertFiniteInset","expanded","value","field","Number","isFinite","String","unionAabb2D","first","second","minX","Math","min","minY","maxX","max","maxY","addVector2D","subtractVector2D","scaleVector2D","vector","scalar","lengthVector2D","hypot","normalizeVector2D","length","distancePoint2D"],"sourceRoot":"../../../src","sources":["geometry/helpers.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/geometry/index.js

@@ -0,0 +1,5 @@
+"use strict";
+
+export { GeometryError } from "./validation.js";
+export { aabbCenter2D, addVector2D, distancePoint2D, expandAabb2D, lengthVector2D, normalizeVector2D, scaleVector2D, subtractVector2D, translateAabb2D, unionAabb2D } from "./helpers.js";
+//# sourceMappingURL=index.js.map

package/lib/module/geometry/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["GeometryError","aabbCenter2D","addVector2D","distancePoint2D","expandAabb2D","lengthVector2D","normalizeVector2D","scaleVector2D","subtractVector2D","translateAabb2D","unionAabb2D"],"sourceRoot":"../../../src","sources":["geometry/index.ts"],"mappings":";;AACA,SAASA,aAAa,QAAgC,iBAAc;AACpE,SACEC,YAAY,EACZC,WAAW,EACXC,eAAe,EACfC,YAAY,EACZC,cAAc,EACdC,iBAAiB,EACjBC,aAAa,EACbC,gBAAgB,EAChBC,eAAe,EACfC,WAAW,QACN,cAAW","ignoreList":[]}

package/lib/module/geometry/validation.js

@@ -0,0 +1,104 @@
+"use strict";
+
+/**
+ * Geometry validation and structured errors (T11.1).
+ *
+ * Mirrors the package's structured-error style (`GameAssetError`): a stable
+ * machine-readable code plus the offending field. Validation happens at
+ * public operation boundaries; helpers never coerce or reorder malformed
+ * values into valid shapes.
+ *
+ * Numeric policy (GS-GEOMETRY-01): validators require the declared
+ * structural shape (a null/array/scalar argument fails with
+ * GEOMETRY_INVALID_SHAPE, never a TypeError) and finite components within
+ * ordinary game-world magnitudes. Derived-value overflow from extreme
+ * finite inputs is out of contract: helpers do not re-validate results,
+ * and zero-length normalization of an overflowing length stays a zero
+ * vector by the existing defined behavior.
+ */
+
+/** Stable error codes for geometry and collision input. */
+
+/** A structured geometry or collision input failure. */
+export class GeometryError extends Error {
+  /** Stable machine-readable code. */
+
+  /** Field path within the value that caused the failure. */
+
+  constructor(code, field, message) {
+    super(`${code} at ${field}: ${message}`);
+    this.name = 'GeometryError';
+    this.code = code;
+    this.field = field;
+  }
+}
+
+/** Assert a finite number (rejects NaN and ±Infinity). */
+export function assertFiniteNumber(value, field) {
+  if (!Number.isFinite(value)) {
+    throw new GeometryError('GEOMETRY_INVALID_NUMBER', field, `expected a finite number, got ${String(value)}`);
+  }
+}
+
+/** Assert a finite, nonnegative size (width, height, radius). */
+export function assertNonnegativeSize(value, field) {
+  assertFiniteNumber(value, field);
+  if (value < 0) {
+    throw new GeometryError('GEOMETRY_INVALID_SIZE', field, `expected a nonnegative size, got ${value}`);
+  }
+}
+
+/** Assert an unsigned 32-bit integer (collision filters and bit masks). */
+export function assertUnsigned32Bits(value, field) {
+  if (!Number.isInteger(value) || value < 0 || value > 0xffffffff) {
+    throw new GeometryError('GEOMETRY_INVALID_BITS', field, `expected an unsigned 32-bit integer, got ${String(value)}`);
+  }
+}
+
+/** Assert a value is a plain record before reading fields (GS-GEOMETRY-01). */
+function assertRecordShape(value, name) {
+  if (value === null || typeof value !== 'object' || Array.isArray(value)) {
+    throw new GeometryError('GEOMETRY_INVALID_SHAPE', name, `expected an object with numeric fields, got ${Array.isArray(value) ? 'an array' : String(value)}`);
+  }
+}
+
+/** Validate a point or vector component pair. */
+export function assertValidPoint2D(point, name = 'point') {
+  assertRecordShape(point, name);
+  assertFiniteNumber(point.x, `${name}.x`);
+  assertFiniteNumber(point.y, `${name}.y`);
+}
+
+/** Validate a vector (same shape as a point, distinct naming). */
+export function assertValidVector2D(vector, name = 'vector') {
+  assertRecordShape(vector, name);
+  assertFiniteNumber(vector.x, `${name}.x`);
+  assertFiniteNumber(vector.y, `${name}.y`);
+}
+
+/** Validate an AABB: finite corner, finite nonnegative size. */
+export function assertValidAabb2D(aabb, name = 'aabb') {
+  assertRecordShape(aabb, name);
+  assertFiniteNumber(aabb.x, `${name}.x`);
+  assertFiniteNumber(aabb.y, `${name}.y`);
+  assertNonnegativeSize(aabb.width, `${name}.width`);
+  assertNonnegativeSize(aabb.height, `${name}.height`);
+}
+
+/** Validate a circle: finite center, finite nonnegative radius. */
+export function assertValidCircle2D(circle, name = 'circle') {
+  assertRecordShape(circle, name);
+  assertFiniteNumber(circle.x, `${name}.x`);
+  assertFiniteNumber(circle.y, `${name}.y`);
+  assertNonnegativeSize(circle.radius, `${name}.radius`);
+}
+/** Validate a segment: finite endpoints that are not both degenerate checks. */
+export function assertValidSegment2D(segment, name = 'segment') {
+  assertRecordShape(segment, name);
+  assertValidPoint2D(segment.start, `${name}.start`);
+  assertValidPoint2D(segment.end, `${name}.end`);
+  if (segment.start.x === segment.end.x && segment.start.y === segment.end.y) {
+    throw new GeometryError('GEOMETRY_INVALID_SEGMENT', name, 'expected distinct endpoints, got a zero-length segment');
+  }
+}
+//# sourceMappingURL=validation.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["GeometryError","Error","constructor","code","field","message","name","assertFiniteNumber","value","Number","isFinite","String","assertNonnegativeSize","assertUnsigned32Bits","isInteger","assertRecordShape","Array","isArray","assertValidPoint2D","point","x","y","assertValidVector2D","vector","assertValidAabb2D","aabb","width","height","assertValidCircle2D","circle","radius","assertValidSegment2D","segment","start","end"],"sourceRoot":"../../../src","sources":["geometry/validation.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/geometry.js

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

package/lib/module/geometry.js.map

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