tiny-essentials 1.28.14 → 1.28.16

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

@@ -0,0 +1,407 @@
+import { access, readFile } from 'fs/promises';
+import { resolve } from '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 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 = resolve(this.#rootDir, cleanPath);
+        try {
+            await 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;
+        }
+    }
+}
+export default TinyPkgExportValidator;

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

@@ -0,0 +1 @@
+{"version":3,"file":"TinyClassManager.d.mts","sourceRoot":"","sources":["../../../../../src/v1/libs/tools/examples/TinyClassManager.mjs"],"names":[],"mappings":""}

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

@@ -0,0 +1 @@
+{"version":3,"file":"TinyPromiseQueue.d.mts","sourceRoot":"","sources":["../../../../src/v1/libs/utils/TinyPromiseQueue.mjs"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAPA,YAAkB,UAAU,GAC5B;;;;IAA0D,IAAI,EAAnD,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,GAAC,OAAO,CAAC,GAAG,CAAC,CACxD;;;;IAAgC,OAAO,EAA5B,CAAC,KAAK,EAAE,GAAG,KAAK,GAAG,CAC9B;;;;IAAkC,MAAM,EAA7B,CAAC,MAAM,CAAC,EAAE,GAAG,KAAK,GAAG,CAChC;;;;IAA8B,EAAE,AAAhC,CACA,EADW,MAAM,GAAC,SAAS,CAC3B;;;;IAAmC,MAAM,AAAzC,CACA,EADW,MAAM,GAAC,IAAI,GAAC,SAAS,CAChC;;;;IAAmC,KAAK,AAAxC,CACF,EADa,MAAM,GAAC,IAAI,GAAC,SAAS,CAClC;CAAA,CAAA;AAED;;;;;;;GAOG;AACH,cAAM,gBAAgB;;IASpB;;;;OAIG;IACH,SAAS,IAFI,OAAO,CAInB;IAsGD;;;;;OAKG;IACH,YAAY,CAAC,EAAE,EAHJ,MAGI,GAFF,MAAM,CAIlB;IAED;;;;OAIG;IACH,YAAY,IAFC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,EAAE,CAO3C;IAED;;;;;OAKG;IACH,YAAY,CAAC,SAAS,EAHX,MAGW,EAAE,OAAO,EAFpB,MAEoB,QAY9B;IAED;;;;;;;;;OASG;IACG,YAAY,CANC,aAAa,SAAlB,GAAkB,EAMb,IAAI,EALZ,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,aAAa,CAK7B,EAAE,EAAE,AAJxB,CACA,EADQ,MAIgB,GAHd,OAAO,CAAC,aAAa,CAAC,CAalC;IAED;;;;;;;;;;;;;OAaG;IACH,OAAO,CAPY,aAAa,SAAlB,GAAkB,EAOxB,IAAI,EAND,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,aAAa,CAMxC,EAAE,KAAK,AALhB,CACA,EADQ,MAAM,GAAC,IAKC,EAAE,EAAE,AAJpB,CACA,EADQ,MAIY,GAHV,OAAO,CAAC,aAAa,CAAC,CAelC;IAED;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,EAJF,MAIE,GAHA,OAAO,CAuBnB;CACF;eAEc,gBAAgB"}

package/dist/v1/libs/{UltraRandomMsgGen.cjs → utils/UltraRandomMsgGen.cjs}

@@ -1,8 +1,8 @@
 'use strict';
 
-var utils = require('./utils.cjs');
+var tools = require('./tools.cjs');
 
-const checkDestroy = utils.createCheckDestroyed('UltraRandomMsgGen');
+const checkDestroy = tools.createCheckDestroyed('UltraRandomMsgGen');
 
 const defaultWords = [
   'lorem',

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

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

package/dist/v1/libs/{UltraRandomMsgGen.mjs → utils/UltraRandomMsgGen.mjs}

@@ -1,4 +1,4 @@
-import { createCheckDestroyed } from './utils.mjs';
+import { createCheckDestroyed } from './tools.mjs';
 const checkDestroy = createCheckDestroyed('UltraRandomMsgGen');
 const defaultWords = [
     'lorem',

package/dist/v1/libs/{utils.d.mts → utils/tools.d.mts}

@@ -3,4 +3,4 @@
  * @param {string} name
  */
 export declare const createCheckDestroyed: (name: string) => (isDestroyed: boolean) => void;
-//# sourceMappingURL=utils.d.mts.map
+//# sourceMappingURL=tools.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.mts","sourceRoot":"","sources":["../../../../src/v1/libs/utils/tools.mjs"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,oBAAoB,SAFtB,MAAM,mBAOJ,OAAO,KAEL,IAKZ,CAAC"}

package/docs/TinyFork.md

@@ -55,14 +55,14 @@ npx tiny-essentials-fork basics/array/multiplyArrayBlocks,diffArrayList
 If a module exports a default class filled with static methods, you can extract those methods just like regular functions. TinyFork will intelligently detach them from the class and export them as standalone functions!
 
 ```bash
-npx tiny-essentials-fork libs/TinyArrayComparator/generateHash
+npx tiny-essentials-fork libs/array/TinyArrayComparator/generateHash
 ```
 
 ### 4. Extracting Multiple Targets at Once
 You can queue as many targets as you want in a single command. TinyFork will orchestrate the entire extraction, mapping all dependencies together.
 
 ```bash
-npx tiny-essentials-fork libs/TinyHtml basics/array/multiplyArrayBlocks libs/TinyArrayComparator/generateHash
+npx tiny-essentials-fork libs/html/TinyHtml basics/array/multiplyArrayBlocks libs/array/TinyArrayComparator/generateHash
 ```
 
 ### 5. Specifying a Library Version