vortez 4.1.1

package/build/Config.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @author NetFeez <codefeez.dev@gmail.com>
+ * @description add the config manager to the Vortez.
+ * @license Apache-2.0
+ */
+import LoggerManager from "./LoggerManager/LoggerManager.js";
+export declare class Config implements Config.Main {
+    templates: Config.Templates;
+    host: string;
+    port: number;
+    logger: LoggerManager;
+    ssl: Config.SSLOptions | null;
+    static instance: Config;
+    constructor(options?: Config.options);
+    get showAll(): boolean;
+    set showAll(value: boolean);
+    static defaultTemplates(): Config.Templates;
+}
+export declare namespace Config {
+    interface Templates {
+        folder?: string;
+        error?: string;
+        [key: string]: string | undefined;
+    }
+    type SSLOptions = {
+        pubKey: string;
+        privKey: string;
+        port?: number;
+    };
+    interface Main {
+        host: string;
+        port: number;
+        ssl: SSLOptions | null;
+        logger: LoggerManager;
+        templates: Templates;
+    }
+    type options = Partial<Main>;
+}
+export default Config;

package/build/Config.js

@@ -0,0 +1,33 @@
+/**
+ * @author NetFeez <codefeez.dev@gmail.com>
+ * @description add the config manager to the Vortez.
+ * @license Apache-2.0
+ */
+import Debug from "./Debug.js";
+import LoggerManager from "./LoggerManager/LoggerManager.js";
+import Utilities from "./Utilities/Utilities.js";
+export class Config {
+    templates;
+    host;
+    port;
+    logger;
+    ssl;
+    static instance;
+    constructor(options = {}) {
+        this.host = options.host ?? 'localhost';
+        this.port = options.port ?? 80;
+        this.ssl = options.ssl ?? null;
+        this.logger = options.logger ?? LoggerManager.getInstance();
+        this.templates = options.templates ?? Config.defaultTemplates();
+    }
+    get showAll() { return Debug.showAll; }
+    set showAll(value) { Debug.showAll = value; }
+    static defaultTemplates() {
+        return {
+            folder: Utilities.Path.relative('./global/Template/Folder.vhtml'),
+            error: Utilities.Path.relative('./global/Template/Error.vhtml')
+        };
+    }
+}
+export default Config;
+//# sourceMappingURL=Config.js.map

package/build/Config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Config.js","sourceRoot":"","sources":["../src/Config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,MAAM,YAAY,CAAC;AAC/B,OAAO,aAAa,MAAM,kCAAkC,CAAC;AAC7D,OAAO,SAAS,MAAM,0BAA0B,CAAC;AAEjD,MAAM,OAAO,MAAM;IACR,SAAS,CAAmB;IAC5B,IAAI,CAAS;IACb,IAAI,CAAS;IACb,MAAM,CAAgB;IACtB,GAAG,CAA2B;IAC9B,MAAM,CAAC,QAAQ,CAAS;IAC/B,YAAmB,UAA0B,EAAE;QAC3C,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,WAAW,CAAC;QACxC,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC;QAC/B,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC;QAC/B,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,aAAa,CAAC,WAAW,EAAE,CAAC;QAC5D,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,MAAM,CAAC,gBAAgB,EAAE,CAAC;IACpE,CAAC;IACD,IAAW,OAAO,KAAc,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;IACvD,IAAW,OAAO,CAAC,KAAc,IAAI,KAAK,CAAC,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC;IACtD,MAAM,CAAC,gBAAgB;QAC1B,OAAO;YACH,MAAM,EAAE,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,gCAAgC,CAAC;YACjE,KAAK,EAAE,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,+BAA+B,CAAC;SAClE,CAAC;IACN,CAAC;CACJ;AAuBD,eAAe,MAAM,CAAC"}

package/build/ConsoleUI.d.ts

@@ -0,0 +1,57 @@
+/**
+ * @author NetFeez <codefeez.dev@gmail.com>
+ * @description contains the basic functionalities for module NetFeez-Labs tools
+ * @license Apache-2.0
+ */
+export declare class ConsoleUI {
+    private static formatString;
+    private static rgbString;
+    private static formats;
+    /**
+     * delete text formats and colors.
+     * @param text the text to clean.
+     * @param prefix the prefix.
+     */
+    static cleanFormat(text: string, prefix?: string): string;
+    /**
+     * colors the text.
+     * @param text the text to color.
+     * @param prefix the prefix.
+     * The default prefix is `&`
+     * Colors and formats
+     * - Formats:
+     * - - `N`: Bold
+     * - - `S`: Underline
+     * - - `P`: Blink
+     * - - `I`: Invert
+     * - - `R`: Reset
+     * - `B`: Used before a color to refer to the background.
+     * - - Example: `&B2Hello` will change the background of the text to green.
+     * - `C`: Used before a color to refer to the text.
+     * - - Example: `&C2Hello` will change the color of the text to green.
+     * - Colors:
+     * - - `(R,G,B)`: an RGB color, replace R, G, and B with their respective values.
+     * - - - No spaces after the `,`
+     * - - - Example: `&B(0,255,0)Hello` will change the background of the text to green.
+     * - - - Example: `&C(0,255,0)Hello` will change the color of the text to green.
+     * - - `0`: Black
+     * - - `1`: White
+     * - - `2`: Green
+     * - - `3`: Cyan
+     * - - `4`: Blue
+     * - - `5`: Magenta
+     * - - `6`: Red
+     * - - `7`: Yellow
+     */
+    static formatText(text: string, prefix?: string): string;
+    /**
+     * sends a message to the user through the console
+     * @param message the message(s) you want to send to the user
+     * @param newLine whether there is a line break or not
+     */
+    static send(message: string | string[], newLine?: boolean): void;
+}
+export declare namespace ConsoleUI {
+    type formatKey = ('N' | 'S' | 'P' | 'I' | 'R' | 'C0' | 'C1' | 'C2' | 'C3' | 'C4' | 'C5' | 'C6' | 'C7' | 'C' | 'B0' | 'B1' | 'B2' | 'B3' | 'B4' | 'B5' | 'B6' | 'B7' | 'B');
+}
+export default ConsoleUI;

package/build/ConsoleUI.js

@@ -0,0 +1,110 @@
+/**
+ * @author NetFeez <codefeez.dev@gmail.com>
+ * @description contains the basic functionalities for module NetFeez-Labs tools
+ * @license Apache-2.0
+ */
+export class ConsoleUI {
+    static formatString = '%prefix%((?:(?:[BC])[0-7])|[NSPIR])';
+    static rgbString = '%prefix%(?:([BC])\\((?:([0-2]?[0-9]{1,2}),([0-2]?[0-9]{1,2}),([0-2]?[0-9]{1,2}))\\))';
+    static formats = {
+        // Var - Code          --      Text color
+        C0: '\x1B[30m', // Black
+        C1: '\x1B[31m', // Red
+        C2: '\x1B[32m', // Green
+        C3: '\x1B[33m', // Yellow
+        C4: '\x1B[34m', // Blue
+        C5: '\x1B[35m', // Magenta
+        C6: '\x1B[36m', // Cyan
+        C7: '\x1B[37m', // White
+        C: '\x1B[38;2;R;G;Bm', //(R,G,B)
+        // Var - Code          --      Background color
+        B0: '\x1B[40m', // Black
+        B1: '\x1B[41m', // Red
+        B2: '\x1B[42m', // Green
+        B3: '\x1B[43m', // Yellow
+        B4: '\x1B[44m', // Blue
+        B5: '\x1B[45m', // Magenta
+        B6: '\x1B[46m', // Cyan
+        B7: '\x1B[47m', // White
+        B: '\x1B[48;2;R;G;Bm', //(R,G,B)
+        // Var - Code          --      Text format
+        N: '\x1B[1m', // Bold
+        S: '\x1B[4m', // Underline
+        P: '\x1B[5m', // Blink
+        I: '\x1B[7m', // Invert
+        R: '\x1B[0m', // Reset
+        none: ''
+    };
+    /**
+     * delete text formats and colors.
+     * @param text the text to clean.
+     * @param prefix the prefix.
+     */
+    static cleanFormat(text, prefix = '&') {
+        const formatExp = new RegExp(this.formatString.replace('%prefix%', prefix), 'g');
+        const rgbExp = new RegExp(this.rgbString.replace('%prefix%', prefix), 'g');
+        return text.replace(formatExp, '').replace(rgbExp, '');
+    }
+    /**
+     * colors the text.
+     * @param text the text to color.
+     * @param prefix the prefix.
+     * The default prefix is `&`
+     * Colors and formats
+     * - Formats:
+     * - - `N`: Bold
+     * - - `S`: Underline
+     * - - `P`: Blink
+     * - - `I`: Invert
+     * - - `R`: Reset
+     * - `B`: Used before a color to refer to the background.
+     * - - Example: `&B2Hello` will change the background of the text to green.
+     * - `C`: Used before a color to refer to the text.
+     * - - Example: `&C2Hello` will change the color of the text to green.
+     * - Colors:
+     * - - `(R,G,B)`: an RGB color, replace R, G, and B with their respective values.
+     * - - - No spaces after the `,`
+     * - - - Example: `&B(0,255,0)Hello` will change the background of the text to green.
+     * - - - Example: `&C(0,255,0)Hello` will change the color of the text to green.
+     * - - `0`: Black
+     * - - `1`: White
+     * - - `2`: Green
+     * - - `3`: Cyan
+     * - - `4`: Blue
+     * - - `5`: Magenta
+     * - - `6`: Red
+     * - - `7`: Yellow
+     */
+    static formatText(text, prefix = '&') {
+        const formatExp = new RegExp(this.formatString.replace('%prefix%', prefix), 'g');
+        const rgbExp = new RegExp(this.rgbString.replace('%prefix%', prefix), 'g');
+        return `${text
+            .replace(formatExp, (result, format) => this.formats[format])
+            .replace(rgbExp, (result, type, R, G, B) => (this.formats[type]
+            .replace('R', R)
+            .replace('G', G)
+            .replace('B', B)))}${this.formats.R}`;
+    }
+    /**
+     * sends a message to the user through the console
+     * @param message the message(s) you want to send to the user
+     * @param newLine whether there is a line break or not
+     */
+    static send(message, newLine) {
+        if (typeof message === 'string') {
+            process.stdout.write(`${message}${newLine ? '\n' : ''}`, 'utf8');
+        }
+        else if (Array.isArray(message)) {
+            message.forEach((value) => {
+                this.send(value);
+            });
+            if (newLine)
+                process.stdout.write(`\n`, 'utf8');
+        }
+        else {
+            process.stdout.write('[consoleUI] You tried to send a failed type \n');
+        }
+    }
+}
+export default ConsoleUI;
+//# sourceMappingURL=ConsoleUI.js.map

package/build/ConsoleUI.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConsoleUI.js","sourceRoot":"","sources":["../src/ConsoleUI.ts"],"names":[],"mappings":"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"}

package/build/Debug.d.ts

@@ -0,0 +1,154 @@
+/**
+ * @author NetFeez <codefeez.dev@gmail.com>
+ * @description Add the debug system to the Vortez.
+ * @license Apache-2.0
+ */
+export declare class Debug {
+    private static debugs;
+    static showAll: boolean;
+    private id;
+    show: boolean;
+    private _save;
+    private filePath;
+    private rootPath;
+    private startDate;
+    private stream;
+    /**
+     * Create or retrieve a debug instance.
+     * @param id - Debug instance ID
+     * @param options - Debug instance options
+     * @returns The debug instance
+     */
+    static getInstance(id?: string, options?: Debug.options): Debug;
+    /**
+     * Create a new debug instance.
+     * @param id - Debug instance ID
+     * @param options - Debug instance options
+     */
+    private constructor();
+    get save(): boolean;
+    set save(value: boolean);
+    /**
+     * Get the stream to the debug file.
+     * @returns The stream to the debug file
+     */
+    private getStream;
+    /**
+     * Log data to the console and/or the debug file.
+     * @param data - Data to log
+     */
+    log(...data: any[]): void;
+    /**
+     * Log data to the console and/or the debug file.
+     * @param data - Data to log
+     */
+    info(...data: any[]): void;
+    /**
+     * Log data to the console and/or the debug file.
+     * @param data - Data to log
+     */
+    warn(...data: any[]): void;
+    /**
+     * Log data to the console and/or the debug file.
+     * @param data - Data to log
+     */
+    error(...data: any[]): void;
+    /**
+     * Log data to the console and/or the debug file with a specific prefix.
+     * @param data - Data to log
+     */
+    customLog(prefix: string, ...data: any[]): void;
+    /**
+     * Save data to the debug file.
+     * @param timestamp - Timestamp of the log
+     * @param prefix - Prefix of the log
+     * @param data - Data to log
+     */
+    private showLog;
+    /**
+     * Save data to the debug file.
+     * @param timestamp - Timestamp of the log
+     * @param prefix - Prefix of the log
+     * @param data - Data to log
+     */
+    private saveLog;
+    /**
+     * Log data using the default debug instance.
+     * @param Data - Data to log
+     */
+    static log(...Data: any): void;
+    /**
+     * Log data using the default debug instance.
+     * @param Data - Data to log
+     */
+    static info(...Data: any): void;
+    /**
+     * Log data using the default debug instance.
+     * @param Data - Data to log
+     */
+    static warn(...Data: any): void;
+    /**
+     * Log data using the default debug instance.
+     * @param Data - Data to log
+     */
+    static error(...Data: any): void;
+    /**
+     * Clean a path.
+     * @param path - Path to clean
+     * @returns Cleaned path
+     */
+    private static cleanPath;
+    /**
+     * Get the path to the debug file.
+     * @param id - Debug instance ID
+     * @param folderPath - Path to the debug folder
+     * @param date - Date of the debug instance
+     * @returns The path to the debug file
+     */
+    private static getFilePath;
+    /**
+     * Generate a stream to the debug file.
+     * @param id - Debug instance ID
+     * @param filePath - Path to the debug file
+     * @param date - Date of the debug instance
+     * @returns The stream to the debug file
+     */
+    private static generateStream;
+    /**
+     * Decorate a timestamp with color codes.
+     * @param timestamp - timestamp to decorate
+     * @returns Decorated timestamp
+     */
+    private static decorateTimestamp;
+    /**
+     * Generate a datetime timestamp.
+     * @returns Formatted datetime timestamp
+     */
+    private static getTimestamp;
+    /**
+     * Get the current date and time in formatted parts.
+     * @returns Object containing date parts and full formats
+     */
+    private static getDate;
+}
+export declare namespace Debug {
+    type debugMap = Map<string, Debug>;
+    interface options {
+        path?: string;
+        show?: boolean;
+        save?: boolean;
+    }
+    interface Date {
+        day: string;
+        month: string;
+        year: string;
+        hour: string;
+        minute: string;
+        second: string;
+        millisecond: string;
+        DateFormat: string;
+        TimeFormat: string;
+        now: globalThis.Date;
+    }
+}
+export default Debug;

package/build/Debug.js

@@ -0,0 +1,256 @@
+/**
+ * @author NetFeez <codefeez.dev@gmail.com>
+ * @description Add the debug system to the Vortez.
+ * @license Apache-2.0
+ */
+import fs from 'fs';
+import ConsoleUI from './ConsoleUI.js';
+import Utilities from './Utilities/Utilities.js';
+export class Debug {
+    static debugs = new Map();
+    static showAll = false;
+    id;
+    show;
+    _save;
+    filePath;
+    rootPath;
+    startDate;
+    stream;
+    /**
+     * Create or retrieve a debug instance.
+     * @param id - Debug instance ID
+     * @param options - Debug instance options
+     * @returns The debug instance
+     */
+    static getInstance(id = '_debug', options = {}) {
+        const debug = Debug.debugs.get(id);
+        if (!debug)
+            return new Debug(id, options);
+        debug.save = options.save ?? debug.save;
+        debug.show = options.show ?? debug.show;
+        return debug;
+    }
+    /**
+     * Create a new debug instance.
+     * @param id - Debug instance ID
+     * @param options - Debug instance options
+     */
+    constructor(id = '_default', options = {}) {
+        const { path = '.debug', show = true, save = true } = options;
+        const now = Debug.getDate();
+        const rootPath = Debug.cleanPath(path);
+        const filePath = Debug.getFilePath(id, rootPath, now);
+        this.id = id;
+        this.show = show;
+        this._save = save;
+        this.rootPath = rootPath;
+        this.filePath = filePath;
+        this.startDate = now;
+        this.stream = null;
+        Debug.debugs.set(id, this);
+    }
+    get save() { return this._save; }
+    set save(value) {
+        this._save = value;
+        if (value)
+            this.stream = this.getStream();
+        else if (this.stream) {
+            this.stream.destroy();
+            this.stream = null;
+        }
+    }
+    /**
+     * Get the stream to the debug file.
+     * @returns The stream to the debug file
+     */
+    getStream() {
+        if (!this.stream) {
+            const id = this.id;
+            const date = this.startDate;
+            const stream = Debug.generateStream(this.filePath);
+            stream.write([
+                '/* +----------------------------+* /',
+                '/* | NetFeez-Labs/Debug by NetFeez |* /',
+                '/* |     Use NetFeez-Labs ReadDebug     |* /',
+                '/* +----------------------------+* /',
+                `/* the name of the DebugFile is the DateTime of initialize Debug with ID ${id} */`,
+                `/* the initialize stream DateTime is ${date.DateFormat} << ${date.TimeFormat} */`,
+                '', ''
+            ].join('\n'));
+            this.stream = stream;
+            const file = Utilities.Path.relative(this.filePath);
+            this.log(`&C2&PStream created to the debug file: &C6&S${file}`);
+        }
+        return this.stream;
+    }
+    /**
+     * Log data to the console and/or the debug file.
+     * @param data - Data to log
+     */
+    log(...data) { this.customLog('&C2[LOG]', ...data); }
+    /**
+     * Log data to the console and/or the debug file.
+     * @param data - Data to log
+     */
+    info(...data) { this.customLog('&C6[INF]', ...data); }
+    /**
+     * Log data to the console and/or the debug file.
+     * @param data - Data to log
+     */
+    warn(...data) { this.customLog('&C3[WRN]', ...data); }
+    /**
+     * Log data to the console and/or the debug file.
+     * @param data - Data to log
+     */
+    error(...data) { this.customLog('&C1[ERR]', ...data); }
+    /**
+     * Log data to the console and/or the debug file with a specific prefix.
+     * @param data - Data to log
+     */
+    customLog(prefix, ...data) {
+        const timestamp = Debug.getTimestamp();
+        if (this._save)
+            this.saveLog(timestamp, prefix, ...data);
+        if (this.show || Debug.showAll)
+            this.showLog(timestamp, prefix, ...data);
+    }
+    /**
+     * Save data to the debug file.
+     * @param timestamp - Timestamp of the log
+     * @param prefix - Prefix of the log
+     * @param data - Data to log
+     */
+    showLog(timestamp, prefix, ...data) {
+        timestamp = Debug.decorateTimestamp(timestamp);
+        timestamp = ConsoleUI.formatText(timestamp);
+        prefix = ConsoleUI.formatText(prefix);
+        const toShow = data.map((Datum) => typeof Datum === 'string' ?
+            ConsoleUI.formatText(Datum) : Datum);
+        console.log(`${timestamp} ${prefix} ->`, ...toShow);
+    }
+    /**
+     * Save data to the debug file.
+     * @param timestamp - Timestamp of the log
+     * @param prefix - Prefix of the log
+     * @param data - Data to log
+     */
+    saveLog(timestamp, prefix, ...data) {
+        timestamp = ConsoleUI.cleanFormat(timestamp);
+        prefix = ConsoleUI.cleanFormat(prefix);
+        const stream = this.getStream();
+        const toSave = data.map((Datum) => typeof Datum === 'string' ?
+            ConsoleUI.cleanFormat(Datum) : Datum);
+        stream.write(`${timestamp} ${prefix} -> ${JSON.stringify(toSave)}\n`);
+    }
+    /**
+     * Log data using the default debug instance.
+     * @param Data - Data to log
+     */
+    static log(...Data) {
+        const debug = this.getInstance();
+        debug.log(...Data);
+    }
+    /**
+     * Log data using the default debug instance.
+     * @param Data - Data to log
+     */
+    static info(...Data) {
+        const debug = this.getInstance();
+        debug.info(...Data);
+    }
+    /**
+     * Log data using the default debug instance.
+     * @param Data - Data to log
+     */
+    static warn(...Data) {
+        const debug = this.getInstance();
+        debug.warn(...Data);
+    }
+    /**
+     * Log data using the default debug instance.
+     * @param Data - Data to log
+     */
+    static error(...Data) {
+        const debug = this.getInstance();
+        debug.error(...Data);
+    }
+    /**
+     * Clean a path.
+     * @param path - Path to clean
+     * @returns Cleaned path
+     */
+    static cleanPath(path) {
+        path = Utilities.Path.normalize(path);
+        path = path.startsWith('/') ? path.slice(1) : path;
+        path = path.endsWith('/') ? path.slice(0, -1) : path;
+        return path;
+    }
+    /**
+     * Get the path to the debug file.
+     * @param id - Debug instance ID
+     * @param folderPath - Path to the debug folder
+     * @param date - Date of the debug instance
+     * @returns The path to the debug file
+     */
+    static getFilePath(id, folderPath, date) {
+        const file = `[${id}] - ${date.hour}.${date.minute}.${date.second}.${date.millisecond}.vlog`;
+        const folder = `${folderPath}/[${date.day}.${date.month}.${date.year}]`;
+        const path = `${folder}/${file}`;
+        return path;
+    }
+    /**
+     * Generate a stream to the debug file.
+     * @param id - Debug instance ID
+     * @param filePath - Path to the debug file
+     * @param date - Date of the debug instance
+     * @returns The stream to the debug file
+     */
+    static generateStream(filePath) {
+        const folder = filePath.slice(0, filePath.lastIndexOf('/'));
+        if (!fs.existsSync(folder))
+            fs.mkdirSync(folder, { recursive: true });
+        const stream = fs.createWriteStream(filePath, 'utf8');
+        return stream;
+    }
+    /**
+     * Decorate a timestamp with color codes.
+     * @param timestamp - timestamp to decorate
+     * @returns Decorated timestamp
+     */
+    static decorateTimestamp(timestamp) {
+        return ConsoleUI.formatText(`&C(255,255,255)${timestamp}&R`);
+    }
+    /**
+     * Generate a datetime timestamp.
+     * @returns Formatted datetime timestamp
+     */
+    static getTimestamp() {
+        const now = Debug.getDate();
+        const prefix = `[${now.hour}:${now.minute}:${now.second}:${now.millisecond}]`;
+        return prefix;
+    }
+    /**
+     * Get the current date and time in formatted parts.
+     * @returns Object containing date parts and full formats
+     */
+    static getDate() {
+        const now = new Date();
+        const day = now.getDate().toString().padStart(2, '0');
+        const month = (now.getMonth() + 1).toString().padStart(2, '0');
+        const year = now.getFullYear().toString().padStart(4, '0');
+        const hour = now.getHours().toString().padStart(2, '0');
+        const minute = now.getMinutes().toString().padStart(2, '0');
+        const second = now.getSeconds().toString().padStart(2, '0');
+        const millisecond = now.getMilliseconds().toString().padStart(3, '0');
+        const DateFormat = `${day}-${month}-${year}`;
+        const TimeFormat = `${hour}.${minute}.${second}.${millisecond}`;
+        const result = {
+            day, month, year,
+            hour, minute, second, millisecond,
+            DateFormat, TimeFormat, now
+        };
+        return result;
+    }
+}
+export default Debug;
+//# sourceMappingURL=Debug.js.map

package/build/Debug.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Debug.js","sourceRoot":"","sources":["../src/Debug.ts"],"names":[],"mappings":"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"}