@plasius/gpu-lighting

Advanced lighting WGSL modules and planning profiles for @plasius/gpu-worker. The package is structured around modern lighting tracks:

• Lumen-inspired hybrid realtime GI/reflections.
• Path-traced reference lighting.
• Froxel-based volumetric lighting.
• HDRI/IBL precomputation passes.

Apache-2.0. ESM + CJS builds. WGSL assets are published in dist/.

Install

npm install @plasius/gpu-lighting

Usage (load one technique)

import {
  loadLightingTechniqueJobs,
  getLightingTechnique,
} from "@plasius/gpu-lighting";
import { assembleWorkerWgsl, loadWorkerWgsl } from "@plasius/gpu-worker";

const workerWgsl = await loadWorkerWgsl();
const { preludeWgsl, jobs } = await loadLightingTechniqueJobs("hybrid");

const shaderCode = await assembleWorkerWgsl(workerWgsl, {
  preludeWgsl,
  jobs,
});

console.log(getLightingTechnique("hybrid").description);

Usage (profile planning)

import {
  getLightingProfile,
  loadLightingProfile,
} from "@plasius/gpu-lighting";

const profile = getLightingProfile("realtime");
// profile.techniques -> ["hybrid", "volumetrics", "hdri"]

const plan = await loadLightingProfile("realtime");
// plan.techniques is an array of loaded prelude+job WGSL bundles.

Profiles

• realtime: Lumen-inspired hybrid GI/reflections + volumetrics + HDRI/IBL.
• hybrid: hybrid GI/reflections with HDRI/IBL support.
• reference: path tracing + volumetrics + HDRI/IBL for validation and lookdev.

Techniques

• hybrid
  • directLighting
  • screenTrace
  • radianceCache
  • finalGather
  • reflectionResolve
• pathtracer
  • pathTrace
  • accumulate
  • denoise
• volumetrics
  • froxelIntegrate
  • volumetricShadow
• hdri
  • irradianceConvolution
  • specularPrefilter
  • brdfLut

Demo

Run the demo server from the repo root:

cd gpu-lighting
npm run demo

Then open http://localhost:8000/gpu-lighting/demo/.

Files

• src/index.js: technique/profile catalogs, loader APIs, validation.
• src/techniques/hybrid/*: realtime hybrid GI/reflections WGSL modules.
• src/techniques/pathtracer/*: path tracing reference WGSL modules.
• src/techniques/volumetrics/*: volumetric lighting WGSL modules.
• src/techniques/hdri/*: HDRI/IBL precompute WGSL modules.
• docs/adrs/*: architecture decisions for the lighting stack.