yini-parser 1.4.3 → 1.6.0

package/dist/core/astBuilder.d.ts

@@ -1,10 +1,7 @@
-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 { AnnotationContext, AssignmentContext, Bad_memberContext, Bad_meta_textContext, Boolean_literalContext, Concat_expressionContext, Concat_operandContext, Concat_tailContext, DirectiveContext, Disabled_line_stmtContext, ElementsContext, EolContext, Full_line_comment_stmtContext, Invalid_section_stmtContext, List_literalContext, MemberContext, Meta_stmtContext, Null_literalContext, Number_literalContext, Object_literalContext, Object_member_separatorContext, Object_memberContext, Object_membersContext, PrologContext, Scalar_valueContext, StmtContext, String_literalContext, Terminal_stmtContext, Terminal_triviaContext, ValueContext, Yini_directiveContext, Yini_mode_declarationContext, 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`.
@@ -12,13 +9,14 @@ import { IParseCoreOptions, IYiniAST, TSourceType } from './internalTypes';
  * @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> {
+export default class ASTBuilder extends YiniParserVisitor<any> {
     private errorHandler;
     private readonly options;
     private readonly isStrict;
     private readonly onDuplicateKey;
     private ast;
     private sectionStack;
+    private ignoredSectionLevel;
     private meta_hasYiniMarker;
     private _numOfMembers;
     private meta_maxLevel;
@@ -28,14 +26,19 @@ export default class ASTBuilder<Result> extends YiniParserVisitor<Result> {
      * @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 validateStrictTopLevelStructure;
     private hasDefinedSectionTitle;
     private setDefineSectionTitle;
-    private extractStringParts;
     private extractStringKindAndValue;
     /** Attach a section to the stack respecting up/down moves (Spec 5.3). :contentReference[oaicite:7]{index=7} */
     private attachSection;
+    private isIgnoringDuplicateSection;
+    private shouldSkipSectionAtLevel;
     /** Insert a key/value into current section (duplicate handling per options). */
     private putMember;
+    private stringifyConcatOperand;
+    private parseStringToken;
+    private hasTrailingComma;
     buildAST(ctx: YiniContext): IYiniAST;
     /**
      * Visit a parse tree produced by `YiniParser.yini`.
@@ -55,13 +58,37 @@ export default class ASTBuilder<Result> extends YiniParserVisitor<Result> {
      * @return the visitor result
      */
     visitTerminal_stmt: (ctx: Terminal_stmtContext) => any;
+    /**
+     * Visit a parse tree produced by `YiniParser.terminal_trivia`.
+     * @param ctx the parse tree
+     * @return the visitor result
+     */
+    visitTerminal_trivia: (ctx: Terminal_triviaContext) => any;
+    /**
+     * Visit a parse tree produced by `YiniParser.stmt`.
+     * @param ctx the parse tree
+     * @return the visitor result
+     */
+    /**
+     * Visit a parse tree produced by `YiniParser.full_line_comment_stmt`.
+     * @param ctx the parse tree
+     * @return the visitor result
+     */
+    visitFull_line_comment_stmt: (_ctx: Full_line_comment_stmtContext) => any;
+    /**
+     * Visit a parse tree produced by `YiniParser.disabled_line_stmt`.
+     * @param ctx the parse tree
+     * @return the visitor result
+     */
+    visitDisabled_line_stmt: (_ctx: Disabled_line_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
+     * @grammarRule eol | full_line_comment_stmt | disabled_line_stmt | SECTION_HEAD | invalid_section_stmt | assignment | meta_stmt | bad_member
      * @return the visitor result
      */
     visitStmt: (ctx: StmtContext) => any;
+    visitInvalid_section_stmt: (ctx: Invalid_section_stmtContext) => any;
     /**
      * Visit a parse tree produced by `YiniParser.meta_stmt`.
      * @param ctx the parse tree
@@ -107,10 +134,47 @@ export default class ASTBuilder<Result> extends YiniParserVisitor<Result> {
      */
     visitValue: (ctx: ValueContext) => any;
     /**
-     * Visit a parse tree produced by `YiniParser.string_literal`.
+     * Visit a parse tree produced by `YiniParser.scalar_value`.
+     * @param ctx the parse tree
+     * @return the visitor result
+     */
+    visitScalar_value: (ctx: Scalar_valueContext) => any;
+    /**
+     * Visit a parse tree produced by `YiniParser.concat_expression`.
+     *
+     * Grammar:
+     *   concat_expression : STRING concat_tail+ ;
+     *
+     * Spec:
+     *   - Concatenation must begin with a string literal.
+     *   - In strict mode, every operand must be a string literal.
+     *   - In lenient mode, later operands may be string, number, boolean, or null.
+     *   - YINI does not define numeric addition.
+     *
+     * Examples:
+     * "Port: " + 8080       // lenient valid
+     * "1" + 2 + 3           // lenient valid
+     * 8080 + " is the port" // invalid: must begin with string literal
+     * 1 + 2 + "3"           // invalid: must begin with string literal
+     * 1 + 2 + 3             // invalid: YINI does not define numeric addition
+     */
+    visitConcat_expression: (ctx: Concat_expressionContext) => any;
+    /**
+     * Visit a parse tree produced by `YiniParser.concat_tail`.
      * @param ctx the parse tree
      * @return the visitor result
      */
+    visitConcat_tail: (ctx: Concat_tailContext) => any;
+    /**
+     * Visit a parse tree produced by `YiniParser.concat_operand`.
+     *
+     * @note Must use token accessors, not literal visitors.
+     *       Use STRING() instead of string_literal(), etc.
+     *
+     * @param ctx the parse tree
+     * @return the visitor result
+     */
+    visitConcat_operand: (ctx: Concat_operandContext) => any;
     visitString_literal: (ctx: String_literalContext) => any;
     /**
      * Visit a parse tree produced by `YiniParser.number_literal`.
@@ -156,28 +220,40 @@ export default class ASTBuilder<Result> extends YiniParserVisitor<Result> {
      * @param ctx the parse tree
      * @grammarRule object_member (COMMA NL* object_member)* COMMA?
      * @return the visitor result
+     *
+     * @note
+     * SPEC says:
+     * - Lenient: first wins + warning
+     * - Strict: error
+     *
+     * NEVER silently overwrite.
      */
     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
+     * @grammarRule KEY object_member_separator NL* value
+     * @return the object member key and value
      */
     visitObject_member: (ctx: Object_memberContext) => any;
     /**
-     * Visit a parse tree produced by `YiniParser.colon_list_decl`.
+     * Visit a parse tree produced by `YiniParser.object_member_separator`.
      * @param ctx the parse tree
-     * @grammarRule KEY WS? COLON (eol | WS+)* elements (eol | WS+)* eol
-     * @return the visitor result
+     * @grammarRule COLON | EQ
+     * @return ':' or '='
      */
-    visitColon_list_decl: (ctx: Colon_list_declContext) => any;
+    visitObject_member_separator: (ctx: Object_member_separatorContext) => any;
     /**
-     * Visit a parse tree produced by `YiniParser.string_concat`.
-     * @param ctx the parse tree
-     * @return the visitor result
+     *
+     * @note
+     * @yini strict  + active lenient  => error
+     * @yini lenient + active strict   => warning
+     * @yini strict  + active strict   => ok
+     * @yini lenient + active lenient  => ok
+     * @yini         + any mode        => ok
      */
-    visitString_concat: (ctx: String_concatContext) => any;
+    visitYini_directive: (ctx: Yini_directiveContext) => any;
+    visitYini_mode_declaration: (ctx: Yini_mode_declarationContext | undefined) => any;
     /**
      * Visit a parse tree produced by `YiniParser.bad_member`.
      * @param ctx the parse tree