next-a11y 0.1.4 → 0.1.5

package/README.md

@@ -1,3 +1,6 @@
+> [!IMPORTANT]
+> THIS PACKAGE IS IN ACTIVE DEVELOPMENT
+
 # next-a11y
 
 **Finds accessibility violations in your Next.js source code. Writes the fix.**

package/dist/cli/index.js

@@ -23,10 +23,13 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 ));
 
 // src/cli/index.ts
-var import_dotenv = require("dotenv");
+var import_dotenv2 = require("dotenv");
 var import_commander = require("commander");
 
 // src/cli/scan-command.ts
+var fs7 = __toESM(require("fs"));
+var path7 = __toESM(require("path"));
+var import_dotenv = require("dotenv");
 var import_picocolors4 = __toESM(require("picocolors"));
 
 // src/config/resolve.ts
@@ -100,7 +103,7 @@ async function loadConfigFile(cwd) {
 }
 function resolveConfig(fileConfig, cliFlags = {}) {
   const merged = deepMerge(DEFAULT_CONFIG, fileConfig);
-  const provider = cliFlags.provider ?? merged.provider;
+  const provider = cliFlags.provider ?? merged.provider ?? detectProviderFromEnv();
   const model = cliFlags.model ?? merged.model ?? (provider ? PROVIDER_DEFAULTS[provider] : "gpt-4.1-nano");
   return {
     provider,
@@ -118,6 +121,12 @@ function resolveConfig(fileConfig, cliFlags = {}) {
     minScore: cliFlags.minScore
   };
 }
+function detectProviderFromEnv() {
+  for (const [name, envVar] of Object.entries(PROVIDER_ENV)) {
+    if (envVar && process.env[envVar]) return name;
+  }
+  return void 0;
+}
 function deepMerge(target, source) {
   const result = { ...target };
   for (const key of Object.keys(source)) {
@@ -146,13 +155,13 @@ async function discoverFiles(basePath, include, exclude) {
   if (typeof fs2.glob === "function") {
     for (const pattern of include) {
       try {
-        const matches = await new Promise((resolve4, reject) => {
+        const matches = await new Promise((resolve5, reject) => {
           fs2.glob(
             pattern,
             { cwd: absBase },
             (err, files) => {
               if (err) reject(err);
-              else resolve4(files);
+              else resolve5(files);
             }
           );
         });
@@ -1924,7 +1933,18 @@ var fs5 = __toESM(require("fs"));
 var path5 = __toESM(require("path"));
 var https = __toESM(require("https"));
 var http = __toESM(require("http"));
+var IMAGE_EXTENSIONS = [".png", ".jpg", ".jpeg", ".webp", ".gif", ".svg", ".avif"];
+function isImagePath(p) {
+  return IMAGE_EXTENSIONS.some((ext) => p.endsWith(ext));
+}
 async function resolveImageSource(src, file, projectRoot) {
+  if (path5.isAbsolute(src) && isImagePath(src)) {
+    try {
+      const buffer = fs5.readFileSync(src);
+      return { type: "file", buffer, path: src };
+    } catch {
+    }
+  }
   if (src.startsWith("/")) {
     const publicPath = path5.join(projectRoot, "public", src);
     try {
@@ -1957,26 +1977,135 @@ async function resolveImageSource(src, file, projectRoot) {
   }
   return { type: "unresolvable", reason: "Dynamic image source" };
 }
-function resolveStaticImportPath(importName, file) {
+function resolveStaticImportPath(importName, file, projectRoot) {
+  let name = importName;
+  if (name.endsWith(".src")) {
+    name = name.slice(0, -4);
+  }
+  if (name.includes("[") || name.includes("(")) {
+    return void 0;
+  }
   const imports = file.getImportDeclarations();
+  const filePath = file.getFilePath();
+  const root = projectRoot ?? findProjectRootFromFile(filePath);
+  const project = file.getProject();
   for (const imp of imports) {
+    const moduleSpecifier = imp.getModuleSpecifierValue();
     const defaultImport = imp.getDefaultImport();
-    if (defaultImport?.getText() === importName) {
-      const moduleSpecifier = imp.getModuleSpecifierValue();
-      if (moduleSpecifier.endsWith(".png") || moduleSpecifier.endsWith(".jpg") || moduleSpecifier.endsWith(".jpeg") || moduleSpecifier.endsWith(".webp") || moduleSpecifier.endsWith(".gif") || moduleSpecifier.endsWith(".svg") || moduleSpecifier.endsWith(".avif")) {
-        const filePath = file.getFilePath();
-        return path5.resolve(path5.dirname(filePath), moduleSpecifier);
+    if (defaultImport?.getText() === name) {
+      return resolveModuleToImage(moduleSpecifier, filePath, root, void 0, project);
+    }
+    const namedImports = imp.getNamedImports();
+    for (const named of namedImports) {
+      if (named.getName() === name || named.getAliasNode()?.getText() === name) {
+        const originalName = named.getName();
+        return resolveModuleToImage(moduleSpecifier, filePath, root, originalName, project);
+      }
+    }
+  }
+  return void 0;
+}
+function resolveModuleToImage(moduleSpecifier, fromFile, projectRoot, namedExport, project) {
+  if (isImagePath(moduleSpecifier)) {
+    return resolveModulePath(moduleSpecifier, fromFile, projectRoot, project);
+  }
+  if (namedExport) {
+    const barrelPath = resolveModulePath(moduleSpecifier, fromFile, projectRoot, project);
+    if (barrelPath) {
+      return followReExport(barrelPath, namedExport);
+    }
+  }
+  return void 0;
+}
+function resolveModulePath(moduleSpecifier, fromFile, projectRoot, project) {
+  let resolved;
+  if (moduleSpecifier.startsWith(".")) {
+    resolved = path5.resolve(path5.dirname(fromFile), moduleSpecifier);
+  } else {
+    const aliasResolved = resolvePathAlias(moduleSpecifier, projectRoot, project);
+    if (aliasResolved) {
+      resolved = aliasResolved;
+    } else {
+      return void 0;
+    }
+  }
+  if (fs5.existsSync(resolved) && fs5.statSync(resolved).isFile()) {
+    return resolved;
+  }
+  const extensions = [".ts", ".tsx", ".js", ".jsx", ...IMAGE_EXTENSIONS];
+  for (const ext of extensions) {
+    const withExt = resolved + ext;
+    if (fs5.existsSync(withExt)) return withExt;
+  }
+  const indexFiles = ["index.ts", "index.tsx", "index.js", "index.jsx"];
+  for (const idx of indexFiles) {
+    const indexPath = path5.join(resolved, idx);
+    if (fs5.existsSync(indexPath)) return indexPath;
+  }
+  return void 0;
+}
+function followReExport(barrelPath, exportName) {
+  try {
+    const content = fs5.readFileSync(barrelPath, "utf-8");
+    const reExportPattern = new RegExp(
+      `export\\s*\\{[^}]*\\b(?:default\\s+as\\s+)?${escapeRegex(exportName)}\\b[^}]*\\}\\s*from\\s*["']([^"']+)["']`
+    );
+    const match = content.match(reExportPattern);
+    if (match) {
+      const reExportPath = match[1];
+      if (isImagePath(reExportPath)) {
+        return path5.resolve(path5.dirname(barrelPath), reExportPath);
+      }
+    }
+  } catch {
+  }
+  return void 0;
+}
+function resolvePathAlias(moduleSpecifier, projectRoot, project) {
+  if (!project) return void 0;
+  const opts = project.getCompilerOptions();
+  const paths = opts.paths;
+  if (!paths) return void 0;
+  const baseDir = opts.baseUrl ?? projectRoot;
+  for (const [pattern, mappings] of Object.entries(paths)) {
+    if (pattern.endsWith("/*")) {
+      const prefix = pattern.slice(0, -1);
+      if (moduleSpecifier.startsWith(prefix)) {
+        const rest = moduleSpecifier.slice(prefix.length);
+        for (const mapping of mappings) {
+          const mappingBase = mapping.endsWith("/*") ? mapping.slice(0, -1) : mapping;
+          const resolved = path5.resolve(baseDir, mappingBase + rest);
+          return resolved;
+        }
+      }
+    } else if (pattern === moduleSpecifier) {
+      if (mappings.length > 0) {
+        return path5.resolve(baseDir, mappings[0]);
       }
     }
   }
   return void 0;
 }
+function escapeRegex(str) {
+  return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function findProjectRootFromFile(filePath) {
+  let dir = path5.dirname(filePath);
+  while (dir !== path5.dirname(dir)) {
+    if (fs5.existsSync(path5.join(dir, "package.json"))) return dir;
+    if (fs5.existsSync(path5.join(dir, "next.config.js"))) return dir;
+    if (fs5.existsSync(path5.join(dir, "next.config.mjs"))) return dir;
+    if (fs5.existsSync(path5.join(dir, "next.config.ts"))) return dir;
+    dir = path5.dirname(dir);
+  }
+  return path5.dirname(filePath);
+}
 function fetchImage(url) {
-  return new Promise((resolve4, reject) => {
+  return new Promise((resolve5, reject) => {
     const client = url.startsWith("https") ? https : http;
     const req = client.get(url, { timeout: 1e4 }, (res) => {
       if (res.statusCode && res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) {
-        fetchImage(res.headers.location).then(resolve4).catch(reject);
+        fetchImage(res.headers.location).then(resolve5).catch(reject);
         return;
       }
       const chunks = [];
@@ -1991,7 +2120,7 @@ function fetchImage(url) {
         }
         chunks.push(chunk);
       });
-      res.on("end", () => resolve4(Buffer.concat(chunks)));
+      res.on("end", () => resolve5(Buffer.concat(chunks)));
       res.on("error", reject);
     });
     req.on("error", reject);
@@ -2064,6 +2193,8 @@ async function resolveAiFixes(opts) {
 async function resolveImgAlt(file, violation, model, config2, cache) {
   const el = findElement(file, violation.line);
   if (!el) return "";
+  const filePath = file.getFilePath();
+  const projectRoot = findProjectRoot(filePath);
   const srcAttr = el.getAttribute("src");
   let srcValue = "";
   if (srcAttr?.getKind() === import_ts_morph18.SyntaxKind.JsxAttribute) {
@@ -2074,13 +2205,11 @@ async function resolveImgAlt(file, violation, model, config2, cache) {
       const expr = init.asKind(import_ts_morph18.SyntaxKind.JsxExpression)?.getExpression();
       if (expr) {
         const importName = expr.getText();
-        const importPath = resolveStaticImportPath(importName, file);
+        const importPath = resolveStaticImportPath(importName, file, projectRoot);
         srcValue = importPath ?? importName;
       }
     }
   }
-  const filePath = file.getFilePath();
-  const projectRoot = findProjectRoot(filePath);
   const imageSource = await resolveImageSource(srcValue, file, projectRoot);
   const context = extractContext(file);
   const prompt = buildImgAltPrompt({
@@ -2167,17 +2296,17 @@ function findElement(file, line) {
   return elements.find((el) => el.getStartLineNumber() === line);
 }
 function findProjectRoot(filePath) {
-  const path8 = require("path");
-  const fs8 = require("fs");
-  let dir = path8.dirname(filePath);
-  while (dir !== path8.dirname(dir)) {
-    if (fs8.existsSync(path8.join(dir, "package.json"))) return dir;
-    if (fs8.existsSync(path8.join(dir, "next.config.js"))) return dir;
-    if (fs8.existsSync(path8.join(dir, "next.config.mjs"))) return dir;
-    if (fs8.existsSync(path8.join(dir, "next.config.ts"))) return dir;
-    dir = path8.dirname(dir);
-  }
-  return path8.dirname(filePath);
+  const path9 = require("path");
+  const fs9 = require("fs");
+  let dir = path9.dirname(filePath);
+  while (dir !== path9.dirname(dir)) {
+    if (fs9.existsSync(path9.join(dir, "package.json"))) return dir;
+    if (fs9.existsSync(path9.join(dir, "next.config.js"))) return dir;
+    if (fs9.existsSync(path9.join(dir, "next.config.mjs"))) return dir;
+    if (fs9.existsSync(path9.join(dir, "next.config.ts"))) return dir;
+    dir = path9.dirname(dir);
+  }
+  return path9.dirname(filePath);
 }
 
 // src/scan/scan.ts
@@ -2199,7 +2328,9 @@ async function detect(targetPath, config2) {
     config2.scanner.include,
     config2.scanner.exclude
   );
+  const tsconfigPath = path6.join(absPath, "tsconfig.json");
   const project = new import_ts_morph19.Project({
+    tsConfigFilePath: fs6.existsSync(tsconfigPath) ? tsconfigPath : void 0,
     skipAddingFilesFromTsConfig: true,
     compilerOptions: {
       jsx: 4,
@@ -2505,7 +2636,7 @@ async function interactiveReview(violations, onAccept) {
   return { applied, skipped };
 }
 function promptAction() {
-  return new Promise((resolve4) => {
+  return new Promise((resolve5) => {
     const rl = readline.createInterface({
       input: process.stdin,
       output: process.stdout
@@ -2516,10 +2647,10 @@ function promptAction() {
       (answer) => {
         rl.close();
         const normalized = answer.trim().toLowerCase();
-        if (normalized === "n" || normalized === "no") resolve4("no");
-        else if (normalized === "s" || normalized === "skip") resolve4("skip");
-        else if (normalized === "q" || normalized === "quit") resolve4("quit");
-        else resolve4("yes");
+        if (normalized === "n" || normalized === "no") resolve5("no");
+        else if (normalized === "s" || normalized === "skip") resolve5("skip");
+        else if (normalized === "q" || normalized === "quit") resolve5("quit");
+        else resolve5("yes");
       }
     );
   });
@@ -2528,6 +2659,21 @@ function promptAction() {
 // src/cli/scan-command.ts
 function registerScanCommand(program2) {
   program2.command("scan").description("Scan files for accessibility issues").argument("<path>", "Path to scan").option("--fix", "Auto-fix issues").option("-i, --interactive", "Review each fix interactively").option("--no-ai", "Skip AI-powered fixes").option("--provider <provider>", "Override AI provider").option("--model <model>", "Override AI model").option("--min-score <score>", "Minimum score threshold (exit code 1 if below)", parseInt).action(async (targetPath, options) => {
+    let envDir = path7.resolve(targetPath);
+    if (fs7.existsSync(envDir) && fs7.statSync(envDir).isFile()) {
+      envDir = path7.dirname(envDir);
+    }
+    let searchDir = envDir;
+    while (searchDir !== path7.dirname(searchDir)) {
+      for (const envFile of [".env", ".env.local"]) {
+        const envPath = path7.join(searchDir, envFile);
+        if (fs7.existsSync(envPath)) {
+          (0, import_dotenv.config)({ path: envPath, override: false, quiet: true });
+        }
+      }
+      if (fs7.existsSync(path7.join(searchDir, "package.json"))) break;
+      searchDir = path7.dirname(searchDir);
+    }
     const fileConfig = await loadConfigFile(process.cwd());
     const config2 = resolveConfig(fileConfig, {
       fix: options.fix,
@@ -2600,8 +2746,8 @@ function registerScanCommand(program2) {
 }
 
 // src/cli/init-command.ts
-var fs7 = __toESM(require("fs"));
-var path7 = __toESM(require("path"));
+var fs8 = __toESM(require("fs"));
+var path8 = __toESM(require("path"));
 var readline2 = __toESM(require("readline"));
 var import_node_child_process = require("child_process");
 var import_picocolors5 = __toESM(require("picocolors"));
@@ -2611,15 +2757,15 @@ function registerInitCommand(program2) {
     console.log(import_picocolors5.default.bold("\n  next-a11y v0.1.4 \u2014 Setup\n"));
     const options = await promptInitOptions();
     const cwd = process.cwd();
-    const hasAppDir = fs7.existsSync(path7.join(cwd, "app"));
-    const hasSrcDir = fs7.existsSync(path7.join(cwd, "src"));
+    const hasAppDir = fs8.existsSync(path8.join(cwd, "app"));
+    const hasSrcDir = fs8.existsSync(path8.join(cwd, "src"));
     const include = [];
     if (hasSrcDir) include.push("src/**/*.{tsx,jsx}");
     if (hasAppDir) include.push("app/**/*.{tsx,jsx}");
     if (include.length === 0) include.push("**/*.{tsx,jsx}");
     const configContent = generateConfig(options.provider, include);
-    const configPath = path7.join(cwd, "a11y.config.ts");
-    fs7.writeFileSync(configPath, configContent);
+    const configPath = path8.join(cwd, "a11y.config.ts");
+    fs8.writeFileSync(configPath, configContent);
     console.log(import_picocolors5.default.green("  Created a11y.config.ts"));
     if (options.provider !== "none" && options.installDep) {
       const pkgMap = {
@@ -2643,14 +2789,14 @@ function registerInitCommand(program2) {
       }
     }
     if (options.addGitignore) {
-      const gitignorePath = path7.join(cwd, ".gitignore");
+      const gitignorePath = path8.join(cwd, ".gitignore");
       let content = "";
-      if (fs7.existsSync(gitignorePath)) {
-        content = fs7.readFileSync(gitignorePath, "utf-8");
+      if (fs8.existsSync(gitignorePath)) {
+        content = fs8.readFileSync(gitignorePath, "utf-8");
       }
       if (!content.includes(".a11y-cache")) {
         const newline = content.endsWith("\n") ? "" : "\n";
-        fs7.appendFileSync(gitignorePath, `${newline}.a11y-cache
+        fs8.appendFileSync(gitignorePath, `${newline}.a11y-cache
 `);
         console.log(import_picocolors5.default.green("  Updated .gitignore"));
       }
@@ -2691,7 +2837,7 @@ async function promptInitOptions() {
   return { provider, installDep, addGitignore };
 }
 function promptSelect(question, options) {
-  return new Promise((resolve4) => {
+  return new Promise((resolve5) => {
     const rl = readline2.createInterface({
       input: process.stdin,
       output: process.stdout
@@ -2704,15 +2850,15 @@ function promptSelect(question, options) {
       rl.close();
       const idx = parseInt(answer.trim()) - 1;
       if (idx >= 0 && idx < options.length) {
-        resolve4(options[idx].value);
+        resolve5(options[idx].value);
       } else {
-        resolve4(options[0].value);
+        resolve5(options[0].value);
       }
     });
   });
 }
 function promptYesNo(question) {
-  return new Promise((resolve4) => {
+  return new Promise((resolve5) => {
     const rl = readline2.createInterface({
       input: process.stdin,
       output: process.stdout
@@ -2720,7 +2866,7 @@ function promptYesNo(question) {
     rl.question(`  ${question} ${import_picocolors5.default.dim("[Y/n]")} `, (answer) => {
       rl.close();
       const normalized = answer.trim().toLowerCase();
-      resolve4(normalized !== "n" && normalized !== "no");
+      resolve5(normalized !== "n" && normalized !== "no");
     });
   });
 }
@@ -2798,10 +2944,10 @@ function formatBytes(bytes) {
 }
 
 // src/cli/index.ts
-(0, import_dotenv.config)({ path: ".env", override: false, quiet: true });
-(0, import_dotenv.config)({ path: ".env.local", override: true, quiet: true });
-(0, import_dotenv.config)({ path: ".env.development", override: true, quiet: true });
-(0, import_dotenv.config)({ path: ".env.development.local", override: true, quiet: true });
+(0, import_dotenv2.config)({ path: ".env", override: false, quiet: true });
+(0, import_dotenv2.config)({ path: ".env.local", override: true, quiet: true });
+(0, import_dotenv2.config)({ path: ".env.development", override: true, quiet: true });
+(0, import_dotenv2.config)({ path: ".env.development.local", override: true, quiet: true });
 var program = new import_commander.Command();
 program.name("next-a11y").description("AI-powered accessibility codemod for Next.js").version("0.1.4");
 registerScanCommand(program);

package/dist/cli/index.mjs

@@ -11,6 +11,9 @@ import { config } from "dotenv";
 import { Command } from "commander";
 
 // src/cli/scan-command.ts
+import * as fs7 from "fs";
+import * as path7 from "path";
+import { config as dotenvConfig } from "dotenv";
 import pc4 from "picocolors";
 
 // src/config/resolve.ts
@@ -42,7 +45,7 @@ async function loadConfigFile(cwd) {
 }
 function resolveConfig(fileConfig, cliFlags = {}) {
   const merged = deepMerge(DEFAULT_CONFIG, fileConfig);
-  const provider = cliFlags.provider ?? merged.provider;
+  const provider = cliFlags.provider ?? merged.provider ?? detectProviderFromEnv();
   const model = cliFlags.model ?? merged.model ?? (provider ? PROVIDER_DEFAULTS[provider] : "gpt-4.1-nano");
   return {
     provider,
@@ -60,6 +63,12 @@ function resolveConfig(fileConfig, cliFlags = {}) {
     minScore: cliFlags.minScore
   };
 }
+function detectProviderFromEnv() {
+  for (const [name, envVar] of Object.entries(PROVIDER_ENV)) {
+    if (envVar && process.env[envVar]) return name;
+  }
+  return void 0;
+}
 function deepMerge(target, source) {
   const result = { ...target };
   for (const key of Object.keys(source)) {
@@ -88,13 +97,13 @@ async function discoverFiles(basePath, include, exclude) {
   if (typeof fs2.glob === "function") {
     for (const pattern of include) {
       try {
-        const matches = await new Promise((resolve4, reject) => {
+        const matches = await new Promise((resolve5, reject) => {
           fs2.glob(
             pattern,
             { cwd: absBase },
             (err, files) => {
               if (err) reject(err);
-              else resolve4(files);
+              else resolve5(files);
             }
           );
         });
@@ -1866,7 +1875,18 @@ import * as fs5 from "fs";
 import * as path5 from "path";
 import * as https from "https";
 import * as http from "http";
+var IMAGE_EXTENSIONS = [".png", ".jpg", ".jpeg", ".webp", ".gif", ".svg", ".avif"];
+function isImagePath(p) {
+  return IMAGE_EXTENSIONS.some((ext) => p.endsWith(ext));
+}
 async function resolveImageSource(src, file, projectRoot) {
+  if (path5.isAbsolute(src) && isImagePath(src)) {
+    try {
+      const buffer = fs5.readFileSync(src);
+      return { type: "file", buffer, path: src };
+    } catch {
+    }
+  }
   if (src.startsWith("/")) {
     const publicPath = path5.join(projectRoot, "public", src);
     try {
@@ -1899,26 +1919,135 @@ async function resolveImageSource(src, file, projectRoot) {
   }
   return { type: "unresolvable", reason: "Dynamic image source" };
 }
-function resolveStaticImportPath(importName, file) {
+function resolveStaticImportPath(importName, file, projectRoot) {
+  let name = importName;
+  if (name.endsWith(".src")) {
+    name = name.slice(0, -4);
+  }
+  if (name.includes("[") || name.includes("(")) {
+    return void 0;
+  }
   const imports = file.getImportDeclarations();
+  const filePath = file.getFilePath();
+  const root = projectRoot ?? findProjectRootFromFile(filePath);
+  const project = file.getProject();
   for (const imp of imports) {
+    const moduleSpecifier = imp.getModuleSpecifierValue();
     const defaultImport = imp.getDefaultImport();
-    if (defaultImport?.getText() === importName) {
-      const moduleSpecifier = imp.getModuleSpecifierValue();
-      if (moduleSpecifier.endsWith(".png") || moduleSpecifier.endsWith(".jpg") || moduleSpecifier.endsWith(".jpeg") || moduleSpecifier.endsWith(".webp") || moduleSpecifier.endsWith(".gif") || moduleSpecifier.endsWith(".svg") || moduleSpecifier.endsWith(".avif")) {
-        const filePath = file.getFilePath();
-        return path5.resolve(path5.dirname(filePath), moduleSpecifier);
+    if (defaultImport?.getText() === name) {
+      return resolveModuleToImage(moduleSpecifier, filePath, root, void 0, project);
+    }
+    const namedImports = imp.getNamedImports();
+    for (const named of namedImports) {
+      if (named.getName() === name || named.getAliasNode()?.getText() === name) {
+        const originalName = named.getName();
+        return resolveModuleToImage(moduleSpecifier, filePath, root, originalName, project);
+      }
+    }
+  }
+  return void 0;
+}
+function resolveModuleToImage(moduleSpecifier, fromFile, projectRoot, namedExport, project) {
+  if (isImagePath(moduleSpecifier)) {
+    return resolveModulePath(moduleSpecifier, fromFile, projectRoot, project);
+  }
+  if (namedExport) {
+    const barrelPath = resolveModulePath(moduleSpecifier, fromFile, projectRoot, project);
+    if (barrelPath) {
+      return followReExport(barrelPath, namedExport);
+    }
+  }
+  return void 0;
+}
+function resolveModulePath(moduleSpecifier, fromFile, projectRoot, project) {
+  let resolved;
+  if (moduleSpecifier.startsWith(".")) {
+    resolved = path5.resolve(path5.dirname(fromFile), moduleSpecifier);
+  } else {
+    const aliasResolved = resolvePathAlias(moduleSpecifier, projectRoot, project);
+    if (aliasResolved) {
+      resolved = aliasResolved;
+    } else {
+      return void 0;
+    }
+  }
+  if (fs5.existsSync(resolved) && fs5.statSync(resolved).isFile()) {
+    return resolved;
+  }
+  const extensions = [".ts", ".tsx", ".js", ".jsx", ...IMAGE_EXTENSIONS];
+  for (const ext of extensions) {
+    const withExt = resolved + ext;
+    if (fs5.existsSync(withExt)) return withExt;
+  }
+  const indexFiles = ["index.ts", "index.tsx", "index.js", "index.jsx"];
+  for (const idx of indexFiles) {
+    const indexPath = path5.join(resolved, idx);
+    if (fs5.existsSync(indexPath)) return indexPath;
+  }
+  return void 0;
+}
+function followReExport(barrelPath, exportName) {
+  try {
+    const content = fs5.readFileSync(barrelPath, "utf-8");
+    const reExportPattern = new RegExp(
+      `export\\s*\\{[^}]*\\b(?:default\\s+as\\s+)?${escapeRegex(exportName)}\\b[^}]*\\}\\s*from\\s*["']([^"']+)["']`
+    );
+    const match = content.match(reExportPattern);
+    if (match) {
+      const reExportPath = match[1];
+      if (isImagePath(reExportPath)) {
+        return path5.resolve(path5.dirname(barrelPath), reExportPath);
       }
     }
+  } catch {
   }
   return void 0;
 }
+function resolvePathAlias(moduleSpecifier, projectRoot, project) {
+  if (!project) return void 0;
+  const opts = project.getCompilerOptions();
+  const paths = opts.paths;
+  if (!paths) return void 0;
+  const baseDir = opts.baseUrl ?? projectRoot;
+  for (const [pattern, mappings] of Object.entries(paths)) {
+    if (pattern.endsWith("/*")) {
+      const prefix = pattern.slice(0, -1);
+      if (moduleSpecifier.startsWith(prefix)) {
+        const rest = moduleSpecifier.slice(prefix.length);
+        for (const mapping of mappings) {
+          const mappingBase = mapping.endsWith("/*") ? mapping.slice(0, -1) : mapping;
+          const resolved = path5.resolve(baseDir, mappingBase + rest);
+          return resolved;
+        }
+      }
+    } else if (pattern === moduleSpecifier) {
+      if (mappings.length > 0) {
+        return path5.resolve(baseDir, mappings[0]);
+      }
+    }
+  }
+  return void 0;
+}
+function escapeRegex(str) {
+  return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function findProjectRootFromFile(filePath) {
+  let dir = path5.dirname(filePath);
+  while (dir !== path5.dirname(dir)) {
+    if (fs5.existsSync(path5.join(dir, "package.json"))) return dir;
+    if (fs5.existsSync(path5.join(dir, "next.config.js"))) return dir;
+    if (fs5.existsSync(path5.join(dir, "next.config.mjs"))) return dir;
+    if (fs5.existsSync(path5.join(dir, "next.config.ts"))) return dir;
+    dir = path5.dirname(dir);
+  }
+  return path5.dirname(filePath);
+}
 function fetchImage(url) {
-  return new Promise((resolve4, reject) => {
+  return new Promise((resolve5, reject) => {
     const client = url.startsWith("https") ? https : http;
     const req = client.get(url, { timeout: 1e4 }, (res) => {
       if (res.statusCode && res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) {
-        fetchImage(res.headers.location).then(resolve4).catch(reject);
+        fetchImage(res.headers.location).then(resolve5).catch(reject);
         return;
       }
       const chunks = [];
@@ -1933,7 +2062,7 @@ function fetchImage(url) {
         }
         chunks.push(chunk);
       });
-      res.on("end", () => resolve4(Buffer.concat(chunks)));
+      res.on("end", () => resolve5(Buffer.concat(chunks)));
       res.on("error", reject);
     });
     req.on("error", reject);
@@ -2006,6 +2135,8 @@ async function resolveAiFixes(opts) {
 async function resolveImgAlt(file, violation, model, config2, cache) {
   const el = findElement(file, violation.line);
   if (!el) return "";
+  const filePath = file.getFilePath();
+  const projectRoot = findProjectRoot(filePath);
   const srcAttr = el.getAttribute("src");
   let srcValue = "";
   if (srcAttr?.getKind() === SyntaxKind18.JsxAttribute) {
@@ -2016,13 +2147,11 @@ async function resolveImgAlt(file, violation, model, config2, cache) {
       const expr = init.asKind(SyntaxKind18.JsxExpression)?.getExpression();
       if (expr) {
         const importName = expr.getText();
-        const importPath = resolveStaticImportPath(importName, file);
+        const importPath = resolveStaticImportPath(importName, file, projectRoot);
         srcValue = importPath ?? importName;
       }
     }
   }
-  const filePath = file.getFilePath();
-  const projectRoot = findProjectRoot(filePath);
   const imageSource = await resolveImageSource(srcValue, file, projectRoot);
   const context = extractContext(file);
   const prompt = buildImgAltPrompt({
@@ -2109,17 +2238,17 @@ function findElement(file, line) {
   return elements.find((el) => el.getStartLineNumber() === line);
 }
 function findProjectRoot(filePath) {
-  const path8 = __require("path");
-  const fs8 = __require("fs");
-  let dir = path8.dirname(filePath);
-  while (dir !== path8.dirname(dir)) {
-    if (fs8.existsSync(path8.join(dir, "package.json"))) return dir;
-    if (fs8.existsSync(path8.join(dir, "next.config.js"))) return dir;
-    if (fs8.existsSync(path8.join(dir, "next.config.mjs"))) return dir;
-    if (fs8.existsSync(path8.join(dir, "next.config.ts"))) return dir;
-    dir = path8.dirname(dir);
-  }
-  return path8.dirname(filePath);
+  const path9 = __require("path");
+  const fs9 = __require("fs");
+  let dir = path9.dirname(filePath);
+  while (dir !== path9.dirname(dir)) {
+    if (fs9.existsSync(path9.join(dir, "package.json"))) return dir;
+    if (fs9.existsSync(path9.join(dir, "next.config.js"))) return dir;
+    if (fs9.existsSync(path9.join(dir, "next.config.mjs"))) return dir;
+    if (fs9.existsSync(path9.join(dir, "next.config.ts"))) return dir;
+    dir = path9.dirname(dir);
+  }
+  return path9.dirname(filePath);
 }
 
 // src/scan/scan.ts
@@ -2141,7 +2270,9 @@ async function detect(targetPath, config2) {
     config2.scanner.include,
     config2.scanner.exclude
   );
+  const tsconfigPath = path6.join(absPath, "tsconfig.json");
   const project = new Project2({
+    tsConfigFilePath: fs6.existsSync(tsconfigPath) ? tsconfigPath : void 0,
     skipAddingFilesFromTsConfig: true,
     compilerOptions: {
       jsx: 4,
@@ -2447,7 +2578,7 @@ async function interactiveReview(violations, onAccept) {
   return { applied, skipped };
 }
 function promptAction() {
-  return new Promise((resolve4) => {
+  return new Promise((resolve5) => {
     const rl = readline.createInterface({
       input: process.stdin,
       output: process.stdout
@@ -2458,10 +2589,10 @@ function promptAction() {
       (answer) => {
         rl.close();
         const normalized = answer.trim().toLowerCase();
-        if (normalized === "n" || normalized === "no") resolve4("no");
-        else if (normalized === "s" || normalized === "skip") resolve4("skip");
-        else if (normalized === "q" || normalized === "quit") resolve4("quit");
-        else resolve4("yes");
+        if (normalized === "n" || normalized === "no") resolve5("no");
+        else if (normalized === "s" || normalized === "skip") resolve5("skip");
+        else if (normalized === "q" || normalized === "quit") resolve5("quit");
+        else resolve5("yes");
       }
     );
   });
@@ -2470,6 +2601,21 @@ function promptAction() {
 // src/cli/scan-command.ts
 function registerScanCommand(program2) {
   program2.command("scan").description("Scan files for accessibility issues").argument("<path>", "Path to scan").option("--fix", "Auto-fix issues").option("-i, --interactive", "Review each fix interactively").option("--no-ai", "Skip AI-powered fixes").option("--provider <provider>", "Override AI provider").option("--model <model>", "Override AI model").option("--min-score <score>", "Minimum score threshold (exit code 1 if below)", parseInt).action(async (targetPath, options) => {
+    let envDir = path7.resolve(targetPath);
+    if (fs7.existsSync(envDir) && fs7.statSync(envDir).isFile()) {
+      envDir = path7.dirname(envDir);
+    }
+    let searchDir = envDir;
+    while (searchDir !== path7.dirname(searchDir)) {
+      for (const envFile of [".env", ".env.local"]) {
+        const envPath = path7.join(searchDir, envFile);
+        if (fs7.existsSync(envPath)) {
+          dotenvConfig({ path: envPath, override: false, quiet: true });
+        }
+      }
+      if (fs7.existsSync(path7.join(searchDir, "package.json"))) break;
+      searchDir = path7.dirname(searchDir);
+    }
     const fileConfig = await loadConfigFile(process.cwd());
     const config2 = resolveConfig(fileConfig, {
       fix: options.fix,
@@ -2542,8 +2688,8 @@ function registerScanCommand(program2) {
 }
 
 // src/cli/init-command.ts
-import * as fs7 from "fs";
-import * as path7 from "path";
+import * as fs8 from "fs";
+import * as path8 from "path";
 import * as readline2 from "readline";
 import { execSync } from "child_process";
 import pc5 from "picocolors";
@@ -2553,15 +2699,15 @@ function registerInitCommand(program2) {
     console.log(pc5.bold("\n  next-a11y v0.1.4 \u2014 Setup\n"));
     const options = await promptInitOptions();
     const cwd = process.cwd();
-    const hasAppDir = fs7.existsSync(path7.join(cwd, "app"));
-    const hasSrcDir = fs7.existsSync(path7.join(cwd, "src"));
+    const hasAppDir = fs8.existsSync(path8.join(cwd, "app"));
+    const hasSrcDir = fs8.existsSync(path8.join(cwd, "src"));
     const include = [];
     if (hasSrcDir) include.push("src/**/*.{tsx,jsx}");
     if (hasAppDir) include.push("app/**/*.{tsx,jsx}");
     if (include.length === 0) include.push("**/*.{tsx,jsx}");
     const configContent = generateConfig(options.provider, include);
-    const configPath = path7.join(cwd, "a11y.config.ts");
-    fs7.writeFileSync(configPath, configContent);
+    const configPath = path8.join(cwd, "a11y.config.ts");
+    fs8.writeFileSync(configPath, configContent);
     console.log(pc5.green("  Created a11y.config.ts"));
     if (options.provider !== "none" && options.installDep) {
       const pkgMap = {
@@ -2585,14 +2731,14 @@ function registerInitCommand(program2) {
       }
     }
     if (options.addGitignore) {
-      const gitignorePath = path7.join(cwd, ".gitignore");
+      const gitignorePath = path8.join(cwd, ".gitignore");
       let content = "";
-      if (fs7.existsSync(gitignorePath)) {
-        content = fs7.readFileSync(gitignorePath, "utf-8");
+      if (fs8.existsSync(gitignorePath)) {
+        content = fs8.readFileSync(gitignorePath, "utf-8");
       }
       if (!content.includes(".a11y-cache")) {
         const newline = content.endsWith("\n") ? "" : "\n";
-        fs7.appendFileSync(gitignorePath, `${newline}.a11y-cache
+        fs8.appendFileSync(gitignorePath, `${newline}.a11y-cache
 `);
         console.log(pc5.green("  Updated .gitignore"));
       }
@@ -2633,7 +2779,7 @@ async function promptInitOptions() {
   return { provider, installDep, addGitignore };
 }
 function promptSelect(question, options) {
-  return new Promise((resolve4) => {
+  return new Promise((resolve5) => {
     const rl = readline2.createInterface({
       input: process.stdin,
       output: process.stdout
@@ -2646,15 +2792,15 @@ function promptSelect(question, options) {
       rl.close();
       const idx = parseInt(answer.trim()) - 1;
       if (idx >= 0 && idx < options.length) {
-        resolve4(options[idx].value);
+        resolve5(options[idx].value);
       } else {
-        resolve4(options[0].value);
+        resolve5(options[0].value);
       }
     });
   });
 }
 function promptYesNo(question) {
-  return new Promise((resolve4) => {
+  return new Promise((resolve5) => {
     const rl = readline2.createInterface({
       input: process.stdin,
       output: process.stdout
@@ -2662,7 +2808,7 @@ function promptYesNo(question) {
     rl.question(`  ${question} ${pc5.dim("[Y/n]")} `, (answer) => {
       rl.close();
       const normalized = answer.trim().toLowerCase();
-      resolve4(normalized !== "n" && normalized !== "no");
+      resolve5(normalized !== "n" && normalized !== "no");
     });
   });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "next-a11y",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "AI-powered accessibility codemod for Next.js",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",