iris-ecs 0.0.1

package/dist/archetype.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"archetype.js","sourceRoot":"","sources":["../src/archetype.ts"],"names":[],"mappings":"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"}

package/dist/component.d.ts

@@ -0,0 +1,89 @@
+import type { Component, Entity, EntityId, Pair, Relation, Tag } from "./encoding.js";
+import type { InferSchema, InferSchemaRecord, SchemaRecord } from "./schema.js";
+import type { World } from "./world.js";
+export declare function addComponent(world: World, entityId: EntityId, componentId: Entity | Tag | Pair<Relation<Record<string, never>>>): void;
+export declare function addComponent<S extends SchemaRecord>(world: World, entityId: EntityId, componentId: Component<S> | Pair<Relation<S>>, data: InferSchemaRecord<S>): void;
+/**
+ * Remove component from entity.
+ *
+ * Moves entity to new archetype without component. Idempotent if not present.
+ *
+ * @param world - World instance
+ * @param entityId - Entity to modify
+ * @param componentId - Component to remove
+ *
+ * @example
+ * ```typescript
+ * addComponent(world, entity, tag);
+ * removeComponent(world, entity, tag);
+ * ```
+ */
+export declare function removeComponent(world: World, entityId: EntityId, componentId: EntityId): void;
+/**
+ * Check if entity has component.
+ *
+ * Returns false for dead entities or if component not present.
+ *
+ * @param world - World instance
+ * @param entityId - Entity to check
+ * @param componentId - Component to check
+ * @returns True if entity has component
+ *
+ * @example
+ * ```typescript
+ * addComponent(world, entity, tag);
+ * hasComponent(world, entity, tag);  // true
+ * ```
+ */
+export declare function hasComponent(world: World, entityId: EntityId, componentId: EntityId): boolean;
+/**
+ * Get component field value.
+ *
+ * @param world - World instance
+ * @param entityId - Entity to query
+ * @param componentId - Data component
+ * @param fieldName - Field name
+ * @returns Field value or undefined if component/field not present
+ *
+ * @example
+ * ```typescript
+ * const Position = defineComponent("Position", { x: Type.f32(), y: Type.f32() });
+ * const x = getComponentValue(world, entity, Position, 'x');
+ * ```
+ */
+export declare function getComponentValue<S extends SchemaRecord, K extends keyof S>(world: World, entityId: EntityId, componentId: Component<S> | Pair<Relation<S>>, fieldName: K): InferSchema<S[K]> | undefined;
+/**
+ * Set component field value.
+ *
+ * @param world - World instance
+ * @param entityId - Entity to modify
+ * @param componentId - Data component
+ * @param fieldName - Field name
+ * @param value - New value
+ *
+ * @example
+ * ```typescript
+ * addComponent(world, entity, Position, { x: 0.0, y: 0.0 });
+ * setComponentValue(world, entity, Position, 'x', 10.0);
+ * ```
+ */
+export declare function setComponentValue<S extends SchemaRecord, K extends keyof S>(world: World, entityId: EntityId, componentId: Component<S> | Pair<Relation<S>>, fieldName: K, value: InferSchema<S[K]>): void;
+/**
+ * Emit component changed event without setting a value.
+ *
+ * @param world - World instance
+ * @param entityId - Entity with the component
+ * @param componentId - Component that was changed
+ *
+ * @example
+ * emitComponentChanged(world, entity, Position);  // Notify change tracking
+ */
+export declare function emitComponentChanged(world: World, entityId: EntityId, componentId: EntityId): void;
+/**
+ * Remove component from all entities that have it.
+ *
+ * @param world - World instance
+ * @param componentId - Component to remove from all entities
+ */
+export declare function cascadeRemoveComponent(world: World, componentId: EntityId): void;
+//# sourceMappingURL=component.d.ts.map

package/dist/component.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component.d.ts","sourceRoot":"","sources":["../src/component.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AAMtF,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChF,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAMxC,wBAAgB,YAAY,CAC1B,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,QAAQ,EAClB,WAAW,EAAE,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,GAChE,IAAI,CAAC;AAER,wBAAgB,YAAY,CAAC,CAAC,SAAS,YAAY,EACjD,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,QAAQ,EAClB,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAC7C,IAAI,EAAE,iBAAiB,CAAC,CAAC,CAAC,GACzB,IAAI,CAAC;AAwER;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,GAAG,IAAI,CAsD7F;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,GAAG,OAAO,CAI7F;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,YAAY,EAAE,CAAC,SAAS,MAAM,CAAC,EACzE,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,QAAQ,EAClB,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAC7C,SAAS,EAAE,CAAC,GACX,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,CAc/B;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,YAAY,EAAE,CAAC,SAAS,MAAM,CAAC,EACzE,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,QAAQ,EAClB,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAC7C,SAAS,EAAE,CAAC,EACZ,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GACvB,IAAI,CAqBN;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,GAAG,IAAI,CASlG;AAMD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,QAAQ,GAAG,IAAI,CAiBhF"}

package/dist/component.js

@@ -0,0 +1,237 @@
+import { archetypeTraverseAdd, archetypeTraverseRemove, destroyArchetype } from "./archetype.js";
+import { encodePair, isPair } from "./encoding.js";
+import { ensureEntity, moveEntityToArchetype } from "./entity.js";
+import { fireObserverEvent } from "./observer.js";
+import { Exclusive, Wildcard } from "./registry.js";
+import { getPairRelation, getPairTarget, getRelationTargets } from "./relation.js";
+/**
+ * Add component to entity.
+ *
+ * Moves entity to new archetype with component. Idempotent if already present.
+ * For data components/pairs, pass initial field values.
+ *
+ * @param world - World instance
+ * @param entityId - Entity to modify
+ * @param componentId - Tag, data component, or pair to add
+ * @param data - Initial field values for data components (optional)
+ *
+ * @example
+ * addComponent(world, entity, Player);
+ * addComponent(world, entity, Position, { x: 0, y: 0 });
+ * addComponent(world, child, pair(ChildOf, parent));
+ */
+export function addComponent(world, entityId, componentId, data) {
+    // Idempotent: already has component
+    if (hasComponent(world, entityId, componentId)) {
+        return;
+    }
+    // Exclusive enforcement: remove old target before adding new
+    if (isPair(componentId)) {
+        const target = getPairTarget(world, componentId);
+        const relation = getPairRelation(componentId);
+        if (hasComponent(world, relation, Exclusive) && target !== Wildcard) {
+            const oldTargets = getRelationTargets(world, entityId, relation);
+            if (oldTargets.length > 0) {
+                removeComponent(world, entityId, encodePair(relation, oldTargets[0]));
+            }
+        }
+    }
+    const entityMeta = ensureEntity(world, entityId);
+    const componentMeta = ensureEntity(world, componentId);
+    const schema = componentMeta.schema;
+    // Find target archetype
+    let toArchetype = archetypeTraverseAdd(world, entityMeta.archetype, componentId, schema);
+    // Add wildcard pairs for query patterns: pair(Wildcard, target) and pair(relation, Wildcard)
+    if (isPair(componentId)) {
+        const target = getPairTarget(world, componentId);
+        const relation = getPairRelation(componentId);
+        toArchetype = archetypeTraverseAdd(world, toArchetype, encodePair(Wildcard, target));
+        toArchetype = archetypeTraverseAdd(world, toArchetype, encodePair(relation, Wildcard));
+    }
+    moveEntityToArchetype(world, entityId, toArchetype);
+    if (data) {
+        for (const fieldName in data) {
+            const value = data[fieldName];
+            setComponentValue(world, entityId, componentId, fieldName, value);
+        }
+    }
+    // Fire after move so observers can access component data
+    fireObserverEvent(world, "componentAdded", componentId, entityId);
+}
+/**
+ * Remove component from entity.
+ *
+ * Moves entity to new archetype without component. Idempotent if not present.
+ *
+ * @param world - World instance
+ * @param entityId - Entity to modify
+ * @param componentId - Component to remove
+ *
+ * @example
+ * ```typescript
+ * addComponent(world, entity, tag);
+ * removeComponent(world, entity, tag);
+ * ```
+ */
+export function removeComponent(world, entityId, componentId) {
+    const meta = ensureEntity(world, entityId);
+    // Find target archetype
+    let toArchetype = archetypeTraverseRemove(world, meta.archetype, componentId);
+    // Idempotent check
+    if (toArchetype === meta.archetype) {
+        return;
+    }
+    // Remove wildcard pairs only if no other pairs need them
+    if (isPair(componentId)) {
+        const target = getPairTarget(world, componentId);
+        const relation = getPairRelation(componentId);
+        const wildcardTargetPair = encodePair(Wildcard, target);
+        const relationWildcardPair = encodePair(relation, Wildcard);
+        let hasOtherTarget = false;
+        let hasOtherRelation = false;
+        for (const typeId of meta.archetype.types) {
+            if (typeId === componentId ||
+                typeId === wildcardTargetPair ||
+                typeId === relationWildcardPair ||
+                !isPair(typeId)) {
+                continue;
+            }
+            if (getPairTarget(world, typeId) === target) {
+                hasOtherTarget = true;
+            }
+            if (getPairRelation(typeId) === relation) {
+                hasOtherRelation = true;
+            }
+        }
+        if (!hasOtherTarget) {
+            toArchetype = archetypeTraverseRemove(world, toArchetype, wildcardTargetPair);
+        }
+        if (!hasOtherRelation) {
+            toArchetype = archetypeTraverseRemove(world, toArchetype, relationWildcardPair);
+        }
+    }
+    // Fire before move so observers can access component data
+    fireObserverEvent(world, "componentRemoved", componentId, entityId);
+    moveEntityToArchetype(world, entityId, toArchetype);
+}
+/**
+ * Check if entity has component.
+ *
+ * Returns false for dead entities or if component not present.
+ *
+ * @param world - World instance
+ * @param entityId - Entity to check
+ * @param componentId - Component to check
+ * @returns True if entity has component
+ *
+ * @example
+ * ```typescript
+ * addComponent(world, entity, tag);
+ * hasComponent(world, entity, tag);  // true
+ * ```
+ */
+export function hasComponent(world, entityId, componentId) {
+    const meta = ensureEntity(world, entityId);
+    return meta.archetype.typesSet.has(componentId);
+}
+/**
+ * Get component field value.
+ *
+ * @param world - World instance
+ * @param entityId - Entity to query
+ * @param componentId - Data component
+ * @param fieldName - Field name
+ * @returns Field value or undefined if component/field not present
+ *
+ * @example
+ * ```typescript
+ * const Position = defineComponent("Position", { x: Type.f32(), y: Type.f32() });
+ * const x = getComponentValue(world, entity, Position, 'x');
+ * ```
+ */
+export function getComponentValue(world, entityId, componentId, fieldName) {
+    const meta = ensureEntity(world, entityId);
+    const fieldColumns = meta.archetype.columns.get(componentId);
+    if (!fieldColumns) {
+        return;
+    }
+    const column = fieldColumns[fieldName];
+    if (!column) {
+        return;
+    }
+    return column[meta.row];
+}
+/**
+ * Set component field value.
+ *
+ * @param world - World instance
+ * @param entityId - Entity to modify
+ * @param componentId - Data component
+ * @param fieldName - Field name
+ * @param value - New value
+ *
+ * @example
+ * ```typescript
+ * addComponent(world, entity, Position, { x: 0.0, y: 0.0 });
+ * setComponentValue(world, entity, Position, 'x', 10.0);
+ * ```
+ */
+export function setComponentValue(world, entityId, componentId, fieldName, value) {
+    const meta = ensureEntity(world, entityId);
+    const fieldColumns = meta.archetype.columns.get(componentId);
+    if (!fieldColumns) {
+        return;
+    }
+    const column = fieldColumns[fieldName];
+    if (!column) {
+        return;
+    }
+    column[meta.row] = value;
+    const ticks = meta.archetype.ticks.get(componentId);
+    if (ticks) {
+        ticks.changed[meta.row] = world.execution.tick;
+    }
+    fireObserverEvent(world, "componentChanged", componentId, entityId);
+}
+/**
+ * Emit component changed event without setting a value.
+ *
+ * @param world - World instance
+ * @param entityId - Entity with the component
+ * @param componentId - Component that was changed
+ *
+ * @example
+ * emitComponentChanged(world, entity, Position);  // Notify change tracking
+ */
+export function emitComponentChanged(world, entityId, componentId) {
+    const meta = ensureEntity(world, entityId);
+    const ticks = meta.archetype.ticks.get(componentId);
+    if (ticks) {
+        ticks.changed[meta.row] = world.execution.tick;
+    }
+    fireObserverEvent(world, "componentChanged", componentId, entityId);
+}
+// ============================================================================
+// Component Cleanup
+// ============================================================================
+/**
+ * Remove component from all entities that have it.
+ *
+ * @param world - World instance
+ * @param componentId - Component to remove from all entities
+ */
+export function cascadeRemoveComponent(world, componentId) {
+    const meta = ensureEntity(world, componentId);
+    // Copy records - will be modified during iteration as entities move
+    const archetypes = [...meta.records];
+    for (const archetype of archetypes) {
+        // Iterate backward for deletion safety (entities removed during iteration)
+        for (let i = archetype.entities.length - 1; i >= 0; i--) {
+            const entityId = archetype.entities[i];
+            removeComponent(world, entityId, componentId);
+        }
+        // Destroy now-invalid archetype (contains dead component type)
+        destroyArchetype(world, archetype);
+    }
+}
+//# sourceMappingURL=component.js.map

package/dist/component.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"component.js","sourceRoot":"","sources":["../src/component.ts"],"names":[],"mappings":"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"}

package/dist/encoding.d.ts

@@ -0,0 +1,204 @@
+import type { Schema, SchemaRecord } from "./schema.js";
+/**
+ * Entity type constant (0x1).
+ */
+export declare const ENTITY_TYPE = 1;
+/**
+ * Tag type constant (0x2).
+ */
+export declare const TAG_TYPE = 2;
+/**
+ * Component type constant (0x3).
+ */
+export declare const COMPONENT_TYPE = 3;
+/**
+ * Relationship type constant (0x4).
+ */
+export declare const RELATIONSHIP_TYPE = 4;
+/**
+ * Maximum raw ID for entities, components, and tags (20-bit).
+ */
+export declare const ID_MASK_20 = 1048575;
+/**
+ * Maximum raw ID for relationships (8-bit).
+ */
+export declare const ID_MASK_8 = 255;
+/**
+ * Entity brand for nominal typing.
+ */
+declare const ENTITY_BRAND: unique symbol;
+/**
+ * Tag brand for nominal typing.
+ */
+declare const TAG_BRAND: unique symbol;
+/**
+ * Component brand for nominal typing.
+ */
+declare const COMPONENT_BRAND: unique symbol;
+/**
+ * Relation brand for nominal typing.
+ */
+declare const RELATION_BRAND: unique symbol;
+/**
+ * Pair brand for nominal typing.
+ */
+declare const PAIR_BRAND: unique symbol;
+/**
+ * Schema brand for carrying schema type in Component.
+ */
+declare const SCHEMA_BRAND: unique symbol;
+/**
+ * Entity ID (branded type).
+ *
+ * Nominal type preventing accidental mixing of entities with raw numbers.
+ */
+export type Entity = number & {
+    [ENTITY_BRAND]: true;
+};
+/**
+ * Tag ID (branded type).
+ *
+ * Nominal type for component tags defined via defineTag().
+ */
+export type Tag = number & {
+    [TAG_BRAND]: true;
+};
+/**
+ * Component ID (branded type).
+ *
+ * Nominal type for data components with field schemas.
+ */
+export type Component<S extends SchemaRecord = SchemaRecord> = number & {
+    [COMPONENT_BRAND]: true;
+    [SCHEMA_BRAND]: S;
+};
+/**
+ * Relation ID (branded type).
+ *
+ * Nominal type for relations with optional schema for pair data.
+ */
+export type Relation<S extends SchemaRecord = SchemaRecord> = number & {
+    [RELATION_BRAND]: true;
+    [SCHEMA_BRAND]: S;
+};
+/**
+ * Pair ID (branded type).
+ *
+ * Nominal type for relation-target pairs. Inherits schema from relation.
+ */
+export type Pair<R extends Relation = Relation> = number & {
+    [PAIR_BRAND]: true;
+    [SCHEMA_BRAND]: R extends Relation<infer S> ? S : never;
+};
+/**
+ * Valid targets for relations.
+ *
+ * Pairs cannot target other pairs to prevent encoding issues.
+ */
+export type RelationTargetId = Entity | Tag | Component | Relation;
+/**
+ * Entity or Component ID (union type).
+ *
+ * Used in function signatures to accept entities, tags, data components, relations, and pairs.
+ */
+export type EntityId = Entity | Tag | Component | Relation | Pair;
+/**
+ * Pair flag bit position (bit 31).
+ */
+export declare const PAIR_FLAG_SHIFT = 31;
+/**
+ * Type bits position (bits 30-28).
+ */
+export declare const TYPE_SHIFT = 28;
+/**
+ * Type mask (3 bits).
+ */
+export declare const TYPE_MASK = 7;
+/**
+ * Encode entity ID from raw ID and generation.
+ *
+ * @param rawId - Raw entity ID (0 to 1,048,575)
+ * @param generation - Generation number (0 to 255)
+ * @returns Encoded 32-bit entity ID
+ */
+export declare function encodeEntity(rawId: number, generation: number): Entity;
+/**
+ * Encode component ID from raw ID.
+ *
+ * @param rawId - Raw component ID (0 to 1,048,575)
+ * @returns Encoded 32-bit component ID
+ */
+export declare function encodeComponent<S extends Record<string, Schema> = Record<string, Schema>>(rawId: number): Component<S>;
+/**
+ * Encode tag ID from raw ID.
+ *
+ * @param rawId - Raw tag ID (0 to 1,048,575)
+ * @returns Encoded 32-bit tag ID
+ */
+export declare function encodeTag(rawId: number): Tag;
+/**
+ * Encode relation ID from raw ID.
+ *
+ * @param rawId - Raw relation ID (0 to 255)
+ * @returns Encoded 32-bit relation ID
+ */
+export declare function encodeRelation<S extends Record<string, Schema> = Record<string, Schema>>(rawId: number): Relation<S>;
+/**
+ * Encode a pair from relation and target.
+ *
+ * @param relation - Relation ID
+ * @param target - Target ID (entity, tag, component, or relation)
+ * @returns Encoded pair ID
+ */
+export declare function encodePair<R extends Relation>(relation: R, target: RelationTargetId): Pair<R>;
+/**
+ * Extract type bits from encoded ID.
+ *
+ * @param id - Encoded ID
+ * @returns Type bits (0x0 - 0x7)
+ */
+export declare function extractType(id: number): number;
+/**
+ * Extract raw ID from encoded ID (type-aware).
+ *
+ * @param id - Encoded ID (any non-pair type)
+ * @returns Raw ID (20-bit for entities/components/tags, 8-bit for relationships)
+ */
+export declare function extractId(id: number): number;
+/**
+ * Extract meta field from encoded ID (type-aware).
+ *
+ * @param id - Encoded ID (any non-pair type)
+ * @returns Meta value (generation for entities, 0 for components/tags/relationships)
+ */
+export declare function extractMeta(id: number): number;
+/**
+ * Check if ID is a pair.
+ *
+ * @param id - Encoded ID
+ * @returns True if bit 31 is set, false otherwise
+ */
+export declare function isPair(id: number): id is Pair;
+/**
+ * Extract relation raw ID from pair.
+ *
+ * @param pairId - Encoded pair ID
+ * @returns Relation raw ID (8-bit)
+ */
+export declare function extractPairRelationId(pairId: number): number;
+/**
+ * Extract target raw ID from pair.
+ *
+ * @param pairId - Encoded pair ID
+ * @returns Target raw ID (20-bit)
+ */
+export declare function extractPairTargetId(pairId: number): number;
+/**
+ * Extract target type from pair.
+ *
+ * @param pairId - Encoded pair ID
+ * @returns Target type bits (3-bit)
+ */
+export declare function extractPairTargetType(pairId: number): number;
+export {};
+//# sourceMappingURL=encoding.d.ts.map

package/dist/encoding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"encoding.d.ts","sourceRoot":"","sources":["../src/encoding.ts"],"names":[],"mappings":"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"}