yini-parser 1.0.2-beta → 1.2.0-beta

package/dist/YINI.js

@@ -1,114 +1,198 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-var _a;
 Object.defineProperty(exports, "__esModule", { value: true });
-const fs_1 = __importDefault(require("fs"));
 const env_1 = require("./config/env");
-const parseEntry_1 = require("./parseEntry");
-const pathAndFileName_1 = require("./utils/pathAndFileName");
+const errorDataHandler_1 = require("./core/errorDataHandler");
+const normalizeOptions_1 = require("./core/options/normalizeOptions");
+const runtime_1 = require("./core/runtime");
 const print_1 = require("./utils/print");
+const DEFAULT_TAB_SIZE = 4; // De facto "modern default" (even though traditionally/historically it's 8).
+// let _runtimeInfo: IRuntimeInfo = {
+//     sourceType: 'Inline',
+//     fileName: undefined,
+//     fileByteSize: null,
+//     lineCount: null,
+//     timeIoMs: null,
+//     preferredBailSensitivity: null,
+//     sha256: null,
+// }
 /**
  * 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 {
-}
-_a = 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';
-    }
-    let level = 0;
-    if (bailSensitivity === 'auto') {
-        if (!strictMode)
-            level = 0;
-        if (strictMode)
-            level = 1;
+    /**
+     * @returns The number of spaces per tab character used in error messages.
+     */
+    static getTabSize() {
+        return this.g_tabSize;
     }
-    else {
-        level = bailSensitivity;
+    /**
+     * 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.');
+            throw new RangeError(`Tab size ${spaces} is out of range (1–32).`);
+        }
+        this.g_tabSize = spaces;
     }
-    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 parse(yiniContent, arg2, // strictMode | options
+    failLevel = 'auto', includeMetadata = false) {
+        (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.',
+        //     )
+        // }
+        // const mode: TParserMode = inferModeFromArgs(arg2)
+        // const defaultOptions = getDefaultOptions(mode)
+        // // Normalize to a fully-required options object.
+        // let userOpts: Required<IAllUserOptions>
+        // // Required, makes all properties in T required, no undefined.
+        // if (isOptionsObjectForm(arg2)) {
+        //     userOpts = {
+        //         ...defaultOptions, // Sets the default options.
+        //         ...arg2,
+        //     }
+        // } else {
+        //     // Positional form.
+        //     userOpts = {
+        //         ...defaultOptions, // Sets the default options.
+        //         strictMode:
+        //             (arg2 as boolean | undefined) ?? defaultOptions.strictMode,
+        //         failLevel,
+        //         includeMetadata,
+        //     }
+        // }
+        // if (userOpts.includeMetadata && _runtimeInfo.sourceType === 'Inline') {
+        //     const lineCount = yiniContent.split(/\r?\n/).length // Counts the lines.
+        //     const sha256 = 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: TBailSensitivityLevel = mapFailLevelToBail(
+        //     userOpts.strictMode,
+        //     userOpts.failLevel,
+        // )
+        ////////////////
+        // const coreOpts: IParseCoreOptions = toCoreOptions(level, userOpts)
+        (0, print_1.debugPrint)();
+        (0, print_1.debugPrint)('==== Call doParse(..) in runtime ==========================');
+        // const result = _parseMain(yiniContent, coreOpts, _runtimeInfo)
+        const runtime = new runtime_1.YiniRuntime('Inline');
+        const result = (0, normalizeOptions_1.isOptionsObjectForm)(arg2)
+            ? runtime.doParse(yiniContent, arg2) // Overload #2: (content, options)
+            : runtime.doParse(
+            // Overload #1: (content, strict?, failLevel?, includeMeta?)
+            yiniContent, arg2, failLevel, includeMetadata);
+        (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;
     }
-    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;
+    // --- 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 = 'auto', includeMetadata = false) {
+        (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.',
+        //     )
+        // }
+        // const mode: TParserMode = inferModeFromArgs(arg2)
+        // const defaultOptions = getDefaultOptions(mode)
+        // // Normalize to a fully-required options object.
+        // let userOpts: Required<IAllUserOptions>
+        // // Required, makes all properties in T required, no undefined.
+        // if (isOptionsObjectForm(arg2)) {
+        //     // Options-object Form.
+        //     userOpts = {
+        //         ...defaultOptions, // Sets the default options.
+        //         ...arg2,
+        //     }
+        // } else {
+        //     // Positional form.
+        //     userOpts = {
+        //         ...defaultOptions, // Sets the default options.
+        //         strictMode:
+        //             (arg2 as boolean | undefined) ?? defaultOptions.strictMode,
+        //         failLevel,
+        //         includeMetadata,
+        //     }
+        // }
+        // if (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.readFileSync(filePath) // Raw buffer for size.
+        // const fileByteSize = rawBuffer.byteLength // Byte size in UTF-8.
+        // let content = rawBuffer.toString('utf8')
+        // const timeEndMs = 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).toFixed(3)
+        //     _runtimeInfo.preferredBailSensitivity = userOpts.failLevel
+        //     _runtimeInfo.sha256 = computeSha256(content) // NOTE: Compute BEFORE any possible tampering of content.
+        // }
+        // let hasNoNewlineAtEOF = false
+        // if (!content.endsWith('\n')) {
+        //     content += '\n'
+        //     hasNoNewlineAtEOF = true
+        // }
+        (0, print_1.debugPrint)();
+        (0, print_1.debugPrint)('==== Call doParseFile(..) in runtime ==========================');
+        // const result = _parseMain(yiniContent, coreOpts, _runtimeInfo)
+        const runtime = new runtime_1.YiniRuntime('File');
+        const result = (0, normalizeOptions_1.isOptionsObjectForm)(arg2)
+            ? runtime.doParseFile(filePath, arg2) // Overload #2: (content, options)
+            : runtime.doParseFile(
+            // Overload #1: (content, strict?, failLevel?, includeMeta?)
+            filePath, arg2, failLevel, includeMetadata);
+        (0, print_1.debugPrint)('==== End call parse ==========================\n');
+        return result;
     }
-    _a.filePath = filePath;
-    const result = _a.parse(content, strictMode, bailSensitivity, 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;
-};
+}
+// @todo In future move/change this to not be a global and suffer from possible race conditions, possibly move this into YiniRuntime class.
+YINI.g_tabSize = DEFAULT_TAB_SIZE; // Global tab size used in error messages.
 exports.default = YINI;
+//# sourceMappingURL=YINI.js.map

package/dist/YINI.js.map

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

package/dist/config/env.js

@@ -60,3 +60,4 @@ const isDebug = () => {
     return false;
 };
 exports.isDebug = isDebug;
+//# sourceMappingURL=env.js.map

package/dist/config/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../../src/config/env.ts"],"names":[],"mappings":";;;AAeA,MAAM,YAAY,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,YAAY,CAAa,CAAA;AAqE9D,oCAAY;AApErB,MAAM,WAAW,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,YAAY,CAAY,CAAA;AAoE7C,kCAAW;AAlElC,kCAAkC;AAClC,8EAA8E;AAC9E,4EAA4E;AAE5E,2CAA2C;AAC3C,IAAI;AAEJ,mDAAmD;AAEnD,gIAAgI;AACzH,MAAM,QAAQ,GAAG,GAAY,EAAE,CAAC,YAAY,KAAK,aAAa,CAAA;AAAxD,QAAA,QAAQ,YAAgD;AAErE,+HAA+H;AACxH,MAAM,SAAS,GAAG,GAAY,EAAE,CAAC,YAAY,KAAK,YAAY,CAAA;AAAxD,QAAA,SAAS,aAA+C;AAErE,6GAA6G;AACtG,MAAM,SAAS,GAAG,GAAY,EAAE,CAAC,YAAY,KAAK,MAAM,CAAA;AAAlD,QAAA,SAAS,aAAyC;AAE/D;;;;GAIG;AACI,MAAM,KAAK,GAAG,GAAY,EAAE;IAC/B,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,CAAA;IAE/B,oEAAoE;IACpE,uDAAuD;IACvD,kCAAkC;IAClC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3B,MAAM,GAAG,GAAW,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;QACzC,IACI,GAAG,CAAC,WAAW,EAAE,KAAK,SAAS;YAC/B,GAAG,CAAC,WAAW,EAAE,KAAK,YAAY,EACpC,CAAC;YACC,OAAO,IAAI,CAAA;QACf,CAAC;IACL,CAAC;IAED,OAAO,KAAK,CAAA;AAChB,CAAC,CAAA;AAjBY,QAAA,KAAK,SAiBjB;AAED;;;;GAIG;AACI,MAAM,OAAO,GAAG,GAAY,EAAE;IACjC,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,CAAA;IAE/B,oEAAoE;IACpE,uDAAuD;IACvD,kCAAkC;IAClC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3B,MAAM,GAAG,GAAW,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;QACzC,IACI,GAAG,CAAC,WAAW,EAAE,KAAK,WAAW;YACjC,GAAG,CAAC,WAAW,EAAE,KAAK,cAAc,EACtC,CAAC;YACC,OAAO,IAAI,CAAA;QACf,CAAC;IACL,CAAC;IAED,OAAO,KAAK,CAAA;AAChB,CAAC,CAAA;AAjBY,QAAA,OAAO,WAiBnB"}

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/generated/YiniParser.js';
+import YiniParserVisitor from '../grammar/generated/YiniParserVisitor';
+import { ErrorDataHandler } from './errorDataHandler';
+import { IParseCoreOptions, IYiniAST, TSourceType } from './internalTypes';
+/** 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;
+}