# Copyright 1999-2026 Gentoo Authors
# Distributed under the terms of the GNU General Public License v2

EAPI=8

# BENTOO-DIVERGENCE: IUSE - llvm_slot_23. The slot is opt-in downstream:
# above _LLVM_NEWEST_STABLE the eclass will not make it a default, so
# exposing it costs nothing and gives the newer slot a way in.
LLVM_COMPAT=( {18..23} )
LLVM_OPTIONAL=1
CARGO_OPTIONAL=1
PYTHON_COMPAT=( python3_{12..14} )

# BENTOO-DIVERGENCE: INHERIT - no toolchain-funcs, which ::gentoo inherits for
# tc-check-openmp. Nothing here calls a tc-* function at all: get_libdir comes
# from multilib and get_llvm_prefix from llvm-r2. Inheriting an eclass nothing
# uses is noise, and _eclasses_ confirms it is genuinely absent rather than
# arriving by another route.
inherit flag-o-matic llvm-r2 meson-multilib python-any-r1 linux-info

# Note: ${P}, not ${PF} -- this names the distfile, which does not change
# across revisions.  With ${PF} the first revbump would look for
# mesa-26.3.0-pre20260825-r1.tar.gz and miss the Manifest entry.
MY_P="${P/_/-}"

CRATES="
	paste@1.0.14
	proc-macro2@1.0.86
	quote@1.0.35
	rustc-hash@2.1.1
	syn@2.0.87
	unicode-ident@1.0.12
"

RUST_MIN_VER="1.85.0"
RUST_MULTILIB=1
RUST_OPTIONAL=1

inherit cargo

DESCRIPTION="OpenGL-like graphic library for Linux"
HOMEPAGE="https://mesa3d.org/"

if [[ ${PV} == 9999 ]]; then
	EGIT_REPO_URI="https://gitlab.freedesktop.org/mesa/mesa.git"
	inherit git-r3
else
	GIT_COMMIT="b316485dd75ca6ab6c16c113480fb94c57d86c95"
	SRC_URI="https://gitlab.freedesktop.org/${PN}/${PN}/-/archive/${GIT_COMMIT}/mesa-${GIT_COMMIT}.tar.gz -> ${MY_P}.tar.gz"
	KEYWORDS="~alpha ~amd64 ~arm ~arm64 ~hppa ~loong ~mips ~ppc ~ppc64 ~riscv ~s390 ~sparc ~x86 ~x64-solaris"
fi

# This should be {CARGO_CRATE_URIS//.crate/.tar.gz} to correspond to the wrap files,
# but there are "stale" distfiles on the mirrors with the wrong names.
# export MESON_PACKAGE_CACHE_DIR="${DISTDIR}"
SRC_URI+="
	${CARGO_CRATE_URIS}
"

# Since 26.3 the Venus protocol headers live out of tree and are pulled in as a
# [wrap-git] meson subproject (subprojects/venus-protocol.wrap), which the
# sandbox cannot clone (--wrap-mode nodownload).  It cannot become a system
# dependency either: upstream installs nothing and ships no pkg-config file,
# it only *generates* headers at build time, so the subproject fallback is the
# only consumable form.  Keep VENUS_PROTOCOL_REV in sync with the "revision"
# field of that wrap file on every bump; src_unpack hard-fails when it drifts,
# because meson only checks the *declared* version of whatever is on disk
# (== 1.1.3 here) and a stale pin silently builds against wrong headers.
#
# The wrap pins by tag since 26.3.0_pre20260901 (it used to name a bare sha),
# so the two are separate variables: REV is whatever the wrap literally says
# and is what the drift check compares against, COMMIT is the sha that tag
# resolved to.  SRC_URI must fetch the sha -- a tag can be moved upstream, and
# a moved tag would change the distfile under a Manifest that still verifies.
VENUS_PROTOCOL_REV="v1.1.3"
VENUS_PROTOCOL_COMMIT="ca19b6358d7cc491bc3e4de76f04c6700876a8fa"
VENUS_PROTOCOL_P="venus-protocol-${VENUS_PROTOCOL_COMMIT}"
# Only the virtio Vulkan driver needs it (with_virtio_vk in meson.build).
SRC_URI+="
	vulkan? ( video_cards_virgl? (
		https://gitlab.freedesktop.org/virgl/venus-protocol/-/archive/${VENUS_PROTOCOL_COMMIT}/${VENUS_PROTOCOL_P}.tar.gz
	) )
"

S="${WORKDIR}/${PN}-${GIT_COMMIT}"
EGIT_CHECKOUT_DIR=${S}

LICENSE="MIT SGI-B-2.0"
SLOT="0"

VIDEO_CARDS="
	asahi d3d12 freedreno i915 imagination intel lavapipe lima nouveau nvk
	panfrost r300 r600 radeon radeonsi v3d vc4 virgl vivante vmware zink"
for card in ${VIDEO_CARDS}; do
	IUSE_VIDEO_CARDS+=" video_cards_${card}"
done

IUSE="${IUSE_VIDEO_CARDS}
	cpu_flags_x86_sse2 debug +llvm
	lm-sensors opencl +opengl +proprietary-codecs
	sysprof test unwind vaapi valgrind vulkan
	wayland +X +zstd"
RESTRICT="!test? ( test )"
# BENTOO-DIVERGENCE: REQUIRED_USE - llvm_slot_23 in the ^^ group, the same slot
# the IUSE tag above adds. One LLVM_COMPAT edit, two divergent axes.
REQUIRED_USE="
	llvm? ( ${LLVM_REQUIRED_USE} )
	video_cards_i915? ( llvm )
	video_cards_lavapipe? ( llvm vulkan )
	video_cards_radeon? ( x86? ( llvm ) amd64? ( llvm ) )
	video_cards_r300?   ( x86? ( llvm ) amd64? ( llvm ) )
	video_cards_zink? ( vulkan opengl )
	video_cards_nvk? ( vulkan video_cards_nouveau )
"

LIBDRM_DEPSTRING=">=x11-libs/libdrm-2.4.133"
RDEPEND="
	${LIBDRM_DEPSTRING}[${MULTILIB_USEDEP}]
	>=dev-libs/expat-2.1.0-r3[${MULTILIB_USEDEP}]
	>=dev-util/spirv-tools-1.3.231.0[${MULTILIB_USEDEP}]
	>=media-libs/libglvnd-1.3.2[X?,${MULTILIB_USEDEP}]
	>=virtual/zlib-1.2.9:=[${MULTILIB_USEDEP}]
	unwind? ( sys-libs/libunwind[${MULTILIB_USEDEP}] )
	llvm? (
		$(llvm_gen_dep "
			llvm-core/llvm:\${LLVM_SLOT}[llvm_targets_AMDGPU(+),${MULTILIB_USEDEP}]
			opencl? (
				dev-util/spirv-llvm-translator:\${LLVM_SLOT}
				llvm-core/clang:\${LLVM_SLOT}[llvm_targets_AMDGPU(+),${MULTILIB_USEDEP}]
				=llvm-runtimes/libclc-\${LLVM_SLOT}*[spirv(-)]
			)
		")
		video_cards_r600? (
			virtual/libelf:0=[${MULTILIB_USEDEP}]
		)
		video_cards_radeon? (
			virtual/libelf:0=[${MULTILIB_USEDEP}]
		)
	)
	lm-sensors? ( sys-apps/lm-sensors:=[${MULTILIB_USEDEP}] )
	opencl? (
		>=virtual/opencl-3
		llvm-runtimes/libclc[spirv(-)]
		virtual/libelf:0=
	)
	vaapi? (
		>=media-libs/libva-1.7.3:=[${MULTILIB_USEDEP}]
	)
	video_cards_i915? (
		${LIBDRM_DEPSTRING}[video_cards_intel]
	)
	video_cards_radeonsi? (
		${LIBDRM_DEPSTRING}[video_cards_amdgpu]
		virtual/libelf:0=[${MULTILIB_USEDEP}]
	)
	video_cards_zink? ( media-libs/vulkan-loader:=[${MULTILIB_USEDEP}] )
	vulkan? (
		media-libs/libdisplay-info:=[${MULTILIB_USEDEP}]
		virtual/libudev:=
	)
	wayland? ( >=dev-libs/wayland-1.18.0[${MULTILIB_USEDEP}] )
	X? (
		>=x11-libs/libX11-1.8[${MULTILIB_USEDEP}]
		>=x11-libs/libxshmfence-1.1[${MULTILIB_USEDEP}]
		>=x11-libs/libXext-1.3.2[${MULTILIB_USEDEP}]
		>=x11-libs/libXxf86vm-1.1.3[${MULTILIB_USEDEP}]
		>=x11-libs/libxcb-1.17:=[${MULTILIB_USEDEP}]
		x11-libs/libXfixes[${MULTILIB_USEDEP}]
		x11-libs/xcb-util-keysyms[${MULTILIB_USEDEP}]
	)
	zstd? ( app-arch/zstd:=[${MULTILIB_USEDEP}] )
"

DEPEND="${RDEPEND}
	sysprof? ( >=dev-util/sysprof-capture-49.0[${MULTILIB_USEDEP}] )
	video_cards_d3d12? ( >=dev-util/directx-headers-1.619.1[${MULTILIB_USEDEP}] )
	valgrind? ( dev-debug/valgrind )
	wayland? ( >=dev-libs/wayland-protocols-1.41 )
	X? (
		x11-libs/libXrandr[${MULTILIB_USEDEP}]
		x11-base/xorg-proto
	)
"

CLC_DEPSTRING="
	~dev-util/mesa_clc-${PV}[video_cards_asahi?,video_cards_panfrost?]
	llvm-runtimes/libclc[spirv(-)]
"
# BENTOO-DIVERGENCE: BDEPEND - app-alternatives/lex where ::gentoo names
# sys-devel/flex directly. The virtual is the current spelling and lets a
# system provide another lex; ::gentoo has it too, it just has not migrated.
BDEPEND="
	${PYTHON_DEPS}
	opencl? (
		>=dev-util/bindgen-0.71.1
		${RUST_DEPEND}
	)
	>=dev-build/meson-1.7.0
	app-alternatives/yacc
	app-alternatives/lex
	virtual/pkgconfig
	$(python_gen_any_dep "
		>=dev-python/mako-0.8.0[\${PYTHON_USEDEP}]
		dev-python/packaging[\${PYTHON_USEDEP}]
		dev-python/pyyaml[\${PYTHON_USEDEP}]
	")
	video_cards_asahi? ( ${CLC_DEPSTRING} )
	video_cards_intel? ( ${CLC_DEPSTRING} )
	video_cards_panfrost? ( ${CLC_DEPSTRING} )
	vulkan? (
		dev-util/glslang
		video_cards_nvk? (
			>=dev-util/bindgen-0.71.1
			>=dev-util/cbindgen-0.26.0
			${RUST_DEPEND}
			${CLC_DEPSTRING}
		)
	)
	wayland? ( dev-util/wayland-scanner )
"

QA_WX_LOAD="
x86? (
	usr/lib/libgallium-*.so
	usr/lib/libGLX_mesa.so.0.0.0
)"

src_unpack() {
	if [[ ${PV} == 9999 ]]; then
		git-r3_src_unpack
	else
		unpack ${MY_P}.tar.gz
	fi

	if use vulkan && use video_cards_virgl; then
		unpack "${VENUS_PROTOCOL_P}.tar.gz"
		# meson resolves the wrap from disk instead of cloning only when the
		# tree sits at the exact "directory" field, so read it from the wrap
		# rather than hardcoding it: upstream renamed it venus-protocol-1.0 ->
		# -1.1 mid-series and a hardcoded path fails as a generic "Subproject
		# is buildable: NO".  "revision" is checked for the same reason.
		local vn_wrap="${S}/subprojects/venus-protocol.wrap"
		local vn_dir vn_rev
		vn_dir=$(sed -n 's/^[[:space:]]*directory[[:space:]]*=[[:space:]]*//p' \
			"${vn_wrap}") || die
		vn_rev=$(sed -n 's/^[[:space:]]*revision[[:space:]]*=[[:space:]]*//p' \
			"${vn_wrap}") || die
		[[ -n ${vn_dir} ]] || die "no 'directory' field in ${vn_wrap}"
		[[ ${vn_rev} == "${VENUS_PROTOCOL_REV}" ]] ||
			die "VENUS_PROTOCOL_REV is stale: the wrap wants ${vn_rev}"

		# Agreeing with "revision" is not proof the pinned sha carries the
		# right headers now that the wrap names a tag: a tag can be moved, and
		# VENUS_PROTOCOL_COMMIT is resolved by hand at bump time.  Compare what
		# the subproject declares against what mesa demands, which is the check
		# that actually matters.  meson would catch it too, but only as the
		# generic "Subproject venus-protocol is buildable: NO".
		local vn_want vn_have
		vn_want=$(sed -n "/dependency('venus-protocol'/,/^[[:space:]]*)/{
			s/^[[:space:]]*version[[:space:]]*:[[:space:]]*'==[[:space:]]*\([0-9.]\+\)'.*/\1/p
		}" "${S}/meson.build") || die
		vn_have=$(sed -n "/^project(/,/^)/{
			s/^[[:space:]]*version:[[:space:]]*'\([0-9.]\+\)'.*/\1/p
		}" "${WORKDIR}/${VENUS_PROTOCOL_P}/meson.build") || die
		[[ -n ${vn_want} ]] || die "no venus-protocol version constraint in ${S}/meson.build"
		[[ -n ${vn_have} ]] || die "no project() version in the venus-protocol tarball"
		[[ ${vn_want} == "${vn_have}" ]] ||
			die "VENUS_PROTOCOL_COMMIT declares ${vn_have}, mesa requires ${vn_want}"

		mv "${WORKDIR}/${VENUS_PROTOCOL_P}" "${S}/subprojects/${vn_dir}" || die

		# venus-protocol used to install a venus-protocol.pc advertising headers
		# it never installed: pkg.generate() ran unconditionally, while the
		# custom_targets that generate those headers carry "install: not_subproj".
		# Merged, that .pc poisoned the NEXT mesa build -- dependency() found it
		# by name, skipped the fallback, and handed the compiler
		# -I/usr/include/venus-protocol, a directory nobody created, so the build
		# died far from the cause on a missing vn_protocol_driver_*.h.  It only
		# bit when the leftover .pc matched the "== <ver>" mesa asks for, which
		# made it look intermittent: measured 2026-09-06, 26.3.0_pre20260905
		# installed a 1.1.2 .pc and 26.3.0_pre20260906, which also wants
		# == 1.1.2, failed to compile.
		#
		# v1.1.3 moved pkg.generate() inside "if not_subproj", so a subproject
		# build now installs nothing and the sed that used to strip the call is
		# gone.  What replaces it is an assertion, not blind trust: a regression
		# would leave no trace in THIS build and would only surface one snapshot
		# later, as that same missing-header compile error.  Counting is what
		# makes it hold -- a second, ungated call added next to the gated one
		# would still satisfy a plain "is it inside the block" test.
		local vn_meson="${S}/subprojects/${vn_dir}/meson.build"
		local vn_pkg_all vn_pkg_gated
		vn_pkg_all=$(grep -cF "pkg.generate(" "${vn_meson}")
		vn_pkg_gated=$(sed -n '/^if not_subproj$/,/^endif$/p' "${vn_meson}" |
			grep -cF "pkg.generate(")
		[[ ${vn_pkg_all} == "${vn_pkg_gated}" ]] ||
			die "venus-protocol calls pkg.generate() outside 'if not_subproj'"
	fi

	# We need this because we cannot tell meson to use DISTDIR yet
	pushd "${DISTDIR}" >/dev/null || die
	mkdir -p "${S}"/subprojects/packagecache || die
	local i
	for i in *.crate; do
		ln -s "${PWD}/${i}" "${S}/subprojects/packagecache/${i/.crate/}.tar.gz" || die
	done
	popd >/dev/null || die
}

pkg_pretend() {
	if use vulkan; then
		if ! use video_cards_asahi &&
		   ! use video_cards_d3d12 &&
		   ! use video_cards_freedreno &&
		   ! use video_cards_imagination &&
		   ! use video_cards_intel &&
		   ! use video_cards_lavapipe &&
		   ! use video_cards_nouveau &&
		   ! use video_cards_nvk &&
		   ! use video_cards_panfrost &&
		   ! use video_cards_radeonsi &&
		   ! use video_cards_v3d &&
		   ! use video_cards_virgl; then
			ewarn "Ignoring USE=vulkan     since VIDEO_CARDS does not contain asahi, d3d12, freedreno, imagination, intel, lavapipe, nouveau, nvk, panfrost, radeonsi, v3d, or virgl"
		fi
	fi

	# VA
	if use vaapi; then
		if ! use video_cards_d3d12 &&
		   ! use video_cards_nouveau &&
		   ! use video_cards_r600 &&
		   ! use video_cards_radeonsi &&
		   ! use video_cards_virgl; then
			ewarn "Ignoring USE=vaapi      since VIDEO_CARDS does not contain d3d12, nouveau, r600, radeonsi, or virgl"
		fi
	fi

	if ! use llvm; then
		use opencl     && ewarn "Ignoring USE=opencl     since USE does not contain llvm"
	fi
}

python_check_deps() {
	python_has_version -b ">=dev-python/mako-0.8.0[${PYTHON_USEDEP}]" &&
	python_has_version -b "dev-python/packaging[${PYTHON_USEDEP}]" &&
	python_has_version -b "dev-python/pyyaml[${PYTHON_USEDEP}]" || return 1
}

pkg_setup() {
	# warning message for bug 459306
	if use llvm && has_version llvm-core/llvm[!debug=]; then
		ewarn "Mismatch between debug USE flags in media-libs/mesa and llvm-core/llvm"
		ewarn "detected! This can cause problems. For details, see bug 459306."
	fi

	if use video_cards_intel ||
	   use video_cards_radeonsi; then
		if kernel_is -ge 5 11 3; then
			CONFIG_CHECK="~KCMP"
		elif kernel_is -ge 5 11; then
			CONFIG_CHECK="~CHECKPOINT_RESTORE"
		elif kernel_is -ge 5 10 20; then
			CONFIG_CHECK="~KCMP"
		else
			CONFIG_CHECK="~CHECKPOINT_RESTORE"
		fi
		linux-info_pkg_setup
	fi

	use llvm && llvm-r2_pkg_setup
	python-any-r1_pkg_setup

	if use opencl || (use vulkan && use video_cards_nvk); then
		rust_pkg_setup
	fi
}

# BENTOO-DIVERGENCE: PATCHES - astc-spirv1.2, a build fix for glslang
# enforcing SPIR-V 1.2 on the ASTC decoder shader. Drop when upstream
# carries it.
PATCHES=(
	# Build fix: the ASTC decoder shader needs SPIR-V 1.2, which glslang
	# started enforcing in 2026-08.  Drop when upstream carries it.
	"${FILESDIR}"/${PN}-astc-spirv1.2.patch
)

src_prepare() {
	default
	sed -i -e "/^PLATFORM_SYMBOLS/a '__gentoo_check_ldflags__'," \
		bin/symbols-check.py || die # bug #830728
}

multilib_src_configure() {
	local emesonargs=()

	# bug #932591 and https://gitlab.freedesktop.org/mesa/mesa/-/issues/11140
	filter-lto

	local platforms
	use X && platforms+="x11"
	use wayland && platforms+=",wayland"
	emesonargs+=(-Dplatforms=${platforms#,})

	if use video_cards_d3d12 ||
	   use video_cards_nouveau ||
	   use video_cards_r600 ||
	   use video_cards_radeonsi ||
	   use video_cards_virgl; then
		emesonargs+=($(meson_feature vaapi gallium-va))
		use vaapi && emesonargs+=( -Dva-libs-path="${EPREFIX}"/usr/$(get_libdir)/va/drivers )
	else
		emesonargs+=(-Dgallium-va=disabled)
	fi

	if use video_cards_d3d12; then
		emesonargs+=($(meson_feature vaapi gallium-d3d12-video))
	fi

	gallium_enable !llvm softpipe
	gallium_enable llvm llvmpipe
	gallium_enable video_cards_asahi asahi
	gallium_enable video_cards_d3d12 d3d12
	gallium_enable video_cards_freedreno freedreno
	gallium_enable video_cards_i915 i915
	gallium_enable video_cards_intel crocus iris
	gallium_enable video_cards_lima lima
	gallium_enable video_cards_nouveau nouveau
	gallium_enable video_cards_panfrost panfrost
	gallium_enable video_cards_v3d v3d
	gallium_enable video_cards_vc4 vc4
	gallium_enable video_cards_virgl virgl
	gallium_enable video_cards_vivante etnaviv
	gallium_enable video_cards_vmware svga
	gallium_enable video_cards_zink zink

	gallium_enable video_cards_r300 r300
	gallium_enable video_cards_r600 r600
	gallium_enable video_cards_radeonsi radeonsi
	if ! use video_cards_r300 &&
	   ! use video_cards_r600; then
		gallium_enable video_cards_radeon r300 r600
	fi

	if use llvm && use opencl; then
		PKG_CONFIG_PATH="$(get_llvm_prefix)/$(get_libdir)/pkgconfig"
		# See https://gitlab.freedesktop.org/mesa/mesa/-/blob/main/docs/rusticl.rst
		emesonargs+=(
			$(meson_native_true gallium-rusticl)
			-Drust_std=2021
		)
	fi

	if use vulkan; then
		vulkan_enable video_cards_asahi asahi
		vulkan_enable video_cards_d3d12 microsoft-experimental
		vulkan_enable video_cards_freedreno freedreno
		vulkan_enable video_cards_imagination imagination
		vulkan_enable video_cards_intel intel intel_hasvk
		vulkan_enable video_cards_lavapipe swrast
		vulkan_enable video_cards_nvk nouveau
		vulkan_enable video_cards_panfrost panfrost
		vulkan_enable video_cards_radeonsi amd
		vulkan_enable video_cards_v3d broadcom
		vulkan_enable video_cards_vc4 broadcom
		vulkan_enable video_cards_virgl virtio
		emesonargs+=(-Dvulkan-layers=anti-lag,device-select,overlay)
	fi

	driver_list() {
		local drivers="$(sort -u <<< "${1// /$'\n'}")"
		echo "${drivers//$'\n'/,}"
	}

	if use opengl && use X; then
		emesonargs+=(-Dglx=dri)
	else
		emesonargs+=(-Dglx=disabled)
	fi

	if [[ "${ABI}" == amd64 ]]; then
		emesonargs+=($(meson_feature video_cards_intel intel-rt))
	fi

	if use video_cards_asahi ||
	   use video_cards_intel ||
	   use video_cards_nvk ||
	   use video_cards_panfrost; then
	   emesonargs+=(-Dmesa-clc=system)
	fi

	if use video_cards_asahi ||
	   use video_cards_panfrost; then
	    emesonargs+=(-Dprecomp-compiler=system)
	fi

	# Never resolve venus-protocol from the system.  Nothing packages it --
	# upstream only generates headers at build time -- so any .pc on the host
	# is the stray one an older mesa left behind (see src_unpack), and it
	# would win over the subproject purely by being found first.
	if use vulkan && use video_cards_virgl; then
		emesonargs+=(--force-fallback-for=venus-protocol)
	fi

	use debug && EMESON_BUILDTYPE=debug

	emesonargs+=(
		$(meson_use test build-tests)
		-Dexpat=enabled
		$(meson_use opengl)
		$(meson_feature opengl gbm)
		$(meson_feature opengl gles1)
		$(meson_feature opengl gles2)
		$(meson_feature opengl glvnd)
		$(meson_feature opengl egl)
		$(meson_feature llvm)
		$(meson_feature lm-sensors lmsensors)
		$(meson_feature unwind libunwind)
		$(meson_feature vulkan display-info)
		$(meson_feature zstd)
		$(meson_use llvm amd-use-llvm)
		$(meson_use sysprof)
		$(meson_use cpu_flags_x86_sse2 sse2)
		-Dvalgrind=$(usex valgrind auto disabled)
		-Dvideo-codecs=$(usex proprietary-codecs "all" "all_free")
		-Dgallium-drivers=$(driver_list "${GALLIUM_DRIVERS[*]}")
		-Dvulkan-drivers=$(driver_list "${VULKAN_DRIVERS[*]}")
		-Db_ndebug=$(usex debug false true)
		-Dallow-broken-lto=true
	)
	meson_src_configure
}

multilib_src_test() {
	meson_src_test -t 100
}

# $1 - VIDEO_CARDS flag (check skipped for "--")
# other args - names of DRI drivers to enable
gallium_enable() {
	if [[ $1 == -- ]] || use $1; then
		shift
		GALLIUM_DRIVERS+=("$@")
	fi
}

vulkan_enable() {
	if [[ $1 == -- ]] || use $1; then
		shift
		VULKAN_DRIVERS+=("$@")
	fi
}