chore: repo hygiene for the wasm era (WO-WZ-015 fix round)

Replace the retired .so Makefile with the wasm/.bnp convention (build /
verify / archive-check / publish via ninja plugin build), gitignore *.so
and *.bnp artifacts, and refresh the stale [compatibility] block_core
constraint to the v0.15 era.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
Alex Dunmow 2026-07-04 00:15:31 +08:00
parent 0a24e8ecff
commit e3a471a3df
3 changed files with 45 additions and 16 deletions

1
.gitignore vendored
View File

@ -3,3 +3,4 @@
tmp/
.idea/
.vscode/
*.bnp

View File

@ -1,20 +1,45 @@
# Noir — build helpers (.so plugin workflow)
# noir — build & publish helpers (wasm .bnp workflow)
#
# Local single-shot build:
# make # produces noir.so via CGO go build -buildmode=plugin
# make templ # regenerate *_templ.go files
# make clean # remove build artefacts
# The theme compiles to a wasip1 reactor-mode wasm module packed into a .bnp
# artifact (`ninja plugin build`). The legacy .so path is retired (WO-WZ-015):
# the CMS is wasm-native and can no longer load .so plugins. Distribution is
# publish-to-registry -> InstallFromRegistry (hot-load, no restart).
#
# Usage:
# make build # compile wasm + pack noir-<version>.bnp
# make verify # validate the built .bnp (layout/abi/name/size)
# make archive-check # prove a clean `git archive HEAD` compiles to wasm
# make publish # ninja plugin publish --bnp (to the active registry)
# make templ # regenerate templ Go files
# make clean # remove build artefacts
.PHONY: all clean templ help
.PHONY: build verify archive-check publish templ clean help
PLUGIN_NAME := noir
NINJA := ninja
BNP := $(PLUGIN_NAME)-$(shell grep '^version' plugin.mod | sed 's/.*"\(.*\)"/\1/').bnp
# Default target: build the .so locally.
all: $(PLUGIN_NAME).so
# Compile to wasm and pack the .bnp (GOOS=wasip1 GOARCH=wasm, DESCRIBE probe,
# tar.zst of plugin.wasm + plugin.mod + manifest.pb + schemas/ + assets/).
build:
$(NINJA) plugin build --dir .
# Local plugin build (no container). Compiles to .so.
$(PLUGIN_NAME).so: $(wildcard *.go) plugin.mod go.mod
CGO_ENABLED=1 go build -buildmode=plugin -ldflags="-s -w" -o $(PLUGIN_NAME).so .
# Validate the built .bnp exactly as the registry/loader will.
verify:
$(NINJA) plugin verify $(BNP)
# Prove a clean `git archive HEAD` (what publish ships) compiles to wasm.
archive-check:
@T=$$(mktemp -d /tmp/archive-check-$(PLUGIN_NAME).XXXXXX) && \
trap 'rm -rf "$$T"' EXIT && \
git archive HEAD | tar -x -C "$$T" && \
cd "$$T" && GOOS=wasip1 GOARCH=wasm go build -buildmode=c-shared -o "$$T/check.wasm" . && \
echo "archive-check OK"
# Publish the prebuilt .bnp to the active registry.
# Pass --host https://my.localdev.blockninjacms.com for the dev orchestrator.
publish: build
$(NINJA) plugin publish --bnp $(BNP)
# Regenerate templ Go files locally.
templ:
@ -22,10 +47,13 @@ templ:
# Remove build artefacts.
clean:
rm -f $(PLUGIN_NAME).so
rm -f $(PLUGIN_NAME)-*.bnp $(PLUGIN_NAME).so plugin.wasm
help:
@echo "Targets:"
@echo " all Build $(PLUGIN_NAME).so (default)"
@echo " templ Regenerate *_templ.go files"
@echo " clean Remove build artefacts"
@echo " build Compile wasm + pack the .bnp"
@echo " verify Validate the built .bnp (loader-identical checks)"
@echo " archive-check Prove a clean git archive HEAD compiles to wasm"
@echo " publish Publish the .bnp to the active registry"
@echo " templ Regenerate templ Go files"
@echo " clean Remove build artefacts"

View File

@ -9,4 +9,4 @@ categories = ["templates"]
tags = ["noir", "monochrome", "photography", "portfolio", "gallery", "filmmaker", "fashion", "darkroom"]
[compatibility]
block_core = ">=0.11.0 <0.12.0"
block_core = ">=0.15.0 <0.16.0"