# gnome-desktop (libgnome-desktop) 44.5 — utilidades compartidas del escritorio GNOME:
# info de monitores (GnomeRR/BG), thumbnails (thumbnailer sandboxeado con bwrap+seccomp),
# idioma/locale (GnomeLanguage vía iso-codes). meson static.
#
# OJO VERSION: no existe "gnome-desktop 48". Upstream dejó de cortar releases estables tras 44.5
# y saltó directo a 51.alpha (verificado en download.gnome.org y en los tags de gitlab.gnome.org:
# ...44.3, 44.4, 44.5, 51.alpha — sin 45..50). Las distros que envían GNOME 45/46/47/48 shippean
# esta misma 44.5 porque es la ÚLTIMA estable de la librería compartida. Por eso 44.5 es la versión
# correcta para un escritorio GNOME 48. sha256 REAL de `curl -sL <url> | sha256sum`.
#
# Feature-minimal: build_gtk4=true, legacy_library=false (SIN libgnome-desktop-3/gtk3 — no está en
# el corpus), docs/debug_tools/installed_tests OFF, udev/systemd disabled (Wayland-only,
# el logind/udev lo cubre arje). backend GL vía gtk4 (ya wayland-only, sin X11).
#
# ══ PASA A LA ISLA DINÁMICA CON INTROSPECCIÓN (2026-07-29) ══════════════════════════════════════
# Antes iba estática y con `-Dintrospection=false`. Lo cambió el arranque de la sesión: gnome-shell
# importa `GnomeDesktop` y `GnomeBG` desde JavaScript sin condicional
# (`js/misc/dependencies.js`), o sea que los DOS typelibs son dep de runtime del shell.
#
# **No se hizo una variante `-introspected` aparte, y la razón es la regla de los dos registros de
# GType**: mutter y gnome-shell ENLAZAN libgnome-desktop, y gjs además dlopearía la `.so` que el
# typelib nombra. Con una variante convivirían la `.a` enlazada y la `.so` cargada, cada una con su
# tabla de GType — el mismo cuadro que costó el episodio de colord (`assertion 'G_IS_FILE (file)'
# failed` + SIGSEGV en binarios que el propio build acababa de enlazar). Acá la variante sería el
# error; el idioma `-shared` vale para librerías de C sin GObject, no para ésta.
#
# `yupana radio gnome-desktop` = **2 sellados a deuda** (mutter y gnome-shell), el mismo par que ya
# se reconstruyó dos veces en esta campaña. Barato y correcto.
#
# `default_library=both` y no `shared`: es el mismo remedio que json-glib. Los consumidores que
# siguen estáticos piden la `.a` y con shared-only cortan; la introspección sólo necesita que EXISTA
# la `.so`.
#
# Con `introspection=true` los dos seds de abajo que borraban las referencias a `libgnome_rr_gir` /
# `libgnome_bg_gir` **dejan de hacer falta y serían dañinos**: ahora esos .gir SÍ se generan, y
# borrarlos de `sources:` es justo lo que impediría que se declaren.
name    = "gnome-desktop"
version = "44.5"

[source]
tarball = "https://download.gnome.org/sources/gnome-desktop/44/gnome-desktop-44.5.tar.xz"
sha256  = "20e0995a6e3a03e8c1026c5a27bc3f45e69ffcc392ad743dcab6107a541d232f"

[build]
compiler = "zig-cc"
target   = "x86_64-linux-musl"
link     = "dynamic"

# (HISTÓRICO, por si alguien vuelve a apagar la introspección: con `-Dintrospection=false` hacían
# falta dos seds más, que borraban `libgnome_rr_gir` y `libgnome_bg_gir` de sendos
# `declare_dependency()`. Es un bug upstream que sólo aparece en esa combinación — alimentan
# `sources:` con un .gir que no se generó; gnome-rr lo deja como cadena VACÍA (meson 1.x la trata
# como fichero ⇒ «File  does not exist») y gnome-bg SIN DEFINIR (⇒ «unknown variable»). El tercer
# sitio, libgnome-desktop/meson.build:163, inicializa a `[]`, que meson aplana sin ruido: es el
# patrón correcto y la prueba de que los otros dos son el descuido. Con introspección encendida los
# .gir existen y los seds sobran.)
#
# El sed que SÍ queda saca `subdir('tests')`: `-Dinstalled_tests=false` sólo decide si los tests se
# INSTALAN, no si se compilan, y el subdir se incluye incondicionalmente. Su único ejecutable
# (bg-slide-show) se enlaza con `-static` contra `-lgtk-4`, y desde la onda 2 gtk4 es DINÁMICA
# (isla dinámica de la introspección) ⇒ no existe libgtk-4.a y el link muere. La librería —lo
# único que esta receta produce para el escritorio— ya está enlazada cuando eso pasa: 26 de 27
# targets. No se compila un exe de prueba que nadie instala.
[build.phases]
configure = "sed -i \"/^subdir('tests')$/d\" meson.build && PKG_CONFIG_PATH=/usr/lib/pkgconfig PYTHONPATH=/usr/lib/python3.12/site-packages meson setup output --prefix=/usr --buildtype=release --wrap-mode=nodownload -Ddefault_library=both -Dbuild_gtk4=true -Dlegacy_library=false -Dintrospection=true -Ddesktop_docs=false -Ddebug_tools=false -Dgtk_doc=false -Dinstalled_tests=false -Dudev=disabled -Dsystemd=disabled -Dc_args=-Wno-error=date-time"
compile   = "PYTHONPATH=/usr/lib/python3.12/site-packages ninja -C output"
install   = "PYTHONPATH=/usr/lib/python3.12/site-packages DESTDIR=/out meson install -C output --no-rebuild"

# deps = tools meson + gtk4 y su cierre .pc transitivo completo (static ⇒ pkg-config resuelve
# Requires.private). libxkbcommon aporta xkbregistry (dep opcional, required:false en meson.build).
#
# gsettings-desktop-schemas: REQUERIDA (schemas_dep) — YA sellada (b3:4777231b), en [deps].build.
#
# Las 3 FRONTERAS de este comentario quedaron CERRADAS el 2026-07-27 (onda 3):
#   iso-codes         → receta nueva en esta misma cola (data + .pc; fuente = pool de Debian).
#   xkeyboard-config  → duplicada desde recipes/incoming-kde/ a esta cola. El resolver sólo mira la
#                       cola propia + recipes/, y el fichero es IDÉNTICO ⇒ mismo ArtifactHash
#                       (b3:bcf9b766) ⇒ cache-hit del artefacto que KDE ya selló, cero rebuild.
#   libseccomp        → receta nueva en esta misma cola (autotools estático, gperf de build-dep).
[deps]
# Las variantes `-shared` (cairo, fontconfig, freetype, libpng, zlib, libjpeg-turbo, libtiff) NO son
# cosmética: con las estáticas el scanner MUERE. g-ir-scanner compila y EJECUTA un binario temporal
# contra la librería recién construida, y para eso carga todo el árbol dinámico. Con `libpng` estática
# no hay `libpng16.so`, así que `libgdk_pixbuf-2.0.so.0` —que sí es dinámica— no relocaliza:
#   Error relocating /usr/lib/libgdk_pixbuf-2.0.so.0: png_set_write_fn: symbol not found
# y el `ldd` con que el scanner resuelve las shlibs sale con 127 («Error loading shared library»),
# que es lo que se ve en el traceback de shlibs.py:106. Es la misma lista que declara gtk4, por la
# misma razón. Regla: si una receta introspecta, su cierre entero tiene que ser cargable.
build = ["meson", "samurai", "python3", "pkgconf", "py3-setuptools", "gobject-introspection", "gi-foreign-girs", "glib-introspected", "gsettings-desktop-schemas", "gtk4", "glib", "gdk-pixbuf", "fontconfig-shared", "libxkbcommon", "cairo-shared", "pango", "graphene", "libepoxy", "wayland", "wayland-protocols", "libdrm", "harfbuzz", "fribidi", "libpng-shared", "pixman", "freetype-shared", "expat", "libffi", "pcre2", "zlib-shared", "libjpeg-turbo-shared", "libtiff-shared", "mesa", "iso-codes", "xkeyboard-config", "libseccomp"]
