superjs-core 0.2.0 → 0.3.1

package/dist/io/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/io/index.ts"],"sourcesContent":["/**\n * Options for CSV parsing.\n */\nexport interface CsvOptions {\n  delimiter?: string\n  header?: boolean\n  skipEmptyLines?: boolean\n}\n\n/**\n * Parses a CSV string into an array of records (objects).\n *\n * @param input - CSV string\n * @param options - Optional parsing options\n */\nexport function parseCsv(input: string, options?: CsvOptions): Record<string, string>[] {\n  const { delimiter = ',', header = true, skipEmptyLines = true } = options ?? {}\n\n  const lines = input.split(/\\r?\\n/)\n  const rows: string[][] = []\n\n  for (const line of lines) {\n    const trimmed = line.trim()\n    if (skipEmptyLines && trimmed.length === 0) continue\n    const values = parseCsvLine(trimmed, delimiter)\n    rows.push(values)\n  }\n\n  if (rows.length === 0) return []\n\n  if (header) {\n    const [head, ...body] = rows\n    if (head === undefined) return []\n    return body.map(row => {\n      const record: Record<string, string> = {}\n      for (let i = 0; i < head.length; i++) {\n        record[head[i]!] = row[i] ?? ''\n      }\n      return record\n    })\n  }\n\n  return rows.map(row => {\n    const record: Record<string, string> = {}\n    for (let i = 0; i < row.length; i++) {\n      record[String(i)] = row[i]!\n    }\n    return record\n  })\n}\n\nfunction parseCsvLine(line: string, delimiter: string): string[] {\n  const result: string[] = []\n  let current = ''\n  let inQuotes = false\n\n  for (let i = 0; i < line.length; i++) {\n    const ch = line[i]!\n    if (inQuotes) {\n      if (ch === '\"') {\n        if (line[i + 1] === '\"') {\n          current += '\"'\n          i++\n        } else {\n          inQuotes = false\n        }\n      } else {\n        current += ch\n      }\n    } else {\n      if (ch === '\"') {\n        inQuotes = true\n      } else if (ch === delimiter) {\n        result.push(current)\n        current = ''\n      } else {\n        current += ch\n      }\n    }\n  }\n  result.push(current)\n  return result\n}\n\n/**\n * Converts an array of records to a CSV string.\n */\nexport function stringifyCsv(data: Record<string, unknown>[], options?: { delimiter?: string }): string {\n  const { delimiter = ',' } = options ?? {}\n  if (data.length === 0) return ''\n\n  const headers = Object.keys(data[0]!)\n  const lines: string[] = [headers.map(v => escapeCsvField(v, delimiter)).join(delimiter)]\n\n  for (const record of data) {\n    const row = headers.map(h => escapeCsvField(String(record[h] ?? ''), delimiter))\n    lines.push(row.join(delimiter))\n  }\n\n  return lines.join('\\n')\n}\n\nfunction escapeCsvField(value: string, delimiter: string): string {\n  if (value.includes('\"') || value.includes(delimiter) || value.includes('\\n') || value.includes('\\r')) {\n    return '\"' + value.replace(/\"/g, '\"\"') + '\"'\n  }\n  return value\n}\n\n/**\n * Safely parses a JSON string, returning the default value or null on failure.\n */\nexport function safeJsonParse<T>(input: string, default_?: T): T | null {\n  try {\n    return JSON.parse(input) as T\n  } catch {\n    return default_ ?? null\n  }\n}\n\n/**\n * Reads an environment variable with optional default.\n */\nexport function env(name: string, default_?: string): string {\n  const value = process.env[name]\n  return value ?? default_ ?? ''\n}\n\n/**\n * Reads an environment variable as an integer.\n */\nexport function envInt(name: string, default_?: number): number {\n  const value = process.env[name]\n  if (value === undefined || value === '') return default_ ?? 0\n  const parsed = Number.parseInt(value, 10)\n  return Number.isNaN(parsed) ? (default_ ?? 0) : parsed\n}\n\n/**\n * Reads an environment variable as a boolean.\n */\nexport function envBool(name: string, default_?: boolean): boolean {\n  const value = process.env[name]\n  if (value === undefined || value === '') return default_ ?? false\n  return value === 'true' || value === '1' || value === 'yes'\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/io/index.ts"],"sourcesContent":["/**\r\n * Options for CSV parsing.\r\n */\r\nexport interface CsvOptions {\r\n  delimiter?: string\r\n  header?: boolean\r\n  skipEmptyLines?: boolean\r\n}\r\n\r\n/**\r\n * Parses a CSV string into an array of records (objects).\r\n *\r\n * @param input - CSV string\r\n * @param options - Optional parsing options\r\n */\r\nexport function parseCsv(input: string, options?: CsvOptions): Record<string, string>[] {\r\n  const { delimiter = ',', header = true, skipEmptyLines = true } = options ?? {}\r\n\r\n  const lines = input.split(/\\r?\\n/)\r\n  const rows: string[][] = []\r\n\r\n  for (const line of lines) {\r\n    const trimmed = line.trim()\r\n    if (skipEmptyLines && trimmed.length === 0) continue\r\n    const values = parseCsvLine(trimmed, delimiter)\r\n    rows.push(values)\r\n  }\r\n\r\n  if (rows.length === 0) return []\r\n\r\n  if (header) {\r\n    const [head, ...body] = rows\r\n    if (head === undefined) return []\r\n    return body.map(row => {\r\n      const record: Record<string, string> = {}\r\n      for (let i = 0; i < head.length; i++) {\r\n        record[head[i]!] = row[i] ?? ''\r\n      }\r\n      return record\r\n    })\r\n  }\r\n\r\n  return rows.map(row => {\r\n    const record: Record<string, string> = {}\r\n    for (let i = 0; i < row.length; i++) {\r\n      record[String(i)] = row[i]!\r\n    }\r\n    return record\r\n  })\r\n}\r\n\r\nfunction parseCsvLine(line: string, delimiter: string): string[] {\r\n  const result: string[] = []\r\n  let current = ''\r\n  let inQuotes = false\r\n\r\n  for (let i = 0; i < line.length; i++) {\r\n    const ch = line[i]!\r\n    if (inQuotes) {\r\n      if (ch === '\"') {\r\n        if (line[i + 1] === '\"') {\r\n          current += '\"'\r\n          i++\r\n        } else {\r\n          inQuotes = false\r\n        }\r\n      } else {\r\n        current += ch\r\n      }\r\n    } else {\r\n      if (ch === '\"') {\r\n        inQuotes = true\r\n      } else if (ch === delimiter) {\r\n        result.push(current)\r\n        current = ''\r\n      } else {\r\n        current += ch\r\n      }\r\n    }\r\n  }\r\n  result.push(current)\r\n  return result\r\n}\r\n\r\n/**\r\n * Converts an array of records to a CSV string.\r\n */\r\nexport function stringifyCsv(data: Record<string, unknown>[], options?: { delimiter?: string }): string {\r\n  const { delimiter = ',' } = options ?? {}\r\n  if (data.length === 0) return ''\r\n\r\n  const headers = Object.keys(data[0]!)\r\n  const lines: string[] = [headers.map(v => escapeCsvField(v, delimiter)).join(delimiter)]\r\n\r\n  for (const record of data) {\r\n    const row = headers.map(h => escapeCsvField(String(record[h] ?? ''), delimiter))\r\n    lines.push(row.join(delimiter))\r\n  }\r\n\r\n  return lines.join('\\n')\r\n}\r\n\r\nfunction escapeCsvField(value: string, delimiter: string): string {\r\n  if (value.includes('\"') || value.includes(delimiter) || value.includes('\\n') || value.includes('\\r')) {\r\n    return '\"' + value.replace(/\"/g, '\"\"') + '\"'\r\n  }\r\n  return value\r\n}\r\n\r\n/**\r\n * Safely parses a JSON string, returning the default value or null on failure.\r\n */\r\nexport function safeJsonParse<T>(input: string, default_?: T): T | null {\r\n  try {\r\n    return JSON.parse(input) as T\r\n  } catch {\r\n    return default_ ?? null\r\n  }\r\n}\r\n\r\n/**\r\n * Reads an environment variable with optional default.\r\n */\r\nexport function env(name: string, default_?: string): string {\r\n  const value = process.env[name]\r\n  return value ?? default_ ?? ''\r\n}\r\n\r\n/**\r\n * Reads an environment variable as an integer.\r\n */\r\nexport function envInt(name: string, default_?: number): number {\r\n  const value = process.env[name]\r\n  if (value === undefined || value === '') return default_ ?? 0\r\n  const parsed = Number.parseInt(value, 10)\r\n  return Number.isNaN(parsed) ? (default_ ?? 0) : parsed\r\n}\r\n\r\n/**\r\n * Reads an environment variable as a boolean.\r\n */\r\nexport function envBool(name: string, default_?: boolean): boolean {\r\n  const value = process.env[name]\r\n  if (value === undefined || value === '') return default_ ?? false\r\n  return value === 'true' || value === '1' || value === 'yes'\r\n}\r\n"],"mappings":"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","names":[]}

package/dist/math/index.d.ts

@@ -113,668 +113,5 @@ declare function randomInt(min: number, max: number): number;
  * @returns Whether the value is in range.
  */
 declare function inRange(value: number, min: number, max: number): boolean;
-/**
- * Converts radians to degrees.
- *
- * @param radians - Angle in radians.
- * @returns Angle in degrees.
- */
-declare function toDegrees(radians: number): number;
-/**
- * Converts degrees to radians.
- *
- * @param degrees - Angle in degrees.
- * @returns Angle in radians.
- */
-declare function toRadians(degrees: number): number;
-/**
- * Computes the sine of an angle.
- *
- * @param angle - The angle.
- * @param unit - Unit of the angle: `'rad'` (default) or `'deg'`.
- * @returns The sine value.
- */
-declare function sin(angle: number, unit?: 'rad' | 'deg'): number;
-/**
- * Computes the cosine of an angle.
- *
- * @param angle - The angle.
- * @param unit - Unit of the angle: `'rad'` (default) or `'deg'`.
- * @returns The cosine value.
- */
-declare function cos(angle: number, unit?: 'rad' | 'deg'): number;
-/**
- * Computes the tangent of an angle.
- *
- * @param angle - The angle.
- * @param unit - Unit of the angle: `'rad'` (default) or `'deg'`.
- * @returns The tangent value.
- */
-declare function tan(angle: number, unit?: 'rad' | 'deg'): number;
-/**
- * Computes the arcsine (inverse sine) of a value.
- *
- * @param value - A number between -1 and 1.
- * @returns The angle in radians.
- * @throws {RangeError} If value is outside [-1, 1].
- */
-declare function asin(value: number): number;
-/**
- * Computes the arccosine (inverse cosine) of a value.
- *
- * @param value - A number between -1 and 1.
- * @returns The angle in radians.
- * @throws {RangeError} If value is outside [-1, 1].
- */
-declare function acos(value: number): number;
-/**
- * Computes the arctangent (inverse tangent) of a value.
- *
- * @param value - Any real number.
- * @returns The angle in radians.
- */
-declare function atan(value: number): number;
-/**
- * Computes the angle whose tangent is the quotient of two numbers.
- *
- * @param y - The y-coordinate.
- * @param x - The x-coordinate.
- * @returns The angle in radians from the positive x-axis.
- */
-declare function atan2(y: number, x: number): number;
-/**
- * Computes the square root of the sum of squares of the arguments (hypotenuse).
- *
- * @param values - Variable number of values.
- * @returns The hypotenuse.
- */
-declare function hypot(...values: number[]): number;
-/**
- * Computes the median of a numeric array.
- *
- * @param values - Array of numbers.
- * @returns The median value.
- * @throws {RangeError} If the array is empty.
- */
-declare function median(values: number[]): number;
-/**
- * Computes the mode(s) of a numeric array.
- *
- * @param values - Array of numbers.
- * @returns Array of mode values (may be multiple).
- * @throws {RangeError} If the array is empty.
- */
-declare function mode(values: number[]): number[];
-/**
- * Computes the p-th percentile of a numeric array.
- *
- * @param values - Array of numbers.
- * @param p - Percentile between 0 and 100.
- * @returns The percentile value.
- * @throws {RangeError} If array is empty or p is out of range.
- */
-declare function percentile(values: number[], p: number): number;
-/**
- * Computes the quartiles (Q1, Q2, Q3) of a numeric array.
- *
- * @param values - Array of numbers.
- * @returns An object with q1, q2, q3.
- * @throws {RangeError} If the array is empty.
- */
-declare function quartiles(values: number[]): {
-    q1: number;
-    q2: number;
-    q3: number;
-};
-/**
- * Computes the variance of a numeric array.
- *
- * @param values - Array of numbers.
- * @param sample - If true, use sample variance (n-1). Default false.
- * @returns The variance.
- * @throws {RangeError} If array has fewer than 2 elements for sample variance.
- */
-declare function variance(values: number[], sample?: boolean): number;
-/**
- * Computes the standard deviation of a numeric array.
- *
- * @param values - Array of numbers.
- * @param sample - If true, use sample standard deviation (n-1). Default false.
- * @returns The standard deviation.
- */
-declare function stddev(values: number[], sample?: boolean): number;
-/**
- * Computes the covariance between two numeric arrays.
- *
- * @param x - First array.
- * @param y - Second array.
- * @returns The covariance.
- * @throws {RangeError} If arrays have different lengths or fewer than 2 elements.
- */
-declare function covariance(x: number[], y: number[]): number;
-/**
- * Computes the Pearson correlation coefficient between two arrays.
- *
- * @param x - First array.
- * @param y - Second array.
- * @returns The correlation coefficient between -1 and 1.
- */
-declare function correlation(x: number[], y: number[]): number;
-/**
- * Computes the sample skewness of a numeric array.
- *
- * @param values - Array of numbers.
- * @returns The skewness.
- */
-declare function skewness(values: number[]): number;
-/**
- * Computes the excess kurtosis of a numeric array.
- *
- * @param values - Array of numbers.
- * @returns The excess kurtosis (kurtosis - 3).
- */
-declare function kurtosis(values: number[]): number;
-/**
- * Computes the weighted mean of values with given weights.
- *
- * @param values - Array of numbers.
- * @param weights - Array of weights.
- * @returns The weighted mean.
- * @throws {RangeError} If arrays differ in length or weights sum to zero.
- */
-declare function weightedMean(values: number[], weights: number[]): number;
-/**
- * Computes the geometric mean of a numeric array.
- *
- * @param values - Array of positive numbers.
- * @returns The geometric mean.
- * @throws {RangeError} If array is empty or contains non-positive values.
- */
-declare function geometricMean(values: number[]): number;
-/**
- * Computes the harmonic mean of a numeric array.
- *
- * @param values - Array of positive numbers.
- * @returns The harmonic mean.
- * @throws {RangeError} If array is empty or contains non-positive values.
- */
-declare function harmonicMean(values: number[]): number;
-/**
- * Computes the z-score of a value relative to a distribution.
- *
- * @param value - The value to standardize.
- * @param mean - The mean of the distribution.
- * @param stddev - The standard deviation of the distribution.
- * @returns The z-score.
- */
-declare function zScore(value: number, mean: number, stddev: number): number;
-/**
- * Normalizes an array to [0, 1] range using min-max scaling.
- *
- * @param values - Array of numbers.
- * @returns The normalized array.
- */
-declare function normalize(values: number[]): number[];
-/**
- * Standardizes an array to have mean 0 and standard deviation 1 (z-scores).
- *
- * @param values - Array of numbers.
- * @returns The standardized array.
- */
-declare function standardize(values: number[]): number[];
-/**
- * Computes the factorial of a non-negative integer.
- *
- * @param n - Non-negative integer.
- * @returns n!.
- * @throws {RangeError} If n is negative or not an integer.
- */
-declare function factorial(n: number): number;
-/**
- * Computes the binomial coefficient "n choose k".
- *
- * @param n - Total number of items.
- * @param k - Number of items to choose.
- * @returns The binomial coefficient.
- * @throws {RangeError} If n < k or arguments are not non-negative integers.
- */
-declare function binomial(n: number, k: number): number;
-/**
- * Computes the number of permutations "n P k".
- *
- * @param n - Total number of items.
- * @param k - Number of items to arrange.
- * @returns The number of permutations.
- * @throws {RangeError} If n < k or arguments are not non-negative integers.
- */
-declare function permutation(n: number, k: number): number;
-/**
- * Computes the greatest common divisor of two or more numbers.
- *
- * @param values - Two or more integers.
- * @returns The GCD.
- * @throws {RangeError} If fewer than 2 values are provided.
- */
-declare function gcd(...values: number[]): number;
-/**
- * Computes the least common multiple of two or more numbers.
- *
- * @param values - Two or more integers.
- * @returns The LCM.
- * @throws {RangeError} If fewer than 2 values are provided.
- */
-declare function lcm(...values: number[]): number;
-/**
- * Checks if a number is prime.
- *
- * @param n - Integer to check.
- * @returns True if prime.
- */
-declare function isPrime(n: number): boolean;
-/**
- * Computes the prime factors of a number.
- *
- * @param n - Integer greater than 1.
- * @returns Array of prime factors.
- * @throws {RangeError} If n is less than 2.
- */
-declare function primeFactors(n: number): number[];
-/**
- * Computes the n-th Fibonacci number.
- *
- * @param n - Non-negative integer (0-indexed: F(0)=0, F(1)=1).
- * @returns The n-th Fibonacci number.
- * @throws {RangeError} If n is negative or not an integer.
- */
-declare function fibonacci(n: number): number;
-/**
- * Checks if a number is even.
- *
- * @param n - The number to check.
- * @returns True if even.
- */
-declare function isEven(n: number): boolean;
-/**
- * Checks if a number is odd.
- *
- * @param n - The number to check.
- * @returns True if odd.
- */
-declare function isOdd(n: number): boolean;
-/**
- * Returns the sign of a number.
- *
- * @param n - The number.
- * @returns -1 if negative, 1 if positive, 0 if zero.
- */
-declare function sign(n: number): number;
-/**
- * Represents a 2D matrix.
- */
-type Matrix = number[][];
-/**
- * Adds two matrices element-wise.
- *
- * @param a - First matrix.
- * @param b - Second matrix.
- * @returns The sum matrix.
- */
-declare function matrixAdd(a: Matrix, b: Matrix): Matrix;
-/**
- * Subtracts two matrices element-wise.
- *
- * @param a - First matrix.
- * @param b - Second matrix.
- * @returns The difference matrix.
- */
-declare function matrixSub(a: Matrix, b: Matrix): Matrix;
-/**
- * Multiplies two matrices element-wise (Hadamard product).
- *
- * @param a - First matrix.
- * @param b - Second matrix.
- * @returns The element-wise product matrix.
- */
-declare function matrixMul(a: Matrix, b: Matrix): Matrix;
-/**
- * Multiplies a matrix by a scalar.
- *
- * @param a - The matrix.
- * @param scalar - The scalar value.
- * @returns The scaled matrix.
- */
-declare function matrixScale(a: Matrix, scalar: number): Matrix;
-/**
- * Transposes a matrix (rows become columns).
- *
- * @param a - The matrix.
- * @returns The transposed matrix.
- */
-declare function matrixTranspose(a: Matrix): Matrix;
-/**
- * Computes the determinant of a square matrix (max 3x3).
- *
- * @param a - The square matrix.
- * @returns The determinant.
- */
-declare function matrixDeterminant(a: Matrix): number;
-/**
- * Computes the inverse of a square matrix (max 3x3).
- *
- * @param a - The square matrix.
- * @returns The inverse matrix.
- */
-declare function matrixInverse(a: Matrix): Matrix;
-/**
- * Creates an n x n identity matrix.
- *
- * @param n - The size of the matrix.
- * @returns The identity matrix.
- */
-declare function matrixIdentity(n: number): Matrix;
-/**
- * Multiplies two matrices using standard matrix multiplication (dot product).
- *
- * @param a - First matrix.
- * @param b - Second matrix.
- * @returns The product matrix.
- */
-declare function matrixMultiply(a: Matrix, b: Matrix): Matrix;
-/**
- * Computes the trace of a square matrix.
- *
- * @param a - The square matrix.
- * @returns The trace (sum of diagonal elements).
- */
-declare function matrixTrace(a: Matrix): number;
-/**
- * Represents a complex number with real and imaginary parts.
- */
-declare class Complex {
-    /** The real part. */
-    re: number;
-    /** The imaginary part. */
-    im: number;
-    constructor(
-    /** The real part. */
-    re: number, 
-    /** The imaginary part. */
-    im?: number);
-    /**
-     * Adds another complex number.
-     *
-     * @param other - The complex number to add.
-     * @returns A new Complex instance.
-     */
-    add(other: Complex): Complex;
-    /**
-     * Subtracts another complex number.
-     *
-     * @param other - The complex number to subtract.
-     * @returns A new Complex instance.
-     */
-    sub(other: Complex): Complex;
-    /**
-     * Multiplies by another complex number.
-     *
-     * @param other - The complex number to multiply by.
-     * @returns A new Complex instance.
-     */
-    mul(other: Complex): Complex;
-    /**
-     * Divides by another complex number.
-     *
-     * @param other - The complex number to divide by.
-     * @returns A new Complex instance.
-     * @throws {DivisionByZeroError} If the divisor is zero.
-     */
-    div(other: Complex): Complex;
-    /**
-     * Computes the magnitude (absolute value) of the complex number.
-     *
-     * @returns The magnitude.
-     */
-    abs(): number;
-    /**
-     * Computes the complex conjugate.
-     *
-     * @returns A new Complex instance with negated imaginary part.
-     */
-    conj(): Complex;
-    /**
-     * Computes the argument (phase angle) in radians.
-     *
-     * @returns The phase angle.
-     */
-    arg(): number;
-    /**
-     * Raises the complex number to a real power.
-     *
-     * @param n - The exponent.
-     * @returns A new Complex instance.
-     */
-    pow(n: number): Complex;
-    /**
-     * Computes the square root of the complex number.
-     *
-     * @returns A new Complex instance.
-     */
-    sqrt(): Complex;
-    /**
-     * Computes e raised to this complex number.
-     *
-     * @returns A new Complex instance.
-     */
-    exp(): Complex;
-    /**
-     * Computes the natural logarithm of the complex number.
-     *
-     * @returns A new Complex instance.
-     */
-    log(): Complex;
-    /**
-     * Computes the sine of the complex number.
-     *
-     * @returns A new Complex instance.
-     */
-    sin(): Complex;
-    /**
-     * Computes the cosine of the complex number.
-     *
-     * @returns A new Complex instance.
-     */
-    cos(): Complex;
-    /**
-     * Returns a string representation of the complex number.
-     *
-     * @returns String like "a + bi".
-     */
-    toString(): string;
-    /**
-     * Creates a complex number from polar coordinates.
-     *
-     * @param r - The magnitude.
-     * @param theta - The angle in radians.
-     * @returns A new Complex instance.
-     */
-    static fromPolar(r: number, theta: number): Complex;
-    /** The real part. */
-    get real(): number;
-    /** The imaginary part. */
-    get imag(): number;
-}
-/**
- * Computes compound interest.
- *
- * @param principal - Initial amount.
- * @param rate - Annual interest rate (decimal, e.g. 0.05 for 5%).
- * @param time - Time in years.
- * @param n - Number of compounding periods per year (default 12).
- * @returns The future value including interest.
- */
-declare function compoundInterest(principal: number, rate: number, time: number, n?: number): number;
-/**
- * Computes the future value of a present sum.
- *
- * @param pv - Present value.
- * @param rate - Periodic interest rate.
- * @param nper - Number of periods.
- * @returns Future value.
- */
-declare function futureValue(pv: number, rate: number, nper: number): number;
-/**
- * Computes the present value of a future sum.
- *
- * @param fv - Future value.
- * @param rate - Periodic interest rate.
- * @param nper - Number of periods.
- * @returns Present value.
- */
-declare function presentValue(fv: number, rate: number, nper: number): number;
-/**
- * Computes the periodic payment for a loan (PMT).
- *
- * @param rate - Periodic interest rate.
- * @param nper - Total number of payments.
- * @param pv - Present value (loan amount).
- * @param fv - Future value (default 0).
- * @returns The periodic payment amount.
- */
-declare function pmt(rate: number, nper: number, pv: number, fv?: number): number;
-/**
- * Computes the net present value (NPV) of cashflows.
- *
- * @param rate - Discount rate per period.
- * @param cashflows - Array of cashflow values (negative for outflows).
- * @returns The net present value.
- */
-declare function npv(rate: number, cashflows: number[]): number;
-/**
- * Computes the internal rate of return (IRR) of cashflows using Newton's method.
- *
- * @param cashflows - Array of cashflow values.
- * @returns The IRR as a decimal.
- */
-declare function irr(cashflows: number[]): number;
-/**
- * Computes the return on investment (ROI).
- *
- * @param gain - The gain from the investment.
- * @param cost - The cost of the investment.
- * @returns The ROI as a decimal.
- */
-declare function roi(gain: number, cost: number): number;
-/**
- * Generates an amortization schedule for a loan.
- *
- * @param principal - Loan amount.
- * @param rate - Periodic interest rate.
- * @param nper - Total number of payments.
- * @returns Array of period details.
- */
-declare function amortizationSchedule(principal: number, rate: number, nper: number): {
-    period: number;
-    payment: number;
-    interest: number;
-    principal: number;
-    balance: number;
-}[];
-/**
- * Generates a random number from a normal (Gaussian) distribution.
- *
- * @param mean - The mean (default 0).
- * @param stddev - The standard deviation (default 1).
- * @returns A normally distributed random number.
- */
-declare function randomNormal(mean?: number, stddev?: number): number;
-/**
- * Generates a random number from a Poisson distribution.
- *
- * @param lambda - The rate parameter (mean).
- * @returns A Poisson-distributed random integer.
- */
-declare function randomPoisson(lambda: number): number;
-/**
- * Generates a random number from a binomial distribution.
- *
- * @param n - Number of trials.
- * @param p - Probability of success per trial.
- * @returns Number of successes.
- */
-declare function randomBinomial(n: number, p: number): number;
-/**
- * Generates a random number from an exponential distribution.
- *
- * @param lambda - The rate parameter.
- * @returns An exponentially distributed random number.
- */
-declare function randomExponential(lambda: number): number;
-/**
- * Generates a random number from a uniform distribution.
- *
- * @param min - Lower bound (default 0).
- * @param max - Upper bound (default 1).
- * @returns A uniformly distributed random number.
- */
-declare function randomUniform(min?: number, max?: number): number;
-/**
- * Computes the numerical derivative of a function at a point.
- *
- * @param f - The function.
- * @param x - The point to evaluate at.
- * @param h - Step size (default 1e-10).
- * @returns The derivative value.
- */
-declare function derivative(f: (x: number) => number, x: number, h?: number): number;
-/**
- * Computes the definite integral of a function using Simpson's rule.
- *
- * @param f - The function to integrate.
- * @param a - Lower bound.
- * @param b - Upper bound.
- * @param n - Number of subintervals (must be even, default 100).
- * @returns The approximate integral value.
- */
-declare function integral(f: (x: number) => number, a: number, b: number, n?: number): number;
-/**
- * Computes the definite integral using the trapezoidal rule.
- *
- * @param f - The function to integrate.
- * @param a - Lower bound.
- * @param b - Upper bound.
- * @param n - Number of subintervals (default 100).
- * @returns The approximate integral value.
- */
-declare function trapezoidal(f: (x: number) => number, a: number, b: number, n?: number): number;
-/**
- * Finds a root of a function using Newton's method.
- *
- * @param f - The function.
- * @param guess - Initial guess.
- * @param tolerance - Convergence tolerance (default 1e-7).
- * @param maxIter - Maximum iterations (default 100).
- * @returns The root value, or NaN if not converged.
- */
-declare function newtonRoot(f: (x: number) => number, guess: number, tolerance?: number, maxIter?: number): number;
-/**
- * Linearly interpolates between two values.
- *
- * @param a - Start value.
- * @param b - End value.
- * @param t - Interpolation factor (0 to 1).
- * @returns The interpolated value.
- */
-declare function lerp(a: number, b: number, t: number): number;
-/**
- * Maps a value from one range to another.
- *
- * @param value - The input value.
- * @param inMin - Input range minimum.
- * @param inMax - Input range maximum.
- * @param outMin - Output range minimum.
- * @param outMax - Output range maximum.
- * @returns The mapped value.
- */
-declare function mapRange(value: number, inMin: number, inMax: number, outMin: number, outMax: number): number;
 
-export { Complex, DivisionByZeroError, type Matrix, acos, add, amortizationSchedule, approxEqual, asin, atan, atan2, average, binomial, ceil, clamp, compoundInterest, correlation, cos, covariance, derivative, div, factorial, fibonacci, floor, futureValue, gcd, geometricMean, harmonicMean, hypot, inRange, integral, irr, isEven, isOdd, isPrime, kurtosis, lcm, lerp, mapRange, matrixAdd, matrixDeterminant, matrixIdentity, matrixInverse, matrixMul, matrixMultiply, matrixScale, matrixSub, matrixTrace, matrixTranspose, median, mode, mul, newtonRoot, normalize, npv, percentile, permutation, pmt, presentValue, primeFactors, quartiles, randomBinomial, randomExponential, randomInt, randomNormal, randomPoisson, randomUniform, roi, round, sign, sin, skewness, standardize, stddev, sub, sum, tan, toDegrees, toRadians, trapezoidal, variance, weightedMean, zScore };
+export { DivisionByZeroError, add, approxEqual, average, ceil, clamp, div, floor, inRange, mul, randomInt, round, sub, sum };