@ste_tisci/ecs 0.1.4 → 0.1.6

package/src/types/index.d.ts

@@ -1,42 +1,43 @@
-import type { IComponentStore } from './IComponentStore.js';
-
-/**
- * Represents component data in Structure of Arrays (SoA) format.
- * Each property of the component is stored in a separate array,
- * enabling cache-efficient iteration and SIMD operations.
- * @template T - The component data type
- * @example
- * // For Position component: { x: number, y: number }
- * // ComponentDataArrays would be: { x: number[], y: number[] }
- */
-export type ComponentDataArrays<T> = {
-  [K in keyof T]: T[K][];
-};
-
-/**
- * Maps component names to their corresponding ComponentStore instances.
- * Used internally by CreateWorld to manage all component stores.
- * @template T - Record type defining all component types
- */
-export type StoreMap<T> = {
-  [K in keyof T]: IComponentStore<T[K]>;
-};
-
-/**
- * Maps component names to their data arrays for direct access.
- * Used to expose component data to the user without store methods.
- * @template T - Record type defining all component types
- */
-export type StoreDataMap<T> = {
-  [K in keyof T]: ComponentDataArrays<T[K]>;
-};
-
-/**
- * Type helper for the query result.
- * Creates an object with eid and all required components typed correctly.
- * @template T - Record type with all component types.
- * @template C - Array of the component names requested in the query.
- */
-export type QueryResult<T, C extends (keyof T)[]> = {
-  [K in C[number]]: { id: number };
-};
+import type { IComponentStore } from './IComponentStore.js';
+
+/**
+ * Represents component data in Structure of Arrays (SoA) format.
+ * Each property of the component is stored in a separate array,
+ * enabling cache-efficient iteration and SIMD operations.
+ * Numeric properties are backed by a Float32Array for a compact, homogeneous
+ * memory layout; non-numeric properties fall back to a plain JS array.
+ * @template T - The component data type
+ * @example
+ * // For Position component: { x: number, y: number }
+ * // ComponentDataArrays would be: { x: Float32Array, y: Float32Array }
+ */
+export type ComponentDataArrays<T> = {
+  [K in keyof T]: T[K] extends number ? Float32Array : T[K][];
+};
+
+/**
+ * Maps component names to their corresponding ComponentStore instances.
+ * Used internally by CreateWorld to manage all component stores.
+ * @template T - Record type defining all component types
+ */
+export type StoreMap<T> = {
+  [K in keyof T]: IComponentStore<T[K]>;
+};
+
+/**
+ * Maps component names to their data arrays for direct access.
+ * Used to expose component data to the user without store methods.
+ * @template T - Record type defining all component types
+ */
+export type StoreDataMap<T> = {
+  [K in keyof T]: ComponentDataArrays<T[K]>;
+};
+
+/**
+ * Type helper for the query result.
+ * Creates an object with an entry for each requested component, holding its store index.
+ * @template C - Array of the component names requested in the query.
+ */
+export type QueryResult<C extends readonly PropertyKey[]> = {
+  [K in C[number]]: { id: number };
+};

package/src/utils/ComponentRegistry.ts

@@ -1,32 +1,32 @@
-import type { IComponentRegistry } from '../types/IComponentRegistry.js';
-
-export function createComponentRegistry<K extends string>(): IComponentRegistry<K> {
-  const nameToID = new Map<K, number>();
-  const IDtoName = new Map<number, K>();
-  let nextID: number = 0;
-
-  function register(name: K): void {
-    if (!nameToID.has(name)) {
-      const eid = nextID++;
-
-      nameToID.set(name, eid);
-      IDtoName.set(eid, name);
-    }
-  }
-
-  function getID(name: K): number {
-    const eid = nameToID.get(name);
-    if (eid === undefined) throw new Error(`Component ${name} not registered`);
-
-    return eid;
-  }
-
-  function getName(cid: number): K {
-    const name = IDtoName.get(cid);
-    if (!name) throw new Error(`Component ID ${cid} not registered`);
-
-    return name;
-  }
-
-  return { register, getID, getName };
-}
+import type { IComponentRegistry } from '../types/IComponentRegistry.js';
+
+export function createComponentRegistry<K extends string>(): IComponentRegistry<K> {
+  const nameToID = new Map<K, number>();
+  const IDtoName = new Map<number, K>();
+  let nextID: number = 0;
+
+  function register(name: K): void {
+    if (!nameToID.has(name)) {
+      const eid = nextID++;
+
+      nameToID.set(name, eid);
+      IDtoName.set(eid, name);
+    }
+  }
+
+  function getID(name: K): number {
+    const eid = nameToID.get(name);
+    if (eid === undefined) throw new Error(`Component ${name} not registered`);
+
+    return eid;
+  }
+
+  function getName(cid: number): K {
+    const name = IDtoName.get(cid);
+    if (!name) throw new Error(`Component ID ${cid} not registered`);
+
+    return name;
+  }
+
+  return { register, getID, getName };
+}

package/src/utils/SparseSet.ts

@@ -1,54 +1,54 @@
-import type { ISparseSet } from '../types/ISparseSet.js';
-
-export function SparseSet(): ISparseSet {
-  const sparse: number[] = [];
-  const dense: number[] = [];
-  let size = 0;
-
-  function has(eid: number): boolean {
-    const ID = getIndex(eid);
-
-    const exist = ID !== undefined && dense[ID] === eid;
-    const isWhitinBounds = ID >= 0 && ID < size;
-
-    return exist && isWhitinBounds;
-  }
-
-  function add(eid: number): void {
-    if (has(eid)) throw new Error(`ID ${eid} already present in the set`);
-
-    sparse[eid] = size;
-    dense[size] = eid;
-    size++;
-  }
-
-  function remove(eid: number): void {
-    if (!has(eid)) throw new Error(`Cannot remove ID ${eid} because does not exists`);
-
-    const ID = getIndex(eid);
-    const last = dense[size - 1];
-
-    // Swap with the last element inserted
-    dense[ID] = last;
-    sparse[last] = ID;
-
-    // Remove the element
-    dense.pop();
-    size--;
-    delete sparse[eid];
-  }
-
-  function getIndex(eid: number): number {
-    return sparse[eid];
-  }
-
-  function getDense(): number[] {
-    return dense;
-  }
-
-  function getSize(): number {
-    return size;
-  }
-
-  return { has, add, remove, getIndex, getDense, getSize };
-}
+import type { ISparseSet } from '../types/ISparseSet.js';
+
+export function SparseSet(): ISparseSet {
+  const sparse: number[] = [];
+  const dense: number[] = [];
+  let size = 0;
+
+  function has(eid: number): boolean {
+    const ID = getIndex(eid);
+
+    const exist = ID !== undefined && dense[ID] === eid;
+    const isWhitinBounds = ID >= 0 && ID < size;
+
+    return exist && isWhitinBounds;
+  }
+
+  function add(eid: number): void {
+    if (has(eid)) throw new Error(`ID ${eid} already present in the set`);
+
+    sparse[eid] = size;
+    dense[size] = eid;
+    size++;
+  }
+
+  function remove(eid: number): void {
+    if (!has(eid)) throw new Error(`Cannot remove ID ${eid} because does not exists`);
+
+    const ID = getIndex(eid);
+    const last = dense[size - 1];
+
+    // Swap with the last element inserted
+    dense[ID] = last;
+    sparse[last] = ID;
+
+    // Remove the element
+    dense.pop();
+    size--;
+    delete sparse[eid];
+  }
+
+  function getIndex(eid: number): number {
+    return sparse[eid];
+  }
+
+  function getDense(): number[] {
+    return dense;
+  }
+
+  function getSize(): number {
+    return size;
+  }
+
+  return { has, add, remove, getIndex, getDense, getSize };
+}

package/tsconfig.json

@@ -1,17 +1,17 @@
-{
-  "compilerOptions": {
-    "target": "es2024",
-    "allowSyntheticDefaultImports": true,
-    "esModuleInterop": true,
-    "outDir": "dist",
-    "forceConsistentCasingInFileNames": true,
-    "resolveJsonModule": true,
-    "strict": true,
-    "sourceMap": true,
-    "rootDir": "src",
-    "moduleResolution": "nodenext",
-    "module": "node20"
-  },
-  "exclude": ["node_modules/"],
-  "include": ["src"]
-}
+{
+  "compilerOptions": {
+    "target": "es2024",
+    "allowSyntheticDefaultImports": true,
+    "esModuleInterop": true,
+    "outDir": "dist",
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "strict": true,
+    "sourceMap": true,
+    "rootDir": "src",
+    "moduleResolution": "nodenext",
+    "module": "node20"
+  },
+  "exclude": ["node_modules/"],
+  "include": ["src"]
+}

package/tsup.config.ts

@@ -1,10 +1,10 @@
-import { defineConfig } from 'tsup';
-
-export default defineConfig({
-  format: ['cjs', 'esm'],
-  entry: ['./src/index.ts'],
-  dts: true,
-  shims: true,
-  skipNodeModulesBundle: true,
-  clean: true,
-});
+import { defineConfig } from 'tsup';
+
+export default defineConfig({
+  format: ['cjs', 'esm'],
+  entry: ['./src/index.ts'],
+  dts: true,
+  shims: true,
+  skipNodeModulesBundle: true,
+  clean: true,
+});