# typed: strict
# frozen_string_literal: true

module OS
  module Mac
    module Stdenv
      extend T::Helpers

      requires_ancestor { SharedEnvExtension }
      requires_ancestor { ::Stdenv }

      sig { returns(T::Array[::Pathname]) }
      def homebrew_extra_pkg_config_paths
        %W[
          #{HOMEBREW_LIBRARY}/Homebrew/os/mac/pkgconfig/#{MacOS.version}
        ].map { |p| ::Pathname.new(p) }
      end
      private :homebrew_extra_pkg_config_paths

      sig {
        params(
          formula:         T.nilable(Formula),
          cc:              T.nilable(String),
          build_bottle:    T.nilable(T::Boolean),
          bottle_arch:     T.nilable(String),
          testing_formula: T::Boolean,
          debug_symbols:   T.nilable(T::Boolean),
        ).void
      }
      def setup_build_environment(formula: nil, cc: nil, build_bottle: false, bottle_arch: nil,
                                  testing_formula: false, debug_symbols: false)
        super

        append "LDFLAGS", "-Wl,-headerpad_max_install_names"

        # `sed` is strict and errors out when it encounters files with mixed character sets.
        delete("LC_ALL")
        self["LC_CTYPE"] = "C"

        # Add `lib` and `include` etc. from the current `macosxsdk` to compiler flags:
        macosxsdk(formula:, testing_formula:)

        return unless MacOS::Xcode.without_clt?

        append_path "PATH", "#{MacOS::Xcode.prefix}/usr/bin"
        append_path "PATH", "#{MacOS::Xcode.toolchain_path}/usr/bin"
      end

      sig { params(version: T.nilable(MacOSVersion)).void }
      def remove_macosxsdk(version = nil)
        # Clear all `lib` and `include` dirs from `CFLAGS`, `CPPFLAGS`, `LDFLAGS` that were
        # previously added by `macosxsdk`.
        remove_from_cflags(/ ?-mmacosx-version-min=\d+\.\d+/)
        delete("CPATH")
        remove "LDFLAGS", "-L#{HOMEBREW_PREFIX}/lib"

        sdk = self["SDKROOT"] || MacOS.sdk_path(version)
        return unless sdk

        delete("SDKROOT")
        remove_from_cflags "-isysroot#{sdk}"
        remove "CPPFLAGS", "-isysroot#{sdk}"
        remove "LDFLAGS", "-isysroot#{sdk}"
        if HOMEBREW_PREFIX.to_s == "/usr/local"
          delete("CMAKE_PREFIX_PATH")
        else
          # It was set in `setup_build_environment`, so we have to restore it here.
          self["CMAKE_PREFIX_PATH"] = HOMEBREW_PREFIX.to_s
        end
        remove "CMAKE_FRAMEWORK_PATH", "#{sdk}/System/Library/Frameworks"
      end

      sig { params(version: T.nilable(MacOSVersion), formula: T.nilable(Formula), testing_formula: T::Boolean).void }
      def macosxsdk(version = nil, formula: nil, testing_formula: false)
        # Sets all needed `lib` and `include` dirs to `CFLAGS`, `CPPFLAGS`, `LDFLAGS`.
        remove_macosxsdk
        min_version = version || MacOS.version
        append_to_cflags("-mmacosx-version-min=#{min_version}")
        self["CPATH"] = "#{HOMEBREW_PREFIX}/include"
        prepend "LDFLAGS", "-L#{HOMEBREW_PREFIX}/lib"

        sdk = if formula
          MacOS.sdk_for_formula(formula, version, check_only_runtime_requirements: testing_formula)
        else
          MacOS.sdk(version)
        end

        Homebrew::Diagnostic.checks(:fatal_setup_build_environment_checks)
        sdk = T.must(sdk).path

        # Extra setup to support Xcode 4.3+ without CLT.
        self["SDKROOT"] = sdk.to_s
        # Tell clang/gcc where system include's are:
        append_path "CPATH", "#{sdk}/usr/include"
        # The -isysroot is needed, too, because of the Frameworks
        append_to_cflags "-isysroot#{sdk}"
        append "CPPFLAGS", "-isysroot#{sdk}"
        # And the linker needs to find sdk/usr/lib
        append "LDFLAGS", "-isysroot#{sdk}"
        # Needed to build cmake itself and perhaps some cmake projects:
        append_path "CMAKE_PREFIX_PATH", "#{sdk}/usr"
        append_path "CMAKE_FRAMEWORK_PATH", "#{sdk}/System/Library/Frameworks"
      end

      # Some configure scripts won't find libxml2 without help.
      # This is a no-op with macOS SDK 10.15.4 and later.
      sig { void }
      def libxml2
        sdk = self["SDKROOT"] || MacOS.sdk_path
        # Use the includes from the sdk
        append "CPPFLAGS", "-I#{sdk}/usr/include/libxml2" unless Pathname("#{sdk}/usr/include/libxml").directory?
      end

      sig { void }
      def no_weak_imports
        # This has little-to-no usage and doesn't make sense to have a special function for.
        odeprecated "ENV.no_weak_imports"
        append "LDFLAGS", "-Wl,-no_weak_imports" if no_weak_imports_support?
      end

      sig { void }
      def no_fixup_chains
        # This has little-to-no usage and behaved inconsistently with the superenv equivalent.
        odeprecated "ENV.no_fixup_chains"
        append "LDFLAGS", "-Wl,-no_fixup_chains" if no_fixup_chains_support?
      end
    end
  end
end

Stdenv.prepend(OS::Mac::Stdenv)
