@zairakai/js-dev-tools 3.20.0 → 3.22.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (53) hide show
  1. package/.editorconfig +11 -72
  2. package/.gitlab/ci/parts/base.yml +95 -0
  3. package/.gitlab/ci/parts/publish.yml +156 -0
  4. package/.gitlab/ci/parts/quality.yml +161 -0
  5. package/.gitlab/ci/parts/security.yml +40 -0
  6. package/.gitlab/ci/parts/updates.yml +60 -0
  7. package/.gitlab/ci/pipeline-js-app.yml +19 -38
  8. package/.gitlab/ci/pipeline-js-package.yml +23 -528
  9. package/README.md +92 -11
  10. package/config/.markdownlintignore +8 -1
  11. package/config/.prettierignore +13 -0
  12. package/config/.stylelintignore +13 -3
  13. package/config/eslint.config.js +7 -1
  14. package/config/knip.config.js +7 -3
  15. package/config/stylelint.config.js +1 -0
  16. package/package.json +46 -29
  17. package/scripts/build.sh +28 -28
  18. package/scripts/ci-quality.sh +6 -6
  19. package/scripts/config.sh +164 -148
  20. package/scripts/doctor.sh +12 -12
  21. package/scripts/eslint-fix.sh +8 -8
  22. package/scripts/eslint.sh +15 -15
  23. package/scripts/install-bats.sh +143 -146
  24. package/scripts/install-hooks.sh +108 -111
  25. package/scripts/install-markdownlint.sh +4 -4
  26. package/scripts/install-shellcheck.sh +135 -138
  27. package/scripts/knip.sh +7 -7
  28. package/scripts/markdownlint.sh +38 -38
  29. package/scripts/outdated.sh +30 -29
  30. package/scripts/prettier-fix.sh +13 -13
  31. package/scripts/prettier.sh +13 -13
  32. package/scripts/setup-project.sh +691 -629
  33. package/scripts/stylelint-fix.sh +26 -19
  34. package/scripts/stylelint.sh +27 -20
  35. package/scripts/test.sh +13 -11
  36. package/scripts/typecheck.sh +11 -11
  37. package/scripts/update-dependencies.mjs +552 -181
  38. package/scripts/validate-shellcheck.sh +18 -18
  39. package/stubs/githooks/commit-msg +24 -21
  40. package/stubs/githooks/pre-commit +19 -19
  41. package/stubs/githooks/pre-push +18 -18
  42. package/stubs/githooks/prepare-commit-msg +6 -6
  43. package/stubs/gitlab-ci/gitlab-ci.yml.stub +1 -1
  44. package/stubs/governance/CONTRIBUTING.md.stub +5 -3
  45. package/stubs/quality/eslint.config.js.stub +1 -1
  46. package/stubs/quality/knip.config.js.stub +1 -1
  47. package/stubs/style/prettier.config.js.stub +3 -3
  48. package/stubs/style/stylelint.config.js.stub +8 -1
  49. package/stubs/testing/vitest.config.js.stub +1 -1
  50. package/tools/make/bats.mk +3 -3
  51. package/tools/make/core.mk +3 -3
  52. package/tools/make/quality.mk +2 -1
  53. package/tools/make/variables.mk +1 -1
@@ -8,11 +8,11 @@ maybe_dockerize "$0" "$@"
8
8
 
9
9
  EXTRA_IGNORES=()
10
10
  while [[ $# -gt 0 ]]; do
11
- case "$1" in
12
- --ignore) EXTRA_IGNORES+=("$2"); shift 2 ;;
13
- --ignore=*) EXTRA_IGNORES+=("${1#--ignore=}"); shift ;;
14
- *) shift ;;
15
- esac
11
+ case "$1" in
12
+ --ignore) EXTRA_IGNORES+=("$2"); shift 2 ;;
13
+ --ignore=*) EXTRA_IGNORES+=("${1#--ignore=}"); shift ;;
14
+ *) shift ;;
15
+ esac
16
16
  done
17
17
 
18
18
  log_header "Stylelint Fix"
@@ -20,46 +20,53 @@ log_header "Stylelint Fix"
20
20
  ensure_bin_optional "$STYLELINT_BIN" "stylelint" || exit 0
21
21
 
22
22
  if [[ -n "$STYLELINT_CONFIG" ]]; then
23
- log_step "Using configuration: ${STYLELINT_CONFIG#"$PROJECT_ROOT"/}"
23
+ log_step "Using configuration: ${STYLELINT_CONFIG#"$PROJECT_ROOT"/}"
24
24
  fi
25
25
 
26
26
  if [[ "$PROJECT_TYPE" == "laravel-app" ]]; then
27
- STYLELINT_TARGET="${STYLELINT_TARGET:-resources/**/*.scss}"
27
+ STYLELINT_TARGET="${STYLELINT_TARGET:-resources/**/*.scss resources/**/*.css resources/**/*.vue}"
28
28
  else
29
- STYLELINT_TARGET="${STYLELINT_TARGET:-src/**/*.scss}"
29
+ STYLELINT_TARGET="${STYLELINT_TARGET:-src/**/*.scss src/**/*.css src/**/*.vue}"
30
30
  fi
31
31
 
32
+ # STYLELINT_TARGET is a list of globs separated by spaces (one per file type: stylelint lints the style blocks of .vue)
33
+ read -r -a STYLELINT_PATTERNS <<< "$STYLELINT_TARGET"
34
+ STYLELINT_ABSOLUTE=()
35
+ for _pattern in "${STYLELINT_PATTERNS[@]}"; do
36
+ STYLELINT_ABSOLUTE+=("${PROJECT_ROOT}/${_pattern}")
37
+ done
38
+
32
39
  log_step "Fixing: $STYLELINT_TARGET"
33
40
 
34
41
  # Skip gracefully if no matching files exist
35
- if ! has_files "${PROJECT_ROOT}/${STYLELINT_TARGET}"; then
36
- log_info "No SCSS/CSS files found matching ${STYLELINT_TARGET} — skipping"
37
- exit 0
42
+ if ! has_files "${STYLELINT_ABSOLUTE[@]}"; then
43
+ log_info "No SCSS, CSS or Vue files found matching ${STYLELINT_TARGET} - skipping"
44
+ exit 0
38
45
  fi
39
46
 
40
47
  STYLELINT_ARGS=(--fix)
41
48
 
42
49
  if [[ -n "$STYLELINT_CONFIG" ]] && [[ "$STYLELINT_CONFIG" != "${PROJECT_ROOT}/stylelint.config.js" ]]; then
43
- STYLELINT_ARGS+=(--config "$STYLELINT_CONFIG")
50
+ STYLELINT_ARGS+=(--config "$STYLELINT_CONFIG")
44
51
  fi
45
52
 
46
53
  if [[ -n "$STYLELINT_IGNORE" ]]; then
47
- STYLELINT_ARGS+=(--ignore-path "$STYLELINT_IGNORE")
54
+ STYLELINT_ARGS+=(--ignore-path "$STYLELINT_IGNORE")
48
55
  fi
49
56
 
50
57
  # Also respect .gitignore if present
51
58
  if [[ -f "${PROJECT_ROOT}/.gitignore" ]]; then
52
- STYLELINT_ARGS+=(--ignore-path "${PROJECT_ROOT}/.gitignore")
59
+ STYLELINT_ARGS+=(--ignore-path "${PROJECT_ROOT}/.gitignore")
53
60
  fi
54
61
 
55
62
  # Extra ignores passed via --ignore → temp file (gitignore format)
56
63
  if [[ ${#EXTRA_IGNORES[@]} -gt 0 ]]; then
57
- _TMP_IGNORE=$(mktemp)
58
- trap 'rm -f "$_TMP_IGNORE"' EXIT
59
- printf '%s\n' "${EXTRA_IGNORES[@]}" > "$_TMP_IGNORE"
60
- STYLELINT_ARGS+=(--ignore-path "$_TMP_IGNORE")
64
+ _TMP_IGNORE=$(mktemp)
65
+ trap 'rm -f "$_TMP_IGNORE"' EXIT
66
+ printf '%s\n' "${EXTRA_IGNORES[@]}" > "$_TMP_IGNORE"
67
+ STYLELINT_ARGS+=(--ignore-path "$_TMP_IGNORE")
61
68
  fi
62
69
 
63
- "$STYLELINT_BIN" "${STYLELINT_ARGS[@]}" "$STYLELINT_TARGET"
70
+ "$STYLELINT_BIN" "${STYLELINT_ARGS[@]}" "${STYLELINT_PATTERNS[@]}"
64
71
 
65
72
  log_success "Stylelint fix applied"
@@ -8,60 +8,67 @@ maybe_dockerize "$0" "$@"
8
8
 
9
9
  EXTRA_IGNORES=()
10
10
  while [[ $# -gt 0 ]]; do
11
- case "$1" in
12
- --ignore) EXTRA_IGNORES+=("$2"); shift 2 ;;
13
- --ignore=*) EXTRA_IGNORES+=("${1#--ignore=}"); shift ;;
14
- *) shift ;;
15
- esac
11
+ case "$1" in
12
+ --ignore) EXTRA_IGNORES+=("$2"); shift 2 ;;
13
+ --ignore=*) EXTRA_IGNORES+=("${1#--ignore=}"); shift ;;
14
+ *) shift ;;
15
+ esac
16
16
  done
17
17
 
18
18
  log_header "Stylelint Check"
19
19
 
20
- # Stylelint is optional — skip gracefully if not installed
20
+ # Stylelint is optional - skip gracefully if not installed
21
21
  ensure_bin_optional "$STYLELINT_BIN" "stylelint" || exit 0
22
22
 
23
23
  if [[ -n "$STYLELINT_CONFIG" ]]; then
24
- log_step "Using configuration: ${STYLELINT_CONFIG#"$PROJECT_ROOT"/}"
24
+ log_step "Using configuration: ${STYLELINT_CONFIG#"$PROJECT_ROOT"/}"
25
25
  fi
26
26
 
27
27
  # Lint target depends on project type (overridable via env)
28
28
  if [[ "$PROJECT_TYPE" == "laravel-app" ]]; then
29
- STYLELINT_TARGET="${STYLELINT_TARGET:-resources/**/*.scss}"
29
+ STYLELINT_TARGET="${STYLELINT_TARGET:-resources/**/*.scss resources/**/*.css resources/**/*.vue}"
30
30
  else
31
- STYLELINT_TARGET="${STYLELINT_TARGET:-src/**/*.scss}"
31
+ STYLELINT_TARGET="${STYLELINT_TARGET:-src/**/*.scss src/**/*.css src/**/*.vue}"
32
32
  fi
33
33
 
34
+ # STYLELINT_TARGET is a list of globs separated by spaces (one per file type: stylelint lints the style blocks of .vue)
35
+ read -r -a STYLELINT_PATTERNS <<< "$STYLELINT_TARGET"
36
+ STYLELINT_ABSOLUTE=()
37
+ for _pattern in "${STYLELINT_PATTERNS[@]}"; do
38
+ STYLELINT_ABSOLUTE+=("${PROJECT_ROOT}/${_pattern}")
39
+ done
40
+
34
41
  log_step "Checking: $STYLELINT_TARGET"
35
42
 
36
43
  # Skip gracefully if no matching files exist (stylelint v16 errors on empty glob)
37
- if ! has_files "${PROJECT_ROOT}/${STYLELINT_TARGET}"; then
38
- log_info "No SCSS/CSS files found matching ${STYLELINT_TARGET} — skipping"
39
- exit 0
44
+ if ! has_files "${STYLELINT_ABSOLUTE[@]}"; then
45
+ log_info "No SCSS, CSS or Vue files found matching ${STYLELINT_TARGET} - skipping"
46
+ exit 0
40
47
  fi
41
48
 
42
49
  STYLELINT_ARGS=()
43
50
 
44
51
  if [[ -n "$STYLELINT_CONFIG" ]] && [[ "$STYLELINT_CONFIG" != "${PROJECT_ROOT}/stylelint.config.js" ]]; then
45
- STYLELINT_ARGS+=(--config "$STYLELINT_CONFIG")
52
+ STYLELINT_ARGS+=(--config "$STYLELINT_CONFIG")
46
53
  fi
47
54
 
48
55
  if [[ -n "$STYLELINT_IGNORE" ]]; then
49
- STYLELINT_ARGS+=(--ignore-path "$STYLELINT_IGNORE")
56
+ STYLELINT_ARGS+=(--ignore-path "$STYLELINT_IGNORE")
50
57
  fi
51
58
 
52
59
  # Also respect .gitignore if present
53
60
  if [[ -f "${PROJECT_ROOT}/.gitignore" ]]; then
54
- STYLELINT_ARGS+=(--ignore-path "${PROJECT_ROOT}/.gitignore")
61
+ STYLELINT_ARGS+=(--ignore-path "${PROJECT_ROOT}/.gitignore")
55
62
  fi
56
63
 
57
64
  # Extra ignores passed via --ignore → temp file (gitignore format)
58
65
  if [[ ${#EXTRA_IGNORES[@]} -gt 0 ]]; then
59
- _TMP_IGNORE=$(mktemp)
60
- trap 'rm -f "$_TMP_IGNORE"' EXIT
61
- printf '%s\n' "${EXTRA_IGNORES[@]}" > "$_TMP_IGNORE"
62
- STYLELINT_ARGS+=(--ignore-path "$_TMP_IGNORE")
66
+ _TMP_IGNORE=$(mktemp)
67
+ trap 'rm -f "$_TMP_IGNORE"' EXIT
68
+ printf '%s\n' "${EXTRA_IGNORES[@]}" > "$_TMP_IGNORE"
69
+ STYLELINT_ARGS+=(--ignore-path "$_TMP_IGNORE")
63
70
  fi
64
71
 
65
- "$STYLELINT_BIN" "${STYLELINT_ARGS[@]}" "$STYLELINT_TARGET"
72
+ "$STYLELINT_BIN" "${STYLELINT_ARGS[@]}" "${STYLELINT_PATTERNS[@]}"
66
73
 
67
74
  log_success "Stylelint check passed"
package/scripts/test.sh CHANGED
@@ -9,8 +9,8 @@ maybe_dockerize "$0" "$@"
9
9
  log_header "Vitest Tests"
10
10
 
11
11
  if ! ensure_bin_optional "$VITEST_BIN" "vitest"; then
12
- log_warning "vitest not installed — add it to devDependencies to run tests"
13
- exit 0
12
+ log_warning "vitest not installed - add it to devDependencies to run tests"
13
+ exit 0
14
14
  fi
15
15
 
16
16
  COVERAGE="${COVERAGE:-false}"
@@ -18,24 +18,26 @@ CI="${CI:-false}"
18
18
 
19
19
  # CI mode: always run with coverage
20
20
  if [[ "$CI" == "true" ]]; then
21
- log_info "Running in CI mode (strict + coverage)"
22
- COVERAGE="true"
21
+ log_info "Running in CI mode (strict + coverage)"
22
+ COVERAGE="true"
23
23
  fi
24
24
 
25
25
  VITEST_ARGS=()
26
26
 
27
27
  if [[ -n "$VITEST_CONFIG" ]]; then
28
- log_step "Using configuration: ${VITEST_CONFIG#"$PROJECT_ROOT"/}"
29
- VITEST_ARGS+=(--config "$VITEST_CONFIG")
28
+ log_step "Using configuration: ${VITEST_CONFIG#"$PROJECT_ROOT"/}"
29
+ VITEST_ARGS+=(--config "$VITEST_CONFIG")
30
30
  fi
31
31
 
32
32
  if [[ "$COVERAGE" == "true" ]]; then
33
- log_info "Running with coverage report"
34
- ensure_dir "build/coverage"
35
- ensure_dir "build/logs"
36
- "$VITEST_BIN" run --coverage --passWithNoTests "${VITEST_ARGS[@]}"
33
+ log_info "Running with coverage report"
34
+ ensure_dir "coverage"
35
+ ensure_dir "build/logs"
36
+ # The JUnit file is the test report that GitLab shows in the merge request
37
+ "$VITEST_BIN" run --coverage --reporter=default --reporter=junit --outputFile.junit=coverage/junit.xml \
38
+ --passWithNoTests "${VITEST_ARGS[@]}"
37
39
  else
38
- "$VITEST_BIN" run --passWithNoTests "${VITEST_ARGS[@]}"
40
+ "$VITEST_BIN" run --passWithNoTests "${VITEST_ARGS[@]}"
39
41
  fi
40
42
 
41
43
  log_success "Tests passed"
@@ -21,10 +21,10 @@ VUE_TSC_BIN="${BIN_DIR}/vue-tsc"
21
21
  log_header "TypeScript Type Checking"
22
22
 
23
23
  if [[ ! -f "${PROJECT_ROOT}/tsconfig.json" ]]; then
24
- log_error "No tsconfig.json found at project root"
25
- log_info "Publish one with:"
26
- log_info " bash node_modules/@zairakai/js-dev-tools/scripts/setup-project.sh --publish=tsconfig"
27
- exit 1
24
+ log_error "No tsconfig.json found at project root"
25
+ log_info "Publish one with:"
26
+ log_info " bash node_modules/@zairakai/js-dev-tools/scripts/setup-project.sh --publish=tsconfig"
27
+ exit 1
28
28
  fi
29
29
 
30
30
  log_info "Config: tsconfig.json"
@@ -32,18 +32,18 @@ log_info "Mode: --noEmit (type validation only)"
32
32
 
33
33
  # Skip gracefully if no .ts/.vue files are found
34
34
  if ! has_files "${PROJECT_ROOT}/**/*.ts" && ! has_files "${PROJECT_ROOT}/**/*.tsx" && ! has_files "${PROJECT_ROOT}/**/*.vue"; then
35
- log_info "No TypeScript or Vue files found — skipping"
36
- exit 0
35
+ log_info "No TypeScript or Vue files found - skipping"
36
+ exit 0
37
37
  fi
38
38
 
39
39
  # Prefer vue-tsc when available (handles .vue SFC imports correctly)
40
40
  if [[ -x "$VUE_TSC_BIN" ]]; then
41
- log_info "Checker: vue-tsc (Vue SFC support)"
42
- "$VUE_TSC_BIN" --noEmit
41
+ log_info "Checker: vue-tsc (Vue SFC support)"
42
+ "$VUE_TSC_BIN" --noEmit
43
43
  else
44
- ensure_bin "$TSC_BIN" "tsc (typescript)"
45
- log_info "Checker: tsc"
46
- "$TSC_BIN" --noEmit
44
+ ensure_bin "$TSC_BIN" "tsc (typescript)"
45
+ log_info "Checker: tsc"
46
+ "$TSC_BIN" --noEmit
47
47
  fi
48
48
 
49
49
  log_success "TypeScript type checking passed"