glslh 1.1.0 → 1.1.1

package/CHANGELOG.md

@@ -1,6 +1,20 @@
 ## 📋 `glslh` Changelog
 
-### **v1.0.1** (Latest)
+### **v1.1.1** (Latest)
+
+- **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.
+
+---
+
+### **v1.1.0**
+
+- **Duplicate Function Collision Detection & Overloading Support**: Added automated static analysis to scan included modules and warn developers if conflicting function signatures clash, while fully supporting valid GLSL function overloading distinguished by parameter signatures.
+- **Strict `#version` Directive Pinning**: Upgraded the preprocessor parsing pipeline to extract and pin `#version` directives to the absolute top of the generated string, ensuring full compliance with strict WebGL driver standards regardless of auto-injected uniform declarations or math constants.
+- **Enhanced Error Line Mapping**: Improved error translation utilities to map monolithic WebGL compilation error line numbers back to their exact source file and line number (`[shape_utils.glsl:14]`).
+
+---
+
+### **v1.0.1**
 
 - **Strict File Extension Whitelisting**: Added validation checks inside `GLSLHParser` to restrict `#include` directives exclusively to valid shader extensions (`.glsl`, `.glslh`, `.frag`, `.vert`, `.frag.glsl`, `.vert.glsl`), preventing security risks and unauthorized inclusions of non-shader files (e.g., `.py`, `.cpp`, `.txt`).
 - **Compound Header Support**: Enhanced path checking to natively support complex shader extension combinations like `.frag.glslh` and `.vert.glslh`.

package/README.md

@@ -39,7 +39,7 @@
 - **Clear CPU/GPU Separation:** All orchestration, math constant calculations (`Math.PI`), and uniform state updates run efficiently on the **CPU**, while heavy rasterization and pixel shading run natively in parallel on the **GPU**.
 - **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.
+- **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]`).
 - **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.
@@ -93,22 +93,18 @@ package/
 ## 🚀 Installation & Quick Start
 
 ```bash
-npm install glslh
+npm install glslh@1.1.1
 ```
 
 ### 1. Create a `.glslh` Shader File (`./shaders/header.glslh`)
 
-Refer to the complete working example setup here: [GLSLH](https://www.google.com/search?q=./test/shaders/header.glslh)
-
 ### 2. Run Declaratively in HTML (`index.html`)
 
-Refer to the complete working example setup here: [index.html](https://www.google.com/search?q=./test/index.html)
-
 ---
 
 ## ⚡ VS Code Extension (Live Preview)
 
-Want instant syntax highlighting, color pickers, and a live WebGL preview pane right inside your editor? Install the official **GLSLH Previewer** extension from the marketplace:
+Want instant syntax highlighting, color pickers, and a live WebGL preview pane right inside your editor? Install the official [**GLSLH Previewer**](https://marketplace.visualstudio.com/items?itemName=SudhanshuAmbastha.glslh-previewer) extension from the marketplace:
 
 - **Live WebGL Preview:** Inspect shaders side-by-side with automatic hot-reloading on save.
 - **Native Color Pickers:** Click color definitions or uniform arrays in `@uniforms` or `vec3()` blocks to adjust values visually.
@@ -118,4 +114,4 @@ Want instant syntax highlighting, color pickers, and a live WebGL preview pane r
 
 ## 📜 License
 
-Distributed under the [**MIT License**](../LICENSE). See `LICENSE` for more information.
+Distributed under the **MIT License**. See [`LICENSE`](../LICENSE) for more information.

package/package.json

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