@d-zero/markuplint-config 5.0.0 → 5.1.0

package/README.md

@@ -1,5 +1,7 @@
 # `@d-zero/markuplint-config`
 
+D-ZERO用のMarkuplint設定です。アクセシブルで保守性の高いHTML実装を促進するためのルールセットを提供します。
+
 ## 個別インストール
 
 ```sh
@@ -16,6 +18,43 @@ npm install -D @d-zero/markuplint-config
 }
 ```
 
+## 含まれるルール
+
+このconfigには以下のD-ZERO独自ルールが含まれています：
+
+### 1. 要素の禁止・必須化
+
+- **`br`要素の禁止**: CSSでスタイル調整を推奨
+- **`img`要素のalt属性必須**: アクセシビリティ確保のため
+- **`a`要素のhref属性必須**: リンクの明確化
+
+### 2. button要素のInvoker Commands API使用の強制
+
+- **`type="button"`のbutton要素**: `command`属性が必須
+  - Invoker Commands APIを使用した宣言的なUI実装を推奨
+  - 例外: `role`属性を持つボタン、フォーム送信ボタン（`type="submit"`/`type="reset"`/typeなし）
+
+- **`popovertarget`属性を持つボタン**: Invoker Commands APIへの移行を推奨
+  - `commandfor`/`command`属性の使用を推奨
+  - `popovertarget`は将来的に非推奨となる予定
+
+詳細は[CODING_GUIDELINES_NO_CLICK_EVENT.md](../../CODING_GUIDELINES_NO_CLICK_EVENT.md)を参照してください。
+
+### 3. ファイル名の命名規則
+
+- **画像/メディアファイル**: 小文字のケバブケース（ハイフン区切り）を強制
+  - 対象: `img`, `video`, `audio`, `source`要素の`src`/`poster`属性
+  - 大文字、スペース、アンダースコアは使用不可
+
+### 4. 無効な属性
+
+- **`a`要素のhref属性**: `javascript:`スキームを禁止
+  - 代わりに`button`要素の使用を推奨
+
+### 5. 特殊な属性の許可
+
+- **`html`要素の`prefix`属性**: Open Graph Protocolのため許可
+
 ### 拡張
 
 プロジェクトに合わせて設定を追加します。

package/base.js

@@ -106,5 +106,35 @@ export default {
 				},
 			},
 		},
+		{
+			selector: 'button[type=button]:not([role]):not([popovertarget])',
+			rules: {
+				'required-attr': {
+					value: 'command',
+					reason:
+						'button要素には原則としてcommand属性が必要です。Invoker Commands APIを使用してアクセシブルなUIを実装してください。role属性を持つボタン（role="tab"など）やtype="submit"/type="reset"/typeなしのボタンは例外として許可されます。（D-ZERO独自ルール）',
+				},
+			},
+		},
+		{
+			selector: 'button[popovertarget]',
+			rules: {
+				'required-attr': {
+					value: 'commandfor',
+					reason:
+						'popovertarget属性の代わりにcommandfor属性を使用してください。popovertarget属性は将来的に非推奨となる予定です。（D-ZERO独自ルール）',
+				},
+			},
+		},
+		{
+			selector: 'button[popovertargetaction]',
+			rules: {
+				'required-attr': {
+					value: 'command',
+					reason:
+						'popovertargetaction属性（show/hide/toggle）の代わりにcommand属性（show-popover/hide-popover/toggle-popover）を使用してください。（D-ZERO独自ルール）',
+				},
+			},
+		},
 	],
 };

package/package.json

@@ -1,8 +1,12 @@
 {
 	"name": "@d-zero/markuplint-config",
-	"version": "5.0.0",
+	"version": "5.1.0",
 	"description": "Configurations of Markuplint",
-	"repository": "https://github.com/d-zero-dev/linters.git",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/d-zero-dev/linters.git",
+		"directory": "packages/@d-zero/markuplint-config"
+	},
 	"author": "D-ZERO Co., Ltd.",
 	"license": "MIT",
 	"publishConfig": {
@@ -22,8 +26,8 @@
 		"*.js"
 	],
 	"dependencies": {
-		"@markuplint/pug-parser": "4.6.22",
+		"@markuplint/pug-parser": "4.6.23",
 		"markuplint": "4.14.0"
 	},
-	"gitHead": "7f635ad8bbb1455d0d362fe00478a2f7bd216924"
+	"gitHead": "645a686188fe078102000e8d59860ec33f2ed750"
 }