@markuplint/ml-config 5.0.0-dev.5 → 5.0.0-rc.0

package/ARCHITECTURE.ja.md

@@ -94,7 +94,8 @@ type RuleConfig<T, O> = {
 
 - `Pretender` -- CSS セレクタを使用してカスタム要素を標準要素に見せかける。`as` フィールドで要素名または詳細な `OriginalNode` を指定
 - `OriginalNode` -- 要素名、スロット、名前空間、属性、継承属性、ARIA プロパティを定義
-- `PretenderDetails` -- マージ後に使用される正規化形式 `{data?, files?, imports?}`
+- `PretenderDetails` -- マージ後に使用される正規化形式 `{data?, files?, imports?, scan?}`
+- `PretenderScanConfig` -- 動的スキャン設定 `{files, ignoreComponentNames?}`。拡張子によりスキャナーを自動判定（`.js/.jsx/.ts/.tsx` → JSX スキャナー、`.vue/.svelte/.astro` → テンプレートスキャナー）
 
 ### 自動修正型
 
@@ -139,7 +140,7 @@ flowchart TD
 | `specs`          | オブジェクト shallow merge | `mergeObject()`                                      | 同上                                          |
 | `excludeFiles`   | 結合+重複排除              | `concatArray(uniquely=true)`                         | 単純な値の重複排除                            |
 | `severity`       | オブジェクト shallow merge | `mergeObject()`                                      | parser と同様                                 |
-| `pretenders`     | セマンティックマージ       | `mergePretenders()`                                  | files/imports: 上書き、data: 追加             |
+| `pretenders`     | セマンティックマージ       | `mergePretenders()`                                  | files/imports: 上書き、data/scan: 追加        |
 | `rules`          | ルール別マージ             | `mergeRules()` → `mergeRule()`                       | **最も複雑 -- 次節で詳述**                    |
 | `nodeRules`      | 結合+名前で重複排除        | `concatArray(uniquely=true, comparePropName='name')` | 名前付きエントリは重複排除、無名は追加        |
 | `childNodeRules` | 結合+名前で重複排除        | `concatArray(uniquely=true, comparePropName='name')` | nodeRules と同様                              |
@@ -198,7 +199,7 @@ flowchart TD
 
 #### mergePretenders(a, b)
 
-配列形式の pretenders を正規化形式 `PretenderDetails`（`{data: [...]}`）に変換してからセマンティックマージ: `files`/`imports` は上書き（右辺優先）、`data` は追加（連結）。
+配列形式の pretenders を正規化形式 `PretenderDetails`（`{data: [...]}`）に変換してからセマンティックマージ: `files`/`imports` は上書き（右辺優先）、`data` と `scan` は追加（連結）。
 
 ## テンプレートレンダリングシステム
 

package/ARCHITECTURE.md

@@ -94,7 +94,8 @@ type RuleConfig<T, O> = {
 
 - `Pretender` -- Uses a CSS selector to make custom elements appear as standard elements for linting purposes; the `as` field specifies the element name or a detailed `OriginalNode`
 - `OriginalNode` -- Defines an element's name, slots, namespace, attributes, inherited attributes, and ARIA properties
-- `PretenderDetails` -- Normalized form `{data?, files?, imports?}` used after merging
+- `PretenderDetails` -- Normalized form `{data?, files?, imports?, scan?}` used after merging
+- `PretenderScanConfig` -- Dynamic scanning configuration `{files, ignoreComponentNames?}` for automatic component detection; file extensions determine the scanner (`.js/.jsx/.ts/.tsx` → JSX scanner, `.vue/.svelte/.astro` → template scanner)
 
 ### Autofix Types
 
@@ -139,7 +140,7 @@ flowchart TD
 | `specs`          | Object shallow merge             | `mergeObject()`                                      | Same as above                                        |
 | `excludeFiles`   | Concat + deduplicate             | `concatArray(uniquely=true)`                         | Simple value deduplication                           |
 | `severity`       | Object shallow merge             | `mergeObject()`                                      | Same as parser                                       |
-| `pretenders`     | Semantic merge                   | `mergePretenders()`                                  | files/imports: override, data: append                |
+| `pretenders`     | Semantic merge                   | `mergePretenders()`                                  | files/imports: override, data/scan: append           |
 | `rules`          | Per-rule merge                   | `mergeRules()` then `mergeRule()`                    | **Most complex -- see next section**                 |
 | `nodeRules`      | Concat + deduplicate by name     | `concatArray(uniquely=true, comparePropName='name')` | Named entries deduplicated; unnamed entries appended |
 | `childNodeRules` | Concat + deduplicate by name     | `concatArray(uniquely=true, comparePropName='name')` | Same as nodeRules                                    |
@@ -198,7 +199,7 @@ Collects the union of all keys from both override records. For each key, calls `
 
 #### mergePretenders(a, b)
 
-Converts array-form pretenders to the normalized `PretenderDetails` form (`{data: [...]}`) then applies semantic merge: `files`/`imports` are overridden (right-side wins), `data` is appended (concatenated).
+Converts array-form pretenders to the normalized `PretenderDetails` form (`{data: [...]}`) then applies semantic merge: `files`/`imports` are overridden (right-side wins), `data` and `scan` are appended (concatenated).
 
 ## Template Rendering System
 

package/CHANGELOG.md

@@ -3,6 +3,12 @@
 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.0](https://github.com/markuplint/markuplint/compare/v5.0.0-alpha.3...v5.0.0-rc.0) (2026-03-12)
+
+### Features
+
+- **ml-config,file-resolver:** wire scan field into config pipeline ([76b042a](https://github.com/markuplint/markuplint/commit/76b042a159b4037d3fff4e7c9a5c9be4d6dba44c)), closes [#3335](https://github.com/markuplint/markuplint/issues/3335) [#3336](https://github.com/markuplint/markuplint/issues/3336) [-#3341](https://github.com/-/issues/3341) [#3335](https://github.com/markuplint/markuplint/issues/3335)
+
 # [5.0.0-alpha.3](https://github.com/markuplint/markuplint/compare/v5.0.0-alpha.2...v5.0.0-alpha.3) (2026-02-26)
 
 ### Features

package/lib/merge-config.js

@@ -112,11 +112,12 @@ function mergePretenders(a, b) {
         return aDetails;
     }
     // files/imports: override (right-side wins)
-    // data: append (concatenate)
+    // data/scan: append (concatenate)
     const details = {
         files: bDetails.files ?? aDetails.files,
         imports: bDetails.imports ?? aDetails.imports,
         data: concatArray(aDetails.data, bDetails.data),
+        scan: concatArray(aDetails.scan, bDetails.scan),
     };
     deleteUndefProp(details);
     return details;

package/lib/types.d.ts

@@ -95,7 +95,8 @@ export type SeverityOptions = {
 };
 /**
  * Normalized form of pretender configuration used after merging.
- * Contains optional file references, import paths, and inline pretender data.
+ * Contains optional file references, import paths, inline pretender data,
+ * and dynamic scanning configuration.
  */
 export type PretenderDetails = {
     /**
@@ -106,13 +107,31 @@ export type PretenderDetails = {
      * @experimental
      */
     readonly imports?: readonly string[];
+    /**
+     * Inline pretender definitions.
+     */
     readonly data?: readonly Pretender[];
+    /**
+     * Dynamic scanning configuration. Each entry specifies a glob pattern
+     * for component files to scan. File extensions determine the scanner:
+     * `.js/.jsx/.ts/.tsx` use the JSX scanner, `.vue/.svelte/.astro` use
+     * the template scanner.
+     *
+     * @experimental
+     */
+    readonly scan?: readonly PretenderScanConfig[];
 };
 /**
  * Data structure for a pretender definition file.
  */
 export type PretenderFileData = {
+    /**
+     * Schema version of the pretender file format.
+     */
     readonly version: string;
+    /**
+     * Array of pretender definitions in this file.
+     */
     readonly data: readonly Pretender[];
 };
 /**
@@ -142,12 +161,6 @@ export type Pretender = {
      * @experimental
      */
     readonly filePath?: string;
-    /**
-     * Dynamic scaning
-     *
-     * @experimental
-     */
-    readonly scan?: readonly PretenderScanConfig[];
 };
 export type OriginalNode = {
     /**
@@ -259,21 +272,35 @@ export type PretenderARIA = {
     };
 };
 /**
+ * Configuration for dynamic component scanning.
+ * File extensions determine the scanner automatically:
+ * `.js/.jsx/.ts/.tsx` → JSX scanner, `.vue/.svelte/.astro` → template scanner.
+ *
  * @experimental
  */
 export type PretenderScanConfig = {
     /**
-     * Supporting for Glob format
+     * Glob pattern(s) for component files to scan.
+     */
+    readonly files: string | readonly string[];
+    /**
+     * Component names to exclude from scanning results.
      */
-    readonly files: string;
-    readonly type: string;
-    readonly options: PretenderScanOptions;
+    readonly ignoreComponentNames?: readonly string[];
 };
 /**
+ * Base options for pretender scanners.
+ *
  * @experimental
  */
 export interface PretenderScanOptions {
+    /**
+     * Working directory for resolving relative file paths.
+     */
     readonly cwd?: string;
+    /**
+     * Component names to exclude from scanning results.
+     */
     readonly ignoreComponentNames?: readonly string[];
 }
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@markuplint/ml-config",
-	"version": "5.0.0-dev.5+e96392f56",
+	"version": "5.0.0-rc.0",
 	"description": "JSON Schema and TypeScript types of markuplint configure JSON",
 	"repository": "git@github.com:markuplint/markuplint.git",
 	"author": "Yusuke Hirao <yusukehirao@me.com>",
@@ -27,14 +27,14 @@
 		"clean": "tsc --build --clean  tsconfig.build.json"
 	},
 	"dependencies": {
-		"@markuplint/ml-ast": "5.0.0-dev.5+e96392f56",
-		"@markuplint/ml-spec": "5.0.0-dev.5+e96392f56",
-		"@markuplint/selector": "5.0.0-dev.5+e96392f56",
-		"@markuplint/shared": "5.0.0-dev.5+e96392f56",
+		"@markuplint/ml-ast": "5.0.0-rc.0",
+		"@markuplint/ml-spec": "5.0.0-rc.0",
+		"@markuplint/selector": "5.0.0-rc.0",
+		"@markuplint/shared": "5.0.0-rc.0",
 		"@types/mustache": "4.2.6",
 		"is-plain-object": "5.0.0",
 		"mustache": "4.2.0",
 		"type-fest": "5.4.4"
 	},
-	"gitHead": "e96392f56e4bc8165ba59622b41c822703a96372"
+	"gitHead": "ebf4d7cfca0c259aead3b292c6b8a202db4cd802"
 }