yini-parser 1.0.0-alpha.1 → 1.0.0-alpha.3

package/dist/yiniHelpers.d.ts

@@ -0,0 +1,44 @@
+/**
+ * This file contains specific YINI helper functions (utils).
+ * @note More general helper functions should go into the dir "src/utils/".
+ */
+/**
+ * Check if the character is a section marker character.
+ * @param character A character in a string.
+ * @note The string must be of length 1.
+ * @throws Will throw if not exactly of length 1.
+ */
+export declare const isMarkerCharacter: (character: string) => boolean;
+/**
+ * @returns Returns the beginning up to (but not including) any comments
+ * starting with //, #, ; or --.
+ * @throws Will throw if consisting more than 1 lines.
+ */
+export declare const stripCommentsAndAfter: (line: string) => string;
+/**
+ * Checks if a string conforms to the identifier rules for section headers and
+ * member key names as defined by the YINI specification, following
+ * the ANTLR4 lexer rule:
+ * IDENT: ('a'..'z' | 'A'..'Z' | '_') ('a'..'z' | 'A'..'Z' | '0'..'9' | '_')*
+
+* @throws Will only throw if blank string.
+ *
+ * @satisfies Should satisfy YINI spec 7, chapter: 3.4. Identifiers, Form 1:
+ * Identifier of Simple Form.
+ * @link https://github.com/YINI-lang/YINI-spec/blob/develop/YINI-Specification.md#34-identifiers
+ */
+export declare const isValidSimpleIdent: (str: string) => boolean;
+/**
+ * Checks if a string is a valid backticked phrase/identifier:
+ * - Wrapped in backticks.
+ * - No raw tabs, newlines, or control characters (U+0000–U+001F), except as
+ *   escaped sequences (e.g., \n).
+ * - May contain ordinary spaces.
+ * @note Empty is allowed: ``, as in spec (due to conform with the JSON empty key "").
+ * @throws Will only throw if missing enclosed backtick(s).
+ *
+ * @satisfies Should satisfy YINI spec 7, chapter: 3.4. Identifiers, Form 2:
+ * Backticked Identifier.
+ * @link https://github.com/YINI-lang/YINI-spec/blob/develop/YINI-Specification.md#34-identifiers
+ */
+export declare const isValidBacktickedIdent: (str: string) => boolean;

package/package.json

@@ -1,18 +1,28 @@
 {
     "name": "yini-parser",
-    "version": "1.0.0-alpha.1",
+    "version": "1.0.0-alpha.3",
     "description": "YINI parser for JavaScript/TypeScript, an INI-inspired configuration format, meant to be readable, and easy to use.",
-    "main": "dist/index.js",
-    "types": "dist/index.d.ts",
+    "keywords": [
+        "read",
+        "yini",
+        "config",
+        "ini",
+        "parser",
+        "file",
+        "parse",
+        "configuration"
+    ],
+    "homepage": "https://m4se.com/yini-lang.org/",
+    "license": "Apache-2.0",
     "files": [
         "dist/",
-        "index.js",
-        "index.d.ts",
         "package.json",
         "README.md",
         "LICENSE",
         "CHANGELOG.md"
     ],
+    "main": "dist/index.js",
+    "types": "dist/index.d.ts",
     "exports": {
         ".": {
             "import": "./dist/index.js",
@@ -22,35 +32,23 @@
     },
     "repository": {
         "type": "git",
-        "url": "git+https://github.com/YOUR_USERNAME/yini-parser.git"
+        "url": "https://github.com/YINI-lang/yini-parser-typescript.git"
     },
-    "keywords": [
-        "read",
-        "yini",
-        "config",
-        "ini",
-        "parser",
-        "file",
-        "parse",
-        "configuration"
-    ],
-    "author": "Marko K. Seppänen",
-    "license": "Apache-2.0",
     "private": false,
     "scripts": {
-        "start": "cross-env NODE_ENV=production APP_ENV=production node dist/index.js",
-        "start:debug": "cross-env IS_DEBUG=1 npm run start",
-        "start:dev": "cross-env NODE_ENV=development APP_ENV=local ts-node src/index.ts",
-        "start:dev:debug": "cross-env IS_DEBUG=1 npm run start:dev",
+        "start": "npm run build && node dist/index.js",
+        "start:debug": "npm run start -- isDebug=1",
+        "start:dev": "cross-env NODE_ENV=development APP_ENV=local ts-node src/index.ts isDev=1",
+        "start:dev:debug": "cross-env npm run start:dev -- isDebug=1",
         "start-w-clean": "npm run tsc && npm run clean:ts-js && npm run start:dev",
         "test": "cross-env NODE_ENV=test APP_ENV=local jest --bail --verbose --runInBand",
-        "test:debug": "cross-env IS_DEBUG=1 npm run test",
+        "test:debug": "cross-env npm run test -- --isDebug=1",
         "test:smoke": "cross-env NODE_ENV=test APP_ENV=local jest tests/smoke --bail --verbose --runInBand",
         "test:unit": "cross-env NODE_ENV=test APP_ENV=local jest tests/unit --bail --verbose --runInBand",
         "test:integr": "cross-env NODE_ENV=test APP_ENV=local jest tests/integration --bail --verbose --runInBand",
-        "test:smoke:debug": "cross-env IS_DEBUG=1 npm run test:smoke",
-        "test:unit:debug": "cross-env IS_DEBUG=1 npm run test:unit",
-        "test:integr:debug": "cross-env IS_DEBUG=1 npm run test:integr",
+        "test:smoke:debug": "cross-env npm run test:smoke -- --isDebug=1",
+        "test:unit:debug": "cross-env npm run test:unit -- --isDebug=1",
+        "test:integr:debug": "cross-env npm run test:integr -- --isDebug=1",
         "ci:test": "cross-env NODE_ENV=test APP_ENV=ci jest --verbose --runInBand",
         "ci:test:smoke": "cross-env NODE_ENV=test APP_ENV=ci jest tests/smoke --verbose --runInBand",
         "tsc": "npx tsc -p ./tsconfig.json",
@@ -60,6 +58,7 @@
         "build": "tsc -p ./tsconfig.json",
         "prepublishOnly": "npm run lint && npm test && npm run build"
     },
+    "author": "Marko K. Seppänen",
     "dependencies": {
         "antlr4": "^4.13.2"
     },

package/dist/src/config/env.js

@@ -1,15 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.APP_ENV = exports.NODE_ENV = exports.isTest = exports.isProd = exports.isDev = exports.isDebug = void 0;
-const NODE_ENV = (process.env.NODE_ENV || 'development');
-exports.NODE_ENV = NODE_ENV;
-const APP_ENV = (process.env.APP_ENV || 'local');
-exports.APP_ENV = APP_ENV;
-const isDebug = () => !!process.env.IS_DEBUG;
-exports.isDebug = isDebug;
-const isDev = () => NODE_ENV === 'development';
-exports.isDev = isDev;
-const isProd = () => NODE_ENV === 'production';
-exports.isProd = isProd;
-const isTest = () => NODE_ENV === 'test';
-exports.isTest = isTest;

package/dist/tests/integration/1-core-parsing/parse-bigger-section-nesting-as-object.test.js

@@ -1,83 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const path_1 = __importDefault(require("path"));
-const src_1 = __importDefault(require("../../../src"));
-const system_1 = require("../../../src/utils/system");
-const DIR_OF_FIXTURES = '../../fixtures/valid/section-nesting-w-classic-markers';
-const answerSectionNestingBigger = {
-    Section1: {
-        bValue1: true,
-        intValue: 1,
-        Section11: {
-            sValue: 11,
-            Section111: {
-                sValue: 111,
-                intValue: 111,
-            },
-        },
-        Section12: {
-            sValue: 12,
-        },
-    },
-    Section2: {
-        sValue: 2,
-        Section21: {
-            sValue: 21,
-            bValue: false,
-            Section211: {
-                sValue: 211,
-                Section2111: {
-                    sValue: 2111,
-                },
-                Section2112: {
-                    sValue: 2112,
-                    strValue: 'test2112',
-                },
-            },
-        },
-        Section22: {
-            bValue3: true,
-            Section221: {
-                sValue: 221,
-            },
-        },
-        Section23: {
-            bValue3: true,
-        },
-    },
-};
-/**
- * Parse bigger section nesting as an object.
- */
-describe('Parse bigger section nesting as an object test:', () => {
-    const baseDir = path_1.default.join(__dirname, DIR_OF_FIXTURES);
-    test('1. Parse bigger section nesting as object, file "section-nesting-bigger.yini".', () => {
-        // Arrange.
-        const fileName = 'section-nesting-bigger.yini';
-        const fullPath = path_1.default.join(baseDir, fileName);
-        // Act.
-        const result = src_1.default.parseFile(fullPath);
-        (0, system_1.debugPrint)('fullPath = ' + fullPath);
-        (0, system_1.debugPrint)(result);
-        // Assert.
-        expect(!!result).toEqual(true);
-        expect(result.Section1).not.toBe('this should fail');
-        expect(JSON.stringify(result, null, 4)).toEqual(JSON.stringify(answerSectionNestingBigger, null, 4));
-    });
-    test('2. Parse bigger section nesting as object, file "section-nesting-bigger-w-comments.yini".', () => {
-        // Arrange.
-        const fileName = 'section-nesting-bigger-w-comments.yini';
-        const fullPath = path_1.default.join(baseDir, fileName);
-        // Act.
-        const result = src_1.default.parseFile(fullPath);
-        (0, system_1.debugPrint)('fullPath = ' + fullPath);
-        (0, system_1.debugPrint)(result);
-        // Assert.
-        expect(!!result).toEqual(true);
-        expect(result.Section1).not.toBe('this should fail');
-        expect(JSON.stringify(result, null, 4)).toEqual(JSON.stringify(answerSectionNestingBigger, null, 4));
-    });
-});

package/dist/tests/integration/1-core-parsing/parse-section-nesting-w-classic-markers.test.js

@@ -1,170 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const path_1 = __importDefault(require("path"));
-const src_1 = __importDefault(require("../../../src"));
-const system_1 = require("../../../src/utils/system");
-const DIR_OF_FIXTURES = '../../fixtures/valid/section-nesting-w-classic-markers';
-/**
- * Parse section nesting with classic (repeating characters) section head markers test.
- */
-describe('Parse section nesting w CLASSIC markers:', () => {
-    const baseDir = path_1.default.join(__dirname, DIR_OF_FIXTURES);
-    test('1. Parse section nesting w CLASSIC markers.', () => {
-        // Arrange.
-        const fileName = 'section-nesting-1.yini';
-        const fullPath = path_1.default.join(baseDir, fileName);
-        // Act.
-        const result = src_1.default.parseFile(fullPath);
-        (0, system_1.debugPrint)(result);
-        // Assert.
-        expect(!!result).toEqual(true);
-        expect(result.Section1).not.toBe('this should fail');
-        expect(JSON.stringify(result, null, 4)).toEqual(JSON.stringify({ Section1: { Section11: { value: 11 } } }, null, 4));
-    });
-    test('2. Parse section nesting w CLASSIC markers.', () => {
-        // Arrange.
-        const fileName = 'section-nesting-2.yini';
-        const fullPath = path_1.default.join(baseDir, fileName);
-        // Act.
-        const result = src_1.default.parseFile(fullPath);
-        (0, system_1.debugPrint)(result);
-        // Assert.
-        expect(!!result).toEqual(true);
-        expect(result.Section1).not.toBe('this should fail');
-        expect(JSON.stringify(result, null, 4)).toEqual(JSON.stringify({
-            Section1: { value: 1, Section11: { value: 11 } },
-            Section2: { value: 2 },
-        }, null, 4));
-    });
-    test('3. Parse section nesting w CLASSIC markers.', () => {
-        // Arrange.
-        const fileName = 'section-nesting-3.yini';
-        const fullPath = path_1.default.join(baseDir, fileName);
-        // Act.
-        const result = src_1.default.parseFile(fullPath);
-        (0, system_1.debugPrint)(result);
-        // Assert.
-        expect(!!result).toEqual(true);
-        expect(result.Section1).not.toBe('this should fail');
-        expect(JSON.stringify(result, null, 4)).toEqual(JSON.stringify({
-            Section1: {
-                value: 1,
-                Section11: { value: 11, Section111: { value: 111 } },
-            },
-        }, null, 4));
-    });
-    test('4. Parse section nesting w CLASSIC markers.', () => {
-        // Arrange.
-        const fileName = 'section-nesting-4.yini';
-        const fullPath = path_1.default.join(baseDir, fileName);
-        // Act.
-        const result = src_1.default.parseFile(fullPath);
-        (0, system_1.debugPrint)(result);
-        // Assert.
-        expect(!!result).toEqual(true);
-        expect(result.Section1).not.toBe('this should fail');
-        expect(JSON.stringify(result, null, 4)).toEqual(JSON.stringify({
-            Section1: {
-                Section11: { Section111: { value: 111 } },
-            },
-        }, null, 4));
-    });
-    test('4. Parse section nesting w CLASSIC markers.', () => {
-        // Arrange.
-        const fileName = 'section-nesting-4.yini';
-        const fullPath = path_1.default.join(baseDir, fileName);
-        // Act.
-        const result = src_1.default.parseFile(fullPath);
-        (0, system_1.debugPrint)(result);
-        // Assert.
-        expect(!!result).toEqual(true);
-        expect(result.Section1).not.toBe('this should fail');
-        expect(JSON.stringify(result, null, 4)).toEqual(JSON.stringify({
-            Section1: {
-                Section11: { Section111: { value: 111 } },
-            },
-        }, null, 4));
-    });
-    test('5. Parse section nesting w CLASSIC markers.', () => {
-        // Arrange.
-        const fileName = 'section-nesting-5.yini';
-        const fullPath = path_1.default.join(baseDir, fileName);
-        // Act.
-        const result = src_1.default.parseFile(fullPath);
-        (0, system_1.debugPrint)(result);
-        // Assert.
-        expect(!!result).toEqual(true);
-        expect(result.Section1).not.toBe('this should fail');
-        expect(JSON.stringify(result, null, 4)).toEqual(JSON.stringify({
-            Section1: {
-                Section11: { Section111: { value: 111 } },
-            },
-            Section2: { value: 2 },
-        }, null, 4));
-    });
-    test('6. Parse section nesting w CLASSIC markers.', () => {
-        // Arrange.
-        const fileName = 'section-nesting-6.yini';
-        const fullPath = path_1.default.join(baseDir, fileName);
-        // Act.
-        const result = src_1.default.parseFile(fullPath);
-        (0, system_1.debugPrint)(result);
-        // Assert.
-        expect(!!result).toEqual(true);
-        expect(result.Section1).not.toBe('this should fail');
-        expect(JSON.stringify(result, null, 4)).toEqual(JSON.stringify({
-            Section1: {
-                Section11: { Section111: { value: 111 } },
-            },
-            Section2: {
-                value: 2,
-                Section21: { Section211: { value: 211 } },
-            },
-        }, null, 4));
-    });
-    test('7. Parse section nesting w CLASSIC markers.', () => {
-        // Arrange.
-        const fileName = 'section-nesting-7.yini';
-        const fullPath = path_1.default.join(baseDir, fileName);
-        // Act.
-        const result = src_1.default.parseFile(fullPath);
-        (0, system_1.debugPrint)(result);
-        // Assert.
-        expect(!!result).toEqual(true);
-        expect(result.Section1).not.toBe('this should fail');
-        expect(JSON.stringify(result, null, 4)).toEqual(JSON.stringify({
-            Section1: {
-                Section11: { Section111: { value: 111 } },
-            },
-            Section2: {
-                value: 2,
-                Section21: { Section211: { value: 211 } },
-                Section22: { value: 221 },
-            },
-        }, null, 4));
-    });
-    test('8. Parse section nesting w CLASSIC markers.', () => {
-        // Arrange.
-        const fileName = 'section-nesting-8.yini';
-        const fullPath = path_1.default.join(baseDir, fileName);
-        // Act.
-        const result = src_1.default.parseFile(fullPath);
-        (0, system_1.debugPrint)(result);
-        // Assert.
-        expect(!!result).toEqual(true);
-        expect(result.Section1).not.toBe('this should fail');
-        expect(JSON.stringify(result, null, 4)).toEqual(JSON.stringify({
-            Section1: {
-                Section11: { Section111: {} },
-            },
-            Section2: {
-                value: 2,
-                Section21: { Section211: {} },
-                Section22: { value: 22 },
-            },
-        }, null, 4));
-    });
-});

package/dist/tests/integration/1-core-parsing/parse-section-nesting-w-nsh-markers.test.js

@@ -1,27 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const path_1 = __importDefault(require("path"));
-const src_1 = __importDefault(require("../../../src"));
-const system_1 = require("../../../src/utils/system");
-const DIR_OF_FIXTURES = '../../fixtures/valid/section-nesting-w-nsh-markers';
-/**
- * Parse section nesting with NUMERIC SHORTHAND section head markers test.
- */
-describe('Parse section nesting w NUMERIC SHORTHAND markers:', () => {
-    const baseDir = path_1.default.join(__dirname, DIR_OF_FIXTURES);
-    xtest('1. Parse section nesting w NUMERIC SHORTHAND markers.', () => {
-        // Arrange.
-        const fileName = 'nsh-section-nesting-1.yini';
-        const fullPath = path_1.default.join(baseDir, fileName);
-        // Act.
-        const result = src_1.default.parseFile(fullPath);
-        (0, system_1.debugPrint)(result);
-        // Assert.
-        expect(!!result).toEqual(true);
-        expect(result.Section1).not.toBe('this should fail');
-        expect(JSON.stringify(result, null, 4)).toEqual(JSON.stringify({ Section1: { Section11: { value: 11 } } }, null, 4));
-    });
-});

package/dist/tests/integration/1-core-parsing/read some values from level 1 and 2.test.js

@@ -1,77 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const path_1 = __importDefault(require("path"));
-const src_1 = __importDefault(require("../../../src"));
-const system_1 = require("../../../src/utils/system");
-const DIR_OF_FIXTURES = '../../fixtures/valid/level-two-deep';
-/**
- * Read correctly some values from level 1 and 2 sections tests.
- */
-describe('Read correctly some values from level 1 and 2 sections tests:', () => {
-    const baseDir = path_1.default.join(__dirname, DIR_OF_FIXTURES);
-    beforeAll(() => { });
-    test('1. Read correctly some values from level 1 and 2, from file "single-section-member-1.yini".', () => {
-        // Arrange.
-        const fileName = 'level-two-deep-1.yini';
-        const fullPath = path_1.default.join(baseDir, fileName);
-        // Act.
-        const result = src_1.default.parseFile(fullPath);
-        (0, system_1.debugPrint)('fullPath = ' + fullPath);
-        (0, system_1.debugPrint)(result);
-        // Assert.
-        expect(!!result).toEqual(true);
-        expect(result.general.name).toEqual('Kim');
-        expect(result.general.name).not.toBe('KIM');
-        expect(result.general.preferences.avatarMode).toEqual(false);
-    });
-    test('2. Read correctly some values from level 1 and 2, from file "level-two-deep-2.yini".', () => {
-        // Arrange.
-        const fileName = 'level-two-deep-2.yini';
-        const fullPath = path_1.default.join(baseDir, fileName);
-        // Act.
-        const result = src_1.default.parseFile(fullPath);
-        (0, system_1.debugPrint)('fullPath = ' + fullPath);
-        (0, system_1.debugPrint)(result);
-        // Assert.
-        // NOTE: Dry run parsing - enough that something is successfully returned.
-        expect(!!result).toEqual(true);
-        expect(result.APP.ID).toEqual(8);
-        expect(result.APP.EXTRA.FLAG).toEqual(false);
-        expect(result.APP.EXTRA.TIME_OUT).toEqual(6000);
-        expect(result.APP.EXTRA.TIME_OUT).not.toBe(0);
-    });
-    test('3. Read correctly some values from level 1 and 2, from file "level-two-deep-3.yini".', () => {
-        // Arrange.
-        const fileName = 'level-two-deep-3.yini';
-        const fullPath = path_1.default.join(baseDir, fileName);
-        // Act.
-        const result = src_1.default.parseFile(fullPath);
-        (0, system_1.debugPrint)('fullPath = ' + fullPath);
-        (0, system_1.debugPrint)(result);
-        // Assert.
-        // NOTE: Dry run parsing - enough that something is successfully returned.
-        expect(!!result).toEqual(true);
-        expect(result.Title.Alpha).toEqual(0.98);
-        expect(result.Title.Alpha).not.toBe(98);
-        expect(result.Title.AlternativeTitle.Name).toEqual('Some other name');
-    });
-    test('4. Read correctly some values from level 1 and 2, from file "level-two-deep-4.yini".', () => {
-        // Arrange.
-        const fileName = 'level-two-deep-4.yini';
-        const fullPath = path_1.default.join(baseDir, fileName);
-        // Act.
-        const result = src_1.default.parseFile(fullPath);
-        (0, system_1.debugPrint)('fullPath = ' + fullPath);
-        (0, system_1.debugPrint)(result);
-        // Assert.
-        // NOTE: Dry run parsing - enough that something is successfully returned.
-        expect(!!result).toEqual(true);
-        expect(result.User.username).toEqual('Alice');
-        expect(result.User.Preferences.theme).toEqual('classic');
-        expect(result.User.Preferences.notifications).toEqual(false);
-        expect(result.User.Preferences.notifications).not.toBe('false'); // NOTE: A string!
-    });
-});

package/dist/tests/integration/1-core-parsing/throw on bad section heads.test.js

@@ -1,162 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const src_1 = __importDefault(require("../../../src"));
-const DIR_OF_FIXTURES = '../../fixtures/valid/level-two-deep';
-/**
- * Throw error when parsing bad section heads tests.
- */
-describe('Throw error when parsing bad section head tests:', () => {
-    beforeAll(() => { });
-    test('1. Should throw error if starting with section (with a member) ^^.', () => {
-        // Arrange.
-        const fixture = `
-        ^^ InvalidHeader // INVALID: Must start with atleast one 1-level section.
-        value = 3
-        `;
-        // Act & Assert.
-        expect(() => {
-            src_1.default.parse(fixture);
-        }).toThrow();
-    });
-    test('2. Should throw error if jumping from section (with a member) ^ -> ^^^.', () => {
-        // Arrange.
-        const fixture = `
-        ^ Header1
-        value = true
-        // BELOW INVALID: Invalid to jump over sections when increasing nesting.
-        ^^^ InvalidHeader
-        anotherValue = 123
-        `;
-        // Act & Assert.
-        expect(() => {
-            src_1.default.parse(fixture);
-        }).toThrow();
-    });
-    test('3. Should throw error if starting with section (without members) ^^.', () => {
-        // Arrange.
-        const fixture = `
-        ^^ InvalidHeader // INVALID: Must start with atleast one 1-level section.
-        `;
-        // Act & Assert.
-        expect(() => {
-            src_1.default.parse(fixture);
-        }).toThrow();
-    });
-    test('4. Should throw error if jumping from section (without members) ^ -> ^^^.', () => {
-        // Arrange.
-        const fixture = `
-        ^ Header1
-        // BELOW INVALID: Invalid to jump over sections when increasing nesting.
-        ^^^ InvalidHeader
-        `;
-        // Act & Assert.
-        expect(() => {
-            src_1.default.parse(fixture);
-        }).toThrow();
-    });
-    test('5. Should throw error if starting with section (with a member) ^^^.', () => {
-        // Arrange.
-        const fixture = `
-        ^^^ InvalidHeader // INVALID: Must start with atleast one 1-level section.
-        strValue = "5"
-        `;
-        // Act & Assert.
-        expect(() => {
-            src_1.default.parse(fixture);
-        }).toThrow();
-    });
-    test('6. Should throw error if jumping from section (with a member) ^^ -> ^^^^.', () => {
-        // Arrange.
-        const fixture = `
-        ^ Section1
-        numValue = 66
-        ^^ Section2
-        numValue = 662
-        // BELOW INVALID: Invalid to jump over sections when increasing nesting.
-        ^^^^ InvalidHeader
-        anotherValue = 123
-        `;
-        // Act & Assert.
-        expect(() => {
-            src_1.default.parse(fixture);
-        }).toThrow();
-    });
-    test('7. Should throw error if starting with section (without members) ^^^.', () => {
-        // Arrange.
-        const fixture = `
-        ^^^ InvalidHeader // INVALID: Must start with atleast one 1-level section.
-        `;
-        // Act & Assert.
-        expect(() => {
-            src_1.default.parse(fixture);
-        }).toThrow();
-    });
-    test('8. Should throw error if jumping from section (without members) ^^ -> ^^^^.', () => {
-        // Arrange.
-        const fixture = `
-        ^ Section1
-        ^^ Section2
-        // BELOW INVALID: Invalid to jump over sections when increasing nesting.
-        ^^^^ InvalidHeader
-        `;
-        // Act & Assert.
-        expect(() => {
-            src_1.default.parse(fixture);
-        }).toThrow();
-    });
-    test('9. Should throw error if starting with section (without members) ^^ (prev. line is a comment).', () => {
-        // Arrange.
-        const fixture = `
-        // BELOW IS INVALID: Must start with atleast one 1-level section.
-        ^^ InvalidHeader
-        `;
-        // Act & Assert.
-        expect(() => {
-            src_1.default.parse(fixture);
-        }).toThrow();
-    });
-    test('10. Should throw error if jumping from section (without members) ^^ -> ^^^^.', () => {
-        // Arrange.
-        const fixture = `
-        ^ Section1
-        ^^ Section2
-        --// BELOW INVALID: Invalid to jump over sections when increasing nesting.
-        ^^^^ InvalidHeader
-        `;
-        // Act & Assert.
-        expect(() => {
-            src_1.default.parse(fixture);
-        }).toThrow();
-    });
-    test('11. Should throw error if mixing section header types.', () => {
-        // Arrange.
-        const invalidYini = `
-        ^^^3 Section1 // NOT OK, bad section marker, cannot mix marker types.
-        x = 200
-        `;
-        // Act & Assert.
-        expect(() => {
-            src_1.default.parse(invalidYini);
-        }).toThrow();
-    });
-    test('12. Should throw error if mixing section header types.', () => {
-        // Arrange.
-        const invalidYini = `
-        ~1 user3
-        username = 'tester three'
-        isSysOp = NO
-
-            # Below is invalid marker, mixup between basic and numeric section marker.
-            ~~2 prefs // NOT OK, bad section marker, cannot mix marker types.
-            theme = "special-dark"
-            notifications = ON
-        `;
-        // Act & Assert.
-        expect(() => {
-            src_1.default.parse(invalidYini);
-        }).toThrow();
-    });
-});