CMakeLists.txt · 构建选项

option(KUI_3D_ZERO_COPY      "Enable zero-copy Filament→Skia texture sharing (Scheme A)" ON)

option(KUI_BUILD_3D_PHYSICS_DLL "Build kui_3d_physics as standalone DLL plugin" ON)

option(KUI_BUILD_3D_RENDER_DLL  "Build kui_3d_render as standalone DLL plugin"  ON)

option(KUI_BUILD_C_ABI      "Build the Windows-ready pure C ABI layer and tests" OFF)

option(KUI_BUILD_EXAMPLES   "Build example applications"       OFF)

option(KUI_BUILD_FUZZERS    "Build fuzz test harnesses (requires Clang+libFuzzer)" OFF)

option(KUI_BUILD_SHARED     "Build kui as shared library (DLL)" OFF)

option(KUI_BUILD_TESTS      "Build unit tests"                 ON)

option(KUI_BUILD_TOOLS      "Build developer tools (dump_analyzer, etc.)" ON)

option(KUI_DEBUG_LAYOUT_EQUIVALENCE_CHECK "R-04 Phase 5 / T-PERF-TOPOLOGY-PARTIAL-REBUILD (debug only): after every successful incremental layout pass, force a from-scratch full rebuild and compare the two box trees BOX BY BOX (structure, box type, geometry, overflow, baselines, resolved margin/padding/border, scrollbar reservation). Divergence prints the offending paths and aborts. Disabled by default (~3x layout cost per pass: the incremental pass plus two forced rebuilds) — enable on a separate debug/equivalence build directory to hunt incremental-vs-full divergence." OFF)

option(KUI_DEVTOOLS_PUBLIC_JSON "Expose token-bearing webSocketDebuggerUrl in DevTools /json and 302 redirect" ON)

option(KUI_DISABLE_MULTICOL "Disable CSS multi-column layout (ADR-001 D-02, OUT_OF_SCOPE)" ON)

option(KUI_DISABLE_SHAPES   "Disable CSS Shapes / polygon clip-path (ADR-001 D-03, OUT_OF_SCOPE)" ON)

option(KUI_DISABLE_SUBGRID  "Disable CSS Grid Subgrid (ADR-001 D-04, DEFERRED_TO_3.0)" ON)

option(KUI_ENABLE_3D_ENGINE  "Enable legacy in-tree 3D Runtime Engine (superseded by the kui-ext-3d extension)" OFF)

option(KUI_ENABLE_3D_PHYSICS "Enable legacy in-tree 3D Physics subsystem (Bullet)"                              OFF)

option(KUI_ENABLE_3D_RENDER  "Enable legacy in-tree 3D Rendering subsystem (Filament)"                          OFF)

option(KUI_ENABLE_DEPENDENCY_TRACKER  "R-13 Phase 4c: Use DependencyTracker for fine-grained style invalidation on class/id/attribute changes (OFF = legacy markSubtreeNeedsStyle path)." ON)

option(KUI_ENABLE_GPU       "Enable GPU-accelerated rendering" ON)

option(KUI_ENABLE_INCREMENTAL_LAYOUT  "R-04 Phase 5: Enable incremental layout fast paths (Clean-DOM short-circuit + per-pass dispatch fast-path + Phase 6 buildLayoutTree skip). OFF = always full rebuild every pass (legacy)." ON)

option(KUI_ENABLE_R06_INTRINSIC_SIZER "R-06: Use IntrinsicSizer unified intrinsic sizing pipeline for Flex/Grid/Block min/max-content (OFF = legacy code paths). Default flipped to ON in Phase 6 after bench + WPT parity." ON)

option(KUI_ENABLE_SCRIPTING "Enable embedded Lua scripting engine" ON)

option(KUI_ENABLE_WEBGL "Enable WebGL rendering context for <canvas>" ON)

option(KUI_GENERATE_PDB     "Generate PDB debug symbols for Release builds (MSVC)" OFF)

option(KUI_LAYOUT_DIAGNOSTICS "KUI-060 缺陷B / R-06: layout incremental-path diagnostics — per-dispatch miss-reason counters (recomputes the constraints hash, ~50ns/box) + env-gated LAYSUM/WALKTIME/MISMATCH/ICACHE dumps + the R06-D3 mismatch red-line test.  OFF = zero release overhead (counters compiled out)." OFF)

option(KUI_PDB_FASTLINK     "Use /DEBUG:FASTLINK instead of /DEBUG:FULL (faster link; PDB references .obj/.lib and is NOT redistributable). Requires KUI_GENERATE_PDB=ON." OFF)

option(KUI_STRICT_WARNINGS "Treat compiler warnings as errors (/WX, -Werror)" OFF)

option(KUI_USE_SKPARAGRAPH  "Use Skia Paragraph for text layout (HarfBuzz+ICU). OFF = legacy wrapText" ON)