feat: initial release v0.3.0

scripts/guards/locale-navigation-guard.mjs

@@ -0,0 +1,101 @@
+#!/usr/bin/env node
+
+import fs from 'fs'
+import path from 'path'
+import process from 'process'
+
+const root = process.cwd()
+const sourceExtensions = new Set(['.ts', '.tsx', '.js', '.jsx', '.mjs', '.cjs'])
+
+const scanDirectories = [
+  'src/app/[locale]',
+]
+
+const extraFiles = [
+  'src/components/Navbar.tsx',
+  'src/components/LanguageSwitcher.tsx',
+]
+
+function toRel(fullPath) {
+  return path.relative(root, fullPath).split(path.sep).join('/')
+}
+
+function walk(dir, out = []) {
+  if (!fs.existsSync(dir)) return out
+  const entries = fs.readdirSync(dir, { withFileTypes: true })
+  for (const entry of entries) {
+    if (entry.name === '.git' || entry.name === '.next' || entry.name === 'node_modules') continue
+    const fullPath = path.join(dir, entry.name)
+    if (entry.isDirectory()) {
+      walk(fullPath, out)
+      continue
+    }
+    if (sourceExtensions.has(path.extname(fullPath))) {
+      out.push(fullPath)
+    }
+  }
+  return out
+}
+
+function gatherTargetFiles() {
+  const files = scanDirectories.flatMap((dir) => walk(path.join(root, dir)))
+  for (const relPath of extraFiles) {
+    const fullPath = path.join(root, relPath)
+    if (fs.existsSync(fullPath)) {
+      files.push(fullPath)
+    }
+  }
+  return Array.from(new Set(files))
+}
+
+function findViolations(content, relPath) {
+  const violations = []
+  const lines = content.split('\n')
+
+  const nextLinkImport = /from\s+['"]next\/link['"]/
+  const nextNavigationUseRouterImport = /import\s*{[\s\S]*?\buseRouter\b[\s\S]*?}\s*from\s*['"]next\/navigation['"]/m
+  const rootHrefLiteral = /\bhref\s*=\s*["']\//
+  const rootHrefTemplate = /\bhref\s*=\s*{`\//
+  const rootRouterCall = /\brouter\.(push|replace|prefetch)\s*\(\s*["'`]\//
+
+  const nextLinkIndex = content.search(nextLinkImport)
+  if (nextLinkIndex >= 0) {
+    const lineNo = content.slice(0, nextLinkIndex).split('\n').length
+    violations.push(`${relPath}:${lineNo} do not import next/link in locale navigation surface; use @/i18n/navigation Link`)
+  }
+
+  const nextNavigationRouterIndex = content.search(nextNavigationUseRouterImport)
+  if (nextNavigationRouterIndex >= 0) {
+    const lineNo = content.slice(0, nextNavigationRouterIndex).split('\n').length
+    violations.push(`${relPath}:${lineNo} do not import useRouter from next/navigation in locale navigation surface; use @/i18n/navigation useRouter`)
+  }
+
+  for (let index = 0; index < lines.length; index += 1) {
+    const line = lines[index]
+    const lineNo = index + 1
+    if (rootHrefLiteral.test(line) || rootHrefTemplate.test(line)) {
+      violations.push(`${relPath}:${lineNo} do not use root-literal href; use Link href={{ pathname: '...' }} via @/i18n/navigation`)
+    }
+    if (rootRouterCall.test(line)) {
+      violations.push(`${relPath}:${lineNo} do not use root-literal router navigation; use router.push/replace({ pathname: '...' }) via @/i18n/navigation`)
+    }
+  }
+
+  return violations
+}
+
+const violations = []
+for (const filePath of gatherTargetFiles()) {
+  const content = fs.readFileSync(filePath, 'utf8')
+  violations.push(...findViolations(content, toRel(filePath)))
+}
+
+if (violations.length > 0) {
+  console.error('\n[locale-navigation-guard] violations found:')
+  for (const violation of violations) {
+    console.error(`  - ${violation}`)
+  }
+  process.exit(1)
+}
+
+console.log('[locale-navigation-guard] OK')