@dimensional-innovations/tool-config 1.0.0

package/src/tools/eslint/presets/frameworks/solid.js

@@ -0,0 +1,45 @@
+import solid from 'eslint-plugin-solid/configs/typescript'
+
+/**
+ * Solid.js framework configuration
+ * Conservative rules for Solid reactive primitives and JSX
+ *
+ * Rules organized by category:
+ * - Reactive primitives (signals, effects, memos)
+ * - JSX best practices
+ * - Component patterns
+ */
+export default function createSolidPreset() {
+  return [
+    {
+      files: ['**/*.jsx', '**/*.tsx'],
+      ...solid,
+      rules: {
+        ...solid.rules,
+
+        // Reactive Primitives (7 rules)
+        'solid/reactivity': 'error', // Enforce reactive dependencies
+        'solid/no-destructure': 'error', // Don't destructure props (loses reactivity)
+        'solid/prefer-for': 'error', // Use <For> over .map()
+        'solid/no-innerhtml': ['error', { allowStatic: true }], // Prevent XSS
+        'solid/event-handlers': [
+          'error',
+          {
+            // Consistent event handler naming
+            ignoreCase: false,
+            warnOnSpread: false
+          }
+        ],
+        'solid/jsx-no-undef': 'error', // Undefined components
+        'solid/jsx-uses-vars': 'error', // Mark JSX vars as used
+
+        // Component Best Practices (5 rules)
+        'solid/components-return-once': 'error', // Single return per component
+        'solid/no-unknown-namespaces': 'error', // Validate JSX namespaces
+        'solid/prefer-show': 'error', // Use <Show> over ternary
+        'solid/self-closing-comp': 'error', // Self-close components without children
+        'solid/style-prop': ['error', { styleProps: ['style', 'css'] }] // Validate style prop
+      }
+    }
+  ]
+}

package/src/tools/eslint/presets/frameworks/svelte.js

@@ -0,0 +1,78 @@
+import svelte from 'eslint-plugin-svelte'
+import svelteParser from 'svelte-eslint-parser'
+import tseslint from 'typescript-eslint'
+
+/**
+ * Svelte.js framework configuration
+ * Comprehensive rules for Svelte 5 (runes, snippets) and SvelteKit projects
+ *
+ * Rules organized by category:
+ * - Core Svelte best practices
+ * - Svelte 5 runes mode
+ * - Code style and formatting
+ *
+ * Note: Accessibility checks are handled by Svelte compiler warnings via svelte/valid-compile
+ */
+export default function createSveltePreset() {
+  return [
+    ...svelte.configs['flat/recommended'],
+    {
+      files: ['**/*.svelte'],
+      languageOptions: {
+        parser: svelteParser,
+        parserOptions: {
+          parser: tseslint.parser,
+          extraFileExtensions: ['.svelte']
+        }
+      },
+      rules: {
+        // Core Svelte Best Practices (7 rules)
+        'svelte/no-at-html-tags': 'error',
+        'svelte/no-target-blank': 'error',
+        'svelte/no-reactive-reassign': 'error',
+        'svelte/require-store-reactive-access': 'error',
+        'svelte/valid-compile': 'error',
+        'svelte/no-unused-svelte-ignore': 'error',
+        'svelte/no-useless-mustaches': 'error',
+        'svelte/require-optimized-style-attribute': 'error',
+
+        // Svelte 5 (runes mode) - 4 rules
+        'svelte/block-lang': [
+          'error',
+          {
+            script: 'ts',
+            style: null
+          }
+        ],
+        'svelte/no-dom-manipulating': 'error',
+        'svelte/no-export-load-in-svelte-module-in-kit-pages': 'error',
+        'svelte/no-store-async': 'error',
+
+        // Code Style (6 rules)
+        'svelte/shorthand-attribute': 'error',
+        'svelte/shorthand-directive': 'error',
+        'svelte/no-spaces-around-equal-signs-in-attribute': 'error',
+        'svelte/html-quotes': [
+          'error',
+          {
+            prefer: 'double'
+          }
+        ],
+        'svelte/indent': [
+          'error',
+          {
+            indent: 2,
+            alignAttributesVertically: true
+          }
+        ],
+        'svelte/first-attribute-linebreak': [
+          'error',
+          {
+            multiline: 'below',
+            singleline: 'beside'
+          }
+        ]
+      }
+    }
+  ]
+}

package/src/tools/eslint/presets/frameworks/vanilla.js

@@ -0,0 +1,16 @@
+/**
+ * Vanilla JavaScript/TypeScript configuration
+ * No framework-specific rules - just modern JavaScript best practices
+ * Perfect for: libraries, utilities, Node.js apps without frameworks
+ */
+export default function createVanillaPreset() {
+  return [
+    {
+      files: ['**/*.js', '**/*.ts', '**/*.tsx'],
+      rules: {
+        // No framework-specific rules
+        // All rules come from base.js and typescript.js presets
+      }
+    }
+  ]
+}

package/src/tools/eslint/presets/frameworks/vue.js

@@ -0,0 +1,125 @@
+import vuePlugin from 'eslint-plugin-vue'
+import tseslint from 'typescript-eslint'
+
+/**
+ * Vue.js 3 configuration
+ * Includes Vue plugin and Vue-specific rules
+ */
+export default function createVuePreset() {
+  return [
+    // Vue recommended configuration (flat config)
+    ...vuePlugin.configs['flat/recommended'],
+
+    // Vue-specific custom rules
+    {
+      files: ['**/*.vue', '**/*.js', '**/*.ts', '**/*.tsx'],
+      rules: {
+        // ============================================================
+        // VUE.JS RULES
+        // Vue 3 best practices and conventions
+        // Documentation: https://eslint.vuejs.org/rules/
+        // ============================================================
+
+        // Component naming
+        'vue/component-name-in-template-casing': ['error', 'PascalCase'], // Use PascalCase for components in templates
+        'vue/multi-word-component-names': 'off', // Allow single-word component names (too strict)
+        'vue/component-definition-name-casing': ['error', 'PascalCase'], // Use PascalCase for component definitions
+
+        // Template best practices
+        'vue/html-self-closing': [
+          'error',
+          {
+            html: {
+              void: 'always',
+              normal: 'always',
+              component: 'always'
+            }
+          }
+        ], // Always use self-closing tags for consistency
+        'vue/max-attributes-per-line': [
+          'error',
+          {
+            singleline: 3,
+            multiline: 1
+          }
+        ], // Limit attributes per line for readability
+        'vue/first-attribute-linebreak': [
+          'error',
+          {
+            singleline: 'ignore',
+            multiline: 'below'
+          }
+        ], // Enforce consistent attribute line breaks
+        'vue/html-closing-bracket-newline': [
+          'error',
+          {
+            singleline: 'never',
+            multiline: 'always'
+          }
+        ], // Enforce consistent closing bracket placement
+
+        // Vue 3 Composition API
+        'vue/no-deprecated-v-on-native-modifier': 'error', // No .native modifier in Vue 3
+        'vue/no-deprecated-slot-attribute': 'error', // Use v-slot instead of slot attribute
+        'vue/require-explicit-emits': 'error', // Require emits to be declared
+        'vue/no-setup-props-reactivity-loss': 'error', // Don't lose reactivity when using props
+        'vue/component-api-style': ['error', ['script-setup']], // Prefer <script setup> syntax
+        'vue/define-macros-order': [
+          'error',
+          {
+            order: ['defineProps', 'defineEmits']
+          }
+        ], // Enforce consistent order of compiler macros
+        'vue/define-emits-declaration': ['error', 'type-based'], // Use type-based emits declarations
+
+        // Directives
+        'vue/no-v-html': 'warn', // Warn about v-html (XSS risk)
+        'vue/v-on-event-hyphenation': ['error', 'always'], // Use kebab-case for event names
+        'vue/v-bind-style': ['error', 'shorthand'], // Use : instead of v-bind:
+        'vue/v-on-style': ['error', 'shorthand'], // Use @ instead of v-on:
+
+        // Attributes
+        'vue/attribute-hyphenation': ['error', 'always'], // Use kebab-case for attributes in templates
+        'vue/prop-name-casing': ['error', 'camelCase'], // Use camelCase for props in script
+
+        // Order and organization
+        'vue/order-in-components': [
+          'error',
+          {
+            order: [
+              'el',
+              'name',
+              'parent',
+              'functional',
+              ['delimiters', 'comments'],
+              ['components', 'directives', 'filters'],
+              'extends',
+              'mixins',
+              'inheritAttrs',
+              'model',
+              ['props', 'propsData'],
+              'data',
+              'computed',
+              'watch',
+              'LIFECYCLE_HOOKS',
+              'methods',
+              ['template', 'render'],
+              'renderError'
+            ]
+          }
+        ] // Enforce consistent component option order
+      }
+    },
+
+    // Vue-specific parser configuration
+    {
+      files: ['**/*.vue'],
+      languageOptions: {
+        parserOptions: {
+          parser: tseslint.parser,
+          extraFileExtensions: ['.vue']
+        }
+      }
+    }
+  ]
+}

package/src/tools/eslint/presets/imports.js

@@ -0,0 +1,41 @@
+import { fixupPluginRules } from '@eslint/compat'
+import importPlugin from 'eslint-plugin-import'
+
+/**
+ * Import/export rules configuration
+ * Uses @eslint/compat for flat config compatibility
+ */
+export default {
+  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', // Prevent duplicate 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
+  }
+}

package/src/tools/eslint/presets/typescript.js

@@ -0,0 +1,131 @@
+/**
+ * TypeScript-specific rules
+ * Only included when TypeScript is detected or explicitly enabled
+ */
+export default {
+  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 or PascalCase (for API responses, component props)
+      {
+        selector: 'property',
+        format: ['camelCase', 'PascalCase'],
+        leadingUnderscore: 'allow',
+        filter: {
+          // Allow properties with special characters (ESLint rule names, etc.)
+          regex: '^(@|no-|prefer-|max-|vue/|import/|spaced-|react/).*$',
+          match: false
+        }
+      },
+      // 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'
+      }
+    ]
+  }
+}