pcbjam/scripts/common/env.sh

#!/bin/bash
# Environment setup for KiCad WASM build scripts

# Get script and project directories using unique names to avoid conflicts
_KICAD_WASM_COMMON_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
_KICAD_WASM_SCRIPTS_DIR="$(dirname "$_KICAD_WASM_COMMON_DIR")"
_KICAD_WASM_PROJECT_ROOT="$(dirname "$_KICAD_WASM_SCRIPTS_DIR")"

# Export paths
export PROJECT_ROOT="$_KICAD_WASM_PROJECT_ROOT"
export SCRIPTS_DIR="$_KICAD_WASM_SCRIPTS_DIR"
export COMMON_DIR="$_KICAD_WASM_COMMON_DIR"

# Use our config.sub wrapper for autoconf projects (emconfigure)
# This intercepts config.sub calls to use our version with emscripten/wasm32 support
# CONFIG_SHELL is critical: nested configures do SHELL=${CONFIG_SHELL-/bin/sh}
export SHELL="$SCRIPTS_DIR/config/config-sub-wrapper.sh"
export CONFIG_SHELL="$SCRIPTS_DIR/config/config-sub-wrapper.sh"

# Build output directories (inside the project)
export BUILD_ROOT="$PROJECT_ROOT/build-wasm"
export DEPS_ROOT="$BUILD_ROOT/deps"
export SYSROOT="$BUILD_ROOT/sysroot"
export STAMPS_DIR="$BUILD_ROOT/stamps"

# Source directories
export KICAD_SOURCE="$PROJECT_ROOT/kicad"
export WXWIDGETS_SOURCE="$PROJECT_ROOT/wxwidgets"
export WASM_COMPAT="$PROJECT_ROOT/wasm"
export STUBS_DIR="$PROJECT_ROOT/stubs"
export CMAKE_MODULES="$PROJECT_ROOT/cmake"

# wxWidgets build location
export WX_BUILD="$BUILD_ROOT/wxwidgets-universal"

# Emscripten settings
export EMSDK_QUIET=1

# Homebrew Emscripten configuration
# The em++ script uses EMSDK_PYTHON (not PYTHON env var) for the Python interpreter
# and finds clang via PATH - Emscripten bundles its own LLVM with WebAssembly support
if [[ -d "/opt/homebrew/Cellar/emscripten" ]]; then
    _EM_VERSION=$(ls /opt/homebrew/Cellar/emscripten/ | sort -V | tail -1)
    _EM_LLVM_BIN="/opt/homebrew/Cellar/emscripten/$_EM_VERSION/libexec/llvm/bin"
    if [[ -d "$_EM_LLVM_BIN" ]]; then
        # Add bundled LLVM to PATH so Emscripten finds its clang (not /usr/bin/clang)
        export PATH="$_EM_LLVM_BIN:$PATH"
    fi
elif [[ -d "/usr/local/Cellar/emscripten" ]]; then
    _EM_VERSION=$(ls /usr/local/Cellar/emscripten/ | sort -V | tail -1)
    _EM_LLVM_BIN="/usr/local/Cellar/emscripten/$_EM_VERSION/libexec/llvm/bin"
    if [[ -d "$_EM_LLVM_BIN" ]]; then
        export PATH="$_EM_LLVM_BIN:$PATH"
    fi
fi

# Emscripten 4.0.22+ requires Python 3.10+ (uses match statement and type union syntax)
# The em++ shell script checks EMSDK_PYTHON first, then falls back to `which python3`
# Set EMSDK_PYTHON to Homebrew's Python to ensure correct version is used
if [[ -d "/opt/homebrew/opt/python@3.14/bin" ]]; then
    export EMSDK_PYTHON="/opt/homebrew/opt/python@3.14/bin/python3.14"
elif [[ -d "/opt/homebrew/opt/python@3.13/bin" ]]; then
    export EMSDK_PYTHON="/opt/homebrew/opt/python@3.13/bin/python3.13"
elif [[ -d "/opt/homebrew/opt/python@3.12/bin" ]]; then
    export EMSDK_PYTHON="/opt/homebrew/opt/python@3.12/bin/python3.12"
elif [[ -d "/opt/homebrew/opt/python@3.11/bin" ]]; then
    export EMSDK_PYTHON="/opt/homebrew/opt/python@3.11/bin/python3.11"
elif [[ -d "/opt/homebrew/opt/python@3.10/bin" ]]; then
    export EMSDK_PYTHON="/opt/homebrew/opt/python@3.10/bin/python3.10"
elif [[ -d "/usr/local/opt/python@3.14/bin" ]]; then
    export EMSDK_PYTHON="/usr/local/opt/python@3.14/bin/python3.14"
elif [[ -d "/usr/local/opt/python@3.13/bin" ]]; then
    export EMSDK_PYTHON="/usr/local/opt/python@3.13/bin/python3.13"
elif [[ -d "/usr/local/opt/python@3.12/bin" ]]; then
    export EMSDK_PYTHON="/usr/local/opt/python@3.12/bin/python3.12"
elif [[ -d "/usr/local/opt/python@3.11/bin" ]]; then
    export EMSDK_PYTHON="/usr/local/opt/python@3.11/bin/python3.11"
elif [[ -d "/usr/local/opt/python@3.10/bin" ]]; then
    export EMSDK_PYTHON="/usr/local/opt/python@3.10/bin/python3.10"
fi

# Common compiler flags
export EMCC_CFLAGS="-fPIC -DEMSCRIPTEN"
export EMCC_CXXFLAGS="-fPIC -DEMSCRIPTEN -std=c++17"

# Use ccache if available for faster rebuilds
if command -v ccache &> /dev/null; then
    export CC="ccache emcc"
    export CXX="ccache em++"
fi

# Debug mode (default: ON, use --release to disable)
# This can be overridden by setting DEBUG_BUILD=0 before sourcing this file
DEBUG_BUILD="${DEBUG_BUILD:-1}"

if [ "$DEBUG_BUILD" = "1" ]; then
    export BUILD_TYPE="Debug"
    export DEBUG_CFLAGS="-g -O1"
    export DEBUG_LDFLAGS="-g -gsource-map"
else
    export BUILD_TYPE="Release"
    export DEBUG_CFLAGS="-O2"
    export DEBUG_LDFLAGS=""
fi

export DEBUG_BUILD BUILD_TYPE DEBUG_CFLAGS DEBUG_LDFLAGS

# Parallel jobs (default to 1 for memory-constrained environments like Docker)
# Can be overridden with -j N flag or by setting JOBS/PARALLEL_JOBS env vars
if [ -n "$PARALLEL_JOBS" ]; then
    export JOBS="$PARALLEL_JOBS"
elif [ -z "$JOBS" ]; then
    # Default to 1 for sequential builds (safer for memory)
    # Use -j N to override for faster builds on machines with more RAM
    export JOBS=1
fi

# Common linker flags for WASM
export WASM_LDFLAGS="\
-sALLOW_MEMORY_GROWTH=1 \
-sINITIAL_MEMORY=256MB \
-sSTACK_SIZE=5MB \
-sASYNCIFY=1 \
-sASYNCIFY_STACK_SIZE=16384 \
-sLEGACY_GL_EMULATION \
-sMAX_WEBGL_VERSION=2"

# Threading flags (when enabled)
export PTHREAD_LDFLAGS="\
-pthread \
-sPROXY_TO_PTHREAD=1 \
-sPTHREAD_POOL_SIZE=navigator.hardwareConcurrency \
-sOFFSCREENCANVAS_SUPPORT=1"

# Create output directories
mkdir -p "$BUILD_ROOT" "$DEPS_ROOT" "$SYSROOT"/{lib,include,share} "$STAMPS_DIR"

# Source other common files
source "$COMMON_DIR/versions.sh"
source "$COMMON_DIR/functions.sh"

# Print environment info (only if not in quiet mode)
if [ "${QUIET:-0}" != "1" ]; then
    echo "KiCad WASM Build Environment"
    echo "  Project root: $PROJECT_ROOT"
    echo "  Build root:   $BUILD_ROOT"
    echo "  Sysroot:      $SYSROOT"
fi