@tremolo-ui/functions 0.5.0 → 0.7.0

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":[],"sources":["../src/math.ts","../src/scales.ts","../src/util.ts","../src/midi.ts","../src/piano.ts","../src/unit.ts"],"sourcesContent":["/**\n * clamp value between min and max\n */\nexport function clamp(value: number, min: number, max: number) {\n  return Math.max(min, Math.min(value, max))\n}\n\n/**\n * Normalize the value from 0 to 1, spreading the range evenly.\n *\n * This is the linear mapping and takes no curve of its own; a `Scale` builds\n * whatever curve it needs on top of it.\n */\nexport function normalizeValue(value: number, min: number, max: number) {\n  if (min >= max) throw new RangeError('requirements: min < max')\n  return clamp((value - min) / (max - min), 0, 1)\n}\n\n/**\n * Convert normalized values back to raw values, spreading the range evenly.\n *\n * The inverse of {@link normalizeValue}.\n */\nexport function rawValue(normalizedValue: number, min: number, max: number) {\n  if (min >= max) throw new RangeError('requirements: min < max')\n  return min + clamp(normalizedValue, 0, 1) * (max - min)\n}\n\nexport function stepValue(value: number, step: number) {\n  if (step <= 0) throw new RangeError('requirements: step > 0')\n  const quotient = Math.floor(value / step)\n  const decimalDigits = decimalPart(step)?.length\n  const v = toFixed(quotient * step, decimalDigits)\n  const next = toFixed((quotient + 1) * step, decimalDigits)\n  return Math.abs(value - v) < Math.abs(value - next) ? v : next\n}\n\nexport function toFixed(x: number, fractionDigits?: number) {\n  return Number(x.toFixed(fractionDigits))\n}\n\nexport function integerPart(x: number | string): string | undefined {\n  if (Number.isNaN(x)) {\n    return undefined\n  }\n  return String(x).split('.')[0]\n}\n\nexport function decimalPart(x: number | string): string | undefined {\n  return String(x).split('.')[1]\n}\n\nexport function radian(degree: number) {\n  return (Math.PI * degree) / 180\n}\n\nexport function degree(radian: number) {\n  return (180 * radian) / Math.PI\n}\n\nexport function mapValue(\n  value: number,\n  inMin: number,\n  inMax: number,\n  outMin: number,\n  outMax: number,\n) {\n  return ((value - inMin) / (inMax - inMin)) * (outMax - outMin) + outMin\n}\n\nexport function dbToGain(db: number) {\n  return Math.pow(10, db / 20)\n}\n\nexport function gainToDb(gain: number) {\n  return 20 * (Math.log(gain) / Math.LN10)\n}\n","import { clamp, normalizeValue, rawValue, stepValue } from './math'\n\nimport type { InputEventOption } from './types'\n\n/**\n * How a value is distributed across the travel of a control.\n *\n * `normalize` and `denormalize` are inverses of each other: the position is\n * 0 at `min` and 1 at `max`, and everything in between is up to the scale.\n *\n * `min` and `max` are arguments rather than baked into the scale, so a scale\n * holds no state and can be a module level constant. Passing the same object\n * on every render therefore costs nothing.\n *\n * @example\n * ```ts\n * exponentialScale.denormalize(0.5, 20, 20000) // 632.45…\n * ```\n */\nexport interface Scale {\n  /** Value to its position on the travel, 0-1. */\n  normalize: (value: number, min: number, max: number) => number\n  /** Position on the travel, 0-1, back to a value. */\n  denormalize: (position: number, min: number, max: number) => number\n}\n\nfunction assertRange(min: number, max: number) {\n  if (min >= max) throw new RangeError('requirements: min < max')\n}\n\n/**\n * Equal travel gives an equal change in value.\n *\n * The right default for anything already linear in perception: dB values,\n * pan, percentages, MIDI note numbers, semitones.\n */\nexport const linearScale: Scale = {\n  normalize: (value, min, max) => normalizeValue(value, min, max),\n  denormalize: (position, min, max) => rawValue(position, min, max),\n}\n\n/**\n * The power law of JUCE's `NormalisableRange::skew`, applied to `value - min`.\n *\n * Use it when the value has to agree with a JUCE or iPlug2 parameter — a\n * plugin UI in a WebView, say, where the knob must sit exactly where the\n * host's automation curve puts it. {@link skewWithCenterValue} gives the\n * factor that places a chosen value at the middle of the travel.\n *\n * `skew < 1` gives the lower end more travel, `skew > 1` the upper end.\n *\n * For new designs prefer {@link exponentialScale} or {@link curveScale}: the\n * slope of this curve is either zero or infinite at `min`, so the bottom of\n * the range is a dead zone or jumps.\n *\n * @param skew the JUCE skew factor\n */\nexport function skewScale(skew: number): Scale {\n  return {\n    // The two expressions JUCE uses, kept verbatim so the numbers agree with\n    // a NormalisableRange: pow() one way, exp(log()) the other.\n    normalize: (value, min, max) =>\n      Math.pow(normalizeValue(value, min, max), skew),\n    denormalize: (position, min, max) =>\n      rawValue(\n        skew === 1\n          ? position\n          : Math.exp(Math.log(clamp(position, 0, 1)) / skew),\n        min,\n        max,\n      ),\n  }\n}\n\n/**\n * The skew factor for {@link skewScale} that puts `centerValue` at the middle\n * of the travel — JUCE's `NormalisableRange::setSkewForCentre`.\n */\nexport function skewWithCenterValue(\n  centerValue: number,\n  min: number,\n  max: number,\n) {\n  if (!(min <= centerValue && centerValue <= max))\n    throw new RangeError('requirements: min <= centerValue <= max')\n  return Math.log(0.5) / Math.log((centerValue - min) / (max - min))\n}\n\n/**\n * Equal travel gives an equal *ratio*, so an octave — or a percentage — takes\n * the same distance wherever it falls.\n *\n * The scale for frequency (a filter cutoff over 20-20000 Hz), free running\n * rates, and delay times.\n *\n * Requires `min` and `max` to be non-zero and of the same sign, since no\n * ratio reaches zero or crosses it. Use {@link curveScale} for a range that\n * starts at 0.\n */\nexport const exponentialScale: Scale = {\n  normalize: (value, min, max) => {\n    assertExponentialRange(min, max)\n    // The value is clamped before the logarithm, not after: outside the range\n    // the ratio can be negative, and log() would give NaN rather than a\n    // position to clamp.\n    return clamp(\n      Math.log(clamp(value, min, max) / min) / Math.log(max / min),\n      0,\n      1,\n    )\n  },\n  denormalize: (position, min, max) => {\n    assertExponentialRange(min, max)\n    return min * Math.pow(max / min, clamp(position, 0, 1))\n  },\n}\n\nfunction assertExponentialRange(min: number, max: number) {\n  assertRange(min, max)\n  if (min === 0 || max === 0 || Math.sign(min) !== Math.sign(max)) {\n    throw new RangeError(\n      'exponentialScale: requirements: min and max are non-zero and have the same sign',\n    )\n  }\n}\n\n/**\n * An exponential bend that still passes exactly through `min` and `max`, so\n * unlike {@link exponentialScale} it works on a range that starts at 0 or\n * crosses it, and unlike {@link skewScale} its slope is neither zero nor\n * infinite at either end.\n *\n * The general purpose taper, and the same family as the curve of an envelope\n * segment (SuperCollider's `CurveWarp`).\n *\n * - `curve > 0` gives the lower end more travel — envelope times from 0 ms,\n *   delay times, anything that wants fine control near the bottom\n * - `curve < 0` gives the upper end more travel — a volume fader over\n *   -60..+6 dB that should be precise around 0 dB\n * - near 0 it is indistinguishable from {@link linearScale}, and is treated\n *   as linear to avoid dividing by zero\n *\n * {@link curveWithCenterValue} gives the curve that places a chosen value at\n * the middle of the travel.\n *\n * @param curve how hard the curve bends, and in which direction\n */\nexport function curveScale(curve: number): Scale {\n  // The two coefficients blow up as the curve flattens: `a` divides by\n  // 1 - e^curve, which goes to 0.\n  if (Math.abs(curve) < 0.001) return linearScale\n\n  const grow = Math.exp(curve)\n\n  // value(position) = b - a * e^(curve * position), fixed so that\n  // value(0) = min and value(1) = max.\n  const coefficients = (min: number, max: number) => {\n    const a = (max - min) / (1 - grow)\n    return { a, b: min + a }\n  }\n\n  return {\n    normalize: (value, min, max) => {\n      assertRange(min, max)\n      const { a, b } = coefficients(min, max)\n      // Clamped before the logarithm: far outside the range `(b - value) / a`\n      // turns negative and log() would give NaN.\n      return clamp(Math.log((b - clamp(value, min, max)) / a) / curve, 0, 1)\n    },\n    denormalize: (position, min, max) => {\n      assertRange(min, max)\n      const { a, b } = coefficients(min, max)\n      return b - a * Math.pow(grow, clamp(position, 0, 1))\n    },\n  }\n}\n\n/**\n * {@link skewScale} mirrored about the middle of the range, so both halves\n * bend the same way — JUCE's `symmetricSkew`.\n *\n * For a bipolar control whose centre matters: detune over -100..+100 cents,\n * or a bipolar filter envelope amount, where the fine adjustment is around 0\n * rather than at either end.\n *\n * `skew < 1` gives the middle more travel, `skew > 1` the two ends.\n *\n * @param skew the JUCE skew factor\n */\nexport function symmetricSkewScale(skew: number): Scale {\n  return {\n    normalize: (value, min, max) => {\n      assertRange(min, max)\n      const proportion = clamp((value - min) / (max - min), 0, 1)\n      if (skew === 1) return proportion\n      const distanceFromMiddle = 2 * proportion - 1\n      return (\n        (1 +\n          Math.pow(Math.abs(distanceFromMiddle), skew) *\n            Math.sign(distanceFromMiddle)) /\n        2\n      )\n    },\n    denormalize: (position, min, max) => {\n      assertRange(min, max)\n      const p = clamp(position, 0, 1)\n      let distanceFromMiddle = 2 * p - 1\n      if (skew !== 1 && distanceFromMiddle !== 0) {\n        distanceFromMiddle =\n          Math.pow(Math.abs(distanceFromMiddle), 1 / skew) *\n          Math.sign(distanceFromMiddle)\n      }\n      return min + ((max - min) / 2) * (1 + distanceFromMiddle)\n    },\n  }\n}\n\n/**\n * The curve for {@link curveScale} that puts `centerValue` at the middle of\n * the travel — the counterpart of {@link skewWithCenterValue}.\n */\nexport function curveWithCenterValue(\n  centerValue: number,\n  min: number,\n  max: number,\n) {\n  assertRange(min, max)\n  if (!(min < centerValue && centerValue < max)) {\n    throw new RangeError('requirements: min < centerValue < max')\n  }\n  // value(0.5) - min = range / (1 + e^(curve / 2))\n  const proportion = (centerValue - min) / (max - min)\n  return 2 * Math.log(1 / proportion - 1)\n}\n\n/**\n * How a value is scaled: the range it lives in, how it is rounded, and how it\n * is distributed across the travel.\n *\n * `AxisOptions` of `@tremolo-ui/dom` extends this, so a drag and a\n * wheel / keyboard nudge run the same value pipeline.\n */\nexport interface ValueRange {\n  min: number\n  max: number\n  /**\n   * Rounding applied to the value. Left unrounded when omitted.\n   */\n  step?: number\n  /**\n   * How the value is distributed across the travel.\n   *\n   * @default linearScale\n   */\n  scale?: Scale\n}\n\n/**\n * Move a value by an amount of input, as reported by a wheel or an arrow key.\n *\n * The pipeline matches `createDragValue` of `@tremolo-ui/dom`: scale, then\n * step, then clamp. Which key or which sign of `deltaY` counts as which\n * direction is left to the caller, since it differs per component.\n *\n * @param direction which way, and how many times, to apply the option. The\n * size of one step is `option[1]`, so this is normally `1` or `-1`.\n *\n * @example\n * // ArrowDown on a slider whose keyboard option is ['raw', 1]\n * applyDelta(value, -1, keyboard, { min, max, step, scale })\n */\nexport function applyDelta(\n  value: number,\n  direction: number,\n  [mode, amount]: InputEventOption,\n  { min, max, step, scale = linearScale }: ValueRange,\n): number {\n  const x = direction * amount\n  const next =\n    mode == 'normalized'\n      ? scale.denormalize(scale.normalize(value, min, max) + x, min, max)\n      : value + x\n  return clamp(step ? stepValue(next, step) : next, min, max)\n}\n","type Operator = '+' | '-' | '*' | '/'\n\nexport function styleHelper(value: string | number): string\nexport function styleHelper(\n  value: string | number,\n  op: Operator,\n  influencer?: number,\n): string\nexport function styleHelper(\n  value: string | number,\n  op?: Operator,\n  influencer?: number,\n) {\n  if (op && influencer) {\n    if (typeof value == 'number') {\n      if (op == '+') return `${value + influencer}px`\n      if (op == '-') return `${value - influencer}px`\n      if (op == '*') return `${value * influencer}px`\n      if (op == '/') return `${value / influencer}px`\n    } else {\n      return `calc(${value}px ${op} ${influencer})`\n    }\n  } else {\n    if (typeof value == 'number') {\n      return `${value}px`\n    } else {\n      return value\n    }\n  }\n}\n\nexport function isEmpty(obj: object) {\n  return Object.keys(obj).length == 0\n}\n\nexport function mod(n: number, m: number) {\n  return ((n % m) + m) % m\n}\n\nexport function xor(a = false, b = false) {\n  return (a || b) && a != b\n}\n","import { mod } from './util'\n\nexport const whiteKeys = ['A', 'B', 'C', 'D', 'E', 'F', 'G'] as const\n\nexport type WhiteKey = (typeof whiteKeys)[number]\n\nexport const noteKeys = [\n  'C',\n  'C#',\n  'D',\n  'D#',\n  'E',\n  'F',\n  'F#',\n  'G',\n  'G#',\n  'A',\n  'A#',\n  'B',\n] as const\n\nexport type NoteKey = (typeof noteKeys)[number]\n\nexport function parseNoteName(noteName: string) {\n  const m = noteName.match(/^([a-g])(#{0,2}|b{0,2})(-?\\d+)$/i)\n  if (!m) throw new Error('Invalid note name')\n  const [, letter, accidental, octave] = m\n  return {\n    letter: letter.toLocaleUpperCase() as WhiteKey,\n    accidental: accidental as '#' | '##' | 'b' | 'bb' | '',\n    octave: Number(octave),\n  }\n}\n\n/**\n * Convert noteName to noteNumber\n */\nexport function noteNumber(noteName: string) {\n  const { letter, accidental, octave } = parseNoteName(noteName)\n  const noteIndex = noteKeys.indexOf(letter.toLocaleUpperCase() as NoteKey)\n  const accidentalValue = (accidental[0] == 'b' ? -1 : 1) * accidental.length\n  return noteIndex + 12 * (Number(octave) + 1) + accidentalValue\n}\n\n/**\n * Convert noteNumber to noteName\n * C-1 = 0\n * G9 = 127\n * @param noteNumber noteNumber\n */\nexport function noteName(noteNumber: number): `${NoteKey}${number}` {\n  const noteIndex = mod(noteNumber, 12)\n  const octave = Math.floor(noteNumber / 12) - 1\n  return `${noteKeys[noteIndex]}${octave}`\n}\n\n/**\n * Convert noteNumber to noteKey\n */\nexport function noteKey(noteNumber: number): NoteKey {\n  return noteKeys[mod(noteNumber, 12)]\n}\n\n/**\n * @param note noteNumber: 0 ~ 127 or noteName e.g. 'C3'\n */\nexport function isWhiteKey(note: number | string) {\n  const n = typeof note == 'string' ? noteNumber(note) : note\n  return (\n    mod(n, 12) == 0 ||\n    mod(n, 12) == 2 ||\n    mod(n, 12) == 4 ||\n    mod(n, 12) == 5 ||\n    mod(n, 12) == 7 ||\n    mod(n, 12) == 9 ||\n    mod(n, 12) == 11\n  )\n}\n\n/**\n * @param note noteNumber: 0 ~ 127 or noteName e.g. 'C3'\n */\nexport function isBlackKey(note: number | string) {\n  return !isWhiteKey(note)\n}\n\n/**\n * @param note noteNumber: 0 ~ 127 or noteName e.g. 'C3'\n * @param detune [cent]\n * @param a4 A4 frequency [Hz]\n * @returns frequency [Hz]\n */\nexport function noteToFrequency(note: number | string, detune = 0, a4 = 440) {\n  const n = typeof note == 'string' ? noteNumber(note) : note\n  return (a4 / 32) * 2 ** ((n - 9 + detune / 100) / 12)\n}\n\n/**\n * Semitones above the root, for each supported scale.\n *\n * Every entry starts at 0 and stays inside one octave, so a scale is a set of\n * pitch classes rather than a set of notes: {@link inScale} compares against\n * it with the octave taken out.\n *\n * `ionian` and `aeolian` are the same sets as `major` and `naturalMinor`; both\n * spellings are here because both are what someone reaches for depending on\n * whether they are thinking in keys or in modes.\n */\nexport const scaleIntervals = {\n  major: [0, 2, 4, 5, 7, 9, 11],\n  naturalMinor: [0, 2, 3, 5, 7, 8, 10],\n  harmonicMinor: [0, 2, 3, 5, 7, 8, 11],\n  melodicMinor: [0, 2, 3, 5, 7, 9, 11],\n\n  ionian: [0, 2, 4, 5, 7, 9, 11],\n  dorian: [0, 2, 3, 5, 7, 9, 10],\n  phrygian: [0, 1, 3, 5, 7, 8, 10],\n  lydian: [0, 2, 4, 6, 7, 9, 11],\n  mixolydian: [0, 2, 4, 5, 7, 9, 10],\n  aeolian: [0, 2, 3, 5, 7, 8, 10],\n  locrian: [0, 1, 3, 5, 6, 8, 10],\n\n  majorPentatonic: [0, 2, 4, 7, 9],\n  minorPentatonic: [0, 3, 5, 7, 10],\n  blues: [0, 3, 5, 6, 7, 10],\n\n  wholeTone: [0, 2, 4, 6, 8, 10],\n  chromatic: [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11],\n} as const satisfies Record<string, readonly number[]>\n\nexport type ScaleName = keyof typeof scaleIntervals\n\n/**\n * Whether a note belongs to a scale, regardless of the octave either sits in.\n *\n * @param note noteNumber: 0 ~ 127 or noteName e.g. 'C3'\n * @param root the note the scale is built on, in the same two forms\n *\n * @example\n * ```ts\n * inScale('F#4', 'D3', 'major') // true\n * ```\n */\nexport function inScale(\n  note: number | string,\n  root: number | string,\n  name: ScaleName,\n): boolean {\n  const n = typeof note == 'string' ? noteNumber(note) : note\n  const r = typeof root == 'string' ? noteNumber(root) : root\n  return (scaleIntervals[name] as readonly number[]).includes(mod(n - r, 12))\n}\n\n/**\n * The notes of a scale, ascending from `root`.\n *\n * The octave above the root is not included: ask for more `octaves` instead, so\n * that concatenating the result of two calls does not repeat a note.\n *\n * @param root noteNumber: 0 ~ 127 or noteName e.g. 'C3'\n * @param octaves how many octaves to cover\n *\n * @example\n * ```ts\n * scaleNotes('C3', 'majorPentatonic') // [48, 50, 52, 55, 57]\n * ```\n */\nexport function scaleNotes(\n  root: number | string,\n  name: ScaleName,\n  octaves = 1,\n): number[] {\n  const r = typeof root == 'string' ? noteNumber(root) : root\n  const intervals = scaleIntervals[name] as readonly number[]\n  return Array.from({ length: octaves }, (_, octave) =>\n    intervals.map((interval) => r + octave * 12 + interval),\n  ).flat()\n}\n","import { isBlackKey, isWhiteKey, noteKey, noteKeys, type NoteKey } from './midi'\n\nexport type NoteRange = {\n  first: number\n  last: number\n}\n\n/**\n * `[noteRange.first, noteRange.first + 1, ..., noteRange.last]`\n */\nexport function getNoteRangeArray(noteRange: NoteRange): number[] {\n  return Array.from(\n    { length: noteRange.last - noteRange.first + 1 },\n    (_, i) => i + noteRange.first,\n  )\n}\n\n/**\n * The geometry of a drawn keyboard.\n *\n * One description is shared by the drawing and the hit testing, so a key cannot\n * be drawn somewhere other than where it responds.\n */\nexport interface PianoLayout {\n  noteRange: NoteRange\n\n  /** Width of a white key, excluding {@link PianoLayout.keyGap}. */\n  whiteKeyWidth: number\n\n  /**\n   * Space between two white keys. Part of the slot a white key occupies, so it\n   * still belongs to one of the keys for the purpose of hit testing.\n   *\n   * @default 1\n   */\n  keyGap?: number\n\n  /**\n   * Width of a black key, as a fraction of {@link PianoLayout.whiteKeyWidth}.\n   *\n   * @default 0.65\n   */\n  blackKeyWidthRatio?: number\n\n  /**\n   * Height of a black key, as a fraction of the height of the keyboard.\n   *\n   * @default 0.6\n   */\n  blackKeyHeightRatio?: number\n}\n\nconst DEFAULT_KEY_GAP = 1\nconst DEFAULT_BLACK_KEY_WIDTH_RATIO = 0.65\nconst DEFAULT_BLACK_KEY_HEIGHT_RATIO = 0.6\n\n/**\n * How many white keys sit at or before each pitch class, counting from C.\n *\n * A black key shares the number of the white key to its left plus one, which\n * puts it on the boundary between the two; {@link notePosition} then shifts it\n * back by half its width to centre it there.\n */\nconst whiteKeysBefore: Record<NoteKey, number> = {\n  C: 0,\n  'C#': 1,\n  D: 1,\n  'D#': 2,\n  E: 2,\n  F: 3,\n  'F#': 4,\n  G: 4,\n  'G#': 5,\n  A: 5,\n  'A#': 6,\n  B: 6,\n}\n\n/** Width of a black key in pixels. */\nexport function blackKeyWidth(layout: PianoLayout): number {\n  return (\n    layout.whiteKeyWidth *\n    (layout.blackKeyWidthRatio ?? DEFAULT_BLACK_KEY_WIDTH_RATIO)\n  )\n}\n\n/** Width of the whole keyboard in pixels. */\nexport function pianoWidth(layout: PianoLayout): number {\n  const whiteKeys = getNoteRangeArray(layout.noteRange).filter(isWhiteKey)\n  return (\n    (layout.whiteKeyWidth + (layout.keyGap ?? DEFAULT_KEY_GAP)) *\n    whiteKeys.length\n  )\n}\n\n/**\n * Offset of the left edge of a key from the left edge of the keyboard, in\n * pixels.\n *\n * Notes outside `noteRange` are placed too, so the value is negative below\n * `noteRange.first`.\n */\nexport function notePosition(note: number, layout: PianoLayout): number {\n  const slot = layout.whiteKeyWidth + (layout.keyGap ?? DEFAULT_KEY_GAP)\n  const target = noteKey(note)\n  const first = noteKey(layout.noteRange.first)\n\n  const octave = Math.floor((note - layout.noteRange.first) / 12)\n  // A note whose pitch class comes before the first one belongs to the octave\n  // above the one the division above gives.\n  const octaveOffset =\n    noteKeys.indexOf(first) > noteKeys.indexOf(target) ? 1 : 0\n\n  const whiteKeysIn =\n    whiteKeysBefore[target] -\n    whiteKeysBefore[first] +\n    (octave + octaveOffset) * 7\n\n  return isBlackKey(note)\n    ? whiteKeysIn * slot - blackKeyWidth(layout) / 2\n    : whiteKeysIn * slot\n}\n\n/**\n * The note drawn at a point, or null where there is none.\n *\n * Black keys are tested first, so they win where they overlap a white one. A\n * white key covers its gap as well as its width, so the whole width of the\n * keyboard belongs to some key and a click cannot fall between two.\n *\n * @param x offset from the left edge of the keyboard, in pixels\n * @param y offset from its top edge, in pixels\n * @param height height of the keyboard, in pixels\n */\nexport function noteAt(\n  x: number,\n  y: number,\n  height: number,\n  layout: PianoLayout,\n): number | null {\n  if (y < 0 || y >= height) return null\n\n  const notes = getNoteRangeArray(layout.noteRange)\n  const blackHeight =\n    height * (layout.blackKeyHeightRatio ?? DEFAULT_BLACK_KEY_HEIGHT_RATIO)\n\n  if (y < blackHeight) {\n    for (const note of notes) {\n      if (isWhiteKey(note)) continue\n      const left = notePosition(note, layout)\n      if (left <= x && x < left + blackKeyWidth(layout)) return note\n    }\n  }\n\n  const slot = layout.whiteKeyWidth + (layout.keyGap ?? DEFAULT_KEY_GAP)\n  for (const note of notes) {\n    if (isBlackKey(note)) continue\n    const left = notePosition(note, layout)\n    if (left <= x && x < left + slot) return note\n  }\n\n  return null\n}\n","/**\n * Units a value can be displayed in, as `[symbol, scale]` pairs ordered from\n * the smallest scale up. A value is shown in the largest unit that does not\n * exceed it.\n *\n * @example\n * [['Hz', 1], ['kHz', 1000]]\n * [['ms', 1], ['s', 1000]]\n */\nexport type Units = [string, number][]\n\n/**\n * Pick the unit a value is displayed in: the largest one whose scale does not\n * exceed the magnitude of the value.\n */\nexport function selectUnit(units: Units, value: number): [string, number] {\n  let i = 0\n  for (; i < units.length; i++) {\n    if (Math.abs(units[i][1]) > Math.abs(value)) break\n  }\n  return units[Math.max(0, i - 1)]\n}\n\n/**\n * Render a value as text, in the unit that suits its magnitude.\n *\n * @param units a single symbol appended as-is, or a list to choose from.\n * @param digit digits after the decimal point. Left as-is when omitted.\n *\n * @example\n * formatValue(1234, [['Hz', 1], ['kHz', 1000]], 2) // '1.23kHz'\n * formatValue(1.5, 'Hz')                           // '1.5Hz'\n */\nexport function formatValue(\n  value: number,\n  units?: string | Units,\n  digit?: number,\n): string {\n  const fixed = (v: number) =>\n    digit != undefined ? v.toFixed(digit) : String(v)\n  if (!units || typeof units == 'string') {\n    return fixed(value) + (units ?? '')\n  }\n  const [unit, scale] = selectUnit(units, value)\n  return fixed(value / scale) + unit\n}\n\n/**\n * Read a value back out of text, undoing the scaling of {@link formatValue}.\n *\n * With a list of units the text has to be a number followed by an optional\n * unit and nothing else, since the unit decides the scale; anything else reads\n * as 0. With a single unit, or none, the first number found anywhere in the\n * text is taken, so a half-typed entry still yields something.\n *\n * @example\n * parseValue('1.23kHz', [['Hz', 1], ['kHz', 1000]]) // 1230\n * parseValue('4abc')                                // 4\n */\nexport function parseValue(text: string, units?: string | Units): number {\n  const str = text.trim()\n\n  if (!units || typeof units == 'string') {\n    const m = str.match(/-?\\d+(\\.\\d+)?/)\n    const v = Number(m?.[0] ?? '0')\n    return isNaN(v) ? 0 : v\n  }\n\n  const m = str.match(/^(-?\\d+(\\.\\d+)?)\\s*(\\w*)$/)\n  if (!m) return 0\n  const found = units.find(([unit]) => unit == m[3])\n  return (Number(m[1]) || 0) * (found ? found[1] : 1)\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.cjs","names":[],"sources":["../src/math.ts","../src/scales.ts","../src/midi.ts","../src/unit.ts"],"sourcesContent":["/**\n * clamp value between min and max\n */\nexport function clamp(value: number, min: number, max: number) {\n  return Math.max(min, Math.min(value, max))\n}\n\n/**\n * Normalize the value from 0 to 1, spreading the range evenly.\n *\n * This is the linear mapping and takes no curve of its own; a `Scale` builds\n * whatever curve it needs on top of it.\n */\nexport function normalizeValue(value: number, min: number, max: number) {\n  if (min >= max) throw new RangeError('requirements: min < max')\n  return clamp((value - min) / (max - min), 0, 1)\n}\n\n/**\n * Convert normalized values back to raw values, spreading the range evenly.\n *\n * The inverse of {@link normalizeValue}.\n */\nexport function rawValue(normalizedValue: number, min: number, max: number) {\n  if (min >= max) throw new RangeError('requirements: min < max')\n  return min + clamp(normalizedValue, 0, 1) * (max - min)\n}\n\n/**\n * Put a value on the grid the caller asked for, rounding a half step upwards.\n *\n * The rounding is done on the quotient rather than by comparing the distance\n * to the two neighbours, because both of those carry error of their own. The\n * quotient is cleared of its artefact first: `0.15 / 0.1` is 1.4999999999999998,\n * and a value sitting exactly on a half step would otherwise fall to whichever\n * side the last bit happened to land on — 0.25 rounded up while 0.15 and 0.35\n * rounded down.\n */\nexport function stepValue(value: number, step: number) {\n  if (step <= 0) throw new RangeError('requirements: step > 0')\n  const quotient = Math.round(toPrecision(value / step))\n  // The product has its own debris to drop: 3141593 * 1e-6 is not 3.141593.\n  const stepped = toPrecision(quotient * step)\n  // Math.round answers -0 for anything in [-0.5, 0), and that reaches the\n  // caller's onChange as a value that prints as 0 but is not it.\n  return stepped === 0 ? 0 : stepped\n}\n\nexport function toFixed(x: number, fractionDigits?: number) {\n  return Number(x.toFixed(fractionDigits))\n}\n\n/**\n * The significant decimal digits a double actually carries. A double holds a\n * little under 16, so anything past this is the binary representation showing\n * through rather than information.\n */\nconst SIGNIFICANT_DIGITS = 15\n\n/**\n * Drop the binary artefact from a computed value.\n *\n * Arithmetic on doubles leaves debris in the last couple of digits, and it\n * accumulates: adding 0.1 to 5 twelve times gives 5.699999999999998 rather\n * than 5.7, and the display of a control shows exactly that. Rounding to the\n * digits a double can carry removes it, and adds nothing back — the value was\n * already the result of a calculation whose own error is that size or larger.\n *\n * This is not the same as rounding to a `step`. {@link stepValue} puts a value\n * on a grid the caller asked for and is a decision about the value; this only\n * removes what was never in the value to begin with.\n *\n * @param significantDigits how many digits to keep. The default is the only\n * one that is purely artefact removal; a smaller number starts discarding real\n * precision.\n *\n * @example\n * toPrecision(5.1 + 0.1) // 5.2, rather than 5.199999999999999\n */\nexport function toPrecision(x: number, significantDigits = SIGNIFICANT_DIGITS) {\n  // Zero has no significant digits to round to, and a non-finite value has no\n  // decimal form to parse back.\n  if (x === 0 || !Number.isFinite(x)) return x\n  const rounded = Number(x.toPrecision(significantDigits))\n  // Rounding up at the very top of the range overflows to Infinity, which is\n  // a worse answer than the artefact.\n  return Number.isFinite(rounded) ? rounded : x\n}\n\nexport function radian(degree: number) {\n  return (Math.PI * degree) / 180\n}\n\nexport function degree(radian: number) {\n  return (180 * radian) / Math.PI\n}\n\nexport function mapValue(\n  value: number,\n  inMin: number,\n  inMax: number,\n  outMin: number,\n  outMax: number,\n) {\n  return ((value - inMin) / (inMax - inMin)) * (outMax - outMin) + outMin\n}\n\nexport function dbToGain(db: number) {\n  return Math.pow(10, db / 20)\n}\n\nexport function gainToDb(gain: number) {\n  return 20 * (Math.log(gain) / Math.LN10)\n}\n","import { clamp, normalizeValue, rawValue } from './math'\n\n/**\n * How a value is distributed across the travel of a control.\n *\n * `normalize` and `denormalize` are inverses of each other: the position is\n * 0 at `min` and 1 at `max`, and everything in between is up to the scale.\n *\n * `min` and `max` are arguments rather than baked into the scale, so a scale\n * holds no state and can be a module level constant. Passing the same object\n * on every render therefore costs nothing.\n *\n * @example\n * ```ts\n * exponentialScale.denormalize(0.5, 20, 20000) // 632.45…\n * ```\n */\nexport interface Scale {\n  /** Value to its position on the travel, 0-1. */\n  normalize: (value: number, min: number, max: number) => number\n  /** Position on the travel, 0-1, back to a value. */\n  denormalize: (position: number, min: number, max: number) => number\n}\n\nfunction assertRange(min: number, max: number) {\n  if (min >= max) throw new RangeError('requirements: min < max')\n}\n\nfunction assertPositiveFinite(value: number, name: string) {\n  if (!Number.isFinite(value) || value <= 0) {\n    throw new RangeError(`${name}: requirements: finite and greater than 0`)\n  }\n}\n\n/**\n * Equal travel gives an equal change in value.\n *\n * The right default for anything already linear in perception: dB values,\n * pan, percentages, MIDI note numbers, semitones.\n */\nexport const linearScale: Scale = {\n  normalize: (value, min, max) => normalizeValue(value, min, max),\n  denormalize: (position, min, max) => rawValue(position, min, max),\n}\n\n/**\n * The power law of JUCE's `NormalisableRange::skew`, applied to `value - min`.\n *\n * Use it when the value has to agree with a JUCE or iPlug2 parameter — a\n * plugin UI in a WebView, say, where the knob must sit exactly where the\n * host's automation curve puts it. {@link skewWithCenterValue} gives the\n * factor that places a chosen value at the middle of the travel.\n *\n * `skew < 1` gives the lower end more travel, `skew > 1` the upper end.\n *\n * For new designs prefer {@link exponentialScale} or {@link curveScale}: the\n * slope of this curve is either zero or infinite at `min`, so the bottom of\n * the range is a dead zone or jumps.\n *\n * @param skew the JUCE skew factor\n */\nexport function skewScale(skew: number): Scale {\n  assertPositiveFinite(skew, 'skewScale')\n  return {\n    // The two expressions JUCE uses, kept verbatim so the numbers agree with\n    // a NormalisableRange: pow() one way, exp(log()) the other.\n    normalize: (value, min, max) =>\n      Math.pow(normalizeValue(value, min, max), skew),\n    denormalize: (position, min, max) =>\n      rawValue(\n        skew === 1\n          ? position\n          : Math.exp(Math.log(clamp(position, 0, 1)) / skew),\n        min,\n        max,\n      ),\n  }\n}\n\n/**\n * The skew factor for {@link skewScale} that puts `centerValue` at the middle\n * of the travel — JUCE's `NormalisableRange::setSkewForCentre`.\n */\nexport function skewWithCenterValue(\n  centerValue: number,\n  min: number,\n  max: number,\n) {\n  assertRange(min, max)\n  if (!(min < centerValue && centerValue < max))\n    throw new RangeError('requirements: min < centerValue < max')\n  return Math.log(0.5) / Math.log((centerValue - min) / (max - min))\n}\n\n/**\n * Equal travel gives an equal *ratio*, so an octave — or a percentage — takes\n * the same distance wherever it falls.\n *\n * The scale for frequency (a filter cutoff over 20-20000 Hz), free running\n * rates, and delay times.\n *\n * Requires `min` and `max` to be non-zero and of the same sign, since no\n * ratio reaches zero or crosses it. Use {@link curveScale} for a range that\n * starts at 0.\n */\nexport const exponentialScale: Scale = {\n  normalize: (value, min, max) => {\n    assertExponentialRange(min, max)\n    // The value is clamped before the logarithm, not after: outside the range\n    // the ratio can be negative, and log() would give NaN rather than a\n    // position to clamp.\n    const start = Math.log(Math.abs(min))\n    const end = Math.log(Math.abs(max))\n    return clamp(\n      (Math.log(Math.abs(clamp(value, min, max))) - start) / (end - start),\n      0,\n      1,\n    )\n  },\n  denormalize: (position, min, max) => {\n    assertExponentialRange(min, max)\n    const start = Math.log(Math.abs(min))\n    const end = Math.log(Math.abs(max))\n    const magnitude = Math.exp(start + (end - start) * clamp(position, 0, 1))\n    return Math.sign(min) * magnitude\n  },\n}\n\nfunction assertExponentialRange(min: number, max: number) {\n  assertRange(min, max)\n  if (min === 0 || max === 0 || Math.sign(min) !== Math.sign(max)) {\n    throw new RangeError(\n      'exponentialScale: requirements: min and max are non-zero and have the same sign',\n    )\n  }\n}\n\n/**\n * An exponential bend that still passes exactly through `min` and `max`, so\n * unlike {@link exponentialScale} it works on a range that starts at 0 or\n * crosses it, and unlike {@link skewScale} its slope is neither zero nor\n * infinite at either end.\n *\n * The general purpose taper, and the same family as the curve of an envelope\n * segment (SuperCollider's `CurveWarp`).\n *\n * - `curve > 0` gives the lower end more travel — envelope times from 0 ms,\n *   delay times, anything that wants fine control near the bottom\n * - `curve < 0` gives the upper end more travel — a volume fader over\n *   -60..+6 dB that should be precise around 0 dB\n * - near 0 it is indistinguishable from {@link linearScale}, and is treated\n *   as linear to avoid dividing by zero\n *\n * {@link curveWithCenterValue} gives the curve that places a chosen value at\n * the middle of the travel.\n *\n * @param curve how hard the curve bends, and in which direction\n */\nexport function curveScale(curve: number): Scale {\n  // Beyond this the flatter half of the curve no longer has enough distinct\n  // double values for normalize and denormalize to remain inverses.\n  if (!Number.isFinite(curve) || Math.abs(curve) > 32) {\n    throw new RangeError(\n      'curveScale: requirements: finite curve from -32 to 32',\n    )\n  }\n  // The two coefficients blow up as the curve flattens: `a` divides by\n  // 1 - e^curve, which goes to 0.\n  if (Math.abs(curve) < 0.001) return linearScale\n\n  return {\n    normalize: (value, min, max) => {\n      assertRange(min, max)\n      const proportion = clamp((value - min) / (max - min), 0, 1)\n      if (proportion === 0 || proportion === 1) return proportion\n      if (curve > 0) {\n        return (\n          1 + Math.log(proportion + (1 - proportion) * Math.exp(-curve)) / curve\n        )\n      }\n      return Math.log1p(proportion * Math.expm1(curve)) / curve\n    },\n    denormalize: (position, min, max) => {\n      assertRange(min, max)\n      const p = clamp(position, 0, 1)\n      if (p === 0) return min\n      if (p === 1) return max\n      const proportion =\n        curve > 0\n          ? (Math.exp(curve * (p - 1)) * (1 - Math.exp(-curve * p))) /\n            (1 - Math.exp(-curve))\n          : Math.expm1(curve * p) / Math.expm1(curve)\n      return min + (max - min) * proportion\n    },\n  }\n}\n\n/**\n * {@link skewScale} mirrored about the middle of the range, so both halves\n * bend the same way — JUCE's `symmetricSkew`.\n *\n * For a bipolar control whose centre matters: detune over -100..+100 cents,\n * or a bipolar filter envelope amount, where the fine adjustment is around 0\n * rather than at either end.\n *\n * `skew < 1` gives the middle more travel, `skew > 1` the two ends.\n *\n * @param skew the JUCE skew factor\n */\nexport function symmetricSkewScale(skew: number): Scale {\n  assertPositiveFinite(skew, 'symmetricSkewScale')\n  return {\n    normalize: (value, min, max) => {\n      assertRange(min, max)\n      const proportion = clamp((value - min) / (max - min), 0, 1)\n      if (skew === 1) return proportion\n      const distanceFromMiddle = 2 * proportion - 1\n      return (\n        (1 +\n          Math.pow(Math.abs(distanceFromMiddle), skew) *\n            Math.sign(distanceFromMiddle)) /\n        2\n      )\n    },\n    denormalize: (position, min, max) => {\n      assertRange(min, max)\n      const p = clamp(position, 0, 1)\n      let distanceFromMiddle = 2 * p - 1\n      if (skew !== 1 && distanceFromMiddle !== 0) {\n        distanceFromMiddle =\n          Math.pow(Math.abs(distanceFromMiddle), 1 / skew) *\n          Math.sign(distanceFromMiddle)\n      }\n      return min + ((max - min) / 2) * (1 + distanceFromMiddle)\n    },\n  }\n}\n\n/**\n * The curve for {@link curveScale} that puts `centerValue` at the middle of\n * the travel — the counterpart of {@link skewWithCenterValue}.\n */\nexport function curveWithCenterValue(\n  centerValue: number,\n  min: number,\n  max: number,\n) {\n  assertRange(min, max)\n  if (!(min < centerValue && centerValue < max)) {\n    throw new RangeError('requirements: min < centerValue < max')\n  }\n  // value(0.5) - min = range / (1 + e^(curve / 2))\n  const proportion = (centerValue - min) / (max - min)\n  return 2 * Math.log(1 / proportion - 1)\n}\n\n/**\n * How a value is scaled: the range it lives in, how it is rounded, and how it\n * is distributed across the travel.\n *\n * `AxisOptions` of `@tremolo-ui/dom` extends this, so a drag and a\n * wheel / keyboard nudge run the same value pipeline.\n */\nexport interface ValueRange {\n  min: number\n  max: number\n  /**\n   * Rounding applied to the value. Left unrounded when omitted.\n   */\n  step?: number\n  /**\n   * How the value is distributed across the travel.\n   *\n   * @default linearScale\n   */\n  scale?: Scale\n}\n","/**\n * Remainder that follows the sign of the divisor, rather than of the dividend.\n *\n * `%` in JavaScript keeps the sign of the left operand, so `-13 % 12` is `-1`\n * and cannot index a 12-element table. Every note here is placed by its\n * position within the octave, and note numbers below C-1 are negative.\n */\nfunction mod(n: number, m: number) {\n  return ((n % m) + m) % m\n}\n\nexport const whiteKeys = ['A', 'B', 'C', 'D', 'E', 'F', 'G'] as const\n\nexport type WhiteKey = (typeof whiteKeys)[number]\n\nexport const noteKeys = [\n  'C',\n  'C#',\n  'D',\n  'D#',\n  'E',\n  'F',\n  'F#',\n  'G',\n  'G#',\n  'A',\n  'A#',\n  'B',\n] as const\n\nexport type NoteKey = (typeof noteKeys)[number]\n\nfunction assertSafeInteger(value: number, name: string) {\n  if (!Number.isSafeInteger(value)) {\n    throw new RangeError(`${name}: requirements: a safe integer`)\n  }\n}\n\nexport function parseNoteName(noteName: string) {\n  const m = noteName.match(/^([a-g])(#{0,2}|b{0,2})(-?\\d+)$/i)\n  if (!m) throw new Error('Invalid note name')\n  const [, letter, accidental, octave] = m\n  const parsedOctave = Number(octave)\n  assertSafeInteger(parsedOctave, 'octave')\n  return {\n    letter: letter.toLocaleUpperCase() as WhiteKey,\n    accidental: accidental as '#' | '##' | 'b' | 'bb' | '',\n    octave: parsedOctave,\n  }\n}\n\n/**\n * Convert noteName to noteNumber\n */\nexport function noteNumber(noteName: string) {\n  const { letter, accidental, octave } = parseNoteName(noteName)\n  const noteIndex = noteKeys.indexOf(letter.toLocaleUpperCase() as NoteKey)\n  const accidentalValue = (accidental[0] === 'b' ? -1 : 1) * accidental.length\n  const result = noteIndex + 12 * (octave + 1) + accidentalValue\n  assertSafeInteger(result, 'note number')\n  return result\n}\n\n/**\n * Convert noteNumber to noteName\n * C-1 = 0\n * G9 = 127\n * @param noteNumber noteNumber\n */\nexport function noteName(noteNumber: number): `${NoteKey}${number}` {\n  assertSafeInteger(noteNumber, 'note number')\n  const noteIndex = mod(noteNumber, 12)\n  const octave = Math.floor(noteNumber / 12) - 1\n  return `${noteKeys[noteIndex]}${octave}`\n}\n\n/**\n * Convert noteNumber to noteKey\n */\nexport function noteKey(noteNumber: number): NoteKey {\n  assertSafeInteger(noteNumber, 'note number')\n  return noteKeys[mod(noteNumber, 12)]\n}\n\n/**\n * @param note noteNumber: 0 ~ 127 or noteName e.g. 'C3'\n */\nexport function isWhiteKey(note: number | string) {\n  const n = typeof note === 'string' ? noteNumber(note) : note\n  assertSafeInteger(n, 'note number')\n  return (\n    mod(n, 12) === 0 ||\n    mod(n, 12) === 2 ||\n    mod(n, 12) === 4 ||\n    mod(n, 12) === 5 ||\n    mod(n, 12) === 7 ||\n    mod(n, 12) === 9 ||\n    mod(n, 12) === 11\n  )\n}\n\n/**\n * @param note noteNumber: 0 ~ 127 or noteName e.g. 'C3'\n */\nexport function isBlackKey(note: number | string) {\n  return !isWhiteKey(note)\n}\n\n/**\n * @param note noteNumber: 0 ~ 127 or noteName e.g. 'C3'\n * @param detune [cent]\n * @param a4 A4 frequency [Hz]\n * @returns frequency [Hz]\n */\nexport function noteToFrequency(note: number | string, detune = 0, a4 = 440) {\n  const n = typeof note === 'string' ? noteNumber(note) : note\n  assertSafeInteger(n, 'note number')\n  return (a4 / 32) * 2 ** ((n - 9 + detune / 100) / 12)\n}\n\n/**\n * Semitones above the root, for each supported scale.\n *\n * Every entry starts at 0 and stays inside one octave, so a scale is a set of\n * pitch classes rather than a set of notes: {@link inScale} compares against\n * it with the octave taken out.\n *\n * `ionian` and `aeolian` are the same sets as `major` and `naturalMinor`; both\n * spellings are here because both are what someone reaches for depending on\n * whether they are thinking in keys or in modes.\n */\nexport const scaleIntervals = {\n  major: [0, 2, 4, 5, 7, 9, 11],\n  naturalMinor: [0, 2, 3, 5, 7, 8, 10],\n  harmonicMinor: [0, 2, 3, 5, 7, 8, 11],\n  melodicMinor: [0, 2, 3, 5, 7, 9, 11],\n\n  ionian: [0, 2, 4, 5, 7, 9, 11],\n  dorian: [0, 2, 3, 5, 7, 9, 10],\n  phrygian: [0, 1, 3, 5, 7, 8, 10],\n  lydian: [0, 2, 4, 6, 7, 9, 11],\n  mixolydian: [0, 2, 4, 5, 7, 9, 10],\n  aeolian: [0, 2, 3, 5, 7, 8, 10],\n  locrian: [0, 1, 3, 5, 6, 8, 10],\n\n  majorPentatonic: [0, 2, 4, 7, 9],\n  minorPentatonic: [0, 3, 5, 7, 10],\n  blues: [0, 3, 5, 6, 7, 10],\n\n  wholeTone: [0, 2, 4, 6, 8, 10],\n  chromatic: [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11],\n} as const satisfies Record<string, readonly number[]>\n\nexport type ScaleName = keyof typeof scaleIntervals\n\n/**\n * Whether a note belongs to a scale, regardless of the octave either sits in.\n *\n * @param note noteNumber: 0 ~ 127 or noteName e.g. 'C3'\n * @param root the note the scale is built on, in the same two forms\n *\n * @example\n * ```ts\n * inScale('F#4', 'D3', 'major') // true\n * ```\n */\nexport function inScale(\n  note: number | string,\n  root: number | string,\n  name: ScaleName,\n): boolean {\n  const n = typeof note === 'string' ? noteNumber(note) : note\n  const r = typeof root === 'string' ? noteNumber(root) : root\n  assertSafeInteger(n, 'note number')\n  assertSafeInteger(r, 'root note number')\n  return (scaleIntervals[name] as readonly number[]).includes(mod(n - r, 12))\n}\n\n/**\n * The notes of a scale, ascending from `root`.\n *\n * The octave above the root is not included: ask for more `octaves` instead, so\n * that concatenating the result of two calls does not repeat a note.\n *\n * @param root noteNumber: 0 ~ 127 or noteName e.g. 'C3'\n * @param octaves how many octaves to cover\n *\n * @example\n * ```ts\n * scaleNotes('C3', 'majorPentatonic') // [48, 50, 52, 55, 57]\n * ```\n */\nexport function scaleNotes(\n  root: number | string,\n  name: ScaleName,\n  octaves = 1,\n): number[] {\n  const r = typeof root === 'string' ? noteNumber(root) : root\n  assertSafeInteger(r, 'root note number')\n  if (!Number.isSafeInteger(octaves) || octaves < 0) {\n    throw new RangeError('octaves: requirements: a non-negative safe integer')\n  }\n  const intervals = scaleIntervals[name] as readonly number[]\n  return Array.from({ length: octaves }, (_, octave) =>\n    intervals.map((interval) => r + octave * 12 + interval),\n  ).flat()\n}\n","import { toPrecision } from './math'\n\n/**\n * The SI prefixes {@link unitFormat} chooses between.\n *\n * Deliberately narrower than the full SI set: yocto through yotta are of no\n * use to an audio control, and every extra prefix is one more symbol `parse`\n * has to tell apart from a unit.\n */\nexport type SIPrefix = 'p' | 'n' | 'µ' | 'm' | '' | 'k' | 'M' | 'G'\n\n/** Ordered small to large. The empty symbol is the base unit. */\nconst PREFIXES: readonly [SIPrefix, number][] = [\n  ['p', 1e-12],\n  ['n', 1e-9],\n  ['µ', 1e-6],\n  ['m', 1e-3],\n  ['', 1],\n  ['k', 1e3],\n  ['M', 1e6],\n  ['G', 1e9],\n]\n\nconst PREFIX_SCALE = new Map<string, number>(PREFIXES)\n\n/**\n * Micro is written three ways. `µ` (U+00B5 MICRO SIGN) is what `format`\n * writes and what d3-format uses, `μ` (U+03BC GREEK SMALL LETTER MU) looks\n * identical and is what a Greek keyboard produces, and `u` is what everyone\n * actually types. All three read back the same.\n */\nconst MICRO_ALIASES: Record<string, SIPrefix> = { μ: 'µ', u: 'µ' }\n\nexport interface UnitFormatOptions {\n  /**\n   * The prefix the stored value is already in.\n   *\n   * A control that keeps milliseconds in `value` is `{ base: 'm' }` with a\n   * unit of `'s'`: 1500 then displays as `1.5s`, and `parse` gives 1500 back.\n   *\n   * @default ''\n   */\n  base?: SIPrefix\n  /**\n   * Whether to scale the number and pick a prefix at all.\n   *\n   * Turn it off for anything that is not an SI quantity. dB, %, cents and\n   * semitones do not take prefixes, and `-6dB` read as \"-6 deci-B\" is wrong\n   * rather than merely unusual.\n   *\n   * @default true\n   */\n  prefixes?: boolean\n  /**\n   * Digits after the decimal point. The number is left as-is when omitted.\n   */\n  digits?: number\n  /**\n   * Text placed between the number and the unit.\n   * @default ''\n   */\n  separator?: string\n}\n\n/** The `format` / `parse` pair a `NumberInput` takes. */\nexport interface UnitFormatter {\n  format: (value: number) => string\n  parse: (text: string) => number\n}\n\n/**\n * Divide by a prefix scale without showing the result of doing so in binary.\n *\n * `0.0005 / 1e-6` is 500.00000000000006, and with no `digits` to round it that\n * lands in the input as written.\n */\nfunction scaleBy(value: number, scale: number): number {\n  return toPrecision(value / scale)\n}\n\n/** A number, then whatever followed it. */\nconst NUMBER_THEN_REST =\n  /^([+-]?(?:\\d+(?:\\.\\d*)?|\\.\\d+)(?:[eE][+-]?\\d+)?)\\s*(.*)$/\n\n/**\n * Build the `format` and `parse` of a unit, as one pair.\n *\n * They are returned together because they have to agree: a `format` that\n * writes `1.23kHz` is only useful next to a `parse` that reads it back as\n * 1230. Spread the result into the input.\n *\n * @example\n * unitFormat('Hz')                                 // 1234 -> '1.23kHz'\n * unitFormat('s', { base: 'm' })                   // value in ms. 1500 -> '1.5s'\n * unitFormat('s', { base: 'm', digits: 2 })        // 1500 -> '1.50s'\n * unitFormat('dB', { prefixes: false, digits: 1 }) // -6.25 -> '-6.3dB'\n *\n * @example\n * <NumberInput.Root {...unitFormat('Hz', { digits: 2 })} value={v} onChange={setV}>\n */\nexport function unitFormat(\n  unit: string,\n  options: UnitFormatOptions = {},\n): UnitFormatter {\n  const { base = '', prefixes = true, digits, separator = '' } = options\n  if (unit === '' && base !== '') {\n    throw new RangeError('unitFormat: base requires a non-empty unit')\n  }\n  const baseScale = PREFIX_SCALE.get(base) ?? 1\n\n  /**\n   * `toFixed` renders anything that rounds to zero from below as `-0`, which\n   * is never what a control should show.\n   */\n  const fixed = (value: number) => {\n    const text = digits !== undefined ? value.toFixed(digits) : String(value)\n    return Number(text) === 0 ? text.replace('-', '') : text\n  }\n\n  if (!prefixes) {\n    // The stored value goes out untouched, so the symbol has to name the unit\n    // it is already in.\n    const symbol = base + unit\n    return {\n      format: (value) =>\n        Number.isFinite(value)\n          ? fixed(value) + separator + symbol\n          : String(value),\n      // Nothing after the number can change the scale, so it is all ignored:\n      // the number in front is the value, half-typed or not.\n      parse: (text) => {\n        const match = text.trim().match(NUMBER_THEN_REST)\n        if (!match) return NaN\n        const value = Number(match[1])\n        return Number.isFinite(value) ? value : NaN\n      },\n    }\n  }\n\n  return {\n    format: (value) => {\n      if (!Number.isFinite(value)) return String(value)\n      const si = value * baseScale\n      // Zero has no magnitude to read, so it stays in the base unit.\n      let index = PREFIXES.findIndex(([, scale]) => scale === 1)\n      if (si !== 0) {\n        // The largest prefix that leaves at least one digit before the point.\n        // Below the smallest prefix the number just gets small: `p` is the\n        // floor, as `G` is the ceiling.\n        const magnitude = Math.abs(si)\n        index = 0\n        for (let i = PREFIXES.length - 1; i >= 0; i--) {\n          if (magnitude >= PREFIXES[i][1]) {\n            index = i\n            break\n          }\n        }\n      }\n      let text = fixed(scaleBy(si, PREFIXES[index][1]))\n      // Rounding can carry the number up out of its own prefix — 999.99Hz at\n      // one digit is 1000.0Hz, which should read 1.0kHz. One step is always\n      // enough, since the carry is at most a factor of ten.\n      if (Math.abs(Number(text)) >= 1000 && index < PREFIXES.length - 1) {\n        index += 1\n        text = fixed(scaleBy(si, PREFIXES[index][1]))\n      }\n      return text + separator + PREFIXES[index][0] + unit\n    },\n\n    parse: (text) => {\n      const match = text.trim().match(NUMBER_THEN_REST)\n      if (!match) return NaN\n      const number = Number(match[1])\n      if (!Number.isFinite(number)) return NaN\n\n      let suffix = match[2].trim()\n      const separatorText = separator.trim()\n      if (separatorText !== '' && suffix.startsWith(separatorText)) {\n        suffix = suffix.slice(separatorText.length).trim()\n      }\n      // A bare number is in the unit the value is stored in, which is what\n      // the input shows once the format is stripped.\n      if (suffix === '') return number\n\n      // The unit symbol is matched first, so a unit that is itself a prefix\n      // letter wins over the prefix reading: `5m` for a unit of `m` is five\n      // metres, not five milli-.\n      let prefix: string | null = null\n      if (unit !== '' && suffix.endsWith(unit)) {\n        prefix = suffix.slice(0, suffix.length - unit.length)\n      } else if (suffix.length <= 1) {\n        prefix = suffix\n      }\n      if (prefix === null) return number\n\n      const normalized = MICRO_ALIASES[prefix] ?? prefix\n      const scale = PREFIX_SCALE.get(normalized)\n      // Unrecognised text after the number is ignored rather than rejected,\n      // so that a half-typed entry still yields the number in front of it.\n      if (scale === undefined) return number\n      return (number * scale) / baseScale\n    },\n  }\n}\n"],"mappings":"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"}

package/dist/index.d.cts

@@ -2,35 +2,58 @@
 /**
  * clamp value between min and max
  */
-declare function clamp(value: number, min: number, max: number): number;
+export declare function clamp(value: number, min: number, max: number): number;
 /**
  * Normalize the value from 0 to 1, spreading the range evenly.
  *
  * This is the linear mapping and takes no curve of its own; a `Scale` builds
  * whatever curve it needs on top of it.
  */
-declare function normalizeValue(value: number, min: number, max: number): number;
+export declare function normalizeValue(value: number, min: number, max: number): number;
 /**
  * Convert normalized values back to raw values, spreading the range evenly.
  *
  * The inverse of {@link normalizeValue}.
  */
-declare function rawValue(normalizedValue: number, min: number, max: number): number;
-declare function stepValue(value: number, step: number): number;
-declare function toFixed(x: number, fractionDigits?: number): number;
-declare function integerPart(x: number | string): string | undefined;
-declare function decimalPart(x: number | string): string | undefined;
-declare function radian(degree: number): number;
-declare function degree(radian: number): number;
-declare function mapValue(value: number, inMin: number, inMax: number, outMin: number, outMax: number): number;
-declare function dbToGain(db: number): number;
-declare function gainToDb(gain: number): number;
-//#endregion
-//#region src/types.d.ts
+export declare function rawValue(normalizedValue: number, min: number, max: number): number;
 /**
- * Options for setting the amount of keyboard and mouse wheel changes.
+ * Put a value on the grid the caller asked for, rounding a half step upwards.
+ *
+ * The rounding is done on the quotient rather than by comparing the distance
+ * to the two neighbours, because both of those carry error of their own. The
+ * quotient is cleared of its artefact first: `0.15 / 0.1` is 1.4999999999999998,
+ * and a value sitting exactly on a half step would otherwise fall to whichever
+ * side the last bit happened to land on — 0.25 rounded up while 0.15 and 0.35
+ * rounded down.
  */
-type InputEventOption = ['normalized' | 'raw', number];
+export declare function stepValue(value: number, step: number): number;
+export declare function toFixed(x: number, fractionDigits?: number): number;
+/**
+ * Drop the binary artefact from a computed value.
+ *
+ * Arithmetic on doubles leaves debris in the last couple of digits, and it
+ * accumulates: adding 0.1 to 5 twelve times gives 5.699999999999998 rather
+ * than 5.7, and the display of a control shows exactly that. Rounding to the
+ * digits a double can carry removes it, and adds nothing back — the value was
+ * already the result of a calculation whose own error is that size or larger.
+ *
+ * This is not the same as rounding to a `step`. {@link stepValue} puts a value
+ * on a grid the caller asked for and is a decision about the value; this only
+ * removes what was never in the value to begin with.
+ *
+ * @param significantDigits how many digits to keep. The default is the only
+ * one that is purely artefact removal; a smaller number starts discarding real
+ * precision.
+ *
+ * @example
+ * toPrecision(5.1 + 0.1) // 5.2, rather than 5.199999999999999
+ */
+export declare function toPrecision(x: number, significantDigits?: number): number;
+export declare function radian(degree: number): number;
+export declare function degree(radian: number): number;
+export declare function mapValue(value: number, inMin: number, inMax: number, outMin: number, outMax: number): number;
+export declare function dbToGain(db: number): number;
+export declare function gainToDb(gain: number): number;
 //#endregion
 //#region src/scales.d.ts
 /**
@@ -60,7 +83,7 @@ interface Scale {
  * The right default for anything already linear in perception: dB values,
  * pan, percentages, MIDI note numbers, semitones.
  */
-declare const linearScale: Scale;
+export declare const linearScale: Scale;
 /**
  * The power law of JUCE's `NormalisableRange::skew`, applied to `value - min`.
  *
@@ -77,12 +100,12 @@ declare const linearScale: Scale;
  *
  * @param skew the JUCE skew factor
  */
-declare function skewScale(skew: number): Scale;
+export declare function skewScale(skew: number): Scale;
 /**
  * The skew factor for {@link skewScale} that puts `centerValue` at the middle
  * of the travel — JUCE's `NormalisableRange::setSkewForCentre`.
  */
-declare function skewWithCenterValue(centerValue: number, min: number, max: number): number;
+export declare function skewWithCenterValue(centerValue: number, min: number, max: number): number;
 /**
  * Equal travel gives an equal *ratio*, so an octave — or a percentage — takes
  * the same distance wherever it falls.
@@ -94,7 +117,7 @@ declare function skewWithCenterValue(centerValue: number, min: number, max: numb
  * ratio reaches zero or crosses it. Use {@link curveScale} for a range that
  * starts at 0.
  */
-declare const exponentialScale: Scale;
+export declare const exponentialScale: Scale;
 /**
  * An exponential bend that still passes exactly through `min` and `max`, so
  * unlike {@link exponentialScale} it works on a range that starts at 0 or
@@ -116,7 +139,7 @@ declare const exponentialScale: Scale;
  *
  * @param curve how hard the curve bends, and in which direction
  */
-declare function curveScale(curve: number): Scale;
+export declare function curveScale(curve: number): Scale;
 /**
  * {@link skewScale} mirrored about the middle of the range, so both halves
  * bend the same way — JUCE's `symmetricSkew`.
@@ -129,12 +152,12 @@ declare function curveScale(curve: number): Scale;
  *
  * @param skew the JUCE skew factor
  */
-declare function symmetricSkewScale(skew: number): Scale;
+export declare function symmetricSkewScale(skew: number): Scale;
 /**
  * The curve for {@link curveScale} that puts `centerValue` at the middle of
  * the travel — the counterpart of {@link skewWithCenterValue}.
  */
-declare function curveWithCenterValue(centerValue: number, min: number, max: number): number;
+export declare function curveWithCenterValue(centerValue: number, min: number, max: number): number;
 /**
  * How a value is scaled: the range it lives in, how it is rounded, and how it
  * is distributed across the travel.
@@ -156,33 +179,13 @@ interface ValueRange {
    */
   scale?: Scale;
 }
-/**
- * Move a value by an amount of input, as reported by a wheel or an arrow key.
- *
- * The pipeline matches `createDragValue` of `@tremolo-ui/dom`: scale, then
- * step, then clamp. Which key or which sign of `deltaY` counts as which
- * direction is left to the caller, since it differs per component.
- *
- * @param direction which way, and how many times, to apply the option. The
- * size of one step is `option[1]`, so this is normally `1` or `-1`.
- *
- * @example
- * // ArrowDown on a slider whose keyboard option is ['raw', 1]
- * applyDelta(value, -1, keyboard, { min, max, step, scale })
- */
-declare function applyDelta(value: number, direction: number, [mode, amount]: InputEventOption, {
-  min,
-  max,
-  step,
-  scale
-}: ValueRange): number;
 //#endregion
 //#region src/midi.d.ts
-declare const whiteKeys: readonly ["A", "B", "C", "D", "E", "F", "G"];
+export declare const whiteKeys: readonly ["A", "B", "C", "D", "E", "F", "G"];
 type WhiteKey = (typeof whiteKeys)[number];
-declare const noteKeys: readonly ["C", "C#", "D", "D#", "E", "F", "F#", "G", "G#", "A", "A#", "B"];
+export declare const noteKeys: readonly ["C", "C#", "D", "D#", "E", "F", "F#", "G", "G#", "A", "A#", "B"];
 type NoteKey = (typeof noteKeys)[number];
-declare function parseNoteName(noteName: string): {
+export declare function parseNoteName(noteName: string): {
   letter: WhiteKey;
   accidental: "#" | "##" | "b" | "bb" | "";
   octave: number;
@@ -190,33 +193,33 @@ declare function parseNoteName(noteName: string): {
 /**
  * Convert noteName to noteNumber
  */
-declare function noteNumber(noteName: string): number;
+export declare function noteNumber(noteName: string): number;
 /**
  * Convert noteNumber to noteName
  * C-1 = 0
  * G9 = 127
  * @param noteNumber noteNumber
  */
-declare function noteName(noteNumber: number): `${NoteKey}${number}`;
+export declare function noteName(noteNumber: number): `${NoteKey}${number}`;
 /**
  * Convert noteNumber to noteKey
  */
-declare function noteKey(noteNumber: number): NoteKey;
+export declare function noteKey(noteNumber: number): NoteKey;
 /**
  * @param note noteNumber: 0 ~ 127 or noteName e.g. 'C3'
  */
-declare function isWhiteKey(note: number | string): boolean;
+export declare function isWhiteKey(note: number | string): boolean;
 /**
  * @param note noteNumber: 0 ~ 127 or noteName e.g. 'C3'
  */
-declare function isBlackKey(note: number | string): boolean;
+export declare function isBlackKey(note: number | string): boolean;
 /**
  * @param note noteNumber: 0 ~ 127 or noteName e.g. 'C3'
  * @param detune [cent]
  * @param a4 A4 frequency [Hz]
  * @returns frequency [Hz]
  */
-declare function noteToFrequency(note: number | string, detune?: number, a4?: number): number;
+export declare function noteToFrequency(note: number | string, detune?: number, a4?: number): number;
 /**
  * Semitones above the root, for each supported scale.
  *
@@ -228,7 +231,7 @@ declare function noteToFrequency(note: number | string, detune?: number, a4?: nu
  * spellings are here because both are what someone reaches for depending on
  * whether they are thinking in keys or in modes.
  */
-declare const scaleIntervals: {
+export declare const scaleIntervals: {
   readonly major: readonly [0, 2, 4, 5, 7, 9, 11];
   readonly naturalMinor: readonly [0, 2, 3, 5, 7, 8, 10];
   readonly harmonicMinor: readonly [0, 2, 3, 5, 7, 8, 11];
@@ -258,7 +261,7 @@ type ScaleName = keyof typeof scaleIntervals;
  * inScale('F#4', 'D3', 'major') // true
  * ```
  */
-declare function inScale(note: number | string, root: number | string, name: ScaleName): boolean;
+export declare function inScale(note: number | string, root: number | string, name: ScaleName): boolean;
 /**
  * The notes of a scale, ascending from `root`.
  *
@@ -273,120 +276,69 @@ declare function inScale(note: number | string, root: number | string, name: Sca
  * scaleNotes('C3', 'majorPentatonic') // [48, 50, 52, 55, 57]
  * ```
  */
-declare function scaleNotes(root: number | string, name: ScaleName, octaves?: number): number[];
+export declare function scaleNotes(root: number | string, name: ScaleName, octaves?: number): number[];
 //#endregion
-//#region src/piano.d.ts
-type NoteRange = {
-  first: number;
-  last: number;
-};
-/**
- * `[noteRange.first, noteRange.first + 1, ..., noteRange.last]`
- */
-declare function getNoteRangeArray(noteRange: NoteRange): number[];
+//#region src/unit.d.ts
 /**
- * The geometry of a drawn keyboard.
+ * The SI prefixes {@link unitFormat} chooses between.
  *
- * One description is shared by the drawing and the hit testing, so a key cannot
- * be drawn somewhere other than where it responds.
+ * Deliberately narrower than the full SI set: yocto through yotta are of no
+ * use to an audio control, and every extra prefix is one more symbol `parse`
+ * has to tell apart from a unit.
  */
-interface PianoLayout {
-  noteRange: NoteRange;
-  /** Width of a white key, excluding {@link PianoLayout.keyGap}. */
-  whiteKeyWidth: number;
+type SIPrefix = 'p' | 'n' | 'µ' | 'm' | '' | 'k' | 'M' | 'G';
+interface UnitFormatOptions {
   /**
-   * Space between two white keys. Part of the slot a white key occupies, so it
-   * still belongs to one of the keys for the purpose of hit testing.
+   * The prefix the stored value is already in.
+   *
+   * A control that keeps milliseconds in `value` is `{ base: 'm' }` with a
+   * unit of `'s'`: 1500 then displays as `1.5s`, and `parse` gives 1500 back.
    *
-   * @default 1
+   * @default ''
    */
-  keyGap?: number;
+  base?: SIPrefix;
   /**
-   * Width of a black key, as a fraction of {@link PianoLayout.whiteKeyWidth}.
+   * Whether to scale the number and pick a prefix at all.
+   *
+   * Turn it off for anything that is not an SI quantity. dB, %, cents and
+   * semitones do not take prefixes, and `-6dB` read as "-6 deci-B" is wrong
+   * rather than merely unusual.
    *
-   * @default 0.65
+   * @default true
    */
-  blackKeyWidthRatio?: number;
+  prefixes?: boolean;
   /**
-   * Height of a black key, as a fraction of the height of the keyboard.
-   *
-   * @default 0.6
+   * Digits after the decimal point. The number is left as-is when omitted.
    */
-  blackKeyHeightRatio?: number;
+  digits?: number;
+  /**
+   * Text placed between the number and the unit.
+   * @default ''
+   */
+  separator?: string;
+}
+/** The `format` / `parse` pair a `NumberInput` takes. */
+interface UnitFormatter {
+  format: (value: number) => string;
+  parse: (text: string) => number;
 }
-/** Width of a black key in pixels. */
-declare function blackKeyWidth(layout: PianoLayout): number;
-/** Width of the whole keyboard in pixels. */
-declare function pianoWidth(layout: PianoLayout): number;
-/**
- * Offset of the left edge of a key from the left edge of the keyboard, in
- * pixels.
- *
- * Notes outside `noteRange` are placed too, so the value is negative below
- * `noteRange.first`.
- */
-declare function notePosition(note: number, layout: PianoLayout): number;
-/**
- * The note drawn at a point, or null where there is none.
- *
- * Black keys are tested first, so they win where they overlap a white one. A
- * white key covers its gap as well as its width, so the whole width of the
- * keyboard belongs to some key and a click cannot fall between two.
- *
- * @param x offset from the left edge of the keyboard, in pixels
- * @param y offset from its top edge, in pixels
- * @param height height of the keyboard, in pixels
- */
-declare function noteAt(x: number, y: number, height: number, layout: PianoLayout): number | null;
-//#endregion
-//#region src/unit.d.ts
-/**
- * Units a value can be displayed in, as `[symbol, scale]` pairs ordered from
- * the smallest scale up. A value is shown in the largest unit that does not
- * exceed it.
- *
- * @example
- * [['Hz', 1], ['kHz', 1000]]
- * [['ms', 1], ['s', 1000]]
- */
-type Units = [string, number][];
-/**
- * Pick the unit a value is displayed in: the largest one whose scale does not
- * exceed the magnitude of the value.
- */
-declare function selectUnit(units: Units, value: number): [string, number];
 /**
- * Render a value as text, in the unit that suits its magnitude.
+ * Build the `format` and `parse` of a unit, as one pair.
  *
- * @param units a single symbol appended as-is, or a list to choose from.
- * @param digit digits after the decimal point. Left as-is when omitted.
+ * They are returned together because they have to agree: a `format` that
+ * writes `1.23kHz` is only useful next to a `parse` that reads it back as
+ * 1230. Spread the result into the input.
  *
  * @example
- * formatValue(1234, [['Hz', 1], ['kHz', 1000]], 2) // '1.23kHz'
- * formatValue(1.5, 'Hz')                           // '1.5Hz'
- */
-declare function formatValue(value: number, units?: string | Units, digit?: number): string;
-/**
- * Read a value back out of text, undoing the scaling of {@link formatValue}.
- *
- * With a list of units the text has to be a number followed by an optional
- * unit and nothing else, since the unit decides the scale; anything else reads
- * as 0. With a single unit, or none, the first number found anywhere in the
- * text is taken, so a half-typed entry still yields something.
+ * unitFormat('Hz')                                 // 1234 -> '1.23kHz'
+ * unitFormat('s', { base: 'm' })                   // value in ms. 1500 -> '1.5s'
+ * unitFormat('s', { base: 'm', digits: 2 })        // 1500 -> '1.50s'
+ * unitFormat('dB', { prefixes: false, digits: 1 }) // -6.25 -> '-6.3dB'
  *
  * @example
- * parseValue('1.23kHz', [['Hz', 1], ['kHz', 1000]]) // 1230
- * parseValue('4abc')                                // 4
+ * <NumberInput.Root {...unitFormat('Hz', { digits: 2 })} value={v} onChange={setV}>
  */
-declare function parseValue(text: string, units?: string | Units): number;
-//#endregion
-//#region src/util.d.ts
-type Operator = '+' | '-' | '*' | '/';
-declare function styleHelper(value: string | number): string;
-declare function styleHelper(value: string | number, op: Operator, influencer?: number): string;
-declare function isEmpty(obj: object): boolean;
-declare function mod(n: number, m: number): number;
-declare function xor(a?: boolean, b?: boolean): boolean;
+export declare function unitFormat(unit: string, options?: UnitFormatOptions): UnitFormatter;
 //#endregion
-export { type InputEventOption, type NoteKey, type NoteRange, type PianoLayout, type Scale, type ScaleName, type Units, type ValueRange, type WhiteKey, applyDelta, blackKeyWidth, clamp, curveScale, curveWithCenterValue, dbToGain, decimalPart, degree, exponentialScale, formatValue, gainToDb, getNoteRangeArray, inScale, integerPart, isBlackKey, isEmpty, isWhiteKey, linearScale, mapValue, mod, normalizeValue, noteAt, noteKey, noteKeys, noteName, noteNumber, notePosition, noteToFrequency, parseNoteName, parseValue, pianoWidth, radian, rawValue, scaleIntervals, scaleNotes, selectUnit, skewScale, skewWithCenterValue, stepValue, styleHelper, symmetricSkewScale, toFixed, whiteKeys, xor };
+export type { NoteKey, SIPrefix, Scale, ScaleName, UnitFormatOptions, UnitFormatter, ValueRange, WhiteKey };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../src/math.ts","../src/types.ts","../src/scales.ts","../src/midi.ts","../src/piano.ts","../src/unit.ts","../src/util.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/math.ts","../src/scales.ts","../src/midi.ts","../src/unit.ts"],"mappings":";;;;wBAGgB,MAAM,eAAe,aAAa;;;;;;;wBAUlC,eAAe,eAAe,aAAa;;;;;;wBAU3C,SAAS,yBAAyB,aAAa;;;;;;;;;;;wBAe/C,UAAU,eAAe;wBAUzB,QAAQ,WAAW;;;;;;;;;;;;;;;;;;;;;wBA+BnB,YAAY,WAAW;wBAUvB,OAAO;wBAIP,OAAO;wBAIP,SACd,eACA,eACA,eACA,gBACA;wBAKc,SAAS;wBAIT,SAAS;;;;;;;;;;;;;;;;;;UC9FR;;EAEf,YAAY,eAAe,aAAa;;EAExC,cAAc,kBAAkB,aAAa;;;;;;;;qBAmBlC,aAAa;;;;;;;;;;;;;;;;;wBAqBV,UAAU,eAAe;;;;;wBAsBzB,oBACd,qBACA,aACA;;;;;;;;;;;;qBAmBW,kBAAkB;;;;;;;;;;;;;;;;;;;;;;wBAqDf,WAAW,gBAAgB;;;;;;;;;;;;;wBAmD3B,mBAAmB,eAAe;;;;;wBAiClC,qBACd,qBACA,aACA;;;;;;;;UAkBe;EACf;EACA;;;;EAIA;;;;;;EAMA,QAAQ;;;;qBCxQG;KAED,mBAAmB;qBAElB;KAeD,kBAAkB;wBAQd,cAAc;EAOY,QAAA;EACZ;;;;;;wBAQd,WAAW;;;;;;;wBAeX,SAAS,wBAAwB;;;;wBAUjC,QAAQ,qBAAqB;;;;wBAQ7B,WAAW;;;;wBAiBX,WAAW;;;;;;;wBAUX,gBAAgB,uBAAuB,iBAAY;;;;;;;;;;;;qBAiBtD;;;;;;;;;;;;;;;;;;KAsBD,yBAAyB;;;;;;;;;;;;wBAarB,QACd,uBACA,uBACA,MAAM;;;;;;;;;;;;;;;wBAuBQ,WACd,uBACA,MAAM,WACN;;;;;;;;;;KC1LU;UAwBK;;;;;;;;;EASf,OAAO;;;;;;;;;;EAUP;;;;EAIA;;;;;EAKA;;;UAIe;EACf,SAAS;EACT,QAAQ;;;;;;;;;;;;;;;;;;wBAiCM,WACd,cACA,UAAS,oBACR"}