es-guard 1.7.0 → 1.9.0

package/dist/cli.js

@@ -5,6 +5,7 @@ import packageJson from "../package.json" with { type: "json" };
 import { checkCompatibility, formatViolationMessage } from "./lib/checkCompatiblity.js";
 import { getBrowserTargetsFromString } from "./lib/getBrowserTargets.js";
 import { detectProjectConfig, getConfigFileNames } from "./lib/detectTarget.js";
+import { getCurrentProjectType } from "./lib/projectType.js";
 import { setVerboseMode } from "./lib/globalState.js";
 const version = packageJson.version;
 // Create the main program
@@ -18,6 +19,7 @@ program
     .option("-t, --target <version>", "Target ES version (2015, 2016, 2017, etc. or 6, 7, 8, etc. or 'latest'). If not specified, will auto-detect from project config files.")
     .option("-b, --browsers <targets>", "Browser targets for compatibility checking (optional: auto-determined from target)")
     .option("-v, --verbose", "Enable verbose output showing detailed detection process and configuration information")
+    .option("--skip", "Do not exit with error code when compatibility errors are found")
     .addHelpText("after", `
 
 Examples:
@@ -28,6 +30,7 @@ Examples:
   es-guard -t latest build           # Check 'build' directory with latest ES (auto-determined browsers)
   es-guard --target 2017 --browsers "> 0.5%, last 2 versions" dist
   es-guard --verbose                 # Auto-detect with detailed detection information
+  es-guard --skip                    # Auto-detect and continue even if compatibility errors are found
 
 Auto-detection searches for ES target in:
   - package.json (browserslist field)
@@ -51,7 +54,7 @@ Browser targets use Browserslist format:
 
 Exit codes:
   0 - No compatibility issues found
-  1 - Compatibility issues found or error occurred
+  1 - Compatibility issues found or error occurred (unless --skip is used)
 `);
 // Add validation for the target option
 program.hook("preAction", (thisCommand) => {
@@ -80,6 +83,9 @@ program.action(async (directory, options) => {
         if (options.verbose) {
             console.log("🔍 Auto-detecting project configuration...");
             console.log(`📂 Searching in: ${process.cwd()}`);
+            // Detect and log project type
+            const projectType = getCurrentProjectType();
+            console.log(`🏗️  Project type: ${projectType}`);
             console.log("");
         }
         // Use unified detection to get all configuration at once
@@ -210,13 +216,17 @@ program.action(async (directory, options) => {
             }
         }
         if (errors.length > 0) {
-            process.exit(1);
-        }
-        else {
-            console.log("✅ No compatibility errors found!");
-            if (warnings.length > 0) {
-                console.log("⚠️  There are compat warnings, but no syntax errors. Please address these warnings and update polyfills in your app and in es-guard config.");
+            if (options.skip) {
+                console.log("⚠️  Compatibility errors found, but continuing due to --skip option");
+                process.exit(0);
             }
+            else {
+                process.exit(1);
+            }
+        }
+        console.log("✅ No compatibility errors found!");
+        if (warnings.length > 0) {
+            console.log("⚠️  There are compat warnings, but no syntax errors. Please address these warnings and update polyfills in your app and in es-guard config.");
         }
     }
     catch (error) {

package/dist/lib/defaults.js

@@ -0,0 +1,77 @@
+/**
+ * Default configurations for different project types
+ */
+/**
+ * Next.js default browserslist configuration
+ * Source: https://nextjs.org/docs/basic-features/supported-browsers-features
+ */
+export const NEXTJS_DEFAULT_BROWSERSLIST = ["chrome 64", "edge 79", "firefox 67", "opera 51", "safari 12"];
+/**
+ * Default output directories for different project types
+ */
+export const DEFAULT_OUTPUT_DIRS = {
+    nextjs: ".next/static",
+    vite: "dist",
+    webpack: "dist",
+    rollup: "dist",
+    parcel: "dist",
+    generic: "dist",
+};
+/**
+ * Project type detection helpers
+ */
+export const PROJECT_TYPES = {
+    nextjs: "nextjs",
+    vite: "vite",
+    webpack: "webpack",
+    rollup: "rollup",
+    parcel: "parcel",
+    generic: "generic",
+};
+export const ProjectTypeKeys = new Set(Object.keys(PROJECT_TYPES));
+export const isProjectType = (projectType) => {
+    return ProjectTypeKeys.has(projectType);
+};
+/**
+ * Get default browserslist for a project type
+ */
+export function getDefaultBrowserslist(projectType) {
+    switch (projectType) {
+        case PROJECT_TYPES.nextjs:
+            return [...NEXTJS_DEFAULT_BROWSERSLIST];
+        // Add more project types here as needed
+        default:
+            return null;
+    }
+}
+/**
+ * Get default output directory for a project type
+ */
+export function getDefaultOutputDir(projectType) {
+    if (isProjectType(projectType)) {
+        return DEFAULT_OUTPUT_DIRS[projectType];
+    }
+    return DEFAULT_OUTPUT_DIRS.generic;
+}
+/**
+ * Detect project type from package.json dependencies
+ */
+export function detectProjectType(dependencies = {}, devDependencies = {}) {
+    const allDeps = { ...dependencies, ...devDependencies };
+    if (allDeps.next) {
+        return PROJECT_TYPES.nextjs;
+    }
+    if (allDeps.vite) {
+        return PROJECT_TYPES.vite;
+    }
+    if (allDeps.webpack) {
+        return PROJECT_TYPES.webpack;
+    }
+    if (allDeps.rollup) {
+        return PROJECT_TYPES.rollup;
+    }
+    if (allDeps.parcel) {
+        return PROJECT_TYPES.parcel;
+    }
+    return PROJECT_TYPES.generic;
+}

package/dist/lib/detectTarget.js

@@ -1,6 +1,9 @@
 import * as fs from "fs";
 import * as path from "path";
 import { verboseMode } from "./globalState.js";
+import { NEXTJS_DEFAULT_BROWSERSLIST } from "./defaults.js";
+import { getCurrentProjectType } from "./projectType.js";
+import { readJsonFile, readTextFile, evaluateJsFile, isPackageJson, isTsConfig, isBabelRc, isViteConfig, isWebpackConfig, isNextConfig, } from "./utils.js";
 // Shared utilities for ES version parsing and conversion
 const CONFIG_FILE_NAMES = [
     "package.json",
@@ -52,80 +55,6 @@ const TARGET_MAP = {
     es6: "2015",
     es5: "2009",
 };
-/**
- * Helper to read and parse JSON file safely
- */
-const readJsonFile = (filePath) => {
-    const content = fs.readFileSync(filePath, "utf-8");
-    return JSON.parse(content);
-};
-/**
- * Helper to read text file safely
- */
-const readTextFile = (filePath) => {
-    return fs.readFileSync(filePath, "utf-8");
-};
-/**
- * Helper to safely evaluate JavaScript files (for config files)
- */
-const evaluateJsFile = (filePath) => {
-    const content = readTextFile(filePath);
-    // Create a safe evaluation context
-    const module = { exports: {} };
-    const require = (id) => {
-        if (id === "path")
-            return path;
-        if (id === "fs")
-            return fs;
-        throw new Error(`Cannot require '${id}' in config evaluation`);
-    };
-    try {
-        // Use Function constructor to create a safe evaluation environment
-        const fn = new Function("module", "exports", "require", "path", "fs", "__dirname", content);
-        fn(module, module.exports, require, path, fs, path.dirname(filePath));
-        return module.exports;
-    }
-    catch (error) {
-        console.warn(`Error evaluating ${filePath}:`, error);
-        return null;
-    }
-};
-/**
- * Type guard for package.json structure
- */
-const isPackageJson = (obj) => {
-    return typeof obj === "object" && obj !== null;
-};
-/**
- * Type guard for tsconfig.json structure
- */
-const isTsConfig = (obj) => {
-    return typeof obj === "object" && obj !== null && "compilerOptions" in obj;
-};
-/**
- * Type guard for .babelrc structure
- */
-const isBabelRc = (obj) => {
-    return typeof obj === "object" && obj !== null && "presets" in obj;
-};
-/**
- * Type guard for vite config structure
- */
-const isViteConfig = (obj) => {
-    return typeof obj === "object" && obj !== null;
-};
-/**
- * Type guard for webpack config structure
- */
-const isWebpackConfig = (obj) => {
-    return typeof obj === "object" && obj !== null;
-};
-/**
- * Type guard for next.js config structure
- */
-const isNextConfig = (obj) => {
-    return typeof obj === "object" && obj !== null;
-};
 /**
  * Get parser function for a given config file
  */
@@ -212,7 +141,7 @@ export const detectProjectConfig = (cwd = process.cwd()) => {
                 // Update output directory if found and not already set
                 if (detection.outputDir && !result.outputDir) {
                     result.outputDir = detection.outputDir;
-                    result.outputSource = filename;
+                    result.outputSource = detection.outputSource || filename;
                     if (verboseMode) {
                         console.log(`      📁 Output directory: ${detection.outputDir}`);
                     }
@@ -226,7 +155,7 @@ export const detectProjectConfig = (cwd = process.cwd()) => {
                 // Update browserslist if found and not already set
                 if (detection.browserslist && !result.browserslist) {
                     result.browserslist = detection.browserslist;
-                    result.browserslistSource = filename;
+                    result.browserslistSource = detection.browserslistSource || filename;
                     if (verboseMode) {
                         console.log(`      🌐 Browserslist: ${detection.browserslist.join(", ")} (from ${result.browserslistSource})`);
                     }
@@ -335,6 +264,8 @@ const parsePackageJson = (filePath) => {
         // Store the full browserslist for CLI defaults
         result.browserslist = browserslist.filter((browser) => typeof browser === "string");
     }
+    // Use global project type detection (lazy initialization)
+    const projectType = getCurrentProjectType(path.dirname(filePath));
     // Check for output directory hints
     if (pkg.dist) {
         result.outputDir = pkg.dist;
@@ -345,9 +276,15 @@ const parsePackageJson = (filePath) => {
     else if (pkg.main && pkg.main.startsWith("./dist/")) {
         result.outputDir = "dist";
     }
-    else if (pkg.dependencies?.next || pkg.devDependencies?.next) {
-        // Next.js apps default to .next directory
+    else if (projectType === "nextjs") {
+        // Set default output directory for Next.js projects
         result.outputDir = ".next/static";
+        result.outputSource = "package.json (default)";
+    }
+    // If no browserslist was found, use default for detected project type
+    if (!result.browserslist && projectType === "nextjs") {
+        result.browserslist = [...NEXTJS_DEFAULT_BROWSERSLIST];
+        result.browserslistSource = "Next.js default";
     }
     return result;
 };

package/dist/lib/globalState.js

@@ -1,7 +1,9 @@
-// Global state management for CLI options
+// Global state management for CLI options and project configuration
 // Static global state variables
 export let verboseMode = false;
 export let debugMode = false;
+export let projectType = undefined;
+export let projectTypeDetected = false;
 /**
  * Set the global verbose mode
  */
@@ -21,6 +23,8 @@ export const getGlobalState = () => {
     return {
         verbose: verboseMode,
         debug: debugMode,
+        projectType,
+        projectTypeDetected,
     };
 };
 /**
@@ -31,6 +35,10 @@ export const setGlobalState = (options) => {
         verboseMode = options.verbose;
     if (options.debug !== undefined)
         debugMode = options.debug;
+    if (options.projectType !== undefined)
+        projectType = options.projectType;
+    if (options.projectTypeDetected !== undefined)
+        projectTypeDetected = options.projectTypeDetected;
 };
 /**
  * Reset global state to defaults
@@ -38,4 +46,25 @@ export const setGlobalState = (options) => {
 export const resetGlobalState = () => {
     verboseMode = false;
     debugMode = false;
+    projectType = undefined;
+    projectTypeDetected = false;
+};
+/**
+ * Set the detected project type globally
+ */
+export const setProjectType = (detectedType) => {
+    projectType = detectedType;
+    projectTypeDetected = true;
+};
+/**
+ * Get the detected project type (lazy detection if not already done)
+ */
+export const getProjectType = () => {
+    return projectType;
+};
+/**
+ * Check if project type has been detected
+ */
+export const isProjectTypeDetected = () => {
+    return projectTypeDetected;
 };

package/dist/lib/projectType.js

@@ -0,0 +1,46 @@
+import * as fs from "fs";
+import * as path from "path";
+import { verboseMode, setProjectType, getProjectType, isProjectTypeDetected } from "./globalState.js";
+import { detectProjectType } from "./defaults.js";
+import { readJsonFile, isPackageJson } from "./utils.js";
+/**
+ * Detect and cache project type globally (lazy initialization)
+ */
+export const detectAndCacheProjectType = (cwd = process.cwd()) => {
+    // Return cached result if already detected
+    if (isProjectTypeDetected()) {
+        return getProjectType() || null;
+    }
+    // Detect project type from package.json
+    const packageJsonPath = path.join(cwd, "package.json");
+    if (fs.existsSync(packageJsonPath)) {
+        try {
+            const pkg = readJsonFile(packageJsonPath);
+            if (isPackageJson(pkg)) {
+                const detectedType = detectProjectType(pkg.dependencies, pkg.devDependencies);
+                setProjectType(detectedType);
+                if (verboseMode) {
+                    console.log(`🔍 Project type detected: ${detectedType}`);
+                }
+                return detectedType;
+            }
+        }
+        catch (error) {
+            // Ignore errors when detecting project type
+            if (verboseMode) {
+                console.log(`   ⚠️  Error detecting project type: ${error instanceof Error ? error.message : String(error)}`);
+            }
+        }
+    }
+    // No project type detected
+    if (verboseMode) {
+        console.log(`🔍 No project type detected`);
+    }
+    return null;
+};
+/**
+ * Get the current project type (detects if not already cached)
+ */
+export const getCurrentProjectType = (cwd = process.cwd()) => {
+    return detectAndCacheProjectType(cwd) || "generic";
+};

package/dist/lib/utils.js

@@ -0,0 +1,76 @@
+import * as fs from "fs";
+import * as path from "path";
+/**
+ * Helper to read and parse JSON file safely
+ */
+export const readJsonFile = (filePath) => {
+    const content = fs.readFileSync(filePath, "utf-8");
+    return JSON.parse(content);
+};
+/**
+ * Helper to read text file safely
+ */
+export const readTextFile = (filePath) => {
+    return fs.readFileSync(filePath, "utf-8");
+};
+/**
+ * Helper to safely evaluate JavaScript files (for config files)
+ */
+export const evaluateJsFile = (filePath) => {
+    const content = readTextFile(filePath);
+    // Create a safe evaluation context
+    const module = { exports: {} };
+    const require = (id) => {
+        if (id === "path")
+            return path;
+        if (id === "fs")
+            return fs;
+        throw new Error(`Cannot require '${id}' in config evaluation`);
+    };
+    try {
+        // Use Function constructor to create a safe evaluation environment
+        const fn = new Function("module", "exports", "require", "path", "fs", "__dirname", content);
+        fn(module, module.exports, require, path, fs, path.dirname(filePath));
+        return module.exports;
+    }
+    catch (error) {
+        console.warn(`Error evaluating ${filePath}:`, error);
+        return null;
+    }
+};
+/**
+ * Type guard for package.json structure
+ */
+export const isPackageJson = (obj) => {
+    return typeof obj === "object" && obj !== null;
+};
+/**
+ * Type guard for tsconfig.json structure
+ */
+export const isTsConfig = (obj) => {
+    return typeof obj === "object" && obj !== null && "compilerOptions" in obj;
+};
+/**
+ * Type guard for .babelrc structure
+ */
+export const isBabelRc = (obj) => {
+    return typeof obj === "object" && obj !== null && "presets" in obj;
+};
+/**
+ * Type guard for vite config structure
+ */
+export const isViteConfig = (obj) => {
+    return typeof obj === "object" && obj !== null;
+};
+/**
+ * Type guard for webpack config structure
+ */
+export const isWebpackConfig = (obj) => {
+    return typeof obj === "object" && obj !== null;
+};
+/**
+ * Type guard for next.js config structure
+ */
+export const isNextConfig = (obj) => {
+    return typeof obj === "object" && obj !== null;
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "es-guard",
-  "version": "1.7.0",
+  "version": "1.9.0",
   "description": "A tool to check JavaScript compatibility with target environments",
   "type": "module",
   "main": "dist/cli.js",