supersonic-scsynth-bundle 0.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (4) hide show
  1. package/LICENSE +27 -0
  2. package/README.md +66 -0
  3. package/index.js +6 -0
  4. package/package.json +38 -0
package/LICENSE ADDED
@@ -0,0 +1,27 @@
1
+ GNU GENERAL PUBLIC LICENSE
2
+ Version 3, 29 June 2007
3
+
4
+ Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/>
5
+ Everyone is permitted to copy and distribute verbatim copies
6
+ of this license document, but changing it is not allowed.
7
+
8
+ This program is free software: you can redistribute it and/or modify
9
+ it under the terms of the GNU General Public License as published by
10
+ the Free Software Foundation, either version 3 of the License, or
11
+ (at your option) any later version.
12
+
13
+ This program is distributed in the hope that it will be useful,
14
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
15
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16
+ GNU General Public License for more details.
17
+
18
+ You should have received a copy of the GNU General Public License
19
+ along with this program. If not, see <https://www.gnu.org/licenses/>.
20
+
21
+ ---
22
+
23
+ SuperSonic - WebAssembly synthesis engine
24
+ Copyright (C) 2025 Sam Aaron (where source differs from SuperCollider)
25
+
26
+ Based on SuperCollider's scsynth
27
+ Copyright (C) 2002-2023 James McCartney and SuperCollider contributors
package/README.md ADDED
@@ -0,0 +1,66 @@
1
+ # supersonic-scsynth-bundle
2
+
3
+ Complete SuperSonic bundle with everything included.
4
+
5
+ ## What's Included
6
+
7
+ This is a convenience meta-package that includes:
8
+
9
+ - **[supersonic-scsynth](https://www.npmjs.com/package/supersonic-scsynth)** - The core scsynth WASM engine (~450KB)
10
+ - **[supersonic-scsynth-synthdefs](https://www.npmjs.com/package/supersonic-scsynth-synthdefs)** - All 120 Sonic Pi synthdefs (~67KB)
11
+ - **[supersonic-scsynth-samples](https://www.npmjs.com/package/supersonic-scsynth-samples)** - All 206 Sonic Pi samples (~34MB)
12
+
13
+ ## Installation
14
+
15
+ ```bash
16
+ npm install supersonic-scsynth-bundle
17
+ ```
18
+
19
+ This installs all three packages as dependencies.
20
+
21
+ ## Usage
22
+
23
+ Same API as using the packages separately:
24
+
25
+ ```javascript
26
+ import { SuperSonic } from 'supersonic-scsynth-bundle';
27
+
28
+ const sonic = new SuperSonic({
29
+ audioBaseURL: 'https://unpkg.com/supersonic-scsynth-samples@0.1.0/samples/'
30
+ });
31
+
32
+ await sonic.init();
33
+ await sonic.loadSynthDefs(
34
+ ['sonic-pi-beep', 'sonic-pi-tb303'],
35
+ 'https://unpkg.com/supersonic-scsynth-synthdefs@0.1.0/synthdefs/'
36
+ );
37
+ ```
38
+
39
+ ## When to Use This
40
+
41
+ **Use this bundle if:**
42
+ - You want a quick start with everything included
43
+ - You're building a Sonic Pi-compatible application
44
+ - You want the Sonic Pi synthdefs and samples
45
+
46
+ **Use separate packages if:**
47
+ - You want minimal package size (just install `supersonic-scsynth`)
48
+ - You have your own synthdefs and samples
49
+ - You're building for production and want fine-grained control
50
+
51
+ ## Package Breakdown
52
+
53
+ | Package | Size | Contains |
54
+ |---------|------|----------|
55
+ | `supersonic-scsynth` | ~450KB | Core WASM engine |
56
+ | `supersonic-scsynth-synthdefs` | ~67KB | 120 Sonic Pi synthdefs |
57
+ | `supersonic-scsynth-samples` | ~34MB | 206 Sonic Pi samples |
58
+ | `supersonic-scsynth-bundle` | ~2KB | Meta-package (depends on all three) |
59
+
60
+ ## Documentation
61
+
62
+ See the main [SuperSonic repository](https://github.com/samaaron/supersonic) for full documentation.
63
+
64
+ ## License
65
+
66
+ GPL-3.0-or-later
package/index.js ADDED
@@ -0,0 +1,6 @@
1
+ // SuperSonic Bundle
2
+ // Re-exports core engine + synthdefs + samples for convenience
3
+
4
+ export * from 'supersonic-scsynth';
5
+ export * from 'supersonic-scsynth-synthdefs';
6
+ export * from 'supersonic-scsynth-samples';
package/package.json ADDED
@@ -0,0 +1,38 @@
1
+ {
2
+ "name": "supersonic-scsynth-bundle",
3
+ "version": "0.1.1",
4
+ "description": "Complete SuperSonic bundle: scsynth engine + Sonic Pi synthdefs and samples",
5
+ "main": "index.js",
6
+ "type": "module",
7
+ "repository": {
8
+ "type": "git",
9
+ "url": "git+https://github.com/samaaron/supersonic.git",
10
+ "directory": "packages/supersonic-scsynth-bundle"
11
+ },
12
+ "keywords": [
13
+ "supercollider",
14
+ "scsynth",
15
+ "sonic-pi",
16
+ "audio",
17
+ "synthesis",
18
+ "webassembly",
19
+ "supersonic",
20
+ "bundle"
21
+ ],
22
+ "author": "Sam Aaron",
23
+ "license": "GPL-3.0-or-later",
24
+ "bugs": {
25
+ "url": "https://github.com/samaaron/supersonic/issues"
26
+ },
27
+ "homepage": "https://github.com/samaaron/supersonic/tree/main/packages/supersonic-scsynth-bundle#readme",
28
+ "files": [
29
+ "index.js",
30
+ "README.md",
31
+ "LICENSE"
32
+ ],
33
+ "dependencies": {
34
+ "supersonic-scsynth": "^0.1.0",
35
+ "supersonic-scsynth-synthdefs": "^0.1.0",
36
+ "supersonic-scsynth-samples": "^0.1.0"
37
+ }
38
+ }