@oasys/oecs 0.5.3 → 0.6.0

package/dist/internal.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r=require("./host_commands-DNf0f6ko.cjs"),d="/packages/engine/src/core/ecs/";class h{activeCache=null;repoRootCache=null;buf=new Map;callsiteCache=new Map;isActive(){if(this.activeCache!==null)return this.activeCache;const t=globalThis.process?.env?.VISUAL_INTEL_TRACE;return this.activeCache=t==="1"||t==="true"}repoRoot(){if(this.repoRootCache!==null)return this.repoRootCache;const e=globalThis.process;return this.repoRootCache=e?.cwd?.()??""}resolveCallsite(){return T(new Error().stack??null,this.repoRoot(),this.callsiteCache)}record(e,t,l){const s=this.resolveCallsite();if(!s)return;const o=`${e}	${t}	${l}	${s}`;this.buf.set(o,(this.buf.get(o)??0)+1)}recordEmit(e){this.record("ecs-events","emit",e)}recordRead(e){this.record("ecs-events","read",e)}recordResourceRead(e){this.record("resources","read",e)}recordResourceWrite(e){this.record("resources","write",e)}recordResourceRegister(e){this.record("resources","register",e)}recordResourceRemove(e){this.record("resources","remove",e)}recordSendAction(e){this.record("actions","send_action",e)}recordHandleAction(e){this.record("actions","handle_action",e)}snapshot(){const e={"ecs-events":{emit:[],read:[]},actions:{send_action:[],handle_action:[]},resources:{read:[],write:[],register:[],remove:[]}};for(const[t,l]of this.buf.entries()){const[s,o,n,c]=t.split("	");if(!s||!o||c===void 0)continue;const u={key:s==="actions"?Number(n):n,file:c,count:l},E=e[s][o];E&&E.push(u)}for(const t of Object.values(e))for(const l of Object.values(t))l.sort((s,o)=>{if(s.file!==o.file)return s.file<o.file?-1:1;const n=String(s.key),c=String(o.key);return n<c?-1:n>c?1:0});return{schemaVersion:1,capturedAt:new Date().toISOString(),channels:e}}reset(){this.buf.clear(),this.callsiteCache.clear(),this.activeCache=null,this.repoRootCache=null}}function _(i){const e=/\(([^)]+):\d+:\d+\)\s*$/.exec(i);if(e)return e[1]??null;const t=/at\s+([^\s][^()]*?):\d+:\d+\s*$/.exec(i);return t&&(t[1]??"").trim()||null}function T(i,e,t){if(!i)return null;const l=i.split(`
-`);for(let s=0;s<l.length;s++){const o=l[s],n=t?.get(o);if(n!==void 0){if(n===null)continue;return n}const c=_(o);if(!c){t?.set(o,null);continue}if(c.includes(d)){t?.set(o,null);continue}const a=C(c,e);return t?.set(o,a),a}return null}function C(i,e){let t=i;return t.startsWith("file://")&&(t=t.slice(7)),e&&t.startsWith(e+"/")&&(t=t.slice(e.length+1)),t.replace(/\\/g,"/")}const R=new h;exports.BUDGET_DEFAULT_ARCHETYPES=r.BUDGET_DEFAULT_ARCHETYPES;exports.BUDGET_DEFAULT_BYTES_PER_ENTITY=r.BUDGET_DEFAULT_BYTES_PER_ENTITY;exports.BUDGET_GROWTH_HEADROOM=r.BUDGET_GROWTH_HEADROOM;exports.DEFAULT_ECS_CAP_BYTES=r.DEFAULT_ECS_CAP_BYTES;exports.HOST_COMMAND_PAYLOAD_BYTES=r.HOST_COMMAND_PAYLOAD_BYTES;exports.HostCommandDispatcher=r.HostCommandDispatcher;exports.MAX_ENTITY_ID=r.MAX_ENTITY_ID;exports.MAX_GENERATION=r.MAX_GENERATION;exports.MAX_INDEX=r.MAX_INDEX;exports.MAX_LIVE_GENERATION=r.MAX_LIVE_GENERATION;exports.RETIRED_GENERATION=r.RETIRED_GENERATION;exports.accessCheck=r.accessCheck;exports.createEntityId=r.createEntityId;exports.getEntityGeneration=r.getEntityGeneration;exports.resolveECSMemory=r.resolveECSMemory;exports.ringDespawnCodec=r.ringDespawnCodec;exports.ringDisableCodec=r.ringDisableCodec;exports.ringEnableCodec=r.ringEnableCodec;exports.ringRemoveComponentCodec=r.ringRemoveComponentCodec;exports.ringSetFieldCodec=r.ringSetFieldCodec;exports.dispatchTrace=R;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const t=require("./host_commands-B2KMx8O2.cjs"),d=["/oecs/src/","/@oasys/oecs/"];function h(o){for(let e=0;e<d.length;e++)if(o.includes(d[e]))return!0;return!1}class T{_activeCache=null;_repoRootCache=null;_counts=new Map;_callsiteCache=new Map;isActive(){if(this._activeCache!==null)return this._activeCache;const r=globalThis.process?.env?.VISUAL_INTEL_TRACE;return this._activeCache=r==="1"||r==="true"}_repoRoot(){if(this._repoRootCache!==null)return this._repoRootCache;const e=globalThis.process;return this._repoRootCache=e?.cwd?.()??""}_resolveCallsite(){return R(new Error().stack??null,this._repoRoot(),this._callsiteCache)}_record(e,r,l){const s=this._resolveCallsite();if(!s)return;const n=`${e}	${r}	${l}	${s}`;this._counts.set(n,(this._counts.get(n)??0)+1)}recordEventEmit(e){this._record("ecs-events","emit",e)}recordEventRead(e){this._record("ecs-events","read",e)}recordResourceRead(e){this._record("resources","read",e)}recordResourceWrite(e){this._record("resources","write",e)}recordResourceRegister(e){this._record("resources","register",e)}recordResourceRemove(e){this._record("resources","remove",e)}recordSendAction(e){this._record("actions","send_action",e)}recordHandleAction(e){this._record("actions","handle_action",e)}snapshot(){const e={"ecs-events":{emit:[],read:[]},actions:{send_action:[],handle_action:[]},resources:{read:[],write:[],register:[],remove:[]}};for(const[r,l]of this._counts.entries()){const[s,n,i,c]=r.split("	");if(!s||!n||c===void 0)continue;const u={key:s==="actions"?Number(i):i,file:c,count:l},_=e[s][n];_&&_.push(u)}for(const r of Object.values(e))for(const l of Object.values(r))l.sort((s,n)=>{if(s.file!==n.file)return s.file<n.file?-1:1;const i=String(s.key),c=String(n.key);return i<c?-1:i>c?1:0});return{schemaVersion:1,capturedAt:new Date().toISOString(),channels:e}}reset(){this._counts.clear(),this._callsiteCache.clear(),this._activeCache=null,this._repoRootCache=null}}function p(o){const e=/\(([^)]+):\d+:\d+\)\s*$/.exec(o);if(e)return e[1]??null;const r=/at\s+([^\s][^()]*?):\d+:\d+\s*$/.exec(o);return r&&(r[1]??"").trim()||null}function R(o,e,r){if(!o)return null;const l=o.split(`
+`);for(let s=0;s<l.length;s++){const n=l[s],i=r?.get(n);if(i!==void 0){if(i===null)continue;return i}const c=p(n);if(!c){r?.set(n,null);continue}if(h(c)){r?.set(n,null);continue}const E=C(c,e);return r?.set(n,E),E}return null}function C(o,e){let r=o;return r.startsWith("file://")&&(r=r.slice(7)),e&&r.startsWith(e+"/")&&(r=r.slice(e.length+1)),r.replace(/\\/g,"/")}const g=new T;function a(o){return new t.ECSError(t.ECS_ERROR.PLUGIN_NOT_INSTALLED,`${o} needs a world, and this plugin was installed on a bare store. Build the world with ECS.create({ plugins: [...] }) instead`)}function S(o){return{store:o,changes:o,get world(){throw new t.ECSError(t.ECS_ERROR.PLUGIN_NOT_INSTALLED,"this plugin needs a world, and it was installed on a bare store. Build the world with ECS.create({ plugins: [...] }) instead")},onSettle(){throw new t.ECSError(t.ECS_ERROR.PLUGIN_NOT_INSTALLED,"a settle hook needs a world, and this plugin was installed on a bare store. Build the world with ECS.create({ plugins: [...] }) instead")},get context(){throw new t.ECSError(t.ECS_ERROR.PLUGIN_NOT_INSTALLED,"this plugin needs a world, and it was installed on a bare store. Build the world with ECS.create({ plugins: [...] }) instead")},onPrewarm(){throw a("a prewarm hook")},onDispose(){throw a("a dispose hook")},get memory(){throw a("the world's memory layout")},installRoute(){throw a("a system dispatch route")}}}exports.BUDGET_DEFAULT_ARCHETYPES=t.BUDGET_DEFAULT_ARCHETYPES;exports.BUDGET_DEFAULT_BYTES_PER_ENTITY=t.BUDGET_DEFAULT_BYTES_PER_ENTITY;exports.BUDGET_GROWTH_HEADROOM=t.BUDGET_GROWTH_HEADROOM;exports.DEFAULT_ECS_CAP_BYTES=t.DEFAULT_ECS_CAP_BYTES;exports.HOST_COMMAND_PAYLOAD_BYTES=t.HOST_COMMAND_PAYLOAD_BYTES;exports.HostCommandDispatcher=t.HostCommandDispatcher;exports.MAX_ENTITY_ID=t.MAX_ENTITY_ID;exports.MAX_GENERATION=t.MAX_GENERATION;exports.MAX_INDEX=t.MAX_INDEX;exports.MAX_LIVE_GENERATION=t.MAX_LIVE_GENERATION;exports.RETIRED_GENERATION=t.RETIRED_GENERATION;exports.WASM_STORE_BASE_BYTES=t.WASM_STORE_BASE_BYTES;exports.accessCheck=t.accessCheck;exports.componentDebugName=t.componentDebugName;exports.componentLabel=t.componentLabel;exports.createEntityId=t.createEntityId;exports.getEntityGeneration=t.getEntityGeneration;exports.pluginInstalledTwiceError=t.pluginInstalledTwiceError;exports.pluginMissingError=t.pluginMissingError;exports.resolveECSMemory=t.resolveECSMemory;exports.ringDespawnCodec=t.ringDespawnCodec;exports.ringDisableCodec=t.ringDisableCodec;exports.ringEnableCodec=t.ringEnableCodec;exports.ringRemoveComponentCodec=t.ringRemoveComponentCodec;exports.ringSetFieldCodec=t.ringSetFieldCodec;exports.setComponentDebugName=t.setComponentDebugName;exports.dispatchTrace=g;exports.storeOnlyHost=S;

package/dist/internal.d.cts

@@ -1,5 +1,5 @@
 /**
- * # oecs/internal — unstable tooling surface
+ * # oecs/internal, unstable tooling surface
  *
  * Codecs, ABI constants, memory inspectors, and dev-mode singletons, exported
  * for tests, tooling, and advanced integrations (replication decode,
@@ -10,11 +10,14 @@
  *
  * @module oecs/internal
  */
-export { resolveECSMemory, DEFAULT_ECS_CAP_BYTES, BUDGET_GROWTH_HEADROOM, BUDGET_DEFAULT_BYTES_PER_ENTITY, BUDGET_DEFAULT_ARCHETYPES } from './core/ecs/index.cjs';
+export { resolveECSMemory, DEFAULT_ECS_CAP_BYTES, WASM_STORE_BASE_BYTES, BUDGET_GROWTH_HEADROOM, BUDGET_DEFAULT_BYTES_PER_ENTITY, BUDGET_DEFAULT_ARCHETYPES } from './core/ecs/index.cjs';
 export type { ResolvedECSMemory, ECSMemoryCapContext } from './core/ecs/index.cjs';
 export { accessCheck } from './core/ecs/index.cjs';
 export { dispatchTrace, type DispatchTraceSnapshot, type DispatchTraceEntry } from './core/ecs/index.cjs';
 export { HostCommandDispatcher, ringSetFieldCodec, ringDespawnCodec, ringDisableCodec, ringEnableCodec, ringRemoveComponentCodec, HOST_COMMAND_PAYLOAD_BYTES } from './core/ecs/index.cjs';
 export type { RingCommandApplier } from './core/ecs/index.cjs';
 export { createEntityId, getEntityGeneration, MAX_INDEX, MAX_GENERATION, MAX_LIVE_GENERATION, RETIRED_GENERATION, MAX_ENTITY_ID } from './core/ecs/index.cjs';
+export { storeOnlyHost } from './core/ecs/index.cjs';
+export { pluginMissingError, pluginInstalledTwiceError } from './core/ecs/utils/plugin_error.cjs';
+export { setComponentDebugName, componentDebugName, componentLabel } from './core/ecs/debug_names.cjs';
 //# sourceMappingURL=internal.d.ts.map

package/dist/internal.d.ts

@@ -1,5 +1,5 @@
 /**
- * # oecs/internal — unstable tooling surface
+ * # oecs/internal, unstable tooling surface
  *
  * Codecs, ABI constants, memory inspectors, and dev-mode singletons, exported
  * for tests, tooling, and advanced integrations (replication decode,
@@ -10,11 +10,14 @@
  *
  * @module oecs/internal
  */
-export { resolveECSMemory, DEFAULT_ECS_CAP_BYTES, BUDGET_GROWTH_HEADROOM, BUDGET_DEFAULT_BYTES_PER_ENTITY, BUDGET_DEFAULT_ARCHETYPES } from './core/ecs/index.js';
+export { resolveECSMemory, DEFAULT_ECS_CAP_BYTES, WASM_STORE_BASE_BYTES, BUDGET_GROWTH_HEADROOM, BUDGET_DEFAULT_BYTES_PER_ENTITY, BUDGET_DEFAULT_ARCHETYPES } from './core/ecs/index.js';
 export type { ResolvedECSMemory, ECSMemoryCapContext } from './core/ecs/index.js';
 export { accessCheck } from './core/ecs/index.js';
 export { dispatchTrace, type DispatchTraceSnapshot, type DispatchTraceEntry } from './core/ecs/index.js';
 export { HostCommandDispatcher, ringSetFieldCodec, ringDespawnCodec, ringDisableCodec, ringEnableCodec, ringRemoveComponentCodec, HOST_COMMAND_PAYLOAD_BYTES } from './core/ecs/index.js';
 export type { RingCommandApplier } from './core/ecs/index.js';
 export { createEntityId, getEntityGeneration, MAX_INDEX, MAX_GENERATION, MAX_LIVE_GENERATION, RETIRED_GENERATION, MAX_ENTITY_ID } from './core/ecs/index.js';
+export { storeOnlyHost } from './core/ecs/index.js';
+export { pluginMissingError, pluginInstalledTwiceError } from './core/ecs/utils/plugin_error.js';
+export { setComponentDebugName, componentDebugName, componentLabel } from './core/ecs/debug_names.js';
 //# sourceMappingURL=internal.d.ts.map

package/dist/internal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,OAAO,EACN,gBAAgB,EAChB,qBAAqB,EACrB,sBAAsB,EACtB,+BAA+B,EAC/B,yBAAyB,EACzB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAGzE,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAIzC,OAAO,EAAE,aAAa,EAAE,KAAK,qBAAqB,EAAE,KAAK,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAMhG,OAAO,EACN,qBAAqB,EACrB,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,wBAAwB,EACxB,0BAA0B,EAC1B,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAQrD,OAAO,EACN,cAAc,EACd,mBAAmB,EACnB,SAAS,EACT,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EAClB,aAAa,EACb,MAAM,YAAY,CAAC"}
+{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,OAAO,EACN,gBAAgB,EAChB,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,EACtB,+BAA+B,EAC/B,yBAAyB,EACzB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAGzE,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAIzC,OAAO,EAAE,aAAa,EAAE,KAAK,qBAAqB,EAAE,KAAK,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAMhG,OAAO,EACN,qBAAqB,EACrB,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,wBAAwB,EACxB,0BAA0B,EAC1B,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAQrD,OAAO,EACN,cAAc,EACd,mBAAmB,EACnB,SAAS,EACT,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EAClB,aAAa,EACb,MAAM,YAAY,CAAC;AAKpB,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAc3C,OAAO,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAK9F,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/internal.development.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./internal-RZN14uMw.cjs");exports.BUDGET_DEFAULT_ARCHETYPES=e.BUDGET_DEFAULT_ARCHETYPES;exports.BUDGET_DEFAULT_BYTES_PER_ENTITY=e.BUDGET_DEFAULT_BYTES_PER_ENTITY;exports.BUDGET_GROWTH_HEADROOM=e.BUDGET_GROWTH_HEADROOM;exports.DEFAULT_ECS_CAP_BYTES=e.DEFAULT_ECS_CAP_BYTES;exports.HOST_COMMAND_PAYLOAD_BYTES=e.HOST_COMMAND_PAYLOAD_BYTES;exports.HostCommandDispatcher=e.HostCommandDispatcher;exports.MAX_ENTITY_ID=e.MAX_ENTITY_ID;exports.MAX_GENERATION=e.MAX_GENERATION;exports.MAX_INDEX=e.MAX_INDEX;exports.MAX_LIVE_GENERATION=e.MAX_LIVE_GENERATION;exports.RETIRED_GENERATION=e.RETIRED_GENERATION;exports.accessCheck=e.accessCheck;exports.createEntityId=e.createEntityId;exports.dispatchTrace=e.dispatchTrace;exports.getEntityGeneration=e.getEntityGeneration;exports.resolveECSMemory=e.resolveECSMemory;exports.ringDespawnCodec=e.ringDespawnCodec;exports.ringDisableCodec=e.ringDisableCodec;exports.ringEnableCodec=e.ringEnableCodec;exports.ringRemoveComponentCodec=e.ringRemoveComponentCodec;exports.ringSetFieldCodec=e.ringSetFieldCodec;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./host_commands-ClVPvhSa.cjs");function o(t){return new e.ECSError(e.ECS_ERROR.PLUGIN_NOT_INSTALLED,`${t} needs a world, and this plugin was installed on a bare store. Build the world with ECS.create({ plugins: [...] }) instead`)}function n(t){return{store:t,changes:t,get world(){throw new e.ECSError(e.ECS_ERROR.PLUGIN_NOT_INSTALLED,"this plugin needs a world, and it was installed on a bare store. Build the world with ECS.create({ plugins: [...] }) instead")},onSettle(){throw new e.ECSError(e.ECS_ERROR.PLUGIN_NOT_INSTALLED,"a settle hook needs a world, and this plugin was installed on a bare store. Build the world with ECS.create({ plugins: [...] }) instead")},get context(){throw new e.ECSError(e.ECS_ERROR.PLUGIN_NOT_INSTALLED,"this plugin needs a world, and it was installed on a bare store. Build the world with ECS.create({ plugins: [...] }) instead")},onPrewarm(){throw o("a prewarm hook")},onDispose(){throw o("a dispose hook")},get memory(){throw o("the world's memory layout")},installRoute(){throw o("a system dispatch route")}}}exports.BUDGET_DEFAULT_ARCHETYPES=e.BUDGET_DEFAULT_ARCHETYPES;exports.BUDGET_DEFAULT_BYTES_PER_ENTITY=e.BUDGET_DEFAULT_BYTES_PER_ENTITY;exports.BUDGET_GROWTH_HEADROOM=e.BUDGET_GROWTH_HEADROOM;exports.DEFAULT_ECS_CAP_BYTES=e.DEFAULT_ECS_CAP_BYTES;exports.HOST_COMMAND_PAYLOAD_BYTES=e.HOST_COMMAND_PAYLOAD_BYTES;exports.HostCommandDispatcher=e.HostCommandDispatcher;exports.MAX_ENTITY_ID=e.MAX_ENTITY_ID;exports.MAX_GENERATION=e.MAX_GENERATION;exports.MAX_INDEX=e.MAX_INDEX;exports.MAX_LIVE_GENERATION=e.MAX_LIVE_GENERATION;exports.RETIRED_GENERATION=e.RETIRED_GENERATION;exports.WASM_STORE_BASE_BYTES=e.WASM_STORE_BASE_BYTES;exports.accessCheck=e.accessCheck;exports.componentDebugName=e.componentDebugName;exports.componentLabel=e.componentLabel;exports.createEntityId=e.createEntityId;exports.dispatchTrace=e.dispatchTrace;exports.getEntityGeneration=e.getEntityGeneration;exports.pluginInstalledTwiceError=e.pluginInstalledTwiceError;exports.pluginMissingError=e.pluginMissingError;exports.resolveECSMemory=e.resolveECSMemory;exports.ringDespawnCodec=e.ringDespawnCodec;exports.ringDisableCodec=e.ringDisableCodec;exports.ringEnableCodec=e.ringEnableCodec;exports.ringRemoveComponentCodec=e.ringRemoveComponentCodec;exports.ringSetFieldCodec=e.ringSetFieldCodec;exports.setComponentDebugName=e.setComponentDebugName;exports.storeOnlyHost=n;

package/dist/internal.development.js

@@ -1,24 +1,74 @@
-import { ax as s, aw as e, av as T, au as _, aE as A, ay as o, a4 as D, aG as n, aF as C, aH as r, p as t, h as c, o as i, ad as d, a3 as I, af as N, aA as R, aB as G, aC as O, aD as M, az as S } from "./internal-C9jjL90H.js";
+import { E as s, a as t } from "./host_commands-nJvTy88E.js";
+import { c as l, b as E, B as d, D as w, k as _, H as T, p as h, n as c, M as p, o as g, R as u, W as N, d as D, u as S, v as A, l as m, e as C, m as I, s as L, q as O, r as R, g as B, h as G, i as M, j as b, f as U, t as y } from "./host_commands-nJvTy88E.js";
+function a(e) {
+  return new s(
+    t.PLUGIN_NOT_INSTALLED,
+    `${e} needs a world, and this plugin was installed on a bare store. Build the world with ECS.create({ plugins: [...] }) instead`
+  );
+}
+function n(e) {
+  return {
+    store: e,
+    changes: e,
+    get world() {
+      throw new s(
+        t.PLUGIN_NOT_INSTALLED,
+        "this plugin needs a world, and it was installed on a bare store. Build the world with ECS.create({ plugins: [...] }) instead"
+      );
+    },
+    onSettle() {
+      throw new s(
+        t.PLUGIN_NOT_INSTALLED,
+        "a settle hook needs a world, and this plugin was installed on a bare store. Build the world with ECS.create({ plugins: [...] }) instead"
+      );
+    },
+    get context() {
+      throw new s(
+        t.PLUGIN_NOT_INSTALLED,
+        "this plugin needs a world, and it was installed on a bare store. Build the world with ECS.create({ plugins: [...] }) instead"
+      );
+    },
+    onPrewarm() {
+      throw a("a prewarm hook");
+    },
+    onDispose() {
+      throw a("a dispose hook");
+    },
+    get memory() {
+      throw a("the world's memory layout");
+    },
+    installRoute() {
+      throw a("a system dispatch route");
+    }
+  };
+}
 export {
-  s as BUDGET_DEFAULT_ARCHETYPES,
-  e as BUDGET_DEFAULT_BYTES_PER_ENTITY,
-  T as BUDGET_GROWTH_HEADROOM,
-  _ as DEFAULT_ECS_CAP_BYTES,
-  A as HOST_COMMAND_PAYLOAD_BYTES,
-  o as HostCommandDispatcher,
-  D as MAX_ENTITY_ID,
-  n as MAX_GENERATION,
-  C as MAX_INDEX,
-  r as MAX_LIVE_GENERATION,
-  t as RETIRED_GENERATION,
-  c as accessCheck,
-  i as createEntityId,
-  d as dispatchTrace,
+  l as BUDGET_DEFAULT_ARCHETYPES,
+  E as BUDGET_DEFAULT_BYTES_PER_ENTITY,
+  d as BUDGET_GROWTH_HEADROOM,
+  w as DEFAULT_ECS_CAP_BYTES,
+  _ as HOST_COMMAND_PAYLOAD_BYTES,
+  T as HostCommandDispatcher,
+  h as MAX_ENTITY_ID,
+  c as MAX_GENERATION,
+  p as MAX_INDEX,
+  g as MAX_LIVE_GENERATION,
+  u as RETIRED_GENERATION,
+  N as WASM_STORE_BASE_BYTES,
+  D as accessCheck,
+  S as componentDebugName,
+  A as componentLabel,
+  m as createEntityId,
+  C as dispatchTrace,
   I as getEntityGeneration,
-  N as resolveECSMemory,
-  R as ringDespawnCodec,
+  L as pluginInstalledTwiceError,
+  O as pluginMissingError,
+  R as resolveECSMemory,
+  B as ringDespawnCodec,
   G as ringDisableCodec,
-  O as ringEnableCodec,
-  M as ringRemoveComponentCodec,
-  S as ringSetFieldCodec
+  M as ringEnableCodec,
+  b as ringRemoveComponentCodec,
+  U as ringSetFieldCodec,
+  y as setComponentDebugName,
+  n as storeOnlyHost
 };

package/dist/internal.js

@@ -1,56 +1,62 @@
-import { b as v, a as A, B as g, D as m, i as D, H as S, n as b, l as I, M, m as N, R as O, c as k, j as w, k as y, r as G, e as F, f as B, g as H, h as L, d as U } from "./host_commands-3jyFfWNg.js";
-const h = "/packages/engine/src/core/ecs/";
-class d {
-  activeCache = null;
-  repoRootCache = null;
-  buf = /* @__PURE__ */ new Map();
-  callsiteCache = /* @__PURE__ */ new Map();
+import { E as l, a as u } from "./host_commands-CwxVQS1z.js";
+import { c as v, b as D, B as I, D as L, j as O, H as b, o as y, m as M, M as k, n as B, R as G, W as U, d as F, t as P, u as H, k as Y, l as $, q as W, p as x, r as X, f as V, g as j, h as q, i as K, e as z, s as J } from "./host_commands-CwxVQS1z.js";
+const _ = ["/oecs/src/", "/@oasys/oecs/"];
+function p(s) {
+  for (let e = 0; e < _.length; e++)
+    if (s.includes(_[e])) return !0;
+  return !1;
+}
+class f {
+  _activeCache = null;
+  _repoRootCache = null;
+  _counts = /* @__PURE__ */ new Map();
+  _callsiteCache = /* @__PURE__ */ new Map();
   isActive() {
-    if (this.activeCache !== null) return this.activeCache;
+    if (this._activeCache !== null) return this._activeCache;
     const t = globalThis.process?.env?.VISUAL_INTEL_TRACE;
-    return this.activeCache = t === "1" || t === "true";
+    return this._activeCache = t === "1" || t === "true";
   }
-  repoRoot() {
-    if (this.repoRootCache !== null) return this.repoRootCache;
+  _repoRoot() {
+    if (this._repoRootCache !== null) return this._repoRootCache;
     const e = globalThis.process;
-    return this.repoRootCache = e?.cwd?.() ?? "";
+    return this._repoRootCache = e?.cwd?.() ?? "";
   }
-  resolveCallsite() {
-    return E(
+  _resolveCallsite() {
+    return g(
       new Error().stack ?? null,
-      this.repoRoot(),
-      this.callsiteCache
+      this._repoRoot(),
+      this._callsiteCache
     );
   }
-  record(e, t, i) {
-    const r = this.resolveCallsite();
-    if (!r) return;
-    const s = `${e}	${t}	${i}	${r}`;
-    this.buf.set(s, (this.buf.get(s) ?? 0) + 1);
+  _record(e, t, a) {
+    const o = this._resolveCallsite();
+    if (!o) return;
+    const r = `${e}	${t}	${a}	${o}`;
+    this._counts.set(r, (this._counts.get(r) ?? 0) + 1);
   }
-  recordEmit(e) {
-    this.record("ecs-events", "emit", e);
+  recordEventEmit(e) {
+    this._record("ecs-events", "emit", e);
   }
-  recordRead(e) {
-    this.record("ecs-events", "read", e);
+  recordEventRead(e) {
+    this._record("ecs-events", "read", e);
   }
   recordResourceRead(e) {
-    this.record("resources", "read", e);
+    this._record("resources", "read", e);
   }
   recordResourceWrite(e) {
-    this.record("resources", "write", e);
+    this._record("resources", "write", e);
   }
   recordResourceRegister(e) {
-    this.record("resources", "register", e);
+    this._record("resources", "register", e);
   }
   recordResourceRemove(e) {
-    this.record("resources", "remove", e);
+    this._record("resources", "remove", e);
   }
   recordSendAction(e) {
-    this.record("actions", "send_action", e);
+    this._record("actions", "send_action", e);
   }
   recordHandleAction(e) {
-    this.record("actions", "handle_action", e);
+    this._record("actions", "handle_action", e);
   }
   snapshot() {
     const e = {
@@ -58,18 +64,18 @@ class d {
       actions: { send_action: [], handle_action: [] },
       resources: { read: [], write: [], register: [], remove: [] }
     };
-    for (const [t, i] of this.buf.entries()) {
-      const [r, s, o, c] = t.split("	");
-      if (!r || !s || c === void 0) continue;
-      const u = { key: r === "actions" ? Number(o) : o, file: c, count: i }, l = e[r][s];
-      l && l.push(u);
+    for (const [t, a] of this._counts.entries()) {
+      const [o, r, n, i] = t.split("	");
+      if (!o || !r || i === void 0) continue;
+      const E = { key: o === "actions" ? Number(n) : n, file: i, count: a }, h = e[o][r];
+      h && h.push(E);
     }
     for (const t of Object.values(e))
-      for (const i of Object.values(t))
-        i.sort((r, s) => {
-          if (r.file !== s.file) return r.file < s.file ? -1 : 1;
-          const o = String(r.key), c = String(s.key);
-          return o < c ? -1 : o > c ? 1 : 0;
+      for (const a of Object.values(t))
+        a.sort((o, r) => {
+          if (o.file !== r.file) return o.file < r.file ? -1 : 1;
+          const n = String(o.key), i = String(r.key);
+          return n < i ? -1 : n > i ? 1 : 0;
         });
     return {
       schemaVersion: 1,
@@ -78,64 +84,113 @@ class d {
     };
   }
   reset() {
-    this.buf.clear(), this.callsiteCache.clear(), this.activeCache = null, this.repoRootCache = null;
+    this._counts.clear(), this._callsiteCache.clear(), this._activeCache = null, this._repoRootCache = null;
   }
 }
-function f(n) {
-  const e = /\(([^)]+):\d+:\d+\)\s*$/.exec(n);
+function w(s) {
+  const e = /\(([^)]+):\d+:\d+\)\s*$/.exec(s);
   if (e) return e[1] ?? null;
-  const t = /at\s+([^\s][^()]*?):\d+:\d+\s*$/.exec(n);
+  const t = /at\s+([^\s][^()]*?):\d+:\d+\s*$/.exec(s);
   return t && (t[1] ?? "").trim() || null;
 }
-function E(n, e, t) {
-  if (!n) return null;
-  const i = n.split(`
+function g(s, e, t) {
+  if (!s) return null;
+  const a = s.split(`
 `);
-  for (let r = 0; r < i.length; r++) {
-    const s = i[r], o = t?.get(s);
-    if (o !== void 0) {
-      if (o === null) continue;
-      return o;
+  for (let o = 0; o < a.length; o++) {
+    const r = a[o], n = t?.get(r);
+    if (n !== void 0) {
+      if (n === null) continue;
+      return n;
     }
-    const c = f(s);
-    if (!c) {
-      t?.set(s, null);
+    const i = w(r);
+    if (!i) {
+      t?.set(r, null);
       continue;
     }
-    if (c.includes(h)) {
-      t?.set(s, null);
+    if (p(i)) {
+      t?.set(r, null);
       continue;
     }
-    const a = p(c, e);
-    return t?.set(s, a), a;
+    const d = R(i, e);
+    return t?.set(r, d), d;
   }
   return null;
 }
-function p(n, e) {
-  let t = n;
+function R(s, e) {
+  let t = s;
   return t.startsWith("file://") && (t = t.slice(7)), e && t.startsWith(e + "/") && (t = t.slice(e.length + 1)), t.replace(/\\/g, "/");
 }
-const C = new d();
+const m = new f();
+function c(s) {
+  return new l(
+    u.PLUGIN_NOT_INSTALLED,
+    `${s} needs a world, and this plugin was installed on a bare store. Build the world with ECS.create({ plugins: [...] }) instead`
+  );
+}
+function S(s) {
+  return {
+    store: s,
+    changes: s,
+    get world() {
+      throw new l(
+        u.PLUGIN_NOT_INSTALLED,
+        "this plugin needs a world, and it was installed on a bare store. Build the world with ECS.create({ plugins: [...] }) instead"
+      );
+    },
+    onSettle() {
+      throw new l(
+        u.PLUGIN_NOT_INSTALLED,
+        "a settle hook needs a world, and this plugin was installed on a bare store. Build the world with ECS.create({ plugins: [...] }) instead"
+      );
+    },
+    get context() {
+      throw new l(
+        u.PLUGIN_NOT_INSTALLED,
+        "this plugin needs a world, and it was installed on a bare store. Build the world with ECS.create({ plugins: [...] }) instead"
+      );
+    },
+    onPrewarm() {
+      throw c("a prewarm hook");
+    },
+    onDispose() {
+      throw c("a dispose hook");
+    },
+    get memory() {
+      throw c("the world's memory layout");
+    },
+    installRoute() {
+      throw c("a system dispatch route");
+    }
+  };
+}
 export {
   v as BUDGET_DEFAULT_ARCHETYPES,
-  A as BUDGET_DEFAULT_BYTES_PER_ENTITY,
-  g as BUDGET_GROWTH_HEADROOM,
-  m as DEFAULT_ECS_CAP_BYTES,
-  D as HOST_COMMAND_PAYLOAD_BYTES,
-  S as HostCommandDispatcher,
-  b as MAX_ENTITY_ID,
-  I as MAX_GENERATION,
-  M as MAX_INDEX,
-  N as MAX_LIVE_GENERATION,
-  O as RETIRED_GENERATION,
-  k as accessCheck,
-  w as createEntityId,
-  C as dispatchTrace,
-  y as getEntityGeneration,
-  G as resolveECSMemory,
-  F as ringDespawnCodec,
-  B as ringDisableCodec,
-  H as ringEnableCodec,
-  L as ringRemoveComponentCodec,
-  U as ringSetFieldCodec
+  D as BUDGET_DEFAULT_BYTES_PER_ENTITY,
+  I as BUDGET_GROWTH_HEADROOM,
+  L as DEFAULT_ECS_CAP_BYTES,
+  O as HOST_COMMAND_PAYLOAD_BYTES,
+  b as HostCommandDispatcher,
+  y as MAX_ENTITY_ID,
+  M as MAX_GENERATION,
+  k as MAX_INDEX,
+  B as MAX_LIVE_GENERATION,
+  G as RETIRED_GENERATION,
+  U as WASM_STORE_BASE_BYTES,
+  F as accessCheck,
+  P as componentDebugName,
+  H as componentLabel,
+  Y as createEntityId,
+  m as dispatchTrace,
+  $ as getEntityGeneration,
+  W as pluginInstalledTwiceError,
+  x as pluginMissingError,
+  X as resolveECSMemory,
+  V as ringDespawnCodec,
+  j as ringDisableCodec,
+  q as ringEnableCodec,
+  K as ringRemoveComponentCodec,
+  z as ringSetFieldCodec,
+  J as setComponentDebugName,
+  S as storeOnlyHost
 };

package/dist/plugins/abi-D3V-QUSf.cjs

@@ -0,0 +1 @@
+"use strict";const _={magic:0,sim_abi_version:4,view_stamp:8,capacity:12,archetype_count:16,layout_descriptor_off:20,command_ring_off:24,action_ring_off:28,entity_index_off:32,event_ring_off:36,region_table_off:40,region_table_count:44,bindings_off:48},E=16,S={component_id:0,field_id:2,type_tag:4,byte_off:8,stride:12},R=40,T={archetype_id:0,component_mask:4,row_count:20,row_capacity:24,column_count:28,enabled_count:32,entity_ids_off:36};exports.ARCHETYPE_DESCRIPTOR_HEADER_BYTES=R;exports.ARCHETYPE_DESCRIPTOR_OFFSETS=T;exports.COLUMN_DESCRIPTOR_BYTES=E;exports.COLUMN_DESCRIPTOR_OFFSETS=S;exports.COMPONENT_MASK_WORDS=4;exports.LEGACY_ABSOLUTE_ABI_VERSION=0;exports.LEGACY_ARCHETYPE_DESCRIPTOR_HEADER_BYTES=36;exports.SIM_ABI_VERSION=1;exports.STORE_HEADER_BYTES=52;exports.STORE_HEADER_OFFSETS=_;exports.STORE_MAGIC=827148627;

package/dist/plugins/abi-NP8pNxpd.js

@@ -0,0 +1,42 @@
+const _ = 827148627, o = 1, t = 0, n = 36, E = 4, c = 52, s = {
+  magic: 0,
+  sim_abi_version: 4,
+  view_stamp: 8,
+  capacity: 12,
+  archetype_count: 16,
+  layout_descriptor_off: 20,
+  command_ring_off: 24,
+  action_ring_off: 28,
+  entity_index_off: 32,
+  event_ring_off: 36,
+  region_table_off: 40,
+  region_table_count: 44,
+  bindings_off: 48
+}, a = 16, e = {
+  component_id: 0,
+  field_id: 2,
+  type_tag: 4,
+  byte_off: 8,
+  stride: 12
+}, i = 40, S = {
+  archetype_id: 0,
+  component_mask: 4,
+  row_count: 20,
+  row_capacity: 24,
+  column_count: 28,
+  enabled_count: 32,
+  entity_ids_off: 36
+};
+export {
+  i as A,
+  E as C,
+  t as L,
+  s as S,
+  S as a,
+  a as b,
+  e as c,
+  c as d,
+  _ as e,
+  o as f,
+  n as g
+};

package/dist/plugins/arrays-Dr_1hCjL.js

@@ -0,0 +1,28 @@
+function o(i, l, e, f) {
+  const t = i.length;
+  if (t < 2) return l;
+  if (l.length < t) {
+    let n = l.length;
+    for (; n < t; ) n *= 2;
+    l = new Uint32Array(n);
+  }
+  e.fill(0), f.fill(0);
+  for (let n = 0; n < t; n++) {
+    const r = i[n] & 1048575;
+    e[r & 1023]++, f[r >> 10 & 1023]++;
+  }
+  for (let n = 1; n < 1024; n++)
+    e[n] += e[n - 1], f[n] += f[n - 1];
+  for (let n = t - 1; n >= 0; n--) {
+    const r = i[n];
+    l[--e[r & 1048575 & 1023]] = r;
+  }
+  for (let n = t - 1; n >= 0; n--) {
+    const r = l[n];
+    i[--f[(r & 1048575) >> 10 & 1023]] = r;
+  }
+  return l;
+}
+export {
+  o as r
+};

package/dist/plugins/arrays-Dt-Joc4i.cjs

@@ -0,0 +1 @@
+"use strict";function o(i,t,e,f){const l=i.length;if(l<2)return t;if(t.length<l){let n=t.length;for(;n<l;)n*=2;t=new Uint32Array(n)}e.fill(0),f.fill(0);for(let n=0;n<l;n++){const r=i[n]&1048575;e[r&1023]++,f[r>>10&1023]++}for(let n=1;n<1024;n++)e[n]+=e[n-1],f[n]+=f[n-1];for(let n=l-1;n>=0;n--){const r=i[n];t[--e[r&1048575&1023]]=r}for(let n=l-1;n>=0;n--){const r=t[n];i[--f[(r&1048575)>>10&1023]]=r}return t}exports.radixSortByIndex=o;

package/dist/plugins/assertions-gtDVfbnQ.js

@@ -0,0 +1,6 @@
+function t(n) {
+  return n;
+}
+export {
+  t as u
+};

package/dist/plugins/assertions-z5GQd_bB.cjs

@@ -0,0 +1 @@
+"use strict";function t(s){return s}exports.unsafeCast=t;