@codehz/ecs 0.6.9 → 0.6.10

package/builder.d.mts

@@ -64,10 +64,11 @@ declare function decodeRelationId(relationId: RelationId<any>): {
 };
 //#endregion
 //#region src/core/component-registry.d.ts
+type ComponentMerge<T = any> = (prev: T, next: T) => T;
 /**
  * Component options that define intrinsic properties
  */
-interface ComponentOptions {
+interface ComponentOptions<T = any> {
   /**
    * Optional name for the component (for serialization/debugging)
    */
@@ -93,6 +94,10 @@ interface ComponentOptions {
    * Inspired by Flecs' DontFragment trait.
    */
   dontFragment?: boolean;
+  /**
+   * Custom merge behavior for repeated set() of the same componentType in a single sync batch.
+   */
+  merge?: ComponentMerge<T>;
 }
 /**
  * Allocate a new component ID from the global allocator.
@@ -108,7 +113,7 @@ interface ComponentOptions {
  * // With name and options
  * const ChildOf = component({ name: "ChildOf", exclusive: true });
  */
-declare function component<T = void>(nameOrOptions?: string | ComponentOptions): ComponentId<T>;
+declare function component<T = void>(nameOrOptions?: string | ComponentOptions<T>): ComponentId<T>;
 /**
  * Get a component ID by its registered name
  * @param name The component name
@@ -286,6 +291,7 @@ declare class Archetype {
   addEntity(entityId: EntityId, componentData: Map<EntityId<any>, any>): void;
   private addDontFragmentRelations;
   getEntity(entityId: EntityId): Map<EntityId<any>, any> | undefined;
+  getEntityDontFragmentRelations(entityId: EntityId): Map<EntityId<any>, any> | undefined;
   dump(): Array<{
     entity: EntityId;
     components: Map<EntityId<any>, any>;
@@ -457,9 +463,14 @@ declare class World {
   private relationEntityIdsByTarget;
   private queries;
   private queryCache;
-  private commandBuffer;
   private legacyHooks;
   private hooks;
+  private commandBuffer;
+  private readonly _changeset;
+  /** Cached command processor context to avoid per-entity object allocation */
+  private readonly _commandCtx;
+  /** Cached hooks context to avoid per-entity object allocation */
+  private readonly _hooksCtx;
   constructor(snapshot?: SerializedWorld);
   private deserializeSnapshot;
   private createArchetypeSignature;
@@ -495,6 +506,12 @@ declare class World {
    * }
    */
   exists(entityId: EntityId): boolean;
+  private assertEntityExists;
+  private assertComponentTypeValid;
+  private assertSetComponentTypeValid;
+  private resolveSetOperation;
+  private resolveRemoveOperation;
+  private getComponentEntityWildcardRelations;
   /**
    * Adds or updates a component on an entity (or marks void component as present).
    * The change is buffered and takes effect after calling `world.sync()`.

package/package.json

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