reframe-video 0.6.27 → 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

@@ -17,6 +17,7 @@ var init_ir = __esm({
     SFX_NAMES = [
       "whoosh",
       "swish",
+      "swoosh",
       "rise",
       "riser",
       "warp",
@@ -28,6 +29,7 @@ var init_ir = __esm({
       "thud",
       "boom",
       "knock",
+      "sub",
       "chime",
       "ding",
       "coin",
@@ -35,7 +37,17 @@ var init_ir = __esm({
       "shimmer",
       "success",
       "zap",
-      "error"
+      "error",
+      "glitch",
+      "static",
+      "scan",
+      "powerup",
+      "powerdown",
+      "snare",
+      "hat",
+      "bubble",
+      "notify",
+      "camera"
     ];
     BGM_SYNTHS = ["ambient-pad", "lofi", "pulse", "tension", "uplift"];
     DEFAULT_TO_DURATION = 0.5;
@@ -1473,6 +1485,7 @@ var init_audio = __esm({
       // transition
       whoosh: 0.35,
       swish: 0.32,
+      swoosh: 0.35,
       rise: 0.5,
       riser: 0.85,
       warp: 0.5,
@@ -1486,6 +1499,7 @@ var init_audio = __esm({
       thud: 0.25,
       boom: 0.6,
       knock: 0.14,
+      sub: 0.7,
       // positive
       chime: 0.7,
       ding: 0.5,
@@ -1495,7 +1509,19 @@ var init_audio = __esm({
       success: 0.6,
       // alert
       zap: 0.22,
-      error: 0.4
+      error: 0.4,
+      // tech
+      glitch: 0.3,
+      static: 0.18,
+      scan: 0.45,
+      powerup: 0.4,
+      powerdown: 0.5,
+      // rhythm / foley
+      snare: 0.18,
+      hat: 0.05,
+      bubble: 0.16,
+      notify: 0.45,
+      camera: 0.18
     };
     FILE_CUE_DURATION = 0.4;
   }
@@ -2097,6 +2123,170 @@ function error(_seed, pitch) {
   }
   return out;
 }
+function swoosh(seed, pitch) {
+  const dur2 = 0.35;
+  const { out, n } = buffer(dur2);
+  let lp = 0, lp2 = 0;
+  for (let i = 0; i < n; i++) {
+    const t = i / SAMPLE_RATE, u = t / dur2;
+    const center = 300 * pitch * Math.pow(7.3, u);
+    const alpha = Math.min(1, TAU * center / SAMPLE_RATE);
+    lp += alpha * (noise(i, seed) - lp);
+    lp2 += alpha * 0.5 * (lp - lp2);
+    const env = Math.sin(Math.PI * u) ** 0.9;
+    out[i] = (lp - lp2) * env * 2.4;
+  }
+  return out;
+}
+function glitch(seed, pitch) {
+  const dur2 = 0.3;
+  const { out, n } = buffer(dur2);
+  const cell = Math.round(SAMPLE_RATE * 0.012);
+  let phase = 0;
+  for (let i = 0; i < n; i++) {
+    const t = i / SAMPLE_RATE, u = t / dur2;
+    const c = Math.floor(i / cell);
+    const on = hash01(c, seed) > 0.4 ? 1 : 0;
+    const freq = 400 * pitch * (1 + Math.floor(hash01(c, seed + 1) * 6));
+    phase += TAU * freq / SAMPLE_RATE;
+    const crush = Math.round(square(phase) * 4) / 4;
+    out[i] = (crush * 0.7 + noise(i, seed + c) * 0.3) * on * (1 - u * 0.3) * 0.55;
+  }
+  return out;
+}
+function staticHit(seed, pitch) {
+  const dur2 = 0.18;
+  const { out, n } = buffer(dur2);
+  let lp = 0;
+  const alpha = Math.min(0.8, TAU * 3e3 * pitch / SAMPLE_RATE);
+  for (let i = 0; i < n; i++) {
+    const t = i / SAMPLE_RATE, u = t / dur2;
+    lp += alpha * (noise(i, seed) - lp);
+    const env = Math.min(1, u * 30) * expDecay(t, dur2, 5);
+    out[i] = (noise(i, seed) - lp) * env * 1.4;
+  }
+  return out;
+}
+function scan(seed, pitch) {
+  const dur2 = 0.45;
+  const { out, n } = buffer(dur2);
+  let phase = 0;
+  for (let i = 0; i < n; i++) {
+    const t = i / SAMPLE_RATE, u = t / dur2;
+    const step = Math.floor(u * 6) / 6;
+    const freq = 500 * pitch * Math.pow(3, step);
+    phase += TAU * freq / SAMPLE_RATE;
+    const cell = u * 6 % 1;
+    const env = Math.min(1, cell * 12) * Math.min(1, (1 - cell) * 4) * 0.7;
+    out[i] = square(phase) * env * 0.5;
+  }
+  return out;
+}
+function powerup(seed, pitch) {
+  const dur2 = 0.4;
+  const { out, n } = buffer(dur2);
+  const notes = [392, 523, 659, 784, 1046].map((f) => f * pitch);
+  let phase = 0;
+  for (let i = 0; i < n; i++) {
+    const t = i / SAMPLE_RATE, u = t / dur2;
+    const idx = Math.min(notes.length - 1, Math.floor(u * notes.length));
+    phase += TAU * notes[idx] / SAMPLE_RATE;
+    const local = u * notes.length - idx;
+    const env = Math.min(1, local * 14) * Math.min(1, (1 - Math.min(1, local)) * 4 + 0.3);
+    out[i] = (Math.sin(phase) + 0.25 * Math.sin(2 * phase)) * env * 0.45;
+  }
+  return out;
+}
+function powerdown(seed, pitch) {
+  const dur2 = 0.5;
+  const { out, n } = buffer(dur2);
+  let phase = 0;
+  for (let i = 0; i < n; i++) {
+    const t = i / SAMPLE_RATE, u = t / dur2;
+    const freq = 700 * pitch * Math.pow(0.18, u);
+    phase += TAU * freq / SAMPLE_RATE;
+    const env = (1 - u) ** 0.8;
+    out[i] = (square(phase) * 0.7 + Math.sin(phase) * 0.3) * env * 0.5;
+  }
+  return out;
+}
+function sub(seed, pitch) {
+  const dur2 = 0.7;
+  const { out, n } = buffer(dur2);
+  let phase = 0;
+  for (let i = 0; i < n; i++) {
+    const t = i / SAMPLE_RATE;
+    const freq = 80 * pitch * Math.pow(0.45, t / 0.4);
+    phase += TAU * freq / SAMPLE_RATE;
+    const click2 = t < 4e-3 ? noise(i, seed) * 0.4 : 0;
+    out[i] = (Math.sin(phase) + click2) * expDecay(t, dur2, 3) * 0.95;
+  }
+  return out;
+}
+function snare(seed, pitch) {
+  const dur2 = 0.18;
+  const { out, n } = buffer(dur2);
+  let phase = 0;
+  for (let i = 0; i < n; i++) {
+    const t = i / SAMPLE_RATE;
+    phase += TAU * 180 * pitch / SAMPLE_RATE;
+    const body = Math.sin(phase) * 0.5 * expDecay(t, dur2, 16);
+    const rattle = noise(i, seed) * expDecay(t, dur2, 7);
+    out[i] = (body + rattle * 0.8) * 0.7;
+  }
+  return out;
+}
+function hat(seed, pitch) {
+  const dur2 = 0.05;
+  const { out, n } = buffer(dur2);
+  let lp = 0;
+  const alpha = Math.min(0.85, TAU * 2500 * pitch / SAMPLE_RATE);
+  for (let i = 0; i < n; i++) {
+    const t = i / SAMPLE_RATE;
+    lp += alpha * (noise(i, seed) - lp);
+    out[i] = (noise(i, seed) - lp) * expDecay(t, dur2, 14) * 0.9;
+  }
+  return out;
+}
+function bubble(seed, pitch) {
+  const dur2 = 0.16;
+  const { out, n } = buffer(dur2);
+  let phase = 0;
+  for (let i = 0; i < n; i++) {
+    const t = i / SAMPLE_RATE, u = t / dur2;
+    const freq = 400 * pitch * Math.pow(3, u);
+    phase += TAU * freq / SAMPLE_RATE;
+    const env = Math.sin(Math.PI * u) ** 1.1;
+    out[i] = Math.sin(phase) * env * 0.6;
+  }
+  return out;
+}
+function notify(seed, pitch) {
+  const dur2 = 0.45;
+  const { out, n } = buffer(dur2);
+  const f0 = 880 * pitch;
+  for (let i = 0; i < n; i++) {
+    const t = i / SAMPLE_RATE;
+    const a = Math.sin(TAU * f0 * t) * expDecay(t, dur2, 5);
+    const b = t > 0.09 ? Math.sin(TAU * f0 * 1.5 * t) * expDecay(t - 0.09, dur2, 4.5) : 0;
+    out[i] = (a * 0.55 + b * 0.6) * 0.55;
+  }
+  return out;
+}
+function camera(seed, pitch) {
+  const dur2 = 0.18;
+  const { out, n } = buffer(dur2);
+  let lp = 0;
+  for (let i = 0; i < n; i++) {
+    const t = i / SAMPLE_RATE;
+    lp += 0.45 * (noise(i, seed) - lp);
+    const k1 = t < 0.02 ? expDecay(t, 0.02, 6) : 0;
+    const k2 = t > 0.08 && t < 0.12 ? expDecay(t - 0.08, 0.04, 6) : 0;
+    const sine = Math.sin(TAU * 2200 * pitch * t);
+    out[i] = (lp * 0.7 + sine * 0.3) * (k1 + k2) * 1.3;
+  }
+  return out;
+}
 function synthSfx(name, params = {}) {
   const seed = params.seed ?? 0;
   const pitch = (params.pitch ?? 1) * seedPitch(seed);
@@ -2183,6 +2373,7 @@ var init_synth = __esm({
     RECIPES = {
       whoosh,
       swish,
+      swoosh,
       rise,
       riser,
       warp,
@@ -2194,6 +2385,7 @@ var init_synth = __esm({
       thud,
       boom,
       knock,
+      sub,
       chime,
       ding,
       coin,
@@ -2201,7 +2393,17 @@ var init_synth = __esm({
       shimmer,
       success,
       zap,
-      error
+      error,
+      glitch,
+      static: staticHit,
+      scan,
+      powerup,
+      powerdown,
+      snare,
+      hat,
+      bubble,
+      notify,
+      camera
     };
     BGM_RECIPES = {
       "ambient-pad": synthAmbientPad,
@@ -2250,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

@@ -9,6 +9,7 @@ import { basename, dirname as dirname7, join as join9, resolve as resolve6 } fro
 var SFX_NAMES = [
   "whoosh",
   "swish",
+  "swoosh",
   "rise",
   "riser",
   "warp",
@@ -20,6 +21,7 @@ var SFX_NAMES = [
   "thud",
   "boom",
   "knock",
+  "sub",
   "chime",
   "ding",
   "coin",
@@ -27,7 +29,17 @@ var SFX_NAMES = [
   "shimmer",
   "success",
   "zap",
-  "error"
+  "error",
+  "glitch",
+  "static",
+  "scan",
+  "powerup",
+  "powerdown",
+  "snare",
+  "hat",
+  "bubble",
+  "notify",
+  "camera"
 ];
 var BGM_SYNTHS = ["ambient-pad", "lofi", "pulse", "tension", "uplift"];
 var DEFAULT_CROSSFADE = 0.5;
@@ -1021,6 +1033,7 @@ var SFX_DURATION = {
   // transition
   whoosh: 0.35,
   swish: 0.32,
+  swoosh: 0.35,
   rise: 0.5,
   riser: 0.85,
   warp: 0.5,
@@ -1034,6 +1047,7 @@ var SFX_DURATION = {
   thud: 0.25,
   boom: 0.6,
   knock: 0.14,
+  sub: 0.7,
   // positive
   chime: 0.7,
   ding: 0.5,
@@ -1043,7 +1057,19 @@ var SFX_DURATION = {
   success: 0.6,
   // alert
   zap: 0.22,
-  error: 0.4
+  error: 0.4,
+  // tech
+  glitch: 0.3,
+  static: 0.18,
+  scan: 0.45,
+  powerup: 0.4,
+  powerdown: 0.5,
+  // rhythm / foley
+  snare: 0.18,
+  hat: 0.05,
+  bubble: 0.16,
+  notify: 0.45,
+  camera: 0.18
 };
 var FILE_CUE_DURATION = 0.4;
 function collectClipAudio(ir, duration, warnings) {
@@ -1603,9 +1629,174 @@ function error(_seed, pitch) {
   }
   return out;
 }
+function swoosh(seed, pitch) {
+  const dur = 0.35;
+  const { out, n } = buffer(dur);
+  let lp = 0, lp2 = 0;
+  for (let i = 0; i < n; i++) {
+    const t = i / SAMPLE_RATE, u = t / dur;
+    const center = 300 * pitch * Math.pow(7.3, u);
+    const alpha = Math.min(1, TAU * center / SAMPLE_RATE);
+    lp += alpha * (noise(i, seed) - lp);
+    lp2 += alpha * 0.5 * (lp - lp2);
+    const env = Math.sin(Math.PI * u) ** 0.9;
+    out[i] = (lp - lp2) * env * 2.4;
+  }
+  return out;
+}
+function glitch(seed, pitch) {
+  const dur = 0.3;
+  const { out, n } = buffer(dur);
+  const cell = Math.round(SAMPLE_RATE * 0.012);
+  let phase = 0;
+  for (let i = 0; i < n; i++) {
+    const t = i / SAMPLE_RATE, u = t / dur;
+    const c = Math.floor(i / cell);
+    const on = hash01(c, seed) > 0.4 ? 1 : 0;
+    const freq = 400 * pitch * (1 + Math.floor(hash01(c, seed + 1) * 6));
+    phase += TAU * freq / SAMPLE_RATE;
+    const crush = Math.round(square(phase) * 4) / 4;
+    out[i] = (crush * 0.7 + noise(i, seed + c) * 0.3) * on * (1 - u * 0.3) * 0.55;
+  }
+  return out;
+}
+function staticHit(seed, pitch) {
+  const dur = 0.18;
+  const { out, n } = buffer(dur);
+  let lp = 0;
+  const alpha = Math.min(0.8, TAU * 3e3 * pitch / SAMPLE_RATE);
+  for (let i = 0; i < n; i++) {
+    const t = i / SAMPLE_RATE, u = t / dur;
+    lp += alpha * (noise(i, seed) - lp);
+    const env = Math.min(1, u * 30) * expDecay(t, dur, 5);
+    out[i] = (noise(i, seed) - lp) * env * 1.4;
+  }
+  return out;
+}
+function scan(seed, pitch) {
+  const dur = 0.45;
+  const { out, n } = buffer(dur);
+  let phase = 0;
+  for (let i = 0; i < n; i++) {
+    const t = i / SAMPLE_RATE, u = t / dur;
+    const step = Math.floor(u * 6) / 6;
+    const freq = 500 * pitch * Math.pow(3, step);
+    phase += TAU * freq / SAMPLE_RATE;
+    const cell = u * 6 % 1;
+    const env = Math.min(1, cell * 12) * Math.min(1, (1 - cell) * 4) * 0.7;
+    out[i] = square(phase) * env * 0.5;
+  }
+  return out;
+}
+function powerup(seed, pitch) {
+  const dur = 0.4;
+  const { out, n } = buffer(dur);
+  const notes = [392, 523, 659, 784, 1046].map((f) => f * pitch);
+  let phase = 0;
+  for (let i = 0; i < n; i++) {
+    const t = i / SAMPLE_RATE, u = t / dur;
+    const idx = Math.min(notes.length - 1, Math.floor(u * notes.length));
+    phase += TAU * notes[idx] / SAMPLE_RATE;
+    const local = u * notes.length - idx;
+    const env = Math.min(1, local * 14) * Math.min(1, (1 - Math.min(1, local)) * 4 + 0.3);
+    out[i] = (Math.sin(phase) + 0.25 * Math.sin(2 * phase)) * env * 0.45;
+  }
+  return out;
+}
+function powerdown(seed, pitch) {
+  const dur = 0.5;
+  const { out, n } = buffer(dur);
+  let phase = 0;
+  for (let i = 0; i < n; i++) {
+    const t = i / SAMPLE_RATE, u = t / dur;
+    const freq = 700 * pitch * Math.pow(0.18, u);
+    phase += TAU * freq / SAMPLE_RATE;
+    const env = (1 - u) ** 0.8;
+    out[i] = (square(phase) * 0.7 + Math.sin(phase) * 0.3) * env * 0.5;
+  }
+  return out;
+}
+function sub(seed, pitch) {
+  const dur = 0.7;
+  const { out, n } = buffer(dur);
+  let phase = 0;
+  for (let i = 0; i < n; i++) {
+    const t = i / SAMPLE_RATE;
+    const freq = 80 * pitch * Math.pow(0.45, t / 0.4);
+    phase += TAU * freq / SAMPLE_RATE;
+    const click2 = t < 4e-3 ? noise(i, seed) * 0.4 : 0;
+    out[i] = (Math.sin(phase) + click2) * expDecay(t, dur, 3) * 0.95;
+  }
+  return out;
+}
+function snare(seed, pitch) {
+  const dur = 0.18;
+  const { out, n } = buffer(dur);
+  let phase = 0;
+  for (let i = 0; i < n; i++) {
+    const t = i / SAMPLE_RATE;
+    phase += TAU * 180 * pitch / SAMPLE_RATE;
+    const body = Math.sin(phase) * 0.5 * expDecay(t, dur, 16);
+    const rattle = noise(i, seed) * expDecay(t, dur, 7);
+    out[i] = (body + rattle * 0.8) * 0.7;
+  }
+  return out;
+}
+function hat(seed, pitch) {
+  const dur = 0.05;
+  const { out, n } = buffer(dur);
+  let lp = 0;
+  const alpha = Math.min(0.85, TAU * 2500 * pitch / SAMPLE_RATE);
+  for (let i = 0; i < n; i++) {
+    const t = i / SAMPLE_RATE;
+    lp += alpha * (noise(i, seed) - lp);
+    out[i] = (noise(i, seed) - lp) * expDecay(t, dur, 14) * 0.9;
+  }
+  return out;
+}
+function bubble(seed, pitch) {
+  const dur = 0.16;
+  const { out, n } = buffer(dur);
+  let phase = 0;
+  for (let i = 0; i < n; i++) {
+    const t = i / SAMPLE_RATE, u = t / dur;
+    const freq = 400 * pitch * Math.pow(3, u);
+    phase += TAU * freq / SAMPLE_RATE;
+    const env = Math.sin(Math.PI * u) ** 1.1;
+    out[i] = Math.sin(phase) * env * 0.6;
+  }
+  return out;
+}
+function notify(seed, pitch) {
+  const dur = 0.45;
+  const { out, n } = buffer(dur);
+  const f0 = 880 * pitch;
+  for (let i = 0; i < n; i++) {
+    const t = i / SAMPLE_RATE;
+    const a = Math.sin(TAU * f0 * t) * expDecay(t, dur, 5);
+    const b = t > 0.09 ? Math.sin(TAU * f0 * 1.5 * t) * expDecay(t - 0.09, dur, 4.5) : 0;
+    out[i] = (a * 0.55 + b * 0.6) * 0.55;
+  }
+  return out;
+}
+function camera(seed, pitch) {
+  const dur = 0.18;
+  const { out, n } = buffer(dur);
+  let lp = 0;
+  for (let i = 0; i < n; i++) {
+    const t = i / SAMPLE_RATE;
+    lp += 0.45 * (noise(i, seed) - lp);
+    const k1 = t < 0.02 ? expDecay(t, 0.02, 6) : 0;
+    const k2 = t > 0.08 && t < 0.12 ? expDecay(t - 0.08, 0.04, 6) : 0;
+    const sine = Math.sin(TAU * 2200 * pitch * t);
+    out[i] = (lp * 0.7 + sine * 0.3) * (k1 + k2) * 1.3;
+  }
+  return out;
+}
 var RECIPES = {
   whoosh,
   swish,
+  swoosh,
   rise,
   riser,
   warp,
@@ -1617,6 +1808,7 @@ var RECIPES = {
   thud,
   boom,
   knock,
+  sub,
   chime,
   ding,
   coin,
@@ -1624,7 +1816,17 @@ var RECIPES = {
   shimmer,
   success,
   zap,
-  error
+  error,
+  glitch,
+  static: staticHit,
+  scan,
+  powerup,
+  powerdown,
+  snare,
+  hat,
+  bubble,
+  notify,
+  camera
 };
 function synthSfx(name, params = {}) {
   const seed = params.seed ?? 0;
@@ -1742,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/dist/compile-api.js

@@ -8,6 +8,7 @@ import { fileURLToPath } from "node:url";
 var SFX_NAMES = [
   "whoosh",
   "swish",
+  "swoosh",
   "rise",
   "riser",
   "warp",
@@ -19,6 +20,7 @@ var SFX_NAMES = [
   "thud",
   "boom",
   "knock",
+  "sub",
   "chime",
   "ding",
   "coin",
@@ -26,7 +28,17 @@ var SFX_NAMES = [
   "shimmer",
   "success",
   "zap",
-  "error"
+  "error",
+  "glitch",
+  "static",
+  "scan",
+  "powerup",
+  "powerdown",
+  "snare",
+  "hat",
+  "bubble",
+  "notify",
+  "camera"
 ];
 var BGM_SYNTHS = ["ambient-pad", "lofi", "pulse", "tension", "uplift"];
 

package/dist/compile.js

@@ -13,6 +13,7 @@ import { fileURLToPath } from "node:url";
 var SFX_NAMES = [
   "whoosh",
   "swish",
+  "swoosh",
   "rise",
   "riser",
   "warp",
@@ -24,6 +25,7 @@ var SFX_NAMES = [
   "thud",
   "boom",
   "knock",
+  "sub",
   "chime",
   "ding",
   "coin",
@@ -31,7 +33,17 @@ var SFX_NAMES = [
   "shimmer",
   "success",
   "zap",
-  "error"
+  "error",
+  "glitch",
+  "static",
+  "scan",
+  "powerup",
+  "powerdown",
+  "snare",
+  "hat",
+  "bubble",
+  "notify",
+  "camera"
 ];
 var BGM_SYNTHS = ["ambient-pad", "lofi", "pulse", "tension", "uplift"];
 

package/dist/diff.js

@@ -16,6 +16,7 @@ import { fileURLToPath } from "node:url";
 var SFX_NAMES = [
   "whoosh",
   "swish",
+  "swoosh",
   "rise",
   "riser",
   "warp",
@@ -27,6 +28,7 @@ var SFX_NAMES = [
   "thud",
   "boom",
   "knock",
+  "sub",
   "chime",
   "ding",
   "coin",
@@ -34,7 +36,17 @@ var SFX_NAMES = [
   "shimmer",
   "success",
   "zap",
-  "error"
+  "error",
+  "glitch",
+  "static",
+  "scan",
+  "powerup",
+  "powerdown",
+  "snare",
+  "hat",
+  "bubble",
+  "notify",
+  "camera"
 ];
 var BGM_SYNTHS = ["ambient-pad", "lofi", "pulse", "tension", "uplift"];
 var DEFAULT_TO_DURATION = 0.5;

package/dist/frame.js

@@ -43,6 +43,7 @@ import { extname, isAbsolute, resolve } from "node:path";
 var SFX_NAMES = [
   "whoosh",
   "swish",
+  "swoosh",
   "rise",
   "riser",
   "warp",
@@ -54,6 +55,7 @@ var SFX_NAMES = [
   "thud",
   "boom",
   "knock",
+  "sub",
   "chime",
   "ding",
   "coin",
@@ -61,7 +63,17 @@ var SFX_NAMES = [
   "shimmer",
   "success",
   "zap",
-  "error"
+  "error",
+  "glitch",
+  "static",
+  "scan",
+  "powerup",
+  "powerdown",
+  "snare",
+  "hat",
+  "bubble",
+  "notify",
+  "camera"
 ];
 var BGM_SYNTHS = ["ambient-pad", "lofi", "pulse", "tension", "uplift"];
 var DEFAULT_TO_DURATION = 0.5;

package/dist/index.js

@@ -2,6 +2,7 @@
 var SFX_NAMES = [
   "whoosh",
   "swish",
+  "swoosh",
   "rise",
   "riser",
   "warp",
@@ -13,6 +14,7 @@ var SFX_NAMES = [
   "thud",
   "boom",
   "knock",
+  "sub",
   "chime",
   "ding",
   "coin",
@@ -20,7 +22,17 @@ var SFX_NAMES = [
   "shimmer",
   "success",
   "zap",
-  "error"
+  "error",
+  "glitch",
+  "static",
+  "scan",
+  "powerup",
+  "powerdown",
+  "snare",
+  "hat",
+  "bubble",
+  "notify",
+  "camera"
 ];
 var BGM_SYNTHS = ["ambient-pad", "lofi", "pulse", "tension", "uplift"];
 var DEFAULT_CROSSFADE = 0.5;
@@ -2919,6 +2931,7 @@ var SFX_DURATION = {
   // transition
   whoosh: 0.35,
   swish: 0.32,
+  swoosh: 0.35,
   rise: 0.5,
   riser: 0.85,
   warp: 0.5,
@@ -2932,6 +2945,7 @@ var SFX_DURATION = {
   thud: 0.25,
   boom: 0.6,
   knock: 0.14,
+  sub: 0.7,
   // positive
   chime: 0.7,
   ding: 0.5,
@@ -2941,7 +2955,19 @@ var SFX_DURATION = {
   success: 0.6,
   // alert
   zap: 0.22,
-  error: 0.4
+  error: 0.4,
+  // tech
+  glitch: 0.3,
+  static: 0.18,
+  scan: 0.45,
+  powerup: 0.4,
+  powerdown: 0.5,
+  // rhythm / foley
+  snare: 0.18,
+  hat: 0.05,
+  bubble: 0.16,
+  notify: 0.45,
+  camera: 0.18
 };
 var FILE_CUE_DURATION = 0.4;
 function collectClipAudio(ir, duration, warnings) {

package/dist/labels.js

@@ -4,6 +4,7 @@
 var SFX_NAMES = [
   "whoosh",
   "swish",
+  "swoosh",
   "rise",
   "riser",
   "warp",
@@ -15,6 +16,7 @@ var SFX_NAMES = [
   "thud",
   "boom",
   "knock",
+  "sub",
   "chime",
   "ding",
   "coin",
@@ -22,7 +24,17 @@ var SFX_NAMES = [
   "shimmer",
   "success",
   "zap",
-  "error"
+  "error",
+  "glitch",
+  "static",
+  "scan",
+  "powerup",
+  "powerdown",
+  "snare",
+  "hat",
+  "bubble",
+  "notify",
+  "camera"
 ];
 var BGM_SYNTHS = ["ambient-pad", "lofi", "pulse", "tension", "uplift"];
 var DEFAULT_TO_DURATION = 0.5;

package/dist/types/ir.d.ts

@@ -415,13 +415,14 @@ export interface BehaviorIR {
 /**
  * The procedural sfx palette — the single source of truth (the type, validation,
  * and the render-cli synth recipes all key off this). Grouped by use:
- *   transition: whoosh swish rise riser warp   · ui: tick click blip pop select
- *   impact: thud boom knock   · positive: chime ding coin sparkle shimmer success
- *   alert: zap error
+ *   transition: whoosh swish swoosh rise riser warp   · ui: tick click blip pop select
+ *   impact: thud boom knock sub   · positive: chime ding coin sparkle shimmer success
+ *   alert: zap error   · tech: glitch static scan powerup powerdown
+ *   rhythm: snare hat   · foley: bubble notify camera
  * Every cue's pitch/texture varies with its `seed` (auto-seeded by cue order), so
  * repeated cues sound different; `params.pitch` is an explicit multiplier.
  */
-export declare const SFX_NAMES: readonly ["whoosh", "swish", "rise", "riser", "warp", "tick", "click", "blip", "pop", "select", "thud", "boom", "knock", "chime", "ding", "coin", "sparkle", "shimmer", "success", "zap", "error"];
+export declare const SFX_NAMES: readonly ["whoosh", "swish", "swoosh", "rise", "riser", "warp", "tick", "click", "blip", "pop", "select", "thud", "boom", "knock", "sub", "chime", "ding", "coin", "sparkle", "shimmer", "success", "zap", "error", "glitch", "static", "scan", "powerup", "powerdown", "snare", "hat", "bubble", "notify", "camera"];
 export type SfxName = (typeof SFX_NAMES)[number];
 /** Synthesized background-music beds (license-free). */
 export declare const BGM_SYNTHS: readonly ["ambient-pad", "lofi", "pulse", "tension", "uplift"];

package/guides/edsl-guide.md

@@ -562,11 +562,14 @@ audio: {
 
 | group | names |
 | --- | --- |
-| transition | `whoosh` `swish` `rise` `riser` `warp` |
+| transition | `whoosh` `swish` `swoosh` `rise` `riser` `warp` |
 | ui | `tick` `click` `blip` `pop` `select` |
-| impact | `thud` `boom` `knock` |
+| impact | `thud` `boom` `knock` `sub` |
 | positive | `chime` `ding` `coin` `sparkle` `shimmer` `success` |
 | alert | `zap` `error` |
+| tech | `glitch` `static` `scan` `powerup` `powerdown` |
+| rhythm | `snare` `hat` |
+| foley | `bubble` `notify` `camera` |
 
 **Variation — repeats don't sound the same.** Each cue's `seed` shifts the sound's
 PITCH (a musical step) and texture, and it **defaults to the cue's order**, so a run of
@@ -578,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.27",
+  "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",