nexabase-report 0.28.1 → 0.28.4

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.4 — 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.4/schema/nexareport.schema.json
 ```
 
-(cambia `@0.28.1` por `@latest` para la versión más reciente). Valida el JSON generado
+(cambia `@0.28.4` 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-CTxi4E42.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-akrwtZ8x.js";
+import { j as Xl } from "./jspdf.es.min-Cs0lmW5w.js";
 function Jl(Pe, br) {
   for (var fe = 0; fe < br.length; fe++) {
     const HA = br[fe];