@dimensional-innovations/tool-config 5.0.1 → 5.0.2

package/dist/chunk-ITGUBGO6.js

@@ -0,0 +1,625 @@
+import { getEslintIgnores } from './chunk-OMQFJOZZ.js';
+import { autoDetect } from './chunk-L7IN57ZC.js';
+import js from '@eslint/js';
+import tseslint from 'typescript-eslint';
+import globals3 from 'globals';
+import prettierConfig from 'eslint-config-prettier';
+import { fixupPluginRules } from '@eslint/compat';
+import importPlugin from 'eslint-plugin-import';
+
+// src/tools/eslint/presets/base.ts
+var basePreset = {
+  rules: {
+    // ============================================================
+    // MODERN JAVASCRIPT RULES
+    // Best practices for ES2015+ code
+    // Documentation: https://eslint.org/docs/rules/
+    // ============================================================
+    // Console and debugging
+    "no-console": ["warn", { allow: ["warn", "error"] }],
+    // Warn on console.log but allow console.warn/error for logging
+    "no-debugger": "warn",
+    // Warn on debugger statements (should be removed before commit)
+    "no-alert": "error",
+    // Disallow alert/confirm/prompt (use proper UI)
+    // Modern syntax preferences
+    "prefer-const": "error",
+    // Use const for variables that are never reassigned
+    "no-var": "error",
+    // Use let/const instead of var
+    "prefer-arrow-callback": "error",
+    // Use arrow functions for callbacks
+    "prefer-template": "error",
+    // Use template literals instead of string concatenation
+    "prefer-destructuring": [
+      "error",
+      {
+        array: true,
+        object: true
+      },
+      {
+        enforceForRenamedProperties: false
+      }
+    ],
+    // Use destructuring where possible
+    "prefer-rest-params": "error",
+    // Use rest parameters instead of arguments object
+    "prefer-spread": "error",
+    // Use spread operator instead of .apply()
+    "object-shorthand": "error",
+    // Use object shorthand syntax {x} instead of {x: x}
+    // Note: arrow-body-style is a formatting rule disabled by eslint-config-prettier
+    // Code quality
+    eqeqeq: ["error", "always"],
+    // Always use === and !== instead of == and !=
+    "no-duplicate-imports": "off",
+    // Handled by import/no-duplicates (better type + value import support)
+    "no-useless-computed-key": "error",
+    // Disallow unnecessary computed property keys
+    "no-useless-constructor": "error",
+    // Disallow unnecessary constructors
+    "no-useless-rename": "error",
+    // Disallow renaming import/export/destructured assignments to same name
+    "no-nested-ternary": "error",
+    // Disallow nested ternary expressions (hard to read)
+    "no-unneeded-ternary": "error",
+    // Disallow ternary operators when simpler alternatives exist
+    "prefer-object-spread": "error",
+    // Use object spread instead of Object.assign
+    // Async/Promise best practices
+    "no-return-await": "error",
+    // Disallow unnecessary return await
+    "require-await": "warn",
+    // Warn on async functions without await (allow for plugin patterns)
+    "no-promise-executor-return": "error",
+    // Disallow returning values from Promise executor functions
+    // ============================================================
+    // CODE QUALITY & COMPLEXITY
+    // Maintainability and readability rules
+    // Documentation: https://eslint.org/docs/rules/
+    // ============================================================
+    // Complexity (warnings to identify areas needing refactoring)
+    complexity: ["warn", 15],
+    // Warn on high cyclomatic complexity
+    "max-depth": ["warn", 4],
+    // Warn on deeply nested blocks
+    "max-lines": ["warn", 500],
+    // Warn on files exceeding 500 lines
+    "max-lines-per-function": [
+      "warn",
+      {
+        max: 100,
+        skipBlankLines: true,
+        skipComments: true
+      }
+    ],
+    // Warn on functions exceeding 100 lines
+    "max-params": ["warn", 4]
+    // Warn on functions with more than 4 parameters
+    // Note: spaced-comment is a formatting rule disabled by eslint-config-prettier
+  }
+};
+var base_default = basePreset;
+var browserEnv = {
+  languageOptions: {
+    ecmaVersion: 2025,
+    sourceType: "module",
+    globals: {
+      ...globals3.browser
+    }
+  }
+};
+var browser_default = browserEnv;
+var nodeEnv = {
+  languageOptions: {
+    ecmaVersion: 2025,
+    sourceType: "module",
+    globals: {
+      ...globals3.node
+    }
+  },
+  rules: {
+    // Node.js-specific rule adjustments
+    "no-console": "off",
+    // Console is normal in Node.js
+    "@typescript-eslint/no-var-requires": "off"
+    // Allow require() in .js files
+  }
+};
+var node_default = nodeEnv;
+var universalEnv = {
+  languageOptions: {
+    ecmaVersion: 2025,
+    sourceType: "module",
+    globals: {
+      ...globals3.browser,
+      ...globals3.node
+    }
+  }
+};
+var universal_default = universalEnv;
+function createAngularPreset() {
+  return [
+    {
+      files: ["**/*.ts"],
+      rules: {
+        // ============================================================
+        // ANGULAR-FRIENDLY TYPESCRIPT RULES
+        // Basic rules that work well with Angular patterns
+        // ============================================================
+        // Angular uses decorators extensively
+        "@typescript-eslint/no-extraneous-class": "off",
+        // Angular components often have empty constructors for DI
+        "@typescript-eslint/no-empty-function": [
+          "error",
+          {
+            allow: ["constructors"]
+          }
+        ],
+        // Angular uses ! for definite assignment (properties set by Angular)
+        "@typescript-eslint/no-non-null-assertion": "warn",
+        // Angular services and components use 'any' in some cases
+        "@typescript-eslint/no-explicit-any": "warn",
+        // Parameter properties are common in Angular (constructor(private foo: Foo))
+        "@typescript-eslint/parameter-properties": "off",
+        "@typescript-eslint/explicit-member-accessibility": "off",
+        // Angular uses both interfaces and types
+        "@typescript-eslint/consistent-type-definitions": "off",
+        // Naming conventions for Angular
+        "@typescript-eslint/naming-convention": [
+          "error",
+          {
+            selector: "default",
+            format: ["camelCase"],
+            leadingUnderscore: "allow",
+            trailingUnderscore: "allow"
+          },
+          {
+            selector: "variable",
+            format: ["camelCase", "UPPER_CASE", "PascalCase"],
+            leadingUnderscore: "allow"
+          },
+          {
+            selector: "typeLike",
+            format: ["PascalCase"]
+          },
+          {
+            selector: "enumMember",
+            format: ["PascalCase", "UPPER_CASE"]
+          },
+          {
+            selector: "property",
+            format: null
+            // Allow any format for properties (Angular templates use various patterns)
+          }
+        ]
+      }
+    },
+    // Disable all formatting rules that conflict with Prettier
+    // This must be last to override any formatting rules from above
+    prettierConfig
+  ];
+}
+function createNodePreset() {
+  return [
+    {
+      files: ["**/*.js", "**/*.ts", "**/*.mjs"],
+      rules: {
+        // ============================================================
+        // NODE.JS BACKEND RULES
+        // Best practices for server-side JavaScript/TypeScript
+        // ============================================================
+        // Console usage is normal in Node.js
+        "no-console": "off",
+        // Process and __dirname are standard in Node
+        "no-process-env": "off",
+        "no-process-exit": "warn",
+        // Async patterns
+        "no-async-promise-executor": "error",
+        "require-atomic-updates": "error",
+        // Error handling
+        "no-throw-literal": "error",
+        "prefer-promise-reject-errors": "error",
+        // Node.js specific
+        "callback-return": "off",
+        // Modern Node uses async/await
+        "handle-callback-err": "off",
+        // Modern Node uses async/await
+        "no-mixed-requires": "off",
+        // ES modules don't have this issue
+        "no-new-require": "error",
+        "no-path-concat": "error",
+        // Use path.join() instead
+        // Security
+        "no-eval": "error",
+        "no-implied-eval": "error",
+        "no-new-func": "error",
+        // Best practices for backend
+        "no-unused-vars": [
+          "error",
+          {
+            args: "after-used",
+            argsIgnorePattern: "^_",
+            varsIgnorePattern: "^_"
+          }
+        ],
+        // Allow both require and import
+        "@typescript-eslint/no-var-requires": "off"
+      }
+    },
+    // Disable all formatting rules that conflict with Prettier
+    // This must be last to override any formatting rules from above
+    prettierConfig
+  ];
+}
+function createVanillaPreset() {
+  return [
+    {
+      files: ["**/*.js", "**/*.ts", "**/*.tsx"],
+      rules: {
+        // No framework-specific rules
+        // All rules come from base.js and typescript.js presets
+      }
+    },
+    // Disable all formatting rules that conflict with Prettier
+    // This must be last to override any formatting rules from above
+    prettierConfig
+  ];
+}
+var importsPreset = {
+  plugins: {
+    import: fixupPluginRules(importPlugin)
+  },
+  rules: {
+    // ============================================================
+    // IMPORT/MODULE RULES
+    // Module import/export best practices
+    // Documentation: https://github.com/import-js/eslint-plugin-import
+    // ============================================================
+    "import/order": [
+      "error",
+      {
+        groups: ["builtin", "external", "internal", "parent", "sibling", "index"],
+        "newlines-between": "always",
+        alphabetize: {
+          order: "asc",
+          caseInsensitive: true
+        }
+      }
+    ],
+    // Enforce consistent import order with alphabetization
+    "import/no-duplicates": [
+      "error",
+      {
+        "prefer-inline": true,
+        considerQueryString: false
+      }
+    ],
+    // Prevent duplicate imports (allows type + value imports from same module)
+    "import/no-unresolved": "off",
+    // TypeScript handles this better
+    "import/named": "off",
+    // TypeScript handles this better
+    "import/namespace": "off",
+    // TypeScript handles this better
+    "import/default": "off",
+    // TypeScript handles this better
+    "import/no-named-as-default": "warn",
+    // Warn on potentially confusing imports
+    "import/no-named-as-default-member": "warn",
+    // Warn on confusing member access
+    "import/newline-after-import": "error",
+    // Require blank line after imports
+    "import/no-webpack-loader-syntax": "error",
+    // No webpack loader syntax in imports
+    "import/first": "error"
+    // Imports must be at the top of the file
+  }
+};
+var imports_default = importsPreset;
+
+// src/tools/eslint/presets/typescript.ts
+var typescriptPreset = {
+  rules: {
+    // ============================================================
+    // TYPESCRIPT RULES
+    // TypeScript-specific linting and type safety
+    // Documentation: https://typescript-eslint.io/rules/
+    // ============================================================
+    // Type safety
+    "@typescript-eslint/no-explicit-any": "warn",
+    // Warn on any usage (allow when necessary)
+    // Note: Type-checked rules (no-unsafe-*) require TypeScript project configuration
+    // They are disabled here but available in recommended-type-checked preset
+    // Type annotations
+    "@typescript-eslint/explicit-function-return-type": "off",
+    // Too strict - TS can infer return types
+    "@typescript-eslint/explicit-module-boundary-types": "off",
+    // Too strict - TS can infer exports
+    "@typescript-eslint/typedef": [
+      "error",
+      {
+        arrayDestructuring: false,
+        arrowParameter: false,
+        memberVariableDeclaration: false,
+        objectDestructuring: false,
+        parameter: false,
+        propertyDeclaration: true,
+        // Require type annotations on class properties
+        variableDeclaration: false,
+        variableDeclarationIgnoreFunction: true
+      }
+    ],
+    // Require type annotations in specific places
+    // Best practices
+    "@typescript-eslint/no-unused-vars": [
+      "error",
+      {
+        argsIgnorePattern: "^_",
+        // Allow unused args prefixed with _
+        varsIgnorePattern: "^_"
+        // Allow unused vars prefixed with _
+      }
+    ],
+    "@typescript-eslint/prefer-for-of": "error",
+    // Prefer for-of over standard for loop with index
+    "@typescript-eslint/no-non-null-assertion": "warn",
+    // Warn on non-null assertions (! operator)
+    // Consistency
+    "@typescript-eslint/consistent-type-definitions": ["error", "interface"],
+    // Prefer interface over type alias
+    "@typescript-eslint/consistent-type-imports": [
+      "error",
+      {
+        prefer: "type-imports",
+        // Use import type for type-only imports
+        disallowTypeAnnotations: false
+      }
+    ],
+    // ============================================================
+    // NAMING CONVENTIONS
+    // Enforce consistent naming patterns across the codebase
+    // Documentation: https://typescript-eslint.io/rules/naming-convention/
+    //
+    // Patterns enforced:
+    // - camelCase: variables, functions, methods, parameters
+    // - PascalCase: classes, interfaces, types, enums
+    // - UPPER_CASE: constants and enum members
+    // - underscore prefix: private members, unused parameters
+    // ============================================================
+    "@typescript-eslint/naming-convention": [
+      "error",
+      // Default: camelCase for most identifiers
+      {
+        selector: "default",
+        format: ["camelCase"],
+        leadingUnderscore: "allow",
+        trailingUnderscore: "forbid"
+      },
+      // Variables: camelCase or UPPER_CASE for constants
+      {
+        selector: "variable",
+        format: ["camelCase", "UPPER_CASE", "PascalCase"],
+        // PascalCase for components
+        leadingUnderscore: "allow"
+      },
+      // Functions and methods: camelCase
+      {
+        selector: ["function", "method"],
+        format: ["camelCase"]
+      },
+      // Classes, interfaces, types, enums: PascalCase
+      {
+        selector: "typeLike",
+        format: ["PascalCase"]
+      },
+      // Type parameters: PascalCase with T prefix
+      {
+        selector: "typeParameter",
+        format: ["PascalCase"],
+        prefix: ["T"]
+      },
+      // Enum members: PascalCase or UPPER_CASE
+      {
+        selector: "enumMember",
+        format: ["PascalCase", "UPPER_CASE"]
+      },
+      // Object properties: allow camelCase, PascalCase, or UPPER_CASE (for API responses, component props, env vars)
+      {
+        selector: "property",
+        format: ["camelCase", "PascalCase", "UPPER_CASE"],
+        leadingUnderscore: "allow",
+        filter: {
+          // Allow properties with special characters (ESLint rule names, path aliases, env vars)
+          regex: "^(@|no-|prefer-|max-|vue/|import/|spaced-|react/|[A-Z_]+).*$",
+          match: false
+        }
+      },
+      // Object literal properties: allow any format (path aliases like @renderer, @main, @preload)
+      {
+        selector: "objectLiteralProperty",
+        format: null
+      },
+      // Imports: allow camelCase or PascalCase (Vue component imports)
+      {
+        selector: "import",
+        format: ["camelCase", "PascalCase"],
+        leadingUnderscore: "allow"
+      },
+      // Private class members: require underscore prefix
+      {
+        selector: "memberLike",
+        modifiers: ["private"],
+        format: ["camelCase"],
+        leadingUnderscore: "require"
+      },
+      // Unused parameters: require underscore prefix
+      {
+        selector: "parameter",
+        modifiers: ["unused"],
+        format: ["camelCase"],
+        leadingUnderscore: "require"
+      }
+    ]
+  }
+};
+var typescript_default = typescriptPreset;
+
+// src/tools/eslint/index.ts
+var SOURCE_FILES = [
+  "**/*.js",
+  "**/*.ts",
+  "**/*.tsx",
+  "**/*.vue",
+  "**/*.jsx",
+  "**/*.svelte",
+  "**/*.astro"
+];
+async function addFrameworkConfig(config, framework) {
+  switch (framework) {
+    case "react": {
+      const { default: createReactPreset } = await import('./react-YIKJI3VA.js');
+      config.push(...createReactPreset());
+      break;
+    }
+    case "vue": {
+      const { default: createVuePreset } = await import('./vue-DP7MCMOU.js');
+      config.push(...createVuePreset());
+      break;
+    }
+    case "svelte": {
+      const { default: createSveltePreset } = await import('./svelte-XEOX6WAQ.js');
+      config.push(...createSveltePreset());
+      break;
+    }
+    case "solid": {
+      const { default: createSolidPreset } = await import('./solid-F44BEBBP.js');
+      config.push(...createSolidPreset());
+      break;
+    }
+    case "astro": {
+      const { default: createAstroPreset } = await import('./astro-6WHBKQFX.js');
+      config.push(...createAstroPreset());
+      break;
+    }
+    case "vanilla":
+      config.push(...createVanillaPreset());
+      break;
+    case "node":
+      config.push(...createNodePreset());
+      break;
+    case "angular":
+      config.push(...createAngularPreset());
+      break;
+    default:
+      console.warn(`\u26A0\uFE0F  Unknown framework "${framework}", defaulting to vanilla JavaScript`);
+      config.push(...createVanillaPreset());
+      break;
+  }
+}
+function getEnvironmentConfig(environment) {
+  switch (environment) {
+    case "node":
+      return node_default;
+    case "universal":
+      return universal_default;
+    case "browser":
+    default:
+      return browser_default;
+  }
+}
+function addTypeScriptConfig(config) {
+  config.push(...tseslint.configs.recommended);
+  config.push({
+    files: SOURCE_FILES,
+    ...typescript_default
+  });
+  config.push({
+    files: ["**/*.d.ts"],
+    rules: {
+      "@typescript-eslint/no-explicit-any": "off"
+    }
+  });
+  config.push({
+    files: ["**/*.js"],
+    rules: {
+      "@typescript-eslint/no-var-requires": "off"
+    }
+  });
+}
+function addOverrides(config, options) {
+  config.push({
+    files: ["tests/**/*.{js,ts,jsx,tsx,vue,svelte,astro}"],
+    rules: {
+      "no-console": "off",
+      "max-lines-per-function": "off",
+      complexity: "off",
+      "max-statements": "off",
+      "max-nested-callbacks": "off",
+      "no-magic-numbers": "off",
+      "@typescript-eslint/no-explicit-any": "off"
+    }
+  });
+  config.push({
+    files: ["**/bin/**/*.js", "**/scripts/**/*.js"],
+    languageOptions: {
+      globals: {
+        ...node_default.languageOptions?.globals
+      }
+    },
+    rules: {
+      "no-console": "off",
+      "max-lines-per-function": "off"
+    }
+  });
+  if (options.rules && Object.keys(options.rules).length > 0) {
+    config.push({
+      files: SOURCE_FILES,
+      rules: options.rules
+    });
+  }
+}
+async function createEslintConfig(options = {}) {
+  const cwd = options.cwd || process.cwd();
+  const detected = autoDetect(cwd);
+  const framework = options.framework === "auto" || !options.framework ? detected.framework : options.framework;
+  const environment = options.environment === "auto" || !options.environment ? detected.environment : options.environment;
+  const typescript = options.typescript === "auto" || options.typescript === void 0 ? detected.typescript : options.typescript;
+  console.log(
+    `\u{1F4E6} ESLint Config: ${framework} | ${environment} | TypeScript: ${typescript ? "Yes" : "No"}`
+  );
+  if (framework === "angular") {
+    console.warn(
+      "\n\u26A0\uFE0F  Angular detected. This package provides basic TypeScript linting.\n   For Angular-specific rules, install: @angular-eslint/eslint-plugin\n   See: https://github.com/angular-eslint/angular-eslint\n"
+    );
+  }
+  const defaultIgnorePaths = getEslintIgnores();
+  const allIgnorePaths = [...defaultIgnorePaths, ...options.ignorePaths || []];
+  const config = [];
+  config.push({ ignores: allIgnorePaths });
+  config.push(js.configs.recommended);
+  if (typescript) {
+    addTypeScriptConfig(config);
+  }
+  const envConfig = getEnvironmentConfig(environment);
+  config.push({
+    files: SOURCE_FILES,
+    ...envConfig
+  });
+  config.push({
+    files: SOURCE_FILES,
+    ...base_default
+  });
+  config.push({
+    files: SOURCE_FILES,
+    ...imports_default
+  });
+  await addFrameworkConfig(config, framework);
+  addOverrides(config, options);
+  return config;
+}
+var eslint_default = createEslintConfig;
+
+export { createEslintConfig, eslint_default };
+//# sourceMappingURL=chunk-ITGUBGO6.js.map
+//# sourceMappingURL=chunk-ITGUBGO6.js.map