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

package/dist/types/augmentations/textmode.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Type augmentations for textmode.js
+ *
+ * This module extends the TextmodeLayer and Textmodifier interfaces
+ * when the textmode.synth.js package is imported.
+ *
+ * @module
+ */
+import type { SynthSource } from '../core/SynthSource';
+declare module 'textmode.js' {
+    interface TextmodeLayer {
+        /**
+         * Set a synth source for this layer.
+         *
+         * The synth will render procedurally generated characters and colors
+         * directly to the layer's draw framebuffer before the draw callback runs.
+         *
+         * @param source A SynthSource chain defining the procedural generation
+         */
+        synth(source: SynthSource): void;
+        /**
+         * Clear the synth from this layer.
+         *
+         * This disposes all synth-related resources including the compiled shader
+         * and any ping-pong framebuffers used for feedback effects. After calling
+         * this method, the layer will no longer render synth content.
+         *
+         * Use this to reset a layer's synth state without removing the layer itself.
+         */
+        clearSynth(): void;
+        /**
+         * Set layer-specific BPM override for array modulation timing.
+         *
+         * This overrides the global BPM set by `t.bpm()` for this specific layer,
+         * allowing polyrhythmic compositions where different layers cycle at
+         * different speeds.
+         *
+         * @param value BPM value (beats per minute) for this layer
+         */
+        bpm(value: number): void;
+        /**
+         * Get the unique identifier for this layer.
+         *
+         * @returns The layer's unique identifier
+         */
+        get id(): string;
+    }
+    interface Textmodifier {
+        /**
+         * Set the global BPM (Beats Per Minute) for array modulation timing.
+         *
+         * This sets the master tempo for all layers. Individual layers can override
+         * this with `layer.bpm(value)` for polyrhythmic compositions.
+         *
+         * In live coding, BPM controls how fast arrays cycle through their values.
+         * By default, BPM is 60, meaning arrays advance 1 element per second.
+         * At BPM 120, they advance 2 elements per second.
+         *
+         * @param value - BPM value (beats per minute)
+         * @returns The BPM value that was set (for chaining)
+         */
+        bpm(value: number): number;
+    }
+}
+//# sourceMappingURL=textmode.d.ts.map

package/dist/types/augmentations/textmode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"textmode.d.ts","sourceRoot":"","sources":["../../../src/augmentations/textmode.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,OAAO,QAAQ,aAAa,CAAC;IAC5B,UAAU,aAAa;QACtB;;;;;;;WAOG;QACH,KAAK,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;QAEjC;;;;;;;;WAQG;QACH,UAAU,IAAI,IAAI,CAAC;QAEnB;;;;;;;;WAQG;QACH,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QAEzB;;;;WAIG;QACH,IAAI,EAAE,IAAI,MAAM,CAAC;KACjB;IAED,UAAU,YAAY;QACrB;;;;;;;;;;;;WAYG;QACH,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;KAC3B;CACD"}

package/dist/types/bootstrap.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Bootstrap module - Initializes the synth system on import.
+ *
+ * This module handles all side-effect initialization required for
+ * the synth system to function. It runs once when the library is imported.
+ */
+/**
+ * Generated standalone functions for source transforms (e.g., osc(), noise())
+ */
+export declare const generatedFunctions: import("./transforms").GeneratedFunctions;
+//# sourceMappingURL=bootstrap.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../../src/bootstrap.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA8BH;;GAEG;AACH,eAAO,MAAM,kBAAkB,2CAAiD,CAAC"}

package/dist/types/compiler/ExternalLayerManager.d.ts

@@ -0,0 +1,60 @@
+import type { ExternalLayerInfo, CompilationTarget } from './types';
+import type { ExternalLayerReference } from '../core/types';
+/**
+ * Manages external layer references and uniform prefix generation.
+ *
+ * When a synth chain references another layer via `src(layer)`, this manager:
+ * 1. Generates unique uniform prefixes for the external layer's textures
+ * 2. Tracks which textures (char, primary, cellColor) are actually sampled
+ * 3. Provides mapping from layer IDs to uniform prefixes for code generation
+ */
+export declare class ExternalLayerManager {
+    /** Map from layer ID to external layer info */
+    private readonly _externalLayers;
+    /** Counter for generating unique uniform prefixes */
+    private _counter;
+    /** Map from layer ID to uniform prefix for consistent naming */
+    private readonly _layerIdToPrefix;
+    /**
+     * Get or create a uniform prefix for an external layer.
+     *
+     * @param layerId - Unique identifier for the layer
+     * @returns The uniform prefix (e.g., 'extLayer0', 'extLayer1')
+     */
+    getPrefix(layerId: string): string;
+    /**
+     * Track usage of an external layer's textures.
+     *
+     * @param ref - The external layer reference
+     * @param target - The current compilation target (determines which texture is sampled)
+     */
+    trackUsage(ref: ExternalLayerReference, target: CompilationTarget): void;
+    /**
+     * Check if a layer ID has been registered.
+     */
+    hasLayer(layerId: string): boolean;
+    /**
+     * Get info for a specific external layer.
+     */
+    getLayerInfo(layerId: string): ExternalLayerInfo | undefined;
+    /**
+     * Get all external layer references.
+     *
+     * @returns A new Map containing all external layer info
+     */
+    getExternalLayers(): Map<string, ExternalLayerInfo>;
+    /**
+     * Check if any external layers are referenced.
+     */
+    get hasExternalLayers(): boolean;
+    /**
+     * Get the count of external layers.
+     */
+    get count(): number;
+    /**
+     * Reset all external layer tracking state.
+     * Should be called at the start of each compilation.
+     */
+    reset(): void;
+}
+//# sourceMappingURL=ExternalLayerManager.d.ts.map

package/dist/types/compiler/ExternalLayerManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExternalLayerManager.d.ts","sourceRoot":"","sources":["../../../src/compiler/ExternalLayerManager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AACpE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAE5D;;;;;;;GAOG;AACH,qBAAa,oBAAoB;IAChC,+CAA+C;IAC/C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAwC;IAExE,qDAAqD;IACrD,OAAO,CAAC,QAAQ,CAAK;IAErB,gEAAgE;IAChE,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA6B;IAE9D;;;;;OAKG;IACI,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IASzC;;;;;OAKG;IACI,UAAU,CAAC,GAAG,EAAE,sBAAsB,EAAE,MAAM,EAAE,iBAAiB,GAAG,IAAI;IA+B/E;;OAEG;IACI,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAIzC;;OAEG;IACI,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAInE;;;;OAIG;IACI,iBAAiB,IAAI,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC;IAI1D;;OAEG;IACH,IAAW,iBAAiB,IAAI,OAAO,CAEtC;IAED;;OAEG;IACH,IAAW,KAAK,IAAI,MAAM,CAEzB;IAED;;;OAGG;IACI,KAAK,IAAI,IAAI;CAKpB"}

package/dist/types/compiler/FeedbackTracker.d.ts

@@ -0,0 +1,53 @@
+import type { CompilationTarget } from './types';
+/**
+ * Feedback usage state returned by the tracker.
+ */
+export interface FeedbackUsage {
+    /** Whether character color feedback (prevCharColorBuffer) is used */
+    usesCharColorFeedback: boolean;
+    /** Whether character feedback (prevCharBuffer) is used */
+    usesCharFeedback: boolean;
+    /** Whether cell color feedback (prevCellColorBuffer) is used */
+    usesCellColorFeedback: boolean;
+}
+/**
+ * Tracks which feedback textures are used during compilation.
+ *
+ * The synth system supports three separate feedback buffers:
+ * - Character color (character foreground)
+ * - Character data (character indices)
+ * - Cell color (character background)
+ *
+ * Each `src()` call samples from a context-aware buffer based on
+ * where it appears in the synth chain.
+ */
+export declare class FeedbackTracker {
+    private _usesFeedback;
+    private _usesCharFeedback;
+    private _usesCellColorFeedback;
+    /**
+     * Track feedback usage for a given compilation target.
+     * @param target - The current compilation target context
+     */
+    trackUsage(target: CompilationTarget): void;
+    /**
+     * Reset all feedback tracking state.
+     * Should be called at the start of each compilation.
+     */
+    reset(): void;
+    /**
+     * Get the current feedback usage state.
+     */
+    getUsage(): FeedbackUsage;
+    /**
+     * Check if any feedback is used.
+     */
+    get usesAnyFeedback(): boolean;
+    /** Whether character color feedback is used */
+    get usesCharColorFeedback(): boolean;
+    /** Whether character feedback is used */
+    get usesCharFeedback(): boolean;
+    /** Whether cell color feedback is used */
+    get usesCellColorFeedback(): boolean;
+}
+//# sourceMappingURL=FeedbackTracker.d.ts.map

package/dist/types/compiler/FeedbackTracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FeedbackTracker.d.ts","sourceRoot":"","sources":["../../../src/compiler/FeedbackTracker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC7B,qEAAqE;IACrE,qBAAqB,EAAE,OAAO,CAAC;IAC/B,0DAA0D;IAC1D,gBAAgB,EAAE,OAAO,CAAC;IAC1B,gEAAgE;IAChE,qBAAqB,EAAE,OAAO,CAAC;CAC/B;AAED;;;;;;;;;;GAUG;AACH,qBAAa,eAAe;IAC3B,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,sBAAsB,CAAS;IAEvC;;;OAGG;IACI,UAAU,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI;IAgBlD;;;OAGG;IACI,KAAK,IAAI,IAAI;IAMpB;;OAEG;IACI,QAAQ,IAAI,aAAa;IAQhC;;OAEG;IACH,IAAW,eAAe,IAAI,OAAO,CAEpC;IAED,+CAA+C;IAC/C,IAAW,qBAAqB,IAAI,OAAO,CAE1C;IAED,yCAAyC;IACzC,IAAW,gBAAgB,IAAI,OAAO,CAErC;IAED,0CAA0C;IAC1C,IAAW,qBAAqB,IAAI,OAAO,CAE1C;CACD"}

package/dist/types/compiler/GLSLGenerator.d.ts

@@ -26,9 +26,9 @@ export interface ShaderGenerationOptions {
     charMapping?: CharacterMapping;
     /** Whether primary color feedback (src) is used */
     usesFeedback?: boolean;
-    /** Whether character feedback (charSrc) is used */
+    /** Whether character feedback (src) is used */
     usesCharFeedback?: boolean;
-    /** Whether cell color feedback (cellColorSrc) is used */
+    /** Whether cell color feedback (src) is used */
     usesCellColorFeedback?: boolean;
     /** External layer references used in this shader */
     externalLayers?: Map<string, ExternalLayerInfo>;

package/dist/types/compiler/GLSLGenerator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GLSLGenerator.d.ts","sourceRoot":"","sources":["../../../src/compiler/GLSLGenerator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACpE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACvC,2BAA2B;IAC3B,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACpC,gCAAgC;IAChC,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC3B,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,4BAA4B;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB,kCAAkC;IAClC,eAAe,EAAE,MAAM,CAAC;IACxB,+BAA+B;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,iCAAiC;IACjC,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAC/B,mDAAmD;IACnD,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,mDAAmD;IACnD,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,yDAAyD;IACzD,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,oDAAoD;IACpD,cAAc,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;CAChD;AAuGD;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,uBAAuB,GAAG,MAAM,CAwG/E;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAC1C,UAAU,EAAE,OAAO,EACnB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACd,MAAM,CAaR"}
+{"version":3,"file":"GLSLGenerator.d.ts","sourceRoot":"","sources":["../../../src/compiler/GLSLGenerator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACpE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACvC,2BAA2B;IAC3B,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACpC,gCAAgC;IAChC,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC3B,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,4BAA4B;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB,kCAAkC;IAClC,eAAe,EAAE,MAAM,CAAC;IACxB,+BAA+B;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,iCAAiC;IACjC,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAC/B,mDAAmD;IACnD,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,+CAA+C;IAC/C,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,gDAAgD;IAChD,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,oDAAoD;IACpD,cAAc,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;CAChD;AAuGD;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,uBAAuB,GAAG,MAAM,CAyG/E;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAC1C,UAAU,EAAE,OAAO,EACnB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACd,MAAM,CAaR"}

package/dist/types/compiler/SynthCompiler.d.ts

@@ -6,6 +6,13 @@
  *   - Target 0: Character data (indexLow, indexHigh, packedFlags, rotation)
  *   - Target 1: Primary/foreground color (RGBA)
  *   - Target 2: Secondary/cell background color (RGBA)
+ *
+ * The compilation process is modular, delegating to:
+ *   - FeedbackTracker: Manages feedback texture usage
+ *   - ExternalLayerManager: Manages cross-layer sampling
+ *   - TransformCodeGenerator: Generates GLSL for individual transforms
+ *   - UniformManager: Manages shader uniforms
+ *   - GLSLGenerator: Assembles the final shader
  */
 import type { SynthSource } from '../core/SynthSource';
 import type { CompiledSynthShader } from './types';
@@ -16,5 +23,4 @@ import type { CompiledSynthShader } from './types';
  * @returns A compiled shader with fragment source and uniform definitions
  */
 export declare function compileSynthSource(source: SynthSource): CompiledSynthShader;
-export type { CompiledSynthShader } from './types';
 //# sourceMappingURL=SynthCompiler.d.ts.map

package/dist/types/compiler/SynthCompiler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SynthCompiler.d.ts","sourceRoot":"","sources":["../../../src/compiler/SynthCompiler.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,mBAAmB,EAAgE,MAAM,SAAS,CAAC;AAOjH;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,WAAW,GAAG,mBAAmB,CAG3E;AAigBD,YAAY,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC"}
+{"version":3,"file":"SynthCompiler.d.ts","sourceRoot":"","sources":["../../../src/compiler/SynthCompiler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,mBAAmB,EAA6C,MAAM,SAAS,CAAC;AAS9F;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,WAAW,GAAG,mBAAmB,CAG3E"}

package/dist/types/compiler/TransformCodeGenerator.d.ts

@@ -0,0 +1,77 @@
+import type { ProcessedTransform } from '../transforms/TransformDefinition';
+import type { CompilationTarget } from './types';
+import type { ExternalLayerReference } from '../core/types';
+/**
+ * Result of generating code for a transform.
+ */
+export interface TransformCodeResult {
+    /** The color variable name after this transform */
+    colorVar: string;
+    /** The character variable name (if modified) */
+    charVar?: string;
+    /** The flags variable name (if modified) */
+    flagsVar?: string;
+    /** The rotation variable name (if modified) */
+    rotationVar?: string;
+}
+/**
+ * Generates GLSL code for individual transforms.
+ *
+ * This module handles the code generation logic for each transform type,
+ * including context-aware function naming for src() operations.
+ */
+export declare class TransformCodeGenerator {
+    /**
+     * Generate a context-aware GLSL function for src().
+     *
+     * When the transform is 'src', this generates a context-specific GLSL function
+     * that samples the appropriate texture based on the current compilation target:
+     * - char context → samples prevCharBuffer
+     * - charColor/main context → samples prevCharColorBuffer (primary color)
+     * - cellColor context → samples prevCellColorBuffer
+     *
+     * For external layer references, generates a function that samples from
+     * the external layer's texture uniforms.
+     *
+     * @param def - The processed transform definition
+     * @param name - The transform name
+     * @param currentTarget - The current compilation target
+     * @param externalRef - Optional external layer reference
+     * @param getExternalPrefix - Function to get external layer uniform prefix
+     * @returns The GLSL function code
+     */
+    getContextAwareGlslFunction(def: ProcessedTransform, name: string, currentTarget: CompilationTarget, externalRef?: ExternalLayerReference, getExternalPrefix?: (layerId: string) => string): string;
+    /**
+     * Get the function name to call for a transform.
+     * Handles context-aware naming for src() operations.
+     */
+    getFunctionName(def: ProcessedTransform, currentTarget: CompilationTarget, externalRef?: ExternalLayerReference, getExternalPrefix?: (layerId: string) => string): string;
+    /**
+     * Generate GLSL code for a transform and append to mainCode.
+     *
+     * @param mainCode - Array to append generated code lines
+     * @param def - The processed transform definition
+     * @param varId - Unique variable ID for this transform
+     * @param coordVar - Current coordinate variable name
+     * @param colorVar - Current color variable name
+     * @param charVar - Current character variable name (if any)
+     * @param flagsVar - Current flags variable name (if any)
+     * @param rotationVar - Current rotation variable name (if any)
+     * @param args - Processed argument strings
+     * @param currentTarget - Current compilation target
+     * @param nestedColorVar - Nested source color variable (for combine ops)
+     * @param externalRef - External layer reference (if any)
+     * @param getExternalPrefix - Function to get external layer prefix
+     * @returns The transform code result with updated variable names
+     */
+    generateTransformCode(mainCode: string[], def: ProcessedTransform, varId: number, coordVar: string, colorVar: string, charVar: string | undefined, flagsVar: string | undefined, rotationVar: string | undefined, args: string[], currentTarget: CompilationTarget, nestedColorVar?: string, externalRef?: ExternalLayerReference, getExternalPrefix?: (layerId: string) => string): TransformCodeResult;
+    /**
+     * Generate GLSL function for external layer src().
+     */
+    private _generateExternalSrcFunction;
+    /**
+     * Generate GLSL function for self-feedback src().
+     */
+    private _generateSelfFeedbackSrcFunction;
+}
+//# sourceMappingURL=TransformCodeGenerator.d.ts.map

package/dist/types/compiler/TransformCodeGenerator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TransformCodeGenerator.d.ts","sourceRoot":"","sources":["../../../src/compiler/TransformCodeGenerator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAC5E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AACjD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,mBAAmB;IACnC,mDAAmD;IACnD,QAAQ,EAAE,MAAM,CAAC;IACjB,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+CAA+C;IAC/C,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAYD;;;;;GAKG;AACH,qBAAa,sBAAsB;IAClC;;;;;;;;;;;;;;;;;;OAkBG;IACI,2BAA2B,CACjC,GAAG,EAAE,kBAAkB,EACvB,IAAI,EAAE,MAAM,EACZ,aAAa,EAAE,iBAAiB,EAChC,WAAW,CAAC,EAAE,sBAAsB,EACpC,iBAAiB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,GAC7C,MAAM;IAcT;;;OAGG;IACI,eAAe,CACrB,GAAG,EAAE,kBAAkB,EACvB,aAAa,EAAE,iBAAiB,EAChC,WAAW,CAAC,EAAE,sBAAsB,EACpC,iBAAiB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,GAC7C,MAAM;IAaT;;;;;;;;;;;;;;;;;OAiBG;IACI,qBAAqB,CAC3B,QAAQ,EAAE,MAAM,EAAE,EAClB,GAAG,EAAE,kBAAkB,EACvB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,IAAI,EAAE,MAAM,EAAE,EACd,aAAa,EAAE,iBAAiB,EAChC,cAAc,CAAC,EAAE,MAAM,EACvB,WAAW,CAAC,EAAE,sBAAsB,EACpC,iBAAiB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,GAC7C,mBAAmB;IA6DtB;;OAEG;IACH,OAAO,CAAC,4BAA4B;IAuBpC;;OAEG;IACH,OAAO,CAAC,gCAAgC;CAUxC"}

package/dist/types/compiler/UniformManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"UniformManager.d.ts","sourceRoot":"","sources":["../../../src/compiler/UniformManager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,YAAY,EAAE,YAAY,EAAY,MAAM,eAAe,CAAC;AAC/F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAGxE;;GAEG;AACH,MAAM,WAAW,iBAAiB;IACjC,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,+BAA+B;IAC/B,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,+BAA+B;IAC/B,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,YAAY,KAAK,MAAM,GAAG,MAAM,EAAE,CAAC;CACnD;AAED;;;;;GAKG;AACH,qBAAa,cAAc;IAC1B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmC;IAC7D,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA+D;IAEhG;;OAEG;IACI,eAAe,CACrB,KAAK,EAAE,mBAAmB,EAC1B,KAAK,EAAE,cAAc,EACrB,MAAM,EAAE,MAAM,GACZ,iBAAiB;IAoEpB;;OAEG;IACH,OAAO,CAAC,cAAc;IAUtB;;OAEG;IACI,WAAW,IAAI,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC;IAI/C;;OAEG;IACI,kBAAkB,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,YAAY,KAAK,MAAM,GAAG,MAAM,EAAE,CAAC;IAIlF;;OAEG;IACI,KAAK,IAAI,IAAI;CAIpB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAG9C"}
+{"version":3,"file":"UniformManager.d.ts","sourceRoot":"","sources":["../../../src/compiler/UniformManager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,YAAY,EAAE,YAAY,EAAY,MAAM,eAAe,CAAC;AAC/F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAGxE;;GAEG;AACH,MAAM,WAAW,iBAAiB;IACjC,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,+BAA+B;IAC/B,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,+BAA+B;IAC/B,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,YAAY,KAAK,MAAM,GAAG,MAAM,EAAE,CAAC;CACnD;AAED;;;;;GAKG;AACH,qBAAa,cAAc;IAC1B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmC;IAC7D,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA+D;IAEhG;;OAEG;IACI,eAAe,CACrB,KAAK,EAAE,mBAAmB,EAC1B,KAAK,EAAE,cAAc,EACrB,MAAM,EAAE,MAAM,GACZ,iBAAiB;IAwEpB;;OAEG;IACH,OAAO,CAAC,cAAc;IAUtB;;OAEG;IACI,WAAW,IAAI,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC;IAI/C;;OAEG;IACI,kBAAkB,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,YAAY,KAAK,MAAM,GAAG,MAAM,EAAE,CAAC;IAIlF;;OAEG;IACI,KAAK,IAAI,IAAI;CAIpB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAG9C"}

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

@@ -1,9 +1,20 @@
 /**
  * Compiler module exports.
+ *
+ * The compiler system is modular, with responsibilities split across:
+ * - SynthCompiler: Main compilation orchestration
+ * - FeedbackTracker: Feedback texture usage tracking
+ * - ExternalLayerManager: Cross-layer sampling management
+ * - TransformCodeGenerator: Individual transform code generation
+ * - UniformManager: Shader uniform handling
+ * - GLSLGenerator: Final shader assembly
  */
 export * from './types';
-export * from './UniformManager';
-export * from './GLSLGenerator';
 export { compileSynthSource } from './SynthCompiler';
-export type { CompiledSynthShader } from './SynthCompiler';
+export type { CompiledSynthShader } from './types';
+export { FeedbackTracker, type FeedbackUsage } from './FeedbackTracker';
+export { ExternalLayerManager } from './ExternalLayerManager';
+export { TransformCodeGenerator, type TransformCodeResult } from './TransformCodeGenerator';
+export { UniformManager } from './UniformManager';
+export * from './GLSLGenerator';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/compiler/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,SAAS,CAAC;AACxB,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,YAAY,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/compiler/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,cAAc,SAAS,CAAC;AAGxB,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,YAAY,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAGnD,OAAO,EAAE,eAAe,EAAE,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACxE,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,sBAAsB,EAAE,KAAK,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC5F,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGlD,cAAc,iBAAiB,CAAC"}

package/dist/types/compiler/types.d.ts

@@ -6,9 +6,9 @@ import type { SynthUniform, SynthContext, CharacterMapping } from '../core/types
  * Compilation target context determining which texture `src()` samples from.
  *
  * - `char`: Compiling a character source chain → src() samples prevCharBuffer
- * - `charColor`: Compiling a character color chain → src() samples prevBuffer (primary color)
+ * - `charColor`: Compiling a character color chain → src() samples prevCharColorBuffer
  * - `cellColor`: Compiling a cell color chain → src() samples prevCellColorBuffer
- * - `main`: Compiling the main chain → src() samples prevBuffer (primary color)
+ * - `main`: Compiling the main chain → src() samples prevCharColorBuffer
  */
 export type CompilationTarget = 'char' | 'charColor' | 'cellColor' | 'main';
 /**
@@ -23,7 +23,7 @@ export interface ExternalLayerInfo {
     /** Whether the character texture is sampled */
     usesChar: boolean;
     /** Whether the primary color texture is sampled */
-    usesPrimary: boolean;
+    usesCharColor: boolean;
     /** Whether the cell color texture is sampled */
     usesCellColor: boolean;
 }
@@ -39,11 +39,11 @@ export interface CompiledSynthShader {
     dynamicUpdaters: Map<string, (ctx: SynthContext) => number | number[]>;
     /** Character mapping if charMap was used */
     charMapping?: CharacterMapping;
-    /** Whether this shader uses feedback (src/prev) - reads from prevBuffer */
-    usesFeedback: boolean;
-    /** Whether this shader uses character feedback (charSrc) - reads from prevCharBuffer */
+    /** Whether this shader uses character color feedback (src) - reads from prevCharColorBuffer */
+    usesCharColorFeedback: boolean;
+    /** Whether this shader uses character feedback (src) - reads from prevCharBuffer */
     usesCharFeedback: boolean;
-    /** Whether this shader uses cell color feedback (cellColorSrc) - reads from prevCellColorBuffer */
+    /** Whether this shader uses cell color feedback (src) - reads from prevCellColorBuffer */
     usesCellColorFeedback: boolean;
     /** External layer references used in this shader, keyed by layer ID */
     externalLayers: Map<string, ExternalLayerInfo>;

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/compiler/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAElF;;;;;;;GAOG;AACH,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,WAAW,GAAG,WAAW,GAAG,MAAM,CAAC;AAE5E;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IACjC,8DAA8D;IAC9D,OAAO,EAAE,MAAM,CAAC;IAChB,mEAAmE;IACnE,aAAa,EAAE,MAAM,CAAC;IACtB,+CAA+C;IAC/C,QAAQ,EAAE,OAAO,CAAC;IAClB,mDAAmD;IACnD,WAAW,EAAE,OAAO,CAAC;IACrB,gDAAgD;IAChD,aAAa,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IACnC,sCAAsC;IACtC,cAAc,EAAE,MAAM,CAAC;IACvB,qDAAqD;IACrD,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACpC,qDAAqD;IACrD,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,YAAY,KAAK,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;IACvE,4CAA4C;IAC5C,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAC/B,2EAA2E;IAC3E,YAAY,EAAE,OAAO,CAAC;IACtB,wFAAwF;IACxF,gBAAgB,EAAE,OAAO,CAAC;IAC1B,mGAAmG;IACnG,qBAAqB,EAAE,OAAO,CAAC;IAC/B,uEAAuE;IACvE,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;CAC/C;AAED;;GAEG;AACH,MAAM,WAAW,MAAM;IACtB,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,iEAAiE;IACjE,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,iEAAiE;IACjE,cAAc,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACtC,uCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,kCAAkC;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iCAAiC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IACjC,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC3B,kCAAkC;IAClC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,yBAAyB;IACzB,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACpC,+BAA+B;IAC/B,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,YAAY,KAAK,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;CACvE"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/compiler/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAElF;;;;;;;GAOG;AACH,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,WAAW,GAAG,WAAW,GAAG,MAAM,CAAC;AAE5E;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IACjC,8DAA8D;IAC9D,OAAO,EAAE,MAAM,CAAC;IAChB,mEAAmE;IACnE,aAAa,EAAE,MAAM,CAAC;IACtB,+CAA+C;IAC/C,QAAQ,EAAE,OAAO,CAAC;IAClB,mDAAmD;IACnD,aAAa,EAAE,OAAO,CAAC;IACvB,gDAAgD;IAChD,aAAa,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IACnC,sCAAsC;IACtC,cAAc,EAAE,MAAM,CAAC;IACvB,qDAAqD;IACrD,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACpC,qDAAqD;IACrD,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,YAAY,KAAK,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;IACvE,4CAA4C;IAC5C,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAC/B,+FAA+F;IAC/F,qBAAqB,EAAE,OAAO,CAAC;IAC/B,oFAAoF;IACpF,gBAAgB,EAAE,OAAO,CAAC;IAC1B,0FAA0F;IAC1F,qBAAqB,EAAE,OAAO,CAAC;IAC/B,uEAAuE;IACvE,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;CAC/C;AAED;;GAEG;AACH,MAAM,WAAW,MAAM;IACtB,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,iEAAiE;IACjE,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,iEAAiE;IACjE,cAAc,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACtC,uCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,kCAAkC;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iCAAiC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IACjC,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC3B,kCAAkC;IAClC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,yBAAyB;IACzB,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACpC,+BAA+B;IAC/B,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,YAAY,KAAK,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;CACvE"}

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

@@ -0,0 +1,30 @@
+/**
+ * Global state for textmode.synth.js.
+ *
+ * This module maintains global configuration that affects all layers,
+ * such as the master BPM for array modulation timing.
+ */
+/**
+ * Set the global BPM for all layers.
+ *
+ * This sets the master tempo for array cycling. Layers will use this value
+ * unless they have a layer-specific BPM set via layer.bpm().
+ *
+ * @param value - BPM value (beats per minute)
+ *
+ * @example
+ * ```typescript
+ * // Set global tempo to 120 BPM (2 beats per second)
+ * t.bpm(120);
+ *
+ * // All layers will now cycle through arrays at this speed
+ * t.layers.base.synth(osc([1, 2, 4, 8])); // Cycles twice as fast as default
+ * ```
+ */
+export declare function setGlobalBpm(value: number): void;
+/**
+ * Get the current global BPM.
+ * @returns Current global BPM value
+ */
+export declare function getGlobalBpm(): number;
+//# sourceMappingURL=GlobalState.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GlobalState.d.ts","sourceRoot":"","sources":["../../../src/core/GlobalState.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAEhD;AAED;;;GAGG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC"}