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

package/node_modules/@allyhub-next/audio/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.

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

@@ -0,0 +1,52 @@
+/** Decibels of an amplitude (1 is full scale), rounded to 0.1, at least −120. */
+export declare const db: (x: number) => number;
+/** A stretch in seconds. */
+export interface Band {
+    start: number;
+    end: number;
+}
+export interface SilenceOptions {
+    /** Seconds of the first sample (default 0). */
+    t0?: number;
+    /** Silence is under this, dBFS (default −40). */
+    threshold?: number;
+    /** The RMS window, seconds (default 0.01). */
+    window?: number;
+    /** The shortest band, seconds (default 0.03). */
+    minLength?: number;
+}
+/**
+ * Stretches where the sound stays under `threshold` dBFS (RMS over
+ * `window` seconds) for at least `minLength` seconds.
+ */
+export declare function silenceBands(s: Float32Array, rate: number, o?: SilenceOptions): Band[];
+/** The sound at a cut, in dBFS and dB. */
+export interface CutSound {
+    /** RMS over the 10 ms around the cut. */
+    levelDb: number;
+    /** RMS over 20–150 ms before and after the cut. */
+    aroundDb: number;
+    /** The highest sample within 5 ms of the cut. */
+    peakDb: number;
+    /**
+     * The largest step between two samples within 2 ms of the cut, against
+     * the steps 5–150 ms around it (their 99th percentile, at least −60
+     * dBFS): above 0 the cut has a sharper edge than the sound beside it; a
+     * click is a large step in quiet sound. At least −60: in silence a step
+     * means nothing.
+     */
+    jumpDb: number;
+}
+/** The sound at sample `at` of `s`. */
+export declare function soundAtCut(s: Float32Array, rate: number, at: number): CutSound;
+/** Samples as `columns` [min, max] pairs, for drawing a waveform. */
+export declare function waveColumns(s: Float32Array, columns: number): [min: number, max: number][];
+/** The level in dBFS over windows of `window` seconds, each at its middle's time from `t0`. */
+export declare function levelCurve(s: Float32Array, rate: number, o?: {
+    t0?: number;
+    window?: number;
+}): {
+    t: number;
+    db: number;
+}[];
+//# sourceMappingURL=at-cut.d.ts.map

package/node_modules/@allyhub-next/audio/dist/at-cut.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+const p=t=>Math.round(t*1e3)/1e3;export const db=t=>t>1e-6?Math.round(20*Math.log10(t)*10)/10:-120;function f(t,l,o){const n=Math.max(0,l),a=Math.min(t.length,o);if(a<=n)return 0;let s=0;for(let h=n;h<a;h++){const u=t[h]??0;s+=u*u}return Math.sqrt(s/(a-n))}export function silenceBands(t,l,o={}){const n=o.t0??0,a=o.threshold??-40,s=Math.max(1,Math.round((o.window??.01)*l)),h=o.minLength??.03,u=[];let c;const i=e=>{c!==void 0&&(e-c)/l>=h-1e-9&&u.push({start:p(n+c/l),end:p(n+e/l)}),c=void 0};for(let e=0;e<t.length;e+=s){const M=db(f(t,e,e+s))<a;M&&c===void 0?c=e:M||i(e)}return i(t.length),u}export function soundAtCut(t,l,o){const n=r=>Math.round(r/1e3*l),a=db(f(t,o-n(5),o+n(5))),s=f(t,o-n(150),o-n(20)),h=f(t,o+n(20),o+n(150)),u=db(Math.sqrt((s*s+h*h)/2));let c=0;for(let r=Math.max(0,o-n(5));r<Math.min(t.length,o+n(5));r++)c=Math.max(c,Math.abs(t[r]??0));const i=r=>Math.abs((t[r]??0)-(t[r-1]??0));let e=0;for(let r=Math.max(1,o-n(2));r<=Math.min(t.length-1,o+n(2));r++)e=Math.max(e,i(r));const M=[];for(const[r,m]of[[o-n(150),o-n(5)],[o+n(5),o+n(150)]])for(let d=Math.max(1,r);d<Math.min(t.length,m);d++)M.push(i(d));M.sort((r,m)=>r-m);const x=M[Math.floor(M.length*.99)]??0,g=10**(-60/20);return{levelDb:a,aroundDb:u,peakDb:db(c),jumpDb:Math.max(-60,Math.round(20*Math.log10(Math.max(e,1e-9)/Math.max(x,g))*10)/10)}}export function waveColumns(t,l){const o=[],n=t.length/l;for(let a=0;a<l;a++){const s=Math.floor(a*n),h=Math.max(s+1,Math.floor((a+1)*n));let u=0,c=0;for(let i=s;i<Math.min(h,t.length);i++){const e=t[i]??0;e<u&&(u=e),e>c&&(c=e)}o.push([u,c])}return o}export function levelCurve(t,l,o={}){const n=Math.max(1,Math.round((o.window??.01)*l)),a=o.t0??0,s=[];for(let h=0;h<t.length;h+=n)s.push({t:a+(h+n/2)/l,db:db(f(t,h,Math.min(t.length,h+n)))});return s}

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

@@ -0,0 +1,33 @@
+import type { MixPlan, SpeechClip, Stereo } from "./plan.js";
+import type { ClipSource } from "./voice.js";
+/** How a file is decoded for the mix: a take's noise reduction and speed, a stem's filter. */
+export interface DecodeAs {
+    denoise?: number | undefined;
+    speed?: number | undefined;
+    filter?: string | undefined;
+}
+/** One file's decoding, as a key: the same file decoded alike is decoded once. */
+export declare const decodeKey: (file: string, how: DecodeAs) => string;
+/**
+ * A decoded file as the mix asks for it: its two channels, and what of
+ * the asking it was made with (`made.speed`: the take's second s is at s
+ * / speed; a speed not made is resampled, its pitch moved). The player
+ * may have a file only as recorded until the host has made it.
+ */
+export type SoundOf = (file: string, how: DecodeAs) => {
+    src: Stereo;
+    made: DecodeAs;
+} | undefined;
+/** The speech's decoding of a clip: its denoise and its speed (pitch kept). */
+export declare const speechHow: (c: SpeechClip) => DecodeAs;
+/** Every decoding a plan asks for, so a host can make them before mixing. */
+export declare function decodings(plan: MixPlan): {
+    file: string;
+    how: DecodeAs;
+}[];
+/**
+ * Each speech clip's source found: as the host made it (sped already,
+ * `stretched`), or as recorded, to be resampled.
+ */
+export declare function clipSource(sound: SoundOf): (c: SpeechClip) => ClipSource | undefined;
+//# sourceMappingURL=decode.d.ts.map

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

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+export const decodeKey=(e,i)=>`${e}\0${String(i.denoise??0)}\0${String(i.speed??1)}\0${i.filter??""}`,speechHow=e=>({...e.denoise?{denoise:e.denoise}:{},...e.speed!==void 0&&e.speed!==1?{speed:e.speed}:{}});export function decodings(e){const i=new Map,t=(s,d)=>i.set(decodeKey(s,d),{file:s,how:d});for(const s of e.speech)t(s.file,speechHow(s));for(const s of e.footage)t(s.file,{});e.music&&t(e.music.file,e.music.shape?.filter?{filter:e.music.shape.filter}:{});for(const s of e.sfx)s.file!==void 0&&t(s.file,s.shape?.filter?{filter:s.shape.filter}:{});return[...i.values()]}export function clipSource(e){return i=>{const t=e(i.file,speechHow(i));if(!t)return;const s=i.speed!==void 0&&i.speed!==1?i.speed:void 0;return s!==void 0&&t.made.speed===s?{src:t.src,stretched:s}:{src:t.src}}}

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

@@ -0,0 +1,37 @@
+import { type MixLevels } from "./levels.js";
+import type { GainPoint, Segment } from "./plan.js";
+/** A stretch of the film, seconds. */
+export interface Span {
+    start: number;
+    end: number;
+}
+/**
+ * Music gain under speech: down by `duck.db` while words are spoken,
+ * going down over `attack` before a word and back over `release` after
+ * one. Pauses shorter than `hold` stay ducked: under a narration the
+ * music is one steady bed, not a swell between every two sentences. It
+ * comes back up between paragraphs, and where nobody speaks.
+ */
+export declare function duckEnvelope(spoken: readonly Span[], duck?: MixLevels["duck"]): GainPoint[];
+/**
+ * Where speech plays on the film's clock: its segments (room tone
+ * included), with gaps shorter than a ramp down and back up joined.
+ */
+export declare function speechSpans(segments: readonly Segment[], duck?: MixLevels["duck"]): Span[];
+/**
+ * A level that changes by `depth` dB while speech plays (the spans),
+ * ramping over the duck's attack and release: music and footage go to
+ * their under-speech level only then.
+ */
+export declare function speechEnvelope(spans: readonly Span[], depth: number, duck?: MixLevels["duck"]): GainPoint[];
+/** The sum of two envelopes, exact at every point of either. */
+export declare function addEnvelopes(a: readonly GainPoint[], b: readonly GainPoint[]): GainPoint[];
+/**
+ * The gain of an equal-power fade `x` of the way through (0 to 1): two
+ * unrelated sounds cross-faded with it keep their summed power, so room
+ * tone goes over into the take's own room without a dip.
+ */
+export declare const equalPower: (x: number) => number;
+/** The envelope's gain at t, in dB: its first value before it, its last after it. */
+export declare function gainAt(points: readonly GainPoint[], t: number): number;
+//# sourceMappingURL=envelope.d.ts.map

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

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{MIX_DEFAULTS as s}from"./levels.js";function f(e,t){const n=[];for(const r of[...e].sort((a,o)=>a.start-o.start)){const a=n.at(-1);a&&r.start-a.end<t?a.end=Math.max(a.end,r.end):n.push({start:r.start,end:r.end})}return n}function u(e,t,n,r){const a=[];for(const o of e)a.push({t:Math.max(0,o.start-n),db:0},{t:o.start,db:t},{t:o.end,db:t},{t:o.end+r,db:0});return a}export function duckEnvelope(e,t=s.duck){return t.db>=0||e.length===0?[]:u(f(e,t.hold+t.attack+t.release),t.db,t.attack,t.release)}export function speechSpans(e,t=s.duck){return f(e.filter(n=>n.dur>0).map(n=>({start:n.at,end:n.at+n.dur})),t.attack+t.release)}export function speechEnvelope(e,t,n=s.duck){return t===0||e.length===0?[]:u(e,t,n.attack,n.release)}export function addEnvelopes(e,t){return e.length===0?[...t]:t.length===0?[...e]:[...new Set([...e,...t].map(r=>r.t))].sort((r,a)=>r-a).map(r=>({t:r,db:gainAt(e,r)+gainAt(t,r)}))}export const equalPower=e=>Math.sin(Math.PI/2*Math.min(1,Math.max(0,e)));export function gainAt(e,t){if(e.length===0)return 0;const n=e[0];if(!n||t<=n.t)return n?.db??0;for(let r=1;r<e.length;r++){const a=e[r-1],o=e[r];if(!(!a||!o)&&t<=o.t)return o.t===a.t?o.db:a.db+(o.db-a.db)*(t-a.t)/(o.t-a.t)}return e.at(-1)?.db??0}

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

@@ -0,0 +1,17 @@
+export { SAMPLE_RATE, type FootageClip, type GainPoint, type MixPlan, type MusicPlay, type MusicSegment, type PartSpan, type Segment, type SfxPlay, type SpeechClip, type Stereo, type VoicePlan, } from "./plan.js";
+export { addEnvelopes, duckEnvelope, equalPower, gainAt, speechEnvelope, speechSpans, type Span, } from "./envelope.js";
+export { clipSource, decodeKey, decodings, speechHow, type DecodeAs, type SoundOf, } from "./decode.js";
+export { renderMix, playSfx, type RenderOptions } from "./render.js";
+export { playMusic } from "./music.js";
+export { hashSeed, SFX_HIT, synthSfx } from "./sfx.js";
+export { addSpeech, playVoice, sumSpeech, voiceGroups, type ClipSource, type VoiceGroup, } from "./voice.js";
+export { limitPeaks, masterMix, previewMaster } from "./master.js";
+export { drySpeech, recordedSpeech, type SpeechTracks } from "./recorded.js";
+export { db, levelCurve, silenceBands, soundAtCut, waveColumns, type Band, type CutSound, type SilenceOptions, } from "./at-cut.js";
+export { MASTER_DEFAULTS, MASTER_MECHANICS, MIX_DEFAULTS, resolveMaster, resolveMix, type MasterOptions, type MasterTargets, type MixLevels, type MixOptions, } from "./levels.js";
+export { BAND_TYPES, bandAt, COMPRESS_DEFAULTS, shapeProblem, shapes, shapeSound, soundFilterProblem, soundLevel, type BandKey, type BandType, type EqBand, type FixedShape, type ResolvedShape, type SoundCompressor, type SoundMoment, type SoundShape, } from "./shape.js";
+export * from "./recording/index.js";
+export { biquad, biquadGain, BUTTERWORTH_Q, chainGain, fromDb, runBiquads, toDb, type Biquad, type FilterSpec, } from "./recording/filters.js";
+export { convolve, fft, magnitudes, minimumPhase, nextPow2, } from "./recording/fft.js";
+export { agc, compress, deess, gainComputer, type AgcOptions, type CompressorOptions, type DeesserOptions, } from "./recording/dynamics.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+export{SAMPLE_RATE}from"./plan.js";export{addEnvelopes,duckEnvelope,equalPower,gainAt,speechEnvelope,speechSpans}from"./envelope.js";export{clipSource,decodeKey,decodings,speechHow}from"./decode.js";export{renderMix,playSfx}from"./render.js";export{playMusic}from"./music.js";export{hashSeed,SFX_HIT,synthSfx}from"./sfx.js";export{addSpeech,playVoice,sumSpeech,voiceGroups}from"./voice.js";export{limitPeaks,masterMix,previewMaster}from"./master.js";export{drySpeech,recordedSpeech}from"./recorded.js";export{db,levelCurve,silenceBands,soundAtCut,waveColumns}from"./at-cut.js";export{MASTER_DEFAULTS,MASTER_MECHANICS,MIX_DEFAULTS,resolveMaster,resolveMix}from"./levels.js";export{BAND_TYPES,bandAt,COMPRESS_DEFAULTS,shapeProblem,shapes,shapeSound,soundFilterProblem,soundLevel}from"./shape.js";export*from"./recording/index.js";export{biquad,biquadGain,BUTTERWORTH_Q,chainGain,fromDb,runBiquads,toDb}from"./recording/filters.js";export{convolve,fft,magnitudes,minimumPhase,nextPow2}from"./recording/fft.js";export{agc,compress,deess,gainComputer}from"./recording/dynamics.js";

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

@@ -0,0 +1,97 @@
+/** `video({ mix })`: loudness targets of the stems (LUFS) and the music's ducking and fades. */
+export interface MixOptions {
+    /** Each part's speech; default -16. */
+    speech?: number;
+    /** The music while speech plays; default -20. */
+    music?: number;
+    /** The music where nobody speaks; default -16. */
+    musicAlone?: number;
+    /** Sound effects from files; built-in sounds move by the same amount from the default; default -22. */
+    sfx?: number;
+    /** Footage's own sound where nobody speaks; default -16. */
+    footage?: number;
+    /** Footage's own sound while speech plays; default -22. */
+    footageUnderSpeech?: number;
+    /**
+     * How the music dips under words: `db` below its level while speech
+     * plays (default -8), going down over `attack` seconds before a word
+     * (0.3), back up over `release` after one (1), and staying down
+     * through pauses shorter than `hold` (2).
+     */
+    duck?: {
+        db?: number;
+        attack?: number;
+        release?: number;
+        hold?: number;
+    };
+    /** The music's fade in at the start and out at the end, seconds; defaults 0.3 and 1.5 (at most a quarter of the video). */
+    musicFade?: {
+        in?: number;
+        out?: number;
+    };
+}
+/** The mix's settings with every default filled in. */
+export interface MixLevels {
+    speech: number;
+    music: number;
+    musicAlone: number;
+    sfx: number;
+    footage: number;
+    footageUnderSpeech: number;
+    duck: {
+        db: number;
+        attack: number;
+        release: number;
+        hold: number;
+    };
+    musicFade: {
+        in: number;
+        out: number;
+    };
+}
+export declare const MIX_DEFAULTS: MixLevels;
+/** An output's mix options over the defaults. */
+export declare function resolveMix(o: MixOptions | undefined): MixLevels;
+/** `video({ master })`: what the sum is mastered to. */
+export interface MasterOptions {
+    /**
+     * Integrated loudness, LUFS (-70 to 0); default the platform profile's,
+     * else -14. false keeps the mix's own level (peaks still limited).
+     */
+    lufs?: number | false;
+    /** True-peak ceiling, dBTP (-9 to 0); default -3 (AAC overshoots up to about 2 dB). */
+    truePeak?: number;
+}
+export declare const MASTER_DEFAULTS: {
+    readonly lufs: -14;
+    readonly truePeak: -3;
+};
+/**
+ * How the master reaches its targets, mechanics rather than options: the
+ * mix's integrated loudness is measured, one gain brings it to the target,
+ * a limiter at `oversample` times the rate holds the true peak under the
+ * ceiling (going down over `attack` seconds, back over `release`), and
+ * what came out is measured again; the gain is corrected by what the
+ * limiter took, at most `rounds` times, until the loudness is within
+ * `tolerance` LU of the target. Nothing rides the level over time: the
+ * mix keeps its loudness range.
+ */
+export declare const MASTER_MECHANICS: {
+    readonly attack: 0.002;
+    readonly release: 0.04;
+    readonly oversample: 4;
+    readonly rounds: 4;
+    readonly tolerance: 0.1;
+};
+/** The master's targets, or false to keep the mix's level (its peaks still limited to `truePeak`). */
+export interface MasterTargets {
+    lufs: number | false;
+    truePeak: number;
+}
+/**
+ * An output's `master` resolved: a number is the loudness, false keeps
+ * the mix's level, an object sets either; `profileLufs` is the platform
+ * profile's loudness, the default when the output names none.
+ */
+export declare function resolveMaster(master: number | false | MasterOptions | undefined, profileLufs?: number): MasterTargets;
+//# sourceMappingURL=levels.d.ts.map

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

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+export const MIX_DEFAULTS={speech:-16,music:-20,musicAlone:-16,sfx:-22,footage:-16,footageUnderSpeech:-22,duck:{db:-8,attack:.3,release:1,hold:2},musicFade:{in:.3,out:1.5}};export function resolveMix(e){const u=MIX_DEFAULTS;return{speech:e?.speech??u.speech,music:e?.music??u.music,musicAlone:e?.musicAlone??u.musicAlone,sfx:e?.sfx??u.sfx,footage:e?.footage??u.footage,footageUnderSpeech:e?.footageUnderSpeech??u.footageUnderSpeech,duck:{...u.duck,...e?.duck},musicFade:{...u.musicFade,...e?.musicFade}}}export const MASTER_DEFAULTS={lufs:-14,truePeak:-3},MASTER_MECHANICS={attack:.002,release:.04,oversample:4,rounds:4,tolerance:.1};export function resolveMaster(e,u){const s=u??MASTER_DEFAULTS.lufs;return e===!1?{lufs:!1,truePeak:MASTER_DEFAULTS.truePeak}:typeof e=="number"?{lufs:e,truePeak:MASTER_DEFAULTS.truePeak}:{lufs:e?.lufs??s,truePeak:e?.truePeak??MASTER_DEFAULTS.truePeak}}

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

@@ -0,0 +1,29 @@
+import { type MasterTargets } from "./levels.js";
+import type { Stereo } from "./plan.js";
+/**
+ * Holds the samples' peaks at `ceiling` (linear) in place: a gain that
+ * looks `attack` seconds ahead, comes down to what the loudest sample in
+ * that window allows, averaged over the window so it never jumps, and
+ * comes back up over `release`. The preview's limiter: it holds the
+ * samples, not the peaks between them, which the export's limiter holds
+ * at four times the rate.
+ */
+export declare function limitPeaks(bus: Stereo, ceiling: number, rate: number, attack?: number, release?: number): void;
+/**
+ * The preview's master, in place: the export's measured gain to the
+ * target loudness and a limiter at the ceiling, the gain corrected by
+ * what the limiter took (MASTER_MECHANICS). Its limiter holds samples,
+ * not true peaks, so the preview's peaks and loudness can differ from the
+ * export's by a fraction of a dB where the mix is limited hard.
+ */
+export declare function masterMix(bus: Stereo, rate: number, targets: MasterTargets): {
+    gainDb: number;
+    integrated?: number;
+};
+/**
+ * A plan's mix as the player plays it: rendered (render.ts), then
+ * mastered in place as the export is. Undefined where it is silent:
+ * nothing to master or to play.
+ */
+export declare function previewMaster(bus: Stereo, rate: number, targets: MasterTargets): Stereo | undefined;
+//# sourceMappingURL=master.d.ts.map

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

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{integratedLoudness as w}from"./recording/loudness.js";import{MASTER_MECHANICS as M}from"./levels.js";export function limitPeaks(e,s,i,m=M.attack,c=M.release){const n=e[0].length,o=Math.max(1,Math.round(m*i)),a=new Float32Array(n);for(let t=0;t<n;t++){const d=Math.max(Math.abs(e[0][t]??0),Math.abs(e[1][t]??0));a[t]=d>s?s/d:1}const r=new Float32Array(n),l=[];let f=0;for(let t=n-1;t>=0;t--){const d=a[t]??1;for(;l.length>f&&(a[l[l.length-1]??0]??1)>=d;)l.pop();for(l.push(t);(l[f]??0)>t+o;)f++;r[t]=a[l[f]??t]??1}const u=Math.exp(-1/(Math.max(c,1e-4)*i));let h=1;for(let t=0;t<n;t++)h=Math.min(r[t]??1,1-(1-h)*u),r[t]=h;let p=0;const x=new Float32Array(n);for(let t=0;t<n;t++)p+=r[t]??1,t>=o&&(p-=r[t-o]??1),x[t]=p/Math.min(o,t+1);for(let t=0;t<n;t++){const d=Math.min(x[t]??1,a[t]??1);e[0][t]=(e[0][t]??0)*d,e[1][t]=(e[1][t]??0)*d}}export function masterMix(e,s,i){const m=10**(i.truePeak/20),c=w(e,s),n=l=>{const f=10**(l/20),u=[Float32Array.from(e[0],h=>h*f),Float32Array.from(e[1],h=>h*f)];return limitPeaks(u,m,s),u};let o=i.lufs===!1||c===void 0?0:i.lufs-c,a=n(o),r=w(a,s);if(i.lufs!==!1&&c!==void 0)for(let l=1;l<M.rounds&&r!==void 0;l++){const f=i.lufs-r;if(Math.abs(f)<=M.tolerance)break;o+=f,a=n(o),r=w(a,s)}return e[0].set(a[0]),e[1].set(a[1]),{gainDb:o,...r===void 0?{}:{integrated:r}}}export function previewMaster(e,s,i){const[m,c]=e;let n=!1;for(let o=0;o<m.length&&!n;o++)n=m[o]!==0||c[o]!==0;if(n)return masterMix(e,s,i),e}

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

@@ -0,0 +1,11 @@
+import type { MusicPlay, Stereo } from "./plan.js";
+/**
+ * The music as the film plays it, at `rate`: its segments with their
+ * seams' equal-power fades, shaped by its bands and compressor, levelled
+ * (a shaped stem by its loudness as shaped, to the mix's musicAlone),
+ * then its gain over time (its dip under speech and its own points) and
+ * its fades, ending at `until` or the film's end. What the render's mix
+ * and the player add.
+ */
+export declare function playMusic(m: MusicPlay, src: Stereo, duration: number, rate: number): Stereo;
+//# sourceMappingURL=music.d.ts.map

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

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{equalPower as b,gainAt as D}from"./envelope.js";import{shapes as F,shapeSound as I,soundLevel as O}from"./shape.js";export function playMusic(f,c,M,t){const i=Math.round(M*t),o=[new Float32Array(i),new Float32Array(i)],g=c[0].length;if(g===0)return o;for(const n of f.segments){const e=Math.round(n.at*t),k=Math.round(n.from*t),r=Math.round(n.dur*t),l=Math.round(n.fadeIn*t),p=Math.round(n.fadeOut*t);for(let s=0;s<r;s++){const u=e+s,a=k+s;if(u<0||u>=i||a<0||a>=g)continue;let d=1;l>0&&s<l&&(d*=b(s/l)),p>0&&r-1-s<p&&(d*=b((r-1-s)/p)),o[0][u]=(o[0][u]??0)+(c[0][a]??0)*d,o[1][u]=(o[1][u]??0)+(c[1][a]??0)*d}}let w=f.gainDb;if(f.shape&&(F(f.shape)||f.shape.filter!==void 0)){I(o,f.shape,t,0);const n=O(o,t);n&&(w=f.alone-n.lufs)}const y=Math.round(f.fadeIn*t),A=Math.round(f.fadeOut*t),h=Math.min(i,Math.round((f.until??M)*t));for(let n=0;n<i;n++){if(n>=h){o[0][n]=0,o[1][n]=0;continue}let e=10**((w+D(f.duck,n/t))/20);n<y&&(e*=n/y),h-n<A&&(e*=(h-n)/A),o[0][n]=(o[0][n]??0)*e,o[1][n]=(o[1][n]??0)*e}return o}

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

@@ -0,0 +1,39 @@
+import { type DecodeAs, type SoundOf } from "../decode.js";
+import { type MixPlan } from "../plan.js";
+import { type FfmpegOptions } from "./ffmpeg.js";
+/**
+ * Speech clean-up: ffmpeg's FFT denoiser (afftdn) reducing the noise by
+ * `db`, tracking the noise floor as it changes.
+ */
+export declare function denoiseFilter(db: number): string;
+/**
+ * The filters that play a file's sound as the mix does: a stem's own
+ * filter chain, the denoiser, then ffmpeg's atempo (a time stretch that
+ * keeps the pitch; one filter covers 0.5 to 2). None for a file played
+ * as recorded.
+ */
+export declare function speechFilters(o: DecodeAs): string[];
+/**
+ * A file's sound denoised, sped or filtered as the mix plays it (the
+ * same filters, stereo at 48 kHz), written to `out` as FLAC: what the
+ * preview plays for a take with denoise() or speed(), or a stem with a
+ * filter.
+ */
+export declare function speechFile(path: string, out: string, how: DecodeAs, o?: FfmpegOptions): Promise<void>;
+/**
+ * A sound or video file's sound as two channels at 48 kHz (a mono file
+ * given twice), through the filters `how` asks for.
+ */
+export declare function decodeStereo(path: string, how?: DecodeAs, o?: FfmpegOptions): Promise<[Float32Array, Float32Array]>;
+/** A file's sound as one channel at `rate` (its channels mixed down), as ffmpeg resamples it. */
+export declare function decodeMono(path: string, rate: number, o?: FfmpegOptions): Promise<Float32Array>;
+/** Where the plan's files are: its name for a file (a repository path) to a path on this computer. */
+export interface MixSources {
+    file(name: string): string | undefined;
+}
+/**
+ * Every file the plan plays decoded as it asks (a take denoised and sped,
+ * a stem filtered), each once; a file that cannot be decoded is left out.
+ */
+export declare function decodePlan(plan: MixPlan, sources: MixSources, o?: FfmpegOptions): Promise<SoundOf>;
+//# sourceMappingURL=decode.d.ts.map

package/node_modules/@allyhub-next/audio/dist/node/decode.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{decodeKey as p,decodings as g}from"../decode.js";import{SAMPLE_RATE as w}from"../plan.js";import{ffmpegOf as d,floats as u,runFfmpeg as l}from"./ffmpeg.js";const m=w;export function denoiseFilter(t){return`afftdn=nr=${Math.min(Math.max(t,.01),97).toFixed(2)}:nf=-50:tn=1`}export function speechFilters(t){return[...t.filter?[t.filter]:[],...t.denoise?[denoiseFilter(t.denoise)]:[],...t.speed!==void 0&&t.speed!==1?[`atempo=${t.speed.toFixed(6)}`]:[]]}export async function speechFile(t,n,i,r={}){const c=speechFilters(i);await l(await d(r),["-v","error","-y","-i",t,"-vn",...c.length>0?["-af",c.join(",")]:[],"-ac","2","-ar",String(m),"-c:a","flac","-f","flac",n])}export async function decodeStereo(t,n={},i={}){const r=speechFilters(n),{out:c}=await l(await d(i),["-v","error","-i",t,...r.length>0?["-af",r.join(",")]:[],"-f","f32le","-ac","2","-ar",String(m),"-"],!0),o=u(c),e=Math.floor(o.length/2),a=new Float32Array(e),s=new Float32Array(e);for(let f=0;f<e;f++)a[f]=o[f*2]??0,s[f]=o[f*2+1]??0;return[a,s]}export async function decodeMono(t,n,i={}){const{out:r}=await l(await d(i),["-v","error","-i",t,"-map","0:a:0","-ac","1","-ar",String(n),"-f","f32le","-"],!0);return u(r)}export async function decodePlan(t,n,i={}){const r=await d(i),c=new Map;for(const{file:o,how:e}of g(t)){const a=n.file(o);if(!a)continue;const s=await decodeStereo(a,e,{ffmpeg:r}).catch(()=>{});s&&c.set(p(o,e),s)}return(o,e)=>{const a=c.get(p(o,e));return a?{src:a,made:e}:void 0}}

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

@@ -0,0 +1,25 @@
+/** One ebur128 measurement, every 100 ms. */
+export interface LoudnessFrame {
+    /** End of the measured window, seconds. */
+    t: number;
+    /** Momentary loudness (400 ms window), LUFS. */
+    momentary: number;
+    /** Short-term loudness (3 s window), LUFS. */
+    shortTerm: number;
+}
+/** The summary: integrated loudness (LUFS), its range (LU) and true peak (dBTP). */
+export interface LoudnessSummary {
+    /** Absent when everything is gated out: ebur128 says −70 LUFS then, nothing to hear. */
+    integrated?: number;
+    range?: number;
+    truePeak?: number;
+}
+/** A finite number in a match, or undefined (`-inf`, missing). */
+export declare function num(s: string | undefined): number | undefined;
+/** ebur128's summary, the last one in the log. */
+export declare function ebur128Summary(log: string): LoudnessSummary;
+/** ebur128's per-frame log (framelog=info) and its summary. */
+export declare function parseEbur128(log: string): LoudnessSummary & {
+    frames: LoudnessFrame[];
+};
+//# sourceMappingURL=ebur128.d.ts.map

package/node_modules/@allyhub-next/audio/dist/node/ebur128.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+export function num(e){if(e===void 0)return;const n=Number(e);return Number.isFinite(n)?n:void 0}export function ebur128Summary(e){const n=e.slice(e.lastIndexOf("Summary:")),t=num(/Integrated loudness:\s*\n\s*I:\s*(-?[\d.]+|-inf) LUFS/.exec(n)?.[1]),s=num(/Loudness range:\s*\n\s*LRA:\s*(-?[\d.]+)/.exec(n)?.[1]),r=num(/True peak:\s*\n\s*Peak:\s*(-?[\d.]+|-inf)/.exec(n)?.[1]);return{...t!==void 0&&t>-70?{integrated:t}:{},...s===void 0?{}:{range:s},...r===void 0?{}:{truePeak:r}}}export function parseEbur128(e){const n=[],t=/\bt:\s*(-?[\d.]+)\s+TARGET:.*?\bM:\s*(-?[\d.]+|-inf)\s+S:\s*(-?[\d.]+|-inf)/g;for(const s of e.matchAll(t)){const r=num(s[1]);r!==void 0&&n.push({t:r,momentary:num(s[2])??-120,shortTerm:num(s[3])??-120})}return{frames:n,...ebur128Summary(e)}}