@forgeax/engine-math 0.0.0-dev.8d955ade1c79

package/dist/euler.d.ts

@@ -0,0 +1,51 @@
+import type { Euler, EulerOrder, Mat3Like, Quat, QuatLike } from './types';
+export type { Euler, EulerOrder };
+/** Create an Euler, defaulting to (0, 0, 0, 'XYZ'). */
+export declare function create(): Euler;
+/** Allocate a new Euler copy. */
+export declare function clone(a: Euler): Euler;
+/** out.x/y/z/order = inputs; returns out (in-place). */
+export declare function set(out: Euler, x: number, y: number, z: number, order: EulerOrder): Euler;
+/**
+ * out (Quat) = quaternion from euler. Returns out.
+ *
+ * Routes directly to quat.fromEuler (D-P2 + 6-order coverage already implemented inside quat).
+ *
+ * @example
+ * ```ts
+ * euler.toQuat(quatBuf, eulerInstance);
+ * ```
+ */
+export declare function toQuat(out: Quat, e: Euler): Quat;
+/**
+ * out (Euler) = euler angles from quaternion in given order. Returns out.
+ *
+ * Implementation path: quat → 3x3 column-major rotation matrix → fromRotationMatrix(order).
+ * This concentrates the 6-order formulas in fromRotationMatrix and avoids dual maintenance.
+ *
+ * @degrade gimbal lock (pitch ≈ ±π/2, sin/cos critical) → set yaw to 0 and let roll absorb the
+ *          full rotation (registry #16; same equivalent-branch semantics as Three.js; no throw).
+ *
+ * @example
+ * ```ts
+ * euler.fromQuat(out, q, 'XYZ');
+ * ```
+ */
+export declare function fromQuat(out: Euler, q: QuatLike, order: EulerOrder): Euler;
+/**
+ * out (Euler) = euler from a 3x3 rotation matrix m (column-major, length 9) in `order`. Returns out.
+ *
+ * Uses the Three.js Euler.setFromRotationMatrix formulas (intrinsic rotation + Hamilton convention).
+ * Each of the 6 orders has an analytic formula; near gimbal-lock (middle axis sin/cos near ±1)
+ * an equivalent branch is selected.
+ *
+ * @degrade gimbal lock → middle axis is fixed at ±π/2; the remaining two axes degenerate
+ * (one is set to 0; the other absorbs the rotation).
+ *
+ * @example
+ * ```ts
+ * euler.fromRotationMatrix(out, mat3InstanceColumnMajor, 'XYZ');
+ * ```
+ */
+export declare function fromRotationMatrix(out: Euler, m: Mat3Like, order: EulerOrder): Euler;
+//# sourceMappingURL=euler.d.ts.map

package/dist/euler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"euler.d.ts","sourceRoot":"","sources":["../src/euler.ts"],"names":[],"mappings":"AA4BA,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAE3E,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;AAElC,uDAAuD;AACvD,wBAAgB,MAAM,IAAI,KAAK,CAE9B;AAED,iCAAiC;AACjC,wBAAgB,KAAK,CAAC,CAAC,EAAE,KAAK,GAAG,KAAK,CAErC;AAED,wDAAwD;AACxD,wBAAgB,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,KAAK,CAMzF;AAED;;;;;;;;;GASG;AACH,wBAAgB,MAAM,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,GAAG,IAAI,CAEhD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,GAAG,KAAK,CAiC1E;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,GAAG,KAAK,CAmGpF"}

package/dist/f32-to-f16-bytes.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Convert a packed float32 RGBA byte buffer into the equivalent float16 RGBA
+ * byte buffer (IEEE 754 binary16, little-endian). The output length is
+ * `src.byteLength / 2`.
+ *
+ * @param src A Uint8Array whose underlying buffer is an interleaved Float32Array.
+ * @returns A Uint8Array of packed binary16 pixels, exactly half the length.
+ */
+export declare function f32ToF16Bytes(src: Uint8Array): Uint8Array;
+//# sourceMappingURL=f32-to-f16-bytes.d.ts.map

package/dist/f32-to-f16-bytes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"f32-to-f16-bytes.d.ts","sourceRoot":"","sources":["../src/f32-to-f16-bytes.ts"],"names":[],"mappings":"AAeA;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,UAAU,GAAG,UAAU,CA+CzD"}

package/dist/frustum.d.ts

@@ -0,0 +1,49 @@
+import type { Box3Like } from './box3';
+import type { Mat4Like, Vec3Like } from './types';
+/**
+ * Frustum storage: Float32Array(24) — 6 planes × 4 floats each (nx, ny, nz, d).
+ * Local brand (not part of the seven-piece SSOT; same rationale as Box3).
+ */
+export type Frustum = Float32Array & {
+    readonly __frustum: void;
+};
+/** Allocate a new Frustum (zero-initialized 6 planes). */
+export declare function create(): Frustum;
+/**
+ * Extract 6 frustum planes (left, right, bottom, top, near, far) from a
+ * combined view-projection matrix (column-major, right-handed).
+ *
+ * Uses Gribb/Hartmann method: each plane = sum or difference of VP rows,
+ * then normalized so (nx, ny, nz) is a unit vector and d is the signed
+ * distance from origin. Plane inside-half-space is nx*x + ny*y + nz*z + d > 0.
+ *
+ * Writes to `out` and returns it.
+ *
+ * @example
+ * ```ts
+ * const view = mat4.lookAt(mat4.create(), [0, 0, 5], [0, 0, 0], [0, 1, 0]);
+ * const proj = mat4.perspective(mat4.create(), Math.PI / 2, 1, 0.1, 100);
+ * const vp = mat4.create();
+ * mat4.multiply(vp, proj, view);
+ * const f = frustum.fromViewProjection(frustum.create(), vp);
+ * ```
+ */
+export declare function fromViewProjection(out: Frustum, vp: Mat4Like): Frustum;
+/**
+ * Test whether an AABB intersects the frustum. Conservative: returns `true` when
+ * the box straddles a plane boundary, even if partially outside.
+ *
+ * For each plane, the signed distance of both the positive-most corner (p-vertex)
+ * and negative-most corner (n-vertex) are tested. The box is outside only when
+ * the p-vertex is on the negative side of any plane.
+ */
+export declare function intersectsBox(f: Frustum, box: Box3Like): boolean;
+/**
+ * Test whether a sphere intersects the frustum. Conservative: returns `true`
+ * when the sphere straddles a plane boundary.
+ *
+ * Computes signed distance from the sphere center to each plane;
+ * outside when distance < -radius.
+ */
+export declare function intersectsSphere(f: Frustum, center: Vec3Like, radius: number): boolean;
+//# sourceMappingURL=frustum.d.ts.map

package/dist/frustum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frustum.d.ts","sourceRoot":"","sources":["../src/frustum.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AACvC,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAElD;;;GAGG;AACH,MAAM,MAAM,OAAO,GAAG,YAAY,GAAG;IAAE,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAA;CAAE,CAAC;AAElE,0DAA0D;AAC1D,wBAAgB,MAAM,IAAI,OAAO,CAEhC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,QAAQ,GAAG,OAAO,CA+HtE;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CA2BhE;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAkBtF"}

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+export type { Color, ColorLike, Euler, EulerOrder, Mat3, Mat3Like, Mat4, Mat4Like, Quat, QuatLike, Vec2, Vec2Like, Vec3, Vec3Like, Vec4, Vec4Like, } from './types';
+export * as box2 from './box2';
+export * as box3 from './box3';
+export * as circle2 from './circle2';
+export * as color from './color';
+export * as easing from './easing';
+export * as euler from './euler';
+export * as halfFloat from './f32-to-f16-bytes';
+export * as frustum from './frustum';
+export * as mat3 from './mat3';
+export * as mat4 from './mat4';
+export * as noise from './noise';
+export * as quat from './quat';
+export * as ray from './ray';
+export * as ray2 from './ray2';
+export * as sphere from './sphere';
+export * as vec2 from './vec2';
+export * as vec3 from './vec3';
+export * as vec4 from './vec4';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAkBA,YAAY,EACV,KAAK,EACL,SAAS,EACT,KAAK,EACL,UAAU,EACV,IAAI,EACJ,QAAQ,EACR,IAAI,EACJ,QAAQ,EACR,IAAI,EACJ,QAAQ,EACR,IAAI,EACJ,QAAQ,EACR,IAAI,EACJ,QAAQ,EACR,IAAI,EACJ,QAAQ,GACT,MAAM,SAAS,CAAC;AAYjB,OAAO,KAAK,IAAI,MAAM,QAAQ,CAAC;AAC/B,OAAO,KAAK,IAAI,MAAM,QAAQ,CAAC;AAC/B,OAAO,KAAK,OAAO,MAAM,WAAW,CAAC;AACrC,OAAO,KAAK,KAAK,MAAM,SAAS,CAAC;AACjC,OAAO,KAAK,MAAM,MAAM,UAAU,CAAC;AACnC,OAAO,KAAK,KAAK,MAAM,SAAS,CAAC;AACjC,OAAO,KAAK,SAAS,MAAM,oBAAoB,CAAC;AAChD,OAAO,KAAK,OAAO,MAAM,WAAW,CAAC;AACrC,OAAO,KAAK,IAAI,MAAM,QAAQ,CAAC;AAC/B,OAAO,KAAK,IAAI,MAAM,QAAQ,CAAC;AAC/B,OAAO,KAAK,KAAK,MAAM,SAAS,CAAC;AACjC,OAAO,KAAK,IAAI,MAAM,QAAQ,CAAC;AAC/B,OAAO,KAAK,GAAG,MAAM,OAAO,CAAC;AAC7B,OAAO,KAAK,IAAI,MAAM,QAAQ,CAAC;AAC/B,OAAO,KAAK,MAAM,MAAM,UAAU,CAAC;AACnC,OAAO,KAAK,IAAI,MAAM,QAAQ,CAAC;AAC/B,OAAO,KAAK,IAAI,MAAM,QAAQ,CAAC;AAC/B,OAAO,KAAK,IAAI,MAAM,QAAQ,CAAC"}