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

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;

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

@@ -0,0 +1,45 @@
+import type { MixPlan, SpeechClip, Stereo } from "./plan.js";
+import { type ResolvedVoice, type VoiceSpan } from "./recording/chain.js";
+/** Speech recorded alike: its clips, where its parts play, and its seed. */
+export interface VoiceGroup {
+    voice: ResolvedVoice;
+    clips: SpeechClip[];
+    spans: VoiceSpan[];
+    /** The parts recorded so, in film order. */
+    parts: string[];
+    seed: number;
+}
+/**
+ * The plan's speech by how it was recorded (the part's own setting, else
+ * the video's): one group per setting, and the clips played as they are
+ * (a setting of false, or a plan without one).
+ */
+export declare function voiceGroups(plan: MixPlan): {
+    groups: VoiceGroup[];
+    dry: SpeechClip[];
+};
+/**
+ * A clip's source: its two channels, and the speed it was already made at
+ * (its second s at s / speed), when it was.
+ */
+export interface ClipSource {
+    src: Stereo;
+    stretched?: number;
+}
+/**
+ * Adds a speech clip into a voice's two channels at `rate`, as the mix
+ * places it: its stretch of the file at its place and gain, faded 10 ms at
+ * each cut or over the plan's equal-power cross-fade. `stretched` is the
+ * speed the source was already made at (its second s at s / speed); else
+ * a clip with a speed is resampled from the source as recorded.
+ */
+export declare function addSpeech(bus: Stereo, src: Stereo, c: SpeechClip, rate: number, stretched?: number): void;
+/** Speech clips summed as the mix places them, before any recording. */
+export declare function sumSpeech(clips: readonly SpeechClip[], duration: number, rate: number, sourceOf: (c: SpeechClip) => ClipSource | undefined): Stereo;
+/**
+ * A voice group's sound: its clips summed (each from `sourceOf`, with the
+ * speed it was made at, or undefined to leave it out), then played
+ * through its setting. What the render's mix and the player both add.
+ */
+export declare function playVoice(g: VoiceGroup, duration: number, rate: number, sourceOf: (c: SpeechClip) => ClipSource | undefined): Stereo;
+//# sourceMappingURL=voice.d.ts.map

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

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{equalPower as q}from"./envelope.js";import{recordVoice as D}from"./recording/chain.js";import{hashSeed as G}from"./sfx.js";export function voiceGroups(e){const c=e.voice;if(!c)return{groups:[],dry:[...e.speech]};const n=o=>(o===void 0?void 0:c.parts?.[o])??c.video,r=new Map,f=[],u=o=>{const t=JSON.stringify(o);let i=r.get(t);return i||(i={voice:o,clips:[],spans:[],parts:[],seed:G(`${c.seed}:voice:${t}`)},r.set(t,i)),i};for(const o of e.speech){const t=n(o.part);t===!1?f.push(o):u(t).clips.push(o)}for(const o of c.spans){const t=n(o.part);if(t===!1)continue;const i=u(t);i.spans.push({start:o.start,end:o.end}),i.parts.push(o.part)}return{groups:[...r.values()],dry:f}}export function addSpeech(e,c,n,r,f){const u=Math.round(n.dur*r),o=Math.round(n.at*r),t=10**(n.gainDb/20),i=Math.min(Math.round(.01*r),Math.floor(u/4)),h=s=>s===void 0||s<=0?0:Math.min(Math.round(s*r),Math.floor(u/2)),O=h(n.fadeIn),S=h(n.fadeOut),l=(s,a)=>a>0?q(s/a):i>0&&s<i?s/i:1,b=e[0].length,m=c[0].length,M=f===void 0?n.speed??1:1,g=f===void 0?n.from*r:n.from/f*r;for(let s=0;s<u;s++){const a=o+s;if(a<0||a>=b)continue;const v=M===1?Math.round(g)+s:g+s*M,p=Math.floor(v);if(p<0||p>=m)continue;const A=v-p,F=Math.min(p+1,m-1),V=t*l(s,O)*l(u-1-s,S);for(let d=0;d<2;d++){const y=c[d]??c[0],w=y[p]??0,$=y[F]??0,x=e[d]??e[0];x[a]=(x[a]??0)+(w+($-w)*A)*V}}}export function sumSpeech(e,c,n,r){const f=Math.round(c*n),u=[new Float32Array(f),new Float32Array(f)];for(const o of e){const t=r(o);t&&addSpeech(u,t.src,o,n,t.stretched)}return u}export function playVoice(e,c,n,r){const f=sumSpeech(e.clips,c,n,r);return D(f,e.voice,n,e.seed,e.spans),f}

package/node_modules/@allyhub-next/audio/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "@allyhub-next/audio",
+  "version": "0.2.0-next.1",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./node": {
+      "types": "./dist/node/index.d.ts",
+      "default": "./dist/node/index.js"
+    }
+  },
+  "private": true,
+  "license": "SEE LICENSE IN LICENSE.md"
+}

package/node_modules/@allyhub-next/formats/LICENSE

@@ -0,0 +1,241 @@
+AllyHub Software License
+
+Copyright (c) 2026 AllyHub, Inc. ("AllyHub"). All rights reserved.
+
+This software (the AllyHub command-line tool, its SDK, runtime and the
+packages they depend on) is proprietary. It is not open source.
+
+1. Permitted use. You may install and run the software, unmodified, to make,
+   check, preview and render videos and decks, including for commercial
+   purposes. What you make with it is yours.
+
+2. Restrictions. Except as this license permits or applicable law requires,
+   you may not copy, modify, adapt, translate, sublicense, sell, rent, lease,
+   publish or otherwise distribute the software, create derivative works of
+   it, or reverse engineer, decompile or disassemble it.
+
+3. Cloud services. AllyHub's cloud tools (sign-in, research, images, voice,
+   video) are separate services governed by AllyHub's terms of service.
+
+4. Trademarks. This license grants no right to use the name "AllyHub" or its
+   logos.
+
+5. No warranty. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY
+   KIND, EXPRESS OR IMPLIED, INCLUDING THE WARRANTIES OF MERCHANTABILITY,
+   FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL
+   ALLYHUB BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY ARISING FROM,
+   OUT OF OR IN CONNECTION WITH THE SOFTWARE OR ITS USE.
+
+6. Third-party code. Parts of the software are adapted from HyperFrames,
+   licensed under the Apache License, Version 2.0 (see NOTICE). Those parts
+   remain under that license, reproduced below, and nothing in this license
+   limits your rights under it.
+
+7. Starter components. The starter components in the "components" folder,
+   which "allyhub add" copies into your workspace, are licensed under the MIT
+   License (see components/LICENSE): once copied, you may change, use and
+   share them freely.
+
+--------------------------------------------------------------------------------
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.