reframe-video 0.6.28 → 0.6.29

package/assets/sfx/LICENSE.md

@@ -14,5 +14,7 @@ Verified against each asset page's license field on 2026-06-11.
 | bgm-song21.mp3 | [Mysterious Ambience (song21)](https://opengameart.org/content/mysterious-ambience-song21) | cynicmusic (pixelsphere.org) | multi-licensed; used under its CC0 option |
 
 CC0 requires no attribution; this file records provenance anyway.
-Files placed here named after a procedural SFX (e.g. `whoosh.wav`) override
-the synthesizer for that name.
+These files are loaded only by an explicit `file:` cue (e.g.
+`{ sfx: undefined, file: "whoosh.wav" }`). A bare `sfx:` name always uses the
+procedural synthesizer (so its pitch/auto-variation applies) — it is no longer
+auto-overridden by a same-named `.wav` here.

package/dist/bin.js

@@ -2452,8 +2452,6 @@ async function resolveCueFile(cue, sceneDir) {
       `audio cue file "${p}" not found (tried absolute, scene-relative, assets/sfx/)`
     );
   }
-  const vendored = join(VENDORED, `${cue.source.name}.wav`);
-  if (existsSync2(vendored)) return vendored;
   const { name, params } = cue.source;
   return writeCached(`${name}-${fnv1a(JSON.stringify(params))}`, () => synthSfx(name, params));
 }

package/dist/cli.js

@@ -1944,8 +1944,6 @@ async function resolveCueFile(cue, sceneDir) {
       `audio cue file "${p}" not found (tried absolute, scene-relative, assets/sfx/)`
     );
   }
-  const vendored = join(VENDORED, `${cue.source.name}.wav`);
-  if (existsSync(vendored)) return vendored;
   const { name, params } = cue.source;
   return writeCached(`${name}-${fnv1a(JSON.stringify(params))}`, () => synthSfx(name, params));
 }

package/guides/edsl-guide.md

@@ -581,8 +581,14 @@ up). `params.gainDb` trims a single hit.
 **bgm beds** (`bgm.synth`): `ambient-pad` `lofi` `pulse` `tension` `uplift` — or
 `bgm.file` for your own. **Mixing**: any cue takes `fadeIn`/`fadeOut` (seconds) and `pan`
 (-1 left … 0 centre … +1 right). A `video` clip's audio takes `fadeIn` and `pan` too
-(clip fade-out isn't supported yet). The bed auto-ducks under cues (`bgm.duck`). See
-`examples/scenes/sfx-showcase.ts` to audition the whole palette.
+(clip fade-out isn't supported yet). The bed auto-ducks under cues (`bgm.duck`).
+
+**Recorded samples** are a separate layer from the synth palette: use a `file:` cue to
+play a CC0 file from `assets/sfx/` — keyboard typing (`keypress-*.wav`, also driven by
+`textTypeCues`), `footstep_*`, and the Kenney UI pack (`click_*`/`confirmation_*`/
+`select_*`/…). A bare `sfx:` name always synthesizes (so it pitch-varies); pass
+`file: "whoosh.wav"` to play the recorded version instead. Audition the procedural set
+with `examples/scenes/sfx-showcase.ts` and the samples with `sample-showcase.ts`.
 
 ## Rules
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "reframe-video",
-  "version": "0.6.28",
+  "version": "0.6.29",
   "description": "Declarative motion graphics that AI can write and humans can tweak — human edits survive AI regeneration. Deterministic mp4 renders from a plain-data scene format.",
   "keywords": [
     "motion-graphics",