@oasys/oecs 0.4.0 → 0.5.1

package/dist/extensions/reactive/ecs_sync.d.ts

@@ -1,12 +1,7 @@
-import { ReactiveArray, ReactiveMap, StructSetters } from '../../core/reactive';
-import { ComponentDef, ComponentSchema, ECS, EntityID, SystemAccessDeclaration } from '../../core/ecs';
-/**
- * Shallow (one-level) value equality — the recommended `eq` for object-valued
- * projections. Mirrors zustand `useShallow` / MobX `comparer.shallow`: two objects
- * are equal iff they have the same own keys with `Object.is`-equal values. Restores
- * "equal write wakes nobody" for projections that build a fresh object each tick.
- */
-export declare function shallow(a: object, b: object): boolean;
+import { ReactiveArray, ReactiveMap, StructSetters, StructEq } from '../../reactive/index.js';
+import { ComponentDef, ComponentSchema, ECS, EntityID, SystemAccessDeclaration } from '../../core/ecs/index.js';
+import { shallow } from '../../reactive/shallow.js';
+export { shallow };
 /**
  * A read cursor over one entity's single-component state, handed to a single-
  * component `Projection`. `field` is column-backed under "column" grain
@@ -32,16 +27,19 @@ export interface RowReader<S extends ComponentSchema> {
  * Lifetime: like `RowReader`, a reused mutable singleton valid ONLY during the
  * synchronous `project` call — never capture it; the next dispatch mutates it.
  */
-export interface JoinReader {
+export interface JoinReader<Schemas extends readonly ComponentSchema[] = readonly ComponentSchema[]> {
     /** The current entity (it has all joined components). */
     readonly eid: EntityID;
-    /** Read a field of one joined component for the current entity. */
-    field<S extends ComponentSchema, K extends string & keyof S>(def: ComponentDef<S>, name: K): number;
+    /** Read a field of one joined component for the current entity. `def` is
+     * constrained to the join's own component set — reading a def outside the
+     * join is the stale-read footgun the module header warns about (its changes
+     * aren't subscribed), so it's a compile error. */
+    field<S extends Schemas[number], K extends string & keyof S>(def: ComponentDef<S>, name: K): number;
 }
 /** Map one single-component row to the value a UI cell reads. */
 export type Projection<S extends ComponentSchema, V> = (row: RowReader<S>) => V;
 /** Map one joined entity to the value a UI cell reads. */
-export type JoinProjection<V> = (row: JoinReader) => V;
+export type JoinProjection<V, Schemas extends readonly ComponentSchema[] = readonly ComponentSchema[]> = (row: JoinReader<Schemas>) => V;
 /** Per-component dirty grain. See the module header for the measured crossover. */
 export type SyncGrain = "entity" | "column";
 export interface EcsMapSyncOptions<V> {
@@ -55,7 +53,7 @@ export interface EcsMapSyncOptions<V> {
     eq?: (a: V, b: V) => boolean;
     /**
      * Access surface the projection touches, merged over the synced components'
-     * `reads`. `__DEV__` access-checks the observer callbacks exactly like a system.
+     * `reads`. `DEV` access-checks the observer callbacks exactly like a system.
      */
     access?: Partial<SystemAccessDeclaration>;
     /**
@@ -79,7 +77,7 @@ export interface EcsMapSync<V> {
  * To read more than one component per row, use `syncJoinToMap` — reading a second
  * component here goes stale (its changes aren't subscribed).
  */
-export declare function syncComponentToMap<S extends ComponentSchema, V>(world: ECS, def: ComponentDef<S>, project: Projection<S, V>, opts?: EcsMapSyncOptions<V>): EcsMapSync<V>;
+export declare function syncComponentToMap<S extends ComponentSchema, V>(ecs: ECS, def: ComponentDef<S>, project: Projection<S, V>, opts?: EcsMapSyncOptions<V>): EcsMapSync<V>;
 /**
  * Sugar over `syncComponentToMap`: project a fixed FIELD LIST into a `{ field:
  * value }` snapshot, with an automatic `shallow` eq so an unchanged row wakes
@@ -93,7 +91,7 @@ export declare function syncComponentToMap<S extends ComponentSchema, V>(world:
  * or hand-written-`eq` projection, so the hot path doesn't allocate exactly where
  * the column grain is meant to keep it cheap.
  */
-export declare function syncFieldsToMap<S extends ComponentSchema, const F extends readonly (string & keyof S)[]>(world: ECS, def: ComponentDef<S>, fields: F, opts?: Omit<EcsMapSyncOptions<{
+export declare function syncFieldsToMap<S extends ComponentSchema, const F extends readonly (string & keyof S)[]>(ecs: ECS, def: ComponentDef<S>, fields: F, opts?: Omit<EcsMapSyncOptions<{
     [K in F[number]]: number;
 }>, "eq">): EcsMapSync<{
     [K in F[number]]: number;
@@ -109,7 +107,9 @@ export declare function syncFieldsToMap<S extends ComponentSchema, const F exten
  * Entity grain only: a join spans archetypes, so there is no single column to
  * sweep. Drive with `batchedUpdate(world, dt)`.
  */
-export declare function syncJoinToMap<V>(world: ECS, defs: readonly ComponentDef[], project: JoinProjection<V>, opts?: Omit<EcsMapSyncOptions<V>, "grain">): EcsMapSync<V>;
+export declare function syncJoinToMap<Schemas extends readonly ComponentSchema[], V>(ecs: ECS, defs: readonly [...{
+    [I in keyof Schemas]: ComponentDef<Schemas[I]>;
+}], project: JoinProjection<V, Schemas>, opts?: Omit<EcsMapSyncOptions<V>, "grain">): EcsMapSync<V>;
 export interface SingletonStructSync<V extends object> {
     /** The live per-field channel: reading `struct.field` in a tracked scope
      * subscribes to that field alone (pair with `fromKernelStruct` to render). */
@@ -120,7 +120,7 @@ export interface SingletonStructSync<V extends object> {
 export interface SingletonSyncOptions<V extends object = Record<string, number>> {
     /**
      * Access surface the publish touches, merged over the synced def's read.
-     * `__DEV__` access-checks the observer callbacks exactly like a system.
+     * `DEV` access-checks the observer callbacks exactly like a system.
      */
     access?: Partial<SystemAccessDeclaration>;
     /** Replay current state on registration (default `true`). flecs `yieldExisting`. */
@@ -134,6 +134,10 @@ export interface SingletonSyncOptions<V extends object = Record<string, number>>
      * the eager initials with the entity's current values on registration.
      */
     into?: readonly [V, StructSetters<V>];
+    /** Per-field equality overrides for the created struct (parity with
+     * `SingletonArraySyncOptions.eq`). Ignored when `into` supplies a
+     * pre-created struct — that struct already carries its own `eq`. */
+    eq?: StructEq<V>;
 }
 /**
  * Sync ONE singleton entity's single-component state into a `reactiveStruct`,
@@ -165,7 +169,7 @@ export interface SingletonSyncOptions<V extends object = Record<string, number>>
  * or the zeros of a freshly-created one — captured (untracked) at registration, NOT a
  * blind 0. A singleton is rarely despawned; this keeps the channel well-defined if it is.
  */
-export declare function syncSingletonToStruct<S extends ComponentSchema, const F extends readonly (string & keyof S)[]>(world: ECS, def: ComponentDef<S>, eid: EntityID, fields: F, opts?: SingletonSyncOptions<{
+export declare function syncSingletonToStruct<S extends ComponentSchema, const F extends readonly (string & keyof S)[]>(ecs: ECS, def: ComponentDef<S>, eid: EntityID, fields: F, opts?: SingletonSyncOptions<{
     [K in F[number]]: number;
 }>): SingletonStructSync<{
     [K in F[number]]: number;
@@ -197,14 +201,14 @@ export interface SingletonArraySyncOptions<T> {
  * `fields` is explicit (a `ComponentDef` is a branded number at runtime). Pair with
  * `@oasys/oecs/solid`'s `fromKernelArray` + a Solid `<Index>`.
  */
-export declare function syncSingletonToArray<S extends ComponentSchema>(world: ECS, def: ComponentDef<S>, eid: EntityID, fields: readonly (string & keyof S)[], opts?: SingletonArraySyncOptions<number>): SingletonArraySync<number>;
+export declare function syncSingletonToArray<S extends ComponentSchema>(ecs: ECS, def: ComponentDef<S>, eid: EntityID, fields: readonly (string & keyof S)[], opts?: SingletonArraySyncOptions<number>): SingletonArraySync<number>;
 /**
  * Advance the world one tick with every bridge publish coalesced into a single UI
  * flush. onAdd/onRemove fire mid-tick at flush boundaries and onSet fires at the
  * tick tail; wrapping the whole update in `batch` defers the effect flush until the
  * tick completes, so a frame that touched K entities (across any number of syncs on
  * this world) wakes its readers once, not once per observer dispatch point.
- * Equivalent to `batch(() => world.update(dt))`.
+ * Equivalent to `batch(() => ecs.update(dt))`.
  */
-export declare function batchedUpdate(world: ECS, dt: number): void;
+export declare function batchedUpdate(ecs: ECS, dt: number): void;
 //# sourceMappingURL=ecs_sync.d.ts.map

package/dist/extensions/reactive/ecs_sync.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ecs_sync.d.ts","sourceRoot":"","sources":["../../../src/extensions/reactive/ecs_sync.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ecs_sync.d.ts","sourceRoot":"","sources":["../../../src/extensions/reactive/ecs_sync.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0EG;AACH,OAAO,EAMN,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,QAAQ,EACb,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAEX,YAAY,EACZ,eAAe,EACf,GAAG,EACH,QAAQ,EAGR,uBAAuB,EAEvB,MAAM,gBAAgB,CAAC;AAKxB,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,CAAC;AAEnB;;;;;;;;;GASG;AACH,MAAM,WAAW,SAAS,CAAC,CAAC,SAAS,eAAe;IACnD,oDAAoD;IACpD,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC;IACvB,gEAAgE;IAChE,KAAK,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,MAAM,CAAC;CACnD;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,UAAU,CAAC,OAAO,SAAS,SAAS,eAAe,EAAE,GAAG,SAAS,eAAe,EAAE;IAClG,yDAAyD;IACzD,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC;IACvB;;;sDAGkD;IAClD,KAAK,CAAC,CAAC,SAAS,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,EAC1D,GAAG,EAAE,YAAY,CAAC,CAAC,CAAC,EACpB,IAAI,EAAE,CAAC,GACL,MAAM,CAAC;CACV;AAED,iEAAiE;AACjE,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,eAAe,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;AAChF,0DAA0D;AAC1D,MAAM,MAAM,cAAc,CACzB,CAAC,EACD,OAAO,SAAS,SAAS,eAAe,EAAE,GAAG,SAAS,eAAe,EAAE,IACpE,CAAC,GAAG,EAAE,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAEpC,mFAAmF;AACnF,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE5C,MAAM,WAAW,iBAAiB,CAAC,CAAC;IACnC,kFAAkF;IAClF,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB;;;;OAIG;IACH,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,OAAO,CAAC;IAC7B;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC,CAAC;IAC1C;;;;OAIG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,UAAU,CAAC,CAAC;IAC5B,+EAA+E;IAC/E,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;IACvC,mFAAmF;IACnF,OAAO,IAAI,IAAI,CAAC;CAChB;AAiED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,eAAe,EAAE,CAAC,EAC9D,GAAG,EAAE,GAAG,EACR,GAAG,EAAE,YAAY,CAAC,CAAC,CAAC,EACpB,OAAO,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,EACzB,IAAI,GAAE,iBAAiB,CAAC,CAAC,CAAM,GAC7B,UAAU,CAAC,CAAC,CAAC,CAyEf;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAC9B,CAAC,SAAS,eAAe,EACzB,KAAK,CAAC,CAAC,SAAS,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC,EAAE,EAE7C,GAAG,EAAE,GAAG,EACR,GAAG,EAAE,YAAY,CAAC,CAAC,CAAC,EACpB,MAAM,EAAE,CAAC,EACT,IAAI,GAAE,IAAI,CAAC,iBAAiB,CAAC;KAAG,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,GAAG,MAAM;CAAE,CAAC,EAAE,IAAI,CAAM,GACpE,UAAU,CAAC;KAAG,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,GAAG,MAAM;CAAE,CAAC,CAQ1C;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,OAAO,SAAS,SAAS,eAAe,EAAE,EAAE,CAAC,EAC1E,GAAG,EAAE,GAAG,EACR,IAAI,EAAE,SAAS,CAAC,GAAG;KAAG,CAAC,IAAI,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;CAAE,CAAC,EACtE,OAAO,EAAE,cAAc,CAAC,CAAC,EAAE,OAAO,CAAC,EAInC,IAAI,GAAE,IAAI,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,OAAO,CAAM,GAC5C,UAAU,CAAC,CAAC,CAAC,CAmEf;AAED,MAAM,WAAW,mBAAmB,CAAC,CAAC,SAAS,MAAM;IACpD;kFAC8E;IAC9E,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IACnB,gFAAgF;IAChF,OAAO,IAAI,IAAI,CAAC;CAChB;AAED,MAAM,WAAW,oBAAoB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAC9E;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC,CAAC;IAC1C,oFAAoF;IACpF,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;;;;;;OAOG;IACH,IAAI,CAAC,EAAE,SAAS,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;IACtC;;wEAEoE;IACpE,EAAE,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,qBAAqB,CACpC,CAAC,SAAS,eAAe,EACzB,KAAK,CAAC,CAAC,SAAS,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC,EAAE,EAE7C,GAAG,EAAE,GAAG,EACR,GAAG,EAAE,YAAY,CAAC,CAAC,CAAC,EACpB,GAAG,EAAE,QAAQ,EACb,MAAM,EAAE,CAAC,EACT,IAAI,GAAE,oBAAoB,CAAC;KAAG,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,GAAG,MAAM;CAAE,CAAM,GAC3D,mBAAmB,CAAC;KAAG,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,GAAG,MAAM;CAAE,CAAC,CA6DnD;AAED,MAAM,WAAW,kBAAkB,CAAC,CAAC;IACpC,oFAAoF;IACpF,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC;IACjC,gFAAgF;IAChF,OAAO,IAAI,IAAI,CAAC;CAChB;AAED,MAAM,WAAW,yBAAyB,CAAC,CAAC;IAC3C,MAAM,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC,CAAC;IAC1C,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,6FAA6F;IAC7F,IAAI,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC;IACxB,0EAA0E;IAC1E,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,OAAO,CAAC;CAC7B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,eAAe,EAC7D,GAAG,EAAE,GAAG,EACR,GAAG,EAAE,YAAY,CAAC,CAAC,CAAC,EACpB,GAAG,EAAE,QAAQ,EACb,MAAM,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC,EAAE,EACrC,IAAI,GAAE,yBAAyB,CAAC,MAAM,CAAM,GAC1C,kBAAkB,CAAC,MAAM,CAAC,CA2D5B;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAExD"}

package/dist/extensions/reactive/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const f=require("../../kernel-yWV3XnAb.cjs"),p=require("../../array-CxbPyiHO.cjs");function _(a,n){if(Object.is(a,n))return!0;const s=a,r=n,i=Object.keys(s);if(i.length!==Object.keys(r).length)return!1;for(let l=0;l<i.length;l++){const u=i[l];if(!Object.prototype.hasOwnProperty.call(r,u)||!Object.is(s[u],r[u]))return!1}return!0}class v{constructor(n){this.def=n}_ctx;_eid=0;get eid(){return this._eid}field(n){return this._ctx.getField(this._eid,this.def,n)}}class w{constructor(n){this.def=n}_eid=0;_row=0;cols=new Map;arch;bind(n){this.arch=n,this.cols.clear()}get eid(){return this._eid}field(n){let s=this.cols.get(n);return s===void 0&&(s=this.arch.getColumnRead(this.def,n),this.cols.set(n,s)),s[this._row]}}class E{_ctx;_eid=0;get eid(){return this._eid}field(n,s){return this._ctx.getField(this._eid,n,s)}}function m(a,n,s,r={}){const i=p.reactiveMap(r.eq),l={...r.access,reads:[n,...r.access?.reads??[]]},u=r.grain??"entity",d=r.seedExisting??!0,b=new v(n),h=(o,t)=>{t.isDisabled(o)||(b._ctx=t,b._eid=o,i.set(o,s(b)))};let g;return f.batch(()=>{if(u==="column"){const o=new w(n);g=a.observe(n,{granularity:"archetype",onSet:t=>{o.bind(t);const c=t.entityIds;for(let e=0;e<t.entityCount;e++)o._row=e,o._eid=c[e],i.set(o._eid,s(o))},onAdd:(t,c)=>h(t,c),onRemove:t=>i.delete(t),onDisable:t=>i.delete(t),onEnable:(t,c)=>h(t,c),access:l,yieldExisting:d})}else g=a.observe(n,{granularity:"entity",onSet:(o,t)=>h(o,t),onAdd:(o,t)=>h(o,t),onRemove:o=>i.delete(o),onDisable:o=>i.delete(o),onEnable:(o,t)=>h(o,t),access:l,yieldExisting:d})}),{map:i,dispose:()=>g.dispose()}}function S(a,n,s,r={}){return m(a,n,l=>{const u={};for(let d=0;d<s.length;d++)u[s[d]]=l.field(s[d]);return u},{...r,eq:_})}function R(a,n,s,r={}){const i=p.reactiveMap(r.eq),l={...r.access,reads:[...n,...r.access?.reads??[]]},u=r.seedExisting??!0,d=new E,b=(t,c)=>{for(let e=0;e<n.length;e++)if(!t.hasComponent(c,n[e]))return!1;return!0},h=(t,c)=>{c.isDisabled(t)||b(c,t)&&(d._ctx=c,d._eid=t,i.set(t,s(d)))},g=t=>{i.delete(t)};let o;return f.batch(()=>{o=n.map(t=>a.observe(t,{granularity:"entity",onSet:h,onAdd:h,onRemove:g,onDisable:g,onEnable:h,access:l,yieldExisting:u}))}),{map:i,dispose:()=>{for(let t=0;t<o.length;t++)o[t].dispose()}}}function T(a,n,s,r,i={}){const l={};for(let e=0;e<r.length;e++)l[r[e]]=0;const[u,d]=i.into??p.reactiveStruct(l),b=f.untrack(()=>r.map(e=>u[e])),h={...i.access,reads:[n,...i.access?.reads??[]]},g=i.seedExisting??!0,o=e=>{for(let y=0;y<r.length;y++)d[r[y]](e.getField(s,n,r[y]))},t=()=>{for(let e=0;e<r.length;e++)d[r[e]](b[e])};let c;return f.batch(()=>{c=a.observe(n,{granularity:"entity",onSet:(e,y)=>{e===s&&o(y)},onAdd:(e,y)=>{e===s&&!y.isDisabled(s)&&o(y)},onRemove:e=>{e===s&&t()},onDisable:e=>{e===s&&t()},onEnable:(e,y)=>{e===s&&o(y)},access:h,yieldExisting:g})}),{struct:u,dispose:()=>c.dispose()}}function x(a,n,s,r,i={}){const l=i.into??p.reactiveArray(new Array(r.length).fill(0),i.eq),u=f.untrack(()=>l.snapshot());if(i.into!==void 0&&u.length!==r.length)throw new Error(`syncSingletonToArray: into.length (${u.length}) must equal fields.length (${r.length})`);const d={...i.access,reads:[n,...i.access?.reads??[]]},b=i.seedExisting??!0,h=new Array(r.length),g=c=>{for(let e=0;e<r.length;e++)h[e]=c.getField(s,n,r[e]);l.reconcile(h)},o=()=>l.reconcile(u);let t;return f.batch(()=>{t=a.observe(n,{granularity:"entity",onSet:(c,e)=>{c===s&&g(e)},onAdd:(c,e)=>{c===s&&!e.isDisabled(s)&&g(e)},onRemove:c=>{c===s&&o()},onDisable:c=>{c===s&&o()},onEnable:(c,e)=>{c===s&&g(e)},access:d,yieldExisting:b})}),{array:l,dispose:()=>t.dispose()}}function A(a,n){f.batch(()=>a.update(n))}exports.batchedUpdate=A;exports.shallow=_;exports.syncComponentToMap=m;exports.syncFieldsToMap=S;exports.syncJoinToMap=R;exports.syncSingletonToArray=x;exports.syncSingletonToStruct=T;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const f=require("../../kernel-yWV3XnAb.cjs"),_=require("../../shallow-DQ8aG51_.cjs");class w{constructor(n){this.def=n}_ctx;_eid=0;get eid(){return this._eid}field(n){return this._ctx.getField(this._eid,this.def,n)}}class m{constructor(n){this.def=n}_eid=0;_row=0;cols=new Map;arch;bind(n){this.arch=n,this.cols.clear()}get eid(){return this._eid}field(n){let s=this.cols.get(n);return s===void 0&&(s=this.arch.getColumnRead(this.def,n),this.cols.set(n,s)),s[this._row]}}class v{_ctx;_eid=0;get eid(){return this._eid}field(n,s){return this._ctx.getField(this._eid,n,s)}}function p(l,n,s,r={}){const c=_.reactiveMap(r.eq),a={...r.access,reads:[n,...r.access?.reads??[]]},h=r.grain??"entity",u=r.seedExisting??!0,b=new w(n),y=(i,o)=>{o.isDisabled(i)||(b._ctx=o,b._eid=i,c.set(i,s(b)))};let g;return f.batch(()=>{if(h==="column"){const i=new m(n);g=l.observe(n,{granularity:"archetype",onSet:o=>{i.bind(o);const t=o.entityIds;for(let e=0;e<o.entityCount;e++)i._row=e,i._eid=t[e],c.set(i._eid,s(i))},onAdd:(o,t)=>y(o,t),onRemove:o=>c.delete(o),onDisable:o=>c.delete(o),onEnable:(o,t)=>y(o,t),access:a,yieldExisting:u})}else g=l.observe(n,{granularity:"entity",onSet:(i,o)=>y(i,o),onAdd:(i,o)=>y(i,o),onRemove:i=>c.delete(i),onDisable:i=>c.delete(i),onEnable:(i,o)=>y(i,o),access:a,yieldExisting:u})}),{map:c,dispose:()=>g.dispose()}}function E(l,n,s,r={}){return p(l,n,a=>{const h={};for(let u=0;u<s.length;u++)h[s[u]]=a.field(s[u]);return h},{...r,eq:_.shallow})}function S(l,n,s,r={}){const c=n,a=_.reactiveMap(r.eq),h={...r.access,reads:[...c,...r.access?.reads??[]]},u=r.seedExisting??!0,b=new v,y=(t,e)=>{for(let d=0;d<c.length;d++)if(!t.hasComponent(e,c[d]))return!1;return!0},g=(t,e)=>{e.isDisabled(t)||y(e,t)&&(b._ctx=e,b._eid=t,a.set(t,s(b)))},i=t=>{a.delete(t)};let o;return f.batch(()=>{o=c.map(t=>l.observe(t,{granularity:"entity",onSet:g,onAdd:g,onRemove:i,onDisable:i,onEnable:g,access:h,yieldExisting:u}))}),{map:a,dispose:()=>{for(let t=0;t<o.length;t++)o[t].dispose()}}}function R(l,n,s,r,c={}){const a={};for(let e=0;e<r.length;e++)a[r[e]]=0;const[h,u]=c.into??_.reactiveStruct(a,c.eq),b=f.untrack(()=>r.map(e=>h[e])),y={...c.access,reads:[n,...c.access?.reads??[]]},g=c.seedExisting??!0,i=e=>{for(let d=0;d<r.length;d++)u[r[d]](e.getField(s,n,r[d]))},o=()=>{for(let e=0;e<r.length;e++)u[r[e]](b[e])};let t;return f.batch(()=>{t=l.observe(n,{granularity:"entity",onSet:(e,d)=>{e===s&&i(d)},onAdd:(e,d)=>{e===s&&!d.isDisabled(s)&&i(d)},onRemove:e=>{e===s&&o()},onDisable:e=>{e===s&&o()},onEnable:(e,d)=>{e===s&&i(d)},access:y,yieldExisting:g})}),{struct:h,dispose:()=>t.dispose()}}function T(l,n,s,r,c={}){const a=c.into??_.reactiveArray(new Array(r.length).fill(0),c.eq),h=f.untrack(()=>a.snapshot());if(c.into!==void 0&&h.length!==r.length)throw new Error(`syncSingletonToArray: into.length (${h.length}) must equal fields.length (${r.length})`);const u={...c.access,reads:[n,...c.access?.reads??[]]},b=c.seedExisting??!0,y=new Array(r.length),g=t=>{for(let e=0;e<r.length;e++)y[e]=t.getField(s,n,r[e]);a.reconcile(y)},i=()=>a.reconcile(h);let o;return f.batch(()=>{o=l.observe(n,{granularity:"entity",onSet:(t,e)=>{t===s&&g(e)},onAdd:(t,e)=>{t===s&&!e.isDisabled(s)&&g(e)},onRemove:t=>{t===s&&i()},onDisable:t=>{t===s&&i()},onEnable:(t,e)=>{t===s&&g(e)},access:u,yieldExisting:b})}),{array:a,dispose:()=>o.dispose()}}function x(l,n){f.batch(()=>l.update(n))}exports.shallow=_.shallow;exports.batchedUpdate=x;exports.syncComponentToMap=p;exports.syncFieldsToMap=E;exports.syncJoinToMap=S;exports.syncSingletonToArray=T;exports.syncSingletonToStruct=R;

package/dist/extensions/reactive/index.d.cts

@@ -0,0 +1,23 @@
+/**
+ * The production ECS→UI reactive bridge (#672 / ADR-0021).
+ *
+ * Drains the engine's own change detection (ADR-0013 component observers, riding
+ * the ADR-0012 per-row dirty list) into a `reactiveMap` — publishing O(changed),
+ * not O(all), each tick. Declarative selection + closure projection (the Bevy
+ * `ExtractComponent` / WatermelonDB `observeWithColumns` shape):
+ *   - `syncComponentToMap(def, project)` — one component, grain `"entity"`/`"column"`.
+ *   - `syncFieldsToMap(def, [fields])` — field-list sugar with auto `shallow` eq.
+ *   - `syncJoinToMap([defs], project)` — multi-component join (subscribes all defs).
+ *
+ * For singleton/ephemeral UI state (net status+latency, FPS/mem, wave timer), model
+ * it as a component on a reserved singleton entity and read it keyless via per-field
+ * channels (#687 / ADR-0024) — NOT a separate reactive-resource subsystem:
+ *   - `syncSingletonToStruct(def, eid, [fields])` — one singleton entity → `reactiveStruct`.
+ *   - `syncSingletonToArray(def, eid, [fields])` — one singleton entity → `reactiveArray` (ordered slots).
+ *
+ * The framework-agnostic counterpart to the Solid leaf: pair the map entry points
+ * with `@oasys/oecs/solid`'s `fromKernelMap`, the singleton struct with
+ * `fromKernelStruct`, and the singleton array with `fromKernelArray`, to render.
+ */
+export { syncComponentToMap, syncFieldsToMap, syncJoinToMap, syncSingletonToStruct, syncSingletonToArray, batchedUpdate, shallow, type Projection, type JoinProjection, type RowReader, type JoinReader, type SyncGrain, type EcsMapSync, type EcsMapSyncOptions, type SingletonStructSync, type SingletonSyncOptions, type SingletonArraySync, type SingletonArraySyncOptions } from './ecs_sync.cjs';
+//# sourceMappingURL=index.d.ts.map

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

@@ -19,5 +19,5 @@
  * with `@oasys/oecs/solid`'s `fromKernelMap`, the singleton struct with
  * `fromKernelStruct`, and the singleton array with `fromKernelArray`, to render.
  */
-export { syncComponentToMap, syncFieldsToMap, syncJoinToMap, syncSingletonToStruct, syncSingletonToArray, batchedUpdate, shallow, type Projection, type JoinProjection, type RowReader, type JoinReader, type SyncGrain, type EcsMapSync, type EcsMapSyncOptions, type SingletonStructSync, type SingletonSyncOptions, type SingletonArraySync, type SingletonArraySyncOptions } from './ecs_sync';
+export { syncComponentToMap, syncFieldsToMap, syncJoinToMap, syncSingletonToStruct, syncSingletonToArray, batchedUpdate, shallow, type Projection, type JoinProjection, type RowReader, type JoinReader, type SyncGrain, type EcsMapSync, type EcsMapSyncOptions, type SingletonStructSync, type SingletonSyncOptions, type SingletonArraySync, type SingletonArraySyncOptions } from './ecs_sync.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/extensions/reactive/index.js

@@ -1,15 +1,5 @@
 import { b as f, u as _ } from "../../kernel-DgyrLFjW.js";
-import { r as p, a as m, b as E } from "../../array-uFR7Q8fU.js";
-function w(a, n) {
-  if (Object.is(a, n)) return !0;
-  const s = a, r = n, o = Object.keys(s);
-  if (o.length !== Object.keys(r).length) return !1;
-  for (let l = 0; l < o.length; l++) {
-    const u = o[l];
-    if (!Object.prototype.hasOwnProperty.call(r, u) || !Object.is(s[u], r[u])) return !1;
-  }
-  return !0;
-}
+import { r as m, s as E, a as p, b as w } from "../../shallow-DfnAm9vG.js";
 class v {
   constructor(n) {
     this.def = n;
@@ -53,173 +43,173 @@ class x {
     return this._ctx.getField(this._eid, n, s);
   }
 }
-function A(a, n, s, r = {}) {
-  const o = p(r.eq), l = {
+function A(l, n, s, r = {}) {
+  const c = m(r.eq), a = {
     ...r.access,
     reads: [n, ...r.access?.reads ?? []]
-  }, u = r.grain ?? "entity", d = r.seedExisting ?? !0, b = new v(n), h = (i, t) => {
-    t.isDisabled(i) || (b._ctx = t, b._eid = i, o.set(i, s(b)));
+  }, h = r.grain ?? "entity", u = r.seedExisting ?? !0, b = new v(n), y = (o, i) => {
+    i.isDisabled(o) || (b._ctx = i, b._eid = o, c.set(o, s(b)));
   };
   let g;
   return f(() => {
-    if (u === "column") {
-      const i = new R(n);
-      g = a.observe(n, {
+    if (h === "column") {
+      const o = new R(n);
+      g = l.observe(n, {
         granularity: "archetype",
-        onSet: (t) => {
-          i.bind(t);
-          const c = t.entityIds;
-          for (let e = 0; e < t.entityCount; e++)
-            i._row = e, i._eid = c[e], o.set(i._eid, s(i));
+        onSet: (i) => {
+          o.bind(i);
+          const t = i.entityIds;
+          for (let e = 0; e < i.entityCount; e++)
+            o._row = e, o._eid = t[e], c.set(o._eid, s(o));
         },
-        onAdd: (t, c) => h(t, c),
-        onRemove: (t) => o.delete(t),
+        onAdd: (i, t) => y(i, t),
+        onRemove: (i) => c.delete(i),
         // Disable = soft remove from the channel; enable = re-add (#677). The
         // column sweep is bounded by enabled rows, so a disabled row would never
         // refresh — drop it on disable, republish on enable.
-        onDisable: (t) => o.delete(t),
-        onEnable: (t, c) => h(t, c),
-        access: l,
-        yieldExisting: d
+        onDisable: (i) => c.delete(i),
+        onEnable: (i, t) => y(i, t),
+        access: a,
+        yieldExisting: u
       });
     } else
-      g = a.observe(n, {
+      g = l.observe(n, {
         granularity: "entity",
-        onSet: (i, t) => h(i, t),
-        onAdd: (i, t) => h(i, t),
-        onRemove: (i) => o.delete(i),
-        onDisable: (i) => o.delete(i),
-        onEnable: (i, t) => h(i, t),
-        access: l,
-        yieldExisting: d
+        onSet: (o, i) => y(o, i),
+        onAdd: (o, i) => y(o, i),
+        onRemove: (o) => c.delete(o),
+        onDisable: (o) => c.delete(o),
+        onEnable: (o, i) => y(o, i),
+        access: a,
+        yieldExisting: u
       });
-  }), { map: o, dispose: () => g.dispose() };
+  }), { map: c, dispose: () => g.dispose() };
 }
-function j(a, n, s, r = {}) {
-  return A(a, n, (l) => {
-    const u = {};
-    for (let d = 0; d < s.length; d++) u[s[d]] = l.field(s[d]);
-    return u;
-  }, { ...r, eq: w });
+function q(l, n, s, r = {}) {
+  return A(l, n, (a) => {
+    const h = {};
+    for (let u = 0; u < s.length; u++) h[s[u]] = a.field(s[u]);
+    return h;
+  }, { ...r, eq: E });
 }
-function M(a, n, s, r = {}) {
-  const o = p(r.eq), l = {
+function M(l, n, s, r = {}) {
+  const c = n, a = m(r.eq), h = {
     ...r.access,
-    reads: [...n, ...r.access?.reads ?? []]
-  }, u = r.seedExisting ?? !0, d = new x(), b = (t, c) => {
-    for (let e = 0; e < n.length; e++) if (!t.hasComponent(c, n[e])) return !1;
+    reads: [...c, ...r.access?.reads ?? []]
+  }, u = r.seedExisting ?? !0, b = new x(), y = (t, e) => {
+    for (let d = 0; d < c.length; d++) if (!t.hasComponent(e, c[d])) return !1;
     return !0;
-  }, h = (t, c) => {
-    c.isDisabled(t) || b(c, t) && (d._ctx = c, d._eid = t, o.set(t, s(d)));
-  }, g = (t) => {
-    o.delete(t);
+  }, g = (t, e) => {
+    e.isDisabled(t) || y(e, t) && (b._ctx = e, b._eid = t, a.set(t, s(b)));
+  }, o = (t) => {
+    a.delete(t);
   };
   let i;
   return f(() => {
-    i = n.map(
-      (t) => a.observe(t, {
+    i = c.map(
+      (t) => l.observe(t, {
         granularity: "entity",
-        onSet: h,
-        onAdd: h,
-        onRemove: g,
+        onSet: g,
+        onAdd: g,
+        onRemove: o,
         // Disabling any joined component soft-removes the entity from the
         // channel; enabling re-evaluates membership and republishes (#677). A
         // disable fires once per carried joined component — `dropRow` is
         // idempotent, and `publishIfMember` re-checks the full join.
-        onDisable: g,
-        onEnable: h,
-        access: l,
+        onDisable: o,
+        onEnable: g,
+        access: h,
         yieldExisting: u
       })
     );
   }), {
-    map: o,
+    map: a,
     dispose: () => {
       for (let t = 0; t < i.length; t++) i[t].dispose();
     }
   };
 }
-function O(a, n, s, r, o = {}) {
-  const l = {};
-  for (let e = 0; e < r.length; e++) l[r[e]] = 0;
-  const [u, d] = o.into ?? m(l), b = _(() => r.map((e) => u[e])), h = {
-    ...o.access,
-    reads: [n, ...o.access?.reads ?? []]
-  }, g = o.seedExisting ?? !0, i = (e) => {
-    for (let y = 0; y < r.length; y++) d[r[y]](e.getField(s, n, r[y]));
-  }, t = () => {
-    for (let e = 0; e < r.length; e++) d[r[e]](b[e]);
+function T(l, n, s, r, c = {}) {
+  const a = {};
+  for (let e = 0; e < r.length; e++) a[r[e]] = 0;
+  const [h, u] = c.into ?? p(a, c.eq), b = _(() => r.map((e) => h[e])), y = {
+    ...c.access,
+    reads: [n, ...c.access?.reads ?? []]
+  }, g = c.seedExisting ?? !0, o = (e) => {
+    for (let d = 0; d < r.length; d++) u[r[d]](e.getField(s, n, r[d]));
+  }, i = () => {
+    for (let e = 0; e < r.length; e++) u[r[e]](b[e]);
   };
-  let c;
+  let t;
   return f(() => {
-    c = a.observe(n, {
+    t = l.observe(n, {
       granularity: "entity",
-      onSet: (e, y) => {
-        e === s && i(y);
+      onSet: (e, d) => {
+        e === s && o(d);
       },
-      onAdd: (e, y) => {
-        e === s && !y.isDisabled(s) && i(y);
+      onAdd: (e, d) => {
+        e === s && !d.isDisabled(s) && o(d);
       },
       onRemove: (e) => {
-        e === s && t();
+        e === s && i();
       },
       onDisable: (e) => {
-        e === s && t();
+        e === s && i();
       },
-      onEnable: (e, y) => {
-        e === s && i(y);
+      onEnable: (e, d) => {
+        e === s && o(d);
       },
-      access: h,
+      access: y,
       yieldExisting: g
     });
-  }), { struct: u, dispose: () => c.dispose() };
+  }), { struct: h, dispose: () => t.dispose() };
 }
-function T(a, n, s, r, o = {}) {
-  const l = o.into ?? E(new Array(r.length).fill(0), o.eq), u = _(() => l.snapshot());
-  if (o.into !== void 0 && u.length !== r.length)
+function C(l, n, s, r, c = {}) {
+  const a = c.into ?? w(new Array(r.length).fill(0), c.eq), h = _(() => a.snapshot());
+  if (c.into !== void 0 && h.length !== r.length)
     throw new Error(
-      `syncSingletonToArray: into.length (${u.length}) must equal fields.length (${r.length})`
+      `syncSingletonToArray: into.length (${h.length}) must equal fields.length (${r.length})`
     );
-  const d = {
-    ...o.access,
-    reads: [n, ...o.access?.reads ?? []]
-  }, b = o.seedExisting ?? !0, h = new Array(r.length), g = (c) => {
-    for (let e = 0; e < r.length; e++) h[e] = c.getField(s, n, r[e]);
-    l.reconcile(h);
-  }, i = () => l.reconcile(u);
-  let t;
+  const u = {
+    ...c.access,
+    reads: [n, ...c.access?.reads ?? []]
+  }, b = c.seedExisting ?? !0, y = new Array(r.length), g = (t) => {
+    for (let e = 0; e < r.length; e++) y[e] = t.getField(s, n, r[e]);
+    a.reconcile(y);
+  }, o = () => a.reconcile(h);
+  let i;
   return f(() => {
-    t = a.observe(n, {
+    i = l.observe(n, {
       granularity: "entity",
-      onSet: (c, e) => {
-        c === s && g(e);
+      onSet: (t, e) => {
+        t === s && g(e);
       },
-      onAdd: (c, e) => {
-        c === s && !e.isDisabled(s) && g(e);
+      onAdd: (t, e) => {
+        t === s && !e.isDisabled(s) && g(e);
       },
-      onRemove: (c) => {
-        c === s && i();
+      onRemove: (t) => {
+        t === s && o();
       },
-      onDisable: (c) => {
-        c === s && i();
+      onDisable: (t) => {
+        t === s && o();
       },
-      onEnable: (c, e) => {
-        c === s && g(e);
+      onEnable: (t, e) => {
+        t === s && g(e);
       },
-      access: d,
+      access: u,
       yieldExisting: b
     });
-  }), { array: l, dispose: () => t.dispose() };
+  }), { array: a, dispose: () => i.dispose() };
 }
-function k(a, n) {
-  f(() => a.update(n));
+function F(l, n) {
+  f(() => l.update(n));
 }
 export {
-  k as batchedUpdate,
-  w as shallow,
+  F as batchedUpdate,
+  E as shallow,
   A as syncComponentToMap,
-  j as syncFieldsToMap,
+  q as syncFieldsToMap,
   M as syncJoinToMap,
-  T as syncSingletonToArray,
-  O as syncSingletonToStruct
+  C as syncSingletonToArray,
+  T as syncSingletonToStruct
 };

package/dist/extensions/solid/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const u=require("solid-js"),c=require("../../interop-CT-REx0W.cjs");function l(e){const[t,o]=u.createSignal(e());return u.onCleanup(c.subscribe(e,s=>o(()=>s))),t}function f(e){return{keys:l(()=>e.keys()),cell:t=>l(()=>e.get(t))}}function i(e){const t={},o=Object.keys(e),s=new Set(o);for(const n of o)t[n]=l(()=>e[n]);return new Proxy({},{get:(n,r)=>s.has(r)?t[r]():Reflect.get(n,r),has:(n,r)=>s.has(r),ownKeys:()=>o,getOwnPropertyDescriptor:(n,r)=>s.has(r)?{get:()=>t[r](),enumerable:!0,configurable:!0}:void 0})}function a(e){return l(()=>e.snapshot())}exports.fromKernel=l;exports.fromKernelArray=a;exports.fromKernelMap=f;exports.fromKernelStruct=i;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const u=require("solid-js"),c=require("../../interop-CT-REx0W.cjs");function l(e){const[t,o]=u.createSignal(e());return u.onCleanup(c.subscribe(e,s=>o(()=>s))),t}function f(e){return{keys:l(()=>e.keys()),cell:t=>l(()=>e.get(t))}}function i(e){const t={},o=Object.keys(e),s=new Set(o);for(const n of o)t[n]=l(()=>e[n]);return new Proxy({},{get:(n,r)=>s.has(r)?t[r]():Reflect.get(n,r),has:(n,r)=>s.has(r),ownKeys:()=>o,getOwnPropertyDescriptor:(n,r)=>s.has(r)?{get:()=>t[r](),enumerable:!0,configurable:!0}:void 0,set:(n,r)=>!1})}function a(e){return l(()=>e.snapshot())}exports.fromKernel=l;exports.fromKernelArray=a;exports.fromKernelMap=f;exports.fromKernelStruct=i;

package/dist/extensions/solid/index.d.cts

@@ -0,0 +1,6 @@
+/**
+ * `@oasys/oecs/solid` — the SolidJS adapter plugin for oecs's reactive
+ * kernel (`@oasys/oecs/reactive` / `../../reactive`, #646 / ADR-0021).
+ */
+export { fromKernel, fromKernelMap, fromKernelStruct, fromKernelArray, type KernelMapView } from './kernel_solid.cjs';
+//# sourceMappingURL=index.d.ts.map

package/dist/extensions/solid/index.d.ts

@@ -1,6 +1,6 @@
 /**
  * `@oasys/oecs/solid` — the SolidJS adapter plugin for oecs's reactive
- * kernel (`@oasys/oecs/reactive` / `../../core/reactive`, #646 / ADR-0021).
+ * kernel (`@oasys/oecs/reactive` / `../../reactive`, #646 / ADR-0021).
  */
-export { fromKernel, fromKernelMap, fromKernelStruct, fromKernelArray, type KernelMapView } from './kernel_solid';
+export { fromKernel, fromKernelMap, fromKernelStruct, fromKernelArray, type KernelMapView } from './kernel_solid.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/extensions/solid/index.js

@@ -1,8 +1,8 @@
-import { createSignal as c, onCleanup as u } from "solid-js";
+import { createSignal as u, onCleanup as c } from "solid-js";
 import { s as a } from "../../interop-CcY6ASQc.js";
 function f(e) {
-  const [t, o] = c(e());
-  return u(a(e, (s) => o(() => s))), t;
+  const [t, o] = u(e());
+  return c(a(e, (s) => o(() => s))), t;
 }
 function g(e) {
   return {
@@ -18,7 +18,11 @@ function m(e) {
     get: (n, r) => s.has(r) ? t[r]() : Reflect.get(n, r),
     has: (n, r) => s.has(r),
     ownKeys: () => o,
-    getOwnPropertyDescriptor: (n, r) => s.has(r) ? { get: () => t[r](), enumerable: !0, configurable: !0 } : void 0
+    getOwnPropertyDescriptor: (n, r) => s.has(r) ? { get: () => t[r](), enumerable: !0, configurable: !0 } : void 0,
+    // Read surface only (`Readonly<T>`, POLISH_AUDIT #8) — mirrors the kernel
+    // struct proxy's trap so a JS-side assignment fails loudly instead of
+    // sticking a non-reactive value on the hidden target.
+    set: (n, r) => !1
   });
 }
 function y(e) {

package/dist/extensions/solid/kernel_solid.d.cts

@@ -0,0 +1,45 @@
+import { Accessor } from 'solid-js';
+import { ReactiveArray, ReactiveMap } from '../../reactive/index.cjs';
+/**
+ * Mirror a kernel accessor into a Solid accessor. The returned accessor tracks in
+ * Solid; it updates once per coalesced kernel change and never on an equal write.
+ */
+export declare function fromKernel<T>(accessor: () => T): Accessor<T>;
+/** A kernel `reactiveMap` projected for a keyed Solid `<For>`. */
+export interface KernelMapView<K, V> {
+    /** The live key set — pass to a keyed Solid `<For each>`. Keyed on the id. */
+    readonly keys: Accessor<readonly K[]>;
+    /** A bridged value accessor for one key — read inside the `<For>` row.
+     * Each call mints a FRESH bridge (subscription): call it once per row (bind
+     * the accessor in the row's scope), never inline it in a hot JSX expression
+     * that re-evaluates per render. */
+    cell(key: K): Accessor<V | undefined>;
+}
+/**
+ * Bridge a kernel `reactiveMap` for keyed Solid rendering. `keys` drives a `<For>`
+ * (one row per entity, keyed on the stable id); `cell(id)` is that row's bridged
+ * value. Changing one entity wakes only its row; spawn/despawn add/remove one row.
+ */
+export declare function fromKernelMap<K, V>(map: ReactiveMap<K, V>): KernelMapView<K, V>;
+/**
+ * Bridge a kernel `reactiveStruct` proxy into a Solid-reactive proxy: reading
+ * `view.field` in a Solid scope tracks that field alone (one `fromKernel` per
+ * field), so a change to one field re-renders only its readers. Completes the
+ * `fromKernel` / `fromKernelMap` / `fromKernelStruct` trio — the read side for the
+ * singleton/ephemeral UI state `syncSingletonToStruct` publishes (ADR-0024). The
+ * field set is read once from the (enumerable) struct proxy; call inside a component
+ * or `root` so each field's `onCleanup` has an owner. The kernel struct's per-field
+ * `eq` and batching carry through `fromKernel` unchanged.
+ */
+export declare function fromKernelStruct<T extends object>(struct: Readonly<T>): Readonly<T>;
+/**
+ * Bridge a kernel `reactiveArray` into a Solid accessor of its snapshot, for a
+ * positional Solid `<Index each={view()}>`. `<Index>` (NOT `<For>`) is the match for
+ * an ordered slot list: it keys by position and hands each slot an accessor, so
+ * duplicate primitive values (e.g. empty army slots) don't alias and a slot change
+ * updates only that row. The snapshot is the array's coarse read (any slot change
+ * wakes it), but `<Index>` then diffs by position and touches only the changed
+ * index's DOM. Use `fromKernelMap` instead for an *entity* collection (keyed, `<For>`).
+ */
+export declare function fromKernelArray<T>(arr: ReactiveArray<T>): Accessor<readonly T[]>;
+//# sourceMappingURL=kernel_solid.d.ts.map