@oasys/oecs 0.3.1 → 0.5.0

package/dist/internal.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r=require("./host_commands-BF8QMi3c.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;

package/dist/internal.d.cts

@@ -0,0 +1,20 @@
+/**
+ * # oecs/internal — unstable tooling surface
+ *
+ * Codecs, ABI constants, memory inspectors, and dev-mode singletons, exported
+ * for tests, tooling, and advanced integrations (replication decode,
+ * cross-thread transports, adversarial harnesses).
+ *
+ * **No semver guarantees.** Anything here may change or disappear in any
+ * release. The supported application surface is the package root.
+ *
+ * @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 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';
+//# sourceMappingURL=internal.d.ts.map

package/dist/internal.d.ts

@@ -0,0 +1,20 @@
+/**
+ * # oecs/internal — unstable tooling surface
+ *
+ * Codecs, ABI constants, memory inspectors, and dev-mode singletons, exported
+ * for tests, tooling, and advanced integrations (replication decode,
+ * cross-thread transports, adversarial harnesses).
+ *
+ * **No semver guarantees.** Anything here may change or disappear in any
+ * release. The supported application surface is the package root.
+ *
+ * @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 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';
+//# sourceMappingURL=internal.d.ts.map

package/dist/internal.d.ts.map

@@ -0,0 +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"}

package/dist/internal.js

@@ -0,0 +1,141 @@
+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-i4cAeyL5.js";
+const h = "/packages/engine/src/core/ecs/";
+class d {
+  activeCache = null;
+  repoRootCache = null;
+  buf = /* @__PURE__ */ new Map();
+  callsiteCache = /* @__PURE__ */ 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 E(
+      new Error().stack ?? null,
+      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);
+  }
+  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, 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 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;
+        });
+    return {
+      schemaVersion: 1,
+      capturedAt: (/* @__PURE__ */ new Date()).toISOString(),
+      channels: e
+    };
+  }
+  reset() {
+    this.buf.clear(), this.callsiteCache.clear(), this.activeCache = null, this.repoRootCache = null;
+  }
+}
+function f(n) {
+  const e = /\(([^)]+):\d+:\d+\)\s*$/.exec(n);
+  if (e) return e[1] ?? null;
+  const t = /at\s+([^\s][^()]*?):\d+:\d+\s*$/.exec(n);
+  return t && (t[1] ?? "").trim() || null;
+}
+function E(n, e, t) {
+  if (!n) return null;
+  const i = n.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;
+    }
+    const c = f(s);
+    if (!c) {
+      t?.set(s, null);
+      continue;
+    }
+    if (c.includes(h)) {
+      t?.set(s, null);
+      continue;
+    }
+    const a = p(c, e);
+    return t?.set(s, a), a;
+  }
+  return null;
+}
+function p(n, e) {
+  let t = n;
+  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();
+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
+};

package/dist/interop-CT-REx0W.cjs

@@ -0,0 +1 @@
+"use strict";const n=require("./kernel-yWV3XnAb.cjs");function u(e,t){let r=!1;return n.effect(()=>{const s=e();r?n.untrack(()=>t(s)):r=!0})}function i(e){return{subscribe:t=>u(e,()=>t()),getSnapshot:e}}exports.subscribe=u;exports.toExternalStore=i;

package/dist/interop-CcY6ASQc.js

@@ -0,0 +1,18 @@
+import { e as n, u } from "./kernel-DgyrLFjW.js";
+function a(e, t) {
+  let r = !1;
+  return n(() => {
+    const s = e();
+    r ? u(() => t(s)) : r = !0;
+  });
+}
+function f(e) {
+  return {
+    subscribe: (t) => a(e, () => t()),
+    getSnapshot: e
+  };
+}
+export {
+  a as s,
+  f as t
+};

package/dist/kernel-DgyrLFjW.js

@@ -0,0 +1,227 @@
+let l = null, v = 0, c = !1, I = 0;
+const a = [];
+let h, r = null;
+function f(s) {
+  const e = s.owned;
+  if (e !== null) {
+    s.owned = null;
+    for (let t = e.length - 1; t >= 0; t--) e[t].dispose();
+  }
+  const i = s.cleanups;
+  if (i !== null) {
+    s.cleanups = null;
+    for (let t = i.length - 1; t >= 0; t--) i[t]();
+  }
+}
+function d(s) {
+  r !== null && (r.owned ??= []).push(s);
+}
+function D(s, e) {
+  const i = e.depsTail;
+  if (i !== void 0 && i.source === s) {
+    i.version = s.version;
+    return;
+  }
+  const t = i !== void 0 ? i.nextDep : e.deps;
+  if (t !== void 0 && t.source === s) {
+    t.version = s.version, e.depsTail = t;
+    return;
+  }
+  const n = O(s, e, i, t);
+  n.version = s.version, i !== void 0 ? i.nextDep = n : e.deps = n, t !== void 0 && (t.prevDep = n), e.depsTail = n, n.prevSub = s.subsTail, s.subsTail !== void 0 ? s.subsTail.nextSub = n : s.subs = n, s.subsTail = n;
+}
+function O(s, e, i, t) {
+  const n = h;
+  return n !== void 0 ? (h = n.nextDep, n.source = s, n.target = e, n.version = 0, n.prevDep = i, n.nextDep = t, n.prevSub = void 0, n.nextSub = void 0, n) : { source: s, target: e, version: 0, prevSub: void 0, nextSub: void 0, prevDep: i, nextDep: t };
+}
+function p(s) {
+  const { source: e, target: i, prevDep: t, nextDep: n, prevSub: o, nextSub: u } = s;
+  return t !== void 0 ? t.nextDep = n : i.deps = n, n !== void 0 && (n.prevDep = t), o !== void 0 ? o.nextSub = u : e.subs = u, u !== void 0 ? u.prevSub = o : e.subsTail = o, s.prevDep = void 0, s.prevSub = void 0, s.nextSub = void 0, s.nextDep = h, h = s, n;
+}
+function T(s) {
+  s.depsTail = void 0;
+}
+function g(s) {
+  const e = s.depsTail;
+  let i = e !== void 0 ? e.nextDep : s.deps;
+  for (; i !== void 0; ) i = p(i);
+}
+function S(s) {
+  for (let e = s.deps; e !== void 0; e = e.nextDep)
+    if (e.source.refresh(), e.version !== e.source.version) return !0;
+  return !1;
+}
+function b(s) {
+  for (let e = s.subs; e !== void 0; e = e.nextSub)
+    e.target.notify();
+}
+class w {
+  value;
+  eq;
+  version = 0;
+  subs = void 0;
+  subsTail = void 0;
+  constructor(e, i) {
+    this.value = e, this.eq = i;
+  }
+  refresh() {
+  }
+  get() {
+    return l !== null && D(this, l), this.value;
+  }
+  set(e) {
+    this.eq(this.value, e) || (this.value = e, this.version++, this.subs !== void 0 && (b(this), v === 0 && E()));
+  }
+}
+class N {
+  value;
+  // assigned by the first refresh, which always runs before any read
+  fn;
+  eq;
+  version = 0;
+  subs = void 0;
+  subsTail = void 0;
+  deps = void 0;
+  depsTail = void 0;
+  flags = 4;
+  cleanups = null;
+  owned = null;
+  constructor(e, i) {
+    this.fn = e, this.eq = i;
+  }
+  refresh() {
+    if (this.flags & 9 || (this.flags &= -3, !(this.flags & 4) && this.version !== 0) || (this.flags &= -5, this.version !== 0 && !S(this))) return;
+    this.flags |= 1, f(this), T(this);
+    const e = l, i = r;
+    l = this, r = this;
+    try {
+      const t = this.fn();
+      (this.version === 0 || !this.eq(this.value, t)) && (this.value = t, this.version++);
+    } finally {
+      l = e, r = i, g(this), this.flags &= -2;
+    }
+  }
+  get() {
+    return this.flags & 1 ? this.value : (this.refresh(), l !== null && D(this, l), this.value);
+  }
+  notify() {
+    this.flags & 2 || (this.flags |= 6, b(this));
+  }
+  dispose() {
+    if (this.flags & 8) return;
+    this.flags |= 8;
+    let e = this.deps;
+    for (; e !== void 0; ) e = p(e);
+    this.depsTail = void 0, f(this);
+  }
+}
+class y {
+  fn;
+  deps = void 0;
+  depsTail = void 0;
+  flags = 0;
+  lastFlush = 0;
+  // the flush generation this effect last ran in (cycle backstop)
+  cleanups = null;
+  owned = null;
+  constructor(e) {
+    this.fn = e;
+  }
+  notify() {
+    this.flags & 2 || (this.flags |= 18, a.push(this));
+  }
+  run() {
+    if (this.flags & 8) return;
+    f(this), T(this);
+    const e = l, i = r;
+    l = this, r = this;
+    try {
+      this.fn();
+    } finally {
+      l = e, r = i, g(this);
+    }
+  }
+  dispose() {
+    if (this.flags & 8) return;
+    this.flags |= 8;
+    let e = this.deps;
+    for (; e !== void 0; ) e = p(e);
+    this.depsTail = void 0, f(this);
+  }
+}
+function E() {
+  if (c) return;
+  c = !0;
+  const s = ++I;
+  let e = 0, i, t = !1;
+  try {
+    for (let n = 0; n < a.length; n++) {
+      const o = a[n];
+      if (o.flags &= -19, !(o.flags & 8) && S(o)) {
+        if (o.lastFlush === s && ++e > 1e5)
+          throw new Error(
+            "reactive flush did not settle after 100000 cascading re-runs (an effect likely writes a signal it depends on — a cycle)"
+          );
+        o.lastFlush = s;
+        try {
+          o.run();
+        } catch (u) {
+          t || (i = u, t = !0);
+        }
+      }
+    }
+  } finally {
+    a.length = 0, c = !1;
+  }
+  if (t) throw i;
+}
+function x(s, e = Object.is) {
+  const i = new w(s, e);
+  return [() => i.get(), (t) => i.set(t)];
+}
+function A(s, e = Object.is) {
+  const i = new N(s, e);
+  return d(i), () => i.get();
+}
+function U(s) {
+  const e = new y(s);
+  return d(e), e.run(), () => e.dispose();
+}
+function F(s) {
+  v++;
+  try {
+    s();
+  } finally {
+    --v === 0 && E();
+  }
+}
+function k(s) {
+  const e = l;
+  l = null;
+  try {
+    return s();
+  } finally {
+    l = e;
+  }
+}
+function P(s) {
+  const e = { cleanups: null, owned: null }, i = r;
+  r = e;
+  try {
+    return s(() => f(e));
+  } finally {
+    r = i;
+  }
+}
+function C(s) {
+  r !== null && (r.cleanups ??= []).push(s);
+}
+export {
+  F as b,
+  A as c,
+  U as e,
+  C as o,
+  P as r,
+  x as s,
+  k as u
+};

package/dist/kernel-yWV3XnAb.cjs

@@ -0,0 +1 @@
+"use strict";let l=null,v=0,c=!1,I=0;const a=[];let h,r=null;function f(s){const e=s.owned;if(e!==null){s.owned=null;for(let i=e.length-1;i>=0;i--)e[i].dispose()}const t=s.cleanups;if(t!==null){s.cleanups=null;for(let i=t.length-1;i>=0;i--)t[i]()}}function d(s){r!==null&&(r.owned??=[]).push(s)}function D(s,e){const t=e.depsTail;if(t!==void 0&&t.source===s){t.version=s.version;return}const i=t!==void 0?t.nextDep:e.deps;if(i!==void 0&&i.source===s){i.version=s.version,e.depsTail=i;return}const n=O(s,e,t,i);n.version=s.version,t!==void 0?t.nextDep=n:e.deps=n,i!==void 0&&(i.prevDep=n),e.depsTail=n,n.prevSub=s.subsTail,s.subsTail!==void 0?s.subsTail.nextSub=n:s.subs=n,s.subsTail=n}function O(s,e,t,i){const n=h;return n!==void 0?(h=n.nextDep,n.source=s,n.target=e,n.version=0,n.prevDep=t,n.nextDep=i,n.prevSub=void 0,n.nextSub=void 0,n):{source:s,target:e,version:0,prevSub:void 0,nextSub:void 0,prevDep:t,nextDep:i}}function p(s){const{source:e,target:t,prevDep:i,nextDep:n,prevSub:o,nextSub:u}=s;return i!==void 0?i.nextDep=n:t.deps=n,n!==void 0&&(n.prevDep=i),o!==void 0?o.nextSub=u:e.subs=u,u!==void 0?u.prevSub=o:e.subsTail=o,s.prevDep=void 0,s.prevSub=void 0,s.nextSub=void 0,s.nextDep=h,h=s,n}function T(s){s.depsTail=void 0}function g(s){const e=s.depsTail;let t=e!==void 0?e.nextDep:s.deps;for(;t!==void 0;)t=p(t)}function S(s){for(let e=s.deps;e!==void 0;e=e.nextDep)if(e.source.refresh(),e.version!==e.source.version)return!0;return!1}function b(s){for(let e=s.subs;e!==void 0;e=e.nextSub)e.target.notify()}class w{value;eq;version=0;subs=void 0;subsTail=void 0;constructor(e,t){this.value=e,this.eq=t}refresh(){}get(){return l!==null&&D(this,l),this.value}set(e){this.eq(this.value,e)||(this.value=e,this.version++,this.subs!==void 0&&(b(this),v===0&&E()))}}class N{value;fn;eq;version=0;subs=void 0;subsTail=void 0;deps=void 0;depsTail=void 0;flags=4;cleanups=null;owned=null;constructor(e,t){this.fn=e,this.eq=t}refresh(){if(this.flags&9||(this.flags&=-3,!(this.flags&4)&&this.version!==0)||(this.flags&=-5,this.version!==0&&!S(this)))return;this.flags|=1,f(this),T(this);const e=l,t=r;l=this,r=this;try{const i=this.fn();(this.version===0||!this.eq(this.value,i))&&(this.value=i,this.version++)}finally{l=e,r=t,g(this),this.flags&=-2}}get(){return this.flags&1?this.value:(this.refresh(),l!==null&&D(this,l),this.value)}notify(){this.flags&2||(this.flags|=6,b(this))}dispose(){if(this.flags&8)return;this.flags|=8;let e=this.deps;for(;e!==void 0;)e=p(e);this.depsTail=void 0,f(this)}}class y{fn;deps=void 0;depsTail=void 0;flags=0;lastFlush=0;cleanups=null;owned=null;constructor(e){this.fn=e}notify(){this.flags&2||(this.flags|=18,a.push(this))}run(){if(this.flags&8)return;f(this),T(this);const e=l,t=r;l=this,r=this;try{this.fn()}finally{l=e,r=t,g(this)}}dispose(){if(this.flags&8)return;this.flags|=8;let e=this.deps;for(;e!==void 0;)e=p(e);this.depsTail=void 0,f(this)}}function E(){if(c)return;c=!0;const s=++I;let e=0,t,i=!1;try{for(let n=0;n<a.length;n++){const o=a[n];if(o.flags&=-19,!(o.flags&8)&&S(o)){if(o.lastFlush===s&&++e>1e5)throw new Error("reactive flush did not settle after 100000 cascading re-runs (an effect likely writes a signal it depends on — a cycle)");o.lastFlush=s;try{o.run()}catch(u){i||(t=u,i=!0)}}}}finally{a.length=0,c=!1}if(i)throw t}function x(s,e=Object.is){const t=new w(s,e);return[()=>t.get(),i=>t.set(i)]}function A(s,e=Object.is){const t=new N(s,e);return d(t),()=>t.get()}function U(s){const e=new y(s);return d(e),e.run(),()=>e.dispose()}function k(s){v++;try{s()}finally{--v===0&&E()}}function F(s){const e=l;l=null;try{return s()}finally{l=e}}function C(s){const e={cleanups:null,owned:null},t=r;r=e;try{return s(()=>f(e))}finally{r=t}}function P(s){r!==null&&(r.cleanups??=[]).push(s)}exports.batch=k;exports.computed=A;exports.effect=U;exports.onCleanup=P;exports.root=C;exports.signal=x;exports.untrack=F;

package/dist/primitives.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r=require("./typed_arrays-D3NmwtCG.cjs"),t=require("./topological_sort-BDvEyb9W.cjs");class o{_dense=[];_sparse=[];get size(){return this._dense.length}get values(){return this._dense}has(e){return this._dense[this._sparse[e]]===e}add(e){this.has(e)||(this._sparse[e]=this._dense.length,this._dense.push(e))}delete(e){if(!this.has(e))return!1;const a=this._sparse[e],s=this._dense[this._dense.length-1];return this._dense[a]=s,this._sparse[s]=a,this._dense.pop(),!0}clear(){this._dense.length=0,this._sparse.length=0}[Symbol.iterator](){return this._dense[Symbol.iterator]()}}exports.BitSet=r.BitSet;exports.GrowableFloat32Array=r.GrowableFloat32Array;exports.GrowableFloat64Array=r.GrowableFloat64Array;exports.GrowableInt16Array=r.GrowableInt16Array;exports.GrowableInt32Array=r.GrowableInt32Array;exports.GrowableInt8Array=r.GrowableInt8Array;exports.GrowableTypedArray=r.GrowableTypedArray;exports.GrowableUint16Array=r.GrowableUint16Array;exports.GrowableUint32Array=r.GrowableUint32Array;exports.GrowableUint8Array=r.GrowableUint8Array;exports.BinaryHeap=t.BinaryHeap;exports.SparseMap=t.SparseMap;exports.topologicalSort=t.topologicalSort;exports.SparseSet=o;

package/dist/primitives.d.cts

@@ -0,0 +1,18 @@
+/**
+ * `@oasys/oecs/primitives` — the general-purpose data-structure primitives the
+ * ECS is built on, surfaced for direct consumer use: a bit set, sparse set/map,
+ * growable typed arrays, a binary heap, and a topological sort.
+ *
+ * These are the low-level building blocks only; the ECS itself is the default
+ * `@oasys/oecs` entry. The internal assertion, brand, and error helpers under
+ * `src/type_primitives/` are intentionally NOT re-exported here.
+ *
+ * @module
+ */
+export { BitSet } from './type_primitives/bitset/bitset.cjs';
+export { SparseSet } from './type_primitives/sparse_set/sparse_set.cjs';
+export { SparseMap } from './type_primitives/sparse_map/sparse_map.cjs';
+export { GrowableTypedArray, GrowableFloat32Array, GrowableFloat64Array, GrowableInt8Array, GrowableInt16Array, GrowableInt32Array, GrowableUint8Array, GrowableUint16Array, GrowableUint32Array, type TypedArrayTag, type AnyTypedArray } from './type_primitives/typed_arrays/typed_arrays.cjs';
+export { BinaryHeap, type CompareFn } from './type_primitives/binary_heap/binary_heap.cjs';
+export { topologicalSort } from './type_primitives/topological_sort/topological_sort.cjs';
+//# sourceMappingURL=primitives.d.ts.map

package/dist/primitives.d.ts

@@ -0,0 +1,18 @@
+/**
+ * `@oasys/oecs/primitives` — the general-purpose data-structure primitives the
+ * ECS is built on, surfaced for direct consumer use: a bit set, sparse set/map,
+ * growable typed arrays, a binary heap, and a topological sort.
+ *
+ * These are the low-level building blocks only; the ECS itself is the default
+ * `@oasys/oecs` entry. The internal assertion, brand, and error helpers under
+ * `src/type_primitives/` are intentionally NOT re-exported here.
+ *
+ * @module
+ */
+export { BitSet } from './type_primitives/bitset/bitset.js';
+export { SparseSet } from './type_primitives/sparse_set/sparse_set.js';
+export { SparseMap } from './type_primitives/sparse_map/sparse_map.js';
+export { GrowableTypedArray, GrowableFloat32Array, GrowableFloat64Array, GrowableInt8Array, GrowableInt16Array, GrowableInt32Array, GrowableUint8Array, GrowableUint16Array, GrowableUint32Array, type TypedArrayTag, type AnyTypedArray } from './type_primitives/typed_arrays/typed_arrays.js';
+export { BinaryHeap, type CompareFn } from './type_primitives/binary_heap/binary_heap.js';
+export { topologicalSort } from './type_primitives/topological_sort/topological_sort.js';
+//# sourceMappingURL=primitives.d.ts.map

package/dist/primitives.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitives.d.ts","sourceRoot":"","sources":["../src/primitives.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,iCAAiC,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EACN,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,MAAM,6CAA6C,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,KAAK,SAAS,EAAE,MAAM,2CAA2C,CAAC;AACvF,OAAO,EAAE,eAAe,EAAE,MAAM,qDAAqD,CAAC"}

package/dist/primitives.js

@@ -0,0 +1,45 @@
+import { B as h, a as o, b as l, d as p, e as _, c as d, G as b, g as u, h as w, f as G } from "./typed_arrays-BcXcnzB4.js";
+import { B as y, S as A, t as S } from "./topological_sort-DK6EjpWa.js";
+class a {
+  _dense = [];
+  _sparse = [];
+  get size() {
+    return this._dense.length;
+  }
+  get values() {
+    return this._dense;
+  }
+  has(e) {
+    return this._dense[this._sparse[e]] === e;
+  }
+  add(e) {
+    this.has(e) || (this._sparse[e] = this._dense.length, this._dense.push(e));
+  }
+  delete(e) {
+    if (!this.has(e)) return !1;
+    const s = this._sparse[e], r = this._dense[this._dense.length - 1];
+    return this._dense[s] = r, this._sparse[r] = s, this._dense.pop(), !0;
+  }
+  clear() {
+    this._dense.length = 0, this._sparse.length = 0;
+  }
+  [Symbol.iterator]() {
+    return this._dense[Symbol.iterator]();
+  }
+}
+export {
+  y as BinaryHeap,
+  h as BitSet,
+  o as GrowableFloat32Array,
+  l as GrowableFloat64Array,
+  p as GrowableInt16Array,
+  _ as GrowableInt32Array,
+  d as GrowableInt8Array,
+  b as GrowableTypedArray,
+  u as GrowableUint16Array,
+  w as GrowableUint32Array,
+  G as GrowableUint8Array,
+  A as SparseMap,
+  a as SparseSet,
+  S as topologicalSort
+};

package/dist/reactive/array.d.cts

@@ -0,0 +1,24 @@
+export interface ReactiveArray<T> {
+    /** Read slot `i`, subscribing to that slot (or to structure if out of range). */
+    get(i: number): T | undefined;
+    /** Element count, tracking structure (length changes only, not value updates). */
+    length(): number;
+    /**
+     * Whole-array snapshot. Tracks structure AND every slot value — the COARSE read
+     * (any slot change wakes it). Use `length()` + `get(i)` for the fine-grained path;
+     * `snapshot()` is for feeding a positional array to a Solid `<Index each>`.
+     */
+    snapshot(): readonly T[];
+    /** Fine-grained slot write. Updating an in-range slot wakes only that slot's readers. */
+    set(i: number, value: T): void;
+    /** Append one element; bumps structure. */
+    push(value: T): void;
+    /** Remove + return the last element; bumps structure. */
+    pop(): T | undefined;
+    /** Array-semantics splice; positionally reconciles so only shifted slots wake. */
+    splice(start: number, deleteCount?: number, ...items: T[]): T[];
+    /** Structural-sharing bulk replace: diff vs current, write only changed slots. */
+    reconcile(next: readonly T[]): void;
+}
+export declare function reactiveArray<T>(initial?: readonly T[], eq?: (a: T, b: T) => boolean): ReactiveArray<T>;
+//# sourceMappingURL=array.d.ts.map

package/dist/reactive/array.d.ts

@@ -0,0 +1,24 @@
+export interface ReactiveArray<T> {
+    /** Read slot `i`, subscribing to that slot (or to structure if out of range). */
+    get(i: number): T | undefined;
+    /** Element count, tracking structure (length changes only, not value updates). */
+    length(): number;
+    /**
+     * Whole-array snapshot. Tracks structure AND every slot value — the COARSE read
+     * (any slot change wakes it). Use `length()` + `get(i)` for the fine-grained path;
+     * `snapshot()` is for feeding a positional array to a Solid `<Index each>`.
+     */
+    snapshot(): readonly T[];
+    /** Fine-grained slot write. Updating an in-range slot wakes only that slot's readers. */
+    set(i: number, value: T): void;
+    /** Append one element; bumps structure. */
+    push(value: T): void;
+    /** Remove + return the last element; bumps structure. */
+    pop(): T | undefined;
+    /** Array-semantics splice; positionally reconciles so only shifted slots wake. */
+    splice(start: number, deleteCount?: number, ...items: T[]): T[];
+    /** Structural-sharing bulk replace: diff vs current, write only changed slots. */
+    reconcile(next: readonly T[]): void;
+}
+export declare function reactiveArray<T>(initial?: readonly T[], eq?: (a: T, b: T) => boolean): ReactiveArray<T>;
+//# sourceMappingURL=array.d.ts.map

package/dist/reactive/array.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"array.d.ts","sourceRoot":"","sources":["../../src/reactive/array.ts"],"names":[],"mappings":"AA2CA,MAAM,WAAW,aAAa,CAAC,CAAC;IAC/B,iFAAiF;IACjF,GAAG,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC;IAC9B,kFAAkF;IAClF,MAAM,IAAI,MAAM,CAAC;IACjB;;;;OAIG;IACH,QAAQ,IAAI,SAAS,CAAC,EAAE,CAAC;IACzB,yFAAyF;IACzF,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;IAC/B,2CAA2C;IAC3C,IAAI,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;IACrB,yDAAyD;IACzD,GAAG,IAAI,CAAC,GAAG,SAAS,CAAC;IACrB,kFAAkF;IAClF,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;IAChE,kFAAkF;IAClF,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,GAAG,IAAI,CAAC;CACpC;AAED,wBAAgB,aAAa,CAAC,CAAC,EAC9B,OAAO,GAAE,SAAS,CAAC,EAAO,EAC1B,EAAE,GAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,OAAmB,GACrC,aAAa,CAAC,CAAC,CAAC,CAmGlB"}

package/dist/reactive/index.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("../kernel-yWV3XnAb.cjs"),t=require("../shallow-DQ8aG51_.cjs"),r=require("../interop-CT-REx0W.cjs");exports.batch=e.batch;exports.computed=e.computed;exports.effect=e.effect;exports.onCleanup=e.onCleanup;exports.root=e.root;exports.signal=e.signal;exports.untrack=e.untrack;exports.reactiveArray=t.reactiveArray;exports.reactiveMap=t.reactiveMap;exports.reactiveStruct=t.reactiveStruct;exports.shallow=t.shallow;exports.subscribe=r.subscribe;exports.toExternalStore=r.toExternalStore;

package/dist/reactive/index.d.cts

@@ -0,0 +1,11 @@
+/**
+ * Reactive kernel — the engine UI seam's fine-grained, glitch-free reactive core
+ * (ADR-0021). Zero dependencies; consumer owns rendering. See docs/api/reactive.md.
+ */
+export { signal, computed, effect, batch, untrack, root, onCleanup, type Accessor, type Setter, type Eq } from './kernel.cjs';
+export { reactiveMap, type ReactiveMap } from './map.cjs';
+export { reactiveStruct, type StructSetters, type StructEq } from './struct.cjs';
+export { reactiveArray, type ReactiveArray } from './array.cjs';
+export { subscribe, toExternalStore, type ExternalStore } from './interop.cjs';
+export { shallow } from './shallow.cjs';
+//# sourceMappingURL=index.d.ts.map

package/dist/reactive/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Reactive kernel — the engine UI seam's fine-grained, glitch-free reactive core
+ * (ADR-0021). Zero dependencies; consumer owns rendering. See docs/api/reactive.md.
+ */
+export { signal, computed, effect, batch, untrack, root, onCleanup, type Accessor, type Setter, type Eq } from './kernel.js';
+export { reactiveMap, type ReactiveMap } from './map.js';
+export { reactiveStruct, type StructSetters, type StructEq } from './struct.js';
+export { reactiveArray, type ReactiveArray } from './array.js';
+export { subscribe, toExternalStore, type ExternalStore } from './interop.js';
+export { shallow } from './shallow.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/reactive/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/reactive/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EACN,MAAM,EACN,QAAQ,EACR,MAAM,EACN,KAAK,EACL,OAAO,EACP,IAAI,EACJ,SAAS,EACT,KAAK,QAAQ,EACb,KAAK,MAAM,EACX,KAAK,EAAE,EACP,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,WAAW,EAAE,KAAK,WAAW,EAAE,MAAM,OAAO,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,KAAK,aAAa,EAAE,KAAK,QAAQ,EAAE,MAAM,UAAU,CAAC;AAC7E,OAAO,EAAE,aAAa,EAAE,KAAK,aAAa,EAAE,MAAM,SAAS,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,KAAK,aAAa,EAAE,MAAM,WAAW,CAAC;AAC3E,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC"}

package/dist/reactive/index.js

@@ -0,0 +1,18 @@
+import { b as r, c as e, e as t, o, r as c, s as p, u } from "../kernel-DgyrLFjW.js";
+import { b as f, r as i, a as l, s as n } from "../shallow-DfnAm9vG.js";
+import { s as x, t as v } from "../interop-CcY6ASQc.js";
+export {
+  r as batch,
+  e as computed,
+  t as effect,
+  o as onCleanup,
+  f as reactiveArray,
+  i as reactiveMap,
+  l as reactiveStruct,
+  c as root,
+  n as shallow,
+  p as signal,
+  x as subscribe,
+  v as toExternalStore,
+  u as untrack
+};