feat(tahuantinsuyu): fase 13 — Solar Return como sexto overlay

Sexto módulo siguiendo el patrón establecido. Cambio estructural:
3-way mutual exclusion para los módulos que comparten el outer ring
(transit + synastry + solar_return). Constante OUTER_RING_MODULES
abstrae el grupo para que fase 14+ pueda sumar lunar return / planet
returns sin tocar la lógica del shell.

- engine: PipelineRequest::SolarReturn { target_age_years } +
  build_solar_return_overlay. Llama eternal_astrology::next_return
  (Sun back to natal Sun, ventana ±1.5 años) desde un instante
  ~30 días antes del cumpleaños target. Computa la carta natal
  completa al return_instant (mismo observer + config natales —
  convención clásica) y la apila como Outer + Aspects cross natal ×
  return. z=12/13. Import: `next_return` añadido a la lista de
  re-exports del bridge.
- modules: solar_return::SolarReturnModule (id "solar_return", toggle
  + slider target_age_years 0..120 step 1.0). Registry pasa a 6
  módulos para Natal.
- shell: OUTER_RING_MODULES const con los tres ids; mutual exclusion
  generalizada de pair-wise a N-way (for-loop sobre el slice). Init
  de age en apply_selection ahora incluye solar_return. build_requests
  agrega la rama. Misma estructura que progression/solar_arc en la
  rama de age handling.
- canvas: aspect_endpoints("solar_return") = (bodies, transits). Tres
  loops del outer ring (paint dots, paint glyphs, anillos guía) ahora
  aceptan los tres module_ids.

Probarlo: en el panel, slider "Edad del retorno" en valor entero (ej.
36) + toggle "Activar" = ves la carta del año cuando volviste a tu
Sol natal a los 36, con todos sus planetas en el outer ring y cross
aspects con tu natal. Cambiando el slider podés explorar año por año.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This commit is contained in:
sergio
2026-05-17 11:23:25 +00:00
parent d9e21fbedc
commit 8d95833c20
5 changed files with 203 additions and 26 deletions
+22 -15
View File
@@ -144,7 +144,7 @@ impl Shell {
// edad actual. Estos quedan en module_configs como
// valor base si el usuario nunca tocó el slider.
self.module_configs.clear();
for module_id in ["progression", "solar_arc"] {
for module_id in ["progression", "solar_arc", "solar_return"] {
let entry = self
.module_configs
.entry(module_id.into())
@@ -239,6 +239,12 @@ impl Shell {
});
}
}
if module_enabled(&self.module_configs, "solar_return") {
let age = self.module_age_or_current("solar_return");
requests.push(PipelineRequest::SolarReturn {
target_age_years: age,
});
}
requests
}
@@ -475,17 +481,13 @@ impl Shell {
if let serde_json::Value::Object(map) = entry {
map.insert(key.clone(), value.clone());
}
// Transit y Synastry comparten el outer ring del
// canvas — son mutuamente excluyentes. Al prender
// uno, apagamos el otro y sincronizamos el panel.
if key == "enabled" && bool_val {
let conflicting = match module_id.as_str() {
"transit" => Some("synastry"),
"synastry" => Some("transit"),
_ => None,
};
if let Some(other) = conflicting {
if module_enabled(&self.module_configs, other) {
// Transit, Synastry y Solar Return comparten el
// outer ring del canvas — son mutuamente excluyentes.
// Al prender uno, apagamos los otros + sync panel +
// persist.
if key == "enabled" && bool_val && OUTER_RING_MODULES.contains(&module_id.as_str()) {
for &other in OUTER_RING_MODULES.iter() {
if other != module_id && module_enabled(&self.module_configs, other) {
set_module_enabled(&mut self.module_configs, other, false);
let other_str = other.to_string();
self.panel.update(cx, |p, cx| {
@@ -496,9 +498,9 @@ impl Shell {
}
}
// Sincronizar visualmente el toggle [T] del canvas
// cuando el cambio afecta el outer ring (transit o
// synastry — ambos lo usan).
if (module_id == "transit" || module_id == "synastry") && key == "enabled" {
// cuando el cambio afecta el outer ring (transit,
// synastry o solar_return).
if OUTER_RING_MODULES.contains(&module_id.as_str()) && key == "enabled" {
self.canvas.update(cx, |c, cx| {
c.set_layer_visible(LayerKind::Outer, bool_val, cx)
});
@@ -520,6 +522,11 @@ impl Shell {
// Helpers de module_configs
// =====================================================================
/// Módulos que pintan en el outer ring del canvas — mutuamente
/// excluyentes a nivel de UI. Al prender uno, los otros se apagan.
const OUTER_RING_MODULES: &[&str] = &["transit", "synastry", "solar_return"];
/// Etiqueta breve para mostrar al elegir una carta en el picker:
/// `"YYYY-MM-DD · Lugar"` cuando hay lugar, sino solo la fecha.
fn format_birth_brief(birth: &tahuantinsuyu_model::StoredBirthData) -> String {