A fast 2D and 3D game engine — TypeScript SDK, C++/WebAssembly core, visual editor. Ship one project to web, desktop, WeChat MiniGames, playable ads, and native Android / iOS.
TypeScript 2d-game-engine3d3d-game-engineandroidcppecsgame-editorgame-enginegamedeviostypescriptwebassemblywebglwebgpuwechat-minigame
refactor(engine): 26 entry points the engine offered and no host asked for
esengine544c6814c7bb
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex fa9812143..0c1d04d94 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -16,6 +16,23 @@ published separately; it ships inside the editor.### Changed+- **Removed: 26 engine entry points no host called.** Five of them+ (`renderer_submitSprites` / `submitUIElements` / `submitBitmapText` /+ `submitShapes` / `submitParticles`) had bodies that were `(void)registry;` —+ collection moved to `renderer_submitAll` and the per-type doors were left+ standing. The rest were an internal mechanism exposed twice (the seven+ clip-rect / stencil entries: UI masks are resolved inside the frame, never from+ JS), a set of incremental post-process calls under a pipeline the SDK rebuilds+ whole (`removePass` / `setPassEnabled` / `isPassEnabled` / `getPassCount` /+ `isBypassed` / `setOutputTarget`), superseded entries (`initRendererWithCanvas`,+ `renderFrameWithMatrix`, `mesh_create`, the per-entity `meshRenderer_setMesh` /+ `makeResident` beside their `…All` forms), and three queries nothing read.++ New gate `check-engine-exports`: every `emscripten::function` must have a+ caller in the SDK, the editor, the tools or the tests — the pointer accessors+ are exempted from the generated layout table itself, so a new component cannot+ make one look dead.+- **Removed: three machines nothing ever drove.** `SubmitSkipFlags` named tworender plugins to skip — one of which (`Spine`) has had no plugin to skipsince spine moved to side modules — and the only `submitAll` in the enginediff --git a/sdk/etc/wasm.api.md b/sdk/etc/wasm.api.mdindex 8fc7b7d6c..436c31fb8 100644--- a/sdk/etc/wasm.api.md+++ b/sdk/etc/wasm.api.md@@ -283,13 +283,11 @@ getUINodeAlphaInTree: ((registry: CppRegistry, entity: number) => number) | undegetUINodeComputedHeight: ((registry: CppRegistry, entity: number) => number) | undefinedgetUINodeComputedWidth: ((registry: CppRegistry, entity: number) => number) | undefinedgetUINodeHiddenInTree: ((registry: CppRegistry, entity: number) => boolean) | undefined-getUINodePointerBlockedInTree: ((registry: CppRegistry, entity: number) => boolean) | undefinedgetVelocityPtr: (registry: CppRegistry, entity: number) => numbergl_checkErrors: (context: string) => numbergl_enableErrorCheck: (enabled: boolean) => voidinitRenderer: () => voidinitRendererWebGPU: (canvasSelector: string, width: number, height: number, readback: boolean, preferBGRA: boolean) => boolean-initRendererWithCanvas: (canvasSelector: string) => booleaninitRendererWithContext: (contextHandle: number) => booleanmarkDeviceRestored: (() => number) | undefinedmaterial_compileEsshader: (source: string, featuresCsv: string) => number@@ -299,12 +297,9 @@ material_setUniform: (materialId: number, name: string, arity: number, v0: numbematerial_undefine: (materialId: number) => voidmeshRenderer_localBounds: ((registry: CppRegistry, entity: number) => { minX: number; minY: number; maxX: number; maxY: number; } | null) | undefinedmeshRenderer_makeAllResident: ((registry: CppRegistry) => number) | undefined-meshRenderer_makeResident: ((registry: CppRegistry, entity: number) => number) | undefinedmeshRenderer_setGeometry: ((registry: CppRegistry, entity: number, posUvPtr: number, vertexCount: number, colorsPtr: number, indicesPtr: number, indexCount: number) => void) | undefinedmeshRenderer_setMaterialAll: ((registry: CppRegistry, materialId: number) => number) | undefined-meshRenderer_setMesh: ((registry: CppRegistry, entity: number, meshHandle: number) => void) | undefinedmeshRenderer_setMeshAll: ((registry: CppRegistry, meshHandle: number) => number) | undefined-mesh_create: ((posUvPtr: number, vertexCount: number, colorsPtr: number, indicesPtr: number, indexCount: number) => number) | undefinedmesh_createFromChannels: ((channelsPtr: number, channelCount: number, vertexStride: number, vertexPtr: number, vertexBytes: number, indexPtr: number, indexCount: number, minX: number, minY: number, minZ: number, maxX: number, maxY: number, maxZ: number, bindPtr: number, bindFloats: number) => number) | undefinedmesh_release: ((meshHandle: number) => void) | undefinednotifyDeviceLost: ((reason: number, message: string) => void) | undefined@@ -324,17 +319,11 @@ postprocess_clearScreenPasses: () => voidpostprocess_end: () => voidpostprocess_endScreenCapture: () => voidpostprocess_executeScreenPasses: () => void-postprocess_getPassCount: () => numberpostprocess_init: (width: number, height: number) => boolean-postprocess_isBypassed: () => booleanpostprocess_isInitialized: () => boolean-postprocess_isPassEnabled: (name: string) => boolean-postprocess_removePass: (name: string) => voidpostprocess_resize: (width: number, height: number) => voidpostprocess_setBypass: (bypass: boolean) => void-postprocess_setOutputTarget: (fboId: number) => voidpostprocess_setOutputViewport: (x: number, y: number, w: number, h: number) => void-postprocess_setPassEnabled: (name: string, enabled: boolean) => voidpostprocess_setPassTexture: (passName: string, uniform: string, textureHandle: number) => voidpostprocess_setScreenUniformFloat: (passName: string, uniform: string, value: number) => voidpostprocess_setScreenUniformVec4: (passName: string, uniform: string, x: number, y: number, z: number, w: number) => void@@ -348,15 +337,10 @@ registry_getCameraEntities: (registry: CppRegistry) => number[]registry_getCanvasEntities: ((registry: CppRegistry) => number[]) | undefinedregistry_getCanvasEntity: (registry: CppRegistry) => numberregistry_getGeneration: (registry: CppRegistry, entity: number) => number-renderFrameWithMatrix: (registry: CppRegistry, width: number, height: number, matrixPtr: number) => voidrenderer_begin: (matrixPtr: number, targetHandle: number, clearFlags: number, r: number, g: number, b: number, a: number, clearX: number, clearY: number, clearW: number, clearH: number) => voidrenderer_beginFrame: (elapsedSec: number) => voidrenderer_captureFrame: ((w: number, h: number) => number) | undefinedrenderer_captureNextFrame: () => void-renderer_clearAllClipRects: () => void-renderer_clearAllStencilMasks: () => void-renderer_clearEntityClipRect: (entity: number) => void-renderer_clearEntityStencilMask: (entity: number) => voidrenderer_createTarget: (width: number, height: number, flags: number) => numberrenderer_diagnose: () => voidrenderer_end: () => void@@ -400,22 +384,14 @@ renderer_setClearColor: (r: number, g: number, b: number, a: number) => voidrenderer_setColorSpace: ((linear: number) => void) | undefinedrenderer_setCullingMask: ((mask: number) => void) | undefinedrenderer_setDepthLayers: ((mask: number) => void) | undefined-renderer_setEntityClipRect: (entity: number, x: number, y: number, w: number, h: number) => voidrenderer_setEntityDrawOrder: ((registry: CppRegistry, entitiesPtr: number, count: number) => void) | undefined-renderer_setEntityStencilMask: (entity: number, refValue: number) => void-renderer_setEntityStencilTest: (entity: number, refValue: number) => voidrenderer_setStage: (stage: number) => voidrenderer_setTextureParams: (textureId: number, minFilter: number, magFilter: number, wrapS: number, wrapT: number) => voidrenderer_setViewport: (x: number, y: number, w: number, h: number) => voidrenderer_setYSortLayers: ((mask: number) => void) | undefinedrenderer_submitAll: (registry: CppRegistry, vpX: number, vpY: number, vpW: number, vpH: number) => void-renderer_submitBitmapText: (registry: CppRegistry) => void-renderer_submitParticles: ((registry: CppRegistry) => void) | undefined-renderer_submitShapes: ((registry: CppRegistry) => void) | undefinedrenderer_submitSkeletalBatchByEntity: ((registry: CppRegistry, verticesPtr: number, vertexCount: number, indicesPtr: number, indexCount: number, textureId: number, blendMode: number, entity: number, skelScale: number, flipX: boolean, flipY: boolean, layer: number, depth: number, materialId: number) => void) | undefined-renderer_submitSprites: (registry: CppRegistry) => voidrenderer_submitTextBatch: ((verticesPtr: number, vertexCount: number, indicesPtr: number, indexCount: number, textureId: number, transformPtr: number, entity: number, layer: number, depth: number, sdf: number, cullBit: number) => void) | undefined-renderer_submitUIElements: (registry: CppRegistry) => voidrenderer_takeFrameCapture: ((handle: number, dest: number, destSize: number) => boolean) | undefinedrenderer_updateTransforms: (registry: CppRegistry) => voidsdfFromAlpha: ((alphaPtr: number, outPtr: number, width: number, height: number, spread: number) => void) | undefined@@ -433,10 +409,8 @@ tilemap_setTile: ((entity: number, x: number, y: number, tileId: number) => voidtilemap_setTiles: ((entity: number, tilesPtr: number, count: number) => void) | undefinedtrail_clear: ((registry: CppRegistry, entity: number) => void) | undefinedtrail_update: ((registry: CppRegistry, dt: number) => void) | undefined-transform_patchPosition: (registry: CppRegistry, entity: number, x: number, y: number, z: number) => voidtransform_update: (registry: CppRegistry) => voiduiHitTest_getHitEntity: () => number-uiHitTest_getHitEntityPrev: () => numberuiHitTest_pick: ((registry: CppRegistry, worldX: number, worldY: number) => number) | undefineduiHitTest_pickAll: ((registry: CppRegistry, worldX: number, worldY: number) => number) | undefineduiHitTest_pickResult: ((index: number) => number) | undefineddiff --git a/sdk/src/ecs/bridge/nativeEngineApi.generated.ts b/sdk/src/ecs/bridge/nativeEngineApi.generated.tsindex b1017c2fc..849127695 100644--- a/sdk/src/ecs/bridge/nativeEngineApi.generated.ts+++ b/sdk/src/ecs/bridge/nativeEngineApi.generated.ts@@ -60,7 +60,6 @@ export interface NativeEngineApi {getUINodeComputedHeight?(registry: unknown, entity: number): number;getUINodeComputedWidth?(registry: unknown, entity: number): number;getUINodeHiddenInTree?(registry: unknown, entity: number): boolean;- getUINodePointerBlockedInTree?(registry: unknown, entity: number): boolean;gl_checkErrors?(context: string): number;gl_enableErrorCheck?(enabled: boolean): void;material_compileEsshader?(source: string, featuresCsv: string): number;@@ -69,12 +68,9 @@ export interface NativeEngineApi {material_setUniform?(materialId: number, name: string, arity: number, v0: number, v1: number, v2: number, v3: number): void;material_undefine?(materialId: number): void;meshRenderer_makeAllResident?(registry: unknown): number;- meshRenderer_makeResident?(registry: unknown, entity: number): number;meshRenderer_setGeometry?(registry: unknown, entity: number, posUvPtr: number, vertexCount: number, colorsPtr: number, indicesPtr: number, indexCount: number): void;meshRenderer_setMaterialAll?(registry: unknown, materialId: number): number;- meshRenderer_setMesh?(registry: unknown, entity: number, meshHandle: number): void;meshRenderer_setMeshAll?(registry: unknown, meshHandle: number): number;- mesh_create?(posUvPtr: number, vertexCount: number, colorsPtr: number, indicesPtr: number, indexCount: number): number;mesh_createFromChannels?(channelsPtr: number, channelCount: number, vertexStride: number, vertexPtr: number, vertexBytes: number, indexPtr: number, indexCount: number, minX: number, minY: number, minZ: number, maxX: number, maxY: number, maxZ: number, bindPtr: number, bindFloats: number): number;mesh_release?(meshHandle: number): void;particle_getAliveCount?(entity: number): number;@@ -93,17 +89,11 @@ export interface NativeEngineApi {postprocess_end?(): void;postprocess_endScreenCapture?(): void;postprocess_executeScreenPasses?(): void;- postprocess_getPassCount?(): number;postprocess_init?(width: number, height: number): boolean;- postprocess_isBypassed?(): boolean;postprocess_isInitialized?(): boolean;- postprocess_isPassEnabled?(name: string): boolean;- postprocess_removePass?(name: string): void;postprocess_resize?(width: number, height: number): void;postprocess_setBypass?(bypass: boolean): void;- postprocess_setOutputTarget?(fboId: number): void;postprocess_setOutputViewport?(x: number, y: number, w: number, h: number): void;- postprocess_setPassEnabled?(name: string, enabled: boolean): void;postprocess_setPassTexture?(passName: string, uniform: string, textureHandle: number): void;postprocess_setScreenUniformFloat?(passName: string, uniform: string, value: number): void;postprocess_setScreenUniformVec4?(passName: string, uniform: string, x: number, y: number, z: number, w: number): void;@@ -113,15 +103,10 @@ export interface NativeEngineApi {registry_batchSyncPhysicsTransforms?(registry: unknown, bufferPtr: number, count: number, ppu: number): void;registry_getCanvasEntity?(registry: unknown): number;registry_getGeneration?(registry: unknown, entity: number): number;- renderFrameWithMatrix?(registry: unknown, viewportWidth: number, viewportHeight: number, matrixPtr: number): void;renderer_begin?(matrixPtr: number, targetHandle: number, clearFlags: number, r: number, g: number, b: number, a: number, clearX: number, clearY: number, clearW: number, clearH: number): void;renderer_beginFrame?(elapsedSec: number): void;renderer_captureFrame?(w: number, h: number): number;renderer_captureNextFrame?(): void;- renderer_clearAllClipRects?(): void;- renderer_clearAllStencilMasks?(): void;- renderer_clearEntityClipRect?(entity: number): void;- renderer_clearEntityStencilMask?(entity: number): void;renderer_createTarget?(width: number, height: number, flags: number): number;renderer_diagnose?(): void;renderer_end?(): void;@@ -160,22 +145,14 @@ export interface NativeEngineApi {renderer_setColorSpace?(linear: number): void;renderer_setCullingMask?(mask: number): void;renderer_setDepthLayers?(mask: number): void;- renderer_setEntityClipRect?(entity: number, x: number, y: number, w: number, h: number): void;renderer_setEntityDrawOrder?(registry: unknown, entitiesPtr: number, count: number): void;- renderer_setEntityStencilMask?(entity: number, refValue: number): void;- renderer_setEntityStencilTest?(entity: number, refValue: number): void;renderer_setStage?(stage: number): void;renderer_setTextureParams?(textureId: number, minFilter: number, magFilter: number, wrapS: number, wrapT: number): void;renderer_setViewport?(x: number, y: number, w: number, h: number): void;renderer_setYSortLayers?(mask: number): void;renderer_submitAll?(registry: unknown, vpX: number, vpY: number, vpW: number, vpH: number): void;- renderer_submitBitmapText?(registry: unknown): void;- renderer_submitParticles?(registry: unknown): void;- renderer_submitShapes?(registry: unknown): void;renderer_submitSkeletalBatchByEntity?(registry: unknown, verticesPtr: number, vertexCount: number, indicesPtr: number, indexCount: number, textureId: number, blendMode: number, entity: number, skelScale: number, flipX: boolean, flipY: boolean, layer: number, depth: number, materialId: number): void;- renderer_submitSprites?(registry: unknown): void;renderer_submitTextBatch?(verticesPtr: number, vertexCount: number, indicesPtr: number, indexCount: number, textureId: number, transformPtr: number, entity: number, layer: number, depth: number, sdf: number, cullBit: number): void;- renderer_submitUIElements?(registry: unknown): void;renderer_takeFrameCapture?(handle: number, dest: number, destSize: number): boolean;renderer_updateTransforms?(registry: unknown): void;rm_acquireTextureByPath?(rm: unknown, path: string): number;@@ -234,10 +211,8 @@ export interface NativeEngineApi {tilemap_worldToTile?(entity: number, wx: number, wy: number, originX: number, originY: number): number;trail_clear?(registry: unknown, entity: number): void;trail_update?(registry: unknown, dt: number): void;- transform_patchPosition?(registry: unknown, entity: number, x: number, y: number, z: number): void;transform_update?(registry: unknown): void;uiHitTest_getHitEntity?(): number;- uiHitTest_getHitEntityPrev?(): number;uiHitTest_pick?(registry: unknown, worldX: number, worldY: number): number;uiHitTest_pickAll?(registry: unknown, worldX: number, worldY: number): number;uiHitTest_pickResult?(index: number): number;@@ -310,7 +285,6 @@ export function createNativeEngineApi(bind('getUINodeComputedHeight', 'es_getUINodeComputedHeight', true);bind('getUINodeComputedWidth', 'es_getUINodeComputedWidth', true);bind('getUINodeHiddenInTree', 'es_getUINodeHiddenInTree', true);- bind('getUINodePointerBlockedInTree', 'es_getUINodePointerBlockedInTree', true);bind('gl_checkErrors', 'es_gl_checkErrors', false);bind('gl_enableErrorCheck', 'es_gl_enableErrorCheck', false);bind('material_compileEsshader', 'es_material_compileEsshader', false);@@ -319,12 +293,9 @@ export function createNativeEngineApi(bind('material_setUniform', 'es_material_setUniform', false);bind('material_undefine', 'es_material_undefine', false);bind('meshRenderer_makeAllResident', 'es_meshRenderer_makeAllResident', true);- bind('meshRenderer_makeResident', 'es_meshRenderer_makeResident', true);bind('meshRenderer_setGeometry', 'es_meshRenderer_setGeometry', true);bind('meshRenderer_setMaterialAll', 'es_meshRenderer_setMaterialAll', true);- bind('meshRenderer_setMesh', 'es_meshRenderer_setMesh', true);bind('meshRenderer_setMeshAll', 'es_meshRenderer_setMeshAll', true);- bind('mesh_create', 'es_mesh_create', false);bind('mesh_createFromChannels', 'es_mesh_createFromChannels', false);bind('mesh_release', 'es_mesh_release', false);bind('particle_getAliveCount', 'es_particle_getAliveCount', false);@@ -343,17 +314,11 @@ export function createNativeEngineApi(bind('postprocess_end', 'es_postprocess_end', false);bind('postprocess_endScreenCapture', 'es_postprocess_endScreenCapture', false);bind('postprocess_executeScreenPasses', 'es_postprocess_executeScreenPasses', false);- bind('postprocess_getPassCount', 'es_postprocess_getPassCount', false);bind('postprocess_init', 'es_postprocess_init', false);- bind('postprocess_isBypassed', 'es_postprocess_isBypassed', false);bind('postprocess_isInitialized', 'es_postprocess_isInitialized', false);- bind('postprocess_isPassEnabled', 'es_postprocess_isPassEnabled', false);- bind('postprocess_removePass', 'es_postprocess_removePass', false);bind('postprocess_resize', 'es_postprocess_resize', false);bind('postprocess_setBypass', 'es_postprocess_setBypass', false);- bind('postprocess_setOutputTarget', 'es_postprocess_setOutputTarget', false);bind('postprocess_setOutputViewport', 'es_postprocess_setOutputViewport', false);- bind('postprocess_setPassEnabled', 'es_postprocess_setPassEnabled', false);bind('postprocess_setPassTexture', 'es_postprocess_setPassTexture', false);bind('postprocess_setScreenUniformFloat', 'es_postprocess_setScreenUniformFloat', false);bind('postprocess_setScreenUniformVec4', 'es_postprocess_setScreenUniformVec4', false);@@ -363,15 +328,10 @@ export function createNativeEngineApi(bind('registry_batchSyncPhysicsTransforms', 'es_registry_batchSyncPhysicsTransforms', true);bind('registry_getCanvasEntity', 'es_registry_getCanvasEntity', true);bind('registry_getGeneration', 'es_registry_getGeneration', true);- bind('renderFrameWithMatrix', 'es_renderFrameWithMatrix', true);bind('renderer_begin', 'es_renderer_begin', false);bind('renderer_beginFrame', 'es_renderer_beginFrame', false);bind('renderer_captureFrame', 'es_renderer_captureFrame', false);bind('renderer_captureNextFrame', 'es_renderer_captureNextFrame', false);- bind('renderer_clearAllClipRects', 'es_renderer_clearAllClipRects', false);- bind('renderer_clearAllStencilMasks', 'es_renderer_clearAllStencilMasks', false);- bind('renderer_clearEntityClipRect', 'es_renderer_clearEntityClipRect', false);- bind('renderer_clearEntityStencilMask', 'es_renderer_clearEntityStencilMask', false);bind('renderer_createTarget', 'es_renderer_createTarget', false);bind('renderer_diagnose', 'es_renderer_diagnose', false);bind('renderer_end', 'es_renderer_end', false);@@ -410,22 +370,14 @@ export function createNativeEngineApi(bind('renderer_setColorSpace', 'es_renderer_setColorSpace', false);bind('renderer_setCullingMask', 'es_renderer_setCullingMask', false);bind('renderer_setDepthLayers', 'es_renderer_setDepthLayers', false);- bind('renderer_setEntityClipRect', 'es_renderer_setEntityClipRect', false);bind('renderer_setEntityDrawOrder', 'es_renderer_setEntityDrawOrder', true);- bind('renderer_setEntityStencilMask', 'es_renderer_setEntityStencilMask', false);- bind('renderer_setEntityStencilTest', 'es_renderer_setEntityStencilTest', false);bind('renderer_setStage', 'es_renderer_setStage', false);bind('renderer_setTextureParams', 'es_renderer_setTextureParams', false);bind('renderer_setViewport', 'es_renderer_setViewport', false);bind('renderer_setYSortLayers', 'es_renderer_setYSortLayers', false);bind('renderer_submitAll', 'es_renderer_submitAll', true);- bind('renderer_submitBitmapText', 'es_renderer_submitBitmapText', true);- bind('renderer_submitParticles', 'es_renderer_submitParticles', true);- bind('renderer_submitShapes', 'es_renderer_submitShapes', true);bind('renderer_submitSkeletalBatchByEntity', 'es_renderer_submitSkeletalBatchByEntity', true);- bind('renderer_submitSprites', 'es_renderer_submitSprites', true);bind('renderer_submitTextBatch', 'es_renderer_submitTextBatch', false);- bind('renderer_submitUIElements', 'es_renderer_submitUIElements', true);bind('renderer_takeFrameCapture', 'es_renderer_takeFrameCapture', false);bind('renderer_updateTransforms', 'es_renderer_updateTransforms', true);bind('rm_acquireTextureByPath', 'es_rm_acquireTextureByPath', true);@@ -484,10 +436,8 @@ export function createNativeEngineApi(bind('tilemap_worldToTile', 'es_tilemap_worldToTile', false);bind('trail_clear', 'es_trail_clear', true);bind('trail_update', 'es_trail_update', true);- bind('transform_patchPosition', 'es_transform_patchPosition', true);bind('transform_update', 'es_transform_update', true);bind('uiHitTest_getHitEntity', 'es_uiHitTest_getHitEntity', false);- bind('uiHitTest_getHitEntityPrev', 'es_uiHitTest_getHitEntityPrev', false);bind('uiHitTest_pick', 'es_uiHitTest_pick', true);bind('uiHitTest_pickAll', 'es_uiHitTest_pickAll', true);bind('uiHitTest_pickResult', 'es_uiHitTest_pickResult', false);diff --git a/sdk/src/wasm.ts b/sdk/src/wasm.tsindex 520b82763..d8d795011 100644--- a/sdk/src/wasm.ts+++ b/sdk/src/wasm.ts@@ -161,7 +161,6 @@ export interface ESEngineModule {FS: EmscriptenFS;initRenderer(): void;- initRendererWithCanvas(canvasSelector: string): boolean;initRendererWithContext(contextHandle: number): boolean;/*** Boot on the WebGPU backend. The host must acquire a GPUDevice and pass it@@ -194,7 +193,6 @@ export interface ESEngineModule {/** Emscripten-internal: texture object pool keyed by handle id. */textures: Record<number, WebGLTexture>;};- renderFrameWithMatrix(registry: CppRegistry, width: number, height: number, matrixPtr: number): void;getResourceManager(): CppResourceManager;/*** Convert a Canvas2D-rasterized alpha bitmap to a signed distance field for@@ -218,19 +216,6 @@ export interface ESEngineModule {* on its own next poll. Reason codes match GfxDeviceLostReason.*/notifyDeviceLost?(reason: number, message: string): void;- /**- * Rebuild the renderer after a loss. False means "not yet" — a browser- * restores a context when it is ready, so this is expected to be retried.- * On success the device is Recovering: drawing, with placeholder textures.- */- /**- * Upload geometry that STAYS on the GPU: interleaved f32 [x,y,z,u,v] per- * vertex, optional RGBA8 colors, u32 triangle indices. Any number of entities- * can draw the result, each with its own transform. Where the inline- * `meshRenderer_setGeometry` payload is rewritten per frame, this is uploaded once.- */- mesh_create?(posUvPtr: number, vertexCount: number, colorsPtr: number,- indicesPtr: number, indexCount: number): number;/*** Upload geometry described by an .esmesh channel table — 8 bytes per channel* (semantic, components, type, normalized, offset) in the file's own layout,@@ -254,14 +239,6 @@ export interface ESEngineModule {mipCount: number, maxRange: number): number;/** Release an environment; its atlas is an ordinary texture and outlives it. */environment_release?(environmentHandle: number): void;- /** Point a MeshRenderer at a resident mesh; 0 returns it to its inline payload. */- meshRenderer_setMesh?(registry: CppRegistry, entity: number, meshHandle: number): void;- /**- * Freeze a MeshRenderer's inline geometry onto the GPU — the same vertices, uploaded- * once and drawn with a per-object transform. Returns the mesh handle, 0 if- * the entity had no geometry to freeze.- */- meshRenderer_makeResident?(registry: CppRegistry, entity: number): number;/** The same for every MeshRenderer in the world; returns how many were frozen. */meshRenderer_makeAllResident?(registry: CppRegistry): number;/**@@ -399,20 +376,14 @@ export interface ESEngineModule {postprocess_shutdown(): void;postprocess_resize(width: number, height: number): void;postprocess_addPass(name: string, shaderHandle: number): number;- postprocess_removePass(name: string): void;- postprocess_setPassEnabled(name: string, enabled: boolean): void;- postprocess_isPassEnabled(name: string): boolean;postprocess_setUniformFloat(passName: string, uniform: string, value: number): void;postprocess_setPassTexture(passName: string, uniform: string, textureHandle: number): void;postprocess_setUniformVec4(passName: string, uniform: string, x: number, y: number, z: number, w: number): void;postprocess_begin(): void;postprocess_end(): void;- postprocess_getPassCount(): number;postprocess_isInitialized(): boolean;postprocess_setBypass(bypass: boolean): void;- postprocess_isBypassed(): boolean;postprocess_clearPasses(): void;- postprocess_setOutputTarget(fboId: number): void;postprocess_setOutputViewport(x: number, y: number, w: number, h: number): void;postprocess_beginScreenCapture(): void;postprocess_endScreenCapture(): void;@@ -435,11 +406,6 @@ export interface ESEngineModule {clearX: number, clearY: number, clearW: number, clearH: number): void;renderer_flush(): void;renderer_end(): void;- renderer_submitSprites(registry: CppRegistry): void;- renderer_submitUIElements(registry: CppRegistry): void;- renderer_submitBitmapText(registry: CppRegistry): void;- renderer_submitShapes?(registry: CppRegistry): void;- renderer_submitParticles?(registry: CppRegistry): void;renderer_submitAll(registry: CppRegistry, vpX: number, vpY: number, vpW: number, vpH: number): void;particle_update?(registry: CppRegistry, dt: number): void;particle_play?(registry: CppRegistry, entity: number): void;@@ -513,16 +479,7 @@ export interface ESEngineModule {engine_setRandomSeed?(seed: number): void;renderer_setTextureParams(textureId: number, minFilter: number, magFilter: number, wrapS: number, wrapT: number): void;- // Clip Rect API- renderer_setEntityClipRect(entity: number, x: number, y: number, w: number, h: number): void;- renderer_clearEntityClipRect(entity: number): void;- renderer_clearAllClipRects(): void;- // Stencil API- renderer_setEntityStencilMask(entity: number, refValue: number): void;- renderer_setEntityStencilTest(entity: number, refValue: number): void;- renderer_clearEntityStencilMask(entity: number): void;- renderer_clearAllStencilMasks(): void;// ECS Query APIregistry_getCanvasEntity(registry: CppRegistry): number;@@ -572,7 +529,6 @@ export interface ESEngineModule {uiLayout_update(registry: CppRegistry, boxLeft: number, boxBottom: number, boxRight: number, boxTop: number, propertyDirty: boolean): void;uiHitTest_update(registry: CppRegistry, mouseWorldX: number, mouseWorldY: number): void;uiHitTest_getHitEntity(): number;- uiHitTest_getHitEntityPrev(): number;uiHitTest_pick?(registry: CppRegistry, worldX: number, worldY: number): number;uiHitTest_pickAll?(registry: CppRegistry, worldX: number, worldY: number): number;uiHitTest_pickResult?(index: number): number;@@ -584,10 +540,7 @@ export interface ESEngineModule {getUINodeHiddenInTree?(registry: CppRegistry, entity: number): boolean;/** Subtree opacity resolved by the layout pass (UINode.opacity multiplied down). */getUINodeAlphaInTree?(registry: CppRegistry, entity: number): number;- /** True when this node or an ancestor set pointerEvents = None. */- getUINodePointerBlockedInTree?(registry: CppRegistry, entity: number): boolean;transform_update(registry: CppRegistry): void;- transform_patchPosition(registry: CppRegistry, entity: number, x: number, y: number, z: number): void;// Animation (Tween) APIanim_createTween(registry: CppRegistry, entity: number, targetProp: number,diff --git a/src/esengine/bindings/PostProcessBindings.cpp b/src/esengine/bindings/PostProcessBindings.cppindex fa11a346f..486b3324e 100644--- a/src/esengine/bindings/PostProcessBindings.cpp+++ b/src/esengine/bindings/PostProcessBindings.cpp@@ -65,23 +65,6 @@ u32 postprocess_addPass(const std::string& name, u32 shaderHandle) {return g_postProcessPipeline->addPass(name, resource::ShaderHandle(shaderHandle));}-void postprocess_removePass(const std::string& name) {- if (g_postProcessPipeline) {- g_postProcessPipeline->removePass(name);- }-}--void postprocess_setPassEnabled(const std::string& name, bool enabled) {- if (g_postProcessPipeline) {- g_postProcessPipeline->setPassEnabled(name, enabled);- }-}--bool postprocess_isPassEnabled(const std::string& name) {- if (!g_postProcessPipeline) return false;- return g_postProcessPipeline->isPassEnabled(name);-}-void postprocess_setUniformFloat(const std::string& passName,const std::string& uniform, f32 value) {if (g_postProcessPipeline) {@@ -123,11 +106,6 @@ void postprocess_end() {}}-u32 postprocess_getPassCount() {- if (!g_postProcessPipeline) return 0;- return g_postProcessPipeline->getPassCount();-}-bool postprocess_isInitialized() {if (!g_postProcessPipeline) return false;return g_postProcessPipeline->isInitialized();@@ -139,23 +117,12 @@ void postprocess_setBypass(bool bypass) {}}-bool postprocess_isBypassed() {- if (!g_postProcessPipeline) return true;- return g_postProcessPipeline->isBypassed();-}-void postprocess_clearPasses() {if (g_postProcessPipeline) {g_postProcessPipeline->clearPasses();}}-void postprocess_setOutputTarget(u32 fboId) {- if (g_postProcessPipeline) {- g_postProcessPipeline->setOutputTarget(FramebufferHandle{fboId});- }-}-void postprocess_setOutputViewport(u32 x, u32 y, u32 w, u32 h) {if (g_postProcessPipeline) {g_postProcessPipeline->setOutputViewport(x, y, w, h);diff --git a/src/esengine/bindings/PostProcessBindings.hpp b/src/esengine/bindings/PostProcessBindings.hppindex 9415db262..c2b7e141f 100644--- a/src/esengine/bindings/PostProcessBindings.hpp+++ b/src/esengine/bindings/PostProcessBindings.hpp@@ -12,9 +12,6 @@ bool postprocess_init(u32 width, u32 height);void postprocess_shutdown();void postprocess_resize(u32 width, u32 height);u32 postprocess_addPass(const std::string& name, u32 shaderHandle);-void postprocess_removePass(const std::string& name);-void postprocess_setPassEnabled(const std::string& name, bool enabled);-bool postprocess_isPassEnabled(const std::string& name);void postprocess_setUniformFloat(const std::string& passName,const std::string& uniform, f32 value);void postprocess_setPassTexture(const std::string& passName,@@ -24,12 +21,9 @@ void postprocess_setUniformVec4(const std::string& passName,f32 x, f32 y, f32 z, f32 w);void postprocess_begin();void postprocess_end();-u32 postprocess_getPassCount();bool postprocess_isInitialized();void postprocess_setBypass(bool bypass);-bool postprocess_isBypassed();void postprocess_clearPasses();-void postprocess_setOutputTarget(u32 fboId);void postprocess_setOutputViewport(u32 x, u32 y, u32 w, u32 h);void postprocess_beginScreenCapture();diff --git a/src/esengine/bindings/RendererBindings.cpp b/src/esengine/bindings/RendererBindings.cppindex 466c449b7..364bfa1ac 100644--- a/src/esengine/bindings/RendererBindings.cpp+++ b/src/esengine/bindings/RendererBindings.cpp@@ -193,47 +193,6 @@ void meshRenderer_setGeometry(ecs::Registry& registry, u32 entity,// Geometry that STAYS on the GPU: interleaved f32 [x,y,z,u,v] plus optional RGBA8// colors, validated exactly as the inline path is. createMesh appends the// per-object transform, so nothing here knows how a mesh reaches the shader.-u32 mesh_create(uintptr_t posUvPtr, u32 vertexCount, uintptr_t colorsPtr,- uintptr_t indicesPtr, u32 indexCount) {- auto* rm = ctx().tryGet<resource::ResourceManager>();- if (!rm || posUvPtr == 0 || indicesPtr == 0 || vertexCount == 0 || indexCount == 0) return 0;- if (indexCount % 3 != 0) {- ES_LOG_WARN("mesh_create: indexCount {} is not a triangle list; rejected", indexCount);- return 0;- }-- const f32* posUv = boundarySpan<f32>(posUvPtr, static_cast<u64>(vertexCount) * 5, "mesh_create.posUv");- const u32* colors = colorsPtr ? boundarySpan<u32>(colorsPtr, vertexCount, "mesh_create.colors") : nullptr;- const u32* indices = boundarySpan<u32>(indicesPtr, indexCount, "mesh_create.indices");- if (!posUv || !indices || (colorsPtr && !colors)) return 0;-- for (u32 i = 0; i < indexCount; ++i) {- if (indices[i] >= vertexCount) {- ES_LOG_WARN("mesh_create: index {} out of range (vertexCount {}); rejected",- indices[i], vertexCount);- return 0;- }- }-- struct MeshVertex { f32 x, y, z, u, v; u32 color; };- static_assert(sizeof(MeshVertex) == 24, "vertex stride must match the mesh layout");- std::vector<MeshVertex> verts(vertexCount);- glm::vec3 mn(posUv[0], posUv[1], posUv[2]);- glm::vec3 mx = mn;- for (u32 i = 0; i < vertexCount; ++i) {- const f32* p = posUv + i * 5;- verts[i] = { p[0], p[1], p[2], p[3], p[4], colors ? colors[i] : 0xFFFFFFFFu };- mn = glm::min(mn, glm::vec3(p[0], p[1], p[2]));- mx = glm::max(mx, glm::vec3(p[0], p[1], p[2]));- }-- auto handle = rm->createMesh(- ConstSpan<u8>(reinterpret_cast<const u8*>(verts.data()), verts.size() * sizeof(MeshVertex)),- ConstSpan<u32>(indices, indexCount),- ConstSpan<GfxVertexAttribute>(kStandardMeshChannels, 3), sizeof(MeshVertex), mn, mx);- return handle.id();-}-// Geometry from an .esmesh. The channel table arrives in the file's own layout// (8 bytes each), so the asset layer owns the FORMAT and the engine owns the// vertex layout it becomes. A channel's semantic is its attribute location.@@ -362,10 +321,6 @@ u32 freezeMeshGeometry(ecs::MeshRenderer* mesh) {}} // namespace-u32 meshRenderer_makeResident(ecs::Registry& registry, u32 entity) {- return freezeMeshGeometry(registry.tryGet<ecs::MeshRenderer>(Entity::fromRaw(entity)));-}-u32 meshRenderer_setMeshAll(ecs::Registry& registry, u32 meshHandle) {u32 pointed = 0;for (auto entity : registry.view<ecs::MeshRenderer>()) {@@ -401,49 +356,6 @@ u32 meshRenderer_makeAllResident(ecs::Registry& registry) {}/** @brief Points a MeshRenderer at resident geometry; 0 returns it to its inline payload. */-void meshRenderer_setMesh(ecs::Registry& registry, u32 entity, u32 meshHandle) {- const Entity ent = Entity::fromRaw(entity);- auto* mesh = registry.tryGet<ecs::MeshRenderer>(ent);- if (!mesh) {- ES_LOG_WARN("meshRenderer_setMesh: entity {} has no MeshRenderer component", entity);- return;- }- mesh->mesh = resource::MeshHandle(meshHandle);-}--void renderFrameWithMatrix(ecs::Registry& registry, i32 viewportWidth, i32 viewportHeight,- uintptr_t matrixPtr) {- if (!g_initialized || !g_renderFrame) return;-- if (auto* rm = ctx().tryGet<resource::ResourceManager>()) {- rm->update();- const auto st = rm->getStats();- ES_PROFILE_COUNTER("res.textures", st.textureCount);- ES_PROFILE_COUNTER("res.cacheHits", st.cacheHits);- ES_PROFILE_COUNTER("res.cacheMisses", st.cacheMisses);- }-- if (g_transformSystem) {- esengine::World w{registry, ctx().services(), 0.0f};- g_transformSystem->update(w);- }-- ctx().state().viewport_width = static_cast<u32>(viewportWidth);- ctx().state().viewport_height = static_cast<u32>(viewportHeight);- g_renderFrame->resize(g_viewportWidth, g_viewportHeight);-- g_device->setViewport(0, 0, static_cast<u32>(viewportWidth), static_cast<u32>(viewportHeight));-- const f32* matrixData = boundarySpan<f32>(matrixPtr, 16, "renderFrameWithMatrix.matrix");- if (!matrixData) return;- glm::mat4 viewProjection = glm::make_mat4(matrixData);-- const auto& cc = ctx().state().clear_color;- g_renderFrame->begin(viewProjection, 0, RenderFrame::PassClear{true, true, cc});- g_renderFrame->collectAll(registry);- g_renderFrame->end();-}-void renderer_init(u32 width, u32 height) {if (!g_renderFrame) return;ctx().state().viewport_width = width;@@ -505,29 +417,11 @@ static void ensureTransformsUpdated(ecs::Registry& registry) {}}-void renderer_submitSprites(ecs::Registry& registry) {- (void)registry;-}--void renderer_submitUIElements(ecs::Registry& registry) {- (void)registry;-}-#ifdef ES_ENABLE_BITMAP_TEXT-void renderer_submitBitmapText(ecs::Registry& registry) {- (void)registry;-}#endif-void renderer_submitShapes(ecs::Registry& registry) {- (void)registry;-}-#ifdef ES_ENABLE_PARTICLES-void renderer_submitParticles(ecs::Registry& registry) {- (void)registry;-}#endifvoid renderer_updateTransforms(ecs::Registry& registry) {@@ -824,48 +718,6 @@ void renderer_diagnose() {ES_LOG_INFO("[Diagnose] No pending GL errors (cleared)");}-void renderer_setEntityClipRect(u32 entity, i32 x, i32 y, i32 w, i32 h) {- if (g_renderFrame) {- g_renderFrame->setEntityClipRect(entity, x, y, w, h);- }-}--void renderer_clearEntityClipRect(u32 entity) {- if (g_renderFrame) {- g_renderFrame->clearEntityClipRect(entity);- }-}--void renderer_clearAllClipRects() {- if (g_renderFrame) {- g_renderFrame->clearAllClipRects();- }-}--void renderer_setEntityStencilMask(u32 entity, i32 refValue) {- if (g_renderFrame) {- g_renderFrame->setEntityStencilMask(entity, refValue);- }-}--void renderer_setEntityStencilTest(u32 entity, i32 refValue) {- if (g_renderFrame) {- g_renderFrame->setEntityStencilTest(entity, refValue);- }-}--void renderer_clearEntityStencilMask(u32 entity) {- if (g_renderFrame) {- g_renderFrame->clearEntityStencilMask(entity);- }-}--void renderer_clearAllStencilMasks() {- if (g_renderFrame) {- g_renderFrame->clearAllStencilMasks();- }-}-void gl_enableErrorCheck(bool enabled) {ctx().state().gl_error_check_enabled = enabled;if (enabled) {diff --git a/src/esengine/bindings/RendererBindings.hpp b/src/esengine/bindings/RendererBindings.hppindex 1a15b2258..e360d2033 100644--- a/src/esengine/bindings/RendererBindings.hpp+++ b/src/esengine/bindings/RendererBindings.hpp@@ -21,8 +21,6 @@ namespace ecs {class Registry;}-void renderFrameWithMatrix(ecs::Registry& registry, i32 viewportWidth, i32 viewportHeight,- uintptr_t matrixPtr);void renderer_init(u32 width, u32 height);void renderer_resize(u32 width, u32 height);@@ -32,12 +30,8 @@ void renderer_begin(uintptr_t matrixPtr, u32 targetHandle, i32 clearFlags,i32 clearX, i32 clearY, u32 clearW, u32 clearH);void renderer_flush();void renderer_end();-void renderer_submitSprites(ecs::Registry& registry);-void renderer_submitUIElements(ecs::Registry& registry);#ifdef ES_ENABLE_BITMAP_TEXT-void renderer_submitBitmapText(ecs::Registry& registry);#endif-void renderer_submitShapes(ecs::Registry& registry);/// Geometry posed by a skeletal runtime (Spine, DragonBones): x,y,u,v,r,g,b,a per/// vertex, drawn as @p entity's, with its material resolved as a Sprite's is.void renderer_submitSkeletalBatchByEntity(@@ -76,13 +70,6 @@ u32 environment_create(uintptr_t shPtr, u32 specularHandle, f32 faceSize, u32 mi/** @brief Releases an environment; its atlas is an ordinary texture and outlives it. */void environment_release(u32 environmentHandle);-/** @brief Uploads geometry that stays on the GPU; returns its handle, 0 on failure. */-u32 mesh_create(uintptr_t posUvPtr, u32 vertexCount, uintptr_t colorsPtr,- uintptr_t indicesPtr, u32 indexCount);-/** @brief Points a MeshRenderer at resident geometry; 0 returns it to its inline payload. */-void meshRenderer_setMesh(ecs::Registry& registry, u32 entity, u32 meshHandle);-/** @brief Freezes a MeshRenderer's inline geometry onto the GPU; returns its handle. */-u32 meshRenderer_makeResident(ecs::Registry& registry, u32 entity);/** @brief Freezes every MeshRenderer in the world; returns how many were frozen. */u32 meshRenderer_makeAllResident(ecs::Registry& registry);/** @brief Points every MeshRenderer at one resident mesh; returns how many. */@@ -90,7 +77,6 @@ u32 meshRenderer_setMeshAll(ecs::Registry& registry, u32 meshHandle);/** @brief Points every MeshRenderer at one material; returns how many. */u32 meshRenderer_setMaterialAll(ecs::Registry& registry, u32 materialId);#ifdef ES_ENABLE_PARTICLES-void renderer_submitParticles(ecs::Registry& registry);#endifvoid renderer_updateTransforms(ecs::Registry& registry);void renderer_setEntityDrawOrder(ecs::Registry& registry, uintptr_t entitiesPtr, u32 count);@@ -145,14 +131,7 @@ void renderer_setCullingMask(u32 mask);/** Project colorSpace: 1 = linear-light rendering (set before shaders compile). */void renderer_setColorSpace(u32 linear);void renderer_diagnose();-void renderer_setEntityClipRect(u32 entity, i32 x, i32 y, i32 w, i32 h);-void renderer_clearEntityClipRect(u32 entity);-void renderer_clearAllClipRects();--void renderer_setEntityStencilMask(u32 entity, i32 refValue);-void renderer_setEntityStencilTest(u32 entity, i32 refValue);-void renderer_clearEntityStencilMask(u32 entity);-void renderer_clearAllStencilMasks();+void gl_enableErrorCheck(bool enabled);u32 gl_checkErrors(const std::string& context);diff --git a/src/esengine/bindings/UIBindings.cpp b/src/esengine/bindings/UIBindings.cppindex 53cb49095..fdcdbfe7f 100644--- a/src/esengine/bindings/UIBindings.cpp+++ b/src/esengine/bindings/UIBindings.cpp@@ -40,10 +40,6 @@ u32 uiHitTest_getHitEntity() {return ctx().require<ecs::UISystem>().getHitEntity();}-u32 uiHitTest_getHitEntityPrev() {- return ctx().require<ecs::UISystem>().getPrevHitEntity();-}-u32 uiHitTest_pick(ecs::Registry& registry, f32 worldX, f32 worldY) {return ctx().require<ecs::UISystem>().pick(registry, worldX, worldY);}@@ -102,11 +98,6 @@ f32 getUINodeAlphaInTree(ecs::Registry& registry, u32 entity) {return node ? node->alpha_in_tree_ : 1.0f;}-bool getUINodePointerBlockedInTree(ecs::Registry& registry, u32 entity) {- auto* node = registry.tryGet<ecs::UINode>(Entity::fromRaw(entity));- return node && node->pointer_blocked_in_tree_;-}-f32 getUINodeComputedWidth(ecs::Registry& registry, u32 entity) {auto* node = registry.tryGet<ecs::UINode>(Entity::fromRaw(entity));if (!node) return 0.0f;@@ -129,11 +120,4 @@ void transform_update(ecs::Registry& registry) {}}-void transform_patchPosition(ecs::Registry& registry, u32 entity,- f32 x, f32 y, f32 z) {- auto* transform = registry.tryGet<ecs::Transform>(Entity::fromRaw(entity));- if (!transform) return;- transform->position = {x, y, z};-}-} // namespace esenginediff --git a/src/esengine/bindings/UIBindings.hpp b/src/esengine/bindings/UIBindings.hppindex e416744f3..885b5a7e6 100644--- a/src/esengine/bindings/UIBindings.hpp+++ b/src/esengine/bindings/UIBindings.hpp@@ -30,7 +30,6 @@ void uiLayout_update(ecs::Registry& registry, f32 boxLeft, f32 boxBottom, f32 bovoid uiHitTest_update(ecs::Registry& registry, f32 mouseWorldX, f32 mouseWorldY);u32 uiHitTest_getHitEntity();-u32 uiHitTest_getHitEntityPrev();u32 uiHitTest_pick(ecs::Registry& registry, f32 worldX, f32 worldY);u32 uiHitTest_pickAll(ecs::Registry& registry, f32 worldX, f32 worldY);u32 uiHitTest_pickResult(u32 index);@@ -53,13 +52,10 @@ u32 ui_getCullBit(ecs::Registry& registry, u32 entity);bool getUINodeHiddenInTree(ecs::Registry& registry, u32 entity);/** Subtree opacity resolved by the layout pass (UINode.opacity multiplied down). */f32 getUINodeAlphaInTree(ecs::Registry& registry, u32 entity);-/** True when this node or an ancestor set pointerEvents = None. */-bool getUINodePointerBlockedInTree(ecs::Registry& registry, u32 entity);f32 getUINodeComputedWidth(ecs::Registry& registry, u32 entity);f32 getUINodeComputedHeight(ecs::Registry& registry, u32 entity);/** Compose world transforms now (the UI layout pass reads them). */void transform_update(ecs::Registry& registry);-void transform_patchPosition(ecs::Registry& registry, u32 entity, f32 x, f32 y, f32 z);} // namespace esenginediff --git a/src/esengine/bindings/WebSDKEntry.cpp b/src/esengine/bindings/WebSDKEntry.cppindex 5c9a8a545..ad4a12922 100644--- a/src/esengine/bindings/WebSDKEntry.cpp+++ b/src/esengine/bindings/WebSDKEntry.cpp@@ -231,10 +231,6 @@ void initRenderer() {initRendererInternal("#canvas");}-bool initRendererWithCanvas(const std::string& canvasSelector) {- return initRendererInternal(canvasSelector.c_str());-}-bool initRendererWithContext(int contextHandle) {if (g_initialized) return true;if (contextHandle <= 0) {@@ -463,13 +459,11 @@ EMSCRIPTEN_BINDINGS(esengine_context) {EMSCRIPTEN_BINDINGS(esengine_renderer) {emscripten::function("initRenderer", &esengine::initRenderer);- emscripten::function("initRendererWithCanvas", &esengine::initRendererWithCanvas);emscripten::function("initRendererWithContext", &esengine::initRendererWithContext);// Registered in every build variant; without ES_ENABLE_WEBGPU it reports// and returns false, so the JS surface never drifts across variants.emscripten::function("initRendererWebGPU", &esengine::initRendererWebGPU);emscripten::function("shutdownRenderer", &esengine::shutdownRenderer);- emscripten::function("renderFrameWithMatrix", &esengine::renderFrameWithMatrix);emscripten::function("getResourceManager", &esengine::getResourceManager, emscripten::allow_raw_pointers());emscripten::function("sdfFromAlpha", &esengine::web_sdfFromAlpha);emscripten::function("deviceStatus", &esengine::deviceStatus);@@ -519,14 +513,11 @@ EMSCRIPTEN_BINDINGS(esengine_renderer) {emscripten::function("renderer_submitSkeletalBatchByEntity", &esengine::renderer_submitSkeletalBatchByEntity);emscripten::function("renderer_submitTextBatch", &esengine::renderer_submitTextBatch);emscripten::function("meshRenderer_setGeometry", &esengine::meshRenderer_setGeometry);- emscripten::function("mesh_create", &esengine::mesh_create);emscripten::function("mesh_createFromChannels", &esengine::mesh_createFromChannels);emscripten::function("mesh_release", &esengine::mesh_release);emscripten::function("environment_create", &esengine::environment_create);emscripten::function("environment_release", &esengine::environment_release);- emscripten::function("meshRenderer_setMesh", &esengine::meshRenderer_setMesh);emscripten::function("meshRenderer_localBounds", &esengine::meshRenderer_localBounds);- emscripten::function("meshRenderer_makeResident", &esengine::meshRenderer_makeResident);emscripten::function("meshRenderer_makeAllResident", &esengine::meshRenderer_makeAllResident);emscripten::function("meshRenderer_setMeshAll", &esengine::meshRenderer_setMeshAll);emscripten::function("meshRenderer_setMaterialAll", &esengine::meshRenderer_setMaterialAll);@@ -572,20 +563,14 @@ EMSCRIPTEN_BINDINGS(esengine_renderer) {emscripten::function("postprocess_shutdown", &esengine::postprocess_shutdown);emscripten::function("postprocess_resize", &esengine::postprocess_resize);emscripten::function("postprocess_addPass", &esengine::postprocess_addPass);- emscripten::function("postprocess_removePass", &esengine::postprocess_removePass);- emscripten::function("postprocess_setPassEnabled", &esengine::postprocess_setPassEnabled);- emscripten::function("postprocess_isPassEnabled", &esengine::postprocess_isPassEnabled);emscripten::function("postprocess_setUniformFloat", &esengine::postprocess_setUniformFloat);emscripten::function("postprocess_setUniformVec4", &esengine::postprocess_setUniformVec4);emscripten::function("postprocess_setPassTexture", &esengine::postprocess_setPassTexture);emscripten::function("postprocess_begin", &esengine::postprocess_begin);emscripten::function("postprocess_end", &esengine::postprocess_end);- emscripten::function("postprocess_getPassCount", &esengine::postprocess_getPassCount);emscripten::function("postprocess_isInitialized", &esengine::postprocess_isInitialized);emscripten::function("postprocess_setBypass", &esengine::postprocess_setBypass);- emscripten::function("postprocess_isBypassed", &esengine::postprocess_isBypassed);emscripten::function("postprocess_clearPasses", &esengine::postprocess_clearPasses);- emscripten::function("postprocess_setOutputTarget", &esengine::postprocess_setOutputTarget);emscripten::function("postprocess_setOutputViewport", &esengine::postprocess_setOutputViewport);emscripten::function("postprocess_beginScreenCapture", &esengine::postprocess_beginScreenCapture);emscripten::function("postprocess_endScreenCapture", &esengine::postprocess_endScreenCapture);@@ -635,15 +620,10 @@ EMSCRIPTEN_BINDINGS(esengine_renderer) {emscripten::function("renderer_begin", &esengine::renderer_begin);emscripten::function("renderer_flush", &esengine::renderer_flush);emscripten::function("renderer_end", &esengine::renderer_end);- emscripten::function("renderer_submitSprites", &esengine::renderer_submitSprites);- emscripten::function("renderer_submitUIElements", &esengine::renderer_submitUIElements);#ifdef ES_ENABLE_BITMAP_TEXT- emscripten::function("renderer_submitBitmapText", &esengine::renderer_submitBitmapText);#endif- emscripten::function("renderer_submitShapes", &esengine::renderer_submitShapes);#ifdef ES_ENABLE_PARTICLES- emscripten::function("renderer_submitParticles", &esengine::renderer_submitParticles);#endifemscripten::function("renderer_updateTransforms", &esengine::renderer_updateTransforms);emscripten::function("renderer_setEntityDrawOrder", &esengine::renderer_setEntityDrawOrder);@@ -685,14 +665,7 @@ EMSCRIPTEN_BINDINGS(esengine_renderer) {emscripten::function("renderer_setDepthLayers", &esengine::renderer_setDepthLayers);emscripten::function("renderer_setCullingMask", &esengine::renderer_setCullingMask);emscripten::function("renderer_setColorSpace", &esengine::renderer_setColorSpace);- emscripten::function("renderer_setEntityClipRect", &esengine::renderer_setEntityClipRect);- emscripten::function("renderer_clearEntityClipRect", &esengine::renderer_clearEntityClipRect);- emscripten::function("renderer_clearAllClipRects", &esengine::renderer_clearAllClipRects);- emscripten::function("renderer_setEntityStencilMask", &esengine::renderer_setEntityStencilMask);- emscripten::function("renderer_setEntityStencilTest", &esengine::renderer_setEntityStencilTest);- emscripten::function("renderer_clearEntityStencilMask", &esengine::renderer_clearEntityStencilMask);- emscripten::function("renderer_clearAllStencilMasks", &esengine::renderer_clearAllStencilMasks);emscripten::function("registry_getCanvasEntity", &esengine::registry_getCanvasEntity);emscripten::function("registry_getCanvasEntities", &esengine::registry_getCanvasEntities);@@ -735,7 +708,6 @@ EMSCRIPTEN_BINDINGS(esengine_ui_systems) {emscripten::function("uiLayout_update", &esengine::uiLayout_update);emscripten::function("uiHitTest_update", &esengine::uiHitTest_update);emscripten::function("uiHitTest_getHitEntity", &esengine::uiHitTest_getHitEntity);- emscripten::function("uiHitTest_getHitEntityPrev", &esengine::uiHitTest_getHitEntityPrev);emscripten::function("uiHitTest_pick", &esengine::uiHitTest_pick);emscripten::function("uiHitTest_pickAll", &esengine::uiHitTest_pickAll);emscripten::function("uiHitTest_pickResult", &esengine::uiHitTest_pickResult);@@ -746,11 +718,9 @@ EMSCRIPTEN_BINDINGS(esengine_ui_systems) {emscripten::function("ui_getCullBit", &esengine::ui_getCullBit);emscripten::function("getUINodeHiddenInTree", &esengine::getUINodeHiddenInTree);emscripten::function("getUINodeAlphaInTree", &esengine::getUINodeAlphaInTree);- emscripten::function("getUINodePointerBlockedInTree", &esengine::getUINodePointerBlockedInTree);emscripten::function("getUINodeComputedWidth", &esengine::getUINodeComputedWidth);emscripten::function("getUINodeComputedHeight", &esengine::getUINodeComputedHeight);emscripten::function("transform_update", &esengine::transform_update);- emscripten::function("transform_patchPosition", &esengine::transform_patchPosition);// Tweens (AnimationBindings.hpp) — the same declarations the native// wrappers are generated from.diff --git a/src/esengine/renderer/frame/PostProcessPipeline.cpp b/src/esengine/renderer/frame/PostProcessPipeline.cppindex 77768098b..21d7bd0df 100644--- a/src/esengine/renderer/frame/PostProcessPipeline.cpp+++ b/src/esengine/renderer/frame/PostProcessPipeline.cpp@@ -203,31 +203,6 @@ void PostProcessPipeline::releasePassResources(PostProcessPass& pass) {}}-void PostProcessPipeline::removePass(const std::string& name) {- auto it = std::find_if(passes_.begin(), passes_.end(),- [&name](const PostProcessPass& p) { return p.name == name; });-- if (it != passes_.end()) {- releasePassResources(*it);- passes_.erase(it);- }-}--void PostProcessPipeline::setPassEnabled(const std::string& name, bool enabled) {- if (auto* pass = findPass(name)) {- pass->enabled = enabled;- }-}--bool PostProcessPipeline::isPassEnabled(const std::string& name) const {- for (const auto& pass : passes_) {- if (pass.name == name) {- return pass.enabled;- }- }- return false;-}-void PostProcessPipeline::setPassUniformFloat(const std::string& passName,const std::string& uniform, f32 value) {if (auto* pass = findPass(passName)) {diff --git a/src/esengine/renderer/frame/PostProcessPipeline.hpp b/src/esengine/renderer/frame/PostProcessPipeline.hppindex bb865074d..987573e1a 100644--- a/src/esengine/renderer/frame/PostProcessPipeline.hpp+++ b/src/esengine/renderer/frame/PostProcessPipeline.hpp@@ -99,20 +99,8 @@ public:*/u32 addPass(const std::string& name, resource::ShaderHandle shader);- /**- * @brief Removes a pass by name- */- void removePass(const std::string& name);- /**- * @brief Enables or disables a pass- */- void setPassEnabled(const std::string& name, bool enabled);- /**- * @brief Checks if a pass is enabled- */- bool isPassEnabled(const std::string& name) const;/*** @brief Sets a float uniform for a pass@@ -280,7 +268,7 @@ private:void runChain(std::vector<PostProcessPass>& passes, TextureHandle sceneTexture);/// The chain's last pass: the copy into the output target's viewport.void blitPass();- /// Frees a pass's GPU-side param UBO (removePass/clearPasses/shutdown).+ /// Frees a pass's GPU-side param UBO (clearPasses/shutdown).void releasePassResources(PostProcessPass& pass);GfxDevice& device_;diff --git a/src/esengine/renderer/frame/RenderFrame.cpp b/src/esengine/renderer/frame/RenderFrame.cppindex c7a74506b..ef3b14e00 100644--- a/src/esengine/renderer/frame/RenderFrame.cpp+++ b/src/esengine/renderer/frame/RenderFrame.cpp@@ -591,10 +591,6 @@ void RenderFrame::setEntityClipRect(u32 entity, i32 x, i32 y, i32 w, i32 h) {clip_rects_[entity] = ScissorRect{x, y, w, h};}-void RenderFrame::clearEntityClipRect(u32 entity) {- clip_rects_.erase(entity);-}-void RenderFrame::clearAllClipRects() {clip_rects_.clear();}@@ -607,10 +603,6 @@ void RenderFrame::setEntityStencilTest(u32 entity, i32 refValue) {stencil_masks_[entity] = {refValue, false};}-void RenderFrame::clearEntityStencilMask(u32 entity) {- stencil_masks_.erase(entity);-}-void RenderFrame::clearAllStencilMasks() {stencil_masks_.clear();}diff --git a/src/esengine/renderer/frame/RenderFrame.hpp b/src/esengine/renderer/frame/RenderFrame.hppindex 3db33189f..62b872c17 100644--- a/src/esengine/renderer/frame/RenderFrame.hpp+++ b/src/esengine/renderer/frame/RenderFrame.hpp@@ -142,12 +142,10 @@ public:void processMasks(ecs::Registry& registry, i32 vpX, i32 vpY, i32 vpW, i32 vpH);void setEntityClipRect(u32 entity, i32 x, i32 y, i32 w, i32 h);- void clearEntityClipRect(u32 entity);void clearAllClipRects();void setEntityStencilMask(u32 entity, i32 refValue);void setEntityStencilTest(u32 entity, i32 refValue);- void clearEntityStencilMask(u32 entity);void clearAllStencilMasks();void submitTileQuad(diff --git a/tools/check-engine-exports.mjs b/tools/check-engine-exports.mjsnew file mode 100644index 000000000..f8c2eb2f9--- /dev/null+++ b/tools/check-engine-exports.mjs@@ -0,0 +1,56 @@+#!/usr/bin/env node+// SPDX-License-Identifier: Apache-2.0+// SPDX-FileCopyrightText: Copyright (c) 2024-present ESEngine Team+/**+ * @file check-engine-exports.mjs+ * @brief Every entry point the engine offers a host must have a caller.+ * @details An export nobody calls is a capability that cannot be wrong, because+ * nothing exercises it — and it reads as one the engine supports. This+ * found five submit entry points whose bodies were `(void)registry;`.+ *+ * Run: node tools/check-engine-exports.mjs (exit 1 on an unreachable export)+ */+import { readFileSync } from 'node:fs';+import path from 'node:path';+import { fileURLToPath } from 'node:url';+import { listTrackedSources } from './lib/sourceRoots.mjs';++const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');+const ENTRY = 'src/esengine/bindings/WebSDKEntry.cpp';++const entry = readFileSync(path.join(ROOT, ENTRY), 'utf8');+const exported = [...entry.matchAll(/emscripten::function\("(\w+)"/g)].map((m) => m[1]);++// The pointer accessors are reached by NAME, out of the generated layout table —+// derived from it rather than listed here, so a new component cannot look dead.+const layouts = readFileSync(path.join(ROOT, 'sdk/src/wasm/ptrLayouts.generated.ts'), 'utf8');+const byName = new Set([...layouts.matchAll(/ptrFn:\s*'(\w+)'/g)].map((m) => m[1]));++// Tests count as callers here: what a binding does to a registry can only be+// read back through another binding. `wasm.ts` declares the surface rather than+// calling it, and generated files name every entry by construction.+const { files, missing } = listTrackedSources(+ ['sdk/src', 'sdk/tests', 'desktop/src', 'desktop/electron', 'desktop/tests', 'tools', 'pipeline/src']);+if (missing.length) {+ console.log(`check-engine-exports: no editor checkout — ${missing.join(', ')} not scanned for callers.`);+}+const texts = files+ .filter((f) => /\.(ts|tsx|mjs|js)$/.test(f) && !f.includes('.generated.') && f !== 'sdk/src/wasm.ts')+ .map((f) => readFileSync(path.join(ROOT, f), 'utf8'));++const unreachable = exported.filter((name) => {+ if (byName.has(name)) return false;+ const re = new RegExp(`\\b${name}\\b`);+ return !texts.some((t) => re.test(t));+});++if (unreachable.length > 0) {+ console.error(`${unreachable.length} engine export(s) no host calls:\n`);+ for (const n of unreachable) console.error(` ${n}`);+ console.error(`\nEither wire it up or drop it from ${ENTRY}: an export with no caller`+ + ' is a capability nothing can find wrong.');+ process.exit(1);+}++console.log(`check-engine-exports: ${exported.length} export(s), every one of them reachable`+ + ` (${byName.size} through the generated pointer table).`);diff --git a/tools/gates.mjs b/tools/gates.mjsindex 6805ef562..f18fc6d61 100644--- a/tools/gates.mjs+++ b/tools/gates.mjs@@ -32,6 +32,7 @@ export const GATES = [{ id: 'gl-boundary', run: 'node tools/check-gl-boundary.mjs' },{ id: 'draw-command-boundary', run: 'node tools/check-draw-command-boundary.mjs' },{ id: 'sidemodule-gates', run: 'node tools/check-sidemodule-gates.mjs' },+ { id: 'engine-exports', run: 'node tools/check-engine-exports.mjs' },{id: 'native-bindings',run: 'node tools/check-native-bindings.mjs',