Makefile

CC = gcc
AS = nasm
LD = ld

BUILD_DIR ?= build
PDF_PYTHON ?= python3
SRC_DIR = src
APP_DIR ?= app
HIVE_REPO ?= HIVE

# 可拆分构建开关：
#   HBOS_ENABLE_GUI=0   不链接桌面、窗口管理器和 GUI 内置应用
#   HBOS_BUNDLE_APPS=0  不链接注册式应用，并生成空 HAX 清单
HBOS_ENABLE_GUI ?= 1
HBOS_BUNDLE_APPS ?= 1
NOGUI_BUILD_DIR ?= build-nogui

# ── 版本命名规则 ────────────────────────────────────────────────
#   完整版本号:  v<MAJOR>.<MINOR>-beta<BETA>-pre<PRE>   例: v0.1-beta4-pre4
#     · MAJOR 大版本 / MINOR 中版本 — 里程碑号（当前 0.1，目标大版本 1.0）
#     · BETA  每次对外更新 +1
#     · PRE   内部小版本号（迭代构建）
#     · HIVE_GUI_REV 当前 HBOS beta 发布线上的 GUI 修订号
#   src/version.h 由下面这些值自动生成（仅在变化时重写），请勿手改 version.h。
#   设版本有三种方式：
#     · `make ver`  交互式询问并写入 version.mk（推荐）
#     · `make ask`  先询问版本再完整构建
#     · 命令行覆盖  make HBOS_VER_BETA=5
#   普通 `make` 不询问，沿用 version.mk（或下面的默认值），便于脚本/IDE 构建。
#   ISO 文件名: hbos-{bios|uefi}-v<...>_<YYYYMMDD>.iso
-include version.mk
HBOS_VER_MAJOR ?= 0
HBOS_VER_MINOR ?= 1
HBOS_VER_BETA  ?= 4
HBOS_VER_PRE   ?= 4
HIVE_GUI_REV   ?= 4

# 派生的各种格式
HBOS_VERSION     = v$(HBOS_VER_MAJOR).$(HBOS_VER_MINOR)-beta$(HBOS_VER_BETA)-pre$(HBOS_VER_PRE)
HBOS_VERSION_REL = $(HBOS_VER_MAJOR).$(HBOS_VER_MINOR)-beta$(HBOS_VER_BETA)-pre$(HBOS_VER_PRE)
HBOS_VERSION_STR = $(HBOS_VER_MAJOR).$(HBOS_VER_MINOR) beta$(HBOS_VER_BETA) pre$(HBOS_VER_PRE)
HIVE_VERSION_REL = $(HBOS_VER_MAJOR).$(HBOS_VER_MINOR)-beta$(HBOS_VER_BETA)-gui.$(HIVE_GUI_REV)
HIVE_VERSION_TAG = HIVE $(HIVE_VERSION_REL)

# 默认目标仍为 all（下面的 version.h 规则在前，避免它抢占默认目标）
.DEFAULT_GOAL := all

# 交互式设置版本号 → version.mk（回车保留当前值）
.PHONY: ver ask apps
ver:
	@echo '── 设置 HBOS 构建版本号（直接回车保留当前值）──'; \
	 printf '  大版本 MAJOR [%s]: ' '$(HBOS_VER_MAJOR)'; read M; M=$${M:-$(HBOS_VER_MAJOR)}; \
	 printf '  中版本 MINOR [%s]: ' '$(HBOS_VER_MINOR)'; read N; N=$${N:-$(HBOS_VER_MINOR)}; \
	 printf '  beta  号  [%s]: ' '$(HBOS_VER_BETA)'; read B; B=$${B:-$(HBOS_VER_BETA)}; \
	 printf '  pre   号  [%s]: ' '$(HBOS_VER_PRE)'; read P; P=$${P:-$(HBOS_VER_PRE)}; \
	 printf '  GUI 修订号 [%s]: ' '$(HIVE_GUI_REV)'; read G; G=$${G:-$(HIVE_GUI_REV)}; \
	 printf 'HBOS_VER_MAJOR = %s\nHBOS_VER_MINOR = %s\nHBOS_VER_BETA = %s\nHBOS_VER_PRE = %s\nHIVE_GUI_REV = %s\n' \
	        "$$M" "$$N" "$$B" "$$P" "$$G" > version.mk; \
	 echo "✓ 已写入 version.mk:  v$$M.$$N-beta$$B-pre$$P / HIVE $$M.$$N-beta$$B-gui.$$G"

# 交互式选择要打包进镜像的 app/*.c（回车默认保留当前状态）。
# 选"不包含"时把源码移到 app/.disabled/（不是直接删除，可随时在下次
# make ask 时选择恢复）——效果和手动把 .c 从 app/ 删掉一样（genhax.py /
# HAX_APP_SRCS 都是 wildcard app/*.c，本来就不会看 app/.disabled/ 里的
# 东西），只是留了个反悔的余地。
apps:
	@mkdir -p app/.disabled; \
	 echo '── 选择要打包进镜像的 app（回车 = 保留当前状态）──'; \
	 for f in app/*.c; do \
	   [ -e "$$f" ] || continue; \
	   name=$$(basename "$$f" .c); \
	   printf '  包含 %-12s [Y/n]: ' "$$name"; read a; \
	   if [ "$$a" = "n" ] || [ "$$a" = "N" ]; then \
	     mv "$$f" "app/.disabled/$$name.c"; \
	     echo "    → 已移到 app/.disabled/（下次 make ask 可以选择恢复）"; \
	   fi; \
	 done; \
	 if ls app/.disabled/*.c >/dev/null 2>&1; then \
	   echo '── 已禁用的 app（回车 = 继续保持禁用）──'; \
	   for f in app/.disabled/*.c; do \
	     [ -e "$$f" ] || continue; \
	     name=$$(basename "$$f" .c); \
	     printf '  恢复 %-12s [y/N]: ' "$$name"; read a; \
	     if [ "$$a" = "y" ] || [ "$$a" = "Y" ]; then \
	       mv "$$f" "app/$$name.c"; \
	       echo "    → 已恢复到 app/"; \
	     fi; \
	   done; \
	 fi

# 先询问版本 + 要打包的 app，再完整构建（GUI + no-GUI 都打包）
ask: ver apps
	@$(MAKE) --no-print-directory all
	@$(MAKE) --no-print-directory nogui

# version.mk 缺失时不报错（占位规则）
version.mk: ;

# 由上面的版本变量自动生成 src/version.h（内容不变则不重写，避免无谓重编译）
.PHONY: version
version: $(SRC_DIR)/version.h
$(SRC_DIR)/version.h: Makefile version.mk
	@printf '%s\n' \
	  '#ifndef HBOS_VERSION_H' \
	  '#define HBOS_VERSION_H' \
	  '' \
	  '/* 本文件由 Makefile 的版本变量自动生成，请勿手改；改版本请编辑 Makefile。 */' \
	  '#define HBOS_VERSION     "$(HBOS_VERSION_STR)"' \
	  '#define HBOS_VERSION_REL "$(HBOS_VERSION_REL)"' \
	  '#define HBOS_VERSION_TAG "$(HBOS_VERSION)"' \
	  '#define HBOS_VERSION_NAME "HBOS - He Bit OS " HBOS_VERSION' \
	  '#define HIVE_VERSION_REL "$(HIVE_VERSION_REL)"' \
	  '#define HIVE_VERSION_TAG "$(HIVE_VERSION_TAG)"' \
	  '' \
	  '#endif /* HBOS_VERSION_H */' > $@.tmp
	@if cmp -s $@.tmp $@ 2>/dev/null; then rm -f $@.tmp; \
	 else mv $@.tmp $@; echo "✓ version.h → $(HBOS_VERSION)"; fi

# 引用 version.h 的目标显式依赖它，使版本变化时重新编译
$(BUILD_DIR)/kernel.o: $(SRC_DIR)/version.h
$(BUILD_DIR)/syscall.o: $(SRC_DIR)/version.h
$(BUILD_DIR)/tools/system.o: $(SRC_DIR)/version.h
$(BUILD_DIR)/shell/shell.o: $(SRC_DIR)/version.h
$(BUILD_DIR)/tools/gui.o: $(SRC_DIR)/version.h
$(BUILD_DIR)/gui/apps/app_settings.o: $(SRC_DIR)/version.h

KERNEL_BIOS = $(BUILD_DIR)/hbos-bios.bin
ISO_BIOS = $(BUILD_DIR)/hbos-bios.iso
ISO_UEFI = $(BUILD_DIR)/hbos-uefi.iso
UEFI_IMG = $(BUILD_DIR)/hbos_uefi.img
DISK_IMG = $(BUILD_DIR)/hbos_disk.img
INSTALL_IMG = $(BUILD_DIR)/hbos_installed.img
INSTALL_IMG_BIOS = $(BUILD_DIR)/hbos_installed_bios.img
INSTALL_IMG_UEFI = $(BUILD_DIR)/hbos_installed_uefi.img
VMWARE_BIOS_VMDK = $(BUILD_DIR)/hbos_vmware_bios.vmdk
VMWARE_UEFI_VMDK = $(BUILD_DIR)/hbos_vmware_uefi.vmdk
VBOX_BIOS_VDI = $(BUILD_DIR)/hbos_virtualbox_bios.vdi
VBOX_UEFI_VDI = $(BUILD_DIR)/hbos_virtualbox_uefi.vdi
LIMINE_EFI = limine-bin/bin/BOOTX64.EFI
UEFI_CD_IMG = $(BUILD_DIR)/limine_uefi_cd.img
OVMF_CODE ?= /usr/share/OVMF/OVMF_CODE_4M.fd
OVMF_VARS ?= /usr/share/OVMF/OVMF_VARS_4M.fd
QEMU_IMG ?= qemu-img

CFLAGS = -m64 -ffreestanding -fno-stack-protector -fno-pic -fno-pie \
         -mcmodel=kernel -mno-red-zone -mno-80387 -mno-mmx -mno-sse -mno-sse2 \
         -O2 -Wall -Wextra -MMD -MP \
         -I$(SRC_DIR) -I$(SRC_DIR)/graphics -I$(SRC_DIR)/shell -I$(SRC_DIR)/core -I$(SRC_DIR)/tools -I$(SRC_DIR)/gui -I$(SRC_DIR)/user \
         -DHBOS_ENABLE_GUI=$(HBOS_ENABLE_GUI) -DHBOS_BUNDLE_APPS=$(HBOS_BUNDLE_APPS)

ASFLAGS = -f elf64 -DHBOS_BUILD_DIR='"$(BUILD_DIR)"'
LDFLAGS_BIOS = -m elf_x86_64 -static -Bsymbolic -nostdlib -T linker_bios.ld

QEMU = /usr/bin/qemu-system-x86_64
QEMU_ENV = env -u SNAP -u SNAP_NAME -u SNAP_REVISION -u SNAP_ARCH -u SNAP_INSTANCE_NAME \
           -u SNAP_COMMON -u SNAP_DATA -u SNAP_USER_COMMON -u SNAP_USER_DATA \
           -u SNAP_LIBRARY_PATH -u GTK_PATH -u GTK_EXE_PREFIX -u GIO_MODULE_DIR \
           -u GTK_IM_MODULE_FILE -u LOCPATH -u LD_LIBRARY_PATH -u LD_PRELOAD

# 字体文件
FONT_TTF = fonts/ZhengGeDianHei-16.ttf
FONT_BIN = $(BUILD_DIR)/font_cjk.bin
# GUI proportional anti-aliased font (HarmonyOS Sans SC). Swap GUI_FONT_TTF to
# change the GUI typeface; glyph coverage is decided by tools/genfont.py.
GUI_FONT_TTF = fonts/HarmonyOS_Sans_SC_Regular.ttf
GUI_FONT_BIN = $(BUILD_DIR)/gui_font.bin
# Desktop wallpaper. Swap GUI_WALL_IMG to change it; genwall.py decodes/resizes.
GUI_WALL_IMG = photo/wallpaper.jpg
GUI_WALL_BIN = $(BUILD_DIR)/gui_wall.bin
# Flat anti-aliased GUI icons. Designs live in tools/genicon.py.
GUI_ICON_BIN = $(BUILD_DIR)/gui_icons.bin

# 注册式内建应用与 .hax 应用使用同一总开关。关闭时内核仍保留应用加载 ABI，
# 但不反向依赖任何具体应用实现。
ifeq ($(HBOS_BUNDLE_APPS),1)
APP_SRCS = $(wildcard $(SRC_DIR)/apps/*.c)
else
APP_SRCS =
endif

C_SRCS = \
	$(SRC_DIR)/kernel.c \
	$(SRC_DIR)/selftest.c \
	$(SRC_DIR)/acpi.c \
	$(SRC_DIR)/syscall.c \
	$(SRC_DIR)/linux_compat.c \
	$(SRC_DIR)/elf.c \
	$(SRC_DIR)/devfs.c \
	$(SRC_DIR)/rtc.c \
	$(SRC_DIR)/ipc.c \
	$(SRC_DIR)/pci.c \
	$(SRC_DIR)/net.c \
	$(SRC_DIR)/tls.c \
	$(SRC_DIR)/block.c \
	$(SRC_DIR)/ahci.c \
	$(SRC_DIR)/fs.c \
	$(SRC_DIR)/vfs.c \
	$(SRC_DIR)/ata.c \
	$(SRC_DIR)/fb.c \
	$(SRC_DIR)/flanterm.c \
	$(SRC_DIR)/xhci.c \
	$(SRC_DIR)/usb_hid.c \
	$(SRC_DIR)/usb_msc.c \
	$(SRC_DIR)/smp.c \
	$(SRC_DIR)/ext2.c \
	$(SRC_DIR)/fat32.c \
	$(SRC_DIR)/bmp.c \
	$(SRC_DIR)/inflate.c \
	$(SRC_DIR)/png.c \
	$(SRC_DIR)/jpeg.c \
	$(SRC_DIR)/wav.c \
	$(SRC_DIR)/ac97.c \
	$(SRC_DIR)/tty.c \
	$(SRC_DIR)/graphics/graphics.c \
	$(SRC_DIR)/graphics/font_cjk.c \
	$(SRC_DIR)/input/mouse.c \
	$(SRC_DIR)/shell/shell.c \
	$(SRC_DIR)/core/task.c \
	$(SRC_DIR)/lib/posix.c \
	$(SRC_DIR)/lib/string.c \
	$(SRC_DIR)/crypto/sha256.c \
	$(SRC_DIR)/crypto/x25519.c \
	$(SRC_DIR)/crypto/p256.c \
	$(SRC_DIR)/crypto/chacha20_poly1305.c \
	$(SRC_DIR)/crypto/aes_gcm.c \
	$(SRC_DIR)/user/app_runtime.c \
	$(SRC_DIR)/user/syscall.c \
	$(SRC_DIR)/user/ldso.c \
	$(SRC_DIR)/user/hax.c \
	$(SRC_DIR)/tools/help.c \
	$(SRC_DIR)/tools/system.c \
	$(SRC_DIR)/tools/debug.c \
	$(SRC_DIR)/tools/history.c \
	$(SRC_DIR)/tools/file.c \
	$(SRC_DIR)/tools/app.c \
	$(SRC_DIR)/tools/ata.c \
	$(SRC_DIR)/tools/disk.c \
	$(SRC_DIR)/tools/net.c \
	$(SRC_DIR)/tools/editor.c \
	$(SRC_DIR)/tools/cc.c \
	$(SRC_DIR)/tools/cppe.c \
	$(SRC_DIR)/tools/tcc_runtime_seed.c \
	$(SRC_DIR)/tools/hpt_repo_seed.c \
	$(SRC_DIR)/tools/web_vendor_seed.c \
	$(SRC_DIR)/tools/audio.c \
	$(SRC_DIR)/rtc_tz.c \
	$(APP_SRCS)

GUI_C_SRCS = \
	$(SRC_DIR)/gpu.c \
	$(SRC_DIR)/graphics/gui_font.c \
	$(SRC_DIR)/graphics/gui_wall.c \
	$(SRC_DIR)/graphics/gui_icons.c \
	$(SRC_DIR)/tools/gui.c \
	$(SRC_DIR)/gui/service.c \
	$(SRC_DIR)/gui/wm.c \
	$(SRC_DIR)/gui/winsrv.c \
	$(SRC_DIR)/gui/compositor.c \
	$(SRC_DIR)/gui/effects.c \
	$(SRC_DIR)/gui/gui_dirty.c \
	$(SRC_DIR)/gui/browser_backend.c \
	$(SRC_DIR)/gui/gui_apps.c \
	$(SRC_DIR)/gui/apps/app_calc.c \
	$(SRC_DIR)/gui/apps/app_clock.c \
	$(SRC_DIR)/gui/apps/app_settings.c \
	$(SRC_DIR)/gui/apps/app_files.c \
	$(SRC_DIR)/gui/apps/app_taskmgr.c \
	$(SRC_DIR)/gui/apps/app_shortcuts.c \
	$(SRC_DIR)/gui/apps/app_imgview.c \
	$(SRC_DIR)/gui/apps/app_hexview.c

ifeq ($(HBOS_ENABLE_GUI),1)
C_SRCS += $(GUI_C_SRCS)
else
C_SRCS += $(SRC_DIR)/gui/nogui.c
endif

C_OBJS = $(C_SRCS:$(SRC_DIR)/%.c=$(BUILD_DIR)/%.o)

# 所有汇编源文件
C_SRCS += \
	$(SRC_DIR)/core/gdt_idt.c \
	$(SRC_DIR)/core/pmm.c \
	$(SRC_DIR)/core/vmm.c \
	$(SRC_DIR)/core/heap.c

ASM_SRCS = \
	$(SRC_DIR)/boot.asm \
	$(SRC_DIR)/core/task_switch.asm \
	$(SRC_DIR)/core/interrupt_asm.asm \
	$(SRC_DIR)/graphics/cjk_glyph.asm \
	$(SRC_DIR)/user/tcc_runtime_blob.asm \
	$(SRC_DIR)/user/tcc_headers_blob.asm \
	$(SRC_DIR)/user/hpt_repo_blob.asm \
	$(SRC_DIR)/user/web_vendor_blob.asm \
	$(SRC_DIR)/smp_trampoline.asm

ifeq ($(HBOS_ENABLE_GUI),1)
ASM_SRCS += \
	$(SRC_DIR)/graphics/gui_glyph.asm \
	$(SRC_DIR)/graphics/gui_wallimg.asm \
	$(SRC_DIR)/graphics/gui_iconsimg.asm
endif

ASM_OBJS = $(ASM_SRCS:$(SRC_DIR)/%.asm=$(BUILD_DIR)/%.o)

# ── HAX 应用：多结构模式自动编译并打包进内核 ─────────────────────────
# “只要 app 里有编译产物，就加入系统”：扫描 $(APP_DIR) 下的三类结构，
# 由 genhax.py 读取各自 .hax 的 .haxmeta 段，生成清单与二进制 blob 嵌入内核。
#   1. $(APP_DIR)/<name>.c          单文件应用（原有方式，向后兼容）
#   2. $(APP_DIR)/<name>/           多文件应用：目录内全部 *.c 编译后链接
#                                   为一个 build/app/<name>.hax
#   3. $(APP_DIR)/lib/<lib>/        独立库：编译一次为 build/app/lib/<lib>.o，
#                                   可被多个应用共享
# 库依赖声明（应用按需链接，避免把所有库塞进每个应用）：
#   - 单文件应用 app/<name>.c    → 同名 app/<name>.deps，每行一个库名
#   - 多文件应用 app/<name>/     → app/<name>/deps，每行一个库名
#   - 库之间的依赖               → app/lib/<lib>/deps，每行一个库名
#   （# 开头为注释；库头文件放在 app/lib/<lib>/ 下，按 <lib/xxx.h> 引入，
#     include 路径已自动加上 $(APP_DIR)/lib）
HBOS_COMPAT_SMOKE ?= 0
HBOS_MUSL_SYSROOT ?=
HBOS_GLIBC_LIBDIR ?=
ifeq ($(HBOS_BUNDLE_APPS),1)
HAX_APP_SRCS = $(wildcard $(APP_DIR)/*.c)
HAX_APP_BINS = $(HAX_APP_SRCS:$(APP_DIR)/%.c=$(BUILD_DIR)/app/%.hax)
HAX_PREBUILT = $(wildcard $(APP_DIR)/*.hax)
# 多文件应用：$(APP_DIR) 下除 lib/include 外、含 *.c 的子目录（名字 = 目录名）
HAX_APP_DIR_NAMES := $(foreach d,$(filter-out lib include,$(notdir $(patsubst %/,%,$(wildcard $(APP_DIR)/*/)))),$(if $(wildcard $(APP_DIR)/$(d)/*.c),$(d)))
# 独立库：$(APP_DIR)/lib 下含 *.c 的子目录
HAX_LIB_NAMES := $(foreach l,$(notdir $(patsubst %/,%,$(wildcard $(APP_DIR)/lib/*/))),$(if $(wildcard $(APP_DIR)/lib/$(l)/*.c),$(l)))
# 名称冲突检查：同一名字不能既单文件又目录
HAX_CONFLICT_NAMES = $(filter $(HAX_APP_DIR_NAMES),$(patsubst $(APP_DIR)/%.c,%,$(HAX_APP_SRCS)))
ifneq ($(strip $(HAX_CONFLICT_NAMES)),)
$(error HAX 应用名冲突（同时存在单文件与同名目录）：$(HAX_CONFLICT_NAMES))
endif
HAX_DIR_APP_BINS = $(HAX_APP_DIR_NAMES:%=$(BUILD_DIR)/app/%.hax)
HAX_ALL_BINS = $(HAX_APP_BINS) $(HAX_DIR_APP_BINS) $(HAX_PREBUILT) $(BUILD_DIR)/app/tcc.hax \
	$(BUILD_DIR)/app/js.hax $(BUSYBOX_HAX)
ifeq ($(HBOS_COMPAT_SMOKE),1)
HAX_ALL_BINS += $(BUILD_DIR)/tests/linux_compat_thread.hax \
	$(BUILD_DIR)/tests/linux_clone3.hax \
	$(BUILD_DIR)/tests/linux_inotify.hax \
	$(BUILD_DIR)/tests/linux_syscall.hax \
	$(BUILD_DIR)/tests/linux_pie.hax \
	$(BUILD_DIR)/tests/linux_dynamic.hax \
	$(BUILD_DIR)/tests/linux_interp.hax \
	$(BUILD_DIR)/tests/linux_abi.hax \
	$(BUILD_DIR)/tests/linux_signal.hax \
	$(BUILD_DIR)/tests/linux_signal_siginfo.hax \
	$(BUILD_DIR)/tests/linux_mprotect.hax \
	$(BUILD_DIR)/tests/linux_mmap_reclaim.hax \
	$(BUILD_DIR)/tests/linux_file_mmap.hax \
	$(BUILD_DIR)/tests/linux_process_abi.hax \
	$(BUILD_DIR)/tests/linux_dlopen.hax \
	$(BUILD_DIR)/tests/linux_dlopen_lib.hax \
	$(BUILD_DIR)/tests/linux_dlopen_deps.hax \
	$(BUILD_DIR)/tests/linux_dlopen_dep_root.hax \
	$(BUILD_DIR)/tests/linux_dlopen_dep_leaf.hax \
	$(BUILD_DIR)/tests/linux_epoll_et.hax
ifneq ($(strip $(HBOS_MUSL_SYSROOT)),)
HAX_ALL_BINS += $(BUILD_DIR)/tests/linux_musl.hax \
	$(BUILD_DIR)/tests/linux_musl_pthread.hax \
	$(BUILD_DIR)/tests/linux_musl_loader.hax \
	$(BUILD_DIR)/tests/linux_musl_stream.hax
endif
ifneq ($(strip $(HBOS_GLIBC_LIBDIR)),)
HAX_ALL_BINS += $(BUILD_DIR)/tests/linux_glibc.hax \
	$(BUILD_DIR)/tests/linux_glibc_loader.hax \
	$(BUILD_DIR)/tests/linux_glibc_libc.hax
endif
endif
else
HAX_APP_SRCS =
HAX_APP_BINS =
HAX_PREBUILT =
HAX_ALL_BINS =
endif
HAX_BLOB     = $(BUILD_DIR)/hax_blob.bin
HAX_MANIFEST = $(BUILD_DIR)/hax_manifest.c
HAX_MODE_STAMP = $(BUILD_DIR)/.hax-mode-$(HBOS_COMPAT_SMOKE)-$(if $(strip $(HBOS_MUSL_SYSROOT)),musl,nomusl)-$(if $(strip $(HBOS_GLIBC_LIBDIR)),glibc,noglibc)
HAX_OBJS     = $(BUILD_DIR)/hax_manifest.o $(BUILD_DIR)/user/hax_blob.o

include mk/secure_net.mk

ALL_OBJS = $(C_OBJS) $(ASM_OBJS) $(HAX_OBJS) $(SECURE_NET_OBJS)

.PHONY: all clean run vm run-bios run-iso run-bios-nodisk run-bios-disk run-bios-ahci install-img vmware-bios vmware-uefi vbox-bios vbox-uefi release smoke xhci-smoke chromium-baseline browser-test hive-test hive-sync linux-compat-lib nogui nogui-bios nogui-uefi nogui-smoke run-nogui run-nogui-bios run-nogui-uefi core-only run-hdd run-hdd-bios run-hdd-uefi iso bios-iso uefi uefi-iso uefi-img disk-img run-uefi run-iso-uefi run-uefi-nodisk run-uefi-headless run-uefi-disk run-uefi-ahci run-uefi-img limine-uefi help font user-progs user-progs-clean linux-compat-smoke

all: iso

help:
	@echo "HBOS common targets:"
	@echo "  make            Build BIOS and UEFI ISOs"
	@echo "  make run        Boot BIOS hard disk image in QEMU"
	@echo "  make run-uefi   Boot UEFI hard disk image in QEMU"
	@echo "  make release    Build ISOs plus VMware/VirtualBox disk images"
	@echo "  make smoke      Build release and boot-test BIOS/UEFI ISO/HDD/VMDK"
	@echo "  make xhci-smoke Boot-test xHCI keyboard and mouse enumeration"
	@echo "  make chromium-baseline  Check module/API compatibility baseline"
	@echo "  make browser-test  Run browser backend capability-gate tests"
	@echo "  make hive-test  Run HIVE widget event/layout unit tests"
	@echo "  make hive-sync  Export the transitional runtime/SDK mirror to HIVE_REPO"
	@echo "  make linux-compat-lib  Build opt-in Linux source compatibility library"
	@echo "  make nogui      Build BIOS/UEFI without desktop GUI or bundled apps"
	@echo "  make run-nogui  Build and boot the no-GUI BIOS ISO in QEMU"
	@echo "  make run-nogui-uefi  Build and boot the no-GUI UEFI ISO in QEMU"
	@echo "  make nogui-smoke  Boot-test no-GUI BIOS and UEFI ISOs"
	@echo "  make core-only  Build HIVE-capable core without registered/HAX apps"
	@echo "  make clean      Clean build files"
	@echo ""
	@echo "Individual artifacts:"
	@echo "  make bios-iso       Build build/hbos-bios.iso"
	@echo "  make uefi-iso       Build build/hbos-uefi.iso"
	@echo "  make install-img    Build BIOS/UEFI bootable hard disk images"
	@echo "  make vmware-bios    Build VMware BIOS VMDK"
	@echo "  make vmware-uefi    Build VMware UEFI VMDK"
	@echo "  make vbox-bios      Build VirtualBox BIOS VDI"
	@echo "  make vbox-uefi      Build VirtualBox UEFI VDI"
	@echo "  make disk-img       Build blank HBFS data disk"
	@echo ""
	@echo "Debug boot targets:"
	@echo "  make run-iso        Boot BIOS ISO with persistent AHCI data disk"
	@echo "  make run-iso-uefi   Boot UEFI ISO with persistent AHCI data disk"
	@echo "  make run-bios-nodisk"
	@echo "  make run-uefi-nodisk"
	@echo "  make run-uefi-headless"

$(BUILD_DIR):
	mkdir -p $(BUILD_DIR) $(BUILD_DIR)/graphics $(BUILD_DIR)/input $(BUILD_DIR)/shell $(BUILD_DIR)/core $(BUILD_DIR)/tools $(BUILD_DIR)/lib $(BUILD_DIR)/user $(BUILD_DIR)/apps $(BUILD_DIR)/gui $(BUILD_DIR)/crypto

# Font generation
font: $(FONT_BIN) $(GUI_FONT_BIN) $(GUI_WALL_BIN) $(GUI_ICON_BIN)

$(FONT_BIN): $(FONT_TTF) tools/genhzk.py
	@echo "[MAKE] Generating CJK font bitmap..."
	python3 tools/genhzk.py $(FONT_TTF) $(FONT_BIN)
	@echo "[MAKE] CJK font: $(FONT_BIN)"

$(GUI_FONT_BIN): $(GUI_FONT_TTF) tools/genfont.py
	@echo "[MAKE] Generating GUI proportional font atlas..."
	python3 tools/genfont.py $(GUI_FONT_TTF) $(GUI_FONT_BIN)
	@echo "[MAKE] GUI font: $(GUI_FONT_BIN)"

$(GUI_WALL_BIN): $(GUI_WALL_IMG) tools/genwall.py
	@echo "[MAKE] Generating desktop wallpaper..."
	python3 tools/genwall.py "$(GUI_WALL_IMG)" $(GUI_WALL_BIN)
	@echo "[MAKE] Wallpaper: $(GUI_WALL_BIN)"

$(GUI_ICON_BIN): tools/genicon.py
	@echo "[MAKE] Generating flat GUI icons..."
	python3 tools/genicon.py $(GUI_ICON_BIN)
	@echo "[MAKE] Icons: $(GUI_ICON_BIN)"

# NASM (.asm) — various directories
$(BUILD_DIR)/boot.o: $(SRC_DIR)/boot.asm | $(BUILD_DIR)
	@mkdir -p $(@D)
	$(AS) $(ASFLAGS) $< -o $@

$(BUILD_DIR)/smp_trampoline.o: $(SRC_DIR)/smp_trampoline.asm | $(BUILD_DIR)
	@mkdir -p $(@D)
	$(AS) $(ASFLAGS) $< -o $@

$(BUILD_DIR)/core/%.o: $(SRC_DIR)/core/%.asm | $(BUILD_DIR)
	@mkdir -p $(@D)
	$(AS) $(ASFLAGS) $< -o $@

$(BUILD_DIR)/graphics/%.o: $(SRC_DIR)/graphics/%.asm | $(BUILD_DIR)
	@mkdir -p $(@D)
	$(AS) $(ASFLAGS) $< -o $@

# The incbin objects must REASSEMBLE when their embedded blob changes — a normal
# (not order-only) prerequisite, otherwise a regenerated blob is silently stale.
$(BUILD_DIR)/graphics/cjk_glyph.o: $(FONT_BIN)
$(BUILD_DIR)/graphics/gui_glyph.o: $(GUI_FONT_BIN)
$(BUILD_DIR)/graphics/gui_wallimg.o: $(GUI_WALL_BIN)
$(BUILD_DIR)/graphics/gui_iconsimg.o: $(GUI_ICON_BIN)

$(BUILD_DIR)/user/tcc_runtime_blob.o: $(SRC_DIR)/user/tcc_runtime_blob.asm $(BUILD_DIR)/tcc/hbos_runtime.o | $(BUILD_DIR)
	@mkdir -p $(@D)
	$(AS) $(ASFLAGS) $< -o $@

# TCC sysinclude header bundle (tools/genheaders.py, seeded into ramfs at
# boot by src/tools/tcc_runtime_seed.c) — lets `#include <stdio.h>` etc.
# resolve in TCC-compiled user programs; see src/user/tcc_headers_blob.asm.
$(BUILD_DIR)/tcc/headers.bin: tools/genheaders.py $(wildcard $(SRC_DIR)/user/libc/*.h) $(wildcard $(SRC_DIR)/user/libc/sys/*.h) $(wildcard $(TCC_DIR)/include/*.h) | $(BUILD_DIR)
	@mkdir -p $(@D)
	python3 tools/genheaders.py $(SRC_DIR)/user/libc $(TCC_DIR)/include $@

$(BUILD_DIR)/user/tcc_headers_blob.o: $(SRC_DIR)/user/tcc_headers_blob.asm $(BUILD_DIR)/tcc/headers.bin | $(BUILD_DIR)
	@mkdir -p $(@D)
	$(AS) $(ASFLAGS) $< -o $@

# ── 内置 HPT 软件仓库 ─────────────────────────────────────────────────
# 把打包在镜像里的 HAX 应用生成一份 HPT 仓库（Packages + pool/），打成 blob
# 经 hpt_repo_blob.asm incbin 嵌入内核，开机由 src/tools/hpt_repo_seed.c
# 解包到 ramfs /packages，让 `run hpt list/install/remove` 开箱可用。
HPT_REPO_DIR       = $(BUILD_DIR)/hpt-repo
HPT_REPO_PACKAGES  = $(HPT_REPO_DIR)/Packages
HPT_REPO_BIN       = $(BUILD_DIR)/hpt-repo.bin

$(BUILD_DIR)/hpt-repo:
	mkdir -p $@

$(HPT_REPO_PACKAGES): tools/genhpt_repo.py $(HAX_ALL_BINS) | $(BUILD_DIR)/hpt-repo
	rm -f $(HPT_REPO_DIR)/*.hax
	python3 tools/genhpt_repo.py $(BUILD_DIR)/app $(HPT_REPO_DIR)

$(HPT_REPO_BIN): tools/genhptblob.py $(HPT_REPO_PACKAGES)
	python3 tools/genhptblob.py $(HPT_REPO_DIR) $@

$(BUILD_DIR)/user/hpt_repo_blob.o: $(SRC_DIR)/user/hpt_repo_blob.asm $(HPT_REPO_BIN) | $(BUILD_DIR)
	@mkdir -p $(@D)
	$(AS) $(ASFLAGS) $< -o $@

# ── 内置 web vendor 包（Vue 运行时等）───────────────────────────────
# third_party/web-vendor/ 里的文件打成 blob 经 web_vendor_blob.asm incbin 嵌入
# 内核，开机由 src/tools/web_vendor_seed.c 解包到 ramfs /system，让浏览器管线
# 不依赖网络也能拿到 Vue 2 window.Vue（外链 Vue 抓取失败时兜底）。
WEB_VENDOR_BIN = $(BUILD_DIR)/web-vendor.bin

$(WEB_VENDOR_BIN): tools/genwebblob.py $(wildcard third_party/web-vendor/*)
	python3 tools/genwebblob.py third_party/web-vendor $@

$(BUILD_DIR)/user/web_vendor_blob.o: $(SRC_DIR)/user/web_vendor_blob.asm $(WEB_VENDOR_BIN) | $(BUILD_DIR)
	@mkdir -p $(@D)
	$(AS) $(ASFLAGS) $< -o $@

# C rules — one generic rule for all subdirectories
$(BUILD_DIR)/%.o: $(SRC_DIR)/%.c | $(BUILD_DIR)
	@mkdir -p $(@D)
	$(CC) -c $(CFLAGS) $< -o $@

$(BUILD_DIR)/graphics/%.o: $(SRC_DIR)/graphics/%.c | $(BUILD_DIR) $(FONT_BIN)
	@mkdir -p $(@D)
	$(CC) -c $(CFLAGS) $< -o $@

$(BUILD_DIR)/shell/%.o: $(SRC_DIR)/shell/%.c | $(BUILD_DIR)
	@mkdir -p $(@D)
	$(CC) -c $(CFLAGS) $< -o $@

$(BUILD_DIR)/input/%.o: $(SRC_DIR)/input/%.c | $(BUILD_DIR)
	@mkdir -p $(@D)
	$(CC) -c $(CFLAGS) $< -o $@

$(BUILD_DIR)/gui/%.o: $(SRC_DIR)/gui/%.c | $(BUILD_DIR)
	@mkdir -p $(@D)
	$(CC) -c $(CFLAGS) $< -o $@

$(BUILD_DIR)/core/%.o: $(SRC_DIR)/core/%.c | $(BUILD_DIR)
	@mkdir -p $(@D)
	$(CC) -c $(CFLAGS) $< -o $@

$(BUILD_DIR)/tools/%.o: $(SRC_DIR)/tools/%.c | $(BUILD_DIR)
	@mkdir -p $(@D)
	$(CC) -c $(CFLAGS) $< -o $@

$(BUILD_DIR)/lib/%.o: $(SRC_DIR)/lib/%.c | $(BUILD_DIR)
	@mkdir -p $(@D)
	$(CC) -c $(CFLAGS) $< -o $@

$(BUILD_DIR)/user/%.o: $(SRC_DIR)/user/%.c | $(BUILD_DIR)
	@mkdir -p $(@D)
	$(CC) -c $(CFLAGS) $< -o $@

$(BUILD_DIR)/apps/%.o: $(SRC_DIR)/apps/%.c | $(BUILD_DIR)
	@mkdir -p $(@D)
	$(CC) -c $(CFLAGS) $< -o $@

# Link
$(KERNEL_BIOS): $(ALL_OBJS) linker_bios.ld
	$(LD) $(LDFLAGS_BIOS) $(filter-out linker_bios.ld,$^) -o $@
	@echo "✓ BIOS kernel: $@"

$(ISO_BIOS): $(KERNEL_BIOS)
	@rm -rf $(BUILD_DIR)/isodir-bios
	@mkdir -p $(BUILD_DIR)/isodir-bios/boot/grub
	@cp $(KERNEL_BIOS) $(BUILD_DIR)/isodir-bios/boot/hbos.bin
	@printf 'set timeout=5\nset default=0\ninsmod all_video\ninsmod gfxterm\nset gfxmode=1920x1080x32,1680x1050x32,1600x900x32,1440x900x32,1366x768x32,1280x800x32,1024x768x32,auto\n' > $(BUILD_DIR)/isodir-bios/boot/grub/grub.cfg
	@printf 'menuentry "HBOS $(HBOS_VERSION) (graphics auto)" {\n  terminal_output gfxterm\n  set gfxpayload=keep\n  multiboot2 /boot/hbos.bin\n}\n' >> $(BUILD_DIR)/isodir-bios/boot/grub/grub.cfg
	@printf 'menuentry "HBOS $(HBOS_VERSION) (text fallback)" {\n  terminal_output console\n  set gfxpayload=text\n  multiboot2 /boot/hbos.bin\n}\n' >> $(BUILD_DIR)/isodir-bios/boot/grub/grub.cfg
	@grub-mkrescue -o $@ $(BUILD_DIR)/isodir-bios
	@cp $@ "$(BUILD_DIR)/hbos-bios-$(HBOS_VERSION)_$(shell date +%Y%m%d).iso"
	@echo "✓ BIOS ISO: $@"
	@echo "✓ Versioned BIOS ISO: $(BUILD_DIR)/hbos-bios-$(HBOS_VERSION)_$(shell date +%Y%m%d).iso"

$(ISO_UEFI): $(KERNEL_BIOS) $(LIMINE_EFI) $(UEFI_CD_IMG) limine.conf
	@rm -rf $(BUILD_DIR)/isodir-uefi
	@mkdir -p $(BUILD_DIR)/isodir-uefi/EFI/BOOT $(BUILD_DIR)/isodir-uefi/boot
	@cp $(KERNEL_BIOS) $(BUILD_DIR)/isodir-uefi/boot/hbos.bin
	@cp limine.conf $(BUILD_DIR)/isodir-uefi/limine.conf
	@cp $(LIMINE_EFI) $(BUILD_DIR)/isodir-uefi/EFI/BOOT/BOOTX64.EFI
	@cp $(UEFI_CD_IMG) $(BUILD_DIR)/isodir-uefi/boot/uefi-cd.img
	@xorriso -as mkisofs -R -r -J -V HBOS_UEFI \
		-eltorito-alt-boot -e boot/uefi-cd.img -no-emul-boot \
		-efi-boot-part --efi-boot-image --protective-msdos-label \
		-o $@ $(BUILD_DIR)/isodir-uefi >/dev/null 2>&1
	@cp $@ "$(BUILD_DIR)/hbos-uefi-$(HBOS_VERSION)_$(shell date +%Y%m%d).iso"
	@echo "✓ UEFI ISO: $@"
	@echo "✓ Versioned UEFI ISO: $(BUILD_DIR)/hbos-uefi-$(HBOS_VERSION)_$(shell date +%Y%m%d).iso"

iso: $(ISO_BIOS) $(ISO_UEFI)

bios-iso: $(ISO_BIOS)

uefi-iso: $(ISO_UEFI)

run: run-hdd-bios

vm: run

run-bios: run

run-iso: run-bios-ahci

run-bios-nodisk: $(ISO_BIOS)
	$(QEMU_ENV) $(QEMU) -cdrom $(ISO_BIOS) -m 512M -boot d -serial stdio -vga std -monitor none

disk-img: $(DISK_IMG)

$(INSTALL_IMG_BIOS): $(KERNEL_BIOS) $(LIMINE_EFI) limine.conf tools/mkhbosdisk.py
	python3 tools/mkhbosdisk.py $@ --mode bios --kernel $(KERNEL_BIOS) --limine-conf limine.conf --limine-dir limine-bin/bin

$(INSTALL_IMG_UEFI): $(KERNEL_BIOS) $(LIMINE_EFI) limine.conf tools/mkhbosdisk.py
	python3 tools/mkhbosdisk.py $@ --mode uefi --kernel $(KERNEL_BIOS) --limine-conf limine.conf --limine-dir limine-bin/bin

$(INSTALL_IMG): $(INSTALL_IMG_UEFI)
	@cp $(INSTALL_IMG_UEFI) $@

install-img: $(INSTALL_IMG_BIOS) $(INSTALL_IMG_UEFI) $(INSTALL_IMG)

$(VMWARE_BIOS_VMDK): $(INSTALL_IMG_BIOS)
	@rm -f $@
	$(QEMU_IMG) convert -f raw -O vmdk -o adapter_type=ide,subformat=monolithicSparse $(INSTALL_IMG_BIOS) $@
	@echo "✓ VMware BIOS VMDK: $@"

$(VMWARE_UEFI_VMDK): $(INSTALL_IMG_UEFI)
	@rm -f $@
	$(QEMU_IMG) convert -f raw -O vmdk -o adapter_type=ide,subformat=monolithicSparse $(INSTALL_IMG_UEFI) $@
	@echo "✓ VMware UEFI VMDK: $@"

$(VBOX_BIOS_VDI): $(INSTALL_IMG_BIOS)
	@rm -f $@
	$(QEMU_IMG) convert -f raw -O vdi $(INSTALL_IMG_BIOS) $@
	@echo "✓ VirtualBox BIOS VDI: $@"

$(VBOX_UEFI_VDI): $(INSTALL_IMG_UEFI)
	@rm -f $@
	$(QEMU_IMG) convert -f raw -O vdi $(INSTALL_IMG_UEFI) $@
	@echo "✓ VirtualBox UEFI VDI: $@"

vmware-bios: $(VMWARE_BIOS_VMDK)

vmware-uefi: $(VMWARE_UEFI_VMDK)

vbox-bios: $(VBOX_BIOS_VDI)

vbox-uefi: $(VBOX_UEFI_VDI)

release: $(ISO_BIOS) $(ISO_UEFI) $(VMWARE_BIOS_VMDK) $(VMWARE_UEFI_VMDK) $(VBOX_BIOS_VDI) $(VBOX_UEFI_VDI)
	@echo "✓ Release artifacts:"
	@echo "  $(ISO_BIOS)"
	@echo "  $(ISO_UEFI)"
	@echo "  $(VMWARE_BIOS_VMDK)"
	@echo "  $(VMWARE_UEFI_VMDK)"
	@echo "  $(VBOX_BIOS_VDI)"
	@echo "  $(VBOX_UEFI_VDI)"

smoke:
	bash scripts/smoke.sh

linux-compat-smoke: $(ISO_BIOS)
	bash scripts/test_linux_compat_smoke.sh $(ISO_BIOS)

xhci-smoke: $(ISO_BIOS)
	python3 scripts/test_usb_input.py
	python3 scripts/test_usb_disk.py

chromium-baseline:
	bash scripts/check_chromium_baseline.sh

browser-test: | $(BUILD_DIR)
	$(CC) -O2 -Wall -Wextra -Isrc/gui \
		tests/test_browser_backend.c src/gui/browser_backend.c \
		src/gui/browser_layout.c \
		-o $(BUILD_DIR)/test_browser_backend
	$(BUILD_DIR)/test_browser_backend

hive-test: | $(BUILD_DIR)
	$(CC) -O2 -Wall -Wextra -Iapp/include -Isrc/user \
		scripts/test_hive_ui.c -o $(BUILD_DIR)/test_hive_ui
	$(BUILD_DIR)/test_hive_ui
	$(CC) -O2 -Wall -Wextra -Isrc \
		scripts/test_hive_winsrv.c src/gui/winsrv.c \
		-o $(BUILD_DIR)/test_hive_winsrv
	$(BUILD_DIR)/test_hive_winsrv
	@echo "✓ HIVE UI 1.4 event/layout/widget tests"

hive-sync:
	@test -x "$(HIVE_REPO)/tools/sync-from-hbos.sh" || \
		{ echo "HIVE repository not found at $(HIVE_REPO)" >&2; exit 1; }
	$(MAKE) -C "$(HIVE_REPO)" sync HBOS_DIR="$(CURDIR)"

nogui:
	@$(MAKE) --no-print-directory BUILD_DIR=$(NOGUI_BUILD_DIR) \
		HBOS_ENABLE_GUI=0 HBOS_BUNDLE_APPS=0 iso
	@echo "✓ no-GUI BIOS: $(NOGUI_BUILD_DIR)/hbos-bios.iso"
	@echo "✓ no-GUI UEFI: $(NOGUI_BUILD_DIR)/hbos-uefi.iso"

nogui-bios:
	@$(MAKE) --no-print-directory BUILD_DIR=$(NOGUI_BUILD_DIR) \
		HBOS_ENABLE_GUI=0 HBOS_BUNDLE_APPS=0 bios-iso

nogui-uefi:
	@$(MAKE) --no-print-directory BUILD_DIR=$(NOGUI_BUILD_DIR) \
		HBOS_ENABLE_GUI=0 HBOS_BUNDLE_APPS=0 uefi-iso

nogui-smoke:
	bash scripts/smoke_nogui.sh

core-only:
	@$(MAKE) --no-print-directory BUILD_DIR=build-core \
		HBOS_ENABLE_GUI=1 HBOS_BUNDLE_APPS=0 HBOS_KERNEL_ONLY=1 iso

run-hdd: run-hdd-bios

# Display backend. SDL grabs the relative PS/2 pointer reliably (the GTK default
# drops continuous motion under Wayland, which made the mouse look "dead").
# Override on the command line if needed, e.g.  make run DISPLAY_OPT='-display gtk'
DISPLAY_OPT ?= -display sdl

run-nogui: run-nogui-bios

run-nogui-bios: nogui-bios
	$(QEMU_ENV) $(QEMU) -m 512M \
		-netdev user,id=net0 -device e1000,netdev=net0 \
		-cdrom $(NOGUI_BUILD_DIR)/hbos-bios.iso -boot d \
		-serial stdio -vga std -monitor none $(DISPLAY_OPT)

run-nogui-uefi: nogui-uefi
	@cp $(OVMF_VARS) $(NOGUI_BUILD_DIR)/OVMF_VARS_NOGUI.fd
	$(QEMU_ENV) $(QEMU) -machine q35 -m 512M \
		-drive if=pflash,format=raw,readonly=on,file=$(OVMF_CODE) \
		-drive if=pflash,format=raw,file=$(NOGUI_BUILD_DIR)/OVMF_VARS_NOGUI.fd \
		-netdev user,id=net0 -device e1000,netdev=net0 \
		-cdrom $(NOGUI_BUILD_DIR)/hbos-uefi.iso -boot d \
		-serial stdio -vga std -monitor none $(DISPLAY_OPT) -no-reboot

run-hdd-bios: $(INSTALL_IMG_BIOS)
	$(QEMU_ENV) $(QEMU) -m 512M \
		-device ich9-ahci,id=ahci \
		-drive file=$(INSTALL_IMG_BIOS),format=raw,if=none,id=hd0 \
		-device ide-hd,drive=hd0,bus=ahci.0 \
		-netdev user,id=net0 -device e1000,netdev=net0 \
		-boot c -serial stdio -vga std -monitor none $(DISPLAY_OPT)

run-hdd-uefi: $(INSTALL_IMG_UEFI)
	@cp $(OVMF_VARS) $(BUILD_DIR)/OVMF_VARS_HDD.fd
	$(QEMU_ENV) $(QEMU) -machine q35 -m 512M \
		-drive if=pflash,format=raw,readonly=on,file=$(OVMF_CODE) \
		-drive if=pflash,format=raw,file=$(BUILD_DIR)/OVMF_VARS_HDD.fd \
		-device ich9-ahci,id=ahci \
		-drive file=$(INSTALL_IMG_UEFI),format=raw,if=none,id=hd0 \
		-device ide-hd,drive=hd0,bus=ahci.0 \
		-netdev user,id=net0 -device e1000,netdev=net0 \
		-boot c -serial stdio -monitor none -vga std -no-reboot

run-bios-disk: $(ISO_BIOS) $(DISK_IMG)
	$(QEMU_ENV) $(QEMU) -m 512M \
		-drive file=$(DISK_IMG),format=raw,if=ide,index=0,media=disk \
		-netdev user,id=net0 -device e1000,netdev=net0 \
		-cdrom $(ISO_BIOS) -boot d \
		-serial stdio -vga std -monitor none

run-bios-ahci: $(ISO_BIOS) $(DISK_IMG)
	$(QEMU_ENV) $(QEMU) -m 512M \
		-device ich9-ahci,id=ahci \
		-drive file=$(DISK_IMG),format=raw,if=none,id=hd0 \
		-device ide-hd,drive=hd0,bus=ahci.0 \
		-netdev user,id=net0 -device e1000,netdev=net0 \
		-cdrom $(ISO_BIOS) -boot d \
		-serial stdio -vga std -monitor none

limine-uefi: $(LIMINE_EFI)

$(LIMINE_EFI):
	$(MAKE) -C limine-bin limine-uefi-x86-64 BUILD_UEFI_X86_64=limine-uefi-x86-64

$(UEFI_CD_IMG): $(KERNEL_BIOS) $(LIMINE_EFI) limine.conf
	@rm -f $@
	@dd if=/dev/zero of=$@ bs=512 count=98304 2>/dev/null
	@mformat -i $@ -h 64 -t 96 -s 16 -N 12345678 ::
	@mmd -i $@ ::/EFI ::/EFI/BOOT ::/boot
	@mcopy -D o -m -i $@ $(LIMINE_EFI) ::/EFI/BOOT/BOOTX64.EFI
	@mcopy -D o -m -i $@ limine.conf ::/limine.conf
	@mcopy -D o -m -i $@ $(KERNEL_BIOS) ::/boot/hbos.bin

$(UEFI_IMG): $(KERNEL_BIOS) $(LIMINE_EFI) limine.conf
	@rm -f $@
	@truncate -s 64M $@
	@mkfs.fat -F 32 $@ >/dev/null
	@mmd -i $@ ::/EFI ::/EFI/BOOT ::/boot
	@mcopy -i $@ $(LIMINE_EFI) ::/EFI/BOOT/BOOTX64.EFI
	@mcopy -i $@ limine.conf ::/limine.conf
	@mcopy -i $@ $(KERNEL_BIOS) ::/boot/hbos.bin
	@echo "✓ UEFI FAT image: $@"

uefi: $(ISO_UEFI)

uefi-img: $(UEFI_IMG)

run-uefi: run-hdd-uefi

run-iso-uefi: run-uefi-ahci

run-uefi-nodisk: $(ISO_UEFI)
	@cp $(OVMF_VARS) $(BUILD_DIR)/OVMF_VARS_UEFI.fd
	$(QEMU_ENV) $(QEMU) -machine q35 -m 512M \
		-drive if=pflash,format=raw,readonly=on,file=$(OVMF_CODE) \
		-drive if=pflash,format=raw,file=$(BUILD_DIR)/OVMF_VARS_UEFI.fd \
		-netdev user,id=net0 -device e1000,netdev=net0 \
		-cdrom $(ISO_UEFI) -boot d \
		-serial none -vga std -monitor none -no-reboot

run-uefi-img: $(UEFI_IMG)
	@cp $(OVMF_VARS) $(BUILD_DIR)/OVMF_VARS_UEFI.fd
	$(QEMU_ENV) $(QEMU) -machine q35 -m 512M \
		-drive if=pflash,format=raw,readonly=on,file=$(OVMF_CODE) \
		-drive if=pflash,format=raw,file=$(BUILD_DIR)/OVMF_VARS_UEFI.fd \
		-drive file=$(UEFI_IMG),format=raw,if=virtio \
		-netdev user,id=net0 -device e1000,netdev=net0 \
		-serial none -vga std -monitor none -no-reboot

run-uefi-headless: $(ISO_UEFI)
	@cp $(OVMF_VARS) $(BUILD_DIR)/OVMF_VARS_UEFI.fd
	$(QEMU_ENV) $(QEMU) -machine q35 -m 512M \
		-drive if=pflash,format=raw,readonly=on,file=$(OVMF_CODE) \
		-drive if=pflash,format=raw,file=$(BUILD_DIR)/OVMF_VARS_UEFI.fd \
		-netdev user,id=net0 -device e1000,netdev=net0 \
		-cdrom $(ISO_UEFI) -boot d \
		-serial stdio -monitor none -display none -no-reboot

run-uefi-disk: $(ISO_UEFI) $(DISK_IMG)
	@cp $(OVMF_VARS) $(BUILD_DIR)/OVMF_VARS_UEFI.fd
	$(QEMU_ENV) $(QEMU) -machine q35 -m 512M \
		-drive if=pflash,format=raw,readonly=on,file=$(OVMF_CODE) \
		-drive if=pflash,format=raw,file=$(BUILD_DIR)/OVMF_VARS_UEFI.fd \
		-drive file=$(DISK_IMG),format=raw,if=ide,index=0,media=disk \
		-netdev user,id=net0 -device e1000,netdev=net0 \
		-cdrom $(ISO_UEFI) -boot d \
		-serial stdio -monitor none -vga std -no-reboot

run-uefi-ahci: $(ISO_UEFI) $(DISK_IMG)
	@cp $(OVMF_VARS) $(BUILD_DIR)/OVMF_VARS_UEFI.fd
	$(QEMU_ENV) $(QEMU) -machine q35 -m 512M \
		-drive if=pflash,format=raw,readonly=on,file=$(OVMF_CODE) \
		-drive if=pflash,format=raw,file=$(BUILD_DIR)/OVMF_VARS_UEFI.fd \
		-device ich9-ahci,id=ahci \
		-drive file=$(DISK_IMG),format=raw,if=none,id=hd0 \
		-device ide-hd,drive=hd0,bus=ahci.0 \
		-netdev user,id=net0 -device e1000,netdev=net0 \
		-cdrom $(ISO_UEFI) -boot d \
		-serial stdio -monitor none -vga std -no-reboot

# ============================================================
# User-space ring3 programs
# ============================================================

USER_PROG_DIR = $(SRC_DIR)/user/progs
USER_LIBC_DIR = $(SRC_DIR)/user/libc
USER_BUILD_DIR = $(BUILD_DIR)/user

USER_CFLAGS = -m64 -mcmodel=large -ffreestanding -fno-stack-protector -fno-pic -fno-pie \
              -mno-red-zone -mno-80387 -mno-mmx -mno-sse -mno-sse2 -O2 -Wall -Wextra \
              -I$(SRC_DIR)/user/libc -I$(SRC_DIR)/user

USER_LDFLAGS = -m elf_x86_64 -static -nostdlib -T user.ld

USER_LIBC_SRCS = \
	$(USER_LIBC_DIR)/crt0.c \
	$(USER_LIBC_DIR)/syscall.c \
	$(USER_LIBC_DIR)/string.c \
	$(USER_LIBC_DIR)/stdlib.c \
	$(USER_LIBC_DIR)/stdio.c \
	$(USER_LIBC_DIR)/socket.c \
	$(USER_LIBC_DIR)/dlfcn.c \
	$(USER_LIBC_DIR)/dirent.c \
	$(USER_LIBC_DIR)/unistd.c \
	$(USER_LIBC_DIR)/errno.c \
	$(USER_LIBC_DIR)/fcntl.c \
	$(USER_LIBC_DIR)/time.c \
	$(USER_LIBC_DIR)/stat.c \
	$(USER_LIBC_DIR)/wait.c \
	$(USER_LIBC_DIR)/getopt.c

USER_LIBC_OBJS = $(USER_LIBC_SRCS:$(SRC_DIR)/%.c=$(BUILD_DIR)/%.o) $(BUILD_DIR)/user/libc/setjmp.o
USER_LINUX_COMPAT_OBJ = $(BUILD_DIR)/user/libc/linux.o
USER_LINUX_COMPAT_LIB = $(BUILD_DIR)/user/libhboslinux.a

.PHONY: linux-compat-lib linux-thread-test-bin
linux-compat-lib: $(USER_LINUX_COMPAT_LIB)

$(USER_LINUX_COMPAT_LIB): $(USER_LINUX_COMPAT_OBJ) | $(BUILD_DIR)
	@mkdir -p $(@D)
	$(AR) rcs $@ $<
	@echo "✓ Linux compatibility library: $@"

linux-thread-test-bin: $(BUILD_DIR)/tests/linux_compat_thread.hax

$(BUILD_DIR)/tests/linux_compat_thread.hax: tests/linux_compat_thread.c $(USER_LIBC_OBJS) $(USER_LINUX_COMPAT_LIB) | $(BUILD_DIR)
	@mkdir -p $(@D)
	$(CC) -c $(USER_CFLAGS) $< -o $(BUILD_DIR)/tests/linux_compat_thread.o
	$(LD) $(USER_LDFLAGS) $(USER_LIBC_OBJS) $(BUILD_DIR)/tests/linux_compat_thread.o $(USER_LINUX_COMPAT_LIB) -o $@
	@echo "✓ Linux thread test binary: $@"

$(BUILD_DIR)/tests/linux_clone3.hax: tests/linux_clone3.c tests/linux_clone3.asm \
		$(USER_LIBC_OBJS) $(USER_LINUX_COMPAT_LIB) | $(BUILD_DIR)
	@mkdir -p $(@D)
	$(CC) -c $(USER_CFLAGS) tests/linux_clone3.c -o $(BUILD_DIR)/tests/linux_clone3.o
	$(AS) $(ASFLAGS) tests/linux_clone3.asm -o $(BUILD_DIR)/tests/linux_clone3_asm.o
	$(LD) $(USER_LDFLAGS) $(USER_LIBC_OBJS) \
		$(BUILD_DIR)/tests/linux_clone3.o $(BUILD_DIR)/tests/linux_clone3_asm.o \
		$(USER_LINUX_COMPAT_LIB) -o $@
	@echo "✓ Native Linux clone3 thread test binary: $@"

$(BUILD_DIR)/tests/linux_epoll_et.hax: tests/linux_epoll_et.c $(USER_LIBC_OBJS) $(USER_LINUX_COMPAT_LIB) | $(BUILD_DIR)
	@mkdir -p $(@D)
	$(CC) -c $(USER_CFLAGS) $< -o $(BUILD_DIR)/tests/linux_epoll_et.o
	$(LD) $(USER_LDFLAGS) $(USER_LIBC_OBJS) $(BUILD_DIR)/tests/linux_epoll_et.o $(USER_LINUX_COMPAT_LIB) -o $@
	@echo "✓ Linux epoll edge/one-shot test binary: $@"

$(BUILD_DIR)/tests/linux_inotify.hax: tests/linux_inotify.c $(USER_LIBC_OBJS) $(USER_LINUX_COMPAT_LIB) | $(BUILD_DIR)
	@mkdir -p $(@D)
	$(CC) -c $(USER_CFLAGS) $< -o $(BUILD_DIR)/tests/linux_inotify.o
	$(LD) $(USER_LDFLAGS) $(USER_LIBC_OBJS) $(BUILD_DIR)/tests/linux_inotify.o $(USER_LINUX_COMPAT_LIB) -o $@
	@echo "✓ Native Linux inotify ABI test binary: $@"

$(BUILD_DIR)/tests/linux_syscall.hax: tests/linux_syscall.asm | $(BUILD_DIR)
	@mkdir -p $(@D)
	$(AS) $(ASFLAGS) $< -o $(BUILD_DIR)/tests/linux_syscall.o
	$(LD) -m elf_x86_64 -static -nostdlib -e _start \
		-Ttext 0x0000001001000000 $(BUILD_DIR)/tests/linux_syscall.o -o $@
	@echo "✓ Native Linux syscall ELF: $@"

$(BUILD_DIR)/tests/linux_pie.hax: tests/linux_syscall.asm | $(BUILD_DIR)
	@mkdir -p $(@D)
	$(AS) $(ASFLAGS) $< -o $(BUILD_DIR)/tests/linux_pie.o
	$(LD) -m elf_x86_64 -pie --no-dynamic-linker -static -nostdlib \
		-e _start -z max-page-size=0x1000 \
		$(BUILD_DIR)/tests/linux_pie.o -o $@
	@echo "✓ Native Linux static PIE: $@"

$(BUILD_DIR)/tests/linux_interp.hax: tests/linux_interp.asm | $(BUILD_DIR)
	@mkdir -p $(@D)
	$(AS) $(ASFLAGS) $< -o $(BUILD_DIR)/tests/linux_interp.o
	$(LD) -m elf_x86_64 -shared -nostdlib -e _start \
		-z max-page-size=0x1000 $(BUILD_DIR)/tests/linux_interp.o -o $@
	@echo "✓ Native Linux PT_INTERP test loader: $@"

$(BUILD_DIR)/tests/linux_dynamic.hax: tests/linux_dynamic.asm \
		$(BUILD_DIR)/tests/linux_interp.hax | $(BUILD_DIR)
	@mkdir -p $(@D)
	$(AS) $(ASFLAGS) $< -o $(BUILD_DIR)/tests/linux_dynamic.o
	$(LD) -m elf_x86_64 -pie -nostdlib -e _start \
		--dynamic-linker /linux_interp -z max-page-size=0x1000 \
		$(BUILD_DIR)/tests/linux_dynamic.o -o $@
	@echo "✓ Native Linux PT_INTERP executable: $@"

$(BUILD_DIR)/tests/linux_musl.hax: tests/linux_musl.c | $(BUILD_DIR)
	@test -n "$(HBOS_MUSL_SYSROOT)" || \
		{ echo "HBOS_MUSL_SYSROOT is required" >&2; exit 2; }
	@mkdir -p $(@D)
	$(CC) -fPIE -nostdinc \
		-isystem "$(HBOS_MUSL_SYSROOT)/usr/include/x86_64-linux-musl" \
		-c $< -o $(BUILD_DIR)/tests/linux_musl.o
	$(LD) -m elf_x86_64 -pie \
		--dynamic-linker /lib/ld-musl-x86_64.so.1 -e _start \
		-z max-page-size=0x1000 \
		"$(HBOS_MUSL_SYSROOT)/usr/lib/x86_64-linux-musl/Scrt1.o" \
		"$(HBOS_MUSL_SYSROOT)/usr/lib/x86_64-linux-musl/crti.o" \
		$(BUILD_DIR)/tests/linux_musl.o \
		-L"$(HBOS_MUSL_SYSROOT)/usr/lib/x86_64-linux-musl" -lc \
		"$(HBOS_MUSL_SYSROOT)/usr/lib/x86_64-linux-musl/crtn.o" -o $@
	@test "$$(stat -c %s $@)" -gt 524288 || \
		{ echo "musl streaming exec test must exceed 512 KiB" >&2; exit 2; }
	@echo "✓ Native dynamically linked musl executable: $@"

$(BUILD_DIR)/tests/linux_musl_pthread.hax: tests/linux_musl_pthread.c | $(BUILD_DIR)
	@test -n "$(HBOS_MUSL_SYSROOT)" || \
		{ echo "HBOS_MUSL_SYSROOT is required" >&2; exit 2; }
	@mkdir -p $(@D)
	$(CC) -fPIE -nostdinc \
		-isystem "$(HBOS_MUSL_SYSROOT)/usr/include/x86_64-linux-musl" \
		-c $< -o $(BUILD_DIR)/tests/linux_musl_pthread.o
	$(LD) -m elf_x86_64 -pie \
		--dynamic-linker /lib/ld-musl-x86_64.so.1 -e _start \
		-z max-page-size=0x1000 \
		"$(HBOS_MUSL_SYSROOT)/usr/lib/x86_64-linux-musl/Scrt1.o" \
		"$(HBOS_MUSL_SYSROOT)/usr/lib/x86_64-linux-musl/crti.o" \
		$(BUILD_DIR)/tests/linux_musl_pthread.o \
		-L"$(HBOS_MUSL_SYSROOT)/usr/lib/x86_64-linux-musl" -lc \
		"$(HBOS_MUSL_SYSROOT)/usr/lib/x86_64-linux-musl/crtn.o" -o $@
	@echo "✓ Native dynamically linked musl pthread executable: $@"

$(BUILD_DIR)/tests/linux_musl_loader.hax: | $(BUILD_DIR)
	@test -n "$(HBOS_MUSL_SYSROOT)" || \
		{ echo "HBOS_MUSL_SYSROOT is required" >&2; exit 2; }
	cp "$(HBOS_MUSL_SYSROOT)/usr/lib/x86_64-linux-musl/libc.so" $@
	@echo "✓ Native musl PT_INTERP/libc image: $@"

$(BUILD_DIR)/tests/linux_musl_stream.hax: tests/linux_musl_stream.asm | $(BUILD_DIR)
	@mkdir -p $(@D)
	$(AS) $(ASFLAGS) $< -o $(BUILD_DIR)/tests/linux_musl_stream.o
	$(LD) -m elf_x86_64 -static -nostdlib -e _start \
		-Ttext 0x0000001002000000 \
		$(BUILD_DIR)/tests/linux_musl_stream.o -o $@
	@echo "✓ Linux streaming execve launcher: $@"

$(BUILD_DIR)/tests/linux_glibc.hax: tests/linux_glibc.c | $(BUILD_DIR)
	@test -n "$(HBOS_GLIBC_LIBDIR)" || \
		{ echo "HBOS_GLIBC_LIBDIR is required" >&2; exit 2; }
	@mkdir -p $(@D)
	$(CC) -fPIE -pie -pthread -Wl,-z,max-page-size=0x1000 \
		-Wl,--dynamic-linker=/lib64/ld-linux-x86-64.so.2 $< -o $@
	@echo "✓ Native dynamically linked glibc executable: $@"

$(BUILD_DIR)/tests/linux_glibc_loader.hax: | $(BUILD_DIR)
	@test -f "$(HBOS_GLIBC_LIBDIR)/ld-linux-x86-64.so.2" || \
		{ echo "glibc loader not found in HBOS_GLIBC_LIBDIR" >&2; exit 2; }
	cp "$(HBOS_GLIBC_LIBDIR)/ld-linux-x86-64.so.2" $@
	@echo "✓ Native glibc PT_INTERP image: $@"

$(BUILD_DIR)/tests/linux_glibc_libc.hax: | $(BUILD_DIR)
	@test -f "$(HBOS_GLIBC_LIBDIR)/libc.so.6" || \
		{ echo "glibc libc.so.6 not found in HBOS_GLIBC_LIBDIR" >&2; exit 2; }
	cp "$(HBOS_GLIBC_LIBDIR)/libc.so.6" $@
	@echo "✓ Native glibc libc image: $@"

$(BUILD_DIR)/tests/linux_abi.hax: tests/linux_abi.asm | $(BUILD_DIR)
	@mkdir -p $(@D)
	$(AS) $(ASFLAGS) $< -o $(BUILD_DIR)/tests/linux_abi.o
	$(LD) -m elf_x86_64 -pie --no-dynamic-linker -static -nostdlib \
		-e _start -z max-page-size=0x1000 \
		$(BUILD_DIR)/tests/linux_abi.o -o $@
	@echo "✓ Native Linux structure/vector ABI test: $@"

$(BUILD_DIR)/tests/linux_signal.hax: tests/linux_signal.asm | $(BUILD_DIR)
	@mkdir -p $(@D)
	$(AS) $(ASFLAGS) $< -o $(BUILD_DIR)/tests/linux_signal.o
	$(LD) -m elf_x86_64 -pie --no-dynamic-linker -static -nostdlib \
		-e _start -z max-page-size=0x1000 \
		$(BUILD_DIR)/tests/linux_signal.o -o $@
	@echo "✓ Native Linux ring3 signal/rt_sigreturn test: $@"

$(BUILD_DIR)/tests/linux_signal_siginfo.hax: tests/linux_signal_siginfo.asm | $(BUILD_DIR)
	@mkdir -p $(@D)
	$(AS) $(ASFLAGS) $< -o $(BUILD_DIR)/tests/linux_signal_siginfo.o
	$(LD) -m elf_x86_64 -pie --no-dynamic-linker -static -nostdlib \
		-e _start -z max-page-size=0x1000 \
		$(BUILD_DIR)/tests/linux_signal_siginfo.o -o $@
	@echo "✓ Native Linux SA_SIGINFO/ucontext/sigaltstack/nesting test: $@"

$(BUILD_DIR)/tests/linux_mprotect.hax: tests/linux_mprotect.asm | $(BUILD_DIR)
	@mkdir -p $(@D)
	$(AS) $(ASFLAGS) $< -o $(BUILD_DIR)/tests/linux_mprotect.o
	$(LD) -m elf_x86_64 -pie --no-dynamic-linker -static -nostdlib \
		-e _start -z max-page-size=0x1000 \
		$(BUILD_DIR)/tests/linux_mprotect.o -o $@
	@echo "✓ Native Linux mmap/mprotect W^X test: $@"

$(BUILD_DIR)/tests/linux_mmap_reclaim.hax: tests/linux_mmap_reclaim.asm | $(BUILD_DIR)
	@mkdir -p $(@D)
	$(AS) $(ASFLAGS) $< -o $(BUILD_DIR)/tests/linux_mmap_reclaim.o
	$(LD) -m elf_x86_64 -pie --no-dynamic-linker -static -nostdlib \
		-e _start -z max-page-size=0x1000 \
		$(BUILD_DIR)/tests/linux_mmap_reclaim.o -o $@
	@echo "✓ Native Linux mmap reclamation/VMA split test: $@"

$(BUILD_DIR)/tests/linux_file_mmap.hax: tests/linux_file_mmap.asm | $(BUILD_DIR)
	@mkdir -p $(@D)
	$(AS) $(ASFLAGS) $< -o $(BUILD_DIR)/tests/linux_file_mmap.o
	$(LD) -m elf_x86_64 -pie --no-dynamic-linker -static -nostdlib \
		-e _start -z max-page-size=0x1000 \
		$(BUILD_DIR)/tests/linux_file_mmap.o -o $@
	@echo "✓ Native Linux regular-file mmap test: $@"

$(BUILD_DIR)/tests/linux_process_abi.hax: tests/linux_process_abi.asm | $(BUILD_DIR)
	@mkdir -p $(@D)
	$(AS) $(ASFLAGS) $< -o $(BUILD_DIR)/tests/linux_process_abi.o
	$(LD) -m elf_x86_64 -pie --no-dynamic-linker -static -nostdlib \
		-e _start -z max-page-size=0x1000 \
		$(BUILD_DIR)/tests/linux_process_abi.o -o $@
	@echo "✓ Native Linux process/resource ABI test: $@"

$(BUILD_DIR)/tests/linux_dlopen_lib.hax: tests/linux_dlopen_lib.c | $(BUILD_DIR)
	@mkdir -p $(@D)
	$(CC) -c -m64 -fPIC -ffreestanding -fno-stack-protector -O2 \
		-Wall -Wextra $< -o $(BUILD_DIR)/tests/linux_dlopen_lib.o
	$(LD) -m elf_x86_64 -shared -nostdlib --hash-style=gnu \
		-z max-page-size=0x1000 \
		$(BUILD_DIR)/tests/linux_dlopen_lib.o -o $@
	@test "$$(stat -c %s $@)" -gt 524288 || \
		{ echo "dlopen streaming test must exceed 512 KiB" >&2; exit 2; }
	@echo "✓ Large streaming dlopen library: $@"

$(BUILD_DIR)/tests/linux_dlopen.hax: tests/linux_dlopen.c \
		$(USER_LIBC_OBJS) | $(BUILD_DIR)
	@mkdir -p $(@D)
	$(CC) -c $(USER_CFLAGS) $< -o $(BUILD_DIR)/tests/linux_dlopen.o
	$(LD) $(USER_LDFLAGS) $(USER_LIBC_OBJS) \
		$(BUILD_DIR)/tests/linux_dlopen.o -o $@
	@echo "✓ Streaming dlopen caller: $@"

$(BUILD_DIR)/tests/linux_dlopen_dep_leaf.hax: tests/linux_dlopen_dep_leaf.c \
		tests/linux_dlopen_dep_leaf.map | $(BUILD_DIR)
	@mkdir -p $(@D)
	$(CC) -c -m64 -fPIC -ffreestanding -fno-stack-protector -O2 \
		-Wall -Wextra $< -o $(BUILD_DIR)/tests/linux_dlopen_dep_leaf.o
	$(LD) -m elf_x86_64 -shared -nostdlib --hash-style=gnu \
		-soname liblinux_dep_leaf.so -init hbos_leaf_dt_init \
		-fini hbos_leaf_dt_fini -z max-page-size=0x1000 \
		--version-script=tests/linux_dlopen_dep_leaf.map \
		$(BUILD_DIR)/tests/linux_dlopen_dep_leaf.o -o $@
	@echo "✓ DT_NEEDED leaf library: $@"

$(BUILD_DIR)/tests/linux_dlopen_dep_root.hax: tests/linux_dlopen_dep_root.c \
		$(BUILD_DIR)/tests/linux_dlopen_dep_leaf.hax | $(BUILD_DIR)
	@mkdir -p $(@D)
	$(CC) -c -m64 -fPIC -ffreestanding -fno-stack-protector -O2 \
		-Wall -Wextra $< -o $(BUILD_DIR)/tests/linux_dlopen_dep_root.o
	$(LD) -m elf_x86_64 -shared -nostdlib --hash-style=gnu --no-as-needed \
		-soname liblinux_dep_root.so -init hbos_root_dt_init \
		-fini hbos_root_dt_fini -z max-page-size=0x1000 \
		$(BUILD_DIR)/tests/linux_dlopen_dep_root.o \
		-L$(BUILD_DIR)/tests -l:linux_dlopen_dep_leaf.hax -o $@
	@echo "✓ DT_NEEDED root library: $@"

$(BUILD_DIR)/tests/linux_dlopen_deps.hax: tests/linux_dlopen_deps.c \
		$(USER_LIBC_OBJS) $(USER_LINUX_COMPAT_LIB) \
		$(BUILD_DIR)/tests/linux_dlopen_dep_root.hax | $(BUILD_DIR)
	@mkdir -p $(@D)
	$(CC) -c $(USER_CFLAGS) $< -o $(BUILD_DIR)/tests/linux_dlopen_deps.o
	$(LD) $(USER_LDFLAGS) $(USER_LIBC_OBJS) \
		$(BUILD_DIR)/tests/linux_dlopen_deps.o $(USER_LINUX_COMPAT_LIB) -o $@
	@echo "✓ DT_NEEDED dependency graph caller: $@"

USER_PROG_SRCS = $(wildcard $(USER_PROG_DIR)/*.c)
USER_PROG_BINS = $(USER_PROG_SRCS:$(USER_PROG_DIR)/%.c=$(USER_BUILD_DIR)/%.elf)

$(BUILD_DIR)/user/libc/%.o: $(SRC_DIR)/user/libc/%.c | $(BUILD_DIR)
	@mkdir -p $(@D)
	$(CC) -c $(USER_CFLAGS) $< -o $@

$(BUILD_DIR)/user/libc/setjmp.o: $(SRC_DIR)/user/libc/setjmp.asm | $(BUILD_DIR)
	@mkdir -p $(@D)
	$(AS) $(ASFLAGS) $< -o $@

$(USER_BUILD_DIR)/%.elf: $(USER_PROG_DIR)/%.c $(USER_LIBC_OBJS) | $(BUILD_DIR)
	@mkdir -p $(@D) $(BUILD_DIR)/user/progs
	$(CC) -c $(USER_CFLAGS) $< -o $(BUILD_DIR)/user/progs/$*.o
	$(LD) $(USER_LDFLAGS) $(USER_LIBC_OBJS) $(BUILD_DIR)/user/progs/$*.o -o $@
	@echo "✓ user prog: $@"

user-progs: $(USER_PROG_BINS)
	@echo "✓ All user programs built"

user-progs-clean:
	rm -rf $(USER_BUILD_DIR) $(BUILD_DIR)/user
	@echo "✓ User programs cleaned"

# ── HAX 应用构建（多结构：单文件 / 多文件目录 / 独立库） ────────────
# 每个 app 源码用 HAX 运行时（= 用户态 libc + crt0）链接成标准 ELF64，
# 扩展名 .hax。SDK 头在 $(APP_DIR)/include，库头按 <lib/xxx.h> 引入。
HAX_CFLAGS = $(USER_CFLAGS) -I$(APP_DIR)/include -I$(APP_DIR)/lib -MMD -MP

# ── 单文件应用（app/<name>.c -> build/app/<name>.hax） ───────────────
# 可选同名 app/<name>.deps 声明要链接的独立库（每行一个库名，# 为注释）。
define HAX_SINGLE_APP_RULE
HAX_APP_LIBOBJ_$(1) := $$(foreach l,$$(strip $$(shell grep -vE '^[[:space:]]*#' $(APP_DIR)/$(1).deps 2>/dev/null)),$(BUILD_DIR)/app/lib/$$(l).o)
$(BUILD_DIR)/app/$(1).hax: $(APP_DIR)/$(1).c $$(wildcard $(APP_DIR)/include/*.h) $$(HAX_APP_LIBOBJ_$(1)) $(USER_LIBC_OBJS) | $(BUILD_DIR)
	@mkdir -p $$(@D)
	$$(CC) -c $$(HAX_CFLAGS) $$< -o $(BUILD_DIR)/app/$(1).o
	$$(LD) $$(USER_LDFLAGS) $(USER_LIBC_OBJS) $(BUILD_DIR)/app/$(1).o $$(HAX_APP_LIBOBJ_$(1)) -o $$@
	@echo "✓ hax app: $$@"
endef
$(foreach n,$(patsubst $(APP_DIR)/%.c,%,$(HAX_APP_SRCS)),$(eval $(call HAX_SINGLE_APP_RULE,$(n))))

# ── 独立库（app/lib/<lib>/ -> build/app/lib/<lib>.o，ld -r 合并一次） ──
# 库之间的依赖写在 app/lib/<lib>/deps（每行一个库名），依赖库会被
# 一并合并进本库的 .o，应用只需声明直接依赖。
define HAX_LIB_RULE
HAX_LIB_SRC_$(1) := $$(wildcard $(APP_DIR)/lib/$(1)/*.c)
HAX_LIB_OBJ_$(1) := $$(patsubst $(APP_DIR)/lib/$(1)/%.c,$(BUILD_DIR)/app/lib/$(1)/%.o,$$(HAX_LIB_SRC_$(1)))
HAX_LIB_DEPOBJ_$(1) := $$(foreach l,$$(strip $$(shell grep -vE '^[[:space:]]*#' $(APP_DIR)/lib/$(1)/deps 2>/dev/null)),$(BUILD_DIR)/app/lib/$$(l).o)
$(BUILD_DIR)/app/lib/$(1)/%.o: $(APP_DIR)/lib/$(1)/%.c $$(wildcard $(APP_DIR)/include/*.h) | $(BUILD_DIR)
	@mkdir -p $$(@D)
	$$(CC) -c $$(HAX_CFLAGS) $$< -o $$@
$(BUILD_DIR)/app/lib/$(1).o: $$(HAX_LIB_OBJ_$(1)) $$(HAX_LIB_DEPOBJ_$(1)) | $(BUILD_DIR)
	@mkdir -p $$(@D)
	$$(LD) -r $$(HAX_LIB_OBJ_$(1)) $$(HAX_LIB_DEPOBJ_$(1)) -o $$@
	@echo "✓ hax lib: $$@ ($(1))"
endef
$(foreach l,$(HAX_LIB_NAMES),$(eval $(call HAX_LIB_RULE,$(l))))

# ── 多文件应用（app/<name>/*.c -> build/app/<name>.hax） ─────────────
# 目录内全部 *.c 分别编译后一起链接；库依赖写在 app/<name>/deps。
define HAX_DIR_APP_RULE
HAX_DIR_SRC_$(1) := $$(wildcard $(APP_DIR)/$(1)/*.c)
HAX_DIR_OBJ_$(1) := $$(patsubst $(APP_DIR)/$(1)/%.c,$(BUILD_DIR)/app/$(1)/%.o,$$(HAX_DIR_SRC_$(1)))
HAX_DIR_DEPOBJ_$(1) := $$(foreach l,$$(strip $$(shell grep -vE '^[[:space:]]*#' $(APP_DIR)/$(1)/deps 2>/dev/null)),$(BUILD_DIR)/app/lib/$$(l).o)
$(BUILD_DIR)/app/$(1)/%.o: $(APP_DIR)/$(1)/%.c $$(wildcard $(APP_DIR)/include/*.h) | $(BUILD_DIR)
	@mkdir -p $$(@D)
	$$(CC) -c $$(HAX_CFLAGS) $$< -o $$@
$(BUILD_DIR)/app/$(1).hax: $$(HAX_DIR_OBJ_$(1)) $$(HAX_DIR_DEPOBJ_$(1)) $(USER_LIBC_OBJS) | $(BUILD_DIR)
	@mkdir -p $$(@D)
	$$(LD) $$(USER_LDFLAGS) $(USER_LIBC_OBJS) $$(HAX_DIR_OBJ_$(1)) $$(HAX_DIR_DEPOBJ_$(1)) -o $$@
	@echo "✓ hax app: $$@ ($(1), 多文件)"
endef
$(foreach d,$(HAX_APP_DIR_NAMES),$(eval $(call HAX_DIR_APP_RULE,$(d))))

# ── TinyCC (vendored third_party/tinycc) — see that dir's README.md ────
# Builds as a single translation unit (tcc.c #includes everything else,
# TinyCC's own default "ONE_SOURCE" unity build) using HBOS's normal user
# libc/crt0/user.ld, exactly like any other single-file .hax app — except
# it needs real SSE2 (own float constant folding) instead of the
# -mno-{80387,mmx,sse,sse2} every other .hax app builds with. See
# third_party/tinycc/README.md for why, and the known FPU-context-switch
# risk that trade-off carries.
# ── quickjs (vendored third_party/quickjs) + musl libm subset ──────
# The `js` command evaluates scripts at ring3 (used by the compat smoke
# suite).  quickjs and the musl-math double-precision files need real SSE2
# like TinyCC (see the TCC_CFLAGS comment below for the FPU trade-off);
# the rest of the .hax apps build with -mno-* via USER_CFLAGS.
QJS_DIR = third_party/quickjs
MUSL_MATH_DIR = third_party/musl-math
QJS_CFLAGS = -m64 -mcmodel=large -ffreestanding -fno-stack-protector -fno-pic -fno-pie \
             -mno-red-zone -O2 -Wall -Wextra -MMD -MP \
             -I$(SRC_DIR)/user/libc -I$(QJS_DIR) -I$(MUSL_MATH_DIR) \
             -I$(BUILD_DIR)/quickjs \
             -DCONFIG_VERSION=\"QuickJS-HBOS\"

QJS_CORE_SRCS = $(QJS_DIR)/quickjs.c $(QJS_DIR)/libregexp.c \
	$(QJS_DIR)/libunicode.c $(QJS_DIR)/dtoa.c $(QJS_DIR)/cutils.c
MUSL_MATH_SRCS = $(wildcard $(MUSL_MATH_DIR)/*.c)

-include $(QJS_CORE_SRCS:$(QJS_DIR)/%.c=$(BUILD_DIR)/quickjs/%.d)
-include $(MUSL_MATH_SRCS:$(MUSL_MATH_DIR)/%.c=$(BUILD_DIR)/quickjs/math/%.d)
-include $(BUILD_DIR)/quickjs/hbos_js.d

$(BUILD_DIR)/quickjs/%.o: $(QJS_DIR)/%.c | $(BUILD_DIR)
	@mkdir -p $(@D)
	$(CC) -c $(QJS_CFLAGS) $< -o $@

$(BUILD_DIR)/quickjs/math/%.o: $(MUSL_MATH_DIR)/%.c | $(BUILD_DIR)
	@mkdir -p $(@D)
	$(CC) -c $(QJS_CFLAGS) -Wno-overflow -Wno-parentheses -Wno-sign-compare \
		$< -o $@

# hbos_dom.js（DOM 平台）构建期转成 C 字符串嵌入 hbos_js.c
$(BUILD_DIR)/quickjs/hbos_dom_inc.h: tools/genjsheader.py $(QJS_DIR)/hbos_dom.js | $(BUILD_DIR)
	@mkdir -p $(@D)
	python3 tools/genjsheader.py $(QJS_DIR)/hbos_dom.js $@

$(BUILD_DIR)/quickjs/hbos_js.o: $(QJS_DIR)/hbos_js.c $(BUILD_DIR)/quickjs/hbos_dom_inc.h | $(BUILD_DIR)
	@mkdir -p $(@D)
	$(CC) -c $(QJS_CFLAGS) $< -o $@

QJS_OBJS = $(QJS_CORE_SRCS:$(QJS_DIR)/%.c=$(BUILD_DIR)/quickjs/%.o) \
	$(MUSL_MATH_SRCS:$(MUSL_MATH_DIR)/%.c=$(BUILD_DIR)/quickjs/math/%.o) \
	$(BUILD_DIR)/quickjs/hbos_js.o

$(BUILD_DIR)/app/js.hax: $(QJS_OBJS) $(USER_LIBC_OBJS) | $(BUILD_DIR)
	@mkdir -p $(@D)
	$(LD) $(USER_LDFLAGS) $(USER_LIBC_OBJS) $(QJS_OBJS) -o $@
	@echo "✓ hax app: $@ (quickjs)"

TCC_DIR = third_party/tinycc
TCC_CFLAGS = -m64 -mcmodel=large -ffreestanding -fno-stack-protector -fno-pic -fno-pie \
             -mno-red-zone -O2 -Wall -MMD -MP \
             -I$(SRC_DIR)/user/libc -I$(SRC_DIR)/user -I$(TCC_DIR)

# tcc.c #includes everything else in $(TCC_DIR) as one unity-build translation
# unit (see third_party/tinycc/README.md) — -MMD/-MP (like the kernel's own
# C_SRCS) tracks that whole chain so editing e.g. tccelf.c or libtcc.c
# correctly forces a rebuild, not just editing tcc.c itself.
-include $(BUILD_DIR)/app/tcc.d

$(BUILD_DIR)/app/tcc.hax: $(TCC_DIR)/tcc.c $(USER_LIBC_OBJS) | $(BUILD_DIR)
	@mkdir -p $(@D)
	$(CC) -c $(TCC_CFLAGS) $< -o $(BUILD_DIR)/app/tcc.o
	$(LD) $(USER_LDFLAGS) $(USER_LIBC_OBJS) $(BUILD_DIR)/app/tcc.o -o $@
	@echo "✓ hax app: $@ (tcc)"

# TinyCC-compiled user programs link against this (crt0 + all of HBOS's own
# libc, combined into one relocatable object) — see tcc.c's HBOS patch
# ("auto-link our own crt0+libc runtime bundle") and
# src/tools/tcc_runtime_seed.c (writes it into ramfs at boot).
$(BUILD_DIR)/tcc/hbos_runtime.o: $(USER_LIBC_OBJS) | $(BUILD_DIR)
	@mkdir -p $(@D)
	$(LD) -r $(USER_LIBC_OBJS) -o $@

# ── Vendored BusyBox applets (third_party/busybox) — see that dir's
# README.md. Each applet is its own standalone .hax (one main() shim
# `#include`-ing the mostly-unmodified upstream applet .c file), not a
# multi-call binary — see README.md "Why one .hax per applet". Unlike tcc.c,
# these need no SSE2, so they build with the normal HAX_CFLAGS-equivalent
# flags (-mno-80387/mmx/sse/sse2), just with third_party/busybox on the
# include path instead of app/include.
BUSYBOX_DIR = third_party/busybox
BUSYBOX_CFLAGS = $(USER_CFLAGS) -MMD -MP -I$(BUSYBOX_DIR)
BUSYBOX_APPLETS = true false echo pwd mkdir wc head cat rm cp mv dirname basename touch which whoami ls

-include $(BUSYBOX_APPLETS:%=$(BUILD_DIR)/app/%.d)
-include $(BUILD_DIR)/busybox/libbb_shim.d

# Small hand-written libbb.h helper implementations (libbb_shim.c) — linked
# into every applet; unused symbols just go unreferenced (same reasoning as
# linking the full USER_LIBC_OBJS into every plain .hax app regardless of
# what each one actually calls).
$(BUILD_DIR)/busybox/libbb_shim.o: $(BUSYBOX_DIR)/libbb_shim.c | $(BUILD_DIR)
	@mkdir -p $(@D)
	$(CC) -c $(BUSYBOX_CFLAGS) $< -o $@

define BUSYBOX_APPLET_RULE
$(BUILD_DIR)/app/$(1).hax: $(BUSYBOX_DIR)/entry_$(1).c $(USER_LIBC_OBJS) $(BUILD_DIR)/busybox/libbb_shim.o | $$(BUILD_DIR)
	@mkdir -p $$(@D)
	$$(CC) -c $$(BUSYBOX_CFLAGS) $$< -o $(BUILD_DIR)/app/$(1).o
	$$(LD) $$(USER_LDFLAGS) $$(USER_LIBC_OBJS) $(BUILD_DIR)/busybox/libbb_shim.o $(BUILD_DIR)/app/$(1).o -o $$@
	@echo "✓ hax app: $$@ (busybox $(1))"
endef
$(foreach applet,$(BUSYBOX_APPLETS),$(eval $(call BUSYBOX_APPLET_RULE,$(applet))))

BUSYBOX_HAX = $(BUSYBOX_APPLETS:%=$(BUILD_DIR)/app/%.hax)

include mk/hpt.mk

# 生成清单与 blob（grouped target：一次调用产出两者，GNU Make >= 4.3）
$(HAX_MODE_STAMP): | $(BUILD_DIR)
	@rm -f $(BUILD_DIR)/.hax-mode-0 $(BUILD_DIR)/.hax-mode-1
	@touch $@

$(HAX_BLOB) $(HAX_MANIFEST) &: $(HAX_ALL_BINS) tools/genhax.py $(HAX_MODE_STAMP) | $(BUILD_DIR)
	python3 tools/genhax.py --blob $(HAX_BLOB) --manifest $(HAX_MANIFEST) $(HAX_ALL_BINS)

# 编译生成的清单 C（位于 build/，需显式规则）
$(BUILD_DIR)/hax_manifest.o: $(HAX_MANIFEST) | $(BUILD_DIR)
	$(CC) -c $(CFLAGS) $< -o $@

# 汇编 incbin blob —— blob 变化时必须重新汇编（普通先决条件）
$(BUILD_DIR)/user/hax_blob.o: $(SRC_DIR)/user/hax_blob.asm $(HAX_BLOB) | $(BUILD_DIR)
	@mkdir -p $(@D)
	$(AS) $(ASFLAGS) $< -o $@

.PHONY: hax-apps
hax-apps: $(HAX_ALL_BINS)
	@echo "✓ All .hax apps built: $(HAX_ALL_BINS)"

# 由 HTML 源经 WeasyPrint 生成紧凑、省油墨的应用开发手册 PDF
.PHONY: hax-doc
hax-doc: docs/HBOS_HAX_API.html tools/genpdf.py
	$(PDF_PYTHON) tools/genpdf.py docs/HBOS_HAX_API.html -o HBOS_HAX_API.pdf
	@echo "✓ 应用开发手册: HBOS_HAX_API.pdf"

# ── HBFS file injection ──────────────────────────────────────────
# Copy a file into a standalone HBFS image:  make hbfs-copy DISK=build/hbos_disk.img FILE=hello.c
hbfs-copy:
	@test -n "$(FILE)" || { echo "Usage: make hbfs-copy DISK=<image> FILE=<file> [NAME=remote_name]"; exit 1; }
	python3 tools/hbfs-copy.py $(DISK) $(FILE) $(NAME)

# Copy a file into the installed disk image:  make hbfs-install FILE=hello.c
hbfs-install: $(INSTALL_IMG_BIOS)
	python3 tools/hbfs-copy.py $(INSTALL_IMG_BIOS) $(FILE) $(NAME)

# List files in installed disk image:  make hbfs-list
hbfs-list: $(INSTALL_IMG_BIOS)
	python3 tools/hbfs-copy.py $(INSTALL_IMG_BIOS) --list

# Create standalone HBFS data disk:  make hbfs-disk
hbfs-disk: $(DISK_IMG)
$(DISK_IMG): tools/mkhbfs.py | $(BUILD_DIR)
	python3 tools/mkhbfs.py $@ --size-mib 16

# ── FAT32 file injection (beta5: new installs default to FAT32) ─────
# Unlike HBFS, FAT32 is a real, standard format -- no custom Python writer
# needed, `mtools`/`dosfstools` (already in README's apt dependency list)
# read/write it directly. OFFSET is the partition's byte offset on the
# image (LBA * 512); 1048576 = LBA 2048 = HBOS_DEFAULT_START_LBA in
# src/fs.c, i.e. the default auto-install range.
#   make fat32-copy DISK=build/hbos_disk.img FILE=hello.c [OFFSET=1048576]
fat32-copy:
	@test -n "$(FILE)" || { echo "Usage: make fat32-copy DISK=<image> FILE=<file> [OFFSET=1048576]"; exit 1; }
	mcopy -i "$(DISK)@@$(or $(OFFSET),1048576)" "$(FILE)" ::

# Copy a file into the installed disk image:  make fat32-install FILE=hello.c
fat32-install: $(INSTALL_IMG_BIOS)
	mcopy -i "$(INSTALL_IMG_BIOS)@@$(or $(OFFSET),1048576)" "$(FILE)" ::

# List files in installed disk image:  make fat32-list
fat32-list: $(INSTALL_IMG_BIOS)
	mdir -i "$(INSTALL_IMG_BIOS)@@$(or $(OFFSET),1048576)"

clean:
	rm -rf $(BUILD_DIR)
	@echo "✓ Cleaned"

# Auto-generated header dependencies (-MMD -MP in CFLAGS): without this, editing
# a shared header (e.g. gui_state.h) doesn't force recompilation of every .c
# that includes it, so a stale .o keeps the OLD struct layout while everything
# else uses the new one — silent memory corruption at runtime, not a build
# error. `-include` so a missing .d (first build) is skipped instead of failing.
-include $(C_OBJS:.o=.d)
# 多结构 HAX 应用的依赖文件（单文件在 build/app/*.d，多文件/库在子目录）
-include $(wildcard $(BUILD_DIR)/app/*.d) $(wildcard $(BUILD_DIR)/app/*/*.d)