eslint-plugin-smarthr 6.14.0 → 6.15.0

package/CHANGELOG.md

@@ -2,6 +2,16 @@
 
 All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
 
+## [6.15.0](https://github.com/kufu/tamatebako/compare/eslint-plugin-smarthr-v6.14.0...eslint-plugin-smarthr-v6.15.0) (2026-05-17)
+
+
+### Features
+
+* add v93-to-v94 migrator for smarthr-ui ([#1315](https://github.com/kufu/tamatebako/issues/1315)) ([06dce27](https://github.com/kufu/tamatebako/commit/06dce272572991f49f3de635790a06d2c6360f4f))
+* best-practice-for-consecutive-definition-listルールを追加 ([#1313](https://github.com/kufu/tamatebako/issues/1313)) ([4e5778f](https://github.com/kufu/tamatebako/commit/4e5778f95d598b233ca3a2e66e023247ed2fdb2f))
+* best-practice-for-default-propsルールを追加 ([#1312](https://github.com/kufu/tamatebako/issues/1312)) ([b0b0bb2](https://github.com/kufu/tamatebako/commit/b0b0bb2e8dd1a4533a9dbfe6583f45da8a6b8d81))
+* 同階層のバレルファイル間のimportを禁止 ([#1310](https://github.com/kufu/tamatebako/issues/1310)) ([4420109](https://github.com/kufu/tamatebako/commit/4420109a6c9f7fc23175928f7c605b69332ddbb7))
+
 ## [6.14.0](https://github.com/kufu/tamatebako/compare/eslint-plugin-smarthr-v6.13.0...eslint-plugin-smarthr-v6.14.0) (2026-05-13)
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "eslint-plugin-smarthr",
-  "version": "6.14.0",
+  "version": "6.15.0",
   "author": "SmartHR",
   "license": "MIT",
   "description": "A sharable ESLint plugin for SmartHR",

package/rules/autofixer-smarthr-ui-migration/DECORATORS.md

@@ -0,0 +1,65 @@
+# smarthr-ui decorators属性の前提知識
+
+## decorators属性の本来の目的と用途
+
+### 基本的な目的
+- **デフォルト文言の変更用**のAPI
+- smarthr-uiがコンポーネント内部で表示するテキストをカスタマイズする手段
+
+### 主な使用用途
+- **多言語化（翻訳）**: ほぼすべてのケースで多言語対応のために利用されている
+- 例: 日本語 → 英語、中国語などへの翻訳
+- 例: 「すべて選択」 → 「Select All」
+
+### 実装パターン
+```tsx
+// v93以前の典型的な使い方（多言語化）
+<ThCheckbox decorators={{ selectAll: () => 'Select All' }} />
+<DropZone decorators={{ selectButtonLabel: () => 'Choose File' }} />
+```
+
+## v94以降の方針変更
+
+### 内部で翻訳対応
+- v94以降、smarthr-ui内部で翻訳機能を提供
+- decorators属性は**不要**になった
+- 削除できる
+
+## migrator開発時の考慮事項
+
+### エラーメッセージの方針
+
+**❌ 避けるべき表現:**
+- 「IntlProviderのみを使用してください」（内部実装の詳細、利用者には意味不明）
+- 「decorators属性を削除してください」（理由が不明）
+
+**✅ 推奨される表現:**
+- 「多言語対応はsmarthr-ui内で自動的に行われるため、decorators属性は不要です」
+- 「翻訳はsmarthr-ui内で自動的に行われます」
+- 利用者視点で「なぜ削除できるのか」が理解できる説明
+
+### 削除時の判断基準
+
+- decoratorsは翻訳目的で使われていた
+- smarthr-ui内部で翻訳対応済み
+- → 自動修正で削除
+
+## 実績
+
+### v92-to-v93: DropZone
+- decorators.selectButtonLabel → selectButtonLabel 属性へ移行
+- 空のdecoratorsは削除
+- IntlProviderの翻訳を使用
+
+### v93-to-v94: ThCheckbox
+- decorators 完全削除（新属性への移行なし）
+- 翻訳はsmarthr-ui内で自動対応
+- 全ケースで自動修正可能
+
+## 今後のversion追加時のチェックリスト
+
+1. decorators削除対象のコンポーネントを確認
+2. 新属性への移行が必要か、完全削除か判断
+3. エラーメッセージは利用者視点で作成
+   - 「なぜ削除できるのか」を説明
+   - 「翻訳は内部で自動的に行われます」を明示

package/rules/autofixer-smarthr-ui-migration/DEVELOPER.md

@@ -2,6 +2,16 @@
 
 このドキュメントは、`autofixer-smarthr-ui-migration` ルールに新しいバージョンの移行ルールを追加する開発者向けのガイドです。
 
+## 重要: decorators属性の前提知識
+
+decorators属性に関する移行ルールを作成する際は、**必ず [DECORATORS.md](./DECORATORS.md) を参照してください。**
+
+**要点:**
+- decorators = デフォルト文言変更用（主用途: 多言語化）
+- v94以降 = 内部で翻訳対応（decorators不要）
+- エラーメッセージ = 利用者視点で「翻訳は自動対応」を明示
+- 「IntlProviderのみ使用」等の内部実装詳細は避ける
+
 ## 新バージョン追加の流れ
 
 新しいバージョン（例: v91→v92）の移行ルールを追加する際の手順：
@@ -56,10 +66,10 @@ autofixer-smarthr-ui-migrationルールに新しいバージョン（v[XX]→v[Y
 ## 参考にするファイル
 
 必ず以下のファイルを読んで、実装パターンを踏襲してください（最新のversionディレクトリを参照）：
-- rules/autofixer-smarthr-ui-migration/versions/v91-to-v92/REFERENCE.md（実装パターンの詳細説明）
-- rules/autofixer-smarthr-ui-migration/versions/v91-to-v92/index.js（実装例）
-- rules/autofixer-smarthr-ui-migration/versions/v91-to-v92/README.md（ユーザー向け移行ガイド）
-- rules/autofixer-smarthr-ui-migration/versions/v91-to-v92/test.js（テストケース）
+- rules/autofixer-smarthr-ui-migration/versions/v93-to-v94/REFERENCE.md（実装パターンの詳細説明）
+- rules/autofixer-smarthr-ui-migration/versions/v93-to-v94/index.js（実装例）
+- rules/autofixer-smarthr-ui-migration/versions/v93-to-v94/README.md（ユーザー向け移行ガイド）
+- rules/autofixer-smarthr-ui-migration/versions/v93-to-v94/test.js（テストケース）
 - test/autofixer-smarthr-ui-migration.js（メインテスト）
 - libs/common.js（rootPathの取得、tsconfig.jsonのpaths設定読み込み）
 
@@ -578,7 +588,7 @@ https://github.com/kufu/smarthr-ui/releases
 
 各versionディレクトリに`REFERENCE.md`があり、実装パターンや注意点が記載されています。
 
-**最新version:** [v91-to-v92/REFERENCE.md](./versions/v91-to-v92/REFERENCE.md)
+**最新version:** [v93-to-v94/REFERENCE.md](./versions/v93-to-v94/REFERENCE.md)
 
 このドキュメントには以下が含まれます：
 - ファイル構造と各セクションの説明

package/rules/autofixer-smarthr-ui-migration/README.md

@@ -193,6 +193,8 @@ export const ActionDialog = (props) => <div>{props.children}</div>
 |-----------|------|
 | `90` → `91` | [移行ガイド](./versions/v90-to-v91/README.md) |
 | `91` → `92` | [移行ガイド](./versions/v91-to-v92/README.md) |
+| `92` → `93` | [移行ガイド](./versions/v92-to-v93/README.md) |
+| `93` → `94` | [移行ガイド](./versions/v93-to-v94/README.md) |
 
 ## 使用方法
 

package/rules/autofixer-smarthr-ui-migration/index.js

@@ -18,12 +18,14 @@
 const v90ToV91 = require('./versions/v90-to-v91/index')
 const v91ToV92 = require('./versions/v91-to-v92/index')
 const v92ToV93 = require('./versions/v92-to-v93/index')
+const v93ToV94 = require('./versions/v93-to-v94/index')
 
 // サポートしているバージョン間の移行モジュール
 const VERSION_MODULES = {
   'v90-v91': v90ToV91,
   'v91-v92': v91ToV92,
   'v92-v93': v92ToV93,
+  'v93-v94': v93ToV94,
 }
 
 module.exports = {

package/rules/autofixer-smarthr-ui-migration/versions/v93-to-v94/README.md

@@ -0,0 +1,98 @@
+# smarthr-ui v93 → v94 移行ガイド
+
+このドキュメントは、smarthr-ui v93からv94への移行に必要な変更をまとめたものです。
+
+## 対応する破壊的変更
+
+### 1. ThCheckbox: decorators属性の削除
+
+v94では、`ThCheckbox`コンポーネントから`decorators`属性が削除されました。チェックボックスラベルの翻訳はsmarthr-ui内で自動的に行われます。
+
+#### 変更内容
+
+**削除された属性:**
+- `decorators?: DecoratorsType<'selectAll'>`
+
+**翻訳:**
+- デフォルトラベル: 「すべて選択」
+- 翻訳はsmarthr-ui内で自動的に行われます
+
+#### 移行方法
+
+**Before (v93):**
+```tsx
+<ThCheckbox decorators={{ selectAll: () => 'Select All' }} />
+```
+
+**After (v94):**
+```tsx
+<ThCheckbox />
+```
+
+#### 自動修正可能なパターン
+
+以下のパターンは、ESLintの`--fix`オプションで自動的に修正されます：
+
+```tsx
+// decorators属性を削除
+<ThCheckbox decorators={{ selectAll: () => '全選択' }} />
+→ <ThCheckbox />
+
+// 空のdecoratorsも削除
+<ThCheckbox decorators={{}} />
+→ <ThCheckbox />
+
+// 複雑な式でも削除
+<ThCheckbox decorators={{ selectAll: () => getLabel() }} />
+→ <ThCheckbox />
+```
+
+#### escape hatch className の変更
+
+v94では、ThCheckboxコンポーネントのescape hatch用className（`smarthr-ui-ThCheckbox`等）に変更はありません。
+
+## ESLintルールの使用方法
+
+### .eslintrc.js の設定
+
+```javascript
+module.exports = {
+  rules: {
+    'smarthr/autofixer-smarthr-ui-migration': ['error', { from: '93', to: '94' }],
+  },
+}
+```
+
+### 自動修正の実行
+
+```bash
+# エラーを確認
+pnpm run lint
+
+# 自動修正を実行
+pnpm run lint --fix
+```
+
+### smarthrUiAlias オプション
+
+プロジェクト固有のsmarthr-ui aliasパスを使用している場合は、`smarthrUiAlias`オプションを指定してください。
+
+```javascript
+module.exports = {
+  rules: {
+    'smarthr/autofixer-smarthr-ui-migration': [
+      'error',
+      {
+        from: '93',
+        to: '94',
+        smarthrUiAlias: '@/components/parts/smarthr-ui', // プロジェクト固有のalias
+      },
+    ],
+  },
+}
+```
+
+## 参考リンク
+
+- [smarthr-ui v94.0.0 リリースノート](https://github.com/kufu/smarthr-ui/releases/tag/smarthr-ui-v94.0.0)
+- [PR #6235: ThCheckbox の decorators 属性削除](https://github.com/kufu/smarthr-ui/pull/6235)

package/rules/autofixer-smarthr-ui-migration/versions/v93-to-v94/REFERENCE.md

@@ -0,0 +1,217 @@
+# v93-to-v94 実装の参考ポイント
+
+このドキュメントは、v93→v94の移行ルール実装の構造と、新しいversionを追加する際の参考ポイントを説明します。
+
+## v93→v94 特有の実装パターン
+
+### 1. ThCheckbox の decorators 属性削除
+
+v94では ThCheckbox コンポーネントから `decorators` 属性が削除されました。v92-to-v93のDropZoneと異なり、**新しい属性への移行はなく、完全に削除する**だけのシンプルなパターンです。
+
+#### 1-1. decorators属性のチェッカー（シンプルな削除）
+
+```javascript
+'JSXAttribute[name.name="decorators"]'(node) {
+  const componentName = node.parent.name.name
+
+  // ThCheckboxコンポーネントのみを対象
+  if (componentName !== 'ThCheckbox') return
+
+  context.report({
+    node,
+    messageId: 'removeDecorators',
+    data: { component: componentName, to: TARGET_VERSION },
+    fix(fixer) {
+      // decorators属性を削除
+      const tokenBefore = sourceCode.getTokenBefore(node)
+      if (tokenBefore && tokenBefore.range[1] < node.range[0]) {
+        return fixer.removeRange([tokenBefore.range[1], node.range[1]])
+      }
+      return fixer.remove(node)
+    },
+  })
+}
+```
+
+**ポイント:**
+- **v92-to-v93のDropZoneとの違い**:
+  - DropZone: `decorators.selectButtonLabel` → `selectButtonLabel`属性への移行
+  - ThCheckbox: `decorators` 完全削除（IntlProviderのみ使用）
+- **値の解析不要**: decoratorsの内容に関わらず削除するため、`extractSelectButtonLabel`のような解析関数は不要
+- **条件分岐なし**: spread syntax、他のキーの存在など、複雑な条件分岐が不要
+- **自動修正: 常に可能**: 手動対応が必要なケースなし
+
+#### 1-2. 前後の空白処理
+
+```javascript
+// decorators属性を削除
+const tokenBefore = sourceCode.getTokenBefore(node)
+if (tokenBefore && tokenBefore.range[1] < node.range[0]) {
+  // 前のトークンとの間に空白がある場合、空白も含めて削除
+  return fixer.removeRange([tokenBefore.range[1], node.range[1]])
+}
+return fixer.remove(node)
+```
+
+**重要:**
+- `getTokenBefore`で前のトークン（他の属性やコンポーネント名）を取得
+- 前のトークンの終了位置とdecorators属性の開始位置の間に空白があれば、空白も含めて削除
+- これにより `<ThCheckbox decorators={{}}` → `<ThCheckbox` のように余分な空白が残らない
+
+## v92-to-v93との実装比較
+
+### DropZone (v92-to-v93) - 複雑
+
+```javascript
+// decoratorsの値を解析
+const result = extractSelectButtonLabel(node)
+
+// 条件分岐
+if (result.type === 'spread') { /* 手動対応 */ }
+if (result.type === 'other-keys') { /* 手動対応 */ }
+if (result.type === 'migratable') {
+  // selectButtonLabel属性を追加 + decorators削除
+  fix(fixer) {
+    const fixes = []
+    fixes.push(fixer.insertTextAfter(node.parent.name, selectButtonLabelAttr))
+    fixes.push(fixer.removeRange([tokenBefore.range[1], node.range[1]]))
+    return fixes
+  }
+}
+```
+
+### ThCheckbox (v93-to-v94) - シンプル
+
+```javascript
+// 値の解析不要、条件分岐なし
+context.report({
+  node,
+  messageId: 'removeDecorators',
+  fix(fixer) {
+    // decorators削除のみ
+    const tokenBefore = sourceCode.getTokenBefore(node)
+    if (tokenBefore && tokenBefore.range[1] < node.range[0]) {
+      return fixer.removeRange([tokenBefore.range[1], node.range[1]])
+    }
+    return fixer.remove(node)
+  }
+})
+```
+
+## 共通パターン
+
+### setupSmarthrUiAliasOptions の使用
+
+```javascript
+const { validSources, isAliasFile, filename } = setupSmarthrUiAliasOptions(context, options)
+```
+
+**目的:**
+- `smarthrUiAlias`オプションに対応
+- aliasファイル（`@/components/parts/smarthr-ui`等）の検出
+- export変数名の置換（コンポーネント名変更時のみ必要）
+
+**v93-to-v94では:**
+- ThCheckboxはリネームされないため、export変数名の置換は不要
+- ただし`setupSmarthrUiAliasOptions`は他のversionとの一貫性のため呼び出す
+
+## テストケースのパターン
+
+### valid（エラーにならないケース）
+
+```javascript
+'<ThCheckbox>Label</ThCheckbox>',  // decoratorsなし
+'<OtherComponent decorators={{}} />',  // ThCheckbox以外
+```
+
+### invalid（エラーになるケース）
+
+```javascript
+{
+  code: '<ThCheckbox decorators={{ selectAll: () => "全選択" }}>Label</ThCheckbox>',
+  output: '<ThCheckbox>Label</ThCheckbox>',
+  errors: [{ messageId: 'removeDecorators' }]
+},
+{
+  code: '<ThCheckbox decorators={{}}>Label</ThCheckbox>',
+  output: '<ThCheckbox>Label</ThCheckbox>',
+  errors: [{ messageId: 'removeDecorators' }]
+}
+```
+
+## 新しいversionを追加する場合
+
+### シンプルな削除パターン（ThCheckboxタイプ）の場合
+
+1. **セレクター**: `JSXAttribute[name.name="属性名"]`
+2. **コンポーネント判定**: `if (componentName !== 'TargetComponent') return`
+3. **fix**: decorators属性を削除（前の空白も含む）
+4. **テスト**: valid（属性なし、他コンポーネント）、invalid（属性あり → 削除）
+
+### 複雑な移行パターン（DropZoneタイプ）の場合
+
+1. **解析関数**: decoratorsの値を解析し、移行可能性を判定
+2. **条件分岐**: spread / migratable / not-migratable / no-label 等
+3. **fix**: 新属性追加 + decorators削除（migratableの場合のみ）
+4. **テスト**: valid（新属性、他コンポーネント）、invalid（各パターン）
+
+## 実装の参考ポイント
+
+**最新version:** [v93-to-v94/REFERENCE.md](./versions/v93-to-v94/REFERENCE.md)
+
+### ESLint fixer API
+
+- `fixer.remove(node)`: ノードを削除
+- `fixer.removeRange([start, end])`: 範囲を削除
+- `fixer.insertTextAfter(node, text)`: ノードの後にテキスト挿入
+- `sourceCode.getTokenBefore(node)`: 前のトークンを取得
+- `sourceCode.getText(node)`: ノードのテキストを取得
+
+### ASTノード構造
+
+```javascript
+// <ThCheckbox decorators={{ selectAll: () => "全選択" }}>
+{
+  type: 'JSXAttribute',
+  name: { type: 'JSXIdentifier', name: 'decorators' },
+  value: {
+    type: 'JSXExpressionContainer',
+    expression: {
+      type: 'ObjectExpression',
+      properties: [...]
+    }
+  },
+  parent: {
+    type: 'JSXOpeningElement',
+    name: { type: 'JSXIdentifier', name: 'ThCheckbox' }
+  }
+}
+```
+
+## トラブルシューティング
+
+### 前の空白が残る
+
+**原因**: `fixer.remove(node)`のみだと、前の空白が残る
+
+**解決策**:
+```javascript
+const tokenBefore = sourceCode.getTokenBefore(node)
+if (tokenBefore && tokenBefore.range[1] < node.range[0]) {
+  return fixer.removeRange([tokenBefore.range[1], node.range[1]])
+}
+```
+
+### aliasファイルで動作しない
+
+**原因**: `smarthrUiAlias`オプションが設定されていない
+
+**解決策**:
+- `setupSmarthrUiAliasOptions`を呼び出す
+- テストで`smarthrUiAlias`オプションを指定したケースを追加
+
+### export変数名が置換されない
+
+**原因**: コンポーネント名変更時、aliasファイルのexport変数名を置換していない
+
+**解決策**: v90-to-v91の`renameExportedIdentifiers`パターンを参照

package/rules/autofixer-smarthr-ui-migration/versions/v93-to-v94/index.js

@@ -0,0 +1,66 @@
+/**
+ * smarthr-ui v93 → v94 移行ルール
+ *
+ * v94での破壊的変更に対応する自動修正を提供します。
+ *
+ * 対応する破壊的変更:
+ * 1. ThCheckbox の decorators 属性削除
+ *    - decorators属性を削除し、IntlProviderのみを使用
+ *
+ * 参考: https://github.com/kufu/smarthr-ui/releases/tag/smarthr-ui-v94.0.0
+ */
+
+const { setupSmarthrUiAliasOptions } = require('../../helpers')
+
+// ============================================================
+// 定数定義
+// ============================================================
+
+// v94を示す定数（メッセージで使用）
+const TARGET_VERSION = 'v94'
+
+// ============================================================
+// モジュールエクスポート
+// ============================================================
+
+module.exports = {
+  messages: {
+    removeDecorators: 'smarthr-ui {{to}} では {{component}} の decorators 属性は削除されました。翻訳はsmarthr-ui内で自動的に行われます',
+  },
+
+  createCheckers(context, sourceCode, options = {}) {
+    const { validSources, isAliasFile, filename } = setupSmarthrUiAliasOptions(context, options)
+
+    const checkers = {
+      // ============================================================
+      // ThCheckbox の decorators 属性削除
+      // ============================================================
+
+      'JSXAttribute[name.name="decorators"]'(node) {
+        const componentName = node.parent.name.name
+
+        // ThCheckboxコンポーネントのみを対象
+        if (componentName !== 'ThCheckbox') return
+
+        context.report({
+          node,
+          messageId: 'removeDecorators',
+          data: { component: componentName, to: TARGET_VERSION },
+          fix(fixer) {
+            // decorators属性を削除
+            const tokenBefore = sourceCode.getTokenBefore(node)
+            if (tokenBefore && tokenBefore.range[1] < node.range[0]) {
+              return fixer.removeRange([tokenBefore.range[1], node.range[1]])
+            }
+            return fixer.remove(node)
+          },
+        })
+      },
+    }
+
+    // aliasファイルの場合、export変数名の置換は不要
+    // (ThCheckboxはリネームされないため)
+
+    return checkers
+  },
+}