ecspresso 0.19.2 → 0.20.0

package/dist/resource-manager.d.ts

@@ -135,13 +135,11 @@ export default class ResourceManager<ResourceTypes extends Record<string, any> =
     /**
      * Subscribe to changes for a specific resource key.
      *
-     * Subscribing marks the resource as "observed." Observed resources:
-     * - Are re-resolved each frame by `withResources` (no stale cache)
-     * - Are shallow-diffed at the end of each frame via `flushObserved()`,
-     *   so in-place mutations are detected and subscribers notified
+     * Subscribing marks the resource as "observed." Observed resources are
+     * shallow-diffed at the end of each frame via `flushObserved()`, so in-place
+     * mutations are detected and subscribers notified.
      *
-     * When the last subscriber unsubscribes, the resource reverts to
-     * normal (cached, no per-frame diff).
+     * When the last subscriber unsubscribes, per-frame diffing stops.
      *
      * @param key The resource key to watch
      * @param callback Function called with (newValue, oldValue) when the resource changes
@@ -158,8 +156,6 @@ export default class ResourceManager<ResourceTypes extends Record<string, any> =
     notifyChange<K extends keyof ResourceTypes>(key: K, newValue: ResourceTypes[K], oldValue: ResourceTypes[K]): void;
     /**
      * Whether a resource has active change subscribers.
-     * Observed resources should not be cached by systems — they need
-     * to be re-resolved each frame so external mutations are visible.
      */
     isObserved<K extends keyof ResourceTypes>(key: K): boolean;
     /**

package/dist/system-builder.d.ts

@@ -86,8 +86,8 @@ export declare class SystemBuilder<Cfg extends WorldConfig = EmptyConfig, Querie
      */
     runWhenEmpty(): this;
     /**
-     * Declare resource dependencies for this system. Resources are resolved
-     * once (on first process call) and the same object is reused every frame.
+     * Declare resource dependencies for this system. Resource values are resolved
+     * before each process call, while the containing object is reused every frame.
      * The resolved resources are available as ctx.resources in setProcess.
      * @param keys Array of resource keys to resolve
      * @returns This SystemBuilder instance for method chaining
@@ -229,7 +229,7 @@ type QueryResults<ComponentTypes extends Record<string, any>, Queries extends Re
  * Context object passed to system process functions.
  * Pre-allocated per system and reused every frame (zero per-frame allocation).
  * When resources are declared via withResources(), the context includes a
- * `resources` field with the resolved values (cached once on first call).
+ * `resources` field whose values are refreshed before each process call.
  */
 export type ProcessContext<Cfg extends WorldConfig, Queries extends Record<string, QueryDefinition<Cfg['components']>>, ResourceKeys extends keyof Cfg['resources'] = never, Singletons extends Record<string, QueryDefinition<Cfg['components']>> = {}> = {
     queries: QueryResults<Cfg['components'], Queries, Singletons>;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "ecspresso",
-	"version": "0.19.2",
+	"version": "0.20.0",
 	"main": "dist/index.js",
 	"module": "dist/index.js",
 	"types": "dist/index.d.ts",
@@ -182,15 +182,14 @@
 		"react": "^19.2.5",
 		"react-dom": "^19.2.5",
 		"three": "^0.184.0",
-		"typedoc": "^0.28.19"
+		"typedoc": "^0.28.19",
+		"typescript": "^6.0.3"
 	},
 	"peerDependencies": {
-		"typescript": "^6.0.3",
 		"pixi.js": "^8.0.0",
 		"howler": "^2.2.0",
 		"three": "^0.184.0",
-		"react": "^19.0.0",
-		"react-dom": "^19.0.0"
+		"react": "^19.0.0"
 	},
 	"peerDependenciesMeta": {
 		"pixi.js": {
@@ -204,9 +203,6 @@
 		},
 		"react": {
 			"optional": true
-		},
-		"react-dom": {
-			"optional": true
 		}
 	},
 	"files": [