@al8b/runtime 0.1.0

package/dist/types/vm.js

@@ -0,0 +1,19 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/types/vm.ts
+var vm_exports = {};
+module.exports = __toCommonJS(vm_exports);
+//# sourceMappingURL=vm.js.map

package/dist/types/vm.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/types/vm.ts"],"sourcesContent":["// VM types are re-exported from ../vm/index.ts — import from there or directly from \"@al8b/vm\".\nexport type {\n\tErrorInfo,\n\tGlobalAPI,\n\tMetaFunctions,\n\tSystemAPI,\n\tVMContext,\n\tVMWarnings,\n\tWarningInfo,\n} from \"@al8b/vm\";\n"],"mappings":";;;;;;;;;;;;;;;;AAAA;;","names":[]}

package/dist/types/vm.mjs

@@ -0,0 +1 @@
+//# sourceMappingURL=vm.mjs.map

package/dist/types/vm.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/utils/deep-clone.d.mts

@@ -0,0 +1,14 @@
+/**
+ * Deep clone utility using structuredClone
+ */
+/**
+ * Deep clone a value using the native structuredClone API
+ * Supports all structured-cloneable types: objects, arrays, primitives, Date, Set, Map, etc.
+ * Does NOT support: Functions, Symbols, DOM nodes
+ *
+ * @param value The value to deep clone
+ * @returns A deep clone of the value
+ */
+declare function deepClone(value: unknown): unknown;
+
+export { deepClone };

package/dist/utils/deep-clone.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Deep clone utility using structuredClone
+ */
+/**
+ * Deep clone a value using the native structuredClone API
+ * Supports all structured-cloneable types: objects, arrays, primitives, Date, Set, Map, etc.
+ * Does NOT support: Functions, Symbols, DOM nodes
+ *
+ * @param value The value to deep clone
+ * @returns A deep clone of the value
+ */
+declare function deepClone(value: unknown): unknown;
+
+export { deepClone };

package/dist/utils/deep-clone.js

@@ -0,0 +1,42 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/utils/deep-clone.ts
+var deep_clone_exports = {};
+__export(deep_clone_exports, {
+  deepClone: () => deepClone
+});
+module.exports = __toCommonJS(deep_clone_exports);
+function deepClone(value) {
+  if (typeof structuredClone !== "undefined") {
+    return structuredClone(value);
+  }
+  try {
+    return JSON.parse(JSON.stringify(value));
+  } catch {
+    return value;
+  }
+}
+__name(deepClone, "deepClone");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  deepClone
+});
+//# sourceMappingURL=deep-clone.js.map

package/dist/utils/deep-clone.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/deep-clone.ts"],"sourcesContent":["/**\n * Deep clone utility using structuredClone\n */\n\n/**\n * Deep clone a value using the native structuredClone API\n * Supports all structured-cloneable types: objects, arrays, primitives, Date, Set, Map, etc.\n * Does NOT support: Functions, Symbols, DOM nodes\n *\n * @param value The value to deep clone\n * @returns A deep clone of the value\n */\nexport function deepClone(value: unknown): unknown {\n\t// Use native structuredClone if available (Node 17.5+, modern browsers)\n\tif (typeof structuredClone !== \"undefined\") {\n\t\treturn structuredClone(value);\n\t}\n\n\t// Fallback for older environments: JSON round-trip\n\t// WARNING: This loses Date, Map, Set, undefined, Function, Symbol values\n\ttry {\n\t\treturn JSON.parse(JSON.stringify(value));\n\t} catch {\n\t\t// If JSON fails (circular reference, etc.), return the original\n\t\t// This is safe but means mutations will affect the original\n\t\treturn value;\n\t}\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAAA;;;;;AAYO,SAASA,UAAUC,OAAc;AAEvC,MAAI,OAAOC,oBAAoB,aAAa;AAC3C,WAAOA,gBAAgBD,KAAAA;EACxB;AAIA,MAAI;AACH,WAAOE,KAAKC,MAAMD,KAAKE,UAAUJ,KAAAA,CAAAA;EAClC,QAAQ;AAGP,WAAOA;EACR;AACD;AAfgBD;","names":["deepClone","value","structuredClone","JSON","parse","stringify"]}

package/dist/utils/deep-clone.mjs

@@ -0,0 +1,19 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+
+// src/utils/deep-clone.ts
+function deepClone(value) {
+  if (typeof structuredClone !== "undefined") {
+    return structuredClone(value);
+  }
+  try {
+    return JSON.parse(JSON.stringify(value));
+  } catch {
+    return value;
+  }
+}
+__name(deepClone, "deepClone");
+export {
+  deepClone
+};
+//# sourceMappingURL=deep-clone.mjs.map

package/dist/utils/deep-clone.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/deep-clone.ts"],"sourcesContent":["/**\n * Deep clone utility using structuredClone\n */\n\n/**\n * Deep clone a value using the native structuredClone API\n * Supports all structured-cloneable types: objects, arrays, primitives, Date, Set, Map, etc.\n * Does NOT support: Functions, Symbols, DOM nodes\n *\n * @param value The value to deep clone\n * @returns A deep clone of the value\n */\nexport function deepClone(value: unknown): unknown {\n\t// Use native structuredClone if available (Node 17.5+, modern browsers)\n\tif (typeof structuredClone !== \"undefined\") {\n\t\treturn structuredClone(value);\n\t}\n\n\t// Fallback for older environments: JSON round-trip\n\t// WARNING: This loses Date, Map, Set, undefined, Function, Symbol values\n\ttry {\n\t\treturn JSON.parse(JSON.stringify(value));\n\t} catch {\n\t\t// If JSON fails (circular reference, etc.), return the original\n\t\t// This is safe but means mutations will affect the original\n\t\treturn value;\n\t}\n}\n"],"mappings":";;;;AAYO,SAASA,UAAUC,OAAc;AAEvC,MAAI,OAAOC,oBAAoB,aAAa;AAC3C,WAAOA,gBAAgBD,KAAAA;EACxB;AAIA,MAAI;AACH,WAAOE,KAAKC,MAAMD,KAAKE,UAAUJ,KAAAA,CAAAA;EAClC,QAAQ;AAGP,WAAOA;EACR;AACD;AAfgBD;","names":["deepClone","value","structuredClone","JSON","parse","stringify"]}

package/dist/utils/index.d.mts

@@ -0,0 +1,3 @@
+export { deepClone } from './deep-clone.mjs';
+export { ObjectPool } from './object-pool.mjs';
+export { shallowEqual } from './shallow-equal.mjs';

package/dist/utils/index.d.ts

@@ -0,0 +1,3 @@
+export { deepClone } from './deep-clone.js';
+export { ObjectPool } from './object-pool.js';
+export { shallowEqual } from './shallow-equal.js';

package/dist/utils/index.js

@@ -0,0 +1,156 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/utils/index.ts
+var utils_exports = {};
+__export(utils_exports, {
+  ObjectPool: () => ObjectPool,
+  deepClone: () => deepClone,
+  shallowEqual: () => shallowEqual
+});
+module.exports = __toCommonJS(utils_exports);
+
+// src/utils/deep-clone.ts
+function deepClone(value) {
+  if (typeof structuredClone !== "undefined") {
+    return structuredClone(value);
+  }
+  try {
+    return JSON.parse(JSON.stringify(value));
+  } catch {
+    return value;
+  }
+}
+__name(deepClone, "deepClone");
+
+// src/utils/object-pool.ts
+var ObjectPool = class {
+  static {
+    __name(this, "ObjectPool");
+  }
+  pool = [];
+  factory;
+  reset;
+  maxSize;
+  /**
+  * Create a new object pool
+  *
+  * @param factory - Function to create new objects
+  * @param reset - Function to reset object state for reuse
+  * @param maxSize - Maximum pool size (default: 100)
+  */
+  constructor(factory, reset, maxSize = 100) {
+    this.factory = factory;
+    this.reset = reset;
+    this.maxSize = maxSize;
+  }
+  /**
+  * Acquire an object from the pool
+  *
+  * Returns a new object if pool is empty, otherwise reuses a pooled object.
+  *
+  * @returns Object from pool or newly created
+  */
+  acquire() {
+    if (this.pool.length > 0) {
+      return this.pool.pop();
+    }
+    return this.factory();
+  }
+  /**
+  * Release an object back to the pool
+  *
+  * Resets the object and adds it back to the pool for reuse.
+  * If pool is at max size, the object is discarded.
+  *
+  * @param obj - Object to release
+  */
+  release(obj) {
+    if (this.pool.length >= this.maxSize) {
+      return;
+    }
+    this.reset(obj);
+    this.pool.push(obj);
+  }
+  /**
+  * Clear all objects from the pool
+  */
+  clear() {
+    this.pool = [];
+  }
+  /**
+  * Get current pool size
+  *
+  * @returns Number of objects in pool
+  */
+  size() {
+    return this.pool.length;
+  }
+  /**
+  * Get maximum pool size
+  *
+  * @returns Maximum pool size
+  */
+  getMaxSize() {
+    return this.maxSize;
+  }
+  /**
+  * Set maximum pool size
+  *
+  * @param maxSize - New maximum pool size
+  */
+  setMaxSize(maxSize) {
+    this.maxSize = maxSize;
+    if (this.pool.length > maxSize) {
+      this.pool = this.pool.slice(0, maxSize);
+    }
+  }
+};
+
+// src/utils/shallow-equal.ts
+function shallowEqual(a, b) {
+  if (a === b) {
+    return true;
+  }
+  if (typeof a !== "object" || typeof b !== "object" || a === null || b === null) {
+    return false;
+  }
+  const aObj = a;
+  const bObj = b;
+  const aKeys = Object.keys(aObj);
+  const bKeys = Object.keys(bObj);
+  if (aKeys.length !== bKeys.length) {
+    return false;
+  }
+  for (const key of aKeys) {
+    if (!(key in bObj) || aObj[key] !== bObj[key]) {
+      return false;
+    }
+  }
+  return true;
+}
+__name(shallowEqual, "shallowEqual");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ObjectPool,
+  deepClone,
+  shallowEqual
+});
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/index.ts","../../src/utils/deep-clone.ts","../../src/utils/object-pool.ts","../../src/utils/shallow-equal.ts"],"sourcesContent":["/**\n * Runtime utilities\n */\n\nexport * from \"./deep-clone\";\nexport * from \"./object-pool\";\nexport * from \"./shallow-equal\";\n","/**\n * Deep clone utility using structuredClone\n */\n\n/**\n * Deep clone a value using the native structuredClone API\n * Supports all structured-cloneable types: objects, arrays, primitives, Date, Set, Map, etc.\n * Does NOT support: Functions, Symbols, DOM nodes\n *\n * @param value The value to deep clone\n * @returns A deep clone of the value\n */\nexport function deepClone(value: unknown): unknown {\n\t// Use native structuredClone if available (Node 17.5+, modern browsers)\n\tif (typeof structuredClone !== \"undefined\") {\n\t\treturn structuredClone(value);\n\t}\n\n\t// Fallback for older environments: JSON round-trip\n\t// WARNING: This loses Date, Map, Set, undefined, Function, Symbol values\n\ttry {\n\t\treturn JSON.parse(JSON.stringify(value));\n\t} catch {\n\t\t// If JSON fails (circular reference, etc.), return the original\n\t\t// This is safe but means mutations will affect the original\n\t\treturn value;\n\t}\n}\n","/**\n * Object Pool utility for game entities\n *\n * Provides object pooling to reduce GC pressure and improve performance\n * for frequently created/destroyed game objects.\n */\n\n/**\n * Object pool for reusing objects\n *\n * @template T - Type of objects in the pool\n */\nexport class ObjectPool<T> {\n\tprivate pool: T[] = [];\n\tprivate factory: () => T;\n\tprivate reset: (obj: T) => void;\n\tprivate maxSize: number;\n\n\t/**\n\t * Create a new object pool\n\t *\n\t * @param factory - Function to create new objects\n\t * @param reset - Function to reset object state for reuse\n\t * @param maxSize - Maximum pool size (default: 100)\n\t */\n\tconstructor(factory: () => T, reset: (obj: T) => void, maxSize: number = 100) {\n\t\tthis.factory = factory;\n\t\tthis.reset = reset;\n\t\tthis.maxSize = maxSize;\n\t}\n\n\t/**\n\t * Acquire an object from the pool\n\t *\n\t * Returns a new object if pool is empty, otherwise reuses a pooled object.\n\t *\n\t * @returns Object from pool or newly created\n\t */\n\tacquire(): T {\n\t\tif (this.pool.length > 0) {\n\t\t\treturn this.pool.pop()!;\n\t\t}\n\t\treturn this.factory();\n\t}\n\n\t/**\n\t * Release an object back to the pool\n\t *\n\t * Resets the object and adds it back to the pool for reuse.\n\t * If pool is at max size, the object is discarded.\n\t *\n\t * @param obj - Object to release\n\t */\n\trelease(obj: T): void {\n\t\tif (this.pool.length >= this.maxSize) {\n\t\t\t// Pool is full, discard object\n\t\t\treturn;\n\t\t}\n\n\t\tthis.reset(obj);\n\t\tthis.pool.push(obj);\n\t}\n\n\t/**\n\t * Clear all objects from the pool\n\t */\n\tclear(): void {\n\t\tthis.pool = [];\n\t}\n\n\t/**\n\t * Get current pool size\n\t *\n\t * @returns Number of objects in pool\n\t */\n\tsize(): number {\n\t\treturn this.pool.length;\n\t}\n\n\t/**\n\t * Get maximum pool size\n\t *\n\t * @returns Maximum pool size\n\t */\n\tgetMaxSize(): number {\n\t\treturn this.maxSize;\n\t}\n\n\t/**\n\t * Set maximum pool size\n\t *\n\t * @param maxSize - New maximum pool size\n\t */\n\tsetMaxSize(maxSize: number): void {\n\t\tthis.maxSize = maxSize;\n\t\t// Trim pool if it exceeds new max size\n\t\tif (this.pool.length > maxSize) {\n\t\t\tthis.pool = this.pool.slice(0, maxSize);\n\t\t}\n\t}\n}\n","/**\n * Shallow equality comparison for objects and arrays\n */\n\n/**\n * Compare two values for shallow equality\n * For objects and arrays, only checks if top-level properties have the same references\n * For primitives, uses === comparison\n *\n * @param a First value\n * @param b Second value\n * @returns true if values are shallowly equal\n */\nexport function shallowEqual(a: unknown, b: unknown): boolean {\n\t// Same reference\n\tif (a === b) {\n\t\treturn true;\n\t}\n\n\t// Different types\n\tif (typeof a !== \"object\" || typeof b !== \"object\" || a === null || b === null) {\n\t\treturn false;\n\t}\n\n\tconst aObj = a as Record<string, unknown>;\n\tconst bObj = b as Record<string, unknown>;\n\n\t// Get keys\n\tconst aKeys = Object.keys(aObj);\n\tconst bKeys = Object.keys(bObj);\n\n\t// Different number of keys\n\tif (aKeys.length !== bKeys.length) {\n\t\treturn false;\n\t}\n\n\t// Check all keys have same reference values\n\tfor (const key of aKeys) {\n\t\tif (!(key in bObj) || aObj[key] !== bObj[key]) {\n\t\t\treturn false;\n\t\t}\n\t}\n\n\treturn true;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAAA;;;;;;;;;ACYO,SAASA,UAAUC,OAAc;AAEvC,MAAI,OAAOC,oBAAoB,aAAa;AAC3C,WAAOA,gBAAgBD,KAAAA;EACxB;AAIA,MAAI;AACH,WAAOE,KAAKC,MAAMD,KAAKE,UAAUJ,KAAAA,CAAAA;EAClC,QAAQ;AAGP,WAAOA;EACR;AACD;AAfgBD;;;ACAT,IAAMM,aAAN,MAAMA;EAZb,OAYaA;;;EACJC,OAAY,CAAA;EACZC;EACAC;EACAC;;;;;;;;EASR,YAAYF,SAAkBC,OAAyBC,UAAkB,KAAK;AAC7E,SAAKF,UAAUA;AACf,SAAKC,QAAQA;AACb,SAAKC,UAAUA;EAChB;;;;;;;;EASAC,UAAa;AACZ,QAAI,KAAKJ,KAAKK,SAAS,GAAG;AACzB,aAAO,KAAKL,KAAKM,IAAG;IACrB;AACA,WAAO,KAAKL,QAAO;EACpB;;;;;;;;;EAUAM,QAAQC,KAAc;AACrB,QAAI,KAAKR,KAAKK,UAAU,KAAKF,SAAS;AAErC;IACD;AAEA,SAAKD,MAAMM,GAAAA;AACX,SAAKR,KAAKS,KAAKD,GAAAA;EAChB;;;;EAKAE,QAAc;AACb,SAAKV,OAAO,CAAA;EACb;;;;;;EAOAW,OAAe;AACd,WAAO,KAAKX,KAAKK;EAClB;;;;;;EAOAO,aAAqB;AACpB,WAAO,KAAKT;EACb;;;;;;EAOAU,WAAWV,SAAuB;AACjC,SAAKA,UAAUA;AAEf,QAAI,KAAKH,KAAKK,SAASF,SAAS;AAC/B,WAAKH,OAAO,KAAKA,KAAKc,MAAM,GAAGX,OAAAA;IAChC;EACD;AACD;;;ACvFO,SAASY,aAAaC,GAAYC,GAAU;AAElD,MAAID,MAAMC,GAAG;AACZ,WAAO;EACR;AAGA,MAAI,OAAOD,MAAM,YAAY,OAAOC,MAAM,YAAYD,MAAM,QAAQC,MAAM,MAAM;AAC/E,WAAO;EACR;AAEA,QAAMC,OAAOF;AACb,QAAMG,OAAOF;AAGb,QAAMG,QAAQC,OAAOC,KAAKJ,IAAAA;AAC1B,QAAMK,QAAQF,OAAOC,KAAKH,IAAAA;AAG1B,MAAIC,MAAMI,WAAWD,MAAMC,QAAQ;AAClC,WAAO;EACR;AAGA,aAAWC,OAAOL,OAAO;AACxB,QAAI,EAAEK,OAAON,SAASD,KAAKO,GAAAA,MAASN,KAAKM,GAAAA,GAAM;AAC9C,aAAO;IACR;EACD;AAEA,SAAO;AACR;AA/BgBV;","names":["deepClone","value","structuredClone","JSON","parse","stringify","ObjectPool","pool","factory","reset","maxSize","acquire","length","pop","release","obj","push","clear","size","getMaxSize","setMaxSize","slice","shallowEqual","a","b","aObj","bObj","aKeys","Object","keys","bKeys","length","key"]}

package/dist/utils/index.mjs

@@ -0,0 +1,129 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+
+// src/utils/deep-clone.ts
+function deepClone(value) {
+  if (typeof structuredClone !== "undefined") {
+    return structuredClone(value);
+  }
+  try {
+    return JSON.parse(JSON.stringify(value));
+  } catch {
+    return value;
+  }
+}
+__name(deepClone, "deepClone");
+
+// src/utils/object-pool.ts
+var ObjectPool = class {
+  static {
+    __name(this, "ObjectPool");
+  }
+  pool = [];
+  factory;
+  reset;
+  maxSize;
+  /**
+  * Create a new object pool
+  *
+  * @param factory - Function to create new objects
+  * @param reset - Function to reset object state for reuse
+  * @param maxSize - Maximum pool size (default: 100)
+  */
+  constructor(factory, reset, maxSize = 100) {
+    this.factory = factory;
+    this.reset = reset;
+    this.maxSize = maxSize;
+  }
+  /**
+  * Acquire an object from the pool
+  *
+  * Returns a new object if pool is empty, otherwise reuses a pooled object.
+  *
+  * @returns Object from pool or newly created
+  */
+  acquire() {
+    if (this.pool.length > 0) {
+      return this.pool.pop();
+    }
+    return this.factory();
+  }
+  /**
+  * Release an object back to the pool
+  *
+  * Resets the object and adds it back to the pool for reuse.
+  * If pool is at max size, the object is discarded.
+  *
+  * @param obj - Object to release
+  */
+  release(obj) {
+    if (this.pool.length >= this.maxSize) {
+      return;
+    }
+    this.reset(obj);
+    this.pool.push(obj);
+  }
+  /**
+  * Clear all objects from the pool
+  */
+  clear() {
+    this.pool = [];
+  }
+  /**
+  * Get current pool size
+  *
+  * @returns Number of objects in pool
+  */
+  size() {
+    return this.pool.length;
+  }
+  /**
+  * Get maximum pool size
+  *
+  * @returns Maximum pool size
+  */
+  getMaxSize() {
+    return this.maxSize;
+  }
+  /**
+  * Set maximum pool size
+  *
+  * @param maxSize - New maximum pool size
+  */
+  setMaxSize(maxSize) {
+    this.maxSize = maxSize;
+    if (this.pool.length > maxSize) {
+      this.pool = this.pool.slice(0, maxSize);
+    }
+  }
+};
+
+// src/utils/shallow-equal.ts
+function shallowEqual(a, b) {
+  if (a === b) {
+    return true;
+  }
+  if (typeof a !== "object" || typeof b !== "object" || a === null || b === null) {
+    return false;
+  }
+  const aObj = a;
+  const bObj = b;
+  const aKeys = Object.keys(aObj);
+  const bKeys = Object.keys(bObj);
+  if (aKeys.length !== bKeys.length) {
+    return false;
+  }
+  for (const key of aKeys) {
+    if (!(key in bObj) || aObj[key] !== bObj[key]) {
+      return false;
+    }
+  }
+  return true;
+}
+__name(shallowEqual, "shallowEqual");
+export {
+  ObjectPool,
+  deepClone,
+  shallowEqual
+};
+//# sourceMappingURL=index.mjs.map

package/dist/utils/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/deep-clone.ts","../../src/utils/object-pool.ts","../../src/utils/shallow-equal.ts"],"sourcesContent":["/**\n * Deep clone utility using structuredClone\n */\n\n/**\n * Deep clone a value using the native structuredClone API\n * Supports all structured-cloneable types: objects, arrays, primitives, Date, Set, Map, etc.\n * Does NOT support: Functions, Symbols, DOM nodes\n *\n * @param value The value to deep clone\n * @returns A deep clone of the value\n */\nexport function deepClone(value: unknown): unknown {\n\t// Use native structuredClone if available (Node 17.5+, modern browsers)\n\tif (typeof structuredClone !== \"undefined\") {\n\t\treturn structuredClone(value);\n\t}\n\n\t// Fallback for older environments: JSON round-trip\n\t// WARNING: This loses Date, Map, Set, undefined, Function, Symbol values\n\ttry {\n\t\treturn JSON.parse(JSON.stringify(value));\n\t} catch {\n\t\t// If JSON fails (circular reference, etc.), return the original\n\t\t// This is safe but means mutations will affect the original\n\t\treturn value;\n\t}\n}\n","/**\n * Object Pool utility for game entities\n *\n * Provides object pooling to reduce GC pressure and improve performance\n * for frequently created/destroyed game objects.\n */\n\n/**\n * Object pool for reusing objects\n *\n * @template T - Type of objects in the pool\n */\nexport class ObjectPool<T> {\n\tprivate pool: T[] = [];\n\tprivate factory: () => T;\n\tprivate reset: (obj: T) => void;\n\tprivate maxSize: number;\n\n\t/**\n\t * Create a new object pool\n\t *\n\t * @param factory - Function to create new objects\n\t * @param reset - Function to reset object state for reuse\n\t * @param maxSize - Maximum pool size (default: 100)\n\t */\n\tconstructor(factory: () => T, reset: (obj: T) => void, maxSize: number = 100) {\n\t\tthis.factory = factory;\n\t\tthis.reset = reset;\n\t\tthis.maxSize = maxSize;\n\t}\n\n\t/**\n\t * Acquire an object from the pool\n\t *\n\t * Returns a new object if pool is empty, otherwise reuses a pooled object.\n\t *\n\t * @returns Object from pool or newly created\n\t */\n\tacquire(): T {\n\t\tif (this.pool.length > 0) {\n\t\t\treturn this.pool.pop()!;\n\t\t}\n\t\treturn this.factory();\n\t}\n\n\t/**\n\t * Release an object back to the pool\n\t *\n\t * Resets the object and adds it back to the pool for reuse.\n\t * If pool is at max size, the object is discarded.\n\t *\n\t * @param obj - Object to release\n\t */\n\trelease(obj: T): void {\n\t\tif (this.pool.length >= this.maxSize) {\n\t\t\t// Pool is full, discard object\n\t\t\treturn;\n\t\t}\n\n\t\tthis.reset(obj);\n\t\tthis.pool.push(obj);\n\t}\n\n\t/**\n\t * Clear all objects from the pool\n\t */\n\tclear(): void {\n\t\tthis.pool = [];\n\t}\n\n\t/**\n\t * Get current pool size\n\t *\n\t * @returns Number of objects in pool\n\t */\n\tsize(): number {\n\t\treturn this.pool.length;\n\t}\n\n\t/**\n\t * Get maximum pool size\n\t *\n\t * @returns Maximum pool size\n\t */\n\tgetMaxSize(): number {\n\t\treturn this.maxSize;\n\t}\n\n\t/**\n\t * Set maximum pool size\n\t *\n\t * @param maxSize - New maximum pool size\n\t */\n\tsetMaxSize(maxSize: number): void {\n\t\tthis.maxSize = maxSize;\n\t\t// Trim pool if it exceeds new max size\n\t\tif (this.pool.length > maxSize) {\n\t\t\tthis.pool = this.pool.slice(0, maxSize);\n\t\t}\n\t}\n}\n","/**\n * Shallow equality comparison for objects and arrays\n */\n\n/**\n * Compare two values for shallow equality\n * For objects and arrays, only checks if top-level properties have the same references\n * For primitives, uses === comparison\n *\n * @param a First value\n * @param b Second value\n * @returns true if values are shallowly equal\n */\nexport function shallowEqual(a: unknown, b: unknown): boolean {\n\t// Same reference\n\tif (a === b) {\n\t\treturn true;\n\t}\n\n\t// Different types\n\tif (typeof a !== \"object\" || typeof b !== \"object\" || a === null || b === null) {\n\t\treturn false;\n\t}\n\n\tconst aObj = a as Record<string, unknown>;\n\tconst bObj = b as Record<string, unknown>;\n\n\t// Get keys\n\tconst aKeys = Object.keys(aObj);\n\tconst bKeys = Object.keys(bObj);\n\n\t// Different number of keys\n\tif (aKeys.length !== bKeys.length) {\n\t\treturn false;\n\t}\n\n\t// Check all keys have same reference values\n\tfor (const key of aKeys) {\n\t\tif (!(key in bObj) || aObj[key] !== bObj[key]) {\n\t\t\treturn false;\n\t\t}\n\t}\n\n\treturn true;\n}\n"],"mappings":";;;;AAYO,SAASA,UAAUC,OAAc;AAEvC,MAAI,OAAOC,oBAAoB,aAAa;AAC3C,WAAOA,gBAAgBD,KAAAA;EACxB;AAIA,MAAI;AACH,WAAOE,KAAKC,MAAMD,KAAKE,UAAUJ,KAAAA,CAAAA;EAClC,QAAQ;AAGP,WAAOA;EACR;AACD;AAfgBD;;;ACAT,IAAMM,aAAN,MAAMA;EAZb,OAYaA;;;EACJC,OAAY,CAAA;EACZC;EACAC;EACAC;;;;;;;;EASR,YAAYF,SAAkBC,OAAyBC,UAAkB,KAAK;AAC7E,SAAKF,UAAUA;AACf,SAAKC,QAAQA;AACb,SAAKC,UAAUA;EAChB;;;;;;;;EASAC,UAAa;AACZ,QAAI,KAAKJ,KAAKK,SAAS,GAAG;AACzB,aAAO,KAAKL,KAAKM,IAAG;IACrB;AACA,WAAO,KAAKL,QAAO;EACpB;;;;;;;;;EAUAM,QAAQC,KAAc;AACrB,QAAI,KAAKR,KAAKK,UAAU,KAAKF,SAAS;AAErC;IACD;AAEA,SAAKD,MAAMM,GAAAA;AACX,SAAKR,KAAKS,KAAKD,GAAAA;EAChB;;;;EAKAE,QAAc;AACb,SAAKV,OAAO,CAAA;EACb;;;;;;EAOAW,OAAe;AACd,WAAO,KAAKX,KAAKK;EAClB;;;;;;EAOAO,aAAqB;AACpB,WAAO,KAAKT;EACb;;;;;;EAOAU,WAAWV,SAAuB;AACjC,SAAKA,UAAUA;AAEf,QAAI,KAAKH,KAAKK,SAASF,SAAS;AAC/B,WAAKH,OAAO,KAAKA,KAAKc,MAAM,GAAGX,OAAAA;IAChC;EACD;AACD;;;ACvFO,SAASY,aAAaC,GAAYC,GAAU;AAElD,MAAID,MAAMC,GAAG;AACZ,WAAO;EACR;AAGA,MAAI,OAAOD,MAAM,YAAY,OAAOC,MAAM,YAAYD,MAAM,QAAQC,MAAM,MAAM;AAC/E,WAAO;EACR;AAEA,QAAMC,OAAOF;AACb,QAAMG,OAAOF;AAGb,QAAMG,QAAQC,OAAOC,KAAKJ,IAAAA;AAC1B,QAAMK,QAAQF,OAAOC,KAAKH,IAAAA;AAG1B,MAAIC,MAAMI,WAAWD,MAAMC,QAAQ;AAClC,WAAO;EACR;AAGA,aAAWC,OAAOL,OAAO;AACxB,QAAI,EAAEK,OAAON,SAASD,KAAKO,GAAAA,MAASN,KAAKM,GAAAA,GAAM;AAC9C,aAAO;IACR;EACD;AAEA,SAAO;AACR;AA/BgBV;","names":["deepClone","value","structuredClone","JSON","parse","stringify","ObjectPool","pool","factory","reset","maxSize","acquire","length","pop","release","obj","push","clear","size","getMaxSize","setMaxSize","slice","shallowEqual","a","b","aObj","bObj","aKeys","Object","keys","bKeys","length","key"]}

package/dist/utils/object-pool.d.mts

@@ -0,0 +1,66 @@
+/**
+ * Object Pool utility for game entities
+ *
+ * Provides object pooling to reduce GC pressure and improve performance
+ * for frequently created/destroyed game objects.
+ */
+/**
+ * Object pool for reusing objects
+ *
+ * @template T - Type of objects in the pool
+ */
+declare class ObjectPool<T> {
+    private pool;
+    private factory;
+    private reset;
+    private maxSize;
+    /**
+     * Create a new object pool
+     *
+     * @param factory - Function to create new objects
+     * @param reset - Function to reset object state for reuse
+     * @param maxSize - Maximum pool size (default: 100)
+     */
+    constructor(factory: () => T, reset: (obj: T) => void, maxSize?: number);
+    /**
+     * Acquire an object from the pool
+     *
+     * Returns a new object if pool is empty, otherwise reuses a pooled object.
+     *
+     * @returns Object from pool or newly created
+     */
+    acquire(): T;
+    /**
+     * Release an object back to the pool
+     *
+     * Resets the object and adds it back to the pool for reuse.
+     * If pool is at max size, the object is discarded.
+     *
+     * @param obj - Object to release
+     */
+    release(obj: T): void;
+    /**
+     * Clear all objects from the pool
+     */
+    clear(): void;
+    /**
+     * Get current pool size
+     *
+     * @returns Number of objects in pool
+     */
+    size(): number;
+    /**
+     * Get maximum pool size
+     *
+     * @returns Maximum pool size
+     */
+    getMaxSize(): number;
+    /**
+     * Set maximum pool size
+     *
+     * @param maxSize - New maximum pool size
+     */
+    setMaxSize(maxSize: number): void;
+}
+
+export { ObjectPool };

package/dist/utils/object-pool.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Object Pool utility for game entities
+ *
+ * Provides object pooling to reduce GC pressure and improve performance
+ * for frequently created/destroyed game objects.
+ */
+/**
+ * Object pool for reusing objects
+ *
+ * @template T - Type of objects in the pool
+ */
+declare class ObjectPool<T> {
+    private pool;
+    private factory;
+    private reset;
+    private maxSize;
+    /**
+     * Create a new object pool
+     *
+     * @param factory - Function to create new objects
+     * @param reset - Function to reset object state for reuse
+     * @param maxSize - Maximum pool size (default: 100)
+     */
+    constructor(factory: () => T, reset: (obj: T) => void, maxSize?: number);
+    /**
+     * Acquire an object from the pool
+     *
+     * Returns a new object if pool is empty, otherwise reuses a pooled object.
+     *
+     * @returns Object from pool or newly created
+     */
+    acquire(): T;
+    /**
+     * Release an object back to the pool
+     *
+     * Resets the object and adds it back to the pool for reuse.
+     * If pool is at max size, the object is discarded.
+     *
+     * @param obj - Object to release
+     */
+    release(obj: T): void;
+    /**
+     * Clear all objects from the pool
+     */
+    clear(): void;
+    /**
+     * Get current pool size
+     *
+     * @returns Number of objects in pool
+     */
+    size(): number;
+    /**
+     * Get maximum pool size
+     *
+     * @returns Maximum pool size
+     */
+    getMaxSize(): number;
+    /**
+     * Set maximum pool size
+     *
+     * @param maxSize - New maximum pool size
+     */
+    setMaxSize(maxSize: number): void;
+}
+
+export { ObjectPool };