fix: aplicar revisiones de CodeRabbit del PR #20

- marco-teorico.tex: corregir contrato de argumentos de \metricbox en
  el ejemplo y en los demos; el 4º arg es un icono (\faArrowDown), no
  un nombre de color; actualizar también la descripción del componente
- revision-rapida.py: preservar número de líneas al vaciar bloques de
  código (evita que los diagnósticos apunten a líneas incorrectas)
- revision-rapida.py: recoger \label{} solo fuera de bloques de código
  para que etiquetas de ejemplo (latexcode/codigosimple) no oculten
  referencias rotas reales
- eps-arquitectura.sty: envolver \SuspendTagging / \ResumeTagging con
  \IfPackageLoadedTF{tagpdf}{...}{} para garantizar compatibilidad con
  instalaciones sin tagpdf (LaTeX < 2024 sin DocumentMetadata)

Author: jmrplens

contenido/capitulos/marco-teorico.tex

@@ -676,19 +676,19 @@ \subsection{Logs y Métricas}
 \end{logbox}
 
 \minisec{Tarjeta de métrica (metricbox)}
-Muestra un valor con etiqueta, unidad y color indicador.
+Muestra un valor con etiqueta, variación y un icono indicador.
 
 \begin{codigosimple}{latex}{Sintaxis: metricbox}
-\metricbox{Etiqueta}{valor}{unidad}{color}
+\metricbox{Etiqueta}{valor}{variación}{\faArrowDown}
 \end{codigosimple}
 
 \vspace{1em}
 \noindent
-\metricbox{Tiempo de respuesta}{45}{ms}{eps-success}
+\metricbox{Tiempo de respuesta}{45 ms}{-12\%}{\faArrowDown}
 \hfill
-\metricbox{Uso de CPU}{78}{\%}{eps-warning}
+\metricbox{Uso de CPU}{78\%}{+5\%}{\faArrowUp}
 \hfill
-\metricbox{Memoria}{2.4}{GB}{eps-info}
+\metricbox{Memoria}{2.4 GB}{-0.3 GB}{\faArrowDown}
 
 
 %% =============================================================================

scripts/revision-rapida.py

@@ -112,14 +112,18 @@ def eliminar_bloques_codigo(texto: str) -> str:
         "phpcode", "phpcodeNN", "terminal",
     ]
     for entorno in entornos:
-        # Reemplaza el CONTENIDO del entorno por una línea vacía,
-        # manteniendo \begin y \end para no desplazar números de línea en exceso.
-        texto = re.sub(
-            r"(\\begin\{" + re.escape(entorno) + r"\}(?:\[[^\]]*\])?(?:\{[^}]*\})*(?:\{[^}]*\})*)(.*?)(\\end\{" + re.escape(entorno) + r"\})",
-            r"\1\n\3",
-            texto,
-            flags=re.DOTALL,
+        # Reemplaza el CONTENIDO del entorno preservando el número de líneas,
+        # para que los números de línea de los diagnósticos posteriores sean correctos.
+        patron = (
+            r"(\\begin\{" + re.escape(entorno) + r"\}(?:\[[^\]]*\])?"
+            r"(?:\{[^}]*\})*(?:\{[^}]*\})*)(.*?)(\\end\{" + re.escape(entorno) + r"\})"
         )
+
+        def _vaciar_bloque(match):
+            lineas = max(match.group(2).count("\n"), 1)
+            return match.group(1) + ("\n" * lineas) + match.group(3)
+
+        texto = re.sub(patron, _vaciar_bloque, texto, flags=re.DOTALL)
     # Eliminar contenido de \verb|...|, \verb!...!, \verb+...+ (verbatim inline)
     texto = re.sub(r"\\verb([^a-zA-Z*])(.*?)\1", r"\\verb\1VERBATIM\1", texto)
     return texto
@@ -272,11 +276,12 @@ def analizar_referencias_cruzadas(archivos_tex: list) -> list:
 
     for ruta in archivos_tex:
         texto_raw = eliminar_comentarios(leer_tex(ruta))
-        # Labels se recogen del texto completo (pueden definirse dentro de entornos)
-        for m in re.finditer(r"\\label\{([^}]+)\}", texto_raw):
-            labels_definidos.add(m.group(1))
-        # Referencias se buscan solo fuera de bloques de código
+        # Labels y referencias se recogen solo fuera de bloques de código,
+        # para evitar que etiquetas de ejemplo (dentro de codigosimple/latexcode)
+        # se registren como definiciones reales y oculten referencias rotas.
         texto = eliminar_bloques_codigo(texto_raw)
+        for m in re.finditer(r"\\label\{([^}]+)\}", texto):
+            labels_definidos.add(m.group(1))
         for m in re.finditer(r"\\(?:ref|pageref|cref|Cref)\{([^}]+)\}", texto):
             linea = texto[:m.start()].count("\n") + 1
             refs_usadas.append((str(ruta.relative_to(RAIZ)), linea, m.group(1)))

sty/componentes/eps-arquitectura.sty

@@ -158,7 +158,8 @@
   \setcounter{partidanum}{0}
   \subsection*{#1}
   % Suspender tagging PDF/UA-2 para evitar artefactos con longtable+multicolumn
-  \SuspendTagging{presupuesto-longtable}%
+  % Guard: solo si tagpdf está cargado (LaTeX 2024+ o con DocumentMetadata)
+  \IfPackageLoadedTF{tagpdf}{\SuspendTagging{presupuesto-longtable}}{}%
   % Columnas con ancho fijo para asegurar alineación correcta y evitar desborde
   % p{1.5cm}: Código
   % p{desc}: Descripción (calculada)
@@ -179,7 +180,7 @@
     \endlastfoot
 }{%
   \end{longtable}
-  \ResumeTagging{presupuesto-longtable}%
+  \IfPackageLoadedTF{tagpdf}{\ResumeTagging{presupuesto-longtable}}{}%
   \endgroup
 }