@flighthq/geometry 0.1.0

package/dist/vector3.d.ts

@@ -0,0 +1,220 @@
+import type { Vector2Like, Vector3, Vector3Like, Vector4Like } from '@flighthq/types';
+/**
+ * Adds the x, y and z components of two vector objects
+ * and writes to out.
+ */
+export declare function addVector3(out: Vector3Like, a: Readonly<Vector3Like>, b: Readonly<Vector3Like>): void;
+/**
+ * Clamps each component of a Vector3Like independently to [min, max].
+ *
+ * Safe when `out` aliases `value`, `min`, or `max`.
+ */
+export declare function clampVector3(out: Vector3Like, value: Readonly<Vector3Like>, min: Readonly<Vector3Like>, max: Readonly<Vector3Like>): void;
+export declare function cloneVector3(source: Readonly<Vector3Like>): Vector3;
+/**
+ * Copies the x, y and z components of a vector.
+ */
+export declare function copyVector3(out: Vector3Like, source: Readonly<Vector3Like>): void;
+/**
+ * The Vector3Like class represents a point or a location in the three-dimensional space using
+ * the Cartesian coordinates x, y, and z. As in a two-dimensional space, the `x` property
+ * represents the horizontal axis and the `y` property represents the vertical axis. In
+ * three-dimensional space, the `z` property represents depth. The value of the `x` property increases as the object moves to the right. The value of the `y` property
+ * increases as the object moves down. The `z` property increases as the object moves
+ * farther from the point of view. Using perspective projection and scaling, the object is
+ * seen to be bigger when near and smaller when farther away from the screen. As in a
+ * right-handed three-dimensional coordinate system, the positive z-axis points away from
+ * the viewer and the value of the `z` property increases as the object moves away from the
+ * viewer's eye. The origin point (0,0,0) of the global space is the upper-left corner of
+ * the stage.
+ *
+ * Invariants:
+ *
+ * - `X_AXIS = new Vector3Like(1, 0, 0);`
+ * - `Y_AXIS = new Vector3Like(0, 1, 0);`
+ * - `Z_AXIS = new Vector3Like(0, 0, 1);`
+ * - `length = Math.sqrt(x ** 2 + y ** 2 + z ** 2);`
+ * - `lengthSquared = x ** 2 + y ** 2 + z ** 2;`
+ */
+export declare function createVector3(x?: number, y?: number, z?: number): Vector3;
+/**
+ * Creates a Vector3 from spherical coordinates (physics convention: radius, inclination θ from
+ * +Y axis, azimuth φ from +X axis in the XZ plane).
+ *
+ * - `theta` is the polar angle measured from the +Y axis (0 = north pole, π = south pole).
+ * - `phi` is the azimuthal angle measured from the +X axis in the XZ plane.
+ */
+export declare function createVector3FromSpherical(radius: number, theta: number, phi: number): Vector3;
+/**
+ * Writes a Vector3Like object that is perpendicular (at a right angle) to the
+ * current Vector3Like and another Vector3Like object. If the returned Vector3Like object's
+ * coordinates are (0,0,0), then the two Vector3Like objects are parallel to each other.
+ **/
+export declare function crossVector3(out: Vector3Like, source: Readonly<Vector3Like>, other: Readonly<Vector3Like>): void;
+/**
+ * Component-wise division of two vectors (Hadamard division). Each component of
+ * `source` is divided by the corresponding component of `divisor`. Components with a
+ * zero divisor produce `0` in the output.
+ *
+ * Safe when `out` aliases `source` or `divisor`.
+ */
+export declare function divideVector3(out: Vector3Like, source: Readonly<Vector3Like>, divisor: Readonly<Vector3Like>): void;
+export declare function equalsVector3(a: Readonly<Vector3Like> | null | undefined, b: Readonly<Vector3Like> | null | undefined): boolean;
+/**
+ * Returns the angle in radians between two vectors. The returned angle is the
+ * smallest radian the first Vector3Like object rotates until it aligns with the
+ * second Vector3Like object.
+ **/
+export declare function getVector3AngleBetween(a: Readonly<Vector3Like>, b: Readonly<Vector3Like>): number;
+/**
+ * Returns the distance between two Vector3Like objects.
+ **/
+export declare function getVector3Distance(a: Readonly<Vector3Like>, b: Readonly<Vector3Like>): number;
+/**
+ * Returns the distance (squared) between two Vector3Like objects.
+ *
+ * This avoids Math.sqrt for better performance.
+ **/
+export declare function getVector3DistanceSquared(a: Readonly<Vector3Like>, b: Readonly<Vector3Like>): number;
+/**
+ * If the current Vector3Like object and the one specified as the parameter are unit
+ * vertices, this method returns the cosine of the angle between the two vertices.
+ * Unit vertices are vertices that point to the same direction but their length is
+ * one. They remove the length of the vector as a factor in the result. You can use
+ * the `normalize()` method to convert a vector to a unit vector.
+ **/
+export declare function getVector3Dot(a: Readonly<Vector3Like>, b: Readonly<Vector3Like>): number;
+/**
+ * The length, magnitude, of the current Vector3Like object from the origin (0,0,0) to
+ * the object's x, y, and z coordinates. The `w` property is ignored. A unit vector has
+ * a length or magnitude of one.
+ **/
+export declare function getVector3Length(source: Readonly<Vector3Like>): number;
+/**
+ * The square of the length of the current Vector3Like object, calculated using the `x`,
+ * `y`, and `z` properties. The `w` property is ignored. Use the `lengthSquared()`
+ * method whenever possible instead of the slower `Math.sqrt()` method call of the
+ * `Vector3Like.length()` method.
+ **/
+export declare function getVector3LengthSquared(source: Readonly<Vector3Like>): number;
+/**
+ * Reads the spherical coordinates (radius, theta, phi) from a Vector3Like. Uses the same
+ * convention as `setVector3FromSpherical` / `createVector3FromSpherical`:
+ * - `theta` is the polar angle from the +Y axis (0 = north pole, π = south pole).
+ * - `phi` is the azimuthal angle from the +X axis in the XZ plane.
+ *
+ * Writes to `out` as (x=radius, y=theta, z=phi).
+ */
+export declare function getVector3Spherical(out: Vector3Like, source: Readonly<Vector3Like>): void;
+/**
+ * Linear interpolation between two Vector3Like objects at parameter `t` in [0, 1].
+ * `t=0` returns `a`; `t=1` returns `b`.
+ *
+ * Safe when `out` aliases `a` or `b` (all inputs are read into locals first).
+ */
+export declare function interpolateVector3(out: Vector3Like, a: Readonly<Vector3Like>, b: Readonly<Vector3Like>, t: number): void;
+/**
+ * Writes the per-component maximum of two vectors.
+ *
+ * Safe when `out` aliases `a` or `b`.
+ */
+export declare function maxVector3(out: Vector3Like, a: Readonly<Vector3Like>, b: Readonly<Vector3Like>): void;
+/**
+ * Writes the per-component minimum of two vectors.
+ *
+ * Safe when `out` aliases `a` or `b`.
+ */
+export declare function minVector3(out: Vector3Like, a: Readonly<Vector3Like>, b: Readonly<Vector3Like>): void;
+/**
+ * Component-wise product of two vectors (Hadamard product).
+ *
+ * Safe when `out` aliases `a` or `b`.
+ */
+export declare function multiplyVector3(out: Vector3Like, a: Readonly<Vector3Like>, b: Readonly<Vector3Like>): void;
+/**
+ * Compares the elements of the current Vector3Like object with the elements of a
+ * specified Vector3Like object to determine whether they are nearly equal.
+ *
+ * The two Vector3Like objects are nearly equal if the value of all the elements of the two
+ * vertices are equal, or the result of the comparison is within the tolerance range.
+ **/
+export declare function nearEqualsVector3(a: Readonly<Vector3Like>, b: Readonly<Vector3Like>, tolerance?: number): boolean;
+/**
+ * Sets the current Vector3Like object to its inverse. The inverse object is also
+ * considered the opposite of the original object. The value of the `x`, `y`, and `z`
+ * properties of the current Vector3Like object is changed to -x, -y, and -z.
+ **/
+export declare function negateVector3(out: Vector3Like, source: Readonly<Vector3Like>): void;
+/**
+ * Converts a Vector3Like object to a unit vector by dividing the first three elements
+ * (x, y, z) by the length of the vector.
+ *
+ * Returns the original length.
+ **/
+export declare function normalizeVector3(out: Vector3Like, source: Readonly<Vector3Like>): number;
+/**
+ * Offsets each component of the current Vector3Like object by a scalar per axis.
+ **/
+export declare function offsetVector3(out: Vector3Like, source: Readonly<Vector3Like>, dx: number, dy: number, dz: number): void;
+/**
+ * Divides the value of the `x` and `y` properties of the current Vector3Like
+ * object by the value of its `z` property.
+ **/
+export declare function projectVector3(out: Vector2Like, source: Readonly<Vector3Like>): void;
+/**
+ * Reflects an incident vector about a unit normal. The result is the reflection of
+ * `incident` across the plane whose normal is `normal`.
+ *
+ * Formula: out = incident - 2 * dot(incident, normal) * normal
+ *
+ * Safe when `out` aliases `incident` or `normal`.
+ */
+export declare function reflectVector3(out: Vector3Like, incident: Readonly<Vector3Like>, normal: Readonly<Vector3Like>): void;
+/**
+ * Scales the current Vector3Like object by a scalar, a magnitude. The Vector3Like object's
+ * x, y, and z elements are multiplied by the provided scalar number.
+ **/
+export declare function scaleVector3(out: Vector3Like, source: Readonly<Vector3Like>, scalar: number): void;
+/**
+ * Sets the members of Vector3Like to the specified values
+ **/
+export declare function setVector3(out: Vector3Like, x: number, y: number, z: number): void;
+/**
+ * Reads a Vector3Like from a Float32Array at a byte offset.
+ */
+export declare function setVector3FromFloat32Array(out: Vector3Like, offset: number, source: Readonly<Float32Array>): void;
+/**
+ * Writes a Vector3Like into spherical coordinates.
+ * Uses the physics convention: theta is polar angle from +Y, phi is azimuthal from +X in XZ.
+ */
+export declare function setVector3FromSpherical(out: Vector3Like, radius: number, theta: number, phi: number): void;
+/**
+ * Copies the x, y, and z components of a Vector4Like into a Vector3Like, dropping the w component.
+ * For perspective-correct results (when w ≠ 1) use projectVector4 instead, which performs the
+ * perspective divide.
+ *
+ * Safe when `out` aliases the same memory as `source`.
+ */
+export declare function setVector3FromVector4(out: Vector3Like, source: Readonly<Vector4Like>): void;
+/**
+ * Subtracts the value of the x, y, and z elements of the current Vector3Like object
+ * from the values of the x, y, and z elements of another Vector3Like object.
+ **/
+export declare function subtractVector3(out: Vector3Like, source: Readonly<Vector3Like>, other: Readonly<Vector3Like>): void;
+/**
+ * Transforms a Vector3Like by a Matrix3 (column-major, row-major storage).
+ * Useful for transforming normals by a normal matrix.
+ *
+ * Safe when `out` aliases `source`.
+ */
+export declare function transformVector3ByMatrix3(out: Vector3Like, source: Readonly<Vector3Like>, matrix: Readonly<{
+    m: Readonly<Float32Array>;
+}>): void;
+/**
+ * Writes a Vector3Like into a Float32Array at a byte offset.
+ */
+export declare function writeVector3ToFloat32Array(out: Float32Array, offset: number, source: Readonly<Vector3Like>): void;
+export declare const VECTOR3_X_AXIS: Readonly<Vector3>;
+export declare const VECTOR3_Y_AXIS: Readonly<Vector3>;
+export declare const VECTOR3_Z_AXIS: Readonly<Vector3>;
+//# sourceMappingURL=vector3.d.ts.map

package/dist/vector3.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector3.d.ts","sourceRoot":"","sources":["../src/vector3.ts"],"names":[],"mappings":"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"}

package/dist/vector3.js

@@ -0,0 +1,380 @@
+import { createEntity } from '@flighthq/entity';
+/**
+ * Adds the x, y and z components of two vector objects
+ * and writes to out.
+ */
+export function addVector3(out, a, b) {
+    out.x = a.x + b.x;
+    out.y = a.y + b.y;
+    out.z = a.z + b.z;
+}
+/**
+ * Clamps each component of a Vector3Like independently to [min, max].
+ *
+ * Safe when `out` aliases `value`, `min`, or `max`.
+ */
+export function clampVector3(out, value, min, max) {
+    const vx = value.x, vy = value.y, vz = value.z;
+    const minX = min.x, minY = min.y, minZ = min.z;
+    const maxX = max.x, maxY = max.y, maxZ = max.z;
+    out.x = vx < minX ? minX : vx > maxX ? maxX : vx;
+    out.y = vy < minY ? minY : vy > maxY ? maxY : vy;
+    out.z = vz < minZ ? minZ : vz > maxZ ? maxZ : vz;
+}
+export function cloneVector3(source) {
+    return createVector3(source.x, source.y, source.z);
+}
+/**
+ * Copies the x, y and z components of a vector.
+ */
+export function copyVector3(out, source) {
+    out.x = source.x;
+    out.y = source.y;
+    out.z = source.z;
+}
+/**
+ * The Vector3Like class represents a point or a location in the three-dimensional space using
+ * the Cartesian coordinates x, y, and z. As in a two-dimensional space, the `x` property
+ * represents the horizontal axis and the `y` property represents the vertical axis. In
+ * three-dimensional space, the `z` property represents depth. The value of the `x` property increases as the object moves to the right. The value of the `y` property
+ * increases as the object moves down. The `z` property increases as the object moves
+ * farther from the point of view. Using perspective projection and scaling, the object is
+ * seen to be bigger when near and smaller when farther away from the screen. As in a
+ * right-handed three-dimensional coordinate system, the positive z-axis points away from
+ * the viewer and the value of the `z` property increases as the object moves away from the
+ * viewer's eye. The origin point (0,0,0) of the global space is the upper-left corner of
+ * the stage.
+ *
+ * Invariants:
+ *
+ * - `X_AXIS = new Vector3Like(1, 0, 0);`
+ * - `Y_AXIS = new Vector3Like(0, 1, 0);`
+ * - `Z_AXIS = new Vector3Like(0, 0, 1);`
+ * - `length = Math.sqrt(x ** 2 + y ** 2 + z ** 2);`
+ * - `lengthSquared = x ** 2 + y ** 2 + z ** 2;`
+ */
+export function createVector3(x, y, z) {
+    return createEntity({ x: x ?? 0, y: y ?? 0, z: z ?? 0 });
+}
+/**
+ * Creates a Vector3 from spherical coordinates (physics convention: radius, inclination θ from
+ * +Y axis, azimuth φ from +X axis in the XZ plane).
+ *
+ * - `theta` is the polar angle measured from the +Y axis (0 = north pole, π = south pole).
+ * - `phi` is the azimuthal angle measured from the +X axis in the XZ plane.
+ */
+export function createVector3FromSpherical(radius, theta, phi) {
+    const out = createVector3();
+    setVector3FromSpherical(out, radius, theta, phi);
+    return out;
+}
+/**
+ * Writes a Vector3Like object that is perpendicular (at a right angle) to the
+ * current Vector3Like and another Vector3Like object. If the returned Vector3Like object's
+ * coordinates are (0,0,0), then the two Vector3Like objects are parallel to each other.
+ **/
+export function crossVector3(out, source, other) {
+    const x = source.y * other.z - source.z * other.y;
+    const y = source.z * other.x - source.x * other.z;
+    const z = source.x * other.y - source.y * other.x;
+    out.x = x;
+    out.y = y;
+    out.z = z;
+}
+/**
+ * Component-wise division of two vectors (Hadamard division). Each component of
+ * `source` is divided by the corresponding component of `divisor`. Components with a
+ * zero divisor produce `0` in the output.
+ *
+ * Safe when `out` aliases `source` or `divisor`.
+ */
+export function divideVector3(out, source, divisor) {
+    const sx = source.x, sy = source.y, sz = source.z;
+    const dx = divisor.x, dy = divisor.y, dz = divisor.z;
+    out.x = dx !== 0 ? sx / dx : 0;
+    out.y = dy !== 0 ? sy / dy : 0;
+    out.z = dz !== 0 ? sz / dz : 0;
+}
+export function equalsVector3(a, b) {
+    if (!a || !b)
+        return false;
+    return a.x === b.x && a.y === b.y && a.z === b.z;
+}
+/**
+ * Returns the angle in radians between two vectors. The returned angle is the
+ * smallest radian the first Vector3Like object rotates until it aligns with the
+ * second Vector3Like object.
+ **/
+export function getVector3AngleBetween(a, b) {
+    const la = getVector3Length(a);
+    const lb = getVector3Length(b);
+    if (la === 0 || lb === 0)
+        return NaN; // undefined angle
+    const _dot = getVector3Dot(a, b) / (la * lb);
+    // clamp dot to [-1, 1] to avoid floating point errors
+    return Math.acos(Math.min(1, Math.max(-1, _dot)));
+}
+/**
+ * Returns the distance between two Vector3Like objects.
+ **/
+export function getVector3Distance(a, b) {
+    const x = b.x - a.x;
+    const y = b.y - a.y;
+    const z = b.z - a.z;
+    return Math.sqrt(x ** 2 + y ** 2 + z ** 2);
+}
+/**
+ * Returns the distance (squared) between two Vector3Like objects.
+ *
+ * This avoids Math.sqrt for better performance.
+ **/
+export function getVector3DistanceSquared(a, b) {
+    const x = b.x - a.x;
+    const y = b.y - a.y;
+    const z = b.z - a.z;
+    return x ** 2 + y ** 2 + z ** 2;
+}
+/**
+ * If the current Vector3Like object and the one specified as the parameter are unit
+ * vertices, this method returns the cosine of the angle between the two vertices.
+ * Unit vertices are vertices that point to the same direction but their length is
+ * one. They remove the length of the vector as a factor in the result. You can use
+ * the `normalize()` method to convert a vector to a unit vector.
+ **/
+export function getVector3Dot(a, b) {
+    return a.x * b.x + a.y * b.y + a.z * b.z;
+}
+/**
+ * The length, magnitude, of the current Vector3Like object from the origin (0,0,0) to
+ * the object's x, y, and z coordinates. The `w` property is ignored. A unit vector has
+ * a length or magnitude of one.
+ **/
+export function getVector3Length(source) {
+    return Math.sqrt(source.x ** 2 + source.y ** 2 + source.z ** 2);
+}
+/**
+ * The square of the length of the current Vector3Like object, calculated using the `x`,
+ * `y`, and `z` properties. The `w` property is ignored. Use the `lengthSquared()`
+ * method whenever possible instead of the slower `Math.sqrt()` method call of the
+ * `Vector3Like.length()` method.
+ **/
+export function getVector3LengthSquared(source) {
+    return source.x ** 2 + source.y ** 2 + source.z ** 2;
+}
+/**
+ * Reads the spherical coordinates (radius, theta, phi) from a Vector3Like. Uses the same
+ * convention as `setVector3FromSpherical` / `createVector3FromSpherical`:
+ * - `theta` is the polar angle from the +Y axis (0 = north pole, π = south pole).
+ * - `phi` is the azimuthal angle from the +X axis in the XZ plane.
+ *
+ * Writes to `out` as (x=radius, y=theta, z=phi).
+ */
+export function getVector3Spherical(out, source) {
+    const x = source.x, y = source.y, z = source.z;
+    const radius = Math.sqrt(x * x + y * y + z * z);
+    if (radius === 0) {
+        out.x = 0;
+        out.y = 0;
+        out.z = 0;
+        return;
+    }
+    out.x = radius;
+    out.y = Math.acos(Math.min(1, Math.max(-1, y / radius)));
+    out.z = Math.atan2(z, x);
+}
+/**
+ * Linear interpolation between two Vector3Like objects at parameter `t` in [0, 1].
+ * `t=0` returns `a`; `t=1` returns `b`.
+ *
+ * Safe when `out` aliases `a` or `b` (all inputs are read into locals first).
+ */
+export function interpolateVector3(out, a, b, t) {
+    const ax = a.x, ay = a.y, az = a.z;
+    out.x = ax + t * (b.x - ax);
+    out.y = ay + t * (b.y - ay);
+    out.z = az + t * (b.z - az);
+}
+/**
+ * Writes the per-component maximum of two vectors.
+ *
+ * Safe when `out` aliases `a` or `b`.
+ */
+export function maxVector3(out, a, b) {
+    out.x = a.x > b.x ? a.x : b.x;
+    out.y = a.y > b.y ? a.y : b.y;
+    out.z = a.z > b.z ? a.z : b.z;
+}
+/**
+ * Writes the per-component minimum of two vectors.
+ *
+ * Safe when `out` aliases `a` or `b`.
+ */
+export function minVector3(out, a, b) {
+    out.x = a.x < b.x ? a.x : b.x;
+    out.y = a.y < b.y ? a.y : b.y;
+    out.z = a.z < b.z ? a.z : b.z;
+}
+/**
+ * Component-wise product of two vectors (Hadamard product).
+ *
+ * Safe when `out` aliases `a` or `b`.
+ */
+export function multiplyVector3(out, a, b) {
+    out.x = a.x * b.x;
+    out.y = a.y * b.y;
+    out.z = a.z * b.z;
+}
+/**
+ * Compares the elements of the current Vector3Like object with the elements of a
+ * specified Vector3Like object to determine whether they are nearly equal.
+ *
+ * The two Vector3Like objects are nearly equal if the value of all the elements of the two
+ * vertices are equal, or the result of the comparison is within the tolerance range.
+ **/
+export function nearEqualsVector3(a, b, tolerance = 1e-6) {
+    return Math.abs(a.x - b.x) < tolerance && Math.abs(a.y - b.y) < tolerance && Math.abs(a.z - b.z) < tolerance;
+}
+/**
+ * Sets the current Vector3Like object to its inverse. The inverse object is also
+ * considered the opposite of the original object. The value of the `x`, `y`, and `z`
+ * properties of the current Vector3Like object is changed to -x, -y, and -z.
+ **/
+export function negateVector3(out, source) {
+    out.x = source.x * -1;
+    out.y = source.y * -1;
+    out.z = source.z * -1;
+}
+/**
+ * Converts a Vector3Like object to a unit vector by dividing the first three elements
+ * (x, y, z) by the length of the vector.
+ *
+ * Returns the original length.
+ **/
+export function normalizeVector3(out, source) {
+    const l = getVector3Length(source);
+    if (l !== 0) {
+        out.x = source.x / l;
+        out.y = source.y / l;
+        out.z = source.z / l;
+    }
+    else {
+        out.x = 0;
+        out.y = 0;
+        out.z = 0;
+    }
+    return l;
+}
+/**
+ * Offsets each component of the current Vector3Like object by a scalar per axis.
+ **/
+export function offsetVector3(out, source, dx, dy, dz) {
+    out.x = source.x + dx;
+    out.y = source.y + dy;
+    out.z = source.z + dz;
+}
+/**
+ * Divides the value of the `x` and `y` properties of the current Vector3Like
+ * object by the value of its `z` property.
+ **/
+export function projectVector3(out, source) {
+    out.x = source.x / source.z;
+    out.y = source.y / source.z;
+}
+/**
+ * Reflects an incident vector about a unit normal. The result is the reflection of
+ * `incident` across the plane whose normal is `normal`.
+ *
+ * Formula: out = incident - 2 * dot(incident, normal) * normal
+ *
+ * Safe when `out` aliases `incident` or `normal`.
+ */
+export function reflectVector3(out, incident, normal) {
+    const ix = incident.x, iy = incident.y, iz = incident.z;
+    const nx = normal.x, ny = normal.y, nz = normal.z;
+    const twoDot = 2 * (ix * nx + iy * ny + iz * nz);
+    out.x = ix - twoDot * nx;
+    out.y = iy - twoDot * ny;
+    out.z = iz - twoDot * nz;
+}
+/**
+ * Scales the current Vector3Like object by a scalar, a magnitude. The Vector3Like object's
+ * x, y, and z elements are multiplied by the provided scalar number.
+ **/
+export function scaleVector3(out, source, scalar) {
+    out.x = source.x * scalar;
+    out.y = source.y * scalar;
+    out.z = source.z * scalar;
+}
+/**
+ * Sets the members of Vector3Like to the specified values
+ **/
+export function setVector3(out, x, y, z) {
+    out.x = x;
+    out.y = y;
+    out.z = z;
+}
+/**
+ * Reads a Vector3Like from a Float32Array at a byte offset.
+ */
+export function setVector3FromFloat32Array(out, offset, source) {
+    out.x = source[offset];
+    out.y = source[offset + 1];
+    out.z = source[offset + 2];
+}
+/**
+ * Writes a Vector3Like into spherical coordinates.
+ * Uses the physics convention: theta is polar angle from +Y, phi is azimuthal from +X in XZ.
+ */
+export function setVector3FromSpherical(out, radius, theta, phi) {
+    const sinTheta = Math.sin(theta);
+    out.x = radius * sinTheta * Math.cos(phi);
+    out.y = radius * Math.cos(theta);
+    out.z = radius * sinTheta * Math.sin(phi);
+}
+/**
+ * Copies the x, y, and z components of a Vector4Like into a Vector3Like, dropping the w component.
+ * For perspective-correct results (when w ≠ 1) use projectVector4 instead, which performs the
+ * perspective divide.
+ *
+ * Safe when `out` aliases the same memory as `source`.
+ */
+export function setVector3FromVector4(out, source) {
+    const x = source.x, y = source.y, z = source.z;
+    out.x = x;
+    out.y = y;
+    out.z = z;
+}
+/**
+ * Subtracts the value of the x, y, and z elements of the current Vector3Like object
+ * from the values of the x, y, and z elements of another Vector3Like object.
+ **/
+export function subtractVector3(out, source, other) {
+    out.x = source.x - other.x;
+    out.y = source.y - other.y;
+    out.z = source.z - other.z;
+}
+/**
+ * Transforms a Vector3Like by a Matrix3 (column-major, row-major storage).
+ * Useful for transforming normals by a normal matrix.
+ *
+ * Safe when `out` aliases `source`.
+ */
+export function transformVector3ByMatrix3(out, source, matrix) {
+    const m = matrix.m;
+    const x = source.x, y = source.y, z = source.z;
+    out.x = m[0] * x + m[1] * y + m[2] * z;
+    out.y = m[3] * x + m[4] * y + m[5] * z;
+    out.z = m[6] * x + m[7] * y + m[8] * z;
+}
+/**
+ * Writes a Vector3Like into a Float32Array at a byte offset.
+ */
+export function writeVector3ToFloat32Array(out, offset, source) {
+    out[offset] = source.x;
+    out[offset + 1] = source.y;
+    out[offset + 2] = source.z;
+}
+export const VECTOR3_X_AXIS = createVector3(1, 0, 0);
+export const VECTOR3_Y_AXIS = createVector3(0, 1, 0);
+export const VECTOR3_Z_AXIS = createVector3(0, 0, 1);
+//# sourceMappingURL=vector3.js.map

package/dist/vector3.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector3.js","sourceRoot":"","sources":["../src/vector3.ts"],"names":[],"mappings":"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"}

package/dist/vector3Pool.d.ts

@@ -0,0 +1,6 @@
+import type { Vector3 } from '@flighthq/types';
+export declare function acquireEmptyVector3(): Vector3;
+export declare function acquireVector3(): Vector3;
+export declare function clearVector3Pool(): void;
+export declare function releaseVector3(v: Vector3): void;
+//# sourceMappingURL=vector3Pool.d.ts.map

package/dist/vector3Pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector3Pool.d.ts","sourceRoot":"","sources":["../src/vector3Pool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAI/C,wBAAgB,mBAAmB,IAAI,OAAO,CAM7C;AAED,wBAAgB,cAAc,IAAI,OAAO,CAUxC;AAED,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC;AAED,wBAAgB,cAAc,CAAC,CAAC,EAAE,OAAO,GAAG,IAAI,CAG/C"}

package/dist/vector3Pool.js

@@ -0,0 +1,28 @@
+import { createVector3 } from './vector3';
+export function acquireEmptyVector3() {
+    const v = acquireVector3();
+    v.x = 0;
+    v.y = 0;
+    v.z = 0;
+    return v;
+}
+export function acquireVector3() {
+    let v;
+    if (pool.length > 0) {
+        v = pool.pop();
+    }
+    else {
+        v = createVector3();
+    }
+    return v;
+}
+export function clearVector3Pool() {
+    pool.length = 0;
+}
+export function releaseVector3(v) {
+    if (!v)
+        return;
+    pool.push(v);
+}
+const pool = [];
+//# sourceMappingURL=vector3Pool.js.map