# kirigami 6.27.0 — KDE Frameworks 6 (tier-4, ADR 0011). Toolkit QML de KDE (UI Plasma Mobile/Desktop).
# Tarball 6.27 se llama "kirigami" (ya no kirigami2). Precursor QML-pesado de Plasma.
# CMakeLists: find_package(Qt6 REQUIRED Core Quick Gui Svg QuickControls2 Concurrent ShaderTools).
#   Quick+QuickControls2 → qtdeclarative (en Qt6 QtQuickControls2 vive en el repo qtdeclarative).
#   Svg → qtsvg. ShaderTools (qsb) → qtshadertools. Core/Gui/Concurrent/DBus → qtbase.
# CERO deps KF6 (el único find_package(KF6Kirigami) es auto-referencia en examples, OFF). Sin option(WITH_X11).
# USE_DBUS ON por defecto en Linux → Qt6DBus (qtbase). BUILD_EXAMPLES OFF por defecto. DESKTOP_ENABLED ON.
#
# ══ ⚠ ESTA RECETA ERA NO-DETERMINISTA, Y SE ARREGLÓ EL 2026-09-14 (SDD 23) ═══════════════════════
# Medido, no sospechado: dos reconstrucciones seguidas con las MISMAS entradas y el MISMO lab daban
# artefactos distintos. Eran dos causas independientes, y cada una tiene su arreglo abajo.
#
# ── CAUSA 1: el AOT de QML compilaba un CONJUNTO DISTINTO de funciones en cada corrida ───────────
# `libKirigamiTemplates.so` cambiaba de tamaño (5.737.344 contra 5.795.072 bytes) y difería en 177
# símbolos locales, todos `QmlCacheGeneratedCode…__invoke`, concentrados en CUATRO ficheros QML:
# InlineMessage, LinkButton, NavigationTabBar y Badge. No es que los símbolos se renumeren: es que
# una corrida compila a AOT funciones que la otra no.
#
# Y esos cuatro son exactamente los que importan MÓDULOS QML HERMANOS del propio proyecto
# (`org.kde.kirigami.platform`, `.primitives`, `.controls`). `qmlcachegen` sólo compila a AOT lo que
# puede resolver de tipos, y los tipos de un módulo hermano salen de su `.qmltypes`, que lo produce
# OTRO objetivo del mismo build. `src/templates/CMakeLists.txt` no declara `DEPENDENCIES` ninguna
# ⇒ con ninja en paralelo, que el `.qmltypes` del hermano exista cuando corre el cachegen de
# templates es una CARRERA. Se gana o se pierde según el planificador, y el artefacto sale distinto.
#
# Arreglo: `-j1` en el compile. Con ninja serial el orden es un topológico FIJO ⇒ el cachegen ve
# siempre el mismo estado y compila siempre el mismo conjunto.
#
# ⚠ Esto NO contradice la regla de «el paralelismo no se capa en la receta». Esa regla es sobre
# THROTTLING por recursos —que va por `nice`/`taskset` justamente para no re-hashear—; acá el `-j`
# es CORRECCIÓN, y el re-hash es el precio que se decidió pagar (arrastra 37 dependientes).
#
# ⚠ Las alternativas se miraron y se descartaron, con el motivo:
#   · `-DQT_QML_NO_CACHEGEN=ON` — determinista y rápido, pero apaga TAMBIÉN el bytecode precompilado
#     de todo el QML de Kirigami: eso es coste de arranque en el escritorio, no de build.
#   · `--only-bytecode` por objetivo — sería lo quirúrgico (conserva bytecode, tira sólo el AOT),
#     pero `QT_QMLCACHEGEN_ARGUMENTS` es propiedad DE OBJETIVO y no es INHERITED, así que no hay
#     forma de ponerla desde la línea de órdenes; haría falta parchear los 9 subdirectorios.
#   · declarar `DEPENDENCIES` en templates — es lo correcto aguas arriba, pero `controls` importa
#     `templates` y `templates` importa `controls`: el ciclo hay que resolverlo con cuidado y eso
#     es trabajo de upstream, no de esta receta.
#
# ── CAUSA 2: el `.tar.bz2` de plantillas se armaba SIN ORDEN ─────────────────────────────────────
# `usr/share/kdevappwizard/templates/kirigami6.tar.bz2` difería desde el byte 0xa, o sea desde el
# primer bloque comprimido. El macro `kde_package_app_templates` de ECM SÍ tiene camino reproducible
# —`--sort=name --mtime=@$SOURCE_DATE_EPOCH --numeric-owner --owner=0 --group=0`— pero está detrás
# de un `if(GNU_TAR_FOUND)`, y esa comprobación corre `tar --sort=name --version` y exige que diga
# «GNU tar». El rootfs del lab es Alpine: `tar` es BUSYBOX ⇒ la comprobación falla ⇒ cae al camino
# de respaldo `cmake -E tar cvfj`, que ni ordena ni normaliza mtime/owner. El orden lo ponía el
# readdir.
#
# Arreglo: `tar` (GNU tar 1.35, ya en el corpus) entra en `[deps] build`. Con él en el overlay la
# comprobación de ECM pasa y se toma el camino reproducible. `SOURCE_DATE_EPOCH` ya lo fija el
# sandbox (=1), así que el `--mtime` queda pineado sin tocar nada más.
#
# Comprobación: `scripts/verificar-repro.sh` sobre esta receta — dos reconstrucciones IDÉNTICAS.
name    = "kirigami"
version = "6.27.0"
license = "LGPL-2.1-or-later OR LGPL-3.0-or-later"

[source]
tarball = "https://download.kde.org/stable/frameworks/6.27/kirigami-6.27.0.tar.xz"
sha256  = "d7daa74e9fe81b674e54e6e979feb85d3d2f4216bf6d9c02bfaa2c021fe1ac2d"

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

[build.phases]
configure = '''
ZW="$PWD/.zwrap"; mkdir -p "$ZW"
cat > "$ZW/cc"  <<'W'
#!/bin/sh
a=""; for x in "$@"; do [ "$x" = "-Wl,--fatal-warnings" ] && continue; a="$a $x"; done
exec /opt/zig/zig cc -mcpu=baseline $a
W
cat > "$ZW/cxx" <<'W'
#!/bin/sh
a=""; for x in "$@"; do [ "$x" = "-Wl,--fatal-warnings" ] && continue; a="$a $x"; done
exec /opt/zig/zig c++ -mcpu=baseline $a
W
chmod +x "$ZW/cc" "$ZW/cxx"
cmake -B build -G Ninja -Wno-dev \
  -DCMAKE_C_COMPILER="$ZW/cc" -DCMAKE_CXX_COMPILER="$ZW/cxx" -DCMAKE_ASM_COMPILER="$ZW/cc" \
  -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=/usr -DCMAKE_PREFIX_PATH=/usr \
  -DCMAKE_INTERPROCEDURAL_OPTIMIZATION=OFF \
  -DBUILD_TESTING=OFF -DBUILD_PYTHON_BINDINGS=OFF -DBUILD_EXAMPLES=OFF
'''
# ⚠ `-j1` NO es throttling: es lo que hace determinista el AOT de QML. Ver la cabecera.
compile = "cmake --build build -j1"
install = "DESTDIR=/out cmake --install build"

[deps]
# `tar` = GNU tar. NO es un capricho: sin él, ECM no reconoce un tar GNU y arma el .tar.bz2 de
# plantillas por el camino NO reproducible. Ver la cabecera, causa 2.
build = ["cmake", "samurai", "python3", "pkgconf", "qtbase", "dbus", "extra-cmake-modules", "qttools", "mesa", "libdrm", "libxkbcommon", "wayland", "qtdeclarative", "qtsvg", "qtshadertools", "tar"]