@skewedaspect/sage 0.10.0-beta.1 → 0.10.0-beta.2

package/dist/{postProcessingFrameGraph-rr2DbgPi.js → postProcessingFrameGraph-C3Og4kaS.js}

@@ -10,61 +10,69 @@ var p = {
 async function m(m, h) {
 	let g = m.activeCamera;
 	if (!g) return;
-	let _ = m.getEngine(), v = new t(m), y = v.textureManager.createRenderTargetTexture("sage-fg-color", {
-		size: {
-			width: 100,
-			height: 100
-		},
-		sizeIsPercentage: !0,
-		options: {
-			formats: [e.TEXTUREFORMAT_RGBA],
-			samples: 4
-		}
-	}), b = new i("sage-clear", v);
-	b.targetTexture = y, v.addTask(b);
-	let x = new l("sage-render", v, m);
-	x.targetTexture = b.outputTexture, x.depthTexture = b.outputDepthTexture, x.camera = g, x.objectList = {
+	let _ = m.getEngine(), v = new t(m);
+	function y(e, t) {
+		return v.textureManager.createRenderTargetTexture(e, {
+			size: {
+				width: 100,
+				height: 100
+			},
+			sizeIsPercentage: !0,
+			options: {
+				formats: [t],
+				samples: 4
+			}
+		});
+	}
+	let b = y("sage-fg-color", e.TEXTUREFORMAT_RGBA), x = y("sage-fg-depth", e.TEXTUREFORMAT_DEPTH24_STENCIL8), S = new i("sage-clear", v);
+	S.targetTexture = b, S.depthTexture = x, S.clearDepth = !0, S.clearStencil = !0, v.addTask(S);
+	let C = new l("sage-render", v, m);
+	C.targetTexture = S.outputTexture, C.depthTexture = S.outputDepthTexture, C.camera = g, C.objectList = {
 		meshes: m.meshes,
 		particleSystems: m.particleSystems
-	}, x.isMainObjectRenderer = !0, v.addTask(x);
-	let S = x.outputTexture;
+	}, C.isMainObjectRenderer = !0, v.addTask(C);
+	let w = C.outputTexture;
 	if (h.ssao) {
 		let e = new o("sage-geometry", v, m);
 		v.addTask(e);
 		let t = new u("sage-ssao", v, .5, 1);
-		t.sourceTexture = S, t.depthTexture = e.geometryViewDepthTexture, t.normalTexture = e.geometryViewNormalTexture, t.camera = g, v.addTask(t), h.ssao.radius !== void 0 && (t.ssao.radius = h.ssao.radius), h.ssao.samples !== void 0 && (t.ssao.samples = h.ssao.samples), h.ssao.totalStrength !== void 0 && (t.ssao.totalStrength = h.ssao.totalStrength), S = t.outputTexture;
+		t.sourceTexture = w, t.depthTexture = e.geometryViewDepthTexture, t.normalTexture = e.geometryViewNormalTexture, t.camera = g, v.addTask(t), h.ssao.radius !== void 0 && (t.ssao.radius = h.ssao.radius), h.ssao.samples !== void 0 && (t.ssao.samples = h.ssao.samples), h.ssao.totalStrength !== void 0 && (t.ssao.totalStrength = h.ssao.totalStrength), w = t.outputTexture;
 	}
 	if (h.bloom) {
 		let e = new n("sage-bloom", v, h.bloom.weight ?? .5, h.bloom.kernel ?? 128, h.bloom.threshold ?? .1, !0, h.bloom.scale ?? .5);
-		e.sourceTexture = S, v.addTask(e), S = e.outputTexture;
+		e.sourceTexture = w, v.addTask(e), w = e.outputTexture;
 	}
 	if (h.grain) {
 		let e = new s("sage-grain", v);
-		e.sourceTexture = S, v.addTask(e), h.grain.intensity !== void 0 && (e.postProcess.intensity = h.grain.intensity), h.grain.animated !== void 0 && (e.postProcess.animated = h.grain.animated), S = e.outputTexture;
+		e.sourceTexture = w, v.addTask(e), h.grain.intensity !== void 0 && (e.postProcess.intensity = h.grain.intensity), h.grain.animated !== void 0 && (e.postProcess.animated = h.grain.animated), w = e.outputTexture;
 	}
 	if (h.sharpen) {
 		let e = new d("sage-sharpen", v);
-		e.sourceTexture = S, v.addTask(e), h.sharpen.edge !== void 0 && (e.postProcess.edgeAmount = h.sharpen.edge), h.sharpen.color !== void 0 && (e.postProcess.colorAmount = h.sharpen.color), S = e.outputTexture;
+		e.sourceTexture = w, v.addTask(e), h.sharpen.edge !== void 0 && (e.postProcess.edgeAmount = h.sharpen.edge), h.sharpen.color !== void 0 && (e.postProcess.colorAmount = h.sharpen.color), w = e.outputTexture;
 	}
 	if (h.chromaticAberration) {
 		let e = new r("sage-chromab", v);
-		e.sourceTexture = S, v.addTask(e), h.chromaticAberration.amount !== void 0 && (e.postProcess.aberrationAmount = h.chromaticAberration.amount), S = e.outputTexture;
+		e.sourceTexture = w, v.addTask(e), h.chromaticAberration.amount !== void 0 && (e.postProcess.aberrationAmount = h.chromaticAberration.amount), w = e.outputTexture;
 	}
 	if (h.tonemap || h.vignette) {
 		let e = new c("sage-imgproc", v);
-		if (e.sourceTexture = S, v.addTask(e), h.tonemap && (e.postProcess.toneMappingEnabled = !0, h.tonemap.operator && (e.postProcess.toneMappingType = p[h.tonemap.operator] ?? f.TONEMAPPING_STANDARD)), h.vignette && (e.postProcess.vignetteEnabled = !0, h.vignette.weight !== void 0 && (e.postProcess.vignetteWeight = h.vignette.weight), h.vignette.stretch !== void 0 && (e.postProcess.vignetteStretch = h.vignette.stretch), h.vignette.color)) {
+		if (e.sourceTexture = w, v.addTask(e), h.tonemap && (e.postProcess.toneMappingEnabled = !0, h.tonemap.operator && (e.postProcess.toneMappingType = p[h.tonemap.operator] ?? f.TONEMAPPING_STANDARD)), h.vignette && (e.postProcess.vignetteEnabled = !0, h.vignette.weight !== void 0 && (e.postProcess.vignetteWeight = h.vignette.weight), h.vignette.stretch !== void 0 && (e.postProcess.vignetteStretch = h.vignette.stretch), h.vignette.color)) {
 			let t = h.vignette.color;
 			e.postProcess.vignetteColor.set(t.r, t.g, t.b, 1);
 		}
-		S = e.outputTexture;
+		w = e.outputTexture;
 	}
 	h.volumetric && console.warn("[SAGE] Volumetric lighting config is recognized but automatic light detection is not yet supported. Use scene.frameGraph to add FrameGraphVolumetricLightingTask manually.");
-	let C = new a("sage-output", v);
-	C.sourceTexture = S, v.addTask(C), m.cameraToUseForPointers = g, m.frameGraph = v, _.onResizeObservable.add(async () => {
+	let T = new a("sage-output", v);
+	T.sourceTexture = w, v.addTask(T), m.cameraToUseForPointers = g, m.frameGraph = v;
+	let E = _.onResizeObservable.add(async () => {
 		await v.buildAsync();
+	});
+	m.onDisposeObservable.addOnce(() => {
+		_.onResizeObservable.remove(E);
 	}), await v.buildAsync();
 }
 //#endregion
 export { m as applyFrameGraphPostProcessing };
 
-//# sourceMappingURL=postProcessingFrameGraph-rr2DbgPi.js.map
+//# sourceMappingURL=postProcessingFrameGraph-C3Og4kaS.js.map

package/dist/postProcessingFrameGraph-C3Og4kaS.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"postProcessingFrameGraph-C3Og4kaS.js","names":[],"sources":["../src/handlers/postProcessingFrameGraph.ts"],"sourcesContent":["//----------------------------------------------------------------------------------------------------------------------\n// Frame Graph Post-Processing Backend\n//\n// Builds a directed task chain using BabylonJS Frame Graph system.\n// Each post-processing effect is a separate task chained via texture handles.\n//----------------------------------------------------------------------------------------------------------------------\n\nimport {\n    Constants,\n    FrameGraph,\n    FrameGraphBloomTask,\n    FrameGraphChromaticAberrationTask,\n    FrameGraphClearTextureTask,\n    FrameGraphCopyToBackbufferColorTask,\n    FrameGraphGeometryRendererTask,\n    FrameGraphGrainTask,\n    FrameGraphImageProcessingTask,\n    FrameGraphObjectRendererTask,\n    FrameGraphSSAO2RenderingPipelineTask,\n    FrameGraphSharpenTask,\n    type FrameGraphTextureHandle,\n    ImageProcessingConfiguration,\n    type Scene,\n} from '@babylonjs/core';\n\nimport type { PostProcessingConfig } from '../interfaces/level.ts';\n\n//----------------------------------------------------------------------------------------------------------------------\n\n/**\n * Map from user-facing tonemap operator names to BabylonJS constants.\n * BabylonJS only has STANDARD (0) and ACES (1) — the other names all map to STANDARD.\n */\nconst TONEMAP_OPERATORS : Record<string, number> = {\n    hable: ImageProcessingConfiguration.TONEMAPPING_STANDARD,\n    reinhard: ImageProcessingConfiguration.TONEMAPPING_STANDARD,\n    hejidawson: ImageProcessingConfiguration.TONEMAPPING_STANDARD,\n    photographic: ImageProcessingConfiguration.TONEMAPPING_STANDARD,\n    aces: ImageProcessingConfiguration.TONEMAPPING_ACES,\n};\n\n//----------------------------------------------------------------------------------------------------------------------\n\nexport async function applyFrameGraphPostProcessing(scene : Scene, config : PostProcessingConfig) : Promise<void>\n{\n    const camera = scene.activeCamera;\n    if(!camera)\n    {\n        return;\n    }\n\n    const engine = scene.getEngine();\n    const fg = new FrameGraph(scene);\n\n    // The color target and its depth attachment differ only in format: the object renderer checks that\n    // their size and sample count agree when the graph builds.\n    function createTarget(name : string, format : number) : FrameGraphTextureHandle\n    {\n        return fg.textureManager.createRenderTargetTexture(name, {\n            size: { width: 100, height: 100 },\n            sizeIsPercentage: true,\n            options: { formats: [ format ], samples: 4 },\n        });\n    }\n\n    const colorTexture = createTarget('sage-fg-color', Constants.TEXTUREFORMAT_RGBA);\n    const depthTexture = createTarget('sage-fg-depth', Constants.TEXTUREFORMAT_DEPTH24_STENCIL8);\n\n    // 1. Clear. The clear task resolves its outputDepthTexture handle only when it is given a depth texture\n    // to clear; the object renderer below reads that handle, and an unresolved one has no texture behind it.\n    const clearTask = new FrameGraphClearTextureTask('sage-clear', fg);\n    clearTask.targetTexture = colorTexture;\n    clearTask.depthTexture = depthTexture;\n    clearTask.clearDepth = true;\n    clearTask.clearStencil = true;\n    fg.addTask(clearTask);\n\n    // 2. Render objects\n    const renderTask = new FrameGraphObjectRendererTask('sage-render', fg, scene);\n    renderTask.targetTexture = clearTask.outputTexture;\n    renderTask.depthTexture = clearTask.outputDepthTexture;\n    renderTask.camera = camera;\n    renderTask.objectList = { meshes: scene.meshes, particleSystems: scene.particleSystems };\n    renderTask.isMainObjectRenderer = true;\n    fg.addTask(renderTask);\n\n    // Track the current output texture through the chain\n    let currentTexture : FrameGraphTextureHandle = renderTask.outputTexture;\n\n    // 3. SSAO (needs geometry renderer for depth/normals)\n    if(config.ssao)\n    {\n        const geoTask = new FrameGraphGeometryRendererTask('sage-geometry', fg, scene);\n        fg.addTask(geoTask);\n\n        const ssaoTask = new FrameGraphSSAO2RenderingPipelineTask('sage-ssao', fg, 0.5, 1.0);\n        ssaoTask.sourceTexture = currentTexture;\n        ssaoTask.depthTexture = geoTask.geometryViewDepthTexture;\n        ssaoTask.normalTexture = geoTask.geometryViewNormalTexture;\n        ssaoTask.camera = camera;\n        fg.addTask(ssaoTask);\n\n        if(config.ssao.radius !== undefined) { ssaoTask.ssao.radius = config.ssao.radius; }\n        if(config.ssao.samples !== undefined) { ssaoTask.ssao.samples = config.ssao.samples; }\n        if(config.ssao.totalStrength !== undefined) { ssaoTask.ssao.totalStrength = config.ssao.totalStrength; }\n\n        currentTexture = ssaoTask.outputTexture;\n    }\n\n    // 4. Bloom\n    if(config.bloom)\n    {\n        const bloomTask = new FrameGraphBloomTask(\n            'sage-bloom',\n            fg,\n            config.bloom.weight ?? 0.5,\n            config.bloom.kernel ?? 128,\n            config.bloom.threshold ?? 0.1,\n            true,\n            config.bloom.scale ?? 0.5\n        );\n        bloomTask.sourceTexture = currentTexture;\n        fg.addTask(bloomTask);\n\n        currentTexture = bloomTask.outputTexture;\n    }\n\n    // 5. Grain\n    if(config.grain)\n    {\n        const grainTask = new FrameGraphGrainTask('sage-grain', fg);\n        grainTask.sourceTexture = currentTexture;\n        fg.addTask(grainTask);\n\n        if(config.grain.intensity !== undefined) { grainTask.postProcess.intensity = config.grain.intensity; }\n        if(config.grain.animated !== undefined) { grainTask.postProcess.animated = config.grain.animated; }\n\n        currentTexture = grainTask.outputTexture;\n    }\n\n    // 6. Sharpen\n    if(config.sharpen)\n    {\n        const sharpenTask = new FrameGraphSharpenTask('sage-sharpen', fg);\n        sharpenTask.sourceTexture = currentTexture;\n        fg.addTask(sharpenTask);\n\n        if(config.sharpen.edge !== undefined) { sharpenTask.postProcess.edgeAmount = config.sharpen.edge; }\n        if(config.sharpen.color !== undefined) { sharpenTask.postProcess.colorAmount = config.sharpen.color; }\n\n        currentTexture = sharpenTask.outputTexture;\n    }\n\n    // 7. Chromatic aberration\n    if(config.chromaticAberration)\n    {\n        const chromTask = new FrameGraphChromaticAberrationTask('sage-chromab', fg);\n        chromTask.sourceTexture = currentTexture;\n        fg.addTask(chromTask);\n\n        if(config.chromaticAberration.amount !== undefined)\n        {\n            chromTask.postProcess.aberrationAmount = config.chromaticAberration.amount;\n        }\n\n        currentTexture = chromTask.outputTexture;\n    }\n\n    // 8. Image processing (tonemap + vignette)\n    if(config.tonemap || config.vignette)\n    {\n        const imgTask = new FrameGraphImageProcessingTask('sage-imgproc', fg);\n        imgTask.sourceTexture = currentTexture;\n        fg.addTask(imgTask);\n\n        if(config.tonemap)\n        {\n            imgTask.postProcess.toneMappingEnabled = true;\n\n            if(config.tonemap.operator)\n            {\n                imgTask.postProcess.toneMappingType\n                    = TONEMAP_OPERATORS[config.tonemap.operator]\n                    ?? ImageProcessingConfiguration.TONEMAPPING_STANDARD;\n            }\n        }\n\n        if(config.vignette)\n        {\n            imgTask.postProcess.vignetteEnabled = true;\n\n            if(config.vignette.weight !== undefined) { imgTask.postProcess.vignetteWeight = config.vignette.weight; }\n            if(config.vignette.stretch !== undefined)\n            {\n                imgTask.postProcess.vignetteStretch = config.vignette.stretch;\n            }\n            if(config.vignette.color)\n            {\n                const vc = config.vignette.color;\n                imgTask.postProcess.vignetteColor.set(vc.r, vc.g, vc.b, 1);\n            }\n        }\n\n        currentTexture = imgTask.outputTexture;\n    }\n\n    // 9. Volumetric lighting — not yet wired up for automatic light detection\n    if(config.volumetric)\n    {\n        console.warn(\n            '[SAGE] Volumetric lighting config is recognized but automatic light detection is not yet supported. '\n            + 'Use scene.frameGraph to add FrameGraphVolumetricLightingTask manually.'\n        );\n    }\n\n    // 10. Output to screen\n    const copyTask = new FrameGraphCopyToBackbufferColorTask('sage-output', fg);\n    copyTask.sourceTexture = currentTexture;\n    fg.addTask(copyTask);\n\n    // Wire up the scene — cameraToUseForPointers is needed because activeCamera becomes null between tasks\n    scene.cameraToUseForPointers = camera;\n    scene.frameGraph = fg;\n\n    // Rebuild on resize. The scene disposes the graph with itself, and the engine outlives both, so the\n    // observer goes with the scene rather than rebuilding a disposed graph for the engine's lifetime.\n    const resizeObserver = engine.onResizeObservable.add(async () =>\n    {\n        await fg.buildAsync();\n    });\n\n    scene.onDisposeObservable.addOnce(() =>\n    {\n        engine.onResizeObservable.remove(resizeObserver);\n    });\n\n    // Initial build\n    await fg.buildAsync();\n}\n\n//----------------------------------------------------------------------------------------------------------------------\n"],"mappings":";;AAiCA,IAAM,IAA6C;CAC/C,OAAO,EAA6B;CACpC,UAAU,EAA6B;CACvC,YAAY,EAA6B;CACzC,cAAc,EAA6B;CAC3C,MAAM,EAA6B;AACvC;AAIA,eAAsB,EAA8B,GAAe,GACnE;CACI,IAAM,IAAS,EAAM;CACrB,IAAG,CAAC,GAEA;CAGJ,IAAM,IAAS,EAAM,UAAU,GACzB,IAAK,IAAI,EAAW,CAAK;CAI/B,SAAS,EAAa,GAAe,GACrC;EACI,OAAO,EAAG,eAAe,0BAA0B,GAAM;GACrD,MAAM;IAAE,OAAO;IAAK,QAAQ;GAAI;GAChC,kBAAkB;GAClB,SAAS;IAAE,SAAS,CAAE,CAAO;IAAG,SAAS;GAAE;EAC/C,CAAC;CACL;CAEA,IAAM,IAAe,EAAa,iBAAiB,EAAU,kBAAkB,GACzE,IAAe,EAAa,iBAAiB,EAAU,8BAA8B,GAIrF,IAAY,IAAI,EAA2B,cAAc,CAAE;CAKjE,AAJA,EAAU,gBAAgB,GAC1B,EAAU,eAAe,GACzB,EAAU,aAAa,IACvB,EAAU,eAAe,IACzB,EAAG,QAAQ,CAAS;CAGpB,IAAM,IAAa,IAAI,EAA6B,eAAe,GAAI,CAAK;CAM5E,AALA,EAAW,gBAAgB,EAAU,eACrC,EAAW,eAAe,EAAU,oBACpC,EAAW,SAAS,GACpB,EAAW,aAAa;EAAE,QAAQ,EAAM;EAAQ,iBAAiB,EAAM;CAAgB,GACvF,EAAW,uBAAuB,IAClC,EAAG,QAAQ,CAAU;CAGrB,IAAI,IAA2C,EAAW;CAG1D,IAAG,EAAO,MACV;EACI,IAAM,IAAU,IAAI,EAA+B,iBAAiB,GAAI,CAAK;EAC7E,EAAG,QAAQ,CAAO;EAElB,IAAM,IAAW,IAAI,EAAqC,aAAa,GAAI,IAAK,CAAG;EAWnF,AAVA,EAAS,gBAAgB,GACzB,EAAS,eAAe,EAAQ,0BAChC,EAAS,gBAAgB,EAAQ,2BACjC,EAAS,SAAS,GAClB,EAAG,QAAQ,CAAQ,GAEhB,EAAO,KAAK,WAAW,KAAA,MAAa,EAAS,KAAK,SAAS,EAAO,KAAK,SACvE,EAAO,KAAK,YAAY,KAAA,MAAa,EAAS,KAAK,UAAU,EAAO,KAAK,UACzE,EAAO,KAAK,kBAAkB,KAAA,MAAa,EAAS,KAAK,gBAAgB,EAAO,KAAK,gBAExF,IAAiB,EAAS;CAC9B;CAGA,IAAG,EAAO,OACV;EACI,IAAM,IAAY,IAAI,EAClB,cACA,GACA,EAAO,MAAM,UAAU,IACvB,EAAO,MAAM,UAAU,KACvB,EAAO,MAAM,aAAa,IAC1B,IACA,EAAO,MAAM,SAAS,EAC1B;EAIA,AAHA,EAAU,gBAAgB,GAC1B,EAAG,QAAQ,CAAS,GAEpB,IAAiB,EAAU;CAC/B;CAGA,IAAG,EAAO,OACV;EACI,IAAM,IAAY,IAAI,EAAoB,cAAc,CAAE;EAO1D,AANA,EAAU,gBAAgB,GAC1B,EAAG,QAAQ,CAAS,GAEjB,EAAO,MAAM,cAAc,KAAA,MAAa,EAAU,YAAY,YAAY,EAAO,MAAM,YACvF,EAAO,MAAM,aAAa,KAAA,MAAa,EAAU,YAAY,WAAW,EAAO,MAAM,WAExF,IAAiB,EAAU;CAC/B;CAGA,IAAG,EAAO,SACV;EACI,IAAM,IAAc,IAAI,EAAsB,gBAAgB,CAAE;EAOhE,AANA,EAAY,gBAAgB,GAC5B,EAAG,QAAQ,CAAW,GAEnB,EAAO,QAAQ,SAAS,KAAA,MAAa,EAAY,YAAY,aAAa,EAAO,QAAQ,OACzF,EAAO,QAAQ,UAAU,KAAA,MAAa,EAAY,YAAY,cAAc,EAAO,QAAQ,QAE9F,IAAiB,EAAY;CACjC;CAGA,IAAG,EAAO,qBACV;EACI,IAAM,IAAY,IAAI,EAAkC,gBAAgB,CAAE;EAS1E,AARA,EAAU,gBAAgB,GAC1B,EAAG,QAAQ,CAAS,GAEjB,EAAO,oBAAoB,WAAW,KAAA,MAErC,EAAU,YAAY,mBAAmB,EAAO,oBAAoB,SAGxE,IAAiB,EAAU;CAC/B;CAGA,IAAG,EAAO,WAAW,EAAO,UAC5B;EACI,IAAM,IAAU,IAAI,EAA8B,gBAAgB,CAAE;EAgBpE,IAfA,EAAQ,gBAAgB,GACxB,EAAG,QAAQ,CAAO,GAEf,EAAO,YAEN,EAAQ,YAAY,qBAAqB,IAEtC,EAAO,QAAQ,aAEd,EAAQ,YAAY,kBACd,EAAkB,EAAO,QAAQ,aAChC,EAA6B,wBAIzC,EAAO,aAEN,EAAQ,YAAY,kBAAkB,IAEnC,EAAO,SAAS,WAAW,KAAA,MAAa,EAAQ,YAAY,iBAAiB,EAAO,SAAS,SAC7F,EAAO,SAAS,YAAY,KAAA,MAE3B,EAAQ,YAAY,kBAAkB,EAAO,SAAS,UAEvD,EAAO,SAAS,QACnB;GACI,IAAM,IAAK,EAAO,SAAS;GAC3B,EAAQ,YAAY,cAAc,IAAI,EAAG,GAAG,EAAG,GAAG,EAAG,GAAG,CAAC;EAC7D;EAGJ,IAAiB,EAAQ;CAC7B;CAGA,AAAG,EAAO,cAEN,QAAQ,KACJ,4KAEJ;CAIJ,IAAM,IAAW,IAAI,EAAoC,eAAe,CAAE;CAM1E,AALA,EAAS,gBAAgB,GACzB,EAAG,QAAQ,CAAQ,GAGnB,EAAM,yBAAyB,GAC/B,EAAM,aAAa;CAInB,IAAM,IAAiB,EAAO,mBAAmB,IAAI,YACrD;EACI,MAAM,EAAG,WAAW;CACxB,CAAC;CAQD,AANA,EAAM,oBAAoB,cAC1B;EACI,EAAO,mBAAmB,OAAO,CAAc;CACnD,CAAC,GAGD,MAAM,EAAG,WAAW;AACxB"}

package/dist/sage.d.ts

@@ -6,9 +6,10 @@ import { AudioEngine } from "./engines/audio.d.ts";
 import { SceneEngine } from "./engines/scene.d.ts";
 import { AssetManager } from "./managers/asset.d.ts";
 /**
- * Creates and initializes a fully-wired GameEngine with rendering, physics, and entity management. A
- * game builds its own action registry, contexts, and bindings from the exported input module -- the engine
- * supplies the pieces input.md and events.md#delivery describe, not a device-to-binding routing loop.
+ * Creates and initializes a fully-wired GameEngine with rendering, physics, and entity management. The
+ * engine owns one InputManager (`engine.managers.inputManager`): its action registry, its action context
+ * registry, device state capture, and the routing loop that runs before each frame's fixed steps
+ * (docs/design/input.md). A game declares its own actions, contexts, and bindings onto it.
  *
  * @param canvas
  * @param entityClasses - The entity class table, keyed by class name, that the simulation spawns from
@@ -30,8 +31,8 @@ export * from "./utils/logger.d.ts";
 export * from "./utils/metadata.d.ts";
 export * from "./utils/timer.d.ts";
 export * from "./utils/version.d.ts";
-export { Behavior, GameEntity, GameSimulationManager } from '@skewedaspect/sage-core';
-export type { BehaviorClass, ComposedOf, EventMap, EventSubscription, GameEntityState, GameEntityType, GameEvent as GameEntityEvent, GameSimulationContext, GameSimulationOptions, GameSimulationSnapshot, NarrowedTo, OpsFor, StateBag, StateFor, } from '@skewedaspect/sage-core';
+export { Behavior, EventBus, GameEntity, GameSimulationManager, NamedBehavior, StateMachineBehavior, defineStates, dilationLimit, drainPassLimit, operationCallDepthLimit, } from '@skewedaspect/sage-core';
+export type { BehaviorClass, ComposedOf, DeepReadonly, EventMap, EventSubscription, GameEntityState, GameEntityType, GameEvent as GameEntityEvent, GameSimulationContext, GameSimulationOptions, GameSimulationSnapshot, NamedState, NarrowedTo, OpsFor, OpsOf, StateBag, StateFor, StateSliceOf, } from '@skewedaspect/sage-core';
 export { NodeEntity } from "./entities/nodeEntity.d.ts";
 export type { NodeEntityState, QuaternionState, Vector3State } from "./entities/nodeEntity.d.ts";
 export { NodePool } from "./entities/nodePool.d.ts";
@@ -44,6 +45,8 @@ export type { GameEntityDefinition, GameEntityDefinitionClass } from "./entities
 export { buildStandardMeshSource } from "./entities/standardMeshSource.d.ts";
 export type { MeshAssetSource } from "./entities/standardMeshSource.d.ts";
 export type { MeshConfig, MeshMaterialConfig } from "./entities/meshConfig.d.ts";
+export { SoundBehavior } from "./behaviors/sound.d.ts";
+export type { SoundConfig, SoundState } from "./behaviors/sound.d.ts";
 export { ActionRegistry } from "./input/actionRegistry.d.ts";
 export { ActionContextRegistry } from "./input/actionContext.d.ts";
 export type { Binding, BindingDefinition, BindingFire, BindingInput, BindingKind, DeviceID, DeviceType, } from "./input/binding.d.ts";
@@ -60,6 +63,8 @@ export { ToggleBinding } from "./input/bindings/toggle.d.ts";
 export type { ToggleOptions } from "./input/bindings/toggle.d.ts";
 export { ValueBinding } from "./input/bindings/value.d.ts";
 export type { ValueOptions } from "./input/bindings/value.d.ts";
+export { DeltaBinding } from "./input/bindings/delta.d.ts";
+export type { DeltaOptions } from "./input/bindings/delta.d.ts";
 export { resolveBinding } from "./input/resolveBinding.d.ts";
 export { deliverAction } from "./input/deliverAction.d.ts";
 export { InputCapture } from "./input/inputCapture.d.ts";
@@ -68,6 +73,7 @@ export { exportConfiguration, importConfiguration } from "./input/configuration.
 export type { Configuration, ContextDefinition } from "./input/configuration.d.ts";
 export type { Action, AnalogAction, DigitalAction } from '@skewedaspect/sage-core';
 export type { FrameCallback } from "./managers/game.d.ts";
+export { InputManager, ROUTING_LOOP_SENDER_ID } from "./managers/input.d.ts";
 export type { TransitionOptions } from "./managers/level.d.ts";
 export { AudioManager } from "./managers/audio.d.ts";
 export type { ChannelInfo } from "./managers/audio.d.ts";
@@ -77,6 +83,8 @@ export { OutlineManager } from "./managers/outline.d.ts";
 export { SimulationSaveManager } from "./managers/simulationSave.d.ts";
 export type { BeforeSaveHook, LevelLoader, LoadResult, SaveEnvelope } from "./managers/simulationSave.d.ts";
 export { DebugConsole } from "./classes/debugConsole.d.ts";
+export { computeHierarchyBounds } from "./utils/bounds.d.ts";
+export type { HierarchyBounds } from "./utils/bounds.d.ts";
 export { generateId } from "./utils/id.d.ts";
 export { StateMachine } from "./utils/stateMachine.d.ts";
 export { getCanonicalTransform, toQuatObject, toQuaternion, toVec3Object, toVector3, } from "./utils/vectors.d.ts";