tnp-core 21.0.134 → 21.0.136

package/browser/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tnp-core/browser",
-  "version": "21.0.134",
+  "version": "21.0.136",
   "peerDependencies": {
     "@angular/common": "^21.0.0",
     "@angular/core": "^21.0.0"

package/browser/types/tnp-core-browser.d.ts

@@ -1094,6 +1094,9 @@ declare namespace CoreModels {
      */
     export const parentLocation = "parent-location";
     export const hasExitCleaningFunction = "has-exit-cleaning-function-for";
+    export type DeepPartial<T> = {
+        [K in keyof T]?: T[K] extends object ? DeepPartial<T[K]> : T[K];
+    };
     export {};
 }
 
@@ -1149,64 +1152,6 @@ declare namespace Utils {
      * all non word / repeated characters
      */
     const camelize: (str?: string) => string;
-    enum DbBinaryFormatEnum {
-        Blob = "Blob",
-        File = "File",
-        string = "string"
-    }
-    type DbBinaryFormatForBrowser = Blob | File | string;
-    /**
-     * Binary format that can be stored in database
-     *
-     * for nodejs => Buffer
-     * for sql.js => string (shoulb be blob - but not supported)
-     *
-     */
-    type DbBinaryFormat = DbBinaryFormatForBrowser;
-    namespace binary {
-        /**
-         * This is for BROWSER ONLY
-         *
-         * @param buffer
-         * @param contentType
-         * @returns
-         */
-        function arrayBufferToBlob(buffer: ArrayBuffer, contentType: CoreModels.ContentType): Promise<Blob>;
-        /**
-         * This is for BROWSER ONLY
-         * @param blob
-         * @returns
-         */
-        function blobToArrayBuffer(blob: Blob): Promise<ArrayBuffer>;
-        /**
-         * it is revers to base64toBlob
-         * @param blob
-         * @returns
-         */
-        function blobToBase64(blob: Blob): Promise<string>;
-        /**
-         * it is revers to blobToBase64()
-         * @param base64Data
-         * @returns
-         */
-        function base64toBlob(base64Data: string, contentTypeOverride?: CoreModels.ContentType): Promise<Blob>;
-        function base64toDbBinaryFormat(text: string): Promise<DbBinaryFormat>;
-        function dbBinaryFormatToBase64(binaryFormat: DbBinaryFormat): Promise<string>;
-        function textToDbBinaryFormat(text: string): Promise<DbBinaryFormat>;
-        function dbBinaryFormatToText(binaryFormat: DbBinaryFormat): Promise<string>;
-        function fileToBlob(file: File): Promise<Blob>;
-        function blobToFile(blob: Blob, nameForFile?: string): Promise<File>;
-        function textToBlob(text: string, type?: CoreModels.ContentType): Promise<Blob>;
-        function blobToText(blob: Blob): Promise<string>;
-        function textToFile(text: string, fileRelativePathOrName: string): Promise<File>;
-        function fileToText(file: File): Promise<string>;
-        function jsonToBlob(jsonObj: object): Promise<Blob>;
-        /**
-         * TODO NOT TESTED
-         */
-        function blobToJson(blob: Blob): Promise<string>;
-        function getBlobFrom(url: string): Promise<Blob>;
-    }
     namespace css {
         /**
          *
@@ -1216,25 +1161,6 @@ declare namespace Utils {
         function numValue(pixelsCss: string | number): number;
     }
 }
-declare namespace UtilsTime {
-    const formatDuration: (milliseconds: number) => string;
-    const wait: (second: number) => Promise<void>;
-    const waitMilliseconds: (milliseconds: number) => Promise<void>;
-    interface MeasureOptions {
-        hideLogs?: boolean;
-    }
-    interface ExecutionTimeResult {
-        readonly milliseconds: number;
-        readonly seconds: number;
-        readonly minutes: number;
-        readonly human: string;
-    }
-    const mesureExecutionTime: <T>(description: string, functionToExecute: () => Promise<T>, options?: MeasureOptions) => Promise<ExecutionTimeResult>;
-    const mesureExecutionTimeSync: <T>(description: string, functionToExecute: () => T, options?: MeasureOptions) => ExecutionTimeResult;
-}
-declare namespace UtilsStringRegex {
-    const containsNonAscii: (pathStringOrPathParts: string) => boolean;
-}
 /**
  * TODO @LAST @IN_PROGRESS
  * - utils for messages
@@ -1244,41 +1170,6 @@ declare namespace UtilsStringRegex {
 declare namespace UtilsMessages {
     const compilationWrapper: (fn: () => any, taskName?: string, executionType?: "Compilation of" | "Code execution of" | "Event:") => Promise<void>;
 }
-declare namespace UtilsSudo {
-    /**
-     * All possible sudo states on Windows 11 (24H2+)
-     */
-    enum SudoStatus {
-        NotInstalled = "NotInstalled",
-        Disabled = "Disabled",
-        Enabled_ForceNewWindow = "Enabled_ForceNewWindow",// Enabled = 2
-        Enabled_Inline = "Enabled_Inline",// Enabled = 3 ← current default
-        Unknown = "Unknown"
-    }
-    /**
-     * @returns true if current process is elevated (admin or sudo root), false otherwise
-     */
-    export const isCurrentProcessElevated: () => Promise<boolean>;
-    /**
-     * Main function – returns detailed sudo status
-     */
-    export function getStatus(): Promise<{
-        status: SudoStatus;
-        label: string;
-        isAvailable: boolean;
-        isInline: boolean;
-    }>;
-    /**
-     * check if sudo is available and in proper mode
-     */
-    export const isInProperModeForTaon: ({ displayErrorMessage, }: {
-        displayErrorMessage?: boolean;
-    }) => Promise<boolean>;
-    export {};
-}
-declare namespace UtilsString {
-    const kebabCaseNoSplitNumbers: (input: string) => string;
-}
 /**
  * Taon migration utilities
  */
@@ -1288,28 +1179,6 @@ declare namespace UtilsMigrations {
     const formatTimestamp: (timestamp: number) => string;
     const isValidTimestamp: (value: any) => boolean;
 }
-declare namespace UtilsJson {
-    interface AttrJsoncProp {
-        name: string;
-        value?: any;
-    }
-    /**
-     * ! TODO handle packages like zone.js with dot
-     * Get attributes from jsonc or json5 file
-     * @param jsonDeepPath lodash path to property in json ex. deep.path.to.prop
-     * @param fileContent jsonc or json5 - json with comments
-     * @returns array of attributes
-     */
-    const getAtrributiesFromJsonWithComments: (jsonDeepPath: string, // lodash path to property in json ex. deep.path.to.prop
-    fileContent: string) => AttrJsoncProp[];
-    const getAttributiesFromComment: (comment: string, attributes?: AttrJsoncProp[]) => AttrJsoncProp[];
-    /**
-     * read json from absolute path
-     * @returns json object
-     */
-    const readJson: (absoluteFilePath: string | string[], defaultValue?: {}, useJson5?: boolean) => any;
-    const readJsonWithComments: (absoluteFilePath: string | string[], defaultValue?: any) => any;
-}
 declare namespace UtilsYaml {
     const yamlToJson: <FORMAT = any>(yamlString: string) => any;
     const jsonToYaml: (json: any) => string;
@@ -1354,64 +1223,6 @@ declare namespace FilePathMetaData {
     }) => T;
     const getOnlyMetadataString: (filename: string) => string;
 }
-declare namespace UtilsDotFile {
-    const setValueToDotFile: (dotFileAbsPath: string | string[], key: string, value: string | number | boolean) => void;
-    const setCommentToKeyInDotFile: (dotFileAbsPath: string | string[], key: string, comment: string) => void;
-    const getValueFromDotFile: (dotFileAbsPath: string | string[], key: string) => string | number | boolean;
-    const addCommentAtTheBeginningOfDotFile: (dotFileAbsPath: string | string[], comment: string) => void;
-    const setValuesKeysFromObject: (dotFileAbsPath: string | string[], obj: Record<string, string | number | boolean>, options?: {
-        /**
-         * if true, it will overwrite existing keys
-         */
-        setAsNewFile?: boolean;
-    }) => void;
-    const getValuesKeysAsJsonObject: <T = Record<string, string | number | boolean>>(dotFileAbsPath: string | string[]) => T;
-    /**
-     * @returns key|comment pairs as json object
-     */
-    const getCommentsKeysAsJsonObject: <T = Record<string, string | undefined>>(dotFileAbsPath: string | string[]) => T;
-}
-declare namespace UtilsCli {
-    /**
-     * Taon CLI specyfic mehtod for mesuring script execution time:
-     * from beginning of script to this moment.
-     */
-    const getTimeFromThisCLIScriptStart: () => {
-        ms: string;
-        sec: string;
-        min: string;
-    };
-}
-/**
- * Easy way to connect CLI commands to cli class methods.
- *
- * Example:
- * in clic class
- *
- * $FirstCli {
- *   static [UtilsCliClassMethod.staticClassNameProperty] = '$FirstCli';
- *
- *   @UtilsCliClassMethod.decoratorMethod('doSomething')
- *   doSomething() {
- *     console.log('doing something');
- *   }
- * }
- *
- * UtilsCliClassMethod.getFrom($FirstCli.prototype.doSomething) // "firstcli:dosomething"
- *
- */
-declare namespace UtilsCliClassMethod {
-    const decoratorMethod: (methodName: string) => MethodDecorator;
-    const getFrom: <ARGS_TO_PARSE extends object = any>(ClassPrototypeMethodFnHere: Function, options?: {
-        globalMethod?: boolean;
-        /**
-         * arguments to parse into CLI format
-         * Example: { projectName: "myproj", envName: "prod" } => "--projectName=myproj --envName=prod"
-         * TODO @LAST add support for DEEP args parsing with lodash-walk-object
-         */
-        argsToParse?: ARGS_TO_PARSE;
-    }) => string;
-}
 
 declare namespace UtilsEtcHosts {
     const SIMULATE_DOMAIN_TAG = "@simulatedDomainByTaon";
@@ -1757,6 +1568,7 @@ declare namespace UtilsOs {
     const isRunningInWsl: () => boolean;
     const isRunningInWindowsPowerShell: () => boolean;
     const isRunningInWindowsCmd: () => boolean;
+    const isRunningInWindowsGitBash: () => boolean;
     const isRunningInDocker: () => boolean;
     const isRunningInLinuxGraphicsCapableEnvironment: () => boolean;
     const isRunningInOsWithGraphicsCapableEnvironment: () => boolean;
@@ -1831,6 +1643,7 @@ declare namespace UtilsOs {
         doneCallback?: () => any;
     }) => Promise<void>;
     function safeExitProgramCleanUp(cleanFn: () => Promise<void> | void): any;
+    const whichOrWherePackageLocated: (packageName: string) => string | undefined;
 }
 declare const taonRepoPathUserInUserDirFn: () => string;
 declare const taonBasePathToGlobalDockerTemplatesFn: () => string;
@@ -2572,6 +2385,244 @@ interface ProcessStartOptions {
  */
 declare const startAsync: (command: string, cwd: string, options?: Partial<ProcessStartOptions>) => Promise<void>;
 
+declare namespace UtilsTime {
+    const formatDuration: (milliseconds: number) => string;
+    const wait: (second: number) => Promise<void>;
+    const waitMilliseconds: (milliseconds: number) => Promise<void>;
+    interface MeasureOptions {
+        hideLogs?: boolean;
+    }
+    interface ExecutionTimeResult {
+        readonly milliseconds: number;
+        readonly seconds: number;
+        readonly minutes: number;
+        readonly human: string;
+    }
+    const mesureExecutionTime: <T>(description: string, functionToExecute: () => Promise<T>, options?: MeasureOptions) => Promise<ExecutionTimeResult>;
+    const mesureExecutionTimeSync: <T>(description: string, functionToExecute: () => T, options?: MeasureOptions) => ExecutionTimeResult;
+}
+
+declare namespace UtilsSudo {
+    /**
+     * All possible sudo states on Windows 11 (24H2+)
+     */
+    enum SudoStatus {
+        NotInstalled = "NotInstalled",
+        Disabled = "Disabled",
+        Enabled_ForceNewWindow = "Enabled_ForceNewWindow",// Enabled = 2
+        Enabled_Inline = "Enabled_Inline",// Enabled = 3 ← current default
+        Unknown = "Unknown"
+    }
+    /**
+     * @returns true if current process is elevated (admin or sudo root), false otherwise
+     */
+    export const isCurrentProcessElevated: () => Promise<boolean>;
+    /**
+     * Main function – returns detailed sudo status
+     */
+    export function getStatus(): Promise<{
+        status: SudoStatus;
+        label: string;
+        isAvailable: boolean;
+        isInline: boolean;
+    }>;
+    /**
+     * check if sudo is available and in proper mode
+     */
+    export const isInProperModeForTaon: ({ displayErrorMessage, }: {
+        displayErrorMessage?: boolean;
+    }) => Promise<boolean>;
+    export {};
+}
+
+declare namespace UtilsCli {
+    /**
+     * Taon CLI specyfic mehtod for mesuring script execution time:
+     * from beginning of script to this moment.
+     */
+    const getTimeFromThisCLIScriptStart: () => {
+        ms: string;
+        sec: string;
+        min: string;
+    };
+}
+/**
+ * Easy way to connect CLI commands to cli class methods.
+ *
+ * Example:
+ * in clic class
+ *
+ * $FirstCli {
+ *   static [UtilsCliClassMethod.staticClassNameProperty] = '$FirstCli';
+ *
+ *   @UtilsCliClassMethod.decoratorMethod('doSomething')
+ *   doSomething() {
+ *     console.log('doing something');
+ *   }
+ * }
+ *
+ * UtilsCliClassMethod.getFrom($FirstCli.prototype.doSomething) // "firstcli:dosomething"
+ *
+ */
+declare namespace UtilsCliClassMethod {
+    const decoratorMethod: (methodName: string) => MethodDecorator;
+    const getFrom: <ARGS_TO_PARSE extends object = any>(ClassPrototypeMethodFnHere: Function, options?: {
+        globalMethod?: boolean;
+        /**
+         * arguments to parse into CLI format
+         * Example: { projectName: "myproj", envName: "prod" } => "--projectName=myproj --envName=prod"
+         * TODO @LAST add support for DEEP args parsing with lodash-walk-object
+         */
+        argsToParse?: ARGS_TO_PARSE;
+    }) => string;
+}
+
+declare namespace UtilsJson {
+    interface AttrJsoncProp {
+        name: string;
+        value?: any;
+    }
+    /**
+     * ! TODO handle packages like zone.js with dot
+     * Get attributes from jsonc or json5 file
+     * @param jsonDeepPath lodash path to property in json ex. deep.path.to.prop
+     * @param fileContent jsonc or json5 - json with comments
+     * @returns array of attributes
+     */
+    const getAtrributiesFromJsonWithComments: (jsonDeepPath: string, // lodash path to property in json ex. deep.path.to.prop
+    fileContent: string) => AttrJsoncProp[];
+    const getAttributiesFromComment: (comment: string, attributes?: AttrJsoncProp[]) => AttrJsoncProp[];
+    /**
+     * read json from absolute path
+     * @returns json object
+     */
+    const readJson: (absoluteFilePath: string | string[], defaultValue?: {}, useJson5?: boolean) => any;
+    const readJsonWithComments: (absoluteFilePath: string | string[], defaultValue?: any) => any;
+}
+
+declare namespace UtilsDotFile {
+    const setValueToDotFile: (dotFileAbsPath: string | string[], key: string, value: string | number | boolean) => void;
+    const setCommentToKeyInDotFile: (dotFileAbsPath: string | string[], key: string, comment: string) => void;
+    const getValueFromDotFile: (dotFileAbsPath: string | string[], key: string) => string | number | boolean;
+    const addCommentAtTheBeginningOfDotFile: (dotFileAbsPath: string | string[], comment: string) => void;
+    const setValuesKeysFromObject: (dotFileAbsPath: string | string[], obj: Record<string, string | number | boolean>, options?: {
+        /**
+         * if true, it will overwrite existing keys
+         */
+        setAsNewFile?: boolean;
+    }) => void;
+    const getValuesKeysAsJsonObject: <T = Record<string, string | number | boolean>>(dotFileAbsPath: string | string[]) => T;
+    /**
+     * @returns key|comment pairs as json object
+     */
+    const getCommentsKeysAsJsonObject: <T = Record<string, string | undefined>>(dotFileAbsPath: string | string[]) => T;
+}
+
+declare enum DbBinaryFormatEnum {
+    Blob = "Blob",
+    File = "File",
+    string = "string"
+}
+type DbBinaryFormatForBrowser = Blob | File | string;
+/**
+ * Binary format that can be stored in database
+ *
+ * for nodejs => Buffer
+ * for sql.js => string (shoulb be blob - but not supported)
+ *
+ */
+type DbBinaryFormat = DbBinaryFormatForBrowser;
+declare namespace UtilsBinary {
+    /**
+     * This is for BROWSER ONLY
+     *
+     * @param buffer
+     * @param contentType
+     * @returns
+     */
+    function arrayBufferToBlob(buffer: ArrayBuffer, contentType: CoreModels.ContentType): Promise<Blob>;
+    /**
+     * This is for BROWSER ONLY
+     * @param blob
+     * @returns
+     */
+    function blobToArrayBuffer(blob: Blob): Promise<ArrayBuffer>;
+    /**
+     * it is revers to base64toBlob
+     * @param blob
+     * @returns
+     */
+    function blobToBase64(blob: Blob): Promise<string>;
+    /**
+     * it is revers to blobToBase64()
+     * @param base64Data
+     * @returns
+     */
+    function base64toBlob(base64Data: string, contentTypeOverride?: CoreModels.ContentType): Promise<Blob>;
+    function base64toDbBinaryFormat(text: string): Promise<DbBinaryFormat>;
+    function dbBinaryFormatToBase64(binaryFormat: DbBinaryFormat): Promise<string>;
+    function textToDbBinaryFormat(text: string): Promise<DbBinaryFormat>;
+    function dbBinaryFormatToText(binaryFormat: DbBinaryFormat): Promise<string>;
+    function fileToBlob(file: File): Promise<Blob>;
+    function blobToFile(blob: Blob, nameForFile?: string): Promise<File>;
+    function textToBlob(text: string, type?: CoreModels.ContentType): Promise<Blob>;
+    function blobToText(blob: Blob): Promise<string>;
+    function textToFile(text: string, fileRelativePathOrName: string): Promise<File>;
+    function fileToText(file: File): Promise<string>;
+    function jsonToBlob(jsonObj: object): Promise<Blob>;
+    /**
+     * TODO NOT TESTED
+     */
+    function blobToJson(blob: Blob): Promise<string>;
+    function getBlobFrom(url: string): Promise<Blob>;
+}
+
+declare namespace UtilsString {
+    const kebabCaseNoSplitNumbers: (input: string) => string;
+}
+declare namespace UtilsStringRegex {
+    const containsNonAscii: (pathStringOrPathParts: string) => boolean;
+}
+
+declare namespace UtilsI18n {
+    const defaultLangLocale: UtilsI18n.CommonLocaleCode;
+    enum CommonLocaleCodeEnum {
+        PL_PL = "pl-PL",
+        EN_US = "en-US",
+        EN_GB = "en-GB",
+        DE_DE = "de-DE",
+        FR_FR = "fr-FR",
+        ES_ES = "es-ES",
+        ZH_CN = "zh-CN"
+    }
+    const commonLocales: CommonLocaleCode[];
+    type CommonLocaleCode = `${CommonLocaleCodeEnum}`;
+    interface LangOption {
+        code: UtilsI18n.CommonLocaleCode;
+        label: string;
+    }
+    const LangOptionArr: LangOption[];
+    function detectLocale(): CommonLocaleCode;
+    interface GettextExtracted {
+        lineNumber: number;
+        gettextString: string;
+        context?: string;
+        /**
+         * translation for specyfic language
+         */
+        translation?: string;
+    }
+    interface GettextFile {
+        fileAbsPath: string;
+        fileRelativePath?: string;
+        /**
+         * taon thing - file can be for app or lib
+         */
+        isAppFile?: boolean;
+        tags: UtilsI18n.GettextExtracted[];
+    }
+}
+
 declare class CLI {
     static chalk: chalk$1.Chalk;
     static installEnvironment(globalDependencies?: any): void;
@@ -3115,5 +3166,5 @@ declare const config: {
     helpAlias: string[];
 };
 
-export { $, BaselineSiteJoinprefix, CLI, CoreConfig, CoreModels, FilePathMetaData, FilesNames, GlobalLibTypeName, GlobalStorage, GlobalTaskManager, GlobalTaskManagerClass, Helpers, LibTypeArr, LibTypeEnum, PREFIXES, PROGRESS_DATA, REGEX_REGION, TAGS, Utils, UtilsCli, UtilsCliClassMethod, UtilsDotFile, UtilsEtcHosts, UtilsExecProc, UtilsFilesFolders, UtilsFilesFoldersSync, UtilsJson, UtilsMessages, UtilsMigrations, UtilsNetwork, UtilsOs, UtilsProcess, UtilsProcessLogger, UtilsProjects, 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 type { CommandOutputOptions, IPROGRESS_DATA, LibTypeNames, ProcessStartOptions, RunSyncOrAsyncOptions, TaskStats };
+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, 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 type { CommandOutputOptions, DbBinaryFormat, DbBinaryFormatForBrowser, IPROGRESS_DATA, LibTypeNames, ProcessStartOptions, RunSyncOrAsyncOptions, TaskStats };