refactor(entity): replace createComponentId with component function

Author: codehz

README.md

@@ -23,15 +23,15 @@ bun install
 
 ```typescript
 import { World } from "@codehz/ecs";
-import { createComponentId } from "@codehz/ecs";
+import { component } from "@codehz/ecs";
 
 // 定义组件类型
 type Position = { x: number; y: number };
 type Velocity = { x: number; y: number };
 
 // 定义组件ID
-const PositionId = createComponentId<Position>(1);
-const VelocityId = createComponentId<Velocity>(2);
+const PositionId = component<Position>(1);
+const VelocityId = component<Velocity>(2);
 
 // 创建世界
 const world = new World();
@@ -85,13 +85,13 @@ world.flushCommands(); // 钩子在这里被调用
 ECS 还支持通配符关系生命周期钩子，可以监听特定组件的所有关系变化：
 
 ```typescript
-import { World, createComponentId, relation } from "@codehz/ecs";
+import { World, component, relation } from "@codehz/ecs";
 
 // 定义组件类型
 type Position = { x: number; y: number };
 
 // 定义组件ID
-const PositionId = createComponentId<Position>(1);
+const PositionId = component<Position>(1);
 
 // 创建世界
 const world = new World();
@@ -147,7 +147,7 @@ bun run examples/simple/demo.ts
 
 ### Entity
 
-- `createComponentId<T>(id)`: 创建类型安全的组件ID
+- `component<T>(id)`: 分配类型安全的组件ID（上限：1022个）
 
 ### Query
 

examples/simple/demo.ts

@@ -1,4 +1,4 @@
-import { createComponentId } from "../../src/entity";
+import { component } from "../../src/entity";
 import type { Query } from "../../src/query";
 import type { System } from "../../src/system";
 import { World } from "../../src/world";
@@ -8,8 +8,8 @@ type Position = { x: number; y: number };
 type Velocity = { x: number; y: number };
 
 // 定义组件ID
-const PositionId = createComponentId<Position>(1);
-const VelocityId = createComponentId<Velocity>(2);
+const PositionId = component<Position>();
+const VelocityId = component<Velocity>();
 
 // 移动系统
 class MovementSystem implements System {

src/entity.test.ts

@@ -2,7 +2,7 @@ import { describe, expect, it } from "bun:test";
 import type { ComponentId, EntityId } from "./entity";
 import {
   COMPONENT_ID_MAX,
-  ComponentIdManager,
+  ComponentIdAllocator,
   createComponentId,
   createEntityId,
   relation,
@@ -373,22 +373,22 @@ describe("EntityIdManager", () => {
 describe("ComponentIdManager", () => {
   describe("Allocation", () => {
     it("should allocate sequential component IDs starting from 1", () => {
-      const manager = new ComponentIdManager();
+      const manager = new ComponentIdAllocator();
       expect(manager.allocate()).toBe(createComponentId(1));
       expect(manager.allocate()).toBe(createComponentId(2));
       expect(manager.allocate()).toBe(createComponentId(3));
     });
 
     it("should allocate up to COMPONENT_ID_MAX", () => {
-      const manager = new ComponentIdManager();
+      const manager = new ComponentIdAllocator();
       for (let i = 1; i <= COMPONENT_ID_MAX; i++) {
         expect(manager.allocate()).toBe(createComponentId(i));
       }
       expect(manager.hasAvailableIds()).toBe(false);
     });
 
     it("should throw error when exceeding maximum component IDs", () => {
-      const manager = new ComponentIdManager();
+      const manager = new ComponentIdAllocator();
       // Allocate all available IDs
       for (let i = 1; i <= COMPONENT_ID_MAX; i++) {
         manager.allocate();
@@ -399,7 +399,7 @@ describe("ComponentIdManager", () => {
 
   describe("State Queries", () => {
     it("should report correct next ID", () => {
-      const manager = new ComponentIdManager();
+      const manager = new ComponentIdAllocator();
       expect(manager.getNextId()).toBe(1);
       manager.allocate();
       expect(manager.getNextId()).toBe(2);
@@ -408,7 +408,7 @@ describe("ComponentIdManager", () => {
     });
 
     it("should correctly report available IDs", () => {
-      const manager = new ComponentIdManager();
+      const manager = new ComponentIdAllocator();
       expect(manager.hasAvailableIds()).toBe(true);
 
       // Allocate all but one

src/entity.ts

@@ -42,6 +42,7 @@ export const WILDCARD_TARGET_ID = 0;
 /**
  * Create a component ID
  * @param id Component identifier (1-1023)
+ * @see component
  */
 export function createComponentId<T = void>(id: number): ComponentId<T> {
   if (id < 1 || id > COMPONENT_ID_MAX) {
@@ -365,7 +366,7 @@ export class EntityIdManager {
  * Component ID Manager for automatic allocation
  * Components are typically registered once and not recycled
  */
-export class ComponentIdManager {
+export class ComponentIdAllocator {
   private nextId: number = 1;
 
   /**
@@ -395,3 +396,8 @@ export class ComponentIdManager {
     return this.nextId <= COMPONENT_ID_MAX;
   }
 }
+
+const globalComponentIdAllocator = new ComponentIdAllocator();
+export function component<T>(): ComponentId<T> {
+  return globalComponentIdAllocator.allocate<T>();
+}