tuning-core 1.0.3 → 1.2.0

package/dist/classes/IntervalSet.d.ts

@@ -95,6 +95,15 @@ export declare class IntervalSet {
    */
     toSweepIntervals(): Fraction[];
     minMax(min: FractionInput, max: FractionInput): this;
+    /**
+   * Fill gaps between consecutive intervals by adding new intervals per gap,
+   * equally spaced in logarithmic (ratio) space. Adds at least 3 new intervals per gap.
+   * When maxGapCents is provided, subdivides further so each part is ≤ maxGapCents.
+   *
+   * @param maxGapCents - Optional maximum gap in cents. When set, each subdivision is ≤ this value.
+   * @returns this (for chaining)
+   */
+    interpolateLog(maxGapCents?: number): this;
     /**
      * Generate all unique ratios between min and max with denominators up to maxDenominator.
      *

package/dist/classes/IntervalSet.js

@@ -182,6 +182,33 @@ export class IntervalSet {
         }
         return this;
     }
+    /**
+   * Fill gaps between consecutive intervals by adding new intervals per gap,
+   * equally spaced in logarithmic (ratio) space. Adds at least 3 new intervals per gap.
+   * When maxGapCents is provided, subdivides further so each part is ≤ maxGapCents.
+   *
+   * @param maxGapCents - Optional maximum gap in cents. When set, each subdivision is ≤ this value.
+   * @returns this (for chaining)
+   */
+    interpolateLog(maxGapCents) {
+        if (maxGapCents !== undefined && maxGapCents <= 0) {
+            throw new Error("maxGapCents must be a positive number");
+        }
+        const ratios = this.getRatios();
+        for (let i = 0; i < ratios.length - 1; i++) {
+            const left = ratios[i].valueOf();
+            const right = ratios[i + 1].valueOf();
+            const gapRatio = right / left;
+            const gapCents = 1200 * Math.log2(gapRatio);
+            const n = Math.max(4, Math.ceil(gapCents / (maxGapCents ?? gapCents)));
+            for (let k = 1; k < n; k++) {
+                const num = left * Math.pow(gapRatio, k / n);
+                const rounded = Math.round(num * 10000) / 10000;
+                this.add(rounded);
+            }
+        }
+        return this;
+    }
     /**
      * Generate all unique ratios between min and max with denominators up to maxDenominator.
      *

package/dist/lib/utils.d.ts

@@ -4,14 +4,14 @@ import type { HarmonicData } from './types';
  * Convert a frequency ratio to cents.
  * @param ratio - The ratio as FractionInput (number, string, array, object, or Fraction)
  * @param places - Number of decimal places to round to (default: 0, no decimals)
- * @returns The ratio in cents (1200 * log2(ratio)), rounded to the specified number of decimals
+ * @returns The ratio in cents (1200 * log2(ratio)), rounded to the specified number of decimals (default 0, no decimals 3/2 = 702 cents)
  */
 export declare function ratioToCents(ratio: FractionInput, places?: number): Fraction;
 /**
  * Convert cents to a frequency ratio.
  * @param cents - The interval in cents as FractionInput (number, string, array, object, or Fraction)
  * @param places - Number of decimal places to round to (default: 0, no decimals)
- * @returns The ratio as a Fraction object (2^(cents/1200)), rounded to the specified number of decimals
+ * @returns The ratio as a Fraction object (2^(cents/1200)), rounded to the specified number of decimals before contertion to fraction (default 3 decimals, 702 cents = 3/2)
  */
 export declare function centsToRatio(cents: FractionInput, places?: number): Fraction;
 /**

package/dist/lib/utils.js

@@ -6,7 +6,7 @@ function round(num, places = 0) {
  * Convert a frequency ratio to cents.
  * @param ratio - The ratio as FractionInput (number, string, array, object, or Fraction)
  * @param places - Number of decimal places to round to (default: 0, no decimals)
- * @returns The ratio in cents (1200 * log2(ratio)), rounded to the specified number of decimals
+ * @returns The ratio in cents (1200 * log2(ratio)), rounded to the specified number of decimals (default 0, no decimals 3/2 = 702 cents)
  */
 export function ratioToCents(ratio, places = 0) {
     const val = new Fraction(ratio).valueOf();
@@ -18,9 +18,9 @@ export function ratioToCents(ratio, places = 0) {
  * Convert cents to a frequency ratio.
  * @param cents - The interval in cents as FractionInput (number, string, array, object, or Fraction)
  * @param places - Number of decimal places to round to (default: 0, no decimals)
- * @returns The ratio as a Fraction object (2^(cents/1200)), rounded to the specified number of decimals
+ * @returns The ratio as a Fraction object (2^(cents/1200)), rounded to the specified number of decimals before contertion to fraction (default 3 decimals, 702 cents = 3/2)
  */
-export function centsToRatio(cents, places = 0) {
+export function centsToRatio(cents, places = 3) {
     const val = new Fraction(cents).valueOf();
     const num = Math.pow(2, val / 1200);
     const rounded = round(num, places);

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "tuning-core",
-    "version": "1.0.3",
+    "version": "1.2.0",
     "type": "module",
     "module": "dist/index.js",
     "main": "dist/index.js",