subagent transcript

total 0
drwxr-xr-x 1 agent agent  246 Jul  5 12:44 .
drwxr-xr-x 1 agent agent 2268 Jul  5 12:41 ..
drwxr-xr-x 1 agent agent  104 Jul  5 12:47 build
drwxr-xr-x 1 agent agent  230 Jul  5 12:45 emscripten-crossbuild
drwxr-xr-x 1 agent agent  154 Jul  5 12:43 fc-pyside-usage
drwxr-xr-x 1 agent agent   24 Jul  5 12:49 poc-minimal
drwxr-xr-x 1 agent agent   86 Jul  5 12:41 py314-compat
drwxr-xr-x 1 agent agent  134 Jul  5 12:45 qt-nothread-typesystem
drwxr-xr-x 1 agent agent  160 Jul  5 12:43 shiboken  …[truncated]

1	# PySide6 / shiboken6 — Emscripten cross-compile toolchain for the FreeCAD wasm target
2	
3	**Scope (slug `emscripten-crossbuild`):** the emscripten toolchain setup to cross-compile
4	`libshiboken` + `libpyside` + the generated Qt bindings for wasm — the emcmake/toolchain-file
5	invocation, pointing at wasm CPython and wasm Qt, with the EXACT ABI flags FreeCAD uses. This is a
6	**split build**: the shiboken *generator* is a host (x86-64) tool; the runtime libs and bindings are
7	wasm. This doc  …[truncated]

1	# PySide6 / shiboken6 — static, no-dlopen binding build strategy (wasm)
2	
3	Scope slug: `static-nodlopen`. This is the crux item: turn PySide's normally-SHARED
4	Python extension modules into **STATIC archives** whose `PyInit_<Module>` symbols are
5	registered via `PyImport_AppendInittab` before `Py_Initialize()`, exactly like FreeCAD
6	already does for its own `Part`/`Sketcher`/… modules on wasm.
7	
8	Everything below is grounded in the real trees:
9	- PySide/shiboken source: `/tmp/pyside-se  …[truncated]

1	# PySide6/shiboken6 → FreeCAD-wasm: Minimal Proof-of-Concept & Validation Plan
2	
3	**Scope (this doc):** the smallest end-to-end pipeline that proves the whole PySide-on-wasm
4	approach, plus the two follow-on milestones. Everything below is grounded in the real trees and,
5	where noted, in commands actually run on 2026-07-05. See `files/CAPTURED-OUTPUT.txt` for raw output.
6	
7	**Slug:** `poc-minimal`. Sibling plans own the details this one only references:
8	`../qt-nothread-typesystem` (QtC  …[truncated]

1	# QtCore shiboken typesystem vs. Qt `-no-feature-thread` (wasm) — analysis & fix
2	
3	**Scope slug:** `qt-nothread-typesystem`
4	**Goal:** Make shiboken's QtCore typesystem bind cleanly against the wasm Qt, which is built
5	`-no-feature-thread` (`QT_FEATURE_thread == -1`, i.e. `QT_CONFIG(thread) == 0`), so that
6	`QThread/QMutex/QWaitCondition/QReadWriteLock/…` do not break generation or compilation.
7	
8	**Verdict (bottom line):** PySide 6.11 was **already designed** to build against a
9	`-no  …[truncated]

1	# Build the shiboken6 generator on the host — RESULT: SUCCESS (built + verified end-to-end)
2	
3	Scope: build the shiboken6 code generator (the HOST tool that parses Qt headers with
4	libclang and emits CPython C-extension source) with clang/llvm 21, host CPython 3.14.4,
5	host Qt 6.11.1 (gcc_64). This is the critical-path host tool for the whole PySide-wasm port.
6	
7	**Status: the generator builds cleanly and works end-to-end.** It produced real binding
8	source (with a `PyInit_*` entry poin  …[truncated]

1	# FreeCAD's exact PySide/shiboken API surface (minimal binding scope)
2	
3	Scope owner: `fc-pyside-usage`.
4	Goal: determine the MINIMAL set of Qt binding modules + shiboken functions FreeCAD-wasm
5	actually needs, so the PySide/shiboken wasm port binds only those (size is the constraint —
6	each Qt binding module is tens of MB, wasm is already ~196 MB).
7	
8	Everything below is grounded in the real tree:
9	- FreeCAD source: `/home/magik6k/lcad-wasm/freecad-port/FreeCAD` (branch `wasm-port`)
1  …[truncated]

1	# CPython 3.14 C-API compatibility for shiboken6 / PySide6 6.11
2	
3	**Scope:** Does shiboken6/PySide6 6.11 build against CPython 3.14? What C-API breakages
4	exist and what patches are needed?
5	
6	**Verdict: NO PATCHES NEEDED.** PySide/shiboken 6.11 (git branch `6.11`) already officially
7	targets and supports CPython 3.14. Every internals-heavy libshiboken translation unit
8	compiles clean against both host Python 3.14.4 headers (g++/llvm) and the wasm CPython 3.14
9	headers (emscripten em+  …[truncated]

1	--- a/sources/pyside6/cmake/Macros/PySideModules.cmake
2	+++ b/sources/pyside6/cmake/Macros/PySideModules.cmake
3	@@ -40,7 +40,14 @@ macro(append_size_optimization_flags _module_name)
4	         if ("${CMAKE_CXX_COMPILER_ID}" STREQUAL "MSVC")
5	             target_compile_options(${_module_name} PRIVATE /Gy /Gw /EHsc)
6	             target_link_options(${_module_name} PRIVATE LINKER:/OPT:REF)
7	         elseif ("${CMAKE_CXX_COMPILER_ID}" MATCHES "GNU|CLANG")
8	-            target_compile_optio  …[truncated]

1	# Drop-in for FreeCAD/src/Main/CMakeLists.txt (inside the existing `if(EMSCRIPTEN)` block,
2	# next to freecad_wasm_generate_inittab). Registers PySide/shiboken static binding archives
3	# on the interpreter inittab using their FULL DOTTED module names.
4	#
5	# The binding archives already export `extern "C" PyObject *PyInit_<leaf>()`
6	# (PyInit_QtCore, PyInit_QtGui, PyInit_Shiboken, ...). We must register them under the
7	# dotted import name so that `import PySide6.QtCore` and shiboken's in  …[truncated]

1	# pyside-wasm-toolchain.cmake
2	# -----------------------------------------------------------------------------
3	# CMake toolchain file for cross-compiling the PySide6/shiboken6 *runtime* libs
4	# (libshiboken, libpyside) and the generated Qt bindings for the FreeCAD
5	# WebAssembly target.
6	#
7	# It CHAIN-LOADS the stock Emscripten toolchain (which sets CMAKE_SYSTEM_NAME=
8	# Emscripten, CMAKE_CROSSCOMPILING=TRUE, and the emcc/em++ compilers) and then
9	# pins the exact ABI-defining flags t  …[truncated]

=== 0001-shiboken6 ===
--- a/sources/shiboken6/CMakeLists.txt
+++ b/sources/shiboken6/CMakeLists.txt
@@ -9,6 +9,25 @@ set(CMAKE_BUILD_TYPE Release CACHE STRING "Build Type")

 include(".cmake.conf")
 project(shiboken6)
+
+# WebAssembly port: no dynamic linking / no dlopen. Every SHARED/MODULE target
+# (libshiboken runtime + the shibokenmodule "Shiboken" C-extension) becomes a
+# static archive linked into the final FreeCAD executable and registered via
+# PyImport_AppendInittab. Mirrors FreeCAD  …[truncated]

File created successfully at: /home/magik6k/lcad-wasm/pyside-port/BUILD-PLAN.md (file state is current in your context — no need to Read it back)