react-semaphor 0.1.443 → 0.1.445

package/dist/chunks/{comparison-document-migration-Dj6xZMCb.js → temporal-result-owner-Cb27SSG9.js}

@@ -1,62 +1,63 @@
-import "./analyze-result-contract-CfOBEwaC.js";
-import { v as V, C as T } from "./metric-comparison-CPoDx56y.js";
-const x = [
+import "./validators-wZ2WlNHc.js";
+import "./analyze-result-contract-DUv3QnMl.js";
+import { v as k, C as V } from "./metric-comparison-BJ_Qu1ZF.js";
+const G = [
   "lg",
   "md",
   "sm",
   "xs",
   "xxs"
-], R = 15, _ = /* @__PURE__ */ new Set([
+], U = 15, _ = /* @__PURE__ */ new Set([
   "previous_period",
   "same_period_last_year",
   "start_vs_end",
   "target"
-]), k = /* @__PURE__ */ new Set([..._, "none", ""]);
+]), I = /* @__PURE__ */ new Set([..._, "none", ""]);
 function l(e) {
   return !!e && typeof e == "object" && !Array.isArray(e);
 }
-function A(e) {
-  const r = l(e.preferences) ? e.preferences : void 0, o = r && l(r.kpiVisualOptions) ? r.kpiVisualOptions : void 0, s = r && l(r.tableVisualOptions) ? r.tableVisualOptions : void 0;
+function E(e) {
+  const r = l(e.preferences) ? e.preferences : void 0, o = r && l(r.kpiVisualOptions) ? r.kpiVisualOptions : void 0, t = r && l(r.tableVisualOptions) ? r.tableVisualOptions : void 0;
   return {
     preferences: r,
     kpiOptions: o,
     kpiComparison: o && l(o.metricComparison) ? o.metricComparison : void 0,
     kpiComparisonPresent: !!o && "metricComparison" in o,
-    tableOptions: s,
-    tableComparison: s && l(s.metricComparison) ? s.metricComparison : void 0,
-    tableComparisonPresent: !!s && "metricComparison" in s
+    tableOptions: t,
+    tableComparison: t && l(t.metricComparison) ? t.metricComparison : void 0,
+    tableComparisonPresent: !!t && "metricComparison" in t
   };
 }
 function O(e) {
-  const r = [], o = (s, p) => {
-    if (Array.isArray(s)) {
-      s.forEach((t, c) => o(t, `${p}[${c}]`));
+  const r = [], o = (t, p) => {
+    if (Array.isArray(t)) {
+      t.forEach((n, c) => o(n, `${p}[${c}]`));
       return;
     }
-    if (!l(s)) return;
-    const m = s.config;
+    if (!l(t)) return;
+    const m = t.config;
     if (l(m)) {
-      const t = A(s), c = !!(t.kpiComparisonPresent || t.tableComparisonPresent), d = m.metricColumns, a = Array.isArray(d) ? d.flatMap(
-        (n, i) => l(n) ? [{ index: i, metric: n }] : []
+      const n = E(t), c = !!(n.kpiComparisonPresent || n.tableComparisonPresent), d = m.metricColumns, a = Array.isArray(d) ? d.flatMap(
+        (s, i) => l(s) ? [{ index: i, metric: s }] : []
       ) : [];
-      if ((a.some(({ metric: n }) => "comparisonType" in n) || c) && r.push({
+      if ((a.some(({ metric: s }) => "comparisonType" in s) || c) && r.push({
         path: p,
-        card: s,
+        card: t,
         metrics: a,
         malformedMetricIndexes: Array.isArray(d) ? d.flatMap(
-          (n, i) => l(n) ? [] : [i]
+          (s, i) => l(s) ? [] : [i]
         ) : [],
         malformedMetricColumns: "metricColumns" in m && !Array.isArray(d),
         hasLegacyPresentation: c
       }), "metricColumns" in m || c) return;
     }
-    Object.entries(s).forEach(
-      ([t, c]) => o(c, p ? `${p}.${t}` : t)
+    Object.entries(t).forEach(
+      ([n, c]) => o(c, p ? `${p}.${n}` : n)
     );
   };
   return o(e, "$"), r;
 }
-const E = {
+const L = {
   difference: "difference",
   change: "percent_change",
   change_difference: "both",
@@ -66,12 +67,12 @@ function $(e, r) {
   if (!e) return;
   const o = Object.fromEntries(
     r.flatMap(
-      (s) => typeof e[s] == "string" ? [[s, e[s]]] : []
+      (t) => typeof e[t] == "string" ? [[t, e[t]]] : []
     )
   );
   return Object.keys(o).length ? o : void 0;
 }
-function I(e, r, o) {
+function N(e, r, o) {
   if (e !== void 0) {
     if (!l(e)) {
       o.push({
@@ -82,8 +83,8 @@ function I(e, r, o) {
       });
       return;
     }
-    Object.entries(e).forEach(([s, p]) => {
-      if (s === "decimalPlaces") {
+    Object.entries(e).forEach(([t, p]) => {
+      if (t === "decimalPlaces") {
         (typeof p != "number" || !Number.isInteger(p) || p < 0 || p > 6) && o.push({
           severity: "error",
           code: "invalid_legacy_comparison_presentation",
@@ -92,45 +93,45 @@ function I(e, r, o) {
         });
         return;
       }
-      s === "type" && (p === void 0 || p === "auto") || p !== void 0 && o.push({
+      t === "type" && (p === void 0 || p === "auto") || p !== void 0 && o.push({
         severity: "error",
         code: "unsupported_comparison_format",
-        path: `${r}.${s}`,
-        message: `Legacy comparison format option "${s}" has no canonical presentation mapping.`
+        path: `${r}.${t}`,
+        message: `Legacy comparison format option "${t}" has no canonical presentation mapping.`
       });
     });
   }
 }
-function C(e, r) {
-  const o = r === "kpi" ? e.calculationType : e.calculatedAs, s = r === "table" && o === void 0 ? "both" : E[String(o)], p = l(e.formatOptions) ? e.formatOptions : void 0, m = l(e.conditionalLabels) ? e.conditionalLabels : void 0, t = l(
+function v(e, r) {
+  const o = r === "kpi" ? e.calculationType : e.calculatedAs, t = r === "table" && o === void 0 ? "both" : L[String(o)], p = l(e.formatOptions) ? e.formatOptions : void 0, m = l(e.conditionalLabels) ? e.conditionalLabels : void 0, n = l(
     r === "kpi" ? e.colorConfig : e.colors
   ) ? r === "kpi" ? e.colorConfig : e.colors : void 0, c = {};
-  if (s && (c.displayMode = s), typeof (p == null ? void 0 : p.decimalPlaces) == "number" && (c.precision = p.decimalPlaces), r === "kpi") {
-    const n = e.showArrow !== !1, i = e.showColor !== !1;
-    c.indicatorStyle = n ? i ? "arrow_badge" : "arrow" : i ? "badge" : "none", c.showColor = i, (e.position === "left" || e.position === "right" || e.position === "top") && (c.position = e.position), typeof e.conditionalLabel == "boolean" && (c.conditionalLabel = e.conditionalLabel), typeof e.labelName == "string" && (c.labelName = e.labelName);
+  if (t && (c.displayMode = t), typeof (p == null ? void 0 : p.decimalPlaces) == "number" && (c.precision = p.decimalPlaces), r === "kpi") {
+    const s = e.showArrow !== !1, i = e.showColor !== !1;
+    c.indicatorStyle = s ? i ? "arrow_badge" : "arrow" : i ? "badge" : "none", c.showColor = i, (e.position === "left" || e.position === "right" || e.position === "top") && (c.position = e.position), typeof e.conditionalLabel == "boolean" && (c.conditionalLabel = e.conditionalLabel), typeof e.labelName == "string" && (c.labelName = e.labelName);
   } else (e.indicatorStyle === "arrow_badge" || e.indicatorStyle === "arrow" || e.indicatorStyle === "badge" || e.indicatorStyle === "none") && (c.indicatorStyle = e.indicatorStyle);
   const d = m ? {
     ...$(m, ["increase", "decrease"]),
     ...typeof m.noChange == "string" ? { neutral: m.noChange } : typeof m.neutral == "string" ? { neutral: m.neutral } : {}
   } : void 0;
   d && Object.keys(d).length && (c.conditionalLabels = d);
-  const a = t ? {
-    ...$(t, ["increase", "decrease"]),
-    ...typeof t.noChange == "string" ? { neutral: t.noChange } : typeof t.neutral == "string" ? { neutral: t.neutral } : {}
+  const a = n ? {
+    ...$(n, ["increase", "decrease"]),
+    ...typeof n.noChange == "string" ? { neutral: n.noChange } : typeof n.neutral == "string" ? { neutral: n.neutral } : {}
   } : void 0;
   return a && Object.keys(a).length && (c.colors = a), c;
 }
 function w(e) {
-  return { ...T, ...e };
+  return { ...V, ...e };
 }
 function P(e) {
   return e.some(({ metric: r }) => r.comparisonType === "previous_period" || r.comparisonType === "same_period_last_year" || r.comparisonType === "target" ? !0 : l(r.comparison) && r.comparison.mode === "explicit");
 }
-function v(e) {
+function C(e) {
   const r = e.card.config;
   return e.metrics.length === 2 && (r.groupByColumns === void 0 || Array.isArray(r.groupByColumns) && r.groupByColumns.length === 0);
 }
-function L(e, r, o, s) {
+function S(e, r, o, t) {
   const p = r === "kpi" ? [
     "enabled",
     "calculationType",
@@ -150,26 +151,26 @@ function L(e, r, o, s) {
     "colors",
     "lowerIsBetter"
   ];
-  Object.keys(e).forEach((n) => {
-    p.includes(n) || s.push({
+  Object.keys(e).forEach((s) => {
+    p.includes(s) || t.push({
       severity: "error",
       code: "invalid_legacy_comparison_presentation",
-      path: `${o}.${n}`,
-      message: `Unknown legacy comparison presentation field "${n}" cannot be dropped automatically.`
+      path: `${o}.${s}`,
+      message: `Unknown legacy comparison presentation field "${s}" cannot be dropped automatically.`
     });
   });
   const m = r === "kpi" ? "calculationType" : "calculatedAs";
-  e[m] !== void 0 && !E[String(e[m])] && s.push({
+  e[m] !== void 0 && !L[String(e[m])] && t.push({
     severity: "error",
     code: "invalid_legacy_comparison_presentation",
     path: `${o}.${m}`,
     message: `Legacy comparison ${m} is unsupported.`
-  }), r === "kpi" && e.position !== void 0 && !["left", "right", "top"].includes(String(e.position)) && s.push({
+  }), r === "kpi" && e.position !== void 0 && !["left", "right", "top"].includes(String(e.position)) && t.push({
     severity: "error",
     code: "invalid_legacy_comparison_presentation",
     path: `${o}.position`,
     message: "Legacy comparison position is unsupported."
-  }), r === "kpi" && e.labelName !== void 0 && typeof e.labelName != "string" && s.push({
+  }), r === "kpi" && e.labelName !== void 0 && typeof e.labelName != "string" && t.push({
     severity: "error",
     code: "invalid_legacy_comparison_presentation",
     path: `${o}.labelName`,
@@ -177,65 +178,65 @@ function L(e, r, o, s) {
   }), (r === "kpi" ? [
     ["conditionalLabels", ["increase", "decrease", "noChange"]],
     ["colorConfig", ["increase", "decrease", "noChange"]]
-  ] : [["colors", ["increase", "decrease", "neutral"]]]).forEach(([n, i]) => {
-    if (e[n] !== void 0) {
-      if (!l(e[n])) {
-        s.push({
+  ] : [["colors", ["increase", "decrease", "neutral"]]]).forEach(([s, i]) => {
+    if (e[s] !== void 0) {
+      if (!l(e[s])) {
+        t.push({
           severity: "error",
           code: "invalid_legacy_comparison_presentation",
-          path: `${o}.${n}`,
-          message: `Legacy comparison ${n} must be an object.`
+          path: `${o}.${s}`,
+          message: `Legacy comparison ${s} must be an object.`
         });
         return;
       }
-      Object.entries(e[n]).forEach(([u, f]) => {
-        i.includes(u) ? typeof f != "string" && s.push({
+      Object.entries(e[s]).forEach(([u, f]) => {
+        i.includes(u) ? typeof f != "string" && t.push({
           severity: "error",
           code: "invalid_legacy_comparison_presentation",
-          path: `${o}.${n}.${u}`,
-          message: `Legacy comparison ${n}.${u} must be a string.`
-        }) : s.push({
+          path: `${o}.${s}.${u}`,
+          message: `Legacy comparison ${s}.${u} must be a string.`
+        }) : t.push({
           severity: "error",
           code: "invalid_legacy_comparison_presentation",
-          path: `${o}.${n}.${u}`,
-          message: `Unknown legacy comparison ${n} field "${u}" cannot be dropped automatically.`
+          path: `${o}.${s}.${u}`,
+          message: `Unknown legacy comparison ${s} field "${u}" cannot be dropped automatically.`
         });
       });
     }
-  }), (r === "kpi" ? ["enabled", "showArrow", "showColor", "conditionalLabel", "lowerIsBetter"] : ["lowerIsBetter"]).forEach((n) => {
-    e[n] !== void 0 && typeof e[n] != "boolean" && s.push({
+  }), (r === "kpi" ? ["enabled", "showArrow", "showColor", "conditionalLabel", "lowerIsBetter"] : ["lowerIsBetter"]).forEach((s) => {
+    e[s] !== void 0 && typeof e[s] != "boolean" && t.push({
       severity: "error",
       code: "invalid_legacy_comparison_presentation",
-      path: `${o}.${n}`,
-      message: `Legacy comparison ${n} must be a boolean.`
+      path: `${o}.${s}`,
+      message: `Legacy comparison ${s} must be a boolean.`
     });
   }), r === "table" && e.indicatorStyle !== void 0 && !["arrow_badge", "arrow", "badge", "none"].includes(
     String(e.indicatorStyle)
-  ) && s.push({
+  ) && t.push({
     severity: "error",
     code: "invalid_legacy_comparison_presentation",
     path: `${o}.indicatorStyle`,
     message: "Legacy comparison indicatorStyle is unsupported."
-  }), I(e.formatOptions, `${o}.formatOptions`, s);
-  const d = C(e, r);
-  V(d, o).errors.forEach((n) => {
-    s.push({
+  }), N(e.formatOptions, `${o}.formatOptions`, t);
+  const d = v(e, r);
+  k(d, o).errors.forEach((s) => {
+    t.push({
       severity: "error",
       code: "invalid_legacy_comparison_presentation",
-      path: n.path || o,
-      message: n.message
+      path: s.path || o,
+      message: s.message
     });
   });
 }
-function S(e) {
-  const r = A(e.card), o = r.kpiComparison ? C(r.kpiComparison, "kpi") : void 0, s = r.tableComparison ? C(r.tableComparison, "table") : void 0;
-  return { namespaces: r, kpi: o, table: s, presentation: o || s };
-}
-function N(e) {
-  const r = l(e.preferences) ? e.preferences : {}, o = l(r.kpiVisualOptions) ? r.kpiVisualOptions : {}, s = l(o.metricComparison) ? o.metricComparison : {}, p = l(r.tableVisualOptions) ? r.tableVisualOptions : {}, m = l(p.metricComparison) ? p.metricComparison : {};
-  return o.lowerIsBetter === !0 || s.lowerIsBetter === !0 || m.lowerIsBetter === !0 ? "lower_is_better" : "higher_is_better";
+function A(e) {
+  const r = E(e.card), o = r.kpiComparison ? v(r.kpiComparison, "kpi") : void 0, t = r.tableComparison ? v(r.tableComparison, "table") : void 0;
+  return { namespaces: r, kpi: o, table: t, presentation: o || t };
 }
 function B(e) {
+  const r = l(e.preferences) ? e.preferences : {}, o = l(r.kpiVisualOptions) ? r.kpiVisualOptions : {}, t = l(o.metricComparison) ? o.metricComparison : {}, p = l(r.tableVisualOptions) ? r.tableVisualOptions : {}, m = l(p.metricComparison) ? p.metricComparison : {};
+  return o.lowerIsBetter === !0 || t.lowerIsBetter === !0 || m.lowerIsBetter === !0 ? "lower_is_better" : "higher_is_better";
+}
+function M(e) {
   switch (e.comparisonType) {
     case "previous_period":
       return { mode: "explicit", spec: { kind: "previous_period" } };
@@ -250,36 +251,36 @@ function B(e) {
       return;
   }
 }
-function M(e) {
+function R(e) {
   const r = l(e.preferences) ? e.preferences : void 0;
   if (!r) return;
   const o = l(r.kpiVisualOptions) ? r.kpiVisualOptions : void 0;
   o && delete o.lowerIsBetter;
-  const s = l(r.tableVisualOptions) ? r.tableVisualOptions : void 0, p = s && l(s.metricComparison) ? s.metricComparison : void 0;
+  const t = l(r.tableVisualOptions) ? r.tableVisualOptions : void 0, p = t && l(t.metricComparison) ? t.metricComparison : void 0;
   p && delete p.lowerIsBetter;
 }
-function F(e) {
+function z(e) {
   const r = O(e);
   if (!r.length)
     return { document: e, changed: !1, changes: [], diagnostics: [] };
   const o = [];
-  if (r.forEach((t) => {
-    var c, d, a, n;
-    if (t.malformedMetricColumns && o.push({
+  if (r.forEach((n) => {
+    var c, d, a, s;
+    if (n.malformedMetricColumns && o.push({
       severity: "error",
       code: "malformed_metric_columns",
-      path: `${t.path}.config.metricColumns`,
+      path: `${n.path}.config.metricColumns`,
       message: "Metric columns must be an array before comparison migration."
-    }), t.malformedMetricIndexes.forEach((i) => {
+    }), n.malformedMetricIndexes.forEach((i) => {
       o.push({
         severity: "error",
         code: "malformed_metric_columns",
-        path: `${t.path}.config.metricColumns[${i}]`,
+        path: `${n.path}.config.metricColumns[${i}]`,
         message: "Metric columns must contain objects before comparison migration."
       });
-    }), t.metrics.forEach(({ metric: i, index: u }) => {
+    }), n.metrics.forEach(({ metric: i, index: u }) => {
       if (!("comparisonType" in i)) return;
-      const f = `${t.path}.config.metricColumns[${u}]`, g = String(i.comparisonType || "");
+      const f = `${n.path}.config.metricColumns[${u}]`, g = String(i.comparisonType || "");
       "comparison" in i && o.push({
         severity: "error",
         code: "conflicting_comparison_contracts",
@@ -292,7 +293,7 @@ function F(e) {
         code: "conflicting_comparison_window_transform",
         path: f,
         message: "A metric cannot combine baseline comparison with previous_period_delta; resolve the authoring intent before migration."
-      }), k.has(g) || o.push({
+      }), I.has(g) || o.push({
         severity: "error",
         code: "unsupported_comparison_type",
         path: `${f}.comparisonType`,
@@ -313,8 +314,8 @@ function F(e) {
         path: `${f}.targetValue`,
         message: "Dead non-target targetValue will be removed without changing the baseline."
       });
-    }), t.hasLegacyPresentation) {
-      const { namespaces: i, kpi: u, table: f } = S(t), g = [
+    }), n.hasLegacyPresentation) {
+      const { namespaces: i, kpi: u, table: f } = A(n), g = [
         (c = i.kpiOptions) == null ? void 0 : c.lowerIsBetter,
         (d = i.kpiComparison) == null ? void 0 : d.lowerIsBetter,
         (a = i.tableComparison) == null ? void 0 : a.lowerIsBetter
@@ -322,59 +323,59 @@ function F(e) {
       new Set(g).size > 1 && o.push({
         severity: "error",
         code: "conflicting_legacy_polarity",
-        path: `${t.path}.preferences`,
+        path: `${n.path}.preferences`,
         message: "Legacy comparison polarity values disagree; resolve the conflict before migration."
-      }), ((n = i.kpiOptions) == null ? void 0 : n.lowerIsBetter) !== void 0 && typeof i.kpiOptions.lowerIsBetter != "boolean" && o.push({
+      }), ((s = i.kpiOptions) == null ? void 0 : s.lowerIsBetter) !== void 0 && typeof i.kpiOptions.lowerIsBetter != "boolean" && o.push({
         severity: "error",
         code: "invalid_legacy_comparison_presentation",
-        path: `${t.path}.preferences.kpiVisualOptions.lowerIsBetter`,
+        path: `${n.path}.preferences.kpiVisualOptions.lowerIsBetter`,
         message: "Legacy comparison lowerIsBetter must be a boolean."
       }), i.kpiComparisonPresent && !i.kpiComparison && o.push({
         severity: "error",
         code: "invalid_legacy_comparison_presentation",
-        path: `${t.path}.preferences.kpiVisualOptions.metricComparison`,
+        path: `${n.path}.preferences.kpiVisualOptions.metricComparison`,
         message: "Legacy KPI comparison presentation must be an object."
       }), i.tableComparisonPresent && !i.tableComparison && o.push({
         severity: "error",
         code: "invalid_legacy_comparison_presentation",
-        path: `${t.path}.preferences.tableVisualOptions.metricComparison`,
+        path: `${n.path}.preferences.tableVisualOptions.metricComparison`,
         message: "Legacy table comparison presentation must be an object."
       }), "comparisonPresentation" in (i.preferences || {}) && o.push({
         severity: "error",
         code: "conflicting_comparison_presentation_contracts",
-        path: `${t.path}.preferences.comparisonPresentation`,
+        path: `${n.path}.preferences.comparisonPresentation`,
         message: "Card contains both legacy and canonical comparison presentation; resolve the conflict before migration."
-      }), i.kpiComparison && typeof i.kpiComparison.enabled == "boolean" && "metricPairComparisonEnabled" in (i.preferences || {}) && v(t) && o.push({
+      }), i.kpiComparison && typeof i.kpiComparison.enabled == "boolean" && "metricPairComparisonEnabled" in (i.preferences || {}) && C(n) && o.push({
         severity: "error",
         code: "conflicting_comparison_presentation_contracts",
-        path: `${t.path}.preferences.metricPairComparisonEnabled`,
+        path: `${n.path}.preferences.metricPairComparisonEnabled`,
         message: "Card contains both legacy and canonical metric-pair enablement; resolve the conflict before migration."
-      }), i.kpiComparison && L(
+      }), i.kpiComparison && S(
         i.kpiComparison,
         "kpi",
-        `${t.path}.preferences.kpiVisualOptions.metricComparison`,
+        `${n.path}.preferences.kpiVisualOptions.metricComparison`,
         o
-      ), i.tableComparison && L(
+      ), i.tableComparison && S(
         i.tableComparison,
         "table",
-        `${t.path}.preferences.tableVisualOptions.metricComparison`,
+        `${n.path}.preferences.tableVisualOptions.metricComparison`,
         o
       ), u && f && JSON.stringify(w(u)) !== JSON.stringify(w(f)) && o.push({
         severity: "error",
         code: "conflicting_legacy_presentation_namespaces",
-        path: `${t.path}.preferences`,
+        path: `${n.path}.preferences`,
         message: "KPI and table comparison presentation values disagree; resolve the conflict before migration."
       });
     }
-  }), o.some((t) => t.severity === "error"))
+  }), o.some((n) => n.severity === "error"))
     return { document: e, changed: !1, changes: [], diagnostics: o };
-  const s = JSON.parse(JSON.stringify(e)), p = O(s), m = [];
-  return p.forEach((t) => {
+  const t = JSON.parse(JSON.stringify(e)), p = O(t), m = [];
+  return p.forEach((n) => {
     var d;
-    const c = N(t.card);
-    if (t.metrics.forEach(({ metric: a, index: n }) => {
+    const c = B(n.card);
+    if (n.metrics.forEach(({ metric: a, index: s }) => {
       if (!("comparisonType" in a)) return;
-      const i = String(a.comparisonType || ""), u = `${t.path}.config.metricColumns[${n}]`, f = B(a), g = ["comparisonType"];
+      const i = String(a.comparisonType || ""), u = `${n.path}.config.metricColumns[${s}]`, f = M(a), g = ["comparisonType"];
       delete a.comparisonType, "targetValue" in a && (delete a.targetValue, g.push("targetValue")), "comparisonDisplay" in a && (delete a.comparisonDisplay, g.push("comparisonDisplay")), f ? a.comparison = f : delete a.comparison, _.has(i) && (a.comparisonPolarity = c), m.push({
         kind: "metric",
         path: u,
@@ -384,17 +385,17 @@ function F(e) {
         comparisonPolarity: _.has(i) ? c : void 0,
         removedFields: g
       });
-    }), M(t.card), t.hasLegacyPresentation) {
-      const { namespaces: a, presentation: n } = S(t), i = (d = a.kpiComparison) == null ? void 0 : d.enabled, u = {
-        ...n
+    }), R(n.card), n.hasLegacyPresentation) {
+      const { namespaces: a, presentation: s } = A(n), i = (d = a.kpiComparison) == null ? void 0 : d.enabled, u = {
+        ...s
       };
-      typeof i == "boolean" && P(t.metrics) && (u.showComparison = i);
-      const f = typeof i == "boolean" && v(t) ? i : void 0, g = typeof i == "boolean" && !P(t.metrics) && !v(t) ? ["kpiVisualOptions.metricComparison.enabled"] : void 0, h = a.preferences, b = [];
-      t.metrics.forEach(({ metric: y }) => {
+      typeof i == "boolean" && P(n.metrics) && (u.showComparison = i);
+      const f = typeof i == "boolean" && C(n) ? i : void 0, g = typeof i == "boolean" && !P(n.metrics) && !C(n) ? ["kpiVisualOptions.metricComparison.enabled"] : void 0, h = a.preferences, b = [];
+      n.metrics.forEach(({ metric: y }) => {
         "comparisonPolarity" in y || (y.comparisonPolarity = c, typeof y.id == "string" && b.push(y.id));
       }), Object.keys(u).length && (h.comparisonPresentation = u), f !== void 0 && (h.metricPairComparisonEnabled = f), a.kpiOptions && delete a.kpiOptions.metricComparison, a.tableOptions && delete a.tableOptions.metricComparison, m.push({
         kind: "presentation",
-        path: `${t.path}.preferences`,
+        path: `${n.path}.preferences`,
         comparisonPresentation: Object.keys(u).length ? u : void 0,
         metricPairComparisonEnabled: f,
         comparisonPolarityMetricIds: b,
@@ -405,10 +406,38 @@ function F(e) {
         ]
       });
     }
-  }), { document: s, changed: !0, changes: m, diagnostics: o };
+  }), { document: t, changed: !0, changes: m, diagnostics: o };
+}
+const D = [
+  "bar",
+  "horizontalBar",
+  "line",
+  "area",
+  "stackedArea",
+  "combo",
+  "stackedBar",
+  "stackedLine"
+], j = new Set(
+  D
+);
+function x(e) {
+  return typeof e == "string" && j.has(e);
+}
+function J(e) {
+  return e === "table" || e === "aggregateTable" || e === "pivotTable" || e === "custom" || x(e);
+}
+function T(e) {
+  return !!(e != null && e.trim());
+}
+function K(e) {
+  return T(e.sql) || T(e.normalizedPython) ? "freeform" : e.hasExecutableConfig ? "config" : "none";
 }
 export {
-  R as D,
-  x as a,
-  F as t
+  U as D,
+  D as S,
+  G as a,
+  x as i,
+  K as r,
+  J as s,
+  z as t
 };

package/dist/chunks/temporal-result-owner-f6-i65Fb.cjs

@@ -0,0 +1 @@
+"use strict";require("./validators-9D4KBqKD.cjs");require("./analyze-result-contract-BHb7sUUW.cjs");const E=require("./metric-comparison-CUAJ8n4y.cjs"),N=["lg","md","sm","xs","xxs"],R=15,y=new Set(["previous_period","same_period_last_year","start_vs_end","target"]),B=new Set([...y,"none",""]);function l(e){return!!e&&typeof e=="object"&&!Array.isArray(e)}function L(e){const r=l(e.preferences)?e.preferences:void 0,o=r&&l(r.kpiVisualOptions)?r.kpiVisualOptions:void 0,n=r&&l(r.tableVisualOptions)?r.tableVisualOptions:void 0;return{preferences:r,kpiOptions:o,kpiComparison:o&&l(o.metricComparison)?o.metricComparison:void 0,kpiComparisonPresent:!!o&&"metricComparison"in o,tableOptions:n,tableComparison:n&&l(n.metricComparison)?n.metricComparison:void 0,tableComparisonPresent:!!n&&"metricComparison"in n}}function O(e){const r=[],o=(n,p)=>{if(Array.isArray(n)){n.forEach((t,c)=>o(t,`${p}[${c}]`));return}if(!l(n))return;const m=n.config;if(l(m)){const t=L(n),c=!!(t.kpiComparisonPresent||t.tableComparisonPresent),d=m.metricColumns,a=Array.isArray(d)?d.flatMap((s,i)=>l(s)?[{index:i,metric:s}]:[]):[];if((a.some(({metric:s})=>"comparisonType"in s)||c)&&r.push({path:p,card:n,metrics:a,malformedMetricIndexes:Array.isArray(d)?d.flatMap((s,i)=>l(s)?[]:[i]):[],malformedMetricColumns:"metricColumns"in m&&!Array.isArray(d),hasLegacyPresentation:c}),"metricColumns"in m||c)return}Object.entries(n).forEach(([t,c])=>o(c,p?`${p}.${t}`:t))};return o(e,"$"),r}const I={difference:"difference",change:"percent_change",change_difference:"both",ratio:"ratio"};function A(e,r){if(!e)return;const o=Object.fromEntries(r.flatMap(n=>typeof e[n]=="string"?[[n,e[n]]]:[]));return Object.keys(o).length?o:void 0}function D(e,r,o){if(e!==void 0){if(!l(e)){o.push({severity:"error",code:"invalid_legacy_comparison_presentation",path:r,message:"Legacy comparison formatOptions must be an object."});return}Object.entries(e).forEach(([n,p])=>{if(n==="decimalPlaces"){(typeof p!="number"||!Number.isInteger(p)||p<0||p>6)&&o.push({severity:"error",code:"invalid_legacy_comparison_presentation",path:`${r}.decimalPlaces`,message:"Legacy comparison decimalPlaces must be an integer from 0 through 6."});return}n==="type"&&(p===void 0||p==="auto")||p!==void 0&&o.push({severity:"error",code:"unsupported_comparison_format",path:`${r}.${n}`,message:`Legacy comparison format option "${n}" has no canonical presentation mapping.`})})}}function v(e,r){const o=r==="kpi"?e.calculationType:e.calculatedAs,n=r==="table"&&o===void 0?"both":I[String(o)],p=l(e.formatOptions)?e.formatOptions:void 0,m=l(e.conditionalLabels)?e.conditionalLabels:void 0,t=l(r==="kpi"?e.colorConfig:e.colors)?r==="kpi"?e.colorConfig:e.colors:void 0,c={};if(n&&(c.displayMode=n),typeof(p==null?void 0:p.decimalPlaces)=="number"&&(c.precision=p.decimalPlaces),r==="kpi"){const s=e.showArrow!==!1,i=e.showColor!==!1;c.indicatorStyle=s?i?"arrow_badge":"arrow":i?"badge":"none",c.showColor=i,(e.position==="left"||e.position==="right"||e.position==="top")&&(c.position=e.position),typeof e.conditionalLabel=="boolean"&&(c.conditionalLabel=e.conditionalLabel),typeof e.labelName=="string"&&(c.labelName=e.labelName)}else(e.indicatorStyle==="arrow_badge"||e.indicatorStyle==="arrow"||e.indicatorStyle==="badge"||e.indicatorStyle==="none")&&(c.indicatorStyle=e.indicatorStyle);const d=m?{...A(m,["increase","decrease"]),...typeof m.noChange=="string"?{neutral:m.noChange}:typeof m.neutral=="string"?{neutral:m.neutral}:{}}:void 0;d&&Object.keys(d).length&&(c.conditionalLabels=d);const a=t?{...A(t,["increase","decrease"]),...typeof t.noChange=="string"?{neutral:t.noChange}:typeof t.neutral=="string"?{neutral:t.neutral}:{}}:void 0;return a&&Object.keys(a).length&&(c.colors=a),c}function $(e){return{...E.COMPARISON_PRESENTATION_DEFAULTS,...e}}function w(e){return e.some(({metric:r})=>r.comparisonType==="previous_period"||r.comparisonType==="same_period_last_year"||r.comparisonType==="target"?!0:l(r.comparison)&&r.comparison.mode==="explicit")}function C(e){const r=e.card.config;return e.metrics.length===2&&(r.groupByColumns===void 0||Array.isArray(r.groupByColumns)&&r.groupByColumns.length===0)}function S(e,r,o,n){const p=r==="kpi"?["enabled","calculationType","formatOptions","showArrow","showColor","conditionalLabel","labelName","position","conditionalLabels","colorConfig","lowerIsBetter"]:["calculatedAs","indicatorStyle","formatOptions","colors","lowerIsBetter"];Object.keys(e).forEach(s=>{p.includes(s)||n.push({severity:"error",code:"invalid_legacy_comparison_presentation",path:`${o}.${s}`,message:`Unknown legacy comparison presentation field "${s}" cannot be dropped automatically.`})});const m=r==="kpi"?"calculationType":"calculatedAs";e[m]!==void 0&&!I[String(e[m])]&&n.push({severity:"error",code:"invalid_legacy_comparison_presentation",path:`${o}.${m}`,message:`Legacy comparison ${m} is unsupported.`}),r==="kpi"&&e.position!==void 0&&!["left","right","top"].includes(String(e.position))&&n.push({severity:"error",code:"invalid_legacy_comparison_presentation",path:`${o}.position`,message:"Legacy comparison position is unsupported."}),r==="kpi"&&e.labelName!==void 0&&typeof e.labelName!="string"&&n.push({severity:"error",code:"invalid_legacy_comparison_presentation",path:`${o}.labelName`,message:"Legacy comparison labelName must be a string."}),(r==="kpi"?[["conditionalLabels",["increase","decrease","noChange"]],["colorConfig",["increase","decrease","noChange"]]]:[["colors",["increase","decrease","neutral"]]]).forEach(([s,i])=>{if(e[s]!==void 0){if(!l(e[s])){n.push({severity:"error",code:"invalid_legacy_comparison_presentation",path:`${o}.${s}`,message:`Legacy comparison ${s} must be an object.`});return}Object.entries(e[s]).forEach(([u,f])=>{i.includes(u)?typeof f!="string"&&n.push({severity:"error",code:"invalid_legacy_comparison_presentation",path:`${o}.${s}.${u}`,message:`Legacy comparison ${s}.${u} must be a string.`}):n.push({severity:"error",code:"invalid_legacy_comparison_presentation",path:`${o}.${s}.${u}`,message:`Unknown legacy comparison ${s} field "${u}" cannot be dropped automatically.`})})}}),(r==="kpi"?["enabled","showArrow","showColor","conditionalLabel","lowerIsBetter"]:["lowerIsBetter"]).forEach(s=>{e[s]!==void 0&&typeof e[s]!="boolean"&&n.push({severity:"error",code:"invalid_legacy_comparison_presentation",path:`${o}.${s}`,message:`Legacy comparison ${s} must be a boolean.`})}),r==="table"&&e.indicatorStyle!==void 0&&!["arrow_badge","arrow","badge","none"].includes(String(e.indicatorStyle))&&n.push({severity:"error",code:"invalid_legacy_comparison_presentation",path:`${o}.indicatorStyle`,message:"Legacy comparison indicatorStyle is unsupported."}),D(e.formatOptions,`${o}.formatOptions`,n);const d=v(e,r);E.validateComparisonPresentationSpec(d,o).errors.forEach(s=>{n.push({severity:"error",code:"invalid_legacy_comparison_presentation",path:s.path||o,message:s.message})})}function T(e){const r=L(e.card),o=r.kpiComparison?v(r.kpiComparison,"kpi"):void 0,n=r.tableComparison?v(r.tableComparison,"table"):void 0;return{namespaces:r,kpi:o,table:n,presentation:o||n}}function M(e){const r=l(e.preferences)?e.preferences:{},o=l(r.kpiVisualOptions)?r.kpiVisualOptions:{},n=l(o.metricComparison)?o.metricComparison:{},p=l(r.tableVisualOptions)?r.tableVisualOptions:{},m=l(p.metricComparison)?p.metricComparison:{};return o.lowerIsBetter===!0||n.lowerIsBetter===!0||m.lowerIsBetter===!0?"lower_is_better":"higher_is_better"}function j(e){switch(e.comparisonType){case"previous_period":return{mode:"explicit",spec:{kind:"previous_period"}};case"same_period_last_year":return{mode:"explicit",spec:{kind:"previous_year"}};case"target":return{mode:"explicit",spec:{kind:"target",targetValue:e.targetValue}};default:return}}function x(e){const r=l(e.preferences)?e.preferences:void 0;if(!r)return;const o=l(r.kpiVisualOptions)?r.kpiVisualOptions:void 0;o&&delete o.lowerIsBetter;const n=l(r.tableVisualOptions)?r.tableVisualOptions:void 0,p=n&&l(n.metricComparison)?n.metricComparison:void 0;p&&delete p.lowerIsBetter}function H(e){const r=O(e);if(!r.length)return{document:e,changed:!1,changes:[],diagnostics:[]};const o=[];if(r.forEach(t=>{var c,d,a,s;if(t.malformedMetricColumns&&o.push({severity:"error",code:"malformed_metric_columns",path:`${t.path}.config.metricColumns`,message:"Metric columns must be an array before comparison migration."}),t.malformedMetricIndexes.forEach(i=>{o.push({severity:"error",code:"malformed_metric_columns",path:`${t.path}.config.metricColumns[${i}]`,message:"Metric columns must contain objects before comparison migration."})}),t.metrics.forEach(({metric:i,index:u})=>{if(!("comparisonType"in i))return;const f=`${t.path}.config.metricColumns[${u}]`,g=String(i.comparisonType||"");"comparison"in i&&o.push({severity:"error",code:"conflicting_comparison_contracts",path:f,message:"Metric contains both legacy and canonical comparison configuration; resolve the conflict before migration."});const h=l(i.parameters)?i.parameters:void 0,b=h&&l(h.windowTransform)?h.windowTransform:void 0;y.has(g)&&(b==null?void 0:b.function)==="previous_period_delta"&&o.push({severity:"error",code:"conflicting_comparison_window_transform",path:f,message:"A metric cannot combine baseline comparison with previous_period_delta; resolve the authoring intent before migration."}),B.has(g)||o.push({severity:"error",code:"unsupported_comparison_type",path:`${f}.comparisonType`,message:`Unsupported legacy metric comparison type "${g}".`}),i.comparisonType==="target"&&(typeof i.targetValue!="number"||!Number.isFinite(i.targetValue))&&o.push({severity:"error",code:"invalid_target_value",path:`${f}.targetValue`,message:"Legacy target comparison requires a finite metric targetValue."}),i.comparisonType==="start_vs_end"&&o.push({severity:"error",code:"unsupported_start_vs_end",path:`${f}.comparisonType`,message:"start_vs_end is retired and cannot be migrated automatically."}),i.targetValue!==void 0&&i.comparisonType!=="target"&&o.push({severity:"warning",code:"stray_target_value",path:`${f}.targetValue`,message:"Dead non-target targetValue will be removed without changing the baseline."})}),t.hasLegacyPresentation){const{namespaces:i,kpi:u,table:f}=T(t),g=[(c=i.kpiOptions)==null?void 0:c.lowerIsBetter,(d=i.kpiComparison)==null?void 0:d.lowerIsBetter,(a=i.tableComparison)==null?void 0:a.lowerIsBetter].filter(h=>typeof h=="boolean");new Set(g).size>1&&o.push({severity:"error",code:"conflicting_legacy_polarity",path:`${t.path}.preferences`,message:"Legacy comparison polarity values disagree; resolve the conflict before migration."}),((s=i.kpiOptions)==null?void 0:s.lowerIsBetter)!==void 0&&typeof i.kpiOptions.lowerIsBetter!="boolean"&&o.push({severity:"error",code:"invalid_legacy_comparison_presentation",path:`${t.path}.preferences.kpiVisualOptions.lowerIsBetter`,message:"Legacy comparison lowerIsBetter must be a boolean."}),i.kpiComparisonPresent&&!i.kpiComparison&&o.push({severity:"error",code:"invalid_legacy_comparison_presentation",path:`${t.path}.preferences.kpiVisualOptions.metricComparison`,message:"Legacy KPI comparison presentation must be an object."}),i.tableComparisonPresent&&!i.tableComparison&&o.push({severity:"error",code:"invalid_legacy_comparison_presentation",path:`${t.path}.preferences.tableVisualOptions.metricComparison`,message:"Legacy table comparison presentation must be an object."}),"comparisonPresentation"in(i.preferences||{})&&o.push({severity:"error",code:"conflicting_comparison_presentation_contracts",path:`${t.path}.preferences.comparisonPresentation`,message:"Card contains both legacy and canonical comparison presentation; resolve the conflict before migration."}),i.kpiComparison&&typeof i.kpiComparison.enabled=="boolean"&&"metricPairComparisonEnabled"in(i.preferences||{})&&C(t)&&o.push({severity:"error",code:"conflicting_comparison_presentation_contracts",path:`${t.path}.preferences.metricPairComparisonEnabled`,message:"Card contains both legacy and canonical metric-pair enablement; resolve the conflict before migration."}),i.kpiComparison&&S(i.kpiComparison,"kpi",`${t.path}.preferences.kpiVisualOptions.metricComparison`,o),i.tableComparison&&S(i.tableComparison,"table",`${t.path}.preferences.tableVisualOptions.metricComparison`,o),u&&f&&JSON.stringify($(u))!==JSON.stringify($(f))&&o.push({severity:"error",code:"conflicting_legacy_presentation_namespaces",path:`${t.path}.preferences`,message:"KPI and table comparison presentation values disagree; resolve the conflict before migration."})}}),o.some(t=>t.severity==="error"))return{document:e,changed:!1,changes:[],diagnostics:o};const n=JSON.parse(JSON.stringify(e)),p=O(n),m=[];return p.forEach(t=>{var d;const c=M(t.card);if(t.metrics.forEach(({metric:a,index:s})=>{if(!("comparisonType"in a))return;const i=String(a.comparisonType||""),u=`${t.path}.config.metricColumns[${s}]`,f=j(a),g=["comparisonType"];delete a.comparisonType,"targetValue"in a&&(delete a.targetValue,g.push("targetValue")),"comparisonDisplay"in a&&(delete a.comparisonDisplay,g.push("comparisonDisplay")),f?a.comparison=f:delete a.comparison,y.has(i)&&(a.comparisonPolarity=c),m.push({kind:"metric",path:u,metricId:typeof a.id=="string"?a.id:void 0,legacyType:i,comparison:f,comparisonPolarity:y.has(i)?c:void 0,removedFields:g})}),x(t.card),t.hasLegacyPresentation){const{namespaces:a,presentation:s}=T(t),i=(d=a.kpiComparison)==null?void 0:d.enabled,u={...s};typeof i=="boolean"&&w(t.metrics)&&(u.showComparison=i);const f=typeof i=="boolean"&&C(t)?i:void 0,g=typeof i=="boolean"&&!w(t.metrics)&&!C(t)?["kpiVisualOptions.metricComparison.enabled"]:void 0,h=a.preferences,b=[];t.metrics.forEach(({metric:_})=>{"comparisonPolarity"in _||(_.comparisonPolarity=c,typeof _.id=="string"&&b.push(_.id))}),Object.keys(u).length&&(h.comparisonPresentation=u),f!==void 0&&(h.metricPairComparisonEnabled=f),a.kpiOptions&&delete a.kpiOptions.metricComparison,a.tableOptions&&delete a.tableOptions.metricComparison,m.push({kind:"presentation",path:`${t.path}.preferences`,comparisonPresentation:Object.keys(u).length?u:void 0,metricPairComparisonEnabled:f,comparisonPolarityMetricIds:b,intentionallyDiscardedFields:g,removedFields:[...a.kpiComparison?["kpiVisualOptions.metricComparison"]:[],...a.tableComparison?["tableVisualOptions.metricComparison"]:[]]})}}),{document:n,changed:!0,changes:m,diagnostics:o}}const k=["bar","horizontalBar","line","area","stackedArea","combo","stackedBar","stackedLine"],Y=new Set(k);function V(e){return typeof e=="string"&&Y.has(e)}function G(e){return e==="table"||e==="aggregateTable"||e==="pivotTable"||e==="custom"||V(e)}function P(e){return!!(e!=null&&e.trim())}function F(e){return P(e.sql)||P(e.normalizedPython)?"freeform":e.hasExecutableConfig?"config":"none"}exports.DASHBOARD_AUTHORING_BREAKPOINTS=N;exports.DASHBOARD_AUTHORING_MAX_GENERATED_CARDS=R;exports.SEMAPHOR_CARTESIAN_CHART_TYPES=k;exports.isSemaphorCartesianChartType=V;exports.resolveTemporalResultOwner=F;exports.supportsCanonicalDashboardTemporalResult=G;exports.transformComparisonDocument=H;

package/dist/chunks/token-types-BdQ8kHBm.cjs

@@ -0,0 +1 @@
+"use strict";require("../value-format-preferences/index.cjs");require("./validators-9D4KBqKD.cjs");const A={mode:"all"};exports.DEFAULT_SEMANTIC_DOMAIN_ACCESS=A;

package/dist/chunks/token-types-DLo91nOf.js

@@ -0,0 +1,8 @@
+import "../value-format-preferences/index.js";
+import "./validators-wZ2WlNHc.js";
+const A = {
+  mode: "all"
+};
+export {
+  A as D
+};

package/dist/chunks/{update-policy-DnF_74zC.js → update-policy-BxvYMYz0.cjs}

@@ -1,3 +1,3 @@
-"use strict";const K=require("./analyze-result-contract-BswhsmWT.js"),S=require("../data-app-sdk-adapters/index.cjs"),re=K.SEMAPHOR_DATA_APP_CODEGEN_SUMMARY_SCHEMA_VERSION,T=K.SEMAPHOR_DATA_APP_CODEGEN_SUMMARY_VALIDATOR_VERSION,k="semaphor-generated-data-app-contract/v1",G="semaphor-generated-data-app-contract-manifest/v1";function x(e){return E(e)?[...K.validateSemaphorDataAppCodegenSummary(e).issues,...ae(e)]:["Plan artifact must be a Semaphor codegenSummary object."]}function ne(e){const t=x(e);if(t.length>0)throw new Error(`Invalid Semaphor codegenSummary:
+"use strict";const K=require("./validators-9D4KBqKD.cjs"),S=require("../data-app-sdk-adapters/index.cjs"),re=K.SEMAPHOR_DATA_APP_CODEGEN_SUMMARY_SCHEMA_VERSION,T=K.SEMAPHOR_DATA_APP_CODEGEN_SUMMARY_VALIDATOR_VERSION,k="semaphor-generated-data-app-contract/v1",G="semaphor-generated-data-app-contract-manifest/v1";function x(e){return E(e)?[...K.validateSemaphorDataAppCodegenSummary(e).issues,...ae(e)]:["Plan artifact must be a Semaphor codegenSummary object."]}function ne(e){const t=x(e);if(t.length>0)throw new Error(`Invalid Semaphor codegenSummary:
 - ${t.join(`
 - `)}`)}function ae(e){var r;const t=E(e);if(!t)return[];const n=[];return((r=E(t.validation))==null?void 0:r.status)==="blocked"&&n.push("validation.status blocked cannot be generated. Resolve blocked semantic model gaps and replan before generating contract files."),Array.isArray(t.unsupportedInsights)&&t.unsupportedInsights.forEach((i,o)=>{var a;((a=E(i))==null?void 0:a.reason)==="missing_relationship"&&n.push(`unsupportedInsights.${o}.reason missing_relationship blocks contract generation. Call semaphor_propose_semantic_model_change, apply an approved semantic model patch, and replan before generating contract files.`)}),Array.isArray(t.views)&&t.views.forEach((i,o)=>{var s;const a=E((s=E(i))==null?void 0:s.computation);(a==null?void 0:a.kind)==="unsupported"&&a.reason==="missing_relationship"&&n.push(`views.${o}.computation.reason missing_relationship blocks contract generation. Call semaphor_propose_semantic_model_change, apply an approved semantic model patch, and replan before generating contract files.`)}),n}function E(e){return e&&typeof e=="object"&&!Array.isArray(e)?e:void 0}const J=["sources.ts","fields.ts","inputs.ts","queries.ts","bindings.ts","accessors.ts","metadata.ts","index.ts"],ie=["USAGE.md"],Y=[...J,...ie,"contract.manifest.json"];async function se({manifest:e,generatedFiles:t}){const n=[],r=y(e);if(!r)return{issues:[{message:"Generated contract manifest must be an object.",repairHint:"Regenerate the generated contract instead of hand-editing the manifest."}]};r.schemaVersion!==G&&n.push({path:"schemaVersion",message:`schemaVersion must be ${G}. Regenerate the contract with semaphor_create_data_app_contract.`,repairHint:"Regenerate the contract with semaphor_create_data_app_contract."}),r.generatedContractSchemaVersion!==k&&n.push({path:"generatedContractSchemaVersion",message:`generatedContractSchemaVersion must be ${k}. Regenerate the contract with semaphor_generate_data_app_contract.`,repairHint:"Regenerate the contract with semaphor_generate_data_app_contract."});const i=y(r.generator);A(i==null?void 0:i.name)||n.push({path:"generator.name",message:"generator.name is required.",repairHint:"Regenerate the generated contract so manifest generator metadata is written deterministically."}),A(i==null?void 0:i.version)||n.push({path:"generator.version",message:"generator.version is required.",repairHint:"Regenerate the generated contract so manifest generator metadata is written deterministically."});for(const a of x(r.codegenSummary))n.push({path:`codegenSummary.${a}`,message:`codegenSummary.${a}`,repairHint:"Regenerate the generated contract from a valid Data App codegenSummary."});if(r.codegenSummaryValidatorVersion!==T&&n.push({path:"codegenSummaryValidatorVersion",message:`codegenSummaryValidatorVersion must be ${T}. Regenerate the contract with semaphor_generate_data_app_contract.`,repairHint:"Regenerate the contract with semaphor_generate_data_app_contract."}),typeof r.codegenSummaryHash!="string")n.push({path:"codegenSummaryHash",message:"codegenSummaryHash is required.",repairHint:"Regenerate the generated contract so manifest hashes are written deterministically."});else if(y(r.codegenSummary)){const a=await fe(r.codegenSummary);r.codegenSummaryHash!==a&&n.push({path:"codegenSummaryHash",message:"codegenSummaryHash does not match codegenSummary. Regenerate the contract instead of editing the manifest.",repairHint:"Regenerate the generated contract instead of editing the manifest."})}n.push(...de(r.codegenSummary));const o=t?oe(t):[];if(n.push(...o),t&&o.length===0&&n.push(...ce(t)),typeof r.generatedContentHash!="string")n.push({path:"generatedContentHash",message:"generatedContentHash is required.",repairHint:"Regenerate the generated contract so manifest hashes are written deterministically."});else if(t&&o.length===0){const a=await ue(t);r.generatedContentHash!==a&&n.push({path:"generatedContentHash",message:"generatedContentHash does not match generated TypeScript files. Regenerate the contract instead of hand-editing generated files.",repairHint:"Regenerate the contract instead of hand-editing generated files."})}return{issues:n}}function oe(e){var r;const t=[],n=new Set(Y);for(const i of Object.keys(e)){if(i.includes("/")||i.includes("\\")){const o=((r=i.split("/").pop())==null?void 0:r.split("\\").pop())||i;t.push({path:`generatedFiles.${i}`,message:`generatedFiles keys must be generated filenames such as "${o}", not path-qualified keys such as "${i}".`,repairHint:'Pass generatedFiles keyed by filename, for example "queries.ts", not "src/semaphor/generated/queries.ts".'});continue}n.has(i)||t.push({path:`generatedFiles.${i}`,message:`generatedFiles contains unknown generated contract file "${i}".`,repairHint:"Pass only the generated files returned by semaphor_generate_data_app_contract, keyed by filename."})}return t}function ce(e){const t=e["USAGE.md"];return typeof t!="string"?[{path:"generatedFiles.USAGE.md",message:"generatedFiles.USAGE.md is required.",repairHint:"Regenerate the generated contract so the generated usage guide is written."}]:["queries","queryOptionsForView","rowsForView","metricValuesForView","kpiPropsForView","roleValuesForView","appInputSpecs","inputOptionQueries"].filter(r=>!t.includes(`\`${r}\``)).map(r=>({path:"generatedFiles.USAGE.md",message:`generatedFiles.USAGE.md must document ${r}.`,repairHint:"Regenerate the generated contract so the usage guide matches generated exports."}))}function de(e){const t=y(e);if(!t)return[];const n=[],r=new Set(b(t.inputs).map(o=>{var a;return(a=y(o))==null?void 0:a.id}).filter(A)),i=new Set(b(t.views).map(o=>{var a;return(a=y(o))==null?void 0:a.id}).filter(A));return b(t.filterContracts).forEach((o,a)=>{const s=y(o),c=s==null?void 0:s.inputId;(!A(c)||!r.has(c))&&n.push({path:`codegenSummary.filterContracts.${a}.inputId`,message:`codegenSummary.filterContracts.${a}.inputId must reference a generated input.`,repairHint:"Regenerate the generated contract from a valid planner output."}),Array.isArray(s==null?void 0:s.bindings)&&s.bindings.forEach((u,f)=>{const p=y(u),m=p==null?void 0:p.viewId;(!A(m)||!i.has(m))&&n.push({path:`codegenSummary.filterContracts.${a}.bindings.${f}.viewId`,message:`codegenSummary.filterContracts.${a}.bindings.${f}.viewId must reference a generated view.`,repairHint:"Regenerate the generated contract from a valid planner output."});const h=y(p==null?void 0:p.fieldRef);A(h==null?void 0:h.name)||n.push({path:`codegenSummary.filterContracts.${a}.bindings.${f}.fieldRef`,message:`codegenSummary.filterContracts.${a}.bindings.${f}.fieldRef is required.`,repairHint:"Regenerate the generated contract from a valid planner output."})})}),n}async function ue(e){const t=Object.keys(e).filter(r=>r.endsWith(".ts")).sort();let n="";for(const r of t)n+=`${r}\0${e[r]}\0`;return`sha256:${await Q(n)}`}async function fe(e){return`sha256:${await Q(M(e))}`}function M(e){if(e===null||typeof e!="object")return JSON.stringify(e);if(Array.isArray(e))return`[${e.map(r=>M(r)).join(",")}]`;const t=e;return`{${Object.keys(t).sort().filter(r=>t[r]!==void 0).map(r=>`${JSON.stringify(r)}:${M(t[r])}`).join(",")}}`}async function Q(e){var r;if(!((r=globalThis.crypto)!=null&&r.subtle))throw new Error("SHA-256 digest support is required for generated contract validation.");const t=new TextEncoder().encode(e),n=await globalThis.crypto.subtle.digest("SHA-256",t);return Array.from(new Uint8Array(n)).map(i=>i.toString(16).padStart(2,"0")).join("")}function y(e){return e&&typeof e=="object"&&!Array.isArray(e)?e:void 0}function b(e){return Array.isArray(e)?e:[]}function A(e){return typeof e=="string"&&e.length>0}function pe(e){const t=d(e),n=V(t),r=[],i=[];return I(t==null?void 0:t.views).filter(o=>{var s;const a=d((s=d(o))==null?void 0:s.sdkSpec);return!!(a!=null&&a.builder&&(a!=null&&a.spec))}).forEach((o,a)=>{var u;const s=String(((u=d(o))==null?void 0:u.id)||`view_${a}`),c=W(o,n);if(c){r.push({viewId:s,...c});return}i.push({viewId:s,path:`views.${s}.sdkSpec`,message:`Generated view execution validation could not build intent for "${s}".`})}),{requests:r,issues:i}}function W(e,t){const n=d(e),r=d(n==null?void 0:n.sdkSpec),i=d(r==null?void 0:r.spec);if(!n||!(r!=null&&r.builder)||!i)return null;const o=me(t)?t:V(d(t)),a=be(r.builder),s=d(w(i,o))||{},c=ye({view:n,builder:a,rawSpec:i,spec:{...s,id:n.id,label:Ne(n,i)},context:o});try{if(a==="analysis"){const u=c;return{intent:S.toSemaphorAnalysisIntent(u),resultShape:"analysis",analysisOptions:S.toSemaphorAnalysisQueryOptions(u)}}if(a==="metric")return{intent:S.toSemaphorMetricIntent(c),resultShape:"metric"};if(a==="records")return{intent:S.toSemaphorRecordsIntent(c),resultShape:"records"};if(a==="matrix")return{intent:S.toSemaphorMatrixIntent(c),resultShape:"matrix"};if(a==="sql")return{intent:S.toSemaphorSqlIntent(c),resultShape:"sql"}}catch{return null}return null}function ge({input:e,filterContract:t,codegenSummary:n}){const r=d(e),i=d(t),o=d(r==null?void 0:r.optionQuery)||d(i==null?void 0:i.optionQuery);if(!r||!o)return null;const a=V(d(n)),s=d(o.spec),c=he(o,s,a),u=o.valueFieldRef||o.valueField||(s==null?void 0:s.valueField),f=o.labelFieldRef||o.labelField||(s==null?void 0:s.labelField);if(!c||!u||!f)return null;const m={...d(w(s||{},a))||{},id:o.id||(s==null?void 0:s.id)||`${r.id}-options`,inputId:r.id,source:c,valueField:u,labelField:f,population:o.population||(s==null?void 0:s.population),dependencies:o.dependencies||(s==null?void 0:s.dependencies),limit:o.limit||(s==null?void 0:s.limit)||100};try{return S.toSemaphorInputOptionsIntent(w(m,a))}catch{return null}}function le({input:e,filterContract:t,binding:n,option:r,codegenSummary:i}){const o=V(d(i)),a=d(e),s=d(t),c=d(n),u=w((c==null?void 0:c.fieldRef)||(s==null?void 0:s.fieldRef)||(a==null?void 0:a.fieldRef),o),f=String((s==null?void 0:s.operator)||(a==null?void 0:a.operator)||"in"),p=Fe(c);return{inputId:String((s==null?void 0:s.inputId)||(a==null?void 0:a.id)||""),kind:"filter",operator:f,value:He(f,r.value),isActive:!0,...u?{field:u}:{},...p?{relationshipHint:p}:{}}}function V(e){return{sourcesByKey:new Map(I(e==null?void 0:e.sources).map(d).filter(Me).filter(t=>typeof t.sourceKey=="string").map(t=>[String(t.sourceKey),Z(t)]))}}function me(e){var t;return e instanceof Object&&((t=d(e))==null?void 0:t.sourcesByKey)instanceof Map}function he(e,t,n){if(typeof e.sourceKey=="string")return n.sourcesByKey.get(e.sourceKey)||{sourceKey:e.sourceKey};if(e.source)return e.source;if(t!=null&&t.source)return t.source;if(typeof(t==null?void 0:t.sourceKey)=="string")return n.sourcesByKey.get(t.sourceKey)||{sourceKey:t.sourceKey}}function ye({view:e,builder:t,rawSpec:n,spec:r,context:i}){var s;if(t!=="records"&&t!=="sql")return r;const o=d((s=d(e.visualSpec))==null?void 0:s.tableBehavior);if(!o)return r;const a={...r};if(Oe(o)==="server"&&(a.pagination={page:1,pageSize:Se({tableBehavior:o,spec:r})}),t==="records"&&Ve(o)==="server"){const c=Ae({view:e,rawSpec:n,tableBehavior:o,context:i});c&&(a.orderBy=c)}return a}function Se({tableBehavior:e,spec:t}){const n=d(e.pagination),r=d(t.pagination);return F(n==null?void 0:n.pageSize)||F(r==null?void 0:r.pageSize)||F(t.limit)||100}function Ae({view:e,rawSpec:t,tableBehavior:n,context:r}){const i=d(n.sorting),o=g(i==null?void 0:i.defaultField);if(!o)return;const s=_e({view:e,rawSpec:t,context:r}).filter(c=>we(c.lookup).includes(o));if(s.length===1)return{field:s[0].field,direction:(i==null?void 0:i.defaultDirection)==="desc"?"desc":"asc"}}function _e({view:e,rawSpec:t,context:n}){var i;const r=[];for(const o of I(t.fields))$(r,o,n);$(r,t.dateField,n),$(r,(i=d(t.orderBy))==null?void 0:i.field,n);for(const o of I(e.fields))$(r,o,n);return Te(r,o=>Ee(o.lookup))}function $(e,t,n){const r=d(t);if(typeof(r==null?void 0:r.name)!="string"||r.name.length===0)return;const i=d(w(r,n))||r;e.push({lookup:r,field:i})}function we(e){return ke([g(e.name),X(e),Ie(e)])}function Ee(e){return[X(e),g(e.name),g(e.role),g(e.aggregate)].join("|")}function X(e){return[g(e.sourceKey)||Re(e.source),g(e.name),g(e.aggregate)].filter(Boolean).join(":")}function Re(e){const t=d(e);if(!t)return"";if(typeof t.kind=="string"&&typeof t.domainId=="string"){if(typeof t.datasetId=="string")return`${t.kind}:${t.domainId}:datasetId:${t.datasetId}`;if(typeof t.datasetName=="string")return`${t.kind}:${t.domainId}:datasetName:${t.datasetName}`}return JSON.stringify(t)}function Ie(e){return Ge([ve(e),g(e.aggregate).toLowerCase(),g(e.label)||g(e.name)].filter(Boolean))}function ve(e){return typeof e.sourceKey=="string"?Ce(e.sourceKey):$e(e.source)}function $e(e){const t=d(e);return t?g(t.datasetName)||g(t.datasetId)||g(t.name)||g(t.kind):""}function Ce(e){const t=String(e).split(":");return t[t.length-1]||String(e)}function Oe(e){var t;return g((t=d(e.pagination))==null?void 0:t.mode)}function Ve(e){var t;return g((t=d(e.sorting))==null?void 0:t.mode)}function w(e,t){if(!e||typeof e!="object")return e;if(Array.isArray(e))return e.map(i=>w(i,t));const n=e;if(typeof n.sourceKey=="string"&&typeof n.kind=="string"&&(typeof n.datasetName=="string"||typeof n.datasetId=="string"))return Z(n);const r={};for(const[i,o]of Object.entries(n))i!=="sourceKey"&&(r[i]=w(o,t));if(typeof n.sourceKey=="string"){const i=t.sourcesByKey.get(n.sourceKey);i&&!r.source&&(r.source=i)}return r}function Z(e){const{sourceKey:t,...n}=e;return n}function Ne(e,t){const n=d(e.visualSpec);return(n==null?void 0:n.title)||e.title||t.label}function be(e){const t=String(e||"").replace(/^semaphor\./,"");return["metric","records","analysis","matrix","sql"].includes(t)?t:""}function Fe(e){if(e!=null&&e.relationshipHint)return e.relationshipHint;const t=I(e==null?void 0:e.relationshipsUsed).map(n=>{var r;return(r=d(n))==null?void 0:r.id}).filter(n=>typeof n=="string"&&n.length>0);return t.length>0?{relationshipIds:t}:void 0}function He(e,t){return e==="in"||e==="not_in"?[t]:e==="between"?Array.isArray(t)?t:[t,t]:t}function F(e){return typeof e=="number"&&Number.isFinite(e)?e:void 0}function g(e){return typeof e=="string"?e:""}function Te(e,t){const n=new Set,r=[];for(const i of e){const o=t(i);!o||n.has(o)||(n.add(o),r.push(i))}return r}function ke(e){return Array.from(new Set(e.filter(Boolean)))}function Ge(e){return(Array.isArray(e)?e.join(" "):e).replace(/[^a-zA-Z0-9]+/g," ").trim().split(/\s+/).filter(Boolean).map((n,r)=>{const i=n.toLowerCase();return r===0?i:i.charAt(0).toUpperCase()+i.slice(1)}).join("")}function d(e){return e&&typeof e=="object"&&!Array.isArray(e)?e:void 0}function I(e){return Array.isArray(e)?e:[]}function Me(e){return e!==void 0}const De=new Set(["diagnostic_fix","fix_diagnostics","fix_inspector_warnings","fix_runtime_warnings","fix_warnings"]),Ke=new Set(["add","edit","mixed","remove"]),j=new Set(["fields","metricBindingKeys","sdkSpec"]);function xe({beforeSummary:e,afterSummary:t,migrationReport:n,operationIntent:r,constraints:i,preferences:o}){const a=l(r),s=typeof(a==null?void 0:a.kind)=="string"?a.kind.trim():"";return Ke.has(s)?{ok:!1,policy:{kind:s,mode:"invalid_operation_kind",reason:"Retired Data App operation aliases are not accepted. Use the hard-migrated analytics/layout/style operationIntent kinds."},violations:[{path:"operationIntent.kind",reason:"Use analytics_add, analytics_edit, analytics_remove, input_add, input_edit, layout_only, style_only, runtime_debug, semantic_model_repair, save_or_publish, or greenfield_create."}]}:B(o)?{ok:!1,policy:{kind:s,mode:"invalid_update_constraints",reason:"Metric aggregate override updates must use operationIntent.measureAggregateOverrides so deterministic update policy can guard the targeted edit."},violations:[{path:"preferences.measureAggregateOverrides",reason:"preferences is retired. Move measureAggregateOverrides to operationIntent.measureAggregateOverrides for update calls."}]}:B(i)?{ok:!1,policy:{kind:s,mode:"invalid_update_constraints",reason:"Metric aggregate override updates must use operationIntent.measureAggregateOverrides so deterministic update policy can guard the targeted edit."},violations:[{path:"constraints.measureAggregateOverrides",reason:"Move measureAggregateOverrides to operationIntent.measureAggregateOverrides for update calls."}]}:De.has(s)?U({beforeSummary:e,afterSummary:t,migrationReport:n,operationIntent:a,mode:"diagnostic_warning_fix",allowedViewChangeReasons:j,label:"Diagnostic warning fixes",reason:"Diagnostic warning fixes are preserve-by-default and may not add/remove views, inputs, or filter contracts."}):s==="analytics_edit"&&Array.isArray(a==null?void 0:a.measureAggregateOverrides)&&a.measureAggregateOverrides.length>0?U({beforeSummary:e,afterSummary:t,migrationReport:n,operationIntent:a,mode:"metric_aggregate_override_edit",allowedViewChangeReasons:j,label:"Metric aggregate override edits",reason:"Metric aggregate override edits are preserve-by-default and may only adjust fields/sdkSpec on targeted views."}):{ok:!0,policy:{kind:s,mode:"general_iterative_update",reason:"General generated-contract edits are allowed to change the requested contract shape. Review the migration report for expected UI work."},violations:[]}}function B(e){var t;return Array.isArray((t=l(e))==null?void 0:t.measureAggregateOverrides)}function U({beforeSummary:e,afterSummary:t,migrationReport:n,operationIntent:r,mode:i,allowedViewChangeReasons:o,label:a,reason:s}){const c=[],u=je(r==null?void 0:r.targetViewIds),f=l(n)||{};u.size===0&&c.push({path:"operationIntent.targetViewIds",reason:`${a} must declare targetViewIds so the update cannot broaden to unrelated views.`}),H({bucket:l(f.views),label:"views",operationLabel:a,violations:c}),H({bucket:l(f.inputs),label:"inputs",operationLabel:a,violations:c}),L({bucket:l(f.inputs),label:"inputs",operationLabel:a,violations:c}),H({bucket:l(f.filterContracts),label:"filterContracts",operationLabel:a,violations:c}),L({bucket:l(f.filterContracts),label:"filterContracts",operationLabel:a,violations:c});for(const m of ee(l(f.views))){u.size>0&&!u.has(_(m.id))&&c.push({path:`views.${_(m.id)||"<unknown>"}`,reason:`${a} may only change explicitly targeted views.`});const h=Array.isArray(m.reasons)?m.reasons.filter(R=>typeof R!="string"||!o.has(R)):[];h.length>0&&c.push({path:`views.${_(m.id)||"<unknown>"}`,reason:`${a} may only adjust fields/sdkSpec/metricBindingKeys; changed ${h.join(", ")}.`})}const p=qe({beforeSummary:e,afterSummary:t,targetViewIds:u,label:a});return p&&c.push(p),{ok:c.length===0,policy:{kind:_(r==null?void 0:r.kind)||"diagnostic_fix",mode:i,allowedViewChangeReasons:Array.from(o).sort(),targetViewIds:Array.from(u).sort(),reason:s},violations:c}}function qe({beforeSummary:e,afterSummary:t,targetViewIds:n,label:r}){const i=l(e),o=l(t);if(!i||!o)return{path:"codegenSummary",reason:`${r} require before/after codegen summaries for full-scope verification.`};const a=P(i),s=P(o),c=z(i.views),u=z(o.views),f=Array.isArray(a.views)?a.views:[];a.views=f;for(const p of n){const m=c.get(p),h=u.get(p);if(!m||!h)continue;const R=f.find(te=>{var q;return((q=l(te))==null?void 0:q.id)===p}),v=l(h);if(!R||!v)continue;const N=R;N.fields=C(v.fields),N.metricBindingKeys=C(v.metricBindingKeys),N.sdkSpec=C(v.sdkSpec)}return O(a)===O(s)?null:{path:"codegenSummary",reason:`${r} may only change fields/sdkSpec/metricBindingKeys on targetViewIds; another generated contract section changed.`}}function P(e){const t=C(e);for(const n of["implementationChecklist","assumptions","nextStep","nextRequiredTool","validation"])delete t[n];return Ue(t.unsupportedInsights)&&delete t.unsupportedInsights,t}function H({bucket:e,label:t,operationLabel:n,violations:r}){for(const i of D(e==null?void 0:e.added))r.push({path:`${t}.${_(i.id)||"<unknown>"}`,reason:`${n} may not add ${t}.`});for(const i of D(e==null?void 0:e.removed))r.push({path:`${t}.${_(i.id)||"<unknown>"}`,reason:`${n} may not remove ${t}.`})}function L({bucket:e,label:t,operationLabel:n,violations:r}){for(const i of ee(e))r.push({path:`${t}.${_(i.id)||"<unknown>"}`,reason:`${n} may not change ${t}.`})}function ee(e){return D(e==null?void 0:e.changed)}function D(e){return Array.isArray(e)?e.map(l).filter(Be):[]}function je(e){return Array.isArray(e)?new Set(e.filter(t=>typeof t=="string"&&t.trim().length>0).map(t=>t.trim())):new Set}function z(e){var n;const t=new Map;for(const r of Array.isArray(e)?e:[]){const i=(n=l(r))==null?void 0:n.id;typeof i=="string"&&i.trim()&&t.set(i,r)}return t}function C(e){return e===void 0?e:JSON.parse(JSON.stringify(e))}function O(e){if(e===null||typeof e!="object")return JSON.stringify(e);if(Array.isArray(e))return`[${e.map(n=>O(n)).join(",")}]`;const t=e;return`{${Object.keys(t).sort().filter(n=>t[n]!==void 0).map(n=>`${JSON.stringify(n)}:${O(t[n])}`).join(",")}}`}function l(e){return e&&typeof e=="object"&&!Array.isArray(e)?e:void 0}function Be(e){return e!==void 0}function Ue(e){return Array.isArray(e)&&e.length===0}function _(e){return typeof e=="string"?e:""}exports.CODEGEN_SUMMARY_SCHEMA_VERSION=re;exports.CODEGEN_SUMMARY_VALIDATOR_VERSION=T;exports.CONTRACT_MANIFEST_SCHEMA_VERSION=G;exports.GENERATED_CONTRACT_SCHEMA_VERSION=k;exports.GENERATED_CONTRACT_TYPESCRIPT_FILES=J;exports.REQUIRED_GENERATED_CONTRACT_FILES=Y;exports.assertValidCodegenSummary=ne;exports.buildSemaphorGeneratedActiveInput=le;exports.buildSemaphorGeneratedInputOptionIntent=ge;exports.buildSemaphorGeneratedViewExecutionRequest=W;exports.buildSemaphorGeneratedViewExecutionRequests=pe;exports.evaluateSemaphorDataAppContractUpdatePolicy=xe;exports.validateCodegenSummary=x;exports.validateSemaphorGeneratedContract=se;