@codehz/ecs 0.3.7 → 0.3.9

package/entity.d.ts

@@ -1,192 +0,0 @@
-/**
- * Unique symbol brand for associating component type information with EntityId
- */
-declare const __componentTypeMarker: unique symbol;
-/**
- * Unique symbol brand for tagging the kind of EntityId (e.g., 'component', 'entity-relation')
- */
-declare const __entityIdTypeTag: unique symbol;
-/**
- * Entity ID type for ECS architecture
- * Based on 52-bit integers within safe integer range
- * - Component IDs: 1-1023
- * - Entity IDs: 1024+
- * - Relation IDs: negative numbers encoding component and entity associations
- */
-export type EntityId<T = void, U = unknown> = number & {
-    readonly [__componentTypeMarker]: T;
-    readonly [__entityIdTypeTag]: U;
-};
-export type ComponentId<T = void> = EntityId<T, "component">;
-export type EntityRelationId<T = void> = EntityId<T, "entity-relation">;
-export type ComponentRelationId<T = void> = EntityId<T, "component-relation">;
-export type WildcardRelationId<T = void> = EntityId<T, "wildcard-relation">;
-export type RelationId<T = void> = EntityRelationId<T> | ComponentRelationId<T> | WildcardRelationId<T>;
-/**
- * Constants for ID ranges
- */
-export declare const INVALID_COMPONENT_ID = 0;
-export declare const COMPONENT_ID_MAX = 1023;
-export declare const ENTITY_ID_START = 1024;
-/**
- * Constants for relation ID encoding
- */
-export declare const RELATION_SHIFT: number;
-export declare const WILDCARD_TARGET_ID = 0;
-/**
- * Create a component ID
- * @param id Component identifier (1-1023)
- * @see component
- */
-export declare function createComponentId<T = void>(id: number): ComponentId<T>;
-/**
- * Create an entity ID
- * @param id Entity identifier (starting from 1024)
- */
-export declare function createEntityId(id: number): EntityId;
-/**
- * Type for relation ID based on component and target types
- */
-type RelationIdType<T, R> = R extends ComponentId<infer U> ? U extends void ? ComponentRelationId<T> : ComponentRelationId<T extends void ? U : T> : R extends EntityId<any> ? EntityRelationId<T> : never;
-/**
- * Create a relation ID by associating a component with another ID (entity or component)
- * @param componentId The component ID (0-1023)
- * @param targetId The target ID (entity, component, or '*' for wildcard)
- */
-export declare function relation<T>(componentId: ComponentId<T>, targetId: "*"): WildcardRelationId<T>;
-export declare function relation<T, R extends EntityId<any>>(componentId: ComponentId<T>, targetId: R): RelationIdType<T, R>;
-/**
- * Check if an ID is a component ID
- */
-export declare function isComponentId<T>(id: EntityId<T>): id is ComponentId<T>;
-/**
- * Check if an ID is an entity ID
- */
-export declare function isEntityId<T>(id: EntityId<T>): id is EntityId<T>;
-/**
- * Check if an ID is a relation ID
- */
-export declare function isRelationId<T>(id: EntityId<T>): id is RelationId<T>;
-/**
- * Check if an ID is a wildcard relation id
- */
-export declare function isWildcardRelationId<T>(id: EntityId<T>): id is WildcardRelationId<T>;
-/**
- * Decode a relation ID into component and target IDs
- * @param relationId The relation ID (must be negative)
- * @returns Object with componentId, targetId, and relation type
- */
-export declare function decodeRelationId(relationId: RelationId<any>): {
-    componentId: ComponentId<any>;
-    targetId: EntityId<any>;
-    type: "entity" | "component" | "wildcard";
-};
-/**
- * Get the string representation of an ID type
- */
-export declare function getIdType(id: EntityId<any>): "component" | "entity" | "entity-relation" | "component-relation" | "wildcard-relation" | "invalid";
-/**
- * Get detailed type information for an EntityId
- * @param id The EntityId to analyze
- * @returns Detailed type information including relation subtypes
- */
-export declare function getDetailedIdType(id: EntityId<any>): {
-    type: "component" | "entity" | "invalid";
-    componentId?: never;
-    targetId?: never;
-} | {
-    type: "entity-relation" | "wildcard-relation";
-    componentId: ComponentId<any>;
-    targetId: EntityId<any>;
-} | {
-    type: "component-relation";
-    componentId: ComponentId<any>;
-    targetId: ComponentId<any>;
-};
-/**
- * Inspect an EntityId and return a human-readable string representation
- * @param id The EntityId to inspect
- * @returns A friendly string representation of the ID
- */
-export declare function inspectEntityId(id: EntityId<any>): string;
-/**
- * Entity ID Manager for automatic allocation and freelist recycling
- */
-export declare class EntityIdManager {
-    private nextId;
-    private freelist;
-    /**
-     * Allocate a new entity ID
-     * Uses freelist if available, otherwise increments counter
-     */
-    allocate(): EntityId;
-    /**
-     * Deallocate an entity ID, adding it to the freelist for reuse
-     * @param id The entity ID to deallocate
-     */
-    deallocate(id: EntityId<any>): void;
-    /**
-     * Get the current freelist size (for debugging/monitoring)
-     */
-    getFreelistSize(): number;
-    /**
-     * Get the next ID that would be allocated (for debugging)
-     */
-    getNextId(): number;
-    /**
-     * Serialize internal state for persistence.
-     * Returns a plain object representing allocator state. Values may be non-JSON-serializable.
-     */
-    serializeState(): {
-        nextId: number;
-        freelist: number[];
-    };
-    /**
-     * Restore internal state from a previously-serialized object.
-     * Overwrites the current nextId and freelist.
-     */
-    deserializeState(state: {
-        nextId: number;
-        freelist?: number[];
-    }): void;
-}
-/**
- * Component ID Manager for automatic allocation
- * Components are typically registered once and not recycled
- */
-export declare class ComponentIdAllocator {
-    private nextId;
-    /**
-     * Allocate a new component ID
-     * Increments counter sequentially from 1
-     */
-    allocate<T = void>(): ComponentId<T>;
-    /**
-     * Get the next ID that would be allocated (for debugging)
-     */
-    getNextId(): number;
-    /**
-     * Check if more component IDs are available
-     */
-    hasAvailableIds(): boolean;
-}
-/**
- * Allocate a new component ID from the global allocator.
- * Optionally register a name for the component.
- * The name is only for serialization/debugging and does not affect base functionality.
- * @param name Optional name for the component
- * @returns The allocated component ID
- */
-export declare function component<T = void>(name?: string): ComponentId<T>;
-/**
- * Get a component ID by its registered name
- * @param name The component name
- * @returns The component ID if found, undefined otherwise
- */
-export declare function getComponentIdByName(name: string): ComponentId<any> | undefined;
-/** Get a component name by its ID
- * @param id The component ID
- * @returns The component name if found, undefined otherwise
- */
-export declare function getComponentNameById(id: ComponentId<any>): string | undefined;
-export {};

package/index.d.ts

@@ -1,7 +0,0 @@
-export * from "./entity";
-export * from "./world";
-export * from "./archetype";
-export * from "./query";
-export * from "./system";
-export * from "./system-scheduler";
-export * from "./types";