Release v1.1.17

[ormidales]

This pull request primarily improves and clarifies JSDoc documentation throughout the codebase, especially for public APIs and critical internal functions. It also makes minor export and test adjustments to ensure documentation and exports are consistent and well-validated. The most notable changes are grouped below:

JSDoc and API Documentation Improvements

• Expanded and clarified the JSDoc for GltfLoaderOptions.resolveUri, explicitly stating the callback must return a Promise, documenting error propagation, and adding @param and @returns tags. Also, baseline URI protections are now documented in a @remarks block. [1] [2] [3] [4]
• Improved JSDoc for ShaderCache.getProgramKey to include a detailed @remarks block about key stability and usage, and clarified documentation for ShaderCache.MAX_KEY_LENGTH. [1] [2] [3] [4]
• Enhanced JSDoc for RenderSystem.flushStaleMeshBuffers and the CONSECUTIVE_MESH_BUFFER_FAILURE_WARNING_THRESHOLD constant, adding @param, @returns, and rationale for the threshold/reset behavior. [1] [2] [3] [4]

Export and API Surface Adjustments

• Changed the wrapGltfError utility to be exported from GltfLoader.ts and validated its export and JSDoc via new tests. [1] [2] [3] [4]
• Updated the core/index.ts barrel export to re-export Material, DEFAULT_VERTEX_SOURCE, and DEFAULT_FRAGMENT_SOURCE together, removing duplicated JSDoc and security notes from the barrel file. Corresponding tests were updated for this new export style. [1] [2]

Version Bump

• Incremented the package version from 1.1.16 to 1.1.17 in package.json.

[Copilot]

Pull request overview

This release PR (v1.1.17) focuses on tightening and validating public-facing JSDoc contracts across core modules, plus a small API surface tweak (wrapGltfError export) and a version bump.

Changes:

• Expanded/clarified JSDoc for GltfLoaderOptions.resolveUri, ShaderCache.getProgramKey, and RenderSystem.flushStaleMeshBuffers / mesh-buffer failure threshold constant.
• Exported wrapGltfError from src/core/GltfLoader.ts and added tests validating both export and JSDoc.
• Updated the core barrel export style for Material + default shader sources; bumped package version to 1.1.17.

Reviewed changes

Copilot reviewed 9 out of 10 changed files in this pull request and generated 3 comments.

Show a summary per file

File	Description
tests/shader.test.ts	Updates/adds assertions for ShaderCache JSDoc structure (@remarks, @see, MAX_KEY_LENGTH docs).
tests/gltf.test.ts	Adds export + behavior tests for wrapGltfError and additional JSDoc contract checks for resolveUri / strict.
tests/ecs.test.ts	Adds JSDoc contract checks for flushStaleMeshBuffers and the mesh-buffer failure threshold constant.
tests/core-index.test.ts	Adjusts tests to match consolidated barrel re-export of Material + default shader sources without duplicated JSDoc.
src/core/ShaderCache.ts	Enhances JSDoc for MAX_KEY_LENGTH and restructures/expands getProgramKey documentation (@remarks, @see).
src/core/index.ts	Consolidates Material + default shader source exports into a single re-export line.
src/core/GltfLoader.ts	Clarifies resolveUri JSDoc, adds @remarks for baseline protections, and exports wrapGltfError with param docs.
src/core/ecs/systems/RenderSystem.ts	Expands JSDoc for the failure threshold constant and adds @param/@returns to flushStaleMeshBuffers.
package.json	Version bump to 1.1.17.
package-lock.json	Lockfile updated for version bump (and related metadata changes).

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.