yini-parser 1.0.1-beta → 1.1.0-beta

package/dist/YINI.js

@@ -4,139 +4,224 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 const fs_1 = __importDefault(require("fs"));
+const perf_hooks_1 = require("perf_hooks");
 const env_1 = require("./config/env");
+const ErrorDataHandler_1 = require("./core/ErrorDataHandler");
 const parseEntry_1 = require("./parseEntry");
 const pathAndFileName_1 = require("./utils/pathAndFileName");
 const print_1 = require("./utils/print");
+const string_1 = require("./utils/string");
+const DEFAULT_TAB_SIZE = 4; // De facto "modern default" (even though traditionally/historically it's 8).
+let _runtimeInfo = {
+    sourceType: 'Inline',
+    fileName: undefined,
+    fileByteSize: null,
+    lineCount: null,
+    timeIoMs: null,
+    preferredBailSensitivity: null,
+    sha256: null,
+};
+// Type guard: did the caller use the options-object form?
+const isOptionsObjectForm = (v) => {
+    return (v != null &&
+        typeof v === 'object' &&
+        // Note: If one wants, this can be relax to "typeof v === 'object'"
+        // but this keeps accidental booleans/strings out.
+        ('strictMode' in v ||
+            'failLevel' in v ||
+            'includeMetaData' in v ||
+            'includeDiagnostics' in v ||
+            'includeTiming' in v ||
+            'preserveUndefinedInMeta' in v ||
+            'requireDocTerminator' in v));
+};
+// Initial default values.
+const DEFAULT_OPTS = {
+    strictMode: false,
+    failLevel: 'auto',
+    includeMetaData: false,
+    includeDiagnostics: false,
+    includeTiming: false,
+    preserveUndefinedInMeta: false,
+    requireDocTerminator: false,
+};
 /**
  * This class is the public API, which exposes only parse(..) and
  * parseFile(..), rest of the implementation details are hidden.
  * @note Only parse and parseFile are public.
  */
 class YINI {
-}
-YINI.filePath = ''; // Used in error reporting.
-/**
- * Parse YINI content into a JavaScript object.
- *
- * @param yiniContent      YINI code as a string (multi‑line content supported).
- * @param strictMode       If `true`, enforce strict parsing rules (e.g. require `/END`, disallow trailing commas).
- * @param bailSensitivity  Controls how errors and warnings are handled:
- *   - `'auto'`               : Auto‑select level (strict→1, lenient→0)
- *   - `0` / `'Ignore-Errors'`    : Continue parsing despite errors; log them and attempt recovery.
- *   - `1` / `'Abort-on-Errors'`  : Stop parsing on the first error.
- *   - `2` / `'Abort-Even-on-Warnings'`: Stop parsing on the first warning **or** error.
- * @param includeMetaData  If `true`, return additional metadata (e.g. warnings, statistics) alongside the parsed object.
- *
- * @note The order of properties in each output object may differ from their order in the YINI source.
- *
- * @returns A JavaScript object representing the parsed YINI content.
- */
-YINI.parse = (yiniContent, strictMode = false, bailSensitivity = 'auto', includeMetaData = false) => {
-    (0, print_1.debugPrint)('-> Entered static parse(..) in class YINI\n');
-    // Important: First, before anything, trim beginning and trailing whitespaces!
-    yiniContent = yiniContent.trim();
-    if (!yiniContent) {
-        throw new Error('Syntax-Error: Unexpected blank YINI input');
-    }
-    if (!yiniContent.endsWith('\n')) {
-        yiniContent += '\n';
+    /**
+     * @returns The number of spaces per tab character used in error messages.
+     */
+    static getTabSize() {
+        return this.g_tabSize;
     }
-    let level = 0;
-    // if (bailSensitivity === 'auto' && !strictMode) level = 0
-    // if (bailSensitivity === 'auto' && strictMode) level = 1
-    if (bailSensitivity === 'auto') {
-        if (!strictMode)
-            level = 0;
-        if (strictMode)
-            level = 1;
-        // if (process.env.NODE_ENV === 'test') level = 1
+    /**
+     * Overrides the number of spaces per tab character used in error messages.
+     * Allowed range: 1-32.
+     */
+    static setTabSize(spaces) {
+        if (spaces < 1 || spaces > 32) {
+            new ErrorDataHandler_1.ErrorDataHandler('None/Ignore').pushOrBail(null, 'Fatal-Error', `Invalid tab size ${spaces} is out of range.`, 'Tab size must be between 1 and 32 spaces.');
+        }
+        this.g_tabSize = spaces;
     }
-    else {
-        level = bailSensitivity;
+    // --- 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.
+    static parse(yiniContent, arg2, // strictMode | options
+    failLevel = DEFAULT_OPTS.failLevel, includeMetaData = DEFAULT_OPTS.includeMetaData) {
+        var _a, _b, _c, _d, _e, _f, _g, _h;
+        (0, print_1.debugPrint)('-> Entered static parse(..) in class YINI\n');
+        // Runtime guard to catch illegal/ambiguous calls coming from JS or any-cast code
+        if (isOptionsObjectForm(arg2) &&
+            (failLevel !== 'auto' || includeMetaData !== false)) {
+            throw new TypeError('Invalid call: when providing an options object, do not also pass positional parameters.');
+        }
+        // Normalize to a fully-required options object.
+        let userOpts;
+        // Required, makes all properties in T required, no undefined.
+        // const userOpts: Required<IAllUserOptions> = isOptionsObjectForm(arg2)
+        if (isOptionsObjectForm(arg2)) {
+            // Options-object Form.
+            /* parse = (
+                  yiniContent: string,
+                  options: IAllUserOptions,
+               )
+            */
+            userOpts = Object.assign(Object.assign({}, DEFAULT_OPTS), { strictMode: (_a = arg2.strictMode) !== null && _a !== void 0 ? _a : DEFAULT_OPTS.strictMode, failLevel: (_b = arg2.failLevel) !== null && _b !== void 0 ? _b : DEFAULT_OPTS.failLevel, includeMetaData: (_c = arg2.includeMetaData) !== null && _c !== void 0 ? _c : DEFAULT_OPTS.includeMetaData, includeDiagnostics: (_d = arg2.includeDiagnostics) !== null && _d !== void 0 ? _d : DEFAULT_OPTS.includeDiagnostics, includeTiming: (_e = arg2.includeTiming) !== null && _e !== void 0 ? _e : DEFAULT_OPTS.includeTiming, preserveUndefinedInMeta: (_f = arg2.preserveUndefinedInMeta) !== null && _f !== void 0 ? _f : DEFAULT_OPTS.preserveUndefinedInMeta, requireDocTerminator: (_g = arg2.requireDocTerminator) !== null && _g !== void 0 ? _g : DEFAULT_OPTS.requireDocTerminator });
+        }
+        else {
+            // Positional form.
+            /* parse = (
+                  yiniContent: string,
+                  strictMode?: boolean,
+                  failLevel?: TPreferredFailLevel,
+                  includeMetaData?: boolean,
+               )
+            */
+            userOpts = Object.assign(Object.assign({}, DEFAULT_OPTS), { strictMode: (_h = arg2) !== null && _h !== void 0 ? _h : DEFAULT_OPTS.strictMode, failLevel,
+                includeMetaData });
+        }
+        if (userOpts.includeMetaData && _runtimeInfo.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.
+            _runtimeInfo.lineCount = lineCount;
+            _runtimeInfo.preferredBailSensitivity = userOpts.failLevel;
+            _runtimeInfo.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;
+        if (userOpts.failLevel === 'auto') {
+            if (!userOpts.strictMode)
+                level = 0;
+            if (userOpts.strictMode)
+                level = 1;
+        }
+        else {
+            level = userOpts.failLevel;
+        }
+        const coreOpts = {
+            isStrict: userOpts.strictMode,
+            bailSensitivity: level,
+            isIncludeMeta: userOpts.includeMetaData,
+            isWithDiagnostics: (0, env_1.isDev)() || (0, env_1.isDebug)() || userOpts.includeDiagnostics,
+            isWithTiming: (0, env_1.isDev)() || (0, env_1.isDebug)() || userOpts.includeTiming,
+            isKeepUndefinedInMeta: (0, env_1.isDebug)() || userOpts.preserveUndefinedInMeta,
+            isRequireDocTerminator: userOpts.requireDocTerminator,
+        };
+        (0, print_1.debugPrint)();
+        (0, print_1.debugPrint)('==== Call parse ==========================');
+        const result = (0, parseEntry_1._parseMain)(yiniContent, coreOpts, _runtimeInfo);
+        (0, print_1.debugPrint)('==== End call parse ==========================\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;
     }
-    const options = {
-        isStrict: strictMode,
-        bailSensitivityLevel: level,
-        isIncludeMeta: includeMetaData,
-        isWithDiagnostics: (0, env_1.isDev)() || (0, env_1.isDebug)(),
-        isWithTiming: (0, env_1.isDebug)(),
-    };
-    (0, print_1.debugPrint)();
-    (0, print_1.debugPrint)('==== Call parse ==========================');
-    const result = (0, parseEntry_1.parseMain)(yiniContent, options);
-    (0, print_1.debugPrint)('==== End call parse ==========================\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);
+    // --- 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.
+    static parseFile(filePath, arg2, // strictMode | options
+    failLevel = DEFAULT_OPTS.failLevel, includeMetaData = DEFAULT_OPTS.includeMetaData) {
+        var _a, _b, _c, _d, _e, _f, _g, _h;
+        (0, print_1.debugPrint)('-> Entered static parseFile(..) in class YINI\n');
+        (0, print_1.debugPrint)('Current directory = ' + process.cwd());
+        // Runtime guard to catch illegal/ambiguous calls coming from JS or any-cast code
+        if (isOptionsObjectForm(arg2) &&
+            (failLevel !== 'auto' || includeMetaData !== false)) {
+            throw new TypeError('Invalid call: when providing an options object, do not also pass positional parameters.');
+        }
+        // Normalize to a fully-required options object.
+        let userOpts;
+        // Required, makes all properties in T required, no undefined.
+        // const userOpts: Required<IAllUserOptions> = isOptionsObjectForm(arg2)
+        if (isOptionsObjectForm(arg2)) {
+            // Options-object Form.
+            /* parse = (
+                  yiniContent: string,
+                  options: IAllUserOptions,
+               )
+            */
+            userOpts = Object.assign(Object.assign({}, DEFAULT_OPTS), { strictMode: (_a = arg2.strictMode) !== null && _a !== void 0 ? _a : DEFAULT_OPTS.strictMode, failLevel: (_b = arg2.failLevel) !== null && _b !== void 0 ? _b : DEFAULT_OPTS.failLevel, includeMetaData: (_c = arg2.includeMetaData) !== null && _c !== void 0 ? _c : DEFAULT_OPTS.includeMetaData, includeDiagnostics: (_d = arg2.includeDiagnostics) !== null && _d !== void 0 ? _d : DEFAULT_OPTS.includeDiagnostics, includeTiming: (_e = arg2.includeTiming) !== null && _e !== void 0 ? _e : DEFAULT_OPTS.includeTiming, preserveUndefinedInMeta: (_f = arg2.preserveUndefinedInMeta) !== null && _f !== void 0 ? _f : DEFAULT_OPTS.preserveUndefinedInMeta, requireDocTerminator: (_g = arg2.requireDocTerminator) !== null && _g !== void 0 ? _g : DEFAULT_OPTS.requireDocTerminator });
+        }
+        else {
+            // Positional form.
+            /* parse = (
+                  yiniContent: string,
+                  strictMode?: boolean,
+                  failLevel?: TPreferredFailLevel,
+                  includeMetaData?: boolean,
+               )
+            */
+            userOpts = Object.assign(Object.assign({}, DEFAULT_OPTS), { strictMode: (_h = arg2) !== null && _h !== void 0 ? _h : DEFAULT_OPTS.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 = perf_hooks_1.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 = perf_hooks_1.performance.now();
+        _runtimeInfo.sourceType = 'File';
+        _runtimeInfo.fileName = filePath;
+        if (userOpts.includeMetaData) {
+            _runtimeInfo.lineCount = content.split(/\r?\n/).length; // Counts the lines.
+            _runtimeInfo.fileByteSize = fileByteSize;
+            _runtimeInfo.timeIoMs = +(timeEndMs - timeStartMs);
+            _runtimeInfo.preferredBailSensitivity = userOpts.failLevel;
+            _runtimeInfo.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.parse(content, userOpts.strictMode, userOpts.failLevel, userOpts.includeMetaData);
+        if (hasNoNewlineAtEOF) {
+            console.warn(`No newline at end of file, it's recommended to end a file with a newline. File:\n"${filePath}"`);
+        }
+        return result;
     }
-    return result;
-};
-/**
- * Parse a YINI file into a JavaScript object.
- *
- * @param yiniFile Path to the YINI file.
- * @param strictMode       If `true`, enforce strict parsing rules (e.g. require `/END`, disallow trailing commas).
- * @param bailSensitivity  Controls how errors and warnings are handled:
- *   - `'auto'`               : Auto‑select level (strict→1, lenient→0)
- *   - `0` / `'Ignore-Errors'`    : Continue parsing despite errors; log them and attempt recovery.
- *   - `1` / `'Abort-on-Errors'`  : Stop parsing on the first error.
- *   - `2` / `'Abort-Even-on-Warnings'`: Stop parsing on the first warning **or** error.
- * @param includeMetaData  If `true`, return additional metadata (e.g. warnings, statistics) alongside the parsed object.
- *
- * @note The order of properties in each output object may differ from their order in the YINI source.
- *
- * @returns A JavaScript object representing the parsed YINI content.
- */
-YINI.parseFile = (filePath, strictMode = false, bailSensitivity = 'auto', includeMetaData = false) => {
-    (0, print_1.debugPrint)('Current directory = ' + process.cwd());
-    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');
-    }
-    let content = fs_1.default.readFileSync(filePath, 'utf8');
-    let hasNoNewlineAtEOF = false;
-    if (!content.endsWith('\n')) {
-        content += '\n';
-        hasNoNewlineAtEOF = true;
-    }
-    YINI.filePath = filePath;
-    let level = 0;
-    // if (bailSensitivity === 'auto' && !strictMode) level = 0
-    // if (bailSensitivity === 'auto' && strictMode) level = 1
-    if (bailSensitivity === 'auto') {
-        if (!strictMode)
-            level = 0;
-        if (strictMode)
-            level = 1;
-        // if (process.env.NODE_ENV === 'test') level = 1
-    }
-    else {
-        level = bailSensitivity;
-    }
-    const options = {
-        isStrict: strictMode,
-        bailSensitivityLevel: level,
-        isIncludeMeta: includeMetaData,
-        isWithDiagnostics: (0, env_1.isDev)() || (0, env_1.isDebug)(),
-        isWithTiming: (0, env_1.isDebug)(),
-    };
-    (0, print_1.debugPrint)();
-    (0, print_1.debugPrint)('==== Call parse ==========================');
-    const result = (0, parseEntry_1.parseMain)(content, options);
-    (0, print_1.debugPrint)('==== End call parse ==========================\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;
-};
+}
+YINI.g_tabSize = DEFAULT_TAB_SIZE; // Global tab size used in error messages.
 exports.default = YINI;

package/dist/core/ASTBuilder.d.ts

@@ -0,0 +1,191 @@
+import { AnnotationContext, AssignmentContext, Bad_memberContext, Bad_meta_textContext, Boolean_literalContext, Colon_list_declContext, DirectiveContext, ElementsContext, EolContext, List_literalContext, MemberContext, Meta_stmtContext, Null_literalContext, Number_literalContext, Object_literalContext, Object_memberContext, Object_membersContext, PrologContext, StmtContext, String_concatContext, String_literalContext, Terminal_stmtContext, ValueContext, YiniContext } from '../grammar/YiniParser.js';
+import YiniParserVisitor from '../grammar/YiniParserVisitor';
+import { ErrorDataHandler } from './ErrorDataHandler';
+import { IParseCoreOptions, IYiniAST, TSourceType } from './types';
+/** Parse SECTION_HEAD token text → {level, name}.
+ * Supports repeated markers (^^^^) and shorthand (^7) (Spec 5.2–5.3.1). :contentReference[oaicite:5]{index=5}:contentReference[oaicite:6]{index=6}
+ */
+/**
+ * This interface defines a complete generic visitor for a parse tree produced
+ * by `YiniParser`.
+ *
+ * @param <Result> The return type of the visit operation. Use `void` for
+ * operations with no return type.
+ */
+export default class ASTBuilder<Result> extends YiniParserVisitor<Result> {
+    private errorHandler;
+    private readonly options;
+    private readonly isStrict;
+    private readonly onDuplicateKey;
+    private ast;
+    private sectionStack;
+    private meta_hasYiniMarker;
+    private _numOfMembers;
+    private meta_maxLevel;
+    mapSectionNamePaths: Map<string, number>;
+    /**
+     * @param metaFileName If parsing from a file, provide the file name here so the meta information can be updated accordingly.
+     * @param metaLineCount Provide the line-count here so the meta information can be updated accordingly.
+     */
+    constructor(errorHandler: ErrorDataHandler, options: IParseCoreOptions, sourceType: TSourceType, metaFileName: string | null);
+    private hasDefinedSectionTitle;
+    private setDefineSectionTitle;
+    /** Attach a section to the stack respecting up/down moves (Spec 5.3). :contentReference[oaicite:7]{index=7} */
+    private attachSection;
+    /** Insert a key/value into current section (duplicate handling per options). */
+    private putMember;
+    buildAST(ctx: YiniContext): IYiniAST;
+    /**
+     * Visit a parse tree produced by `YiniParser.yini`.
+     * @param ctx the parse tree
+     * @return the visitor result
+     */
+    visitYini: (ctx: YiniContext) => any;
+    /**
+     * Visit a parse tree produced by `YiniParser.prolog`.
+     * @param ctx the parse tree
+     * @return the visitor result
+     */
+    visitProlog: (ctx: PrologContext) => any;
+    /**
+     * Visit a parse tree produced by `YiniParser.terminal`.
+     * @param ctx the parse tree
+     * @return the visitor result
+     */
+    visitTerminal_stmt: (ctx: Terminal_stmtContext) => any;
+    /**
+     * Visit a parse tree produced by `YiniParser.stmt`.
+     * @param ctx the parse tree
+     * @grammarRule eol | SECTION_HEAD | assignment | colon_list_decl | marker_stmt | bad_member
+     * @return the visitor result
+     */
+    visitStmt: (ctx: StmtContext) => any;
+    /**
+     * Visit a parse tree produced by `YiniParser.meta_stmt`.
+     * @param ctx the parse tree
+     */
+    visitMeta_stmt: (ctx: Meta_stmtContext) => any;
+    /**
+     * Visit a parse tree produced by `YiniParser.directive`.
+     * @param ctx the parse tree
+     * @note Directive statements in YINI are special top-level commands that
+     *       appear only at the beginning of a document, before any sections
+     *       or members. Each directive may occur at most once per file.
+     */
+    visitDirective: (ctx: DirectiveContext) => any;
+    /**
+     * Visit a parse tree produced by `YiniParser.annotation`.
+     * @param ctx the parse tree
+     * @return the visitor result
+     */
+    visitAnnotation: (ctx: AnnotationContext) => any;
+    /**
+     * Visit a parse tree produced by `YiniParser.eol`.
+     * @param ctx the parse tree
+     * @return the visitor result
+     */
+    visitEol: (ctx: EolContext) => any;
+    /**
+     * Visit a parse tree produced by `YiniParser.assignment`.
+     * @param ctx the parse tree
+     * @return the visitor result
+     */
+    visitAssignment: (ctx: AssignmentContext) => any;
+    /**
+     * Visit a parse tree produced by `YiniParser.member`.
+     * @param ctx the parse tree
+     * @grammarRule KEY WS? EQ WS? value?
+     * @return the visitor result
+     */
+    visitMember: (ctx: MemberContext) => any;
+    /**
+     * Visit a parse tree produced by `YiniParser.value`.
+     * @param ctx the parse tree
+     * @return the visitor result
+     */
+    visitValue: (ctx: ValueContext) => any;
+    /**
+     * Visit a parse tree produced by `YiniParser.string_literal`.
+     * @param ctx the parse tree
+     * @return the visitor result
+     */
+    visitString_literal: (ctx: String_literalContext) => any;
+    /**
+     * Visit a parse tree produced by `YiniParser.number_literal`.
+     * @param ctx the parse tree
+     * @return the visitor result
+     */
+    visitNumber_literal: (ctx: Number_literalContext) => any;
+    /**
+     * Visit a parse tree produced by `YiniParser.boolean_literal`.
+     * @param ctx the parse tree
+     * @return the visitor result
+     */
+    visitBoolean_literal: (ctx: Boolean_literalContext) => any;
+    /**
+     * Visit a parse tree produced by `YiniParser.null_literal`.
+     * @param ctx the parse tree
+     * @return the visitor result
+     */
+    visitNull_literal: (ctx: Null_literalContext) => any;
+    /**
+     * Visit a parse tree produced by `YiniParser.list_literal`.
+     * @param ctx the parse tree
+     * @grammarRule OB NL* elements? NL* CB NL* | EMPTY_LIST NL*
+     * @return the visitor result
+     */
+    visitList_literal: (ctx: List_literalContext) => any;
+    /**
+     * Visit a parse tree produced by `YiniParser.elements`.
+     * @param ctx the parse tree
+     * @grammarRule value (NL* COMMA NL* value)* COMMA?
+     * @return the visitor result
+     */
+    visitElements: (ctx: ElementsContext) => any;
+    /**
+     * Visit a parse tree produced by `YiniParser.object_literal`.
+     * @param ctx the parse tree
+     * @grammarRule OC NL* object_members? NL* CC NL* | EMPTY_OBJECT NL*
+     * @return the visitor result
+     */
+    visitObject_literal: (ctx: Object_literalContext) => any;
+    /**
+     * Visit a parse tree produced by `YiniParser.object_members`.
+     * @param ctx the parse tree
+     * @grammarRule object_member (COMMA NL* object_member)* COMMA?
+     * @return the visitor result
+     */
+    visitObject_members: (ctx: Object_membersContext) => any;
+    /**
+     * Visit a parse tree produced by `YiniParser.object_member`.
+     * @param ctx the parse tree
+     * @grammarRule KEY WS? COLON NL* value
+     * @return the visitor result
+     */
+    visitObject_member: (ctx: Object_memberContext) => any;
+    /**
+     * Visit a parse tree produced by `YiniParser.colon_list_decl`.
+     * @param ctx the parse tree
+     * @grammarRule KEY WS? COLON (eol | WS+)* elements (eol | WS+)* eol
+     * @return the visitor result
+     */
+    visitColon_list_decl: (ctx: Colon_list_declContext) => any;
+    /**
+     * Visit a parse tree produced by `YiniParser.string_concat`.
+     * @param ctx the parse tree
+     * @return the visitor result
+     */
+    visitString_concat: (ctx: String_concatContext) => any;
+    /**
+     * Visit a parse tree produced by `YiniParser.bad_member`.
+     * @param ctx the parse tree
+     * @return the visitor result
+     */
+    visitBad_member: (ctx: Bad_memberContext) => any;
+    /**
+     * Visit a parse tree produced by `YiniParser.bad_meta_text`.
+     * @param ctx the parse tree
+     * @return the visitor result
+     */
+    visitBad_meta_text: (ctx: Bad_meta_textContext) => any;
+}