eslint-plugin-smarthr 6.8.0 → 6.9.1

package/CHANGELOG.md

@@ -2,6 +2,20 @@
 
 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.9.1](https://github.com/kufu/tamatebako/compare/eslint-plugin-smarthr-v6.9.0...eslint-plugin-smarthr-v6.9.1) (2026-04-07)
+
+
+### Bug Fixes
+
+* **best-practice-for-text-component:** 変換不可能なshr-クラスのみの場合に不要なスペースが挿入される問題を修正 ([#1199](https://github.com/kufu/tamatebako/issues/1199)) ([ad942fc](https://github.com/kufu/tamatebako/commit/ad942fcfa2484013fe82fd1c9d9b94c097a0e27a))
+
+## [6.9.0](https://github.com/kufu/tamatebako/compare/eslint-plugin-smarthr-v6.8.0...eslint-plugin-smarthr-v6.9.0) (2026-04-05)
+
+
+### Features
+
+* **autofixer-smarthr-ui-migration:** smarthr-uiのalias対応を追加 ([#1191](https://github.com/kufu/tamatebako/issues/1191)) ([4a23056](https://github.com/kufu/tamatebako/commit/4a23056695a2955885ca8c1134b953f40f4588d4))
+
 ## [6.8.0](https://github.com/kufu/tamatebako/compare/eslint-plugin-smarthr-v6.7.0...eslint-plugin-smarthr-v6.8.0) (2026-04-03)
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "eslint-plugin-smarthr",
-  "version": "6.8.0",
+  "version": "6.9.1",
   "author": "SmartHR",
   "license": "MIT",
   "description": "A sharable ESLint plugin for SmartHR",
@@ -37,5 +37,5 @@
     "eslintplugin",
     "smarthr"
   ],
-  "gitHead": "37f60f6de393d28ec95cca0d84df567fb417d424"
+  "gitHead": "5f958652e81f7a69a347489108ff88cb1b3e56dd"
 }

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

@@ -61,6 +61,7 @@ autofixer-smarthr-ui-migrationルールに新しいバージョン（v[XX]→v[Y
 - rules/autofixer-smarthr-ui-migration/versions/v90-to-v91/README.md（ユーザー向け移行ガイド）
 - rules/autofixer-smarthr-ui-migration/versions/v90-to-v91/test.js（テストケース）
 - test/autofixer-smarthr-ui-migration.js（メインテスト）
+- libs/common.js（rootPathの取得、tsconfig.jsonのpaths設定読み込み）
 
 ## 対応する変更
 
@@ -71,26 +72,54 @@ smarthr-ui v[YY]のリリースノート: [GitHubリリースページのURL]
 1. [変更内容1の説明]
    - 例: ComponentA が ComponentB にリネーム（破壊的変更）
    - 自動修正: [可能/不可能/条件付き]
+   - セレクター: `ImportDeclaration`, `JSXOpeningElement[name.name="ComponentA"]`
 
 2. [変更内容2の説明]
    - 例: propsXがpropsYにリネーム（破壊的変更）
    - 自動修正: [可能/不可能/条件付き]
+   - セレクター: `JSXAttribute[name.name="propsX"]`
 
 3. [変更内容3の説明]
    - 例: 非推奨パターンから推奨パターンへの置き換え（非破壊的）
    - 自動修正: [可能/不可能/条件付き]
+   - セレクター: [該当するASTセレクター]
 
 4. ...
 
+**自動修正の判断基準:**
+- ✅ 自動修正可能: 機械的に100%正しく変換できる場合
+- ⚠️ エラーのみ: 手動確認が必要な場合（未知の属性がある、複数の対処方法がある等）
+- ❌ 検出しない: 複雑すぎる、影響範囲が広すぎる場合
+
 ## 実装内容
 
 1. versionディレクトリを作成: `versions/v[XX]-to-v[YY]/`
 
 2. `versions/v[XX]-to-v[YY]/index.js` を作成
    - messages定義
-   - createCheckers関数の実装
+   - createCheckers関数の実装（`createCheckers(context, sourceCode, options = {})`）
    - 必要に応じてヘルパー関数
 
+   **smarthrUiAliasオプションを利用する場合:**
+   ```javascript
+   const { rootPath } = require('../../../../libs/common')
+
+   createCheckers(context, sourceCode, options = {}) {
+     const customSmarthrUiAlias = options.smarthrUiAlias
+     const validSources = ['smarthr-ui']
+     if (customSmarthrUiAlias) {
+       validSources.push(customSmarthrUiAlias)
+     }
+
+     const isAliasFile = customSmarthrUiAlias && isFileMatchingSmarthrUiAlias(
+       context.getFilename(),
+       customSmarthrUiAlias
+     )
+
+     // ... チェッカー実装
+   }
+   ```
+
 3. `versions/v[XX]-to-v[YY]/README.md` を作成（ユーザー向け移行ガイド）
    - 各変更の説明
    - Before/Afterのコード例
@@ -104,6 +133,26 @@ smarthr-ui v[YY]のリリースノート: [GitHubリリースページのURL]
    - valid: v[YY]形式が正常に通ること
    - invalid: v[XX]形式が検出されて修正されること
 
+   **テストケースの構造:**
+   ```javascript
+   const v[XX]Tov[YY]Options = [{ from: '[XX]', to: '[YY]' }]
+
+   module.exports = {
+     valid: [
+       { code: `import { NewComponent } from 'smarthr-ui'`, options: v[XX]Tov[YY]Options },
+       { code: `<NewComponent>...</NewComponent>`, options: v[XX]Tov[YY]Options },
+     ],
+     invalid: [
+       {
+         code: `import { OldComponent } from 'smarthr-ui'`,
+         output: `import { NewComponent } from 'smarthr-ui'`,
+         options: v[XX]Tov[YY]Options,
+         errors: [{ messageId: 'renameComponent', data: { old: 'OldComponent', new: 'NewComponent', to: 'v[YY]' } }],
+       },
+     ],
+   }
+   ```
+
 6. `index.js`のVERSION_MODULESに登録
    ```javascript
    const v[XX]Tov[YY] = require('./versions/v[XX]-to-v[YY]/index')
@@ -144,6 +193,50 @@ smarthr-ui v[YY]のリリースノート: [GitHubリリースページのURL]
 - JSDocコメントを適切に追加してください
 - ディレクトリ名は必ず `vXX-to-vYY` 形式にしてください（内部キーと統一）
 
+## 共通機能：smarthrUiAlias オプション
+
+プロジェクト固有のsmarthr-ui aliasパスに対応するため、`smarthrUiAlias`オプションが利用可能です。
+
+### createCheckers関数でのオプション利用
+
+```javascript
+createCheckers(context, sourceCode, options = {}) {
+  const customSmarthrUiAlias = options.smarthrUiAlias
+  const validSources = ['smarthr-ui']
+  if (customSmarthrUiAlias) {
+    validSources.push(customSmarthrUiAlias)
+  }
+
+  // aliasファイルかどうかの判定
+  const isAliasFile = customSmarthrUiAlias && isFileMatchingSmarthrUiAlias(
+    context.getFilename(),
+    customSmarthrUiAlias
+  )
+
+  // ...
+}
+```
+
+### 主な用途
+
+1. **importのチェック範囲拡張**: `smarthr-ui`に加えて、aliasパス（例: `@/components/parts/smarthr-ui`）からのimportも置換対象
+2. **aliasファイル内のexport変数名置換**: `smarthrUiAlias`配下のファイルで、smarthr-uiコンポーネント名と同じexport変数名を自動置換
+
+詳細は[README.md](./README.md#smarthr-ui-の-alias-を使用している場合)を参照。
+
+### 🔄 今後の検討事項：共通化
+
+**現状:** 各versionディレクトリ（v90-to-v91など）で個別にsmarthrUiAlias関連の処理を実装しています。
+
+**検討中:** 以下の処理を共通化できる可能性があります：
+- `validSources`の拡張ロジック
+- `isFileMatchingSmarthrUiAlias`ヘルパー関数
+- export変数名の置換チェッカー追加ロジック
+
+**実装時期:** v92移行ルール追加時に、重複を確認して共通化を検討してください。共通化する場合は、以下のような場所が候補です：
+- `libs/common.js`に共通ヘルパー関数を追加
+- 各versionモジュールで共通の基底関数を提供
+
 ## 完了後の作業
 
 実装が完了したら、**必ずこのDEVELOPER.mdを更新**してください：
@@ -163,7 +256,11 @@ smarthr-ui v[YY]のリリースノート: [GitHubリリースページのURL]
 - [ ] `versions/vXX-to-vYY/` ディレクトリを作成
 - [ ] `versions/vXX-to-vYY/index.js` を作成
   - [ ] messages定義が含まれている
-  - [ ] createCheckers関数が実装されている
+  - [ ] createCheckers関数が実装されている（`createCheckers(context, sourceCode, options = {})`）
+  - [ ] smarthrUiAliasオプションに対応している場合：
+    - [ ] `const { rootPath } = require('../../../../libs/common')` をimport
+    - [ ] `validSources`に`customSmarthrUiAlias`を追加
+    - [ ] `isAliasFile`でファイル判定を実装
   - [ ] ヘルパー関数にJSDocコメントがある
   - [ ] ファイル冒頭に変更サマリーコメントがある
 - [ ] `versions/vXX-to-vYY/README.md` を作成（ユーザー向け移行ガイド）
@@ -191,6 +288,120 @@ smarthr-ui v[YY]のリリースノート: [GitHubリリースページのURL]
 - [ ] `npm test -- test/autofixer-smarthr-ui-migration.js` が通過
 - [ ] オプション `{ from: "[XX]", to: "[YY]" }` で動作確認
 - [ ] 複数バージョンスキップ（例: `{ from: "90", to: "[YY]" }`）でも動作確認
+- [ ] smarthrUiAliasオプション対応がある場合：
+  - [ ] `{ from: "[XX]", to: "[YY]", smarthrUiAlias: "@/components/parts/smarthr-ui" }` で動作確認
+  - [ ] aliasファイル内のexport変数名が置換されることを確認
+
+### 実プロダクトでの検証
+
+単体テストが通過したら、実際のプロダクトで動作確認を行います。
+
+**手順:**
+
+1. **対象プロダクトの選択**
+   - ローカルにある実プロダクトを選択（例: `/works/workflow/michi/frontend`）
+
+2. **ブランチ作成**
+   - `staging` ブランチから新しいブランチを作成（`staging` がない場合は `master` または `main`）
+   ```bash
+   cd /path/to/product
+   git checkout staging  # または master/main
+   git pull
+   git checkout -b test/migrator-vXX-to-vYY
+   ```
+
+3. **migratorの追加と設定**
+   - 開発中の `eslint-plugin-smarthr` を対象プロダクトに追加
+   ```bash
+   # 相対パスで開発中のパッケージを追加
+   pnpm add -D ../../../tamatebako/packages/eslint-plugin-smarthr
+   # または npm/yarn の場合
+   # npm install -D ../../../tamatebako/packages/eslint-plugin-smarthr
+   ```
+
+   - **Legacy Config形式** (`.eslintrc.js`) の場合：
+   ```javascript
+   module.exports = {
+     extends: ['smarthr'],
+     rules: {
+       'smarthr/autofixer-smarthr-ui-migration': [
+         'error',
+         { from: 'XX', to: 'YY', smarthrUiAlias: '@/components/parts/smarthr-ui' }
+       ]
+     }
+   }
+   ```
+
+   - **Flat Config形式** (`eslint.config.mjs`) の場合：
+   ```javascript
+   import smarthr from 'eslint-config-smarthr'
+   import smarthrPlugin from 'eslint-plugin-smarthr'  // 追加
+
+   export default [
+     ...smarthr,
+     {
+       plugins: {
+         'smarthr-local': smarthrPlugin,  // 別名で登録
+       },
+       rules: {
+         'smarthr-local/autofixer-smarthr-ui-migration': [
+           'error',
+           { from: 'XX', to: 'YY', smarthrUiAlias: '@/components/parts/smarthr-ui' }
+         ],
+       },
+     },
+   ]
+   ```
+   **注意:** Flat Configでは、すでに `eslint-config-smarthr` 経由で `smarthr` プラグインが登録されているため、開発中のバージョンを使用するには別名（例: `smarthr-local`）で登録する必要があります。
+
+4. **初回実行**
+   ```bash
+   npm run lint:fix  # または eslint --fix .
+   ```
+
+5. **問題の修正と再実行**
+   - 実行時に出た問題（エラー、不正な変換など）を確認
+   - 問題があれば migrator の実装を修正
+   - **重要:** 再実行前に、staging が更新されていない状態（migration前の状態）に戻す
+   ```bash
+   git reset --hard HEAD  # 変更を破棄
+   # migratorを修正後、再度実行
+   npm run lint:fix
+   ```
+   - 問題が解決するまで手順5を繰り返す
+
+6. **PR作成**
+   - 問題が修正されたことを確認できたら、差分を確認しやすいよう draft で PR 作成
+   ```bash
+   git add .
+   git commit -m "test: vXX to vYY migration test"
+   git push -u origin test/migrator-vXX-to-vYY
+   gh pr create --draft --title "test: vXX to vYY migration test" --body "migratorの動作確認用PR"
+   ```
+   - PR の差分をレビューして、期待通りの変換が行われているか確認
+
+7. **クリーンアップ**
+   - 検証完了後、対象プロダクトを元の状態に戻す
+   ```bash
+   # PRはクローズ（マージしない）
+   gh pr close test/migrator-vXX-to-vYY
+
+   # ブランチを削除
+   git checkout staging  # または master/main
+   git branch -D test/migrator-vXX-to-vYY
+   git push origin --delete test/migrator-vXX-to-vYY
+
+   # package.jsonとlockファイルを元に戻す
+   git checkout package.json pnpm-lock.yaml  # または package-lock.json/yarn.lock
+   pnpm install  # 依存関係を再インストール
+   ```
+
+**確認ポイント:**
+- [ ] エラーが出ずに実行完了する
+- [ ] 意図した変換が正しく行われている
+- [ ] 不要な変更が含まれていない
+- [ ] エッジケースでも正しく動作する
+- [ ] aliasファイル内のexport変数名も正しく置換されている（smarthrUiAliasオプション使用時）
 
 ## 参考情報
 

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

@@ -31,6 +31,160 @@ smarthr-ui のバージョン間の移行を支援する自動修正ルールで
 }
 ```
 
+### smarthr-ui の alias を使用している場合
+
+プロジェクトで smarthr-ui を独自のパスから re-export している場合（例: `@/components/parts/smarthr-ui`）、`smarthrUiAlias` オプションを指定することで、alias ファイル内のコンポーネント定義も自動修正の対象になります。
+
+#### 前提条件
+
+このオプションを使用するには、`tsconfig.json` で paths 設定が必要です：
+
+```json
+{
+  "compilerOptions": {
+    "paths": {
+      "@/*": ["src/*"]
+    }
+  }
+}
+```
+
+#### 使用方法
+
+```javascript
+{
+  "rules": {
+    "smarthr/autofixer-smarthr-ui-migration": [
+      "error",
+      {
+        "from": "90",
+        "to": "91",
+        "smarthrUiAlias": "@/components/parts/smarthr-ui"
+      }
+    ]
+  }
+}
+```
+
+#### 動作
+
+このオプションを指定すると、以下の3つが置換対象になります：
+
+1. **`smarthr-ui` からの直接 import**（`smarthrUiAlias` 指定に関わらず常に置換）
+   ```typescript
+   // Before
+   import { ActionDialog } from 'smarthr-ui'
+   // After
+   import { ControlledActionDialog } from 'smarthr-ui'
+   ```
+
+2. **alias パスからの import**
+   ```typescript
+   // Before
+   import { ActionDialog } from '@/components/parts/smarthr-ui'
+   // After
+   import { ControlledActionDialog } from '@/components/parts/smarthr-ui'
+   ```
+
+3. **alias ファイル内の export 変数名**（smarthr-ui のコンポーネント名と同じ場合のみ）
+   ```typescript
+   // @/components/parts/smarthr-ui/ActionDialog.tsx（aliasファイル）
+
+   // Before（v90 使用時）
+   import { ActionDialog as ShrActionDialog } from 'smarthr-ui'
+   export const ActionDialog = (props) => {
+     return <ShrActionDialog {...props} customProp="value" />
+   }
+
+   // After（v91 移行後）
+   import { ControlledActionDialog as ShrActionDialog } from 'smarthr-ui'
+   export const ControlledActionDialog = (props) => {
+     return <ShrActionDialog {...props} customProp="value" />
+   }
+   ```
+
+#### barrel import 構造への対応
+
+`smarthrUiAlias` で指定されたパス配下のすべてのファイルが置換対象になります。
+
+**ディレクトリ形式:**
+```
+@/components/parts/smarthr-ui/
+├── index.tsx               # ✅ 置換対象
+├── ActionDialog.tsx        # ✅ 置換対象
+├── FormDialog.tsx          # ✅ 置換対象
+└── dialogs/
+    └── MessageDialog.tsx   # ✅ 置換対象（サブディレクトリも含む）
+```
+
+```typescript
+// index.tsx（barrel export）
+export { ActionDialog } from './ActionDialog'
+export { FormDialog } from './FormDialog'
+
+// または、smarthr-uiから直接re-export
+export { ActionDialog } from 'smarthr-ui'
+// → export { ControlledActionDialog } from 'smarthr-ui' に自動置換
+
+// ActionDialog.tsx
+import { ActionDialog as ShrActionDialog } from 'smarthr-ui'
+export const ActionDialog = (props) => <ShrActionDialog {...props} />
+// → export const ControlledActionDialog に自動置換
+```
+
+**単一ファイル形式:**
+```
+@/components/parts/smarthr-ui.tsx   # ✅ 置換対象
+```
+
+```typescript
+// smarthr-ui.tsx
+export const ActionDialog = (props) => <div>{props.children}</div>
+// → export const ControlledActionDialog に自動置換
+```
+
+#### 制限事項
+
+- **対象ファイルの範囲:** `smarthrUiAlias` で指定されたパス配下のファイルのみ。他のディレクトリにある同名の export は変更されません
+  ```typescript
+  // src/components/parts/smarthr-ui/index.tsx → 置換される ✅
+  // src/features/custom/ActionDialog.tsx → 置換されない ✅
+  ```
+
+- **変数名の判定:** smarthr-ui が提供するコンポーネント名と完全一致する export 変数名のみ置換
+  ```typescript
+  export const ActionDialog = ...  // ✅ 置換される
+  export const MyActionDialog = ... // ❌ 置換されない
+  export const CustomDialog = ...   // ❌ 置換されない
+  ```
+
+- **export 形式:** 現在は `export const` 形式のみサポート
+  ```typescript
+  export const ActionDialog = ... // ✅ サポート
+  export function ActionDialog()  // ❌ 未サポート
+  export class ActionDialog       // ❌ 未サポート
+  ```
+
+- **ファイル名の変更:** ファイル名が変更対象のコンポーネント名と一致する場合、ファイル名の変更を促すエラーが表示されます（自動修正不可）
+  ```
+  // エラー例
+  smarthr-ui v91 では ActionDialog が ControlledActionDialog にリネームされました。
+  以下の手順で対応してください:
+  1. ファイル名を変更（例: git mv ActionDialog.tsx ControlledActionDialog.tsx）
+  2. このファイルをimportしている箇所を更新（例: from '@/path/ActionDialog' → from '@/path/ControlledActionDialog'）
+  ```
+
+  **対応手順:**
+  1. ファイル名を変更: `git mv ActionDialog.tsx ControlledActionDialog.tsx`
+  2. このファイルをimportしている箇所を手動で更新:
+     ```typescript
+     // Before
+     import { FormDialog } from '@/components/parts/smarthr-ui/FormDialog'
+
+     // After
+     import { ControlledFormDialog } from '@/components/parts/smarthr-ui/ControlledFormDialog'
+     ```
+
 ## サポートされているバージョン
 
 各バージョンの破壊的変更の詳細と対応内容については、リンク先の移行ガイドを参照してください。

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

@@ -38,6 +38,9 @@ module.exports = {
             type: 'string',
             pattern: '^[0-9]+$',
           },
+          smarthrUiAlias: {
+            type: 'string',
+          },
         },
         required: ['from', 'to'],
         additionalProperties: false,
@@ -90,7 +93,7 @@ module.exports = {
     // 例: v90→v92 なら [v90→v91のチェッカー] を収集
     const checkersList = path.map((stepKey) => {
       const module = VERSION_MODULES[stepKey]
-      return module.createCheckers(context, sourceCode)
+      return module.createCheckers(context, sourceCode, options)
     })
 
     const mergedCheckers = mergeCheckers(checkersList)

package/rules/autofixer-smarthr-ui-migration/versions/v90-to-v91/REFERENCE.md

@@ -77,11 +77,36 @@ module.exports = {
 
 ESLintのセレクターとハンドラーを返す関数です。
 
+**シグネチャ:**
 ```javascript
-createCheckers(context, sourceCode) {
-  return {
+createCheckers(context, sourceCode, options = {})
+```
+
+- `context`: ESLintのcontext
+- `sourceCode`: ESLintのsourceCode
+- `options`: ユーザーが指定したオプション（`smarthrUiAlias`など）
+
+**基本構造:**
+```javascript
+createCheckers(context, sourceCode, options = {}) {
+  // smarthrUiAliasオプションの取得
+  const customSmarthrUiAlias = options.smarthrUiAlias
+  const validSources = ['smarthr-ui']
+  if (customSmarthrUiAlias) {
+    validSources.push(customSmarthrUiAlias)
+  }
+
+  // aliasファイルかどうかの判定
+  const isAliasFile = customSmarthrUiAlias && isFileMatchingSmarthrUiAlias(
+    context.getFilename(),
+    customSmarthrUiAlias
+  )
+
+  const checkers = {
     // インポート文の処理
     ImportDeclaration(node) {
+      // smarthr-ui + smarthrUiAlias の両方をチェック
+      if (!validSources.includes(node.source.value)) return
       // ...
     },
 
@@ -95,6 +120,15 @@ createCheckers(context, sourceCode) {
       // ...
     },
   }
+
+  // aliasファイルの場合のみ、export変数名の置換を追加
+  if (isAliasFile) {
+    checkers['ExportNamedDeclaration > VariableDeclaration > VariableDeclarator'] = function(node) {
+      // export const ActionDialog = ... を置換
+    }
+  }
+
+  return checkers
 }
 ```
 
@@ -156,13 +190,18 @@ function findTargetParent(node, sourceCode) {
 
 ### ✅ 自動修正可能
 
-機械的に100%正しく変換できる場合のみ自動修正を実装します。
+機械的に100%正しく変換できる場合に自動修正を実装します。ただし、実用上は100%の正確性が保証できない場合でも、以下の条件を満たせば自動修正を実装して構いません：
+
+- **実際には使用されていない機能や属性**である可能性が高い
+- 置換することで**利便性が明らかに向上する**
+- 誤った変換が行われても**影響が限定的**である
 
 **例:**
 - コンポーネント名のリネーム（ActionDialog → ControlledActionDialog）
 - 属性名のリネーム（type → status）
 - 属性の削除（値が変わらない場合）
 - **未知の属性を保持したまま移行可能な場合**（Text → span など、移行先が明確な置換）
+- **理論的には100%正しくないが、実用上問題ない場合**（使用頻度が極めて低い機能の置換など）
 
 ### ⚠️ エラーのみ（自動修正なし）
 
@@ -437,6 +476,200 @@ function hasUnknownAttributes(node, ...knownAttrs) {
 - **属性の移行先が明確** → パターンA（未知の属性も保持して自動修正）
 - **属性の移行先が不明確** → パターンB（エラーのみ、手動対応）
 
+### パターン6: smarthrUiAlias オプションへの対応
+
+プロジェクト固有のsmarthr-ui aliasパスに対応するため、`smarthrUiAlias`オプションを利用します。
+
+#### validSourcesの拡張
+
+`smarthr-ui`に加えて、aliasパスからのimportもチェック対象にします。
+
+```javascript
+createCheckers(context, sourceCode, options = {}) {
+  const customSmarthrUiAlias = options.smarthrUiAlias
+  const validSources = ['smarthr-ui']
+  if (customSmarthrUiAlias) {
+    validSources.push(customSmarthrUiAlias)
+  }
+
+  return {
+    ImportDeclaration(node) {
+      // smarthr-ui または @/components/parts/smarthr-ui からのimport
+      if (!validSources.includes(node.source.value)) return
+
+      // ...置換処理
+    }
+  }
+}
+```
+
+#### aliasファイル内のexport変数名置換
+
+aliasディレクトリ配下のファイルで、smarthr-uiコンポーネント名と同じ変数名をexportしている場合に置換します。
+
+```javascript
+// aliasファイルかどうかの判定
+const isAliasFile = customSmarthrUiAlias && isFileMatchingSmarthrUiAlias(
+  context.getFilename(),
+  customSmarthrUiAlias
+)
+
+const checkers = {
+  // ... 通常のチェッカー
+}
+
+// aliasファイルの場合のみ、export変数名の置換を追加
+if (isAliasFile) {
+  checkers['ExportNamedDeclaration > VariableDeclaration > VariableDeclarator'] = function(node) {
+    const variableName = node.id.name
+    const newName = DIALOG_COMPONENTS[variableName]
+
+    if (newName) {
+      context.report({
+        node: node.id,
+        messageId: 'renameDialog',
+        data: { old: variableName, new: newName, to: TARGET_VERSION },
+        fix(fixer) {
+          return fixer.replaceText(node.id, newName)
+        },
+      })
+    }
+  }
+}
+
+return checkers
+```
+
+#### ファイルパスのマッチング（ヘルパー関数）
+
+```javascript
+const { rootPath } = require('../../../../libs/common')
+
+function isFileMatchingSmarthrUiAlias(filename, smarthrUiAlias) {
+  // rootPathを使って絶対パスで比較を試みる
+  const resolved = smarthrUiAlias.replace(/^@\//, `${rootPath}/`)
+  if (filename.includes(resolved)) {
+    return true
+  }
+
+  // rootPathでマッチしない場合:
+  // パスの一部としてマッチング（テスト環境などで使用）
+  const pathPart = smarthrUiAlias.replace(/^@\//, '').replace(/^~\//, '')
+
+  // 以下のパターンにマッチング:
+  // 1. ディレクトリ形式: /components/parts/smarthr-ui/index.tsx
+  // 2. 個別ファイル: /components/parts/smarthr-ui/ActionDialog.tsx
+  // 3. 単一ファイル形式: /components/parts/smarthr-ui.tsx
+  return (
+    filename.includes(`/${pathPart}/`) ||
+    filename.endsWith(`/${pathPart}`) ||
+    filename.includes(`/${pathPart}.`)
+  )
+}
+```
+
+**このパターンが適用されるケース:**
+- **barrel import構造**: `@/components/parts/smarthr-ui/index.tsx` + 個別ファイル
+- **個別ファイルのみ**: `@/components/parts/smarthr-ui/ActionDialog.tsx` など
+- **単一ファイル形式**: `@/components/parts/smarthr-ui.tsx` （ディレクトリではなく1つのファイル）
+
+**ポイント:**
+- importチェックは`validSources`で拡張
+- export変数名の置換は`isAliasFile`条件付きで追加
+- サブディレクトリも含めてマッチング（`filename.includes(resolved)`）
+- 単一ファイル形式にも対応（`filename.includes(\`/\${pathPart}.\`)`）
+
+### パターン7: aliasファイル名の変更チェック
+
+aliasファイルのファイル名が変更対象のコンポーネント名と一致する場合、ファイル名の変更を促すエラーを表示します。
+
+```javascript
+checkers.Program = function(node) {
+  if (!isAliasFile) return
+
+  // ファイル名からコンポーネント名を抽出（拡張子を除く）
+  const fileBasename = filename.split('/').pop() || ''
+  const componentName = fileBasename.replace(/\.(tsx?|jsx?)$/, '')
+
+  // Dialog系コンポーネント名と一致するかチェック
+  const newName = DIALOG_COMPONENTS[componentName]
+  if (newName) {
+    const oldFile = fileBasename
+    const newFile = fileBasename.replace(componentName, newName)
+
+    context.report({
+      node,
+      messageId: 'renameAliasFile',
+      data: {
+        old: componentName,
+        new: newName,
+        to: TARGET_VERSION,
+        oldFile,
+        newFile,
+      },
+      // fixは提供しない（ファイル名の変更はESLintでは不可能）
+    })
+  }
+}
+```
+
+**このパターンが必要なケース:**
+- aliasファイルのファイル名がコンポーネント名と一致している場合
+- 例: `ActionDialog.tsx` → `ControlledActionDialog.tsx` に変更が必要
+
+**ポイント:**
+- `Program` ノードに対してチェック（ファイルごとに1回だけ実行）
+- ファイル名の変更はESLintでは不可能なので、fix関数は提供しない
+- エラーメッセージに新旧のファイル名を含める
+- export変数名の置換とは別のエラーとして表示される
+
+**エラーメッセージに含める情報:**
+- ファイル名の変更手順（`git mv` の例）
+- ファイル名変更後、import文も更新が必要であることを明記
+
+**注意:**
+- re-export（`export { ActionDialog } from 'smarthr-ui'`）にも対応するため、`ExportNamedDeclaration`チェッカーも実装が必要
+- ファイル名変更後、そのファイルをimportしている箇所も手動で更新する必要がある
+  ```typescript
+  // Before
+  import { FormDialog } from '@/components/parts/smarthr-ui/FormDialog'
+
+  // After (ファイル名変更後)
+  import { ControlledFormDialog } from '@/components/parts/smarthr-ui/ControlledFormDialog'
+  ```
+
+```javascript
+ExportNamedDeclaration(node) {
+  // sourceがない場合（通常のexport）はスキップ
+  if (!node.source) return
+  if (!validSources.includes(node.source.value)) return
+
+  node.specifiers.forEach((specifier) => {
+    if (specifier.type !== 'ExportSpecifier') return
+
+    const exportedName = specifier.exported.name
+    const localName = specifier.local.name
+    const newName = DIALOG_COMPONENTS[localName]
+
+    if (newName) {
+      context.report({
+        node: specifier,
+        messageId: 'renameDialog',
+        data: { old: localName, new: newName, to: TARGET_VERSION },
+        fix(fixer) {
+          // export { ActionDialog } のように local === exported の場合
+          if (localName === exportedName) {
+            return fixer.replaceText(specifier, newName)
+          }
+          // export { ActionDialog as MyDialog } のような場合
+          return fixer.replaceText(specifier.local, newName)
+        },
+      })
+    }
+  })
+}
+```
+
 ## トラブルシューティング
 
 ### Fix objects must not be overlapped

package/rules/autofixer-smarthr-ui-migration/versions/v90-to-v91/index.js

@@ -13,6 +13,8 @@
  * 参考: https://github.com/kufu/smarthr-ui/releases/tag/smarthr-ui-v91.0.0
  */
 
+const { rootPath } = require('../../../../libs/common')
+
 // ============================================================
 // 定数定義
 // ============================================================
@@ -51,10 +53,56 @@ module.exports = {
     migrateResponseMessage: '見出し/ラベル内の ResponseMessage は親コンポーネントの icon 属性に移行してください',
     migrateResponseMessageWithUnknownAttrs: '見出し/ラベル内の ResponseMessage は親コンポーネントの icon 属性に移行してください。status/iconGap 以外の属性（id, onClick など）がある場合は手動で移行してください',
     removeArbitraryDisplayName: 'AppHeader の arbitraryDisplayName 属性は削除されました。email, empCode, firstName, lastName から自動生成されます',
+    renameAliasFile: 'smarthr-ui {{to}} では {{old}} が {{new}} にリネームされました。以下の手順で対応してください: 1. ファイル名を変更（例: git mv {{oldFile}} {{newFile}}）2. このファイルをimportしている箇所を更新（例: from \'@/path/{{old}}\' → from \'@/path/{{new}}\'）',
   },
 
-  createCheckers(context, sourceCode) {
-    return {
+  createCheckers(context, sourceCode, options = {}) {
+    const customSmarthrUiAlias = options.smarthrUiAlias
+    const validSources = ['smarthr-ui']
+    if (customSmarthrUiAlias) {
+      validSources.push(customSmarthrUiAlias)
+    }
+
+    // 現在のファイルがaliasファイルか判定
+    const filename = context.getFilename()
+    const isAliasFile = customSmarthrUiAlias && isFileMatchingSmarthrUiAlias(
+      filename,
+      customSmarthrUiAlias
+    )
+
+    const checkers = {
+      // ============================================================
+      // 0. aliasファイル名の変更チェック
+      // ============================================================
+
+      // aliasファイルの場合、ファイル名も変更を促す
+      Program(node) {
+        if (!isAliasFile) return
+
+        // ファイル名からコンポーネント名を抽出（拡張子を除く）
+        const fileBasename = filename.split('/').pop() || ''
+        const componentName = fileBasename.replace(/\.(tsx?|jsx?)$/, '')
+
+        // Dialog系コンポーネント名と一致するかチェック
+        const newName = DIALOG_COMPONENTS[componentName]
+        if (newName) {
+          const oldFile = fileBasename
+          const newFile = fileBasename.replace(componentName, newName)
+
+          context.report({
+            node,
+            messageId: 'renameAliasFile',
+            data: {
+              old: componentName,
+              new: newName,
+              to: TARGET_VERSION,
+              oldFile,
+              newFile,
+            },
+          })
+        }
+      },
+
       // ============================================================
       // 1. Dialogコンポーネントのリネーム
       // ============================================================
@@ -63,7 +111,7 @@ module.exports = {
       // 例: import { ActionDialog } from 'smarthr-ui'
       //  → import { ControlledActionDialog } from 'smarthr-ui'
       ImportDeclaration(node) {
-        if (node.source.value !== 'smarthr-ui') return
+        if (!validSources.includes(node.source.value)) return
 
         node.specifiers.forEach((specifier) => {
           if (specifier.type !== 'ImportSpecifier') return
@@ -84,6 +132,39 @@ module.exports = {
         })
       },
 
+      // export文での検出と修正（re-export）
+      // 例: export { ActionDialog } from 'smarthr-ui'
+      //  → export { ControlledActionDialog } from 'smarthr-ui'
+      ExportNamedDeclaration(node) {
+        // sourceがない場合（通常のexport）はスキップ
+        if (!node.source) return
+        if (!validSources.includes(node.source.value)) return
+
+        node.specifiers.forEach((specifier) => {
+          if (specifier.type !== 'ExportSpecifier') return
+
+          const exportedName = specifier.exported.name
+          const localName = specifier.local.name
+          const newName = DIALOG_COMPONENTS[localName]
+
+          if (newName) {
+            context.report({
+              node: specifier,
+              messageId: 'renameDialog',
+              data: { old: localName, new: newName, to: TARGET_VERSION },
+              fix(fixer) {
+                // export { ActionDialog } のように local === exported の場合
+                if (localName === exportedName) {
+                  return fixer.replaceText(specifier, newName)
+                }
+                // export { ActionDialog as MyDialog } のような場合
+                return fixer.replaceText(specifier.local, newName)
+              },
+            })
+          }
+        })
+      },
+
       // JSX要素での検出と修正
       // 例: <ActionDialog>...</ActionDialog>
       //  → <ControlledActionDialog>...</ControlledActionDialog>
@@ -467,5 +548,60 @@ module.exports = {
         return fixer.replaceText(attr.value, newValue)
       }
     }
+
+    // ============================================================
+    // aliasファイル内のexport変数名の置換
+    // ============================================================
+
+    // aliasファイルの場合のみ、export変数名を置換
+    if (isAliasFile) {
+      checkers['ExportNamedDeclaration > VariableDeclaration > VariableDeclarator'] = function (node) {
+        const variableName = node.id.name
+        const newName = DIALOG_COMPONENTS[variableName]
+
+        if (newName) {
+          context.report({
+            node: node.id,
+            messageId: 'renameDialog',
+            data: { old: variableName, new: newName, to: TARGET_VERSION },
+            fix(fixer) {
+              return fixer.replaceText(node.id, newName)
+            },
+          })
+        }
+      }
+    }
+
+    return checkers
   },
 }
+
+/**
+ * smarthrUiAliasで指定されたパスと現在のファイルパスがマッチするか判定
+ *
+ * @param {string} filename - 現在処理中のファイルパス
+ * @param {string} smarthrUiAlias - smarthrUiAliasオプションの値（例: '@/components/parts/smarthr-ui'）
+ * @returns {boolean} マッチする場合true
+ */
+function isFileMatchingSmarthrUiAlias(filename, smarthrUiAlias) {
+  // rootPathを使って絶対パスで比較を試みる
+  const resolved = smarthrUiAlias.replace(/^@\//, `${rootPath}/`)
+  if (filename.includes(resolved)) {
+    return true
+  }
+
+  // rootPathでマッチしない場合:
+  // パスの一部としてマッチング（テスト環境などで使用）
+  // 例: '@/components/parts/smarthr-ui' -> 'components/parts/smarthr-ui'
+  const pathPart = smarthrUiAlias.replace(/^@\//, '').replace(/^~\//, '')
+
+  // 以下のパターンにマッチング:
+  // 1. ディレクトリ形式: /components/parts/smarthr-ui/index.tsx
+  // 2. 個別ファイル: /components/parts/smarthr-ui/ActionDialog.tsx
+  // 3. 単一ファイル形式: /components/parts/smarthr-ui.tsx
+  return (
+    filename.includes(`/${pathPart}/`) ||
+    filename.endsWith(`/${pathPart}`) ||
+    filename.includes(`/${pathPart}.`)
+  )
+}

package/rules/autofixer-smarthr-ui-migration/versions/v90-to-v91/test.js

@@ -48,6 +48,43 @@ module.exports = {
     { code: `<ResponseMessage status="success">Xxxx</ResponseMessage>`, options: v90ToV91Options },
     { code: `<Heading icon={{ prefix: <FaCheckIcon />, gap: 0.5 }}>Xxxx</Heading>`, options: v90ToV91Options },
     { code: `<AppHeader email="test@example.com" />`, options: v90ToV91Options },
+
+    // smarthrUiAliasオプション: aliasファイル外では置換しない
+    {
+      code: `export const ActionDialog = (props) => <div>{props.children}</div>`,
+      filename: '/Users/test/src/features/custom/ActionDialog.tsx',
+      options: [{ from: '90', to: '91', smarthrUiAlias: '@/components/parts/smarthr-ui' }],
+    },
+
+    // smarthrUiAliasオプション: v91形式は正常
+    {
+      code: `import { ControlledActionDialog } from '@/components/parts/smarthr-ui'`,
+      options: [{ from: '90', to: '91', smarthrUiAlias: '@/components/parts/smarthr-ui' }],
+    },
+    {
+      code: `export const ControlledActionDialog = (props) => <div>{props.children}</div>`,
+      filename: '/Users/test/src/components/parts/smarthr-ui/ControlledActionDialog.tsx',
+      options: [{ from: '90', to: '91', smarthrUiAlias: '@/components/parts/smarthr-ui' }],
+    },
+
+    // smarthrUiAliasオプション: カスタム名のexportは置換しない
+    {
+      code: `export const MyActionDialog = (props) => <div>{props.children}</div>`,
+      filename: '/Users/test/src/components/parts/smarthr-ui/MyActionDialog.tsx',
+      options: [{ from: '90', to: '91', smarthrUiAlias: '@/components/parts/smarthr-ui' }],
+    },
+    {
+      code: `export const CustomDialog = (props) => <div>{props.children}</div>`,
+      filename: '/Users/test/src/components/parts/smarthr-ui/CustomDialog.tsx',
+      options: [{ from: '90', to: '91', smarthrUiAlias: '@/components/parts/smarthr-ui' }],
+    },
+
+    // smarthrUiAliasオプション: 単一ファイル形式でもv91形式は正常
+    {
+      code: `export const ControlledFormDialog = (props) => <div>{props.children}</div>`,
+      filename: '/Users/test/src/components/parts/smarthr-ui.tsx',
+      options: [{ from: '90', to: '91', smarthrUiAlias: '@/components/parts/smarthr-ui' }],
+    },
   ],
 
   invalid: [
@@ -217,5 +254,80 @@ module.exports = {
       options: v90ToV91Options,
       errors: [{ messageId: 'removeArbitraryDisplayName' }],
     },
+
+    // ============================================================
+    // 6. smarthrUiAliasオプション
+    // ============================================================
+    // aliasからのimport
+    {
+      code: `import { ActionDialog } from '@/components/parts/smarthr-ui'`,
+      output: `import { ControlledActionDialog } from '@/components/parts/smarthr-ui'`,
+      options: [{ from: '90', to: '91', smarthrUiAlias: '@/components/parts/smarthr-ui' }],
+      errors: [{ messageId: 'renameDialog', data: { old: 'ActionDialog', new: 'ControlledActionDialog', to: 'v91' } }],
+    },
+    // aliasファイル内のexport変数名置換（index.tsx）
+    {
+      code: `export const FormDialog = (props) => <div>{props.children}</div>`,
+      output: `export const ControlledFormDialog = (props) => <div>{props.children}</div>`,
+      filename: '/Users/test/src/components/parts/smarthr-ui/index.tsx',
+      options: [{ from: '90', to: '91', smarthrUiAlias: '@/components/parts/smarthr-ui' }],
+      errors: [{ messageId: 'renameDialog', data: { old: 'FormDialog', new: 'ControlledFormDialog', to: 'v91' } }],
+    },
+    // barrel import: smarthr-uiからimport + export（個別ファイル）
+    {
+      code: `import { ActionDialog as ShrActionDialog } from 'smarthr-ui'\nexport const ActionDialog = (props) => <ShrActionDialog {...props} />`,
+      output: `import { ControlledActionDialog as ShrActionDialog } from 'smarthr-ui'\nexport const ControlledActionDialog = (props) => <ShrActionDialog {...props} />`,
+      filename: '/Users/test/src/components/parts/smarthr-ui/ActionDialog.tsx',
+      options: [{ from: '90', to: '91', smarthrUiAlias: '@/components/parts/smarthr-ui' }],
+      errors: [
+        { messageId: 'renameAliasFile', data: { old: 'ActionDialog', new: 'ControlledActionDialog', to: 'v91', oldFile: 'ActionDialog.tsx', newFile: 'ControlledActionDialog.tsx' } },
+        { messageId: 'renameDialog', data: { old: 'ActionDialog', new: 'ControlledActionDialog', to: 'v91' } },
+        { messageId: 'renameDialog', data: { old: 'ActionDialog', new: 'ControlledActionDialog', to: 'v91' } },
+      ],
+    },
+    // サブディレクトリ内のファイルも対象
+    {
+      code: `export const MessageDialog = (props) => <div>{props.children}</div>`,
+      output: `export const ControlledMessageDialog = (props) => <div>{props.children}</div>`,
+      filename: '/Users/test/src/components/parts/smarthr-ui/dialogs/MessageDialog.tsx',
+      options: [{ from: '90', to: '91', smarthrUiAlias: '@/components/parts/smarthr-ui' }],
+      errors: [
+        { messageId: 'renameAliasFile', data: { old: 'MessageDialog', new: 'ControlledMessageDialog', to: 'v91', oldFile: 'MessageDialog.tsx', newFile: 'ControlledMessageDialog.tsx' } },
+        { messageId: 'renameDialog', data: { old: 'MessageDialog', new: 'ControlledMessageDialog', to: 'v91' } },
+      ],
+    },
+    // 単一ファイル形式も対象
+    {
+      code: `export const FormDialog = (props) => <div>{props.children}</div>`,
+      output: `export const ControlledFormDialog = (props) => <div>{props.children}</div>`,
+      filename: '/Users/test/src/components/parts/smarthr-ui.tsx',
+      options: [{ from: '90', to: '91', smarthrUiAlias: '@/components/parts/smarthr-ui' }],
+      errors: [{ messageId: 'renameDialog', data: { old: 'FormDialog', new: 'ControlledFormDialog', to: 'v91' } }],
+    },
+
+    // ============================================================
+    // 7. aliasファイル名の変更
+    // ============================================================
+    // ファイル名がDialog系コンポーネント名の場合、ファイル名変更を促す
+    {
+      code: `// ActionDialog.tsx\nexport { ActionDialog } from 'smarthr-ui'`,
+      output: `// ActionDialog.tsx\nexport { ControlledActionDialog } from 'smarthr-ui'`,
+      filename: '/Users/test/src/components/parts/smarthr-ui/ActionDialog.tsx',
+      options: [{ from: '90', to: '91', smarthrUiAlias: '@/components/parts/smarthr-ui' }],
+      errors: [
+        { messageId: 'renameAliasFile', data: { old: 'ActionDialog', new: 'ControlledActionDialog', to: 'v91', oldFile: 'ActionDialog.tsx', newFile: 'ControlledActionDialog.tsx' } },
+        { messageId: 'renameDialog', data: { old: 'ActionDialog', new: 'ControlledActionDialog', to: 'v91' } },
+      ],
+    },
+    {
+      code: `// FormDialog.tsx\nconst foo = 'bar'`,
+      output: null,
+      filename: '/Users/test/src/components/parts/smarthr-ui/FormDialog.tsx',
+      options: [{ from: '90', to: '91', smarthrUiAlias: '@/components/parts/smarthr-ui' }],
+      errors: [
+        { messageId: 'renameAliasFile', data: { old: 'FormDialog', new: 'ControlledFormDialog', to: 'v91', oldFile: 'FormDialog.tsx', newFile: 'ControlledFormDialog.tsx' } },
+      ],
+    },
+
   ],
 }

package/rules/best-practice-for-text-component/index.js

@@ -177,16 +177,37 @@ module.exports = {
       // パターン2-1: classNameのみ（asなし）、Text属性なし、shr-クラスあり
       [SELECTOR_CONVERTIBLE_SHR_TO_PROPS]: (classNameAttrNode) => {
         const { nonConvertible, propSuggestions, convertible } = categorizeClassNames(classNameAttrNode)
+        const openingElement = classNameAttrNode.parent
+        const jsxElement = openingElement.parent
+
+        // 変換可能なクラスが0個の場合、spanに変換（パターン1-3と同じ動作）
+        if (!propSuggestions) {
+          const classNameText = `className="${classNameAttrNode.value.value}"`
+          context.report({
+            node: openingElement,
+            message: `Textコンポーネントの機能を使用していないため、ネイティブHTML要素（<span>）に置き換えてください。
+ - 詳細: https://github.com/kufu/tamatebako/tree/master/packages/eslint-plugin-smarthr/rules/best-practice-for-text-component
+ - 推奨: <span ${classNameText}>
+ - Textコンポーネントの機能（weight、size、color等）を使用しない場合は、直接HTML要素を使用することでシンプルになります`,
+            fix(fixer) {
+              return [
+                fixer.replaceText(openingElement.name, 'span'),
+                fixer.replaceText(jsxElement.closingElement.name, 'span')
+              ]
+            },
+          })
+          return
+        }
 
+        // 変換可能なクラスがある場合、属性に変換
         context.report({
-          node: classNameAttrNode.parent,
+          node: openingElement,
           message: `classNameで指定されたshr-プレフィックスのクラスは、Textコンポーネントの属性に置き換えてください。
  - 詳細: https://github.com/kufu/tamatebako/tree/master/packages/eslint-plugin-smarthr/rules/best-practice-for-text-component
  - 推奨: <Text ${propSuggestions}${nonConvertible ? ` className="${nonConvertible}"` : ''}>
  - 変換可能なクラス: ${convertible}
  - shr-プレフィックスのクラスをTextの属性に置き換えることで、型安全性が向上し、意図がより明確になります`,
           fix(fixer) {
-            const openingElement = classNameAttrNode.parent
             const sourceCode = context.sourceCode || context.getSourceCode()
             const fixes = []
 
@@ -235,8 +256,39 @@ module.exports = {
       [SELECTOR_CONVERTIBLE_SHR_TO_PROPS_WITH_AS]: (classNameAttrNode) => {
         const { nonConvertible, propSuggestions, convertible } = categorizeClassNames(classNameAttrNode)
         const openingElement = classNameAttrNode.parent
+        const jsxElement = openingElement.parent
         const asValue = getAttributeLiteralValue(openingElement, 'as')
 
+        // 変換可能なクラスが0個の場合、as属性で指定されたタグに変換（パターン1-4と同じ動作）
+        if (!propSuggestions) {
+          const classNameValue = getAttributeLiteralValue(openingElement, 'className')
+          const classNameText = `className="${classNameValue}"`
+          context.report({
+            node: openingElement,
+            message: `Textコンポーネントの機能を使用していないため、ネイティブHTML要素に置き換えてください。
+ - 詳細: https://github.com/kufu/tamatebako/tree/master/packages/eslint-plugin-smarthr/rules/best-practice-for-text-component
+ - <${asValue}>要素にclassNameを移動してください
+ - Textコンポーネントの機能（weight、size、color等）を使用しない場合は、直接HTML要素を使用することでシンプルになります`,
+            fix(fixer) {
+              const sourceCode = context.sourceCode || context.getSourceCode()
+              const asAttrNode = getAttributeNode(openingElement, 'as')
+
+              // 属性とその前のスペースを含めて削除
+              const tokenBefore = sourceCode.getTokenBefore(asAttrNode)
+              const rangeStart = tokenBefore.range[1]
+              const rangeEnd = asAttrNode.range[1]
+
+              return [
+                fixer.removeRange([rangeStart, rangeEnd]),
+                fixer.replaceText(openingElement.name, asValue),
+                fixer.replaceText(jsxElement.closingElement.name, asValue)
+              ]
+            },
+          })
+          return
+        }
+
+        // 変換可能なクラスがある場合、属性に変換
         context.report({
           node: openingElement,
           message: `classNameで指定されたshr-プレフィックスのクラスは、Textコンポーネントの属性に置き換えてください。

package/test/best-practice-for-text-component.js

@@ -105,6 +105,11 @@ ruleTester.run('best-practice-for-text-component', rule, {
     { code: `<Text as="p" className="shr-text-sm custom-class">text</Text>`, output: `<Text as="p" size="S" className="custom-class">text</Text>`, errors: [{ message: errorConvertibleShr('size="S" className="custom-class"', 'shr-text-sm', 'p') }] },
     { code: `<Text className="shr-text-lg shr-font-bold custom-one custom-two">text</Text>`, output: `<Text size="L" weight="bold" className="custom-one custom-two">text</Text>`, errors: [{ message: errorConvertibleShr('size="L" weight="bold" className="custom-one custom-two"', 'shr-text-lg, shr-font-bold') }] },
 
+    // パターン2-4: shr-プレフィックスがあるが変換不可能なクラスのみ（spanに変換）
+    { code: `<Text className="shr-w-[10rem]">text</Text>`, output: `<span className="shr-w-[10rem]">text</span>`, errors: [{ message: errorUnnecessaryClassName('shr-w-[10rem]') }] },
+    { code: `<Text className="shr-inline-block shr-mr-0.5">text</Text>`, output: `<span className="shr-inline-block shr-mr-0.5">text</span>`, errors: [{ message: errorUnnecessaryClassName('shr-inline-block shr-mr-0.5') }] },
+    { code: `<Text as="p" className="shr-bg-background shr-block">text</Text>`, output: `<p className="shr-bg-background shr-block">text</p>`, errors: [{ message: errorUnnecessaryAsClassName('p') }] },
+
     // パターン3: 属性とclassNameの矛盾
     { code: `<Text size="M" className="shr-text-sm">text</Text>`, errors: [{ message: errorConflictingProps('shr-text-sm') }] },
     { code: `<Text weight="bold" className="shr-font-normal">text</Text>`, errors: [{ message: errorConflictingProps('shr-font-normal') }] },