@markuplint/pug-parser 5.0.0-rc.2 → 5.0.0-rc.5

package/CHANGELOG.md

@@ -3,6 +3,21 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [5.0.0-rc.5](https://github.com/markuplint/markuplint/compare/v5.0.0-rc.4...v5.0.0-rc.5) (2026-08-28)
+
+### Features
+
+- **markdown-parser,pug-parser:** force fragment parsing for embedded HTML ([57c4172](https://github.com/markuplint/markuplint/commit/57c4172d5a68adb7e20a4f4e4d8dbe802983e3ca)), closes [#3844](https://github.com/markuplint/markuplint/issues/3844)
+- **markdown-parser,pug-parser:** forward embedded HTML parseErrors to outer document ([9ec7988](https://github.com/markuplint/markuplint/commit/9ec79882840cbedd76c5b8f774ff10c876d2c858)), closes [#3844](https://github.com/markuplint/markuplint/issues/3844)
+
+# [5.0.0-rc.4](https://github.com/markuplint/markuplint/compare/v5.0.0-rc.3...v5.0.0-rc.4) (2026-04-19)
+
+**Note:** Version bump only for package @markuplint/pug-parser
+
+# [5.0.0-rc.3](https://github.com/markuplint/markuplint/compare/v5.0.0-rc.2...v5.0.0-rc.3) (2026-04-19)
+
+**Note:** Version bump only for package @markuplint/pug-parser
+
 # [5.0.0-rc.2](https://github.com/markuplint/markuplint/compare/v5.0.0-rc.1...v5.0.0-rc.2) (2026-04-15)
 
 **Note:** Version bump only for package @markuplint/pug-parser

package/lib/index.d.ts

@@ -3,5 +3,6 @@
  * Pug template parser for markuplint. Provides a parser that transforms Pug (formerly Jade)
  * template syntax into markuplint's AST, handling indentation-based nesting, tag interpolation,
  * inline HTML, Pug attributes, mixins, conditionals, and other Pug-specific constructs.
+ * The upstream pug-lexer and pug-parser dependencies implement the Pug 3 syntax specification.
  */
 export { parser } from './parser.js';

package/lib/index.js

@@ -3,5 +3,6 @@
  * Pug template parser for markuplint. Provides a parser that transforms Pug (formerly Jade)
  * template syntax into markuplint's AST, handling indentation-based nesting, tag interpolation,
  * inline HTML, Pug attributes, mixins, conditionals, and other Pug-specific constructs.
+ * The upstream pug-lexer and pug-parser dependencies implement the Pug 3 syntax specification.
  */
 export { parser } from './parser.js';

package/lib/parser.d.ts

@@ -17,30 +17,8 @@ declare class PugParser extends Parser<ASTNode> {
         isFragment: boolean;
     };
     parseError(error: any): ParserError;
-    /**
-     * Converts a Pug AST node into markuplint node tree items.
-     * Handles Doctype, Text (including inline HTML and tag interpolation),
-     * Comment, BlockComment, Tag (with attributes and child blocks),
-     * and other Pug-specific constructs (mixins, conditionals, etc.)
-     * which are mapped to preprocessor-specific blocks.
-     *
-     * @param originNode - The Pug AST node to convert
-     * @param parentNode - The parent node in the markuplint tree, or null for root nodes
-     * @param depth - The nesting depth of the node
-     * @returns An array of markuplint node tree items
-     */
     nodeize(originNode: ASTNode, parentNode: MLASTParentNode | null, depth: number): readonly MLASTNodeTreeItem[];
     afterFlattenNodes(nodeList: readonly MLASTNodeTreeItem[]): readonly MLASTNodeTreeItem[];
-    /**
-     * Visits an element token for Pug, constructing a start tag node with
-     * pre-parsed attributes (including `&attributes` spread syntax) and
-     * visiting child nodes within the Pug block.
-     *
-     * @param token - The child token with tag metadata
-     * @param childNodes - The child Pug AST nodes within the tag's block
-     * @param options - Options containing pre-parsed attribute overrides
-     * @returns An array of markuplint node tree items for the element and its children
-     */
     visitElement(token: ChildToken & {
         readonly nodeName: string;
         readonly isFragment: false;
@@ -49,15 +27,12 @@ declare class PugParser extends Parser<ASTNode> {
             readonly attributes: readonly MLASTAttr[];
         };
     }): MLASTNodeTreeItem[];
-    visitSpreadAttr(): null;
     /**
-     * Visits an attribute token, handling Pug-specific syntax including
-     * shorthand `#id` and `.class` notation, quoted attribute names,
-     * unescaped attribute names (trailing `!`), and JavaScript expression values.
-     *
-     * @param token - The token representing the attribute
-     * @returns The parsed attribute node with Pug-specific metadata
+     * Intentionally a no-op: `&attributes` spread syntax is converted inline
+     * in the `Tag` case of `nodeize()`, so the base-class spread attribute
+     * visitor must not produce a node.
      */
+    visitSpreadAttr(): null;
     visitAttr(token: Token): MLASTAttr;
 }
 export declare const parser: PugParser;

package/lib/parser.js

@@ -1,11 +1,6 @@
 import { HtmlParser } from '@markuplint/html-parser';
 import { ParserError, Parser, AttrState, scriptParser, getNamespace } from '@markuplint/parser-utils';
 import { pugParse } from './pug-parser/index.js';
-/**
- * Internal HTML parser used for inline HTML content within Pug templates.
- * Extends the standard HTML parser to handle Pug tag interpolation syntax (`#[...]`),
- * treating interpolated tags as preprocessor-specific blocks.
- */
 class HtmlInPugParser extends HtmlParser {
     constructor() {
         super({
@@ -35,6 +30,7 @@ class HtmlInPugParser extends HtmlParser {
 class PugParser extends Parser {
     constructor() {
         super({
+            // Pug expresses nesting through indentation and never emits explicit closing tags.
             endTagType: 'never',
         });
     }
@@ -56,18 +52,6 @@ class PugParser extends Parser {
         }
         return super.parseError(error);
     }
-    /**
-     * Converts a Pug AST node into markuplint node tree items.
-     * Handles Doctype, Text (including inline HTML and tag interpolation),
-     * Comment, BlockComment, Tag (with attributes and child blocks),
-     * and other Pug-specific constructs (mixins, conditionals, etc.)
-     * which are mapped to preprocessor-specific blocks.
-     *
-     * @param originNode - The Pug AST node to convert
-     * @param parentNode - The parent node in the markuplint tree, or null for root nodes
-     * @param depth - The nesting depth of the node
-     * @returns An array of markuplint node tree items
-     */
     nodeize(
     // eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
     originNode, parentNode, depth) {
@@ -79,6 +63,8 @@ class PugParser extends Parser {
                     depth,
                     parentNode,
                     name: originNode.raw ?? '',
+                    // Pug doctypes use shorthand keywords (e.g. `doctype html`),
+                    // so no public/system IDs exist in the source.
                     publicId: '',
                     systemId: '',
                 });
@@ -99,7 +85,17 @@ class PugParser extends Parser {
                     offsetLine: originNode.line,
                     offsetColumn: originNode.column ?? parentNode?.col,
                     depth,
+                    // HTML emitted by a single Pug line is always a partial —
+                    // Pug itself owns the document boundary (`doctype html`,
+                    // `html(...)`, etc.). Force fragment parsing so parse5
+                    // doesn't fire `missing-doctype` on every inline HTML
+                    // chunk.
+                    documentMode: 'fragment',
                 });
+                // Surface tokenizer-level parse errors from the embedded
+                // HtmlInPugParser so users who opt in via
+                // `severity.parseError` see them on the outer Pug document.
+                this.accumulateParseErrors(htmlDoc.parseErrors);
                 const newNodeList = [];
                 for (const node of htmlDoc.nodeList) {
                     if (node.nodeName === '#ps:tag-interpolation') {
@@ -147,6 +143,10 @@ class PugParser extends Parser {
                         attr.offset === attr.endOffset &&
                         typeof attr.val === 'string') {
                         /**
+                         * pug-parser reports shorthand `#id`/`.class` attributes with a
+                         * zero-width location span (offset === endOffset), so the end
+                         * offset must be recalculated from the value length.
+                         *
                          * #value =>
                          * {
                          *   name: 'id',
@@ -221,16 +221,6 @@ class PugParser extends Parser {
             exposeWhiteSpace: false,
         });
     }
-    /**
-     * Visits an element token for Pug, constructing a start tag node with
-     * pre-parsed attributes (including `&attributes` spread syntax) and
-     * visiting child nodes within the Pug block.
-     *
-     * @param token - The child token with tag metadata
-     * @param childNodes - The child Pug AST nodes within the tag's block
-     * @param options - Options containing pre-parsed attribute overrides
-     * @returns An array of markuplint node tree items for the element and its children
-     */
     visitElement(token, 
     // eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
     childNodes, options) {
@@ -253,17 +243,14 @@ class PugParser extends Parser {
         const siblings = this.visitChildren(childNodes, startTag);
         return [startTag, ...siblings];
     }
+    /**
+     * Intentionally a no-op: `&attributes` spread syntax is converted inline
+     * in the `Tag` case of `nodeize()`, so the base-class spread attribute
+     * visitor must not produce a node.
+     */
     visitSpreadAttr() {
         return null;
     }
-    /**
-     * Visits an attribute token, handling Pug-specific syntax including
-     * shorthand `#id` and `.class` notation, quoted attribute names,
-     * unescaped attribute names (trailing `!`), and JavaScript expression values.
-     *
-     * @param token - The token representing the attribute
-     * @returns The parsed attribute node with Pug-specific metadata
-     */
     visitAttr(token) {
         if (token.raw[0] === '#' || token.raw[0] === '.') {
             const attr = super.visitAttr(token, {
@@ -293,11 +280,21 @@ class PugParser extends Parser {
         if (attr.name.raw.toLowerCase() === 'class') {
             this.updateAttr(attr, { isDuplicatable: true });
         }
+        /**
+         * Pug allows attribute names to be wrapped in quotes (e.g. `'data-value'="foo"`).
+         *
+         * @see https://pugjs.org/language/attributes.html#quoted-attributes
+         */
         if (attr.name.raw.startsWith("'") && attr.name.raw.endsWith("'")) {
             this.updateAttr(attr, {
                 potentialName: attr.name.raw.slice(1, -1),
             });
         }
+        /**
+         * A trailing `!` on the attribute name marks the value as unescaped.
+         *
+         * @see https://pugjs.org/language/attributes.html#unescaped-attributes
+         */
         if (attr.name.raw.endsWith('!')) {
             this.updateAttr(attr, {
                 potentialName: attr.name.raw.slice(0, -1),

package/lib/pug-parser/index.d.ts

@@ -1,11 +1,2 @@
 import type { ASTBlock } from '../types.js';
-/**
- * Parses a Pug template string into an optimized AST with computed offsets
- * and location data by lexing with pug-lexer, parsing with pug-parser,
- * and then enriching each node with raw source, offsets, and end positions.
- *
- * @param pug - The raw Pug template source code
- * @param useOffset - Whether to strip indent/outdent tokens (used when parsing at a non-zero offset)
- * @returns The optimized Pug AST block containing enriched nodes
- */
 export declare function pugParse(pug: string, useOffset?: boolean): ASTBlock;

package/lib/pug-parser/index.js

@@ -3,19 +3,13 @@ import lexer from 'pug-lexer';
 import parser from 'pug-parser';
 import { getOffsetFromLineAndCol } from '../utils/get-offset-from-line-and-col.js';
 import { getOffsetsFromCode } from '@markuplint/parser-utils/location';
-/**
- * Parses a Pug template string into an optimized AST with computed offsets
- * and location data by lexing with pug-lexer, parsing with pug-parser,
- * and then enriching each node with raw source, offsets, and end positions.
- *
- * @param pug - The raw Pug template source code
- * @param useOffset - Whether to strip indent/outdent tokens (used when parsing at a non-zero offset)
- * @returns The optimized Pug AST block containing enriched nodes
- */
 export function pugParse(pug, useOffset = false) {
     let lexOrigin = lexer(pug);
     /**
-     * Exclude indent and outdent tokens when offset is received to avoid indentation errors
+     * Exclude indent and outdent tokens when offset is received to avoid indentation errors:
+     * a sub-template parsed at a non-zero offset (e.g. tag interpolation content) inherits
+     * its indentation context from the parent template, so its own indent/outdent tokens
+     * are spurious.
      */
     if (useOffset) {
         const newLexOrigin = [];
@@ -27,18 +21,13 @@ export function pugParse(pug, useOffset = false) {
         }
         lexOrigin = newLexOrigin;
     }
+    // pug-parser mutates the token array it consumes, so clone the tokens first to keep
+    // an independent reference for correlating AST nodes with lexer tokens afterwards.
     const lex = structuredClone(lexOrigin);
     const originAst = parser(lexOrigin);
     const ast = optimizeAST(originAst, lex, pug);
     return ast;
 }
-/**
- * Computes the cumulative character offset at the end of each line
- * in the given source string.
- *
- * @param pug - The raw Pug template source code
- * @returns An array where each index corresponds to a line and the value is the cumulative offset
- */
 function getOffsetsFromLines(pug) {
     const lines = pug.split(/\n/);
     let chars = 0;
@@ -48,14 +37,6 @@ function getOffsetsFromLines(pug) {
     });
     return result;
 }
-/**
- * Merges consecutive Text nodes into a single Text node, combining
- * their raw source and extending the end location of the first node.
- *
- * @param nodes - The array of AST nodes to process
- * @param pug - The raw Pug template source code
- * @returns A new array with adjacent Text nodes merged together
- */
 function mergeTextNode(
 // eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
 nodes, pug) {
@@ -73,16 +54,6 @@ nodes, pug) {
     }
     return baseNodes;
 }
-/**
- * Transforms the raw pug-parser AST into an optimized AST by computing
- * accurate source offsets, raw text slices, and end positions for each node.
- * Recursively processes child blocks and merges adjacent text nodes.
- *
- * @param originalAST - The raw AST block from pug-parser, or null
- * @param tokens - The lexed token list from pug-lexer
- * @param pug - The raw Pug template source code
- * @returns The optimized AST block with enriched location data
- */
 function optimizeAST(
 // eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
 originalAST, 
@@ -500,17 +471,6 @@ tokens, pug) {
         line: originalAST.line,
     };
 }
-/**
- * Recursively processes conditional node chains (`else if` / `else`) in the Pug AST,
- * computing location data for each alternate branch.
- *
- * @param node - The Pug conditional AST node with potential alternate branches
- * @param tokens - The lexed token list from pug-lexer
- * @param pug - The raw Pug template source code
- * @param offsets - Precomputed line offset array
- * @param depth - The current recursion depth for tracking nested conditionals
- * @returns An array of optimized conditional nodes for the alternate branches
- */
 function optimizeASTOfConditionalNode(
 // eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
 node, 
@@ -588,17 +548,6 @@ tokens, pug, offsets, depth) {
     }
     return altNodes;
 }
-/**
- * Finds the matching lexer token for a node at the given position and returns
- * its end location and length.
- *
- * @param offset - The character offset of the node's start
- * @param line - The 1-based line number of the node
- * @param column - The 1-based column number of the node
- * @param tokens - The lexed token list from pug-lexer
- * @param tokenType - Optional token type(s) to filter by
- * @returns An object with endLine, endColumn, endOffset, and length
- */
 function getLocationFromToken(offset, line, column, 
 // eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
 tokens, tokenType) {
@@ -623,17 +572,6 @@ tokens, tokenType) {
         length,
     };
 }
-/**
- * Extracts and enriches attribute data from the original Pug AST attributes
- * by correlating each attribute with its corresponding lexer token to compute
- * accurate offsets and raw source slices.
- *
- * @param originalAttrs - The original attribute list from the Pug AST
- * @param tokens - The lexed token list from pug-lexer
- * @param offsets - Precomputed line offset array
- * @param pug - The raw Pug template source code
- * @returns An array of enriched attribute objects with computed location data
- */
 function getAttrs(
 // eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
 originalAttrs, 
@@ -671,25 +609,11 @@ tokens, offsets, pug) {
     }
     return attrs;
 }
-/**
- * Determines the end position of a tag node including its attributes
- * by scanning lexer tokens that follow the tag's position and precede
- * non-attribute tokens.
- *
- * @param nodeName - The tag name of the element
- * @param offset - The character offset of the tag's start
- * @param line - The 1-based line number of the tag
- * @param column - The 1-based column number of the tag
- * @param tokens - The lexed token list from pug-lexer
- * @param offsets - Precomputed line offset array
- * @returns An object with endOffset, endLine, and endColumn
- */
 function getEndAttributeLocation(nodeName, offset, line, column, 
 // eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
 tokens, offsets) {
     let beforeNewlineToken = null;
     for (const token of tokens) {
-        // Searching token after the tag node.
         if (beforeNewlineToken &&
             (token.loc.start.line > line || (token.loc.start.line >= line && token.loc.start.column > column)) &&
             token.type !== 'attribute' &&
@@ -713,15 +637,6 @@ tokens, offsets) {
         endColumn: column + nodeName.length,
     };
 }
-/**
- * Detects whether a Text node is part of a pipeless text block (indented
- * text content below a tag) and returns its full span if so.
- *
- * @param node - The Pug Text AST node to check
- * @param pug - The raw Pug template source code
- * @param tokens - The lexed token list from pug-lexer
- * @returns Location data for the pipeless text span, or null if not pipeless text
- */
 function getPipelessText(
 // eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
 node, pug, 
@@ -758,19 +673,6 @@ tokens) {
     }
     return null;
 }
-/**
- * Extracts raw text content and computes accurate end locations for a Text node
- * by walking through lexer tokens from the node's start position. Handles
- * multi-line text, piped text detection, and indentation tracking.
- *
- * @param val - The text value from the Pug AST node
- * @param offset - The character offset where the text starts
- * @param line - The 1-based start line number
- * @param column - The 1-based start column number
- * @param tokens - The lexed token list from pug-lexer
- * @param pug - The raw Pug template source code
- * @returns An array of ASTText nodes with computed location data
- */
 function getRawTextAndLocationEnd(val, offset, line, column, 
 // eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
 tokens, pug) {

package/lib/types.d.ts

@@ -1,7 +1,3 @@
-/**
- * Additional location and raw source data that is computed during AST optimization
- * and appended to the original Pug AST node types.
- */
 export type AdditionalASTData = {
     raw: string;
     offset: number;
@@ -9,84 +5,59 @@ export type AdditionalASTData = {
     endLine: number;
     endColumn: number;
 };
-/** Union of all optimized Pug AST node types that the parser can produce. */
 export type ASTNode = ASTDoctype | ASTComment | ASTBlockComment | ASTText | ASTTag | ASTInterpolatedTag | ASTCode | ASTConditional | ASTCase | ASTWhen | ASTWhile | ASTEach | ASTMixin | ASTMixinBlock | ASTYieldBlock | ASTFileReference | ASTInclude | ASTRawInclude | ASTIncludeFilter | ASTExtends | ASTNamedBlock | ASTFilter;
-/** Represents a Pug block containing an ordered list of child nodes. */
 export type ASTBlock = {
     type: 'Block';
     nodes: readonly ASTNode[];
     line: number;
 };
-/** An optimized Pug doctype node with computed location data. */
 export type ASTDoctype = PugAST.Doctype & AdditionalASTData;
-/** An optimized Pug single-line comment node with computed location data. */
 export type ASTComment = PugAST.Comments.Comment & AdditionalASTData;
-/** An optimized Pug block comment node with computed location data and an optimized child block. */
 export type ASTBlockComment = Omit<PugAST.Comments.BlockComment, 'block'> & {
     block: ASTBlock | null;
 } & AdditionalASTData;
-/** An optimized Pug text node with computed location data. */
 export type ASTText = PugAST.Text & AdditionalASTData;
-/** An optimized Pug tag node with computed attributes and child block. */
 export type ASTTag = Omit<PugAST.Tag, 'attrs' | 'block'> & {
     attrs: readonly ASTAttr[];
     block: ASTBlock | null;
 } & AdditionalASTData;
-/** An optimized Pug interpolated tag node with computed child block. */
 export type ASTInterpolatedTag = Omit<PugAST.InterpolatedTag, 'block'> & {
     block: ASTBlock | null;
 } & AdditionalASTData;
-/** An optimized Pug code node (unbuffered/buffered JavaScript) with computed child block. */
 export type ASTCode = Omit<PugAST.Code, 'block'> & {
     block: ASTBlock | null;
 } & AdditionalASTData;
-/** An optimized Pug conditional (`if`/`else if`/`else`) node with computed child block. */
 export type ASTConditional = Omit<PugAST.CodeHelpers.Conditional, 'consequent' | 'alternate'> & {
     block: ASTBlock | null;
 } & AdditionalASTData;
-/** An optimized Pug `case` node with computed child block. */
 export type ASTCase = Omit<PugAST.CodeHelpers.CaseWhen.Case, 'block'> & {
     block: ASTBlock | null;
 } & AdditionalASTData;
-/** An optimized Pug `when` node with computed child block. */
 export type ASTWhen = Omit<PugAST.CodeHelpers.CaseWhen.When, 'block'> & {
     block: ASTBlock | null;
 } & AdditionalASTData;
-/** An optimized Pug `while` loop node with computed location data. */
 export type ASTWhile = PugAST.While & AdditionalASTData;
-/** An optimized Pug `each` iteration node with computed child block. */
 export type ASTEach = Omit<PugAST.Each, 'block' | 'alternate'> & {
     block: ASTBlock | null;
 } & AdditionalASTData;
-/** An optimized Pug mixin (definition or call) node with computed child block. */
 export type ASTMixin = Omit<PugAST.Mixin, 'block'> & {
     block: ASTBlock | null;
 } & AdditionalASTData;
-/** An optimized Pug `block` placeholder inside a mixin definition. */
 export type ASTMixinBlock = PugAST.MixinBlock & AdditionalASTData;
-/** An optimized Pug `yield` block placeholder. */
 export type ASTYieldBlock = PugAST.YieldBlock & AdditionalASTData;
-/** An optimized Pug file reference node with computed location data. */
 export type ASTFileReference = PugAST.FileOperations.FileReference & AdditionalASTData;
-/** An optimized Pug `include` node with computed child block. */
 export type ASTInclude = Omit<PugAST.FileOperations.Include, 'block'> & {
     block: ASTBlock | null;
 } & AdditionalASTData;
-/** An optimized Pug raw `include` node with computed location data. */
 export type ASTRawInclude = PugAST.FileOperations.RawInclude & AdditionalASTData;
-/** An optimized Pug include filter node with computed location data. */
 export type ASTIncludeFilter = PugAST.FileOperations.IncludeFilter & AdditionalASTData;
-/** An optimized Pug `extends` node with computed location data. */
 export type ASTExtends = PugAST.FileOperations.Extends & AdditionalASTData;
-/** An optimized Pug named block node with computed child nodes. */
 export type ASTNamedBlock = Omit<PugAST.FileOperations.NamedBlock, 'nodes'> & {
     nodes: readonly ASTNode[];
 } & AdditionalASTData;
-/** An optimized Pug filter node with computed child block. */
 export type ASTFilter = Omit<PugAST.Filter, 'block'> & {
     block: ASTBlock | null;
 } & AdditionalASTData;
-/** An optimized Pug attribute with computed location and raw source data. */
 export type ASTAttr = PugAST.AbstractNodeTypes.Attribute & AdditionalASTData;
 export declare namespace PugAST {
     /**

package/lib/utils/get-offset-from-line-and-col.d.ts

@@ -1,11 +1,4 @@
 /**
- * Calculates the character offset in a string from a 1-based line number
- * and 1-based column number. Handles multi-byte characters correctly
- * by splitting lines into individual characters.
- *
- * @param str - The source string to compute the offset within
- * @param line - The 1-based line number
- * @param col - The 1-based column number
- * @returns The 0-based character offset corresponding to the given line and column
+ * `line` and `col` are 1-based; the returned offset is 0-based.
  */
 export declare function getOffsetFromLineAndCol(str: string, line: number, col: number): number;

package/lib/utils/get-offset-from-line-and-col.js

@@ -1,12 +1,5 @@
 /**
- * Calculates the character offset in a string from a 1-based line number
- * and 1-based column number. Handles multi-byte characters correctly
- * by splitting lines into individual characters.
- *
- * @param str - The source string to compute the offset within
- * @param line - The 1-based line number
- * @param col - The 1-based column number
- * @returns The 0-based character offset corresponding to the given line and column
+ * `line` and `col` are 1-based; the returned offset is 0-based.
  */
 export function getOffsetFromLineAndCol(str, line, col) {
     const lines = str.split('\n').slice(0, line);

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@markuplint/pug-parser",
-	"version": "5.0.0-rc.2",
+	"version": "5.0.0-rc.5",
 	"description": "Pug parser for markuplint",
 	"repository": {
 		"type": "git",
@@ -10,7 +10,7 @@
 	"author": "Yusuke Hirao <yusukehirao@me.com>",
 	"license": "MIT",
 	"engines": {
-		"node": ">=22"
+		"node": ">=24"
 	},
 	"type": "module",
 	"exports": {
@@ -28,11 +28,11 @@
 		"clean": "tsc --build --clean tsconfig.build.json"
 	},
 	"dependencies": {
-		"@markuplint/html-parser": "5.0.0-rc.2",
-		"@markuplint/ml-ast": "5.0.0-rc.2",
-		"@markuplint/parser-utils": "5.0.0-rc.2",
+		"@markuplint/html-parser": "5.0.0-rc.5",
+		"@markuplint/ml-ast": "5.0.0-rc.5",
+		"@markuplint/parser-utils": "5.0.0-rc.5",
 		"pug-lexer": "5.0.1",
 		"pug-parser": "6.0.0"
 	},
-	"gitHead": "e43763858d9234c417053becc73dbd088c1e7ea6"
+	"gitHead": "8d87463af2ff3f1b83fb28da20f1819362cf3555"
 }