@zairakai/js-dev-tools 1.0.0 → 1.2.0

package/.gitlab/ci/pipeline-js-package.yml

@@ -41,6 +41,7 @@ include:
 workflow:
   rules:
     - if: $CI_COMMIT_TAG =~ /^v\d+\.\d+\.\d+$/
+    - if: $CI_PIPELINE_SOURCE == "schedule"
     - if: $CI_PIPELINE_SOURCE == "merge_request_event" || $CI_MERGE_REQUEST_ID
     - if: $CI_COMMIT_BRANCH == "main" || $CI_COMMIT_BRANCH == "develop"
     - if: $CI_COMMIT_REF_NAME =~ /^feature\// || $CI_COMMIT_REF_NAME =~ /^fix\// || $CI_COMMIT_REF_NAME =~ /^hotfix\//
@@ -240,6 +241,8 @@ js:quality:bats:
 js:quality:outdated:
   <<: *job_node
   stage: quality
+  rules:
+    - if: $CI_PIPELINE_SOURCE == "schedule"
   script:
     - bash "$DEV_TOOLS_SCRIPTS/outdated.sh"
   artifacts:

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.2.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,9 +617,86 @@ 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
 }
 
+# ============================================================================
+# GitLab CI — Ref Synchronizer
+# Mirrors GitlabCiSynchronizer.php from laravel-dev-tools.
+# Runs on every postinstall (npm install / npm update).
+# Reads the installed version of @zairakai/js-dev-tools and updates the
+# ref: in the project's .gitlab-ci.yml if it is out of sync.
+# ============================================================================
+
+sync_gitlab_ci_ref() {
+    local gitlab_ci="${PROJECT_ROOT}/.gitlab-ci.yml"
+    local gitlab_project="zairakai/npm-packages/js-dev-tools"
+
+    [[ -f "$gitlab_ci" ]] || return 0
+    grep -qF "$gitlab_project" "$gitlab_ci" || return 0
+
+    # Resolve installed version from the package's own package.json
+    local installed_version
+    installed_version="$(node -e "try{const p=require('${DEV_TOOLS_ROOT}/package.json');console.log('v'+(p.version||'').replace(/^v/,''))}catch(e){}" 2>/dev/null || echo "")"
+
+    [[ -n "$installed_version" ]] || return 0
+
+    # Extract the current ref: value inside the js-dev-tools include block
+    local in_block=false found_project=false current_ref=""
+    while IFS= read -r line; do
+        local trimmed="${line#"${line%%[![:space:]]*}"}"  # ltrim
+
+        if [[ "$trimmed" == "include:" ]]; then
+            in_block=true
+            continue
+        fi
+
+        if [[ "$in_block" == true ]]; then
+            # Exit block on non-indented, non-list line
+            if [[ -n "$trimmed" ]] && [[ "$line" != " "* ]] && [[ "$line" != "-"* ]]; then
+                in_block=false
+                found_project=false
+            fi
+
+            if [[ "$found_project" == false ]] && [[ "$trimmed" == *"$gitlab_project"* ]]; then
+                found_project=true
+                continue
+            fi
+
+            if [[ "$found_project" == true ]] && [[ "$trimmed" == ref:* ]]; then
+                current_ref="${trimmed#ref:}"
+                current_ref="${current_ref#"${current_ref%%[![:space:]]*}"}"  # ltrim
+                current_ref="${current_ref//\'/}"
+                current_ref="${current_ref//\"/}"
+                break
+            fi
+        fi
+    done < "$gitlab_ci"
+
+    [[ -n "$current_ref" ]] || return 0
+    [[ "$current_ref" != "$installed_version" ]] || return 0
+
+    # Auto-fix: replace the ref
+    if sed -i "s|ref: ${current_ref}|ref: ${installed_version}|" "$gitlab_ci"; then
+        echo "  dev-tools: .gitlab-ci.yml ref ${current_ref} → ${installed_version}"
+    else
+        echo "  dev-tools: WARNING — could not update .gitlab-ci.yml ref (manual fix needed)" >&2
+    fi
+}
+
 # ============================================================================
 # Makefile Setup
 # ============================================================================
@@ -776,6 +853,9 @@ setup_project() {
             "config/dev-tools/eslint.config.js"
     fi
 
+    # ─── GitLab CI ref sync ───────────────────────────────────────────────────
+    sync_gitlab_ci_ref
+
     # ─── Summary ─────────────────────────────────────────────────────────────
     if [[ "$SILENT_MODE" == "true" ]]; then
         check_optional_deps

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,
 }