@freereportjs/core 0.8.0 → 0.10.0

package/dist/index.js

@@ -186,138 +186,6 @@ function pdfFonts(pages) {
   return out;
 }
 
-// src/version.ts
-var version = "0.8.0";
-var releaseDate = "2026-10-15";
-
-// src/license.ts
-var PUBLIC_KEY = { kty: "EC", crv: "P-256", x: "MiJXJR8TZJ_-0VKk0wIQ-5mzRsyQ6ruGsbcRRdw9jrw", y: "MTdklYSzCM2pganffz7PPMfxSclQkBLqU_9se_VDznM" };
-var PRICING_URL = "https://freereport.app/pricing/";
-var USAGE_URL = "https://freereport.app/api/usage";
-var STATUS_URL = "https://freereport.app/api/domain-status";
-var b64urlDecode = (s) => {
-  const bin = atob(s.replace(/-/g, "+").replace(/_/g, "/") + "=".repeat((4 - s.length % 4) % 4));
-  return Uint8Array.from(bin, (c) => c.charCodeAt(0));
-};
-function isDevHost(host) {
-  const h = host.toLowerCase().replace(/^\[|\]$/g, "");
-  return !h || h === "localhost" || h === "127.0.0.1" || h === "::1" || h === "0.0.0.0" || h.endsWith(".localhost") || h.endsWith(".test") || h.endsWith(".local") || /^(10\.\d+|192\.168|172\.(1[6-9]|2\d|3[01]))\.\d+\.\d+$/.test(h);
-}
-function domainMatches(host, domains) {
-  const h = host.toLowerCase().replace(/\.$/, "");
-  return domains.some((d) => {
-    const raw = d.toLowerCase().replace(/\.$/, "");
-    const wildcard = raw.startsWith("*.");
-    const dom = wildcard ? raw.slice(2) : raw;
-    if (!dom) return false;
-    if (h === dom || h === `www.${dom}`) return true;
-    return wildcard && h.endsWith(`.${dom}`);
-  });
-}
-var today = (now) => `${now.getFullYear()}-${String(now.getMonth() + 1).padStart(2, "0")}-${String(now.getDate()).padStart(2, "0")}`;
-async function verifyLicense(key2, host, opts = {}) {
-  const parts = typeof key2 === "string" ? key2.trim().split(".") : [];
-  if (parts.length !== 3 || parts[0] !== "FR1") return { ok: false, reason: "format" };
-  let info;
-  try {
-    info = JSON.parse(new TextDecoder().decode(b64urlDecode(parts[1])));
-    if (!Array.isArray(info.domains) || typeof info.expires !== "string") return { ok: false, reason: "format" };
-  } catch {
-    return { ok: false, reason: "format" };
-  }
-  const subtle = typeof crypto !== "undefined" ? crypto.subtle : void 0;
-  if (!subtle) return { ok: false, reason: "unsupported", info };
-  try {
-    const pub = await subtle.importKey("jwk", opts.publicKey ?? PUBLIC_KEY, { name: "ECDSA", namedCurve: "P-256" }, false, ["verify"]);
-    const signed = new TextEncoder().encode(`${parts[0]}.${parts[1]}`);
-    const ok = await subtle.verify({ name: "ECDSA", hash: "SHA-256" }, pub, b64urlDecode(parts[2]), signed);
-    if (!ok) return { ok: false, reason: "signature", info };
-  } catch {
-    return { ok: false, reason: "signature", info };
-  }
-  if (today(opts.now ?? /* @__PURE__ */ new Date()) > info.expires) return { ok: false, reason: "expired", info };
-  if (!domainMatches(host, info.domains)) return { ok: false, reason: "domain", info };
-  if (info.updates && (opts.released ?? releaseDate) > info.updates) return { ok: false, reason: "updates", info };
-  return { ok: true, info };
-}
-var globalKey;
-var statuses = /* @__PURE__ */ new Map();
-var badgeCheck = null;
-function setLicenseKey(key2) {
-  globalKey = key2;
-}
-var NOTICE = {
-  missing: `FreeReport is free for personal use. Company use needs a domain license (\u20A9500,000 per domain per year, or \u20A9900,000 perpetual): ${PRICING_URL}
-FreeReport\uB294 \uAC1C\uC778\uC5D0\uAC8C \uBB34\uB8CC\uC785\uB2C8\uB2E4. \uD68C\uC0AC\uC5D0\uC11C \uC4F0\uB824\uBA74 \uB3C4\uBA54\uC778 \uB77C\uC774\uC120\uC2A4(\uB3C4\uBA54\uC778\uB2F9 \uC5F0 50\uB9CC \uC6D0, \uC601\uAD6C 90\uB9CC \uC6D0)\uAC00 \uD544\uC694\uD569\uB2C8\uB2E4: ${PRICING_URL}`,
-  format: "FreeReport: the license key is not in the right format. / \uB77C\uC774\uC120\uC2A4 \uD0A4 \uD615\uC2DD\uC774 \uC62C\uBC14\uB974\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4.",
-  signature: "FreeReport: the license key could not be verified. / \uB77C\uC774\uC120\uC2A4 \uD0A4\uB97C \uD655\uC778\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.",
-  expired: "FreeReport: the license key has expired. / \uB77C\uC774\uC120\uC2A4 \uAE30\uAC04\uC774 \uB05D\uB0AC\uC2B5\uB2C8\uB2E4.",
-  domain: "FreeReport: the license key is for a different domain. / \uB2E4\uB978 \uB3C4\uBA54\uC778\uC6A9 \uB77C\uC774\uC120\uC2A4 \uD0A4\uC785\uB2C8\uB2E4.",
-  updates: "FreeReport: this version was released after the update period of your perpetual license. / \uC601\uAD6C \uB77C\uC774\uC120\uC2A4\uC758 \uC5C5\uB370\uC774\uD2B8 \uAE30\uAC04 \uB4A4\uC5D0 \uB098\uC628 \uBC84\uC804\uC785\uB2C8\uB2E4."
-};
-function reportUsage(info, host = typeof location !== "undefined" ? location.hostname : "") {
-  try {
-    if (isDevHost(host) || typeof navigator === "undefined") return;
-    const day = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
-    const mark = `${host}|${day}|${info.licensed ? 1 : 0}`;
-    const store = typeof localStorage !== "undefined" ? localStorage : null;
-    if (store?.getItem("freereport:usage") === mark) return;
-    store?.setItem("freereport:usage", mark);
-    const body = JSON.stringify({ version: info.version, licensed: info.licensed, company: info.company, url: `${location.origin}${location.pathname}` });
-    if (typeof navigator.sendBeacon === "function") navigator.sendBeacon(USAGE_URL, body);
-    else if (typeof fetch === "function") void fetch(USAGE_URL, { method: "POST", body, mode: "no-cors", keepalive: true }).catch(() => void 0);
-  } catch {
-  }
-}
-function checkLicense(key2 = globalKey, host = typeof location !== "undefined" ? location.hostname : "") {
-  if (isDevHost(host)) return Promise.resolve(true);
-  const k = key2 ?? globalKey;
-  const id = `${k ?? ""}@${host}`;
-  let status = statuses.get(id);
-  if (status) return status;
-  if (!k) {
-    console.info(NOTICE.missing);
-    reportUsage({ version, licensed: false }, host);
-    status = Promise.resolve(false);
-  } else {
-    status = verifyLicense(k, host).then((res) => {
-      reportUsage({ version, licensed: res.ok, company: res.ok ? res.info.company : void 0 }, host);
-      if (res.ok || res.reason === "unsupported") return res.ok || res.reason === "unsupported";
-      const extra = res.info ? ` (${res.info.domains.join(", ")}, ${res.info.expires})` : "";
-      console.warn(`${NOTICE[res.reason]}${extra}
-${PRICING_URL}`);
-      return false;
-    }, () => false);
-  }
-  statuses.set(id, status);
-  return status;
-}
-function badgeRequested(host = typeof location !== "undefined" ? location.hostname : "") {
-  if (isDevHost(host) || typeof fetch !== "function") return Promise.resolve(false);
-  if (badgeCheck) return badgeCheck;
-  const day = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
-  let store = null;
-  try {
-    store = typeof localStorage !== "undefined" ? localStorage : null;
-    const cached = JSON.parse(store?.getItem("freereport:badge") ?? "null");
-    if (cached && cached.host === host && cached.day === day) return badgeCheck = Promise.resolve(cached.show);
-  } catch {
-  }
-  badgeCheck = fetch(STATUS_URL, { mode: "cors", credentials: "omit" }).then((r) => r.ok ? r.json() : { badge: false }).then((d) => {
-    const show = d.badge === true;
-    try {
-      store?.setItem("freereport:badge", JSON.stringify({ host, day, show }));
-    } catch {
-    }
-    return show;
-  }, () => false);
-  return badgeCheck;
-}
-async function needsFreeBadge(key2, host = typeof location !== "undefined" ? location.hostname : "") {
-  if (await checkLicense(key2, host)) return false;
-  return badgeRequested(host);
-}
-
 // src/format.ts
 var DIGITS = ["", "\uC77C", "\uC774", "\uC0BC", "\uC0AC", "\uC624", "\uC721", "\uCE60", "\uD314", "\uAD6C"];
 var SMALL = ["", "\uC2ED", "\uBC31", "\uCC9C"];
@@ -499,6 +367,138 @@ function formatValue(v, format, locale = "ko") {
   return String(v);
 }
 
+// src/version.ts
+var version = "0.10.0";
+var releaseDate = "2026-10-19";
+
+// src/license.ts
+var PUBLIC_KEY = { kty: "EC", crv: "P-256", x: "MiJXJR8TZJ_-0VKk0wIQ-5mzRsyQ6ruGsbcRRdw9jrw", y: "MTdklYSzCM2pganffz7PPMfxSclQkBLqU_9se_VDznM" };
+var PRICING_URL = "https://freereport.app/pricing/";
+var USAGE_URL = "https://freereport.app/api/usage";
+var STATUS_URL = "https://freereport.app/api/domain-status";
+var b64urlDecode = (s) => {
+  const bin = atob(s.replace(/-/g, "+").replace(/_/g, "/") + "=".repeat((4 - s.length % 4) % 4));
+  return Uint8Array.from(bin, (c) => c.charCodeAt(0));
+};
+function isDevHost(host) {
+  const h = host.toLowerCase().replace(/^\[|\]$/g, "");
+  return !h || h === "localhost" || h === "127.0.0.1" || h === "::1" || h === "0.0.0.0" || h.endsWith(".localhost") || h.endsWith(".test") || h.endsWith(".local") || /^(10\.\d+|192\.168|172\.(1[6-9]|2\d|3[01]))\.\d+\.\d+$/.test(h);
+}
+function domainMatches(host, domains) {
+  const h = host.toLowerCase().replace(/\.$/, "");
+  return domains.some((d) => {
+    const raw = d.toLowerCase().replace(/\.$/, "");
+    const wildcard = raw.startsWith("*.");
+    const dom = wildcard ? raw.slice(2) : raw;
+    if (!dom) return false;
+    if (h === dom || h === `www.${dom}`) return true;
+    return wildcard && h.endsWith(`.${dom}`);
+  });
+}
+var today = (now) => `${now.getFullYear()}-${String(now.getMonth() + 1).padStart(2, "0")}-${String(now.getDate()).padStart(2, "0")}`;
+async function verifyLicense(key2, host, opts = {}) {
+  const parts = typeof key2 === "string" ? key2.trim().split(".") : [];
+  if (parts.length !== 3 || parts[0] !== "FR1") return { ok: false, reason: "format" };
+  let info;
+  try {
+    info = JSON.parse(new TextDecoder().decode(b64urlDecode(parts[1])));
+    if (!Array.isArray(info.domains) || typeof info.expires !== "string") return { ok: false, reason: "format" };
+  } catch {
+    return { ok: false, reason: "format" };
+  }
+  const subtle = typeof crypto !== "undefined" ? crypto.subtle : void 0;
+  if (!subtle) return { ok: false, reason: "unsupported", info };
+  try {
+    const pub = await subtle.importKey("jwk", opts.publicKey ?? PUBLIC_KEY, { name: "ECDSA", namedCurve: "P-256" }, false, ["verify"]);
+    const signed = new TextEncoder().encode(`${parts[0]}.${parts[1]}`);
+    const ok = await subtle.verify({ name: "ECDSA", hash: "SHA-256" }, pub, b64urlDecode(parts[2]), signed);
+    if (!ok) return { ok: false, reason: "signature", info };
+  } catch {
+    return { ok: false, reason: "signature", info };
+  }
+  if (today(opts.now ?? /* @__PURE__ */ new Date()) > info.expires) return { ok: false, reason: "expired", info };
+  if (!domainMatches(host, info.domains)) return { ok: false, reason: "domain", info };
+  if (info.updates && (opts.released ?? releaseDate) > info.updates) return { ok: false, reason: "updates", info };
+  return { ok: true, info };
+}
+var globalKey;
+var statuses = /* @__PURE__ */ new Map();
+var badgeCheck = null;
+function setLicenseKey(key2) {
+  globalKey = key2;
+}
+var NOTICE = {
+  missing: `FreeReport is free for personal use. Company use needs a domain license (\u20A9500,000 per domain per year, or \u20A9900,000 perpetual): ${PRICING_URL}
+FreeReport\uB294 \uAC1C\uC778\uC5D0\uAC8C \uBB34\uB8CC\uC785\uB2C8\uB2E4. \uD68C\uC0AC\uC5D0\uC11C \uC4F0\uB824\uBA74 \uB3C4\uBA54\uC778 \uB77C\uC774\uC120\uC2A4(\uB3C4\uBA54\uC778\uB2F9 \uC5F0 50\uB9CC \uC6D0, \uC601\uAD6C 90\uB9CC \uC6D0)\uAC00 \uD544\uC694\uD569\uB2C8\uB2E4: ${PRICING_URL}`,
+  format: "FreeReport: the license key is not in the right format. / \uB77C\uC774\uC120\uC2A4 \uD0A4 \uD615\uC2DD\uC774 \uC62C\uBC14\uB974\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4.",
+  signature: "FreeReport: the license key could not be verified. / \uB77C\uC774\uC120\uC2A4 \uD0A4\uB97C \uD655\uC778\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.",
+  expired: "FreeReport: the license key has expired. / \uB77C\uC774\uC120\uC2A4 \uAE30\uAC04\uC774 \uB05D\uB0AC\uC2B5\uB2C8\uB2E4.",
+  domain: "FreeReport: the license key is for a different domain. / \uB2E4\uB978 \uB3C4\uBA54\uC778\uC6A9 \uB77C\uC774\uC120\uC2A4 \uD0A4\uC785\uB2C8\uB2E4.",
+  updates: "FreeReport: this version was released after the update period of your perpetual license. / \uC601\uAD6C \uB77C\uC774\uC120\uC2A4\uC758 \uC5C5\uB370\uC774\uD2B8 \uAE30\uAC04 \uB4A4\uC5D0 \uB098\uC628 \uBC84\uC804\uC785\uB2C8\uB2E4."
+};
+function reportUsage(info, host = typeof location !== "undefined" ? location.hostname : "") {
+  try {
+    if (isDevHost(host) || typeof navigator === "undefined") return;
+    const day = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+    const mark = `${host}|${day}|${info.licensed ? 1 : 0}`;
+    const store = typeof localStorage !== "undefined" ? localStorage : null;
+    if (store?.getItem("freereport:usage") === mark) return;
+    store?.setItem("freereport:usage", mark);
+    const body = JSON.stringify({ version: info.version, licensed: info.licensed, company: info.company, url: `${location.origin}${location.pathname}` });
+    if (typeof navigator.sendBeacon === "function") navigator.sendBeacon(USAGE_URL, body);
+    else if (typeof fetch === "function") void fetch(USAGE_URL, { method: "POST", body, mode: "no-cors", keepalive: true }).catch(() => void 0);
+  } catch {
+  }
+}
+function checkLicense(key2 = globalKey, host = typeof location !== "undefined" ? location.hostname : "") {
+  if (isDevHost(host)) return Promise.resolve(true);
+  const k = key2 ?? globalKey;
+  const id = `${k ?? ""}@${host}`;
+  let status = statuses.get(id);
+  if (status) return status;
+  if (!k) {
+    console.info(NOTICE.missing);
+    reportUsage({ version, licensed: false }, host);
+    status = Promise.resolve(false);
+  } else {
+    status = verifyLicense(k, host).then((res) => {
+      reportUsage({ version, licensed: res.ok, company: res.ok ? res.info.company : void 0 }, host);
+      if (res.ok || res.reason === "unsupported") return res.ok || res.reason === "unsupported";
+      const extra = res.info ? ` (${res.info.domains.join(", ")}, ${res.info.expires})` : "";
+      console.warn(`${NOTICE[res.reason]}${extra}
+${PRICING_URL}`);
+      return false;
+    }, () => false);
+  }
+  statuses.set(id, status);
+  return status;
+}
+function badgeRequested(host = typeof location !== "undefined" ? location.hostname : "") {
+  if (isDevHost(host) || typeof fetch !== "function") return Promise.resolve(false);
+  if (badgeCheck) return badgeCheck;
+  const day = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+  let store = null;
+  try {
+    store = typeof localStorage !== "undefined" ? localStorage : null;
+    const cached = JSON.parse(store?.getItem("freereport:badge") ?? "null");
+    if (cached && cached.host === host && cached.day === day) return badgeCheck = Promise.resolve(cached.show);
+  } catch {
+  }
+  badgeCheck = fetch(STATUS_URL, { mode: "cors", credentials: "omit" }).then((r) => r.ok ? r.json() : { badge: false }).then((d) => {
+    const show = d.badge === true;
+    try {
+      store?.setItem("freereport:badge", JSON.stringify({ host, day, show }));
+    } catch {
+    }
+    return show;
+  }, () => false);
+  return badgeCheck;
+}
+async function needsFreeBadge(key2, host = typeof location !== "undefined" ? location.hostname : "") {
+  if (await checkLicense(key2, host)) return false;
+  return badgeRequested(host);
+}
+
 // src/expr.ts
 var OPS = ["===", "!==", "==", "!=", "<=", ">=", "&&", "||", "??", "<", ">", "+", "-", "*", "/", "%", "!", "?", ":", "(", ")", ",", ".", "[", "]"];
 function tokenize(src) {
@@ -933,7 +933,7 @@ function checkExpression(src) {
     return e.message;
   }
 }
-function interpolate(template, scope) {
+function interpolate(template, scope, locale) {
   if (!template.includes("{")) return template.replace(/}}/g, "}");
   let out = "";
   let i = 0;
@@ -961,7 +961,7 @@ function interpolate(template, scope) {
     }
     const { expr, format } = splitFormat(template.slice(i + 1, end));
     const v = evaluate(expr, scope);
-    out += formatValue(v, format);
+    out += formatValue(v, format, locale);
     i = end + 1;
   }
   return out;
@@ -1335,6 +1335,11 @@ function pathData(d) {
   return d.map((v) => typeof v === "number" ? n(v) : v).join(" ");
 }
 var opacityAttr = (o) => o !== void 0 && o < 1 ? ` opacity="${n(o)}"` : "";
+var sourceAttrs = (it) => {
+  const s = it.source;
+  if (!s?.elementId) return "";
+  return ` data-fr-id="${esc(s.elementId)}" data-fr-kind="${it.kind}"${s.row !== void 0 ? ` data-fr-row="${s.row}"` : ""}`;
+};
 function textSvg(t, clipId) {
   const sizeMm = t.font.size * PT;
   const family = `${quoteFamily(t.font.family)}, ${FALLBACK_FONTS}`.replace(/"/g, "'");
@@ -1348,11 +1353,12 @@ function textSvg(t, clipId) {
   }
   const overflow = t.source?.band !== "watermark" && t.lines.some((l) => l.x < t.x - 0.05 || l.x + l.width > t.x + t.w + 0.05 || l.y - sizeMm * 0.8 < t.y - 0.05 || l.y + sizeMm * 0.2 > t.y + t.h + 0.05);
   const transform = t.rotate ? ` transform="rotate(${n(t.rotate)} ${n(t.x + t.w / 2)} ${n(t.y + t.h / 2)})"` : "";
-  if (!overflow) return { defs: "", body: `<g ${attrs}${transform}${opacityAttr(t.opacity)}>${body}</g>` };
+  const hooks = sourceAttrs(t) + (t.overflow ? ' data-fr-overflow="1"' : "");
+  if (!overflow) return { defs: "", body: `<g ${attrs}${hooks}${transform}${opacityAttr(t.opacity)}>${body}</g>` };
   const id = clipId();
   return {
     defs: `<clipPath id="${id}"><rect x="${n(t.x)}" y="${n(t.y)}" width="${n(t.w)}" height="${n(t.h)}"/></clipPath>`,
-    body: `<g ${attrs} clip-path="url(#${id})"${transform}${opacityAttr(t.opacity)}>${body}</g>`
+    body: `<g ${attrs}${hooks} clip-path="url(#${id})"${transform}${opacityAttr(t.opacity)}>${body}</g>`
   };
 }
 function itemSvg(it, clipId) {
@@ -1401,7 +1407,8 @@ function pageToSvg(page, opts = {}) {
   for (const it of page.items) {
     const r = itemSvg(it, clipId);
     defs += r.defs;
-    body += r.body;
+    const hooks = it.kind === "text" ? "" : sourceAttrs(it);
+    body += hooks && r.body ? `<g${hooks}>${r.body}</g>` : r.body;
   }
   const size = opts.scale ? `width="${n(page.width * opts.scale)}" height="${n(page.height * opts.scale)}"` : `width="${n(page.width)}mm" height="${n(page.height)}mm"`;
   return `<svg xmlns="http://www.w3.org/2000/svg" ${size} viewBox="0 0 ${n(page.width)} ${n(page.height)}"${opts.className ? ` class="${opts.className}"` : ""} text-rendering="geometricPrecision">${defs ? `<defs>${defs}</defs>` : ""}<rect width="100%" height="100%" fill="#fff"/>${body}</svg>`;
@@ -2900,7 +2907,7 @@ function prepare(el, scope, ctx, bandCanGrow) {
   let text = "";
   let value;
   if (!ctx.blank) {
-    if (el.type === "text") text = interpolate(el.text ?? "", scope);
+    if (el.type === "text") text = interpolate(el.text ?? "", scope, ctx.locale);
     else {
       value = evaluate(el.expr, scope);
       text = value == null || value === "" ? el.nullText ?? "" : formatValue(value, el.format, ctx.locale);
@@ -2945,6 +2952,7 @@ function textItem(x, y, w, h, lines, font, st, measure) {
     else if (st.align === "right") lx = x + w - pr - width;
     return { text, x: lx, y: top + i * lineH + (lineH - font.size * PT) / 2 + font.size * PT * ASCENT, width };
   });
+  const overflow = total > innerH + 0.05 || out.some((l) => l.width > w - pl - pr + 0.05);
   return {
     kind: "text",
     x,
@@ -2959,6 +2967,7 @@ function textItem(x, y, w, h, lines, font, st, measure) {
     underline: st.underline || void 0,
     strike: st.strike || void 0,
     letterSpacing: st.letterSpacing || void 0,
+    overflow: overflow || void 0,
     text: lines.join("\n")
   };
 }
@@ -3027,25 +3036,68 @@ function barcodeItems(el, x, y, w, h, scope, ctx) {
     return [textItem(x, y, w, h, ["(barcode?)"], { family: "sans-serif", size: 7, bold: false, italic: false }, { ...resolveStyle(ctx.def, el), color: "#cc0000" }, ctx.measure)];
   }
 }
+function shifts(prepared) {
+  let grew = false;
+  for (const p of prepared) if (p.needed > p.el.h + 0.01) {
+    grew = true;
+    break;
+  }
+  if (!grew) return null;
+  const out = /* @__PURE__ */ new Map();
+  const top = (p) => Math.min(p.el.y, p.el.y + p.el.h);
+  const bottom = (p) => Math.max(p.el.y, p.el.y + p.el.h);
+  const order = [...prepared].sort((a, b) => top(a) - top(b));
+  for (const p of order) {
+    if (p.el.shift === false) continue;
+    let by = 0;
+    for (const q of order) {
+      if (top(q) >= top(p)) break;
+      if (bottom(q) > top(p) + 0.01) continue;
+      by = Math.max(by, (out.get(q) ?? 0) + Math.max(0, q.needed - q.el.h));
+    }
+    if (by > 0) out.set(p, by);
+  }
+  return out;
+}
+function addAnchor(out, el, ctx, left, top, y, h, hidden) {
+  if (!el.id) return;
+  const line = el.type === "line";
+  out.push({
+    id: el.id,
+    band: ctx.kind,
+    row: ctx.rowIndex,
+    x: left + (line ? Math.min(el.x, el.x + el.w) : el.x),
+    y: top + (line ? Math.min(y, y + h) : y),
+    w: line ? Math.abs(el.w) : el.w,
+    h: line ? Math.abs(h) : h,
+    ...hidden ? { hidden } : {}
+  });
+}
 function renderBand(band, scope, ctx, left, top, minHeight = 0) {
   const bandGrow = band.canGrow ?? (ctx.kind === "detail" || ctx.kind === "groupHeader" || ctx.kind === "groupFooter" || ctx.kind === "summary" || ctx.kind === "title");
   const prepared = [];
+  const anchors = ctx.anchors && !ctx.blank ? [] : void 0;
   for (const el of band.elements) {
-    if (el.visible && !ctx.blank && !truthy(evaluate(el.visible, scope))) continue;
+    if (el.visible && !ctx.blank && !truthy(evaluate(el.visible, scope))) {
+      if (anchors) addAnchor(anchors, el, ctx, left, top, el.y, el.h, true);
+      continue;
+    }
     prepared.push(prepare(el, scope, ctx, bandGrow));
   }
+  const shift2 = shifts(prepared);
   let height = Math.max(band.height, minHeight);
-  for (const p of prepared) height = Math.max(height, p.el.y + p.needed);
+  for (const p of prepared) height = Math.max(height, p.el.y + (shift2?.get(p) ?? 0) + p.needed);
   const items = [];
   const bg = ctx.background ?? band.background;
   if (bg) items.push({ kind: "box", x: left, y: top, w: ctx.width, h: height, fill: bg, source: { band: ctx.kind, row: ctx.rowIndex } });
-  const growth = height - band.height;
   for (const p of prepared) {
     const el = p.el;
+    const elY = shift2 ? el.y + (shift2.get(p) ?? 0) : el.y;
     const touchesBottom = el.y + el.h >= band.height - 0.01;
     let h = p.needed;
-    if ((el.stretch ?? touchesBottom) && el.type !== "line" && el.type !== "table" && el.type !== "crosstab") h = Math.max(h, el.h + growth, height - el.y);
-    const x = left + el.x, y = top + el.y;
+    if ((el.stretch ?? touchesBottom) && el.type !== "line" && el.type !== "table" && el.type !== "crosstab") h = Math.max(h, height - elY);
+    const x = left + el.x, y = top + elY;
+    if (anchors) addAnchor(anchors, el, ctx, left, top, elY, el.type === "line" ? el.h === 0 ? 0 : el.y + el.h >= band.height - 0.01 ? Math.max(el.h, height - elY) : el.h : h);
     switch (el.type) {
       case "text":
       case "field": {
@@ -3060,7 +3112,7 @@ function renderBand(band, scope, ctx, left, top, minHeight = 0) {
         break;
       }
       case "line": {
-        const lh = el.h === 0 ? 0 : el.y + el.h >= band.height - 0.01 ? el.h + growth : el.h;
+        const lh = el.h === 0 ? 0 : el.y + el.h >= band.height - 0.01 ? Math.max(el.h, height - elY) : el.h;
         items.push({ kind: "line", x1: x, y1: y, x2: x + el.w, y2: y + lh, width: el.width ?? 0.2, color: el.color ?? "#000000", dash: el.dash, source: { band: ctx.kind, elementId: el.id } });
         break;
       }
@@ -3098,7 +3150,7 @@ function renderBand(band, scope, ctx, left, top, minHeight = 0) {
         break;
     }
   }
-  return { height, items };
+  return anchors ? { height, items, anchors } : { height, items };
 }
 
 // src/layout.ts
@@ -3283,7 +3335,7 @@ function paginate(def, data, opts, knownTotal, docHash) {
       groupLevel: e.group?.level
     }
   });
-  const ctxFor = (kind, extra = {}) => ({ def, measure, locale, kind, width, previous, ...extra });
+  const ctxFor = (kind, extra = {}) => ({ def, measure, locale, kind, width, previous, anchors: opts.anchors, ...extra });
   const newPage = () => {
     if (pages.length >= maxPages) throw new Error(`Report stopped at ${maxPages} pages (maxPages)`);
     page = { number: pages.length + 1, total: 0, width: geo.width, height: geo.height, items: [] };
@@ -3298,13 +3350,14 @@ function paginate(def, data, opts, knownTotal, docHash) {
     previous.clear();
   };
   const place = (band, kind, scope, extra = {}, pre) => {
-    const r = pre ? { height: pre.height, items: shiftItems(pre.items, y) } : renderBand(band, scope, ctxFor(kind, extra), ml, y);
+    const r = pre ? { height: pre.height, items: shiftItems(pre.items, y), anchors: pre.anchors?.map((a) => ({ ...a, y: a.y + y })) } : renderBand(band, scope, ctxFor(kind, extra), ml, y);
     for (const it of r.items) page.items.push(it);
+    if (r.anchors) (page.anchors ?? (page.anchors = [])).push(...r.anchors);
     y += r.height;
     hasBody = true;
     return r.height;
   };
-  const heightOf = (band, kind, scope, extra = {}) => renderBand(band, scope, ctxFor(kind, { ...extra, previous: void 0 }), 0, 0).height;
+  const heightOf = (band, kind, scope, extra = {}) => renderBand(band, scope, ctxFor(kind, { ...extra, previous: void 0, anchors: false }), 0, 0).height;
   const renderChunk = (e, scope, extra) => {
     const band = e.band;
     const n2 = Math.max(1, Math.floor(band.columns ?? 1));
@@ -3317,7 +3370,7 @@ function paginate(def, data, opts, knownTotal, docHash) {
       ml + i * (colW + gap),
       0
     ));
-    return { height: Math.max(...parts.map((p) => p.height)), items: parts.flatMap((p) => p.items) };
+    return { height: Math.max(...parts.map((p) => p.height)), items: parts.flatMap((p) => p.items), anchors: opts.anchors ? parts.flatMap((p) => p.anchors ?? []) : void 0 };
   };
   const isTableEntry = (e) => e.kind === "detail" || e.kind === "groupHeader" || e.kind === "groupFooter";
   const placeColumnHeader = (e) => {
@@ -3413,7 +3466,9 @@ function paginate(def, data, opts, knownTotal, docHash) {
     const draw = (band, kind, top) => {
       if (!band) return;
       if (band.visible && !truthy2(evaluate(band.visible, scope))) return;
-      extraItems.push(...renderBand(band, scope, ctxFor(kind, { previous: void 0 }), ml, top, 0).items);
+      const r = renderBand(band, scope, ctxFor(kind, { previous: void 0 }), ml, top, 0);
+      extraItems.push(...r.items);
+      if (r.anchors) (p.anchors ?? (p.anchors = [])).push(...r.anchors);
     };
     if (!(def.pageHeaderSkipFirst && i === 0)) draw(b.pageHeader, "pageHeader", mt);
     draw(b.pageFooter, "pageFooter", geo.height - mb - footerH);
@@ -5550,8 +5605,10 @@ function createReport(definition, data = {}, opts = {}) {
   let rows = data;
   let params = { ...opts.params };
   let cached = null;
+  let anchored = null;
   void checkLicense(opts.licenseKey);
   const layout = () => cached ?? (cached = layoutReport(def, rows, { ...opts, params }));
+  const withAnchors = () => opts.anchors ? layout() : anchored ?? (anchored = layoutReport(def, rows, { ...opts, params, anchors: true }));
   const allowed = async (kind, fileName) => {
     if (!opts.onOutput) return true;
     const l = layout();
@@ -5565,12 +5622,16 @@ function createReport(definition, data = {}, opts = {}) {
     layout,
     async ready() {
       await ensureFonts(def);
-      cached = null;
+      cached = anchored = null;
       return layout();
     },
+    anchors(prefix = "") {
+      const l = withAnchors();
+      return l.pages.flatMap((p, i) => (p.anchors ?? []).filter((a) => a.id.startsWith(prefix)).map((a) => ({ ...a, page: i + 1, pageWidth: p.width, pageHeight: p.height })));
+    },
     setData(d) {
       rows = d;
-      cached = null;
+      cached = anchored = null;
     },
     fingerprint() {
       const l = layout();
@@ -5578,11 +5639,11 @@ function createReport(definition, data = {}, opts = {}) {
     },
     setParams(p) {
       params = { ...p };
-      cached = null;
+      cached = anchored = null;
     },
     setDefinition(d) {
       def = d;
-      cached = null;
+      cached = anchored = null;
     },
     async print(o = {}) {
       if (!await allowed("print")) return false;
@@ -5719,7 +5780,7 @@ var PAGE_GAP = 16;
 function paramInput(name, p, value, t) {
   const id = `fr-p-${name.replace(/[^\w-]/g, "_")}`;
   const label = `<label for="${id}">${escapeHtml(p.label ?? name)}${p.required ? ' <b aria-hidden="true">*</b>' : ""}</label>`;
-  const v = value == null ? "" : value instanceof Date ? value.toISOString().slice(0, 10) : String(value);
+  const v = value == null ? "" : value instanceof Date ? formatDate(value, "yyyy-MM-dd") : String(value);
   const req = p.required ? " required" : "";
   if (p.type === "select" || p.options) {
     return `<div class="fr-param">${label}<select id="${id}" name="${escapeHtml(name)}"${req}>${(p.options ?? []).map((o) => `<option value="${escapeHtml(String(o.value))}"${String(o.value) === v ? " selected" : ""}>${escapeHtml(String(o.label ?? o.value))}</option>`).join("")}</select></div>`;
@@ -5784,9 +5845,10 @@ function createViewer(el, options) {
   const toggle = $(".fr-params-toggle");
   const menuBtn = $('[data-act="menu"]');
   const menuList = $(".fr-menu-list");
+  const overlayText = $(".fr-overlay-text");
   const busy = (text) => {
     overlay.hidden = text === null;
-    $(".fr-overlay-text").textContent = text ?? "";
+    overlayText.textContent = text ?? "";
   };
   const showParams = (open) => {
     if (!form || !toggle) return;
@@ -5838,6 +5900,7 @@ function createViewer(el, options) {
       const holder = document.createElement("div");
       holder.className = "fr-page";
       holder.dataset.index = String(i);
+      holder.dataset.page = String(i + 1);
       holder.setAttribute("aria-label", `${t.page} ${i + 1}`);
       frag.appendChild(holder);
     });
@@ -5847,7 +5910,11 @@ function createViewer(el, options) {
       for (const e of entries) if (e.isIntersecting) drawPage(e.target);
       updateCurrent();
     }, { root: body, rootMargin: "600px 0px" }) : null;
-    pagesEl.querySelectorAll(".fr-page").forEach((p, i) => observer ? observer.observe(p) : i < 3 && drawPage(p));
+    const holders = pagesEl.querySelectorAll(".fr-page");
+    holders.forEach((p, i) => observer ? observer.observe(p) : i < 3 && drawPage(p));
+    const pageH = result.height * MM_PX * scale + PAGE_GAP;
+    const from = Math.min(holders.length - 1, Math.max(0, Math.floor(body.scrollTop / pageH)));
+    for (let i = from; i < Math.min(holders.length, from + 1 + Math.ceil(body.clientHeight / pageH)); i++) drawPage(holders[i]);
     if (totalEl) totalEl.textContent = `/ ${result.pages.length}`;
     lastQuery = "";
     hits = [];
@@ -5859,6 +5926,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 +5955,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;
@@ -5875,34 +5964,54 @@ function createViewer(el, options) {
     body.scrollTop = ratio * body.scrollHeight;
   };
   let runSeq = 0;
-  const run = async () => {
-    const seq2 = ++runSeq;
+  let runs = 0;
+  let latest = Promise.resolve();
+  const setState = (state) => {
+    el.dataset.frState = state;
+  };
+  const runOnce = async (seq2) => {
     busy(t.loading);
+    setState("busy");
+    let during = "data";
+    const stale = () => seq2 !== runSeq;
     try {
       if (options.fetchData) {
         const fetched = await options.fetchData(params);
-        if (seq2 !== runSeq) return;
+        if (stale()) return await latest;
         report.setData(fetched);
       }
+      during = "layout";
       report.setParams(params);
       await ensureFonts(report.definition);
       if (destroyed) return;
+      if (stale()) return await latest;
       result = report.layout();
+      reported = -1;
       build();
+      el.dataset.frRun = String(++runs);
+      setState("ready");
+      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>`;
+      if (stale()) return await latest;
+      const err = fail(e, during);
+      pagesEl.innerHTML = `<p class="fr-empty">${t.error}: ${escapeHtml(err.message)}</p>`;
+      el.dataset.frRun = String(++runs);
+      setState("error");
     } finally {
-      busy(null);
+      if (!stale()) busy(null);
     }
   };
+  const run = () => latest = runOnce(++runSeq);
   const exportAs = async (kind) => {
     busy(t.exporting);
     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 +6053,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 +6128,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 +6136,21 @@ function createViewer(el, options) {
       const v = inp.value;
       next[inp.name] = type === "number" ? v === "" ? null : Number(v) : type === "boolean" ? v === "true" : v;
     });
-    params = next;
+    const before = el.dataset.frState;
+    setState("busy");
+    let answer;
+    try {
+      answer = await options.onParamsSubmit?.({ ...next });
+    } catch (x) {
+      fail(x, "data");
+      setState(before ?? "ready");
+      return;
+    }
+    if (answer === false) {
+      setState(before ?? "ready");
+      return;
+    }
+    params = answer && typeof answer === "object" ? { ...next, ...answer } : next;
     void run();
   });
   const ro = typeof ResizeObserver !== "undefined" ? new ResizeObserver(() => {
@@ -6138,6 +6261,8 @@ function createViewer(el, options) {
       listeners.abort();
       el.innerHTML = "";
       el.classList.remove("fr-viewer");
+      delete el.dataset.frState;
+      delete el.dataset.frRun;
     }
   };
 }
@@ -6185,7 +6310,7 @@ function ensureIds(def) {
   for (const s of bandSlots(def)) for (const el of s.band.elements) if (el.id) all.add(el.id);
   const seen = /* @__PURE__ */ new Set();
   for (const s of bandSlots(def)) for (const el of s.band.elements) {
-    if (el.id && /^[\w-]{1,64}$/.test(String(el.id)) && !seen.has(el.id)) {
+    if (el.id && /^[\w:.-]{1,64}$/.test(String(el.id)) && !seen.has(el.id)) {
       seen.add(el.id);
       continue;
     }