isometric-physics 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Carson Fujita
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.cjs

@@ -0,0 +1,133 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  getCardinalLabel: () => getCardinalLabel,
+  getToScreen: () => getToScreen,
+  isoTransform: () => isoTransform,
+  stepVesselPosition: () => stepVesselPosition,
+  vec2Add: () => vec2Add,
+  vec2Dot: () => vec2Dot,
+  vec2Length: () => vec2Length,
+  vec2Normalize: () => vec2Normalize,
+  vec2Scale: () => vec2Scale,
+  vec2Sub: () => vec2Sub,
+  vec3Add: () => vec3Add,
+  vec3Cross: () => vec3Cross,
+  vec3Dot: () => vec3Dot,
+  vec3Length: () => vec3Length,
+  vec3Normalize: () => vec3Normalize,
+  vec3Scale: () => vec3Scale,
+  vec3Sub: () => vec3Sub
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/isometric.ts
+var ISO_ANGLE = Math.PI / 6;
+var COS_30 = Math.cos(ISO_ANGLE);
+var SIN_30 = Math.sin(ISO_ANGLE);
+var isoTransform = (x, y, z = 0) => ({
+  x: (x - y) * COS_30,
+  y: (x + y) * SIN_30 - z
+});
+var getToScreen = (centerX, centerY, scale = 1) => (x, y, z) => {
+  const iso = isoTransform(x * scale, y * scale, z * scale);
+  return { x: centerX + iso.x, y: centerY + iso.y };
+};
+var getCardinalLabel = (heading) => {
+  const directions = [
+    { min: 337.5, max: 360, label: "N" },
+    { min: 0, max: 22.5, label: "N" },
+    { min: 22.5, max: 67.5, label: "NE" },
+    { min: 67.5, max: 112.5, label: "E" },
+    { min: 112.5, max: 157.5, label: "SE" },
+    { min: 157.5, max: 202.5, label: "S" },
+    { min: 202.5, max: 247.5, label: "SW" },
+    { min: 247.5, max: 292.5, label: "W" },
+    { min: 292.5, max: 337.5, label: "NW" }
+  ];
+  for (const dir of directions) {
+    if (heading >= dir.min && heading < dir.max) return dir.label;
+  }
+  return "N";
+};
+
+// src/vectors.ts
+var vec2Add = (a, b) => ({ x: a.x + b.x, y: a.y + b.y });
+var vec2Sub = (a, b) => ({ x: a.x - b.x, y: a.y - b.y });
+var vec2Scale = (v, s) => ({ x: v.x * s, y: v.y * s });
+var vec2Length = (v) => Math.sqrt(v.x ** 2 + v.y ** 2);
+var vec2Normalize = (v) => {
+  const l = vec2Length(v) || 1;
+  return vec2Scale(v, 1 / l);
+};
+var vec2Dot = (a, b) => a.x * b.x + a.y * b.y;
+var vec3Add = (a, b) => ({ x: a.x + b.x, y: a.y + b.y, z: a.z + b.z });
+var vec3Sub = (a, b) => ({ x: a.x - b.x, y: a.y - b.y, z: a.z - b.z });
+var vec3Scale = (v, s) => ({ x: v.x * s, y: v.y * s, z: v.z * s });
+var vec3Length = (v) => Math.sqrt(v.x ** 2 + v.y ** 2 + v.z ** 2);
+var vec3Normalize = (v) => {
+  const l = vec3Length(v) || 1;
+  return vec3Scale(v, 1 / l);
+};
+var vec3Dot = (a, b) => a.x * b.x + a.y * b.y + a.z * b.z;
+var vec3Cross = (a, b) => ({
+  x: a.y * b.z - a.z * b.y,
+  y: a.z * b.x - a.x * b.z,
+  z: a.x * b.y - a.y * b.x
+});
+
+// src/physics.ts
+var stepVesselPosition = (pos, velocity, rotationDeg, deltaTime, gridSize) => {
+  if (velocity === 0) return pos;
+  const limit = gridSize / 2;
+  const rad = -rotationDeg * Math.PI / 180;
+  const dx = -velocity * Math.sin(rad) * deltaTime;
+  const dy = -velocity * Math.cos(rad) * deltaTime;
+  let newX = pos.x + dx;
+  let newY = pos.y + dy;
+  if (newX > limit) newX -= gridSize;
+  if (newX < -limit) newX += gridSize;
+  if (newY > limit) newY -= gridSize;
+  if (newY < -limit) newY += gridSize;
+  return { x: newX, y: newY };
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  getCardinalLabel,
+  getToScreen,
+  isoTransform,
+  stepVesselPosition,
+  vec2Add,
+  vec2Dot,
+  vec2Length,
+  vec2Normalize,
+  vec2Scale,
+  vec2Sub,
+  vec3Add,
+  vec3Cross,
+  vec3Dot,
+  vec3Length,
+  vec3Normalize,
+  vec3Scale,
+  vec3Sub
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/isometric.ts","../src/vectors.ts","../src/physics.ts"],"sourcesContent":["export * from './isometric.js';\nexport * from './vectors.js';\nexport * from './physics.js';\n","/**\n * @file isometric.ts\n * @description Isometric projection math: standard 2:1 dimetric projection (X right-down, Y left-down, Z up).\n * @version 1.0.0\n */\n\nexport type Point = { x: number; y: number };\n\nconst ISO_ANGLE = Math.PI / 6;\nconst COS_30 = Math.cos(ISO_ANGLE);\nconst SIN_30 = Math.sin(ISO_ANGLE);\n\n/**\n * Standard isometric projection (X right-down, Y left-down, Z up).\n * @version 1.0.0\n */\nexport const isoTransform = (x: number, y: number, z = 0): Point => ({\n    x: (x - y) * COS_30,\n    y: (x + y) * SIN_30 - z,\n});\n\n/**\n * Creates a projection function bound to a specific canvas origin and scale.\n */\nexport const getToScreen = (centerX: number, centerY: number, scale = 1) =>\n    (x: number, y: number, z: number): Point => {\n        const iso = isoTransform(x * scale, y * scale, z * scale);\n        return { x: centerX + iso.x, y: centerY + iso.y };\n    };\n\n/**\n * Returns a cardinal direction label for a heading in degrees (0–360).\n */\nexport const getCardinalLabel = (heading: number): string => {\n    const directions = [\n        { min: 337.5, max: 360, label: 'N' },\n        { min: 0,     max: 22.5,  label: 'N' },\n        { min: 22.5,  max: 67.5,  label: 'NE' },\n        { min: 67.5,  max: 112.5, label: 'E' },\n        { min: 112.5, max: 157.5, label: 'SE' },\n        { min: 157.5, max: 202.5, label: 'S' },\n        { min: 202.5, max: 247.5, label: 'SW' },\n        { min: 247.5, max: 292.5, label: 'W' },\n        { min: 292.5, max: 337.5, label: 'NW' },\n    ];\n    for (const dir of directions) {\n        if (heading >= dir.min && heading < dir.max) return dir.label;\n    }\n    return 'N';\n};\n","/**\n * @file vectors.ts\n * @description Lightweight 2D and 3D vector types and operations.\n * @version 1.0.0\n */\n\nexport type Vector2 = { x: number; y: number };\nexport type Vector3 = { x: number; y: number; z: number };\n\nexport const vec2Add     = (a: Vector2, b: Vector2): Vector2 => ({ x: a.x + b.x, y: a.y + b.y });\nexport const vec2Sub     = (a: Vector2, b: Vector2): Vector2 => ({ x: a.x - b.x, y: a.y - b.y });\nexport const vec2Scale   = (v: Vector2, s: number):  Vector2 => ({ x: v.x * s,   y: v.y * s });\nexport const vec2Length  = (v: Vector2): number => Math.sqrt(v.x ** 2 + v.y ** 2);\nexport const vec2Normalize = (v: Vector2): Vector2 => {\n    const l = vec2Length(v) || 1;\n    return vec2Scale(v, 1 / l);\n};\nexport const vec2Dot     = (a: Vector2, b: Vector2): number => a.x * b.x + a.y * b.y;\n\nexport const vec3Add     = (a: Vector3, b: Vector3): Vector3 => ({ x: a.x + b.x, y: a.y + b.y, z: a.z + b.z });\nexport const vec3Sub     = (a: Vector3, b: Vector3): Vector3 => ({ x: a.x - b.x, y: a.y - b.y, z: a.z - b.z });\nexport const vec3Scale   = (v: Vector3, s: number):  Vector3 => ({ x: v.x * s,   y: v.y * s,   z: v.z * s });\nexport const vec3Length  = (v: Vector3): number => Math.sqrt(v.x ** 2 + v.y ** 2 + v.z ** 2);\nexport const vec3Normalize = (v: Vector3): Vector3 => {\n    const l = vec3Length(v) || 1;\n    return vec3Scale(v, 1 / l);\n};\nexport const vec3Dot     = (a: Vector3, b: Vector3): number => a.x * b.x + a.y * b.y + a.z * b.z;\nexport const vec3Cross   = (a: Vector3, b: Vector3): Vector3 => ({\n    x: a.y * b.z - a.z * b.y,\n    y: a.z * b.x - a.x * b.z,\n    z: a.x * b.y - a.y * b.x,\n});\n","/**\n * @file physics.ts\n * @description Pure vessel-position integration step, detached from React. Given a current\n * position, velocity, and heading, advances the position by one timestep and wraps it around\n * a square world of the given size.\n * @version 1.0.0\n */\nimport type { Point } from './isometric.js';\n\n/**\n * Advances a vessel's position by one physics step.\n * @param pos - Current { x, y } position in world units.\n * @param velocity - Current velocity in world units per second.\n * @param rotationDeg - Current heading in degrees (0 = north, 90 = east).\n * @param deltaTime - Elapsed time since the last step, in seconds.\n * @param gridSize - Total span of the (square) world; position wraps at ±gridSize/2.\n * @returns The new { x, y } position, wrapped to stay within the world bounds.\n * @version 1.0.0\n */\nexport const stepVesselPosition = (\n    pos: Point,\n    velocity: number,\n    rotationDeg: number,\n    deltaTime: number,\n    gridSize: number,\n): Point => {\n    if (velocity === 0) return pos;\n\n    const limit = gridSize / 2;\n    const rad = (-rotationDeg * Math.PI) / 180;\n    const dx = -velocity * Math.sin(rad) * deltaTime;\n    const dy = -velocity * Math.cos(rad) * deltaTime;\n\n    let newX = pos.x + dx;\n    let newY = pos.y + dy;\n    if (newX >  limit) newX -= gridSize;\n    if (newX < -limit) newX += gridSize;\n    if (newY >  limit) newY -= gridSize;\n    if (newY < -limit) newY += gridSize;\n\n    return { x: newX, y: newY };\n};\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,72 @@
+/**
+ * @file isometric.ts
+ * @description Isometric projection math: standard 2:1 dimetric projection (X right-down, Y left-down, Z up).
+ * @version 1.0.0
+ */
+type Point = {
+    x: number;
+    y: number;
+};
+/**
+ * Standard isometric projection (X right-down, Y left-down, Z up).
+ * @version 1.0.0
+ */
+declare const isoTransform: (x: number, y: number, z?: number) => Point;
+/**
+ * Creates a projection function bound to a specific canvas origin and scale.
+ */
+declare const getToScreen: (centerX: number, centerY: number, scale?: number) => (x: number, y: number, z: number) => Point;
+/**
+ * Returns a cardinal direction label for a heading in degrees (0–360).
+ */
+declare const getCardinalLabel: (heading: number) => string;
+
+/**
+ * @file vectors.ts
+ * @description Lightweight 2D and 3D vector types and operations.
+ * @version 1.0.0
+ */
+type Vector2 = {
+    x: number;
+    y: number;
+};
+type Vector3 = {
+    x: number;
+    y: number;
+    z: number;
+};
+declare const vec2Add: (a: Vector2, b: Vector2) => Vector2;
+declare const vec2Sub: (a: Vector2, b: Vector2) => Vector2;
+declare const vec2Scale: (v: Vector2, s: number) => Vector2;
+declare const vec2Length: (v: Vector2) => number;
+declare const vec2Normalize: (v: Vector2) => Vector2;
+declare const vec2Dot: (a: Vector2, b: Vector2) => number;
+declare const vec3Add: (a: Vector3, b: Vector3) => Vector3;
+declare const vec3Sub: (a: Vector3, b: Vector3) => Vector3;
+declare const vec3Scale: (v: Vector3, s: number) => Vector3;
+declare const vec3Length: (v: Vector3) => number;
+declare const vec3Normalize: (v: Vector3) => Vector3;
+declare const vec3Dot: (a: Vector3, b: Vector3) => number;
+declare const vec3Cross: (a: Vector3, b: Vector3) => Vector3;
+
+/**
+ * @file physics.ts
+ * @description Pure vessel-position integration step, detached from React. Given a current
+ * position, velocity, and heading, advances the position by one timestep and wraps it around
+ * a square world of the given size.
+ * @version 1.0.0
+ */
+
+/**
+ * Advances a vessel's position by one physics step.
+ * @param pos - Current { x, y } position in world units.
+ * @param velocity - Current velocity in world units per second.
+ * @param rotationDeg - Current heading in degrees (0 = north, 90 = east).
+ * @param deltaTime - Elapsed time since the last step, in seconds.
+ * @param gridSize - Total span of the (square) world; position wraps at ±gridSize/2.
+ * @returns The new { x, y } position, wrapped to stay within the world bounds.
+ * @version 1.0.0
+ */
+declare const stepVesselPosition: (pos: Point, velocity: number, rotationDeg: number, deltaTime: number, gridSize: number) => Point;
+
+export { type Point, type Vector2, type Vector3, getCardinalLabel, getToScreen, isoTransform, stepVesselPosition, vec2Add, vec2Dot, vec2Length, vec2Normalize, vec2Scale, vec2Sub, vec3Add, vec3Cross, vec3Dot, vec3Length, vec3Normalize, vec3Scale, vec3Sub };

package/dist/index.d.ts

@@ -0,0 +1,72 @@
+/**
+ * @file isometric.ts
+ * @description Isometric projection math: standard 2:1 dimetric projection (X right-down, Y left-down, Z up).
+ * @version 1.0.0
+ */
+type Point = {
+    x: number;
+    y: number;
+};
+/**
+ * Standard isometric projection (X right-down, Y left-down, Z up).
+ * @version 1.0.0
+ */
+declare const isoTransform: (x: number, y: number, z?: number) => Point;
+/**
+ * Creates a projection function bound to a specific canvas origin and scale.
+ */
+declare const getToScreen: (centerX: number, centerY: number, scale?: number) => (x: number, y: number, z: number) => Point;
+/**
+ * Returns a cardinal direction label for a heading in degrees (0–360).
+ */
+declare const getCardinalLabel: (heading: number) => string;
+
+/**
+ * @file vectors.ts
+ * @description Lightweight 2D and 3D vector types and operations.
+ * @version 1.0.0
+ */
+type Vector2 = {
+    x: number;
+    y: number;
+};
+type Vector3 = {
+    x: number;
+    y: number;
+    z: number;
+};
+declare const vec2Add: (a: Vector2, b: Vector2) => Vector2;
+declare const vec2Sub: (a: Vector2, b: Vector2) => Vector2;
+declare const vec2Scale: (v: Vector2, s: number) => Vector2;
+declare const vec2Length: (v: Vector2) => number;
+declare const vec2Normalize: (v: Vector2) => Vector2;
+declare const vec2Dot: (a: Vector2, b: Vector2) => number;
+declare const vec3Add: (a: Vector3, b: Vector3) => Vector3;
+declare const vec3Sub: (a: Vector3, b: Vector3) => Vector3;
+declare const vec3Scale: (v: Vector3, s: number) => Vector3;
+declare const vec3Length: (v: Vector3) => number;
+declare const vec3Normalize: (v: Vector3) => Vector3;
+declare const vec3Dot: (a: Vector3, b: Vector3) => number;
+declare const vec3Cross: (a: Vector3, b: Vector3) => Vector3;
+
+/**
+ * @file physics.ts
+ * @description Pure vessel-position integration step, detached from React. Given a current
+ * position, velocity, and heading, advances the position by one timestep and wraps it around
+ * a square world of the given size.
+ * @version 1.0.0
+ */
+
+/**
+ * Advances a vessel's position by one physics step.
+ * @param pos - Current { x, y } position in world units.
+ * @param velocity - Current velocity in world units per second.
+ * @param rotationDeg - Current heading in degrees (0 = north, 90 = east).
+ * @param deltaTime - Elapsed time since the last step, in seconds.
+ * @param gridSize - Total span of the (square) world; position wraps at ±gridSize/2.
+ * @returns The new { x, y } position, wrapped to stay within the world bounds.
+ * @version 1.0.0
+ */
+declare const stepVesselPosition: (pos: Point, velocity: number, rotationDeg: number, deltaTime: number, gridSize: number) => Point;
+
+export { type Point, type Vector2, type Vector3, getCardinalLabel, getToScreen, isoTransform, stepVesselPosition, vec2Add, vec2Dot, vec2Length, vec2Normalize, vec2Scale, vec2Sub, vec3Add, vec3Cross, vec3Dot, vec3Length, vec3Normalize, vec3Scale, vec3Sub };

package/dist/index.js

@@ -0,0 +1,90 @@
+// src/isometric.ts
+var ISO_ANGLE = Math.PI / 6;
+var COS_30 = Math.cos(ISO_ANGLE);
+var SIN_30 = Math.sin(ISO_ANGLE);
+var isoTransform = (x, y, z = 0) => ({
+  x: (x - y) * COS_30,
+  y: (x + y) * SIN_30 - z
+});
+var getToScreen = (centerX, centerY, scale = 1) => (x, y, z) => {
+  const iso = isoTransform(x * scale, y * scale, z * scale);
+  return { x: centerX + iso.x, y: centerY + iso.y };
+};
+var getCardinalLabel = (heading) => {
+  const directions = [
+    { min: 337.5, max: 360, label: "N" },
+    { min: 0, max: 22.5, label: "N" },
+    { min: 22.5, max: 67.5, label: "NE" },
+    { min: 67.5, max: 112.5, label: "E" },
+    { min: 112.5, max: 157.5, label: "SE" },
+    { min: 157.5, max: 202.5, label: "S" },
+    { min: 202.5, max: 247.5, label: "SW" },
+    { min: 247.5, max: 292.5, label: "W" },
+    { min: 292.5, max: 337.5, label: "NW" }
+  ];
+  for (const dir of directions) {
+    if (heading >= dir.min && heading < dir.max) return dir.label;
+  }
+  return "N";
+};
+
+// src/vectors.ts
+var vec2Add = (a, b) => ({ x: a.x + b.x, y: a.y + b.y });
+var vec2Sub = (a, b) => ({ x: a.x - b.x, y: a.y - b.y });
+var vec2Scale = (v, s) => ({ x: v.x * s, y: v.y * s });
+var vec2Length = (v) => Math.sqrt(v.x ** 2 + v.y ** 2);
+var vec2Normalize = (v) => {
+  const l = vec2Length(v) || 1;
+  return vec2Scale(v, 1 / l);
+};
+var vec2Dot = (a, b) => a.x * b.x + a.y * b.y;
+var vec3Add = (a, b) => ({ x: a.x + b.x, y: a.y + b.y, z: a.z + b.z });
+var vec3Sub = (a, b) => ({ x: a.x - b.x, y: a.y - b.y, z: a.z - b.z });
+var vec3Scale = (v, s) => ({ x: v.x * s, y: v.y * s, z: v.z * s });
+var vec3Length = (v) => Math.sqrt(v.x ** 2 + v.y ** 2 + v.z ** 2);
+var vec3Normalize = (v) => {
+  const l = vec3Length(v) || 1;
+  return vec3Scale(v, 1 / l);
+};
+var vec3Dot = (a, b) => a.x * b.x + a.y * b.y + a.z * b.z;
+var vec3Cross = (a, b) => ({
+  x: a.y * b.z - a.z * b.y,
+  y: a.z * b.x - a.x * b.z,
+  z: a.x * b.y - a.y * b.x
+});
+
+// src/physics.ts
+var stepVesselPosition = (pos, velocity, rotationDeg, deltaTime, gridSize) => {
+  if (velocity === 0) return pos;
+  const limit = gridSize / 2;
+  const rad = -rotationDeg * Math.PI / 180;
+  const dx = -velocity * Math.sin(rad) * deltaTime;
+  const dy = -velocity * Math.cos(rad) * deltaTime;
+  let newX = pos.x + dx;
+  let newY = pos.y + dy;
+  if (newX > limit) newX -= gridSize;
+  if (newX < -limit) newX += gridSize;
+  if (newY > limit) newY -= gridSize;
+  if (newY < -limit) newY += gridSize;
+  return { x: newX, y: newY };
+};
+export {
+  getCardinalLabel,
+  getToScreen,
+  isoTransform,
+  stepVesselPosition,
+  vec2Add,
+  vec2Dot,
+  vec2Length,
+  vec2Normalize,
+  vec2Scale,
+  vec2Sub,
+  vec3Add,
+  vec3Cross,
+  vec3Dot,
+  vec3Length,
+  vec3Normalize,
+  vec3Scale,
+  vec3Sub
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/isometric.ts","../src/vectors.ts","../src/physics.ts"],"sourcesContent":["/**\n * @file isometric.ts\n * @description Isometric projection math: standard 2:1 dimetric projection (X right-down, Y left-down, Z up).\n * @version 1.0.0\n */\n\nexport type Point = { x: number; y: number };\n\nconst ISO_ANGLE = Math.PI / 6;\nconst COS_30 = Math.cos(ISO_ANGLE);\nconst SIN_30 = Math.sin(ISO_ANGLE);\n\n/**\n * Standard isometric projection (X right-down, Y left-down, Z up).\n * @version 1.0.0\n */\nexport const isoTransform = (x: number, y: number, z = 0): Point => ({\n    x: (x - y) * COS_30,\n    y: (x + y) * SIN_30 - z,\n});\n\n/**\n * Creates a projection function bound to a specific canvas origin and scale.\n */\nexport const getToScreen = (centerX: number, centerY: number, scale = 1) =>\n    (x: number, y: number, z: number): Point => {\n        const iso = isoTransform(x * scale, y * scale, z * scale);\n        return { x: centerX + iso.x, y: centerY + iso.y };\n    };\n\n/**\n * Returns a cardinal direction label for a heading in degrees (0–360).\n */\nexport const getCardinalLabel = (heading: number): string => {\n    const directions = [\n        { min: 337.5, max: 360, label: 'N' },\n        { min: 0,     max: 22.5,  label: 'N' },\n        { min: 22.5,  max: 67.5,  label: 'NE' },\n        { min: 67.5,  max: 112.5, label: 'E' },\n        { min: 112.5, max: 157.5, label: 'SE' },\n        { min: 157.5, max: 202.5, label: 'S' },\n        { min: 202.5, max: 247.5, label: 'SW' },\n        { min: 247.5, max: 292.5, label: 'W' },\n        { min: 292.5, max: 337.5, label: 'NW' },\n    ];\n    for (const dir of directions) {\n        if (heading >= dir.min && heading < dir.max) return dir.label;\n    }\n    return 'N';\n};\n","/**\n * @file vectors.ts\n * @description Lightweight 2D and 3D vector types and operations.\n * @version 1.0.0\n */\n\nexport type Vector2 = { x: number; y: number };\nexport type Vector3 = { x: number; y: number; z: number };\n\nexport const vec2Add     = (a: Vector2, b: Vector2): Vector2 => ({ x: a.x + b.x, y: a.y + b.y });\nexport const vec2Sub     = (a: Vector2, b: Vector2): Vector2 => ({ x: a.x - b.x, y: a.y - b.y });\nexport const vec2Scale   = (v: Vector2, s: number):  Vector2 => ({ x: v.x * s,   y: v.y * s });\nexport const vec2Length  = (v: Vector2): number => Math.sqrt(v.x ** 2 + v.y ** 2);\nexport const vec2Normalize = (v: Vector2): Vector2 => {\n    const l = vec2Length(v) || 1;\n    return vec2Scale(v, 1 / l);\n};\nexport const vec2Dot     = (a: Vector2, b: Vector2): number => a.x * b.x + a.y * b.y;\n\nexport const vec3Add     = (a: Vector3, b: Vector3): Vector3 => ({ x: a.x + b.x, y: a.y + b.y, z: a.z + b.z });\nexport const vec3Sub     = (a: Vector3, b: Vector3): Vector3 => ({ x: a.x - b.x, y: a.y - b.y, z: a.z - b.z });\nexport const vec3Scale   = (v: Vector3, s: number):  Vector3 => ({ x: v.x * s,   y: v.y * s,   z: v.z * s });\nexport const vec3Length  = (v: Vector3): number => Math.sqrt(v.x ** 2 + v.y ** 2 + v.z ** 2);\nexport const vec3Normalize = (v: Vector3): Vector3 => {\n    const l = vec3Length(v) || 1;\n    return vec3Scale(v, 1 / l);\n};\nexport const vec3Dot     = (a: Vector3, b: Vector3): number => a.x * b.x + a.y * b.y + a.z * b.z;\nexport const vec3Cross   = (a: Vector3, b: Vector3): Vector3 => ({\n    x: a.y * b.z - a.z * b.y,\n    y: a.z * b.x - a.x * b.z,\n    z: a.x * b.y - a.y * b.x,\n});\n","/**\n * @file physics.ts\n * @description Pure vessel-position integration step, detached from React. Given a current\n * position, velocity, and heading, advances the position by one timestep and wraps it around\n * a square world of the given size.\n * @version 1.0.0\n */\nimport type { Point } from './isometric.js';\n\n/**\n * Advances a vessel's position by one physics step.\n * @param pos - Current { x, y } position in world units.\n * @param velocity - Current velocity in world units per second.\n * @param rotationDeg - Current heading in degrees (0 = north, 90 = east).\n * @param deltaTime - Elapsed time since the last step, in seconds.\n * @param gridSize - Total span of the (square) world; position wraps at ±gridSize/2.\n * @returns The new { x, y } position, wrapped to stay within the world bounds.\n * @version 1.0.0\n */\nexport const stepVesselPosition = (\n    pos: Point,\n    velocity: number,\n    rotationDeg: number,\n    deltaTime: number,\n    gridSize: number,\n): Point => {\n    if (velocity === 0) return pos;\n\n    const limit = gridSize / 2;\n    const rad = (-rotationDeg * Math.PI) / 180;\n    const dx = -velocity * Math.sin(rad) * deltaTime;\n    const dy = -velocity * Math.cos(rad) * deltaTime;\n\n    let newX = pos.x + dx;\n    let newY = pos.y + dy;\n    if (newX >  limit) newX -= gridSize;\n    if (newX < -limit) newX += gridSize;\n    if (newY >  limit) newY -= gridSize;\n    if (newY < -limit) newY += gridSize;\n\n    return { x: newX, y: newY };\n};\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "isometric-physics",
+  "version": "1.0.0",
+  "description": "Zero-dependency isometric projection math, 2D/3D vector operations, and vessel position integration.",
+  "author": "Carson Fujita <carsonfujita@gmail.com>",
+  "repository": "https://github.com/TheFujirose/isometric-physics",
+  "license": "MIT",
+  "keywords": [
+    "isometric",
+    "projection",
+    "vectors",
+    "physics",
+    "math"
+  ],
+  "sideEffects": false,
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "devDependencies": {
+    "tsup": "^8.5.1",
+    "typescript": "^6.0.3"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch"
+  }
+}