react-semaphor 0.1.449 → 0.1.454

package/dist/chunks/{analyze-result-contract-T-0Ntzys.js → analyze-result-contract-BbRJ-C06.js}

@@ -1,4 +1,4 @@
-import { f as t, g as n } from "./validators-Cs74WVie.js";
+import { g as t, h as n } from "./validators-DEmd8Sin.js";
 const o = new Set(
   Object.keys(t)
 );

package/dist/chunks/{analyze-result-contract-BHb7sUUW.cjs → analyze-result-contract-LPDNldic.cjs}

@@ -1 +1 @@
-"use strict";const t=require("./validators-9D4KBqKD.cjs"),a=new Set(Object.keys(t.SEMAPHOR_ANALYZE_RESULT_FIELD_CONTRACT));function o(){return Object.keys(t.SEMAPHOR_ANALYZE_RESULT_FIELD_CONTRACT)}function s(e){return a.has(e)}function l(e){if(!e||typeof e!="object"||Array.isArray(e))throw new Error("Semaphor analyze result must be an object.");const r=Object.keys(e).filter(n=>!s(n));if(r.length)throw new Error(`Semaphor analyze result contains unsupported top-level field(s): ${r.join(", ")}.`);return t.semaphorAnalyzeResultSchema.parse(e)}exports.getSemaphorAnalyzeResultFieldNames=o;exports.isSemaphorAnalyzeResultFieldName=s;exports.parseSemaphorAnalyzeResult=l;
+"use strict";const t=require("./validators-BDYprKI9.cjs"),a=new Set(Object.keys(t.SEMAPHOR_ANALYZE_RESULT_FIELD_CONTRACT));function o(){return Object.keys(t.SEMAPHOR_ANALYZE_RESULT_FIELD_CONTRACT)}function s(e){return a.has(e)}function l(e){if(!e||typeof e!="object"||Array.isArray(e))throw new Error("Semaphor analyze result must be an object.");const r=Object.keys(e).filter(n=>!s(n));if(r.length)throw new Error(`Semaphor analyze result contains unsupported top-level field(s): ${r.join(", ")}.`);return t.semaphorAnalyzeResultSchema.parse(e)}exports.getSemaphorAnalyzeResultFieldNames=o;exports.isSemaphorAnalyzeResultFieldName=s;exports.parseSemaphorAnalyzeResult=l;

package/dist/chunks/canonical-result-keys-BA0HCP4e.cjs

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

package/dist/chunks/canonical-result-keys-D6avdjpA.js

@@ -0,0 +1,467 @@
+import "./validators-DEmd8Sin.js";
+import "./analyze-result-contract-BbRJ-C06.js";
+import { g as I, C as k } from "./temporal-bucket-5UYEotyQ.js";
+import "../value-format-preferences/index.js";
+const _ = /* @__PURE__ */ new Set([
+  "previous_period",
+  "same_period_last_year",
+  "start_vs_end",
+  "target"
+]), V = /* @__PURE__ */ new Set([..._, "none", ""]);
+function l(e) {
+  return !!e && typeof e == "object" && !Array.isArray(e);
+}
+function E(e) {
+  const o = l(e.preferences) ? e.preferences : void 0, r = o && l(o.kpiVisualOptions) ? o.kpiVisualOptions : void 0, i = o && l(o.tableVisualOptions) ? o.tableVisualOptions : void 0;
+  return {
+    preferences: o,
+    kpiOptions: r,
+    kpiComparison: r && l(r.metricComparison) ? r.metricComparison : void 0,
+    kpiComparisonPresent: !!r && "metricComparison" in r,
+    tableOptions: i,
+    tableComparison: i && l(i.metricComparison) ? i.metricComparison : void 0,
+    tableComparisonPresent: !!i && "metricComparison" in i
+  };
+}
+function $(e) {
+  const o = [], r = (i, a) => {
+    if (Array.isArray(i)) {
+      i.forEach((n, c) => r(n, `${a}[${c}]`));
+      return;
+    }
+    if (!l(i)) return;
+    const m = i.config;
+    if (l(m)) {
+      const n = E(i), c = !!(n.kpiComparisonPresent || n.tableComparisonPresent), g = m.metricColumns, p = Array.isArray(g) ? g.flatMap(
+        (s, t) => l(s) ? [{ index: t, metric: s }] : []
+      ) : [];
+      if ((p.some(({ metric: s }) => "comparisonType" in s) || c) && o.push({
+        path: a,
+        card: i,
+        metrics: p,
+        malformedMetricIndexes: Array.isArray(g) ? g.flatMap(
+          (s, t) => l(s) ? [] : [t]
+        ) : [],
+        malformedMetricColumns: "metricColumns" in m && !Array.isArray(g),
+        hasLegacyPresentation: c
+      }), "metricColumns" in m || c) return;
+    }
+    Object.entries(i).forEach(
+      ([n, c]) => r(c, a ? `${a}.${n}` : n)
+    );
+  };
+  return r(e, "$"), o;
+}
+const A = {
+  difference: "difference",
+  change: "percent_change",
+  change_difference: "both",
+  ratio: "ratio"
+};
+function O(e, o) {
+  if (!e) return;
+  const r = Object.fromEntries(
+    o.flatMap(
+      (i) => typeof e[i] == "string" ? [[i, e[i]]] : []
+    )
+  );
+  return Object.keys(r).length ? r : void 0;
+}
+function N(e, o, r) {
+  if (e !== void 0) {
+    if (!l(e)) {
+      r.push({
+        severity: "error",
+        code: "invalid_legacy_comparison_presentation",
+        path: o,
+        message: "Legacy comparison formatOptions must be an object."
+      });
+      return;
+    }
+    Object.entries(e).forEach(([i, a]) => {
+      if (i === "decimalPlaces") {
+        (typeof a != "number" || !Number.isInteger(a) || a < 0 || a > 6) && r.push({
+          severity: "error",
+          code: "invalid_legacy_comparison_presentation",
+          path: `${o}.decimalPlaces`,
+          message: "Legacy comparison decimalPlaces must be an integer from 0 through 6."
+        });
+        return;
+      }
+      i === "type" && (a === void 0 || a === "auto") || a !== void 0 && r.push({
+        severity: "error",
+        code: "unsupported_comparison_format",
+        path: `${o}.${i}`,
+        message: `Legacy comparison format option "${i}" has no canonical presentation mapping.`
+      });
+    });
+  }
+}
+function v(e, o) {
+  const r = o === "kpi" ? e.calculationType : e.calculatedAs, i = o === "table" && r === void 0 ? "both" : A[String(r)], a = l(e.formatOptions) ? e.formatOptions : void 0, m = l(e.conditionalLabels) ? e.conditionalLabels : void 0, n = l(
+    o === "kpi" ? e.colorConfig : e.colors
+  ) ? o === "kpi" ? e.colorConfig : e.colors : void 0, c = {};
+  if (i && (c.displayMode = i), typeof (a == null ? void 0 : a.decimalPlaces) == "number" && (c.precision = a.decimalPlaces), o === "kpi") {
+    const s = e.showArrow !== !1, t = e.showColor !== !1;
+    c.indicatorStyle = s ? t ? "arrow_badge" : "arrow" : t ? "badge" : "none", c.showColor = t, (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 g = m ? {
+    ...O(m, ["increase", "decrease"]),
+    ...typeof m.noChange == "string" ? { neutral: m.noChange } : typeof m.neutral == "string" ? { neutral: m.neutral } : {}
+  } : void 0;
+  g && Object.keys(g).length && (c.conditionalLabels = g);
+  const p = n ? {
+    ...O(n, ["increase", "decrease"]),
+    ...typeof n.noChange == "string" ? { neutral: n.noChange } : typeof n.neutral == "string" ? { neutral: n.neutral } : {}
+  } : void 0;
+  return p && Object.keys(p).length && (c.colors = p), c;
+}
+function w(e) {
+  return { ...k, ...e };
+}
+function P(e) {
+  return e.some(({ metric: o }) => o.comparisonType === "previous_period" || o.comparisonType === "same_period_last_year" || o.comparisonType === "target" ? !0 : l(o.comparison) && o.comparison.mode === "explicit");
+}
+function C(e) {
+  const o = e.card.config;
+  return e.metrics.length === 2 && (o.groupByColumns === void 0 || Array.isArray(o.groupByColumns) && o.groupByColumns.length === 0);
+}
+function L(e, o, r, i) {
+  const a = o === "kpi" ? [
+    "enabled",
+    "calculationType",
+    "formatOptions",
+    "showArrow",
+    "showColor",
+    "conditionalLabel",
+    "labelName",
+    "position",
+    "conditionalLabels",
+    "colorConfig",
+    "lowerIsBetter"
+  ] : [
+    "calculatedAs",
+    "indicatorStyle",
+    "formatOptions",
+    "colors",
+    "lowerIsBetter"
+  ];
+  Object.keys(e).forEach((s) => {
+    a.includes(s) || i.push({
+      severity: "error",
+      code: "invalid_legacy_comparison_presentation",
+      path: `${r}.${s}`,
+      message: `Unknown legacy comparison presentation field "${s}" cannot be dropped automatically.`
+    });
+  });
+  const m = o === "kpi" ? "calculationType" : "calculatedAs";
+  e[m] !== void 0 && !A[String(e[m])] && i.push({
+    severity: "error",
+    code: "invalid_legacy_comparison_presentation",
+    path: `${r}.${m}`,
+    message: `Legacy comparison ${m} is unsupported.`
+  }), o === "kpi" && e.position !== void 0 && !["left", "right", "top"].includes(String(e.position)) && i.push({
+    severity: "error",
+    code: "invalid_legacy_comparison_presentation",
+    path: `${r}.position`,
+    message: "Legacy comparison position is unsupported."
+  }), o === "kpi" && e.labelName !== void 0 && typeof e.labelName != "string" && i.push({
+    severity: "error",
+    code: "invalid_legacy_comparison_presentation",
+    path: `${r}.labelName`,
+    message: "Legacy comparison labelName must be a string."
+  }), (o === "kpi" ? [
+    ["conditionalLabels", ["increase", "decrease", "noChange"]],
+    ["colorConfig", ["increase", "decrease", "noChange"]]
+  ] : [["colors", ["increase", "decrease", "neutral"]]]).forEach(([s, t]) => {
+    if (e[s] !== void 0) {
+      if (!l(e[s])) {
+        i.push({
+          severity: "error",
+          code: "invalid_legacy_comparison_presentation",
+          path: `${r}.${s}`,
+          message: `Legacy comparison ${s} must be an object.`
+        });
+        return;
+      }
+      Object.entries(e[s]).forEach(([u, f]) => {
+        t.includes(u) ? typeof f != "string" && i.push({
+          severity: "error",
+          code: "invalid_legacy_comparison_presentation",
+          path: `${r}.${s}.${u}`,
+          message: `Legacy comparison ${s}.${u} must be a string.`
+        }) : i.push({
+          severity: "error",
+          code: "invalid_legacy_comparison_presentation",
+          path: `${r}.${s}.${u}`,
+          message: `Unknown legacy comparison ${s} field "${u}" cannot be dropped automatically.`
+        });
+      });
+    }
+  }), (o === "kpi" ? ["enabled", "showArrow", "showColor", "conditionalLabel", "lowerIsBetter"] : ["lowerIsBetter"]).forEach((s) => {
+    e[s] !== void 0 && typeof e[s] != "boolean" && i.push({
+      severity: "error",
+      code: "invalid_legacy_comparison_presentation",
+      path: `${r}.${s}`,
+      message: `Legacy comparison ${s} must be a boolean.`
+    });
+  }), o === "table" && e.indicatorStyle !== void 0 && !["arrow_badge", "arrow", "badge", "none"].includes(
+    String(e.indicatorStyle)
+  ) && i.push({
+    severity: "error",
+    code: "invalid_legacy_comparison_presentation",
+    path: `${r}.indicatorStyle`,
+    message: "Legacy comparison indicatorStyle is unsupported."
+  }), N(e.formatOptions, `${r}.formatOptions`, i);
+  const g = v(e, o);
+  I(g, r).errors.forEach((s) => {
+    i.push({
+      severity: "error",
+      code: "invalid_legacy_comparison_presentation",
+      path: s.path || r,
+      message: s.message
+    });
+  });
+}
+function T(e) {
+  const o = E(e.card), r = o.kpiComparison ? v(o.kpiComparison, "kpi") : void 0, i = o.tableComparison ? v(o.tableComparison, "table") : void 0;
+  return { namespaces: o, kpi: r, table: i, presentation: r || i };
+}
+function M(e) {
+  const o = l(e.preferences) ? e.preferences : {}, r = l(o.kpiVisualOptions) ? o.kpiVisualOptions : {}, i = l(r.metricComparison) ? r.metricComparison : {}, a = l(o.tableVisualOptions) ? o.tableVisualOptions : {}, m = l(a.metricComparison) ? a.metricComparison : {};
+  return r.lowerIsBetter === !0 || i.lowerIsBetter === !0 || m.lowerIsBetter === !0 ? "lower_is_better" : "higher_is_better";
+}
+function B(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 R(e) {
+  const o = l(e.preferences) ? e.preferences : void 0;
+  if (!o) return;
+  const r = l(o.kpiVisualOptions) ? o.kpiVisualOptions : void 0;
+  r && delete r.lowerIsBetter;
+  const i = l(o.tableVisualOptions) ? o.tableVisualOptions : void 0, a = i && l(i.metricComparison) ? i.metricComparison : void 0;
+  a && delete a.lowerIsBetter;
+}
+function G(e) {
+  const o = $(e);
+  if (!o.length)
+    return { document: e, changed: !1, changes: [], diagnostics: [] };
+  const r = [];
+  if (o.forEach((n) => {
+    var c, g, p, s;
+    if (n.malformedMetricColumns && r.push({
+      severity: "error",
+      code: "malformed_metric_columns",
+      path: `${n.path}.config.metricColumns`,
+      message: "Metric columns must be an array before comparison migration."
+    }), n.malformedMetricIndexes.forEach((t) => {
+      r.push({
+        severity: "error",
+        code: "malformed_metric_columns",
+        path: `${n.path}.config.metricColumns[${t}]`,
+        message: "Metric columns must contain objects before comparison migration."
+      });
+    }), n.metrics.forEach(({ metric: t, index: u }) => {
+      if (!("comparisonType" in t)) return;
+      const f = `${n.path}.config.metricColumns[${u}]`, d = String(t.comparisonType || "");
+      "comparison" in t && r.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(t.parameters) ? t.parameters : void 0, b = h && l(h.windowTransform) ? h.windowTransform : void 0;
+      _.has(d) && (b == null ? void 0 : b.function) === "previous_period_delta" && r.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."
+      }), V.has(d) || r.push({
+        severity: "error",
+        code: "unsupported_comparison_type",
+        path: `${f}.comparisonType`,
+        message: `Unsupported legacy metric comparison type "${d}".`
+      }), t.comparisonType === "target" && (typeof t.targetValue != "number" || !Number.isFinite(t.targetValue)) && r.push({
+        severity: "error",
+        code: "invalid_target_value",
+        path: `${f}.targetValue`,
+        message: "Legacy target comparison requires a finite metric targetValue."
+      }), t.comparisonType === "start_vs_end" && r.push({
+        severity: "error",
+        code: "unsupported_start_vs_end",
+        path: `${f}.comparisonType`,
+        message: "start_vs_end is retired and cannot be migrated automatically."
+      }), t.targetValue !== void 0 && t.comparisonType !== "target" && r.push({
+        severity: "warning",
+        code: "stray_target_value",
+        path: `${f}.targetValue`,
+        message: "Dead non-target targetValue will be removed without changing the baseline."
+      });
+    }), n.hasLegacyPresentation) {
+      const { namespaces: t, kpi: u, table: f } = T(n), d = [
+        (c = t.kpiOptions) == null ? void 0 : c.lowerIsBetter,
+        (g = t.kpiComparison) == null ? void 0 : g.lowerIsBetter,
+        (p = t.tableComparison) == null ? void 0 : p.lowerIsBetter
+      ].filter((h) => typeof h == "boolean");
+      new Set(d).size > 1 && r.push({
+        severity: "error",
+        code: "conflicting_legacy_polarity",
+        path: `${n.path}.preferences`,
+        message: "Legacy comparison polarity values disagree; resolve the conflict before migration."
+      }), ((s = t.kpiOptions) == null ? void 0 : s.lowerIsBetter) !== void 0 && typeof t.kpiOptions.lowerIsBetter != "boolean" && r.push({
+        severity: "error",
+        code: "invalid_legacy_comparison_presentation",
+        path: `${n.path}.preferences.kpiVisualOptions.lowerIsBetter`,
+        message: "Legacy comparison lowerIsBetter must be a boolean."
+      }), t.kpiComparisonPresent && !t.kpiComparison && r.push({
+        severity: "error",
+        code: "invalid_legacy_comparison_presentation",
+        path: `${n.path}.preferences.kpiVisualOptions.metricComparison`,
+        message: "Legacy KPI comparison presentation must be an object."
+      }), t.tableComparisonPresent && !t.tableComparison && r.push({
+        severity: "error",
+        code: "invalid_legacy_comparison_presentation",
+        path: `${n.path}.preferences.tableVisualOptions.metricComparison`,
+        message: "Legacy table comparison presentation must be an object."
+      }), "comparisonPresentation" in (t.preferences || {}) && r.push({
+        severity: "error",
+        code: "conflicting_comparison_presentation_contracts",
+        path: `${n.path}.preferences.comparisonPresentation`,
+        message: "Card contains both legacy and canonical comparison presentation; resolve the conflict before migration."
+      }), t.kpiComparison && typeof t.kpiComparison.enabled == "boolean" && "metricPairComparisonEnabled" in (t.preferences || {}) && C(n) && r.push({
+        severity: "error",
+        code: "conflicting_comparison_presentation_contracts",
+        path: `${n.path}.preferences.metricPairComparisonEnabled`,
+        message: "Card contains both legacy and canonical metric-pair enablement; resolve the conflict before migration."
+      }), t.kpiComparison && L(
+        t.kpiComparison,
+        "kpi",
+        `${n.path}.preferences.kpiVisualOptions.metricComparison`,
+        r
+      ), t.tableComparison && L(
+        t.tableComparison,
+        "table",
+        `${n.path}.preferences.tableVisualOptions.metricComparison`,
+        r
+      ), u && f && JSON.stringify(w(u)) !== JSON.stringify(w(f)) && r.push({
+        severity: "error",
+        code: "conflicting_legacy_presentation_namespaces",
+        path: `${n.path}.preferences`,
+        message: "KPI and table comparison presentation values disagree; resolve the conflict before migration."
+      });
+    }
+  }), r.some((n) => n.severity === "error"))
+    return { document: e, changed: !1, changes: [], diagnostics: r };
+  const i = JSON.parse(JSON.stringify(e)), a = $(i), m = [];
+  return a.forEach((n) => {
+    var g;
+    const c = M(n.card);
+    if (n.metrics.forEach(({ metric: p, index: s }) => {
+      if (!("comparisonType" in p)) return;
+      const t = String(p.comparisonType || ""), u = `${n.path}.config.metricColumns[${s}]`, f = B(p), d = ["comparisonType"];
+      delete p.comparisonType, "targetValue" in p && (delete p.targetValue, d.push("targetValue")), "comparisonDisplay" in p && (delete p.comparisonDisplay, d.push("comparisonDisplay")), f ? p.comparison = f : delete p.comparison, _.has(t) && (p.comparisonPolarity = c), m.push({
+        kind: "metric",
+        path: u,
+        metricId: typeof p.id == "string" ? p.id : void 0,
+        legacyType: t,
+        comparison: f,
+        comparisonPolarity: _.has(t) ? c : void 0,
+        removedFields: d
+      });
+    }), R(n.card), n.hasLegacyPresentation) {
+      const { namespaces: p, presentation: s } = T(n), t = (g = p.kpiComparison) == null ? void 0 : g.enabled, u = {
+        ...s
+      };
+      typeof t == "boolean" && P(n.metrics) && (u.showComparison = t);
+      const f = typeof t == "boolean" && C(n) ? t : void 0, d = typeof t == "boolean" && !P(n.metrics) && !C(n) ? ["kpiVisualOptions.metricComparison.enabled"] : void 0, h = p.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), p.kpiOptions && delete p.kpiOptions.metricComparison, p.tableOptions && delete p.tableOptions.metricComparison, m.push({
+        kind: "presentation",
+        path: `${n.path}.preferences`,
+        comparisonPresentation: Object.keys(u).length ? u : void 0,
+        metricPairComparisonEnabled: f,
+        comparisonPolarityMetricIds: b,
+        intentionallyDiscardedFields: d,
+        removedFields: [
+          ...p.kpiComparison ? ["kpiVisualOptions.metricComparison"] : [],
+          ...p.tableComparison ? ["tableVisualOptions.metricComparison"] : []
+        ]
+      });
+    }
+  }), { document: i, changed: !0, changes: m, diagnostics: r };
+}
+const D = [
+  "bar",
+  "horizontalBar",
+  "line",
+  "area",
+  "stackedArea",
+  "combo",
+  "stackedBar",
+  "stackedLine"
+], x = new Set(
+  D
+);
+function j(e) {
+  return typeof e == "string" && x.has(e);
+}
+function J(e) {
+  return e === "detailTable" || e === "table" || e === "aggregateTable" || e === "pivotTable" || e === "custom" || j(e);
+}
+function S(e) {
+  return !!(e != null && e.trim());
+}
+function q(e) {
+  return S(e.sql) || S(e.normalizedPython) ? "freeform" : e.hasExecutableConfig ? "config" : "none";
+}
+const F = "SEMAPHOR_CALCULATED_FIELD";
+function K(e, o, r) {
+  if (r && (o === "groupby" || o === "pivotby"))
+    return r;
+  if (o === "metric" && e.name === "*" && !e.expression)
+    return e.alias || "count";
+  if (e.alias) return e.alias;
+  const i = e.entityName && e.entityName !== F ? e.entityName : void 0;
+  if (e.role === "metric") {
+    let a = e.aggregate || "metric";
+    if (e.expression) {
+      const m = e.expression.match(
+        /^(COUNT|SUM|AVG|MIN|MAX|MEDIAN|DISTINCT)\s*\(/i
+      );
+      a = m ? m[1].toLowerCase() : "expr";
+    } else
+      a = a.toLowerCase();
+    return i && i !== e.name ? `${i}_${e.name}_${a}` : `${e.name}_${a}`;
+  }
+  return i && i !== e.name ? `${i}_${e.name}` : e.name;
+}
+function W(e) {
+  return K(e, "detail");
+}
+function X(e) {
+  const o = e.label;
+  return o && e.labelCount === 1 && (o === e.rawKey || !e.rawKeys.has(o)) ? o : e.rawKey;
+}
+export {
+  D as S,
+  K as a,
+  W as b,
+  X as c,
+  j as i,
+  q as r,
+  J as s,
+  G as t
+};