@agile-team/mach-report 2.16.0 → 2.18.0

package/dist/pdf.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./font-loader-EKLzOJxf.cjs"),t=require("./pdf-ByVCb1i6.cjs");exports.clearFontCache=e.clearFontCache;exports.configureFontCache=e.configureFontCache;exports.getFontCacheStats=e.getFontCacheStats;exports.invalidateFontCache=e.invalidateFontCache;exports.loadFontWithCache=e.loadFontWithCache;exports.createFontBytesMeasurer=t.createFontBytesMeasurer;exports.renderPlanToPdf=t.renderPlanToPdf;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./font-loader-DBBJ5KE9.cjs"),t=require("./pdf-DqyxJ96U.cjs");exports.clearFontCache=e.clearFontCache;exports.configureFontCache=e.configureFontCache;exports.getFontCacheStats=e.getFontCacheStats;exports.invalidateFontCache=e.invalidateFontCache;exports.loadFontWithCache=e.loadFontWithCache;exports.createFontBytesMeasurer=t.createFontBytesMeasurer;exports.renderPlanToPdf=t.renderPlanToPdf;

package/dist/pdf.d.cts

@@ -1,3 +1,13 @@
+declare type AggregateOperation = "sum" | "count" | "avg" | "min" | "max" | "weightedAvg";
+
+declare interface AggregateRequest {
+    op: AggregateOperation;
+    field?: string;
+    weightField?: string;
+    numeric?: "number" | "decimal";
+    digits?: number;
+}
+
 declare interface AssetRenderBudget {
     /** Maximum newly rendered assets, default 1000. Existing imageData is kept unchanged. */
     maxAssets?: number;
@@ -11,6 +21,8 @@ declare interface AssetRenderBudget {
 
 declare interface AssetRenderOptions extends OutputDiagnosticOptions, ImageMediaOptions {
     assetRenderers?: Partial<Record<ImageComponentKind, ComponentImageRenderer>>;
+    /** Explicit id/version registry; unbound components continue using assetRenderers by kind. */
+    assetRegistry?: ComponentAssetRegistry;
     assetBudget?: AssetRenderBudget;
     /** Default throw prevents an incomplete export; placeholder retains the component and emits diagnostics. */
     assetFailure?: "throw" | "placeholder";
@@ -54,6 +66,11 @@ declare type ColumnFormat = {
     pattern?: string;
 };
 
+declare interface ComponentAssetRegistry {
+    rendererFor(component: Readonly<PlanComponent>): ComponentImageRenderer | undefined;
+    hasExtension(id: string, version: string, kind: string): boolean;
+}
+
 /** A literal own field of the current label record; expressions and paths are not evaluated. */
 declare interface ComponentBinding {
     field: string;
@@ -139,6 +156,12 @@ export declare interface FontLoadOptions {
 export declare function getFontCacheStats(): FontCacheStats;
 
 declare interface GridCell {
+    /** Resolved visual only. Original value, text, editability and source are unchanged. */
+    dataBar?: {
+        start: number;
+        end: number;
+        color: string;
+    };
     /** Styled cell content; text remains a plain-text fallback. Imported rich cells are read-only. */
     richParagraphs?: RichParagraph[];
     text?: string;
@@ -199,6 +222,11 @@ declare interface OutputDiagnostic {
     componentPath?: readonly number[];
     kind: string;
     nid?: string;
+    /** Declarative extension identity only; no property values or business binding data enter diagnostics. */
+    extension?: {
+        id: string;
+        version: string;
+    };
     message: string;
 }
 
@@ -251,6 +279,8 @@ export declare interface PdfRenderResult {
 }
 
 declare interface PlanComponent {
+    /** Template-only aggregate binding, expanded into shared primitives during layout. */
+    chartBinding?: ReportChartBinding;
     /** Optional QR/barcode encoding configuration; no encoder is loaded by the core. */
     code?: CodeOptions;
     /** Template-only binding; resolved and removed before constructing the output plan. */
@@ -339,6 +369,42 @@ declare interface ReportCellSource {
     sourceToken?: string;
 }
 
+/** Serializable binding; data and authorization continue to come from the existing report source. */
+declare interface ReportChartBinding {
+    dataset: string;
+    categoryField: string;
+    measures: readonly ReportChartMeasure[];
+    type: ReportChartOptions["type"];
+    sort?: "asc" | "desc";
+    title?: string;
+    showValues?: boolean;
+    maxRows?: number;
+    maxCategories?: number;
+}
+
+declare interface ReportChartMeasure extends AggregateRequest {
+    label?: string;
+    color?: string;
+}
+
+declare interface ReportChartOptions {
+    type: "bar" | "line" | "stackedBar" | "percentBar";
+    categories: readonly string[];
+    series: readonly ReportChartSeries[];
+    leftMm: number;
+    topMm: number;
+    widthMm: number;
+    heightMm: number;
+    title?: string;
+    showValues?: boolean;
+}
+
+declare interface ReportChartSeries {
+    name: string;
+    values: readonly (number | null)[];
+    color?: string;
+}
+
 declare interface RichParagraph {
     segments: RichSegment[];
     align?: ComponentStyle["align"];

package/dist/pdf.d.ts

@@ -1,3 +1,13 @@
+declare type AggregateOperation = "sum" | "count" | "avg" | "min" | "max" | "weightedAvg";
+
+declare interface AggregateRequest {
+    op: AggregateOperation;
+    field?: string;
+    weightField?: string;
+    numeric?: "number" | "decimal";
+    digits?: number;
+}
+
 declare interface AssetRenderBudget {
     /** Maximum newly rendered assets, default 1000. Existing imageData is kept unchanged. */
     maxAssets?: number;
@@ -11,6 +21,8 @@ declare interface AssetRenderBudget {
 
 declare interface AssetRenderOptions extends OutputDiagnosticOptions, ImageMediaOptions {
     assetRenderers?: Partial<Record<ImageComponentKind, ComponentImageRenderer>>;
+    /** Explicit id/version registry; unbound components continue using assetRenderers by kind. */
+    assetRegistry?: ComponentAssetRegistry;
     assetBudget?: AssetRenderBudget;
     /** Default throw prevents an incomplete export; placeholder retains the component and emits diagnostics. */
     assetFailure?: "throw" | "placeholder";
@@ -54,6 +66,11 @@ declare type ColumnFormat = {
     pattern?: string;
 };
 
+declare interface ComponentAssetRegistry {
+    rendererFor(component: Readonly<PlanComponent>): ComponentImageRenderer | undefined;
+    hasExtension(id: string, version: string, kind: string): boolean;
+}
+
 /** A literal own field of the current label record; expressions and paths are not evaluated. */
 declare interface ComponentBinding {
     field: string;
@@ -139,6 +156,12 @@ export declare interface FontLoadOptions {
 export declare function getFontCacheStats(): FontCacheStats;
 
 declare interface GridCell {
+    /** Resolved visual only. Original value, text, editability and source are unchanged. */
+    dataBar?: {
+        start: number;
+        end: number;
+        color: string;
+    };
     /** Styled cell content; text remains a plain-text fallback. Imported rich cells are read-only. */
     richParagraphs?: RichParagraph[];
     text?: string;
@@ -199,6 +222,11 @@ declare interface OutputDiagnostic {
     componentPath?: readonly number[];
     kind: string;
     nid?: string;
+    /** Declarative extension identity only; no property values or business binding data enter diagnostics. */
+    extension?: {
+        id: string;
+        version: string;
+    };
     message: string;
 }
 
@@ -251,6 +279,8 @@ export declare interface PdfRenderResult {
 }
 
 declare interface PlanComponent {
+    /** Template-only aggregate binding, expanded into shared primitives during layout. */
+    chartBinding?: ReportChartBinding;
     /** Optional QR/barcode encoding configuration; no encoder is loaded by the core. */
     code?: CodeOptions;
     /** Template-only binding; resolved and removed before constructing the output plan. */
@@ -339,6 +369,42 @@ declare interface ReportCellSource {
     sourceToken?: string;
 }
 
+/** Serializable binding; data and authorization continue to come from the existing report source. */
+declare interface ReportChartBinding {
+    dataset: string;
+    categoryField: string;
+    measures: readonly ReportChartMeasure[];
+    type: ReportChartOptions["type"];
+    sort?: "asc" | "desc";
+    title?: string;
+    showValues?: boolean;
+    maxRows?: number;
+    maxCategories?: number;
+}
+
+declare interface ReportChartMeasure extends AggregateRequest {
+    label?: string;
+    color?: string;
+}
+
+declare interface ReportChartOptions {
+    type: "bar" | "line" | "stackedBar" | "percentBar";
+    categories: readonly string[];
+    series: readonly ReportChartSeries[];
+    leftMm: number;
+    topMm: number;
+    widthMm: number;
+    heightMm: number;
+    title?: string;
+    showValues?: boolean;
+}
+
+declare interface ReportChartSeries {
+    name: string;
+    values: readonly (number | null)[];
+    color?: string;
+}
+
 declare interface RichParagraph {
     segments: RichSegment[];
     align?: ComponentStyle["align"];

package/dist/pdf.js

@@ -1,5 +1,5 @@
-import { clearFontCache as t, configureFontCache as o, getFontCacheStats as r, invalidateFontCache as n, loadFontWithCache as c } from "./font-loader-CzI1GuBc.js";
-import { c as F, r as s } from "./pdf-DJ5S6ukC.js";
+import { clearFontCache as t, configureFontCache as o, getFontCacheStats as r, invalidateFontCache as n, loadFontWithCache as c } from "./font-loader-DW8tIaNp.js";
+import { c as F, r as s } from "./pdf-CKROKygt.js";
 export {
   t as clearFontCache,
   o as configureFontCache,

package/dist/{plugin-C2j5_mhx.js → plugin-ByjF2kiV.js}

@@ -1,15 +1,15 @@
 import { defineAsyncComponent as c, computed as m } from "vue";
-import { b as i, c as l, a as s } from "./injection-keys-e85udZCp.js";
-import { g as d } from "./report-params-B1RzkhJj.js";
-const p = c(() => import("./ReportPreview-BcDKCLiK.js").then((r) => r.s)), _ = {
+import { b as i, c as l, a as d } from "./injection-keys-e85udZCp.js";
+import { g as s } from "./report-params-D9tBuM9B.js";
+const p = c(() => import("./ReportPreview-BxWWTUL5.js").then((r) => r.v)), _ = {
   install(r, e = {}) {
     let t = e.fetcher;
     if (!t && e.reports) {
       const f = e.reports;
       let n;
-      t = async (o) => (n ??= import("@agile-team/mach-report").then(({ createReportSource: a }) => a(f)), (await n)(o)), t.getParamDefs = (o) => d(f, o);
+      t = async (o) => (n ??= import("@agile-team/mach-report").then(({ createReportSource: a }) => a(f)), (await n)(o)), t.getParamDefs = (o) => s(f, o);
     }
-    t && r.provide(i, t), e.pdfExporter && r.provide(l, e.pdfExporter), r.provide(s, m(() => {
+    t && r.provide(i, t), e.pdfExporter && r.provide(l, e.pdfExporter), r.provide(d, m(() => {
       if (e.pdfFontUrl === void 0) return e.config ?? null;
       const f = e.config ?? { defaults: {}, presets: {} };
       return { ...f, defaults: { ...f.defaults, pdfFontUrl: e.pdfFontUrl } };

package/dist/{plugin-Dr39GBRG.cjs → plugin-DM1M2wlI.cjs}

@@ -1 +1 @@
-"use strict";var R=Object.create;var f=Object.defineProperty;var u=Object.getOwnPropertyDescriptor;var P=Object.getOwnPropertyNames;var d=Object.getPrototypeOf,p=Object.prototype.hasOwnProperty;var m=(r,e,t,n)=>{if(e&&typeof e=="object"||typeof e=="function")for(let o of P(e))!p.call(r,o)&&o!==t&&f(r,o,{get:()=>e[o],enumerable:!(n=u(e,o))||n.enumerable});return r};var E=(r,e,t)=>(t=r!=null?R(d(r)):{},m(e||!r||!r.__esModule?f(t,"default",{value:r,enumerable:!0}):t,r));const l=require("vue"),i=require("./injection-keys-Db_DyLkm.cjs"),h=require("./report-params-WDGrA4oP.cjs"),s=l.defineAsyncComponent(()=>Promise.resolve().then(()=>require("./ReportPreview-Bk9nLfO9.cjs")).then(r=>r.ReportPreview$1)),v={install(r,e={}){let t=e.fetcher;if(!t&&e.reports){const n=e.reports;let o;t=async c=>(o??=import("@agile-team/mach-report").then(({createReportSource:a})=>a(n)),(await o)(c)),t.getParamDefs=c=>h.getReportParamDefs(n,c)}t&&r.provide(i.MACH_REPORT_FETCHER_KEY,t),e.pdfExporter&&r.provide(i.MACH_REPORT_PDF_EXPORTER_KEY,e.pdfExporter),r.provide(i.MACH_REPORT_CONFIG_KEY,l.computed(()=>{if(e.pdfFontUrl===void 0)return e.config??null;const n=e.config??{defaults:{},presets:{}};return{...n,defaults:{...n.defaults,pdfFontUrl:e.pdfFontUrl}}})),e.globalComponent!==!1&&!r.component("MachReportPreview")&&r.component("MachReportPreview",s)}};exports.MachReportPreview=s;exports.machReportPlugin=v;
+"use strict";var R=Object.create;var f=Object.defineProperty;var u=Object.getOwnPropertyDescriptor;var P=Object.getOwnPropertyNames;var d=Object.getPrototypeOf,p=Object.prototype.hasOwnProperty;var m=(r,e,t,n)=>{if(e&&typeof e=="object"||typeof e=="function")for(let o of P(e))!p.call(r,o)&&o!==t&&f(r,o,{get:()=>e[o],enumerable:!(n=u(e,o))||n.enumerable});return r};var E=(r,e,t)=>(t=r!=null?R(d(r)):{},m(e||!r||!r.__esModule?f(t,"default",{value:r,enumerable:!0}):t,r));const l=require("vue"),i=require("./injection-keys-Db_DyLkm.cjs"),h=require("./report-params-VTg8MoCp.cjs"),s=l.defineAsyncComponent(()=>Promise.resolve().then(()=>require("./ReportPreview-Yf99omi3.cjs")).then(r=>r.ReportPreview$1)),v={install(r,e={}){let t=e.fetcher;if(!t&&e.reports){const n=e.reports;let o;t=async c=>(o??=import("@agile-team/mach-report").then(({createReportSource:a})=>a(n)),(await o)(c)),t.getParamDefs=c=>h.getReportParamDefs(n,c)}t&&r.provide(i.MACH_REPORT_FETCHER_KEY,t),e.pdfExporter&&r.provide(i.MACH_REPORT_PDF_EXPORTER_KEY,e.pdfExporter),r.provide(i.MACH_REPORT_CONFIG_KEY,l.computed(()=>{if(e.pdfFontUrl===void 0)return e.config??null;const n=e.config??{defaults:{},presets:{}};return{...n,defaults:{...n.defaults,pdfFontUrl:e.pdfFontUrl}}})),e.globalComponent!==!1&&!r.component("MachReportPreview")&&r.component("MachReportPreview",s)}};exports.MachReportPreview=s;exports.machReportPlugin=v;

package/dist/prefill-B8H9qwE4.js

@@ -0,0 +1,371 @@
+import { v as q, G as O, n as V, N as Z, O as T } from "./json-snapshot-By4ZVVUt.js";
+import { r as B } from "./grid-geometry-BNptEcMm.js";
+import { d as $, p as S, a as H, j as P, g as J } from "./computed-C8NRZQss.js";
+function I(e) {
+  return Number.isFinite(e) ? Math.max(0, e) : 0;
+}
+function ce(e, t = 0) {
+  const r = e.length, o = I(t), n = new Array(r + 1);
+  n[0] = 0;
+  for (let i = 0; i < r; i++)
+    n[i + 1] = n[i] + I(e[i] ?? 0) + o;
+  const a = n[r];
+  function s(i) {
+    let c = 0, u = r - 1, p = 0;
+    for (; c <= u; ) {
+      const f = c + u >>> 1;
+      n[f] <= i ? (p = f, c = f + 1) : u = f - 1;
+    }
+    return p;
+  }
+  function l(i, c, u = 1) {
+    if (r === 0) return { start: 0, end: -1, padTopPx: 0, padBottomPx: 0 };
+    const p = Math.floor(I(u)), f = I(c), g = s(f), m = Math.max(0, g - p), b = f + I(i);
+    let w = g, x = r - 1, F = r - 1;
+    for (; w <= x; ) {
+      const R = w + x >>> 1;
+      n[R + 1] < b ? w = R + 1 : (F = R, x = R - 1);
+    }
+    const C = Math.min(r - 1, F + p);
+    return {
+      start: m,
+      end: C,
+      padTopPx: n[m],
+      padBottomPx: Math.max(0, a - n[C + 1])
+    };
+  }
+  return {
+    totalHeightPx: a,
+    pageAt: s,
+    offsetAt: (i) => n[Math.max(0, Math.min(r, Math.floor(i)))] ?? 0,
+    window: l
+  };
+}
+class h extends Error {
+  constructor(t) {
+    super(`Report drill: ${t}`), this.code = t, this.name = "ReportDrillError";
+  }
+}
+function v(e) {
+  return typeof e == "string" && e.trim().length > 0 && e.length <= 256;
+}
+function G(e) {
+  if (typeof e == "number" && Number.isFinite(e) || typeof e == "boolean") return String(e);
+  if (typeof e == "string" && e.length > 0 && e.length <= 4096) return e;
+  throw new h("missing-value");
+}
+function Q(e, t) {
+  return Object.getOwnPropertyDescriptor(e, t)?.value;
+}
+function L(e) {
+  if (!Array.isArray(e) || e.length > 64) throw new h("config");
+  const t = /* @__PURE__ */ new Set();
+  for (const r of e) {
+    if (!r || !v(r.id) || !v(r.label) || !r.target || !v(r.target.field) || t.has(r.id)) throw new h("config");
+    t.add(r.id);
+    const o = r.target;
+    if (o.datasetId !== void 0 && !v(o.datasetId) || o.reportScope !== void 0 && !v(o.reportScope)) throw new h("config");
+    if (o.roles !== void 0 && (!Array.isArray(o.roles) || o.roles.length > 16 || o.roles.some((n) => !v(n)))) throw new h("config");
+    X(r.params);
+  }
+}
+function X(e) {
+  if (e !== void 0) {
+    if (!e || typeof e != "object" || Array.isArray(e) || Object.keys(e).length > 32) throw new h("config");
+    for (const [t, r] of Object.entries(e)) {
+      if (!v(t) || ["__proto__", "constructor", "prototype"].includes(t) || !r || typeof r != "object") throw new h("config");
+      if ("value" in r)
+        try {
+          G(r.value);
+        } catch {
+          throw new h("config");
+        }
+      else if (!["value", "rowKey", "query", "field"].includes(r.from) || (r.from === "query" || r.from === "field") && !v(r.field)) throw new h("config");
+    }
+  }
+}
+function U(e, t, r) {
+  const { target: o } = r, n = t.source?.datasetId ?? t.component.table?.source?.datasetId;
+  return (t.source?.field ?? t.table?.columnKey) === o.field && (o.datasetId === void 0 || n === o.datasetId) && (o.reportScope === void 0 || e.pages[t.address.pageIndex]?.meta?.reportScope === o.reportScope) && (o.roles ? o.roles.includes(t.table?.role ?? "") : t.table?.role !== "header");
+}
+function le(e, t, r) {
+  L(r);
+  const o = q(e, t);
+  return o ? r.filter((n) => U(e, o, n)) : [];
+}
+function Y(e, t, r, o) {
+  if ("value" in e) return e.value;
+  switch (e.from) {
+    case "value":
+      return r.value;
+    case "rowKey":
+      return r.source?.rowKey;
+    case "query":
+      return Q(o, e.field);
+    case "field": {
+      const n = r.component.table?.columnKeys.indexOf(e.field) ?? -1;
+      return n < 0 ? void 0 : q(t, { ...r.address, columnIndex: n })?.value;
+    }
+  }
+}
+function de(e, t, r, o = {}) {
+  L([r]);
+  const n = q(e, t);
+  if (!n || !U(e, n, r)) throw new h("target");
+  const a = Object.fromEntries(Object.entries(r.params ?? {}).map(([i, c]) => [i, G(Y(c, e, n, o))])), s = Object.entries(o);
+  if (s.length > 128 || s.some(([i, c]) => !v(i) || typeof c != "string" || c.length > 4096)) throw new h("config");
+  const l = e.pages[t.pageIndex]?.meta?.reportScope;
+  return Object.freeze({ actionId: r.id, params: Object.freeze(a), returnState: Object.freeze({
+    params: Object.freeze(Object.fromEntries(s)),
+    address: Object.freeze({ ...t }),
+    ...typeof l == "string" ? { reportScope: l } : {},
+    ...n.source ? { source: Object.freeze({ sourceScope: n.source.sourceScope, datasetId: n.source.datasetId, rowKey: n.source.rowKey, field: n.source.field }) } : {}
+  }) });
+}
+function ue(e, t) {
+  if (!t.source) return e.pages[t.address.pageIndex]?.meta?.reportScope === t.reportScope && q(e, t.address) ? { ...t.address } : null;
+  const r = V(e), o = O({ address: t.address, source: t.source });
+  for (const [n, a] of e.pages.entries())
+    if (!(t.reportScope !== void 0 && a.meta?.reportScope !== t.reportScope)) {
+      for (const [s, l] of a.components.entries())
+        if (l.grid)
+          for (const i of B(l.grid, l.widthMm, l.heightMm).cells) {
+            const c = { pageIndex: n, componentIndex: s, rowIndex: i.ri, columnIndex: i.ci }, u = r(c);
+            if (u?.source && O(u) === o) return c;
+          }
+    }
+  return null;
+}
+class d extends Error {
+  constructor(t, r) {
+    super(r), this.code = t, this.name = "ReportDataError";
+  }
+}
+function y(e, t, r) {
+  const o = e ?? t;
+  if (!Number.isSafeInteger(o) || o < 1 || o > r) throw new d("limit", "Invalid report data budget");
+  return o;
+}
+function z(e) {
+  if (typeof e == "string" && e.length > 0 && e.length <= 2048) return `s:${e}`;
+  if (typeof e == "number" && Number.isSafeInteger(e)) return `n:${Object.is(e, -0) ? 0 : e}`;
+  throw new d("identity", "A stable string or safe integer business key is required");
+}
+function D(e) {
+  if (typeof e.datasetId != "string" || !e.datasetId.trim() || e.datasetId.length > 2048) throw new d("identity", "A dataset identity is required");
+  if (e.sourceScope !== void 0 && (typeof e.sourceScope != "string" || !e.sourceScope.trim() || e.sourceScope.length > 2048)) throw new d("identity", "Invalid source scope");
+}
+function j(e, t = 256) {
+  if (!Array.isArray(e) || !e.length || e.length > t) throw new d("limit", "A bounded explicit field allowlist is required");
+  const r = /* @__PURE__ */ new Set();
+  for (const o of e) {
+    if (typeof o != "string" || !o.trim() || o.length > 2048 || ["__proto__", "constructor", "prototype"].includes(o)) throw new d("identity", "Invalid report field");
+    if (r.has(o)) throw new d("duplicate", "Duplicate report field");
+    r.add(o);
+  }
+}
+function K(e, t) {
+  const r = Object.getOwnPropertyDescriptor(e.values, t);
+  if (!r) return;
+  if (!("value" in r)) throw new d("value", "Report values must be plain scalar data");
+  const o = r.value;
+  if (o === null || typeof o == "boolean" || typeof o == "string" || typeof o == "number" && Number.isFinite(o)) return o;
+  throw new d("value", "Report values must be finite scalar data");
+}
+function ee(e) {
+  if (!e || typeof e != "object" || ![Object.prototype, null].includes(Object.getPrototypeOf(e))) throw new d("value", "Report records must be plain data");
+  const t = Object.getOwnPropertyDescriptor(e, "rowKey"), r = Object.getOwnPropertyDescriptor(e, "values");
+  if (!t || !("value" in t) || !r || !("value" in r) || !r.value || typeof r.value != "object" || ![Object.prototype, null].includes(Object.getPrototypeOf(r.value))) throw new d("value", "Report records require own scalar keys and plain values");
+  return { rowKey: t.value, values: r.value };
+}
+function A(e, t, r = {}) {
+  const o = y(r.maxRows, 5e4, 1e5), n = y(r.maxCells, 1e6, 2e6);
+  if (!Array.isArray(e) || Object.getPrototypeOf(e) !== Array.prototype || e.length > o || e.length * t.length > n) throw new d("limit", "Report data exceeds its budget");
+  const a = /* @__PURE__ */ new Map();
+  for (let s = 0; s < e.length; s++) {
+    const l = Object.getOwnPropertyDescriptor(e, s);
+    if (!l || !("value" in l)) throw new d("value", "Sparse or accessor report records are unsupported");
+    const i = ee(l.value), c = z(i.rowKey);
+    if (a.has(c)) throw new d("duplicate", "Duplicate business row key");
+    const u = /* @__PURE__ */ Object.create(null);
+    for (const p of t) {
+      const f = K(i, p);
+      f !== void 0 && (u[p] = f);
+    }
+    a.set(c, { rowKey: i.rowKey, values: u });
+  }
+  return a;
+}
+function k(e) {
+  return e == null || e === "";
+}
+function E(e, t) {
+  return k(e) ? t.missing === "zero" ? S(0) : void 0 : S(e);
+}
+function te(e) {
+  return { coefficient: -e.coefficient, scale: e.scale };
+}
+function re(e, t, r, o) {
+  const n = E(e, r), a = Object.is(e, t) ? n : E(t, r);
+  if (!n || !a) return { equal: W(e, t, r), ratioUnavailable: "missing" };
+  const s = H(a, te(n)), l = { ...s, coefficient: s.coefficient < 0n ? -s.coefficient : s.coefficient }, i = $(l, r.toleranceValue) <= 0;
+  return i && !o ? { equal: i } : n.coefficient === 0n ? { equal: i, delta: P(s), ...s.coefficient === 0n && r.zeroDenominator === "zero-if-equal" ? { changeRatio: "0" } : { ratioUnavailable: "zero-denominator" } } : { equal: i, delta: P(s), changeRatio: P(J(s, n, r.ratioDigits ?? 12)) };
+}
+function W(e, t, r) {
+  return r.missing === "empty-equivalent" && k(e) && k(t) || Object.is(e, t);
+}
+function oe(e) {
+  j(e.fields.map((t) => t.field), y(e.maxFields, 256, 1024));
+  for (const t of e.fields) {
+    if (t.type !== void 0 && !["decimal", "value"].includes(t.type)) throw new d("value", "Invalid comparison field type");
+    if (t.missing && !["distinct", "empty-equivalent", "zero"].includes(t.missing)) throw new d("value", "Invalid missing-value policy");
+    if (t.zeroDenominator && !["omit", "zero-if-equal"].includes(t.zeroDenominator)) throw new d("value", "Invalid zero-denominator policy");
+    if (t.missing === "zero" && t.type !== "decimal") throw new d("value", "Zero missing-value policy requires a decimal field");
+    if (t.tolerance !== void 0 && (t.type !== "decimal" || $(S(t.tolerance), S(0)) < 0)) throw new d("value", "Tolerance requires a non-negative decimal");
+    if (t.ratioDigits !== void 0 && (!Number.isInteger(t.ratioDigits) || t.ratioDigits < 0 || t.ratioDigits > 100)) throw new d("value", "Invalid ratio precision");
+  }
+  return e.fields.map((t) => ({ ...t, toleranceValue: S(t.tolerance ?? "0") }));
+}
+function _(e, t, r, o, n) {
+  let a = !1;
+  for (const s of r) {
+    const l = e ? K(e, s.field) : void 0, i = t ? K(t, s.field) : void 0, c = s.type === "decimal" ? re(l, i, s, !e || !t) : { equal: W(l, i, s) };
+    if (e && t && c.equal) continue;
+    if (a = !0, o.length >= n) throw new d("limit", "Report differences exceed their budget");
+    const { equal: u, ...p } = c;
+    o.push({ rowKey: (t ?? e).rowKey, kind: e ? t ? "changed" : "removed" : "added", field: s.field, label: s.label ?? s.field, before: l, after: i, ...p });
+  }
+  return a;
+}
+function fe(e, t, r) {
+  D(e), D(t);
+  const o = oe(r);
+  if (e.datasetId !== t.datasetId || e.sourceScope !== t.sourceScope) throw new d("identity", "Comparison requires the same business dataset and source scope");
+  const n = r.fields.map((u) => u.field), a = A(e.rows, n, r), s = A(t.rows, n, r), l = y(r.maxDifferences, 2e4, 1e5), i = [], c = { added: 0, removed: 0, changed: 0, unchanged: 0, cells: 0 };
+  for (const [u, p] of a) {
+    const f = s.get(u), g = _(p, f, o, i, l);
+    f ? g ? c.changed++ : c.unchanged++ : c.removed++;
+  }
+  for (const [u, p] of s) a.has(u) || (_(void 0, p, o, i, l), c.added++);
+  return c.cells = i.length, { sourceScope: t.sourceScope, datasetId: t.datasetId, differences: i, counts: c };
+}
+function M(e, t) {
+  D(t), j(t.fields, y(t.maxFields, 256, 1024));
+  const r = y(t.maxCells, 1e6, 2e6), o = new Set(t.fields), n = /* @__PURE__ */ new Map(), a = V(e);
+  let s = 0;
+  for (const [l, i] of e.pages.entries()) for (const [c, u] of i.components.entries()) {
+    if (!u.grid) continue;
+    for (const f of u.grid.cells)
+      if (s += f.length, s > r) throw new d("limit", "Report cell scan exceeds its budget");
+    const p = B(u.grid, u.widthMm, u.heightMm).cells;
+    for (const f of p) {
+      const g = a({ pageIndex: l, componentIndex: c, rowIndex: f.ri, columnIndex: f.ci }), m = g?.source;
+      if (!g || !m || m.datasetId !== t.datasetId || m.sourceScope !== t.sourceScope || !o.has(m.field)) continue;
+      z(m.rowKey);
+      const b = O(g), w = n.get(b);
+      w ? (!Object.is(w.context.value, g.value) || w.context.source?.revision !== m.revision || w.context.source?.sourceToken !== m.sourceToken || w.context.editable !== g.editable) && (w.ambiguous = !0) : n.set(b, { context: g, ambiguous: !1 });
+    }
+  }
+  return n;
+}
+function pe(e, t) {
+  const r = M(e, t), o = /* @__PURE__ */ new Map(), n = y(t.maxRows, 5e4, 1e5);
+  for (const { context: a, ambiguous: s } of r.values()) {
+    if (s) throw new d("conflict", "Repeated report cells disagree for the same business field");
+    const l = a.source, i = z(l.rowKey);
+    let c = o.get(i);
+    if (!c) {
+      if (o.size >= n) throw new d("limit", "Report row extraction exceeds its budget");
+      c = { rowKey: l.rowKey, values: /* @__PURE__ */ Object.create(null) }, o.set(i, c);
+    }
+    c.values[l.field] = a.value;
+  }
+  return { sourceScope: t.sourceScope, datasetId: t.datasetId, rows: [...o.values()] };
+}
+function N(e) {
+  return e == null || e === "";
+}
+function ne(e, t, r) {
+  if (!t) {
+    e.reason = "missing-target";
+    return;
+  }
+  const { context: o, ambiguous: n } = t;
+  if (e.before = o.value, n) {
+    e.status = "conflict", e.reason = "ambiguous";
+    return;
+  }
+  if (!o.editable || r.canEdit?.(o) === !1) {
+    e.reason = "readonly";
+    return;
+  }
+  if (N(e.after)) {
+    e.reason = "missing-source";
+    return;
+  }
+  if (Object.is(o.value, e.after)) {
+    e.status = "matched", e.reason = "unchanged";
+    return;
+  }
+  if (r.mode !== "replace" && !N(o.value)) {
+    e.reason = "occupied";
+    return;
+  }
+  try {
+    const a = T(o, e.after);
+    if (Object.is(a.value, a.previousValue)) {
+      e.status = "matched", e.reason = "unchanged";
+      return;
+    }
+    return e.after = a.value, e.status = "changed", a;
+  } catch {
+    e.status = "conflict", e.reason = "invalid";
+    return;
+  }
+}
+function ge(e, t) {
+  if (D(t), t.mode !== void 0 && t.mode !== "empty" && t.mode !== "replace") throw new d("value", "Invalid prefill policy");
+  const r = y(t.maxFields, 256, 1024), o = t.fields.map((f) => f.field), n = [...new Set(t.fields.map((f) => f.sourceField ?? f.field))];
+  j(o, r), j(n, r);
+  const a = A(t.rows, n, t), s = M(e, { ...t, fields: o }), l = y(t.maxChanges, 1e4, 1e4), i = y(t.maxCells, 1e6, 2e6);
+  if (a.size * o.length > i) throw new d("limit", "Prefill review exceeds its budget");
+  const c = [], u = [], p = { matched: 0, changed: 0, skipped: 0, conflict: 0 };
+  for (const f of a.values()) for (const g of t.fields) {
+    const m = { sourceScope: t.sourceScope, datasetId: t.datasetId, rowKey: f.rowKey, field: g.field }, b = { source: m, label: g.label ?? g.field, status: "skipped", after: K(f, g.sourceField ?? g.field) }, w = O({ address: { pageIndex: 0, componentIndex: 0, rowIndex: 0, columnIndex: 0 }, source: m }), x = ne(b, s.get(w), t);
+    if (x) {
+      if (u.length >= l) throw new d("limit", "Prefill changes exceed the atomic edit budget");
+      u.push(x);
+    }
+    p[b.status]++, c.push(b);
+  }
+  return { sourceScope: t.sourceScope, datasetId: t.datasetId, items: c, counts: p, edits: u };
+}
+function me(e, t, r) {
+  if (t.counts.conflict > 0) throw new d("conflict", "Resolve prefill conflicts before applying");
+  if (t.edits.length > 1e4) throw new d("limit", "Prefill changes exceed the atomic edit budget");
+  if (!t.edits.length) return [];
+  const o = [...new Set(t.edits.map((s) => s.source.field))], n = M(e, { sourceScope: t.sourceScope, datasetId: t.datasetId, fields: o }), a = /* @__PURE__ */ new Set();
+  return t.edits.map((s) => {
+    if (!s.source || s.source.datasetId !== t.datasetId || s.source.sourceScope !== t.sourceScope) throw new d("identity", "Prefill identity changed");
+    const l = O(s), i = n.get(l);
+    if (a.has(l)) throw new d("duplicate", "Duplicate prefill target");
+    if (a.add(l), !i || i.ambiguous || Z(i.context, s) || !Object.is(i.context.value, s.previousValue)) throw new d("conflict", "Prefill target changed; reload the preview");
+    if (!i.context.editable || r?.(i.context) === !1) throw new d("conflict", "Prefill target is read-only");
+    return { address: { ...i.context.address }, value: T(i.context, s.value).value };
+  });
+}
+export {
+  d as R,
+  h as a,
+  fe as b,
+  ce as c,
+  de as d,
+  ge as e,
+  me as f,
+  ue as g,
+  y as h,
+  M as i,
+  le as m,
+  pe as r,
+  L as v
+};