@libraz/libcantus 1.0.1 → 1.2.0

package/dist/{chunk-E3F4AHAH.cjs → chunk-CGBADIO5.cjs}

@@ -4,34 +4,24 @@
 
 
 
-var _chunkQ2WGKJNNcjs = require('./chunk-Q2WGKJNN.cjs');
 
-// src/core/instrument/articulation.ts
-var ARTICULATIONS = Object.freeze([
-  "accent",
-  "ghost",
-  "staccato",
-  "legato",
-  "slide",
-  "hammer",
-  "mute",
-  "flam",
-  "drag",
-  "roll",
-  "choke",
-  "open"
-]);
+
+
+
+
+
+var _chunkS5BKZZGMcjs = require('./chunk-S5BKZZGM.cjs');
 
 // src/core/instrument/profile.ts
 var LIMBS = Object.freeze(["rightHand", "leftHand", "rightFoot", "leftFoot"]);
 function toInstrumentProfile(value, name = "instrument") {
   if (typeof value !== "object" || value === null) {
-    throw new (0, _chunkQ2WGKJNNcjs.InvalidInputError)(`${name} must be an instrument profile; received ${typeof value}`);
+    throw new (0, _chunkS5BKZZGMcjs.InvalidInputError)(`${name} must be an instrument profile; received ${typeof value}`);
   }
   const data = "toJSON" in value && typeof value.toJSON === "function" ? value.toJSON() : value;
   const kind = _optionalChain([data, 'optionalAccess', _2 => _2.kind]);
   if (kind !== "stringed" && kind !== "percussion") {
-    throw new (0, _chunkQ2WGKJNNcjs.InvalidInputError)(
+    throw new (0, _chunkS5BKZZGMcjs.InvalidInputError)(
       `${name} must be a stringed or percussion profile; received kind ${String(kind)}`
     );
   }
@@ -41,24 +31,60 @@ function toInstrumentProfile(value, name = "instrument") {
 function toStringedProfile(value, name = "instrument") {
   const profile = toInstrumentProfile(value, name);
   if (profile.kind !== "stringed") {
-    throw new (0, _chunkQ2WGKJNNcjs.InvalidInputError)(
+    throw new (0, _chunkS5BKZZGMcjs.InvalidInputError)(
       `${name} must be a stringed instrument; ${profile.name} has no strings`
     );
   }
   return profile;
 }
+var MAX_FRETS = 127;
+var MAX_POLYPHONY = 128;
 function assertProfile(profile) {
+  if (typeof profile.name !== "string" || profile.name === "") {
+    throw new (0, _chunkS5BKZZGMcjs.InvalidInputError)(
+      `instrument name must be a non-empty string; received ${_chunkS5BKZZGMcjs.describeRejected.call(void 0, profile.name)}`
+    );
+  }
+  if (!Array.isArray(profile.articulations)) {
+    throw new (0, _chunkS5BKZZGMcjs.InvalidInputError)(
+      `${profile.name} articulations must be an array; received ${_chunkS5BKZZGMcjs.describeRejected.call(void 0, profile.articulations)}`
+    );
+  }
+  for (const [index, articulation] of profile.articulations.entries()) {
+    _chunkS5BKZZGMcjs.assertOneOf.call(void 0, articulation, _chunkS5BKZZGMcjs.ARTICULATIONS, `${profile.name} articulations[${index}]`);
+  }
+  _chunkS5BKZZGMcjs.assertPositiveInt.call(void 0, profile.polyphony, `${profile.name} polyphony`, MAX_POLYPHONY);
   if (profile.kind === "stringed") {
-    if (profile.tuning.length === 0) {
-      throw new (0, _chunkQ2WGKJNNcjs.InvalidInputError)(`${profile.name} must have at least one string`);
+    if (!Array.isArray(profile.tuning) || profile.tuning.length === 0) {
+      throw new (0, _chunkS5BKZZGMcjs.InvalidInputError)(`${profile.name} must have at least one string`);
     }
-    if (!Number.isInteger(profile.frets) || profile.frets < 0) {
-      throw new (0, _chunkQ2WGKJNNcjs.InvalidInputError)(`${profile.name} frets must be a non-negative integer`);
+    for (const [index, open] of profile.tuning.entries()) {
+      _chunkS5BKZZGMcjs.assertMidiPitch.call(void 0, open, `${profile.name} tuning[${index}]`);
     }
+    _chunkS5BKZZGMcjs.assertInteger.call(void 0, profile.frets, `${profile.name} frets`, 0, MAX_FRETS);
+    _chunkS5BKZZGMcjs.assertInteger.call(void 0, profile.maxStretch, `${profile.name} maxStretch`, 0, MAX_FRETS);
     return;
   }
-  if (Object.keys(profile.reach).length === 0) {
-    throw new (0, _chunkQ2WGKJNNcjs.InvalidInputError)(`${profile.name} must have at least one voice within reach`);
+  if (!Array.isArray(profile.limbs) || profile.limbs.length === 0) {
+    throw new (0, _chunkS5BKZZGMcjs.InvalidInputError)(`${profile.name} must have at least one limb`);
+  }
+  for (const [index, limb] of profile.limbs.entries()) {
+    _chunkS5BKZZGMcjs.assertOneOf.call(void 0, limb, LIMBS, `${profile.name} limbs[${index}]`);
+  }
+  if (typeof profile.reach !== "object" || profile.reach === null) {
+    throw new (0, _chunkS5BKZZGMcjs.InvalidInputError)(
+      `${profile.name} reach must be a table of limbs by voice; received ${_chunkS5BKZZGMcjs.describeRejected.call(void 0, profile.reach)}`
+    );
+  }
+  const voices = Object.keys(profile.reach);
+  for (const key of voices) {
+    _chunkS5BKZZGMcjs.assertMidiPitch.call(void 0, Number(key), `${profile.name} reach pitch`);
+  }
+  if (voices.every((key) => reachOf(profile, Number(key)).length === 0)) {
+    throw new (0, _chunkS5BKZZGMcjs.InvalidInputError)(`${profile.name} must have at least one voice within reach`);
+  }
+  for (const pitch of _nullishCoalesce(profile.overdub, () => ( []))) {
+    _chunkS5BKZZGMcjs.assertMidiPitch.call(void 0, pitch, `${profile.name} overdub pitch`);
   }
 }
 function reachOf(profile, pitch) {
@@ -68,7 +94,9 @@ function reachOf(profile, pitch) {
   return (_nullishCoalesce(profile.reach[pitch], () => ( []))).filter((limb) => profile.limbs.includes(limb));
 }
 function instrumentRange(profile) {
-  assertProfile(profile);
+  return rangeIn(toInstrumentProfile(profile));
+}
+function rangeIn(profile) {
   if (profile.kind === "stringed") {
     let low2 = Number.POSITIVE_INFINITY;
     let high2 = Number.NEGATIVE_INFINITY;
@@ -91,43 +119,56 @@ function instrumentRange(profile) {
   return { low, high };
 }
 function canSound(profile, pitch) {
-  assertProfile(profile);
+  const resolved = toInstrumentProfile(profile, "instrument");
+  _chunkS5BKZZGMcjs.assertMidiPitch.call(void 0, pitch, "pitch");
+  return soundsIn(resolved, pitch);
+}
+function soundsIn(profile, pitch) {
   if (profile.kind === "stringed") {
     return profile.tuning.some((open) => pitch >= open && pitch - open <= profile.frets);
   }
   return reachOf(profile, pitch).length > 0;
 }
 function fingeringsFor(profile, pitch) {
-  assertProfile(profile);
+  const stringed = toStringedProfile(profile, "instrument");
+  _chunkS5BKZZGMcjs.assertMidiPitch.call(void 0, pitch, "pitch");
+  return fingeringsIn(stringed, pitch);
+}
+function fingeringsIn(stringed, pitch) {
   const out = [];
-  for (let string = 0; string < profile.tuning.length; string += 1) {
-    const open = profile.tuning[string];
+  for (let string = 0; string < stringed.tuning.length; string += 1) {
+    const open = stringed.tuning[string];
     if (open === void 0) {
       continue;
     }
     const fret = pitch - open;
-    if (fret >= 0 && fret <= profile.frets) {
+    if (fret >= 0 && fret <= stringed.frets) {
       out.push({ string, fret });
     }
   }
   return out;
 }
 function foldIntoRange(pitch, profile) {
-  if (canSound(profile, pitch)) {
+  const resolved = toInstrumentProfile(profile, "instrument");
+  _chunkS5BKZZGMcjs.assertMidiPitch.call(void 0, pitch, "pitch");
+  return foldIn(pitch, resolved);
+}
+function foldIn(pitch, resolved) {
+  if (soundsIn(resolved, pitch)) {
     return pitch;
   }
-  const { low, high } = instrumentRange(profile);
-  for (let candidate = pitch + 12; candidate <= high; candidate += 12) {
-    if (canSound(profile, candidate)) {
-      return candidate;
+  const { low, high } = rangeIn(resolved);
+  const first = pitch + 12 * Math.ceil((low - pitch) / 12);
+  let best;
+  for (let candidate = first; candidate <= high; candidate += 12) {
+    if (!soundsIn(resolved, candidate)) {
+      continue;
     }
-  }
-  for (let candidate = pitch - 12; candidate >= low; candidate -= 12) {
-    if (canSound(profile, candidate)) {
-      return candidate;
+    if (best === void 0 || Math.abs(candidate - pitch) <= Math.abs(best - pitch)) {
+      best = candidate;
     }
   }
-  return pitch;
+  return _nullishCoalesce(best, () => ( pitch));
 }
 
 // src/core/instrument/playability.ts
@@ -138,13 +179,13 @@ var DIFFICULTY_SCALE = 12;
 var MIN_DIFFICULTY = 1;
 var MAX_DIFFICULTY = 5;
 var STRING_CROSSING_COST = 2;
-var ONSET_GRID = 128;
-var EPS = 1e-9;
+var SIMULTANEITY_BEATS = 1 / 128;
 function playability(notes, profile, bpm) {
-  _chunkQ2WGKJNNcjs.assertNoteEvents.call(void 0, notes, "playability notes", { allowNonPositiveDuration: true });
+  _chunkS5BKZZGMcjs.assertNoteEvents.call(void 0, notes, "playability notes", { allowNonPositiveDuration: true });
   if (bpm !== void 0) {
-    _chunkQ2WGKJNNcjs.assertRange.call(void 0, bpm, Number.MIN_VALUE, 1e3, "playability bpm");
+    _chunkS5BKZZGMcjs.assertRange.call(void 0, bpm, Number.MIN_VALUE, 1e3, "playability bpm");
   }
+  const instrument = toInstrumentProfile(profile, "playability profile");
   const order = notes.map((_, index) => index).sort((a, b) => {
     const left = notes[a];
     const right = notes[b];
@@ -161,11 +202,13 @@ function playability(notes, profile, bpm) {
     movement: 0,
     secondsPerBeat: bpm === void 0 ? void 0 : 60 / bpm
   };
-  checkExistence(state, profile);
-  if (profile.kind === "stringed") {
-    placeOnNeck(state, profile);
+  if (instrument.kind === "stringed") {
+    checkExistence(state, instrument, (pitch) => soundsIn(instrument, pitch));
+    placeOnNeck(state, instrument);
   } else {
-    placeOnKit(state, profile);
+    const kit = readKit(instrument);
+    checkExistence(state, instrument, (pitch) => limbsFor(kit, pitch).length > 0);
+    placeOnKit(state, kit);
   }
   return {
     difficulty: difficultyOf(state, bpm),
@@ -173,13 +216,13 @@ function playability(notes, profile, bpm) {
     placements: state.placements
   };
 }
-function checkExistence(state, profile) {
+function checkExistence(state, profile, sounds) {
   for (const index of state.order) {
     const note = state.notes[index];
     if (!note) {
       continue;
     }
-    if (!canSound(profile, note.pitch)) {
+    if (!sounds(note.pitch)) {
       state.issues.push({
         type: "noteOutOfRange",
         layer: 1,
@@ -202,33 +245,35 @@ function checkExistence(state, profile) {
     }
   }
 }
+function isSimultaneous(anchorBeat, startBeat) {
+  return startBeat - anchorBeat <= SIMULTANEITY_BEATS + _chunkS5BKZZGMcjs.BEAT_EPS;
+}
 function soundingGroups(state) {
   const groups = [];
   let active = [];
   let cursor = 0;
-  let previousKey = Number.NaN;
+  let anchor;
   for (const index of state.order) {
     const note = state.notes[index];
     if (!note) {
       continue;
     }
-    const key = Math.round(note.startBeat * ONSET_GRID);
-    if (key === previousKey) {
+    if (anchor !== void 0 && isSimultaneous(anchor, note.startBeat)) {
       continue;
     }
-    previousKey = key;
     const at = note.startBeat;
+    anchor = at;
     active = active.filter((member) => {
       const held = state.notes[member];
-      return held !== void 0 && held.startBeat + held.durationBeat > at + EPS;
+      return held !== void 0 && held.startBeat + held.durationBeat > at + _chunkS5BKZZGMcjs.BEAT_EPS;
     });
     while (cursor < state.order.length) {
       const candidateIndex = state.order[cursor];
       const candidate = candidateIndex === void 0 ? void 0 : state.notes[candidateIndex];
-      if (!candidate || candidate.startBeat > at + EPS) {
+      if (!candidate || !isSimultaneous(at, candidate.startBeat)) {
         break;
       }
-      if (candidateIndex !== void 0 && candidate.startBeat + candidate.durationBeat > at + EPS) {
+      if (candidateIndex !== void 0 && candidate.startBeat + candidate.durationBeat > at + _chunkS5BKZZGMcjs.BEAT_EPS) {
         active.push(candidateIndex);
       }
       cursor += 1;
@@ -248,12 +293,12 @@ function placeOnNeck(state, profile) {
     if (!note || !placement) {
       continue;
     }
-    const candidates = fingeringsFor(profile, note.pitch);
+    const candidates = fingeringsIn(profile, note.pitch);
     if (candidates.length === 0) {
       continue;
     }
     const free = candidates.filter(
-      (candidate) => (_nullishCoalesce(stringFreeAt[candidate.string], () => ( 0))) <= note.startBeat + EPS
+      (candidate) => (_nullishCoalesce(stringFreeAt[candidate.string], () => ( 0))) <= note.startBeat + _chunkS5BKZZGMcjs.BEAT_EPS
     );
     if (free.length === 0) {
       const blocked = candidates.map((candidate) => stringHeldBy[candidate.string]).filter((held) => held !== void 0);
@@ -304,7 +349,7 @@ function checkShiftSpeed(state, profile, fromIndex, toIndex, from, to) {
   }
   const seconds = (note.startBeat - previousNote.startBeat) * secondsPerBeat;
   const shift = Math.abs(to.fret - from.fret);
-  if (seconds <= EPS || shift === 0) {
+  if (seconds <= _chunkS5BKZZGMcjs.BEAT_EPS || shift === 0) {
     return;
   }
   if (shift / seconds > MAX_FRET_SHIFT_PER_SECOND) {
@@ -350,61 +395,103 @@ function checkPolyphony(state, profile, group) {
     message: `${group.members.length} notes sound at once; ${profile.name} has ${profile.polyphony}`
   });
 }
-function placeOnKit(state, profile) {
-  const limbForVoice = /* @__PURE__ */ new Map();
-  const lastStroke = /* @__PURE__ */ new Map();
+var NO_LIMBS = Object.freeze([]);
+function readKit(profile) {
+  const limbs = /* @__PURE__ */ new Map();
+  for (const key of Object.keys(profile.reach)) {
+    const pitch = Number(key);
+    limbs.set(pitch, reachOf(profile, pitch));
+  }
+  return { profile, limbs, overdub: new Set(_nullishCoalesce(profile.overdub, () => ( []))) };
+}
+function limbsFor(kit, pitch) {
+  if (pitch === void 0) {
+    return NO_LIMBS;
+  }
+  return _nullishCoalesce(kit.limbs.get(pitch), () => ( NO_LIMBS));
+}
+function passesAt(state, kit, members) {
+  const played = { id: "kit", members: [] };
+  const overdubs = /* @__PURE__ */ new Map();
+  for (const index of members) {
+    const pitch = _optionalChain([state, 'access', _6 => _6.notes, 'access', _7 => _7[index], 'optionalAccess', _8 => _8.pitch]);
+    if (pitch === void 0 || !kit.overdub.has(pitch)) {
+      played.members.push(index);
+      continue;
+    }
+    let pass = overdubs.get(pitch);
+    if (!pass) {
+      pass = { id: `overdub ${pitch}`, members: [] };
+      overdubs.set(pitch, pass);
+    }
+    pass.members.push(index);
+  }
+  return [played, ...overdubs.values()];
+}
+function placePass(state, kit, pass, memory) {
+  const taken = /* @__PURE__ */ new Set();
+  let conflicted = false;
+  const members = [...pass.members].sort((a, b) => {
+    const left = limbsFor(kit, _optionalChain([state, 'access', _9 => _9.notes, 'access', _10 => _10[a], 'optionalAccess', _11 => _11.pitch]));
+    const right = limbsFor(kit, _optionalChain([state, 'access', _12 => _12.notes, 'access', _13 => _13[b], 'optionalAccess', _14 => _14.pitch]));
+    return left.length - right.length || a - b;
+  });
+  for (const index of members) {
+    const note = state.notes[index];
+    const placement = state.placements[index];
+    if (!note || !placement) {
+      continue;
+    }
+    const candidates = limbsFor(kit, note.pitch);
+    if (candidates.length === 0) {
+      continue;
+    }
+    const preferred = memory.limbForVoice.get(note.pitch);
+    const free = candidates.filter((limb) => !taken.has(limb));
+    const chosen = free.length === 0 ? candidates[0] : preferred !== void 0 && free.includes(preferred) ? preferred : free[0];
+    if (free.length === 0) {
+      conflicted = true;
+    }
+    if (chosen === void 0) {
+      continue;
+    }
+    taken.add(chosen);
+    placement.limb = chosen;
+    memory.limbForVoice.set(note.pitch, chosen);
+    state.movement += 1;
+    const strokeKey = `${pass.id} ${chosen}`;
+    const previousIndex = memory.lastStroke.get(strokeKey);
+    if (previousIndex !== void 0) {
+      const previousNote = state.notes[previousIndex];
+      if (previousNote && previousNote.pitch !== note.pitch) {
+        state.movement += 1;
+      }
+      checkStrokeSpeed(state, kit.profile, previousIndex, index, chosen);
+    }
+    memory.lastStroke.set(strokeKey, index);
+  }
+  return conflicted;
+}
+function placeOnKit(state, kit) {
+  const memory = { limbForVoice: /* @__PURE__ */ new Map(), lastStroke: /* @__PURE__ */ new Map() };
   for (const group of onsetGroups(state)) {
-    const taken = /* @__PURE__ */ new Set();
     let conflicted = false;
-    const members = [...group.members].sort((a, b) => {
-      const left = reachOf(profile, _optionalChain([state, 'access', _6 => _6.notes, 'access', _7 => _7[a], 'optionalAccess', _8 => _8.pitch]));
-      const right = reachOf(profile, _optionalChain([state, 'access', _9 => _9.notes, 'access', _10 => _10[b], 'optionalAccess', _11 => _11.pitch]));
-      return left.length - right.length || a - b;
-    });
-    for (const index of members) {
-      const note = state.notes[index];
-      const placement = state.placements[index];
-      if (!note || !placement) {
+    for (const pass of passesAt(state, kit, group.members)) {
+      if (!placePass(state, kit, pass, memory)) {
         continue;
       }
-      const candidates = reachOf(profile, note.pitch);
-      if (candidates.length === 0) {
-        continue;
-      }
-      const preferred = limbForVoice.get(note.pitch);
-      const free = candidates.filter((limb) => !taken.has(limb));
-      const chosen = free.length === 0 ? candidates[0] : preferred !== void 0 && free.includes(preferred) ? preferred : free[0];
-      if (free.length === 0) {
-        conflicted = true;
-      }
-      if (chosen === void 0) {
-        continue;
-      }
-      taken.add(chosen);
-      placement.limb = chosen;
-      limbForVoice.set(note.pitch, chosen);
-      state.movement += 1;
-      const previousIndex = lastStroke.get(chosen);
-      if (previousIndex !== void 0) {
-        const previousNote = state.notes[previousIndex];
-        if (previousNote && previousNote.pitch !== note.pitch) {
-          state.movement += 1;
-        }
-        checkStrokeSpeed(state, profile, previousIndex, index, chosen);
-      }
-      lastStroke.set(chosen, index);
-    }
-    if (conflicted) {
+      conflicted = true;
       state.issues.push({
         type: "limbConflict",
         layer: 2,
-        notes: [...group.members].sort((a, b) => a - b),
+        notes: [...pass.members].sort((a, b) => a - b),
         startBeat: group.startBeat,
         impossible: true,
-        message: `${group.members.length} simultaneous strokes cannot be shared among the limbs of ${profile.name}`
+        message: `${pass.members.length} simultaneous strokes cannot be shared among the limbs of ${kit.profile.name}`
       });
-    } else {
-      checkPolyphony(state, profile, group);
+    }
+    if (!conflicted) {
+      checkPolyphony(state, kit.profile, group);
     }
   }
 }
@@ -419,7 +506,7 @@ function checkStrokeSpeed(state, profile, fromIndex, toIndex, limb) {
     return;
   }
   const seconds = (note.startBeat - previousNote.startBeat) * secondsPerBeat;
-  if (seconds <= EPS || seconds >= MIN_LIMB_STROKE_SECONDS) {
+  if (seconds <= _chunkS5BKZZGMcjs.BEAT_EPS || seconds >= MIN_LIMB_STROKE_SECONDS) {
     return;
   }
   state.issues.push({
@@ -433,18 +520,15 @@ function checkStrokeSpeed(state, profile, fromIndex, toIndex, limb) {
 }
 function onsetGroups(state) {
   const groups = [];
-  let key = Number.NaN;
   let current;
   for (const index of state.order) {
     const note = state.notes[index];
-    if (!note) {
+    if (!note || note.durationBeat <= 0) {
       continue;
     }
-    const onsetKey = Math.round(note.startBeat * ONSET_GRID);
-    if (!current || onsetKey !== key) {
+    if (!current || !isSimultaneous(current.startBeat, note.startBeat)) {
       current = { startBeat: note.startBeat, members: [] };
       groups.push(current);
-      key = onsetKey;
     }
     current.members.push(index);
   }
@@ -461,7 +545,7 @@ function difficultyOf(state, bpm) {
     last = Math.max(last, note.startBeat + Math.max(0, note.durationBeat));
   }
   const spanBeats = last - first;
-  if (!Number.isFinite(spanBeats) || spanBeats <= EPS) {
+  if (!Number.isFinite(spanBeats) || spanBeats <= _chunkS5BKZZGMcjs.BEAT_EPS) {
     return MIN_DIFFICULTY;
   }
   const seconds = spanBeats * 60 / (_nullishCoalesce(bpm, () => ( REFERENCE_BPM)));
@@ -558,7 +642,7 @@ function absorbSegment(hash, segment, index) {
     return next;
   }
   if (typeof segment === "number") {
-    _chunkQ2WGKJNNcjs.assertFiniteNumber.call(void 0, segment, `seed path segment ${index}`);
+    _chunkS5BKZZGMcjs.assertFiniteNumber.call(void 0, segment, `seed path segment ${index}`);
     numberBytes.setFloat64(0, segment === 0 ? 0 : segment, true);
     let next = absorb(hash, TAG_NUMBER);
     for (let i = 0; i < 8; i += 1) {
@@ -566,7 +650,7 @@ function absorbSegment(hash, segment, index) {
     }
     return next;
   }
-  throw new (0, _chunkQ2WGKJNNcjs.InvalidInputError)(
+  throw new (0, _chunkS5BKZZGMcjs.InvalidInputError)(
     `seed path segment ${index} must be a string or a number; received ${typeof segment}`
   );
 }
@@ -576,7 +660,7 @@ function hashPath(domain, root, path) {
   for (let index = 0; index < path.length; index += 1) {
     const segment = path[index];
     if (segment === void 0) {
-      throw new (0, _chunkQ2WGKJNNcjs.InvalidInputError)(
+      throw new (0, _chunkS5BKZZGMcjs.InvalidInputError)(
         `seed path segment ${index} must be a string or a number; received undefined`
       );
     }
@@ -587,23 +671,23 @@ function hashPath(domain, root, path) {
 
 // src/core/random/positional.ts
 function createPositionalRng(seed) {
-  _chunkQ2WGKJNNcjs.assertInteger.call(void 0, seed, "seed", 0, 4294967295);
+  _chunkS5BKZZGMcjs.assertInteger.call(void 0, seed, "seed", 0, 4294967295);
   return {
     at: (...path) => hashPath(DOMAIN_POSITION, seed, path) / UINT32_RANGE
   };
 }
 function includeAt(rng, complexity, ...path) {
-  _chunkQ2WGKJNNcjs.assertRange.call(void 0, complexity, 0, 1, "complexity");
+  _chunkS5BKZZGMcjs.assertRange.call(void 0, complexity, 0, 1, "complexity");
   const draw = rng.at(...path);
   if (!(draw >= 0 && draw < 1)) {
-    throw new (0, _chunkQ2WGKJNNcjs.InvalidInputError)(`positional draw must be in [0, 1); received ${draw}`);
+    throw new (0, _chunkS5BKZZGMcjs.InvalidInputError)(`positional draw must be in [0, 1); received ${draw}`);
   }
   return draw < complexity;
 }
 
 // src/core/random/seed.ts
 function deriveSeed(root, ...path) {
-  _chunkQ2WGKJNNcjs.assertInteger.call(void 0, root, "root seed", 0, 4294967295);
+  _chunkS5BKZZGMcjs.assertInteger.call(void 0, root, "root seed", 0, 4294967295);
   return hashPath(DOMAIN_SEED, root, path);
 }
 
@@ -614,9 +698,9 @@ function resolveAlgorithmVersion(requested) {
   if (requested === void 0) {
     return ALGORITHM_VERSION;
   }
-  _chunkQ2WGKJNNcjs.assertInteger.call(void 0, requested, "algorithm version");
+  _chunkS5BKZZGMcjs.assertInteger.call(void 0, requested, "algorithm version");
   if (requested < MIN_ALGORITHM_VERSION || requested > ALGORITHM_VERSION) {
-    throw new (0, _chunkQ2WGKJNNcjs.InvalidInputError)(
+    throw new (0, _chunkS5BKZZGMcjs.InvalidInputError)(
       `algorithm version ${requested} is not produced by this build; supported versions are ${MIN_ALGORITHM_VERSION}..${ALGORITHM_VERSION}`
     );
   }
@@ -625,7 +709,7 @@ function resolveAlgorithmVersion(requested) {
 
 // src/core/random/index.ts
 function createRng(seed) {
-  _chunkQ2WGKJNNcjs.assertInteger.call(void 0, seed, "seed", 0, 4294967295);
+  _chunkS5BKZZGMcjs.assertInteger.call(void 0, seed, "seed", 0, 4294967295);
   let state = seed >>> 0;
   const next = () => {
     state = state + 1831565813 >>> 0;
@@ -637,29 +721,29 @@ function createRng(seed) {
   return {
     next,
     prob: (p) => {
-      _chunkQ2WGKJNNcjs.assertRange.call(void 0, p, 0, 1, "probability");
+      _chunkS5BKZZGMcjs.assertRange.call(void 0, p, 0, 1, "probability");
       return next() < p;
     },
     range: (lo, hi) => {
-      _chunkQ2WGKJNNcjs.assertInteger.call(void 0, lo, "range lower bound");
-      _chunkQ2WGKJNNcjs.assertInteger.call(void 0, hi, "range upper bound");
+      _chunkS5BKZZGMcjs.assertInteger.call(void 0, lo, "range lower bound");
+      _chunkS5BKZZGMcjs.assertInteger.call(void 0, hi, "range upper bound");
       if (lo > hi) {
-        throw new (0, _chunkQ2WGKJNNcjs.InvalidInputError)(
+        throw new (0, _chunkS5BKZZGMcjs.InvalidInputError)(
           `range lower bound must not exceed upper bound; received ${lo} > ${hi}`
         );
       }
-      _chunkQ2WGKJNNcjs.assertInteger.call(void 0, hi - lo, "range span", 0);
+      _chunkS5BKZZGMcjs.assertInteger.call(void 0, hi - lo, "range span", 0);
       return lo + Math.floor(next() * (hi - lo + 1));
     },
     float: (lo, hi) => {
-      _chunkQ2WGKJNNcjs.assertFiniteNumber.call(void 0, lo, "float lower bound");
-      _chunkQ2WGKJNNcjs.assertFiniteNumber.call(void 0, hi, "float upper bound");
+      _chunkS5BKZZGMcjs.assertFiniteNumber.call(void 0, lo, "float lower bound");
+      _chunkS5BKZZGMcjs.assertFiniteNumber.call(void 0, hi, "float upper bound");
       if (lo > hi) {
-        throw new (0, _chunkQ2WGKJNNcjs.InvalidInputError)(
+        throw new (0, _chunkS5BKZZGMcjs.InvalidInputError)(
           `float lower bound must not exceed upper bound; received ${lo} > ${hi}`
         );
       }
-      _chunkQ2WGKJNNcjs.assertFiniteNumber.call(void 0, hi - lo, "float span");
+      _chunkS5BKZZGMcjs.assertFiniteNumber.call(void 0, hi - lo, "float span");
       return lo + next() * (hi - lo);
     }
   };
@@ -686,5 +770,8 @@ function createRng(seed) {
 
 
 
-exports.ARTICULATIONS = ARTICULATIONS; exports.LIMBS = LIMBS; exports.toInstrumentProfile = toInstrumentProfile; exports.toStringedProfile = toStringedProfile; exports.instrumentRange = instrumentRange; exports.canSound = canSound; exports.fingeringsFor = fingeringsFor; exports.foldIntoRange = foldIntoRange; exports.playability = playability; exports.BASS_4_STRING = BASS_4_STRING; exports.BASS_5_STRING = BASS_5_STRING; exports.GUITAR_STANDARD = GUITAR_STANDARD; exports.GUITAR_DROP_D = GUITAR_DROP_D; exports.createPositionalRng = createPositionalRng; exports.includeAt = includeAt; exports.deriveSeed = deriveSeed; exports.ALGORITHM_VERSION = ALGORITHM_VERSION; exports.MIN_ALGORITHM_VERSION = MIN_ALGORITHM_VERSION; exports.resolveAlgorithmVersion = resolveAlgorithmVersion; exports.createRng = createRng;
-//# sourceMappingURL=chunk-E3F4AHAH.cjs.map
+
+
+
+exports.LIMBS = LIMBS; exports.toInstrumentProfile = toInstrumentProfile; exports.toStringedProfile = toStringedProfile; exports.instrumentRange = instrumentRange; exports.rangeIn = rangeIn; exports.canSound = canSound; exports.soundsIn = soundsIn; exports.fingeringsFor = fingeringsFor; exports.fingeringsIn = fingeringsIn; exports.foldIntoRange = foldIntoRange; exports.foldIn = foldIn; exports.playability = playability; exports.BASS_4_STRING = BASS_4_STRING; exports.BASS_5_STRING = BASS_5_STRING; exports.GUITAR_STANDARD = GUITAR_STANDARD; exports.GUITAR_DROP_D = GUITAR_DROP_D; exports.createPositionalRng = createPositionalRng; exports.includeAt = includeAt; exports.deriveSeed = deriveSeed; exports.ALGORITHM_VERSION = ALGORITHM_VERSION; exports.MIN_ALGORITHM_VERSION = MIN_ALGORITHM_VERSION; exports.resolveAlgorithmVersion = resolveAlgorithmVersion; exports.createRng = createRng;
+//# sourceMappingURL=chunk-CGBADIO5.cjs.map