textmode.synth.js 1.0.0-beta.1

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

@@ -0,0 +1 @@
+{"version":3,"file":"ISynthSource.d.ts","sourceRoot":"","sources":["../../../src/core/ISynthSource.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,62 @@
+import type { SynthParameterValue } from './types';
+/**
+ * A recorded transform in the synthesis chain.
+ */
+export interface TransformRecord {
+    /** Transform function name */
+    name: string;
+    /** User-provided arguments */
+    userArgs: SynthParameterValue[];
+}
+/**
+ * A mutable chain of transform records for the fluent API.
+ * While the internal implementation is mutable for compatibility with the
+ * existing fluent API, the returned readonly arrays provide a consistent view.
+ */
+export declare class SynthChain {
+    /** The transforms in this chain */
+    private _transforms;
+    /**
+     * Create a new SynthChain with the given transforms.
+     * @internal Use static factory methods instead.
+     */
+    private constructor();
+    /**
+     * Create an empty chain.
+     */
+    static empty(): SynthChain;
+    /**
+     * Create a chain from existing transforms.
+     */
+    static from(transforms: readonly TransformRecord[]): SynthChain;
+    /**
+     * Get all transforms in this chain (readonly view).
+     */
+    get transforms(): readonly TransformRecord[];
+    /**
+     * Push a transform to this chain (internal mutation).
+     * @internal
+     */
+    push(record: TransformRecord): void;
+    /**
+     * Get the number of transforms in this chain.
+     */
+    get length(): number;
+    /**
+     * Check if the chain is empty.
+     */
+    get isEmpty(): boolean;
+    /**
+     * Append a transform to this chain, returning a new chain.
+     */
+    append(record: TransformRecord): SynthChain;
+    /**
+     * Get a transform at a specific index.
+     */
+    get(index: number): TransformRecord | undefined;
+    /**
+     * Create an iterator over the transforms.
+     */
+    [Symbol.iterator](): Iterator<TransformRecord>;
+}
+//# sourceMappingURL=SynthChain.d.ts.map

package/dist/types/core/SynthChain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SynthChain.d.ts","sourceRoot":"","sources":["../../../src/core/SynthChain.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC/B,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,8BAA8B;IAC9B,QAAQ,EAAE,mBAAmB,EAAE,CAAC;CAChC;AAED;;;;GAIG;AACH,qBAAa,UAAU;IACtB,mCAAmC;IACnC,OAAO,CAAC,WAAW,CAAoB;IAEvC;;;OAGG;IACH,OAAO;IAIP;;OAEG;WACW,KAAK,IAAI,UAAU;IAIjC;;OAEG;WACW,IAAI,CAAC,UAAU,EAAE,SAAS,eAAe,EAAE,GAAG,UAAU;IAItE;;OAEG;IACH,IAAW,UAAU,IAAI,SAAS,eAAe,EAAE,CAElD;IAED;;;OAGG;IACI,IAAI,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI;IAI1C;;OAEG;IACH,IAAW,MAAM,IAAI,MAAM,CAE1B;IAED;;OAEG;IACH,IAAW,OAAO,IAAI,OAAO,CAE5B;IAED;;OAEG;IACI,MAAM,CAAC,MAAM,EAAE,eAAe,GAAG,UAAU;IAIlD;;OAEG;IACI,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAItD;;OAEG;IACI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,eAAe,CAAC;CAGrD"}

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

@@ -0,0 +1,126 @@
+import type { SynthParameterValue, CharacterMapping, ExternalLayerReference } from './types';
+import { SynthChain, type TransformRecord } from './SynthChain';
+import { ISynthSource } from './ISynthSource';
+/**
+ * Options for creating a new SynthSource.
+ * @internal
+ */
+interface SynthSourceCreateOptions {
+    chain?: SynthChain;
+    charMapping?: CharacterMapping;
+    colorSource?: SynthSource;
+    cellColorSource?: SynthSource;
+    charSource?: SynthSource;
+    charCount?: number;
+    nestedSources?: Map<number, SynthSource>;
+    externalLayerRefs?: Map<number, ExternalLayerReference>;
+}
+/**
+ * A chainable synthesis source that accumulates transforms to be compiled into a shader.
+ *
+ * This is the core class that enables hydra-like method chaining for
+ * generating procedural textmode visuals. Each method call adds a
+ * transform to the chain, which is later compiled into a GLSL shader.
+ *
+ * @example
+ * ```ts
+ * // Create a synth chain with procedural characters and colors
+ * const synth = noise(10)
+ *   .rotate(0.1)
+ *   .scroll(0.1, 0)
+ *
+ *   .charColor(osc(5).kaleid(4))
+ *   .cellColor(osc(5).kaleid(4).invert())
+ *
+ *   .charMap('@#%*+=-:. ');
+ * ```
+ */
+export declare class SynthSource implements ISynthSource {
+    /** The immutable chain of transforms */
+    private readonly _chain;
+    /** Character mapping for charMap transform */
+    private _charMapping?;
+    /** Nested sources for combine operations (indexed by transform position) */
+    private readonly _nestedSources;
+    /** External layer references for cross-layer sampling (indexed by transform position) */
+    private readonly _externalLayerRefs;
+    /** Reference to the color source chain (if any) */
+    private _colorSource?;
+    /** Reference to the cell color source chain (if any) */
+    private _cellColorSource?;
+    /** Reference to the character source chain (if any) - used by char() function */
+    private _charSource?;
+    /** Number of unique characters when using char() function */
+    private _charCount?;
+    /**
+     * Create a new SynthSource.
+     * @param options Optional initialization options
+     * @ignore Use generator functions like `osc()`, `noise()` instead
+     */
+    constructor(options?: SynthSourceCreateOptions);
+    /**
+     * Add a transform to the chain.
+     * This method is called by dynamically injected transform methods.
+     * @ignore
+     */
+    addTransform(name: string, userArgs: SynthParameterValue[]): this;
+    /**
+     * Add a combine transform that references another source.
+     * @ignore
+     */
+    addCombineTransform(name: string, source: SynthSource, userArgs: SynthParameterValue[]): this;
+    /**
+     * Add an external layer reference at the current transform index.
+     * Used by src(layer) to track cross-layer sampling.
+     * @ignore
+     */
+    addExternalLayerRef(ref: ExternalLayerReference): this;
+    charMap(chars: string): this;
+    charColor(source: SynthSource): this;
+    char(source: SynthSource, charCount: number): this;
+    cellColor(source: SynthSource): this;
+    paint(source: SynthSource): this;
+    clone(): SynthSource;
+    /**
+     * Get the transform records.
+     * @ignore
+     */
+    get transforms(): readonly TransformRecord[];
+    /**
+     * Get the character mapping if defined.
+     * @ignore
+     */
+    get charMapping(): CharacterMapping | undefined;
+    /**
+     * Get the color source if defined.
+     * @ignore
+     */
+    get colorSource(): SynthSource | undefined;
+    /**
+     * Get the cell color source if defined.
+     * @ignore
+     */
+    get cellColorSource(): SynthSource | undefined;
+    /**
+     * Get the character source if defined (from char() function).
+     * @ignore
+     */
+    get charSource(): SynthSource | undefined;
+    /**
+     * Get the character count if defined (from char() function).
+     * @ignore
+     */
+    get charCount(): number | undefined;
+    /**
+     * Get all nested sources for combine operations.
+     * @ignore
+     */
+    get nestedSources(): Map<number, SynthSource>;
+    /**
+     * Get all external layer references for cross-layer sampling.
+     * @ignore
+     */
+    get externalLayerRefs(): Map<number, ExternalLayerReference>;
+}
+export {};
+//# sourceMappingURL=SynthSource.d.ts.map

package/dist/types/core/SynthSource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SynthSource.d.ts","sourceRoot":"","sources":["../../../src/core/SynthSource.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,mBAAmB,EACnB,gBAAgB,EAChB,sBAAsB,EACtB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,cAAc,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C;;;GAGG;AACH,UAAU,wBAAwB;IACjC,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAC/B,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,eAAe,CAAC,EAAE,WAAW,CAAC;IAC9B,UAAU,CAAC,EAAE,WAAW,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACzC,iBAAiB,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;CACxD;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,WAAY,YAAW,YAAY;IAC/C,wCAAwC;IACxC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAa;IAEpC,8CAA8C;IAC9C,OAAO,CAAC,YAAY,CAAC,CAAmB;IAExC,4EAA4E;IAC5E,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA2B;IAE1D,yFAAyF;IACzF,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAsC;IAEzE,mDAAmD;IACnD,OAAO,CAAC,YAAY,CAAC,CAAc;IAEnC,wDAAwD;IACxD,OAAO,CAAC,gBAAgB,CAAC,CAAc;IAEvC,iFAAiF;IACjF,OAAO,CAAC,WAAW,CAAC,CAAc;IAElC,6DAA6D;IAC7D,OAAO,CAAC,UAAU,CAAC,CAAS;IAE5B;;;;OAIG;gBACS,OAAO,CAAC,EAAE,wBAAwB;IAe9C;;;;OAIG;IACI,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,mBAAmB,EAAE,GAAG,IAAI;IASxE;;;OAGG;IACI,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,mBAAmB,EAAE,GAAG,IAAI;IAMpG;;;;OAIG;IACI,mBAAmB,CAAC,GAAG,EAAE,sBAAsB,GAAG,IAAI;IAUtD,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAa5B,SAAS,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAKpC,IAAI,CAAC,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAMlD,SAAS,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAKpC,KAAK,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAMhC,KAAK,IAAI,WAAW;IA6B3B;;;OAGG;IACH,IAAW,UAAU,IAAI,SAAS,eAAe,EAAE,CAElD;IAED;;;OAGG;IACH,IAAW,WAAW,IAAI,gBAAgB,GAAG,SAAS,CAErD;IAED;;;OAGG;IACH,IAAW,WAAW,IAAI,WAAW,GAAG,SAAS,CAEhD;IAED;;;OAGG;IACH,IAAW,eAAe,IAAI,WAAW,GAAG,SAAS,CAEpD;IAED;;;OAGG;IACH,IAAW,UAAU,IAAI,WAAW,GAAG,SAAS,CAE/C;IAED;;;OAGG;IACH,IAAW,SAAS,IAAI,MAAM,GAAG,SAAS,CAEzC;IAED;;;OAGG;IACH,IAAW,aAAa,IAAI,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAEnD;IAED;;;OAGG;IACH,IAAW,iBAAiB,IAAI,GAAG,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAElE;CACD"}

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

@@ -0,0 +1,7 @@
+/**
+ * Core exports for the synth engine.
+ */
+export * from './types';
+export * from './SynthChain';
+export * from './SynthSource';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC"}

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

@@ -0,0 +1,106 @@
+/**
+ * Core types for the textmode.js synthesis system.
+ *
+ * This module contains foundational type definitions used throughout
+ * the synth engine, including transform types, parameter values,
+ * context interfaces, and shader compilation types.
+ */
+import { SynthSource } from "./SynthSource";
+/**
+ * Transform type categories determining how functions compose in the shader pipeline.
+ *
+ * Each type has specific input/output signatures:
+ * - `src`: Source generators that produce colors from UV coordinates
+ * - `coord`: Coordinate transforms that modify UV before sampling
+ * - `color`: Color transforms that modify existing color values
+ * - `combine`: Blending operations that combine two color sources
+ * - `combineCoord`: Modulation that uses one source to affect another's coordinates
+ * - `charModify`: Character property modifiers (flip, rotate, invert)
+ */
+export type SynthTransformType = 'src' | 'coord' | 'color' | 'combine' | 'combineCoord' | 'charModify';
+/**
+ * GLSL type for transform inputs.
+ */
+export type GLSLType = 'float' | 'vec2' | 'vec3' | 'vec4' | 'int' | 'sampler2D';
+/**
+ * Input parameter definition for a transform function.
+ */
+export interface TransformInput {
+    /** Parameter name used in GLSL and JS API */
+    name: string;
+    /** GLSL type */
+    type: GLSLType;
+    /** Default value if not provided */
+    default: number | number[] | null;
+}
+/**
+ * Dynamic parameter value types supported by the synth system.
+ *
+ * - `number`: Static numeric value
+ * - `number[]`: Array of numbers for vector types or modulated arrays (Hydra-style)
+ * - `string`: String value (rarely used)
+ * - `function`: Evaluated each frame with context
+ * - `SynthSource`: Nested synth chain for combine/modulate operations
+ * - `null`: Use default value
+ */
+export type SynthParameterValue = number | number[] | string | ((ctx: SynthContext) => number) | ((ctx: SynthContext) => number[]) | SynthSource | null;
+/**
+ * Context passed to dynamic parameter functions during rendering.
+ */
+export interface SynthContext {
+    /** Current time in seconds */
+    time: number;
+    /** Current frame count */
+    frameCount: number;
+    /** Grid width in pixels */
+    width: number;
+    /** Grid height in pixels */
+    height: number;
+    /** Grid columns */
+    cols: number;
+    /** Grid rows */
+    rows: number;
+}
+/**
+ * Character set mapping for charMap transform.
+ */
+export interface CharacterMapping {
+    /** The character string to use */
+    chars: string;
+    /** Pre-computed character code points */
+    indices: number[];
+}
+/**
+ * Reference to an external layer for cross-layer sampling.
+ * Used by src(layer) to enable hydra-style output references.
+ */
+export interface ExternalLayerReference {
+    /** Unique identifier for the layer (typically layer.id or generated) */
+    layerId: string;
+    /** The layer object reference (opaque to the compiler, used by plugin) */
+    layer: unknown;
+}
+/**
+ * Uniform definition for compiled shaders.
+ */
+export interface SynthUniform {
+    /** Uniform name in GLSL */
+    name: string;
+    /** GLSL type */
+    type: GLSLType;
+    /** Current value */
+    value: number | number[];
+    /** Whether this uniform is dynamically updated each frame */
+    isDynamic: boolean;
+}
+/**
+ * Return type signature lookup for each transform type.
+ */
+export declare const TRANSFORM_TYPE_INFO: Record<SynthTransformType, {
+    returnType: string;
+    args: Array<{
+        type: string;
+        name: string;
+    }>;
+}>;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C;;;;;;;;;;GAUG;AACH,MAAM,MAAM,kBAAkB,GAC3B,KAAK,GACL,OAAO,GACP,OAAO,GACP,SAAS,GACT,cAAc,GACd,YAAY,CAAC;AAEhB;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,WAAW,CAAC;AAEhF;;GAEG;AACH,MAAM,WAAW,cAAc;IAC9B,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB;IAChB,IAAI,EAAE,QAAQ,CAAC;IACf,oCAAoC;IACpC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,CAAC;CAClC;AAED;;;;;;;;;GASG;AACH,MAAM,MAAM,mBAAmB,GAC5B,MAAM,GACN,MAAM,EAAE,GACR,MAAM,GACN,CAAC,CAAC,GAAG,EAAE,YAAY,KAAK,MAAM,CAAC,GAC/B,CAAC,CAAC,GAAG,EAAE,YAAY,KAAK,MAAM,EAAE,CAAC,GACjC,WAAW,GACX,IAAI,CAAC;AAER;;GAEG;AACH,MAAM,WAAW,YAAY;IAC5B,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,0BAA0B;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,4BAA4B;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB;IAChB,IAAI,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,yCAAyC;IACzC,OAAO,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACtC,wEAAwE;IACxE,OAAO,EAAE,MAAM,CAAC;IAChB,0EAA0E;IAC1E,KAAK,EAAE,OAAO,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC5B,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB;IAChB,IAAI,EAAE,QAAQ,CAAC;IACf,oBAAoB;IACpB,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACzB,6DAA6D;IAC7D,SAAS,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CACvC,kBAAkB,EAClB;IACC,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC5C,CAgCD,CAAC"}