@rosalana/sandbox 0.0.5 → 0.1.0

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import type { AnyUniformValue, HookCallback, SandboxOptions, UniformSchema, WebGLVersion } from "./types";
+import type { AnyUniformValue, HookCallback, ModuleDefinition, SandboxOptions, UniformSchema, WebGLVersion } from "./types";
 export * from "./types";
 export * from "./errors";
 /**
@@ -50,6 +50,34 @@ export declare class Sandbox {
      * });
      */
     static create(canvas: HTMLCanvasElement, options?: SandboxOptions): Sandbox;
+    /**
+     * Define a shader module that can be imported in shader source with `#import <function> from "module_name"`.
+     * @example
+     * Sandbox.defineModule("my_module", source, { options });
+     * // Then in shader:
+     * // #import myFunc from "my_module"
+     * // void main() {
+     * //   myFunc();
+     * // }
+     */
+    static defineModule(name: ModuleDefinition["name"], source: ModuleDefinition["source"], options?: ModuleDefinition["options"]): void;
+    /**
+     * Get the list of available shader modules that can be used with `#import` in shader source.
+     */
+    static availableModules(): {
+        name: string;
+        methods: string[];
+        uniforms: {
+            name: string;
+            type: import("./types").GLSLType;
+        }[];
+        options: Record<string, Record<string, import("./types").ModuleMethodOption>> | undefined;
+    }[];
+    /**
+     * Compile a shader source with Sandbox's shader preprocessor and return the final GLSL code.
+     * This is useful for debugging shader code or precompiling shaders for production use.
+     */
+    static compile(shaderSource: string): string;
     private resolveOptions;
     private setupListeners;
     private destroyListeners;
@@ -95,6 +123,14 @@ export declare class Sandbox {
      * sandbox.setFragment(fragmentSource);
      */
     setFragment(fragment: string): this;
+    /**
+     * Get current fragment shader source.
+     */
+    getFragment(): string;
+    /**
+     * Get current vertex shader source.
+     */
+    getVertex(): string;
     /**
      * Set the max frame rate runtime
      *
@@ -107,6 +143,12 @@ export declare class Sandbox {
      * Add a runtime render hook.
      */
     hook(callback: HookCallback, when?: "before" | "after"): () => void;
+    /**
+     * Runtime configure the module behavior
+     * @example
+     * sandbox.module("my_module", { intensity: 0.5 });
+     */
+    module<T extends Record<string, AnyUniformValue>>(name: string, config: T): this;
     /**
      * Start animation loop.
      */