@coldsurf/synth-kit 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Dong-Ho Choi
+
+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,61 @@
+# @coldsurf/synth-kit
+
+Color-blind Web Audio synthesis engines, built for [COLDSURF Tape](https://coldsurf.io) — a generative music series produced entirely from code, no samples, no external audio.
+
+## Mental model
+
+Think VST: **one engine, many patches.**
+
+- An **engine** (`createWall`, `createDrumKit`, `createBass`, `createDubChamber`, `createStrip`) knows nothing about "sound." It only accepts parameters.
+- A **preset** is the color — a plain object of parameter values (`SUNWALL`, `BLUEWALL`, `DRY_KIT`, `DUB_HOLY_BASS`, ...).
+- Every engine takes an `AudioContext` and a `bus: AudioNode` it connects into — nothing else. Compose engines by wiring their outputs into shared buses, channel strips, or a dub chamber.
+
+```ts
+import { createWall, SUNWALL, runStepClock } from '@coldsurf/synth-kit'
+
+const ctx = new AudioContext()
+const wall = createWall(ctx, ctx.destination, SUNWALL)
+
+wall.fadeIn(0.8, 2)
+wall.setChord(0)
+
+// drive the time-varying parts (distortion ramp, tremolo depth) from your own clock
+runStepClock(ctx, {
+  start: ctx.currentTime + 0.1,
+  step: 60 / 88 / 4, // 16th notes at 88 BPM
+  totalSteps: 64,
+  onStep: (_stepIdx, when) => {
+    wall.update(when - ctx.currentTime)
+  },
+})
+```
+
+## Engines
+
+| Engine | Import | Vocabulary | Built-in presets |
+| --- | --- | --- | --- |
+| Wall | `createWall` | sawtooth chord stack → WaveShaper distortion → tremolo LFO. Shoegaze/blackgaze/post-rock/post-metal walls. | `SUNWALL` · `BLUEWALL` · `WHITEWALL` · `BLACKWALL` · `SUBLIME_HATE_WALL` · `GRATIS_WALL` |
+| Drumkit | `createDrumKit` (`./drumkit`) | kick (pitched body + optional sub/click) · snare (tone + noise, optional gated tails) · hat (filtered noise, open/closed). | `DRY_KIT` · `WET_KIT` · `IRON_KIT` · `BATHEDAY_KIT` · `SUBLIME_KIT` · `REVEAL_KIT` · `DUB_RELAY_KIT` · `DUB_HOLY_KIT` · `DUB_POWER_KIT` |
+| Bass | `createBass` (`./bass`) | reese + sub layers. | `DUB_RELAY_BASS` · `DUB_HOLY_BASS` · `DUB_POWER_BASS` |
+| Dub chamber | `createDubChamber` (`./dub`) | sidechain duck bus + cross-feedback stereo delay return + tape saturation → master. | `DUB_RELAY_CHAMBER` · `DUB_HOLY_CHAMBER` · `DUB_POWER_CHAMBER` · `CRUSH_CHAMBER` |
+| Space | `createStrip` (`./space`) | per-instrument channel strip — pan + carve EQ (HP/LP/bell), opt-in only. | — (mixer, not an instrument) |
+| Scheduler | `runStepClock` | color-blind lookahead step clock (`AudioContext.currentTime` based, no `setInterval` jitter). | — |
+
+All engine handles expose `dispose()`. Instrument engines that hold time-varying parameters (wall's distortion/tremolo ramps) expose `update(elapsedSec)` — call it from your own clock (e.g. `runStepClock`).
+
+## Design invariants
+
+- **Zero runtime dependencies.** Pure Web Audio API + TypeScript.
+- **Single-entry barrels.** Import from the package root or its `./drumkit` / `./bass` / `./dub` / `./space` subpaths only — no deep imports into internal files.
+- **Engines never own scheduling, master fades, sidechain, or panning.** Those are the caller's responsibility — engines only build the node graph and expose handles.
+- **Presets never merge "close enough" values.** Two presets that look nearly identical (e.g. two kick bodies 3 Hz apart) stay separate constants — the goal is preserving an exact, previously-shipped sound, not deduplicating numbers.
+
+## Browser vs. offline rendering
+
+This package is built and tested against real browser `AudioContext`. It does **not** currently ship an offline-rendering runtime.
+
+If you plan to render score/patterns to a `.wav` file outside a browser (e.g. from a CLI or server process), be aware: some engines' time-varying parameters (the `wall` engine's distortion envelope, specifically) reassign `WaveShaperNode.curve` at runtime, which real browsers allow but [`node-web-audio-api`](https://github.com/ircam-ircam/node-web-audio-api) currently does not. Presets with a static (non-ramping) distortion value, and all `drumkit`/`bass`/`dub` engines, are unaffected. A dedicated offline-rendering story (headless-browser based, or an engine-level fix) is tracked separately — see the issues tab.
+
+## License
+
+MIT

package/dist/bass/index.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Bass — *저역* 합성 엔진. dub 트랙들이 글자 그대로 복제하던 sub·reese 베이스 골격을
+ * 한 악기로. sunwall·drumkit 과 같은 VST 모델: `createBass` 는 *색-불문 엔진*,
+ * `*_BASS` 는 *패치*.
+ *
+ *   sub   : sine + 보조 osc(triangle/같은·살짝 detune) → AD-sustain env → bus
+ *   reese : detuned saw × 2(한 옥타브 위) → resonant lowpass → tanh saturation → bus
+ *
+ * 엔진은 *voice 합성* 만 한다 — `(when, freq, dur, velocity)` 절대시간으로 `bus` 에 한 음을
+ * 그린다. 스케줄링(스텝 루프)·master fade·사이드체인 duck·dub send 는 *트랙* 의 책임이며
+ * 엔진 밖이다 (drumkit 과 동일한 정규화 기준). dub-holy 처럼 sub 만 쓰는 트랙은 preset 에서
+ * `reese` 를 비우면 `reese()` 가 no-op.
+ *
+ * 보존 기준: 들리는 envelope(attack·sustain·release)·필터·saturation·디튠은 원본 상수 그대로
+ * preset 으로 주입. 들리지 않는 것만 정규화 — saturation 커브 Float32Array 는 핸들당 한 번
+ * 계산해 음마다 재사용(내용 동일), ephemeral voice 노드의 지연 disconnect 는 drumkit 과 동일.
+ *
+ * 트랙 전용 저역(dig-it 의 motorik saw bass 등)은 rule-of-three 미달이라 트랙 인라인으로 남는다.
+ */
+/** sub 베이스 voice — sine + 보조 osc 의 sustained 저역 드론. */
+interface SubPreset {
+    /** 보조 osc 파형. 세 트랙 'triangle'. */
+    secondType: OscillatorType;
+    /** 보조 osc freq 배율 — *맥놀이* detune. relay·power 1, holy 1.005. 기본 1. */
+    secondRatio?: number;
+    /** gain attack(0.0001 → velocity) 시간. relay 0.04 / power 0.05 / holy 0.08. */
+    attack: number;
+    /** sustain 종료~exp decay 구간 길이. hold 는 `when + dur - release` 까지. relay 0.12 / power 0.15 / holy 0.2. */
+    release: number;
+}
+/** reese 베이스 voice — *우글거리는* mid-bass(detuned saw → resonant LP → tanh sat). */
+interface ReesePreset {
+    /** root 대비 옥타브 배율. 세 트랙 2(한 옥타브 위). 기본 2. */
+    octaveRatio?: number;
+    /** saw voice 디튠 ±cents. relay 8 / power 10. */
+    detuneCents: number;
+    /** lowpass cutoff(Hz). relay 380 / power 420. */
+    lpHz: number;
+    /** lowpass Q(resonance). relay 6 / power 5.5. */
+    lpQ: number;
+    /** tanh saturation drive. relay 3.5 / power 3.2. */
+    satK: number;
+    /** gain attack 시간. relay 0.012 / power 0.015. */
+    attack: number;
+    /** sustain 종료~exp decay 구간 길이. relay 0.05 / power 0.06. */
+    release: number;
+}
+interface BassPreset {
+    sub?: SubPreset;
+    reese?: ReesePreset;
+}
+interface BassHandle {
+    /** when 에 sub 한 음(dur 동안 sustain). preset.sub 없으면 no-op. */
+    sub(when: number, freq: number, dur: number, velocity: number): void;
+    /** when 에 reese 한 음. preset.reese 없으면 no-op. */
+    reese(when: number, freq: number, dur: number, velocity: number): void;
+    /** 공유 노드 정리. ephemeral voice 노드는 self-stop + 내부 타임아웃 disconnect. */
+    dispose(): void;
+}
+/**
+ * 베이스를 만들어 `bus` 로 voice 를 합성하는 핸들을 돌려준다.
+ *
+ * @param bus 각 음이 연결될 목적지(트랙의 ductable·master 등).
+ */
+declare function createBass(ctx: AudioContext, bus: AudioNode, preset: BassPreset): BassHandle;
+
+/**
+ * Bass presets — *bass 패치*. 트랙당 하나. 각 dub 트랙 인라인 베이스의 *들리는 상수* 를 그대로
+ * 옮긴 것이라, 거의 같아 보여도(예: relay lp380/Q6 vs power lp420/Q5.5) 합치지 않는다 —
+ * *소리 보존* 이 기준. dedup 이득은 엔진(`createBass`)이지 preset 수가 아니다.
+ *
+ * dub-holy 는 reese 없이 sub 만 — *대성당의 드론* 은 sustained sub + organ pad 가 핵이라
+ * reese 의 *우글거림* 을 쓰지 않는다.
+ */
+
+/** Dub the Wall(21) — *둥둥둥* 의 잔음. relay 의 sub(38–55 Hz)·reese(Berghain 결). */
+declare const DUB_RELAY_BASS: BassPreset;
+/** Dub Holy(20) — *대성당의 sub 드론*. 60–120 Hz, 보조 osc 살짝 detune(맥놀이). reese 없음. */
+declare const DUB_HOLY_BASS: BassPreset;
+/** Dub Power(22) — *peak 64.6 Hz* 의 sub + *권위의 우글거림* reese. */
+declare const DUB_POWER_BASS: BassPreset;
+
+export { type BassHandle, type BassPreset, DUB_HOLY_BASS, DUB_POWER_BASS, DUB_RELAY_BASS, type ReesePreset, type SubPreset, createBass };

package/dist/bass/index.js

@@ -0,0 +1,13 @@
+import {
+  DUB_HOLY_BASS,
+  DUB_POWER_BASS,
+  DUB_RELAY_BASS,
+  createBass
+} from "../chunk-CNJ6DQV5.js";
+export {
+  DUB_HOLY_BASS,
+  DUB_POWER_BASS,
+  DUB_RELAY_BASS,
+  createBass
+};
+//# sourceMappingURL=index.js.map

package/dist/bass/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/chunk-CMHDHRZ6.js

@@ -0,0 +1,61 @@
+// src/space/strip.ts
+function createStrip(ctx, dest, preset) {
+  const input = ctx.createGain();
+  input.gain.value = preset.gain ?? 1;
+  const nodes = [input];
+  let tail = input;
+  const BUTTERWORTH_Q = Math.SQRT1_2;
+  if (preset.hpHz !== void 0) {
+    const hp = ctx.createBiquadFilter();
+    hp.type = "highpass";
+    hp.frequency.value = preset.hpHz;
+    hp.Q.value = preset.hpQ ?? BUTTERWORTH_Q;
+    tail.connect(hp);
+    nodes.push(hp);
+    tail = hp;
+  }
+  if (preset.lpHz !== void 0) {
+    const lp = ctx.createBiquadFilter();
+    lp.type = "lowpass";
+    lp.frequency.value = preset.lpHz;
+    lp.Q.value = preset.lpQ ?? BUTTERWORTH_Q;
+    tail.connect(lp);
+    nodes.push(lp);
+    tail = lp;
+  }
+  if (preset.bell !== void 0) {
+    const bell = ctx.createBiquadFilter();
+    bell.type = "peaking";
+    bell.frequency.value = preset.bell.hz;
+    bell.Q.value = preset.bell.q;
+    bell.gain.value = preset.bell.gainDb;
+    tail.connect(bell);
+    nodes.push(bell);
+    tail = bell;
+  }
+  const panner = ctx.createStereoPanner();
+  panner.pan.value = preset.pan ?? 0;
+  tail.connect(panner).connect(dest);
+  nodes.push(panner);
+  return {
+    input,
+    setPan(value, rampSec) {
+      const now = ctx.currentTime;
+      panner.pan.cancelScheduledValues(now);
+      if (rampSec <= 0) {
+        panner.pan.setValueAtTime(value, now);
+        return;
+      }
+      panner.pan.setValueAtTime(panner.pan.value, now);
+      panner.pan.linearRampToValueAtTime(value, now + rampSec);
+    },
+    dispose() {
+      for (const node of nodes) node.disconnect();
+    }
+  };
+}
+
+export {
+  createStrip
+};
+//# sourceMappingURL=chunk-CMHDHRZ6.js.map

package/dist/chunk-CMHDHRZ6.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/space/strip.ts"],"sourcesContent":["/**\n * Channel strip — *공간/믹스* 어휘의 공유 도구. sunwall·drumkit·dub·bass 가 한 트랙에서\n * 동시에 울릴 때 저-중역이 겹쳐 뭉개지는 문제를, 악기 *밖* 의 per-instrument 채널 스트립으로\n * 푼다(패닝 + carve EQ). VST 모델: `createStrip` 은 *믹서 한 채널*, `StripPreset` 은 *그 설정*.\n *\n * 엔진은 무변경. 모든 엔진이 출력을 *주입받은 `AudioNode` bus* 로만 쓰므로(`createWall(ctx, bus,…)`\n * 등), 스트립은 그 `bus` 자리에 끼워넣는 한 노드 묶음일 뿐이다 — 엔진 시그니처·내부 그래프 불변.\n *\n *   input(trim gain) → [HP] → [LP] → [bell peaking] → StereoPanner → dest\n *\n * **옵트인 불변식**: preset 의 carve 필드(`hpHz`·`lpHz`·`bell`)는 *있을 때만* 노드를 만든다\n * (sunwall 의 `bend` 미지정 = 미생성 패턴). 빈 preset(`{}`)이면 trim gain(=1) + StereoPanner(pan 0)\n * 뿐 → 센터 모노로 투명. 즉 트랙이 *명시적으로* preset 을 줄 때만 소리가 변한다.\n *\n * offline wav 렌더(실 Chromium `OfflineAudioContext` 바운스) 호환: `StereoPannerNode`·\n * `BiquadFilterNode` 는 표준 노드라 별도 facade 불필요(하니스 `scripts/sound-render-harness.ts`).\n */\n\nexport interface StripPreset {\n  /** StereoPanner pan. -1(L)~+1(R). 기본 0(센터·모노 유지). */\n  pan?: number\n  /** carve HP cutoff(Hz). 베이스/킥 자리 비우기. 기본 미생성(bypass). */\n  hpHz?: number\n  /** HP Q. 기본 BiquadFilter 기본값(0.7071). */\n  hpQ?: number\n  /** carve LP cutoff(Hz). 위 악기에 고역 양보. 기본 미생성(bypass). */\n  lpHz?: number\n  /** LP Q. 기본 BiquadFilter 기본값. */\n  lpQ?: number\n  /** 보충 notch/peak — 특정 충돌 대역만 ±dB(예: 벽 250Hz -3dB). 기본 미생성(bypass). */\n  bell?: { hz: number; q: number; gainDb: number }\n  /** 스트립 트림 gain. 기본 1. */\n  gain?: number\n}\n\nexport interface StripHandle {\n  /** 엔진이 출력을 꽂는 입력 노드(= 체인 맨 앞 trim gain). */\n  readonly input: AudioNode\n  /** pan 을 value 로 ramp(섹션 자동화용·옵션). rampSec<=0 이면 즉시. */\n  setPan(value: number, rampSec: number): void\n  /** stop 없음 — 패시브 체인. 전체 노드 disconnect. */\n  dispose(): void\n}\n\n/**\n * 채널 스트립을 만들어 `dest` 앞에 끼운다. 엔진은 돌려받은 `input` 으로 출력을 꽂는다.\n *\n * carve 필드(`hpHz`·`lpHz`·`bell`)는 *있을 때만* 노드를 만든다 — 빈 preset 은 trim gain +\n * pan 0 panner 뿐(투명).\n *\n * @param dest 스트립 출력이 연결될 목적지(트랙의 ductable·master 등).\n */\nexport function createStrip(ctx: AudioContext, dest: AudioNode, preset: StripPreset): StripHandle {\n  // 체인 맨 앞 = trim gain. 엔진이 여기 꽂는다(빈 preset 이면 gain 1 → 투명).\n  const input = ctx.createGain()\n  input.gain.value = preset.gain ?? 1\n\n  // 패시브 노드 모음 — dispose 시 전부 disconnect.\n  const nodes: AudioNode[] = [input]\n  let tail: AudioNode = input\n\n  // carve 필터 Q 기본 = 1/√2(Butterworth, 평탄). BiquadFilter 의 기본 Q 는 1 이라 cutoff 에\n  // +1.25 dB *공진 봉우리* 가 생기는데, carve(자리 비우기)용 필터엔 부적절하다 — 봉우리가 깎으려던\n  // 대역(예: 150~200 Hz)에 오히려 에너지를 더해, 모인 신호가 챔버 saturation rail 을 더 세게 때린다.\n  const BUTTERWORTH_Q = Math.SQRT1_2\n\n  if (preset.hpHz !== undefined) {\n    const hp = ctx.createBiquadFilter()\n    hp.type = 'highpass'\n    hp.frequency.value = preset.hpHz\n    hp.Q.value = preset.hpQ ?? BUTTERWORTH_Q\n    tail.connect(hp)\n    nodes.push(hp)\n    tail = hp\n  }\n\n  if (preset.lpHz !== undefined) {\n    const lp = ctx.createBiquadFilter()\n    lp.type = 'lowpass'\n    lp.frequency.value = preset.lpHz\n    lp.Q.value = preset.lpQ ?? BUTTERWORTH_Q\n    tail.connect(lp)\n    nodes.push(lp)\n    tail = lp\n  }\n\n  if (preset.bell !== undefined) {\n    const bell = ctx.createBiquadFilter()\n    bell.type = 'peaking'\n    bell.frequency.value = preset.bell.hz\n    bell.Q.value = preset.bell.q\n    bell.gain.value = preset.bell.gainDb\n    tail.connect(bell)\n    nodes.push(bell)\n    tail = bell\n  }\n\n  // panner 는 항상 존재(pan 0 = 투명). setPan 자동화의 고정 핸들.\n  const panner = ctx.createStereoPanner()\n  panner.pan.value = preset.pan ?? 0\n  tail.connect(panner).connect(dest)\n  nodes.push(panner)\n\n  return {\n    input,\n    setPan(value: number, rampSec: number) {\n      const now = ctx.currentTime\n      panner.pan.cancelScheduledValues(now)\n      if (rampSec <= 0) {\n        panner.pan.setValueAtTime(value, now)\n        return\n      }\n      panner.pan.setValueAtTime(panner.pan.value, now)\n      panner.pan.linearRampToValueAtTime(value, now + rampSec)\n    },\n    dispose() {\n      for (const node of nodes) node.disconnect()\n    },\n  }\n}\n"],"mappings":";AAoDO,SAAS,YAAY,KAAmB,MAAiB,QAAkC;AAEhG,QAAM,QAAQ,IAAI,WAAW;AAC7B,QAAM,KAAK,QAAQ,OAAO,QAAQ;AAGlC,QAAM,QAAqB,CAAC,KAAK;AACjC,MAAI,OAAkB;AAKtB,QAAM,gBAAgB,KAAK;AAE3B,MAAI,OAAO,SAAS,QAAW;AAC7B,UAAM,KAAK,IAAI,mBAAmB;AAClC,OAAG,OAAO;AACV,OAAG,UAAU,QAAQ,OAAO;AAC5B,OAAG,EAAE,QAAQ,OAAO,OAAO;AAC3B,SAAK,QAAQ,EAAE;AACf,UAAM,KAAK,EAAE;AACb,WAAO;AAAA,EACT;AAEA,MAAI,OAAO,SAAS,QAAW;AAC7B,UAAM,KAAK,IAAI,mBAAmB;AAClC,OAAG,OAAO;AACV,OAAG,UAAU,QAAQ,OAAO;AAC5B,OAAG,EAAE,QAAQ,OAAO,OAAO;AAC3B,SAAK,QAAQ,EAAE;AACf,UAAM,KAAK,EAAE;AACb,WAAO;AAAA,EACT;AAEA,MAAI,OAAO,SAAS,QAAW;AAC7B,UAAM,OAAO,IAAI,mBAAmB;AACpC,SAAK,OAAO;AACZ,SAAK,UAAU,QAAQ,OAAO,KAAK;AACnC,SAAK,EAAE,QAAQ,OAAO,KAAK;AAC3B,SAAK,KAAK,QAAQ,OAAO,KAAK;AAC9B,SAAK,QAAQ,IAAI;AACjB,UAAM,KAAK,IAAI;AACf,WAAO;AAAA,EACT;AAGA,QAAM,SAAS,IAAI,mBAAmB;AACtC,SAAO,IAAI,QAAQ,OAAO,OAAO;AACjC,OAAK,QAAQ,MAAM,EAAE,QAAQ,IAAI;AACjC,QAAM,KAAK,MAAM;AAEjB,SAAO;AAAA,IACL;AAAA,IACA,OAAO,OAAe,SAAiB;AACrC,YAAM,MAAM,IAAI;AAChB,aAAO,IAAI,sBAAsB,GAAG;AACpC,UAAI,WAAW,GAAG;AAChB,eAAO,IAAI,eAAe,OAAO,GAAG;AACpC;AAAA,MACF;AACA,aAAO,IAAI,eAAe,OAAO,IAAI,OAAO,GAAG;AAC/C,aAAO,IAAI,wBAAwB,OAAO,MAAM,OAAO;AAAA,IACzD;AAAA,IACA,UAAU;AACR,iBAAW,QAAQ,MAAO,MAAK,WAAW;AAAA,IAC5C;AAAA,EACF;AACF;","names":[]}

package/dist/chunk-CNJ6DQV5.js

@@ -0,0 +1,147 @@
+// src/bass/bass.ts
+function makeSaturationCurve(k) {
+  const n = 512;
+  const buffer = new ArrayBuffer(n * Float32Array.BYTES_PER_ELEMENT);
+  const curve = new Float32Array(buffer);
+  const denom = Math.tanh(k);
+  for (let i = 0; i < n; i++) {
+    const x = i / (n - 1) * 2 - 1;
+    curve[i] = Math.tanh(k * x) / denom;
+  }
+  return curve;
+}
+function createBass(ctx, bus, preset) {
+  const reeseCurve = preset.reese ? makeSaturationCurve(preset.reese.satK) : null;
+  let stopped = false;
+  const pending = /* @__PURE__ */ new Set();
+  const trackDispose = (fn, lifetimeMs) => {
+    pending.add(fn);
+    window.setTimeout(() => {
+      if (pending.has(fn)) {
+        fn();
+        pending.delete(fn);
+      }
+    }, lifetimeMs);
+  };
+  function sub(when, freq, dur, velocity) {
+    if (stopped || !preset.sub) return;
+    const s = preset.sub;
+    const osc = ctx.createOscillator();
+    osc.type = "sine";
+    osc.frequency.value = freq;
+    const osc2 = ctx.createOscillator();
+    osc2.type = s.secondType;
+    osc2.frequency.value = freq * (s.secondRatio ?? 1);
+    const g = ctx.createGain();
+    g.gain.setValueAtTime(1e-4, when);
+    g.gain.linearRampToValueAtTime(velocity, when + s.attack);
+    g.gain.setValueAtTime(velocity, when + dur - s.release);
+    g.gain.exponentialRampToValueAtTime(1e-4, when + dur);
+    osc.connect(g).connect(bus);
+    osc2.connect(g);
+    osc.start(when);
+    osc2.start(when);
+    const stop = dur + 0.05;
+    osc.stop(when + stop);
+    osc2.stop(when + stop);
+    trackDispose(
+      () => {
+        try {
+          osc.stop();
+          osc2.stop();
+        } catch {
+        }
+        osc.disconnect();
+        osc2.disconnect();
+        g.disconnect();
+      },
+      (stop + 0.1) * 1e3
+    );
+  }
+  function reese(when, freq, dur, velocity) {
+    if (stopped || !preset.reese || !reeseCurve) return;
+    const r = preset.reese;
+    const out = ctx.createGain();
+    out.gain.setValueAtTime(1e-4, when);
+    out.gain.linearRampToValueAtTime(velocity, when + r.attack);
+    out.gain.setValueAtTime(velocity, when + dur - r.release);
+    out.gain.exponentialRampToValueAtTime(1e-4, when + dur);
+    const lp = ctx.createBiquadFilter();
+    lp.type = "lowpass";
+    lp.frequency.value = r.lpHz;
+    lp.Q.value = r.lpQ;
+    out.connect(lp);
+    const sat = ctx.createWaveShaper();
+    sat.curve = reeseCurve;
+    sat.oversample = "2x";
+    lp.connect(sat).connect(bus);
+    const octave = r.octaveRatio ?? 2;
+    const oscs = [];
+    const gains = [];
+    const stop = dur + 0.05;
+    for (let v = 0; v < 2; v++) {
+      const osc = ctx.createOscillator();
+      osc.type = "sawtooth";
+      const cents = v === 0 ? -r.detuneCents : r.detuneCents;
+      osc.frequency.value = freq * octave * 2 ** (cents / 1200);
+      const og = ctx.createGain();
+      og.gain.value = 0.5;
+      osc.connect(og).connect(out);
+      osc.start(when);
+      osc.stop(when + stop);
+      oscs.push(osc);
+      gains.push(og);
+    }
+    trackDispose(
+      () => {
+        for (const osc of oscs) {
+          try {
+            osc.stop();
+          } catch {
+          }
+          osc.disconnect();
+        }
+        for (const og of gains) og.disconnect();
+        out.disconnect();
+        lp.disconnect();
+        sat.disconnect();
+      },
+      (stop + 0.1) * 1e3
+    );
+  }
+  return {
+    sub,
+    reese,
+    dispose() {
+      stopped = true;
+      for (const fn of pending) {
+        try {
+          fn();
+        } catch {
+        }
+      }
+      pending.clear();
+    }
+  };
+}
+
+// src/bass/basses.ts
+var DUB_RELAY_BASS = {
+  sub: { secondType: "triangle", attack: 0.04, release: 0.12 },
+  reese: { detuneCents: 8, lpHz: 380, lpQ: 6, satK: 3.5, attack: 0.012, release: 0.05 }
+};
+var DUB_HOLY_BASS = {
+  sub: { secondType: "triangle", secondRatio: 1.005, attack: 0.08, release: 0.2 }
+};
+var DUB_POWER_BASS = {
+  sub: { secondType: "triangle", attack: 0.05, release: 0.15 },
+  reese: { detuneCents: 10, lpHz: 420, lpQ: 5.5, satK: 3.2, attack: 0.015, release: 0.06 }
+};
+
+export {
+  createBass,
+  DUB_RELAY_BASS,
+  DUB_HOLY_BASS,
+  DUB_POWER_BASS
+};
+//# sourceMappingURL=chunk-CNJ6DQV5.js.map

package/dist/chunk-CNJ6DQV5.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/bass/bass.ts","../src/bass/basses.ts"],"sourcesContent":["/**\n * Bass — *저역* 합성 엔진. dub 트랙들이 글자 그대로 복제하던 sub·reese 베이스 골격을\n * 한 악기로. sunwall·drumkit 과 같은 VST 모델: `createBass` 는 *색-불문 엔진*,\n * `*_BASS` 는 *패치*.\n *\n *   sub   : sine + 보조 osc(triangle/같은·살짝 detune) → AD-sustain env → bus\n *   reese : detuned saw × 2(한 옥타브 위) → resonant lowpass → tanh saturation → bus\n *\n * 엔진은 *voice 합성* 만 한다 — `(when, freq, dur, velocity)` 절대시간으로 `bus` 에 한 음을\n * 그린다. 스케줄링(스텝 루프)·master fade·사이드체인 duck·dub send 는 *트랙* 의 책임이며\n * 엔진 밖이다 (drumkit 과 동일한 정규화 기준). dub-holy 처럼 sub 만 쓰는 트랙은 preset 에서\n * `reese` 를 비우면 `reese()` 가 no-op.\n *\n * 보존 기준: 들리는 envelope(attack·sustain·release)·필터·saturation·디튠은 원본 상수 그대로\n * preset 으로 주입. 들리지 않는 것만 정규화 — saturation 커브 Float32Array 는 핸들당 한 번\n * 계산해 음마다 재사용(내용 동일), ephemeral voice 노드의 지연 disconnect 는 drumkit 과 동일.\n *\n * 트랙 전용 저역(dig-it 의 motorik saw bass 등)은 rule-of-three 미달이라 트랙 인라인으로 남는다.\n */\n\n/** sub 베이스 voice — sine + 보조 osc 의 sustained 저역 드론. */\nexport interface SubPreset {\n  /** 보조 osc 파형. 세 트랙 'triangle'. */\n  secondType: OscillatorType\n  /** 보조 osc freq 배율 — *맥놀이* detune. relay·power 1, holy 1.005. 기본 1. */\n  secondRatio?: number\n  /** gain attack(0.0001 → velocity) 시간. relay 0.04 / power 0.05 / holy 0.08. */\n  attack: number\n  /** sustain 종료~exp decay 구간 길이. hold 는 `when + dur - release` 까지. relay 0.12 / power 0.15 / holy 0.2. */\n  release: number\n}\n\n/** reese 베이스 voice — *우글거리는* mid-bass(detuned saw → resonant LP → tanh sat). */\nexport interface ReesePreset {\n  /** root 대비 옥타브 배율. 세 트랙 2(한 옥타브 위). 기본 2. */\n  octaveRatio?: number\n  /** saw voice 디튠 ±cents. relay 8 / power 10. */\n  detuneCents: number\n  /** lowpass cutoff(Hz). relay 380 / power 420. */\n  lpHz: number\n  /** lowpass Q(resonance). relay 6 / power 5.5. */\n  lpQ: number\n  /** tanh saturation drive. relay 3.5 / power 3.2. */\n  satK: number\n  /** gain attack 시간. relay 0.012 / power 0.015. */\n  attack: number\n  /** sustain 종료~exp decay 구간 길이. relay 0.05 / power 0.06. */\n  release: number\n}\n\nexport interface BassPreset {\n  sub?: SubPreset\n  reese?: ReesePreset\n}\n\nexport interface BassHandle {\n  /** when 에 sub 한 음(dur 동안 sustain). preset.sub 없으면 no-op. */\n  sub(when: number, freq: number, dur: number, velocity: number): void\n  /** when 에 reese 한 음. preset.reese 없으면 no-op. */\n  reese(when: number, freq: number, dur: number, velocity: number): void\n  /** 공유 노드 정리. ephemeral voice 노드는 self-stop + 내부 타임아웃 disconnect. */\n  dispose(): void\n}\n\n/** tanh saturation 커브 — reese 의 *우글거림*. drive 가 클수록 거칠다. */\nfunction makeSaturationCurve(k: number): Float32Array<ArrayBuffer> {\n  const n = 512\n  const buffer = new ArrayBuffer(n * Float32Array.BYTES_PER_ELEMENT)\n  const curve = new Float32Array(buffer)\n  const denom = Math.tanh(k)\n  for (let i = 0; i < n; i++) {\n    const x = (i / (n - 1)) * 2 - 1\n    curve[i] = Math.tanh(k * x) / denom\n  }\n  return curve\n}\n\n/**\n * 베이스를 만들어 `bus` 로 voice 를 합성하는 핸들을 돌려준다.\n *\n * @param bus 각 음이 연결될 목적지(트랙의 ductable·master 등).\n */\nexport function createBass(ctx: AudioContext, bus: AudioNode, preset: BassPreset): BassHandle {\n  // reese saturation 커브 — 핸들당 한 번. 음마다 새 WaveShaper 가 같은 Float32Array 를 공유.\n  const reeseCurve = preset.reese ? makeSaturationCurve(preset.reese.satK) : null\n\n  // ephemeral voice 노드의 지연 disconnect — drumkit 과 동일한 cleanup.\n  let stopped = false\n  const pending = new Set<() => void>()\n  const trackDispose = (fn: () => void, lifetimeMs: number) => {\n    pending.add(fn)\n    window.setTimeout(() => {\n      if (pending.has(fn)) {\n        fn()\n        pending.delete(fn)\n      }\n    }, lifetimeMs)\n  }\n\n  function sub(when: number, freq: number, dur: number, velocity: number) {\n    if (stopped || !preset.sub) return\n    const s = preset.sub\n\n    const osc = ctx.createOscillator()\n    osc.type = 'sine'\n    osc.frequency.value = freq\n    const osc2 = ctx.createOscillator()\n    osc2.type = s.secondType\n    osc2.frequency.value = freq * (s.secondRatio ?? 1)\n\n    const g = ctx.createGain()\n    g.gain.setValueAtTime(0.0001, when)\n    g.gain.linearRampToValueAtTime(velocity, when + s.attack)\n    g.gain.setValueAtTime(velocity, when + dur - s.release)\n    g.gain.exponentialRampToValueAtTime(0.0001, when + dur)\n    osc.connect(g).connect(bus)\n    osc2.connect(g)\n    osc.start(when)\n    osc2.start(when)\n    const stop = dur + 0.05\n    osc.stop(when + stop)\n    osc2.stop(when + stop)\n    trackDispose(\n      () => {\n        try {\n          osc.stop()\n          osc2.stop()\n        } catch {\n          // 이미 정지 — 무해.\n        }\n        osc.disconnect()\n        osc2.disconnect()\n        g.disconnect()\n      },\n      (stop + 0.1) * 1000,\n    )\n  }\n\n  function reese(when: number, freq: number, dur: number, velocity: number) {\n    if (stopped || !preset.reese || !reeseCurve) return\n    const r = preset.reese\n\n    const out = ctx.createGain()\n    out.gain.setValueAtTime(0.0001, when)\n    out.gain.linearRampToValueAtTime(velocity, when + r.attack)\n    out.gain.setValueAtTime(velocity, when + dur - r.release)\n    out.gain.exponentialRampToValueAtTime(0.0001, when + dur)\n\n    const lp = ctx.createBiquadFilter()\n    lp.type = 'lowpass'\n    lp.frequency.value = r.lpHz\n    lp.Q.value = r.lpQ\n    out.connect(lp)\n\n    const sat = ctx.createWaveShaper()\n    sat.curve = reeseCurve\n    sat.oversample = '2x'\n    lp.connect(sat).connect(bus)\n\n    const octave = r.octaveRatio ?? 2\n    const oscs: OscillatorNode[] = []\n    const gains: GainNode[] = []\n    const stop = dur + 0.05\n    for (let v = 0; v < 2; v++) {\n      const osc = ctx.createOscillator()\n      osc.type = 'sawtooth'\n      const cents = v === 0 ? -r.detuneCents : r.detuneCents\n      osc.frequency.value = freq * octave * 2 ** (cents / 1200)\n      const og = ctx.createGain()\n      og.gain.value = 0.5\n      osc.connect(og).connect(out)\n      osc.start(when)\n      osc.stop(when + stop)\n      oscs.push(osc)\n      gains.push(og)\n    }\n    trackDispose(\n      () => {\n        for (const osc of oscs) {\n          try {\n            osc.stop()\n          } catch {\n            // 이미 정지 — 무해.\n          }\n          osc.disconnect()\n        }\n        for (const og of gains) og.disconnect()\n        out.disconnect()\n        lp.disconnect()\n        sat.disconnect()\n      },\n      (stop + 0.1) * 1000,\n    )\n  }\n\n  return {\n    sub,\n    reese,\n    dispose() {\n      stopped = true\n      for (const fn of pending) {\n        try {\n          fn()\n        } catch {\n          // 이미 정리됨 — 무해.\n        }\n      }\n      pending.clear()\n    },\n  }\n}\n","/**\n * Bass presets — *bass 패치*. 트랙당 하나. 각 dub 트랙 인라인 베이스의 *들리는 상수* 를 그대로\n * 옮긴 것이라, 거의 같아 보여도(예: relay lp380/Q6 vs power lp420/Q5.5) 합치지 않는다 —\n * *소리 보존* 이 기준. dedup 이득은 엔진(`createBass`)이지 preset 수가 아니다.\n *\n * dub-holy 는 reese 없이 sub 만 — *대성당의 드론* 은 sustained sub + organ pad 가 핵이라\n * reese 의 *우글거림* 을 쓰지 않는다.\n */\n\nimport type { BassPreset } from './bass'\n\n/** Dub the Wall(21) — *둥둥둥* 의 잔음. relay 의 sub(38–55 Hz)·reese(Berghain 결). */\nexport const DUB_RELAY_BASS: BassPreset = {\n  sub: { secondType: 'triangle', attack: 0.04, release: 0.12 },\n  reese: { detuneCents: 8, lpHz: 380, lpQ: 6, satK: 3.5, attack: 0.012, release: 0.05 },\n}\n\n/** Dub Holy(20) — *대성당의 sub 드론*. 60–120 Hz, 보조 osc 살짝 detune(맥놀이). reese 없음. */\nexport const DUB_HOLY_BASS: BassPreset = {\n  sub: { secondType: 'triangle', secondRatio: 1.005, attack: 0.08, release: 0.2 },\n}\n\n/** Dub Power(22) — *peak 64.6 Hz* 의 sub + *권위의 우글거림* reese. */\nexport const DUB_POWER_BASS: BassPreset = {\n  sub: { secondType: 'triangle', attack: 0.05, release: 0.15 },\n  reese: { detuneCents: 10, lpHz: 420, lpQ: 5.5, satK: 3.2, attack: 0.015, release: 0.06 },\n}\n"],"mappings":"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","names":[]}

package/dist/drumkit/index.d.ts

@@ -0,0 +1,153 @@
+/**
+ * Drumkit — *타악* 합성 엔진. catalog 트랙들이 글자 그대로 복제하던 kick·snare·hat 골격을
+ * 한 악기로. sunwall 과 같은 VST 모델: `createDrumKit` 은 *색-불문 엔진*, `*_KIT` 은 *패치*.
+ *
+ *   kick   : body osc(피치 envelope) → gain env → bus  (+ 옵션 sub body, click transient)
+ *   snare  : tone osc + bandpass noise (+ 옵션 gated reverb tail × N)
+ *   hat    : highpass(+옵션 bandpass) noise → gain env (closed/open)
+ *
+ * 엔진은 *voice 합성* 만 한다 — `(when, velocity)` 절대시간으로 `bus` 에 한 타격을 그린다.
+ * 스케줄링(스텝 루프)·master fade·사이드체인 duck·dub send 는 *트랙* 의 책임이며 엔진 밖이다.
+ * 한 곡 전용 voice(metalHit·tom·shimmer·salute·
+ * crash·clap·rim)는 rule-of-three 미달이라 트랙 인라인으로 남는다.
+ *
+ * 보존 기준: 들리는 envelope(attack·peak·decay)·필터·피치는 원본 상수 그대로. 들리지 않는
+ * 것만 정규화 — ① white noise 버퍼 내용(통계적으로 동일한 난수), ② 일부 노드 stop() 시점은
+ * preset 의 `stop`/`stopPad` 로 그대로 박는다.
+ */
+/** envelope ramp 종류. dub kick 은 exp attack(peak>velocity 허용), 그 외엔 lin. */
+type Ramp = 'lin' | 'exp';
+/** 피치 + gain envelope 한 layer (kick body·sub 공용). */
+interface KickBody {
+    startHz: number;
+    endHz: number;
+    /** freq exponentialRamp 도달 시간. */
+    pitchTau: number;
+    /** gain attack 시간. */
+    attack: number;
+    attackCurve: Ramp;
+    /** peak gain = velocity * peakMul. 기본 1. dub body1 은 1.3 등. */
+    peakMul?: number;
+    /** gain exponentialRamp→0 도달 시간(=감쇠 끝). */
+    decay: number;
+    /** osc.stop(when + stop). */
+    stop: number;
+}
+/** kick transient click — 짧은 highpass noise burst. */
+interface KickClick {
+    hpHz: number;
+    /** peak = velocity * level. */
+    level: number;
+    attack: number;
+    attackCurve: Ramp;
+    decay: number;
+    stop: number;
+}
+interface KickPreset {
+    body: KickBody;
+    /** dub 전용 — 깊은 sub tail layer. */
+    sub?: KickBody;
+    click?: KickClick;
+}
+interface SnareTone {
+    type: OscillatorType;
+    startHz: number;
+    /** 있으면 startHz → endHz 피치 envelope. */
+    endHz?: number;
+    pitchTau?: number;
+    /** peak = velocity * level. */
+    level: number;
+    decay: number;
+    stop: number;
+}
+interface SnareNoise {
+    bpHz: number;
+    q: number;
+    /** playbackRate ∈ [prMin, prMax] 무작위. 고정이면 두 값 동일. */
+    prMin: number;
+    prMax: number;
+    level: number;
+    decay: number;
+    stop: number;
+}
+/** Gated reverb tail (wet-room 의 *In the Air Tonight* 결). 자연 감쇠 대신 plateau → cut. */
+interface GatedTail {
+    centerHz: number;
+    q: number;
+    /** peak = velocity * level. */
+    level: number;
+    plateau: number;
+    cut: number;
+}
+interface SnarePreset {
+    tone?: SnareTone;
+    noise?: SnareNoise;
+    gatedTails?: GatedTail[];
+}
+interface HatPreset {
+    hpHz: number;
+    hpQ?: number;
+    /** 있으면 highpass 뒤에 bandpass 한 단(dub hat). */
+    bpHz?: number;
+    bpQ?: number;
+    /** playbackRate = prCenter + (random - 0.5) * prSpread. */
+    prCenter: number;
+    prSpread: number;
+    attack: number;
+    closedDecay: number;
+    openDecay: number;
+    /** peak = velocity * (open ? openLevel : closedLevel). dry/iron/reveal 은 1. */
+    closedLevel: number;
+    openLevel: number;
+    /** stop = when + tail + stopPad. */
+    stopPad: number;
+}
+interface DrumKitPreset {
+    kick: KickPreset;
+    snare?: SnarePreset;
+    hat?: HatPreset;
+}
+interface DrumKitHandle {
+    /** when 에 kick 한 타. */
+    kick(when: number, velocity: number): void;
+    /** when 에 snare 한 타. preset.snare 없으면 no-op. */
+    snare(when: number, velocity: number): void;
+    /** when 에 hat 한 타(open/closed). preset.hat 없으면 no-op. */
+    hat(when: number, velocity: number, open: boolean): void;
+    /** 공유 노드 정리. ephemeral voice 노드는 self-stop + 내부 타임아웃 disconnect. */
+    dispose(): void;
+}
+/**
+ * 드럼킷을 만들어 `bus` 로 voice 를 합성하는 핸들을 돌려준다.
+ *
+ * @param bus 각 타격이 연결될 목적지(트랙의 drumBus·tone·master 등).
+ */
+declare function createDrumKit(ctx: AudioContext, bus: AudioNode, preset: DrumKitPreset): DrumKitHandle;
+
+/**
+ * Drumkit presets — *kit 패치*. 트랙당 하나. 각 트랙 인라인 드럼의 *들리는 상수* 를 그대로
+ * 옮긴 것이라, 거의 같아 보여도(예: batheday 150→45 vs gratis 140→42) 합치지 않는다 —
+ * *소리 보존* 이 기준. dedup 이득은 엔진(`createDrumKit`)이지
+ * preset 수가 아니다.
+ */
+
+/** dry-room — LinnDrum/DR-55 식 dry punch. tail 없는 마른 머신. */
+declare const DRY_KIT: DrumKitPreset;
+/** wet-room — 깊고 긴 sine kick + *gated reverb* snare(In the Air Tonight). */
+declare const WET_KIT: DrumKitPreset;
+/** iron-pulse — 산업 sub 펌프 kick(+click) + 거친 highpass grit(hat). */
+declare const IRON_KIT: DrumKitPreset;
+/** batheday — 블랙게이즈 계열 결의 kick/snare. */
+declare const BATHEDAY_KIT: DrumKitPreset;
+/** sublime-hate — kick/snare 가 batheday 와 완전 동일. */
+declare const SUBLIME_KIT: DrumKitPreset;
+/** reveal-the-truth — IDM 계열의 *snappy* kick(+click) + snare + hat. */
+declare const REVEAL_KIT: DrumKitPreset;
+/** dub-relay — 144 BPM, 2-body sub kick. */
+declare const DUB_RELAY_KIT: DrumKitPreset;
+/** dub-holy — 70 BPM half-time, *더 깊고 긴* sub kick. hat 미사용. */
+declare const DUB_HOLY_KIT: DrumKitPreset;
+/** dub-power — 78 BPM, *권위의 박* kick + hat. */
+declare const DUB_POWER_KIT: DrumKitPreset;
+
+export { BATHEDAY_KIT, DRY_KIT, DUB_HOLY_KIT, DUB_POWER_KIT, DUB_RELAY_KIT, type DrumKitHandle, type DrumKitPreset, type GatedTail, type HatPreset, IRON_KIT, type KickBody, type KickClick, type KickPreset, REVEAL_KIT, SUBLIME_KIT, type SnareNoise, type SnarePreset, type SnareTone, WET_KIT, createDrumKit };