@oasys/oecs 0.5.0 → 0.5.1

package/dist/extensions/editor/editor.d.ts

@@ -5,7 +5,7 @@ import { ComponentDef, ComponentHandle, ComponentSchema, EntityID, CompleteField
  * to the reactive read channel (e.g. a `reactiveMap`/`reactiveStruct` projection)
  * or to `ecs.getField`; `undefined` for an unknown slot falls back to `0`.
  */
-export type FieldReader = (eid: EntityID, def: ComponentDef, field: string) => number | undefined;
+export type FieldReader = (entityId: EntityID, def: ComponentDef, field: string) => number | undefined;
 /**
  * A reified, undoable unit of editor work: the `forward` commands and their
  * `inverse`, both plain `HostCommand` data on the one bus. The arrays are mutable
@@ -42,33 +42,35 @@ export declare class TransactionBuilder {
      * also forwards the new id to the caller. The finalizer re-fires on redo, so the
      * inverse tracks the current id.
      */
-    spawn<Defs extends readonly ComponentDef[]>(components: SpawnEntries<Defs>, onSpawned?: (eid: EntityID) => void): this;
+    spawn<Defs extends readonly ComponentDef[]>(components: SpawnEntries<Defs>, onSpawned?: (entityId: EntityID) => void): this;
     /**
-     * Despawn `eid`. Inverse: respawn from `restore` (the components+values to
+     * Despawn `entityId`. Inverse: respawn from `restore` (the components+values to
      * recreate — read them from the channel before despawning). Undo respawns the
      * DATA, not the identity: the new entity gets a fresh id, and the respawn's
      * `onSpawned` rewrites this despawn's target so redo removes the respawned
      * entity rather than the dead original.
      */
-    despawn<Defs extends readonly ComponentDef[]>(eid: EntityID, restore: SpawnEntries<Defs>): this;
+    despawn<Defs extends readonly ComponentDef[]>(entityId: EntityID, restore: SpawnEntries<Defs>): this;
     /**
-     * Set `field` of `def` on `eid` to `value`. Inverse: set it back to the value
+     * Set `field` of `def` on `entityId` to `value`. Inverse: set it back to the value
      * this edit replaced — read from the staged overlay / shadow (so stacked edits,
      * within one build or before a commit, invert correctly) or, failing that, the
      * read channel (`0` if unknown).
      */
-    setField<S extends ComponentSchema>(eid: EntityID, def: ComponentDef<S>, field: string & keyof S, value: number): this;
-    /** Add `def` (with complete `values`) to `eid`. Inverse: remove it. */
-    addComponent<S extends ComponentSchema>(eid: EntityID, def: ComponentDef<S>, values: CompleteFieldValues<S>): this;
+    setField<S extends ComponentSchema>(entityId: EntityID, def: ComponentDef<S>, field: string & keyof S, value: number): this;
+    /** Attach `def` (with complete `values`) to `entityId`. Inverse: remove it.
+     * Bare `add` — the namespaced-handle grammar (matches `ctx.commands.add` and
+     * the queue's `add`), not `addComponent`. */
+    add<S extends ComponentSchema>(entityId: EntityID, def: ComponentDef<S>, values: CompleteFieldValues<S>): this;
     /**
-     * Remove `def` from `eid`. Inverse: re-add it from `restore` (the field values
-     * to recreate — read them from the channel before removing).
+     * Detach `def` from `entityId`. Inverse: re-add it from `restore` (the field values
+     * to recreate — read them from the channel before removing). Bare `remove` — see `add`.
      */
-    removeComponent<S extends ComponentSchema>(eid: EntityID, def: ComponentDef<S>, restore: CompleteFieldValues<S>): this;
-    /** Disable `eid`. Inverse: enable it. */
-    disable(eid: EntityID): this;
-    /** Enable `eid`. Inverse: disable it. */
-    enable(eid: EntityID): this;
+    remove<S extends ComponentSchema>(entityId: EntityID, def: ComponentDef<S>, restore: CompleteFieldValues<S>): this;
+    /** Disable `entityId`. Inverse: enable it. */
+    disable(entityId: EntityID): this;
+    /** Enable `entityId`. Inverse: disable it. */
+    enable(entityId: EntityID): this;
 }
 /**
  * The editor's undo/redo manager over a {@link HostCommandQueue}. Each action is a
@@ -97,19 +99,19 @@ export declare class Editor {
      */
     transaction(build: (tx: TransactionBuilder) => void): EditorTransaction;
     /** Spawn `components` as its own undo entry. `onSpawned` reports the new id. */
-    spawn<Defs extends readonly ComponentDef[]>(components: SpawnEntries<Defs>, onSpawned?: (eid: EntityID) => void): EditorTransaction;
-    /** Despawn `eid` as its own undo entry; `restore` recreates it on undo. */
-    despawn<Defs extends readonly ComponentDef[]>(eid: EntityID, restore: SpawnEntries<Defs>): EditorTransaction;
+    spawn<Defs extends readonly ComponentDef[]>(components: SpawnEntries<Defs>, onSpawned?: (entityId: EntityID) => void): EditorTransaction;
+    /** Despawn `entityId` as its own undo entry; `restore` recreates it on undo. */
+    despawn<Defs extends readonly ComponentDef[]>(entityId: EntityID, restore: SpawnEntries<Defs>): EditorTransaction;
     /** Set one field as its own undo entry. */
-    setField<S extends ComponentSchema>(eid: EntityID, def: ComponentDef<S>, field: string & keyof S, value: number): EditorTransaction;
-    /** Add a component as its own undo entry. */
-    addComponent<S extends ComponentSchema>(eid: EntityID, def: ComponentDef<S>, values: CompleteFieldValues<S>): EditorTransaction;
-    /** Remove a component as its own undo entry; `restore` re-adds it on undo. */
-    removeComponent<S extends ComponentSchema>(eid: EntityID, def: ComponentDef<S>, restore: CompleteFieldValues<S>): EditorTransaction;
-    /** Disable `eid` as its own undo entry. */
-    disable(eid: EntityID): EditorTransaction;
-    /** Enable `eid` as its own undo entry. */
-    enable(eid: EntityID): EditorTransaction;
+    setField<S extends ComponentSchema>(entityId: EntityID, def: ComponentDef<S>, field: string & keyof S, value: number): EditorTransaction;
+    /** Attach a component as its own undo entry. Bare `add` (see `TransactionBuilder.add`). */
+    add<S extends ComponentSchema>(entityId: EntityID, def: ComponentDef<S>, values: CompleteFieldValues<S>): EditorTransaction;
+    /** Detach a component as its own undo entry; `restore` re-adds it on undo. Bare `remove`. */
+    remove<S extends ComponentSchema>(entityId: EntityID, def: ComponentDef<S>, restore: CompleteFieldValues<S>): EditorTransaction;
+    /** Disable `entityId` as its own undo entry. */
+    disable(entityId: EntityID): EditorTransaction;
+    /** Enable `entityId` as its own undo entry. */
+    enable(entityId: EntityID): EditorTransaction;
     /**
      * Undo the most recent transaction: enqueue its inverse commands (in reverse
      * order — a group unwinds last-action-first) on the bus and move it to the redo
@@ -145,7 +147,7 @@ export declare class Editor {
     /** Read one committed `(entity, component, field)` slot through the reader
      * this editor was constructed with — the default read for `fieldHandle`
      * when no channel thunk is supplied (M11). */
-    committedField(eid: EntityID, def: ComponentDef, field: string): number | undefined;
+    committedField(entityId: EntityID, def: ComponentDef, field: string): number | undefined;
     /**
      * The pending value the editor believes for a field that the committed read
      * channel has NOT caught up to yet (the shadow), or `undefined` if none. Lets an
@@ -161,7 +163,7 @@ export declare class Editor {
      * the next edit to the slot. `value` (the read channel) is always the source of
      * truth; `pending` is only the optimistic bridge.
      */
-    pendingField(eid: EntityID, def: ComponentHandle, field: string): number | undefined;
+    pendingField(entityId: EntityID, def: ComponentHandle, field: string): number | undefined;
     /** Enqueue forward commands, record the transaction, clear redo, sync shadow. */
     private commit;
     /** Keep the setField shadow in step with the commands just enqueued. */

package/dist/extensions/editor/editor.d.ts.map

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

package/dist/extensions/editor/field_handle.d.cts

@@ -26,9 +26,9 @@ export interface FieldHandle {
     readonly pending: number | undefined;
 }
 /**
- * Build a {@link FieldHandle} for one `(eid, def, field)` slot. `read` is the
+ * Build a {@link FieldHandle} for one `(entityId, def, field)` slot. `read` is the
  * tracked read of the reactive channel for this field (e.g.
- * `() => sync.map.get(eid)?.x`); `set` routes through `editor.setField`, so the
+ * `() => sync.map.get(entityId)?.x`); `set` routes through `editor.setField`, so the
  * edit is queued, batched, and undoable.
  *
  * `read` is optional (M11): omitted, the handle reads through the editor's own
@@ -36,5 +36,5 @@ export interface FieldHandle {
  * but NOT reactive — supply the channel thunk when the handle's `value` must
  * subscribe inside a tracking scope.
  */
-export declare function fieldHandle<S extends ComponentSchema>(editor: Editor, eid: EntityID, def: ComponentDef<S>, field: string & keyof S, read?: () => number | undefined): FieldHandle;
+export declare function fieldHandle<S extends ComponentSchema>(editor: Editor, entityId: EntityID, def: ComponentDef<S>, field: string & keyof S, read?: () => number | undefined): FieldHandle;
 //# sourceMappingURL=field_handle.d.ts.map

package/dist/extensions/editor/field_handle.d.ts

@@ -26,9 +26,9 @@ export interface FieldHandle {
     readonly pending: number | undefined;
 }
 /**
- * Build a {@link FieldHandle} for one `(eid, def, field)` slot. `read` is the
+ * Build a {@link FieldHandle} for one `(entityId, def, field)` slot. `read` is the
  * tracked read of the reactive channel for this field (e.g.
- * `() => sync.map.get(eid)?.x`); `set` routes through `editor.setField`, so the
+ * `() => sync.map.get(entityId)?.x`); `set` routes through `editor.setField`, so the
  * edit is queued, batched, and undoable.
  *
  * `read` is optional (M11): omitted, the handle reads through the editor's own
@@ -36,5 +36,5 @@ export interface FieldHandle {
  * but NOT reactive — supply the channel thunk when the handle's `value` must
  * subscribe inside a tracking scope.
  */
-export declare function fieldHandle<S extends ComponentSchema>(editor: Editor, eid: EntityID, def: ComponentDef<S>, field: string & keyof S, read?: () => number | undefined): FieldHandle;
+export declare function fieldHandle<S extends ComponentSchema>(editor: Editor, entityId: EntityID, def: ComponentDef<S>, field: string & keyof S, read?: () => number | undefined): FieldHandle;
 //# sourceMappingURL=field_handle.d.ts.map

package/dist/extensions/editor/field_handle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"field_handle.d.ts","sourceRoot":"","sources":["../../../src/extensions/editor/field_handle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC9E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAEvC;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC3B;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,8EAA8E;IAC9E,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB;;;;;;;OAOG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;CACrC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,eAAe,EACpD,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,QAAQ,EACb,GAAG,EAAE,YAAY,CAAC,CAAC,CAAC,EACpB,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,EACvB,IAAI,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,GAC7B,WAAW,CAYb"}
+{"version":3,"file":"field_handle.d.ts","sourceRoot":"","sources":["../../../src/extensions/editor/field_handle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC9E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAEvC;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC3B;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,8EAA8E;IAC9E,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB;;;;;;;OAOG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;CACrC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,eAAe,EACpD,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,QAAQ,EAClB,GAAG,EAAE,YAAY,CAAC,CAAC,CAAC,EACpB,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,EACvB,IAAI,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,GAC7B,WAAW,CAYb"}

package/dist/extensions/editor/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function d(r,t,e){return`${r}:${t.id}:${e}`}const a=new WeakMap;class h{constructor(t,e){this.readField=t,this.shadow=e,a.set(this,{forward:[],inverse:[]})}staged=new Map;get _txn(){return a.get(this)}spawn(t,e){const n={kind:"despawn",eid:0};return this._txn.inverse.push(n),this._txn.forward.push({kind:"spawn",components:t,onSpawned:s=>{n.eid=s,e?.(s)}}),this}despawn(t,e){const n={kind:"despawn",eid:t};return this._txn.forward.push(n),this._txn.inverse.push({kind:"spawn",components:e,onSpawned:s=>{n.eid=s}}),this}setField(t,e,n,s){const i=d(t,e,n),o=this.staged.get(i)??this.shadow.get(i)??this.readField(t,e,n)??0;return this.staged.set(i,s),this._txn.forward.push({kind:"set_field",eid:t,def:e,field:n,value:s}),this._txn.inverse.push({kind:"set_field",eid:t,def:e,field:n,value:o}),this}addComponent(t,e,n){return this._txn.forward.push({kind:"add_component",eid:t,def:e,values:n}),this._txn.inverse.push({kind:"remove_component",eid:t,def:e}),this}removeComponent(t,e,n){return this._txn.forward.push({kind:"remove_component",eid:t,def:e}),this._txn.inverse.push({kind:"add_component",eid:t,def:e,values:n}),this}disable(t){return this._txn.forward.push({kind:"disable",eid:t}),this._txn.inverse.push({kind:"enable",eid:t}),this}enable(t){return this._txn.forward.push({kind:"enable",eid:t}),this._txn.inverse.push({kind:"disable",eid:t}),this}}class u{constructor(t,e){this.queue=t,this.readField=e}undoStack=[];redoStack=[];listeners=[];shadow=new Map;transaction(t){const e=new h(this.readField,this.shadow);return t(e),this.commit(a.get(e))}spawn(t,e){return this.transaction(n=>n.spawn(t,e))}despawn(t,e){return this.transaction(n=>n.despawn(t,e))}setField(t,e,n,s){return this.transaction(i=>i.setField(t,e,n,s))}addComponent(t,e,n){return this.transaction(s=>s.addComponent(t,e,n))}removeComponent(t,e,n){return this.transaction(s=>s.removeComponent(t,e,n))}disable(t){return this.transaction(e=>e.disable(t))}enable(t){return this.transaction(e=>e.enable(t))}undo(){const t=this.undoStack.pop();if(t===void 0)return!1;const e=t.inverse.slice().reverse();for(const n of e)this.queue.push(n);return this.applyShadow(e),this.redoStack.push(t),this.notify(),!0}redo(){const t=this.redoStack.pop();if(t===void 0)return!1;for(const e of t.forward)this.queue.push(e);return this.applyShadow(t.forward),this.undoStack.push(t),this.notify(),!0}clear(){this.undoStack.length=0,this.redoStack.length=0,this.shadow.clear(),this.notify()}depths(){return{undo:this.undoStack.length,redo:this.redoStack.length}}get canUndo(){return this.undoStack.length>0}get canRedo(){return this.redoStack.length>0}onChange(t){return this.listeners.push(t),()=>{const e=this.listeners.indexOf(t);e!==-1&&this.listeners.splice(e,1)}}notify(){for(const t of this.listeners.slice())t()}committedField(t,e,n){return this.readField(t,e,n)}pendingField(t,e,n){const s=d(t,e,n),i=this.shadow.get(s);if(i===void 0)return;const o=this.readField(t,e,n);if(o===i||o===void 0){this.shadow.delete(s);return}return i}commit(t){if(t.forward.length===0)return t;for(const e of t.forward)this.queue.push(e);return this.applyShadow(t.forward),this.undoStack.push(t),this.redoStack.length=0,this.notify(),t}applyShadow(t){for(const e of t)e.kind==="set_field"&&this.shadow.set(d(e.eid,e.def,e.field),e.value)}}function c(r,t,e,n,s){return{get value(){return s!==void 0?s():r.committedField(t,e,n)},set(i){r.setField(t,e,n,i)},get pending(){return r.pendingField(t,e,n)}}}exports.Editor=u;exports.TransactionBuilder=h;exports.fieldHandle=c;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function o(r,t,e){return`${r}:${t.id}:${e}`}const a=new WeakMap;class h{constructor(t,e){this.readField=t,this.shadow=e,a.set(this,{forward:[],inverse:[]})}staged=new Map;get _txn(){return a.get(this)}spawn(t,e){const s={kind:"despawn",eid:0};return this._txn.inverse.push(s),this._txn.forward.push({kind:"spawn",components:t,onSpawned:n=>{s.eid=n,e?.(n)}}),this}despawn(t,e){const s={kind:"despawn",eid:t};return this._txn.forward.push(s),this._txn.inverse.push({kind:"spawn",components:e,onSpawned:n=>{s.eid=n}}),this}setField(t,e,s,n){const i=o(t,e,s),d=this.staged.get(i)??this.shadow.get(i)??this.readField(t,e,s)??0;return this.staged.set(i,n),this._txn.forward.push({kind:"set_field",eid:t,def:e,field:s,value:n}),this._txn.inverse.push({kind:"set_field",eid:t,def:e,field:s,value:d}),this}add(t,e,s){return this._txn.forward.push({kind:"add_component",eid:t,def:e,values:s}),this._txn.inverse.push({kind:"remove_component",eid:t,def:e}),this}remove(t,e,s){return this._txn.forward.push({kind:"remove_component",eid:t,def:e}),this._txn.inverse.push({kind:"add_component",eid:t,def:e,values:s}),this}disable(t){return this._txn.forward.push({kind:"disable",eid:t}),this._txn.inverse.push({kind:"enable",eid:t}),this}enable(t){return this._txn.forward.push({kind:"enable",eid:t}),this._txn.inverse.push({kind:"disable",eid:t}),this}}class u{constructor(t,e){this.queue=t,this.readField=e}undoStack=[];redoStack=[];listeners=[];shadow=new Map;transaction(t){const e=new h(this.readField,this.shadow);return t(e),this.commit(a.get(e))}spawn(t,e){return this.transaction(s=>s.spawn(t,e))}despawn(t,e){return this.transaction(s=>s.despawn(t,e))}setField(t,e,s,n){return this.transaction(i=>i.setField(t,e,s,n))}add(t,e,s){return this.transaction(n=>n.add(t,e,s))}remove(t,e,s){return this.transaction(n=>n.remove(t,e,s))}disable(t){return this.transaction(e=>e.disable(t))}enable(t){return this.transaction(e=>e.enable(t))}undo(){const t=this.undoStack.pop();if(t===void 0)return!1;const e=t.inverse.slice().reverse();for(const s of e)this.queue.push(s);return this.applyShadow(e),this.redoStack.push(t),this.notify(),!0}redo(){const t=this.redoStack.pop();if(t===void 0)return!1;for(const e of t.forward)this.queue.push(e);return this.applyShadow(t.forward),this.undoStack.push(t),this.notify(),!0}clear(){this.undoStack.length=0,this.redoStack.length=0,this.shadow.clear(),this.notify()}depths(){return{undo:this.undoStack.length,redo:this.redoStack.length}}get canUndo(){return this.undoStack.length>0}get canRedo(){return this.redoStack.length>0}onChange(t){return this.listeners.push(t),()=>{const e=this.listeners.indexOf(t);e!==-1&&this.listeners.splice(e,1)}}notify(){for(const t of this.listeners.slice())t()}committedField(t,e,s){return this.readField(t,e,s)}pendingField(t,e,s){const n=o(t,e,s),i=this.shadow.get(n);if(i===void 0)return;const d=this.readField(t,e,s);if(d===i||d===void 0){this.shadow.delete(n);return}return i}commit(t){if(t.forward.length===0)return t;for(const e of t.forward)this.queue.push(e);return this.applyShadow(t.forward),this.undoStack.push(t),this.redoStack.length=0,this.notify(),t}applyShadow(t){for(const e of t)e.kind==="set_field"&&this.shadow.set(o(e.eid,e.def,e.field),e.value)}}function c(r,t,e,s,n){return{get value(){return n!==void 0?n():r.committedField(t,e,s)},set(i){r.setField(t,e,s,i)},get pending(){return r.pendingField(t,e,s)}}}exports.Editor=u;exports.TransactionBuilder=h;exports.fieldHandle=c;

package/dist/extensions/editor/index.js

@@ -1,11 +1,11 @@
-function a(r, t, e) {
+function o(r, t, e) {
   return `${r}:${t.id}:${e}`;
 }
-const d = /* @__PURE__ */ new WeakMap();
+const a = /* @__PURE__ */ new WeakMap();
 class h {
   /** @internal */
   constructor(t, e) {
-    this.readField = t, this.shadow = e, d.set(this, { forward: [], inverse: [] });
+    this.readField = t, this.shadow = e, a.set(this, { forward: [], inverse: [] });
   }
   /** Values staged by THIS build, layered over the editor's shared shadow. Kept
    * transaction-local so an aborted build (the callback throws before commit)
@@ -14,62 +14,64 @@ class h {
    * held. The one merge point into the shared shadow is commit's `applyShadow`. */
   staged = /* @__PURE__ */ new Map();
   get _txn() {
-    return d.get(this);
+    return a.get(this);
   }
   spawn(t, e) {
-    const n = {
+    const s = {
       kind: "despawn",
       eid: 0
     };
-    return this._txn.inverse.push(n), this._txn.forward.push({
+    return this._txn.inverse.push(s), this._txn.forward.push({
       kind: "spawn",
       components: t,
-      onSpawned: (s) => {
-        n.eid = s, e?.(s);
+      onSpawned: (n) => {
+        s.eid = n, e?.(n);
       }
     }), this;
   }
   despawn(t, e) {
-    const n = { kind: "despawn", eid: t };
-    return this._txn.forward.push(n), this._txn.inverse.push({
+    const s = { kind: "despawn", eid: t };
+    return this._txn.forward.push(s), this._txn.inverse.push({
       kind: "spawn",
       components: e,
-      onSpawned: (s) => {
-        n.eid = s;
+      onSpawned: (n) => {
+        s.eid = n;
       }
     }), this;
   }
   /**
-   * Set `field` of `def` on `eid` to `value`. Inverse: set it back to the value
+   * Set `field` of `def` on `entityId` to `value`. Inverse: set it back to the value
    * this edit replaced — read from the staged overlay / shadow (so stacked edits,
    * within one build or before a commit, invert correctly) or, failing that, the
    * read channel (`0` if unknown).
    */
-  setField(t, e, n, s) {
-    const i = a(t, e, n), o = this.staged.get(i) ?? this.shadow.get(i) ?? this.readField(t, e, n) ?? 0;
-    return this.staged.set(i, s), this._txn.forward.push({ kind: "set_field", eid: t, def: e, field: n, value: s }), this._txn.inverse.push({ kind: "set_field", eid: t, def: e, field: n, value: o }), this;
+  setField(t, e, s, n) {
+    const i = o(t, e, s), d = this.staged.get(i) ?? this.shadow.get(i) ?? this.readField(t, e, s) ?? 0;
+    return this.staged.set(i, n), this._txn.forward.push({ kind: "set_field", eid: t, def: e, field: s, value: n }), this._txn.inverse.push({ kind: "set_field", eid: t, def: e, field: s, value: d }), this;
   }
-  /** Add `def` (with complete `values`) to `eid`. Inverse: remove it. */
-  addComponent(t, e, n) {
-    return this._txn.forward.push({ kind: "add_component", eid: t, def: e, values: n }), this._txn.inverse.push({ kind: "remove_component", eid: t, def: e }), this;
+  /** Attach `def` (with complete `values`) to `entityId`. Inverse: remove it.
+   * Bare `add` — the namespaced-handle grammar (matches `ctx.commands.add` and
+   * the queue's `add`), not `addComponent`. */
+  add(t, e, s) {
+    return this._txn.forward.push({ kind: "add_component", eid: t, def: e, values: s }), this._txn.inverse.push({ kind: "remove_component", eid: t, def: e }), this;
   }
   /**
-   * Remove `def` from `eid`. Inverse: re-add it from `restore` (the field values
-   * to recreate — read them from the channel before removing).
+   * Detach `def` from `entityId`. Inverse: re-add it from `restore` (the field values
+   * to recreate — read them from the channel before removing). Bare `remove` — see `add`.
    */
-  removeComponent(t, e, n) {
+  remove(t, e, s) {
     return this._txn.forward.push({ kind: "remove_component", eid: t, def: e }), this._txn.inverse.push({
       kind: "add_component",
       eid: t,
       def: e,
-      values: n
+      values: s
     }), this;
   }
-  /** Disable `eid`. Inverse: enable it. */
+  /** Disable `entityId`. Inverse: enable it. */
   disable(t) {
     return this._txn.forward.push({ kind: "disable", eid: t }), this._txn.inverse.push({ kind: "enable", eid: t }), this;
   }
-  /** Enable `eid`. Inverse: disable it. */
+  /** Enable `entityId`. Inverse: disable it. */
   enable(t) {
     return this._txn.forward.push({ kind: "enable", eid: t }), this._txn.inverse.push({ kind: "disable", eid: t }), this;
   }
@@ -91,31 +93,31 @@ class u {
    */
   transaction(t) {
     const e = new h(this.readField, this.shadow);
-    return t(e), this.commit(d.get(e));
+    return t(e), this.commit(a.get(e));
   }
   spawn(t, e) {
-    return this.transaction((n) => n.spawn(t, e));
+    return this.transaction((s) => s.spawn(t, e));
   }
   despawn(t, e) {
-    return this.transaction((n) => n.despawn(t, e));
+    return this.transaction((s) => s.despawn(t, e));
   }
   /** Set one field as its own undo entry. */
-  setField(t, e, n, s) {
-    return this.transaction((i) => i.setField(t, e, n, s));
+  setField(t, e, s, n) {
+    return this.transaction((i) => i.setField(t, e, s, n));
   }
-  /** Add a component as its own undo entry. */
-  addComponent(t, e, n) {
-    return this.transaction((s) => s.addComponent(t, e, n));
+  /** Attach a component as its own undo entry. Bare `add` (see `TransactionBuilder.add`). */
+  add(t, e, s) {
+    return this.transaction((n) => n.add(t, e, s));
   }
-  /** Remove a component as its own undo entry; `restore` re-adds it on undo. */
-  removeComponent(t, e, n) {
-    return this.transaction((s) => s.removeComponent(t, e, n));
+  /** Detach a component as its own undo entry; `restore` re-adds it on undo. Bare `remove`. */
+  remove(t, e, s) {
+    return this.transaction((n) => n.remove(t, e, s));
   }
-  /** Disable `eid` as its own undo entry. */
+  /** Disable `entityId` as its own undo entry. */
   disable(t) {
     return this.transaction((e) => e.disable(t));
   }
-  /** Enable `eid` as its own undo entry. */
+  /** Enable `entityId` as its own undo entry. */
   enable(t) {
     return this.transaction((e) => e.enable(t));
   }
@@ -128,7 +130,7 @@ class u {
     const t = this.undoStack.pop();
     if (t === void 0) return !1;
     const e = t.inverse.slice().reverse();
-    for (const n of e) this.queue.push(n);
+    for (const s of e) this.queue.push(s);
     return this.applyShadow(e), this.redoStack.push(t), this.notify(), !0;
   }
   /**
@@ -177,8 +179,8 @@ class u {
   /** Read one committed `(entity, component, field)` slot through the reader
    * this editor was constructed with — the default read for `fieldHandle`
    * when no channel thunk is supplied (M11). */
-  committedField(t, e, n) {
-    return this.readField(t, e, n);
+  committedField(t, e, s) {
+    return this.readField(t, e, s);
   }
   /**
    * The pending value the editor believes for a field that the committed read
@@ -195,12 +197,12 @@ class u {
    * the next edit to the slot. `value` (the read channel) is always the source of
    * truth; `pending` is only the optimistic bridge.
    */
-  pendingField(t, e, n) {
-    const s = a(t, e, n), i = this.shadow.get(s);
+  pendingField(t, e, s) {
+    const n = o(t, e, s), i = this.shadow.get(n);
     if (i === void 0) return;
-    const o = this.readField(t, e, n);
-    if (o === i || o === void 0) {
-      this.shadow.delete(s);
+    const d = this.readField(t, e, s);
+    if (d === i || d === void 0) {
+      this.shadow.delete(n);
       return;
     }
     return i;
@@ -214,19 +216,19 @@ class u {
   /** Keep the setField shadow in step with the commands just enqueued. */
   applyShadow(t) {
     for (const e of t)
-      e.kind === "set_field" && this.shadow.set(a(e.eid, e.def, e.field), e.value);
+      e.kind === "set_field" && this.shadow.set(o(e.eid, e.def, e.field), e.value);
   }
 }
-function c(r, t, e, n, s) {
+function c(r, t, e, s, n) {
   return {
     get value() {
-      return s !== void 0 ? s() : r.committedField(t, e, n);
+      return n !== void 0 ? n() : r.committedField(t, e, s);
     },
     set(i) {
-      r.setField(t, e, n, i);
+      r.setField(t, e, s, i);
     },
     get pending() {
-      return r.pendingField(t, e, n);
+      return r.pendingField(t, e, s);
     }
   };
 }

package/dist/{host_commands-i4cAeyL5.js → host_commands-BI8pEmjH.js}

@@ -1991,40 +1991,48 @@ function ue(e, t) {
 class _n {
   queued = [];
   spawn(t, n) {
-    this.queued.push({ kind: "spawn", components: t, onSpawned: n });
+    return this.queued.push({ kind: "spawn", components: t, onSpawned: n }), this;
   }
   despawn(t) {
-    this.queued.push({ kind: "despawn", eid: t });
-  }
-  addComponent(t, n, r) {
-    this.queued.push({ kind: "add_component", eid: t, def: n, values: r });
-  }
-  removeComponent(t, n) {
-    this.queued.push({ kind: "remove_component", eid: t, def: n });
-  }
-  /** Set `field` of `def` on `eid`. Applied IMMEDIATELY at the drain, unlike the
-   * deferred structural ops — so `def` must already be on `eid`. Do NOT
-   * `addComponent`/`spawn` `def` and `setField` it in the same frame: the add is
+    return this.queued.push({ kind: "despawn", eid: t }), this;
+  }
+  /** Attach `def` (with complete `values`) to `entityId` (deferred to the
+   * drain). The namespaced-handle grammar — the queue is a commands buffer, so
+   * it drops the noun (`add`, not `addComponent`), matching `ctx.commands.add`
+   * and the queue's own bare `spawn`/`despawn`/`disable`/`enable`. Values are
+   * complete (transport carries explicit intent per field; see `spawnEntry`),
+   * unlike the authoring-side bundle sugar. */
+  add(t, n, r) {
+    return this.queued.push({ kind: "add_component", eid: t, def: n, values: r }), this;
+  }
+  /** Detach `def` from `entityId` (deferred to the drain). Bare `remove`
+   * matching `ctx.commands.remove` — see `add`. */
+  remove(t, n) {
+    return this.queued.push({ kind: "remove_component", eid: t, def: n }), this;
+  }
+  /** Set `field` of `def` on `entityId`. Applied IMMEDIATELY at the drain, unlike
+   * the deferred structural ops — so `def` must already be on `entityId`. Do NOT
+   * `add`/`spawn` `def` and `setField` it in the same frame: the add is
    * still pending its flush when the immediate set runs (carry the value in
-   * `addComponent`/`spawnEntry` instead). `applyHostCommand` throws an
+   * `add`/`spawnEntry` instead). `applyHostCommand` throws an
    * actionable error in `DEV` if you do. */
   setField(t, n, r, s) {
-    this.queued.push({ kind: "set_field", eid: t, def: n, field: r, value: s });
+    return this.queued.push({ kind: "set_field", eid: t, def: n, field: r, value: s }), this;
   }
   disable(t) {
-    this.queued.push({ kind: "disable", eid: t });
+    return this.queued.push({ kind: "disable", eid: t }), this;
   }
   enable(t) {
-    this.queued.push({ kind: "enable", eid: t });
+    return this.queued.push({ kind: "enable", eid: t }), this;
   }
   /** Enqueue a pre-built command. The path for a SAB-ring codec, an editor's
    * reified inverse, or a replay log — all of which produce `HostCommand` data
    * directly rather than calling the typed sugar above. */
   push(t) {
-    this.queued.push(t);
+    return this.queued.push(t), this;
   }
   /** Commands buffered but not yet applied. */
-  pending() {
+  get pending() {
     return this.queued.length;
   }
   /** Drop every buffered command without applying it (M15) — e.g. abandoning