@block_factory/lib 0.0.3 → 0.0.5

package/index.js

@@ -1,8 +1,43 @@
 var __defProp = Object.defineProperty;
 var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
 var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
 
-// util/Math.ts
+// _module/BlockFactory.ts
+var BlockFactory_exports = {};
+__export(BlockFactory_exports, {
+  Command: () => Command,
+  ContainerWrapper: () => ContainerWrapper,
+  IEntityWrapper: () => IEntityWrapper,
+  IForm: () => IForm,
+  IPlayerWrapper: () => IPlayerWrapper,
+  MathUtils: () => MathUtils,
+  RawText: () => RawText,
+  RegisterForm: () => RegisterForm,
+  Signal: () => Signal,
+  System: () => System,
+  Vec2: () => Vec2,
+  Vec3: () => Vec3,
+  _EntityHandler_: () => _EntityHandler_,
+  _INITIALIZE_BF_FRAMEWORK_: () => _INITIALIZE_BF_FRAMEWORK_,
+  _THREAD_: () => _THREAD_,
+  onEntityEmission: () => onEntityEmission
+});
+
+// _module/Framework/_INIT.ts
+var IS_INITIALIZED = false;
+var PACK_ID = void 0;
+function _INITIALIZE_BF_FRAMEWORK_(packId) {
+  if (IS_INITIALIZED) throw Error(`CONFLICT WARNING: ${PACK_ID} already initialized.`);
+  PACK_ID = packId;
+  IS_INITIALIZED = true;
+  console.log("Block Factory Framework Loaded");
+}
+
+// _module/util/Math.ts
 var MathUtils;
 ((MathUtils2) => {
   function clamp(value, min, max) {
@@ -72,7 +107,7 @@ var MathUtils;
   ;
 })(MathUtils || (MathUtils = {}));
 
-// util/Signal.ts
+// _module/util/Signal.ts
 var Signal = class {
   constructor() {
     __publicField(this, "listeners", /* @__PURE__ */ new Set());
@@ -93,13 +128,17 @@ var Signal = class {
     return this.listeners.has(callback);
   }
   emit(data) {
-    for (const cb of Array.from(this.listeners)) {
-      cb(data);
+    for (const callback of Array.from(this.listeners)) {
+      try {
+        callback(data);
+      } catch (err) {
+        console.error("BFLIB: Signal listener error:", err);
+      }
     }
   }
 };
 
-// util/Vector.ts
+// _module/util/Vector.ts
 var _Vec2 = class _Vec2 {
   /**
    * Creates a new Vec2.
@@ -419,52 +458,75 @@ __publicField(_Vec3, "NORTH", new _Vec3(0, 0, 1));
 __publicField(_Vec3, "SOUTH", new _Vec3(0, 0, -1));
 var Vec3 = _Vec3;
 
-// util/RawText.ts
-var RawText;
-((RawText2) => {
-  RawText2.TEXT = (value) => ({
-    text: value
-  });
-  RawText2.TRANSLATE = (key, ...params) => ({
-    translate: key,
-    with: params.length ? params : void 0
-  });
-  RawText2.SCORE = (name, objective) => ({
-    score: {
-      name,
-      objective
-    }
-  });
-  RawText2.MESSAGE = (...rawText) => ({
-    rawtext: rawText
-  });
-  RawText2.FORMAT = {
-    DarkRed: (0, RawText2.TEXT)("\xA74"),
-    Red: (0, RawText2.TEXT)("\xA7c"),
-    Gold: (0, RawText2.TEXT)("\xA76"),
-    Yellow: (0, RawText2.TEXT)("\xA7e"),
-    Green: (0, RawText2.TEXT)("\xA72"),
-    Lime: (0, RawText2.TEXT)("\xA7a"),
-    Aqua: (0, RawText2.TEXT)("\xA7b"),
-    Cyan: (0, RawText2.TEXT)("\xA73"),
-    DarkBlue: (0, RawText2.TEXT)("\xA71"),
-    Blue: (0, RawText2.TEXT)("\xA79"),
-    Magenta: (0, RawText2.TEXT)("\xA7d"),
-    Purple: (0, RawText2.TEXT)("\xA75"),
-    White: (0, RawText2.TEXT)("\xA7f"),
-    Gray: (0, RawText2.TEXT)("\xA77"),
-    DarkGray: (0, RawText2.TEXT)("\xA78"),
-    Black: (0, RawText2.TEXT)("\xA70"),
-    Obfuscated: (0, RawText2.TEXT)("\xA7k"),
-    Bold: (0, RawText2.TEXT)("\xA7l"),
-    StrikeThrough: (0, RawText2.TEXT)("\xA7m"),
-    Italic: (0, RawText2.TEXT)("\xA7o"),
-    Reset: (0, RawText2.TEXT)("\xA7r"),
-    NewLine: (0, RawText2.TEXT)("\n")
-  };
-})(RawText || (RawText = {}));
+// _module/util/RawText.ts
+var RawText = class {
+  /**
+   * Creates a simple text component.
+   * @param value - The text value.
+   * @returns Text component object.
+   */
+  static text(value) {
+    return { text: value };
+  }
+  /**
+   * Creates a translation component with optional 'with' parameters.
+   * @param key - The translation key.
+   * @param params - The optional parameters for translation.
+   * @returns Translation component object.
+   */
+  static translate(key, ...params) {
+    return {
+      translate: key,
+      with: params.length ? params : void 0
+    };
+  }
+  /**
+   * Creates a score component.
+   * @param name - The entity's name whose score is being displayed.
+   * @param objective - The name of the score objective.
+   * @returns Score component object.
+   */
+  static score(name, objective) {
+    return { score: { name, objective } };
+  }
+  /**
+   * Wraps various text components into a rawtext structure.
+   * @param rawText - The raw text components.
+   * @returns Raw text object.
+   */
+  static message(...rawText) {
+    return { rawtext: rawText };
+  }
+};
+/**
+ * Common formatting and color codes.
+ */
+__publicField(RawText, "FORMAT", {
+  DarkRed: "\xA74",
+  Red: "\xA7c",
+  Gold: "\xA76",
+  Yellow: "\xA7e",
+  Green: "\xA72",
+  Lime: "\xA7a",
+  Aqua: "\xA7b",
+  Cyan: "\xA73",
+  DarkBlue: "\xA71",
+  Blue: "\xA79",
+  Magenta: "\xA7d",
+  Purple: "\xA75",
+  White: "\xA7f",
+  Gray: "\xA77",
+  DarkGray: "\xA78",
+  Black: "\xA70",
+  Obfuscated: "\xA7k",
+  Bold: "\xA7l",
+  StrikeThrough: "\xA7m",
+  Italic: "\xA7o",
+  Reset: "\xA7r",
+  NewLine: "\n"
+});
 
-// util/Command.ts
+// _module/util/Command.ts
 import {
   system
 } from "@minecraft/server";
@@ -500,7 +562,7 @@ system.beforeEvents.startup.subscribe(
   }
 );
 
-// util/System.ts
+// _module/util/System.ts
 var System;
 ((System2) => {
   System2.ProxyConstructor = ((_instance, source) => {
@@ -525,7 +587,7 @@ var System;
   });
 })(System || (System = {}));
 
-// util/Forms/Form.ts
+// _module/util/Forms/Form.ts
 import { world } from "@minecraft/server";
 import { uiManager } from "@minecraft/server-ui";
 var _IForm = class _IForm {
@@ -550,267 +612,10 @@ __publicField(_IForm, "occupiedPlayers", /* @__PURE__ */ new Set());
 __publicField(_IForm, "returnText", "Back");
 var IForm = _IForm;
 
-// util/Forms/FormAction.ts
+// _module/util/Forms/FormAction.ts
 import { ActionFormData } from "@minecraft/server-ui";
-var RETURN_ID = "d7213196-4cb6-4199-a40b-22fbf2d944ef";
-var IActionFormData = class extends IForm {
-  constructor() {
-    super(...arguments);
-    __publicField(this, "form", new ActionFormData());
-    __publicField(this, "_buttons", /* @__PURE__ */ new Map());
-    __publicField(this, "_nextButtonIndex", 0);
-    __publicField(this, "_id", "untitled");
-  }
-  title(titleText) {
-    this.form.title(titleText);
-    this._id = typeof titleText === "string" ? titleText : JSON.stringify(titleText);
-    return this;
-  }
-  body(bodyText) {
-    this.form.body(bodyText);
-    return this;
-  }
-  divider() {
-    this.form.divider();
-    return this;
-  }
-  header(text) {
-    this.form.header(text);
-    return this;
-  }
-  label(text) {
-    this.form.label(text);
-    return this;
-  }
-  button(text, options = {}) {
-    if (options.iconPath) this.form.button(text, options.iconPath);
-    else this.form.button(text);
-    const id = options.id ?? this._nextButtonIndex;
-    const allowReturn = options.allowReturn ?? true;
-    this._buttons.set(this._nextButtonIndex, {
-      id,
-      subForm: options.subForm,
-      allowReturn
-    });
-    this._nextButtonIndex++;
-    return this;
-  }
-  async show(player) {
-    if (IForm.isOccupied(player)) {
-      throw new Error(`Player ${player.id} is already occupied by form: ${this._id}`);
-    }
-    this.setOccupied(player, true);
-    try {
-      return await this._showInternal(player, []);
-    } finally {
-      this.setOccupied(player, false);
-    }
-  }
-  async _showChained(player, returnStack) {
-    return await this._showInternal(player, returnStack);
-  }
-  _wrapResponse(response, id) {
-    return {
-      canceled: response.canceled,
-      cancelationReason: response.cancelationReason,
-      selection: response.selection,
-      id
-    };
-  }
-  async _showInternal(player, returnStack) {
-    this.form = new ActionFormData();
-    this._buttons.clear();
-    this._nextButtonIndex = 0;
-    this.build(player);
-    if (returnStack.length > 0) {
-      this.form.button(IForm.returnText);
-      this._buttons.set(this._nextButtonIndex, {
-        id: RETURN_ID,
-        subForm: returnStack[returnStack.length - 1],
-        allowReturn: true
-      });
-      this._nextButtonIndex++;
-    }
-    const response = await this.form.show(player);
-    if (response.canceled) {
-      const wrapped2 = this._wrapResponse(response, void 0);
-      this.onCancel?.(player, wrapped2);
-      return wrapped2;
-    }
-    const meta = response.selection !== void 0 ? this._buttons.get(response.selection) : void 0;
-    if (meta?.id === RETURN_ID && meta.subForm) {
-      const prevCtor = returnStack[returnStack.length - 1];
-      const newStack = returnStack.slice(0, -1);
-      const prev = new prevCtor();
-      return await prev._showChained(player, newStack);
-    }
-    const wrapped = this._wrapResponse(response, meta?.id);
-    this.onSubmit(player, wrapped);
-    if (meta?.subForm) {
-      const next = new meta.subForm();
-      const allowReturn = meta.allowReturn ?? true;
-      const nextStack = allowReturn ? [...returnStack, this.constructor] : [...returnStack];
-      return await next._showChained(player, nextStack);
-    }
-    return wrapped;
-  }
-};
-
-// util/Forms/FormModal.ts
-import {
-  ModalFormData
-} from "@minecraft/server-ui";
-var IModalFormData = class extends IForm {
-  constructor() {
-    super(...arguments);
-    __publicField(this, "form", new ModalFormData());
-    __publicField(this, "_id", "untitled");
-    __publicField(this, "_widgetMeta", []);
-  }
-  title(titleText) {
-    this.form.title(titleText);
-    this._id = typeof titleText === "string" ? titleText : JSON.stringify(titleText);
-    return this;
-  }
-  divider() {
-    this.form.divider();
-    return this;
-  }
-  header(text) {
-    this.form.header(text);
-    return this;
-  }
-  label(text) {
-    this.form.label(text);
-    return this;
-  }
-  textField(label, options) {
-    const opts = { defaultValue: options.defaultValue };
-    this.form.textField(label, options.placeholder, opts);
-    this._widgetMeta.push({ type: "textField", id: options.id });
-    return this;
-  }
-  dropdown(label, options) {
-    const opts = { defaultValueIndex: options.defaultValueIndex };
-    this.form.dropdown(label, options.choices, opts);
-    this._widgetMeta.push({ type: "dropdown", id: options.id });
-    return this;
-  }
-  slider(label, options) {
-    const opts = {
-      defaultValue: options.defaultValue,
-      valueStep: options.step
-    };
-    this.form.slider(label, options.min, options.max, opts);
-    this._widgetMeta.push({ type: "slider", id: options.id });
-    return this;
-  }
-  toggle(label, options) {
-    const opts = { defaultValue: options.defaultValue };
-    this.form.toggle(label, opts);
-    this._widgetMeta.push({ type: "toggle", id: options.id });
-    return this;
-  }
-  async show(player) {
-    if (IForm.isOccupied(player)) {
-      throw new Error(`Player ${player.id} is already occupied by form: ${this._id}`);
-    }
-    this.setOccupied(player, true);
-    try {
-      return await this._showInternal(player);
-    } finally {
-      this.setOccupied(player, false);
-    }
-  }
-  _wrapResponse(res, values) {
-    return {
-      canceled: res.canceled,
-      cancelationReason: res.cancelationReason,
-      formValues: res.formValues,
-      widget: values
-    };
-  }
-  _mapValues(formValues) {
-    if (!formValues) return void 0;
-    const out = /* @__PURE__ */ new Map();
-    for (let i = 0; i < formValues.length; i++) {
-      const meta = this._widgetMeta[i];
-      if (!meta) continue;
-      out.set(meta.id, formValues[i]);
-    }
-    return out;
-  }
-  async _showInternal(player) {
-    this.form = new ModalFormData();
-    this._widgetMeta = [];
-    this.build(player);
-    const res = await this.form.show(player);
-    if (res.canceled) {
-      const wrapped2 = this._wrapResponse(res);
-      this.onCancel?.(player, wrapped2);
-      return wrapped2;
-    }
-    const values = this._mapValues(res.formValues);
-    const wrapped = this._wrapResponse(res, values);
-    this.onSubmit(player, wrapped);
-    return wrapped;
-  }
-};
 
-// util/Forms/FormMessage.ts
-import {
-  MessageFormData
-} from "@minecraft/server-ui";
-var IMessageFormData = class extends IForm {
-  constructor() {
-    super(...arguments);
-    __publicField(this, "form", new MessageFormData());
-    __publicField(this, "_id", "untitled");
-  }
-  title(titleText) {
-    this.form.title(titleText);
-    this._id = typeof titleText === "string" ? titleText : JSON.stringify(titleText);
-    return this;
-  }
-  body(bodyText) {
-    this.form.body(bodyText);
-    return this;
-  }
-  button0(text, id = 0) {
-    this.form.button1(text);
-    return this;
-  }
-  button1(text, id = 1) {
-    this.form.button2(text);
-    return this;
-  }
-  async show(player) {
-    if (IForm.isOccupied(player)) {
-      throw new Error(
-        `Player ${player.id} is already occupied by form: ${this._id}`
-      );
-    }
-    this.setOccupied(player, true);
-    try {
-      return await this._showInternal(player);
-    } finally {
-      this.setOccupied(player, false);
-    }
-  }
-  async _showInternal(player) {
-    this.form = new MessageFormData();
-    this.build(player);
-    const res = await this.form.show(player);
-    if (res.canceled || res.selection === void 0) {
-      this.onCancel?.(player, res);
-      return res;
-    }
-    this.onSubmit(player, res);
-    return res;
-  }
-};
-
-// util/Forms/FormRegistry.ts
+// _module/util/Forms/FormRegistry.ts
 import { Player as Player2, world as world2 } from "@minecraft/server";
 var registeredForms = [];
 function RegisterForm(itemId) {
@@ -836,7 +641,7 @@ world2.afterEvents.itemUse.subscribe((event) => {
   });
 });
 
-// util/Wrapper/Container.ts
+// _module/util/Wrapper/Container.ts
 var ContainerWrapper = class _ContainerWrapper {
   constructor(source) {
     __publicField(this, "source");
@@ -860,88 +665,108 @@ var ContainerWrapper = class _ContainerWrapper {
   }
 };
 
-// util/Wrapper/IEntity.ts
-import { EntityInventoryComponent } from "@minecraft/server";
+// _module/util/Wrapper/IEntity.ts
+import { EntityInventoryComponent, system as system2, TicksPerSecond } from "@minecraft/server";
 var IEntityWrapper = class _IEntityWrapper {
   constructor(source) {
     __publicField(this, "source");
-    //======================== Interal ========================
-    __publicField(this, "isAlive", false);
     this.source = source;
     return System.ProxyConstructor(this, source);
   }
   static wrap(source) {
     return new _IEntityWrapper(source);
   }
+  //======================== Interal ========================
   get inventory() {
     const i = this.source.getComponent(
       EntityInventoryComponent.componentId
     );
     return ContainerWrapper.wrap(i.container);
   }
-  test() {
+  async playAnimationAsync(animation, options) {
+    this.source.playAnimation(animation.id, options);
+    await system2.waitTicks(animation.length * TicksPerSecond);
   }
 };
 
-// util/Wrapper/IPlayer.ts
-import { EntityInventoryComponent as EntityInventoryComponent2 } from "@minecraft/server";
+// _module/util/Wrapper/IPlayer.ts
+import { EntityInventoryComponent as EntityInventoryComponent2, system as system3, TicksPerSecond as TicksPerSecond2 } from "@minecraft/server";
 var IPlayerWrapper = class _IPlayerWrapper {
   constructor(source) {
     __publicField(this, "source");
-    //======================== Interal ========================
-    __publicField(this, "isAlive", false);
     this.source = source;
     return System.ProxyConstructor(this, source);
   }
   static wrap(player) {
     return new _IPlayerWrapper(player);
   }
+  //======================== Interal ========================
   get inventory() {
     const i = this.source.getComponent(
       EntityInventoryComponent2.componentId
     );
     return ContainerWrapper.wrap(i.container);
   }
-  test() {
-    this.source.sendMessage(`${this.source.name} was tested`);
+  async playSoundAsync(sound, options) {
+    this.source.playSound(sound.id, options);
+    await system3.waitTicks(sound.length * TicksPerSecond2);
+  }
+  async playAnimationAsync(animation, options) {
+    this.source.playAnimation(animation.id, options);
+    await system3.waitTicks(animation.length * TicksPerSecond2);
   }
 };
 
-// sys/Threads.ts
-import { system as system2, TicksPerSecond } from "@minecraft/server";
-var Threads = class _Threads {
+// _module/Framework/Threads.ts
+import { system as system4, TicksPerSecond as TicksPerSecond3 } from "@minecraft/server";
+var Threads = class {
   constructor() {
     __publicField(this, "MAIN", new Signal());
     __publicField(this, "LATE", new Signal());
-    __publicField(this, "MAIN_INTERVAL_RATE", 0);
-    __publicField(this, "LATE_INTERVAL_RATE", TicksPerSecond);
+    __publicField(this, "_mainRate", 0);
+    __publicField(this, "_lateRate", TicksPerSecond3);
     __publicField(this, "_MAIN_ID");
     __publicField(this, "_LATE_ID");
     __publicField(this, "_delta", this.createDeltaTimer());
-    this._MAIN_ID = system2.runInterval(() => {
+    __publicField(this, "_started", false);
+  }
+  configure(cfg) {
+    if (this._started) throw new Error("BFLIB: _THREAD_ already started; configure before start().");
+    if (cfg.mainRate !== void 0) this._mainRate = cfg.mainRate;
+    if (cfg.lateRate !== void 0) this._lateRate = cfg.lateRate;
+  }
+  start() {
+    if (this._started) return;
+    this._started = true;
+    this._MAIN_ID = system4.runInterval(() => {
       if (this.MAIN.count <= 0) return;
       try {
         const delta = this._delta();
         this.MAIN.emit(delta);
-      } catch (error) {
-        throw Error(`ERROR: _THREAD_.MAIN:${this._MAIN_ID} | ${error}`);
+      } catch (e) {
+        console.error(`ERROR: _THREAD_.MAIN:${this._MAIN_ID} |`, e);
       }
-    }, this.MAIN_INTERVAL_RATE);
-    this._LATE_ID = system2.runInterval(() => {
+    }, this._mainRate);
+    this._LATE_ID = system4.runInterval(() => {
       if (this.LATE.count <= 0) return;
       try {
         this.LATE.emit();
-      } catch (error) {
-        throw Error(`ERROR: _THREAD_.LATE:${this._LATE_ID} | ${error}`);
+      } catch (e) {
+        console.error(`ERROR: _THREAD_.LATE:${this._LATE_ID} |`, e);
       }
-    }, this.LATE_INTERVAL_RATE);
+    }, this._lateRate);
   }
-  static create() {
-    return new _Threads();
+  stop() {
+    if (this._MAIN_ID !== void 0) system4.clearRun(this._MAIN_ID);
+    if (this._LATE_ID !== void 0) system4.clearRun(this._LATE_ID);
+    this._MAIN_ID = void 0;
+    this._LATE_ID = void 0;
+    this._started = false;
+    this._delta = this.createDeltaTimer();
   }
   createDeltaTimer() {
     let last = Date.now();
-    return function nextDelta() {
+    return () => {
       const now = Date.now();
       const delta = (now - last) / 1e3;
       last = now;
@@ -949,38 +774,151 @@ var Threads = class _Threads {
     };
   }
 };
-var _THREAD_ = Threads.create();
-_THREAD_.MAIN_INTERVAL_RATE = 10;
+var _THREAD_ = new Threads();
 
-// index.ts
-var BlockFactory;
-((BlockFactory2) => {
-  MathUtils;
-  Signal;
-  Vec2;
-  Vec3;
-  RawText;
-  Command;
-  System;
-  IForm;
-  IActionFormData;
-  IModalFormData;
-  IMessageFormData;
-  RegisterForm;
-  ContainerWrapper;
-  IEntityWrapper;
-  IPlayerWrapper;
-  _THREAD_;
-})(BlockFactory || (BlockFactory = {}));
+// _module/Framework/EntityTasks.ts
+import {
+  system as system5,
+  world as world3
+} from "@minecraft/server";
+var onEntityEmission = new Signal();
+var EntityHandler = class {
+  constructor() {
+    __publicField(this, "PACK_ID");
+    __publicField(this, "GLOBAL_MEMORY_ID", "GLB_MEM.ENTITY");
+    __publicField(this, "scriptEventSignal", system5.afterEvents.scriptEventReceive);
+    __publicField(this, "loadEventSignal", world3.afterEvents.worldLoad);
+    __publicField(this, "spawnEventSignal", world3.afterEvents.entitySpawn);
+    __publicField(this, "removeAfterEventSignal", world3.afterEvents.entityRemove);
+    __publicField(this, "removeBeforeEventSignal", world3.beforeEvents.entityRemove);
+    __publicField(this, "EM_INDEX", /* @__PURE__ */ new Map());
+    __publicField(this, "EM_KEYS", []);
+    __publicField(this, "SEARCH_TYPES", /* @__PURE__ */ new Set());
+    __publicField(this, "_started", false);
+    __publicField(this, "_wired", false);
+    /* ------------------------------------------------------------------------ */
+    /* Event Wiring                                                             */
+    /* ------------------------------------------------------------------------ */
+    __publicField(this, "onWorldLoad", (_event) => {
+      this.scriptEventSignal.subscribe(this.processScriptEvents);
+      if (this.SEARCH_TYPES.size > 0) {
+        this.spawnEventSignal.subscribe(this.onEntitySpawned);
+        this.removeBeforeEventSignal.subscribe(this.onEntityRemovedBefore);
+        this.removeAfterEventSignal.subscribe(this.onEntityRemovedAfter);
+      }
+      this._wired = true;
+      this.reloadEntityMemory();
+      this.loadEventSignal.unsubscribe(this.onWorldLoad);
+    });
+    __publicField(this, "processScriptEvents", (event) => {
+      if (!event.sourceEntity) return;
+      if (event.id !== `${this.PACK_ID}:entity_emitter`) return;
+      let parms;
+      try {
+        parms = JSON.parse(event.message);
+      } catch (e) {
+        console.error(`BFLIB: entity_emitter JSON parse failed:`, e);
+        return;
+      }
+      onEntityEmission.emit({
+        iEntity: IEntityWrapper.wrap(event.sourceEntity),
+        parms
+      });
+    });
+    __publicField(this, "onEntitySpawned", (event) => {
+      const entity = event.entity;
+      if (!this.isValidType(entity.typeId)) return;
+      this.saveEntityInMemory(entity);
+    });
+    __publicField(this, "onEntityRemovedBefore", (event) => {
+      const entity = event.removedEntity;
+      if (!this.isValidType(entity.typeId)) return;
+      this.deleteEntityInMemory(entity);
+    });
+    __publicField(this, "onEntityRemovedAfter", (_event) => {
+    });
+  }
+  configure() {
+    if (this._started) throw new Error("BFLIB: EntityHandler already started;");
+  }
+  registerEntity(typeId) {
+    if (Array.isArray(typeId)) typeId.forEach((t) => this.SEARCH_TYPES.add(t));
+    else this.SEARCH_TYPES.add(typeId);
+  }
+  start(packId) {
+    if (this._started) return;
+    this._started = true;
+    this.PACK_ID = packId;
+    this.loadEventSignal.subscribe(this.onWorldLoad);
+  }
+  stop() {
+    if (!this._started) return;
+    this.loadEventSignal.unsubscribe(this.onWorldLoad);
+    if (this._wired) {
+      this.scriptEventSignal.unsubscribe(this.processScriptEvents);
+      this.spawnEventSignal.unsubscribe(this.onEntitySpawned);
+      this.removeBeforeEventSignal.unsubscribe(this.onEntityRemovedBefore);
+      this.removeAfterEventSignal.unsubscribe(this.onEntityRemovedAfter);
+      this._wired = false;
+    }
+    this._started = false;
+  }
+  /* ------------------------------------------------------------------------ */
+  /* Filters                                                                  */
+  /* ------------------------------------------------------------------------ */
+  isValidType(typeId) {
+    return this.SEARCH_TYPES.has(typeId);
+  }
+  /* ------------------------------------------------------------------------ */
+  /* Persistence                                                              */
+  /* ------------------------------------------------------------------------ */
+  reloadEntityMemory() {
+    this.EM_INDEX.clear();
+    this.EM_KEYS.length = 0;
+    const raw = world3.getDynamicProperty(this.GLOBAL_MEMORY_ID);
+    if (!raw) return;
+    let parsed;
+    try {
+      parsed = JSON.parse(raw);
+    } catch (e) {
+      console.error(`BFLIB: Failed to parse ${this.GLOBAL_MEMORY_ID}:`, e);
+      return;
+    }
+    for (const id of parsed) {
+      this.EM_KEYS.push(id);
+      const entity = world3.getEntity(id);
+      if (entity) this.EM_INDEX.set(entity.id, entity);
+    }
+  }
+  persistKeys() {
+    world3.setDynamicProperty(this.GLOBAL_MEMORY_ID, JSON.stringify(this.EM_KEYS));
+  }
+  saveEntityInMemory(entity) {
+    if (this.EM_INDEX.has(entity.id)) return false;
+    this.EM_KEYS.push(entity.id);
+    this.EM_INDEX.set(entity.id, entity);
+    this.persistKeys();
+    return true;
+  }
+  deleteEntityInMemory(entity) {
+    const existed = this.EM_INDEX.delete(entity.id);
+    if (!existed) return false;
+    const idx = this.EM_KEYS.indexOf(entity.id);
+    if (idx !== -1) this.EM_KEYS.splice(idx, 1);
+    this.persistKeys();
+    return true;
+  }
+  getEntitiesInMemory() {
+    return Array.from(this.EM_INDEX.values());
+  }
+};
+var _EntityHandler_ = new EntityHandler();
 export {
-  BlockFactory,
+  BlockFactory_exports as BlockFactory,
   Command,
   ContainerWrapper,
-  IActionFormData,
   IEntityWrapper,
   IForm,
-  IMessageFormData,
-  IModalFormData,
   IPlayerWrapper,
   MathUtils,
   RawText,
@@ -989,5 +927,8 @@ export {
   System,
   Vec2,
   Vec3,
-  _THREAD_
+  _EntityHandler_,
+  _INITIALIZE_BF_FRAMEWORK_,
+  _THREAD_,
+  onEntityEmission
 };