archetype-ecs 1.3.1 → 1.3.2

package/dist/ComponentRegistry.js

@@ -0,0 +1,29 @@
+export const TYPED = Symbol('typed');
+export const TYPE_MAP = {
+    'f32': Float32Array,
+    'f64': Float64Array,
+    'i8': Int8Array,
+    'i16': Int16Array,
+    'i32': Int32Array,
+    'u8': Uint8Array,
+    'u16': Uint16Array,
+    'u32': Uint32Array,
+    'string': Array,
+};
+export function parseTypeSpec(typeStr) {
+    const match = typeStr.match(/^(\w+)\[(\d+)\]$/);
+    if (match) {
+        const Ctor = TYPE_MAP[match[1]];
+        if (!Ctor)
+            throw new Error(`Unknown base type "${match[1]}"`);
+        return [Ctor, parseInt(match[2])];
+    }
+    const Ctor = TYPE_MAP[typeStr];
+    if (!Ctor)
+        throw new Error(`Unknown type "${typeStr}"`);
+    return Ctor;
+}
+export const componentSchemas = new Map();
+export function toSym(type) {
+    return type._sym || type;
+}

package/dist/EntityManager.d.ts

@@ -0,0 +1,52 @@
+import { type ComponentDef, type FieldRef } from './ComponentRegistry.js';
+export type { FieldRef } from './ComponentRegistry.js';
+export type EntityId = number;
+export type SoAArrayValue = Float32Array | Float64Array | Int8Array | Int16Array | Int32Array | Uint8Array | Uint16Array | Uint32Array | unknown[];
+export interface ArchetypeView {
+    readonly id: number;
+    readonly entityIds: EntityId[];
+    readonly count: number;
+    readonly snapshotEntityIds: EntityId[] | null;
+    readonly snapshotCount: number;
+    field(ref: FieldRef): SoAArrayValue | undefined;
+    fieldStride(ref: FieldRef): number;
+    snapshot(ref: FieldRef): SoAArrayValue | undefined;
+}
+export interface SerializedData {
+    nextId: number;
+    entities: EntityId[];
+    components: Record<string, Record<string, unknown>>;
+}
+export type ComponentData = Record<string, number | string | ArrayLike<number>> | null | undefined;
+export interface EntityManager {
+    createEntity(): EntityId;
+    destroyEntity(id: EntityId): void;
+    addComponent(entityId: EntityId, type: ComponentDef, data?: ComponentData): void;
+    removeComponent(entityId: EntityId, type: ComponentDef): void;
+    getComponent(entityId: EntityId, type: ComponentDef): Record<string, number | string | number[]> | undefined;
+    get(entityId: EntityId, fieldRef: FieldRef): number | string | undefined;
+    set(entityId: EntityId, fieldRef: FieldRef, value: number | string | ArrayLike<number>): void;
+    hasComponent(entityId: EntityId, type: ComponentDef): boolean;
+    query(include: ComponentDef[], exclude?: ComponentDef[]): EntityId[];
+    getAllEntities(): EntityId[];
+    createEntityWith(...args: unknown[]): EntityId;
+    count(include: ComponentDef[], exclude?: ComponentDef[]): number;
+    forEach(include: ComponentDef[], callback: (view: ArchetypeView) => void, exclude?: ComponentDef[]): void;
+    onAdd(type: ComponentDef, callback: (entityId: EntityId) => void): () => void;
+    onRemove(type: ComponentDef, callback: (entityId: EntityId) => void): () => void;
+    flushHooks(): void;
+    commitRemovals(): void;
+    enableTracking(filterComponent: ComponentDef): void;
+    flushChanges(): {
+        created: Set<EntityId>;
+        destroyed: Set<EntityId>;
+    };
+    flushSnapshots(): void;
+    serialize(symbolToName: Map<symbol, string>, stripComponents?: ComponentDef[], skipEntitiesWith?: ComponentDef[], options?: {
+        serializers?: Map<string, (data: unknown) => unknown>;
+    }): SerializedData;
+    deserialize(data: SerializedData, nameToSymbol: Record<string, ComponentDef>, options?: {
+        deserializers?: Map<string, (data: unknown) => unknown>;
+    }): void;
+}
+export declare function createEntityManager(): EntityManager;