nexabase-report 0.28.1 → 0.28.3

package/NEXAREPORT.md

@@ -1,4 +1,4 @@
-<!-- nexabase-report@0.28.1 — generado por scripts/gen-ai-context.mjs, no editar a mano -->
+<!-- nexabase-report@0.28.3 — 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.1/schema/nexareport.schema.json
+https://unpkg.com/nexabase-report@0.28.3/schema/nexareport.schema.json
 ```
 
-(cambia `@0.28.1` por `@latest` para la versión más reciente). Valida el JSON generado
+(cambia `@0.28.3` 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/README.md

@@ -241,6 +241,29 @@ Reports use a banded structure:
 
 `Text`, `Image`, `Barcode`, `QRCode`, `Rectangle`, `Ellipse`, `Line`, `Arrow`, `Table`, `Chart`, `Crosstab`, `SubReport`, `DrillDown`
 
+## AI-Assisted Report Generation
+
+Let your AI coding assistant (Claude Code, Gemini CLI, OpenCode, Cursor...) build report JSON for
+you — one command, run once per project:
+
+```bash
+npx nexabase-report-ai
+```
+
+This detects your project's AI instructions file (`CLAUDE.md`, `AGENTS.md`, `GEMINI.md`,
+`.cursorrules`) — or creates `AGENTS.md` if none exists — and adds a pointer to the always-current
+report reference and JSON Schema (served straight from the published package, so it's never
+stale):
+
+- `https://unpkg.com/nexabase-report@latest/NEXAREPORT.md` — band/element types, binding syntax,
+  worked examples
+- `https://unpkg.com/nexabase-report@latest/schema/nexareport.schema.json` — the formal schema, to
+  validate generated JSON before trusting it
+
+From then on, any assistant that reads your project's instructions file already knows the current
+report format — no manual copy-pasting, and it can't drift out of date since both files are
+regenerated from the real TypeScript types on every published version.
+
 ## Expression Engine
 
 Safe evaluation without `eval`. Supports:

package/bin/nexabase-report-ai.mjs

@@ -0,0 +1,47 @@
+#!/usr/bin/env node
+// npx nexabase-report-ai  ->  agrega, UNA vez, el puntero a NEXAREPORT.md/schema en el archivo
+// de instrucciones de IA que ya tenga el proyecto (CLAUDE.md/AGENTS.md/GEMINI.md/.cursorrules).
+// Idempotente: si ya está, no duplica nada.
+import { readFile, writeFile, appendFile } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+
+const cwd = process.cwd();
+const MARKER = '<!-- nexabase-report:ai-context -->';
+
+const BLOCK = `
+${MARKER}
+## NexaReport
+
+Antes de crear o modificar un reporte de NexaReport (JSON \`NexaReportDefinition\`), lee
+https://unpkg.com/nexabase-report@latest/NEXAREPORT.md y valida el JSON generado contra
+https://unpkg.com/nexabase-report@latest/schema/nexareport.schema.json antes de entregarlo.
+`;
+
+const candidates = ['CLAUDE.md', 'AGENTS.md', 'GEMINI.md', '.cursorrules'];
+const found = candidates.filter(f => existsSync(join(cwd, f)));
+
+async function addTo(file) {
+  const path = join(cwd, file);
+  const current = existsSync(path) ? await readFile(path, 'utf-8') : '';
+  if (current.includes(MARKER)) {
+    console.log(`  = ${file} ya tiene la sección de NexaReport, sin cambios`);
+    return;
+  }
+  if (current) {
+    await appendFile(path, '\n' + BLOCK);
+  } else {
+    await writeFile(path, BLOCK.trimStart() + '\n');
+  }
+  console.log(`  + ${file} actualizado`);
+}
+
+if (found.length > 0) {
+  for (const f of found) await addTo(f);
+} else {
+  // Ningún archivo de instrucciones detectado: crea AGENTS.md, la convención más genérica
+  // (la leen Claude Code, Gemini CLI, OpenCode, Cursor y otros).
+  await addTo('AGENTS.md');
+}
+
+console.log('\nListo. Cualquier IA que lea ese archivo ya sabe consultar el formato actual de NexaReport.');

package/dist/{generated-BjsMhDVX.js → generated-BnErILTW.js}

@@ -859,6 +859,36 @@ promedio…). No dependen de la banda en la que estén, porque no hay bandas.</l
 <p>Los formatos pensados para documentos —Word, PPTX— y los de datos —Excel, CSV— están orientados a
 reportes paginados. Si necesitas repartir cifras periódicamente por correo o en un archivo, el
 formato adecuado es un <strong>reporte</strong>, no un dashboard.</p>
+`
+  },
+  {
+    id: "ia-generacion",
+    title: "Generar reportes con IA",
+    search: "ia, ai, claude, gemini, copilot, cursor, prompt, generar, automatizar, npx generar reportes con ia si integras nexareport en tu app, no necesitas armar el json del reporte a mano ni empezar desde cero en el diseñador: un asistente de ia puede generarlo por ti. configuración (un comando, una sola vez) desde la carpeta de tu proyecto: npx nexabase report ai ese comando detecta el archivo de instrucciones que tu asistente ya lee solo ( claude.md , agents.md , gemini.md , .cursorrules ) —o crea agents.md si no encuentra ninguno— y le agrega el puntero al formato actual de nexareport. no hay nada que copiar ni pegar a mano, y si lo corres de nuevo no duplica nada. de ahí en adelante, cualquier desarrollador del equipo , en cualquier sesión , con cualquier reporte que pida, la ia ya sabe consultar sola el formato actual — sin volver a tocar nada. por qué siempre está al día el comando apunta a nexabase report@latest en npm, no a una copia local: el documento de referencia y el schema formal se regeneran automáticamente en cada versión publicada, directo desde el código. nunca vas a recibir un json con un campo que ya no existe, o le falte uno nuevo (como staticpage , para reportes de páginas fijas). después de generarlo pega el json resultante en el diseñador ( importar json ) para revisarlo visualmente y ajustar posiciones, colores o binding fino — la ia arma la estructura, el diseñador es donde lo dejas exacto.",
+    element: "",
+    html: `<h1>Generar reportes con IA</h1>
+<p>Si integras NexaReport en tu app, no necesitas armar el JSON del reporte a mano ni empezar desde
+cero en el diseñador: un asistente de IA puede generarlo por ti.</p>
+<h2>Configuración (un comando, una sola vez)</h2>
+<p>Desde la carpeta de tu proyecto:</p>
+<pre><code>npx nexabase-report-ai
+</code></pre>
+<p>Ese comando detecta el archivo de instrucciones que tu asistente ya lee solo (<code>CLAUDE.md</code>,
+<code>AGENTS.md</code>, <code>GEMINI.md</code>, <code>.cursorrules</code>) —o crea <code>AGENTS.md</code> si no encuentra ninguno— y le agrega
+el puntero al formato actual de NexaReport. No hay nada que copiar ni pegar a mano, y si lo
+corres de nuevo no duplica nada.</p>
+<p>De ahí en adelante, <strong>cualquier desarrollador del equipo</strong>, en <strong>cualquier sesión</strong>, con
+<strong>cualquier reporte</strong> que pida, la IA ya sabe consultar sola el formato actual — sin volver a
+tocar nada.</p>
+<h2>Por qué siempre está al día</h2>
+<p>El comando apunta a <code>nexabase-report@latest</code> en npm, no a una copia local: el documento de
+referencia y el schema formal se regeneran automáticamente en cada versión publicada, directo
+desde el código. Nunca vas a recibir un JSON con un campo que ya no existe, o le falte uno nuevo
+(como <code>StaticPage</code>, para reportes de páginas fijas).</p>
+<h2>Después de generarlo</h2>
+<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>
 `
   }
 ];

package/dist/{html2pdf-B3mAxkNT.js → html2pdf-jHo6I3W3.js}

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

package/dist/{index-n-ggfS1p.js → index-Dc1HlUG3.js}

@@ -93562,7 +93562,7 @@ function RWe(t) {
     let A = null, p = null;
     try {
       await new Promise((H) => setTimeout(H, 50)), typeof document < "u" && ((g = document.fonts) != null && g.ready) && await document.fonts.ready, A = await L5(t.reportPaperRef.value, t.apiBaseUrl), p = await H5(t.reportPaperRef.value);
-      const { default: y } = await import("./html2pdf-B3mAxkNT.js").then((H) => H.h), E = t.reportDef.value, B = E.layout.page, x = (((v = E.metadata) == null ? void 0 : v.name) || "reporte") + ".pdf", I = t.reportPaperRef.value.querySelector(".report-page"), S = (I == null ? void 0 : I.offsetWidth) || t.reportPaperRef.value.offsetWidth || void 0, M = (I == null ? void 0 : I.offsetHeight) || void 0, C = Math.min(3, Math.max(2, (typeof window < "u" ? window.devicePixelRatio : 2) || 2)), Q = (I == null ? void 0 : I.offsetWidth) || 794, T = (I == null ? void 0 : I.offsetHeight) || 1123, F = Math.max(1, t.pagination.value.totalPages), U = await y().set({
+      const { default: y } = await import("./html2pdf-jHo6I3W3.js").then((H) => H.h), E = t.reportDef.value, B = E.layout.page, x = (((v = E.metadata) == null ? void 0 : v.name) || "reporte") + ".pdf", I = t.reportPaperRef.value.querySelector(".report-page"), S = (I == null ? void 0 : I.offsetWidth) || t.reportPaperRef.value.offsetWidth || void 0, M = (I == null ? void 0 : I.offsetHeight) || void 0, C = Math.min(3, Math.max(2, (typeof window < "u" ? window.devicePixelRatio : 2) || 2)), Q = (I == null ? void 0 : I.offsetWidth) || 794, T = (I == null ? void 0 : I.offsetHeight) || 1123, F = Math.max(1, t.pagination.value.totalPages), U = await y().set({
         filename: x,
         margin: 0,
         image: { type: "jpeg", quality: 0.98 },
@@ -93593,7 +93593,7 @@ function RWe(t) {
   }
   async function a() {
     var G;
-    const h = t.reportDef.value, { jsPDF: A } = await import("./jspdf.es.min-C6M8fb8R.js").then((k) => k.j), p = h.layout.page, g = p.orientation === "landscape";
+    const h = t.reportDef.value, { jsPDF: A } = await import("./jspdf.es.min-Ce1kkozr.js").then((k) => k.j), p = h.layout.page, g = p.orientation === "landscape";
     let v = 210, m = 297;
     if (p.format === "Letter" ? (v = 215.9, m = 279.4) : p.format === "Ticket" && (v = 80, m = 200), g) {
       const k = v;
@@ -93950,7 +93950,7 @@ function RWe(t) {
       t.isExportingPdf.value = !0;
       try {
         await new Promise((U) => setTimeout(U, 50)), typeof document < "u" && ((A = document.fonts) != null && A.ready) && await document.fonts.ready;
-        const v = await L5(t.reportPaperRef.value, t.apiBaseUrl), m = await H5(t.reportPaperRef.value), { default: y } = await import("./html2pdf-B3mAxkNT.js").then((U) => U.h), B = t.reportDef.value.layout.page, x = t.reportPaperRef.value.querySelector(".report-page"), I = (x == null ? void 0 : x.offsetWidth) || t.reportPaperRef.value.offsetWidth || void 0, S = (x == null ? void 0 : x.offsetHeight) || void 0, M = Math.min(3, Math.max(2, (typeof window < "u" ? window.devicePixelRatio : 2) || 2)), C = (x == null ? void 0 : x.offsetWidth) || 794, Q = (x == null ? void 0 : x.offsetHeight) || 1123, T = Math.max(1, t.pagination.value.totalPages), b = await y().set({
+        const v = await L5(t.reportPaperRef.value, t.apiBaseUrl), m = await H5(t.reportPaperRef.value), { default: y } = await import("./html2pdf-jHo6I3W3.js").then((U) => U.h), B = t.reportDef.value.layout.page, x = t.reportPaperRef.value.querySelector(".report-page"), I = (x == null ? void 0 : x.offsetWidth) || t.reportPaperRef.value.offsetWidth || void 0, S = (x == null ? void 0 : x.offsetHeight) || void 0, M = Math.min(3, Math.max(2, (typeof window < "u" ? window.devicePixelRatio : 2) || 2)), C = (x == null ? void 0 : x.offsetWidth) || 794, Q = (x == null ? void 0 : x.offsetHeight) || 1123, T = Math.max(1, t.pagination.value.totalPages), b = await y().set({
           filename: "report.pdf",
           margin: 0,
           image: { type: "jpeg", quality: 0.98 },
@@ -94134,7 +94134,7 @@ ${E.outerHTML}
       t.isExportingPdf.value = !0;
       try {
         await new Promise((T) => setTimeout(T, 50)), typeof document < "u" && ((g = document.fonts) != null && g.ready) && await document.fonts.ready;
-        const m = await L5(A, t.apiBaseUrl), y = await H5(A), { default: E } = await import("./html2pdf-B3mAxkNT.js").then((T) => T.h), { default: B } = await import("./pptxgen.es-KpBnHDuC.js"), x = Array.from(A.querySelectorAll(".report-page"));
+        const m = await L5(A, t.apiBaseUrl), y = await H5(A), { default: E } = await import("./html2pdf-jHo6I3W3.js").then((T) => T.h), { default: B } = await import("./pptxgen.es-DRuTW2iV.js"), x = Array.from(A.querySelectorAll(".report-page"));
         if (x.length === 0) {
           Si("PPTX export — no rendered pages were found", null);
           return;
@@ -94484,7 +94484,7 @@ const UWe = {
       }
       return !!de;
     }
-    const o = it(() => a(n.minimal)), s = it(() => a(n.fluid)), l = it(() => !o.value || a(n.showThumbs)), c = it(() => !o.value || a(n.showToolbar)), u = We(!1), f = it(() => "0.28.1"), d = it(() => "2026-08-28T02:37:13.553Z"), h = it(() => A.value), A = We(n.locale || "es"), p = We(!a(n.minimal)), g = We("pages"), v = We(""), m = We(!1), y = it(() => {
+    const o = it(() => a(n.minimal)), s = it(() => a(n.fluid)), l = it(() => !o.value || a(n.showThumbs)), c = it(() => !o.value || a(n.showToolbar)), u = We(!1), f = it(() => "0.28.3"), d = it(() => "2026-08-28T03:08:50.080Z"), h = it(() => A.value), A = We(n.locale || "es"), p = We(!a(n.minimal)), g = We("pages"), v = We(""), m = We(!1), y = it(() => {
       const de = v.value.toLowerCase().trim();
       return de ? ge.value.filter((ve) => ve.title.toLowerCase().includes(de)) : ge.value;
     });
@@ -94546,7 +94546,7 @@ const UWe = {
     let Ae = null;
     async function Qe() {
       if (Ae) return Ae;
-      const de = await import("./html2pdf-B3mAxkNT.js").then((ve) => ve.h);
+      const de = await import("./html2pdf-jHo6I3W3.js").then((ve) => ve.h);
       return Ae = (de == null ? void 0 : de.default) || de, Ae;
     }
     async function _e(de) {
@@ -111973,7 +111973,7 @@ const nit = { class: "nd-help-panel" }, iit = { class: "nd-help-head" }, ait = {
       if (!(i.value.length || a.value)) {
         a.value = !0;
         try {
-          const h = await import("./generated-BjsMhDVX.js");
+          const h = await import("./generated-BnErILTW.js");
           i.value = h.helpTopics, o.value || c(r.contextElement);
         } finally {
           a.value = !1;
@@ -126144,7 +126144,7 @@ const upt = { class: "nd-rt-toolbar" }, dpt = ["title"], fpt = ["title"], hpt =
     function Ah(ne, _) {
       fl(ne, _, W, V);
     }
-    const gu = We(!1), po = We(!1), k0 = We(!1), Zn = We("home"), Ua = We(null), go = We(""), vu = it(() => "0.28.1"), vo = it(() => "2026-08-28T02:37:13.553Z"), mu = it(() => ({
+    const gu = We(!1), po = We(!1), k0 = We(!1), Zn = We("home"), Ua = We(null), go = We(""), vu = it(() => "0.28.3"), vo = it(() => "2026-08-28T03:08:50.080Z"), mu = it(() => ({
       home: d("tab_file"),
       new: d("new"),
       open: d("open"),

package/dist/{index.es-5IFpweNE.js → index.es-CKZ1d9_J.js}

@@ -1,5 +1,5 @@
-import { c as Va, d as il } from "./index-n-ggfS1p.js";
-import { _ as La } from "./jspdf.es.min-C6M8fb8R.js";
+import { c as Va, d as il } from "./index-Dc1HlUG3.js";
+import { _ as La } from "./jspdf.es.min-Ce1kkozr.js";
 var fn = {}, cn = {}, cr, vn;
 function Q() {
   if (vn) return cr;

package/dist/{jspdf.es.min-C6M8fb8R.js → jspdf.es.min-Ce1kkozr.js}

@@ -7303,7 +7303,7 @@ function wu(n) {
  */
 (function(n) {
   function e() {
-    return (Ht.canvg ? Promise.resolve(Ht.canvg) : import("./index.es-5IFpweNE.js")).catch((function(r) {
+    return (Ht.canvg ? Promise.resolve(Ht.canvg) : import("./index.es-CKZ1d9_J.js")).catch((function(r) {
       return Promise.reject(new Error("Could not load canvg: " + r));
     })).then((function(r) {
       return r.default ? r.default : r;

package/dist/nexabase-report.es.js

@@ -1,4 +1,4 @@
-import { D as s, N as r, a as t, S as E, b as m, i, r as l, e as o, t as p } from "./index-n-ggfS1p.js";
+import { D as s, N as r, a as t, S as E, b as m, i, r as l, e as o, t as p } from "./index-Dc1HlUG3.js";
 export {
   s as DEFAULT_THEME,
   r as NexaDesignerElement,