diff --git a/scripts/generate-media-use-audio-carve.mjs b/scripts/generate-media-use-audio-carve.mjs index 98bf3d23c1..4916284364 100644 --- a/scripts/generate-media-use-audio-carve.mjs +++ b/scripts/generate-media-use-audio-carve.mjs @@ -16,6 +16,7 @@ const { build } = await import(resolve(here, "../packages/core/node_modules/esbu const ENTRY = `export { analyseCarveBands, analyseCarveDuck, + analyseCarveDynamics, carveBandsToChain, carveProfile, classifyAudioName, diff --git a/skills-manifest.json b/skills-manifest.json index ec5fe0845b..0b1a52c0a1 100644 --- a/skills-manifest.json +++ b/skills-manifest.json @@ -18,7 +18,7 @@ "files": 13 }, "media-use": { - "hash": "bffe3f288782b86a", + "hash": "fa655ce936dab4a5", "files": 128 }, "remotion-to-hyperframes": { diff --git a/skills/media-use/audio/scripts/carve.test.mjs b/skills/media-use/audio/scripts/carve.test.mjs index 338d1f1928..9f99426b02 100644 --- a/skills/media-use/audio/scripts/carve.test.mjs +++ b/skills/media-use/audio/scripts/carve.test.mjs @@ -1,7 +1,15 @@ import assert from "node:assert/strict"; import test from "node:test"; import { execFileSync } from "node:child_process"; -import { existsSync, mkdirSync, mkdtempSync, rmSync, symlinkSync, writeFileSync } from "node:fs"; +import { + existsSync, + mkdirSync, + mkdtempSync, + readFileSync, + rmSync, + symlinkSync, + writeFileSync, +} from "node:fs"; import { tmpdir } from "node:os"; import { dirname, join } from "node:path"; import { fileURLToPath } from "node:url"; @@ -241,6 +249,17 @@ test("carve never loads @hyperframes/core from the composition's project", () => }); }); +test("the bundled core exports every function carve.mjs calls", async () => { + const source = readFileSync(join(SCRIPTS_DIR, "carve.mjs"), "utf-8"); + const called = new Set([...source.matchAll(/carveApi\s*\.\s*(\w+)/g)].map((m) => m[1])); + const bundle = await import("./lib/audio-carve.mjs"); + assert.ok(called.size > 0); + assert.deepEqual( + [...called].filter((name) => typeof bundle[name] !== "function"), + [], + ); +}); + test("members is required, so dropping it cannot silently restore the group form", () => { // The gap this closes: `main()` is the only code that BUILDS `members`, and no // test runs `main()` (the symlink test stops at the usage error, a real run diff --git a/skills/media-use/audio/scripts/lib/audio-carve.mjs b/skills/media-use/audio/scripts/lib/audio-carve.mjs index 4a33b32bc3..80e4ccd00c 100644 --- a/skills/media-use/audio/scripts/lib/audio-carve.mjs +++ b/skills/media-use/audio/scripts/lib/audio-carve.mjs @@ -1,4 +1,4 @@ // GENERATED: do not hand-edit. Source: packages/core/src/audioCarve.ts and audioFx.ts, bundled by // scripts/generate-media-use-audio-carve.mjs so carve.mjs runs the same analysis as Studio without // loading @hyperframes/core from the project. Regenerate: node scripts/generate-media-use-audio-carve.mjs -var K="data-fx-chain",Fe=K.slice(5),A=1,y=(e="frequency",n="Frequency",t=1e3,a=20,r=2e4)=>({kind:"number",key:e,label:n,unit:"Hz",min:a,max:r,step:1,default:t,scale:"log",automatable:!0}),C=(e=.707,n="Bandwidth: higher is narrower.")=>({kind:"number",key:"q",label:"Q",unit:"",min:.1,max:20,step:.01,default:e,scale:"log",automatable:!0,hint:n}),F=(e=-40,n=40,t=0)=>({kind:"number",key:"gain",label:"Gain",unit:"dB",min:e,max:n,step:.1,default:t,automatable:!0}),T={kind:"enum",key:"poles",label:"Slope",options:[{value:"1",label:"6 dB/oct"},{value:"2",label:"12 dB/oct"}],default:"2",hint:"Two poles is the usual biquad; one pole is gentler."},B=[{id:"gain",label:"Gain",group:"dynamics",description:"Raise or lower the whole signal. Automate it to duck under something else.",params:[F(-60,12,0)],web:"gain-node"},{id:"peaking",label:"Peaking EQ",group:"filter",description:"Boost or cut a band, leaving everything either side alone.",params:[y("frequency","Frequency",1e3),F(-40,40,0),C(1)],web:"biquad-peaking"},{id:"lowshelf",label:"Low Shelf",group:"filter",description:"Lift or drop everything below the corner frequency.",params:[y("frequency","Frequency",200,20,2e3),F(-40,40,0)],web:"biquad-lowshelf"},{id:"highshelf",label:"High Shelf",group:"filter",description:"Lift or drop everything above the corner frequency.",params:[y("frequency","Frequency",4e3,500,2e4),F(-40,40,0)],web:"biquad-highshelf"},{id:"highpass",label:"High-pass",group:"filter",description:"Remove low frequencies: the usual fix for rumble on a voice.",params:[y("frequency","Cutoff",300,20,2e4),C(.707),T],web:"biquad-highpass"},{id:"lowpass",label:"Low-pass",group:"filter",description:"Remove high frequencies, which darkens or muffles a track.",params:[y("frequency","Cutoff",8e3,100,2e4),C(.707),T],web:"biquad-lowpass"},{id:"compressor",label:"Compressor",group:"dynamics",description:"Pull loud parts down so the quiet ones can come up.",params:[{kind:"number",key:"threshold",label:"Threshold",unit:"dB",min:-60,max:0,step:.5,default:-24,hint:"Level above which the compressor starts working."},{kind:"number",key:"ratio",label:"Ratio",unit:":1",min:1,max:20,step:.1,default:4},{kind:"number",key:"attack",label:"Attack",unit:"ms",min:.01,max:2e3,step:.1,default:20,scale:"log"},{kind:"number",key:"release",label:"Release",unit:"ms",min:.01,max:9e3,step:1,default:250,scale:"log"},{kind:"number",key:"knee",label:"Knee",unit:"",min:1,max:8,step:.01,default:2.83,hint:"1 is a hard corner; higher eases into it."},{kind:"number",key:"makeup",label:"Makeup",unit:"dB",min:0,max:36,step:.1,default:0},{kind:"number",key:"mix",label:"Mix",unit:"",min:0,max:1,step:.01,default:1,hint:"Below 1 blends the dry signal back in."}],web:"worklet-compressor"},{id:"limiter",label:"Limiter",group:"dynamics",description:"Peak limiter that follows the signal's level. It has no lookahead, so a fast peak or an inter-sample peak can pass the ceiling; use the true-peak limiter for a delivery limit.",params:[{kind:"number",key:"limit",label:"Ceiling",unit:"dB",min:-24,max:0,step:.1,default:-1},{kind:"number",key:"attack",label:"Attack",unit:"ms",min:.1,max:80,step:.1,default:5},{kind:"number",key:"release",label:"Release",unit:"ms",min:1,max:8e3,step:1,default:50,scale:"log"},{kind:"number",key:"level_out",label:"Output",unit:"dB",min:-24,max:24,step:.1,default:0}],web:"worklet-limiter"},{id:"truepeak",label:"True-peak limiter",group:"dynamics",description:"Lookahead limiter that holds a 4x estimate of the inter-sample peak at a dBTP ceiling; full-band noise can land up to about 1.7 dB above it. Adds lookahead plus about 0.3 ms of latency.",params:[{kind:"number",key:"ceiling",label:"Ceiling",unit:"dBTP",min:-24,max:0,step:.1,default:-1,hint:"Target true peak, measured on a 4x oversampled signal. Dense full-band sound can end up to about 1.7 dB above it."},{kind:"number",key:"lookahead",label:"Lookahead",unit:"ms",min:.5,max:10,step:.1,default:3,hint:"How far ahead the gain starts falling. Longer is smoother and adds the same latency."},{kind:"number",key:"release",label:"Release",unit:"ms",min:10,max:2e3,step:1,default:80,scale:"log"}],web:"worklet-truepeak"},{id:"gate",label:"Noise Gate",group:"dynamics",description:"Silence the track when it drops below the threshold.",params:[{kind:"number",key:"threshold",label:"Threshold",unit:"dB",min:-80,max:0,step:.5,default:-35},{kind:"number",key:"range",label:"Range",unit:"dB",min:-80,max:0,step:.5,default:-24,hint:"How far down the gate pulls when closed."},{kind:"number",key:"ratio",label:"Ratio",unit:":1",min:1,max:20,step:.1,default:10},{kind:"number",key:"attack",label:"Attack",unit:"ms",min:.01,max:9e3,step:.1,default:1,scale:"log"},{kind:"number",key:"release",label:"Release",unit:"ms",min:.01,max:9e3,step:1,default:100,scale:"log"},{kind:"number",key:"knee",label:"Knee",unit:"",min:1,max:8,step:.01,default:2.83}],web:"worklet-gate"},{id:"saturate",label:"Saturation",group:"nonlinear",description:"Soft-clip the waveform for warmth or outright distortion.",params:[{kind:"enum",key:"type",label:"Curve",options:[{value:"tanh",label:"Tanh"},{value:"atan",label:"Arctan"},{value:"cubic",label:"Cubic"},{value:"exp",label:"Exponential"},{value:"alg",label:"Algebraic"},{value:"quintic",label:"Quintic"},{value:"sin",label:"Sine"},{value:"erf",label:"Error function"},{value:"hard",label:"Hard clip"}],default:"tanh"},{kind:"number",key:"threshold",label:"Threshold",unit:"dB",min:-40,max:0,step:.1,default:-6},{kind:"number",key:"output",automatable:!0,label:"Output",unit:"dB",min:-24,max:24,step:.1,default:0},{kind:"number",key:"oversample",label:"Oversample",unit:"x",min:1,max:8,step:1,default:4,hint:"Higher costs more but keeps aliasing down."}],web:"waveshaper"},{id:"bitcrush",label:"Bitcrush",group:"nonlinear",description:"Drop bit depth and sample rate for a lo-fi, digital sound.",params:[{kind:"number",key:"bits",label:"Bit depth",unit:"bit",min:1,max:32,step:.1,default:8},{kind:"number",key:"samples",label:"Sample hold",unit:"x",min:1,max:250,step:1,default:1,hint:"Repeats each sample N times, a crude downsample."},{kind:"number",key:"mix",label:"Mix",unit:"",min:0,max:1,step:.01,default:1}],web:"worklet-bitcrush"},{id:"pitchshift",label:"Pitch shift",group:"time",description:"Shifts pitch up or down without changing playback speed. Adds ~50 ms of latency.",params:[{kind:"number",key:"semitones",label:"Semitones",unit:"st",min:-12,max:12,step:1,default:0},{kind:"number",key:"mix",label:"Mix",unit:"",min:0,max:1,step:.01,default:1}],web:"worklet-pitchshift"},{id:"delay",label:"Delay",group:"time",description:"Repeating echoes behind the dry signal.",params:[{kind:"number",key:"time",automatable:!0,label:"Time",unit:"ms",min:1,max:5e3,step:1,default:250,scale:"log"},{kind:"number",key:"feedback",automatable:!0,label:"Feedback",unit:"",min:.01,max:.95,step:.01,default:.35},{kind:"number",key:"mix",automatable:!0,label:"Mix",unit:"",min:0,max:1,step:.01,default:.4}],web:"delay-feedback"},{id:"chorus",label:"Chorus",group:"time",description:"Detuned copies of the signal for width and thickness.",params:[{kind:"number",key:"delay",automatable:!0,label:"Delay",unit:"ms",min:1,max:100,step:.1,default:7},{kind:"number",key:"depth",automatable:!0,label:"Depth",unit:"ms",min:0,max:10,step:.01,default:2},{kind:"number",key:"speed",automatable:!0,label:"Rate",unit:"Hz",min:.01,max:10,step:.01,default:1},{kind:"number",key:"mix",automatable:!0,label:"Mix",unit:"",min:0,max:1,step:.01,default:.5}],web:"chorus-lfo"},{id:"phaser",label:"Phaser",group:"time",description:"Sweeping notches moving through the spectrum.",params:[{kind:"number",key:"in_gain",automatable:!0,label:"Input",unit:"",min:0,max:1,step:.01,default:.4},{kind:"number",key:"out_gain",automatable:!0,label:"Output",unit:"",min:0,max:2,step:.01,default:.74},{kind:"number",key:"delay",label:"Delay",unit:"ms",min:.1,max:5,step:.1,default:3},{kind:"number",key:"decay",label:"Decay",unit:"",min:0,max:.99,step:.01,default:.4},{kind:"number",key:"speed",automatable:!0,label:"Rate",unit:"Hz",min:.1,max:2,step:.01,default:.5},{kind:"enum",key:"type",label:"Waveform",options:[{value:"0",label:"Triangular"},{value:"1",label:"Sinusoidal"}],default:"0"}],web:"allpass-phaser"},{id:"reverb",label:"Reverb",group:"time",description:"Room tail. Both ends convolve the same generated impulse, so preview matches render.",params:[{kind:"number",key:"size",label:"Room size",unit:"",min:.05,max:1,step:.01,default:.7},{kind:"number",key:"damping",label:"Damping",unit:"",min:0,max:1,step:.01,default:.5,hint:"Higher rolls the top off the tail faster."},{kind:"number",key:"wet",automatable:!0,label:"Wet",unit:"",min:0,max:1,step:.01,default:.35},{kind:"number",key:"dry",automatable:!0,label:"Dry",unit:"",min:0,max:1,step:.01,default:.7}],web:"convolver"}],D=new Map(B.map(e=>[e.id,e]));var ve=B.map(e=>e.id);function M(e){let n=D.get(e);if(!n)return{};let t={};for(let a of n.params)t[a.key]=a.default;return t}function O(e,n){let t=D.get(e);if(!t)return{};let a={};for(let r of t.params){let o=n?.[r.key];if(r.kind==="enum"){let i=r.options.some(u=>u.value===o);a[r.key]=i?o:r.default;continue}let s=typeof o=="number"?o:typeof o=="string"&&o.trim()!==""?Number(o):Number.NaN;a[r.key]=Number.isFinite(s)?Math.min(r.max,Math.max(r.min,s)):r.default}return a}var x=class extends Error{constructor(n){super(n),this.name="AudioFxChainError"}};function X(e){let n;try{n=JSON.parse(e)}catch(r){throw new x(`Chain file is not valid JSON: ${r.message}`)}if(typeof n!="object"||n===null)throw new x("Chain file must be a JSON object.");let t=n;if(t.version!==A)throw new x(`Unsupported chain version: ${String(t.version)}`);if(!Array.isArray(t.nodes))throw new x("Chain file is missing a `nodes` array.");let a=t.nodes.map(W);return{version:A,nodes:a}}function j(e){return JSON.stringify({version:A,nodes:e.nodes.map(Q)})}function J(e){let n=new Set(e.nodes.map(t=>t.id).filter(Boolean));for(let t=1;;t+=1){let a=`n${t}`;if(!n.has(a))return a}}function W(e,n){if(typeof e!="object"||e===null)throw new x(`Node ${n} is not an object.`);let t=e;if(typeof t.type!="string"||!D.has(t.type))throw new x(`Node ${n} has unknown effect type: ${String(t.type)}`);return L({type:t.type,id:k(t.id),fromCarve:v(t.fromCarve),fromPreset:k(t.fromPreset),label:k(t.label),fromEq:k(t.fromEq),fromLeveller:v(t.fromLeveller),presetAmount:R(t.presetAmount),enabled:t.enabled!==!1,params:O(t.type,t.params??void 0)})}function Q(e){return L({type:e.type,id:k(e.id),fromCarve:v(e.fromCarve),fromPreset:k(e.fromPreset),label:k(e.label),fromEq:k(e.fromEq),fromLeveller:v(e.fromLeveller),presetAmount:e.presetAmount===1?void 0:R(e.presetAmount),enabled:e.enabled===!1?!1:void 0,params:O(e.type,e.params)})}function k(e){return typeof e=="string"&&e?e:void 0}function v(e){return e===!0?!0:void 0}function R(e){if(!(typeof e!="number"||!Number.isFinite(e)))return Math.min(1,Math.max(0,e))}function L(e){for(let n of Object.keys(e))e[n]===void 0&&delete e[n];return e}function V(e,n){let t=e.length;for(let a=1,r=0;a>1;for(;r&o;o>>=1)r^=o;r^=o,a`${ne}${e}${ae}`,re=new RegExp(`music|bgm|${w("bed")}|soundtrack|score|${w("song")}|theme|instrumental|track\\d`,"i"),oe=new RegExp(`voice|${w("vo")}|${w("vox")}|narrat|speech|dialog|monolog|announce|${w("tts")}|talk|interview|podcast|recap|script`,"i");function ie(...e){let n=e.filter(Boolean).join(" ");return oe.test(n)?"voice":te.test(n)?"sfx":re.test(n)?"music":"unknown"}function se(e,n){let t=a=>typeof a.duration=="number"&&Number.isFinite(a.duration)?a.start+Math.max(0,a.duration):Number.POSITIVE_INFINITY;return e.start({samples:o.samples,at:Math.round(o.offsetSeconds*n)})),a=t.reduce((o,s)=>Math.max(o,s.at+s.samples.length),0);if(a<=0)return new Float32Array(0);let r=new Float32Array(a);for(let{samples:o,at:s}of t){let i=s<0?-s:0;for(let u=i;u=a||(r[l]=(r[l]??0)+(o[u]??0))}}return r}function me(e,n){let t=Math.max(e.length,c),a=e.length>=c?e:(()=>{let m=new Float32Array(c);return m.set(e),m})(),r=new Float32Array(c);for(let m=0;m=a&&e[i]0?o/s:0}var fe=30;function ce(e,n){let t=Math.log2(e/2e3),a=Math.exp(-(t*t)/2);return n*fe*(1-a)}function be(e,n,t){if(e.length===0)return[];let{freqs:a,power:r}=me(e,n),s=Z.map(u=>{let l=de(a,r,u);return{center:u,hasEnergy:l>0,scoreDb:l>0?10*Math.log10(l)-ce(u,t.intelligibilityBias):Number.NEGATIVE_INFINITY}}).sort((u,l)=>l.scoreDb-u.scoreDb).slice(0,Math.max(1,t.bands)).filter(u=>u.hasEnergy);if(s.length===0)return[];let i=s[0].scoreDb;return s.map(({center:u,scoreDb:l})=>{let f=Math.pow(10,(l-i)/10),p=Math.min(t.maxCutDb,Math.max(t.maxCutDb/2,t.maxCutDb*f));return{freq:u,gainDb:-Number(p.toFixed(2)),q:t.q}}).sort((u,l)=>u.freq-l.freq)}var pe=30,he=.05;var xe=2.4,ke=400,P=.2,ge=.5;function ye(e,n){let t=[{t:0,v:0}],a=0,r=-1;return e.forEach((o,s)=>{s!==e.length-1&&Math.abs(o.v-a)0&&r!==s-1&&t.push(e[s-1]),t.push(o),a=o.v,r=s)}),t}function U(e,n,t){let a=0,r=0;for(let s=n;s0?20*Math.log10(o):Number.NEGATIVE_INFINITY}function Ae(e,n,t,a,r){if(e.length===0||a.duckDb<=0)return[];let o=Math.max(c,Math.ceil(e.length/ke)),s=Math.round(r*t),i=[],u=[],l=[];for(let h=0;h{let q=u[_]??Number.NEGATIVE_INFINITY,G=h>p&&Number.isFinite(q)?q-(h-a.headroomDb):0,I=Math.min(a.duckDb,Math.max(0,G));b+=(I>b?m:d)*(I-b);let Y=b=P;)b+=d*-b,E+=$,g.push({t:Number(E.toFixed(3)),v:b=S||N.push({t:S,v:0}),N}function we(e){let n=e.map(t=>({type:"peaking",enabled:!0,params:{...M("peaking"),frequency:t.freq,gain:t.gainDb,q:t.q}}));return{version:A,nodes:n}}export{be as analyseCarveBands,Ae as analyseCarveDuck,we as carveBandsToChain,ue as carveProfile,ie as classifyAudioName,se as clipsOverlap,M as defaultAudioFxParams,J as mintAudioFxNodeId,le as mixCarveSources,X as parseAudioFxChain,j as serializeAudioFxChain}; +var Z="data-fx-chain",Ne=Z.slice(5),D=1,C=(e="frequency",n="Frequency",t=1e3,a=20,r=2e4)=>({kind:"number",key:e,label:n,unit:"Hz",min:a,max:r,step:1,default:t,scale:"log",automatable:!0}),I=(e=.707,n="Bandwidth: higher is narrower.")=>({kind:"number",key:"q",label:"Q",unit:"",min:.1,max:20,step:.01,default:e,scale:"log",automatable:!0,hint:n}),E=(e=-40,n=40,t=0)=>({kind:"number",key:"gain",label:"Gain",unit:"dB",min:e,max:n,step:.1,default:t,automatable:!0}),L={kind:"enum",key:"poles",label:"Slope",options:[{value:"1",label:"6 dB/oct"},{value:"2",label:"12 dB/oct"}],default:"2",hint:"Two poles is the usual biquad; one pole is gentler."},V=[{id:"gain",label:"Gain",group:"dynamics",description:"Raise or lower the whole signal. Automate it to duck under something else.",params:[E(-60,12,0)],web:"gain-node"},{id:"peaking",label:"Peaking EQ",group:"filter",description:"Boost or cut a band, leaving everything either side alone.",params:[C("frequency","Frequency",1e3),E(-40,40,0),I(1)],web:"biquad-peaking"},{id:"lowshelf",label:"Low Shelf",group:"filter",description:"Lift or drop everything below the corner frequency.",params:[C("frequency","Frequency",200,20,2e3),E(-40,40,0)],web:"biquad-lowshelf"},{id:"highshelf",label:"High Shelf",group:"filter",description:"Lift or drop everything above the corner frequency.",params:[C("frequency","Frequency",4e3,500,2e4),E(-40,40,0)],web:"biquad-highshelf"},{id:"highpass",label:"High-pass",group:"filter",description:"Remove low frequencies: the usual fix for rumble on a voice.",params:[C("frequency","Cutoff",300,20,2e4),I(.707),L],web:"biquad-highpass"},{id:"lowpass",label:"Low-pass",group:"filter",description:"Remove high frequencies, which darkens or muffles a track.",params:[C("frequency","Cutoff",8e3,100,2e4),I(.707),L],web:"biquad-lowpass"},{id:"compressor",label:"Compressor",group:"dynamics",description:"Pull loud parts down so the quiet ones can come up.",params:[{kind:"number",key:"threshold",label:"Threshold",unit:"dB",min:-60,max:0,step:.5,default:-24,hint:"Level above which the compressor starts working."},{kind:"number",key:"ratio",label:"Ratio",unit:":1",min:1,max:20,step:.1,default:4},{kind:"number",key:"attack",label:"Attack",unit:"ms",min:.01,max:2e3,step:.1,default:20,scale:"log"},{kind:"number",key:"release",label:"Release",unit:"ms",min:.01,max:9e3,step:1,default:250,scale:"log"},{kind:"number",key:"knee",label:"Knee",unit:"",min:1,max:8,step:.01,default:2.83,hint:"1 is a hard corner; higher eases into it."},{kind:"number",key:"makeup",label:"Makeup",unit:"dB",min:0,max:36,step:.1,default:0},{kind:"number",key:"mix",label:"Mix",unit:"",min:0,max:1,step:.01,default:1,hint:"Below 1 blends the dry signal back in."}],web:"worklet-compressor"},{id:"limiter",label:"Limiter",group:"dynamics",description:"Peak limiter that follows the signal's level. It has no lookahead, so a fast peak or an inter-sample peak can pass the ceiling; use the true-peak limiter for a delivery limit.",params:[{kind:"number",key:"limit",label:"Ceiling",unit:"dB",min:-24,max:0,step:.1,default:-1},{kind:"number",key:"attack",label:"Attack",unit:"ms",min:.1,max:80,step:.1,default:5},{kind:"number",key:"release",label:"Release",unit:"ms",min:1,max:8e3,step:1,default:50,scale:"log"},{kind:"number",key:"level_out",label:"Output",unit:"dB",min:-24,max:24,step:.1,default:0}],web:"worklet-limiter"},{id:"truepeak",label:"True-peak limiter",group:"dynamics",description:"Lookahead limiter that holds a 4x estimate of the inter-sample peak at a dBTP ceiling; full-band noise can land up to about 1.7 dB above it. Adds lookahead plus about 0.3 ms of latency.",params:[{kind:"number",key:"ceiling",label:"Ceiling",unit:"dBTP",min:-24,max:0,step:.1,default:-1,hint:"Target true peak, measured on a 4x oversampled signal. Dense full-band sound can end up to about 1.7 dB above it."},{kind:"number",key:"lookahead",label:"Lookahead",unit:"ms",min:.5,max:10,step:.1,default:3,hint:"How far ahead the gain starts falling. Longer is smoother and adds the same latency."},{kind:"number",key:"release",label:"Release",unit:"ms",min:10,max:2e3,step:1,default:80,scale:"log"}],web:"worklet-truepeak"},{id:"gate",label:"Noise Gate",group:"dynamics",description:"Silence the track when it drops below the threshold.",params:[{kind:"number",key:"threshold",label:"Threshold",unit:"dB",min:-80,max:0,step:.5,default:-35},{kind:"number",key:"range",label:"Range",unit:"dB",min:-80,max:0,step:.5,default:-24,hint:"How far down the gate pulls when closed."},{kind:"number",key:"ratio",label:"Ratio",unit:":1",min:1,max:20,step:.1,default:10},{kind:"number",key:"attack",label:"Attack",unit:"ms",min:.01,max:9e3,step:.1,default:1,scale:"log"},{kind:"number",key:"release",label:"Release",unit:"ms",min:.01,max:9e3,step:1,default:100,scale:"log"},{kind:"number",key:"knee",label:"Knee",unit:"",min:1,max:8,step:.01,default:2.83}],web:"worklet-gate"},{id:"saturate",label:"Saturation",group:"nonlinear",description:"Soft-clip the waveform for warmth or outright distortion.",params:[{kind:"enum",key:"type",label:"Curve",options:[{value:"tanh",label:"Tanh"},{value:"atan",label:"Arctan"},{value:"cubic",label:"Cubic"},{value:"exp",label:"Exponential"},{value:"alg",label:"Algebraic"},{value:"quintic",label:"Quintic"},{value:"sin",label:"Sine"},{value:"erf",label:"Error function"},{value:"hard",label:"Hard clip"}],default:"tanh"},{kind:"number",key:"threshold",label:"Threshold",unit:"dB",min:-40,max:0,step:.1,default:-6},{kind:"number",key:"output",automatable:!0,label:"Output",unit:"dB",min:-24,max:24,step:.1,default:0},{kind:"number",key:"oversample",label:"Oversample",unit:"x",min:1,max:8,step:1,default:4,hint:"Higher costs more but keeps aliasing down."}],web:"waveshaper"},{id:"bitcrush",label:"Bitcrush",group:"nonlinear",description:"Drop bit depth and sample rate for a lo-fi, digital sound.",params:[{kind:"number",key:"bits",label:"Bit depth",unit:"bit",min:1,max:32,step:.1,default:8},{kind:"number",key:"samples",label:"Sample hold",unit:"x",min:1,max:250,step:1,default:1,hint:"Repeats each sample N times, a crude downsample."},{kind:"number",key:"mix",label:"Mix",unit:"",min:0,max:1,step:.01,default:1}],web:"worklet-bitcrush"},{id:"pitchshift",label:"Pitch shift",group:"time",description:"Shifts pitch up or down without changing playback speed. Adds ~50 ms of latency.",params:[{kind:"number",key:"semitones",label:"Semitones",unit:"st",min:-12,max:12,step:1,default:0},{kind:"number",key:"mix",label:"Mix",unit:"",min:0,max:1,step:.01,default:1}],web:"worklet-pitchshift"},{id:"delay",label:"Delay",group:"time",description:"Repeating echoes behind the dry signal.",params:[{kind:"number",key:"time",automatable:!0,label:"Time",unit:"ms",min:1,max:5e3,step:1,default:250,scale:"log"},{kind:"number",key:"feedback",automatable:!0,label:"Feedback",unit:"",min:.01,max:.95,step:.01,default:.35},{kind:"number",key:"mix",automatable:!0,label:"Mix",unit:"",min:0,max:1,step:.01,default:.4}],web:"delay-feedback"},{id:"chorus",label:"Chorus",group:"time",description:"Detuned copies of the signal for width and thickness.",params:[{kind:"number",key:"delay",automatable:!0,label:"Delay",unit:"ms",min:1,max:100,step:.1,default:7},{kind:"number",key:"depth",automatable:!0,label:"Depth",unit:"ms",min:0,max:10,step:.01,default:2},{kind:"number",key:"speed",automatable:!0,label:"Rate",unit:"Hz",min:.01,max:10,step:.01,default:1},{kind:"number",key:"mix",automatable:!0,label:"Mix",unit:"",min:0,max:1,step:.01,default:.5}],web:"chorus-lfo"},{id:"phaser",label:"Phaser",group:"time",description:"Sweeping notches moving through the spectrum.",params:[{kind:"number",key:"in_gain",automatable:!0,label:"Input",unit:"",min:0,max:1,step:.01,default:.4},{kind:"number",key:"out_gain",automatable:!0,label:"Output",unit:"",min:0,max:2,step:.01,default:.74},{kind:"number",key:"delay",label:"Delay",unit:"ms",min:.1,max:5,step:.1,default:3},{kind:"number",key:"decay",label:"Decay",unit:"",min:0,max:.99,step:.01,default:.4},{kind:"number",key:"speed",automatable:!0,label:"Rate",unit:"Hz",min:.1,max:2,step:.01,default:.5},{kind:"enum",key:"type",label:"Waveform",options:[{value:"0",label:"Triangular"},{value:"1",label:"Sinusoidal"}],default:"0"}],web:"allpass-phaser"},{id:"reverb",label:"Reverb",group:"time",description:"Room tail. Both ends convolve the same generated impulse, so preview matches render.",params:[{kind:"number",key:"size",label:"Room size",unit:"",min:.05,max:1,step:.01,default:.7},{kind:"number",key:"damping",label:"Damping",unit:"",min:0,max:1,step:.01,default:.5,hint:"Higher rolls the top off the tail faster."},{kind:"number",key:"wet",automatable:!0,label:"Wet",unit:"",min:0,max:1,step:.01,default:.35},{kind:"number",key:"dry",automatable:!0,label:"Dry",unit:"",min:0,max:1,step:.01,default:.7}],web:"convolver"}],T=new Map(V.map(e=>[e.id,e]));var He=V.map(e=>e.id);function B(e){let n=T.get(e);if(!n)return{};let t={};for(let a of n.params)t[a.key]=a.default;return t}function U(e,n){let t=T.get(e);if(!t)return{};let a={};for(let r of t.params){let o=n?.[r.key];if(r.kind==="enum"){let i=r.options.some(u=>u.value===o);a[r.key]=i?o:r.default;continue}let s=typeof o=="number"?o:typeof o=="string"&&o.trim()!==""?Number(o):Number.NaN;a[r.key]=Number.isFinite(s)?Math.min(r.max,Math.max(r.min,s)):r.default}return a}var y=class extends Error{constructor(n){super(n),this.name="AudioFxChainError"}};function ee(e){let n;try{n=JSON.parse(e)}catch(r){throw new y(`Chain file is not valid JSON: ${r.message}`)}if(typeof n!="object"||n===null)throw new y("Chain file must be a JSON object.");let t=n;if(t.version!==D)throw new y(`Unsupported chain version: ${String(t.version)}`);if(!Array.isArray(t.nodes))throw new y("Chain file is missing a `nodes` array.");let a=t.nodes.map(ae);return{version:D,nodes:a}}function te(e){return JSON.stringify({version:D,nodes:e.nodes.map(re)})}function ne(e){let n=new Set(e.nodes.map(t=>t.id).filter(Boolean));for(let t=1;;t+=1){let a=`n${t}`;if(!n.has(a))return a}}function ae(e,n){if(typeof e!="object"||e===null)throw new y(`Node ${n} is not an object.`);let t=e;if(typeof t.type!="string"||!T.has(t.type))throw new y(`Node ${n} has unknown effect type: ${String(t.type)}`);return z({type:t.type,id:A(t.id),fromCarve:S(t.fromCarve),fromPreset:A(t.fromPreset),label:A(t.label),fromEq:A(t.fromEq),fromLeveller:S(t.fromLeveller),presetAmount:$(t.presetAmount),enabled:t.enabled!==!1,params:U(t.type,t.params??void 0)})}function re(e){return z({type:e.type,id:A(e.id),fromCarve:S(e.fromCarve),fromPreset:A(e.fromPreset),label:A(e.label),fromEq:A(e.fromEq),fromLeveller:S(e.fromLeveller),presetAmount:e.presetAmount===1?void 0:$(e.presetAmount),enabled:e.enabled===!1?!1:void 0,params:U(e.type,e.params)})}function A(e){return typeof e=="string"&&e?e:void 0}function S(e){return e===!0?!0:void 0}function $(e){if(!(typeof e!="number"||!Number.isFinite(e)))return Math.min(1,Math.max(0,e))}function z(e){for(let n of Object.keys(e))e[n]===void 0&&delete e[n];return e}function O(e,n){let t=e.length;for(let a=1,r=0;a>1;for(;r&o;o>>=1)r^=o;r^=o,a`${ue}${e}${le}`,me=new RegExp(`music|bgm|${M("bed")}|soundtrack|score|${M("song")}|theme|instrumental|track\\d`,"i"),de=new RegExp(`voice|${M("vo")}|${M("vox")}|narrat|speech|dialog|monolog|announce|${M("tts")}|talk|interview|podcast|recap|script`,"i");function fe(...e){let n=e.filter(Boolean).join(" ");return de.test(n)?"voice":se.test(n)?"sfx":me.test(n)?"music":"unknown"}function ce(e,n){let t=a=>typeof a.duration=="number"&&Number.isFinite(a.duration)?a.start+Math.max(0,a.duration):Number.POSITIVE_INFINITY;return e.start({samples:o.samples,at:Math.round(o.offsetSeconds*n)})),a=t.reduce((o,s)=>Math.max(o,s.at+s.samples.length),0);if(a<=0)return new Float32Array(0);let r=new Float32Array(a);for(let{samples:o,at:s}of t){let i=s<0?-s:0;for(let u=i;u=a||(r[l]=(r[l]??0)+(o[u]??0))}}return r}function he(e,n){let t=Math.max(e.length,d),a=e.length>=d?e:(()=>{let c=new Float32Array(d);return c.set(e),c})(),r=new Float32Array(d);for(let c=0;c=a&&e[i]0?o/s:0}var xe=30;function ke(e,n){let t=Math.log2(e/2e3),a=Math.exp(-(t*t)/2);return n*xe*(1-a)}function ge(e,n,t){if(e.length===0)return[];let{freqs:a,power:r}=he(e,n),s=oe.map(u=>{let l=Y(a,r,u);return{center:u,hasEnergy:l>0,scoreDb:l>0?10*Math.log10(l)-ke(u,t.intelligibilityBias):Number.NEGATIVE_INFINITY}}).sort((u,l)=>l.scoreDb-u.scoreDb).slice(0,Math.max(1,t.bands)).filter(u=>u.hasEnergy);if(s.length===0)return[];let i=s[0].scoreDb;return s.map(({center:u,scoreDb:l})=>{let f=Math.pow(10,(l-i)/10),h=Math.min(t.maxCutDb,Math.max(t.maxCutDb/2,t.maxCutDb*f));return{freq:u,gainDb:-Number(h.toFixed(2)),q:t.q}}).sort((u,l)=>u.freq-l.freq)}var K=30,X=.05,ye=.25,Ae=2.4,j=400,_=.2,J=.5;function W(e,n){let t=[{t:0,v:0}],a=0,r=-1;return e.forEach((o,s)=>{s!==e.length-1&&Math.abs(o.v-a)0&&r!==s-1&&t.push(e[s-1]),t.push(o),a=o.v,r=s)}),t}function we(e,n,t){if(e.length===0||t.length===0)return[];let a=new Float32Array(d);for(let m=0;m[]),l=new Float64Array(d),f=new Float64Array(d);for(let m=0;mu[w].push(Y(s,x,p.freq)))}let h=e.length/n,c=1-Math.exp(-(r/n)/X),b=1-Math.exp(-(r/n)/ye);return t.map((m,x)=>{let p=u[x],w=Math.max(...p),g=0,P=[];p.forEach((F,k)=>{let N=F>0&&w>0?Math.max(0,1+10*Math.log10(F/w)/K):0;g+=(N>g?c:b)*(N-g);let H=m.gainDb*g,q=Math.abs(H)<_?0:Number(H.toFixed(1));P.push({t:Number(i[k].toFixed(3)),v:q})});let v=W(P,J);return v.push({t:Number(Math.max(h,v.at(-1).t).toFixed(3)),v:0}),{freq:m.freq,points:v}})}function G(e,n,t){let a=0,r=0;for(let s=n;s0?20*Math.log10(o):Number.NEGATIVE_INFINITY}function ve(e,n,t,a,r){if(e.length===0||a.duckDb<=0)return[];let o=Math.max(d,Math.ceil(e.length/j)),s=Math.round(r*t),i=[],u=[],l=[];for(let k=0;k{let H=u[N]??Number.NEGATIVE_INFINITY,q=k>h&&Number.isFinite(H)?H-(k-a.headroomDb):0,R=Math.min(a.duckDb,Math.max(0,q));m+=(R>m?c:b)*(R-m);let Q=m<_?0:-Number(m.toFixed(1));x.push({t:Number(l[N].toFixed(3)),v:Q})});let p=o/t,w=l.at(-1)??0;for(;m>=_;)m+=b*-m,w+=p,x.push({t:Number(w.toFixed(3)),v:m<_?0:-Number(m.toFixed(1))});let g=W(x,J),P=e.length/t,v=g.at(-1),F=Number(Math.max(P,v.t).toFixed(3));return v.v===0&&v.t>=F||g.push({t:F,v:0}),g}function Fe(e){let n=e.map(t=>({type:"peaking",enabled:!0,params:{...B("peaking"),frequency:t.freq,gain:t.gainDb,q:t.q}}));return{version:D,nodes:n}}export{ge as analyseCarveBands,ve as analyseCarveDuck,we as analyseCarveDynamics,Fe as carveBandsToChain,be as carveProfile,fe as classifyAudioName,ce as clipsOverlap,B as defaultAudioFxParams,ne as mintAudioFxNodeId,pe as mixCarveSources,ee as parseAudioFxChain,te as serializeAudioFxChain};