@allyhub/sdk 0.1.0-alpha.8 → 0.2.0-next.0

package/node_modules/@allyhub-next/audio/dist/recording/measure.d.ts

@@ -0,0 +1,67 @@
+/** The measurement's thresholds. */
+export interface RecordingMeasureOptions {
+    /**
+     * A frame is speech when it is this share of the way from the quiet end
+     * (the 10th percentile of frame levels, at most `range` dB under the
+     * loud end) to the loud end (the 95th percentile).
+     */
+    split: number;
+    range: number;
+    /** Speech joined over gaps shorter than this, s. */
+    join: number;
+    /** A pause is at least this long, s. */
+    gap: number;
+    /** A fall is read from this many dB under where speech stopped… */
+    skip: number;
+    /** …down to this many dB over the pause's floor. */
+    floor: number;
+    /** Fewer ends than this measure no decay. */
+    least: number;
+    /** An end whose fall from `skip` to `floor` spans fewer dB than this is not read. */
+    fall: number;
+}
+export declare const RECORDING_MEASURE_DEFAULTS: RecordingMeasureOptions;
+/** Third-octave band centres, Hz (ISO 266, 63 Hz to 16 kHz). */
+export declare const THIRD_OCTAVES: number[];
+/** What a voice's recording measures. */
+export interface RecordingMeasurement {
+    /** Its integrated loudness, LUFS. */
+    loudness: number | null;
+    /** Seconds of speech and of pauses. */
+    speech: number;
+    pauses: number;
+    /** dB by third-octave band against the 1 kHz band, over its speech. */
+    spectrum: {
+        hz: number;
+        db: number;
+    }[];
+    /** The room's decay where speech stops: its median time, the spread of the middle half, how many ends. */
+    decay: {
+        t60: number;
+        low: number;
+        high: number;
+        ends: number;
+    } | {
+        missing: string;
+    };
+    /** The pauses' loudness under the speech's, LU, and the tone's tilt, dB per octave. */
+    tone: {
+        below: number;
+        tilt: number;
+    } | {
+        missing: string;
+    };
+    /** Short-term loudness spread over the speech, LU (10th to 90th percentile), and peak over RMS, dB. */
+    dynamics: {
+        spread: number;
+        crest: number;
+    };
+}
+/** Speech and pauses as frame runs. */
+export declare function speechRuns(levels: readonly number[], frame: number, o?: RecordingMeasureOptions): {
+    speech: [number, number][];
+    pauses: [number, number][];
+};
+/** A voice's recording measured (channels at `rate`). */
+export declare function measureRecording(channels: readonly Float32Array[], rate: number, o?: RecordingMeasureOptions): RecordingMeasurement;
+//# sourceMappingURL=measure.d.ts.map

package/node_modules/@allyhub-next/audio/dist/recording/measure.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{fft as J}from"./fft.js";import{integratedLoudness as H,steadyLoudness as K}from"./loudness.js";import{biquad as W,runBiquads as X}from"./filters.js";export const RECORDING_MEASURE_DEFAULTS={split:.35,range:60,join:.15,gap:.3,skip:5,floor:6,least:4,fall:10},THIRD_OCTAVES=[63,80,100,125,160,200,250,315,400,500,630,800,1e3,1250,1600,2e3,2500,3150,4e3,5e3,6300,8e3,1e4,12500,16e3];const F=(i,e)=>i[Math.min(i.length-1,Math.max(0,Math.floor(e*i.length)))]??0;function Y(i){const e=i[0]?.length??0,f=new Float32Array(e);for(const h of i)for(let s=0;s<e;s++)f[s]=(f[s]??0)+(h[s]??0)/i.length;return f}function N(i,e){const f=[];for(let h=0;h+e<=i.length;h+=e){let s=0;for(let M=h;M<h+e;M++)s+=(i[M]??0)**2;f.push(10*Math.log10(s/e+1e-20))}return f}export function speechRuns(i,e,f=RECORDING_MEASURE_DEFAULTS){const h=[...i].sort((t,n)=>t-n),s=F(h,.95),M=Math.max(F(h,.1),s-f.range),w=M+f.split*(s-M),b=i.map(t=>t>w),A=[];let a=-1;b.forEach((t,n)=>{t&&a<0&&(a=n),!t&&a>=0&&(A.push([a,n]),a=-1)}),a>=0&&A.push([a,b.length]);const p=[];for(const t of A){const n=p[p.length-1];n&&(t[0]-n[1])*e<f.join?n[1]=t[1]:p.push([t[0],t[1]])}const S=[];for(let t=1;t<p.length;t++){const n=p[t-1]?.[1]??0,y=p[t]?.[0]??0;(y-n)*e>=f.gap&&S.push([n,y])}return{speech:p,pauses:S}}function Z(i,e,f){const s=new Float64Array(4097);let M=0;const w=new Float64Array(8192),b=new Float64Array(8192),A=Float64Array.from({length:8192},(t,n)=>.5-.5*Math.cos(2*Math.PI*n/8191));for(let t=0;t+8192<=i.length;t+=8192/4)if(f(t+8192/2)){for(let n=0;n<8192;n++)w[n]=(i[t+n]??0)*(A[n]??0),b[n]=0;J(w,b);for(let n=0;n<=8192/2;n++)s[n]=(s[n]??0)+(w[n]??0)**2+(b[n]??0)**2;M++}const a=e/8192,p=THIRD_OCTAVES.filter(t=>t*2**(1/6)<e/2).map(t=>{const n=t/1.122462048309373,y=t*2**(1/6);let O=0;for(let x=Math.floor(n/a);x<=Math.ceil(y/a);x++){const T=Math.max(n,(x-.5)*a),v=Math.min(y,(x+.5)*a);v>T&&(O+=(s[x]??0)*(v-T)/a)}return{hz:t,db:10*Math.log10(O/Math.max(M,1)+1e-20)}}),S=p.find(t=>t.hz===1e3)?.db??0;return p.map(t=>({hz:t.hz,db:Math.round((t.db-S)*10)/10}))}export function measureRecording(i,e,f=RECORDING_MEASURE_DEFAULTS){const h=Y(i),s=Math.round(.02*e),M=N(h,s),{speech:w,pauses:b}=speechRuns(M,s/e,f),A=new Uint8Array(M.length);for(const[o,r]of w)for(let c=o;c<r;c++)A[c]=1;const a=o=>Math.round(o*10)/10,p=o=>Math.round(o*1e3)/1e3,S=Z(h,e,o=>A[Math.floor(o/s)]===1),t=Math.round(.005*e),n=N(h,t),y=[];for(const[o,r]of b){const c=Math.round(o*s/t),k=Math.round(r*s/t),_=F(n.slice(c,k).sort((l,d)=>l-d),.2),D=n.slice(Math.max(0,c-100),c).sort((l,d)=>l-d),C=F(D,.9);let E=c;for(let l=c;l>Math.max(0,c-100);l--)if((n[l]??-200)>=C-6){E=l;break}const g=(n[E]??-200)-f.skip,m=Math.max(_+f.floor,g-40);if(g-m<f.fall)continue;const u=[],R=Math.min(k,n.length,E+Math.round(.5*e/t));for(let l=E;l<R;l++){const d=n[l]??-200;if(d<=m)break;d<=g&&u.push([l*t/e,d])}if(u.length<4)continue;const L=u.reduce((l,d)=>l+d[0],0)/u.length,Q=u.reduce((l,d)=>l+d[1],0)/u.length,V=u.reduce((l,d)=>l+(d[0]-L)*(d[1]-Q),0),B=u.reduce((l,d)=>l+(d[0]-L)**2,0),G=B>0?V/B:0;G<0&&y.push(G)}const O=y.length<f.least?{missing:`${String(y.length)} ends of speech before a pause fell far enough to read (${String(f.least)} needed)`}:(()=>{const o=y.map(r=>-60/r).sort((r,c)=>r-c);return{t60:p(F(o,.5)),low:p(F(o,.25)),high:p(F(o,.75)),ends:o.length}})(),x=H(i,e),T=o=>{const r=Math.round(.08/(s/e));return[o[0]+r,o[1]-r]},v=b.map(T).filter(([o,r])=>r-o>5);let P={missing:"no pause long enough to hear the room in"};if(v.length>0&&x!==void 0){const o=v.reduce((j,[g,m])=>j+(m-g)*s,0),r=Math.max(o,Math.round(.5*e)),c=j=>{const g=new Float32Array(r);let m=0;for(const[u,R]of v)g.set(j.subarray(u*s,R*s),m),m+=(R-u)*s;for(let u=m;u<r;u++)g[u]=g[(u-m)%Math.max(m,1)]??0;return g},k=i.map(c),_=K(k,e),D=j=>{let g=0,m=0;for(const u of k){const R=Float32Array.from(u);X(R,[W({type:"bandpass",hz:j,q:Math.SQRT2},e)]);for(const L of R)g+=L*L;m+=R.length}return 10*Math.log10(g/Math.max(m,1)+1e-20)},C=D(250),E=D(4e3);P=_===void 0?{missing:"the pauses are silent"}:{below:a(x-_),tilt:a((E-C)/4)}}const q=[],I=Math.round(.4*e);for(let o=0;o+I<=h.length;o+=Math.round(.1*e)){if(A[Math.floor((o+I/2)/s)]!==1)continue;const r=H([h.subarray(o,o+I)],e);r!==void 0&&q.push(r)}q.sort((o,r)=>o-r);let U=0,$=0,z=0;for(const[o,r]of w)for(let c=o*s;c<r*s&&c<h.length;c++){const k=Math.abs(h[c]??0);U=Math.max(U,k),$+=k*k,z++}return{loudness:x===void 0?null:a(x),speech:a(w.reduce((o,[r,c])=>o+(c-r),0)*(s/e)),pauses:a(b.reduce((o,[r,c])=>o+(c-r),0)*(s/e)),spectrum:S,decay:O,tone:P,dynamics:{spread:q.length>0?a(F(q,.9)-F(q,.1)):0,crest:z>0?a(20*Math.log10(U/Math.sqrt($/z+1e-20))):0}}}

package/node_modules/@allyhub-next/audio/dist/recording/mic.d.ts

@@ -0,0 +1,32 @@
+import type { Vec3 } from "./vec.js";
+/** The speed of sound, m/s, at 20 °C. */
+export declare const SOUND_SPEED = 343;
+/** A first-order pattern, as pyroomacoustics names them, and its pressure share p. */
+export declare const PATTERNS: {
+    readonly omni: 1;
+    readonly subcardioid: 0.75;
+    readonly cardioid: 0.5;
+    readonly supercardioid: 0.37;
+    readonly hypercardioid: 0.25;
+    readonly figure8: 0;
+};
+export type Pattern = keyof typeof PATTERNS;
+/** A pattern's gain toward a direction at angle θ off its axis (cos θ given). */
+export declare function patternGain(pattern: Pattern, cos: number): number;
+/**
+ * The proximity effect on axis at `hz`: the near field's gain over the far
+ * field's, |1 + (1 - p)/(jkr)|, of a source `distance` m away.
+ */
+export declare function proximity(pattern: Pattern, distance: number, hz: number): number;
+/**
+ * The talker's loss toward an angle θ off where they face, at 180° (dB, ≤ 0),
+ * by octave band centre: little in the lows, much in the highs.
+ */
+export declare const TALKER_BEHIND: readonly (readonly [number, number])[];
+/** A table of [Hz, dB] read at `hz`, linear in log frequency, held past its ends. */
+export declare function curveDb(table: readonly (readonly [number, number])[], hz: number): number;
+/** The talker's loss (dB) at `hz` toward a direction θ off their facing (cos θ given). */
+export declare function talkerDb(hz: number, cos: number): number;
+/** cos of the angle between two vectors (1 when either is zero). */
+export declare function cosBetween(a: Vec3, b: Vec3): number;
+//# sourceMappingURL=mic.d.ts.map

package/node_modules/@allyhub-next/audio/dist/recording/mic.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+export const SOUND_SPEED=343,PATTERNS={omni:1,subcardioid:.75,cardioid:.5,supercardioid:.37,hypercardioid:.25,figure8:0};export function patternGain(t,r){const n=PATTERNS[t];return n+(1-n)*r}export function proximity(t,r,n){const o=PATTERNS[t],e=2*Math.PI*Math.max(n,1)*Math.max(r,.005)/343;return Math.hypot(1,(1-o)/e)}export const TALKER_BEHIND=[[63,0],[125,-1],[250,-2],[500,-4],[1e3,-6],[2e3,-9],[4e3,-13],[8e3,-18],[16e3,-25]];export function curveDb(t,r){const n=t[0],o=t[t.length-1];if(!n||!o)return 0;if(r<=n[0])return n[1];if(r>=o[0])return o[1];for(let e=1;e<t.length;e++){const i=t[e-1],c=t[e];if(!i||!c||r>c[0])continue;const u=Math.log(r/i[0])/Math.log(c[0]/i[0]);return i[1]+(c[1]-i[1])*u}return o[1]}export function talkerDb(t,r){return curveDb(TALKER_BEHIND,t)*((1-r)/2)}export function cosBetween(t,r){const n=Math.hypot(t[0],t[1],t[2]),o=Math.hypot(r[0],r[1],r[2]);return n===0||o===0?1:(t[0]*r[0]+t[1]*r[1]+t[2]*r[2])/(n*o)}

package/node_modules/@allyhub-next/audio/dist/recording/noise.d.ts

@@ -0,0 +1,27 @@
+/** mulberry32: the same numbers for the same seed, everywhere. */
+export declare function random(seed: number): () => number;
+/** Normal noise (Box–Muller) from a seed. */
+export declare function gaussian(seed: number): () => number;
+/** What a room tone sounds like. */
+export interface NoiseShape {
+    /** dB per octave over 1 kHz (pink noise is -3). */
+    tilt: number;
+    /** dB more below 120 Hz: ventilation, traffic, the building. */
+    rumble: number;
+    /** The mains' hum: its fundamental (50 or 60 Hz) and its level against the noise, dB; absent: none. */
+    hum?: {
+        hz: number;
+        db: number;
+    };
+    /** The highest frequency it has, Hz: a device's band. */
+    top: number;
+}
+/** The noise's gain at a frequency (linear), relative to 1 kHz. */
+export declare function noiseGain(shape: NoiseShape, hz: number): number;
+/**
+ * `n` samples of room tone of unit RMS before its level is set: Gaussian
+ * noise through the shape's minimum-phase filter, the hum added as sines
+ * (its harmonics falling 6 dB each), all from the seed.
+ */
+export declare function roomTone(n: number, rate: number, shape: NoiseShape, seed: number): Float32Array;
+//# sourceMappingURL=noise.d.ts.map

package/node_modules/@allyhub-next/audio/dist/recording/noise.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{convolve as p,minimumPhase as P}from"./fft.js";export function random(n){let r=n>>>0;return()=>{r=r+1831565813>>>0;let t=r;return t=Math.imul(t^t>>>15,t|1),t^=t+Math.imul(t^t>>>7,t|61),((t^t>>>14)>>>0)/4294967296}}export function gaussian(n){const r=random(n);let t;return()=>{if(t!==void 0){const h=t;return t=void 0,h}const a=Math.max(r(),1e-12),c=r(),e=Math.sqrt(-2*Math.log(a));return t=e*Math.sin(2*Math.PI*c),e*Math.cos(2*Math.PI*c)}}export function noiseGain(n,r){const t=Math.max(r,10);let a=n.tilt*Math.log2(t/1e3);return a+=n.rumble/(1+(t/120)**2),t>n.top&&(a-=48*Math.log2(t/n.top)),10**(a/20)}export function roomTone(n,r,t,a){const c=gaussian(a),e=new Float32Array(n+4096);for(let o=0;o<e.length;o++)e[o]=c();const h=P(o=>noiseGain(t,o),r,2048),l=p(e,h).subarray(4096);let m=0;for(const o of l)m+=o*o;const M=Math.sqrt(m/Math.max(1,l.length)),i=new Float32Array(n);for(let o=0;o<n;o++)i[o]=(l[o]??0)/(M||1);if(t.hum){const o=10**(t.hum.db/20)*Math.SQRT2,x=random(a^2654435769);for(let u=1;u<=6;u++){const f=t.hum.hz*u;if(f>t.top)break;const d=o/2**(u-1),b=x()*2*Math.PI,g=2*Math.PI*f/r;for(let s=0;s<n;s++)i[s]=(i[s]??0)+d*Math.sin(g*s+b)}}return i}

package/node_modules/@allyhub-next/audio/dist/recording/presets.d.ts

@@ -0,0 +1,64 @@
+import type { CompressorOptions, DeesserOptions } from "./dynamics.js";
+import type { FilterSpec } from "./filters.js";
+import type { Pattern } from "./mic.js";
+import type { NoiseShape } from "./noise.js";
+import type { PostName, RoomName, RoomOptions, VoiceSetup } from "./setup.js";
+import type { Vec3 } from "./vec.js";
+/** A room as a preset gives it: every value. */
+export interface RoomPreset {
+    size: Vec3;
+    walls: string;
+    floor: string;
+    ceiling: string;
+    rt60: number;
+    talker: Vec3;
+    /** Only the ground is there (outdoors). */
+    open?: true;
+    /** Reflection order of the image sources. */
+    order: number;
+}
+export declare const ROOM_PRESETS: Record<RoomName, RoomPreset>;
+/** A finishing chain as a preset gives it. */
+export interface PostPreset {
+    highpass: number | false;
+    eq: FilterSpec[];
+    /** Threshold: dB over the voice's loudness. */
+    deess: DeesserOptions | false;
+    /** Threshold: dB over the voice's loudness. */
+    compress: CompressorOptions | false;
+}
+export declare const POST_PRESETS: Record<PostName, PostPreset>;
+/** A setup as its preset gives it. */
+export interface SetupPreset {
+    pattern: Pattern;
+    distance: number;
+    angle: number;
+    below: number;
+    response: (readonly [number, number])[];
+    band: readonly [number, number];
+    stereo: number | false;
+    room: RoomName | RoomOptions | false;
+    /** Its loudness under the voice's (LU), and its shape. */
+    noise: (NoiseShape & {
+        below: number;
+    }) | false;
+    /** Target: dB over the voice's loudness. */
+    agc: {
+        target: number;
+        most: number;
+        attack: number;
+        release: number;
+        /** The speech's level it follows is over this many seconds. */
+        window: number;
+        /** Under this (dB under the voice's loudness) the gain holds: a pause is not lifted. */
+        gate?: number;
+    } | false;
+    post: PostName | false;
+}
+export declare const SETUP_PRESETS: Record<VoiceSetup, SetupPreset>;
+/** The dry voice's own microphone: a studio's cardioid 0.2 m away. */
+export declare const SOURCE_DEFAULTS: {
+    pattern: Pattern;
+    distance: number;
+};
+//# sourceMappingURL=presets.d.ts.map

package/node_modules/@allyhub-next/audio/dist/recording/presets.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+export const ROOM_PRESETS={bedroom:{size:[3.4,2.6,4],walls:"plasterboard",floor:"carpet",ceiling:"plasterboard-ceiling",rt60:.4,talker:[1.5,1.2,1.5],order:3},"living-room":{size:[5,2.7,6],walls:"plasterboard",floor:"wood",ceiling:"plasterboard-ceiling",rt60:.55,talker:[2.2,1.2,2.5],order:3},office:{size:[4,2.8,5],walls:"plasterboard",floor:"carpet-thin",ceiling:"ceiling-tiles",rt60:.45,talker:[1.8,1.2,2],order:3},kitchen:{size:[3,2.6,4],walls:"tiles",floor:"tiles",ceiling:"plasterboard-ceiling",rt60:.75,talker:[1.4,1.6,1.6],order:3},treated:{size:[3,2.6,3.5],walls:"foam",floor:"carpet",ceiling:"foam",rt60:.2,talker:[1.4,1.2,1.4],order:3},car:{size:[1.4,1.15,1.9],walls:"glass",floor:"upholstery",ceiling:"upholstery",rt60:.08,talker:[.45,.85,.9],order:6},outdoor:{size:[60,30,60],walls:"hard",floor:"hard",ceiling:"hard",rt60:.4,talker:[30,1.6,30],open:!0,order:1}};const e={hz:5500,threshold:-12,ratio:3,attack:.002,release:.06};export const POST_PRESETS={finish:{highpass:70,eq:[],deess:e,compress:{threshold:-3,ratio:4,knee:6,attack:.005,release:.3,window:.01}},"phone-app":{highpass:90,eq:[{type:"peak",hz:300,db:-2,q:1},{type:"peak",hz:4e3,db:3,q:.8},{type:"highshelf",hz:1e4,db:1}],deess:e,compress:{threshold:0,ratio:3,knee:6,attack:.005,release:.12,window:.01}}};const r={tilt:-4,rumble:8,top:16e3};export const SETUP_PRESETS={studio:{pattern:"cardioid",distance:.2,angle:0,below:0,response:[[125,-3.5],[250,-3],[500,-.5],[1e3,0],[2e3,-2],[4e3,-1.5],[8e3,-4],[12500,-4]],band:[20,2e4],stereo:!1,room:!1,noise:!1,agc:!1,post:"finish"},phone:{pattern:"omni",distance:.35,angle:0,below:25,response:[[125,-8.5],[250,-3.5],[500,-.5],[1e3,0],[2e3,0],[4e3,0],[8e3,-3.5],[12500,-2.5]],band:[100,16e3],stereo:.1,room:{preset:"bedroom",rt60:.2},noise:{...r,below:42},agc:{target:0,most:10,attack:.3,release:1.5,window:2,gate:-25},post:!1},lav:{pattern:"omni",distance:.22,angle:0,below:70,response:[[125,-2],[250,-3],[500,.5],[1e3,0],[2e3,-1],[4e3,-1],[8e3,-3.5],[12500,-4]],band:[70,18e3],stereo:!1,room:{preset:"bedroom",rt60:.13},noise:{tilt:-4,rumble:4,top:18e3,below:50},agc:!1,post:"finish"}},SOURCE_DEFAULTS={pattern:"cardioid",distance:.2};

package/node_modules/@allyhub-next/audio/dist/recording/room.d.ts

@@ -0,0 +1,78 @@
+import { type Pattern } from "./mic.js";
+import type { Vec3 } from "./vec.js";
+/** Octave band centres, Hz, from 125. */
+export declare function bandCentres(rate: number): number[];
+/**
+ * Absorption coefficients (energy) at 125 Hz to 8 kHz, from
+ * pyroomacoustics' data/materials.json; values past what a source gives
+ * hold its last.
+ */
+export declare const MATERIALS: Record<string, readonly number[]>;
+/**
+ * Air absorption (energy, per metre) at 125 Hz to 8 kHz, 20 °C and 30–50 %
+ * humidity: Vorländer's Auralization, as pyroomacoustics has it.
+ */
+export declare const AIR: number[];
+/** A table at 125 Hz to 8 kHz read at the given band centres (log-linear, extrapolated past 8 kHz, kept in [0, 1]). */
+export declare function atBands(table: readonly number[], centres: readonly number[]): number[];
+/** A box room, its surfaces' absorption by band, the talker and the microphone. */
+export interface RoomModel {
+    /** Width (x), height (y), depth (z), m. */
+    size: Vec3;
+    /** Absorption by band (at 125 Hz up) of the walls at x = 0 and x = W, y = 0 (the floor) and y = H, z = 0 and z = D. */
+    surfaces: readonly [
+        readonly number[],
+        readonly number[],
+        readonly number[],
+        readonly number[],
+        readonly number[],
+        readonly number[]
+    ];
+    /** Surfaces that are not there (outdoors: only the ground). */
+    open?: readonly boolean[];
+    talker: Vec3;
+    /** Where the talker faces. */
+    facing: Vec3;
+    mic: Vec3;
+    /** Where the microphone points. */
+    axis: Vec3;
+    pattern: Pattern;
+    /** The dry voice's own microphone: proximity is this setup's over it. */
+    source: {
+        pattern: Pattern;
+        distance: number;
+    };
+    /** Reflection order of the image sources; past it the statistical tail. */
+    order: number;
+}
+/** The reverberation time of each band, s (Eyring, with the air). */
+export declare function reverberation(room: RoomModel, rate: number): number[];
+/**
+ * Surfaces scaled by one factor so the room's reverberation time at
+ * 500 Hz–1 kHz is `rt60` (bisection on the factor; each coefficient kept
+ * under 0.99).
+ */
+export declare function withReverberation(room: RoomModel, rt60: number, rate: number): RoomModel;
+/** The impulse response's parts: the direct sound's delay and gain, and the rest. */
+export interface RoomResponse {
+    /** Every reflection and the tail, the direct sound left out, at `lead` samples before the direct sound's arrival. */
+    reflections: Float64Array;
+    /** The direct sound: its amplitude (1/d, the pattern), and the talker's angle toward the microphone (cos). */
+    direct: {
+        gain: number;
+        cos: number;
+        distance: number;
+    };
+    /** Samples the response is ahead of the direct sound's arrival: the sinc's half. */
+    lead: number;
+    /** Each band's reverberation time, s. */
+    rt60: number[];
+    /** When the tail takes over, s after the direct sound. */
+    mixing: number;
+}
+/**
+ * The room's impulse response at `rate`, its time 0 the direct sound's
+ * arrival less `lead` samples, seeded for the tail.
+ */
+export declare function roomResponse(room: RoomModel, rate: number, seed: number): RoomResponse;
+//# sourceMappingURL=room.d.ts.map

package/node_modules/@allyhub-next/audio/dist/recording/room.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{fft as nt,nextPow2 as ht}from"./fft.js";import{cosBetween as Q,patternGain as ot,proximity as st,talkerDb as lt}from"./mic.js";import{random as Mt}from"./noise.js";export function bandCentres(t){const n=Math.floor(Math.log2(t/125));return Array.from({length:n},(r,s)=>125*2**s)}export const MATERIALS={hard:[.02,.02,.03,.03,.04,.05,.05],plasterboard:[.15,.1,.06,.04,.04,.05,.05],"plasterboard-ceiling":[.2,.15,.1,.08,.04,.02,.02],tiles:[.01,.01,.01,.02,.02,.02,.02],concrete:[.01,.03,.05,.02,.02,.02,.02],wood:[.18,.12,.1,.09,.08,.07,.07],carpet:[.08,.08,.3,.6,.75,.8,.8],"carpet-thin":[.02,.04,.08,.2,.35,.4,.4],glass:[.1,.05,.04,.03,.03,.03,.03],curtains:[.05,.12,.35,.45,.38,.36,.36],"ceiling-tiles":[.49,.53,.53,.75,.92,.99,.99],foam:[.12,.33,.83,.97,.98,.95,.95],upholstery:[.44,.6,.77,.89,.82,.7,.7],grass:[.11,.26,.6,.69,.92,.99,.99]},AIR=[1e-4,3e-4,6e-4,.001,.0019,.0058,.0203];export function atBands(t,n){return n.map(r=>{const s=Math.log2(r/125),p=Math.min(Math.max(Math.floor(s),0),t.length-2),i=t[p]??0,M=t[p+1]??i;return Math.min(1,Math.max(0,i+(M-i)*(s-p)))})}const _=343;function ft(t){const[n,r,s]=t;return[r*s,r*s,n*s,n*s,n*r,n*r]}export function reverberation(t,n){const r=bandCentres(n),[s,p,i]=t.size,M=s*p*i,h=ft(t.size),a=h.reduce((m,g)=>m+g,0),e=atBands(AIR,r);return r.map((m,g)=>{let F=0;t.surfaces.forEach((I,R)=>{const k=t.open?.[R]===!0;F+=(h[R]??0)*(k?1:atBands(I,r)[g]??0)});const y=Math.min(F/a,.999);return 24*Math.LN10*M/(_*(-a*Math.log(1-y)+4*(e[g]??0)*M))})}export function withReverberation(t,n,r){const s=h=>({...t,surfaces:t.surfaces.map(a=>a.map(e=>Math.min(.99,e*h)))}),p=h=>{const a=reverberation(h,r);return((a[2]??0)+(a[3]??0))/2};let i=.001,M=1e3;for(let h=0;h<60;h++){const a=Math.sqrt(i*M);p(s(a))>n?i=a:M=a}return s(Math.sqrt(i*M))}function pt(t,n,r){const s=n/2+1,p=t.map(()=>new Float64Array(s)),i=t.map((a,e)=>e===0?0:Math.round(a/Math.SQRT2/r*n)),M=t.map(a=>Math.round(a/r*n)),h=t.map((a,e)=>e===t.length-1?s:Math.round(a*Math.SQRT2/r*n));t.forEach((a,e)=>{const m=p[e];if(m)for(let g=i[e]??0;g<Math.min(h[e]??s,s);g++)m[g]=1});for(let a=1;a<t.length;a++){const e=Math.max(1,Math.round(.5*((h[a]??0)-(M[a]??0)))),m=p[a-1],g=p[a];if(!(!m||!g))for(let F=-e;F<=e;F++){const y=(i[a]??0)+F;if(y<0||y>=s)continue;const I=(F/e+1)/2;m[y]=Math.cos(Math.PI*I/2),g[y]=Math.sin(Math.PI*I/2)}}return p}function ut(t,n,r){const s=Math.floor(n),p=n-s;for(let i=0;i<81;i++){const M=s-40+i;if(M<0||M>=t.length)continue;const h=i-40-p,a=Math.abs(h)<1e-9?1:Math.sin(Math.PI*h)/(Math.PI*h),e=.5-.5*Math.cos(2*Math.PI*i/80);t[M]=(t[M]??0)+r*e*a}}export function roomResponse(t,n,r){const s=bandCentres(n),p=s.length,[i,M,h]=t.size,a=[i,M,h],e=t.talker,m=t.mic,g=t.surfaces.map((f,u)=>t.open?.[u]===!0?s.map(()=>0):atBands(f,s).map(o=>Math.sqrt(1-o))),F=atBands(AIR,s),y=reverberation(t,n),I=[m[0]-e[0],m[1]-e[1],m[2]-e[2]],R=Math.hypot(...I),k=40,E=t.order,K=[];let q=1/0;for(let f=-(E+1);f<=E+1;f++)for(let u=-(E+1);u<=E+1;u++)for(let o=-(E+1);o<=E+1;o++){const b=Math.abs(f)+Math.abs(u)+Math.abs(o);if(b===0||b>E+1)continue;const d=[f,u,o],c=(S,v)=>{const x=a[v]??1,w=e[v];return S*x+(Math.abs(S)%2===1?x-w:w)},l=[c(f,0)-m[0],c(u,1)-m[1],c(o,2)-m[2]],P=Math.hypot(...l),N=(P-R)/_;if(b===E+1){d.every((v,x)=>v===0||!(t.open?.[x*2]===!0&&t.open[x*2+1]===!0))&&(q=Math.min(q,N));continue}let C=!1;const H=s.map((S,v)=>{let x=1;return d.forEach((w,X)=>{const Y=w>0?Math.floor(w/2):Math.ceil(-w/2),Z=w>0?Math.ceil(w/2):Math.floor(-w/2),$=g[X*2]?.[v]??0,tt=g[X*2+1]?.[v]??0;(Y>0&&$===0||Z>0&&tt===0)&&(C=!0),x*=$**Y*tt**Z}),x});if(C)continue;const V=[Math.abs(f)%2===1?l[0]:-l[0],Math.abs(u)%2===1?l[1]:-l[1],Math.abs(o)%2===1?l[2]:-l[2]],W=ot(t.pattern,Q(l,t.axis)),J=Q(V,t.facing);K.push({t:N,amp:H.map((S,v)=>{const x=s[v]??1e3,w=st(t.pattern,P,x)/st(t.source.pattern,t.source.distance,x);return S*W/P*Math.exp(-.5*(F[v]??0)*P)*10**(lt(x,J)/20)*w})})}Number.isFinite(q)||(q=.08);const at=Math.max(...y),z=Math.ceil((Math.min(Math.max(at,q+.05),3)+.01)*n)+2*k,A=ht(2*z),ct=pt(s,A,n),D=new Float64Array(A),j=new Float64Array(A),B=new Float64Array(A),T=new Float64Array(A),O=Math.round(q*n),[et,rt,it]=t.size,U=et*rt*it,G=t.open?.some(Boolean)===!0,L=new Float64Array(z);if(!G){const f=Mt(r);let u=q;for(;u*n<z-k;){const c=Math.floor(u*n)+k;L[c]=(L[c]??0)+(f()<.5?-1:1);const l=Math.min(4*Math.PI*_**3*(u+R/_)**2/U,1e4);u+=Math.log(1/Math.max(f(),1e-12))/l}const o=Math.max(1,Math.round(.004*n)),b=new Float64Array(z);let d=0;for(let c=0;c<z;c++)d+=(L[c]??0)**2,c>=o&&(d-=(L[c-o]??0)**2),b[c]=d/o;for(let c=0;c<z;c++){const l=b[Math.min(z-1,c+Math.floor(o/2))]??0;l>0&&(L[c]=(L[c]??0)/Math.sqrt(l))}}for(let f=0;f<p;f++){B.fill(0),T.fill(0);for(const o of K)!G&&o.t>q+.002||ut(B,o.t*n+k,o.amp[f]??0);if(!G){const o=y[f]??.4,b=Math.round(.01*n);for(let d=O+k-Math.round(.002*n);d<z;d++){const c=(d-k)/n,l=Math.sqrt(4*Math.PI*_/U/n*Math.exp(-6*Math.LN10*(c+R/_)/o)),P=d-(O+k-Math.round(.002*n)),N=P<b?.5-.5*Math.cos(Math.PI*P/b):1;T[d]=(L[d]??0)*l*N}}nt(B,T);const u=ct[f];if(u)for(let o=0;o<A;o++){const b=o<=A/2?o:A-o,d=(u[b]??0)**2,c=(A-o)%A,l=B[o]??0,P=T[o]??0,N=B[c]??0,C=T[c]??0,H=(l+N)/2,V=(P-C)/2,W=(P+C)/2,J=(N-l)/2;D[o]=(D[o]??0)+d*(H+W),j[o]=(j[o]??0)+d*(V+J)}}return nt(D,j,!0),{reflections:D.slice(0,z),direct:{gain:ot(t.pattern,Q([-I[0],-I[1],-I[2]],t.axis))/R,cos:Q(I,t.facing),distance:R},lead:k,rt60:y,mixing:q}}

package/node_modules/@allyhub-next/audio/dist/recording/setup.d.ts

@@ -0,0 +1,111 @@
+import type { CompressorOptions, DeesserOptions } from "./dynamics.js";
+import type { FilterSpec } from "./filters.js";
+import type { Pattern } from "./mic.js";
+import type { NoiseShape } from "./noise.js";
+import type { Vec3 } from "./vec.js";
+/** The setups a voice can be recorded with, by name. */
+export declare const VOICE_SETUPS: readonly ["studio", "phone", "lav"];
+export type VoiceSetup = (typeof VOICE_SETUPS)[number];
+/** The rooms, by name. */
+export declare const ROOMS: readonly ["bedroom", "living-room", "office", "kitchen", "treated", "car", "outdoor"];
+export type RoomName = (typeof ROOMS)[number];
+/** The finishing chains, by name. */
+export declare const POSTS: readonly ["finish", "phone-app"];
+export type PostName = (typeof POSTS)[number];
+/** A surface's absorption by octave band (125 Hz to 8 kHz), or a material's name. */
+export type Surface = string | readonly number[];
+/** A room: a box, its surfaces, and where the talker stands in it. */
+export interface RoomOptions {
+    /** A named room whose values fill what is not given. */
+    preset?: RoomName;
+    /** Width, height and depth, m. */
+    size?: Vec3;
+    /** The walls', the floor's and the ceiling's absorption. */
+    walls?: Surface;
+    floor?: Surface;
+    ceiling?: Surface;
+    /**
+     * The reverberation time at 500 Hz–1 kHz, s: the surfaces' absorption
+     * is scaled until the room has it (Eyring), keeping their shape over
+     * the bands.
+     */
+    rt60?: number;
+    /** The talker's mouth in the room, m from its corner (x across, y up, z along); they face +z. */
+    talker?: Vec3;
+}
+/** The room's own sound under the voice. */
+export interface NoiseOptions extends Partial<NoiseShape> {
+    /** Its loudness under the voice's, LU. */
+    below?: number;
+}
+/** The finishing after the recording. */
+export interface PostOptions {
+    /** A named chain whose values fill what is not given. */
+    preset?: PostName;
+    /** A high-pass, Hz; false: none. */
+    highpass?: number | false;
+    /** Equalizer bands, after the high-pass. */
+    eq?: readonly FilterSpec[];
+    /** A de-esser; its threshold is dB over the voice's loudness. */
+    deess?: Partial<DeesserOptions> | false;
+    /** A compressor; its threshold is dB over the voice's loudness. */
+    compress?: Partial<CompressorOptions> | false;
+}
+/** A phone's automatic gain: its target is dB over the voice's loudness. */
+export interface AgcSettings {
+    target?: number;
+    most?: number;
+    attack?: number;
+    release?: number;
+    /** The speech's level it follows is over this many seconds. */
+    window?: number;
+    /** Under this (dB under the voice's loudness) the gain holds: a pause is not lifted. */
+    gate?: number;
+}
+/** `voice`: a setup's name, or one with changes; false: the voice as it is. */
+export interface VoiceOptions {
+    /** The setup whose values fill what is not given; default studio. */
+    setup?: VoiceSetup;
+    /**
+     * What recorded the dry voice already: its microphone's pattern and its
+     * distance (a TTS voice: a studio's cardioid 0.2 m away). Proximity is
+     * what this setup adds over that one's.
+     */
+    source?: {
+        pattern?: Pattern;
+        distance?: number;
+    };
+    /** The microphone's pattern. */
+    pattern?: Pattern;
+    /** Mouth to microphone, m. */
+    distance?: number;
+    /** How far the microphone is round from where the talker faces, degrees. */
+    angle?: number;
+    /** How far below the mouth it is, degrees. */
+    below?: number;
+    /** The microphone's own response: [Hz, dB] points, linear in log frequency. */
+    response?: readonly (readonly [number, number])[];
+    /** The band it records, Hz: under the first and over the second it falls away. */
+    band?: readonly [number, number];
+    /** Two microphones this far apart, m (a phone's), each its own room; false: one. */
+    stereo?: number | false;
+    /** The room; false: none (as a studio's dry voice). */
+    room?: RoomName | RoomOptions | false;
+    /** The room's own sound; false: none. */
+    noise?: NoiseOptions | false;
+    /** The device's automatic gain; false: none. */
+    agc?: AgcSettings | false;
+    /** The finishing; false: none. */
+    post?: PostName | PostOptions | false;
+    /**
+     * More microphones that heard the same voice, mixed in at `gain` dB (a
+     * phone left recording beside a desk microphone). The finishing is the
+     * first's, on the sum.
+     */
+    also?: readonly (Omit<VoiceOptions, "also" | "post"> & {
+        gain?: number;
+    })[];
+}
+/** What a piece or a part says: a setup, its changes, or false. */
+export type VoiceSetting = VoiceSetup | VoiceOptions | false;
+//# sourceMappingURL=setup.d.ts.map

package/node_modules/@allyhub-next/audio/dist/recording/setup.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+export const VOICE_SETUPS=["studio","phone","lav"],ROOMS=["bedroom","living-room","office","kitchen","treated","car","outdoor"],POSTS=["finish","phone-app"];

package/node_modules/@allyhub-next/audio/dist/recording/vec.d.ts

@@ -0,0 +1,3 @@
+/** A point or a direction in a room, metres: x across, y up, z along. */
+export type Vec3 = readonly [number, number, number];
+//# sourceMappingURL=vec.d.ts.map

package/node_modules/@allyhub-next/audio/dist/recording/vec.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+export{};

package/node_modules/@allyhub-next/audio/dist/render.d.ts

@@ -0,0 +1,26 @@
+import { type SoundOf } from "./decode.js";
+import type { MixPlan, SfxPlay, Stereo } from "./plan.js";
+/**
+ * A sound effect's samples as it plays: its file's (or the built-in
+ * sound's), shaped and levelled. A shaped file sits at the mix's sfx
+ * level by its loudness as shaped; a shaped built-in sound keeps the
+ * level it had.
+ */
+export declare function playSfx(x: SfxPlay, src: Stereo, rate: number): {
+    src: Stereo;
+    gainDb: number;
+};
+export interface RenderOptions {
+    /** The speech alone, as recorded, for measuring it. */
+    only?: "voice";
+}
+/**
+ * Renders a plan to a stereo mix at `rate`, before mastering: each
+ * recording group's speech summed and recorded through its setting, then
+ * turned by the parts' speech gains; speech played as it is and footage
+ * sound, each a stretch of its file at its place with 10 ms fades at each
+ * cut; the music as the film plays it; the sound effects. A file `sound`
+ * does not have is left out.
+ */
+export declare function renderMix(plan: MixPlan, sound: SoundOf, rate: number, o?: RenderOptions): Stereo;
+//# sourceMappingURL=render.d.ts.map

package/node_modules/@allyhub-next/audio/dist/render.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{clipSource as x}from"./decode.js";import{equalPower as z,gainAt as A}from"./envelope.js";import{playMusic as B}from"./music.js";import{shapes as C,shapeSound as H,soundLevel as q}from"./shape.js";import{synthSfx as J}from"./sfx.js";import{playVoice as K,voiceGroups as N}from"./voice.js";function Q(o,r,n){if(r.length===0)return;const s=o[0].length;for(let i=0;i<s;i++){const t=10**(A(r,i/n)/20);t!==1&&(o[0][i]=(o[0][i]??0)*t,o[1][i]=(o[1][i]??0)*t)}}function E(o,r,n,s,i,t){const m=Math.round(n.dur*s),y=Math.round(n.at*s),v=10**(n.gainDb/20),p=Math.min(Math.round(.01*s),Math.floor(m/4)),e=l=>l===void 0||l<=0?0:Math.min(Math.round(l*s),Math.floor(m/2)),f=e(n.fadeIn),a=e(n.fadeOut),c=(l,g)=>g>0?z(l/g):p>0&&l<p?l/p:1,u=[...n.envelope??[]],b=o[0].length,h=r[0].length,d=i===void 0?n.speed??1:1,S=i===void 0?n.from*s:n.from/i*s;for(let l=0;l<m;l++){const g=y+l;if(g<0||g>=b)continue;const F=d===1?Math.round(S)+l:S+l*d,M=Math.floor(F);if(M<0||M>=h)continue;const I=F-M,O=Math.min(M+1,h-1),w=g/s,V=u.length>0||t.length>0?10**((A(u,w)+A(t,w))/20):1,j=v*V*c(l,f)*c(m-1-l,a);for(let D=0;D<2;D++){const G=r[D]??r[0],L=G[M]??0,k=G[O]??0,P=o[D]??o[0];P[g]=(P[g]??0)+(L+(k-L)*I)*j}}}export function playSfx(o,r,n){if(!o.shape||!(C(o.shape)||o.shape.filter!==void 0))return{src:r,gainDb:o.gainDb};const s=q(r,n)?.lufs,i=[Float32Array.from(r[0]),Float32Array.from(r[1])];H(i,o.shape,n,0);const t=q(i,n)?.lufs;return t===void 0?{src:i,gainDb:o.gainDb}:o.level?{src:i,gainDb:o.level.target-t+o.level.gainDb}:{src:i,gainDb:o.gainDb+(s===void 0?0:s-t)}}function R(o,r,n){const s=J(o,r,n);return[s,s]}export function renderMix(o,r,n,s={}){const i=Math.round(o.duration*n),t=[new Float32Array(i),new Float32Array(i)],m=o.speechGain??[],y=x(r),{groups:v,dry:p}=N(o);for(const e of v){const[f,a]=K(e,o.duration,n,y);Q([f,a],m,n);for(let c=0;c<i;c++)t[0][c]=(t[0][c]??0)+(f[c]??0),t[1][c]=(t[1][c]??0)+(a[c]??0)}for(const e of p){const f=y(e);f&&E(t,f.src,e,n,f.stretched,m)}if(s.only==="voice")return t;for(const e of o.footage){const f=r(e.file,{});f&&E(t,f.src,e,n,void 0,[])}if(o.music){const e=o.music,f=r(e.file,e.shape?.filter?{filter:e.shape.filter}:{});if(f){const[a,c]=B(e,f.src,o.duration,n);for(let u=0;u<i;u++)t[0][u]=(t[0][u]??0)+(a[u]??0),t[1][u]=(t[1][u]??0)+(c[u]??0)}}for(const e of o.sfx){let f;if(e.file!==void 0?f=r(e.file,e.shape?.filter?{filter:e.shape.filter}:{})?.src:f=R(e.sound,n,e.seed),!f)continue;const a=playSfx(e,f,n),c=10**(a.gainDb/20),u=Math.round(e.at*n),b=a.src[0].length;for(let h=0;h<b;h++){const d=u+h;d<0||d>=i||(t[0][d]=(t[0][d]??0)+(a.src[0][h]??0)*c,t[1][d]=(t[1][d]??0)+(a.src[1][h]??0)*c)}}return t}

package/node_modules/@allyhub-next/audio/dist/sfx.d.ts

@@ -0,0 +1,10 @@
+/** Where the transient of each built-in sound is, so it lands on the cue. */
+export declare const SFX_HIT: Record<string, number>;
+/** FNV-1a: a stable 32-bit seed from text. */
+export declare function hashSeed(text: string): number;
+/**
+ * A built-in sound as mono samples at `rate`, peak about −14 dBFS (so the
+ * sum stays under the voice). Deterministic for a seed.
+ */
+export declare function synthSfx(sound: string, rate: number, seed: number): Float32Array<ArrayBuffer>;
+//# sourceMappingURL=sfx.d.ts.map

package/node_modules/@allyhub-next/audio/dist/sfx.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+export const SFX_HIT={whoosh:.18,tick:.004,pop:.01};export function hashSeed(o){let n=2166136261;for(let t=0;t<o.length;t++)n^=o.charCodeAt(t),n=Math.imul(n,16777619)>>>0;return n}function v(o){let n=o>>>0;return()=>{n=n+1831565813>>>0;let t=n;return t=Math.imul(t^t>>>15,t|1),t^=t+Math.imul(t^t>>>7,t|61),((t^t>>>14)>>>0)/4294967296}}export function synthSfx(o,n,t){const r=v(t),p=()=>r()*2-1,u=.2;if(o==="tick"){const e=Math.round(n*.06),h=new Float32Array(e);for(let s=0;s<e;s++){const c=s/n,a=Math.exp(-c*90);h[s]=(Math.sin(2*Math.PI*3200*c)*.8+p()*.2)*a}return f(h,u*.7)}if(o==="pop"){const e=Math.round(n*.12),h=new Float32Array(e);let s=0;for(let c=0;c<e;c++){const a=c/n,M=300+600*Math.exp(-a*40);s+=2*Math.PI*M/n;const g=Math.min(1,a/.002)*Math.exp(-a*35);h[c]=Math.sin(s)*g}return f(h,u)}const d=.55,x=Math.round(n*d),m=new Float32Array(x),i=SFX_HIT.whoosh??.18;let w=0,l=0;for(let e=0;e<x;e++){const h=e/n,s=400+2600*Math.exp(-(((h-i)/.12)**2)),c=2*Math.sin(Math.PI*s/n),a=p()-w-.7*l;l+=c*a,w+=c*l;const M=h<i?(h/i)**2:Math.exp(-((h-i)/(d-i))*4);m[e]=l*M}return f(m,u)}function f(o,n){let t=0;for(const r of o)t=Math.max(t,Math.abs(r));if(t>0)for(let r=0;r<o.length;r++)o[r]=(o[r]??0)/t*n;return o}

package/node_modules/@allyhub-next/audio/dist/shape.d.ts

@@ -0,0 +1,118 @@
+import { type FilterSpec } from "./recording/filters.js";
+/** The kinds of band an equalizer has, as the cookbook names them. */
+export declare const BAND_TYPES: readonly ["highpass", "lowpass", "bandpass", "peak", "lowshelf", "highshelf"];
+export type BandType = (typeof BAND_TYPES)[number];
+/**
+ * A band's values from a moment of the film on: `at` is the moment (the
+ * music's own reference: film seconds, an anchor, a part or a word in a
+ * part), and what it leaves out is the band's own value.
+ */
+export interface BandKey<T = SoundMoment> {
+    at: T;
+    hz?: number;
+    db?: number;
+    q?: number;
+}
+/**
+ * One band of an equalizer: a pass (`highpass`, `lowpass`, `bandpass`,
+ * with its `q`, default a Butterworth's 0.707), a `peak` (`db` at `hz`,
+ * `q` default 1) or a shelf (`lowshelf`, `highshelf`: `db` under or over
+ * `hz`, `q` the shelf's slope, default 1). `keys` move its values over
+ * the film's clock (music only).
+ */
+export interface EqBand<T = SoundMoment> {
+    type: BandType;
+    hz: number;
+    db?: number;
+    q?: number;
+    keys?: BandKey<T>[];
+}
+/**
+ * A compressor: from `threshold` dB over the stem's loudness (its
+ * integrated loudness as shaped so far: 0 is at it, -6 six dB under), the
+ * level over it is divided by `ratio`.
+ */
+export interface SoundCompressor {
+    threshold: number;
+    /** Input dB over the threshold per output dB; default 2. */
+    ratio?: number;
+    /** The knee's width, dB; default 6. */
+    knee?: number;
+    /** Seconds to go down, and to come back up; defaults 0.01 and 0.15. */
+    attack?: number;
+    release?: number;
+    /** The detector's window, seconds (0: the peak); default 0.01. */
+    window?: number;
+}
+/** A compressor's defaults: a gentle glue on a whole stem. */
+export declare const COMPRESS_DEFAULTS: {
+    readonly ratio: 2;
+    readonly knee: 6;
+    readonly attack: 0.01;
+    readonly release: 0.15;
+    readonly window: 0.01;
+};
+/** How a stem is shaped (`music: { filter, eq, compress }`, a sound's own). */
+export interface SoundShape<T = SoundMoment> {
+    /**
+     * An ffmpeg audio filter chain run on the file as it is decoded, on the
+     * file's own clock ("acompressor=ratio=3,deesser"): one chain, nothing
+     * that reads files, makes sound of its own or changes the timing.
+     */
+    filter?: string;
+    /** Equalizer bands, in order. */
+    eq?: EqBand<T>[];
+    /** A compressor after the bands. */
+    compress?: SoundCompressor;
+}
+/**
+ * A moment of the film a video-level option names: film seconds, an
+ * anchor of any part ("@drop", "@drop+0.2", "@/drop") or a part's key
+ * (its start), or a word reference in a part (`{ part, at }`: `at` as a
+ * layer's at, from that part's start).
+ */
+export type SoundMoment = number | string | {
+    part: string;
+    at: number | string;
+};
+/** A shape whose bands do not move (a sound effect's). */
+export type FixedShape = Omit<SoundShape, "eq"> & {
+    eq?: Omit<EqBand, "keys">[];
+};
+/** A shape resolved for the mix: its keys at film seconds. */
+export type ResolvedShape = SoundShape<number>;
+/**
+ * Why a sound's filter chain cannot be used, or undefined when it can: one
+ * linear chain of audio filters, none that reads or names files, listens,
+ * loads plugins, makes sound of its own (a random source would differ from
+ * render to render) or changes the timing (the music's beat and the
+ * film's clock would part).
+ */
+export declare function soundFilterProblem(chain: string): string | undefined;
+/**
+ * What is wrong with a shape, or nothing. `keyed`: its bands may move
+ * over time (the music's; a sound effect's are fixed).
+ */
+export declare function shapeProblem(shape: unknown, keyed?: boolean): string | undefined;
+/** A band's values at film time t: its own, moved by its keys (frequency on a log scale). */
+export declare function bandAt(band: EqBand<number>, t: number): FilterSpec;
+/**
+ * Shapes a sound's channels in place with its bands and compressor (its
+ * `filter` was run when it was decoded). `start` is the film second of
+ * the first sample, for bands that move. Deterministic: the same samples
+ * every time, here and in the player.
+ */
+export declare function shapeSound(channels: readonly Float32Array[], shape: ResolvedShape | undefined, rate: number, start?: number): void;
+/**
+ * How loud a sound is, LUFS, and how it was measured: its integrated
+ * loudness (BS.1770, gated), or, where that cannot be measured (shorter
+ * than one 0.4 s block, or all under the gate), its K-weighted level over
+ * its whole length ("level"). Undefined for digital silence.
+ */
+export declare function soundLevel(channels: readonly Float32Array[], rate: number): {
+    lufs: number;
+    by: "integrated" | "level";
+} | undefined;
+/** Whether a shape does anything in JavaScript (bands or a compressor). */
+export declare const shapes: (s: SoundShape<unknown> | undefined) => boolean;
+//# sourceMappingURL=shape.d.ts.map

package/node_modules/@allyhub-next/audio/dist/shape.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{compress as z}from"./recording/dynamics.js";import{biquad as k,runBiquads as $}from"./recording/filters.js";import{integratedLoudness as v,steadyLoudness as S}from"./recording/loudness.js";export const BAND_TYPES=["highpass","lowpass","bandpass","peak","lowshelf","highshelf"],COMPRESS_DEFAULTS={ratio:2,knee:6,attack:.01,release:.15,window:.01};const j={movie:"reads files",amovie:"reads files",sendcmd:"reads files",asendcmd:"reads files",zmq:"listens on the network",azmq:"listens on the network",ladspa:"loads plugins",lv2:"loads plugins",lrc:"reads files",arnndn:"reads files (its model)",sofalizer:"reads files",afir:"takes a second input",amix:"takes several inputs",amerge:"takes several inputs",join:"takes several inputs",asplit:"makes several outputs",anoisesrc:"makes sound of its own",aevalsrc:"makes sound of its own",sine:"makes sound of its own",atempo:"changes the timing (a take's speed is take().speed())",asetrate:"changes the timing",asetpts:"changes the timing",atrim:"changes the timing (play stretches with music.play)",areverse:"changes the timing",aloop:"changes the timing (loop with music.loop)",apad:"changes the timing",adelay:"changes the timing",apulsator:"changes the timing",silenceremove:"changes the timing",loudnorm:"rides the level over time with a window of its own (level the stem with mix, compress with compress)"};export function soundFilterProblem(e){if(typeof e!="string"||e.trim()==="")return'A filter is an ffmpeg audio filter chain, such as "highpass=f=80,acompressor=ratio=3"';const i=e.replace(/'[^']*'/g,"''").replace(/\\./g,"");if(/[;[\]]/.test(i))return"A sound's filter is one chain of filters separated by commas: no ; and no [labels]";for(const t of i.split(",")){const o=/^\s*([A-Za-z0-9_]+)/.exec(t)?.[1];if(!o)return`"${t.trim()}" is not a filter`;const n=j[o.toLowerCase()];if(n)return`The filter ${o} cannot be used on a sound: it ${n}`}if(/(?:^|[:=@])\s*\w*file(?:name)?\s*=/i.test(i))return"A sound's filter cannot name files (…file= options)"}const A=e=>typeof e=="number"&&Number.isFinite(e)||typeof e=="string"&&e.trim()!==""||typeof e=="object"&&e!==null&&typeof e.part=="string"&&(typeof e.at=="number"||typeof e.at=="string"),p=(e,i,t)=>typeof e=="number"&&Number.isFinite(e)&&e>=i&&e<=t;function x(e,i){if(typeof e!="object"||e===null)return"a band is { type, hz, db?, q? }";const t=e,o=Object.keys(t).filter(r=>!["type","hz","db","q","keys"].includes(r));if(o.length>0)return`a band has no ${o.join(", ")}`;if(!BAND_TYPES.includes(t.type))return`a band's type is one of ${BAND_TYPES.join(", ")}, not ${JSON.stringify(t.type)}`;const n=(r,l)=>{if(r.hz!==void 0&&!p(r.hz,10,24e3))return`${l}hz is a frequency from 10 to 24000 Hz, not ${JSON.stringify(r.hz)}`;if(r.db!==void 0&&!p(r.db,-60,24))return`${l}db is dB from -60 to 24, not ${JSON.stringify(r.db)}`;if(r.q!==void 0&&!p(r.q,.05,40))return`${l}q is from 0.05 to 40, not ${JSON.stringify(r.q)}`};if(t.hz===void 0)return"a band has a frequency, hz";const a=n(t,"");if(a)return a;const s=t.type;if((s==="peak"||s==="lowshelf"||s==="highshelf")&&t.db===void 0)return`a ${s} band has its gain, db`;const f=t.keys;if(f!==void 0){if(!i)return"only the music's bands move over time (keys)";if(!Array.isArray(f)||f.length===0)return"keys is a list of { at, hz?, db?, q? }";for(const[r,l]of f.entries()){if(typeof l!="object"||l===null)return`keys[${String(r)}] is { at, hz?, db?, q? }`;const c=l,h=Object.keys(c).filter(u=>!["at","hz","db","q"].includes(u));if(h.length>0)return`keys[${String(r)}] has no ${h.join(", ")}`;if(!A(c.at))return`keys[${String(r)}].at is a moment: film seconds, an anchor ("@drop"), a part's key, or { part, at }`;const d=n(c,`keys[${String(r)}].`);if(d)return d}}}export function shapeProblem(e,i=!1){if(typeof e!="object"||e===null||Array.isArray(e))return"a shape is { filter?, eq?, compress? }";const t=e;if(t.filter!==void 0){const n=soundFilterProblem(t.filter);if(n)return n}if(t.eq!==void 0){if(!Array.isArray(t.eq))return"eq is a list of bands, { type, hz, db?, q? }";for(const[n,a]of t.eq.entries()){const s=x(a,i);if(s)return`eq[${String(n)}]: ${s}`}}const o=t.compress;if(o!==void 0){if(typeof o!="object"||o===null)return"compress is { threshold, ratio?, knee?, attack?, release?, window? }";const n=o,a=Object.keys(n).filter(s=>!["threshold","ratio","knee","attack","release","window"].includes(s));if(a.length>0)return`compress has no ${a.join(", ")}`;if(!p(n.threshold,-60,24))return"compress.threshold is dB over the stem's loudness, from -60 to 24";if(n.ratio!==void 0&&!p(n.ratio,1,100))return"compress.ratio is from 1 to 100";if(n.knee!==void 0&&!p(n.knee,0,40))return"compress.knee is dB from 0 to 40";for(const s of["attack","release","window"])if(n[s]!==void 0&&!p(n[s],0,10))return`compress.${s} is seconds from 0 to 10`}}export function bandAt(e,i){const t=e.keys??[];let o=e.hz,n=e.db??0,a=e.q;if(t.length>0){const s=[...t].sort((d,u)=>d.at-u.at),f=(d,u)=>d[u]??(u==="hz"?e.hz:u==="db"?e.db??0:e.q),r=s[0],l=s.at(-1);let c=r,h=r;if(r&&i<=r.at)c=r,h=r;else if(l&&i>=l.at)c=l,h=l;else for(let d=1;d<s.length;d++){const u=s[d];if(u&&i<u.at){c=s[d-1],h=u;break}}if(c&&h){const d=h.at===c.at?1:(i-c.at)/(h.at-c.at),u=f(c,"hz")??e.hz,y=f(h,"hz")??e.hz;o=u===y||d<=0?u:d>=1?y:Math.exp(Math.log(u)+(Math.log(y)-Math.log(u))*d);const b=f(c,"db")??0,q=f(h,"db")??0;n=b+(q-b)*d;const m=f(c,"q"),g=f(h,"q");a=m===void 0||g===void 0?m??g:m+(g-m)*d}}switch(e.type){case"peak":return{type:"peak",hz:o,db:n,...a===void 0?{}:{q:a}};case"lowshelf":case"highshelf":return{type:e.type,hz:o,db:n,...a===void 0?{}:{slope:a}};default:return{type:e.type,hz:o,...a===void 0?{}:{q:a}}}}const w=32;function O(e,i,t,o){if(!i.keys||i.keys.length===0){$(e,[k(bandAt(i,0),t)]);return}let n=0,a=0,s=k(bandAt(i,o),t);for(let f=0;f<e.length;f++){f%w===0&&(s=k(bandAt(i,o+(f+w/2)/t),t));const r=e[f]??0,l=s.b0*r+n;n=s.b1*r-s.a1*l+a,a=s.b2*r-s.a2*l,e[f]=l}}export function shapeSound(e,i,t,o=0){if(!i)return;for(const a of i.eq??[])for(const s of e)O(s,a,t,o);const n=i.compress;if(n){const a=soundLevel(e,t)?.lufs;if(a===void 0)return;const s={threshold:a+n.threshold,ratio:n.ratio??COMPRESS_DEFAULTS.ratio,knee:n.knee??COMPRESS_DEFAULTS.knee,attack:n.attack??COMPRESS_DEFAULTS.attack,release:n.release??COMPRESS_DEFAULTS.release,window:n.window??COMPRESS_DEFAULTS.window};z(e,s,t)}}export function soundLevel(e,i){const t=v(e,i);if(t!==void 0&&t>-70)return{lufs:t,by:"integrated"};const o=S(e,i);return o===void 0?void 0:{lufs:o,by:"level"}}export const shapes=e=>(e?.eq?.length??0)>0||e?.compress!==void 0;