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
import { describe, expect, it, vi } from 'vitest';
import { World } from '../src/ecs/world';
import { AppContext, getDefaultContext, setDefaultContext } from '../src/ecs/context';
import { defineComponent, getUserComponents, unregisterComponent } from '../src/ecs/component';
function isolated(run: (context: AppContext, world: World) => void) {
const previous = getDefaultContext(), context = new AppContext();
setDefaultContext(context);
try { run(context, new World()); }
finally { setDefaultContext(previous); }
}
describe('group component inspection', () => {
it('matches scalar ordering and builds the script index once for a large group', () => isolated((_context, world) => {
for (let i = 0; i < 200; i++) defineComponent('Unused' + i, { value: 0 });
const a = defineComponent('GroupFirst', { value: 1 }), b = defineComponent('GroupSecond', { value: 2 });
const entities = Array.from({ length: 100 }, () => world.spawn());
for (const entity of entities) { world.insert(entity, b); world.insert(entity, a); }
const input = [entities[1], entities[0], ...entities];
const expected = input.map(entity => world.getComponentTypes(entity));
const iterator = vi.spyOn(getUserComponents(), Symbol.iterator);
expect(world.getComponentTypesBatch(input)).toEqual(expected);
expect(iterator).toHaveBeenCalledTimes(1);
iterator.mockRestore();
world.remove(entities[0], b);
expect(world.getComponentTypesBatch(input)).toEqual(input.map(entity => world.getComponentTypes(entity)));
world.despawn(entities[1]);
expect(world.getComponentTypesBatch(input)).toEqual(input.map(entity => world.getComponentTypes(entity)));
expect(world.getComponentTypesBatch([])).toEqual([]);
}));
it('follows aliases, same-size catalogue edits and replacement registrations', () => isolated((context, world) => {
const component = defineComponent('Original', { value: 1 }), entity = world.spawn();
world.insert(entity, component);
context.componentRegistry.set('Alias', component);
expect(world.getComponentTypesBatch([entity])).toEqual([['Original']]);
unregisterComponent('Original');
expect(world.getComponentTypesBatch([entity])).toEqual([world.getComponentTypes(entity)]);
expect(world.getComponentTypesBatch([entity])).toEqual([['Alias']]);
context.componentRegistry.delete('Alias');
context.componentRegistry.set('Renamed', component);
expect(world.getComponentTypesBatch([entity])).toEqual([['Renamed']]);
context.componentRegistry.clear();
const replacement = defineComponent('Renamed', { value: 2 });
expect(world.getComponentTypesBatch([entity])).toEqual([[]]);
world.insert(entity, replacement);
expect(world.getComponentTypesBatch([entity])).toEqual([world.getComponentTypes(entity)]);
expect(world.getComponentTypesBatch([entity])).toEqual([['Renamed']]);
}));
it('uses the current context on every group read', () => isolated((_context, world) => {
const component = defineComponent('ContextComponent', { value: 0 }), entity = world.spawn();
world.insert(entity, component);
expect(world.getComponentTypesBatch([entity])).toEqual([['ContextComponent']]);
const previous = getDefaultContext();
setDefaultContext(new AppContext());
try {
expect(world.getComponentTypesBatch([entity])).toEqual([[]]);
defineComponent('DifferentContextComponent', { value: 0 });
expect(world.getComponentTypesBatch([entity])).toEqual([[]]);
defineComponent('ContextComponent', { value: 0 });
expect(world.getComponentTypesBatch([entity])).toEqual([world.getComponentTypes(entity)]);
expect(world.getComponentTypesBatch([entity])).toEqual([['ContextComponent']]);
} finally { setDefaultContext(previous); }
expect(world.getComponentTypesBatch([entity])).toEqual([['ContextComponent']]);
}));
});