@datamoc/mw_games 0.18.0 → 0.19.0

package/CHANGELOG.md

@@ -5,6 +5,19 @@ All notable changes to `mwg` are documented here. Format follows
 [Semantic Versioning](https://semver.org/) as of this first release - a 0.y.z version means
 the public API may still change between minor versions.
 
+## [0.19.0] - 2026-09-26
+
+A game that plays five instruments no longer ships all 128: the audio module learns which
+programs its MIDI files actually use and writes a smaller SoundFont carrying only those.
+
+### Added
+
+- `audio.collectSoundFontUsage` lists the (bank, program) pairs scheduled notes request
+  across MIDI files, with drums mapped to bank 128 the way the renderer maps them.
+- `audio.subsetSoundFont` writes a smaller, valid SoundFont 2 file carrying only the used
+  programs, with zones, ranges, tuning, envelopes and sample loops copied verbatim and
+  every index remapped, so a compiled game ships just the samples it plays.
+
 ## [0.18.0] - 2026-09-25
 
 ### Added

package/dist/audio/SoundFont.d.ts

@@ -1,15 +1,4 @@
-/**
- * A SoundFont 2 reader: presets to instruments to sample zones, enough to play
- * General MIDI music with real samples. Supported: key and velocity ranges, root key
- * and tuning, sample loop modes, the volume envelope (attack, hold, decay, sustain,
- * release), pan and attenuation, with the global-zone and preset-plus-instrument
- * layering rules. Not supported: modulators, filters and LFOs, 24-bit samples, or
- * stereo-linked sample pairs beyond playing each side as its own mono voice.
- *
- * A SoundFont file is only data (recorded samples plus preset tables), so reading one
- * is ordinary format engineering; the licence that matters is the font's own, checked
- * before it ships, never here.
- */
+import { type MidiFile } from './Midi.ts';
 /** one mono sample: raw frames plus its loop region in frames and native rate */
 export interface SoundFontSample {
     data: Float32Array;
@@ -45,6 +34,11 @@ export interface SoundFont {
     hasPreset(bank: number, program: number): boolean;
     readonly presetCount: number;
 }
+/** one used program: the voice a game's MIDI files actually request */
+export interface SoundFontProgram {
+    bank: number;
+    program: number;
+}
 /**
  * Reads SoundFont 2 bytes into layered preset voices.
  *
@@ -61,4 +55,44 @@ export interface SoundFont {
  * ```
  */
 export declare function parseSoundFont(data: ArrayBuffer | ArrayBufferView): SoundFont;
+/**
+ * Every sampled voice the given MIDI files can request, as (bank, program) pairs:
+ * the channel voice in effect at each scheduled note, with drums mapped to bank 128
+ * the same way the renderer maps them. A game's compile step feeds this straight
+ * into `subsetSoundFont` so the shipped font carries only these programs.
+ *
+ * @example
+ * ```ts
+ * import { parseMidi, collectSoundFontUsage } from '@datamoc/mw_games/audio';
+ *
+ * declare const midiBytes: ArrayBuffer;
+ *
+ * const usage = collectSoundFontUsage([parseMidi(midiBytes)]);
+ * console.log(usage.length);
+ * ```
+ */
+export declare function collectSoundFontUsage(files: readonly MidiFile[]): SoundFontProgram[];
+/**
+ * Writes a smaller, valid SoundFont 2 file carrying only the used programs: their
+ * presets (names kept), instruments and samples, with zones, ranges, tuning,
+ * envelopes and sample loops copied verbatim and every index remapped. Zones that
+ * reference samples missing from the file (ROM samples) are dropped, matching what
+ * the reader voices for the full font; the library, genre and morphology metadata
+ * is zeroed and the INFO list, when present, rides along untouched. Modulator lists
+ * are emptied and 24-bit upper bits are dropped: the reader voices neither, so what
+ * it plays is unchanged, while a third-party player would miss those.
+ *
+ * @example
+ * ```ts
+ * import { parseMidi, collectSoundFontUsage, subsetSoundFont } from '@datamoc/mw_games/audio';
+ *
+ * declare const midiBytes: ArrayBuffer;
+ * declare const soundfontBytes: ArrayBuffer;
+ *
+ * const usage = collectSoundFontUsage([parseMidi(midiBytes)]);
+ * const pruned = subsetSoundFont(soundfontBytes, usage);
+ * console.log(usage.length, pruned.byteLength);
+ * ```
+ */
+export declare function subsetSoundFont(data: ArrayBuffer | ArrayBufferView, usage: readonly SoundFontProgram[]): ArrayBuffer;
 //# sourceMappingURL=SoundFont.d.ts.map

package/dist/audio/SoundFont.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SoundFont.d.ts","sourceRoot":"","sources":["../../src/audio/SoundFont.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAoBH,iFAAiF;AACjF,MAAM,WAAW,eAAe;IAC/B,IAAI,EAAE,YAAY,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CAChB;AAQD,wDAAwD;AACxD,MAAM,WAAW,cAAc;IAC9B,MAAM,EAAE,eAAe,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;IACd,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,GAAG,EAAE,MAAM,CAAC;IACZ,6EAA6E;IAC7E,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACzB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,cAAc,EAAE,CAAC;IACvF,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;IAClD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC7B;AAmBD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,WAAW,GAAG,eAAe,GAAG,SAAS,CA6L7E"}
+{"version":3,"file":"SoundFont.d.ts","sourceRoot":"","sources":["../../src/audio/SoundFont.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,QAAQ,EAAE,MAAM,WAAW,CAAC;AAwCxD,iFAAiF;AACjF,MAAM,WAAW,eAAe;IAC/B,IAAI,EAAE,YAAY,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,wDAAwD;AACxD,MAAM,WAAW,cAAc;IAC9B,MAAM,EAAE,eAAe,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;IACd,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,GAAG,EAAE,MAAM,CAAC;IACZ,6EAA6E;IAC7E,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACzB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,cAAc,EAAE,CAAC;IACvF,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;IAClD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC7B;AAED,uEAAuE;AACvE,MAAM,WAAW,gBAAgB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CAChB;AAyMD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,WAAW,GAAG,eAAe,GAAG,SAAS,CAkG7E;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,SAAS,QAAQ,EAAE,GAAG,gBAAgB,EAAE,CAcpF;AA6CD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,WAAW,GAAG,eAAe,EAAE,KAAK,EAAE,SAAS,gBAAgB,EAAE,GAAG,WAAW,CAiOpH"}