ecspresso 0.8.0 → 0.9.0

package/dist/system-builder.d.ts

@@ -1,6 +1,6 @@
 import Bundle from "./bundle";
 import ECSpresso from "./ecspresso";
-import type { FilteredEntity, System } from "./types";
+import type { FilteredEntity, System, SystemPhase } from "./types";
 /**
  * Builder class for creating type-safe ECS Systems with proper query inference
  */
@@ -14,6 +14,7 @@ export declare class SystemBuilder<ComponentTypes extends Record<string, any> =
     private initializeFunction?;
     private eventHandlers?;
     private _priority;
+    private _phase;
     private _isRegistered;
     private _groups;
     private _inScreens?;
@@ -52,6 +53,14 @@ export declare class SystemBuilder<ComponentTypes extends Record<string, any> =
      * @returns This SystemBuilder instance for method chaining
      */
     setPriority(priority: number): this;
+    /**
+     * Set the execution phase for this system.
+     * Systems are grouped by phase and executed in order:
+     * preUpdate -> fixedUpdate -> update -> postUpdate -> render
+     * @param phase The phase to assign this system to (default: 'update')
+     * @returns This SystemBuilder instance for method chaining
+     */
+    inPhase(phase: SystemPhase): this;
     /**
      * Add this system to a group. Systems can belong to multiple groups.
      * When any group a system belongs to is disabled, the system will be skipped.
@@ -89,6 +98,7 @@ export declare class SystemBuilder<ComponentTypes extends Record<string, any> =
     addQuery<QueryName extends string, WithComponents extends keyof ComponentTypes, WithoutComponents extends keyof ComponentTypes = never, NewQueries extends Queries & Record<QueryName, QueryDefinition<ComponentTypes, WithComponents, WithoutComponents>> = Queries & Record<QueryName, QueryDefinition<ComponentTypes, WithComponents, WithoutComponents>>>(name: QueryName, definition: {
         with: ReadonlyArray<WithComponents>;
         without?: ReadonlyArray<WithoutComponents>;
+        changed?: ReadonlyArray<WithComponents>;
     }): this extends SystemBuilderWithEcspresso<ComponentTypes, EventTypes, ResourceTypes, Queries> ? SystemBuilderWithEcspresso<ComponentTypes, EventTypes, ResourceTypes, NewQueries> : this extends SystemBuilderWithBundle<ComponentTypes, EventTypes, ResourceTypes, Queries> ? SystemBuilderWithBundle<ComponentTypes, EventTypes, ResourceTypes, NewQueries> : SystemBuilder<ComponentTypes, EventTypes, ResourceTypes, NewQueries>;
     /**
      * Set the system's process function that runs each update
@@ -148,6 +158,7 @@ export declare function registerSystemWithEcspresso<ComponentTypes extends Recor
 type QueryDefinition<ComponentTypes, WithComponents extends keyof ComponentTypes = any, WithoutComponents extends keyof ComponentTypes = any> = {
     with: ReadonlyArray<WithComponents>;
     without?: ReadonlyArray<WithoutComponents>;
+    changed?: ReadonlyArray<WithComponents>;
 };
 type QueryResults<ComponentTypes, Queries extends Record<string, QueryDefinition<ComponentTypes>>> = {
     [QueryName in keyof Queries]: QueryName extends string ? FilteredEntity<ComponentTypes, Queries[QueryName] extends QueryDefinition<ComponentTypes, infer W, any> ? W : never, Queries[QueryName] extends QueryDefinition<ComponentTypes, any, infer WO> ? WO : never>[] : never;

package/dist/types.d.ts

@@ -1,4 +1,10 @@
 import ECSpresso from "./ecspresso";
+/**
+ * Execution phase for systems. Systems are grouped by phase and executed
+ * in this fixed order: preUpdate -> fixedUpdate -> update -> postUpdate -> render.
+ * Within each phase, systems are sorted by priority (higher first).
+ */
+export type SystemPhase = 'preUpdate' | 'fixedUpdate' | 'update' | 'postUpdate' | 'render';
 export interface Entity<ComponentTypes> {
     id: number;
     components: Partial<ComponentTypes>;
@@ -54,6 +60,7 @@ export interface FilteredEntity<ComponentTypes, WithComponents extends keyof Com
 export interface QueryConfig<ComponentTypes, WithComponents extends keyof ComponentTypes, WithoutComponents extends keyof ComponentTypes> {
     with: ReadonlyArray<WithComponents>;
     without?: ReadonlyArray<WithoutComponents>;
+    changed?: ReadonlyArray<WithComponents>;
 }
 /**
  * Utility type to derive the entity type that would result from a query definition.
@@ -79,6 +86,7 @@ export interface QueryConfig<ComponentTypes, WithComponents extends keyof Compon
 export type QueryResultEntity<ComponentTypes extends Record<string, any>, QueryDef extends {
     with: ReadonlyArray<keyof ComponentTypes>;
     without?: ReadonlyArray<keyof ComponentTypes>;
+    changed?: ReadonlyArray<keyof ComponentTypes>;
 }> = FilteredEntity<ComponentTypes, QueryDef['with'][number], QueryDef['without'] extends ReadonlyArray<any> ? QueryDef['without'][number] : never>;
 /**
  * Simplified query definition type for creating reusable queries
@@ -86,6 +94,7 @@ export type QueryResultEntity<ComponentTypes extends Record<string, any>, QueryD
 export type QueryDefinition<ComponentTypes extends Record<string, any>, WithComponents extends keyof ComponentTypes = keyof ComponentTypes, WithoutComponents extends keyof ComponentTypes = keyof ComponentTypes> = {
     with: ReadonlyArray<WithComponents>;
     without?: ReadonlyArray<WithoutComponents>;
+    changed?: ReadonlyArray<WithComponents>;
 };
 /**
  * Helper function to create a query definition with proper type inference.
@@ -117,6 +126,7 @@ export type QueryDefinition<ComponentTypes extends Record<string, any>, WithComp
 export declare function createQueryDefinition<ComponentTypes extends Record<string, any>, const QueryDef extends {
     with: ReadonlyArray<keyof ComponentTypes>;
     without?: ReadonlyArray<keyof ComponentTypes>;
+    changed?: ReadonlyArray<keyof ComponentTypes>;
 }>(queryDef: QueryDef): QueryDef;
 export interface System<ComponentTypes extends Record<string, any> = {}, WithComponents extends keyof ComponentTypes = never, WithoutComponents extends keyof ComponentTypes = never, EventTypes extends Record<string, any> = {}, ResourceTypes extends Record<string, any> = {}, AssetTypes extends Record<string, unknown> = {}, ScreenStates extends Record<string, any> = {}> {
     label: string;
@@ -125,6 +135,12 @@ export interface System<ComponentTypes extends Record<string, any> = {}, WithCom
      * When systems have the same priority, they execute in registration order
      */
     priority?: number;
+    /**
+     * Execution phase for this system (default: 'update')
+     * Systems are grouped by phase and executed in order:
+     * preUpdate -> fixedUpdate -> update -> postUpdate -> render
+     */
+    phase?: SystemPhase;
     /**
      * Groups this system belongs to. If any group is disabled, the system will be skipped.
      */

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "ecspresso",
-	"version": "0.8.0",
+	"version": "0.9.0",
 	"main": "dist/index.js",
 	"module": "dist/index.js",
 	"types": "dist/index.d.ts",