textmode.synth.js 1.0.0-beta.1 → 1.0.0-beta.3

package/dist/types/core/ISynthSource.d.ts

@@ -1,4 +1,10 @@
 import type { SynthParameterValue } from './types';
+/**
+ * Interface defining all chainable methods available on SynthSource.
+ *
+ * This interface serves as the authoritative documentation for all
+ * synthesis methods.
+ */
 export interface ISynthSource {
     /**
      * Map character indices to a specific character set.
@@ -12,8 +18,8 @@ export interface ISynthSource {
      * // Map noise values to ASCII art characters
      * noise(10).charMap('@#%*+=-:. ')
      *
-     * // Use block characters
-     * osc(1).charMap(' .:-=+*#%@')
+     * // Use lowercase alphabet characters
+     * osc(1).charMap('abcdefghijklmnopqrstuvwxyz')
      *
      * // Use custom symbols
      * gradient().charMap('-<>^v')
@@ -68,7 +74,7 @@ export interface ISynthSource {
      * char(noise(10), 16)
      *
      * // Use oscillator to select characters
-     * char(osc(5), 8)
+     * char(osc(5), 32)
      * ```
      */
     char(source: ISynthSource, charCount: number): this;
@@ -124,32 +130,37 @@ export interface ISynthSource {
      * @param sync - Synchronization offset (default: 0.1)
      * @param offset - Phase offset (default: 0.0)
      */
-    osc?: (frequency?: SynthParameterValue, sync?: SynthParameterValue, offset?: SynthParameterValue) => ISynthSource;
+    osc(frequency?: SynthParameterValue, sync?: SynthParameterValue, offset?: SynthParameterValue): this;
     /**
      * Generate Perlin noise patterns.
      * @param scale - Scale of the noise pattern (default: 10.0)
      * @param speed - Animation speed (default: 0.1)
      */
-    noise?: (scale?: SynthParameterValue, speed?: SynthParameterValue) => ISynthSource;
+    noise(scale?: SynthParameterValue, speed?: SynthParameterValue): this;
     /**
-     * Generate Voronoi (cellular) patterns.
-     * @param scale - Scale of Voronoi cells (default: 5.0)
+     * Generate voronoi patterns.
+     * @param scale - Scale of voronoi cells (default: 5.0)
      * @param speed - Animation speed (default: 0.3)
      * @param blending - Blending between cell regions (default: 0.3)
      */
-    voronoi?: (scale?: SynthParameterValue, speed?: SynthParameterValue, blending?: SynthParameterValue) => ISynthSource;
+    voronoi(scale?: SynthParameterValue, speed?: SynthParameterValue, blending?: SynthParameterValue): this;
     /**
      * Generate a rotating radial gradient.
      * @param speed - Rotation speed (default: 0.0)
+     *
+     * @example
+     * ```typescript
+     * gradient([1,2,4])
+     * ```
      */
-    gradient?: (speed?: SynthParameterValue) => ISynthSource;
+    gradient(speed?: SynthParameterValue): this;
     /**
      * Generate geometric shapes (polygons).
      * @param sides - Number of sides (default: 3)
      * @param radius - Radius of the shape (default: 0.3)
      * @param smoothing - Edge smoothing amount (default: 0.01)
      */
-    shape?: (sides?: SynthParameterValue, radius?: SynthParameterValue, smoothing?: SynthParameterValue) => ISynthSource;
+    shape(sides?: SynthParameterValue, radius?: SynthParameterValue, smoothing?: SynthParameterValue): this;
     /**
      * Generate a solid color.
      * @param r - Red channel (0-1, default: 0.0)
@@ -157,7 +168,7 @@ export interface ISynthSource {
      * @param b - Blue channel (0-1, default: 0.0)
      * @param a - Alpha channel (0-1, default: 1.0)
      */
-    solid?: (r?: SynthParameterValue, g?: SynthParameterValue, b?: SynthParameterValue, a?: SynthParameterValue) => ISynthSource;
+    solid(r?: SynthParameterValue, g?: SynthParameterValue, b?: SynthParameterValue, a?: SynthParameterValue): this;
     /**
      * Sample the previous frame for feedback effects, or sample from another layer.
      *
@@ -191,25 +202,9 @@ export interface ISynthSource {
      * char(noise(10).diff(src()))           // src() → character feedback
      *   .charColor(osc(5).blend(src(), 0.5)) // src() → primary color feedback
      *   .cellColor(voronoi().diff(src()))    // src() → cell color feedback
-     *
-     * // Cross-layer sampling (hydra-style o0, o1, o2, o3)
-     * const layer1 = t.layers.add();
-     * const layer2 = t.layers.add();
-     *
-     * layer1.synth(noise(10).mult(osc(20)));
-     *
-     * layer2.synth(
-     *   char(voronoi(5).diff(src(layer1)))  // Sample layer1's char texture
-     *     .charColor(osc(10).blend(src(layer1), 0.5))  // Sample layer1's primary color
-     * );
-     *
-     * // Complex multi-layer composition
-     * t.layers.base.synth(
-     *   noise(3, 0.3).thresh(0.3).diff(src(layer2), 0.3)
-     * );
      * ```
      */
-    src?: (layer?: unknown) => ISynthSource;
+    src(layer?: unknown): this;
     /**
      * Rotate coordinates.
      * @param angle - Rotation angle in radians (default: 10.0)
@@ -218,12 +213,12 @@ export interface ISynthSource {
      * @example
      * ```typescript
      * // Rotate shape continuously
-     * charOsc(50, 0, 0, 16)
+     * osc(50, 0, 0, 16)
      *   .rotate((ctx) => ctx.time % 360)
      *   .charColor(osc(50).rotate((ctx) => ctx.time % 360));
      * ```
      */
-    rotate?: (angle?: SynthParameterValue, speed?: SynthParameterValue) => ISynthSource;
+    rotate(angle?: SynthParameterValue, speed?: SynthParameterValue): this;
     /**
      * Scale coordinates.
      * @param amount - Scale amount (default: 1.5)
@@ -235,10 +230,10 @@ export interface ISynthSource {
      * @example
      * ```typescript
      * // Scale a triangle shape
-     * charShape(3).scale(1.5, 1, 1);
+     * shape(3).scale(1.5, 1, 1);
      * ```
      */
-    scale?: (amount?: SynthParameterValue, xMult?: SynthParameterValue, yMult?: SynthParameterValue, offsetX?: SynthParameterValue, offsetY?: SynthParameterValue) => ISynthSource;
+    scale(amount?: SynthParameterValue, xMult?: SynthParameterValue, yMult?: SynthParameterValue, offsetX?: SynthParameterValue, offsetY?: SynthParameterValue): this;
     /**
      * Scroll coordinates in both X and Y directions.
      * @param scrollX - X scroll amount (default: 0.5)
@@ -249,22 +244,22 @@ export interface ISynthSource {
      * @example
      * ```typescript
      * // Scroll a shape diagonally
-     * charShape(3).scroll(0.1, -0.3);
+     * shape(3).scroll(0.1, -0.3);
      * ```
      */
-    scroll?: (scrollX?: SynthParameterValue, scrollY?: SynthParameterValue, speedX?: SynthParameterValue, speedY?: SynthParameterValue) => ISynthSource;
+    scroll(scrollX?: SynthParameterValue, scrollY?: SynthParameterValue, speedX?: SynthParameterValue, speedY?: SynthParameterValue): this;
     /**
      * Scroll coordinates in X direction.
      * @param scrollX - X scroll amount (default: 0.5)
      * @param speed - Scroll speed (default: 0.0)
      */
-    scrollX?: (scrollX?: SynthParameterValue, speed?: SynthParameterValue) => ISynthSource;
+    scrollX(scrollX?: SynthParameterValue, speed?: SynthParameterValue): this;
     /**
      * Scroll coordinates in Y direction.
      * @param scrollY - Y scroll amount (default: 0.5)
      * @param speed - Scroll speed (default: 0.0)
      */
-    scrollY?: (scrollY?: SynthParameterValue, speed?: SynthParameterValue) => ISynthSource;
+    scrollY(scrollY?: SynthParameterValue, speed?: SynthParameterValue): this;
     /**
      * Pixelate the output.
      * @param pixelX - Pixel size in X (default: 20.0)
@@ -273,12 +268,12 @@ export interface ISynthSource {
      * @example
      * ```typescript
      * // Pixelate noise pattern
-     * charNoise(1, 0.05)
+     * noise(1, 0.05)
      *   .pixelate(20, 20)
      *   .charColor(noise().pixelate(20, 20));
      * ```
      */
-    pixelate?: (pixelX?: SynthParameterValue, pixelY?: SynthParameterValue) => ISynthSource;
+    pixelate(pixelX?: SynthParameterValue, pixelY?: SynthParameterValue): this;
     /**
      * Repeat coordinates in both X and Y directions.
      * @param repeatX - Number of X repetitions (default: 3.0)
@@ -289,24 +284,24 @@ export interface ISynthSource {
      * @example
      * ```typescript
      * // Repeat a shape in a 3x3 grid
-     * charShape(3)
+     * shape(3)
      *   .repeat(3, 3, 0, 0)
      *   .charColor(shape().repeat(3, 3, 0, 0));
      * ```
      */
-    repeat?: (repeatX?: SynthParameterValue, repeatY?: SynthParameterValue, offsetX?: SynthParameterValue, offsetY?: SynthParameterValue) => ISynthSource;
+    repeat(repeatX?: SynthParameterValue, repeatY?: SynthParameterValue, offsetX?: SynthParameterValue, offsetY?: SynthParameterValue): this;
     /**
      * Repeat coordinates in X direction.
      * @param reps - Number of repetitions (default: 3.0)
      * @param offset - Offset between repetitions (default: 0.0)
      */
-    repeatX?: (reps?: SynthParameterValue, offset?: SynthParameterValue) => ISynthSource;
+    repeatX(reps?: SynthParameterValue, offset?: SynthParameterValue): this;
     /**
      * Repeat coordinates in Y direction.
      * @param reps - Number of repetitions (default: 3.0)
      * @param offset - Offset between repetitions (default: 0.0)
      */
-    repeatY?: (reps?: SynthParameterValue, offset?: SynthParameterValue) => ISynthSource;
+    repeatY(reps?: SynthParameterValue, offset?: SynthParameterValue): this;
     /**
      * Apply kaleidoscope effect.
      * @param nSides - Number of kaleidoscope sides (default: 4.0)
@@ -314,53 +309,50 @@ export interface ISynthSource {
      * @example
      * ```typescript
      * // Create a 50-sided kaleidoscope pattern
-     * charOsc(25, -0.1, 0.5, 32)
+     * osc(25, -0.1, 0.5, 32)
      *   .kaleid(50)
      *   .charColor(osc(25, -0.1, 0.5).kaleid(50));
      * ```
      */
-    kaleid?: (nSides?: SynthParameterValue) => ISynthSource;
+    kaleid(nSides?: SynthParameterValue): this;
     /**
      * Adjust brightness.
      * @param amount - Brightness adjustment amount (default: 0.4)
      *
      * @example
      * ```typescript
-     * // Animate brightness with sine wave
-     * charOsc(20, 0, 2, 16)
+     * osc(1)
      *   .charColor(
-     *     osc(20, 0, 2).brightness((ctx) => Math.sin(ctx.time))
-     *   );
+     *     osc(20, 0, 2).brightness(() => Math.sin(t.secs()))
+     *   )
      * ```
      */
-    brightness?: (amount?: SynthParameterValue) => ISynthSource;
+    brightness(amount?: SynthParameterValue): this;
     /**
      * Adjust contrast.
      * @param amount - Contrast amount (default: 1.6)
      *
      * @example
      * ```typescript
-     * // Animate contrast
-     * charOsc(20, 0.1, 0, 16)
+     * osc(1)
      *   .charColor(
      *     osc(20).contrast((ctx) => Math.sin(ctx.time) * 5)
-     *   );
+     *   )
      * ```
      */
-    contrast?: (amount?: SynthParameterValue) => ISynthSource;
+    contrast(amount?: SynthParameterValue): this;
     /**
      * Invert colors.
      * @param amount - Inversion amount (default: 1.0)
      *
      * @example
      * ```typescript
-     * // Toggle inversion with array
-     * charSolid(16)
-     *   .charColor(solid(1, 1, 1).invert([0, 1]))
-     *   .cellColor(solid(1, 1, 1).invert([1, 0]));
+     *  solid(0.2, 0, 0, 1)
+     *     .charColor(solid(1, 1, 1).invert([0, 1]))
+     *     .cellColor(solid(1, 1, 1).invert([1, 0]))
      * ```
      */
-    invert?: (amount?: SynthParameterValue) => ISynthSource;
+    invert(amount?: SynthParameterValue): this;
     /**
      * Adjust color saturation.
      * @param amount - Saturation amount (default: 2.0)
@@ -368,32 +360,37 @@ export interface ISynthSource {
      * @example
      * ```typescript
      * // Animate saturation
-     * charOsc(10, 0, 1, 16)
+     * osc(10, 0, 1, 16)
      *   .charColor(
      *     osc(10, 0, 1).saturate((ctx) => Math.sin(ctx.time) * 10)
      *   );
      * ```
      */
-    saturate?: (amount?: SynthParameterValue) => ISynthSource;
+    saturate(amount?: SynthParameterValue): this;
     /**
      * Shift hue.
      * @param hue - Hue shift amount (default: 0.4)
      *
      * @example
      * ```typescript
-     * // Animate hue shift
-     * charOsc(30, 0.1, 1, 16)
+     * osc(1)
      *   .charColor(
      *     osc(30, 0.1, 1).hue((ctx) => Math.sin(ctx.time))
-     *   );
+     *   )
      * ```
      */
-    hue?: (hue?: SynthParameterValue) => ISynthSource;
+    hue(hue?: SynthParameterValue): this;
     /**
      * Apply colorama effect (hue rotation based on luminance).
      * @param amount - Effect amount (default: 0.005)
+     *
+     * @example
+     * ```typescript
+     * // Create color cycle effect on oscillator
+     * noise(4).colorama(0.3)
+     * ```
      */
-    colorama?: (amount?: SynthParameterValue) => ISynthSource;
+    colorama(amount?: SynthParameterValue): this;
     /**
      * Posterize colors to limited palette.
      * @param bins - Number of color bins (default: 3.0)
@@ -402,52 +399,90 @@ export interface ISynthSource {
      * @example
      * ```typescript
      * // Posterize gradient with array modulation
-     * charGradient(0, 16)
+     * gradient(0, 16)
      *   .rotate(1.57)
      *   .charColor(
      *     gradient(0).posterize([1, 5, 15, 30], 0.5)
      *   );
      * ```
      */
-    posterize?: (bins?: SynthParameterValue, gamma?: SynthParameterValue) => ISynthSource;
+    posterize(bins?: SynthParameterValue, gamma?: SynthParameterValue): this;
     /**
      * Apply threshold based on luminance.
      * @param threshold - Threshold value (default: 0.5)
      * @param tolerance - Tolerance range (default: 0.1)
+     *
+     * @example
+     * ```typescript
+     * // Apply threshold to oscillator
+     * osc(10,0,1).luma(0.5,0.1)
+     * ```
      */
-    luma?: (threshold?: SynthParameterValue, tolerance?: SynthParameterValue) => ISynthSource;
+    luma(threshold?: SynthParameterValue, tolerance?: SynthParameterValue): this;
     /**
      * Apply hard threshold.
      * @param threshold - Threshold value (default: 0.5)
      * @param tolerance - Tolerance range (default: 0.04)
      */
-    thresh?: (threshold?: SynthParameterValue, tolerance?: SynthParameterValue) => ISynthSource;
+    thresh(threshold?: SynthParameterValue, tolerance?: SynthParameterValue): this;
     /**
-     * Set color channels.
-     * @param r - Red channel (default: 1.0)
-     * @param g - Green channel (default: 1.0)
-     * @param b - Blue channel (default: 1.0)
-     * @param a - Alpha channel (default: 1.0)
+     * Colorize a grayscale source or multiply an existing color source.
+     *
+     * This is the recommended way to add color to grayscale sources like `osc()`,
+     * `noise()`, or `voronoi()`.
+     *
+     * @param r - Red channel multiplier (default: 1.0)
+     * @param g - Green channel multiplier (default: 1.0)
+     * @param b - Blue channel multiplier (default: 1.0)
+     * @param a - Alpha channel multiplier (default: 1.0)
+     *
+     * @example
+     * ```typescript
+     * // Create a blue oscillator
+     * osc(10).color(0, 0.5, 1.0)
+     *
+     * // Colorize noise with a red tint
+     * noise(5).color(1, 0.2, 0.2)
+     * ```
      */
-    color?: (r?: SynthParameterValue, g?: SynthParameterValue, b?: SynthParameterValue, a?: SynthParameterValue) => ISynthSource;
+    color(r?: SynthParameterValue, g?: SynthParameterValue, b?: SynthParameterValue, a?: SynthParameterValue): this;
     /**
-     * Scale and offset red channel.
+     * Extract the red channel as a grayscale value.
      * @param scale - Scale multiplier (default: 1.0)
      * @param offset - Offset amount (default: 0.0)
+     *
+     * @example
+     * ```typescript
+     * // Extract red channel as grayscale
+     * voronoi(5).hue(0.4).r()
+     *
+     * // Convert red intensity to character indices
+     * char(osc(10).hue(0.5).r(), 16)
+     * ```
      */
-    r?: (scale?: SynthParameterValue, offset?: SynthParameterValue) => ISynthSource;
+    r(scale?: SynthParameterValue, offset?: SynthParameterValue): this;
     /**
-     * Scale and offset green channel.
+     * Extract the green channel as a grayscale value.
      * @param scale - Scale multiplier (default: 1.0)
      * @param offset - Offset amount (default: 0.0)
+     *
+     * @example
+     * ```typescript
+     * osc(4,0.1,1.5).layer(gradient().g())
+     * ```
      */
-    g?: (scale?: SynthParameterValue, offset?: SynthParameterValue) => ISynthSource;
+    g(scale?: SynthParameterValue, offset?: SynthParameterValue): this;
     /**
-     * Scale and offset blue channel.
+     * Extract the blue channel as a grayscale value.
      * @param scale - Scale multiplier (default: 1.0)
      * @param offset - Offset amount (default: 0.0)
+     *
+     * @example
+     * ```typescript
+     * osc(8,0.1,1.5).layer(gradient().colorama(1).b())
+     * ```
      */
-    b?: (scale?: SynthParameterValue, offset?: SynthParameterValue) => ISynthSource;
+    b(scale?: SynthParameterValue, offset?: SynthParameterValue): this;
     /**
      * Shift color channels by adding offset values.
      * @param r - Red channel shift (default: 0.5)
@@ -455,23 +490,18 @@ export interface ISynthSource {
      * @param b - Blue channel shift (default: 0.0)
      * @param a - Alpha channel shift (default: 0.0)
      */
-    shift?: (r?: SynthParameterValue, g?: SynthParameterValue, b?: SynthParameterValue, a?: SynthParameterValue) => ISynthSource;
+    shift(r?: SynthParameterValue, g?: SynthParameterValue, b?: SynthParameterValue, a?: SynthParameterValue): this;
     /**
      * Apply gamma correction for nonlinear brightness control.
      * @param amount - Gamma value (default: 1.0, < 1.0 brightens, > 1.0 darkens)
      *
      * @example
      * ```typescript
-     * // Brighten midtones
-     * charNoise(10)
-     *   .charColor(gradient(0).gamma(0.7))
-     *
-     * // Darken with animation
-     * charOsc(8)
+     * osc(1)
      *   .charColor(osc(5).gamma([1.0, 1.5, 2.0].smooth(4)))
      * ```
      */
-    gamma?: (amount?: SynthParameterValue) => ISynthSource;
+    gamma(amount?: SynthParameterValue): this;
     /**
      * Adjust input/output levels and gamma for precise tonal control.
      * @param inMin - Input minimum (default: 0.0)
@@ -483,15 +513,15 @@ export interface ISynthSource {
      * @example
      * ```typescript
      * // Expand tonal range from 0.2-0.8 to 0-1
-     * charNoise(10)
+     * noise(10)
      *   .charColor(noise(5).levels(0.2, 0.8, 0.0, 1.0, 1.0))
      *
      * // Compress highlights, boost shadows
-     * charVoronoi(8)
+     * voronoi(8)
      *   .charColor(voronoi(5).levels(0.0, 1.0, 0.2, 0.9, 0.8))
      * ```
      */
-    levels?: (inMin?: SynthParameterValue, inMax?: SynthParameterValue, outMin?: SynthParameterValue, outMax?: SynthParameterValue, gamma?: SynthParameterValue) => ISynthSource;
+    levels(inMin?: SynthParameterValue, inMax?: SynthParameterValue, outMin?: SynthParameterValue, outMax?: SynthParameterValue, gamma?: SynthParameterValue): this;
     /**
      * Clamp color values to a specified range for stability.
      * @param min - Minimum value (default: 0.0)
@@ -499,18 +529,10 @@ export interface ISynthSource {
      *
      * @example
      * ```typescript
-     * // Prevent overflow after multiple blend operations
-     * charOsc(10)
-     *   .charColor(
-     *     osc(5).add(osc(8), 0.8).add(osc(12), 0.6).clampColor(0.0, 1.0)
-     *   )
-     *
-     * // Create hard clip effect
-     * charNoise(8)
-     *   .charColor(noise(5).brightness(0.5).clampColor(0.3, 0.7))
+     * osc(5).add(osc(8), 0.8).add(osc(12), 0.6).clamp(0.2, 0.8)
      * ```
      */
-    clampColor?: (min?: SynthParameterValue, max?: SynthParameterValue) => ISynthSource;
+    clamp(min?: SynthParameterValue, max?: SynthParameterValue): this;
     /**
      * Add another source.
      * @param source - Source to add
@@ -519,28 +541,24 @@ export interface ISynthSource {
      * @example
      * ```typescript
      * // Add two shapes with animated blend amount
-     * charShape(3)
+     * shape(3)
      *   .scale(0.5)
-     *   .charColor(
-     *     shape(3)
-     *       .scale(0.5)
-     *       .add(shape(4).scale(2), [0, 0.25, 0.5, 0.75, 1])
-     *   );
+     *   .add(shape(4).scale(2), [0, 0.25, 0.5, 0.75, 1])
      * ```
      */
-    add?: (source: ISynthSource, amount?: SynthParameterValue) => ISynthSource;
+    add(source: ISynthSource, amount?: SynthParameterValue): this;
     /**
      * Subtract another source.
      * @param source - Source to subtract
      * @param amount - Blend amount (default: 0.5)
      */
-    sub?: (source: ISynthSource, amount?: SynthParameterValue) => ISynthSource;
+    sub(source: ISynthSource, amount?: SynthParameterValue): this;
     /**
      * Multiply with another source.
      * @param source - Source to multiply
      * @param amount - Blend amount (default: 0.5)
      */
-    mult?: (source: ISynthSource, amount?: SynthParameterValue) => ISynthSource;
+    mult(source: ISynthSource, amount?: SynthParameterValue): this;
     /**
      * Blend with another source.
      * @param source - Source to blend
@@ -549,35 +567,34 @@ export interface ISynthSource {
      * @example
      * ```typescript
      * // Blend two shapes
-     * charShape(3)
+     * shape(3)
      *   .scale(0.5)
-     *   .charColor(
-     *     shape(3)
-     *       .scale(0.5)
-     *       .blend(shape(4).scale(2), [0, 0.25, 0.5, 0.75, 1])
-     *   );
+     *   .blend(shape(4).scale(2), [0, 0.25, 0.5, 0.75, 1])
      * ```
      */
-    blend?: (source: ISynthSource, amount?: SynthParameterValue) => ISynthSource;
+    blend(source: ISynthSource, amount?: SynthParameterValue): this;
     /**
      * Difference with another source.
      * @param source - Source to compare
      *
      * @example
      * ```typescript
-     * // Create difference pattern between two oscillators
-     * charOsc(9, 0.1, 2, 16)
-     *   .charColor(
-     *     osc(9, 0.1, 2).diff(osc(13, 0.5, 5))
-     *   );
+     * osc(1, 0.1, 2).diff(osc(1, 0.5, 5))
      * ```
      */
-    diff?: (source: ISynthSource) => ISynthSource;
+    diff(source: ISynthSource): this;
     /**
      * Layer another source on top.
      * @param source - Source to layer
+     *
+     * @example
+     * ```typescript
+     *   osc(1)
+     *   .charColor(osc(30).layer(osc(15).rotate(1).luma()))
+     *   .cellColor(osc(30).layer(osc(15).rotate(1).luma()).invert())
+     * ```
      */
-    layer?: (source: ISynthSource) => ISynthSource;
+    layer(source: ISynthSource): this;
     /**
      * Mask using another source.
      * @param source - Source to use as mask
@@ -585,13 +602,10 @@ export interface ISynthSource {
      * @example
      * ```typescript
      * // Mask gradient with voronoi pattern
-     * charGradient(0, 16)
-     *   .charColor(
-     *     gradient(5).mask(voronoi()).invert([0, 1])
-     *   );
+     * gradient(5).mask(voronoi()).invert([0, 1])
      * ```
      */
-    mask?: (source: ISynthSource) => ISynthSource;
+    mask(source: ISynthSource): this;
     /**
      * Modulate coordinates using another source.
      * @param source - Modulation source
@@ -599,120 +613,77 @@ export interface ISynthSource {
      *
      * @example
      * ```typescript
-     * // Modulate voronoi with kaleidoscope pattern
-     * charVoronoi(5, 0.3, 16)
-     *   .rotate((ctx) => (ctx.time % 360) / 2)
-     *   .modulate(
-     *     osc(25, 0.1, 0.5)
-     *       .kaleid(50)
-     *       .scale((ctx) => Math.sin(ctx.time) * 0.5 + 1)
-     *       .modulate(noise(0.6, 0.5)),
-     *     0.5
-     *   );
+     * osc(3, 0, 2)
+     *     .modulate(noise().add(gradient(), -1), 1)
      * ```
      */
-    modulate?: (source: ISynthSource, amount?: SynthParameterValue) => ISynthSource;
+    modulate(source: ISynthSource, amount?: SynthParameterValue): this;
     /**
      * Modulate scale using another source.
      * @param source - Modulation source
      * @param multiple - Scale multiplier (default: 1.0)
      * @param offset - Offset amount (default: 1.0)
      */
-    modulateScale?: (source: ISynthSource, multiple?: SynthParameterValue, offset?: SynthParameterValue) => ISynthSource;
+    modulateScale(source: ISynthSource, multiple?: SynthParameterValue, offset?: SynthParameterValue): this;
     /**
      * Modulate rotation using another source.
      * @param source - Modulation source
      * @param multiple - Rotation multiplier (default: 1.0)
      * @param offset - Offset amount (default: 0.0)
      */
-    modulateRotate?: (source: ISynthSource, multiple?: SynthParameterValue, offset?: SynthParameterValue) => ISynthSource;
+    modulateRotate(source: ISynthSource, multiple?: SynthParameterValue, offset?: SynthParameterValue): this;
     /**
      * Modulate pixelation using another source.
      * @param source - Modulation source
      * @param multiple - Pixelation multiplier (default: 10.0)
      * @param offset - Offset amount (default: 3.0)
+     *
+     * @example
+     * ```typescript
+     * noise(3).modulatePixelate(noise(1, 0).pixelate(8, 8), 1024, 8)
+     * ```
      */
-    modulatePixelate?: (source: ISynthSource, multiple?: SynthParameterValue, offset?: SynthParameterValue) => ISynthSource;
+    modulatePixelate(source: ISynthSource, multiple?: SynthParameterValue, offset?: SynthParameterValue): this;
     /**
      * Modulate kaleidoscope using another source.
      * @param source - Modulation source
      * @param nSides - Number of sides (default: 4.0)
+     *
+     * @example
+     * ```typescript
+     * osc(2, 0.1, 2)
+     *     .modulateKaleid(osc(16).kaleid(999), 1)
+     * ```
      */
-    modulateKaleid?: (source: ISynthSource, nSides?: SynthParameterValue) => ISynthSource;
+    modulateKaleid(source: ISynthSource, nSides?: SynthParameterValue): this;
     /**
      * Modulate X scroll using another source.
      * @param source - Modulation source
      * @param scrollX - X scroll amount (default: 0.5)
      * @param speed - Scroll speed (default: 0.0)
      */
-    modulateScrollX?: (source: ISynthSource, scrollX?: SynthParameterValue, speed?: SynthParameterValue) => ISynthSource;
+    modulateScrollX(source: ISynthSource, scrollX?: SynthParameterValue, speed?: SynthParameterValue): this;
     /**
      * Modulate Y scroll using another source.
      * @param source - Modulation source
      * @param scrollY - Y scroll amount (default: 0.5)
      * @param speed - Scroll speed (default: 0.0)
      */
-    modulateScrollY?: (source: ISynthSource, scrollY?: SynthParameterValue, speed?: SynthParameterValue) => ISynthSource;
+    modulateScrollY(source: ISynthSource, scrollY?: SynthParameterValue, speed?: SynthParameterValue): this;
     /**
-     * Generate character indices using Perlin noise.
-     * @param scale - Scale of the noise pattern (default: 10.0)
-     * @param speed - Animation speed (default: 0.1)
-     * @param charCount - Number of different characters to use (default: 256)
-     */
-    charNoise?: (scale?: SynthParameterValue, speed?: SynthParameterValue, charCount?: SynthParameterValue) => ISynthSource;
-    /**
-     * Generate character indices using oscillating sine waves.
-     * @param frequency - Frequency of the oscillation (default: 60.0)
-     * @param sync - Synchronization offset (default: 0.1)
-     * @param charCount - Number of different characters to use (default: 256)
-     */
-    charOsc?: (frequency?: SynthParameterValue, sync?: SynthParameterValue, charCount?: SynthParameterValue) => ISynthSource;
-    /**
-     * Generate character indices using a gradient.
-     * @param charCount - Number of different characters to use (default: 256)
-     * @param direction - Gradient direction (default: 0.0)
-     */
-    charGradient?: (charCount?: SynthParameterValue, direction?: SynthParameterValue) => ISynthSource;
-    /**
-     * Generate character indices using Voronoi (cellular) patterns.
-     * @param scale - Scale of Voronoi cells (default: 5.0)
-     * @param speed - Animation speed (default: 0.3)
-     * @param charCount - Number of different characters to use (default: 256)
+     * Add a transform to the chain.
+     * @ignore
      */
-    charVoronoi?: (scale?: SynthParameterValue, speed?: SynthParameterValue, charCount?: SynthParameterValue) => ISynthSource;
+    addTransform(name: string, userArgs: SynthParameterValue[]): this;
     /**
-     * Generate character indices based on geometric shapes (polygons).
-     * @param sides - Number of sides (default: 3)
-     * @param innerChar - Character index for inside the shape (default: 0)
-     * @param outerChar - Character index for outside the shape (default: 1)
-     * @param radius - Radius of the shape (default: 0.3)
-     */
-    charShape?: (sides?: SynthParameterValue, innerChar?: SynthParameterValue, outerChar?: SynthParameterValue, radius?: SynthParameterValue) => ISynthSource;
-    /**
-     * Generate a solid character index across the entire canvas.
-     * @param charIndex - Character index to use (default: 0)
-     */
-    charSolid?: (charIndex?: SynthParameterValue) => ISynthSource;
-    /**
-     * Flip characters horizontally.
-     * @param toggle - Toggle flip (default: 1.0)
+     * Add a combine transform that references another source.
+     * @ignore
      */
-    charFlipX?: (toggle?: SynthParameterValue) => ISynthSource;
+    addCombineTransform(name: string, source: ISynthSource, userArgs: SynthParameterValue[]): this;
     /**
-     * Flip characters vertically.
-     * @param toggle - Toggle flip (default: 1.0)
-     */
-    charFlipY?: (toggle?: SynthParameterValue) => ISynthSource;
-    /**
-     * Invert character indices.
-     * @param toggle - Toggle invert (default: 1.0)
-     */
-    charInvert?: (toggle?: SynthParameterValue) => ISynthSource;
-    /**
-     * Rotate characters.
-     * @param angle - Rotation angle in radians (default: 0.0)
-     * @param speed - Rotation speed (default: 0.0)
+     * Add an external layer reference at the current transform index.
+     * @ignore
      */
-    charRotate?: (angle?: SynthParameterValue, speed?: SynthParameterValue) => ISynthSource;
+    addExternalLayerRef(ref: unknown): this;
 }
 //# sourceMappingURL=ISynthSource.d.ts.map