sergio/takana

1# deckcraft — las presentaciones: `.pptx` de ida y vuelta
2#
3# ── DE DÓNDE SALE ESTA FAMILIA ─────────────────────────────────────────────────────────────────
4# ArtCraft publica doce aplicaciones de escritorio en **Rust puro sobre egui + wgpu**, Apache-2.0 o
5# MIT, cada una en su propio repo de `github.com/storytold`. Para esta casa son interesantes por una
6# razón concreta y medible: **no tienen ni una línea de GTK ni de Qt**, que es el muro que deja a
7# `libreoffice` en «59 recetas y tres muros ⇒ no es un ticket, es un año»
8# (`docs/plan-apps-usuario-final.md:48`). Acá cada app es UNA receta `cargo_vendor`.
9#
10# La primera que se midió fue `gridcraft`, y la medición está en su receta: sella en 12 min, abre
11# ventana en el perfil `escritorio-sway` y **pinta** — `wgpu` toma el backend **GL** sobre EGL/GLES
12# con llvmpipe (GL 4.5), sin Vulkan y sin ninguna variable de entorno, porque el default de
13# `egui-wgpu` es `Backends::from_env().unwrap_or(PRIMARY | GL)`.
14#
15# ⚠ **Son 0.x y se mueven solas.** Portar esto es comprar su cinta de correr (SDD 26 §2). Se pinea
16# el **sha del tag**, no `main`, y por eso la versión de arriba es una release y no «lo de hoy».
17#
18# ── X11: NO SE PARCHEA, Y ESO ES UNA DECISIÓN MEDIDA ──────────────────────────────────────────
19# Las doce declaran `eframe` con los features `wayland` **y** `x11`, y la primera versión de esto
20# arrancaba el feature `x11` con un `sed`. Se quitó, por tres cosas que se midieron al hacerlo:
21#   1. **No hay muro de build**: lo que `x11` arrastra es `x11rb` (protocolo X en Rust puro) y
22#      `x11-dl` (que hace `dlopen`, no enlaza). Ninguna receta nueva, ni un `.so` de X en el link.
23#   2. **No hay muro de runtime**: winit elige Wayland cuando `WAYLAND_DISPLAY` está puesto, y en
24#      esta distro `libX11` directamente no existe ⇒ el camino X es inerte, no roto.
25#   3. **Quitarlo SÍ cuesta**: cambia el grafo ⇒ el `Cargo.lock` deja de cerrar y hay que soltar el
26#      `--locked` del compile (medido: `error: cannot update the lock file … because --locked`).
27#      Y varias de estas apps declaran `winit` con `x11` por su cuenta y lo USAN en el código
28#      (`photocraft` abre por Xwayland si el usuario lo elige en Preferencias), así que un `sed`
29#      ciego rompe el build en unas y es un no-op en otras.
30# ⇒ Se deja el feature y se conserva el `--locked`, que es el pin fuerte. La distro sigue siendo
31# Wayland-only por lo que NO lleva en la imagen, no por lo que esta receta le recorta al upstream.
32#
33# ── LA FORMA ───────────────────────────────────────────────────────────────────────────────────
34# `link = "dynamic"` + `-crt-static` como `boveda`/`shuma-pregunta`/`mirada-greeter`: winit y wgpu
35# cargan `libwayland-client`, `libEGL`/`libvulkan` por `dlopen`, y un binario `crt-static` no puede.
36# El lanzador, el MIME y los iconos son de UPSTREAM — lo contrario de `boveda.toml`, donde hay que
37# autorar el `.desktop` — y están enhebrados: `Icon=`/`StartupWMClass=` del `.desktop`, el nombre de
38# los iconos hicolor y el `with_app_id()` de la app coinciden en `ai.storyteller.deckcraft`, así que
39# el emparejamiento ventana↔lanzador funciona en Wayland sin parchear nada.
40#
41name    = "deckcraft"
42version = "0.6.1"
43license = "MIT OR Apache-2.0"
44
45[source]
46# `v0.6.1`, el tag vigente al 2026-10-12. Se pinea el SHA: un tag se mueve.
47repo   = "https://github.com/storytold/deckcraft"
48commit = "688c7ef592c901ca4541c25e210c1b302e4dc066"
49# ⚠ `vendor_cargo_deps` **sobrescribe** `<src>/.cargo/config.toml` con `std::fs::write`
50# (`crates/takana-build/src/fetch.rs:852`), y estos repos traen uno propio. Hoy es inocuo —dentro
51# sólo hay `[alias] xtask`, que estas recetas no usan— pero si un bump mete ahí un `rustflags` o un
52# `linker`, desaparece sin un solo aviso y el fallo no va a nombrar al config.
53# El `Cargo.lock` está committeado ⇒ el vendoreo va con `--locked` y queda pineado en el tiempo.
54
55[build]
56compiler = "zig-cc"
57target   = "x86_64-linux-musl"
58link     = "dynamic"
59flags    = ["-p", "deckcraft", "--bin", "deckcraft"]
60
61[build.phases]
62compile = '''
63set -e
64# LOCKSTEP_XML_PATH — la causa entera está en `mirada-greeter.toml` y repetida en `boveda.toml`:
65# `accesskit` → `atspi` → `atspi-common`, que trae `zbus-lockstep-macros` como dep NORMAL y cuyo
66# `#[validate]` recorre el dir `xml/` llamando `.extension().expect()` en CADA entrada ⇒ PANICA al
67# toparse con el subdirectorio `xml/schemas/`. Apuntando la variable a un dir con sólo los `.xml` se
68# evita. La comprobación es a gritos: un `cp` mudo dejaría la variable apuntando a un dir VACÍO y el
69# panic volvería con el error lejos de la causa.
70XMLDIR="$PWD/.atspi-lockstep-xml"
71mkdir -p "$XMLDIR"
72ls vendor/atspi-common/xml/*.xml >/dev/null 2>&1 || { echo "no hay vendor/atspi-common/xml/*.xml — ¿cambió el vendoreo o la versión de atspi? sin esto zbus-lockstep-macros panica en xml/schemas/" >&2; exit 1; }
73cp vendor/atspi-common/xml/*.xml "$XMLDIR"/
74export LOCKSTEP_XML_PATH="$XMLDIR"
75
76# El envoltorio de zig-cc, igual que en las otras winit+wgpu del corpus.
77printf '%s\n' '#!/bin/sh' 'for a do' 'case "$a" in --target=*) a=--target=x86_64-linux-musl ;; esac' 'set -- "$@" "$a"' 'shift' 'done' 'exec zig cc -mcpu=baseline "$@"' > "$PWD/.hammer-zig-cc"
78chmod +x "$PWD/.hammer-zig-cc"
79printf '%s\n' '#!/bin/sh' 'exec zig ar "$@"' > "$PWD/.hammer-zig-ar"
80chmod +x "$PWD/.hammer-zig-ar"
81RF="-C linker=$PWD/.hammer-zig-cc"
82rustc -vV | grep -q 'host: .*-alpine-' || RF="$RF -C link-self-contained=no"
83CC="$PWD/.hammer-zig-cc" AR="$PWD/.hammer-zig-ar" RUSTFLAGS="$RF" cargo rustc --release --locked --offline -p deckcraft --bin deckcraft -- -C target-feature=-crt-static
84'''
85install = '''
86set -e
87test -x target/release/deckcraft || { echo "no hay target/release/deckcraft — ¿cambió el nombre del bin?" >&2; exit 1; }
88install -Dm755 target/release/deckcraft /out/usr/bin/deckcraft
89
90install -Dm644 packaging/linux/ai.storyteller.deckcraft.desktop /out/usr/share/applications/ai.storyteller.deckcraft.desktop
91install -Dm644 packaging/linux/ai.storyteller.deckcraft.mime.xml /out/usr/share/mime/packages/ai.storyteller.deckcraft.xml
92# Los iconos se recorren con un glob y NO con una lista de tamaños: `effectcraft` y `filmcraft`
93# traen el doble de entradas que las demás, y una lista fija los habría instalado a medias en
94# silencio. Se cuenta lo instalado y se falla si es cero.
95n=0
96for p in assets/app-icon/hicolor/*/apps/ai.storyteller.deckcraft.*; do
97  [ -f "$p" ] || continue
98  install -Dm644 "$p" "/out/usr/share/icons/hicolor/${p#assets/app-icon/hicolor/}"
99  n=$((n+1))
100done
101[ "$n" -gt 0 ] || { echo "ningún icono instalado — ¿cambió assets/app-icon/hicolor/?" >&2; exit 1; }
102install -Dm644 LICENSE-MIT /out/usr/share/licenses/deckcraft/LICENSE-MIT
103install -Dm644 LICENSE-APACHE /out/usr/share/licenses/deckcraft/LICENSE-APACHE
104
105# Un `.desktop` vacío o un binario de 0 bytes son la forma de fallo de la casa: artefacto presente,
106# función ausente (CLAUDE.md §3).
107test -s /out/usr/share/applications/ai.storyteller.deckcraft.desktop
108test -s /out/usr/bin/deckcraft
109'''
110
111[deps]
112# Igual que las demás de la familia MÁS `alsa-lib`, y ésta no es decorativa: la app trae `cpal`
113# **sin condicionar por plataforma**, que en Linux es `alsa-sys` y pregunta por `alsa.pc` con
114# pkg-config ⇒ sin esta dep el build muere en el `build.rs` de `alsa-sys`, no en el link.
115# ⚠ Y el corpus hoy NO publica `alsa`: `scripts/provee.py --desde corpus alsa` sale «NADIE LO
116# PUBLICA en ninguna cola» aunque `recipes/alsa-lib.toml` exista — la receta está escrita y sin
117# sellar. Declararla acá la construye; no hay que hacer nada aparte.
118build = ["mesa", "wayland", "wayland-protocols", "libdrm", "expat", "zlib", "zstd", "libffi", "pkgconf", "alsa-lib"]