@markuplint/smarty-parser 4.6.22 → 4.6.23

package/ARCHITECTURE.ja.md

@@ -0,0 +1,85 @@
+# @markuplint/smarty-parser
+
+## 概要
+
+`@markuplint/smarty-parser` は `HtmlParser` を拡張し、Smarty テンプレート式を含む HTML のリントを可能にします。Smarty 固有の `ignoreTags` パターンを定義する薄い設定レイヤーであり、すべてのパースロジックは基底の HTML パーサーに委譲されます。
+
+## 動作の仕組み
+
+このパーサーは基底の `HtmlParser` が提供する `ignoreTags` メカニズムを使用します:
+
+1. **マスク** -- パース前に、すべての Smarty テンプレート式（`{ ... }`、`{* ... *}`、`{literal} ... {/literal}`）が開始/終了デリミタにより識別され、プレースホルダーテキストに置換される
+2. **パース** -- マスクされた HTML は、テンプレート式が存在しないかのように標準 HTML パーサー（parse5）によってパースされる
+3. **保持** -- 元の Smarty 式は AST 内に `#ps:*`（PreprocessorSpecificBlock）ノードとして保持され、ソース位置も維持される
+
+このアプローチにより、markuplint は Smarty 構文に影響されることなく HTML 構造をリントできます。
+
+## ignoreTags 設定
+
+`SmartyParser` コンストラクタは、正しいマッチングを保証するために、最も具体的なものから順に3つのパターンを定義しています:
+
+| タイプ             | 開始        | 終了         | 説明                                               |
+| ------------------ | ----------- | ------------ | -------------------------------------------------- |
+| `smarty-literal`   | `{literal}` | `{/literal}` | Smarty パースを経由しないリテラルブロック          |
+| `smarty-comment`   | `{*`        | `*}`         | Smarty コメント（出力にレンダリングされない）      |
+| `smarty-scriptlet` | `{`         | `}`          | 一般的な Smarty タグ（変数、関数、モディファイア） |
+
+順序が重要です: `{literal}` と `{*` は汎用的な `{` パターンより先にマッチさせる必要があり、誤マッチを防止します。
+
+## サポートされない構文
+
+**引用符なしの属性値**内のテンプレート式はサポートされていません。これはすべてのテンプレートエンジンパーサーに共通する既知の制限です（[#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 を拡張する SmartyParser クラス
+└── index.spec.ts   -- パーサー統合テスト
+```
+
+## 主要ソースファイル
+
+| ファイル        | 用途                                                                |
+| --------------- | ------------------------------------------------------------------- |
+| `src/parser.ts` | `SmartyParser` クラスを定義し、シングルトン `parser` をエクスポート |
+| `src/index.ts`  | パッケージエントリーポイント。`parser` を再エクスポート             |
+
+## 統合ポイント
+
+```mermaid
+flowchart TD
+    subgraph upstream ["上流"]
+        htmlParser["@markuplint/html-parser\n(HtmlParser クラス)"]
+    end
+
+    subgraph pkg ["@markuplint/smarty-parser"]
+        smartyParser["SmartyParser\nextends HtmlParser\n(ignoreTags のみ)"]
+    end
+
+    subgraph downstream ["下流"]
+        mlCore["@markuplint/ml-core\n(MLASTDocument → MLDOM)"]
+    end
+
+    htmlParser -->|"継承"| smartyParser
+    smartyParser -->|"MLASTDocument を生成"| mlCore
+```
+
+## ドキュメントマップ
+
+- [メンテナンスガイド](docs/maintenance.ja.md) -- コマンド、レシピ、テスト

package/ARCHITECTURE.md

@@ -0,0 +1,85 @@
+# @markuplint/smarty-parser
+
+## Overview
+
+`@markuplint/smarty-parser` extends `HtmlParser` to lint HTML containing Smarty template expressions. It is a thin configuration layer that defines Smarty-specific `ignoreTags` patterns, delegating all parsing logic to the base HTML parser.
+
+## How It Works
+
+The parser uses the `ignoreTags` mechanism provided by the base `HtmlParser`:
+
+1. **Mask** -- Before parsing, all Smarty template expressions (`{ ... }`, `{* ... *}`, `{literal} ... {/literal}`) 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 Smarty 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 Smarty syntax.
+
+## ignoreTags Configuration
+
+The `SmartyParser` constructor defines three ignore patterns, ordered from most specific to least specific to ensure correct matching:
+
+| Type               | Start       | End          | Description                                           |
+| ------------------ | ----------- | ------------ | ----------------------------------------------------- |
+| `smarty-literal`   | `{literal}` | `{/literal}` | Literal blocks passed through without Smarty parsing  |
+| `smarty-comment`   | `{*`        | `*}`         | Smarty comments (not rendered in output)              |
+| `smarty-scriptlet` | `{`         | `}`          | General Smarty tags (variables, functions, modifiers) |
+
+The ordering matters: `{literal}` and `{*` must be matched before the generic `{` pattern to prevent false matches.
+
+## 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       -- SmartyParser class extending HtmlParser
+└── index.spec.ts   -- Parser integration tests
+```
+
+## Key Source Files
+
+| File            | Purpose                                                              |
+| --------------- | -------------------------------------------------------------------- |
+| `src/parser.ts` | Defines `SmartyParser` 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/smarty-parser"]
+        smartyParser["SmartyParser\nextends HtmlParser\n(ignoreTags only)"]
+    end
+
+    subgraph downstream ["Downstream"]
+        mlCore["@markuplint/ml-core\n(MLASTDocument → MLDOM)"]
+    end
+
+    htmlParser -->|"extends"| smartyParser
+    smartyParser -->|"produces MLASTDocument"| mlCore
+```
+
+## Documentation Map
+
+- [Maintenance Guide](docs/maintenance.md) -- Commands, recipes, and testing

package/CHANGELOG.md

@@ -3,13 +3,13 @@
 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/smarty-parser@4.6.21...@markuplint/smarty-parser@4.6.22) (2025-11-05)
+## [4.6.23](https://github.com/markuplint/markuplint/compare/@markuplint/smarty-parser@4.6.22...@markuplint/smarty-parser@4.6.23) (2026-02-10)
 
 **Note:** Version bump only for package @markuplint/smarty-parser
 
+## [4.6.22](https://github.com/markuplint/markuplint/compare/@markuplint/smarty-parser@4.6.21...@markuplint/smarty-parser@4.6.22) (2025-11-05)
 
-
-
+**Note:** Version bump only for package @markuplint/smarty-parser
 
 ## [4.6.21](https://github.com/markuplint/markuplint/compare/@markuplint/smarty-parser@4.6.20...@markuplint/smarty-parser@4.6.21) (2025-08-24)
 

package/SKILL.md

@@ -0,0 +1,95 @@
+---
+description: Perform maintenance tasks for @markuplint/smarty-parser
+globs:
+  - packages/@markuplint/smarty-parser/src/**
+alwaysApply: false
+---
+
+# smarty-parser-maintenance
+
+Perform maintenance tasks for `@markuplint/smarty-parser`: modify ignoreTags configuration,
+add new Smarty tag patterns, and update tests.
+
+## Input
+
+`$ARGUMENTS` specifies the task. Supported tasks:
+
+| Task               | Description                              |
+| ------------------ | ---------------------------------------- |
+| `modify-ignoretag` | Add or modify an ignoreTags pattern      |
+| `fix-parsing`      | Fix a parsing issue with Smarty syntax   |
+| `add-test`         | Add test cases for specific Smarty usage |
+
+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 and ignoreTags configuration
+- `src/parser.ts` -- SmartyParser class (source of truth for ignore patterns)
+
+## Task: modify-ignoretag
+
+Add or modify an ignoreTags pattern. Follow recipe #1 in `docs/maintenance.md`.
+
+### Step 1: Understand the current configuration
+
+1. Read `src/parser.ts` and review the existing `ignoreTags` array
+2. Understand the ordering: most specific patterns must come first
+
+### Step 2: Make the change
+
+1. Add the new pattern or modify an existing one in the `ignoreTags` array
+2. Use a descriptive `type` name prefixed with `smarty-`
+3. Ensure proper ordering: longer/more specific start delimiters before shorter ones
+
+### Step 3: Verify
+
+1. Build: `yarn build --scope @markuplint/smarty-parser`
+2. Add test cases to `src/index.spec.ts` verifying the new pattern produces the correct `#ps:smarty-*` node
+3. Test: `yarn test --scope @markuplint/smarty-parser`
+
+## Task: fix-parsing
+
+Fix a parsing issue with Smarty syntax. Follow recipe #2 in `docs/maintenance.md`.
+
+### Step 1: Reproduce the issue
+
+1. Create a minimal Smarty template that demonstrates the problem
+2. Write a failing test case in `src/index.spec.ts`
+
+### Step 2: Identify the cause
+
+1. Check if the issue is in the ignoreTags ordering (most common cause)
+2. Check if the delimiter pattern is too greedy or too restrictive
+3. If the issue is in the base parser, the fix belongs in `@markuplint/html-parser` or `@markuplint/parser-utils`
+
+### Step 3: Verify
+
+1. Build: `yarn build --scope @markuplint/smarty-parser`
+2. Test: `yarn test --scope @markuplint/smarty-parser`
+
+## Task: add-test
+
+Add test cases for specific Smarty usage. Follow recipe #3 in `docs/maintenance.md`.
+
+### Step 1: Write the test
+
+1. Read `src/index.spec.ts` for the existing test patterns
+2. Use `nodeListToDebugMaps()` for snapshot-style assertions
+3. Test node names: `#ps:smarty-scriptlet`, `#ps:smarty-comment`, `#ps:smarty-literal`
+
+### Step 2: Verify
+
+1. Test: `yarn test --scope @markuplint/smarty-parser`
+
+## Rules
+
+1. **Never reorder ignoreTags carelessly** -- more specific patterns must come before less specific ones.
+2. **Always prefix type names with `smarty-`** for consistency.
+3. **Test with real Smarty patterns** -- `{if}`, `{foreach}`, `{include}`, `{$variable}`, `{$var|modifier}`.
+4. **Add JSDoc comments** to all new public methods and properties.

package/docs/maintenance.ja.md

@@ -0,0 +1,125 @@
+# メンテナンスガイド
+
+## コマンド
+
+| コマンド                                       | 説明                   |
+| ---------------------------------------------- | ---------------------- |
+| `yarn build --scope @markuplint/smarty-parser` | このパッケージをビルド |
+| `yarn dev --scope @markuplint/smarty-parser`   | ウォッチモードでビルド |
+| `yarn clean --scope @markuplint/smarty-parser` | ビルド成果物を削除     |
+| `yarn test --scope @markuplint/smarty-parser`  | テストを実行           |
+
+## テスト
+
+テストファイルは `*.spec.ts` の命名規則に従い、`src/` ディレクトリに配置されています:
+
+| テストファイル  | カバレッジ                                                                                         |
+| --------------- | -------------------------------------------------------------------------------------------------- |
+| `index.spec.ts` | SmartyParser 統合テスト（スクリプトレット、コメント、リテラルブロック、ネストブロック、フル HTML） |
+
+主なテストパターンでは `nodeListToDebugMaps` を使用したスナップショット形式のアサーションを行います:
+
+```ts
+import { nodeListToDebugMaps } from '@markuplint/parser-utils';
+import { parser } from './parser.js';
+
+const doc = parser.parse('<div>{ title }</div>');
+const debugMaps = nodeListToDebugMaps(doc.nodeList);
+expect(debugMaps).toStrictEqual([
+  '[1:1]>[1:6](0,5)div: <div>',
+  '[1:6]>[1:15](5,14)#ps:smarty-scriptlet: {␣title␣}',
+  '[1:15]>[1:21](14,20)div: </div>',
+]);
+```
+
+各タグタイプのノード名:
+
+| ignoreTags タイプ  | AST ノード名           |
+| ------------------ | ---------------------- |
+| `smarty-literal`   | `#ps:smarty-literal`   |
+| `smarty-comment`   | `#ps:smarty-comment`   |
+| `smarty-scriptlet` | `#ps:smarty-scriptlet` |
+
+## レシピ
+
+### 1. ignoreTags パターンの追加・変更
+
+1. `src/parser.ts` を読み、既存の `ignoreTags` 配列を確認
+2. 新しいエントリを追加、または既存のものを変更:
+   - `type`: `smarty-` プレフィックスを持つ説明的な名前
+   - `start`: 開始デリミタ（文字列または正規表現）
+   - `end`: 終了デリミタ（文字列）
+3. 適切な順序を確保: より具体的なパターン（長い開始デリミタ）をより一般的なものの前に配置。例: `{literal}` を `{` の前に
+4. ビルド: `yarn build --scope @markuplint/smarty-parser`
+5. `src/index.spec.ts` にテストケースを追加
+6. テスト: `yarn test --scope @markuplint/smarty-parser`
+
+### 2. パース問題の修正
+
+1. 問題を再現する最小限の Smarty テンプレートを作成
+2. `src/index.spec.ts` に `nodeListToDebugMaps` を使用した失敗するテストケースを記述
+3. よくある原因:
+   - **順序の誤り** -- 汎用パターン（`{`）が具体的なパターン（`{literal}`）より先にマッチしている
+   - **貪欲なマッチング** -- デリミタがテキストを過剰に消費している
+   - **基底パーサーの問題** -- 問題は `@markuplint/html-parser` または `@markuplint/parser-utils` にあり、このパッケージではない
+4. `src/parser.ts` で問題を修正
+5. ビルドとテスト: `yarn build --scope @markuplint/smarty-parser && yarn test --scope @markuplint/smarty-parser`
+
+### 3. テストケースの追加
+
+1. `src/index.spec.ts` の既存パターンを確認
+2. `nodeListToDebugMaps()` を使用してデバッグ出力を生成
+3. ノード名が期待される `#ps:smarty-*` パターンと一致することを検証
+4. テストすべき一般的な Smarty パターン:
+   - 変数: `{$name}`、`{$user.name}`
+   - モディファイア: `{$name|escape}`、`{$date|date_format:"%Y"}`
+   - 関数: `{include file='header.tpl'}`、`{assign var='x' value='y'}`
+   - ブロックタグ: `{if $cond}...{/if}`、`{foreach $items as $item}...{/foreach}`
+   - コメント: `{* this is a comment *}`
+   - リテラルブロック: `{literal}...{/literal}`
+
+## 上流依存
+
+このパッケージは `@markuplint/html-parser` のみに依存しています。`HtmlParser` の `ignoreTags` メカニズムや基底 `Parser` クラスの変更がこのパッケージに影響する可能性があります。
+
+`@markuplint/html-parser` が更新された場合:
+
+```shell
+yarn build --scope @markuplint/smarty-parser && yarn test --scope @markuplint/smarty-parser
+```
+
+## トラブルシューティング
+
+### Smarty 式が検出されない
+
+**症状:** `{$variable}` のような Smarty タグが `#ps:smarty-scriptlet` ノードではなくプレーンテキストとして表示される。
+
+**原因:** `ignoreTags` パターンがマッチしていない。開始または終了デリミタが不正な可能性がある。
+
+**解決策:**
+
+1. `src/parser.ts` の `ignoreTags` 配列を確認
+2. 開始/終了デリミタが対象の Smarty 構文と一致することを検証
+3. 問題を再現するテストケースを追加
+
+### 誤ったタグタイプが割り当てられる
+
+**症状:** `{* comment *}` が `#ps:smarty-comment` ではなく `#ps:smarty-scriptlet` として検出される。
+
+**原因:** パターン順序の問題。汎用的な `{` パターンが、より具体的な `{*` パターンの前にマッチしている。
+
+**解決策:**
+
+1. `ignoreTags` 配列でより具体的なパターンが先に配置されていることを確認
+2. 正しい順序: `smarty-literal` > `smarty-comment` > `smarty-scriptlet`
+
+### リテラルブロックが正しく処理されない
+
+**症状:** `{literal}...{/literal}` 内のコンテンツが Smarty 式としてパースされる。
+
+**原因:** `smarty-literal` パターンがマッチしていない、または `smarty-scriptlet` の後に配置されている。
+
+**解決策:**
+
+1. `smarty-literal` が `ignoreTags` の最初のエントリであることを確認
+2. start が正確に `{literal}` で end が正確に `{/literal}` であることを確認

package/docs/maintenance.md

@@ -0,0 +1,125 @@
+# Maintenance Guide
+
+## Commands
+
+| Command                                        | Description            |
+| ---------------------------------------------- | ---------------------- |
+| `yarn build --scope @markuplint/smarty-parser` | Build this package     |
+| `yarn dev --scope @markuplint/smarty-parser`   | Watch mode build       |
+| `yarn clean --scope @markuplint/smarty-parser` | Remove build artifacts |
+| `yarn test --scope @markuplint/smarty-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` | SmartyParser integration tests (scriptlets, comments, literal blocks, nested blocks, full 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>{ title }</div>');
+const debugMaps = nodeListToDebugMaps(doc.nodeList);
+expect(debugMaps).toStrictEqual([
+  '[1:1]>[1:6](0,5)div: <div>',
+  '[1:6]>[1:15](5,14)#ps:smarty-scriptlet: {␣title␣}',
+  '[1:15]>[1:21](14,20)div: </div>',
+]);
+```
+
+Node names for each tag type:
+
+| ignoreTags Type    | AST Node Name          |
+| ------------------ | ---------------------- |
+| `smarty-literal`   | `#ps:smarty-literal`   |
+| `smarty-comment`   | `#ps:smarty-comment`   |
+| `smarty-scriptlet` | `#ps:smarty-scriptlet` |
+
+## Recipes
+
+### 1. Adding or Modifying an ignoreTags Pattern
+
+1. Read `src/parser.ts` and review the existing `ignoreTags` array
+2. Add the new entry or modify an existing one:
+   - `type`: A descriptive name prefixed with `smarty-`
+   - `start`: The opening delimiter (string or regex)
+   - `end`: The closing delimiter (string)
+3. Ensure proper ordering: more specific patterns (longer start delimiters) must come before less specific ones. For example, `{literal}` before `{`
+4. Build: `yarn build --scope @markuplint/smarty-parser`
+5. Add test cases to `src/index.spec.ts`
+6. Test: `yarn test --scope @markuplint/smarty-parser`
+
+### 2. Fixing a Parsing Issue
+
+1. Create a minimal Smarty template that reproduces the issue
+2. Write a failing test case in `src/index.spec.ts` using `nodeListToDebugMaps`
+3. Common causes:
+   - **Wrong ordering** -- A generic pattern (`{`) matches before a specific one (`{literal}`)
+   - **Greedy matching** -- A delimiter consumes too much text
+   - **Base parser issue** -- The problem is in `@markuplint/html-parser` or `@markuplint/parser-utils`, not here
+4. Fix the issue in `src/parser.ts`
+5. Build and test: `yarn build --scope @markuplint/smarty-parser && yarn test --scope @markuplint/smarty-parser`
+
+### 3. Adding Test Cases
+
+1. Read `src/index.spec.ts` for existing patterns
+2. Use `nodeListToDebugMaps()` to generate debug output
+3. Verify node names match the expected `#ps:smarty-*` pattern
+4. Common Smarty patterns to test:
+   - Variables: `{$name}`, `{$user.name}`
+   - Modifiers: `{$name|escape}`, `{$date|date_format:"%Y"}`
+   - Functions: `{include file='header.tpl'}`, `{assign var='x' value='y'}`
+   - Block tags: `{if $cond}...{/if}`, `{foreach $items as $item}...{/foreach}`
+   - Comments: `{* this is a comment *}`
+   - Literal blocks: `{literal}...{/literal}`
+
+## Upstream Dependency
+
+This package depends solely on `@markuplint/html-parser`. Changes to `HtmlParser`'s `ignoreTags` mechanism or the base `Parser` class may affect this package.
+
+When `@markuplint/html-parser` is updated:
+
+```shell
+yarn build --scope @markuplint/smarty-parser && yarn test --scope @markuplint/smarty-parser
+```
+
+## Troubleshooting
+
+### Smarty expressions are not detected
+
+**Symptom:** Smarty tags like `{$variable}` appear as plain text instead of `#ps:smarty-scriptlet` nodes.
+
+**Cause:** The `ignoreTags` pattern is not matching. The start or end delimiter may be incorrect.
+
+**Solution:**
+
+1. Check the `ignoreTags` array in `src/parser.ts`
+2. Verify the start/end delimiters match the Smarty syntax in question
+3. Add a test case reproducing the issue
+
+### Wrong tag type is assigned
+
+**Symptom:** A `{* comment *}` is detected as `#ps:smarty-scriptlet` instead of `#ps:smarty-comment`.
+
+**Cause:** Pattern ordering issue. The generic `{` pattern is matching before the more specific `{*` pattern.
+
+**Solution:**
+
+1. Ensure more specific patterns appear earlier in the `ignoreTags` array
+2. The correct order is: `smarty-literal` > `smarty-comment` > `smarty-scriptlet`
+
+### Literal blocks are not handled correctly
+
+**Symptom:** Content inside `{literal}...{/literal}` is parsed as Smarty expressions.
+
+**Cause:** The `smarty-literal` pattern is not matching, or it appears after `smarty-scriptlet` in the array.
+
+**Solution:**
+
+1. Verify `smarty-literal` is the first entry in `ignoreTags`
+2. Check that start is exactly `{literal}` and end is exactly `{/literal}`

package/lib/index.d.ts

@@ -1 +1,7 @@
+/**
+ * @module @markuplint/smarty-parser
+ * Markuplint parser plugin for Smarty templates. Extends the standard HTML parser
+ * to treat Smarty literal blocks, comments, and scriptlet tags 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/smarty-parser
+ * Markuplint parser plugin for Smarty templates. Extends the standard HTML parser
+ * to treat Smarty literal blocks, comments, and scriptlet tags 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 Smarty templates that extends the standard HTML parser.
+ *
+ * Configures the HTML parser to recognize Smarty tag variants as opaque blocks:
+ * - `{literal} ... {/literal}` (literal blocks passed through without parsing)
+ * - `{* ... *}` (Smarty comments)
+ * - `{ ... }` (general Smarty scriptlet tags for variables, functions, and modifiers)
+ */
 declare class SmartyParser extends HtmlParser {
     constructor();
 }
+/**
+ * Singleton Smarty parser instance for use by the markuplint engine.
+ */
 export declare const parser: SmartyParser;
 export {};

package/lib/parser.js

@@ -1,4 +1,12 @@
 import { HtmlParser } from '@markuplint/html-parser';
+/**
+ * Parser for Smarty templates that extends the standard HTML parser.
+ *
+ * Configures the HTML parser to recognize Smarty tag variants as opaque blocks:
+ * - `{literal} ... {/literal}` (literal blocks passed through without parsing)
+ * - `{* ... *}` (Smarty comments)
+ * - `{ ... }` (general Smarty scriptlet tags for variables, functions, and modifiers)
+ */
 class SmartyParser extends HtmlParser {
     constructor() {
         super({
@@ -22,4 +30,7 @@ class SmartyParser extends HtmlParser {
         });
     }
 }
+/**
+ * Singleton Smarty parser instance for use by the markuplint engine.
+ */
 export const parser = new SmartyParser();

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@markuplint/smarty-parser",
-	"version": "4.6.22",
+	"version": "4.6.23",
 	"description": "Smarty 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.6.23"
 	},
 	"devDependencies": {
-		"@markuplint/parser-utils": "4.8.10"
+		"@markuplint/parser-utils": "4.8.11"
 	},
-	"gitHead": "6213ea30269ef404f030e67bbcc7fc7443ec1060"
+	"gitHead": "193ee7c1262bbed95424e38efdf1a8e56ff049f4"
 }