Skip to content

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.

fix(build): sdk builds run EHT first; cache key covers build config

yhh3ef4b080d688
diff --git a/build-tools/cli.js b/build-tools/cli.js
index 6b8614015..9ca3a51ee 100644
--- a/build-tools/cli.js
+++ b/build-tools/cli.js
@@ -63,8 +63,12 @@ program
const 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 @@ program
program
.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.js
index 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 the
diff --git a/sdk/wasm.generated.ts b/sdk/wasm.generated.ts
deleted file mode 100644
index 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;
-}