yini-parser 1.1.0-beta → 1.3.0-beta

package/dist/core/runtime.js

@@ -0,0 +1,201 @@
+"use strict";
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+var _YiniRuntime_runtime;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.YiniRuntime = void 0;
+const fs_1 = __importDefault(require("fs"));
+const env_1 = require("../config/env");
+const pathAndFileName_1 = require("../utils/pathAndFileName");
+const print_1 = require("../utils/print");
+const string_1 = require("../utils/string");
+const defaultParserOptions_1 = require("./options/defaultParserOptions");
+const failLevel_1 = require("./options/failLevel");
+const optionsFunctions_1 = require("./options/optionsFunctions");
+const pipeline_1 = require("./pipeline/pipeline");
+/**
+ * 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).
+ */
+class YiniRuntime {
+    constructor(sourceType) {
+        /**
+         * @note Leading # makes the property "truly private" at runtime.
+         */
+        _YiniRuntime_runtime.set(this, void 0);
+        __classPrivateFieldSet(this, _YiniRuntime_runtime, this.makeRuntimeInfo(), "f");
+        __classPrivateFieldGet(this, _YiniRuntime_runtime, "f").sourceType = sourceType;
+    }
+    makeRuntimeInfo() {
+        return {
+            sourceType: 'Inline',
+            fileName: undefined,
+            fileByteSize: null,
+            lineCount: null,
+            timeIoMs: null,
+            preferredBailSensitivity: null,
+            sha256: null,
+        };
+    }
+    // --- Single implementation --------------------------------------------
+    // Implementation method (not declared with arrow function) for both method overload signatures.
+    // NOTE: Must be method declaration with NO =, arrow functions not (currently) supported for this type of method overloading.
+    doParse(yiniContent, arg2, // strictMode | options
+    failLevel = 'auto', includeMetadata = false) {
+        (0, print_1.debugPrint)('-> Entered doParse(..) in YiniRuntime class\n');
+        // Runtime guard to catch illegal/ambiguous calls coming from JS or any-cast code
+        if ((0, optionsFunctions_1.isOptionsObjectForm)(arg2) &&
+            (failLevel !== 'auto' || includeMetadata !== false)) {
+            throw new TypeError('Invalid call: when providing an options object, do not also pass positional parameters.');
+        }
+        const mode = (0, optionsFunctions_1.inferModeFromArgs)(arg2);
+        const defaultOptions = (0, defaultParserOptions_1.getDefaultUserOptions)(mode);
+        // Normalize to a fully-required options object.
+        let userOpts;
+        // Required, makes all properties in T required, no undefined.
+        if ((0, optionsFunctions_1.isOptionsObjectForm)(arg2)) {
+            userOpts = {
+                ...defaultOptions, // Sets the default options.
+                ...arg2,
+            };
+        }
+        else {
+            // Positional form.
+            userOpts = {
+                ...defaultOptions, // Sets the default options.
+                strictMode: arg2 ?? defaultOptions.strictMode,
+                failLevel,
+                includeMetadata,
+            };
+        }
+        if (userOpts.includeMetadata && __classPrivateFieldGet(this, _YiniRuntime_runtime, "f").sourceType === 'Inline') {
+            const lineCount = yiniContent.split(/\r?\n/).length; // Counts the lines.
+            const sha256 = (0, string_1.computeSha256)(yiniContent); // NOTE: Compute BEFORE any possible tampering of content.
+            __classPrivateFieldGet(this, _YiniRuntime_runtime, "f").lineCount = lineCount;
+            __classPrivateFieldGet(this, _YiniRuntime_runtime, "f").preferredBailSensitivity = userOpts.failLevel;
+            __classPrivateFieldGet(this, _YiniRuntime_runtime, "f").sha256 = sha256;
+        }
+        // NOTE: Important: Do not trim or mutate the yiniContent here, due
+        // to it will mess up the line numbers in error reporting.
+        if (!yiniContent) {
+            throw new Error('Syntax-Error: Unexpected blank YINI input');
+        }
+        if (!yiniContent.endsWith('\n')) {
+            yiniContent += '\n';
+        }
+        let level = (0, failLevel_1.mapFailLevelToBail)(userOpts.strictMode, userOpts.failLevel);
+        const coreOpts = (0, optionsFunctions_1.toCoreOptions)(userOpts, level);
+        (0, print_1.debugPrint)();
+        (0, print_1.debugPrint)('==== Call runPipeline(..) ==========================');
+        const result = (0, pipeline_1.runPipeline)(yiniContent, coreOpts, __classPrivateFieldGet(this, _YiniRuntime_runtime, "f"), userOpts);
+        (0, print_1.debugPrint)('==== End call runPipeline ==========================\n');
+        if ((0, env_1.isDev)()) {
+            console.log();
+            (0, print_1.devPrint)('YINI.parse(..): result:');
+            console.log(result);
+            (0, print_1.devPrint)('Complete result:');
+            (0, print_1.printObject)(result);
+        }
+        return result;
+    }
+    // --- Single implementation --------------------------------------------
+    // Implementation method (not declared with arrow function) for both method overload signatures.
+    // NOTE: Must be method declaration with NO =, arrow functions not (currently) supported for this type of method overloading.
+    doParseFile(filePath, arg2, // strictMode | options
+    failLevel = 'auto', includeMetadata = false) {
+        (0, print_1.debugPrint)('-> Entered doParseFile(..) in YiniRuntime class\n');
+        (0, print_1.debugPrint)('Current directory = ' + process.cwd());
+        // Runtime guard to catch illegal/ambiguous calls coming from JS or any-cast code
+        if ((0, optionsFunctions_1.isOptionsObjectForm)(arg2) &&
+            (failLevel !== 'auto' || includeMetadata !== false)) {
+            throw new TypeError('Invalid call: when providing an options object, do not also pass positional parameters.');
+        }
+        const mode = (0, optionsFunctions_1.inferModeFromArgs)(arg2);
+        const defaultOptions = (0, defaultParserOptions_1.getDefaultUserOptions)(mode);
+        // Normalize to a fully-required options object.
+        let userOpts;
+        // Required, makes all properties in T required, no undefined.
+        if ((0, optionsFunctions_1.isOptionsObjectForm)(arg2)) {
+            // Options-object Form.
+            userOpts = {
+                ...defaultOptions, // Sets the default options.
+                ...arg2,
+            };
+        }
+        else {
+            // Positional form.
+            userOpts = {
+                ...defaultOptions, // Sets the default options.
+                strictMode: arg2 ?? defaultOptions.strictMode,
+                failLevel,
+                includeMetadata,
+            };
+        }
+        if ((0, pathAndFileName_1.getFileNameExtension)(filePath).toLowerCase() !== '.yini') {
+            // IMPORTANT: If "silent" option is set, do not log anything to console!
+            if (!userOpts.silent) {
+                // In quiet-mode we still show errors (these are fine).
+                console.error('Invalid file extension for YINI file:');
+                console.error(`"${filePath}"`);
+                console.error('File does not have a valid ".yini" extension (case-insensitive).');
+            }
+            throw new Error('Error: Unexpected file extension for YINI file');
+        }
+        // ---- Phase 0: I/O ----
+        const timeStartMs = performance.now();
+        // let content = fs.readFileSync(filePath, 'utf8')
+        const rawBuffer = fs_1.default.readFileSync(filePath); // Raw buffer for size.
+        const fileByteSize = rawBuffer.byteLength; // Byte size in UTF-8.
+        let content = rawBuffer.toString('utf8');
+        const timeEndMs = performance.now();
+        // this.#runtime.sourceType = 'File'
+        __classPrivateFieldGet(this, _YiniRuntime_runtime, "f").fileName = filePath;
+        __classPrivateFieldGet(this, _YiniRuntime_runtime, "f").timeIoMs = +(timeEndMs - timeStartMs).toFixed(3); // NOTE: (!) Dependent of isWithTiming.
+        if (userOpts.includeMetadata) {
+            __classPrivateFieldGet(this, _YiniRuntime_runtime, "f").lineCount = content.split(/\r?\n/).length; // Counts the lines.
+            __classPrivateFieldGet(this, _YiniRuntime_runtime, "f").fileByteSize = fileByteSize;
+            // this.#runtime.timeIoMs = +(timeEndMs - timeStartMs).toFixed(3) // NOTE: (!) Dependent of isWithTiming.
+            __classPrivateFieldGet(this, _YiniRuntime_runtime, "f").preferredBailSensitivity = userOpts.failLevel;
+            __classPrivateFieldGet(this, _YiniRuntime_runtime, "f").sha256 = (0, string_1.computeSha256)(content); // NOTE: Compute BEFORE any possible tampering of content.
+        }
+        let hasNoNewlineAtEOF = false;
+        if (!content.endsWith('\n')) {
+            content += '\n';
+            hasNoNewlineAtEOF = true;
+        }
+        const result = this.doParse(content, {
+            ...userOpts,
+        });
+        // if (hasNoNewlineAtEOF && !userOpts.quiet && !userOpts.silent) {
+        if (hasNoNewlineAtEOF && !userOpts.quiet) {
+            // IMPORTANT: If "silent" option is set, do not log anything to console!
+            if (!userOpts.silent) {
+                //@todo: (or maybe not, 20250917) Maybe let errorHandler emit message
+                console.warn(`No newline at end of file, it's recommended to end a file with a newline. File:\n"${filePath}"`);
+            }
+        }
+        return result;
+    }
+}
+exports.YiniRuntime = YiniRuntime;
+_YiniRuntime_runtime = new WeakMap();
+//# sourceMappingURL=runtime.js.map

package/dist/core/runtime.js.map

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

package/dist/dev/main.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/dev/main.js

@@ -0,0 +1,305 @@
+"use strict";
+/*
+ * This includes of dev / debug / demo / custom-tesing code.
+ *
+ * https://github.com/YINI-lang/yini-parser-typescript/blob/main/docs/Project-Setup.md
+ *
+ * Run this code with the following commands:
+ *     npm run start:dev
+ * or
+ *     npm run start:dev:debug
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const env_1 = require("../config/env");
+const print_1 = require("../utils/print");
+const YINI_1 = __importDefault(require("../YINI"));
+(0, print_1.debugPrint)();
+(0, print_1.debugPrint)('-> Entered dev/main.ts');
+(0, print_1.debugPrint)();
+if ((0, env_1.isDev)() || (0, env_1.isDebug)()) {
+    console.log(`process.env?.NODE_ENV = '${process.env?.NODE_ENV}'`);
+    console.log(`process.env?.APP_ENV  = '${process.env?.APP_ENV}'`);
+    console.log(`process.env?.IS_DEBUG = '${process.env?.IS_DEBUG}'`);
+    (0, print_1.debugPrint)();
+    console.log(`localNodeEnv = '${env_1.localNodeEnv}'`);
+    console.log(` localAppEnv = '${env_1.localAppEnv}'`);
+    console.log(' isProdEnv() = ' + (0, env_1.isProdEnv)());
+    console.log('  isDevEnv() = ' + (0, env_1.isDevEnv)());
+    console.log(' isTestEnv() = ' + (0, env_1.isTestEnv)());
+    console.log();
+    console.log('     isDev() = ' + (0, env_1.isDev)());
+    console.log('   isDebug() = ' + (0, env_1.isDebug)());
+    console.log();
+}
+const debugTestObj = {
+    name: 'e_test',
+    lang: 'TypeScript',
+};
+(0, print_1.debugPrint)('debugTestObj:');
+(0, print_1.debugPrint)(debugTestObj);
+(0, print_1.debugPrint)();
+if ((0, env_1.isProdEnv)()) {
+    // Do nothing, and exit.
+}
+else {
+    if (env_1.localAppEnv === 'local' && env_1.localNodeEnv !== 'test') {
+        // parseUntilError(`^1 SectionName`, false, 2)
+        //         const validYini = `
+        // < user
+        // username = 'tester two'
+        // isSysOp = YES
+        //     << prefs
+        //     theme = "light"
+        //     notifications = OFF
+        // ^1 user2
+        // ^2 prefs
+        // ^3 deepSection
+        // ^4 deeperSection
+        // key = "Level 4 section"
+        // ^5 yetDeeperSection
+        // key = "Level 5 section"
+        // item = 77
+        // <1 user3
+        // username = 'tester three'
+        // isSysOp = NO
+        //     <<2 prefs
+        //     theme = "special-dark"
+        //     notifications = ON
+        // `
+        //         // Act.
+        //         const result = parseUntilError(validYini)
+        //         debugPrint(result)
+        // const validYini = `^ App
+        //     id = 32403  # The correct app id.
+        //     title = "My Program"
+        // `
+        /*
+        const yini = `
+        @yini
+
+        ^ NumberFormats
+
+          ^^ HexFormat              // Hexadecimal (base-16)
+             hex    = #FF0066       // Default notation
+             altHex = 0xFF0066      // Alternative notation
+          ^^ BinFormat              // Binary (base-2)
+             bin    = %10101111     // Default notation
+             altBin = 0b10101111    // Alternative notation
+          ^^ OctFormat              // Octal (base-8)
+             oct    = 0o755         // ( = decimal 493)
+          ^^ DozFormat              // Duodecimal (base-12)
+             doz    = 0z10XE        // Default notation:     X=10, E=11
+             altDoz = 0z10AB        // Alternative notation: A=10, B=11
+        ` // End.
+        */
+        /*
+        const yini = `
+    @yini
+    @YINI   ///dfsf
+
+    < User
+    nullKey =
+    nullKey2 = NULL
+    username = 'tester two'
+    userId   = 234
+    userColor = #ffaa99
+    userPerm = 0O733
+    userFearues = %01101
+    isSysOp = YES
+
+    map = {
+        a: 3,
+        b: 4,
+        cc: 5,
+        \`d d\`: 3453
+        }
+
+    listValueB: 3, 4, 5
+    listValue2 = ["a", "b"]
+    listValue3 = [434]
+    listValue4 = []
+    listValue5 = [1, ["a", "b", "c", [null, TRUE]], 3]
+    
+    --listObject = { a: 1, b: 2}
+    
+    colonList:
+        1,
+        2,
+        3,
+
+        << Prefs
+        theme = "light"
+        notifications = OFF
+        nullValue = NULL
+
+    ^1 User2
+    ^2 PrefsOfUser2
+    ^3 DeepSection
+    ^4 DeeperSection
+    key = "Level 4 section"
+    ^5 YetDeeperSection
+    key = "Level 5 section"
+    item = 77
+
+    <1 User3
+    username = 'tester three'
+    isSysOp = NO
+
+        <2 Prefs2
+        theme = "special-dark"
+        notifications = ON
+
+        <2 Special
+        value = 123
+        `
+*/
+        // npm run start:dev
+        // "timing": {
+        //     "totalMs": 158.421,
+        //     "phase1Ms": 151.36,
+        //     "phase2Ms": 6.92,
+        //     "phase3Ms": 0.14
+        // }
+        //console.log(toPrettyJSON(YINI.parse(yini, false, 'auto', true)))
+        // const yini = `
+        //     < SubTitle
+        //     theme = "special-dark"
+        //     notifications = ON
+        //     < SubTitle // NOT OK, SubTitle already exists
+        //     theme2 = "special-dark"
+        //         `
+        const errorYini = `
+        ^ Section1
+        333="oops"   // invalid key => error
+        `;
+        const warnYini = `
+        ^ Section2
+        // => warning, if requireDocTerminator: 'warn-if-missing'
+        `;
+        // console.log(
+        //     toPrettyJSON(
+        YINI_1.default.parse(`
+    ^ Section1
+    value =   // invalid in strict mode => error
+    `, {
+            // failLevel: 'errors',
+            throwOnError: false,
+            // requireDocTerminator: 'warn-if-missing',
+            strictMode: true,
+            silent: false,
+            // includeMetadata: false,
+        });
+        //     ),
+        // )
+        // const yini = `
+        //     /*sdfsdf*/
+        //     @yini
+        //     @include 'sdf'
+        //     --@invalid
+        //     @deprecated
+        //     ^ window
+        //     --^^ window2
+        //     title = 'Sample Window'  // Strings can be enclosed in either ' or ".
+        //     @deprecated
+        //     id = 'window_main'
+        //     // @bla
+        //     --@include 'wrongplace'
+        //     --@yini   // This is an error should be catched in the parser.
+        //     /end
+        // `
+        // YINI.setTabSize(2)
+        // debugPrint('tab size = ' + YINI.getTabSize())
+        // const yini = `        @yini
+        // --@yini
+        // ^ Header // INVALID: Must start with atleast one 1-level section.
+        // key = 33254
+        // /END
+        // --/END
+        // `
+        // console.log(
+        //     toPrettyJSON(
+        //         YINI.parse(yini, {
+        //             strictMode: false,
+        //             failLevel: 'errors',
+        //             includeMetadata: false,
+        //             requireDocTerminator: 'optional',
+        //         }),
+        //     ),
+        // )
+        //         const yini = `
+        // ^ Booleans
+        // bool1 = true
+        // bool2 = false
+        // bool3 = on
+        // bool4 = off
+        // bool5 = yes
+        // bool6 = no
+        //         `
+        //         console.log(
+        //             toPrettyJSON(
+        //                 YINI.parse(yini, {
+        //                     strictMode: true,
+        //                     failLevel: 'auto',
+        //                     includeMetadata: false,
+        //                     requireDocTerminator: 'optional',
+        //                 }),
+        //             ),
+        //         )
+        // console.log(
+        //     toPrettyJSON(
+        //         YINI.parseFile(
+        //             'comprehensive-example.yini',
+        //             false,
+        //             'auto',
+        //             true,
+        //         ),
+        //     ),
+        // )
+        // const result: YiniParseResult = YINI.parseFile(
+        //     'comprehensive-example.yini',
+        //     { includeMetadata: true },
+        // )
+        // console.log(toPrettyJSON('' + result.meta))
+        // console.log(
+        //     toPrettyJSON(
+        //         YINI.parseFile('comprehensive-example.yini', {
+        //             strictMode: false,
+        //             failLevel: 'auto',
+        //             includeMetadata: true,
+        //         }),
+        //     ),
+        // )
+        // const fileName = './tests/fixtures/invalid/corrupt-config-2.yini'
+        // const result = YINI.parseFile(fileName, {
+        //     strictMode: true,
+        //     failLevel: 'ignore-errors',
+        // })
+        // printObject(result)
+        // let parserOptions: any = getDefaultUserOptions('lenient')
+        // debugPrint('** parserOptions: (lenient)')
+        // isDebug() && printObject(parserOptions)
+        // isDebug() &&
+        //     console.log(
+        //         'derived mode = ' + matchModeFromParseOptions(parserOptions),
+        //     )
+        // parserOptions = getDefaultUserOptions('strict')
+        // debugPrint('** parserOptions: (strict)')
+        // isDebug() && printObject(parserOptions)
+        // isDebug() &&
+        //     console.log(
+        //         'derived mode = ' +
+        //             matchModeFromCoreOptions(toCoreOptions(parserOptions)),
+        //     )
+        // const fileName =
+        //     './tests/fixtures/invalid/bad-user-profile-config-2.yini'
+        // YINI.parseFile(fileName, {
+        //     strictMode: false,
+        //     failLevel: 'auto',
+        //     includeMetadata: true,
+        // })
+    }
+}
+//# sourceMappingURL=main.js.map

package/dist/dev/main.js.map

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

package/dist/grammar/{YiniLexer.js → generated/YiniLexer.js}

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-// Generated from grammar/v1.0.0-rc.3/YiniLexer.g4 by ANTLR 4.13.2
+// Generated from ./grammar/v1.0.0-rc.3/YiniLexer.g4 by ANTLR 4.13.2
 // noinspection ES6UnusedImports,JSUnusedGlobalSymbols,JSUnusedLocalSymbols
 const antlr4_1 = require("antlr4");
 class YiniLexer extends antlr4_1.Lexer {
@@ -412,3 +412,4 @@ YiniLexer._serializedATN = [4, 0, 50, 705, 6, -1, 2, 0,
     636, 645, 650, 655, 666, 668, 673, 682, 691, 696, 702, 1, 6, 0, 0];
 YiniLexer.DecisionsToDFA = YiniLexer._ATN.decisionToState.map((ds, index) => new antlr4_1.DFA(ds, index));
 exports.default = YiniLexer;
+//# sourceMappingURL=YiniLexer.js.map