yini-parser 1.0.0-alpha.6 → 1.0.0-alpha.7x

package/dist/YINI.js

@@ -17,9 +17,20 @@ class YINI {
 }
 YINI.filePath = ''; // Used in error reporting.
 /**
- * @param yiniContent YINI code as a string, can be multiple lines.
- * @note The order of properties (members) in each JavaScript object (section) may differ from the order in the input YINI content.
- * @returns The parsed JavaScript object.
+ * Parse YINI content into a JavaScript object.
+ *
+ * @param yiniContent      YINI code as a string (multi‑line content supported).
+ * @param strictMode       If `true`, enforce strict parsing rules (e.g. require `/END`, disallow trailing commas).
+ * @param bailSensitivity  Controls how errors and warnings are handled:
+ *   - `'auto'`               : Auto‑select level (strict→1, lenient→0)
+ *   - `0` / `'Ignore-Errors'`    : Continue parsing despite errors; log them and attempt recovery.
+ *   - `1` / `'Abort-on-Errors'`  : Stop parsing on the first error.
+ *   - `2` / `'Abort-Even-on-Warnings'`: Stop parsing on the first warning **or** error.
+ * @param includeMetaData  If `true`, return additional metadata (e.g. warnings, statistics) alongside the parsed object.
+ *
+ * @note The order of properties in each output object may differ from their order in the YINI source.
+ *
+ * @returns A JavaScript object representing the parsed YINI content.
  */
 YINI.parse = (yiniContent, strictMode = false, bailSensitivity = 'auto', includeMetaData = false) => {
     (0, system_1.debugPrint)('-> Entered static parse(..) in class YINI\n');
@@ -66,9 +77,20 @@ YINI.parse = (yiniContent, strictMode = false, bailSensitivity = 'auto', include
     return result;
 };
 /**
+ * Parse a YINI file into a JavaScript object.
+ *
  * @param yiniFile Path to the YINI file.
- * @note The order of properties (members) in each JavaScript object (section) may differ from the order in the input YINI file.
- * @returns The parsed JavaScript object.
+ * @param strictMode       If `true`, enforce strict parsing rules (e.g. require `/END`, disallow trailing commas).
+ * @param bailSensitivity  Controls how errors and warnings are handled:
+ *   - `'auto'`               : Auto‑select level (strict→1, lenient→0)
+ *   - `0` / `'Ignore-Errors'`    : Continue parsing despite errors; log them and attempt recovery.
+ *   - `1` / `'Abort-on-Errors'`  : Stop parsing on the first error.
+ *   - `2` / `'Abort-Even-on-Warnings'`: Stop parsing on the first warning **or** error.
+ * @param includeMetaData  If `true`, return additional metadata (e.g. warnings, statistics) alongside the parsed object.
+ *
+ * @note The order of properties in each output object may differ from their order in the YINI source.
+ *
+ * @returns A JavaScript object representing the parsed YINI content.
  */
 YINI.parseFile = (filePath, strictMode = false, bailSensitivity = 'auto', includeMetaData = false) => {
     (0, system_1.debugPrint)('Current directory = ' + process.cwd());

package/dist/core/ErrorDataHandler.js

@@ -95,13 +95,12 @@ class ErrorDataHandler {
                     this.emitInternalError(msgWhat, msgWhy, msgHint);
                     if (this.persistThreshold === '1-Abort-on-Errors' ||
                         this.persistThreshold === '2-Abort-Even-on-Warnings') {
-                        if (process.env.NODE_ENV === 'test') {
-                            // In test, throw an error instead of exiting.
-                            throw new Error(`Internal-Error: ${msgWhat}`);
-                        }
-                        else {
-                            process.exit(2);
-                        }
+                        // if (process.env.NODE_ENV === 'test') {
+                        // In test, throw an error instead of exiting.
+                        throw new Error(`Internal-Error: ${msgWhat}`);
+                        // } else {
+                        //     process.exit(2)
+                        // }
                     }
                     break;
                 case 'Syntax-Error':
@@ -109,26 +108,24 @@ class ErrorDataHandler {
                     this.emitSyntaxError(msgWhat, msgWhy, msgHint);
                     if (this.persistThreshold === '1-Abort-on-Errors' ||
                         this.persistThreshold === '2-Abort-Even-on-Warnings') {
-                        if (process.env.NODE_ENV === 'test') {
-                            // In test, throw an error instead of exiting.
-                            throw new Error(`Syntax-Error: ${'' + msgWhat}`);
-                        }
-                        else {
-                            process.exit(3);
-                        }
+                        // if (process.env.NODE_ENV === 'test') {
+                        // In test, throw an error instead of exiting.
+                        throw new Error(`Syntax-Error: ${'' + msgWhat}`);
+                        // } else {
+                        //     process.exit(3)
+                        // }
                     }
                     break;
                 case 'Syntax-Warning':
                     this.numSyntaxWarnings++;
                     this.emitSyntaxWarning(msgWhat, msgWhy, msgHint);
                     if (this.persistThreshold === '2-Abort-Even-on-Warnings') {
-                        if (process.env.NODE_ENV === 'test') {
-                            // In test, throw an error instead of exiting.
-                            throw new Error(`Syntax-Warning: ${msgWhat}`);
-                        }
-                        else {
-                            process.exit(4);
-                        }
+                        // if (process.env.NODE_ENV === 'test') {
+                        // In test, throw an error instead of exiting.
+                        throw new Error(`Syntax-Warning: ${msgWhat}`);
+                        // } else {
+                        //     process.exit(4)
+                        // }
                     }
                     break;
                 case 'Notice':
@@ -143,17 +140,16 @@ class ErrorDataHandler {
                     this.numFatalErrors++;
                     this.emitFatalError(msgWhat, msgWhy, msgHint);
                     // CANNOT recover fatal errors, will lead to an exit!
-                    if (process.env.NODE_ENV === 'test') {
-                        // In test, throw an error instead of exiting.
-                        throw new Error(`Internal-Error: ${msgWhat}`);
-                    }
-                    else {
-                        process.exit(1);
-                        // (!) Not sure about the below yet, if it's preferable in this case...
-                        // Use this instead of process.exit(1), this will
-                        // lead to that the current thread(s) will exit as well.
-                        // process.exitCode = 1
-                    }
+                    // if (process.env.NODE_ENV === 'test') {
+                    // In test, throw an error instead of exiting.
+                    throw new Error(`Internal-Error: ${msgWhat}`);
+                // } else {
+                //     process.exit(1)
+                // (!) Not sure about the below yet, if it's preferable in this case...
+                // Use this instead of process.exit(1), this will
+                // lead to that the current thread(s) will exit as well.
+                // process.exitCode = 1
+                // }
             }
         };
         this.emitFatalError = (msgWhat = 'Something went wrong!', msgWhy = '', msgHint = '') => {

package/dist/core/YINIVisitor.d.ts

@@ -136,13 +136,13 @@ export default class YINIVisitor<IResult> extends YiniParserVisitor<IResult> {
      * @param ctx the parse tree
      * @return the visitor result
      */
-    visitElements?: (ctx: ElementsContext) => IResult;
+    visitElements: (ctx: ElementsContext) => IResult;
     /**
      * Visit a parse tree produced by `YiniParser.element`.
      * @param ctx the parse tree
      * @return the visitor result
      */
-    visitElement: (ctx: ElementContext) => IResult;
+    visitElement: (ctx: ElementContext) => any;
     /**
      * Visit a parse tree produced by `YiniParser.string_concat`.
      * @param ctx the parse tree

package/dist/core/YINIVisitor.js

@@ -779,7 +779,8 @@ class YINIVisitor extends YiniParserVisitor_1.default {
                 return this.visit(ctx.null_literal());
             if (ctx.object_literal())
                 return this.visit(ctx.object_literal());
-            //   if (ctx.list()) return this.visit(ctx.list())
+            if (ctx.list_in_brackets())
+                return this.visit(ctx.list_in_brackets());
             //   if (ctx.string_concat()) return this.visit(ctx.string_concat())
             return null;
         };
@@ -883,8 +884,80 @@ class YINIVisitor extends YiniParserVisitor_1.default {
          */
         // visitList_in_brackets?: (ctx: List_in_bracketsContext) => IResult
         this.visitList_in_brackets = (ctx) => {
-            const elements = ctx.elements() ? this.visit(ctx.elements()) : [];
-            return { type: 'List', value: elements };
+            (0, system_1.debugPrint)('-> Entered visitList_in_brackets(..)');
+            let elements = [];
+            if (!ctx.elements()) {
+                (0, system_1.debugPrint)('Detected elements() is [], in list brackets');
+                // elements = []
+                return { type: 'List', value: [] };
+            }
+            else {
+                (0, system_1.debugPrint)('Detected elements() has items, in list brackets');
+                elements = this.visit(ctx.elements());
+            }
+            (0, system_1.debugPrint)('<- Leaving visitList_in_brackets(..)');
+            if ((0, env_1.isDebug)()) {
+                console.log('returning:');
+                console.log({ type: 'List', value: elements.value });
+                console.log();
+            }
+            return { type: 'List', value: elements.value };
+        };
+        /**
+         * Visit a parse tree produced by `YiniParser.elements`.
+         * @param ctx the parse tree
+         * @return the visitor result
+         */
+        this.visitElements = (ctx) => {
+            (0, system_1.debugPrint)('-> Entered visitElements(..)');
+            const firstElem = ctx.element();
+            let elements = [];
+            (0, system_1.debugPrint)('            element  = ' + firstElem);
+            (0, system_1.debugPrint)('  element.getText()  = ' + firstElem.getText());
+            (0, system_1.debugPrint)('            elements = ' + !!ctx.elements());
+            const resultElem = ctx.element()
+                ? this.visitElement(ctx.element())
+                : null;
+            const resultTypeElem = resultElem === null || resultElem === void 0 ? void 0 : resultElem.type;
+            const resultValueElem = resultElem === null || resultElem === void 0 ? void 0 : resultElem.value;
+            (0, system_1.debugPrint)(' elem type  = ' + resultTypeElem + '          @visitElements(..)');
+            (0, system_1.debugPrint)(' elem value = ' + resultValueElem + '         @visitElements(..)');
+            const resultElems = ctx.elements()
+                ? this.visitElements(ctx.elements())
+                : null;
+            const resultTypeElems = resultElems === null || resultElems === void 0 ? void 0 : resultElems.type;
+            const resultValueElems = resultElems === null || resultElems === void 0 ? void 0 : resultElems.value;
+            (0, system_1.debugPrint)(' elems type  = ' +
+                resultTypeElems +
+                '          @visitElements(..)');
+            (0, system_1.debugPrint)(' elems value = ' +
+                resultValueElems +
+                '         @visitElements(..)');
+            if (!ctx.elements()) {
+                (0, system_1.debugPrint)('In visitElements(..) detected that elements() has no elements');
+                elements = undefined;
+            }
+            else {
+                (0, system_1.debugPrint)('In visitElements(..) detected elements in elements()');
+                elements = this.visit(ctx.elements());
+                if ((0, env_1.isDebug)()) {
+                    console.log('result of visited elements:');
+                    (0, system_1.printObject)(elements);
+                }
+            }
+            const returnValues = elements
+                ? [resultElem].concat(elements.value)
+                : [resultElem];
+            (0, system_1.debugPrint)('<- Leaving visitElements(..)');
+            if ((0, env_1.isDebug)()) {
+                console.log('returnValues:');
+                (0, system_1.printObject)(returnValues);
+            }
+            return {
+                type: 'List',
+                // value: [resultElem].concat(elements.value),
+                value: returnValues,
+            };
         };
         /**
          * Visit a parse tree produced by `YiniParser.element`.
@@ -892,12 +965,33 @@ class YINIVisitor extends YiniParserVisitor_1.default {
          * @return the visitor result
          */
         // visitElement?: (ctx: ElementContext) => IResult
+        // visitElement = (ctx: ElementContext): IResult => {
         this.visitElement = (ctx) => {
+            (0, system_1.debugPrint)('-> Entered visitElement(..)');
+            // if (ctx.value()) {
+            //     return this.visit(ctx.value())
+            // } else {
+            //     return { type: 'Null', value: null } as IResult
+            // }
+            let result;
             if (ctx.value()) {
-                return this.visit(ctx.value());
+                result = this.visit(ctx.value());
             }
             else {
-                return { type: 'Null', value: null };
+                result = { type: 'Null', value: null };
+            }
+            (0, system_1.debugPrint)('<- Leaving visitElement(..)');
+            if ((0, env_1.isDebug)()) {
+                console.log('returning:');
+                (0, system_1.printObject)(result);
+                console.log();
+            }
+            //return 'value'
+            switch (result.type) {
+                case 'String':
+                    return `${result.value}`;
+                default:
+                    return result.value;
             }
         };
         this.errorHandler = errorHandler;

package/dist/grammar/YiniLexer.js

@@ -81,7 +81,10 @@ YiniLexer.literalNames = [null, null,
     "']'", "'{'",
     "'}'", "'+'",
     "'$'", "'%'",
-    "'@'", "';'"];
+    "'@'", "';'",
+    null, null,
+    null, "'{}'",
+    "'[]'"];
 YiniLexer.symbolicNames = [null, "YINI_MARKER",
     "SECTION_HEAD",
     "TERMINAL_TOKEN",

package/dist/grammar/YiniParser.d.ts

@@ -67,6 +67,8 @@ export default class YiniParser extends Parser {
     static readonly RULE_string_literal = 16;
     static readonly RULE_string_concat = 17;
     static readonly RULE_boolean_literal = 18;
+    static readonly RULE_empty_object = 19;
+    static readonly RULE_empty_list = 20;
     static readonly literalNames: (string | null)[];
     static readonly symbolicNames: (string | null)[];
     static readonly ruleNames: string[];
@@ -96,6 +98,8 @@ export default class YiniParser extends Parser {
     string_literal(): String_literalContext;
     string_concat(): String_concatContext;
     boolean_literal(): Boolean_literalContext;
+    empty_object(): Empty_objectContext;
+    empty_list(): Empty_listContext;
     static readonly _serializedATN: number[];
     private static __ATN;
     static get _ATN(): ATN;
@@ -183,7 +187,7 @@ export declare class Object_literalContext extends ParserRuleContext {
     CC(): TerminalNode;
     NL_list(): TerminalNode[];
     NL(i: number): TerminalNode;
-    EMPTY_OBJECT(): TerminalNode;
+    empty_object(): Empty_objectContext;
     get ruleIndex(): number;
     accept<Result>(visitor: YiniParserVisitor<Result>): Result;
 }
@@ -195,7 +199,7 @@ export declare class ObjectMemberListContext extends ParserRuleContext {
     COMMA(i: number): TerminalNode;
     NL_list(): TerminalNode[];
     NL(i: number): TerminalNode;
-    EMPTY_OBJECT(): TerminalNode;
+    empty_object(): Empty_objectContext;
     get ruleIndex(): number;
     accept<Result>(visitor: YiniParserVisitor<Result>): Result;
 }
@@ -224,7 +228,7 @@ export declare class List_in_bracketsContext extends ParserRuleContext {
     CB(): TerminalNode;
     NL_list(): TerminalNode[];
     NL(i: number): TerminalNode;
-    EMPTY_LIST(): TerminalNode;
+    empty_list(): Empty_listContext;
     get ruleIndex(): number;
     accept<Result>(visitor: YiniParserVisitor<Result>): Result;
 }
@@ -281,3 +285,23 @@ export declare class Boolean_literalContext extends ParserRuleContext {
     get ruleIndex(): number;
     accept<Result>(visitor: YiniParserVisitor<Result>): Result;
 }
+export declare class Empty_objectContext extends ParserRuleContext {
+    constructor(parser?: YiniParser, parent?: ParserRuleContext, invokingState?: number);
+    EMPTY_OBJECT(): TerminalNode;
+    OC(): TerminalNode;
+    CC(): TerminalNode;
+    NL_list(): TerminalNode[];
+    NL(i: number): TerminalNode;
+    get ruleIndex(): number;
+    accept<Result>(visitor: YiniParserVisitor<Result>): Result;
+}
+export declare class Empty_listContext extends ParserRuleContext {
+    constructor(parser?: YiniParser, parent?: ParserRuleContext, invokingState?: number);
+    EMPTY_LIST(): TerminalNode;
+    OB(): TerminalNode;
+    CB(): TerminalNode;
+    NL_list(): TerminalNode[];
+    NL(i: number): TerminalNode;
+    get ruleIndex(): number;
+    accept<Result>(visitor: YiniParserVisitor<Result>): Result;
+}