@codehz/ecs 0.7.0 → 0.7.1

package/README.en.md

@@ -204,8 +204,10 @@ world.sync();
 ### Running Examples
 
 ```bash
-bun run examples/simple/demo.ts
-bun run examples/advanced-scheduling/demo.ts
+bun run examples/simple.ts
+bun run examples/advanced-scheduling.ts
+bun run examples/parent-child-hierarchy.ts
+bun run examples/inventory-system-relations.ts
 ```
 
 ## API Overview
@@ -410,11 +412,14 @@ src/
 └── __tests__/               # Unit tests & performance tests
 
 examples/
-├── simple/
-│   ├── demo.ts              # Basic example
-│   └── README.md            # Example documentation
-└── advanced-scheduling/
-    └── demo.ts              # Pipeline scheduling example
+├── advanced-scheduling.ts    # Pipeline scheduling example
+├── collision-detection.ts    # Collision detection example
+├── parent-child-hierarchy.ts # Parent-child hierarchy and transform propagation example
+├── serialization.ts          # Serialization example
+├── simple.ts                 # Basic example
+├── spatial-grid.ts           # Spatial grid example
+├── state-machine.ts          # State machine example
+└── tag-filtering.ts          # Tag filtering example
 
 scripts/
 ├── build.ts                 # Build script
@@ -427,7 +432,8 @@ scripts/
 bun install
 bun test                    # Run tests
 bunx tsc --noEmit           # Type check
-bun run examples/simple/demo.ts  # Run example
+bun run examples/simple.ts       # Run example
+bun run examples/parent-child-hierarchy.ts
 bun run scripts/build.ts    # Build
 ```
 

package/README.md

@@ -204,8 +204,10 @@ world.sync();
 ### 运行示例
 
 ```bash
-bun run examples/simple/demo.ts
-bun run examples/advanced-scheduling/demo.ts
+bun run examples/simple.ts
+bun run examples/advanced-scheduling.ts
+bun run examples/parent-child-hierarchy.ts
+bun run examples/inventory-system-relations.ts
 ```
 
 ## API 概述
@@ -410,11 +412,14 @@ src/
 └── __tests__/               # 单元测试 & 性能测试
 
 examples/
-├── simple/
-│   ├── demo.ts              # 基本示例
-│   └── README.md            # 示例说明
-└── advanced-scheduling/
-    └── demo.ts              # Pipeline 调度示例
+├── advanced-scheduling.ts   # Pipeline 调度示例
+├── collision-detection.ts   # 碰撞检测示例
+├── parent-child-hierarchy.ts # 父子层级与 Transform 传播示例
+├── serialization.ts         # 序列化示例
+├── simple.ts                # 基本示例
+├── spatial-grid.ts          # 空间网格示例
+├── state-machine.ts         # 状态机示例
+└── tag-filtering.ts         # 标签过滤示例
 
 scripts/
 ├── build.ts                 # 构建脚本
@@ -427,7 +432,8 @@ scripts/
 bun install
 bun test                    # 运行测试
 bunx tsc --noEmit           # 类型检查
-bun run examples/simple/demo.ts  # 运行示例
+bun run examples/simple.ts       # 运行示例
+bun run examples/parent-child-hierarchy.ts
 bun run scripts/build.ts    # 构建
 ```
 

package/builder.d.mts

@@ -1070,6 +1070,9 @@ declare class World {
    * @overload getOptional<T>(entityId: EntityId<T>): { value: T } | undefined
    * Retrieves the entity's primary component safely.
    *
+   * @overload getOptional<T>(entityId: EntityId, componentType: WildcardRelationId<T>): { value: [EntityId<unknown>, T][] } | undefined
+   * Retrieves all matching relation values safely.
+   *
    * @overload getOptional<T>(entityId: EntityId, componentType: EntityId<T>): { value: T } | undefined
    * Retrieves a specific component safely.
    *
@@ -1084,6 +1087,9 @@ declare class World {
   getOptional<T>(entityId: EntityId<T>): {
     value: T;
   } | undefined;
+  getOptional<T>(entityId: EntityId, componentType: WildcardRelationId<T>): {
+    value: [EntityId<unknown>, T][];
+  } | undefined;
   getOptional<T>(entityId: EntityId, componentType: EntityId<T>): {
     value: T;
   } | undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codehz/ecs",
-  "version": "0.7.0",
+  "version": "0.7.1",
   "repository": {
     "url": "https://github.com/codehz/ecs"
   },