yini-parser 1.1.0-beta → 1.3.0-beta

package/dist/core/options/failLevel.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mapFailLevelToBail = mapFailLevelToBail;
+function mapFailLevelToBail(isStrict, failLevel) {
+    let bailLevel = '0-Ignore-Errors';
+    if (failLevel === 'auto') {
+        if (!isStrict)
+            bailLevel = '0-Ignore-Errors';
+        if (isStrict)
+            bailLevel = '1-Abort-on-Errors';
+    }
+    else {
+        switch (failLevel) {
+            case 'ignore-errors':
+                bailLevel = '0-Ignore-Errors';
+                break;
+            case 'errors':
+                bailLevel = '1-Abort-on-Errors';
+                break;
+            case 'warnings-and-errors':
+                bailLevel = '2-Abort-Even-on-Warnings';
+                break;
+        }
+    }
+    return bailLevel;
+}
+//# sourceMappingURL=failLevel.js.map

package/dist/core/options/failLevel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"failLevel.js","sourceRoot":"","sources":["../../../src/core/options/failLevel.ts"],"names":[],"mappings":";;AAKA,gDAwBC;AAxBD,SAAgB,kBAAkB,CAC9B,QAAiB,EACjB,SAA6B;IAE7B,IAAI,SAAS,GAA0B,iBAAiB,CAAA;IAExD,IAAI,SAAS,KAAK,MAAM,EAAE,CAAC;QACvB,IAAI,CAAC,QAAQ;YAAE,SAAS,GAAG,iBAAiB,CAAA;QAC5C,IAAI,QAAQ;YAAE,SAAS,GAAG,mBAAmB,CAAA;IACjD,CAAC;SAAM,CAAC;QACJ,QAAQ,SAAS,EAAE,CAAC;YAChB,KAAK,eAAe;gBAChB,SAAS,GAAG,iBAAiB,CAAA;gBAC7B,MAAK;YACT,KAAK,QAAQ;gBACT,SAAS,GAAG,mBAAmB,CAAA;gBAC/B,MAAK;YACT,KAAK,qBAAqB;gBACtB,SAAS,GAAG,0BAA0B,CAAA;gBACtC,MAAK;QACb,CAAC;IACL,CAAC;IAED,OAAO,SAAS,CAAA;AACpB,CAAC"}

package/dist/core/options/optionsFunctions.d.ts

@@ -0,0 +1,8 @@
+import { ParseOptions } from '../../types';
+import { IParseCoreOptions, TBailSensitivityLevel, TParserMode } from '../internalTypes';
+/**
+ * Map user parse options to core options.
+ */
+export declare const toCoreOptions: (userOpts: Required<ParseOptions>, bailLevel?: TBailSensitivityLevel) => IParseCoreOptions;
+export declare const isOptionsObjectForm: (v: unknown) => v is ParseOptions;
+export declare const inferModeFromArgs: (arg2?: boolean | ParseOptions) => TParserMode;

package/dist/core/options/optionsFunctions.js

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.inferModeFromArgs = exports.isOptionsObjectForm = exports.toCoreOptions = void 0;
+const env_1 = require("../../config/env");
+const failLevel_1 = require("./failLevel");
+/**
+ * Map user parse options to core options.
+ */
+const toCoreOptions = (userOpts, bailLevel) => {
+    const level = bailLevel ?? (0, failLevel_1.mapFailLevelToBail)(userOpts.strictMode, userOpts.failLevel);
+    return {
+        rules: {
+            initialMode: userOpts.strictMode ? 'strict' : 'lenient',
+            onDuplicateKey: userOpts.onDuplicateKey,
+            requireDocTerminator: userOpts.requireDocTerminator,
+            treatEmptyValueAsNull: userOpts.treatEmptyValueAsNull,
+        },
+        bailSensitivity: level,
+        isIncludeMeta: userOpts.includeMetadata,
+        isWithDiagnostics: (0, env_1.isDev)() || (0, env_1.isDebug)() || userOpts.includeDiagnostics,
+        isWithTiming: (0, env_1.isDev)() || (0, env_1.isDebug)() || userOpts.includeTiming,
+        isKeepUndefinedInMeta: (0, env_1.isDebug)() || userOpts.preserveUndefinedInMeta,
+        isQuiet: userOpts.quiet, // Dup of suppressWarnings!
+        isSilent: userOpts.silent,
+        isThrowOnError: userOpts.throwOnError,
+    };
+};
+exports.toCoreOptions = toCoreOptions;
+// Type guard: did the caller use the options-object form?
+const isOptionsObjectForm = (v) => {
+    return (v != null &&
+        typeof v === 'object' &&
+        // Note: If one wants, this can be relax to "typeof v === 'object'"
+        // but this keeps accidental booleans/strings out.
+        ('strictMode' in v ||
+            'failLevel' in v ||
+            'includeMetadata' in v ||
+            'includeDiagnostics' in v ||
+            'includeTiming' in v ||
+            'preserveUndefinedInMeta' in v ||
+            'onDuplicateKey' in v ||
+            'requireDocTerminator' in v ||
+            'treatEmptyValueAsNull' in v ||
+            'quiet' in v ||
+            'silent' in v ||
+            'isThrowOnError' in v));
+};
+exports.isOptionsObjectForm = isOptionsObjectForm;
+const inferModeFromArgs = (arg2) => {
+    if (typeof arg2 === 'boolean') {
+        return arg2 ? 'strict' : 'lenient';
+    }
+    if (arg2 && typeof arg2 === 'object') {
+        const sm = arg2.strictMode;
+        if (typeof sm === 'boolean') {
+            return sm ? 'strict' : 'lenient';
+        }
+    }
+    return 'lenient';
+};
+exports.inferModeFromArgs = inferModeFromArgs;
+//# sourceMappingURL=optionsFunctions.js.map

package/dist/core/options/optionsFunctions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"optionsFunctions.js","sourceRoot":"","sources":["../../../src/core/options/optionsFunctions.ts"],"names":[],"mappings":";;;AAAA,0CAAiD;AAOjD,2CAAgD;AAEhD;;GAEG;AACI,MAAM,aAAa,GAAG,CACzB,QAAgC,EAChC,SAAiC,EAChB,EAAE;IACnB,MAAM,KAAK,GACP,SAAS,IAAI,IAAA,8BAAkB,EAAC,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAA;IAE5E,OAAO;QACH,KAAK,EAAE;YACH,WAAW,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;YACvD,cAAc,EAAE,QAAQ,CAAC,cAAc;YACvC,oBAAoB,EAAE,QAAQ,CAAC,oBAAoB;YACnD,qBAAqB,EAAE,QAAQ,CAAC,qBAAqB;SACxD;QACD,eAAe,EAAE,KAAK;QACtB,aAAa,EAAE,QAAQ,CAAC,eAAe;QACvC,iBAAiB,EAAE,IAAA,WAAK,GAAE,IAAI,IAAA,aAAO,GAAE,IAAI,QAAQ,CAAC,kBAAkB;QACtE,YAAY,EAAE,IAAA,WAAK,GAAE,IAAI,IAAA,aAAO,GAAE,IAAI,QAAQ,CAAC,aAAa;QAC5D,qBAAqB,EAAE,IAAA,aAAO,GAAE,IAAI,QAAQ,CAAC,uBAAuB;QACpE,OAAO,EAAE,QAAQ,CAAC,KAAK,EAAE,2BAA2B;QACpD,QAAQ,EAAE,QAAQ,CAAC,MAAM;QACzB,cAAc,EAAE,QAAQ,CAAC,YAAY;KACxC,CAAA;AACL,CAAC,CAAA;AAvBY,QAAA,aAAa,iBAuBzB;AAED,0DAA0D;AACnD,MAAM,mBAAmB,GAAG,CAAC,CAAU,EAAqB,EAAE;IACjE,OAAO,CACH,CAAC,IAAI,IAAI;QACT,OAAO,CAAC,KAAK,QAAQ;QACrB,mEAAmE;QACnE,kDAAkD;QAClD,CAAC,YAAY,IAAK,CAAS;YACvB,WAAW,IAAK,CAAS;YACzB,iBAAiB,IAAK,CAAS;YAC/B,oBAAoB,IAAK,CAAS;YAClC,eAAe,IAAK,CAAS;YAC7B,yBAAyB,IAAK,CAAS;YACvC,gBAAgB,IAAK,CAAS;YAC9B,sBAAsB,IAAK,CAAS;YACpC,uBAAuB,IAAK,CAAS;YACrC,OAAO,IAAK,CAAS;YACrB,QAAQ,IAAK,CAAS;YACtB,gBAAgB,IAAK,CAAS,CAAC,CACtC,CAAA;AACL,CAAC,CAAA;AAnBY,QAAA,mBAAmB,uBAmB/B;AAEM,MAAM,iBAAiB,GAAG,CAC7B,IAA6B,EAClB,EAAE;IACb,IAAI,OAAO,IAAI,KAAK,SAAS,EAAE,CAAC;QAC5B,OAAO,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAA;IACtC,CAAC;IACD,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QACnC,MAAM,EAAE,GAAI,IAAqB,CAAC,UAAU,CAAA;QAC5C,IAAI,OAAO,EAAE,KAAK,SAAS,EAAE,CAAC;YAC1B,OAAO,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAA;QACpC,CAAC;IACL,CAAC;IACD,OAAO,SAAS,CAAA;AACpB,CAAC,CAAA;AAbY,QAAA,iBAAiB,qBAa7B"}

package/dist/core/parsingRules/modeFromRulesMatcher.d.ts

@@ -0,0 +1,8 @@
+import { ParseOptions } from 'querystring';
+import { IParseCoreOptions, TExactMode } from '../internalTypes';
+export declare const matchModeFromParseOptions: (parserOptions: ParseOptions) => TExactMode;
+/**
+ * Determines the effective parse mode from the current options (option rules).
+ * @returns 'custom' if no exact match exists, otherwise the matched mode.
+ */
+export declare const matchModeFromCoreOptions: (coreOptions: IParseCoreOptions) => TExactMode;

package/dist/core/parsingRules/modeFromRulesMatcher.js

@@ -0,0 +1,114 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.matchModeFromCoreOptions = exports.matchModeFromParseOptions = void 0;
+const env_1 = require("../../config/env");
+const print_1 = require("../../utils/print");
+const errorDataHandler_1 = require("../errorDataHandler");
+const optionsFunctions_1 = require("../options/optionsFunctions");
+const MODE_PROFILES = {
+    lenient: [0, 0, 0],
+    //   moderate: [1, 0, 1],
+    strict: [2, 0, 2],
+    //'pedantic'
+    //'paranoid'
+};
+const matchModeFromParseOptions = (parserOptions) => (0, exports.matchModeFromCoreOptions)((0, optionsFunctions_1.toCoreOptions)(parserOptions));
+exports.matchModeFromParseOptions = matchModeFromParseOptions;
+/**
+ * Determines the effective parse mode from the current options (option rules).
+ * @returns 'custom' if no exact match exists, otherwise the matched mode.
+ */
+const matchModeFromCoreOptions = (coreOptions) => {
+    (0, print_1.debugPrint)('-> matchModeFromRules(..):');
+    if (!coreOptions?.rules) {
+        // Note, after pushing processing may continue or exit, depending on the error and/or the bail threshold.
+        new errorDataHandler_1.ErrorDataHandler('None/Ignore').pushOrBail(null, 'Fatal-Error', `The passed input object is missing rules object.`, 'Option might be of wrong type, it must be core options.');
+    }
+    // debugPrint(
+    //     'coreOptions.rules.?onDuplicateKey        = ' +
+    //         coreOptions.rules?.onDuplicateKey,
+    // )
+    // debugPrint(
+    //     'coreOptions.rules.?requireDocTerminator  = ' +
+    //         coreOptions.rules?.requireDocTerminator,
+    // )
+    // debugPrint(
+    //     'coreOptions.rules.?treatEmptyValueAsNull = ' +
+    //         coreOptions.rules?.treatEmptyValueAsNull,
+    // )
+    const rules = { ...coreOptions.rules };
+    // if (rules.onDuplicateKey === 'error') {
+    //     if (rules.treatEmptyValueAsNull == 'disallow') {
+    //         return 'strict'
+    //     }
+    //     return 'lenient'
+    // }
+    // return 'custom'
+    const res = inferTParserModeExact(rules);
+    (0, print_1.debugPrint)('          mode = ' + res.mode);
+    (0, print_1.debugPrint)('        vector = ' + res.vector);
+    (0, print_1.debugPrint)('matchedProfile = ' + res.matchedProfile);
+    return res.mode;
+};
+exports.matchModeFromCoreOptions = matchModeFromCoreOptions;
+/**
+ * Infer mode by **exact vector match** to a canonical profile (option rules).
+ * If no exact match exists, returns 'custom'.
+ */
+const inferTParserModeExact = (rules) => {
+    // debugPrint('-> inferTParserModeExact(..):')
+    // debugPrint('rules.onDuplicateKey        = ' + rules.onDuplicateKey)
+    // debugPrint('rules.requireDocTerminator  = ' + rules.requireDocTerminator)
+    // debugPrint('rules.treatEmptyValueAsNull = ' + rules.treatEmptyValueAsNull)
+    // Note, **each rule** is scored on a strictness scale (0 = lenient, 1 = medium, 2 = strict).
+    const vector = [
+        scoreDupl(rules.onDuplicateKey),
+        scoreTerm(rules.requireDocTerminator),
+        scoreEmpty(rules.treatEmptyValueAsNull),
+    ];
+    (0, print_1.debugPrint)('** vector:');
+    // isDebug() && printObject(vector)
+    (0, env_1.isDebug)() && console.log(vector);
+    for (const mode of Object.keys(MODE_PROFILES)) {
+        if (vecEquals(vector, MODE_PROFILES[mode])) {
+            return { mode, vector, matchedProfile: mode };
+        }
+    }
+    return { mode: 'custom', vector };
+};
+const scoreDupl = (v) => {
+    switch (v) {
+        case 'keep-first':
+        case 'warn-and-keep-first':
+            return 0; // Rule in lenient mode.
+        case 'overwrite':
+        case 'warn-and-overwrite':
+            return 1;
+        case 'error':
+            return 2; // Rule in strict mode.
+    }
+};
+const scoreTerm = (v) => {
+    switch (v) {
+        case 'optional':
+            return 0; // Rule in lenient and strict mode.
+        case 'warn-if-missing':
+            return 1;
+        case 'required':
+            return 2;
+    }
+};
+const scoreEmpty = (v) => {
+    switch (v) {
+        case 'allow':
+            return 0; // Rule in lenient mode.
+        case 'allow-with-warning':
+            return 1;
+        case 'disallow':
+            return 2; // Rule in strict mode.
+    }
+};
+const vecEquals = (a, b) => {
+    return a[0] === b[0] && a[1] === b[1] && a[2] === b[2];
+};
+//# sourceMappingURL=modeFromRulesMatcher.js.map

package/dist/core/parsingRules/modeFromRulesMatcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"modeFromRulesMatcher.js","sourceRoot":"","sources":["../../../src/core/parsingRules/modeFromRulesMatcher.ts"],"names":[],"mappings":"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"}

package/dist/core/parsingRules/rulesConstAndGuards.d.ts

@@ -0,0 +1,7 @@
+import { DocumentTerminatorRule, DuplicateKeyPolicy, EmptyValueRule } from '../../types';
+export declare const DuplicateKeyPolicies: readonly ["error", "warn-and-keep-first", "warn-and-overwrite", "keep-first", "overwrite"];
+export declare const DocumentTerminatorRules: readonly ["optional", "warn-if-missing", "required"];
+export declare const EmptyValueRules: readonly ["allow", "allow-with-warning", "disallow"];
+export declare const isDuplicateKeyPolicy: (v: unknown) => v is DuplicateKeyPolicy;
+export declare const isDocumentTerminatorRule: (v: unknown) => v is DocumentTerminatorRule;
+export declare const isEmptyValueRule: (v: unknown) => v is EmptyValueRule;

package/dist/core/parsingRules/rulesConstAndGuards.js

@@ -0,0 +1,35 @@
+"use strict";
+// --- Parsing Rule Values -------------------------------------------------
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isEmptyValueRule = exports.isDocumentTerminatorRule = exports.isDuplicateKeyPolicy = exports.EmptyValueRules = exports.DocumentTerminatorRules = exports.DuplicateKeyPolicies = void 0;
+/*
+    NOTE: These rule values are re-exported as **types** (derived from these consants) in types/index.ts.
+    NOTE: These constant gives runtime access as they are also used in error messages.
+*/
+exports.DuplicateKeyPolicies = [
+    'error',
+    'warn-and-keep-first', // Keep first with a warning.
+    'warn-and-overwrite', // 'warn-and-overwrite' = 'warn-and-keep-last'
+    'keep-first', // Silent, first wins.
+    'overwrite', // Silent, last wins.
+];
+exports.DocumentTerminatorRules = [
+    'optional',
+    'warn-if-missing',
+    'required',
+];
+exports.EmptyValueRules = [
+    'allow',
+    'allow-with-warning',
+    'disallow',
+];
+// --- Runtime Guards ------------------------------------------------------
+const isDuplicateKeyPolicy = (v) => typeof v === 'string' &&
+    exports.DuplicateKeyPolicies.includes(v);
+exports.isDuplicateKeyPolicy = isDuplicateKeyPolicy;
+const isDocumentTerminatorRule = (v) => typeof v === 'string' &&
+    exports.DocumentTerminatorRules.includes(v);
+exports.isDocumentTerminatorRule = isDocumentTerminatorRule;
+const isEmptyValueRule = (v) => typeof v === 'string' && exports.EmptyValueRules.includes(v);
+exports.isEmptyValueRule = isEmptyValueRule;
+//# sourceMappingURL=rulesConstAndGuards.js.map

package/dist/core/parsingRules/rulesConstAndGuards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rulesConstAndGuards.js","sourceRoot":"","sources":["../../../src/core/parsingRules/rulesConstAndGuards.ts"],"names":[],"mappings":";AAAA,4EAA4E;;;AAQ5E;;;EAGE;AAEW,QAAA,oBAAoB,GAAG;IAChC,OAAO;IACP,qBAAqB,EAAE,6BAA6B;IACpD,oBAAoB,EAAE,8CAA8C;IACpE,YAAY,EAAE,sBAAsB;IACpC,WAAW,EAAE,qBAAqB;CAC5B,CAAA;AAEG,QAAA,uBAAuB,GAAG;IACnC,UAAU;IACV,iBAAiB;IACjB,UAAU;CACJ,CAAA;AAEG,QAAA,eAAe,GAAG;IAC3B,OAAO;IACP,oBAAoB;IACpB,UAAU;CACJ,CAAA;AAEV,4EAA4E;AAErE,MAAM,oBAAoB,GAAG,CAAC,CAAU,EAA2B,EAAE,CACxE,OAAO,CAAC,KAAK,QAAQ;IACpB,4BAA0C,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAA;AAF9C,QAAA,oBAAoB,wBAE0B;AAEpD,MAAM,wBAAwB,GAAG,CACpC,CAAU,EACiB,EAAE,CAC7B,OAAO,CAAC,KAAK,QAAQ;IACpB,+BAA6C,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAA;AAJjD,QAAA,wBAAwB,4BAIyB;AAEvD,MAAM,gBAAgB,GAAG,CAAC,CAAU,EAAuB,EAAE,CAChE,OAAO,CAAC,KAAK,QAAQ,IAAK,uBAAqC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAA;AADlE,QAAA,gBAAgB,oBACkD"}

package/dist/core/pipeline/errorListeners.d.ts

@@ -0,0 +1,18 @@
+import { ErrorListener, RecognitionException } from 'antlr4';
+import { ErrorDataHandler } from '../errorDataHandler';
+export declare const createLexerErrorListener: (errorHandler: ErrorDataHandler) => MyLexerErrorListener;
+export declare const createParserErrorListener: (errorHandler: ErrorDataHandler) => MyParserErrorListener;
+declare class MyLexerErrorListener implements ErrorListener<any> {
+    private errorHandler;
+    constructor(errorHandler: ErrorDataHandler);
+    syntaxError(recognizer: any, offendingSymbol: any, line: number, charPositionInLine: number, msg: string, e: RecognitionException | undefined): void;
+}
+declare class MyParserErrorListener implements ErrorListener<any> {
+    private errorHandler;
+    constructor(errorHandler: ErrorDataHandler);
+    syntaxError(recognizer: any, offendingSymbol: any, line: number, charPositionInLine: number, msg: string, e: RecognitionException | undefined): void;
+    reportAmbiguity(...args: any[]): void;
+    reportAttemptingFullContext(...args: any[]): void;
+    reportContextSensitivity(...args: any[]): void;
+}
+export {};

package/dist/core/pipeline/errorListeners.js

@@ -0,0 +1,107 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createParserErrorListener = exports.createLexerErrorListener = void 0;
+const util_1 = require("util");
+const antlr4_1 = require("antlr4");
+const env_1 = require("../../config/env");
+const YiniParser_1 = require("../../grammar/generated/YiniParser");
+const print_1 = require("../../utils/print");
+const createLexerErrorListener = (errorHandler) => {
+    return new MyLexerErrorListener(errorHandler);
+};
+exports.createLexerErrorListener = createLexerErrorListener;
+const createParserErrorListener = (errorHandler) => {
+    return new MyParserErrorListener(errorHandler);
+};
+exports.createParserErrorListener = createParserErrorListener;
+/**
+ * @param line Line number as 1-based.
+ * @param col Column number as 0-based.
+ *
+ * @note Refactor away this function if possible, due to this context ad-hoc
+ * is brittle, it relies on runtime internals of ANTLR generated code.
+ */
+const createGeneralCtx = (line, endColumn, startColumn = undefined) => {
+    const startToken = new antlr4_1.Token();
+    const stopToken = new antlr4_1.Token();
+    const ctx = new YiniParser_1.YiniContext();
+    ctx.start = startToken;
+    ctx.stop = stopToken;
+    ctx.start.line = line; // Note: Line num is 1-based.
+    // if (startColumn && startColumn >= 0) {
+    if (startColumn !== undefined) {
+        ctx.start.column = startColumn; // Note: Column num is 0-based.
+        ctx.stop.line = line;
+    }
+    ctx.stop.column = endColumn; // Note: Column num is 0-based.
+    return ctx;
+};
+const parsePossibleStartCol = (errorHandler, recognizer) => {
+    let possibleStartCol = undefined;
+    try {
+        possibleStartCol = recognizer?._ctx.start?.column
+            ? recognizer?._ctx.start?.column + 1
+            : undefined;
+    }
+    catch (err) {
+        let msgHint = '';
+        if ((0, util_1.isError)(err)) {
+            msgHint = 'Error: ' + err.message;
+        }
+        else {
+            msgHint = 'Thrown value:' + JSON.stringify(err);
+        }
+        if ((0, env_1.isProdEnv)()) {
+            // return 0
+            return undefined;
+        }
+        errorHandler.pushOrBail(null, 'Internal-Error', 'Catched error of possibleStartCol in parser grammar listener.', msgHint);
+    }
+    return possibleStartCol;
+};
+class MyLexerErrorListener {
+    constructor(errorHandler) {
+        this.errorHandler = errorHandler;
+    }
+    syntaxError(recognizer, offendingSymbol, line, charPositionInLine, msg, e) {
+        // Handle the error as you want:
+        (0, print_1.debugPrint)('ANTLR lexer cached an error');
+        const col = charPositionInLine + 1;
+        const possibleStartCol = parsePossibleStartCol(this.errorHandler, recognizer);
+        // const msgWhat = `Syntax error at line ${line}, column ${col}:`
+        const msgWhat = `Syntax error`;
+        // Try to map message:
+        // From: "mismatched input '/END' expecting <EOF>"
+        // To:   "Found '/END', but expected the end of the document."
+        // const msgWhy = `${capitalizeFirst(msg)}`
+        const msgWhy = `Details: ${msg}`;
+        // const msgHint = ``
+        const ctx = createGeneralCtx(line, charPositionInLine, possibleStartCol); // So we can show line/col in error message.
+        // Note, after pushing processing may continue or exit, depending on the error and/or the bail threshold.
+        this.errorHandler.pushOrBail(ctx, 'Syntax-Error', msgWhat, msgWhy);
+    }
+}
+class MyParserErrorListener {
+    constructor(errorHandler) {
+        this.errorHandler = errorHandler;
+    }
+    syntaxError(recognizer, offendingSymbol, line, charPositionInLine, msg, e) {
+        (0, print_1.debugPrint)('ANTLR parser cached an error');
+        const col = charPositionInLine + 1;
+        const possibleStartCol = parsePossibleStartCol(this.errorHandler, recognizer);
+        const msgWhat = `Syntax error`;
+        // Try to map message:
+        // From: "mismatched input '/END' expecting <EOF>"
+        // To:   "Found '/END', but expected the end of the document."
+        // const msgWhy = `${capitalizeFirst(msg)}`
+        const msgWhy = `Details: ${msg}`;
+        const ctx = createGeneralCtx(line, charPositionInLine, possibleStartCol); // So we can show line/col in error message.
+        // Note, after pushing processing may continue or exit, depending on the error and/or the bail threshold.
+        this.errorHandler.pushOrBail(ctx, 'Syntax-Error', msgWhat, msgWhy);
+    }
+    // The following are required for the interface, but can be left empty.
+    reportAmbiguity(...args) { }
+    reportAttemptingFullContext(...args) { }
+    reportContextSensitivity(...args) { }
+}
+//# sourceMappingURL=errorListeners.js.map

package/dist/core/pipeline/errorListeners.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorListeners.js","sourceRoot":"","sources":["../../../src/core/pipeline/errorListeners.ts"],"names":[],"mappings":"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"}

package/dist/core/pipeline/pipeline.d.ts

@@ -0,0 +1,18 @@
+/**
+ * This file is the orchestrator that wires up the pipeline (lexer → parser →
+ * astBuilder → objectBuilder, etc.)
+ */
+import { ParsedObject, ParseOptions, YiniParseResult } from '../../types';
+import { IParseCoreOptions, IRuntimeInfo } from '../internalTypes';
+/**
+ * @internal Single source of truth.
+ *
+ * Entrypoint for the YINI parsing pipeline:
+ * tokenization → grammar parse → AST build → object build → result.
+ *
+ * @param _meta_userOpts The user options from which the core options were
+ *        derived/resolved from. This object is provided only for debugging
+ *        and metadata purposes and should not be relied upon in
+ *        application logic.
+ */
+export declare const runPipeline: (yiniContent: string, coreOptions: IParseCoreOptions, runtimeInfo: IRuntimeInfo, _meta_userOpts: ParseOptions) => ParsedObject | YiniParseResult;