@zairakai/js-dev-tools 1.0.0 → 1.1.0

package/config/eslint.config.js

@@ -16,15 +16,13 @@ const gitignoreConfig = existsSync(gitignorePath) ? [includeIgnoreFile(gitignore
 
 export default [
   ...gitignoreConfig,
+
   // Base JavaScript rules
   pluginJs.configs.recommended,
 
-  // Vue configurations
+  // Vue flat config (sets up vue-eslint-parser as the Vue file parser)
   ...pluginVue.configs['flat/strongly-recommended'],
 
-  // Prettier integration (must be last)
-  eslintConfigPrettier,
-
   // Base configuration for all files
   {
     languageOptions: {
@@ -112,25 +110,56 @@ export default [
     },
   },
 
-  // TypeScript specific configuration
+  // TypeScript configuration for .ts / .tsx files
   {
-    files: ['**/*.ts', '**/*.tsx', '**/*.vue'],
+    files: ['**/*.ts', '**/*.tsx'],
     languageOptions: {
       parser: parserTypeScript,
       parserOptions: {
         project: './tsconfig.json',
-        extraFileExtensions: ['.vue'],
       },
     },
     plugins: {
       '@typescript-eslint': pluginTypeScript,
     },
     rules: {
-      // Disable JS rules that conflict with TS
       'no-unused-vars': 'off',
       'no-undef': 'off',
+      '@typescript-eslint/no-unused-vars': [
+        'error',
+        {
+          argsIgnorePattern: '^_',
+          varsIgnorePattern: '^_',
+          caughtErrorsIgnorePattern: '^_',
+        },
+      ],
+      '@typescript-eslint/no-explicit-any': 'warn',
+      '@typescript-eslint/explicit-function-return-type': 'off',
+      '@typescript-eslint/explicit-module-boundary-types': 'off',
+      '@typescript-eslint/prefer-nullish-coalescing': 'error',
+      '@typescript-eslint/prefer-optional-chain': 'error',
+      '@typescript-eslint/no-non-null-assertion': 'warn',
+    },
+  },
 
-      // Enable TS rules
+  // TypeScript configuration for .vue files
+  // vue-eslint-parser (set by pluginVue above) must remain the primary parser.
+  // TypeScript parser is passed as parserOptions.parser for <script> blocks only.
+  {
+    files: ['**/*.vue'],
+    languageOptions: {
+      parserOptions: {
+        parser: parserTypeScript,
+        project: './tsconfig.json',
+        extraFileExtensions: ['.vue'],
+      },
+    },
+    plugins: {
+      '@typescript-eslint': pluginTypeScript,
+    },
+    rules: {
+      'no-unused-vars': 'off',
+      'no-undef': 'off',
       '@typescript-eslint/no-unused-vars': [
         'error',
         {
@@ -148,13 +177,12 @@ export default [
     },
   },
 
-  // Test files configuration
+  // Test files
   {
     files: ['**/*.test.{js,ts}', '**/*.spec.{js,ts}', '**/tests/**/*'],
     languageOptions: {
       globals: {
         ...globals.jest,
-        ...globals.vitest,
         describe: 'readonly',
         it: 'readonly',
         test: 'readonly',
@@ -172,7 +200,7 @@ export default [
     },
   },
 
-  // Configuration files
+  // Config files
   {
     files: ['**/*.config.{js,ts}', '**/.*rc.{js,ts}'],
     rules: {
@@ -195,4 +223,7 @@ export default [
       '**/*.min.js',
     ],
   },
+
+  // Prettier — must be last to disable all formatting rules
+  eslintConfigPrettier,
 ]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zairakai/js-dev-tools",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "The unified and centralized development toolkit for JavaScript/TypeScript projects - ESLint, Prettier, Stylelint, Knip, Vitest, Git Hooks, and GitLab CI pipeline templates",
   "keywords": [
     "dev-tools",
@@ -88,6 +88,7 @@
     "validate": "make quality"
   },
   "dependencies": {
+    "@eslint/compat": "^2.0.3",
     "@eslint/js": "^10.0.0",
     "@prettier/plugin-php": "^0.24.0",
     "@typescript-eslint/eslint-plugin": "^8.40.0",
@@ -110,7 +111,6 @@
     "vue-eslint-parser": "^10.0.0"
   },
   "devDependencies": {
-    "@eslint/compat": "^2.0.3",
     "@vitest/coverage-v8": "^4.0.0",
     "knip": "^5.85.0",
     "sort-package-json": "^3.6.1",

package/scripts/config.sh

@@ -135,9 +135,9 @@ export -f ensure_bin_optional
 # Check if files matching pattern exist
 has_files() {
     local pattern="$1"
-    # SC2086: unquoted intentionally — we need word splitting + glob expansion via nullglob
+    # SC2086: unquoted intentionally — we need word splitting + glob expansion via nullglob+globstar
     # shellcheck disable=SC2086
-    ( shopt -s nullglob; set -- $pattern; [ $# -gt 0 ] )
+    ( shopt -s nullglob globstar; set -- $pattern; [ $# -gt 0 ] )
 }
 export -f has_files
 

package/scripts/setup-project.sh

@@ -617,6 +617,19 @@ do_publish() {
             "${DEV_TOOLS_ROOT}/${source_rel}" \
             "${PROJECT_ROOT}/${target_rel}" \
             "$key"
+
+        # After publishing markdownlint config to config/dev-tools/, also create a root
+        # .markdownlint.json that extends it — IDEs and editor extensions look at root.
+        if [[ "$key" == "markdownlint" ]]; then
+            local root_markdownlint="${PROJECT_ROOT}/.markdownlint.json"
+            local root_content='{"extends":"./config/dev-tools/.markdownlint.json"}'
+
+            if [[ ! -f "$root_markdownlint" ]]; then
+                echo "$root_content" > "$root_markdownlint"
+                track_created ".markdownlint.json (root — extends config/dev-tools/)"
+                log_success "Created: .markdownlint.json → extends config/dev-tools/.markdownlint.json"
+            fi
+        fi
     done
 }
 

package/stubs/quality/knip.config.js.stub

@@ -1,14 +1,20 @@
 /**
- * Knip configuration
+ * Knip configuration — extends the @zairakai/js-dev-tools base config.
  * @see https://knip.dev/reference/configuration
  */
+
+import baseConfig from '@zairakai/js-dev-tools/config/knip.config.js'
+
 export default {
-  // Extend the base configuration from @zairakai/js-dev-tools
-  // (Assuming the base config is compatible or you want to start fresh)
-  // For now, we point to the project structure
-  entry: ['src/index.ts!', 'src/index.js!'],
-  project: ['src/**/*.ts!', 'src/**/*.js!'],
-  ignore: ['**/*.d.ts'],
-  ignoreDependencies: [],
-  ignoreBinaries: [],
+  ...baseConfig,
+  // Override entry points for your project structure:
+  // entry: ['src/index.ts!'],
+  // project: ['src/**/*.ts!'],
+  ignoreDependencies: [
+    ...(baseConfig.ignoreDependencies ?? []),
+    // Add project-specific ignored dependencies here
+  ],
+  ignoreBinaries: [
+    ...(baseConfig.ignoreBinaries ?? []),
+  ],
 }

package/stubs/style/prettier.config.js.stub

@@ -3,14 +3,15 @@
  * Extends the @zairakai/js-dev-tools base config — customize as needed.
  *
  * Example of adding project-specific overrides:
- *   module.exports = {
+ *   import baseConfig from '@zairakai/js-dev-tools/config/prettier.config.js'
+ *   export default {
  *     ...baseConfig,
  *     printWidth: 100,
  *   }
  */
 
-const baseConfig = require('@zairakai/js-dev-tools/config/prettier.config.js')
+import baseConfig from '@zairakai/js-dev-tools/config/prettier.config.js'
 
-module.exports = {
+export default {
   ...baseConfig,
 }