@markuplint/parser-utils 4.8.11 → 5.0.0-alpha.0

package/lib/parser.d.ts

@@ -1,5 +1,5 @@
 import type { Token, ChildToken, QuoteSet, ParseOptions, ParserOptions, Tokenized, ValueType } from './types.js';
-import type { EndTagType, MLASTDocument, MLASTParentNode, MLParser, ParserAuthoredElementNameDistinguishing, MLASTElement, MLASTElementCloseTag, MLASTToken, MLASTNodeTreeItem, MLASTTag, MLASTText, MLASTAttr, MLASTChildNode, MLASTSpreadAttr, ElementType, Walker, MLASTHTMLAttr, MLASTPreprocessorSpecificBlockConditionalType } from '@markuplint/ml-ast';
+import type { EndTagType, MLASTDocument, MLASTParentNode, MLParser, ParserAuthoredElementNameDistinguishing, MLASTElement, MLASTElementCloseTag, MLASTToken, MLASTNodeTreeItem, MLASTTag, MLASTText, MLASTAttr, MLASTChildNode, MLASTSpreadAttr, ElementType, Walker, MLASTHTMLAttr, MLASTBlockBehavior } from '@markuplint/ml-ast';
 import { AttrState } from './enums.js';
 import { ParserError } from './parser-error.js';
 /**
@@ -209,14 +209,13 @@ export declare abstract class Parser<Node extends {} = {}, State extends unknown
      * and recursively traversed child nodes. Handles ghost elements (empty raw),
      * self-closing tags, and nameless fragments (e.g., JSX `<>`).
      *
-     * @param token - The child token with the element's node name and namespace
+     * @param token - The child token with the element's node name; namespace is auto-detected from tag name and parent node
      * @param childNodes - The language-specific child AST nodes to traverse
      * @param options - Controls end tag creation, fragment handling, and property overrides
      * @returns An array of AST nodes including the start tag, optional end tag, and any sibling nodes
      */
     visitElement(token: ChildToken & {
         readonly nodeName: string;
-        readonly namespace: string;
     }, childNodes?: readonly Node[], options?: {
         readonly createEndTagToken?: (startTag: MLASTElement) => ChildToken | null;
         readonly namelessFragment?: boolean;
@@ -228,14 +227,14 @@ export declare abstract class Parser<Node extends {} = {}, State extends unknown
      *
      * @param token - The child token with the block's node name and fragment flag
      * @param childNodes - The language-specific child AST nodes to traverse
-     * @param conditionalType - The conditional type if this is a conditional block (e.g., "if", "else")
+     * @param blockBehavior - The block behavior if this is a control-flow block (e.g., "if", "each")
      * @param originBlockNode - The original language-specific block node for reference
      * @returns An array of AST nodes including the block node and any sibling nodes
      */
     visitPsBlock(token: ChildToken & {
         readonly nodeName: string;
         readonly isFragment: boolean;
-    }, childNodes?: readonly Node[], conditionalType?: MLASTPreprocessorSpecificBlockConditionalType, originBlockNode?: Node): readonly MLASTNodeTreeItem[];
+    }, childNodes?: readonly Node[], blockBehavior?: MLASTBlockBehavior | null, originBlockNode?: Node): readonly MLASTNodeTreeItem[];
     /**
      * Traverses a list of child nodes under the given parent, appending the resulting
      * child AST nodes to the parent and returning any sibling nodes that belong
@@ -285,18 +284,15 @@ export declare abstract class Parser<Node extends {} = {}, State extends unknown
         readonly namelessFragment?: boolean;
     }): (MLASTTag | MLASTText)[];
     /**
-     * Updates the position and depth properties of an AST node, recalculating
-     * end offsets, lines, and columns based on the new start values.
+     * Updates the position and depth properties of an AST node.
      *
      * @param node - The AST node whose location should be updated
      * @param props - The new position and depth values to apply (only provided values are changed)
      */
-    updateLocation(node: MLASTNodeTreeItem, props: Partial<Pick<MLASTNodeTreeItem, 'startOffset' | 'startLine' | 'startCol' | 'depth'>>): void;
+    updateLocation(node: MLASTNodeTreeItem, props: Partial<Pick<MLASTNodeTreeItem, 'offset' | 'line' | 'col' | 'depth'>>): void;
     /**
      * Set new raw code to target node.
      *
-     * Replace the raw code and update the start/end offset/line/column.
-     *
      * @param node target node
      * @param raw new raw code
      */
@@ -329,17 +325,17 @@ export declare abstract class Parser<Node extends {} = {}, State extends unknown
      */
     detectElementType(nodeName: string, defaultPattern?: ParserAuthoredElementNameDistinguishing): ElementType;
     /**
-     * Creates a new MLASTToken with a generated UUID and computed end position.
+     * Creates a new MLASTToken with a generated UUID.
      * Accepts either a Token object or a raw string with explicit start coordinates.
      *
      * @param token - A Token object or raw string to create the AST token from
-     * @param startOffset - The byte offset where the token starts (required when token is a string)
-     * @param startLine - The line number where the token starts (required when token is a string)
-     * @param startCol - The column number where the token starts (required when token is a string)
-     * @returns A fully populated AST token with UUID, start/end positions, and raw content
+     * @param offset - The zero-based byte offset where the token starts (required when token is a string)
+     * @param line - The one-based line number where the token starts (required when token is a string)
+     * @param col - The one-based column number where the token starts (required when token is a string)
+     * @returns An AST token with UUID, start position, and raw content
      */
     createToken(token: Token): MLASTToken;
-    createToken(token: string, startOffset: number, startLine: number, startCol: number): MLASTToken;
+    createToken(token: string, offset: number, line: number, col: number): MLASTToken;
     /**
      * Extracts a Token from the current raw code at the given byte offset range,
      * computing the line and column from the source position.