@stevejtrettel/shader-sandbox 0.1.0

package/dist-lib/engine/ShadertoyEngine.d.ts

@@ -0,0 +1,160 @@
+/**
+ * Engine - Shadertoy Execution Engine
+ *
+ * Implements the execution model described in docs/engine-spec.md.
+ *
+ * Responsibilities:
+ *  - Own WebGL resources for passes (programs, VAOs, textures, FBOs).
+ *  - Execute passes each frame in Shadertoy order: BufferA→BufferB→BufferC→BufferD→Image.
+ *  - Bind Shadertoy uniforms (iResolution, iTime, iTimeDelta, iFrame, iMouse).
+ *  - Bind iChannel0..3 according to ChannelSource.
+ */
+import { ShadertoyProject, PassName } from '../project/types';
+import { EngineOptions, EngineStats } from './types';
+export declare class ShadertoyEngine {
+    readonly project: ShadertoyProject;
+    readonly gl: WebGL2RenderingContext;
+    private _width;
+    private _height;
+    private _frame;
+    private _time;
+    private _lastStepTime;
+    private _passes;
+    private _textures;
+    private _keyboardTexture;
+    private _blackTexture;
+    private _keyStates;
+    private _toggleStates;
+    private _compilationErrors;
+    constructor(opts: EngineOptions);
+    get width(): number;
+    get height(): number;
+    get stats(): EngineStats;
+    /**
+     * Get shader compilation errors (if any occurred during initialization).
+     * Returns empty array if all shaders compiled successfully.
+     */
+    getCompilationErrors(): Array<{
+        passName: PassName;
+        error: string;
+        source: string;
+        isFromCommon: boolean;
+        originalLine: number | null;
+    }>;
+    /**
+     * Check if there were any compilation errors.
+     */
+    hasErrors(): boolean;
+    /**
+     * Get the framebuffer for the Image pass (for presenting to screen).
+     */
+    getImageFramebuffer(): WebGLFramebuffer | null;
+    /**
+     * Run one full frame of all passes.
+     *
+     * @param timeSeconds - global time in seconds (monotone, from App)
+     * @param mouse - iMouse as [x, y, clickX, clickY]
+     */
+    step(timeSeconds: number, mouse: [number, number, number, number]): void;
+    /**
+     * Resize all internal render targets to new width/height.
+     * Does not reset time or frame count.
+     */
+    resize(width: number, height: number): void;
+    /**
+     * Reset frame counter and clear all render targets.
+     * Used for playback controls to restart shader from frame 0.
+     */
+    reset(): void;
+    /**
+     * Update keyboard key state (called from App on keydown/keyup events).
+     *
+     * @param keycode ASCII keycode (e.g., 65 for 'A')
+     * @param isDown true if key pressed, false if released
+     */
+    updateKeyState(keycode: number, isDown: boolean): void;
+    /**
+     * Update keyboard texture with current key states.
+     * Should be called once per frame before rendering.
+     */
+    updateKeyboardTexture(): void;
+    /**
+     * Recompile a single pass with new GLSL source code.
+     * Used for live editing - keeps the old shader running if compilation fails.
+     *
+     * @param passName - Name of the pass to recompile ('Image', 'BufferA', etc.)
+     * @param newSource - New GLSL source code for the pass
+     * @returns Object with success status and error message if failed
+     */
+    recompilePass(passName: PassName, newSource: string): {
+        success: boolean;
+        error?: string;
+    };
+    /**
+     * Recompile common.glsl and all passes that use it.
+     * Used for live editing of common code.
+     *
+     * @param newCommonSource - New GLSL source code for common.glsl
+     * @returns Object with success status and errors for each failed pass
+     */
+    recompileCommon(newCommonSource: string): {
+        success: boolean;
+        errors: Array<{
+            passName: PassName;
+            error: string;
+        }>;
+    };
+    /**
+     * Delete all GL resources.
+     */
+    dispose(): void;
+    private initExtensions;
+    /**
+     * Initialize external textures based on project.textures.
+     *
+     * NOTE: This function as written assumes that actual image loading
+     * is handled elsewhere. For now we just construct an empty array.
+     * In a real implementation, you would load images here.
+     */
+    private initProjectTextures;
+    /**
+     * Compile shaders, create VAOs/FBOs/textures, and build RuntimePass array.
+     */
+    private initRuntimePasses;
+    /**
+     * Calculate line number mappings for error reporting.
+     * Returns info about where common.glsl code lives in the compiled shader.
+     */
+    private getLineMapping;
+    /**
+     * Build complete fragment shader source with Shadertoy boilerplate.
+     *
+     * @param userSource - The user's GLSL source code
+     * @param channels - Channel configuration for this pass (to detect cubemap textures)
+     */
+    private buildFragmentShader;
+    /**
+     * Preprocess shader to convert cubemap-style texture() calls to equirectangular.
+     *
+     * Uses the channel configuration to determine which channels are cubemaps.
+     * Only channels explicitly marked as `type: 'cubemap'` in config.json will have
+     * their texture() calls wrapped with _st_dirToEquirect().
+     *
+     * @param source - User's GLSL source code
+     * @param channels - Channel configuration for this pass
+     */
+    private preprocessCubemapTextures;
+    private executePass;
+    private bindBuiltinUniforms;
+    private bindChannelTextures;
+    /**
+     * Resolve a ChannelSource to an actual WebGLTexture to bind.
+     */
+    private resolveChannelTexture;
+    /**
+     * Swap current and previous textures for a pass (ping-pong).
+     * Also reattach framebuffer to new current texture.
+     */
+    private swapPassTextures;
+}
+//# sourceMappingURL=ShadertoyEngine.d.ts.map

package/dist-lib/engine/ShadertoyEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShadertoyEngine.d.ts","sourceRoot":"","sources":["../../src/engine/ShadertoyEngine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EACL,gBAAgB,EAEhB,QAAQ,EACT,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,aAAa,EAIb,WAAW,EAEZ,MAAM,SAAS,CAAC;AAkDjB,qBAAa,eAAe;IAC1B,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC;IACnC,QAAQ,CAAC,EAAE,EAAE,sBAAsB,CAAC;IAEpC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAS;IAExB,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,KAAK,CAAa;IAC1B,OAAO,CAAC,aAAa,CAAuB;IAE5C,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,SAAS,CAA0B;IAC3C,OAAO,CAAC,gBAAgB,CAAuC;IAE/D,OAAO,CAAC,aAAa,CAA6B;IAGlD,OAAO,CAAC,UAAU,CAAmC;IACrD,OAAO,CAAC,aAAa,CAAkC;IAGvD,OAAO,CAAC,kBAAkB,CAMlB;gBAEI,IAAI,EAAE,aAAa;IAmC/B,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,IAAI,KAAK,IAAI,WAAW,CASvB;IAED;;;OAGG;IACH,oBAAoB,IAAI,KAAK,CAAC;QAC5B,QAAQ,EAAE,QAAQ,CAAC;QACnB,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,YAAY,EAAE,OAAO,CAAC;QACtB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;KAC7B,CAAC;IAIF;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACH,mBAAmB,IAAI,gBAAgB,GAAG,IAAI;IAK9C;;;;;OAKG;IACH,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAyCxE;;;OAGG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAsB3C;;;OAGG;IACH,KAAK,IAAI,IAAI;IAkCb;;;;;OAKG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI;IAatD;;;OAGG;IACH,qBAAqB,IAAI,IAAI;IAa7B;;;;;;;OAOG;IACH,aAAa,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,GAAG;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;IAyD1F;;;;;;OAMG;IACH,eAAe,CAAC,eAAe,EAAE,MAAM,GAAG;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,KAAK,CAAC;YAAE,QAAQ,EAAE,QAAQ,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE;IA0CpH;;OAEG;IACH,OAAO,IAAI,IAAI;IAsCf,OAAO,CAAC,cAAc;IAgBtB;;;;;;OAMG;IACH,OAAO,CAAC,mBAAmB;IA4D3B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA0FzB;;;OAGG;IACH,OAAO,CAAC,cAAc;IAWtB;;;;;OAKG;IACH,OAAO,CAAC,mBAAmB;IA0C3B;;;;;;;;;OASG;IACH,OAAO,CAAC,yBAAyB;IA+BjC,OAAO,CAAC,WAAW;IAoCnB,OAAO,CAAC,mBAAmB;IAiC3B,OAAO,CAAC,mBAAmB;IAmB3B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA4C7B;;;OAGG;IACH,OAAO,CAAC,gBAAgB;CAmBzB"}