SPIRV-Cross.NET -- vendored NuGet package
==========================================

What it's for
--------------
Managed wrapper (Kai Angulo, MIT) around Khronos Group's SPIRV-Cross cross-compiler. Used by
Blacklight.WebGL2's shader build step to turn dxc-compiled SPIR-V (from the DXC-compatible HLSL
shell, see Modules\Blacklight\WebGL2\WebGL2\Shaders\MainWebGL2.hlsl) into GLSL ES 3.00 for WebGL2.
Chosen over the ShaderPipeline spike's original Veldrid.SPIRV (~143 MB of every-platform native libs,
NU1903-flagged ancient transitive deps) for a much smaller, cleaner, dependency-free package.

Version
-------
1.0.2, from https://www.nuget.org/packages/SPIRV-Cross.NET/.

Contents (packages\)
---------------------
spirv-cross.net.1.0.2.7z   (28.7 MB -> 3.9 MB) -- a snapshot of the package's exploded global-packages-
                           folder entry (.nuspec, lib\, runtimes\, the win-x64 native DLL under
                           content\, etc.), not the raw .nupkg -- same mechanism as
                           3rdParty\DotNetWasmTools, see that folder's own Readme.txt. build.py's
                           ensure_vendored_nuget_packages_extracted() unpacks it straight into
                           Junk\NuGet (this repo's globalPackagesFolder) before any restore runs, so no
                           packageSource entry is needed in Modules\NuGet.config at all -- NuGet finds
                           it already resolved there. Verified round-trip byte-identical against the
                           original NuGet-populated cache folder (minus .nupkg/.nupkg.sha512) before the
                           raw .nupkg was deleted.

Usage
-----
  using SPIRVCross;
  // See Modules\Blacklight\WebGL2\ShaderTranspiler\Program.cs for the actual HLSL->SPIR-V->GLSL
  // pipeline this drives.