pepperscore 0.2.0 → 0.4.0

package/dist/range-fit-core-B1rMWdI4.js

@@ -0,0 +1,468 @@
+//#region src/lib/instrument-model.ts
+var e = [
+	"piano",
+	"guitar",
+	"bassguitar",
+	"double-bass",
+	"drum-kit",
+	"alto-saxophone",
+	"tenor-saxophone",
+	"bari-saxophone",
+	"flute",
+	"clarinet",
+	"trumpet",
+	"trombone",
+	"violin",
+	"viola",
+	"cello",
+	"microphone"
+], t = [
+	"beginner",
+	"intermediate",
+	"advanced"
+], n = (e, t, n) => Object.freeze({
+	beginner: Object.freeze({
+		low: e[0],
+		high: e[1]
+	}),
+	intermediate: Object.freeze({
+		low: t[0],
+		high: t[1]
+	}),
+	advanced: Object.freeze({
+		low: n[0],
+		high: n[1]
+	})
+}), r = Object.freeze({
+	semitones: 0,
+	diatonic: 0
+}), i = Object.freeze({
+	semitones: 12,
+	diatonic: 7
+}), a = Object.freeze({
+	semitones: 2,
+	diatonic: 1
+}), o = {
+	piano: {
+		id: "piano",
+		label: "Piano",
+		gmProgram: 1,
+		clef: "treble",
+		transposition: r,
+		ranges: n([21, 108], [21, 108], [21, 108])
+	},
+	guitar: {
+		id: "guitar",
+		label: "Guitar",
+		gmProgram: 25,
+		clef: "treble",
+		transposition: i,
+		ranges: n([40, 64], [40, 76], [40, 88])
+	},
+	bassguitar: {
+		id: "bassguitar",
+		label: "Bass Guitar",
+		gmProgram: 34,
+		clef: "bass",
+		transposition: i,
+		ranges: n([28, 48], [28, 55], [28, 60])
+	},
+	"double-bass": {
+		id: "double-bass",
+		label: "Double Bass",
+		gmProgram: 33,
+		clef: "bass",
+		transposition: i,
+		ranges: n([28, 48], [28, 55], [28, 64])
+	},
+	"drum-kit": {
+		id: "drum-kit",
+		label: "Drum Kit",
+		gmProgram: 1,
+		clef: "percussion",
+		transposition: r
+	},
+	"alto-saxophone": {
+		id: "alto-saxophone",
+		label: "Alto Saxophone",
+		short: "Alto Sax",
+		gmProgram: 66,
+		clef: "treble",
+		transposition: {
+			semitones: 9,
+			diatonic: 5
+		},
+		ranges: n([49, 69], [49, 77], [49, 81])
+	},
+	"tenor-saxophone": {
+		id: "tenor-saxophone",
+		label: "Tenor Saxophone",
+		short: "Tenor Sax",
+		gmProgram: 67,
+		clef: "treble",
+		transposition: {
+			semitones: 14,
+			diatonic: 8
+		},
+		ranges: n([44, 64], [44, 72], [44, 76])
+	},
+	"bari-saxophone": {
+		id: "bari-saxophone",
+		label: "Baritone Saxophone",
+		short: "Bari Sax",
+		gmProgram: 68,
+		clef: "treble",
+		transposition: {
+			semitones: 21,
+			diatonic: 12
+		},
+		ranges: n([37, 57], [37, 65], [36, 69])
+	},
+	flute: {
+		id: "flute",
+		label: "Flute",
+		gmProgram: 74,
+		clef: "treble",
+		transposition: r,
+		ranges: n([60, 84], [60, 91], [59, 96])
+	},
+	clarinet: {
+		id: "clarinet",
+		label: "Clarinet",
+		gmProgram: 72,
+		clef: "treble",
+		transposition: a,
+		ranges: n([50, 74], [50, 82], [50, 91])
+	},
+	trumpet: {
+		id: "trumpet",
+		label: "Trumpet",
+		gmProgram: 57,
+		clef: "treble",
+		transposition: a,
+		ranges: n([55, 72], [54, 79], [52, 86])
+	},
+	trombone: {
+		id: "trombone",
+		label: "Trombone",
+		gmProgram: 58,
+		clef: "bass",
+		transposition: r,
+		ranges: n([46, 65], [40, 70], [34, 77])
+	},
+	violin: {
+		id: "violin",
+		label: "Violin",
+		gmProgram: 41,
+		clef: "treble",
+		transposition: r,
+		ranges: n([55, 81], [55, 91], [55, 105])
+	},
+	viola: {
+		id: "viola",
+		label: "Viola",
+		gmProgram: 42,
+		clef: "alto",
+		transposition: r,
+		ranges: n([48, 76], [48, 84], [48, 96])
+	},
+	cello: {
+		id: "cello",
+		label: "Cello",
+		gmProgram: 43,
+		clef: "bass",
+		transposition: r,
+		ranges: n([36, 64], [36, 76], [36, 88])
+	},
+	microphone: {
+		id: "microphone",
+		label: "Voice",
+		gmProgram: 54,
+		clef: "treble",
+		transposition: r,
+		ranges: n([48, 72], [45, 76], [40, 81])
+	}
+};
+for (let e of Object.values(o)) Object.freeze(e.transposition), Object.freeze(e);
+var s = Object.freeze(o), c = (e) => s[e].short ?? s[e].label, l = [
+	[
+		1,
+		24,
+		"piano"
+	],
+	[
+		25,
+		32,
+		"guitar"
+	],
+	[
+		33,
+		33,
+		"double-bass"
+	],
+	[
+		34,
+		40,
+		"bassguitar"
+	],
+	[
+		41,
+		41,
+		"violin"
+	],
+	[
+		42,
+		42,
+		"viola"
+	],
+	[
+		43,
+		43,
+		"cello"
+	],
+	[
+		44,
+		44,
+		"double-bass"
+	],
+	[
+		45,
+		52,
+		"violin"
+	],
+	[
+		53,
+		55,
+		"microphone"
+	],
+	[
+		57,
+		57,
+		"trumpet"
+	],
+	[
+		58,
+		59,
+		"trombone"
+	],
+	[
+		60,
+		60,
+		"trumpet"
+	],
+	[
+		61,
+		61,
+		"trombone"
+	],
+	[
+		62,
+		64,
+		"trumpet"
+	],
+	[
+		65,
+		66,
+		"alto-saxophone"
+	],
+	[
+		67,
+		67,
+		"tenor-saxophone"
+	],
+	[
+		68,
+		68,
+		"bari-saxophone"
+	],
+	[
+		69,
+		72,
+		"clarinet"
+	],
+	[
+		73,
+		80,
+		"flute"
+	]
+];
+function u(e) {
+	return s[l.find(([t, n]) => e >= t && e <= n)?.[2] ?? "piano"];
+}
+var d = [
+	"C",
+	"D",
+	"E",
+	"F",
+	"G",
+	"A",
+	"B"
+], f = [
+	"F",
+	"C",
+	"G",
+	"D",
+	"A",
+	"E",
+	"B"
+], p = {
+	C: 0,
+	D: 2,
+	E: 4,
+	F: 5,
+	G: 7,
+	A: 9,
+	B: 11
+}, m = (e) => (e.octave + 1) * 12 + p[e.step] + e.alter;
+function h(e, t) {
+	return t > 0 ? +(f.indexOf(e) < t) : t < 0 && f.length - 1 - f.indexOf(e) < -t ? -1 : 0;
+}
+function g(e, t, n) {
+	let r = [];
+	for (let t of d) for (let n = Math.floor(e / 12) - 2; n <= Math.floor(e / 12); n++) {
+		let i = e - m({
+			step: t,
+			octave: n,
+			alter: 0
+		});
+		i >= -2 && i <= 2 && r.push({
+			step: t,
+			octave: n,
+			alter: i
+		});
+	}
+	let i = n >= 0 ? 1 : -1, a = (e) => e.alter === h(e.step, t) ? 0 : e.alter === 0 ? 1 : e.alter === i ? 2 : e.alter === -i ? 3 : 4;
+	return r.sort((e, t) => a(e) - a(t))[0];
+}
+function _(e, t) {
+	return m(e) - t.semitones;
+}
+function v(e, t, n) {
+	return g(e + t.semitones, n, n < 0 ? -1 : 1);
+}
+function y(e, t, n) {
+	let r = e.octave * 7 + d.indexOf(e.step) + t.diatonic, i = Math.floor(r / 7), a = d[r - i * 7], o = m(e) + t.semitones, s = o - m({
+		step: a,
+		octave: i,
+		alter: 0
+	});
+	return Math.abs(s) <= 2 ? {
+		pitch: {
+			step: a,
+			octave: i,
+			alter: s
+		},
+		respelled: !1
+	} : {
+		pitch: v(o, {
+			semitones: 0,
+			diatonic: 0
+		}, n),
+		respelled: !0
+	};
+}
+var b = (e, t) => y(e, t, 0).pitch;
+function x(e, t) {
+	let n = (7 * t.semitones % 12 + 12) % 12;
+	n > 6 && (n -= 12);
+	let r = e + n;
+	return r > 7 ? r - 12 : r < -7 ? r + 12 : r;
+}
+var S = Object.freeze([
+	"alto-saxophone",
+	"tenor-saxophone",
+	"bari-saxophone",
+	"trumpet",
+	"trombone",
+	"flute",
+	"clarinet",
+	"violin",
+	"viola",
+	"cello",
+	"double-bass"
+]);
+//#endregion
+//#region src/lib/range-fit-core.ts
+function C(e, t) {
+	let n = /* @__PURE__ */ new Map();
+	e.forEach((e, t) => e.forEach((e) => n.set(e, t)));
+	let r = e.map((e, t) => t), i = (e) => r[e] === e ? e : r[e] = i(r[e]);
+	for (let [e, a] of t) {
+		let t = n.get(e), o = n.get(a);
+		if (t === void 0 || o === void 0) continue;
+		let [s, c] = [i(t), i(o)];
+		s !== c && (r[Math.max(s, c)] = Math.min(s, c));
+	}
+	let a = /* @__PURE__ */ new Map();
+	return e.forEach((e, t) => {
+		let n = i(t);
+		a.set(n, [...a.get(n) ?? [], ...e]);
+	}), [...a.values()];
+}
+function w(e, t) {
+	let n = /* @__PURE__ */ new Map(), r = (e) => {
+		let t = e;
+		for (; n.has(t);) t = n.get(t);
+		return t;
+	}, i = [], a = /* @__PURE__ */ new Set(), o = (e) => {
+		a.has(e) || (a.add(e), i.push(e));
+	};
+	for (let [t, i] of e) {
+		o(t), o(i);
+		let [e, a] = [r(t), r(i)];
+		e !== a && n.set(a, e);
+	}
+	let s = /* @__PURE__ */ new Map();
+	for (let e of i) {
+		let t = r(e);
+		s.set(t, [...s.get(t) ?? [], e]);
+	}
+	if (t) {
+		let e = new Map(t.map((e, t) => [e, t]));
+		for (let t of s.values()) t.sort((t, n) => (e.get(t) ?? Infinity) - (e.get(n) ?? Infinity));
+	}
+	return (e) => a.has(e) ? s.get(r(e)) : [e];
+}
+function T(e, t, n) {
+	let r = {}, i = [], a = [];
+	for (let t of e) for (let e of t) r[e.id] = 0;
+	if (!n || !t) return {
+		shifts: r,
+		bothWays: i,
+		stillOut: a
+	};
+	let o = (e) => ({
+		below: e.some((e) => e < t.low),
+		above: e.some((e) => e > t.high)
+	});
+	for (let t of e) {
+		let e = t.flatMap((e) => e.midi), n = t.map((e) => e.id), { below: s, above: c } = o(e);
+		if (s && c) {
+			i.push(n);
+			continue;
+		}
+		if (!s && !c) continue;
+		let l = s ? 12 : -12;
+		for (let e of n) r[e] = l;
+		let u = o(e.map((e) => e + l));
+		(u.below || u.above) && a.push(n);
+	}
+	return {
+		shifts: r,
+		bothWays: i,
+		stillOut: a
+	};
+}
+function E(e, t, n) {
+	let r = { ...e };
+	for (let e of Object.keys(t)) {
+		if (t[e] === void 0) continue;
+		let i = n(e), a = i.find((e) => t[e] !== void 0);
+		for (let e of i) r[e] = t[a];
+	}
+	return r;
+}
+//#endregion
+export { x as _, S as a, t as c, h as d, m as f, y as g, b as h, w as i, u as l, _ as m, C as n, s as o, g as p, T as r, e as s, E as t, c as u, v };
+
+//# sourceMappingURL=range-fit-core-B1rMWdI4.js.map

package/dist/range-fit-core-B1rMWdI4.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"range-fit-core-B1rMWdI4.js","names":["INSTRUMENT_IDS","LEVELS","ranges","beginner","intermediate","advanced","CONCERT","OCTAVE","B_FLAT","INSTRUMENT_TABLE","info","INSTRUMENTS","instrumentName","id","GM_BLOCKS","instrumentFor","low","high","gmProgram","STEPS","SHARP_ORDER","SEMITONES","pitchMidi","p","keyAlter","fifths","step","spellMidi","candidates","octave","target","alter","single","direction","rank","a","b","spelledSoundingMidi","pitch","transposition","writtenPitch","soundingMidi","keyFifths","transposePitchSpelled","index","transposePitch","writtenKeyFifths","shift","concertFifths","EMBED_INSTRUMENTS","joinRuns","runOf","run","i","parent","runs","root","from","to","ties","ra","rb","merged","r","tieChainOf","appearance","seen","note","groups","order","chain","x","y","planShifts","shifts","bothWays","stillOut","phrase","phrases","autoRange","range","outside","midis","m","ids","below","above","after","applyOverrides","out","overrides","chainOf","owner"],"sources":["../src/lib/instrument-model.ts","../src/lib/range-fit-core.ts"],"sourcesContent":["/** The instrument model shared by the reader, the embeds and the editor (`pepperscore/instruments`); framework-free. */\n\n/** The viewer's instrument ids. */\nexport const INSTRUMENT_IDS = [\n  'piano', 'guitar', 'bassguitar', 'double-bass', 'drum-kit', 'alto-saxophone', 'tenor-saxophone', 'bari-saxophone',\n  'flute', 'clarinet', 'trumpet', 'trombone', 'violin', 'viola', 'cello', 'microphone',\n] as const;\nexport const LEVELS = ['beginner', 'intermediate', 'advanced'] as const;\n\nexport type InstrumentId = typeof INSTRUMENT_IDS[number];\nexport type RangeLevel = typeof LEVELS[number];\n/** An instrument a pitched part can be switched to: any but the drum kit (unpitched). */\nexport type SwitchInstrumentId = Exclude<InstrumentId, 'drum-kit'>;\nexport type Transposition = { semitones: number; diatonic: number };\nexport type InstrumentClef = 'treble' | 'bass' | 'alto' | 'tenor' | 'percussion' | 'treble8vb';\nexport type SpelledPitch = { step: 'A' | 'B' | 'C' | 'D' | 'E' | 'F' | 'G'; octave: number; alter: number };\nexport type InstrumentInfo = {\n  id: InstrumentId;\n  label: string;\n  /** The name the editor's controls and status line use when shorter than `label` (\"Alto Sax\"). */\n  short?: string;\n  /** 1-based GM program (the viewer's voice program); the drum kit plays on channel 10, not a program. */\n  gmProgram: number;\n  clef: InstrumentClef;\n  /** Written minus sounding. */\n  transposition: Transposition;\n  /** Playable range per level in sounding MIDI, inclusive; absent for unpitched instruments. */\n  ranges?: Record<RangeLevel, { low: number; high: number }>;\n};\n\ntype Span = [number, number];\nconst ranges = (beginner: Span, intermediate: Span, advanced: Span): InstrumentInfo['ranges'] => Object.freeze({\n  beginner: Object.freeze({ low: beginner[0], high: beginner[1] }),\n  intermediate: Object.freeze({ low: intermediate[0], high: intermediate[1] }),\n  advanced: Object.freeze({ low: advanced[0], high: advanced[1] }),\n});\nconst CONCERT: Transposition = Object.freeze({ semitones: 0, diatonic: 0 });\nconst OCTAVE: Transposition = Object.freeze({ semitones: 12, diatonic: 7 });\nconst B_FLAT: Transposition = Object.freeze({ semitones: 2, diatonic: 1 });\n\nconst INSTRUMENT_TABLE: Record<InstrumentId, InstrumentInfo> = {\n  piano: { id: 'piano', label: 'Piano', gmProgram: 1, clef: 'treble', transposition: CONCERT, ranges: ranges([21, 108], [21, 108], [21, 108]) },\n  guitar: { id: 'guitar', label: 'Guitar', gmProgram: 25, clef: 'treble', transposition: OCTAVE, ranges: ranges([40, 64], [40, 76], [40, 88]) },\n  bassguitar: { id: 'bassguitar', label: 'Bass Guitar', gmProgram: 34, clef: 'bass', transposition: OCTAVE, ranges: ranges([28, 48], [28, 55], [28, 60]) },\n  'double-bass': { id: 'double-bass', label: 'Double Bass', gmProgram: 33, clef: 'bass', transposition: OCTAVE, ranges: ranges([28, 48], [28, 55], [28, 64]) },\n  'drum-kit': { id: 'drum-kit', label: 'Drum Kit', gmProgram: 1, clef: 'percussion', transposition: CONCERT },\n  'alto-saxophone': { id: 'alto-saxophone', label: 'Alto Saxophone', short: 'Alto Sax', gmProgram: 66, clef: 'treble', transposition: { semitones: 9, diatonic: 5 }, ranges: ranges([49, 69], [49, 77], [49, 81]) },\n  'tenor-saxophone': { id: 'tenor-saxophone', label: 'Tenor Saxophone', short: 'Tenor Sax', gmProgram: 67, clef: 'treble', transposition: { semitones: 14, diatonic: 8 }, ranges: ranges([44, 64], [44, 72], [44, 76]) },\n  'bari-saxophone': { id: 'bari-saxophone', label: 'Baritone Saxophone', short: 'Bari Sax', gmProgram: 68, clef: 'treble', transposition: { semitones: 21, diatonic: 12 }, ranges: ranges([37, 57], [37, 65], [36, 69]) },\n  flute: { id: 'flute', label: 'Flute', gmProgram: 74, clef: 'treble', transposition: CONCERT, ranges: ranges([60, 84], [60, 91], [59, 96]) },\n  clarinet: { id: 'clarinet', label: 'Clarinet', gmProgram: 72, clef: 'treble', transposition: B_FLAT, ranges: ranges([50, 74], [50, 82], [50, 91]) },\n  trumpet: { id: 'trumpet', label: 'Trumpet', gmProgram: 57, clef: 'treble', transposition: B_FLAT, ranges: ranges([55, 72], [54, 79], [52, 86]) },\n  trombone: { id: 'trombone', label: 'Trombone', gmProgram: 58, clef: 'bass', transposition: CONCERT, ranges: ranges([46, 65], [40, 70], [34, 77]) },\n  violin: { id: 'violin', label: 'Violin', gmProgram: 41, clef: 'treble', transposition: CONCERT, ranges: ranges([55, 81], [55, 91], [55, 105]) },\n  viola: { id: 'viola', label: 'Viola', gmProgram: 42, clef: 'alto', transposition: CONCERT, ranges: ranges([48, 76], [48, 84], [48, 96]) },\n  cello: { id: 'cello', label: 'Cello', gmProgram: 43, clef: 'bass', transposition: CONCERT, ranges: ranges([36, 64], [36, 76], [36, 88]) },\n  microphone: { id: 'microphone', label: 'Voice', gmProgram: 54, clef: 'treble', transposition: CONCERT, ranges: ranges([48, 72], [45, 76], [40, 81]) },\n};\nfor (const info of Object.values(INSTRUMENT_TABLE)) { Object.freeze(info.transposition); Object.freeze(info); }\n/** The model's instruments by id (frozen). */\nexport const INSTRUMENTS: Readonly<Record<InstrumentId, Readonly<InstrumentInfo>>> = Object.freeze(INSTRUMENT_TABLE);\n\n/** The instrument's short name for controls and the status line (`short`, else `label`). */\nexport const instrumentName = (id: InstrumentId): string => INSTRUMENTS[id].short ?? INSTRUMENTS[id].label;\n\n/**\n * GM program blocks (1-based, inclusive) and the instrument nearest each, after the viewer's\n * GM manifest; programs outside every block (synths, ethnic, effects) fall back to piano.\n */\nconst GM_BLOCKS: [number, number, InstrumentId][] = [\n  [1, 24, 'piano'], [25, 32, 'guitar'], [33, 33, 'double-bass'], [34, 40, 'bassguitar'],\n  [41, 41, 'violin'], [42, 42, 'viola'], [43, 43, 'cello'], [44, 44, 'double-bass'], [45, 52, 'violin'],\n  [53, 55, 'microphone'], [57, 57, 'trumpet'], [58, 59, 'trombone'], [60, 60, 'trumpet'], [61, 61, 'trombone'], [62, 64, 'trumpet'],\n  [65, 66, 'alto-saxophone'], [67, 67, 'tenor-saxophone'], [68, 68, 'bari-saxophone'], [69, 72, 'clarinet'], [73, 80, 'flute'],\n];\n\n/** The instrument nearest a 1-based GM program; piano when none is near. */\nexport function instrumentFor(gmProgram: number): Readonly<InstrumentInfo> {\n  const block = GM_BLOCKS.find(([low, high]) => gmProgram >= low && gmProgram <= high);\n  return INSTRUMENTS[block?.[2] ?? 'piano'];\n}\n\nconst STEPS = ['C', 'D', 'E', 'F', 'G', 'A', 'B'] as const;\nconst SHARP_ORDER = ['F', 'C', 'G', 'D', 'A', 'E', 'B'];\nconst SEMITONES: Record<SpelledPitch['step'], number> = { C: 0, D: 2, E: 4, F: 5, G: 7, A: 9, B: 11 };\n\n/** The MIDI number of a pitch (C4 = 60). */\nexport const pitchMidi = (p: SpelledPitch): number => (p.octave + 1) * 12 + SEMITONES[p.step] + p.alter;\n\n/** The alteration the key signature (`fifths`) gives `step`. */\nexport function keyAlter(step: SpelledPitch['step'], fifths: number): number {\n  if (fifths > 0) return SHARP_ORDER.indexOf(step) < fifths ? 1 : 0;\n  if (fifths < 0) return SHARP_ORDER.length - 1 - SHARP_ORDER.indexOf(step) < -fifths ? -1 : 0;\n  return 0;\n}\n\n/**\n * The spelling of MIDI note `target`: the key signature's (`fifths`) spelling if it has one, else the\n * natural, else a sharp going up (`direction` >= 0) or a flat going down, else the other single\n * accidental, else a double.\n */\nexport function spellMidi(target: number, fifths: number, direction: number): SpelledPitch | undefined {\n  const candidates: SpelledPitch[] = [];\n  for (const step of STEPS) {\n    for (let octave = Math.floor(target / 12) - 2; octave <= Math.floor(target / 12); octave++) {\n      const alter = target - pitchMidi({ step, octave, alter: 0 });\n      if (alter >= -2 && alter <= 2) candidates.push({ step, octave, alter });\n    }\n  }\n  const single = direction >= 0 ? 1 : -1;\n  const rank = (p: SpelledPitch) => (p.alter === keyAlter(p.step, fifths) ? 0 : p.alter === 0 ? 1 : p.alter === single ? 2 : p.alter === -single ? 3 : 4);\n  return candidates.sort((a, b) => rank(a) - rank(b))[0];\n}\n\n/** The sounding MIDI number of a written pitch on an instrument with `transposition` (written minus sounding). */\nexport function spelledSoundingMidi(pitch: SpelledPitch, transposition: { semitones: number }): number {\n  return pitchMidi(pitch) - transposition.semitones;\n}\n\n/**\n * The written pitch of sounding MIDI `soundingMidi` for an instrument with `transposition`, spelled for the\n * written key `keyFifths`: the key's own accidentals first, then naturals, then sharps for chromatic notes in\n * sharp keys and C major, flats in flat keys. Only `semitones` is used: a MIDI number carries no spelling to\n * move by the diatonic interval.\n */\nexport function writtenPitch(soundingMidi: number, transposition: Transposition, keyFifths: number): SpelledPitch {\n  const target = soundingMidi + transposition.semitones;\n  // Every MIDI number has a natural or single-accidental spelling, so spellMidi always finds one.\n  return spellMidi(target, keyFifths, keyFifths < 0 ? -1 : 1)!;\n}\n\n/**\n * `pitch` moved by `t`, keeping its spelling: the step moves by `diatonic` (carrying the octave) and the alter\n * is whatever makes the MIDI number move by `semitones`. When that alter would pass a double accidental the\n * note is respelled with `writtenPitch` for the key `keyFifths` and `respelled` is true.\n */\nexport function transposePitchSpelled(pitch: SpelledPitch, t: Transposition, keyFifths: number): { pitch: SpelledPitch; respelled: boolean } {\n  const index = pitch.octave * 7 + STEPS.indexOf(pitch.step) + t.diatonic;\n  const octave = Math.floor(index / 7);\n  const step = STEPS[index - octave * 7];\n  const target = pitchMidi(pitch) + t.semitones;\n  const alter = target - pitchMidi({ step, octave, alter: 0 });\n  if (Math.abs(alter) <= 2) return { pitch: { step, octave, alter }, respelled: false };\n  return { pitch: writtenPitch(target, { semitones: 0, diatonic: 0 }, keyFifths), respelled: true };\n}\n\n/** `pitch` moved by `t`, keeping its spelling (see `transposePitchSpelled`; the fallback spells for C major). */\nexport const transposePitch = (pitch: SpelledPitch, t: Transposition): SpelledPitch => transposePitchSpelled(pitch, t, 0).pitch;\n\n/**\n * The written key (fifths) of music in concert key `concertFifths` shown with `transposition` (written minus\n * sounding): the transposition as fifths, `(7 * semitones) mod 12` normalised to -6..6, added and wrapped\n * back into -7..7. Alto sax (+9 semitones) is +3 fifths; a B-flat instrument +2.\n */\nexport function writtenKeyFifths(concertFifths: number, transposition: Transposition): number {\n  let shift = (((7 * transposition.semitones) % 12) + 12) % 12;\n  if (shift > 6) shift -= 12;\n  const fifths = concertFifths + shift;\n  return fifths > 7 ? fifths - 12 : fifths < -7 ? fifths + 12 : fifths;\n}\n\n/** The instruments the embeds offer, in switch order (frozen). */\nexport const EMBED_INSTRUMENTS: readonly InstrumentId[] = Object.freeze([\n  'alto-saxophone', 'tenor-saxophone', 'bari-saxophone', 'trumpet', 'trombone', 'flute', 'clarinet', 'violin', 'viola', 'cello', 'double-bass',\n] as const);\n","// Schema-free range-fit rules shared by the editor and the reader: both build phrases and ties from their\n// own score model and hand them here as plain event ids and MIDI numbers.\n\nexport type Shift = 0 | 12 | -12;\n/** One event (note or chord): its notes' judged MIDI (sounding plus interval). */\nexport type FitEvent = { id: string; midi: number[] };\n\n/** Merges runs of event ids that a tie links (`[from, to]`), keeping the first run's position. */\nexport function joinRuns(runs: string[][], ties: [string, string][]): string[][] {\n  const runOf = new Map<string, number>();\n  runs.forEach((run, i) => run.forEach((id) => runOf.set(id, i)));\n  const parent = runs.map((_, i) => i);\n  const root = (i: number): number => (parent[i] === i ? i : (parent[i] = root(parent[i])));\n  for (const [from, to] of ties) {\n    const a = runOf.get(from), b = runOf.get(to);\n    if (a === undefined || b === undefined) continue;\n    const [ra, rb] = [root(a), root(b)];\n    if (ra !== rb) parent[Math.max(ra, rb)] = Math.min(ra, rb);\n  }\n  const merged = new Map<number, string[]>();\n  runs.forEach((run, i) => {\n    const r = root(i);\n    merged.set(r, [...(merged.get(r) ?? []), ...run]);\n  });\n  return [...merged.values()];\n}\n\n/** The ordered chain of events the ties link around `id` (itself alone when untied), in `order` (event order) when given, else by first appearance in the ties. */\nexport function tieChainOf(ties: [string, string][], order?: string[]): (id: string) => string[] {\n  const parent = new Map<string, string>();\n  const root = (id: string): string => { let r = id; while (parent.has(r)) r = parent.get(r)!; return r; };\n  const appearance: string[] = [];\n  const seen = new Set<string>();\n  const note = (id: string) => { if (!seen.has(id)) { seen.add(id); appearance.push(id); } };\n  for (const [from, to] of ties) {\n    note(from); note(to);\n    const [a, b] = [root(from), root(to)];\n    if (a !== b) parent.set(b, a);\n  }\n  const groups = new Map<string, string[]>();\n  for (const id of appearance) {\n    const r = root(id);\n    groups.set(r, [...(groups.get(r) ?? []), id]);\n  }\n  if (order) {\n    const rank = new Map(order.map((id, i) => [id, i]));\n    for (const chain of groups.values()) chain.sort((x, y) => (rank.get(x) ?? Infinity) - (rank.get(y) ?? Infinity));\n  }\n  return (id) => (seen.has(id) ? groups.get(root(id))! : [id]);\n}\n\nexport type ShiftPlan = { shifts: Record<string, Shift>; bothWays: string[][]; stillOut: string[][] };\n\n/**\n * Plans an octave per phrase: any note below the range moves every event up, above moves it down, both\n * leaves the phrase (listed in `bothWays`); a phrase still out after its move keeps it (listed in\n * `stillOut`). A chord is out when any of its notes is. No range or `autoRange` off plans no shifts.\n */\nexport function planShifts(phrases: FitEvent[][], range: { low: number; high: number } | undefined, autoRange: boolean): ShiftPlan {\n  const shifts: Record<string, Shift> = {};\n  const bothWays: string[][] = [];\n  const stillOut: string[][] = [];\n  for (const phrase of phrases) for (const e of phrase) shifts[e.id] = 0;\n  if (!autoRange || !range) return { shifts, bothWays, stillOut };\n  const outside = (midis: number[]) => ({ below: midis.some((m) => m < range.low), above: midis.some((m) => m > range.high) });\n  for (const phrase of phrases) {\n    const midis = phrase.flatMap((e) => e.midi);\n    const ids = phrase.map((e) => e.id);\n    const { below, above } = outside(midis);\n    if (below && above) { bothWays.push(ids); continue; }\n    if (!below && !above) continue;\n    const shift: Shift = below ? 12 : -12;\n    for (const id of ids) shifts[id] = shift;\n    const after = outside(midis.map((m) => m + shift));\n    if (after.below || after.above) stillOut.push(ids);\n  }\n  return { shifts, bothWays, stillOut };\n}\n\n/** Sets single events from the user's overrides, each extended along its tie chain (the first override on a chain wins); overrides beat planned shifts. */\nexport function applyOverrides(shifts: Record<string, Shift>, overrides: Record<string, Shift>, chainOf: (id: string) => string[]): Record<string, Shift> {\n  const out = { ...shifts };\n  for (const id of Object.keys(overrides)) {\n    if (overrides[id] === undefined) continue;\n    const chain = chainOf(id);\n    const owner = chain.find((e) => overrides[e] !== undefined)!;\n    for (const e of chain) out[e] = overrides[owner];\n  }\n  return out;\n}\n"],"mappings":"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"}

package/dist/runtime-files.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Files pepperscore loads at runtime instead of bundling them: Verovio (LGPL-3.0-or-later, kept as upstream's own
+ * separately replaceable files) and the third-party notices. The build (vite.config.ts) writes them to dist/verovio/
+ * and dist/THIRD_PARTY_NOTICES.txt.
+ *
+ * Keep this file at the root of src/: its code lands in dist/index.js, so `./` is dist/. The library build must not
+ * resolve these URLs (`@vite-ignore`; lib mode would inline the files as data URLs); its runtime-files plugin then
+ * turns them back into plain `new URL('./…', import.meta.url)` in dist/index.js, the pattern host bundlers (Vite,
+ * Astro) recognise to copy the files as assets. scripts/finalize-dist.mjs fails the build if they do not survive.
+ */
+import type { VerovioFiles } from './lib/verovio-protocol';
+/** The Verovio files shipped with pepperscore. */
+export declare const bundledVerovioFiles: () => VerovioFiles;
+/** The third-party notices shipped with pepperscore (linked from the drawer's Licences entry). */
+export declare const thirdPartyNoticesUrl: () => string;

package/dist/{sf2-player-CRlOJDhD.js → sf2-player-oWC6yrUH.js}

@@ -52,15 +52,37 @@ async function a(e, { url: n, drums: a, program: o, preset: s, destination: c })
 	} catch (e) {
 		throw g.dispose(), h.disconnect(), e;
 	}
-	return f && (h.gain.value = 1 / Math.sqrt(Math.max(1, ...Array.from({ length: 128 }, (e, t) => p.zones.filter((e) => e.keyRange.lo <= t && t <= e.keyRange.hi).length)))), {
-		start: (e) => g.start(e),
-		stop: () => g.stop(),
+	f && (h.gain.value = 1 / Math.sqrt(Math.max(1, ...Array.from({ length: 128 }, (e, t) => p.zones.filter((e) => e.keyRange.lo <= t && t <= e.keyRange.hi).length))));
+	let _ = /* @__PURE__ */ new Map(), v = 0, y = () => {
+		for (let e of [..._.keys()]) e();
+		_.clear(), g.stop();
+	}, b = new Set(p.zones.flatMap(({ keyRange: { lo: e, hi: t } = {
+		lo: 0,
+		hi: 127
+	} }) => Array.from({ length: Math.max(0, t - e + 1) }, (t, n) => e + n)));
+	return {
+		start: ({ note: t, time: n, duration: r, velocity: i }) => {
+			let a = e.currentTime;
+			for (let [e, t] of _) t < a && _.delete(e);
+			let o = g.start({
+				note: t,
+				time: n,
+				duration: r,
+				velocity: i,
+				stopId: `n${v++}`
+			}), s = () => {
+				_.delete(s), o();
+			};
+			return _.set(s, Math.max(n, a) + r + 2), s;
+		},
+		stop: y,
 		dispose: () => {
-			g.dispose(), h.disconnect();
-		}
+			y(), g.dispose(), h.disconnect();
+		},
+		covers: (e) => b.has(e)
 	};
 }
 //#endregion
 export { a as loadSf2Player };
 
-//# sourceMappingURL=sf2-player-CRlOJDhD.js.map
+//# sourceMappingURL=sf2-player-oWC6yrUH.js.map

package/dist/sf2-player-oWC6yrUH.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sf2-player-oWC6yrUH.js","names":["soundfonts","parsedSoundfont","cached","url","response","buffer","soundfont2","LAYERED","layeredInstrument","zones","preset","presetZone","lo","zone","hi","layer","findPreset","presets","item","drums","program","loadSf2Player","smplrInstrument","soundfont","match","instrument","Sf2Sampler","sf2InstrumentToPreset","options","ctx","smplr","json","buffers","output","context","destination","sampler","error","note","pending","nextId","stopAll","stop","covered","i","now","end","handle","time","duration"],"sources":["../src/lib/sf2-player.ts"],"sourcesContent":["import type { Instrument, InstrumentZone, Preset, SoundFont2 } from 'soundfont2';\nimport type { AudioPlayer } from './sound-players';\n\nconst soundfonts = new Map<string, Promise<SoundFont2>>();\n\n/**\n * Each SF2 is downloaded and parsed once per URL. Every program, part and instance builds its player from the same\n * parsed soundfont (read-only here), so disposing one player never touches data another is using.\n */\nfunction parsedSoundfont(url: string): Promise<SoundFont2> {\n  let cached = soundfonts.get(url);\n  if (!cached) {\n    cached = Promise.all([\n      fetch(url).then(response => {\n        if (!response.ok) throw new Error(`Could not load the soundfont (${response.status}).`);\n        return response.arrayBuffer();\n      }),\n      import('soundfont2'),\n    ]).then(([buffer, { default: soundfont2 }]) => new soundfont2.SoundFont2(new Uint8Array(buffer)));\n    cached.catch(() => soundfonts.delete(url));\n    soundfonts.set(url, cached);\n  }\n  return cached;\n}\n\n/** Name of the synthetic instrument that layers every instrument zone of the chosen preset. */\nconst LAYERED = '\\u0000pepperscore-preset';\n\n/**\n * smplr's Soundfont2 plays one SF2 instrument, but a GM preset often layers several (TimGM6mb's Standard kit is\n * Standard0 + Standard1, its strings stack six). This merges them into one instrument, clipped to each preset zone's key\n * range; smplr then sounds every region that matches a note. Sample names get a layer prefix because smplr keys its\n * buffers by name. Velocity ranges, pan and attenuation are not applied (smplr's SF2 conversion ignores them).\n */\nfunction layeredInstrument(preset: Preset): Instrument {\n  const zones = preset.zones.flatMap((presetZone, layer) => (presetZone.instrument?.zones ?? []).flatMap((zone): InstrumentZone[] => {\n    const lo = Math.max(zone.keyRange?.lo ?? 0, presetZone.keyRange?.lo ?? 0);\n    const hi = Math.min(zone.keyRange?.hi ?? 127, presetZone.keyRange?.hi ?? 127);\n    if (!zone.sample || lo > hi) return [];\n    return [{ ...zone, keyRange: { lo, hi }, sample: { ...zone.sample, header: { ...zone.sample.header, name: `${layer}:${zone.sample.header.name}` } } }];\n  }));\n  return { header: { name: LAYERED, bagIndex: -1 }, zones };\n}\n\n/** The GM preset: bank 128 preset 0 (Standard kit) for drums, else bank 0 preset `program - 1`; or a preset named `preset`. */\nconst findPreset = (presets: Preset[], drums: boolean, program = 1, preset?: string) =>\n  presets.find(item => preset ? item.header.name === preset : drums ? item.header.bank === 128 && item.header.preset === 0 : item.header.bank === 0 && item.header.preset === program - 1);\n\nexport type Sf2Options = { url: string; drums: boolean; program?: number; preset?: string; destination: AudioNode };\n\n/** A player for one preset of an SF2. `preset` names an SF2 preset, or failing that a single SF2 instrument. */\nexport async function loadSf2Player(context: AudioContext, { url, drums, program, preset, destination }: Sf2Options): Promise<AudioPlayer> {\n  const [{ Instrument: smplrInstrument, sf2InstrumentToPreset }, soundfont] = await Promise.all([import('smplr'), parsedSoundfont(url)]);\n  const match = findPreset(soundfont.presets, drums, program, preset);\n  const instrument = match ? layeredInstrument(match) : preset ? soundfont.instruments.find(item => item.header.name === preset) : undefined;\n  if (!instrument) throw new Error(preset ? `The soundfont has no preset or instrument named \"${preset}\".` : drums ? 'The soundfont has no standard drum kit.' : `The soundfont has no instrument for GM program ${program}.`);\n  // smplr's own Soundfont2 fetches and parses the file per sampler; this plugin only turns the shared instrument into samples.\n  const Sf2Sampler = smplrInstrument<{ instrument: Instrument }>((ctx, options, smplr) => {\n    const { json, buffers } = sf2InstrumentToPreset(options.instrument, ctx);\n    return smplr.loadInstrument(json, buffers);\n  });\n  const output = context.createGain();\n  output.connect(destination);\n  const sampler = Sf2Sampler(context, { instrument, destination: output });\n  try { await sampler.ready; } catch (error) { sampler.dispose(); output.disconnect(); throw error; }\n  // Stacked layers add up: scale by 1/sqrt(the most regions any one note sounds) so the preset sits near single-layer\n  // ones. A global approximation: notes with fewer layers are scaled by the same amount.\n  if (match) output.gain.value = 1 / Math.sqrt(Math.max(1, ...Array.from({ length: 128 }, (_, note) => instrument.zones.filter(zone => zone.keyRange!.lo <= note && note <= zone.keyRange!.hi).length)));\n  // smplr queues a note more than its 200 ms lookahead ahead in its own scheduler, and its argument-less stop() only\n  // stops sounding voices: queued notes would still play after a stop. So every start keeps its own stop handle (with a\n  // unique stopId, since smplr's handle stops every voice sharing the id, which defaults to the pitch), and stop() calls\n  // them all. Handles are dropped once their note has ended.\n  const pending = new Map<() => void, number>();\n  let nextId = 0;\n  const release = 2; // seconds after a note's end before its handle is forgotten (covers smplr's release tail)\n  const stopAll = () => { for (const stop of [...pending.keys()]) stop(); pending.clear(); sampler.stop(); };\n  // Notes some zone sounds (a zone without a key range covers every key).\n  const covered = new Set(instrument.zones.flatMap(({ keyRange: { lo, hi } = { lo: 0, hi: 127 } }) => Array.from({ length: Math.max(0, hi - lo + 1) }, (_, i) => lo + i)));\n  return {\n    start: ({ note, time, duration, velocity }) => {\n      const now = context.currentTime;\n      for (const [stop, end] of pending) if (end < now) pending.delete(stop);\n      const handle = sampler.start({ note, time, duration, velocity, stopId: `n${nextId++}` });\n      const stop = () => { pending.delete(stop); handle(); };\n      pending.set(stop, Math.max(time, now) + duration + release);\n      return stop;\n    },\n    stop: stopAll,\n    dispose: () => { stopAll(); sampler.dispose(); output.disconnect(); },\n    covers: note => covered.has(note),\n  };\n}\n"],"mappings":"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"}