@markuplint/nunjucks-parser 4.6.22 → 4.18.0

package/ARCHITECTURE.ja.md

@@ -0,0 +1,91 @@
+# @markuplint/nunjucks-parser
+
+## 概要
+
+`@markuplint/nunjucks-parser` は `HtmlParser` を拡張し、Nunjucks テンプレート式を含む HTML をリントします。Nunjucks 構文に対する3つの無視パターンを宣言することで、テンプレート式を不透明なブロックとして扱いながら、周囲の HTML 構造を markuplint が解析できるようにします。
+
+## 動作の仕組み
+
+このパーサーは基底 `HtmlParser` が提供する `ignoreTags` メカニズムを使用します:
+
+1. **マスク** -- パース前に、すべての Nunjucks テンプレート式が開始/終了デリミタで識別され、プレースホルダーテキストに置換される
+2. **パース** -- マスクされた HTML が標準 HTML パーサー（parse5）によって、テンプレート式が存在しないかのようにパースされる
+3. **保持** -- 元の Nunjucks 式は AST 内で `#ps:*`（PreprocessorSpecificBlock）ノードとして保持され、ソース位置が維持される
+
+このアプローチにより、markuplint は Nunjucks 構文に混乱することなく HTML 構造をリントできます。
+
+## ignoreTags 設定
+
+`NunjucksParser` コンストラクタは3つの無視パターンを定義します:
+
+| タイプ             | 開始 | 終了 | 説明                                             |
+| ------------------ | ---- | ---- | ------------------------------------------------ |
+| `nunjucks-block`   | `{%` | `%}` | ブロックタグ（if, for, macro, block, extends等） |
+| `nunjucks-output`  | `{{` | `}}` | 出力 / 変数展開                                  |
+| `nunjucks-comment` | `{#` | `#}` | コメント（レンダリングされない）                 |
+
+## サポートされない構文
+
+**引用符なしの属性値**内のテンプレート式はサポートされていません。これはすべてのテンプレートエンジンパーサーに共通する既知の制限です（[#240](https://github.com/markuplint/markuplint/issues/240)）。[ウェブサイトのドキュメント](https://markuplint.dev/docs/guides/besides-html)も参照してください。
+
+使用可能:
+
+```html
+<div attr="{{ value }}"></div>
+<div attr="{{ value }}"></div>
+<div attr="{{ value }}-{{ value2 }}-{{ value3 }}"></div>
+```
+
+使用不可（引用符なし）:
+
+```html
+<div attr="{{" value }}></div>
+```
+
+## ディレクトリ構成
+
+```
+src/
+├── index.ts        -- parser を再エクスポート
+├── parser.ts       -- HtmlParser を拡張する NunjucksParser クラス
+└── index.spec.ts   -- パーサー統合テスト
+```
+
+## 主要ソースファイル
+
+| ファイル        | 用途                                                                              |
+| --------------- | --------------------------------------------------------------------------------- |
+| `src/parser.ts` | `NunjucksParser` クラスを定義し、シングルトン `parser` インスタンスをエクスポート |
+| `src/index.ts`  | パッケージエントリポイント; `parser` を再エクスポート                             |
+
+## 統合ポイント
+
+```mermaid
+flowchart TD
+    subgraph upstream ["上流"]
+        htmlParser["@markuplint/html-parser\n(HtmlParser クラス)"]
+    end
+
+    subgraph pkg ["@markuplint/nunjucks-parser"]
+        nunjucksParser["NunjucksParser\nextends HtmlParser\n(ignoreTags のみ)"]
+    end
+
+    subgraph downstream ["下流"]
+        mlCore["@markuplint/ml-core\n(MLASTDocument -> MLDOM)"]
+    end
+
+    htmlParser -->|"継承"| nunjucksParser
+    nunjucksParser -->|"MLASTDocument を生成"| mlCore
+```
+
+### 上流
+
+- **`@markuplint/html-parser`** -- `ignoreTags` サポートを備えた `HtmlParser` 基底クラスを提供
+
+### 下流
+
+- **`@markuplint/ml-core`** -- このパーサーが生成する `MLASTDocument` を消費し、ルール評価用の MLDOM を構築
+
+## ドキュメントマップ
+
+- [メンテナンスガイド](docs/maintenance.ja.md) -- コマンド、レシピ、テスト

package/ARCHITECTURE.md

@@ -0,0 +1,91 @@
+# @markuplint/nunjucks-parser
+
+## Overview
+
+`@markuplint/nunjucks-parser` extends `HtmlParser` to lint HTML containing Nunjucks template expressions. By declaring three ignore patterns for Nunjucks syntax, the parser lets markuplint analyze the surrounding HTML structure while treating template expressions as opaque blocks.
+
+## How It Works
+
+The parser uses the `ignoreTags` mechanism provided by the base `HtmlParser`:
+
+1. **Mask** -- Before parsing, all Nunjucks template expressions are identified by their start/end delimiters and replaced with placeholder text
+2. **Parse** -- The masked HTML is parsed by the standard HTML parser (parse5) as if the template expressions did not exist
+3. **Preserve** -- The original Nunjucks expressions are preserved in the AST as `#ps:*` (PreprocessorSpecificBlock) nodes, maintaining their source positions
+
+This approach allows markuplint to lint the HTML structure without being confused by Nunjucks syntax.
+
+## ignoreTags Configuration
+
+The `NunjucksParser` constructor defines three ignore patterns:
+
+| Type               | Start | End  | Description                                    |
+| ------------------ | ----- | ---- | ---------------------------------------------- |
+| `nunjucks-block`   | `{%`  | `%}` | Block tags (if, for, macro, block, extends...) |
+| `nunjucks-output`  | `{{`  | `}}` | Output / variable interpolation                |
+| `nunjucks-comment` | `{#`  | `#}` | Comments (not rendered)                        |
+
+## Unsupported Syntaxes
+
+Template expressions inside **unquoted attribute values** are not supported. This is a known limitation shared by all template engine parsers ([#240](https://github.com/markuplint/markuplint/issues/240)). See also the [website documentation](https://markuplint.dev/docs/guides/besides-html).
+
+Available:
+
+```html
+<div attr="{{ value }}"></div>
+<div attr="{{ value }}"></div>
+<div attr="{{ value }}-{{ value2 }}-{{ value3 }}"></div>
+```
+
+Unavailable (unquoted):
+
+```html
+<div attr="{{" value }}></div>
+```
+
+## Directory Structure
+
+```
+src/
+├── index.ts        -- Re-exports parser
+├── parser.ts       -- NunjucksParser class extending HtmlParser
+└── index.spec.ts   -- Parser integration tests
+```
+
+## Key Source Files
+
+| File            | Purpose                                                                |
+| --------------- | ---------------------------------------------------------------------- |
+| `src/parser.ts` | Defines `NunjucksParser` class and exports singleton `parser` instance |
+| `src/index.ts`  | Package entry point; re-exports `parser`                               |
+
+## Integration Points
+
+```mermaid
+flowchart TD
+    subgraph upstream ["Upstream"]
+        htmlParser["@markuplint/html-parser\n(HtmlParser class)"]
+    end
+
+    subgraph pkg ["@markuplint/nunjucks-parser"]
+        nunjucksParser["NunjucksParser\nextends HtmlParser\n(ignoreTags only)"]
+    end
+
+    subgraph downstream ["Downstream"]
+        mlCore["@markuplint/ml-core\n(MLASTDocument -> MLDOM)"]
+    end
+
+    htmlParser -->|"extends"| nunjucksParser
+    nunjucksParser -->|"produces MLASTDocument"| mlCore
+```
+
+### Upstream
+
+- **`@markuplint/html-parser`** -- Provides the `HtmlParser` base class with `ignoreTags` support
+
+### Downstream
+
+- **`@markuplint/ml-core`** -- Consumes the `MLASTDocument` produced by this parser to build the MLDOM for rule evaluation
+
+## Documentation Map
+
+- [Maintenance Guide](docs/maintenance.md) -- Commands, recipes, and testing

package/CHANGELOG.md

@@ -3,13 +3,21 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
-## [4.6.22](https://github.com/markuplint/markuplint/compare/@markuplint/nunjucks-parser@4.6.21...@markuplint/nunjucks-parser@4.6.22) (2025-11-05)
+# [4.18.0](https://github.com/markuplint/markuplint/compare/v4.14.1...v4.18.0) (2026-04-22)
 
 **Note:** Version bump only for package @markuplint/nunjucks-parser
 
+## [4.6.24](https://github.com/markuplint/markuplint/compare/@markuplint/nunjucks-parser@4.6.23...@markuplint/nunjucks-parser@4.6.24) (2026-04-21)
+
+**Note:** Version bump only for package @markuplint/nunjucks-parser
 
+## [4.6.23](https://github.com/markuplint/markuplint/compare/@markuplint/nunjucks-parser@4.6.22...@markuplint/nunjucks-parser@4.6.23) (2026-02-10)
 
+**Note:** Version bump only for package @markuplint/nunjucks-parser
 
+## [4.6.22](https://github.com/markuplint/markuplint/compare/@markuplint/nunjucks-parser@4.6.21...@markuplint/nunjucks-parser@4.6.22) (2025-11-05)
+
+**Note:** Version bump only for package @markuplint/nunjucks-parser
 
 ## [4.6.21](https://github.com/markuplint/markuplint/compare/@markuplint/nunjucks-parser@4.6.20...@markuplint/nunjucks-parser@4.6.21) (2025-08-24)
 

package/SKILL.md

@@ -0,0 +1,94 @@
+---
+description: Perform maintenance tasks for @markuplint/nunjucks-parser
+globs:
+  - packages/@markuplint/nunjucks-parser/src/**
+alwaysApply: false
+---
+
+# nunjucks-parser-maintenance
+
+Perform maintenance tasks for `@markuplint/nunjucks-parser`: modify ignoreTags configuration,
+add new Nunjucks syntax patterns, and update tests.
+
+## Input
+
+`$ARGUMENTS` specifies the task. Supported tasks:
+
+| Task               | Description                            |
+| ------------------ | -------------------------------------- |
+| `modify-ignoretag` | Modify or add an ignoreTags pattern    |
+| `fix-parsing`      | Fix a parsing issue with Nunjucks HTML |
+| `add-test`         | Add a new test case                    |
+
+If omitted, defaults to `modify-ignoretag`.
+
+## Reference
+
+Before executing any task, read `docs/maintenance.md` (or `docs/maintenance.ja.md`)
+for the full guide. The recipes there are the source of truth for procedures.
+
+Also read:
+
+- `ARCHITECTURE.md` -- Package overview, ignoreTags table, and integration points
+- `src/parser.ts` -- NunjucksParser class (source of truth for ignore patterns)
+
+## Task: modify-ignoretag
+
+Modify or add an ignoreTags pattern. Follow recipe #1 in `docs/maintenance.md`.
+
+### Step 1: Understand the current patterns
+
+1. Read `src/parser.ts` and review the `ignoreTags` array in the constructor
+2. Each entry has `type` (node name), `start` (opening delimiter), and `end` (closing delimiter)
+
+### Step 2: Make the change
+
+1. Add or modify entries in the `ignoreTags` array
+2. If the new pattern overlaps with existing patterns, place the more specific pattern first
+3. Use a regex string for `start` if a simple string match is insufficient
+
+### Step 3: Verify
+
+1. Build: `yarn build --scope @markuplint/nunjucks-parser`
+2. Add test cases to `src/index.spec.ts`
+3. Test: `yarn test --scope @markuplint/nunjucks-parser`
+
+## Task: fix-parsing
+
+Fix a parsing issue with Nunjucks-containing HTML. Follow recipe #2 in `docs/maintenance.md`.
+
+### Step 1: Reproduce
+
+1. Add a failing test case to `src/index.spec.ts` using `nodeListToDebugMaps`
+2. Run: `yarn test --scope @markuplint/nunjucks-parser`
+
+### Step 2: Diagnose
+
+1. Check if the issue is in ignoreTags patterns (`src/parser.ts`) or in the upstream `HtmlParser`
+2. If the issue is upstream, fix it in `@markuplint/html-parser` instead
+
+### Step 3: Verify
+
+1. Build: `yarn build --scope @markuplint/nunjucks-parser`
+2. Test: `yarn test --scope @markuplint/nunjucks-parser`
+
+## Task: add-test
+
+Add a new test case. Follow recipe #3 in `docs/maintenance.md`.
+
+### Step 1: Write the test
+
+1. Read `src/index.spec.ts` for existing patterns
+2. Use `nodeListToDebugMaps` for snapshot-style assertions
+3. Use `parser.parse(source).nodeList` to get the node list
+
+### Step 2: Verify
+
+1. Test: `yarn test --scope @markuplint/nunjucks-parser`
+
+## Rules
+
+1. **Never override HtmlParser methods** in `NunjucksParser` -- this parser is ignoreTags-only.
+2. **Order ignoreTags from most specific to least specific** when patterns share a common prefix.
+3. **Add JSDoc comments** to all new public methods and properties.
+4. **Test all three expression types** (block, output, comment) when modifying patterns.

package/docs/maintenance.ja.md

@@ -0,0 +1,102 @@
+# メンテナンスガイド
+
+## コマンド
+
+| コマンド                                         | 説明                   |
+| ------------------------------------------------ | ---------------------- |
+| `yarn build --scope @markuplint/nunjucks-parser` | このパッケージをビルド |
+| `yarn dev --scope @markuplint/nunjucks-parser`   | ウォッチモードでビルド |
+| `yarn clean --scope @markuplint/nunjucks-parser` | ビルド成果物を削除     |
+| `yarn test --scope @markuplint/nunjucks-parser`  | テストを実行           |
+
+## テスト
+
+テストファイルは `*.spec.ts` の命名規則に従い、`src/` ディレクトリに配置されています:
+
+| テストファイル  | カバレッジ                                                                        |
+| --------------- | --------------------------------------------------------------------------------- |
+| `index.spec.ts` | パーサー統合テスト（block、output、comment タグの認識とネストされた HTML の処理） |
+
+主なテストパターンでは `nodeListToDebugMaps` を使用したスナップショット形式のアサーションを行います:
+
+```ts
+import { nodeListToDebugMaps } from '@markuplint/parser-utils';
+import { parser } from './parser.js';
+
+const doc = parser.parse('<div>{% if foo %}<span>{{ bar }}</span>{% endif %}</div>');
+const debugMaps = nodeListToDebugMaps(doc.nodeList);
+expect(debugMaps).toStrictEqual([
+  // 期待されるデバッグ出力
+]);
+```
+
+シンプルなタグ認識テストの場合:
+
+```ts
+expect(parser.parse('{% any %}').nodeList[0]?.nodeName).toBe('#ps:nunjucks-block');
+expect(parser.parse('{{ any }}').nodeList[0]?.nodeName).toBe('#ps:nunjucks-output');
+expect(parser.parse('{# any #}').nodeList[0]?.nodeName).toBe('#ps:nunjucks-comment');
+```
+
+## レシピ
+
+### 1. ignoreTags パターンの追加・変更
+
+1. `src/parser.ts` を読み、`ignoreTags` 配列を確認
+2. `type`、`start`、`end` プロパティを持つエントリを追加または変更
+3. パターンが共通のプレフィックスを持つ場合、より具体的なパターンを先に配置
+4. ビルド: `yarn build --scope @markuplint/nunjucks-parser`
+5. `src/index.spec.ts` にテストケースを追加し、新しいパターンが期待される `#ps:*` ノードを生成することを検証
+6. テスト: `yarn test --scope @markuplint/nunjucks-parser`
+
+### 2. パース問題の修正
+
+1. `src/index.spec.ts` に問題を再現する失敗するテストケースを追加
+2. 問題が ignoreTags 設定（`src/parser.ts`）にあるか、上流の `@markuplint/html-parser` にあるかを判断
+3. 上流の場合、そちらで修正し両パッケージをテスト:
+   ```shell
+   yarn test --scope @markuplint/html-parser --scope @markuplint/nunjucks-parser
+   ```
+4. ローカルの場合、ignoreTags パターンを調整
+5. ビルドとテスト: `yarn build --scope @markuplint/nunjucks-parser && yarn test --scope @markuplint/nunjucks-parser`
+
+### 3. テストケースの追加
+
+1. `src/index.spec.ts` の既存パターンを確認
+2. タグ認識テスト: `nodeName` が `#ps:nunjucks-block`、`#ps:nunjucks-output`、`#ps:nunjucks-comment` であることをアサート
+3. 複雑な HTML: `nodeListToDebugMaps` を使用した完全な AST スナップショット比較
+4. 実行: `yarn test --scope @markuplint/nunjucks-parser`
+
+## 上流への影響
+
+このパッケージは `@markuplint/html-parser` のみに依存しています。`HtmlParser` クラスまたはその `ignoreTags` メカニズムへの変更がこのパーサーに影響する可能性があります。上流の依存関係をアップグレードする際:
+
+1. ビルド: `yarn build --scope @markuplint/nunjucks-parser`
+2. テスト: `yarn test --scope @markuplint/nunjucks-parser`
+3. 3つの式タイプ（block、output、comment）がすべて正しくパースされることを検証
+
+## トラブルシューティング
+
+### Nunjucks 式がプリプロセッサブロックとして認識されない
+
+**症状:** Nunjucks 式（例: `{% raw %}`）が `#ps:nunjucks-block` ノードではなくテキストコンテンツとして表示される。
+
+**原因:** ignoreTags パターンがその式のデリミタにマッチしていない。
+
+**解決策:**
+
+1. `src/parser.ts` を確認 -- ignoreTags エントリの `start` と `end` デリミタを検証
+2. 式がバリアントデリミタを使用している場合、新しい ignoreTags エントリを追加するか既存のパターンを調整
+3. 失敗した特定の式でテスト
+
+### HTML 属性内の Nunjucks 式がパースエラーを引き起こす
+
+**症状:** 属性値に Nunjucks 式を含む HTML（例: `class="{{ foo }}"`）が予期しない AST 出力を生成する。
+
+**原因:** ignoreTags のマスクはソース位置を保持するが、プレースホルダーが HTML 属性パースと相互作用する可能性がある。
+
+**解決策:**
+
+1. `nodeListToDebugMaps` を使用した最小限のテストケースで再現
+2. これは通常、上流の `HtmlParser` の問題 -- 他のテンプレートパーサーでも同じ問題があるか確認
+3. Nunjucks デリミタに固有の問題であれば、`@markuplint/html-parser` に対してイシューを作成

package/docs/maintenance.md

@@ -0,0 +1,102 @@
+# Maintenance Guide
+
+## Commands
+
+| Command                                          | Description            |
+| ------------------------------------------------ | ---------------------- |
+| `yarn build --scope @markuplint/nunjucks-parser` | Build this package     |
+| `yarn dev --scope @markuplint/nunjucks-parser`   | Watch mode build       |
+| `yarn clean --scope @markuplint/nunjucks-parser` | Remove build artifacts |
+| `yarn test --scope @markuplint/nunjucks-parser`  | Run tests              |
+
+## Testing
+
+Test files follow the `*.spec.ts` naming convention and are located in the `src/` directory:
+
+| Test File       | Coverage                                                                          |
+| --------------- | --------------------------------------------------------------------------------- |
+| `index.spec.ts` | Parser integration tests (block, output, comment tag recognition and nested HTML) |
+
+The primary testing pattern uses `nodeListToDebugMaps` for snapshot-style assertions:
+
+```ts
+import { nodeListToDebugMaps } from '@markuplint/parser-utils';
+import { parser } from './parser.js';
+
+const doc = parser.parse('<div>{% if foo %}<span>{{ bar }}</span>{% endif %}</div>');
+const debugMaps = nodeListToDebugMaps(doc.nodeList);
+expect(debugMaps).toStrictEqual([
+  // expected debug output
+]);
+```
+
+For simple tag recognition tests:
+
+```ts
+expect(parser.parse('{% any %}').nodeList[0]?.nodeName).toBe('#ps:nunjucks-block');
+expect(parser.parse('{{ any }}').nodeList[0]?.nodeName).toBe('#ps:nunjucks-output');
+expect(parser.parse('{# any #}').nodeList[0]?.nodeName).toBe('#ps:nunjucks-comment');
+```
+
+## Recipes
+
+### 1. Adding or Modifying an ignoreTags Pattern
+
+1. Read `src/parser.ts` and review the `ignoreTags` array
+2. Add or modify the entry with `type`, `start`, and `end` properties
+3. If patterns share a common prefix, place the more specific pattern first
+4. Build: `yarn build --scope @markuplint/nunjucks-parser`
+5. Add test cases to `src/index.spec.ts` verifying the new pattern produces the expected `#ps:*` node
+6. Test: `yarn test --scope @markuplint/nunjucks-parser`
+
+### 2. Fixing a Parsing Issue
+
+1. Add a failing test case to `src/index.spec.ts` reproducing the issue
+2. Determine whether the issue is in the ignoreTags configuration (`src/parser.ts`) or upstream in `@markuplint/html-parser`
+3. If upstream, fix it there and test both packages:
+   ```shell
+   yarn test --scope @markuplint/html-parser --scope @markuplint/nunjucks-parser
+   ```
+4. If local, adjust the ignoreTags patterns
+5. Build and test: `yarn build --scope @markuplint/nunjucks-parser && yarn test --scope @markuplint/nunjucks-parser`
+
+### 3. Adding a Test Case
+
+1. Read `src/index.spec.ts` for existing patterns
+2. For tag recognition: assert `nodeName` equals `#ps:nunjucks-block`, `#ps:nunjucks-output`, or `#ps:nunjucks-comment`
+3. For complex HTML: use `nodeListToDebugMaps` for full AST snapshot comparison
+4. Run: `yarn test --scope @markuplint/nunjucks-parser`
+
+## Upstream Impact
+
+This package depends solely on `@markuplint/html-parser`. Changes to the `HtmlParser` class or its `ignoreTags` mechanism may affect this parser. When upgrading the upstream dependency:
+
+1. Build: `yarn build --scope @markuplint/nunjucks-parser`
+2. Test: `yarn test --scope @markuplint/nunjucks-parser`
+3. Verify all three expression types (block, output, comment) still parse correctly
+
+## Troubleshooting
+
+### Nunjucks expression not recognized as a preprocessor block
+
+**Symptom:** A Nunjucks expression (e.g., `{% raw %}`) appears as text content instead of a `#ps:nunjucks-block` node.
+
+**Cause:** The ignoreTags pattern does not match the expression's delimiters.
+
+**Solution:**
+
+1. Check `src/parser.ts` -- verify the `start` and `end` delimiters in the ignoreTags entry
+2. If the expression uses a variant delimiter, add a new ignoreTags entry or adjust the existing pattern
+3. Test with the specific expression that failed
+
+### Nunjucks expression inside an HTML attribute causes parse error
+
+**Symptom:** HTML containing Nunjucks expressions in attribute values (e.g., `class="{{ foo }}"`) produces unexpected AST output.
+
+**Cause:** The ignoreTags masking preserves source positions but the placeholder may interact with HTML attribute parsing.
+
+**Solution:**
+
+1. Reproduce with a minimal test case using `nodeListToDebugMaps`
+2. This is typically an upstream `HtmlParser` issue -- check if other template parsers have the same problem
+3. If specific to Nunjucks delimiters, file an issue against `@markuplint/html-parser`

package/lib/index.d.ts

@@ -1 +1,7 @@
+/**
+ * @module @markuplint/nunjucks-parser
+ * Markuplint parser plugin for Nunjucks templates. Extends the standard HTML parser
+ * to treat Nunjucks block tags, output expressions, and comments as opaque blocks,
+ * allowing markuplint to lint the surrounding HTML structure.
+ */
 export { parser } from './parser.js';

package/lib/index.js

@@ -1 +1,7 @@
+/**
+ * @module @markuplint/nunjucks-parser
+ * Markuplint parser plugin for Nunjucks templates. Extends the standard HTML parser
+ * to treat Nunjucks block tags, output expressions, and comments as opaque blocks,
+ * allowing markuplint to lint the surrounding HTML structure.
+ */
 export { parser } from './parser.js';

package/lib/parser.d.ts

@@ -1,6 +1,17 @@
 import { HtmlParser } from '@markuplint/html-parser';
+/**
+ * Parser for Nunjucks templates that extends the standard HTML parser.
+ *
+ * Configures the HTML parser to recognize Nunjucks tag variants as opaque blocks:
+ * - `{% ... %}` (block tags such as if, for, macro)
+ * - `{{ ... }}` (output / variable interpolation)
+ * - `{# ... #}` (comments)
+ */
 declare class NunjucksParser extends HtmlParser {
     constructor();
 }
+/**
+ * Singleton Nunjucks parser instance for use by the markuplint engine.
+ */
 export declare const parser: NunjucksParser;
 export {};

package/lib/parser.js

@@ -1,4 +1,12 @@
 import { HtmlParser } from '@markuplint/html-parser';
+/**
+ * Parser for Nunjucks templates that extends the standard HTML parser.
+ *
+ * Configures the HTML parser to recognize Nunjucks tag variants as opaque blocks:
+ * - `{% ... %}` (block tags such as if, for, macro)
+ * - `{{ ... }}` (output / variable interpolation)
+ * - `{# ... #}` (comments)
+ */
 class NunjucksParser extends HtmlParser {
     constructor() {
         super({
@@ -22,4 +30,7 @@ class NunjucksParser extends HtmlParser {
         });
     }
 }
+/**
+ * Singleton Nunjucks parser instance for use by the markuplint engine.
+ */
 export const parser = new NunjucksParser();

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@markuplint/nunjucks-parser",
-	"version": "4.6.22",
+	"version": "4.18.0",
 	"description": "Nunjucks template parser for markuplint",
 	"repository": "git@github.com:markuplint/markuplint.git",
 	"author": "Yusuke Hirao <yusukehirao@me.com>",
@@ -21,10 +21,10 @@
 		"clean": "tsc --build --clean tsconfig.build.json"
 	},
 	"dependencies": {
-		"@markuplint/html-parser": "4.6.22"
+		"@markuplint/html-parser": "4.18.0"
 	},
 	"devDependencies": {
-		"@markuplint/parser-utils": "4.8.10"
+		"@markuplint/parser-utils": "4.18.0"
 	},
-	"gitHead": "6213ea30269ef404f030e67bbcc7fc7443ec1060"
+	"gitHead": "1885af6349def3f19df975b9e9c399dd47361de1"
 }