@latticexyz/recs 2.2.18-f0433092876e2ac9b5b12cd0ecae9c120a2d0368 → 2.2.18

package/dist/deprecated/index.js

@@ -1,2 +1,163 @@
-import{d as h,m as O,n as T,o as a,r as c,x as v}from"../chunk-2YR7WENB.js";var b=(s=>(s.Requested="Requested",s.Executing="Executing",s.WaitingForTxEvents="WaitingForTxEvents",s.Complete="Complete",s.Failed="Failed",s.Cancelled="Cancelled",s.TxReduced="TxReduced",s))(b||{});import{merge as S}from"rxjs";import{mapObject as D,awaitStreamValue as F,uuid as R}from"@latticexyz/utils";function A(d){return O(d,{state:5,on:14,metadata:18,overrides:12,txHash:6},{id:"Action"})}function L(d,x,C){let o=A(d),m={},u=new Map,f=new Map;d.registerDisposer(()=>{for(let{dispose:t}of f.values())t()});function s(t){let n=m[t.id]||v(t);return m[t.id]||(m[t.id]=n),n}function E(t){if(d.hasEntity(t.id))return console.warn(`Action with id ${t.id} is already requested.`),t.id;let i=h(d,void 0,{id:t.id});T(o,i,{state:"Requested",on:t.on,metadata:t.metadata,overrides:void 0,txHash:void 0});for(let r of Object.values(t.components))m[r.id]||(m[r.id]=v(r));let e={...t,entity:i,componentsWithOptimisticUpdates:D(t.components,r=>s(r))};u.set(e.id,e);let p=S(...Object.values(e.componentsWithOptimisticUpdates).map(r=>r.update$)).subscribe(()=>g(e));return g(e),f.set(e.id,{dispose:()=>p?.unsubscribe()}),i}function g(t){if(c(o,t.entity)?.state!=="Requested")return;let n=t.requirement(t.componentsWithOptimisticUpdates);n&&w(t,n)}async function w(t,n){if(c(o,t.entity)?.state!=="Requested")return;a(o,t.entity,{state:"Executing"});let i=t.updates(t.componentsWithOptimisticUpdates,n).map(e=>({...e,id:R()}));a(o,t.entity,{overrides:i.map(e=>`${e.id}/${e.component.id}`)});for(let{component:e,value:p,entity:r,id:y}of i)m[e.id].addOverride(y,{entity:r,value:p});try{let e=await t.execute(n);if(e&&(a(o,t.entity,{state:"WaitingForTxEvents",txHash:e}),await F(x,p=>p===e),a(o,t.entity,{state:"TxReduced"}),t.awaitConfirmation))if(C)await C(e);else throw new Error("action has awaitConfirmation but no waitForTransaction specified in createActionSystem");a(o,t.entity,{state:"Complete"})}catch(e){M(e,t)}l(t.id)}function M(t,n){console.error(t),a(o,n.entity,{state:"Failed"}),l(n.id)}function W(t){let n=u.get(t);return!n||c(o,n.entity)?.state!=="Requested"?(console.warn(`Action ${t} was not found or is not in the "Requested" state.`),!1):(a(o,n.entity,{state:"Cancelled"}),l(t),!0)}function l(t){if(!u.get(t)){console.warn(`Trying to remove action ${t} that does not exist.`);return}let i=t,e=i!=null&&c(o,i)?.overrides||[];for(let p of e){let[r,y]=p.split("/");m[y].removeOverride(r)}f.get(t)?.dispose(),f.delete(t),u.delete(t),i!=null&&setTimeout(()=>d.deleteEntity(i),5e3)}return{add:E,cancel:W,withOptimisticUpdates:s,Action:o}}export{b as ActionState,L as createActionSystem};
+import {
+  createEntity,
+  defineComponent,
+  getComponentValue,
+  overridableComponent,
+  setComponent,
+  updateComponent
+} from "../chunk-PAKOIJAK.js";
+
+// src/deprecated/constants.ts
+var ActionState = /* @__PURE__ */ ((ActionState2) => {
+  ActionState2["Requested"] = "Requested";
+  ActionState2["Executing"] = "Executing";
+  ActionState2["WaitingForTxEvents"] = "WaitingForTxEvents";
+  ActionState2["Complete"] = "Complete";
+  ActionState2["Failed"] = "Failed";
+  ActionState2["Cancelled"] = "Cancelled";
+  ActionState2["TxReduced"] = "TxReduced";
+  return ActionState2;
+})(ActionState || {});
+
+// src/deprecated/createActionSystem.ts
+import { merge } from "rxjs";
+import { mapObject, awaitStreamValue, uuid } from "@latticexyz/utils";
+
+// src/deprecated/defineActionComponent.ts
+function defineActionComponent(world) {
+  const Action = defineComponent(
+    world,
+    {
+      state: 5 /* String */,
+      on: 14 /* OptionalEntity */,
+      metadata: 18 /* OptionalT */,
+      overrides: 12 /* OptionalStringArray */,
+      txHash: 6 /* OptionalString */
+    },
+    { id: "Action" }
+  );
+  return Action;
+}
+
+// src/deprecated/createActionSystem.ts
+function createActionSystem(world, txReduced$, waitForTransaction) {
+  const Action = defineActionComponent(world);
+  const componentsWithOptimisticUpdates = {};
+  const actionData = /* @__PURE__ */ new Map();
+  const disposer = /* @__PURE__ */ new Map();
+  world.registerDisposer(() => {
+    for (const { dispose } of disposer.values()) dispose();
+  });
+  function withOptimisticUpdates(component) {
+    const optimisticComponent = componentsWithOptimisticUpdates[component.id] || overridableComponent(component);
+    if (!componentsWithOptimisticUpdates[component.id]) {
+      componentsWithOptimisticUpdates[component.id] = optimisticComponent;
+    }
+    return optimisticComponent;
+  }
+  function add(actionRequest) {
+    const existingAction = world.hasEntity(actionRequest.id);
+    if (existingAction) {
+      console.warn(`Action with id ${actionRequest.id} is already requested.`);
+      return actionRequest.id;
+    }
+    const entity = createEntity(world, void 0, {
+      id: actionRequest.id
+    });
+    setComponent(Action, entity, {
+      state: "Requested" /* Requested */,
+      on: actionRequest.on,
+      metadata: actionRequest.metadata,
+      overrides: void 0,
+      txHash: void 0
+    });
+    for (const component of Object.values(actionRequest.components)) {
+      if (!componentsWithOptimisticUpdates[component.id])
+        componentsWithOptimisticUpdates[component.id] = overridableComponent(component);
+    }
+    const action = {
+      ...actionRequest,
+      entity,
+      componentsWithOptimisticUpdates: mapObject(actionRequest.components, (c) => withOptimisticUpdates(c))
+    };
+    actionData.set(action.id, action);
+    const subscription = merge(
+      ...Object.values(action.componentsWithOptimisticUpdates).map((c) => c.update$)
+    ).subscribe(() => checkRequirement(action));
+    checkRequirement(action);
+    disposer.set(action.id, { dispose: () => subscription?.unsubscribe() });
+    return entity;
+  }
+  function checkRequirement(action) {
+    if (getComponentValue(Action, action.entity)?.state !== "Requested" /* Requested */) return;
+    const requirementResult = action.requirement(action.componentsWithOptimisticUpdates);
+    if (requirementResult) executeAction(action, requirementResult);
+  }
+  async function executeAction(action, requirementResult) {
+    if (getComponentValue(Action, action.entity)?.state !== "Requested" /* Requested */) return;
+    updateComponent(Action, action.entity, { state: "Executing" /* Executing */ });
+    const overrides = action.updates(action.componentsWithOptimisticUpdates, requirementResult).map((o) => ({ ...o, id: uuid() }));
+    updateComponent(Action, action.entity, { overrides: overrides.map((o) => `${o.id}/${o.component.id}`) });
+    for (const { component, value, entity, id } of overrides) {
+      componentsWithOptimisticUpdates[component.id].addOverride(id, { entity, value });
+    }
+    try {
+      const tx = await action.execute(requirementResult);
+      if (tx) {
+        updateComponent(Action, action.entity, { state: "WaitingForTxEvents" /* WaitingForTxEvents */, txHash: tx });
+        await awaitStreamValue(txReduced$, (v) => v === tx);
+        updateComponent(Action, action.entity, { state: "TxReduced" /* TxReduced */ });
+        if (action.awaitConfirmation) {
+          if (waitForTransaction) {
+            await waitForTransaction(tx);
+          } else {
+            throw new Error("action has awaitConfirmation but no waitForTransaction specified in createActionSystem");
+          }
+        }
+      }
+      updateComponent(Action, action.entity, { state: "Complete" /* Complete */ });
+    } catch (e) {
+      handleError(e, action);
+    }
+    remove(action.id);
+  }
+  function handleError(e, action) {
+    console.error(e);
+    updateComponent(Action, action.entity, { state: "Failed" /* Failed */ });
+    remove(action.id);
+  }
+  function cancel(actionId) {
+    const action = actionData.get(actionId);
+    if (!action || getComponentValue(Action, action.entity)?.state !== "Requested" /* Requested */) {
+      console.warn(`Action ${actionId} was not found or is not in the "Requested" state.`);
+      return false;
+    }
+    updateComponent(Action, action.entity, { state: "Cancelled" /* Cancelled */ });
+    remove(actionId);
+    return true;
+  }
+  function remove(actionId) {
+    const action = actionData.get(actionId);
+    if (!action) {
+      console.warn(`Trying to remove action ${actionId} that does not exist.`);
+      return;
+    }
+    const actionEntity = actionId;
+    const overrides = actionEntity != null && getComponentValue(Action, actionEntity)?.overrides || [];
+    for (const override of overrides) {
+      const [id, componentId] = override.split("/");
+      const component = componentsWithOptimisticUpdates[componentId];
+      component.removeOverride(id);
+    }
+    disposer.get(actionId)?.dispose();
+    disposer.delete(actionId);
+    actionData.delete(actionId);
+    actionEntity != null && setTimeout(() => world.deleteEntity(actionEntity), 5e3);
+  }
+  return { add, cancel, withOptimisticUpdates, Action };
+}
+export {
+  ActionState,
+  createActionSystem
+};
 //# sourceMappingURL=index.js.map

package/dist/deprecated/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/deprecated/constants.ts","../../src/deprecated/createActionSystem.ts","../../src/deprecated/defineActionComponent.ts"],"sourcesContent":["export enum ActionState {\n  Requested = \"Requested\",\n  Executing = \"Executing\",\n  WaitingForTxEvents = \"WaitingForTxEvents\",\n  Complete = \"Complete\",\n  Failed = \"Failed\",\n  Cancelled = \"Cancelled\",\n  TxReduced = \"TxReduced\",\n}\n","import { merge, Observable } from \"rxjs\";\nimport { mapObject, awaitStreamValue, uuid } from \"@latticexyz/utils\";\nimport { ActionState } from \"./constants\";\nimport { ActionData, ActionRequest } from \"./types\";\nimport { defineActionComponent } from \"./defineActionComponent\";\nimport { overridableComponent, setComponent, getComponentValue, updateComponent } from \"../Component\";\nimport { createEntity } from \"../Entity\";\nimport { World, OverridableComponent, Metadata, Component, Components, Entity, Schema } from \"../types\";\n\nexport type ActionSystem = ReturnType<typeof createActionSystem>;\n\n/**\n * @deprecated For now, we suggest using `overridableComponent(Component)` and `addOverride`/`removeOverride` to manage overrides yourself.\n */\nexport function createActionSystem<M = unknown>(\n  world: World,\n  txReduced$: Observable<string>,\n  waitForTransaction?: (tx: string) => Promise<void>,\n) {\n  // Action component\n  const Action = defineActionComponent<M>(world);\n\n  // Components that scheduled actions depend on including pending updates\n  const componentsWithOptimisticUpdates: { [id: string]: OverridableComponent<Schema> } = {};\n\n  // ActionData contains requirements and execute logic of scheduled actions.\n  // We also store the relevant subset of all componentsWithOptimisticUpdates in the action data,\n  // to recheck requirements only if relevant components updated.\n  const actionData = new Map<string, ActionData>();\n\n  // Disposers of requirement check autoruns for all pending actions\n  const disposer = new Map<string, { dispose: () => void }>();\n  world.registerDisposer(() => {\n    for (const { dispose } of disposer.values()) dispose();\n  });\n\n  /**\n   * Maps all components in a given components map to the respective components including pending updates\n   * @param component Component to be mapped to components including pending updates\n   * @returns Components including pending updates\n   */\n  function withOptimisticUpdates<S extends Schema, M extends Metadata, T>(\n    component: Component<S, M, T>,\n  ): OverridableComponent<S, M, T> {\n    const optimisticComponent = componentsWithOptimisticUpdates[component.id] || overridableComponent(component);\n\n    // If the component is not tracked yet, add it to the map of overridable components\n    if (!componentsWithOptimisticUpdates[component.id]) {\n      componentsWithOptimisticUpdates[component.id] = optimisticComponent;\n    }\n\n    // Typescript can't know that the optimistic component with this id has the same type as C\n    return optimisticComponent as OverridableComponent<S, M, T>;\n  }\n\n  /**\n   * Schedules an action. The action will be executed once its requirement is fulfilled.\n   * Note: the requirement will only be rechecked automatically if the requirement is based on components\n   * (or other mobx-observable values).\n   * @param actionRequest Action to be scheduled\n   * @returns index of the entity created for the action\n   */\n  function add<C extends Components, T>(actionRequest: ActionRequest<C, T, M>): Entity {\n    // Prevent the same actions from being scheduled multiple times\n    const existingAction = world.hasEntity(actionRequest.id as Entity);\n    if (existingAction) {\n      console.warn(`Action with id ${actionRequest.id} is already requested.`);\n      return actionRequest.id as Entity;\n    }\n\n    // Set the action component\n    const entity = createEntity(world, undefined, {\n      id: actionRequest.id,\n    });\n\n    setComponent(Action, entity, {\n      state: ActionState.Requested,\n      on: actionRequest.on,\n      metadata: actionRequest.metadata,\n      overrides: undefined,\n      txHash: undefined,\n    });\n\n    // Add components that are not tracked yet to internal overridable component map.\n    // Pending updates will be applied to internal overridable components.\n    for (const component of Object.values(actionRequest.components)) {\n      if (!componentsWithOptimisticUpdates[component.id])\n        componentsWithOptimisticUpdates[component.id] = overridableComponent(component);\n    }\n\n    // Store relevant components with pending updates along the action's requirement and execution logic\n    const action = {\n      ...actionRequest,\n      entity,\n      componentsWithOptimisticUpdates: mapObject(actionRequest.components, (c) => withOptimisticUpdates(c)),\n    } as unknown as ActionData;\n    actionData.set(action.id, action);\n\n    // This subscriotion makes sure the action requirement is checked again every time\n    // one of the referenced components changes or the pending updates map changes\n    const subscription = merge(\n      ...Object.values(action.componentsWithOptimisticUpdates).map((c) => c.update$),\n    ).subscribe(() => checkRequirement(action));\n    checkRequirement(action);\n    disposer.set(action.id, { dispose: () => subscription?.unsubscribe() });\n\n    return entity;\n  }\n\n  /**\n   * Checks the requirement of a given action and executes the action if the requirement is fulfilled\n   * @param action Action to check the requirement of\n   * @returns void\n   */\n  function checkRequirement(action: ActionData) {\n    // Only check requirements of requested actions\n    if (getComponentValue(Action, action.entity)?.state !== ActionState.Requested) return;\n\n    // Check requirement on components including pending updates\n    const requirementResult = action.requirement(action.componentsWithOptimisticUpdates);\n\n    // Execute the action if the requirements are met\n    if (requirementResult) executeAction(action, requirementResult);\n  }\n\n  /**\n   * Executes the given action and sets the corresponding Action component\n   * @param action ActionData of the action to be executed\n   * @param requirementResult Result of the action's requirement function\n   * @returns void\n   */\n  async function executeAction<T>(action: ActionData, requirementResult: T) {\n    // Only execute actions that were requested before\n    if (getComponentValue(Action, action.entity)?.state !== ActionState.Requested) return;\n\n    // Update the action state\n    updateComponent(Action, action.entity, { state: ActionState.Executing });\n\n    // Compute overrides\n    const overrides = action\n      .updates(action.componentsWithOptimisticUpdates, requirementResult)\n      .map((o) => ({ ...o, id: uuid() }));\n\n    // Store overrides on Action component to be able to remove when action is done\n    updateComponent(Action, action.entity, { overrides: overrides.map((o) => `${o.id}/${o.component.id}`) });\n\n    // Set all pending updates of this action\n    for (const { component, value, entity, id } of overrides) {\n      componentsWithOptimisticUpdates[component.id].addOverride(id, { entity, value });\n    }\n\n    try {\n      // Execute the action\n      const tx = await action.execute(requirementResult);\n\n      // If the result includes a hash key (single tx) or hashes (multiple tx) key, wait for the transactions to complete before removing the pending actions\n      if (tx) {\n        // Wait for all tx events to be reduced\n        updateComponent(Action, action.entity, { state: ActionState.WaitingForTxEvents, txHash: tx });\n        await awaitStreamValue(txReduced$, (v) => v === tx);\n        updateComponent(Action, action.entity, { state: ActionState.TxReduced });\n        // TODO: extend ActionData type to be aware of whether waitForTransaction is set\n        if (action.awaitConfirmation) {\n          if (waitForTransaction) {\n            await waitForTransaction(tx);\n          } else {\n            throw new Error(\"action has awaitConfirmation but no waitForTransaction specified in createActionSystem\");\n          }\n        }\n      }\n\n      updateComponent(Action, action.entity, { state: ActionState.Complete });\n    } catch (e) {\n      handleError(e, action);\n    }\n\n    // After the action is done executing (failed or completed), remove its actionData and remove the Action component\n    remove(action.id);\n  }\n\n  // Set the action's state to ActionState.Failed\n  function handleError(e: unknown, action: ActionData) {\n    console.error(e);\n    updateComponent(Action, action.entity, { state: ActionState.Failed });\n    remove(action.id);\n  }\n\n  /**\n   * Cancels the action with the given ID if it is in the \"Requested\" state.\n   * @param actionId ID of the action to be cancelled\n   * @returns void\n   */\n  function cancel(actionId: string): boolean {\n    const action = actionData.get(actionId);\n    if (!action || getComponentValue(Action, action.entity)?.state !== ActionState.Requested) {\n      console.warn(`Action ${actionId} was not found or is not in the \"Requested\" state.`);\n      return false;\n    }\n    updateComponent(Action, action.entity, { state: ActionState.Cancelled });\n    remove(actionId);\n    return true;\n  }\n\n  /**\n   * Removes actionData disposer of the action with the given ID and removes its pending updates.\n   * @param actionId ID of the action to be removed\n   */\n  function remove(actionId: string) {\n    const action = actionData.get(actionId);\n    if (!action) {\n      console.warn(`Trying to remove action ${actionId} that does not exist.`);\n      return;\n    }\n\n    // Remove this action's pending updates\n    const actionEntity = actionId as Entity;\n    const overrides = (actionEntity != null && getComponentValue(Action, actionEntity)?.overrides) || [];\n    for (const override of overrides) {\n      const [id, componentId] = override.split(\"/\");\n      const component = componentsWithOptimisticUpdates[componentId];\n      component.removeOverride(id);\n    }\n\n    // Remove this action's autorun and corresponding disposer\n    disposer.get(actionId)?.dispose();\n    disposer.delete(actionId);\n\n    // Remove the action data\n    actionData.delete(actionId);\n\n    // Remove the action entity after some time\n    actionEntity != null && setTimeout(() => world.deleteEntity(actionEntity), 5000);\n  }\n\n  return { add, cancel, withOptimisticUpdates, Action };\n}\n","import { defineComponent } from \"../Component\";\nimport { Type } from \"../constants\";\nimport { World, Component, SchemaOf, Metadata } from \"../types\";\n\nexport function defineActionComponent<T = unknown>(world: World) {\n  const Action = defineComponent(\n    world,\n    {\n      state: Type.String,\n      on: Type.OptionalEntity,\n      metadata: Type.OptionalT,\n      overrides: Type.OptionalStringArray,\n      txHash: Type.OptionalString,\n    },\n    { id: \"Action\" },\n  );\n  return Action as Component<SchemaOf<typeof Action>, Metadata, T>;\n}\n"],"mappings":"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","names":["ActionState","merge","mapObject","awaitStreamValue","uuid","defineActionComponent","world","defineComponent","createActionSystem","world","txReduced$","waitForTransaction","Action","defineActionComponent","componentsWithOptimisticUpdates","actionData","disposer","dispose","withOptimisticUpdates","component","optimisticComponent","overridableComponent","add","actionRequest","entity","createEntity","setComponent","action","mapObject","c","subscription","merge","checkRequirement","getComponentValue","requirementResult","executeAction","updateComponent","overrides","o","uuid","value","id","tx","awaitStreamValue","v","handleError","remove","e","cancel","actionId","actionEntity","override","componentId"]}
+{"version":3,"sources":["../../src/deprecated/constants.ts","../../src/deprecated/createActionSystem.ts","../../src/deprecated/defineActionComponent.ts"],"sourcesContent":["export enum ActionState {\n  Requested = \"Requested\",\n  Executing = \"Executing\",\n  WaitingForTxEvents = \"WaitingForTxEvents\",\n  Complete = \"Complete\",\n  Failed = \"Failed\",\n  Cancelled = \"Cancelled\",\n  TxReduced = \"TxReduced\",\n}\n","import { merge, Observable } from \"rxjs\";\nimport { mapObject, awaitStreamValue, uuid } from \"@latticexyz/utils\";\nimport { ActionState } from \"./constants\";\nimport { ActionData, ActionRequest } from \"./types\";\nimport { defineActionComponent } from \"./defineActionComponent\";\nimport { overridableComponent, setComponent, getComponentValue, updateComponent } from \"../Component\";\nimport { createEntity } from \"../Entity\";\nimport { World, OverridableComponent, Metadata, Component, Components, Entity, Schema } from \"../types\";\n\nexport type ActionSystem = ReturnType<typeof createActionSystem>;\n\n/**\n * @deprecated For now, we suggest using `overridableComponent(Component)` and `addOverride`/`removeOverride` to manage overrides yourself.\n */\nexport function createActionSystem<M = unknown>(\n  world: World,\n  txReduced$: Observable<string>,\n  waitForTransaction?: (tx: string) => Promise<void>,\n) {\n  // Action component\n  const Action = defineActionComponent<M>(world);\n\n  // Components that scheduled actions depend on including pending updates\n  const componentsWithOptimisticUpdates: { [id: string]: OverridableComponent<Schema> } = {};\n\n  // ActionData contains requirements and execute logic of scheduled actions.\n  // We also store the relevant subset of all componentsWithOptimisticUpdates in the action data,\n  // to recheck requirements only if relevant components updated.\n  const actionData = new Map<string, ActionData>();\n\n  // Disposers of requirement check autoruns for all pending actions\n  const disposer = new Map<string, { dispose: () => void }>();\n  world.registerDisposer(() => {\n    for (const { dispose } of disposer.values()) dispose();\n  });\n\n  /**\n   * Maps all components in a given components map to the respective components including pending updates\n   * @param component Component to be mapped to components including pending updates\n   * @returns Components including pending updates\n   */\n  function withOptimisticUpdates<S extends Schema, M extends Metadata, T>(\n    component: Component<S, M, T>,\n  ): OverridableComponent<S, M, T> {\n    const optimisticComponent = componentsWithOptimisticUpdates[component.id] || overridableComponent(component);\n\n    // If the component is not tracked yet, add it to the map of overridable components\n    if (!componentsWithOptimisticUpdates[component.id]) {\n      componentsWithOptimisticUpdates[component.id] = optimisticComponent;\n    }\n\n    // Typescript can't know that the optimistic component with this id has the same type as C\n    return optimisticComponent as OverridableComponent<S, M, T>;\n  }\n\n  /**\n   * Schedules an action. The action will be executed once its requirement is fulfilled.\n   * Note: the requirement will only be rechecked automatically if the requirement is based on components\n   * (or other mobx-observable values).\n   * @param actionRequest Action to be scheduled\n   * @returns index of the entity created for the action\n   */\n  function add<C extends Components, T>(actionRequest: ActionRequest<C, T, M>): Entity {\n    // Prevent the same actions from being scheduled multiple times\n    const existingAction = world.hasEntity(actionRequest.id as Entity);\n    if (existingAction) {\n      console.warn(`Action with id ${actionRequest.id} is already requested.`);\n      return actionRequest.id as Entity;\n    }\n\n    // Set the action component\n    const entity = createEntity(world, undefined, {\n      id: actionRequest.id,\n    });\n\n    setComponent(Action, entity, {\n      state: ActionState.Requested,\n      on: actionRequest.on,\n      metadata: actionRequest.metadata,\n      overrides: undefined,\n      txHash: undefined,\n    });\n\n    // Add components that are not tracked yet to internal overridable component map.\n    // Pending updates will be applied to internal overridable components.\n    for (const component of Object.values(actionRequest.components)) {\n      if (!componentsWithOptimisticUpdates[component.id])\n        componentsWithOptimisticUpdates[component.id] = overridableComponent(component);\n    }\n\n    // Store relevant components with pending updates along the action's requirement and execution logic\n    const action = {\n      ...actionRequest,\n      entity,\n      componentsWithOptimisticUpdates: mapObject(actionRequest.components, (c) => withOptimisticUpdates(c)),\n    } as unknown as ActionData;\n    actionData.set(action.id, action);\n\n    // This subscriotion makes sure the action requirement is checked again every time\n    // one of the referenced components changes or the pending updates map changes\n    const subscription = merge(\n      ...Object.values(action.componentsWithOptimisticUpdates).map((c) => c.update$),\n    ).subscribe(() => checkRequirement(action));\n    checkRequirement(action);\n    disposer.set(action.id, { dispose: () => subscription?.unsubscribe() });\n\n    return entity;\n  }\n\n  /**\n   * Checks the requirement of a given action and executes the action if the requirement is fulfilled\n   * @param action Action to check the requirement of\n   * @returns void\n   */\n  function checkRequirement(action: ActionData) {\n    // Only check requirements of requested actions\n    if (getComponentValue(Action, action.entity)?.state !== ActionState.Requested) return;\n\n    // Check requirement on components including pending updates\n    const requirementResult = action.requirement(action.componentsWithOptimisticUpdates);\n\n    // Execute the action if the requirements are met\n    if (requirementResult) executeAction(action, requirementResult);\n  }\n\n  /**\n   * Executes the given action and sets the corresponding Action component\n   * @param action ActionData of the action to be executed\n   * @param requirementResult Result of the action's requirement function\n   * @returns void\n   */\n  async function executeAction<T>(action: ActionData, requirementResult: T) {\n    // Only execute actions that were requested before\n    if (getComponentValue(Action, action.entity)?.state !== ActionState.Requested) return;\n\n    // Update the action state\n    updateComponent(Action, action.entity, { state: ActionState.Executing });\n\n    // Compute overrides\n    const overrides = action\n      .updates(action.componentsWithOptimisticUpdates, requirementResult)\n      .map((o) => ({ ...o, id: uuid() }));\n\n    // Store overrides on Action component to be able to remove when action is done\n    updateComponent(Action, action.entity, { overrides: overrides.map((o) => `${o.id}/${o.component.id}`) });\n\n    // Set all pending updates of this action\n    for (const { component, value, entity, id } of overrides) {\n      componentsWithOptimisticUpdates[component.id].addOverride(id, { entity, value });\n    }\n\n    try {\n      // Execute the action\n      const tx = await action.execute(requirementResult);\n\n      // If the result includes a hash key (single tx) or hashes (multiple tx) key, wait for the transactions to complete before removing the pending actions\n      if (tx) {\n        // Wait for all tx events to be reduced\n        updateComponent(Action, action.entity, { state: ActionState.WaitingForTxEvents, txHash: tx });\n        await awaitStreamValue(txReduced$, (v) => v === tx);\n        updateComponent(Action, action.entity, { state: ActionState.TxReduced });\n        // TODO: extend ActionData type to be aware of whether waitForTransaction is set\n        if (action.awaitConfirmation) {\n          if (waitForTransaction) {\n            await waitForTransaction(tx);\n          } else {\n            throw new Error(\"action has awaitConfirmation but no waitForTransaction specified in createActionSystem\");\n          }\n        }\n      }\n\n      updateComponent(Action, action.entity, { state: ActionState.Complete });\n    } catch (e) {\n      handleError(e, action);\n    }\n\n    // After the action is done executing (failed or completed), remove its actionData and remove the Action component\n    remove(action.id);\n  }\n\n  // Set the action's state to ActionState.Failed\n  function handleError(e: unknown, action: ActionData) {\n    console.error(e);\n    updateComponent(Action, action.entity, { state: ActionState.Failed });\n    remove(action.id);\n  }\n\n  /**\n   * Cancels the action with the given ID if it is in the \"Requested\" state.\n   * @param actionId ID of the action to be cancelled\n   * @returns void\n   */\n  function cancel(actionId: string): boolean {\n    const action = actionData.get(actionId);\n    if (!action || getComponentValue(Action, action.entity)?.state !== ActionState.Requested) {\n      console.warn(`Action ${actionId} was not found or is not in the \"Requested\" state.`);\n      return false;\n    }\n    updateComponent(Action, action.entity, { state: ActionState.Cancelled });\n    remove(actionId);\n    return true;\n  }\n\n  /**\n   * Removes actionData disposer of the action with the given ID and removes its pending updates.\n   * @param actionId ID of the action to be removed\n   */\n  function remove(actionId: string) {\n    const action = actionData.get(actionId);\n    if (!action) {\n      console.warn(`Trying to remove action ${actionId} that does not exist.`);\n      return;\n    }\n\n    // Remove this action's pending updates\n    const actionEntity = actionId as Entity;\n    const overrides = (actionEntity != null && getComponentValue(Action, actionEntity)?.overrides) || [];\n    for (const override of overrides) {\n      const [id, componentId] = override.split(\"/\");\n      const component = componentsWithOptimisticUpdates[componentId];\n      component.removeOverride(id);\n    }\n\n    // Remove this action's autorun and corresponding disposer\n    disposer.get(actionId)?.dispose();\n    disposer.delete(actionId);\n\n    // Remove the action data\n    actionData.delete(actionId);\n\n    // Remove the action entity after some time\n    actionEntity != null && setTimeout(() => world.deleteEntity(actionEntity), 5000);\n  }\n\n  return { add, cancel, withOptimisticUpdates, Action };\n}\n","import { defineComponent } from \"../Component\";\nimport { Type } from \"../constants\";\nimport { World, Component, SchemaOf, Metadata } from \"../types\";\n\nexport function defineActionComponent<T = unknown>(world: World) {\n  const Action = defineComponent(\n    world,\n    {\n      state: Type.String,\n      on: Type.OptionalEntity,\n      metadata: Type.OptionalT,\n      overrides: Type.OptionalStringArray,\n      txHash: Type.OptionalString,\n    },\n    { id: \"Action\" },\n  );\n  return Action as Component<SchemaOf<typeof Action>, Metadata, T>;\n}\n"],"mappings":"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","names":["ActionState"]}

package/dist/index.js

@@ -1,2 +1,412 @@
-import{a as W,b as v,c as te,d as ne,e as g,f as V,g as re,h as oe,i as ie,j as S,k as pe,l as ae,m as ye,n as C,o as ue,p as E,q as s,r as l,s as me,t as h,u as de,v as O,w as b,x as se,y as le,z as ce}from"./chunk-2YR7WENB.js";import{concat as K,EMPTY as X,from as Z}from"rxjs";import{filterNullish as R}from"@latticexyz/utils";import{observable as B}from"mobx";import{concat as $,concatMap as q,filter as F,from as D,map as j,merge as L,of as z,share as Y}from"rxjs";var N=(o=>(o[o.Has=0]="Has",o[o.HasValue=1]="HasValue",o[o.Not=2]="Not",o[o.NotValue=3]="NotValue",o[o.ProxyRead=4]="ProxyRead",o[o.ProxyExpand=5]="ProxyExpand",o))(N||{});function xe(e){return[2,4,6,14,16,8,10,12].includes(e)}function Te(e){return[7,8,9,10,11,12,15,16].includes(e)}function ge(e){return[1,2].includes(e)}function Se(e){return[13,14].includes(e)}function Le(e){return{type:0,component:e}}function ze(e){return{type:2,component:e}}function Ye(e,t){return{type:1,component:e,value:t}}function Ge(e,t){return{type:3,component:e,value:t}}function Je(e,t){return{type:4,component:e,depth:t}}function Ke(e,t){return{type:5,component:e,depth:t}}function c(e,t){if(t.type===0)return s(t.component,e);if(t.type===1)return h(t.value,l(t.component,e));if(t.type===2)return!s(t.component,e);if(t.type===3)return!h(t.value,l(t.component,e));throw new Error("Unknown query fragment")}function G(e){return e.type===0||e.type==1}function P(e){return e.type===2||e.type==3}function J(e){return e.type===5||e.type==4}function U(e,t){return e&&G(t)||!e&&P(t)}function I(e,t,n){let r=e,a=!1;for(let y=0;y<n.depth;y++){let o=l(n.component,r);if(!o)return null;let p=o.value;if(!p)return null;if(r=p,a=c(r,t),U(a,t))return a}return a}function Q(e,t,n){if(n===0)return new Set;let r=O(t,{value:e});if(n===1)return r;let a=[...r].map(y=>[...Q(y,t,n-1)]).flat();return new Set([...r,...a])}function A(e,t){let n=t?new Set([...t]):void 0,r,a;for(let y=0;y<e.length;y++){let o=e[y];if(J(o))o.type===4&&(r=o),o.type===5&&(a=o);else if(n)for(let p of[...n]){let m=c(p,o);if(r&&r.depth>0&&!U(m,o)&&(m=I(p,o,r)??m),m||n.delete(p),a&&a.depth>0){let d=Q(p,a.component,a.depth);for(let i of d)(c(i,o)||r&&r.depth>0&&I(i,o,r))&&n.add(i)}}else{if(P(o))throw new Error("First EntityQueryFragment must be Has or HasValue");if(n=o.type===0?new Set([...b(o.component)]):O(o.component,o.value),a&&a.depth>0)for(let p of[...n])for(let m of Q(p,a.component,a.depth))n.add(m)}}return n??new Set}function f(e,t){let n=t?.runOnInit||t?.initialSet?A(e,t.initialSet):new Set,r=B(n),a=D(r).pipe(S(e[0].component)),y=e.findIndex(p=>[5,4].includes(p.type))!==-1,o=L(...e.map(p=>p.component.update$)).pipe(y?q(p=>{let m=A(e,t?.initialSet),d=[];for(let i of r)m.has(i)||(r.delete(i),d.push({entity:i,type:1,component:p.component,value:[void 0,void 0]}));for(let i of m)r.has(i)?d.push({entity:i,type:2,component:p.component,value:[l(p.component,i),void 0]}):(r.add(i),d.push({entity:i,type:0,component:p.component,value:[l(p.component,i),void 0]}));return z(...d)}):j(p=>{if(r.has(p.entity))return e.filter(u=>u.component.id===p.component.id).every(u=>c(p.entity,u))?{...p,type:2}:(r.delete(p.entity),{...p,type:1});if(e.every(d=>c(p.entity,d)))return r.add(p.entity),{...p,type:0}}),R());return{matching:r,update$:$(a,o).pipe(Y())}}function H(e,t){return f(e,t).update$.pipe(F(n=>n.type===2))}function w(e,t){return f(e,t).update$.pipe(F(n=>n.type===0))}function k(e,t){return f(e,t).update$.pipe(F(n=>n.type===1))}function x(e,t,n){let r=t.subscribe(n);e.registerDisposer(()=>r?.unsubscribe())}function ot(e,t,n,r={runOnInit:!0}){x(e,H(t,r),n)}function it(e,t,n,r={runOnInit:!0}){x(e,w(t,r),n)}function pt(e,t,n,r={runOnInit:!0}){x(e,k(t,r),n)}function _(e,t,n,r={runOnInit:!0}){x(e,f(t,r).update$,n)}function at(e,t,n,r={runOnInit:!0}){let a=r?.runOnInit?Z(b(t)).pipe(S(t)):X;x(e,K(a,t.update$),n)}function yt(e,t,n,r,a={update:!1,runOnInit:!0}){_(e,t,({entity:y,type:o})=>{o===0&&C(n(y),y,r(y)),o===1&&E(n(y),y),a?.update&&o===2&&C(n(y),y,r(y))},a)}import{transformIterator as ee}from"@latticexyz/utils";function lt(){let e=new Set,t=[],n=[];function r({id:i,idSuffix:u}={}){let T=i||e.size+(u?"-"+u:""),M=g(T);return e.add(M),T}function a(){return ee(e.values(),V)}function y(i){t.push(i)}function o(i){for(let[,u]of n.filter(T=>!i||T[0]===i))u();n=n.filter(u=>i&&u[0]!==i)}function p(i,u=""){n.push([u,i])}function m(i){let u=g(i);return e.has(u)}function d(i){for(let u of t)s(u,i)&&E(u,i);e.delete(g(i))}return{registerEntity:r,components:t,registerComponent:y,dispose:o,registerDisposer:p,hasEntity:m,getEntities:a,entitySymbols:e,deleteEntity:d}}function ct(e,t){return{...e,registerDisposer:n=>e.registerDisposer(n,t),dispose:()=>e.dispose(t)}}function ft(e,t){return e.components.filter(n=>s(n,t))}export{Le as Has,Ye as HasValue,ze as Not,Ge as NotValue,te as OptionalTypes,Ke as ProxyExpand,Je as ProxyRead,N as QueryFragmentType,W as Type,v as UpdateType,le as clearLocalCache,h as componentValueEquals,ne as createEntity,re as createIndexer,ce as createLocalCache,lt as createWorld,ye as defineComponent,at as defineComponentSystem,w as defineEnterQuery,it as defineEnterSystem,k as defineExitQuery,pt as defineExitSystem,f as defineQuery,x as defineRxSystem,yt as defineSyncSystem,_ as defineSystem,H as defineUpdateQuery,ot as defineUpdateSystem,Q as getChildEntities,b as getComponentEntities,l as getComponentValue,me as getComponentValueStrict,O as getEntitiesWithValue,ft as getEntityComponents,V as getEntityString,g as getEntitySymbol,s as hasComponent,Te as isArrayType,oe as isComponentUpdate,Se as isEntityType,ae as isFullComponentValue,pe as isIndexer,ge as isNumberType,xe as isOptionalType,ct as namespaceWorld,se as overridableComponent,E as removeComponent,A as runQuery,C as setComponent,ie as toUpdate,S as toUpdateStream,ue as updateComponent,de as withValue};
+import {
+  OptionalTypes,
+  Type,
+  UpdateType,
+  clearLocalCache,
+  componentValueEquals,
+  createEntity,
+  createIndexer,
+  createLocalCache,
+  defineComponent,
+  getComponentEntities,
+  getComponentValue,
+  getComponentValueStrict,
+  getEntitiesWithValue,
+  getEntityString,
+  getEntitySymbol,
+  hasComponent,
+  isComponentUpdate,
+  isFullComponentValue,
+  isIndexer,
+  overridableComponent,
+  removeComponent,
+  setComponent,
+  toUpdate,
+  toUpdateStream,
+  updateComponent,
+  withValue
+} from "./chunk-PAKOIJAK.js";
+
+// src/System.ts
+import { concat as concat2, EMPTY, from as from2 } from "rxjs";
+
+// src/Query.ts
+import { filterNullish } from "@latticexyz/utils";
+import { observable } from "mobx";
+import { concat, concatMap, filter, from, map, merge, of, share } from "rxjs";
+
+// src/types.ts
+var QueryFragmentType = /* @__PURE__ */ ((QueryFragmentType2) => {
+  QueryFragmentType2[QueryFragmentType2["Has"] = 0] = "Has";
+  QueryFragmentType2[QueryFragmentType2["HasValue"] = 1] = "HasValue";
+  QueryFragmentType2[QueryFragmentType2["Not"] = 2] = "Not";
+  QueryFragmentType2[QueryFragmentType2["NotValue"] = 3] = "NotValue";
+  QueryFragmentType2[QueryFragmentType2["ProxyRead"] = 4] = "ProxyRead";
+  QueryFragmentType2[QueryFragmentType2["ProxyExpand"] = 5] = "ProxyExpand";
+  return QueryFragmentType2;
+})(QueryFragmentType || {});
+function isOptionalType(t) {
+  return [
+    2 /* OptionalNumber */,
+    4 /* OptionalBigInt */,
+    6 /* OptionalString */,
+    14 /* OptionalEntity */,
+    16 /* OptionalEntityArray */,
+    8 /* OptionalNumberArray */,
+    10 /* OptionalBigIntArray */,
+    12 /* OptionalStringArray */
+  ].includes(t);
+}
+function isArrayType(t) {
+  return [
+    7 /* NumberArray */,
+    8 /* OptionalNumberArray */,
+    9 /* BigIntArray */,
+    10 /* OptionalBigIntArray */,
+    11 /* StringArray */,
+    12 /* OptionalStringArray */,
+    15 /* EntityArray */,
+    16 /* OptionalEntityArray */
+  ].includes(t);
+}
+function isNumberType(t) {
+  return [1 /* Number */, 2 /* OptionalNumber */].includes(t);
+}
+function isEntityType(t) {
+  return [13 /* Entity */, 14 /* OptionalEntity */].includes(t);
+}
+
+// src/Query.ts
+function Has(component) {
+  return { type: 0 /* Has */, component };
+}
+function Not(component) {
+  return { type: 2 /* Not */, component };
+}
+function HasValue(component, value) {
+  return { type: 1 /* HasValue */, component, value };
+}
+function NotValue(component, value) {
+  return { type: 3 /* NotValue */, component, value };
+}
+function ProxyRead(component, depth) {
+  return { type: 4 /* ProxyRead */, component, depth };
+}
+function ProxyExpand(component, depth) {
+  return { type: 5 /* ProxyExpand */, component, depth };
+}
+function passesQueryFragment(entity, fragment) {
+  if (fragment.type === 0 /* Has */) {
+    return hasComponent(fragment.component, entity);
+  }
+  if (fragment.type === 1 /* HasValue */) {
+    return componentValueEquals(fragment.value, getComponentValue(fragment.component, entity));
+  }
+  if (fragment.type === 2 /* Not */) {
+    return !hasComponent(fragment.component, entity);
+  }
+  if (fragment.type === 3 /* NotValue */) {
+    return !componentValueEquals(fragment.value, getComponentValue(fragment.component, entity));
+  }
+  throw new Error("Unknown query fragment");
+}
+function isPositiveFragment(fragment) {
+  return fragment.type === 0 /* Has */ || fragment.type == 1 /* HasValue */;
+}
+function isNegativeFragment(fragment) {
+  return fragment.type === 2 /* Not */ || fragment.type == 3 /* NotValue */;
+}
+function isSettingFragment(fragment) {
+  return fragment.type === 5 /* ProxyExpand */ || fragment.type == 4 /* ProxyRead */;
+}
+function isBreakingPassState(passes, fragment) {
+  return passes && isPositiveFragment(fragment) || !passes && isNegativeFragment(fragment);
+}
+function passesQueryFragmentProxy(entity, fragment, proxyRead) {
+  let proxyEntity = entity;
+  let passes = false;
+  for (let i = 0; i < proxyRead.depth; i++) {
+    const value = getComponentValue(proxyRead.component, proxyEntity);
+    if (!value) return null;
+    const entity2 = value.value;
+    if (!entity2) return null;
+    proxyEntity = entity2;
+    passes = passesQueryFragment(proxyEntity, fragment);
+    if (isBreakingPassState(passes, fragment)) {
+      return passes;
+    }
+  }
+  return passes;
+}
+function getChildEntities(entity, component, depth) {
+  if (depth === 0) return /* @__PURE__ */ new Set();
+  const directChildEntities = getEntitiesWithValue(component, { value: entity });
+  if (depth === 1) return directChildEntities;
+  const indirectChildEntities = [...directChildEntities].map((childEntity) => [...getChildEntities(childEntity, component, depth - 1)]).flat();
+  return /* @__PURE__ */ new Set([...directChildEntities, ...indirectChildEntities]);
+}
+function runQuery(fragments, initialSet) {
+  let entities = initialSet ? /* @__PURE__ */ new Set([...initialSet]) : void 0;
+  let proxyRead = void 0;
+  let proxyExpand = void 0;
+  for (let i = 0; i < fragments.length; i++) {
+    const fragment = fragments[i];
+    if (isSettingFragment(fragment)) {
+      if (fragment.type === 4 /* ProxyRead */) proxyRead = fragment;
+      if (fragment.type === 5 /* ProxyExpand */) proxyExpand = fragment;
+    } else if (!entities) {
+      if (isNegativeFragment(fragment)) {
+        throw new Error("First EntityQueryFragment must be Has or HasValue");
+      }
+      entities = fragment.type === 0 /* Has */ ? /* @__PURE__ */ new Set([...getComponentEntities(fragment.component)]) : getEntitiesWithValue(fragment.component, fragment.value);
+      if (proxyExpand && proxyExpand.depth > 0) {
+        for (const entity of [...entities]) {
+          for (const childEntity of getChildEntities(entity, proxyExpand.component, proxyExpand.depth)) {
+            entities.add(childEntity);
+          }
+        }
+      }
+    } else {
+      for (const entity of [...entities]) {
+        let passes = passesQueryFragment(entity, fragment);
+        if (proxyRead && proxyRead.depth > 0 && !isBreakingPassState(passes, fragment)) {
+          passes = passesQueryFragmentProxy(entity, fragment, proxyRead) ?? passes;
+        }
+        if (!passes) entities.delete(entity);
+        if (proxyExpand && proxyExpand.depth > 0) {
+          const childEntities = getChildEntities(entity, proxyExpand.component, proxyExpand.depth);
+          for (const childEntity of childEntities) {
+            if (passesQueryFragment(childEntity, fragment) || proxyRead && proxyRead.depth > 0 && passesQueryFragmentProxy(childEntity, fragment, proxyRead))
+              entities.add(childEntity);
+          }
+        }
+      }
+    }
+  }
+  return entities ?? /* @__PURE__ */ new Set();
+}
+function defineQuery(fragments, options) {
+  const initialSet = options?.runOnInit || options?.initialSet ? runQuery(fragments, options.initialSet) : /* @__PURE__ */ new Set();
+  const matching = observable(initialSet);
+  const initial$ = from(matching).pipe(toUpdateStream(fragments[0].component));
+  const containsProxy = fragments.findIndex((v) => [5 /* ProxyExpand */, 4 /* ProxyRead */].includes(v.type)) !== -1;
+  const internal$ = merge(...fragments.map((f) => f.component.update$)).pipe(
+    containsProxy ? concatMap((update) => {
+      const newMatchingSet = runQuery(fragments, options?.initialSet);
+      const updates = [];
+      for (const previouslyMatchingEntity of matching) {
+        if (!newMatchingSet.has(previouslyMatchingEntity)) {
+          matching.delete(previouslyMatchingEntity);
+          updates.push({
+            entity: previouslyMatchingEntity,
+            type: 1 /* Exit */,
+            component: update.component,
+            value: [void 0, void 0]
+          });
+        }
+      }
+      for (const matchingEntity of newMatchingSet) {
+        if (matching.has(matchingEntity)) {
+          updates.push({
+            entity: matchingEntity,
+            type: 2 /* Update */,
+            component: update.component,
+            value: [getComponentValue(update.component, matchingEntity), void 0]
+          });
+        } else {
+          matching.add(matchingEntity);
+          updates.push({
+            entity: matchingEntity,
+            type: 0 /* Enter */,
+            component: update.component,
+            value: [getComponentValue(update.component, matchingEntity), void 0]
+          });
+        }
+      }
+      return of(...updates);
+    }) : (
+      // Query does not contain proxies
+      map((update) => {
+        if (matching.has(update.entity)) {
+          const relevantFragments = fragments.filter((f) => f.component.id === update.component.id);
+          const pass2 = relevantFragments.every((f) => passesQueryFragment(update.entity, f));
+          if (pass2) {
+            return { ...update, type: 2 /* Update */ };
+          } else {
+            matching.delete(update.entity);
+            return { ...update, type: 1 /* Exit */ };
+          }
+        }
+        const pass = fragments.every((f) => passesQueryFragment(update.entity, f));
+        if (pass) {
+          matching.add(update.entity);
+          return { ...update, type: 0 /* Enter */ };
+        }
+      })
+    ),
+    filterNullish()
+  );
+  return {
+    matching,
+    update$: concat(initial$, internal$).pipe(share())
+  };
+}
+function defineUpdateQuery(fragments, options) {
+  return defineQuery(fragments, options).update$.pipe(filter((e) => e.type === 2 /* Update */));
+}
+function defineEnterQuery(fragments, options) {
+  return defineQuery(fragments, options).update$.pipe(filter((e) => e.type === 0 /* Enter */));
+}
+function defineExitQuery(fragments, options) {
+  return defineQuery(fragments, options).update$.pipe(filter((e) => e.type === 1 /* Exit */));
+}
+
+// src/System.ts
+function defineRxSystem(world, observable$, system) {
+  const subscription = observable$.subscribe(system);
+  world.registerDisposer(() => subscription?.unsubscribe());
+}
+function defineUpdateSystem(world, query, system, options = { runOnInit: true }) {
+  defineRxSystem(world, defineUpdateQuery(query, options), system);
+}
+function defineEnterSystem(world, query, system, options = { runOnInit: true }) {
+  defineRxSystem(world, defineEnterQuery(query, options), system);
+}
+function defineExitSystem(world, query, system, options = { runOnInit: true }) {
+  defineRxSystem(world, defineExitQuery(query, options), system);
+}
+function defineSystem(world, query, system, options = { runOnInit: true }) {
+  defineRxSystem(world, defineQuery(query, options).update$, system);
+}
+function defineComponentSystem(world, component, system, options = { runOnInit: true }) {
+  const initial$ = options?.runOnInit ? from2(getComponentEntities(component)).pipe(toUpdateStream(component)) : EMPTY;
+  defineRxSystem(world, concat2(initial$, component.update$), system);
+}
+function defineSyncSystem(world, query, component, value, options = { update: false, runOnInit: true }) {
+  defineSystem(
+    world,
+    query,
+    ({ entity, type }) => {
+      if (type === 0 /* Enter */) setComponent(component(entity), entity, value(entity));
+      if (type === 1 /* Exit */) removeComponent(component(entity), entity);
+      if (options?.update && type === 2 /* Update */) setComponent(component(entity), entity, value(entity));
+    },
+    options
+  );
+}
+
+// src/World.ts
+import { transformIterator } from "@latticexyz/utils";
+function createWorld() {
+  const entitySymbols = /* @__PURE__ */ new Set();
+  const components = [];
+  let disposers = [];
+  function registerEntity({ id, idSuffix } = {}) {
+    const entity = id || entitySymbols.size + (idSuffix ? "-" + idSuffix : "");
+    const entitySymbol = getEntitySymbol(entity);
+    entitySymbols.add(entitySymbol);
+    return entity;
+  }
+  function getEntities() {
+    return transformIterator(entitySymbols.values(), getEntityString);
+  }
+  function registerComponent(component) {
+    components.push(component);
+  }
+  function dispose(namespace) {
+    for (const [, disposer] of disposers.filter((d) => !namespace || d[0] === namespace)) {
+      disposer();
+    }
+    disposers = disposers.filter((d) => namespace && d[0] !== namespace);
+  }
+  function registerDisposer(disposer, namespace = "") {
+    disposers.push([namespace, disposer]);
+  }
+  function hasEntity(entity) {
+    const entitySymbol = getEntitySymbol(entity);
+    return entitySymbols.has(entitySymbol);
+  }
+  function deleteEntity(entity) {
+    for (const component of components) {
+      if (hasComponent(component, entity)) removeComponent(component, entity);
+    }
+    entitySymbols.delete(getEntitySymbol(entity));
+  }
+  return {
+    registerEntity,
+    components,
+    registerComponent,
+    dispose,
+    registerDisposer,
+    hasEntity,
+    getEntities,
+    entitySymbols,
+    deleteEntity
+  };
+}
+function namespaceWorld(world, namespace) {
+  return {
+    ...world,
+    registerDisposer: (disposer) => world.registerDisposer(disposer, namespace),
+    dispose: () => world.dispose(namespace)
+  };
+}
+function getEntityComponents(world, entity) {
+  return world.components.filter((component) => hasComponent(component, entity));
+}
+export {
+  Has,
+  HasValue,
+  Not,
+  NotValue,
+  OptionalTypes,
+  ProxyExpand,
+  ProxyRead,
+  QueryFragmentType,
+  Type,
+  UpdateType,
+  clearLocalCache,
+  componentValueEquals,
+  createEntity,
+  createIndexer,
+  createLocalCache,
+  createWorld,
+  defineComponent,
+  defineComponentSystem,
+  defineEnterQuery,
+  defineEnterSystem,
+  defineExitQuery,
+  defineExitSystem,
+  defineQuery,
+  defineRxSystem,
+  defineSyncSystem,
+  defineSystem,
+  defineUpdateQuery,
+  defineUpdateSystem,
+  getChildEntities,
+  getComponentEntities,
+  getComponentValue,
+  getComponentValueStrict,
+  getEntitiesWithValue,
+  getEntityComponents,
+  getEntityString,
+  getEntitySymbol,
+  hasComponent,
+  isArrayType,
+  isComponentUpdate,
+  isEntityType,
+  isFullComponentValue,
+  isIndexer,
+  isNumberType,
+  isOptionalType,
+  namespaceWorld,
+  overridableComponent,
+  removeComponent,
+  runQuery,
+  setComponent,
+  toUpdate,
+  toUpdateStream,
+  updateComponent,
+  withValue
+};
 //# sourceMappingURL=index.js.map