supersonic-scsynth 0.1.0 → 0.1.2

package/README.md

@@ -1,6 +1,6 @@
 # SuperSonic
 
-> **Warning - Super Alpha Status**: SuperSonic is currently in active development (v0.1.0). The API is likely to change between releases. Feedback welcome!
+> **Warning - Super Alpha Status**: SuperSonic is currently in active development (v0.1.1). The API is likely to change between releases. Feedback welcome!
 
 This is a WebAssembly port of SuperCollider's highly flexible and powerful synthesis engine scsynth.
 
@@ -16,7 +16,7 @@ Note: SuperSonic uses a SharedBuffer to send and receive OSC messages from scsyn
 ### Option 1: npm Package (Recommended)
 
 ```bash
-# Core engine only (~2MB)
+# Core engine only (~450KB)
 npm install supersonic-scsynth
 
 # Or install everything (engine + synthdefs + samples)
@@ -27,10 +27,10 @@ npm install supersonic-scsynth-bundle
 
 ```html
 <script type="module">
-  import { SuperSonic } from 'https://unpkg.com/supersonic-scsynth@0.1.0';
+  import { SuperSonic } from 'https://unpkg.com/supersonic-scsynth@latest';
 
   const sonic = new SuperSonic({
-    audioBaseURL: 'https://unpkg.com/supersonic-scsynth-samples-bd@0.1.0/samples/'
+    audioBaseURL: 'https://unpkg.com/supersonic-scsynth-samples@latest/samples/'
   });
 
   await sonic.init();
@@ -38,7 +38,7 @@ npm install supersonic-scsynth-bundle
   // Load synthdefs from CDN
   await sonic.loadSynthDefs(
     ['sonic-pi-beep'],
-    'https://unpkg.com/supersonic-scsynth-synthdefs@0.1.0/synthdefs/'
+    'https://unpkg.com/supersonic-scsynth-synthdefs@latest/synthdefs/'
   );
 </script>
 ```
@@ -49,34 +49,29 @@ The 'nightly' (i.e. for every new commit) pre-built distribution files are publi
 
 https://samaaron.github.io/supersonic/supersonic-dist.zip
 
+This includes:
+- Core engine (WASM + JS)
+- All 120 synthdefs
+- All 206 samples
+- Size: ~35MB
+
 ## Package Structure
 
 SuperSonic is published as multiple npm packages to keep the core engine small:
 
 ### Core Package
-- **`supersonic-scsynth`** (~2MB) - The WebAssembly scsynth engine
+- **`supersonic-scsynth`** (~450KB) - The WebAssembly scsynth engine
   - GPL-3.0-or-later license
 
 ### Resource Packages
-- **`supersonic-scsynth-synthdefs`** (~7MB) - All 120 Sonic Pi synthdefs
+- **`supersonic-scsynth-synthdefs`** (~67KB) - All 120 Sonic Pi synthdefs
   - MIT license
   - From [Sonic Pi](https://github.com/sonic-pi-net/sonic-pi)
 
-- **`supersonic-scsynth-samples`** - Meta-package for all Sonic Pi samples
+- **`supersonic-scsynth-samples`** (~34MB) - All 206 Sonic Pi samples
   - CC0-1.0 license (public domain)
-  - Includes 18 category packages (install individually to save space):
-    - `supersonic-scsynth-samples-bd` - Bass drums
-    - `supersonic-scsynth-samples-sn` - Snares
-    - `supersonic-scsynth-samples-hat` - Hi-hats
-    - `supersonic-scsynth-samples-loop` - Drum loops
-    - `supersonic-scsynth-samples-ambi` - Ambient sounds
-    - `supersonic-scsynth-samples-bass` - Bass sounds
-    - `supersonic-scsynth-samples-elec` - Electronic sounds
-    - `supersonic-scsynth-samples-glitch` - Glitch sounds
-    - `supersonic-scsynth-samples-guit` - Guitar sounds
-    - `supersonic-scsynth-samples-perc` - Percussion
-    - `supersonic-scsynth-samples-misc` - Miscellaneous
-    - Plus: arovane, drum, mehackit, ride, tabla, tbd, vinyl
+  - Categories: ambient, bass, drums, electronic, glitch, guitar, hi-hats, loops, percussion, snares, tabla, vinyl, and more
+  - From [Sonic Pi](https://github.com/sonic-pi-net/sonic-pi)
 
 ### Convenience Package
 - **`supersonic-scsynth-bundle`** - Includes core + synthdefs + all samples
@@ -107,7 +102,7 @@ source ~/path/to/emsdk_env.sh
 ./build.sh
 ```
 
-Outputs to `dist/` directory (~1.5MB WASM + ~80KB JS).
+Outputs to `dist/` directory (~1.5MB WASM + ~76KB JS + symlinks to synthdefs/samples).
 
 ### 2. Serve Demo
 
@@ -159,11 +154,11 @@ sonic.send('/notify', 1);
 ### With Synthdefs and Samples (npm/CDN)
 
 ```javascript
-import { SuperSonic } from 'https://unpkg.com/supersonic-scsynth@0.1.0';
+import { SuperSonic } from 'https://unpkg.com/supersonic-scsynth@latest';
 
 // Configure sample path (required for buffer loading)
 const sonic = new SuperSonic({
-  audioBaseURL: 'https://unpkg.com/supersonic-scsynth-samples-bd@0.1.0/samples/'
+  audioBaseURL: 'https://unpkg.com/supersonic-scsynth-samples@latest/samples/'
 });
 
 await sonic.init();
@@ -171,7 +166,7 @@ await sonic.init();
 // Load synthdefs (baseUrl is required)
 await sonic.loadSynthDefs(
   ['sonic-pi-beep', 'sonic-pi-tb303'],
-  'https://unpkg.com/supersonic-scsynth-synthdefs@0.1.0/synthdefs/'
+  'https://unpkg.com/supersonic-scsynth-synthdefs@latest/synthdefs/'
 );
 
 // Play a synth
@@ -230,9 +225,8 @@ npm install supersonic-scsynth
 # Synthdefs (optional)
 npm install supersonic-scsynth-synthdefs
 
-# Individual sample categories (optional)
-npm install supersonic-scsynth-samples-bd
-npm install supersonic-scsynth-samples-loop
+# Samples (optional)
+npm install supersonic-scsynth-samples
 
 # Or everything at once
 npm install supersonic-scsynth-bundle
@@ -242,16 +236,16 @@ Then use via CDN in your HTML:
 
 ```html
 <script type="module">
-  import { SuperSonic } from 'https://unpkg.com/supersonic-scsynth@0.1.0';
+  import { SuperSonic } from 'https://unpkg.com/supersonic-scsynth@latest';
 
   const sonic = new SuperSonic({
-    audioBaseURL: 'https://unpkg.com/supersonic-scsynth-samples-bd@0.1.0/samples/'
+    audioBaseURL: 'https://unpkg.com/supersonic-scsynth-samples@latest/samples/'
   });
 
   await sonic.init();
   await sonic.loadSynthDefs(
     ['sonic-pi-beep'],
-    'https://unpkg.com/supersonic-scsynth-synthdefs@0.1.0/synthdefs/'
+    'https://unpkg.com/supersonic-scsynth-synthdefs@latest/synthdefs/'
   );
 </script>
 ```
@@ -282,32 +276,23 @@ Sample and synthdef paths must be explicitly configured:
 
 ```javascript
 const sonic = new SuperSonic({
-  audioBaseURL: 'https://unpkg.com/supersonic-scsynth-samples-bd@0.1.0/samples/'
+  audioBaseURL: 'https://unpkg.com/supersonic-scsynth-samples@latest/samples/'
 });
 
 await sonic.loadSynthDefs(
   ['sonic-pi-beep'],
-  'https://unpkg.com/supersonic-scsynth-synthdefs@0.1.0/synthdefs/'
+  'https://unpkg.com/supersonic-scsynth-synthdefs@latest/synthdefs/'
 );
 ```
 
-**Engine Paths (Default):**
+**Engine Paths:**
 
 The core engine expects these files relative to your HTML:
 - WASM: `./dist/wasm/scsynth-nrt.wasm`
 - AudioWorklet: `./dist/workers/scsynth_audio_worklet.js`
 - Workers: `./dist/workers/osc_out_worker.js`, `osc_in_worker.js`, `debug_worker.js`
 
-**Custom Engine Paths:**
-
-```javascript
-const sonic = new SuperSonic();
-sonic.config.wasmUrl = '/custom/path/scsynth-nrt.wasm';
-sonic.config.workletUrl = '/custom/path/scsynth_audio_worklet.js';
-await sonic.init();
-```
-
-**Note:** Worker paths are currently hardcoded to `./dist/workers/` and cannot be configured.
+These paths are currently not configurable.
 
 
 ## License

package/dist/supersonic.js

@@ -2101,7 +2101,7 @@ var SuperSonic = class {
     }
     if (!this.audioBaseURL) {
       throw new Error(
-        'audioBaseURL not configured. Please set it in SuperSonic constructor options.\nExample: new SuperSonic({ audioBaseURL: "https://unpkg.com/supersonic-scsynth-samples-bd@0.1.0/samples/" })\nOr install sample packages: npm install supersonic-scsynth-samples-bd'
+        'audioBaseURL not configured. Please set it in SuperSonic constructor options.\nExample: new SuperSonic({ audioBaseURL: "https://unpkg.com/supersonic-scsynth-samples@latest/samples/" })\nOr install sample packages: npm install supersonic-scsynth-samples'
       );
     }
     return this.audioBaseURL + scPath;
@@ -2316,7 +2316,7 @@ var SuperSonic = class {
    * @example
    * const results = await sonic.loadSynthDefs(
    *   ['sonic-pi-beep', 'sonic-pi-tb303'],
-   *   'https://unpkg.com/supersonic-scsynth-synthdefs@0.1.0/synthdefs/'
+   *   'https://unpkg.com/supersonic-scsynth-synthdefs@latest/synthdefs/'
    * );
    */
   async loadSynthDefs(names, baseUrl) {
@@ -2325,7 +2325,7 @@ var SuperSonic = class {
     }
     if (!baseUrl) {
       throw new Error(
-        'baseUrl is required. Please specify the URL to your synthdefs.\nExample: await sonic.loadSynthDefs(["sonic-pi-beep"], "https://unpkg.com/supersonic-scsynth-synthdefs@0.1.0/synthdefs/")\nOr install: npm install supersonic-scsynth-synthdefs'
+        'baseUrl is required. Please specify the URL to your synthdefs.\nExample: await sonic.loadSynthDefs(["sonic-pi-beep"], "https://unpkg.com/supersonic-scsynth-synthdefs@latest/synthdefs/")\nOr install: npm install supersonic-scsynth-synthdefs'
       );
     }
     const results = {};

package/dist/wasm/manifest.json

@@ -1,8 +1,6 @@
 {
-  "wasmFile": "scsynth-nrt.ca1dd592.wasm",
-  "wasmFileStable": "scsynth-nrt.wasm",
-  "hash": "ca1dd592",
-  "buildId": "20251102-111057",
-  "buildTime": "2025-11-02T11:10:57Z",
-  "gitHash": "cc71875"
+  "wasmFile": "scsynth-nrt.wasm",
+  "buildId": "20251104-122135",
+  "buildTime": "2025-11-04T12:21:35Z",
+  "gitHash": "261e158"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "supersonic-scsynth",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "SuperCollider scsynth WebAssembly port for AudioWorklet - Run SuperCollider synthesis in the browser",
   "main": "dist/supersonic.js",
   "unpkg": "dist/supersonic.js",
@@ -8,8 +8,10 @@
   "type": "module",
   "scripts": {
     "build": "./build.sh",
+    "build:release": "./build.sh --release",
     "clean": "./clean.sh",
-    "dev": "cd example && ruby server.rb"
+    "dev": "cd example && ruby server.rb",
+    "prepublishOnly": "./build.sh --release"
   },
   "repository": {
     "type": "git",