docs: update version in readme and add entry in changelog for 1.0.0-pre.12

- debug and release targets now produce both shared and static libs
- obj dirs split into shared/ and static/ to keep fPIC objects isolated
- install no longer depends on release, guards with existence check instead
- build.sh handles privilege escalation for install/uninstall via doas or
  sudo, falling back gracefully if already root
- uninstall cleans up static lib alongside shared

CHANGELOG.md

@@ -7,6 +7,32 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.0.0-pre.12] - 2026-03-29
+
+### Fixed
+- `gmake.mk`: changed static library extension on Windows from `.lib` to `.a` for MinGW compatibility
+- `module_loader`: use `RTLD_GLOBAL` when loading modules to correctly expose host symbols to dynamic libraries
+
+## [1.0.0-pre.11] - 2026-03-15
+
+### Fixed
+- `gmake.mk`: `PREFIX` now defaults to `/usr` on Linux instead of `/usr/local`
+
+## [1.0.0-pre.10] - 2026-03-14
+
+### Fixed
+- `bmake.mk`: all target and object paths now anchored with `${.CURDIR}` to fix incorrect path nesting when building from outside the project root; substitution delimiters switched to `|` to avoid conflicts with path separators; compile rules now emit `-MT`/`-MF` for correct dependency file targeting; removed stale `.-include` directives for `.d` files; release lib rules now use `${.TARGET}` consistently
+- `gmake.mk`: removed `AR`/`ARFLAGS_STATIC` variables and the `ifeq`-guarded static lib rules; both debug and release static lib rules now use `ar rcs` directly, as MinGW ships `ar` and `lib.exe` was incorrect
+
+## [1.0.0-pre.9] - 2026-03-12
+
+### Changed
+- `debug` and `release` targets now produce both a shared and static library alongside each other
+- obj directories split into `shared/` and `static/` subdirs to keep `-fPIC` objects isolated
+- `install` no longer depends on `release`; guards with an existence check and exits with a clear message if artifacts are missing
+- `uninstall` removes static lib alongside shared lib
+- `build.sh`: `install` and `uninstall` now handle privilege escalation automatically via `doas` or `sudo`; skips escalation if already root
+
 ## [1.0.0-pre.8] - 2026-03-08
 
 ### Fixed
@@ -192,7 +218,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Dependency management and versioning not yet implemented
 - API is unstable and subject to change in future releases
 
-[Unreleased]: https://github.com/anth64/stk/compare/v1.0.0-pre.8...HEAD
+[Unreleased]: https://github.com/anth64/stk/compare/v1.0.0-pre.12...HEAD
+[1.0.0-pre.12]: https://github.com/anth64/stk/compare/v1.0.0-pre.11...v1.0.0-pre.12
+[1.0.0-pre.11]: https://github.com/anth64/stk/compare/v1.0.0-pre.10...v1.0.0-pre.11
+[1.0.0-pre.10]: https://github.com/anth64/stk/compare/v1.0.0-pre.9...v1.0.0-pre.10
+[1.0.0-pre.9]: https://github.com/anth64/stk/compare/v1.0.0-pre.8...v1.0.0-pre.9
 [1.0.0-pre.8]: https://github.com/anth64/stk/compare/v1.0.0-pre.7...v1.0.0-pre.8
 [1.0.0-pre.7]: https://github.com/anth64/stk/compare/v1.0.0-pre.6...v1.0.0-pre.7
 [1.0.0-pre.6]: https://github.com/anth64/stk/compare/v1.0.0-pre.5...v1.0.0-pre.6

README.md

@@ -43,19 +43,19 @@ build.bat debug release
 
 #### Unix (Linux/BSD/macOS)
 ```bash
-sudo ./build.sh install
+./build.sh install
 ```
 
-Installs to `/usr/local` by default. Use `PREFIX` to customize:
+Installs to `/usr` on Linux, `/usr/local` on BSD/macOS by default. Use `PREFIX` to customize:
 ```bash
-sudo ./build.sh PREFIX=$HOME/.local install
+./build.sh PREFIX=$HOME/.local install
 ```
 
 #### Windows
 ```
 build.bat release
 ```
-* Once finished building, copy the headers from `include/` to `your_project/include/stk/` and `bin/release/stk.dll` to your project's lib directory.
+* Once finished building, copy the headers from `include/` to `your_project/include/stk/` and copy `bin/release/stk.dll` or `bin/release/stk.lib` to your project's `lib` directory, depending on whether you are linking dynamically or statically.
 
 ---
 
@@ -234,7 +234,7 @@ stk_init();
 
 ## Project Status
 
-**Current Version:** 1.0.0-pre.8
+**Current Version:** 1.0.0-pre.12
 
 ### What Works
 - Cross-platform module loading and hot-reloading

bmake.mk

@@ -12,44 +12,59 @@ FULL_LIB     = lib${LIB_NAME}.dylib
 FULL_LIB     = lib${LIB_NAME}.so
 .endif
 
+STATIC_LIB   = lib${LIB_NAME}.a
+
 LDFLAGS_PLAT = -ldl
 CFLAGS_PLAT  = -fPIC
 CFLAGS_BASE  = -Wall -Wpedantic -I${.CURDIR}/${INC_DIR} -std=c89 ${CFLAGS_PLAT}
+CFLAGS_STATIC =
 
 .PHONY: all debug release clean test install uninstall
 
 all: debug
 
-OBJS_DEBUG   = ${SRCS:S/^src\//obj\/debug\//:S/.c$/.o/}
-OBJS_RELEASE = ${SRCS:S/^src\//obj\/release\//:S/.c$/.o/}
+OBJS_DEBUG_SHARED   = ${SRCS:S|^src/|${.CURDIR}/obj/debug/shared/|:S/.c$/.o/}
+OBJS_DEBUG_STATIC   = ${SRCS:S|^src/|${.CURDIR}/obj/debug/static/|:S/.c$/.o/}
+OBJS_RELEASE_SHARED = ${SRCS:S|^src/|${.CURDIR}/obj/release/shared/|:S/.c$/.o/}
+OBJS_RELEASE_STATIC = ${SRCS:S|^src/|${.CURDIR}/obj/release/static/|:S/.c$/.o/}
 
-debug: ${BIN_DIR}/debug/${FULL_LIB}
-release: ${BIN_DIR}/release/${FULL_LIB}
+debug: ${.CURDIR}/${BIN_DIR}/debug/${FULL_LIB} ${.CURDIR}/${BIN_DIR}/debug/${STATIC_LIB}
+release: ${.CURDIR}/${BIN_DIR}/release/${FULL_LIB} ${.CURDIR}/${BIN_DIR}/release/${STATIC_LIB}
 
-${BIN_DIR}/debug/${FULL_LIB}: ${OBJS_DEBUG}
+${.CURDIR}/${BIN_DIR}/debug/${FULL_LIB}: ${OBJS_DEBUG_SHARED}
 	@mkdir -p ${.TARGET:H}
 	${CC} -shared -o ${.TARGET} ${.ALLSRC} ${LDFLAGS_PLAT}
 
-${BIN_DIR}/release/${FULL_LIB}: ${OBJS_RELEASE}
-	@mkdir -p ${.CURDIR}/${BIN_DIR}/release
-	${CC} -shared -s -o ${.CURDIR}/${BIN_DIR}/release/${FULL_LIB} ${.ALLSRC} ${LDFLAGS_PLAT}
+${.CURDIR}/${BIN_DIR}/debug/${STATIC_LIB}: ${OBJS_DEBUG_STATIC}
+	@mkdir -p ${.TARGET:H}
+	ar rcs ${.TARGET} ${.ALLSRC}
 
+${.CURDIR}/${BIN_DIR}/release/${FULL_LIB}: ${OBJS_RELEASE_SHARED}
+	@mkdir -p ${.TARGET:H}
+	${CC} -shared -s -o ${.TARGET} ${.ALLSRC} ${LDFLAGS_PLAT}
+
+${.CURDIR}/${BIN_DIR}/release/${STATIC_LIB}: ${OBJS_RELEASE_STATIC}
+	@mkdir -p ${.TARGET:H}
+	ar rcs ${.TARGET} ${.ALLSRC}
 
 .for _src in ${SRCS}
-_obj_base = ${_src:S/^src\///:S/.c$/.o/}
-
-obj/debug/${_obj_base}: ${_src}
+${.CURDIR}/obj/debug/shared/${_src:S|^src/||:S/.c$/.o/}: ${.CURDIR}/${_src}
 	@mkdir -p ${.TARGET:H}
-	${CC} ${CFLAGS_BASE} -g -O0 -MMD -MP -c ${.ALLSRC} -o ${.TARGET}
+	${CC} ${CFLAGS_BASE} -g -O0 -MMD -MP -MT ${.TARGET} -MF ${.TARGET:S/.o$/.d/} -c ${.ALLSRC} -o ${.TARGET}
 
-obj/release/${_obj_base}: ${_src}
+${.CURDIR}/obj/debug/static/${_src:S|^src/||:S/.c$/.o/}: ${.CURDIR}/${_src}
 	@mkdir -p ${.TARGET:H}
-	${CC} ${CFLAGS_BASE} -O2 -MMD -MP -c ${.ALLSRC} -o ${.TARGET}
+	${CC} ${CFLAGS_BASE} ${CFLAGS_STATIC} -g -O0 -MMD -MP -MT ${.TARGET} -MF ${.TARGET:S/.o$/.d/} -c ${.ALLSRC} -o ${.TARGET}
+
+${.CURDIR}/obj/release/shared/${_src:S|^src/||:S/.c$/.o/}: ${.CURDIR}/${_src}
+	@mkdir -p ${.TARGET:H}
+	${CC} ${CFLAGS_BASE} -O2 -MMD -MP -MT ${.TARGET} -MF ${.TARGET:S/.o$/.d/} -c ${.ALLSRC} -o ${.TARGET}
+
+${.CURDIR}/obj/release/static/${_src:S|^src/||:S/.c$/.o/}: ${.CURDIR}/${_src}
+	@mkdir -p ${.TARGET:H}
+	${CC} ${CFLAGS_BASE} ${CFLAGS_STATIC} -O2 -MMD -MP -MT ${.TARGET} -MF ${.TARGET:S/.o$/.d/} -c ${.ALLSRC} -o ${.TARGET}
 .endfor
 
-.-include "obj/debug/*.d"
-.-include "obj/release/*.d"
-
 clean:
 	rm -rf ${.CURDIR}/${OBJ_DIR} ${.CURDIR}/${BIN_DIR}
 
@@ -57,13 +72,16 @@ test: debug
 	@echo "=== Building and running stk tests ==="
 	cd ${.CURDIR}/test && ${MAKE} -f bmake.mk
 
-install: release
+install:
+	@test -f ${.CURDIR}/${BIN_DIR}/release/${FULL_LIB} || { echo "Run 'make -f bmake.mk release' before installing."; exit 1; }
 	install -d ${LIBDIR} ${INCDIR}/stk
 	install -m 755 ${.CURDIR}/${BIN_DIR}/release/${FULL_LIB} ${LIBDIR}/
+	install -m 644 ${.CURDIR}/${BIN_DIR}/release/${STATIC_LIB} ${LIBDIR}/
 	install -m 644 ${.CURDIR}/${INC_DIR}/stk.h ${INCDIR}/stk/
 	install -m 644 ${.CURDIR}/${INC_DIR}/stk_version.h ${INCDIR}/stk/
 	install -m 644 ${.CURDIR}/${INC_DIR}/stk_log.h ${INCDIR}/stk/
 
 uninstall:
 	rm -f ${LIBDIR}/${FULL_LIB}
+	rm -f ${LIBDIR}/${STATIC_LIB}
 	rm -rf ${INCDIR}/stk

build.sh

@@ -8,4 +8,32 @@ else
 	MK_FILE="bmake.mk"
 fi
 
-make -f "$MK_FILE" "$@"
+HAS_INSTALL=0
+HAS_UNINSTALL=0
+for arg in "$@"; do
+	case "$arg" in
+		install)   HAS_INSTALL=1 ;;
+		uninstall) HAS_UNINSTALL=1 ;;
+	esac
+done
+
+if [ "$HAS_INSTALL" = "1" ] || [ "$HAS_UNINSTALL" = "1" ]; then
+	if [ "$HAS_INSTALL" = "1" ]; then
+		make -f "$MK_FILE" release
+	fi
+
+	if [ "$(id -u)" = "0" ]; then
+		PRIV=""
+	elif command -v doas > /dev/null 2>&1; then
+		PRIV="doas"
+	elif command -v sudo > /dev/null 2>&1; then
+		PRIV="sudo"
+	else
+		echo "error: install requires root. neither doas nor sudo found." >&2
+		exit 1
+	fi
+
+	$PRIV make -f "$MK_FILE" "$@"
+else
+	make -f "$MK_FILE" "$@"
+fi

config.mk

@@ -4,6 +4,7 @@ OBJ_DIR = obj
 BIN_DIR = bin
 
 LIB_NAME = stk
+STATIC_LIB = lib$(LIB_NAME).a
 
 SRCS = src/module.c \
        src/platform.c \

gmake.mk

@@ -3,14 +3,18 @@ include config.mk
 ifeq ($(OS),Windows_NT)
     SHELL := cmd.exe
     FULL_LIB := $(LIB_NAME).dll
+    STATIC_LIB := lib$(LIB_NAME).a
     LDFLAGS_PLAT :=
     CFLAGS_PLAT :=
+    CFLAGS_STATIC :=
     MKDIR = if not exist $(subst /,\,$(1)) mkdir $(subst /,\,$(1))
     RMDIR = if exist $(subst /,\,$(1)) rd /s /q $(subst /,\,$(1))
 else
     FULL_LIB := lib$(LIB_NAME).so
+    STATIC_LIB := lib$(LIB_NAME).a
     LDFLAGS_PLAT := -ldl
     CFLAGS_PLAT := -fPIC
+    CFLAGS_STATIC :=
     MKDIR = mkdir -p $(1)
     RMDIR = rm -rf $(1)
 endif
@@ -18,7 +22,7 @@ endif
 RELEASE_LDFLAGS := -s
 CFLAGS_BASE := -Wall -Wpedantic -I$(INC_DIR) -std=c89 $(CFLAGS_PLAT) 
 
-PREFIX ?= /usr/local
+PREFIX ?= /usr
 LIBDIR ?= $(PREFIX)/lib
 INCDIR ?= $(PREFIX)/include
 
@@ -26,29 +30,47 @@ INCDIR ?= $(PREFIX)/include
 
 all: debug
 
-debug: $(BIN_DIR)/debug/$(FULL_LIB) 
-release: $(BIN_DIR)/release/$(FULL_LIB) 
+debug: $(BIN_DIR)/debug/$(FULL_LIB) $(BIN_DIR)/debug/$(STATIC_LIB)
+release: $(BIN_DIR)/release/$(FULL_LIB) $(BIN_DIR)/release/$(STATIC_LIB)
 
 # Debug Rules
-$(BIN_DIR)/debug/$(FULL_LIB): $(SRCS:src/%.c=obj/debug/%.o) 
+$(BIN_DIR)/debug/$(FULL_LIB): $(SRCS:src/%.c=obj/debug/shared/%.o)
 	@$(call MKDIR,$(@D))
 	$(CC) -shared -o $@ $^ $(LDFLAGS_PLAT)
 
-obj/debug/%.o: src/%.c 
+$(BIN_DIR)/debug/$(STATIC_LIB): $(SRCS:src/%.c=obj/debug/static/%.o)
+	@$(call MKDIR,$(@D))
+	ar rcs $@ $^
+
+obj/debug/shared/%.o: src/%.c
 	@$(call MKDIR,$(@D))
 	$(CC) $(CFLAGS_BASE) -g -O0 -MMD -MP -c $< -o $@
 
+obj/debug/static/%.o: src/%.c
+	@$(call MKDIR,$(@D))
+	$(CC) $(CFLAGS_BASE) $(CFLAGS_STATIC) -g -O0 -MMD -MP -c $< -o $@
+
 # Release Rules
-$(BIN_DIR)/release/$(FULL_LIB): $(SRCS:src/%.c=obj/release/%.o) 
+$(BIN_DIR)/release/$(FULL_LIB): $(SRCS:src/%.c=obj/release/shared/%.o)
 	@$(call MKDIR,$(@D))
 	$(CC) -shared $(RELEASE_LDFLAGS) -o $@ $^ $(LDFLAGS_PLAT)
 
-obj/release/%.o: src/%.c 
+$(BIN_DIR)/release/$(STATIC_LIB): $(SRCS:src/%.c=obj/release/static/%.o)
+	@$(call MKDIR,$(@D))
+	ar rcs $@ $^
+
+obj/release/shared/%.o: src/%.c
 	@$(call MKDIR,$(@D))
 	$(CC) $(CFLAGS_BASE) -O2 -MMD -MP -c $< -o $@
 
--include $(wildcard obj/debug/*.d) 
--include $(wildcard obj/release/*.d) 
+obj/release/static/%.o: src/%.c
+	@$(call MKDIR,$(@D))
+	$(CC) $(CFLAGS_BASE) $(CFLAGS_STATIC) -O2 -MMD -MP -c $< -o $@
+
+-include $(wildcard obj/debug/shared/*.d)
+-include $(wildcard obj/debug/static/*.d)
+-include $(wildcard obj/release/shared/*.d)
+-include $(wildcard obj/release/static/*.d) 
 
 clean: 
 	@$(call RMDIR,$(OBJ_DIR))
@@ -58,23 +80,26 @@ test: debug
 	@echo "=== Building and running stk tests ==="
 	@$(MAKE) -C test -f gmake.mk
 
-# Installation (Unix only)
 ifneq ($(OS),Windows_NT)
-install: release
+install:
+	@test -f $(BIN_DIR)/release/$(FULL_LIB) || { echo "Run 'make -f gmake.mk release' before installing."; exit 1; }
 	install -d $(LIBDIR) $(INCDIR)/stk
 	install -m 755 $(BIN_DIR)/release/$(FULL_LIB) $(LIBDIR)/
+	install -m 644 $(BIN_DIR)/release/$(STATIC_LIB) $(LIBDIR)/
 	install -m 644 $(INC_DIR)/stk.h $(INCDIR)/stk/
 	install -m 644 $(INC_DIR)/stk_version.h $(INCDIR)/stk/
 	install -m 644 $(INC_DIR)/stk_log.h $(INCDIR)/stk/
 
 uninstall:
 	rm -f $(LIBDIR)/$(FULL_LIB)
+	rm -f $(LIBDIR)/$(STATIC_LIB)
 	rm -rf $(INCDIR)/stk
 else
 install:
 	@echo "make install is not supported on Windows."
 	@echo "Copy include/ directory contents to your_project/include/stk/"
 	@echo "Copy bin/release/stk.dll to your project's lib directory."
+	@echo "Copy bin/release/stk.lib to your project's lib directory."
 
 uninstall:
 	@echo "make uninstall is not supported on Windows."

src/platform.c

@@ -278,7 +278,7 @@ void *platform_load_library(const char *path)
 #ifdef _WIN32
 	return (void *)LoadLibraryA(path);
 #else
-	return dlopen(path, RTLD_NOW);
+	return dlopen(path, RTLD_NOW | RTLD_GLOBAL);
 #endif
 }