@sachitv/safe-math-ts 0.1.0

package/esm/src/geometry3d/types.d.ts

@@ -0,0 +1,151 @@
+import type { Dimensionless, Quantity, UnitExpr } from '../units.js';
+declare const frameTagBrand: unique symbol;
+declare const vecBrand: unique symbol;
+declare const pointBrand: unique symbol;
+declare const dirBrand: unique symbol;
+declare const deltaBrand: unique symbol;
+declare const quatBrand: unique symbol;
+declare const matBrand: unique symbol;
+declare const linearMatBrand: unique symbol;
+declare const projectionMatBrand: unique symbol;
+/** Compile-time token for explicitly declaring frames. */
+export type FrameTag<Frame extends string> = string & {
+    readonly [frameTagBrand]: Frame;
+};
+/**
+ * Creates a compile-time frame token.
+ *
+ * @param name Frame identifier text.
+ * @returns Branded frame token used by frame-aware APIs.
+ */
+export declare const frame: <Frame extends string>(name: Frame) => FrameTag<Frame>;
+/** Shared raw 3D tuple used by point/direction/displacement variants. */
+type Vec3Base<Unit extends UnitExpr, Frame extends string> = readonly [
+    Quantity<Unit>,
+    Quantity<Unit>,
+    Quantity<Unit>
+] & {
+    readonly [vecBrand]: {
+        readonly unit: Unit;
+        readonly frame: Frame;
+    };
+};
+/**
+ * Unitful point in an affine frame.
+ *
+ * Points are locations and are not directly addable with other points.
+ */
+export type Point3<Unit extends UnitExpr, Frame extends string> = Vec3Base<Unit, Frame> & {
+    readonly [pointBrand]: {
+        readonly unit: Unit;
+        readonly frame: Frame;
+    };
+};
+/**
+ * Dimensionless direction in a frame.
+ *
+ * Represents orientation/axis information.  The constructor does **not**
+ * enforce unit length — functions that require a true unit vector
+ * (e.g. `reflectVec3`, `quatFromAxisAngle`) normalize internally.
+ */
+export type Dir3<Frame extends string> = Delta3<Dimensionless, Frame> & {
+    readonly [dirBrand]: {
+        readonly frame: Frame;
+    };
+};
+/**
+ * Unitful displacement (delta/translation) in a frame.
+ *
+ * This is the vector quantity that can be added/subtracted and used for translation.
+ */
+export type Delta3<Unit extends UnitExpr, Frame extends string> = Vec3Base<Unit, Frame> & {
+    readonly [deltaBrand]: {
+        readonly unit: Unit;
+        readonly frame: Frame;
+    };
+};
+/** Quaternion rotation in `<ToFrame, FromFrame>` order. */
+export type Quaternion<ToFrame extends string, FromFrame extends string> = readonly [
+    number,
+    number,
+    number,
+    number
+] & {
+    readonly [quatBrand]: {
+        readonly toFrame: ToFrame;
+        readonly fromFrame: FromFrame;
+    };
+};
+/**
+ * Affine 4x4 transform in `<ToFrame, FromFrame>` order.
+ *
+ * `TranslationUnit` describes the translation component unit.
+ * Storage layout is column-major:
+ * `[m00,m10,m20,m30, m01,m11,m21,m31, m02,m12,m22,m32, m03,m13,m23,m33]`.
+ * The transform APIs multiply points/directions as column vectors on the right,
+ * so `m03/m13/m23` live at indices 12/13/14.
+ */
+export type Mat4<ToFrame extends string, FromFrame extends string, TranslationUnit extends UnitExpr> = readonly [
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number
+] & {
+    readonly [matBrand]: {
+        readonly translationUnit: TranslationUnit;
+        readonly toFrame: ToFrame;
+        readonly fromFrame: FromFrame;
+    };
+};
+/**
+ * Linear-only (zero translation) matrix in `<ToFrame, FromFrame>` order.
+ */
+export type LinearMat4<ToFrame extends string, FromFrame extends string> = Mat4<ToFrame, FromFrame, Dimensionless> & {
+    readonly [linearMatBrand]: {
+        readonly toFrame: ToFrame;
+        readonly fromFrame: FromFrame;
+    };
+};
+/**
+ * Perspective 4x4 projection matrix in `<ToFrame, FromFrame>` order.
+ *
+ * Uses the same column-major storage layout as `Mat4`.
+ */
+export type ProjectionMat4<ToFrame extends string, FromFrame extends string, DepthUnit extends UnitExpr> = readonly [
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number
+] & {
+    readonly [projectionMatBrand]: {
+        readonly depthUnit: DepthUnit;
+        readonly toFrame: ToFrame;
+        readonly fromFrame: FromFrame;
+    };
+};
+export {};
+//# sourceMappingURL=types.d.ts.map

package/esm/src/geometry3d/types.d.ts.map

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

package/esm/src/geometry3d/types.js

@@ -0,0 +1,7 @@
+/**
+ * Creates a compile-time frame token.
+ *
+ * @param name Frame identifier text.
+ * @returns Branded frame token used by frame-aware APIs.
+ */
+export const frame = (name) => name;

package/esm/src/geometry3d/vector3.d.ts

@@ -0,0 +1,253 @@
+import { type Dimensionless, type MulUnit, type NoInfer, type Quantity, type UnitExpr, type UnitTag } from '../units.js';
+import type { Delta3, Dir3, FrameTag, Point3 } from './types.js';
+/**
+ * Constructs a frame-aware displacement vector.
+ *
+ * @param frameTag Frame token for the resulting displacement.
+ * @param x X component.
+ * @param y Y component.
+ * @param z Z component.
+ * @returns Displacement in `frameTag`.
+ */
+export declare const delta3: <Unit extends UnitExpr, Frame extends string>(frameTag: FrameTag<Frame>, x: Quantity<Unit>, y: Quantity<Unit>, z: Quantity<Unit>) => Delta3<Unit, Frame>;
+/**
+ * Constructs a frame-aware point.
+ *
+ * @param frameTag Frame token for the resulting point.
+ * @param x X component.
+ * @param y Y component.
+ * @param z Z component.
+ * @returns Point in `frameTag`.
+ */
+export declare const point3: <Unit extends UnitExpr, Frame extends string>(frameTag: FrameTag<Frame>, x: Quantity<Unit>, y: Quantity<Unit>, z: Quantity<Unit>) => Point3<Unit, Frame>;
+/**
+ * Constructs a frame-aware direction (dimensionless).
+ *
+ * @param frameTag Frame token for the resulting direction.
+ * @param x X component.
+ * @param y Y component.
+ * @param z Z component.
+ * @returns Direction in `frameTag`.
+ */
+export declare const dir3: <Frame extends string>(frameTag: FrameTag<Frame>, x: Quantity<Dimensionless>, y: Quantity<Dimensionless>, z: Quantity<Dimensionless>) => Dir3<Frame>;
+/**
+ * Constructs a zero displacement for an explicit unit and frame.
+ *
+ * @param unitTag Unit token for the displacement components.
+ * @param frameTag Frame token for the displacement.
+ * @returns Zero displacement in the provided unit and frame.
+ */
+export declare const zeroVec3: <Unit extends UnitExpr, Frame extends string>(unitTag: UnitTag<Unit>, frameTag: FrameTag<Frame>) => Delta3<Unit, Frame>;
+/**
+ * Adds two displacements with matching unit and frame.
+ *
+ * @param left Left displacement.
+ * @param right Right displacement in the same unit/frame.
+ * @returns Component-wise sum.
+ */
+export declare const addVec3: <Unit extends UnitExpr, Frame extends string>(left: Delta3<Unit, Frame>, right: Delta3<NoInfer<Unit>, NoInfer<Frame>>) => Delta3<Unit, Frame>;
+/**
+ * Subtracts two displacements with matching unit and frame.
+ *
+ * @param left Left displacement.
+ * @param right Right displacement in the same unit/frame.
+ * @returns Component-wise difference.
+ */
+export declare const subVec3: <Unit extends UnitExpr, Frame extends string>(left: Delta3<Unit, Frame>, right: Delta3<NoInfer<Unit>, NoInfer<Frame>>) => Delta3<Unit, Frame>;
+/**
+ * Negates each displacement component.
+ *
+ * @param value Displacement to negate.
+ * @returns Negated displacement.
+ */
+export declare const negVec3: <Unit extends UnitExpr, Frame extends string>(value: Delta3<Unit, Frame>) => Delta3<Unit, Frame>;
+/**
+ * Multiplies each displacement component by a unitless scalar.
+ *
+ * @param value Displacement to scale.
+ * @param scalar Unitless multiplier.
+ * @returns Scaled displacement.
+ */
+export declare const scaleVec3: <Unit extends UnitExpr, Frame extends string>(value: Delta3<Unit, Frame>, scalar: number) => Delta3<Unit, Frame>;
+/**
+ * Scales a unitless direction by a unitful magnitude.
+ *
+ * @param value Direction vector.
+ * @param magnitude Unitful scalar magnitude.
+ * @returns Displacement with unit derived from `magnitude`.
+ */
+export declare const scaleDir3: <Unit extends UnitExpr, Frame extends string>(value: Dir3<Frame>, magnitude: Quantity<Unit>) => Delta3<Unit, Frame>;
+/**
+ * Translates a point by a displacement.
+ *
+ * @param point Input point.
+ * @param delta Translation displacement in the same frame/unit.
+ * @returns Translated point.
+ */
+export declare const addPoint3: <Unit extends UnitExpr, Frame extends string>(point: Point3<Unit, Frame>, delta: Delta3<NoInfer<Unit>, NoInfer<Frame>>) => Point3<Unit, Frame>;
+/**
+ * Offsets a point by subtracting a displacement.
+ *
+ * @param point Input point.
+ * @param delta Displacement to subtract.
+ * @returns Offset point.
+ */
+export declare const subPoint3Delta3: <Unit extends UnitExpr, Frame extends string>(point: Point3<Unit, Frame>, delta: Delta3<NoInfer<Unit>, NoInfer<Frame>>) => Point3<Unit, Frame>;
+/**
+ * Computes the displacement from `right` point to `left` point.
+ *
+ * @param left Destination point.
+ * @param right Source point.
+ * @returns Displacement that moves `right` to `left`.
+ */
+export declare const subPoint3: <Unit extends UnitExpr, Frame extends string>(left: Point3<Unit, Frame>, right: Point3<NoInfer<Unit>, NoInfer<Frame>>) => Delta3<Unit, Frame>;
+/**
+ * Computes dot product for two displacements/directions in the same frame.
+ *
+ * @param left Left vector.
+ * @param right Right vector in the same frame.
+ * @returns Scalar product with multiplied unit.
+ */
+export declare const dotVec3: <LeftUnit extends UnitExpr, RightUnit extends UnitExpr, Frame extends string>(left: Delta3<LeftUnit, Frame>, right: Delta3<RightUnit, NoInfer<Frame>>) => Quantity<MulUnit<LeftUnit, RightUnit>>;
+/**
+ * Computes cross product for two displacements/directions in the same frame.
+ *
+ * @param left Left vector.
+ * @param right Right vector in the same frame.
+ * @returns Cross-product vector with multiplied unit.
+ */
+export declare const crossVec3: <LeftUnit extends UnitExpr, RightUnit extends UnitExpr, Frame extends string>(left: Delta3<LeftUnit, Frame>, right: Delta3<RightUnit, NoInfer<Frame>>) => Delta3<MulUnit<LeftUnit, RightUnit>, Frame>;
+/**
+ * Computes squared Euclidean length of a displacement/direction.
+ *
+ * @param value Input vector.
+ * @returns Squared length.
+ */
+export declare const lengthSquaredVec3: <Unit extends UnitExpr, Frame extends string>(value: Delta3<Unit, Frame>) => Quantity<MulUnit<Unit, Unit>>;
+/**
+ * Computes Euclidean length of a displacement/direction.
+ *
+ * @param value Input vector.
+ * @returns Vector length.
+ */
+export declare const lengthVec3: <Unit extends UnitExpr, Frame extends string>(value: Delta3<Unit, Frame>) => Quantity<Unit>;
+/**
+ * Computes Euclidean distance between two displacements.
+ *
+ * @param left Left displacement.
+ * @param right Right displacement in the same unit/frame.
+ * @returns Distance magnitude.
+ */
+export declare function distanceVec3<Unit extends UnitExpr, Frame extends string>(left: Delta3<Unit, Frame>, right: Delta3<NoInfer<Unit>, NoInfer<Frame>>): Quantity<Unit>;
+/**
+ * Computes Euclidean distance between two points.
+ *
+ * @param left Left point.
+ * @param right Right point in the same unit/frame.
+ * @returns Distance magnitude.
+ */
+export declare function distanceVec3<Unit extends UnitExpr, Frame extends string>(left: Point3<Unit, Frame>, right: Point3<NoInfer<Unit>, NoInfer<Frame>>): Quantity<Unit>;
+/**
+ * Computes Euclidean distance between two points.
+ *
+ * @param left Left point.
+ * @param right Right point in the same unit/frame.
+ * @returns Distance magnitude.
+ */
+export declare const distancePoint3: <Unit extends UnitExpr, Frame extends string>(left: Point3<Unit, Frame>, right: Point3<NoInfer<Unit>, NoInfer<Frame>>) => Quantity<Unit>;
+/**
+ * Normalizes displacement length to 1.
+ *
+ * Unsafe variant: performs no zero-length guard.
+ * Degenerate inputs can yield `NaN`/`Infinity`.
+ *
+ * @param value Vector to normalize.
+ * @returns Unit-length direction in the same frame.
+ */
+export declare const normalizeVec3Unsafe: <Unit extends UnitExpr, Frame extends string>(value: Delta3<Unit, Frame>) => Dir3<Frame>;
+/**
+ * Normalizes displacement length to 1.
+ *
+ * Throws when vector length is at or below `1e-14`.
+ *
+ * @param value Vector to normalize.
+ * @returns Unit-length direction in the same frame.
+ * @throws {Error} When the vector is near zero length.
+ */
+export declare const normalizeVec3: <Unit extends UnitExpr, Frame extends string>(value: Delta3<Unit, Frame>) => Dir3<Frame>;
+/**
+ * Linearly interpolates between two displacements.
+ *
+ * @param start Start displacement.
+ * @param end End displacement in the same unit/frame.
+ * @param t Interpolation parameter.
+ * @returns Interpolated displacement.
+ */
+export declare function lerpVec3<Unit extends UnitExpr, Frame extends string>(start: Delta3<Unit, Frame>, end: Delta3<NoInfer<Unit>, NoInfer<Frame>>, t: number): Delta3<Unit, Frame>;
+/**
+ * Linearly interpolates between two points.
+ *
+ * @param start Start point.
+ * @param end End point in the same unit/frame.
+ * @param t Interpolation parameter.
+ * @returns Interpolated point.
+ */
+export declare function lerpVec3<Unit extends UnitExpr, Frame extends string>(start: Point3<Unit, Frame>, end: Point3<NoInfer<Unit>, NoInfer<Frame>>, t: number): Point3<Unit, Frame>;
+/**
+ * Projects a displacement onto another displacement in the same frame.
+ *
+ * Unsafe variant: performs no zero-length guard for `onto`.
+ *
+ * @param value Vector being projected.
+ * @param onto Target direction for projection.
+ * @returns Projection of `value` onto `onto`.
+ */
+export declare const projectVec3Unsafe: <ValueUnit extends UnitExpr, OntoUnit extends UnitExpr, Frame extends string>(value: Delta3<ValueUnit, Frame>, onto: Delta3<OntoUnit, NoInfer<Frame>>) => Delta3<ValueUnit, Frame>;
+/**
+ * Projects a displacement onto another displacement in the same frame.
+ *
+ * @param value Vector being projected.
+ * @param onto Target direction for projection.
+ * @returns Projection of `value` onto `onto`.
+ * @throws {Error} When `onto` is near zero length.
+ */
+export declare const projectVec3: <ValueUnit extends UnitExpr, OntoUnit extends UnitExpr, Frame extends string>(value: Delta3<ValueUnit, Frame>, onto: Delta3<OntoUnit, NoInfer<Frame>>) => Delta3<ValueUnit, Frame>;
+/**
+ * Reflects a displacement around a normal direction.
+ *
+ * Unsafe variant: performs no zero-length guard for `normal`.
+ *
+ * @param incident Incident displacement.
+ * @param normal Reflection normal direction.
+ * @returns Reflected displacement.
+ */
+export declare const reflectVec3Unsafe: <Unit extends UnitExpr, Frame extends string>(incident: Delta3<Unit, Frame>, normal: Dir3<NoInfer<Frame>>) => Delta3<Unit, Frame>;
+/**
+ * Reflects a displacement around a normal direction.
+ *
+ * @param incident Incident displacement.
+ * @param normal Reflection normal direction.
+ * @returns Reflected displacement.
+ * @throws {Error} When `normal` is near zero length.
+ */
+export declare const reflectVec3: <Unit extends UnitExpr, Frame extends string>(incident: Delta3<Unit, Frame>, normal: Dir3<NoInfer<Frame>>) => Delta3<Unit, Frame>;
+/**
+ * Computes the angle in radians between two displacements.
+ *
+ * Unsafe variant: performs no zero-length guards.
+ *
+ * @param left Left vector.
+ * @param right Right vector.
+ * @returns Angle in radians.
+ */
+export declare const angleBetweenVec3Unsafe: <LeftUnit extends UnitExpr, RightUnit extends UnitExpr, Frame extends string>(left: Delta3<LeftUnit, Frame>, right: Delta3<RightUnit, NoInfer<Frame>>) => number;
+/**
+ * Computes the angle in radians between two non-zero displacements.
+ *
+ * @param left Left vector.
+ * @param right Right vector.
+ * @returns Angle in radians.
+ * @throws {Error} When either vector is near zero length.
+ */
+export declare const angleBetweenVec3: <LeftUnit extends UnitExpr, RightUnit extends UnitExpr, Frame extends string>(left: Delta3<LeftUnit, Frame>, right: Delta3<RightUnit, NoInfer<Frame>>) => number;
+//# sourceMappingURL=vector3.d.ts.map

package/esm/src/geometry3d/vector3.d.ts.map

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