react-semaphor 0.1.427 → 0.1.429

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 (96) hide show
  1. package/dist/analytics-protocol/index.cjs +1 -1
  2. package/dist/analytics-protocol/index.js +72 -71
  3. package/dist/brand-studio/index.cjs +1 -1
  4. package/dist/brand-studio/index.js +5 -4
  5. package/dist/briefings/index.cjs +1 -1
  6. package/dist/briefings/index.js +1031 -622
  7. package/dist/chunks/analyze-result-contract-BswhsmWT.js +1 -0
  8. package/dist/chunks/{analyze-result-contract-DnfF8kBb.js → analyze-result-contract-CfOBEwaC.js} +681 -759
  9. package/dist/chunks/{code-editor-CojfM3qp.js → code-editor-C65eEYyU.js} +2980 -2960
  10. package/dist/chunks/code-editor-DOh3aYEh.js +138 -0
  11. package/dist/chunks/{comparison-document-migration-b6c3xiWh.js → comparison-document-migration-DbU_BTxR.js} +1 -1
  12. package/dist/chunks/{comparison-document-migration-BJH1idOd.js → comparison-document-migration-Dj6xZMCb.js} +2 -2
  13. package/dist/chunks/csv-utils-Co0WxHke.js +4 -0
  14. package/dist/chunks/csv-utils-suxSkJGj.js +376 -0
  15. package/dist/chunks/dashboard-CQfAvRYI.js +1401 -0
  16. package/dist/chunks/{dashboard-DSxho2LN.js → dashboard-agBXhvKo.js} +45651 -42951
  17. package/dist/chunks/{dashboard-briefing-launcher-CguxcHIl.js → dashboard-briefing-launcher-CkH_pthg.js} +1 -1
  18. package/dist/chunks/{dashboard-briefing-launcher-BFIw5BOf.js → dashboard-briefing-launcher-gBNNKqoH.js} +100 -99
  19. package/dist/chunks/{dashboard-controls-Cl0LagTr.js → dashboard-controls-CAZnIGfT.js} +2 -2
  20. package/dist/chunks/{dashboard-controls-jD-HpCNK.js → dashboard-controls-CoIxUTvH.js} +207 -202
  21. package/dist/chunks/{dashboard-json-BovTt0uu.js → dashboard-json-BMcPjL8-.js} +18 -17
  22. package/dist/chunks/dashboard-json-D4hFrMkX.js +1 -0
  23. package/dist/chunks/{edit-dashboard-visual-dlm8F_Qu.js → edit-dashboard-visual-Bc8qNfSr.js} +8721 -8481
  24. package/dist/chunks/edit-dashboard-visual-onhUUXlw.js +182 -0
  25. package/dist/chunks/{metric-comparison-CWweq9RG.js → metric-comparison-CPoDx56y.js} +1 -1
  26. package/dist/chunks/{metric-comparison-BKgkMy9r.js → metric-comparison-DVy3fll_.js} +1 -1
  27. package/dist/chunks/numeric-presentation-CGTcqocU.js +517 -0
  28. package/dist/chunks/numeric-presentation-Dlb-Dk4c.js +1 -0
  29. package/dist/chunks/report-preferences-dialog-CPptr_V9.js +690 -0
  30. package/dist/chunks/report-preferences-dialog-DV_5aHrS.js +1 -0
  31. package/dist/chunks/source-identity-5OPV4gvg.js +92 -0
  32. package/dist/chunks/source-identity-Cbo2LOHQ.js +1 -0
  33. package/dist/chunks/{update-policy-CY2k-pJP.js → update-policy-De2NswtM.js} +1 -1
  34. package/dist/chunks/{update-policy-BgONreNd.js → update-policy-DnF_74zC.js} +1 -1
  35. package/dist/chunks/{use-create-flow-overlay-state-kbl6avDY.js → use-create-flow-overlay-state-Bs6gqgjo.js} +1 -1
  36. package/dist/chunks/{use-create-flow-overlay-state-BU0ROMSm.js → use-create-flow-overlay-state-CgQbCrni.js} +97 -96
  37. package/dist/chunks/validators-B2vUAqTf.js +1 -0
  38. package/dist/chunks/{validators-Cz-XuORM.js → validators-Bce_J7Vd.js} +19 -13
  39. package/dist/dashboard/index.cjs +1 -1
  40. package/dist/dashboard/index.js +1 -1
  41. package/dist/dashboard-authoring/index.cjs +3 -3
  42. package/dist/dashboard-authoring/index.js +20 -19
  43. package/dist/data-app-builder/index.cjs +1 -1
  44. package/dist/data-app-builder/index.js +50 -50
  45. package/dist/data-app-codegen/index.cjs +1 -1
  46. package/dist/data-app-codegen/index.js +2 -2
  47. package/dist/data-app-codegen-node/index.cjs +1 -1
  48. package/dist/data-app-codegen-node/index.js +3 -3
  49. package/dist/data-app-sdk/index.cjs +2 -2
  50. package/dist/data-app-sdk/index.js +27 -26
  51. package/dist/data-app-sdk-adapters/index.cjs +1 -1
  52. package/dist/data-app-sdk-adapters/index.js +25 -24
  53. package/dist/data-app-sdk-validation/index.cjs +1 -1
  54. package/dist/data-app-sdk-validation/index.js +57 -55
  55. package/dist/format-utils/index.cjs +2 -5
  56. package/dist/format-utils/index.js +136 -161
  57. package/dist/index.cjs +1 -1
  58. package/dist/index.js +158 -155
  59. package/dist/report-runtime-context/index.cjs +1 -0
  60. package/dist/report-runtime-context/index.js +394 -0
  61. package/dist/style.css +1 -1
  62. package/dist/surfboard/index.cjs +1 -1
  63. package/dist/surfboard/index.js +7 -6
  64. package/dist/types/analytics-protocol.d.ts +0 -4
  65. package/dist/types/briefings.d.ts +216 -19
  66. package/dist/types/dashboard-assistant.d.ts +0 -2
  67. package/dist/types/dashboard-authoring.d.ts +34 -9
  68. package/dist/types/dashboard.d.ts +93 -9
  69. package/dist/types/data-app-builder.d.ts +0 -1
  70. package/dist/types/data-app-codegen-node.d.ts +6 -28
  71. package/dist/types/data-app-codegen.d.ts +6 -28
  72. package/dist/types/data-app-sdk-adapters.d.ts +6 -28
  73. package/dist/types/data-app-sdk-validation.d.ts +6 -29
  74. package/dist/types/data-app-sdk.d.ts +6 -31
  75. package/dist/types/format-utils.d.ts +128 -4
  76. package/dist/types/index.cjs +1 -1
  77. package/dist/types/index.js +10 -13
  78. package/dist/types/main.d.ts +249 -89
  79. package/dist/types/report-runtime-context.d.ts +99 -0
  80. package/dist/types/shared.d.ts +34 -9
  81. package/dist/types/surfboard.d.ts +119 -16
  82. package/dist/types/types.d.ts +156 -73
  83. package/dist/types/value-format-preferences.d.ts +126 -0
  84. package/dist/value-format-preferences/index.cjs +1 -0
  85. package/dist/value-format-preferences/index.js +635 -0
  86. package/package.json +11 -1
  87. package/dist/chunks/analyze-result-contract-ege_u6Nl.js +0 -1
  88. package/dist/chunks/calendar-preferences-dialog-DE4tk3t3.js +0 -457
  89. package/dist/chunks/calendar-preferences-dialog-DuGX1NPV.js +0 -1
  90. package/dist/chunks/code-editor-BoowcKU0.js +0 -138
  91. package/dist/chunks/dashboard-json-7mpQsizF.js +0 -1
  92. package/dist/chunks/dashboard-ogxedhSY.js +0 -1402
  93. package/dist/chunks/date-formatter-BTTYdAik.js +0 -1
  94. package/dist/chunks/date-formatter-D-89jTjG.js +0 -514
  95. package/dist/chunks/edit-dashboard-visual-B7wLrHeF.js +0 -182
  96. package/dist/chunks/validators-B4VMLX3_.js +0 -1
@@ -0,0 +1 @@
1
+ "use strict";const e=require("zod"),ne=require("./source-identity-Cbo2LOHQ.js"),E={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"},j="semaphor-data-app-codegen-summary/v1",qe="semaphor-data-app-codegen-summary-validator/v2",Ee=new Set(["metric","records","matrix","analysis","sql_fallback"]),xe=new Set(["semaphor.metric","semaphor.records","semaphor.matrix","semaphor.analysis","semaphor.sql"]),Fe=new Set(["SUM","COUNT","AVG","MIN","MAX","MEDIAN","DISTINCT"]),Ne=new Set(["absolute_delta","largest_negative","largest_positive","positive_and_negative","all"]),re=new Set(["source","id","label","measures","primaryMeasure","dateField","timeGrain","dimensions","comparison","orderBy","filters","relationshipHint","limit","derivedFields"]),Ke=new Set([...re,"analysis","timeWindow","filters","driverMode","includePopulation","calendarContext","chartTitle","chartType"]),Oe=new Set(["source","id","label","fields","dateField","timeGrain","timeWindow","filters","orderBy","relationshipHint","limit","pagination","totals","derivedFields"]),De=new Set(["source","id","label","filters","relationshipHint","rows","columns","values","totals","sort","expansion","layout","displayLimits"]),Me=new Set(["source","id","label","sql","defaultParameters","pythonCode","fields","limit","pagination","rationale"]),Te=new Set(["kpi","line_chart","bar_chart","stacked_bar_chart","pie_chart","donut_chart","area_chart","table","matrix","narrative","text_block","custom"]),Be=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 Pe(o){return L(o).ok}function L(o){const i=[];if(!o||typeof o!="object")return{ok:!1,issues:["Summary must be an object."]};const t=o;return t.schemaVersion!==j&&i.push(`schemaVersion must be ${j}.`),(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(...Le(t.implementationChecklist)),Array.isArray(t.sources)&&t.sources.forEach((s,n)=>{i.push(...w(s,`sources.${n}`))}),Array.isArray(t.inputs)&&t.inputs.forEach((s,n)=>{i.push(...Ge(s,`inputs.${n}`))}),Array.isArray(t.views)&&t.views.forEach((s,n)=>{i.push(...Ue(s,`views.${n}`))}),Array.isArray(t.filterContracts)&&t.filterContracts.forEach((s,n)=>{i.push(...it(s,`filterContracts.${n}`))}),t.unsupportedInsights!==void 0&&(Array.isArray(t.unsupportedInsights)?t.unsupportedInsights.forEach((s,n)=>{i.push(...$t(s,`unsupportedInsights.${n}`))}):i.push("unsupportedInsights must be an array.")),i.push(...Ve(t)),{ok:i.length===0,issues:i}}function Ve(o){const i=Array.isArray(o.unsupportedInsights)&&o.unsupportedInsights.some(u=>{var l;return X.has((l=a(u))==null?void 0:l.reason)}),t=Array.isArray(o.views)&&o.views.some(u=>{var d;const l=a((d=a(u))==null?void 0:d.computation);return(l==null?void 0:l.kind)==="unsupported"&&X.has(l.reason)});if(!i&&!t)return[];const s=[],n=a(o.validation);(n==null?void 0:n.status)!=="blocked"&&s.push("validation.status must be blocked when semantic model repair gaps are present.");const r=a(o.nextRequiredTool);return(r==null?void 0:r.name)!=="semaphor_propose_semantic_model_change"&&s.push("nextRequiredTool.name must be semaphor_propose_semantic_model_change when semantic model repair gaps are present."),s}const X=new Set(["missing_relationship","raw_identifier_filter_options"]);function w(o,i){const t=a(o);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 Le(o){const i=a(o);if(!i)return["implementationChecklist must be an object."];const t=[],s=["requiredDevtools","requiredInputOptions","filterScopeByInput","bindingsByView","validationCommands","browserSmokeChecks"];for(const r of s)r in i||t.push(`implementationChecklist.${r} is required.`);const n=a(i.requiredDevtools);return n?typeof n.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."),a(i.bindingsByView)||t.push("implementationChecklist.bindingsByView must be an object."),g(i.validationCommands)||t.push("implementationChecklist.validationCommands must be an array of strings."),g(i.browserSmokeChecks)||t.push("implementationChecklist.browserSmokeChecks must be an array of strings."),t}function Ge(o,i){const t=a(o);if(!t)return[`${i} must be an object.`];const s=[];return(typeof t.id!="string"||!t.id.trim())&&s.push(`${i}.id is required.`),t.fieldRef&&s.push(...c(t.fieldRef,`${i}.fieldRef`)),s.push(...le(t.optionQuery,`${i}.optionQuery`)),g(t.appliesToViewIds)||s.push(`${i}.appliesToViewIds must be an array of strings.`),t.bindings!==void 0&&!Array.isArray(t.bindings)&&s.push(`${i}.bindings must be an array.`),Array.isArray(t.bindings)&&t.bindings.forEach((n,r)=>{const u=a(n);if(!u){s.push(`${i}.bindings.${r} must be an object.`);return}g(u.appliesToViewIds)||s.push(`${i}.bindings.${r}.appliesToViewIds must be an array of strings.`),s.push(...c(u.fieldRef,`${i}.bindings.${r}.fieldRef`))}),s}function Ue(o,i){const t=a(o);if(!t)return[`${i} must be an object.`];const s=[];if((typeof t.id!="string"||!t.id.trim())&&s.push(`${i}.id is required.`),t.visualSpec!==void 0&&s.push(...ht(t.visualSpec,`${i}.visualSpec`)),t.computation!==void 0&&s.push(...vt(t.computation,`${i}.computation`)),gt(t))return s.push(...D(t,`${i}`)),t.fields!==void 0&&(Array.isArray(t.fields)?t.fields.forEach((d,b)=>{s.push(...c(d,`${i}.fields.${b}`))}):s.push(`${i}.fields must be an array.`)),t.queryKind!==void 0&&s.push(`${i}.queryKind is not allowed for non-executable views.`),t.sdkBuilder!==void 0&&s.push(`${i}.sdkBuilder is not allowed for non-executable views.`),t.sdkSpec!==void 0&&s.push(`${i}.sdkSpec is not allowed for non-executable views.`),s;if(!Array.isArray(t.fields))return s.push(`${i}.fields must be an array.`),(t.sdkSpec!==void 0||t.sdkBuilder!==void 0)&&s.push(`${i}.fields must be an array for executable views.`),s.push(...D(t,`${i}`)),s;t.fields.forEach((d,b)=>{s.push(...c(d,`${i}.fields.${b}`))}),$(t.queryKind)||s.push(`${i}.queryKind must be a supported codegen query kind.`),t.sdkBuilder!==void 0&&!ce(t.sdkBuilder)&&s.push(`${i}.sdkBuilder must be a supported SDK builder.`),t.metricBindingKeys!==void 0&&(Array.isArray(t.metricBindingKeys)?t.metricBindingKeys.some(d=>typeof d!="string"||d.trim().length===0)&&s.push(`${i}.metricBindingKeys must be an array of strings.`):s.push(`${i}.metricBindingKeys must be an array of strings.`));const n=a(t.sdkSpec),r=(n==null?void 0:n.builder)==="semaphor.metric";r&&(!Array.isArray(t.metricBindingKeys)||t.metricBindingKeys.length===0)&&s.push(`${i}.metricBindingKeys is required for metric views.`);const u=He(t);r&&Array.isArray(t.metricBindingKeys)&&u&&JSON.stringify(t.metricBindingKeys)!==JSON.stringify(u)&&s.push(`${i}.metricBindingKeys must match the generated metric field binding keys in order.`);const l=a(t.computation);return(l==null?void 0:l.kind)==="server_query"&&$(t.queryKind)&&$(l.queryKind)&&l.queryKind!==t.queryKind&&s.push(`${i}.computation.queryKind must match queryKind.`),s.push(...st({value:t.sdkSpec,path:`${i}.sdkSpec`,queryKind:typeof t.queryKind=="string"?t.queryKind:void 0,sdkBuilder:typeof t.sdkBuilder=="string"?t.sdkBuilder:void 0}),...D(t,`${i}`)),s}function He(o){const i=a(o.sdkSpec);if((i==null?void 0:i.builder)!=="semaphor.metric")return;const t=a(i.spec);if(!t)return;const n=[t.primaryMeasure,...Array.isArray(t.measures)?t.measures:[]].map(Qe).filter(r=>!!r);return Array.from(new Map(n.map(r=>[r.identity,r.bindingKey])).values())}function Qe(o){const i=a(o);if(!i||typeof i.name!="string"||!i.name.trim())return;const t=Ye(i);return t?{identity:JSON.stringify({source:t,name:i.name,aggregate:ae(i)}),bindingKey:Ze(i)}:void 0}function Ye(o){if(typeof o.sourceKey=="string"&&o.sourceKey.trim())return{sourceKey:o.sourceKey};const i=a(o.source);if(i)return{kind:i.kind,domainId:i.domainId,datasetId:i.datasetId,datasetName:i.datasetName,name:i.name}}function Ze(o){return typeof o.sourceKey=="string"&&o.sourceKey.trim()?[o.sourceKey,ae(o),o.name].filter(Boolean).join(":"):ne.semaphorMetricMeasureBindingKey(o)}function ae(o){return ne.semaphorMetricAggregate(o)}function D(o,i){var b;const t=a((b=a(o.visualSpec))==null?void 0:b.tableBehavior),s=a(o.sdkSpec),n=a(s==null?void 0:s.spec),r=typeof(s==null?void 0:s.builder)=="string"?s.builder:void 0,u=r==="semaphor.records"?a(n==null?void 0:n.totals):void 0,l=[];if(!t)return u&&l.push(`${i}.sdkSpec.spec.totals is only allowed when tableBehavior.totals.mode is server.`),l;const d=a(t.totals);return d?(d.mode==="server"&&(r!=="semaphor.records"&&l.push(`${i}.visualSpec.tableBehavior.totals.mode server is only supported for semaphor.records views.`),!u||u.mode!=="server"?l.push(`${i}.sdkSpec.spec.totals.mode must be server when tableBehavior.totals.mode is server.`):l.push(...We({left:d.measures,right:u.measures,leftPath:`${i}.visualSpec.tableBehavior.totals.measures`,rightPath:`${i}.sdkSpec.spec.totals.measures`}))),d.mode!=="server"&&u&&l.push(`${i}.sdkSpec.spec.totals is only allowed when tableBehavior.totals.mode is server.`),r==="semaphor.sql"&&d.mode!=="none"&&l.push(`${i}.visualSpec.tableBehavior.totals.mode must be none for semaphor.sql views.`),r==="semaphor.sql"&&a(n==null?void 0:n.totals)&&l.push(`${i}.sdkSpec.spec.totals is not supported for semaphor.sql.`),l):(u&&l.push(`${i}.sdkSpec.spec.totals is only allowed when tableBehavior.totals.mode is server.`),l)}function We({left:o,right:i,leftPath:t,rightPath:s}){if(!Array.isArray(o)||!Array.isArray(i))return[`${s} must match ${t}.`];const n=[];return o.length!==i.length?(n.push(`${s} must match ${t}.`),n):(o.forEach((r,u)=>{Je(a(r),a(i[u]))||n.push(`${s}.${u} must match ${t}.${u}.`)}),n)}function Je(o,i){return!o||!i?!1:o.name===i.name&&(o.role||"measure")===(i.role||"measure")&&ee(o)===ee(i)&&Xe(o,i)}function ee(o){return typeof o.aggregate=="string"?o.aggregate.toUpperCase():"SUM"}function Xe(o,i){const t=a(o.source),s=a(i.source);if(et(t,s))return!1;const n=te(o),r=te(i);if(n.size>0||r.size>0){for(const u of n)if(r.has(u))return!0;return!1}return!t||!s||t.kind!==s.kind?!1:t.kind==="semantic"?t.domainId===s.domainId&&t.datasetName===s.datasetName&&(t.datasetId===void 0||s.datasetId===void 0||t.datasetId===s.datasetId):t.kind==="physical"?t.connectionId===s.connectionId&&t.tableName===s.tableName:t.kind==="sql"?t.connectionId===s.connectionId:!1}function et(o,i){if(!o||!i||o.kind!=="semantic"||i.kind!=="semantic")return!1;const t=typeof o.datasetId=="string"?o.datasetId.trim():"",s=typeof i.datasetId=="string"?i.datasetId.trim():"";return!!(t&&s&&t!==s)}function te(o){const i=typeof o.sourceKey=="string"?o.sourceKey.trim():"";return i?new Set([i]):tt(a(o.source))}function tt(o){const i=new Set;if(!o)return i;const t=typeof o.sourceKey=="string"?o.sourceKey.trim():"";if(t&&i.add(t),o.kind==="semantic"){const s=typeof o.domainId=="string"?o.domainId:"",n=typeof o.datasetName=="string"?o.datasetName:"",r=typeof o.datasetId=="string"?o.datasetId:"";s&&r&&i.add(`semantic:${s}:datasetId:${r}`),s&&n&&i.add(`semantic:${s}:datasetName:${n}`)}if(o.kind==="physical"){const s=typeof o.connectionId=="string"?o.connectionId:"",n=typeof o.tableName=="string"?o.tableName:"",r=typeof o.databaseName=="string"?o.databaseName:"",u=typeof o.schemaName=="string"?o.schemaName:"";s&&n&&(i.add(["physical",s,r,u,n].join(":")),i.add(`physical:${s}:${n}`))}if(o.kind==="sql"){const s=typeof o.connectionId=="string"?o.connectionId:"",n=typeof o.dialect=="string"?o.dialect:"",r=typeof o.label=="string"?o.label:"";s&&(i.add(["sql",s,n,r].join(":")),i.add(`sql:${s}`))}return i}function it(o,i){const t=a(o);if(!t)return[`${i} must be an object.`];const s=[];if(t.fieldRef&&s.push(...c(t.fieldRef,`${i}.fieldRef`)),(typeof t.inputId!="string"||!t.inputId.trim())&&s.push(`${i}.inputId is required.`),s.push(...le(t.optionQuery,`${i}.optionQuery`)),g(t.appliesToViewIds)||s.push(`${i}.appliesToViewIds must be an array of strings.`),g(t.notAppliedToViewIds)||s.push(`${i}.notAppliedToViewIds must be an array of strings.`),!Array.isArray(t.bindings))s.push(`${i}.bindings must be an array.`);else{const n=g(t.appliesToViewIds)?new Set(t.appliesToViewIds):void 0,r=g(t.notAppliedToViewIds)?new Set(t.notAppliedToViewIds):void 0;t.bindings.forEach((u,l)=>{const d=a(u);if(!d){s.push(`${i}.bindings.${l} must be an object.`);return}typeof d.viewId!="string"||!d.viewId?s.push(`${i}.bindings.${l}.viewId is required.`):(n&&!n.has(d.viewId)&&s.push(`${i}.bindings.${l}.viewId must be included in appliesToViewIds.`),r!=null&&r.has(d.viewId)&&s.push(`${i}.bindings.${l}.viewId must not be listed in notAppliedToViewIds.`)),s.push(...c(d.fieldRef,`${i}.bindings.${l}.fieldRef`))})}return s}function le(o,i){if(o===void 0)return[];const t=a(o);if(!t)return[`${i} must be an object.`];const s=[...h(t.valueFieldRef,`${i}.valueFieldRef`),...h(t.labelFieldRef,`${i}.labelFieldRef`),...h(t.filterFieldRef,`${i}.filterFieldRef`)];return t.builder!=="semaphor.inputOptions"&&s.push(`${i}.builder must be semaphor.inputOptions.`),typeof t.sourceKey!="string"&&t.source===void 0&&s.push(`${i} must include source or sourceKey.`),t.source!==void 0&&s.push(...w(t.source,`${i}.source`)),a(t.valueFieldRef)||s.push(`${i}.valueFieldRef is required.`),a(t.labelFieldRef)||s.push(`${i}.labelFieldRef is required.`),t.limit!==void 0&&(typeof t.limit!="number"||!Number.isInteger(t.limit)||t.limit<=0)&&s.push(`${i}.limit must be a positive integer.`),s}function st(o){var n;const i=a(o.value);if(!i)return[`${o.path} is required for executable views.`];const t=[];if(!ce(i.builder))return t.push(`${o.path}.builder must be a supported SDK builder.`),t;o.sdkBuilder&&i.builder!==o.sdkBuilder&&t.push(`${o.path}.builder must match sdkBuilder.`),o.queryKind&&$(o.queryKind)&&i.builder!==mt(o.queryKind)&&t.push(`${o.path}.builder must match queryKind.`);const s=a(i.spec);if(!s)return t.push(`${o.path}.spec must be an object.`),t;switch(i.builder){case"semaphor.metric":t.push(...v(s,re,`${o.path}.spec`),...I(s,o.path),...M(s.measures,`${o.path}.spec.measures`),...h(s.primaryMeasure,`${o.path}.spec.primaryMeasure`),...h(s.dateField,`${o.path}.spec.dateField`),...T(s.dimensions,`${o.path}.spec.dimensions`),...B(s.orderBy,`${o.path}.spec.orderBy`),..._(s.filters,`${o.path}.spec.filters`));break;case"semaphor.analysis":t.push(...v(s,Ke,`${o.path}.spec`),...I(s,o.path),...M(s.measures,`${o.path}.spec.measures`),...h(s.primaryMeasure,`${o.path}.spec.primaryMeasure`),...h(s.dateField,`${o.path}.spec.dateField`),...T(s.dimensions,`${o.path}.spec.dimensions`),...B(s.orderBy,`${o.path}.spec.orderBy`),..._(s.filters,`${o.path}.spec.filters`),...nt(s,`${o.path}.spec`));break;case"semaphor.records":t.push(...v(s,Oe,`${o.path}.spec`),...I(s,o.path),...M(s.fields,`${o.path}.spec.fields`),...h(s.dateField,`${o.path}.spec.dateField`),...B(s.orderBy,`${o.path}.spec.orderBy`),..._(s.filters,`${o.path}.spec.filters`),...rt(s.totals,`${o.path}.spec.totals`));break;case"semaphor.matrix":t.push(...v(s,De,`${o.path}.spec`),...at(s,o.path),...lt(s.rows,`${o.path}.spec.rows`),...ut(s.columns,`${o.path}.spec.columns`),...dt(s.values,`${o.path}.spec.values`),...ct(s.sort,`${o.path}.spec.sort`),..._(s.filters,`${o.path}.spec.filters`),...ot(s.displayLimits,`${o.path}.spec.displayLimits`));break;case"semaphor.sql":t.push(...v(s,Me,`${o.path}.spec`),...I(s,o.path)),((n=a(s.source))==null?void 0:n.kind)!=="sql"&&t.push(`${o.path}.spec.source.kind must be sql.`),(typeof s.sql!="string"||!s.sql.trim())&&t.push(`${o.path}.spec.sql is required.`),t.push(...T(s.fields,`${o.path}.spec.fields`));break}return t}function ot(o,i){if(o===void 0)return[];const t=a(o);if(!t)return[`${i} must be an object.`];const s=[];s.push(...ie(t.rows,`${i}.rows`),...ie(t.columns,`${i}.columns`));for(const n of Object.keys(t))n==="rows"||n==="columns"||s.push(`${i}.${n} is not supported.`);return s}function ie(o,i){if(o===void 0)return[];const t=a(o);if(!t)return[`${i} must be an object.`];const s=[];(typeof t.limit!="number"||!Number.isInteger(t.limit)||t.limit<1)&&s.push(`${i}.limit must be a positive integer.`);for(const n of Object.keys(t))n!=="limit"&&s.push(`${i}.${n} is not supported; matrix display limits are count-only in v1.`);return s}function nt(o,i){const t=[];if(o.driverMode!==void 0&&!Ne.has(o.driverMode)&&t.push(`${i}.driverMode must be a supported analysis driver mode.`),o.includePopulation!==void 0&&typeof o.includePopulation!="boolean"&&t.push(`${i}.includePopulation must be a boolean.`),o.calendarContext!==void 0){const s=a(o.calendarContext);if(!s)t.push(`${i}.calendarContext must be an object.`);else{s.tz!==void 0&&typeof s.tz!="string"&&t.push(`${i}.calendarContext.tz must be a string.`),s.weekStart!==void 0&&(typeof s.weekStart!="number"||!Number.isInteger(s.weekStart)||s.weekStart<0||s.weekStart>6)&&t.push(`${i}.calendarContext.weekStart must be an integer between 0 and 6.`);const n=s.anchor;if(n!==void 0&&n!=="now"){const r=a(n);(!r||typeof r.iso!="string"||!r.iso.trim())&&t.push(`${i}.calendarContext.anchor must be now or { iso }.`)}}}return t}function rt(o,i){if(o===void 0)return[];const t=a(o);if(!t)return[`${i} must be an object.`];const s=[];return t.mode!=="server"&&s.push(`${i}.mode must be server.`),!Array.isArray(t.measures)||t.measures.length===0?s.push(`${i}.measures must include at least one measure.`):t.measures.forEach((n,r)=>{var u;s.push(...pe(n,`${i}.measures.${r}`)),((u=a(n))==null?void 0:u.role)!=="measure"&&s.push(`${i}.measures.${r}.role must be measure.`)}),s}function v(o,i,t){const s=[];return Object.keys(o).forEach(n=>{i.has(n)||s.push(`${t}.${n} is not supported for this SDK builder.`)}),s}function I(o,i){return a(o.source)?w(o.source,`${i}.spec.source`):[`${i}.spec.source must be an object.`]}function at(o,i){const t=a(o.source);if(!t)return[`${i}.spec.source must be an object.`];const s=w(o.source,`${i}.spec.source`);return t.kind!=="semantic"&&t.kind!=="physical"&&s.push(`${i}.spec.source.kind must be semantic or physical.`),s}function M(o,i){const t=G(o,i);return Array.isArray(o)&&o.forEach((s,n)=>{t.push(...c(s,`${i}.${n}`))}),t}function T(o,i){if(o===void 0)return[];if(!Array.isArray(o))return[`${i} must be an array.`];const t=[];return o.forEach((s,n)=>{t.push(...c(s,`${i}.${n}`))}),t}function B(o,i){if(o===void 0)return[];const t=a(o);return t?[...c(t.field,`${i}.field`),...ue(t.direction,`${i}.direction`)]:[`${i} must be an object.`]}function lt(o,i){const t=G(o,i);return Array.isArray(o)&&o.forEach((s,n)=>{const r=a(s);if(!r){t.push(`${i}.${n} must be an object.`);return}t.push(...c(r.field,`${i}.${n}.field`))}),t}function ut(o,i){if(o===void 0)return[];const t=[];return Array.isArray(o)?(o.forEach((s,n)=>{const r=a(s);if(!r){t.push(`${i}.${n} must be an object.`);return}t.push(...c(r.field,`${i}.${n}.field`))}),t):[`${i} must be an array.`]}function dt(o,i){const t=G(o,i);return Array.isArray(o)&&o.forEach((s,n)=>{const r=a(s);if(!r){t.push(`${i}.${n} must be an object.`);return}t.push(...c(r.field,`${i}.${n}.field`))}),t}function ct(o,i){if(o===void 0)return[];if(!Array.isArray(o))return[`${i} must be an array.`];const t=[];return o.forEach((s,n)=>{const r=a(s);if(!r){t.push(`${i}.${n} must be an object.`);return}r.axis!=="row"&&r.axis!=="column"&&t.push(`${i}.${n}.axis must be row or column.`),t.push(...ue(r.direction,`${i}.${n}.direction`),...pt(r.by,`${i}.${n}.by`))}),t}function pt(o,i){const t=a(o);if(!t)return[`${i} must be an object.`];switch(t.kind){case"label":return[];case"field":return c(t.field,`${i}.field`);case"value":return typeof t.valueId!="string"||!t.valueId.trim()?[`${i}.valueId is required.`]:[];default:return[`${i}.kind must be label, field, or value.`]}}function ue(o,i){return o==="asc"||o==="desc"?[]:[`${i} must be asc or desc.`]}function _(o,i){if(o===void 0)return[];if(!Array.isArray(o))return[`${i} must be an array.`];const t=[];return o.forEach((s,n)=>{const r=a(s);if(!r){t.push(`${i}.${n} must be an object.`);return}t.push(...c(r.field,`${i}.${n}.field`))}),t}function G(o,i){return!Array.isArray(o)||o.length===0?[`${i} must be a non-empty array.`]:[]}function mt(o){switch(o){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 gt(o){const i=a(o.computation),t=a(o.visualSpec);return(i==null?void 0:i.kind)==="presentation_only"||(i==null?void 0:i.kind)==="derived"||(i==null?void 0:i.kind)==="unsupported"||o.visual==="text_block"||(t==null?void 0:t.visualType)==="text_block"}function ht(o,i){const t=a(o);if(!t)return[`${i} must be an object.`];const s=[];return Te.has(t.visualType)||s.push(`${i}.visualType must be a supported visual type.`),t.limit!==void 0&&(typeof t.limit!="number"||!Number.isInteger(t.limit)||t.limit<=0)&&s.push(`${i}.limit must be a positive integer.`),t.tableBehavior!==void 0&&s.push(...ft(t.tableBehavior,`${i}.tableBehavior`)),s}function ft(o,i){const t=a(o);if(!t)return[`${i} must be an object.`];const s=[];return t.tableMode!=="bounded"&&t.tableMode!=="server_paginated"&&t.tableMode!=="server_windowed"&&s.push(`${i}.tableMode must be a supported table mode.`),s.push(...yt(t.height,`${i}.height`),...bt(t.pagination,`${i}.pagination`),...zt(t.sorting,`${i}.sorting`),...St(t.totals,`${i}.totals`)),typeof t.serverSideRequired!="boolean"&&s.push(`${i}.serverSideRequired must be a boolean.`),s}function yt(o,i){const t=a(o);if(!t)return[`${i} must be an object.`];const s=[];return(typeof t.maxPx!="number"||!Number.isInteger(t.maxPx)||t.maxPx<=0)&&s.push(`${i}.maxPx must be a positive integer.`),t.scroll!=="vertical"&&t.scroll!=="both"&&s.push(`${i}.scroll must be vertical or both.`),typeof t.stickyHeader!="boolean"&&s.push(`${i}.stickyHeader must be a boolean.`),s}function bt(o,i){const t=a(o);if(!t)return[`${i} must be an object.`];const s=[];return t.mode!=="none"&&t.mode!=="server"&&t.mode!=="client_for_bounded_rows"&&s.push(`${i}.mode must be a supported pagination mode.`),t.pageSize!==void 0&&(typeof t.pageSize!="number"||!Number.isInteger(t.pageSize)||t.pageSize<=0)&&s.push(`${i}.pageSize must be a positive integer.`),t.readsFrom!==void 0&&t.readsFrom!=="result.pagination"&&s.push(`${i}.readsFrom must be result.pagination.`),s}function zt(o,i){const t=a(o);if(!t)return[`${i} must be an object.`];const s=[];return t.mode!=="server"&&t.mode!=="client_for_bounded_rows"&&s.push(`${i}.mode must be a supported sorting mode.`),t.defaultField!==void 0&&(typeof t.defaultField!="string"||!t.defaultField.trim())&&s.push(`${i}.defaultField must be a non-empty string.`),t.defaultDirection!==void 0&&t.defaultDirection!=="asc"&&t.defaultDirection!=="desc"&&s.push(`${i}.defaultDirection must be asc or desc.`),t.resetPageOnChange!==void 0&&typeof t.resetPageOnChange!="boolean"&&s.push(`${i}.resetPageOnChange must be a boolean.`),s}function St(o,i){const t=a(o);if(!t)return[`${i} must be an object.`];const s=[];return t.mode!=="none"&&t.mode!=="server"&&t.mode!=="local"?(s.push(`${i}.mode must be none, server, or local.`),s):t.mode==="none"?(t.measures!==void 0&&s.push(`${i}.measures is not allowed when mode is none.`),t.label!==void 0&&s.push(`${i}.label is not allowed when mode is none.`),s):t.mode==="server"?(!Array.isArray(t.measures)||t.measures.length===0?s.push(`${i}.measures must include at least one measure when mode is server.`):t.measures.forEach((n,r)=>{var u;s.push(...pe(n,`${i}.measures.${r}`)),((u=a(n))==null?void 0:u.role)!=="measure"&&s.push(`${i}.measures.${r}.role must be measure.`)}),t.label!==void 0&&s.push(`${i}.label is not allowed when mode is server.`),s):(t.mode==="local"&&(t.label!=="Displayed rows"&&t.label!=="Current page"&&s.push(`${i}.label must be Displayed rows or Current page when mode is local.`),t.measures!==void 0&&s.push(`${i}.measures is not allowed when mode is local.`)),s)}function vt(o,i){const t=a(o);if(!t)return[`${i} must be an object.`];const s=[];switch(t.kind){case"server_query":$(t.queryKind)||s.push(`${i}.queryKind must be a supported codegen query kind.`),t.queryOwnership!==void 0&&t.queryOwnership!=="view_owned"&&t.queryOwnership!=="shared_query"&&s.push(`${i}.queryOwnership must be view_owned or shared_query.`),t.sourceKeys!==void 0&&!g(t.sourceKeys)&&s.push(`${i}.sourceKeys must be an array of strings.`),t.fieldNames!==void 0&&!g(t.fieldNames)&&s.push(`${i}.fieldNames must be an array of strings.`);break;case"derived":(typeof t.upstreamViewId!="string"||!t.upstreamViewId.trim())&&s.push(`${i}.upstreamViewId is required.`),(typeof t.derivation!="string"||!t.derivation.trim())&&s.push(`${i}.derivation is required.`);break;case"presentation_only":break;case"unsupported":(typeof t.reason!="string"||!t.reason.trim())&&s.push(`${i}.reason is required.`),(typeof t.suggestedModelingFix!="string"||!t.suggestedModelingFix.trim())&&s.push(`${i}.suggestedModelingFix is required.`);break;default:s.push(`${i}.kind must be a supported computation kind.`)}return s}function $t(o,i){const t=a(o);if(!t)return[`${i} must be an object.`];const s=[];for(const r of["title","requestedQuestion","suggestedModelingFix"])(typeof t[r]!="string"||!t[r].trim())&&s.push(`${i}.${r} is required.`);return Be.has(t.reason)||s.push(`${i}.reason must be a supported unsupported insight reason.`),(t.relationshipCandidate!==void 0||t.nextRepairAction!==void 0)&&t.reason!=="missing_relationship"&&s.push(`${i} relationship repair metadata is only valid for missing_relationship unsupported insights.`),t.diagnostic!==void 0&&s.push(...wt(t.diagnostic,`${i}.diagnostic`,t.reason)),t.relationshipCandidate!==void 0&&s.push(...At(t.relationshipCandidate,`${i}.relationshipCandidate`)),t.nextRepairAction!==void 0&&s.push(...kt(t.nextRepairAction,`${i}.nextRepairAction`)),s}function wt(o,i,t){const s=a(o);if(!s)return[`${i} must be an object.`];const n=[],r=new Set(["kind","inputId","inputLabel","optionSource","optionField","missingEvidence"]);Object.keys(s).forEach(l=>{r.has(l)||n.push(`${i}.${l} is not supported; raw identifier diagnostics support only kind, inputId, inputLabel, optionSource, optionField, and missingEvidence.`)}),t!=="raw_identifier_filter_options"&&n.push(`${i} is only valid for raw_identifier_filter_options unsupported insights.`),s.kind!=="raw_identifier_filter_options"&&n.push(`${i}.kind must be raw_identifier_filter_options.`);for(const l of["inputId","inputLabel"])(typeof s[l]!="string"||!s[l].trim())&&n.push(`${i}.${l} must be a non-empty string.`);n.push(...V(s.optionSource,`${i}.optionSource`)),n.push(...de(s.optionField,`${i}.optionField`));const u=new Set(["display_field","relationship_display_path"]);return!Array.isArray(s.missingEvidence)||s.missingEvidence.length===0?n.push(`${i}.missingEvidence must be a non-empty evidence array.`):s.missingEvidence.forEach((l,d)=>{u.has(l)||n.push(`${i}.missingEvidence.${d} must be display_field or relationship_display_path.`)}),n}function kt(o,i){const t=a(o);if(!t)return[`${i} must be an object.`];const s=[],n=new Set(["tool","reason"]);return Object.keys(t).forEach(r=>{n.has(r)||s.push(`${i}.${r} is not supported; repair actions support only tool and reason.`)}),t.tool!=="semaphor_propose_semantic_model_change"&&s.push(`${i}.tool must be semaphor_propose_semantic_model_change.`),t.reason!=="missing_relationship"&&s.push(`${i}.reason must be missing_relationship.`),s}function At(o,i){const t=a(o);if(!t)return[`${i} must be an object.`];const s=[],n=new Set(["source","sourceFields","target","targetFields"]);Object.keys(t).forEach(r=>{n.has(r)||s.push(`${i}.${r} is not supported; relationship candidates support only source, sourceFields, target, and targetFields.`)}),s.push(...V(t.source,`${i}.source`)),s.push(...V(t.target,`${i}.target`));for(const r of["sourceFields","targetFields"]){const u=t[r];if(!Array.isArray(u)||u.length===0){s.push(`${i}.${r} must be a non-empty endpoint field array.`);continue}u.forEach((l,d)=>{s.push(...de(l,`${i}.${r}.${d}`))})}return s}function de(o,i){const t=a(o);if(!t)return[`${i} must be an object.`];const s=[],n=new Set(["name","label","role","dataType"]);return Object.keys(t).forEach(r=>{n.has(r)||s.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())&&s.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))&&s.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))&&s.push(`${i}.dataType must be string, number, boolean, date, datetime, or unknown.`),s}function V(o,i){const t=a(o);if(!t)return[`${i} must be an object.`];const s=[],n=new Set(["kind","domainId","datasetName","datasetId","label","sourceKey"]);return Object.keys(t).forEach(r=>{n.has(r)||s.push(`${i}.${r} is not supported; relationship candidate sources support only semantic identity fields.`)}),t.kind!=="semantic"&&s.push(`${i} must use semantic source identity.`),(typeof t.domainId!="string"||!t.domainId.trim()||typeof t.datasetName!="string"||!t.datasetName.trim())&&s.push(`${i} must include semantic domainId and datasetName.`),s}function $(o){return Ee.has(o)}function ce(o){return xe.has(o)}function h(o,i){return o===void 0?[]:c(o,i)}function c(o,i){const t=a(o);if(!t)return[`${i} must be an object.`];const s=[];return(typeof t.name!="string"||!t.name.trim())&&s.push(`${i}.name is required.`),!t.source&&typeof t.sourceKey!="string"&&s.push(`${i} must include source or sourceKey.`),t.aggregate!==void 0&&!Fe.has(t.aggregate)&&s.push(`${i}.aggregate must be a supported aggregate function.`),s}function pe(o,i){const t=a(o),s=c(o,i);if(!t||typeof t.sourceKey=="string"&&t.sourceKey.trim())return s;if(t.source!==void 0){const r=w(t.source,`${i}.source`);return r.length===0||s.push(...r),s}return s.includes(`${i} must include source or sourceKey.`)||s.push(`${i} must include source or sourceKey.`),s}function a(o){return o&&typeof o=="object"&&!Array.isArray(o)?o:void 0}function g(o){return Array.isArray(o)&&o.every(i=>typeof i=="string")}const p=e.z.record(e.z.string(),e.z.unknown()),x=e.z.array(p),m=e.z.enum(["SUM","COUNT","AVG","MIN","MAX","MEDIAN","DISTINCT"]),F=e.z.enum(["postgres","mysql","mssql","snowflake","clickhouse","bigquery","redshift","duckdb","sqlite","unknown"]),me=e.z.enum(["hour","day","week","month","quarter","year"]),N=e.z.enum(["dimension","measure","date","id","unknown"]),K=e.z.enum(["string","number","boolean","date","datetime","unknown"]),R=e.z.union([e.z.number(),e.z.string(),e.z.null()]),P=e.z.enum(["millisecond","second","minute","hour","day"]),ge=e.z.union([e.z.object({type:e.z.enum(["number","currency","percent","percentage","scientific"]),locale:e.z.string().optional(),minimumFractionDigits:e.z.number().optional(),maximumFractionDigits:e.z.number().optional(),useGrouping:e.z.boolean().optional(),prefix:e.z.string().optional(),suffix:e.z.string().optional(),negativeStyle:e.z.enum(["minus","parentheses"]).optional(),compact:e.z.boolean().optional(),scale:e.z.number().optional(),currency:e.z.string().optional(),percentValueMode:e.z.enum(["fraction","whole"]).optional()}).passthrough().superRefine((o,i)=>{"locale"in o&&i.addIssue({code:e.z.ZodIssueCode.custom,path:["locale"],message:"Numeric semantic formats inherit locale from viewer preferences."})}),e.z.object({type:e.z.enum(["date","datetime"]),locale:e.z.string().optional(),pattern:e.z.string().optional(),relative:e.z.boolean().optional(),timezone:e.z.string().optional(),sourceTimezone:e.z.string().optional(),prefix:e.z.string().optional(),suffix:e.z.string().optional()}).passthrough(),e.z.object({type:e.z.literal("duration"),inputUnit:P.optional(),outputStyle:e.z.enum(["compact","digital","long"]).optional(),largestUnit:P.optional(),smallestUnit:P.optional(),maxUnits:e.z.number().optional(),prefix:e.z.string().optional(),suffix:e.z.string().optional(),negativeStyle:e.z.enum(["minus","parentheses"]).optional()}).passthrough(),e.z.object({type:e.z.literal("string"),prefix:e.z.string().optional(),suffix:e.z.string().optional()}).passthrough()]),It=e.z.union([e.z.object({kind:e.z.literal("defaultAggregate")}).passthrough(),e.z.object({kind:e.z.literal("blank")}).passthrough(),e.z.object({kind:e.z.literal("labelOnly"),label:e.z.string().optional()}).passthrough(),e.z.object({kind:e.z.literal("customAggregate"),aggregate:m}).passthrough(),e.z.object({kind:e.z.literal("percentOfParent")}).passthrough(),e.z.object({kind:e.z.literal("percentOfGrandTotal")}).passthrough(),e.z.object({kind:e.z.literal("customExpression"),expressionId:e.z.string()}).passthrough()]);function k(o,i){return e.z.object(o).passthrough().superRefine((t,s)=>{for(const n of i)Object.prototype.hasOwnProperty.call(t,n)||s.addIssue({code:"custom",path:[n],message:`Required field "${n}" is missing.`})})}const U=e.z.object({kind:e.z.literal("semantic"),domainId:e.z.string(),datasetName:e.z.string(),datasetId:e.z.string().optional(),label:e.z.string().optional(),connectionId:e.z.string().optional()}).passthrough(),he=e.z.object({kind:e.z.literal("physical"),connectionId:e.z.string(),connectionType:e.z.string().optional(),tableName:e.z.string(),databaseName:e.z.string().optional(),schemaName:e.z.string().optional(),label:e.z.string().optional(),dialect:F.optional()}).passthrough(),fe=e.z.object({kind:e.z.literal("sql"),connectionId:e.z.string(),dialect:F.optional(),label:e.z.string().optional()}).passthrough(),z=e.z.union([U,he,fe]),y=e.z.object({name:e.z.string(),label:e.z.string().optional(),role:N.optional(),dataType:K.optional(),source:z.optional(),aggregate:m.optional()}).passthrough(),_t=e.z.object({kind:e.z.literal("field"),field:y,aggregate:m.optional()}).passthrough(),H=e.z.object({kind:e.z.literal("derived_field"),name:e.z.string(),label:e.z.string(),description:e.z.string().optional(),resultRole:N,dataType:K,computeStage:e.z.enum(["row","aggregate"]),expression:e.z.string(),expressionLanguage:e.z.literal("semaphor_sql_template").optional(),inputs:e.z.record(_t),defaultAggregate:m.optional(),aggregationBehavior:e.z.enum(["additive","non_additive","ratio_of_sums","weighted","pre_aggregated","snapshot"]).optional(),aggregationStrategy:e.z.enum(["default","symmetric_aggregate","aggregate_then_join","weighted"]).optional(),format:ge.optional(),tags:e.z.array(e.z.string()).optional()}).passthrough(),O=y.and(e.z.object({derivedField:H.optional()}).passthrough()),Rt=U,jt=e.z.object({kind:e.z.literal("physical"),connectionId:e.z.string().optional(),connectionType:e.z.string().optional(),tableName:e.z.string(),databaseName:e.z.string().optional(),schemaName:e.z.string().optional(),label:e.z.string().optional(),dialect:F.optional()}).passthrough(),Ct=e.z.object({kind:e.z.literal("sql"),connectionId:e.z.string().optional(),dialect:F.optional(),label:e.z.string().optional()}).passthrough(),qt=e.z.union([Rt,jt,Ct]),Et=e.z.object({key:e.z.string().optional(),name:e.z.string(),label:e.z.string().optional(),role:N.optional(),dataType:K.optional(),source:qt.optional(),aggregate:m.optional(),derivedField:e.z.never().optional()}).passthrough(),C=e.z.object({key:e.z.string(),name:e.z.string(),label:e.z.string(),role:N.optional(),dataType:K.optional(),aggregate:m.optional(),source:z.optional(),derivedField:H.optional()}).passthrough(),ye=e.z.object({code:e.z.string(),message:e.z.string().optional(),invalidField:e.z.string().optional(),fieldRole:e.z.enum(["measure","date","dimension","input","source","sql"]).optional(),validMeasureCandidates:e.z.array(e.z.string()).optional(),validDateCandidates:e.z.array(e.z.string()).optional(),validDimensionCandidates:e.z.array(e.z.string()).optional(),recommendedNextStep:e.z.string()}).passthrough(),q=e.z.object({code:e.z.string(),message:e.z.string(),path:e.z.string().optional(),fieldRole:e.z.enum(["measure","date","dimension","input","source","sql"]).optional(),repairHint:ye.optional()}).passthrough(),Q=e.z.object({ok:e.z.boolean(),errors:e.z.array(q),warnings:e.z.array(q),repairHints:e.z.array(ye)}).passthrough(),xt=e.z.object({page:e.z.number(),pageSize:e.z.number(),pageCount:e.z.number(),totalCount:e.z.number(),hasNextPage:e.z.boolean(),hasPrevPage:e.z.boolean()}).passthrough(),A={intentId:e.z.string().optional(),queryPath:e.z.enum(["query_spec","sql","sql_python"]),warnings:e.z.array(e.z.string()).optional(),rowCount:e.z.number().optional(),rowLimitExceeded:e.z.boolean().optional(),limit:e.z.number().optional(),pagination:xt.optional()},be=e.z.object({...A,kind:e.z.literal("metric"),primaryValue:R,measures:e.z.record(R).optional(),missingMeasures:e.z.array(e.z.string()).optional(),comparison:e.z.object({kind:e.z.enum(["previous_period","previous_year","target"]),value:R.optional(),delta:e.z.union([e.z.number(),e.z.null()]).optional(),deltaPercent:e.z.union([e.z.number(),e.z.null()]).optional()}).passthrough().optional(),records:x.optional()}).passthrough(),ze=e.z.object({...A,kind:e.z.literal("records"),columns:e.z.array(C),records:x,totals:e.z.object({mode:e.z.literal("server"),scope:e.z.literal("filtered_result"),row:e.z.record(e.z.string(),e.z.unknown()),columns:e.z.array(C).optional()}).passthrough().optional()}).passthrough(),Se=e.z.object({...A,kind:e.z.literal("inputOptions"),options:e.z.array(k({label:e.z.string(),value:e.z.unknown(),count:e.z.number().optional(),disambiguation:e.z.array(e.z.string()).optional()},["value"]))}).passthrough(),ve=e.z.object({...A,kind:e.z.literal("sql"),columns:e.z.array(C),records:x,sqlShape:e.z.object({statementType:e.z.string().optional(),explicitLimit:e.z.number().optional(),hasPythonCode:e.z.boolean().optional()}).passthrough().optional()}).passthrough(),Ft=e.z.object({enabled:e.z.boolean().optional(),position:e.z.enum(["before","after"]).optional(),label:e.z.string().optional()}).passthrough(),se=e.z.object({id:e.z.enum(["rows","columns"]),levels:e.z.array(e.z.object({instanceId:e.z.string(),fieldKey:e.z.string(),label:e.z.string(),field:y,grain:me.optional(),subtotal:Ft.optional()}).passthrough()),nodeIds:e.z.array(e.z.string())}).passthrough(),S=k({instanceId:e.z.string(),fieldKey:e.z.string(),value:e.z.unknown(),label:e.z.string()},["value"]),Nt=e.z.union([e.z.object({kind:e.z.literal("label")}).passthrough(),e.z.object({kind:e.z.literal("field"),field:y,aggregate:m.optional()}).passthrough(),e.z.object({kind:e.z.literal("value"),valueId:e.z.string(),rowPath:e.z.array(S).optional(),columnPath:e.z.array(S).optional()}).passthrough()]),Kt=e.z.enum(["present","presentNull","missing","densified"]),Ot=e.z.enum(["value","rowSubtotal","columnSubtotal","subtotalIntersection","rowGrandTotal","columnGrandTotal","matrixGrandTotal"]),Dt=e.z.object({instanceId:e.z.string(),fieldKey:e.z.string(),field:y,role:e.z.enum(["row","column","measure","sort","filter"]),label:e.z.string().optional()}).passthrough(),Mt=e.z.union([e.z.object({kind:e.z.literal("additive"),aggregate:m.optional()}).passthrough(),e.z.object({kind:e.z.literal("semiAdditive"),aggregate:m.optional(),grain:me.optional()}).passthrough(),e.z.object({kind:e.z.literal("nonAdditive"),aggregate:m.optional()}).passthrough(),e.z.object({kind:e.z.literal("ratio"),numeratorMeasureInstanceId:e.z.string().optional(),denominatorMeasureInstanceId:e.z.string().optional()}).passthrough(),e.z.object({kind:e.z.literal("custom"),expressionId:e.z.string().optional()}).passthrough()]),Tt=e.z.object({instanceId:e.z.string(),fieldKey:e.z.string(),label:e.z.string(),field:y,aggregate:m.optional(),format:ge.optional(),totalBehavior:It.optional(),semantics:Mt}).passthrough(),Bt=e.z.object({id:e.z.string(),measureId:e.z.string(),aggregate:m.optional(),label:e.z.string().optional(),source:e.z.enum(["measureDefault","rowSubtotal","columnSubtotal","subtotalIntersection","rowGrandTotal","columnGrandTotal","matrixGrandTotal","custom"]),scope:e.z.object({rowLevelId:e.z.string().optional(),columnLevelId:e.z.string().optional(),rowNodeId:e.z.string().optional(),columnNodeId:e.z.string().optional()}).passthrough().optional()}).passthrough(),Pt=e.z.object({kind:e.z.string(),label:e.z.string().optional(),payload:e.z.record(e.z.string(),e.z.unknown()).optional()}).passthrough(),Vt=k({id:e.z.string(),axis:e.z.enum(["row","column"]),path:e.z.array(S),level:e.z.number(),label:e.z.string(),value:e.z.unknown(),parentId:e.z.string().optional(),hasChildren:e.z.boolean(),isExpanded:e.z.boolean().optional(),isSubtotal:e.z.boolean().optional(),isGrandTotal:e.z.boolean().optional(),subtotalFunction:m.optional(),childCount:e.z.number().optional(),actions:e.z.array(Pt).optional()},["value"]),Lt=e.z.object({rowHeaderLevels:e.z.array(e.z.object({id:e.z.string(),label:e.z.string(),fieldInstanceId:e.z.string()}).passthrough()),columnHeaderRows:e.z.array(e.z.object({id:e.z.string(),cells:e.z.array(e.z.object({id:e.z.string(),label:e.z.string(),role:e.z.enum(["rowHeader","columnHeader","measureHeader","subtotal","grandTotal"]),colSpan:e.z.number(),rowSpan:e.z.number(),columnPath:e.z.array(S),measureInstanceId:e.z.string().optional()}).passthrough())}).passthrough()),columns:e.z.array(e.z.object({id:e.z.string(),label:e.z.string(),columnNodeId:e.z.string().optional(),columnPath:e.z.array(S),measureInstanceId:e.z.string(),role:e.z.enum(["value","columnSubtotal","columnGrandTotal"])}).passthrough())}).passthrough(),Gt=k({rowId:e.z.string(),columnId:e.z.string().optional(),measureId:e.z.string(),value:e.z.unknown(),presence:Kt,role:Ot,calculationId:e.z.string().optional()},["value"]).superRefine((o,i)=>{Object.prototype.hasOwnProperty.call(o,"formattedValue")&&i.addIssue({code:"custom",path:["formattedValue"],message:"Matrix result cells carry typed values; formattedValue is not supported."})}),Ut=e.z.object({rows:e.z.boolean().optional(),columns:e.z.boolean().optional(),grandTotal:e.z.union([e.z.boolean(),e.z.object({rows:e.z.boolean().optional(),columns:e.z.boolean().optional()}).passthrough()]).optional()}).passthrough(),Ht=k({id:e.z.string(),axis:e.z.enum(["row","column"]),targetInstanceId:e.z.string().optional(),direction:e.z.enum(["asc","desc"]),nulls:e.z.enum(["warehouseDefault","first","last"]).optional(),scope:e.z.enum(["global","withinParent"]).optional(),by:Nt},["by"]),Qt=e.z.object({rowOffset:e.z.number().optional(),rowLimit:e.z.number().optional(),columnOffset:e.z.number().optional(),columnLimit:e.z.number().optional(),hasMoreRows:e.z.boolean().optional(),hasMoreColumns:e.z.boolean().optional()}).passthrough(),Yt=e.z.object({axis:e.z.enum(["row","column"]),path:e.z.array(S),depth:e.z.number().optional()}).passthrough(),Zt=e.z.object({rowLazyLoading:e.z.boolean().optional(),columnLazyLoading:e.z.boolean().optional(),expandableRowNodeIds:e.z.array(e.z.string()).optional(),expandableColumnNodeIds:e.z.array(e.z.string()).optional(),nextRequests:e.z.array(Yt).optional()}).passthrough(),Wt=e.z.object({domains:e.z.record(e.z.object({min:e.z.number().optional(),max:e.z.number().optional()}).passthrough()).optional(),rules:e.z.array(e.z.record(e.z.string(),e.z.unknown())).optional()}).passthrough(),$e=e.z.object({...A,kind:e.z.literal("matrix"),schemaVersion:e.z.literal(1),shape:e.z.enum(["hierarchical","pivot"]),capabilities:e.z.array(e.z.string()),executionMetadata:e.z.record(e.z.string(),e.z.unknown()),fieldsById:e.z.record(e.z.string(),Dt),measuresById:e.z.record(e.z.string(),Tt),calculationsById:e.z.record(e.z.string(),Bt).optional(),axes:e.z.object({rows:se,columns:se}).passthrough(),nodesById:e.z.record(e.z.string(),Vt),layout:Lt,cells:e.z.array(Gt),totals:Ut,sort:e.z.array(Ht),formattingContext:Wt,pageInfo:Qt.optional(),expansion:Zt.optional()}).passthrough(),we=e.z.union([be,ze,Se,ve,$e]),ke=e.z.object({status:e.z.enum(["not_required","resolved","missing","ambiguous","fanout_risk","unknown"]),requiredSources:e.z.array(z).optional(),relationshipsUsed:e.z.array(e.z.string()).optional(),missingSources:e.z.array(e.z.string()).optional(),warnings:e.z.array(e.z.string()).optional(),message:e.z.string().optional(),recommendedNextStep:e.z.string().optional(),joinPlanSummary:e.z.object({baseSource:z.optional(),joinedSources:e.z.array(z).optional(),joinCount:e.z.number().optional()}).passthrough().optional(),fanoutRisk:e.z.object({status:e.z.enum(["none","warning","error","unknown"]),message:e.z.string().optional()}).passthrough().optional()}).passthrough(),oe=e.z.enum(["ambiguous_fields","empty_result","missing_grounded_fields","missing_relationship","no_grounded_query","partial_result","presentation_incomplete","query_validation_failed","unsafe_join"]),Y=e.z.object({version:e.z.literal(1),status:e.z.enum(["answered","partial","blocked"]),summary:e.z.string(),answered:e.z.array(e.z.object({slotId:e.z.string().optional(),queryId:e.z.string().optional(),summary:e.z.string(),evidenceIds:e.z.array(e.z.string()).optional(),fieldsUsed:e.z.array(O).optional()}).passthrough()),blocked:e.z.array(e.z.object({slotId:e.z.string().optional(),queryId:e.z.string().optional(),reasonCode:oe,message:e.z.string(),missingFields:e.z.array(e.z.string()).optional(),availableFields:e.z.array(e.z.string()).optional(),ambiguousFields:e.z.array(e.z.string()).optional(),missingRelationships:e.z.array(e.z.string()).optional(),evidenceIds:e.z.array(e.z.string()).optional(),neededFromUser:e.z.array(e.z.string()).optional(),recommendedNextStep:e.z.string().optional()}).passthrough()),semanticModelRecommendations:e.z.array(e.z.object({reasonCode:oe,message:e.z.string(),recommendedNextStep:e.z.string().optional()}).passthrough()).optional()}).passthrough(),Z=e.z.object({scope:e.z.literal("filtered_query"),measures:e.z.record(R)}).passthrough(),W=e.z.object({answeredObligations:e.z.array(e.z.string()),missingObligations:e.z.array(e.z.string()),warnings:e.z.array(q).optional()}).passthrough(),Ae=e.z.object({intentId:e.z.string().optional(),queryId:e.z.string().optional(),status:e.z.enum(["answered","partial","failed"]),resultShape:e.z.enum(["metric","records","inputOptions","sql","matrix","period_change","analysis"]).optional(),intent:e.z.unknown().optional(),compiledQuery:e.z.unknown().optional(),fieldsUsed:e.z.array(O).optional(),result:we.optional(),validation:Q,coverage:W.optional(),missingFields:e.z.array(e.z.string()).optional(),warnings:e.z.array(e.z.string()).optional(),relationshipDiagnostics:ke.optional(),diagnosticFeedback:Y.optional(),population:Z.optional(),metadata:e.z.record(e.z.string(),e.z.unknown()).optional()}).passthrough();function Jt(o){switch(o){case"boolean":return e.z.boolean().optional();case"compactExecutionFieldArray":return e.z.array(Et).optional();case"coverage":return W.optional();case"diagnosticFeedback":return Y.optional();case"executionFieldArray":return e.z.array(O).optional();case"executionResult":return Ae.optional();case"number":return e.z.number().finite().optional();case"population":return Z.optional();case"record":return p.optional();case"recordArray":return x.optional();case"responseDetail":return e.z.enum(["compact","standard","debug"]).optional();case"string":return e.z.string().optional();case"stringArray":return e.z.array(e.z.string()).optional();case"unknown":return e.z.unknown().optional();case"unknownArray":return e.z.array(e.z.unknown()).optional();case"validationResult":return Q.optional()}}const Ie=Object.fromEntries(Object.entries(E).map(([o,i])=>[o,Jt(i)])),_e=e.z.object(Ie).strict(),J=e.z.object({sourceKey:e.z.string().optional(),kind:e.z.enum(["semantic","physical","sql"]).optional(),domainId:e.z.string().optional(),datasetName:e.z.string().optional(),datasetId:e.z.string().optional(),connectionId:e.z.string().optional(),tableName:e.z.string().optional(),label:e.z.string().optional()}).passthrough(),f=e.z.object({name:e.z.string(),label:e.z.string().optional(),role:e.z.enum(["dimension","measure","date","id","unknown"]).optional(),dataType:e.z.enum(["string","number","boolean","date","datetime","unknown"]).optional(),aggregate:m.optional(),sourceKey:e.z.string().optional(),source:J.optional()}).passthrough(),Re=e.z.object({id:e.z.string().optional(),builder:e.z.literal("semaphor.inputOptions"),source:J.optional(),sourceKey:e.z.string().optional(),valueFieldRef:f,labelFieldRef:f,filterFieldRef:f.optional(),population:e.z.unknown().optional(),dependencies:e.z.unknown().optional(),limit:e.z.number().int().positive().optional(),spec:p.optional()}).passthrough(),je=e.z.object({appliesToViewIds:e.z.array(e.z.string()).optional(),viewId:e.z.string().optional(),fieldRef:f,relationshipHint:e.z.unknown().optional(),relationshipsUsed:e.z.array(p).optional()}).passthrough(),Xt=e.z.object({id:e.z.string(),label:e.z.string().optional(),type:e.z.string().optional(),serverSide:e.z.boolean().optional(),fieldRef:f.optional(),optionQuery:Re.optional(),bindings:e.z.array(je).optional(),appliesToViewIds:e.z.array(e.z.string()),relationshipHint:e.z.unknown().optional(),relationshipsUsed:e.z.array(p).optional()}).passthrough(),ei=e.z.object({builder:e.z.enum(["semaphor.metric","semaphor.records","semaphor.matrix","semaphor.analysis","semaphor.sql"]),spec:p,fallbackReason:p.optional()}).passthrough(),ti=e.z.object({id:e.z.string(),title:e.z.string().optional(),purpose:e.z.string().optional(),sourcePresentation:e.z.object({sourceKeys:e.z.array(e.z.string()).optional(),sourceLabels:e.z.array(e.z.string()).optional()}).passthrough().optional(),visual:e.z.string().optional(),visualSpec:p.optional(),queryKind:e.z.enum(["metric","records","matrix","analysis","sql_fallback"]).optional(),sdkBuilder:e.z.enum(["semaphor.metric","semaphor.records","semaphor.matrix","semaphor.analysis","semaphor.sql"]).optional(),sdkSpec:ei.optional(),fields:e.z.array(f).optional(),computation:p.optional(),uxExpectations:e.z.array(e.z.string()).optional(),validation:p.optional()}).passthrough(),ii=e.z.object({inputId:e.z.string(),label:e.z.string().optional(),type:e.z.string().optional(),serverSide:e.z.boolean().optional(),fieldRef:f.optional(),optionQuery:Re.optional(),bindings:e.z.array(je),appliesToViewIds:e.z.array(e.z.string()),notAppliedToViewIds:e.z.array(e.z.string())}).passthrough(),si=e.z.object({schemaVersion:e.z.literal(j),title:e.z.string(),purpose:e.z.string().optional(),userGoal:e.z.string().optional(),nextStep:e.z.string().optional(),sources:e.z.array(J),inputs:e.z.array(Xt),views:e.z.array(ti),filterContracts:e.z.array(ii),implementationChecklist:e.z.object({schemaVersion:e.z.string().optional(),requiredDevtools:e.z.object({mountRootDevtools:e.z.boolean(),providerDebugBridge:e.z.string().optional(),panelPosition:e.z.string().optional(),forbidden:e.z.array(e.z.string()).optional()}).passthrough(),requiredInputOptions:e.z.array(p),filterScopeByInput:e.z.array(p),bindingsByView:e.z.record(e.z.string(),e.z.array(p)),validationCommands:e.z.array(e.z.string()),browserSmokeChecks:e.z.array(e.z.string())}).passthrough(),nextRequiredTool:e.z.object({name:e.z.string(),reason:e.z.string().optional()}).optional(),unsupportedInsights:e.z.array(e.z.object({title:e.z.string(),requestedQuestion:e.z.string(),reason:e.z.string(),suggestedModelingFix:e.z.string()}).passthrough()).optional(),assumptions:e.z.array(e.z.string()).optional(),validation:p.optional()}).passthrough().superRefine((o,i)=>{const t=L(o);for(const s of t.issues)i.addIssue({code:e.z.ZodIssueCode.custom,message:s})}),oi=new Set(Object.keys(E));function ni(){return Object.keys(E)}function Ce(o){return oi.has(o)}function ri(o){if(!o||typeof o!="object"||Array.isArray(o))throw new Error("Semaphor analyze result must be an object.");const t=Object.keys(o).filter(s=>!Ce(s));if(t.length)throw new Error(`Semaphor analyze result contains unsupported top-level field(s): ${t.join(", ")}.`);return _e.parse(o)}exports.SEMAPHOR_ANALYZE_RESULT_FIELD_CONTRACT=E;exports.SEMAPHOR_DATA_APP_CODEGEN_SUMMARY_SCHEMA_VERSION=j;exports.SEMAPHOR_DATA_APP_CODEGEN_SUMMARY_VALIDATOR_VERSION=qe;exports.getSemaphorAnalyzeResultFieldNames=ni;exports.isSemaphorAnalyzeResultFieldName=Ce;exports.isSemaphorDataAppCodegenSummary=Pe;exports.parseSemaphorAnalyzeResult=ri;exports.semaphorAnalyticsCoverageSchema=W;exports.semaphorAnalyticsDiagnosticFeedbackSchema=Y;exports.semaphorAnalyticsExecutionResultSchema=Ae;exports.semaphorAnalyticsPopulationSchema=Z;exports.semaphorAnalyticsResultSchema=we;exports.semaphorAnalyticsValidationIssueSchema=q;exports.semaphorAnalyticsValidationResultSchema=Q;exports.semaphorAnalyzeResultSchema=_e;exports.semaphorAnalyzeResultShape=Ie;exports.semaphorDataAppCodegenSummarySchema=si;exports.semaphorDerivedFieldDefinitionSchema=H;exports.semaphorExecutionFieldRefSchema=O;exports.semaphorFieldRefSchema=y;exports.semaphorInputOptionsResultSchema=Se;exports.semaphorMatrixResultSchema=$e;exports.semaphorMetricResultSchema=be;exports.semaphorPhysicalSourceRefSchema=he;exports.semaphorRecordsResultSchema=ze;exports.semaphorRelationshipDiagnosticsSchema=ke;exports.semaphorResultColumnSchema=C;exports.semaphorSemanticSourceRefSchema=U;exports.semaphorSourceRefSchema=z;exports.semaphorSqlResultSchema=ve;exports.semaphorSqlSourceRefSchema=fe;exports.validateSemaphorDataAppCodegenSummary=L;