@pawells/math-extended 1.1.1 → 3.0.0

package/build/vectors/predefined.d.ts

@@ -2,7 +2,7 @@
  * Predefined vector factory functions for common mathematical operations.
  * Provides convenient constructors for standard vectors used in graphics, physics, and mathematics.
  */
-import { TVector, TVector2, TVector3, TVector4 } from './types.js';
+import type { TVector, TVector2, TVector3, TVector4 } from './types.js';
 type TVectorSize3 = 3;
 type TVectorSize4 = 4;
 /**
@@ -14,9 +14,11 @@ type TVectorSize4 = 4;
  * @returns A vector with all components set to 0
  *
  * @example
- * const origin2D = VectorZero(2); // [0, 0]
- * const origin3D = VectorZero(3); // [0, 0, 0]
- * const origin4D = VectorZero(4); // [0, 0, 0, 0]
+     * ```typescript
+     * const origin2D = VectorZero(2); // [0, 0]
+     * const origin3D = VectorZero(3); // [0, 0, 0]
+     * const origin4D = VectorZero(4); // [0, 0, 0, 0]
+     * ```
  */
 export declare function VectorZero(size: 1): TVector;
 export declare function VectorZero(size: 2): TVector2;
@@ -31,9 +33,11 @@ export declare function VectorZero(size: TVectorSize4): TVector4;
  * @returns A vector with all components set to 1
  *
  * @example
- * const ones2D = VectorOne(2); // [1, 1]
- * const ones3D = VectorOne(3); // [1, 1, 1]
- * const ones4D = VectorOne(4); // [1, 1, 1, 1]
+     * ```typescript
+     * const ones2D = VectorOne(2); // [1, 1]
+     * const ones3D = VectorOne(3); // [1, 1, 1]
+     * const ones4D = VectorOne(4); // [1, 1, 1, 1]
+     * ```
  */
 export declare function VectorOne(size: 1): TVector;
 export declare function VectorOne(size: 2): TVector2;
@@ -47,8 +51,10 @@ export declare function VectorOne(size: TVectorSize4): TVector4;
  * @returns [0, 1] - Unit vector in positive Y direction
  *
  * @example
- * const upDirection = Vector2_Up(); // Character movement upward
- * const velocity = Vector2_Up().map(c => c * speed); // Moving up at given speed
+     * ```typescript
+     * const upDirection = Vector2Up(); // Character movement upward
+     * const velocity = Vector2Up().map(c => c * speed); // Moving up at given speed
+     * ```
  */
 export declare function Vector2Up(): TVector2;
 /**
@@ -58,8 +64,10 @@ export declare function Vector2Up(): TVector2;
  * @returns [0, 1, 0] - Unit vector in positive Y direction
  *
  * @example
- * const worldUp = Vector3_Up(); // World space up direction
- * const jumpForce = Vector3_Up().map(c => c * jumpStrength);
+     * ```typescript
+     * const worldUp = Vector3Up(); // World space up direction
+     * const jumpForce = Vector3Up().map(c => c * jumpStrength);
+     * ```
  */
 export declare function Vector3Up(): TVector3;
 /**
@@ -67,6 +75,10 @@ export declare function Vector3Up(): TVector3;
  * Useful in homogeneous coordinates and 4D transformations.
  *
  * @returns [0, 1, 0, 0] - Unit vector in positive Y direction
+ * @example
+     * ```typescript
+     * const up4 = Vector4Up(); // [0, 1, 0, 0]
+     * ```
  */
 export declare function Vector4Up(): TVector4;
 /**
@@ -76,8 +88,10 @@ export declare function Vector4Up(): TVector4;
  * @returns [0, -1] - Unit vector in negative Y direction
  *
  * @example
- * const gravity = Vector2_Down().map(c => c * 9.81); // Gravity force
- * const dropDirection = Vector2_Down(); // Object falling down
+     * ```typescript
+     * const gravity = Vector2Down().map(c => c * 9.81); // Gravity force
+     * const dropDirection = Vector2Down(); // Object falling down
+     * ```
  */
 export declare function Vector2Down(): TVector2;
 /**
@@ -87,14 +101,20 @@ export declare function Vector2Down(): TVector2;
  * @returns [0, -1, 0] - Unit vector in negative Y direction
  *
  * @example
- * const gravityForce = Vector3Down().map(c => c * 9.81);
- * const downwardRay = Vector3Down(); // Raycast downward
+     * ```typescript
+     * const gravityForce = Vector3Down().map(c => c * 9.81);
+     * const downwardRay = Vector3Down(); // Raycast downward
+     * ```
  */
 export declare function Vector3Down(): TVector3;
 /**
  * Creates a 4D unit vector pointing downward (negative Y direction).
  *
  * @returns [0, -1, 0, 0] - Unit vector in negative Y direction
+ * @example
+     * ```typescript
+     * const down4 = Vector4Down(); // [0, -1, 0, 0]
+     * ```
  */
 export declare function Vector4Down(): TVector4;
 /**
@@ -104,8 +124,10 @@ export declare function Vector4Down(): TVector4;
  * @returns [-1, 0] - Unit vector in negative X direction
  *
  * @example
- * const leftMovement = Vector2Left().map(c => c * speed);
- * const leftDirection = Vector2Left(); // Character facing left
+     * ```typescript
+     * const leftMovement = Vector2Left().map(c => c * speed);
+     * const leftDirection = Vector2Left(); // Character facing left
+     * ```
  */
 export declare function Vector2Left(): TVector2;
 /**
@@ -115,13 +137,19 @@ export declare function Vector2Left(): TVector2;
  * @returns [-1, 0, 0] - Unit vector in negative X direction
  *
  * @example
- * const strafeLeft = Vector3Left().map(c => c * strafeSpeed);
+     * ```typescript
+     * const strafeLeft = Vector3Left().map(c => c * strafeSpeed);
+     * ```
  */
 export declare function Vector3Left(): TVector3;
 /**
  * Creates a 4D unit vector pointing left (negative X direction).
  *
  * @returns [-1, 0, 0, 0] - Unit vector in negative X direction
+ * @example
+     * ```typescript
+     * const left4 = Vector4Left(); // [-1, 0, 0, 0]
+     * ```
  */
 export declare function Vector4Left(): TVector4;
 /**
@@ -131,8 +159,10 @@ export declare function Vector4Left(): TVector4;
  * @returns [1, 0] - Unit vector in positive X direction
  *
  * @example
- * const rightMovement = Vector2Right().map(c => c * speed);
- * const rightDirection = Vector2Right(); // Character facing right
+     * ```typescript
+     * const rightMovement = Vector2Right().map(c => c * speed);
+     * const rightDirection = Vector2Right(); // Character facing right
+     * ```
  */
 export declare function Vector2Right(): TVector2;
 /**
@@ -142,13 +172,19 @@ export declare function Vector2Right(): TVector2;
  * @returns [1, 0, 0] - Unit vector in positive X direction
  *
  * @example
- * const strafeRight = Vector3Right().map(c => c * strafeSpeed);
+     * ```typescript
+     * const strafeRight = Vector3Right().map(c => c * strafeSpeed);
+     * ```
  */
 export declare function Vector3Right(): TVector3;
 /**
  * Creates a 4D unit vector pointing right (positive X direction).
  *
  * @returns [1, 0, 0, 0] - Unit vector in positive X direction
+ * @example
+     * ```typescript
+     * const right4 = Vector4Right(); // [1, 0, 0, 0]
+     * ```
  */
 export declare function Vector4Right(): TVector4;
 /**
@@ -159,14 +195,20 @@ export declare function Vector4Right(): TVector4;
  * @returns [0, 0, 1] - Unit vector in positive Z direction
  *
  * @example
- * const forwardMovement = Vector3Forward().map(c => c * speed);
- * const cameraForward = Vector3Forward(); // Camera looking direction
+     * ```typescript
+     * const forwardMovement = Vector3Forward().map(c => c * speed);
+     * const cameraForward = Vector3Forward(); // Camera looking direction
+     * ```
  */
 export declare function Vector3Forward(): TVector3;
 /**
  * Creates a 4D unit vector pointing forward (positive Z direction).
  *
  * @returns [0, 0, 1, 0] - Unit vector in positive Z direction
+ * @example
+     * ```typescript
+     * const forward4 = Vector4Forward(); // [0, 0, 1, 0]
+     * ```
  */
 export declare function Vector4Forward(): TVector4;
 /**
@@ -177,14 +219,20 @@ export declare function Vector4Forward(): TVector4;
  * @returns [0, 0, -1] - Unit vector in negative Z direction
  *
  * @example
- * const backwardMovement = Vector3Backward().map(c => c * speed);
- * const reverseDirection = Vector3Backward(); // Moving away from target
+     * ```typescript
+     * const backwardMovement = Vector3Backward().map(c => c * speed);
+     * const reverseDirection = Vector3Backward(); // Moving away from target
+     * ```
  */
 export declare function Vector3Backward(): TVector3;
 /**
  * Creates a 4D unit vector pointing backward (negative Z direction).
  *
  * @returns [0, 0, -1, 0] - Unit vector in negative Z direction
+ * @example
+     * ```typescript
+     * const backward4 = Vector4Backward(); // [0, 0, -1, 0]
+     * ```
  */
 export declare function Vector4Backward(): TVector4;
 export {};

package/build/vectors/predefined.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"predefined.d.ts","sourceRoot":"","sources":["../../src/vectors/predefined.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEnE,KAAK,YAAY,GAAG,CAAC,CAAC;AACtB,KAAK,YAAY,GAAG,CAAC,CAAC;AAEtB;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC;AAC7C,wBAAgB,UAAU,CAAC,IAAI,EAAE,CAAC,GAAG,QAAQ,CAAC;AAC9C,wBAAgB,UAAU,CAAC,IAAI,EAAE,YAAY,GAAG,QAAQ,CAAC;AACzD,wBAAgB,UAAU,CAAC,IAAI,EAAE,YAAY,GAAG,QAAQ,CAAC;AAKzD;;;;;;;;;;;;GAYG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC;AAC5C,wBAAgB,SAAS,CAAC,IAAI,EAAE,CAAC,GAAG,QAAQ,CAAC;AAC7C,wBAAgB,SAAS,CAAC,IAAI,EAAE,YAAY,GAAG,QAAQ,CAAC;AACxD,wBAAgB,SAAS,CAAC,IAAI,EAAE,YAAY,GAAG,QAAQ,CAAC;AAKxD;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,IAAI,QAAQ,CAEpC;AAED;;;;;;;;;GASG;AACH,wBAAgB,SAAS,IAAI,QAAQ,CAEpC;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,IAAI,QAAQ,CAEpC;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,IAAI,QAAQ,CAEtC;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,IAAI,QAAQ,CAEtC;AAED;;;;GAIG;AACH,wBAAgB,WAAW,IAAI,QAAQ,CAEtC;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,IAAI,QAAQ,CAEtC;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,IAAI,QAAQ,CAEtC;AAED;;;;GAIG;AACH,wBAAgB,WAAW,IAAI,QAAQ,CAEtC;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,IAAI,QAAQ,CAEvC;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,IAAI,QAAQ,CAEvC;AAED;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,QAAQ,CAEvC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,IAAI,QAAQ,CAEzC;AAED;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,QAAQ,CAEzC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,IAAI,QAAQ,CAE1C;AAED;;;;GAIG;AACH,wBAAgB,eAAe,IAAI,QAAQ,CAE1C"}
+{"version":3,"file":"predefined.d.ts","sourceRoot":"","sources":["../../src/vectors/predefined.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAExE,KAAK,YAAY,GAAG,CAAC,CAAC;AACtB,KAAK,YAAY,GAAG,CAAC,CAAC;AAEtB;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC;AAC7C,wBAAgB,UAAU,CAAC,IAAI,EAAE,CAAC,GAAG,QAAQ,CAAC;AAC9C,wBAAgB,UAAU,CAAC,IAAI,EAAE,YAAY,GAAG,QAAQ,CAAC;AACzD,wBAAgB,UAAU,CAAC,IAAI,EAAE,YAAY,GAAG,QAAQ,CAAC;AAKzD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC;AAC5C,wBAAgB,SAAS,CAAC,IAAI,EAAE,CAAC,GAAG,QAAQ,CAAC;AAC7C,wBAAgB,SAAS,CAAC,IAAI,EAAE,YAAY,GAAG,QAAQ,CAAC;AACxD,wBAAgB,SAAS,CAAC,IAAI,EAAE,YAAY,GAAG,QAAQ,CAAC;AAKxD;;;;;;;;;;;;GAYG;AACH,wBAAgB,SAAS,IAAI,QAAQ,CAEpC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,IAAI,QAAQ,CAEpC;AAED;;;;;;;;;GASG;AACH,wBAAgB,SAAS,IAAI,QAAQ,CAEpC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,IAAI,QAAQ,CAEtC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,IAAI,QAAQ,CAEtC;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,IAAI,QAAQ,CAEtC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,IAAI,QAAQ,CAEtC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,IAAI,QAAQ,CAEtC;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,IAAI,QAAQ,CAEtC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,IAAI,QAAQ,CAEvC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,IAAI,QAAQ,CAEvC;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,IAAI,QAAQ,CAEvC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,IAAI,QAAQ,CAEzC;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,IAAI,QAAQ,CAEzC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,IAAI,QAAQ,CAE1C;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,IAAI,QAAQ,CAE1C"}

package/build/vectors/predefined.js

@@ -16,8 +16,10 @@ export function VectorOne(size) {
  * @returns [0, 1] - Unit vector in positive Y direction
  *
  * @example
- * const upDirection = Vector2_Up(); // Character movement upward
- * const velocity = Vector2_Up().map(c => c * speed); // Moving up at given speed
+     * ```typescript
+     * const upDirection = Vector2Up(); // Character movement upward
+     * const velocity = Vector2Up().map(c => c * speed); // Moving up at given speed
+     * ```
  */
 export function Vector2Up() {
     return [0, 1];
@@ -29,8 +31,10 @@ export function Vector2Up() {
  * @returns [0, 1, 0] - Unit vector in positive Y direction
  *
  * @example
- * const worldUp = Vector3_Up(); // World space up direction
- * const jumpForce = Vector3_Up().map(c => c * jumpStrength);
+     * ```typescript
+     * const worldUp = Vector3Up(); // World space up direction
+     * const jumpForce = Vector3Up().map(c => c * jumpStrength);
+     * ```
  */
 export function Vector3Up() {
     return [0, 1, 0];
@@ -40,6 +44,10 @@ export function Vector3Up() {
  * Useful in homogeneous coordinates and 4D transformations.
  *
  * @returns [0, 1, 0, 0] - Unit vector in positive Y direction
+ * @example
+     * ```typescript
+     * const up4 = Vector4Up(); // [0, 1, 0, 0]
+     * ```
  */
 export function Vector4Up() {
     return [0, 1, 0, 0];
@@ -51,8 +59,10 @@ export function Vector4Up() {
  * @returns [0, -1] - Unit vector in negative Y direction
  *
  * @example
- * const gravity = Vector2_Down().map(c => c * 9.81); // Gravity force
- * const dropDirection = Vector2_Down(); // Object falling down
+     * ```typescript
+     * const gravity = Vector2Down().map(c => c * 9.81); // Gravity force
+     * const dropDirection = Vector2Down(); // Object falling down
+     * ```
  */
 export function Vector2Down() {
     return [0, -1];
@@ -64,8 +74,10 @@ export function Vector2Down() {
  * @returns [0, -1, 0] - Unit vector in negative Y direction
  *
  * @example
- * const gravityForce = Vector3Down().map(c => c * 9.81);
- * const downwardRay = Vector3Down(); // Raycast downward
+     * ```typescript
+     * const gravityForce = Vector3Down().map(c => c * 9.81);
+     * const downwardRay = Vector3Down(); // Raycast downward
+     * ```
  */
 export function Vector3Down() {
     return [0, -1, 0];
@@ -74,6 +86,10 @@ export function Vector3Down() {
  * Creates a 4D unit vector pointing downward (negative Y direction).
  *
  * @returns [0, -1, 0, 0] - Unit vector in negative Y direction
+ * @example
+     * ```typescript
+     * const down4 = Vector4Down(); // [0, -1, 0, 0]
+     * ```
  */
 export function Vector4Down() {
     return [0, -1, 0, 0];
@@ -85,8 +101,10 @@ export function Vector4Down() {
  * @returns [-1, 0] - Unit vector in negative X direction
  *
  * @example
- * const leftMovement = Vector2Left().map(c => c * speed);
- * const leftDirection = Vector2Left(); // Character facing left
+     * ```typescript
+     * const leftMovement = Vector2Left().map(c => c * speed);
+     * const leftDirection = Vector2Left(); // Character facing left
+     * ```
  */
 export function Vector2Left() {
     return [-1, 0];
@@ -98,7 +116,9 @@ export function Vector2Left() {
  * @returns [-1, 0, 0] - Unit vector in negative X direction
  *
  * @example
- * const strafeLeft = Vector3Left().map(c => c * strafeSpeed);
+     * ```typescript
+     * const strafeLeft = Vector3Left().map(c => c * strafeSpeed);
+     * ```
  */
 export function Vector3Left() {
     return [-1, 0, 0];
@@ -107,6 +127,10 @@ export function Vector3Left() {
  * Creates a 4D unit vector pointing left (negative X direction).
  *
  * @returns [-1, 0, 0, 0] - Unit vector in negative X direction
+ * @example
+     * ```typescript
+     * const left4 = Vector4Left(); // [-1, 0, 0, 0]
+     * ```
  */
 export function Vector4Left() {
     return [-1, 0, 0, 0];
@@ -118,8 +142,10 @@ export function Vector4Left() {
  * @returns [1, 0] - Unit vector in positive X direction
  *
  * @example
- * const rightMovement = Vector2Right().map(c => c * speed);
- * const rightDirection = Vector2Right(); // Character facing right
+     * ```typescript
+     * const rightMovement = Vector2Right().map(c => c * speed);
+     * const rightDirection = Vector2Right(); // Character facing right
+     * ```
  */
 export function Vector2Right() {
     return [1, 0];
@@ -131,7 +157,9 @@ export function Vector2Right() {
  * @returns [1, 0, 0] - Unit vector in positive X direction
  *
  * @example
- * const strafeRight = Vector3Right().map(c => c * strafeSpeed);
+     * ```typescript
+     * const strafeRight = Vector3Right().map(c => c * strafeSpeed);
+     * ```
  */
 export function Vector3Right() {
     return [1, 0, 0];
@@ -140,6 +168,10 @@ export function Vector3Right() {
  * Creates a 4D unit vector pointing right (positive X direction).
  *
  * @returns [1, 0, 0, 0] - Unit vector in positive X direction
+ * @example
+     * ```typescript
+     * const right4 = Vector4Right(); // [1, 0, 0, 0]
+     * ```
  */
 export function Vector4Right() {
     return [1, 0, 0, 0];
@@ -152,8 +184,10 @@ export function Vector4Right() {
  * @returns [0, 0, 1] - Unit vector in positive Z direction
  *
  * @example
- * const forwardMovement = Vector3Forward().map(c => c * speed);
- * const cameraForward = Vector3Forward(); // Camera looking direction
+     * ```typescript
+     * const forwardMovement = Vector3Forward().map(c => c * speed);
+     * const cameraForward = Vector3Forward(); // Camera looking direction
+     * ```
  */
 export function Vector3Forward() {
     return [0, 0, 1];
@@ -162,6 +196,10 @@ export function Vector3Forward() {
  * Creates a 4D unit vector pointing forward (positive Z direction).
  *
  * @returns [0, 0, 1, 0] - Unit vector in positive Z direction
+ * @example
+     * ```typescript
+     * const forward4 = Vector4Forward(); // [0, 0, 1, 0]
+     * ```
  */
 export function Vector4Forward() {
     return [0, 0, 1, 0];
@@ -174,8 +212,10 @@ export function Vector4Forward() {
  * @returns [0, 0, -1] - Unit vector in negative Z direction
  *
  * @example
- * const backwardMovement = Vector3Backward().map(c => c * speed);
- * const reverseDirection = Vector3Backward(); // Moving away from target
+     * ```typescript
+     * const backwardMovement = Vector3Backward().map(c => c * speed);
+     * const reverseDirection = Vector3Backward(); // Moving away from target
+     * ```
  */
 export function Vector3Backward() {
     return [0, 0, -1];
@@ -184,6 +224,10 @@ export function Vector3Backward() {
  * Creates a 4D unit vector pointing backward (negative Z direction).
  *
  * @returns [0, 0, -1, 0] - Unit vector in negative Z direction
+ * @example
+     * ```typescript
+     * const backward4 = Vector4Backward(); // [0, 0, -1, 0]
+     * ```
  */
 export function Vector4Backward() {
     return [0, 0, -1, 0];

package/build/vectors/predefined.js.map

@@ -1 +1 @@
-{"version":3,"file":"predefined.js","sourceRoot":"","sources":["../../src/vectors/predefined.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAwBH,MAAM,UAAU,UAAU,CAAC,IAAY;IACtC,OAAO,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAChC,CAAC;AAmBD,MAAM,UAAU,SAAS,CAAC,IAAY;IACrC,OAAO,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAChC,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,SAAS;IACxB,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AACf,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,SAAS;IACxB,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AAClB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,SAAS;IACxB,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AACrB,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,WAAW;IAC1B,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AAChB,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,WAAW;IAC1B,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AACnB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW;IAC1B,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AACtB,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,WAAW;IAC1B,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAChB,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,WAAW;IAC1B,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AACnB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW;IAC1B,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AACtB,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,YAAY;IAC3B,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AACf,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,YAAY;IAC3B,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AAClB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY;IAC3B,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AACrB,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,cAAc;IAC7B,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AAClB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc;IAC7B,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AACrB,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,eAAe;IAC9B,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AACnB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe;IAC9B,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AACtB,CAAC"}
+{"version":3,"file":"predefined.js","sourceRoot":"","sources":["../../src/vectors/predefined.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA0BH,MAAM,UAAU,UAAU,CAAC,IAAY;IACtC,OAAO,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAChC,CAAC;AAqBD,MAAM,UAAU,SAAS,CAAC,IAAY;IACrC,OAAO,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAChC,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,SAAS;IACxB,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AACf,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,SAAS;IACxB,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AAClB,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,SAAS;IACxB,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AACrB,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,WAAW;IAC1B,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AAChB,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,WAAW;IAC1B,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AACnB,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,WAAW;IAC1B,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AACtB,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,WAAW;IAC1B,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAChB,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,WAAW;IAC1B,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AACnB,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,WAAW;IAC1B,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AACtB,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,YAAY;IAC3B,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AACf,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,YAAY;IAC3B,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AAClB,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,YAAY;IAC3B,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AACrB,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,cAAc;IAC7B,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AAClB,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc;IAC7B,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AACrB,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,eAAe;IAC9B,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AACnB,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe;IAC9B,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AACtB,CAAC"}

package/build/vectors/types.d.ts

@@ -2,50 +2,70 @@
  * Vector type definitions for mathematical operations and geometric calculations.
  * These types provide a flexible foundation for vector operations while maintaining type safety.
  */
+import z from 'zod';
 /**
  * Generic vector type representing an array of numbers with arbitrary dimensions.
  * Useful for mathematical operations on vectors of any size.
  *
  * @example
+ * ```typescript
  * const vector: TVector = [1, 2, 3, 4, 5]; // 5D vector
+ * ```
  */
-export type TVector = number[];
+export declare const VECTOR_SCHEMA: z.ZodArray<z.ZodNumber>;
+export type TVector = z.infer<typeof VECTOR_SCHEMA>;
+/**
+ * Non-empty vector schema ensuring at least one element.
+ * Used for operations that require non-empty vectors.
+ */
+export declare const VECTOR_NONEMPTY_SCHEMA: z.ZodArray<z.ZodNumber>;
 /**
  * 2D vector type supporting both tuple and array representations.
  * Commonly used for 2D graphics, physics simulations, and coordinate systems.
  *
  * @example
+ * ```typescript
  * const position: TVector2 = [10, 20];     // Tuple representation (preferred)
  * const velocity: TVector2 = [5.5, -3.2]; // Array representation
+ * ```
  */
-export type TVector2 = [number, number];
+export declare const VECTOR2_SCHEMA: z.ZodArray<z.ZodNumber>;
+export type TVector2 = z.infer<typeof VECTOR2_SCHEMA>;
 /**
  * 3D vector type supporting both tuple and array representations.
  * Essential for 3D graphics, spatial calculations, and physics simulations.
  *
  * @example
+ * ```typescript
  * const position: TVector3 = [10, 20, 30];      // 3D position
  * const direction: TVector3 = [0, 1, 0];       // Unit vector (up)
  * const velocity: TVector3 = [2.5, -1.8, 3.2]; // 3D velocity
+ * ```
  */
-export type TVector3 = [number, number, number];
+export declare const VECTOR3_SCHEMA: z.ZodArray<z.ZodNumber>;
+export type TVector3 = z.infer<typeof VECTOR3_SCHEMA>;
 /**
  * 4D vector type supporting both tuple and array representations.
  * Used for homogeneous coordinates in 3D transformations and projections.
  *
  * @example
+ * ```typescript
  * const homogeneous: TVector4 = [10, 20, 30, 1]; // 3D point in homogeneous coordinates
  * const direction: TVector4 = [0, 1, 0, 0];     // 3D direction vector
+ * ```
  */
-export type TVector4 = [number, number, number, number];
+export declare const VECTOR4_SCHEMA: z.ZodArray<z.ZodNumber>;
+export type TVector4 = z.infer<typeof VECTOR4_SCHEMA>;
 /**
  * Union type representing any vector type.
  * Useful for functions that can accept vectors of any dimension.
  *
  * @example
+ * ```typescript
  * function processVector(vector: TAnyVector): void {
  *   // Can handle any vector dimension
  * }
+ * ```
  */
 export type TAnyVector = TVector | TVector2 | TVector3 | TVector4;
 /**
@@ -54,9 +74,11 @@ export type TAnyVector = TVector | TVector2 | TVector3 | TVector4;
  *
  * @template T - The input vector type extending TAnyVector
  * @example
+ * ```typescript
  * function operation<T extends TAnyVector>(vector: T): TVectorResult<T> {
  *   // Returns same specific type as input
  * }
+ * ```
  */
 export type TVectorResult<T extends TAnyVector> = T extends TVector2 ? TVector2 : T extends TVector3 ? TVector3 : T extends TVector4 ? TVector4 : TVector;
 //# sourceMappingURL=types.d.ts.map

package/build/vectors/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/vectors/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;GAMG;AACH,MAAM,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC;AAE/B;;;;;;;GAOG;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAExC;;;;;;;;GAQG;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAEhD;;;;;;;GAOG;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAExD;;;;;;;;GAQG;AACH,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAElE;;;;;;;;;GASG;AACH,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,UAAU,IAAI,CAAC,SAAS,QAAQ,GAAG,QAAQ,GAAG,CAAC,SAAS,QAAQ,GAAG,QAAQ,GAAG,CAAC,SAAS,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/vectors/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,CAAC,MAAM,KAAK,CAAC;AAEpB;;;;;;;;GAQG;AACH,eAAO,MAAM,aAAa,yBAAsB,CAAC;AACjD,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAEpD;;;GAGG;AACH,eAAO,MAAM,sBAAsB,yBAAuB,CAAC;AAE3D;;;;;;;;;GASG;AACH,eAAO,MAAM,cAAc,yBAAmH,CAAC;AAC/I,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEtD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,cAAc,yBAAsH,CAAC;AAClJ,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEtD;;;;;;;;;GASG;AACH,eAAO,MAAM,cAAc,yBAAyH,CAAC;AACrJ,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEtD;;;;;;;;;;GAUG;AACH,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAElE;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,UAAU,IAAI,CAAC,SAAS,QAAQ,GAAG,QAAQ,GAAG,CAAC,SAAS,QAAQ,GAAG,QAAQ,GAAG,CAAC,SAAS,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC"}

package/build/vectors/types.js

@@ -2,5 +2,54 @@
  * Vector type definitions for mathematical operations and geometric calculations.
  * These types provide a flexible foundation for vector operations while maintaining type safety.
  */
-export {};
+import z from 'zod';
+/**
+ * Generic vector type representing an array of numbers with arbitrary dimensions.
+ * Useful for mathematical operations on vectors of any size.
+ *
+ * @example
+ * ```typescript
+ * const vector: TVector = [1, 2, 3, 4, 5]; // 5D vector
+ * ```
+ */
+export const VECTOR_SCHEMA = z.array(z.number());
+/**
+ * Non-empty vector schema ensuring at least one element.
+ * Used for operations that require non-empty vectors.
+ */
+export const VECTOR_NONEMPTY_SCHEMA = VECTOR_SCHEMA.min(1);
+/**
+ * 2D vector type supporting both tuple and array representations.
+ * Commonly used for 2D graphics, physics simulations, and coordinate systems.
+ *
+ * @example
+ * ```typescript
+ * const position: TVector2 = [10, 20];     // Tuple representation (preferred)
+ * const velocity: TVector2 = [5.5, -3.2]; // Array representation
+ * ```
+ */
+export const VECTOR2_SCHEMA = z.array(z.number()).refine(arr => arr.length === 2, { message: 'Vector2 must be an array of 2 numbers [x, y]' });
+/**
+ * 3D vector type supporting both tuple and array representations.
+ * Essential for 3D graphics, spatial calculations, and physics simulations.
+ *
+ * @example
+ * ```typescript
+ * const position: TVector3 = [10, 20, 30];      // 3D position
+ * const direction: TVector3 = [0, 1, 0];       // Unit vector (up)
+ * const velocity: TVector3 = [2.5, -1.8, 3.2]; // 3D velocity
+ * ```
+ */
+export const VECTOR3_SCHEMA = z.array(z.number()).refine(arr => arr.length === 3, { message: 'Vector3 must be an array of 3 numbers [x, y, z]' });
+/**
+ * 4D vector type supporting both tuple and array representations.
+ * Used for homogeneous coordinates in 3D transformations and projections.
+ *
+ * @example
+ * ```typescript
+ * const homogeneous: TVector4 = [10, 20, 30, 1]; // 3D point in homogeneous coordinates
+ * const direction: TVector4 = [0, 1, 0, 0];     // 3D direction vector
+ * ```
+ */
+export const VECTOR4_SCHEMA = z.array(z.number()).refine(arr => arr.length === 4, { message: 'Vector4 must be an array of 4 numbers [x, y, z, w]' });
 //# sourceMappingURL=types.js.map

package/build/vectors/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/vectors/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/vectors/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,CAAC,MAAM,KAAK,CAAC;AAEpB;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;AAGjD;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AAE3D;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,EAAE,OAAO,EAAE,8CAA8C,EAAE,CAAC,CAAC;AAG/I;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,EAAE,OAAO,EAAE,iDAAiD,EAAE,CAAC,CAAC;AAGlJ;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,EAAE,OAAO,EAAE,oDAAoD,EAAE,CAAC,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "@pawells/math-extended",
 	"displayName": "Math Extended",
-	"version": "1.1.1",
+	"version": "3.0.0",
 	"description": "Shared TypeScript math library — vectors, matrices, quaternions, interpolation, angles, and random utilities. ESM-only.",
 	"type": "module",
 	"main": "./build/index.js",
@@ -28,7 +28,8 @@
 		"prepare": "husky"
 	},
 	"dependencies": {
-		"@pawells/typescript-common": "1.3.1"
+		"@pawells/typescript-common": "2.0.0",
+		"zod": "^4.4.3"
 	},
 	"devDependencies": {
 		"@eslint/js": "^10.0.1",
@@ -44,7 +45,7 @@
 		"eslint-plugin-unused-imports": "^4.0.0",
 		"globals": "^17.4.0",
 		"husky": "^9.1.7",
-		"typescript": "^5.3.3",
+		"typescript": "^6.0.2",
 		"vitest": "^4.0.18"
 	},
 	"keywords": [