eslint-plugin-smarthr 6.10.0 → 6.10.2

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.10.2](https://github.com/kufu/tamatebako/compare/eslint-plugin-smarthr-v6.10.1...eslint-plugin-smarthr-v6.10.2) (2026-04-09)
+
+
+### Bug Fixes
+
+* **test:** typescript-eslint v8のparserに更新 ([#1217](https://github.com/kufu/tamatebako/issues/1217)) ([e44ac27](https://github.com/kufu/tamatebako/commit/e44ac27e26afc9cbe26244afd38e62bb65aecaa4))
+
+## [6.10.1](https://github.com/kufu/tamatebako/compare/eslint-plugin-smarthr-v6.10.0...eslint-plugin-smarthr-v6.10.1) (2026-04-08)
+
+
+### Bug Fixes
+
+* **require-barrel-import:** next.jsの特殊文字パスでのバグ修正とリファクタリング ([#1210](https://github.com/kufu/tamatebako/issues/1210)) ([458cfe9](https://github.com/kufu/tamatebako/commit/458cfe90084cbcee936bcb375216f5807880edd7))
+
 ## [6.10.0](https://github.com/kufu/tamatebako/compare/eslint-plugin-smarthr-v6.9.1...eslint-plugin-smarthr-v6.10.0) (2026-04-08)
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "eslint-plugin-smarthr",
-  "version": "6.10.0",
+  "version": "6.10.2",
   "author": "SmartHR",
   "license": "MIT",
   "description": "A sharable ESLint plugin for SmartHR",
@@ -37,5 +37,5 @@
     "eslintplugin",
     "smarthr"
   ],
-  "gitHead": "9f682d10a15702c061e23d7c0922e0d3f69149d5"
+  "gitHead": "662f8876643b981d82a4a5aaf5d9a96d7d7ed58b"
 }

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

@@ -31,62 +31,172 @@ const SCHEMA = [
   }
 ]
 
-const entriedReplacePaths = Object.entries(replacePaths)
 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 TARGET_EXTS = ['ts', 'tsx', 'js', 'jsx']
 
-// 正規表現を事前生成してキャッシュ
-const entriedReplacePathsWithRegex = entriedReplacePaths.map(([key, values]) => [
-  key,
-  values,
-  new RegExp(`^${key}(.+)$`),
-  values.map(v => new RegExp(`^${path.resolve(`${CWD}/${v}`)}(.+)$`))
-])
-
-const calculateAbsoluteImportPath = (source) => {
-  if (source[0] === '/') {
-    return source
+// Path aliasの情報を事前計算してキャッシュ
+const REPLACE_PATHS_INFO = Object.entries(replacePaths).map(([key, values]) => {
+  const resolvedPaths = values.map(v => path.resolve(`${CWD}/${v.replace(/\/\*$/, '')}`))
+  return {
+    key,
+    values,
+    keyRegex: new RegExp(`^${key}(.+)$`),
+    resolvedPaths,
+    valueRegexes: resolvedPaths.map(p => new RegExp(`^${p}(.+)$`))
   }
+})
 
-  return entriedReplacePathsWithRegex.reduce((prev, [key, values, keyRegex]) => {
-    if (source === prev) {
-      return values.reduce((p, v) => {
-        if (prev === p && keyRegex.test(keyRegex)) {
-          return p.replace(keyRegex, `${path.resolve(`${CWD}/${v}`)}/$1`)
-        }
+// @/ と ~/ のパスのみをrootとする（READMEの仕様通り）
+const ALL_ROOT_PATHS = (() => {
+  const rootKeys = ['@/', '~/']
+  return REPLACE_PATHS_INFO
+    .filter(info => rootKeys.includes(info.key))
+    .flatMap(info => info.resolvedPaths)
+})()
+
+/**
+ * Path aliasを絶対パスに変換する
+ * @param {string} importPath - import文のパス（例: '@/components/Button'）
+ * @returns {string} 絶対パス（例: '/path/to/src/components/Button'）
+ */
+const resolvePathAlias = (importPath) => {
+  if (importPath[0] === '/') {
+    return importPath
+  }
 
-        return p
-      }, prev)
+  for (const { keyRegex, resolvedPaths } of REPLACE_PATHS_INFO) {
+    if (keyRegex.test(importPath)) {
+      return importPath.replace(keyRegex, `${resolvedPaths[0]}/$1`)
     }
+  }
 
-    return prev
-  }, source)
+  return importPath
 }
-const calculateReplacedImportPath = (source) => {
-  return entriedReplacePathsWithRegex.reduce((prev, [key, values, keyRegex, valueRegexes]) => {
-    if (source === prev) {
-      return values.reduce((p, v, index) => {
-        if (prev === p) {
-          const regexp = valueRegexes[index]
-
-          if (regexp.test(prev)) {
-            return p.replace(regexp, `${key}/$1`).replace(REGEX_UNNECESSARY_SLASH, '/')
-          }
-        }
 
-        return p
-      }, prev)
+/**
+ * 絶対パスをPath aliasに変換する
+ * @param {string} absolutePath - 絶対パス（例: '/path/to/src/components/Button'）
+ * @returns {string} Path alias（例: '@/components/Button'）
+ */
+const convertToPathAlias = (absolutePath) => {
+  for (const { key, valueRegexes } of REPLACE_PATHS_INFO) {
+    for (const regexp of valueRegexes) {
+      if (regexp.test(absolutePath)) {
+        return absolutePath.replace(regexp, `${key}/$1`).replace(REGEX_UNNECESSARY_SLASH, '/')
+      }
     }
+  }
+
+  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 + '/')
+}
+
+/**
+ * allowedImportsオプションに基づいて、特定のimportが許可されているかチェックする
+ * @param {object} node - ImportDeclaration node
+ * @param {string} importerDir - import元のディレクトリ
+ * @param {Array} targetAllowedImports - 適用されるallowedImportsのキー配列
+ * @param {object} allowedImportsConfig - allowedImportsの設定
+ * @returns {{ shouldSkip: boolean, deniedModules: Array }} チェック結果
+ */
+const checkAllowedImports = (node, importerDir, targetAllowedImports, allowedImportsConfig) => {
+  let isDenyPath = false
+  let deniedModules = []
+
+  for (const allowedKey of targetAllowedImports) {
+    const allowedOption = allowedImportsConfig[allowedKey]
+
+    for (const targetModule in allowedOption) {
+      const actualTarget = targetModule[0] !== '.'
+        ? targetModule
+        : path.resolve(`${CWD}/${targetModule}`)
+
+      let importSource = node.source.value
+
+      // 絶対パスの場合は、import元ディレクトリを基準に解決
+      if (actualTarget[0] === '/') {
+        importSource = path.resolve(`${importerDir}/${importSource}`)
+      }
+
+      if (actualTarget !== importSource) {
+        continue
+      }
+
+      const allowedModules = allowedOption[targetModule] || true
+
+      if (!Array.isArray(allowedModules)) {
+        isDenyPath = true
+        deniedModules.push(true)
+      } else {
+        const importedNames = node.specifiers.map(s => s.imported?.name)
+        const notAllowedModules = importedNames.filter(name => !allowedModules.includes(name))
+        deniedModules.push(notAllowedModules)
+      }
+    }
+  }
+
+  // 完全に許可されている場合はスキップ
+  const shouldSkip =
+    (isDenyPath && deniedModules[0] === true) ||
+    (!isDenyPath && deniedModules.length === 1 && deniedModules[0].length === 0)
 
-    return prev
-  }, source)
+  return { shouldSkip, deniedModules }
 }
 
-const pickImportedName = (s) => s.imported?.name
-const findExistsSync = (p) => fs.existsSync(p)
+/**
+ * import先のパスから親方向に barrel ファイルを探索する
+ * @param {string} importedPath - import先の絶対パス
+ * @param {string} importerDir - import元のディレクトリ
+ * @returns {string|undefined} 見つかったbarrelファイルのパス
+ */
+const findBarrelFile = (importedPath, importerDir) => {
+  const pathSegments = importedPath.split('/')
+  let currentPath = importedPath
+  let barrel = undefined
+
+  // ディレクトリ指定の場合、そのindex.tsを指していることは自明なので一階層上から探索
+  if (fs.existsSync(currentPath) && fs.statSync(currentPath).isDirectory()) {
+    pathSegments.pop()
+    currentPath = pathSegments.join('/')
+  }
+
+  while (pathSegments.length > 0) {
+    // 以下の場合は探索終了
+    // 1. いずれかのreplacePathsのルートに到達した場合
+    // 2. import先がimport元の内部にある場合（同階層・サブディレクトリからのimport）
+    if (ALL_ROOT_PATHS.includes(currentPath) || isImportedInsideImporter(importerDir, currentPath)) {
+      break
+    }
+
+    // 現在のパスにbarrelファイルがあるかチェック
+    const foundBarrel = TARGET_EXTS
+      .map(ext => `${currentPath}/index.${ext}`)
+      .find(filePath => fs.existsSync(filePath))
+
+    if (foundBarrel) {
+      barrel = foundBarrel
+    }
+
+    // 一階層上に移動
+    pathSegments.pop()
+    currentPath = pathSegments.join('/')
+  }
+
+  return barrel
+}
 
 /**
  * @type {import('@typescript-eslint/utils').TSESLint.RuleModule<''>}
@@ -99,108 +209,78 @@ module.exports = {
   create(context) {
     const option = context.options[0] || {}
 
-    if (option.ignores && option.ignores.some((i) => (new RegExp(i)).test(context.filename))) {
-      return {}
+    // ignoresオプションでスキップ対象のファイルかチェック
+    if (option.ignores) {
+      const isIgnored = option.ignores.some(pattern =>
+        new RegExp(pattern).test(context.filename)
+      )
+      if (isIgnored) {
+        return {}
+      }
     }
 
-    const dir = getParentDir(context.filename)
+    const importerDir = getParentDir(context.filename)
+
+    // このファイルに適用されるallowedImportsのキーを収集
     const targetAllowedImports = []
     if (option?.allowedImports) {
-      for (const regex in option.allowedImports) {
-        if ((new RegExp(regex)).test(context.filename)) {
-          targetAllowedImports.push(regex)
+      for (const pattern in option.allowedImports) {
+        if (new RegExp(pattern).test(context.filename)) {
+          targetAllowedImports.push(pattern)
         }
       }
     }
 
     return {
       ImportDeclaration: (node) => {
-        let isDenyPath = false
-        let deniedModules = []
-
-        for (const allowedKey of targetAllowedImports) {
-          const allowedOption = option.allowedImports[allowedKey]
-
-          for (const targetModule in allowedOption) {
-            const actualTarget = targetModule[0] !== '.' ? targetModule : path.resolve(`${CWD}/${targetModule}`)
-            let sourceValue = node.source.value
-
-            if (actualTarget[0] === '/') {
-              sourceValue = path.resolve(`${dir}/${sourceValue}`)
-            }
-
-            if (actualTarget !== sourceValue) {
-              continue
-            }
-
-            let allowedModules = allowedOption[targetModule] || true
-
-            if (!Array.isArray(allowedModules)) {
-              isDenyPath = true
-              deniedModules.push(true)
-            } else {
-              deniedModules.push(node.specifiers.map(pickImportedName).filter(i => allowedModules.indexOf(i) == -1))
-            }
-          }
-        }
-
-        if (
-          isDenyPath && deniedModules[0] === true ||
-          !isDenyPath && deniedModules.length === 1 && deniedModules[0].length === 0
-        ) {
+        // allowedImportsチェック
+        const { shouldSkip, deniedModules } = checkAllowedImports(
+          node,
+          importerDir,
+          targetAllowedImports,
+          option.allowedImports || {}
+        )
+        if (shouldSkip) {
           return
         }
 
-        let sourceValue = node.source.value
+        // import先のパスを絶対パスに変換
+        let importedPath = node.source.value
 
-        if (sourceValue[0] === '.') {
-          sourceValue = path.resolve(`${dir}/${sourceValue}`)
+        // 相対パスの場合、絶対パスに変換
+        if (importedPath[0] === '.') {
+          importedPath = path.resolve(`${importerDir}/${importedPath}`)
         }
 
-        sourceValue = calculateAbsoluteImportPath(sourceValue)
+        // Path alias（@/, ~/など）を絶対パスに変換
+        importedPath = resolvePathAlias(importedPath)
 
-        if (sourceValue[0] !== '/') {
+        // 絶対パスでない場合（node_modulesなど）はスキップ
+        if (importedPath[0] !== '/') {
           return
         }
 
-        const sources = sourceValue.split('/')
+        // barrel ファイルを探索
+        const barrelPath = findBarrelFile(importedPath, importerDir)
 
-        // HINT: directoryの場合、indexファイルからimportしていることは自明であるため、一階層上からチェックする
-        if (fs.existsSync(sourceValue) && fs.statSync(sourceValue).isDirectory()) {
-          sources.pop()
-          sourceValue = sources.join('/')
-        }
-
-        let barrel = undefined
-
-        while (sources.length > 0) {
-          // HINT: 以下の場合は即終了
-          // - import元以下のimportだった場合
-          // - rootまで捜索した場合
-          if (
-            dir === rootPath ||
-            dir.match(new RegExp(`^${sourceValue}`))
-          ) {
-            break
-          }
-
-          barrel = TARGET_EXTS.map((e) => `${sourceValue}/index.${e}`).find(findExistsSync) || barrel
-
-          sources.pop()
-          sourceValue = sources.join('/')
+        // barrel が見つからない、またはroot pathのindex.tsの場合はスキップ
+        if (!barrelPath || REGEX_ROOT_PATH.test(barrelPath)) {
+          return
         }
 
-        if (barrel && !barrel.match(REGEX_ROOT_PATH)) {
-          barrel = calculateReplacedImportPath(barrel)
-          const noExt = barrel.replace(REGEX_INDEX_FILE, '')
-          deniedModules = [...new Set(deniedModules.flat())]
-
-          context.report({
-            node,
-            message: `${deniedModules.length ? `${deniedModules.join(', ')} は ${noExt} からimportしてください` :  `${noExt} からimportするか、${barrel} のbarrelファイルを削除して直接import可能にしてください`}
- - 詳細: https://github.com/kufu/tamatebako/tree/master/packages/eslint-plugin-smarthr/rules/require-barrel-import`,
-          });
-        }
+        // barrel パスをPath aliasに変換
+        const barrelWithAlias = convertToPathAlias(barrelPath)
+        const barrelDirWithAlias = barrelWithAlias.replace(REGEX_INDEX_FILE, '')
+        const uniqueDeniedModules = [...new Set(deniedModules.flat())]
+
+        // エラーを報告
+        context.report({
+          node,
+          message: uniqueDeniedModules.length
+            ? `${uniqueDeniedModules.join(', ')} は ${barrelDirWithAlias} からimportしてください`
+            : `${barrelDirWithAlias} からimportするか、${barrelWithAlias} のbarrelファイルを削除して直接import可能にしてください`
+              + '\n - 詳細: https://github.com/kufu/tamatebako/tree/master/packages/eslint-plugin-smarthr/rules/require-barrel-import',
+        })
       },
     }
   },

package/test/prohibit-export-array-type.js

@@ -1,9 +1,10 @@
 const rule = require('../rules/prohibit-export-array-type')
 const RuleTester = require('eslint').RuleTester
+const tseslint = require('typescript-eslint')
 
 const ruleTester = new RuleTester({
   languageOptions: {
-    parser: require('@typescript-eslint/parser'),
+    parser: tseslint.parser,
     parserOptions: {
       ecmaFeatures: {
         jsx: true,

package/test/require-barrel-import.js

@@ -0,0 +1,407 @@
+const fs = require('fs')
+const path = require('path')
+const rule = require('../rules/require-barrel-import')
+const RuleTester = require('eslint').RuleTester
+
+const ruleTester = new RuleTester({
+  languageOptions: {
+    parserOptions: {
+      ecmaFeatures: {
+        jsx: true,
+      },
+    },
+  },
+})
+
+// テストフィクスチャのルートディレクトリ
+const fixturesRoot = path.join(__dirname, '..', 'test-fixtures')
+
+/**
+ * テスト用のファイル構造を作成するヘルパー
+ * @param {string} testName - テスト名（ディレクトリ名として使用）
+ * @param {Object} structure - ファイル構造定義
+ * @returns {string} 作成したディレクトリのパス
+ */
+function createFixture(testName, structure) {
+  const fixtureDir = path.join(fixturesRoot, testName)
+
+  // ディレクトリが既に存在する場合は削除
+  if (fs.existsSync(fixtureDir)) {
+    fs.rmSync(fixtureDir, { recursive: true, force: true })
+  }
+
+  // ディレクトリとファイルを再帰的に作成
+  function createStructure(dir, struct) {
+    fs.mkdirSync(dir, { recursive: true })
+
+    for (const [name, content] of Object.entries(struct)) {
+      const fullPath = path.join(dir, name)
+
+      if (typeof content === 'object' && content !== null) {
+        // ディレクトリ
+        createStructure(fullPath, content)
+      } else {
+        // ファイル
+        fs.writeFileSync(fullPath, content || '')
+      }
+    }
+  }
+
+  createStructure(fixtureDir, structure)
+  return fixtureDir
+}
+
+/**
+ * テスト終了後のクリーンアップ
+ */
+function cleanupFixtures() {
+  if (fs.existsSync(fixturesRoot)) {
+    const entries = fs.readdirSync(fixturesRoot)
+    for (const entry of entries) {
+      const fullPath = path.join(fixturesRoot, entry)
+      if (fs.statSync(fullPath).isDirectory()) {
+        fs.rmSync(fullPath, { recursive: true, force: true })
+      }
+    }
+  }
+}
+
+// テスト終了後にクリーンアップ
+afterAll(() => {
+  cleanupFixtures()
+})
+
+ruleTester.run('require-barrel-import', rule, {
+  valid: [
+    // 同階層・サブディレクトリからのimport（エラーにならない）
+    {
+      code: `import { useMenu } from './hooks/useMenu'`,
+      filename: (() => {
+        createFixture('same-level-import', {
+          'Menu': {
+            'MenuItem.tsx': '',
+            'index.tsx': 'export {}',
+            'hooks': {
+              'useMenu.ts': '',
+            },
+          },
+        })
+        return `${fixturesRoot}/same-level-import/Menu/MenuItem.tsx`
+      })(),
+    },
+
+    // Next.js App Router特殊文字パス - 同階層import
+    {
+      code: `import { useUsers } from './hooks/useUsers'`,
+      filename: (() => {
+        createFixture('nextjs-special-chars', {
+          'app': {
+            '(private)': {
+              'settings': {
+                'user_roles': {
+                  '_components': {
+                    'index.tsx': 'export {}',
+                    'AddUserRoleDialog': {
+                      'index.tsx': 'export {}',
+                      'AddUserRoleDialog.tsx': '',
+                      'hooks': {
+                        'useUsers.ts': '',
+                      },
+                    },
+                  },
+                },
+              },
+            },
+          },
+        })
+        return `${fixturesRoot}/nextjs-special-chars/app/(private)/settings/user_roles/_components/AddUserRoleDialog/AddUserRoleDialog.tsx`
+      })(),
+    },
+
+    // Dynamic Routes - [id]パス（同階層）
+    {
+      code: `import { useDetail } from './hooks/useDetail'`,
+      filename: (() => {
+        createFixture('nextjs-dynamic-route', {
+          'app': {
+            'items': {
+              '[id]': {
+                'index.tsx': 'export {}',
+                'DetailPage.tsx': '',
+                'hooks': {
+                  'useDetail.ts': '',
+                },
+              },
+            },
+          },
+        })
+        return `${fixturesRoot}/nextjs-dynamic-route/app/items/[id]/DetailPage.tsx`
+      })(),
+    },
+
+    // barrel が存在しない場合（同階層サブディレクトリ）
+    {
+      code: `import { helper } from './utils/helper'`,
+      filename: (() => {
+        createFixture('no-barrel', {
+          'components': {
+            'Button': {
+              'Button.tsx': '',
+              'utils': {
+                'helper.ts': '',
+              },
+            },
+          },
+        })
+        return `${fixturesRoot}/no-barrel/components/Button/Button.tsx`
+      })(),
+    },
+
+    // 親階層からのimport + barrelなし（エラーにならない）
+    {
+      code: `import { helper } from '../utils/helper'`,
+      filename: (() => {
+        createFixture('parent-import-no-barrel', {
+          // index.tsx なし（barrelなし）
+          'Button': {
+            'Button.tsx': '',
+          },
+          'utils': {
+            'helper.ts': '',
+          },
+        })
+        return `${fixturesRoot}/parent-import-no-barrel/Button/Button.tsx`
+      })(),
+    },
+
+    // Next.js特殊文字パス - 親階層からのimport + barrelなし
+    {
+      code: `import { createUserRole } from '../hooks/createUserRoleAction'`,
+      filename: (() => {
+        createFixture('nextjs-parent-no-barrel', {
+          // index.tsx なし（barrelなし）
+          'AddUserRoleDialog': {
+            'AddUserRoleDialog.tsx': '',
+          },
+          'hooks': {
+            'createUserRoleAction.ts': '',
+          },
+        })
+        return `${fixturesRoot}/nextjs-parent-no-barrel/AddUserRoleDialog/AddUserRoleDialog.tsx`
+      })(),
+    },
+
+    // Dynamic Routes - 親階層からのimport + barrelなし
+    {
+      code: `import { api } from '../api/client'`,
+      filename: (() => {
+        createFixture('dynamic-route-parent-no-barrel', {
+          // index.tsx なし（barrelなし）
+          '[id]': {
+            'DetailPage.tsx': '',
+          },
+          'api': {
+            'client.ts': '',
+          },
+        })
+        return `${fixturesRoot}/dynamic-route-parent-no-barrel/[id]/DetailPage.tsx`
+      })(),
+    },
+
+    // ============================================================
+    // Path alias - 同階層からのimport（エラーにならない）
+    // ============================================================
+    {
+      code: `import { useMenu } from '~/path-alias-same-level/Menu/hooks/useMenu'`,
+      filename: (() => {
+        createFixture('path-alias-same-level', {
+          'Menu': {
+            'MenuItem.tsx': '',
+            'index.tsx': 'export {}',
+            'hooks': {
+              'useMenu.ts': '',
+            },
+          },
+        })
+        return `${fixturesRoot}/path-alias-same-level/Menu/MenuItem.tsx`
+      })(),
+    },
+
+    // Path alias - 同階層サブディレクトリ + barrelなし
+    {
+      code: `import { helper } from '~/path-alias-no-barrel/components/Button/utils/helper'`,
+      filename: (() => {
+        createFixture('path-alias-no-barrel', {
+          'components': {
+            'Button': {
+              'Button.tsx': '',
+              'utils': {
+                'helper.ts': '',
+              },
+            },
+          },
+        })
+        return `${fixturesRoot}/path-alias-no-barrel/components/Button/Button.tsx`
+      })(),
+    },
+
+    // Path alias - 親階層からのimport + barrelなし
+    {
+      code: `import { helper } from '~/path-alias-parent-no-barrel/utils/helper'`,
+      filename: (() => {
+        createFixture('path-alias-parent-no-barrel', {
+          // index.tsx なし（barrelなし）
+          'Button': {
+            'Button.tsx': '',
+          },
+          'utils': {
+            'helper.ts': '',
+          },
+        })
+        return `${fixturesRoot}/path-alias-parent-no-barrel/Button/Button.tsx`
+      })(),
+    },
+  ],
+
+  invalid: [
+    // 親階層からのimport（barrelが存在する場合）
+    {
+      code: `import { createUserRole } from '../hooks/createUserRoleAction'`,
+      filename: (() => {
+        createFixture('parent-import-with-barrel', {
+          'components': {
+            'index.tsx': 'export {}',
+            'AddDialog': {
+              'AddDialog.tsx': '',
+            },
+            'hooks': {
+              'createUserRoleAction.ts': '',
+            },
+          },
+        })
+        return `${fixturesRoot}/parent-import-with-barrel/components/AddDialog/AddDialog.tsx`
+      })(),
+      errors: [
+        {
+          message: /からimportするか、.*のbarrelファイルを削除して直接import可能にしてください/,
+        },
+      ],
+    },
+
+    // Next.js特殊文字パス - 親階層からのimport
+    {
+      code: `import { createUserRole } from '../hooks/createUserRoleAction'`,
+      filename: (() => {
+        createFixture('nextjs-parent-import', {
+          'app': {
+            '(private)': {
+              'settings': {
+                'user_roles': {
+                  '_components': {
+                    'index.tsx': 'export {}',
+                    'AddUserRoleDialog': {
+                      'AddUserRoleDialog.tsx': '',
+                    },
+                    'hooks': {
+                      'createUserRoleAction.ts': '',
+                    },
+                  },
+                },
+              },
+            },
+          },
+        })
+        return `${fixturesRoot}/nextjs-parent-import/app/(private)/settings/user_roles/_components/AddUserRoleDialog/AddUserRoleDialog.tsx`
+      })(),
+      errors: [
+        {
+          message: /からimportするか、.*のbarrelファイルを削除して直接import可能にしてください/,
+        },
+      ],
+    },
+
+    // [id] Dynamic Routes - 親階層からのimport
+    {
+      code: `import { api } from '../api/client'`,
+      filename: (() => {
+        createFixture('dynamic-route-parent-import', {
+          'app': {
+            'items': {
+              'index.tsx': 'export {}',
+              '[id]': {
+                'DetailPage.tsx': '',
+              },
+              'api': {
+                'client.ts': '',
+              },
+            },
+          },
+        })
+        return `${fixturesRoot}/dynamic-route-parent-import/app/items/[id]/DetailPage.tsx`
+      })(),
+      errors: [
+        {
+          message: /からimportするか、.*のbarrelファイルを削除して直接import可能にしてください/,
+        },
+      ],
+    },
+
+    // ============================================================
+    // Path alias - 親階層からのimport（barrelあり）
+    // ============================================================
+    {
+      code: `import { createUserRole } from '~/path-alias-parent-import-with-barrel/components/hooks/createUserRoleAction'`,
+      filename: (() => {
+        createFixture('path-alias-parent-import-with-barrel', {
+          'components': {
+            'index.tsx': 'export {}',
+            'AddDialog': {
+              'AddDialog.tsx': '',
+            },
+            'hooks': {
+              'createUserRoleAction.ts': '',
+            },
+          },
+        })
+        return `${fixturesRoot}/path-alias-parent-import-with-barrel/components/AddDialog/AddDialog.tsx`
+      })(),
+      errors: [
+        {
+          message: /からimportするか、.*のbarrelファイルを削除して直接import可能にしてください/,
+        },
+      ],
+    },
+
+    // Path alias + Next.js特殊文字パス - 親階層からのimport
+    {
+      code: `import { createUserRole } from '~/path-alias-nextjs-parent/app/(private)/settings/user_roles/_components/hooks/createUserRoleAction'`,
+      filename: (() => {
+        createFixture('path-alias-nextjs-parent', {
+          'app': {
+            '(private)': {
+              'settings': {
+                'user_roles': {
+                  '_components': {
+                    'index.tsx': 'export {}',
+                    'AddUserRoleDialog': {
+                      'AddUserRoleDialog.tsx': '',
+                    },
+                    'hooks': {
+                      'createUserRoleAction.ts': '',
+                    },
+                  },
+                },
+              },
+            },
+          },
+        })
+        return `${fixturesRoot}/path-alias-nextjs-parent/app/(private)/settings/user_roles/_components/AddUserRoleDialog/AddUserRoleDialog.tsx`
+      })(),
+      errors: [
+        {
+          message: /からimportするか、.*のbarrelファイルを削除して直接import可能にしてください/,
+        },
+      ],
+    },
+  ],
+})

package/tsconfig.json

@@ -1,8 +1,10 @@
 {
   "compilerOptions": {
     "paths": {
+      // ルール実装で使用
       "@/*": ["./src/*"],
-      "~/*": ["./src/*"]
+      // テスト用
+      "~/*": ["./test-fixtures/*"]
     }
   }
 }