makefile

.PHONY: help
help: makefile
	@tail -n +4 makefile | grep ".PHONY"


.PHONY: format
format:
	cargo clippy --fix --allow-dirty
	cargo fmt
	# nix fmt  # TODO: Reactivate when it's faster


.PHONY: lint
lint:
	cargo fmt --all --check
	cargo clippy --workspace --all-targets -- --deny warnings


.PHONY: lint-lua
lint-lua:
	cargo run --package luacad -- lint examples/


.PHONY: test-units
test-units:
	cargo test --lib --bins -- --show-output
	@echo "✅ All unit tests passed!\n\n"


.PHONY: build
build:
	cargo build


.PHONY: test
test:
	cargo test


# Regenerate the rasterized and path-traced image next to every example's
# entry point (literal_openscad has none: it only emits OpenSCAD code)
.PHONY: example-images
example-images:
	cargo build --package luacad --release
	@for entry in examples/*/*.lua examples/*/*.scad; do \
		case $$entry in examples/literal_openscad/*) continue;; esac; \
		base=$${entry%.*}; \
		echo "→ $$base.png"; \
		target/release/luacad render "$$entry" "$$base.png"; \
		echo "→ $${base}_raytraced.png"; \
		target/release/luacad render --raytrace "$$entry" \
			"$${base}_raytraced.png"; \
	done


# Regenerates website/examples.html — every example's source, the OpenSCAD it
# exports to and a preview — from the examples themselves. The page is checked
# in because GitHub Pages deploys `website/` as it stands, so it has to be
# rebuilt whenever an example changes.
.PHONY: website-examples
website-examples:
	@command -v lua > /dev/null \
		|| (echo "No lua interpreter on this shell" && exit 1)
	cargo build --package luacad --release
	cd website-src \
		&& LUACAD=../target/release/luacad lua build_examples.lua


# The browser build behind https://luacad.ad-si.com/playground.
#
# Needs Emscripten on the shell: `nix develop` provides it, as does sourcing
# an emsdk's `emsdk_env.sh`. The per-target compiler variables are set because
# a `CC` inherited from the environment — a Nix dev shell sets one, for
# instance — otherwise wins over the `emcc` the `cc` crate would pick for this
# target on its own.
.PHONY: wasm
wasm:
	@command -v emcc > /dev/null \
		|| (echo "No emcc on this shell: run \`nix develop\`," \
			"or source <emsdk>/emsdk_env.sh" && exit 1)
	CC_wasm32_unknown_emscripten=emcc \
	CXX_wasm32_unknown_emscripten=em++ \
	AR_wasm32_unknown_emscripten=emar \
		cargo build --package luacad-wasm --release \
			--target wasm32-unknown-emscripten
	cp target/wasm32-unknown-emscripten/release/luacad-wasm.js \
		target/wasm32-unknown-emscripten/release/luacad_wasm.wasm \
		website/playground/


# An activated emsdk puts its own root on `PATH`, and that root holds a
# `node` *directory* — which shadows the real interpreter and fails with
# "Permission denied". Emscripten names the node it installed in
# `EMSDK_NODE`, so prefer that whenever it is set.
NODE ?= $(if $(EMSDK_NODE),$(EMSDK_NODE),node)

.PHONY: test-wasm
test-wasm: wasm
	$(NODE) crates/luacad-wasm/smoke_test.mjs website/playground


# Serves the website exactly as GitHub Pages does, so the playground can be
# tried out locally. The wasm module needs a real HTTP server; opening the
# file directly does not work.
.PHONY: serve-website
serve-website: wasm
	@echo "→ http://localhost:8000/playground/"
	cd website && python3 -m http.server 8000


.PHONY: run
run:
	cargo run --package luacad-studio


.PHONY: dev
dev:
	watchexec --restart --exts rs,toml -- cargo run --package luacad-studio


.PHONY: package
package:
	cargo package --workspace


.PHONY: release
release:
	@echo '1. `cai changelog <first-commit-hash>`, then give the'
	@echo '   `## Unreleased` heading its version and date, as in'
	@echo '   `## 2026-08-22 - 1.2.0`.'
	@echo '2. Bump the version in the root `Cargo.toml`: `workspace.package`'
	@echo '   and every entry of `workspace.dependencies`. No member manifest'
	@echo '   names a version, so those are all of them. A `cargo check`'
	@echo '   writes the new versions into `Cargo.lock`.'
	@echo '3. Regenerate what is derived from the sources, in case a change'
	@echo '   since the last release did not:'
	@echo '     make example-images    # the images next to every example'
	@echo '     make website-examples  # website/examples.html'
	@echo '4. `git add -u && git commit -m "Release <version>"`'
	@echo '5. Check CI is green on main — the `package` job verifies every'
	@echo '   crate builds from its tarball. `make package` does the same'
	@echo '   locally, but reuses cached builds of the local registry and can'
	@echo '   pass or fail against stale artifacts; trust CI over it.'
	@echo '6. Publish in dependency order — each must be live on crates.io'
	@echo '   before the next one can resolve it:'
	@echo '     cargo publish -p luacad-manifold-sys'
	@echo '     cargo publish -p luacad-prime-core'
	@echo '     cargo publish -p luacad-scad-syntax'
	@echo '     cargo publish -p luacad-scad-ir'
	@echo '     cargo publish -p luacad-scad-eval'
	@echo '     cargo publish -p opencsg-sys'
	@echo '     cargo publish -p luacad'
	@echo '     cargo publish -p luacad-studio'
	@echo '7. Push a `v*` tag, or create the release at' \
		'https://github.com/ad-si/LuaCAD/releases/new'
	@echo '   The `release` job attaches the binaries of every platform and'
	@echo '   their checksums; a bare tag gets a draft release to publish.'
	@echo '8. Point the Homebrew tap at the new release:'
	@echo '   https://github.com/ad-si/homebrew-tap'
	@echo '   `brew install ad-si/tap/luacad` hands out the prebuilt binaries'
	@echo '   attached in step 7, so the formula needs their new URLs and the'
	@echo '   checksums from the `SHA256SUMS.txt` next to them.'
	@echo -e \
		"9. Announce release on \n" \
		"   - https://x.com \n" \
		"   - https://bsky.app \n" \
		"   - https://this-week-in-rust.org \n" \
		"   - https://news.ycombinator.com \n" \
		"   - https://lobste.rs \n" \
		"   - Reddit \n" \
		"     - https://reddit.com/r/rust \n"


.PHONY: install
install:
	cargo install --path crates/luacad
	cargo install --path crates/luacad-studio