@oasys/oecs 0.5.4 → 0.6.0

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

@@ -0,0 +1,8 @@
+/**
+ * `@oasys/oecs/solid`, the SolidJS plugin.
+ *
+ * `solid()` reads the store's change feed and writes Solid signals and stores
+ * directly. Nothing sits between the store and Solid.
+ */
+export { solid, type ECSSolid, type RowReader, type SolidPlugin, type SolidComponentView, type SolidGrain, type SolidSingletonView, type SolidViewOptions } from './solid.cjs';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1,8 @@
+/**
+ * `@oasys/oecs/solid`, the SolidJS plugin.
+ *
+ * `solid()` reads the store's change feed and writes Solid signals and stores
+ * directly. Nothing sits between the store and Solid.
+ */
+export { solid, type ECSSolid, type RowReader, type SolidPlugin, type SolidComponentView, type SolidGrain, type SolidSingletonView, type SolidViewOptions } from './solid.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/plugins/solid/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/solid/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EACN,KAAK,EACL,KAAK,QAAQ,EACb,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACvB,KAAK,UAAU,EACf,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,MAAM,SAAS,CAAC"}

package/dist/plugins/solid/solid.d.cts

@@ -0,0 +1,97 @@
+import { Accessor } from 'solid-js';
+import { Store } from 'solid-js/store';
+import { Plugin, ComponentDef, ComponentSchema, EntityID } from '../../core/ecs/index.cjs';
+/**
+ * A read cursor over one entity's single-component state, handed to a
+ * projection. `field` reads a column under the `"column"` grain, and it reads
+ * by id through a cursor under the `"entity"` grain.
+ *
+ * The cursor is a reused mutable singleton, valid only during the synchronous
+ * `project` call for the current row. Read what you need and return. A captured
+ * reader reads the next row, because the next row mutates it in place.
+ */
+export interface RowReader<S extends ComponentSchema> {
+    /** The entity of the row being projected. */
+    readonly eid: EntityID;
+    /** Read one field of the projected component, for the current row. */
+    field<K extends string & keyof S>(name: K): number;
+}
+/** Per-component grain of the set half of a view. */
+export type SolidGrain = "entity" | "column";
+/** The world surface this plugin adds. */
+export interface SolidPlugin {
+    readonly solid: ECSSolid;
+}
+/** One component projected into one Solid signal per entity. */
+export interface SolidComponentView<V> {
+    /** The row's live value, as one Solid signal. The first call for an id
+     * makes that signal, seeded with the value the view holds now, and every
+     * later call returns the same accessor. Bind it once for each row, in the
+     * row's own scope, and never inside a jsx expression that re-evaluates.
+     *
+     * `undefined` while the view does not hold the id. A cell outlives a
+     * delete, so the same accessor reports the row leaving and returning, and
+     * the view keeps every cell a caller ever asked for. */
+    cell(id: EntityID): Accessor<V | undefined>;
+    /** The live key set, for a keyed `<For each={view.keys()}>`. A new array
+     * only when membership changed. */
+    readonly keys: Accessor<readonly EntityID[]>;
+    dispose(): void;
+}
+export interface SolidViewOptions<V = unknown> {
+    /** `"entity"` publishes the rows the by-id write paths recorded. `"column"`
+     * republishes every enabled row of an archetype whose column changed, and
+     * costs the write path nothing. Default `"entity"`. */
+    grain?: SolidGrain;
+    /** Publish the current enabled members at creation. Default `true`. */
+    seedExisting?: boolean;
+    /** Value equality for each cell, handed to Solid as the signal's `equals`.
+     * An equal publish wakes nobody. Default is Solid's own `===`, so a
+     * projection that returns a fresh object every tick wakes its reader every
+     * tick unless it passes one. `fields` supplies its own. */
+    eq?: (a: V, b: V) => boolean;
+}
+/** One entity's fields, published into a Solid store with no key. */
+export interface SolidSingletonView<V extends object> {
+    readonly value: Store<V>;
+    dispose(): void;
+}
+/** The `ecs.solid` facade. Each entry point returns a view and its disposer. */
+export interface ECSSolid {
+    /** Project one component into one signal per entity. `project` runs once
+     * per published entity, and the reader it receives is a reused singleton:
+     * read what you need and return, never capture it. The projected value must
+     * not be a function, which a Solid setter reads as an updater. */
+    component<S extends ComponentSchema, V>(def: ComponentDef<S>, project: (row: RowReader<S>) => V, opts?: SolidViewOptions<V>): SolidComponentView<V>;
+    /** Sugar over {@link component}: publish a fixed field list as a
+     * `{ field: value }` record, with an `eq` that compares those fields. A
+     * fresh record per published entity, so prefer a scalar projection for a
+     * high-churn component. */
+    fields<S extends ComponentSchema, const F extends readonly (string & keyof S)[]>(def: ComponentDef<S>, fields: F, opts?: SolidViewOptions<{
+        [K in F[number]]: number;
+    }>): SolidComponentView<{
+        [K in F[number]]: number;
+    }>;
+    /** Publish one entity's fields into a keyless Solid store. A remove or a
+     * disable of that entity resets the fields to the values the store held at
+     * creation.
+     *
+     * A store, and not a signal per field: one entity carries a fixed key set,
+     * a publish writes only the fields that moved, and a reader tracks the
+     * field it reads. None of that sits on the per-entity path. */
+    singleton<S extends ComponentSchema, const F extends readonly (string & keyof S)[]>(def: ComponentDef<S>, eid: EntityID, fields: F, opts?: {
+        seedExisting?: boolean;
+    }): SolidSingletonView<{
+        [K in F[number]]: number;
+    }>;
+}
+/**
+ * The solid plugin, for `ECS.create({ plugins: [solid()] })`. It requires
+ * no other plugin, and observers are not involved.
+ *
+ * A world that installs it carries `ecs.solid`. A world that does not carries
+ * no member of that name, so `ecs.solid` is a compile error rather than a
+ * fault at run time. There is no reserved slot to name the missing import.
+ */
+export declare function solid(): Plugin<SolidPlugin>;
+//# sourceMappingURL=solid.d.ts.map

package/dist/plugins/solid/solid.d.ts

@@ -0,0 +1,97 @@
+import { Accessor } from 'solid-js';
+import { Store } from 'solid-js/store';
+import { Plugin, ComponentDef, ComponentSchema, EntityID } from '../../core/ecs/index.js';
+/**
+ * A read cursor over one entity's single-component state, handed to a
+ * projection. `field` reads a column under the `"column"` grain, and it reads
+ * by id through a cursor under the `"entity"` grain.
+ *
+ * The cursor is a reused mutable singleton, valid only during the synchronous
+ * `project` call for the current row. Read what you need and return. A captured
+ * reader reads the next row, because the next row mutates it in place.
+ */
+export interface RowReader<S extends ComponentSchema> {
+    /** The entity of the row being projected. */
+    readonly eid: EntityID;
+    /** Read one field of the projected component, for the current row. */
+    field<K extends string & keyof S>(name: K): number;
+}
+/** Per-component grain of the set half of a view. */
+export type SolidGrain = "entity" | "column";
+/** The world surface this plugin adds. */
+export interface SolidPlugin {
+    readonly solid: ECSSolid;
+}
+/** One component projected into one Solid signal per entity. */
+export interface SolidComponentView<V> {
+    /** The row's live value, as one Solid signal. The first call for an id
+     * makes that signal, seeded with the value the view holds now, and every
+     * later call returns the same accessor. Bind it once for each row, in the
+     * row's own scope, and never inside a jsx expression that re-evaluates.
+     *
+     * `undefined` while the view does not hold the id. A cell outlives a
+     * delete, so the same accessor reports the row leaving and returning, and
+     * the view keeps every cell a caller ever asked for. */
+    cell(id: EntityID): Accessor<V | undefined>;
+    /** The live key set, for a keyed `<For each={view.keys()}>`. A new array
+     * only when membership changed. */
+    readonly keys: Accessor<readonly EntityID[]>;
+    dispose(): void;
+}
+export interface SolidViewOptions<V = unknown> {
+    /** `"entity"` publishes the rows the by-id write paths recorded. `"column"`
+     * republishes every enabled row of an archetype whose column changed, and
+     * costs the write path nothing. Default `"entity"`. */
+    grain?: SolidGrain;
+    /** Publish the current enabled members at creation. Default `true`. */
+    seedExisting?: boolean;
+    /** Value equality for each cell, handed to Solid as the signal's `equals`.
+     * An equal publish wakes nobody. Default is Solid's own `===`, so a
+     * projection that returns a fresh object every tick wakes its reader every
+     * tick unless it passes one. `fields` supplies its own. */
+    eq?: (a: V, b: V) => boolean;
+}
+/** One entity's fields, published into a Solid store with no key. */
+export interface SolidSingletonView<V extends object> {
+    readonly value: Store<V>;
+    dispose(): void;
+}
+/** The `ecs.solid` facade. Each entry point returns a view and its disposer. */
+export interface ECSSolid {
+    /** Project one component into one signal per entity. `project` runs once
+     * per published entity, and the reader it receives is a reused singleton:
+     * read what you need and return, never capture it. The projected value must
+     * not be a function, which a Solid setter reads as an updater. */
+    component<S extends ComponentSchema, V>(def: ComponentDef<S>, project: (row: RowReader<S>) => V, opts?: SolidViewOptions<V>): SolidComponentView<V>;
+    /** Sugar over {@link component}: publish a fixed field list as a
+     * `{ field: value }` record, with an `eq` that compares those fields. A
+     * fresh record per published entity, so prefer a scalar projection for a
+     * high-churn component. */
+    fields<S extends ComponentSchema, const F extends readonly (string & keyof S)[]>(def: ComponentDef<S>, fields: F, opts?: SolidViewOptions<{
+        [K in F[number]]: number;
+    }>): SolidComponentView<{
+        [K in F[number]]: number;
+    }>;
+    /** Publish one entity's fields into a keyless Solid store. A remove or a
+     * disable of that entity resets the fields to the values the store held at
+     * creation.
+     *
+     * A store, and not a signal per field: one entity carries a fixed key set,
+     * a publish writes only the fields that moved, and a reader tracks the
+     * field it reads. None of that sits on the per-entity path. */
+    singleton<S extends ComponentSchema, const F extends readonly (string & keyof S)[]>(def: ComponentDef<S>, eid: EntityID, fields: F, opts?: {
+        seedExisting?: boolean;
+    }): SolidSingletonView<{
+        [K in F[number]]: number;
+    }>;
+}
+/**
+ * The solid plugin, for `ECS.create({ plugins: [solid()] })`. It requires
+ * no other plugin, and observers are not involved.
+ *
+ * A world that installs it carries `ecs.solid`. A world that does not carries
+ * no member of that name, so `ecs.solid` is a compile error rather than a
+ * fault at run time. There is no reserved slot to name the missing import.
+ */
+export declare function solid(): Plugin<SolidPlugin>;
+//# sourceMappingURL=solid.d.ts.map

package/dist/plugins/solid/solid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"solid.d.ts","sourceRoot":"","sources":["../../../src/plugins/solid/solid.ts"],"names":[],"mappings":"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"}

package/dist/plugins/solid.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const a=require("solid-js"),p=require("solid-js/store"),b="solid";class w{eid=0;_cols;constructor(e){this._cols=e}field(e){return this._cols[e]}}class y{eid=0;row=0;_cols=new Map;_arch;_def;constructor(e){this._def=e}bind(e){this._arch=e,this._cols.clear()}field(e){let s=this._cols.get(e);return s===void 0&&(s=this._arch.getColumnRead(this._def,e),this._cols.set(e,s)),s[this.row]}}function f(c,e){const s=c?.id;if(typeof s!="number")throw new TypeError(`${e}: the definition is not a dense component, got ${String(c)}. Pass a dense component definition`);return s}class g{keys;pending=new Set;cid;wantsSet;_owner;_changes;_def;_project;_cursor;_entityReader;_columnReader;_setKeys;_values=new Map;_cellGet=new Map;_cellSet=new Map;_equals;_keysDirty=!1;_baseline;_disposed=!1;constructor(e,s,t,i,n,h,o){this._owner=e,this._changes=s.changes,this.cid=t,this._def=i,this._project=n,this.wantsSet=h==="entity",this._cursor=s.world.cursorRead(i),this._entityReader=new w(this._cursor),this._columnReader=h==="column"?new y(i):null,this._equals=o===void 0?void 0:(r,l)=>r===l||r!==void 0&&l!==void 0&&o(r,l),this._baseline=s.store.changeTick;const[d,_]=a.createSignal([]);this.keys=d,this._setKeys=_}cell(e){let s=this._cellGet.get(e);if(s===void 0){const t=this._values.get(e),[i,n]=this._equals===void 0?a.createSignal(t):a.createSignal(t,{equals:this._equals});s=i,this._cellGet.set(e,i),this._cellSet.set(e,n)}return s}seed(){const e=this._changes.collectEnabledWith(this.cid);for(let s=0;s<e.length;s++)this._publishOne(e[s]);this._flushKeys()}publish(e){if(this._columnReader!==null)this._changes.forEachChangedArchetype(this.cid,this._baseline,this._onArchetype),this._baseline=e;else{const s=this._changes.drainSet(this.cid,e),t=s.scanned;for(let n=0;n<t.length;n++)this._publishOne(t[n]);const i=s.listed;for(let n=0;n<i.length;n++){const h=i[n];this._isPublishable(h)&&this._publishOne(h)}}this.pending.size!==0&&(this.pending.forEach(this._resolvePending),this.pending.clear()),this._flushKeys()}dispose(){this._disposed||(this._disposed=!0,this._owner._remove(this))}_onArchetype=e=>{const s=this._columnReader;s.bind(e);const t=e.entityIds,i=e.entityCount;for(let n=0;n<i;n++){s.row=n;const h=t[n];s.eid=h,this._writeRow(h,this._project(s))}};_resolvePending=e=>{this._isPublishable(e)?this._publishOne(e):this._deleteOne(e)};_isPublishable(e){const s=this._changes;return s.isAlive(e)&&s.hasComponent(e,this._def)&&!s.isDisabled(e)}_publishOne(e){this._cursor.at(e),this._entityReader.eid=e,this._writeRow(e,this._project(this._entityReader))}_writeRow(e,s){const t=this._values.size;this._values.set(e,s),this._values.size!==t&&(this._keysDirty=!0);const i=this._cellSet.get(e);i!==void 0&&i(s)}_deleteOne(e){if(!this._values.delete(e))return;this._keysDirty=!0;const s=this._cellSet.get(e);s!==void 0&&s(void 0)}_flushKeys(){this._keysDirty&&(this._keysDirty=!1,this._setKeys(Array.from(this._values.keys())))}}class S{value;pending=new Set;cid;wantsSet=!0;_owner;_changes;_def;_eid;_fields;_defaults;_cursor;_cols;_write;_disposed=!1;constructor(e,s,t,i,n,h){this._owner=e,this._changes=s.changes,this.cid=t,this._def=i,this._eid=n,this._fields=h,this._cursor=s.world.cursorRead(i),this._cols=this._cursor;const o={};for(let l=0;l<h.length;l++)o[h[l]]=0;const[d,_]=p.createStore(o);this.value=d,this._write=_;const r=[];for(let l=0;l<h.length;l++)r.push(o[h[l]]);this._defaults=r}seed(){this._isPublishable()&&this._publish()}publish(e){const s=this._changes.drainSet(this.cid,e),t=s.scanned;let i=!1;for(let n=0;n<t.length;n++)t[n]===this._eid&&(i=!0);if(!i){const n=s.listed;for(let h=0;h<n.length;h++)n[h]===this._eid&&this._isPublishable()&&(i=!0)}i&&this._publish(),this.pending.size!==0&&(this.pending.has(this._eid)&&(this._isPublishable()?this._publish():this._reset()),this.pending.clear())}dispose(){this._disposed||(this._disposed=!0,this._owner._remove(this))}_isPublishable(){const e=this._changes,s=this._eid;return e.isAlive(s)&&e.hasComponent(s,this._def)&&!e.isDisabled(s)}_publish(){this._cursor.at(this._eid);const e=this._fields;for(let s=0;s<e.length;s++)this._write(e[s],this._cols[e[s]])}_reset(){const e=this._fields;for(let s=0;s<e.length;s++)this._write(e[s],this._defaults[s])}}class m{_host;_views=[];_byCid=new Map;constructor(e){this._host=e,e.changes.addStructuralHook(this._onStructural),e.onSettle(this._onSettle)}component(e,s,t={}){const i=f(e,"solid.component"),n=new g(this,this._host,i,e,s,t.grain??"entity",t.eq);return this._add(n),(t.seedExisting??!0)&&a.batch(()=>n.seed()),n}fields(e,s,t={}){const i=d=>{const _={};for(let r=0;r<s.length;r++)_[s[r]]=d.field(s[r]);return _},n=t.eq??((d,_)=>{const r=d,l=_;for(let u=0;u<s.length;u++)if(r[s[u]]!==l[s[u]])return!1;return!0}),h=f(e,"solid.fields"),o=new g(this,this._host,h,e,i,t.grain??"entity",n);return this._add(o),(t.seedExisting??!0)&&a.batch(()=>o.seed()),o}singleton(e,s,t,i={}){const n=f(e,"solid.singleton"),h=new S(this,this._host,n,e,s,t);return this._add(h),(i.seedExisting??!0)&&a.batch(()=>h.seed()),h}_remove(e){const s=this._views.indexOf(e);s>=0&&this._views.splice(s,1);const t=this._byCid.get(e.cid);if(t!==void 0){const i=t.indexOf(e);i>=0&&t.splice(i,1),t.length===0&&this._byCid.delete(e.cid)}this._reconfigure(e.cid)}_add(e){this._views.push(e);let s=this._byCid.get(e.cid);s===void 0&&(s=[],this._byCid.set(e.cid,s)),s.push(e),this._reconfigure(e.cid)}_reconfigure(e){const s=this._byCid.get(e);let t=!1,i=!1;if(s!==void 0)for(let h=0;h<s.length;h++)t=!0,s[h].wantsSet&&(i=!0);const n={add:t,remove:t,disable:t,enable:t,set:i};this._host.changes.configureObservation(b,e,n)}_onStructural=e=>{this._views.length!==0&&(this._record(e.addComp,e.addEid,e.addLen),this._record(e.remComp,e.remEid,e.remLen),this._record(e.disComp,e.disEid,e.disLen),this._record(e.enaComp,e.enaEid,e.enaLen))};_record(e,s,t){for(let i=0;i<t;i++){const n=this._byCid.get(e[i]);if(n===void 0)continue;const h=s[i];for(let o=0;o<n.length;o++)n[o].pending.add(h)}}_run=0;_publishAll=()=>{const e=this._views,s=this._run;for(let t=0;t<e.length;t++)e[t].publish(s)};_onSettle=e=>{this._views.length!==0&&(this._run=e,a.batch(this._publishAll))}}function v(){return{name:"solid",requires:[],install(c){return{solid:new m(c)}}}}exports.solid=v;

package/dist/plugins/solid.d.cts

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

package/dist/plugins/solid.d.ts

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

package/dist/plugins/solid.development.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const a=require("solid-js"),p=require("solid-js/store"),b="solid";class w{eid=0;_cols;constructor(e){this._cols=e}field(e){return this._cols[e]}}class y{eid=0;row=0;_cols=new Map;_arch;_def;constructor(e){this._def=e}bind(e){this._arch=e,this._cols.clear()}field(e){let s=this._cols.get(e);return s===void 0&&(s=this._arch.getColumnRead(this._def,e),this._cols.set(e,s)),s[this.row]}}function f(c,e){const s=c?.id;if(typeof s!="number")throw new TypeError(`${e}: the definition is not a dense component, got ${String(c)}. Pass a dense component definition`);return s}class g{keys;pending=new Set;cid;wantsSet;_owner;_changes;_def;_project;_cursor;_entityReader;_columnReader;_setKeys;_values=new Map;_cellGet=new Map;_cellSet=new Map;_equals;_keysDirty=!1;_baseline;_disposed=!1;constructor(e,s,t,i,n,h,o){this._owner=e,this._changes=s.changes,this.cid=t,this._def=i,this._project=n,this.wantsSet=h==="entity",this._cursor=s.world.cursorRead(i),this._entityReader=new w(this._cursor),this._columnReader=h==="column"?new y(i):null,this._equals=o===void 0?void 0:(r,l)=>r===l||r!==void 0&&l!==void 0&&o(r,l),this._baseline=s.store.changeTick;const[d,_]=a.createSignal([]);this.keys=d,this._setKeys=_}cell(e){let s=this._cellGet.get(e);if(s===void 0){const t=this._values.get(e),[i,n]=this._equals===void 0?a.createSignal(t):a.createSignal(t,{equals:this._equals});s=i,this._cellGet.set(e,i),this._cellSet.set(e,n)}return s}seed(){const e=this._changes.collectEnabledWith(this.cid);for(let s=0;s<e.length;s++)this._publishOne(e[s]);this._flushKeys()}publish(e){if(this._columnReader!==null)this._changes.forEachChangedArchetype(this.cid,this._baseline,this._onArchetype),this._baseline=e;else{const s=this._changes.drainSet(this.cid,e),t=s.scanned;for(let n=0;n<t.length;n++)this._publishOne(t[n]);const i=s.listed;for(let n=0;n<i.length;n++){const h=i[n];this._isPublishable(h)&&this._publishOne(h)}}this.pending.size!==0&&(this.pending.forEach(this._resolvePending),this.pending.clear()),this._flushKeys()}dispose(){this._disposed||(this._disposed=!0,this._owner._remove(this))}_onArchetype=e=>{const s=this._columnReader;s.bind(e);const t=e.entityIds,i=e.entityCount;for(let n=0;n<i;n++){s.row=n;const h=t[n];s.eid=h,this._writeRow(h,this._project(s))}};_resolvePending=e=>{this._isPublishable(e)?this._publishOne(e):this._deleteOne(e)};_isPublishable(e){const s=this._changes;return s.isAlive(e)&&s.hasComponent(e,this._def)&&!s.isDisabled(e)}_publishOne(e){this._cursor.at(e),this._entityReader.eid=e,this._writeRow(e,this._project(this._entityReader))}_writeRow(e,s){const t=this._values.size;this._values.set(e,s),this._values.size!==t&&(this._keysDirty=!0);const i=this._cellSet.get(e);i!==void 0&&i(s)}_deleteOne(e){if(!this._values.delete(e))return;this._keysDirty=!0;const s=this._cellSet.get(e);s!==void 0&&s(void 0)}_flushKeys(){this._keysDirty&&(this._keysDirty=!1,this._setKeys(Array.from(this._values.keys())))}}class S{value;pending=new Set;cid;wantsSet=!0;_owner;_changes;_def;_eid;_fields;_defaults;_cursor;_cols;_write;_disposed=!1;constructor(e,s,t,i,n,h){this._owner=e,this._changes=s.changes,this.cid=t,this._def=i,this._eid=n,this._fields=h,this._cursor=s.world.cursorRead(i),this._cols=this._cursor;const o={};for(let l=0;l<h.length;l++)o[h[l]]=0;const[d,_]=p.createStore(o);this.value=d,this._write=_;const r=[];for(let l=0;l<h.length;l++)r.push(o[h[l]]);this._defaults=r}seed(){this._isPublishable()&&this._publish()}publish(e){const s=this._changes.drainSet(this.cid,e),t=s.scanned;let i=!1;for(let n=0;n<t.length;n++)t[n]===this._eid&&(i=!0);if(!i){const n=s.listed;for(let h=0;h<n.length;h++)n[h]===this._eid&&this._isPublishable()&&(i=!0)}i&&this._publish(),this.pending.size!==0&&(this.pending.has(this._eid)&&(this._isPublishable()?this._publish():this._reset()),this.pending.clear())}dispose(){this._disposed||(this._disposed=!0,this._owner._remove(this))}_isPublishable(){const e=this._changes,s=this._eid;return e.isAlive(s)&&e.hasComponent(s,this._def)&&!e.isDisabled(s)}_publish(){this._cursor.at(this._eid);const e=this._fields;for(let s=0;s<e.length;s++)this._write(e[s],this._cols[e[s]])}_reset(){const e=this._fields;for(let s=0;s<e.length;s++)this._write(e[s],this._defaults[s])}}class m{_host;_views=[];_byCid=new Map;constructor(e){this._host=e,e.changes.addStructuralHook(this._onStructural),e.onSettle(this._onSettle)}component(e,s,t={}){const i=f(e,"solid.component"),n=new g(this,this._host,i,e,s,t.grain??"entity",t.eq);return this._add(n),(t.seedExisting??!0)&&a.batch(()=>n.seed()),n}fields(e,s,t={}){const i=d=>{const _={};for(let r=0;r<s.length;r++)_[s[r]]=d.field(s[r]);return _},n=t.eq??((d,_)=>{const r=d,l=_;for(let u=0;u<s.length;u++)if(r[s[u]]!==l[s[u]])return!1;return!0}),h=f(e,"solid.fields"),o=new g(this,this._host,h,e,i,t.grain??"entity",n);return this._add(o),(t.seedExisting??!0)&&a.batch(()=>o.seed()),o}singleton(e,s,t,i={}){const n=f(e,"solid.singleton"),h=new S(this,this._host,n,e,s,t);return this._add(h),(i.seedExisting??!0)&&a.batch(()=>h.seed()),h}_remove(e){const s=this._views.indexOf(e);s>=0&&this._views.splice(s,1);const t=this._byCid.get(e.cid);if(t!==void 0){const i=t.indexOf(e);i>=0&&t.splice(i,1),t.length===0&&this._byCid.delete(e.cid)}this._reconfigure(e.cid)}_add(e){this._views.push(e);let s=this._byCid.get(e.cid);s===void 0&&(s=[],this._byCid.set(e.cid,s)),s.push(e),this._reconfigure(e.cid)}_reconfigure(e){const s=this._byCid.get(e);let t=!1,i=!1;if(s!==void 0)for(let h=0;h<s.length;h++)t=!0,s[h].wantsSet&&(i=!0);const n={add:t,remove:t,disable:t,enable:t,set:i};this._host.changes.configureObservation(b,e,n)}_onStructural=e=>{this._views.length!==0&&(this._record(e.addComp,e.addEid,e.addLen),this._record(e.remComp,e.remEid,e.remLen),this._record(e.disComp,e.disEid,e.disLen),this._record(e.enaComp,e.enaEid,e.enaLen))};_record(e,s,t){for(let i=0;i<t;i++){const n=this._byCid.get(e[i]);if(n===void 0)continue;const h=s[i];for(let o=0;o<n.length;o++)n[o].pending.add(h)}}_run=0;_publishAll=()=>{const e=this._views,s=this._run;for(let t=0;t<e.length;t++)e[t].publish(s)};_onSettle=e=>{this._views.length!==0&&(this._run=e,a.batch(this._publishAll))}}function v(){return{name:"solid",requires:[],install(c){return{solid:new m(c)}}}}exports.solid=v;

package/dist/plugins/solid.development.js

@@ -0,0 +1,319 @@
+import { batch as u, createSignal as f } from "solid-js";
+import { createStore as b } from "solid-js/store";
+const w = "solid";
+class y {
+  eid = 0;
+  _cols;
+  constructor(e) {
+    this._cols = e;
+  }
+  field(e) {
+    return this._cols[e];
+  }
+}
+class m {
+  eid = 0;
+  row = 0;
+  _cols = /* @__PURE__ */ new Map();
+  _arch;
+  _def;
+  constructor(e) {
+    this._def = e;
+  }
+  bind(e) {
+    this._arch = e, this._cols.clear();
+  }
+  field(e) {
+    let s = this._cols.get(e);
+    return s === void 0 && (s = this._arch.getColumnRead(this._def, e), this._cols.set(e, s)), s[this.row];
+  }
+}
+function g(_, e) {
+  const s = _?.id;
+  if (typeof s != "number")
+    throw new TypeError(
+      `${e}: the definition is not a dense component, got ${String(_)}. Pass a dense component definition`
+    );
+  return s;
+}
+class p {
+  keys;
+  pending = /* @__PURE__ */ new Set();
+  cid;
+  wantsSet;
+  _owner;
+  _changes;
+  _def;
+  _project;
+  _cursor;
+  _entityReader;
+  _columnReader;
+  _setKeys;
+  /** What the view holds now, and the seed of a cell made later. The key set
+   * is derived from it, so a publish or a delete that changes its size marks
+   * the key signal dirty. */
+  _values = /* @__PURE__ */ new Map();
+  /** The cells a caller asked for. Two maps rather than one of pairs, so the
+   * publish takes one lookup and the accessor lookup stays off that path. */
+  _cellGet = /* @__PURE__ */ new Map();
+  _cellSet = /* @__PURE__ */ new Map();
+  _equals;
+  _keysDirty = !1;
+  _baseline;
+  _disposed = !1;
+  constructor(e, s, t, i, n, h, o) {
+    this._owner = e, this._changes = s.changes, this.cid = t, this._def = i, this._project = n, this.wantsSet = h === "entity", this._cursor = s.world.cursorRead(i), this._entityReader = new y(this._cursor), this._columnReader = h === "column" ? new m(i) : null, this._equals = o === void 0 ? void 0 : (r, l) => r === l || r !== void 0 && l !== void 0 && o(r, l), this._baseline = s.store.changeTick;
+    const [d, c] = f([]);
+    this.keys = d, this._setKeys = c;
+  }
+  cell(e) {
+    let s = this._cellGet.get(e);
+    if (s === void 0) {
+      const t = this._values.get(e), [i, n] = this._equals === void 0 ? f(t) : f(t, { equals: this._equals });
+      s = i, this._cellGet.set(e, i), this._cellSet.set(e, n);
+    }
+    return s;
+  }
+  /** Publish every current enabled member. Cold path, and the caller wraps it
+   * in a `batch`. */
+  seed() {
+    const e = this._changes.collectEnabledWith(this.cid);
+    for (let s = 0; s < e.length; s++) this._publishOne(e[s]);
+    this._flushKeys();
+  }
+  publish(e) {
+    if (this._columnReader !== null)
+      this._changes.forEachChangedArchetype(this.cid, this._baseline, this._onArchetype), this._baseline = e;
+    else {
+      const s = this._changes.drainSet(this.cid, e), t = s.scanned;
+      for (let n = 0; n < t.length; n++) this._publishOne(t[n]);
+      const i = s.listed;
+      for (let n = 0; n < i.length; n++) {
+        const h = i[n];
+        this._isPublishable(h) && this._publishOne(h);
+      }
+    }
+    this.pending.size !== 0 && (this.pending.forEach(this._resolvePending), this.pending.clear()), this._flushKeys();
+  }
+  dispose() {
+    this._disposed || (this._disposed = !0, this._owner._remove(this));
+  }
+  /** One archetype of the column grain. Bound once, so the sweep allocates no
+   * closure per tick. */
+  _onArchetype = (e) => {
+    const s = this._columnReader;
+    s.bind(e);
+    const t = e.entityIds, i = e.entityCount;
+    for (let n = 0; n < i; n++) {
+      s.row = n;
+      const h = t[n];
+      s.eid = h, this._writeRow(h, this._project(s));
+    }
+  };
+  /** One entity the structural hook recorded. Bound once, for the same
+   * reason as `_onArchetype`. */
+  _resolvePending = (e) => {
+    this._isPublishable(e) ? this._publishOne(e) : this._deleteOne(e);
+  };
+  _isPublishable(e) {
+    const s = this._changes;
+    return s.isAlive(e) && s.hasComponent(e, this._def) && !s.isDisabled(e);
+  }
+  _publishOne(e) {
+    this._cursor.at(e), this._entityReader.eid = e, this._writeRow(e, this._project(this._entityReader));
+  }
+  _writeRow(e, s) {
+    const t = this._values.size;
+    this._values.set(e, s), this._values.size !== t && (this._keysDirty = !0);
+    const i = this._cellSet.get(e);
+    i !== void 0 && i(s);
+  }
+  /** Drop the row. A row the view never held writes nothing, so a spawn and a
+   * despawn inside one tick leave Solid untouched. */
+  _deleteOne(e) {
+    if (!this._values.delete(e)) return;
+    this._keysDirty = !0;
+    const s = this._cellSet.get(e);
+    s !== void 0 && s(void 0);
+  }
+  _flushKeys() {
+    this._keysDirty && (this._keysDirty = !1, this._setKeys(Array.from(this._values.keys())));
+  }
+}
+class v {
+  value;
+  pending = /* @__PURE__ */ new Set();
+  cid;
+  wantsSet = !0;
+  _owner;
+  _changes;
+  _def;
+  _eid;
+  _fields;
+  /** The values the store held at creation, the reset target of a remove and
+   * of a disable. A Solid store has no row to delete here, so the channel
+   * states its empty value instead of a blind zero. */
+  _defaults;
+  _cursor;
+  _cols;
+  _write;
+  _disposed = !1;
+  constructor(e, s, t, i, n, h) {
+    this._owner = e, this._changes = s.changes, this.cid = t, this._def = i, this._eid = n, this._fields = h, this._cursor = s.world.cursorRead(i), this._cols = this._cursor;
+    const o = {};
+    for (let l = 0; l < h.length; l++) o[h[l]] = 0;
+    const [d, c] = b(o);
+    this.value = d, this._write = c;
+    const r = [];
+    for (let l = 0; l < h.length; l++) r.push(o[h[l]]);
+    this._defaults = r;
+  }
+  /** Publish the target's current fields, when it is there to read. Cold
+   * path, and the caller wraps it in a `batch`. */
+  seed() {
+    this._isPublishable() && this._publish();
+  }
+  publish(e) {
+    const s = this._changes.drainSet(this.cid, e), t = s.scanned;
+    let i = !1;
+    for (let n = 0; n < t.length; n++) t[n] === this._eid && (i = !0);
+    if (!i) {
+      const n = s.listed;
+      for (let h = 0; h < n.length; h++)
+        n[h] === this._eid && this._isPublishable() && (i = !0);
+    }
+    i && this._publish(), this.pending.size !== 0 && (this.pending.has(this._eid) && (this._isPublishable() ? this._publish() : this._reset()), this.pending.clear());
+  }
+  dispose() {
+    this._disposed || (this._disposed = !0, this._owner._remove(this));
+  }
+  _isPublishable() {
+    const e = this._changes, s = this._eid;
+    return e.isAlive(s) && e.hasComponent(s, this._def) && !e.isDisabled(s);
+  }
+  _publish() {
+    this._cursor.at(this._eid);
+    const e = this._fields;
+    for (let s = 0; s < e.length; s++) this._write(e[s], this._cols[e[s]]);
+  }
+  _reset() {
+    const e = this._fields;
+    for (let s = 0; s < e.length; s++) this._write(e[s], this._defaults[s]);
+  }
+}
+class S {
+  _host;
+  _views = [];
+  _byCid = /* @__PURE__ */ new Map();
+  constructor(e) {
+    this._host = e, e.changes.addStructuralHook(this._onStructural), e.onSettle(this._onSettle);
+  }
+  component(e, s, t = {}) {
+    const i = g(e, "solid.component"), n = new p(
+      this,
+      this._host,
+      i,
+      e,
+      s,
+      t.grain ?? "entity",
+      t.eq
+    );
+    return this._add(n), (t.seedExisting ?? !0) && u(() => n.seed()), n;
+  }
+  fields(e, s, t = {}) {
+    const i = (d) => {
+      const c = {};
+      for (let r = 0; r < s.length; r++) c[s[r]] = d.field(s[r]);
+      return c;
+    }, n = t.eq ?? ((d, c) => {
+      const r = d, l = c;
+      for (let a = 0; a < s.length; a++) if (r[s[a]] !== l[s[a]]) return !1;
+      return !0;
+    }), h = g(e, "solid.fields"), o = new p(
+      this,
+      this._host,
+      h,
+      e,
+      i,
+      t.grain ?? "entity",
+      n
+    );
+    return this._add(o), (t.seedExisting ?? !0) && u(() => o.seed()), o;
+  }
+  singleton(e, s, t, i = {}) {
+    const n = g(e, "solid.singleton"), h = new v(this, this._host, n, e, s, t);
+    return this._add(h), (i.seedExisting ?? !0) && u(() => h.seed()), h;
+  }
+  /** Drop a view and recompute its component's ask. Idempotent through the
+   * view's own disposed flag. */
+  _remove(e) {
+    const s = this._views.indexOf(e);
+    s >= 0 && this._views.splice(s, 1);
+    const t = this._byCid.get(e.cid);
+    if (t !== void 0) {
+      const i = t.indexOf(e);
+      i >= 0 && t.splice(i, 1), t.length === 0 && this._byCid.delete(e.cid);
+    }
+    this._reconfigure(e.cid);
+  }
+  _add(e) {
+    this._views.push(e);
+    let s = this._byCid.get(e.cid);
+    s === void 0 && (s = [], this._byCid.set(e.cid, s)), s.push(e), this._reconfigure(e.cid);
+  }
+  /** The OR of every live view's ask for `cid`. All-false on the last
+   * dispose, which is the same as never asking. Cold path. */
+  _reconfigure(e) {
+    const s = this._byCid.get(e);
+    let t = !1, i = !1;
+    if (s !== void 0)
+      for (let h = 0; h < s.length; h++)
+        t = !0, s[h].wantsSet && (i = !0);
+    const n = {
+      add: t,
+      remove: t,
+      disable: t,
+      enable: t,
+      set: i
+    };
+    this._host.changes.configureObservation(w, e, n);
+  }
+  /** Record the round's structural events, and write nothing. A view resolves
+   * them at settle, so an entity that arrives and leaves inside one tick
+   * never reaches Solid. */
+  _onStructural = (e) => {
+    this._views.length !== 0 && (this._record(e.addComp, e.addEid, e.addLen), this._record(e.remComp, e.remEid, e.remLen), this._record(e.disComp, e.disEid, e.disLen), this._record(e.enaComp, e.enaEid, e.enaLen));
+  };
+  _record(e, s, t) {
+    for (let i = 0; i < t; i++) {
+      const n = this._byCid.get(e[i]);
+      if (n === void 0) continue;
+      const h = s[i];
+      for (let o = 0; o < n.length; o++) n[o].pending.add(h);
+    }
+  }
+  /** The run tick of the settle in progress. It reaches `_publishAll` through
+   * a field so the batched body can be bound once. */
+  _run = 0;
+  _publishAll = () => {
+    const e = this._views, s = this._run;
+    for (let t = 0; t < e.length; t++) e[t].publish(s);
+  };
+  /** One Solid flush for the whole plugin, whatever the number of views.
+   * A world with no view calls `batch` never. */
+  _onSettle = (e) => {
+    this._views.length !== 0 && (this._run = e, u(this._publishAll));
+  };
+}
+function k() {
+  return {
+    name: "solid",
+    requires: [],
+    install(_) {
+      return { solid: new S(_) };
+    }
+  };
+}
+export {
+  k as solid
+};