@stevejtrettel/shader-sandbox 0.1.2 → 0.1.4

package/dist-lib/project/types.d.ts

@@ -5,6 +5,133 @@
  * Based on docs/project-spec.md
  */
 export type PassName = 'Image' | 'BufferA' | 'BufferB' | 'BufferC' | 'BufferD';
+/**
+ * Theme mode for the shader viewer.
+ * - 'light': Always use light theme
+ * - 'dark': Always use dark theme
+ * - 'system': Follow OS preference (prefers-color-scheme)
+ */
+export type ThemeMode = 'light' | 'dark' | 'system';
+/**
+ * Supported uniform types for user-defined controls.
+ * For now, we start with float only. More types will be added later.
+ */
+export type UniformType = 'float' | 'int' | 'bool' | 'vec2' | 'vec3' | 'vec4';
+/**
+ * Base uniform definition shared by all types.
+ */
+interface UniformDefinitionBase {
+    /** Display label (defaults to uniform name if not provided) */
+    label?: string;
+    /** If true, uniform is declared but has no UI control (for script-only uniforms) */
+    hidden?: boolean;
+}
+/**
+ * Float uniform with slider control.
+ */
+export interface FloatUniformDefinition extends UniformDefinitionBase {
+    type: 'float';
+    value: number;
+    min?: number;
+    max?: number;
+    step?: number;
+}
+/**
+ * Integer uniform with discrete slider.
+ */
+export interface IntUniformDefinition extends UniformDefinitionBase {
+    type: 'int';
+    value: number;
+    min?: number;
+    max?: number;
+    step?: number;
+}
+/**
+ * Boolean uniform with toggle control.
+ */
+export interface BoolUniformDefinition extends UniformDefinitionBase {
+    type: 'bool';
+    value: boolean;
+}
+/**
+ * Vec2 uniform (2D position picker).
+ */
+export interface Vec2UniformDefinition extends UniformDefinitionBase {
+    type: 'vec2';
+    value: [number, number];
+    min?: [number, number];
+    max?: [number, number];
+}
+/**
+ * Vec3 uniform (color picker or 3D value).
+ */
+export interface Vec3UniformDefinition extends UniformDefinitionBase {
+    type: 'vec3';
+    value: [number, number, number];
+    /** If true, use color picker UI. Otherwise use 3 sliders. */
+    color?: boolean;
+    /** Per-component min (default: [0, 0, 0]) */
+    min?: [number, number, number];
+    /** Per-component max (default: [1, 1, 1]) */
+    max?: [number, number, number];
+    /** Per-component step (default: [0.01, 0.01, 0.01]) */
+    step?: [number, number, number];
+}
+/**
+ * Vec4 uniform (color with alpha or 4D value).
+ */
+export interface Vec4UniformDefinition extends UniformDefinitionBase {
+    type: 'vec4';
+    value: [number, number, number, number];
+    /** If true, use color picker with alpha. Otherwise use 4 sliders. */
+    color?: boolean;
+    /** Per-component min (default: [0, 0, 0, 0]) */
+    min?: [number, number, number, number];
+    /** Per-component max (default: [1, 1, 1, 1]) */
+    max?: [number, number, number, number];
+    /** Per-component step (default: [0.01, 0.01, 0.01, 0.01]) */
+    step?: [number, number, number, number];
+}
+/**
+ * Array uniform types supported in UBOs.
+ */
+export type ArrayUniformType = 'float' | 'vec2' | 'vec3' | 'vec4' | 'mat3' | 'mat4';
+/**
+ * Array uniform backed by a Uniform Buffer Object (UBO).
+ * Data is provided from JavaScript via setUniformValue().
+ * The engine auto-injects the layout(std140) uniform block into the shader.
+ */
+export interface ArrayUniformDefinition extends UniformDefinitionBase {
+    type: ArrayUniformType;
+    /** Number of elements in the array */
+    count: number;
+}
+/**
+ * Type guard: returns true if a uniform definition is an array uniform (has count).
+ */
+export declare function isArrayUniform(def: UniformDefinition): def is ArrayUniformDefinition;
+/**
+ * Returns true if a uniform should have a UI control.
+ * Excludes array uniforms (UBOs) and hidden uniforms (script-only).
+ */
+export declare function hasUIControl(def: UniformDefinition): boolean;
+/**
+ * Union of all uniform definition types.
+ */
+export type UniformDefinition = FloatUniformDefinition | IntUniformDefinition | BoolUniformDefinition | Vec2UniformDefinition | Vec3UniformDefinition | Vec4UniformDefinition | ArrayUniformDefinition;
+/**
+ * Map of uniform names to their definitions.
+ */
+export type UniformDefinitions = Record<string, UniformDefinition>;
+/**
+ * A single uniform value at runtime.
+ */
+export type UniformValue = number | boolean | number[] | Float32Array;
+/**
+ * Runtime uniform values (current state).
+ * Keys are uniform names, values are the current value.
+ */
+export type UniformValues = Record<string, UniformValue>;
 /**
  * Reference to another buffer pass.
  * By default, reads the previous frame (safe for all cases).
@@ -29,18 +156,48 @@ export interface ChannelJSONTexture {
 export interface ChannelJSONKeyboard {
     keyboard: true;
 }
+/**
+ * Reference to audio input (microphone).
+ * Provides a 512x2 texture: row 0 = FFT spectrum, row 1 = waveform.
+ */
+export interface ChannelJSONAudio {
+    audio: true;
+}
+/**
+ * Reference to webcam input.
+ */
+export interface ChannelJSONWebcam {
+    webcam: true;
+}
+/**
+ * Reference to a video file.
+ */
+export interface ChannelJSONVideo {
+    video: string;
+}
+/**
+ * Reference to a script-uploaded texture.
+ * The texture is created/updated at runtime via engine.updateTexture().
+ */
+export interface ChannelJSONScript {
+    script: string;
+}
 /**
  * Union type for channel sources in JSON config (object form).
  */
-export type ChannelJSONObject = ChannelJSONBuffer | ChannelJSONTexture | ChannelJSONKeyboard;
+export type ChannelJSONObject = ChannelJSONBuffer | ChannelJSONTexture | ChannelJSONKeyboard | ChannelJSONAudio | ChannelJSONWebcam | ChannelJSONVideo | ChannelJSONScript;
 /**
  * Channel value in simplified config format.
  * Can be a string shorthand or full object:
  * - "BufferA", "BufferB", etc. → buffer reference
  * - "keyboard" → keyboard input
+ * - "audio" → microphone audio input
+ * - "webcam" → webcam video input
  * - "photo.jpg" (with extension) → texture file
  * - { buffer: "BufferA" } → explicit buffer with options
  * - { texture: "photo.jpg", filter: "nearest" } → texture with options
+ * - { video: "clip.mp4" } → video file
+ * - { script: "myData" } → script-uploaded texture
  */
 export type ChannelValue = string | ChannelJSONObject;
 /**
@@ -81,18 +238,71 @@ export interface PassConfigSimplified {
  * }
  */
 export interface ShadertoyConfig {
+    /** Must be 'shadertoy' to use Shadertoy-compatible iChannel mode. */
+    mode: 'shadertoy';
+    title?: string;
+    author?: string;
+    description?: string;
+    layout?: 'fullscreen' | 'default' | 'split' | 'tabbed';
+    theme?: ThemeMode;
+    controls?: boolean;
+    common?: string;
+    /** Start paused on first frame (default: false) */
+    startPaused?: boolean;
+    /** Pixel ratio multiplier (default: window.devicePixelRatio). Use <1 for lower resolution. */
+    pixelRatio?: number;
+    Image?: PassConfigSimplified;
+    BufferA?: PassConfigSimplified;
+    BufferB?: PassConfigSimplified;
+    BufferC?: PassConfigSimplified;
+    BufferD?: PassConfigSimplified;
+}
+/**
+ * Per-buffer configuration in standard mode.
+ */
+export interface StandardBufferConfig {
+    filter?: 'nearest' | 'linear';
+    wrap?: 'clamp' | 'repeat';
+}
+/**
+ * Standard mode config format.
+ * Buffers and textures are available everywhere by name.
+ * Also supports pass-level configs (Image, BufferA, etc.) for simple cases
+ * where named buffers aren't needed.
+ */
+export interface StandardConfig {
+    mode?: 'standard';
     title?: string;
     author?: string;
     description?: string;
     layout?: 'fullscreen' | 'default' | 'split' | 'tabbed';
+    theme?: ThemeMode;
     controls?: boolean;
     common?: string;
+    startPaused?: boolean;
+    pixelRatio?: number;
+    uniforms?: UniformDefinitions;
+    /**
+     * Named buffers (framebuffers with ping-pong).
+     * Array shorthand ["velocity"] normalizes to { "velocity": {} }.
+     * Max 4 buffers (maps to BufferA-D internally).
+     */
+    buffers?: string[] | Record<string, StandardBufferConfig>;
+    /**
+     * Named textures available in all passes.
+     * Value is a file path or special source: "keyboard", "audio", "webcam".
+     */
+    textures?: Record<string, string>;
     Image?: PassConfigSimplified;
     BufferA?: PassConfigSimplified;
     BufferB?: PassConfigSimplified;
     BufferC?: PassConfigSimplified;
     BufferD?: PassConfigSimplified;
 }
+/**
+ * Union of all config formats that can appear in config.json.
+ */
+export type ProjectConfig = ShadertoyConfig | StandardConfig;
 /**
  * Normalized channel source for engine consumption.
  * All channels are represented as one of these discriminated union variants.
@@ -109,6 +319,16 @@ export type ChannelSource = {
     cubemap: boolean;
 } | {
     kind: 'keyboard';
+} | {
+    kind: 'audio';
+} | {
+    kind: 'webcam';
+} | {
+    kind: 'video';
+    src: string;
+} | {
+    kind: 'script';
+    name: string;
 };
 /**
  * Exactly 4 channels (iChannel0-3), matching Shadertoy's fixed channel count.
@@ -118,7 +338,7 @@ export type Channels = [ChannelSource, ChannelSource, ChannelSource, ChannelSour
  * External 2D texture loaded from image file.
  * Textures are deduplicated by (source, filter, wrap) tuple.
  */
-export interface ShadertoyTexture2D {
+export interface ShaderTexture2D {
     name: string;
     filename?: string;
     source: string;
@@ -128,22 +348,24 @@ export interface ShadertoyTexture2D {
 /**
  * A single shader pass in the rendering pipeline.
  */
-export interface ShadertoyPass {
+export interface ShaderPass {
     name: PassName;
     glslSource: string;
     channels: Channels;
+    /** Named samplers (standard mode). Maps sampler name → source. */
+    namedSamplers?: Map<string, ChannelSource>;
 }
 /**
  * Project metadata (title, author, description).
  */
-export interface ShadertoyMeta {
+export interface ShaderMeta {
     title: string;
     author: string | null;
     description: string | null;
 }
 /**
  * Complete in-memory representation of a Shadertoy project.
- * Produced by loadProject() and consumed by ShadertoyEngine.
+ * Produced by loadProject() and consumed by ShaderEngine.
  *
  * Guarantees:
  * - passes.Image always exists
@@ -151,7 +373,12 @@ export interface ShadertoyMeta {
  * - Textures are deduplicated
  * - All paths resolved and GLSL loaded
  */
-export interface ShadertoyProject {
+export interface ShaderProject {
+    /**
+     * Project mode. 'shadertoy' uses iChannel0-3, 'standard' uses named samplers.
+     * Defaults to 'standard' if not specified.
+     */
+    mode: 'shadertoy' | 'standard';
     /**
      * Project root directory path.
      */
@@ -159,15 +386,31 @@ export interface ShadertoyProject {
     /**
      * Project metadata.
      */
-    meta: ShadertoyMeta;
+    meta: ShaderMeta;
     /**
      * Layout mode for the shader viewer.
      */
     layout: 'fullscreen' | 'default' | 'split' | 'tabbed';
+    /**
+     * Theme mode for the shader viewer.
+     * Defaults to 'light' if not specified.
+     */
+    theme: ThemeMode;
     /**
      * Whether to show playback controls (play/pause, reset).
      */
     controls: boolean;
+    /**
+     * Whether to start paused on first frame.
+     * Defaults to false.
+     */
+    startPaused: boolean;
+    /**
+     * Pixel ratio for resolution scaling.
+     * Defaults to null (use window.devicePixelRatio).
+     * Use values < 1 for lower resolution (better performance).
+     */
+    pixelRatio: number | null;
     /**
      * Common GLSL code (prepended to all shaders), or null if none.
      */
@@ -177,16 +420,52 @@ export interface ShadertoyProject {
      * Image is always present, BufferA-D are optional.
      */
     passes: {
-        Image: ShadertoyPass;
-        BufferA?: ShadertoyPass;
-        BufferB?: ShadertoyPass;
-        BufferC?: ShadertoyPass;
-        BufferD?: ShadertoyPass;
+        Image: ShaderPass;
+        BufferA?: ShaderPass;
+        BufferB?: ShaderPass;
+        BufferC?: ShaderPass;
+        BufferD?: ShaderPass;
     };
     /**
      * Deduplicated list of external textures.
      * All ChannelSource with kind: 'texture2D' refer to names in this list.
      */
-    textures: ShadertoyTexture2D[];
+    textures: ShaderTexture2D[];
+    /**
+     * Custom uniform definitions from config.
+     * Users must declare these uniforms in their shader code.
+     * Array uniforms (with count) are auto-declared by the engine.
+     */
+    uniforms: UniformDefinitions;
+    /**
+     * Demo script hooks (from script.js in demo folder).
+     * Provides setup() and onFrame() callbacks for JS-driven computation.
+     */
+    script: DemoScriptHooks | null;
+}
+/**
+ * The API surface exposed to script.js hooks.
+ * A restricted view of the engine for safety and clarity.
+ */
+export interface ScriptEngineAPI {
+    setUniformValue(name: string, value: UniformValue): void;
+    getUniformValue(name: string): UniformValue | undefined;
+    /** Upload or update a named texture for use as a script channel. */
+    updateTexture(name: string, width: number, height: number, data: Uint8Array | Float32Array): void;
+    /** Read pixels from a buffer pass (previous frame). Returns RGBA Uint8Array. */
+    readPixels(passName: string, x: number, y: number, width: number, height: number): Uint8Array;
+    readonly width: number;
+    readonly height: number;
+}
+/**
+ * Hooks exported by a demo's script.js file.
+ * Both are optional — a script can export just setup, just onFrame, or both.
+ */
+export interface DemoScriptHooks {
+    /** Called once after engine init, before the first frame */
+    setup?: (engine: ScriptEngineAPI) => void;
+    /** Called every frame before shader execution */
+    onFrame?: (engine: ScriptEngineAPI, time: number, deltaTime: number, frame: number) => void;
 }
+export {};
 //# sourceMappingURL=types.d.ts.map

package/dist-lib/project/types.d.ts.map

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

package/dist-lib/project/types.js

@@ -4,4 +4,16 @@
  * Pure TypeScript interfaces matching Shadertoy's mental model.
  * Based on docs/project-spec.md
  */
-export {};
+/**
+ * Type guard: returns true if a uniform definition is an array uniform (has count).
+ */
+export function isArrayUniform(def) {
+    return 'count' in def && typeof def.count === 'number';
+}
+/**
+ * Returns true if a uniform should have a UI control.
+ * Excludes array uniforms (UBOs) and hidden uniforms (script-only).
+ */
+export function hasUIControl(def) {
+    return !isArrayUniform(def) && !def.hidden;
+}

package/dist-lib/styles/base.css

@@ -2,6 +2,8 @@
  * Base Styles - Global resets and root element styling
  */
 
+@import './theme.css';
+
 * {
   margin: 0;
   padding: 0;
@@ -16,7 +18,9 @@ html, body {
 }
 
 body {
-  background: #f5f5f5;
+  background: var(--bg-primary);
+  color: var(--text-primary);
+  transition: background-color 0.2s ease, color 0.2s ease;
 }
 
 #app {

package/dist-lib/uniforms/UniformControls.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Uniform Controls Component
+ *
+ * Renders UI controls for custom uniforms defined in config.json.
+ * Supports: float, int, bool, vec2 (XY pad), vec3 (color picker or sliders), vec4 (sliders)
+ */
+import './uniform-controls.css';
+import { UniformDefinitions, UniformValue, UniformValues } from '../project/types';
+export interface UniformControlsOptions {
+    /** Container element to mount controls into */
+    container: HTMLElement;
+    /** Uniform definitions from project config */
+    uniforms: UniformDefinitions;
+    /** Callback when a uniform value changes */
+    onChange: (name: string, value: UniformValue) => void;
+    /** Initial values (optional, defaults to definition values) */
+    initialValues?: UniformValues;
+}
+export declare class UniformControls {
+    private container;
+    private uniforms;
+    private onChange;
+    private values;
+    private updaters;
+    private documentListeners;
+    constructor(opts: UniformControlsOptions);
+    /**
+     * Render all uniform controls.
+     */
+    private render;
+    /**
+     * Create a control element for a uniform.
+     */
+    private createControl;
+    private createSliderRow;
+    private createFloatSlider;
+    private createIntSlider;
+    private createBoolToggle;
+    private createVec2Pad;
+    private createColorPicker;
+    private createColorPicker4;
+    private createVecSliders;
+    private formatNumber;
+    private formatVec2;
+    private rgbToHex;
+    private hexToRgb;
+    /**
+     * Update a uniform value externally (e.g., from reset).
+     */
+    setValue(name: string, value: UniformValue): void;
+    /**
+     * Reset all uniforms to their default values.
+     */
+    resetToDefaults(): void;
+    /**
+     * Destroy the controls and clean up.
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=UniformControls.d.ts.map

package/dist-lib/uniforms/UniformControls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UniformControls.d.ts","sourceRoot":"","sources":["../../src/uniforms/UniformControls.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,wBAAwB,CAAC;AAEhC,OAAO,EACL,kBAAkB,EAElB,YAAY,EACZ,aAAa,EAQd,MAAM,kBAAkB,CAAC;AAE1B,MAAM,WAAW,sBAAsB;IACrC,+CAA+C;IAC/C,SAAS,EAAE,WAAW,CAAC;IACvB,8CAA8C;IAC9C,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,4CAA4C;IAC5C,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;IACtD,+DAA+D;IAC/D,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AAOD,qBAAa,eAAe;IAC1B,OAAO,CAAC,SAAS,CAAc;IAC/B,OAAO,CAAC,QAAQ,CAAqB;IACrC,OAAO,CAAC,QAAQ,CAA8C;IAC9D,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,QAAQ,CAAyD;IAGzE,OAAO,CAAC,iBAAiB,CAAuD;gBAEpE,IAAI,EAAE,sBAAsB;IAcxC;;OAEG;IACH,OAAO,CAAC,MAAM;IA2Cd;;OAEG;IACH,OAAO,CAAC,aAAa;IAyBrB,OAAO,CAAC,eAAe;IAqDvB,OAAO,CAAC,iBAAiB;IA6BzB,OAAO,CAAC,eAAe;IA6BvB,OAAO,CAAC,gBAAgB;IAgDxB,OAAO,CAAC,aAAa;IAkGrB,OAAO,CAAC,iBAAiB;IAgEzB,OAAO,CAAC,kBAAkB;IAuE1B,OAAO,CAAC,gBAAgB;IAkExB,OAAO,CAAC,YAAY;IAOpB,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,QAAQ;IAOhB,OAAO,CAAC,QAAQ;IAchB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,IAAI;IAMjD;;OAEG;IACH,eAAe,IAAI,IAAI;IAQvB;;OAEG;IACH,OAAO,IAAI,IAAI;CAShB"}