yini-parser 1.0.1-beta → 1.1.0-beta

package/dist/core/ErrorDataHandler.d.ts

@@ -1,21 +1,15 @@
-import { TIssueType, TPersistThreshold } from './types';
-interface IIssuePayload {
-    type: TIssueType;
-    msgWhat: string;
-    start: {
-        line: number;
-        column: number;
-    };
-    end?: {
-        line?: number;
-        column?: number;
-    };
-}
+import { IIssuePayload, TIssueType, TPersistThreshold, TSubjectType } from './types';
 /**
  * This class handles all error/notice reporting and processes exit/throwing.
  */
 export declare class ErrorDataHandler {
-    private persistThreshold;
+    private readonly persistThreshold;
+    private readonly subjectType;
+    private readonly fileName;
+    private errors;
+    private warnings;
+    private notices;
+    private infos;
     private numFatalErrors;
     private numInternalErrors;
     private numSyntaxErrors;
@@ -31,8 +25,8 @@ export declare class ErrorDataHandler {
             - Level 1 = abort on errors only
             - Level 2 = abort even on warnings
      */
-    constructor(threshold?: TPersistThreshold);
-    makeIssuePayload: (type: TIssueType, msgWhat: string, lineNum: number, startCol: number, endCol: number) => IIssuePayload;
+    constructor(subjectType: TSubjectType, threshold?: TPersistThreshold, fileName?: string | undefined);
+    private makeIssue;
     /**
      * After pushing processing may continue or exit, depending on the error
      * and/or the bail threshold (that can be optionally set my the user).
@@ -46,15 +40,21 @@ export declare class ErrorDataHandler {
      * @param msgWhy More details and more specific info about the issue/error.
      * @param msgHint Hint or HUMBLE description on how to fix the issue.
      */
-    pushOrBail: (ctx: any, type: TIssueType, msgWhat: string, msgWhy?: string, msgHint?: string) => void;
+    pushOrBail(ctx: any, type: TIssueType, msgWhat: string, msgWhy?: string, msgHint?: string): void;
+    private formatSignificantMessageLine;
     private emitFatalError;
     private emitInternalError;
     private emitSyntaxError;
     private emitSyntaxWarning;
     private emitNotice;
     private emitInfo;
+    getNumOfAllMessages(): number;
     getNumOfErrors(): number;
     getNumOfWarnings(): number;
-    getNumOfInfoAndNotices(): number;
+    getNumOfNotices(): number;
+    getNumOfInfos(): number;
+    getErrors(): IIssuePayload[];
+    getWarnings(): IIssuePayload[];
+    getNotices(): IIssuePayload[];
+    getInfos(): IIssuePayload[];
 }
-export {};

package/dist/core/ErrorDataHandler.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ErrorDataHandler = void 0;
 const env_1 = require("../config/env");
 const print_1 = require("../utils/print");
+const string_1 = require("../utils/string");
 // All the issue titles are defined here to get a quick overview of all
 // titles, and to easier check that all titles match with relation to
 // the other titles.
@@ -27,168 +28,260 @@ class ErrorDataHandler {
             - Level 1 = abort on errors only
             - Level 2 = abort even on warnings
      */
-    constructor(threshold = '1-Abort-on-Errors') {
+    constructor(subjectType, threshold = '1-Abort-on-Errors', fileName = undefined) {
+        this.errors = [];
+        this.warnings = [];
+        this.notices = [];
+        this.infos = [];
         this.numFatalErrors = 0;
         this.numInternalErrors = 0;
         this.numSyntaxErrors = 0;
         this.numSyntaxWarnings = 0;
         this.numNotices = 0;
         this.numInfos = 0;
-        this.makeIssuePayload = (type, msgWhat, lineNum, startCol, endCol) => {
-            const issue = {
-                type,
-                msgWhat,
-                // msgHintOrFix: string = '', // Hint or wow to fix.
-                start: {
-                    line: lineNum,
-                    column: startCol,
-                },
-                end: {
-                    line: lineNum,
-                    column: endCol,
-                },
-            };
-            (0, print_1.debugPrint)('issue:');
-            (0, env_1.isDebug)() && console.log(issue);
-            return issue;
+        this.subjectType = subjectType;
+        this.persistThreshold = threshold;
+        this.fileName = fileName;
+    }
+    makeIssue(line, column, type, message, advice = undefined, hint = undefined) {
+        const issue = {
+            line,
+            column: !column ? undefined : column,
+            typeKey: (0, string_1.toLowerSnakeCase)(type),
+            message,
+            advice: advice || undefined, // Note, this will render ''-values as undfined and omit these in console outputs.
+            hint: hint || undefined, // Note, this will render ''-values as undfined and omit these in console outputs.
         };
-        /**
-         * After pushing processing may continue or exit, depending on the error
-         * and/or the bail threshold (that can be optionally set my the user).
-         *
-         * @note This function MIGHT result in a return, throw, or exit depending
-         * on the bail policy (set my the user).
-         *
-         * @param ctx
-         * @param type
-         * @param msgWhat Name of the specific error or what failed. E.g. "Key already exists in this section scope".
-         * @param msgWhy More details and more specific info about the issue/error.
-         * @param msgHint Hint or HUMBLE description on how to fix the issue.
-         */
-        this.pushOrBail = (ctx, type, msgWhat, msgWhy = '', msgHint = '') => {
-            var _a, _b, _c, _d, _e, _f;
-            (0, print_1.debugPrint)('-> pushOrBail(..)');
-            (0, print_1.debugPrint)('ctx.exception?.name       =' + ((_a = ctx === null || ctx === void 0 ? void 0 : ctx.exception) === null || _a === void 0 ? void 0 : _a.name));
-            (0, print_1.debugPrint)('ctx.exception?.message    = ' + ((_b = ctx === null || ctx === void 0 ? void 0 : ctx.exception) === null || _b === void 0 ? void 0 : _b.message));
-            (0, print_1.debugPrint)('exception?.offendingToken = ' + ((_c = ctx === null || ctx === void 0 ? void 0 : ctx.exception) === null || _c === void 0 ? void 0 : _c.offendingToken));
-            (0, print_1.debugPrint)();
-            (0, print_1.debugPrint)('ctx.ruleIndex    = ' + (ctx === null || ctx === void 0 ? void 0 : ctx.start.channel));
-            (0, print_1.debugPrint)('ctx.ruleIndex    = ' + (ctx === null || ctx === void 0 ? void 0 : ctx.ruleIndex));
-            (0, print_1.debugPrint)('ctx.ruleContext  = ' + (ctx === null || ctx === void 0 ? void 0 : ctx.ruleContext));
-            (0, print_1.debugPrint)('ctx.stop?.line   = ' + ((_d = ctx === null || ctx === void 0 ? void 0 : ctx.stop) === null || _d === void 0 ? void 0 : _d.line));
-            (0, print_1.debugPrint)('ctx.stop?.column = ' + ((_e = ctx === null || ctx === void 0 ? void 0 : ctx.stop) === null || _e === void 0 ? void 0 : _e.column));
-            const lineNum = (ctx === null || ctx === void 0 ? void 0 : ctx.start.line) || 0; // Column (1-based).
-            const startCol = !ctx ? 0 : ++ctx.start.column; // Column (0-based).
-            const endCol = (((_f = ctx === null || ctx === void 0 ? void 0 : ctx.stop) === null || _f === void 0 ? void 0 : _f.column) || 0) + 1; // Column (0-based).
+        (0, print_1.debugPrint)('issue:');
+        (0, env_1.isDebug)() && console.log(issue);
+        return issue;
+    }
+    /**
+     * After pushing processing may continue or exit, depending on the error
+     * and/or the bail threshold (that can be optionally set my the user).
+     *
+     * @note This function MIGHT result in a return, throw, or exit depending
+     * on the bail policy (set my the user).
+     *
+     * @param ctx
+     * @param type
+     * @param msgWhat Name of the specific error or what failed. E.g. "Key already exists in this section scope".
+     * @param msgWhy More details and more specific info about the issue/error.
+     * @param msgHint Hint or HUMBLE description on how to fix the issue.
+     */
+    pushOrBail(ctx, type, msgWhat, msgWhy = '', msgHint = '') {
+        var _a, _b, _c, _d, _e, _f;
+        (0, print_1.debugPrint)('-> pushOrBail(..)');
+        (0, print_1.debugPrint)('ctx.exception?.name       =' + ((_a = ctx === null || ctx === void 0 ? void 0 : ctx.exception) === null || _a === void 0 ? void 0 : _a.name));
+        (0, print_1.debugPrint)('ctx.exception?.message    = ' + ((_b = ctx === null || ctx === void 0 ? void 0 : ctx.exception) === null || _b === void 0 ? void 0 : _b.message));
+        (0, print_1.debugPrint)('exception?.offendingToken = ' + ((_c = ctx === null || ctx === void 0 ? void 0 : ctx.exception) === null || _c === void 0 ? void 0 : _c.offendingToken));
+        (0, print_1.debugPrint)();
+        (0, print_1.debugPrint)('ctx.ruleIndex    = ' + (ctx === null || ctx === void 0 ? void 0 : ctx.start.channel));
+        (0, print_1.debugPrint)('ctx.ruleIndex    = ' + (ctx === null || ctx === void 0 ? void 0 : ctx.ruleIndex));
+        (0, print_1.debugPrint)('ctx.ruleContext  = ' + (ctx === null || ctx === void 0 ? void 0 : ctx.ruleContext));
+        (0, print_1.debugPrint)('ctx.stop?.line   = ' + ((_d = ctx === null || ctx === void 0 ? void 0 : ctx.stop) === null || _d === void 0 ? void 0 : _d.line));
+        (0, print_1.debugPrint)('ctx.stop?.column = ' + ((_e = ctx === null || ctx === void 0 ? void 0 : ctx.stop) === null || _e === void 0 ? void 0 : _e.column));
+        const lineNum = (ctx === null || ctx === void 0 ? void 0 : ctx.start.line) || undefined; // Line (1-based).
+        // const startCol = !ctx ? 0 : ++ctx.start.column // Column (0-based).
+        const startCol = !ctx
+            ? undefined
+            : ++ctx.start.column; // Column (0-based).
+        // const endCol = (ctx?.stop?.column || 0) + 1 // Column (0-based).
+        const endCol = !!((_f = ctx === null || ctx === void 0 ? void 0 : ctx.stop) === null || _f === void 0 ? void 0 : _f.column)
+            ? ++ctx.stop.column
+            : undefined; // Note: Column (0-based).
+        let colNum = startCol || endCol;
+        // if (colNum === 0) {
+        //     colNum = undefined
+        // }
+        let msgWhatWithLineNum = msgWhat;
+        if (lineNum && lineNum > 0) {
+            //@todo func that removes possible . at end
+            //msgWhatWithLineNum =
             // Patch message with the offending line number.
-            msgWhat += ', at line: ' + lineNum;
+            // msgWhatWithLineNum += ', at line: ' + lineNum
+            msgWhatWithLineNum += ' at line ' + lineNum;
+            if (colNum) {
+                msgWhatWithLineNum += ', column ' + colNum;
+            }
             if (process.env.NODE_ENV === 'test') {
-                msgWhat += `\nAt line: ${lineNum}, column(s): ${startCol}-${endCol}`;
+                msgWhatWithLineNum += `\nAt line: ${lineNum}, column(s): ${startCol}-${endCol}`;
             }
-            (0, print_1.debugPrint)('persistThreshold = ' + this.persistThreshold);
-            (0, print_1.debugPrint)('lineNum = ' + lineNum);
-            (0, print_1.debugPrint)();
-            const issue = this.makeIssuePayload(type, msgWhat, lineNum, startCol, endCol);
-            switch (type) {
-                case 'Internal-Error':
-                    this.numInternalErrors++;
-                    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)
-                        // }
-                    }
-                    break;
-                case 'Syntax-Error':
-                    this.numSyntaxErrors++;
-                    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)
-                        // }
-                    }
-                    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)
-                        // }
-                    }
-                    break;
-                case 'Notice':
-                    this.numNotices++;
-                    this.emitNotice(msgWhat, msgWhy, msgHint);
-                    break;
-                case 'Info':
-                    this.numInfos++;
-                    this.emitInfo(msgWhat, msgWhy, msgHint);
-                    break;
-                default: // Including 'Internal-Error'.
-                    this.numFatalErrors++;
-                    this.emitFatalError(msgWhat, msgWhy, msgHint);
-                    // CANNOT recover fatal errors, will lead to an exit!
+        }
+        (0, print_1.debugPrint)('persistThreshold = ' + this.persistThreshold);
+        (0, print_1.debugPrint)(' lineNum = ' + lineNum);
+        (0, print_1.debugPrint)('  colNum = ' + colNum);
+        (0, print_1.debugPrint)('startCol = ' + startCol);
+        (0, print_1.debugPrint)('  endCol = ' + endCol);
+        (0, print_1.debugPrint)();
+        const loc = {
+            lineNum: lineNum || 0, // 1-based, if n/a use 0.
+            colNum: colNum || 0, // 1-based, if n/a use 0.
+        };
+        console.log(); // Print an empty line before outputting message.
+        switch (type) {
+            case 'Internal-Error':
+                this.numInternalErrors++;
+                this.errors.push(this.makeIssue(lineNum, colNum, type, msgWhat, msgWhy, msgHint));
+                this.emitInternalError(loc, msgWhatWithLineNum, msgWhy, msgHint);
+                console.log(); // Emit an empty line before outputting message.
+                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(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
-                // }
+                    // } else {
+                    //     process.exit(2)
+                    // }
+                }
+                break;
+            case 'Syntax-Error':
+                this.numSyntaxErrors++;
+                this.errors.push(this.makeIssue(lineNum, colNum, type, msgWhat, msgWhy, msgHint));
+                this.emitSyntaxError(loc, msgWhatWithLineNum, msgWhy, msgHint);
+                console.log(); // Emit an empty line before outputting message.
+                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)
+                    // }
+                }
+                break;
+            case 'Syntax-Warning':
+                this.numSyntaxWarnings++;
+                this.warnings.push(this.makeIssue(lineNum, colNum, type, msgWhat, msgWhy, msgHint));
+                this.emitSyntaxWarning(loc, msgWhatWithLineNum, msgWhy, msgHint);
+                console.log(); // Emit an empty line before outputting message.
+                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)
+                    // }
+                }
+                break;
+            case 'Notice':
+                this.numNotices++;
+                this.notices.push(this.makeIssue(lineNum, colNum, type, msgWhat, msgWhy, msgHint));
+                this.emitNotice(loc, msgWhatWithLineNum, msgWhy, msgHint);
+                console.log(); // Emit an empty line before outputting message.
+                break;
+            case 'Info':
+                this.numInfos++;
+                this.infos.push(this.makeIssue(lineNum, colNum, type, msgWhat, msgWhy, msgHint));
+                this.emitInfo(loc, msgWhatWithLineNum, msgWhy, msgHint);
+                console.log(); // Emit an empty line before outputting message.
+                break;
+            default: // Including 'Internal-Error'.
+                this.numFatalErrors++;
+                this.errors.push(this.makeIssue(lineNum, colNum, type, msgWhat, msgWhy, msgHint));
+                this.emitFatalError(loc, msgWhatWithLineNum, msgWhy, msgHint);
+                console.log(); // Emit an empty line before outputting message.
+                // 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
+            // }
+        }
+    }
+    formatSignificantMessageLine(loc, issueTitle) {
+        // if (this.subjectType === 'None/Ignore') {
+        //     return issueTitle
+        // }
+        switch (this.subjectType) {
+            case 'None/Ignore':
+                return issueTitle;
+            case 'File':
+            case 'Inline': {
+                // Construct a full line from several parts.
+                const titlePart = (0, string_1.trimTrailingNonLetters)(issueTitle.trim());
+                let line = `${titlePart} in `;
+                if (this.subjectType === 'Inline') {
+                    line += 'inline YINI content';
+                    // if (loc?.lineNum) {
+                    //     line += `, ${loc.lineNum}`
+                    //     if (loc?.colNum) line += `:${loc.colNum}`
+                    // }
+                }
+                else {
+                    line += `in ${this.fileName}`;
+                    // if (loc?.lineNum) {
+                    //     line += `:${loc.lineNum}`
+                    //     if (loc?.colNum) line += `:${loc.colNum}`
+                    // }
+                }
+                if (loc === null || loc === void 0 ? void 0 : loc.lineNum) {
+                    line += `:${loc.lineNum}`;
+                    if (loc === null || loc === void 0 ? void 0 : loc.colNum)
+                        line += `:${loc.colNum}`;
+                }
+                return line;
             }
-        };
-        this.emitFatalError = (msgWhat = 'Something went wrong!', msgWhy = '', msgHint = '') => {
-            console.error(issueTitle[0]); // Print the issue title.
-            msgWhat && console.error(msgWhat);
-            msgWhy && console.log(msgWhy);
-            msgHint && console.log(msgHint);
-        };
-        this.emitInternalError = (msgWhat = 'Something went wrong!', msgWhy = '', msgHint = '') => {
-            console.error(issueTitle[1]); // Print the issue title.
-            msgWhat && console.error(msgWhat);
-            msgWhy && console.log(msgWhy);
-            msgHint && console.log(msgHint);
-        };
-        this.emitSyntaxError = (msgWhat, msgWhy = '', msgHint = '') => {
-            console.error(issueTitle[2]); // Print the issue title.
-            msgWhat && console.error(msgWhat);
-            msgWhy && console.log(msgWhy);
-            msgHint && console.log(msgHint);
-        };
-        this.emitSyntaxWarning = (msgWhat, msgWhy = '', msgHint = '') => {
-            console.warn(issueTitle[3]); // Print the issue title.
-            msgWhat && console.warn(msgWhat);
-            msgWhy && console.log(msgWhy);
-            msgHint && console.log(msgHint);
-        };
-        this.emitNotice = (msgWhat, msgWhy = '', msgHint = '') => {
-            console.warn(issueTitle[4]); // Print the issue title.
-            msgWhat && console.warn(msgWhat);
-            msgWhy && console.log(msgWhy);
-            msgHint && console.log(msgHint);
-        };
-        this.emitInfo = (msgWhat, msgWhy = '', msgHint = '') => {
-            console.info(issueTitle[5]); // Print the issue title.
-            msgWhat && console.info(msgWhat);
-            msgWhy && console.log(msgWhy);
-            msgHint && console.log(msgHint);
-        };
-        this.persistThreshold = threshold;
+        }
+    }
+    emitFatalError(loc, msgWhat = 'Something went wrong!', msgWhy = '', msgHint = '') {
+        // console.error(issueTitle[0]) // Print the issue title.
+        const messageHeader = this.formatSignificantMessageLine(loc, issueTitle[0]);
+        console.error(messageHeader); // Print the issue title.
+        msgWhat && console.log(msgWhat);
+        msgWhy && console.log(msgWhy);
+        msgHint && console.log(msgHint);
+    }
+    emitInternalError(loc, msgWhat = 'Something went wrong!', msgWhy = '', msgHint = '') {
+        // console.error(issueTitle[1]) // Print the issue title.
+        const messageHeader = this.formatSignificantMessageLine(loc, issueTitle[1]);
+        console.error(messageHeader); // Print the issue title.
+        msgWhat && console.log(msgWhat);
+        msgWhy && console.log(msgWhy);
+        msgHint && console.log(msgHint);
+    }
+    emitSyntaxError(loc, msgWhat, msgWhy = '', msgHint = '') {
+        // console.error(issueTitle[2]) // Print the issue title.
+        const messageHeader = this.formatSignificantMessageLine(loc, issueTitle[2]);
+        console.error(messageHeader); // Print the issue title.
+        msgWhat && console.log(msgWhat);
+        msgWhy && console.log(msgWhy);
+        msgHint && console.log(msgHint);
+    }
+    emitSyntaxWarning(loc, msgWhat, msgWhy = '', msgHint = '') {
+        // console.warn(issueTitle[3]) // Print the issue title.
+        const messageHeader = this.formatSignificantMessageLine(loc, issueTitle[3]);
+        console.warn(messageHeader); // Print the issue title.
+        msgWhat && console.log(msgWhat);
+        msgWhy && console.log(msgWhy);
+        msgHint && console.log(msgHint);
+    }
+    emitNotice(loc, msgWhat, msgWhy = '', msgHint = '') {
+        // console.warn(issueTitle[4]) // Print the issue title.
+        const messageHeader = this.formatSignificantMessageLine(loc, issueTitle[4]);
+        console.warn(messageHeader); // Print the issue title.
+        msgWhat && console.log(msgWhat);
+        msgWhy && console.log(msgWhy);
+        msgHint && console.log(msgHint);
+    }
+    emitInfo(loc, msgWhat, msgWhy = '', msgHint = '') {
+        // console.info(issueTitle[5]) // Print the issue title.
+        const messageHeader = this.formatSignificantMessageLine(loc, issueTitle[5]);
+        console.info(messageHeader); // Print the issue title.
+        msgWhat && console.log(msgWhat);
+        msgWhy && console.log(msgWhy);
+        msgHint && console.log(msgHint);
+    }
+    getNumOfAllMessages() {
+        return (this.getNumOfErrors() +
+            this.getNumOfWarnings() +
+            this.getNumOfNotices() +
+            this.getNumOfNotices());
     }
     getNumOfErrors() {
         return (this.numFatalErrors + this.numInternalErrors + this.numSyntaxErrors);
@@ -196,8 +289,23 @@ class ErrorDataHandler {
     getNumOfWarnings() {
         return this.numSyntaxWarnings;
     }
-    getNumOfInfoAndNotices() {
-        return this.numNotices + this.numInfos;
+    getNumOfNotices() {
+        return this.numNotices;
+    }
+    getNumOfInfos() {
+        return this.numInfos;
+    }
+    getErrors() {
+        return this.errors;
+    }
+    getWarnings() {
+        return this.warnings;
+    }
+    getNotices() {
+        return this.notices;
+    }
+    getInfos() {
+        return this.infos;
     }
 }
 exports.ErrorDataHandler = ErrorDataHandler;

package/dist/core/objectBuilder.d.ts

@@ -1,6 +1,12 @@
-import { TJSObject, TSyntaxTreeContainer } from '../core/types';
+import { IYiniAST } from '../core/types';
 import { ErrorDataHandler } from './ErrorDataHandler';
 /**
- * Construct the final result of a JavaScript Object.
+ * Construct the final JavaScript Object.
+ * Transforms the AST to the plain JS object.
+ *
+ * - Keys are used exactly as-is.
+ * - Order of properties matches the AST traversal order.
+ *
+ * @note All `tag` fields MUST be ignored.
  */
-export declare const constructFinalObject: (syntaxTreeC: TSyntaxTreeContainer, errorHandler: ErrorDataHandler) => TJSObject;
+export declare const astToObject: (ast: IYiniAST, errorHandler: ErrorDataHandler) => Record<string, unknown>;