yini-parser 1.0.0-alpha.7x → 1.0.0-beta.1

package/dist/core/objectBuilder.js

@@ -2,34 +2,34 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.constructFinalObject = void 0;
 const env_1 = require("../config/env");
-const system_1 = require("../utils/system");
+const print_1 = require("../utils/print");
 /**
  * Construct the final result of a JavaScript Object.
  */
 const constructFinalObject = (syntaxTreeC, errorHandler) => {
-    (0, system_1.debugPrint)('-> constructFinalObject(..)');
+    (0, print_1.debugPrint)('-> constructFinalObject(..)');
     const bulder = new Builder(syntaxTreeC, errorHandler);
     if ((0, env_1.isDebug)()) {
         console.log('Argument, syntaxTreeC:');
-        (0, system_1.printObject)(syntaxTreeC);
+        (0, print_1.printObject)(syntaxTreeC);
     }
     const jsObject = bulder.doCheckAndBuild();
-    (0, system_1.debugPrint)('<- About to leave constructFinalObject(..)');
+    (0, print_1.debugPrint)('<- About to leave constructFinalObject(..)');
     if ((0, env_1.isDebug)()) {
         console.log('Returning, jsObject:');
-        (0, system_1.printObject)(syntaxTreeC);
+        (0, print_1.printObject)(syntaxTreeC);
     }
     return jsObject;
 };
 exports.constructFinalObject = constructFinalObject;
 class Builder {
     constructor(syntaxTreeC, errorHandler) {
-        (0, system_1.debugPrint)('-> Builder: constructor(..)');
+        (0, print_1.debugPrint)('-> Builder: constructor(..)');
         this.syntaxTreeC = syntaxTreeC;
         this.errorHandler = errorHandler;
     }
     doCheckAndBuild() {
-        (0, system_1.debugPrint)('-> Builder: doCheckAndBuild(..)');
+        (0, print_1.debugPrint)('-> Builder: doCheckAndBuild(..)');
         if (!this.syntaxTreeC) {
             // Note, after pushing processing may continue or exit, depending on the error and/or the bail threshold.
             this.errorHandler.pushOrBail(null, 'Fatal-Error', 'SyntaxTreeC is undefined', 'This is most likely caused by an internal error somewhere. The process cannot recover fully from this, sorry.');
@@ -39,46 +39,46 @@ class Builder {
         return jsObject;
     }
     buildFullSubTrees(syntaxTreeC) {
-        (0, system_1.debugPrint)('-> Builder: buildFullSubTrees(..)');
+        (0, print_1.debugPrint)('-> Builder: buildFullSubTrees(..)');
         (0, env_1.isDebug)() && console.log();
         const fullSubTreeList = []; // List of FULL sub-trees.
         // Current Working Full Sub-Tree (starting at level 1).
         let workingFullSubTree = syntaxTreeC._syntaxTree[0]; // (!) Any tree MUST START at level 1.
-        (0, system_1.debugPrint)(`Setted new workingFullSubTree, from syntaxTreeC._syntaxTree[0]`);
+        (0, print_1.debugPrint)(`Setted new workingFullSubTree, from syntaxTreeC._syntaxTree[0]`);
         const len = syntaxTreeC._syntaxTree.length;
         for (let i = 1; i < len; i++) {
             const currentChainC = syntaxTreeC._syntaxTree[i];
             const level = currentChainC.originLevel;
             const nestingIndex = level - 1; // For debugging purposes.
             const chain = currentChainC.chain; // For debugging purposes.
-            (0, system_1.debugPrint)(`Got new chain from syntaxTreeC._syntaxTree[${i}] to be mounted onto parent...`);
-            (0, system_1.debugPrint)('* level: ' + level + ' (i=' + i + '), chain: ' + chain);
+            (0, print_1.debugPrint)(`Got new chain from syntaxTreeC._syntaxTree[${i}] to be mounted onto parent...`);
+            (0, print_1.debugPrint)('* level: ' + level + ' (i=' + i + '), chain: ' + chain);
             if (level === 1) {
-                (0, system_1.debugPrint)('HIT - Detected that currentChain starts with level 1');
+                (0, print_1.debugPrint)('HIT - Detected that currentChain starts with level 1');
                 fullSubTreeList.push(workingFullSubTree);
-                (0, system_1.debugPrint)('The workingFullSubTree is finished, pushed it to the list.');
+                (0, print_1.debugPrint)('The workingFullSubTree is finished, pushed it to the list.');
                 workingFullSubTree = syntaxTreeC._syntaxTree[i]; // (!) The tree MUST START at level 1.
-                (0, system_1.debugPrint)(`Setted new workingFullSubTree, from syntaxTreeC._syntaxTree[${i}]`);
+                (0, print_1.debugPrint)(`Setted new workingFullSubTree, from syntaxTreeC._syntaxTree[${i}]`);
             }
             else {
-                (0, system_1.debugPrint)('About to mount currentChain onto workingFullSubTree at correct level...');
+                (0, print_1.debugPrint)('About to mount currentChain onto workingFullSubTree at correct level...');
                 workingFullSubTree = this.mountChainOntoLevel(currentChainC, workingFullSubTree);
             }
-            (0, system_1.debugPrint)();
+            (0, print_1.debugPrint)();
         }
         fullSubTreeList.push(workingFullSubTree);
         if ((0, env_1.isDebug)()) {
             console.log();
             console.log('--- fullSubTreeList: (list of FULL sub-trees.) -------');
-            (0, system_1.printObject)(fullSubTreeList);
+            (0, print_1.printObject)(fullSubTreeList);
             console.log();
         }
         return fullSubTreeList;
     }
     mountChainOntoLevel(chainC, workingSubTree) {
-        (0, system_1.debugPrint)('-> Builder: mountChainOntoLevel(..)');
+        (0, print_1.debugPrint)('-> Builder: mountChainOntoLevel(..)');
         if ((0, env_1.isDebug)()) {
-            (0, system_1.printObject)(chainC);
+            (0, print_1.printObject)(chainC);
         }
         if (chainC.originLevel > 1) {
             // NOP
@@ -86,36 +86,36 @@ class Builder {
         else {
             // Note, after pushing processing may continue or exit, depending on the error and/or the bail threshold.
             this.errorHandler.pushOrBail(null, 'Fatal-Error', 'Internal-Error: Detected incorrect chain in mountChainOntoLevel(..), start section has level: ' +
-                chainC.originLevel, 'The (chain) must start with a section level higher than 1', '' + (0, system_1.printObject)(chainC));
+                chainC.originLevel, 'The (chain) must start with a section level higher than 1', '' + (0, print_1.printObject)(chainC));
         }
         if (workingSubTree.originLevel != 1) {
             // Note, after pushing processing may continue or exit, depending on the error and/or the bail threshold.
             this.errorHandler.pushOrBail(null, 'Fatal-Error', 'Internal-Error: Detected incorrect full sub-tree in mountChainOntoLevel(..), start section has level: ' +
-                chainC.originLevel, 'A full sub-tree (chain) must start with a section at level 1', '' + (0, system_1.printObject)(chainC));
+                chainC.originLevel, 'A full sub-tree (chain) must start with a section at level 1', '' + (0, print_1.printObject)(chainC));
         }
         const chain = chainC.chain;
         const targetLevel = chainC.originLevel;
         if ((0, env_1.isDebug)()) {
-            (0, system_1.debugPrint)('Target level = ' + targetLevel);
-            (0, system_1.debugPrint)(`The chain to mount: (onto level: ${targetLevel})`);
-            (0, system_1.printObject)(chain);
-            (0, system_1.debugPrint)('--- workingFullSubTree: -------');
-            (0, system_1.debugPrint)('Before mounting onto workingSubTree.chain:');
-            (0, system_1.printObject)(workingSubTree.chain);
+            (0, print_1.debugPrint)('Target level = ' + targetLevel);
+            (0, print_1.debugPrint)(`The chain to mount: (onto level: ${targetLevel})`);
+            (0, print_1.printObject)(chain);
+            (0, print_1.debugPrint)('--- workingFullSubTree: -------');
+            (0, print_1.debugPrint)('Before mounting onto workingSubTree.chain:');
+            (0, print_1.printObject)(workingSubTree.chain);
         }
-        (0, system_1.debugPrint)('Mount currentChain onto workingFullSubTree.');
+        (0, print_1.debugPrint)('Mount currentChain onto workingFullSubTree.');
         workingSubTree.chain = mountObjectAtLevel(workingSubTree.chain, chain, targetLevel, this.errorHandler);
         if ((0, env_1.isDebug)()) {
-            (0, system_1.debugPrint)('After mounting onto workingSubTree.chain:');
-            (0, system_1.printObject)(workingSubTree.chain);
-            (0, system_1.debugPrint)('----------');
+            (0, print_1.debugPrint)('After mounting onto workingSubTree.chain:');
+            (0, print_1.printObject)(workingSubTree.chain);
+            (0, print_1.debugPrint)('----------');
         }
-        (0, system_1.debugPrint)('<- Builder: mountChainOntoLevel(..)');
+        (0, print_1.debugPrint)('<- Builder: mountChainOntoLevel(..)');
         return workingSubTree;
     }
     // Contruct the final JS object from the list of full sub-trees.
     buildObjectFromList(fullSubTreeList) {
-        (0, system_1.debugPrint)('-> Builder: buildObjectFromList(..)');
+        (0, print_1.debugPrint)('-> Builder: buildObjectFromList(..)');
         const jsObject = {};
         for (const chainC of fullSubTreeList) {
             if (chainC.originLevel === 1) {
@@ -132,7 +132,7 @@ class Builder {
             else {
                 // Note, after pushing processing may continue or exit, depending on the error and/or the bail threshold.
                 this.errorHandler.pushOrBail(null, 'Fatal-Error', 'Internal-Error: Detected incorrect full sub-tree in buildObjectFromList(..), start section has level: ' +
-                    chainC.originLevel, 'A full sub-tree (chain) must start with a section at level 1', '' + (0, system_1.printObject)(chainC));
+                    chainC.originLevel, 'A full sub-tree (chain) must start with a section at level 1', '' + (0, print_1.printObject)(chainC));
             }
         }
         return jsObject;
@@ -163,14 +163,14 @@ const mountObjectAtLevel = (objectSrc, objectDest, level, errorHandler) => {
         current = current[nextKey];
         currentLevel++;
     }
-    (0, system_1.debugPrint)('--------');
-    (0, system_1.debugPrint)('   current = ' + (0, system_1.toPrettyJSON)(current));
+    (0, print_1.debugPrint)('--------');
+    (0, print_1.debugPrint)('   current = ' + (0, print_1.toPrettyJSON)(current));
     const [firstKey] = Object.keys(objectDest);
-    (0, system_1.debugPrint)('objectDest = ' + firstKey);
+    (0, print_1.debugPrint)('objectDest = ' + firstKey);
     if (Object.prototype.hasOwnProperty.call(current, firstKey)) {
         //@todo Add metadata with line number, onto chainC, so can use line number in error reporting
-        (0, system_1.debugPrint)(`(!) sectionName already exist, name: "${firstKey}", in: `);
-        (0, system_1.debugPrint)((0, system_1.toPrettyJSON)(current));
+        (0, print_1.debugPrint)(`(!) sectionName already exist, name: "${firstKey}", in: `);
+        (0, print_1.debugPrint)((0, print_1.toPrettyJSON)(current));
         // Note, after pushing processing may continue or exit, depending on the error and/or the bail threshold.
         errorHandler.pushOrBail(null, 'Syntax-Error', 'Section name already exists', 'Cannot redefine section name: "' +
             firstKey +

package/dist/grammar/YiniLexer.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-// Generated from grammar/v1.0.0-beta.7x/YiniLexer.g4 by ANTLR 4.13.2
+// Generated from grammar/v1.0.0-rc.1/YiniLexer.g4 by ANTLR 4.13.2
 // noinspection ES6UnusedImports,JSUnusedGlobalSymbols,JSUnusedLocalSymbols
 const antlr4_1 = require("antlr4");
 class YiniLexer extends antlr4_1.Lexer {

package/dist/grammar/YiniParser.d.ts

@@ -206,7 +206,7 @@ export declare class ObjectMemberListContext extends ParserRuleContext {
 export declare class ObjectMemberContext extends ParserRuleContext {
     constructor(parser?: YiniParser, parent?: ParserRuleContext, invokingState?: number);
     KEY(): TerminalNode;
-    EQ(): TerminalNode;
+    COLON(): TerminalNode;
     value(): ValueContext;
     WS(): TerminalNode;
     NL_list(): TerminalNode[];

package/dist/grammar/YiniParser.js

@@ -1,5 +1,5 @@
 "use strict";
-// Generated from grammar/v1.0.0-beta.7x/YiniParser.g4 by ANTLR 4.13.2
+// Generated from grammar/v1.0.0-rc.1/YiniParser.g4 by ANTLR 4.13.2
 // noinspection ES6UnusedImports,JSUnusedGlobalSymbols,JSUnusedLocalSymbols
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Empty_listContext = exports.Empty_objectContext = exports.Boolean_literalContext = exports.String_concatContext = exports.String_literalContext = exports.Null_literalContext = exports.Number_literalContext = exports.ElementContext = exports.ElementsContext = exports.List_in_bracketsContext = exports.ListContext = exports.ObjectMemberContext = exports.ObjectMemberListContext = exports.Object_literalContext = exports.ValueContext = exports.Member_colon_listContext = exports.MemberContext = exports.Section_membersContext = exports.Terminal_lineContext = exports.SectionContext = exports.YiniContext = void 0;
@@ -799,7 +799,7 @@ class YiniParser extends antlr4_1.Parser {
                     }
                 }
                 this.state = 220;
-                this.match(YiniParser.EQ);
+                this.match(YiniParser.COLON);
                 this.state = 224;
                 this._errHandler.sync(this);
                 _la = this._input.LA(1);
@@ -1628,7 +1628,7 @@ YiniParser._serializedATN = [4, 1, 46, 347, 2, 0, 7, 0, 2,
     3, 38, 19, 0, 208, 210, 5, 39, 0, 0, 209, 208, 1, 0, 0, 0, 210, 213, 1, 0, 0, 0, 211, 209, 1, 0,
     0, 0, 211, 212, 1, 0, 0, 0, 212, 215, 1, 0, 0, 0, 213, 211, 1, 0, 0, 0, 214, 190, 1, 0, 0, 0, 214,
     207, 1, 0, 0, 0, 215, 17, 1, 0, 0, 0, 216, 218, 5, 29, 0, 0, 217, 219, 5, 41, 0, 0, 218, 217, 1,
-    0, 0, 0, 218, 219, 1, 0, 0, 0, 219, 220, 1, 0, 0, 0, 220, 224, 5, 9, 0, 0, 221, 223, 5, 39, 0, 0,
+    0, 0, 0, 218, 219, 1, 0, 0, 0, 219, 220, 1, 0, 0, 0, 220, 224, 5, 12, 0, 0, 221, 223, 5, 39, 0, 0,
     222, 221, 1, 0, 0, 0, 223, 226, 1, 0, 0, 0, 224, 222, 1, 0, 0, 0, 224, 225, 1, 0, 0, 0, 225, 227,
     1, 0, 0, 0, 226, 224, 1, 0, 0, 0, 227, 228, 3, 12, 6, 0, 228, 19, 1, 0, 0, 0, 229, 232, 3, 24, 12,
     0, 230, 232, 3, 22, 11, 0, 231, 229, 1, 0, 0, 0, 231, 230, 1, 0, 0, 0, 232, 21, 1, 0, 0, 0, 233,
@@ -2005,8 +2005,8 @@ class ObjectMemberContext extends antlr4_1.ParserRuleContext {
     KEY() {
         return this.getToken(YiniParser.KEY, 0);
     }
-    EQ() {
-        return this.getToken(YiniParser.EQ, 0);
+    COLON() {
+        return this.getToken(YiniParser.COLON, 0);
     }
     value() {
         return this.getTypedRuleContext(ValueContext, 0);

package/dist/grammar/YiniParserVisitor.js

@@ -1,5 +1,5 @@
 "use strict";
-// Generated from grammar/v1.0.0-beta.7x/YiniParser.g4 by ANTLR 4.13.2
+// Generated from grammar/v1.0.0-rc.1/YiniParser.g4 by ANTLR 4.13.2
 Object.defineProperty(exports, "__esModule", { value: true });
 const antlr4_1 = require("antlr4");
 /**

package/dist/index.js

@@ -17,20 +17,20 @@ exports.parseFile = exports.parse = void 0;
     /END
 */
 const env_1 = require("./config/env");
-const system_1 = require("./utils/system");
+const print_1 = require("./utils/print");
 const YINI_1 = __importDefault(require("./YINI"));
 // export { default } from './YINI'
 exports.parse = YINI_1.default.parse;
 exports.parseFile = YINI_1.default.parseFile;
 exports.default = YINI_1.default;
-(0, system_1.debugPrint)();
-(0, system_1.debugPrint)('-> Entered index.ts');
-(0, system_1.debugPrint)();
+(0, print_1.debugPrint)();
+(0, print_1.debugPrint)('-> Entered index.ts');
+(0, print_1.debugPrint)();
 if ((0, env_1.isDev)() || (0, env_1.isDebug)()) {
     console.log(`process.env?.NODE_ENV = '${(_a = process.env) === null || _a === void 0 ? void 0 : _a.NODE_ENV}'`);
     console.log(`process.env?.APP_ENV  = '${(_b = process.env) === null || _b === void 0 ? void 0 : _b.APP_ENV}'`);
     console.log(`process.env?.IS_DEBUG = '${(_c = process.env) === null || _c === void 0 ? void 0 : _c.IS_DEBUG}'`);
-    (0, system_1.debugPrint)();
+    (0, print_1.debugPrint)();
     console.log(`localNodeEnv = '${env_1.localNodeEnv}'`);
     console.log(` localAppEnv = '${env_1.localAppEnv}'`);
     console.log(' isProdEnv() = ' + (0, env_1.isProdEnv)());
@@ -45,9 +45,9 @@ const debugTestObj = {
     name: 'e_test',
     lang: 'TypeScript',
 };
-(0, system_1.debugPrint)('debugTestObj:');
-(0, system_1.debugPrint)(debugTestObj);
-(0, system_1.debugPrint)();
+(0, print_1.debugPrint)('debugTestObj:');
+(0, print_1.debugPrint)(debugTestObj);
+(0, print_1.debugPrint)();
 if ((0, env_1.isProdEnv)()) {
     // Do nothing, and exit.
 }
@@ -176,33 +176,9 @@ Expected JS output:
         //     title = "My Program"
         // `
         const yini = `
-/*
-    nested.yini
-    Demonstrates nested sections in YINI format.
-*/
-
-@yini
-
-^ App                  // Top-level section: App
-name = 'Nested Demo App'
-version = "1.2.3"
-
-    ^^ Theme           // Nested under App: App.Theme
-    primaryColor = #336699
-    darkMode = true
-
-
-        ^^^ Overrides  // Nested under Theme: App.Theme.Overrides
-        darkMode = false
-        fontSize = 14
-
-^ Database             // Another top-level section: Database
-host = "db.local"
-port = 5432
-
-    ^^ Credentials     // Nested under Database: Database.Credentials    username = "admin"
-    password = "secret"
-            `;
+            ^ Database
+            pool = { max: 10, min: 2 }
+        `;
         YINI_1.default.parse(yini);
         //         YINI.parse(`
         // ^ Section1

package/dist/parseEntry.js

@@ -11,14 +11,14 @@ const objectBuilder_1 = require("./core/objectBuilder");
 const YINIVisitor_1 = __importDefault(require("./core/YINIVisitor"));
 const YiniLexer_1 = __importDefault(require("./grammar/YiniLexer"));
 const YiniParser_1 = __importDefault(require("./grammar/YiniParser"));
-const system_1 = require("./utils/system");
+const print_1 = require("./utils/print");
 class MyErrorListener {
     constructor(errorHandler) {
         this.errors = [];
         this.errorHandler = errorHandler;
     }
     syntaxError(recognizer, offendingSymbol, line, charPositionInLine, msg, e) {
-        (0, system_1.debugPrint)('ANTLR grammar cached an error');
+        (0, print_1.debugPrint)('ANTLR grammar cached an error');
         this.errors.push(`Line ${line}:${charPositionInLine} ${msg}`);
         const msgWhat = `Syntax error, at line: ${line}`;
         const msgWhy = `At about column ${1 + charPositionInLine} ${msg}`;
@@ -36,10 +36,10 @@ const parseMain = (yiniContent, options = {
     isWithDiagnostics: false,
     isWithTiming: false,
 }) => {
-    (0, system_1.debugPrint)();
-    (0, system_1.debugPrint)('-> Entered parseMain(..) in parseEntry');
-    (0, system_1.debugPrint)('     isStrict mode = ' + options.isStrict);
-    (0, system_1.debugPrint)('bailSensitivityLevel = ' + options.bailSensitivityLevel);
+    (0, print_1.debugPrint)();
+    (0, print_1.debugPrint)('-> Entered parseMain(..) in parseEntry');
+    (0, print_1.debugPrint)('     isStrict mode = ' + options.isStrict);
+    (0, print_1.debugPrint)('bailSensitivityLevel = ' + options.bailSensitivityLevel);
     let persistThreshold;
     switch (options.bailSensitivityLevel) {
         case 0:
@@ -52,7 +52,7 @@ const parseMain = (yiniContent, options = {
             persistThreshold = '2-Abort-Even-on-Warnings';
     }
     (0, env_1.isDebug)() && console.log();
-    (0, system_1.debugPrint)('=== Phase 1 ===================================================');
+    (0, print_1.debugPrint)('=== Phase 1 ===================================================');
     const inputStream = antlr4_1.CharStreams.fromString(yiniContent);
     const lexer = new YiniLexer_1.default(inputStream);
     const tokenStream = new antlr4_1.CommonTokenStream(lexer);
@@ -61,21 +61,21 @@ const parseMain = (yiniContent, options = {
     const errorListener = new MyErrorListener(errorHandler);
     parser.removeErrorListeners(); // Removes the default console error output.
     parser.addErrorListener(errorListener);
-    (0, system_1.debugPrint)();
-    (0, system_1.debugPrint)('--- Starting parsing... ---');
+    (0, print_1.debugPrint)();
+    (0, print_1.debugPrint)('--- Starting parsing... ---');
     const parseTree = parser.yini(); // The function yini() is the start rule.
     if (errorListener.errors.length > 0) {
-        (0, system_1.debugPrint)('*** ERROR detected ***');
+        (0, print_1.debugPrint)('*** ERROR detected ***');
         if ((0, env_1.isDebug)()) {
             // Handle or display syntax errors
             console.error('Syntax errors detected:', errorListener.errors);
             //process.exit(1)
         }
     }
-    (0, system_1.debugPrint)('--- Parsing done. ---');
-    (0, system_1.debugPrint)('=== Ended phase 1 =============================================');
+    (0, print_1.debugPrint)('--- Parsing done. ---');
+    (0, print_1.debugPrint)('=== Ended phase 1 =============================================');
     (0, env_1.isDebug)() && console.log();
-    (0, system_1.debugPrint)('=== Phase 2 ===================================================');
+    (0, print_1.debugPrint)('=== Phase 2 ===================================================');
     //    const errorHandler = new ErrorDataHandler(persistThreshold)
     const visitor = new YINIVisitor_1.default(errorHandler, options.isStrict);
     const syntaxTreeC = visitor.visit(parseTree);
@@ -83,26 +83,26 @@ const parseMain = (yiniContent, options = {
         console.log();
         console.log('**************************************************************************');
         console.log('*** syntaxTreeContainer: *************************************************');
-        (0, system_1.printObject)(syntaxTreeC);
+        (0, print_1.printObject)(syntaxTreeC);
         console.log('**************************************************************************');
         console.log('**************************************************************************');
         console.log();
     }
-    (0, system_1.debugPrint)('=== Ended phase 2 =============================================');
+    (0, print_1.debugPrint)('=== Ended phase 2 =============================================');
     (0, env_1.isDebug)() && console.log();
-    (0, system_1.debugPrint)('=== Phase 3 ===================================================');
+    (0, print_1.debugPrint)('=== Phase 3 ===================================================');
     // Construct.
     const finalJSResult = (0, objectBuilder_1.constructFinalObject)(syntaxTreeC, errorHandler);
-    (0, system_1.debugPrint)('=== Ended phase 3 =============================================');
-    (0, system_1.debugPrint)('visitor.visit(..): finalJSResult:');
+    (0, print_1.debugPrint)('=== Ended phase 3 =============================================');
+    (0, print_1.debugPrint)('visitor.visit(..): finalJSResult:');
     (0, env_1.isDebug)() && console.debug(finalJSResult);
-    (0, system_1.debugPrint)();
+    (0, print_1.debugPrint)();
     if (options.isStrict) {
         //throw Error('ERROR: Strict-mode not yet implemented')
         errorHandler.pushOrBail(null, 'Syntax-Warning', 'WARNING: Strict-mode not yet fully implemented', '', '');
     }
     else {
-        (0, system_1.debugPrint)('visitor.visit(..): finalJSResult:');
+        (0, print_1.debugPrint)('visitor.visit(..): finalJSResult:');
         (0, env_1.isDebug)() && console.debug(finalJSResult);
     }
     // Construct meta data.
@@ -148,7 +148,7 @@ const parseMain = (yiniContent, options = {
             phase3Ms: null,
         };
     }
-    (0, system_1.debugPrint)('getNumOfErrors(): ' + errorHandler.getNumOfErrors());
+    (0, print_1.debugPrint)('getNumOfErrors(): ' + errorHandler.getNumOfErrors());
     if (errorHandler.getNumOfErrors()) {
         console.log();
         console.log('Parsing is complete, but some problems were detected. Please see the errors above for details.');

package/dist/parsers/extractHeaderParts.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-const system_1 = require("../utils/system");
+const print_1 = require("../utils/print");
 const yiniHelpers_1 = require("../yiniHelpers");
 const extractSignificantYiniLine_1 = require("./extractSignificantYiniLine");
 /**
@@ -26,11 +26,11 @@ const extractSignificantYiniLine_1 = require("./extractSignificantYiniLine");
  * @returns An object with the identified header parts: marker characters, parsed name, and parsed level string.
  */
 const extractHeaderParts = (rawLine, errorHandler = null, ctx = null) => {
-    (0, system_1.debugPrint)('-> Entered extractHeaderParts(..)');
+    (0, print_1.debugPrint)('-> Entered extractHeaderParts(..)');
     rawLine = rawLine.trim();
     const str = (0, extractSignificantYiniLine_1.extractYiniLine)(rawLine);
-    (0, system_1.debugPrint)('rawLine: >>>' + rawLine + '<<<');
-    (0, system_1.debugPrint)('    str: >>>' + str + '<<<');
+    (0, print_1.debugPrint)('rawLine: >>>' + rawLine + '<<<');
+    (0, print_1.debugPrint)('    str: >>>' + str + '<<<');
     // Edge case: empty line.
     if (!str) {
         errorHandler.pushOrBail(ctx, 'Internal-Error', 'Received blank argument in extractHeaderParts(..)', 'Sorry, an unintended internal error happened.');
@@ -81,18 +81,18 @@ const extractHeaderParts = (rawLine, errorHandler = null, ctx = null) => {
         // Optionally, strip trailing comments or newlines here if needed.
     }
     if (isBacktickedName) {
-        (0, system_1.debugPrint)('Backticed sectionNamePart: ' + sectionNamePart);
+        (0, print_1.debugPrint)('Backticed sectionNamePart: ' + sectionNamePart);
         // sectionNamePart = trimBackticks(sectionNamePart)
     }
-    (0, system_1.debugPrint)();
-    (0, system_1.debugPrint)('------');
-    (0, system_1.debugPrint)('<- About to leave extractHeaderParts(..)');
-    (0, system_1.debugPrint)();
-    (0, system_1.debugPrint)('    markerCharsPart: >>>' + markerCharsPart + '<<<');
-    (0, system_1.debugPrint)('    sectionNamePart: >>>' + sectionNamePart + '<<<');
-    (0, system_1.debugPrint)('         numberPart: >>>' + numberPart + '<<<');
-    (0, system_1.debugPrint)('   isBacktickedName: ' + isBacktickedName);
-    (0, system_1.debugPrint)();
+    (0, print_1.debugPrint)();
+    (0, print_1.debugPrint)('------');
+    (0, print_1.debugPrint)('<- About to leave extractHeaderParts(..)');
+    (0, print_1.debugPrint)();
+    (0, print_1.debugPrint)('    markerCharsPart: >>>' + markerCharsPart + '<<<');
+    (0, print_1.debugPrint)('    sectionNamePart: >>>' + sectionNamePart + '<<<');
+    (0, print_1.debugPrint)('         numberPart: >>>' + numberPart + '<<<');
+    (0, print_1.debugPrint)('   isBacktickedName: ' + isBacktickedName);
+    (0, print_1.debugPrint)();
     return {
         strMarkerChars: markerCharsPart,
         strSectionName: sectionNamePart,

package/dist/parsers/extractSignificantYiniLine.js

@@ -2,8 +2,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.extractYiniLine = void 0;
 const env_1 = require("../config/env");
+const print_1 = require("../utils/print");
 const string_1 = require("../utils/string");
-const system_1 = require("../utils/system");
 const yiniHelpers_1 = require("../yiniHelpers");
 /**
  * Extract significant YINI line from YINI content (that may be surrounded by comments.).
@@ -14,57 +14,57 @@ const yiniHelpers_1 = require("../yiniHelpers");
  * @returns Will filter out any comments (before or after) and return only one single significant YINI line.
  */
 const extractYiniLine = (rawYiniContent) => {
-    (0, system_1.debugPrint)('-> Entered extractSignificantYiniCode(..)');
+    (0, print_1.debugPrint)('-> Entered extractSignificantYiniCode(..)');
     const significantLines = [];
     let resultLine = '';
-    (0, system_1.debugPrint)('rawYiniContent: >>>' + rawYiniContent + '<<<');
+    (0, print_1.debugPrint)('rawYiniContent: >>>' + rawYiniContent + '<<<');
     const contentLines = (0, string_1.splitLines)(rawYiniContent);
     if ((0, env_1.isDebug)()) {
         console.log(`contentLines: (len: ${contentLines.length})`);
-        (0, system_1.printObject)(contentLines);
+        (0, print_1.printObject)(contentLines);
     }
     // contentLines.forEach((row: string) => {
     for (const line of contentLines) {
         let row = line;
-        (0, system_1.debugPrint)('---');
+        (0, print_1.debugPrint)('---');
         // debugPrint('row (a): >>>' + row + '<<<')
         // row = stripNLAndAfter(row)
-        (0, system_1.debugPrint)('row (b): >>>' + row + '<<<');
+        (0, print_1.debugPrint)('row (b): >>>' + row + '<<<');
         row = (0, yiniHelpers_1.stripCommentsAndAfter)(row);
-        (0, system_1.debugPrint)('row (c): >>>' + row + '<<<');
+        (0, print_1.debugPrint)('row (c): >>>' + row + '<<<');
         row = row.trim();
-        (0, system_1.debugPrint)('row (d): >>>' + row + '<<<');
+        (0, print_1.debugPrint)('row (d): >>>' + row + '<<<');
         if (row) {
-            (0, system_1.debugPrint)('Found some content in split row (non-comments).');
-            (0, system_1.debugPrint)('Split row: >>>' + row + '<<<');
+            (0, print_1.debugPrint)('Found some content in split row (non-comments).');
+            (0, print_1.debugPrint)('Split row: >>>' + row + '<<<');
             // Use this as input in line.
             // line = row
             significantLines.push(row);
             // break
         }
     }
-    (0, system_1.debugPrint)('--- End: parse line from section content-----------------');
-    (0, system_1.debugPrint)();
+    (0, print_1.debugPrint)('--- End: parse line from section content-----------------');
+    (0, print_1.debugPrint)();
     switch (significantLines.length) {
         case 0:
             resultLine = '';
             break;
         case 1:
-            (0, system_1.debugPrint)('Did only find one significant lines in rawYiniContent, OK');
+            (0, print_1.debugPrint)('Did only find one significant lines in rawYiniContent, OK');
             resultLine = significantLines[0];
             break;
         default:
-            (0, system_1.debugPrint)('(!) Did find several significant lines in rawYiniContent! - Maybe internal error...');
-            (0, system_1.debugPrint)('significantLines[0] = >>>' + significantLines[0] + '<<<');
-            (0, system_1.debugPrint)('significantLines[1] = >>>' + significantLines[1] + '<<<');
+            (0, print_1.debugPrint)('(!) Did find several significant lines in rawYiniContent! - Maybe internal error...');
+            (0, print_1.debugPrint)('significantLines[0] = >>>' + significantLines[0] + '<<<');
+            (0, print_1.debugPrint)('significantLines[1] = >>>' + significantLines[1] + '<<<');
         // throw new Error(
         //     'Internal error: Detected several row lines in rawYiniContent: >>>' +
         //         rawYiniContent +
         //         '<<<',
         // )
     }
-    (0, system_1.debugPrint)('<- About to leave extractSignificantYiniCode(..):');
-    (0, system_1.debugPrint)('resultLine: >>>' + resultLine + '<<<');
+    (0, print_1.debugPrint)('<- About to leave extractSignificantYiniCode(..):');
+    (0, print_1.debugPrint)('resultLine: >>>' + resultLine + '<<<');
     return resultLine;
 };
 exports.extractYiniLine = extractYiniLine;

package/dist/parsers/parseBoolean.js

@@ -1,11 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-const system_1 = require("../utils/system");
+const print_1 = require("../utils/print");
 /**
  * Extract boolean literal.
  */
 const parseBooleanLiteral = (txt) => {
-    (0, system_1.debugPrint)('-> Entered parseBooleanLiteral(..)');
+    (0, print_1.debugPrint)('-> Entered parseBooleanLiteral(..)');
     const value = !!(txt === 'true' || txt === 'yes' || txt === 'on');
     return value;
 };

package/dist/parsers/parseNull.js

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-const system_1 = require("../utils/system");
+const print_1 = require("../utils/print");
 const parseNullLiteral = (txt) => {
-    (0, system_1.debugPrint)('-> Entered parseNullLiteral(..)');
+    (0, print_1.debugPrint)('-> Entered parseNullLiteral(..)');
     if (txt.toLowerCase() !== 'null') {
         throw Error('Syntax Error: Unexpected token or character; expected `Null` literal (case-insensitive)');
     }