@zairakai/js-dev-tools 1.0.0

package/scripts/knip.sh

@@ -0,0 +1,40 @@
+#!/usr/bin/env bash
+#
+# Knip — Dead Code & Unused Dependency Detection
+# Finds unused exports, files, and dependencies in TypeScript/JavaScript projects.
+# https://knip.dev
+#
+# Optional: skips gracefully if knip is not installed.
+#
+# Usage:
+#   bash scripts/knip.sh
+#
+# Installation:
+#   npm install --save-dev knip
+#
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# shellcheck disable=SC1091
+source "${SCRIPT_DIR}/config.sh"
+
+KNIP_BIN="${BIN_DIR}/knip"
+
+log_header "Knip — Dead Code Detection"
+
+if ! ensure_bin_optional "$KNIP_BIN" "knip"; then
+    log_info "Install: npm install --save-dev knip"
+    exit 0
+fi
+
+KNIP_ARGS=()
+
+if [[ -n "$KNIP_CONFIG" ]]; then
+    log_step "Using configuration: ${KNIP_CONFIG#"$PROJECT_ROOT"/}"
+    KNIP_ARGS+=(--config "$KNIP_CONFIG")
+fi
+
+"$KNIP_BIN" "${KNIP_ARGS[@]}"
+
+log_success "Knip check passed — no dead code found"

package/scripts/markdownlint-fix.sh

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# shellcheck disable=SC1091
+source "$SCRIPT_DIR/config.sh"
+
+bash "$SCRIPT_DIR/markdownlint.sh" --fix

package/scripts/markdownlint.sh

@@ -0,0 +1,84 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# shellcheck disable=SC1091
+source "$SCRIPT_DIR/config.sh"
+
+FIX_MODE=false
+EXTRA_IGNORES=()
+while [[ $# -gt 0 ]]; do
+    case "$1" in
+        --fix)        FIX_MODE=true; shift ;;
+        --ignore)     EXTRA_IGNORES+=("$2"); shift 2 ;;
+        --ignore=*)   EXTRA_IGNORES+=("${1#--ignore=}"); shift ;;
+        *)            shift ;;
+    esac
+done
+
+if [[ "$FIX_MODE" == "true" ]]; then
+    log_header "Markdownlint Documentation Auto-Fix"
+else
+    log_header "Markdownlint Documentation Validation"
+fi
+
+ensure_bin "$MARKDOWNLINT_BIN" "markdownlint-cli2" || exit 1
+
+if [[ -z "$MARKDOWNLINT_CONFIG" ]]; then
+    log_error "No markdownlint configuration found"
+    log_warning "Expected one of:"
+    log_warning "  .markdownlint.json (project root)"
+    log_warning "  config/dev-tools/.markdownlint.json (published config)"
+    log_warning "  node_modules/@zairakai/js-dev-tools/config/.markdownlint.json (default)"
+    exit 1
+fi
+
+log_step "Configuration: ${MARKDOWNLINT_CONFIG#"$PROJECT_ROOT"/}"
+
+# Parse a gitignore-format file and inject each entry as !pattern
+_add_ignore_file() {
+    local file="$1"
+    [[ ! -f "$file" ]] && return
+    while IFS= read -r _line || [[ -n "$_line" ]]; do
+        [[ -z "$_line" || "$_line" =~ ^[[:space:]]*# || "$_line" =~ ^! ]] && continue
+        MARKDOWNLINT_ARGS+=("!${_line}")
+    done < "$file"
+}
+
+MARKDOWNLINT_ARGS=("--config" "$MARKDOWNLINT_CONFIG" "**/*.md" "!.git" "!node_modules" "!vendor")
+
+# Parse .gitignore entries as exclusion patterns
+_add_ignore_file "${PROJECT_ROOT}/.gitignore"
+
+# Parse project-specific markdownlint ignore file
+if [[ -n "$MARKDOWNLINT_IGNORE" ]]; then
+    _add_ignore_file "$MARKDOWNLINT_IGNORE"
+fi
+
+# Extra ignores passed via --ignore
+if [[ ${#EXTRA_IGNORES[@]} -gt 0 ]]; then
+    for _ignore in "${EXTRA_IGNORES[@]}"; do
+        MARKDOWNLINT_ARGS+=("!${_ignore}")
+    done
+fi
+
+if [[ "$FIX_MODE" == "true" ]]; then
+    MARKDOWNLINT_ARGS=("--fix" "${MARKDOWNLINT_ARGS[@]}")
+    log_step "Fixing Markdown documentation..."
+else
+    log_step "Validating Markdown documentation..."
+fi
+
+if "$MARKDOWNLINT_BIN" "${MARKDOWNLINT_ARGS[@]}"; then
+    if [[ "$FIX_MODE" == "true" ]]; then
+        log_success "Markdown documentation fixed"
+    else
+        log_success "Markdown validation passed"
+    fi
+    exit 0
+else
+    log_error "Markdownlint found documentation issues"
+    echo ""
+    echo "Fix automatically with: make markdownlint-fix"
+    exit 1
+fi

package/scripts/outdated.sh

@@ -0,0 +1,70 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# shellcheck disable=SC1091
+source "$SCRIPT_DIR/config.sh"
+
+log_header "NPM Outdated Check"
+
+ensure_dir "build/reports"
+
+# ─── IGNORE LIST ──────────────────────────────────────────────────────────────
+# Packages to exclude from the outdated check.
+# Populated from two sources (merged):
+#   1. OUTDATED_IGNORE env var — comma-separated list
+#      e.g. OUTDATED_IGNORE=prettier-plugin-blade,some-other-pkg
+#   2. package.json "outdatedIgnore" array field (optional, project-level)
+#      e.g. "outdatedIgnore": ["prettier-plugin-blade"]
+# ──────────────────────────────────────────────────────────────────────────────
+build_jq_filter() {
+    local ignore_csv="${OUTDATED_IGNORE:-}"
+    local pkg_json="${PROJECT_ROOT}/package.json"
+    local from_pkg_json=""
+
+    if command_exists jq && [[ -f "$pkg_json" ]]; then
+        from_pkg_json="$(jq -r '(.outdatedIgnore // []) | join(",")' "$pkg_json" 2>/dev/null || true)"
+    fi
+
+    # Merge both sources
+    local combined="${ignore_csv}${ignore_csv:+,}${from_pkg_json}"
+
+    if [[ -z "$combined" ]]; then
+        echo "."
+        return
+    fi
+
+    # Build: del(.pkg1) | del(.pkg2) | ...
+    local filter="."
+    IFS=',' read -ra packages <<< "$combined"
+    for pkg in "${packages[@]}"; do
+        pkg="${pkg// /}"  # trim spaces
+        [[ -z "$pkg" ]] && continue
+        filter+=" | del(.\"${pkg}\")"
+    done
+
+    echo "$filter"
+}
+
+log_step "Checking direct dependencies for outdated packages..."
+
+npm outdated --omit=peer --json > build/reports/npm-outdated.json 2>/dev/null || true
+
+JQ_FILTER="$(build_jq_filter)"
+
+if command_exists jq && [[ "$JQ_FILTER" != "." ]]; then
+    log_step "Ignoring: ${OUTDATED_IGNORE:-}$(jq -r '(.outdatedIgnore // []) | join(", ")' "${PROJECT_ROOT}/package.json" 2>/dev/null || true)"
+    filtered="$(jq "${JQ_FILTER}" build/reports/npm-outdated.json 2>/dev/null || cat build/reports/npm-outdated.json)"
+    echo "$filtered" > build/reports/npm-outdated.json
+fi
+
+if [[ ! -s build/reports/npm-outdated.json ]] || [[ "$(cat build/reports/npm-outdated.json)" == "{}" ]]; then
+    log_success "All dependencies are up to date"
+    exit 0
+fi
+
+log_error "Outdated packages found:"
+cat build/reports/npm-outdated.json
+echo ""
+echo "Run: npm update (or update package.json manually)"
+exit 1

package/scripts/prettier-fix.sh

@@ -0,0 +1,52 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# shellcheck disable=SC1091
+source "$SCRIPT_DIR/config.sh"
+
+EXTRA_IGNORES=()
+while [[ $# -gt 0 ]]; do
+    case "$1" in
+        --ignore)     EXTRA_IGNORES+=("$2"); shift 2 ;;
+        --ignore=*)   EXTRA_IGNORES+=("${1#--ignore=}"); shift ;;
+        *)            shift ;;
+    esac
+done
+
+log_header "Prettier Fix"
+
+ensure_bin "$PRETTIER_BIN" "prettier" || exit 1
+
+if [[ -n "$PRETTIER_CONFIG" ]]; then
+    log_step "Using configuration: ${PRETTIER_CONFIG#"$PROJECT_ROOT"/}"
+fi
+
+PRETTIER_ARGS=(--write)
+
+if [[ -n "$PRETTIER_CONFIG" ]] && [[ "$PRETTIER_CONFIG" != "${PROJECT_ROOT}/prettier.config.js" ]]; then
+    PRETTIER_ARGS+=(--config "$PRETTIER_CONFIG")
+fi
+
+if [[ -n "$PRETTIER_IGNORE" ]]; then
+    PRETTIER_ARGS+=(--ignore-path "$PRETTIER_IGNORE")
+fi
+
+# Also respect .gitignore if present
+if [[ -f "${PROJECT_ROOT}/.gitignore" ]]; then
+    PRETTIER_ARGS+=(--ignore-path "${PROJECT_ROOT}/.gitignore")
+fi
+
+# Extra ignores passed via --ignore
+if [[ ${#EXTRA_IGNORES[@]} -gt 0 ]]; then
+    _TMP_IGNORE=$(mktemp)
+    trap 'rm -f "$_TMP_IGNORE"' EXIT
+    printf '%s\n' "${EXTRA_IGNORES[@]}" > "$_TMP_IGNORE"
+    PRETTIER_ARGS+=(--ignore-path "$_TMP_IGNORE")
+fi
+
+PRETTIER_ARGS+=(".")
+
+"$PRETTIER_BIN" "${PRETTIER_ARGS[@]}"
+
+log_success "Prettier fix applied"

package/scripts/prettier.sh

@@ -0,0 +1,53 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# shellcheck disable=SC1091
+source "$SCRIPT_DIR/config.sh"
+
+EXTRA_IGNORES=()
+while [[ $# -gt 0 ]]; do
+    case "$1" in
+        --ignore)     EXTRA_IGNORES+=("$2"); shift 2 ;;
+        --ignore=*)   EXTRA_IGNORES+=("${1#--ignore=}"); shift ;;
+        *)            shift ;;
+    esac
+done
+
+log_header "Prettier Check"
+
+ensure_bin "$PRETTIER_BIN" "prettier" || exit 1
+
+if [[ -n "$PRETTIER_CONFIG" ]]; then
+    log_step "Using configuration: ${PRETTIER_CONFIG#"$PROJECT_ROOT"/}"
+fi
+
+PRETTIER_ARGS=(--check)
+
+if [[ -n "$PRETTIER_CONFIG" ]] && [[ "$PRETTIER_CONFIG" != "${PROJECT_ROOT}/prettier.config.js" ]]; then
+    PRETTIER_ARGS+=(--config "$PRETTIER_CONFIG")
+fi
+
+if [[ -n "$PRETTIER_IGNORE" ]]; then
+    PRETTIER_ARGS+=(--ignore-path "$PRETTIER_IGNORE")
+fi
+
+# Also respect .gitignore if present
+if [[ -f "${PROJECT_ROOT}/.gitignore" ]]; then
+    PRETTIER_ARGS+=(--ignore-path "${PROJECT_ROOT}/.gitignore")
+fi
+
+# Extra ignores passed via --ignore
+if [[ ${#EXTRA_IGNORES[@]} -gt 0 ]]; then
+    _TMP_IGNORE=$(mktemp)
+    trap 'rm -f "$_TMP_IGNORE"' EXIT
+    printf '%s\n' "${EXTRA_IGNORES[@]}" > "$_TMP_IGNORE"
+    PRETTIER_ARGS+=(--ignore-path "$_TMP_IGNORE")
+fi
+
+# Prettier checks all supported files from project root
+PRETTIER_ARGS+=(".")
+
+"$PRETTIER_BIN" "${PRETTIER_ARGS[@]}"
+
+log_success "Prettier check passed"