yini-parser 1.0.2-beta → 1.2.0-beta

package/dist/core/objectBuilder.js

@@ -1,185 +1,149 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.constructFinalObject = void 0;
+exports.astToObject = void 0;
 const env_1 = require("../config/env");
 const print_1 = require("../utils/print");
 /**
- * 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.
  */
-const constructFinalObject = (syntaxTreeC, errorHandler) => {
+const astToObject = (ast, errorHandler) => {
     (0, print_1.debugPrint)('-> constructFinalObject(..)');
-    const bulder = new Builder(syntaxTreeC, errorHandler);
-    if ((0, env_1.isDebug)()) {
-        console.log('Argument, syntaxTreeC:');
-        (0, print_1.printObject)(syntaxTreeC);
+    // return sectionChildrenToObject(ast.root)
+    const out = {};
+    for (const child of ast.root.children) {
+        define(out, child.sectionName, sectionToObject(child));
     }
-    const jsObject = bulder.doCheckAndBuild();
-    (0, print_1.debugPrint)('<- About to leave constructFinalObject(..)');
-    if ((0, env_1.isDebug)()) {
-        console.log('Returning, jsObject:');
-        (0, print_1.printObject)(syntaxTreeC);
-    }
-    return jsObject;
+    return out;
 };
-exports.constructFinalObject = constructFinalObject;
-class Builder {
-    constructor(syntaxTreeC, errorHandler) {
-        (0, print_1.debugPrint)('-> Builder: constructor(..)');
-        this.syntaxTreeC = syntaxTreeC;
-        this.errorHandler = errorHandler;
-    }
-    doCheckAndBuild() {
-        (0, print_1.debugPrint)('-> Builder: doCheckAndBuild(..)');
-        if (!this.syntaxTreeC) {
-            // Note, after pushing processing may continue or exit, depending on the error and/or the bail threshold.
-            this.errorHandler.pushOrBail(null, 'Fatal-Error', 'SyntaxTreeC is undefined', 'This is most likely caused by an internal error somewhere. The process cannot recover fully from this, sorry.');
-        }
-        const fullSubTreeList = this.buildFullSubTrees(this.syntaxTreeC);
-        const jsObject = this.buildObjectFromList(fullSubTreeList);
-        return jsObject;
-    }
-    buildFullSubTrees(syntaxTreeC) {
-        (0, print_1.debugPrint)('-> Builder: buildFullSubTrees(..)');
-        (0, env_1.isDebug)() && console.log();
-        const fullSubTreeList = []; // List of FULL sub-trees.
-        // Current Working Full Sub-Tree (starting at level 1).
-        let workingFullSubTree = syntaxTreeC._syntaxTree[0]; // (!) Any tree MUST START at level 1.
-        (0, print_1.debugPrint)(`Setted new workingFullSubTree, from syntaxTreeC._syntaxTree[0]`);
-        const len = syntaxTreeC._syntaxTree.length;
-        for (let i = 1; i < len; i++) {
-            const currentChainC = syntaxTreeC._syntaxTree[i];
-            const level = currentChainC.originLevel;
-            const nestingIndex = level - 1; // For debugging purposes.
-            const chain = currentChainC.chain; // For debugging purposes.
-            (0, print_1.debugPrint)(`Got new chain from syntaxTreeC._syntaxTree[${i}] to be mounted onto parent...`);
-            (0, print_1.debugPrint)('* level: ' + level + ' (i=' + i + '), chain: ' + chain);
-            if (level === 1) {
-                (0, print_1.debugPrint)('HIT - Detected that currentChain starts with level 1');
-                fullSubTreeList.push(workingFullSubTree);
-                (0, print_1.debugPrint)('The workingFullSubTree is finished, pushed it to the list.');
-                workingFullSubTree = syntaxTreeC._syntaxTree[i]; // (!) The tree MUST START at level 1.
-                (0, print_1.debugPrint)(`Setted new workingFullSubTree, from syntaxTreeC._syntaxTree[${i}]`);
-            }
-            else {
-                (0, print_1.debugPrint)('About to mount currentChain onto workingFullSubTree at correct level...');
-                workingFullSubTree = this.mountChainOntoLevel(currentChainC, workingFullSubTree);
-            }
-            (0, print_1.debugPrint)();
-        }
-        fullSubTreeList.push(workingFullSubTree);
-        if ((0, env_1.isDebug)()) {
-            console.log();
-            console.log('--- fullSubTreeList: (list of FULL sub-trees.) -------');
-            (0, print_1.printObject)(fullSubTreeList);
-            console.log();
-        }
-        return fullSubTreeList;
+exports.astToObject = astToObject;
+/** Convert only the children of a section into an object keyed by sectionName. */
+// function sectionChildrenToObject(
+//     section: YiniSection,
+// ): Record<string, unknown> {
+//     const out: Record<string, unknown> = {}
+//     for (const child of section.children) {
+//         out[child.sectionName] = sectionToObject(child)
+//     }
+//     return out
+// }
+/** Convert a section (its members + nested sections) to a plain object. */
+// function sectionToObject(node: YiniSection): Record<string, unknown> {
+//     const obj: Record<string, unknown> = {}
+//     // Members → properties
+//     for (const [key, val] of node.members.entries()) {
+//         obj[key] = literalToJS(val)
+//     }
+//     // Nested sections → nested objects keyed by sectionName
+//     for (const child of node.children) {
+//         obj[child.sectionName] = sectionToObject(child)
+//     }
+//     return obj
+// }
+/**
+ * Convert a section (members + nested sections) to a plain
+ * object, preserving order.
+ */
+const sectionToObject = (node) => {
+    const obj = {};
+    // 1) Members (Map preserves insertion order).
+    for (const [key, val] of node.members) {
+        define(obj, key, literalToJS(val));
     }
-    mountChainOntoLevel(chainC, workingSubTree) {
-        (0, print_1.debugPrint)('-> Builder: mountChainOntoLevel(..)');
-        if ((0, env_1.isDebug)()) {
-            (0, print_1.printObject)(chainC);
-        }
-        if (chainC.originLevel > 1) {
-            // NOP
-        }
-        else {
-            // Note, after pushing processing may continue or exit, depending on the error and/or the bail threshold.
-            this.errorHandler.pushOrBail(null, 'Fatal-Error', 'Internal-Error: Detected incorrect chain in mountChainOntoLevel(..), start section has level: ' +
-                chainC.originLevel, 'The (chain) must start with a section level higher than 1', '' + (0, print_1.printObject)(chainC));
-        }
-        if (workingSubTree.originLevel != 1) {
-            // Note, after pushing processing may continue or exit, depending on the error and/or the bail threshold.
-            this.errorHandler.pushOrBail(null, 'Fatal-Error', 'Internal-Error: Detected incorrect full sub-tree in mountChainOntoLevel(..), start section has level: ' +
-                chainC.originLevel, 'A full sub-tree (chain) must start with a section at level 1', '' + (0, print_1.printObject)(chainC));
-        }
-        const chain = chainC.chain;
-        const targetLevel = chainC.originLevel;
-        if ((0, env_1.isDebug)()) {
-            (0, print_1.debugPrint)('Target level = ' + targetLevel);
-            (0, print_1.debugPrint)(`The chain to mount: (onto level: ${targetLevel})`);
-            (0, print_1.printObject)(chain);
-            (0, print_1.debugPrint)('--- workingFullSubTree: -------');
-            (0, print_1.debugPrint)('Before mounting onto workingSubTree.chain:');
-            (0, print_1.printObject)(workingSubTree.chain);
-        }
-        (0, print_1.debugPrint)('Mount currentChain onto workingFullSubTree.');
-        workingSubTree.chain = mountObjectAtLevel(workingSubTree.chain, chain, targetLevel, this.errorHandler);
-        if ((0, env_1.isDebug)()) {
-            (0, print_1.debugPrint)('After mounting onto workingSubTree.chain:');
-            (0, print_1.printObject)(workingSubTree.chain);
-            (0, print_1.debugPrint)('----------');
-        }
-        (0, print_1.debugPrint)('<- Builder: mountChainOntoLevel(..)');
-        return workingSubTree;
+    // 2) Nested sections (array order preserved).
+    for (const child of node.children) {
+        define(obj, child.sectionName, sectionToObject(child));
     }
-    // Contruct the final JS object from the list of full sub-trees.
-    buildObjectFromList(fullSubTreeList) {
-        (0, print_1.debugPrint)('-> Builder: buildObjectFromList(..)');
-        const jsObject = {};
-        for (const chainC of fullSubTreeList) {
-            if (chainC.originLevel === 1) {
+    return obj;
+};
+/**
+ * Convert a literal to plain JS, ignoring both `tag` and `type`.
+ * - Scalars: return primitive value
+ * - List:    return array (item order preserved)
+ * - Object:  return plain object; iterate keys in creation order
+ *
+ * @note All `tag` fields MUST be ignored.
+ */
+const literalToJS = (v) => {
+    const IS_LOCAL_DEBUG = false;
+    (0, print_1.debugPrint)('In literalToJS(..)');
+    // if (!v) {
+    //     // NOTE: Only in lenient-mode, if parsing a
+    //     // member (key = value), but the value is invalid
+    //     // key will get undefined
+    //     return undefined
+    // }
+    switch (v.type) {
+        case 'String':
+        case 'Number':
+        case 'Boolean':
+        case 'Null':
+            return v.value;
+        case 'Undefined':
+            return undefined;
+        case 'List': {
+            if (IS_LOCAL_DEBUG) {
+                (0, print_1.debugPrint)("case 'List':");
                 if ((0, env_1.isDebug)()) {
-                    console.log('About to assign chainC.chain:');
-                    console.log(chainC.chain);
+                    console.log('input:');
+                    (0, print_1.printObject)(v);
                 }
-                Object.assign(jsObject, chainC.chain);
+            }
+            const out = v.elems.map((elem) => {
+                const ret = literalToJS(elem);
+                if (IS_LOCAL_DEBUG) {
+                    if ((0, env_1.isDebug)()) {
+                        console.log(`elem:`);
+                        (0, print_1.printObject)(elem);
+                    }
+                }
+                return ret;
+            });
+            if (IS_LOCAL_DEBUG) {
                 if ((0, env_1.isDebug)()) {
-                    console.log('After, jsObject:');
-                    console.log(jsObject);
+                    console.log('Returning:');
+                    (0, print_1.printObject)(out);
                 }
             }
-            else {
-                // Note, after pushing processing may continue or exit, depending on the error and/or the bail threshold.
-                this.errorHandler.pushOrBail(null, 'Fatal-Error', 'Internal-Error: Detected incorrect full sub-tree in buildObjectFromList(..), start section has level: ' +
-                    chainC.originLevel, 'A full sub-tree (chain) must start with a section at level 1', '' + (0, print_1.printObject)(chainC));
+            return out;
+        }
+        case 'Object': {
+            const out = {};
+            // for (const key of Object.keys(v.entries)) {
+            //     const entry = v.entries[key]
+            //     if (isScalar(entry)) {
+            //         // Scalar entries in object-literals: value
+            //         // out[key] = { type: entry.type, value: entry.value }
+            //         out[key] = entry.value
+            //     } else if (entry.type === 'List') {
+            //         out[key] = entry.elems.map(literalToJS)
+            //     } else {
+            //         out[key] = literalToJS(entry) // nested object-literal
+            //     }
+            // }
+            // Object.keys preserves property insertion order for plain objects
+            for (const k of Object.keys(v.entries)) {
+                define(out, k, literalToJS(v.entries[k]));
             }
+            return out;
         }
-        return jsObject;
     }
-}
+};
 /**
- * Mounts objectDest onto the first object at the given depth (level is
- * 1-based) in objectSrc.
- * @return Returns a new object without mutating input objects.
+ * Helper function, defines a property to preserve explicit insertion
+ * order and enumerability.
  */
-const mountObjectAtLevel = (objectSrc, objectDest, level, errorHandler) => {
-    // Deep copy to avoid mutating the input.
-    const result = JSON.parse(JSON.stringify(objectSrc));
-    let current = result;
-    let currentLevel = 1;
-    // Traverse down the first object path until the desired level.
-    while (currentLevel < level) {
-        // Get all keys in current object.
-        const keys = Object.keys(current);
-        // Find first key where value is a plain object (not array).
-        const nextKey = keys.find((key) => current[key] &&
-            typeof current[key] === 'object' &&
-            !Array.isArray(current[key]));
-        if (!nextKey) {
-            // Could not reach the specified depth.
-            return result;
-        }
-        current = current[nextKey];
-        currentLevel++;
-    }
-    (0, print_1.debugPrint)('--------');
-    (0, print_1.debugPrint)('   current = ' + (0, print_1.toPrettyJSON)(current));
-    const [firstKey] = Object.keys(objectDest);
-    (0, print_1.debugPrint)('objectDest = ' + firstKey);
-    if (Object.prototype.hasOwnProperty.call(current, firstKey)) {
-        //@todo Add metadata with line number, onto chainC, so can use line number in error reporting
-        (0, print_1.debugPrint)(`(!) sectionName already exist, name: "${firstKey}", in: `);
-        (0, print_1.debugPrint)((0, print_1.toPrettyJSON)(current));
-        // Note, after pushing processing may continue or exit, depending on the error and/or the bail threshold.
-        errorHandler.pushOrBail(null, 'Syntax-Error', 'Section name already exists', 'Cannot redefine section name: "' +
-            firstKey +
-            '" at level ' +
-            currentLevel +
-            '.');
-        return current;
-    }
-    // Mount objectDest onto the object at the required level.
-    Object.assign(current, objectDest);
-    return result;
+const define = (obj, key, value) => {
+    Object.defineProperty(obj, key, {
+        value,
+        enumerable: true,
+        configurable: true,
+        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;