react-semaphor 0.1.443 → 0.1.445

package/dist/chunks/pivot-result-lifecycle-BM3Pl-D1.js

@@ -0,0 +1,914 @@
+var V = Object.defineProperty;
+var U = (e, t, n) => t in e ? V(e, t, { enumerable: !0, configurable: !0, writable: !0, value: n }) : e[t] = n;
+var w = (e, t, n) => U(e, typeof t != "symbol" ? t + "" : t, n);
+import { t as y, c as B, e as Z, g as D, m as L, a as b, b as q, i as G, d as X, f as H, h as Y } from "./format-types-CZH5w1lo.js";
+import { b as h } from "./presentation-execution-CGlb7YZ6.js";
+import { f as W } from "./temporal-bucket-BnPxGrAi.js";
+import { m as J } from "./validators-wZ2WlNHc.js";
+import "./analyze-result-contract-DUv3QnMl.js";
+import { a as Q } from "./metric-comparison-BJ_Qu1ZF.js";
+import { b as z } from "./temporal-bucket-contract-B2bJ1oe4.js";
+import { d as ee, P as te } from "./pivot-result-identity-B6QCWOSi.js";
+function M(e, t) {
+  const n = y(e), o = y(t), r = n.getTime() - o.getTime();
+  return r < 0 ? -1 : r > 0 ? 1 : r;
+}
+function ne(e) {
+  return B(e, Date.now());
+}
+function re(e, t) {
+  const n = y(e), o = y(t), r = n.getFullYear() - o.getFullYear(), s = n.getMonth() - o.getMonth();
+  return r * 12 + s;
+}
+function oe(e) {
+  return (t) => {
+    const o = (e ? Math[e] : Math.trunc)(t);
+    return o === 0 ? 0 : o;
+  };
+}
+function se(e, t) {
+  return +y(e) - +y(t);
+}
+function ie(e) {
+  const t = y(e);
+  return t.setHours(23, 59, 59, 999), t;
+}
+function ae(e) {
+  const t = y(e), n = t.getMonth();
+  return t.setFullYear(t.getFullYear(), n + 1, 0), t.setHours(23, 59, 59, 999), t;
+}
+function ce(e) {
+  const t = y(e);
+  return +ie(t) == +ae(t);
+}
+function le(e, t) {
+  const n = y(e), o = y(t), r = M(n, o), s = Math.abs(
+    re(n, o)
+  );
+  let a;
+  if (s < 1)
+    a = 0;
+  else {
+    n.getMonth() === 1 && n.getDate() > 27 && n.setDate(30), n.setMonth(n.getMonth() - r * s);
+    let i = M(n, o) === -r;
+    ce(y(e)) && s === 1 && M(e, o) === 1 && (i = !1), a = r * (s - Number(i));
+  }
+  return a === 0 ? 0 : a;
+}
+function ue(e, t, n) {
+  const o = se(e, t) / 1e3;
+  return oe(n == null ? void 0 : n.roundingMethod)(o);
+}
+function fe(e, t, n) {
+  const o = q(), r = (n == null ? void 0 : n.locale) ?? o.locale ?? Z, s = 2520, a = M(e, t);
+  if (isNaN(a))
+    throw new RangeError("Invalid time value");
+  const i = Object.assign({}, n, {
+    addSuffix: n == null ? void 0 : n.addSuffix,
+    comparison: a
+  });
+  let c, f;
+  a > 0 ? (c = y(t), f = y(e)) : (c = y(e), f = y(t));
+  const m = ue(f, c), d = (D(f) - D(c)) / 1e3, u = Math.round((m - d) / 60);
+  let p;
+  if (u < 2)
+    return n != null && n.includeSeconds ? m < 5 ? r.formatDistance("lessThanXSeconds", 5, i) : m < 10 ? r.formatDistance("lessThanXSeconds", 10, i) : m < 20 ? r.formatDistance("lessThanXSeconds", 20, i) : m < 40 ? r.formatDistance("halfAMinute", 0, i) : m < 60 ? r.formatDistance("lessThanXMinutes", 1, i) : r.formatDistance("xMinutes", 1, i) : u === 0 ? r.formatDistance("lessThanXMinutes", 1, i) : r.formatDistance("xMinutes", u, i);
+  if (u < 45)
+    return r.formatDistance("xMinutes", u, i);
+  if (u < 90)
+    return r.formatDistance("aboutXHours", 1, i);
+  if (u < L) {
+    const g = Math.round(u / 60);
+    return r.formatDistance("aboutXHours", g, i);
+  } else {
+    if (u < s)
+      return r.formatDistance("xDays", 1, i);
+    if (u < b) {
+      const g = Math.round(u / L);
+      return r.formatDistance("xDays", g, i);
+    } else if (u < b * 2)
+      return p = Math.round(u / b), r.formatDistance("aboutXMonths", p, i);
+  }
+  if (p = le(f, c), p < 12) {
+    const g = Math.round(u / b);
+    return r.formatDistance("xMonths", g, i);
+  } else {
+    const g = p % 12, x = Math.trunc(p / 12);
+    return g < 3 ? r.formatDistance("aboutXYears", x, i) : g < 9 ? r.formatDistance("overXYears", x, i) : r.formatDistance("almostXYears", x + 1, i);
+  }
+}
+function de(e, t) {
+  return fe(e, ne(e), t);
+}
+const F = [
+  "day",
+  "hour",
+  "minute",
+  "second",
+  "millisecond"
+], R = {
+  day: 864e5,
+  hour: 36e5,
+  minute: 6e4,
+  second: 1e3,
+  millisecond: 1
+}, me = {
+  day: "d",
+  hour: "hr",
+  minute: "min",
+  second: "s",
+  millisecond: "ms"
+}, ye = {
+  day: ["day", "days"],
+  hour: ["hour", "hours"],
+  minute: ["minute", "minutes"],
+  second: ["second", "seconds"],
+  millisecond: ["millisecond", "milliseconds"]
+};
+function ge(e) {
+  return e === "day" || e === "hour" || e === "minute" || e === "second" || e === "millisecond";
+}
+function P(e, t) {
+  return ge(e) ? e : t;
+}
+function I(e, t) {
+  return F.indexOf(P(e, t));
+}
+function pe(e, t) {
+  const n = I(e, "day"), o = I(t, "second"), r = Math.min(n, o), s = Math.max(n, o);
+  return F.slice(r, s + 1);
+}
+function he(e, t) {
+  return e * R[P(t, "second")];
+}
+function we(e, t) {
+  const n = pe(t.largestUnit, t.smallestUnit), o = n[n.length - 1], r = R[o];
+  let s = Math.round(e / r) * r;
+  return n.map((a) => {
+    const i = R[a], c = Math.floor(s / i);
+    return s -= c * i, { unit: a, value: c };
+  });
+}
+function be(e, t) {
+  const n = e.filter((s) => s.value !== 0), o = n.length > 0 ? n : [e[e.length - 1]], r = typeof t == "number" && Number.isFinite(t) ? Math.max(1, Math.trunc(t)) : o.length;
+  return o.slice(0, r).map((s) => `${s.value}${me[s.unit]}`).join(" ");
+}
+function ve(e, t) {
+  const n = e.filter((s) => s.value !== 0), o = n.length > 0 ? n : [e[e.length - 1]], r = typeof t == "number" && Number.isFinite(t) ? Math.max(1, Math.trunc(t)) : o.length;
+  return o.slice(0, r).map((s) => {
+    const [a, i] = ye[s.unit];
+    return `${s.value} ${s.value === 1 ? a : i}`;
+  }).join(" ");
+}
+function Me(e) {
+  const t = e.some(
+    (c) => c.unit === "day" && c.value !== 0
+  ), n = e.some((c) => c.unit === "millisecond"), o = e.findIndex((c) => c.value !== 0), r = Math.max(0, e.length - 2), s = t ? 0 : o === -1 ? r : Math.min(o, r), a = o === -1 ? e.slice(r) : e.slice(s);
+  if (a.length === 0)
+    return "0";
+  const i = a.map((c, f) => c.unit === "millisecond" ? String(c.value).padStart(3, "0") : f === 0 ? String(c.value) : String(c.value).padStart(2, "0")).join(":");
+  return n ? i.replace(/:(\d{3})$/, ".$1") : i;
+}
+function Ae(e, t, n) {
+  const o = `${n.prefix || ""}${e}${n.suffix || ""}`;
+  return t ? n.negativeInParentheses ? `(${o})` : `-${o}` : o;
+}
+function xe(e, t = {}) {
+  if (e == null)
+    return "";
+  const n = typeof e == "number" ? e : typeof e == "string" && e.trim() ? Number(e) : NaN;
+  if (!Number.isFinite(n))
+    return "";
+  const o = t.inputUnit || "second", r = t.outputStyle === "digital" || t.outputStyle === "long" ? t.outputStyle : "compact", s = n < 0, a = Math.abs(he(n, o)), i = we(a, t), c = r === "digital" ? Me(i) : r === "long" ? ve(i, t.maxUnits) : be(i, t.maxUnits);
+  return Ae(c, s, t);
+}
+function Ce(e, t, n) {
+  const o = {
+    ...t,
+    locale: t.locale ?? n
+  };
+  if (o.type === "number")
+    return h(e, o);
+  const { prefix: r, suffix: s, ...a } = o;
+  return `${r ?? ""}${h(e, {
+    ...a,
+    negativeStyle: o.type === "currency" ? o.negativeStyle : "minus"
+  })}${s ?? ""}`;
+}
+function C(e, t, n) {
+  return e === null ? { value: e, text: null } : !t || !G(t) && t.type !== "duration" ? {
+    value: e,
+    text: h(e, { type: "number", locale: n })
+  } : t.type === "duration" ? {
+    value: e,
+    text: xe(e, {
+      inputUnit: t.inputUnit,
+      outputStyle: t.outputStyle,
+      largestUnit: t.largestUnit,
+      smallestUnit: t.smallestUnit,
+      maxUnits: t.maxUnits,
+      prefix: t.prefix,
+      suffix: t.suffix,
+      negativeInParentheses: t.negativeStyle === "parentheses"
+    })
+  } : { value: e, text: Ce(e, t, n) };
+}
+function _(e, t, n, o) {
+  return e === null ? { value: e, text: null } : o === "percent" ? {
+    value: e,
+    text: h(e, {
+      type: "percent",
+      locale: n,
+      minimumFractionDigits: t,
+      maximumFractionDigits: t,
+      percentValueMode: "fraction"
+    })
+  } : {
+    value: e,
+    text: h(e, {
+      type: "number",
+      locale: n,
+      minimumFractionDigits: t,
+      maximumFractionDigits: t,
+      suffix: "×"
+    })
+  };
+}
+function T(e, t) {
+  if (e === void 0) return t;
+  if (!Number.isInteger(e) || e < 0 || e > 6)
+    throw new RangeError("Comparison precision must be an integer from 0 to 6.");
+  return e;
+}
+function Ye(e, t) {
+  const n = {
+    mode: t.displayMode,
+    current: C(
+      e.currentValue,
+      t.metricFormat,
+      t.locale
+    ),
+    comparison: C(
+      e.comparisonValue,
+      t.metricFormat,
+      t.locale
+    )
+  };
+  return (t.displayMode === "difference" || t.displayMode === "both") && (n.difference = C(
+    e.delta,
+    t.metricFormat,
+    t.locale
+  )), (t.displayMode === "percent_change" || t.displayMode === "both") && (n.percentChange = _(
+    e.percentChange,
+    T(t.precision, 1),
+    t.locale,
+    "percent"
+  )), t.displayMode === "ratio" && (n.ratio = _(
+    e.ratio,
+    T(t.precision, 2),
+    t.locale,
+    "ratio"
+  )), n;
+}
+function We(e, t) {
+  return e && e !== "auto" ? e : t;
+}
+function Je(e, t = /* @__PURE__ */ new Date()) {
+  try {
+    const n = {
+      timeZone: e,
+      timeZoneName: "short"
+    }, r = new Intl.DateTimeFormat("en-US", n).formatToParts(t).find((s) => s.type === "timeZoneName");
+    return (r == null ? void 0 : r.value) || e;
+  } catch {
+    return e;
+  }
+}
+function Qe(e) {
+  try {
+    const t = {
+      timeZone: e,
+      timeZoneName: "long"
+    }, o = new Intl.DateTimeFormat("en-US", t).formatToParts(
+      /* @__PURE__ */ new Date()
+    ).find((r) => r.type === "timeZoneName");
+    return (o == null ? void 0 : o.value) || e;
+  } catch {
+    return e;
+  }
+}
+function K(e, t = "auto") {
+  if (!e)
+    return /* @__PURE__ */ new Date(NaN);
+  const n = e.endsWith("Z"), o = /[+-]\d{2}:?\d{2}$/.test(e), r = /\([A-Z]{3,4}\)$/.test(e);
+  if (t === "auto")
+    return n || o || r ? new Date(e) : /* @__PURE__ */ new Date(e + "Z");
+  if (t === "local") {
+    if (n || o) {
+      const s = e.replace(/Z$/, "").replace(/[+-]\d{2}:?\d{2}$/, "");
+      return new Date(s);
+    }
+    return new Date(e);
+  } else return t === "UTC" ? n ? new Date(e) : o ? new Date(e) : /* @__PURE__ */ new Date(e + "Z") : n || o || r ? new Date(e) : Y(e, t);
+}
+const Re = "MM/dd/yyyy", ze = (e, t, n, o = "auto") => {
+  if (!e)
+    return "";
+  try {
+    const r = K(e, o);
+    if (isNaN(r.getTime()))
+      return e;
+    const a = (t && t.trim() ? t : Re).replace(/LLLL/g, "MMMM").replace(/LLL/g, "MMM");
+    return n && n !== "auto" ? X(r, n, a) : H(r, a);
+  } catch (r) {
+    return console.error("Date formatting error:", r), e;
+  }
+}, et = (e, t = "auto") => {
+  if (!e)
+    return "";
+  try {
+    const n = K(e, t);
+    return isNaN(n.getTime()) ? e : de(n, { addSuffix: !0 });
+  } catch (n) {
+    return console.error("Relative time formatting error:", n), e;
+  }
+};
+function Se(e, t = ",") {
+  if (e == null)
+    return "";
+  const n = String(e);
+  return n.includes(t) || n.includes('"') || n.includes(`
+`) || n.includes("\r") ? `"${n.replace(/"/g, '""')}"` : n;
+}
+function De(e, t = ",") {
+  return e.map((n) => Se(n, t)).join(t);
+}
+function Le(e, t = {}) {
+  const { delimiter: n = ",", lineEnding: o = `
+` } = t;
+  return e.map((r) => De(r, n)).join(o);
+}
+function tt(e, t = {}) {
+  if (e.length === 0)
+    return "";
+  const {
+    delimiter: n = ",",
+    lineEnding: o = `
+`,
+    includeHeaders: r = !0,
+    columns: s
+  } = t, a = s || Object.keys(e[0]), i = [];
+  r && i.push(a);
+  for (const c of e) {
+    const f = a.map((m) => {
+      const d = c[m];
+      return d == null ? "" : String(d);
+    });
+    i.push(f);
+  }
+  return Le(i, { delimiter: n, lineEnding: o });
+}
+const Ie = "__TOTAL__";
+function A(e) {
+  return typeof e == "object" && e !== null && !Array.isArray(e);
+}
+function S(e) {
+  return e === Ie;
+}
+function nt(e) {
+  const t = /* @__PURE__ */ new Map(), n = (e.groupByColumns ?? []).map((r, s) => {
+    var f, m, d;
+    if (!A(r))
+      throw new Error(`Aggregate groupByColumns[${s}] is invalid`);
+    const a = typeof r.id == "string" && r.id.length > 0 ? r.id : void 0, i = a ? (d = (m = (f = e.columnKeyMap) == null ? void 0 : f.byRole) == null ? void 0 : m.groupby) == null ? void 0 : d[a] : void 0, c = (i == null ? void 0 : i.outputKey) || (i == null ? void 0 : i.rawKey) || (typeof r.alias == "string" && r.alias.length > 0 ? r.alias : typeof r.name == "string" && r.name.length > 0 ? r.name : void 0);
+    if (!c)
+      throw new Error(`Aggregate groupByColumns[${s}] has no output key`);
+    return [a, r.alias, r.name, c].forEach((u) => {
+      typeof u == "string" && u.length > 0 && t.set(u, c);
+    }), c;
+  }), o = (e.rowAggregates ?? []).flatMap((r) => !A(r) || typeof r.function != "string" || typeof r.groupLevel != "string" ? [] : [
+    {
+      function: r.function,
+      groupLevel: r.groupLevel === "ALL" ? "ALL" : t.get(r.groupLevel) || r.groupLevel,
+      ...typeof r.label == "string" ? { label: r.label } : {}
+    }
+  ]);
+  return { groupColumnKeys: n, rowAggregates: o };
+}
+function O(e) {
+  return e === "SUM" ? "Total" : e.charAt(0).toUpperCase() + e.slice(1).toLowerCase();
+}
+function _e(e) {
+  var n;
+  if (e.customLabel) return e.customLabel;
+  const t = O(e.aggregateFunction);
+  if (e.levelValue !== void 0 && !S(e.levelValue)) {
+    if (e.levelValue === null) {
+      const r = (n = e.formatValue) == null ? void 0 : n.call(e, null);
+      return r ? `Subtotal ${r}` : `Subtotal ${t}`;
+    }
+    const o = e.formatValue ? e.formatValue(e.levelValue) : String(e.levelValue);
+    if (o) return `Subtotal (${o})`;
+  }
+  return `Subtotal ${t}`;
+}
+function Te(e, t) {
+  return t || `Grand ${O(e)}`;
+}
+function N(e) {
+  var o, r;
+  const t = e.context.groupColumnKeys, n = typeof e.row.aggregate == "string" ? e.row.aggregate : "SUM";
+  if (e.row.isGrandTotal === !0) {
+    const s = (o = e.context.rowAggregates.find(
+      (a) => a.groupLevel === "ALL"
+    )) == null ? void 0 : o.label;
+    return {
+      kind: "grand-total",
+      cells: t.map((a, i) => ({
+        columnKey: a,
+        text: i === 0 ? Te(n, s) : "",
+        placement: i === 0 ? "label" : "empty",
+        colSpan: i === 0 ? t.length : 1
+      }))
+    };
+  }
+  if (e.row.isSubtotal === !0) {
+    if (typeof e.row.subtotalLevel != "string")
+      throw new Error("Aggregate subtotal row is missing subtotalLevel");
+    const s = t.indexOf(e.row.subtotalLevel);
+    if (s < 0)
+      throw new Error(
+        `Aggregate subtotal level "${e.row.subtotalLevel}" has no group column`
+      );
+    const a = A(e.row.subtotalContext) ? e.row.subtotalContext : void 0, i = A(a == null ? void 0 : a.groupByValues) ? a.groupByValues : {}, c = (r = e.context.rowAggregates.find(
+      (f) => f.groupLevel === e.row.subtotalLevel && f.function === n
+    )) == null ? void 0 : r.label;
+    return {
+      kind: "subtotal",
+      cells: t.map((f, m) => {
+        if (m > s)
+          return {
+            columnKey: f,
+            text: "",
+            placement: "empty",
+            colSpan: 1
+          };
+        if (m < s) {
+          const d = e.row[f];
+          return {
+            columnKey: f,
+            text: d === void 0 || S(d) ? "" : e.formatValue(d, f),
+            placement: "value",
+            colSpan: 1
+          };
+        }
+        return {
+          columnKey: f,
+          text: _e({
+            aggregateFunction: n,
+            customLabel: c,
+            levelValue: i[f],
+            formatValue: (d) => e.formatLabelValue ? e.formatLabelValue(d, f) : String(e.formatValue(d, f) ?? "")
+          }),
+          placement: "label",
+          colSpan: t.length - s
+        };
+      })
+    };
+  }
+  return {
+    kind: "data",
+    cells: t.map((s) => {
+      const a = e.row[s];
+      return {
+        columnKey: s,
+        text: a === void 0 || S(a) ? "" : e.formatValue(a, s),
+        placement: "value",
+        colSpan: 1
+      };
+    })
+  };
+}
+function rt(e) {
+  const t = N(e).cells.find(
+    (n) => n.columnKey === e.columnKey
+  );
+  if (!t)
+    throw new Error(`Aggregate group column "${e.columnKey}" is unknown`);
+  return t.text;
+}
+function ot(e) {
+  return N(e).cells.map((t) => t.text);
+}
+class $e extends Error {
+  constructor(n, o) {
+    super(`${n}: ${o}`);
+    w(this, "deliveryBlocking", !0);
+    this.code = n, this.name = "PivotHeaderPresentationError";
+  }
+}
+function st(e) {
+  var r;
+  const t = e.mode ?? "formatted", n = e.members.map((s) => {
+    var i;
+    if (t === "canonical" || !s.temporalBucket)
+      return s.value === null ? "" : String(s.value);
+    const a = (i = e.resolveTemporalFormat) == null ? void 0 : i.call(e, s.fieldId);
+    if (!a)
+      throw new $e(
+        "missing_resolved_temporal_format",
+        `Missing resolved temporal presentation for pivot field "${s.fieldId}"`
+      );
+    return W({
+      value: s.value,
+      metadata: s.temporalBucket,
+      format: a
+    });
+  }), o = ((r = e.metricLabel) == null ? void 0 : r.trim()) || void 0;
+  return {
+    memberLabels: n,
+    ...o ? { metricLabel: o } : {},
+    flattenedLabel: [
+      ...n,
+      ...o ? [o] : []
+    ].join(" / ")
+  };
+}
+function v(e) {
+  return Array.from(
+    new Set(
+      (e ?? []).flatMap(
+        (t) => typeof t.id == "string" && t.id ? [t.id] : []
+      )
+    )
+  );
+}
+function it(e) {
+  const t = e.metricFields ?? [], n = v(t), o = /* @__PURE__ */ new Map();
+  return n.forEach((r) => {
+    o.set(
+      r,
+      t.filter((s) => s.id === r).length
+    );
+  }), {
+    expectedRoleFieldIds: {
+      groupby: v(e.groupByFields),
+      metric: n.length > 0 ? n : [J],
+      pivotby: v(e.pivotByFields),
+      detail: v(e.detailFields)
+    },
+    expectedMetricAliases: t.flatMap(
+      (r) => r.id && (o.get(r.id) ?? 0) > 1 ? [Q(r)] : []
+    )
+  };
+}
+class l extends Error {
+  constructor(n, o) {
+    super(`invalid_pivot_result_lifecycle: ${n}`);
+    w(this, "code", "invalid_pivot_result_lifecycle");
+    w(this, "deliveryBlocking", !0);
+    this.cause = o, this.name = "PivotResultLifecycleError";
+  }
+}
+function je(e) {
+  if (!Array.isArray(e) || e.some(
+    (n) => !n || typeof n != "object" || Array.isArray(n) || typeof n.key != "string" || !n.key || typeof n.name != "string" || typeof n.label != "string"
+  ))
+    throw new l(
+      "Canonical pivot columns must be an array of keyed, named result descriptors."
+    );
+  const t = e;
+  if (new Set(t.map((n) => n.key)).size !== t.length)
+    throw new l(
+      "Canonical pivot column keys must be unique."
+    );
+  for (const n of t) {
+    const o = z(n, {
+      metadataRequired: !1
+    });
+    if (!o.ok)
+      throw new l(
+        `Canonical pivot column "${n.key}" has invalid temporal metadata: ${o.error.message}`
+      );
+  }
+  return t;
+}
+function $(e) {
+  if (!e || typeof e != "object" || Array.isArray(e) || e.version !== 1 || e.source !== "explorer" || !e.byRole || typeof e.byRole != "object" || Array.isArray(e.byRole))
+    throw new l(
+      "A loaded canonical pivot result requires its role-scoped column key map."
+    );
+  const t = e, n = /* @__PURE__ */ new Set(["groupby", "metric", "pivotby", "detail"]);
+  for (const [o, r] of Object.entries(t.byRole)) {
+    if (!n.has(o) || !r || typeof r != "object" || Array.isArray(r))
+      throw new l(
+        `Canonical pivot role map contains invalid "${o}" bindings.`
+      );
+    for (const [s, a] of Object.entries(r))
+      if (!s || !a || typeof a != "object" || Array.isArray(a) || a.role !== o || typeof a.rawKey != "string" || !a.rawKey || a.outputKey !== void 0 && (typeof a.outputKey != "string" || !a.outputKey))
+        throw new l(
+          `Canonical pivot role map contains an invalid "${o}:${s}" binding.`
+        );
+  }
+  if (t.byMetricAlias !== void 0) {
+    if (!t.byMetricAlias || typeof t.byMetricAlias != "object" || Array.isArray(t.byMetricAlias))
+      throw new l(
+        "Canonical pivot metric-alias bindings must be an object."
+      );
+    for (const [o, r] of Object.entries(
+      t.byMetricAlias
+    ))
+      if (!o || !r || typeof r != "object" || Array.isArray(r) || r.role !== "metric" || typeof r.rawKey != "string" || !r.rawKey || r.outputKey !== void 0 && (typeof r.outputKey != "string" || !r.outputKey))
+        throw new l(
+          `Canonical pivot metric-alias map contains an invalid "${o}" binding.`
+        );
+  }
+  return t;
+}
+function ke(e) {
+  if (e === void 0) return {};
+  if (!e || typeof e != "object" || Array.isArray(e))
+    throw new l(
+      "Canonical pivot column metadata must be an object."
+    );
+  for (const [t, n] of Object.entries(e)) {
+    if (!t || !n || typeof n != "object" || Array.isArray(n))
+      throw new l(
+        `Canonical pivot column metadata contains an invalid "${t}" classification.`
+      );
+    const { isSubtotal: o, subtotalScope: r } = n;
+    if (o !== void 0 && typeof o != "boolean" || r !== void 0 && r !== "base" && r !== "pivot-value" && r !== "grand-total" || o === !0 && r !== "pivot-value" && r !== "grand-total" || (r === "pivot-value" || r === "grand-total") && o !== !0 || r === "base" && o === !0)
+      throw new l(
+        `Canonical pivot column metadata contains an incoherent "${t}" subtotal classification.`
+      );
+  }
+  return e;
+}
+function j(e, t) {
+  if (!Array.isArray(e) || e.some((n) => typeof n != "string" || !n) || new Set(e).size !== e.length)
+    throw new l(
+      `Canonical pivot contract ${t} must be an array of unique field identities.`
+    );
+  return e;
+}
+function Ee(e, t) {
+  if (!e || typeof e != "object" || Array.isArray(e) || e.version !== 1)
+    throw new l(
+      "A canonical pivot result requires its versioned result contract."
+    );
+  const n = e, o = n.expectedRoleFieldIds;
+  if (!o || typeof o != "object" || Array.isArray(o))
+    throw new l(
+      "Canonical pivot contract role identities must be an object."
+    );
+  const s = Object.fromEntries(
+    [
+      "groupby",
+      "metric",
+      "pivotby",
+      "detail"
+    ].map((u) => [
+      u,
+      j(
+        o[u],
+        `expectedRoleFieldIds.${u}`
+      )
+    ])
+  ), a = j(
+    n.expectedMetricAliases,
+    "expectedMetricAliases"
+  ), i = n.columnKinds;
+  if (!i || typeof i != "object" || Array.isArray(i))
+    throw new l(
+      "Canonical pivot contract column kinds must be an object."
+    );
+  const c = /* @__PURE__ */ new Set([
+    "row",
+    "pivot_metric",
+    "value"
+  ]), f = t.map((u) => u.key), m = Object.keys(i);
+  if (m.length !== f.length || m.some(
+    (u) => !f.includes(u) || !c.has(
+      i[u]
+    )
+  ))
+    throw new l(
+      "Canonical pivot contract must classify every authoritative result column exactly once."
+    );
+  const d = ke(
+    n.columnClassifications
+  );
+  if (Object.keys(d).some(
+    (u) => !f.includes(u)
+  ))
+    throw new l(
+      "Canonical pivot contract contains a classification for an unknown result column."
+    );
+  return {
+    version: 1,
+    expectedRoleFieldIds: s,
+    expectedMetricAliases: a,
+    columnKinds: i,
+    columnClassifications: d
+  };
+}
+function k(e, t) {
+  const n = [
+    "groupby",
+    "metric",
+    "pivotby",
+    "detail"
+  ];
+  for (const s of n) {
+    const a = new Set(t.expectedRoleFieldIds[s] ?? []), i = Object.keys(e.byRole[s] ?? {});
+    if (i.length !== a.size || i.some((c) => !a.has(c)))
+      throw new l(
+        `The role-scoped ${s} bindings do not match the authored result fields.`
+      );
+  }
+  const o = new Set(t.expectedMetricAliases), r = Object.keys(e.byMetricAlias ?? {});
+  if (r.length !== o.size || r.some((s) => !o.has(s)))
+    throw new l(
+      "The metric-alias bindings do not match the authored metric instances."
+    );
+}
+function Fe(e) {
+  if (!Array.isArray(e) || e.some(
+    (t) => !t || typeof t != "object" || Array.isArray(t)
+  ))
+    throw new l(
+      "Canonical pivot records must be an array of row objects."
+    );
+  return e;
+}
+function Pe(e, t) {
+  e.forEach((n, o) => {
+    t.forEach((r) => {
+      if (!Object.prototype.hasOwnProperty.call(n, r.key) || n[r.key] === void 0)
+        throw new l(
+          `Canonical pivot column "${r.key}" is absent from row ${o}.`
+        );
+    });
+  });
+}
+function Ke(e, t, n) {
+  const o = new Set(t.map((r) => r.key));
+  ["groupby", "detail"].forEach((r) => {
+    Object.entries(e.byRole[r] ?? {}).forEach(
+      ([s, a]) => {
+        const i = a.outputKey || a.rawKey;
+        if (!o.has(i) || n.columnKinds[i] !== "row")
+          throw new l(
+            `The role-scoped ${r} binding for "${s}" does not name an authoritative result column.`
+          );
+      }
+    );
+  });
+}
+function E(e, t) {
+  t.forEach((n) => {
+    const o = e.columnKinds[n.key];
+    if (o === "pivot_metric" && n.pivotIdentity === void 0)
+      throw new l(
+        `Physical pivot result column "${n.key}" is missing its identity.`
+      );
+    if (o !== "pivot_metric" && n.pivotIdentity !== void 0)
+      throw new l(
+        `Canonical pivot result column "${n.key}" carries pivot identity outside the physical pivot projection.`
+      );
+  });
+}
+function Oe(e) {
+  const t = Fe(e.records), n = je(e.columns), o = Ee(
+    e.pivotResultContract,
+    n
+  ), r = o.expectedRoleFieldIds.pivotby ?? [];
+  if (e.pivotResultState === "loaded_empty") {
+    if (t.length !== 0)
+      throw new l(
+        "A loaded_empty pivot result cannot carry records."
+      );
+    if (n.some(
+      (c) => o.columnKinds[c.key] === "pivot_metric"
+    ))
+      throw new l(
+        "A loaded_empty pivot result cannot carry physical pivot columns."
+      );
+    E(o, n);
+    const i = $(e.columnKeyMap);
+    return k(i, o), {
+      pivotResultState: "loaded_empty",
+      records: [],
+      columns: n,
+      columnKeyMap: i,
+      pivotResultContract: o
+    };
+  }
+  if (e.pivotResultState !== "loaded_valid")
+    throw new l(
+      "A canonical pivot result must declare loaded_empty or loaded_valid."
+    );
+  if (t.length === 0)
+    throw new l(
+      "A loaded_valid pivot result must carry at least one record."
+    );
+  const s = $(e.columnKeyMap);
+  k(s, o), Ke(s, n, o), E(o, n);
+  const a = n.filter(
+    (i) => o.columnKinds[i.key] === "pivot_metric"
+  );
+  if (r.length > 0 && a.length === 0)
+    throw new l(
+      "A loaded_valid pivot result is missing its physical pivot columns."
+    );
+  try {
+    ee(a, {
+      expectedPivotFieldIds: r,
+      columnClassifications: o.columnClassifications
+    });
+  } catch (i) {
+    throw i instanceof te ? new l(i.message, i) : i;
+  }
+  return Pe(t, n), {
+    pivotResultState: "loaded_valid",
+    records: t,
+    columns: n,
+    columnKeyMap: s,
+    pivotResultContract: o
+  };
+}
+function at(e) {
+  const t = /* @__PURE__ */ new Set();
+  ["groupby", "detail"].forEach((s) => {
+    Object.values(e.columnKeyMap.byRole[s] ?? {}).forEach((a) => {
+      t.add(a.outputKey || a.rawKey);
+    });
+  });
+  const n = new Set(e.physicalPivotColumnKeys), o = new Set(
+    e.columns.map((s) => s.key)
+  ), r = {
+    version: 1,
+    expectedRoleFieldIds: {
+      groupby: Array.from(
+        new Set(e.expectedRoleFieldIds.groupby ?? [])
+      ),
+      metric: Array.from(
+        new Set(e.expectedRoleFieldIds.metric ?? [])
+      ),
+      pivotby: Array.from(
+        new Set(e.expectedRoleFieldIds.pivotby ?? [])
+      ),
+      detail: Array.from(
+        new Set(e.expectedRoleFieldIds.detail ?? [])
+      )
+    },
+    expectedMetricAliases: [...e.expectedMetricAliases ?? []],
+    columnKinds: Object.fromEntries(
+      e.columns.map((s) => [
+        s.key,
+        t.has(s.key) ? "row" : n.has(s.key) ? "pivot_metric" : "value"
+      ])
+    ),
+    columnClassifications: Object.fromEntries(
+      Object.entries(e.columnMetadata ?? {}).filter(
+        ([s]) => o.has(s)
+      )
+    )
+  };
+  return Oe({
+    pivotResultState: e.records.length === 0 ? "loaded_empty" : "loaded_valid",
+    pivotResultContract: r,
+    records: e.records,
+    columns: e.columns,
+    columnKeyMap: e.columnKeyMap
+  });
+}
+export {
+  Ie as A,
+  $e as P,
+  ze as a,
+  De as b,
+  l as c,
+  Le as d,
+  Se as e,
+  et as f,
+  at as g,
+  it as h,
+  Te as i,
+  rt as j,
+  ot as k,
+  _e as l,
+  xe as m,
+  Ye as n,
+  Je as o,
+  Qe as p,
+  S as q,
+  tt as r,
+  Oe as s,
+  K as t,
+  N as u,
+  st as v,
+  nt as w,
+  We as x,
+  de as y
+};