glslh 1.1.1 → 1.1.2

package/CHANGELOG.md

@@ -1,6 +1,12 @@
 ## 📋 `glslh` Changelog
 
-### **v1.1.1** (Latest)
+### **v1.1.2** (Latest)
+
+- **AI-Native Error Context Mapping**: Upgraded `translateShaderError` inside `parser.js` to automatically extract and embed surrounding 5-line code snippets (`--- Code Context ---`) directly alongside modular file and line indicators, allowing developers and AI assistants to diagnose and patch WebGL compilation errors instantly without manual file lookups.
+
+---
+
+### **v1.1.1**
 
 - **Documentation & README Refinement**: Updated documentation, architecture diagrams, and release logs to reflect complete structural guides for modular struct-based composition, CPU/GPU division of labor, and extension workflows.
 

package/README.md

@@ -40,7 +40,7 @@
 - **Zero Runtime Performance Cost:** Because modular files are stitched and compiled once during initialization, your shaders execute at full native GPU speed with zero runtime overhead.
 - **C-Style `#include` Directives:** Split massive shaders into modular files with full circular dependency protection and strict extension validation.
 - **Duplicate Function Collision Detection:** Automatically scans included modules and warns you if multiple files define conflicting function signatures (`float hash()`) before WebGL compilation fails, while fully supporting valid GLSL function overloading.
-- **Error Line Mapping:** Instantly translates monolithic WebGL compilation error line numbers back to their exact source file and line number (`[shape_utils.glsl:14]`).
+- **Error Context Mapping:** Automatically captures and embeds 5-line surrounding code context snippets alongside modular file and line numbers when WebGL compilation fails.
 - **Self-Contained Metadata Blocks:** Define uniform data types, default values, and derived per-frame formulas right at the top of your shader file (`@uniforms`).
 - **Direct JavaScript Math Injection:** Use native JS constants like `Math.PI` or `Math.TAU` directly in your GLSL code; the preprocessor evaluates them before GPU compilation.
 - **Framework Agnostic:** Seamlessly output standard Three.js `ShaderMaterial` objects ready for Vanilla JS, Three.js, or React Three Fiber.
@@ -93,7 +93,7 @@ package/
 ## 🚀 Installation & Quick Start
 
 ```bash
-npm install glslh@1.1.1
+npm install glslh@1.1.2
 ```
 
 ### 1. Create a `.glslh` Shader File (`./shaders/header.glslh`)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "glslh",
-  "version": "1.1.1",
+  "version": "1.1.2",
   "description": "A lightweight GLSL preprocessor and runtime bridge for modular shader development.",
   "type": "module",
   "main": "./src/dom-canvas.js",

package/src/parser.js

@@ -103,7 +103,6 @@ export class GLSLHParser {
       new Set(),
     );
 
-    // Run duplicate function collision check on the final flattened source
     detectFunctionCollisions(result.source);
 
     return result;
@@ -239,7 +238,6 @@ export class GLSLHParser {
       }
     }
 
-    // 1. Extract #version if present so it always stays at the absolute top
     const versionMatch = processed.match(/^\s*#version[^\n]*\r?\n/);
     let versionHeader = "";
     if (versionMatch) {
@@ -247,7 +245,6 @@ export class GLSLHParser {
       processed = processed.slice(versionHeader.length);
     }
 
-    // 2. Build auto-injected math constants defines
     let constantsBlock = "";
     if (usedConstants.size > 0) {
       constantsBlock = "// --- GLSLH Auto-injected Math Constants ---\n";
@@ -258,7 +255,6 @@ export class GLSLHParser {
       constantsBlock += "\n";
     }
 
-    // 3. Build auto-injected uniform declarations
     let declBlock = "";
     const declLines = Object.entries(uniformsDefinition)
       .filter(
@@ -273,7 +269,6 @@ export class GLSLHParser {
         "\n\n";
     }
 
-    // 4. Re-assemble with #version strictly at the top
     processed = versionHeader + constantsBlock + declBlock + processed;
 
     return {
@@ -362,7 +357,17 @@ export function translateShaderError(
     const mapped = lineMap.at(flatLine - 1);
 
     if (mapped && !mapped.isMarker) {
-      return `[${mapped.file}:${mapped.line}]`;
+      const contextStart = Math.max(0, flatLine - 3);
+      const contextEnd = Math.min(lines.length - 1, flatLine + 1);
+      let snippet = "\n--- Code Context ---\n";
+
+      for (let i = contextStart; i <= contextEnd; i++) {
+        const prefix = i === flatLine - 1 ? " >> " : "    ";
+        snippet += `${prefix}${i + 1}: ${lines[i]}\n`;
+      }
+      snippet += "--------------------";
+
+      return `[File: ${mapped.file} | Line: ${mapped.line}]${snippet}`;
     }
     return match;
   });