yini-parser 1.1.0-beta → 1.2.0-beta

package/dist/core/{ErrorDataHandler.js → errorDataHandler.js}

@@ -28,7 +28,7 @@ class ErrorDataHandler {
             - Level 1 = abort on errors only
             - Level 2 = abort even on warnings
      */
-    constructor(subjectType, threshold = '1-Abort-on-Errors', fileName = undefined) {
+    constructor(subjectType, fileName = undefined, bailSensitivityLevel = '1-Abort-on-Errors', isAvoidWarningsInConsole = false) {
         this.errors = [];
         this.warnings = [];
         this.notices = [];
@@ -40,8 +40,9 @@ class ErrorDataHandler {
         this.numNotices = 0;
         this.numInfos = 0;
         this.subjectType = subjectType;
-        this.persistThreshold = threshold;
         this.fileName = fileName;
+        this.persistThreshold = bailSensitivityLevel;
+        this.isAvoidWarningsInConsole = isAvoidWarningsInConsole;
     }
     makeIssue(line, column, type, message, advice = undefined, hint = undefined) {
         const issue = {
@@ -70,36 +71,29 @@ class ErrorDataHandler {
      * @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)('ctx.exception?.name       =' + ctx?.exception?.name);
+        (0, print_1.debugPrint)('ctx.exception?.message    = ' + ctx?.exception?.message);
+        (0, print_1.debugPrint)('exception?.offendingToken = ' + ctx?.exception?.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).
+        (0, print_1.debugPrint)('ctx.ruleIndex    = ' + ctx?.start.channel);
+        (0, print_1.debugPrint)('ctx.ruleIndex    = ' + ctx?.ruleIndex);
+        (0, print_1.debugPrint)('ctx.ruleContext  = ' + ctx?.ruleContext);
+        (0, print_1.debugPrint)('ctx.stop?.line   = ' + ctx?.stop?.line);
+        (0, print_1.debugPrint)('ctx.stop?.column = ' + ctx?.stop?.column);
+        const lineNum = ctx?.start.line || undefined; // Line (1-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)
+        const endCol = !!ctx?.stop?.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.
-            // msgWhatWithLineNum += ', at line: ' + lineNum
             msgWhatWithLineNum += ' at line ' + lineNum;
             if (colNum) {
                 msgWhatWithLineNum += ', column ' + colNum;
@@ -127,12 +121,8 @@ class ErrorDataHandler {
                 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(2)
-                    // }
                 }
                 break;
             case 'Syntax-Error':
@@ -142,26 +132,20 @@ class ErrorDataHandler {
                 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.isAvoidWarningsInConsole) {
+                    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':
@@ -182,22 +166,11 @@ class ErrorDataHandler {
                 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;
@@ -208,21 +181,13 @@ class ErrorDataHandler {
                 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}`
-                    // }
+                    line += `${this.fileName}`;
                 }
-                if (loc === null || loc === void 0 ? void 0 : loc.lineNum) {
+                if (loc?.lineNum) {
                     line += `:${loc.lineNum}`;
-                    if (loc === null || loc === void 0 ? void 0 : loc.colNum)
+                    if (loc?.colNum)
                         line += `:${loc.colNum}`;
                 }
                 return line;
@@ -230,7 +195,6 @@ class ErrorDataHandler {
         }
     }
     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);
@@ -238,7 +202,6 @@ class ErrorDataHandler {
         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);
@@ -246,7 +209,6 @@ class ErrorDataHandler {
         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);
@@ -254,7 +216,6 @@ class ErrorDataHandler {
         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);
@@ -262,7 +223,6 @@ class ErrorDataHandler {
         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);
@@ -270,7 +230,6 @@ class ErrorDataHandler {
         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);
@@ -309,3 +268,4 @@ class ErrorDataHandler {
     }
 }
 exports.ErrorDataHandler = ErrorDataHandler;
+//# sourceMappingURL=errorDataHandler.js.map

package/dist/core/errorDataHandler.js.map

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

package/dist/core/internalTypes.d.ts

@@ -0,0 +1,121 @@
+/**
+ * Internal types ONLY, public (user-facing) type should go into src/types/index.ts.
+ *
+ * @note
+ *   The use of null vs undefined
+ *   ----------------------------
+ *   The convention here (in this file) is:
+ *   - undefined is used where a value is missing, or does not apply.
+ *   - null is used where a value is missing or has not yet been computed.
+ *
+ * @note All names of **internal** types and interfaces (shapes) must be
+ * prefixed with `T` or `I`.
+ */
+import { OnDuplicateKey, PreferredFailLevel } from '../types';
+export type TParserMode = 'lenient' | 'strict';
+export type TSourceType = 'File' | 'Inline';
+export type TSubjectType = 'None/Ignore' | TSourceType;
+export type TBailSensitivityLevel = '0-Ignore-Errors' | '1-Abort-on-Errors' | '2-Abort-Even-on-Warnings';
+/**
+ * Scalar literal, a single, indivisible piece of data:
+ * string, number, boolean, and null.
+ * @property {string | undefined} [tag]
+ *           Its contents may change at any time and should not
+ *           be relied upon for any significant purpose.
+ * @note Undefined is included here despite that JSON cannot represent
+ *       it (undefined), but JS objects can (it's sometimes useful in
+ *       debugging etc), it will later get stripped if converted into JSON.
+ */
+export type TScalarValue = {
+    type: 'String';
+    value: string;
+    tag: string | undefined;
+} | {
+    type: 'Number';
+    value: number;
+    tag: string | undefined;
+} | {
+    type: 'Boolean';
+    value: boolean;
+    tag: string | undefined;
+} | {
+    type: 'Null';
+    value: null;
+    tag: string | undefined;
+} | {
+    type: 'Undefined';
+    value: undefined;
+    tag: string | undefined;
+};
+/** Any literal value in YINI: scalar, list, or object. */
+export type TValueLiteral = TScalarValue | TListValue | TObjectValue;
+/**
+ * @property {string | undefined} [tag]
+ *           Debugging only. Its contents may change at any time and
+ *           must not be relied upon for any functional purpose.
+ */
+export type TListValue = {
+    type: 'List';
+    elems: readonly TValueLiteral[];
+    tag: string | undefined;
+};
+/**
+ * @property {string | undefined} [tag]
+ *           Debugging only. Its contents may change at any time and
+ *           must not be relied upon for any functional purpose.
+ */
+export type TObjectValue = {
+    type: 'Object';
+    entries: Readonly<Record<string, TValueLiteral>>;
+    tag: string | undefined;
+};
+export type TSectionHeaderType = undefined | 'Classic-Header-Marker' | 'Numeric-Header-Marker';
+export type TIssueType = 'Fatal-Error' | 'Internal-Error' | 'Syntax-Error' | 'Syntax-Warning' | 'Notice' | 'Info';
+interface IMetaBaseInfo {
+    sourceType: TSourceType;
+    fileName: string | undefined;
+}
+/**
+ * Internal runtime info / meta data.
+ * @note Used for internal diagnostics, bookkeeping, state, etc.
+ */
+export interface IRuntimeInfo extends IMetaBaseInfo {
+    lineCount: number | null;
+    fileByteSize: number | null;
+    timeIoMs: number | null;
+    preferredBailSensitivity: null | PreferredFailLevel;
+    sha256: string | null;
+}
+export interface IParseCoreOptions {
+    isStrict: boolean;
+    bailSensitivity: TBailSensitivityLevel;
+    isIncludeMeta: boolean;
+    isWithDiagnostics: boolean;
+    isWithTiming: boolean;
+    isKeepUndefinedInMeta: boolean;
+    isAvoidWarningsInConsole: boolean;
+    requireDocTerminator: 'optional' | 'warn-if-missing' | 'required';
+    treatEmptyValueAsNull: 'allow' | 'allow-with-warning' | 'disallow';
+    onDuplicateKey: OnDuplicateKey;
+}
+export interface IYiniAST extends IMetaBaseInfo {
+    root: IYiniSection;
+    isStrict: boolean;
+    terminatorSeen: boolean;
+    yiniMarkerSeen: boolean;
+    maxDepth: number | null;
+    numOfSections: number;
+    numOfMembers: number;
+    sectionNamePaths: string[] | null;
+}
+export interface IYiniSection {
+    sectionName: string;
+    level: number;
+    members: Map<string, TValueLiteral>;
+    children: IYiniSection[];
+}
+export interface IBuildOptions {
+    mode?: 'lenient' | 'strict';
+    onDuplicateKey?: OnDuplicateKey;
+}
+export {};

package/dist/core/{types.js → internalTypes.js}

@@ -1,10 +1,16 @@
 "use strict";
 /**
+ * Internal types ONLY, public (user-facing) type should go into src/types/index.ts.
+ *
  * @note
  *   The use of null vs undefined
  *   ----------------------------
  *   The convention here (in this file) is:
  *   - undefined is used where a value is missing, or does not apply.
  *   - null is used where a value is missing or has not yet been computed.
+ *
+ * @note All names of **internal** types and interfaces (shapes) must be
+ * prefixed with `T` or `I`.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=internalTypes.js.map

package/dist/core/internalTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"internalTypes.js","sourceRoot":"","sources":["../../src/core/internalTypes.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG"}

package/dist/core/objectBuilder.d.ts

@@ -1,5 +1,5 @@
-import { IYiniAST } from '../core/types';
-import { ErrorDataHandler } from './ErrorDataHandler';
+import { ErrorDataHandler } from './errorDataHandler';
+import { IYiniAST } from './internalTypes';
 /**
  * Construct the final JavaScript Object.
  * Transforms the AST to the plain JS object.

package/dist/core/objectBuilder.js

@@ -146,3 +146,4 @@ const define = (obj, key, value) => {
         writable: true,
     });
 };
+//# sourceMappingURL=objectBuilder.js.map

package/dist/core/objectBuilder.js.map

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

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

@@ -0,0 +1,3 @@
+import { PreferredFailLevel } from '../../types';
+import { TBailSensitivityLevel } from '../internalTypes';
+export declare function mapFailLevelToBail(isStrict: boolean, failLevel: PreferredFailLevel): TBailSensitivityLevel;

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

@@ -0,0 +1,5 @@
+import { AllUserOptions } from '../../types';
+import { IParseCoreOptions, TBailSensitivityLevel, TParserMode } from '../internalTypes';
+export declare const toCoreOptions: (bailLevel: TBailSensitivityLevel, userOpts: Required<AllUserOptions>) => IParseCoreOptions;
+export declare const isOptionsObjectForm: (v: unknown) => v is AllUserOptions;
+export declare const inferModeFromArgs: (arg2?: boolean | AllUserOptions) => TParserMode;

package/dist/core/options/normalizeOptions.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.inferModeFromArgs = exports.isOptionsObjectForm = exports.toCoreOptions = void 0;
+const env_1 = require("../../config/env");
+const toCoreOptions = (bailLevel, userOpts) => {
+    return {
+        isStrict: userOpts.strictMode,
+        bailSensitivity: bailLevel,
+        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,
+        isAvoidWarningsInConsole: userOpts.suppressWarnings,
+        requireDocTerminator: userOpts.requireDocTerminator,
+        treatEmptyValueAsNull: userOpts.treatEmptyValueAsNull,
+        onDuplicateKey: userOpts.onDuplicateKey,
+    };
+};
+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 ||
+            'suppressWarnings' in v ||
+            'requireDocTerminator' in v ||
+            'treatEmptyValueAsNull' in v ||
+            'onDuplicateKey' in v));
+};
+exports.isOptionsObjectForm = isOptionsObjectForm;
+// const mode: TParserMode =
+// ((arg2 as any)?.strictMode ?? (arg2 as boolean | undefined)) ===
+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=normalizeOptions.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"normalizeOptions.js","sourceRoot":"","sources":["../../../src/core/options/normalizeOptions.ts"],"names":[],"mappings":";;;AAAA,0CAAiD;AAQ1C,MAAM,aAAa,GAAG,CACzB,SAAgC,EAChC,QAAkC,EACjB,EAAE;IACnB,OAAO;QACH,QAAQ,EAAE,QAAQ,CAAC,UAAU;QAC7B,eAAe,EAAE,SAAS;QAC1B,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,wBAAwB,EAAE,QAAQ,CAAC,gBAAgB;QACnD,oBAAoB,EAAE,QAAQ,CAAC,oBAAoB;QACnD,qBAAqB,EAAE,QAAQ,CAAC,qBAAqB;QACrD,cAAc,EAAE,QAAQ,CAAC,cAAc;KAC1C,CAAA;AACL,CAAC,CAAA;AAhBY,QAAA,aAAa,iBAgBzB;AAED,0DAA0D;AACnD,MAAM,mBAAmB,GAAG,CAAC,CAAU,EAAuB,EAAE;IACnE,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,kBAAkB,IAAK,CAAS;YAChC,sBAAsB,IAAK,CAAS;YACpC,uBAAuB,IAAK,CAAS;YACrC,gBAAgB,IAAK,CAAS,CAAC,CACtC,CAAA;AACL,CAAC,CAAA;AAjBY,QAAA,mBAAmB,uBAiB/B;AAED,4BAA4B;AAC5B,mEAAmE;AAE5D,MAAM,iBAAiB,GAAG,CAC7B,IAA+B,EACpB,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,IAAuB,CAAC,UAAU,CAAA;QAC9C,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/options/parserOptionsConstants.d.ts

@@ -0,0 +1,7 @@
+import { AllUserOptions } from '../../types';
+import { TParserMode } from '../internalTypes';
+export declare const getDefaultOptions: (mode: TParserMode) => Required<Pick<AllUserOptions, "includeDiagnostics" | "includeTiming" | "preserveUndefinedInMeta" | "suppressWarnings" | "requireDocTerminator" | "treatEmptyValueAsNull" | "onDuplicateKey" | "strictMode" | "failLevel" | "includeMetadata">>;
+export type NormalizedOptions = Required<Pick<AllUserOptions, 'strictMode' | 'failLevel' | 'includeMetadata' | 'includeDiagnostics' | 'includeTiming' | 'preserveUndefinedInMeta' | 'suppressWarnings' | 'requireDocTerminator' | 'treatEmptyValueAsNull' | 'onDuplicateKey'>>;
+export declare const BASE_DEFAULTS: NormalizedOptions;
+export declare const DEFAULT_LENIENT_OPTS: NormalizedOptions;
+export declare const DEFAULT_STRICT_OPTS: NormalizedOptions;

package/dist/core/options/parserOptionsConstants.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_STRICT_OPTS = exports.DEFAULT_LENIENT_OPTS = exports.BASE_DEFAULTS = exports.getDefaultOptions = void 0;
+const getDefaultOptions = (mode) => mode === 'strict' ? exports.DEFAULT_STRICT_OPTS : exports.DEFAULT_LENIENT_OPTS;
+exports.getDefaultOptions = getDefaultOptions;
+// Base (mode-agnostic) defaults
+exports.BASE_DEFAULTS = {
+    strictMode: false,
+    failLevel: 'auto',
+    includeMetadata: false,
+    includeDiagnostics: false,
+    includeTiming: false,
+    preserveUndefinedInMeta: false,
+    suppressWarnings: false, // Suppress warnings in console (does not affect warnings in meta data).
+    requireDocTerminator: 'optional',
+    treatEmptyValueAsNull: 'allow-with-warning',
+    onDuplicateKey: 'error',
+};
+exports.DEFAULT_LENIENT_OPTS = {
+    ...exports.BASE_DEFAULTS,
+    strictMode: false,
+    failLevel: 'ignore-errors',
+    suppressWarnings: false, // Suppress warnings in console (does not affect warnings in meta data).
+    requireDocTerminator: 'optional',
+    treatEmptyValueAsNull: 'allow-with-warning',
+    onDuplicateKey: 'warn-and-keep-first',
+};
+exports.DEFAULT_STRICT_OPTS = {
+    ...exports.BASE_DEFAULTS,
+    strictMode: true,
+    failLevel: 'errors',
+    suppressWarnings: false, // Suppress warnings in console (does not affect warnings in meta data).
+    requireDocTerminator: 'optional',
+    treatEmptyValueAsNull: 'disallow',
+    onDuplicateKey: 'error',
+};
+//# sourceMappingURL=parserOptionsConstants.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parserOptionsConstants.js","sourceRoot":"","sources":["../../../src/core/options/parserOptionsConstants.ts"],"names":[],"mappings":";;;AAGO,MAAM,iBAAiB,GAAG,CAAC,IAAiB,EAAE,EAAE,CACnD,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,2BAAmB,CAAC,CAAC,CAAC,4BAAoB,CAAA;AADrD,QAAA,iBAAiB,qBACoC;AAkBlE,gCAAgC;AACnB,QAAA,aAAa,GAAsB;IAC5C,UAAU,EAAE,KAAK;IACjB,SAAS,EAAE,MAAM;IACjB,eAAe,EAAE,KAAK;IACtB,kBAAkB,EAAE,KAAK;IACzB,aAAa,EAAE,KAAK;IACpB,uBAAuB,EAAE,KAAK;IAC9B,gBAAgB,EAAE,KAAK,EAAE,wEAAwE;IACjG,oBAAoB,EAAE,UAAU;IAChC,qBAAqB,EAAE,oBAAoB;IAC3C,cAAc,EAAE,OAAO;CAC1B,CAAA;AAEY,QAAA,oBAAoB,GAAsB;IACnD,GAAG,qBAAa;IAChB,UAAU,EAAE,KAAK;IACjB,SAAS,EAAE,eAAe;IAC1B,gBAAgB,EAAE,KAAK,EAAE,wEAAwE;IACjG,oBAAoB,EAAE,UAAU;IAChC,qBAAqB,EAAE,oBAAoB;IAC3C,cAAc,EAAE,qBAAqB;CACxC,CAAA;AAEY,QAAA,mBAAmB,GAAsB;IAClD,GAAG,qBAAa;IAChB,UAAU,EAAE,IAAI;IAChB,SAAS,EAAE,QAAQ;IACnB,gBAAgB,EAAE,KAAK,EAAE,wEAAwE;IACjG,oBAAoB,EAAE,UAAU;IAChC,qBAAqB,EAAE,UAAU;IACjC,cAAc,EAAE,OAAO;CAC1B,CAAA"}

package/dist/core/pipeline.d.ts

@@ -0,0 +1,18 @@
+/**
+ * This file is the orchestrator that wires up the pipeline (lexer → parser →
+ * astBuilder → objectBuilder, etc.)
+ */
+import { AllUserOptions, ParsedObject, 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: AllUserOptions) => ParsedObject | YiniParseResult;