@zairakai/js-dev-tools 1.4.4 → 2.1.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zairakai/js-dev-tools",
-  "version": "1.4.4",
+  "version": "2.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",
@@ -102,8 +102,8 @@
     "prettier-plugin-blade": "^2.1.0",
     "prettier-plugin-organize-imports": "^4.0.0",
     "stylelint": "^17.8.0",
-    "stylelint-config-html": "^1.1.0",
-    "stylelint-config-recommended-vue": "^1.5.0",
+    "stylelint-config-html": "^2.0.0",
+    "stylelint-config-recommended-vue": "^2.0.0",
     "stylelint-config-standard": "^40.0.0",
     "stylelint-config-standard-scss": "^17.0.0",
     "stylelint-order": "^8.0.0",
@@ -113,7 +113,7 @@
   "devDependencies": {
     "@vitest/coverage-v8": "^4.1.4",
     "knip": "^6.4.1",
-    "sort-package-json": "^3.6.1",
+    "sort-package-json": "^4.0.0",
     "typescript": "^6.0.3",
     "vitest": "^4.1.4",
     "zod": "^4.0.0"

package/scripts/config.sh

@@ -43,6 +43,59 @@ detect_project_type() {
 PROJECT_TYPE="$(detect_project_type)"
 export PROJECT_TYPE
 
+# ─── DOCKER AUTO-DISPATCH ──────────────────────────────────────────────────────
+# Tool scripts that need a real Node runtime (eslint, prettier, stylelint, knip,
+# tsc/vue-tsc, vitest, npm outdated) call maybe_dockerize right after sourcing
+# this file. When a docker-compose stack is already running for this project,
+# the script transparently re-execs itself inside the "node" service instead of
+# depending on whatever Node happens to be on the host.
+#
+# Utility scripts (doctor.sh, install-hooks.sh, git-*.sh, setup-project.sh) never
+# call this — they inspect or act on the host on purpose and must keep doing so.
+#
+# Opt out with DEV_TOOLS_NO_DOCKER=true. Override target service/mount with
+# DEV_TOOLS_NODE_SERVICE / DEV_TOOLS_NODE_SERVICE_MOUNT if a project's compose
+# file diverges from the "node" / "/app" convention.
+DEV_TOOLS_DOCKER_ENV_VARS=(CI COVERAGE)
+
+maybe_dockerize() {
+    local script_path="$1"
+    shift
+
+    # Already running inside a container — nothing to dispatch.
+    [[ -f /.dockerenv ]] && return 0
+
+    # Explicit opt-out.
+    [[ "${DEV_TOOLS_NO_DOCKER:-false}" == "true" ]] && return 0
+
+    # CI runners execute inside a single job image, not this dev compose stack.
+    [[ "${CI:-false}" == "true" || "${GITLAB_CI:-false}" == "true" ]] && return 0
+
+    command -v docker >/dev/null 2>&1 || return 0
+    [[ -f "${PROJECT_ROOT}/docker-compose.yml" ]] || return 0
+
+    local service="${DEV_TOOLS_NODE_SERVICE:-node}"
+    local mount="${DEV_TOOLS_NODE_SERVICE_MOUNT:-/app}"
+
+    # Only dispatch when the target service is already running — never start
+    # it as a side effect of running a quality check.
+    if ! (cd "$PROJECT_ROOT" && docker compose ps --status running --services 2>/dev/null | grep -qx "$service"); then
+        return 0
+    fi
+
+    local rel_script="${script_path#"${PROJECT_ROOT}"/}"
+    local env_flags=()
+    local var
+    for var in "${DEV_TOOLS_DOCKER_ENV_VARS[@]}"; do
+        [[ -n "${!var:-}" ]] && env_flags+=(-e "$var")
+    done
+
+    log_step "Dispatching to '${service}' container..."
+    cd "$PROJECT_ROOT"
+    exec docker compose exec -T "${env_flags[@]}" "$service" bash "${mount}/${rel_script}" "$@"
+}
+export -f maybe_dockerize
+
 # ─── BINARY PATHS ─────────────────────────────────────────────────────────────
 BIN_DIR="${PROJECT_ROOT}/node_modules/.bin"
 export ESLINT_BIN="${BIN_DIR}/eslint"

package/scripts/eslint-fix.sh

@@ -4,6 +4,7 @@ set -euo pipefail
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 # shellcheck disable=SC1091
 source "$SCRIPT_DIR/config.sh"
+maybe_dockerize "$0" "$@"
 
 log_header "ESLint Fix"
 

package/scripts/eslint.sh

@@ -4,6 +4,7 @@ set -euo pipefail
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 # shellcheck disable=SC1091
 source "$SCRIPT_DIR/config.sh"
+maybe_dockerize "$0" "$@"
 
 log_header "ESLint Check"
 

package/scripts/knip.sh

@@ -18,6 +18,7 @@ set -euo pipefail
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 # shellcheck disable=SC1091
 source "${SCRIPT_DIR}/config.sh"
+maybe_dockerize "$0" "$@"
 
 KNIP_BIN="${BIN_DIR}/knip"
 

package/scripts/outdated.sh

@@ -4,6 +4,7 @@ set -euo pipefail
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 # shellcheck disable=SC1091
 source "$SCRIPT_DIR/config.sh"
+maybe_dockerize "$0" "$@"
 
 log_header "NPM Outdated Check"
 

package/scripts/prettier-fix.sh

@@ -4,6 +4,7 @@ set -euo pipefail
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 # shellcheck disable=SC1091
 source "$SCRIPT_DIR/config.sh"
+maybe_dockerize "$0" "$@"
 
 EXTRA_IGNORES=()
 while [[ $# -gt 0 ]]; do

package/scripts/prettier.sh

@@ -4,6 +4,7 @@ set -euo pipefail
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 # shellcheck disable=SC1091
 source "$SCRIPT_DIR/config.sh"
+maybe_dockerize "$0" "$@"
 
 EXTRA_IGNORES=()
 while [[ $# -gt 0 ]]; do

package/scripts/stylelint-fix.sh

@@ -4,6 +4,7 @@ set -euo pipefail
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 # shellcheck disable=SC1091
 source "$SCRIPT_DIR/config.sh"
+maybe_dockerize "$0" "$@"
 
 EXTRA_IGNORES=()
 while [[ $# -gt 0 ]]; do

package/scripts/stylelint.sh

@@ -4,6 +4,7 @@ set -euo pipefail
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 # shellcheck disable=SC1091
 source "$SCRIPT_DIR/config.sh"
+maybe_dockerize "$0" "$@"
 
 EXTRA_IGNORES=()
 while [[ $# -gt 0 ]]; do

package/scripts/test.sh

@@ -4,6 +4,7 @@ set -euo pipefail
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 # shellcheck disable=SC1091
 source "$SCRIPT_DIR/config.sh"
+maybe_dockerize "$0" "$@"
 
 log_header "Vitest Tests"
 

package/scripts/typecheck.sh

@@ -13,6 +13,7 @@ set -euo pipefail
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 # shellcheck disable=SC1091
 source "${SCRIPT_DIR}/config.sh"
+maybe_dockerize "$0" "$@"
 
 TSC_BIN="${BIN_DIR}/tsc"
 VUE_TSC_BIN="${BIN_DIR}/vue-tsc"