pycodedj 0.2.0__tar.gz → 0.3.0__tar.gz

{pycodedj-0.2.0 → pycodedj-0.3.0}/CHANGELOG.md

@@ -1,5 +1,35 @@
 # Changelog
 
+## [0.3.0] - 2026-05-08
+
+### Features
+
+- `pycodedj panic` — 全アクティブループを即時停止。SuperCollider 側でシンセを解放し `~loops` / `~loopParams` を初期化する
+- `pycodedj mute <name>` — ループを消音（停止しない）。再評価時もミュート状態を維持
+- `pycodedj unmute <name>` — ミュート解除、音量を復元
+- `pycodedj solo <name>` — 対象ループ以外を全ミュート（CLI は OSC 直送、完全な状態管理は watch セッション内の `Engine.solo()` 推奨）
+- `pycodedj unsolo` — ソロ解除、solo 前のミュート状態に戻す
+- `pycodedj status` — アクティブループの名前・ミュート状態・音量・カットオフを表示
+
+### Improvements
+
+- `ParseResult` dataclass 導入 — `parse_blocks()` が SyntaxError 時に `ParseResult(ok=False, error=...)` を返すようになり、watch モードでコード編集中に構文エラーがあっても演奏中のループが止まらなくなった
+- `Engine` 内部状態を `LoopState` dataclass で管理 — `muted` / `muted_before_solo` フラグを保持し、mute/solo/unsolo の状態を正確に追跡
+- `eval_block` が OSC 送信成功後に内部状態を更新するよう修正（送信失敗時の状態不整合を解消）
+- `Engine.solo()` に未知のループ名ガードを追加（存在しない名前を渡しても全ループがミュートされない）
+- CLI `unmute` が SuperCollider に永続化された `amp=0` を上書きしてから voice_count を送るよう修正
+
+### Docs
+
+- README.md / README.ja.md — panic / mute / unmute / status のクイックリファレンスを追加、ロードマップの Sprint 1 を完了に更新
+- `docs/manual.md` / `docs/manual.ja.md` / `docs/manual.html` — セクション 12 に新コマンド 6 つの全リファレンスを追加
+
+## [0.2.1] - 2026-05-08
+
+### Docs
+
+- `docs/manual.html` — Python シンタックスハイライターのプレースホルダー衝突バグを修正。`PY_NUMBER` がプレースホルダーのインデックス数字にマッチしてコメント・文字列が正しく表示されない問題を解消
+
 ## [0.2.0] - 2026-05-08
 
 ### Breaking

{pycodedj-0.2.0 → pycodedj-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pycodedj
-Version: 0.2.0
+Version: 0.3.0
 License: MIT License with Commons Clause
         
         "Commons Clause" License Condition v1.0
@@ -108,6 +108,7 @@ BPM clock is held by SuperCollider's `TempoClock`. Python only sends parameter u
 | Function definition count | Polyphony voice count (1–4) | Functions = independent voices |
 | Comment ratio | Reverb depth (0.0–0.8) | More whitespace = more space |
 | `volume=` argument | Amplitude (0.0–1.0) | Direct performer control over loudness |
+| `eq=` / `low=` / `mid=` / `high=` arguments | Simple 3-band EQ | Per-loop tone shaping |
 
 Tempo (BPM) and root pitch are controlled explicitly by the performer, to prevent the foundation of the piece from shifting on every save.
 
@@ -190,6 +191,33 @@ pycodedj watch demo.py
 
 From here, just write code and save.
 
+**5. Emergency stop**
+
+```bash
+pycodedj panic
+```
+
+Sends a stop signal to all active loops immediately. Use this if something goes wrong during a performance.
+
+**6. Mute / solo**
+
+```bash
+pycodedj mute bass        # silence a loop without stopping it
+pycodedj unmute bass      # restore its sound
+pycodedj solo pad         # mute all loops except pad
+pycodedj unsolo           # release solo, restore previous mute state
+```
+
+Note: `mute`, `unmute`, `solo`, and `unsolo` send OSC directly to SuperCollider. For full state management, call `Engine.mute()` / `Engine.solo()` from within a watch session.
+
+**7. Loop status**
+
+```bash
+pycodedj status
+```
+
+Prints the name, mute state, amplitude, and filter cutoff of each active loop.
+
 ---
 
 ## Example Files
@@ -197,7 +225,8 @@ From here, just write code and save.
 | File | Contents |
 | :--- | :--- |
 | `examples/demo.py` | Intro demo with bass / melody / pad |
-| `examples/club_set.py` | Layered club groove using kick_hard / bass_rumble / bass_reese and more |
+| `examples/club_set.py` | EDM groove (8 loops, kick → acid bass → rave stabs → hoover → shimmer) |
+| `examples/sound_showcase.py` | All 30 synths — evaluate one at a time to audition each sound |
 
 ---
 
@@ -273,11 +302,12 @@ External visualisers such as Hydra can receive the same parameters on a separate
 
 ## Roadmap
 
-- [x] Spec design and mapping design
-- [ ] Phase 0: Listening validation of mapping hypotheses
-- [x] Phase 1: Python → SuperCollider OSC prototype
-- [x] Phase 2: Hot-reload live loop implementation (`pycodedj watch`)
-- [ ] Phase 3: Hydra visualiser integration
+- [x] Python → SuperCollider OSC prototype
+- [x] Hot-reload live loop implementation (`pycodedj watch`)
+- [x] Sprint 1: Live stability (`panic`, SyntaxError recovery, `mute`/`solo`, `status`)
+- [ ] Sprint 2: Music DSL (`pattern()`, `sample()`, `@loop` parameter expansion, mapping modes)
+- [ ] Sprint 3: Sound design and playability (SynthDef cleanup, `bpm`, `list-synths`)
+- [ ] Sprint 4: README and manual refresh, Hydra visualiser integration
 
 ---
 

{pycodedj-0.2.0 → pycodedj-0.3.0}/README.ja.md

@@ -46,6 +46,7 @@ BPMクロックは SuperCollider 側の `TempoClock` が保持します。Python
 | 関数定義数 | ポリフォニー声部数 (1–4) | 関数＝独立した声部 |
 | コメント率 | リバーブ Depth (0.0–0.8) | 余白の多さ＝空間の広さ |
 | `volume=` 引数 | Amplitude (0.0–1.0) | 演奏者が直接音量を制御する |
+| `eq=` / `low=` / `mid=` / `high=` 引数 | 簡易 3 バンド EQ | ループごとの音質補正 |
 
 テンポ（BPM）と基音（Pitch）は演奏者が明示的に制御します。保存のたびに楽曲全体の土台が変わることを防ぐためです。
 
@@ -128,6 +129,33 @@ pycodedj watch demo.py
 
 あとはエディタでコードを書いて保存するだけです。
 
+**5. 緊急停止**
+
+```bash
+pycodedj panic
+```
+
+全アクティブループに停止信号を即時送信します。演奏中に問題が起きたときに使います。
+
+**6. ミュート / ソロ**
+
+```bash
+pycodedj mute bass        # ループを消音（停止はしない）
+pycodedj unmute bass      # 音量を元に戻す
+pycodedj solo pad         # pad 以外を全ミュート
+pycodedj unsolo           # ソロ解除、ミュート状態を元に戻す
+```
+
+注意: `mute` / `unmute` / `solo` / `unsolo` は OSC を直接 SuperCollider に送信します。完全な状態管理が必要な場合は watch セッション内で `Engine.mute()` / `Engine.solo()` を呼び出してください。
+
+**7. ループのステータス確認**
+
+```bash
+pycodedj status
+```
+
+アクティブなループの名前・ミュート状態・音量・フィルターカットオフを表示します。
+
 ---
 
 ## サンプルファイル
@@ -135,7 +163,8 @@ pycodedj watch demo.py
 | ファイル | 内容 |
 | :--- | :--- |
 | `examples/demo.py` | bass / melody / pad の 3 ループ入門デモ |
-| `examples/club_set.py` | kick_hard / bass_rumble / bass_reese などを重ねた多層クラブグルーヴ |
+| `examples/club_set.py` | EDM クラブグルーヴ（8 ループ、キック → アシッドベース → レイブスタブ → Hoover → シマー） |
+| `examples/sound_showcase.py` | 全 30 音色を収録 — 1 音ずつ eval して確認できる |
 
 ---
 
@@ -211,11 +240,12 @@ Hydra 等の外部ビジュアライザーへは同じパラメーターを別
 
 ## ロードマップ
 
-- [x] 仕様設計・マッピング設計
-- [ ] フェーズ0: マッピング仮説の聴取検証
-- [x] フェーズ1: Python → SuperCollider OSC プロトタイプ
-- [x] フェーズ2: ホットリロード・ライブループ実装（`pycodedj watch`）
-- [ ] フェーズ3: Hydra ビジュアライザー統合
+- [x] Python → SuperCollider OSC プロトタイプ
+- [x] ホットリロード・ライブループ実装（`pycodedj watch`）
+- [x] Sprint 1: ライブ安定性（`panic`, SyntaxError維持, `mute`/`solo`, `status`）
+- [ ] Sprint 2: 音楽DSL（`pattern()`, `sample()`, `@loop` パラメータ拡張, mapping モード）
+- [ ] Sprint 3: 音色・演奏性（SynthDef整理, `bpm`, `list-synths`）
+- [ ] Sprint 4: README・マニュアル刷新、Hydra ビジュアライザー統合
 
 ---
 

{pycodedj-0.2.0 → pycodedj-0.3.0}/README.md

@@ -46,6 +46,7 @@ BPM clock is held by SuperCollider's `TempoClock`. Python only sends parameter u
 | Function definition count | Polyphony voice count (1–4) | Functions = independent voices |
 | Comment ratio | Reverb depth (0.0–0.8) | More whitespace = more space |
 | `volume=` argument | Amplitude (0.0–1.0) | Direct performer control over loudness |
+| `eq=` / `low=` / `mid=` / `high=` arguments | Simple 3-band EQ | Per-loop tone shaping |
 
 Tempo (BPM) and root pitch are controlled explicitly by the performer, to prevent the foundation of the piece from shifting on every save.
 
@@ -128,6 +129,33 @@ pycodedj watch demo.py
 
 From here, just write code and save.
 
+**5. Emergency stop**
+
+```bash
+pycodedj panic
+```
+
+Sends a stop signal to all active loops immediately. Use this if something goes wrong during a performance.
+
+**6. Mute / solo**
+
+```bash
+pycodedj mute bass        # silence a loop without stopping it
+pycodedj unmute bass      # restore its sound
+pycodedj solo pad         # mute all loops except pad
+pycodedj unsolo           # release solo, restore previous mute state
+```
+
+Note: `mute`, `unmute`, `solo`, and `unsolo` send OSC directly to SuperCollider. For full state management, call `Engine.mute()` / `Engine.solo()` from within a watch session.
+
+**7. Loop status**
+
+```bash
+pycodedj status
+```
+
+Prints the name, mute state, amplitude, and filter cutoff of each active loop.
+
 ---
 
 ## Example Files
@@ -135,7 +163,8 @@ From here, just write code and save.
 | File | Contents |
 | :--- | :--- |
 | `examples/demo.py` | Intro demo with bass / melody / pad |
-| `examples/club_set.py` | Layered club groove using kick_hard / bass_rumble / bass_reese and more |
+| `examples/club_set.py` | EDM groove (8 loops, kick → acid bass → rave stabs → hoover → shimmer) |
+| `examples/sound_showcase.py` | All 30 synths — evaluate one at a time to audition each sound |
 
 ---
 
@@ -211,11 +240,12 @@ External visualisers such as Hydra can receive the same parameters on a separate
 
 ## Roadmap
 
-- [x] Spec design and mapping design
-- [ ] Phase 0: Listening validation of mapping hypotheses
-- [x] Phase 1: Python → SuperCollider OSC prototype
-- [x] Phase 2: Hot-reload live loop implementation (`pycodedj watch`)
-- [ ] Phase 3: Hydra visualiser integration
+- [x] Python → SuperCollider OSC prototype
+- [x] Hot-reload live loop implementation (`pycodedj watch`)
+- [x] Sprint 1: Live stability (`panic`, SyntaxError recovery, `mute`/`solo`, `status`)
+- [ ] Sprint 2: Music DSL (`pattern()`, `sample()`, `@loop` parameter expansion, mapping modes)
+- [ ] Sprint 3: Sound design and playability (SynthDef cleanup, `bpm`, `list-synths`)
+- [ ] Sprint 4: README and manual refresh, Hydra visualiser integration
 
 ---