import type { ThreeDimensional } from '../dimensions.ts';
import type { Pipeable } from '../utils.ts';
import type { Vector3TypeId } from './vector3.internal.ts';
/**
 * A 3D vector.
 *
 * All fields are readonly and immutable, and all operations create new instances.
 *
 * @since 1.0.0
 */
export 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
 */
export declare const isVector3: (v: unknown) => v is Vector3;
export 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;
};
export 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;
};
/**
 * Creates a new `Vector3` instance from a `[x, y, z]` tuple. Inverse of
 * {@link components}.
 *
 * @param t - The `[x, y, z]` tuple.
 * @returns A new `Vector3` instance.
 * @since 2.0.0
 */
export declare const fromTuple: (t: readonly [number, number, 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.0.0
 */
export 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
 */
export 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
 */
export 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
 */
export 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
 */
export declare const normalize: (vector: Vector3) => Vector3;
export 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;
};
export 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
 */
export 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
 */
export declare const softmax: (v: Vector3) => Vector3;
/**
 * Creates a zero vector.
 *
 * @since 1.0.0
 */
export declare const zero: Vector3;
/**
 * Creates a unit vector.
 *
 * @since 1.0.0
 */
export declare const unit: Vector3;
/**
 * Creates a unit vector in the x direction.
 *
 * @since 1.0.0
 */
export declare const unitX: Vector3;
/**
 * Creates a unit vector in the y direction.
 *
 * @since 1.0.0
 */
export declare const unitY: Vector3;
/**
 * Creates a unit vector in the z direction.
 *
 * @since 1.0.0
 */
export declare const unitZ: Vector3;
export 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;
};
export 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;
};
export 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;
};
export 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
 */
export declare const getX: (v: Vector3) => number;
export 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;
};
export declare const mapX: {
    /**
     * Returns a new `Vector3` with the x component replaced by `f(v.x)`.
     *
     * @param v - The vector to update.
     * @param f - The function to apply to the x component.
     * @returns A new `Vector3` with the updated x.
     * @since 2.0.0
     */
    (v: Vector3, f: (x: number) => number): Vector3;
    /**
     * Returns a new `Vector3` with the x component replaced by `f(v.x)`.
     *
     * @param f - The function to apply to the x component.
     * @returns A function that takes a vector and returns the updated vector.
     * @since 2.0.0
     */
    (f: (x: number) => 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
 */
export declare const getY: (v: Vector3) => number;
export 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;
};
export declare const mapY: {
    /**
     * Returns a new `Vector3` with the y component replaced by `f(v.y)`.
     *
     * @param v - The vector to update.
     * @param f - The function to apply to the y component.
     * @returns A new `Vector3` with the updated y.
     * @since 2.0.0
     */
    (v: Vector3, f: (y: number) => number): Vector3;
    /**
     * Returns a new `Vector3` with the y component replaced by `f(v.y)`.
     *
     * @param f - The function to apply to the y component.
     * @returns A function that takes a vector and returns the updated vector.
     * @since 2.0.0
     */
    (f: (y: number) => 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
 */
export declare const getZ: (v: Vector3) => number;
export 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;
};
export declare const mapZ: {
    /**
     * Returns a new `Vector3` with the z component replaced by `f(v.z)`.
     *
     * @param v - The vector to update.
     * @param f - The function to apply to the z component.
     * @returns A new `Vector3` with the updated z.
     * @since 2.0.0
     */
    (v: Vector3, f: (z: number) => number): Vector3;
    /**
     * Returns a new `Vector3` with the z component replaced by `f(v.z)`.
     *
     * @param f - The function to apply to the z component.
     * @returns A function that takes a vector and returns the updated vector.
     * @since 2.0.0
     */
    (f: (z: number) => 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
 */
export declare const getR: (v: Vector3) => number;
export 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;
};
export declare const mapR: {
    /**
     * Returns a new `Vector3` with the radius replaced by `f(magnitude(v))`,
     * preserving direction.
     *
     * @param v - The vector to update.
     * @param f - The function to apply to the radius.
     * @returns A new `Vector3` with the updated radius.
     * @since 2.0.0
     */
    (v: Vector3, f: (r: number) => number): Vector3;
    /**
     * Returns a new `Vector3` with the radius replaced by `f(magnitude(v))`,
     * preserving direction.
     *
     * @param f - The function to apply to the radius.
     * @returns A function that takes a vector and returns the updated vector.
     * @since 2.0.0
     */
    (f: (r: number) => 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
 */
export declare const getTheta: (v: Vector3) => number;
export 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;
};
export declare const mapTheta: {
    /**
     * Returns a new `Vector3` with the polar angle replaced by
     * `f(getTheta(v))`.
     *
     * @param v - The vector to update.
     * @param f - The function to apply to the polar angle (in radians).
     * @returns A new `Vector3` with the updated polar angle.
     * @since 2.0.0
     */
    (v: Vector3, f: (theta: number) => number): Vector3;
    /**
     * Returns a new `Vector3` with the polar angle replaced by
     * `f(getTheta(v))`.
     *
     * @param f - The function to apply to the polar angle (in radians).
     * @returns A function that takes a vector and returns the updated vector.
     * @since 2.0.0
     */
    (f: (theta: number) => 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
 */
export declare const getPhi: (v: Vector3) => number;
export 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;
};
export declare const mapPhi: {
    /**
     * Returns a new `Vector3` with the azimuthal angle replaced by
     * `f(getPhi(v))`.
     *
     * @param v - The vector to update.
     * @param f - The function to apply to the azimuthal angle (in radians).
     * @returns A new `Vector3` with the updated azimuthal angle.
     * @since 2.0.0
     */
    (v: Vector3, f: (phi: number) => number): Vector3;
    /**
     * Returns a new `Vector3` with the azimuthal angle replaced by
     * `f(getPhi(v))`.
     *
     * @param f - The function to apply to the azimuthal angle (in radians).
     * @returns A function that takes a vector and returns the updated vector.
     * @since 2.0.0
     */
    (f: (phi: number) => number): (v: Vector3) => Vector3;
};