@marmooo/soundfont-split 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 marmooo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,71 @@
+# @marmooo/soundfont-split
+
+Split a SoundFont (SF2 / SF3) into per-preset SF3 files.
+
+```
+out_dir/
+  000/000.sf3  # bank 0, program 0
+  000/001.sf3
+  ...
+  128/000.sf3  # percussion (bank 128)
+  ...
+```
+
+Each file contains only the instruments and samples required by that preset
+(including stereo-linked samples). Indices are remapped so the result is a valid
+standalone SF3.
+
+## Installation
+
+### Deno
+
+```
+deno install -fr -RW -g npm:@marmooo/soundfont-split --name soundfont-split
+```
+
+### Node
+
+```
+npm install @marmooo/soundfont-split -g
+```
+
+## Usage
+
+```ts
+import { parse } from "@marmooo/soundfont";
+import { extractPreset, splitSoundFont } from "@marmooo/soundfont-split";
+
+await splitSoundFont("input.sf2", "out_dir", { quality: 4, concurrency: 4 });
+
+const sf = parse(Deno.readFileSync("input.sf2"));
+const one = extractPreset(sf, 0);
+```
+
+## CLI
+
+```
+Usage: soundfont-split <input.sf2|sf3> <out_dir> [options]
+
+Split a SoundFont (SF2 / SF3) into per-preset SF3 files.
+
+out_dir/
+  000/000.sf3  # bank 0, program 0
+  000/001.sf3
+  ...
+  128/000.sf3  # percussion (bank 128)
+  ...
+
+Options:
+  -V, --version      show version
+  -q, --quality      Vorbis VBR quality ([-1, 10], default 4)
+  -c, --concurrency  max parallel sample encodes (global across presets)
+                     default: hardwareConcurrency or 4
+  -r, --recompress   re-encode already-compressed (SF3) samples at
+                     --quality instead of copying them through as-is
+                       default: false
+  -h, --help         show this help
+```
+
+## License
+
+MIT

package/esm/_dnt.polyfills.d.ts

@@ -0,0 +1,11 @@
+declare global {
+    interface Object {
+        /**
+         * Determines whether an object has a property with the specified name.
+         * @param o An object.
+         * @param v A property name.
+         */
+        hasOwn(o: object, v: PropertyKey): boolean;
+    }
+}
+export {};

package/esm/_dnt.polyfills.js

@@ -0,0 +1,15 @@
+// https://github.com/tc39/proposal-accessible-object-hasownproperty/blob/main/polyfill.js
+if (!Object.hasOwn) {
+    Object.defineProperty(Object, "hasOwn", {
+        value: function (object, property) {
+            if (object == null) {
+                throw new TypeError("Cannot convert undefined or null to object");
+            }
+            return Object.prototype.hasOwnProperty.call(Object(object), property);
+        },
+        configurable: true,
+        enumerable: false,
+        writable: true,
+    });
+}
+export {};

package/esm/_dnt.shims.d.ts

@@ -0,0 +1,5 @@
+import { Deno } from "@deno/shim-deno";
+export { Deno } from "@deno/shim-deno";
+export declare const dntGlobalThis: Omit<typeof globalThis, "Deno"> & {
+    Deno: typeof Deno;
+};

package/esm/_dnt.shims.js

@@ -0,0 +1,61 @@
+import { Deno } from "@deno/shim-deno";
+export { Deno } from "@deno/shim-deno";
+const dntGlobals = {
+    Deno,
+};
+export const dntGlobalThis = createMergeProxy(globalThis, dntGlobals);
+function createMergeProxy(baseObj, extObj) {
+    return new Proxy(baseObj, {
+        get(_target, prop, _receiver) {
+            if (prop in extObj) {
+                return extObj[prop];
+            }
+            else {
+                return baseObj[prop];
+            }
+        },
+        set(_target, prop, value) {
+            if (prop in extObj) {
+                delete extObj[prop];
+            }
+            baseObj[prop] = value;
+            return true;
+        },
+        deleteProperty(_target, prop) {
+            let success = false;
+            if (prop in extObj) {
+                delete extObj[prop];
+                success = true;
+            }
+            if (prop in baseObj) {
+                delete baseObj[prop];
+                success = true;
+            }
+            return success;
+        },
+        ownKeys(_target) {
+            const baseKeys = Reflect.ownKeys(baseObj);
+            const extKeys = Reflect.ownKeys(extObj);
+            const extKeysSet = new Set(extKeys);
+            return [...baseKeys.filter((k) => !extKeysSet.has(k)), ...extKeys];
+        },
+        defineProperty(_target, prop, desc) {
+            if (prop in extObj) {
+                delete extObj[prop];
+            }
+            Reflect.defineProperty(baseObj, prop, desc);
+            return true;
+        },
+        getOwnPropertyDescriptor(_target, prop) {
+            if (prop in extObj) {
+                return Reflect.getOwnPropertyDescriptor(extObj, prop);
+            }
+            else {
+                return Reflect.getOwnPropertyDescriptor(baseObj, prop);
+            }
+        },
+        has(_target, prop) {
+            return prop in extObj || prop in baseObj;
+        },
+    });
+}

package/esm/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import "./_dnt.polyfills.js";

package/esm/cli.js

@@ -0,0 +1,59 @@
+#!/usr/bin/env node
+import "./_dnt.polyfills.js";
+import * as dntShim from "./_dnt.shims.js";
+import { parseArgs } from "./deps/jsr.io/@std/cli/1.0.32/mod.js";
+import { splitSoundFont } from "./src/mod.js";
+const VERSION = "0.0.1";
+const args = parseArgs(dntShim.Deno.args, {
+    string: ["quality", "concurrency"],
+    boolean: ["version", "help", "recompress"],
+    alias: {
+        q: "quality",
+        c: "concurrency",
+        r: "recompress",
+        V: "version",
+        h: "help",
+    },
+});
+const usage = `Usage: soundfont-split <input.sf2|sf3> <out_dir> [options]
+
+Split a SoundFont (SF2 / SF3) into per-preset SF3 files.
+
+out_dir/
+  000/000.sf3  # bank 0, program 0
+  000/001.sf3
+  ...
+  128/000.sf3  # percussion (bank 128)
+  ...
+
+Options:
+  -V, --version      output the version number
+  -q, --quality      Vorbis VBR quality ([-1, 10], default 4)
+  -c, --concurrency  max parallel sample encodes (global across presets)
+                       default: hardwareConcurrency or 4
+  -r, --recompress   re-encode already-compressed (SF3) samples at
+                     --quality instead of copying them through as-is
+                       default: false
+  -h, --help         display help for command`;
+if (args.version) {
+    console.log(VERSION);
+    dntShim.Deno.exit(0);
+}
+if (args.help) {
+    console.log(usage);
+    dntShim.Deno.exit(0);
+}
+const inputPath = args._[0];
+const outDir = args._[1];
+if (!inputPath || !outDir) {
+    console.error(usage);
+    dntShim.Deno.exit(1);
+}
+const qualityArg = args.quality;
+const concurrencyArg = args.concurrency;
+const results = await splitSoundFont(inputPath, outDir, {
+    quality: qualityArg ? Number(qualityArg) : undefined,
+    concurrency: concurrencyArg ? Number(concurrencyArg) : undefined,
+    recompress: args.recompress,
+});
+console.log(`\ndone: ${results.length} preset(s) written under ${outDir}`);

package/esm/deps/jsr.io/@std/cli/1.0.32/_data.d.ts

@@ -0,0 +1,8 @@
+declare namespace _default {
+    let UNICODE_VERSION: string;
+    let tables: {
+        d: string;
+        r: string;
+    }[];
+}
+export default _default;

package/esm/deps/jsr.io/@std/cli/1.0.32/_data.js

@@ -0,0 +1,17 @@
+export default {
+    "UNICODE_VERSION": "15.0.0",
+    "tables": [
+        {
+            "d": "AAECAwQFBgcICQoLDA0OAw8DDwkQCRESERIA",
+            "r": "AQEBAgEBAQEBAQEBAQEBBwEHAVABBwcBBwF4"
+        },
+        {
+            "d": "AAECAwQFBgcGCAYJCgsMDQ4PEAYREhMUBhUWFxgZGhscHR4fICEiIyIkJSYnKCkqJSssLS4vMDEyMzQ1Njc4OToGOzwKBj0GPj9AQUIGQwZEBkVGR0hJSktMTQZOBgoGT1BRUlNUVVZXWFkGWgZbBlxdXl1fYGFiY2RlZmdoBmlqBmsGAQZsBm1uO29wcXI7czt0dXZ3OwY7eHkGent8Bn0Gfn+AgYKDhIWGBoc7iAZdO4kGiosGAXGMBo0GjgaPBpAGkQaSBpMGlJUGlpcGmJmam5ydnp+gLgahLKIGo6SlpganqKmqqwasBq0Grq8GsLGyswa0BrUGtre4Brm6uwZHvAa9vga/wME7wjvDxAbFO8bHO8gGyQbKywbMzQbOBs/Q0QbSBr8GvgbT1AbUBtUG1gbXBtjZ2tsG3N0G3t/g4eLjO+Tl5ufoO+k76gbrBuztOwbu7/AGO+XxCgYKCwZd8g==",
+            "r": "AQEBAQEBAQEBAQEBAQEBAQEBAQMBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQECBQEOAQEBAQEBAQEBAwEBAQEBAQEBAQIBAwEIAQEBAQEBAQEBAQEBAQIBAQEBAQEBAQEBAQEBAQEBDQEBBQEBAQEBAgEBAwEBAQEBAQEBAQEBbQHaAQEFAQEBBAECAQEBAQEBAQEBAwGuASFkCAELAQEBAQEBAQEHAQMBAQEaAQIBCAEFAQEBAQEBAQEBAQEBAQEBAQEBAQECAQEBAQIBAQEBAQEBAwEDAQEBAQEBAQUBAQEBAQEBBAEBAVIBAdkBARABAQFfARMBAYoBBAEBBQEmAUkBAQcBAQIBHgEBARUBAQEBAQUBAQcBDwEBARoBAgEBAQEBAQECAQEBAQEBAQEBAQEBAQEBAQMBBAEBAgEBAQEUfwEBAQIDAXj/AQ=="
+        },
+        {
+            "d": "AFUVAF3Xd3X/93//VXVVV9VX9V91f1/31X93XVXdVdVV9dVV/VVX1X9X/131VfXVVXV3V1VdVV1V1/1dV1X/3VUAVf3/3/9fVf3/3/9fVV1V/11VFQBQVQEAEEEQVQBQVQBAVFUVAFVUVQUAEAAUBFBVFVFVAEBVBQBUVRUAVVFVBRAAAVBVAVVQVQBVBQBAVUVUAQBUUQEAVQVVUVVUAVRVUVUFVUVBVVRBFRRQUVVQUVUBEFRRVQVVBQBRVRQBVFVRVUFVBVVFVVRVUVVUVQRUBQRQVUFVBVVFVVBVBVVQVRVUAVRVUVUFVVFVRVUFRFVRAEBVFQBAVVEAVFUAQFVQVRFRVQEAQAAEVQEAAQBUVUVVAQQAQVVQBVRVAVRVRUFVUVVRVaoAVQFVBVRVBVUFVQVVEABQVUUBAFVRVRUAVUFVUVVAFVRVRVUBVRUUVUUAQEQBAFQVABRVAEBVAFUEQFRFVRUAVVBVBVAQUFVFUBFQVQAFVUAABABUUVVUUFUVANd/X3//BUD3XdV1VQAEAFVXVdX9V1VXVQBUVdVdVdV1VX111VXVV9V//1X/X1VdVf9fVV9VdVdV1VX31dfVXXX9193/d1X/VV9VV3VVX//1VfVVXVVdVdVVdVWlVWlVqVaWVf/f/1X/Vf/1X1Xf/19V9VVf9df1X1X1X1XVVWlVfV31VVpVd1V3VapV33/fVZVVlVX1WVWlVelV+v/v//7/31Xv/6/77/tVWaVVVlVdVWaVmlX1/1WpVVZVlVWVVlVW+V9VFVBVAKqaqlWqWlWqVaoKoKpqqapqgapVqaqpqmqqVapqqv+qVqpqVRVAAFBVBVVQVUUVVUFVVFVQVQBQVRVVBQBQVRUAUFWqVkBVFQVQVVFVAUBBVRVVVFVUVQQUVAVRVVBVRVVRVFFVqlVFVQCqWlUAqmqqaqpVqlZVqmpVAV1VUVVUVQVAVQFBVQBVQBVVQVUAVRVUVQFVBQBUVQVQVVFVAEBVFFRVFVBVFUBBUUVVUVVAVRUAAQBUVRVVUFUFAEBVARRVFVAEVUVVFQBAVVRVBQBUAFRVAAVEVUVVFQBEFQRVBVBVEFRVUFUVAEARVFUVUQAQVQEFEABVFQBBVRVEFVUABVVUVQEAQFUVABRAVRVVAUABVQUAQFBVAEAAEFUFAAUABEFVAUBFEAAQVVARVRVUVVBVBUBVRFVUFQBQVQBUVQBAVRVVFUBVqlRVWlWqVapaVapWVaqpqmmqalVlVWpZVapVqlVBAFUAUABAVRVQVRUAQAEAVQVQVQVUVQBAFQBUVVFVVFUVAAEAVQBAABQAEARAVUVVAFUAQFUAQFVWVZVV/39V/1//X1X/76uq6v9XVWpVqlWqVlVaVapaVapWVamqmqqmqlWqapWqVapWqmqmqpaqWlWVaqpVZVVpVVZVlapVqlpVVmqpVapVlVZVqlZVqlVWVapqqpqqVapWqlZVqpqqWlWlqlWqVlWqVlVRVQD/Xw==",
+            "r": "CBcBCAEBAQEBAQEBAQECAQEBAQEBAQEBAQEBAQMBAQECAQEBAQEBAQEBAQEBBAEBGAEDAQwBAwEIAQEBAQEBAQgcCAEDAQEBAQEDAQEBDQEDEAELAQEBEQEKAQEBDgEBAgIBAQoBBQQBCAEBAQEBAQEHAQEHBgEWAQIBDQECAgEFAQECAgEKAQ0BAQIKAQ0BDQEBAQEBAQEBAgEHAQ4BAQEBAQQBBgEBDgEBAQEBAQcBAQIBAQEBBAEFAQEBDgEBAQEBAQECAQcBDwECAQwCDQEBAQEBAQECAQgBAQEEAQcBDQEBAQEBAQQBBwERAQEBARYBAQECAQEBGAECAQIBARIBBgEBDQECAQEBAQECAQgBAQEZAQEBAgYBAQEDAQECAQEBAQMBCBgIBwEMAQEGAQcBBwEQAQEBAQEBAgIBCgEBDQEIAQ0BAQEBAQEBBgEBDgEBAQEBAQEBAgEMBwEMAQwBAQEBCQECAwEHAQEBAQ0BAQEBDgIBBgEDAQEBAQEBAQMBAQEBAgEBAQEBAQEBCAEBAgEBAQEBAQkBCAgBAwECAQEBAgEBAQkBAQEBAwECAQMBAQIBBwEFAQEDAQYBAQEBAgEBAQEBAQEBAQECAgEDAQECBAIDAgIBBQEEAQEBAwEPAQEBCyIBCAEJAwQBAQIBAQEBAgECAQEBAQMBAQEBAwEBAQEBAQEBAQgBAQMDAgEBAwEEAQIBAQEBBAEBAQEBAQECAQEBAQEBAQEBAQEHAQQBAwEBAQcBAgUBBgECAQYBAQwBAQEUAQELCAYBFgMFAQYDAQoBAQMBARQBAQkBAQoBBgEVAwsBCgIPAQ0BGQEBAgEHARQBAwIBBgEBAQUBBgQBAgEJAQEBBQECAQMHAQELAQECCQEQAQECAgECAQsBDAEBAQEBCgEBAQsBAQEECQ4BCAQCAQEECAEEAQEFCAEPAQEEAQEPAQgBFAEBAQEBAQEKAQEJAQ8BEAEBEwEBAQIBCwEBDgENAwEKAQEBAQELAQEBAQECAQwBCAEBAQEBDgEDAQwBAQECAQEXAQEBAQEHAgEBBQEIAQEBAQEQAgEBBQEUAQEBAQEbAQEBAQEGARQBAQEBARkBAQEBCQEBAQEQAQIBDwEBARQBAQEBBwEBAQkBAQEBAQECAQEBCwECAQEVAQEBAQQBBQEBAQEOAQEBAQEBEgEBFgEBAgEMAQEBAQ8BAQMBFgEBDgEBBQEPAQETAQECAQMOAgUBCgIBGQEBAQEIAQMBBwEBAwECEwgBAQcLAQUBFwEBAQEDAQEBBwEBBAEBDg0BAQwBAQEDAQQBAQEDBAEBBAEBAQEBEAEPAQgBAQsBAQ4BEQEMAgEBBwEOAQEHAQEBAQQBBAEDCwECAQEBAwEBBggBAgEBAREBBQMKAQEBAwQCEQEBHgEPAQIBAQYEAQYBAwEUAQUMAQEBAQEBAQECAQEBAgEIAwEBBgsBAgEODAMBAgEBCwEBAQEBAwECAQECAQEBBwgPAQ=="
+        }
+    ]
+};

package/esm/deps/jsr.io/@std/cli/1.0.32/_run_length.d.ts

@@ -0,0 +1,8 @@
+export declare function runLengthEncode(arr: number[]): {
+    d: string;
+    r: string;
+};
+export declare function runLengthDecode({ d, r }: {
+    d: string;
+    r: string;
+}): Uint8Array<ArrayBuffer>;

package/esm/deps/jsr.io/@std/cli/1.0.32/_run_length.js

@@ -0,0 +1,34 @@
+// Copyright 2018-2026 the Deno authors. MIT license.
+export function runLengthEncode(arr) {
+    const data = [];
+    const runLengths = [];
+    let prev = Symbol("none");
+    for (const x of arr) {
+        if (x === prev) {
+            ++runLengths[runLengths.length - 1];
+        }
+        else {
+            prev = x;
+            data.push(x);
+            runLengths.push(1);
+        }
+    }
+    for (const r of runLengths) {
+        if (r >= 0x100) {
+            throw new Error(`Run length too long: ${r}`);
+        }
+    }
+    return {
+        d: btoa(String.fromCharCode(...data)),
+        r: btoa(String.fromCharCode(...runLengths)),
+    };
+}
+export function runLengthDecode({ d, r }) {
+    const data = atob(d);
+    const runLengths = atob(r);
+    let out = "";
+    for (const [i, ch] of [...runLengths].entries()) {
+        out += data[i].repeat(ch.codePointAt(0));
+    }
+    return Uint8Array.from([...out].map((x) => x.codePointAt(0)));
+}

package/esm/deps/jsr.io/@std/cli/1.0.32/mod.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Tools for creating interactive command line tools.
+ *
+ * ```ts
+ * import { parseArgs } from "@std/cli/parse-args";
+ * import { assertEquals } from "@std/assert";
+ *
+ * // Same as running `deno run example.ts --foo --bar=baz ./quux.txt`
+ * const args = parseArgs(["--foo", "--bar=baz", "./quux.txt"]);
+ * assertEquals(args, { foo: true, bar: "baz", _: ["./quux.txt"] });
+ * ```
+ *
+ * @module
+ */
+export * from "./parse_args.js";
+export * from "./prompt_secret.js";
+export * from "./unicode_width.js";

package/esm/deps/jsr.io/@std/cli/1.0.32/mod.js

@@ -0,0 +1,18 @@
+// Copyright 2018-2026 the Deno authors. MIT license.
+/**
+ * Tools for creating interactive command line tools.
+ *
+ * ```ts
+ * import { parseArgs } from "@std/cli/parse-args";
+ * import { assertEquals } from "@std/assert";
+ *
+ * // Same as running `deno run example.ts --foo --bar=baz ./quux.txt`
+ * const args = parseArgs(["--foo", "--bar=baz", "./quux.txt"]);
+ * assertEquals(args, { foo: true, bar: "baz", _: ["./quux.txt"] });
+ * ```
+ *
+ * @module
+ */
+export * from "./parse_args.js";
+export * from "./prompt_secret.js";
+export * from "./unicode_width.js";