@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.
- package/.editorconfig +11 -72
- package/.gitlab/ci/parts/base.yml +95 -0
- package/.gitlab/ci/parts/publish.yml +156 -0
- package/.gitlab/ci/parts/quality.yml +161 -0
- package/.gitlab/ci/parts/security.yml +40 -0
- package/.gitlab/ci/parts/updates.yml +60 -0
- package/.gitlab/ci/pipeline-js-app.yml +19 -38
- package/.gitlab/ci/pipeline-js-package.yml +23 -528
- package/README.md +92 -11
- package/config/.markdownlintignore +8 -1
- package/config/.prettierignore +13 -0
- package/config/.stylelintignore +13 -3
- package/config/eslint.config.js +7 -1
- package/config/knip.config.js +7 -3
- package/config/stylelint.config.js +1 -0
- package/package.json +46 -29
- package/scripts/build.sh +28 -28
- package/scripts/ci-quality.sh +6 -6
- package/scripts/config.sh +164 -148
- package/scripts/doctor.sh +12 -12
- package/scripts/eslint-fix.sh +8 -8
- package/scripts/eslint.sh +15 -15
- package/scripts/install-bats.sh +143 -146
- package/scripts/install-hooks.sh +108 -111
- package/scripts/install-markdownlint.sh +4 -4
- package/scripts/install-shellcheck.sh +135 -138
- package/scripts/knip.sh +7 -7
- package/scripts/markdownlint.sh +38 -38
- package/scripts/outdated.sh +30 -29
- package/scripts/prettier-fix.sh +13 -13
- package/scripts/prettier.sh +13 -13
- package/scripts/setup-project.sh +691 -629
- package/scripts/stylelint-fix.sh +26 -19
- package/scripts/stylelint.sh +27 -20
- package/scripts/test.sh +13 -11
- package/scripts/typecheck.sh +11 -11
- package/scripts/update-dependencies.mjs +552 -181
- package/scripts/validate-shellcheck.sh +18 -18
- package/stubs/githooks/commit-msg +24 -21
- package/stubs/githooks/pre-commit +19 -19
- package/stubs/githooks/pre-push +18 -18
- package/stubs/githooks/prepare-commit-msg +6 -6
- package/stubs/gitlab-ci/gitlab-ci.yml.stub +1 -1
- package/stubs/governance/CONTRIBUTING.md.stub +5 -3
- package/stubs/quality/eslint.config.js.stub +1 -1
- package/stubs/quality/knip.config.js.stub +1 -1
- package/stubs/style/prettier.config.js.stub +3 -3
- package/stubs/style/stylelint.config.js.stub +8 -1
- package/stubs/testing/vitest.config.js.stub +1 -1
- package/tools/make/bats.mk +3 -3
- package/tools/make/core.mk +3 -3
- package/tools/make/quality.mk +2 -1
- package/tools/make/variables.mk +1 -1
package/scripts/stylelint-fix.sh
CHANGED
|
@@ -8,11 +8,11 @@ maybe_dockerize "$0" "$@"
|
|
|
8
8
|
|
|
9
9
|
EXTRA_IGNORES=()
|
|
10
10
|
while [[ $# -gt 0 ]]; do
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
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
|
-
|
|
23
|
+
log_step "Using configuration: ${STYLELINT_CONFIG#"$PROJECT_ROOT"/}"
|
|
24
24
|
fi
|
|
25
25
|
|
|
26
26
|
if [[ "$PROJECT_TYPE" == "laravel-app" ]]; then
|
|
27
|
-
|
|
27
|
+
STYLELINT_TARGET="${STYLELINT_TARGET:-resources/**/*.scss resources/**/*.css resources/**/*.vue}"
|
|
28
28
|
else
|
|
29
|
-
|
|
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 "${
|
|
36
|
-
|
|
37
|
-
|
|
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
|
-
|
|
50
|
+
STYLELINT_ARGS+=(--config "$STYLELINT_CONFIG")
|
|
44
51
|
fi
|
|
45
52
|
|
|
46
53
|
if [[ -n "$STYLELINT_IGNORE" ]]; then
|
|
47
|
-
|
|
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
|
-
|
|
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
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
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[@]}" "$
|
|
70
|
+
"$STYLELINT_BIN" "${STYLELINT_ARGS[@]}" "${STYLELINT_PATTERNS[@]}"
|
|
64
71
|
|
|
65
72
|
log_success "Stylelint fix applied"
|
package/scripts/stylelint.sh
CHANGED
|
@@ -8,60 +8,67 @@ maybe_dockerize "$0" "$@"
|
|
|
8
8
|
|
|
9
9
|
EXTRA_IGNORES=()
|
|
10
10
|
while [[ $# -gt 0 ]]; do
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
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
|
|
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
|
-
|
|
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
|
-
|
|
29
|
+
STYLELINT_TARGET="${STYLELINT_TARGET:-resources/**/*.scss resources/**/*.css resources/**/*.vue}"
|
|
30
30
|
else
|
|
31
|
-
|
|
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 "${
|
|
38
|
-
|
|
39
|
-
|
|
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
|
-
|
|
52
|
+
STYLELINT_ARGS+=(--config "$STYLELINT_CONFIG")
|
|
46
53
|
fi
|
|
47
54
|
|
|
48
55
|
if [[ -n "$STYLELINT_IGNORE" ]]; then
|
|
49
|
-
|
|
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
|
-
|
|
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
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
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[@]}" "$
|
|
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
|
-
|
|
13
|
-
|
|
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
|
-
|
|
22
|
-
|
|
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
|
-
|
|
29
|
-
|
|
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
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
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
|
-
|
|
40
|
+
"$VITEST_BIN" run --passWithNoTests "${VITEST_ARGS[@]}"
|
|
39
41
|
fi
|
|
40
42
|
|
|
41
43
|
log_success "Tests passed"
|
package/scripts/typecheck.sh
CHANGED
|
@@ -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
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
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
|
-
|
|
36
|
-
|
|
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
|
-
|
|
42
|
-
|
|
41
|
+
log_info "Checker: vue-tsc (Vue SFC support)"
|
|
42
|
+
"$VUE_TSC_BIN" --noEmit
|
|
43
43
|
else
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
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"
|