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: generate PTR_LAYOUTS from C++ struct layout and replace timeline magic numbers
esengine82e7d7465e12
diff --git a/sdk/src/ptrLayouts.generated.ts b/sdk/src/ptrLayouts.generated.tsnew file mode 100644index 000000000..fa6270e81--- /dev/null+++ b/sdk/src/ptrLayouts.generated.ts@@ -0,0 +1,347 @@+/**+ * @file ptrLayouts.generated.ts+ * @brief Auto-generated component pointer layouts+ * @details Generated by EHT - DO NOT EDIT+ */++type PtrFieldType = 'f32' | 'i32' | 'u32' | 'bool' | 'u8' | 'vec2' | 'vec3' | 'vec4' | 'quat' | 'color';++interface PtrFieldDesc {+ readonly name: string;+ readonly type: PtrFieldType;+ readonly offset: number;+}++export interface PtrLayout {+ readonly ptrFn: string;+ readonly fields: readonly PtrFieldDesc[];+}++export const PTR_LAYOUTS: Record<string, PtrLayout> = {+ UIRect: {+ ptrFn: 'getUIRectPtr',+ fields: [+ { name: 'anchorMin', type: 'vec2', offset: 0 },+ { name: 'anchorMax', type: 'vec2', offset: 8 },+ { name: 'offsetMin', type: 'vec2', offset: 16 },+ { name: 'offsetMax', type: 'vec2', offset: 24 },+ { name: 'size', type: 'vec2', offset: 32 },+ { name: 'pivot', type: 'vec2', offset: 40 },+ ],+ },+ FlexItem: {+ ptrFn: 'getFlexItemPtr',+ fields: [+ { name: 'flexGrow', type: 'f32', offset: 0 },+ { name: 'flexShrink', type: 'f32', offset: 4 },+ { name: 'flexBasis', type: 'f32', offset: 8 },+ { name: 'order', type: 'i32', offset: 12 },+ { name: 'alignSelf', type: 'u8', offset: 16 },+ { name: 'minWidth', type: 'f32', offset: 20 },+ { name: 'minHeight', type: 'f32', offset: 24 },+ { name: 'maxWidth', type: 'f32', offset: 28 },+ { name: 'maxHeight', type: 'f32', offset: 32 },+ { name: 'widthPercent', type: 'f32', offset: 36 },+ { name: 'heightPercent', type: 'f32', offset: 40 },+ ],+ },+ BoxCollider: {+ ptrFn: 'getBoxColliderPtr',+ fields: [+ { name: 'halfExtents', type: 'vec2', offset: 0 },+ { name: 'offset', type: 'vec2', offset: 8 },+ { name: 'density', type: 'f32', offset: 16 },+ { name: 'friction', type: 'f32', offset: 20 },+ { name: 'restitution', type: 'f32', offset: 24 },+ { name: 'isSensor', type: 'bool', offset: 28 },+ { name: 'enabled', type: 'bool', offset: 29 },+ { name: 'categoryBits', type: 'u32', offset: 32 },+ { name: 'maskBits', type: 'u32', offset: 36 },+ ],+ },+ CircleCollider: {+ ptrFn: 'getCircleColliderPtr',+ fields: [+ { name: 'radius', type: 'f32', offset: 0 },+ { name: 'offset', type: 'vec2', offset: 4 },+ { name: 'density', type: 'f32', offset: 12 },+ { name: 'friction', type: 'f32', offset: 16 },+ { name: 'restitution', type: 'f32', offset: 20 },+ { name: 'isSensor', type: 'bool', offset: 24 },+ { name: 'enabled', type: 'bool', offset: 25 },+ { name: 'categoryBits', type: 'u32', offset: 28 },+ { name: 'maskBits', type: 'u32', offset: 32 },+ ],+ },+ CapsuleCollider: {+ ptrFn: 'getCapsuleColliderPtr',+ fields: [+ { name: 'radius', type: 'f32', offset: 0 },+ { name: 'halfHeight', type: 'f32', offset: 4 },+ { name: 'offset', type: 'vec2', offset: 8 },+ { name: 'density', type: 'f32', offset: 16 },+ { name: 'friction', type: 'f32', offset: 20 },+ { name: 'restitution', type: 'f32', offset: 24 },+ { name: 'isSensor', type: 'bool', offset: 28 },+ { name: 'enabled', type: 'bool', offset: 29 },+ { name: 'categoryBits', type: 'u32', offset: 32 },+ { name: 'maskBits', type: 'u32', offset: 36 },+ ],+ },+ SegmentCollider: {+ ptrFn: 'getSegmentColliderPtr',+ fields: [+ { name: 'point1', type: 'vec2', offset: 0 },+ { name: 'point2', type: 'vec2', offset: 8 },+ { name: 'density', type: 'f32', offset: 16 },+ { name: 'friction', type: 'f32', offset: 20 },+ { name: 'restitution', type: 'f32', offset: 24 },+ { name: 'isSensor', type: 'bool', offset: 28 },+ { name: 'enabled', type: 'bool', offset: 29 },+ { name: 'categoryBits', type: 'u32', offset: 32 },+ { name: 'maskBits', type: 'u32', offset: 36 },+ ],+ },+ FanLayout: {+ ptrFn: 'getFanLayoutPtr',+ fields: [+ { name: 'radius', type: 'f32', offset: 0 },+ { name: 'maxSpreadAngle', type: 'f32', offset: 4 },+ { name: 'maxCardAngle', type: 'f32', offset: 8 },+ { name: 'tiltFactor', type: 'f32', offset: 12 },+ { name: 'cardSpacing', type: 'f32', offset: 16 },+ { name: 'direction', type: 'i32', offset: 20 },+ ],+ },+ ParticleEmitter: {+ ptrFn: 'getParticleEmitterPtr',+ fields: [+ { name: 'rate', type: 'f32', offset: 0 },+ { name: 'burstCount', type: 'i32', offset: 4 },+ { name: 'burstInterval', type: 'f32', offset: 8 },+ { name: 'duration', type: 'f32', offset: 12 },+ { name: 'looping', type: 'bool', offset: 16 },+ { name: 'playOnStart', type: 'bool', offset: 17 },+ { name: 'maxParticles', type: 'i32', offset: 20 },+ { name: 'lifetimeMin', type: 'f32', offset: 24 },+ { name: 'lifetimeMax', type: 'f32', offset: 28 },+ { name: 'shape', type: 'i32', offset: 32 },+ { name: 'shapeRadius', type: 'f32', offset: 36 },+ { name: 'shapeSize', type: 'vec2', offset: 40 },+ { name: 'shapeAngle', type: 'f32', offset: 48 },+ { name: 'speedMin', type: 'f32', offset: 52 },+ { name: 'speedMax', type: 'f32', offset: 56 },+ { name: 'angleSpreadMin', type: 'f32', offset: 60 },+ { name: 'angleSpreadMax', type: 'f32', offset: 64 },+ { name: 'startSizeMin', type: 'f32', offset: 68 },+ { name: 'startSizeMax', type: 'f32', offset: 72 },+ { name: 'endSizeMin', type: 'f32', offset: 76 },+ { name: 'endSizeMax', type: 'f32', offset: 80 },+ { name: 'sizeEasing', type: 'i32', offset: 84 },+ { name: 'startColor', type: 'color', offset: 88 },+ { name: 'endColor', type: 'color', offset: 104 },+ { name: 'colorEasing', type: 'i32', offset: 120 },+ { name: 'rotationMin', type: 'f32', offset: 124 },+ { name: 'rotationMax', type: 'f32', offset: 128 },+ { name: 'angularVelocityMin', type: 'f32', offset: 132 },+ { name: 'angularVelocityMax', type: 'f32', offset: 136 },+ { name: 'gravity', type: 'vec2', offset: 140 },+ { name: 'damping', type: 'f32', offset: 148 },+ { name: 'texture', type: 'u32', offset: 152 },+ { name: 'spriteColumns', type: 'i32', offset: 156 },+ { name: 'spriteRows', type: 'i32', offset: 160 },+ { name: 'spriteFPS', type: 'f32', offset: 164 },+ { name: 'spriteLoop', type: 'bool', offset: 168 },+ { name: 'blendMode', type: 'i32', offset: 172 },+ { name: 'layer', type: 'i32', offset: 176 },+ { name: 'material', type: 'u32', offset: 180 },+ { name: 'simulationSpace', type: 'i32', offset: 184 },+ { name: 'enabled', type: 'bool', offset: 188 },+ ],+ },+ Transform: {+ ptrFn: 'getTransformPtr',+ fields: [+ { name: 'position', type: 'vec3', offset: 0 },+ { name: 'rotation', type: 'quat', offset: 12 },+ { name: 'scale', type: 'vec3', offset: 28 },+ { name: 'worldPosition', type: 'vec3', offset: 40 },+ { name: 'worldRotation', type: 'quat', offset: 52 },+ { name: 'worldScale', type: 'vec3', offset: 68 },+ ],+ },+ UIRenderer: {+ ptrFn: 'getUIRendererPtr',+ fields: [+ { name: 'visualType', type: 'u8', offset: 0 },+ { name: 'texture', type: 'u32', offset: 4 },+ { name: 'color', type: 'color', offset: 8 },+ { name: 'uvOffset', type: 'vec2', offset: 24 },+ { name: 'uvScale', type: 'vec2', offset: 32 },+ { name: 'sliceBorder', type: 'vec4', offset: 40 },+ { name: 'material', type: 'u32', offset: 56 },+ { name: 'enabled', type: 'bool', offset: 60 },+ ],+ },+ GridLayout: {+ ptrFn: 'getGridLayoutPtr',+ fields: [+ { name: 'direction', type: 'i32', offset: 0 },+ { name: 'crossAxisCount', type: 'i32', offset: 4 },+ { name: 'itemSize', type: 'vec2', offset: 8 },+ { name: 'spacing', type: 'vec2', offset: 16 },+ ],+ },+ Velocity: {+ ptrFn: 'getVelocityPtr',+ fields: [+ { name: 'linear', type: 'vec3', offset: 0 },+ { name: 'angular', type: 'vec3', offset: 12 },+ ],+ },+ SpineAnimation: {+ ptrFn: 'getSpineAnimationPtr',+ fields: [+ { name: 'timeScale', type: 'f32', offset: 0 },+ { name: 'loop', type: 'bool', offset: 4 },+ { name: 'playing', type: 'bool', offset: 5 },+ { name: 'flipX', type: 'bool', offset: 6 },+ { name: 'flipY', type: 'bool', offset: 7 },+ { name: 'color', type: 'color', offset: 8 },+ { name: 'layer', type: 'i32', offset: 24 },+ { name: 'skeletonScale', type: 'f32', offset: 28 },+ { name: 'material', type: 'u32', offset: 32 },+ { name: 'enabled', type: 'bool', offset: 36 },+ ],+ },+ Interactable: {+ ptrFn: 'getInteractablePtr',+ fields: [+ { name: 'enabled', type: 'bool', offset: 0 },+ { name: 'blockRaycast', type: 'bool', offset: 1 },+ { name: 'raycastTarget', type: 'bool', offset: 2 },+ ],+ },+ UIInteraction: {+ ptrFn: 'getUIInteractionPtr',+ fields: [+ { name: 'hovered', type: 'bool', offset: 0 },+ { name: 'pressed', type: 'bool', offset: 1 },+ { name: 'justPressed', type: 'bool', offset: 2 },+ { name: 'justReleased', type: 'bool', offset: 3 },+ ],+ },+ RigidBody: {+ ptrFn: 'getRigidBodyPtr',+ fields: [+ { name: 'bodyType', type: 'u8', offset: 0 },+ { name: 'gravityScale', type: 'f32', offset: 4 },+ { name: 'linearDamping', type: 'f32', offset: 8 },+ { name: 'angularDamping', type: 'f32', offset: 12 },+ { name: 'fixedRotation', type: 'bool', offset: 16 },+ { name: 'bullet', type: 'bool', offset: 17 },+ { name: 'enabled', type: 'bool', offset: 18 },+ ],+ },+ BitmapText: {+ ptrFn: 'getBitmapTextPtr',+ fields: [+ { name: 'color', type: 'color', offset: 0 },+ { name: 'fontSize', type: 'f32', offset: 16 },+ { name: 'align', type: 'u8', offset: 20 },+ { name: 'spacing', type: 'f32', offset: 24 },+ { name: 'layer', type: 'i32', offset: 28 },+ { name: 'font', type: 'u32', offset: 32 },+ { name: 'enabled', type: 'bool', offset: 36 },+ ],+ },+ Sprite: {+ ptrFn: 'getSpritePtr',+ fields: [+ { name: 'texture', type: 'u32', offset: 0 },+ { name: 'color', type: 'color', offset: 4 },+ { name: 'size', type: 'vec2', offset: 20 },+ { name: 'pivot', type: 'vec2', offset: 28 },+ { name: 'uvOffset', type: 'vec2', offset: 36 },+ { name: 'uvScale', type: 'vec2', offset: 44 },+ { name: 'layer', type: 'i32', offset: 52 },+ { name: 'flipX', type: 'bool', offset: 56 },+ { name: 'flipY', type: 'bool', offset: 57 },+ { name: 'material', type: 'u32', offset: 60 },+ { name: 'enabled', type: 'bool', offset: 64 },+ ],+ },+ UIMask: {+ ptrFn: 'getUIMaskPtr',+ fields: [+ { name: 'enabled', type: 'bool', offset: 0 },+ { name: 'mode', type: 'u8', offset: 1 },+ ],+ },+ FlexContainer: {+ ptrFn: 'getFlexContainerPtr',+ fields: [+ { name: 'direction', type: 'u8', offset: 0 },+ { name: 'wrap', type: 'u8', offset: 1 },+ { name: 'justifyContent', type: 'u8', offset: 2 },+ { name: 'alignItems', type: 'u8', offset: 3 },+ { name: 'alignContent', type: 'u8', offset: 4 },+ { name: 'gap', type: 'vec2', offset: 8 },+ ],+ },+ ShapeRenderer: {+ ptrFn: 'getShapeRendererPtr',+ fields: [+ { name: 'shapeType', type: 'u8', offset: 0 },+ { name: 'color', type: 'color', offset: 4 },+ { name: 'size', type: 'vec2', offset: 20 },+ { name: 'cornerRadius', type: 'f32', offset: 28 },+ { name: 'layer', type: 'i32', offset: 32 },+ { name: 'enabled', type: 'bool', offset: 36 },+ ],+ },+ Selectable: {+ ptrFn: 'getSelectablePtr',+ fields: [+ { name: 'selected', type: 'bool', offset: 0 },+ { name: 'group', type: 'i32', offset: 4 },+ ],+ },+ LayoutGroup: {+ ptrFn: 'getLayoutGroupPtr',+ fields: [+ { name: 'direction', type: 'u8', offset: 0 },+ { name: 'spacing', type: 'f32', offset: 4 },+ { name: 'childAlignment', type: 'u8', offset: 8 },+ { name: 'reverseOrder', type: 'bool', offset: 9 },+ ],+ },+ Canvas: {+ ptrFn: 'getCanvasPtr',+ fields: [+ { name: 'designResolution', type: 'vec2', offset: 0 },+ { name: 'pixelsPerUnit', type: 'f32', offset: 8 },+ { name: 'scaleMode', type: 'u8', offset: 12 },+ { name: 'matchWidthOrHeight', type: 'f32', offset: 16 },+ { name: 'backgroundColor', type: 'color', offset: 20 },+ ],+ },+ Camera: {+ ptrFn: 'getCameraPtr',+ fields: [+ { name: 'projectionType', type: 'u8', offset: 0 },+ { name: 'fov', type: 'f32', offset: 4 },+ { name: 'orthoSize', type: 'f32', offset: 8 },+ { name: 'nearPlane', type: 'f32', offset: 12 },+ { name: 'farPlane', type: 'f32', offset: 16 },+ { name: 'aspectRatio', type: 'f32', offset: 20 },+ { name: 'isActive', type: 'bool', offset: 24 },+ { name: 'priority', type: 'i32', offset: 28 },+ { name: 'viewportX', type: 'f32', offset: 32 },+ { name: 'viewportY', type: 'f32', offset: 36 },+ { name: 'viewportW', type: 'f32', offset: 40 },+ { name: 'viewportH', type: 'f32', offset: 44 },+ { name: 'clearFlags', type: 'i32', offset: 48 },+ ],+ },+};diff --git a/sdk/src/timeline/TimelineRuntime.ts b/sdk/src/timeline/TimelineRuntime.tsindex 368f562eb..52c6d326d 100644--- a/sdk/src/timeline/TimelineRuntime.ts+++ b/sdk/src/timeline/TimelineRuntime.ts@@ -6,6 +6,14 @@ import type { TimelineAsset } from './TimelineTypes';import type { ESEngineModule } from '../wasm';import type { Entity } from '../types';+const TimelineEventType = {+ SpinePlay: 0,+ SpineStop: 1,+ SpriteAnimPlay: 2,+ AudioPlay: 3,+ ActivationSet: 4,+} as const;+export function setNestedProperty(obj: Record<string, any>, path: string, value: number): boolean {const parts = path.split('.');let target = obj;@@ -100,7 +108,7 @@ export function processTimelineEvents(world: any, module: ESEngineModule): voidconst entity = module._tl_getEventEntity(i);switch (type) {- case 0: { // SpinePlay+ case TimelineEventType.SpinePlay: {const animName = decodeEventString(module, i);const loop = module._tl_getEventIntParam(i) !== 0;if (world.has(entity, SpineAnimation)) {@@ -112,7 +120,7 @@ export function processTimelineEvents(world: any, module: ESEngineModule): void}break;}- case 1: { // SpineStop+ case TimelineEventType.SpineStop: {if (world.has(entity, SpineAnimation)) {const current = world.get(entity, SpineAnimation);current.playing = false;@@ -120,7 +128,7 @@ export function processTimelineEvents(world: any, module: ESEngineModule): void}break;}- case 2: { // SpriteAnimPlay+ case TimelineEventType.SpriteAnimPlay: {const clipName = decodeEventString(module, i);if (world.has(entity, SpriteAnimator)) {const current = world.get(entity, SpriteAnimator);@@ -132,7 +140,7 @@ export function processTimelineEvents(world: any, module: ESEngineModule): void}break;}- case 3: { // AudioPlay+ case TimelineEventType.AudioPlay: {const clipPath = decodeEventString(module, i);const volume = module._tl_getEventFloatParam(i);if (clipPath) {@@ -140,7 +148,7 @@ export function processTimelineEvents(world: any, module: ESEngineModule): void}break;}- case 4: { // ActivationSet+ case TimelineEventType.ActivationSet: {const active = module._tl_getEventIntParam(i) !== 0;if (world.has(entity, SpineAnimation)) {const current = world.get(entity, SpineAnimation);diff --git a/sdk/src/world.ts b/sdk/src/world.tsindex be29985b1..f8b5d2331 100644--- a/sdk/src/world.ts+++ b/sdk/src/world.ts@@ -43,7 +43,10 @@ function convertForWasm(// Pointer-based Field Layout Descriptors// =============================================================================-type PtrFieldType = 'f32' | 'i32' | 'u32' | 'bool' | 'u8' | 'vec2' | 'vec3' | 'quat' | 'color';+import { PTR_LAYOUTS, type PtrLayout } from './ptrLayouts.generated';+export { PTR_LAYOUTS };++type PtrFieldType = 'f32' | 'i32' | 'u32' | 'bool' | 'u8' | 'vec2' | 'vec3' | 'vec4' | 'quat' | 'color';interface PtrFieldDesc {readonly name: string;@@ -51,116 +54,6 @@ interface PtrFieldDesc {readonly offset: number;}-interface PtrLayout {- readonly ptrFn: string;- readonly fields: readonly PtrFieldDesc[];-}--const PTR_LAYOUTS: Record<string, PtrLayout> = {- Transform: {- ptrFn: 'getTransformPtr',- fields: [- { name: 'position', type: 'vec3', offset: 0 },- { name: 'rotation', type: 'quat', offset: 12 },- { name: 'scale', type: 'vec3', offset: 28 },- { name: 'worldPosition', type: 'vec3', offset: 40 },- { name: 'worldRotation', type: 'quat', offset: 52 },- { name: 'worldScale', type: 'vec3', offset: 68 },- ],- },- Sprite: {- ptrFn: 'getSpritePtr',- fields: [- { name: 'texture', type: 'u32', offset: 0 },- { name: 'color', type: 'color', offset: 4 },- { name: 'size', type: 'vec2', offset: 20 },- { name: 'uvOffset', type: 'vec2', offset: 28 },- { name: 'uvScale', type: 'vec2', offset: 36 },- { name: 'layer', type: 'i32', offset: 44 },- { name: 'flipX', type: 'bool', offset: 48 },- { name: 'flipY', type: 'bool', offset: 49 },- { name: 'material', type: 'u32', offset: 52 },- { name: 'enabled', type: 'bool', offset: 56 },- ],- },- Velocity: {- ptrFn: 'getVelocityPtr',- fields: [- { name: 'linear', type: 'vec3', offset: 0 },- { name: 'angular', type: 'vec3', offset: 12 },- ],- },- Camera: {- ptrFn: 'getCameraPtr',- fields: [- { name: 'projectionType', type: 'u8', offset: 0 },- { name: 'fov', type: 'f32', offset: 4 },- { name: 'orthoSize', type: 'f32', offset: 8 },- { name: 'nearPlane', type: 'f32', offset: 12 },- { name: 'farPlane', type: 'f32', offset: 16 },- { name: 'aspectRatio', type: 'f32', offset: 20 },- { name: 'isActive', type: 'bool', offset: 24 },- { name: 'priority', type: 'i32', offset: 28 },- { name: 'viewportX', type: 'f32', offset: 32 },- { name: 'viewportY', type: 'f32', offset: 36 },- { name: 'viewportW', type: 'f32', offset: 40 },- { name: 'viewportH', type: 'f32', offset: 44 },- { name: 'clearFlags', type: 'i32', offset: 48 },- ],- },- UIRect: {- ptrFn: 'getUIRectPtr',- fields: [- { name: 'anchorMin', type: 'vec2', offset: 0 },- { name: 'anchorMax', type: 'vec2', offset: 8 },- { name: 'offsetMin', type: 'vec2', offset: 16 },- { name: 'offsetMax', type: 'vec2', offset: 24 },- { name: 'size', type: 'vec2', offset: 32 },- { name: 'pivot', type: 'vec2', offset: 40 },- ],- },- RigidBody: {- ptrFn: 'getRigidBodyPtr',- fields: [- { name: 'bodyType', type: 'u8', offset: 0 },- { name: 'gravityScale', type: 'f32', offset: 4 },- { name: 'linearDamping', type: 'f32', offset: 8 },- { name: 'angularDamping', type: 'f32', offset: 12 },- { name: 'fixedRotation', type: 'bool', offset: 16 },- { name: 'bullet', type: 'bool', offset: 17 },- { name: 'enabled', type: 'bool', offset: 18 },- ],- },- BoxCollider: {- ptrFn: 'getBoxColliderPtr',- fields: [- { name: 'halfExtents', type: 'vec2', offset: 0 },- { name: 'offset', type: 'vec2', offset: 8 },- { name: 'density', type: 'f32', offset: 16 },- { name: 'friction', type: 'f32', offset: 20 },- { name: 'restitution', type: 'f32', offset: 24 },- { name: 'isSensor', type: 'bool', offset: 28 },- { name: 'enabled', type: 'bool', offset: 29 },- { name: 'categoryBits', type: 'u32', offset: 32 },- { name: 'maskBits', type: 'u32', offset: 36 },- ],- },- CircleCollider: {- ptrFn: 'getCircleColliderPtr',- fields: [- { name: 'radius', type: 'f32', offset: 0 },- { name: 'offset', type: 'vec2', offset: 4 },- { name: 'density', type: 'f32', offset: 12 },- { name: 'friction', type: 'f32', offset: 16 },- { name: 'restitution', type: 'f32', offset: 20 },- { name: 'isSensor', type: 'bool', offset: 24 },- { name: 'enabled', type: 'bool', offset: 25 },- { name: 'categoryBits', type: 'u32', offset: 28 },- { name: 'maskBits', type: 'u32', offset: 32 },- ],- },-};-function readPtrField(f32: Float32Array, u32: Uint32Array, u8: Uint8Array,ptr: number, field: PtrFieldDesc,@@ -175,6 +68,7 @@ function readPtrField(case 'u8': return u8[byteOff];case 'vec2': return { x: f32[idx], y: f32[idx + 1] };case 'vec3': return { x: f32[idx], y: f32[idx + 1], z: f32[idx + 2] };+ case 'vec4':case 'quat': return { x: f32[idx], y: f32[idx + 1], z: f32[idx + 2], w: f32[idx + 3] };case 'color': return { r: f32[idx], g: f32[idx + 1], b: f32[idx + 2], a: f32[idx + 3] };}@@ -204,6 +98,7 @@ function fillPtrFields(v.x = f32[idx]; v.y = f32[idx + 1]; v.z = f32[idx + 2];break;}+ case 'vec4':case 'quat': {const v = target[field.name] as any;v.x = f32[idx]; v.y = f32[idx + 1]; v.z = f32[idx + 2]; v.w = f32[idx + 3];@@ -224,6 +119,7 @@ function createPreallocatedResult(fields: readonly PtrFieldDesc[]): Record<strinswitch (f.type) {case 'vec2': obj[f.name] = { x: 0, y: 0 }; break;case 'vec3': obj[f.name] = { x: 0, y: 0, z: 0 }; break;+ case 'vec4':case 'quat': obj[f.name] = { x: 0, y: 0, z: 0, w: 0 }; break;case 'color': obj[f.name] = { r: 0, g: 0, b: 0, a: 0 }; break;default: obj[f.name] = null; break;@@ -246,6 +142,7 @@ function writePtrField(case 'u8': u8[byteOff] = value; break;case 'vec2': f32[idx] = value.x; f32[idx + 1] = value.y; break;case 'vec3': f32[idx] = value.x; f32[idx + 1] = value.y; f32[idx + 2] = value.z; break;+ case 'vec4':case 'quat': f32[idx] = value.x; f32[idx + 1] = value.y; f32[idx + 2] = value.z; f32[idx + 3] = value.w; break;case 'color': f32[idx] = value.r; f32[idx + 1] = value.g; f32[idx + 2] = value.b; f32[idx + 3] = value.a; break;}diff --git a/tools/eht.py b/tools/eht.pyindex 4bb17c017..2abd7f514 100644--- a/tools/eht.py+++ b/tools/eht.py@@ -1131,6 +1131,145 @@ class AnimTargetGenerator:return '\n'.join(lines)+class PtrLayoutGenerator:+ """Generates ptrLayouts.generated.ts with computed struct field offsets."""++ TYPE_SIZES = {+ 'bool': 1, 'u8': 1, 'i8': 1,+ 'u16': 2, 'i16': 2,+ 'f32': 4, 'i32': 4, 'u32': 4, 'float': 4, 'int': 4, 'unsigned': 4,+ 'f64': 8, 'i64': 8, 'u64': 8, 'double': 8,+ 'glm::vec2': 8, 'glm::uvec2': 8,+ 'glm::vec3': 12,+ 'glm::vec4': 16, 'glm::quat': 16,+ 'Padding': 16,+ }++ TYPE_ALIGNS = {+ 'bool': 1, 'u8': 1, 'i8': 1,+ 'u16': 2, 'i16': 2,+ 'f32': 4, 'i32': 4, 'u32': 4, 'float': 4, 'int': 4, 'unsigned': 4,+ 'f64': 4, 'i64': 4, 'u64': 4, 'double': 4,+ 'glm::vec2': 4, 'glm::uvec2': 4,+ 'glm::vec3': 4,+ 'glm::vec4': 4, 'glm::quat': 4,+ 'Padding': 4,+ }++ CPP_TO_PTR_TYPE = {+ 'bool': 'bool', 'u8': 'u8', 'i8': 'u8',+ 'f32': 'f32', 'float': 'f32',+ 'i32': 'i32', 'int': 'i32',+ 'u32': 'u32', 'unsigned': 'u32',+ 'glm::vec2': 'vec2', 'glm::uvec2': 'vec2',+ 'glm::vec3': 'vec3',+ 'glm::vec4': 'color', 'glm::quat': 'quat',+ }++ def __init__(self, components: List[Component], enums: List[Enum]):+ self.components = components+ self.types = TypeSystem(enums)+ self.layouts: List[Dict] = []+ self._compute()++ def _get_size(self, cpp_type: str) -> Optional[int]:+ t = self.types.clean_type(cpp_type)+ if t in self.TYPE_SIZES:+ return self.TYPE_SIZES[t]+ if self.types.is_handle(t):+ return 4+ if self.types.is_enum(t):+ return 1+ return None++ def _get_align(self, cpp_type: str) -> int:+ t = self.types.clean_type(cpp_type)+ if t in self.TYPE_ALIGNS:+ return self.TYPE_ALIGNS[t]+ if self.types.is_handle(t) or self.types.is_enum(t):+ return 4 if self.types.is_handle(t) else 1+ return 4++ def _get_ptr_type(self, cpp_type: str, prop: Property) -> Optional[str]:+ t = self.types.clean_type(cpp_type)+ if t in self.CPP_TO_PTR_TYPE:+ if t == 'glm::vec4':+ is_color = any(pat in prop.name for pat in MetadataGenerator.COLOR_FIELD_PATTERNS)+ return 'color' if is_color else 'vec4'+ return self.CPP_TO_PTR_TYPE[t]+ if self.types.is_handle(t):+ return 'u32'+ if self.types.is_enum(t):+ return 'u8'+ return None++ def _compute(self):+ for comp in self.components:+ fields = []+ offset = 0+ for prop in comp.properties:+ size = self._get_size(prop.cpp_type)+ if size is None:+ continue+ ptr_type = self._get_ptr_type(prop.cpp_type, prop)+ if ptr_type is None:+ continue++ align = self._get_align(prop.cpp_type)+ if offset % align != 0:+ offset += align - (offset % align)++ fields.append({+ 'name': prop.name,+ 'type': ptr_type,+ 'offset': offset,+ })+ offset += size++ if fields:+ self.layouts.append({+ 'name': comp.name,+ 'ptrFn': f'get{comp.name}Ptr',+ 'fields': fields,+ })++ def generate(self) -> str:+ lines = [+ '/**',+ ' * @file ptrLayouts.generated.ts',+ ' * @brief Auto-generated component pointer layouts',+ ' * @details Generated by EHT - DO NOT EDIT',+ ' */',+ '',+ "type PtrFieldType = 'f32' | 'i32' | 'u32' | 'bool' | 'u8' | 'vec2' | 'vec3' | 'vec4' | 'quat' | 'color';",+ '',+ 'interface PtrFieldDesc {',+ ' readonly name: string;',+ ' readonly type: PtrFieldType;',+ ' readonly offset: number;',+ '}',+ '',+ 'export interface PtrLayout {',+ ' readonly ptrFn: string;',+ ' readonly fields: readonly PtrFieldDesc[];',+ '}',+ '',+ 'export const PTR_LAYOUTS: Record<string, PtrLayout> = {',+ ]++ for layout in self.layouts:+ lines.append(f' {layout["name"]}: {{')+ lines.append(f" ptrFn: '{layout['ptrFn']}',")+ lines.append(' fields: [')+ for f in layout['fields']:+ lines.append(f" {{ name: '{f['name']}', type: '{f['type']}', offset: {f['offset']} }},")+ lines.append(' ],')+ lines.append(' },')++ lines.extend(['};', ''])+ return '\n'.join(lines)++def main():parser = argparse.ArgumentParser(description='EHT - ESEngine Header Tool')parser.add_argument('--input', '-i', type=Path, nargs='+',@@ -1199,6 +1338,12 @@ def main():print(f"Generating: {anim_ts_path}")anim_ts_path.write_text(anim_gen.generate_ts(), encoding='utf-8')+ ptr_gen = PtrLayoutGenerator(cpp_parser.components, cpp_parser.enums)+ ptr_path = args.ts_output / 'src' / 'ptrLayouts.generated.ts'+ if ptr_path.parent.exists():+ print(f"Generating: {ptr_path}")+ ptr_path.write_text(ptr_gen.generate(), encoding='utf-8')+print("[OK] Done!")return 0