koboldcpp/tools/ui/CMakeLists.txt

set(TARGET llama-ui)

# Deprecated: use LLAMA_UI_HF_BUCKET instead
set(LLAMA_WEBUI_HF_BUCKET "llama-ui" CACHE STRING "Hugging Face bucket name for prebuilt webui assets (deprecated: use LLAMA_UI_HF_BUCKET)")
set(LLAMA_UI_HF_BUCKET "llama-ui" CACHE STRING "Hugging Face bucket name for prebuilt UI assets")

# Backward compat: forward old var to new one
if(DEFINED LLAMA_WEBUI_HF_BUCKET AND NOT DEFINED LLAMA_UI_HF_BUCKET)
    set(LLAMA_UI_HF_BUCKET ${LLAMA_WEBUI_HF_BUCKET})
elseif(DEFINED LLAMA_WEBUI_HF_BUCKET AND NOT "${LLAMA_WEBUI_HF_BUCKET}" STREQUAL "${LLAMA_UI_HF_BUCKET}")
    message(DEPRECATION "LLAMA_WEBUI_HF_BUCKET is deprecated, use LLAMA_UI_HF_BUCKET instead")
endif()

set(TARGET_SRCS "")
set(UI_COMPILE_DEFS "")

if(LLAMA_BUILD_UI)
    set(PUBLIC_ASSETS
        index.html
        bundle.js
        bundle.css
        loading.html
    )

    # Determine source of UI assets (priority: local > HF Bucket)
    set(UI_SOURCE "")
    set(UI_SOURCE_DIR "")

    # Priority 1: Check for local build output
    set(LOCAL_UI_DIR "${PROJECT_SOURCE_DIR}/build/tools/ui/dist")

    # Verify all required assets exist before declaring local source valid
    set(ALL_ASSETS_PRESENT TRUE)
    foreach(asset ${PUBLIC_ASSETS})
        if(NOT EXISTS "${LOCAL_UI_DIR}/${asset}")
            set(ALL_ASSETS_PRESENT FALSE)
            break()
        endif()
    endforeach()

    if(ALL_ASSETS_PRESENT)
        set(UI_SOURCE "local")
        set(UI_SOURCE_DIR "${LOCAL_UI_DIR}")
        message(STATUS "UI: using local build from ${UI_SOURCE_DIR}")
    endif()

    # Priority 2: Build-time asset provisioning (npm build → HF Bucket fallback)
    if(NOT UI_SOURCE_DIR)
        # Environment variable takes precedence (e.g., from CI workflows)
        # Deprecated: use HF_UI_VERSION instead
        if(DEFINED ENV{HF_WEBUI_VERSION})
            set(HF_UI_VERSION "$ENV{HF_WEBUI_VERSION}")
            message(DEPRECATION "HF_WEBUI_VERSION env var is deprecated, use HF_UI_VERSION instead")
            if(NOT HF_UI_VERSION MATCHES "^[A-Za-z0-9._-]+$")
                message(FATAL_ERROR "UI: invalid HF_WEBUI_VERSION='${HF_UI_VERSION}' - must match ^[A-Za-z0-9._-]+$")
            endif()
        elseif(DEFINED ENV{HF_UI_VERSION})
            set(HF_UI_VERSION "$ENV{HF_UI_VERSION}")
            if(NOT HF_UI_VERSION MATCHES "^[A-Za-z0-9._-]+$")
                message(FATAL_ERROR "UI: invalid HF_UI_VERSION='${HF_UI_VERSION}' - must match ^[A-Za-z0-9._-]+$")
            endif()
        elseif(DEFINED LLAMA_BUILD_NUMBER)
            set(HF_UI_VERSION "b${LLAMA_BUILD_NUMBER}")
            message(STATUS "UI: derived HF_UI_VERSION=b${LLAMA_BUILD_NUMBER}")
        else()
            set(HF_UI_VERSION "")
            message(STATUS "UI: version not specified (will use HF 'latest')")
        endif()

        if("${HF_UI_VERSION}" STREQUAL "")
            set(UI_VERSION_TAG "provisioned")
        else()
            set(UI_VERSION_TAG "${HF_UI_VERSION}")
        endif()
        set(UI_STAMP "${CMAKE_CURRENT_BINARY_DIR}/.ui-${UI_VERSION_TAG}.stamp")

        string(REPLACE ";" "+" PUBLIC_ASSETS_JOINED "${PUBLIC_ASSETS}")

        add_custom_command(
            OUTPUT ${UI_STAMP}
            COMMAND ${CMAKE_COMMAND}
                "-DSOURCE_DIR=${PROJECT_SOURCE_DIR}"
                "-DPUBLIC_DIR=${PROJECT_SOURCE_DIR}/build/tools/ui/dist"
                "-DHF_BUCKET=${LLAMA_UI_HF_BUCKET}"
                "-DHF_VERSION=${HF_UI_VERSION}"
                "-DHF_ENABLED=${LLAMA_USE_PREBUILT_UI}"
                "-DASSETS=${PUBLIC_ASSETS_JOINED}"
                "-DSTAMP_FILE=${UI_STAMP}"
                "-DNPM_DIR=${PROJECT_SOURCE_DIR}/tools/ui"
                -P ${PROJECT_SOURCE_DIR}/scripts/ui-download.cmake
            COMMENT "Building/provisioning UI assets (npm build -> HF Bucket fallback)"
        )

        set(UI_SOURCE "provisioned")
        set(UI_SOURCE_DIR "${PROJECT_SOURCE_DIR}/build/tools/ui/dist")
    endif()

    # Process assets from the determined source
    if(UI_SOURCE_DIR)
        foreach(asset ${PUBLIC_ASSETS})
            set(input "${UI_SOURCE_DIR}/${asset}")
            set(output "${CMAKE_CURRENT_BINARY_DIR}/${asset}.hpp")
            list(APPEND TARGET_SRCS ${output})

            if(UI_SOURCE STREQUAL "local")
                if(NOT EXISTS "${input}")
                    message(FATAL_ERROR "UI asset not found: ${input}")
                endif()
                set(dependency "${input}")
            else()
                set(dependency "${UI_STAMP}")
            endif()

            add_custom_command(
                DEPENDS ${dependency}
                OUTPUT "${output}"
                COMMAND "${CMAKE_COMMAND}" "-DINPUT=${input}" "-DOUTPUT=${output}" -P "${PROJECT_SOURCE_DIR}/scripts/xxd.cmake"
            )
            set_source_files_properties(${output} PROPERTIES GENERATED TRUE)
        endforeach()

        list(APPEND UI_COMPILE_DEFS
            LLAMA_BUILD_UI
            LLAMA_UI_DEFAULT_ENABLED=1
        )
        message(STATUS "UI: embedded with source: ${UI_SOURCE}")
    else()
        message(WARNING "UI: no source available. Neither local build (build/tools/ui/dist/) nor HF Bucket download succeeded.")
        message(WARNING "UI: building server without embedded UI. Set LLAMA_BUILD_UI=OFF to suppress this warning.")
        list(APPEND UI_COMPILE_DEFS LLAMA_UI_DEFAULT_ENABLED=0)
    endif()
else()
    list(APPEND UI_COMPILE_DEFS LLAMA_UI_DEFAULT_ENABLED=0)
endif()

# Build the static library
add_library(${TARGET} STATIC ui.cpp)

target_include_directories(${TARGET} PUBLIC
    ${CMAKE_CURRENT_SOURCE_DIR}
    ${CMAKE_CURRENT_BINARY_DIR}
)

target_compile_definitions(${TARGET} PUBLIC ${UI_COMPILE_DEFS})

if(TARGET_SRCS)
    # List generated .hpp files as sources so CMake tracks them as build dependencies
    target_sources(${TARGET} PRIVATE ${TARGET_SRCS})
    set_source_files_properties(${TARGET_SRCS} PROPERTIES HEADER_FILE_ONLY TRUE)
endif()