archetype-ecs 1.4.2 → 1.5.0

package/dist/WasmArena.js

@@ -0,0 +1,48 @@
+const ALIGN = 16; // 16-byte alignment for SIMD
+export class WasmArena {
+    memory;
+    nextOffset = 0;
+    views = [];
+    constructor(initialPages = 2048, maxPages = 16384) {
+        this.memory = new WebAssembly.Memory({ initial: initialPages, maximum: maxPages });
+    }
+    alloc(byteLength) {
+        // Align up to 16 bytes
+        const aligned = (this.nextOffset + ALIGN - 1) & ~(ALIGN - 1);
+        const end = aligned + byteLength;
+        if (end > this.memory.buffer.byteLength) {
+            const needed = Math.ceil((end - this.memory.buffer.byteLength) / 65536);
+            this.memory.grow(needed);
+            this.handleGrow();
+        }
+        this.nextOffset = end;
+        return aligned;
+    }
+    createView(Ctor, offset, count, fields, field) {
+        const view = new Ctor(this.memory.buffer, offset, count);
+        this.views.push({ fields, field, offset, Ctor, count });
+        fields[field] = view;
+        return view;
+    }
+    handleGrow() {
+        const buf = this.memory.buffer;
+        for (const reg of this.views) {
+            reg.fields[reg.field] = new reg.Ctor(buf, reg.offset, reg.count);
+        }
+    }
+    /** Update a registered view to point to a new (larger) allocation. */
+    updateView(fields, field, offset, Ctor, count) {
+        // Find and update the existing registration
+        for (const reg of this.views) {
+            if (reg.fields === fields && reg.field === field) {
+                reg.offset = offset;
+                reg.Ctor = Ctor;
+                reg.count = count;
+                fields[field] = new Ctor(this.memory.buffer, offset, count);
+                return;
+            }
+        }
+        // Not found — register as new
+        this.createView(Ctor, offset, count, fields, field);
+    }
+}

package/dist/{src/index.d.ts → index.d.ts}

@@ -1,17 +1,15 @@
 export { createEntityManager } from './EntityManager.js';
-export type { EntityId, FieldRef, ArchetypeView, EntityManager, SerializedData } from './EntityManager.js';
+export type { EntityId, ArchetypeView, EntityManager, SerializedData } from './EntityManager.js';
 export { createSystem, createSystems, System, OnAdded, OnRemoved } from './System.js';
 export type { SystemContext, FunctionalSystemConstructor, FunctionalSystem, Pipeline } from './System.js';
 export { profiler } from './Profiler.js';
 export type { Profiler, ProfilerEntry } from './Profiler.js';
 export { TYPED, componentSchemas, parseTypeSpec } from './ComponentRegistry.js';
-export type { ComponentDef, TypeSpec } from './ComponentRegistry.js';
+export type { ComponentDef, FieldRef, TypeSpec } from './ComponentRegistry.js';
+export { WasmArena } from './WasmArena.js';
+export { instantiateKernels, isWasmSimdAvailable } from './wasm-kernels.js';
+export type { IterateKernels } from './wasm-kernels.js';
 import { type ComponentDef } from './ComponentRegistry.js';
-import type { FieldRef } from './EntityManager.js';
 export declare function component(name: string): ComponentDef;
-export declare function component<F extends readonly string[]>(name: string, type: string, fields: F): ComponentDef & {
-    readonly [K in F[number]]: FieldRef;
-};
-export declare function component<S extends Record<string, string>>(name: string, schema: S): ComponentDef & {
-    readonly [K in keyof S]: FieldRef;
-};
+export declare function component<const F extends readonly string[]>(name: string, type: string, fields: F): ComponentDef<F[number]>;
+export declare function component<S extends Record<string, string>>(name: string, schema: S): ComponentDef<Extract<keyof S, string>>;

package/dist/{src/index.js → index.js}

@@ -2,6 +2,8 @@ export { createEntityManager } from './EntityManager.js';
 export { createSystem, createSystems, System, OnAdded, OnRemoved } from './System.js';
 export { profiler } from './Profiler.js';
 export { TYPED, componentSchemas, parseTypeSpec } from './ComponentRegistry.js';
+export { WasmArena } from './WasmArena.js';
+export { instantiateKernels, isWasmSimdAvailable } from './wasm-kernels.js';
 import { parseTypeSpec, componentSchemas } from './ComponentRegistry.js';
 export function component(name, typeOrSchema, fields) {
     const sym = Symbol(name);

package/dist/wasm-kernels.d.ts

@@ -0,0 +1,10 @@
+export interface IterateKernels {
+    iterate_scalar(px: number, py: number, vx: number, vy: number, count: number): void;
+    iterate_simd(px: number, py: number, vx: number, vy: number, count: number): void;
+    add_f32(dst: number, src: number, count: number): void;
+}
+/** Returns true if the runtime supports WebAssembly SIMD. Result is cached. */
+export declare function isWasmSimdAvailable(): boolean;
+export declare function instantiateKernels(memory: WebAssembly.Memory): Promise<IterateKernels>;
+/** Synchronous instantiation — only for small modules (<4KB). Used internally. */
+export declare function instantiateKernelsSync(memory: WebAssembly.Memory): IterateKernels;

package/dist/wasm-kernels.js

@@ -0,0 +1,59 @@
+// Auto-generated from src/iterate.wat — do not edit by hand
+const ITERATE_WASM = new Uint8Array([
+    0, 97, 115, 109, 1, 0, 0, 0, 1, 15, 2, 96, 5, 127, 127, 127, 127, 127, 0, 96,
+    3, 127, 127, 127, 0, 2, 15, 1, 3, 101, 110, 118, 6, 109, 101, 109, 111, 114, 121, 2,
+    0, 1, 3, 4, 3, 0, 0, 1, 7, 43, 3, 14, 105, 116, 101, 114, 97, 116, 101, 95,
+    115, 99, 97, 108, 97, 114, 0, 0, 12, 105, 116, 101, 114, 97, 116, 101, 95, 115, 105, 109,
+    100, 0, 1, 7, 97, 100, 100, 95, 102, 51, 50, 0, 2, 10, 148, 3, 3, 87, 1, 2,
+    127, 65, 0, 33, 5, 2, 64, 3, 64, 32, 5, 32, 4, 79, 13, 1, 32, 5, 65, 2,
+    116, 33, 6, 32, 0, 32, 6, 106, 32, 0, 32, 6, 106, 42, 2, 0, 32, 2, 32, 6,
+    106, 42, 2, 0, 146, 56, 2, 0, 32, 1, 32, 6, 106, 32, 1, 32, 6, 106, 42, 2,
+    0, 32, 3, 32, 6, 106, 42, 2, 0, 146, 56, 2, 0, 32, 5, 65, 1, 106, 33, 5,
+    12, 0, 11, 11, 11, 183, 1, 1, 3, 127, 32, 4, 65, 124, 113, 33, 7, 65, 0, 33,
+    5, 2, 64, 3, 64, 32, 5, 32, 7, 79, 13, 1, 32, 5, 65, 2, 116, 33, 6, 32,
+    0, 32, 6, 106, 32, 0, 32, 6, 106, 253, 0, 4, 0, 32, 2, 32, 6, 106, 253, 0,
+    4, 0, 253, 228, 1, 253, 11, 4, 0, 32, 1, 32, 6, 106, 32, 1, 32, 6, 106, 253,
+    0, 4, 0, 32, 3, 32, 6, 106, 253, 0, 4, 0, 253, 228, 1, 253, 11, 4, 0, 32,
+    5, 65, 4, 106, 33, 5, 12, 0, 11, 11, 2, 64, 3, 64, 32, 5, 32, 4, 79, 13,
+    1, 32, 5, 65, 2, 116, 33, 6, 32, 0, 32, 6, 106, 32, 0, 32, 6, 106, 42, 2,
+    0, 32, 2, 32, 6, 106, 42, 2, 0, 146, 56, 2, 0, 32, 1, 32, 6, 106, 32, 1,
+    32, 6, 106, 42, 2, 0, 32, 3, 32, 6, 106, 42, 2, 0, 146, 56, 2, 0, 32, 5,
+    65, 1, 106, 33, 5, 12, 0, 11, 11, 11, 128, 1, 1, 3, 127, 32, 2, 65, 124, 113,
+    33, 5, 65, 0, 33, 3, 2, 64, 3, 64, 32, 3, 32, 5, 79, 13, 1, 32, 3, 65,
+    2, 116, 33, 4, 32, 0, 32, 4, 106, 32, 0, 32, 4, 106, 253, 0, 4, 0, 32, 1,
+    32, 4, 106, 253, 0, 4, 0, 253, 228, 1, 253, 11, 4, 0, 32, 3, 65, 4, 106, 33,
+    3, 12, 0, 11, 11, 2, 64, 3, 64, 32, 3, 32, 2, 79, 13, 1, 32, 3, 65, 2,
+    116, 33, 4, 32, 0, 32, 4, 106, 32, 0, 32, 4, 106, 42, 2, 0, 32, 1, 32, 4,
+    106, 42, 2, 0, 146, 56, 2, 0, 32, 3, 65, 1, 106, 33, 3, 12, 0, 11, 11, 11
+]); // 500 bytes
+// Cached compiled module (shared across all EntityManager instances)
+let cachedModule = null;
+function getCompiledModule() {
+    if (!cachedModule) {
+        cachedModule = new WebAssembly.Module(ITERATE_WASM);
+    }
+    return cachedModule;
+}
+/** Returns true if the runtime supports WebAssembly SIMD. Result is cached. */
+export function isWasmSimdAvailable() {
+    if (cachedModule !== null)
+        return true;
+    try {
+        getCompiledModule();
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export async function instantiateKernels(memory) {
+    const module = getCompiledModule();
+    const instance = await WebAssembly.instantiate(module, { env: { memory } });
+    return instance.exports;
+}
+/** Synchronous instantiation — only for small modules (<4KB). Used internally. */
+export function instantiateKernelsSync(memory) {
+    const module = getCompiledModule();
+    const instance = new WebAssembly.Instance(module, { env: { memory } });
+    return instance.exports;
+}

package/package.json

@@ -1,20 +1,22 @@
 {
   "name": "archetype-ecs",
-  "version": "1.4.2",
+  "version": "1.5.0",
   "description": "Lightweight archetype-based Entity Component System",
   "type": "module",
-  "main": "dist/src/index.js",
-  "types": "dist/src/index.d.ts",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
   "exports": {
     ".": {
-      "types": "./dist/src/index.d.ts",
-      "default": "./dist/src/index.js"
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
     }
   },
   "scripts": {
     "build": "tsc",
-    "test": "tsc && node --test dist/tests/EntityManager.test.js dist/tests/System.test.js",
-    "bench": "node --expose-gc bench/multi-ecs-bench.js"
+    "test": "tsc && tsc -p tsconfig.test.json && node --test dist-test/tests/EntityManager.test.js dist-test/tests/System.test.js",
+    "bench": "node --expose-gc bench/multi-ecs-bench.js",
+    "bench:churn": "tsc && node --expose-gc bench/component-churn-bench.js",
+    "bench:tsc-vs-tsgo": "bash bench/run-js-vs-go-ts.sh"
   },
   "keywords": [
     "ecs",
@@ -26,10 +28,13 @@
   ],
   "license": "MIT",
   "devDependencies": {
+    "@types/node": "^25.2.3",
+    "@typescript/native-preview": "^7.0.0-dev.20260220.1",
     "bitecs": "^0.4.0",
     "harmony-ecs": "^0.0.12",
     "miniplex": "^2.0.0",
     "typescript": "^5.9.3",
+    "wabt": "^1.0.39",
     "wolf-ecs": "^2.0.0"
   }
 }

package/src/ComponentRegistry.ts

@@ -34,12 +34,16 @@ export function parseTypeSpec(typeStr: string): TypeSpec {
 
 export const componentSchemas = new Map<symbol, Record<string, TypeSpec>>();
 
-export interface ComponentDef {
+export interface FieldRef {
   readonly _sym: symbol;
-  readonly _name: string;
-  [key: string]: unknown;
+  readonly _field: string;
 }
 
+export type ComponentDef<F extends string = never> = {
+  readonly _sym: symbol;
+  readonly _name: string;
+} & { readonly [K in F]: FieldRef };
+
 export function toSym(type: ComponentDef | symbol): symbol {
   return (type as ComponentDef)._sym || (type as symbol);
 }