@freereportjs/core 0.8.0 → 0.9.0

package/dist/index.d.ts

@@ -795,6 +795,21 @@ interface ViewerOptions extends ReportOptions {
     /** Show the parameter panel open at start (default: when the report has parameters without defaults). */
     paramsOpen?: boolean;
     fileName?: string;
+    /** After every successful run (start, 조회/Run, setData, setParams, setDefinition): page and row counts. */
+    onReady?: (e: ViewerReadyEvent) => void;
+    /** When the user submits the parameter panel, before the data is fetched. Return false to stay (e.g. failed validation), or return changed params. */
+    onParamsSubmit?: (params: Record<string, unknown>) => boolean | void | Record<string, unknown> | Promise<boolean | void | Record<string, unknown>>;
+    /** The page in view changed (1-based). */
+    onPageChange?: (page: number, total: number) => void;
+    /** Loading data, laying out, printing or saving failed. The viewer still shows its own message. */
+    onError?: (error: Error, during: 'data' | 'layout' | 'output') => void;
+}
+interface ViewerReadyEvent {
+    pages: number;
+    rows: number;
+    /** Layout time in milliseconds. */
+    ms: number;
+    params: Record<string, unknown>;
 }
 interface Viewer {
     readonly report: Report;
@@ -1130,7 +1145,7 @@ declare function verifyLicense(key: string, host: string, opts?: {
 declare function setLicenseKey(key: string): void;
 
 /** FreeReport version (kept in sync with releases.json by scripts/release.mjs). */
-declare const version = "0.8.0";
+declare const version = "0.9.0";
 
 type Lang = 'ko' | 'en';
 
@@ -1192,4 +1207,4 @@ declare function renderXlsx(def: ReportDefinition, data?: ReportData, opts?: Ser
     mode?: 'form' | 'data';
 }): Promise<Uint8Array>;
 
-export { AgentError, type AgentLogEntry, type AgentPrintOptions, type AgentPrintResult, type AgentPrinter, type AgentStatus, type Align, type Band, type BandKind, type BarcodeElement, type BorderInput, type BorderSide, type BoxItem, type ChartElement, type ChartSeries, type CrosstabElement, type Designer, type DesignerOptions, type ElementType, type Emboss, type Expr, FUNCTIONS, type FieldElement, type FontBytes, type FontEntry, type GroupDefinition, type ImageElement, type ImageItem, type ItemSource, type LayoutOptions, type LayoutResult, type LicenseInfo, type LineElement, type LineItem, type OutputEvent, type OutputKind, PAPER, type PageItem, type PageSetup, type PaperSize, type ParamDefinition, type PathCommand, type PathItem, type PdfFontSource, type PdfOptions, type PdfPermissions, type PdfSecurity, type PrintOptions, type RectElement, type Report, type ReportData, type ReportDefinition, type ReportElement, type ReportOptions, type ReportPage, type ResolvedBorder, type ResolvedFont, type ServerRenderOptions, type Style, type TableColumn, type TableElement, type TextElement, type TextItem, type TextLine, type TextMeasurer, type VAlign, type Viewer, type ViewerOptions, type Watermark, type XCell, type XCellStyle, type XSheet, agent, applyEmboss, blankReport, canonicalText, canvasMeasurer, checkExpression, compile, contentWidth, createDesigner, createReport, createViewer, dataToCsv, dataToXlsx, defaultMeasurer, embossImage, encodeCode128, encodeDataMatrix, encodeEan13, encodePdf417, encodeQr, ensureFonts, estimateMeasurer, evaluate, fingerprintPages, formatDate, formatNumber, formatValue, getFont, interpolate, koreanAmount, koreanNumber, layoutReport, loadFontBytes, loadFonts, pageGeometry, pageToSvg, pagesToHwpx, pagesToXlsx, paramValues, printPages, registerFont, renderPage, renderPdf, renderXlsx, resetMeasurer, rowsOf, saveFile, setLicenseKey, sha256Hex, ttfMeasurer, verifyLicense, version, wrapText, writePdf, writeXlsx };
+export { AgentError, type AgentLogEntry, type AgentPrintOptions, type AgentPrintResult, type AgentPrinter, type AgentStatus, type Align, type Band, type BandKind, type BarcodeElement, type BorderInput, type BorderSide, type BoxItem, type ChartElement, type ChartSeries, type CrosstabElement, type Designer, type DesignerOptions, type ElementType, type Emboss, type Expr, FUNCTIONS, type FieldElement, type FontBytes, type FontEntry, type GroupDefinition, type ImageElement, type ImageItem, type ItemSource, type LayoutOptions, type LayoutResult, type LicenseInfo, type LineElement, type LineItem, type OutputEvent, type OutputKind, PAPER, type PageItem, type PageSetup, type PaperSize, type ParamDefinition, type PathCommand, type PathItem, type PdfFontSource, type PdfOptions, type PdfPermissions, type PdfSecurity, type PrintOptions, type RectElement, type Report, type ReportData, type ReportDefinition, type ReportElement, type ReportOptions, type ReportPage, type ResolvedBorder, type ResolvedFont, type ServerRenderOptions, type Style, type TableColumn, type TableElement, type TextElement, type TextItem, type TextLine, type TextMeasurer, type VAlign, type Viewer, type ViewerOptions, type ViewerReadyEvent, type Watermark, type XCell, type XCellStyle, type XSheet, agent, applyEmboss, blankReport, canonicalText, canvasMeasurer, checkExpression, compile, contentWidth, createDesigner, createReport, createViewer, dataToCsv, dataToXlsx, defaultMeasurer, embossImage, encodeCode128, encodeDataMatrix, encodeEan13, encodePdf417, encodeQr, ensureFonts, estimateMeasurer, evaluate, fingerprintPages, formatDate, formatNumber, formatValue, getFont, interpolate, koreanAmount, koreanNumber, layoutReport, loadFontBytes, loadFonts, pageGeometry, pageToSvg, pagesToHwpx, pagesToXlsx, paramValues, printPages, registerFont, renderPage, renderPdf, renderXlsx, resetMeasurer, rowsOf, saveFile, setLicenseKey, sha256Hex, ttfMeasurer, verifyLicense, version, wrapText, writePdf, writeXlsx };

package/dist/index.js

@@ -187,8 +187,8 @@ function pdfFonts(pages) {
 }
 
 // src/version.ts
-var version = "0.8.0";
-var releaseDate = "2026-10-15";
+var version = "0.9.0";
+var releaseDate = "2026-10-16";
 
 // src/license.ts
 var PUBLIC_KEY = { kty: "EC", crv: "P-256", x: "MiJXJR8TZJ_-0VKk0wIQ-5mzRsyQ6ruGsbcRRdw9jrw", y: "MTdklYSzCM2pganffz7PPMfxSclQkBLqU_9se_VDznM" };
@@ -5859,6 +5859,27 @@ function createViewer(el, options) {
     const pageH = result.height * MM_PX * scale + PAGE_GAP;
     current = Math.min(result.pages.length - 1, Math.max(0, Math.round(body.scrollTop / pageH)));
     if (pageInput && document.activeElement !== pageInput) pageInput.value = String(current + 1);
+    notifyPage();
+  };
+  let reported = -1;
+  const notifyPage = () => {
+    if (!result?.pages.length || current === reported) return;
+    reported = current;
+    try {
+      options.onPageChange?.(current + 1, result.pages.length);
+    } catch (e) {
+      console.error(e);
+    }
+  };
+  const fail = (e, during) => {
+    const err = e instanceof Error ? e : new Error(String(e));
+    console.error(err);
+    try {
+      options.onError?.(err, during);
+    } catch (x) {
+      console.error(x);
+    }
+    return err;
   };
   const goTo = (n2) => {
     if (!result) return;
@@ -5867,6 +5888,7 @@ function createViewer(el, options) {
     if (holder) body.scrollTop = holder.offsetTop - pagesEl.offsetTop;
     current = i;
     if (pageInput) pageInput.value = String(i + 1);
+    notifyPage();
   };
   const setZoom = (z) => {
     const ratio = result ? body.scrollTop / Math.max(1, body.scrollHeight) : 0;
@@ -5878,20 +5900,28 @@ function createViewer(el, options) {
   const run = async () => {
     const seq2 = ++runSeq;
     busy(t.loading);
+    let during = "data";
     try {
       if (options.fetchData) {
         const fetched = await options.fetchData(params);
         if (seq2 !== runSeq) return;
         report.setData(fetched);
       }
+      during = "layout";
       report.setParams(params);
       await ensureFonts(report.definition);
       if (destroyed) return;
       result = report.layout();
+      reported = -1;
       build();
+      try {
+        options.onReady?.({ pages: result.pages.length, rows: result.rowCount, ms: result.ms, params: { ...params } });
+      } catch (e) {
+        console.error(e);
+      }
     } catch (e) {
-      console.error(e);
-      pagesEl.innerHTML = `<p class="fr-empty">${t.error}: ${escapeHtml(String(e.message ?? e))}</p>`;
+      const err = fail(e, during);
+      pagesEl.innerHTML = `<p class="fr-empty">${t.error}: ${escapeHtml(err.message)}</p>`;
     } finally {
       busy(null);
     }
@@ -5901,8 +5931,7 @@ function createViewer(el, options) {
     try {
       await report.download(kind, options.fileName);
     } catch (e) {
-      console.error(e);
-      alertText(`${t.error}: ${e.message}`);
+      alertText(`${t.error}: ${fail(e, "output").message}`);
     } finally {
       busy(null);
     }
@@ -5944,7 +5973,7 @@ function createViewer(el, options) {
         setZoom(Math.round((scale - 0.1) * 10) / 10);
         break;
       case "print":
-        void report.print().catch((err) => alertText(`${t.error}: ${err.message}`));
+        void report.print().catch((err) => alertText(`${t.error}: ${fail(err, "output").message}`));
         break;
       case "pdf":
         void exportAs("pdf");
@@ -6019,7 +6048,7 @@ function createViewer(el, options) {
     e.preventDefault();
     setZoom(Math.round(scale * (e.deltaY < 0 ? 1.1 : 1 / 1.1) * 100) / 100);
   }, { passive: false });
-  form?.addEventListener("submit", (e) => {
+  form?.addEventListener("submit", async (e) => {
     e.preventDefault();
     const next = { ...params };
     form.querySelectorAll("input, select").forEach((inp) => {
@@ -6027,7 +6056,15 @@ function createViewer(el, options) {
       const v = inp.value;
       next[inp.name] = type === "number" ? v === "" ? null : Number(v) : type === "boolean" ? v === "true" : v;
     });
-    params = next;
+    let answer;
+    try {
+      answer = await options.onParamsSubmit?.({ ...next });
+    } catch (x) {
+      fail(x, "data");
+      return;
+    }
+    if (answer === false) return;
+    params = answer && typeof answer === "object" ? { ...next, ...answer } : next;
     void run();
   });
   const ro = typeof ResizeObserver !== "undefined" ? new ResizeObserver(() => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@freereportjs/core",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "description": "FreeReport — a web reporting engine (free for personal use): banded report designer, paged viewer, printing, PDF with embedded Korean fonts, Excel export.",
   "license": "SEE LICENSE IN LICENSE",
   "type": "module",