yini-parser 1.0.2-beta → 1.2.0-beta

package/dist/core/pipeline.js

@@ -0,0 +1,323 @@
+"use strict";
+/**
+ * This file is the orchestrator that wires up the pipeline (lexer → parser →
+ * astBuilder → objectBuilder, etc.)
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runPipeline = void 0;
+const perf_hooks_1 = require("perf_hooks");
+const util_1 = require("util");
+const antlr4_1 = require("antlr4");
+const env_1 = require("../config/env");
+const YiniLexer_1 = __importDefault(require("../grammar/generated/YiniLexer"));
+const YiniParser_1 = __importStar(require("../grammar/generated/YiniParser"));
+const object_1 = require("../utils/object");
+const print_1 = require("../utils/print");
+const astBuilder_1 = __importDefault(require("./astBuilder"));
+const errorDataHandler_1 = require("./errorDataHandler");
+const objectBuilder_1 = require("./objectBuilder");
+const resultMetadataBuilder_1 = require("./resultMetadataBuilder");
+/**
+ * @param line Line number as 1-based.
+ * @param col Column number as 0-based.
+ */
+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) {
+        ctx.start.column = startColumn; // Note: Column num is 0-based.
+    }
+    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);
+        }
+        errorHandler.pushOrBail(null, 'Internal-Error', 'Catched error of possibleStartCol in parser grammar listener.', msgHint);
+    }
+    return possibleStartCol;
+};
+class MyParserErrorListener {
+    constructor(errorHandler) {
+        this.errors = [];
+        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) { }
+}
+class MyLexerErrorListener {
+    constructor(errorHandler) {
+        this.errors = [];
+        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);
+    }
+}
+/**
+ * @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.
+ */
+const runPipeline = (yiniContent, coreOptions, runtimeInfo, _meta_userOpts) => {
+    (0, print_1.debugPrint)();
+    (0, print_1.debugPrint)('-> Entered parseMain(..) in parseEntry');
+    (0, print_1.debugPrint)('           isStrict mode = ' + coreOptions.isStrict);
+    (0, print_1.debugPrint)('         bailSensitivity = ' + coreOptions.bailSensitivity);
+    (0, print_1.debugPrint)('           isIncludeMeta = ' + coreOptions.isIncludeMeta);
+    (0, print_1.debugPrint)('       isWithDiagnostics = ' + coreOptions.isWithDiagnostics);
+    (0, print_1.debugPrint)('            isWithTiming = ' + coreOptions.isWithTiming);
+    (0, print_1.debugPrint)('   isKeepUndefinedInMeta = ' + coreOptions.isKeepUndefinedInMeta);
+    (0, print_1.debugPrint)('isAvoidWarningsInConsole = ' + coreOptions.isAvoidWarningsInConsole);
+    (0, print_1.debugPrint)('    requireDocTerminator = ' + coreOptions.requireDocTerminator);
+    (0, print_1.debugPrint)('   treatEmptyValueAsNull = ' + coreOptions.treatEmptyValueAsNull);
+    (0, print_1.debugPrint)('          onDuplicateKey = ' + coreOptions.onDuplicateKey);
+    (0, print_1.debugPrint)();
+    (0, print_1.debugPrint)('  runtimeInfo.sourceType = ' + runtimeInfo.sourceType);
+    (0, print_1.debugPrint)('    runtimeInfo.fileName = ' + runtimeInfo.fileName);
+    // let persistThreshold: TBailSensitivityLevel
+    // switch (coreOptions.bailSensitivity) {
+    //     case '0-Ignore-Errors':
+    //         persistThreshold = '0-Ignore-Errors'
+    //         break
+    //     case 1:
+    //         persistThreshold = '1-Abort-on-Errors'
+    //         break
+    //     default:
+    //         persistThreshold = '2-Abort-Even-on-Warnings'
+    // }
+    const errorHandler = new errorDataHandler_1.ErrorDataHandler(runtimeInfo.sourceType, runtimeInfo.fileName, coreOptions.bailSensitivity, coreOptions.isAvoidWarningsInConsole);
+    if (yiniContent.trim() === '') {
+        const isFileSourceType = runtimeInfo?.sourceType === 'File';
+        // Note, after pushing processing may continue or exit, depending on the error and/or the bail threshold.
+        errorHandler.pushOrBail(null, 'Syntax-Error', 'Empty YINI document.', `The input is blank or contains only whitespace in the ${isFileSourceType ? 'YINI file' : 'YINI inline content'}.`, `Tip: Add at least one section '^ SectionName' or a key-value pair 'key = value' to make it a valid YINI file.`);
+    }
+    //---------------------------------------------
+    // Note: Only computed when isWithTiming.
+    let timeStartMs = 0;
+    let timeEnd1Ms = 0;
+    let timeEnd2Ms = 0;
+    let timeEnd3Ms = 0;
+    let timeEnd4Ms = 0;
+    //---------------------------------------------
+    //---------------------------------------------
+    // Note: Should ALWAYS be computed.
+    let runStartedAt = '';
+    let runFinishedAt = '';
+    let durationMs = 0;
+    //---------------------------------------------
+    (0, env_1.isDebug)() && console.log();
+    (0, print_1.debugPrint)('=== Phase 1 - Lexing ===================================================');
+    // -----------------------------
+    // Below block should always be done despite isWithTiming to compute
+    // total time and runStartedAt that should always be computed.
+    {
+        timeStartMs = perf_hooks_1.performance.now();
+        runStartedAt = new Date().toISOString();
+    }
+    // -----------------------------
+    const inputStream = antlr4_1.CharStreams.fromString(yiniContent);
+    const lexer = new YiniLexer_1.default(inputStream);
+    // Remove the default ConsoleErrorListener
+    lexer.removeErrorListeners(); // Removes the default lexer console error output.
+    const lexerErrorListener = new MyLexerErrorListener(errorHandler);
+    lexer.addErrorListener(lexerErrorListener);
+    const tokenStream = new antlr4_1.CommonTokenStream(lexer);
+    // Important: force tokenization here so lexing is measured separately.
+    tokenStream.fill();
+    (0, print_1.debugPrint)('--- Parsing done. ---');
+    (0, print_1.debugPrint)('=== Ended phase 1 =============================================');
+    (0, env_1.isDebug)() && console.log();
+    (0, print_1.debugPrint)('=== Phase 2 - Parsing ===================================================');
+    if (coreOptions.isWithTiming) {
+        timeEnd1Ms = perf_hooks_1.performance.now();
+    }
+    const parser = new YiniParser_1.default(tokenStream);
+    // const errorListener = new MyParserErrorListener(errorHandler)
+    parser.removeErrorListeners(); // Removes the default parser console error output.
+    const parserErrorListener = new MyParserErrorListener(errorHandler);
+    parser.addErrorListener(parserErrorListener);
+    const parseTree = parser.yini(); // The function yini() is the start rule.
+    if (parserErrorListener.errors.length > 0 ||
+        lexerErrorListener.errors.length > 0) {
+        (0, print_1.debugPrint)('*** ERROR detected ***');
+        if ((0, env_1.isDebug)()) {
+            // Handle or display syntax errors
+            console.error('Syntax errors detected:', parserErrorListener.errors, lexerErrorListener.errors);
+        }
+    }
+    (0, print_1.debugPrint)('=== Ended phase 2 =============================================');
+    (0, env_1.isDebug)() && console.log();
+    (0, print_1.debugPrint)('=== Phase 3 - AST Model build & validation ===================================================');
+    if (coreOptions.isWithTiming) {
+        timeEnd2Ms = perf_hooks_1.performance.now();
+    }
+    const builder = new astBuilder_1.default(errorHandler, coreOptions, runtimeInfo.sourceType, runtimeInfo.fileName || null);
+    const ast = builder.buildAST(parseTree);
+    if (ast.numOfMembers === 0 && ast.numOfSections === 0) {
+        // Note, after pushing processing may continue or exit, depending on the error and/or the bail threshold.
+        errorHandler.pushOrBail(null, 'Syntax-Error', 'No meaningful content.', `No sections or members found in the ${ast.sourceType === 'File' ? 'YINI file' : 'YINI inline content'}.`, `${ast.sourceType === 'File' ? 'A valid YINI file' : 'Any valid YINI inline content'} must contain at least one section '^ SectionName' or a key–value pair 'key = value' to make it a valid YINI file.`);
+    }
+    if ((0, env_1.isDebug)()) {
+        console.log();
+        console.log('**************************************************************************');
+        console.log('*** AST *************************************************');
+        (0, print_1.printObject)(ast);
+        console.log('**************************************************************************');
+        console.log('**************************************************************************');
+        console.log();
+    }
+    (0, print_1.debugPrint)('=== Ended phase 3 =============================================');
+    (0, env_1.isDebug)() && console.log();
+    (0, print_1.debugPrint)('=== Phase 4 - Object Building Construction / Binding / Evaluation) ===================================================');
+    if (coreOptions.isWithTiming) {
+        timeEnd3Ms = perf_hooks_1.performance.now();
+    }
+    // Construct.
+    // const finalJSResult = constructFinalObject(syntaxTreeC, errorHandler)
+    // const finalJSResult = builder.build(parseTree)
+    // const finalJSResult = ast //NOTE: ONLY TEMP so code runs
+    const finalJSResult = (0, objectBuilder_1.astToObject)(ast, errorHandler);
+    (0, print_1.debugPrint)('=== Ended phase 4 =============================================');
+    // -----------------------------
+    // Below block should always be done despite isWithTiming to compute
+    // total time and runStartedAt that should always be computed.
+    {
+        timeEnd4Ms = perf_hooks_1.performance.now();
+        durationMs = timeEnd4Ms - timeStartMs;
+        runFinishedAt = new Date().toISOString();
+    }
+    // -----------------------------
+    (0, print_1.debugPrint)('visitor.visit(..): finalJSResult:');
+    (0, env_1.isDebug)() && console.debug(finalJSResult);
+    (0, print_1.debugPrint)();
+    if (coreOptions.isStrict) {
+        // Note, after pushing processing may continue or exit, depending on the error and/or the bail threshold.
+        errorHandler.pushOrBail(null, 'Syntax-Warning', 'Warning: Strict mode is not yet fully implemented.', 'Some validation rules may still be missing or incomplete.');
+    }
+    else {
+        (0, print_1.debugPrint)('visitor.visit(..): finalJSResult:');
+        (0, env_1.isDebug)() && console.debug(finalJSResult);
+    }
+    const params = {
+        ast,
+        coreOptions,
+        runtimeInfo,
+        _meta_userOpts,
+        errorHandler,
+        runStartedAt,
+        runFinishedAt,
+        durationMs,
+        timeStartMs,
+        timeEnd1Ms,
+        timeEnd2Ms,
+        timeEnd3Ms,
+        timeEnd4Ms,
+    };
+    const constructedMetadata = (0, resultMetadataBuilder_1.buildResultMetadata)(params);
+    (0, print_1.debugPrint)('getNumOfErrors(): ' + errorHandler.getNumOfErrors());
+    if (errorHandler.getNumOfErrors()) {
+        console.log();
+        console.log('Parsing is complete, but some problems were detected. Please see the errors above for details.');
+        console.log('Number of errors found: ' + errorHandler.getNumOfErrors());
+    }
+    if (coreOptions.isIncludeMeta) {
+        return {
+            result: finalJSResult,
+            meta: !coreOptions.isKeepUndefinedInMeta
+                ? (0, object_1.removeUndefinedDeep)(constructedMetadata)
+                : constructedMetadata,
+        };
+    }
+    return finalJSResult;
+};
+exports.runPipeline = runPipeline;
+//# sourceMappingURL=pipeline.js.map

package/dist/core/pipeline.js.map

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

package/dist/core/resultMetadataBuilder.d.ts

@@ -0,0 +1,19 @@
+import { AllUserOptions, ResultMetadata } from '../types';
+import { ErrorDataHandler } from './errorDataHandler';
+import { IParseCoreOptions, IRuntimeInfo, IYiniAST } from './internalTypes';
+export interface IBuildResultMetadataParams {
+    ast: IYiniAST;
+    coreOptions: IParseCoreOptions;
+    runtimeInfo: IRuntimeInfo;
+    _meta_userOpts: AllUserOptions;
+    errorHandler: ErrorDataHandler;
+    runStartedAt: string;
+    runFinishedAt: string;
+    durationMs: number;
+    timeStartMs: number;
+    timeEnd1Ms: number;
+    timeEnd2Ms: number;
+    timeEnd3Ms: number;
+    timeEnd4Ms: number;
+}
+export declare const buildResultMetadata: (p: IBuildResultMetadataParams) => ResultMetadata;

package/dist/core/resultMetadataBuilder.js

@@ -0,0 +1,166 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildResultMetadata = void 0;
+// const pkg = require('../../package.json')
+const package_json_1 = __importDefault(require("../../package.json")); // NOTE: Requires "resolveJsonModule": true (or "esModuleInterop": true).
+const env_1 = require("../config/env");
+const object_1 = require("../utils/object");
+const string_1 = require("../utils/string");
+const buildResultMetadata = (p) => {
+    // --- Construct meta information -------------------------------------
+    const to3 = (n) => Number.parseFloat(n.toFixed(3));
+    // Construct meta data.
+    const metadata = {
+        parserVersion: package_json_1.default.version,
+        mode: p.coreOptions.isStrict ? 'strict' : 'lenient',
+        totalErrors: p.errorHandler.getNumOfErrors(),
+        totalWarnings: p.errorHandler.getNumOfWarnings(),
+        totalMessages: p.errorHandler.getNumOfAllMessages(),
+        runStartedAt: p.runStartedAt,
+        runFinishedAt: p.runFinishedAt,
+        durationMs: to3(p.durationMs),
+        preservesOrder: true,
+        orderGuarantee: 'implementation-defined',
+        source: {
+            // sourceType: toLowerSnakeCase(ast.sourceType),
+            sourceType: (0, string_1.toLowerKebabCase)(p.ast.sourceType),
+            fileName: p.ast.fileName,
+            hasDocumentTerminator: p.ast.terminatorSeen,
+            hasYiniMarker: p.ast.yiniMarkerSeen,
+            lineCount: p.runtimeInfo.lineCount,
+            byteSize: p.runtimeInfo.fileByteSize,
+            sha256: p.runtimeInfo.sha256,
+        },
+        structure: {
+            maxDepth: p.ast.maxDepth,
+            sectionCount: p.ast.numOfSections,
+            memberCount: p.ast.numOfMembers,
+            keysParsedCount: null,
+            // objectCount: null,
+            // listCount: null,
+            sectionNamePaths: p.ast.sectionNamePaths,
+        },
+        metaSchemaVersion: '1.1.0',
+    };
+    // Attach optional diagnostics.
+    if (p.coreOptions.isWithDiagnostics) {
+        const mapLevelKey = (level) => {
+            switch (level) {
+                case '0-Ignore-Errors':
+                    return 'ignore-errors';
+                case '1-Abort-on-Errors':
+                    return 'errors';
+                case '2-Abort-Even-on-Warnings':
+                    return 'warnings-and-errors';
+            }
+        };
+        const mapLevelDescription = (level) => {
+            switch (level) {
+                case '0-Ignore-Errors':
+                    return 'Continue despite errors.';
+                case '1-Abort-on-Errors':
+                    return 'Abort when errors occur.';
+                case '2-Abort-Even-on-Warnings':
+                    return 'Abort when errors or warnings occur.';
+            }
+            return null;
+        };
+        metadata.diagnostics = {
+            failLevel: {
+                preferredLevel: p.runtimeInfo.preferredBailSensitivity,
+                usedLevelType: p.coreOptions.bailSensitivity,
+                usedLevelKey: mapLevelKey(p.coreOptions.bailSensitivity),
+                levelDescription: (mapLevelDescription(p.coreOptions.bailSensitivity)),
+            },
+            errors: {
+                errorCount: p.errorHandler.getNumOfErrors(),
+                payload: p.errorHandler.getErrors(),
+            },
+            warnings: {
+                warningCount: p.errorHandler.getNumOfWarnings(),
+                payload: p.errorHandler.getWarnings(),
+            },
+            notices: {
+                noticeCount: p.errorHandler.getNumOfNotices(),
+                payload: p.errorHandler.getNotices(),
+            },
+            infos: {
+                infoCount: p.errorHandler.getNumOfInfos(),
+                payload: p.errorHandler.getInfos(),
+            },
+            environment: {
+                NODE_ENV: process.env.NODE_ENV,
+                APP_ENV: process.env.APP_ENV,
+                lib: {
+                    nodeEnv: env_1.localNodeEnv,
+                    appEnv: env_1.localAppEnv,
+                    flags: { isDev: (0, env_1.isDev)(), isDebug: (0, env_1.isDebug)() },
+                },
+            },
+            effectiveOptions: (0, object_1.sortObjectKeys)({
+                // IMPORTANT: (!) These user options MUST be mapped from coreOptions (to user options).
+                strictMode: p.coreOptions.isStrict,
+                failLevel: mapLevelKey(p.coreOptions.bailSensitivity),
+                includeMetadata: p.coreOptions.isIncludeMeta,
+                includeDiagnostics: p.coreOptions.isWithDiagnostics,
+                includeTiming: p.coreOptions.isWithTiming,
+                preserveUndefinedInMeta: p.coreOptions.isKeepUndefinedInMeta,
+                suppressWarnings: p.coreOptions.isAvoidWarningsInConsole,
+                requireDocTerminator: p.coreOptions.requireDocTerminator,
+                treatEmptyValueAsNull: p.coreOptions.treatEmptyValueAsNull,
+                onDuplicateKey: p.coreOptions.onDuplicateKey,
+            }),
+            options: (0, object_1.sortObjectKeys)(p._meta_userOpts),
+        };
+    }
+    // Attach optional durations timing data.
+    if (p.coreOptions.isWithTiming) {
+        metadata.timing = {
+            total: !p.coreOptions.isWithTiming
+                ? null
+                : {
+                    timeMs: to3(p.durationMs), // durationMs = timeEnd4Ms - timeStartMs
+                    name: p.runtimeInfo.sourceType === 'Inline'
+                        ? 'Total'
+                        : 'Total (excluding phase0 (I/O))',
+                },
+            phase0: !p.coreOptions.isWithTiming ||
+                p.runtimeInfo.sourceType === 'Inline'
+                ? undefined
+                : {
+                    timeMs: to3(p.runtimeInfo.timeIoMs),
+                    name: 'I/O',
+                },
+            phase1: !p.coreOptions.isWithTiming
+                ? null
+                : {
+                    timeMs: to3(p.timeEnd1Ms - p.timeStartMs),
+                    name: 'Lexing',
+                },
+            phase2: !p.coreOptions.isWithTiming
+                ? null
+                : {
+                    timeMs: to3(p.timeEnd2Ms - p.timeEnd1Ms),
+                    name: 'Parsing',
+                },
+            phase3: !p.coreOptions.isWithTiming
+                ? null
+                : {
+                    timeMs: to3(p.timeEnd3Ms - p.timeEnd2Ms),
+                    name: 'AST Building',
+                },
+            phase4: !p.coreOptions.isWithTiming
+                ? null
+                : {
+                    timeMs: to3(p.timeEnd4Ms - p.timeEnd3Ms),
+                    name: 'Object Building',
+                },
+        };
+    }
+    return metadata;
+};
+exports.buildResultMetadata = buildResultMetadata;
+//# sourceMappingURL=resultMetadataBuilder.js.map

package/dist/core/resultMetadataBuilder.js.map

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

package/dist/core/runtime.d.ts

@@ -0,0 +1,17 @@
+import { AllUserOptions, ParsedObject, PreferredFailLevel } from '../types';
+/**
+ * Private class representing a runtime context for a single parse call.
+ *
+ * @note This design prevents race conditions: each call gets its own
+ *       runtimeInfo and related state. Without this, multiple calls
+ *       (especially in parallel) could overwrite each other's data.
+ */
+export declare class YiniRuntime {
+    #private;
+    constructor(sourceType: 'Inline' | 'File');
+    private makeRuntimeInfo;
+    doParse(yiniContent: string, strictMode?: boolean, failLevel?: PreferredFailLevel, includeMetadata?: boolean): ParsedObject;
+    doParse(yiniContent: string, options?: AllUserOptions): ParsedObject;
+    doParseFile(filePath: string, strictMode?: boolean, failLevel?: PreferredFailLevel, includeMetadata?: boolean): ParsedObject;
+    doParseFile(filePath: string, options?: AllUserOptions): ParsedObject;
+}