ai-localize-framework-detectors 2.0.3 → 2.0.4

package/package.json

@@ -1,10 +1,15 @@
 {
   "name": "ai-localize-framework-detectors",
-  "version": "2.0.3",
+  "version": "2.0.4",
   "description": "Auto-detect frontend frameworks from project structure",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
   "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "CHANGELOG.md"
+  ],
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -12,8 +17,23 @@
       "require": "./dist/index.js"
     }
   },
+  "keywords": [
+    "i18n",
+    "localization",
+    "l10n",
+    "internationalization",
+    "ai-localize",
+    "framework-detection",
+    "react",
+    "vue",
+    "angular",
+    "nextjs"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
   "dependencies": {
-    "ai-localize-shared": "2.0.3"
+    "ai-localize-shared": "2.0.4"
   },
   "devDependencies": {
     "tsup": "^8.0.1",

package/src/detector.ts

@@ -1,212 +0,0 @@
-import * as fs from 'fs';
-import * as path from 'path';
-
-import type { Framework } from 'ai-localize-shared';
-import { readJsonSafe } from 'ai-localize-shared';
-
-export interface DetectionResult {
-  framework: Framework;
-  confidence: number;
-  evidence: string[];
-  variant?: string;
-}
-
-interface PackageJson {
-  dependencies?: Record<string, string>;
-  devDependencies?: Record<string, string>;
-  peerDependencies?: Record<string, string>;
-  scripts?: Record<string, string>;
-  name?: string;
-}
-
-/**
- * Detects the frontend framework used in a project directory.
- * Uses package.json dependencies, config files, and folder structure.
- */
-export class FrameworkDetector {
-  private projectRoot: string;
-  private pkg: PackageJson | null;
-
-  constructor(projectRoot: string) {
-    this.projectRoot = projectRoot;
-    this.pkg = readJsonSafe<PackageJson>(path.join(projectRoot, 'package.json'));
-  }
-
-  detect(): DetectionResult {
-    const results: DetectionResult[] = [
-    this.detectNextJs(),
-      this.detectReact(),
-      this.detectAngular(),
-      this.detectVue(),
-      this.detectJQuery(),
-      this.detectVanillaJs(),
-      this.detectJsp(),
-    ];
-
-  // Sort by confidence descending
-    results.sort((a, b) => b.confidence - a.confidence);
-    const best = results[0];
-
-    if (best.confidence === 0) {
-      return { framework: 'unknown', confidence: 0, evidence: ['No framework detected'] };
-    }
-    return best;
-  }
-
-  private allDeps(): Record<string, string> {
-    if (!this.pkg) return {};
-    return {
-      ...(this.pkg.dependencies || {}),
-      ...(this.pkg.devDependencies || {}),
-    ...(this.pkg.peerDependencies || {}),
-  };
-  }
-
-  private hasDep(name: string): boolean {
-    return name in this.allDeps();
-  }
-
-private fileExists(relPath: string): boolean {
-    return fs.existsSync(path.join(this.projectRoot, relPath));
-  }
-
-  private detectNextJs(): DetectionResult {
-    const evidence: string[] = [];
-    let confidence = 0;
-
-    if (this.hasDep('next')) { evidence.push('dep: next'); confidence += 50; }
-    if (this.fileExists('next.config.js') || this.fileExists('next.config.ts') || this.fileExists('next.config.mjs')) {
-      evidence.push('next.config.js found'); confidence += 40;
-    }
-    if (this.fileExists('pages') || this.fileExists('app')) {
-   evidence.push('pages/app directory found'); confidence += 10;
-    }
-
-    return { framework: 'react-nextjs', confidence, evidence };
-  }
-
-  private detectReact(): DetectionResult {
-    const evidence: string[] = [];
-    let confidence = 0;
-    let variant: Framework = 'react';
-
-    if (this.hasDep('react')) { evidence.push('dep: react'); confidence += 40; }
-    if (this.hasDep('react-dom')) { evidence.push('dep: react-dom'); confidence += 10; }
-
-    // Vite
-    if (this.hasDep('vite') || this.fileExists('vite.config.ts') || this.fileExists('vite.config.js')) {
-    evidence.push('vite config found'); confidence += 30; variant = 'react-vite';
-    }
-
-    // CRA
-    if (this.hasDep('react-scripts')) {
-      evidence.push('dep: react-scripts (CRA)'); confidence += 30; variant = 'react-cra';
-}
-
-    // React without specific build tool
-    if (confidence >= 50 && variant === 'react') {
-      evidence.push('generic react project');
-  }
-
-    return { framework: variant, confidence, evidence };
-  }
-
-  private detectAngular(): DetectionResult {
-    const evidence: string[] = [];
-    let confidence = 0;
-    let variant: Framework = 'angular';
-
-    if (this.hasDep('@angular/core')) { evidence.push('dep: @angular/core'); confidence += 50; }
-    if (this.fileExists('angular.json')) { evidence.push('angular.json found'); confidence += 30; }
-    if (this.fileExists('tsconfig.app.json')) { evidence.push('tsconfig.app.json found'); confidence += 10; }
-
-  if (this.hasDep('@ngx-translate/core')) {
-      evidence.push('dep: @ngx-translate/core'); confidence += 10; variant = 'angular-ngx';
-    } else if (confidence > 0) {
-      variant = 'angular-i18n';
-    }
-
-    return { framework: variant, confidence, evidence };
-  }
-
-  private detectVue(): DetectionResult {
-    const evidence: string[] = [];
-    let confidence = 0;
-    let variant: Framework = 'vue';
-
-    if (this.hasDep('vue')) { evidence.push('dep: vue'); confidence += 50; }
-    if (this.hasDep('@vue/cli-service') || this.fileExists('vue.config.js')) {
-      evidence.push('vue-cli config found'); confidence += 20;
-    }
-    if (this.hasDep('vite') && confidence > 0) {
-      evidence.push('vite (vue)'); confidence += 20;
-    }
-    if (this.hasDep('vue-i18n')) {
-  evidence.push('dep: vue-i18n'); confidence += 10; variant = 'vue-i18n';
-    }
-
-    return { framework: variant, confidence, evidence };
-  }
-
-  private detectJQuery(): DetectionResult {
-    const evidence: string[] = [];
-    let confidence = 0;
-
-    if (this.hasDep('jquery')) { evidence.push('dep: jquery'); confidence += 60; }
-    // Check for jQuery usage in common files
-    const htmlFiles = ['index.html', 'public/index.html'];
-    for (const f of htmlFiles) {
-      if (!this.fileExists(f)) continue;
-      try {
-        const content = fs.readFileSync(path.join(this.projectRoot, f), 'utf-8');
-        if (content.includes('jquery') || content.includes('jQuery')) {
-   evidence.push(`jQuery reference in ${f}`); confidence += 20;
-        }
-      } catch { /* ignore */ }
-    }
-
-    return { framework: 'jquery', confidence, evidence };
-  }
-
-  private detectVanillaJs(): DetectionResult {
-    const evidence: string[] = [];
-    let confidence = 0;
-
-    if (!this.pkg) {
-      evidence.push('No package.json'); confidence = 20;
-    } else {
-      const deps = Object.keys(this.allDeps());
-      if (deps.length === 0) { evidence.push('No dependencies'); confidence = 30; }
-    }
-
-    // Check for plain HTML entry
-    if (this.fileExists('index.html')) {
-      evidence.push('index.html found'); confidence += 10;
-    }
-
-    return { framework: 'vanilla-js', confidence, evidence };
-  }
-
-private detectJsp(): DetectionResult {
-    const evidence: string[] = [];
-    let confidence = 0;
-
-    // JSP projects typically have WEB-INF and .jsp files
-    if (this.fileExists('WEB-INF') || this.fileExists('src/main/webapp')) {
-      evidence.push('WEB-INF/webapp found'); confidence += 50;
-    }
-    if (this.fileExists('pom.xml') || this.fileExists('build.gradle')) {
-      evidence.push('Java build file found'); confidence += 30;
-    }
-
-    return { framework: 'jsp', confidence, evidence };
-  }
-}
-
-/**
- * Convenience function to detect framework in a directory
- */
-export function detectFramework(projectRoot: string): DetectionResult {
-  const detector = new FrameworkDetector(projectRoot);
-  return detector.detect();
-}

package/src/i18n-detector.ts

@@ -1,140 +0,0 @@
-import * as fs from 'fs';
-import * as path from 'path';
-
-import { readJsonSafe } from 'ai-localize-shared';
-import type { Framework } from 'ai-localize-shared';
-
-export interface I18nSetupResult {
-  hasI18n: boolean;
-  library?: string;
-  configFile?: string;
-  localesDir?: string;
-  namespaces?: string[];
-  defaultLanguage?: string;
-  targetLanguages?: string[];
-}
-
-interface PackageJson {
-  dependencies?: Record<string, string>;
-  devDependencies?: Record<string, string>;
-}
-
-/** Detects existing i18n setup in a project */
-export class I18nDetector {
-  private root: string;
-  private pkg: PackageJson | null;
-
-  constructor(projectRoot: string) {
-    this.root = projectRoot;
-this.pkg = readJsonSafe<PackageJson>(path.join(projectRoot, 'package.json'));
-  }
-
-  detect(framework: Framework): I18nSetupResult {
-    switch (framework) {
-      case 'react':
-      case 'react-cra':
-      case 'react-vite':
-   case 'react-nextjs':
-        return this.detectReactI18n();
-      case 'angular':
-      case 'angular-ngx':
-      case 'angular-i18n':
-        return this.detectAngularI18n();
-      case 'vue':
-      case 'vue-i18n':
-        return this.detectVueI18n();
-      default:
-        return this.detectGenericI18n();
-    }
-  }
-
-  private allDeps(): Record<string, string> {
-    return {
-      ...(this.pkg?.dependencies || {}),
-      ...(this.pkg?.devDependencies || {}),
-    };
-  }
-
-  private fileExists(rel: string): boolean {
-    return fs.existsSync(path.join(this.root, rel));
-  }
-
-  private findLocalesDir(): string | undefined {
-    const candidates = ['locales', 'src/locales', 'i18n', 'src/i18n', 'public/locales'];
-    return candidates.find((c) => this.fileExists(c));
-  }
-
-  private detectLanguagesFromLocalesDir(localesDir?: string): string[] {
-    if (!localesDir) return [];
-    const full = path.join(this.root, localesDir);
-    try {
-      return fs
-        .readdirSync(full, { withFileTypes: true })
-        .filter((e) => e.isDirectory())
-    .map((e) => e.name);
-    } catch {
-      return [];
-    }
-  }
-
-  private detectReactI18n(): I18nSetupResult {
- const deps = this.allDeps();
-    if (!deps['i18next'] && !deps['react-i18next']) {
-      return { hasI18n: false };
-    }
-
-    const localesDir = this.findLocalesDir();
-    const languages = this.detectLanguagesFromLocalesDir(localesDir);
-    const configFile = ['i18n.ts', 'i18n.js', 'src/i18n.ts', 'src/i18n.js'].find((f) =>
-      this.fileExists(f)
-    );
-
-    return {
-      hasI18n: true,
-      library: 'react-i18next',
-      configFile,
-      localesDir,
-      defaultLanguage: languages[0] || 'en',
-      targetLanguages: languages.slice(1),
-    };
-  }
-
-  private detectAngularI18n(): I18nSetupResult {
-    const deps = this.allDeps();
-    if (!deps['@ngx-translate/core'] && !deps['@angular/localize']) {
-      return { hasI18n: false };
-    }
-
-    const localesDir = this.findLocalesDir();
-    const library = deps['@ngx-translate/core'] ? '@ngx-translate/core' : '@angular/localize';
-
-    return {
-      hasI18n: true,
-  library,
-      localesDir,
-      defaultLanguage: 'en',
-    };
-  }
-
-  private detectVueI18n(): I18nSetupResult {
-    const deps = this.allDeps();
-    if (!deps['vue-i18n']) return { hasI18n: false };
-
- const localesDir = this.findLocalesDir();
-    const languages = this.detectLanguagesFromLocalesDir(localesDir);
-
-    return {
-hasI18n: true,
-   library: 'vue-i18n',
-      localesDir,
-      defaultLanguage: languages[0] || 'en',
-      targetLanguages: languages.slice(1),
-    };
-  }
-
-  private detectGenericI18n(): I18nSetupResult {
-    const localesDir = this.findLocalesDir();
-    if (!localesDir) return { hasI18n: false };
-    return { hasI18n: true, localesDir };
-  }
-}

package/src/index.ts

@@ -1,2 +0,0 @@
-export * from './detector.js';
-export * from './i18n-detector.js';

package/tsconfig.json

@@ -1,9 +0,0 @@
-{
-  "extends": "../../tsconfig.base.json",
-  "compilerOptions": {
-    "outDir": "./dist",
-    "rootDir": "./src"
-  },
-  "include": ["src/**/*"],
-  "exclude": ["node_modules", "dist"]
-}