nexabase-report 0.28.48 → 0.28.49

package/NEXAREPORT.md

@@ -1,4 +1,4 @@
-<!-- nexabase-report@0.28.48 — generado por scripts/gen-ai-context.mjs, no editar a mano -->
+<!-- nexabase-report@0.28.49 — generado por scripts/gen-ai-context.mjs, no editar a mano -->
 # NexaReport — referencia para agentes de IA
 
 > Este archivo se genera desde los tipos TypeScript reales del paquete (`src/lib/types/report.ts`
@@ -281,10 +281,10 @@ El schema formal completo (todas las interfaces, no solo bandas/elementos) está
 `nexabase-report/schema`, así que es accesible sin instalar nada vía:
 
 ```
-https://unpkg.com/nexabase-report@0.28.48/schema/nexareport.schema.json
+https://unpkg.com/nexabase-report@0.28.49/schema/nexareport.schema.json
 ```
 
-(cambia `@0.28.48` por `@latest` para la versión más reciente). Valida el JSON generado
+(cambia `@0.28.49` por `@latest` para la versión más reciente). Valida el JSON generado
 contra ese schema antes de darlo por bueno — evita que un campo inventado llegue al usuario.
 
 Más ejemplos reales (subreportes, crosstab, master-detail, códigos de barras) en `examples/*.json`

package/dist/{generated-BIdKRDqj.js → generated-BJ_UpWRr.js}

@@ -883,6 +883,75 @@ desde el código. Nunca vas a recibir un JSON con un campo que ya no existe, o l
 <p>Pega el JSON resultante en el diseñador (<strong>Importar JSON</strong>) para revisarlo visualmente y ajustar
 posiciones, colores o binding fino — la IA arma la estructura, el diseñador es donde lo dejas
 exacto.</p>
+`
+  },
+  {
+    id: "integracion-cdn",
+    title: "Publicar el visor en tu web (CDN)",
+    search: `cdn, jsdelivr, unpkg, embeber, integrar, cache, navegador, produccion, actualizar, script publicar el visor en tu web (cdn) si vas a mostrar <nexa viewer en un sitio externo sin pasar por un bundler, la forma más rápida es cargarlo desde un cdn público. hay una trampa con la que se han topado varios clientes: cargarlo mal hace que dejen de ver las correcciones que publicas. el problema: el navegador cachea la copia vieja un <script apuntando siempre a la misma url —sin número de versión— se cachea en el navegador de cada visitante hasta por 7 días . publicás un fix, el cdn ya lo tiene, pero el navegador del cliente sigue sirviendo su copia local vieja hasta que expire el caché o el usuario haga un refresco forzado (ctrl+shift+r). desde el diseñador no hay forma de "empujar" esa actualización: es una limitación del navegador, no de nexareport. html <! ❌ el navegador puede quedarse con esta copia hasta 7 días <script src="https://cdn.jsdelivr.net/npm/nexabase report/dist/nexabase report.umd.js" <\/script la solución: resolver la versión antes de cargar en vez de apuntar a la url sin versión, resolvé la última versión publicada (jsdelivr cachea esa consulta solo 10 segundos) y cargá el archivo desde la url versionada resultante. cada release usa una url distinta, así que el navegador no tiene forma de servir una copia vieja aunque quiera. html <nexa viewer id="viewer" minimal </nexa viewer <script fetch('https://data.jsdelivr.com/v1/packages/npm/nexabase report/resolved?specifier=latest') .then(r = r.json()) .then(({ version }) = { const css = document.createelement('link'); css.rel = 'stylesheet'; css.href = https://cdn.jsdelivr.net/npm/nexabase report@\${version}/dist/style.css ; const cssready = new promise(resolve = { css.onload = resolve; css.onerror = resolve; }); document.head.appendchild(css); const js = document.createelement('script'); js.src = https://cdn.jsdelivr.net/npm/nexabase report@\${version}/dist/nexabase report.umd.js ; const jsready = new promise(resolve = { js.onload = resolve; }); document.head.appendchild(js); // esperar los dos recursos, no solo el js: si el visor arranca a medir alturas de // página antes de que el css esté aplicado, la paginación sale mal (páginas de // menos, scroll roto) sin que salte ningún error en consola. promise.all([cssready, jsready]).then(() = { nexareport.registernexareport(); const viewer = document.getelementbyid('viewer'); viewer.definition = { / json del reporte / }; viewer.data = [ / datos / ]; }); }); <\/script no hace falta fijar el número de versión a mano ni editar nada en cada release: la resolución siempre trae la última publicada, y el navegador solo se ve obligado a bajarla de nuevo cuando efectivamente cambió. importante: esperá siempre los dos recursos (css y js) antes de inicializar el visor. si solo esperás el <script y dejás que el <link cargue en paralelo sin que nadie lo espere, en redes donde el css tarda más que el js (por ejemplo, el js ya en caché de una visita anterior y el css no) el visor puede arrancar a medir alturas de página antes de que el estilo esté aplicado — un candidato plausible para un reporte que de repente muestra una sola página sin ningún error en consola. si ya integraste con la url sin versión cambiar tu propio código al patrón de arriba resuelve el problema hacia adelante. para los usuarios que ya cargaron la versión vieja antes del cambio, no hay forma de purgar su caché de forma remota: necesitan un refresco forzado una única vez.`,
+    element: "",
+    html: `<h1>Publicar el visor en tu web (CDN)</h1>
+<p>Si vas a mostrar <code>&lt;nexa-viewer&gt;</code> en un sitio externo sin pasar por un bundler, la forma más rápida
+es cargarlo desde un CDN público. Hay una trampa con la que se han topado varios clientes: cargarlo
+mal hace que dejen de ver las correcciones que publicas.</p>
+<h2>El problema: el navegador cachea la copia vieja</h2>
+<p>Un <code>&lt;script&gt;</code> apuntando siempre a la misma URL —sin número de versión— se cachea en el navegador de
+cada visitante hasta por <strong>7 días</strong>. Publicás un fix, el CDN ya lo tiene, pero el navegador del
+cliente sigue sirviendo su copia local vieja hasta que expire el caché o el usuario haga un refresco
+forzado (Ctrl+Shift+R). Desde el diseñador no hay forma de &quot;empujar&quot; esa actualización: es una
+limitación del navegador, no de NexaReport.</p>
+<pre><code class="language-html">&lt;!-- ❌ El navegador puede quedarse con esta copia hasta 7 días --&gt;
+&lt;script src=&quot;https://cdn.jsdelivr.net/npm/nexabase-report/dist/nexabase-report.umd.js&quot;&gt;&lt;/script&gt;
+</code></pre>
+<h2>La solución: resolver la versión antes de cargar</h2>
+<p>En vez de apuntar a la URL sin versión, resolvé la última versión publicada (jsDelivr cachea esa
+consulta solo 10 segundos) y cargá el archivo desde la URL versionada resultante. Cada release usa
+una URL distinta, así que el navegador no tiene forma de servir una copia vieja aunque quiera.</p>
+<pre><code class="language-html">&lt;nexa-viewer id=&quot;viewer&quot; minimal&gt;&lt;/nexa-viewer&gt;
+
+&lt;script&gt;
+  fetch(&#39;https://data.jsdelivr.com/v1/packages/npm/nexabase-report/resolved?specifier=latest&#39;)
+    .then(r =&gt; r.json())
+    .then(({ version }) =&gt; {
+      const css = document.createElement(&#39;link&#39;);
+      css.rel = &#39;stylesheet&#39;;
+      css.href = \`https://cdn.jsdelivr.net/npm/nexabase-report@\${version}/dist/style.css\`;
+      const cssReady = new Promise(resolve =&gt; { css.onload = resolve; css.onerror = resolve; });
+      document.head.appendChild(css);
+
+      const js = document.createElement(&#39;script&#39;);
+      js.src = \`https://cdn.jsdelivr.net/npm/nexabase-report@\${version}/dist/nexabase-report.umd.js\`;
+      const jsReady = new Promise(resolve =&gt; { js.onload = resolve; });
+      document.head.appendChild(js);
+
+      // Esperar los DOS recursos, no solo el JS: si el visor arranca a medir alturas de
+      // página antes de que el CSS esté aplicado, la paginación sale mal (páginas de
+      // menos, scroll roto) sin que salte ningún error en consola.
+      Promise.all([cssReady, jsReady]).then(() =&gt; {
+        NexaReport.registerNexaReport();
+
+        const viewer = document.getElementById(&#39;viewer&#39;);
+        viewer.definition = { /* JSON del reporte */ };
+        viewer.data = [ /* datos */ ];
+      });
+    });
+&lt;/script&gt;
+</code></pre>
+<p>No hace falta fijar el número de versión a mano ni editar nada en cada release: la resolución
+siempre trae la última publicada, y el navegador solo se ve obligado a bajarla de nuevo cuando
+efectivamente cambió.</p>
+<blockquote>
+<p><strong>Importante:</strong> esperá siempre los dos recursos (CSS y JS) antes de inicializar el visor. Si
+solo esperás el <code>&lt;script&gt;</code> y dejás que el <code>&lt;link&gt;</code> cargue en paralelo sin que nadie lo espere,
+en redes donde el CSS tarda más que el JS (por ejemplo, el JS ya en caché de una visita anterior
+y el CSS no) el visor puede arrancar a medir alturas de página antes de que el estilo esté
+aplicado — un candidato plausible para un reporte que de repente muestra una sola página sin
+ningún error en consola.</p>
+</blockquote>
+<h2>Si ya integraste con la URL sin versión</h2>
+<p>Cambiar tu propio código al patrón de arriba resuelve el problema hacia adelante. Para los usuarios
+que ya cargaron la versión vieja antes del cambio, no hay forma de purgar su caché de forma remota:
+necesitan un refresco forzado una única vez.</p>
 `
   }
 ];

package/dist/{html2pdf-C93-nWaW.js → html2pdf-CN5Bea9j.js}

@@ -1,5 +1,5 @@
-import { g as Nl, c as ut, d as Vl } from "./index-BExMmJUt.js";
-import { j as Xl } from "./jspdf.es.min-miF7naN5.js";
+import { g as Nl, c as ut, d as Vl } from "./index-CNxyint1.js";
+import { j as Xl } from "./jspdf.es.min-Cvx4ls2L.js";
 function Jl(Pe, br) {
   for (var fe = 0; fe < br.length; fe++) {
     const HA = br[fe];