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

package/dist/grammar/YiniParserVisitor.d.ts

@@ -18,6 +18,8 @@ import { Null_literalContext } from "./YiniParser.js";
 import { String_literalContext } from "./YiniParser.js";
 import { String_concatContext } from "./YiniParser.js";
 import { Boolean_literalContext } from "./YiniParser.js";
+import { Empty_objectContext } from "./YiniParser.js";
+import { Empty_listContext } from "./YiniParser.js";
 /**
  * This interface defines a complete generic visitor for a parse tree produced
  * by `YiniParser`.
@@ -140,4 +142,16 @@ export default class YiniParserVisitor<Result> extends ParseTreeVisitor<Result>
      * @return the visitor result
      */
     visitBoolean_literal?: (ctx: Boolean_literalContext) => Result;
+    /**
+     * Visit a parse tree produced by `YiniParser.empty_object`.
+     * @param ctx the parse tree
+     * @return the visitor result
+     */
+    visitEmpty_object?: (ctx: Empty_objectContext) => Result;
+    /**
+     * Visit a parse tree produced by `YiniParser.empty_list`.
+     * @param ctx the parse tree
+     * @return the visitor result
+     */
+    visitEmpty_list?: (ctx: Empty_listContext) => Result;
 }

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.d.ts

@@ -1 +1,4 @@
-export { default } from './YINI';
+import YINI from './YINI';
+export declare const parse: (yiniContent: string, strictMode?: boolean, bailSensitivity?: "auto" | 0 | 1 | 2, includeMetaData?: boolean) => import("./core/types").TJSObject;
+export declare const parseFile: (filePath: string, strictMode?: boolean, bailSensitivity?: "auto" | 0 | 1 | 2, includeMetaData?: boolean) => import("./core/types").TJSObject;
+export default YINI;

package/dist/index.js

@@ -5,7 +5,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 var _a, _b, _c;
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.default = void 0;
+exports.parseFile = exports.parse = void 0;
 /*
     https://pauloe-me.medium.com/typescript-npm-package-publishing-a-beginners-guide-40b95908e69c
     
@@ -17,18 +17,20 @@ exports.default = 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"));
-var YINI_2 = require("./YINI");
-Object.defineProperty(exports, "default", { enumerable: true, get: function () { return __importDefault(YINI_2).default; } });
-(0, system_1.debugPrint)();
-(0, system_1.debugPrint)('-> Entered index.ts');
-(0, system_1.debugPrint)();
+// export { default } from './YINI'
+exports.parse = YINI_1.default.parse;
+exports.parseFile = YINI_1.default.parseFile;
+exports.default = YINI_1.default;
+(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)());
@@ -43,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.
 }
@@ -173,14 +175,11 @@ Expected JS output:
         //     id = 32403  # The correct app id.
         //     title = "My Program"
         // `
-        const corruptYini = `
-            ^ App
-            title = 'MyApp Title'
-            items = 25
-            items = 90  // (!) Redefinition!
-            isDarkTheme = true
+        const yini = `
+            ^ Database
+            pool = { max: 10, min: 2 }
         `;
-        YINI_1.default.parse(corruptYini, false, 2);
+        YINI_1.default.parse(yini);
         //         YINI.parse(`
         // ^ Section1
         //             ^^ Section2

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,55 +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, 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)');
     }

package/dist/parsers/parseNumber.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");
 const parseNumberLiteral = (txt) => {
-    (0, system_1.debugPrint)('-> Entered parseNumberLiteral(..), txt: ' + txt);
+    (0, print_1.debugPrint)('-> Entered parseNumberLiteral(..), txt: ' + txt);
     if (/^0[xX]|#/.test(txt)) {
         // Prefix: 0x, 0X, #
-        (0, system_1.debugPrint)('* Identified as a hex number');
+        (0, print_1.debugPrint)('* Identified as a hex number');
         return {
             type: 'Number-Integer',
             // value: parseInt(txt.replace('#', '0x'), 16),
@@ -14,7 +14,7 @@ const parseNumberLiteral = (txt) => {
     }
     if (/^0[bB]|%/.test(txt)) {
         // Prefix: 0b, 0B, %
-        (0, system_1.debugPrint)('* Identified as a bin number');
+        (0, print_1.debugPrint)('* Identified as a bin number');
         return {
             type: 'Number-Integer',
             value: parseInt(txt.replace(/^0[bB]|%/, ''), 2),
@@ -22,7 +22,7 @@ const parseNumberLiteral = (txt) => {
     }
     if (/^0[oO]/.test(txt)) {
         // Prefix: 0o, 0O
-        (0, system_1.debugPrint)('* Identified as a ord number');
+        (0, print_1.debugPrint)('* Identified as a ord number');
         return {
             type: 'Number-Integer',
             value: parseInt(txt.replace(/^0[oO]/, ''), 8),
@@ -30,7 +30,7 @@ const parseNumberLiteral = (txt) => {
     }
     if (/^0[zZ]/.test(txt)) {
         // Prefix: 0z, 0Z
-        (0, system_1.debugPrint)('* Identified as a duodecimal number');
+        (0, print_1.debugPrint)('* Identified as a duodecimal number');
         return {
             type: 'Number-Integer',
             value: parseInt(txt.replace(/^0[zZ]/, ''), 12),
@@ -38,12 +38,12 @@ const parseNumberLiteral = (txt) => {
     }
     // In a regex literal the dot must be escaped (\.) to match a literal '.'
     if (/\./.test(txt)) {
-        (0, system_1.debugPrint)('* Identified as a float number');
+        (0, print_1.debugPrint)('* Identified as a float number');
         return { type: 'Number-Float', value: parseFloat(txt) };
     }
     // TODO: Depending, on mode, below continue or break on error
     //console.error('Error: Failed to parse number value: ' + txt)
-    (0, system_1.debugPrint)('* Identified as a int number');
+    (0, print_1.debugPrint)('* Identified as a int number');
     return { type: 'Number-Integer', value: parseInt(txt) };
 };
 exports.default = parseNumberLiteral;

package/dist/parsers/parseSectionHeader.js

@@ -5,25 +5,25 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 const extractHeaderParts_1 = __importDefault(require("../parsers/extractHeaderParts"));
 const extractSignificantYiniLine_1 = require("../parsers/extractSignificantYiniLine");
+const print_1 = require("../utils/print");
 const string_1 = require("../utils/string");
-const system_1 = require("../utils/system");
 const yiniHelpers_1 = require("../yiniHelpers");
 /**
  * Extract ...
  * @param rawLine Raw line with the section header.
  */
 const parseSectionHeader = (rawLine, errorHandler, ctx) => {
-    (0, system_1.debugPrint)('-> Entered parseSectionHeader(..)');
+    (0, print_1.debugPrint)('-> Entered parseSectionHeader(..)');
     rawLine = rawLine.trim();
     const line = (0, extractSignificantYiniLine_1.extractYiniLine)(rawLine);
-    (0, system_1.debugPrint)('                  rawLine: >>>' + rawLine + '<<<');
-    (0, system_1.debugPrint)('extractYiniLine(..), line: >>>' + line + '<<<');
+    (0, print_1.debugPrint)('                  rawLine: >>>' + rawLine + '<<<');
+    (0, print_1.debugPrint)('extractYiniLine(..), line: >>>' + line + '<<<');
     let { strMarkerChars, strSectionName, strNumberPart, isBacktickedName } = (0, extractHeaderParts_1.default)(rawLine, errorHandler, ctx);
-    (0, system_1.debugPrint)('In parseSectionHeader(..), after extractHeaderParts(..):');
-    (0, system_1.debugPrint)('  strMarkerChars: ' + strMarkerChars);
-    (0, system_1.debugPrint)('  strSectionName: ' + strSectionName);
-    (0, system_1.debugPrint)('   strNumberPart: ' + strNumberPart);
-    (0, system_1.debugPrint)('isBacktickedName: ' + isBacktickedName);
+    (0, print_1.debugPrint)('In parseSectionHeader(..), after extractHeaderParts(..):');
+    (0, print_1.debugPrint)('  strMarkerChars: ' + strMarkerChars);
+    (0, print_1.debugPrint)('  strSectionName: ' + strSectionName);
+    (0, print_1.debugPrint)('   strNumberPart: ' + strNumberPart);
+    (0, print_1.debugPrint)('isBacktickedName: ' + isBacktickedName);
     let headerMarkerType;
     let level = 0;
     if (strMarkerChars === '') {
@@ -76,7 +76,7 @@ const parseSectionHeader = (rawLine, errorHandler, ctx) => {
         }
     }
     else {
-        (0, system_1.debugPrint)('Naming contraints: Is not a BacktickedName');
+        (0, print_1.debugPrint)('Naming contraints: Is not a BacktickedName');
         if (lenOfName <= 0) {
             errorHandler.pushOrBail(ctx, 'Syntax-Error', 'Invalid section name in repeating marker characters header, section name: "' +
                 strSectionName +
@@ -93,15 +93,15 @@ const parseSectionHeader = (rawLine, errorHandler, ctx) => {
     }
     // ---------------------------------------------------------------
     // strSectionName = trimBackticks(strSectionName)
-    (0, system_1.debugPrint)('                        --------------');
-    (0, system_1.debugPrint)('<- About to leave parseSectionHeader(..)');
-    (0, system_1.debugPrint)(`    rawLine = >>>${rawLine}<<<`);
-    (0, system_1.debugPrint)(`       line = >>>${line}<<<`);
-    (0, system_1.debugPrint)();
-    (0, system_1.debugPrint)('identified level: ' + level);
-    (0, system_1.debugPrint)('     SectionName: ' + strSectionName);
-    (0, system_1.debugPrint)('headerMarkerType: ' + headerMarkerType);
-    (0, system_1.debugPrint)('                        --------------');
+    (0, print_1.debugPrint)('                        --------------');
+    (0, print_1.debugPrint)('<- About to leave parseSectionHeader(..)');
+    (0, print_1.debugPrint)(`    rawLine = >>>${rawLine}<<<`);
+    (0, print_1.debugPrint)(`       line = >>>${line}<<<`);
+    (0, print_1.debugPrint)();
+    (0, print_1.debugPrint)('identified level: ' + level);
+    (0, print_1.debugPrint)('     SectionName: ' + strSectionName);
+    (0, print_1.debugPrint)('headerMarkerType: ' + headerMarkerType);
+    (0, print_1.debugPrint)('                        --------------');
     return {
         markerType: headerMarkerType,
         sectionName: strSectionName,

package/dist/parsers/parseString.js

@@ -1,30 +1,30 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const env_1 = require("../config/env");
-const system_1 = require("../utils/system");
+const print_1 = require("../utils/print");
 const parseStringLiteral = (raw) => {
     var _a;
-    (0, system_1.debugPrint)('-> Entered parseStringLiteral(..)');
-    (0, system_1.debugPrint)('raw = >>>' + raw + '<<<');
+    (0, print_1.debugPrint)('-> Entered parseStringLiteral(..)');
+    (0, print_1.debugPrint)('raw = >>>' + raw + '<<<');
     /*
             Extracts an optional prefix (C, c, H, or h) and identifies whether
             the string is triple-quoted, double-quoted, or single-quoted.
         */
     const prefixMatch = raw.match(/^(C|c|H|h|R|r)?("""|"|')/);
-    (0, system_1.debugPrint)('prefixMatch:');
+    (0, print_1.debugPrint)('prefixMatch:');
     if ((0, env_1.isDebug)()) {
         console.debug(prefixMatch);
     }
     let prefix = prefixMatch ? (_a = prefixMatch[1]) === null || _a === void 0 ? void 0 : _a.toUpperCase() : '';
-    (0, system_1.debugPrint)('          prefix = ' + prefix);
+    (0, print_1.debugPrint)('          prefix = ' + prefix);
     let quoteType = prefixMatch ? prefixMatch[2] : '';
-    (0, system_1.debugPrint)('       quoteType = ' + quoteType);
-    (0, system_1.debugPrint)('quoteType.length = ' + quoteType.length);
+    (0, print_1.debugPrint)('       quoteType = ' + quoteType);
+    (0, print_1.debugPrint)('quoteType.length = ' + quoteType.length);
     // Extracts the substring after removing the initial prefix (if any)
     // and quotes at the start (prefix.length + quoteType.length) and the
     // quotes at the end (-quoteType.length).
     let inner = raw.slice(((prefix === null || prefix === void 0 ? void 0 : prefix.length) || 0) + quoteType.length, -quoteType.length);
-    (0, system_1.debugPrint)('inner (raw) = ' + inner);
+    (0, print_1.debugPrint)('inner (raw) = ' + inner);
     if (prefix === 'C') {
         inner = inner
             .replace(/\\n/g, '\n')
@@ -34,7 +34,7 @@ const parseStringLiteral = (raw) => {
     else if (prefix === 'H') {
         inner = inner.replace(/[\s\n\r]+/g, ' ').trim();
     }
-    (0, system_1.debugPrint)('inner (reformat) = ' + inner);
+    (0, print_1.debugPrint)('inner (reformat) = ' + inner);
     return inner;
 };
 exports.default = parseStringLiteral;

package/dist/utils/string.js

@@ -6,7 +6,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.stripNLAndAfter = exports.isDigit = exports.isAlpha = exports.isEnclosedInBackticks = exports.trimBackticks = void 0;
 exports.splitLines = splitLines;
-const system_1 = require("./system");
+const print_1 = require("./print");
 /**
  * Splits a string into an array of lines, handling both LF and CRLF newlines.
  * @param content The input string.
@@ -90,8 +90,8 @@ const stripNLAndAfter = (line) => {
     // debugPrint('stripNLAndAfter(..): idx2 = ' + idx2)
     const idx = Math.min(idx1, idx2);
     const resultLine = idx === Number.MAX_SAFE_INTEGER ? line : line.substring(0, idx);
-    (0, system_1.debugPrint)('stripNLAndAfter(..),       line: >>>' + line + '<<<');
-    (0, system_1.debugPrint)('stripNLAndAfter(..), resultLine: >>>' + resultLine + '<<<');
+    (0, print_1.debugPrint)('stripNLAndAfter(..),       line: >>>' + line + '<<<');
+    (0, print_1.debugPrint)('stripNLAndAfter(..), resultLine: >>>' + resultLine + '<<<');
     return resultLine;
 };
 exports.stripNLAndAfter = stripNLAndAfter;

package/dist/yiniHelpers.js

@@ -5,8 +5,8 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.isValidBacktickedIdent = exports.isValidSimpleIdent = exports.stripCommentsAndAfter = exports.isMarkerCharacter = void 0;
+const print_1 = require("./utils/print");
 const string_1 = require("./utils/string");
-const system_1 = require("./utils/system");
 const SECTION_MARKER1 = '^';
 const SECTION_MARKER2 = '<';
 const SECTION_MARKER3 = '\u00A7'; // Section sign §.
@@ -64,8 +64,8 @@ const stripCommentsAndAfter = (line) => {
     // debugPrint('stripCommentsAndAfter(..): idx5 = ' + idx5)
     const idx = Math.min(idx1, idx2, idx3, idx4, idx5);
     const resultLine = idx === Number.MAX_SAFE_INTEGER ? line : line.substring(0, idx);
-    (0, system_1.debugPrint)('stripCommentsAndAfter(..),       line: >>>' + line + '<<<');
-    (0, system_1.debugPrint)('stripCommentsAndAfter(..), resultLine: >>>' + resultLine + '<<<');
+    (0, print_1.debugPrint)('stripCommentsAndAfter(..),       line: >>>' + line + '<<<');
+    (0, print_1.debugPrint)('stripCommentsAndAfter(..), resultLine: >>>' + resultLine + '<<<');
     return resultLine;
 };
 exports.stripCommentsAndAfter = stripCommentsAndAfter;

package/examples/basic-output.js

@@ -0,0 +1,15 @@
+// Parsed output from examples/basic.yini using YINI.parseFile(...)
+
+// JS object
+{
+  App: { 
+    title: 'My App',
+    items: 10,
+    debug: true 
+  },
+  Server: {
+    host: 'localhost',
+    port: 8080,
+    useTLS: false 
+  }
+}

package/examples/basic-with-comments.yini

@@ -0,0 +1,15 @@
+/*
+    basic-explained.yini
+*/
+
+@yini  // Optional marker indicating this is a YINI config file.
+
+^ App  // Section header: defines the "App" section.
+title = 'My App'     // A string (single-quoted or double-quoted are both supported).
+items = 10           // A number value.
+debug = ON           // Boolean true (ON/OFF are case-insensitive aliases for true/false).
+
+^ Server  // Another top-level section.
+host = "localhost"   // A string using double quotes.
+port = 8080          // A number value.
+useTLS = OFF         // Boolean false.