\n#endif\n\n#ifdef _WIN32\nint WINAPI WinMain(HINSTANCE hInst, HINSTANCE hPrevInst, LPSTR lpCmdLine,\n int nCmdShow) {\n (void)hInst;\n (void)hPrevInst;\n (void)lpCmdLine;\n (void)nCmdShow;\n#else\nint main(void) {\n#endif\n webview_t w = webview_create(0, NULL);\n webview_set_title(w, \"Basic Example\");\n webview_set_size(w, 480, 320, WEBVIEW_HINT_NONE);\n webview_set_html(w, \"Thanks for using webview!\");\n webview_run(w);\n webview_destroy(w);\n return 0;\n}\n```\n\n### Building the Example\n\nBuild the project:\n\n```sh\ncmake -G Ninja -B build -S . -D CMAKE_BUILD_TYPE=Release\ncmake --build build\n```\n\nFind the executable in the `build/bin` directory.\n\n### Building Amalgamated Library\n\nAn amalgamated library can be built when building the project using CMake, or the `amalgamate.py` script can be invoked directly.\n\nThe latter is described below.\n\n```sh\npython3 scripts/amalgamate/amalgamate.py --base core --search include --output webview_amalgamation.h src\n```\n\nSee `python3 scripts/amalgamate/amalgamate.py --help` for script usage.\n\n### Non-CMake Usage\n\nHere's an example for invoking GCC/Clang-like compilers directly. Use the `main.cc` file from the previous example.\n\nPlace either the amalgamated `webview.h` header or all of the individual files into `libs/webview`, and `WebView2.h` from [MS WebView2][ms-webview2-sdk] into `libs`.\n\nBuild the project on your chosen platform.\n\n\n macOS
\n c++ main.cc -O2 --std=c++11 -Ilibs -framework WebKit -ldl -o example
\n \n\n\n Linux
\n c++ main.cc -O2 --std=c++11 -Ilibs $(pkg-config --cflags --libs gtk+-3.0 webkit2gtk-4.1) -ldl -o example
\n \n\n\n Windows
\n c++ main.cc -O2 --std=c++14 -static -mwindows -Ilibs -ladvapi32 -lole32 -lshell32 -lshlwapi -luser32 -lversion -o example
\n \n\n## Customization\n\n### CMake Targets\n\nThe following CMake targets are available:\n\nName | Description\n---- | -----------\n`webview::core` | Headers for C++.\n`webview::core_shared` | Shared library for C.\n`webview::core_static` | Static library for C.\n\nSpecial targets for on-demand checks and related tasks:\n\nName | Description\n---- | -----------\n`webview_format_check` | Check files with clang-format.\n`webview_reformat` | Reformat files with clang-format.\n\n### CMake Options\n\nThe following boolean options can be used when building the webview project standalone or when building it as part of your project (e.g. with FetchContent).\n\nOption | Description\n------ | -----------\n`WEBVIEW_BUILD` | Enable building\n`WEBVIEW_BUILD_AMALGAMATION` | Build amalgamated library\n`WEBVIEW_BUILD_DOCS` | Build documentation\n`WEBVIEW_BUILD_EXAMPLES` | Build examples\n`WEBVIEW_BUILD_SHARED_LIBRARY` | Build shared libraries\n`WEBVIEW_BUILD_STATIC_LIBRARY` | Build static libraries\n`WEBVIEW_BUILD_TESTS` | Build tests\n`WEBVIEW_ENABLE_CHECKS` | Enable checks\n`WEBVIEW_ENABLE_CLANG_FORMAT` | Enable clang-format\n`WEBVIEW_ENABLE_CLANG_TIDY` | Enable clang-tidy\n`WEBVIEW_ENABLE_PACKAGING` | Enable packaging\n`WEBVIEW_INSTALL_DOCS` | Install documentation\n`WEBVIEW_INSTALL_TARGETS` | Install targets\n`WEBVIEW_IS_CI` | Initialized by the `CI` environment variable\n`WEBVIEW_PACKAGE_AMALGAMATION` | Package amalgamated library\n`WEBVIEW_PACKAGE_DOCS` | Package documentation\n`WEBVIEW_PACKAGE_HEADERS` | Package headers\n`WEBVIEW_PACKAGE_LIB` | Package compiled libraries\n`WEBVIEW_STRICT_CHECKS` | Make checks strict\n`WEBVIEW_STRICT_CLANG_FORMAT` | Make clang-format check strict\n`WEBVIEW_STRICT_CLANG_TIDY` | Make clang-tidy check strict\n`WEBVIEW_USE_COMPAT_MINGW` | Use compatibility helper for MinGW\n`WEBVIEW_USE_STATIC_MSVC_RUNTIME` | Use static runtime library (MSVC)\n\n> [!NOTE]\n> Checks are *enabled* by default, but aren't *enforced* by default for local development (controlled by the `WEBVIEW_IS_CI` option).\n\nNon-boolean options:\n\nOption | Description\n------ | -----------\n`WEBVIEW_CLANG_FORMAT_EXE` | Path of the `clang-format` executable.\n`WEBVIEW_CLANG_TIDY_EXE` | Path of the `clang-tidy` executable.\n\n### Package Consumer Options\n\nThese options can be used when when using the webview CMake package.\n\n#### Linux-specific Options\n\nOption | Description\n------ | -----------\n`WEBVIEW_WEBKITGTK_API` | WebKitGTK API to interface with, e.g. `6.0`, `4.1` (recommended) or `4.0`. This will also automatically decide the GTK version. Uses the latest recommended API by default if available, or the latest known and available API. Note that there can be major differences between API versions that can affect feature availability. See webview API documentation for details on feature availability.\n\n#### Windows-specific Options\n\nOption | Description\n------ | -----------\n`WEBVIEW_MSWEBVIEW2_VERSION` | MS WebView2 version, e.g. `1.0.1150.38`.\n`WEBVIEW_USE_BUILTIN_MSWEBVIEW2`| Use built-in MS WebView2.\n\n### Compile-time Options\n\nThese options can be specified as preprocessor macros to modify the build, but are not needed when using CMake.\n\n#### C API Linkage\n\nName | Description\n---- | -----------\n`WEBVIEW_API` | Controls C API linkage, symbol visibility and whether it's a shared library. By default this is `inline` for C++ and `extern` for C.\n`WEBVIEW_BUILD_SHARED` | Modifies `WEBVIEW_API` for building a shared library.\n`WEBVIEW_SHARED` | Modifies `WEBVIEW_API` for using a shared library.\n`WEBVIEW_STATIC` | Modifies `WEBVIEW_API` for building or using a static library.\n\n#### Backend Selection\n\nName | Description\n---- | -----------\n`WEBVIEW_GTK` | Compile the GTK/WebKitGTK backend.\n`WEBVIEW_COCOA` | Compile the Cocoa/WebKit backend.\n`WEBVIEW_EDGE` | Compile the Win32/WebView2 backend.\n\n#### Windows-specific Options\n\nOption | Description\n------ | -----------\n`WEBVIEW_MSWEBVIEW2_BUILTIN_IMPL` | Enables (`1`) or disables (`0`) the built-in implementation of the WebView2 loader. Enabling this avoids the need for `WebView2Loader.dll` but if the DLL is present then the DLL takes priority. This option is enabled by default.\n`WEBVIEW_MSWEBVIEW2_EXPLICIT_LINK`| Enables (`1`) or disables (`0`) explicit linking of `WebView2Loader.dll`. Enabling this avoids the need for import libraries (`*.lib`). This option is enabled by default if `WEBVIEW_MSWEBVIEW2_BUILTIN_IMPL` is enabled.\n\n## MinGW-w64 Requirements\n\nIn order to build this library using MinGW-w64 on Windows then it must support C++14 and have an up-to-date Windows SDK.\n\nDistributions that are known to be compatible:\n\n* [LLVM MinGW](https://github.com/mstorsjo/llvm-mingw)\n* [MSYS2](https://www.msys2.org/)\n* [WinLibs](https://winlibs.com/)\n\n## MS WebView2 Loader\n\nLinking the WebView2 loader part of the Microsoft WebView2 SDK is not a hard requirement when using our webview library, and neither is distributing `WebView2Loader.dll` with your app.\n\nIf, however, `WebView2Loader.dll` is loadable at runtime, e.g. from the executable's directory, then it will be used; otherwise our minimalistic implementation will be used instead.\n\nShould you wish to use the official loader then remember to distribute it along with your app unless you link it statically. Linking it statically is possible with Visual C++ but not MinGW-w64.\n\nHere are some of the noteworthy ways our implementation of the loader differs from the official implementation:\n\n* Does not support configuring WebView2 using environment variables such as `WEBVIEW2_BROWSER_EXECUTABLE_FOLDER`.\n* Microsoft Edge Insider (preview) channels are not supported.\n\n[Customization options](#Customization) can be used to change how the library integrates the WebView2 loader.\n\n## Thread Safety\n\nSince library functions generally do not have thread safety guarantees, `webview_dispatch()` (C) / `webview::dispatch()` (C++) can be used to schedule code to execute on the main/GUI thread and thereby make that execution safe in multi-threaded applications.\n\n`webview_return()` (C) / `webview::resolve()` (C++) uses `*dispatch()` internally and is therefore safe to call from another thread.\n\nThe main/GUI thread should be the thread that calls `webview_run()` (C) / `webview::run()` (C++).\n\n## Development\n\nThis project uses the CMake build system.\n\n### Development Dependencies\n\nIn addition to the dependencies mentioned earlier in this document for developing *with* the webview library, the following are used during development *of* the webview library.\n\n* Amalgamation:\n * Python >= 3.9\n* Checks:\n * `clang-format`\n * `clang-tidy`\n* Documentation:\n * Doxygen\n * Graphvis\n\n### Building\n\n```sh\ncmake -G \"Ninja Multi-Config\" -B build -S .\ncmake --build build --config CONFIG\n```\n\nReplace `CONFIG` with one of `Debug`, `Release`, or `Profile`. Use `Profile` to enable code coverage (GCC/Clang).\n\nRun tests:\n\n```sh\nctest --test-dir build --build-config CONFIG\n```\n\nGenerate test coverage report:\n\n```sh\ngcovr\n```\n\nFind the coverage report in `build/coverage`.\n\n### Packaging\n\nRun this after building the `Debug` and `Release` configs of the project:\n\n```sh\ncd build\ncpack -G External -C \"Debug;Release\" --config CPackConfig.cmake\n```\n\n### Cross-compilation\n\nSee CMake toolchain files in the `cmake/toolchains` directory.\n\nFor example, this targets Windows x64 on Linux with POSIX threads:\n\n```sh\ncmake -G \"Ninja Multi-Config\" -B build -S . -D CMAKE_TOOLCHAIN_FILE=cmake/toolchains/x86_64-w64-mingw32.cmake -D WEBVIEW_TOOLCHAIN_EXECUTABLE_SUFFIX=-posix\ncmake --build build --config CONFIG\n```\n\n## Limitations\n\n### Browser Features\n\nSince a browser engine is not a full web browser it may not support every feature you may expect from a browser. If you find that a feature does not work as expected then please consult with the browser engine's documentation and [open an issue][issues-new] if you think that the library should support it.\n\nFor example, the library does not attempt to support user interaction features like `alert()`, `confirm()` and `prompt()` and other non-essential features like `console.log()`.\n\n## Bindings\n\nLanguage | Project\n---------- | -------\nAda | [thechampagne/webview-ada](https://github.com/thechampagne/webview-ada)\nBun | [tr1ckydev/webview-bun](https://github.com/tr1ckydev/webview-bun)\nC# | [webview/webview_csharp](https://github.com/webview/webview_csharp)\nC3 | [thechampagne/webview-c3](https://github.com/thechampagne/webview-c3)\nCrystal | [naqvis/webview](https://github.com/naqvis/webview)\nD | [thechampagne/webview-d](https://github.com/thechampagne/webview-d), [ronnie-w/webviewd](https://github.com/ronnie-w/webviewd)\nDeno | [webview/webview_deno](https://github.com/webview/webview_deno)\nGo | [webview/webview_go][webview_go]\nHarbour | [EricLendvai/Harbour_WebView](https://github.com/EricLendvai/Harbour_WebView)\nHaskell | [lettier/webviewhs](https://github.com/lettier/webviewhs)\nJanet | [janet-lang/webview](https://github.com/janet-lang/webview)\nJava | [webview/webview_java](https://github.com/webview/webview_java)\nKotlin | [Winterreisender/webviewko](https://github.com/Winterreisender/webviewko)\nMoonBit | [justjavac/moonbit-webview](https://github.com/justjavac/moonbit-webview)\nNim | [oskca/webview](https://github.com/oskca/webview), [neroist/webview](https://github.com/neroist/webview)\nNode.js | [Winterreisender/webview-nodejs](https://github.com/Winterreisender/webview-nodejs)\nOdin | [thechampagne/webview-odin](https://github.com/thechampagne/webview-odin)\nPascal | [PierceNg/fpwebview](http://github.com/PierceNg/fpwebview)\nPython | [congzhangzh/webview_python](https://github.com/congzhangzh/webview_python),[zserge/webview-python](https://github.com/zserge/webview-python)\nPHP | [0hr/php-webview](https://github.com/0hr/php-webview), [KingBes/pebview](https://github.com/KingBes/pebview), [happystraw/php-ext-webview](https://github.com/happystraw/php-ext-webview)\nRing | [ysdragon/webview](https://github.com/ysdragon/webview)\nRuby | [Maaarcocr/webview_ruby](https://github.com/Maaarcocr/webview_ruby)\nRust | [Boscop/web-view](https://github.com/Boscop/web-view)\nSwift | [jakenvac/SwiftWebview](https://github.com/jakenvac/SwiftWebview)\nV | [malisipi/mui](https://github.com/malisipi/mui/tree/main/webview), [ttytm/webview](https://github.com/ttytm/webview)\nVala | [taozuhong/webview-vala](https://github.com/taozuhong/webview-vala)\nZig | [thechampagne/webview-zig](https://github.com/thechampagne/webview-zig), [happystraw/zig-webview](https://github.com/happystraw/zig-webview)\n\nIf you wish to add bindings to the list, feel free to submit a pull request or [open an issue][issues-new].\n\n## Generating Bindings\n\nYou can generate bindings for the library by yourself using the included SWIG interface (`webview.i`).\n\nHere are some examples to get you started. Unix-style command lines are used for conciseness.\n\n```sh\nmkdir -p build/bindings/{python,csharp,java,ruby}\nswig -c++ -python -outdir build/bindings/python -o build/bindings/python/python_wrap.cpp webview.i\nswig -c++ -csharp -outdir build/bindings/csharp -o build/bindings/csharp/csharp_wrap.cpp webview.i\nswig -c++ -java -outdir build/bindings/java -o build/bindings/java/java_wrap.cpp webview.i\nswig -c++ -ruby -outdir build/bindings/ruby -o build/bindings/ruby/ruby_wrap.cpp webview.i\n```\n\n## License\n\nCode is distributed under MIT license, feel free to use it in your proprietary projects as well.\n\n[examples]: https://github.com/webview/webview/tree/master/examples\n[gtk]: https://gtk.org/\n[issues]: https://github.com/webview/docs/issues\n[issues-new]: https://github.com/webview/webview/issues/new\n[webkit]: https://webkit.org/\n[webkitgtk]: https://webkitgtk.org/\n[webview]: https://github.com/webview/webview\n[webview_go]: https://github.com/webview/webview_go\n[webview.dev]: https://webview.dev\n[ms-webview2]: https://developer.microsoft.com/en-us/microsoft-edge/webview2/\n[ms-webview2-sdk]: https://www.nuget.org/packages/Microsoft.Web.WebView2\n[ms-webview2-rt]: https://developer.microsoft.com/en-us/microsoft-edge/webview2/\n[win32-api]: https://docs.microsoft.com/en-us/windows/win32/apiindex/windows-api-list\n"
},
{
"path": "cmake/clang_format.cmake",
"content": "file(TO_CMAKE_PATH \"${BINARY_DIR}\" BINARY_DIR)\nfile(TO_CMAKE_PATH \"${SOURCE_DIR}\" SOURCE_DIR)\n\nfile(GLOB_RECURSE TEMP_FILES\n ${SOURCE_DIR}/*.h\n ${SOURCE_DIR}/*.hh\n ${SOURCE_DIR}/*.hpp\n ${SOURCE_DIR}/*.hxx\n ${SOURCE_DIR}/*.c\n ${SOURCE_DIR}/*.cc\n ${SOURCE_DIR}/*.cpp\n ${SOURCE_DIR}/*.cxx)\n\nset(FILES)\nforeach(FILE IN LISTS TEMP_FILES)\n file(TO_CMAKE_PATH \"${FILE}\" FILE)\n if(NOT FILE MATCHES \"^${BINARY_DIR}(/|$)\")\n list(APPEND FILES \"${FILE}\")\n endif()\nendforeach()\n\nif(CMD STREQUAL \"check\")\n set(ARGS \"--dry-run\")\nelseif(CMD STREQUAL \"reformat\")\n set(ARGS \"-i\")\nendif()\n\nif(STRICT)\n list(APPEND ARGS \"--Werror\")\nendif()\n\nexecute_process(COMMAND \"${CLANG_FORMAT_EXE}\" ${ARGS} ${FILES}\n RESULT_VARIABLE RESULT)\n\nif(NOT RESULT EQUAL 0 AND (STRICT OR NOT RESULT EQUAL 1))\n message(FATAL_ERROR \"clang-format check failed.\")\nendif()\n"
},
{
"path": "cmake/extract_version.cmake",
"content": "# Extracts the library's version number and prints it to stdout.\n\ninclude(\"${CMAKE_CURRENT_LIST_DIR}/internal.cmake\")\nwebview_extract_version()\n# Need this workaround because message() prints to stderr\nexecute_process(COMMAND ${CMAKE_COMMAND} -E echo \"${WEBVIEW_VERSION}\")\n"
},
{
"path": "cmake/internal.cmake",
"content": "set(WEBVIEW_CURRENT_CMAKE_DIR \"${CMAKE_CURRENT_LIST_DIR}\")\ninclude(\"${WEBVIEW_CURRENT_CMAKE_DIR}/webview.cmake\")\n\n# Needed when we need the project directory before calling project()\nset(WEBVIEW_ROOT_DIR \"${WEBVIEW_CURRENT_CMAKE_DIR}/..\")\n\nmacro(webview_init)\n include(CheckCXXSourceCompiles)\n include(CMakeDependentOption)\n include(CMakePackageConfigHelpers)\n include(GNUInstallDirs)\n\n list(APPEND CMAKE_MODULE_PATH \"${WEBVIEW_CURRENT_CMAKE_DIR}/modules\")\n\n enable_language(C CXX)\n\n webview_options()\n webview_internal_options()\n\n # Version 0.x of the library can't guarantee backward compatibility.\n if(WEBVIEW_VERSION_NUMBER VERSION_LESS 1.0)\n set(WEBVIEW_VERSION_COMPATIBILITY \"${WEBVIEW_VERSION_MAJOR}.${WEBVIEW_VERSION_MINOR}\")\n else()\n set(WEBVIEW_VERSION_COMPATIBILITY \"${WEBVIEW_VERSION_NUMBER}\")\n endif()\n\n # Hide symbols by default\n set(CMAKE_CXX_VISIBILITY_PRESET hidden)\n set(CMAKE_VISIBILITY_INLINES_HIDDEN YES)\n\n # Use debug postfix to separate debug/release binaries for the library\n set(CMAKE_DEBUG_POSTFIX d)\n\n if(WEBVIEW_IS_TOP_LEVEL_BUILD)\n # Add custom build types\n if(CMAKE_CONFIGURATION_TYPES)\n list(APPEND CMAKE_CONFIGURATION_TYPES Profile)\n list(REMOVE_DUPLICATES CMAKE_CONFIGURATION_TYPES)\n set(CMAKE_CONFIGURATION_TYPES \"${CMAKE_CONFIGURATION_TYPES}\" CACHE STRING \"\" FORCE)\n endif()\n\n # Use custom compiler/linker flags for the \"Profile\" build type\n if((CMAKE_C_COMPILER_ID MATCHES \"((^GNU)|Clang)$\") AND (CMAKE_CXX_COMPILER_ID MATCHES \"((^GNU)|Clang)$\"))\n set(CMAKE_C_FLAGS_PROFILE \"-g -O0 -fprofile-arcs -ftest-coverage\")\n set(CMAKE_CXX_FLAGS_PROFILE \"-g -O0 -fprofile-arcs -ftest-coverage\")\n set(CMAKE_EXE_LINKER_FLAGS_PROFILE \"-fprofile-arcs\")\n set(CMAKE_SHARED_LINKER_FLAGS_PROFILE \"-fprofile-arcs\")\n elseif(MSVC)\n # MSVC isn't supported but warnings are emitted if these variables are undefined\n set(CMAKE_C_FLAGS_PROFILE \"/Od\")\n set(CMAKE_CXX_FLAGS_PROFILE \"/Od\")\n set(CMAKE_EXE_LINKER_FLAGS_PROFILE \"\")\n set(CMAKE_SHARED_LINKER_FLAGS_PROFILE \"\")\n endif()\n\n # Default language standards\n # All of CMAKE__STANDARD, CMAKE__REQUIRED and CMAKE__EXTENSIONS must be set\n # Note that we also use the cxx_std_11 compile feature for consumers\n set(CMAKE_C_STANDARD 99 CACHE STRING \"\")\n set(CMAKE_C_STANDARD_REQUIRED YES)\n set(CMAKE_C_EXTENSIONS NO)\n set(CMAKE_CXX_STANDARD 11 CACHE STRING \"\")\n set(CMAKE_CXX_STANDARD_REQUIRED YES)\n set(CMAKE_CXX_EXTENSIONS NO)\n\n # Enable output of compile commands\n set(CMAKE_EXPORT_COMPILE_COMMANDS ON)\n\n # Enable compile warnings\n if(MSVC)\n add_compile_options(/W4)\n else()\n add_compile_options(-Wall -Wextra -Wpedantic)\n endif()\n\n # Set default build type for single-config generators\n get_property(IS_MULTI_CONFIG GLOBAL PROPERTY GENERATOR_IS_MULTI_CONFIG)\n if(NOT IS_MULTI_CONFIG AND NOT CMAKE_BUILD_TYPE)\n set(CMAKE_BUILD_TYPE Release CACHE STRING \"\" FORCE)\n endif()\n\n if(WEBVIEW_USE_STATIC_MSVC_RUNTIME AND MSVC AND NOT CMAKE_MSVC_RUNTIME_LIBRARY)\n # Use static MSVC runtime library\n set(CMAKE_MSVC_RUNTIME_LIBRARY \"MultiThreaded$<$:Debug>\")\n endif()\n\n webview_set_install_rpath()\n\n if(WEBVIEW_ENABLE_CHECKS AND WEBVIEW_ENABLE_CLANG_FORMAT)\n # Allow skipping clang-format outside of CI environment\n\n webview_find_clang_format(${WEBVIEW_IS_CI})\n\n if(WEBVIEW_CLANG_FORMAT_FOUND)\n add_custom_target(webview_format_check ALL\n COMMAND ${CMAKE_COMMAND}\n -D CMD=check\n -D \"BINARY_DIR=${PROJECT_BINARY_DIR}\"\n -D \"SOURCE_DIR=${PROJECT_SOURCE_DIR}\"\n -D \"CLANG_FORMAT_EXE=${WEBVIEW_CLANG_FORMAT_EXE}\"\n -D \"STRICT=$,$>\"\n -P \"${WEBVIEW_CURRENT_CMAKE_DIR}/clang_format.cmake\"\n COMMENT \"Checking files with clang-format...\"\n VERBATIM)\n add_custom_target(webview_reformat\n COMMAND ${CMAKE_COMMAND}\n -D CMD=reformat\n -D \"BINARY_DIR=${PROJECT_BINARY_DIR}\"\n -D \"SOURCE_DIR=${PROJECT_SOURCE_DIR}\"\n -D \"CLANG_FORMAT_EXE=${WEBVIEW_CLANG_FORMAT_EXE}\"\n -P \"${WEBVIEW_CURRENT_CMAKE_DIR}/clang_format.cmake\"\n COMMENT \"Reformatting files with clang-format...\"\n VERBATIM)\n else()\n message(WARNING \"Skipping clang-format checks as clang-format was not found\")\n endif()\n endif()\n\n if(WEBVIEW_ENABLE_CHECKS AND WEBVIEW_ENABLE_CLANG_TIDY)\n if((CMAKE_C_COMPILER_ID MATCHES \"Clang$\") AND (CMAKE_CXX_COMPILER_ID MATCHES \"Clang$\"))\n # Allow skipping clang-tidy outside of CI environment\n\n webview_find_clang_tidy(${WEBVIEW_IS_CI})\n\n if(WEBVIEW_CLANG_TIDY_FOUND)\n set(WEBVIEW_CLANG_TIDY_ARGS)\n if(WEBVIEW_STRICT_CHECKS AND WEBVIEW_STRICT_CLANG_TIDY)\n list(APPEND WEBVIEW_CLANG_TIDY_ARGS \"--warnings-as-errors=*\")\n endif()\n\n set(CMAKE_C_CLANG_TIDY \"${WEBVIEW_CLANG_TIDY_EXE}\" ${WEBVIEW_CLANG_TIDY_ARGS})\n set(CMAKE_CXX_CLANG_TIDY \"${WEBVIEW_CLANG_TIDY_EXE}\" ${WEBVIEW_CLANG_TIDY_ARGS})\n else()\n message(WARNING \"Skipping clang-tidy checks as clang-tidy was not found: ${WEBVIEW_CLANG_TIDY_EXE_HINT}\")\n endif()\n else()\n # Skip check when clang isn't used with clang-tidy to avoid errors due to unsupported compiler flags\n # such as -fno-keep-inline-dllexport (tested GCC 14, Clang-Tidy 18)\n message(WARNING \"Skipping clang-tidy checks with non-clang compiler.\")\n endif()\n endif()\n endif()\n\n if(WEBVIEW_BUILD)\n webview_find_dependencies()\n endif()\nendmacro()\n\nfunction(webview_find_clang_format REQUIRED)\n if(WEBVIEW_CLANG_FORMAT_EXE)\n set(WEBVIEW_CLANG_FORMAT_FOUND TRUE PARENT_SCOPE)\n return()\n endif()\n set(CLANG_FORMAT_EXE_HINT \"clang-format\")\n set(FIND_ARGS WEBVIEW_CLANG_FORMAT_EXE \"${CLANG_FORMAT_EXE_HINT}\")\n if(REQUIRED)\n list(APPEND FIND_ARGS REQUIRED)\n endif()\n find_program(${FIND_ARGS})\n if(WEBVIEW_CLANG_FORMAT_EXE)\n set(WEBVIEW_CLANG_FORMAT_FOUND TRUE PARENT_SCOPE)\n else()\n set(WEBVIEW_CLANG_FORMAT_FOUND FALSE PARENT_SCOPE)\n endif()\nendfunction()\n\nfunction(webview_find_clang_tidy REQUIRED)\n if(WEBVIEW_CLANG_TIDY_EXE)\n set(WEBVIEW_CLANG_TIDY_FOUND TRUE PARENT_SCOPE)\n return()\n endif()\n # Using WEBVIEW_TOOLCHAIN_EXECUTABLE_SUFFIX here because we pair clang-tidy with the clang compiler\n set(WEBVIEW_CLANG_TIDY_EXE_HINT \"clang-tidy${WEBVIEW_TOOLCHAIN_EXECUTABLE_SUFFIX}\")\n set(FIND_ARGS WEBVIEW_CLANG_TIDY_EXE \"${WEBVIEW_CLANG_TIDY_EXE_HINT}\")\n if(REQUIRED)\n list(APPEND FIND_ARGS REQUIRED)\n endif()\n find_program(${FIND_ARGS})\n if(WEBVIEW_CLANG_TIDY_EXE)\n set(WEBVIEW_CLANG_TIDY_FOUND TRUE PARENT_SCOPE)\n else()\n set(WEBVIEW_CLANG_TIDY_FOUND FALSE PARENT_SCOPE)\n endif()\nendfunction()\n\nfunction(webview_find_doxygen REQUIRED)\n if(REQUIRED)\n list(APPEND FIND_ARGS REQUIRED)\n endif()\n list(APPEND FIND_ARGS COMPONENTS dot)\n find_package(Doxygen ${FIND_ARGS})\n set(Doxygen_FOUND \"${Doxygen_FOUND}\" PARENT_SCOPE)\n set(Doxygen_FOUND_EXECUTABLE \"${Doxygen_FOUND_EXECUTABLE}\" PARENT_SCOPE)\nendfunction()\n\nfunction(webview_find_python3 REQUIRED)\n if(REQUIRED)\n list(APPEND FIND_ARGS REQUIRED)\n endif()\n find_package(Python3 ${FIND_ARGS})\n set(Python3_FOUND \"${Python3_FOUND}\" PARENT_SCOPE)\n set(Python3_EXECUTABLE \"${Python3_EXECUTABLE}\" PARENT_SCOPE)\nendfunction()\n\nmacro(webview_extract_version)\n file(READ \"${WEBVIEW_ROOT_DIR}/core/include/webview/version.h\" WEBVIEW_H_CONTENT)\n\n if(NOT DEFINED WEBVIEW_VERSION_MAJOR)\n string(REGEX MATCH \"#define WEBVIEW_VERSION_MAJOR ([0-9]+)\" WEBVIEW_VERSION_MAJOR_MATCH \"${WEBVIEW_H_CONTENT}\")\n set(WEBVIEW_VERSION_MAJOR \"${CMAKE_MATCH_1}\")\n endif()\n\n if(NOT DEFINED WEBVIEW_VERSION_MINOR)\n string(REGEX MATCH \"#define WEBVIEW_VERSION_MINOR ([0-9]+)\" WEBVIEW_VERSION_MINOR_MATCH \"${WEBVIEW_H_CONTENT}\")\n set(WEBVIEW_VERSION_MINOR \"${CMAKE_MATCH_1}\")\n endif()\n\n if(NOT DEFINED WEBVIEW_VERSION_PATCH)\n string(REGEX MATCH \"#define WEBVIEW_VERSION_PATCH ([0-9]+)\" WEBVIEW_VERSION_PATCH_MATCH \"${WEBVIEW_H_CONTENT}\")\n set(WEBVIEW_VERSION_PATCH \"${CMAKE_MATCH_1}\")\n endif()\n\n if(NOT DEFINED WEBVIEW_VERSION_PRE_RELEASE)\n string(REGEX MATCH \"#define WEBVIEW_VERSION_PRE_RELEASE \\\"([^\\\"]*)\\\"\" WEBVIEW_VERSION_PRE_RELEASE_MATCH \"${WEBVIEW_H_CONTENT}\")\n set(WEBVIEW_VERSION_PRE_RELEASE \"${CMAKE_MATCH_1}\")\n endif()\n\n if(NOT DEFINED WEBVIEW_VERSION_BUILD_METADATA)\n string(REGEX MATCH \"#define WEBVIEW_VERSION_BUILD_METADATA \\\"([^\\\"]*)\\\"\" WEBVIEW_VERSION_BUILD_METADATA_MATCH \"${WEBVIEW_H_CONTENT}\")\n set(WEBVIEW_VERSION_BUILD_METADATA \"${CMAKE_MATCH_1}\")\n endif()\n\n set(WEBVIEW_VERSION_NUMBER \"${WEBVIEW_VERSION_MAJOR}.${WEBVIEW_VERSION_MINOR}.${WEBVIEW_VERSION_PATCH}\")\n set(WEBVIEW_VERSION \"${WEBVIEW_VERSION_NUMBER}${WEBVIEW_VERSION_PRE_RELEASE}${WEBVIEW_VERSION_BUILD_METADATA}\")\nendmacro()\n\nmacro(webview_install_targets)\n # Install headers\n install(DIRECTORY \"${WEBVIEW_ROOT_DIR}/core/include/webview\"\n DESTINATION \"${CMAKE_INSTALL_INCLUDEDIR}\"\n COMPONENT webview_headers)\n\n # Install modules\n install(DIRECTORY \"${WEBVIEW_CURRENT_CMAKE_DIR}/modules\"\n DESTINATION \"${CMAKE_INSTALL_LIBDIR}/cmake/webview\"\n COMPONENT webview_cmake)\n\n # Install targets\n list(APPEND WEBVIEW_INSTALL_TARGET_NAMES webview_core_headers)\n\n if(WEBVIEW_BUILD_SHARED_LIBRARY)\n list(APPEND WEBVIEW_INSTALL_TARGET_NAMES webview_core_shared)\n endif()\n\n if(WEBVIEW_BUILD_STATIC_LIBRARY)\n list(APPEND WEBVIEW_INSTALL_TARGET_NAMES webview_core_static)\n endif()\n\n if(CMAKE_SYSTEM_NAME STREQUAL \"Windows\" AND WEBVIEW_USE_COMPAT_MINGW)\n list(APPEND WEBVIEW_INSTALL_TARGET_NAMES webview_compat_mingw)\n endif()\n\n install(TARGETS ${WEBVIEW_INSTALL_TARGET_NAMES}\n COMPONENT webview_libraries_runtime_release\n CONFIGURATIONS Release\n RUNTIME\n DESTINATION \"${CMAKE_INSTALL_BINDIR}\"\n LIBRARY\n DESTINATION \"${CMAKE_INSTALL_LIBDIR}\"\n NAMELINK_COMPONENT webview_trash\n ARCHIVE\n DESTINATION \"${CMAKE_INSTALL_LIBDIR}\"\n COMPONENT webview_trash)\n\n install(TARGETS ${WEBVIEW_INSTALL_TARGET_NAMES}\n EXPORT webview_targets\n COMPONENT webview_libraries\n RUNTIME\n DESTINATION \"${CMAKE_INSTALL_BINDIR}\"\n LIBRARY\n DESTINATION \"${CMAKE_INSTALL_LIBDIR}\"\n ARCHIVE\n DESTINATION \"${CMAKE_INSTALL_LIBDIR}\")\n\n install(EXPORT webview_targets\n DESTINATION \"${CMAKE_INSTALL_LIBDIR}/cmake/webview\"\n NAMESPACE webview::\n FILE webview-targets.cmake\n COMPONENT webview_cmake)\n\n export(EXPORT webview_targets FILE \"${CMAKE_CURRENT_BINARY_DIR}/webview-targets.cmake\")\n\n # Install package config\n configure_package_config_file(\n \"${WEBVIEW_CURRENT_CMAKE_DIR}/webview-config.cmake.in\"\n \"${CMAKE_CURRENT_BINARY_DIR}/webview-config.cmake\"\n INSTALL_DESTINATION \"${CMAKE_INSTALL_LIBDIR}/cmake/webview\"\n NO_SET_AND_CHECK_MACRO\n NO_CHECK_REQUIRED_COMPONENTS_MACRO)\n\n write_basic_package_version_file(\n \"${CMAKE_CURRENT_BINARY_DIR}/webview-config-version.cmake\"\n VERSION \"${WEBVIEW_VERSION_COMPATIBILITY}\"\n COMPATIBILITY SameMinorVersion)\n\n install(\n FILES\n \"${WEBVIEW_CURRENT_CMAKE_DIR}/webview.cmake\"\n \"${CMAKE_CURRENT_BINARY_DIR}/webview-config.cmake\"\n \"${CMAKE_CURRENT_BINARY_DIR}/webview-config-version.cmake\"\n DESTINATION \"${CMAKE_INSTALL_LIBDIR}/cmake/webview\"\n COMPONENT webview_cmake)\nendmacro()\n\nmacro(webview_internal_options)\n if(CMAKE_CURRENT_SOURCE_DIR STREQUAL CMAKE_SOURCE_DIR)\n set(WEBVIEW_IS_TOP_LEVEL_BUILD TRUE)\n endif()\n\n if(NOT DEFINED WEBVIEW_IS_CI)\n set(WEBVIEW_IS_CI FALSE)\n if(\"$ENV{CI}\" MATCHES \"^(1|true|TRUE)$\")\n set(WEBVIEW_IS_CI TRUE)\n endif()\n endif()\n\n option(WEBVIEW_BUILD \"Enable building\" ON)\n cmake_dependent_option(WEBVIEW_BUILD_AMALGAMATION \"Build amalgamated library\" ON \"WEBVIEW_BUILD;WEBVIEW_IS_TOP_LEVEL_BUILD\" OFF)\n option(WEBVIEW_BUILD_DOCS \"Build documentation\" ${WEBVIEW_IS_TOP_LEVEL_BUILD})\n option(WEBVIEW_BUILD_TESTS \"Build tests\" ${WEBVIEW_IS_TOP_LEVEL_BUILD})\n option(WEBVIEW_BUILD_EXAMPLES \"Build examples\" ${WEBVIEW_IS_TOP_LEVEL_BUILD})\n option(WEBVIEW_INSTALL_DOCS \"Install documentation\" ${WEBVIEW_IS_TOP_LEVEL_BUILD})\n option(WEBVIEW_INSTALL_TARGETS \"Install targets\" ${WEBVIEW_IS_TOP_LEVEL_BUILD})\n option(WEBVIEW_BUILD_SHARED_LIBRARY \"Build shared libraries\" ON)\n option(WEBVIEW_BUILD_STATIC_LIBRARY \"Build static libraries\" ON)\n option(WEBVIEW_USE_COMPAT_MINGW \"Use compatibility helper for MinGW\" ${WEBVIEW_IS_TOP_LEVEL_BUILD})\n option(WEBVIEW_USE_STATIC_MSVC_RUNTIME \"Use static runtime library (MSVC)\" OFF)\n option(WEBVIEW_ENABLE_CHECKS \"Enable checks\" ${WEBVIEW_IS_TOP_LEVEL_BUILD})\n option(WEBVIEW_ENABLE_CLANG_FORMAT \"Enable clang-format\" ${WEBVIEW_ENABLE_CHECKS})\n option(WEBVIEW_ENABLE_CLANG_TIDY \"Enable clang-tidy\" ${WEBVIEW_ENABLE_CHECKS})\n option(WEBVIEW_ENABLE_PACKAGING \"Enable packaging\" ${WEBVIEW_IS_TOP_LEVEL_BUILD})\n option(WEBVIEW_STRICT_CHECKS \"Make checks strict\" ${WEBVIEW_IS_CI})\n cmake_dependent_option(WEBVIEW_PACKAGE_AMALGAMATION \"Package amalgamated library\" ON WEBVIEW_ENABLE_PACKAGING OFF)\n cmake_dependent_option(WEBVIEW_PACKAGE_DOCS \"Package documentation\" ON WEBVIEW_ENABLE_PACKAGING OFF)\n cmake_dependent_option(WEBVIEW_PACKAGE_HEADERS \"Package headers\" ON WEBVIEW_ENABLE_PACKAGING OFF)\n cmake_dependent_option(WEBVIEW_PACKAGE_LIB \"Package compiled libraries\" ON WEBVIEW_ENABLE_PACKAGING OFF)\n option(WEBVIEW_STRICT_CLANG_FORMAT \"Make clang-format check strict\" ${WEBVIEW_STRICT_CHECKS})\n option(WEBVIEW_STRICT_CLANG_TIDY \"Make clang-tidy check strict\" ${WEBVIEW_STRICT_CHECKS})\nendmacro()\n\nmacro(webview_set_install_rpath)\n if(CMAKE_SYSTEM_NAME STREQUAL \"Darwin\" OR CMAKE_SYSTEM_NAME STREQUAL \"Linux\")\n # RPATH/RUNPATH\n if(CMAKE_SYSTEM_NAME STREQUAL \"Darwin\")\n set(RPATH_BASE @loader_path)\n else()\n set(RPATH_BASE $ORIGIN)\n endif()\n\n file(RELATIVE_PATH RPATH_SUBDIR\n \"${CMAKE_CURRENT_BINARY_DIR}/${CMAKE_INSTALL_BINDIR}\"\n \"${CMAKE_CURRENT_BINARY_DIR}/${CMAKE_INSTALL_LIBDIR}\")\n set(CMAKE_INSTALL_RPATH \"${RPATH_BASE}\" \"${RPATH_BASE}/${RPATH_SUBDIR}\")\n endif()\nendmacro()\n"
},
{
"path": "cmake/modules/FindMSWebView2.cmake",
"content": "if(DEFINED MSWebView2_ROOT)\n find_path(MSWebView2_INCLUDE_DIR WebView2.h\n PATHS\n \"${MSWebView2_ROOT}/build/native\"\n \"${MSWebView2_ROOT}\"\n PATH_SUFFIXES include\n NO_CMAKE_FIND_ROOT_PATH)\nendif()\n\ninclude(FindPackageHandleStandardArgs)\nfind_package_handle_standard_args(MSWebView2 REQUIRED_VARS MSWebView2_INCLUDE_DIR)\n\nif(MSWebView2_FOUND)\n if(NOT TARGET MSWebView2::headers)\n add_library(MSWebView2::headers INTERFACE IMPORTED)\n set_target_properties(MSWebView2::headers PROPERTIES\n INTERFACE_INCLUDE_DIRECTORIES \"${MSWebView2_INCLUDE_DIR}\")\n target_compile_features(MSWebView2::headers INTERFACE cxx_std_11)\n endif()\nendif()\n"
},
{
"path": "cmake/toolchains/arm64-windows-msvc.cmake",
"content": "set(CMAKE_SYSTEM_NAME Windows)\nset(CMAKE_SYSTEM_PROCESSOR ARM64)\n\nset(CMAKE_C_COMPILER cl)\nset(CMAKE_CXX_COMPILER cl)\n\nset(CMAKE_GENERATOR_PLATFORM ARM64 CACHE INTERNAL \"\")\n"
},
{
"path": "cmake/toolchains/host-gnu.cmake",
"content": "set(CMAKE_C_COMPILER \"gcc${WEBVIEW_TOOLCHAIN_EXECUTABLE_SUFFIX}\")\nset(CMAKE_CXX_COMPILER \"g++${WEBVIEW_TOOLCHAIN_EXECUTABLE_SUFFIX}\")\n"
},
{
"path": "cmake/toolchains/host-llvm.cmake",
"content": "set(CMAKE_C_COMPILER \"clang${WEBVIEW_TOOLCHAIN_EXECUTABLE_SUFFIX}\")\nset(CMAKE_CXX_COMPILER \"clang++${WEBVIEW_TOOLCHAIN_EXECUTABLE_SUFFIX}\")\n"
},
{
"path": "cmake/toolchains/i686-w64-mingw32.cmake",
"content": "set(CMAKE_SYSTEM_NAME Windows)\nset(CMAKE_SYSTEM_PROCESSOR i686)\n\nset(CMAKE_SYSROOT /usr/i686-w64-mingw32)\nset(CMAKE_C_COMPILER \"i686-w64-mingw32-gcc${WEBVIEW_TOOLCHAIN_EXECUTABLE_SUFFIX}\")\nset(CMAKE_CXX_COMPILER \"i686-w64-mingw32-g++${WEBVIEW_TOOLCHAIN_EXECUTABLE_SUFFIX}\")\nset(CMAKE_RANLIB i686-w64-mingw32-ranlib)\nset(CMAKE_RC_COMPILER i686-w64-mingw32-windres)\n\nset(CMAKE_FIND_ROOT_PATH_MODE_PROGRAM NEVER)\nset(CMAKE_FIND_ROOT_PATH_MODE_LIBRARY ONLY)\nset(CMAKE_FIND_ROOT_PATH_MODE_INCLUDE ONLY)\n"
},
{
"path": "cmake/toolchains/i686-windows-msvc.cmake",
"content": "set(CMAKE_SYSTEM_NAME Windows)\nset(CMAKE_SYSTEM_PROCESSOR x86)\n\nset(CMAKE_C_COMPILER cl)\nset(CMAKE_CXX_COMPILER cl)\n\nset(CMAKE_GENERATOR_PLATFORM Win32 CACHE INTERNAL \"\")\n"
},
{
"path": "cmake/toolchains/universal-macos-llvm.cmake",
"content": "set(CMAKE_SYSTEM_NAME Darwin)\n\nset(CMAKE_C_COMPILER \"clang${WEBVIEW_TOOLCHAIN_EXECUTABLE_SUFFIX}\")\nset(CMAKE_CXX_COMPILER \"clang++${WEBVIEW_TOOLCHAIN_EXECUTABLE_SUFFIX}\")\n\nset(CMAKE_OSX_ARCHITECTURES \"arm64;x86_64\" CACHE INTERNAL \"\")\n"
},
{
"path": "cmake/toolchains/x86_64-msys2-gnu-ucrt64.cmake",
"content": "set(CMAKE_SYSTEM_NAME Windows)\nset(CMAKE_SYSTEM_PROCESSOR x86_64)\n\nset(CMAKE_C_COMPILER \"gcc${WEBVIEW_TOOLCHAIN_EXECUTABLE_SUFFIX}\")\nset(CMAKE_CXX_COMPILER \"g++${WEBVIEW_TOOLCHAIN_EXECUTABLE_SUFFIX}\")\n\nset(MSYSTEM ucrt64 CACHE INTERNAL \"\")\n"
},
{
"path": "cmake/toolchains/x86_64-msys2-llvm-clang64.cmake",
"content": "set(CMAKE_SYSTEM_NAME Windows)\nset(CMAKE_SYSTEM_PROCESSOR x86_64)\n\nset(CMAKE_C_COMPILER \"clang${WEBVIEW_TOOLCHAIN_EXECUTABLE_SUFFIX}\")\nset(CMAKE_CXX_COMPILER \"clang++${WEBVIEW_TOOLCHAIN_EXECUTABLE_SUFFIX}\")\n\nset(MSYSTEM clang64 CACHE INTERNAL \"\")\n"
},
{
"path": "cmake/toolchains/x86_64-w64-mingw32.cmake",
"content": "set(CMAKE_SYSTEM_NAME Windows)\nset(CMAKE_SYSTEM_PROCESSOR x86_64)\n\nset(CMAKE_SYSROOT /usr/x86_64-w64-mingw32)\nset(CMAKE_C_COMPILER \"x86_64-w64-mingw32-gcc${WEBVIEW_TOOLCHAIN_EXECUTABLE_SUFFIX}\")\nset(CMAKE_CXX_COMPILER \"x86_64-w64-mingw32-g++${WEBVIEW_TOOLCHAIN_EXECUTABLE_SUFFIX}\")\nset(CMAKE_RANLIB x86_64-w64-mingw32-ranlib)\nset(CMAKE_RC_COMPILER x86_64-w64-mingw32-windres)\n\nset(CMAKE_FIND_ROOT_PATH_MODE_PROGRAM NEVER)\nset(CMAKE_FIND_ROOT_PATH_MODE_LIBRARY ONLY)\nset(CMAKE_FIND_ROOT_PATH_MODE_INCLUDE ONLY)\n"
},
{
"path": "cmake/toolchains/x86_64-windows-msvc.cmake",
"content": "set(CMAKE_SYSTEM_NAME Windows)\nset(CMAKE_SYSTEM_PROCESSOR AMD64)\n\nset(CMAKE_C_COMPILER cl)\nset(CMAKE_CXX_COMPILER cl)\n\nset(CMAKE_GENERATOR_PLATFORM x64 CACHE INTERNAL \"\")\n"
},
{
"path": "cmake/webview-config.cmake.in",
"content": "@PACKAGE_INIT@\n\ninclude(CMakeFindDependencyMacro)\ninclude(\"${CMAKE_CURRENT_LIST_DIR}/webview.cmake\")\nlist(APPEND CMAKE_MODULE_PATH \"${CMAKE_CURRENT_LIST_DIR}/modules\")\n\nwebview_options()\nwebview_find_dependencies()\n\ninclude(\"${CMAKE_CURRENT_LIST_DIR}/webview-targets.cmake\")\n"
},
{
"path": "cmake/webview.cmake",
"content": "macro(webview_options)\n if(CMAKE_SYSTEM_NAME STREQUAL \"Windows\")\n set(WEBVIEW_MSWEBVIEW2_VERSION \"1.0.1150.38\" CACHE STRING \"MS WebView2 version\")\n option(WEBVIEW_USE_BUILTIN_MSWEBVIEW2 \"Use built-in MS WebView2\" ON)\n endif()\nendmacro()\n\nmacro(webview_find_dependencies)\n if(CMAKE_SYSTEM_NAME STREQUAL \"Darwin\")\n list(APPEND WEBVIEW_DEPENDENCIES \"-framework WebKit\" dl)\n elseif(CMAKE_SYSTEM_NAME STREQUAL \"Windows\")\n if(WEBVIEW_USE_BUILTIN_MSWEBVIEW2)\n find_package(MSWebView2 QUIET)\n if(NOT MSWebView2_FOUND)\n webview_fetch_mswebview2(${WEBVIEW_MSWEBVIEW2_VERSION})\n endif()\n find_package(MSWebView2 REQUIRED)\n if(MSWebView2_FOUND)\n list(APPEND WEBVIEW_DEPENDENCIES MSWebView2::headers)\n endif()\n endif()\n list(APPEND WEBVIEW_DEPENDENCIES advapi32 ole32 shell32 shlwapi user32 version)\n else()\n find_package(PkgConfig REQUIRED)\n\n # List of preferred WebkitGTK modules (from most to least preferred)\n set(WEBVIEW_WEBKITGTK_PREFERRED_API_LIST webkit2gtk-4.1)\n # List of known WebkitGTK modules (from higher to lower version)\n set(WEBVIEW_WEBKITGTK_KNOWN_API_LIST webkitgtk-6.0 webkit2gtk-4.1 webkit2gtk-4.0)\n\n # Try to find specific WebKitGTK API\n if(NOT \"${WEBVIEW_WEBKITGTK_API}\" STREQUAL \"\")\n if(WEBVIEW_WEBKITGTK_API VERSION_EQUAL 6.0)\n pkg_check_modules(WEBVIEW_WEBKITGTK REQUIRED IMPORTED_TARGET webkitgtk-6.0)\n elseif(WEBVIEW_WEBKITGTK_API VERSION_EQUAL 4.1)\n pkg_check_modules(WEBVIEW_WEBKITGTK REQUIRED IMPORTED_TARGET webkit2gtk-4.1)\n elseif(WEBVIEW_WEBKITGTK_API VERSION_EQUAL 4.0)\n pkg_check_modules(WEBVIEW_WEBKITGTK REQUIRED IMPORTED_TARGET webkit2gtk-4.0)\n else()\n message(FATAL_ERROR \"Unsupported WebKitGTK API: ${WEBVIEW_WEBKITGTK_API}\")\n endif()\n endif()\n\n if(\"${WEBVIEW_WEBKITGTK_MODULE_NAME}\" STREQUAL \"\")\n # Try to find a preferred WebKitGTK API\n pkg_search_module(WEBVIEW_WEBKITGTK IMPORTED_TARGET ${WEBVIEW_WEBKITGTK_PREFERRED_API_LIST})\n if (NOT WEBVIEW_WEBKITGTK_FOUND)\n message(STATUS \"Trying to find any WebKitGTK API\")\n pkg_search_module(WEBVIEW_WEBKITGTK REQUIRED IMPORTED_TARGET ${WEBVIEW_WEBKITGTK_KNOWN_API_LIST})\n endif()\n else()\n pkg_check_modules(WEBVIEW_WEBKITGTK REQUIRED IMPORTED_TARGET \"${WEBVIEW_WEBKITGTK_MODULE_NAME}\")\n endif()\n\n if(\"${WEBVIEW_WEBKITGTK_MODULE_NAME}\" STREQUAL \"webkitgtk-6.0\")\n set(WEBVIEW_WEBKITGTK_API 6.0)\n elseif(\"${WEBVIEW_WEBKITGTK_MODULE_NAME}\" STREQUAL \"webkit2gtk-4.1\")\n set(WEBVIEW_WEBKITGTK_API 4.1)\n elseif(\"${WEBVIEW_WEBKITGTK_MODULE_NAME}\" STREQUAL \"webkit2gtk-4.0\")\n set(WEBVIEW_WEBKITGTK_API 4.0)\n else()\n message(FATAL_ERROR \"Couldn't find any supported WebKitGTK API\")\n endif()\n\n # Find matching GTK module\n if(\"${WEBVIEW_WEBKITGTK_API}\" VERSION_GREATER_EQUAL 6.0)\n pkg_check_modules(WEBVIEW_GTK REQUIRED IMPORTED_TARGET gtk4)\n elseif(\"${WEBVIEW_WEBKITGTK_API}\" VERSION_LESS 5.0)\n pkg_check_modules(WEBVIEW_GTK REQUIRED IMPORTED_TARGET gtk+-3.0)\n endif()\n\n list(APPEND WEBVIEW_DEPENDENCIES PkgConfig::WEBVIEW_WEBKITGTK PkgConfig::WEBVIEW_GTK dl)\n endif()\nendmacro()\n\nfunction(webview_fetch_mswebview2 VERSION)\n cmake_policy(PUSH)\n # Avoid warning related to FetchContent and DOWNLOAD_EXTRACT_TIMESTAMP\n if(POLICY CMP0135)\n cmake_policy(SET CMP0135 NEW)\n endif()\n if(NOT COMMAND FetchContent_Declare)\n include(FetchContent)\n endif()\n set(FC_NAME microsoft_web_webview2)\n FetchContent_Declare(${FC_NAME}\n URL \"https://www.nuget.org/api/v2/package/Microsoft.Web.WebView2/${VERSION}\")\n FetchContent_MakeAvailable(${FC_NAME})\n set(MSWebView2_ROOT \"${${FC_NAME}_SOURCE_DIR}\")\n set(MSWebView2_ROOT \"${MSWebView2_ROOT}\" PARENT_SCOPE)\n cmake_policy(POP)\nendfunction()\n"
},
{
"path": "compatibility/CMakeLists.txt",
"content": "if(WEBVIEW_USE_COMPAT_MINGW)\n add_subdirectory(mingw)\nendif()\n"
},
{
"path": "compatibility/mingw/CMakeLists.txt",
"content": "# Compatibility target for MinGW that can be used to work around missing\n# \"EventToken.h\" header (used by MS WebView2) when targetting Windows.\n\nif(CMAKE_SYSTEM_NAME STREQUAL \"Windows\")\n add_library(webview_compat_mingw INTERFACE)\n add_library(webview::compat_mingw ALIAS webview_compat_mingw)\n set_target_properties(webview_compat_mingw PROPERTIES\n EXPORT_NAME compat_mingw)\n target_include_directories(\n webview_compat_mingw\n INTERFACE\n \"$\"\n \"$\")\nendif()\n"
},
{
"path": "compatibility/mingw/include/EventToken.h",
"content": "#ifndef WEBVIEW_COMPAT_EVENTTOKEN_H\n#define WEBVIEW_COMPAT_EVENTTOKEN_H\n#ifdef _WIN32\n\n// This compatibility header provides types used by MS WebView2. This header can\n// be used as an alternative to the \"EventToken.h\" header normally provided by\n// the Windows SDK. Depending on the MinGW distribution, this header may not be\n// present, or it may be present with the name \"eventtoken.h\". The letter casing\n// matters when cross-compiling on a system with case-sensitive file names.\n\n#ifndef __eventtoken_h__\n\n#ifdef __cplusplus\n#include \n#else\n#include \n#endif\n\ntypedef struct EventRegistrationToken {\n int64_t value;\n} EventRegistrationToken;\n#endif // __eventtoken_h__\n\n#endif // _WIN32\n#endif // WEBVIEW_COMPAT_EVENTTOKEN_H\n"
},
{
"path": "core/CMakeLists.txt",
"content": "# Core header library\nadd_library(webview_core_headers INTERFACE)\nadd_library(webview::core ALIAS webview_core_headers)\ntarget_include_directories(\n webview_core_headers\n INTERFACE\n \"$\"\n \"$\")\ntarget_link_libraries(webview_core_headers INTERFACE ${WEBVIEW_DEPENDENCIES})\n# Note that we also use CMAKE_CXX_STANDARD which can override this\ntarget_compile_features(webview_core_headers INTERFACE cxx_std_11)\nset_target_properties(webview_core_headers PROPERTIES\n EXPORT_NAME core)\n\nif(CMAKE_SYSTEM_NAME STREQUAL \"Windows\" AND WEBVIEW_USE_COMPAT_MINGW)\n target_link_libraries(webview_core_headers INTERFACE webview::compat_mingw)\nendif()\n\n# Core shared library\nif(WEBVIEW_BUILD_SHARED_LIBRARY)\n add_library(webview_core_shared SHARED)\n add_library(webview::core_shared ALIAS webview_core_shared)\n target_sources(webview_core_shared PRIVATE src/webview.cc)\n target_link_libraries(webview_core_shared PUBLIC webview_core_headers)\n set_target_properties(webview_core_shared PROPERTIES\n OUTPUT_NAME webview\n VERSION \"${WEBVIEW_VERSION_NUMBER}\"\n SOVERSION \"${WEBVIEW_VERSION_COMPATIBILITY}\"\n EXPORT_NAME core_shared)\n target_compile_definitions(webview_core_shared\n INTERFACE WEBVIEW_SHARED\n PRIVATE WEBVIEW_BUILD_SHARED)\nendif()\n\n# Core static library\nif(WEBVIEW_BUILD_STATIC_LIBRARY)\n # Change .lib file name for MSVC because otherwise it would be the same for shared and static\n if(MSVC)\n set(STATIC_LIBRARY_OUTPUT_NAME webview_static)\n else()\n set(STATIC_LIBRARY_OUTPUT_NAME webview)\n endif()\n\n add_library(webview_core_static STATIC)\n add_library(webview::core_static ALIAS webview_core_static)\n target_sources(webview_core_static PRIVATE src/webview.cc)\n target_link_libraries(webview_core_static PUBLIC webview_core_headers)\n set_target_properties(webview_core_static PROPERTIES\n OUTPUT_NAME \"${STATIC_LIBRARY_OUTPUT_NAME}\"\n POSITION_INDEPENDENT_CODE ON\n EXPORT_NAME core_static)\n target_compile_definitions(webview_core_static PUBLIC WEBVIEW_STATIC)\nendif()\n\nif(WEBVIEW_BUILD_TESTS)\n add_subdirectory(tests)\nendif()\n\nif(WEBVIEW_BUILD_AMALGAMATION)\n webview_find_python3(${WEBVIEW_IS_CI})\n if(Python3_FOUND)\n webview_find_clang_format(${WEBVIEW_IS_CI})\n if(WEBVIEW_CLANG_FORMAT_EXE)\n file(GLOB_RECURSE HEADER_FILES CONFIGURE_DEPENDS include/**)\n file(GLOB_RECURSE SOURCE_FILES CONFIGURE_DEPENDS src/**)\n set(AMALGAMATION_STAMP_FILE \"${CMAKE_CURRENT_BINARY_DIR}/amalgamation/webview.h.stamp\")\n\n add_custom_command(\n OUTPUT \"${AMALGAMATION_STAMP_FILE}\"\n COMMAND \"${CMAKE_COMMAND}\" -E touch \"${AMALGAMATION_STAMP_FILE}\"\n COMMAND ${Python3_EXECUTABLE}\n \"${PROJECT_SOURCE_DIR}/scripts/amalgamate/amalgamate.py\"\n --clang-format-exe \"${WEBVIEW_CLANG_FORMAT_EXE}\"\n --base \"${CMAKE_CURRENT_SOURCE_DIR}\"\n --search include\n --output \"${CMAKE_CURRENT_BINARY_DIR}/amalgamation/webview.h\"\n ${SOURCE_FILES}\n DEPENDS ${HEADER_FILES} ${SOURCE_FILES}\n COMMENT \"Building amalgamation...\"\n VERBATIM)\n\n add_custom_target(webview_amalgamate ALL\n DEPENDS \"${AMALGAMATION_STAMP_FILE}\")\n\n install(FILES \"${CMAKE_CURRENT_BINARY_DIR}/amalgamation/webview.h\"\n DESTINATION .\n COMPONENT webview_amalgamation)\n else()\n message(WARNING \"Skipping amalgamation as clang-format was not found\")\n endif()\n else()\n message(WARNING \"Skipping amalgamation as Python 3 was not found\")\n endif()\nendif()\n"
},
{
"path": "core/include/webview/api.h",
"content": "/*\n * MIT License\n *\n * Copyright (c) 2017 Serge Zaitsev\n * Copyright (c) 2022 Steffen André Langnes\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\n#ifndef WEBVIEW_API_H\n#define WEBVIEW_API_H\n\n#include \"errors.h\"\n#include \"macros.h\"\n#include \"types.h\"\n\n#ifdef __cplusplus\nextern \"C\" {\n#endif\n\n/**\n * Creates a new webview instance.\n *\n * @param debug Enable developer tools if supported by the backend.\n * @param window Optional native window handle, i.e. @c GtkWindow pointer\n * @c NSWindow pointer (Cocoa) or @c HWND (Win32). If non-null,\n * the webview widget is embedded into the given window, and the\n * caller is expected to assume responsibility for the window as\n * well as application lifecycle. If the window handle is null,\n * a new window is created and both the window and application\n * lifecycle are managed by the webview instance.\n * @remark Win32: The function also accepts a pointer to @c HWND (Win32) in the\n * window parameter for backward compatibility.\n * @remark Win32/WebView2: @c CoInitializeEx should be called with\n * @c COINIT_APARTMENTTHREADED before attempting to call this function\n * with an existing window. Omitting this step may cause WebView2\n * initialization to fail.\n * @return @c NULL on failure. Creation can fail for various reasons such\n * as when required runtime dependencies are missing or when window\n * creation fails.\n * @retval WEBVIEW_ERROR_MISSING_DEPENDENCY\n * May be returned if WebView2 is unavailable on Windows.\n */\nWEBVIEW_API webview_t webview_create(int debug, void *window);\n\n/**\n * Destroys a webview instance and closes the native window.\n *\n * @param w The webview instance.\n */\nWEBVIEW_API webview_error_t webview_destroy(webview_t w);\n\n/**\n * Runs the main loop until it's terminated.\n *\n * @param w The webview instance.\n */\nWEBVIEW_API webview_error_t webview_run(webview_t w);\n\n/**\n * Stops the main loop. It is safe to call this function from another\n * background thread.\n *\n * @param w The webview instance.\n */\nWEBVIEW_API webview_error_t webview_terminate(webview_t w);\n\n/**\n * Schedules a function to be invoked on the thread with the run/event loop.\n *\n * Since library functions generally do not have thread safety guarantees,\n * this function can be used to schedule code to execute on the main/GUI\n * thread and thereby make that execution safe in multi-threaded applications.\n *\n * @param w The webview instance.\n * @param fn The function to be invoked.\n * @param arg An optional argument passed along to the callback function.\n */\nWEBVIEW_API webview_error_t webview_dispatch(webview_t w,\n void (*fn)(webview_t w, void *arg),\n void *arg);\n\n/**\n * Returns the native handle of the window associated with the webview instance.\n * The handle can be a @c GtkWindow pointer (GTK), @c NSWindow pointer (Cocoa)\n * or @c HWND (Win32).\n *\n * @param w The webview instance.\n * @return The handle of the native window.\n */\nWEBVIEW_API void *webview_get_window(webview_t w);\n\n/**\n * Get a native handle of choice.\n *\n * @param w The webview instance.\n * @param kind The kind of handle to retrieve.\n * @return The native handle or @c NULL.\n * @since 0.11\n */\nWEBVIEW_API void *webview_get_native_handle(webview_t w,\n webview_native_handle_kind_t kind);\n\n/**\n * Updates the title of the native window.\n *\n * @param w The webview instance.\n * @param title The new title.\n */\nWEBVIEW_API webview_error_t webview_set_title(webview_t w, const char *title);\n\n/**\n * Updates the size of the native window.\n *\n * Remarks:\n * - Subsequent calls to this function may behave inconsistently across\n * different versions of GTK and windowing systems (X11/Wayland).\n * - Using WEBVIEW_HINT_MAX for setting the maximum window size is not\n * supported with GTK 4 because X11-specific functions such as\n * gtk_window_set_geometry_hints were removed. This option has no effect\n * when using GTK 4.\n *\n * @param w The webview instance.\n * @param width New width.\n * @param height New height.\n * @param hints Size hints.\n */\nWEBVIEW_API webview_error_t webview_set_size(webview_t w, int width, int height,\n webview_hint_t hints);\n\n/**\n * Navigates webview to the given URL. URL may be a properly encoded data URI.\n *\n * Example:\n * @code{.c}\n * webview_navigate(w, \"https://github.com/webview/webview\");\n * webview_navigate(w, \"data:text/html,%3Ch1%3EHello%3C%2Fh1%3E\");\n * webview_navigate(w, \"data:text/html;base64,PGgxPkhlbGxvPC9oMT4=\");\n * @endcode\n *\n * @param w The webview instance.\n * @param url URL.\n */\nWEBVIEW_API webview_error_t webview_navigate(webview_t w, const char *url);\n\n/**\n * Load HTML content into the webview.\n *\n * Example:\n * @code{.c}\n * webview_set_html(w, \"Hello
\");\n * @endcode\n *\n * @param w The webview instance.\n * @param html HTML content.\n */\nWEBVIEW_API webview_error_t webview_set_html(webview_t w, const char *html);\n\n/**\n * Injects JavaScript code to be executed immediately upon loading a page.\n * The code will be executed before @c window.onload.\n *\n * @param w The webview instance.\n * @param js JS content.\n */\nWEBVIEW_API webview_error_t webview_init(webview_t w, const char *js);\n\n/**\n * Evaluates arbitrary JavaScript code.\n *\n * Use bindings if you need to communicate the result of the evaluation.\n *\n * @param w The webview instance.\n * @param js JS content.\n */\nWEBVIEW_API webview_error_t webview_eval(webview_t w, const char *js);\n\n/**\n * Binds a function pointer to a new global JavaScript function.\n *\n * Internally, JS glue code is injected to create the JS function by the\n * given name. The callback function is passed a request identifier,\n * a request string and a user-provided argument. The request string is\n * a JSON array of the arguments passed to the JS function.\n *\n * @param w The webview instance.\n * @param name Name of the JS function.\n * @param fn Callback function.\n * @param arg User argument.\n * @retval WEBVIEW_ERROR_DUPLICATE\n * A binding already exists with the specified name.\n */\nWEBVIEW_API webview_error_t webview_bind(webview_t w, const char *name,\n void (*fn)(const char *id,\n const char *req, void *arg),\n void *arg);\n\n/**\n * Removes a binding created with webview_bind().\n *\n * @param w The webview instance.\n * @param name Name of the binding.\n * @retval WEBVIEW_ERROR_NOT_FOUND No binding exists with the specified name.\n */\nWEBVIEW_API webview_error_t webview_unbind(webview_t w, const char *name);\n\n/**\n * Responds to a binding call from the JS side.\n *\n * This function is safe to call from another thread.\n *\n * @param w The webview instance.\n * @param id The identifier of the binding call. Pass along the value received\n * in the binding handler (see webview_bind()).\n * @param status A status of zero tells the JS side that the binding call was\n * successful; any other value indicates an error.\n * @param result The result of the binding call to be returned to the JS side.\n * This must either be a valid JSON value or an empty string for\n * the primitive JS value @c undefined.\n */\nWEBVIEW_API webview_error_t webview_return(webview_t w, const char *id,\n int status, const char *result);\n\n/**\n * Get the library's version information.\n *\n * @since 0.10\n */\nWEBVIEW_API const webview_version_info_t *webview_version(void);\n\n#ifdef __cplusplus\n}\n#endif\n\n#endif // WEBVIEW_API_H\n"
},
{
"path": "core/include/webview/backends.hh",
"content": "/*\n * MIT License\n *\n * Copyright (c) 2017 Serge Zaitsev\n * Copyright (c) 2022 Steffen André Langnes\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\n#ifndef WEBVIEW_BACKENDS_HH\n#define WEBVIEW_BACKENDS_HH\n\n#if defined(__cplusplus) && !defined(WEBVIEW_HEADER)\n\n#include \"detail/backends/cocoa_webkit.hh\"\n#include \"detail/backends/gtk_webkitgtk.hh\"\n#include \"detail/backends/win32_edge.hh\"\n\nnamespace webview {\nusing webview = browser_engine;\n}\n\n#endif // defined(__cplusplus) && !defined(WEBVIEW_HEADER)\n#endif // WEBVIEW_BACKENDS_HH\n"
},
{
"path": "core/include/webview/c_api_impl.hh",
"content": "/*\n * MIT License\n *\n * Copyright (c) 2017 Serge Zaitsev\n * Copyright (c) 2022 Steffen André Langnes\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\n#ifndef WEBVIEW_C_API_IMPL_HH\n#define WEBVIEW_C_API_IMPL_HH\n\n#if defined(__cplusplus) && !defined(WEBVIEW_HEADER)\n\n#include \"backends.hh\"\n#include \"errors.h\"\n#include \"errors.hh\"\n#include \"json_deprecated.hh\"\n#include \"macros.h\"\n#include \"types.h\"\n#include \"version.h\"\n\nnamespace webview {\nnamespace detail {\n\n// The library's version information.\nconstexpr const webview_version_info_t library_version_info{\n {WEBVIEW_VERSION_MAJOR, WEBVIEW_VERSION_MINOR, WEBVIEW_VERSION_PATCH},\n WEBVIEW_VERSION_NUMBER,\n WEBVIEW_VERSION_PRE_RELEASE,\n WEBVIEW_VERSION_BUILD_METADATA};\n\ntemplate \nwebview_error_t api_filter(WorkFn &&do_work, ResultFn &&put_result) noexcept {\n try {\n auto result = do_work();\n if (result.ok()) {\n put_result(result.value());\n return WEBVIEW_ERROR_OK;\n }\n return result.error().code();\n } catch (const exception &e) {\n return e.error().code();\n } catch (...) {\n return WEBVIEW_ERROR_UNSPECIFIED;\n }\n}\n\ntemplate \nwebview_error_t api_filter(WorkFn &&do_work) noexcept {\n try {\n auto result = do_work();\n if (result.ok()) {\n return WEBVIEW_ERROR_OK;\n }\n return result.error().code();\n } catch (const exception &e) {\n return e.error().code();\n } catch (...) {\n return WEBVIEW_ERROR_UNSPECIFIED;\n }\n}\n\ninline webview *cast_to_webview(void *w) {\n if (!w) {\n throw exception{WEBVIEW_ERROR_INVALID_ARGUMENT,\n \"Cannot cast null pointer to webview instance\"};\n }\n return static_cast(w);\n}\n\n} // namespace detail\n} // namespace webview\n\nWEBVIEW_API webview_t webview_create(int debug, void *wnd) {\n using namespace webview::detail;\n webview::webview *w{};\n auto err = api_filter(\n [=]() -> webview::result {\n return new webview::webview{static_cast(debug), wnd};\n },\n [&](webview::webview *w_) { w = w_; });\n if (err == WEBVIEW_ERROR_OK) {\n return w;\n }\n return nullptr;\n}\n\nWEBVIEW_API webview_error_t webview_destroy(webview_t w) {\n using namespace webview::detail;\n return api_filter([=]() -> webview::noresult {\n delete cast_to_webview(w);\n return {};\n });\n}\n\nWEBVIEW_API webview_error_t webview_run(webview_t w) {\n using namespace webview::detail;\n return api_filter([=] { return cast_to_webview(w)->run(); });\n}\n\nWEBVIEW_API webview_error_t webview_terminate(webview_t w) {\n using namespace webview::detail;\n return api_filter([=] { return cast_to_webview(w)->terminate(); });\n}\n\nWEBVIEW_API webview_error_t webview_dispatch(webview_t w,\n void (*fn)(webview_t, void *),\n void *arg) {\n using namespace webview::detail;\n if (!fn) {\n return WEBVIEW_ERROR_INVALID_ARGUMENT;\n }\n return api_filter(\n [=] { return cast_to_webview(w)->dispatch([=]() { fn(w, arg); }); });\n}\n\nWEBVIEW_API void *webview_get_window(webview_t w) {\n using namespace webview::detail;\n void *window = nullptr;\n auto err = api_filter([=] { return cast_to_webview(w)->window(); },\n [&](void *value) { window = value; });\n if (err == WEBVIEW_ERROR_OK) {\n return window;\n }\n return nullptr;\n}\n\nWEBVIEW_API void *webview_get_native_handle(webview_t w,\n webview_native_handle_kind_t kind) {\n using namespace webview::detail;\n void *handle{};\n auto err = api_filter(\n [=]() -> webview::result {\n auto *w_ = cast_to_webview(w);\n switch (kind) {\n case WEBVIEW_NATIVE_HANDLE_KIND_UI_WINDOW:\n return w_->window();\n case WEBVIEW_NATIVE_HANDLE_KIND_UI_WIDGET:\n return w_->widget();\n case WEBVIEW_NATIVE_HANDLE_KIND_BROWSER_CONTROLLER:\n return w_->browser_controller();\n default:\n return webview::error_info{WEBVIEW_ERROR_INVALID_ARGUMENT};\n }\n },\n [&](void *handle_) { handle = handle_; });\n if (err == WEBVIEW_ERROR_OK) {\n return handle;\n }\n return nullptr;\n}\n\nWEBVIEW_API webview_error_t webview_set_title(webview_t w, const char *title) {\n using namespace webview::detail;\n if (!title) {\n return WEBVIEW_ERROR_INVALID_ARGUMENT;\n }\n return api_filter([=] { return cast_to_webview(w)->set_title(title); });\n}\n\nWEBVIEW_API webview_error_t webview_set_size(webview_t w, int width, int height,\n webview_hint_t hints) {\n using namespace webview::detail;\n return api_filter(\n [=] { return cast_to_webview(w)->set_size(width, height, hints); });\n}\n\nWEBVIEW_API webview_error_t webview_navigate(webview_t w, const char *url) {\n using namespace webview::detail;\n if (!url) {\n return WEBVIEW_ERROR_INVALID_ARGUMENT;\n }\n return api_filter([=] { return cast_to_webview(w)->navigate(url); });\n}\n\nWEBVIEW_API webview_error_t webview_set_html(webview_t w, const char *html) {\n using namespace webview::detail;\n if (!html) {\n return WEBVIEW_ERROR_INVALID_ARGUMENT;\n }\n return api_filter([=] { return cast_to_webview(w)->set_html(html); });\n}\n\nWEBVIEW_API webview_error_t webview_init(webview_t w, const char *js) {\n using namespace webview::detail;\n if (!js) {\n return WEBVIEW_ERROR_INVALID_ARGUMENT;\n }\n return api_filter([=] { return cast_to_webview(w)->init(js); });\n}\n\nWEBVIEW_API webview_error_t webview_eval(webview_t w, const char *js) {\n using namespace webview::detail;\n if (!js) {\n return WEBVIEW_ERROR_INVALID_ARGUMENT;\n }\n return api_filter([=] { return cast_to_webview(w)->eval(js); });\n}\n\nWEBVIEW_API webview_error_t webview_bind(webview_t w, const char *name,\n void (*fn)(const char *id,\n const char *req, void *arg),\n void *arg) {\n using namespace webview::detail;\n if (!name || !fn) {\n return WEBVIEW_ERROR_INVALID_ARGUMENT;\n }\n return api_filter([=] {\n return cast_to_webview(w)->bind(\n name,\n [=](const std::string &seq, const std::string &req, void *arg_) {\n fn(seq.c_str(), req.c_str(), arg_);\n },\n arg);\n });\n}\n\nWEBVIEW_API webview_error_t webview_unbind(webview_t w, const char *name) {\n using namespace webview::detail;\n if (!name) {\n return WEBVIEW_ERROR_INVALID_ARGUMENT;\n }\n return api_filter([=] { return cast_to_webview(w)->unbind(name); });\n}\n\nWEBVIEW_API webview_error_t webview_return(webview_t w, const char *id,\n int status, const char *result) {\n using namespace webview::detail;\n if (!id || !result) {\n return WEBVIEW_ERROR_INVALID_ARGUMENT;\n }\n return api_filter(\n [=] { return cast_to_webview(w)->resolve(id, status, result); });\n}\n\nWEBVIEW_API const webview_version_info_t *webview_version(void) {\n return &webview::detail::library_version_info;\n}\n\n#endif // defined(__cplusplus) && !defined(WEBVIEW_HEADER)\n#endif // WEBVIEW_C_API_IMPL_HH\n"
},
{
"path": "core/include/webview/detail/backends/cocoa_webkit.hh",
"content": "/*\n * MIT License\n *\n * Copyright (c) 2017 Serge Zaitsev\n * Copyright (c) 2022 Steffen André Langnes\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\n#ifndef WEBVIEW_BACKENDS_COCOA_WEBKIT_HH\n#define WEBVIEW_BACKENDS_COCOA_WEBKIT_HH\n\n#if defined(__cplusplus) && !defined(WEBVIEW_HEADER)\n\n#include \"../../macros.h\"\n\n#if defined(WEBVIEW_PLATFORM_DARWIN) && defined(WEBVIEW_COCOA)\n\n//\n// ====================================================================\n//\n// This implementation uses Cocoa WKWebView backend on macOS. It is\n// written using ObjC runtime and uses WKWebView class as a browser runtime.\n// You should pass \"-framework Webkit\" flag to the compiler.\n//\n// ====================================================================\n//\n\n#include \"../../types.hh\"\n#include \"../engine_base.hh\"\n#include \"../platform/darwin/cocoa/cocoa.hh\"\n#include \"../platform/darwin/objc/objc.hh\"\n#include \"../platform/darwin/webkit/webkit.hh\"\n#include \"../user_script.hh\"\n\n#include \n#include \n#include \n#include \n#include \n\n#include \n\nnamespace webview {\nnamespace detail {\n\nclass user_script::impl {\npublic:\n impl(id script) : m_script{objc::retain(script)} {}\n\n ~impl() { objc::release(m_script); }\n\n impl(const impl &) = delete;\n impl &operator=(const impl &) = delete;\n impl(impl &&) = delete;\n impl &operator=(impl &&) = delete;\n\n id get_native() const { return m_script; }\n\nprivate:\n id m_script{};\n};\n\n// Encapsulate backend in its own namespace to avoid polluting the parent\n// namespace when pulling in commonly-used symbols from other namespaces.\n// Since those commmon symbols are used a lot, this reduces the overall\n// noise in the code.\nnamespace cocoa_webkit {\n\nusing namespace cocoa;\nusing namespace webkit;\n\nclass cocoa_wkwebview_engine : public engine_base {\npublic:\n cocoa_wkwebview_engine(bool debug, void *window)\n : engine_base{!window}, m_app{NSApplication_get_sharedApplication()} {\n window_init(window);\n window_settings(debug);\n dispatch_size_default();\n }\n\n cocoa_wkwebview_engine(const cocoa_wkwebview_engine &) = delete;\n cocoa_wkwebview_engine &operator=(const cocoa_wkwebview_engine &) = delete;\n cocoa_wkwebview_engine(cocoa_wkwebview_engine &&) = delete;\n cocoa_wkwebview_engine &operator=(cocoa_wkwebview_engine &&) = delete;\n\n virtual ~cocoa_wkwebview_engine() {\n objc::autoreleasepool arp;\n if (m_window) {\n if (m_webview) {\n if (auto ui_delegate{WKWebView_get_UIDelegate(m_webview)}) {\n WKWebView_set_UIDelegate(m_webview, nullptr);\n objc::release(ui_delegate);\n }\n objc::release(m_webview);\n m_webview = nullptr;\n }\n if (m_widget) {\n if (m_widget == NSWindow_get_contentView(m_window)) {\n NSWindow_set_contentView(m_window, nullptr);\n }\n objc::release(m_widget);\n m_widget = nullptr;\n }\n if (owns_window()) {\n // Replace delegate to avoid callbacks and other bad things during\n // destruction.\n NSWindow_set_delegate(m_window, nullptr);\n NSWindow_close(m_window);\n on_window_destroyed(true);\n }\n m_window = nullptr;\n }\n if (m_window_delegate) {\n objc::release(m_window_delegate);\n m_window_delegate = nullptr;\n }\n if (m_app_delegate) {\n NSApplication_set_delegate(m_app, nullptr);\n // Make sure to release the delegate we created.\n objc::release(m_app_delegate);\n m_app_delegate = nullptr;\n }\n if (owns_window()) {\n // Needed for the window to close immediately.\n deplete_run_loop_event_queue();\n }\n // TODO: Figure out why m_manager is still alive after the autoreleasepool\n // has been drained.\n }\n\nprotected:\n result window_impl() override {\n if (m_window) {\n return m_window;\n }\n return error_info{WEBVIEW_ERROR_INVALID_STATE};\n }\n\n result widget_impl() override {\n if (m_widget) {\n return m_widget;\n }\n return error_info{WEBVIEW_ERROR_INVALID_STATE};\n }\n\n result browser_controller_impl() override {\n if (m_webview) {\n return m_webview;\n }\n return error_info{WEBVIEW_ERROR_INVALID_STATE};\n }\n\n noresult terminate_impl() override {\n stop_run_loop();\n return {};\n }\n\n noresult run_impl() override {\n NSApplication_run(m_app);\n return {};\n }\n\n noresult dispatch_impl(std::function f) override {\n dispatch_async_f(dispatch_get_main_queue(), new dispatch_fn_t(f),\n (dispatch_function_t)([](void *arg) {\n auto f = static_cast(arg);\n (*f)();\n delete f;\n }));\n return {};\n }\n\n noresult set_title_impl(const std::string &title) override {\n NSWindow_set_title(m_window, title);\n return {};\n }\n noresult set_size_impl(int width, int height, webview_hint_t hints) override {\n objc::autoreleasepool arp;\n\n auto style = static_cast(\n NSWindowStyleMaskTitled | NSWindowStyleMaskClosable |\n NSWindowStyleMaskMiniaturizable);\n if (hints != WEBVIEW_HINT_FIXED) {\n style =\n static_cast(style | NSWindowStyleMaskResizable);\n }\n NSWindow_set_styleMask(m_window, style);\n\n if (hints == WEBVIEW_HINT_MIN) {\n NSWindow_set_contentMinSize(m_window, NSSizeMake(width, height));\n } else if (hints == WEBVIEW_HINT_MAX) {\n NSWindow_set_contentMaxSize(m_window, NSSizeMake(width, height));\n } else {\n auto rect{NSWindow_get_frame(m_window)};\n NSWindow_setFrame(m_window,\n NSRectMake(rect.origin.x, rect.origin.y, width, height),\n true, false);\n }\n NSWindow_center(m_window);\n\n return window_show();\n }\n noresult navigate_impl(const std::string &url) override {\n objc::autoreleasepool arp;\n\n WKWebView_loadRequest(\n m_webview, NSURLRequest_requestWithURL(NSURL_URLWithString(url)));\n\n return {};\n }\n noresult set_html_impl(const std::string &html) override {\n objc::autoreleasepool arp;\n WKWebView_loadHTMLString(m_webview, NSString_stringWithUTF8String(html),\n nullptr);\n return {};\n }\n noresult eval_impl(const std::string &js) override {\n objc::autoreleasepool arp;\n // URI is null before content has begun loading.\n auto nsurl{WKWebView_get_URL(m_webview)};\n if (!nsurl) {\n return {};\n }\n WKWebView_evaluateJavaScript(m_webview, NSString_stringWithUTF8String(js),\n nullptr);\n return {};\n }\n\n user_script add_user_script_impl(const std::string &js) override {\n objc::autoreleasepool arp;\n auto wk_script{WKUserScript_withSource(\n NSString_stringWithUTF8String(js),\n WKUserScriptInjectionTimeAtDocumentStart, true)};\n // Script is retained when added.\n WKUserContentController_addUserScript(m_manager, wk_script);\n user_script script{\n js, user_script::impl_ptr{new user_script::impl{wk_script},\n [](user_script::impl *p) { delete p; }}};\n return script;\n }\n\n void remove_all_user_scripts_impl(\n const std::list & /*scripts*/) override {\n objc::autoreleasepool arp;\n // Removing scripts decreases the retain count of each script.\n WKUserContentController_removeAllUserScripts(m_manager);\n }\n\n bool are_user_scripts_equal_impl(const user_script &first,\n const user_script &second) override {\n auto *wk_first = first.get_impl().get_native();\n auto *wk_second = second.get_impl().get_native();\n return wk_first == wk_second;\n }\n\nprivate:\n id create_app_delegate() {\n objc::autoreleasepool arp;\n constexpr auto class_name = \"WebviewAppDelegate\";\n // Avoid crash due to registering same class twice\n auto cls = objc_lookUpClass(class_name);\n if (!cls) {\n // Note: Avoid registering the class name \"AppDelegate\" as it is the\n // default name in projects created with Xcode, and using the same name\n // causes objc_registerClassPair to crash.\n cls =\n objc_allocateClassPair(objc::get_class(\"NSResponder\"), class_name, 0);\n class_addProtocol(cls, objc_getProtocol(\"NSTouchBarProvider\"));\n class_addMethod(\n cls,\n objc::selector(\"applicationShouldTerminateAfterLastWindowClosed:\"),\n (IMP)(+[](id, SEL, id) -> BOOL { return NO; }), \"c@:@\");\n class_addMethod(cls, objc::selector(\"applicationDidFinishLaunching:\"),\n (IMP)(+[](id self, SEL, id notification) {\n auto app{NSNotification_get_object(notification)};\n auto w = get_associated_webview(self);\n w->on_application_did_finish_launching(self, app);\n }),\n \"v@:@\");\n objc_registerClassPair(cls);\n }\n return objc::Class_new(cls);\n }\n id create_script_message_handler() {\n objc::autoreleasepool arp;\n constexpr auto class_name = \"WebviewWKScriptMessageHandler\";\n // Avoid crash due to registering same class twice\n auto cls = objc_lookUpClass(class_name);\n if (!cls) {\n cls =\n objc_allocateClassPair(objc::get_class(\"NSResponder\"), class_name, 0);\n class_addProtocol(cls, objc_getProtocol(\"WKScriptMessageHandler\"));\n class_addMethod(\n cls, objc::selector(\"userContentController:didReceiveScriptMessage:\"),\n (IMP)(+[](id self, SEL, id, id msg) {\n auto w = get_associated_webview(self);\n w->on_message(\n NSString_get_UTF8String(WKScriptMessage_get_body(msg)));\n }),\n \"v@:@@\");\n objc_registerClassPair(cls);\n }\n auto instance{objc::Class_new(cls)};\n set_associated_webview(instance, this);\n return instance;\n }\n static id create_webkit_ui_delegate() {\n objc::autoreleasepool arp;\n constexpr auto class_name = \"WebviewWKUIDelegate\";\n // Avoid crash due to registering same class twice\n auto cls = objc_lookUpClass(class_name);\n if (!cls) {\n cls = objc_allocateClassPair(objc::get_class(\"NSObject\"), class_name, 0);\n class_addProtocol(cls, objc_getProtocol(\"WKUIDelegate\"));\n class_addMethod(\n cls,\n objc::selector(\"webView:runOpenPanelWithParameters:initiatedByFrame:\"\n \"completionHandler:\"),\n (IMP)(+[](id, SEL, id, id parameters, id, id completion_handler) {\n auto allows_multiple_selection{\n WKOpenPanelParameters_get_allowsMultipleSelection(parameters)};\n auto allows_directories{\n WKOpenPanelParameters_get_allowsDirectories(parameters)};\n\n // Show a panel for selecting files.\n auto panel{NSOpenPanel_openPanel()};\n NSOpenPanel_set_canChooseFiles(panel, true);\n NSOpenPanel_set_canChooseDirectories(panel, allows_directories);\n NSOpenPanel_set_allowsMultipleSelection(panel,\n allows_multiple_selection);\n auto modal_response{NSSavePanel_runModal(panel)};\n\n // Get the URLs for the selected files. If the modal was canceled\n // then we pass null to the completion handler to signify\n // cancellation.\n id urls{modal_response == NSModalResponseOK\n ? NSOpenPanel_get_URLs(panel)\n : nullptr};\n\n // Invoke the completion handler block.\n auto sig{NSMethodSignature_signatureWithObjCTypes(\"v@?@\")};\n auto invocation{NSInvocation_invocationWithMethodSignature(sig)};\n NSInvocation_set_target(invocation, completion_handler);\n NSInvocation_setArgument(invocation, &urls, 1);\n NSInvocation_invoke(invocation);\n }),\n \"v@:@@@@\");\n objc_registerClassPair(cls);\n }\n return objc::Class_new(cls);\n }\n static id create_window_delegate() {\n objc::autoreleasepool arp;\n constexpr auto class_name = \"WebviewNSWindowDelegate\";\n // Avoid crash due to registering same class twice\n auto cls = objc_lookUpClass(class_name);\n if (!cls) {\n cls = objc_allocateClassPair(objc::get_class(\"NSObject\"), class_name, 0);\n class_addProtocol(cls, objc_getProtocol(\"NSWindowDelegate\"));\n class_addMethod(cls, objc::selector(\"windowWillClose:\"),\n (IMP)(+[](id self, SEL, id notification) {\n auto window{NSNotification_get_object(notification)};\n auto w = get_associated_webview(self);\n w->on_window_will_close(self, window);\n }),\n \"v@:@\");\n objc_registerClassPair(cls);\n }\n return objc::Class_new(cls);\n }\n static cocoa_wkwebview_engine *get_associated_webview(id object) {\n objc::autoreleasepool arp;\n if (id assoc_obj{objc_getAssociatedObject(object, \"webview\")}) {\n cocoa_wkwebview_engine *w{};\n NSValue_getValue(assoc_obj, &w, sizeof(w));\n return w;\n }\n return nullptr;\n }\n static void set_associated_webview(id object, cocoa_wkwebview_engine *w) {\n objc::autoreleasepool arp;\n objc_setAssociatedObject(object, \"webview\", NSValue_valueWithPointer(w),\n OBJC_ASSOCIATION_RETAIN);\n }\n static bool is_app_bundled() noexcept {\n auto bundle = NSBundle_get_mainBundle();\n if (!bundle) {\n return false;\n }\n auto bundle_path = NSBundle_get_bundlePath(bundle);\n auto bundled =\n NSString_hasSuffix(bundle_path, NSString_stringWithUTF8String(\".app\"));\n return !!bundled;\n }\n void on_application_did_finish_launching(id /*delegate*/, id app) {\n // See comments related to application lifecycle in create_app_delegate().\n if (owns_window()) {\n // Stop the main run loop so that we can return\n // from the constructor.\n stop_run_loop();\n }\n\n // Activate the app if it is not bundled.\n // Bundled apps launched from Finder are activated automatically but\n // otherwise not. Activating the app even when it has been launched from\n // Finder does not seem to be harmful but calling this function is rarely\n // needed as proper activation is normally taken care of for us.\n // Bundled apps have a default activation policy of\n // NSApplicationActivationPolicyRegular while non-bundled apps have a\n // default activation policy of NSApplicationActivationPolicyProhibited.\n if (!is_app_bundled()) {\n // \"setActivationPolicy:\" must be invoked before\n // \"activateIgnoringOtherApps:\" for activation to work.\n NSApplication_setActivationPolicy(app,\n NSApplicationActivationPolicyRegular);\n // Activate the app regardless of other active apps.\n // This can be obtrusive so we only do it when necessary.\n NSApplication_activateIgnoringOtherApps(app, true);\n }\n\n window_init_proceed();\n }\n void on_window_will_close(id /*delegate*/, id /*window*/) {\n // Widget destroyed along with window.\n m_widget = nullptr;\n m_webview = nullptr;\n m_window = nullptr;\n dispatch([this] { on_window_destroyed(); });\n }\n void window_settings(bool debug) {\n objc::autoreleasepool arp;\n\n auto config{objc::autorelease(WKWebViewConfiguration_new())};\n\n m_manager = WKWebViewConfiguration_get_userContentController(config);\n\n auto preferences = WKWebViewConfiguration_get_preferences(config);\n auto yes_value = NSNumber_numberWithBool(true);\n\n if (debug) {\n NSObject_setValue_forKey(\n preferences, yes_value,\n NSString_stringWithUTF8String(\"developerExtrasEnabled\"));\n }\n\n NSObject_setValue_forKey(\n preferences, yes_value,\n NSString_stringWithUTF8String(\"fullScreenEnabled\"));\n\n#if defined(__has_builtin)\n#if __has_builtin(__builtin_available)\n if (__builtin_available(macOS 10.13, *)) {\n NSObject_setValue_forKey(\n preferences, yes_value,\n NSString_stringWithUTF8String(\"javaScriptCanAccessClipboard\"));\n NSObject_setValue_forKey(\n preferences, yes_value,\n NSString_stringWithUTF8String(\"DOMPasteAllowed\"));\n }\n#else\n#error __builtin_available not supported by compiler\n#endif\n#else\n#error __has_builtin not supported by compiler\n#endif\n\n auto ui_delegate = create_webkit_ui_delegate();\n m_webview =\n objc::retain(WKWebView_withFrame(CGRectMake(0, 0, 0, 0), config));\n // Autoresizing mask is needed to prevent the Web Inspector pane from\n // pushing the main web view out of bounds\n auto autoresizing_mask{static_cast(\n NSViewWidthSizable | NSViewMaxXMargin | NSViewHeightSizable |\n NSViewMaxYMargin)};\n NSView_set_autoresizingMask(m_webview, autoresizing_mask);\n set_associated_webview(ui_delegate, this);\n WKWebView_set_UIDelegate(m_webview, ui_delegate);\n\n if (debug) {\n // Explicitly make WKWebView inspectable via Safari on OS versions that\n // disable the feature by default (macOS 13.3 and later) and support\n // enabling it. According to Apple, the behavior on older OS versions is\n // for content to always be inspectable in \"debug builds\".\n // Testing shows that this is true for macOS 12.6 but somehow not 10.15.\n // https://webkit.org/blog/13936/enabling-the-inspection-of-web-content-in-apps/\n WKWebView_set_inspectable(m_webview, true);\n }\n\n auto script_message_handler =\n objc::autorelease(create_script_message_handler());\n WKUserContentController_addScriptMessageHandler(\n m_manager, script_message_handler,\n NSString_stringWithUTF8String(\"__webview__\"));\n\n add_init_script(\"function(message) {\\n\\\n return window.webkit.messageHandlers.__webview__.postMessage(message);\\n\\\n}\");\n set_up_widget();\n NSWindow_set_contentView(m_window, m_widget);\n if (owns_window()) {\n NSWindow_makeKeyAndOrderFront(m_window);\n }\n }\n void set_up_widget() {\n objc::autoreleasepool arp;\n // Create a new view that can contain both the web view and the Web Inspector pane\n m_widget = objc::retain(NSView_withFrame(NSRectMake(0, 0, 0, 0)));\n // Autoresizing is needed because the Web Inspector pane is a sibling of the web view\n NSView_set_autoresizesSubviews(m_widget, true);\n NSView_addSubview(m_widget, m_webview);\n NSView_set_frame(m_webview, NSView_get_bounds(m_widget));\n }\n void stop_run_loop() {\n objc::autoreleasepool arp;\n // Request the run loop to stop. This doesn't immediately stop the loop.\n NSApplication_stop(m_app);\n // The run loop will stop after processing an NSEvent.\n auto event{NSEvent_otherEventWithType(\n NSEventTypeApplicationDefined, NSPointMake(0, 0),\n NSEventModifierFlags{}, 0, 0, nullptr, 0, 0, 0)};\n NSApplication_postEvent(m_app, event, true);\n }\n static bool get_and_set_is_first_instance() noexcept {\n static std::atomic_bool first{true};\n bool temp = first;\n if (temp) {\n first = false;\n }\n return temp;\n }\n void window_init(void *window) {\n objc::autoreleasepool arp;\n\n m_window = static_cast(window);\n if (!owns_window()) {\n return;\n }\n\n // Skip application setup if this isn't the first instance of this class\n // because the launch event is only sent once.\n if (!get_and_set_is_first_instance()) {\n window_init_proceed();\n return;\n }\n\n m_app_delegate = create_app_delegate();\n set_associated_webview(m_app_delegate, this);\n NSApplication_set_delegate(m_app, m_app_delegate);\n\n // Start the main run loop so that the app delegate gets the\n // NSApplicationDidFinishLaunchingNotification notification after the run\n // loop has started in order to perform further initialization.\n // We need to return from this constructor so this run loop is only\n // temporary.\n NSApplication_run(m_app);\n }\n void window_init_proceed() {\n objc::autoreleasepool arp;\n\n m_window = objc::retain(NSWindow_withContentRect(\n NSRectMake(0, 0, 0, 0), NSWindowStyleMaskTitled, NSBackingStoreBuffered,\n false));\n m_window_delegate = create_window_delegate();\n set_associated_webview(m_window_delegate, this);\n NSWindow_set_delegate(m_window, m_window_delegate);\n on_window_created();\n }\n\n noresult window_show() {\n objc::autoreleasepool arp;\n if (m_is_window_shown) {\n return {};\n }\n m_is_window_shown = true;\n return {};\n }\n\n void run_event_loop_while(std::function fn) override {\n objc::autoreleasepool arp;\n while (fn()) {\n objc::autoreleasepool arp2;\n if (auto event{NSApplication_nextEventMatchingMask(\n m_app, NSEventMaskAny, nullptr,\n NSRunLoopMode::NSDefaultRunLoopMode(), true)}) {\n NSApplication_sendEvent(m_app, event);\n }\n }\n }\n\n id m_app{};\n id m_app_delegate{};\n id m_window_delegate{};\n id m_window{};\n id m_widget{};\n id m_webview{};\n id m_manager{};\n bool m_is_window_shown{};\n};\n\n} // namespace cocoa_webkit\n} // namespace detail\n\nusing browser_engine = detail::cocoa_webkit::cocoa_wkwebview_engine;\n\n} // namespace webview\n\n#endif // defined(WEBVIEW_PLATFORM_DARWIN) && defined(WEBVIEW_COCOA)\n#endif // defined(__cplusplus) && !defined(WEBVIEW_HEADER)\n#endif // WEBVIEW_BACKENDS_COCOA_WEBKIT_HH\n"
},
{
"path": "core/include/webview/detail/backends/gtk_webkitgtk.hh",
"content": "/*\n * MIT License\n *\n * Copyright (c) 2017 Serge Zaitsev\n * Copyright (c) 2022 Steffen André Langnes\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\n#ifndef WEBVIEW_BACKENDS_GTK_WEBKITGTK_HH\n#define WEBVIEW_BACKENDS_GTK_WEBKITGTK_HH\n\n#if defined(__cplusplus) && !defined(WEBVIEW_HEADER)\n\n#include \"../../macros.h\"\n\n#if defined(WEBVIEW_PLATFORM_LINUX) && defined(WEBVIEW_GTK)\n\n//\n// ====================================================================\n//\n// This implementation uses webkit2gtk backend. It requires GTK and\n// WebKitGTK libraries. Proper compiler flags can be retrieved via:\n//\n// pkg-config --cflags --libs gtk4 webkitgtk-6.0\n// pkg-config --cflags --libs gtk+-3.0 webkit2gtk-4.1\n// pkg-config --cflags --libs gtk+-3.0 webkit2gtk-4.0\n//\n// ====================================================================\n//\n\n#include \"../../errors.hh\"\n#include \"../../types.hh\"\n#include \"../engine_base.hh\"\n#include \"../platform/linux/gtk/compat.hh\"\n#include \"../platform/linux/webkitgtk/compat.hh\"\n#include \"../platform/linux/webkitgtk/dmabuf.hh\"\n#include \"../user_script.hh\"\n\n#include \n#include \n#include \n#include \n\n#include \n\n#if GTK_MAJOR_VERSION >= 4\n\n#include \n#include \n\n#elif GTK_MAJOR_VERSION >= 3\n\n#include \n#include \n\n#endif\n\n#include \n#include \n\nnamespace webview {\nnamespace detail {\n\nclass user_script::impl {\npublic:\n impl(WebKitUserScript *script) : m_script{script} {\n webkit_user_script_ref(script);\n }\n\n ~impl() { webkit_user_script_unref(m_script); }\n\n impl(const impl &) = delete;\n impl &operator=(const impl &) = delete;\n impl(impl &&) = delete;\n impl &operator=(impl &&) = delete;\n\n WebKitUserScript *get_native() const { return m_script; }\n\nprivate:\n WebKitUserScript *m_script{};\n};\n\nclass gtk_webkit_engine : public engine_base {\npublic:\n gtk_webkit_engine(bool debug, void *window) : engine_base{!window} {\n window_init(window);\n window_settings(debug);\n dispatch_size_default();\n }\n\n gtk_webkit_engine(const gtk_webkit_engine &) = delete;\n gtk_webkit_engine &operator=(const gtk_webkit_engine &) = delete;\n gtk_webkit_engine(gtk_webkit_engine &&) = delete;\n gtk_webkit_engine &operator=(gtk_webkit_engine &&) = delete;\n\n virtual ~gtk_webkit_engine() {\n if (m_window) {\n if (owns_window()) {\n // Disconnect handlers to avoid callbacks invoked during destruction.\n g_signal_handlers_disconnect_by_data(GTK_WINDOW(m_window), this);\n gtk_window_close(GTK_WINDOW(m_window));\n on_window_destroyed(true);\n } else {\n gtk_compat::window_remove_child(GTK_WINDOW(m_window),\n GTK_WIDGET(m_webview));\n }\n }\n if (m_webview) {\n g_object_unref(m_webview);\n }\n if (owns_window()) {\n // Needed for the window to close immediately.\n deplete_run_loop_event_queue();\n }\n }\n\nprotected:\n result window_impl() override {\n if (m_window) {\n return m_window;\n }\n return error_info{WEBVIEW_ERROR_INVALID_STATE};\n }\n\n result widget_impl() override {\n if (m_webview) {\n return m_webview;\n }\n return error_info{WEBVIEW_ERROR_INVALID_STATE};\n }\n\n result browser_controller_impl() override {\n if (m_webview) {\n return m_webview;\n }\n return error_info{WEBVIEW_ERROR_INVALID_STATE};\n }\n\n noresult run_impl() override {\n m_stop_run_loop = false;\n while (!m_stop_run_loop) {\n g_main_context_iteration(nullptr, TRUE);\n }\n return {};\n }\n\n noresult terminate_impl() override {\n return dispatch_impl([&] { m_stop_run_loop = true; });\n }\n\n noresult dispatch_impl(std::function f) override {\n g_idle_add_full(G_PRIORITY_HIGH_IDLE, (GSourceFunc)([](void *fn) -> int {\n (*static_cast(fn))();\n return G_SOURCE_REMOVE;\n }),\n new std::function(f),\n [](void *fn) { delete static_cast(fn); });\n return {};\n }\n\n noresult set_title_impl(const std::string &title) override {\n gtk_window_set_title(GTK_WINDOW(m_window), title.c_str());\n return {};\n }\n\n noresult set_size_impl(int width, int height, webview_hint_t hints) override {\n gtk_window_set_resizable(GTK_WINDOW(m_window), hints != WEBVIEW_HINT_FIXED);\n if (hints == WEBVIEW_HINT_NONE || hints == WEBVIEW_HINT_FIXED) {\n gtk_compat::window_set_size(GTK_WINDOW(m_window), width, height);\n } else if (hints == WEBVIEW_HINT_MIN) {\n gtk_widget_set_size_request(m_window, width, height);\n } else if (hints == WEBVIEW_HINT_MAX) {\n gtk_compat::window_set_max_size(GTK_WINDOW(m_window), width, height);\n } else {\n return error_info{WEBVIEW_ERROR_INVALID_ARGUMENT, \"Invalid hint\"};\n }\n return window_show();\n }\n\n noresult navigate_impl(const std::string &url) override {\n webkit_web_view_load_uri(WEBKIT_WEB_VIEW(m_webview), url.c_str());\n return {};\n }\n\n noresult set_html_impl(const std::string &html) override {\n webkit_web_view_load_html(WEBKIT_WEB_VIEW(m_webview), html.c_str(),\n nullptr);\n return {};\n }\n\n noresult eval_impl(const std::string &js) override {\n // URI is null before content has begun loading.\n if (!webkit_web_view_get_uri(WEBKIT_WEB_VIEW(m_webview))) {\n return {};\n }\n#if (WEBKIT_MAJOR_VERSION == 2 && WEBKIT_MINOR_VERSION >= 40) || \\\n WEBKIT_MAJOR_VERSION > 2\n webkit_web_view_evaluate_javascript(WEBKIT_WEB_VIEW(m_webview), js.c_str(),\n static_cast(js.size()), nullptr,\n nullptr, nullptr, nullptr, nullptr);\n#else\n webkit_web_view_run_javascript(WEBKIT_WEB_VIEW(m_webview), js.c_str(),\n nullptr, nullptr, nullptr);\n#endif\n return {};\n }\n\n user_script add_user_script_impl(const std::string &js) override {\n auto *wk_script = webkit_user_script_new(\n js.c_str(), WEBKIT_USER_CONTENT_INJECT_TOP_FRAME,\n WEBKIT_USER_SCRIPT_INJECT_AT_DOCUMENT_START, nullptr, nullptr);\n webkit_user_content_manager_add_script(m_user_content_manager, wk_script);\n user_script script{\n js, user_script::impl_ptr{new user_script::impl{wk_script},\n [](user_script::impl *p) { delete p; }}};\n webkit_user_script_unref(wk_script);\n return script;\n }\n\n void remove_all_user_scripts_impl(\n const std::list & /*scripts*/) override {\n webkit_user_content_manager_remove_all_scripts(m_user_content_manager);\n }\n\n bool are_user_scripts_equal_impl(const user_script &first,\n const user_script &second) override {\n auto *wk_first = first.get_impl().get_native();\n auto *wk_second = second.get_impl().get_native();\n return wk_first == wk_second;\n }\n\nprivate:\n#if GTK_MAJOR_VERSION >= 4\n static char *get_string_from_js_result(JSCValue *r) {\n return jsc_value_to_string(r);\n }\n#else\n static char *get_string_from_js_result(WebKitJavascriptResult *r) {\n char *s;\n#if (WEBKIT_MAJOR_VERSION == 2 && WEBKIT_MINOR_VERSION >= 22) || \\\n WEBKIT_MAJOR_VERSION > 2\n JSCValue *value = webkit_javascript_result_get_js_value(r);\n s = jsc_value_to_string(value);\n#else\n JSGlobalContextRef ctx = webkit_javascript_result_get_global_context(r);\n JSValueRef value = webkit_javascript_result_get_value(r);\n JSStringRef js = JSValueToStringCopy(ctx, value, nullptr);\n size_t n = JSStringGetMaximumUTF8CStringSize(js);\n s = g_new(char, n);\n JSStringGetUTF8CString(js, s, n);\n JSStringRelease(js);\n#endif\n return s;\n }\n#endif\n\n void window_init(void *window) {\n m_window = static_cast(window);\n if (owns_window()) {\n if (!gtk_compat::init_check()) {\n throw exception{WEBVIEW_ERROR_UNSPECIFIED, \"GTK init failed\"};\n }\n m_window = gtk_compat::window_new();\n on_window_created();\n auto on_window_destroy = +[](GtkWidget *, gpointer arg) {\n auto *w = static_cast(arg);\n w->m_window = nullptr;\n w->on_window_destroyed();\n };\n g_signal_connect(G_OBJECT(m_window), \"destroy\",\n G_CALLBACK(on_window_destroy), this);\n }\n webkit_dmabuf::apply_webkit_dmabuf_workaround();\n // Initialize webview widget\n m_webview = webkit_web_view_new();\n g_object_ref_sink(m_webview);\n WebKitUserContentManager *manager = m_user_content_manager =\n webkit_web_view_get_user_content_manager(WEBKIT_WEB_VIEW(m_webview));\n webkitgtk_compat::connect_script_message_received(\n manager, \"__webview__\",\n [this](WebKitUserContentManager *, const std::string &r) {\n on_message(r);\n });\n webkitgtk_compat::user_content_manager_register_script_message_handler(\n manager, \"__webview__\");\n add_init_script(\"function(message) {\\n\\\n return window.webkit.messageHandlers.__webview__.postMessage(message);\\n\\\n}\");\n }\n\n void window_settings(bool debug) {\n WebKitSettings *settings =\n webkit_web_view_get_settings(WEBKIT_WEB_VIEW(m_webview));\n webkit_settings_set_javascript_can_access_clipboard(settings, true);\n if (debug) {\n webkit_settings_set_enable_write_console_messages_to_stdout(settings,\n true);\n webkit_settings_set_enable_developer_extras(settings, true);\n }\n }\n\n noresult window_show() {\n if (m_is_window_shown) {\n return {};\n }\n gtk_compat::window_set_child(GTK_WINDOW(m_window), GTK_WIDGET(m_webview));\n gtk_compat::widget_set_visible(GTK_WIDGET(m_webview), true);\n\n if (owns_window()) {\n gtk_widget_grab_focus(GTK_WIDGET(m_webview));\n gtk_compat::widget_set_visible(GTK_WIDGET(m_window), true);\n }\n m_is_window_shown = true;\n return {};\n }\n\n void run_event_loop_while(std::function fn) override {\n while (fn()) {\n g_main_context_iteration(nullptr, TRUE);\n }\n }\n\n GtkWidget *m_window{};\n GtkWidget *m_webview{};\n WebKitUserContentManager *m_user_content_manager{};\n bool m_stop_run_loop{};\n bool m_is_window_shown{};\n};\n\n} // namespace detail\n\nusing browser_engine = detail::gtk_webkit_engine;\n\n} // namespace webview\n\n#endif // defined(WEBVIEW_PLATFORM_LINUX) && defined(WEBVIEW_GTK)\n#endif // defined(__cplusplus) && !defined(WEBVIEW_HEADER)\n#endif // WEBVIEW_BACKENDS_GTK_WEBKITGTK_HH\n"
},
{
"path": "core/include/webview/detail/backends/win32_edge.hh",
"content": "/*\n * MIT License\n *\n * Copyright (c) 2017 Serge Zaitsev\n * Copyright (c) 2022 Steffen André Langnes\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\n#ifndef WEBVIEW_BACKENDS_WIN32_EDGE_HH\n#define WEBVIEW_BACKENDS_WIN32_EDGE_HH\n\n#if defined(__cplusplus) && !defined(WEBVIEW_HEADER)\n\n#include \"../../macros.h\"\n\n#if defined(WEBVIEW_PLATFORM_WINDOWS) && defined(WEBVIEW_EDGE)\n\n//\n// ====================================================================\n//\n// This implementation uses Win32 API to create a native window. It\n// uses Edge/Chromium webview2 backend as a browser engine.\n//\n// ====================================================================\n//\n\n#include \"../../errors.hh\"\n#include \"../../types.hh\"\n#include \"../engine_base.hh\"\n#include \"../native_library.hh\"\n#include \"../platform/windows/com_init_wrapper.hh\"\n#include \"../platform/windows/dpi.hh\"\n#include \"../platform/windows/iid.hh\"\n#include \"../platform/windows/reg_key.hh\"\n#include \"../platform/windows/theme.hh\"\n#include \"../platform/windows/version.hh\"\n#include \"../platform/windows/webview2/loader.hh\"\n#include \"../user_script.hh\"\n#include \"../utility/string.hh\"\n\n#include \n#include \n#include \n#include \n#include \n#include \n\n#ifndef WIN32_LEAN_AND_MEAN\n#define WIN32_LEAN_AND_MEAN\n#endif\n\n#include \n\n#include \n#include \n#include \n\n#ifdef _MSC_VER\n#pragma comment(lib, \"ole32.lib\")\n#pragma comment(lib, \"shell32.lib\")\n#pragma comment(lib, \"shlwapi.lib\")\n#pragma comment(lib, \"user32.lib\")\n#pragma comment(lib, \"version.lib\")\n#endif\n\nnamespace webview {\nnamespace detail {\n\nusing msg_cb_t = std::function;\n\nclass webview2_com_handler\n : public ICoreWebView2CreateCoreWebView2EnvironmentCompletedHandler,\n public ICoreWebView2CreateCoreWebView2ControllerCompletedHandler,\n public ICoreWebView2WebMessageReceivedEventHandler,\n public ICoreWebView2PermissionRequestedEventHandler {\n using webview2_com_handler_cb_t =\n std::function;\n\npublic:\n webview2_com_handler(HWND hwnd, msg_cb_t msgCb, webview2_com_handler_cb_t cb)\n : m_window(hwnd), m_msgCb(msgCb), m_cb(cb) {}\n\n virtual ~webview2_com_handler() = default;\n webview2_com_handler(const webview2_com_handler &other) = delete;\n webview2_com_handler &operator=(const webview2_com_handler &other) = delete;\n webview2_com_handler(webview2_com_handler &&other) = delete;\n webview2_com_handler &operator=(webview2_com_handler &&other) = delete;\n\n ULONG STDMETHODCALLTYPE AddRef() { return ++m_ref_count; }\n ULONG STDMETHODCALLTYPE Release() {\n if (m_ref_count > 1) {\n return --m_ref_count;\n }\n delete this;\n return 0;\n }\n HRESULT STDMETHODCALLTYPE QueryInterface(REFIID riid, LPVOID *ppv) {\n using namespace mswebview2::cast_info;\n\n if (!ppv) {\n return E_POINTER;\n }\n\n // All of the COM interfaces we implement should be added here regardless\n // of whether they are required.\n // This is just to be on the safe side in case the WebView2 Runtime ever\n // requests a pointer to an interface we implement.\n // The WebView2 Runtime must at the very least be able to get a pointer to\n // ICoreWebView2CreateCoreWebView2EnvironmentCompletedHandler when we use\n // our custom WebView2 loader implementation, and observations have shown\n // that it is the only interface requested in this case. None have been\n // observed to be requested when using the official WebView2 loader.\n\n if (cast_if_equal_iid(this, riid, controller_completed, ppv) ||\n cast_if_equal_iid(this, riid, environment_completed, ppv) ||\n cast_if_equal_iid(this, riid, message_received, ppv) ||\n cast_if_equal_iid(this, riid, permission_requested, ppv)) {\n return S_OK;\n }\n\n return E_NOINTERFACE;\n }\n HRESULT STDMETHODCALLTYPE Invoke(HRESULT res, ICoreWebView2Environment *env) {\n if (SUCCEEDED(res)) {\n res = env->CreateCoreWebView2Controller(m_window, this);\n if (SUCCEEDED(res)) {\n return S_OK;\n }\n }\n try_create_environment();\n return S_OK;\n }\n HRESULT STDMETHODCALLTYPE Invoke(HRESULT res,\n ICoreWebView2Controller *controller) {\n if (FAILED(res)) {\n // See try_create_environment() regarding\n // HRESULT_FROM_WIN32(ERROR_INVALID_STATE).\n // The result is E_ABORT if the parent window has been destroyed already.\n switch (res) {\n case HRESULT_FROM_WIN32(ERROR_INVALID_STATE):\n case E_ABORT:\n return S_OK;\n }\n try_create_environment();\n return S_OK;\n }\n\n ICoreWebView2 *webview;\n ::EventRegistrationToken token;\n controller->get_CoreWebView2(&webview);\n webview->add_WebMessageReceived(this, &token);\n webview->add_PermissionRequested(this, &token);\n\n m_cb(controller, webview);\n return S_OK;\n }\n HRESULT STDMETHODCALLTYPE\n Invoke(ICoreWebView2 * /*sender*/,\n ICoreWebView2WebMessageReceivedEventArgs *args) {\n LPWSTR message{};\n auto res = args->TryGetWebMessageAsString(&message);\n if (SUCCEEDED(res)) {\n m_msgCb(narrow_string(message));\n }\n\n CoTaskMemFree(message);\n return S_OK;\n }\n HRESULT STDMETHODCALLTYPE\n Invoke(ICoreWebView2 * /*sender*/,\n ICoreWebView2PermissionRequestedEventArgs *args) {\n COREWEBVIEW2_PERMISSION_KIND kind;\n args->get_PermissionKind(&kind);\n if (kind == COREWEBVIEW2_PERMISSION_KIND_CLIPBOARD_READ) {\n args->put_State(COREWEBVIEW2_PERMISSION_STATE_ALLOW);\n }\n return S_OK;\n }\n\n // Set the function that will perform the initiating logic for creating\n // the WebView2 environment.\n void set_attempt_handler(std::function attempt_handler) noexcept {\n m_attempt_handler = attempt_handler;\n }\n\n // Retry creating a WebView2 environment.\n // The initiating logic for creating the environment is defined by the\n // caller of set_attempt_handler().\n void try_create_environment() noexcept {\n // WebView creation fails with HRESULT_FROM_WIN32(ERROR_INVALID_STATE) if\n // a running instance using the same user data folder exists, and the\n // Environment objects have different EnvironmentOptions.\n // Source: https://docs.microsoft.com/en-us/microsoft-edge/webview2/reference/win32/icorewebview2environment?view=webview2-1.0.1150.38\n if (m_attempts < m_max_attempts) {\n ++m_attempts;\n auto res = m_attempt_handler();\n if (SUCCEEDED(res)) {\n return;\n }\n // Not entirely sure if this error code only applies to\n // CreateCoreWebView2Controller so we check here as well.\n if (res == HRESULT_FROM_WIN32(ERROR_INVALID_STATE)) {\n return;\n }\n // Wait for m_sleep_ms before trying again.\n Sleep(m_sleep_ms);\n try_create_environment();\n return;\n }\n // Give up.\n m_cb(nullptr, nullptr);\n }\n\nprivate:\n HWND m_window;\n msg_cb_t m_msgCb;\n webview2_com_handler_cb_t m_cb;\n std::atomic m_ref_count{1};\n std::function m_attempt_handler;\n unsigned int m_max_attempts = 60;\n unsigned int m_sleep_ms = 200;\n unsigned int m_attempts = 0;\n};\n\nclass webview2_user_script_added_handler\n : public ICoreWebView2AddScriptToExecuteOnDocumentCreatedCompletedHandler {\npublic:\n using callback_fn = std::function;\n\n webview2_user_script_added_handler(callback_fn cb) : m_cb{cb} {}\n\n virtual ~webview2_user_script_added_handler() = default;\n webview2_user_script_added_handler(\n const webview2_user_script_added_handler &other) = delete;\n webview2_user_script_added_handler &\n operator=(const webview2_user_script_added_handler &other) = delete;\n webview2_user_script_added_handler(\n webview2_user_script_added_handler &&other) = delete;\n webview2_user_script_added_handler &\n operator=(webview2_user_script_added_handler &&other) = delete;\n\n ULONG STDMETHODCALLTYPE AddRef() { return ++m_ref_count; }\n ULONG STDMETHODCALLTYPE Release() {\n if (m_ref_count > 1) {\n return --m_ref_count;\n }\n delete this;\n return 0;\n }\n\n HRESULT STDMETHODCALLTYPE QueryInterface(REFIID riid, LPVOID *ppv) {\n using namespace mswebview2::cast_info;\n\n if (!ppv) {\n return E_POINTER;\n }\n\n if (cast_if_equal_iid(this, riid,\n add_script_to_execute_on_document_created_completed,\n ppv)) {\n return S_OK;\n }\n\n return E_NOINTERFACE;\n }\n\n HRESULT STDMETHODCALLTYPE Invoke(HRESULT res, LPCWSTR id) {\n m_cb(res, id);\n return S_OK;\n }\n\nprivate:\n callback_fn m_cb;\n std::atomic m_ref_count{1};\n};\n\nclass user_script::impl {\npublic:\n impl(const std::wstring &id, const std::wstring &code)\n : m_id{id}, m_code{code} {}\n\n impl(const impl &) = delete;\n impl &operator=(const impl &) = delete;\n impl(impl &&) = delete;\n impl &operator=(impl &&) = delete;\n\n const std::wstring &get_id() const { return m_id; }\n const std::wstring &get_code() const { return m_code; }\n\nprivate:\n std::wstring m_id;\n std::wstring m_code;\n};\n\nclass win32_edge_engine : public engine_base {\npublic:\n win32_edge_engine(bool debug, void *window) : engine_base{!window} {\n window_init(window);\n window_settings(debug);\n dispatch_size_default();\n }\n\n virtual ~win32_edge_engine() {\n if (m_com_handler) {\n m_com_handler->Release();\n m_com_handler = nullptr;\n }\n if (m_webview) {\n m_webview->Release();\n m_webview = nullptr;\n }\n if (m_controller) {\n m_controller->Release();\n m_controller = nullptr;\n }\n // Replace wndproc to avoid callbacks and other bad things during\n // destruction.\n auto wndproc = reinterpret_cast(\n +[](HWND hwnd, UINT msg, WPARAM wp, LPARAM lp) -> LRESULT {\n return DefWindowProcW(hwnd, msg, wp, lp);\n });\n if (m_widget) {\n SetWindowLongPtrW(m_widget, GWLP_WNDPROC, wndproc);\n }\n if (m_window && owns_window()) {\n SetWindowLongPtrW(m_window, GWLP_WNDPROC, wndproc);\n }\n if (m_widget) {\n DestroyWindow(m_widget);\n m_widget = nullptr;\n }\n if (m_window) {\n if (owns_window()) {\n DestroyWindow(m_window);\n on_window_destroyed(true);\n }\n m_window = nullptr;\n }\n if (owns_window()) {\n // Not strictly needed for windows to close immediately but aligns\n // behavior across backends.\n deplete_run_loop_event_queue();\n }\n // We need the message window in order to deplete the event queue.\n if (m_message_window) {\n SetWindowLongPtrW(m_message_window, GWLP_WNDPROC, wndproc);\n DestroyWindow(m_message_window);\n m_message_window = nullptr;\n }\n }\n\n win32_edge_engine(const win32_edge_engine &other) = delete;\n win32_edge_engine &operator=(const win32_edge_engine &other) = delete;\n win32_edge_engine(win32_edge_engine &&other) = delete;\n win32_edge_engine &operator=(win32_edge_engine &&other) = delete;\n\nprotected:\n noresult run_impl() override {\n MSG msg;\n while (GetMessageW(&msg, nullptr, 0, 0) > 0) {\n TranslateMessage(&msg);\n DispatchMessageW(&msg);\n }\n return {};\n }\n result window_impl() override {\n if (m_window) {\n return m_window;\n }\n return error_info{WEBVIEW_ERROR_INVALID_STATE};\n }\n result widget_impl() override {\n if (m_widget) {\n return m_widget;\n }\n return error_info{WEBVIEW_ERROR_INVALID_STATE};\n }\n result browser_controller_impl() override {\n if (m_controller) {\n return m_controller;\n }\n return error_info{WEBVIEW_ERROR_INVALID_STATE};\n }\n noresult terminate_impl() override {\n PostQuitMessage(0);\n return {};\n }\n noresult dispatch_impl(dispatch_fn_t f) override {\n PostMessageW(m_message_window, WM_APP, 0, (LPARAM) new dispatch_fn_t(f));\n return {};\n }\n\n noresult set_title_impl(const std::string &title) override {\n SetWindowTextW(m_window, widen_string(title).c_str());\n return {};\n }\n\n noresult set_size_impl(int width, int height, webview_hint_t hints) override {\n auto style = GetWindowLong(m_window, GWL_STYLE);\n if (hints == WEBVIEW_HINT_FIXED) {\n style &= ~(WS_THICKFRAME | WS_MAXIMIZEBOX);\n } else {\n style |= (WS_THICKFRAME | WS_MAXIMIZEBOX);\n }\n SetWindowLong(m_window, GWL_STYLE, style);\n\n if (hints == WEBVIEW_HINT_MAX) {\n m_maxsz.x = width;\n m_maxsz.y = height;\n } else if (hints == WEBVIEW_HINT_MIN) {\n m_minsz.x = width;\n m_minsz.y = height;\n } else {\n auto dpi = get_window_dpi(m_window);\n m_dpi = dpi;\n auto scaled_size =\n scale_size(width, height, get_default_window_dpi(), dpi);\n auto frame_size =\n make_window_frame_size(m_window, scaled_size.cx, scaled_size.cy, dpi);\n SetWindowPos(m_window, nullptr, 0, 0, frame_size.cx, frame_size.cy,\n SWP_NOZORDER | SWP_NOACTIVATE | SWP_NOMOVE |\n SWP_FRAMECHANGED);\n }\n return window_show();\n }\n\n noresult navigate_impl(const std::string &url) override {\n auto wurl = widen_string(url);\n m_webview->Navigate(wurl.c_str());\n return {};\n }\n\n noresult eval_impl(const std::string &js) override {\n // TODO: Skip if no content has begun loading yet. Can't check with\n // ICoreWebView2::get_Source because it returns \"about:blank\".\n auto wjs = widen_string(js);\n m_webview->ExecuteScript(wjs.c_str(), nullptr);\n return {};\n }\n\n noresult set_html_impl(const std::string &html) override {\n m_webview->NavigateToString(widen_string(html).c_str());\n return {};\n }\n\n user_script add_user_script_impl(const std::string &js) override {\n auto wjs = widen_string(js);\n std::wstring script_id;\n bool done{};\n webview2_user_script_added_handler handler{[&](HRESULT res, LPCWSTR id) {\n if (SUCCEEDED(res)) {\n script_id = id;\n }\n done = true;\n }};\n auto res =\n m_webview->AddScriptToExecuteOnDocumentCreated(wjs.c_str(), &handler);\n if (SUCCEEDED(res)) {\n // We want to guard against executing the default `set_size` prematurely\n set_default_size_guard(true);\n // Sadly we need to pump the event loop in order to get the script ID.\n run_event_loop_while([&] { return !done; });\n // The user's `set_size` may have been executed from the depleted event queue,\n // and if so, guard against putting the default `set_size` back onto the queue.\n if (!m_is_window_shown) {\n set_default_size_guard(false);\n dispatch_size_default();\n }\n }\n // TODO: There's a non-zero chance that we didn't get the script ID.\n // We need to convey the error somehow.\n return user_script{\n js, user_script::impl_ptr{new user_script::impl{script_id, wjs},\n [](user_script::impl *p) { delete p; }}};\n }\n\n void\n remove_all_user_scripts_impl(const std::list &scripts) override {\n for (const auto &script : scripts) {\n const auto &id = script.get_impl().get_id();\n m_webview->RemoveScriptToExecuteOnDocumentCreated(id.c_str());\n }\n }\n\n bool are_user_scripts_equal_impl(const user_script &first,\n const user_script &second) override {\n const auto &first_id = first.get_impl().get_id();\n const auto &second_id = second.get_impl().get_id();\n return first_id == second_id;\n }\n\nprivate:\n void window_init(void *window) {\n if (!is_webview2_available()) {\n throw exception{WEBVIEW_ERROR_MISSING_DEPENDENCY,\n \"WebView2 is unavailable\"};\n }\n\n HINSTANCE hInstance = GetModuleHandle(nullptr);\n\n if (owns_window()) {\n m_com_init = {COINIT_APARTMENTTHREADED};\n enable_dpi_awareness();\n\n HICON icon = (HICON)LoadImage(\n hInstance, IDI_APPLICATION, IMAGE_ICON, GetSystemMetrics(SM_CXICON),\n GetSystemMetrics(SM_CYICON), LR_DEFAULTCOLOR);\n\n // Create a top-level window.\n WNDCLASSEXW wc;\n ZeroMemory(&wc, sizeof(WNDCLASSEX));\n wc.cbSize = sizeof(WNDCLASSEX);\n wc.hInstance = hInstance;\n wc.lpszClassName = L\"webview\";\n wc.hIcon = icon;\n wc.lpfnWndProc = (WNDPROC)(+[](HWND hwnd, UINT msg, WPARAM wp,\n LPARAM lp) -> LRESULT {\n win32_edge_engine *w{};\n\n if (msg == WM_NCCREATE) {\n auto *lpcs{reinterpret_cast(lp)};\n w = static_cast(lpcs->lpCreateParams);\n w->m_window = hwnd;\n SetWindowLongPtrW(hwnd, GWLP_USERDATA, reinterpret_cast(w));\n enable_non_client_dpi_scaling_if_needed(hwnd);\n apply_window_theme(hwnd);\n } else {\n w = reinterpret_cast(\n GetWindowLongPtrW(hwnd, GWLP_USERDATA));\n }\n\n if (!w) {\n return DefWindowProcW(hwnd, msg, wp, lp);\n }\n\n switch (msg) {\n case WM_SIZE:\n w->resize_widget();\n break;\n case WM_CLOSE:\n DestroyWindow(hwnd);\n break;\n case WM_DESTROY:\n w->m_window = nullptr;\n SetWindowLongPtrW(hwnd, GWLP_USERDATA, 0);\n w->on_window_destroyed();\n break;\n case WM_GETMINMAXINFO: {\n auto lpmmi = (LPMINMAXINFO)lp;\n if (w->m_maxsz.x > 0 && w->m_maxsz.y > 0) {\n lpmmi->ptMaxSize = w->m_maxsz;\n lpmmi->ptMaxTrackSize = w->m_maxsz;\n }\n if (w->m_minsz.x > 0 && w->m_minsz.y > 0) {\n lpmmi->ptMinTrackSize = w->m_minsz;\n }\n } break;\n case 0x02E4 /*WM_GETDPISCALEDSIZE*/: {\n auto dpi = static_cast(wp);\n auto *size{reinterpret_cast(lp)};\n *size = w->get_scaled_size(w->m_dpi, dpi);\n return TRUE;\n }\n case 0x02E0 /*WM_DPICHANGED*/: {\n // Windows 10: The size we get here is exactly what we supplied to WM_GETDPISCALEDSIZE.\n // Windows 11: The size we get here is NOT what we supplied to WM_GETDPISCALEDSIZE.\n // Due to this difference, don't use the suggested bounds.\n auto dpi = static_cast(HIWORD(wp));\n w->on_dpi_changed(dpi);\n break;\n }\n case WM_SETTINGCHANGE: {\n auto *area = reinterpret_cast(lp);\n if (area) {\n w->on_system_setting_change(area);\n }\n break;\n }\n case WM_ACTIVATE:\n if (LOWORD(wp) != WA_INACTIVE) {\n w->focus_webview();\n }\n break;\n default:\n return DefWindowProcW(hwnd, msg, wp, lp);\n }\n return 0;\n });\n RegisterClassExW(&wc);\n\n CreateWindowW(L\"webview\", L\"\", WS_OVERLAPPEDWINDOW, CW_USEDEFAULT,\n CW_USEDEFAULT, 0, 0, nullptr, nullptr, hInstance, this);\n if (!m_window) {\n throw exception{WEBVIEW_ERROR_INVALID_STATE, \"Window is null\"};\n }\n on_window_created();\n\n m_dpi = get_window_dpi(m_window);\n } else {\n m_window = IsWindow(static_cast(window))\n ? static_cast(window)\n : *(static_cast(window));\n m_dpi = get_window_dpi(m_window);\n }\n // Create a window that WebView2 will be embedded into.\n WNDCLASSEXW widget_wc{};\n widget_wc.cbSize = sizeof(WNDCLASSEX);\n widget_wc.hInstance = hInstance;\n widget_wc.lpszClassName = L\"webview_widget\";\n widget_wc.lpfnWndProc = (WNDPROC)(+[](HWND hwnd, UINT msg, WPARAM wp,\n LPARAM lp) -> LRESULT {\n win32_edge_engine *w{};\n\n if (msg == WM_NCCREATE) {\n auto *lpcs{reinterpret_cast(lp)};\n w = static_cast(lpcs->lpCreateParams);\n w->m_widget = hwnd;\n SetWindowLongPtrW(hwnd, GWLP_USERDATA, reinterpret_cast(w));\n } else {\n w = reinterpret_cast(\n GetWindowLongPtrW(hwnd, GWLP_USERDATA));\n }\n\n if (!w) {\n return DefWindowProcW(hwnd, msg, wp, lp);\n }\n\n switch (msg) {\n case WM_SIZE:\n w->resize_webview();\n break;\n case WM_DESTROY:\n w->m_widget = nullptr;\n SetWindowLongPtrW(hwnd, GWLP_USERDATA, 0);\n break;\n default:\n return DefWindowProcW(hwnd, msg, wp, lp);\n }\n return 0;\n });\n RegisterClassExW(&widget_wc);\n CreateWindowExW(WS_EX_CONTROLPARENT, L\"webview_widget\", nullptr, WS_CHILD,\n 0, 0, 0, 0, m_window, nullptr, hInstance, this);\n if (!m_widget) {\n throw exception{WEBVIEW_ERROR_INVALID_STATE, \"Widget window is null\"};\n }\n\n // Create a message-only window for internal messaging.\n WNDCLASSEXW message_wc{};\n message_wc.cbSize = sizeof(WNDCLASSEX);\n message_wc.hInstance = hInstance;\n message_wc.lpszClassName = L\"webview_message\";\n message_wc.lpfnWndProc = (WNDPROC)(+[](HWND hwnd, UINT msg, WPARAM wp,\n LPARAM lp) -> LRESULT {\n win32_edge_engine *w{};\n\n if (msg == WM_NCCREATE) {\n auto *lpcs{reinterpret_cast(lp)};\n w = static_cast(lpcs->lpCreateParams);\n w->m_message_window = hwnd;\n SetWindowLongPtrW(hwnd, GWLP_USERDATA, reinterpret_cast(w));\n } else {\n w = reinterpret_cast(\n GetWindowLongPtrW(hwnd, GWLP_USERDATA));\n }\n\n if (!w) {\n return DefWindowProcW(hwnd, msg, wp, lp);\n }\n\n switch (msg) {\n case WM_APP:\n if (auto f = (dispatch_fn_t *)(lp)) {\n (*f)();\n delete f;\n }\n break;\n case WM_DESTROY:\n w->m_message_window = nullptr;\n SetWindowLongPtrW(hwnd, GWLP_USERDATA, 0);\n break;\n default:\n return DefWindowProcW(hwnd, msg, wp, lp);\n }\n return 0;\n });\n RegisterClassExW(&message_wc);\n CreateWindowExW(0, L\"webview_message\", nullptr, 0, 0, 0, 0, 0, HWND_MESSAGE,\n nullptr, hInstance, this);\n if (!m_message_window) {\n throw exception{WEBVIEW_ERROR_INVALID_STATE, \"Message window is null\"};\n }\n }\n\n void window_settings(bool debug) {\n auto cb =\n std::bind(&win32_edge_engine::on_message, this, std::placeholders::_1);\n embed(m_widget, debug, cb).ensure_ok();\n }\n\n noresult window_show() {\n if (owns_window() && !m_is_window_shown) {\n ShowWindow(m_window, SW_SHOW);\n UpdateWindow(m_window);\n SetFocus(m_window);\n m_is_window_shown = true;\n }\n return {};\n }\n noresult embed(HWND wnd, bool debug, msg_cb_t cb) {\n std::atomic_flag flag = ATOMIC_FLAG_INIT;\n flag.test_and_set();\n\n wchar_t currentExePath[MAX_PATH];\n GetModuleFileNameW(nullptr, currentExePath, MAX_PATH);\n wchar_t *currentExeName = PathFindFileNameW(currentExePath);\n\n wchar_t dataPath[MAX_PATH];\n if (!SUCCEEDED(\n SHGetFolderPathW(nullptr, CSIDL_APPDATA, nullptr, 0, dataPath))) {\n return error_info{WEBVIEW_ERROR_UNSPECIFIED, \"SHGetFolderPathW failed\"};\n }\n wchar_t userDataFolder[MAX_PATH];\n PathCombineW(userDataFolder, dataPath, currentExeName);\n\n m_com_handler = new webview2_com_handler(\n wnd, cb,\n [&](ICoreWebView2Controller *controller, ICoreWebView2 *webview) {\n if (!controller || !webview) {\n flag.clear();\n return;\n }\n controller->AddRef();\n webview->AddRef();\n m_controller = controller;\n m_webview = webview;\n flag.clear();\n });\n\n m_com_handler->set_attempt_handler([&] {\n return m_webview2_loader.create_environment_with_options(\n nullptr, userDataFolder, nullptr, m_com_handler);\n });\n m_com_handler->try_create_environment();\n\n // Pump the message loop until WebView2 has finished initialization.\n bool got_quit_msg = false;\n MSG msg;\n while (flag.test_and_set() && GetMessageW(&msg, nullptr, 0, 0) >= 0) {\n if (msg.message == WM_QUIT) {\n got_quit_msg = true;\n break;\n }\n TranslateMessage(&msg);\n DispatchMessageW(&msg);\n }\n if (got_quit_msg) {\n return error_info{WEBVIEW_ERROR_CANCELED};\n }\n if (!m_controller || !m_webview) {\n return error_info{WEBVIEW_ERROR_INVALID_STATE};\n }\n ICoreWebView2Settings *settings = nullptr;\n auto res = m_webview->get_Settings(&settings);\n if (res != S_OK) {\n return error_info{WEBVIEW_ERROR_UNSPECIFIED, \"get_Settings failed\"};\n }\n res = settings->put_AreDevToolsEnabled(debug ? TRUE : FALSE);\n if (res != S_OK) {\n return error_info{WEBVIEW_ERROR_UNSPECIFIED,\n \"put_AreDevToolsEnabled failed\"};\n }\n res = settings->put_IsStatusBarEnabled(FALSE);\n if (res != S_OK) {\n return error_info{WEBVIEW_ERROR_UNSPECIFIED,\n \"put_IsStatusBarEnabled failed\"};\n }\n add_init_script(\"function(message) {\\n\\\n return window.chrome.webview.postMessage(message);\\n\\\n}\");\n resize_webview();\n m_controller->put_IsVisible(TRUE);\n ShowWindow(m_widget, SW_SHOW);\n UpdateWindow(m_widget);\n if (owns_window()) {\n focus_webview();\n }\n return {};\n }\n\n void resize_widget() {\n if (m_widget) {\n RECT r{};\n if (GetClientRect(GetParent(m_widget), &r)) {\n MoveWindow(m_widget, r.left, r.top, r.right - r.left, r.bottom - r.top,\n TRUE);\n }\n }\n }\n\n void resize_webview() {\n if (m_widget && m_controller) {\n RECT bounds{};\n if (GetClientRect(m_widget, &bounds)) {\n m_controller->put_Bounds(bounds);\n }\n }\n }\n\n void focus_webview() {\n if (m_controller) {\n m_controller->MoveFocus(COREWEBVIEW2_MOVE_FOCUS_REASON_PROGRAMMATIC);\n }\n }\n\n bool is_webview2_available() const noexcept {\n LPWSTR version_info = nullptr;\n auto res = m_webview2_loader.get_available_browser_version_string(\n nullptr, &version_info);\n // The result will be equal to HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND)\n // if the WebView2 runtime is not installed.\n auto ok = SUCCEEDED(res) && version_info;\n if (version_info) {\n CoTaskMemFree(version_info);\n }\n return ok;\n }\n\n void on_dpi_changed(int dpi) {\n auto scaled_size = get_scaled_size(m_dpi, dpi);\n auto frame_size =\n make_window_frame_size(m_window, scaled_size.cx, scaled_size.cy, dpi);\n SetWindowPos(m_window, nullptr, 0, 0, frame_size.cx, frame_size.cy,\n SWP_NOZORDER | SWP_NOACTIVATE | SWP_NOMOVE | SWP_FRAMECHANGED);\n m_dpi = dpi;\n }\n\n SIZE get_size() const {\n RECT bounds;\n GetClientRect(m_window, &bounds);\n auto width = bounds.right - bounds.left;\n auto height = bounds.bottom - bounds.top;\n return {width, height};\n }\n\n SIZE get_scaled_size(int from_dpi, int to_dpi) const {\n auto size = get_size();\n return scale_size(size.cx, size.cy, from_dpi, to_dpi);\n }\n\n void on_system_setting_change(const wchar_t *area) {\n // Detect light/dark mode change in system.\n if (lstrcmpW(area, L\"ImmersiveColorSet\") == 0) {\n apply_window_theme(m_window);\n }\n }\n\n void run_event_loop_while(std::function fn) override {\n MSG msg;\n while (fn() && GetMessageW(&msg, nullptr, 0, 0) > 0) {\n TranslateMessage(&msg);\n DispatchMessageW(&msg);\n }\n }\n\n // The app is expected to call CoInitializeEx before\n // CreateCoreWebView2EnvironmentWithOptions.\n // Source: https://docs.microsoft.com/en-us/microsoft-edge/webview2/reference/win32/webview2-idl#createcorewebview2environmentwithoptions\n com_init_wrapper m_com_init;\n HWND m_window = nullptr;\n HWND m_widget = nullptr;\n HWND m_message_window = nullptr;\n POINT m_minsz = POINT{0, 0};\n POINT m_maxsz = POINT{0, 0};\n DWORD m_main_thread = GetCurrentThreadId();\n ICoreWebView2 *m_webview = nullptr;\n ICoreWebView2Controller *m_controller = nullptr;\n webview2_com_handler *m_com_handler = nullptr;\n mswebview2::loader m_webview2_loader;\n int m_dpi{};\n bool m_is_window_shown{};\n};\n\n} // namespace detail\n\nusing browser_engine = detail::win32_edge_engine;\n\n} // namespace webview\n\n#endif // defined(WEBVIEW_PLATFORM_WINDOWS) && defined(WEBVIEW_EDGE)\n#endif // defined(__cplusplus) && !defined(WEBVIEW_HEADER)\n#endif // WEBVIEW_BACKENDS_WIN32_EDGE_HH\n"
},
{
"path": "core/include/webview/detail/basic_result.hh",
"content": "/*\n * MIT License\n *\n * Copyright (c) 2017 Serge Zaitsev\n * Copyright (c) 2022 Steffen André Langnes\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\n#ifndef WEBVIEW_DETAIL_BASIC_RESULT_HH\n#define WEBVIEW_DETAIL_BASIC_RESULT_HH\n\n#if defined(__cplusplus) && !defined(WEBVIEW_HEADER)\n\n#include \"exceptions.hh\"\n#include \"optional.hh\"\n\n#include \n\nnamespace webview {\nnamespace detail {\n\ntemplate \nclass basic_result {\npublic:\n using value_type = Value;\n using error_type = Error;\n using exception_type = Exception;\n\n basic_result() : basic_result(value_type{}) {}\n\n basic_result(const value_type &value) : m_value{value} {}\n basic_result(value_type &&value) : m_value{std::forward(value)} {}\n\n basic_result(const error_type &error) : m_error{error} {}\n basic_result(error_type &&error) : m_error{std::forward(error)} {}\n\n bool ok() const { return has_value() && !has_error(); }\n bool has_value() const { return m_value.has_value(); }\n bool has_error() const { return m_error.has_value(); }\n\n void ensure_ok() {\n if (!ok()) {\n throw exception_type{error()};\n }\n }\n\n const value_type &value() const {\n if (!has_value()) {\n throw bad_access{};\n }\n return m_value.get();\n }\n\n const error_type &error() const {\n if (!has_error()) {\n throw bad_access{};\n }\n return m_error.get();\n }\n\nprivate:\n optional m_value;\n optional m_error;\n};\n\ntemplate \nclass basic_result {\npublic:\n using value_type = void;\n using error_type = Error;\n using exception_type = Exception;\n\n basic_result() = default;\n\n basic_result(error_type &&error) : m_error{std::forward(error)} {}\n\n bool ok() const { return !has_error(); }\n\n bool has_error() const { return m_error.has_value(); }\n\n void ensure_ok() {\n if (!ok()) {\n throw exception_type{error()};\n }\n }\n\n const error_type &error() const {\n if (!has_error()) {\n throw bad_access{};\n }\n return m_error.get();\n }\n\nprivate:\n optional m_error;\n};\n\n} // namespace detail\n} // namespace webview\n\n#endif // defined(__cplusplus) && !defined(WEBVIEW_HEADER)\n#endif // WEBVIEW_DETAIL_BASIC_RESULT_HH\n"
},
{
"path": "core/include/webview/detail/engine_base.hh",
"content": "/*\n * MIT License\n *\n * Copyright (c) 2017 Serge Zaitsev\n * Copyright (c) 2022 Steffen André Langnes\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\n#ifndef WEBVIEW_DETAIL_ENGINE_BASE_HH\n#define WEBVIEW_DETAIL_ENGINE_BASE_HH\n\n#if defined(__cplusplus) && !defined(WEBVIEW_HEADER)\n\n#include \"../errors.hh\"\n#include \"../types.h\"\n#include \"../types.hh\"\n#include \"json.hh\"\n#include \"user_script.hh\"\n\n#include \n#include \n#include \n#include
![\"Discord\"](\"https://assets-global.website-files.com/6257adef93867e50d84d30e2/636e0b5061df29d55a92d945_full_logo_blurple_RGB.svg\"){kind=logo}