import { logger } from './logger.mjs'; // currently duplicate with core util.mjs to skip dependency // TODO: add separate util module? export const tokenizeNote = (note) => { if (typeof note !== 'string') { return []; } const [pc, acc = '', oct] = note.match(/^([a-gA-G])([#bsf]*)([0-9]*)$/)?.slice(1) || []; if (!pc) { return []; } return [pc, acc, oct ? Number(oct) : undefined]; }; const chromas = { c: 0, d: 2, e: 4, f: 5, g: 7, a: 9, b: 11 }; const accs = { '#': 1, b: -1, s: 1, f: -1 }; export const noteToMidi = (note, defaultOctave = 3) => { const [pc, acc, oct = defaultOctave] = tokenizeNote(note); if (!pc) { throw new Error('not a note: "' + note + '"'); } const chroma = chromas[pc.toLowerCase()]; const offset = acc?.split('').reduce((o, char) => o + accs[char], 0) || 0; return (Number(oct) + 1) * 12 + chroma + offset; }; export const midiToFreq = (n) => { return Math.pow(2, (n - 69) / 12) * 440; }; export const clamp = (num, min, max) => Math.min(Math.max(num, min), max); export const freqToMidi = (freq) => { return (12 * Math.log(freq / 440)) / Math.LN2 + 69; }; export const valueToMidi = (value, fallbackValue) => { if (typeof value !== 'object') { throw new Error('valueToMidi: expected object value'); } let { freq, note } = value; if (typeof freq === 'number') { return freqToMidi(freq); } if (typeof note === 'string') { return noteToMidi(note); } if (typeof note === 'number') { return note; } if (!fallbackValue) { throw new Error('valueToMidi: expected freq or note to be set'); } return fallbackValue; }; export function nanFallback(value, fallback = 0, silent) { if (isNaN(Number(value))) { !silent && logger(`"${value}" is not a number, falling back to ${fallback}`, 'warning'); return fallback; } return value; } // modulo that works with negative numbers e.g. _mod(-1, 3) = 2. Works on numbers (rather than patterns of numbers, as @mod@ from pattern.mjs does) export const _mod = (n, m) => ((n % m) + m) % m; // round to nearest int, negative numbers will output a subtracted index export const getSoundIndex = (n, numSounds) => { return _mod(Math.round(nanFallback(n, 0)), numSounds); };