tnp-core 21.0.144 → 21.0.145

package/browser/fesm2022/tnp-core-browser.mjs

@@ -310,6 +310,7 @@ import * as json5 from 'json5';
 export { json5 };
 import { Subject, BehaviorSubject } from 'rxjs';
 import 'reflect-metadata';
+import { exec } from 'node:child_process';
 import axios from 'axios';
 
 let isBrowser = false;
@@ -1724,6 +1725,193 @@ const CoreConfig = {
     },
 };
 
+/* */
+/* */
+var UtilsProgress;
+(function (UtilsProgress) {
+    const PROGRESS_PREFIX = '[[[';
+    const PROGRESS_SUFFIX = ']]]';
+    //#endregion
+    //#region emit progress
+    function emitProgress(event, forceShow = false) {
+        const normalizedEvent = {
+            ...event,
+            value: normalizeProgressValue(event.value),
+            date: event.date ?? new Date().toISOString(),
+        };
+        const dataToWrite = `${PROGRESS_PREFIX}` +
+            `${JSON.stringify(normalizedEvent)}` +
+            `${PROGRESS_SUFFIX}`;
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        //#region @browser
+        if (forceShow || globalThis.taonNonInteractive) {
+            console.log(dataToWrite);
+        }
+        //#endregion
+    }
+    UtilsProgress.emitProgress = emitProgress;
+    //#endregion
+    //#region resolve from
+    function resolveFrom(chunk, options = {}, checkSplit = true) {
+        options = options || {};
+        if (!_.isString(chunk)) {
+            return [];
+        }
+        if (_.isNil(checkSplit)) {
+            checkSplit = true;
+        }
+        if (checkSplit) {
+            const lines = chunk.split(/\r\n|\n|\r/);
+            if (lines.length > 1) {
+                return lines.flatMap(line => resolveFrom(line, options, false));
+            }
+        }
+        const result = [];
+        const trimmedChunk = chunk.trim();
+        if (!trimmedChunk) {
+            return result;
+        }
+        /*
+         * A line may contain one or multiple progress events:
+         *
+         * [[[{"value":10}]]]
+         *
+         * or:
+         *
+         * normal log [[[{"value":10}]]] another log
+         */
+        const progressJsonParts = extractProgressJsonParts(trimmedChunk);
+        for (const progressJson of progressJsonParts) {
+            const event = parseTaonProgressJson(progressJson, options);
+            if (!event) {
+                continue;
+            }
+            result.push(event);
+            options.callbackOnFounded?.(event);
+        }
+        return result;
+    }
+    UtilsProgress.resolveFrom = resolveFrom;
+    //#endregion
+    //#region has progress event
+    function hasProgressEvent(chunk) {
+        return resolveFrom(chunk).length > 0;
+    }
+    UtilsProgress.hasProgressEvent = hasProgressEvent;
+    //#endregion
+    //#region parse taon progress line
+    function parseTaonProgressLine(line) {
+        if (!_.isString(line)) {
+            return undefined;
+        }
+        const trimmed = line.trim();
+        if (!trimmed.startsWith(PROGRESS_PREFIX) ||
+            !trimmed.endsWith(PROGRESS_SUFFIX)) {
+            return undefined;
+        }
+        const json = trimmed.slice(PROGRESS_PREFIX.length, -PROGRESS_SUFFIX.length);
+        return parseTaonProgressJson(json);
+    }
+    UtilsProgress.parseTaonProgressLine = parseTaonProgressLine;
+    //#endregion
+    //#region extract progress json parts
+    function extractProgressJsonParts(chunk) {
+        const result = [];
+        let searchIndex = 0;
+        while (searchIndex < chunk.length) {
+            const prefixIndex = chunk.indexOf(PROGRESS_PREFIX, searchIndex);
+            if (prefixIndex === -1) {
+                break;
+            }
+            const jsonStart = prefixIndex + PROGRESS_PREFIX.length;
+            const suffixIndex = chunk.indexOf(PROGRESS_SUFFIX, jsonStart);
+            if (suffixIndex === -1) {
+                break;
+            }
+            result.push(chunk.slice(jsonStart, suffixIndex));
+            searchIndex = suffixIndex + PROGRESS_SUFFIX.length;
+        }
+        return result;
+    }
+    //#endregion
+    //#region parse progress json
+    function parseTaonProgressJson(json, options = {}) {
+        try {
+            const parsed = JSON.parse(json);
+            if (!isTaonProgressEvent(parsed)) {
+                if (options.logParseErrors) {
+                    console.error(`Invalid Taon progress event: ${json}`);
+                }
+                return undefined;
+            }
+            return {
+                ...parsed,
+                value: normalizeProgressValue(parsed.value),
+            };
+        }
+        catch (error) {
+            if (options.logParseErrors) {
+                console.error(`Cannot parse Taon progress event: ${json}`, error);
+            }
+            return undefined;
+        }
+    }
+    //#endregion
+    //#region normalize progress value
+    function normalizeProgressValue(value) {
+        if (typeof value !== 'number') {
+            return undefined;
+        }
+        if (!Number.isFinite(value)) {
+            return undefined;
+        }
+        return Math.max(0, Math.min(100, value));
+    }
+    //#endregion
+    //#region is taon progress event
+    function isTaonProgressEvent(value) {
+        if (value === null || typeof value !== 'object' || Array.isArray(value)) {
+            return false;
+        }
+        const event = value;
+        return (isOptionalFiniteNumber(event.value) &&
+            isOptionalString(event.message) &&
+            isOptionalProgressType(event.type) &&
+            isOptionalIsoDateString(event.date));
+    }
+    //#endregion
+    //#region validators
+    function isOptionalFiniteNumber(value) {
+        return (value === undefined ||
+            (typeof value === 'number' && Number.isFinite(value)));
+    }
+    function isOptionalString(value) {
+        return value === undefined || typeof value === 'string';
+    }
+    function isOptionalProgressType(value) {
+        return (value === undefined ||
+            value === 'info' ||
+            value === 'warning' ||
+            value === 'error' ||
+            value === 'event');
+    }
+    function isOptionalIsoDateString(value) {
+        if (value === undefined) {
+            return true;
+        }
+        if (typeof value !== 'string') {
+            return false;
+        }
+        return !Number.isNaN(Date.parse(value));
+    }
+    //#endregion
+})(UtilsProgress || (UtilsProgress = {}));
+
 // @ts-ignore
 const isCloudflareWorker = typeof WebSocketPair !== 'undefined';
 const taonContainers = 'taon-containers';
@@ -3670,184 +3858,22 @@ const startAsync = async (command, cwd, options) => {
 };
 //#endregion
 
-var UtilsTime;
-(function (UtilsTime) {
-    //#region format duration
-    UtilsTime.formatDuration = (milliseconds) => {
-        const absMs = Math.abs(milliseconds);
-        const ms = absMs % 1000;
-        const totalSeconds = Math.floor(absMs / 1000);
-        const seconds = totalSeconds % 60;
-        const totalMinutes = Math.floor(totalSeconds / 60);
-        const minutes = totalMinutes % 60;
-        const hours = Math.floor(totalMinutes / 60);
-        const parts = [];
-        if (hours > 0) {
-            parts.push(`${hours}h`);
-        }
-        if (minutes > 0) {
-            parts.push(`${minutes}min`);
-        }
-        if (seconds > 0) {
-            parts.push(`${seconds}s`);
-        }
-        // show ms:
-        // - always when < 1s
-        // - otherwise only if there is remainder
-        if (ms > 0 || parts.length === 0) {
-            parts.push(`${ms}ms`);
-        }
-        return parts.join(', ');
-    };
-    //#endregion
-    //#region wait
-    UtilsTime.wait = (second) => {
-        return new Promise((resolve, reject) => {
-            setTimeout(() => {
-                resolve(void 0);
-            }, second * 1000);
-        });
-    };
-    //#endregion
-    //#region wait miliseconds
-    UtilsTime.waitMilliseconds = (milliseconds) => {
-        // Helpers.taskStarted(`Waiting ${milliseconds} milliseconds...`);
-        return new Promise((resolve, reject) => {
-            setTimeout(() => {
-                // Helpers.taskDone(`Done waiting ${milliseconds} milliseconds`);
-                resolve(void 0);
-            }, milliseconds);
-        });
-    };
-    function createResult(description, durationMs, options) {
-        const seconds = durationMs / 1000;
-        const minutes = seconds / 60;
-        const human = durationMs < 1000
-            ? `${durationMs.toFixed(2)}ms`
-            : seconds < 60
-                ? `${seconds.toFixed(2)}s`
-                : `${minutes.toFixed(2)}min`;
-        if (!options?.hideLogs) {
-            Helpers.taskDone(`Execution time for "${chalk.bold(description)}": ${chalk.bold(human)}`);
-        }
-        return {
-            milliseconds: durationMs,
-            seconds,
-            minutes,
-            human,
-        };
-    }
-    //#endregion
-    //#region mesure execution time
-    UtilsTime.mesureExecutionTime = async (description, functionToExecute, options) => {
-        if (!options?.hideLogs) {
-            Helpers.taskStarted(`Starting ${chalk.bold(description)} (measuring time)`);
-        }
-        const start = process.hrtime.bigint();
-        await functionToExecute();
-        const end = process.hrtime.bigint();
-        const durationMs = Number(end - start) / 1_000_000;
-        return createResult(description, durationMs, options);
-    };
-    //#endregion
-    //#region mesure execution time sync
-    UtilsTime.mesureExecutionTimeSync = (description, functionToExecute, options) => {
-        if (!options?.hideLogs) {
-            Helpers.taskStarted(`Starting ${chalk.bold(description)} (measuring time)`);
-        }
-        const start = process.hrtime.bigint();
-        functionToExecute();
-        const end = process.hrtime.bigint();
-        const durationMs = Number(end - start) / 1_000_000;
-        return createResult(description, durationMs, options);
-    };
-    //#endregion
-})(UtilsTime || (UtilsTime = {}));
-
 //#region imports
 //#endregion
-//#region utils
-var Utils;
-(function (Utils) {
-    //#region wait
-    Utils.wait = (second) => {
-        return UtilsTime.wait(second);
-    };
-    //#endregion
-    //#region wait miliseconds
-    Utils.waitMilliseconds = (milliseconds) => {
-        // Helpers.taskStarted(`Waiting ${milliseconds} milliseconds...`);
-        return UtilsTime.waitMilliseconds(milliseconds);
-    };
-    //#endregion
-    //#region utils / uniq array
-    Utils.uniqArray = (array, uniqueProperty) => {
-        var seen = {};
-        return array
-            .filter(f => !!f)
-            .filter(function (item) {
-            return seen.hasOwnProperty(uniqueProperty ? item[uniqueProperty] : item)
-                ? false
-                : (seen[uniqueProperty ? item[uniqueProperty] : item] = true);
-        });
-    };
-    //#endregion
-    //#region utils / recursive sort keys in object
-    /**
-     * @param anyObject
-     * @returns object with sorted keys
-     */
-    Utils.sortKeys = (anyObject) => {
-        if (_.isArray(anyObject)) {
-            return anyObject.map(Utils.sortKeys);
-        }
-        if (_.isObject(anyObject)) {
-            return _.fromPairs(_.keys(anyObject)
-                .sort()
-                .map(key => [key, Utils.sortKeys(anyObject[key])]));
-        }
-        return anyObject;
-    };
-    //#endregion
-    //#region utils / escape string for reg exp
+var UtilsProcess;
+(function (UtilsProcess) {
+    //#region utils process  / start async child process command until
     /**
-     * Example:
-     * new RegExp(escapeStringForRegEx('a.b.c'),'g') => /a\.b\.c/g
+     * This let you start child process and resolve promise when some
+     * condition is met. It is useful for example when you want to start
+     * process and wait until some output is in stdout or stderr.
      */
-    Utils.escapeStringForRegEx = (stringForRegExp, options) => {
-        options = options || {};
-        if (options?.skipEscapeSlashAndDash) {
-            return stringForRegExp.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-        }
-        return stringForRegExp.replace(/[-\/\\^$*+?.()|[\]{}]/g, '\\$&');
-    };
-    //#endregion
-    //#region utils / remove chalk special chars
-    function removeChalkSpecialChars(str) {
-        // Regex to match ANSI escape sequences used by Chalk
-        const ansiRegex = /\u001b\[[0-9;]*m/g;
-        // Replace all ANSI escape sequences with an empty string
-        return str.replace(ansiRegex, '');
-    }
-    Utils.removeChalkSpecialChars = removeChalkSpecialChars;
-    //#endregion
-    //#region utils / full date time
-    Utils.fullDateTime = () => {
+    UtilsProcess.startAsyncChildProcessCommandUntil = async (command, options) => {
+        /* */
         /* */
         /* */
-        return (void 0);
-    };
-    //#endregion
-    //#region utils / full date
-    Utils.fullDate = () => {
         /* */
         /* */
-        return (void 0);
-    };
-    //#endregion
-    //#region utils / get free port
-    const takenPorts = [];
-    Utils.getFreePort = async (options) => {
         /* */
         /* */
         /* */
@@ -3878,15 +3904,6 @@ var Utils;
         /* */
         /* */
         /* */
-        return (void 0);
-    };
-    //#endregion
-    //#region utils / required uncached
-    /**
-     * Traverses the cache to search for all the cached
-     * files of the specified module name
-     */
-    const searchCache = (moduleName, callback) => {
         /* */
         /* */
         /* */
@@ -3907,12 +3924,6 @@ var Utils;
         /* */
         /* */
         /* */
-        return (void 0);
-    };
-    /**
-     * Removes a module from the cache
-     */
-    const purgeCache = moduleName => {
         /* */
         /* */
         /* */
@@ -3929,58 +3940,12 @@ var Utils;
         /* */
         return (void 0);
     };
-    Utils.requireUncached = (module) => {
-        /* */
+    //#endregion
+    //#region utils process  / get git bash path
+    UtilsProcess.getGitBashPath = () => {
         /* */
         /* */
         /* */
-        return (void 0);
-    };
-    //#endregion
-    //#region utils / camelize
-    /**
-     * similar to camelCase but remove
-     * all non word / repeated characters
-     */
-    Utils.camelize = (str = '') => {
-        str = str.replace(/\W/g, '').toLowerCase();
-        return str
-            .replace(/(?:^\w|[A-Z]|\b\w)/g, function (word, index) {
-            return index == 0 ? word.toLowerCase() : word.toUpperCase();
-        })
-            .replace(/\s+/g, '');
-    };
-    //#endregion
-    //#region css
-    let css;
-    (function (css) {
-        //#region css utils / numeric value of pixels
-        /**
-         *
-         * @param pixelsCss pixels ex. 100px
-         * @returns
-         */
-        function numValue(pixelsCss) {
-            // tslint:disable-next-line:radix
-            return parseInt(pixelsCss?.toString()?.replace('px', ''));
-        }
-        css.numValue = numValue;
-        //#endregion
-    })(css = Utils.css || (Utils.css = {}));
-    //#endregion
-})(Utils || (Utils = {}));
-//#endregion
-//#region TODO IN_PROGRESS utils messages
-/**
- * TODO @LAST @IN_PROGRESS
- * - utils for messages
- * - export when ready
- * - should be ready for everything async refactor
- */
-var UtilsMessages;
-(function (UtilsMessages) {
-    //#region utils messages / compilation wrapper
-    UtilsMessages.compilationWrapper = async (fn, taskName = 'Task', executionType = 'Compilation of') => {
         /* */
         /* */
         /* */
@@ -3999,48 +3964,14 @@ var UtilsMessages;
         return (void 0);
     };
     //#endregion
-})(UtilsMessages || (UtilsMessages = {}));
-//#endregion
-//#region utils migrations
-/**
- * Taon migration utilities
- */
-var UtilsMigrations;
-(function (UtilsMigrations) {
-    UtilsMigrations.getTimestampFromClassName = (className) => {
-        const [maybeTimestamp1, maybeTimestamp2] = className.split('_') || [];
-        // console.log({ maybeTimestamp1, maybeTimestamp2 });
-        const timestamp1 = parseInt(maybeTimestamp1);
-        const timestamp2 = parseInt(maybeTimestamp2);
-        const timestamp = !_.isNaN(timestamp1) ? timestamp1 : timestamp2;
-        return UtilsMigrations.isValidTimestamp(timestamp) ? timestamp : void 0;
-    };
-    UtilsMigrations.getFormattedTimestampFromClassName = (className) => {
-        const timestamp = UtilsMigrations.getTimestampFromClassName(className);
-        if (!timestamp) {
-            return void 0;
-        }
-        return UtilsMigrations.formatTimestamp(timestamp);
-    };
-    UtilsMigrations.formatTimestamp = (timestamp) => {
-        const dateFromTimestamp = new Date(timestamp);
-        // @ts-ignore
-        return `${dateformat(dateFromTimestamp, 'dd-mm-yyyy HH:MM:ss')}`;
-    };
-    UtilsMigrations.isValidTimestamp = (value) => {
-        if (typeof value !== 'number') {
-            return false; // Must be a number
-        }
-        const minTimestamp = 0; // Minimum possible timestamp (Unix epoch)
-        const maxTimestamp = 8640000000000000; // Max safe timestamp in JS (represents year ~275760)
-        return value >= minTimestamp && value <= maxTimestamp;
-    };
-})(UtilsMigrations || (UtilsMigrations = {}));
-//#endregion
-//#region utils yaml
-var UtilsYaml;
-(function (UtilsYaml) {
-    UtilsYaml.yamlToJson = (yamlString) => {
+    //#region utils process  / start process in new graphical terminal window
+    /**
+     * TODO IMPLEMENT
+     * start async node process
+     */
+    UtilsProcess.startInNewTerminalWindow = (command, options) => {
+        /* */
+        /* */
         /* */
         /* */
         /* */
@@ -4050,9 +3981,6 @@ var UtilsYaml;
         /* */
         /* */
         /* */
-        return (void 0);
-    };
-    UtilsYaml.jsonToYaml = (json) => {
         /* */
         /* */
         /* */
@@ -4065,10 +3993,6 @@ var UtilsYaml;
         /* */
         /* */
         /* */
-        return (void 0);
-    };
-    //#region read yaml as json
-    UtilsYaml.readYamlAsJson = (absFilePathToYamlOrYmlFile, options) => {
         /* */
         /* */
         /* */
@@ -4080,131 +4004,12 @@ var UtilsYaml;
         /* */
         /* */
         /* */
-        return (void 0);
-    };
-    //#endregion
-    //#region write json to yaml
-    UtilsYaml.writeJsonToYaml = (destinationYamlfileAbsPath, json) => {
         /* */
         /* */
         /* */
         /* */
         /* */
         /* */
-        return (void 0);
-    };
-    //#endregion
-})(UtilsYaml || (UtilsYaml = {}));
-//#endregion
-//#region utils filepath metadata
-var FilePathMetaData;
-(function (FilePathMetaData) {
-    const TERMINATOR = 'xxxxx'; // terminates metadata block
-    const KV_SEPARATOR = '...'; // key/value separator
-    const PAIR_SEPARATOR = 'IxIxI'; // between pairs
-    //#region embed data into filename
-    /**
-     * Embed metadata into filename while preserving the extension.
-     *
-     * Example:
-     * embedData({ version: "1.2.3", envName: "__" }, "project.zip")
-     * -> "version|-|1.2.3||--||envName|-|__|||project.zip"
-     *
-     * keysMap = {
-     *  projectName: "pn",
-     *  envName: "en",
-     *  version: "v"
-     * }
-     */
-    FilePathMetaData.embedData = (data, orgFilename, options) => {
-        options = options || {};
-        const ext = path.extname(orgFilename);
-        const base = path.basename(orgFilename, ext);
-        const meta = Object.entries(data)
-            .map(([key, value]) => {
-            if (options.keysMap && options.keysMap[key]) {
-                key = options.keysMap[key];
-            }
-            return `${key}${KV_SEPARATOR}${value ?? ''}`;
-        })
-            .join(PAIR_SEPARATOR);
-        return `${meta}${TERMINATOR}${options.skipAddingBasenameAtEnd ? '' : base}${ext}`;
-    };
-    //#endregion
-    //#region extract data from filename
-    /**
-     * Extract metadata from filename (reverse of embedData).
-     *
-     * Example:
-     * extractData<{ version: string; env: string }>("myfile__version-1.2.3__env-prod.zip")
-     * -> { version: "1.2.3", env: "prod" }
-     *
-     * keysMap = {
-     *  projectName: "pn",
-     *  envName: "en",
-     *  version: "v"
-     * }
-     */
-    FilePathMetaData.extractData = (filename, options) => {
-        options = options || {};
-        const ext = path.extname(filename);
-        const thereIsNoExt = ext.includes('|') || ext.includes('-');
-        const base = thereIsNoExt ? filename : path.basename(filename, ext);
-        // Everything BEFORE the FIRST TERMINATOR
-        const idx = base.lastIndexOf(TERMINATOR);
-        const metaPart = idx >= 0 ? base.substring(0, idx) : base;
-        const data = {};
-        let cursor = 0;
-        while (cursor <= metaPart.length) {
-            const sepIdx = metaPart.indexOf(PAIR_SEPARATOR, cursor);
-            const segment = sepIdx === -1
-                ? metaPart.substring(cursor)
-                : metaPart.substring(cursor, sepIdx);
-            if (segment) {
-                const kvIdx = segment.indexOf(KV_SEPARATOR);
-                if (kvIdx > -1) {
-                    const key = segment.substring(0, kvIdx);
-                    const value = segment.substring(kvIdx + KV_SEPARATOR.length);
-                    let finalKey = options.keysMap
-                        ? Object.keys(options.keysMap || {}).find(k => options.keysMap[k] === key)
-                        : key;
-                    data[finalKey] = value;
-                }
-            }
-            if (sepIdx === -1)
-                break;
-            cursor = sepIdx + PAIR_SEPARATOR.length;
-        }
-        return data;
-    };
-    //#endregion
-    //#region get only metadata string
-    FilePathMetaData.getOnlyMetadataString = (filename) => {
-        const ext = path.extname(filename);
-        const base = path.basename(filename, ext);
-        const idx = base.lastIndexOf(TERMINATOR);
-        if (idx === -1)
-            return ''; // no terminator
-        const metaPart = base.substring(0, idx);
-        if (!metaPart.trim())
-            return ''; // empty metadata
-        return metaPart;
-    };
-    //#endregion
-})(FilePathMetaData || (FilePathMetaData = {}));
-//#endregion
-
-//#region imports
-//#endregion
-var UtilsProcess;
-(function (UtilsProcess) {
-    //#region utils process  / start async child process command until
-    /**
-     * This let you start child process and resolve promise when some
-     * condition is met. It is useful for example when you want to start
-     * process and wait until some output is in stdout or stderr.
-     */
-    UtilsProcess.startAsyncChildProcessCommandUntil = async (command, options) => {
         /* */
         /* */
         /* */
@@ -4277,152 +4082,11 @@ var UtilsProcess;
         return (void 0);
     };
     //#endregion
-    //#region utils process  / get git bash path
-    UtilsProcess.getGitBashPath = () => {
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        return (void 0);
-    };
-    //#endregion
-    //#region utils process  / start process in new graphical terminal window
-    /**
-     * TODO IMPLEMENT
-     * start async node process
-     */
-    UtilsProcess.startInNewTerminalWindow = (command, options) => {
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        return (void 0);
-    };
-    //#endregion
-    //#region utils process / get bash or shell name
-    UtilsProcess.getBashOrShellName = () => {
-        //#region @browser
-        return 'browser';
-        //#endregion
+    //#region utils process / get bash or shell name
+    UtilsProcess.getBashOrShellName = () => {
+        //#region @browser
+        return 'browser';
+        //#endregion
         /* */
         /* */
         /* */
@@ -7365,6 +7029,9 @@ var Helpers;
         /* */
         /* */
         /* */
+        /* */
+        /* */
+        /* */
     };
     Helpers.info = (details, repeatable = false) => {
         /* */
@@ -7410,6 +7077,9 @@ var Helpers;
         /* */
         /* */
         /* */
+        /* */
+        /* */
+        /* */
     };
     Helpers.success = (details) => {
         if (Helpers.getIsBrowser()) {
@@ -7450,6 +7120,9 @@ var Helpers;
         /* */
         /* */
         /* */
+        /* */
+        /* */
+        /* */
     };
     class ActionInstance {
         constructor(actionName) {
@@ -7528,6 +7201,9 @@ var Helpers;
         /* */
         /* */
         /* */
+        /* */
+        /* */
+        /* */
     };
     Helpers.logTaskStarted = (details) => {
         if (global.hideLog && frameworkName === 'taon') {
@@ -7587,6 +7263,9 @@ var Helpers;
         /* */
         /* */
         /* */
+        /* */
+        /* */
+        /* */
     };
     Helpers.logTaskDone = (details) => {
         if (global.hideLog && frameworkName === 'taon') {
@@ -7745,6 +7424,9 @@ var Helpers;
         /* */
         /* */
         /* */
+        /* */
+        /* */
+        /* */
     };
     const processes = [];
     Helpers.bigMaxBuffer = 2024 * 500;
@@ -9640,25 +9322,450 @@ var Helpers;
         /* */
         return (void 0);
     };
-    /**
-     * @deprecated use UtilsFilesFoldersSync.getFilesFrom
-     * return absolute paths for files inside folder or link to folder
-     */
-    Helpers.getFilesFrom = (folderOrLinkToFolder, options) => {
-        return UtilsFilesFoldersSync.getFilesFrom(folderOrLinkToFolder, options);
+    /**
+     * @deprecated use UtilsFilesFoldersSync.getFilesFrom
+     * return absolute paths for files inside folder or link to folder
+     */
+    Helpers.getFilesFrom = (folderOrLinkToFolder, options) => {
+        return UtilsFilesFoldersSync.getFilesFrom(folderOrLinkToFolder, options);
+    };
+    /**
+     * @deprecated use UtilsFilesFoldersSync.getFoldersFrom
+     * return absolute paths for folders inside folder or link to folder
+     */
+    Helpers.getFoldersFrom = (folderOrLinkToFolder, options) => {
+        return UtilsFilesFoldersSync.getFoldersFrom(folderOrLinkToFolder, options);
+    };
+    /**
+     * @deprecated use UtilsFilesFoldersSync.filesFrom
+     * return absolute paths for folders inside folders
+     */
+    Helpers.filesFrom = (pathToFolder, recrusive = false, incudeUnexistedLinks = false) => {
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        return (void 0);
+    };
+    /**
+     * @deprecated use UtilsOs.openFolderInFileExplorer
+     * @param folderPath
+     */
+    Helpers.openFolderInFileExplorer = (folderPath) => {
+        UtilsOs.openFolderInFileExplorer(folderPath);
+    };
+    Helpers.hideNodeWarnings = () => {
+        /* */
+        /* */
+        /* */
+    };
+})(Helpers || (Helpers = {}));
+
+var UtilsTime;
+(function (UtilsTime) {
+    //#region format duration
+    UtilsTime.formatDuration = (milliseconds) => {
+        const absMs = Math.abs(milliseconds);
+        const ms = absMs % 1000;
+        const totalSeconds = Math.floor(absMs / 1000);
+        const seconds = totalSeconds % 60;
+        const totalMinutes = Math.floor(totalSeconds / 60);
+        const minutes = totalMinutes % 60;
+        const hours = Math.floor(totalMinutes / 60);
+        const parts = [];
+        if (hours > 0) {
+            parts.push(`${hours}h`);
+        }
+        if (minutes > 0) {
+            parts.push(`${minutes}min`);
+        }
+        if (seconds > 0) {
+            parts.push(`${seconds}s`);
+        }
+        // show ms:
+        // - always when < 1s
+        // - otherwise only if there is remainder
+        if (ms > 0 || parts.length === 0) {
+            parts.push(`${ms}ms`);
+        }
+        return parts.join(', ');
+    };
+    //#endregion
+    //#region wait
+    UtilsTime.wait = (second) => {
+        return new Promise((resolve, reject) => {
+            setTimeout(() => {
+                resolve(void 0);
+            }, second * 1000);
+        });
+    };
+    //#endregion
+    //#region wait miliseconds
+    UtilsTime.waitMilliseconds = (milliseconds) => {
+        // Helpers.taskStarted(`Waiting ${milliseconds} milliseconds...`);
+        return new Promise((resolve, reject) => {
+            setTimeout(() => {
+                // Helpers.taskDone(`Done waiting ${milliseconds} milliseconds`);
+                resolve(void 0);
+            }, milliseconds);
+        });
+    };
+    function createResult(description, durationMs, options) {
+        const seconds = durationMs / 1000;
+        const minutes = seconds / 60;
+        const human = durationMs < 1000
+            ? `${durationMs.toFixed(2)}ms`
+            : seconds < 60
+                ? `${seconds.toFixed(2)}s`
+                : `${minutes.toFixed(2)}min`;
+        if (!options?.hideLogs) {
+            Helpers.taskDone(`Execution time for "${chalk.bold(description)}": ${chalk.bold(human)}`);
+        }
+        return {
+            milliseconds: durationMs,
+            seconds,
+            minutes,
+            human,
+        };
+    }
+    //#endregion
+    //#region mesure execution time
+    UtilsTime.mesureExecutionTime = async (description, functionToExecute, options) => {
+        if (!options?.hideLogs) {
+            Helpers.taskStarted(`Starting ${chalk.bold(description)} (measuring time)`);
+        }
+        const start = process.hrtime.bigint();
+        await functionToExecute();
+        const end = process.hrtime.bigint();
+        const durationMs = Number(end - start) / 1_000_000;
+        return createResult(description, durationMs, options);
+    };
+    //#endregion
+    //#region mesure execution time sync
+    UtilsTime.mesureExecutionTimeSync = (description, functionToExecute, options) => {
+        if (!options?.hideLogs) {
+            Helpers.taskStarted(`Starting ${chalk.bold(description)} (measuring time)`);
+        }
+        const start = process.hrtime.bigint();
+        functionToExecute();
+        const end = process.hrtime.bigint();
+        const durationMs = Number(end - start) / 1_000_000;
+        return createResult(description, durationMs, options);
+    };
+    //#endregion
+})(UtilsTime || (UtilsTime = {}));
+
+//#region imports
+//#endregion
+//#region utils
+var Utils;
+(function (Utils) {
+    //#region wait
+    Utils.wait = (second) => {
+        return UtilsTime.wait(second);
+    };
+    //#endregion
+    //#region wait miliseconds
+    Utils.waitMilliseconds = (milliseconds) => {
+        // Helpers.taskStarted(`Waiting ${milliseconds} milliseconds...`);
+        return UtilsTime.waitMilliseconds(milliseconds);
+    };
+    //#endregion
+    //#region utils / uniq array
+    Utils.uniqArray = (array, uniqueProperty) => {
+        var seen = {};
+        return array
+            .filter(f => !!f)
+            .filter(function (item) {
+            return seen.hasOwnProperty(uniqueProperty ? item[uniqueProperty] : item)
+                ? false
+                : (seen[uniqueProperty ? item[uniqueProperty] : item] = true);
+        });
+    };
+    //#endregion
+    //#region utils / recursive sort keys in object
+    /**
+     * @param anyObject
+     * @returns object with sorted keys
+     */
+    Utils.sortKeys = (anyObject) => {
+        if (_.isArray(anyObject)) {
+            return anyObject.map(Utils.sortKeys);
+        }
+        if (_.isObject(anyObject)) {
+            return _.fromPairs(_.keys(anyObject)
+                .sort()
+                .map(key => [key, Utils.sortKeys(anyObject[key])]));
+        }
+        return anyObject;
+    };
+    //#endregion
+    //#region utils / escape string for reg exp
+    /**
+     * Example:
+     * new RegExp(escapeStringForRegEx('a.b.c'),'g') => /a\.b\.c/g
+     */
+    Utils.escapeStringForRegEx = (stringForRegExp, options) => {
+        options = options || {};
+        if (options?.skipEscapeSlashAndDash) {
+            return stringForRegExp.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+        }
+        return stringForRegExp.replace(/[-\/\\^$*+?.()|[\]{}]/g, '\\$&');
+    };
+    //#endregion
+    //#region utils / remove chalk special chars
+    function removeChalkSpecialChars(str) {
+        // Regex to match ANSI escape sequences used by Chalk
+        const ansiRegex = /\u001b\[[0-9;]*m/g;
+        // Replace all ANSI escape sequences with an empty string
+        return str.replace(ansiRegex, '');
+    }
+    Utils.removeChalkSpecialChars = removeChalkSpecialChars;
+    //#endregion
+    //#region utils / full date time
+    Utils.fullDateTime = () => {
+        /* */
+        /* */
+        return (void 0);
+    };
+    //#endregion
+    //#region utils / full date
+    Utils.fullDate = () => {
+        /* */
+        /* */
+        return (void 0);
+    };
+    //#endregion
+    //#region utils / get free port
+    const takenPorts = [];
+    Utils.getFreePort = async (options) => {
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        return (void 0);
+    };
+    //#endregion
+    //#region utils / required uncached
+    /**
+     * Traverses the cache to search for all the cached
+     * files of the specified module name
+     */
+    const searchCache = (moduleName, callback) => {
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        return (void 0);
+    };
+    /**
+     * Removes a module from the cache
+     */
+    const purgeCache = moduleName => {
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        return (void 0);
+    };
+    Utils.requireUncached = (module) => {
+        /* */
+        /* */
+        /* */
+        /* */
+        return (void 0);
+    };
+    //#endregion
+    //#region utils / camelize
+    /**
+     * similar to camelCase but remove
+     * all non word / repeated characters
+     */
+    Utils.camelize = (str = '') => {
+        str = str.replace(/\W/g, '').toLowerCase();
+        return str
+            .replace(/(?:^\w|[A-Z]|\b\w)/g, function (word, index) {
+            return index == 0 ? word.toLowerCase() : word.toUpperCase();
+        })
+            .replace(/\s+/g, '');
+    };
+    //#endregion
+    //#region css
+    let css;
+    (function (css) {
+        //#region css utils / numeric value of pixels
+        /**
+         *
+         * @param pixelsCss pixels ex. 100px
+         * @returns
+         */
+        function numValue(pixelsCss) {
+            // tslint:disable-next-line:radix
+            return parseInt(pixelsCss?.toString()?.replace('px', ''));
+        }
+        css.numValue = numValue;
+        //#endregion
+    })(css = Utils.css || (Utils.css = {}));
+    //#endregion
+})(Utils || (Utils = {}));
+//#endregion
+//#region TODO IN_PROGRESS utils messages
+/**
+ * TODO @LAST @IN_PROGRESS
+ * - utils for messages
+ * - export when ready
+ * - should be ready for everything async refactor
+ */
+var UtilsMessages;
+(function (UtilsMessages) {
+    //#region utils messages / compilation wrapper
+    UtilsMessages.compilationWrapper = async (fn, taskName = 'Task', executionType = 'Compilation of') => {
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        return (void 0);
+    };
+    //#endregion
+})(UtilsMessages || (UtilsMessages = {}));
+//#endregion
+//#region utils migrations
+/**
+ * Taon migration utilities
+ */
+var UtilsMigrations;
+(function (UtilsMigrations) {
+    UtilsMigrations.getTimestampFromClassName = (className) => {
+        const [maybeTimestamp1, maybeTimestamp2] = className.split('_') || [];
+        // console.log({ maybeTimestamp1, maybeTimestamp2 });
+        const timestamp1 = parseInt(maybeTimestamp1);
+        const timestamp2 = parseInt(maybeTimestamp2);
+        const timestamp = !_.isNaN(timestamp1) ? timestamp1 : timestamp2;
+        return UtilsMigrations.isValidTimestamp(timestamp) ? timestamp : void 0;
     };
-    /**
-     * @deprecated use UtilsFilesFoldersSync.getFoldersFrom
-     * return absolute paths for folders inside folder or link to folder
-     */
-    Helpers.getFoldersFrom = (folderOrLinkToFolder, options) => {
-        return UtilsFilesFoldersSync.getFoldersFrom(folderOrLinkToFolder, options);
+    UtilsMigrations.getFormattedTimestampFromClassName = (className) => {
+        const timestamp = UtilsMigrations.getTimestampFromClassName(className);
+        if (!timestamp) {
+            return void 0;
+        }
+        return UtilsMigrations.formatTimestamp(timestamp);
     };
-    /**
-     * @deprecated use UtilsFilesFoldersSync.filesFrom
-     * return absolute paths for folders inside folders
-     */
-    Helpers.filesFrom = (pathToFolder, recrusive = false, incudeUnexistedLinks = false) => {
+    UtilsMigrations.formatTimestamp = (timestamp) => {
+        const dateFromTimestamp = new Date(timestamp);
+        // @ts-ignore
+        return `${dateformat(dateFromTimestamp, 'dd-mm-yyyy HH:MM:ss')}`;
+    };
+    UtilsMigrations.isValidTimestamp = (value) => {
+        if (typeof value !== 'number') {
+            return false; // Must be a number
+        }
+        const minTimestamp = 0; // Minimum possible timestamp (Unix epoch)
+        const maxTimestamp = 8640000000000000; // Max safe timestamp in JS (represents year ~275760)
+        return value >= minTimestamp && value <= maxTimestamp;
+    };
+})(UtilsMigrations || (UtilsMigrations = {}));
+//#endregion
+//#region utils yaml
+var UtilsYaml;
+(function (UtilsYaml) {
+    UtilsYaml.yamlToJson = (yamlString) => {
+        /* */
         /* */
         /* */
         /* */
@@ -9667,6 +9774,9 @@ var Helpers;
         /* */
         /* */
         /* */
+        return (void 0);
+    };
+    UtilsYaml.jsonToYaml = (json) => {
         /* */
         /* */
         /* */
@@ -9679,6 +9789,10 @@ var Helpers;
         /* */
         /* */
         /* */
+        return (void 0);
+    };
+    //#region read yaml as json
+    UtilsYaml.readYamlAsJson = (absFilePathToYamlOrYmlFile, options) => {
         /* */
         /* */
         /* */
@@ -9690,6 +9804,11 @@ var Helpers;
         /* */
         /* */
         /* */
+        return (void 0);
+    };
+    //#endregion
+    //#region write json to yaml
+    UtilsYaml.writeJsonToYaml = (destinationYamlfileAbsPath, json) => {
         /* */
         /* */
         /* */
@@ -9698,72 +9817,106 @@ var Helpers;
         /* */
         return (void 0);
     };
+    //#endregion
+})(UtilsYaml || (UtilsYaml = {}));
+//#endregion
+//#region utils filepath metadata
+var FilePathMetaData;
+(function (FilePathMetaData) {
+    const TERMINATOR = 'xxxxx'; // terminates metadata block
+    const KV_SEPARATOR = '...'; // key/value separator
+    const PAIR_SEPARATOR = 'IxIxI'; // between pairs
+    //#region embed data into filename
     /**
-     * @deprecated use UtilsOs.openFolderInFileExplorer
-     * @param folderPath
+     * Embed metadata into filename while preserving the extension.
+     *
+     * Example:
+     * embedData({ version: "1.2.3", envName: "__" }, "project.zip")
+     * -> "version|-|1.2.3||--||envName|-|__|||project.zip"
+     *
+     * keysMap = {
+     *  projectName: "pn",
+     *  envName: "en",
+     *  version: "v"
+     * }
      */
-    Helpers.openFolderInFileExplorer = (folderPath) => {
-        UtilsOs.openFolderInFileExplorer(folderPath);
-    };
-    Helpers.hideNodeWarnings = () => {
-        /* */
-        /* */
-        /* */
-    };
-})(Helpers || (Helpers = {}));
-
-class PROGRESS_DATA {
-    constructor() {
-        this.type = 'event';
-    }
-    static log(log) {
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-    }
-    static resolveFrom(chunk, callbackOnFounded, checkSplit = true) {
-        let progress;
-        let res = [];
-        if (!_.isString(chunk)) {
-            return [];
-        }
-        chunk = chunk.trim();
-        if (checkSplit) {
-            const split = chunk.split(/\r\n|\n|\r/);
-            if (split.length > 1) {
-                // console.log('split founded', split)
-                split.forEach(s => {
-                    res = res.concat(this.resolveFrom(s, callbackOnFounded, false));
-                });
-                return res;
+    FilePathMetaData.embedData = (data, orgFilename, options) => {
+        options = options || {};
+        const ext = path.extname(orgFilename);
+        const base = path.basename(orgFilename, ext);
+        const meta = Object.entries(data)
+            .map(([key, value]) => {
+            if (options.keysMap && options.keysMap[key]) {
+                key = options.keysMap[key];
             }
-        }
-        if (/\[\[\[.*\]\]\]/g.test(chunk)) {
-            chunk = chunk.replace(/^\[\[\[/g, '').replace(/\]\]\]$/g, '');
-            progress = chunk;
-        }
-        if (!_.isUndefined(progress)) {
-            try {
-                const p = JSON.parse(progress);
-                const single = _.merge(new PROGRESS_DATA(), p);
-                res = res.concat([single]);
-                if (_.isFunction(callbackOnFounded)) {
-                    callbackOnFounded(single);
+            return `${key}${KV_SEPARATOR}${value ?? ''}`;
+        })
+            .join(PAIR_SEPARATOR);
+        return `${meta}${TERMINATOR}${options.skipAddingBasenameAtEnd ? '' : base}${ext}`;
+    };
+    //#endregion
+    //#region extract data from filename
+    /**
+     * Extract metadata from filename (reverse of embedData).
+     *
+     * Example:
+     * extractData<{ version: string; env: string }>("myfile__version-1.2.3__env-prod.zip")
+     * -> { version: "1.2.3", env: "prod" }
+     *
+     * keysMap = {
+     *  projectName: "pn",
+     *  envName: "en",
+     *  version: "v"
+     * }
+     */
+    FilePathMetaData.extractData = (filename, options) => {
+        options = options || {};
+        const ext = path.extname(filename);
+        const thereIsNoExt = ext.includes('|') || ext.includes('-');
+        const base = thereIsNoExt ? filename : path.basename(filename, ext);
+        // Everything BEFORE the FIRST TERMINATOR
+        const idx = base.lastIndexOf(TERMINATOR);
+        const metaPart = idx >= 0 ? base.substring(0, idx) : base;
+        const data = {};
+        let cursor = 0;
+        while (cursor <= metaPart.length) {
+            const sepIdx = metaPart.indexOf(PAIR_SEPARATOR, cursor);
+            const segment = sepIdx === -1
+                ? metaPart.substring(cursor)
+                : metaPart.substring(cursor, sepIdx);
+            if (segment) {
+                const kvIdx = segment.indexOf(KV_SEPARATOR);
+                if (kvIdx > -1) {
+                    const key = segment.substring(0, kvIdx);
+                    const value = segment.substring(kvIdx + KV_SEPARATOR.length);
+                    let finalKey = options.keysMap
+                        ? Object.keys(options.keysMap || {}).find(k => options.keysMap[k] === key)
+                        : key;
+                    data[finalKey] = value;
                 }
             }
-            catch (err) {
-                const errMsg = err instanceof Error ? err.message : String(err);
-                Helpers.error(errMsg, true, true);
-                Helpers.error(`ProgresssBarData: fail to parse "${progress}"`, true, true);
-            }
+            if (sepIdx === -1)
+                break;
+            cursor = sepIdx + PAIR_SEPARATOR.length;
         }
-        return res;
-    }
-}
+        return data;
+    };
+    //#endregion
+    //#region get only metadata string
+    FilePathMetaData.getOnlyMetadataString = (filename) => {
+        const ext = path.extname(filename);
+        const base = path.basename(filename, ext);
+        const idx = base.lastIndexOf(TERMINATOR);
+        if (idx === -1)
+            return ''; // no terminator
+        const metaPart = base.substring(0, idx);
+        if (!metaPart.trim())
+            return ''; // empty metadata
+        return metaPart;
+    };
+    //#endregion
+})(FilePathMetaData || (FilePathMetaData = {}));
+//#endregion
 
 //#region imports
 //#endregion
@@ -10365,6 +10518,189 @@ var UtilsExecProc;
     //#endregion
 })(UtilsExecProc || (UtilsExecProc = {}));
 
+class ExecAsyncVscodeError extends Error {
+    constructor(options) {
+        const details = [
+            `Command failed: ${options.command}`,
+            options.cwd ? `cwd: ${options.cwd}` : undefined,
+            typeof options.exitCode === 'number'
+                ? `exit code: ${options.exitCode}`
+                : undefined,
+            options.signal ? `signal: ${options.signal}` : undefined,
+            options.stderr.trim() ? `stderr:\n${options.stderr.trim()}` : undefined,
+        ]
+            .filter(Boolean)
+            .join('\n');
+        super(details, {
+            cause: options.cause,
+        });
+        this.name = 'ExecAsyncVscodeError';
+        this.command = options.command;
+        this.cwd = options.cwd;
+        this.stdout = options.stdout;
+        this.stderr = options.stderr;
+        this.exitCode = options.exitCode;
+        this.signal = options.signal;
+    }
+}
+function execAsyncVscode(options) {
+    const { command, cwd, outputChannel, progress, cancellationToken, showCommand = true, showOutput = true, maxBuffer = 100 * 1024 * 1024, parseProgress = UtilsProgress.parseTaonProgressLine, } = options;
+    return new Promise((resolve, reject) => {
+        let stdout = '';
+        let stderr = '';
+        let previousProgress = 0;
+        let settled = false;
+        if (showCommand) {
+            outputChannel?.appendLine(`> ${command}`);
+            if (cwd) {
+                outputChannel?.appendLine(`cwd: ${cwd}`);
+            }
+        }
+        const execOptions = {
+            cwd,
+            env: {
+                ...process.env,
+                ...options.env,
+            },
+            windowsHide: true,
+            maxBuffer,
+        };
+        const proc = exec(command, execOptions, (error, finalStdout, finalStderr) => {
+            if (settled) {
+                return;
+            }
+            settled = true;
+            cancellationSubscription?.dispose();
+            /*
+             * The data listeners normally filled these already. Using the callback
+             * values as a fallback also covers unusual stream situations.
+             */
+            stdout ||= finalStdout ?? '';
+            stderr ||= finalStderr ?? '';
+            if (error) {
+                reject(new ExecAsyncVscodeError({
+                    command,
+                    cwd,
+                    stdout,
+                    stderr,
+                    exitCode: typeof error.code === 'number' ? error.code : undefined,
+                    signal: error.signal ?? undefined,
+                    cause: error,
+                }));
+                return;
+            }
+            resolve({
+                stdout,
+                stderr,
+                exitCode: 0,
+            });
+        });
+        const stdoutReader = createLineReader(line => {
+            stdout += `${line}\n`;
+            const progressData = parseProgress?.(line);
+            if (progressData) {
+                reportProgress(progressData);
+                return;
+            }
+            options.onStdoutLine?.(line);
+            if (showOutput && line) {
+                outputChannel?.appendLine(line);
+            }
+        });
+        const stderrReader = createLineReader(line => {
+            stderr += `${line}\n`;
+            const progressData = parseProgress?.(line);
+            if (progressData) {
+                reportProgress(progressData);
+                return;
+            }
+            options.onStderrLine?.(line);
+            if (showOutput && line) {
+                outputChannel?.appendLine(`[stderr] ${line}`);
+            }
+        });
+        proc.stdout?.setEncoding('utf8');
+        proc.stderr?.setEncoding('utf8');
+        proc.stdout?.on('data', stdoutReader.push);
+        proc.stderr?.on('data', stderrReader.push);
+        proc.stdout?.on('end', stdoutReader.flush);
+        proc.stderr?.on('end', stderrReader.flush);
+        proc.stdout?.on('error', error => {
+            outputChannel?.appendLine(`[stdout stream error] ${error.stack ?? error.message}`);
+        });
+        proc.stderr?.on('error', error => {
+            outputChannel?.appendLine(`[stderr stream error] ${error.stack ?? error.message}`);
+        });
+        proc.once('error', error => {
+            outputChannel?.appendLine(`[process error] ${error.stack ?? error.message}`);
+        });
+        const cancellationSubscription = cancellationToken?.onCancellationRequested(() => {
+            if (settled) {
+                return;
+            }
+            outputChannel?.appendLine(`Cancelling command: ${command}`);
+            terminateChild(proc);
+        });
+        function reportProgress(data) {
+            const message = data.message?.trim();
+            if (typeof data.value === 'number') {
+                const currentProgress = Math.max(previousProgress, Math.min(100, data.value));
+                progress?.report({
+                    message,
+                    increment: currentProgress - previousProgress,
+                });
+                previousProgress = currentProgress;
+            }
+            else if (message) {
+                progress?.report({
+                    message,
+                });
+            }
+            if (message && showOutput) {
+                outputChannel?.appendLine(`[${data.type ?? 'event'}] ${message}`);
+            }
+        }
+    });
+}
+function terminateChild(proc) {
+    if (!proc.pid || proc.killed) {
+        return;
+    }
+    if (process.platform === 'win32') {
+        /*
+         * exec() creates a shell. Killing only proc.kill() can leave descendants
+         * such as Node/ONNX alive, so terminate the process tree.
+         */
+        exec(`taskkill /pid ${proc.pid} /t /f`, {
+            windowsHide: true,
+        }, () => undefined);
+        return;
+    }
+    proc.kill('SIGTERM');
+}
+function createLineReader(onLine) {
+    let pending = '';
+    const push = (chunk) => {
+        pending += chunk.toString();
+        const lines = pending.split(/\r\n|\n|\r/);
+        pending = lines.pop() ?? '';
+        for (const line of lines) {
+            onLine(line);
+        }
+    };
+    const flush = () => {
+        if (!pending) {
+            return;
+        }
+        onLine(pending);
+        pending = '';
+    };
+    return {
+        push,
+        flush,
+    };
+}
+
 //#region imports
 //#endregion
 var UtilsNetwork;
@@ -13140,5 +13476,5 @@ var index = {};
  * Generated bundle index. Do not edit.
  */
 
-export { $, BaselineSiteJoinprefix, CLI, CoreConfig, CoreModels, DbBinaryFormatEnum, FilePathMetaData, FilesNames, GlobalLibTypeName, GlobalStorage, GlobalTaskManager, GlobalTaskManagerClass, Helpers, LibTypeArr, LibTypeEnum, PREFIXES, PROGRESS_DATA, REGEX_REGION, TAGS, Utils, UtilsBinary, UtilsCli, UtilsCliClassMethod, UtilsDotFile, UtilsEtcHosts, UtilsExecProc, UtilsFilesFolders, UtilsFilesFoldersSync, UtilsI18n, UtilsJson, UtilsMessages, UtilsMigrations, UtilsNetwork, UtilsOs, UtilsProcess, UtilsProcessLogger, UtilsProjects, UtilsStdinStdoutLogger, UtilsString, UtilsStringRegex, UtilsSudo, UtilsTerminal, UtilsTime, UtilsWaitNotifier, UtilsYaml, _, appRelatedFiles, areTrustedForPatchUpdate, backendNodejsOnlyFiles, backendWebsqlNodejsFiles, baseTaonDevProjectsNames, chalk, child_process, chokidar, config, crossPlatformPath, dateformat, dockerTemplates, dotTaonFolder, dotTnpFolder, encoding, extAllowedToExportAndReplaceTSJSCodeFiles, extAllowedToReplace, extForSassLikeFiles, extForStyles, extTemplatesFiles, fg, fileName, filesNotAllowedToClean, fkill, folderName, frameworkName, frameworkNameBe, frontEndOnly, frontendFiles, fse, glob, globalSpinner, http, https, isCloudflareWorker, isElevated, load, mkdirp, ncp, net, notAllowedNames, notAllowedProjectNames, notNeededForExportFiles, os, path, ps, psList, requireDefault, requiredForDev, rimraf, spawn, startAsync, taonActionFromParent, taonBasePathToGlobalDockerTemplatesFn, taonContainers, taonPackageName, taonProjects, taonRepoPathUserInUserDirFn, tempFoldersName, tnpPackageName, urlRepoTaon, urlRepoTaonContainers, win32Path };
+export { $, BaselineSiteJoinprefix, CLI, CoreConfig, CoreModels, DbBinaryFormatEnum, ExecAsyncVscodeError, FilePathMetaData, FilesNames, GlobalLibTypeName, GlobalStorage, GlobalTaskManager, GlobalTaskManagerClass, Helpers, LibTypeArr, LibTypeEnum, PREFIXES, REGEX_REGION, TAGS, Utils, UtilsBinary, UtilsCli, UtilsCliClassMethod, UtilsDotFile, UtilsEtcHosts, UtilsExecProc, UtilsFilesFolders, UtilsFilesFoldersSync, UtilsI18n, UtilsJson, UtilsMessages, UtilsMigrations, UtilsNetwork, UtilsOs, UtilsProcess, UtilsProcessLogger, UtilsProgress, UtilsProjects, UtilsStdinStdoutLogger, UtilsString, UtilsStringRegex, UtilsSudo, UtilsTerminal, UtilsTime, UtilsWaitNotifier, UtilsYaml, _, appRelatedFiles, areTrustedForPatchUpdate, backendNodejsOnlyFiles, backendWebsqlNodejsFiles, baseTaonDevProjectsNames, chalk, child_process, chokidar, config, crossPlatformPath, dateformat, dockerTemplates, dotTaonFolder, dotTnpFolder, encoding, execAsyncVscode, extAllowedToExportAndReplaceTSJSCodeFiles, extAllowedToReplace, extForSassLikeFiles, extForStyles, extTemplatesFiles, fg, fileName, filesNotAllowedToClean, fkill, folderName, frameworkName, frameworkNameBe, frontEndOnly, frontendFiles, fse, glob, globalSpinner, http, https, isCloudflareWorker, isElevated, load, mkdirp, ncp, net, notAllowedNames, notAllowedProjectNames, notNeededForExportFiles, os, path, ps, psList, requireDefault, requiredForDev, rimraf, spawn, startAsync, taonActionFromParent, taonBasePathToGlobalDockerTemplatesFn, taonContainers, taonPackageName, taonProjects, taonRepoPathUserInUserDirFn, tempFoldersName, tnpPackageName, urlRepoTaon, urlRepoTaonContainers, win32Path };
 //# sourceMappingURL=tnp-core-browser.mjs.map