Add KiCad PCBnew WASM build support and documentation

Build infrastructure:
- Update build-pcbnew.sh with stub library compilation
- Update build-wxuniversal-wasm.sh with library symlinks and stubs
- Add stub libraries for libgit2 and curl (network ops via JS)
- Add WASM-specific CMake Find modules

Documentation:
- Add KICAD_WASM_BUILD.md with complete modification list
- Document 68 KiCad files modified for WASM support
- Document disabled features and reasons
- Document stub libraries and wxWidgets changes

Submodule updates:
- kicad: Add WASM/Emscripten build support (wasm-port branch)
- wxwidgets: Add KiCad compatibility fixes

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

scripts/build-wxuniversal-wasm.sh

@@ -95,6 +95,27 @@ echo ""
 echo "=== Building wxWidgets ==="
 emmake make -j$(nproc 2>/dev/null || sysctl -n hw.ncpu)
 
+# Create library symlinks (remove -emscripten suffix for CMake compatibility)
+echo ""
+echo "=== Creating library symlinks ==="
+cd "$BUILD_DIR/lib"
+for lib in *-emscripten.a; do
+    if [ -f "$lib" ]; then
+        newname="${lib/-emscripten/}"
+        ln -sf "$lib" "$newname"
+    fi
+done
+
+# Create stub libraries for components wx-config reports but we didn't build
+# KiCad doesn't use these directly
+echo "Creating stub libraries..."
+for stub in richtext webview; do
+    emar rcs "libwx_wasmunivu_${stub}-3.2.a"
+    ln -sf "libwx_wasmunivu_${stub}-3.2.a" "libwx_wasmunivu_${stub}-3.2-emscripten.a"
+done
+
+cd "$BUILD_DIR"
+
 echo ""
 echo "=== Build complete ==="
 ls -lh "$BUILD_DIR"/lib/*.a 2>/dev/null || echo "Libraries built in $BUILD_DIR/lib"

scripts/deps/build-boost.sh

@@ -57,10 +57,10 @@ log_info "Building Boost ${BOOST_VERSION} for WASM..."
 
 cd "${BOOST_DIR}"
 
-# Bootstrap b2 if needed
+# Bootstrap b2 if needed (use gcc for native build of b2)
 if [ ! -f "b2" ]; then
     log_info "Bootstrapping b2..."
-    ./bootstrap.sh --with-toolset=clang
+    ./bootstrap.sh --with-toolset=gcc
 fi
 
 # Create user-config.jam for Emscripten

scripts/deps/build-cairo.sh

@@ -78,6 +78,9 @@ sys_root = '${SYSROOT}'
 pkg_config_libdir = '${SYSROOT}/lib/pkgconfig'
 
 [built-in options]
+default_library = 'static'
+b_staticpic = false
+b_pie = false
 c_args = ['-pthread', '-I${SYSROOT}/include', '-I${SYSROOT}/include/freetype2', '-I${SYSROOT}/include/pixman-1']
 c_link_args = ['-pthread', '-L${SYSROOT}/lib']
 pkg_config_path = '${SYSROOT}/lib/pkgconfig'
@@ -101,7 +104,9 @@ meson setup "${CAIRO_DIR}" \
     -Dzlib=enabled \
     -Dtests=disabled \
     -Dspectre=disabled \
-    -Dsymbol-lookup=disabled
+    -Dsymbol-lookup=disabled \
+    -Dfreetype2:default_library=static \
+    -Dlibpng:default_library=static
 
 JOBS=${JOBS:-$(sysctl -n hw.ncpu 2>/dev/null || nproc 2>/dev/null || echo 4)}
 ninja -j${JOBS}

scripts/deps/build-ngspice.sh

@@ -58,15 +58,18 @@ export CFLAGS="-pthread"
 export CXXFLAGS="-pthread"
 export LDFLAGS="-pthread"
 
-# Configure ngspice as a shared library for KiCad integration
+# Configure ngspice as a static library for WASM
+# Note: --with-ngshared requires shared libs which WASM doesn't support
+# We build static lib instead
 emconfigure "${NGSPICE_DIR}/configure" \
     --prefix="${SYSROOT}" \
     --host=wasm32-unknown-emscripten \
     --build=$(uname -m)-linux-gnu \
-    --enable-shared \
-    --with-ngshared \
+    --disable-shared \
+    --enable-static \
     --disable-debug \
     --disable-dependency-tracking \
+    --disable-openmp \
     --enable-cider \
     --enable-xspice \
     --without-x \

scripts/kicad/build-pcbnew.sh

@@ -85,6 +85,38 @@ fi
 mkdir -p "${KICAD_BUILD}"
 cd "${KICAD_BUILD}"
 
+# Step 6.1: Build stub libraries for missing symbols
+STUBS_DIR="${PROJECT_ROOT}/wasm/stubs"
+STUBS_BUILD="${BUILD_ROOT}/stubs"
+mkdir -p "${STUBS_BUILD}"
+
+log_info "Building stub libraries..."
+# Compile libgit2 stub
+emcc -c "${STUBS_DIR}/libgit2_stub.c" -o "${STUBS_BUILD}/libgit2_stub.o"
+emar rcs "${STUBS_BUILD}/libgit2_stub.a" "${STUBS_BUILD}/libgit2_stub.o"
+
+# Compile curl stub
+emcc -c "${STUBS_DIR}/curl_stub.c" -o "${STUBS_BUILD}/curl_stub.o"
+emar rcs "${STUBS_BUILD}/libcurl_stub.a" "${STUBS_BUILD}/curl_stub.o"
+
+log_info "Stub libraries built"
+
+# Step 6.5: Verify WASM support is in KiCad fork
+# The kicad submodule should already have WASM port detection and kiplatform support
+KICAD_CMAKE="${KICAD_DIR}/CMakeLists.txt"
+if ! grep -q "msw|qt|gtk|osx|wasm" "${KICAD_CMAKE}"; then
+    log_error "KiCad fork is missing WASM port detection support."
+    log_error "Please ensure the kicad submodule has WASM modifications."
+    exit 1
+fi
+KIPLATFORM_CMAKE="${KICAD_DIR}/libs/kiplatform/CMakeLists.txt"
+if ! grep -q "KICAD_WX_PORT STREQUAL wasm" "${KIPLATFORM_CMAKE}"; then
+    log_error "KiCad fork is missing kiplatform WASM support."
+    log_error "Please ensure the kicad submodule has WASM modifications."
+    exit 1
+fi
+log_info "KiCad WASM support verified"
+
 # Step 7: Configure KiCad with CMake
 # We use CMAKE_MODULE_PATH to inject our compatibility layer
 log_info "Configuring KiCad with CMake..."
@@ -92,19 +124,16 @@ emcmake cmake "${KICAD_DIR}" \
     -DCMAKE_BUILD_TYPE=${BUILD_TYPE} \
     -DCMAKE_INSTALL_PREFIX="${SYSROOT}" \
     -DCMAKE_MODULE_PATH="${WASM_LAYER}/cmake" \
+    -DSYSROOT="${SYSROOT}" \
     -DCMAKE_POLICY_VERSION_MINIMUM=3.5 \
-    -DCMAKE_CXX_FLAGS="${EXTRA_FLAGS} -pthread -DKICAD_USE_PLATFORM_WASM=1 -I${SYSROOT}/include" \
-    -DCMAKE_C_FLAGS="${EXTRA_FLAGS} -pthread -I${SYSROOT}/include" \
-    -DCMAKE_EXE_LINKER_FLAGS="-pthread -sASYNCIFY=1 -sASYNCIFY_STACK_SIZE=65536 -sUSE_PTHREADS=1 -sPTHREAD_POOL_SIZE=4 -sALLOW_MEMORY_GROWTH=1 -sINITIAL_MEMORY=256MB -sMAXIMUM_MEMORY=4GB -L${SYSROOT}/lib" \
+    -DCMAKE_CXX_FLAGS="${EXTRA_FLAGS} -pthread -sUSE_ZLIB=1 -DKICAD_USE_PLATFORM_WASM=1 -I${SYSROOT}/include" \
+    -DCMAKE_C_FLAGS="${EXTRA_FLAGS} -pthread -sUSE_ZLIB=1 -I${SYSROOT}/include" \
+    -DCMAKE_EXE_LINKER_FLAGS="-pthread -sUSE_ZLIB=1 -sASYNCIFY=1 -sASYNCIFY_STACK_SIZE=65536 -sUSE_PTHREADS=1 -sPTHREAD_POOL_SIZE=4 -sALLOW_MEMORY_GROWTH=1 -sINITIAL_MEMORY=256MB -sMAXIMUM_MEMORY=4GB -L${SYSROOT}/lib ${STUBS_BUILD}/libgit2_stub.a ${STUBS_BUILD}/libcurl_stub.a" \
     -DCMAKE_PREFIX_PATH="${SYSROOT};${WX_BUILD}" \
     -DwxWidgets_CONFIG_EXECUTABLE="${WX_BUILD}/wx-config" \
     \
     -DKICAD_BUILD_QA_TESTS=OFF \
-    -DKICAD_SCRIPTING=OFF \
-    -DKICAD_SCRIPTING_PYTHON3=OFF \
-    -DKICAD_SCRIPTING_WXPYTHON=OFF \
     -DKICAD_SPICE=OFF \
-    -DKICAD_USE_OCC=OFF \
     -DKICAD_USE_EGL=OFF \
     -DKICAD_USE_BUNDLED_GLEW=ON \
     \
@@ -112,6 +141,26 @@ emcmake cmake "${KICAD_DIR}" \
     -DZSTD_INCLUDE_DIR="${SYSROOT}/include" \
     -DZSTD_LIBRARY="${SYSROOT}/lib/libzstd.a" \
     -DGLM_INCLUDE_DIR="${SYSROOT}/include" \
+    -DBOOST_ROOT="${SYSROOT}" \
+    -DBoost_INCLUDE_DIR="${SYSROOT}/include" \
+    -DBoost_LIBRARY_DIR="${SYSROOT}/lib" \
+    -DBoost_NO_SYSTEM_PATHS=ON \
+    -DBoost_NO_BOOST_CMAKE=ON \
+    -DFREETYPE_INCLUDE_DIR_ft2build="${SYSROOT}/include/freetype2" \
+    -DFREETYPE_INCLUDE_DIR_freetype2="${SYSROOT}/include/freetype2" \
+    -DFREETYPE_LIBRARY="${SYSROOT}/lib/libfreetype.a" \
+    -DHarfBuzz_INCLUDE_DIR="${SYSROOT}/include/harfbuzz" \
+    -DHarfBuzz_LIBRARY="${SYSROOT}/lib/libharfbuzz.a" \
+    -DOCC_INCLUDE_DIR="${SYSROOT}/include/opencascade" \
+    -DOCC_LIBRARY_DIR="${SYSROOT}/lib" \
+    -DProtobuf_INCLUDE_DIR="${SYSROOT}/include" \
+    -DProtobuf_LIBRARY="${SYSROOT}/lib/libprotobuf.a" \
+    -DProtobuf_LITE_LIBRARY="${SYSROOT}/lib/libprotobuf-lite.a" \
+    -DODBC_CONFIG:STRING="stub-for-wasm" \
+    -DODBCLIB:STRING="" \
+    -DODBC_CFLAGS:STRING="" \
+    -DODBC_LINK_FLAGS:STRING="" \
+    -DODBC_LIBRARIES:STRING="" \
     \
     -DBUILD_GITHUB_PLUGIN=OFF \
     -DKICAD_PCM=OFF