Makefile

SHELL := /usr/bin/env bash
.SHELLFLAGS := -eu -o pipefail -c
.DEFAULT_GOAL := help

IMAGE_NAME ?= ghcr.io/no42-org/coolmodfiles
IMAGE_TAG  ?= rc

ENV_FILE_ARG := $(if $(wildcard .env),--env-file .env,)
LIBRARY_MOUNT_ARG := $(if $(wildcard ./mods),-v $(CURDIR)/mods:/library:ro -e LIBRARY_ROOT=/library,)

.PHONY: help install dev lint typecheck audit audit-full build test e2e verify format format-check image run clean

help: ## Show this help
	@awk 'BEGIN {FS=":.*?## "} /^[a-zA-Z_-]+:.*?## /{printf "  \033[36m%-14s\033[0m %s\n", $$1, $$2}' $(MAKEFILE_LIST)

install: ## Install dependencies (clean install from lockfile)
	npm ci

dev: ## Start the Next.js dev server with hot reload
	npm run dev

lint: install ## Run ESLint
	npm run lint

typecheck: install ## Run TypeScript compiler in check-only mode
	npm run typecheck

# Dev-tree advisories are excluded: GHSA-mh99-v99m-4gvg (brace-expansion) has no
# fix compatible with eslint 9 / eslint-config-next's minimatch@3 chain.
audit: install ## Run npm audit on production deps (fails on high or critical)
	npm audit --omit=dev --audit-level=high

audit-full: install ## Run npm audit on the full tree incl. dev deps (watched by audit-watch.yml, see #138)
	npm audit --audit-level=high

build: install ## Build the Next.js app
	npm run build

test: install ## Run Vitest test suite
	npm test

e2e: install ## Run Playwright end-to-end tests (installs browsers if missing)
	npx playwright install --with-deps
	npm run test:e2e

verify: install ## Run lint + typecheck + unit-tests + audit + build (fail-fast)
	npm run lint
	npm run typecheck
	npm test
	npm audit --omit=dev --audit-level=high
	npm run build

format: ## Format all files with Prettier
	npm run format

format-check: ## Check that all files are Prettier-formatted
	npm run format:check

image: ## Build the Docker image
	docker build -t $(IMAGE_NAME):$(IMAGE_TAG) .

run: ## Run the image locally on port 3000 (uses .env and ./mods if present)
	docker run --rm -p 3000:3000 $(ENV_FILE_ARG) $(LIBRARY_MOUNT_ARG) $(IMAGE_NAME):$(IMAGE_TAG)

clean: ## Remove build artifacts
	rm -rf .next node_modules