@axi-engine/utils 0.1.7 → 0.1.8

package/dist/index.js

@@ -1,285 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-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/index.ts
-var index_exports = {};
-__export(index_exports, {
-  ConstructorRegistry: () => ConstructorRegistry,
-  Emitter: () => Emitter,
-  areArraysEqual: () => areArraysEqual,
-  axiSettings: () => axiSettings,
-  clampNumber: () => clampNumber,
-  configure: () => configure,
-  ensurePathArray: () => ensurePathArray,
-  ensurePathString: () => ensurePathString,
-  firstKeyOf: () => firstKeyOf,
-  genArray: () => genArray,
-  getPercentOf: () => getPercentOf,
-  getRandomElement: () => getRandomElement,
-  haveSameElements: () => haveSameElements,
-  isBoolean: () => isBoolean,
-  isNullOrUndefined: () => isNullOrUndefined,
-  isNumber: () => isNumber,
-  isPercentageString: () => isPercentageString,
-  isSequentialStart: () => isSequentialStart,
-  isString: () => isString,
-  isUndefined: () => isUndefined,
-  last: () => last,
-  randId: () => randId,
-  randInt: () => randInt,
-  shuffleArray: () => shuffleArray,
-  throwIf: () => throwIf,
-  throwIfEmpty: () => throwIfEmpty,
-  unique: () => unique
-});
-module.exports = __toCommonJS(index_exports);
-
-// src/arrays.ts
-function genArray(length) {
-  return Array.from({ length }, (_v, i) => i);
-}
-function shuffleArray(array) {
-  const result = [...array];
-  for (let i = result.length - 1; i > 0; i--) {
-    const j = Math.floor(Math.random() * (i + 1));
-    [result[i], result[j]] = [result[j], result[i]];
-  }
-  return result;
-}
-function isSequentialStart(arr1, arr2) {
-  if (arr1.length > arr2.length) {
-    return false;
-  }
-  return arr1.every((element, index) => element === arr2[index]);
-}
-function haveSameElements(arr1, arr2) {
-  if (!arr1 && !arr2) return true;
-  if (!arr1 || !arr2) return false;
-  if (arr1.length !== arr2.length) return false;
-  const sortedArr1 = [...arr1].sort();
-  const sortedArr2 = [...arr2].sort();
-  return sortedArr1.every((value, index) => value === sortedArr2[index]);
-}
-function areArraysEqual(arr1, arr2) {
-  if (!arr1 && !arr2) return true;
-  if (!arr1 || !arr2) return false;
-  if (arr1.length !== arr2.length) return false;
-  return arr1.every((value, index) => value === arr2[index]);
-}
-function last(array) {
-  return array[array.length - 1];
-}
-function unique(array) {
-  return [...new Set(array)];
-}
-function getRandomElement(array) {
-  if (array.length === 0) {
-    return void 0;
-  }
-  const index = Math.floor(Math.random() * array.length);
-  return array[index];
-}
-
-// src/guards.ts
-function isNullOrUndefined(val) {
-  return val === void 0 || val === null;
-}
-function isUndefined(val) {
-  return typeof val === "undefined";
-}
-function isNumber(val) {
-  return typeof val === "number";
-}
-function isBoolean(val) {
-  return typeof val === "boolean";
-}
-function isString(val) {
-  return typeof val === "string";
-}
-function isPercentageString(val) {
-  return typeof val === "string" && val.endsWith("%");
-}
-
-// src/assertion.ts
-function throwIf(conditionForThrow, exceptionMessage) {
-  if (conditionForThrow) {
-    throw new Error(exceptionMessage);
-  }
-}
-function throwIfEmpty(value, exceptionMessage) {
-  const isArrayAndEmpty = Array.isArray(value) && value.length === 0;
-  if (isNullOrUndefined(value) || isArrayAndEmpty) {
-    throw new Error(exceptionMessage);
-  }
-}
-
-// src/config.ts
-var defaultConfig = {
-  pathSeparator: "/"
-};
-var axiSettings = { ...defaultConfig };
-function configure(newConfig) {
-  Object.assign(axiSettings, newConfig);
-}
-
-// src/constructor-registry.ts
-var ConstructorRegistry = class {
-  items = /* @__PURE__ */ new Map();
-  /**
-   * Registers a constructor with a unique string identifier.
-   *
-   * @param typeId - The unique identifier for the constructor (e.g., a static `typeName` property from a class).
-   * @param ctor - The class constructor to register.
-   * @returns The registry instance for chainable calls.
-   * @throws If a constructor with the same `typeId` is already registered.
-   */
-  register(typeId, ctor) {
-    throwIf(this.items.has(typeId), `A constructor with typeId '${typeId}' is already registered.`);
-    this.items.set(typeId, ctor);
-    return this;
-  }
-  /**
-   * Retrieves a constructor by its identifier.
-   *
-   * @param typeId - The identifier of the constructor to retrieve.
-   * @returns The found class constructor.
-   * @throws If no constructor is found for the given `typeId`.
-   */
-  get(typeId) {
-    const Ctor = this.items.get(typeId);
-    throwIfEmpty(Ctor, `No constructor found for typeId '${typeId}'`);
-    return Ctor;
-  }
-  /**
-   * Checks if a constructor for a given identifier is registered.
-   * @param typeId - The identifier to check.
-   * @returns `true` if a constructor is registered, otherwise `false`.
-   */
-  has(typeId) {
-    return this.items.has(typeId);
-  }
-  /**
-   * Clears all registered constructors from the registry.
-   */
-  clear() {
-    this.items.clear();
-  }
-};
-
-// src/emitter.ts
-var Emitter = class {
-  listeners = /* @__PURE__ */ new Set();
-  /**
-   * Returns the number of listeners.
-   */
-  get listenerCount() {
-    return this.listeners.size;
-  }
-  /**
-   * Subscribes a listener to this event.
-   * @returns A function to unsubscribe the listener.
-   */
-  subscribe(listener) {
-    this.listeners.add(listener);
-    return () => this.listeners.delete(listener);
-  }
-  /**
-   * Manually unsubscribe by listener
-   * @returns returns true if an listener has been removed, or false if the listener does not exist.
-   */
-  unsubscribe(listener) {
-    return this.listeners.delete(listener);
-  }
-  /**
-   * Dispatches the event to all subscribed listeners.
-   */
-  emit(...args) {
-    this.listeners.forEach((listener) => listener(...args));
-  }
-  /**
-   * Clears all listeners.
-   */
-  clear() {
-    this.listeners.clear();
-  }
-};
-
-// src/math.ts
-function clampNumber(val, min, max) {
-  if (!isNullOrUndefined(min)) val = Math.max(val, min);
-  if (!isNullOrUndefined(max)) val = Math.min(val, max);
-  return val;
-}
-function getPercentOf(val, percents) {
-  return percents / 100 * val;
-}
-
-// src/misc.ts
-function firstKeyOf(obj) {
-  return Object.keys(obj)[0];
-}
-
-// src/path.ts
-function ensurePathArray(path, separator = axiSettings.pathSeparator) {
-  return Array.isArray(path) ? [...path] : path.split(separator);
-}
-function ensurePathString(path, separator = axiSettings.pathSeparator) {
-  return !Array.isArray(path) ? path : path.join(separator);
-}
-
-// src/random.ts
-var import_uuid = require("uuid");
-function randInt(min, max) {
-  min = Math.ceil(min);
-  max = Math.floor(max);
-  return Math.floor(Math.random() * (max - min) + min);
-}
-function randId() {
-  return (0, import_uuid.v4)();
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  ConstructorRegistry,
-  Emitter,
-  areArraysEqual,
-  axiSettings,
-  clampNumber,
-  configure,
-  ensurePathArray,
-  ensurePathString,
-  firstKeyOf,
-  genArray,
-  getPercentOf,
-  getRandomElement,
-  haveSameElements,
-  isBoolean,
-  isNullOrUndefined,
-  isNumber,
-  isPercentageString,
-  isSequentialStart,
-  isString,
-  isUndefined,
-  last,
-  randId,
-  randInt,
-  shuffleArray,
-  throwIf,
-  throwIfEmpty,
-  unique
-});