tiny-essentials 1.28.19 → 1.29.0

package/dist/v1/libs/utils/TinyCloner.cjs

@@ -0,0 +1,466 @@
+'use strict';
+
+var objFilter = require('../../basics/objFilter.cjs');
+
+const registry = objFilter.getObjTypeRegistry();
+const order = objFilter.getObjTypeOrder();
+
+/**
+ * Represents a plugin used by the TinyCloner to identify and clone specific data types.
+ *
+ * @template {any} Value
+ * @typedef {Object} CloningPlugin
+ * @property {string} id - The function id.
+ * @property {(value: Value) => boolean} canHandle - A function that accepts an item and returns true if the plugin is responsible for that type.
+ * @property {(value: Value, isDeep: boolean, cloner: TinyCloner|typeof TinyCloner) => Value} clone - A function that accepts the item and the cloner instance, returning the cloned version.
+ */
+
+/**
+ * @typedef {Object} TinyClonerOptions
+ * @property {boolean} [isolationMode=false] - If true, the instance will be initialized with a copy of the default plugins and will ignore global defaults during the cloning process.
+ */
+
+/**
+ * A class that performs deep cloning using a plugin-based architecture with advanced management capabilities.
+ */
+class TinyCloner {
+  /** @type {boolean} */
+  #isolationMode = false;
+
+  /**
+   * Indicates whether the instance is operating in isolation mode.
+   *
+   * If `true`, the instance is initialized with a snapshot of the current default plugins
+   * and will strictly use only its own plugins during the cloning process, ignoring
+   * any future changes to the global defaults.
+   *
+   * If `false`, the instance will use its own plugins and will fall back to the
+   * global default plugins if no match is found in the instance.
+   *
+   * @returns {boolean} True if the instance is isolated, false if it uses global fallbacks.
+   */
+  get isolationMode() {
+    return this.#isolationMode;
+  }
+
+  /** @type {boolean} */
+  static #defaultIsDeep = true;
+
+  /**
+   * Gets the global default value for the isDeep parameter.
+   * @returns {boolean}
+   */
+  static get defaultIsDeep() {
+    return TinyCloner.#defaultIsDeep;
+  }
+
+  /**
+   * Sets the global default value for the isDeep parameter.
+   * @param {boolean} value - The new default value.
+   * @throws {TypeError} If the value is not a boolean.
+   */
+  static set defaultIsDeep(value) {
+    if (typeof value !== 'boolean') {
+      throw new TypeError('The defaultIsDeep property must be a boolean.');
+    }
+    TinyCloner.#defaultIsDeep = value;
+  }
+
+  /**
+   * Creates an instance of TinyCloner.
+   *
+   * @param {TinyClonerOptions} [options={ isolationMode: false }] - Configuration options for the cloner instance.
+   */
+  constructor(options = { isolationMode: false }) {
+    if (typeof options !== 'object' || options === null) {
+      throw new TypeError('Options must be a non-null object.');
+    }
+
+    if (
+      typeof options.isolationMode !== 'undefined' &&
+      typeof options.isolationMode !== 'boolean'
+    ) {
+      throw new TypeError('The property "isolationMode" must be a boolean.');
+    }
+
+    this.#isolationMode = !!options.isolationMode;
+
+    if (this.#isolationMode) {
+      // Initialize instance with a copy of default plugins
+      this.#plugins = TinyCloner.#defaultPlugins.map((p) => ({ ...p }));
+    }
+  }
+
+  /**
+   * Creates a default plugin specifically designed to handle plain JavaScript objects.
+   * @param {string} id - The function id.
+   * @returns {CloningPlugin<Object.<string, any>>} A plugin object configured for object cloning.
+   */
+  static _createObjectPlugin(id) {
+    if (typeof id !== 'string') throw new TypeError('Id must be a string.');
+    return {
+      id,
+      canHandle: (item) => item !== null && typeof item === 'object',
+      clone: (item, isDeep, cloner) => {
+        /** @type {Record<string, any>} */
+        const result = {};
+        for (const key in item) {
+          if (Object.prototype.hasOwnProperty.call(item, key)) {
+            result[key] = isDeep ? cloner.clone(item[key], isDeep) : item[key];
+          }
+        }
+        return result;
+      },
+    };
+  }
+
+  /**
+   * @type {CloningPlugin<any>[]}
+   */
+  static #defaultPlugins = [];
+
+  /**
+   * Validates that a plugin object adheres to the required CloningPlugin interface.
+   *
+   * @template {any} T
+   * @param {CloningPlugin<T>} plugin - The plugin object to validate.
+   * @throws {TypeError} If the plugin does not implement the required 'canHandle' and 'clone' methods.
+   */
+  static validatePlugin(plugin) {
+    if (typeof plugin?.canHandle !== 'function' || typeof plugin?.clone !== 'function') {
+      throw new TypeError(
+        'Each plugin must implement the required interface: canHandle(item) and clone(item, cloner).',
+      );
+    }
+    if (typeof plugin?.id !== 'string')
+      throw new TypeError(
+        'Each plugin must implement the required interface: the plugin id string.',
+      );
+  }
+
+  // --- Static Management (Global Defaults) ---
+
+  /**
+   * @returns {CloningPlugin<any>[]} A deep copy of the current default plugins array.
+   */
+  static get plugins() {
+    return TinyCloner.#defaultPlugins.map((plugin) => ({ ...plugin }));
+  }
+
+  /**
+   * @returns {number} The total number of default plugins registered.
+   */
+  static get size() {
+    return TinyCloner.#defaultPlugins.length;
+  }
+
+  /**
+   * @returns {string[]} An array containing the unique IDs of all default plugins.
+   */
+  static get ids() {
+    return TinyCloner.#defaultPlugins.map((p) => p.id);
+  }
+
+  /**
+   * @param {CloningPlugin<any>[]} newPlugins - An array of plugins to replace the current ones.
+   * @throws {TypeError} If the input is not an array or if plugins do not implement the required interface.
+   */
+  static set plugins(newPlugins) {
+    if (!Array.isArray(newPlugins)) {
+      throw new TypeError('The defaultPlugins property must be an array.');
+    }
+
+    // Deep validation of the plugin structure to ensure runtime safety
+    TinyCloner.#defaultPlugins = newPlugins.map((plugin) => {
+      TinyCloner.validatePlugin(plugin);
+      return { ...plugin };
+    });
+  }
+
+  /**
+   * Adds a new plugin to the default plugins registry at a specified position.
+   *
+   * @param {CloningPlugin<any>} plugin - The plugin to add.
+   * @param {'start' | 'end' | 'index'} [position='start'] - The position where the plugin should be inserted.
+   * @param {number} [index=0] - The specific index to use if position is set to 'index'.
+   * @throws {TypeError} If the plugin is invalid, the position is unrecognized, or index is not a valid integer.
+   */
+  static addPlugin(plugin, position = 'start', index = 0) {
+    TinyCloner.validatePlugin(plugin);
+    if (TinyCloner.hasPlugin(plugin.id))
+      throw new TypeError(
+        `A plugin with the ID "${plugin.id}" already exists in the global registry.`,
+      );
+    const pluginCopy = { ...plugin };
+
+    if (position === 'start') {
+      TinyCloner.#defaultPlugins.unshift(pluginCopy);
+    } else if (position === 'end') {
+      TinyCloner.#defaultPlugins.push(pluginCopy);
+    } else if (position === 'index') {
+      if (!Number.isInteger(index) || index < 0) {
+        throw new TypeError('When position is "index", the index must be a non-negative integer.');
+      }
+      TinyCloner.#defaultPlugins.splice(index, 0, pluginCopy);
+    } else {
+      throw new TypeError('Position must be "start", "end", or "index".');
+    }
+  }
+
+  /**
+   * Checks if a default plugin with the specified ID exists.
+   *
+   * @param {string} id - The ID of the plugin to search for.
+   * @returns {boolean} True if the plugin exists, false otherwise.
+   * @throws {TypeError} If the id is not a string.
+   */
+  static hasPlugin(id) {
+    if (typeof id !== 'string') throw new TypeError('The ID must be a string.');
+    return TinyCloner.#defaultPlugins.some((p) => p.id === id);
+  }
+
+  /**
+   * Removes a default plugin from the registry by its ID.
+   *
+   * @param {string} id - The ID of the plugin to remove.
+   * @returns {boolean} True if a plugin was removed, false if the plugin was not found.
+   * @throws {TypeError} If the id is not a string.
+   */
+  static removePlugin(id) {
+    if (typeof id !== 'string') throw new TypeError('The ID must be a string.');
+    const index = TinyCloner.#defaultPlugins.findIndex((p) => p.id === id);
+    if (index !== -1) {
+      TinyCloner.#defaultPlugins.splice(index, 1);
+      return true;
+    }
+    return false;
+  }
+
+  /**
+   * Removes default plugins that satisfy the provided predicate.
+   * @param {(plugin: CloningPlugin<any>) => boolean} predicate - A function that returns true for plugins to be removed.
+   */
+  static filterPlugins(predicate) {
+    if (typeof predicate !== 'function') throw new TypeError('Predicate must be a function.');
+    TinyCloner.#defaultPlugins = TinyCloner.#defaultPlugins.filter((p) => !predicate({ ...p }));
+  }
+
+  /**
+   * Updates a default plugin at a specific index.
+   * @param {number} index - The index of the plugin to update.
+   * @param {CloningPlugin<any>} plugin - The new plugin configuration.
+   * @throws {RangeError} If the index is out of bounds.
+   */
+  static updatePlugin(index, plugin) {
+    if (index < 0 || index >= TinyCloner.#defaultPlugins.length) {
+      throw new RangeError('Index out of bounds.');
+    }
+    TinyCloner.validatePlugin(plugin);
+    TinyCloner.#defaultPlugins[index] = { ...plugin };
+  }
+
+  /**
+   * Reorders the default plugins array.
+   * @param {((a: CloningPlugin<any>, b: CloningPlugin<any>) => number)} [compareFn] - The function to make the new order of plugins.
+   */
+  static reorderPlugins(compareFn) {
+    TinyCloner.#defaultPlugins = TinyCloner.#defaultPlugins.sort(
+      compareFn ? (a, b) => compareFn({ ...a }, { ...b }) : undefined,
+    );
+  }
+
+  // --- Instance Management ---
+
+  /**
+   * @type {CloningPlugin<any>[]}
+   */
+  #plugins = [];
+
+  /**
+   * @returns {number} The total number of plugins registered in this specific instance.
+   */
+  get size() {
+    return this.#plugins.length;
+  }
+
+  /**
+   * @returns {string[]} An array containing the unique IDs of all plugins in this instance.
+   */
+  get ids() {
+    return this.#plugins.map((p) => p.id);
+  }
+
+  /**
+   * @returns {CloningPlugin<any>[]} A deep copy of the instance's plugins.
+   */
+  get plugins() {
+    return this.#plugins.map((plugin) => ({ ...plugin }));
+  }
+
+  /**
+   * @param {CloningPlugin<any>[]} newPlugins - An array of plugins to replace the current ones.
+   * @throws {TypeError} If the input is not an array or if plugins do not implement the required interface.
+   */
+  set plugins(newPlugins) {
+    if (!Array.isArray(newPlugins)) {
+      throw new TypeError('The plugins property must be an array.');
+    }
+
+    // Deep validation of the plugin structure to ensure runtime safety
+    this.#plugins = newPlugins.map((plugin) => {
+      TinyCloner.validatePlugin(plugin);
+      return { ...plugin };
+    });
+  }
+
+  /**
+   * Adds a new plugin to the instance at a specified position.
+   *
+   * @param {CloningPlugin<any>} plugin - The plugin to add.
+   * @param {'start' | 'end' | 'index'} [position='start'] - The position where the plugin should be inserted.
+   * @param {number} [index=0] - The specific index to use if position is set to 'index'.
+   * @throws {TypeError} If the plugin is invalid, the position is unrecognized, or index is not a valid integer.
+   */
+  addPlugin(plugin, position = 'start', index = 0) {
+    TinyCloner.validatePlugin(plugin);
+    if (this.hasPlugin(plugin.id))
+      throw new TypeError(`A plugin with the ID "${plugin.id}" already exists in this instance.`);
+    const pluginCopy = { ...plugin };
+
+    if (position === 'start') {
+      this.#plugins.unshift(pluginCopy);
+    } else if (position === 'end') {
+      this.#plugins.push(pluginCopy);
+    } else if (position === 'index') {
+      if (!Number.isInteger(index) || index < 0) {
+        throw new TypeError('When position is "index", the index must be a non-negative integer.');
+      }
+      this.#plugins.splice(index, 0, pluginCopy);
+    } else {
+      throw new TypeError('Position must be "start", "end", or "index".');
+    }
+  }
+
+  /**
+   * Checks if a plugin with the specified ID exists in this instance.
+   *
+   * @param {string} id - The ID of the plugin to search for.
+   * @returns {boolean} True if the plugin exists, false otherwise.
+   * @throws {TypeError} If the id is not a string.
+   */
+  hasPlugin(id) {
+    if (typeof id !== 'string') throw new TypeError('The ID must be a string.');
+    return this.#plugins.some((p) => p.id === id);
+  }
+
+  /**
+   * Removes a plugin from this instance by its ID.
+   *
+   * @param {string} id - The ID of the plugin to remove.
+   * @returns {boolean} True if a plugin was removed, false if the plugin was not found.
+   * @throws {TypeError} If the id is not a string.
+   */
+  removePlugin(id) {
+    if (typeof id !== 'string') throw new TypeError('The ID must be a string.');
+    const index = this.#plugins.findIndex((p) => p.id === id);
+    if (index !== -1) {
+      this.#plugins.splice(index, 1);
+      return true;
+    }
+    return false;
+  }
+
+  /**
+   * Removes instance plugins that satisfy the provided predicate.
+   * @param {(plugin: CloningPlugin<any>) => boolean} predicate - A function that returns true for plugins to be removed.
+   */
+  filterPlugins(predicate) {
+    if (typeof predicate !== 'function') throw new TypeError('Predicate must be a function.');
+    this.#plugins = this.#plugins.filter((p) => !predicate({ ...p }));
+  }
+
+  /**
+   * Updates an instance plugin at a specific index.
+   * @param {number} index - The index of the plugin to update.
+   * @param {CloningPlugin<any>} plugin - The new plugin configuration.
+   * @throws {RangeError} If the index is out of bounds.
+   */
+  updatePlugin(index, plugin) {
+    if (index < 0 || index >= this.#plugins.length) {
+      throw new RangeError('Index out of bounds.');
+    }
+    TinyCloner.validatePlugin(plugin);
+    this.#plugins[index] = { ...plugin };
+  }
+
+  /**
+   * Reorders the instance's plugins array.
+   * @param {((a: CloningPlugin<any>, b: CloningPlugin<any>) => number)} [compareFn] - The function to make the new order of plugins.
+   */
+  reorderPlugins(compareFn) {
+    this.#plugins = this.#plugins.sort(
+      compareFn ? (a, b) => compareFn({ ...a }, { ...b }) : undefined,
+    );
+  }
+
+  /**
+   * Performs the cloning operation on the provided item.
+   *
+   * @template {any} Value
+   * @param {Value} item - The item to be cloned.
+   * @param {boolean} [isDeep=true] - Whether to perform a deep clone (true) or a shallow clone (false).
+   * @returns {Value} The cloned version of the input item.
+   */
+  static clone(item, isDeep = TinyCloner.#defaultIsDeep) {
+    for (const plugin of TinyCloner.#defaultPlugins) {
+      if (plugin.canHandle(item)) {
+        return plugin.clone(item, isDeep, TinyCloner);
+      }
+    }
+
+    // Fallback for primitives and null
+    return item;
+  }
+
+  /**
+   * Performs the cloning operation on the provided item.
+   *
+   * @template {any} Value
+   * @param {Value} item - The item to be cloned.
+   * @param {boolean} [isDeep=true] - Whether to perform a deep clone (true) or a shallow clone (false).
+   * @returns {Value} The cloned version of the input item.
+   */
+  clone(item, isDeep = TinyCloner.#defaultIsDeep) {
+    // 1. Check instance plugins first
+    for (const plugin of this.#plugins) {
+      if (plugin.canHandle(item)) {
+        return plugin.clone(item, isDeep, this);
+      }
+    }
+
+    // 2. If isolationMode is false, check global defaults
+    if (!this.#isolationMode) {
+      for (const plugin of TinyCloner.#defaultPlugins) {
+        if (plugin.canHandle(item)) {
+          return plugin.clone(item, isDeep, this);
+        }
+      }
+    }
+
+    // Fallback for primitives and null
+    return item;
+  }
+}
+
+// Initializing default plugins
+TinyCloner.plugins = order
+  .filter((typeName) => registry[typeName]) // Ensures that the type exists in the record
+  .map((typeName) => ({
+    id: typeName,
+    canHandle: registry[typeName].validator,
+    /** @type {(val: any, isDeep: boolean, cloner: TinyCloner|typeof TinyCloner) => any} */
+    // @ts-ignore
+    clone: registry[typeName].cloner,
+  }));
+
+module.exports = TinyCloner;

package/dist/v1/libs/utils/TinyCloner.d.mts

@@ -0,0 +1,221 @@
+export type CloningPlugin<Value extends any> = {
+    /**
+     * - The function id.
+     */
+    id: string;
+    /**
+     * - A function that accepts an item and returns true if the plugin is responsible for that type.
+     */
+    canHandle: (value: Value) => boolean;
+    /**
+     * - A function that accepts the item and the cloner instance, returning the cloned version.
+     */
+    clone: (value: Value, isDeep: boolean, cloner: TinyCloner | typeof TinyCloner) => Value;
+};
+export type TinyClonerOptions = {
+    /**
+     * - If true, the instance will be initialized with a copy of the default plugins and will ignore global defaults during the cloning process.
+     */
+    isolationMode?: boolean;
+};
+/**
+ * Represents a plugin used by the TinyCloner to identify and clone specific data types.
+ *
+ * @template {any} Value
+ * @typedef {Object} CloningPlugin
+ * @property {string} id - The function id.
+ * @property {(value: Value) => boolean} canHandle - A function that accepts an item and returns true if the plugin is responsible for that type.
+ * @property {(value: Value, isDeep: boolean, cloner: TinyCloner|typeof TinyCloner) => Value} clone - A function that accepts the item and the cloner instance, returning the cloned version.
+ */
+/**
+ * @typedef {Object} TinyClonerOptions
+ * @property {boolean} [isolationMode=false] - If true, the instance will be initialized with a copy of the default plugins and will ignore global defaults during the cloning process.
+ */
+/**
+ * A class that performs deep cloning using a plugin-based architecture with advanced management capabilities.
+ */
+declare class TinyCloner {
+    #private;
+    /**
+     * Indicates whether the instance is operating in isolation mode.
+     *
+     * If `true`, the instance is initialized with a snapshot of the current default plugins
+     * and will strictly use only its own plugins during the cloning process, ignoring
+     * any future changes to the global defaults.
+     *
+     * If `false`, the instance will use its own plugins and will fall back to the
+     * global default plugins if no match is found in the instance.
+     *
+     * @returns {boolean} True if the instance is isolated, false if it uses global fallbacks.
+     */
+    get isolationMode(): boolean;
+    /**
+     * Gets the global default value for the isDeep parameter.
+     * @returns {boolean}
+     */
+    static get defaultIsDeep(): boolean;
+    /**
+     * Sets the global default value for the isDeep parameter.
+     * @param {boolean} value - The new default value.
+     * @throws {TypeError} If the value is not a boolean.
+     */
+    static set defaultIsDeep(value: boolean);
+    /**
+     * Creates an instance of TinyCloner.
+     *
+     * @param {TinyClonerOptions} [options={ isolationMode: false }] - Configuration options for the cloner instance.
+     */
+    constructor(options?: TinyClonerOptions);
+    /**
+     * Creates a default plugin specifically designed to handle plain JavaScript objects.
+     * @param {string} id - The function id.
+     * @returns {CloningPlugin<Object.<string, any>>} A plugin object configured for object cloning.
+     */
+    static _createObjectPlugin(id: string): CloningPlugin<Record<string, any>>;
+    /**
+     * Validates that a plugin object adheres to the required CloningPlugin interface.
+     *
+     * @template {any} T
+     * @param {CloningPlugin<T>} plugin - The plugin object to validate.
+     * @throws {TypeError} If the plugin does not implement the required 'canHandle' and 'clone' methods.
+     */
+    static validatePlugin<T extends any>(plugin: CloningPlugin<T>): void;
+    /**
+     * @returns {CloningPlugin<any>[]} A deep copy of the current default plugins array.
+     */
+    static get plugins(): CloningPlugin<any>[];
+    /**
+     * @returns {number} The total number of default plugins registered.
+     */
+    static get size(): number;
+    /**
+     * @returns {string[]} An array containing the unique IDs of all default plugins.
+     */
+    static get ids(): string[];
+    /**
+     * @param {CloningPlugin<any>[]} newPlugins - An array of plugins to replace the current ones.
+     * @throws {TypeError} If the input is not an array or if plugins do not implement the required interface.
+     */
+    static set plugins(newPlugins: CloningPlugin<any>[]);
+    /**
+     * Adds a new plugin to the default plugins registry at a specified position.
+     *
+     * @param {CloningPlugin<any>} plugin - The plugin to add.
+     * @param {'start' | 'end' | 'index'} [position='start'] - The position where the plugin should be inserted.
+     * @param {number} [index=0] - The specific index to use if position is set to 'index'.
+     * @throws {TypeError} If the plugin is invalid, the position is unrecognized, or index is not a valid integer.
+     */
+    static addPlugin(plugin: CloningPlugin<any>, position?: 'start' | 'end' | 'index', index?: number): void;
+    /**
+     * Checks if a default plugin with the specified ID exists.
+     *
+     * @param {string} id - The ID of the plugin to search for.
+     * @returns {boolean} True if the plugin exists, false otherwise.
+     * @throws {TypeError} If the id is not a string.
+     */
+    static hasPlugin(id: string): boolean;
+    /**
+     * Removes a default plugin from the registry by its ID.
+     *
+     * @param {string} id - The ID of the plugin to remove.
+     * @returns {boolean} True if a plugin was removed, false if the plugin was not found.
+     * @throws {TypeError} If the id is not a string.
+     */
+    static removePlugin(id: string): boolean;
+    /**
+     * Removes default plugins that satisfy the provided predicate.
+     * @param {(plugin: CloningPlugin<any>) => boolean} predicate - A function that returns true for plugins to be removed.
+     */
+    static filterPlugins(predicate: (plugin: CloningPlugin<any>) => boolean): void;
+    /**
+     * Updates a default plugin at a specific index.
+     * @param {number} index - The index of the plugin to update.
+     * @param {CloningPlugin<any>} plugin - The new plugin configuration.
+     * @throws {RangeError} If the index is out of bounds.
+     */
+    static updatePlugin(index: number, plugin: CloningPlugin<any>): void;
+    /**
+     * Reorders the default plugins array.
+     * @param {((a: CloningPlugin<any>, b: CloningPlugin<any>) => number)} [compareFn] - The function to make the new order of plugins.
+     */
+    static reorderPlugins(compareFn?: ((a: CloningPlugin<any>, b: CloningPlugin<any>) => number)): void;
+    /**
+     * @returns {number} The total number of plugins registered in this specific instance.
+     */
+    get size(): number;
+    /**
+     * @returns {string[]} An array containing the unique IDs of all plugins in this instance.
+     */
+    get ids(): string[];
+    /**
+     * @returns {CloningPlugin<any>[]} A deep copy of the instance's plugins.
+     */
+    get plugins(): CloningPlugin<any>[];
+    /**
+     * @param {CloningPlugin<any>[]} newPlugins - An array of plugins to replace the current ones.
+     * @throws {TypeError} If the input is not an array or if plugins do not implement the required interface.
+     */
+    set plugins(newPlugins: CloningPlugin<any>[]);
+    /**
+     * Adds a new plugin to the instance at a specified position.
+     *
+     * @param {CloningPlugin<any>} plugin - The plugin to add.
+     * @param {'start' | 'end' | 'index'} [position='start'] - The position where the plugin should be inserted.
+     * @param {number} [index=0] - The specific index to use if position is set to 'index'.
+     * @throws {TypeError} If the plugin is invalid, the position is unrecognized, or index is not a valid integer.
+     */
+    addPlugin(plugin: CloningPlugin<any>, position?: 'start' | 'end' | 'index', index?: number): void;
+    /**
+     * Checks if a plugin with the specified ID exists in this instance.
+     *
+     * @param {string} id - The ID of the plugin to search for.
+     * @returns {boolean} True if the plugin exists, false otherwise.
+     * @throws {TypeError} If the id is not a string.
+     */
+    hasPlugin(id: string): boolean;
+    /**
+     * Removes a plugin from this instance by its ID.
+     *
+     * @param {string} id - The ID of the plugin to remove.
+     * @returns {boolean} True if a plugin was removed, false if the plugin was not found.
+     * @throws {TypeError} If the id is not a string.
+     */
+    removePlugin(id: string): boolean;
+    /**
+     * Removes instance plugins that satisfy the provided predicate.
+     * @param {(plugin: CloningPlugin<any>) => boolean} predicate - A function that returns true for plugins to be removed.
+     */
+    filterPlugins(predicate: (plugin: CloningPlugin<any>) => boolean): void;
+    /**
+     * Updates an instance plugin at a specific index.
+     * @param {number} index - The index of the plugin to update.
+     * @param {CloningPlugin<any>} plugin - The new plugin configuration.
+     * @throws {RangeError} If the index is out of bounds.
+     */
+    updatePlugin(index: number, plugin: CloningPlugin<any>): void;
+    /**
+     * Reorders the instance's plugins array.
+     * @param {((a: CloningPlugin<any>, b: CloningPlugin<any>) => number)} [compareFn] - The function to make the new order of plugins.
+     */
+    reorderPlugins(compareFn?: ((a: CloningPlugin<any>, b: CloningPlugin<any>) => number)): void;
+    /**
+     * Performs the cloning operation on the provided item.
+     *
+     * @template {any} Value
+     * @param {Value} item - The item to be cloned.
+     * @param {boolean} [isDeep=true] - Whether to perform a deep clone (true) or a shallow clone (false).
+     * @returns {Value} The cloned version of the input item.
+     */
+    static clone<Value extends any>(item: Value, isDeep?: boolean): Value;
+    /**
+     * Performs the cloning operation on the provided item.
+     *
+     * @template {any} Value
+     * @param {Value} item - The item to be cloned.
+     * @param {boolean} [isDeep=true] - Whether to perform a deep clone (true) or a shallow clone (false).
+     * @returns {Value} The cloned version of the input item.
+     */
+    clone<Value extends any>(item: Value, isDeep?: boolean): Value;
+}
+export default TinyCloner;
+//# sourceMappingURL=TinyCloner.d.mts.map

package/dist/v1/libs/utils/TinyCloner.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TinyCloner.d.mts","sourceRoot":"","sources":["../../../../src/v1/libs/utils/TinyCloner.mjs"],"names":[],"mappings":"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"}