# gobject-introspection 1.84.0 — el escáner de metadata de GNOME (g-ir-scanner + typelibs).
# Es dep de casi toda lib GNOME (gtk4/libadwaita/etc. lo declaran cuando -Dintrospection=enabled).
# meson static, backend feature-minimal: doctool/gtk_doc/tests off, PERO build_introspection_data=true
# (los .gir/.typelib SON su razón de ser).
#
# BORRADOR PARA EL MAPA — dificultad conocida: g-ir-scanner NO es puro metadata. Para cada lib
# COMPILA y EJECUTA un pequeño binario "dumper" enlazado contra el target para volcar los GTypes en
# runtime. En un lab cross/hermetico static-musl esto es el palo largo del stack GNOME:
#   1) ejecutar un binario del target dentro del sandbox (aquí target==host x86_64-linux-musl, así que
#      NO hay emulación — a favor nuestro; el escenario cross real necesitaría qemu/exe_wrapper).
#   2) el dumper enlaza estático contra glib+libffi; el scanner invoca al compilador (CC/zig-cc) y al
#      linker en runtime ⇒ necesita el toolchain + el cierre .pc COMPLETO visible en PKG_CONFIG_PATH.
#   3) suele pelear con -static / musl (símbolos de introspección, gi-dump). PROBABLEMENTE NO selle a
#      la primera — dejar como frontera medida, no como sellado asumido.
name    = "gobject-introspection"
version = "1.84.0"
license = "LGPL-2.0-or-later AND GPL-2.0-or-later"

[source]
tarball = "https://download.gnome.org/sources/gobject-introspection/1.84/gobject-introspection-1.84.0.tar.xz"
sha256  = "945b57da7ec262e5c266b89e091d14be800cc424277d82a02872b7d794a84779"

[build]
compiler = "zig-cc"
target   = "x86_64-linux-musl"
# ISLA DINÁMICA: g-i es parte de la isla GNOME y linkea la glib dinámica. link=dynamic para que sus
# binarios internos (g-ir-compiler, dumper) tomen libglib-2.0.so CONSISTENTEMENTE — no mezclar el .a
# (estático) con la glib que ya trae libgirepository-2.0.so (dinámica): esa mezcla da DOS copias del
# estado de GType ⇒ g-ir-compiler SIGSEGV. Ver [[gnome-introspection-dinamica]].
link     = "dynamic"

[build.phases]
# build_introspection_data=FALSE: g-i 1.84 sólo genera aquí los typelibs EXTERNOS de X11/cairo
# (cairo/xlib/xft/xrandr/xfixes/win32) — que NO queremos (Wayland-only) y sobre los que g-ir-compiler
# hace SIGSEGV bajo musl. Los typelibs CORE (GLib/GObject/Gio) los produce glib (absorbió girepository).
# g-i aquí = las TOOLS (g-ir-scanner/compiler) que usan gtk4 &co. default_library=both (isla dinámica).
configure = "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 -Ddoctool=disabled -Dgtk_doc=false -Dtests=false -Dbuild_introspection_data=false -Dcairo=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]
# glib + su cierre .pc estático (pkgconf resuelve Requires.private: pcre2, zlib, libffi).
# flex/bison: el parser de anotaciones del scanner. libffi: además lo enlaza el dumper.
# py3-setuptools: meson.build:29 exige `python3 (setuptools)` importable (instala giscanner como
# paquete python) — el python3 del rootfs NO trae setuptools; se lo damos como módulo sellado.
build = ["meson", "samurai", "python3", "py3-setuptools", "pkgconf", "flex", "bison", "glib", "libffi", "pcre2", "zlib"]
# FRONTERA: cairo omitida a propósito (-Dcairo=disabled) — feature-minimal, evita el typelib Cairo-1.0.
