curvy 1.0.8 → 2.0.0-alpha.0

package/dist/shared/vector2-TV0UnlxY.d.mts

@@ -0,0 +1,1168 @@
+import { t as Pipeable } from "./utils-DqTGyXrP.mjs";
+
+//#region src/dimensions.d.ts
+type TwoDimensionalIndex = 0 | 1;
+type TwoDimensionalComponent = 'x' | 'y';
+interface TwoDimensional<out T1, out T2 = T1> {
+  readonly x: T1;
+  readonly y: T2;
+  readonly 0: T1;
+  readonly 1: T2;
+}
+type ThreeDimensionalIndex = TwoDimensionalIndex | 2;
+type ThreeDimensionalComponent = TwoDimensionalComponent | 'z';
+interface ThreeDimensional<out T1, out T2 = T1, out T3 = T2> extends TwoDimensional<T1, T2> {
+  readonly z: T3;
+  readonly 2: T3;
+}
+type FourDimensionalIndex = ThreeDimensionalIndex | 3;
+type FourDimensionalComponent = ThreeDimensionalComponent | 'w';
+interface FourDimensional<out T1, out T2 = T1, out T3 = T2, out T4 = T3> extends ThreeDimensional<T1, T2, T3> {
+  readonly w: T4;
+  readonly 3: T4;
+}
+//#endregion
+//#region src/vector/vector4.internal.d.ts
+declare const Vector4TypeId: unique symbol;
+type Vector4TypeId = typeof Vector4TypeId;
+declare namespace vector4_d_exports {
+  export { Vector4, add$2 as add, components$2 as components, dot$2 as dot, equals$2 as equals, hadamard$2 as hadamard, isVector4, magnitude$2 as magnitude, make$2 as make, normalize$2 as normalize, scale$2 as scale, softmax$2 as softmax, subtract$2 as subtract, transpose$2 as transpose, unit$2 as unit, zero$2 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$2: {
+  /**
+   * 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$2: {
+  /**
+   * 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$2: <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$2: (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$2: (vector: Vector4) => Vector4;
+declare const dot$2: {
+  /**
+   * 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$2: (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$2: (v: Vector4) => Vector4;
+/**
+ * Creates a zero vector.
+ *
+ * @since 1.0.0
+ */
+declare const zero$2: Vector4;
+/**
+ * Creates a unit vector.
+ *
+ * @since 1.0.0
+ */
+declare const unit$2: Vector4;
+declare const add$2: {
+  /**
+   * 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$2: {
+  /**
+   * 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$2: {
+  /**
+   * 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$2: {
+  /**
+   * 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$1 as add, components$1 as components, cross$1 as cross, dot$1 as dot, equals$1 as equals, fromSpherical, getPhi, getR$1 as getR, getTheta$1 as getTheta, getX$1 as getX, getY$1 as getY, getZ, hadamard$1 as hadamard, isVector3, length, magnitude$1 as magnitude, make$1 as make, normalize$1 as normalize, scale$1 as scale, setPhi, setR$1 as setR, setTheta$1 as setTheta, setX$1 as setX, setY$1 as setY, setZ, softmax$1 as softmax, subtract$1 as subtract, transpose$1 as transpose, unit$1 as unit, unitX, unitY, unitZ, zero$1 as 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$1: {
+  /**
+   * 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$1: {
+  /**
+   * 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$1: <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$1: (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$1: (vector: Vector3) => Vector3;
+declare const dot$1: {
+  /**
+   * 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$1: {
+  /**
+   * 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$1: (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$1: (v: Vector3) => Vector3;
+/**
+ * Creates a zero vector.
+ *
+ * @since 1.0.0
+ */
+declare const zero$1: Vector3;
+/**
+ * Creates a unit vector.
+ *
+ * @since 1.0.0
+ */
+declare const unit$1: 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$1: {
+  /**
+   * 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$1: {
+  /**
+   * 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$1: {
+  /**
+   * 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$1: {
+  /**
+   * 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$1: (v: Vector3) => number;
+declare const setX$1: {
+  /**
+   * 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$1: (v: Vector3) => number;
+declare const setY$1: {
+  /**
+   * 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$1: (v: Vector3) => number;
+declare const setR$1: {
+  /**
+   * 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$1: (v: Vector3) => number;
+declare const setTheta$1: {
+  /**
+   * 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
+//#region src/vector/vector2.internal.d.ts
+declare const Vector2TypeId: unique symbol;
+type Vector2TypeId = typeof Vector2TypeId;
+declare const WeightedVector2TypeId: unique symbol;
+type WeightedVector2TypeId = typeof WeightedVector2TypeId;
+declare namespace vector2_d_exports {
+  export { Vector2, Weighted, add, components, cross, dot, equals, fromPolar, getR, getTheta, getX, getY, hadamard, isVector2, isWeighted, magnitude, make, makeWeighted, normalize, scale, setR, setTheta, setX, setY, softmax, subtract, transpose, unit, unweighted, weightedEquals, withWeight, zero };
+}
+/**
+ * A 2D vector.
+ *
+ * All fields are readonly and immutable, and all operations create new instances.
+ *
+ * @since 1.0.0
+ */
+interface Vector2 extends Pipeable, TwoDimensional<number> {
+  readonly [Vector2TypeId]: Vector2TypeId;
+}
+/**
+ * A 2D point with an associated positive scalar weight.
+ *
+ * Used by rational primitives (e.g. `RationalBezier2d`) where each control
+ * point carries an influence weight. The interface is structurally distinct
+ * from `Vector2` — its brand prevents accidental use with vector arithmetic
+ * (`add`, `subtract`, `scale`, etc.) where weighted operations are not
+ * well-defined.
+ *
+ * Construct via {@link makeWeighted} (from raw components) or
+ * {@link withWeight} (from an existing `Vector2`).
+ *
+ * @since 2.1.0
+ */
+interface Weighted extends Pipeable {
+  readonly [WeightedVector2TypeId]: WeightedVector2TypeId;
+  readonly x: number;
+  readonly y: number;
+  readonly weight: number;
+}
+/**
+ * Checks if a value is a `Vector2`.
+ *
+ * @param v - The value to check.
+ * @returns `true` if the value is a `Vector2`, `false` otherwise.
+ * @since 1.0.0
+ */
+declare const isVector2: (v: unknown) => v is Vector2;
+/**
+ * Checks if a value is a `Vector2.Weighted`.
+ *
+ * @param v - The value to check.
+ * @returns `true` if the value is a `Vector2.Weighted`, `false` otherwise.
+ * @since 2.1.0
+ */
+declare const isWeighted: (v: unknown) => v is Weighted;
+/**
+ * Creates a new `Vector2.Weighted` from raw components. The weight must be
+ * finite and positive.
+ *
+ * @param x - The x component.
+ * @param y - The y component.
+ * @param weight - The positive scalar weight.
+ * @returns A new `Vector2.Weighted` instance.
+ * @since 2.1.0
+ */
+declare const makeWeighted: (x: number, y: number, weight: number) => Weighted;
+declare const withWeight: {
+  /**
+   * Promotes a `Vector2` to a `Vector2.Weighted` by attaching the given
+   * positive scalar weight.
+   *
+   * @param v - The point to weight.
+   * @param weight - The positive scalar weight.
+   * @returns A new `Vector2.Weighted` instance.
+   * @since 2.1.0
+   */
+  (v: Vector2, weight: number): Weighted;
+  /**
+   * Promotes a `Vector2` to a `Vector2.Weighted` by attaching the given
+   * positive scalar weight.
+   *
+   * @param weight - The positive scalar weight.
+   * @returns A function that takes a `Vector2` and returns a weighted point.
+   * @since 2.1.0
+   */
+  (weight: number): (v: Vector2) => Weighted;
+};
+/**
+ * Strips the weight from a `Vector2.Weighted`, returning the underlying point.
+ *
+ * @param w - The weighted point.
+ * @returns A new `Vector2` instance with the same x and y components.
+ * @since 2.1.0
+ */
+declare const unweighted: (w: Weighted) => Vector2;
+declare const weightedEquals: {
+  /**
+   * Checks if two `Vector2.Weighted` instances are approximately equal —
+   * point components and weight all within the default absolute tolerance.
+   *
+   * @param a - The first weighted point.
+   * @param b - The second weighted point.
+   * @returns `true` when components and weight are within tolerance.
+   * @since 2.1.0
+   */
+  (a: Weighted, b: Weighted): boolean;
+  /**
+   * Checks if two `Vector2.Weighted` instances are approximately equal.
+   *
+   * @param b - The second weighted point.
+   * @returns A function that takes the first weighted point and returns the comparison result.
+   * @since 2.1.0
+   */
+  (b: Weighted): (a: Weighted) => boolean;
+};
+declare const equals: {
+  /**
+   * Checks if two `Vector2` 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: Vector2, b: Vector2): boolean;
+  /**
+   * Checks if two `Vector2` 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: Vector2): (a: Vector2) => boolean;
+};
+declare const make: {
+  /**
+   * Creates a new `Vector2` instance.
+   *
+   * @param xy - The x and y components of the vector.
+   * @returns A new `Vector2` instance.
+   * @since 1.0.0
+   */
+  (xy: number): Vector2;
+  /**
+   * Creates a new `Vector2` instance.
+   *
+   * @param x - The x component of the vector.
+   * @param y - The y component of the vector.
+   * @returns A new `Vector2` instance.
+   * @since 1.0.0
+   */
+  (x: number, y: number): Vector2;
+};
+/**
+ * Transposes a 2-tuple of items into one or more `Vector2`s, one per channel
+ * extracted by the projection function. See {@link Vector4.transpose} for the
+ * full operation description; this is the 2-component analog.
+ *
+ * @param inputs - Exactly two items of any type.
+ * @param project - A function returning a fixed-arity tuple of numbers — one per output channel.
+ * @returns A tuple of `Vector2`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], project: (item: T) => Channels) => { readonly [K in keyof Channels]: Vector2 };
+/**
+ * Creates a new `Vector2` instance from polar coordinates.
+ *
+ * @param r - The radius.
+ * @param theta - The angle, in radians.
+ * @returns A new `Vector2` instance.
+ * @since 1.0.0
+ */
+declare const fromPolar: (r: number, theta: number) => Vector2;
+/**
+ * Calculates the magnitude of a `Vector2`.
+ *
+ * @param vector - The vector to calculate the magnitude of.
+ * @returns The magnitude of the vector.
+ * @since 1.0.0
+ */
+declare const magnitude: (vector: Vector2) => number;
+/**
+ * Normalizes a `Vector2`.
+ *
+ * @param vector - The vector to normalize.
+ * @returns A new `Vector2` instance with the same direction and a magnitude of 1.
+ * @since 1.0.0
+ */
+declare const normalize: (vector: Vector2) => Vector2;
+declare const dot: {
+  /**
+   * Calculates the dot product of two `Vector2` instances.
+   *
+   * @param a - The first vector.
+   * @param b - The second vector.
+   * @returns The dot product of the two vectors.
+   * @since 1.0.0
+   */
+  (a: Vector2, b: Vector2): number;
+  /**
+   * Calculates the dot product of two `Vector2` instances.
+   *
+   * @param b - The second vector.
+   * @returns A function that takes the first vector and returns the dot product.
+   * @since 1.0.0
+   */
+  (b: Vector2): (a: Vector2) => number;
+};
+declare const cross: {
+  /**
+   * Calculates the cross product of two `Vector2` instances.
+   *
+   * @param a - The first vector.
+   * @param b - The second vector.
+   * @returns The cross product of the two vectors.
+   * @since 1.0.0
+   */
+  (a: Vector2, b: Vector2): number;
+  /**
+   * Calculates the cross product of two `Vector2` instances.
+   *
+   * @param b - The second vector.
+   * @returns A function that takes the first vector and returns the cross product.
+   * @since 1.0.0
+   */
+  (b: Vector2): (a: Vector2) => number;
+};
+/**
+ * Returns the components of a `Vector2` as an array.
+ *
+ * @param r - The radius.
+ * @param theta - The angle, in radians.
+ * @returns A new `Vector2` instance.
+ * @since 1.0.0
+ */
+declare const components: (v: Vector2) => [number, number];
+/**
+ * Applies the softmax function to a `Vector2`.
+ *
+ * @param v - The vector to apply the softmax function to.
+ * @returns A new `Vector2` instance with the softmax applied.
+ * @since 1.0.0
+ */
+declare const softmax: (v: Vector2) => Vector2;
+/**
+ * Creates a zero vector.
+ *
+ * @returns A new `Vector2` instance with both components set to 0.
+ * @since 1.0.0
+ */
+declare const zero: Vector2;
+/**
+ * Creates a unit vector.
+ *
+ * @returns A new `Vector2` instance with both components set to 1.
+ * @since 1.0.0
+ */
+declare const unit: Vector2;
+declare const add: {
+  /**
+   * Adds two `Vector2` instances together.
+   *
+   * @param a - The first vector.
+   * @param b - The second vector.
+   * @returns A new `Vector2` instance representing the sum of the two vectors.
+   * @since 1.0.0
+   */
+  (a: Vector2, b: Vector2): Vector2;
+  /**
+   * Adds two `Vector2` instances together.
+   *
+   * @param b - The second vector.
+   * @returns A function that takes the first vector and returns the sum.
+   * @since 1.0.0
+   */
+  (b: Vector2): (a: Vector2) => Vector2;
+};
+declare const subtract: {
+  /**
+   * Subtracts one `Vector2` instance from another.
+   *
+   * @param a - The first vector.
+   * @param b - The second vector.
+   * @returns A new `Vector2` instance representing the difference of the two vectors.
+   * @since 1.0.0
+   */
+  (a: Vector2, b: Vector2): Vector2;
+  /**
+   * Subtracts one `Vector2` instance from another.
+   *
+   * @param b - The second vector.
+   * @returns A function that takes the first vector and returns the difference.
+   * @since 1.0.0
+   */
+  (b: Vector2): (a: Vector2) => Vector2;
+};
+declare const hadamard: {
+  /**
+   * Performs the Hadamard product of two `Vector2` instances.
+   *
+   * @param a - The first vector.
+   * @param b - The second vector.
+   * @returns A new `Vector2` instance representing the Hadamard product of the two vectors.
+   * @since 1.0.0
+   */
+  (a: Vector2, b: Vector2): Vector2;
+  /**
+   * Performs the Hadamard product of two `Vector2` instances.
+   *
+   * @param b - The second vector.
+   * @returns A function that takes the first vector and returns the Hadamard product.
+   * @since 1.0.0
+   */
+  (b: Vector2): (a: Vector2) => Vector2;
+};
+declare const scale: {
+  /**
+   * Scales a `Vector2` by a scalar value.
+   *
+   * @param s - The scalar value to scale by.
+   * @returns A function that takes a vector and returns the scaled vector.
+   * @since 1.0.0
+   */
+  (s: number): (v: Vector2) => Vector2;
+  /**
+   * Scales a `Vector2` by a scalar value.
+   *
+   * @param v - The vector to scale.
+   * @param s - The scalar value to scale by.
+   * @returns A new `Vector2` instance representing the scaled vector.
+   * @since 1.0.0
+   */
+  (v: Vector2, s: number): Vector2;
+};
+/**
+ * Gets the x component of a `Vector2`.
+ *
+ * @param v - The vector to get the x component from.
+ * @returns The x component of the vector.
+ * @since 1.0.0
+ */
+declare const getX: (v: Vector2) => number;
+declare const setX: {
+  /**
+   * Sets the x component of a `Vector2`.
+   *
+   * @param v - The vector to set the x component of.
+   * @param x - The new x component.
+   * @returns A new `Vector2` instance with the updated x component.
+   * @since 1.0.0
+   */
+  (v: Vector2, x: number): Vector2;
+  /**
+   * Sets the x component of a `Vector2`.
+   *
+   * @param x - The new x component.
+   * @returns A function that takes a vector and returns the updated vector.
+   * @since 1.0.0
+   */
+  (x: number): (v: Vector2) => Vector2;
+};
+/**
+ * Gets the y component of a `Vector2`.
+ *
+ * @param v - The vector to get the y component from.
+ * @returns The y component of the vector.
+ * @since 1.0.0
+ */
+declare const getY: (v: Vector2) => number;
+declare const setY: {
+  /**
+   * Sets the y component of a `Vector2`.
+   *
+   * @param v - The vector to set the y component of.
+   * @param y - The new y component.
+   * @returns A new `Vector2` instance with the updated y component.
+   * @since 1.0.0
+   */
+  (v: Vector2, y: number): Vector2;
+  /**
+   * Sets the y component of a `Vector2`.
+   *
+   * @param y - The new y component.
+   * @returns A function that takes a vector and returns the updated vector.
+   * @since 1.0.0
+   */
+  (y: number): (v: Vector2) => Vector2;
+};
+/**
+ * Gets the radius of a `Vector2`.
+ *
+ * @param v - The vector to get the radius from.
+ * @returns The radius of the vector.
+ * @since 1.0.0
+ */
+declare const getR: (v: Vector2) => number;
+declare const setR: {
+  /**
+   * Sets the radius of a `Vector2`.
+   *
+   * @param v - The vector to set the radius of.
+   * @param r - The new radius.
+   * @returns A new `Vector2` instance with the updated radius.
+   * @since 1.0.0
+   */
+  (v: Vector2, r: number): Vector2;
+  /**
+   * Sets the radius of a `Vector2`.
+   *
+   * @param r - The new radius.
+   * @returns A function that takes a vector and returns the updated vector.
+   * @since 1.0.0
+   */
+  (r: number): (v: Vector2) => Vector2;
+};
+/**
+ * Gets the angle of a `Vector2`.
+ *
+ * @param v - The vector to get the angle from.
+ * @returns The angle of the vector in radians.
+ * @since 1.0.0
+ */
+declare const getTheta: (v: Vector2) => number;
+declare const setTheta: {
+  /**
+   * Sets the angle of a `Vector2`.
+   *
+   * @param v - The vector to set the angle of.
+   * @param theta - The new angle, in radians.
+   * @returns A new `Vector2` instance with the updated angle.
+   * @since 1.0.0
+   */
+  (v: Vector2, theta: number): Vector2;
+  /**
+   * Sets the angle of a `Vector2`.
+   *
+   * @param theta - The new angle, in radians.
+   * @returns A function that takes a vector and returns the updated vector.
+   * @since 1.0.0
+   */
+  (theta: number): (v: Vector2) => Vector2;
+};
+//#endregion
+export { vector3_d_exports as a, FourDimensionalComponent as c, ThreeDimensionalIndex as d, TwoDimensional as f, Vector3 as i, FourDimensionalIndex as l, TwoDimensionalIndex as m, Weighted as n, Vector4 as o, TwoDimensionalComponent as p, vector2_d_exports as r, vector4_d_exports as s, Vector2 as t, ThreeDimensionalComponent as u };
+//# sourceMappingURL=vector2-TV0UnlxY.d.mts.map