cantor-digitalis 0.0.1

package/dist/nodes/glottal-formant.d.ts

@@ -0,0 +1,64 @@
+import type { Node } from "./types";
+export type GlottalFormantParams = {
+    /** Glottal formant centre frequency in Hz, computed as f0 / (2 * Oq) */
+    Fg: number;
+    /** Glottal formant bandwidth in Hz, computed from f0, Oq, and αm */
+    Bg: number;
+    /** Source amplitude, derived from E, Oq, and R (shimmer) */
+    Ag: number;
+};
+/**
+ * Glottal Formant (GF)
+ *
+ * The glottal formant represents the main spectral peak of the voice source,
+ * corresponding to the resonance characteristics of the glottal pulse. It is
+ * implemented as a 2-pole 1-zero digital resonant filter in series with a
+ * 1-zero differentiation filter.
+ *
+ * The transfer function (Section 3.2.1) is:
+ *
+ * GF(z) = -Ag * z^{-1} * (1 - z^{-1}) / (1 - 2R*cos(θ)*z^{-1} + R²*z^{-2})
+ *
+ * Where:
+ *   R = e^(-π * Bg * Ts)  (pole radius, Ts = sampling period)
+ *   θ = 2π * Fg * Ts      (pole angle)
+ *
+ * The filter shapes the periodic impulse train (at frequency f0) to produce
+ * the characteristic spectrum of the glottal flow derivative.
+ *
+ * Paper reference: Section 3.2.1 (filter structure), Section 4.2.2 (parameter mapping)
+ *
+ * Input parameters:
+ *   - Fg (glottal formant centre frequency) — computed as f0 / (2·Oq)
+ *   - Bg (glottal formant bandwidth) — computed from f0, Oq, and αm
+ *   - Ag (source amplitude) — derived from E, Oq, and R (shimmer)
+ *
+ * The intermediate parameters Oq (open quotient) and αm (asymmetry coefficient)
+ * are computed from T (tenseness), E (vocal effort), and M (laryngeal mechanism).
+ */
+export declare class GlottalFormant implements Node<GlottalFormantParams> {
+    private ctx;
+    private workletNode;
+    in: AudioNode;
+    out: AudioNode;
+    private constructor();
+    /** Glottal formant centre frequency AudioParam (a-rate, 20-2000 Hz) */
+    get Fg(): AudioParam;
+    /** Glottal formant bandwidth AudioParam (a-rate, 10-500 Hz) */
+    get Bg(): AudioParam;
+    /** Source amplitude AudioParam (a-rate, 0-10) */
+    get Ag(): AudioParam;
+    /**
+     * Creates a new GlottalFormant node.
+     *
+     * The AudioWorklet module is registered automatically on first use.
+     */
+    static create(ctx: AudioContext, params: GlottalFormantParams): Promise<GlottalFormant>;
+    /**
+     * Updates the glottal formant parameters.
+     * Sets AudioParams via setTargetAtTime for smooth transitions.
+     */
+    update(params: GlottalFormantParams): void;
+    destroy(): void;
+}
+//# sourceMappingURL=glottal-formant.d.ts.map

package/dist/nodes/glottal-formant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glottal-formant.d.ts","sourceRoot":"","sources":["../../src/nodes/glottal-formant.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAEpC,MAAM,MAAM,oBAAoB,GAAG;IACjC,wEAAwE;IACxE,EAAE,EAAE,MAAM,CAAC;IACX,oEAAoE;IACpE,EAAE,EAAE,MAAM,CAAC;IACX,4DAA4D;IAC5D,EAAE,EAAE,MAAM,CAAC;CACZ,CAAC;AAqHF;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,qBAAa,cAAe,YAAW,IAAI,CAAC,oBAAoB,CAAC;IAC/D,OAAO,CAAC,GAAG,CAAe;IAC1B,OAAO,CAAC,WAAW,CAAmB;IAC/B,EAAE,EAAE,SAAS,CAAC;IACd,GAAG,EAAE,SAAS,CAAC;IAEtB,OAAO;IAOP,uEAAuE;IACvE,IAAI,EAAE,IAAI,UAAU,CAEnB;IAED,+DAA+D;IAC/D,IAAI,EAAE,IAAI,UAAU,CAEnB;IAED,iDAAiD;IACjD,IAAI,EAAE,IAAI,UAAU,CAEnB;IAED;;;;OAIG;WACU,MAAM,CACjB,GAAG,EAAE,YAAY,EACjB,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,cAAc,CAAC;IAU1B;;;OAGG;IACH,MAAM,CAAC,MAAM,EAAE,oBAAoB,GAAG,IAAI;IAM1C,OAAO,IAAI,IAAI;CAGhB"}

package/dist/nodes/noise-source.d.ts

@@ -0,0 +1,51 @@
+import type { Node } from "./types";
+export type NoiseSourceParams = {
+    /** Noise amplitude, derived directly from B (breathiness) */
+    An: number;
+};
+/**
+ * Noise Source (NS)
+ *
+ * The noise source provides the aspiration component for breathy voice qualities.
+ * It consists of Gaussian white noise filtered through a bandpass filter
+ * (Butterworth, 1000–6000 Hz cutoff frequencies) and scaled by an amplitude factor.
+ *
+ * The noise can be modulated by the glottal flow derivative for mixed voice
+ * qualities (not implemented in this basic version).
+ *
+ * Paper reference: Section 3.2.3 (filter structure), Section 4.2.5 (parameter mapping)
+ *
+ * Input parameters:
+ *   - An (noise amplitude) — derived directly from B (breathiness), with
+ *     scaling by E when voicing is off
+ *
+ * Signal flow:
+ *   Gaussian Noise → Highpass (1000 Hz) → Lowpass (6000 Hz) → Output
+ *
+ * The bandpass is implemented as a cascade of 2nd-order Butterworth highpass
+ * and lowpass filters using native BiquadFilterNodes.
+ */
+export declare class NoiseSource implements Node<NoiseSourceParams> {
+    private ctx;
+    private workletNode;
+    private highpassFilter;
+    private lowpassFilter;
+    in: AudioNode | null;
+    out: AudioNode;
+    private constructor();
+    /** Noise amplitude AudioParam (a-rate, 0-1) */
+    get An(): AudioParam;
+    /**
+     * Creates a new NoiseSource node.
+     *
+     * The AudioWorklet module is registered automatically on first use.
+     */
+    static create(ctx: AudioContext, params: NoiseSourceParams): Promise<NoiseSource>;
+    /**
+     * Updates the noise source amplitude.
+     * Sets AudioParam via setTargetAtTime for smooth transitions.
+     */
+    update(params: NoiseSourceParams): void;
+    destroy(): void;
+}
+//# sourceMappingURL=noise-source.d.ts.map

package/dist/nodes/noise-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"noise-source.d.ts","sourceRoot":"","sources":["../../src/nodes/noise-source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAEpC,MAAM,MAAM,iBAAiB,GAAG;IAC9B,6DAA6D;IAC7D,EAAE,EAAE,MAAM,CAAC;CACZ,CAAC;AA0FF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,WAAY,YAAW,IAAI,CAAC,iBAAiB,CAAC;IACzD,OAAO,CAAC,GAAG,CAAe;IAC1B,OAAO,CAAC,WAAW,CAAmB;IACtC,OAAO,CAAC,cAAc,CAAmB;IACzC,OAAO,CAAC,aAAa,CAAmB;IAEjC,EAAE,EAAE,SAAS,GAAG,IAAI,CAAQ;IAC5B,GAAG,EAAE,SAAS,CAAC;IAEtB,OAAO;IAaP,+CAA+C;IAC/C,IAAI,EAAE,IAAI,UAAU,CAEnB;IAED;;;;OAIG;WACU,MAAM,CACjB,GAAG,EAAE,YAAY,EACjB,MAAM,EAAE,iBAAiB,GACxB,OAAO,CAAC,WAAW,CAAC;IA6BvB;;;OAGG;IACH,MAAM,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI;IAIvC,OAAO,IAAI,IAAI;CAKhB"}

package/dist/nodes/pulse-train.d.ts

@@ -0,0 +1,51 @@
+import type { Node } from "./types";
+export type PulseTrainParams = {
+    /** Fundamental frequency in Hz (derived from P, P₀) */
+    f0: number;
+    /** Jitter depth: maximum f₀ perturbation as a fraction (0-0.3 for ±30%) */
+    jitterDepth: number;
+    /** Shimmer depth: maximum amplitude perturbation as a fraction (0-1 for ±100%) */
+    shimmerDepth: number;
+};
+/**
+ * Pulse Train (Voiced Excitation Source)
+ *
+ * Generates a periodic impulse train at the fundamental frequency f₀,
+ * with integrated jitter (f₀ perturbation) and shimmer (amplitude perturbation)
+ * for roughness simulation.
+ *
+ * In the spectral domain, the unperturbed output is a Dirac comb: Σδ(f − n·f₀),
+ * representing energy at each harmonic frequency. Jitter spreads energy around
+ * harmonics, and shimmer modulates the overall amplitude cycle-to-cycle.
+ *
+ * The impulse train is the input to the glottal formant filter, which shapes
+ * each impulse into the characteristic glottal pulse waveform.
+ *
+ * Paper reference: Section 3.1 (spectral equation showing the Dirac comb term),
+ *                  Section 4.1.2 (jitter), Section 4.2.4 (shimmer)
+ *
+ * Input parameters:
+ *   - f0: Fundamental frequency in Hz
+ *   - jitterDepth: Maximum f₀ perturbation (0-0.3 for up to ±30%)
+ *   - shimmerDepth: Maximum amplitude perturbation (0-1 for up to ±100%)
+ */
+export declare class PulseTrain implements Node<PulseTrainParams> {
+    private ctx;
+    private workletNode;
+    private gain;
+    in: null;
+    out: AudioNode;
+    private constructor();
+    /** Fundamental frequency AudioParam (a-rate, 20-20000 Hz) */
+    get f0(): AudioParam;
+    /** Jitter depth AudioParam (k-rate, 0-0.3) */
+    get jitterDepth(): AudioParam;
+    /** Shimmer depth AudioParam (k-rate, 0-1) */
+    get shimmerDepth(): AudioParam;
+    static create(ctx: AudioContext, params: PulseTrainParams): Promise<PulseTrain>;
+    update(params: PulseTrainParams): void;
+    destroy(): void;
+    start(): void;
+    stop(): void;
+}
+//# sourceMappingURL=pulse-train.d.ts.map

package/dist/nodes/pulse-train.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pulse-train.d.ts","sourceRoot":"","sources":["../../src/nodes/pulse-train.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAGpC,MAAM,MAAM,gBAAgB,GAAG;IAC7B,uDAAuD;IACvD,EAAE,EAAE,MAAM,CAAC;IACX,2EAA2E;IAC3E,WAAW,EAAE,MAAM,CAAC;IACpB,kFAAkF;IAClF,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AA2LF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,UAAW,YAAW,IAAI,CAAC,gBAAgB,CAAC;IACvD,OAAO,CAAC,GAAG,CAAe;IAC1B,OAAO,CAAC,WAAW,CAAmB;IACtC,OAAO,CAAC,IAAI,CAAO;IAEZ,EAAE,EAAE,IAAI,CAAC;IACT,GAAG,EAAE,SAAS,CAAC;IAEtB,OAAO;IAQP,6DAA6D;IAC7D,IAAI,EAAE,IAAI,UAAU,CAEnB;IAED,8CAA8C;IAC9C,IAAI,WAAW,IAAI,UAAU,CAE5B;IAED,6CAA6C;IAC7C,IAAI,YAAY,IAAI,UAAU,CAE7B;WAEY,MAAM,CAAC,GAAG,EAAE,YAAY,EAAE,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC;IAcrF,MAAM,CAAC,MAAM,EAAE,gBAAgB;IAM/B,OAAO;IAKP,KAAK;IAIL,IAAI;CAGL"}

package/dist/nodes/spectral-tilt.d.ts

@@ -0,0 +1,69 @@
+import type { Node } from "./types";
+export type SpectralTiltParams = {
+    /** First stage attenuation in dB at 3000 Hz, derived from E and M */
+    Tl1: number;
+    /** Second stage attenuation in dB at 3000 Hz, derived from E and M */
+    Tl2: number;
+};
+/**
+ * Spectral Tilt (ST)
+ *
+ * The spectral tilt filter models the high-frequency roll-off of the glottal
+ * source spectrum. Louder, more pressed phonation has less spectral tilt
+ * (brighter sound), while softer or breathier phonation has more tilt
+ * (darker sound).
+ *
+ * It is implemented as a cascade of two 1-pole 1-zero low-pass filters, each
+ * providing attenuation specified in dB at 3000 Hz.
+ *
+ * The transfer function (Section 3.2.2) is:
+ *
+ * ST(z) = ST₁(z) × ST₂(z)
+ *
+ * Where each stage is:
+ * STᵢ(z) = (1 - aᵢ) / (1 - aᵢ·z⁻¹)
+ *
+ * With:
+ *   aᵢ = νᵢ - √(νᵢ² - 1)
+ *   νᵢ = 1 + (1 - cos(2π·3000·Ts)) / (10^(Tlᵢ/10) - 1)
+ *
+ * Paper reference: Section 3.2.2 (filter structure), Section 4.2.3 (parameter mapping)
+ *
+ * Input parameters:
+ *   - Tl₁ (first tilt stage attenuation in dB at 3 kHz) — derived from E and M
+ *   - Tl₂ (second tilt stage attenuation in dB at 3 kHz) — derived from E and M
+ *
+ * Parameter mapping from Section 4.2.3:
+ *   For M=1 (chest voice):
+ *     Tl₁ = 27 - 21·Ep dB
+ *     Tl₂ = 11 - 11·Ep dB
+ *   For M=2 (falsetto):
+ *     Tl₁ = 45 - 36·Ep dB
+ *     Tl₂ = 20 - 18.5·Ep dB
+ *
+ * Where Ep is the perturbed vocal effort (E with heartbeat and slow perturbations).
+ */
+export declare class SpectralTilt implements Node<SpectralTiltParams> {
+    private ctx;
+    private workletNode;
+    in: AudioNode;
+    out: AudioNode;
+    private constructor();
+    /** First stage spectral tilt attenuation AudioParam (k-rate, 0-50 dB at 3kHz) */
+    get Tl1(): AudioParam;
+    /** Second stage spectral tilt attenuation AudioParam (k-rate, 0-30 dB at 3kHz) */
+    get Tl2(): AudioParam;
+    /**
+     * Creates a new SpectralTilt node.
+     *
+     * The AudioWorklet module is registered automatically on first use.
+     */
+    static create(ctx: AudioContext, params: SpectralTiltParams): Promise<SpectralTilt>;
+    /**
+     * Updates the spectral tilt parameters.
+     * Sets AudioParams via setTargetAtTime for smooth transitions.
+     */
+    update(params: SpectralTiltParams): void;
+    destroy(): void;
+}
+//# sourceMappingURL=spectral-tilt.d.ts.map

package/dist/nodes/spectral-tilt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spectral-tilt.d.ts","sourceRoot":"","sources":["../../src/nodes/spectral-tilt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAEpC,MAAM,MAAM,kBAAkB,GAAG;IAC/B,qEAAqE;IACrE,GAAG,EAAE,MAAM,CAAC;IACZ,sEAAsE;IACtE,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAwIF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,qBAAa,YAAa,YAAW,IAAI,CAAC,kBAAkB,CAAC;IAC3D,OAAO,CAAC,GAAG,CAAe;IAC1B,OAAO,CAAC,WAAW,CAAmB;IAC/B,EAAE,EAAE,SAAS,CAAC;IACd,GAAG,EAAE,SAAS,CAAC;IAEtB,OAAO;IAOP,iFAAiF;IACjF,IAAI,GAAG,IAAI,UAAU,CAEpB;IAED,kFAAkF;IAClF,IAAI,GAAG,IAAI,UAAU,CAEpB;IAED;;;;OAIG;WACU,MAAM,CACjB,GAAG,EAAE,YAAY,EACjB,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,YAAY,CAAC;IAUxB;;;OAGG;IACH,MAAM,CAAC,MAAM,EAAE,kBAAkB,GAAG,IAAI;IAKxC,OAAO,IAAI,IAAI;CAGhB"}

package/dist/nodes/types.d.ts

@@ -0,0 +1,10 @@
+export interface Node<T extends Record<string, any>> {
+    update(params: T): void;
+    destroy(): void;
+    in: AudioNode | null;
+    out: AudioNode | null;
+}
+export interface NodeStatic<T extends Record<string, any>> {
+    create(ctx: AudioContext, params: T): Node<T>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/nodes/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/nodes/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,IAAI,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IACjD,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC;IACxB,OAAO,IAAI,IAAI,CAAC;IAEhB,EAAE,EAAE,SAAS,GAAG,IAAI,CAAC;IACrB,GAAG,EAAE,SAAS,GAAG,IAAI,CAAC;CACvB;AAED,MAAM,WAAW,UAAU,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IACvD,MAAM,CAAE,GAAG,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;CAChD"}

package/dist/nodes/vocal-tract.d.ts

@@ -0,0 +1,83 @@
+import type { Node } from "./types";
+import { FormantResonator, FormantResonatorParams } from "./formant-resonator";
+import { AntiResonance } from "./anti-resonance";
+export type VocalTractParams = {
+    /** Array of formant parameters (F, B, A) for each resonator */
+    formants: FormantResonatorParams[];
+    /** Anti-formant centre frequency in Hz (nominally 4700 Hz, scaled by αS) */
+    F_BQ: number;
+    /** Anti-formant quality factor (nominally 2.5) */
+    Q_BQ: number;
+};
+/**
+ * Vocal Tract Model
+ *
+ * The vocal tract model shapes the glottal source spectrum to produce
+ * recognisable vowels and voice timbres. It consists of parallel formant
+ * resonators (simulating the resonances of the oral cavity) followed by
+ * a cascaded anti-resonance filter (simulating the effect of the hypo-pharynx).
+ *
+ * Signal flow:
+ *
+ *              ┌─→ R1(F1, B1, A1) ─┐
+ *              ├─→ R2(F2, B2, A2) ─┤
+ *   Input ─────┼─→ R3(F3, B3, A3) ─┼─────→ BQ(F_BQ, Q_BQ) ─────→ Output
+ *              ├─→ ...            ─┤
+ *              └─→ Rn(Fn, Bn, An) ─┘
+ *
+ * The paper uses six formants (R1-R6):
+ *   - F1-F3: Primary formants that determine vowel identity
+ *   - F4-F6: Higher formants that contribute to voice timbre
+ *
+ * The anti-resonance (BQ) models spectral dips caused by the hypo-pharynx
+ * cavity at approximately 2.5–3.5 kHz and 4–5 kHz.
+ *
+ * Paper reference: Section 3.3 (overall structure), Section 3.3.1 (formants),
+ *                  Section 3.3.2 (anti-resonance)
+ *
+ * Input parameters:
+ *   - formants: Array of {F, B, A} objects for each resonator
+ *   - F_BQ: Anti-formant centre frequency (nominally 4700 Hz, scaled by αS)
+ *   - Q_BQ: Anti-formant quality factor (nominally 2.5)
+ */
+export declare class VocalTract implements Node<VocalTractParams> {
+    private formantBank;
+    private antiResonance;
+    in: AudioNode;
+    out: AudioNode;
+    private constructor();
+    /**
+     * Creates a new VocalTract node.
+     *
+     * Sets up the parallel formant bank followed by the anti-resonance filter.
+     */
+    static create(ctx: AudioContext, params: VocalTractParams): Promise<VocalTract>;
+    /**
+     * Updates all vocal tract parameters.
+     *
+     * @throws Error if the formants array length doesn't match the original
+     */
+    update(params: VocalTractParams): void;
+    /**
+     * Returns the number of formant resonators in the vocal tract.
+     */
+    get formantCount(): number;
+    /**
+     * Returns the array of formant resonators for direct AudioParam access.
+     *
+     * Example usage:
+     *   vocalTract.formants[0].F.setValueAtTime(800, ctx.currentTime);
+     *   vocalTract.formants[2].B.linearRampToValueAtTime(100, ctx.currentTime + 0.1);
+     */
+    get formants(): readonly FormantResonator[];
+    /**
+     * Returns the anti-resonance node for direct AudioParam access.
+     *
+     * Example usage:
+     *   vocalTract.antiResonanceNode.F.setValueAtTime(4500, ctx.currentTime);
+     *   vocalTract.antiResonanceNode.Q.setValueAtTime(3, ctx.currentTime);
+     */
+    get antiResonanceNode(): AntiResonance;
+    destroy(): void;
+}
+//# sourceMappingURL=vocal-tract.d.ts.map

package/dist/nodes/vocal-tract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vocal-tract.d.ts","sourceRoot":"","sources":["../../src/nodes/vocal-tract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAEpC,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC/E,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,+DAA+D;IAC/D,QAAQ,EAAE,sBAAsB,EAAE,CAAC;IACnC,4EAA4E;IAC5E,IAAI,EAAE,MAAM,CAAC;IACb,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,qBAAa,UAAW,YAAW,IAAI,CAAC,gBAAgB,CAAC;IACvD,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,aAAa,CAAgB;IAE9B,EAAE,EAAE,SAAS,CAAC;IACd,GAAG,EAAE,SAAS,CAAC;IAEtB,OAAO;IAUP;;;;OAIG;WACU,MAAM,CACjB,GAAG,EAAE,YAAY,EACjB,MAAM,EAAE,gBAAgB,GACvB,OAAO,CAAC,UAAU,CAAC;IAatB;;;;OAIG;IACH,MAAM,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI;IAKtC;;OAEG;IACH,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED;;;;;;OAMG;IACH,IAAI,QAAQ,IAAI,SAAS,gBAAgB,EAAE,CAE1C;IAED;;;;;;OAMG;IACH,IAAI,iBAAiB,IAAI,aAAa,CAErC;IAED,OAAO,IAAI,IAAI;CAIhB"}

package/dist/nodes/voice.d.ts

@@ -0,0 +1,102 @@
+import type { Node } from "./types";
+import { GlottalFlowDerivative } from "./glottal-flow-derivative";
+import { VocalTract } from "./vocal-tract";
+import { Gain } from "./gain";
+import { SynthParams } from "../parameters";
+/**
+ * Voice Synthesizer
+ *
+ * The complete voice synthesis pipeline combining the glottal flow derivative
+ * (voice source) with the vocal tract model (formant filtering). This implements
+ * the full source-filter model described in the paper.
+ *
+ * Signal flow:
+ *
+ *   ┌─────────────────────────────────────────────────────────────────────────┐
+ *   │ Glottal Flow Derivative (Source)                                        │
+ *   │                                                                         │
+ *   │   PulseTrain(f0) → GlottalFormant(Fg,Bg,Ag) → SpectralTilt(Tl1,Tl2) ─┬─┤
+ *   │                                                          ↓ (mod)     │ │
+ *   │   NoiseSource(An) ──────────────────────────────────→ [×] ───────────┘ │
+ *   └─────────────────────────────────────────────────────────────────────────┘
+ *                                        │
+ *                                        ↓
+ *   ┌─────────────────────────────────────────────────────────────────────────┐
+ *   │ Vocal Tract (Filter)                                                    │
+ *   │                                                                         │
+ *   │            ┌─→ R1(F1, B1, A1) ─┐                                        │
+ *   │            ├─→ R2(F2, B2, A2) ─┤                                        │
+ *   │   Input ───┼─→ R3(F3, B3, A3) ─┼───→ BQ(F_BQ, Q_BQ) ───→ Output        │
+ *   │            ├─→ ...            ─┤                                        │
+ *   │            └─→ Rn(Fn, Bn, An) ─┘                                        │
+ *   └─────────────────────────────────────────────────────────────────────────┘
+ *                                        │
+ *                                        ↓
+ *                                   OutputGain ───→ Output
+ *
+ * Paper reference: Section 3.1 (overall model), Section 3.2 (voice source),
+ *                  Section 3.3 (vocal tract)
+ *
+ * Input parameters:
+ *   - source: GlottalFlowDerivativeParams (f0, Fg, Bg, Ag, Tl1, Tl2, An)
+ *   - tract: VocalTractParams (formants array, F_BQ, Q_BQ)
+ *   - outputGain: Overall output level (optional, defaults to 1)
+ */
+export declare class Voice implements Node<SynthParams> {
+    private glottalFlowDerivative;
+    private vocalTract;
+    private outputGainNode;
+    in: AudioNode | null;
+    out: AudioNode;
+    private constructor();
+    /**
+     * Creates a new Voice synthesizer node.
+     *
+     * Sets up the complete source-filter synthesis pipeline.
+     */
+    static create(ctx: AudioContext, params: SynthParams): Promise<Voice>;
+    /**
+     * Updates all voice parameters.
+     *
+     * @throws Error if the formants array length doesn't match the original
+     */
+    update(params: SynthParams): void;
+    /**
+     * Starts the voice (begins voiced excitation).
+     */
+    start(): void;
+    /**
+     * Stops the voice (stops voiced excitation).
+     * Note: Noise component continues based on An parameter.
+     */
+    stop(): void;
+    /**
+     * Returns the number of formant resonators in the vocal tract.
+     */
+    get formantCount(): number;
+    /**
+     * Returns the glottal flow derivative node for direct AudioParam access.
+     *
+     * Example usage:
+     *   voice.source.pulseTrainNode.f0.setValueAtTime(440, ctx.currentTime);
+     *   voice.source.glottalFormantNode.Ag.setTargetAtTime(0.5, ctx.currentTime, 0.1);
+     */
+    get source(): GlottalFlowDerivative;
+    /**
+     * Returns the vocal tract node for direct AudioParam access.
+     *
+     * Example usage:
+     *   voice.tract.formants[0].F.linearRampToValueAtTime(800, ctx.currentTime + 0.1);
+     *   voice.tract.antiResonanceNode.F.setValueAtTime(4500, ctx.currentTime);
+     */
+    get tract(): VocalTract;
+    /**
+     * Returns the output gain node for direct AudioParam access.
+     *
+     * Example usage:
+     *   voice.outputGain.gain.linearRampToValueAtTime(0.5, ctx.currentTime + 1);
+     */
+    get outputGain(): Gain;
+    destroy(): void;
+}
+//# sourceMappingURL=voice.d.ts.map

package/dist/nodes/voice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice.d.ts","sourceRoot":"","sources":["../../src/nodes/voice.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,qBAAa,KAAM,YAAW,IAAI,CAAC,WAAW,CAAC;IAC7C,OAAO,CAAC,qBAAqB,CAAwB;IACrD,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,cAAc,CAAO;IAEtB,EAAE,EAAE,SAAS,GAAG,IAAI,CAAQ;IAC5B,GAAG,EAAE,SAAS,CAAC;IAEtB,OAAO;IAWP;;;;OAIG;WACU,MAAM,CACjB,GAAG,EAAE,YAAY,EACjB,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,KAAK,CAAC;IAejB;;;;OAIG;IACH,MAAM,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAQjC;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;;OAGG;IACH,IAAI,IAAI,IAAI;IAIZ;;OAEG;IACH,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED;;;;;;OAMG;IACH,IAAI,MAAM,IAAI,qBAAqB,CAElC;IAED;;;;;;OAMG;IACH,IAAI,KAAK,IAAI,UAAU,CAEtB;IAED;;;;;OAKG;IACH,IAAI,UAAU,IAAI,IAAI,CAErB;IAED,OAAO,IAAI,IAAI;CAKhB"}

package/dist/parameters/index.d.ts

@@ -0,0 +1,111 @@
+/**
+ * Perceptual and Synth Parameters
+ *
+ * There are high-level, user-controllable parameters for the voice synthesiser.
+ * They map to the perceptually meaningful dimensions described in Section 2.1 of the paper.
+ * These are converted to the low-level synthesis parameters required by
+ * the voice engine using the generateSynthParams function.
+ *
+ * All normalised parameters range from 0 to 1 unless otherwise noted.
+ */
+export type SynthFormant = {
+    /** Formant centre frequency in Hz */
+    F: number;
+    /** Formant bandwidth in Hz */
+    B: number;
+    /** Formant amplitude (linear gain) */
+    A: number;
+};
+export type SynthParams = {
+    /** Fundamental frequency in Hz */
+    f0: number;
+    /** Glottal formant centre frequency in Hz */
+    Fg: number;
+    /** Glottal formant bandwidth in Hz */
+    Bg: number;
+    /** Source amplitude */
+    Ag: number;
+    /** First stage spectral tilt attenuation in dB at 3 kHz */
+    Tl1: number;
+    /** Second stage spectral tilt attenuation in dB at 3 kHz */
+    Tl2: number;
+    /** Noise amplitude */
+    An: number;
+    /** Jitter depth: maximum f₀ perturbation as a fraction (0-0.3 for ±30%) */
+    jitterDepth: number;
+    /** Shimmer depth: maximum amplitude perturbation as a fraction (0-1 for ±100%) */
+    shimmerDepth: number;
+    /** Array of formant parameters (F, B, A) for each resonator */
+    formants: SynthFormant[];
+    /** Anti-formant centre frequency in Hz */
+    F_BQ: number;
+    /** Anti-formant quality factor */
+    Q_BQ: number;
+    /** Overall output gain (linear) */
+    outputGain?: number;
+};
+export type PerceptualParams = {
+    /** (P) Normalised melodic position across the pitch range (0-1) */
+    pitch: number;
+    /** (P₀) Base MIDI note number (e.g., 48 for C3, 60 for C4) */
+    pitchOffset: number;
+    /** (E) Perceived force/dynamics of the voice (0-1) */
+    vocalEffort: number;
+    /** (H) Vertical tongue position: 0 = close (e.g., /i/, /u/), 1 = open (e.g., /a/) */
+    vowelHeight: number;
+    /** (V) Horizontal tongue position: 0 = back (e.g., /u/), 1 = front (e.g., /i/) */
+    vowelBackness: number;
+    /** (T) Degree of vocal fold adduction: 0 = lax, 1 = tense */
+    tenseness: number;
+    /** (B) Amount of aspiration noise (0-1) */
+    breathiness: number;
+    /** (R) Structural aperiodicities causing jitter/shimmer (0-1) */
+    roughness: number;
+    /** (S) Apparent size of the vocal tract: 0 = small/child, 1 = large/giant */
+    vocalTractSize: number;
+    /** (M) Vocal fold vibration mode: false = chest voice (M1), true = falsetto (M2) */
+    isFalsetto: boolean;
+};
+/**
+ * Feature flags for the voice parameter conversion.
+ * All features are enabled by default (true). Set to false to disable.
+ */
+export type SynthFeatures = {
+    /**
+     * Attenuate formant amplitudes when harmonics coincide with formant frequencies.
+     * Paper reference: Section 4.3.7
+     */
+    harmonicCoincidenceAttenuation?: boolean;
+    /**
+     * Scale formant frequencies by larynx position factor (K) and vocal tract size (αS).
+     * Paper reference: Sections 4.3.2, 4.3.3
+     */
+    formantFrequencyScaling?: boolean;
+    /**
+     * Raise F1 with vocal effort and constrain it above f₀ + 50 Hz.
+     * Paper reference: Section 4.3.4
+     */
+    f1Tuning?: boolean;
+    /**
+     * Constrain F2 above 2·f₀ + 50 Hz.
+     * Paper reference: Section 4.3.5
+     */
+    f2Tuning?: boolean;
+    /**
+     * Scale the anti-resonance frequency (F_BQ) by vocal tract size (αS).
+     * When disabled, uses nominal 4700 Hz.
+     */
+    antiResonanceScaling?: boolean;
+};
+/**
+ * Converts high-level perceptually relevant voice parameters to internal synthesizer parameters.
+ *
+ * This implements the parameter mapping rules from Section 4 of the paper,
+ * converting perceptually meaningful high-level parameters to the low-level
+ * synthesis parameters needed by the voice engine.
+ *
+ * @param params - The high-level, perceptual voice parameters
+ * @param features - Optional feature flags to enable/disable specific behaviours (all enabled by default)
+ */
+export declare function generateSynthParams(params: PerceptualParams, features?: SynthFeatures): SynthParams;
+//# sourceMappingURL=index.d.ts.map

package/dist/parameters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/parameters/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,MAAM,MAAM,YAAY,GAAG;IACzB,qCAAqC;IACrC,CAAC,EAAE,MAAM,CAAC;IACV,8BAA8B;IAC9B,CAAC,EAAE,MAAM,CAAC;IACV,sCAAsC;IACtC,CAAC,EAAE,MAAM,CAAC;CACX,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,kCAAkC;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,6CAA6C;IAC7C,EAAE,EAAE,MAAM,CAAC;IACX,sCAAsC;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,uBAAuB;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,2DAA2D;IAC3D,GAAG,EAAE,MAAM,CAAC;IACZ,4DAA4D;IAC5D,GAAG,EAAE,MAAM,CAAC;IACZ,sBAAsB;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,2EAA2E;IAC3E,WAAW,EAAE,MAAM,CAAC;IACpB,kFAAkF;IAClF,YAAY,EAAE,MAAM,CAAC;IACrB,+DAA+D;IAC/D,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B,mEAAmE;IACnE,KAAK,EAAE,MAAM,CAAC;IACd,8DAA8D;IAC9D,WAAW,EAAE,MAAM,CAAC;IACpB,sDAAsD;IACtD,WAAW,EAAE,MAAM,CAAC;IACpB,qFAAqF;IACrF,WAAW,EAAE,MAAM,CAAC;IACpB,kFAAkF;IAClF,aAAa,EAAE,MAAM,CAAC;IACtB,6DAA6D;IAC7D,SAAS,EAAE,MAAM,CAAC;IAClB,2CAA2C;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,iEAAiE;IACjE,SAAS,EAAE,MAAM,CAAC;IAClB,6EAA6E;IAC7E,cAAc,EAAE,MAAM,CAAC;IACvB,oFAAoF;IACpF,UAAU,EAAE,OAAO,CAAC;CACrB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B;;;OAGG;IACH,8BAA8B,CAAC,EAAE,OAAO,CAAC;IACzC;;;OAGG;IACH,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;OAGG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC,CAAC;AA2KF;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,gBAAgB,EACxB,QAAQ,GAAE,aAAkB,GAC3B,WAAW,CA+Fb"}

package/dist/parameters/vowels.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Vowel formant data from Cantor Digitalis Table 3
+ *
+ * Reference: Section 4.3.1 "Generic Formant Values"
+ *
+ * The sixth formant is derived: F6 = 2*F4, A6 = -15 dB, B6 = 150 Hz
+ */
+export interface Formant {
+    frequency: number;
+    amplitude: number;
+    bandwidth: number;
+}
+export interface VowelData {
+    ipa: string;
+    v: number;
+    h: number;
+    formants: [Formant, Formant, Formant, Formant, Formant, Formant];
+}
+/**
+ * Interpolate formants for arbitrary vowel coordinates using bilinear interpolation.
+ *
+ * @param v - Vowel backness (0 = back, 1 = front)
+ * @param h - Vowel height (0 = close, 1 = open)
+ * @returns Interpolated formant array
+ */
+export declare function interpolateFormants(v: number, h: number): [Formant, Formant, Formant, Formant, Formant, Formant];
+export declare const vowels: VowelData[];
+//# sourceMappingURL=vowels.d.ts.map

package/dist/parameters/vowels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vowels.d.ts","sourceRoot":"","sources":["../../src/parameters/vowels.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,OAAO;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;CAClE;AAgDD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,GACR,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CA4CxD;AAED,eAAO,MAAM,MAAM,EAAE,SAAS,EAmI7B,CAAC"}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "cantor-digitalis",
+  "version": "0.0.1",
+  "description": "A physically-informed source-filter model for singing voice synthesis using the Web Audio API",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "dev": "vite",
+    "build": "npm run build:lib",
+    "build:lib": "vite build --mode lib && tsc -p tsconfig.build.json",
+    "build:example": "vite build",
+    "preview": "vite preview",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build:lib"
+  },
+  "keywords": [
+    "audio",
+    "web-audio",
+    "synthesizer",
+    "voice",
+    "singing",
+    "speech",
+    "formant",
+    "source-filter"
+  ],
+  "author": "Edward Browncross",
+  "license": "ISC",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/edwardbrowncross/cantor-digitalis.git"
+  },
+  "homepage": "https://edwardbrowncross.github.io/cantor-digitalis/",
+  "bugs": {
+    "url": "https://github.com/edwardbrowncross/cantor-digitalis/issues"
+  },
+  "devDependencies": {
+    "@types/node": "^25.0.10",
+    "typescript": "^5.9.3",
+    "vite": "^6.4.1"
+  }
+}