@zairakai/js-dev-tools 3.20.0 → 4.0.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 +45 -28
- 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 +17 -17
- package/scripts/stylelint.sh +18 -18
- 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/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,44 +20,44 @@ 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}"
|
|
28
28
|
else
|
|
29
|
-
|
|
29
|
+
STYLELINT_TARGET="${STYLELINT_TARGET:-src/**/*.scss}"
|
|
30
30
|
fi
|
|
31
31
|
|
|
32
32
|
log_step "Fixing: $STYLELINT_TARGET"
|
|
33
33
|
|
|
34
34
|
# Skip gracefully if no matching files exist
|
|
35
35
|
if ! has_files "${PROJECT_ROOT}/${STYLELINT_TARGET}"; then
|
|
36
|
-
|
|
37
|
-
|
|
36
|
+
log_info "No SCSS/CSS files found matching ${STYLELINT_TARGET} - skipping"
|
|
37
|
+
exit 0
|
|
38
38
|
fi
|
|
39
39
|
|
|
40
40
|
STYLELINT_ARGS=(--fix)
|
|
41
41
|
|
|
42
42
|
if [[ -n "$STYLELINT_CONFIG" ]] && [[ "$STYLELINT_CONFIG" != "${PROJECT_ROOT}/stylelint.config.js" ]]; then
|
|
43
|
-
|
|
43
|
+
STYLELINT_ARGS+=(--config "$STYLELINT_CONFIG")
|
|
44
44
|
fi
|
|
45
45
|
|
|
46
46
|
if [[ -n "$STYLELINT_IGNORE" ]]; then
|
|
47
|
-
|
|
47
|
+
STYLELINT_ARGS+=(--ignore-path "$STYLELINT_IGNORE")
|
|
48
48
|
fi
|
|
49
49
|
|
|
50
50
|
# Also respect .gitignore if present
|
|
51
51
|
if [[ -f "${PROJECT_ROOT}/.gitignore" ]]; then
|
|
52
|
-
|
|
52
|
+
STYLELINT_ARGS+=(--ignore-path "${PROJECT_ROOT}/.gitignore")
|
|
53
53
|
fi
|
|
54
54
|
|
|
55
55
|
# Extra ignores passed via --ignore → temp file (gitignore format)
|
|
56
56
|
if [[ ${#EXTRA_IGNORES[@]} -gt 0 ]]; then
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
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")
|
|
61
61
|
fi
|
|
62
62
|
|
|
63
63
|
"$STYLELINT_BIN" "${STYLELINT_ARGS[@]}" "$STYLELINT_TARGET"
|
package/scripts/stylelint.sh
CHANGED
|
@@ -8,58 +8,58 @@ 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}"
|
|
30
30
|
else
|
|
31
|
-
|
|
31
|
+
STYLELINT_TARGET="${STYLELINT_TARGET:-src/**/*.scss}"
|
|
32
32
|
fi
|
|
33
33
|
|
|
34
34
|
log_step "Checking: $STYLELINT_TARGET"
|
|
35
35
|
|
|
36
36
|
# Skip gracefully if no matching files exist (stylelint v16 errors on empty glob)
|
|
37
37
|
if ! has_files "${PROJECT_ROOT}/${STYLELINT_TARGET}"; then
|
|
38
|
-
|
|
39
|
-
|
|
38
|
+
log_info "No SCSS/CSS files found matching ${STYLELINT_TARGET} - skipping"
|
|
39
|
+
exit 0
|
|
40
40
|
fi
|
|
41
41
|
|
|
42
42
|
STYLELINT_ARGS=()
|
|
43
43
|
|
|
44
44
|
if [[ -n "$STYLELINT_CONFIG" ]] && [[ "$STYLELINT_CONFIG" != "${PROJECT_ROOT}/stylelint.config.js" ]]; then
|
|
45
|
-
|
|
45
|
+
STYLELINT_ARGS+=(--config "$STYLELINT_CONFIG")
|
|
46
46
|
fi
|
|
47
47
|
|
|
48
48
|
if [[ -n "$STYLELINT_IGNORE" ]]; then
|
|
49
|
-
|
|
49
|
+
STYLELINT_ARGS+=(--ignore-path "$STYLELINT_IGNORE")
|
|
50
50
|
fi
|
|
51
51
|
|
|
52
52
|
# Also respect .gitignore if present
|
|
53
53
|
if [[ -f "${PROJECT_ROOT}/.gitignore" ]]; then
|
|
54
|
-
|
|
54
|
+
STYLELINT_ARGS+=(--ignore-path "${PROJECT_ROOT}/.gitignore")
|
|
55
55
|
fi
|
|
56
56
|
|
|
57
57
|
# Extra ignores passed via --ignore → temp file (gitignore format)
|
|
58
58
|
if [[ ${#EXTRA_IGNORES[@]} -gt 0 ]]; then
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
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")
|
|
63
63
|
fi
|
|
64
64
|
|
|
65
65
|
"$STYLELINT_BIN" "${STYLELINT_ARGS[@]}" "$STYLELINT_TARGET"
|
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"
|