pepperscore 0.1.1 → 0.3.0

package/dist/lib/verovio-protocol.d.ts

@@ -50,6 +50,21 @@ export type VerovioRequest = {
     chunkBudget: number;
     simulateOom?: boolean;
 });
+/**
+ * Where the worker imports Verovio from: upstream's own, unmodified ES modules, loaded at runtime so they stay a
+ * separately replaceable library (LGPL-3.0-or-later). `module` is the Emscripten module (npm verovio's
+ * dist/verovio-module.mjs, default export: an async factory of the WASM module); `toolkit` is the JavaScript toolkit
+ * (dist/verovio.mjs, exports `VerovioToolkit` and `enableLogToBuffer`). Absolute URLs.
+ */
+export type VerovioFiles = {
+    module: string;
+    toolkit: string;
+};
+/** Sent once by the runtime right after it starts a worker, before any request. */
+export type VerovioConfigure = {
+    kind: 'configure';
+    files: VerovioFiles;
+};
 export type VerovioReply = {
     id: number;
     value?: unknown;

package/dist/lib/verovio-runtime.d.ts

@@ -1,5 +1,5 @@
 import type { SourceDocument } from './notation/document';
-import type { BaselineInfo, PagesResult, ProbeResult, VerovioReply, ViewSpec } from './verovio-protocol';
+import type { BaselineInfo, PagesResult, ProbeResult, VerovioFiles, VerovioReply, ViewSpec } from './verovio-protocol';
 /** A worker failure; `code` says why (see VerovioReply). */
 export declare class VerovioError extends Error {
     readonly code?: VerovioReply['code'];
@@ -24,6 +24,14 @@ export declare const chunkSettings: () => {
  * threshold) on a fresh worker. The caller then opens or draws the score again. Returns the new budget.
  */
 export declare function reduceChunkSize(): number;
+/** The Verovio files under a directory laid out like the verovio npm package's dist/; a relative URL resolves against the page. */
+export declare function verovioFilesAt(base: string, page?: string): VerovioFiles;
+/**
+ * Load Verovio from `base` (see PepperScoreProps.verovioBaseUrl) instead of the shipped copy. Every reader on the page
+ * shares one worker, so this applies to all of them, from the next time the worker starts (the first engraving, or
+ * a restart); a blank `base` changes nothing.
+ */
+export declare function setVerovioBaseUrl(base: string | undefined): void;
 export declare function verovioRevision(document: SourceDocument): number;
 /** A reader mounted: a channel of its own, so its imports and renders never supersede another reader's. */
 export declare function openVerovioChannel(): number;

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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"}