yini-parser 1.1.0-beta → 1.3.0-beta

package/dist/core/pipeline/pipeline.js

@@ -0,0 +1,244 @@
+"use strict";
+/**
+ * This file is the orchestrator that wires up the pipeline (lexer → parser →
+ * astBuilder → objectBuilder, etc.)
+ */
+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 antlr4_1 = require("antlr4");
+const env_1 = require("../../config/env");
+const YiniLexer_1 = __importDefault(require("../../grammar/generated/YiniLexer"));
+const YiniParser_1 = __importDefault(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");
+const errorListeners_1 = require("./errorListeners");
+/**
+ * @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 runPipeline(..) in pipeline.ts');
+    (0, print_1.debugPrint)('    isStrict initialMode = ' + coreOptions.rules.initialMode);
+    (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)('isQuiet = ' + coreOptions.isQuiet);
+    (0, print_1.debugPrint)('          onDuplicateKey = ' + coreOptions.rules.onDuplicateKey);
+    (0, print_1.debugPrint)('    requireDocTerminator = ' + coreOptions.rules.requireDocTerminator);
+    (0, print_1.debugPrint)('   treatEmptyValueAsNull = ' + coreOptions.rules.treatEmptyValueAsNull);
+    (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.isQuiet, coreOptions.isSilent, coreOptions.isThrowOnError);
+    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)
+    const lexerErrorListener = (0, errorListeners_1.createLexerErrorListener)(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)
+    const parserErrorListener = (0, errorListeners_1.createParserErrorListener)(errorHandler);
+    parser.addErrorListener(parserErrorListener);
+    const parseTree = parser.yini(); // The function yini() is the start rule.
+    // if (
+    //     parserErrorListener.errors.length > 0 ||
+    //     lexerErrorListener.errors.length > 0
+    // ) {
+    //     debugPrint('*** ERROR detected ***')
+    //     if (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.rules.initialMode === 'strict') {
+        // Note, after pushing processing may continue or exit, depending on the error and/or the bail threshold.
+        errorHandler.pushOrBail(null, 'Syntax-Warning', 'Warning: Strict initialMode is not yet fully implemented.', 'Some validation rules may still be missing or incomplete.');
+        if (coreOptions.bailSensitivity === '0-Ignore-Errors') {
+            // IMPORTANT: If "silent" option is set, do not log anything to console!
+            if (!coreOptions.isQuiet && !coreOptions.isSilent) {
+                console.warn(`Warning: The initial mode was set to strict mode, but fail level is set to 'ignore-errors'. This combination is contradictory and might be a mistake.`);
+            }
+        }
+    }
+    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());
+    // Print a summary line at the end if any errors or warnings.
+    if (!coreOptions.isQuiet && !coreOptions.isSilent) {
+        const errors = errorHandler.getNumOfErrors();
+        const warnings = errorHandler.getNumOfWarnings();
+        // Notes:
+        // - if any errors, print to console **ERROR**.
+        // - if no errors but warnings, print to console **WARN**.
+        // Otherwise, adds a lot more complexity to auto testing (especially options testing), etc.
+        //
+        // Also, output one concise summary line (according to "best practices").
+        if (coreOptions.bailSensitivity !== '0-Ignore-Errors') {
+            /*
+                '1-Abort-on-Errors':
+                Show summary if: errors >= 1 or warnings >= 3.
+
+                '2-Abort-Even-on-Warnings':
+                Show summary if: errors >= 1 or warnings >= 1
+            */
+            const numOfWarningsToTrigger = coreOptions.bailSensitivity === '1-Abort-on-Errors' ? 3 : 1;
+            if (errors) {
+                console.error(`Parsing completed with ${errors} error(s), ${warnings} warning(s). Please see details above.`);
+            }
+            else if (warnings >= numOfWarningsToTrigger &&
+                !coreOptions.isQuiet) {
+                console.warn(`Parsing completed with ${errors} error(s), ${warnings} warning(s).`);
+            }
+        }
+    }
+    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/pipeline.js.map

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

package/dist/core/resultMetadataBuilder.d.ts

@@ -0,0 +1,19 @@
+import { ParseOptions, ResultMetadata } from '../types';
+import { ErrorDataHandler } from './errorDataHandler';
+import { IParseCoreOptions, IRuntimeInfo, IYiniAST } from './internalTypes';
+export interface IBuildResultMetadataParams {
+    ast: IYiniAST;
+    coreOptions: IParseCoreOptions;
+    runtimeInfo: IRuntimeInfo;
+    _meta_userOpts: ParseOptions;
+    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,187 @@
+"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 print_1 = require("../utils/print");
+const string_1 = require("../utils/string");
+const modeFromRulesMatcher_1 = require("./parsingRules/modeFromRulesMatcher");
+const buildResultMetadata = (p) => {
+    // --- Construct meta information -------------------------------------
+    const to3 = (n) => {
+        if (!n) {
+            if ((0, env_1.isProdEnv)()) {
+                return 0;
+            }
+            else {
+                (0, print_1.debugPrint)('In buildResultMetadata(..): p.runtimeInfo:');
+                (0, print_1.printObject)(p.runtimeInfo);
+                (0, print_1.debugPrint)('In buildResultMetadata(..): p.coreOptions:');
+                (0, print_1.printObject)(p.coreOptions);
+                (0, print_1.debugPrint)('In buildResultMetadata(..): p.durationMs:');
+                (0, print_1.printObject)(p.durationMs);
+                // p.errorHandler.pushOrBail(null,'Internal-Error', 'to3 received undefined')
+                throw Error('to3(..) received undefined');
+            }
+        }
+        return Number.parseFloat(n.toFixed(3));
+    };
+    // Construct meta data.
+    const metadata = {
+        parserVersion: package_json_1.default.version,
+        mode: p.coreOptions.rules.initialMode,
+        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.1',
+    };
+    // 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;
+        };
+        const effectiveMode = (0, modeFromRulesMatcher_1.matchModeFromCoreOptions)(p.coreOptions);
+        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)({
+                effectiveMode: effectiveMode, // Appended.
+                // IMPORTANT: (!) These user options MUST be mapped from coreOptions (to user options).
+                strictMode: effectiveMode === 'strict' ? true : false,
+                failLevel: mapLevelKey(p.coreOptions.bailSensitivity),
+                includeMetadata: p.coreOptions.isIncludeMeta,
+                includeDiagnostics: p.coreOptions.isWithDiagnostics,
+                includeTiming: p.coreOptions.isWithTiming,
+                preserveUndefinedInMeta: p.coreOptions.isKeepUndefinedInMeta,
+                quiet: p.coreOptions.isQuiet,
+                requireDocTerminator: p.coreOptions.rules.requireDocTerminator,
+                treatEmptyValueAsNull: p.coreOptions.rules.treatEmptyValueAsNull,
+                onDuplicateKey: p.coreOptions.rules.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,21 @@
+import { ParsedObject, ParseOptions, 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.
+ *
+ * @note The following options MUST be respected!
+ *   quiet?: boolean // Reduce output (show only errors, does not effect warnings and etc. in meta data).
+ *   silent?: boolean // Suppress all output (even errors, exit code only).
+ */
+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?: ParseOptions): ParsedObject;
+    doParseFile(filePath: string, strictMode?: boolean, failLevel?: PreferredFailLevel, includeMetadata?: boolean): ParsedObject;
+    doParseFile(filePath: string, options?: ParseOptions): ParsedObject;
+}