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
fix(build): sdk builds run EHT first; cache key covers build config
yhh3ef4b080d688
diff --git a/build-tools/cli.js b/build-tools/cli.jsindex 6b8614015..9ca3a51ee 100644--- a/build-tools/cli.js+++ b/build-tools/cli.js@@ -63,8 +63,12 @@ programconst noCache = !options.cache;+ // EHT output feeds sdk/src (component.generated.ts, wasm.generated.ts)+ // as well as the wasm bindings, so an sdk-only build needs it too —+ // otherwise the SDK bundles stale generated sources after a header edit.+ await runEht({ noCache });+if (wasmTargets.length > 0) {- await runEht({ noCache });await buildWasmParallel(wasmTargets, {debug: isDebug,clean: options.clean,@@ -156,12 +160,17 @@ programprogram.command('sdk').description('Build SDK only')+ .option('--no-cache', 'Disable build cache').option('-v, --verbose', 'Verbose output', false).action(async (options) => {logger.setVerbose(options.verbose);try {- await buildSdk();+ const noCache = !options.cache;+ // Regenerate EHT outputs in sdk/src first, or the SDK bundles stale+ // generated sources after a C++ header edit.+ await runEht({ noCache });+ await buildSdk({ noCache });await syncToDesktop({ wasm: false, sdk: true });} catch (err) {handleBuildError(err, { verbose: options.verbose });diff --git a/build-tools/tasks/sdk.js b/build-tools/tasks/sdk.jsindex 5ca9b4480..fbc0b445f 100644--- a/build-tools/tasks/sdk.js+++ b/build-tools/tasks/sdk.js@@ -6,7 +6,7 @@ import { existsSync } from 'fs';import config from '../build.config.js';import * as logger from '../utils/logger.js';import { runCommand } from '../utils/emscripten.js';-import { hashDirectory, HashCache } from '../utils/hash.js';+import { hashDirectory, hashFiles, HashCache } from '../utils/hash.js';export async function buildSdk(options = {}) {const { manifest = null, noCache = false } = options;@@ -43,7 +43,11 @@ export async function buildSdk(options = {}) {await cache.load();const sdkSrcDir = path.join(sdkDir, 'src');- currentHash = await hashDirectory(sdkSrcDir, /\.ts$/);+ // The bundle is a function of the sources AND the build configuration,+ // so rollup/tsconfig/package edits must bust the cache too.+ const configFiles = ['rollup.config.js', 'tsconfig.json', 'package.json']+ .map((f) => path.join(sdkDir, f));+ currentHash = `${await hashDirectory(sdkSrcDir, /\.ts$/)}:${await hashFiles(configFiles)}`;// Skip only when the source is unchanged AND the artifacts are actually// present. Hashing the source alone wrongly reported "cached" after thediff --git a/sdk/wasm.generated.ts b/sdk/wasm.generated.tsdeleted file mode 100644index 93f22af1d..000000000--- a/sdk/wasm.generated.ts+++ /dev/null@@ -1,614 +0,0 @@-/**- * @file wasm.generated.ts- * @brief ESEngine WASM Bindings TypeScript Definitions- * @details Generated by EHT - DO NOT EDIT- */--import type { Entity, Vec2, Vec3, Vec4, Quat } from './types';--// Additional Math Types-export interface UVec2 { x: number; y: number; }-export interface Padding { left: number; top: number; right: number; bottom: number; }-export type Mat4 = number[];--// Emscripten Vector Types-export interface VectorEntity {- size(): number;- get(index: number): number;- push_back(value: number): void;- set(index: number, value: number): boolean;- delete(): void;-}--// Enums--export enum TextAlign {- Left = 0,- Center = 1,- Right = 2,-}--export enum ProjectionType {- Perspective = 0,- Orthographic = 1,-}--export enum ClearFlags {- Nothing = 0,- Color = 1,- Depth = 2,- ColorAndDepth = 3,-}--export enum CanvasScaleMode {- FixedWidth = 0,- FixedHeight = 1,- Expand = 2,- Shrink = 3,- Match = 4,-}--export enum FlexDirection {- Row = 0,- Column = 1,- RowReverse = 2,- ColumnReverse = 3,-}--export enum FlexWrap {- NoWrap = 0,- Wrap = 1,-}--export enum JustifyContent {- Start = 0,- Center = 1,- End = 2,- SpaceBetween = 3,- SpaceAround = 4,- SpaceEvenly = 5,-}--export enum AlignItems {- Start = 0,- Center = 1,- End = 2,- Stretch = 3,-}--export enum AlignContent {- Start = 0,- Center = 1,- End = 2,- Stretch = 3,- SpaceBetween = 4,- SpaceAround = 5,-}--export enum AlignSelf {- Auto = 0,- Start = 1,- Center = 2,- End = 3,- Stretch = 4,-}--export enum GridDirection {- Vertical = 0,- Horizontal = 1,-}--export enum EmitterShape {- Point = 0,- Circle = 1,- Rectangle = 2,- Cone = 3,-}--export enum SimulationSpace {- World = 0,- Local = 1,-}--export enum BodyType {- Static = 0,- Kinematic = 1,- Dynamic = 2,-}--export enum MaskMode {- Scissor = 0,- Stencil = 1,-}--export enum UIVisualType {- None = 0,- SolidColor = 1,- Image = 2,- NineSlice = 3,-}--// Components--export interface BitmapText {- text: string;- color: Vec4;- fontSize: number;- align: number;- spacing: number;- layer: number;- font: number;- enabled: boolean;-}--export interface Camera {- projectionType: number;- fov: number;- orthoSize: number;- nearPlane: number;- farPlane: number;- aspectRatio: number;- isActive: boolean;- priority: number;- viewport: Vec4;- clearFlags: number;-}--export interface Canvas {- designResolution: UVec2;- pixelsPerUnit: number;- scaleMode: number;- matchWidthOrHeight: number;- backgroundColor: Vec4;-}--export interface BoxCollider {- halfExtents: Vec2;- offset: Vec2;- density: number;- friction: number;- restitution: number;- isSensor: boolean;- enabled: boolean;- categoryBits: number;- maskBits: number;-}--export interface CircleCollider {- radius: number;- offset: Vec2;- density: number;- friction: number;- restitution: number;- isSensor: boolean;- enabled: boolean;- categoryBits: number;- maskBits: number;-}--export interface CapsuleCollider {- radius: number;- halfHeight: number;- offset: Vec2;- density: number;- friction: number;- restitution: number;- isSensor: boolean;- enabled: boolean;- categoryBits: number;- maskBits: number;-}--export interface SegmentCollider {- point1: Vec2;- point2: Vec2;- density: number;- friction: number;- restitution: number;- isSensor: boolean;- enabled: boolean;- categoryBits: number;- maskBits: number;-}--export interface FlexContainer {- direction: number;- wrap: number;- justifyContent: number;- alignItems: number;- alignContent: number;- gap: Vec2;- padding: Padding;-}--export interface FlexItem {- flexGrow: number;- flexShrink: number;- flexBasis: number;- order: number;- alignSelf: number;- margin: Padding;- minWidth: number;- minHeight: number;- maxWidth: number;- maxHeight: number;- widthPercent: number;- heightPercent: number;-}--export interface GridLayout {- direction: number;- crossAxisCount: number;- itemSize: Vec2;- spacing: Vec2;-}--export interface Parent {- entity: number;-}--export interface Children {- entities: VectorEntity;-}--export interface Interactable {- enabled: boolean;- blockRaycast: boolean;- raycastTarget: boolean;-}--export interface ParticleEmitter {- rate: number;- burstCount: number;- burstInterval: number;- duration: number;- looping: boolean;- playOnStart: boolean;- maxParticles: number;- lifetimeMin: number;- lifetimeMax: number;- shape: number;- shapeRadius: number;- shapeSize: Vec2;- shapeAngle: number;- speedMin: number;- speedMax: number;- angleSpreadMin: number;- angleSpreadMax: number;- startSizeMin: number;- startSizeMax: number;- endSizeMin: number;- endSizeMax: number;- sizeEasing: number;- startColor: Vec4;- endColor: Vec4;- colorEasing: number;- rotationMin: number;- rotationMax: number;- angularVelocityMin: number;- angularVelocityMax: number;- gravity: Vec2;- damping: number;- texture: number;- spriteColumns: number;- spriteRows: number;- spriteFPS: number;- spriteLoop: boolean;- blendMode: number;- layer: number;- material: number;- simulationSpace: number;- enabled: boolean;-}--export interface RigidBody {- bodyType: number;- gravityScale: number;- linearDamping: number;- angularDamping: number;- fixedRotation: boolean;- bullet: boolean;- enabled: boolean;-}--export interface ShapeRenderer {- shapeType: number;- color: Vec4;- size: Vec2;- cornerRadius: number;- layer: number;- enabled: boolean;-}--export interface SpineAnimation {- skeletonPath: string;- atlasPath: string;- skin: string;- animation: string;- timeScale: number;- loop: boolean;- playing: boolean;- flipX: boolean;- flipY: boolean;- color: Vec4;- layer: number;- skeletonScale: number;- material: number;- enabled: boolean;-}--export interface Sprite {- texture: number;- color: Vec4;- size: Vec2;- pivot: Vec2;- uvOffset: Vec2;- uvScale: Vec2;- layer: number;- flipX: boolean;- flipY: boolean;- tileSize: Vec2;- tileSpacing: Vec2;- material: number;- enabled: boolean;-}--export interface StateMachine {- current: string;- previous: string;-}--export interface StateVisuals {- targetGraphic: number;- transitionFlags: number;- fadeDuration: number;- slot0Name: string;- slot0Color: Vec4;- slot0Sprite: number;- slot0Scale: number;- slot1Name: string;- slot1Color: Vec4;- slot1Sprite: number;- slot1Scale: number;- slot2Name: string;- slot2Color: Vec4;- slot2Sprite: number;- slot2Scale: number;- slot3Name: string;- slot3Color: Vec4;- slot3Sprite: number;- slot3Scale: number;- slot4Name: string;- slot4Color: Vec4;- slot4Sprite: number;- slot4Scale: number;- slot5Name: string;- slot5Color: Vec4;- slot5Sprite: number;- slot5Scale: number;- slot6Name: string;- slot6Color: Vec4;- slot6Sprite: number;- slot6Scale: number;- slot7Name: string;- slot7Color: Vec4;- slot7Sprite: number;- slot7Scale: number;-}--export interface TilemapLayer {- cellSize: Vec2;- originOffset: Vec2;- tileset: number;- tilesetColumns: number;- tilesetRows: number;- renderLayer: number;- tintColor: Vec4;- opacity: number;- parallaxFactor: Vec2;- visible: boolean;-}--export interface Transform {- position: Vec3;- rotation: Quat;- scale: Vec3;- worldPosition: Vec3;- worldRotation: Quat;- worldScale: Vec3;-}--export interface UIInteraction {- hovered: boolean;- pressed: boolean;- justPressed: boolean;- justReleased: boolean;-}--export interface UIMask {- enabled: boolean;- mode: number;-}--export interface UIRect {- anchorMin: Vec2;- anchorMax: Vec2;- offsetMin: Vec2;- offsetMax: Vec2;- size: Vec2;- pivot: Vec2;-}--export interface UIRenderer {- visualType: number;- texture: number;- color: Vec4;- uvOffset: Vec2;- uvScale: Vec2;- sliceBorder: Vec4;- material: number;- enabled: boolean;-}--export interface Velocity {- linear: Vec3;- angular: Vec3;-}--// Registry-export interface Registry {- create(): Entity;- destroy(entity: Entity): void;- valid(entity: Entity): boolean;- entityCount(): number;-- hasBitmapText(entity: Entity): boolean;- getBitmapText(entity: Entity): BitmapText;- addBitmapText(entity: Entity, component: BitmapText): void;- removeBitmapText(entity: Entity): void;- hasCamera(entity: Entity): boolean;- getCamera(entity: Entity): Camera;- addCamera(entity: Entity, component: Camera): void;- removeCamera(entity: Entity): void;- hasCanvas(entity: Entity): boolean;- getCanvas(entity: Entity): Canvas;- addCanvas(entity: Entity, component: Canvas): void;- removeCanvas(entity: Entity): void;- hasBoxCollider(entity: Entity): boolean;- getBoxCollider(entity: Entity): BoxCollider;- addBoxCollider(entity: Entity, component: BoxCollider): void;- removeBoxCollider(entity: Entity): void;- hasCircleCollider(entity: Entity): boolean;- getCircleCollider(entity: Entity): CircleCollider;- addCircleCollider(entity: Entity, component: CircleCollider): void;- removeCircleCollider(entity: Entity): void;- hasCapsuleCollider(entity: Entity): boolean;- getCapsuleCollider(entity: Entity): CapsuleCollider;- addCapsuleCollider(entity: Entity, component: CapsuleCollider): void;- removeCapsuleCollider(entity: Entity): void;- hasSegmentCollider(entity: Entity): boolean;- getSegmentCollider(entity: Entity): SegmentCollider;- addSegmentCollider(entity: Entity, component: SegmentCollider): void;- removeSegmentCollider(entity: Entity): void;- hasFlexContainer(entity: Entity): boolean;- getFlexContainer(entity: Entity): FlexContainer;- addFlexContainer(entity: Entity, component: FlexContainer): void;- removeFlexContainer(entity: Entity): void;- hasFlexItem(entity: Entity): boolean;- getFlexItem(entity: Entity): FlexItem;- addFlexItem(entity: Entity, component: FlexItem): void;- removeFlexItem(entity: Entity): void;- hasGridLayout(entity: Entity): boolean;- getGridLayout(entity: Entity): GridLayout;- addGridLayout(entity: Entity, component: GridLayout): void;- removeGridLayout(entity: Entity): void;- hasParent(entity: Entity): boolean;- getParent(entity: Entity): Parent;- addParent(entity: Entity, component: Parent): void;- removeParent(entity: Entity): void;- hasChildren(entity: Entity): boolean;- getChildren(entity: Entity): Children;- addChildren(entity: Entity, component: Children): void;- removeChildren(entity: Entity): void;- hasInteractable(entity: Entity): boolean;- getInteractable(entity: Entity): Interactable;- addInteractable(entity: Entity, component: Interactable): void;- removeInteractable(entity: Entity): void;- hasParticleEmitter(entity: Entity): boolean;- getParticleEmitter(entity: Entity): ParticleEmitter;- addParticleEmitter(entity: Entity, component: ParticleEmitter): void;- removeParticleEmitter(entity: Entity): void;- hasRigidBody(entity: Entity): boolean;- getRigidBody(entity: Entity): RigidBody;- addRigidBody(entity: Entity, component: RigidBody): void;- removeRigidBody(entity: Entity): void;- hasShapeRenderer(entity: Entity): boolean;- getShapeRenderer(entity: Entity): ShapeRenderer;- addShapeRenderer(entity: Entity, component: ShapeRenderer): void;- removeShapeRenderer(entity: Entity): void;- hasSpineAnimation(entity: Entity): boolean;- getSpineAnimation(entity: Entity): SpineAnimation;- addSpineAnimation(entity: Entity, component: SpineAnimation): void;- removeSpineAnimation(entity: Entity): void;- hasSprite(entity: Entity): boolean;- getSprite(entity: Entity): Sprite;- addSprite(entity: Entity, component: Sprite): void;- removeSprite(entity: Entity): void;- hasStateMachine(entity: Entity): boolean;- getStateMachine(entity: Entity): StateMachine;- addStateMachine(entity: Entity, component: StateMachine): void;- removeStateMachine(entity: Entity): void;- hasStateVisuals(entity: Entity): boolean;- getStateVisuals(entity: Entity): StateVisuals;- addStateVisuals(entity: Entity, component: StateVisuals): void;- removeStateVisuals(entity: Entity): void;- hasTilemapLayer(entity: Entity): boolean;- getTilemapLayer(entity: Entity): TilemapLayer;- addTilemapLayer(entity: Entity, component: TilemapLayer): void;- removeTilemapLayer(entity: Entity): void;- hasTransform(entity: Entity): boolean;- getTransform(entity: Entity): Transform;- addTransform(entity: Entity, component: Transform): void;- removeTransform(entity: Entity): void;- hasUIInteraction(entity: Entity): boolean;- getUIInteraction(entity: Entity): UIInteraction;- addUIInteraction(entity: Entity, component: UIInteraction): void;- removeUIInteraction(entity: Entity): void;- hasUIMask(entity: Entity): boolean;- getUIMask(entity: Entity): UIMask;- addUIMask(entity: Entity, component: UIMask): void;- removeUIMask(entity: Entity): void;- hasUIRect(entity: Entity): boolean;- getUIRect(entity: Entity): UIRect;- addUIRect(entity: Entity, component: UIRect): void;- removeUIRect(entity: Entity): void;- hasUIRenderer(entity: Entity): boolean;- getUIRenderer(entity: Entity): UIRenderer;- addUIRenderer(entity: Entity, component: UIRenderer): void;- removeUIRenderer(entity: Entity): void;- hasVelocity(entity: Entity): boolean;- getVelocity(entity: Entity): Velocity;- addVelocity(entity: Entity, component: Velocity): void;- removeVelocity(entity: Entity): void;-- // Hierarchy Utilities- setParent(child: Entity, parent: Entity): void;-}--// Module-export interface ESEngineModule {- Registry: new () => Registry;- /**- * Authoritative list of component names this WASM build exposes- * on the Registry. Used by BuiltinBridge to detect drift between- * the shipped SDK and the actual WASM module.- */- getBuiltinComponentNames(): string[];- BitmapText: new () => BitmapText;- Camera: new () => Camera;- Canvas: new () => Canvas;- BoxCollider: new () => BoxCollider;- CircleCollider: new () => CircleCollider;- CapsuleCollider: new () => CapsuleCollider;- SegmentCollider: new () => SegmentCollider;- FlexContainer: new () => FlexContainer;- FlexItem: new () => FlexItem;- GridLayout: new () => GridLayout;- Parent: new () => Parent;- Children: new () => Children;- Interactable: new () => Interactable;- ParticleEmitter: new () => ParticleEmitter;- RigidBody: new () => RigidBody;- ShapeRenderer: new () => ShapeRenderer;- SpineAnimation: new () => SpineAnimation;- Sprite: new () => Sprite;- StateMachine: new () => StateMachine;- StateVisuals: new () => StateVisuals;- TilemapLayer: new () => TilemapLayer;- Transform: new () => Transform;- UIInteraction: new () => UIInteraction;- UIMask: new () => UIMask;- UIRect: new () => UIRect;- UIRenderer: new () => UIRenderer;- Velocity: new () => Velocity;-}