automerge-rb 0.1.1

data/vendor/automerge-rust/automerge-c/build.rs

@@ -0,0 +1,21 @@
+extern crate cbindgen;
+
+use std::{env, path::PathBuf};
+
+fn main() {
+    let crate_dir = PathBuf::from(
+        env::var("CARGO_MANIFEST_DIR").expect("CARGO_MANIFEST_DIR env var is not defined"),
+    );
+
+    let config = cbindgen::Config::from_file("cbindgen.toml")
+        .expect("Unable to find cbindgen.toml configuration file");
+
+    if let Ok(writer) = cbindgen::generate_with_config(crate_dir, config) {
+        // \note CMake sets this environment variable before invoking Cargo so
+        //       that it can direct the generated header file into its
+        //       out-of-source build directory for post-processing.
+        if let Ok(target_dir) = env::var("CBINDGEN_TARGET_DIR") {
+            writer.write_to_file(PathBuf::from(target_dir).join("automerge.h"));
+        }
+    }
+}

data/vendor/automerge-rust/automerge-c/cbindgen.toml

@@ -0,0 +1,48 @@
+after_includes = """\n
+/**
+ * \\defgroup enumerations Public Enumerations
+ *  Symbolic names for integer constants.
+ */
+
+/**
+ * \\memberof AMdoc
+ * \\def AM_ROOT
+ * \\brief The root object of a document.
+ */
+#define AM_ROOT NULL
+
+/**
+ * \\memberof AMdoc
+ * \\def AM_CHANGE_HASH_SIZE
+ * \\brief The count of bytes in a change hash.
+ */
+#define AM_CHANGE_HASH_SIZE 32
+"""
+autogen_warning = """
+/**
+ * \\file
+ * \\brief All constants, functions and types in the core Automerge C API.
+ *
+ * \\warning This file is auto-generated by cbindgen.
+ */
+"""
+documentation = true
+documentation_style = "doxy"
+include_guard = "AUTOMERGE_C_H"
+includes = []
+language = "C"
+line_length = 140
+no_includes = true
+style = "both"
+sys_includes = ["stdbool.h", "stddef.h", "stdint.h", "time.h"]
+usize_is_size_t = true
+
+[enum]
+derive_const_casts = true
+enum_class = true
+must_use = "MUST_USE_ENUM"
+prefix_with_name = true
+rename_variants = "ScreamingSnakeCase"
+
+[export]
+item_types = ["constants", "enums", "functions", "opaque", "structs", "typedefs"]

data/vendor/automerge-rust/automerge-c/cmake/Cargo.toml.in

@@ -0,0 +1,22 @@
+[package]
+name = "${PROJECT_NAME}"
+version = "${PROJECT_VERSION}"
+authors = ["Orion Henry <orion.henry@gmail.com>", "Jason Kankiewicz <jason.kankiewicz@gmail.com>"]
+edition = "2021"
+license = "MIT"
+rust-version = "1.73.0"
+
+[lib]
+name = "${BINDINGS_NAME}"
+crate-type = ["staticlib"]
+bench = false
+doc = false
+
+[dependencies]
+${LIBRARY_NAME} = { path = "../${LIBRARY_NAME}" }
+hex = "^0.4.3"
+libc = "^0.2"
+smol_str = "0.3"
+
+[build-dependencies]
+cbindgen = "^0.29"

data/vendor/automerge-rust/automerge-c/cmake/automerge-c-config.cmake.in

@@ -0,0 +1,99 @@
+@PACKAGE_INIT@
+
+include(CMakeFindDependencyMacro)
+
+set(CMAKE_THREAD_PREFER_PTHREAD TRUE)
+
+set(THREADS_PREFER_PTHREAD_FLAG TRUE)
+
+find_dependency(Threads)
+
+find_library(@SYMBOL_PREFIX@_IMPLIB_DEBUG @LIBRARY_NAME@${CMAKE_DEBUG_POSTFIX} PATHS "${PACKAGE_PREFIX_DIR}/debug/${CMAKE_INSTALL_LIBDIR}" "${PACKAGE_PREFIX_DIR}/${CMAKE_INSTALL_LIBDIR}" NO_DEFAULT_PATH)
+
+find_library(@SYMBOL_PREFIX@_IMPLIB_RELEASE @LIBRARY_NAME@${CMAKE_RELEASE_POSTFIX} PATHS "${PACKAGE_PREFIX_DIR}/${CMAKE_INSTALL_LIBDIR}" NO_DEFAULT_PATH)
+
+find_file(@SYMBOL_PREFIX@_LOCATION_DEBUG "${CMAKE_SHARED_LIBRARY_PREFIX}@LIBRARY_NAME@${CMAKE_DEBUG_POSTFIX}${CMAKE_SHARED_LIBRARY_SUFFIX}" PATHS "${PACKAGE_PREFIX_DIR}/debug/${CMAKE_INSTALL_BINDIR}" "${PACKAGE_PREFIX_DIR}/${CMAKE_INSTALL_LIBDIR}" NO_DEFAULT_PATH)
+
+find_file(@SYMBOL_PREFIX@_LOCATION_RELEASE "${CMAKE_SHARED_LIBRARY_PREFIX}@LIBRARY_NAME@${CMAKE_RELEASE_POSTFIX}${CMAKE_SHARED_LIBRARY_SUFFIX}" PATHS "${PACKAGE_PREFIX_DIR}/${CMAKE_INSTALL_BINDIR}" NO_DEFAULT_PATH)
+
+if(@BUILD_SHARED_LIBS@)
+    set(@SYMBOL_PREFIX@_DEFINE_SYMBOL "@SYMBOL_PREFIX@_EXPORTS")
+
+    if(WIN32)
+        set(@SYMBOL_PREFIX@_NO_SONAME_DEBUG "TRUE")
+
+        set(@SYMBOL_PREFIX@_NO_SONAME_RELEASE "TRUE")
+
+        set(@SYMBOL_PREFIX@_SONAME_DEBUG "")
+
+        set(@SYMBOL_PREFIX@_SONAME_RELEASE "")
+    else()
+        set(@SYMBOL_PREFIX@_NO_SONAME_DEBUG "FALSE")
+
+        set(@SYMBOL_PREFIX@_NO_SONAME_RELEASE "FALSE")
+
+        get_filename_component(@SYMBOL_PREFIX@_SONAME_DEBUG "${@SYMBOL_PREFIX@_LOCATION_DEBUG}" NAME)
+
+        get_filename_component(@SYMBOL_PREFIX@_SONAME_RELEASE "${@SYMBOL_PREFIX@_LOCATION_RELEASE}" NAME)
+    endif()
+
+    set(@SYMBOL_PREFIX@_TYPE "SHARED")
+else()
+    set(@SYMBOL_PREFIX@_DEFINE_SYMBOL "")
+
+    set(@SYMBOL_PREFIX@_LOCATION_DEBUG "${@SYMBOL_PREFIX@_IMPLIB_DEBUG}")
+
+    set(@SYMBOL_PREFIX@_IMPLIB_DEBUG "")
+
+    set(@SYMBOL_PREFIX@_LOCATION_RELEASE "${@SYMBOL_PREFIX@_IMPLIB_RELEASE}")
+
+    set(@SYMBOL_PREFIX@_IMPLIB_RELEASE "")
+
+    set(@SYMBOL_PREFIX@_NO_SONAME_DEBUG "TRUE")
+
+    set(@SYMBOL_PREFIX@_NO_SONAME_RELEASE "TRUE")
+
+    set(@SYMBOL_PREFIX@_SONAME_DEBUG "")
+
+    set(@SYMBOL_PREFIX@_SONAME_RELEASE "")
+
+    set(@SYMBOL_PREFIX@_TYPE "STATIC")
+endif()
+
+add_library(@NAMESPACE@@PROJECT_NAME@ ${@SYMBOL_PREFIX@_TYPE} IMPORTED)
+
+set_target_properties(
+    @NAMESPACE@@PROJECT_NAME@
+    PROPERTIES
+        # \note Cargo writes a debug build into a nested directory instead of
+        #       decorating its name.
+        DEBUG_POSTFIX ""
+        DEFINE_SYMBOL "${@SYMBOL_PREFIX@_DEFINE_SYMBOL}"
+        IMPORTED_CONFIGURATIONS "RELEASE;DEBUG"
+        IMPORTED_IMPLIB_DEBUG "${@SYMBOL_PREFIX@_IMPLIB_DEBUG}"
+        IMPORTED_IMPLIB_RELEASE "${@SYMBOL_PREFIX@_IMPLIB_RELEASE}"
+        IMPORTED_LOCATION_DEBUG "${@SYMBOL_PREFIX@_LOCATION_DEBUG}"
+        IMPORTED_LOCATION_RELEASE "${@SYMBOL_PREFIX@_LOCATION_RELEASE}"
+        IMPORTED_NO_SONAME_DEBUG "${@SYMBOL_PREFIX@_NO_SONAME_DEBUG}"
+        IMPORTED_NO_SONAME_RELEASE "${@SYMBOL_PREFIX@_NO_SONAME_RELEASE}"
+        IMPORTED_SONAME_DEBUG "${@SYMBOL_PREFIX@_SONAME_DEBUG}"
+        IMPORTED_SONAME_RELEASE "${@SYMBOL_PREFIX@_SONAME_RELEASE}"
+        INTERFACE_INCLUDE_DIRECTORIES "${PACKAGE_PREFIX_DIR}/${CMAKE_INSTALL_INCLUDEDIR}"
+        LINKER_LANGUAGE C
+        PUBLIC_HEADER "${PACKAGE_PREFIX_DIR}/${CMAKE_INSTALL_INCLUDEDIR}/@PROJECT_NAME@/@LIBRARY_NAME@.h"
+        SOVERSION "@PROJECT_VERSION_MAJOR@"
+        VERSION "@PROJECT_VERSION@"
+        # \note Cargo exports all of the symbols automatically.
+        WINDOWS_EXPORT_ALL_SYMBOLS "TRUE"
+)
+
+# Remove the variables that the find_* command calls cached.
+unset(@SYMBOL_PREFIX@_IMPLIB_DEBUG CACHE)
+
+unset(@SYMBOL_PREFIX@_IMPLIB_RELEASE CACHE)
+
+unset(@SYMBOL_PREFIX@_LOCATION_DEBUG CACHE)
+
+unset(@SYMBOL_PREFIX@_LOCATION_RELEASE CACHE)
+
+check_required_components(@PROJECT_NAME@)

data/vendor/automerge-rust/automerge-c/cmake/cbindgen.toml.in

@@ -0,0 +1,48 @@
+after_includes = """\n
+/**
+ * \\defgroup enumerations Public Enumerations
+ *  Symbolic names for integer constants.
+ */
+
+/**
+ * \\memberof AMdoc
+ * \\def AM_ROOT
+ * \\brief The root object of a document.
+ */
+#define AM_ROOT NULL
+
+/**
+ * \\memberof AMdoc
+ * \\def AM_CHANGE_HASH_SIZE
+ * \\brief The count of bytes in a change hash.
+ */
+#define AM_CHANGE_HASH_SIZE 32
+"""
+autogen_warning = """
+/**
+ * \\file
+ * \\brief All constants, functions and types in the core Automerge C API.
+ *
+ * \\warning This file is auto-generated by cbindgen.
+ */
+"""
+documentation = true
+documentation_style = "doxy"
+include_guard = "@INCLUDE_GUARD_PREFIX@_H"
+includes = []
+language = "C"
+line_length = 140
+no_includes = true
+style = "both"
+sys_includes = ["stdbool.h", "stddef.h", "stdint.h", "time.h"]
+usize_is_size_t = true
+
+[enum]
+derive_const_casts = true
+enum_class = true
+must_use = "MUST_USE_ENUM"
+prefix_with_name = true
+rename_variants = "ScreamingSnakeCase"
+
+[export]
+item_types = ["constants", "enums", "functions", "opaque", "structs", "typedefs"]

data/vendor/automerge-rust/automerge-c/cmake/config.h.in

@@ -0,0 +1,58 @@
+#ifndef @INCLUDE_GUARD_PREFIX@_CONFIG_H
+#define @INCLUDE_GUARD_PREFIX@_CONFIG_H
+/**
+ * \file
+ * \brief Configuration pararameters defined by the build system.
+ *
+ * \warning This file is auto-generated by CMake.
+ */
+
+/**
+ * \def @SYMBOL_PREFIX@_VERSION
+ * \brief Denotes a semantic version of the form {MAJOR}{MINOR}{PATCH} as three,
+ *        two-digit decimal numbers without leading zeros (e.g. 100 is 0.1.0).
+ */
+#define @SYMBOL_PREFIX@_VERSION @INTEGER_PROJECT_VERSION@
+
+/**
+ * \def @SYMBOL_PREFIX@_MAJOR_VERSION
+ * \brief Denotes a semantic major version as a decimal number.
+ */
+#define @SYMBOL_PREFIX@_MAJOR_VERSION (@SYMBOL_PREFIX@_VERSION / 100000)
+
+/**
+ * \def @SYMBOL_PREFIX@_MINOR_VERSION
+ * \brief Denotes a semantic minor version as a decimal number.
+ */
+#define @SYMBOL_PREFIX@_MINOR_VERSION ((@SYMBOL_PREFIX@_VERSION / 100) % 1000)
+
+/**
+ * \def @SYMBOL_PREFIX@_PATCH_VERSION
+ * \brief Denotes a semantic patch version as a decimal number.
+ */
+#define @SYMBOL_PREFIX@_PATCH_VERSION (@SYMBOL_PREFIX@_VERSION % 100)
+
+#ifdef DOXYGEN
+/**
+ * \def @SYMBOL_PREFIX@_UTF8
+ * \brief Defined if the `pos` and `del` arguments of `AMspliceText()` and the
+ *        length returned by `AMobjSize()` for an `AM_OBJ_TYPE_TEXT` object are
+ *        in units of UTF-8 code points (i.e. bytes).
+ */
+ #define @SYMBOL_PREFIX@_UTF8
+
+ /**
+ * \def @SYMBOL_PREFIX@_UTF32
+ * \brief Defined if the `pos` and `del` arguments of `AMspliceText()` and the
+ *        length returned by `AMobjSize()` for an `AM_OBJ_TYPE_TEXT` object are
+ *        in units of UTF-32 code points.
+ */
+#define @SYMBOL_PREFIX@_UTF32
+
+#else
+
+#define @SYMBOL_PREFIX@_@TEXT_INDEXING_ENCODING@
+
+#endif
+
+#endif /* @INCLUDE_GUARD_PREFIX@_CONFIG_H */

data/vendor/automerge-rust/automerge-c/cmake/enum-string-functions-gen.cmake

@@ -0,0 +1,183 @@
+# This CMake script is used to generate a header and a source file for utility
+# functions that convert the tags of generated enum types into strings and
+# strings into the tags of generated enum types.
+cmake_minimum_required(VERSION 3.25 FATAL_ERROR)
+
+# Seeks the starting line of the source enum's declaration.
+macro(seek_enum_mode)
+    if (line MATCHES "^(typedef[ \t]+)?enum ")
+        string(REGEX REPLACE "^(typedef[ \t]+)?enum ([0-9a-zA-Z_]+).*$" "\\2" enum_name "${line}")
+        set(mode "read_tags")
+    endif()
+endmacro()
+
+# Scans the input for the current enum's tags.
+macro(read_tags_mode)
+    if(line MATCHES "^}[ \t]+${enum_name};")
+        set(mode "generate")
+    elseif(line MATCHES "^[A-Z0-9_]+.*$")
+        string(REGEX REPLACE "^([A-Za-z0-9_]+).*$" "\\1" tmp "${line}")
+        list(APPEND enum_tags "${tmp}")
+    endif()
+endmacro()
+
+macro(write_header_file)
+    # Generate a to-string function declaration.
+    list(APPEND header_body
+        "/**\n"
+        " * \\ingroup enumerations\n"
+        " * \\brief Gets the string representation of an `${enum_name}` enum tag.\n"
+        " *\n"
+        " * \\param[in] tag An `${enum_name}` enum tag.\n"
+        " * \\return A null-terminated byte string.\n"
+        " */\n"
+        "char const* ${enum_name}ToString(${enum_name} const tag)\;\n"
+        "\n")
+    # Generate a from-string function declaration.
+    list(APPEND header_body
+        "/**\n"
+        " * \\ingroup enumerations\n"
+        " * \\brief Gets an `${enum_name}` enum tag from its string representation.\n"
+        " *\n"
+        " * \\param[out] dest An `${enum_name}` enum tag pointer.\n"
+        " * \\param[in] src A null-terminated byte string.\n"
+        " * \\return `true` if \\p src matches the string representation of an\n"
+        " *         `${enum_name}` enum tag, `false` otherwise.\n"
+        " */\n"
+        "bool ${enum_name}FromString(${enum_name}* dest, char const* const src)\;\n"
+        "\n")
+endmacro()
+
+macro(write_source_file)
+    # Generate a to-string function implementation.
+    list(APPEND source_body
+        "char const* ${enum_name}ToString(${enum_name} const tag) {\n"
+        "    switch (tag) {\n"
+        "        default:\n"
+        "            return \"???\"\;\n")
+    foreach(label IN LISTS enum_tags)
+        list(APPEND source_body
+            "        case ${label}:\n"
+            "            return \"${label}\"\;\n")
+    endforeach()
+    list(APPEND source_body
+        "    }\n"
+        "}\n"
+        "\n")
+    # Generate a from-string function implementation.
+    list(APPEND source_body
+        "bool ${enum_name}FromString(${enum_name}* dest, char const* const src) {\n")
+    foreach(label IN LISTS enum_tags)
+        list(APPEND source_body
+            "    if (!strcmp(src, \"${label}\")) {\n"
+            "        *dest = ${label}\;\n"
+            "        return true\;\n"
+            "    }\n")
+    endforeach()
+    list(APPEND source_body
+        "    return false\;\n"
+        "}\n"
+        "\n")
+endmacro()
+
+function(main)
+    set(header_body "")
+    # File header and includes.
+    list(APPEND header_body
+        "#ifndef ${include_guard}\n"
+        "#define ${include_guard}\n"
+        "/**\n"
+        " * \\file\n"
+        " * \\brief Utility functions for converting enum tags into null-terminated\n"
+        " *        byte strings and vice versa.\n"
+        " *\n"
+        " * \\warning This file is auto-generated by CMake.\n"
+        " */\n"
+        "\n"
+        "#include <stdbool.h>\n"
+        "\n"
+        "#include <${library_include}>\n"
+        "\n")
+    set(source_body "")
+    # File includes.
+    list(APPEND source_body
+        "/** \\warning This file is auto-generated by CMake. */\n"
+        "\n"
+        "#include \"stdio.h\"\n"
+        "#include \"string.h\"\n"
+        "\n"
+        "#include <${header_include}>\n"
+        "\n")
+    set(enum_name "")
+    set(enum_tags "")
+    set(mode "seek_enum")
+    file(STRINGS "${input_path}" lines)
+    foreach(line IN LISTS lines)
+        string(REGEX REPLACE "^(.+)(//.*)?" "\\1" line "${line}")
+        string(STRIP "${line}" line)
+        if(mode STREQUAL "seek_enum")
+            seek_enum_mode()
+        elseif(mode STREQUAL "read_tags")
+            read_tags_mode()
+        else()
+            # The end of the enum declaration was reached.
+            if(NOT enum_name)
+                # The end of the file was reached.
+                return()
+            endif()
+            if(NOT enum_tags)
+                message(FATAL_ERROR "No tags found for `${enum_name}`.")
+            endif()
+            string(TOLOWER "${enum_name}" output_stem_prefix)
+            string(CONCAT output_stem "${output_stem_prefix}" "_string")
+            cmake_path(REPLACE_EXTENSION output_stem "h" OUTPUT_VARIABLE output_header_basename)
+            write_header_file()
+            write_source_file()
+            set(enum_name "")
+            set(enum_tags "")
+            set(mode "seek_enum")
+        endif()
+    endforeach()
+    # File footer.
+    list(APPEND header_body
+        "#endif /* ${include_guard} */\n")
+    message(STATUS "Generating header file \"${output_header_path}\"...")
+    file(WRITE "${output_header_path}" ${header_body})
+    message(STATUS "Generating source file \"${output_source_path}\"...")
+    file(WRITE "${output_source_path}" ${source_body})
+endfunction()
+
+if(NOT DEFINED PROJECT_NAME)
+    message(FATAL_ERROR "Variable PROJECT_NAME is not defined.")
+elseif(NOT DEFINED LIBRARY_NAME)
+    message(FATAL_ERROR "Variable LIBRARY_NAME is not defined.")
+elseif(NOT DEFINED SUBDIR)
+    message(FATAL_ERROR "Variable SUBDIR is not defined.")
+elseif(${CMAKE_ARGC} LESS 9)
+    message(FATAL_ERROR "Too few arguments.")
+elseif(${CMAKE_ARGC} GREATER 10)
+    message(FATAL_ERROR "Too many arguments.")
+elseif(NOT EXISTS ${CMAKE_ARGV5})
+    message(FATAL_ERROR "Input header \"${CMAKE_ARGV7}\" not found.")
+endif()
+cmake_path(CONVERT "${CMAKE_ARGV7}" TO_CMAKE_PATH_LIST input_path NORMALIZE)
+cmake_path(CONVERT "${CMAKE_ARGV8}" TO_CMAKE_PATH_LIST output_header_path NORMALIZE)
+cmake_path(CONVERT "${CMAKE_ARGV9}" TO_CMAKE_PATH_LIST output_source_path NORMALIZE)
+string(TOLOWER "${PROJECT_NAME}" project_root)
+cmake_path(CONVERT "${SUBDIR}" TO_CMAKE_PATH_LIST project_subdir NORMALIZE)
+string(TOLOWER "${project_subdir}" project_subdir)
+string(TOLOWER "${LIBRARY_NAME}" library_stem)
+cmake_path(REPLACE_EXTENSION library_stem "h" OUTPUT_VARIABLE library_basename)
+string(JOIN "/" library_include "${project_root}" "${library_basename}")
+string(TOUPPER "${PROJECT_NAME}" project_name_upper)
+string(TOUPPER "${project_subdir}" include_guard_infix)
+string(REGEX REPLACE "/" "_" include_guard_infix "${include_guard_infix}")
+string(REGEX REPLACE "-" "_" include_guard_prefix "${project_name_upper}")
+string(JOIN "_" include_guard_prefix  "${include_guard_prefix}" "${include_guard_infix}")
+string(JOIN "/" output_header_prefix "${project_root}" "${project_subdir}")
+cmake_path(GET output_header_path STEM output_header_stem)
+string(TOUPPER "${output_header_stem}" include_guard_stem)
+string(JOIN "_" include_guard "${include_guard_prefix}" "${include_guard_stem}" "H")
+cmake_path(GET output_header_path FILENAME output_header_basename)
+string(JOIN "/" header_include "${output_header_prefix}" "${output_header_basename}")
+main()

data/vendor/automerge-rust/automerge-c/cmake/file-regex-replace.cmake

@@ -0,0 +1,33 @@
+# This CMake script is used to perform string substitutions within a generated
+# file.
+cmake_minimum_required(VERSION 3.25 FATAL_ERROR)
+
+if(NOT DEFINED MATCH_REGEX)
+    message(FATAL_ERROR "Variable \"MATCH_REGEX\" is not defined.")
+elseif(NOT DEFINED REPLACE_EXPR)
+    message(FATAL_ERROR "Variable \"REPLACE_EXPR\" is not defined.")
+elseif(${CMAKE_ARGC} LESS 7)
+    message(FATAL_ERROR "Too few arguments.")
+elseif(${CMAKE_ARGC} GREATER 8)
+    message(FATAL_ERROR "Too many arguments.")
+elseif(NOT EXISTS ${CMAKE_ARGV6})
+    message(FATAL_ERROR "Input file \"${CMAKE_ARGV6}\" not found.")
+endif()
+
+message(STATUS "Replacing \"${MATCH_REGEX}\" with \"${REPLACE_EXPR}\" in \"${CMAKE_ARGV6}\"...")
+
+file(READ ${CMAKE_ARGV6} INPUT_STRING)
+
+string(REGEX REPLACE "${MATCH_REGEX}" "${REPLACE_EXPR}" OUTPUT_STRING "${INPUT_STRING}")
+
+if(DEFINED CMAKE_ARGV7)
+    set(OUTPUT_FILE "${CMAKE_ARGV7}")
+else()
+    set(OUTPUT_FILE "${CMAKE_ARGV6}")
+endif()
+
+if(NOT "${OUTPUT_STRING}" STREQUAL "${INPUT_STRING}")
+    file(WRITE ${OUTPUT_FILE} "${OUTPUT_STRING}")
+
+    message(STATUS "Created/updated \"${OUTPUT_FILE}\".")
+endif()

data/vendor/automerge-rust/automerge-c/cmake/file-touch.cmake

@@ -0,0 +1,35 @@
+# This CMake script is used to force Cargo to regenerate the header file for the
+# core bindings after the out-of-source build directory has been cleaned.
+cmake_minimum_required(VERSION 3.25 FATAL_ERROR)
+
+if(NOT DEFINED CONDITION)
+    message(FATAL_ERROR "Variable \"CONDITION\" is not defined.")
+elseif(${CMAKE_ARGC} LESS 7)
+    message(FATAL_ERROR "Too few arguments.")
+elseif(${CMAKE_ARGC} GREATER 7)
+    message(FATAL_ERROR "Too many arguments.")
+elseif(NOT EXISTS ${CMAKE_ARGV6})
+    message(FATAL_ERROR "File \"${CMAKE_ARGV6}\" not found.")
+elseif(IS_DIRECTORY "${CMAKE_ARG6}")
+    message(FATAL_ERROR "Directory \"${CMAKE_ARG6}\" can't be touched.")
+endif()
+
+message(STATUS "Touching \"${CMAKE_ARGV6}\" if ${CONDITION} \"${CMAKE_ARGV5}\"...")
+
+if(CONDITION STREQUAL "EXISTS")
+    if(EXISTS "${CMAKE_ARGV5}")
+        set(DO_IT TRUE)
+    endif()
+elseif((CONDITION STREQUAL "NOT_EXISTS") OR (CONDITION STREQUAL "!EXISTS"))
+    if(NOT EXISTS "${CMAKE_ARGV5}")
+        set(DO_IT TRUE)
+    endif()
+else()
+    message(FATAL_ERROR "Unexpected condition \"${CONDITION}\".")
+endif()
+
+if(DO_IT)
+    file(TOUCH_NOCREATE "${CMAKE_ARGV6}")
+
+    message(STATUS "Touched \"${CMAKE_ARGV6}\".")
+endif()

data/vendor/automerge-rust/automerge-c/docs/CMakeLists.txt

@@ -0,0 +1,39 @@
+cmake_minimum_required(VERSION 3.25 FATAL_ERROR)
+
+find_package(Doxygen OPTIONAL_COMPONENTS dot)
+
+if(DOXYGEN_FOUND)
+    set(DOXYGEN_ALIASES "installed_headerfile=\\headerfile ${LIBRARY_NAME}.h <${PROJECT_NAME}/${LIBRARY_NAME}.h>")
+
+    set(DOXYGEN_GENERATE_LATEX YES)
+
+    set(DOXYGEN_PDF_HYPERLINKS YES)
+
+    set(DOXYGEN_PREDEFINED "DOXYGEN")
+
+    set(DOXYGEN_PROJECT_LOGO "${CMAKE_CURRENT_SOURCE_DIR}/img/brandmark.png")
+
+    set(DOXYGEN_SORT_BRIEF_DOCS YES)
+
+    set(DOXYGEN_USE_MDFILE_AS_MAINPAGE "${PROJECT_SOURCE_DIR}/README.md")
+
+    doxygen_add_docs(
+        ${LIBRARY_NAME}_docs
+        "${CBINDGEN_TARGET_DIR}/${LIBRARY_NAME}.h"
+        "${CBINDGEN_TARGET_DIR}/config.h"
+        "${CBINDGEN_TARGET_DIR}/${UTILS_SUBDIR}/enum_string.h"
+        "${PROJECT_SOURCE_DIR}/${CMAKE_INSTALL_INCLUDEDIR}/${PROJECT_NAME}/${UTILS_SUBDIR}/result.h"
+        "${PROJECT_SOURCE_DIR}/${CMAKE_INSTALL_INCLUDEDIR}/${PROJECT_NAME}/${UTILS_SUBDIR}/stack_callback_data.h"
+        "${PROJECT_SOURCE_DIR}/${CMAKE_INSTALL_INCLUDEDIR}/${PROJECT_NAME}/${UTILS_SUBDIR}/stack.h"
+        "${PROJECT_SOURCE_DIR}/${CMAKE_INSTALL_INCLUDEDIR}/${PROJECT_NAME}/${UTILS_SUBDIR}/string.h"
+        "${PROJECT_SOURCE_DIR}/README.md"
+        WORKING_DIRECTORY ${PROJECT_SOURCE_DIR}
+        COMMENT "Producing documentation with Doxygen..."
+    )
+
+    # \note A Doxygen input file isn't a file-level dependency so the Doxygen
+    #       command must instead depend upon a target that either outputs the
+    #       file or depends upon it also or it will just output an error message
+    #       when it can't be found.
+    add_dependencies(${LIBRARY_NAME}_docs ${BINDINGS_NAME}_artifacts ${LIBRARY_NAME}_utilities)
+endif()

data/vendor/automerge-rust/automerge-c/examples/CMakeLists.txt

@@ -0,0 +1,42 @@
+cmake_minimum_required(VERSION 3.25 FATAL_ERROR)
+
+add_executable(
+    ${LIBRARY_NAME}_quickstart
+        quickstart.c
+)
+
+set_target_properties(${LIBRARY_NAME}_quickstart PROPERTIES LINKER_LANGUAGE C)
+
+# \note An imported library's INTERFACE_INCLUDE_DIRECTORIES property can't
+#       contain a non-existent path so its build-time include directory
+#       must be specified for all of its dependent targets instead.
+target_include_directories(
+    ${LIBRARY_NAME}_quickstart
+    PRIVATE "$<BUILD_INTERFACE:${CBINDGEN_INCLUDEDIR}>"
+)
+
+target_link_libraries(${LIBRARY_NAME}_quickstart PRIVATE ${LIBRARY_NAME})
+
+add_dependencies(${LIBRARY_NAME}_quickstart ${BINDINGS_NAME}_artifacts)
+
+if(BUILD_SHARED_LIBS AND WIN32)
+    add_custom_command(
+        TARGET ${LIBRARY_NAME}_quickstart
+        POST_BUILD
+        COMMAND ${CMAKE_COMMAND} -E copy_if_different
+                ${CARGO_CURRENT_BINARY_DIR}/${CMAKE_SHARED_LIBRARY_PREFIX}${LIBRARY_NAME}${CMAKE_${CMAKE_BUILD_TYPE}_POSTFIX}${CMAKE_SHARED_LIBRARY_SUFFIX}
+                ${CMAKE_CURRENT_BINARY_DIR}
+        COMMENT "Copying the DLL built by Cargo into the examples directory..."
+        VERBATIM
+    )
+endif()
+
+add_custom_command(
+    TARGET ${LIBRARY_NAME}_quickstart
+    POST_BUILD
+    COMMAND
+        ${LIBRARY_NAME}_quickstart
+    COMMENT
+        "Running the example quickstart..."
+    VERBATIM
+)

data/vendor/automerge-rust/automerge-c/examples/README.md

@@ -0,0 +1,9 @@
+# Automerge C examples
+
+## Quickstart
+
+```shell
+cmake -E make_directory automerge-c/build
+cmake -S automerge-c -B automerge-c/build
+cmake --build automerge-c/build --target automerge_quickstart
+```