react-semaphor 0.1.477 → 0.1.478

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (109) hide show
  1. package/dist/analytics-protocol/index.cjs +1 -1
  2. package/dist/analytics-protocol/index.js +9 -9
  3. package/dist/brand-studio/index.cjs +1 -1
  4. package/dist/brand-studio/index.js +4 -4
  5. package/dist/briefings/index.cjs +1 -1
  6. package/dist/briefings/index.js +4 -4
  7. package/dist/chunks/{analyze-result-contract-OgPk-zGu.cjs → analyze-result-contract-BX_nQmPN.cjs} +1 -1
  8. package/dist/chunks/{analyze-result-contract-C8s8EUL5.js → analyze-result-contract-DsiAzCYn.js} +1 -1
  9. package/dist/chunks/{saved-temporal-bucket-format-CHsXUPJI.js → card-config-utils-CyDKaPNT.js} +190 -190
  10. package/dist/chunks/card-config-utils-D3Xuu0ub.cjs +1 -0
  11. package/dist/chunks/{common-types-C1IM7gao.cjs → common-types-BCSbPclk.cjs} +1 -1
  12. package/dist/chunks/{common-types-BLPy5_E0.js → common-types-D3r4PILe.js} +1 -1
  13. package/dist/chunks/{dashboard-briefing-launcher-CXHq6ime.cjs → dashboard-briefing-launcher-7qAW16mO.cjs} +2 -2
  14. package/dist/chunks/{dashboard-briefing-launcher-C9d8CPxv.js → dashboard-briefing-launcher-DAhtLQPc.js} +134 -134
  15. package/dist/chunks/{dashboard-controls-BqDm4ARp.js → dashboard-controls-C_CBmEwW.js} +13 -12
  16. package/dist/chunks/{dashboard-controls-d7Yd2fJb.cjs → dashboard-controls-CoVqAeKG.cjs} +10 -10
  17. package/dist/chunks/{dashboard-input-contract-JFJZgenC.cjs → dashboard-date-comparison-definition-C93wv8Ua.cjs} +1 -1
  18. package/dist/chunks/{dashboard-input-contract-BrGdGFz0.js → dashboard-date-comparison-definition-KohOqBqR.js} +19 -19
  19. package/dist/chunks/dashboard-filter-value-compatibility-BAatYtUS.js +1215 -0
  20. package/dist/chunks/dashboard-filter-value-compatibility-Bco2gN96.cjs +1 -0
  21. package/dist/chunks/{dashboard-json-CL_vgcWq.js → dashboard-json-0w58H39L.js} +7 -7
  22. package/dist/chunks/dashboard-json-B3XSl7b_.cjs +1 -0
  23. package/dist/chunks/{edit-dashboard-visual-Dklel3MC.cjs → edit-dashboard-visual-BsLRKeuO.cjs} +6 -6
  24. package/dist/chunks/{edit-dashboard-visual-C0Zvyo-X.js → edit-dashboard-visual-BsWEU8xf.js} +277 -277
  25. package/dist/chunks/{editor-action-buttons-BOyUtX9j.js → editor-action-buttons-B3CB5c__.js} +39 -39
  26. package/dist/chunks/{editor-action-buttons-AcaZsiDy.cjs → editor-action-buttons-DMLDvrJD.cjs} +1 -1
  27. package/dist/chunks/{index-Cd8qGOXl.cjs → index--0Il-Bpd.cjs} +238 -238
  28. package/dist/chunks/{format-types-CFHQoIuk.js → index-BS0_dp0l.js} +168 -168
  29. package/dist/chunks/{index-D9S3j7_z.js → index-BvRREsU9.js} +9 -9
  30. package/dist/chunks/index-ByQgqT9d.cjs +1 -0
  31. package/dist/chunks/{index-v2MZLyus.cjs → index-CXeIDdjd.cjs} +1 -1
  32. package/dist/chunks/{index-DrdF7QR7.js → index-DgGcVyUs.js} +30518 -31308
  33. package/dist/chunks/matrix-result-contract-CFPnlcLm.cjs +1 -0
  34. package/dist/chunks/{matrix-result-contract-BpzhImar.js → matrix-result-contract-DFfUvb1r.js} +3 -3
  35. package/dist/chunks/{temporal-bucket-CtP7hKLa.js → metric-comparison-CTexJ8V1.js} +705 -705
  36. package/dist/chunks/metric-comparison-x0lipytf.cjs +1 -0
  37. package/dist/chunks/pivot-header-presentation-8Ra1RfHg.cjs +4 -0
  38. package/dist/chunks/{pivot-header-presentation-CaERAWpl.js → pivot-header-presentation-tpb_J900.js} +118 -118
  39. package/dist/chunks/{pivot-result-identity-CIZXsI53.js → pivot-result-identity-BIeP9v8I.js} +1 -1
  40. package/dist/chunks/{pivot-result-identity-DRUlTWUq.cjs → pivot-result-identity-BVnhG2rR.cjs} +1 -1
  41. package/dist/chunks/pivot-result-lifecycle-D_bRCqaB.cjs +1 -0
  42. package/dist/chunks/{pivot-result-lifecycle-B9FTybxN.js → pivot-result-lifecycle-mjJ1rBvV.js} +7 -7
  43. package/dist/chunks/{raw-temporal-contract-U8J9RlEH.js → raw-temporal-contract-BuQIB31z.js} +1 -1
  44. package/dist/chunks/{raw-temporal-contract-D8YuxTAg.cjs → raw-temporal-contract-vnNwLy9R.cjs} +1 -1
  45. package/dist/chunks/{report-preferences-dialog-BjygtSP3.js → report-preferences-dialog-Bytgubvz.js} +25 -25
  46. package/dist/chunks/report-preferences-dialog-I0Pbn_Yb.cjs +1 -0
  47. package/dist/chunks/{report-runtime-context-DNbgCsko.js → report-runtime-context-B_pAmqxl.js} +1 -1
  48. package/dist/chunks/{report-runtime-context-RFiWq4wK.cjs → report-runtime-context-BfW4qiMJ.cjs} +1 -1
  49. package/dist/chunks/{source-entity-resolution-BDC-Qngk.cjs → source-entity-resolution-DCAAS-y8.cjs} +1 -1
  50. package/dist/chunks/{source-entity-resolution-ugN3sZUk.js → source-entity-resolution-WUstJID6.js} +1 -1
  51. package/dist/chunks/{switch-C8NihGV4.js → switch-BsGTOjuD.js} +12342 -11110
  52. package/dist/chunks/switch-Cpj3DrCZ.cjs +138 -0
  53. package/dist/chunks/{temporal-bucket-authoring-DJ9kK2wD.js → temporal-bucket-authoring-CyTCHy1K.js} +3 -3
  54. package/dist/chunks/temporal-bucket-authoring-DueSgLJU.cjs +1 -0
  55. package/dist/chunks/{temporal-bucket-contract-CZl5D7FZ.js → temporal-bucket-contract-BeOx0uYe.js} +1 -1
  56. package/dist/chunks/{temporal-bucket-contract-BD862TAa.cjs → temporal-bucket-contract-Cp-usD9Z.cjs} +1 -1
  57. package/dist/chunks/{token-types-CoHsSJ4E.cjs → token-types-D9eN35rf.cjs} +1 -1
  58. package/dist/chunks/{token-types-DfDtCqlw.js → token-types-Dvomvqw0.js} +1 -1
  59. package/dist/chunks/{update-policy-BGNXFgBU.cjs → update-policy-Buw2LmvX.cjs} +1 -1
  60. package/dist/chunks/{update-policy-BybMiM61.js → update-policy-MWg0aH3d.js} +1 -1
  61. package/dist/chunks/{validators-D-T-2HOR.js → validators-D3AarM2T.js} +662 -663
  62. package/dist/chunks/validators-DqIM0B3C.cjs +1 -0
  63. package/dist/dashboard/index.cjs +1 -1
  64. package/dist/dashboard/index.js +2 -2
  65. package/dist/dashboard-authoring/index.cjs +3 -3
  66. package/dist/dashboard-authoring/index.js +81 -79
  67. package/dist/data-app-builder/index.cjs +1 -1
  68. package/dist/data-app-builder/index.js +2 -2
  69. package/dist/data-app-codegen/index.cjs +1 -1
  70. package/dist/data-app-codegen/index.js +2 -2
  71. package/dist/data-app-codegen-node/index.cjs +1 -1
  72. package/dist/data-app-codegen-node/index.js +3 -3
  73. package/dist/data-app-sdk/index.cjs +1 -1
  74. package/dist/data-app-sdk/index.js +3 -3
  75. package/dist/data-app-sdk-adapters/index.cjs +1 -1
  76. package/dist/data-app-sdk-adapters/index.js +2 -2
  77. package/dist/data-app-sdk-validation/index.cjs +1 -1
  78. package/dist/data-app-sdk-validation/index.js +3 -3
  79. package/dist/format-utils/index.cjs +3 -3
  80. package/dist/format-utils/index.js +9 -9
  81. package/dist/index.cjs +1 -1
  82. package/dist/index.js +177 -176
  83. package/dist/report-runtime-context/index.cjs +1 -1
  84. package/dist/report-runtime-context/index.js +2 -2
  85. package/dist/surfboard/index.cjs +1 -1
  86. package/dist/surfboard/index.js +3 -3
  87. package/dist/types/briefings.d.ts +11 -0
  88. package/dist/types/dashboard-authoring.d.ts +17 -0
  89. package/dist/types/dashboard.d.ts +11 -0
  90. package/dist/types/index.cjs +1 -1
  91. package/dist/types/index.js +4 -4
  92. package/dist/types/main.d.ts +12 -0
  93. package/dist/types/shared.d.ts +11 -0
  94. package/dist/types/surfboard.d.ts +11 -0
  95. package/dist/types/types.d.ts +11 -0
  96. package/package.json +1 -1
  97. package/dist/chunks/dashboard-filter-value-compatibility-BCVF9IHg.js +0 -1026
  98. package/dist/chunks/dashboard-filter-value-compatibility-DLkdeypb.cjs +0 -1
  99. package/dist/chunks/dashboard-json-BYQjTmqD.cjs +0 -1
  100. package/dist/chunks/format-types-PSZZ7hG8.cjs +0 -1
  101. package/dist/chunks/matrix-result-contract-Bhg60NtS.cjs +0 -1
  102. package/dist/chunks/pivot-header-presentation-CePk1R6g.cjs +0 -4
  103. package/dist/chunks/pivot-result-lifecycle-CcGt_29N.cjs +0 -1
  104. package/dist/chunks/report-preferences-dialog-DW40ECz1.cjs +0 -1
  105. package/dist/chunks/saved-temporal-bucket-format-DNMtD77o.cjs +0 -1
  106. package/dist/chunks/switch-B1mZx2k9.cjs +0 -138
  107. package/dist/chunks/temporal-bucket-9Wz9Ds6H.cjs +0 -1
  108. package/dist/chunks/temporal-bucket-authoring-DSpzgXHc.cjs +0 -1
  109. package/dist/chunks/validators-DcshgK7w.cjs +0 -1
@@ -1 +0,0 @@
1
- "use strict";var q=Object.defineProperty;var B=(e,r,t)=>r in e?q(e,r,{enumerable:!0,configurable:!0,writable:!0,value:t}):e[r]=t;var v=(e,r,t)=>B(e,typeof r!="symbol"?r+"":r,t);const h=require("./validators-DcshgK7w.cjs"),I=require("../value-format-preferences/index.cjs"),F="higher_is_better",G={displayMode:"difference",showComparison:!0,indicatorStyle:"arrow_badge",showColor:!0,conditionalLabel:!1};function V(e){return h.parseSemaphorIsoInstant(e)!==null}function H(e){var r,t,o,n;if(((r=e.metricComparison)==null?void 0:r.mode)!=="off"){if(((t=e.metricComparison)==null?void 0:t.mode)==="explicit")return{source:"explicit",spec:e.metricComparison.spec};if(!((e.inheritGlobalComparison??((o=e.globalDateComparison)==null?void 0:o.inheritGlobalComparison))===!1||((n=e.globalDateComparison)==null?void 0:n.selection.mode)!=="period"))return{source:"inherited",spec:e.globalDateComparison.selection.spec,...e.globalDateComparison.owner?{owner:e.globalDateComparison.owner}:{}}}}function J(e){if(e.alias)return e.alias;const r=e.entityName&&e.entityName!=="SEMAPHOR_CALCULATED_FIELD"?e.entityName:void 0,t=r&&r!==e.name?`${r}_`:"";if(e.role!=="metric")return`${t}${e.name}`;let o=e.aggregate||"metric";if(e.expression){const n=e.expression.match(/^(COUNT|SUM|AVG|MIN|MAX|MEDIAN|DISTINCT)\s*\(/i);o=n?n[1].toLowerCase():"expr"}else o=o.toLowerCase();return`${t}${e.name}_${o}`}function i(e,r,t){return t?{code:e,message:r,path:t}:{code:e,message:r}}function d(e){return!!e&&typeof e=="object"&&!Array.isArray(e)}function u(e,r,t,o){Object.keys(e).forEach(n=>{r.includes(n)||o.push(i("invalid_comparison_spec",`Comparison kind does not accept field "${n}".`,`${t}.${n}`))})}function D(e,r,t){e.alignment!==void 0&&e.alignment!=="calendar"&&e.alignment!=="weekday"&&t.push(i("invalid_comparison_spec",'Comparison alignment must be "calendar" or "weekday".',`${r}.alignment`)),e.toDate!==void 0&&typeof e.toDate!="boolean"&&t.push(i("invalid_comparison_spec","Comparison toDate must be a boolean.",`${r}.toDate`))}function E(e,r,t){e!==void 0&&(typeof e!="number"||!Number.isSafeInteger(e)||e<=0)&&t.push(i("invalid_comparison_spec","Comparison offset must be a positive safe integer.",r))}function T(e,r="comparison"){const t=[];return d(e)?(e.kind==="previous_period"?(u(e,["kind","offsetPeriods","alignment","toDate"],r,t),E(e.offsetPeriods,`${r}.offsetPeriods`,t),D(e,r,t)):e.kind==="previous_year"?(u(e,["kind","offsetYears","alignment","toDate"],r,t),E(e.offsetYears,`${r}.offsetYears`,t),D(e,r,t)):e.kind==="target"?(u(e,["kind","targetValue"],r,t),(typeof e.targetValue!="number"||!Number.isFinite(e.targetValue))&&t.push(i("invalid_comparison_spec","Target comparison requires a finite targetValue.",`${r}.targetValue`))):t.push(i("invalid_comparison_spec","Comparison kind must be previous_period, previous_year, or target.",`${r}.kind`)),{ok:t.length===0,errors:t,warnings:[]}):{ok:!1,errors:[i("invalid_comparison_spec","Comparison spec must be an object.",r)],warnings:[]}}function z(e,r="comparison"){if(!d(e))return{ok:!1,errors:[i("invalid_comparison_config","Comparison config must be an object.",r)],warnings:[]};const t=[];return e.mode==="off"?u(e,["mode"],r,t):e.mode==="explicit"?(u(e,["mode","spec"],r,t),t.push(...T(e.spec,`${r}.spec`).errors)):t.push(i("invalid_comparison_config","Comparison mode must be off or explicit.",`${r}.mode`)),{ok:t.length===0,errors:t,warnings:[]}}function R(e,r="comparisonSelection"){if(!d(e))return{ok:!1,errors:[i("invalid_global_date_comparison","Global Date comparison selection must be an object.",r)],warnings:[]};const t=[];if(e.mode==="off")u(e,["mode"],r,t);else if(e.mode==="period"){u(e,["mode","spec"],r,t);const o=T(e.spec,`${r}.spec`);t.push(...o.errors),d(e.spec)&&e.spec.kind==="target"&&t.push(i("invalid_global_date_comparison","Global Date comparison supports previous_period or previous_year, not target.",`${r}.spec.kind`))}else t.push(i("invalid_global_date_comparison","Global Date comparison mode must be off or period.",`${r}.mode`));return{ok:t.length===0,errors:t,warnings:[]}}function Z(e,r="globalDateComparison"){if(!d(e))return{ok:!1,errors:[i("invalid_global_date_comparison","Global Date comparison context must be an object.",r)],warnings:[]};const t=[];return u(e,["selection","inheritGlobalComparison","owner","referenceTime"],r,t),t.push(...R(e.selection,`${r}.selection`).errors),e.inheritGlobalComparison!==void 0&&e.inheritGlobalComparison!==!1&&t.push(i("invalid_global_date_comparison","inheritGlobalComparison may only be false when present.",`${r}.inheritGlobalComparison`)),e.owner!==void 0&&(d(e.owner)?e.owner.kind==="global_date"?u(e.owner,["kind"],`${r}.owner`,t):e.owner.kind==="field_date"?(u(e.owner,["kind","filterId","label"],`${r}.owner`,t),(typeof e.owner.filterId!="string"||!e.owner.filterId.trim())&&t.push(i("invalid_global_date_comparison","Field Date comparison owner requires a non-empty filterId.",`${r}.owner.filterId`)),(typeof e.owner.label!="string"||!e.owner.label.trim())&&t.push(i("invalid_global_date_comparison","Field Date comparison owner requires a non-empty label.",`${r}.owner.label`))):t.push(i("invalid_global_date_comparison","Comparison owner kind must be global_date or field_date.",`${r}.owner.kind`)):t.push(i("invalid_global_date_comparison","Comparison owner must be an object.",`${r}.owner`))),e.referenceTime!==void 0&&(typeof e.referenceTime!="string"||!V(e.referenceTime))&&t.push(i("invalid_global_date_comparison","referenceTime must be a valid ISO date-time string when present.",`${r}.referenceTime`)),{ok:t.length===0,errors:t,warnings:[]}}function Q(e,r="comparisonPolarity"){return e==="higher_is_better"||e==="lower_is_better"||e==="neutral"?{ok:!0,errors:[],warnings:[]}:{ok:!1,errors:[i("invalid_comparison_polarity","Comparison polarity must be higher_is_better, lower_is_better, or neutral.",r)],warnings:[]}}function W(e,r="comparisonPresentation"){if(!d(e))return{ok:!1,errors:[i("invalid_comparison_presentation","Comparison presentation must be an object.",r)],warnings:[]};const t=[],o=["displayMode","showComparison","precision","indicatorStyle","showColor","position","conditionalLabel","labelName","conditionalLabels","colors"];return Object.keys(e).forEach(a=>{o.includes(a)||t.push(i("invalid_comparison_presentation",`Comparison presentation does not accept field "${a}".`,`${r}.${a}`))}),[["displayMode",["difference","percent_change","both","ratio"]],["indicatorStyle",["arrow_badge","arrow","badge","none"]],["position",["left","right","top"]]].forEach(([a,s])=>{e[a]!==void 0&&!s.includes(e[a])&&t.push(i("invalid_comparison_presentation",`Comparison presentation ${a} is invalid.`,`${r}.${a}`))}),["showComparison","showColor","conditionalLabel"].forEach(a=>{e[a]!==void 0&&typeof e[a]!="boolean"&&t.push(i("invalid_comparison_presentation",`Comparison presentation ${a} must be a boolean.`,`${r}.${a}`))}),e.precision!==void 0&&(typeof e.precision!="number"||!Number.isInteger(e.precision)||e.precision<0||e.precision>6)&&t.push(i("invalid_comparison_presentation","Comparison presentation precision must be an integer from 0 through 6.",`${r}.precision`)),e.labelName!==void 0&&typeof e.labelName!="string"&&t.push(i("invalid_comparison_presentation","Comparison presentation labelName must be a string.",`${r}.labelName`)),["conditionalLabels","colors"].forEach(a=>{const s=e[a];if(s!==void 0){if(!d(s)){t.push(i("invalid_comparison_presentation",`Comparison presentation ${a} must be an object.`,`${r}.${a}`));return}Object.keys(s).forEach(l=>{["increase","decrease","neutral"].includes(l)||t.push(i("invalid_comparison_presentation",`Comparison presentation ${a} does not accept field "${l}".`,`${r}.${a}.${l}`))}),Object.entries(s).forEach(([l,c])=>{c!==void 0&&typeof c!="string"&&t.push(i("invalid_comparison_presentation",`Comparison presentation ${a}.${l} must be a string.`,`${r}.${a}.${l}`))})}}),{ok:t.length===0,errors:t,warnings:[]}}function K(e){return e===null?"unknown":e>0?"increase":e<0?"decrease":"no_change"}function X(e,r){return e==="unknown"||e==="no_change"||r==="neutral"?"neutral":r==="higher_is_better"&&e==="increase"||r==="lower_is_better"&&e==="decrease"?"favorable":"unfavorable"}function ee(e){const{currentValue:r,comparisonValue:t,polarity:o=F}=e,a=r!==null&&t!==null?r-t:null,s=a!==null&&t!==null&&t!==0?a/Math.abs(t):null,l=r!==null&&t!==null&&t!==0?r/t:null,c=K(a);return{status:t===null?"insufficient_history":"available",currentValue:r,comparisonValue:t,delta:a,percentChange:s,ratio:l,direction:c,sentiment:X(c,o)}}function _(e){if(e===null||typeof e!="object"||Array.isArray(e))return!1;const r=Object.getPrototypeOf(e);if(r===null||r===Object.prototype)return!0;const t=Object.prototype.hasOwnProperty.call(r,"constructor")?r.constructor:void 0;return typeof t=="function"&&Function.prototype.toString.call(t)===Function.prototype.toString.call(Object)}const x={dateStyle:"short",dateTime:{dateStyle:"short",timeStyle:"short"}};class y extends Error{constructor(t,o){super(o);v(this,"code");this.name="TemporalBucketContractError",this.code=t}}const re=["Jan","Feb","Mar","Apr","May","Jun","Jul","Aug","Sep","Oct","Nov","Dec"],te=["January","February","March","April","May","June","July","August","September","October","November","December"];function $(e){return{ok:!1,error:{code:"invalid_temporal_bucket_value",message:e}}}function oe(e){return e%4===0&&(e%100!==0||e%400===0)}function ne(e,r){return r===2?oe(e)?29:28:[4,6,9,11].includes(r)?30:31}function ae(e,r,t){const o=[0,3,2,5,0,3,5,1,4,6,2,4],n=r<3?e-1:e;return(n+Math.floor(n/4)-Math.floor(n/100)+Math.floor(n/400)+o[r-1]+t)%7}function M(e){var r;return(r=e.calendar.fiscalCalendar)==null?void 0:r.yearStartMonth}function ie(e,r){return(e-r+12)%12%3===0}function se(e,r){const{granularity:t}=r,o=M(r)??1;switch(t){case"second":return!0;case"minute":return e.second===0;case"hour":return e.minute===0&&e.second===0;case"day":return!0;case"week":return ae(e.year,e.month,e.day)===r.calendar.weekStart;case"month":return e.day===1;case"quarter":return e.day===1&&ie(e.month,o);case"year":return e.day===1&&e.month===o}}function L(e,r){if(e===null)return{ok:!0,value:null};const t=r.granularity==="second"||r.granularity==="minute"||r.granularity==="hour",o=t?/^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2}):(\d{2})$/.exec(e):/^(\d{4})-(\d{2})-(\d{2})$/.exec(e);if(!o)return $(`Expected ${t?"YYYY-MM-DDTHH:mm:ss":"YYYY-MM-DD"} for ${r.granularity} granularity.`);const n={year:Number(o[1]),month:Number(o[2]),day:Number(o[3]),hour:t?Number(o[4]):0,minute:t?Number(o[5]):0,second:t?Number(o[6]):0};return n.year<1||n.month<1||n.month>12||n.day<1||n.day>ne(n.year,n.month)||n.hour>23||n.minute>59||n.second>59?$(`Invalid canonical ${r.granularity} bucket value ${e}.`):se(n,r)?{ok:!0,value:n}:$(`Canonical value ${e} is not aligned to ${r.granularity} granularity and its governed Calendar.`)}function Y(e){if(!_(e))return{ok:!1,issues:[{path:"$",message:"Resolved temporal bucket format must be an object."}]};const r=[],t=new Set(["type","presentation","locale"]);for(const s of Object.keys(e))t.has(s)||r.push({path:s,message:`Unknown property "${s}".`});e.type!=="temporal_bucket"&&r.push({path:"type",message:"Expected temporal_bucket."});const o=e.presentation;if(!_(o))r.push({path:"presentation",message:"Expected a presentation object."});else{const s=o.mode,l=s==="preset"?new Set(["mode","preset"]):s==="pattern"?new Set(["mode","pattern"]):s==="auto"?new Set(["mode","styles"]):new Set(["mode"]);for(const c of Object.keys(o))l.has(c)||r.push({path:`presentation.${c}`,message:`Unknown property "${c}".`});if(s==="preset")h.isTemporalBucketPreset(o.preset)||r.push({path:"presentation.preset",message:"Expected a supported preset."});else if(s==="pattern")if(typeof o.pattern!="string"||!o.pattern)r.push({path:"presentation.pattern",message:"Expected a non-empty pattern."});else{const c=h.tokenizeTemporalBucketPattern(o.pattern);c.ok||r.push({path:"presentation.pattern",message:c.message})}else if(s==="auto"){const c=o.styles;(!_(c)||!["short","medium","long"].includes(String(c.dateStyle))||!_(c.dateTime)||!["short","medium","long"].includes(String(c.dateTime.dateStyle))||!["short","medium","long"].includes(String(c.dateTime.timeStyle))||Object.keys(c).some(m=>m!=="dateStyle"&&m!=="dateTime")||Object.keys(c.dateTime).some(m=>m!=="dateStyle"&&m!=="timeStyle"))&&r.push({path:"presentation.styles",message:"Expected complete resolved date and datetime styles."})}else r.push({path:"presentation.mode",message:"Expected auto, preset, or pattern."})}const n=I.canonicalizeSupportedLocale(e.locale);if(n||r.push({path:"locale",message:"Expected a supported base BCP 47 locale."}),r.length>0||!n||!_(o))return{ok:!1,issues:r};if(o.mode==="auto"){const s=o.styles;return{ok:!0,value:{type:"temporal_bucket",locale:n,presentation:{mode:"auto",styles:{dateStyle:s.dateStyle,dateTime:{dateStyle:s.dateTime.dateStyle,timeStyle:s.dateTime.timeStyle}}}}}}return{ok:!0,value:{type:"temporal_bucket",presentation:o.mode==="preset"?{mode:"preset",preset:o.preset}:{mode:"pattern",pattern:o.pattern},locale:n}}}function ce(e,r){const t=!!r.calendar.fiscalCalendar;return e==="fiscal_quarter_short"||e==="fiscal_year"?t:e==="quarter_short"||e==="quarter_long"?!t:!0}function j(e,r){return h.validateTemporalBucketFormatApplicability(e,r.granularity).ok?e.presentation.mode==="preset"?ce(e.presentation.preset,r):!(e.presentation.mode==="pattern"&&r.calendar.fiscalCalendar&&(r.granularity==="quarter"||r.granularity==="year")):!1}function A(e,r){if(!(!e||e.presentation.mode==="auto"))return j(e,r)?{type:"temporal_bucket",presentation:e.presentation}:void 0}function le(e){var n;const r=I.canonicalizeSupportedLocale(e.locale);if(!r)throw new y("invalid_temporal_bucket_format","Temporal bucket locale must be a supported base BCP 47 locale.");const t=A(e.cardFormat,e.metadata);if(t)return{format:{...t,locale:r},source:"card"};const o=((n=e.semanticFormat)==null?void 0:n.granularity)===e.metadata.granularity?A(e.semanticFormat.format,e.metadata):void 0;return o?{format:{...o,locale:r},source:"semantic"}:{format:{type:"temporal_bucket",locale:r,presentation:{mode:"auto",styles:e.styles??x}},source:"automatic"}}function f(e,r=2){return String(e).padStart(r,"0")}function C(e,r,t){if(r==="en-US")return(t==="short"?re:te)[e-1];const o=new Date(Date.UTC(2e3,e-1,15));return new Intl.DateTimeFormat(r,{calendar:"gregory",month:t,timeZone:"UTC"}).format(o)}function ue(e,r,t){return r.map(o=>{if(o.kind==="literal")return o.value;switch(o.value){case"YYYY":return f(e.year,4);case"YY":return f(e.year%100);case"MMMM":return C(e.month,t,"long");case"MMM":return C(e.month,t,"short");case"MM":return f(e.month);case"DD":return f(e.day);case"HH":return f(e.hour);case"mm":return f(e.minute);case"ss":return f(e.second)}}).join("")}const P=new Map;function g(e,r){const t=`${e}:${JSON.stringify(r)}`,o=P.get(t);if(o)return o;const n=new Intl.DateTimeFormat(e,r);return P.set(t,n),n}function w(e){const r=new Date(0);return r.setUTCFullYear(e.year,e.month-1,e.day),r.setUTCHours(e.hour,e.minute,e.second,0),r}function O(e,r,t){return g(r,{calendar:"gregory",dateStyle:t,timeZone:"UTC"}).format(w(e))}function me(e,r,t){return g(r,{calendar:"gregory",dateStyle:t.dateStyle,timeStyle:t.timeStyle==="long"?"medium":t.timeStyle,timeZone:"UTC"}).format(w(e))}function de(e,r,t){var n;if(t==="short"){const a=w(e),s=g(r,{calendar:"gregory",dateStyle:"short",timeZone:"UTC"}).formatToParts(a),l=s.findIndex(p=>p.type==="month"),c=s.findIndex(p=>p.type==="year"),m=(n=g(r,{calendar:"gregory",timeZone:"UTC",year:"numeric"}).formatToParts(a).find(p=>p.type==="year"))==null?void 0:n.value;if(l>=0&&c>=0&&m){const p=Math.min(l,c),U=Math.max(l,c);let k=!1;return s.slice(p,U+1).filter(b=>b.type==="day"?(k=!0,!1):k&&b.type==="literal"?(k=!1,!1):!0).map(b=>b.type==="year"?m:b.value).join("")}}return g(r,{calendar:"gregory",month:t==="short"?"numeric":t==="medium"?"short":"long",timeZone:"UTC",year:"numeric"}).format(w(e))}function pe(e,r){return Math.floor((e.month-r+12)%12/3)+1}function N(e,r){return r===1||e.month<r?e.year:e.year+1}function fe(e){return e===1?"1st":e===2?"2nd":e===3?"3rd":`${e}th`}function S(e,r,t,o){const n=M(o)??1,a=pe(e,n);switch(r){case"week_of_short":return`Week of ${C(e.month,t,"short")} ${e.day}, ${e.year}`;case"week_of_long":return`Week of ${C(e.month,t,"long")} ${e.day}, ${e.year}`;case"quarter_short":return`Q${a} ${e.year}`;case"quarter_long":return`${fe(a)} Quarter ${e.year}`;case"fiscal_quarter_short":return`Q${a} FY${N(e,n)}`;case"fiscal_year":return`FY${N(e,n)}`}}function _e(e,r,t,o){const n=M(r);switch(r.granularity){case"second":case"minute":case"hour":return me(e,t,o.dateTime);case"day":return O(e,t,o.dateStyle);case"week":return`Week of ${O(e,t,o.dateStyle)}`;case"month":return de(e,t,o.dateStyle);case"quarter":return S(e,n?"fiscal_quarter_short":"quarter_short",t,r);case"year":return n?S(e,"fiscal_year",t,r):String(e.year)}}function be(e){const r=Y(e.format);if(!r.ok||!j(r.value,e.metadata))throw new y("invalid_temporal_bucket_format","Resolved temporal bucket format is invalid or inapplicable to its metadata.");const t=L(e.value,e.metadata);if(!t.ok)throw new y(t.error.code,t.error.message);if(t.value===null)return"(Blank)";const{presentation:o,locale:n}=r.value;if(o.mode==="auto")return _e(t.value,e.metadata,n,o.styles);if(o.mode==="preset")return S(t.value,o.preset,n,e.metadata);const a=h.tokenizeTemporalBucketPattern(o.pattern);if(!a.ok)throw new y("invalid_temporal_bucket_format",a.message);return ue(t.value,a.segments,n)}exports.COMPARISON_PRESENTATION_DEFAULTS=G;exports.DEFAULT_METRIC_COMPARISON_POLARITY=F;exports.DEFAULT_RESOLVED_TEMPORAL_STYLE_SET=x;exports.TemporalBucketContractError=y;exports.evaluateMetricComparison=ee;exports.formatTemporalBucket=be;exports.isPlainJsonRecord=_;exports.parseResolvedTemporalBucketFormat=Y;exports.parseTemporalBucketValue=L;exports.resolveMetricComparisonRequest=H;exports.resolveMetricResultAlias=J;exports.resolveTemporalBucketPresentation=le;exports.validateComparisonPresentationSpec=W;exports.validateGlobalDateComparisonContext=Z;exports.validateGlobalDateComparisonSelection=R;exports.validateMetricComparisonConfig=z;exports.validateMetricComparisonPolarity=Q;exports.validateMetricComparisonSpec=T;
@@ -1 +0,0 @@
1
- "use strict";const C=require("./validators-DcshgK7w.cjs");require("./analyze-result-contract-OgPk-zGu.cjs");const P=require("./temporal-bucket-9Wz9Ds6H.cjs"),H=require("../value-format-preferences/index.cjs"),O=new Set(["previous_period","same_period_last_year","start_vs_end","target"]),U=new Set([...O,"none",""]);function m(e){return!!e&&typeof e=="object"&&!Array.isArray(e)}function I(e){const o=m(e.preferences)?e.preferences:void 0,t=o&&m(o.kpiVisualOptions)?o.kpiVisualOptions:void 0,r=o&&m(o.tableVisualOptions)?o.tableVisualOptions:void 0;return{preferences:o,kpiOptions:t,kpiComparison:t&&m(t.metricComparison)?t.metricComparison:void 0,kpiComparisonPresent:!!t&&"metricComparison"in t,tableOptions:r,tableComparison:r&&m(r.metricComparison)?r.metricComparison:void 0,tableComparisonPresent:!!r&&"metricComparison"in r}}function w(e){const o=[],t=(r,a)=>{if(Array.isArray(r)){r.forEach((n,s)=>t(n,`${a}[${s}]`));return}if(!m(r))return;const c=r.config;if(m(c)){const n=I(r),s=!!(n.kpiComparisonPresent||n.tableComparisonPresent),u=c.metricColumns,l=Array.isArray(u)?u.flatMap((p,i)=>m(p)?[{index:i,metric:p}]:[]):[];if((l.some(({metric:p})=>"comparisonType"in p)||s)&&o.push({path:a,card:r,metrics:l,malformedMetricIndexes:Array.isArray(u)?u.flatMap((p,i)=>m(p)?[]:[i]):[],malformedMetricColumns:"metricColumns"in c&&!Array.isArray(u),hasLegacyPresentation:s}),"metricColumns"in c||s)return}Object.entries(r).forEach(([n,s])=>t(s,a?`${a}.${n}`:n))};return t(e,"$"),o}const R={difference:"difference",change:"percent_change",change_difference:"both",ratio:"ratio"};function D(e,o){if(!e)return;const t=Object.fromEntries(o.flatMap(r=>typeof e[r]=="string"?[[r,e[r]]]:[]));return Object.keys(t).length?t:void 0}function q(e,o,t){if(e!==void 0){if(!m(e)){t.push({severity:"error",code:"invalid_legacy_comparison_presentation",path:o,message:"Legacy comparison formatOptions must be an object."});return}Object.entries(e).forEach(([r,a])=>{if(r==="decimalPlaces"){(typeof a!="number"||!Number.isInteger(a)||a<0||a>6)&&t.push({severity:"error",code:"invalid_legacy_comparison_presentation",path:`${o}.decimalPlaces`,message:"Legacy comparison decimalPlaces must be an integer from 0 through 6."});return}r==="type"&&(a===void 0||a==="auto")||a!==void 0&&t.push({severity:"error",code:"unsupported_comparison_format",path:`${o}.${r}`,message:`Legacy comparison format option "${r}" has no canonical presentation mapping.`})})}}function k(e,o){const t=o==="kpi"?e.calculationType:e.calculatedAs,r=o==="table"&&t===void 0?"both":R[String(t)],a=m(e.formatOptions)?e.formatOptions:void 0,c=m(e.conditionalLabels)?e.conditionalLabels:void 0,n=m(o==="kpi"?e.colorConfig:e.colors)?o==="kpi"?e.colorConfig:e.colors:void 0,s={};if(r&&(s.displayMode=r),typeof(a==null?void 0:a.decimalPlaces)=="number"&&(s.precision=a.decimalPlaces),o==="kpi"){const p=e.showArrow!==!1,i=e.showColor!==!1;s.indicatorStyle=p?i?"arrow_badge":"arrow":i?"badge":"none",s.showColor=i,(e.position==="left"||e.position==="right"||e.position==="top")&&(s.position=e.position),typeof e.conditionalLabel=="boolean"&&(s.conditionalLabel=e.conditionalLabel),typeof e.labelName=="string"&&(s.labelName=e.labelName)}else(e.indicatorStyle==="arrow_badge"||e.indicatorStyle==="arrow"||e.indicatorStyle==="badge"||e.indicatorStyle==="none")&&(s.indicatorStyle=e.indicatorStyle);const u=c?{...D(c,["increase","decrease"]),...typeof c.noChange=="string"?{neutral:c.noChange}:typeof c.neutral=="string"?{neutral:c.neutral}:{}}:void 0;u&&Object.keys(u).length&&(s.conditionalLabels=u);const l=n?{...D(n,["increase","decrease"]),...typeof n.noChange=="string"?{neutral:n.noChange}:typeof n.neutral=="string"?{neutral:n.neutral}:{}}:void 0;return l&&Object.keys(l).length&&(s.colors=l),s}function $(e){return{...P.COMPARISON_PRESENTATION_DEFAULTS,...e}}function S(e){return e.some(({metric:o})=>o.comparisonType==="previous_period"||o.comparisonType==="same_period_last_year"||o.comparisonType==="target"?!0:m(o.comparison)&&o.comparison.mode==="explicit")}function A(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,t,r){const a=o==="kpi"?["enabled","calculationType","formatOptions","showArrow","showColor","conditionalLabel","labelName","position","conditionalLabels","colorConfig","lowerIsBetter"]:["calculatedAs","indicatorStyle","formatOptions","colors","lowerIsBetter"];Object.keys(e).forEach(p=>{a.includes(p)||r.push({severity:"error",code:"invalid_legacy_comparison_presentation",path:`${t}.${p}`,message:`Unknown legacy comparison presentation field "${p}" cannot be dropped automatically.`})});const c=o==="kpi"?"calculationType":"calculatedAs";e[c]!==void 0&&!R[String(e[c])]&&r.push({severity:"error",code:"invalid_legacy_comparison_presentation",path:`${t}.${c}`,message:`Legacy comparison ${c} is unsupported.`}),o==="kpi"&&e.position!==void 0&&!["left","right","top"].includes(String(e.position))&&r.push({severity:"error",code:"invalid_legacy_comparison_presentation",path:`${t}.position`,message:"Legacy comparison position is unsupported."}),o==="kpi"&&e.labelName!==void 0&&typeof e.labelName!="string"&&r.push({severity:"error",code:"invalid_legacy_comparison_presentation",path:`${t}.labelName`,message:"Legacy comparison labelName must be a string."}),(o==="kpi"?[["conditionalLabels",["increase","decrease","noChange"]],["colorConfig",["increase","decrease","noChange"]]]:[["colors",["increase","decrease","neutral"]]]).forEach(([p,i])=>{if(e[p]!==void 0){if(!m(e[p])){r.push({severity:"error",code:"invalid_legacy_comparison_presentation",path:`${t}.${p}`,message:`Legacy comparison ${p} must be an object.`});return}Object.entries(e[p]).forEach(([h,d])=>{i.includes(h)?typeof d!="string"&&r.push({severity:"error",code:"invalid_legacy_comparison_presentation",path:`${t}.${p}.${h}`,message:`Legacy comparison ${p}.${h} must be a string.`}):r.push({severity:"error",code:"invalid_legacy_comparison_presentation",path:`${t}.${p}.${h}`,message:`Unknown legacy comparison ${p} field "${h}" cannot be dropped automatically.`})})}}),(o==="kpi"?["enabled","showArrow","showColor","conditionalLabel","lowerIsBetter"]:["lowerIsBetter"]).forEach(p=>{e[p]!==void 0&&typeof e[p]!="boolean"&&r.push({severity:"error",code:"invalid_legacy_comparison_presentation",path:`${t}.${p}`,message:`Legacy comparison ${p} must be a boolean.`})}),o==="table"&&e.indicatorStyle!==void 0&&!["arrow_badge","arrow","badge","none"].includes(String(e.indicatorStyle))&&r.push({severity:"error",code:"invalid_legacy_comparison_presentation",path:`${t}.indicatorStyle`,message:"Legacy comparison indicatorStyle is unsupported."}),q(e.formatOptions,`${t}.formatOptions`,r);const u=k(e,o);P.validateComparisonPresentationSpec(u,t).errors.forEach(p=>{r.push({severity:"error",code:"invalid_legacy_comparison_presentation",path:p.path||t,message:p.message})})}function B(e){const o=I(e.card),t=o.kpiComparison?k(o.kpiComparison,"kpi"):void 0,r=o.tableComparison?k(o.tableComparison,"table"):void 0;return{namespaces:o,kpi:t,table:r,presentation:t||r}}function J(e){const o=m(e.preferences)?e.preferences:{},t=m(o.kpiVisualOptions)?o.kpiVisualOptions:{},r=m(t.metricComparison)?t.metricComparison:{},a=m(o.tableVisualOptions)?o.tableVisualOptions:{},c=m(a.metricComparison)?a.metricComparison:{};return t.lowerIsBetter===!0||r.lowerIsBetter===!0||c.lowerIsBetter===!0?"lower_is_better":"higher_is_better"}function x(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 z(e){const o=m(e.preferences)?e.preferences:void 0;if(!o)return;const t=m(o.kpiVisualOptions)?o.kpiVisualOptions:void 0;t&&delete t.lowerIsBetter;const r=m(o.tableVisualOptions)?o.tableVisualOptions:void 0,a=r&&m(r.metricComparison)?r.metricComparison:void 0;a&&delete a.lowerIsBetter}function G(e){const o=w(e);if(!o.length)return{document:e,changed:!1,changes:[],diagnostics:[]};const t=[];if(o.forEach(n=>{var s,u,l,p;if(n.malformedMetricColumns&&t.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(i=>{t.push({severity:"error",code:"malformed_metric_columns",path:`${n.path}.config.metricColumns[${i}]`,message:"Metric columns must contain objects before comparison migration."})}),n.metrics.forEach(({metric:i,index:h})=>{if(!("comparisonType"in i))return;const d=`${n.path}.config.metricColumns[${h}]`,g=String(i.comparisonType||"");"comparison"in i&&t.push({severity:"error",code:"conflicting_comparison_contracts",path:d,message:"Metric contains both legacy and canonical comparison configuration; resolve the conflict before migration."});const b=m(i.parameters)?i.parameters:void 0,Y=b&&m(b.windowTransform)?b.windowTransform:void 0;O.has(g)&&(Y==null?void 0:Y.function)==="previous_period_delta"&&t.push({severity:"error",code:"conflicting_comparison_window_transform",path:d,message:"A metric cannot combine baseline comparison with previous_period_delta; resolve the authoring intent before migration."}),U.has(g)||t.push({severity:"error",code:"unsupported_comparison_type",path:`${d}.comparisonType`,message:`Unsupported legacy metric comparison type "${g}".`}),i.comparisonType==="target"&&(typeof i.targetValue!="number"||!Number.isFinite(i.targetValue))&&t.push({severity:"error",code:"invalid_target_value",path:`${d}.targetValue`,message:"Legacy target comparison requires a finite metric targetValue."}),i.comparisonType==="start_vs_end"&&t.push({severity:"error",code:"unsupported_start_vs_end",path:`${d}.comparisonType`,message:"start_vs_end is retired and cannot be migrated automatically."}),i.targetValue!==void 0&&i.comparisonType!=="target"&&t.push({severity:"warning",code:"stray_target_value",path:`${d}.targetValue`,message:"Dead non-target targetValue will be removed without changing the baseline."})}),n.hasLegacyPresentation){const{namespaces:i,kpi:h,table:d}=B(n),g=[(s=i.kpiOptions)==null?void 0:s.lowerIsBetter,(u=i.kpiComparison)==null?void 0:u.lowerIsBetter,(l=i.tableComparison)==null?void 0:l.lowerIsBetter].filter(b=>typeof b=="boolean");new Set(g).size>1&&t.push({severity:"error",code:"conflicting_legacy_polarity",path:`${n.path}.preferences`,message:"Legacy comparison polarity values disagree; resolve the conflict before migration."}),((p=i.kpiOptions)==null?void 0:p.lowerIsBetter)!==void 0&&typeof i.kpiOptions.lowerIsBetter!="boolean"&&t.push({severity:"error",code:"invalid_legacy_comparison_presentation",path:`${n.path}.preferences.kpiVisualOptions.lowerIsBetter`,message:"Legacy comparison lowerIsBetter must be a boolean."}),i.kpiComparisonPresent&&!i.kpiComparison&&t.push({severity:"error",code:"invalid_legacy_comparison_presentation",path:`${n.path}.preferences.kpiVisualOptions.metricComparison`,message:"Legacy KPI comparison presentation must be an object."}),i.tableComparisonPresent&&!i.tableComparison&&t.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(i.preferences||{})&&t.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."}),i.kpiComparison&&typeof i.kpiComparison.enabled=="boolean"&&"metricPairComparisonEnabled"in(i.preferences||{})&&A(n)&&t.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."}),i.kpiComparison&&L(i.kpiComparison,"kpi",`${n.path}.preferences.kpiVisualOptions.metricComparison`,t),i.tableComparison&&L(i.tableComparison,"table",`${n.path}.preferences.tableVisualOptions.metricComparison`,t),h&&d&&JSON.stringify($(h))!==JSON.stringify($(d))&&t.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."})}}),t.some(n=>n.severity==="error"))return{document:e,changed:!1,changes:[],diagnostics:t};const r=JSON.parse(JSON.stringify(e)),a=w(r),c=[];return a.forEach(n=>{var u;const s=J(n.card);if(n.metrics.forEach(({metric:l,index:p})=>{if(!("comparisonType"in l))return;const i=String(l.comparisonType||""),h=`${n.path}.config.metricColumns[${p}]`,d=x(l),g=["comparisonType"];delete l.comparisonType,"targetValue"in l&&(delete l.targetValue,g.push("targetValue")),"comparisonDisplay"in l&&(delete l.comparisonDisplay,g.push("comparisonDisplay")),d?l.comparison=d:delete l.comparison,O.has(i)&&(l.comparisonPolarity=s),c.push({kind:"metric",path:h,metricId:typeof l.id=="string"?l.id:void 0,legacyType:i,comparison:d,comparisonPolarity:O.has(i)?s:void 0,removedFields:g})}),z(n.card),n.hasLegacyPresentation){const{namespaces:l,presentation:p}=B(n),i=(u=l.kpiComparison)==null?void 0:u.enabled,h={...p};typeof i=="boolean"&&S(n.metrics)&&(h.showComparison=i);const d=typeof i=="boolean"&&A(n)?i:void 0,g=typeof i=="boolean"&&!S(n.metrics)&&!A(n)?["kpiVisualOptions.metricComparison.enabled"]:void 0,b=l.preferences,Y=[];n.metrics.forEach(({metric:T})=>{"comparisonPolarity"in T||(T.comparisonPolarity=s,typeof T.id=="string"&&Y.push(T.id))}),Object.keys(h).length&&(b.comparisonPresentation=h),d!==void 0&&(b.metricPairComparisonEnabled=d),l.kpiOptions&&delete l.kpiOptions.metricComparison,l.tableOptions&&delete l.tableOptions.metricComparison,c.push({kind:"presentation",path:`${n.path}.preferences`,comparisonPresentation:Object.keys(h).length?h:void 0,metricPairComparisonEnabled:d,comparisonPolarityMetricIds:Y,intentionallyDiscardedFields:g,removedFields:[...l.kpiComparison?["kpiVisualOptions.metricComparison"]:[],...l.tableComparison?["tableVisualOptions.metricComparison"]:[]]})}}),{document:r,changed:!0,changes:c,diagnostics:t}}const N=["bar","horizontalBar","line","area","stackedArea","combo","stackedBar","stackedLine"],K=new Set(N);function F(e){return typeof e=="string"&&K.has(e)}function W(e){return e==="detailTable"||e==="table"||e==="aggregateTable"||e==="pivotTable"||e==="custom"||F(e)}function V(e){return!!(e!=null&&e.trim())}function Q(e){return V(e.sql)||V(e.normalizedPython)?"freeform":e.hasExecutableConfig?"config":"none"}const M={type:"temporal_bucket",presentation:{mode:"auto"}},_={value:"auto",label:"Automatic",format:M};function f(e,o){return{value:`pattern:${e}`,label:o,format:{type:"temporal_bucket",presentation:{mode:"pattern",pattern:e}}}}function v(e,o){return{value:`preset:${e}`,label:o,format:{type:"temporal_bucket",presentation:{mode:"preset",preset:e}}}}function y(e){return{...f(e,"Custom format…"),value:"custom",custom:!0}}const E={second:[_,f("HH:mm:ss","14:30:45 (HH:mm:ss)"),f("YYYY-MM-DD HH:mm:ss","2024-01-15 14:30:45 (YYYY-MM-DD HH:mm:ss)"),y("DD/MM/YYYY HH:mm:ss")],minute:[_,f("HH:mm","14:30 (HH:mm)"),f("YYYY-MM-DD HH:mm","2024-01-15 14:30 (YYYY-MM-DD HH:mm)"),y("DD/MM/YYYY HH:mm")],hour:[_,f("HH","14 (HH)"),f("YYYY-MM-DD HH","2024-01-15 14 (YYYY-MM-DD HH)"),y("DD/MM/YYYY HH")],day:[_,f("YYYY-MM-DD","2024-01-15 (YYYY-MM-DD)"),f("MM/DD/YYYY","01/15/2024 (MM/DD/YYYY)"),f("DD/MM/YYYY","15/01/2024 (DD/MM/YYYY)"),f("MMM DD, YYYY","Jan 15, 2024 (MMM DD, YYYY)"),f("MMMM DD, YYYY","January 15, 2024 (MMMM DD, YYYY)"),y("YYYY/MM/DD")],week:[_,v("week_of_short","Week of Jan 15, 2024"),v("week_of_long","Week of January 15, 2024"),f("YYYY-MM-DD","2024-01-15 (YYYY-MM-DD)"),y("YYYY/MM/DD")],month:[_,f("MMM YYYY","Jan 2024 (MMM YYYY)"),f("MMMM YYYY","January 2024 (MMMM YYYY)"),f("YYYY-MM","2024-01 (YYYY-MM)"),f("MM/YYYY","01/2024 (MM/YYYY)"),f("YYYY MMM","2024 Jan (YYYY MMM)"),y("YYYY/MM")],quarter:[_,v("quarter_short","Q1 2024"),v("quarter_long","1st Quarter 2024")],year:[_,f("YYYY","2024 (YYYY)"),f("YY","24 (YY)")]},X={second:"2026-07-31T14:05:09",minute:"2026-07-31T14:05:00",hour:"2026-07-31T14:00:00",day:"2026-07-31",week:"2026-07-27",month:"2026-07-01",quarter:"2026-07-01",year:"2026-01-01"};function j(e,o,t=H.DEFAULT_RESOLVED_VALUE_FORMAT_PREFERENCES){return P.formatTemporalBucket({value:X[o],metadata:{kind:"temporal_bucket",granularity:o,calendar:{tz:"UTC",weekStart:1,...e.presentation.mode==="preset"&&(e.presentation.preset==="fiscal_quarter_short"||e.presentation.preset==="fiscal_year")?{fiscalCalendar:{kind:"month_aligned",yearStartMonth:7}}:{}}},format:e.presentation.mode==="auto"?{type:"temporal_bucket",locale:t.locale,presentation:{mode:"auto",styles:{dateStyle:t.dateStyle,dateTime:{...t.dateTime}}}}:{type:"temporal_bucket",locale:t.locale,presentation:e.presentation}})}function Z(e,o,t=H.DEFAULT_RESOLVED_VALUE_FORMAT_PREFERENCES){const r=E[e],a=(o==null?void 0:o.presentation.mode)==="preset"?o.presentation.preset:void 0,c=a&&o&&C.validateTemporalBucketFormatApplicability(o,e).ok&&!r.some(s=>{var u;return((u=s.format)==null?void 0:u.presentation.mode)==="preset"&&s.format.presentation.preset===a})?v(a,a):void 0;return(c?[...r,c]:r).map(s=>{if(!s.format||s.custom)return s;const u=j(s.format,e,t);return s.format.presentation.mode==="pattern"?{...s,label:`${u} (${s.format.presentation.pattern})`}:s.format.presentation.mode==="auto"?{...s,label:`Automatic (${u})`}:{...s,label:u}})}function ee(e,o){const t=E[o];if(e.presentation.mode==="pattern"){const r=e.presentation.pattern,a=t.find(c=>{var n;return((n=c.format)==null?void 0:n.presentation.mode)==="pattern"&&c.format.presentation.pattern===r});return{value:(a==null?void 0:a.value)??"custom",customPattern:a!=null&&a.custom||!a?r:"",format:e}}if(e.presentation.mode==="preset"){const r=e.presentation.preset,a=t.find(n=>{var s;return((s=n.format)==null?void 0:s.presentation.mode)==="preset"&&n.format.presentation.preset===r}),c=C.validateTemporalBucketFormatApplicability(e,o).ok;return a?{value:a.value,customPattern:"",format:e}:c?{value:`preset:${r}`,customPattern:"",format:e}:{value:"auto",customPattern:"",format:M}}return{value:"auto",customPattern:"",format:e}}function oe(e,o,t=""){var n;const r=E[e].find(s=>s.value===o),a=o.startsWith("preset:")?o.slice(7):void 0,c=o==="custom"?{type:"temporal_bucket",presentation:{mode:"pattern",pattern:t.trim()||(((n=r==null?void 0:r.format)==null?void 0:n.presentation.mode)==="pattern"?r.format.presentation.pattern:"")}}:(r==null?void 0:r.format)??(a&&C.isTemporalBucketPreset(a)?{type:"temporal_bucket",presentation:{mode:"preset",preset:a}}:void 0);return!c||!C.validateTemporalBucketFormatApplicability(c,e).ok?M:c}function te(e,o){return C.validateTemporalBucketFormatApplicability(e,o).ok?e:M}exports.AUTOMATIC_TEMPORAL_BUCKET_FORMAT=M;exports.SEMAPHOR_CARTESIAN_CHART_TYPES=N;exports.getTemporalBucketAuthoringOptions=Z;exports.getTemporalBucketAuthoringSelection=ee;exports.isSemaphorCartesianChartType=F;exports.previewTemporalBucketAuthoringFormat=j;exports.reconcileTemporalBucketAuthoringFormat=te;exports.resolveTemporalBucketAuthoringFormat=oe;exports.resolveTemporalResultOwner=Q;exports.supportsCanonicalDashboardTemporalResult=W;exports.transformComparisonDocument=G;
@@ -1 +0,0 @@
1
- "use strict";const a=require("zod"),E=["second","minute","hour","day","week","month","quarter","year"];function ni(e){return typeof e=="string"&&E.includes(e)}const[,,...ae]=E;function si(e){return ni(e)&&ae.includes(e)}const oi=["week_of_short","week_of_long","quarter_short","quarter_long","fiscal_quarter_short","fiscal_year"],tt={invalidMetadata:"invalid_raw_temporal_metadata"};function ri(e){return e==="second"||e==="minute"||e==="hour"?"datetime":"date"}const at={missingMetadata:"missing_temporal_bucket_metadata",invalidMetadata:"invalid_temporal_bucket_metadata",invalidValue:"invalid_temporal_bucket_value"},nt="__auto_count__";function li(e){try{return new Intl.DateTimeFormat("en-US",{timeZone:e}).format(),!0}catch{return!1}}const di={answerSummary:"string",responseDetail:"responseDetail",mode:"string",comparisonKind:"string",executionResult:"executionResult",compiledQuery:"unknown",data:"unknown",resultSets:"record",analysisWarnings:"unknownArray",columns:"unknownArray",records:"recordArray",rowCount:"number",rowLimitExceeded:"boolean",output:"string",querySpec:"unknown",metadata:"record",validation:"validationResult",coverage:"coverage",diagnosticFeedback:"diagnosticFeedback",missingFields:"stringArray",warnings:"unknownArray",comparison:"unknown",population:"population",comparisons:"recordArray",fieldsUsed:"compactExecutionFieldArray",primary:"recordArray",contributors:"recordArray",segments:"recordArray",periodChanges:"recordArray",changes:"recordArray",largestNegativeChanges:"recordArray",largestPositiveChanges:"recordArray",drivers:"recordArray",absoluteDeltaDrivers:"recordArray",largestNegativeDrivers:"recordArray",largestPositiveDrivers:"recordArray",periodRows:"recordArray",sql:"unknown",omitted:"stringArray"},st="SUM";function z(e){return typeof e=="string"&&e.trim().length>0}function N(e){return z(e)?e.trim().toLowerCase():""}function ot(e){const i=z(e.id)?e.id.trim():void 0;if(!i)return;const t=N(i),n=z(e.table)?e.table.trim():void 0;if(!(t===N(e.name)||n&&t===N(n)))return i}function k(e){const i=z(e.datasetId)?e.datasetId.trim():void 0;if(i)return N(i)===N(e.datasetName)?void 0:i}function $e(e){if(e.kind!=="semantic")return e;const i=k(e),{datasetId:t,...n}=e;return{...n,...i?{datasetId:i}:{}}}function rt(e){return e?e.kind==="semantic"?!!(z(e.domainId)&&(z(e.datasetId)||z(e.datasetName))):e.kind==="physical"?z(e.connectionId)&&z(e.tableName):z(e.connectionId):!1}function Q(e){if(!e)return"";if(e.kind==="semantic"){const i=k(e);return[e.kind,e.domainId,i?`datasetId:${i}`:`datasetName:${e.datasetName}`].join(":")}return e.kind==="physical"?[e.kind,e.connectionId,e.databaseName||"",e.schemaName||"",e.tableName].join(":"):[e.kind,e.connectionId,e.dialect||"",e.label||""].join(":")}function ne(e,i){if(!e||!i)return e===i;if(e.kind!==i.kind)return!1;if(e.kind==="semantic"&&i.kind==="semantic"){if(e.domainId!==i.domainId)return!1;const t=k(e),n=k(i);return t&&n?t===n:e.datasetName===i.datasetName}return Q(e)===Q(i)}function we(e,i){return e.kind!=="semantic"||i.kind!=="semantic"?e:$e({...e,datasetName:e.datasetName||i.datasetName,datasetId:k(e)||k(i),label:e.label||i.label,connectionId:e.connectionId||i.connectionId})}function lt(e){const i=[];for(const t of e){const n=$e(t),s=i.findIndex(r=>ne(r,n));if(s===-1){i.push(n);continue}i[s]=we(i[s],n)}return i}function ui(e,i){return e.name===i.name&&ne(e.source,i.source)}function ci(e){return[e.source?Q(e.source):"unknown",se(e),e.name].filter(Boolean).join(":")}function se(e){return dt(e.aggregate||st)}function dt(e){return e.trim().toUpperCase()}function ut(e,i){return{...e,label:e.label||i.label,role:e.role||i.role,dataType:e.dataType||i.dataType,source:e.source&&i.source?we(e.source,i.source):e.source||i.source}}const Z="semaphor-data-app-codegen-summary/v1",ct="semaphor-data-app-codegen-summary-validator/v2",pt=new Set(["metric","records","matrix","analysis","sql_fallback"]),mt=new Set(["semaphor.metric","semaphor.records","semaphor.matrix","semaphor.analysis","semaphor.sql"]),ft=new Set(["SUM","COUNT","AVG","MIN","MAX","MEDIAN","DISTINCT"]),gt=new Set(["absolute_delta","largest_negative","largest_positive","positive_and_negative","all"]),pi=new Set(["source","id","label","measures","primaryMeasure","dateField","timeGrain","dimensions","comparison","orderBy","filters","relationshipHint","limit","derivedFields"]),ht=new Set([...pi,"analysis","timeWindow","filters","driverMode","includePopulation","calendarContext","chartTitle","chartType"]),yt=new Set(["source","id","label","fields","dateField","timeGrain","timeWindow","filters","orderBy","relationshipHint","limit","pagination","totals","derivedFields"]),bt=new Set(["source","id","label","filters","relationshipHint","rows","columns","values","totals","sort","expansion","layout","displayLimits"]),_t=new Set(["source","id","label","sql","defaultParameters","pythonCode","fields","limit","pagination","rationale"]),vt=new Set(["kpi","line_chart","bar_chart","stacked_bar_chart","pie_chart","donut_chart","area_chart","table","matrix","narrative","text_block","custom"]),zt=new Set(["missing_measure","missing_dimension","missing_date","missing_relationship","missing_semantic_role","missing_current_app_state","raw_identifier_filter_options","unsupported_change_intent","ambiguous_field_grounding","bounded_intent_unavailable","invalid_bounded_intent_output","latest_snapshot_selector_not_modeled","unsupported_grain","requires_sql_escape_hatch","unsupported_sdk_capability"]);function St(e){return ke(e).ok}function ke(e){const i=[];if(!e||typeof e!="object")return{ok:!1,issues:["Summary must be an object."]};const t=e;return t.schemaVersion!==Z&&i.push(`schemaVersion must be ${Z}.`),(typeof t.title!="string"||!t.title.trim())&&i.push("title is required."),Array.isArray(t.sources)||i.push("sources must be an array."),Array.isArray(t.inputs)||i.push("inputs must be an array."),Array.isArray(t.views)||i.push("views must be an array."),Array.isArray(t.filterContracts)||i.push("filterContracts must be an array."),(!t.implementationChecklist||typeof t.implementationChecklist!="object")&&i.push("implementationChecklist must be an object."),t.implementationChecklist&&typeof t.implementationChecklist=="object"&&i.push(...wt(t.implementationChecklist)),Array.isArray(t.sources)&&t.sources.forEach((n,s)=>{i.push(...B(n,`sources.${s}`))}),Array.isArray(t.inputs)&&t.inputs.forEach((n,s)=>{i.push(...kt(n,`inputs.${s}`))}),Array.isArray(t.views)&&t.views.forEach((n,s)=>{i.push(...It(n,`views.${s}`))}),Array.isArray(t.filterContracts)&&t.filterContracts.forEach((n,s)=>{i.push(...jt(n,`filterContracts.${s}`))}),t.unsupportedInsights!==void 0&&(Array.isArray(t.unsupportedInsights)?t.unsupportedInsights.forEach((n,s)=>{i.push(...ta(n,`unsupportedInsights.${s}`))}):i.push("unsupportedInsights must be an array.")),i.push(...$t(t)),{ok:i.length===0,issues:i}}function $t(e){const i=Array.isArray(e.unsupportedInsights)&&e.unsupportedInsights.some(l=>{var d;return Ke.has((d=c(l))==null?void 0:d.reason)}),t=Array.isArray(e.views)&&e.views.some(l=>{var u;const d=c((u=c(l))==null?void 0:u.computation);return(d==null?void 0:d.kind)==="unsupported"&&Ke.has(d.reason)});if(!i&&!t)return[];const n=[],s=c(e.validation);(s==null?void 0:s.status)!=="blocked"&&n.push("validation.status must be blocked when semantic model repair gaps are present.");const r=c(e.nextRequiredTool);return(r==null?void 0:r.name)!=="semaphor_propose_semantic_model_change"&&n.push("nextRequiredTool.name must be semaphor_propose_semantic_model_change when semantic model repair gaps are present."),n}const Ke=new Set(["missing_relationship","raw_identifier_filter_options"]);function B(e,i){const t=c(e);return t?t.kind==="semantic"?typeof t.domainId=="string"&&t.domainId.trim()&&typeof t.datasetName=="string"&&t.datasetName.trim()?[]:[`${i} must include sourceKey or a supported source identity.`]:typeof t.sourceKey=="string"&&t.sourceKey.trim()?[]:t.kind==="physical"&&typeof t.tableName=="string"&&t.tableName.trim()&&typeof t.connectionId=="string"&&t.connectionId.trim()?[]:t.kind==="sql"&&typeof t.connectionId=="string"&&t.connectionId.trim()?[]:[`${i} must include sourceKey or a supported source identity.`]:[`${i} must be an object.`]}function wt(e){const i=c(e);if(!i)return["implementationChecklist must be an object."];const t=[],n=["requiredDevtools","requiredInputOptions","filterScopeByInput","bindingsByView","validationCommands","browserSmokeChecks"];for(const r of n)r in i||t.push(`implementationChecklist.${r} is required.`);const s=c(i.requiredDevtools);return s?typeof s.mountRootDevtools!="boolean"&&t.push("implementationChecklist.requiredDevtools.mountRootDevtools must be a boolean."):t.push("implementationChecklist.requiredDevtools must be an object."),Array.isArray(i.requiredInputOptions)||t.push("implementationChecklist.requiredInputOptions must be an array."),Array.isArray(i.filterScopeByInput)||t.push("implementationChecklist.filterScopeByInput must be an array."),c(i.bindingsByView)||t.push("implementationChecklist.bindingsByView must be an object."),S(i.validationCommands)||t.push("implementationChecklist.validationCommands must be an array of strings."),S(i.browserSmokeChecks)||t.push("implementationChecklist.browserSmokeChecks must be an array of strings."),t}function kt(e,i){const t=c(e);if(!t)return[`${i} must be an object.`];const n=[];return(typeof t.id!="string"||!t.id.trim())&&n.push(`${i}.id is required.`),t.fieldRef&&n.push(...h(t.fieldRef,`${i}.fieldRef`)),n.push(...fi(t.optionQuery,`${i}.optionQuery`)),S(t.appliesToViewIds)||n.push(`${i}.appliesToViewIds must be an array of strings.`),t.bindings!==void 0&&!Array.isArray(t.bindings)&&n.push(`${i}.bindings must be an array.`),Array.isArray(t.bindings)&&t.bindings.forEach((s,r)=>{const l=c(s);if(!l){n.push(`${i}.bindings.${r} must be an object.`);return}S(l.appliesToViewIds)||n.push(`${i}.bindings.${r}.appliesToViewIds must be an array of strings.`),n.push(...h(l.fieldRef,`${i}.bindings.${r}.fieldRef`))}),n}function It(e,i){const t=c(e);if(!t)return[`${i} must be an object.`];const n=[];if((typeof t.id!="string"||!t.id.trim())&&n.push(`${i}.id is required.`),t.visualSpec!==void 0&&n.push(...Qt(t.visualSpec,`${i}.visualSpec`)),t.computation!==void 0&&n.push(...ia(t.computation,`${i}.computation`)),Yt(t))return n.push(...pe(t,`${i}`)),t.fields!==void 0&&(Array.isArray(t.fields)?t.fields.forEach((u,p)=>{n.push(...h(u,`${i}.fields.${p}`))}):n.push(`${i}.fields must be an array.`)),t.queryKind!==void 0&&n.push(`${i}.queryKind is not allowed for non-executable views.`),t.sdkBuilder!==void 0&&n.push(`${i}.sdkBuilder is not allowed for non-executable views.`),t.sdkSpec!==void 0&&n.push(`${i}.sdkSpec is not allowed for non-executable views.`),n;if(!Array.isArray(t.fields))return n.push(`${i}.fields must be an array.`),(t.sdkSpec!==void 0||t.sdkBuilder!==void 0)&&n.push(`${i}.fields must be an array for executable views.`),n.push(...pe(t,`${i}`)),n;t.fields.forEach((u,p)=>{n.push(...h(u,`${i}.fields.${p}`))}),q(t.queryKind)||n.push(`${i}.queryKind must be a supported codegen query kind.`),t.sdkBuilder!==void 0&&!yi(t.sdkBuilder)&&n.push(`${i}.sdkBuilder must be a supported SDK builder.`),t.metricBindingKeys!==void 0&&(Array.isArray(t.metricBindingKeys)?t.metricBindingKeys.some(u=>typeof u!="string"||u.trim().length===0)&&n.push(`${i}.metricBindingKeys must be an array of strings.`):n.push(`${i}.metricBindingKeys must be an array of strings.`));const s=c(t.sdkSpec),r=(s==null?void 0:s.builder)==="semaphor.metric";r&&(!Array.isArray(t.metricBindingKeys)||t.metricBindingKeys.length===0)&&n.push(`${i}.metricBindingKeys is required for metric views.`);const l=At(t);r&&Array.isArray(t.metricBindingKeys)&&l&&JSON.stringify(t.metricBindingKeys)!==JSON.stringify(l)&&n.push(`${i}.metricBindingKeys must match the generated metric field binding keys in order.`);const d=c(t.computation);return(d==null?void 0:d.kind)==="server_query"&&q(t.queryKind)&&q(d.queryKind)&&d.queryKind!==t.queryKind&&n.push(`${i}.computation.queryKind must match queryKind.`),n.push(...Nt({value:t.sdkSpec,path:`${i}.sdkSpec`,queryKind:typeof t.queryKind=="string"?t.queryKind:void 0,sdkBuilder:typeof t.sdkBuilder=="string"?t.sdkBuilder:void 0}),...pe(t,`${i}`)),n}function At(e){const i=c(e.sdkSpec);if((i==null?void 0:i.builder)!=="semaphor.metric")return;const t=c(i.spec);if(!t)return;const s=[t.primaryMeasure,...Array.isArray(t.measures)?t.measures:[]].map(xt).filter(r=>!!r);return Array.from(new Map(s.map(r=>[r.identity,r.bindingKey])).values())}function xt(e){const i=c(e);if(!i||typeof i.name!="string"||!i.name.trim())return;const t=Rt(i);return t?{identity:JSON.stringify({source:t,name:i.name,aggregate:mi(i)}),bindingKey:Mt(i)}:void 0}function Rt(e){if(typeof e.sourceKey=="string"&&e.sourceKey.trim())return{sourceKey:e.sourceKey};const i=c(e.source);if(i)return{kind:i.kind,domainId:i.domainId,datasetId:i.datasetId,datasetName:i.datasetName,name:i.name}}function Mt(e){return typeof e.sourceKey=="string"&&e.sourceKey.trim()?[e.sourceKey,mi(e),e.name].filter(Boolean).join(":"):ci(e)}function mi(e){return se(e)}function pe(e,i){var p;const t=c((p=c(e.visualSpec))==null?void 0:p.tableBehavior),n=c(e.sdkSpec),s=c(n==null?void 0:n.spec),r=typeof(n==null?void 0:n.builder)=="string"?n.builder:void 0,l=r==="semaphor.records"?c(s==null?void 0:s.totals):void 0,d=[];if(!t)return l&&d.push(`${i}.sdkSpec.spec.totals is only allowed when tableBehavior.totals.mode is server.`),d;const u=c(t.totals);return u?(u.mode==="server"&&(r!=="semaphor.records"&&d.push(`${i}.visualSpec.tableBehavior.totals.mode server is only supported for semaphor.records views.`),!l||l.mode!=="server"?d.push(`${i}.sdkSpec.spec.totals.mode must be server when tableBehavior.totals.mode is server.`):d.push(...Tt({left:u.measures,right:l.measures,leftPath:`${i}.visualSpec.tableBehavior.totals.measures`,rightPath:`${i}.sdkSpec.spec.totals.measures`}))),u.mode!=="server"&&l&&d.push(`${i}.sdkSpec.spec.totals is only allowed when tableBehavior.totals.mode is server.`),r==="semaphor.sql"&&u.mode!=="none"&&d.push(`${i}.visualSpec.tableBehavior.totals.mode must be none for semaphor.sql views.`),r==="semaphor.sql"&&c(s==null?void 0:s.totals)&&d.push(`${i}.sdkSpec.spec.totals is not supported for semaphor.sql.`),d):(l&&d.push(`${i}.sdkSpec.spec.totals is only allowed when tableBehavior.totals.mode is server.`),d)}function Tt({left:e,right:i,leftPath:t,rightPath:n}){if(!Array.isArray(e)||!Array.isArray(i))return[`${n} must match ${t}.`];const s=[];return e.length!==i.length?(s.push(`${n} must match ${t}.`),s):(e.forEach((r,l)=>{Et(c(r),c(i[l]))||s.push(`${n}.${l} must match ${t}.${l}.`)}),s)}function Et(e,i){return!e||!i?!1:e.name===i.name&&(e.role||"measure")===(i.role||"measure")&&Ve(e)===Ve(i)&&Ct(e,i)}function Ve(e){return typeof e.aggregate=="string"?e.aggregate.toUpperCase():"SUM"}function Ct(e,i){const t=c(e.source),n=c(i.source);if(Dt(t,n))return!1;const s=Le(e),r=Le(i);if(s.size>0||r.size>0){for(const l of s)if(r.has(l))return!0;return!1}return!t||!n||t.kind!==n.kind?!1:t.kind==="semantic"?t.domainId===n.domainId&&t.datasetName===n.datasetName&&(t.datasetId===void 0||n.datasetId===void 0||t.datasetId===n.datasetId):t.kind==="physical"?t.connectionId===n.connectionId&&t.tableName===n.tableName:t.kind==="sql"?t.connectionId===n.connectionId:!1}function Dt(e,i){if(!e||!i||e.kind!=="semantic"||i.kind!=="semantic")return!1;const t=typeof e.datasetId=="string"?e.datasetId.trim():"",n=typeof i.datasetId=="string"?i.datasetId.trim():"";return!!(t&&n&&t!==n)}function Le(e){const i=typeof e.sourceKey=="string"?e.sourceKey.trim():"";return i?new Set([i]):Ft(c(e.source))}function Ft(e){const i=new Set;if(!e)return i;const t=typeof e.sourceKey=="string"?e.sourceKey.trim():"";if(t&&i.add(t),e.kind==="semantic"){const n=typeof e.domainId=="string"?e.domainId:"",s=typeof e.datasetName=="string"?e.datasetName:"",r=typeof e.datasetId=="string"?e.datasetId:"";n&&r&&i.add(`semantic:${n}:datasetId:${r}`),n&&s&&i.add(`semantic:${n}:datasetName:${s}`)}if(e.kind==="physical"){const n=typeof e.connectionId=="string"?e.connectionId:"",s=typeof e.tableName=="string"?e.tableName:"",r=typeof e.databaseName=="string"?e.databaseName:"",l=typeof e.schemaName=="string"?e.schemaName:"";n&&s&&(i.add(["physical",n,r,l,s].join(":")),i.add(`physical:${n}:${s}`))}if(e.kind==="sql"){const n=typeof e.connectionId=="string"?e.connectionId:"",s=typeof e.dialect=="string"?e.dialect:"",r=typeof e.label=="string"?e.label:"";n&&(i.add(["sql",n,s,r].join(":")),i.add(`sql:${n}`))}return i}function jt(e,i){const t=c(e);if(!t)return[`${i} must be an object.`];const n=[];if(t.fieldRef&&n.push(...h(t.fieldRef,`${i}.fieldRef`)),(typeof t.inputId!="string"||!t.inputId.trim())&&n.push(`${i}.inputId is required.`),n.push(...fi(t.optionQuery,`${i}.optionQuery`)),S(t.appliesToViewIds)||n.push(`${i}.appliesToViewIds must be an array of strings.`),S(t.notAppliedToViewIds)||n.push(`${i}.notAppliedToViewIds must be an array of strings.`),!Array.isArray(t.bindings))n.push(`${i}.bindings must be an array.`);else{const s=S(t.appliesToViewIds)?new Set(t.appliesToViewIds):void 0,r=S(t.notAppliedToViewIds)?new Set(t.notAppliedToViewIds):void 0;t.bindings.forEach((l,d)=>{const u=c(l);if(!u){n.push(`${i}.bindings.${d} must be an object.`);return}typeof u.viewId!="string"||!u.viewId?n.push(`${i}.bindings.${d}.viewId is required.`):(s&&!s.has(u.viewId)&&n.push(`${i}.bindings.${d}.viewId must be included in appliesToViewIds.`),r!=null&&r.has(u.viewId)&&n.push(`${i}.bindings.${d}.viewId must not be listed in notAppliedToViewIds.`)),n.push(...h(u.fieldRef,`${i}.bindings.${d}.fieldRef`))})}return n}function fi(e,i){if(e===void 0)return[];const t=c(e);if(!t)return[`${i} must be an object.`];const n=[...$(t.valueFieldRef,`${i}.valueFieldRef`),...$(t.labelFieldRef,`${i}.labelFieldRef`),...$(t.filterFieldRef,`${i}.filterFieldRef`)];if(t.builder!=="semaphor.inputOptions"&&n.push(`${i}.builder must be semaphor.inputOptions.`),typeof t.sourceKey!="string"&&t.source===void 0&&n.push(`${i} must include source or sourceKey.`),t.source!==void 0){const s=c(t.source);!s||s.kind!=="semantic"&&s.kind!=="physical"?n.push(`${i}.source.kind must be semantic or physical.`):n.push(...B(t.source,`${i}.source`))}return c(t.valueFieldRef)||n.push(`${i}.valueFieldRef is required.`),c(t.labelFieldRef)||n.push(`${i}.labelFieldRef is required.`),t.limit!==void 0&&(typeof t.limit!="number"||!Number.isInteger(t.limit)||t.limit<=0)&&n.push(`${i}.limit must be a positive integer.`),n}function Nt(e){var s;const i=c(e.value);if(!i)return[`${e.path} is required for executable views.`];const t=[];if(!yi(i.builder))return t.push(`${e.path}.builder must be a supported SDK builder.`),t;e.sdkBuilder&&i.builder!==e.sdkBuilder&&t.push(`${e.path}.builder must match sdkBuilder.`),e.queryKind&&q(e.queryKind)&&i.builder!==Ut(e.queryKind)&&t.push(`${e.path}.builder must match queryKind.`);const n=c(i.spec);if(!n)return t.push(`${e.path}.spec must be an object.`),t;switch(i.builder){case"semaphor.metric":t.push(...j(n,pi,`${e.path}.spec`),...L(n,e.path),...me(n.measures,`${e.path}.spec.measures`),...$(n.primaryMeasure,`${e.path}.spec.primaryMeasure`),...$(n.dateField,`${e.path}.spec.dateField`),...fe(n.dimensions,`${e.path}.spec.dimensions`),...ge(n.orderBy,`${e.path}.spec.orderBy`),...H(n.filters,`${e.path}.spec.filters`));break;case"semaphor.analysis":t.push(...j(n,ht,`${e.path}.spec`),...L(n,e.path),...me(n.measures,`${e.path}.spec.measures`),...$(n.primaryMeasure,`${e.path}.spec.primaryMeasure`),...$(n.dateField,`${e.path}.spec.dateField`),...fe(n.dimensions,`${e.path}.spec.dimensions`),...ge(n.orderBy,`${e.path}.spec.orderBy`),...H(n.filters,`${e.path}.spec.filters`),...Ot(n,`${e.path}.spec`));break;case"semaphor.records":t.push(...j(n,yt,`${e.path}.spec`),...L(n,e.path),...me(n.fields,`${e.path}.spec.fields`),...$(n.dateField,`${e.path}.spec.dateField`),...ge(n.orderBy,`${e.path}.spec.orderBy`),...H(n.filters,`${e.path}.spec.filters`),...Pt(n.totals,`${e.path}.spec.totals`));break;case"semaphor.matrix":t.push(...j(n,bt,`${e.path}.spec`),...Bt(n,e.path),...Kt(n.rows,`${e.path}.spec.rows`),...Vt(n.columns,`${e.path}.spec.columns`),...Lt(n.values,`${e.path}.spec.values`),...Ht(n.sort,`${e.path}.spec.sort`),...H(n.filters,`${e.path}.spec.filters`),...qt(n.displayLimits,`${e.path}.spec.displayLimits`));break;case"semaphor.sql":t.push(...j(n,_t,`${e.path}.spec`),...L(n,e.path)),((s=c(n.source))==null?void 0:s.kind)!=="sql"&&t.push(`${e.path}.spec.source.kind must be sql.`),(typeof n.sql!="string"||!n.sql.trim())&&t.push(`${e.path}.spec.sql is required.`),t.push(...fe(n.fields,`${e.path}.spec.fields`));break}return t}function qt(e,i){if(e===void 0)return[];const t=c(e);if(!t)return[`${i} must be an object.`];const n=[];n.push(...He(t.rows,`${i}.rows`),...He(t.columns,`${i}.columns`));for(const s of Object.keys(t))s==="rows"||s==="columns"||n.push(`${i}.${s} is not supported.`);return n}function He(e,i){if(e===void 0)return[];const t=c(e);if(!t)return[`${i} must be an object.`];const n=[];(typeof t.limit!="number"||!Number.isInteger(t.limit)||t.limit<1)&&n.push(`${i}.limit must be a positive integer.`);for(const s of Object.keys(t))s!=="limit"&&n.push(`${i}.${s} is not supported; matrix display limits are count-only in v1.`);return n}function Ot(e,i){const t=[];if(e.driverMode!==void 0&&!gt.has(e.driverMode)&&t.push(`${i}.driverMode must be a supported analysis driver mode.`),e.includePopulation!==void 0&&typeof e.includePopulation!="boolean"&&t.push(`${i}.includePopulation must be a boolean.`),e.calendarContext!==void 0){const n=c(e.calendarContext);if(!n)t.push(`${i}.calendarContext must be an object.`);else{n.tz!==void 0&&typeof n.tz!="string"&&t.push(`${i}.calendarContext.tz must be a string.`),n.weekStart!==void 0&&(typeof n.weekStart!="number"||!Number.isInteger(n.weekStart)||n.weekStart<0||n.weekStart>6)&&t.push(`${i}.calendarContext.weekStart must be an integer between 0 and 6.`);const s=n.anchor;if(s!==void 0&&s!=="now"){const r=c(s);(!r||typeof r.iso!="string"||!r.iso.trim())&&t.push(`${i}.calendarContext.anchor must be now or { iso }.`)}}}return t}function Pt(e,i){if(e===void 0)return[];const t=c(e);if(!t)return[`${i} must be an object.`];const n=[];return t.mode!=="server"&&n.push(`${i}.mode must be server.`),!Array.isArray(t.measures)||t.measures.length===0?n.push(`${i}.measures must include at least one measure.`):t.measures.forEach((s,r)=>{var l;n.push(...bi(s,`${i}.measures.${r}`)),((l=c(s))==null?void 0:l.role)!=="measure"&&n.push(`${i}.measures.${r}.role must be measure.`)}),n}function j(e,i,t){const n=[];return Object.keys(e).forEach(s=>{i.has(s)||n.push(`${t}.${s} is not supported for this SDK builder.`)}),n}function L(e,i){return c(e.source)?B(e.source,`${i}.spec.source`):[`${i}.spec.source must be an object.`]}function Bt(e,i){const t=c(e.source);if(!t)return[`${i}.spec.source must be an object.`];const n=B(e.source,`${i}.spec.source`);return t.kind!=="semantic"&&t.kind!=="physical"&&n.push(`${i}.spec.source.kind must be semantic or physical.`),n}function me(e,i){const t=Ie(e,i);return Array.isArray(e)&&e.forEach((n,s)=>{t.push(...h(n,`${i}.${s}`))}),t}function fe(e,i){if(e===void 0)return[];if(!Array.isArray(e))return[`${i} must be an array.`];const t=[];return e.forEach((n,s)=>{t.push(...h(n,`${i}.${s}`))}),t}function ge(e,i){if(e===void 0)return[];const t=c(e);return t?[...h(t.field,`${i}.field`),...gi(t.direction,`${i}.direction`)]:[`${i} must be an object.`]}function Kt(e,i){const t=Ie(e,i);return Array.isArray(e)&&e.forEach((n,s)=>{const r=c(n);if(!r){t.push(`${i}.${s} must be an object.`);return}t.push(...h(r.field,`${i}.${s}.field`))}),t}function Vt(e,i){if(e===void 0)return[];const t=[];return Array.isArray(e)?(e.forEach((n,s)=>{const r=c(n);if(!r){t.push(`${i}.${s} must be an object.`);return}t.push(...h(r.field,`${i}.${s}.field`))}),t):[`${i} must be an array.`]}function Lt(e,i){const t=Ie(e,i);return Array.isArray(e)&&e.forEach((n,s)=>{const r=c(n);if(!r){t.push(`${i}.${s} must be an object.`);return}t.push(...h(r.field,`${i}.${s}.field`))}),t}function Ht(e,i){if(e===void 0)return[];if(!Array.isArray(e))return[`${i} must be an array.`];const t=[];return e.forEach((n,s)=>{const r=c(n);if(!r){t.push(`${i}.${s} must be an object.`);return}r.axis!=="row"&&r.axis!=="column"&&t.push(`${i}.${s}.axis must be row or column.`),t.push(...gi(r.direction,`${i}.${s}.direction`),...Gt(r.by,`${i}.${s}.by`))}),t}function Gt(e,i){const t=c(e);if(!t)return[`${i} must be an object.`];switch(t.kind){case"member":return[];case"field":return h(t.field,`${i}.field`);case"value":return typeof t.valueId!="string"||!t.valueId.trim()?[`${i}.valueId is required.`]:[];default:return[`${i}.kind must be member, field, or value.`]}}function gi(e,i){return e==="asc"||e==="desc"?[]:[`${i} must be asc or desc.`]}function H(e,i){if(e===void 0)return[];if(!Array.isArray(e))return[`${i} must be an array.`];const t=[];return e.forEach((n,s)=>{const r=c(n);if(!r){t.push(`${i}.${s} must be an object.`);return}t.push(...h(r.field,`${i}.${s}.field`))}),t}function Ie(e,i){return!Array.isArray(e)||e.length===0?[`${i} must be a non-empty array.`]:[]}function Ut(e){switch(e){case"metric":return"semaphor.metric";case"records":return"semaphor.records";case"matrix":return"semaphor.matrix";case"analysis":return"semaphor.analysis";case"sql_fallback":return"semaphor.sql"}}function Yt(e){const i=c(e.computation),t=c(e.visualSpec);return(i==null?void 0:i.kind)==="presentation_only"||(i==null?void 0:i.kind)==="derived"||(i==null?void 0:i.kind)==="unsupported"||e.visual==="text_block"||(t==null?void 0:t.visualType)==="text_block"}function Qt(e,i){const t=c(e);if(!t)return[`${i} must be an object.`];const n=[];return vt.has(t.visualType)||n.push(`${i}.visualType must be a supported visual type.`),t.limit!==void 0&&(typeof t.limit!="number"||!Number.isInteger(t.limit)||t.limit<=0)&&n.push(`${i}.limit must be a positive integer.`),t.tableBehavior!==void 0&&n.push(...Zt(t.tableBehavior,`${i}.tableBehavior`)),n}function Zt(e,i){const t=c(e);if(!t)return[`${i} must be an object.`];const n=[];return t.tableMode!=="bounded"&&t.tableMode!=="server_paginated"&&t.tableMode!=="server_windowed"&&n.push(`${i}.tableMode must be a supported table mode.`),n.push(...Xt(t.height,`${i}.height`),...Wt(t.pagination,`${i}.pagination`),...Jt(t.sorting,`${i}.sorting`),...ea(t.totals,`${i}.totals`)),typeof t.serverSideRequired!="boolean"&&n.push(`${i}.serverSideRequired must be a boolean.`),n}function Xt(e,i){const t=c(e);if(!t)return[`${i} must be an object.`];const n=[];return(typeof t.maxPx!="number"||!Number.isInteger(t.maxPx)||t.maxPx<=0)&&n.push(`${i}.maxPx must be a positive integer.`),t.scroll!=="vertical"&&t.scroll!=="both"&&n.push(`${i}.scroll must be vertical or both.`),typeof t.stickyHeader!="boolean"&&n.push(`${i}.stickyHeader must be a boolean.`),n}function Wt(e,i){const t=c(e);if(!t)return[`${i} must be an object.`];const n=[];return t.mode!=="none"&&t.mode!=="server"&&t.mode!=="client_for_bounded_rows"&&n.push(`${i}.mode must be a supported pagination mode.`),t.pageSize!==void 0&&(typeof t.pageSize!="number"||!Number.isInteger(t.pageSize)||t.pageSize<=0)&&n.push(`${i}.pageSize must be a positive integer.`),t.readsFrom!==void 0&&t.readsFrom!=="result.pagination"&&n.push(`${i}.readsFrom must be result.pagination.`),n}function Jt(e,i){const t=c(e);if(!t)return[`${i} must be an object.`];const n=[];return t.mode!=="server"&&t.mode!=="client_for_bounded_rows"&&n.push(`${i}.mode must be a supported sorting mode.`),t.defaultField!==void 0&&(typeof t.defaultField!="string"||!t.defaultField.trim())&&n.push(`${i}.defaultField must be a non-empty string.`),t.defaultDirection!==void 0&&t.defaultDirection!=="asc"&&t.defaultDirection!=="desc"&&n.push(`${i}.defaultDirection must be asc or desc.`),t.resetPageOnChange!==void 0&&typeof t.resetPageOnChange!="boolean"&&n.push(`${i}.resetPageOnChange must be a boolean.`),n}function ea(e,i){const t=c(e);if(!t)return[`${i} must be an object.`];const n=[];return t.mode!=="none"&&t.mode!=="server"&&t.mode!=="local"?(n.push(`${i}.mode must be none, server, or local.`),n):t.mode==="none"?(t.measures!==void 0&&n.push(`${i}.measures is not allowed when mode is none.`),t.label!==void 0&&n.push(`${i}.label is not allowed when mode is none.`),n):t.mode==="server"?(!Array.isArray(t.measures)||t.measures.length===0?n.push(`${i}.measures must include at least one measure when mode is server.`):t.measures.forEach((s,r)=>{var l;n.push(...bi(s,`${i}.measures.${r}`)),((l=c(s))==null?void 0:l.role)!=="measure"&&n.push(`${i}.measures.${r}.role must be measure.`)}),t.label!==void 0&&n.push(`${i}.label is not allowed when mode is server.`),n):(t.mode==="local"&&(t.label!=="Displayed rows"&&t.label!=="Current page"&&n.push(`${i}.label must be Displayed rows or Current page when mode is local.`),t.measures!==void 0&&n.push(`${i}.measures is not allowed when mode is local.`)),n)}function ia(e,i){const t=c(e);if(!t)return[`${i} must be an object.`];const n=[];switch(t.kind){case"server_query":q(t.queryKind)||n.push(`${i}.queryKind must be a supported codegen query kind.`),t.queryOwnership!==void 0&&t.queryOwnership!=="view_owned"&&t.queryOwnership!=="shared_query"&&n.push(`${i}.queryOwnership must be view_owned or shared_query.`),t.sourceKeys!==void 0&&!S(t.sourceKeys)&&n.push(`${i}.sourceKeys must be an array of strings.`),t.fieldNames!==void 0&&!S(t.fieldNames)&&n.push(`${i}.fieldNames must be an array of strings.`);break;case"derived":(typeof t.upstreamViewId!="string"||!t.upstreamViewId.trim())&&n.push(`${i}.upstreamViewId is required.`),(typeof t.derivation!="string"||!t.derivation.trim())&&n.push(`${i}.derivation is required.`);break;case"presentation_only":break;case"unsupported":(typeof t.reason!="string"||!t.reason.trim())&&n.push(`${i}.reason is required.`),(typeof t.suggestedModelingFix!="string"||!t.suggestedModelingFix.trim())&&n.push(`${i}.suggestedModelingFix is required.`);break;default:n.push(`${i}.kind must be a supported computation kind.`)}return n}function ta(e,i){const t=c(e);if(!t)return[`${i} must be an object.`];const n=[];for(const r of["title","requestedQuestion","suggestedModelingFix"])(typeof t[r]!="string"||!t[r].trim())&&n.push(`${i}.${r} is required.`);return zt.has(t.reason)||n.push(`${i}.reason must be a supported unsupported insight reason.`),(t.relationshipCandidate!==void 0||t.nextRepairAction!==void 0)&&t.reason!=="missing_relationship"&&n.push(`${i} relationship repair metadata is only valid for missing_relationship unsupported insights.`),t.diagnostic!==void 0&&n.push(...aa(t.diagnostic,`${i}.diagnostic`,t.reason)),t.relationshipCandidate!==void 0&&n.push(...sa(t.relationshipCandidate,`${i}.relationshipCandidate`)),t.nextRepairAction!==void 0&&n.push(...na(t.nextRepairAction,`${i}.nextRepairAction`)),n}function aa(e,i,t){const n=c(e);if(!n)return[`${i} must be an object.`];const s=[],r=new Set(["kind","inputId","inputLabel","optionSource","optionField","missingEvidence"]);Object.keys(n).forEach(d=>{r.has(d)||s.push(`${i}.${d} is not supported; raw identifier diagnostics support only kind, inputId, inputLabel, optionSource, optionField, and missingEvidence.`)}),t!=="raw_identifier_filter_options"&&s.push(`${i} is only valid for raw_identifier_filter_options unsupported insights.`),n.kind!=="raw_identifier_filter_options"&&s.push(`${i}.kind must be raw_identifier_filter_options.`);for(const d of["inputId","inputLabel"])(typeof n[d]!="string"||!n[d].trim())&&s.push(`${i}.${d} must be a non-empty string.`);s.push(...be(n.optionSource,`${i}.optionSource`)),s.push(...hi(n.optionField,`${i}.optionField`));const l=new Set(["display_field","relationship_display_path"]);return!Array.isArray(n.missingEvidence)||n.missingEvidence.length===0?s.push(`${i}.missingEvidence must be a non-empty evidence array.`):n.missingEvidence.forEach((d,u)=>{l.has(d)||s.push(`${i}.missingEvidence.${u} must be display_field or relationship_display_path.`)}),s}function na(e,i){const t=c(e);if(!t)return[`${i} must be an object.`];const n=[],s=new Set(["tool","reason"]);return Object.keys(t).forEach(r=>{s.has(r)||n.push(`${i}.${r} is not supported; repair actions support only tool and reason.`)}),t.tool!=="semaphor_propose_semantic_model_change"&&n.push(`${i}.tool must be semaphor_propose_semantic_model_change.`),t.reason!=="missing_relationship"&&n.push(`${i}.reason must be missing_relationship.`),n}function sa(e,i){const t=c(e);if(!t)return[`${i} must be an object.`];const n=[],s=new Set(["source","sourceFields","target","targetFields"]);Object.keys(t).forEach(r=>{s.has(r)||n.push(`${i}.${r} is not supported; relationship candidates support only source, sourceFields, target, and targetFields.`)}),n.push(...be(t.source,`${i}.source`)),n.push(...be(t.target,`${i}.target`));for(const r of["sourceFields","targetFields"]){const l=t[r];if(!Array.isArray(l)||l.length===0){n.push(`${i}.${r} must be a non-empty endpoint field array.`);continue}l.forEach((d,u)=>{n.push(...hi(d,`${i}.${r}.${u}`))})}return n}function hi(e,i){const t=c(e);if(!t)return[`${i} must be an object.`];const n=[],s=new Set(["name","label","role","dataType"]);return Object.keys(t).forEach(r=>{s.has(r)||n.push(`${i}.${r} is not supported; relationship candidate fields are scoped by their endpoint and support only name, label, role, and dataType.`)}),(typeof t.name!="string"||!t.name.trim())&&n.push(`${i}.name must be a non-empty string.`),t.role!==void 0&&(typeof t.role!="string"||!["dimension","measure","date","id","unknown"].includes(t.role))&&n.push(`${i}.role must be dimension, measure, date, id, or unknown.`),t.dataType!==void 0&&(typeof t.dataType!="string"||!["string","number","boolean","date","datetime","unknown"].includes(t.dataType))&&n.push(`${i}.dataType must be string, number, boolean, date, datetime, or unknown.`),n}function be(e,i){const t=c(e);if(!t)return[`${i} must be an object.`];const n=[],s=new Set(["kind","domainId","datasetName","datasetId","label","sourceKey"]);return Object.keys(t).forEach(r=>{s.has(r)||n.push(`${i}.${r} is not supported; relationship candidate sources support only semantic identity fields.`)}),t.kind!=="semantic"&&n.push(`${i} must use semantic source identity.`),(typeof t.domainId!="string"||!t.domainId.trim()||typeof t.datasetName!="string"||!t.datasetName.trim())&&n.push(`${i} must include semantic domainId and datasetName.`),n}function q(e){return pt.has(e)}function yi(e){return mt.has(e)}function $(e,i){return e===void 0?[]:h(e,i)}function h(e,i){const t=c(e);if(!t)return[`${i} must be an object.`];const n=[];return(typeof t.name!="string"||!t.name.trim())&&n.push(`${i}.name is required.`),!t.source&&typeof t.sourceKey!="string"&&n.push(`${i} must include source or sourceKey.`),t.aggregate!==void 0&&!ft.has(t.aggregate)&&n.push(`${i}.aggregate must be a supported aggregate function.`),n}function bi(e,i){const t=c(e),n=h(e,i);if(!t||typeof t.sourceKey=="string"&&t.sourceKey.trim())return n;if(t.source!==void 0){const r=B(t.source,`${i}.source`);return r.length===0||n.push(...r),n}return n.includes(`${i} must include source or sourceKey.`)||n.push(`${i} must include source or sourceKey.`),n}function c(e){return e&&typeof e=="object"&&!Array.isArray(e)?e:void 0}function S(e){return Array.isArray(e)&&e.every(i=>typeof i=="string")}const b=a.z.record(a.z.string(),a.z.unknown()),C=a.z.array(b),_=a.z.enum(["SUM","COUNT","AVG","MIN","MAX","MEDIAN","DISTINCT"]),oe=a.z.enum(["postgres","mysql","mssql","snowflake","clickhouse","bigquery","redshift","duckdb","sqlite","unknown"]),_i=a.z.enum(E),vi=a.z.enum(ae),re=a.z.enum(["dimension","measure","date","id","unknown"]),le=a.z.enum(["string","number","boolean","date","datetime","unknown"]),Y=a.z.union([a.z.number(),a.z.string(),a.z.null()]),he=a.z.enum(["millisecond","second","minute","hour","day"]),oa=a.z.enum(oi),ra=a.z.discriminatedUnion("mode",[a.z.object({mode:a.z.literal("auto")}).strict(),a.z.object({mode:a.z.literal("preset"),preset:oa}).strict(),a.z.object({mode:a.z.literal("pattern"),pattern:a.z.string().min(1)}).strict()]),X=a.z.object({type:a.z.literal("temporal_bucket"),presentation:ra}).strict(),la=a.z.object({tz:a.z.string().min(1).refine(li,{message:"tz must be a valid IANA timezone"}),weekStart:a.z.number().int().min(0).max(6),fiscalCalendar:a.z.object({kind:a.z.literal("month_aligned"),yearStartMonth:a.z.number().int().min(1).max(12)}).strict().optional()}).strict(),W=a.z.object({kind:a.z.literal("temporal_bucket"),granularity:_i,calendar:la}).strict(),zi=a.z.object({kind:a.z.literal("raw_temporal"),valueKind:a.z.enum(["date","wall_datetime","instant"])}).strict(),Si=a.z.union([a.z.object({type:a.z.enum(["number","currency","percent","percentage","scientific"]),locale:a.z.string().optional(),minimumFractionDigits:a.z.number().optional(),maximumFractionDigits:a.z.number().optional(),useGrouping:a.z.boolean().optional(),prefix:a.z.string().optional(),suffix:a.z.string().optional(),negativeStyle:a.z.enum(["minus","parentheses"]).optional(),compact:a.z.boolean().optional(),scale:a.z.number().optional(),currency:a.z.string().optional(),percentValueMode:a.z.enum(["fraction","whole"]).optional()}).passthrough().superRefine((e,i)=>{"locale"in e&&i.addIssue({code:a.z.ZodIssueCode.custom,path:["locale"],message:"Numeric semantic formats inherit locale from viewer preferences."})}),a.z.object({type:a.z.enum(["date","datetime"]),locale:a.z.string().optional(),pattern:a.z.string().optional(),relative:a.z.boolean().optional(),timezone:a.z.string().optional(),sourceTimezone:a.z.string().optional(),prefix:a.z.string().optional(),suffix:a.z.string().optional()}).passthrough(),a.z.object({type:a.z.literal("duration"),inputUnit:he.optional(),outputStyle:a.z.enum(["compact","digital","long"]).optional(),largestUnit:he.optional(),smallestUnit:he.optional(),maxUnits:a.z.number().optional(),prefix:a.z.string().optional(),suffix:a.z.string().optional(),negativeStyle:a.z.enum(["minus","parentheses"]).optional()}).passthrough(),a.z.object({type:a.z.literal("string"),prefix:a.z.string().optional(),suffix:a.z.string().optional()}).passthrough()]),da=a.z.union([a.z.object({kind:a.z.literal("defaultAggregate")}).passthrough(),a.z.object({kind:a.z.literal("blank")}).passthrough(),a.z.object({kind:a.z.literal("labelOnly"),label:a.z.string().optional()}).passthrough(),a.z.object({kind:a.z.literal("customAggregate"),aggregate:_}).passthrough(),a.z.object({kind:a.z.literal("percentOfParent")}).passthrough(),a.z.object({kind:a.z.literal("percentOfGrandTotal")}).passthrough(),a.z.object({kind:a.z.literal("customExpression"),expressionId:a.z.string()}).passthrough()]);function K(e,i){return a.z.object(e).passthrough().superRefine((t,n)=>{for(const s of i)Object.prototype.hasOwnProperty.call(t,s)||n.addIssue({code:"custom",path:[s],message:`Required field "${s}" is missing.`})})}const Ae=a.z.object({kind:a.z.literal("semantic"),domainId:a.z.string(),datasetName:a.z.string(),datasetId:a.z.string().optional(),label:a.z.string().optional(),connectionId:a.z.string().optional()}).passthrough(),$i=a.z.object({kind:a.z.literal("physical"),connectionId:a.z.string(),connectionType:a.z.string().optional(),tableName:a.z.string(),databaseName:a.z.string().optional(),schemaName:a.z.string().optional(),label:a.z.string().optional(),dialect:oe.optional()}).passthrough(),wi=a.z.object({kind:a.z.literal("sql"),connectionId:a.z.string(),dialect:oe.optional(),label:a.z.string().optional()}).passthrough(),R=a.z.union([Ae,$i,wi]),I=a.z.object({name:a.z.string(),label:a.z.string().optional(),role:re.optional(),dataType:le.optional(),source:R.optional(),aggregate:_.optional()}).passthrough(),ua=a.z.object({kind:a.z.literal("field"),field:I,aggregate:_.optional()}).passthrough(),xe=a.z.object({kind:a.z.literal("derived_field"),name:a.z.string(),label:a.z.string(),description:a.z.string().optional(),resultRole:re,dataType:le,computeStage:a.z.enum(["row","aggregate"]),expression:a.z.string(),expressionLanguage:a.z.literal("semaphor_sql_template").optional(),inputs:a.z.record(ua),defaultAggregate:_.optional(),aggregationBehavior:a.z.enum(["additive","non_additive","ratio_of_sums","weighted","pre_aggregated","snapshot"]).optional(),aggregationStrategy:a.z.enum(["default","symmetric_aggregate","aggregate_then_join","weighted"]).optional(),format:Si.optional(),tags:a.z.array(a.z.string()).optional()}).passthrough(),de=I.and(a.z.object({derivedField:xe.optional()}).passthrough()),ca=Ae,pa=a.z.object({kind:a.z.literal("physical"),connectionId:a.z.string().optional(),connectionType:a.z.string().optional(),tableName:a.z.string(),databaseName:a.z.string().optional(),schemaName:a.z.string().optional(),label:a.z.string().optional(),dialect:oe.optional()}).passthrough(),ma=a.z.object({kind:a.z.literal("sql"),connectionId:a.z.string().optional(),dialect:oe.optional(),label:a.z.string().optional()}).passthrough(),fa=a.z.union([ca,pa,ma]),ga=a.z.object({key:a.z.string().optional(),name:a.z.string(),label:a.z.string().optional(),role:re.optional(),dataType:le.optional(),source:fa.optional(),aggregate:_.optional(),derivedField:a.z.never().optional()}).passthrough(),M=a.z.object({key:a.z.string(),name:a.z.string(),label:a.z.string(),role:re.optional(),dataType:le.optional(),aggregate:_.optional(),source:R.optional(),derivedField:xe.optional(),temporalBucket:W.optional(),rawTemporal:zi.optional(),pivotIdentity:a.z.object({metricId:a.z.string().min(1),metricAlias:a.z.string().min(1),members:a.z.array(a.z.object({fieldId:a.z.string().min(1),value:a.z.string().nullable(),temporalBucket:W.optional()}).strict())}).strict().optional()}).passthrough().superRefine((e,i)=>{if(e.temporalBucket&&e.rawTemporal&&i.addIssue({code:a.z.ZodIssueCode.custom,path:["rawTemporal"],message:"A result column cannot carry both temporalBucket and rawTemporal metadata."}),e.temporalBucket){const t=ri(e.temporalBucket.granularity);e.dataType!==t&&i.addIssue({code:a.z.ZodIssueCode.custom,path:["dataType"],message:`${e.temporalBucket.granularity} temporal buckets require dataType ${t}.`})}if(e.rawTemporal){const t=e.rawTemporal.valueKind==="date"?"date":"datetime";e.dataType!==t&&i.addIssue({code:a.z.ZodIssueCode.custom,path:["dataType"],message:`${e.rawTemporal.valueKind} raw temporal values require dataType ${t}.`})}}),ha=a.z.object({records:C,columns:a.z.array(M).optional()}).passthrough(),ya=a.z.object({records:C,columns:a.z.array(M)}).passthrough(),ki=a.z.object({code:a.z.string(),message:a.z.string().optional(),invalidField:a.z.string().optional(),fieldRole:a.z.enum(["measure","date","dimension","input","source","sql"]).optional(),validMeasureCandidates:a.z.array(a.z.string()).optional(),validDateCandidates:a.z.array(a.z.string()).optional(),validDimensionCandidates:a.z.array(a.z.string()).optional(),recommendedNextStep:a.z.string()}).passthrough(),J=a.z.object({code:a.z.string(),message:a.z.string(),path:a.z.string().optional(),fieldRole:a.z.enum(["measure","date","dimension","input","source","sql"]).optional(),repairHint:ki.optional()}).passthrough(),Re=a.z.object({ok:a.z.boolean(),errors:a.z.array(J),warnings:a.z.array(J),repairHints:a.z.array(ki)}).passthrough(),ba=a.z.object({page:a.z.number(),pageSize:a.z.number(),pageCount:a.z.number(),totalCount:a.z.number(),hasNextPage:a.z.boolean(),hasPrevPage:a.z.boolean()}).passthrough(),V={intentId:a.z.string().optional(),queryPath:a.z.enum(["query_spec","sql","sql_python"]),warnings:a.z.array(a.z.string()).optional(),rowCount:a.z.number().optional(),rowLimitExceeded:a.z.boolean().optional(),limit:a.z.number().optional(),pagination:ba.optional()},Ii=a.z.object({...V,kind:a.z.literal("metric"),primaryValue:Y,measures:a.z.record(Y).optional(),missingMeasures:a.z.array(a.z.string()).optional(),comparison:a.z.object({kind:a.z.enum(["previous_period","previous_year","target"]),value:Y.optional(),delta:a.z.union([a.z.number(),a.z.null()]).optional(),deltaPercent:a.z.union([a.z.number(),a.z.null()]).optional()}).passthrough().optional(),records:C.optional()}).passthrough(),Ai=a.z.object({...V,kind:a.z.literal("records"),columns:a.z.array(M),records:C,totals:a.z.object({mode:a.z.literal("server"),scope:a.z.literal("filtered_result"),row:a.z.record(a.z.string(),a.z.unknown()),columns:a.z.array(M).optional()}).passthrough().optional()}).passthrough(),xi=a.z.object({...V,kind:a.z.literal("inputOptions"),options:a.z.array(K({label:a.z.string(),value:a.z.unknown(),count:a.z.number().optional(),disambiguation:a.z.array(a.z.string()).optional()},["value"]))}).passthrough(),Ri=a.z.object({...V,kind:a.z.literal("sql"),columns:a.z.array(M),records:C,sqlShape:a.z.object({statementType:a.z.string().optional(),explicitLimit:a.z.number().optional(),hasPythonCode:a.z.boolean().optional()}).passthrough().optional()}).passthrough(),_a=a.z.object({enabled:a.z.boolean().optional(),position:a.z.enum(["before","after"]).optional(),label:a.z.string().optional()}).passthrough(),Ge=a.z.object({id:a.z.enum(["rows","columns"]),levels:a.z.array(a.z.object({instanceId:a.z.string(),fieldKey:a.z.string(),label:a.z.string(),field:I,grain:vi.optional(),temporalBucket:W.optional(),subtotal:_a.optional()}).passthrough()),nodeIds:a.z.array(a.z.string())}).passthrough(),T=K({instanceId:a.z.string(),fieldKey:a.z.string(),value:a.z.unknown(),label:a.z.string().optional()},["value"]),va=a.z.union([a.z.object({kind:a.z.literal("member")}).passthrough(),a.z.object({kind:a.z.literal("field"),field:I,aggregate:_.optional()}).passthrough(),a.z.object({kind:a.z.literal("value"),valueId:a.z.string(),rowPath:a.z.array(T).optional(),columnPath:a.z.array(T).optional()}).passthrough()]),za=a.z.enum(["present","presentNull","missing","densified"]),Sa=a.z.enum(["value","rowSubtotal","columnSubtotal","subtotalIntersection","rowGrandTotal","columnGrandTotal","matrixGrandTotal"]),$a=a.z.object({instanceId:a.z.string(),fieldKey:a.z.string(),field:I,role:a.z.enum(["row","column","measure","sort","filter"]),label:a.z.string().optional()}).passthrough(),wa=a.z.union([a.z.object({kind:a.z.literal("additive"),aggregate:_.optional()}).passthrough(),a.z.object({kind:a.z.literal("semiAdditive"),aggregate:_.optional(),grain:vi.optional()}).passthrough(),a.z.object({kind:a.z.literal("nonAdditive"),aggregate:_.optional()}).passthrough(),a.z.object({kind:a.z.literal("ratio"),numeratorMeasureInstanceId:a.z.string().optional(),denominatorMeasureInstanceId:a.z.string().optional()}).passthrough(),a.z.object({kind:a.z.literal("custom"),expressionId:a.z.string().optional()}).passthrough()]),ka=a.z.object({instanceId:a.z.string(),fieldKey:a.z.string(),label:a.z.string(),field:I,aggregate:_.optional(),format:Si.optional(),totalBehavior:da.optional(),semantics:wa}).passthrough(),Ia=a.z.object({id:a.z.string(),measureId:a.z.string(),aggregate:_.optional(),label:a.z.string().optional(),source:a.z.enum(["measureDefault","rowSubtotal","columnSubtotal","subtotalIntersection","rowGrandTotal","columnGrandTotal","matrixGrandTotal","custom"]),scope:a.z.object({rowLevelId:a.z.string().optional(),columnLevelId:a.z.string().optional(),rowNodeId:a.z.string().optional(),columnNodeId:a.z.string().optional()}).passthrough().optional()}).passthrough(),Aa=a.z.object({kind:a.z.string(),label:a.z.string().optional(),payload:a.z.record(a.z.string(),a.z.unknown()).optional()}).passthrough(),xa=K({id:a.z.string(),axis:a.z.enum(["row","column"]),path:a.z.array(T),level:a.z.number(),label:a.z.string().optional(),value:a.z.unknown(),parentId:a.z.string().optional(),hasChildren:a.z.boolean(),isExpanded:a.z.boolean().optional(),isSubtotal:a.z.boolean().optional(),isGrandTotal:a.z.boolean().optional(),subtotalFunction:_.optional(),childCount:a.z.number().optional(),actions:a.z.array(Aa).optional()},["value"]),Ra=a.z.object({rowHeaderLevels:a.z.array(a.z.object({id:a.z.string(),label:a.z.string(),fieldInstanceId:a.z.string()}).passthrough()),columnHeaderRows:a.z.array(a.z.object({id:a.z.string(),cells:a.z.array(a.z.object({id:a.z.string(),label:a.z.string().optional(),role:a.z.enum(["rowHeader","columnHeader","measureHeader","subtotal","grandTotal"]),colSpan:a.z.number(),rowSpan:a.z.number(),columnPath:a.z.array(T),measureInstanceId:a.z.string().optional()}).passthrough())}).passthrough()),columns:a.z.array(a.z.object({id:a.z.string(),label:a.z.string().optional(),columnNodeId:a.z.string().optional(),columnPath:a.z.array(T),measureInstanceId:a.z.string(),role:a.z.enum(["value","columnSubtotal","columnGrandTotal"])}).passthrough())}).passthrough(),Ma=K({rowId:a.z.string(),columnId:a.z.string().optional(),measureId:a.z.string(),value:a.z.unknown(),presence:za,role:Sa,calculationId:a.z.string().optional()},["value"]).superRefine((e,i)=>{Object.prototype.hasOwnProperty.call(e,"formattedValue")&&i.addIssue({code:"custom",path:["formattedValue"],message:"Matrix result cells carry typed values; formattedValue is not supported."})}),Ta=a.z.object({rows:a.z.boolean().optional(),columns:a.z.boolean().optional(),grandTotal:a.z.union([a.z.boolean(),a.z.object({rows:a.z.boolean().optional(),columns:a.z.boolean().optional()}).passthrough()]).optional()}).passthrough(),Ea=K({id:a.z.string(),axis:a.z.enum(["row","column"]),targetInstanceId:a.z.string().optional(),direction:a.z.enum(["asc","desc"]),nulls:a.z.enum(["warehouseDefault","first","last"]).optional(),scope:a.z.enum(["global","withinParent"]).optional(),by:va},["by"]),Ca=a.z.object({rowOffset:a.z.number().optional(),rowLimit:a.z.number().optional(),columnOffset:a.z.number().optional(),columnLimit:a.z.number().optional(),hasMoreRows:a.z.boolean().optional(),hasMoreColumns:a.z.boolean().optional()}).passthrough(),Da=a.z.object({axis:a.z.enum(["row","column"]),path:a.z.array(T),depth:a.z.number().optional()}).passthrough(),Fa=a.z.object({rowLazyLoading:a.z.boolean().optional(),columnLazyLoading:a.z.boolean().optional(),expandableRowNodeIds:a.z.array(a.z.string()).optional(),expandableColumnNodeIds:a.z.array(a.z.string()).optional(),nextRequests:a.z.array(Da).optional()}).passthrough(),ja=a.z.object({domains:a.z.record(a.z.object({min:a.z.number().optional(),max:a.z.number().optional()}).passthrough()).optional(),rules:a.z.array(a.z.record(a.z.string(),a.z.unknown())).optional()}).passthrough(),Mi=a.z.object({...V,kind:a.z.literal("matrix"),schemaVersion:a.z.literal(2),shape:a.z.enum(["hierarchical","pivot"]),capabilities:a.z.array(a.z.string()),executionMetadata:a.z.record(a.z.string(),a.z.unknown()),fieldsById:a.z.record(a.z.string(),$a),measuresById:a.z.record(a.z.string(),ka),calculationsById:a.z.record(a.z.string(),Ia).optional(),axes:a.z.object({rows:Ge,columns:Ge}).passthrough(),nodesById:a.z.record(a.z.string(),xa),layout:Ra,cells:a.z.array(Ma),totals:Ta,sort:a.z.array(Ea),formattingContext:ja,pageInfo:Ca.optional(),expansion:Fa.optional()}).passthrough(),Ti=a.z.union([Ii,Ai,xi,Ri,Mi]),Ei=a.z.object({status:a.z.enum(["not_required","resolved","missing","ambiguous","fanout_risk","unknown"]),requiredSources:a.z.array(R).optional(),relationshipsUsed:a.z.array(a.z.string()).optional(),missingSources:a.z.array(a.z.string()).optional(),warnings:a.z.array(a.z.string()).optional(),message:a.z.string().optional(),recommendedNextStep:a.z.string().optional(),joinPlanSummary:a.z.object({baseSource:R.optional(),joinedSources:a.z.array(R).optional(),joinCount:a.z.number().optional()}).passthrough().optional(),fanoutRisk:a.z.object({status:a.z.enum(["none","warning","error","unknown"]),message:a.z.string().optional()}).passthrough().optional()}).passthrough(),Ue=a.z.enum(["ambiguous_fields","empty_result","missing_grounded_fields","missing_relationship","no_grounded_query","partial_result","presentation_incomplete","query_validation_failed","unsafe_join"]),Me=a.z.object({version:a.z.literal(1),status:a.z.enum(["answered","partial","blocked"]),summary:a.z.string(),answered:a.z.array(a.z.object({slotId:a.z.string().optional(),queryId:a.z.string().optional(),summary:a.z.string(),evidenceIds:a.z.array(a.z.string()).optional(),fieldsUsed:a.z.array(de).optional()}).passthrough()),blocked:a.z.array(a.z.object({slotId:a.z.string().optional(),queryId:a.z.string().optional(),reasonCode:Ue,message:a.z.string(),missingFields:a.z.array(a.z.string()).optional(),availableFields:a.z.array(a.z.string()).optional(),ambiguousFields:a.z.array(a.z.string()).optional(),missingRelationships:a.z.array(a.z.string()).optional(),evidenceIds:a.z.array(a.z.string()).optional(),neededFromUser:a.z.array(a.z.string()).optional(),recommendedNextStep:a.z.string().optional()}).passthrough()),semanticModelRecommendations:a.z.array(a.z.object({reasonCode:Ue,message:a.z.string(),recommendedNextStep:a.z.string().optional()}).passthrough()).optional()}).passthrough(),Te=a.z.object({scope:a.z.literal("filtered_query"),measures:a.z.record(Y)}).passthrough(),Ee=a.z.object({answeredObligations:a.z.array(a.z.string()),missingObligations:a.z.array(a.z.string()),warnings:a.z.array(J).optional()}).passthrough(),Ci=a.z.object({intentId:a.z.string().optional(),queryId:a.z.string().optional(),status:a.z.enum(["answered","partial","failed"]),resultShape:a.z.enum(["metric","records","inputOptions","sql","matrix","period_change","analysis"]).optional(),intent:a.z.unknown().optional(),compiledQuery:a.z.unknown().optional(),fieldsUsed:a.z.array(de).optional(),result:Ti.optional(),validation:Re,coverage:Ee.optional(),missingFields:a.z.array(a.z.string()).optional(),warnings:a.z.array(a.z.string()).optional(),relationshipDiagnostics:Ei.optional(),diagnosticFeedback:Me.optional(),population:Te.optional(),metadata:a.z.record(a.z.string(),a.z.unknown()).optional()}).passthrough();function Na(e){switch(e){case"boolean":return a.z.boolean().optional();case"compactExecutionFieldArray":return a.z.array(ga).optional();case"coverage":return Ee.optional();case"diagnosticFeedback":return Me.optional();case"executionFieldArray":return a.z.array(de).optional();case"executionResult":return Ci.optional();case"number":return a.z.number().finite().optional();case"population":return Te.optional();case"record":return b.optional();case"recordArray":return C.optional();case"responseDetail":return a.z.enum(["compact","standard","debug"]).optional();case"string":return a.z.string().optional();case"stringArray":return a.z.array(a.z.string()).optional();case"unknown":return a.z.unknown().optional();case"unknownArray":return a.z.array(a.z.unknown()).optional();case"validationResult":return Re.optional()}}const Di=Object.fromEntries(Object.entries(di).map(([e,i])=>[e,Na(i)])),qa=a.z.object(Di).strict(),Ce=a.z.object({sourceKey:a.z.string().optional(),kind:a.z.enum(["semantic","physical","sql"]).optional(),domainId:a.z.string().optional(),datasetName:a.z.string().optional(),datasetId:a.z.string().optional(),connectionId:a.z.string().optional(),tableName:a.z.string().optional(),label:a.z.string().optional()}).passthrough(),w=a.z.object({name:a.z.string(),label:a.z.string().optional(),role:a.z.enum(["dimension","measure","date","id","unknown"]).optional(),dataType:a.z.enum(["string","number","boolean","date","datetime","unknown"]).optional(),aggregate:_.optional(),sourceKey:a.z.string().optional(),source:Ce.optional()}).passthrough(),Fi=a.z.object({id:a.z.string().optional(),builder:a.z.literal("semaphor.inputOptions"),source:Ce.optional(),sourceKey:a.z.string().optional(),valueFieldRef:w,labelFieldRef:w,filterFieldRef:w.optional(),population:a.z.unknown().optional(),dependencies:a.z.unknown().optional(),limit:a.z.number().int().positive().optional(),spec:b.optional()}).passthrough(),ji=a.z.object({appliesToViewIds:a.z.array(a.z.string()).optional(),viewId:a.z.string().optional(),fieldRef:w,relationshipHint:a.z.unknown().optional(),relationshipsUsed:a.z.array(b).optional()}).passthrough(),Oa=a.z.object({id:a.z.string(),label:a.z.string().optional(),type:a.z.string().optional(),serverSide:a.z.boolean().optional(),fieldRef:w.optional(),optionQuery:Fi.optional(),bindings:a.z.array(ji).optional(),appliesToViewIds:a.z.array(a.z.string()),relationshipHint:a.z.unknown().optional(),relationshipsUsed:a.z.array(b).optional()}).passthrough(),Pa=a.z.object({builder:a.z.enum(["semaphor.metric","semaphor.records","semaphor.matrix","semaphor.analysis","semaphor.sql"]),spec:b,fallbackReason:b.optional()}).passthrough(),Ba=a.z.object({id:a.z.string(),title:a.z.string().optional(),purpose:a.z.string().optional(),sourcePresentation:a.z.object({sourceKeys:a.z.array(a.z.string()).optional(),sourceLabels:a.z.array(a.z.string()).optional()}).passthrough().optional(),visual:a.z.string().optional(),visualSpec:b.optional(),queryKind:a.z.enum(["metric","records","matrix","analysis","sql_fallback"]).optional(),sdkBuilder:a.z.enum(["semaphor.metric","semaphor.records","semaphor.matrix","semaphor.analysis","semaphor.sql"]).optional(),sdkSpec:Pa.optional(),fields:a.z.array(w).optional(),computation:b.optional(),uxExpectations:a.z.array(a.z.string()).optional(),validation:b.optional()}).passthrough(),Ka=a.z.object({inputId:a.z.string(),label:a.z.string().optional(),type:a.z.string().optional(),serverSide:a.z.boolean().optional(),fieldRef:w.optional(),optionQuery:Fi.optional(),bindings:a.z.array(ji),appliesToViewIds:a.z.array(a.z.string()),notAppliedToViewIds:a.z.array(a.z.string())}).passthrough(),Va=a.z.object({schemaVersion:a.z.literal(Z),title:a.z.string(),purpose:a.z.string().optional(),userGoal:a.z.string().optional(),nextStep:a.z.string().optional(),sources:a.z.array(Ce),inputs:a.z.array(Oa),views:a.z.array(Ba),filterContracts:a.z.array(Ka),implementationChecklist:a.z.object({schemaVersion:a.z.string().optional(),requiredDevtools:a.z.object({mountRootDevtools:a.z.boolean(),providerDebugBridge:a.z.string().optional(),panelPosition:a.z.string().optional(),forbidden:a.z.array(a.z.string()).optional()}).passthrough(),requiredInputOptions:a.z.array(b),filterScopeByInput:a.z.array(b),bindingsByView:a.z.record(a.z.string(),a.z.array(b)),validationCommands:a.z.array(a.z.string()),browserSmokeChecks:a.z.array(a.z.string())}).passthrough(),nextRequiredTool:a.z.object({name:a.z.string(),reason:a.z.string().optional()}).optional(),unsupportedInsights:a.z.array(a.z.object({title:a.z.string(),requestedQuestion:a.z.string(),reason:a.z.string(),suggestedModelingFix:a.z.string()}).passthrough()).optional(),assumptions:a.z.array(a.z.string()).optional(),validation:b.optional()}).passthrough().superRefine((e,i)=>{const t=ke(e);for(const n of t.issues)i.addIssue({code:a.z.ZodIssueCode.custom,message:n})});function ue(e){return typeof e=="string"?e.trim().toLowerCase():""}function Ni(e){return String(e.column_name||e.name||e.qualifiedFieldName||"")}function qi(e){return Array.from(new Set([e.column_name,e.name,e.qualifiedFieldName,e.alias].filter(i=>typeof i=="string"&&i.trim().length>0).map(i=>i.trim())))}function ce(e){const i=Ua(e);return i?Ga(i)?"number":i.includes("timestamp")||i.includes("datetime")||i.startsWith("time")?"datetime":i.includes("date")?"date":i.includes("bool")?"boolean":"string":"unknown"}const La=new Set(["int","uint","integer","bigint","smallint","tinyint","numeric","decimal","double","float","number","real","money","currency","percent"]),Ha=["int","uint","decimal","float"];function Ga(e){const i=e.split(/[\s(]/,1)[0]||"";return La.has(i)?!0:Ha.some(t=>{if(!i.startsWith(t))return!1;const n=i.slice(t.length);return n.length>0&&Array.from(n).every(s=>s>="0"&&s<="9")})}function Ua(e){let i=ue(e),t="";for(;i&&i!==t;)t=i,i=Ye(i,"nullable"),i=Ye(i,"lowcardinality");return i}function Ye(e,i){const t=`${i}(`;return!e.startsWith(t)||!e.endsWith(")")?e:e.slice(t.length,-1).trim()}function Oi(e){const i=ce(e);return i==="date"||i==="datetime"}function De(e){return Oi(e.dataType||e.data_type)}function Fe(e){const i=Pi(e);return i==="id"||i==="row_id"}function _e(e){const i=Pi(e);return Fe(e)||i.endsWith("_id")||i.endsWith("_key")||i.endsWith("_number")}function Pi(e){return ue(Ni(e)||e.name||e.alias).replace(/[^a-z0-9]+/g,"_").replace(/^_+|_+$/g,"")}function je(e,i={}){const t=ue(e.role);return t==="metric"||t==="measure"?!i.excludeIdentifiers||!_e(e):t==="groupby"||t==="dimension"||t==="date"||t==="id"?!1:ce(e.dataType||e.data_type)==="number"&&(!i.excludeIdentifiers||!_e(e))}function Ya(e){return!je(e)&&!De(e)}function Qa(e){const i=new Set,t=new Set,n=new Set;for(const s of e){if(Fe(s))continue;const r=qi(s);if(r.length!==0){if(De(s)){r.forEach(l=>t.add(l));continue}if(je(s,{excludeIdentifiers:!0})){r.forEach(l=>i.add(l));continue}r.forEach(l=>n.add(l))}}return{validMeasureCandidates:Array.from(i).sort(),validDateCandidates:Array.from(t).sort(),validDimensionCandidates:Array.from(n).sort()}}const Bi=["YYYY","MMMM","MMM","YY","MM","DD","HH","mm","ss"],Za=new Set([" ","-","/",":",".",",","T"]),Ki={week_of_short:"week",week_of_long:"week",quarter_short:"quarter",quarter_long:"quarter",fiscal_quarter_short:"quarter",fiscal_year:"year"};function Xa(e){return typeof e=="string"&&Object.prototype.hasOwnProperty.call(Ki,e)}function Wa(e,i){return Bi.find(t=>e.startsWith(t,i))}function Vi(e){var s;if(!e||e.trim()!==e)return{ok:!1,code:"invalid_temporal_bucket_pattern",message:"Temporal bucket patterns must be non-empty and trimmed."};const i=[];let t=0,n=!1;for(;t<e.length;){const r=Wa(e,t);if(r){if(n)return{ok:!1,code:"invalid_temporal_bucket_pattern",message:"Adjacent temporal bucket tokens require a separator."};i.push({kind:"token",value:r}),t+=r.length,n=!0;continue}const l=e[t];if(!Za.has(l))return{ok:!1,code:"invalid_temporal_bucket_pattern",message:`Unsupported temporal bucket pattern character "${l}".`};if(i.length===0)return{ok:!1,code:"invalid_temporal_bucket_pattern",message:"Temporal bucket patterns cannot begin with a separator."};const d=i[i.length-1];d.kind==="literal"?d.value+=l:i.push({kind:"literal",value:l}),t+=1,n=!1}return((s=i[i.length-1])==null?void 0:s.kind)!=="token"?{ok:!1,code:"invalid_temporal_bucket_pattern",message:"Temporal bucket patterns cannot end with a separator."}:{ok:!0,segments:i}}function Ja(e){return e.flatMap(i=>i.kind==="token"?[i.value]:[])}function Qe(e,i){return e.filter(t=>i.includes(t)).length===1}function G(e,i){return e.some(t=>i.includes(t))}function en(e){return new Set(e).size!==e.length}function tn(e,i){if(en(e))return!1;const t=["YYYY","YY"],n=["MMMM","MMM","MM"],s=["HH","mm","ss"],r=Qe(e,t),l=Qe(e,n),d=e.includes("DD"),u=G(e,s);switch(i){case"second":return e.includes("HH")&&e.includes("mm")&&e.includes("ss")&&(!G(e,[...t,...n,"DD"])||r&&l&&d);case"minute":return e.includes("HH")&&e.includes("mm")&&(!G(e,[...t,...n,"DD"])||r&&l&&d);case"hour":return e.includes("HH")&&(!G(e,[...t,...n,"DD"])||r&&l&&d);case"day":case"week":return r&&l&&d&&!u;case"month":return r&&l&&!d&&!u;case"quarter":return!1;case"year":return r&&!l&&!d&&!u}}function ee(e,i){if(e.presentation.mode==="auto")return{ok:!0};if(e.presentation.mode==="preset"){const n=Ki[e.presentation.preset];return n===i?{ok:!0}:{ok:!1,code:"incompatible_temporal_bucket_preset",message:`Preset ${e.presentation.preset} requires ${n} granularity.`}}const t=Vi(e.presentation.pattern);return t.ok?tn(Ja(t.segments),i)?{ok:!0,segments:t.segments}:{ok:!1,code:"incompatible_temporal_bucket_pattern",message:`Pattern ${e.presentation.pattern} is not compatible with ${i} granularity.`}:t}function an(e,i){if(!(!e||!i))return ee(e,i).ok?e:void 0}function o(e,i,t){return t?{code:e,message:i,path:t}:{code:e,message:i}}function nn(e){for(let i=0;i<e.length;i+=1){const t=e[i];if(e.some((n,s)=>s!==i&&Hi(n,t)))return!1}return!0}function Li(e,i){return ui(e,i)}function Hi(e,i){return Li(e,i)&&P(e)===P(i)}function sn(e){return`Metric intent has duplicate measure "${e.name}" with the same aggregate (${P(e)}). Use different aggregates to request both, or remove one entry.`}function Ze(e){return typeof e=="string"||typeof e=="number"||typeof e=="boolean"||e===null}function on(e,i,t){if(e!==void 0){if(!e||typeof e!="object"||Array.isArray(e)){t.push(o("invalid_sql_default_parameters","SQL defaultParameters must be an object keyed by parameter name.",i));return}Object.entries(e).forEach(([n,s])=>{if(!n.trim()){t.push(o("invalid_sql_default_parameter_name","SQL defaultParameters names must be non-empty strings.",`${i}.${n}`));return}(Array.isArray(s)?s.every(Ze):Ze(s))||t.push(o("invalid_sql_default_parameter_value","SQL defaultParameters values must be strings, numbers, booleans, nulls, or arrays of those scalar values.",`${i}.${n}`))})}}function rn(e,i){return Ne(e,i).length===1}function ln(e,i){return Ne(e,i).length===1}function Ne(e,i){return i.filter(n=>dn(e,n))}function dn(e,i){return un(e,i)?e.source?Li(i,e):!0:!1}function un(e,i){return!(i.name!==e.name||e.role!==void 0&&i.role!==void 0&&i.role!==e.role||cn(e,i)&&P(i)!==P(e))}function cn(e,i){return e.role==="measure"||i.role==="measure"||e.aggregate!==void 0||i.aggregate!==void 0}function P(e){return se(e)}const pn=/^(\d{4})-(\d{2})-(\d{2})$/,Gi=/^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2})(?::(\d{2})(?:\.(\d+))?)?(Z|[+-]\d{2}:\d{2})$/;function ie(e){if(typeof e!="string")return null;const i=e.trim(),t=pn.exec(i);if(t){const[,v,D,F]=t;return Xe(v,D,F)?new Date(Date.UTC(Number(v),Number(D)-1,Number(F))):null}const n=Gi.exec(i);if(!n)return null;const[,s,r,l,d,u,p="00",,y]=n;if(!Xe(s,r,l)||!O(d,0,23)||!O(u,0,59)||!O(p,0,59)||!fn(y))return null;const x=new Date(i);return Number.isFinite(x.getTime())?x:null}function mn(e){return typeof e!="string"||!Gi.test(e.trim())?null:ie(e)}function Xe(e,i,t){const n=Number(e),s=Number(i),r=Number(t);if(!Number.isInteger(n)||!Number.isInteger(s)||!Number.isInteger(r)||s<1||s>12)return!1;const l=new Date(Date.UTC(n,s-1,r));return l.getUTCFullYear()===n&&l.getUTCMonth()===s-1&&l.getUTCDate()===r}function O(e,i,t){const n=Number(e);return Number.isInteger(n)&&n>=i&&n<=t}function fn(e){if(e==="Z")return!0;const i=/^([+-])(\d{2}):(\d{2})$/.exec(e);return!!(i&&O(i[2],0,23)&&O(i[3],0,59))}function f(e){return typeof e=="string"&&e.trim().length>0}function gn(e){const i=new Set;let t=0;for(;t<e.length;){const n=e[t];if(n==="'"||n==='"'){t=hn(e,t);continue}if(n==="{"){const s=e.indexOf("}",t+1);if(s===-1){t+=1;continue}const r=e.slice(t+1,s);/^[A-Za-z_][A-Za-z0-9_]*$/.test(r)&&i.add(r),t=s+1;continue}t+=1}return Array.from(i)}function hn(e,i){const t=e[i];let n=i+1;for(;n<e.length;){if(e[n]===t){if(e[n+1]===t){n+=2;continue}return n+1}n+=1}return e.length}function m(e){return!!(e&&typeof e=="object"&&!Array.isArray(e))}function We(e,i,t){if(e!==void 0){if(!m(e)){t.push(o("invalid_pagination","Pagination must be an object with positive integer page and pageSize.",i));return}(!Number.isInteger(e.page)||typeof e.page!="number"||e.page<1)&&t.push(o("invalid_pagination_page","Pagination page must be a positive integer.",`${i}.page`)),(!Number.isInteger(e.pageSize)||typeof e.pageSize!="number"||e.pageSize<1)&&t.push(o("invalid_pagination_page_size","Pagination pageSize must be a positive integer.",`${i}.pageSize`))}}function ve(e){const i=new Set;for(const t of e){if(i.has(t))return t;i.add(t)}return null}function ye(e,i,t,n){ve(e.filter(r=>f(r)))&&n.push(o("duplicate_matrix_public_id",`Matrix ${t} ids must be unique so sort and expansion references are unambiguous.`,i))}const yn=new Set(["SUM","COUNT","AVG","MIN","MAX","MEDIAN","DISTINCT"]);function qe(e,i,t){if(!e||typeof e!="object"){t.push(o("missing_source","Analytics intent needs a source.",i));return}if(e.kind==="semantic"){f(e.domainId)||t.push(o("missing_semantic_domain","Semantic source needs a domainId.",`${i}.domainId`)),f(e.datasetName)||t.push(o("missing_dataset_name","Semantic source needs a datasetName.",`${i}.datasetName`));return}if(e.kind==="physical"){f(e.connectionId)||t.push(o("missing_connection_id","Physical source needs a connectionId.",`${i}.connectionId`)),f(e.tableName)||t.push(o("missing_table_name","Physical source needs a tableName.",`${i}.tableName`));return}if(e.kind==="sql"){f(e.connectionId)||t.push(o("missing_connection_id","SQL source needs a connectionId.",`${i}.connectionId`));return}t.push(o("invalid_source_kind","Source kind is not supported.",i))}function g(e,i,t,n={}){if(!e||!m(e)){n.required&&t.push(o("missing_field_ref","Field reference needs a name.",i));return}f(e.name)||t.push(o("missing_field_ref","Field reference needs a name.",`${i}.name`)),e.source!==void 0&&qe(e.source,`${i}.source`,t),A(e.aggregate,`${i}.aggregate`,t)}function bn(e,i,t){if(!m(e)){t.push(o("invalid_input_binding","Input bindings must be structured objects.",i));return}f(e.inputId)||t.push(o("invalid_input_binding","Input bindings need a non-empty inputId.",`${i}.inputId`)),e.kind!==void 0&&e.kind!=="filter"&&e.kind!=="control"&&t.push(o("invalid_input_binding","Input binding kind must be filter or control.",`${i}.kind`)),e.field!==void 0&&g(e.field,`${i}.field`,t),e.relationshipHint!==void 0&&Oe(e.relationshipHint,`${i}.relationshipHint`,t)}function Oe(e,i,t){if(!m(e)){t.push(o("invalid_relationship_hint","Relationship hints must be structured objects.",i));return}e.relationshipIds!==void 0&&(!Array.isArray(e.relationshipIds)||e.relationshipIds.some(n=>!f(n)))&&t.push(o("invalid_relationship_hint","Relationship hint relationshipIds must be non-empty strings.",`${i}.relationshipIds`))}function _n(e,i){var n,s;if(((n=e.source)==null?void 0:n.kind)!=="semantic"&&((s=e.source)==null?void 0:s.kind)!=="physical"&&i.push(o("invalid_input_options_source","Input options must use a semantic or physical source.","source")),f(e.inputId)||i.push(o("missing_input_options_input_id","Input options intent needs the inputId it populates.","inputId")),e.search!==void 0&&typeof e.search!="string"&&i.push(o("invalid_input_options_search","Input options search must be a string.","search")),e.limit!==void 0&&(typeof e.limit!="number"||!Number.isFinite(e.limit)||!Number.isInteger(e.limit)||e.limit<=0)&&i.push(o("invalid_input_options_limit","Input options limit must be a positive finite number.","limit")),(!e.labelField||!f(e.labelField.name))&&i.push(o("missing_input_options_label_field","Input options intent needs a labelField.","labelField")),g(e.labelField,"labelField",i,{required:!0}),(!e.valueField||!f(e.valueField.name))&&i.push(o("missing_input_options_value_field","Input options intent needs a valueField.","valueField")),g(e.valueField,"valueField",i,{required:!0}),e.searchField!==void 0&&g(e.searchField,"searchField",i,{required:!0}),e.disambiguationFields!==void 0&&(Array.isArray(e.disambiguationFields)?e.disambiguationFields.forEach((r,l)=>{g(r,`disambiguationFields.${l}`,i,{required:!0})}):i.push(o("invalid_input_options_disambiguation_fields","Input options disambiguationFields must be an array of field refs.","disambiguationFields"))),[{field:e.labelField,path:"labelField"},{field:e.valueField,path:"valueField"},...e.searchField?[{field:e.searchField,path:"searchField"}]:[],...Array.isArray(e.disambiguationFields)?e.disambiguationFields.map((r,l)=>({field:r,path:`disambiguationFields.${l}`})):[]].forEach(({field:r,path:l})=>{r!=null&&r.source&&!ne(r.source,e.source)&&i.push(o("input_options_field_source_mismatch","Input option fields must belong to the declared option source.",`${l}.source`))}),e.dependencies!==void 0){const r=e.dependencies;if(!m(r))i.push(o("invalid_input_options_dependencies","Input options dependencies must be a structured object.","dependencies"));else{const l=r.mode;l!==void 0&&l!=="independent"&&l!=="explicit"&&i.push(o("invalid_input_options_dependencies","Input options dependencies mode must be independent or explicit.","dependencies.mode")),Je(r.includeInputIds,"dependencies.includeInputIds",i,"Input options includeInputIds must be non-empty strings."),Je(r.excludeInputIds,"dependencies.excludeInputIds",i,"Input options excludeInputIds must be non-empty strings."),zn(e,i)}}if(e.population!==void 0){const r=e.population;if(!m(r))i.push(o("invalid_input_options_population","Input options population must be a structured object.","population"));else{const l=r.kind;l!=="option_source"&&l!=="related_population"&&i.push(o("invalid_input_options_population","Input options population kind must be option_source or related_population.","population.kind")),l==="option_source"&&r.baseSource!==void 0&&i.push(o("invalid_input_options_population","Input options population baseSource is only valid for related_population.","population.baseSource")),l==="option_source"&&r.relationshipHint!==void 0&&i.push(o("invalid_input_options_population","Input options population relationshipHint is only valid for related_population.","population.relationshipHint")),l==="related_population"&&(qe(r.baseSource,"population.baseSource",i),r.relationshipHint!==void 0&&Oe(r.relationshipHint,"population.relationshipHint",i))}}}function vn(e,i){if(!(!("inputs"in e)||e.inputs===void 0)){if(!Array.isArray(e.inputs)){i.push(o("invalid_input_binding","Analytics intent inputs must be an array of input bindings.","inputs"));return}e.inputs.forEach((t,n)=>bn(t,`inputs.${n}`,i))}}function zn(e,i){var n,s;const t=new Set(Array.isArray(e.inputs)?e.inputs.map(r=>m(r)?r.inputId:void 0).filter(r=>typeof r=="string"):[]);for(const r of((n=e.dependencies)==null?void 0:n.includeInputIds)||[])t.has(r)||i.push(o("invalid_input_options_dependencies",`Input options dependency "${r}" is not declared in inputs.`,"dependencies.includeInputIds"));for(const r of((s=e.dependencies)==null?void 0:s.excludeInputIds)||[])r!==e.inputId&&!t.has(r)&&i.push(o("invalid_input_options_dependencies",`Input options dependency exclusion "${r}" is not the populated inputId and is not declared in inputs.`,"dependencies.excludeInputIds"))}function Je(e,i,t,n){e!==void 0&&(!Array.isArray(e)||e.some(s=>!f(s)))&&t.push(o("invalid_input_options_dependencies",n,i))}function A(e,i,t){e!==void 0&&(typeof e!="string"||!yn.has(e))&&t.push(o("invalid_aggregate","Field aggregate must be SUM, COUNT, AVG, MIN, MAX, MEDIAN, or DISTINCT.",i))}const Sn=new Set(["measure","dimension","date","id","unknown"]),$n=new Set(["row","aggregate"]),Ui=new Set(["string","number","boolean","date","datetime","unknown"]),wn=new Set(["number","currency","percent","percentage","scientific","date","datetime","duration","string","temporal_bucket"]),kn=new Set(E),In=new Set(["millisecond","second","minute","hour","day"]),An=new Set(["compact","digital","long"]);function Yi(e,i,t){if(e===void 0)return;if(!m(e)){t.push(o("invalid_value_format","Value format must be a structured object.",i));return}const n=e;(typeof n.type!="string"||!wn.has(n.type))&&t.push(o("invalid_value_format_type","Value format type must be number, currency, percent, percentage, scientific, date, datetime, duration, string, or temporal_bucket.",`${i}.type`)),n.type==="temporal_bucket"&&!X.safeParse(e).success&&t.push(o("invalid_temporal_bucket_format","Temporal bucket format must contain a valid auto, preset, or pattern presentation.",i)),(n.type==="number"||n.type==="currency"||n.type==="percent"||n.type==="percentage"||n.type==="scientific")&&Object.prototype.hasOwnProperty.call(e,"locale")&&t.push(o("invalid_value_format","Numeric value formats cannot define viewer locale.",`${i}.locale`)),U(e.minimumFractionDigits,`${i}.minimumFractionDigits`,t),U(e.maximumFractionDigits,`${i}.maximumFractionDigits`,t),U(e.scale,`${i}.scale`,t),U(e.maxUnits,`${i}.maxUnits`,t),e.useGrouping!==void 0&&typeof e.useGrouping!="boolean"&&t.push(o("invalid_value_format_use_grouping","Value format useGrouping must be boolean.",`${i}.useGrouping`)),e.negativeStyle!==void 0&&e.negativeStyle!=="minus"&&e.negativeStyle!=="parentheses"&&t.push(o("invalid_value_format_negative_style","Value format negativeStyle must be minus or parentheses.",`${i}.negativeStyle`)),e.percentValueMode!==void 0&&e.percentValueMode!=="fraction"&&e.percentValueMode!=="whole"&&t.push(o("invalid_value_format_percent_mode","Value format percentValueMode must be fraction or whole.",`${i}.percentValueMode`));for(const s of["inputUnit","largestUnit","smallestUnit"]){const r=e[s];r!==void 0&&(typeof r!="string"||!In.has(r))&&t.push(o("invalid_value_format_duration_unit","Duration format units must be millisecond, second, minute, hour, or day.",`${i}.${s}`))}e.outputStyle!==void 0&&(typeof e.outputStyle!="string"||!An.has(e.outputStyle))&&t.push(o("invalid_value_format_duration_style","Duration format outputStyle must be compact, digital, or long.",`${i}.outputStyle`))}function Qi(e,i,t){if(m(e)&&e.type==="temporal_bucket"){t.push(o("invalid_scalar_value_format","Scalar and measure slots cannot own temporal bucket presentation; declare it with grain on a grouped field or axis.",i));return}Yi(e,i,t)}function U(e,i,t){e!==void 0&&(typeof e!="number"||!Number.isFinite(e))&&t.push(o("invalid_value_format_number","Value format numeric options must be finite numbers.",i))}const xn=new Set(["additive","non_additive","ratio_of_sums","weighted","pre_aggregated","snapshot"]),Rn=new Set(["default","symmetric_aggregate","aggregate_then_join","weighted"]);function Mn(e,i,t){if(!e||!m(e)){t.push(o("invalid_derived_field_input","Derived field inputs must be structured input references.",i));return}if(e.kind==="field"){g(e.field,`${i}.field`,t,{required:!0}),A(e.aggregate,`${i}.aggregate`,t);return}t.push(o("invalid_derived_field_input","Derived field input kind must be field.",`${i}.kind`))}function ei(e,i,t){if(!m(e)){t.push(o("invalid_result_column_ref","Result calculation references must use columnKey or field.",i));return}const n=f(e.columnKey),s=m(e.field);if(n===s){t.push(o("invalid_result_column_ref","Result calculation references must identify exactly one of columnKey or field.",i));return}s&&g(e.field,`${i}.field`,t,{required:!0})}function Tn(e,i,t){if(!m(e)){t.push(o("invalid_result_calculation_output","Result calculation output must be a structured object.",i));return}f(e.key)||t.push(o("invalid_result_calculation_output","Result calculation output needs a stable key.",`${i}.key`)),e.dataType!==void 0&&(typeof e.dataType!="string"||!Ui.has(e.dataType))&&t.push(o("invalid_result_calculation_output","Result calculation output dataType must be string, number, boolean, date, datetime, or unknown.",`${i}.dataType`)),Qi(e.format,`${i}.format`,t)}function En(e,i,t){e!==void 0&&(si(e)||t.push(o("invalid_time_grain",`Matrix time grain must be one of: ${ae.join(", ")}.`,i)))}function Zi(e,i,t,n){e!=="asc"&&e!=="desc"&&t.push(o(n,"Sort direction must be asc or desc.",i))}function Xi(e,i,t,n){e!==void 0&&e!=="warehouseDefault"&&e!=="first"&&e!=="last"&&t.push(o(n,"Null ordering must be warehouseDefault, first, or last.",i))}function Wi(e,i,t,n){e!==void 0&&e!=="global"&&e!=="withinParent"&&t.push(o(n,"Sort scope must be global or withinParent.",i))}function Cn(e,i,t){e.enabled!==void 0&&typeof e.enabled!="boolean"&&t.push(o("invalid_matrix_subtotal","Matrix subtotal enabled must be a boolean.",`${i}.enabled`)),e.position!==void 0&&e.position!=="before"&&e.position!=="after"&&t.push(o("invalid_matrix_subtotal","Matrix subtotal position must be before or after.",`${i}.position`)),e.label!==void 0&&typeof e.label!="string"&&t.push(o("invalid_matrix_subtotal","Matrix subtotal label must be a string.",`${i}.label`))}function Dn(e,i,t){if(Zi(e.direction,`${i}.direction`,t,"invalid_matrix_sort_direction"),Xi(e.nulls,`${i}.nulls`,t,"invalid_matrix_sort_nulls"),Wi(e.scope,`${i}.scope`,t,"invalid_matrix_sort_scope"),!m(e.by)){t.push(o("invalid_matrix_sort_by","Matrix sort by must be a structured object.",`${i}.by`));return}if(e.by.kind!=="member"){if(e.by.kind==="field"){g(e.by.field,`${i}.by.field`,t,{required:!0}),A(e.by.aggregate,`${i}.by.aggregate`,t);return}t.push(o("invalid_matrix_sort_by","Matrix axis sort by must be member or field.",`${i}.by.kind`))}}function ii(e,i,t,n){if(!Array.isArray(e))return n.required?t.push(o("missing_matrix_rows","Matrix intent needs at least one row axis level.",i)):e!==void 0&&t.push(o("invalid_matrix_columns","Matrix columns must be an array of axis levels.",i)),[];n.required&&e.length===0&&t.push(o("missing_matrix_rows","Matrix intent needs at least one row axis level.",i));const s=[];return e.forEach((r,l)=>{var D,F;const d=`${i}.${l}`;if(!m(r)){t.push(o("invalid_matrix_axis_level","Matrix axis levels must be structured objects.",d));return}const u=r;s.push(u),u.id!==void 0&&!f(u.id)&&t.push(o("invalid_matrix_axis_level_id","Matrix axis level id must be a non-empty string.",`${d}.id`)),g(u.field,`${d}.field`,t,{required:!0}),En(u.grain,`${d}.grain`,t);const p=ce((D=u.field)==null?void 0:D.dataType),y=((F=u.field)==null?void 0:F.role)==="date"||p==="date"||p==="datetime",x=p==="string"||p==="number"||p==="boolean";y&&!u.grain&&t.push(o("missing_matrix_temporal_grain","Temporal Matrix axis levels require an explicit supported grain.",`${d}.grain`)),x&&u.grain&&t.push(o("invalid_matrix_temporal_grain","Matrix grain is valid only for temporal axis fields.",`${d}.grain`)),u.format!==void 0&&(!u.grain||!X.safeParse(u.format).success?t.push(o("invalid_matrix_temporal_format","Matrix temporal presentation requires a valid structured format and explicit grain.",`${d}.format`)):ee(u.format,u.grain).ok||t.push(o("invalid_matrix_temporal_format","Matrix temporal presentation is not applicable to the selected grain.",`${d}.format`)));const v=u.semanticTemporalPresentation;if(v!==void 0){const Be=v==null?void 0:v.format;!u.grain||(v==null?void 0:v.granularity)!==u.grain||!X.safeParse(Be).success?t.push(o("invalid_matrix_temporal_format","Matrix semantic temporal presentation must match the selected grain.",`${d}.semanticTemporalPresentation`)):ee(Be,u.grain).ok||t.push(o("invalid_matrix_temporal_format","Matrix semantic temporal presentation is not applicable to the selected grain.",`${d}.semanticTemporalPresentation.format`))}u.label!==void 0&&typeof u.label!="string"&&t.push(o("invalid_matrix_axis_label","Matrix axis level label must be a string.",`${d}.label`)),u.subtotal!==void 0&&typeof u.subtotal!="boolean"&&(m(u.subtotal)?Cn(u.subtotal,`${d}.subtotal`,t):t.push(o("invalid_matrix_subtotal","Matrix subtotal must be a boolean or structured options object.",`${d}.subtotal`))),u.sortBy!==void 0&&(m(u.sortBy)?Dn(u.sortBy,`${d}.sortBy`,t):t.push(o("invalid_matrix_sort_by","Matrix axis sortBy must be a structured object.",`${d}.sortBy`)))}),s}function Fn(e,i,t){if(!m(e)){t.push(o("invalid_matrix_total_behavior","Matrix total behavior must be a structured object.",i));return}if(e.kind!=="defaultAggregate"&&e.kind!=="blank"&&e.kind!=="labelOnly"&&e.kind!=="customAggregate"&&e.kind!=="percentOfParent"&&e.kind!=="percentOfGrandTotal"&&e.kind!=="customExpression"){t.push(o("invalid_matrix_total_behavior","Matrix total behavior kind is not supported.",`${i}.kind`));return}e.kind==="customAggregate"&&(Object.prototype.hasOwnProperty.call(e,"aggregate")?A(e.aggregate,`${i}.aggregate`,t):t.push(o("invalid_matrix_total_behavior","Custom matrix total behavior needs an aggregate.",`${i}.aggregate`))),e.kind==="customExpression"&&!f(e.expressionId)&&t.push(o("invalid_matrix_total_behavior","Custom matrix total behavior needs an expressionId.",`${i}.expressionId`)),e.kind==="labelOnly"&&e.label!==void 0&&typeof e.label!="string"&&t.push(o("invalid_matrix_total_behavior","Matrix label-only total behavior label must be a string.",`${i}.label`))}function jn(e,i,t){if(!Array.isArray(e)||e.length===0)return t.push(o("missing_matrix_values","Matrix intent needs at least one value field.",i)),[];const n=[];return e.forEach((s,r)=>{const l=`${i}.${r}`;if(!m(s)){t.push(o("invalid_matrix_value","Matrix values must be structured objects.",l));return}const d=s;n.push(d),d.id!==void 0&&!f(d.id)&&t.push(o("invalid_matrix_value_id","Matrix value id must be a non-empty string.",`${l}.id`)),g(d.field,`${l}.field`,t,{required:!0}),A(d.aggregate,`${l}.aggregate`,t),Qi(d.format,`${l}.format`,t),d.label!==void 0&&typeof d.label!="string"&&t.push(o("invalid_matrix_value_label","Matrix value label must be a string.",`${l}.label`)),d.totalBehavior!==void 0&&Fn(d.totalBehavior,`${l}.totalBehavior`,t)}),n}function Nn(e,i,t){if(!m(e)){t.push(o("invalid_matrix_totals","Matrix totals must be a structured object.",i));return}for(const n of["rows","columns"]){const s=e[n];s!==void 0&&s!==!0&&s!==!1&&s!=="perLevel"&&t.push(o("invalid_matrix_totals","Matrix total axis setting must be a boolean or perLevel.",`${i}.${n}`))}if(e.grandTotal!==void 0&&typeof e.grandTotal!="boolean")if(!m(e.grandTotal))t.push(o("invalid_matrix_totals","Matrix grandTotal must be a boolean or structured object.",`${i}.grandTotal`));else for(const n of["rows","columns"]){const s=e.grandTotal[n];s!==void 0&&typeof s!="boolean"&&t.push(o("invalid_matrix_totals","Matrix grandTotal rows/columns must be booleans.",`${i}.grandTotal.${n}`))}e.rowPosition!==void 0&&e.rowPosition!=="top"&&e.rowPosition!=="bottom"&&t.push(o("invalid_matrix_totals","Matrix row total position must be top or bottom.",`${i}.rowPosition`)),e.columnPosition!==void 0&&e.columnPosition!=="left"&&e.columnPosition!=="right"&&t.push(o("invalid_matrix_totals","Matrix column total position must be left or right.",`${i}.columnPosition`))}function ze(e,i,t,n){if(!Array.isArray(e)){n.push(o("invalid_matrix_path","Matrix member path must be an array of path segments.",i));return}e.forEach((s,r)=>{const l=`${i}.${r}`;if(!m(s)){n.push(o("invalid_matrix_path","Matrix path segment must be a structured object.",l));return}const d=s;if(!f(d.levelId)){n.push(o("stable_id_required","Matrix path segments must reference an explicit public axis level id.",`${l}.levelId`));return}Object.prototype.hasOwnProperty.call(s,"value")||n.push(o("invalid_matrix_path","Matrix path segments must include a value property; use explicit null for null members.",`${l}.value`)),t.has(d.levelId)||n.push(o("stable_id_required","Matrix path segment levelId must match an explicit public axis level id.",`${l}.levelId`))})}function ti(e,i,t,n){if(!m(e)){n.push(o("invalid_matrix_expansion","Matrix expansion axis options must be structured objects.",i));return}e.defaultDepth!==void 0&&(typeof e.defaultDepth!="number"||!Number.isInteger(e.defaultDepth)||e.defaultDepth<0)&&n.push(o("invalid_matrix_expansion","Matrix expansion defaultDepth must be a non-negative integer.",`${i}.defaultDepth`)),e.lazy!==void 0&&typeof e.lazy!="boolean"&&n.push(o("invalid_matrix_expansion","Matrix expansion lazy must be a boolean.",`${i}.lazy`)),e.expandedPaths!==void 0&&(Array.isArray(e.expandedPaths)?e.expandedPaths.forEach((s,r)=>{ze(s,`${i}.expandedPaths.${r}`,t,n)}):n.push(o("invalid_matrix_expansion","Matrix expandedPaths must be an array of member paths.",`${i}.expandedPaths`)))}function qn(e,i,t,n){if(e!==void 0){if(!m(e)){n.push(o("invalid_matrix_expansion","Matrix expansion must be a structured object.","expansion"));return}e.rows!==void 0&&ti(e.rows,"expansion.rows",i,n),e.columns!==void 0&&ti(e.columns,"expansion.columns",t,n)}}function On(e,i,t,n,s){if(e!==void 0){if(!Array.isArray(e)){s.push(o("invalid_matrix_sort","Matrix sort must be an array of sort rules.","sort"));return}e.forEach((r,l)=>{const d=`sort.${l}`;if(!m(r)){s.push(o("invalid_matrix_sort","Matrix sort rule must be a structured object.",d));return}const u=r;u.axis!=="row"&&u.axis!=="column"&&s.push(o("invalid_matrix_sort","Matrix sort axis must be row or column.",`${d}.axis`));const p=u.axis==="column"?t:i;if(u.targetId!==void 0&&!p.has(u.targetId)&&s.push(o("stable_id_required","Matrix sort targetId must reference an explicit public axis level id.",`${d}.targetId`)),Zi(u.direction,`${d}.direction`,s,"invalid_matrix_sort_direction"),Xi(u.nulls,`${d}.nulls`,s,"invalid_matrix_sort_nulls"),Wi(u.scope,`${d}.scope`,s,"invalid_matrix_sort_scope"),!m(u.by)){s.push(o("invalid_matrix_sort_by","Matrix sort by must be a structured object.",`${d}.by`));return}if(u.by.kind!=="member"){if(u.by.kind==="field"){g(u.by.field,`${d}.by.field`,s,{required:!0}),A(u.by.aggregate,`${d}.by.aggregate`,s);return}if(u.by.kind==="value"){(!f(u.by.valueId)||!n.has(u.by.valueId))&&s.push(o("stable_id_required","Matrix value sort must reference an explicit public value id.",`${d}.by.valueId`)),u.by.rowPath!==void 0&&ze(u.by.rowPath,`${d}.by.rowPath`,i,s),u.by.columnPath!==void 0&&ze(u.by.columnPath,`${d}.by.columnPath`,t,s);return}s.push(o("invalid_matrix_sort_by","Matrix sort by must be label, field, or value.",`${d}.by.kind`))}})}}function Pn(e,i){if(e!==void 0){if(!m(e)){i.push(o("invalid_matrix_layout","Matrix layout must be a structured object.","layout"));return}e.hierarchy!==void 0&&e.hierarchy!=="compact"&&e.hierarchy!=="tabular"&&e.hierarchy!=="outline"&&i.push(o("invalid_matrix_layout","Matrix hierarchy layout must be compact, tabular, or outline.","layout.hierarchy")),e.valuesPlacement!==void 0&&e.valuesPlacement!=="columns"&&e.valuesPlacement!=="rows"&&i.push(o("invalid_matrix_layout","Matrix valuesPlacement must be columns or rows.","layout.valuesPlacement")),e.stickyRowHeaders!==void 0&&typeof e.stickyRowHeaders!="boolean"&&i.push(o("invalid_matrix_layout","Matrix stickyRowHeaders must be a boolean.","layout.stickyRowHeaders")),e.stickyColumnHeaders!==void 0&&typeof e.stickyColumnHeaders!="boolean"&&i.push(o("invalid_matrix_layout","Matrix stickyColumnHeaders must be a boolean.","layout.stickyColumnHeaders"))}}function ai(e,i,t){if(!m(e)){t.push(o("invalid_matrix_display_limits","Matrix display limit must be a structured object.",i));return}(typeof e.limit!="number"||!Number.isInteger(e.limit)||e.limit<1)&&t.push(o("invalid_matrix_display_limits","Matrix display limit must be a positive integer.",`${i}.limit`));for(const n of Object.keys(e))n!=="limit"&&t.push(o("invalid_matrix_display_limits",`Matrix display limit ${n} is not supported in v1; use count-only { limit } display limits.`,`${i}.${n}`))}function Bn(e,i){if(e!==void 0){if(!m(e)){i.push(o("invalid_matrix_display_limits","Matrix displayLimits must be a structured object.","displayLimits"));return}e.rows!==void 0&&ai(e.rows,"displayLimits.rows",i),e.columns!==void 0&&ai(e.columns,"displayLimits.columns",i);for(const t of Object.keys(e))t==="rows"||t==="columns"||i.push(o("invalid_matrix_display_limits",`Matrix displayLimits ${t} is not supported in v1; use rows and columns count limits only.`,`displayLimits.${t}`))}}function Kn(e,i){var u;((u=e.source)==null?void 0:u.kind)==="sql"&&i.push(o("unsupported_matrix_sql_source","Matrix analytics intent does not support raw SQL sources.","source.kind"));const t=ii(e.rows,"rows",i,{required:!0}),n=ii(e.columns,"columns",i,{required:!1}),s=jn(e.values,"values",i);te(e.filters,"filters",i),e.totals!==void 0&&Nn(e.totals,"totals",i),ye(t.map(p=>p.id),"rows","row axis level",i),ye(n.map(p=>p.id),"columns","column axis level",i),ye(s.map(p=>p.id),"values","value",i);const r=new Set(t.map(p=>p.id).filter(p=>f(p))),l=new Set(n.map(p=>p.id).filter(p=>f(p))),d=new Set(s.map(p=>p.id).filter(p=>f(p)));On(e.sort,r,l,d,i),qn(e.expansion,r,l,i),Pn(e.layout,i),Bn(e.displayLimits,i)}function Vn(e,i){if(e.analysis===void 0)return;if(!m(e.analysis)){i.push(o("invalid_measure_analysis","Metric analysis must be a structured object.","analysis"));return}if(e.analysis.kind!=="period_change"){i.push(o("invalid_measure_analysis","Metric analysis kind is not supported.","analysis.kind"));return}e.dateField||i.push(o("missing_analysis_date_field","Period-change analysis needs a dateField.","dateField")),e.timeGrain||i.push(o("missing_analysis_time_grain","Period-change analysis needs a timeGrain.","timeGrain")),e.analysis.orderBy!==void 0&&e.analysis.orderBy!=="absolute_change"&&e.analysis.orderBy!=="positive_change"&&e.analysis.orderBy!=="negative_change"&&e.analysis.orderBy!=="period"&&i.push(o("invalid_measure_analysis","Period-change analysis orderBy must be absolute_change, positive_change, negative_change, or period.","analysis.orderBy"));const{timeWindow:t}=e.analysis;t!==void 0&&Se(t,"analysis.timeWindow",i)}function Se(e,i,t){if(!m(e)){t.push(o("invalid_time_window","Time window must be a structured object.",i));return}if(e.kind!==void 0&&e.kind!=="relative"&&e.kind!=="absolute"&&t.push(o("invalid_time_window","Time window kind must be relative or absolute.",`${i}.kind`)),e.kind==="absolute"){if(f(e.start)||t.push(o("invalid_time_window","Absolute time window start must be a non-empty ISO date or timestamp string.",`${i}.start`)),f(e.end)||t.push(o("invalid_time_window","Absolute time window end must be a non-empty ISO date or timestamp string.",`${i}.end`)),f(e.start)&&f(e.end)){const n=ie(e.start),s=ie(e.end);n||t.push(o("invalid_time_window","Absolute time window start must be a valid ISO date or timestamp.",`${i}.start`)),s||t.push(o("invalid_time_window","Absolute time window end must be a valid ISO date or timestamp.",`${i}.end`)),n&&s&&n.getTime()>s.getTime()&&t.push(o("invalid_time_window","Absolute time window start must be before or equal to end.",i))}return}(typeof e.unit!="string"||!kn.has(e.unit))&&t.push(o("invalid_time_window",`Time window unit must be one of: ${E.join(", ")}.`,`${i}.unit`)),(typeof e.value!="number"||!Number.isFinite(e.value)||e.value<=0)&&t.push(o("invalid_time_window","Time window value must be a positive number.",`${i}.value`)),e.anchor!==void 0&&e.anchor!=="now"&&e.anchor!=="latest_available"&&t.push(o("invalid_time_window","Time window anchor must be now or latest_available.",`${i}.anchor`)),e.completeness!==void 0&&e.completeness!=="include_partial"&&e.completeness!=="complete_periods"&&t.push(o("invalid_time_window","Time window completeness must be include_partial or complete_periods.",`${i}.completeness`))}function te(e,i,t){if(e!==void 0){if(!Array.isArray(e)){t.push(o("invalid_analytics_filters","Analytics filters must be an array.",i));return}e.forEach((n,s)=>{var u;const r=`${i}.${s}`;if(!m(n)){t.push(o("invalid_analytics_filter","Analytics filter must be a structured object.",r));return}const l=n;g(l.field,`${r}.field`,t,{required:!0}),l.scope!==void 0&&l.scope!=="row"&&l.scope!=="aggregate"&&t.push(o("invalid_analytics_filter_scope","Analytics filter scope must be row or aggregate.",`${r}.scope`)),l.scope==="aggregate"&&((u=l.field)==null?void 0:u.role)!==void 0&&l.field.role!=="measure"&&t.push(o("invalid_analytics_filter_scope","Aggregate-scope analytics filters must target a measure field.",`${r}.scope`));const d=l.operator==="is_null"||l.operator==="is_not_null";if(l.operator!==void 0&&l.operator!=="="&&l.operator!=="!="&&l.operator!=="in"&&l.operator!=="not_in"&&l.operator!=="contains"&&l.operator!=="not_contains"&&l.operator!=="between"&&l.operator!=="not_between"&&l.operator!==">"&&l.operator!==">="&&l.operator!=="<"&&l.operator!=="<="&&l.operator!=="is_null"&&l.operator!=="is_not_null"&&t.push(o("invalid_analytics_filter_operator","Analytics filter operator is not supported.",`${r}.operator`)),l.values===void 0&&!d&&t.push(o("missing_analytics_filter_value","Analytics filter needs values unless it is a null check.",r)),d&&l.values!==void 0){t.push(o("invalid_analytics_filter_values","Null-check analytics filters must not include values.",`${r}.values`));return}if(l.values!==void 0&&!Array.isArray(l.values)){t.push(o("invalid_analytics_filter_values","Analytics filter values must be an array when provided.",`${r}.values`));return}if(l.values!==void 0){const p=l.values.length;if(l.operator==="between"||l.operator==="not_between"){p!==2&&t.push(o("invalid_analytics_filter_values","Between analytics filters must include exactly two values.",`${r}.values`));return}(l.operator==="contains"||l.operator==="not_contains"||l.operator==="="||l.operator==="!="||l.operator===">"||l.operator===">="||l.operator==="<"||l.operator==="<="||l.operator===void 0)&&p!==1&&t.push(o("invalid_analytics_filter_values","Scalar analytics filters must include exactly one value. Use in/not_in for multiple values.",`${r}.values`))}})}}function Ji(e){const i=[];if(!m(e))return i.push(o("invalid_derived_field","Derived field definition must be a structured object.")),{ok:!1,errors:i,warnings:[]};if(e.kind!=="derived_field"&&i.push(o("invalid_derived_field_kind","Derived field kind must be derived_field.","kind")),f(e.name)||i.push(o("invalid_derived_field_name","Derived field needs a name.","name")),f(e.label)||i.push(o("invalid_derived_field_label","Derived field needs a label.","label")),Sn.has(e.resultRole)||i.push(o("invalid_derived_field_role","Derived field resultRole must be measure, dimension, date, id, or unknown.","resultRole")),Ui.has(e.dataType)||i.push(o("invalid_derived_field_data_type","Derived field dataType must be string, number, boolean, date, datetime, or unknown.","dataType")),$n.has(e.computeStage)||i.push(o("invalid_derived_field_compute_stage","Derived field computeStage must be row or aggregate.","computeStage")),e.computeStage==="aggregate"&&e.resultRole!=="measure"&&i.push(o("invalid_derived_field_compute_stage","Aggregate-stage derived fields must have resultRole measure.","computeStage")),e.resultRole!=="measure"&&e.defaultAggregate!==void 0&&i.push(o("invalid_derived_field_aggregate","Only measure derived fields may declare defaultAggregate.","defaultAggregate")),e.computeStage==="row"&&e.resultRole==="measure"&&e.defaultAggregate===void 0&&i.push(o("missing_derived_field_default_aggregate","Row-stage measure derived fields must declare defaultAggregate so row results have explicit rollup semantics.","defaultAggregate")),A(e.defaultAggregate,"defaultAggregate",i),e.aggregationBehavior!==void 0&&!xn.has(e.aggregationBehavior)&&i.push(o("invalid_derived_field_aggregation_behavior","Derived field aggregationBehavior is not supported.","aggregationBehavior")),e.aggregationStrategy!==void 0&&!Rn.has(e.aggregationStrategy)&&i.push(o("invalid_derived_field_aggregation_strategy","Derived field aggregationStrategy is not supported.","aggregationStrategy")),f(e.expression)||i.push(o("invalid_derived_field_expression","Derived field needs a named-token expression.","expression")),e.expressionLanguage!==void 0&&e.expressionLanguage!=="semaphor_sql_template"&&i.push(o("invalid_derived_field_expression_language","Derived field expressionLanguage must be semaphor_sql_template.","expressionLanguage")),!m(e.inputs)||Object.keys(e.inputs).length===0?i.push(o("invalid_derived_field_inputs","Derived field needs at least one typed input.","inputs")):Object.entries(e.inputs).forEach(([n,s])=>{if(!f(n)){i.push(o("invalid_derived_field_input_name","Derived field input names must be non-empty strings.","inputs"));return}Mn(s,`inputs.${n}`,i)}),f(e.expression)&&m(e.inputs)){const n=gn(e.expression),s=new Set(n),r=Object.keys(e.inputs).filter(l=>f(l));n.forEach(l=>{Object.prototype.hasOwnProperty.call(e.inputs,l)||i.push(o("invalid_derived_field_expression_token",`Derived field expression token "{${l}}" needs a matching inputs.${l} entry.`,"expression"))}),r.forEach(l=>{s.has(l)||i.push(o("unused_derived_field_input",`Derived field input "${l}" is not referenced by expression.`,`inputs.${l}`))})}const t=e.format;return m(t)&&t.type==="temporal_bucket"?i.push(o("invalid_derived_field_format","Derived field computation metadata cannot own temporal bucket presentation; declare grain and format on the grouped field.","format")):Yi(t,"format",i),e.tags!==void 0&&(!Array.isArray(e.tags)||e.tags.some(n=>!f(n)))&&i.push(o("invalid_derived_field_tags","Derived field tags must be non-empty strings.","tags")),{ok:i.length===0,errors:i,warnings:[]}}function Ln(e){const i=[];if(!m(e))return i.push(o("invalid_result_calculation","Result calculation must be a structured object.")),{ok:!1,errors:i,warnings:[]};if(f(e.id)||i.push(o("invalid_result_calculation_id","Result calculation needs an id.","id")),f(e.label)||i.push(o("invalid_result_calculation_label","Result calculation needs a label.","label")),e.kind!=="percent_of_total"&&e.kind!=="rank"&&e.kind!=="running_total"&&e.kind!=="previous_row_delta"&&i.push(o("invalid_result_calculation_kind","Result calculation kind must be percent_of_total, rank, running_total, or previous_row_delta.","kind")),ei(e.input,"input",i),Tn(e.output,"output",i),e.kind==="percent_of_total"){const t=e.denominator;t!==void 0&&(m(t)?t.scope==="population"?(g(t.metric,"denominator.metric",i,{required:!0}),te(t.filters,"denominator.filters",i)):t.scope!=="returned_result"&&i.push(o("invalid_result_calculation_denominator","Percent-of-total denominator scope must be returned_result or population.","denominator.scope")):i.push(o("invalid_result_calculation_denominator","Percent-of-total denominator must be a structured object.","denominator")))}return e.kind==="rank"&&e.order!==void 0&&e.order!=="asc"&&e.order!=="desc"&&i.push(o("invalid_result_calculation_order","Rank result calculation order must be asc or desc.","order")),(e.kind==="running_total"||e.kind==="previous_row_delta")&&e.orderBy!==void 0&&ei(e.orderBy,"orderBy",i),{ok:i.length===0,errors:i,warnings:[]}}function Pe(e){var n;const i=[],t=[];if(!e||typeof e!="object")return{ok:!1,errors:[o("invalid_analytics_intent","Analytics intent must be a structured object.")],warnings:t,repairHints:[{code:"invalid_analytics_intent",recommendedNextStep:"Send one structured analytics intent object with kind, source, and required fields."}]};if(e.version!==void 0&&e.version!==1&&i.push(o("invalid_version","Analytics intent version must be 1.","version")),qe(e.source,"source",i),Hn(e,i),vn(e,i),"relationshipHint"in e&&e.relationshipHint!==void 0&&Oe(e.relationshipHint,"relationshipHint",i),e.kind==="metric"){const s=Array.isArray(e.measures)?e.measures.filter(r=>m(r)&&f(r.name)):[];if(!Array.isArray(e.measures)||e.measures.length===0?i.push(o("missing_measure","Metric intent needs at least one measure.","measures")):e.measures.some(r=>!m(r)||!f(r.name))&&i.push(o("invalid_measure_list","Metric intent measures must be an array of field references with names.","measures")),s.forEach((r,l)=>{g(r,`measures.${l}`,i,{required:!0})}),s.length>0&&!nn(s)){const r=s.find((l,d)=>s.some((u,p)=>p!==d&&Hi(u,l)));r&&i.push(o("duplicate_measure",sn(r),"measures"))}if(m(e.primaryMeasure)&&f(e.primaryMeasure.name)&&Ne(e.primaryMeasure,s).length>1&&i.push(o("ambiguous_primary_measure","Metric intent primaryMeasure must identify exactly one selected measure.","primaryMeasure")),e.primaryMeasure!==void 0&&(g(e.primaryMeasure,"primaryMeasure",i,{required:!0}),m(e.primaryMeasure)&&f(e.primaryMeasure.name)&&s.length>0&&!rn(e.primaryMeasure,s)&&i.push(o("invalid_primary_measure","Metric intent primaryMeasure must match one measure field reference.","primaryMeasure"))),e.dimensions!==void 0&&!Array.isArray(e.dimensions)?i.push(o("invalid_measure_dimensions","Metric intent dimensions must be an array of field references.","dimensions")):Array.isArray(e.dimensions)&&e.dimensions.some(r=>!m(r)||!f(r.name))&&i.push(o("invalid_measure_dimensions","Metric intent dimensions must be an array of field references with names.","dimensions")),e.dateField!==void 0&&g(e.dateField,"dateField",i),e.timeWindow!==void 0&&(Se(e.timeWindow,"timeWindow",i),e.dateField||i.push(o("missing_time_window_date_field","Metric timeWindow needs a dateField.","dateField"))),te(e.filters,"filters",i),Array.isArray(e.dimensions)&&e.dimensions.forEach((r,l)=>{g(r,`dimensions.${l}`,i)}),e.orderBy!==void 0){if(!m(e.orderBy))i.push(o("invalid_measure_order_by","Metric intent orderBy must be a structured object.","orderBy"));else if(g(e.orderBy.field,"orderBy.field",i,{required:!0}),e.orderBy.direction!=="asc"&&e.orderBy.direction!=="desc"&&i.push(o("invalid_measure_order_direction","Metric intent orderBy direction must be asc or desc.","orderBy.direction")),m(e.orderBy.field)&&f(e.orderBy.field.name)){const r=[...s,...e.timeGrain&&e.dateField&&m(e.dateField)?[e.dateField]:[],...Array.isArray(e.dimensions)?e.dimensions.filter(l=>m(l)&&f(l.name)):[]];r.length>0&&!ln(e.orderBy.field,r)&&i.push(o("invalid_measure_order_by","Metric intent orderBy.field must match one selected measure, grouped dateField, or dimension.","orderBy.field"))}}Vn(e,i)}else if(e.kind==="records"){if(!Array.isArray(e.fields)||e.fields.length===0?i.push(o("missing_record_fields","Records intent needs at least one field.","fields")):e.fields.some(s=>!m(s)||!f(s.name))&&i.push(o("invalid_record_fields","Records intent fields must be field references with names.","fields")),Array.isArray(e.fields)&&e.fields.forEach((s,r)=>{g(s,`fields.${r}`,i)}),e.dateField!==void 0&&g(e.dateField,"dateField",i),We(e.pagination,"pagination",i),e.timeWindow!==void 0&&(Se(e.timeWindow,"timeWindow",i),e.dateField||i.push(o("missing_time_window_date_field","Records timeWindow needs a dateField.","dateField"))),te(e.filters,"filters",i),Array.isArray(e.filters)&&e.filters.forEach((s,r)=>{m(s)&&s.scope==="aggregate"&&i.push(o("unsupported_record_filter_scope","Records intents support row-scope filters only. Use a metric intent for aggregate-scope filters.",`filters.${r}.scope`))}),e.orderBy!==void 0&&(m(e.orderBy)?(g(e.orderBy.field,"orderBy.field",i,{required:!0}),e.orderBy.direction!=="asc"&&e.orderBy.direction!=="desc"&&i.push(o("invalid_record_order_direction","Records intent orderBy direction must be asc or desc.","orderBy.direction"))):i.push(o("invalid_record_order_by","Records intent orderBy must be a structured object.","orderBy"))),e.totals!==void 0)if(!m(e.totals))i.push(o("invalid_records_totals","Records totals must be a structured server totals request.","totals"));else{e.totals.mode!=="server"&&i.push(o("invalid_records_totals","Records totals mode must be server.","totals.mode"));const s=e.totals.measures;!Array.isArray(s)||s.length===0?i.push(o("missing_records_totals_measures","Records server totals need at least one measure.","totals.measures")):s.forEach((r,l)=>{g(r,`totals.measures.${l}`,i,{required:!0}),(!m(r)||r.role!=="measure")&&i.push(o("invalid_records_totals_measure","Records server totals measures must be measure field references.",`totals.measures.${l}.role`))})}}else e.kind==="inputOptions"?_n(e,i):e.kind==="matrix"?Kn(e,i):e.kind==="sql"?(((n=e.source)==null?void 0:n.kind)!=="sql"&&i.push(o("invalid_sql_source","SQL analytics intent must use a SQL execution source.","source")),f(e.sql)||i.push(o("missing_sql","SQL analytics intent needs SQL text.","sql")),on(e.defaultParameters,"defaultParameters",i),Array.isArray(e.fields)&&e.fields.forEach((s,r)=>{g(s,`fields.${r}`,i)}),We(e.pagination,"pagination",i)):i.push(o("invalid_analytics_kind","Analytics kind is not supported.","kind"));return{ok:i.length===0,errors:i,warnings:t,repairHints:Un(i)}}function Hn(e,i){if(!(!("derivedFields"in e)||e.derivedFields===void 0)){if(!Array.isArray(e.derivedFields)){i.push(o("invalid_derived_fields","Analytics intent derivedFields must be an array of derived field definitions.","derivedFields"));return}e.derivedFields.forEach((t,n)=>{Ji(t).errors.forEach(r=>{i.push({...r,path:r.path?`derivedFields.${n}.${r.path}`:`derivedFields.${n}`})})})}}function et(e){const i=[],t=[];if(!e||typeof e!="object")return{ok:!1,errors:[o("invalid_operation_intent","Operation intent must be a structured object.")],warnings:t,repairHints:[{code:"invalid_operation_intent",recommendedNextStep:"Send one typed operation intent with version, kind, and required operation fields."}]};if(e.version!==1&&i.push(o("invalid_version","Operation intent version must be 1.","version")),e.kind==="answer_obligations")!Array.isArray(e.obligations)||e.obligations.length===0?i.push(o("missing_obligations","Answer-obligations operation intent needs at least one obligation.","obligations")):e.obligations.forEach((n,s)=>{f(n.id)||i.push(o("missing_obligation_id","Each analytics obligation needs an id.",`obligations.${s}.id`)),f(n.prompt)||i.push(o("missing_obligation_prompt","Each analytics obligation needs a prompt.",`obligations.${s}.prompt`))});else if(e.kind==="dashboard_change"||e.kind==="data_app_change"){if(f(e.instruction)||i.push(o("missing_instruction","Change operation intent needs an instruction.","instruction")),e.analyticsIntent){const n=Pe(e.analyticsIntent);i.push(...n.errors),t.push(...n.warnings)}}else i.push(o("invalid_operation_kind","Operation intent kind is not supported.","kind"));return{ok:i.length===0,errors:i,warnings:t,repairHints:it(i)}}function Gn(e){const i=[],t=[];if(!e||typeof e!="object")return{ok:!1,errors:[o("invalid_recovery_plan","Analytics recovery plan must be a structured object.")],warnings:t,repairHints:[{code:"invalid_recovery_plan",recommendedNextStep:"Return a typed recovery plan with operationIntent and plannedToolCalls."}]};e.version!==1&&i.push(o("invalid_version","Recovery plan version must be 1.","version")),e.kind!=="analytics_recovery_plan"&&i.push(o("invalid_recovery_plan_kind","Recovery plan kind must be analytics_recovery_plan.","kind"));const n=et(e.operationIntent);return i.push(...n.errors),t.push(...n.warnings),Array.isArray(e.plannedToolCalls)||i.push(o("invalid_planned_tool_calls","Recovery plan plannedToolCalls must be an array.","plannedToolCalls")),{ok:i.length===0,errors:i,warnings:t,repairHints:it(i)}}function it(e){return e.map(i=>({code:i.code,recommendedNextStep:i.code==="missing_obligations"?"Normalize the user request into one or more typed analytics obligations before recovery planning.":"Correct the operation/recovery contract shape before planning execution."}))}function Un(e){return e.map(i=>{switch(i.code){case"missing_source":return{code:i.code,fieldRole:"source",recommendedNextStep:"Provide a semantic, physical, or SQL source before executing analytics."};case"missing_measure":return{code:i.code,fieldRole:"measure",recommendedNextStep:"Choose one exact measure from the grounded schema candidates."};case"missing_record_fields":return{code:i.code,fieldRole:"dimension",recommendedNextStep:"Provide at least one field for the records intent."};case"missing_matrix_rows":return{code:i.code,fieldRole:"dimension",recommendedNextStep:"Choose at least one row axis level for the matrix table."};case"missing_matrix_values":return{code:i.code,fieldRole:"measure",recommendedNextStep:"Choose at least one value field for the matrix table."};case"unsupported_matrix_sql_source":return{code:i.code,fieldRole:"source",recommendedNextStep:"Use a semantic or explorer-backed source for matrix tables; raw SQL matrix tables are not supported."};case"missing_input_options_input_id":return{code:i.code,fieldRole:"input",recommendedNextStep:"Provide the inputId that these option values populate."};case"missing_input_options_label_field":return{code:i.code,fieldRole:"dimension",recommendedNextStep:"Provide the human-readable field used as option labels."};case"missing_input_options_value_field":return{code:i.code,fieldRole:"dimension",recommendedNextStep:"Provide the stable field used as option values."};case"missing_sql":return{code:i.code,fieldRole:"sql",recommendedNextStep:"Provide bounded read-only SQL with an explicit outer LIMIT."};case"conflicting_sql":return{code:i.code,fieldRole:"sql",recommendedNextStep:"Use one canonical SQL text location for the intent; prefer top-level sql."};case"missing_semantic_domain":case"missing_dataset_name":case"missing_connection_id":case"missing_table_name":return{code:i.code,fieldRole:"source",recommendedNextStep:"Use grounded catalog metadata to fill the missing source reference."};default:return}}).filter(i=>!!i)}function Yn(e,i,t,n){if(!e||typeof e!="object"){t.push(o("invalid_view","Dashboard view must be an object.",i));return}if(f(e.title)||t.push(o("missing_view_title","Dashboard view needs a title.",i)),!e.presentation||typeof e.presentation!="object"){t.push(o("missing_presentation","Dashboard view needs a presentation.",`${i}.presentation`));return}if(e.presentation.kind==="text"){f(e.text)||n.push(o("missing_text_content","Text views should include text content.",`${i}.text`));return}if(!e.analytics){t.push(o("missing_view_analytics","Non-text dashboard views need analytics intent.",`${i}.analytics`));return}e.presentation.kind==="matrixTable"&&e.analytics.kind!=="matrix"&&t.push(o("invalid_matrix_view_analytics","Matrix table views need matrix analytics intent.",`${i}.analytics.kind`));const s=Pe(e.analytics);for(const r of s.errors)t.push(o(r.code,r.message,`${i}.analytics${r.path?`.${r.path}`:""}`));for(const r of s.warnings)n.push(o(r.code,r.message,`${i}.analytics${r.path?`.${r.path}`:""}`))}function Qn(e){const i=[],t=[];if(!e||typeof e!="object")return{ok:!1,errors:[o("invalid_dashboard_intent","Dashboard intent must be a structured object.")],warnings:t};e.version!==1&&i.push(o("invalid_version","Dashboard intent version must be 1.")),e.kind!=="dashboard"&&i.push(o("invalid_kind","Experience intent kind must be dashboard.")),f(e.title)||i.push(o("missing_title","Dashboard intent needs a title.","title"));const n=Array.isArray(e.inputs)?e.inputs:[],s=ve(n.filter(m).map(u=>u.id).filter(u=>typeof u=="string"));s&&i.push(o("duplicate_input_id",`Duplicate input id: ${s}.`,"inputs"));for(const[u,p]of n.entries()){const y=`inputs.${u}`;if(!m(p)){i.push(o("invalid_input","Dashboard input must be an object.",y));continue}f(p.id)||i.push(o("missing_input_id","Input needs an id.",`${y}.id`)),f(p.label)||i.push(o("missing_input_label","Input needs a label.",`${y}.label`)),!p.field||!f(p.field.name)?i.push(o("missing_input_field","Input needs a field.",`${y}.field`)):g(p.field,`${y}.field`,i)}const r=Array.isArray(e.sections)?e.sections:[];r.length===0&&i.push(o("missing_sections","Dashboard intent needs at least one section.","sections"));const l=r.flatMap(u=>u&&typeof u=="object"&&Array.isArray(u.views)?u.views.filter(m).map(p=>p.id).filter(p=>!!p):[]),d=ve(l);d&&i.push(o("duplicate_view_id",`Duplicate dashboard view id: ${d}.`,"sections"));for(const[u,p]of r.entries()){const y=`sections.${u}`;if(!p||typeof p!="object"){i.push(o("invalid_section","Dashboard section must be an object.",y));continue}if(f(p.title)||i.push(o("missing_section_title","Dashboard section needs a title.",y)),!Array.isArray(p.views)||p.views.length===0){i.push(o("missing_section_views","Dashboard section needs at least one view.",`${y}.views`));continue}for(const[x,v]of p.views.entries())Yn(v,`${y}.views.${x}`,i,t)}return{ok:i.length===0,errors:i,warnings:t}}exports.RAW_TEMPORAL_CONTRACT_ERROR_CODES=tt;exports.SEMAPHOR_ANALYZE_RESULT_FIELD_CONTRACT=di;exports.SEMAPHOR_DATA_APP_CODEGEN_SUMMARY_SCHEMA_VERSION=Z;exports.SEMAPHOR_DATA_APP_CODEGEN_SUMMARY_VALIDATOR_VERSION=ct;exports.SEMAPHOR_GENERATED_COUNT_METRIC_ID=nt;exports.SEMAPHOR_MATRIX_TIME_GRAINS=ae;exports.SEMAPHOR_TIME_GRAINS=E;exports.TEMPORAL_BUCKET_CONTRACT_ERROR_CODES=at;exports.TEMPORAL_BUCKET_PATTERN_TOKENS=Bi;exports.TEMPORAL_BUCKET_PRESETS=oi;exports.buildAnalyticsCatalogFieldSummary=Qa;exports.canonicalDashboardRecordsPayloadSchema=ya;exports.canonicalizeSemaphorSourceIdentity=$e;exports.dashboardRecordsPayloadSchema=ha;exports.getAnalyticsCatalogFieldCandidates=qi;exports.getAnalyticsCatalogFieldName=Ni;exports.getSemaphorDatasetEntityId=ot;exports.getSemaphorNonRedundantDatasetId=k;exports.hasCompleteSemaphorSourceIdentity=rt;exports.isAnalyticsCatalogDateField=De;exports.isAnalyticsCatalogDimensionField=Ya;exports.isAnalyticsCatalogMetricField=je;exports.isAnalyticsDateLikeDataType=Oi;exports.isAnalyticsMetricIdentifierField=_e;exports.isAnalyticsTechnicalIdentifierField=Fe;exports.isSemaphorDataAppCodegenSummary=St;exports.isSemaphorMatrixTimeGrain=si;exports.isSemaphorTimeGrain=ni;exports.isTemporalBucketPreset=Xa;exports.isValidIanaTimeZone=li;exports.mergeSemaphorSourcesByIdentity=lt;exports.normalizeAnalyticsCatalogDataType=ce;exports.normalizeAnalyticsCatalogName=ue;exports.parseSemaphorIsoInstant=mn;exports.parseSemaphorIsoTimeWindowBoundary=ie;exports.preferSemaphorFieldRefMetadata=ut;exports.preferSemaphorSourceMetadata=we;exports.rawTemporalValueMetadataSchema=zi;exports.resolveApplicableTemporalBucketFormat=an;exports.semaphorAnalyticsCoverageSchema=Ee;exports.semaphorAnalyticsDiagnosticFeedbackSchema=Me;exports.semaphorAnalyticsExecutionResultSchema=Ci;exports.semaphorAnalyticsPopulationSchema=Te;exports.semaphorAnalyticsResultSchema=Ti;exports.semaphorAnalyticsValidationIssueSchema=J;exports.semaphorAnalyticsValidationResultSchema=Re;exports.semaphorAnalyzeResultSchema=qa;exports.semaphorAnalyzeResultShape=Di;exports.semaphorDataAppCodegenSummarySchema=Va;exports.semaphorDerivedFieldDefinitionSchema=xe;exports.semaphorExecutionFieldRefSchema=de;exports.semaphorFieldRefSchema=I;exports.semaphorFieldRefsMatch=ui;exports.semaphorInputOptionsResultSchema=xi;exports.semaphorMatrixResultSchema=Mi;exports.semaphorMetricAggregate=se;exports.semaphorMetricMeasureBindingKey=ci;exports.semaphorMetricResultSchema=Ii;exports.semaphorPhysicalSourceRefSchema=$i;exports.semaphorRecordsResultSchema=Ai;exports.semaphorRelationshipDiagnosticsSchema=Ei;exports.semaphorResultColumnSchema=M;exports.semaphorSemanticSourceRefSchema=Ae;exports.semaphorSourceIdentityKey=Q;exports.semaphorSourceRefSchema=R;exports.semaphorSourcesReferToSameDataset=ne;exports.semaphorSqlResultSchema=Ri;exports.semaphorSqlSourceRefSchema=wi;exports.semaphorTimeGrainSchema=_i;exports.temporalBucketDataTypeForGrain=ri;exports.temporalBucketFormatSchema=X;exports.temporalBucketMetadataSchema=W;exports.tokenizeTemporalBucketPattern=Vi;exports.validateSemaphorAnalyticsIntent=Pe;exports.validateSemaphorAnalyticsRecoveryPlan=Gn;exports.validateSemaphorDashboardIntent=Qn;exports.validateSemaphorDataAppCodegenSummary=ke;exports.validateSemaphorDerivedFieldDefinition=Ji;exports.validateSemaphorOperationIntent=et;exports.validateSemaphorResultCalculation=Ln;exports.validateTemporalBucketFormatApplicability=ee;