eslint-plugin-smarthr 6.11.0 → 6.12.0

package/CHANGELOG.md

@@ -2,6 +2,18 @@
 
 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.12.0](https://github.com/kufu/tamatebako/compare/eslint-plugin-smarthr-v6.11.0...eslint-plugin-smarthr-v6.12.0) (2026-04-15)
+
+
+### Features
+
+* **require-barrel-import:** additionalBarrelFileNamesオプション追加と同階層・子階層からのバレルimport禁止 ([#1244](https://github.com/kufu/tamatebako/issues/1244)) ([b38a143](https://github.com/kufu/tamatebako/commit/b38a1432a92bd3ee4e52f3a450177e59f65512f0))
+
+
+### Bug Fixes
+
+* **format-import-path:** dirCount関数でmatch結果がnullの場合のエラーを修正 ([#1246](https://github.com/kufu/tamatebako/issues/1246)) ([fc50fba](https://github.com/kufu/tamatebako/commit/fc50fbadc3da3b046a73bbab664c281fc7be847f))
+
 ## [6.11.0](https://github.com/kufu/tamatebako/compare/eslint-plugin-smarthr-v6.10.4...eslint-plugin-smarthr-v6.11.0) (2026-04-14)
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "eslint-plugin-smarthr",
-  "version": "6.11.0",
+  "version": "6.12.0",
   "author": "SmartHR",
   "license": "MIT",
   "description": "A sharable ESLint plugin for SmartHR",
@@ -34,5 +34,5 @@
     "eslintplugin",
     "smarthr"
   ],
-  "gitHead": "17b3e279b5cf8ffeef90d1eccce77101c7b68cba"
+  "gitHead": "ae65de908cf0b81ad201a18e376bb500a9bd7842"
 }

package/rules/format-import-path/index.js

@@ -28,7 +28,11 @@ const DIR_SEPARATE_REGEX = /\//g
 const MULTIPLE_DIR_SEPARATE_REGEX =/(\/)+/g
 const TRAILING_SLASH_REGEX = /^(.+?)\/$/
 
-const dirCount = (dir) => dir.match(DIR_SEPARATE_REGEX).length
+const dirCount = (dir) => {
+  if (!dir) return 0
+  const matches = dir.match(DIR_SEPARATE_REGEX)
+  return matches ? matches.length : 0
+}
 
 const convertType = (calcContext, calcDomainNode) => {
   const { option: { format: { all, outside, globalModule, module, domain, lower } } } = calcContext

package/rules/require-barrel-import/README.md

@@ -24,6 +24,49 @@ barrelを経由することで、内部のファイル構成を変更しても
 
 例えば、`Page/parts/Menu/Item` を `Page/parts/Menu` から importすることで、import文がより簡潔で読みやすくなります。
 
+## 同階層・子階層からのバレルimportの禁止
+
+バレルファイル（index.ts、client.ts等）と同じディレクトリまたは子ディレクトリ内からバレルファイルをimportすることを禁止します。
+
+### なぜ禁止する必要があるのか
+
+バレルファイルは**ディレクトリ外部**へのエクスポート専用として設計されています。同じディレクトリ内や子ディレクトリからバレルファイルをimportすると、以下の問題が発生します：
+
+1. **循環参照のリスク**: バレルファイルが内部のファイルをexportし、その内部ファイルがバレルファイルをimportする循環が発生しやすい
+2. **カプセル化の崩壊**: バレルファイルは外部向けAPIであり、内部からimportすると内部実装の境界が曖昧になる
+3. **不要な依存**: 直接相対パスでimportできるものをバレル経由でimportすることは冗長
+
+### ❌ 検出されるエラーケース
+
+```typescript
+// src/components/Button/Button.tsx から同じディレクトリのバレルをimport
+import { ButtonProps } from '.'          // NG
+import { ButtonProps } from './index'    // NG
+import { ButtonProps } from '@/components/Button'  // NG
+
+// src/components/Button/_utils/helper.ts から親のバレルをimport
+import { Button } from '..'              // NG
+import { Button } from '../index'        // NG
+import { Button } from '@/components/Button'  // NG
+
+// client.ts を使用している場合
+import { ButtonPresentation } from './client'  // NG
+```
+
+### ✅ 正しいimport方法
+
+```typescript
+// 同じディレクトリ内では直接相対パスを使用
+import { ButtonProps } from './types'    // OK
+
+// 親ディレクトリのファイルも直接相対パスを使用
+import { buttonUtils } from '../utils'   // OK
+
+// バレルファイルは外部ディレクトリからのみimport
+// src/pages/HomePage.tsx から
+import { Button } from '@/components/Button'  // OK
+```
+
 ## config
 
 ### 必須設定
@@ -43,6 +86,95 @@ tsconfig.json の compilerOptions.pathsに `@/*` もしくは `~/*` としてroo
 
 特定のファイルから特定のimportを許可する設定を記述できます。
 
+### additionalBarrelFileNames
+
+`index` 以外にbarrelファイルとして扱うファイル名を配列で指定します（拡張子なし）。
+
+Next.jsなどで使用される `client.ts` をbarrelファイルとして扱いたい場合に使用します。
+
+- デフォルト: `[]`（`index.*` のみがbarrelファイル）
+- 例: `['client']` を指定すると、`client.ts`, `client.tsx` などもbarrelファイルとして扱われます
+- 複数指定も可能: `['client', 'server']` を指定すると、`server.ts`, `server.tsx` なども追加されます
+
+#### 優先順位とチェックルール
+
+**1. 同じディレクトリ内に複数のbarrelがある場合**
+- `client.ts` と `index.ts` が両方ある場合、どちらからのimportも許容されます
+- 例: `import { Foo } from './api'` も `import { Foo } from './api/client'` もOK
+
+**2. 同じファイル名の場合は親を優先**
+
+探索により同じファイル名のbarrelが複数見つかった場合（例: `client.ts`同士、`index.ts`同士）、より親のbarrelを推奨します。
+
+```typescript
+// 例: 同じファイル名の場合（index同士）
+route/
+  index.ts  ← より親を推奨
+  edit/
+    index.ts
+
+// import { Foo } from './route/edit/Foo'
+// → route/index.ts を推奨（より親のbarrel）
+```
+
+**index.ts経由のre-export対応:**
+
+子で`index.ts`を見つけた場合でも、親方向に`client.ts`があれば、そちらを優先します。
+
+```typescript
+// 子が index.ts、親が client.ts のパターン
+route/
+  client.ts  ← これを推奨
+  edit/
+    index.ts
+
+// import { Foo } from './route/edit/Foo'
+// → route/client.ts を推奨（親のclient.tsが見つかった）
+
+// この場合、route/client.ts で edit/index.ts をre-exportする想定：
+// route/client.ts
+export * from './edit'
+```
+
+**3. エラーメッセージの表示**
+
+`additionalBarrelFileNames`が設定されている場合、エラーメッセージには存在しないbarrelファイルも含めて全ての選択肢が表示されます。
+
+```typescript
+// 例: additionalBarrelFileNames: ['client'] 設定時、index.tsのみ存在
+検出されたバレル: @/components/api/index.ts
+現在のimport:      import { fetchUser } from '@/components/api/user'
+推奨されるimport（以下のいずれか）:
+  - import { fetchUser } from '@/components/api' // index.ts
+  - import { fetchUser } from '@/components/api/client' // client.ts (作成が必要)
+
+※ 存在しないバレルファイルは必要に応じて作成してください。
+```
+
+- `index.ts`が優先的に表示されます（常に最初）
+- 存在しないファイルには `(作成が必要)` マークが表示されます
+- 存在しないファイルがある場合、注意メッセージが追加されます
+- 「検出されたバレル」には実際に存在するファイルのみが表示されます
+
+**4. 階層の一貫性チェック**
+
+子ディレクトリで`client.ts`を使用している場合、親ディレクトリにも同名のbarrelを作成することを促します。これにより、プロジェクト全体でbarrel構造の一貫性を保ちます。
+
+```typescript
+// 例: client.tsパターンの一貫性チェック
+route/
+  index.ts  ← client.tsがない
+  edit/
+    client.ts  ← client.tsを使用
+
+// import { Foo } from './route/edit/client'
+// → エラー: route/client.ts を作成して、edit/client のexportをまとめてください
+
+// この場合、以下のようにroute/client.tsを作成する必要があります：
+// route/client.ts
+export * from './edit/client'
+```
+
 ## rules
 
 ```js
@@ -50,13 +182,16 @@ tsconfig.json の compilerOptions.pathsに `@/*` もしくは `~/*` としてroo
   rules: {
     'smarthr/require-barrel-import': [
       'error',
-      // ignores: ['\\/test\\/'], // 除外したいファイルの正規表現
-      // allowedImports: {
-      //   '/any/path/': { // 正規表現でチェックするファイルを指定
-      //     // import制御するファイル (相対パスを指定する場合、.eslintrc.js を基準とする)
-      //     '@/hoge/fuga': true // ['abc', 'def'] と指定すると個別に指定
-      //   }
-      // },
+      {
+        // ignores: ['\\/test\\/'], // 除外したいファイルの正規表現
+        // allowedImports: {
+        //   '/any/path/': { // 正規表現でチェックするファイルを指定
+        //     // import制御するファイル (相対パスを指定する場合、.eslintrc.js を基準とする)
+        //     '@/hoge/fuga': true // ['abc', 'def'] と指定すると個別に指定
+        //   }
+        // },
+        // additionalBarrelFileNames: ['client'], // Next.jsなどでclient.tsをbarrelとして扱う
+      }
     ],
   },
 }

package/rules/require-barrel-import/index.js

@@ -26,6 +26,7 @@ const SCHEMA = [
         additionalProperties: true,
       },
       ignores: { type: 'array', items: { type: 'string' }, default: [] },
+      additionalBarrelFileNames: { type: 'array', items: { type: 'string' }, default: [] },
     },
     additionalProperties: false,
   }
@@ -35,6 +36,7 @@ const CWD = process.cwd()
 const REGEX_UNNECESSARY_SLASH = /(\/)+/g
 const REGEX_ROOT_PATH = new RegExp(`^${rootPath}/index\.`)
 const REGEX_INDEX_FILE = /\/index\.(ts|js)x?$/
+const REGEX_BARREL_FILE_EXT = /\.(ts|js)x?$/
 const TARGET_EXTS = ['ts', 'tsx', 'js', 'jsx']
 
 // Path aliasの情報を事前計算してキャッシュ
@@ -93,17 +95,6 @@ const convertToPathAlias = (absolutePath) => {
   return absolutePath
 }
 
-/**
- * import先がimport元の内部にあるかチェック（同階層・サブディレクトリからのimport）
- * （Next.js App Routerの特殊文字パスにも対応）
- * @param {string} importerDir - import元のディレクトリ
- * @param {string} importedPath - import先のパス
- * @returns {boolean}
- */
-const isImportedInsideImporter = (importerDir, importedPath) => {
-  return importedPath === importerDir || importedPath.startsWith(importerDir + '/')
-}
-
 /**
  * 2つのパスの共通の親ディレクトリを見つける
  * @param {string} path1 - パス1
@@ -122,6 +113,58 @@ const findCommonParent = (path1, path2) => {
   return segments1.slice(0, i).join('/')
 }
 
+/**
+ * 指定されたbarrelファイル名の候補パスを生成する
+ * @param {string} dir - ディレクトリパス
+ * @param {Array<string>} fileNames - barrelファイル名の配列
+ * @returns {Array<string>} パス候補の配列
+ */
+const generateBarrelFilePaths = (dir, fileNames) => {
+  return fileNames.flatMap(name => TARGET_EXTS.map(ext => `${dir}/${name}.${ext}`))
+}
+
+/**
+ * パスからファイル名（拡張子なし）を抽出する
+ * @param {string} filePath - ファイルパス
+ * @returns {string} ファイル名（拡張子なし）
+ */
+const extractFileName = (filePath) => {
+  return filePath.split('/').pop().replace(REGEX_BARREL_FILE_EXT, '')
+}
+
+/**
+ * import先が直接バレルファイルを指しているか検出する
+ * @param {string} importedPath - import先の絶対パス
+ * @param {Array<string>} barrelFileNames - バレルファイル名のリスト（index, client, server等）
+ * @returns {string|undefined} バレルファイルのパス、またはundefined
+ */
+const detectDirectBarrelImport = (importedPath, barrelFileNames) => {
+  // ディレクトリ指定の場合（'.'、'..'、'@/components/Button'など）
+  if (fs.existsSync(importedPath) && fs.statSync(importedPath).isDirectory()) {
+    const indexFile = TARGET_EXTS
+      .map(ext => `${importedPath}/index.${ext}`)
+      .find(f => fs.existsSync(f))
+    return indexFile
+  }
+
+  // ファイル指定の場合（'./index'、'./client'、'@/components/Button/client'など）
+  const fileWithExt = TARGET_EXTS
+    .map(ext => `${importedPath}.${ext}`)
+    .find(f => fs.existsSync(f))
+
+  if (!fileWithExt) {
+    return undefined
+  }
+
+  // バレルファイル名のパターンにマッチするかチェック
+  const barrelPattern = `\\/(${barrelFileNames.join('|')})\\.(ts|tsx|js|jsx)$`
+  if (new RegExp(barrelPattern).test(fileWithExt)) {
+    return fileWithExt
+  }
+
+  return undefined
+}
+
 /**
  * allowedImportsオプションに基づいて、特定のimportが許可されているかチェックする
  * @param {object} node - ImportDeclaration node
@@ -178,39 +221,86 @@ const checkAllowedImports = (node, importerDir, targetAllowedImports, allowedImp
  * import先のパスから親方向に barrel ファイルを探索する
  * @param {string} importedPath - import先の絶対パス
  * @param {string} importerDir - import元のディレクトリ
- * @returns {string|undefined} 見つかったbarrelファイルのパス
+ * @param {Array<string>} additionalBarrelFileNames - 追加でbarrelファイルとして扱うファイル名（拡張子なし、例: ['client', 'server']）
+ * @returns {{ barrelPath: string|undefined, missingBarrel: { fileName: string, parentDir: string }|null }} 見つかったbarrelファイルのパスと、作成すべきbarrelファイル情報
  */
-const findBarrelFile = (importedPath, importerDir) => {
+const findBarrelFile = (importedPath, importerDir, additionalBarrelFileNames = []) => {
   const pathSegments = importedPath.split('/')
   let currentPath = importedPath
-  let barrel = undefined
+  let barrel
+  let missingBarrel = null
+
+  // 優先順位: 追加指定されたファイル名 > index
+  const barrelFileNames = [...additionalBarrelFileNames, 'index']
 
   // import元とimport先の共通の親ディレクトリを見つける
   // 共通の親のbarrelファイルは除外する（同じディレクトリツリー内の相対importには適用されない）
   const commonParent = findCommonParent(importerDir, importedPath)
 
-  // ディレクトリ指定の場合、そのindex.tsを指していることは自明なので一階層上から探索
-  if (fs.existsSync(currentPath) && fs.statSync(currentPath).isDirectory()) {
+  // ディレクトリ指定の場合、またはファイルが存在しない場合は親ディレクトリから探索
+  if (!fs.existsSync(currentPath) || fs.statSync(currentPath).isDirectory()) {
     pathSegments.pop()
     currentPath = pathSegments.join('/')
   }
 
+  // 見つかったbarrelのファイル名を記録
+  // additionalBarrelFileNames（client, server等）が見つかった場合のみ、親方向には同じファイル名のみ探索
+  // index.tsが見つかった場合は、親方向にもadditionalBarrelFileNamesを探し続ける
+  let foundBarrelFileName = null
+
   while (pathSegments.length > 0) {
     // 以下の場合は探索終了
     // 1. 共通の親ディレクトリに到達した場合（commonParent自体のbarrelは除外）
     // 2. いずれかのreplacePathsのルートに到達した場合
-    // 3. import先がimport元の内部にある場合（同階層・サブディレクトリからのimport）
-    if (currentPath === commonParent || ALL_ROOT_PATHS.includes(currentPath) || isImportedInsideImporter(importerDir, currentPath)) {
+    if (currentPath === commonParent || ALL_ROOT_PATHS.includes(currentPath)) {
       break
     }
 
+    // 追加指定されたbarrelファイル（client.ts, server.ts等）が見つかっているか
+    const isAdditionalBarrelFound = foundBarrelFileName && additionalBarrelFileNames.includes(foundBarrelFileName)
+
+    // 探索するファイル名を決定
+    // - まだ見つかっていない、またはindexが見つかった → 全てのbarrelFileNamesを探す
+    // - additionalBarrelFileNames（client, server）が見つかった → 同じファイル名のみ探す
+    const searchFileNames = isAdditionalBarrelFound
+      ? [foundBarrelFileName]
+      : barrelFileNames
+
     // 現在のパスにbarrelファイルがあるかチェック
-    const foundBarrel = TARGET_EXTS
-      .map(ext => `${currentPath}/index.${ext}`)
+    const foundBarrel = generateBarrelFilePaths(currentPath, searchFileNames)
       .find(filePath => fs.existsSync(filePath))
 
     if (foundBarrel) {
-      barrel = foundBarrel
+      const fileName = extractFileName(foundBarrel)
+
+      if (!foundBarrelFileName) {
+        // 最初に見つかったbarrel
+        barrel = foundBarrel
+        foundBarrelFileName = fileName
+      } else if (fileName === foundBarrelFileName) {
+        // 同じファイル名の場合は、より親を優先（上書き）
+        barrel = foundBarrel
+      } else if (isAdditionalBarrelFound && fileName === 'index') {
+        // client.tsを探していたが、親でindex.tsしか見つからなかった場合
+        // client.tsを作成してexportをまとめるよう促す
+        missingBarrel = {
+          fileName: foundBarrelFileName,
+          parentDir: currentPath,
+        }
+      }
+      // 異なるファイル名の場合は上書きしない（最も近いbarrelを維持）
+    } else if (isAdditionalBarrelFound) {
+      // client.tsを探していたが見つからなかった場合、index.tsがあるかチェック
+      const indexBarrel = generateBarrelFilePaths(currentPath, ['index'])
+        .find(filePath => fs.existsSync(filePath))
+
+      if (indexBarrel && !missingBarrel) {
+        // index.tsは見つかったが、client.tsがない
+        missingBarrel = {
+          fileName: foundBarrelFileName,
+          parentDir: currentPath,
+        }
+      }
     }
 
     // 一階層上に移動
@@ -218,7 +308,7 @@ const findBarrelFile = (importedPath, importerDir) => {
     currentPath = pathSegments.join('/')
   }
 
-  return barrel
+  return { barrelPath: barrel, missingBarrel }
 }
 
 /**
@@ -234,9 +324,8 @@ module.exports = {
 
     // ignoresオプションでスキップ対象のファイルかチェック
     if (option.ignores) {
-      const isIgnored = option.ignores.some(pattern =>
-        new RegExp(pattern).test(context.filename)
-      )
+      const ignorePatterns = option.ignores.map(pattern => new RegExp(pattern))
+      const isIgnored = ignorePatterns.some(regex => regex.test(context.filename))
       if (isIgnored) {
         return {}
       }
@@ -283,24 +372,139 @@ module.exports = {
           return
         }
 
-        // barrel ファイルを探索
-        const barrelPath = findBarrelFile(importedPath, importerDir)
+        // バレルファイル名のリストを作成（index + 追加指定されたファイル名）
+        const additionalBarrelFileNames = option.additionalBarrelFileNames || []
+        const barrelFileNames = [...additionalBarrelFileNames, 'index']
+
+        // ========================================
+        // 同階層・子階層からのバレルimportチェック
+        // ========================================
+        // import文が直接バレルファイル（index.ts、client.ts等）を指している場合、
+        // import元の位置関係をチェックする
+        const directBarrelPath = detectDirectBarrelImport(importedPath, barrelFileNames)
+
+        if (directBarrelPath) {
+          const barrelDir = path.dirname(directBarrelPath)
+
+          // import元がバレルと同階層、またはバレルディレクトリ以下にある場合はNG
+          const isSameLevelOrChild = importerDir === barrelDir || importerDir.startsWith(barrelDir + '/')
+
+          if (isSameLevelOrChild) {
+            const barrelWithAlias = convertToPathAlias(directBarrelPath)
+
+            context.report({
+              node,
+              message: `バレルファイルからのimportは、そのディレクトリ外部からのみ許可されています。
+
+検出されたバレル: ${barrelWithAlias}
+現在のimport:     import from '${node.source.value}'
+
+バレルファイルはディレクトリ外部へのエクスポートにのみ使用してください。
+同じディレクトリまたは子ディレクトリ内では、直接相対パスでimportしてください。
+
+詳細: https://github.com/kufu/tamatebako/tree/master/packages/eslint-plugin-smarthr/rules/require-barrel-import`,
+            })
+            return
+          }
+        }
+
+        // ========================================
+        // バレルファイルを探索
+        // ========================================
+        // import先のパスから親方向にバレルファイルを探索
+        const { barrelPath, missingBarrel } = findBarrelFile(importedPath, importerDir, additionalBarrelFileNames)
 
         // barrel が見つからない、またはroot pathのindex.tsの場合はスキップ
         if (!barrelPath || REGEX_ROOT_PATH.test(barrelPath)) {
           return
         }
 
+        // 親階層でclient.ts/server.tsが見つからず、index.tsのみ見つかった場合
+        // barrelファイル自体からのimportでも一貫性チェックは実行
+        if (missingBarrel) {
+          const missingBarrelWithAlias = convertToPathAlias(`${missingBarrel.parentDir}/${missingBarrel.fileName}`)
+          const existingBarrelWithAlias = convertToPathAlias(barrelPath).replace(REGEX_BARREL_FILE_EXT, '')
+
+          context.report({
+            node,
+            message: `${missingBarrelWithAlias}.ts を作成して、${existingBarrelWithAlias} のexportをまとめてください
+
+親ディレクトリに ${missingBarrel.fileName}.ts が存在しないため、一貫性のあるbarrel構造を保つために作成が必要です。
+
+作成例:
+// ${missingBarrelWithAlias}.ts
+export * from '${existingBarrelWithAlias}'
+
+詳細: https://github.com/kufu/tamatebako/tree/master/packages/eslint-plugin-smarthr/rules/require-barrel-import`,
+          })
+          return
+        }
+
+        // barrelファイル自体、または同じディレクトリの他のbarrelファイルからimportしている場合はスキップ
+        // 同じディレクトリに index.ts と client.ts がある場合、どちらからのimportも許容する
+        const barrelDir = barrelPath.substring(0, barrelPath.lastIndexOf('/'))
+        const allBarrelsInSameDir = generateBarrelFilePaths(barrelDir, barrelFileNames)
+          .filter(filePath => fs.existsSync(filePath))
+
+        const importedPathWithExts = TARGET_EXTS.map(ext => `${importedPath}.${ext}`)
+        const isImportingFromBarrel = importedPathWithExts.some(p => allBarrelsInSameDir.includes(p))
+        if (isImportingFromBarrel) {
+          return
+        }
+
         // barrel パスをPath aliasに変換
         const barrelWithAlias = convertToPathAlias(barrelPath)
-        const barrelDirWithAlias = barrelWithAlias.replace(REGEX_INDEX_FILE, '')
+        // barrelファイルの拡張子を除去（index.ts → ディレクトリパス、client.ts → client）
+        const barrelDirWithAlias = REGEX_INDEX_FILE.test(barrelWithAlias)
+          ? barrelWithAlias.replace(REGEX_INDEX_FILE, '')
+          : barrelWithAlias.replace(REGEX_BARREL_FILE_EXT, '')
         const uniqueDeniedModules = [...new Set(deniedModules.flat())]
 
+        // ========================================
+        // エラーメッセージ生成の準備
+        // ========================================
         // importしているモジュール名を取得
-        const importedModules = node.specifiers
-          .map(s => s.imported?.name || s.local?.name)
-          .filter(Boolean)
-          .join(', ')
+        const importedModules = node.specifiers.reduce((acc, s) => {
+          const name = s.imported?.name || s.local?.name
+          return name ? (acc ? `${acc}, ${name}` : name) : acc
+        }, '')
+
+        // additionalBarrelFileNamesが設定されている場合は、
+        // 存在しないファイルも含めて全ての選択肢を表示する
+        const hasAdditionalBarrels = option?.additionalBarrelFileNames?.length > 0
+
+        // エラーメッセージに表示するbarrelファイルのリストを作成
+        const barrelFilesToShow = hasAdditionalBarrels
+          ? barrelFileNames.map(name => {
+              // 各barrelファイル名について、存在する拡張子を優先、なければ.tsを使用
+              const candidates = TARGET_EXTS.map(ext => `${barrelDir}/${name}.${ext}`)
+              return candidates.find(filePath => fs.existsSync(filePath)) || `${barrelDir}/${name}.ts`
+            })
+          : allBarrelsInSameDir
+
+        // barrelファイルをエラーメッセージ用に変換
+        // （path alias変換、import path生成、存在チェック）
+        const barrelSuggestions = barrelFilesToShow.map(filePath => {
+          const pathWithAlias = convertToPathAlias(filePath)
+          const dirWithAlias = REGEX_INDEX_FILE.test(pathWithAlias)
+            ? pathWithAlias.replace(REGEX_INDEX_FILE, '')
+            : pathWithAlias.replace(REGEX_BARREL_FILE_EXT, '')
+
+          // 元のimport記法（相対パス or path alias）に合わせたimportパスを生成
+          let importPath = dirWithAlias
+          if (node.source.value[0] === '.') {
+            const dirAbsolute = resolvePathAlias(dirWithAlias)
+            const relativePath = path.relative(importerDir, dirAbsolute)
+            importPath = relativePath.startsWith('.') ? relativePath : `./${relativePath}`
+          }
+
+          return {
+            barrelFile: pathWithAlias,
+            importPath,
+            fileName: path.basename(filePath),
+            exists: fs.existsSync(filePath)
+          }
+        })
 
         // 推奨されるimportパスを生成（元の記法に合わせる）
         let suggestedImportPath = barrelDirWithAlias
@@ -311,19 +515,58 @@ module.exports = {
           suggestedImportPath = relativePath.startsWith('.') ? relativePath : `./${relativePath}`
         }
 
+        // ========================================
+        // エラーメッセージを生成
+        // ========================================
+        // barrelファイルが複数ある、またはadditionalBarrelFileNamesが設定されている場合は
+        // 複数選択肢形式で表示（存在しないファイルも含む）
+        const shouldShowAllSuggestions = barrelSuggestions.length > 1 || hasAdditionalBarrels
+
+        let suggestionsMessage = ''
+        if (shouldShowAllSuggestions) {
+          // index.ts を優先的に表示するためにソート
+          const sortedSuggestions = [...barrelSuggestions].sort((a, b) => {
+            const isAIndex = a.fileName.startsWith('index.')
+            const isBIndex = b.fileName.startsWith('index.')
+            if (isAIndex && !isBIndex) return -1
+            if (!isAIndex && isBIndex) return 1
+            return 0
+          })
+
+          suggestionsMessage = '\n推奨されるimport（以下のいずれか）:\n' +
+            sortedSuggestions.map(({ importPath, fileName, exists }) =>
+              `  - import { ${importedModules} } from '${importPath}' // ${fileName}${exists ? '' : ' (作成が必要)'}`
+            ).join('\n')
+
+          // 存在しないファイルがある場合は注意メッセージを追加
+          const missingBarrels = barrelSuggestions.filter(({ exists }) => !exists)
+          if (missingBarrels.length > 0) {
+            suggestionsMessage += '\n\n※ 存在しないバレルファイルは必要に応じて作成してください。'
+          }
+        } else {
+          suggestionsMessage = `\n推奨されるimport:  import { ${importedModules} } from '${suggestedImportPath}'`
+        }
+
+        // 「検出されたバレル」には実際に存在するファイルのみを表示
+        const existingBarrels = barrelSuggestions.filter(({ exists }) => exists)
+        const barrelFilesInfo = existingBarrels.length > 1
+          ? existingBarrels.map(({ barrelFile }) => barrelFile).join(', ')
+          : barrelWithAlias
+
+        // ========================================
         // エラーを報告
+        // ========================================
         context.report({
           node,
           message: uniqueDeniedModules.length
             ? `${uniqueDeniedModules.join(', ')} は ${barrelDirWithAlias} からimportしてください`
             : `バレルファイルを経由してimportしてください
 
-検出されたバレル: ${barrelWithAlias}
-現在のimport:      import { ${importedModules} } from '${node.source.value}'
-推奨されるimport:  import { ${importedModules} } from '${suggestedImportPath}'
+検出されたバレル: ${barrelFilesInfo}
+現在のimport:      import { ${importedModules} } from '${node.source.value}'${suggestionsMessage}
 
 注意: バレルファイルに ${importedModules} のexportが必要です。
-      存在しない場合は ${path.basename(barrelPath)} に追加してください。
+      存在しない場合は対象のファイルに追加してください。
 
 詳細: https://github.com/kufu/tamatebako/tree/master/packages/eslint-plugin-smarthr/rules/require-barrel-import`,
         })

package/test/require-barrel-import.js

@@ -90,6 +90,89 @@ ruleTester.run('require-barrel-import', rule, {
       })(),
     },
 
+    // additionalBarrelFileNames - client.tsからimport（エラーにならない）
+    {
+      code: `import { fetchUser } from './api/client'`,
+      filename: (() => {
+        createFixture('barrel-file-names-valid', {
+          'components': {
+            'Page.tsx': '',
+            'api': {
+              'client.ts': 'export {}',
+              'user.ts': '',
+            },
+          },
+        })
+        return `${fixturesRoot}/barrel-file-names-valid/components/Page.tsx`
+      })(),
+      options: [
+        {
+          additionalBarrelFileNames: ['client', 'server'],
+        },
+      ],
+    },
+
+    // additionalBarrelFileNames - 同じディレクトリにindex.tsとclient.tsがある場合、index.tsからimportもOK
+    {
+      code: `import { fetchUser } from './api'`,
+      filename: (() => {
+        createFixture('barrel-file-names-both-index', {
+          'components': {
+            'Page.tsx': '',
+            'api': {
+              'index.ts': 'export {}',
+              'client.ts': 'export {}',
+              'user.ts': '',
+            },
+          },
+        })
+        return `${fixturesRoot}/barrel-file-names-both-index/components/Page.tsx`
+      })(),
+      options: [
+        {
+          additionalBarrelFileNames: ['client', 'server'],
+        },
+      ],
+    },
+
+    // additionalBarrelFileNames - 同じディレクトリにindex.tsとclient.tsがある場合、client.tsからimportもOK
+    {
+      code: `import { fetchUser } from './api/client'`,
+      filename: (() => {
+        createFixture('barrel-file-names-both-client', {
+          'components': {
+            'Page.tsx': '',
+            'api': {
+              'index.ts': 'export {}',
+              'client.ts': 'export {}',
+              'user.ts': '',
+            },
+          },
+        })
+        return `${fixturesRoot}/barrel-file-names-both-client/components/Page.tsx`
+      })(),
+      options: [
+        {
+          additionalBarrelFileNames: ['client', 'server'],
+        },
+      ],
+    },
+
+    // 同じディレクトリで非バレルファイルをimport（エラーにならない）
+    {
+      code: `import { ButtonProps } from './types'`,
+      filename: (() => {
+        createFixture('same-dir-non-barrel', {
+          'Button': {
+            'index.tsx': 'export {}',
+            'Button.tsx': '',
+            'types.ts': '',
+          },
+        })
+        return `${fixturesRoot}/same-dir-non-barrel/Button/Button.tsx`
+      })(),
+    },
+
     // Next.js App Router特殊文字パス - 同階層import
     {
       code: `import { useUsers } from './hooks/useUsers'`,
@@ -391,5 +474,529 @@ ruleTester.run('require-barrel-import', rule, {
         },
       ],
     },
+
+    // additionalBarrelFileNames - index.tsとclient.tsが両方ある場合、複数の選択肢を表示
+    {
+      code: `import { fetchUser } from './api/user'`,
+      filename: (() => {
+        createFixture('barrel-file-names-multiple-options', {
+          'components': {
+            'Page.tsx': '',
+            'api': {
+              'index.ts': 'export {}',
+              'client.ts': 'export {}',
+              'user.ts': '',
+            },
+          },
+        })
+        return `${fixturesRoot}/barrel-file-names-multiple-options/components/Page.tsx`
+      })(),
+      options: [
+        {
+          additionalBarrelFileNames: ['client'],
+        },
+      ],
+      errors: [
+        {
+          message: /推奨されるimport（以下のいずれか）[\s\S]*index\.ts[\s\S]*client\.ts/,
+        },
+      ],
+    },
+
+    // additionalBarrelFileNames - index.tsのみ存在する場合、存在しないclient.tsも選択肢に表示
+    {
+      code: `import { fetchUser } from './api/user'`,
+      filename: (() => {
+        createFixture('barrel-file-names-with-missing-client', {
+          'components': {
+            'Page.tsx': '',
+            'api': {
+              'index.ts': 'export {}',
+              'user.ts': '',
+            },
+          },
+        })
+        return `${fixturesRoot}/barrel-file-names-with-missing-client/components/Page.tsx`
+      })(),
+      options: [
+        {
+          additionalBarrelFileNames: ['client'],
+        },
+      ],
+      errors: [
+        {
+          message: /推奨されるimport（以下のいずれか）[\s\S]*index\.ts[\s\S]*client\.ts \(作成が必要\)[\s\S]*※ 存在しないバレルファイルは必要に応じて作成してください。/,
+        },
+      ],
+    },
+
+    // additionalBarrelFileNames - client.tsのみ存在する場合、存在しないindex.tsも選択肢に表示
+    {
+      code: `import { fetchUser } from './api/user'`,
+      filename: (() => {
+        createFixture('barrel-file-names-with-missing-index', {
+          'components': {
+            'Page.tsx': '',
+            'api': {
+              'client.ts': 'export {}',
+              'user.ts': '',
+            },
+          },
+        })
+        return `${fixturesRoot}/barrel-file-names-with-missing-index/components/Page.tsx`
+      })(),
+      options: [
+        {
+          additionalBarrelFileNames: ['client'],
+        },
+      ],
+      errors: [
+        {
+          message: /推奨されるimport（以下のいずれか）[\s\S]*index\.ts \(作成が必要\)[\s\S]*client\.ts[\s\S]*※ 存在しないバレルファイルは必要に応じて作成してください。/,
+        },
+      ],
+    },
+
+    // additionalBarrelFileNames - client.tsをbarrelとして扱う
+    {
+      code: `import { fetchUser } from './api/user'`,
+      filename: (() => {
+        createFixture('barrel-file-names-client', {
+          'components': {
+            'Page.tsx': '',
+            'api': {
+              'client.ts': 'export {}',  // client.tsがbarrel
+              'user.ts': '',
+            },
+          },
+        })
+        return `${fixturesRoot}/barrel-file-names-client/components/Page.tsx`
+      })(),
+      options: [
+        {
+          additionalBarrelFileNames: ['client', 'server'],
+        },
+      ],
+      errors: [
+        {
+          message: /バレルファイルを経由してimportしてください/,
+        },
+      ],
+    },
+
+    // additionalBarrelFileNames - server.tsをbarrelとして扱う
+    {
+      code: `import { getServerData } from './server-api/data'`,
+      filename: (() => {
+        createFixture('barrel-file-names-server', {
+          'lib': {
+            'App.tsx': '',
+            'server-api': {
+              'server.ts': 'export {}',  // server.tsがbarrel
+              'data.ts': '',
+            },
+          },
+        })
+        return `${fixturesRoot}/barrel-file-names-server/lib/App.tsx`
+      })(),
+      options: [
+        {
+          additionalBarrelFileNames: ['client', 'server'],
+        },
+      ],
+      errors: [
+        {
+          message: /バレルファイルを経由してimportしてください/,
+        },
+      ],
+    },
+
+    // additionalBarrelFileNames - client.tsがindexより優先される（同じディレクトリ内）
+    {
+      code: `import { fetchUser } from './api/user'`,
+      filename: (() => {
+        createFixture('barrel-file-names-priority', {
+          'components': {
+            'Page.tsx': '',
+            'api': {
+              'client.ts': 'export {}',  // client.tsが優先
+              'index.ts': 'export {}',
+              'user.ts': '',
+            },
+          },
+        })
+        return `${fixturesRoot}/barrel-file-names-priority/components/Page.tsx`
+      })(),
+      options: [
+        {
+          additionalBarrelFileNames: ['client'],
+        },
+      ],
+      errors: [
+        {
+          message: /client\.ts/,  // client.tsが検出される
+        },
+      ],
+    },
+
+    // additionalBarrelFileNames - 異なるファイル名の場合は最も近いbarrelを優先
+    {
+      code: `import { useFormContext } from './route/edit/_hooks/useFormContext'`,
+      filename: (() => {
+        createFixture('barrel-file-names-nearest-priority', {
+          'Page.tsx': '',  // importer
+          'route': {
+            'client.ts': 'export {}',  // 親のclient.ts
+            'edit': {
+              'index.ts': 'export {}',  // より近いindex.tsが優先される
+              '_hooks': {
+                'useFormContext.ts': '',
+              },
+            },
+          },
+        })
+        return `${fixturesRoot}/barrel-file-names-nearest-priority/Page.tsx`
+      })(),
+      options: [
+        {
+          additionalBarrelFileNames: ['client', 'server'],
+        },
+      ],
+      errors: [
+        {
+          message: /route\/edit/,  // 最も近いindex.ts（route/edit）が検出される
+        },
+      ],
+    },
+
+    // additionalBarrelFileNames - より親のclient.tsを優先
+    {
+      code: `import { useFormContext } from './route/edit/_hooks/useFormContext'`,
+      filename: (() => {
+        createFixture('barrel-file-names-parent-priority', {
+          'Page.tsx': '',  // importer
+          'route': {
+            'client.ts': 'export {}',  // 親のclient.tsが優先される
+            'edit': {
+              'client.ts': 'export {}',  // こちらではなく親が検出される
+              '_hooks': {
+                'useFormContext.ts': '',
+              },
+            },
+          },
+        })
+        return `${fixturesRoot}/barrel-file-names-parent-priority/Page.tsx`
+      })(),
+      options: [
+        {
+          additionalBarrelFileNames: ['client', 'server'],
+        },
+      ],
+      errors: [
+        {
+          message: /route\/client\.ts/,  // より親のclient.tsが検出される
+        },
+      ],
+    },
+
+    // additionalBarrelFileNames - 親にclient.tsがなくindex.tsのみの場合、client.ts作成を促す
+    {
+      code: `import { useFormContext } from './route/edit/_hooks/useFormContext'`,
+      filename: (() => {
+        createFixture('barrel-file-names-missing-client', {
+          'Page.tsx': '',  // importer
+          'route': {
+            'index.ts': 'export {}',  // index.tsのみ
+            // client.ts なし
+            'edit': {
+              'client.ts': 'export {}',  // 子にはclient.tsがある
+              '_hooks': {
+                'useFormContext.ts': '',
+              },
+            },
+          },
+        })
+        return `${fixturesRoot}/barrel-file-names-missing-client/Page.tsx`
+      })(),
+      options: [
+        {
+          additionalBarrelFileNames: ['client', 'server'],
+        },
+      ],
+      errors: [
+        {
+          message: /route\/client\.ts を作成して.*edit\/client のexportをまとめてください/,
+        },
+      ],
+    },
+
+    // additionalBarrelFileNames - 複雑なネスト: 子=index, 中間=client, 親=index
+    {
+      code: `import { Component } from './route/edit/components/Component'`,
+      filename: (() => {
+        createFixture('barrel-file-names-nested-mixed', {
+          'Page.tsx': '',  // importer
+          'route': {
+            'index.ts': 'export {}',  // 親 (index)
+            'edit': {
+              'client.ts': 'export {}',  // 中間 (client)
+              'components': {
+                'index.ts': 'export {}',  // 子 (index) - 最も近い
+                'Component.tsx': '',
+              },
+            },
+          },
+        })
+        return `${fixturesRoot}/barrel-file-names-nested-mixed/Page.tsx`
+      })(),
+      options: [
+        {
+          additionalBarrelFileNames: ['client', 'server'],
+        },
+      ],
+      errors: [
+        {
+          message: /route\/edit\/components/,  // 最も近いindex.ts（components）が検出される
+        },
+      ],
+    },
+
+    // additionalBarrelFileNames - 複雑なネスト: 全てclient.ts
+    {
+      code: `import { Component } from './route/edit/components/Component'`,
+      filename: (() => {
+        createFixture('barrel-file-names-nested-all-client', {
+          'Page.tsx': '',  // importer
+          'route': {
+            'client.ts': 'export {}',  // 親 (client)
+            'edit': {
+              'client.ts': 'export {}',  // 中間 (client)
+              'components': {
+                'client.ts': 'export {}',  // 子 (client) - 同名なので探索を続ける
+                'Component.tsx': '',
+              },
+            },
+          },
+        })
+        return `${fixturesRoot}/barrel-file-names-nested-all-client/Page.tsx`
+      })(),
+      options: [
+        {
+          additionalBarrelFileNames: ['client', 'server'],
+        },
+      ],
+      errors: [
+        {
+          message: /route\/client/,  // より親のclient.tsが検出される
+        },
+      ],
+    },
+
+    // additionalBarrelFileNames - 複雑なネスト: 子=client, 中間=index, 親=なし
+    {
+      code: `import { Component } from './route/edit/components/Component'`,
+      filename: (() => {
+        createFixture('barrel-file-names-nested-reverse', {
+          'Page.tsx': '',  // importer
+          'route': {
+            // barrelなし
+            'edit': {
+              'index.ts': 'export {}',  // 中間 (index)
+              'components': {
+                'client.ts': 'export {}',  // 子 (client) - 最も近い
+                'Component.tsx': '',
+              },
+            },
+          },
+        })
+        return `${fixturesRoot}/barrel-file-names-nested-reverse/Page.tsx`
+      })(),
+      options: [
+        {
+          additionalBarrelFileNames: ['client', 'server'],
+        },
+      ],
+      errors: [
+        {
+          message: /route\/edit\/components\/client/,  // 最も近いclient.tsが検出される
+        },
+      ],
+    },
+
+    // ============================================================
+    // 【新規】同じディレクトリまたは子階層からバレルファイルを経由するimport
+    // ============================================================
+
+    // 1. 同じディレクトリでバレルファイルを経由（from '.'）
+    {
+      code: `import { Button } from '.'`,
+      filename: (() => {
+        createFixture('same-dir-barrel-dot', {
+          'Button': {
+            'index.tsx': 'export { Button } from "./Button"',
+            'Button.tsx': '',
+          },
+        })
+        return `${fixturesRoot}/same-dir-barrel-dot/Button/Button.tsx`
+      })(),
+      errors: [
+        {
+          message: /バレルファイルからのimportは、そのディレクトリ外部からのみ許可されています/,
+        },
+      ],
+    },
+
+    // 2. 同じディレクトリでバレルファイルを経由（from './index'）
+    {
+      code: `import { Button } from './index'`,
+      filename: (() => {
+        createFixture('same-dir-barrel-index', {
+          'Button': {
+            'index.tsx': 'export { Button } from "./Button"',
+            'Button.tsx': '',
+          },
+        })
+        return `${fixturesRoot}/same-dir-barrel-index/Button/Button.tsx`
+      })(),
+      errors: [
+        {
+          message: /バレルファイルからのimportは、そのディレクトリ外部からのみ許可されています/,
+        },
+      ],
+    },
+
+    // 3. 同じディレクトリでclient.tsを経由（from './client'）
+    {
+      code: `import { ButtonPresentation } from './client'`,
+      filename: (() => {
+        createFixture('same-dir-barrel-client', {
+          'Button': {
+            'Button.container.tsx': '',
+            'Button.presentation.tsx': '',
+            'client.ts': 'export { ButtonPresentation } from "./Button.presentation"',
+          },
+        })
+        return `${fixturesRoot}/same-dir-barrel-client/Button/Button.container.tsx`
+      })(),
+      options: [
+        {
+          additionalBarrelFileNames: ['client'],
+        },
+      ],
+      errors: [
+        {
+          message: /バレルファイルからのimportは、そのディレクトリ外部からのみ許可されています/,
+        },
+      ],
+    },
+
+    // 4. 親ディレクトリのバレルを子階層から経由（from '..'）
+    {
+      code: `import { Button } from '..'`,
+      filename: (() => {
+        createFixture('child-dir-parent-barrel-dot', {
+          'Button': {
+            'index.tsx': 'export { Button } from "./Button"',
+            'Button.tsx': '',
+            '_utils': {
+              'helper.ts': '',
+            },
+          },
+        })
+        return `${fixturesRoot}/child-dir-parent-barrel-dot/Button/_utils/helper.ts`
+      })(),
+      errors: [
+        {
+          message: /バレルファイルからのimportは、そのディレクトリ外部からのみ許可されています/,
+        },
+      ],
+    },
+
+    // 5. 親ディレクトリのバレルを子階層から経由（from '../index'）
+    {
+      code: `import { Button } from '../index'`,
+      filename: (() => {
+        createFixture('child-dir-parent-barrel-index', {
+          'Button': {
+            'index.tsx': 'export { Button } from "./Button"',
+            'Button.tsx': '',
+            '_utils': {
+              'helper.ts': '',
+            },
+          },
+        })
+        return `${fixturesRoot}/child-dir-parent-barrel-index/Button/_utils/helper.ts`
+      })(),
+      errors: [
+        {
+          message: /バレルファイルからのimportは、そのディレクトリ外部からのみ許可されています/,
+        },
+      ],
+    },
+
+    // 6. path aliasで同じディレクトリのバレルを経由
+    {
+      code: `import { Button } from '@/same-dir-path-alias-barrel/Button'`,
+      filename: (() => {
+        createFixture('same-dir-path-alias-barrel', {
+          'Button': {
+            'index.tsx': 'export { Button } from "./Button"',
+            'Button.tsx': '',
+          },
+        })
+        return `${fixturesRoot}/same-dir-path-alias-barrel/Button/Button.tsx`
+      })(),
+      errors: [
+        {
+          message: /バレルファイルからのimportは、そのディレクトリ外部からのみ許可されています/,
+        },
+      ],
+    },
+
+    // 7. path aliasでバレルディレクトリの子階層から経由
+    {
+      code: `import { Button } from '@/child-dir-path-alias-barrel/Button'`,
+      filename: (() => {
+        createFixture('child-dir-path-alias-barrel', {
+          'Button': {
+            'index.tsx': 'export { Button } from "./Button"',
+            'Button.tsx': '',
+            '_utils': {
+              'helper.ts': '',
+            },
+          },
+        })
+        return `${fixturesRoot}/child-dir-path-alias-barrel/Button/_utils/helper.ts`
+      })(),
+      errors: [
+        {
+          message: /バレルファイルからのimportは、そのディレクトリ外部からのみ許可されています/,
+        },
+      ],
+    },
+
+    // 8. 孫ディレクトリからバレルを経由（from '../../index'）
+    {
+      code: `import { Button } from '../../index'`,
+      filename: (() => {
+        createFixture('grandchild-dir-barrel', {
+          'Button': {
+            'index.tsx': 'export { Button } from "./Button"',
+            'Button.tsx': '',
+            '_utils': {
+              '_helpers': {
+                'deep.ts': '',
+              },
+            },
+          },
+        })
+        return `${fixturesRoot}/grandchild-dir-barrel/Button/_utils/_helpers/deep.ts`
+      })(),
+      errors: [
+        {
+          message: /バレルファイルからのimportは、そのディレクトリ外部からのみ許可されています/,
+        },
+      ],
+    },
   ],
 })