yini-parser 1.1.0-beta → 1.3.0-beta

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

@@ -28,7 +28,9 @@ 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', isQuiet = false, // Reduce output (show only errors, does not effect warnings and etc. in meta data).
+    isSilent = false, // Suppress all output (even errors, exit code only).
+    isThrowOnError = false) {
         this.errors = [];
         this.warnings = [];
         this.notices = [];
@@ -40,8 +42,11 @@ class ErrorDataHandler {
         this.numNotices = 0;
         this.numInfos = 0;
         this.subjectType = subjectType;
-        this.persistThreshold = threshold;
         this.fileName = fileName;
+        this.persistThreshold = bailSensitivityLevel;
+        this.isQuiet = isQuiet;
+        this.isSilent = isSilent;
+        this.isThrowOnError = isThrowOnError;
     }
     makeIssue(line, column, type, message, advice = undefined, hint = undefined) {
         const issue = {
@@ -58,48 +63,43 @@ class ErrorDataHandler {
     }
     /**
      * After pushing processing may continue or exit, depending on the error
-     * and/or the bail threshold (that can be optionally set my the user).
+     * and/or the bail threshold (that can be optionally set by the user).
      *
      * @note This function MIGHT result in a return, throw, or exit depending
-     * on the bail policy (set my the user).
+     * on the bail policy (set by 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.
+     * @param msgHint Hint or HUMBLE suggestion 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).
-        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).
+        (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: number | undefined = !ctx
+        //     ? undefined
+        //     : ++ctx.start.column // Column (0-based).
+        // const endCol: number | undefined = !!ctx?.stop?.column
+        //     ? ++ctx.stop.column
+        //     : undefined // Note: Column (0-based).
+        const startCol = ctx?.start?.column != null ? ctx.start.column + 1 : undefined; // Note: Column (0-based).
+        const endCol = ctx?.stop?.column != null ? ctx.stop.column + 1 : 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;
@@ -118,86 +118,83 @@ class ErrorDataHandler {
             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.
+        if (!this.isSilent) {
+            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(2)
-                    // }
+                    if (!this.isThrowOnError) {
+                        (0, print_1.debugPrint)('Skipped throwing');
+                    }
+                    else {
+                        // (?, not if can delete this message now (it may have been superceded), 20250921) In test, throw an error instead of exiting.
+                        throw new Error(`Internal-Error: ${msgWhat}`);
+                    }
                 }
                 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)
-                    // }
+                    if (!this.isThrowOnError) {
+                        (0, print_1.debugPrint)('Skipped throwing');
+                    }
+                    else {
+                        // (?, not if can delete this message now (it may have been superceded), 20250921) In test, throw an error instead of exiting.
+                        throw new Error(`Syntax-Error: ${'' + msgWhat}`);
+                    }
                 }
                 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.isQuiet) {
+                    this.emitSyntaxWarning(loc, msgWhatWithLineNum, 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 (!this.isThrowOnError) {
+                        (0, print_1.debugPrint)('Skipped throwing');
+                    }
+                    else {
+                        // (?, not if can delete this message now (it may have been superceded), 20250921) In test, throw an error instead of exiting.
+                        throw new Error(`Syntax-Warning: ${msgWhat}`);
+                    }
                 }
                 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'.
+            default: // Unhandled/unknown error type → Fatal.
                 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.
+                /*
+                    "Best practises":
+                    - ONLY on I/O failures: file not found, unreadable file, encoding errors.
+                    - ONLY on programmer/usage errors: invalid options, conflicting flags.
+                    - ONLY on internal faults: invariants broken, unexpected exceptions from dependencies.
+                */
+                // CANNOT recover fatal errors, will lead to an bail!
+                // In test, throw an error instead of bailing/exiting.
+                // IMPORTANT: Never exit with exit code since this is a library!
                 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,80 +205,88 @@ 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;
             }
         }
     }
+    /*
+     * - error/warning → console.error / console.warn
+     * - notice/info → console.log / console.info
+     */
     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);
+        if (!this.isSilent) {
+            console.error(messageHeader); // Print the issue title.
+            msgWhat && console.log(msgWhat);
+            msgWhy && console.log(msgWhy);
+            msgHint && console.log(msgHint);
+            console.log(); // Emit an empty line before outputting message.
+        }
     }
     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);
+        if (!this.isSilent) {
+            console.error(messageHeader); // Print the issue title.
+            msgWhat && console.log(msgWhat);
+            msgWhy && console.log(msgWhy);
+            msgHint && console.log(msgHint);
+            console.log(); // Emit an empty line before outputting message.
+        }
     }
     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);
+        if (!this.isSilent) {
+            console.error(messageHeader); // Print the issue title.
+            msgWhat && console.log(msgWhat);
+            msgWhy && console.log(msgWhy);
+            msgHint && console.log(msgHint);
+            console.log(); // Emit an empty line before outputting message.
+        }
     }
     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);
+        if (!this.isQuiet && !this.isSilent) {
+            console.warn(messageHeader); // Print the issue title.
+            msgWhat && console.log(msgWhat);
+            msgWhy && console.log(msgWhy);
+            msgHint && console.log(msgHint);
+            console.log(); // Emit an empty line before outputting message.
+        }
     }
     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);
+        if (!this.isQuiet && !this.isSilent) {
+            console.log(messageHeader); // Print the issue title.
+            msgWhat && console.log(msgWhat);
+            msgWhy && console.log(msgWhy);
+            msgHint && console.log(msgHint);
+            console.log(); // Emit an empty line before outputting message.
+        }
     }
     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);
+        if (!this.isQuiet && !this.isSilent) {
+            console.info(messageHeader); // Print the issue title.
+            msgWhat && console.log(msgWhat);
+            msgWhy && console.log(msgWhy);
+            msgHint && console.log(msgHint);
+            console.log(); // Emit an empty line before outputting message.
+        }
     }
     getNumOfAllMessages() {
         return (this.getNumOfErrors() +
             this.getNumOfWarnings() +
             this.getNumOfNotices() +
-            this.getNumOfNotices());
+            this.getNumOfInfos());
     }
     getNumOfErrors() {
         return (this.numFatalErrors + this.numInternalErrors + this.numSyntaxErrors);
@@ -309,3 +314,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,127 @@
+/**
+ * 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 { DocumentTerminatorRule, DuplicateKeyPolicy, EmptyValueRule, OnDuplicateKey, PreferredFailLevel } from '../types';
+export type TParserMode = 'lenient' | 'strict';
+export type TExactMode = 'custom' | TParserMode;
+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 {
+    rules: IParseRuleOptions;
+    bailSensitivity: TBailSensitivityLevel;
+    isIncludeMeta: boolean;
+    isWithDiagnostics: boolean;
+    isWithTiming: boolean;
+    isKeepUndefinedInMeta: boolean;
+    isQuiet: boolean;
+    isSilent: boolean;
+    isThrowOnError: boolean;
+}
+export interface IParseRuleOptions {
+    initialMode: 'custom' | TParserMode;
+    onDuplicateKey: DuplicateKeyPolicy;
+    requireDocTerminator: DocumentTerminatorRule;
+    treatEmptyValueAsNull: EmptyValueRule;
+}
+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/defaultParserOptions.d.ts

@@ -0,0 +1,17 @@
+import { ParseOptions } from '../../types';
+import { TParserMode } from '../internalTypes';
+export declare const getDefaultUserOptions: (mode: TParserMode) => {
+    includeDiagnostics: boolean;
+    includeTiming: boolean;
+    preserveUndefinedInMeta: boolean;
+    onDuplicateKey: import("../../types").OnDuplicateKey;
+    requireDocTerminator: import("../../types").DocumentTerminatorRule;
+    treatEmptyValueAsNull: import("../../types").EmptyValueRule;
+    quiet: boolean;
+    silent: boolean;
+    throwOnError: boolean;
+    strictMode: boolean;
+    failLevel: import("../../types").PreferredFailLevel;
+    includeMetadata: boolean;
+};
+export type TNormalizedUserOptions = Required<Pick<ParseOptions, 'strictMode' | 'failLevel' | 'includeMetadata' | 'includeDiagnostics' | 'includeTiming' | 'preserveUndefinedInMeta' | 'onDuplicateKey' | 'requireDocTerminator' | 'treatEmptyValueAsNull' | 'quiet' | 'silent' | 'throwOnError'>>;

package/dist/core/options/defaultParserOptions.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getDefaultUserOptions = void 0;
+// export const getDefaultUserOptions = (mode: TParserMode): ParseOptions =>
+// export const getDefaultUserOptions = (mode: TParserMode) =>
+//     mode === 'strict' ? DEFAULT_STRICT_OPTS : DEFAULT_LENIENT_OPTS
+const getDefaultUserOptions = (mode) => mode === 'strict' ? { ...DEFAULT_STRICT_OPTS } : { ...DEFAULT_LENIENT_OPTS };
+exports.getDefaultUserOptions = getDefaultUserOptions;
+// Base (mode-agnostic) defaults
+const 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).
+    onDuplicateKey: 'error',
+    requireDocTerminator: 'optional',
+    treatEmptyValueAsNull: 'allow-with-warning',
+    quiet: false, // Suppress warnings in console (does not affect warnings in meta data).
+    silent: false,
+    //@todo: Change default throwOnError to false
+    throwOnError: true, // Will throw on first parse error encountered.
+};
+const DEFAULT_LENIENT_OPTS = {
+    ...BASE_DEFAULTS,
+    strictMode: false,
+    failLevel: 'ignore-errors',
+    // suppressWarnings: false, // Suppress warnings in console (does not affect warnings in meta data).
+    // Below are options for pure rules:
+    onDuplicateKey: 'warn-and-keep-first',
+    requireDocTerminator: 'optional',
+    treatEmptyValueAsNull: 'allow',
+};
+const DEFAULT_STRICT_OPTS = {
+    ...BASE_DEFAULTS,
+    strictMode: true,
+    failLevel: 'errors',
+    // suppressWarnings: false, // Suppress warnings in console (does not affect warnings in meta data).
+    // Below are options for pure rules:
+    onDuplicateKey: 'error',
+    requireDocTerminator: 'optional',
+    treatEmptyValueAsNull: 'disallow',
+};
+//# sourceMappingURL=defaultParserOptions.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"defaultParserOptions.js","sourceRoot":"","sources":["../../../src/core/options/defaultParserOptions.ts"],"names":[],"mappings":";;;AAGA,4EAA4E;AAC5E,8DAA8D;AAC9D,qEAAqE;AAE9D,MAAM,qBAAqB,GAAG,CAAC,IAAiB,EAAE,EAAE,CACvD,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,GAAG,mBAAmB,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,oBAAoB,EAAE,CAAA;AADnE,QAAA,qBAAqB,yBAC8C;AAsBhF,gCAAgC;AAChC,MAAM,aAAa,GAA2B;IAC1C,UAAU,EAAE,KAAK;IACjB,SAAS,EAAE,MAAM;IACjB,eAAe,EAAE,KAAK;IACtB,kBAAkB,EAAE,KAAK;IACzB,aAAa,EAAE,KAAK;IACpB,uBAAuB,EAAE,KAAK;IAC9B,oGAAoG;IACpG,cAAc,EAAE,OAAO;IACvB,oBAAoB,EAAE,UAAU;IAChC,qBAAqB,EAAE,oBAAoB;IAC3C,KAAK,EAAE,KAAK,EAAE,wEAAwE;IACtF,MAAM,EAAE,KAAK;IACb,6CAA6C;IAC7C,YAAY,EAAE,IAAI,EAAE,+CAA+C;CACtE,CAAA;AAED,MAAM,oBAAoB,GAA2B;IACjD,GAAG,aAAa;IAChB,UAAU,EAAE,KAAK;IACjB,SAAS,EAAE,eAAe;IAC1B,oGAAoG;IACpG,oCAAoC;IACpC,cAAc,EAAE,qBAAqB;IACrC,oBAAoB,EAAE,UAAU;IAChC,qBAAqB,EAAE,OAAO;CACjC,CAAA;AAED,MAAM,mBAAmB,GAA2B;IAChD,GAAG,aAAa;IAChB,UAAU,EAAE,IAAI;IAChB,SAAS,EAAE,QAAQ;IACnB,oGAAoG;IACpG,oCAAoC;IACpC,cAAc,EAAE,OAAO;IACvB,oBAAoB,EAAE,UAAU;IAChC,qBAAqB,EAAE,UAAU;CACpC,CAAA"}

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;