refactor(builder): deprecate withTag and withRelationTag methods

Make value parameter optional for void components in with() and
withRelation() methods, allowing simpler syntax like .with(TagId)
instead of .withTag(TagId). The deprecated methods remain for
backward compatibility.

Author: codehz

README.md

@@ -322,10 +322,8 @@ const restored = new World(readySnapshot);
 
 EntityBuilder 提供流式 API 用于便捷的实体创建：
 
-- `with(componentId, value)`: 添加组件到构建器
-- `withTag(componentId)`: 添加标记组件（无值）到构建器
-- `withRelation(componentId, targetEntity, value)`: 添加关系组件到构建器
-- `withRelationTag(componentId, targetEntity)`: 添加关系标记（无值）到构建器
+- `with(componentId, value?)`: 添加组件到构建器（对于 `void` 类型组件，value 参数可省略）
+- `withRelation(componentId, targetEntity, value?)`: 添加关系组件到构建器（对于 `void` 类型关系，value 参数可省略）
 - `build()`: 创建实体并应用所有组件（需要手动调用 `world.sync()`）
 
 ### World

src/__tests__/testing.test.ts

@@ -102,7 +102,7 @@ describe("testing module", () => {
 
     it("should support tag components", () => {
       const world = new World();
-      const entity = new EntityBuilder(world).withTag(TagId).build();
+      const entity = new EntityBuilder(world).with(TagId).build();
       world.sync();
 
       expect(world.has(entity, TagId)).toBe(true);
@@ -130,7 +130,7 @@ describe("testing module", () => {
       const parent = world.new();
       world.sync();
 
-      const child = new EntityBuilder(world).withRelationTag(ChildOfId, parent).build();
+      const child = new EntityBuilder(world).withRelation(ChildOfId, parent).build();
       world.sync();
 
       const relationId = relation(ChildOfId, parent);

src/core/builder.ts

@@ -21,21 +21,33 @@ export class EntityBuilder {
     this.world = world;
   }
 
-  with<T>(componentId: EntityId<T>, value: T): this {
+  with<T>(componentId: EntityId<T>, ...args: T extends void ? [] | [void] : [T]): this {
+    const value = (args.length > 0 ? args[0] : undefined) as T;
     this.components.push({ type: "component", id: componentId, value });
     return this;
   }
 
+  /**
+   * @deprecated Use `with(componentId)` instead for void components
+   */
   withTag(componentId: EntityId<void>): this {
     this.components.push({ type: "component", id: componentId, value: undefined as void });
     return this;
   }
 
-  withRelation<T>(componentId: ComponentId<T>, targetEntity: EntityId<any>, value: T): this {
+  withRelation<T>(
+    componentId: ComponentId<T>,
+    targetEntity: EntityId<any>,
+    ...args: T extends void ? [] | [void] : [T]
+  ): this {
+    const value = (args.length > 0 ? args[0] : undefined) as T;
     this.components.push({ type: "relation", componentId, targetId: targetEntity, value });
     return this;
   }
 
+  /**
+   * @deprecated Use `withRelation(componentId, targetEntity)` instead for void relations
+   */
   withRelationTag(componentId: ComponentId<void>, targetEntity: EntityId<any>): this {
     this.components.push({ type: "relation", componentId, targetId: targetEntity, value: undefined as void });
     return this;

src/testing/index.ts

@@ -216,7 +216,7 @@ export class WorldFixture {
  *
  * // Tag component (void type)
  * const tagged = new EntityBuilder(world)
- *   .withTag(PlayerTagId)
+ *   .with(PlayerTagId)
  *   .build();
  * ```
  */