@oasys/oecs 0.5.4 → 0.6.0

package/dist/plugins/observers/observer_registry.d.ts

@@ -0,0 +1,101 @@
+import { ComponentHandle } from '../../core/ecs/component.js';
+import { SparseComponentDef } from '../../core/ecs/sparse_store.js';
+import { SystemContext } from '../../core/ecs/system_context.js';
+import { StructuralObserverEvents } from '../../core/ecs/store.js';
+import { SystemDescriptor } from '../../core/ecs/system.js';
+import { ObserverConfig, ObserverHandle, ObserverHooks, ObserverHost } from '../../core/ecs/observer.js';
+/**
+ * Registry of component observers. Owned by the observers plugin, which builds
+ * it at install. The store calls `dispatchStructural` through its structural
+ * hook between fixed-point rounds of `flushStructural`, and the world calls
+ * `dispatchSet` through the plugin's settle hook at the post-update detection
+ * point.
+ */
+export declare class ObserverRegistry implements ObserverHooks {
+    private readonly _store;
+    private readonly _ctx;
+    private readonly _entries;
+    /** ComponentID → its observers (structural + onSet). */
+    private readonly _byCid;
+    /** The entity-level onSet observers on sparse components, in registration
+     * order. */
+    private readonly _sparseEntries;
+    /** Per-`dispatchSet` cache of each sparse component's drain, so two
+     * observers on one sparse component fire over one snapshot. */
+    private readonly _sparseDrainCache;
+    /** Cached access-topological order. A register or a dispose invalidates it. */
+    private _topo;
+    private readonly _addBuckets;
+    private readonly _remBuckets;
+    private readonly _disBuckets;
+    private readonly _enaBuckets;
+    private _radixOut;
+    private readonly _radixC0;
+    private readonly _radixC1;
+    private readonly _setDrainCache;
+    constructor(_store: ObserverHost, _ctx: SystemContext);
+    get count(): number;
+    /** The synthesized `SystemDescriptor`s of every registered observer, in
+     * registration order (`dispose()` splices entries out, so none are stale).
+     * Fed into the `startup()` archetype-prewarm closure so an observer's declared
+     * `spawns` and `transitions` create their target archetypes eagerly, exactly as a
+     * system's do. Without this an archetype an observer spawns into or transitions to
+     * first-touches lazily mid-tick, the one asymmetry left in the otherwise
+     * uniform "no lazy archetypes" prewarm. */
+    descriptors(): SystemDescriptor[];
+    register(def: ComponentHandle | SparseComponentDef, config: ObserverConfig): ObserverHandle;
+    /** The sparse arm of `register`: an entity-level onSet, and nothing else.
+     * A sparse add and remove are immediate and touch no archetype, so there
+     * is no flush boundary to fire a structural observer at, and no archetype
+     * column for the archetype grain. */
+    private _registerSparse;
+    private _dispose;
+    /** Recompute the component's hot-path observation flags from its live
+     * observers and push them to the store (which owns the flags + fast-path
+     * counters). */
+    private _reconfigureComponent;
+    private _getTopo;
+    /**
+     * Fire onAdd, onRemove, onDisable and onEnable for one fixed-point round's
+     * effective events, in canonical order: access-topological across observers,
+     * entity-id order (radix) within each observer. Called through the store's
+     * structural hook after the batch commits. Observer callbacks may
+     * enqueue further structural ops (or toggles) onto the deferred buffers (the
+     * store loops until quiescent).
+     *
+     * The events arrive as flat `(comp, eid)` parallel arrays collected during the
+     * flush. This dispatch buckets by component once (O(K)), then walks observers
+     * in topo order so a producer's writes are visible to a consumer
+     * (glitch-free). A round
+     * carries either structural (add, remove) or toggle (disable, enable) events, never both,
+     * toggles drain only once add, remove and destroy are quiescent (`flushStructural`),
+     * but all four bucket uniformly. The empty pairs are no-ops. Within an
+     * observer the fire order is remove, add, disable, enable (the "leaving" edges
+     * before the "entering" edges).
+     */
+    dispatchStructural(ev: StructuralObserverEvents): void;
+    /** Radix-sort `eids` by entity index (canonical within-observer order), then
+     * fire `fn` per entity under the observer's access scope. */
+    private _fireEach;
+    private _bucket;
+    private _clearBuckets;
+    /**
+     * Fire onSet observers for the current frame, in canonical order. Per-entity
+     * onSet drains the opt-in dirty list, once for each changed entity.
+     * Archetype-granular onSet scans the change tick, once for each changed
+     * archetype column.
+     * Called through the plugin's settle hook, after every phase of the frame.
+     * `run` is the change tick advanced
+     * for this dispatch: above every system run of the frame, and the baseline
+     * each archetype-granular observer keeps for its next dispatch.
+     */
+    dispatchSet(run: number): void;
+    /** Fire one sparse observer over the members recorded since the last
+     * drain. The store's walk gives alive, member and enabled entities, so no
+     * check remains here. Canonical order by entity index, through the radix. */
+    private _dispatchSparseSet;
+    private _dispatchSetEntity;
+    private _dispatchSetArch;
+    private _yieldExisting;
+}
+//# sourceMappingURL=observer_registry.d.ts.map

package/dist/plugins/observers/observer_registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observer_registry.d.ts","sourceRoot":"","sources":["../../../src/plugins/observers/observer_registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAkDK;AAGL,OAAO,KAAK,EAAgB,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC9E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAGtE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,KAAK,EAAe,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAClF,OAAO,EAIN,KAAK,gBAAgB,EACrB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAEX,cAAc,EAEd,cAAc,EACd,aAAa,EACb,YAAY,EACZ,MAAM,yBAAyB,CAAC;AAwIjC;;;;;;GAMG;AACH,qBAAa,gBAAiB,YAAW,aAAa;IAqCpD,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,IAAI;IArCtB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAuB;IAChD,wDAAwD;IACxD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsC;IAC7D;gBACY;IACZ,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAwB;IACvD;mEAC+D;IAC/D,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAiC;IACnE,+EAA+E;IAC/E,OAAO,CAAC,KAAK,CAAgC;IAI7C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA+B;IAC3D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA+B;IAI3D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA+B;IAC3D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA+B;IAK3D,OAAO,CAAC,SAAS,CAAyB;IAC1C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAwB;IACjD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAwB;IAMjD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAkC;gBAG/C,MAAM,EAAE,YAAY,EACpB,IAAI,EAAE,aAAa;IAGrC,IAAI,KAAK,IAAI,MAAM,CAElB;IAED;;;;;;+CAM2C;IAC3C,WAAW,IAAI,gBAAgB,EAAE;IAQjC,QAAQ,CAAC,GAAG,EAAE,eAAe,GAAG,kBAAkB,EAAE,MAAM,EAAE,cAAc,GAAG,cAAc;IA4E3F;;;yCAGqC;IACrC,OAAO,CAAC,eAAe;IAwCvB,OAAO,CAAC,QAAQ;IAehB;;oBAEgB;IAChB,OAAO,CAAC,qBAAqB;IA0B7B,OAAO,CAAC,QAAQ;IAShB;;;;;;;;;;;;;;;;;OAiBG;IACH,kBAAkB,CAAC,EAAE,EAAE,wBAAwB,GAAG,IAAI;IA4CtD;iEAC6D;IAC7D,OAAO,CAAC,SAAS;IAcjB,OAAO,CAAC,OAAO;IAYf,OAAO,CAAC,aAAa;IAQrB;;;;;;;;;OASG;IACH,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IA2B9B;;iFAE6E;IAC7E,OAAO,CAAC,kBAAkB;IAwB1B,OAAO,CAAC,kBAAkB;IA0D1B,OAAO,CAAC,gBAAgB;IAyBxB,OAAO,CAAC,cAAc;CA0BtB"}

package/dist/plugins/observers.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const S=require("../index.cjs"),E=require("./assertions-z5GQd_bB.cjs"),O=require("../internal.cjs"),u=require("./arrays-Dt-Joc4i.cjs"),f=!1,C=a=>E.unsafeCast(a),k=Object.freeze({reads:Object.freeze([]),writes:Object.freeze([]),spawns:Object.freeze([]),despawns:Object.freeze([]),transitions:Object.freeze([]),resourceReads:Object.freeze([]),resourceWrites:Object.freeze([]),sparseReads:Object.freeze([]),sparseWrites:Object.freeze([]),relationReads:Object.freeze([]),relationWrites:Object.freeze([])}),b="observers",g=Symbol.dispose??Symbol.for("Symbol.dispose"),y=(1<<20)-1;let w=0;function x(a,e){const t={...k,...e,id:C(w++),name:a,fn:B};return Object.freeze(t)}function B(){}function v(a){const e=new Set;if(a)for(let t=0;t<a.length;t++)e.add(a[t].id);return e}function R(a){const e=(n,o)=>n.cid-o.cid||n.id-o.id,t=new Map,i=new Map;for(const n of a)t.set(n,[]),i.set(n,0);for(const n of a)if(n.writes.size!==0)for(const o of a){if(n===o)continue;let d=!1;for(const c of n.writes)if(o.reads.has(c)){d=!0;break}d&&(t.get(n).push(o),i.set(o,i.get(o)+1))}const s=a.filter(n=>i.get(n)===0).sort(e),r=[];for(;s.length>0;){const n=s.shift();r.push(n);for(const o of t.get(n)){const d=i.get(o)-1;i.set(o,d),d===0&&(s.push(o),s.sort(e))}}if(r.length!==a.length){const n=new Set(r);for(const o of a.slice().sort(e))n.has(o)||r.push(o)}return r}class m{constructor(e,t){this._store=e,this._ctx=t}_entries=[];_byCid=new Map;_sparseEntries=[];_sparseDrainCache=new Map;_topo=null;_addBuckets=new Map;_remBuckets=new Map;_disBuckets=new Map;_enaBuckets=new Map;_radixOut=new Uint32Array(1024);_radixC0=new Int32Array(1024);_radixC1=new Int32Array(1024);_setDrainCache=new Map;get count(){return this._entries.length+this._sparseEntries.length}descriptors(){const e=[];for(let t=0;t<this._entries.length;t++)e.push(this._entries[t].descriptor);for(let t=0;t<this._sparseEntries.length;t++)e.push(this._sparseEntries[t].descriptor);return e}register(e,t){if(typeof e=="number")return this._registerSparse(e,t);const i=e.id;if(typeof i!="number")throw new S.ECSError(S.ECS_ERROR.OBSERVER_INVALID_CONFIG,"observe(): the definition is not a registered component. Observe a dense or a sparse component");const s=t.granularity??"archetype",r=t.onSet!==void 0&&s==="entity",n=t.onSet!==void 0&&s!=="entity",o=t.access??{},d=x(t.name??`observer(${O.componentDebugName(e)??i})`,o),c={id:d.id,cid:i,def:e,onAdd:t.onAdd,onRemove:t.onRemove,onDisable:t.onDisable,onEnable:t.onEnable,onSetEntity:r?t.onSet:void 0,onSetArch:n?t.onSet:void 0,descriptor:d,writes:v(o.writes),reads:v(o.reads),yieldExisting:t.yieldExisting??!1,lastSetTick:0,disposed:!1};this._entries.push(c);let l=this._byCid.get(i);l===void 0&&(l=[],this._byCid.set(i,l)),l.push(c),this._topo=null,this._reconfigureComponent(i),c.yieldExisting&&c.onAdd!==void 0&&this._yieldExisting(c);const h=()=>this._dispose(c);return{dispose:h,[g]:h}}_registerSparse(e,t){if(t.onSet===void 0||t.granularity!=="entity"||t.onAdd!==void 0||t.onRemove!==void 0||t.onDisable!==void 0||t.onEnable!==void 0)throw new S.ECSError(S.ECS_ERROR.OBSERVER_INVALID_CONFIG,'observe(): a sparse component takes onSet with granularity "entity" and no other callback. Move onAdd, onRemove, onDisable, onEnable and the archetype grain to a dense component');const i=x(t.name??`observer(sparse ${e})`,t.access??{}),s={id:i.id,sid:e,onSet:t.onSet,descriptor:i,disposed:!1};this._sparseEntries.push(s),this._store.configureSparseObservation(b,e,!0);const r=()=>{if(s.disposed)return;s.disposed=!0;const n=this._sparseEntries.indexOf(s);n>=0&&this._sparseEntries.splice(n,1);let o=!1;for(let d=0;d<this._sparseEntries.length;d++)this._sparseEntries[d].sid===e&&(o=!0);o||this._store.configureSparseObservation(b,e,!1)};return{dispose:r,[g]:r}}_dispose(e){if(e.disposed)return;e.disposed=!0;const t=this._entries.indexOf(e);t>=0&&this._entries.splice(t,1);const i=this._byCid.get(e.cid);if(i!==void 0){const s=i.indexOf(e);s>=0&&i.splice(s,1),i.length===0&&this._byCid.delete(e.cid)}this._topo=null,this._reconfigureComponent(e.cid)}_reconfigureComponent(e){const t=this._byCid.get(e);let i=!1,s=!1,r=!1,n=!1,o=!1;if(t!==void 0)for(let d=0;d<t.length;d++){const c=t[d];c.onAdd!==void 0&&(i=!0),c.onRemove!==void 0&&(s=!0),c.onDisable!==void 0&&(r=!0),c.onEnable!==void 0&&(n=!0),c.onSetEntity!==void 0&&(o=!0)}this._store.configureObservation(b,e,{add:i,remove:s,disable:r,enable:n,set:o})}_getTopo(){return this._topo===null&&(this._topo=R(this._entries)),this._topo}dispatchStructural(e){this._bucket(e.addComp,e.addEid,e.addLen,this._addBuckets),this._bucket(e.remComp,e.remEid,e.remLen,this._remBuckets),this._bucket(e.disComp,e.disEid,e.disLen,this._disBuckets),this._bucket(e.enaComp,e.enaEid,e.enaLen,this._enaBuckets);const t=this._getTopo();for(let i=0;i<t.length;i++){const s=t[i];if(!s.disposed){if(s.onRemove!==void 0){const r=this._remBuckets.get(s.cid);r!==void 0&&r.length>0&&this._fireEach(s,s.onRemove,r,"remove")}if(s.onAdd!==void 0){const r=this._addBuckets.get(s.cid);r!==void 0&&r.length>0&&this._fireEach(s,s.onAdd,r,"add")}if(s.onDisable!==void 0){const r=this._disBuckets.get(s.cid);r!==void 0&&r.length>0&&this._fireEach(s,s.onDisable,r,"disable")}if(s.onEnable!==void 0){const r=this._enaBuckets.get(s.cid);r!==void 0&&r.length>0&&this._fireEach(s,s.onEnable,r,"enable")}}}this._clearBuckets(this._addBuckets),this._clearBuckets(this._remBuckets),this._clearBuckets(this._disBuckets),this._clearBuckets(this._enaBuckets)}_fireEach(e,t,i,s){this._radixOut=u.radixSortByIndex(i,this._radixOut,this._radixC0,this._radixC1);try{const r=f?this._store.trace:null;for(let n=0;n<i.length;n++)t(E.unsafeCast(i[n]),this._ctx)}finally{}}_bucket(e,t,i,s){for(let r=0;r<i;r++){const n=e[r];let o=s.get(n);o===void 0&&(o=[],s.set(n,o)),o.push(t[r])}}_clearBuckets(e){for(const t of e.values())t.length=0}dispatchSet(e){if(this._entries.length===0&&this._sparseEntries.length===0)return;const t=this._getTopo(),i=this._setDrainCache;for(let r=0;r<t.length;r++){const n=t[r];n.onSetEntity!==void 0?this._dispatchSetEntity(n,i,e):n.onSetArch!==void 0&&this._dispatchSetArch(n,e)}i.clear();const s=this._sparseEntries;if(s.length!==0){const r=this._sparseDrainCache;for(let n=0;n<s.length;n++){const o=s[n];o.disposed||this._dispatchSparseSet(o,r,e)}r.clear()}}_dispatchSparseSet(e,t,i){let s=t.get(e.sid);if(s===void 0&&(s=this._store.drainSparseSet(e.sid,i),this._radixOut=u.radixSortByIndex(s,this._radixOut,this._radixC0,this._radixC1),t.set(e.sid,s)),s.length===0)return;const r=e.onSet;try{for(let n=0;n<s.length;n++)r(s[n],this._ctx)}finally{}}_dispatchSetEntity(e,t,i){let s=t.get(e.cid);s===void 0&&(s=this._store.drainSet(e.cid,i),this._radixOut=u.radixSortByIndex(s.scanned,this._radixOut,this._radixC0,this._radixC1),this._radixOut=u.radixSortByIndex(s.listed,this._radixOut,this._radixC0,this._radixC1),A(s.listed),t.set(e.cid,s));const r=s.scanned,n=s.listed,o=r.length,d=n.length;if(o===0&&d===0)return;const c=e.def,l=e.onSetEntity;try{let h=0,p=0;for(;h<o||p<d;){let _;if(p>=d||h<o&&(r[h]&y)<(n[p]&y))_=r[h++];else if(_=n[p++],!this._store.isAlive(_)||!this._store.hasComponent(_,c)||this._store.isDisabled(_))continue;l(_,this._ctx)}}finally{}}_dispatchSetArch(e,t){const i=e.onSetArch,s=e.lastSetTick;try{this._store.forEachChangedArchetype(e.cid,s,r=>{i(r,this._ctx)})}finally{}e.lastSetTick=t}_yieldExisting(e){const t=e.onAdd,i=this._store.collectEnabledWith(e.cid);if(i.length!==0){this._radixOut=u.radixSortByIndex(i,this._radixOut,this._radixC0,this._radixC1);try{for(let s=0;s<i.length;s++)t(E.unsafeCast(i[s]),this._ctx)}finally{}}}}function A(a){const e=a.length;if(e<2)return;let t=1;for(let i=1;i<e;i++)a[i]!==a[t-1]&&(a[t++]=a[i]);a.length=t}function D(){return{name:"observers",install(a){const e=new m(a.store,a.context);return a.onSettle(t=>e.dispatchSet(t)),a.onPrewarm(()=>e.descriptors()),a.changes.addStructuralHook(t=>e.dispatchStructural(t)),{observe(t,i){return e.register(t,i)}}}}}exports.ObserverRegistry=m;exports.observers=D;

package/dist/plugins/observers.d.cts

@@ -0,0 +1 @@
+export * from "./observers/index.cjs";

package/dist/plugins/observers.d.ts

@@ -0,0 +1 @@
+export * from "./observers/index.js";

package/dist/plugins/observers.development.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const l=require("../index.development.cjs"),v=require("./assertions-z5GQd_bB.cjs"),d=require("../internal.development.cjs"),p=require("./arrays-Dt-Joc4i.cjs"),S=!0,O=c=>{if(!(Number.isInteger(c)&&c>=0))throw new l.ECSError(l.ECS_ERROR.INVALID_SYSTEM_ID,`system id must be an integer >= 0, got ${c}`);return v.unsafeCast(c)},x=Object.freeze({reads:Object.freeze([]),writes:Object.freeze([]),spawns:Object.freeze([]),despawns:Object.freeze([]),transitions:Object.freeze([]),resourceReads:Object.freeze([]),resourceWrites:Object.freeze([]),sparseReads:Object.freeze([]),sparseWrites:Object.freeze([]),relationReads:Object.freeze([]),relationWrites:Object.freeze([])}),b="observers",C=Symbol.dispose??Symbol.for("Symbol.dispose"),y=(1<<20)-1;let R=0;function g(c,e){const t={...x,...e,id:O(R++),name:c,fn:w};return Object.freeze(t)}function w(){}function k(c){const e=new Set;if(c)for(let t=0;t<c.length;t++)e.add(c[t].id);return e}function A(c){const e=(s,o)=>s.cid-o.cid||s.id-o.id,t=new Map,i=new Map;for(const s of c)t.set(s,[]),i.set(s,0);for(const s of c)if(s.writes.size!==0)for(const o of c){if(s===o)continue;let a=!1;for(const h of s.writes)if(o.reads.has(h)){a=!0;break}a&&(t.get(s).push(o),i.set(o,i.get(o)+1))}const n=c.filter(s=>i.get(s)===0).sort(e),r=[];for(;n.length>0;){const s=n.shift();r.push(s);for(const o of t.get(s)){const a=i.get(o)-1;i.set(o,a),a===0&&(n.push(o),n.sort(e))}}if(r.length!==c.length){const s=new Set(r);for(const o of c.slice().sort(e))s.has(o)||r.push(o)}return r}class m{constructor(e,t){this._store=e,this._ctx=t}_entries=[];_byCid=new Map;_sparseEntries=[];_sparseDrainCache=new Map;_topo=null;_addBuckets=new Map;_remBuckets=new Map;_disBuckets=new Map;_enaBuckets=new Map;_radixOut=new Uint32Array(1024);_radixC0=new Int32Array(1024);_radixC1=new Int32Array(1024);_setDrainCache=new Map;get count(){return this._entries.length+this._sparseEntries.length}descriptors(){const e=[];for(let t=0;t<this._entries.length;t++)e.push(this._entries[t].descriptor);for(let t=0;t<this._sparseEntries.length;t++)e.push(this._sparseEntries[t].descriptor);return e}register(e,t){if(typeof e=="number")return this._registerSparse(e,t);const i=e.id;if(typeof i!="number")throw new l.ECSError(l.ECS_ERROR.OBSERVER_INVALID_CONFIG,"observe(): the definition is not a registered component. Observe a dense or a sparse component");const n=t.granularity??"archetype",r=t.onSet!==void 0&&n==="entity",s=t.onSet!==void 0&&n!=="entity";if(t.onSet===void 0&&t.granularity!==void 0)throw new l.ECSError(l.ECS_ERROR.OBSERVER_INVALID_CONFIG,"observe(): `granularity` is meaningless without `onSet`");if(t.onAdd===void 0&&t.onRemove===void 0&&t.onDisable===void 0&&t.onEnable===void 0&&t.onSet===void 0)throw new l.ECSError(l.ECS_ERROR.OBSERVER_INVALID_CONFIG,"observe(): at least one of onAdd, onRemove, onDisable, onEnable and onSet is required");const o=t.access??{},a=g(t.name??`observer(${d.componentDebugName(e)??i})`,o),h={id:a.id,cid:i,def:e,onAdd:t.onAdd,onRemove:t.onRemove,onDisable:t.onDisable,onEnable:t.onEnable,onSetEntity:r?t.onSet:void 0,onSetArch:s?t.onSet:void 0,descriptor:a,writes:k(o.writes),reads:k(o.reads),yieldExisting:t.yieldExisting??!1,lastSetTick:0,disposed:!1};this._entries.push(h);let f=this._byCid.get(i);f===void 0&&(f=[],this._byCid.set(i,f)),f.push(h),this._topo=null,this._reconfigureComponent(i),h.yieldExisting&&h.onAdd!==void 0&&this._yieldExisting(h);const _=()=>this._dispose(h);return{dispose:_,[C]:_}}_registerSparse(e,t){if(t.onSet===void 0||t.granularity!=="entity"||t.onAdd!==void 0||t.onRemove!==void 0||t.onDisable!==void 0||t.onEnable!==void 0)throw new l.ECSError(l.ECS_ERROR.OBSERVER_INVALID_CONFIG,'observe(): a sparse component takes onSet with granularity "entity" and no other callback. Move onAdd, onRemove, onDisable, onEnable and the archetype grain to a dense component');const i=g(t.name??`observer(sparse ${e})`,t.access??{}),n={id:i.id,sid:e,onSet:t.onSet,descriptor:i,disposed:!1};this._sparseEntries.push(n),this._store.configureSparseObservation(b,e,!0);const r=()=>{if(n.disposed)return;n.disposed=!0;const s=this._sparseEntries.indexOf(n);s>=0&&this._sparseEntries.splice(s,1);let o=!1;for(let a=0;a<this._sparseEntries.length;a++)this._sparseEntries[a].sid===e&&(o=!0);o||this._store.configureSparseObservation(b,e,!1)};return{dispose:r,[C]:r}}_dispose(e){if(e.disposed)return;e.disposed=!0;const t=this._entries.indexOf(e);t>=0&&this._entries.splice(t,1);const i=this._byCid.get(e.cid);if(i!==void 0){const n=i.indexOf(e);n>=0&&i.splice(n,1),i.length===0&&this._byCid.delete(e.cid)}this._topo=null,this._reconfigureComponent(e.cid)}_reconfigureComponent(e){const t=this._byCid.get(e);let i=!1,n=!1,r=!1,s=!1,o=!1;if(t!==void 0)for(let a=0;a<t.length;a++){const h=t[a];h.onAdd!==void 0&&(i=!0),h.onRemove!==void 0&&(n=!0),h.onDisable!==void 0&&(r=!0),h.onEnable!==void 0&&(s=!0),h.onSetEntity!==void 0&&(o=!0)}this._store.configureObservation(b,e,{add:i,remove:n,disable:r,enable:s,set:o})}_getTopo(){return this._topo===null&&(this._topo=A(this._entries)),this._topo}dispatchStructural(e){this._bucket(e.addComp,e.addEid,e.addLen,this._addBuckets),this._bucket(e.remComp,e.remEid,e.remLen,this._remBuckets),this._bucket(e.disComp,e.disEid,e.disLen,this._disBuckets),this._bucket(e.enaComp,e.enaEid,e.enaLen,this._enaBuckets);const t=this._getTopo(),i=d.accessCheck.current();for(let n=0;n<t.length;n++){const r=t[n];if(!r.disposed){if(r.onRemove!==void 0){const s=this._remBuckets.get(r.cid);s!==void 0&&s.length>0&&this._fireEach(r,r.onRemove,s,"remove")}if(r.onAdd!==void 0){const s=this._addBuckets.get(r.cid);s!==void 0&&s.length>0&&this._fireEach(r,r.onAdd,s,"add")}if(r.onDisable!==void 0){const s=this._disBuckets.get(r.cid);s!==void 0&&s.length>0&&this._fireEach(r,r.onDisable,s,"disable")}if(r.onEnable!==void 0){const s=this._enaBuckets.get(r.cid);s!==void 0&&s.length>0&&this._fireEach(r,r.onEnable,s,"enable")}}}i!==null&&d.accessCheck.enter(i),this._clearBuckets(this._addBuckets),this._clearBuckets(this._remBuckets),this._clearBuckets(this._disBuckets),this._clearBuckets(this._enaBuckets)}_fireEach(e,t,i,n){this._radixOut=p.radixSortByIndex(i,this._radixOut,this._radixC0,this._radixC1),d.accessCheck.enter(e.descriptor);try{const r=S?this._store.trace:null;for(let s=0;s<i.length;s++)t(v.unsafeCast(i[s]),this._ctx),S&&r?.observerFired(n,e.cid,i[s],e.descriptor)}finally{d.accessCheck.leave()}}_bucket(e,t,i,n){for(let r=0;r<i;r++){const s=e[r];let o=n.get(s);o===void 0&&(o=[],n.set(s,o)),o.push(t[r])}}_clearBuckets(e){for(const t of e.values())t.length=0}dispatchSet(e){if(this._entries.length===0&&this._sparseEntries.length===0)return;const t=d.accessCheck.current(),i=this._getTopo(),n=this._setDrainCache;for(let s=0;s<i.length;s++){const o=i[s];o.onSetEntity!==void 0?this._dispatchSetEntity(o,n,e):o.onSetArch!==void 0&&this._dispatchSetArch(o,e)}n.clear();const r=this._sparseEntries;if(r.length!==0){const s=this._sparseDrainCache;for(let o=0;o<r.length;o++){const a=r[o];a.disposed||this._dispatchSparseSet(a,s,e)}s.clear()}t!==null&&d.accessCheck.enter(t)}_dispatchSparseSet(e,t,i){let n=t.get(e.sid);if(n===void 0&&(n=this._store.drainSparseSet(e.sid,i),this._radixOut=p.radixSortByIndex(n,this._radixOut,this._radixC0,this._radixC1),t.set(e.sid,n)),n.length===0)return;const r=e.onSet;d.accessCheck.enter(e.descriptor);try{for(let s=0;s<n.length;s++)r(n[s],this._ctx),S&&this._store.trace?.observerFired("set",e.sid,n[s],e.descriptor)}finally{d.accessCheck.leave()}}_dispatchSetEntity(e,t,i){let n=t.get(e.cid);n===void 0&&(n=this._store.drainSet(e.cid,i),this._radixOut=p.radixSortByIndex(n.scanned,this._radixOut,this._radixC0,this._radixC1),this._radixOut=p.radixSortByIndex(n.listed,this._radixOut,this._radixC0,this._radixC1),B(n.listed),t.set(e.cid,n));const r=n.scanned,s=n.listed,o=r.length,a=s.length;if(o===0&&a===0)return;const h=e.def,f=e.onSetEntity;d.accessCheck.enter(e.descriptor);try{let _=0,E=0;for(;_<o||E<a;){let u;if(E>=a||_<o&&(r[_]&y)<(s[E]&y))u=r[_++];else if(u=s[E++],!this._store.isAlive(u)||!this._store.hasComponent(u,h)||this._store.isDisabled(u))continue;f(u,this._ctx),S&&this._store.trace?.observerFired("set",e.cid,u,e.descriptor)}}finally{d.accessCheck.leave()}}_dispatchSetArch(e,t){const i=e.onSetArch,n=e.lastSetTick;d.accessCheck.enter(e.descriptor);try{this._store.forEachChangedArchetype(e.cid,n,r=>{i(r,this._ctx),S&&this._store.trace?.observerFired("set",e.cid,-1,e.descriptor)})}finally{d.accessCheck.leave()}e.lastSetTick=t}_yieldExisting(e){const t=e.onAdd,i=this._store.collectEnabledWith(e.cid);if(i.length===0)return;this._radixOut=p.radixSortByIndex(i,this._radixOut,this._radixC0,this._radixC1);const n=d.accessCheck.current();d.accessCheck.enter(e.descriptor);try{for(let r=0;r<i.length;r++)t(v.unsafeCast(i[r]),this._ctx)}finally{d.accessCheck.leave(),n!==null&&d.accessCheck.enter(n)}}}function B(c){const e=c.length;if(e<2)return;let t=1;for(let i=1;i<e;i++)c[i]!==c[t-1]&&(c[t++]=c[i]);c.length=t}function I(){return{name:"observers",install(c){const e=new m(c.store,c.context);return c.onSettle(t=>e.dispatchSet(t)),c.onPrewarm(()=>e.descriptors()),c.changes.addStructuralHook(t=>e.dispatchStructural(t)),{observe(t,i){return e.register(t,i)}}}}}exports.ObserverRegistry=m;exports.observers=I;

package/dist/plugins/observers.development.js

@@ -0,0 +1,431 @@
+import { ECSError as S, ECS_ERROR as v } from "../index.development.js";
+import { u as m } from "./assertions-gtDVfbnQ.js";
+import { componentDebugName as C, accessCheck as h } from "../internal.development.js";
+import { r as p } from "./arrays-Dr_1hCjL.js";
+const f = !0, k = (d) => {
+  if (!(Number.isInteger(d) && d >= 0))
+    throw new S(
+      v.INVALID_SYSTEM_ID,
+      `system id must be an integer >= 0, got ${d}`
+    );
+  return m(d);
+}, w = Object.freeze({
+  reads: Object.freeze([]),
+  writes: Object.freeze([]),
+  spawns: Object.freeze([]),
+  despawns: Object.freeze([]),
+  transitions: Object.freeze([]),
+  resourceReads: Object.freeze([]),
+  resourceWrites: Object.freeze([]),
+  sparseReads: Object.freeze([]),
+  sparseWrites: Object.freeze([]),
+  relationReads: Object.freeze([]),
+  relationWrites: Object.freeze([])
+}), b = "observers", g = Symbol.dispose ?? Symbol.for("Symbol.dispose"), y = (1 << 20) - 1;
+let A = 0;
+function O(d, e) {
+  const t = {
+    ...w,
+    ...e,
+    id: k(A++),
+    name: d,
+    fn: R
+  };
+  return Object.freeze(t);
+}
+function R() {
+}
+function x(d) {
+  const e = /* @__PURE__ */ new Set();
+  if (d) for (let t = 0; t < d.length; t++) e.add(d[t].id);
+  return e;
+}
+function B(d) {
+  const e = (s, o) => s.cid - o.cid || s.id - o.id, t = /* @__PURE__ */ new Map(), i = /* @__PURE__ */ new Map();
+  for (const s of d)
+    t.set(s, []), i.set(s, 0);
+  for (const s of d)
+    if (s.writes.size !== 0)
+      for (const o of d) {
+        if (s === o) continue;
+        let a = !1;
+        for (const c of s.writes)
+          if (o.reads.has(c)) {
+            a = !0;
+            break;
+          }
+        a && (t.get(s).push(o), i.set(o, i.get(o) + 1));
+      }
+  const n = d.filter((s) => i.get(s) === 0).sort(e), r = [];
+  for (; n.length > 0; ) {
+    const s = n.shift();
+    r.push(s);
+    for (const o of t.get(s)) {
+      const a = i.get(o) - 1;
+      i.set(o, a), a === 0 && (n.push(o), n.sort(e));
+    }
+  }
+  if (r.length !== d.length) {
+    const s = new Set(r);
+    for (const o of d.slice().sort(e)) s.has(o) || r.push(o);
+  }
+  return r;
+}
+class D {
+  constructor(e, t) {
+    this._store = e, this._ctx = t;
+  }
+  _entries = [];
+  /** ComponentID → its observers (structural + onSet). */
+  _byCid = /* @__PURE__ */ new Map();
+  /** The entity-level onSet observers on sparse components, in registration
+   * order. */
+  _sparseEntries = [];
+  /** Per-`dispatchSet` cache of each sparse component's drain, so two
+   * observers on one sparse component fire over one snapshot. */
+  _sparseDrainCache = /* @__PURE__ */ new Map();
+  /** Cached access-topological order. A register or a dispose invalidates it. */
+  _topo = null;
+  // --- dispatch scratch (reused, never reallocated in the hot loop) ---
+  // Per-component eid buckets for the current structural round, keyed by cid.
+  _addBuckets = /* @__PURE__ */ new Map();
+  _remBuckets = /* @__PURE__ */ new Map();
+  // Disable and enable buckets, populated only on a toggle-drain round
+  // (toggles drain once add, remove and destroy are quiescent, so a round carries
+  // either structural events or toggle events, never both).
+  _disBuckets = /* @__PURE__ */ new Map();
+  _enaBuckets = /* @__PURE__ */ new Map();
+  // The radix scratch is a typed array, grown by doubling, and never a plain
+  // array grown by a length assignment: JavaScriptCore turns the latter into a
+  // sparse store, and each element store in the pass becomes a hash insert.
+  // The drain of a large frame is far slower there for that reason.
+  _radixOut = new Uint32Array(1024);
+  _radixC0 = new Int32Array(1024);
+  _radixC1 = new Int32Array(1024);
+  // Per-`dispatchSet` cache of each component's drain, so a component with
+  // more than one per-entity onSet observer drains exactly once and fans the
+  // same snapshot out to every observer. Cleared at the end of each dispatch.
+  // (Bug: a second per-entity onSet observer on the same component used to
+  // see an empty list.)
+  _setDrainCache = /* @__PURE__ */ new Map();
+  get count() {
+    return this._entries.length + this._sparseEntries.length;
+  }
+  /** The synthesized `SystemDescriptor`s of every registered observer, in
+   * registration order (`dispose()` splices entries out, so none are stale).
+   * Fed into the `startup()` archetype-prewarm closure so an observer's declared
+   * `spawns` and `transitions` create their target archetypes eagerly, exactly as a
+   * system's do. Without this an archetype an observer spawns into or transitions to
+   * first-touches lazily mid-tick, the one asymmetry left in the otherwise
+   * uniform "no lazy archetypes" prewarm. */
+  descriptors() {
+    const e = [];
+    for (let t = 0; t < this._entries.length; t++) e.push(this._entries[t].descriptor);
+    for (let t = 0; t < this._sparseEntries.length; t++)
+      e.push(this._sparseEntries[t].descriptor);
+    return e;
+  }
+  register(e, t) {
+    if (typeof e == "number") return this._registerSparse(e, t);
+    const i = e.id;
+    if (typeof i != "number")
+      throw new S(
+        v.OBSERVER_INVALID_CONFIG,
+        "observe(): the definition is not a registered component. Observe a dense or a sparse component"
+      );
+    const n = t.granularity ?? "archetype", r = t.onSet !== void 0 && n === "entity", s = t.onSet !== void 0 && n !== "entity";
+    if (t.onSet === void 0 && t.granularity !== void 0)
+      throw new S(
+        v.OBSERVER_INVALID_CONFIG,
+        "observe(): `granularity` is meaningless without `onSet`"
+      );
+    if (t.onAdd === void 0 && t.onRemove === void 0 && t.onDisable === void 0 && t.onEnable === void 0 && t.onSet === void 0)
+      throw new S(
+        v.OBSERVER_INVALID_CONFIG,
+        "observe(): at least one of onAdd, onRemove, onDisable, onEnable and onSet is required"
+      );
+    const o = t.access ?? {}, a = O(
+      t.name ?? `observer(${C(e) ?? i})`,
+      o
+    ), c = {
+      // Share one identity space with the descriptor (used only for the
+      // topo tie-break + diagnostics).
+      id: a.id,
+      cid: i,
+      def: e,
+      onAdd: t.onAdd,
+      onRemove: t.onRemove,
+      onDisable: t.onDisable,
+      onEnable: t.onEnable,
+      onSetEntity: r ? t.onSet : void 0,
+      onSetArch: s ? t.onSet : void 0,
+      descriptor: a,
+      writes: x(o.writes),
+      reads: x(o.reads),
+      yieldExisting: t.yieldExisting ?? !1,
+      lastSetTick: 0,
+      disposed: !1
+    };
+    this._entries.push(c);
+    let u = this._byCid.get(i);
+    u === void 0 && (u = [], this._byCid.set(i, u)), u.push(c), this._topo = null, this._reconfigureComponent(i), c.yieldExisting && c.onAdd !== void 0 && this._yieldExisting(c);
+    const l = () => this._dispose(c);
+    return { dispose: l, [g]: l };
+  }
+  /** The sparse arm of `register`: an entity-level onSet, and nothing else.
+   * A sparse add and remove are immediate and touch no archetype, so there
+   * is no flush boundary to fire a structural observer at, and no archetype
+   * column for the archetype grain. */
+  _registerSparse(e, t) {
+    if (t.onSet === void 0 || t.granularity !== "entity" || t.onAdd !== void 0 || t.onRemove !== void 0 || t.onDisable !== void 0 || t.onEnable !== void 0)
+      throw new S(
+        v.OBSERVER_INVALID_CONFIG,
+        'observe(): a sparse component takes onSet with granularity "entity" and no other callback. Move onAdd, onRemove, onDisable, onEnable and the archetype grain to a dense component'
+      );
+    const i = O(
+      t.name ?? `observer(sparse ${e})`,
+      t.access ?? {}
+    ), n = {
+      id: i.id,
+      sid: e,
+      onSet: t.onSet,
+      descriptor: i,
+      disposed: !1
+    };
+    this._sparseEntries.push(n), this._store.configureSparseObservation(b, e, !0);
+    const r = () => {
+      if (n.disposed) return;
+      n.disposed = !0;
+      const s = this._sparseEntries.indexOf(n);
+      s >= 0 && this._sparseEntries.splice(s, 1);
+      let o = !1;
+      for (let a = 0; a < this._sparseEntries.length; a++)
+        this._sparseEntries[a].sid === e && (o = !0);
+      o || this._store.configureSparseObservation(b, e, !1);
+    };
+    return { dispose: r, [g]: r };
+  }
+  _dispose(e) {
+    if (e.disposed) return;
+    e.disposed = !0;
+    const t = this._entries.indexOf(e);
+    t >= 0 && this._entries.splice(t, 1);
+    const i = this._byCid.get(e.cid);
+    if (i !== void 0) {
+      const n = i.indexOf(e);
+      n >= 0 && i.splice(n, 1), i.length === 0 && this._byCid.delete(e.cid);
+    }
+    this._topo = null, this._reconfigureComponent(e.cid);
+  }
+  /** Recompute the component's hot-path observation flags from its live
+   * observers and push them to the store (which owns the flags + fast-path
+   * counters). */
+  _reconfigureComponent(e) {
+    const t = this._byCid.get(e);
+    let i = !1, n = !1, r = !1, s = !1, o = !1;
+    if (t !== void 0)
+      for (let a = 0; a < t.length; a++) {
+        const c = t[a];
+        c.onAdd !== void 0 && (i = !0), c.onRemove !== void 0 && (n = !0), c.onDisable !== void 0 && (r = !0), c.onEnable !== void 0 && (s = !0), c.onSetEntity !== void 0 && (o = !0);
+      }
+    this._store.configureObservation(b, e, {
+      add: i,
+      remove: n,
+      disable: r,
+      enable: s,
+      set: o
+    });
+  }
+  _getTopo() {
+    return this._topo === null && (this._topo = B(this._entries)), this._topo;
+  }
+  // =======================================================
+  // Structural dispatch (onAdd and onRemove)
+  // =======================================================
+  /**
+   * Fire onAdd, onRemove, onDisable and onEnable for one fixed-point round's
+   * effective events, in canonical order: access-topological across observers,
+   * entity-id order (radix) within each observer. Called through the store's
+   * structural hook after the batch commits. Observer callbacks may
+   * enqueue further structural ops (or toggles) onto the deferred buffers (the
+   * store loops until quiescent).
+   *
+   * The events arrive as flat `(comp, eid)` parallel arrays collected during the
+   * flush. This dispatch buckets by component once (O(K)), then walks observers
+   * in topo order so a producer's writes are visible to a consumer
+   * (glitch-free). A round
+   * carries either structural (add, remove) or toggle (disable, enable) events, never both,
+   * toggles drain only once add, remove and destroy are quiescent (`flushStructural`),
+   * but all four bucket uniformly. The empty pairs are no-ops. Within an
+   * observer the fire order is remove, add, disable, enable (the "leaving" edges
+   * before the "entering" edges).
+   */
+  dispatchStructural(e) {
+    this._bucket(e.addComp, e.addEid, e.addLen, this._addBuckets), this._bucket(e.remComp, e.remEid, e.remLen, this._remBuckets), this._bucket(e.disComp, e.disEid, e.disLen, this._disBuckets), this._bucket(e.enaComp, e.enaEid, e.enaLen, this._enaBuckets);
+    const t = this._getTopo(), i = h.current();
+    for (let n = 0; n < t.length; n++) {
+      const r = t[n];
+      if (!r.disposed) {
+        if (r.onRemove !== void 0) {
+          const s = this._remBuckets.get(r.cid);
+          s !== void 0 && s.length > 0 && this._fireEach(r, r.onRemove, s, "remove");
+        }
+        if (r.onAdd !== void 0) {
+          const s = this._addBuckets.get(r.cid);
+          s !== void 0 && s.length > 0 && this._fireEach(r, r.onAdd, s, "add");
+        }
+        if (r.onDisable !== void 0) {
+          const s = this._disBuckets.get(r.cid);
+          s !== void 0 && s.length > 0 && this._fireEach(r, r.onDisable, s, "disable");
+        }
+        if (r.onEnable !== void 0) {
+          const s = this._enaBuckets.get(r.cid);
+          s !== void 0 && s.length > 0 && this._fireEach(r, r.onEnable, s, "enable");
+        }
+      }
+    }
+    i !== null && h.enter(i), this._clearBuckets(this._addBuckets), this._clearBuckets(this._remBuckets), this._clearBuckets(this._disBuckets), this._clearBuckets(this._enaBuckets);
+  }
+  /** Radix-sort `eids` by entity index (canonical within-observer order), then
+   * fire `fn` per entity under the observer's access scope. */
+  _fireEach(e, t, i, n) {
+    this._radixOut = p(i, this._radixOut, this._radixC0, this._radixC1), h.enter(e.descriptor);
+    try {
+      const r = f ? this._store.trace : null;
+      for (let s = 0; s < i.length; s++)
+        t(m(i[s]), this._ctx), f && r?.observerFired(n, e.cid, i[s], e.descriptor);
+    } finally {
+      h.leave();
+    }
+  }
+  _bucket(e, t, i, n) {
+    for (let r = 0; r < i; r++) {
+      const s = e[r];
+      let o = n.get(s);
+      o === void 0 && (o = [], n.set(s, o)), o.push(t[r]);
+    }
+  }
+  _clearBuckets(e) {
+    for (const t of e.values()) t.length = 0;
+  }
+  // =======================================================
+  // onSet dispatch (post-update detection point)
+  // =======================================================
+  /**
+   * Fire onSet observers for the current frame, in canonical order. Per-entity
+   * onSet drains the opt-in dirty list, once for each changed entity.
+   * Archetype-granular onSet scans the change tick, once for each changed
+   * archetype column.
+   * Called through the plugin's settle hook, after every phase of the frame.
+   * `run` is the change tick advanced
+   * for this dispatch: above every system run of the frame, and the baseline
+   * each archetype-granular observer keeps for its next dispatch.
+   */
+  dispatchSet(e) {
+    if (this._entries.length === 0 && this._sparseEntries.length === 0) return;
+    const t = h.current(), i = this._getTopo(), n = this._setDrainCache;
+    for (let s = 0; s < i.length; s++) {
+      const o = i[s];
+      o.onSetEntity !== void 0 ? this._dispatchSetEntity(o, n, e) : o.onSetArch !== void 0 && this._dispatchSetArch(o, e);
+    }
+    n.clear();
+    const r = this._sparseEntries;
+    if (r.length !== 0) {
+      const s = this._sparseDrainCache;
+      for (let o = 0; o < r.length; o++) {
+        const a = r[o];
+        a.disposed || this._dispatchSparseSet(a, s, e);
+      }
+      s.clear();
+    }
+    t !== null && h.enter(t);
+  }
+  /** Fire one sparse observer over the members recorded since the last
+   * drain. The store's walk gives alive, member and enabled entities, so no
+   * check remains here. Canonical order by entity index, through the radix. */
+  _dispatchSparseSet(e, t, i) {
+    let n = t.get(e.sid);
+    if (n === void 0 && (n = this._store.drainSparseSet(e.sid, i), this._radixOut = p(n, this._radixOut, this._radixC0, this._radixC1), t.set(e.sid, n)), n.length === 0) return;
+    const r = e.onSet;
+    h.enter(e.descriptor);
+    try {
+      for (let s = 0; s < n.length; s++)
+        r(n[s], this._ctx), f && this._store.trace?.observerFired("set", e.sid, n[s], e.descriptor);
+    } finally {
+      h.leave();
+    }
+  }
+  _dispatchSetEntity(e, t, i) {
+    let n = t.get(e.cid);
+    n === void 0 && (n = this._store.drainSet(e.cid, i), this._radixOut = p(n.scanned, this._radixOut, this._radixC0, this._radixC1), this._radixOut = p(n.listed, this._radixOut, this._radixC0, this._radixC1), I(n.listed), t.set(e.cid, n));
+    const r = n.scanned, s = n.listed, o = r.length, a = s.length;
+    if (o === 0 && a === 0) return;
+    const c = e.def, u = e.onSetEntity;
+    h.enter(e.descriptor);
+    try {
+      let l = 0, E = 0;
+      for (; l < o || E < a; ) {
+        let _;
+        if (E >= a || l < o && (r[l] & y) < (s[E] & y))
+          _ = r[l++];
+        else if (_ = s[E++], !this._store.isAlive(_) || !this._store.hasComponent(_, c) || this._store.isDisabled(_))
+          continue;
+        u(_, this._ctx), f && this._store.trace?.observerFired("set", e.cid, _, e.descriptor);
+      }
+    } finally {
+      h.leave();
+    }
+  }
+  _dispatchSetArch(e, t) {
+    const i = e.onSetArch, n = e.lastSetTick;
+    h.enter(e.descriptor);
+    try {
+      this._store.forEachChangedArchetype(e.cid, n, (r) => {
+        i(r, this._ctx), f && this._store.trace?.observerFired("set", e.cid, -1, e.descriptor);
+      });
+    } finally {
+      h.leave();
+    }
+    e.lastSetTick = t;
+  }
+  // =======================================================
+  // Seeding a new observer with the existing members
+  // =======================================================
+  _yieldExisting(e) {
+    const t = e.onAdd, i = this._store.collectEnabledWith(e.cid);
+    if (i.length === 0) return;
+    this._radixOut = p(i, this._radixOut, this._radixC0, this._radixC1);
+    const n = h.current();
+    h.enter(e.descriptor);
+    try {
+      for (let r = 0; r < i.length; r++) t(m(i[r]), this._ctx);
+    } finally {
+      h.leave(), n !== null && h.enter(n);
+    }
+  }
+}
+function I(d) {
+  const e = d.length;
+  if (e < 2) return;
+  let t = 1;
+  for (let i = 1; i < e; i++)
+    d[i] !== d[t - 1] && (d[t++] = d[i]);
+  d.length = t;
+}
+function V() {
+  return {
+    name: "observers",
+    install(d) {
+      const e = new D(d.store, d.context);
+      return d.onSettle((t) => e.dispatchSet(t)), d.onPrewarm(() => e.descriptors()), d.changes.addStructuralHook((t) => e.dispatchStructural(t)), {
+        observe(t, i) {
+          return e.register(t, i);
+        }
+      };
+    }
+  };
+}
+export {
+  D as ObserverRegistry,
+  V as observers
+};