curvy 1.0.9 → 2.0.0-alpha.2

package/dist/shared/vector3-DqeOZtOB.d.mts

@@ -0,0 +1,703 @@
+import { i as FourDimensional, s as ThreeDimensional } from "./vector2-DPUY3_eA.mjs";
+import { t as Pipeable } from "./utils-MCckigYk.mjs";
+
+//#region src/vector/vector4.internal.d.ts
+declare const Vector4TypeId: unique symbol;
+type Vector4TypeId = typeof Vector4TypeId;
+declare namespace vector4_d_exports {
+  export { Vector4, add$1 as add, components$1 as components, dot$1 as dot, equals$1 as equals, hadamard$1 as hadamard, isVector4, magnitude$1 as magnitude, make$1 as make, normalize$1 as normalize, scale$1 as scale, softmax$1 as softmax, subtract$1 as subtract, transpose$1 as transpose, unit$1 as unit, zero$1 as zero };
+}
+/**
+ * A 4D vector.
+ *
+ * All fields are readonly and immutable, and all operations create new instances.
+ *
+ * @since 1.0.0
+ */
+interface Vector4 extends Pipeable, FourDimensional<number> {
+  readonly [Vector4TypeId]: Vector4TypeId;
+}
+/**
+ * Checks if a value is a `Vector4`.
+ *
+ * @param v - The value to check.
+ * @returns `true` if the value is a `Vector4`, `false` otherwise.
+ * @since 1.0.0
+ */
+declare const isVector4: (v: unknown) => v is Vector4;
+declare const equals$1: {
+  /**
+   * Checks if two `Vector4` instances are approximately equal within the
+   * default absolute tolerance ({@link EPSILON}).
+   *
+   * @param a - The first vector.
+   * @param b - The second vector.
+   * @returns `true` when each pair of components is within tolerance.
+   * @since 1.1.0
+   */
+  (a: Vector4, b: Vector4): boolean;
+  /**
+   * Checks if two `Vector4` instances are approximately equal within the
+   * default absolute tolerance ({@link EPSILON}).
+   *
+   * @param b - The second vector.
+   * @returns A function that takes the first vector and returns the comparison result.
+   * @since 1.1.0
+   */
+  (b: Vector4): (a: Vector4) => boolean;
+};
+declare const make$1: {
+  /**
+   * Creates a new `Vector4` instance.
+   *
+   * @param xyzw - The x, y, z, and w components of the vector.
+   * @returns A new `Vector4` instance.
+   * @since 1.0.0
+   */
+  (xyzw: number): Vector4;
+  /**
+   * Creates a new `Vector4` instance.
+   *
+   * @param x - The x component of the vector.
+   * @param yzw - The y, z, and w components of the vector.
+   * @returns A new `Vector4` instance.
+   * @since 1.0.0
+   */
+  (x: number, yzw: number): Vector4;
+  /**
+   * Creates a new `Vector4` instance.
+   *
+   * @param x - The x component of the vector.
+   * @param y - The y component of the vector.
+   * @param zw - The z and w components of the vector.
+   * @returns A new `Vector4` instance.
+   * @since 1.0.0
+   */
+  (x: number, y: number, zw: number): Vector4;
+  /**
+   * Creates a new `Vector4` instance.
+   *
+   * @param x - The x component of the vector.
+   * @param y - The y component of the vector.
+   * @param z - The z component of the vector.
+   * @param w - The w component of the vector.
+   * @returns A new `Vector4` instance.
+   * @since 1.0.0
+   */
+  (x: number, y: number, z: number, w: number): Vector4;
+};
+/**
+ * Transposes a 4-tuple of items into one or more `Vector4`s, one per channel
+ * extracted by the projection function.
+ *
+ * For each output channel, takes the corresponding number from each of the
+ * four projected items and packs them into a `Vector4` — the data-layout
+ * transformation NumPy calls a transpose, FP calls `unzip`, GPUs call a
+ * gather, and DSP people inexplicably call deinterleaving.
+ *
+ * The projection's return-tuple arity determines the number of output
+ * vectors, and that arity is preserved in the return type.
+ *
+ * @example
+ * ```ts
+ * // Pack the x and y coordinates of four control points into two Vector4s.
+ * const [xs, ys] = Vector4.transpose(
+ *   [p0, p1, p2, p3],
+ *   (p) => [p.x, p.y],
+ * )
+ * ```
+ *
+ * @param inputs - Exactly four items of any type.
+ * @param project - A function returning a fixed-arity tuple of numbers — one per output channel.
+ * @returns A tuple of `Vector4`s with the same arity as the projection's return tuple.
+ * @since 2.1.0
+ */
+declare const transpose$1: <T, const Channels extends ReadonlyArray<number>>(inputs: readonly [T, T, T, T], project: (item: T) => Channels) => { readonly [K in keyof Channels]: Vector4 };
+/**
+ * Gets the magnitude of a `Vector4`.
+ *
+ * @param vector - The vector to calculate the magnitude of.
+ * @returns The magnitude of the vector.
+ * @since 1.0.0
+ */
+declare const magnitude$1: (vector: Vector4) => number;
+/**
+ * Normalizes a `Vector4`.
+ *
+ * @param vector - The vector to normalize.
+ * @returns A new `Vector4` instance with the same direction as the input vector but with a magnitude of 1.
+ * @since 1.0.0
+ */
+declare const normalize$1: (vector: Vector4) => Vector4;
+declare const dot$1: {
+  /**
+   * Computes the dot product of two `Vector4` instances.
+   *
+   * @param a - The first vector.
+   * @param b - The second vector.
+   * @returns The dot product of the two vectors.
+   * @since 1.0.0
+   */
+  (a: Vector4, b: Vector4): number;
+  /**
+   * Computes the dot product of a `Vector4` instance and another vector.
+   *
+   * @param b - The second vector.
+   * @returns A function that takes the first vector and returns the dot product.
+   * @since 1.0.0
+   */
+  (b: Vector4): (a: Vector4) => number;
+};
+/**
+ * Returns the components of a `Vector4` as an array.
+ *
+ * @param v - The vector to get the components of.
+ * @returns An array containing the x, y, z, and w components of the vector.
+ * @since 1.0.0
+ */
+declare const components$1: (v: Vector4) => [number, number, number, number];
+/**
+ * Applies the softmax function to a `Vector4`.
+ *
+ * @param v - The vector to calculate the softmax of.
+ * @returns A new `Vector4` instance representing the softmax of the input vector.
+ */
+declare const softmax$1: (v: Vector4) => Vector4;
+/**
+ * Creates a zero vector.
+ *
+ * @since 1.0.0
+ */
+declare const zero$1: Vector4;
+/**
+ * Creates a unit vector.
+ *
+ * @since 1.0.0
+ */
+declare const unit$1: Vector4;
+declare const add$1: {
+  /**
+   * Adds two `Vector4` instances.
+   *
+   * @param a - The first vector.
+   * @param b - The second vector.
+   * @returns A new `Vector4` instance representing the sum of the two vectors.
+   * @since 1.0.0
+   */
+  (a: Vector4, b: Vector4): Vector4;
+  /**
+   * Adds a `Vector4` instance to another vector.
+   *
+   * @param b - The second vector.
+   * @returns A function that takes the first vector and returns the sum.
+   * @since 1.0.0
+   */
+  (b: Vector4): (a: Vector4) => Vector4;
+};
+declare const subtract$1: {
+  /**
+   * Subtracts one `Vector4` instance from another.
+   *
+   * @param a - The first vector.
+   * @param b - The second vector.
+   * @returns A new `Vector4` instance representing the difference of the two vectors.
+   * @since 1.0.0
+   */
+  (a: Vector4, b: Vector4): Vector4;
+  /**
+   * Subtracts a `Vector4` instance from another vector.
+   *
+   * @param b - The second vector.
+   * @returns A function that takes the first vector and returns the difference.
+   * @since 1.0.0
+   */
+  (b: Vector4): (a: Vector4) => Vector4;
+};
+declare const hadamard$1: {
+  /**
+   * Computes the Hadamard product of two `Vector4` instances.
+   *
+   * @param a - The first vector.
+   * @param b - The second vector.
+   * @returns A new `Vector4` instance representing the Hadamard product of the two vectors.
+   * @since 1.0.0
+   */
+  (a: Vector4, b: Vector4): Vector4;
+  /**
+   * Computes the Hadamard product of a `Vector4` instance and another vector.
+   *
+   * @param b - The second vector.
+   * @returns A function that takes the first vector and returns the Hadamard product.
+   * @since 1.0.0
+   */
+  (b: Vector4): (a: Vector4) => Vector4;
+};
+declare const scale$1: {
+  /**
+   * Scales a `Vector4` by a scalar.
+   *
+   * @param s - The scalar to scale the vector by.
+   * @returns A function that takes the vector and returns the scaled vector.
+   * @since 1.0.0
+   */
+  (s: number): (v: Vector4) => Vector4;
+  /**
+   * Scales a `Vector4` by a scalar.
+   *
+   * @param s - The scalar to scale the vector by.
+   * @param v - The vector to scale.
+   * @returns A new `Vector4` instance representing the scaled vector.
+   * @since 1.0.0
+   */
+  (v: Vector4, s: number): Vector4;
+};
+//#endregion
+//#region src/vector/vector3.internal.d.ts
+declare const Vector3TypeId: unique symbol;
+type Vector3TypeId = typeof Vector3TypeId;
+declare namespace vector3_d_exports {
+  export { Vector3, add, components, cross, dot, equals, fromSpherical, getPhi, getR, getTheta, getX, getY, getZ, hadamard, isVector3, length, magnitude, make, normalize, scale, setPhi, setR, setTheta, setX, setY, setZ, softmax, subtract, transpose, unit, unitX, unitY, unitZ, zero };
+}
+/**
+ * A 3D vector.
+ *
+ * All fields are readonly and immutable, and all operations create new instances.
+ *
+ * @since 1.0.0
+ */
+interface Vector3 extends Pipeable, ThreeDimensional<number> {
+  readonly [Vector3TypeId]: Vector3TypeId;
+}
+/**
+ * Checks if a value is a `Vector3`.
+ *
+ * @param v - The value to check.
+ * @returns `true` if the value is a `Vector3`, `false` otherwise.
+ * @since 1.0.0
+ */
+declare const isVector3: (v: unknown) => v is Vector3;
+declare const equals: {
+  /**
+   * Checks if two `Vector3` instances are approximately equal within the
+   * default absolute tolerance ({@link EPSILON}).
+   *
+   * @param a - The first vector.
+   * @param b - The second vector.
+   * @returns `true` when each pair of components is within tolerance.
+   * @since 1.1.0
+   */
+  (a: Vector3, b: Vector3): boolean;
+  /**
+   * Checks if two `Vector3` instances are approximately equal within the
+   * default absolute tolerance ({@link EPSILON}).
+   *
+   * @param b - The second vector.
+   * @returns A function that takes the first vector and returns the comparison result.
+   * @since 1.1.0
+   */
+  (b: Vector3): (a: Vector3) => boolean;
+};
+declare const make: {
+  /**
+   * Creates a new `Vector3` instance.
+   *
+   * @param xyz - The x, y, and z components of the vector.
+   * @returns A new `Vector3` instance.
+   * @since 1.0.0
+   */
+  (xyz: number): Vector3;
+  /**
+   * Creates a new `Vector3` instance.
+   *
+   * @param x - The x component of the vector.
+   * @param yz - The y and z components of the vector.
+   * @returns A new `Vector3` instance.
+   * @since 1.0.0
+   */
+  (x: number, yz: number): Vector3;
+  /**
+   * Creates a new `Vector3` instance.
+   *
+   * @param x - The x component of the vector.
+   * @param y - The y component of the vector.
+   * @param z - The z component of the vector.
+   * @returns A new `Vector3` instance.
+   * @since 1.0.0
+   */
+  (x: number, y: number, z: number): Vector3;
+};
+/**
+ * Transposes a 3-tuple of items into one or more `Vector3`s, one per channel
+ * extracted by the projection function. See {@link Vector4.transpose} for the
+ * full operation description; this is the 3-component analog.
+ *
+ * @param inputs - Exactly three items of any type.
+ * @param project - A function returning a fixed-arity tuple of numbers — one per output channel.
+ * @returns A tuple of `Vector3`s with the same arity as the projection's return tuple.
+ * @since 2.1.0
+ */
+declare const transpose: <T, const Channels extends ReadonlyArray<number>>(inputs: readonly [T, T, T], project: (item: T) => Channels) => { readonly [K in keyof Channels]: Vector3 };
+/**
+ * Creates a new `Vector3` instance from spherical coordinates.
+ *
+ * @param r - The radius.
+ * @param theta - The polar angle, in radians. Ranges from 0 to π
+ * @param phi - The azimuthal angle, in radians. Ranges from 0 to 2π
+ * @returns A new `Vector3` instance.
+ * @since 1.0.0
+ */
+declare const fromSpherical: (r: number, theta: number, phi: number) => Vector3;
+/**
+ * Calculates the magnitude of a `Vector3`.
+ *
+ * @param vector - The vector to calculate the magnitude of.
+ * @returns The magnitude of the vector.
+ * @since 1.0.0
+ */
+declare const magnitude: (vector: Vector3) => number;
+/**
+ * Calculates the length of a `Vector3`.
+ *
+ * @param vector - The vector to calculate the length of.
+ * @returns The length of the vector.
+ * @see {@link magnitude}
+ * @since 1.0.0
+ */
+declare const length: (vector: Vector3) => number;
+/**
+ * Normalizes a `Vector3`.
+ *
+ * @param vector - The vector to normalize.
+ * @returns A new `Vector3` instance with the same direction as the input vector, but with a magnitude of 1.
+ * @since 1.0.0
+ */
+declare const normalize: (vector: Vector3) => Vector3;
+declare const dot: {
+  /**
+   * Calculates the dot product of two `Vector3` instances.
+   *
+   * @param a - The first vector.
+   * @param b - The second vector.
+   * @returns The dot product of the two vectors.
+   * @since 1.0.0
+   */
+  (a: Vector3, b: Vector3): number;
+  /**
+   * Calculates the dot product of two `Vector3` instances.
+   *
+   * @param b - The second vector.
+   * @returns A function that takes the first vector and returns the dot product.
+   * @since 1.0.0
+   */
+  (b: Vector3): (a: Vector3) => number;
+};
+declare const cross: {
+  /**
+   * Calculates the cross product of two `Vector3` instances.
+   *
+   * @param a - The first vector.
+   * @param b - The second vector.
+   * @returns A new `Vector3` instance representing the cross product of the two vectors.
+   * @since 1.0.0
+   */
+  (a: Vector3, b: Vector3): Vector3;
+  /**
+   * Calculates the cross product of two `Vector3` instances.
+   *
+   * @param b - The second vector.
+   * @returns A function that takes the first vector and returns the cross product.
+   * @since 1.0.0
+   */
+  (b: Vector3): (a: Vector3) => Vector3;
+};
+/**
+ * Returns the components of a `Vector3` as an array.
+ *
+ * @param v - The vector to get the components of.
+ * @returns An array containing the x, y, and z components of the vector.
+ * @since 1.0.0
+ */
+declare const components: (v: Vector3) => [number, number, number];
+/**
+ * Calculates the softmax of a `Vector3`.
+ *
+ * @param v - The vector to calculate the softmax of.
+ * @returns A new `Vector3` instance representing the softmax of the input vector.
+ * @since 1.0.0
+ */
+declare const softmax: (v: Vector3) => Vector3;
+/**
+ * Creates a zero vector.
+ *
+ * @since 1.0.0
+ */
+declare const zero: Vector3;
+/**
+ * Creates a unit vector.
+ *
+ * @since 1.0.0
+ */
+declare const unit: Vector3;
+/**
+ * Creates a unit vector in the x direction.
+ *
+ * @since 1.0.0
+ */
+declare const unitX: Vector3;
+/**
+ * Creates a unit vector in the y direction.
+ *
+ * @since 1.0.0
+ */
+declare const unitY: Vector3;
+/**
+ * Creates a unit vector in the z direction.
+ *
+ * @since 1.0.0
+ */
+declare const unitZ: Vector3;
+declare const add: {
+  /**
+   * Adds two `Vector3` instances.
+   *
+   * @param a - The first vector.
+   * @param b - The second vector.
+   * @returns A new `Vector3` instance representing the sum of the two vectors.
+   * @since 1.0.0
+   */
+  (a: Vector3, b: Vector3): Vector3;
+  /**
+   * Adds two `Vector3` instances.
+   *
+   * @param b - The second vector.
+   * @returns A function that takes the first vector and returns the sum.
+   * @since 1.0.0
+   */
+  (b: Vector3): (a: Vector3) => Vector3;
+};
+declare const subtract: {
+  /**
+   * Subtracts one `Vector3` instance from another.
+   *
+   * @param a - The vector to subtract from.
+   * @param b - The vector to subtract.
+   * @returns A new `Vector3` instance representing the difference of the two vectors.
+   * @since 1.0.0
+   */
+  (a: Vector3, b: Vector3): Vector3;
+  /**
+   * Subtracts one `Vector3` instance from another.
+   *
+   * @param b - The vector to subtract.
+   * @returns A function that takes the first vector and returns the difference.
+   * @since 1.0.0
+   */
+  (b: Vector3): (a: Vector3) => Vector3;
+};
+declare const hadamard: {
+  /**
+   * Calculates the Hadamard product of two `Vector3` instances.
+   *
+   * The Hadamard product is an element-wise multiplication of two vectors.
+   *
+   * @param a - The first vector.
+   * @param b - The second vector.
+   * @returns A new `Vector3` instance representing the Hadamard product of the two vectors.
+   * @since 1.0.0
+   */
+  (a: Vector3, b: Vector3): Vector3;
+  /**
+   * Calculates the Hadamard product of two `Vector3` instances.
+   *
+   * The Hadamard product is an element-wise multiplication of two vectors.
+   *
+   * @param b - The second vector.
+   * @returns A function that takes the first vector and returns the Hadamard product.
+   * @since 1.0.0
+   */
+  (b: Vector3): (a: Vector3) => Vector3;
+};
+declare const scale: {
+  /**
+   * Scales a `Vector3` instance by a scalar value.
+   *
+   * @param s - The scalar value to scale by.
+   * @return A function that takes a vector and returns the scaled vector.
+   * @since 1.0.0
+   */
+  (s: number): (v: Vector3) => Vector3;
+  /**
+   * Scales a `Vector3` instance by a scalar value.
+   *
+   * @param s - The scalar value to scale by.
+   * @param v - The vector to scale.
+   * @returns A new `Vector3` instance representing the scaled vector.
+   * @since 1.0.0
+   */
+  (v: Vector3, s: number): Vector3;
+};
+/**
+ * Gets the x component of a `Vector3`.
+ *
+ * @param v - The vector to get the x component of.
+ * @returns The x component of the vector.
+ * @since 1.0.0
+ */
+declare const getX: (v: Vector3) => number;
+declare const setX: {
+  /**
+   * Sets the x component of a `Vector3`.
+   *
+   * @param v - The vector to set the x component of.
+   * @param x - The new x component.
+   * @returns A new `Vector3` instance with the updated x component.
+   * @since 1.0.0
+   */
+  (v: Vector3, x: number): Vector3;
+  /**
+   * Sets the x component of a `Vector3`.
+   *
+   * @param x - The new x component.
+   * @returns A function that takes the vector and returns a new `Vector3` instance with the updated x component.
+   * @since 1.0.0
+   */
+  (x: number): (v: Vector3) => Vector3;
+};
+/**
+ * Gets the y component of a `Vector3`.
+ *
+ * @param v - The vector of which to get the y component.
+ * @returns The y component of the vector.
+ * @since 1.0.0
+ */
+declare const getY: (v: Vector3) => number;
+declare const setY: {
+  /**
+   * Sets the y component of a `Vector3`.
+   *
+   * @param v - The vector of which to set the y component.
+   * @param y - The new y component.
+   * @returns A new `Vector3` instance with the updated y component.
+   * @since 1.0.0
+   */
+  (v: Vector3, y: number): Vector3;
+  /**
+   * Sets the y component of a `Vector3`.
+   *
+   * @param y - The new y component.
+   * @returns A function that takes the vector and returns a new `Vector3` instance with the updated y component.
+   * @since 1.0.0
+   */
+  (y: number): (v: Vector3) => Vector3;
+};
+/**
+ * Gets the z component of a `Vector3`.
+ *
+ * @param v - The vector of which to get the z component.
+ * @returns The z component of the vector.
+ * @since 1.0.0
+ */
+declare const getZ: (v: Vector3) => number;
+declare const setZ: {
+  /**
+   * Sets the z component of a `Vector3`.
+   *
+   * @param v - The vector of which to set the z component.
+   * @param z - The new z component.
+   * @returns A new `Vector3` instance with the updated z component.
+   * @since 1.0.0
+   */
+  (v: Vector3, z: number): Vector3;
+  /**
+   * Sets the z component of a `Vector3`.
+   *
+   * @param z - The new z component.
+   * @returns A function that takes the vector and returns a new `Vector3` instance with the updated z component.
+   * @since 1.0.0
+   */
+  (z: number): (v: Vector3) => Vector3;
+};
+/**
+ * Gets the radius of a `Vector3`.
+ *
+ * @param v - The vector of which to get the radius.
+ * @returns The radius of the vector.
+ * @since 1.0.0
+ */
+declare const getR: (v: Vector3) => number;
+declare const setR: {
+  /**
+   * Sets the radius of a `Vector3`.
+   *
+   * @param v - The vector of which to set the radius.
+   * @param r - The new radius.
+   * @returns A new `Vector3` instance with the updated radius.
+   * @since 1.0.0
+   */
+  (v: Vector3, r: number): Vector3;
+  /**
+   * Sets the radius of a `Vector3`.
+   *
+   * @param r - The new radius.
+   * @returns A function that takes the vector and returns the updated vector.
+   * @since 1.0.0
+   */
+  (r: number): (v: Vector3) => Vector3;
+};
+/**
+ * Gets the polar angle (theta) of a `Vector3`.
+ *
+ * @param v - The vector of which to get the polar angle.
+ * @returns The polar angle of the vector.
+ * @since 1.0.0
+ */
+declare const getTheta: (v: Vector3) => number;
+declare const setTheta: {
+  /**
+   * Sets the polar angle (theta) of a `Vector3`.
+   *
+   * @param v - The vector of which to set the polar angle.
+   * @param theta - The new polar angle.
+   * @returns A new `Vector3` instance with the updated polar angle.
+   * @since 1.0.0
+   */
+  (v: Vector3, theta: number): Vector3;
+  /**
+   * Sets the polar angle (theta) of a `Vector3`.
+   *
+   * @param theta - The new polar angle.
+   * @returns A function that takes the vector and returns the updated vector.
+   * @since 1.0.0
+   */
+  (theta: number): (v: Vector3) => Vector3;
+};
+/**
+ * Gets the azimuthal angle (phi) of a `Vector3`.
+ *
+ * @param v - The vector of which to get the azimuthal angle.
+ * @returns The azimuthal angle of the vector.
+ * @since 1.0.0
+ */
+declare const getPhi: (v: Vector3) => number;
+declare const setPhi: {
+  /**
+   * Sets the azimuthal angle (phi) of a `Vector3`.
+   *
+   * @param v - The vector of which to set the azimuthal angle.
+   * @param phi - The new azimuthal angle.
+   * @returns A new `Vector3` instance with the updated azimuthal angle.
+   * @since 1.0.0
+   */
+  (v: Vector3, phi: number): Vector3;
+  /**
+   * Sets the azimuthal angle (phi) of a `Vector3`.
+   *
+   * @param phi - The new azimuthal angle.
+   * @returns A function that takes the vector and returns the updated vector.
+   * @since 1.0.0
+   */
+  (phi: number): (v: Vector3) => Vector3;
+};
+//#endregion
+export { vector4_d_exports as i, vector3_d_exports as n, Vector4 as r, Vector3 as t };
+//# sourceMappingURL=vector3-DqeOZtOB.d.mts.map