tiny-essentials 1.28.14 → 1.28.16

package/dist/v1/libs/{TinyI18.mjs → text/TinyI18.mjs}

@@ -1,7 +1,7 @@
 import { readFile, writeFile } from 'fs/promises';
 import { existsSync } from 'fs';
 import { join as pathJoin } from 'path';
-import { createCheckDestroyed } from './utils.mjs';
+import { createCheckDestroyed } from '../utils/tools.mjs';
 const checkDestroy = createCheckDestroyed('TinyI18');
 /**
  * Supported operating modes for TinyI18.

package/dist/v1/libs/{TinyTextDiffer.cjs → text/TinyTextDiffer.cjs}

@@ -1,8 +1,8 @@
 'use strict';
 
-var utils = require('./utils.cjs');
+var tools = require('../utils/tools.cjs');
 
-const checkDestroy = utils.createCheckDestroyed('TinyTextDiffer');
+const checkDestroy = tools.createCheckDestroyed('TinyTextDiffer');
 
 /**
  * Represents the result of a single text segment comparison.

package/dist/v1/libs/text/TinyTextDiffer.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TinyTextDiffer.d.mts","sourceRoot":"","sources":["../../../../src/v1/libs/text/TinyTextDiffer.mjs"],"names":[],"mappings":"AAMG,YAAkB,UAAU,GAC5B;;;;IAAmB,KAAK,EAAb,MAAM,CACjB;;;;IAAuC,IAAI,EAAhC,QAAQ,GAAC,OAAO,GAAC,SAAS,CACvC;CAAA,CAAA;AALD;;;;;GAKG;AAEH;;;GAGG;AACH,cAAM,cAAc;;IAOlB,IAAI,SAAS,YAEZ;IAED;;;OAGG;IACH,IAAI,OAAO,IAFE,MAAM,EAAE,CAKpB;IAED;;;OAGG;IACH,IAAI,OAAO,CAAC,OAAO,EAFR,MAAM,EAEE,EAUlB;IAED;;;OAGG;IACH,IAAI,IAAI,IAFK,MAAM,CAKlB;IAED;;;OAGG;IACH,YAAY,OAAO,AAFhB,CAA8B,EAAtB,MAAM,EAEO,EAEvB;IAwBD;;;;OAIG;IACH,GAAG,CAAC,KAAK,EAHE,MAGF,GAFI,MAAM,CASlB;IAED;;;;OAIG;IACH,GAAG,CAAC,KAAK,EAHE,MAGF,GAFI,OAAO,CAMnB;IAED;;;;OAIG;IACH,GAAG,CAAC,IAAI,EAHG,MAGH,GAFK,IAAI,CAMhB;IAED;;;OAGG;IACH,MAAM,IAFO,MAAM,GAAG,SAAS,CAK9B;IAED;;;;;OAKG;IACH,KAAK,CAAC,KAAK,EAJA,MAIA,EAAE,IAAI,EAHN,MAGM,GAFJ,IAAI,CAOhB;IAED;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAHH,MAGG,GAFD,OAAO,CASnB;IAED;;;OAGG;IACH,KAAK,IAFQ,IAAI,CAKhB;IAED;;;;;OAKG;IACH,OAAO,CAAC,GAAG,OAAO,EAHJ,MAAM,EAGF,GAFL,CAAC,UAAU,EAAE,CAAC,EAAE,CAgC5B;IAED;;;;;;OAMG;YACH,YAAY;IA2DZ;;;OAGG;IACH,OAAO,IAFM,IAAI,CAMhB;CACF;eAEc,cAAc"}

package/dist/v1/libs/{TinyTextDiffer.mjs → text/TinyTextDiffer.mjs}

@@ -1,4 +1,4 @@
-import { createCheckDestroyed } from './utils.mjs';
+import { createCheckDestroyed } from '../utils/tools.mjs';
 const checkDestroy = createCheckDestroyed('TinyTextDiffer');
 /**
  * Represents the result of a single text segment comparison.

package/dist/v1/libs/text/TinyTextRangeEditor.d.mts.map

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

package/dist/v1/libs/text/TinyTextarea.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TinyTextarea.d.mts","sourceRoot":"","sources":["../../../../src/v1/libs/text/TinyTextarea.mjs"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AARA,YAAkB,WAAW,GAC7B;;;;IAAmB,UAAU,EAAlB,MAAM,CACjB;;;;IAAmB,MAAM,EAAd,MAAM,CACjB;;;;IAAmB,YAAY,EAApB,MAAM,CACjB;;;;IAAmB,SAAS,EAAjB,MAAM,CACjB;;;;IAAmB,UAAU,EAAlB,MAAM,CACjB;;;;IAAmB,OAAO,EAAf,MAAM,CACjB;;;;IAAmB,IAAI,EAAZ,MAAM,CACnB;CAAA,CAAA;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,cAAM,YAAY;;IAyHT,YAAY;IAlHnB;;;;OAIG;IACH,IAAI,SAAS,IAFA,OAAO,CAInB;IAsBD;;;OAGG;IACH,IAAI,UAAU,IAFD,MAAM,CAIlB;IAED;;;OAGG;IACH,IAAI,OAAO,IAFE,MAAM,CAIlB;IAED;;;OAGG;IACH,IAAI,WAAW,IAFF,MAAM,CAIlB;IAED;;;OAGG;IACH,IAAI,aAAa,IAFJ,MAAM,CAIlB;IAED;;;OAGG;IACH,IAAI,WAAW,IAFF,MAAM,CAIlB;IAED;;;OAGG;IACH,IAAI,QAAQ,IAFC,mBAAmB,CAI/B;IAED;;;;;;;;;;;OAWG;IACH,YAAY,QAAQ,EATT,mBASS,EAAE,OAAO,AAR1B,CAKA,EAJA;QAAyB,OAAO,AAAhC,CACA,EADQ,MAAM,CACd;QAAyB,WAAW,AAApC,CACA,EADQ,MAAM,CACd;QAA8C,QAAQ,AAAtD,CACA,EADQ,CAAC,IAAI,EAAE,WAAW,KAAK,IAAI,CACnC;QAA8C,OAAO,AAArD,CACA,EADQ,CAAC,IAAI,EAAE,WAAW,KAAK,IAAI,CACnC;KAG+B,EA4BjC;IA+DD;;;OAGG;IACH,OAAO,IAFM;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAO5C;IAED;;OAEG;IACH,OAAO,SAEN;IAED;;OAEG;IACH,OAAO,SAMN;CACF;eAEc,YAAY"}

package/dist/v1/libs/{TinyClassManager → tools/TinyClassManager}/TinyPluginInliner.cjs

@@ -6,7 +6,7 @@ var module$1 = require('module');
 
 var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
 // Enables resolving paths inside node_modules natively
-const require$1 = module$1.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('v1/libs/TinyClassManager/TinyPluginInliner.cjs', document.baseURI).href)));
+const require$1 = module$1.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('v1/libs/tools/TinyClassManager/TinyPluginInliner.cjs', document.baseURI).href)));
 
 /**
  * @typedef {Object} RootReplacement

package/dist/v1/libs/tools/TinyClassManager/TinyPluginInliner.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TinyPluginInliner.d.mts","sourceRoot":"","sources":["../../../../../src/v1/libs/tools/TinyClassManager/TinyPluginInliner.mjs"],"names":[],"mappings":"AAQG,YAAkB,eAAe,GACjC;;;;IAAmB,IAAI,EAAZ,MAAM,CACjB;;;;IAAmB,EAAE,EAAV,MAAM,CACnB;CAAA,CAAA;AAGE,YAAkB,aAAa,GAC/B;;;;IAAmB,UAAU,EAAlB,MAAM,CACjB;;;;IAAmB,MAAM,EAAd,MAAM,CACjB;;;;IAAmB,WAAW,EAAnB,MAAM,CACjB;;;;IAA6B,eAAe,AAA5C,CACF,EADa,eAAe,CAC5B;CAAA,CAAA;AAZD;;;;GAIG;AAEH;;;;;;GAMG;AAEH,cAAM,iBAAiB;IAOd,MAAM;IACN,SAAS;IACT,MAAM;IACN,OAAO;IACP,QAAQ;IAER,cAAc;IACd,eAAe;IAbtB;;;;OAIG;IACH,YAAY,MAAM,EAFP,aAEO,EASjB;IAED;;;;;;;;;;OAUG;YACH,qBAAqB;IA+DrB;;;;;;OAMG;YACH,gBAAgB;IAkBhB;;;;;;;OAOG;YACH,iBAAiB;IAoBjB;;;;OAIG;IACG,KAAK,IAFE,OAAO,CAAC,IAAI,CAAC,CA0FzB;CACF;eAEc,iBAAiB"}

package/dist/v1/libs/tools/TinyClassManager.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TinyClassManager.d.mts","sourceRoot":"","sources":["../../../../src/v1/libs/tools/TinyClassManager.mjs"],"names":[],"mappings":"AAAA,0DAA0D;AAAtD,YAAuC,YAAY,GAAzC,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAc;AAMpD,YAAkB,gBAAgB,CAHT,KAAK,SAAnB,YAAmB,EACL,SAAS,SAAvB,YAAuB,EACP,oBAAoB,SAApC,YAAY,EAAwB,IAE/C;;;;IAAmB,IAAI,EAAZ,MAAM,CACjB;;;;IAAsB,YAAY,AAAlC,CACA,EADW,MAAM,EAAE,CACnB;;;;IAAsE,KAAK,EAAhE,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,oBAAoB,KAAK,SAAS,CACtE;CAAA,CAAA;AARD;;;;;;;;GAQG;AAEH;;;;GAIG;AACH,cAAM,gBAAgB,CAHM,CAAC,SAAf,YAAe,EACC,IAAI,SAApB,CAAC,GAAC,YAAkB;;IAShC;;;OAGG;IACH,IAAI,cAAc,IAFL,MAAM,EAAE,CAKpB;IASD;;;OAGG;IACH,IAAI,oBAAoB,IAFX,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC,CAAC,CAK1B;IAED;;;OAGG;IACH,IAAI,IAAI,IAFK,MAAM,CAKlB;IAQD;;OAEG;IACH,IAAI,YAAY,MAGf;IAOD;;OAEG;IACH,IAAI,IAAI,YAEP;IAED;;;;OAIG;IACH,YACE,SAAS,EAJA,CAIA,EAET,UAAU,AALT,CAA+B,EAAvB,IAAI,EAKE,EAIhB;IAsCD;;;;;;;OAOG;IACH,GAAG,CALyB,CAAC,SAAf,YAAe,EAKzB,MAAM,EAJC,gBAAgB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC,CAAC,CAItC,GAHG,gBAAgB,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,CAiBzC;IAED;;;;;;;OAOG;IACH,MAAM,CALsB,CAAC,SAAf,YAAe,EAKtB,OAAO,EAJH,CAAC,SAAS,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC,CAAC,KAAK,CAIxC,GAHD,gBAAgB,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,CAoCzC;IAED;;;;OAIG;IACH,KAAK,IAHQ,CAAC,CAWb;CACF;eAEc,gBAAgB"}

package/dist/v1/libs/{TinyDebugger.cjs → tools/TinyDebugger.cjs}

@@ -1,8 +1,8 @@
 'use strict';
 
 var events = require('events');
-var objChecker = require('../basics/objChecker.cjs');
-var browserDetector = require('../basics/browserDetector.cjs');
+var objChecker = require('../../basics/objChecker.cjs');
+var browserDetector = require('../../basics/browserDetector.cjs');
 
 /**
  * A lightweight debugging utility that wraps console methods and provides event emission.

package/dist/v1/libs/tools/TinyDebugger.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TinyDebugger.d.mts","sourceRoot":"","sources":["../../../../src/v1/libs/tools/TinyDebugger.mjs"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAItC;;;GAGG;AACH,cAAM,YAAa,SAAQ,YAAY;;IAqDrC;;;;;;;;;OASG;IACH,YAAY,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,WAAmB,EAAE,YAAoB,EAAE,EAP7E;QAAiC,MAAM,EAA/B,OAAO,CAAC,OAAO,CAAC,CACxB;QAAuB,EAAE,EAAjB,MAAM,CACd;QAAwB,SAAS,EAAzB,OAAO,CACf;QAAyB,WAAW,AAApC,CACA,EADQ,OAAO,CACf;QAAyB,YAAY,AAArC,CACA,EADQ,OAAO,CACf;KAE6E,EA0B/E;IAED;;OAEG;IACH,IAAI,KAAK,IAFI,MAAM,CAIlB;IAED;;OAEG;IACH,IAAI,WAAW,IAFF,OAAO,CAInB;IAED;;OAEG;IACH,IAAI,YAAY,IAFH,OAAO,CAInB;IAED;;;OAGG;IACH,IAAI,YAAY,CAAC,KAAK,EAHX,OAGW,EAOrB;IAED;;OAEG;IACH,IAAI,SAAS,IAFA,OAAO,CAInB;IAED;;;OAGG;IACH,IAAI,SAAS,CAAC,KAAK,EAHR,OAGQ,EAOlB;IAED;;;;OAIG;IACH,YAAY,CAAC,EAAE,EAHJ,MAGI,EAAE,IAAI,EAFV,MAEU,QAEpB;IAED;;;OAGG;IACH,eAAe,CAAC,EAAE,EAFP,MAEO,QAEjB;IAED;;;;OAIG;IACH,aAAa,CAAC,EAAE,EAHL,MAGK,EAAE,IAAI,EAFX,MAEW,QAErB;IAED;;;OAGG;IACH,gBAAgB,CAAC,EAAE,EAFR,MAEQ,QAElB;IA0BD;;;OAGG;IACH,QAAQ,IAFK,IAAI,GAAC,SAAS,CAM1B;IAED;;;OAGG;IACH,WAAW,IAFE,IAAI,GAAC,SAAS,CAM1B;IAED;;;;;;OAMG;IACH,QAAQ,CAAC,OAAO,EALL,OAAO,GAAG,YAAY,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,YAAY,GAAG,WAKpE,EAAE,KAAK,AAJpB,CACA,EADQ,MAIY,GAFV,IAAI,CA8BhB;IAED;;;;;;OAMG;IACH,YAAY,CAAC,KAAK,EALP,MAKO,EAAE,GAAG,IAAI,EAJb,GAAG,EAIU,GAFd,IAAI,CAQhB;IAED;;;;;OAKG;IACH,SAAS,CAAC,SAAS,EAJR,OAIQ,EAAE,GAAG,IAAI,EAHd,GAAG,EAGW,GAFf,IAAI,CAQhB;IAED;;;;;OAKG;IACH,MAAM,CAAC,IAAI,EAJA,GAIA,EAAE,OAAO,AAHjB,CACA,EADQ,OAAO,MAAM,EAAE,cAGN,GAFP,IAAI,CAMhB;IAED;;;;;;OAMG;IACH,QAAQ,CAAC,WAAW,EALT,GAKS,EAAE,UAAU,AAJ7B,CACA,EADQ,MAAM,EAIe,GAFnB,IAAI,CAchB;IAED;;;;;;;OAOG;IACH,GAAG,CAAC,OAAO,EANA,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,gBAAgB,GAAG,OAMtF,EAAE,OAAO,EALT,MAKS,EAAE,GAAG,IAAI,EAJf,GAAG,EAIY,GAFhB,IAAI,CAsChB;CACF;eAEc,YAAY"}

package/dist/v1/libs/{TinyDebugger.mjs → tools/TinyDebugger.mjs}

@@ -1,6 +1,6 @@
 import { EventEmitter } from 'events';
-import { isValidObj } from '../basics/objChecker.mjs';
-import { browserIs } from '../basics/browserDetector.mjs';
+import { isValidObj } from '../../basics/objChecker.mjs';
+import { browserIs } from '../../basics/browserDetector.mjs';
 /**
  * A lightweight debugging utility that wraps console methods and provides event emission.
  * @extends EventEmitter

package/dist/v1/libs/tools/TinyPkgExportValidator.cjs

@@ -0,0 +1,462 @@
+'use strict';
+
+var promises = require('fs/promises');
+var path = require('path');
+
+/**
+ * @typedef {Object} ConsoleColors - The color configuration object.
+ * @property {string} RESET - The ANSI reset code.
+ * @property {string} GREEN - The ANSI green code.
+ * @property {string} RED - The ANSI red code.
+ * @property {string} YELLOW - The ANSI yellow code.
+ * @property {string} CYAN - The ANSI cyan code.
+ * @property {string} DIM - The ANSI dim code.
+ */
+
+/**
+ * @typedef {Object} ValidatorOptions - Configuration options for the validator.
+ * @property {string} [projectName] - Custom name for the project report.
+ * @property {boolean} [silent] - If true, no logs will be printed to the console.
+ * @property {DefaultMessages} [messages] - Custom message templates.
+ */
+
+/**
+ * @typedef {Object} DefaultMessages
+ * @property {string} header
+ * @property {string}  divider
+ * @property {string}  itemValid
+ * @property {string}  itemInvalid
+ * @property {string}  itemMissing
+ * @property {string}  successHeader
+ * @property {string}  failureHeader
+ * @property {string}  errorLoad
+ * @property {string}  noExports
+ * @property {string}  errorNotFound
+ * @property {string}  errorParse
+ * @property {string}  errorUnexpected
+ */
+
+/**
+ * Default messages used when no custom messages are provided.
+ * Placeholders like {projectName}, {path}, etc., are replaced at runtime.
+ * @type {DefaultMessages}
+ */
+const DEFAULT_MESSAGES = {
+  header: `\n=== {projectName} ===\n`,
+  divider: `\n-----------------------------------------`,
+  itemValid: `  [✔] {path}`,
+  itemInvalid: `  [✘] {path}`,
+  itemMissing: `      Missing: {errorPath}`,
+  successHeader: `SUCCESS: All exports are correctly mapped.`,
+  failureHeader: `FAILURE: {errorCount} export(s) are missing or invalid.`,
+  errorLoad: `Error: package.json not loaded in the current directory.`,
+  noExports: `[!] No "exports" field found in package.json.`,
+  errorNotFound: `Error: package.json not found in the current directory.`,
+  errorParse: `Error: Failed to parse package.json. Ensure it is valid JSON.`,
+  errorUnexpected: `An unexpected error occurred: {message}`,
+};
+
+/**
+ * Array of keys required by the DefaultMessages type.
+ * Used for deep validation of the messages object.
+ */
+const MESSAGE_KEYS = Object.keys(DEFAULT_MESSAGES);
+
+/**
+ * Class responsible for validating package exports.
+ * Implements state encapsulation, custom logging, and recursive search logic.
+ */
+class TinyPkgExportValidator {
+  /**
+   * Console color constants (ANSI escape codes).
+   * @type {ConsoleColors}
+   */
+  #COLORS = {
+    RESET: '\x1b[0m',
+    GREEN: '\x1b[32m',
+    RED: '\x1b[31m',
+    YELLOW: '\x1b[33m',
+    CYAN: '\x1b[36m',
+    DIM: '\x1b[2m',
+  };
+
+  get COLORS() {
+    return structuredClone(this.#COLORS);
+  }
+
+  /**
+   * Updates the color constants with a new configuration.
+   *
+   * @param {ConsoleColors} newColors - The new color configuration object.
+   * @throws {TypeError} If newColors is not an object, if keys do not match exactly, or if any value is not a string.
+   */
+  set COLORS(newColors) {
+    // 1. Validate that the input is a non-null object and not an array
+    if (typeof newColors !== 'object' || newColors === null || Array.isArray(newColors)) {
+      throw new TypeError('The provided configuration must be a non-null object.');
+    }
+
+    const originalKeys = Object.keys(this.#COLORS);
+    const newKeys = Object.keys(newColors);
+
+    // 2. Validate that the keys match exactly (same length and same names)
+    const hasSameKeys =
+      originalKeys.length === newKeys.length && originalKeys.every((key) => newKeys.includes(key));
+
+    if (!hasSameKeys) {
+      throw new TypeError(
+        'The new configuration must contain the exact same keys as the original color set.',
+      );
+    }
+
+    // 3. Validate that all values are strings
+    for (const key of originalKeys) {
+      // @ts-ignore
+      if (typeof newColors[key] !== 'string') {
+        throw new TypeError(`The value for key "${key}" must be a string.`);
+      }
+    }
+
+    // Apply the new configuration using a clone to prevent external mutation
+    this.#COLORS = structuredClone(newColors);
+  }
+
+  // --- Private State ---
+
+  /** @type {Record<string, any>} */
+  #packageData = {};
+
+  /** @type {string} */
+  #packageJsonPath;
+
+  /** @type {string} */
+  #rootDir;
+
+  /** @type {Array<{path: string, valid: boolean, errorPath?: string}>} */
+  #results;
+
+  /** @type {boolean} */
+  #started = false;
+
+  /** @type {string} */
+  #projectName;
+
+  /** @type {boolean} */
+  #silent;
+
+  /** @type {DefaultMessages} */
+  #messages;
+
+  // --- Getters ---
+
+  get packageData() {
+    return structuredClone(this.#packageData);
+  }
+  get packageJsonPath() {
+    return this.#packageJsonPath;
+  }
+  get rootDir() {
+    return this.#rootDir;
+  }
+  get results() {
+    return structuredClone(this.#results);
+  }
+  get started() {
+    return this.#started;
+  }
+  get projectName() {
+    return this.#projectName;
+  }
+  get silent() {
+    return this.#silent;
+  }
+
+  /**
+   * Creates an instance of TinyPkgExportValidator.
+   *
+   * @param {string} packageJsonPath - The package.json JSON file path.
+   * @param {string} rootDir - The project root directory.
+   * @param {ValidatorOptions} [options={}] - Configuration options.
+   * @throws {TypeError} If arguments are not strings or if options fails deep validation.
+   */
+  constructor(packageJsonPath, rootDir, options = {}) {
+    if (typeof packageJsonPath !== 'string') {
+      throw new TypeError('The "packageJsonPath" argument must be a string.');
+    }
+    if (typeof rootDir !== 'string') {
+      throw new TypeError('The "rootDir" argument must be a string.');
+    }
+
+    this.#validateOptions(options);
+
+    this.#packageJsonPath = packageJsonPath;
+    this.#rootDir = rootDir;
+    this.#results = [];
+
+    // Configuration assignment
+    this.#projectName = options.projectName ?? 'Tiny-Essentials Export Validation';
+    this.#silent = !!options.silent;
+    this.#messages = { ...DEFAULT_MESSAGES, ...(options.messages ?? {}) };
+  }
+
+  /**
+   * Performs a deep validation of the options object against the ValidatorOptions JSDoc.
+   *
+   * @param {ValidatorOptions} options - The options to validate.
+   * @throws {TypeError} If any property does not match the expected type or structure.
+   */
+  #validateOptions(options) {
+    if (typeof options !== 'object' || options === null || Array.isArray(options)) {
+      throw new TypeError('The "options" argument must be a non-null object.');
+    }
+
+    // Validate projectName
+    if (options.projectName !== undefined && typeof options.projectName !== 'string') {
+      throw new TypeError('The "options.projectName" property must be a string.');
+    }
+
+    // Validate silent
+    if (options.silent !== undefined && typeof options.silent !== 'boolean') {
+      throw new TypeError('The "options.silent" property must be a boolean.');
+    }
+
+    // Validate messages (Deep Validation)
+    if (options.messages !== undefined) {
+      if (
+        typeof options.messages !== 'object' ||
+        options.messages === null ||
+        Array.isArray(options.messages)
+      ) {
+        throw new TypeError('The "options.messages" property must be a non-null object.');
+      }
+
+      // Ensure all required keys from DefaultMessages are present and are strings
+      for (const key of MESSAGE_KEYS) {
+        // @ts-ignore
+        if (typeof options.messages[key] !== 'string') {
+          throw new TypeError(`The "options.messages.${key}" property must be a string.`);
+        }
+      }
+    }
+  }
+
+  /**
+   * Internal helper to apply template replacements.
+   * @param {string} template - The message template string.
+   * @param {Object} context - Data for placeholders.
+   * @returns {string} The processed string.
+   * @throws {TypeError} If template is not a string or context is not an object.
+   */
+  #applyTemplate(template, context) {
+    if (typeof template !== 'string') {
+      throw new TypeError('The template must be a string.');
+    }
+    if (typeof context !== 'object' || context === null) {
+      throw new TypeError('The context must be a non-null object.');
+    }
+
+    return template.replace(/{(\w+)}/g, (match, key) => {
+      // @ts-ignore
+      return context[key] !== undefined ? context[key] : match;
+    });
+  }
+
+  /**
+   * Internal helper to handle console output, coloring, and silent mode.
+   * @param {'error'|'warning'|'success'|'info'|'dim'|'cyan'} type - The log type.
+   * @param {string} templateKey - The key in the messages object.
+   * @param {Object} [context={}] - Data for the template.
+   * @throws {TypeError} If arguments do not match required types or if type is invalid.
+   */
+  #log(type, templateKey, context = {}) {
+    if (this.#silent) return;
+
+    const VALID_LOG_TYPES = ['error', 'warning', 'success', 'info', 'dim', 'cyan'];
+
+    if (!VALID_LOG_TYPES.includes(type)) {
+      throw new TypeError(
+        `Invalid log type: "${type}". Valid types are: ${VALID_LOG_TYPES.join(', ')}`,
+      );
+    }
+    if (typeof templateKey !== 'string') {
+      throw new TypeError('The templateKey must be a string.');
+    }
+    if (typeof context !== 'object' || context === null) {
+      throw new TypeError('The context must be a non-null object.');
+    }
+
+    const template =
+      // @ts-ignore
+      this.#messages[templateKey] || templateKey;
+    const message = this.#applyTemplate(template, { ...context, projectName: this.#projectName });
+
+    switch (type) {
+      case 'error':
+        console.error(`${this.#COLORS.RED}${message}${this.#COLORS.RESET}`);
+        break;
+      case 'warning':
+        console.log(`${this.#COLORS.YELLOW}${message}${this.#COLORS.RESET}`);
+        break;
+      case 'success':
+        console.log(`${this.#COLORS.GREEN}${message}${this.#COLORS.RESET}`);
+        break;
+      case 'cyan':
+        console.log(`${this.#COLORS.CYAN}${message}${this.#COLORS.RESET}`);
+        break;
+      case 'dim':
+        console.log(`${this.#COLORS.DIM}${message}${this.#COLORS.RESET}`);
+        break;
+      default:
+        console.log(message);
+    }
+  }
+
+  /**
+   * Loads and parses the package.json file from the specified path.
+   *
+   * @returns {Promise<void>} A promise that resolves when the package data is loaded.
+   * @throws {TypeError} If the parsed JSON content is not a non-null object.
+   * @throws {Error} If the file cannot be read or parsed.
+   */
+  async start() {
+    if (this.#started) return;
+    this.#started = true;
+
+    try {
+      const packageRaw = await promises.readFile(this.#packageJsonPath, 'utf-8');
+      const packageData = JSON.parse(packageRaw);
+      if (typeof packageData !== 'object' || packageData === null) {
+        this.#started = false;
+        throw new TypeError('The "packageData" argument must be a non-null object.');
+      }
+      this.#packageData = packageData;
+    } catch (error) {
+      this.#started = false;
+      throw error;
+    }
+  }
+
+  /**
+   * Executes the validation process.
+   * @returns {Promise<boolean>} Returns true if all paths are valid, false otherwise.
+   */
+  async validate() {
+    if (!this.#started) {
+      this.#log('error', 'errorLoad');
+      return true;
+    }
+
+    const exports = this.#packageData.exports;
+
+    if (!exports) {
+      this.#log('warning', 'noExports');
+      return true;
+    }
+
+    this.#results = [];
+    try {
+      await this.#traverseExports(exports);
+    } catch (error) {
+      if (error instanceof Error) {
+        if (error instanceof SyntaxError) {
+          this.#log('error', 'errorParse');
+        } else if ('code' in error && error.code === 'ENOENT') {
+          this.#log('error', 'errorNotFound');
+        } else {
+          this.#log('error', 'errorUnexpected', { message: error.message });
+        }
+      }
+      throw error;
+    }
+    return this.#report();
+  }
+
+  /**
+   * Recursively traverses the exports object.
+   *
+   * @param {Record<string, any>|string} node - The current node of the exports object.
+   * @param {string} currentKey - The key (used for log tracking).
+   * @returns {Promise<void>}
+   * @throws {TypeError} If node is not a string or object, or if currentKey is not a string.
+   */
+  async #traverseExports(node, currentKey = '') {
+    if (typeof currentKey !== 'string') {
+      throw new TypeError('The "currentKey" argument must be a string.');
+    }
+
+    if (typeof node === 'string') {
+      // Base case: the value is a direct path
+      await this.#checkFileExists(node, currentKey);
+    } else if (typeof node === 'object' && node !== null) {
+      // Recursive case: the value is an object (e.g., { import: '...', require: '...' })
+      const keys = Object.keys(node);
+      for (const key of keys) {
+        const subKey = currentKey ? `${currentKey} -> ${key}` : key;
+        await this.#traverseExports(node[key], subKey);
+      }
+    } else {
+      throw new TypeError('The "node" argument must be a string or a non-null object.');
+    }
+  }
+
+  /**
+   * Checks for the existence of a file in the file system.
+   *
+   * @param {string} relativePath - The relative path defined in package.json.
+   * @param {string} context - The key context for reporting purposes.
+   * @returns {Promise<void>}
+   * @throws {TypeError} If relativePath or context are not strings.
+   */
+  async #checkFileExists(relativePath, context) {
+    if (typeof relativePath !== 'string') {
+      throw new TypeError('The "relativePath" argument must be a string.');
+    }
+    if (typeof context !== 'string') {
+      throw new TypeError('The "context" argument must be a string.');
+    }
+
+    // Remove potential wildcards (e.g., '*') for literal path validation
+    const cleanPath = relativePath.replace(/\*/g, '');
+    const absolutePath = path.resolve(this.#rootDir, cleanPath);
+
+    try {
+      await promises.access(absolutePath);
+      this.#results.push({ path: context, valid: true });
+    } catch {
+      this.#results.push({ path: context, valid: false, errorPath: relativePath });
+    }
+  }
+
+  /**
+   * Generates the final report in the console.
+   *
+   * @returns {boolean} True if there are no errors, false if there are failures.
+   */
+  #report() {
+    this.#log('cyan', 'header');
+
+    let errorCount = 0;
+
+    for (const result of this.#results) {
+      if (result.valid) {
+        this.#log('success', 'itemValid', { path: result.path });
+      } else {
+        this.#log('error', 'itemInvalid', { path: result.path });
+        this.#log('dim', 'itemMissing', { errorPath: result.errorPath });
+        errorCount++;
+      }
+    }
+
+    this.#log('cyan', 'divider');
+
+    if (errorCount === 0) {
+      this.#log('success', 'successHeader');
+      return true;
+    } else {
+      this.#log('error', 'failureHeader', { errorCount });
+      return false;
+    }
+  }
+}
+
+module.exports = TinyPkgExportValidator;

package/dist/v1/libs/tools/TinyPkgExportValidator.d.mts

@@ -0,0 +1,104 @@
+export type ConsoleColors = {
+    /**
+     * - The ANSI reset code.
+     */
+    RESET: string;
+    /**
+     * - The ANSI green code.
+     */
+    GREEN: string;
+    /**
+     * - The ANSI red code.
+     */
+    RED: string;
+    /**
+     * - The ANSI yellow code.
+     */
+    YELLOW: string;
+    /**
+     * - The ANSI cyan code.
+     */
+    CYAN: string;
+    /**
+     * - The ANSI dim code.
+     */
+    DIM: string;
+};
+export type ValidatorOptions = {
+    /**
+     * - Custom name for the project report.
+     */
+    projectName?: string;
+    /**
+     * - If true, no logs will be printed to the console.
+     */
+    silent?: boolean;
+    /**
+     * - Custom message templates.
+     */
+    messages?: DefaultMessages;
+};
+export type DefaultMessages = {
+    header: string;
+    divider: string;
+    itemValid: string;
+    itemInvalid: string;
+    itemMissing: string;
+    successHeader: string;
+    failureHeader: string;
+    errorLoad: string;
+    noExports: string;
+    errorNotFound: string;
+    errorParse: string;
+    errorUnexpected: string;
+};
+/**
+ * Class responsible for validating package exports.
+ * Implements state encapsulation, custom logging, and recursive search logic.
+ */
+declare class TinyPkgExportValidator {
+    #private;
+    get COLORS(): ConsoleColors;
+    /**
+     * Updates the color constants with a new configuration.
+     *
+     * @param {ConsoleColors} newColors - The new color configuration object.
+     * @throws {TypeError} If newColors is not an object, if keys do not match exactly, or if any value is not a string.
+     */
+    set COLORS(newColors: ConsoleColors);
+    get packageData(): Record<string, any>;
+    get packageJsonPath(): string;
+    get rootDir(): string;
+    get results(): {
+        path: string;
+        valid: boolean;
+        errorPath?: string;
+    }[];
+    get started(): boolean;
+    get projectName(): string;
+    get silent(): boolean;
+    /**
+     * Creates an instance of TinyPkgExportValidator.
+     *
+     * @param {string} packageJsonPath - The package.json JSON file path.
+     * @param {string} rootDir - The project root directory.
+     * @param {ValidatorOptions} [options={}] - Configuration options.
+     * @throws {TypeError} If arguments are not strings or if options fails deep validation.
+     */
+    constructor(packageJsonPath: string, rootDir: string, options?: ValidatorOptions);
+    /**
+     * Loads and parses the package.json file from the specified path.
+     *
+     * @returns {Promise<void>} A promise that resolves when the package data is loaded.
+     * @throws {TypeError} If the parsed JSON content is not a non-null object.
+     * @throws {Error} If the file cannot be read or parsed.
+     */
+    start(): Promise<void>;
+    /**
+     * Executes the validation process.
+     * @returns {Promise<boolean>} Returns true if all paths are valid, false otherwise.
+     */
+    validate(): Promise<boolean>;
+}
+export default TinyPkgExportValidator;
+//# sourceMappingURL=TinyPkgExportValidator.d.mts.map

package/dist/v1/libs/tools/TinyPkgExportValidator.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TinyPkgExportValidator.d.mts","sourceRoot":"","sources":["../../../../src/v1/libs/tools/TinyPkgExportValidator.mjs"],"names":[],"mappings":"AAIG,YAAkB,aAAa,GAC/B;;;;IAAmB,KAAK,EAAb,MAAM,CACjB;;;;IAAmB,KAAK,EAAb,MAAM,CACjB;;;;IAAmB,GAAG,EAAX,MAAM,CACjB;;;;IAAmB,MAAM,EAAd,MAAM,CACjB;;;;IAAmB,IAAI,EAAZ,MAAM,CACjB;;;;IAAmB,GAAG,EAAX,MAAM,CACnB;CAAA,CAAA;AAGE,YAAkB,gBAAgB,GAClC;;;;IAAoB,WAAW,AAA/B,CACA,EADW,MAAM,CACjB;;;;IAAqB,MAAM,AAA3B,CACA,EADW,OAAO,CAClB;;;;IAA6B,QAAQ,AAArC,CACF,EADa,eAAe,CAC5B;CAAA,CAAA;AAGE,YAAkB,eAAe,GACjC;IAAmB,MAAM,EAAd,MAAM,CACjB;IAAoB,OAAO,EAAhB,MAAM,CACjB;IAAoB,SAAS,EAAlB,MAAM,CACjB;IAAoB,WAAW,EAApB,MAAM,CACjB;IAAoB,WAAW,EAApB,MAAM,CACjB;IAAoB,aAAa,EAAtB,MAAM,CACjB;IAAoB,aAAa,EAAtB,MAAM,CACjB;IAAoB,SAAS,EAAlB,MAAM,CACjB;IAAoB,SAAS,EAAlB,MAAM,CACjB;IAAoB,aAAa,EAAtB,MAAM,CACjB;IAAoB,UAAU,EAAnB,MAAM,CACjB;IAAoB,eAAe,EAAxB,MAAM,CACnB;CAAA,CAAA;AA4BD;;;GAGG;AACH,cAAM,sBAAsB;;IAc1B,IAAI,MAAM,IAOC,aAAa,CALvB;IAED;;;;;OAKG;IACH,IAAI,MAAM,CAAC,SAAS,EAHT,aAGS,EA6BnB;IA8BD,IAAI,WAAW,wBAEd;IACD,IAAI,eAAe,WAElB;IACD,IAAI,OAAO,WAEV;IACD,IAAI,OAAO;cA1Ba,MAAM;eAAS,OAAO;oBAAc,MAAM;QA4BjE;IACD,IAAI,OAAO,YAEV;IACD,IAAI,WAAW,WAEd;IACD,IAAI,MAAM,YAET;IAED;;;;;;;OAOG;IACH,YAAY,eAAe,EALhB,MAKgB,EAAE,OAAO,EAJzB,MAIyB,EAAE,OAAO,AAH1C,CACA,EADQ,gBAGuC,EAkBjD;IAkHD;;;;;;OAMG;IACG,KAAK,IAJE,OAAO,CAAC,IAAI,CAAC,CAoBzB;IAED;;;OAGG;IACG,QAAQ,IAFD,OAAO,CAAC,OAAO,CAAC,CA+B5B;CAwFF;eAEc,sBAAsB"}