Spaces:

JairoDanielMT
/

doc-compiler-j2-pdf

Running

App Files Files Community

JairoDanielMT commited on 7 days ago

Commit

0324409

1 Parent(s): b647e89

templates actualizados y blindados

Browse files

Files changed (7) hide show

app/templates/IndexDocument.html.j2 +93 -33
app/templates/InternalModule.html.j2 +60 -25
app/templates/MapReduce.html.j2 +131 -67
app/templates/RESTlet.html.j2 +118 -43
app/templates/ScheduledScript.html.j2 +108 -37
app/templates/UserEventScript.html.j2 +69 -22
app/templates/components.html.j2 +21 -10

app/templates/IndexDocument.html.j2 CHANGED Viewed

@@ -3,30 +3,64 @@
   <head>
     <meta charset="UTF-8" />
     <title>Índice de Formas · {{ job_id }}</title>
     <style>
       body {
-        font-family: "Segoe UI", -apple-system, BlinkMacSystemFont, "Noto Sans", sans-serif;
         color: #0f172a;
-        margin: 28px;
         font-size: 12px;
       }
       h1 {
-        font-size: 24px;
         text-transform: uppercase;
         letter-spacing: 0.06em;
-        margin-bottom: 4px;
       }
       h2 {
         color: #475569;
         font-size: 14px;
-        margin-top: 4px;
-        margin-bottom: 16px;
       }
       table {
         width: 100%;
         border-collapse: collapse;
         font-size: 11px;
       }
       th,
       td {
         border: 1px solid #e2e8f0;
@@ -34,51 +68,77 @@
         text-align: left;
         vertical-align: top;
       }
       th {
         text-transform: uppercase;
         letter-spacing: 0.08em;
         font-size: 10px;
         background: #f1f5f9;
       }
       tbody tr:nth-child(odd) {
         background: #f8fafc;
       }
       .muted {
         color: #94a3b8;
         font-size: 10px;
         text-transform: uppercase;
         letter-spacing: 0.08em;
         margin-top: 24px;
       }
     </style>
   </head>
   <body>
-    <h1>Índice de Formas</h1>
-    <h2>Job {{ job_id }} · {{ entries|length }} documentos</h2>
-    <table>
-      <thead>
-        <tr>
-          <th>#</th>
-          <th>Archivo</th>
-          <th>Título</th>
-          <th>Tipo</th>
-          <th>Descripción</th>
-          <th>SuiteScript</th>
-        </tr>
-      </thead>
-      <tbody>
-        {% for entry in entries %}
-          <tr>
-            <td>{{ loop.index }}</td>
-            <td>{{ entry.path }}</td>
-            <td>{{ entry.title }}</td>
-            <td>{{ entry.script_type or "-" }}</td>
-            <td>{{ entry.description or "Sin descripción" }}</td>
-            <td>{{ entry.api_version or "-" }}</td>
-          </tr>
-        {% endfor %}
-      </tbody>
-    </table>
-    <p class="muted">Generado automáticamente {{ generated_at }}</p>
   </body>
 </html>

   <head>
     <meta charset="UTF-8" />
     <title>Índice de Formas · {{ job_id }}</title>
+    <!-- Fuente corporativa (Inter) -->
+    <link rel="preconnect" href="https://fonts.googleapis.com" />
+    <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
+    <link
+      href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&display=swap"
+      rel="stylesheet"
+    />
     <style>
+      @page {
+        size: A4;
+        margin: 25.4mm; /* 2.54 cm por lado */
+      }
       body {
+        font-family: "Inter", -apple-system, BlinkMacSystemFont, "Noto Sans",
+          system-ui, sans-serif;
         color: #0f172a;
+        margin: 0;
         font-size: 12px;
+        line-height: 1.6;
+        background: #ffffff;
+        padding: 0 0 8mm 0;
+      }
+      .page {
+        padding: 0;
+        margin: 0;
       }
       h1 {
+        font-size: 22px;
         text-transform: uppercase;
         letter-spacing: 0.06em;
+        margin: 0 0 4px 0;
       }
       h2 {
         color: #475569;
         font-size: 14px;
+        margin: 0 0 16px 0;
       }
       table {
         width: 100%;
         border-collapse: collapse;
         font-size: 11px;
       }
+      thead {
+        display: table-header-group; /* repite encabezado en cada página */
+      }
+      tbody tr {
+        page-break-inside: avoid;
+      }
       th,
       td {
         border: 1px solid #e2e8f0;
         text-align: left;
         vertical-align: top;
       }
       th {
         text-transform: uppercase;
         letter-spacing: 0.08em;
         font-size: 10px;
         background: #f1f5f9;
       }
       tbody tr:nth-child(odd) {
         background: #f8fafc;
       }
       .muted {
         color: #94a3b8;
         font-size: 10px;
         text-transform: uppercase;
         letter-spacing: 0.08em;
         margin-top: 24px;
+        text-align: right;
       }
     </style>
   </head>
   <body>
+    <div class="page">
+      <h1>Índice de Formas</h1>
+      <h2>
+        Job {{ job_id }} ·
+        {{ entries is defined and entries is iterable and entries|length or 0 }}
+        documentos
+      </h2>
+      {% if entries and entries is iterable %}
+        <table>
+          <thead>
+            <tr>
+              <th>#</th>
+              <th>Archivo</th>
+              <th>Título</th>
+              <th>Tipo</th>
+              <th>Descripción</th>
+              <th>SuiteScript</th>
+            </tr>
+          </thead>
+          <tbody>
+            {% for entry in entries %}
+              {# Si entry es mapping (dict), usamos sus campos. Si no, lo mostramos crudo. #}
+              {% if entry is mapping %}
+                <tr>
+                  <td>{{ loop.index }}</td>
+                  <td>{{ entry.path | default("-") }}</td>
+                  <td>{{ entry.title | default("-") }}</td>
+                  <td>{{ entry.script_type | default("-") }}</td>
+                  <td>{{ entry.description | default("Sin descripción") }}</td>
+                  <td>{{ entry.api_version | default("-") }}</td>
+                </tr>
+              {% else %}
+                <tr>
+                  <td>{{ loop.index }}</td>
+                  <td colspan="5">
+                    {{ entry }}
+                  </td>
+                </tr>
+              {% endif %}
+            {% endfor %}
+          </tbody>
+        </table>
+      {% else %}
+        <p>No se encontraron documentos para este job.</p>
+      {% endif %}
+      <p class="muted">Generado automáticamente {{ generated_at }}</p>
+    </div>
   </body>
 </html>

app/templates/InternalModule.html.j2 CHANGED Viewed

@@ -2,30 +2,65 @@
 {% import "components.html.j2" as ui %}
 {% block content %}
-<h1>{{ doc.metadata.script_type or "Módulo interno" }} · {{ doc.metadata.description or "Documentación" }}</h1>
-<p class="muted">Referencia funcional del módulo compartido.</p>
-{{ ui.metadata_block(doc.metadata) }}
-{{ ui.summary_block(doc.summary) }}
-{% if doc.api %}
-  <div class="section">
-    <h2>API pública</h2>
-    {% for fn in doc.api %}
-      <h3>{{ fn.name }}</h3>
-      <p>{{ fn.description }}</p>
-      {{ ui.table_block("Parámetros", fn.parameters, [
-        {"field": "name", "title": "Nombre"},
-        {"field": "description", "title": "Descripción"},
-        {"field": "type", "title": "Tipo"}
-      ]) }}
-      {{ ui.list_block("Efectos colaterales", fn.side_effects) }}
-      {{ ui.logic_block("Retorna", fn.returns) }}
-    {% endfor %}
-  </div>
-{% endif %}
-{{ ui.list_block("Efectos colaterales", doc.side_effects) }}
-{{ ui.list_block("Errores", doc.errors) }}
-{{ ui.logic_block("Detalles de implementación", doc.logic) }}
 {% endblock %}

 {% import "components.html.j2" as ui %}
 {% block content %}
+  <header class="doc-header">
+    <h1>{{ doc.metadata.script_type or "Módulo interno" }} · {{ doc.metadata.description or "Documentación" }}</h1>
+    <p class="doc-header-meta">
+      Módulo compartido / servicios internos
+    </p>
+    <p class="muted">Referencia funcional del módulo compartido.</p>
+  </header>
+  {{ ui.metadata_block(doc.metadata) }}
+  {{ ui.summary_block(doc.summary) }}
+  {# ------------------------ API pública ------------------------ #}
+  {% if doc.api %}
+    <div class="section">
+      <h2>API pública</h2>
+      {% for fn in doc.api %}
+        <h3>{{ fn.name }}</h3>
+        <p>{{ fn.description }}</p>
+        {# Par&aacute;metros: solo tabla si hay datos estructurados #}
+        {% if fn.parameters %}
+          {{ ui.table_block("Parámetros", fn.parameters, [
+            {"field": "name", "title": "Nombre"},
+            {"field": "description", "title": "Descripción"},
+            {"field": "type", "title": "Tipo"}
+          ]) }}
+        {% endif %}
+        {% if fn.side_effects %}
+          {{ ui.list_block("Efectos colaterales", fn.side_effects) }}
+        {% endif %}
+        {% if fn.returns %}
+          {{ ui.logic_block("Retorna", fn.returns) }}
+        {% endif %}
+      {% endfor %}
+    </div>
+  {% endif %}
+  {# ------------------------ Efectos generales del módulo ------------------------ #}
+  {% if doc.side_effects %}
+    {{ ui.list_block("Efectos colaterales", doc.side_effects) }}
+  {% endif %}
+  {# ------------------------ Errores ------------------------ #}
+  {% if doc.errors %}
+    {% if doc.errors is mapping %}
+      {# Si algún día viene como objeto: usar list_block sobre sus partes #}
+      {{ ui.list_block("Errores", doc.errors.explicit_checks or []) }}
+      {{ ui.list_block("Manejo de excepciones", doc.errors.exception_handling or []) }}
+    {% else %}
+      {# Caso actual típico: lista simple de strings #}
+      {{ ui.list_block("Errores", doc.errors) }}
+    {% endif %}
+  {% endif %}
+  {# ------------------------ Detalles de implementación ------------------------ #}
+  {% if doc.logic %}
+    {{ ui.logic_block("Detalles de implementación", doc.logic) }}
+  {% endif %}
 {% endblock %}

app/templates/MapReduce.html.j2 CHANGED Viewed

@@ -2,77 +2,141 @@
 {% import "components.html.j2" as ui %}
 {% block content %}
-<h1>Map/Reduce · {{ doc.metadata.description or doc.metadata.script_type }}</h1>
-<p class="muted">Pipeline de procesamiento por lotes.</p>
-{{ ui.metadata_block(doc.metadata) }}
-{{ ui.summary_block(doc.summary) }}
-{% if doc.getInputData %}
-  <div class="section">
-    <h2>getInputData</h2>
-    <p>{{ doc.getInputData.details }}</p>
-    {{ ui.table_block("Filtros", doc.getInputData.filters, [
-      {"field": "field", "title": "Campo"},
-      {"field": "operator", "title": "Operador"},
-      {"field": "value", "title": "Valor"}
-    ]) }}
-    {{ ui.table_block("Columnas", doc.getInputData.columns, [
-      {"field": "name", "title": "Nombre"},
-      {"field": "label", "title": "Etiqueta"}
-    ]) }}
-  </div>
-{% endif %}
-{% if doc.map %}
-  <div class="section">
-    <h2>map</h2>
-    <p>{{ doc.map.logic }}</p>
-    {{ ui.list_block("Campos utilizados", doc.map.fields_used) }}
-    {{ ui.table_block("Operaciones en registros", doc.map.record_operations, [
-      {"field": "type", "title": "Operación"},
-      {"field": "recordType", "title": "Record"},
-      {"field": "fields", "title": "Campos"}
     ]) }}
-  </div>
-{% endif %}
-{% if doc.reduce %}
-  <div class="section">
-    <h2>reduce</h2>
-    <p>{{ doc.reduce.logic }}</p>
-    {{ ui.list_block("Agregaciones", doc.reduce.aggregations) }}
-    {{ ui.table_block("Operaciones en registros", doc.reduce.record_operations, [
       {"field": "type", "title": "Operación"},
       {"field": "recordType", "title": "Record"},
       {"field": "fields", "title": "Campos"}
     ]) }}
-  </div>
-{% endif %}
-{% if doc.summarize %}
-  <div class="section">
-    <h2>summarize</h2>
-    <p>{{ doc.summarize.usage }}</p>
-    {{ ui.list_block("Errores", doc.summarize.errors) }}
-    {{ ui.list_block("Acciones finales", doc.summarize.final_actions) }}
-  </div>
-{% endif %}
-{{ ui.table_block("Búsquedas utilizadas", doc.searches, [
-  {"field": "id", "title": "ID"},
-  {"field": "filters", "title": "Filtros"},
-  {"field": "columns", "title": "Columnas"}
-]) }}
-{{ ui.table_block("Operaciones con registros", doc.records, [
-  {"field": "type", "title": "Operación"},
-  {"field": "recordType", "title": "Record"},
-  {"field": "fields", "title": "Campos"}
-]) }}
-{{ ui.list_block("Side effects", doc.side_effects) }}
-{{ ui.table_block("Errores", doc.errors, [
-  {"field": "location", "title": "Ubicación"},
-  {"field": "description", "title": "Descripción"}
-]) }}
 {% endblock %}

 {% import "components.html.j2" as ui %}
 {% block content %}
+  <header class="doc-header">
+    <h1>Map/Reduce · {{ doc.metadata.description or doc.metadata.script_type }}</h1>
+    <p class="doc-header-meta">
+      Pipeline de procesamiento por lotes (SuiteScript Map/Reduce).
+    </p>
+    <p class="muted">Procesos masivos, búsquedas y operaciones sobre registros.</p>
+  </header>
+  {{ ui.metadata_block(doc.metadata) }}
+  {{ ui.summary_block(doc.summary) }}
+  {# ------------------------ getInputData ------------------------ #}
+  {% if doc.getInputData %}
+    <div class="section">
+      <h2>getInputData</h2>
+      {% if doc.getInputData.details %}
+        <p>{{ doc.getInputData.details }}</p>
+      {% endif %}
+      {% if doc.getInputData.filters %}
+        {{ ui.table_block("Filtros", doc.getInputData.filters, [
+          {"field": "field", "title": "Campo"},
+          {"field": "operator", "title": "Operador"},
+          {"field": "value", "title": "Valor"}
+        ]) }}
+      {% endif %}
+      {% if doc.getInputData.columns %}
+        {{ ui.table_block("Columnas", doc.getInputData.columns, [
+          {"field": "name", "title": "Nombre"},
+          {"field": "label", "title": "Etiqueta"}
+        ]) }}
+      {% endif %}
+    </div>
+  {% endif %}
+  {# ------------------------ map ------------------------ #}
+  {% if doc.map %}
+    <div class="section">
+      <h2>map</h2>
+      {% if doc.map.logic %}
+        <p>{{ doc.map.logic }}</p>
+      {% endif %}
+      {% if doc.map.fields_used %}
+        {{ ui.list_block("Campos utilizados", doc.map.fields_used) }}
+      {% endif %}
+      {% if doc.map.record_operations %}
+        {{ ui.table_block("Operaciones en registros (map)", doc.map.record_operations, [
+          {"field": "type", "title": "Operación"},
+          {"field": "recordType", "title": "Record"},
+          {"field": "fields", "title": "Campos"}
+        ]) }}
+      {% endif %}
+    </div>
+  {% endif %}
+  {# ------------------------ reduce ------------------------ #}
+  {% if doc.reduce %}
+    <div class="section">
+      <h2>reduce</h2>
+      {% if doc.reduce.logic %}
+        <p>{{ doc.reduce.logic }}</p>
+      {% endif %}
+      {% if doc.reduce.aggregations %}
+        {{ ui.list_block("Agregaciones", doc.reduce.aggregations) }}
+      {% endif %}
+      {% if doc.reduce.record_operations %}
+        {{ ui.table_block("Operaciones en registros (reduce)", doc.reduce.record_operations, [
+          {"field": "type", "title": "Operación"},
+          {"field": "recordType", "title": "Record"},
+          {"field": "fields", "title": "Campos"}
+        ]) }}
+      {% endif %}
+    </div>
+  {% endif %}
+  {# ------------------------ summarize ------------------------ #}
+  {% if doc.summarize %}
+    <div class="section">
+      <h2>summarize</h2>
+      {% if doc.summarize.usage %}
+        <p>{{ doc.summarize.usage }}</p>
+      {% endif %}
+      {% if doc.summarize.errors %}
+        {{ ui.list_block("Errores", doc.summarize.errors) }}
+      {% endif %}
+      {% if doc.summarize.final_actions %}
+        {{ ui.list_block("Acciones finales", doc.summarize.final_actions) }}
+      {% endif %}
+    </div>
+  {% endif %}
+  {# ------------------------ búsquedas globales ------------------------ #}
+  {% if doc.searches %}
+    {{ ui.table_block("Búsquedas utilizadas", doc.searches, [
+      {"field": "id", "title": "ID"},
+      {"field": "filters", "title": "Filtros"},
+      {"field": "columns", "title": "Columnas"}
     ]) }}
+  {% endif %}
+  {# ------------------------ operaciones globales con registros ------------------------ #}
+  {% if doc.records %}
+    {{ ui.table_block("Operaciones con registros", doc.records, [
       {"field": "type", "title": "Operación"},
       {"field": "recordType", "title": "Record"},
       {"field": "fields", "title": "Campos"}
     ]) }}
+  {% endif %}
+  {# ------------------------ side effects globales ------------------------ #}
+  {% if doc.side_effects %}
+    {{ ui.list_block("Side effects", doc.side_effects) }}
+  {% endif %}
+  {# ------------------------ errores globales ------------------------ #}
+  {% if doc.errors %}
+    {% if doc.errors is mapping %}
+      {{ ui.list_block("Errores", doc.errors.explicit_checks or []) }}
+      {{ ui.list_block("Manejo de excepciones", doc.errors.exception_handling or []) }}
+    {% else %}
+      {{ ui.table_block("Errores", doc.errors, [
+        {"field": "location", "title": "Ubicación"},
+        {"field": "description", "title": "Descripción"}
+      ]) }}
+    {% endif %}
+  {% endif %}
 {% endblock %}

app/templates/RESTlet.html.j2 CHANGED Viewed

@@ -2,61 +2,136 @@
 {% import "components.html.j2" as ui %}
 {% block content %}
-<h1>RESTlet · {{ doc.metadata.description or doc.metadata.script_type }}</h1>
-<p class="muted">Documentación técnica del servicio RESTlet.</p>
 {{ ui.metadata_block(doc.metadata) }}
 {{ ui.summary_block(doc.summary) }}
 {% set endpoints = doc.endpoints or {} %}
-{% if endpoints %}
   <div class="section">
     <h2>Endpoints</h2>
-    {% for method, definition in endpoints.items() if definition %}
       <h3>{{ method|upper }}</h3>
-      {% if definition.description %}<p>{{ definition.description }}</p>{% endif %}
       {% set inputs = definition.inputs or {} %}
-      {{ ui.table_block("URL params", inputs.url_params, [
-        {"field": "name", "title": "Nombre"},
-        {"field": "description", "title": "Descripción"},
-        {"field": "type", "title": "Tipo"}
-      ]) }}
-      {{ ui.table_block("Query string", inputs.query_string, [
-        {"field": "name", "title": "Nombre"},
-        {"field": "description", "title": "Descripción"},
-        {"field": "type", "title": "Tipo"}
-      ]) }}
-      {{ ui.table_block("Body", inputs.body_fields, [
-        {"field": "name", "title": "Nombre"},
-        {"field": "description", "title": "Descripción"},
-        {"field": "type", "title": "Tipo"}
-      ]) }}
-      {{ ui.logic_block("Lógica", definition.logic) }}
-      {{ ui.table_block("Operaciones sobre registros", definition.record_operations, [
-        {"field": "type", "title": "Operación"},
-        {"field": "recordType", "title": "Record"},
-        {"field": "details", "title": "Detalles"}
-      ]) }}
-      {{ ui.table_block("Búsquedas", definition.searches, [
-        {"field": "id", "title": "ID"},
-        {"field": "filters", "title": "Filtros"},
-        {"field": "columns", "title": "Columnas"}
-      ]) }}
-      {{ ui.logic_block("Salida", definition.output) }}
-      {{ ui.list_block("Validaciones", definition.validations) }}
-      {{ ui.list_block("Side effects", definition.side_effects) }}
     {% endfor %}
   </div>
 {% endif %}
-{{ ui.list_block("Validaciones globales", doc.validations) }}
-{{ ui.table_block("Errores", doc.errors, [
-  {"field": "location", "title": "Ubicación"},
-  {"field": "description", "title": "Descripción"},
-  {"field": "throws", "title": "Excepción"}
-]) }}
-{{ ui.list_block("Side effects globales", doc.side_effects) }}
 {% endblock %}

 {% import "components.html.j2" as ui %}
 {% block content %}
+<header class="doc-header">
+  <h1>RESTlet · {{ doc.metadata.description or doc.metadata.script_type }}</h1>
+  <p class="doc-header-meta">
+    SuiteScript {{ doc.metadata.suitescript_version or "N/D" }}
+  </p>
+  <p class="muted">Documentación técnica del servicio RESTlet.</p>
+</header>
 {{ ui.metadata_block(doc.metadata) }}
 {{ ui.summary_block(doc.summary) }}
+{# ============================================================
+   ENDPOINTS (GET, POST, PUT, DELETE...)
+   ============================================================ #}
 {% set endpoints = doc.endpoints or {} %}
+{% if endpoints and endpoints is mapping %}
   <div class="section">
     <h2>Endpoints</h2>
+    {% for method, definition in endpoints.items() %}
+      {# Saltar si la IA devolvió algo no válido #}
+      {% if not (definition and definition is mapping) %}
+        <h3>{{ method|upper }}</h3>
+        <p>No se pudo interpretar la definición de este endpoint.</p>
+        {% continue %}
+      {% endif %}
       <h3>{{ method|upper }}</h3>
+      {% if definition.description %}
+        <p>{{ definition.description }}</p>
+      {% endif %}
+      {# ---------------------- INPUTS ---------------------- #}
       {% set inputs = definition.inputs or {} %}
+      {% if inputs is mapping %}
+        {% if inputs.url_params %}
+          {{ ui.table_block("URL params", inputs.url_params, [
+            {"field": "name", "title": "Nombre"},
+            {"field": "description", "title": "Descripción"},
+            {"field": "type", "title": "Tipo"}
+          ]) }}
+        {% endif %}
+        {% if inputs.query_string %}
+          {{ ui.table_block("Query string", inputs.query_string, [
+            {"field": "name", "title": "Nombre"},
+            {"field": "description", "title": "Descripción"},
+            {"field": "type", "title": "Tipo"}
+          ]) }}
+        {% endif %}
+        {% if inputs.body_fields %}
+          {{ ui.table_block("Body", inputs.body_fields, [
+            {"field": "name", "title": "Nombre"},
+            {"field": "description", "title": "Descripción"},
+            {"field": "type", "title": "Tipo"}
+          ]) }}
+        {% endif %}
+      {% else %}
+        <p class="muted">Inputs no estructurados o no disponibles.</p>
+      {% endif %}
+      {# ---------------------- LÓGICA ---------------------- #}
+      {% if definition.logic %}
+        {{ ui.logic_block("Lógica", definition.logic) }}
+      {% endif %}
+      {# ---------------------- OPERACIONES ---------------------- #}
+      {% if definition.record_operations %}
+        {{ ui.table_block("Operaciones sobre registros", definition.record_operations, [
+          {"field": "type", "title": "Operación"},
+          {"field": "recordType", "title": "Record"},
+          {"field": "details", "title": "Detalles"}
+        ]) }}
+      {% endif %}
+      {% if definition.searches %}
+        {{ ui.table_block("Búsquedas", definition.searches, [
+          {"field": "id", "title": "ID"},
+          {"field": "filters", "title": "Filtros"},
+          {"field": "columns", "title": "Columnas"}
+        ]) }}
+      {% endif %}
+      {# ---------------------- OUTPUT ---------------------- #}
+      {% if definition.output %}
+        {{ ui.logic_block("Salida", definition.output) }}
+      {% endif %}
+      {# ---------------------- VALIDACIONES ---------------------- #}
+      {% if definition.validations %}
+        {{ ui.list_block("Validaciones", definition.validations) }}
+      {% endif %}
+      {# ---------------------- SIDE EFFECTS ---------------------- #}
+      {% if definition.side_effects %}
+        {{ ui.list_block("Side effects", definition.side_effects) }}
+      {% endif %}
     {% endfor %}
   </div>
 {% endif %}
+{# VALIDACIONES GLOBALES #}
+{% if doc.validations %}
+  {{ ui.list_block("Validaciones globales", doc.validations) }}
+{% endif %}
+{# ERRORES #}
+{% if doc.errors %}
+  {% if doc.errors is mapping %}
+    {{ ui.list_block("Errores detectados", doc.errors.explicit_checks or []) }}
+    {{ ui.list_block("Manejo de excepciones", doc.errors.exception_handling or []) }}
+  {% else %}
+    {{ ui.table_block("Errores", doc.errors, [
+      {"field": "location", "title": "Ubicación"},
+      {"field": "description", "title": "Descripción"},
+      {"field": "throws", "title": "Excepción"}
+    ]) }}
+  {% endif %}
+{% endif %}
+{# SIDE EFFECTS GLOBALES #}
+{% if doc.side_effects %}
+  {{ ui.list_block("Side effects globales", doc.side_effects) }}
+{% endif %}
 {% endblock %}

app/templates/ScheduledScript.html.j2 CHANGED Viewed

@@ -2,66 +2,137 @@
 {% import "components.html.j2" as ui %}
 {% block content %}
-<h1>Scheduled Script · {{ doc.metadata.description or doc.metadata.script_type }}</h1>
-<p class="muted">Procesos periódicos y lotes programados.</p>
 {{ ui.metadata_block(doc.metadata) }}
 {{ ui.summary_block(doc.summary) }}
 {% if doc.input_data %}
   <div class="section">
     <h2>Entrada</h2>
-    <p>{{ doc.input_data.details }}</p>
-    {{ ui.table_block("Parámetros", doc.input_data.parameters, [
-      {"field": "id", "title": "Parámetro"},
-      {"field": "description", "title": "Descripción"}
-    ]) }}
-    {{ ui.table_block("Filtros", doc.input_data.filters, [
-      {"field": "field", "title": "Campo"},
-      {"field": "operator", "title": "Operador"},
-      {"field": "value", "title": "Valor"}
-    ]) }}
-    {{ ui.table_block("Columnas", doc.input_data.columns, [
-      {"field": "name", "title": "Nombre"},
-      {"field": "label", "title": "Etiqueta"}
-    ]) }}
   </div>
 {% endif %}
 {% if doc.logic %}
   <div class="section">
     <h2>Lógica</h2>
-    <p>{{ doc.logic.steps }}</p>
-    {{ ui.list_block("Bucles", doc.logic.loops) }}
-    {{ ui.list_block("Condiciones", doc.logic.conditions) }}
   </div>
 {% endif %}
-{{ ui.table_block("Operaciones con registros", doc.record_operations, [
-  {"field": "type", "title": "Operación"},
-  {"field": "record", "title": "Record"},
-  {"field": "details", "title": "Detalles"}
-]) }}
-{{ ui.table_block("Búsquedas", doc.searches, [
-  {"field": "type", "title": "Tipo"},
-  {"field": "filters", "title": "Filtros"},
-  {"field": "columns", "title": "Columnas"}
-]) }}
 {% if doc.governance %}
   <div class="section">
     <h2>Governance</h2>
-    <p>Usage checks: {{ doc.governance.usage_checks }}</p>
-    <p>Yielding: {{ doc.governance.yielding }}</p>
-    <p>Task rescheduling: {{ doc.governance.task_rescheduling }}</p>
   </div>
 {% endif %}
-{{ ui.table_block("Errores", doc.errors, [
-  {"field": "scenario", "title": "Escenario"},
-  {"field": "handling", "title": "Manejo"}
-]) }}
-{{ ui.list_block("Side effects", doc.side_effects) }}
 {% endblock %}

 {% import "components.html.j2" as ui %}
 {% block content %}
+<header class="doc-header">
+  <h1>Scheduled Script · {{ doc.metadata.description or doc.metadata.script_type }}</h1>
+  <p class="doc-header-meta">
+    SuiteScript {{ doc.metadata.suitescript_version or "N/D" }}
+  </p>
+  <p class="muted">Procesos periódicos y lotes programados.</p>
+</header>
 {{ ui.metadata_block(doc.metadata) }}
 {{ ui.summary_block(doc.summary) }}
+{# ============================================================
+   INPUT DATA
+   ============================================================ #}
 {% if doc.input_data %}
   <div class="section">
     <h2>Entrada</h2>
+    {% if doc.input_data.details %}
+      <p>{{ doc.input_data.details }}</p>
+    {% endif %}
+    {% if doc.input_data.parameters %}
+      {{ ui.table_block("Parámetros", doc.input_data.parameters, [
+        {"field": "id", "title": "Parámetro"},
+        {"field": "description", "title": "Descripción"}
+      ]) }}
+    {% endif %}
+    {% if doc.input_data.filters %}
+      {{ ui.table_block("Filtros", doc.input_data.filters, [
+        {"field": "field", "title": "Campo"},
+        {"field": "operator", "title": "Operador"},
+        {"field": "value", "title": "Valor"}
+      ]) }}
+    {% endif %}
+    {% if doc.input_data.columns %}
+      {{ ui.table_block("Columnas", doc.input_data.columns, [
+        {"field": "name", "title": "Nombre"},
+        {"field": "label", "title": "Etiqueta"}
+      ]) }}
+    {% endif %}
   </div>
 {% endif %}
+{# ============================================================
+   LÓGICA
+   ============================================================ #}
 {% if doc.logic %}
   <div class="section">
     <h2>Lógica</h2>
+    {% if doc.logic.steps %}
+      <p>{{ doc.logic.steps }}</p>
+    {% endif %}
+    {% if doc.logic.loops %}
+      {{ ui.list_block("Bucles", doc.logic.loops) }}
+    {% endif %}
+    {% if doc.logic.conditions %}
+      {{ ui.list_block("Condiciones", doc.logic.conditions) }}
+    {% endif %}
   </div>
 {% endif %}
+{# ============================================================
+   OPERACIONES CON REGISTROS
+   ============================================================ #}
+{% if doc.record_operations %}
+  {{ ui.table_block("Operaciones con registros", doc.record_operations, [
+    {"field": "type", "title": "Operación"},
+    {"field": "record", "title": "Record"},
+    {"field": "details", "title": "Detalles"}
+  ]) }}
+{% endif %}
+{# ============================================================
+   BÚSQUEDAS
+   ============================================================ #}
+{% if doc.searches %}
+  {{ ui.table_block("Búsquedas", doc.searches, [
+    {"field": "type", "title": "Tipo"},
+    {"field": "filters", "title": "Filtros"},
+    {"field": "columns", "title": "Columnas"}
+  ]) }}
+{% endif %}
+{# ============================================================
+   GOVERNANCE
+   ============================================================ #}
 {% if doc.governance %}
   <div class="section">
     <h2>Governance</h2>
+    {% if doc.governance.usage_checks %}
+      <p><strong>Usage checks:</strong> {{ doc.governance.usage_checks }}</p>
+    {% endif %}
+    {% if doc.governance.yielding %}
+      <p><strong>Yielding:</strong> {{ doc.governance.yielding }}</p>
+    {% endif %}
+    {% if doc.governance.task_rescheduling %}
+      <p><strong>Task rescheduling:</strong> {{ doc.governance.task_rescheduling }}</p>
+    {% endif %}
   </div>
 {% endif %}
+{# ============================================================
+   ERRORES
+   ============================================================ #}
+{% if doc.errors %}
+  {% if doc.errors is mapping %}
+    {{ ui.list_block("Escenarios de error", doc.errors.scenarios or []) }}
+    {{ ui.list_block("Manejo", doc.errors.handling or []) }}
+  {% else %}
+    {{ ui.table_block("Errores", doc.errors, [
+      {"field": "scenario", "title": "Escenario"},
+      {"field": "handling", "title": "Manejo"}
+    ]) }}
+  {% endif %}
+{% endif %}
+{# ============================================================
+   SIDE EFFECTS
+   ============================================================ #}
+{% if doc.side_effects %}
+  {{ ui.list_block("Side effects", doc.side_effects) }}
+{% endif %}
 {% endblock %}

app/templates/UserEventScript.html.j2 CHANGED Viewed

@@ -2,37 +2,84 @@
 {% import "components.html.j2" as ui %}
 {% block content %}
-<h1>User Event · {{ doc.metadata.description or doc.metadata.script_type }}</h1>
-<p class="muted">Eventos server-side sobre records.</p>
 {{ ui.metadata_block(doc.metadata) }}
 {{ ui.summary_block(doc.summary) }}
 {% if doc.events %}
   <div class="section">
     <h2>Eventos implementados</h2>
-    {% for name, description in doc.events.items() if description %}
-      <h3>{{ name }}</h3>
-      <p>{{ description }}</p>
-    {% endfor %}
   </div>
 {% endif %}
-{{ ui.list_block("Validaciones", doc.validations) }}
-{{ ui.table_block("Búsquedas", doc.searches, [
-  {"field": "type", "title": "Tipo"},
-  {"field": "filters", "title": "Filtros"},
-  {"field": "columns", "title": "Columnas"}
-]) }}
-{{ ui.table_block("Operaciones en registros", doc.record_operations, [
-  {"field": "type", "title": "Operación"},
-  {"field": "record", "title": "Record"},
-  {"field": "details", "title": "Detalles"}
-]) }}
-{{ ui.list_block("Side effects", doc.side_effects) }}
-{{ ui.table_block("Errores", doc.errors, [
-  {"field": "location", "title": "Ubicación"},
-  {"field": "description", "title": "Descripción"}
-]) }}
 {% endblock %}

 {% import "components.html.j2" as ui %}
 {% block content %}
+<header class="doc-header">
+  <h1>User Event · {{ doc.metadata.description or doc.metadata.script_type }}</h1>
+  <p class="doc-header-meta">
+    SuiteScript {{ doc.metadata.suitescript_version or "N/D" }}
+  </p>
+  <p class="muted">Eventos server-side sobre records.</p>
+</header>
 {{ ui.metadata_block(doc.metadata) }}
 {{ ui.summary_block(doc.summary) }}
+{# ============================================================
+   EVENTOS IMPLEMENTADOS
+   ============================================================ #}
 {% if doc.events %}
   <div class="section">
     <h2>Eventos implementados</h2>
+    {% if doc.events is mapping %}
+      {% for name, description in doc.events.items() if description %}
+        <h3>{{ name }}</h3>
+        <p>{{ description }}</p>
+      {% endfor %}
+    {% else %}
+      <p>{{ doc.events }}</p>
+    {% endif %}
   </div>
 {% endif %}
+{# ============================================================
+   VALIDACIONES
+   ============================================================ #}
+{% if doc.validations %}
+  {{ ui.list_block("Validaciones", doc.validations) }}
+{% endif %}
+{# ============================================================
+   BÚSQUEDAS
+   ============================================================ #}
+{% if doc.searches %}
+  {{ ui.table_block("Búsquedas", doc.searches, [
+    {"field": "type", "title": "Tipo"},
+    {"field": "filters", "title": "Filtros"},
+    {"field": "columns", "title": "Columnas"}
+  ]) }}
+{% endif %}
+{# ============================================================
+   OPERACIONES EN REGISTROS
+   ============================================================ #}
+{% if doc.record_operations %}
+  {{ ui.table_block("Operaciones en registros", doc.record_operations, [
+    {"field": "type", "title": "Operación"},
+    {"field": "record", "title": "Record"},
+    {"field": "details", "title": "Detalles"}
+  ]) }}
+{% endif %}
+{# ============================================================
+   SIDE EFFECTS
+   ============================================================ #}
+{% if doc.side_effects %}
+  {{ ui.list_block("Side effects", doc.side_effects) }}
+{% endif %}
+{# ============================================================
+   ERRORES
+   ============================================================ #}
+{% if doc.errors %}
+  {% if doc.errors is mapping %}
+    {{ ui.list_block("Errores detectados", doc.errors.explicit_checks or []) }}
+    {{ ui.list_block("Manejo de excepciones", doc.errors.exception_handling or []) }}
+  {% else %}
+    {{ ui.table_block("Errores", doc.errors, [
+      {"field": "location", "title": "Ubicación"},
+      {"field": "description", "title": "Descripción"}
+    ]) }}
+  {% endif %}
+{% endif %}
 {% endblock %}

app/templates/components.html.j2 CHANGED Viewed

@@ -50,6 +50,7 @@
   {% endif %}
 {%- endmacro %}
 {% macro table_block(title, rows, columns) -%}
   {% if rows %}
     <div class="section">
@@ -64,16 +65,26 @@
         </thead>
         <tbody>
           {% for row in rows %}
-            <tr>
-              {% for column in columns %}
-                {% set value = row.get(column.field) %}
-                {% if value is sequence and value is not string %}
-                  <td>{{ value|join(", ") }}</td>
-                {% else %}
-                  <td>{{ value or "" }}</td>
-                {% endif %}
-              {% endfor %}
-            </tr>
           {% endfor %}
         </tbody>
       </table>

   {% endif %}
 {%- endmacro %}
+{# --------- AQUÍ ESTÁ EL CAMBIO IMPORTANTE --------- #}
 {% macro table_block(title, rows, columns) -%}
   {% if rows %}
     <div class="section">
         </thead>
         <tbody>
           {% for row in rows %}
+            {# Si row es un dict: comportamiento normal #}
+            {% if row is mapping %}
+              <tr>
+                {% for column in columns %}
+                  {% set value = row.get(column.field) %}
+                  {% if value is sequence and value is not string %}
+                    <td>{{ value|join(", ") }}</td>
+                  {% else %}
+                    <td>{{ value or "" }}</td>
+                  {% endif %}
+                {% endfor %}
+              </tr>
+            {% else %}
+              {# Fallback: fila no estructurada (string, número, etc.) #}
+              <tr>
+                <td colspan="{{ columns|length }}">
+                  {{ row }}
+                </td>
+              </tr>
+            {% endif %}
           {% endfor %}
         </tbody>
       </table>