@yamato-daiwa/es-extensions-nodejs 1.9.0-alpha.1 → 1.9.0-alpha.2

package/Distributable/ConsoleApplicationLogger.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const es_extensions_1 = require("@yamato-daiwa/es-extensions");
 class ConsoleApplicationLogger {
+    static localization = es_extensions_1.loggerLocalization__english;
     static setLocalization(localization) {
         ConsoleApplicationLogger.localization = localization;
         return ConsoleApplicationLogger;
@@ -411,7 +412,6 @@ class ConsoleApplicationLogger {
         return `\x1b[48;2;${colorDefinition.red};${colorDefinition.green};${colorDefinition.blue}m`;
     }
 }
-ConsoleApplicationLogger.localization = es_extensions_1.loggerLocalization__english;
 (function (ConsoleApplicationLogger) {
     let FourBitColours;
     (function (FourBitColours) {

package/Distributable/ConsoleCommandsParser/ConsoleCommandsParser.js

@@ -8,6 +8,16 @@ const es_extensions_1 = require("@yamato-daiwa/es-extensions");
 const InvalidConsoleCommandError_1 = __importDefault(require("../Errors/InvalidConsoleCommand/InvalidConsoleCommandError"));
 const ConsoleCommandsParserLocalization_english_1 = __importDefault(require("./ConsoleCommandsParserLocalization.english"));
 class ConsoleCommandsParser {
+    static localization = ConsoleCommandsParserLocalization_english_1.default;
+    static MINIMAL_ARGUMENTS_COUNT_IN_VALID_CONSOLE_COMMAND = 2;
+    static PARSING_METHOD_INVOCATION_EXPRESSION = "ConsoleCommandsParser.parse(commandLineInterfaceSpecification, argumentsVector)";
+    applicationName;
+    targetCommandPhrase;
+    targetCommandPhraseDescription;
+    isTargetCommandPhraseDefault;
+    targetCommandOptions;
+    targetCommandOptionsWhichHasNotBeenProcessedYet = [];
+    targetCommandOptionsSpecification;
     static parse(commandLineInterfaceSpecification, argumentsVector = process.argv) {
         ConsoleCommandsParser.validateCommandLineInterfaceSpecification(commandLineInterfaceSpecification);
         if (!Array.isArray(argumentsVector)) {
@@ -99,7 +109,6 @@ class ConsoleCommandsParser {
         return textSegments.join("");
     }
     constructor({ commandLineInterfaceSpecification, consciouslyInputtedArguments }) {
-        this.targetCommandOptionsWhichHasNotBeenProcessedYet = [];
         const helpReference = ConsoleCommandsParser.generateFullHelpReference(commandLineInterfaceSpecification);
         const firstConsciouslyInputtedArgument = consciouslyInputtedArguments[0];
         let defaultCommandPhrase;
@@ -681,9 +690,6 @@ class ConsoleCommandsParser {
         }
     }
 }
-ConsoleCommandsParser.localization = ConsoleCommandsParserLocalization_english_1.default;
-ConsoleCommandsParser.MINIMAL_ARGUMENTS_COUNT_IN_VALID_CONSOLE_COMMAND = 2;
-ConsoleCommandsParser.PARSING_METHOD_INVOCATION_EXPRESSION = "ConsoleCommandsParser.parse(commandLineInterfaceSpecification, argumentsVector)";
 (function (ConsoleCommandsParser) {
     let ParametersTypes;
     (function (ParametersTypes) {

package/Distributable/DateTime/NodeJS_Timer.js

@@ -1,46 +1,34 @@
 "use strict";
-var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
-    if (kind === "m") throw new TypeError("Private method is not writable");
-    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
-    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
-    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
-};
-var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
-    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
-    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
-    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
-};
-var _NodeJS_Timer_nativeTimeout, _NodeJS_Timer_secondsLeft, _NodeJS_Timer_isActive;
 Object.defineProperty(exports, "__esModule", { value: true });
 const es_extensions_1 = require("@yamato-daiwa/es-extensions");
 class NodeJS_Timer extends es_extensions_1.Timer {
+    #nativeTimeout;
+    #secondsLeft = this.period__seconds;
+    #isActive = false;
     constructor(compoundParameter) {
         super(compoundParameter);
-        _NodeJS_Timer_nativeTimeout.set(this, void 0);
-        _NodeJS_Timer_secondsLeft.set(this, this.period__seconds);
-        _NodeJS_Timer_isActive.set(this, false);
     }
     countDown({ asynchronousCompletion = es_extensions_1.Timer.AsynchronousCompletions.promise } = {}) {
         if (this.isActive) {
             return;
         }
-        __classPrivateFieldSet(this, _NodeJS_Timer_isActive, true, "f");
+        this.#isActive = true;
         const promise = new Promise((resolve) => {
-            __classPrivateFieldSet(this, _NodeJS_Timer_nativeTimeout, setInterval(() => {
+            this.#nativeTimeout = setInterval(() => {
                 if (this.mustStop) {
-                    __classPrivateFieldSet(this, _NodeJS_Timer_isActive, false, "f");
-                    window.clearInterval(__classPrivateFieldGet(this, _NodeJS_Timer_nativeTimeout, "f"));
+                    this.#isActive = false;
+                    window.clearInterval(this.#nativeTimeout);
                     resolve(es_extensions_1.Timer.Outcomes.stopped);
                     return;
                 }
-                __classPrivateFieldSet(this, _NodeJS_Timer_secondsLeft, __classPrivateFieldGet(this, _NodeJS_Timer_secondsLeft, "f") - 1, "f");
-                if (__classPrivateFieldGet(this, _NodeJS_Timer_secondsLeft, "f") === 0) {
-                    __classPrivateFieldSet(this, _NodeJS_Timer_isActive, false, "f");
-                    __classPrivateFieldSet(this, _NodeJS_Timer_secondsLeft, this.period__seconds, "f");
-                    clearInterval(__classPrivateFieldGet(this, _NodeJS_Timer_nativeTimeout, "f"));
+                this.#secondsLeft = this.#secondsLeft - 1;
+                if (this.#secondsLeft === 0) {
+                    this.#isActive = false;
+                    this.#secondsLeft = this.period__seconds;
+                    clearInterval(this.#nativeTimeout);
                     resolve(es_extensions_1.Timer.Outcomes.elapsed);
                 }
-            }, (0, es_extensions_1.secondsToMilliseconds)(1)), "f");
+            }, (0, es_extensions_1.secondsToMilliseconds)(1));
         });
         if (asynchronousCompletion === es_extensions_1.Timer.AsynchronousCompletions.promise) {
             return promise;
@@ -58,17 +46,16 @@ class NodeJS_Timer extends es_extensions_1.Timer {
         });
     }
     resetAndRestart({ asynchronousCompletion = es_extensions_1.Timer.AsynchronousCompletions.promise } = {}) {
-        clearInterval(__classPrivateFieldGet(this, _NodeJS_Timer_nativeTimeout, "f"));
-        __classPrivateFieldSet(this, _NodeJS_Timer_isActive, false, "f");
-        __classPrivateFieldSet(this, _NodeJS_Timer_secondsLeft, this.period__seconds, "f");
+        clearInterval(this.#nativeTimeout);
+        this.#isActive = false;
+        this.#secondsLeft = this.period__seconds;
         if (asynchronousCompletion === es_extensions_1.Timer.AsynchronousCompletions.promise) {
             return this.countDown({ asynchronousCompletion: es_extensions_1.Timer.AsynchronousCompletions.promise });
         }
         this.countDown({ asynchronousCompletion: es_extensions_1.Timer.AsynchronousCompletions.callback });
     }
     get isActive() {
-        return __classPrivateFieldGet(this, _NodeJS_Timer_isActive, "f");
+        return this.#isActive;
     }
 }
-_NodeJS_Timer_nativeTimeout = new WeakMap(), _NodeJS_Timer_secondsLeft = new WeakMap(), _NodeJS_Timer_isActive = new WeakMap();
 exports.default = NodeJS_Timer;

package/Distributable/Errors/FileNotFoundError/FileNotFoundError.js

@@ -6,6 +6,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const FileNotFoundErrorLocalization_english_1 = __importDefault(require("./FileNotFoundErrorLocalization.english"));
 const es_extensions_1 = require("@yamato-daiwa/es-extensions");
 class FileNotFoundError extends Error {
+    static NAME = "FileNotFoundError";
+    static localization = FileNotFoundErrorLocalization_english_1.default;
     constructor(constructorParameter) {
         super();
         this.name = FileNotFoundError.NAME;
@@ -16,6 +18,4 @@ class FileNotFoundError extends Error {
                     (0, es_extensions_1.insertSubstring)(constructorParameter.messageSpecificPart, { modifier: (messageSpecificPart) => ` ${messageSpecificPart}` });
     }
 }
-FileNotFoundError.NAME = "FileNotFoundError";
-FileNotFoundError.localization = FileNotFoundErrorLocalization_english_1.default;
 exports.default = FileNotFoundError;

package/Distributable/Errors/InvalidConsoleCommand/InvalidConsoleCommandError.js

@@ -6,6 +6,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const InvalidConsoleCommandErrorLocalization_english_1 = __importDefault(require("./InvalidConsoleCommandErrorLocalization.english"));
 const es_extensions_1 = require("@yamato-daiwa/es-extensions");
 class InvalidConsoleCommandError extends Error {
+    static NAME = "InvalidConsoleCommandError";
+    static localization = InvalidConsoleCommandErrorLocalization_english_1.default;
     constructor(constructorParameter) {
         super();
         this.name = InvalidConsoleCommandError.NAME;
@@ -16,6 +18,4 @@ class InvalidConsoleCommandError extends Error {
                     (0, es_extensions_1.insertSubstring)(constructorParameter.messageSpecificPart, { modifier: (messageSpecificPart) => ` ${messageSpecificPart}` });
     }
 }
-InvalidConsoleCommandError.NAME = "InvalidConsoleCommandError";
-InvalidConsoleCommandError.localization = InvalidConsoleCommandErrorLocalization_english_1.default;
 exports.default = InvalidConsoleCommandError;

package/Distributable/Errors/PathRefersToDirectoryNotFileError/PathRefersToDirectoryNotFileError.js

@@ -6,6 +6,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const PathRefersToDirectoryNotFileErrorLocalization_english_1 = __importDefault(require("./PathRefersToDirectoryNotFileErrorLocalization.english"));
 const es_extensions_1 = require("@yamato-daiwa/es-extensions");
 class PathRefersToDirectoryNotFileError extends Error {
+    static NAME = "PathRefersToDirectoryNotFileError";
+    static localization = PathRefersToDirectoryNotFileErrorLocalization_english_1.default;
     constructor(constructorParameter) {
         super();
         this.name = PathRefersToDirectoryNotFileError.NAME;
@@ -16,6 +18,4 @@ class PathRefersToDirectoryNotFileError extends Error {
                     (0, es_extensions_1.insertSubstring)(constructorParameter.messageSpecificPart, { modifier: (messageSpecificPart) => ` ${messageSpecificPart}` });
     }
 }
-PathRefersToDirectoryNotFileError.NAME = "PathRefersToDirectoryNotFileError";
-PathRefersToDirectoryNotFileError.localization = PathRefersToDirectoryNotFileErrorLocalization_english_1.default;
 exports.default = PathRefersToDirectoryNotFileError;

package/Distributable/ImprovedPath/ImprovedPath.js

@@ -1,15 +1,4 @@
 "use strict";
-var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
-    if (kind === "m") throw new TypeError("Private method is not writable");
-    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
-    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
-    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
-};
-var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
-    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
-    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
-    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
-};
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
@@ -158,51 +147,50 @@ class ImprovedPath {
     }
 }
 (function (ImprovedPath) {
-    var _ParsingResult_rawPath, _ParsingResult_root, _ParsingResult_root__forwardSlashesSeparators, _ParsingResult_directory, _ParsingResult_directory__forwardSlashesSeparators, _ParsingResult_directoryExplodedToPathSegments;
     class ParsingResult {
+        #rawPath;
+        #root;
+        #root__forwardSlashesSeparators;
+        #directory;
+        #directory__forwardSlashesSeparators;
+        #directoryExplodedToPathSegments;
         constructor(namedParameters) {
-            _ParsingResult_rawPath.set(this, void 0);
-            _ParsingResult_root.set(this, void 0);
-            _ParsingResult_root__forwardSlashesSeparators.set(this, void 0);
-            _ParsingResult_directory.set(this, void 0);
-            _ParsingResult_directory__forwardSlashesSeparators.set(this, void 0);
-            _ParsingResult_directoryExplodedToPathSegments.set(this, void 0);
-            __classPrivateFieldSet(this, _ParsingResult_rawPath, namedParameters.rawPath, "f");
+            this.#rawPath = namedParameters.rawPath;
             if (namedParameters.nativeParsedPath.root.length > 0) {
-                __classPrivateFieldSet(this, _ParsingResult_root, namedParameters.nativeParsedPath.root, "f");
-                __classPrivateFieldSet(this, _ParsingResult_root__forwardSlashesSeparators, (0, es_extensions_1.replaceDoubleBackslashesWithForwardSlashes)(__classPrivateFieldGet(this, _ParsingResult_root, "f")), "f");
+                this.#root = namedParameters.nativeParsedPath.root;
+                this.#root__forwardSlashesSeparators = (0, es_extensions_1.replaceDoubleBackslashesWithForwardSlashes)(this.#root);
             }
             else {
-                __classPrivateFieldSet(this, _ParsingResult_root, null, "f");
-                __classPrivateFieldSet(this, _ParsingResult_root__forwardSlashesSeparators, null, "f");
+                this.#root = null;
+                this.#root__forwardSlashesSeparators = null;
             }
             if (namedParameters.nativeParsedPath.dir.length > 0) {
-                __classPrivateFieldSet(this, _ParsingResult_directory, namedParameters.nativeParsedPath.dir, "f");
-                __classPrivateFieldSet(this, _ParsingResult_directory__forwardSlashesSeparators, (0, es_extensions_1.replaceDoubleBackslashesWithForwardSlashes)(__classPrivateFieldGet(this, _ParsingResult_directory, "f")), "f");
-                __classPrivateFieldSet(this, _ParsingResult_directoryExplodedToPathSegments, [
-                    ...__classPrivateFieldGet(this, _ParsingResult_directory__forwardSlashesSeparators, "f").startsWith("/") ? ["/"] : [],
-                    ...(0, es_extensions_1.splitString)(__classPrivateFieldGet(this, _ParsingResult_directory__forwardSlashesSeparators, "f"), "/").
+                this.#directory = namedParameters.nativeParsedPath.dir;
+                this.#directory__forwardSlashesSeparators = (0, es_extensions_1.replaceDoubleBackslashesWithForwardSlashes)(this.#directory);
+                this.#directoryExplodedToPathSegments = [
+                    ...this.#directory__forwardSlashesSeparators.startsWith("/") ? ["/"] : [],
+                    ...(0, es_extensions_1.splitString)(this.#directory__forwardSlashesSeparators, "/").
                         filter((pathSegment) => pathSegment.length > 0)
-                ], "f");
+                ];
             }
             else {
-                __classPrivateFieldSet(this, _ParsingResult_directory, null, "f");
-                __classPrivateFieldSet(this, _ParsingResult_directory__forwardSlashesSeparators, null, "f");
-                __classPrivateFieldSet(this, _ParsingResult_directoryExplodedToPathSegments, [], "f");
+                this.#directory = null;
+                this.#directory__forwardSlashesSeparators = null;
+                this.#directoryExplodedToPathSegments = [];
             }
         }
         get root() {
-            return __classPrivateFieldGet(this, _ParsingResult_root, "f");
+            return this.#root;
         }
         get root__forwardSlashesSeparators() {
-            return __classPrivateFieldGet(this, _ParsingResult_root__forwardSlashesSeparators, "f");
+            return this.#root__forwardSlashesSeparators;
         }
         getRootExpectedToExist(namedParameters) {
             const root = namedParameters?.alwaysForwardSlashesSeparators === true ?
-                __classPrivateFieldGet(this, _ParsingResult_root__forwardSlashesSeparators, "f") : __classPrivateFieldGet(this, _ParsingResult_root, "f");
+                this.#root__forwardSlashesSeparators : this.#root;
             if ((0, es_extensions_1.isNull)(root)) {
                 es_extensions_1.Logger.throwErrorWithFormattedMessage({
-                    errorInstance: new es_extensions_1.UnexpectedEventError(`Contrary to expectations, the root is not exists on path '${__classPrivateFieldGet(this, _ParsingResult_rawPath, "f")}'.`),
+                    errorInstance: new es_extensions_1.UnexpectedEventError(`Contrary to expectations, the root is not exists on path '${this.#rawPath}'.`),
                     title: es_extensions_1.UnexpectedEventError.localization.defaultTitle,
                     occurrenceLocation: "ImprovedPath.ParsedPath.getRootExpectedToBeExists(namedParameters)"
                 });
@@ -210,17 +198,17 @@ class ImprovedPath {
             return root;
         }
         get directory() {
-            return __classPrivateFieldGet(this, _ParsingResult_directory, "f");
+            return this.#directory;
         }
         get directory__forwardSlashesSeparators() {
-            return __classPrivateFieldGet(this, _ParsingResult_directory__forwardSlashesSeparators, "f");
+            return this.#directory__forwardSlashesSeparators;
         }
         getDirectoryExpectedToExist(namedParameters) {
             const directory = namedParameters?.alwaysForwardSlashesSeparators === true ?
-                __classPrivateFieldGet(this, _ParsingResult_directory__forwardSlashesSeparators, "f") : __classPrivateFieldGet(this, _ParsingResult_directory, "f");
+                this.#directory__forwardSlashesSeparators : this.#directory;
             if ((0, es_extensions_1.isNull)(directory)) {
                 es_extensions_1.Logger.throwErrorWithFormattedMessage({
-                    errorInstance: new es_extensions_1.UnexpectedEventError(`Contrary to expectations, the directory is not exists on path '${__classPrivateFieldGet(this, _ParsingResult_rawPath, "f")}'.`),
+                    errorInstance: new es_extensions_1.UnexpectedEventError(`Contrary to expectations, the directory is not exists on path '${this.#rawPath}'.`),
                     title: es_extensions_1.UnexpectedEventError.localization.defaultTitle,
                     occurrenceLocation: "ImprovedPath.ParsedPath.getDirectoryExpectedToExist(namedParameters)"
                 });
@@ -228,10 +216,9 @@ class ImprovedPath {
             return directory;
         }
         get directoryExplodedToPathSegments() {
-            return __classPrivateFieldGet(this, _ParsingResult_directoryExplodedToPathSegments, "f");
+            return this.#directoryExplodedToPathSegments;
         }
     }
-    _ParsingResult_rawPath = new WeakMap(), _ParsingResult_root = new WeakMap(), _ParsingResult_root__forwardSlashesSeparators = new WeakMap(), _ParsingResult_directory = new WeakMap(), _ParsingResult_directory__forwardSlashesSeparators = new WeakMap(), _ParsingResult_directoryExplodedToPathSegments = new WeakMap();
     ImprovedPath.ParsingResult = ParsingResult;
 })(ImprovedPath || (ImprovedPath = {}));
 exports.default = ImprovedPath;

package/Distributable/ObjectDataFilesProcessor/ObjectDataFilesProcessor.js

@@ -14,6 +14,7 @@ const FileNotFoundError_1 = __importDefault(require("../Errors/FileNotFoundError
 const PathRefersToDirectoryNotFileError_1 = __importDefault(require("../Errors/PathRefersToDirectoryNotFileError/PathRefersToDirectoryNotFileError"));
 const ObjectDataFilesProcessorLocalization_english_1 = __importDefault(require("./ObjectDataFilesProcessorLocalization.english"));
 class ObjectDataFilesProcessor {
+    static localization = ObjectDataFilesProcessorLocalization_english_1.default;
     static processFile(compoundParameter) {
         const filePath = compoundParameter.filePath;
         let dataSchema;
@@ -216,7 +217,6 @@ class ObjectDataFilesProcessor {
         return processingResult.processedData;
     }
 }
-ObjectDataFilesProcessor.localization = ObjectDataFilesProcessorLocalization_english_1.default;
 (function (ObjectDataFilesProcessor) {
     let SupportedSchemas;
     (function (SupportedSchemas) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yamato-daiwa/es-extensions-nodejs",
-  "version": "1.9.0-alpha.1",
+  "version": "1.9.0-alpha.2",
   "description": "Additional to @yamato-daiwa/es-extensions functionality for Node.js environment. Helper functions and classes aimed to reduce the routine code. Build-in TypeScript type safety.",
   "keywords": [
     "nodejs",
@@ -29,10 +29,10 @@
     "Distributable"
   ],
   "engines": {
-    "node": ">=20.0.0"
+    "node": ">=22.0.0"
   },
   "peerDependencies": {
-    "@yamato-daiwa/es-extensions": "1.9.0-alpha.1"
+    "@yamato-daiwa/es-extensions": "1.9.0-alpha.2"
   },
   "dependencies": {
     "dotenv": "17.3.1",
@@ -45,18 +45,18 @@
     "@types/json5": "0.0.30",
     "@types/node": "22.15.31",
     "@types/yamljs": "0.2.34",
-    "@yamato-daiwa/es-extensions": "1.9.0-alpha.1",
-    "@yamato-daiwa/style_guides": "0.11.6",
+    "@yamato-daiwa/es-extensions": "1.9.0-alpha.2",
+    "@yamato-daiwa/style_guides": "0.13.0",
     "rimraf": "6.1.3",
     "tsx": "4.21.0",
-    "typescript": "5.9.3"
+    "typescript": "6.0.2"
   },
   "scripts": {
     "Check Types": "tsc --noEmit",
     "Lint": "eslint Source Tests",
     "Run Tests": "node --require tsx/cjs --test \"Tests/**/*.test.ts\"",
-    "Rebuild Distributable Without Preliminary Cleaning": "tsc",
-    "Rebuild Distributable": "rimraf Distributable && tsc",
+    "Rebuild Distributable Without Preliminary Cleaning": "tsc -p tsconfig.build.json",
+    "Rebuild Distributable": "rimraf Distributable && tsc -p tsconfig.build.json",
     "Rebuild Distributable and Realize Alpha": "npm run \"Rebuild Distributable\" && npm publish --tag alpha",
     "Rebuild Distributable and Realize RC": "npm run \"Rebuild Distributable\" && npm publish --tag rc"
   },