yini-parser 1.0.2-beta → 1.2.0-beta

package/dist/core/runtime.js

@@ -0,0 +1,189 @@
+"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 failLevel_1 = require("./options/failLevel");
+const normalizeOptions_1 = require("./options/normalizeOptions");
+const parserOptionsConstants_1 = require("./options/parserOptionsConstants");
+const pipeline_1 = require("./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.
+ */
+class YiniRuntime {
+    // constructor(sourceType: 'Inline' | 'File', seed?: Partial<IRuntimeInfo>) {
+    constructor(sourceType) {
+        /**
+         * @note Leading # makes the property "truly private" at runtime.
+         */
+        _YiniRuntime_runtime.set(this, void 0);
+        // this.#runtime = { sourceType, fileName: undefined, ...seed }
+        __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, normalizeOptions_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, normalizeOptions_1.inferModeFromArgs)(arg2);
+        const defaultOptions = (0, parserOptionsConstants_1.getDefaultOptions)(mode);
+        // Normalize to a fully-required options object.
+        let userOpts;
+        // Required, makes all properties in T required, no undefined.
+        if ((0, normalizeOptions_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, normalizeOptions_1.toCoreOptions)(level, userOpts);
+        (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, normalizeOptions_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, normalizeOptions_1.inferModeFromArgs)(arg2);
+        const defaultOptions = (0, parserOptionsConstants_1.getDefaultOptions)(mode);
+        // Normalize to a fully-required options object.
+        let userOpts;
+        // Required, makes all properties in T required, no undefined.
+        if ((0, normalizeOptions_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') {
+            console.error('Invalid file extension for YINI file:');
+            console.error(`"${filePath}"`);
+            console.log('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;
+        if (userOpts.includeMetadata) {
+            __classPrivateFieldGet(this, _YiniRuntime_runtime, "f").lineCount = content.split(/\r?\n/).length; // Counts the lines.
+            __classPrivateFieldGet(this, _YiniRuntime_runtime, "f").fileByteSize = fileByteSize;
+            __classPrivateFieldGet(this, _YiniRuntime_runtime, "f").timeIoMs = +(timeEndMs - timeStartMs).toFixed(3);
+            __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.suppressWarnings) {
+            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,374 @@
+"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"
+        //         `
+        // Arrange.
+        /*
+        const yini = `
+        @yini
+        // Example: Strict-friendly YINI document (no trailing commas, explicit /END)
+
+        ^ App
+        name = 'YINI Demo Service'
+        version = '1.4.0'
+        description = 'Demo service for showcasing the YINI format'
+        owners = ['dev-team', 'ops-team']
+
+        // String concatenation (the '+' joins adjacent STRING tokens)
+--        longNote = 'This text is split across ' +
+--                    'two strings and then concatenated.'
+
+        // Case-insensitive booleans
+        enabled = YES
+        experimentalMode = off
+
+        // Numbers (ints, floats, scientific)
+        retries = 3
+        requestTimeoutMs = 2500
+        backoffFactor = 1.25
+        maxPayloadMB = 1.0e2
+
+        ^ Server
+        host = '127.0.0.1'
+        port = 8080
+        useTLS = false
+
+        ^^ CORS
+            allowedOrigins: 'https://example.com', 'https://admin.example.com'
+            allowCredentials = true
+
+        ^^ Headers
+            // Object literal with key:value pairs
+            defaults = {
+            \`X-Frame-Options\`: 'DENY',
+            \`X-Content-Type-Options\`: 'nosniff'
+            }
+
+        ^ Database
+        engine = 'postgres'
+        host = 'db.internal'
+        port = 5432
+        username = 'app_user'
+        password = 'change_me'
+        pool = {
+            min: 2,
+            max: 16
+        }
+
+        ^^ Replicas
+            // Colon-form list (values only)
+            endpoints: 'db-replica-1.internal', 'db-replica-2.internal'
+            readPreference = 'nearest'
+
+        ^ Features
+        // Mixed data types
+        betaFlags = ['new-ui', 'fast-path']
+        darkLaunch = NO
+        uploadLimitMB = 128
+
+        ^ Integrations
+        // List of objects
+        webhooks = [
+            { name: 'audit', url: 'https://hooks.example.com/audit',  active: true },
+            { name: 'metrics', url: 'https://hooks.example.com/metric', active: true }
+        ]
+
+        ^ Users
+        // Simple table-ish list using colon form
+        admins: 'alice', 'bob', 'carol'
+        reviewers: 'dave', 'erin'
+
+        ^^ Profiles
+            // Object-of-objects
+            alice = {
+            email: 'alice@example.com',
+            roles: ['admin', 'dev'],
+            mfa: true
+            }
+            bob = {
+            email: 'bob@example.com',
+            roles: ['admin'],
+            mfa: false
+            }
+
+        ^ Paths
+        logs = '/var/log/yini-demo/'
+        data = '/srv/yini-demo/data'
+
+        ^^ \`Backups\`
+            // Empty value -> null in lenient mode; in strict mode, supply explicit null:
+            lastFull = null
+            targets: '/mnt/backup1', '/mnt/backup2'
+        ^^^ Backups2
+            value = 23
+
+        ^ Security
+        allowedIPs: '10.0.0.0/24', '10.1.0.0/24'
+
+        ^ Logging
+        level = 'info'
+        format = 'json'
+        sinks = ['stdout']
+
+        /END
+        `*/
+        // 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 = YINI_1.default.parseFile('comprehensive-example.yini', { includeMetadata: true });
+        console.log((0, print_1.toPrettyJSON)('' + result.meta));
+        // console.log(
+        //     toPrettyJSON(
+        //         YINI.parseFile('comprehensive-example.yini', {
+        //             strictMode: false,
+        //             failLevel: 'auto',
+        //             includeMetadata: true,
+        //         }),
+        //     ),
+        // )
+        // const fileName = './tests/fixtures/valid/common/common-config-2.yini'
+        // YINI.parseFile(fileName, {
+        //     strictMode: false,
+        //     failLevel: 'auto',
+        //     includeMetadata: true,
+        // })
+        // const fileName =
+        //     './tests/fixtures/invalid/bad-user-profile-config-2.yini'
+        // YINI.parseFile(fileName, {
+        //     strictMode: true,
+        //     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/generated/YiniLexer.d.ts

@@ -0,0 +1,74 @@
+import { ATN, CharStream, DFA, Lexer, RuleContext } from "antlr4";
+export default class YiniLexer extends Lexer {
+    static readonly YINI_TOKEN = 1;
+    static readonly INCLUDE_TOKEN = 2;
+    static readonly DEPRECATED_TOKEN = 3;
+    static readonly SECTION_HEAD = 4;
+    static readonly TERMINAL_TOKEN = 5;
+    static readonly SS = 6;
+    static readonly EUR = 7;
+    static readonly CARET = 8;
+    static readonly GT = 9;
+    static readonly LT = 10;
+    static readonly EQ = 11;
+    static readonly HASH = 12;
+    static readonly COMMA = 13;
+    static readonly COLON = 14;
+    static readonly OB = 15;
+    static readonly CB = 16;
+    static readonly OC = 17;
+    static readonly CC = 18;
+    static readonly PLUS = 19;
+    static readonly DOLLAR = 20;
+    static readonly PC = 21;
+    static readonly AT = 22;
+    static readonly SEMICOLON = 23;
+    static readonly BOOLEAN_FALSE = 24;
+    static readonly BOOLEAN_TRUE = 25;
+    static readonly NULL = 26;
+    static readonly EMPTY_OBJECT = 27;
+    static readonly EMPTY_LIST = 28;
+    static readonly SHEBANG = 29;
+    static readonly NUMBER = 30;
+    static readonly KEY = 31;
+    static readonly IDENT = 32;
+    static readonly IDENT_BACKTICKED = 33;
+    static readonly STRING = 34;
+    static readonly TRIPLE_QUOTED_STRING = 35;
+    static readonly SINGLE_OR_DOUBLE = 36;
+    static readonly R_AND_C_STRING = 37;
+    static readonly HYPER_STRING = 38;
+    static readonly ESC_SEQ = 39;
+    static readonly ESC_SEQ_BASE = 40;
+    static readonly NL = 41;
+    static readonly SINGLE_NL = 42;
+    static readonly WS = 43;
+    static readonly BLOCK_COMMENT = 44;
+    static readonly COMMENT = 45;
+    static readonly LINE_COMMENT = 46;
+    static readonly INLINE_COMMENT = 47;
+    static readonly IDENT_INVALID = 48;
+    static readonly REST = 49;
+    static readonly META_INVALID = 50;
+    static readonly EOF: number;
+    static readonly channelNames: string[];
+    static readonly literalNames: (string | null)[];
+    static readonly symbolicNames: (string | null)[];
+    static readonly modeNames: string[];
+    static readonly ruleNames: string[];
+    atLineStart(): boolean;
+    constructor(input: CharStream);
+    get grammarFileName(): string;
+    get literalNames(): (string | null)[];
+    get symbolicNames(): (string | null)[];
+    get ruleNames(): string[];
+    get serializedATN(): number[];
+    get channelNames(): string[];
+    get modeNames(): string[];
+    sempred(localctx: RuleContext, ruleIndex: number, predIndex: number): boolean;
+    private LINE_COMMENT_sempred;
+    static readonly _serializedATN: number[];
+    private static __ATN;
+    static get _ATN(): ATN;
+    static DecisionsToDFA: DFA[];
+}