@stevejtrettel/shader-sandbox 0.1.0

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

@@ -0,0 +1,192 @@
+/**
+ * Project Layer - Type Definitions for Shadertoy Projects
+ *
+ * Pure TypeScript interfaces matching Shadertoy's mental model.
+ * Based on docs/project-spec.md
+ */
+export type PassName = 'Image' | 'BufferA' | 'BufferB' | 'BufferC' | 'BufferD';
+/**
+ * Reference to another buffer pass.
+ * By default, reads the previous frame (safe for all cases).
+ * Use current: true to read from a buffer that has already run this frame.
+ */
+export interface ChannelJSONBuffer {
+    buffer: PassName;
+    current?: boolean;
+}
+/**
+ * Reference to external texture (image file).
+ */
+export interface ChannelJSONTexture {
+    texture: string;
+    filter?: 'nearest' | 'linear';
+    wrap?: 'clamp' | 'repeat';
+    type?: '2d' | 'cubemap';
+}
+/**
+ * Reference to keyboard texture (runtime-provided).
+ */
+export interface ChannelJSONKeyboard {
+    keyboard: true;
+}
+/**
+ * Union type for channel sources in JSON config (object form).
+ */
+export type ChannelJSONObject = ChannelJSONBuffer | ChannelJSONTexture | ChannelJSONKeyboard;
+/**
+ * Channel value in simplified config format.
+ * Can be a string shorthand or full object:
+ * - "BufferA", "BufferB", etc. → buffer reference
+ * - "keyboard" → keyboard input
+ * - "photo.jpg" (with extension) → texture file
+ * - { buffer: "BufferA" } → explicit buffer with options
+ * - { texture: "photo.jpg", filter: "nearest" } → texture with options
+ */
+export type ChannelValue = string | ChannelJSONObject;
+/**
+ * Pass configuration in simplified format.
+ * Channel bindings are directly on the pass object.
+ *
+ * Example:
+ * {
+ *   "iChannel0": "BufferA",
+ *   "iChannel1": "photo.jpg",
+ *   "source": "custom.glsl"  // optional
+ * }
+ */
+export interface PassConfigSimplified {
+    /** Optional custom source file path */
+    source?: string;
+    /** Channel bindings - string shorthand or full object */
+    iChannel0?: ChannelValue;
+    iChannel1?: ChannelValue;
+    iChannel2?: ChannelValue;
+    iChannel3?: ChannelValue;
+}
+/**
+ * Top-level config.json structure (simplified flat format).
+ *
+ * Example:
+ * {
+ *   "title": "My Shader",
+ *   "layout": "split",
+ *   "controls": true,
+ *
+ *   "BufferA": {
+ *     "iChannel0": "BufferA"
+ *   },
+ *   "Image": {
+ *     "iChannel0": "BufferA"
+ *   }
+ * }
+ */
+export interface ShadertoyConfig {
+    title?: string;
+    author?: string;
+    description?: string;
+    layout?: 'fullscreen' | 'default' | 'split' | 'tabbed';
+    controls?: boolean;
+    common?: string;
+    Image?: PassConfigSimplified;
+    BufferA?: PassConfigSimplified;
+    BufferB?: PassConfigSimplified;
+    BufferC?: PassConfigSimplified;
+    BufferD?: PassConfigSimplified;
+}
+/**
+ * Normalized channel source for engine consumption.
+ * All channels are represented as one of these discriminated union variants.
+ */
+export type ChannelSource = {
+    kind: 'none';
+} | {
+    kind: 'buffer';
+    buffer: PassName;
+    current: boolean;
+} | {
+    kind: 'texture';
+    name: string;
+    cubemap: boolean;
+} | {
+    kind: 'keyboard';
+};
+/**
+ * Exactly 4 channels (iChannel0-3), matching Shadertoy's fixed channel count.
+ */
+export type Channels = [ChannelSource, ChannelSource, ChannelSource, ChannelSource];
+/**
+ * External 2D texture loaded from image file.
+ * Textures are deduplicated by (source, filter, wrap) tuple.
+ */
+export interface ShadertoyTexture2D {
+    name: string;
+    filename?: string;
+    source: string;
+    filter: 'nearest' | 'linear';
+    wrap: 'clamp' | 'repeat';
+}
+/**
+ * A single shader pass in the rendering pipeline.
+ */
+export interface ShadertoyPass {
+    name: PassName;
+    glslSource: string;
+    channels: Channels;
+}
+/**
+ * Project metadata (title, author, description).
+ */
+export interface ShadertoyMeta {
+    title: string;
+    author: string | null;
+    description: string | null;
+}
+/**
+ * Complete in-memory representation of a Shadertoy project.
+ * Produced by loadProject() and consumed by ShadertoyEngine.
+ *
+ * Guarantees:
+ * - passes.Image always exists
+ * - All passes have exactly 4 channels (missing → kind: 'none')
+ * - Textures are deduplicated
+ * - All paths resolved and GLSL loaded
+ */
+export interface ShadertoyProject {
+    /**
+     * Project root directory path.
+     */
+    root: string;
+    /**
+     * Project metadata.
+     */
+    meta: ShadertoyMeta;
+    /**
+     * Layout mode for the shader viewer.
+     */
+    layout: 'fullscreen' | 'default' | 'split' | 'tabbed';
+    /**
+     * Whether to show playback controls (play/pause, reset).
+     */
+    controls: boolean;
+    /**
+     * Common GLSL code (prepended to all shaders), or null if none.
+     */
+    commonSource: string | null;
+    /**
+     * Pass definitions.
+     * Image is always present, BufferA-D are optional.
+     */
+    passes: {
+        Image: ShadertoyPass;
+        BufferA?: ShadertoyPass;
+        BufferB?: ShadertoyPass;
+        BufferC?: ShadertoyPass;
+        BufferD?: ShadertoyPass;
+    };
+    /**
+     * Deduplicated list of external textures.
+     * All ChannelSource with kind: 'texture2D' refer to names in this list.
+     */
+    textures: ShadertoyTexture2D[];
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist-lib/project/types.js

@@ -0,0 +1,7 @@
+/**
+ * Project Layer - Type Definitions for Shadertoy Projects
+ *
+ * Pure TypeScript interfaces matching Shadertoy's mental model.
+ * Based on docs/project-spec.md
+ */
+export {};

package/dist-lib/styles/base.css

@@ -0,0 +1,29 @@
+/**
+ * Base Styles - Global resets and root element styling
+ */
+
+* {
+  margin: 0;
+  padding: 0;
+  box-sizing: border-box;
+}
+
+html, body {
+  width: 100%;
+  height: 100%;
+  overflow: hidden;
+  font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
+}
+
+body {
+  background: #f5f5f5;
+}
+
+#app {
+  width: 100%;
+  height: 100%;
+}
+
+canvas {
+  display: block;
+}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@stevejtrettel/shader-sandbox",
+  "version": "0.1.0",
+  "description": "Local Shadertoy-compatible GLSL shader development environment with live editing",
+  "type": "module",
+  "main": "./dist-lib/index.js",
+  "types": "./dist-lib/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist-lib/index.js",
+      "types": "./dist-lib/index.d.ts"
+    }
+  },
+  "bin": {
+    "shader": "./bin/cli.js"
+  },
+  "files": [
+    "bin",
+    "dist-lib",
+    "templates",
+    "src"
+  ],
+  "scripts": {
+    "new": "node scripts/new-demo.cjs",
+    "dev": "vite",
+    "dev:demo": "node scripts/dev-demo.cjs",
+    "build": "tsc && vite build",
+    "build:demo": "node scripts/build-demo.cjs",
+    "build:embed": "node scripts/build-embed.cjs",
+    "build:embed:folder": "node scripts/build-embed-folder.cjs",
+    "build:embed:screenshots": "node scripts/build-folder-screenshots.cjs",
+    "build:lib": "node scripts/build-lib.cjs",
+    "prepublishOnly": "npm run build:lib",
+    "preview": "vite preview"
+  },
+  "dependencies": {
+    "prismjs": "^1.30.0",
+    "vite": "^5.0.0",
+    "vite-plugin-css-injected-by-js": "^3.5.2"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "@types/prismjs": "^1.26.5",
+    "puppeteer-core": "^24.34.0",
+    "typescript": "^5.3.3",
+    "vite": "^5.0.8"
+  }
+}