Makefile

# SPDX-FileCopyrightText: 2024-2026 caixw
#
# SPDX-License-Identifier: MIT

ROOT = .
APPS = $(ROOT)/apps

APPS_SERVER = $(APPS)/server
SERVER_BIN = server

ifeq ($(OS),Windows_NT)
	SERVER_BIN = server.exe
else
	SERVER_BIN = server
endif

########################### mk-coverage ###################################

.PHONY: mk-coverage gen

COVERAGE = $(ROOT)/coverage
ifeq ($(OS),Windows_NT)
	MKCOVERAGE = mkdir "$(COVERAGE)" 2>NUL || exit 0
else
	MKCOVERAGE = mkdir -p $(COVERAGE)
endif

mk-coverage:
	$(MKCOVERAGE)

# 生成中间代码
gen:
	go generate $(ROOT)/...

########################### build ###################################

.PHONY: build build-go build-ts build-app
.PHONY: build-ts-plugin-about build-ts-plugin-api build-ts-plugin
.PHONY: build-ts-docs build-ts-admin-demo build-ts-core build-ts-components build-ts-illustrations build-ts-admin

build: build-go build-ts

build-app: build-go build-ts-admin build-ts-docs

build-ts-plugin: build-ts-plugin-about build-ts-plugin-api

build-go: gen
	go build -o=$(APPS_SERVER)/$(SERVER_BIN) -v $(APPS_SERVER)

build-ts-docs: build-ts-admin-demo build-ts-plugin-api
	pnpm --filter=./apps/docs run build

build-ts-plugin-about: build-ts-admin
	pnpm --filter=./build/vite-plugin-about run build

build-ts-plugin-api:
	pnpm --filter=./build/vite-plugin-api run build

build-ts-core:
	pnpm --filter=./packages/core run build

build-ts-components: build-ts-core
	pnpm --filter=./packages/components run build

build-ts-illustrations: build-ts-components
	pnpm --filter=./packages/illustrations run build

build-ts-admin: build-ts-components build-ts-illustrations
	pnpm --filter=./packages/admin run build

build-ts-admin-demo: build-ts-admin build-ts-plugin-about
	pnpm --filter=./apps/admin run build

# 编译前端项目内容
build-ts: build-ts-docs

########################### install ###################################

.PHONY: install install-ts install-go init

install-ts:
	pnpm install

install-go:
	go mod download

# 安装依赖
install: install-go install-ts

# 安装基本数据，依赖 build 生成的测试项目
init: build-app
	cd $(APPS_SERVER) && ./$(SERVER_BIN) -a=install

########################### watch ###################################

.PHONY: watch-server watch-admin watch-docs watch

watch-server:
	web watch -app=-a=serve $(APPS_SERVER)

watch-admin:
	pnpm --filter=./apps/admin run dev

watch-docs:
	pnpm --filter=./apps/docs run dev

# 运行测试内容
#
# 需要采用 -j 执行并行命令，比如：
#  make watch -j2
watch: watch-server watch-admin

########################### test ###################################

.PHONY: test test-go test-ts lint-ts
.PHONY: test-ts-core test-ts-components test-ts-admin
.PHONY: test-ts-docs
.PHONY: test-ts-plugin-about test-ts-plugin-api

lint-ts:
	pnpm run lint

# 执行 Go 测试
test-go: mk-coverage
	go vet -v ./...
	go test -v -coverprofile='coverage/go.txt' -p=1 -parallel=1 -covermode=atomic ./...

test-ts-plugin-about: mk-coverage
	pnpm run test --project=@cmfx/vite-plugin-about

test-ts-plugin-api: mk-coverage
	pnpm run test --project=@cmfx/vite-plugin-api

test-ts-core: mk-coverage
	pnpm run test --project=@cmfx/core

test-ts-docs: mk-coverage
	pnpm run test --project=@cmfx/docs

test-ts-components: mk-coverage build-ts-core
	pnpm run test --project=@cmfx/components

test-ts-admin: mk-coverage build-ts-components
	pnpm run test --project=@cmfx/admin

# 执行 TypeScript 测试
test-ts: build-ts mk-coverage
	pnpm run test-nowatch

# 执行测试内容
test: test-go test-ts

############################# changelog ###############################

# 生成 CHANGELOG.md 文件，接受 from 和 to 参数，用于指定生成的范围，一般为 git tag 值。
# to 同时也会作为版本号写入 CHANGELOG.md 文件。
#
# 如果不指定参数
# to 表示最新的提交
# from 表示第一个提交
#
# 用法：
# make changelog
# make changelog from=v1.0.0 to=v1.1.0

.PHONY: changelog
to = 'HEAD'
from = '$(shell git rev-list --max-parents=0 HEAD)'

changelog:
	bash ./scripts/changelog.sh $(from) $(to)

########################### publish ###################################

.PHONY: publish-npm

publish-npm: build-ts
	pnpm publish --filter=./packages/core --filter=./packages/components \
	--filter=./packages/admin --filter=./packages/illustrations \
	--filter=./build/vite-plugin-about --filter=./build/vite-plugin-api \
	--access=public --no-git-checks

########################### version ###################################

# 用于修正当前项目的版本号
#
# 包含一个参数 target，用以指定需要升级的版本号，可以是 patch、minor 和 major 三个值，默认值为 patch。
# 比如：`make version` 或是 `make version target=minor`
#
# 该操作会同时更新所有 package.json 中的版本号以及 cmfx/VERSION 的内容，后者为服务端项目的版本号。
#
# NOTE: 大版本号的更新会清零小版本号。

.PHONY: version
target = patch
version:
	@VER=$$(pnpm version $(target) --commit-hooks=false --git-tag-version=false --workspaces \
	--include-workspace-root --workspaces-update=false | tail -n 1 | sed 's/^v//'); \
	echo $$VER > cmfx/VERSION