ai-localize-framework-detectors 1.0.0

package/dist/index.d.mts

@@ -0,0 +1,59 @@
+import { Framework } from '@ai-localize/shared';
+
+interface DetectionResult {
+    framework: Framework;
+    confidence: number;
+    evidence: string[];
+    variant?: string;
+}
+/**
+ * Detects the frontend framework used in a project directory.
+ * Uses package.json dependencies, config files, and folder structure.
+ */
+declare class FrameworkDetector {
+    private projectRoot;
+    private pkg;
+    constructor(projectRoot: string);
+    detect(): DetectionResult;
+    private allDeps;
+    private hasDep;
+    private fileExists;
+    private detectNextJs;
+    private detectReact;
+    private detectAngular;
+    private detectVue;
+    private detectJQuery;
+    private detectVanillaJs;
+    private detectJsp;
+}
+/**
+ * Convenience function to detect framework in a directory
+ */
+declare function detectFramework(projectRoot: string): DetectionResult;
+
+interface I18nSetupResult {
+    hasI18n: boolean;
+    library?: string;
+    configFile?: string;
+    localesDir?: string;
+    namespaces?: string[];
+    defaultLanguage?: string;
+    targetLanguages?: string[];
+}
+/** Detects existing i18n setup in a project */
+declare class I18nDetector {
+    private root;
+    private pkg;
+    constructor(projectRoot: string);
+    detect(framework: Framework): I18nSetupResult;
+    private allDeps;
+    private fileExists;
+    private findLocalesDir;
+    private detectLanguagesFromLocalesDir;
+    private detectReactI18n;
+    private detectAngularI18n;
+    private detectVueI18n;
+    private detectGenericI18n;
+}
+
+export { type DetectionResult, FrameworkDetector, I18nDetector, type I18nSetupResult, detectFramework };

package/dist/index.d.ts

@@ -0,0 +1,59 @@
+import { Framework } from '@ai-localize/shared';
+
+interface DetectionResult {
+    framework: Framework;
+    confidence: number;
+    evidence: string[];
+    variant?: string;
+}
+/**
+ * Detects the frontend framework used in a project directory.
+ * Uses package.json dependencies, config files, and folder structure.
+ */
+declare class FrameworkDetector {
+    private projectRoot;
+    private pkg;
+    constructor(projectRoot: string);
+    detect(): DetectionResult;
+    private allDeps;
+    private hasDep;
+    private fileExists;
+    private detectNextJs;
+    private detectReact;
+    private detectAngular;
+    private detectVue;
+    private detectJQuery;
+    private detectVanillaJs;
+    private detectJsp;
+}
+/**
+ * Convenience function to detect framework in a directory
+ */
+declare function detectFramework(projectRoot: string): DetectionResult;
+
+interface I18nSetupResult {
+    hasI18n: boolean;
+    library?: string;
+    configFile?: string;
+    localesDir?: string;
+    namespaces?: string[];
+    defaultLanguage?: string;
+    targetLanguages?: string[];
+}
+/** Detects existing i18n setup in a project */
+declare class I18nDetector {
+    private root;
+    private pkg;
+    constructor(projectRoot: string);
+    detect(framework: Framework): I18nSetupResult;
+    private allDeps;
+    private fileExists;
+    private findLocalesDir;
+    private detectLanguagesFromLocalesDir;
+    private detectReactI18n;
+    private detectAngularI18n;
+    private detectVueI18n;
+    private detectGenericI18n;
+}
+
+export { type DetectionResult, FrameworkDetector, I18nDetector, type I18nSetupResult, detectFramework };

package/dist/index.js

@@ -0,0 +1,340 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  FrameworkDetector: () => FrameworkDetector,
+  I18nDetector: () => I18nDetector,
+  detectFramework: () => detectFramework
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/detector.ts
+var fs = __toESM(require("fs"));
+var path = __toESM(require("path"));
+var import_shared = require("@ai-localize/shared");
+var FrameworkDetector = class {
+  projectRoot;
+  pkg;
+  constructor(projectRoot) {
+    this.projectRoot = projectRoot;
+    this.pkg = (0, import_shared.readJsonSafe)(path.join(projectRoot, "package.json"));
+  }
+  detect() {
+    const results = [
+      this.detectNextJs(),
+      this.detectReact(),
+      this.detectAngular(),
+      this.detectVue(),
+      this.detectJQuery(),
+      this.detectVanillaJs(),
+      this.detectJsp()
+    ];
+    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;
+  }
+  allDeps() {
+    if (!this.pkg) return {};
+    return {
+      ...this.pkg.dependencies || {},
+      ...this.pkg.devDependencies || {},
+      ...this.pkg.peerDependencies || {}
+    };
+  }
+  hasDep(name) {
+    return name in this.allDeps();
+  }
+  fileExists(relPath) {
+    return fs.existsSync(path.join(this.projectRoot, relPath));
+  }
+  detectNextJs() {
+    const evidence = [];
+    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 };
+  }
+  detectReact() {
+    const evidence = [];
+    let confidence = 0;
+    let variant = "react";
+    if (this.hasDep("react")) {
+      evidence.push("dep: react");
+      confidence += 40;
+    }
+    if (this.hasDep("react-dom")) {
+      evidence.push("dep: react-dom");
+      confidence += 10;
+    }
+    if (this.hasDep("vite") || this.fileExists("vite.config.ts") || this.fileExists("vite.config.js")) {
+      evidence.push("vite config found");
+      confidence += 30;
+      variant = "react-vite";
+    }
+    if (this.hasDep("react-scripts")) {
+      evidence.push("dep: react-scripts (CRA)");
+      confidence += 30;
+      variant = "react-cra";
+    }
+    if (confidence >= 50 && variant === "react") {
+      evidence.push("generic react project");
+    }
+    return { framework: variant, confidence, evidence };
+  }
+  detectAngular() {
+    const evidence = [];
+    let confidence = 0;
+    let variant = "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 };
+  }
+  detectVue() {
+    const evidence = [];
+    let confidence = 0;
+    let variant = "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 };
+  }
+  detectJQuery() {
+    const evidence = [];
+    let confidence = 0;
+    if (this.hasDep("jquery")) {
+      evidence.push("dep: jquery");
+      confidence += 60;
+    }
+    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 {
+      }
+    }
+    return { framework: "jquery", confidence, evidence };
+  }
+  detectVanillaJs() {
+    const evidence = [];
+    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;
+      }
+    }
+    if (this.fileExists("index.html")) {
+      evidence.push("index.html found");
+      confidence += 10;
+    }
+    return { framework: "vanilla-js", confidence, evidence };
+  }
+  detectJsp() {
+    const evidence = [];
+    let confidence = 0;
+    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 };
+  }
+};
+function detectFramework(projectRoot) {
+  const detector = new FrameworkDetector(projectRoot);
+  return detector.detect();
+}
+
+// src/i18n-detector.ts
+var fs2 = __toESM(require("fs"));
+var path2 = __toESM(require("path"));
+var import_shared2 = require("@ai-localize/shared");
+var I18nDetector = class {
+  root;
+  pkg;
+  constructor(projectRoot) {
+    this.root = projectRoot;
+    this.pkg = (0, import_shared2.readJsonSafe)(path2.join(projectRoot, "package.json"));
+  }
+  detect(framework) {
+    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();
+    }
+  }
+  allDeps() {
+    return {
+      ...this.pkg?.dependencies || {},
+      ...this.pkg?.devDependencies || {}
+    };
+  }
+  fileExists(rel) {
+    return fs2.existsSync(path2.join(this.root, rel));
+  }
+  findLocalesDir() {
+    const candidates = ["locales", "src/locales", "i18n", "src/i18n", "public/locales"];
+    return candidates.find((c) => this.fileExists(c));
+  }
+  detectLanguagesFromLocalesDir(localesDir) {
+    if (!localesDir) return [];
+    const full = path2.join(this.root, localesDir);
+    try {
+      return fs2.readdirSync(full, { withFileTypes: true }).filter((e) => e.isDirectory()).map((e) => e.name);
+    } catch {
+      return [];
+    }
+  }
+  detectReactI18n() {
+    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)
+    };
+  }
+  detectAngularI18n() {
+    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"
+    };
+  }
+  detectVueI18n() {
+    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)
+    };
+  }
+  detectGenericI18n() {
+    const localesDir = this.findLocalesDir();
+    if (!localesDir) return { hasI18n: false };
+    return { hasI18n: true, localesDir };
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  FrameworkDetector,
+  I18nDetector,
+  detectFramework
+});

package/dist/index.mjs

@@ -0,0 +1,301 @@
+// src/detector.ts
+import * as fs from "fs";
+import * as path from "path";
+import { readJsonSafe } from "@ai-localize/shared";
+var FrameworkDetector = class {
+  projectRoot;
+  pkg;
+  constructor(projectRoot) {
+    this.projectRoot = projectRoot;
+    this.pkg = readJsonSafe(path.join(projectRoot, "package.json"));
+  }
+  detect() {
+    const results = [
+      this.detectNextJs(),
+      this.detectReact(),
+      this.detectAngular(),
+      this.detectVue(),
+      this.detectJQuery(),
+      this.detectVanillaJs(),
+      this.detectJsp()
+    ];
+    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;
+  }
+  allDeps() {
+    if (!this.pkg) return {};
+    return {
+      ...this.pkg.dependencies || {},
+      ...this.pkg.devDependencies || {},
+      ...this.pkg.peerDependencies || {}
+    };
+  }
+  hasDep(name) {
+    return name in this.allDeps();
+  }
+  fileExists(relPath) {
+    return fs.existsSync(path.join(this.projectRoot, relPath));
+  }
+  detectNextJs() {
+    const evidence = [];
+    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 };
+  }
+  detectReact() {
+    const evidence = [];
+    let confidence = 0;
+    let variant = "react";
+    if (this.hasDep("react")) {
+      evidence.push("dep: react");
+      confidence += 40;
+    }
+    if (this.hasDep("react-dom")) {
+      evidence.push("dep: react-dom");
+      confidence += 10;
+    }
+    if (this.hasDep("vite") || this.fileExists("vite.config.ts") || this.fileExists("vite.config.js")) {
+      evidence.push("vite config found");
+      confidence += 30;
+      variant = "react-vite";
+    }
+    if (this.hasDep("react-scripts")) {
+      evidence.push("dep: react-scripts (CRA)");
+      confidence += 30;
+      variant = "react-cra";
+    }
+    if (confidence >= 50 && variant === "react") {
+      evidence.push("generic react project");
+    }
+    return { framework: variant, confidence, evidence };
+  }
+  detectAngular() {
+    const evidence = [];
+    let confidence = 0;
+    let variant = "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 };
+  }
+  detectVue() {
+    const evidence = [];
+    let confidence = 0;
+    let variant = "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 };
+  }
+  detectJQuery() {
+    const evidence = [];
+    let confidence = 0;
+    if (this.hasDep("jquery")) {
+      evidence.push("dep: jquery");
+      confidence += 60;
+    }
+    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 {
+      }
+    }
+    return { framework: "jquery", confidence, evidence };
+  }
+  detectVanillaJs() {
+    const evidence = [];
+    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;
+      }
+    }
+    if (this.fileExists("index.html")) {
+      evidence.push("index.html found");
+      confidence += 10;
+    }
+    return { framework: "vanilla-js", confidence, evidence };
+  }
+  detectJsp() {
+    const evidence = [];
+    let confidence = 0;
+    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 };
+  }
+};
+function detectFramework(projectRoot) {
+  const detector = new FrameworkDetector(projectRoot);
+  return detector.detect();
+}
+
+// src/i18n-detector.ts
+import * as fs2 from "fs";
+import * as path2 from "path";
+import { readJsonSafe as readJsonSafe2 } from "@ai-localize/shared";
+var I18nDetector = class {
+  root;
+  pkg;
+  constructor(projectRoot) {
+    this.root = projectRoot;
+    this.pkg = readJsonSafe2(path2.join(projectRoot, "package.json"));
+  }
+  detect(framework) {
+    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();
+    }
+  }
+  allDeps() {
+    return {
+      ...this.pkg?.dependencies || {},
+      ...this.pkg?.devDependencies || {}
+    };
+  }
+  fileExists(rel) {
+    return fs2.existsSync(path2.join(this.root, rel));
+  }
+  findLocalesDir() {
+    const candidates = ["locales", "src/locales", "i18n", "src/i18n", "public/locales"];
+    return candidates.find((c) => this.fileExists(c));
+  }
+  detectLanguagesFromLocalesDir(localesDir) {
+    if (!localesDir) return [];
+    const full = path2.join(this.root, localesDir);
+    try {
+      return fs2.readdirSync(full, { withFileTypes: true }).filter((e) => e.isDirectory()).map((e) => e.name);
+    } catch {
+      return [];
+    }
+  }
+  detectReactI18n() {
+    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)
+    };
+  }
+  detectAngularI18n() {
+    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"
+    };
+  }
+  detectVueI18n() {
+    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)
+    };
+  }
+  detectGenericI18n() {
+    const localesDir = this.findLocalesDir();
+    if (!localesDir) return { hasI18n: false };
+    return { hasI18n: true, localesDir };
+  }
+};
+export {
+  FrameworkDetector,
+  I18nDetector,
+  detectFramework
+};

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "ai-localize-framework-detectors",
+  "version": "1.0.0",
+  "description": "Auto-detect frontend frameworks from project structure",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "ai-localize-shared": "1.0.0"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.1",
+    "typescript": "^5.3.3",
+    "vitest": "^1.2.1"
+  },
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format cjs,esm --dts",
+    "dev": "tsup src/index.ts --format cjs,esm --dts --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "lint": "eslint src --ext .ts"
+  }
+}

package/src/detector.ts

@@ -0,0 +1,212 @@
+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

@@ -0,0 +1,140 @@
+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

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

package/tsconfig.json

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