react-semaphor 0.1.507 → 0.1.508

package/dist/data-app-sdk-adapters/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const y=require("../chunks/operators-DEfKaU_V.cjs"),l=require("../chunks/validators-DVYAnnX0.cjs");require("../chunks/matrix-operation-contract-D9dLX-Wr.cjs");function g(i){var e,r,o;const t=b(i);return{version:1,kind:"metric",id:i.id,label:i.label,source:h(i),measures:t,primaryMeasure:M(i,t),dateField:i.dateField?a(i.dateField,"date"):void 0,timeGrain:i.timeGrain,dimensions:(e=i.dimensions)==null?void 0:e.map(n=>a(n,"dimension")),comparison:$(i.comparison),orderBy:i.orderBy?{field:a(i.orderBy.field),direction:i.orderBy.direction}:void 0,inputs:u(i.inputs),...(r=i.filters)!=null&&r.length?{filters:i.filters}:{},...i.relationshipHint?{relationshipHint:i.relationshipHint}:{},limit:i.limit,...(o=i.derivedFields)!=null&&o.length?{derivedFields:i.derivedFields}:{}}}function v(i){return{...g(i),...i.timeWindow?{timeWindow:i.timeWindow}:{},...i.analysis?{analysis:i.analysis}:{}}}function F(i){return{...i.chartTitle?{chartTitle:i.chartTitle}:{},...i.chartType?{chartType:i.chartType}:{},...i.driverMode?{driverMode:i.driverMode}:{},...i.includePopulation!==void 0?{includePopulation:i.includePopulation}:{},...i.calendarContext?{calendarContext:i.calendarContext}:{}}}function M(i,t){if(!i.primaryMeasure)return t[0]||{name:"",role:"measure"};const e=a(i.primaryMeasure,"measure"),r=H(e,t),o=r.length===1?r[0]:void 0;return o?p(e,o):e}function b(i){const t=[];for(const e of i.measures.map(r=>a(r,"measure"))){if(!e.name)continue;const r=t.findIndex(o=>R(o,e));if(r===-1){t.push(e);continue}t[r]=p(t[r],e)}return t}function R(i,t){return l.semaphorFieldRefsMatch(i,t)&&d(i)===d(t)}function w(i,t){return d(t)===d(i)}function k(i,t){return t.name!==i.name||i.source&&!l.semaphorFieldRefsMatch(t,i)?!1:w(i,t)}function H(i,t){const e=t.filter(r=>k(i,r));return i.aggregate!==void 0,e}function d(i){return l.semaphorMetricAggregate(i)}function p(i,t){if(i.aggregate&&t.aggregate&&i.aggregate!==t.aggregate)throw new Error(`Measure "${i.name}" was requested with conflicting aggregate semantics: ${i.aggregate} and ${t.aggregate}.`);return{...l.preferSemaphorFieldRefMetadata(i,t),aggregate:i.aggregate||t.aggregate}}function A(i){var e,r;if("sort"in i)throw new Error("semaphor.records supports orderBy for a single deterministic sort. Multiple sort clauses are not supported by the analytics protocol yet.");if(!E(i))throw new Error("semaphor.records needs at least one field.");const t=B(i.fields);return{version:1,kind:"records",id:i.id,label:i.label,source:h(i),fields:t,dateField:i.dateField?a(i.dateField,"date"):void 0,timeGrain:i.timeGrain,...i.timeWindow?{timeWindow:i.timeWindow}:{},...(e=i.filters)!=null&&e.length?{filters:i.filters}:{},orderBy:i.orderBy?{field:a(i.orderBy.field),direction:i.orderBy.direction}:void 0,inputs:u(i.inputs),...i.relationshipHint?{relationshipHint:i.relationshipHint}:{},limit:i.limit,...i.pagination?{pagination:i.pagination}:{},...i.totals?{totals:{mode:"server",measures:i.totals.measures.map(o=>a(o,"measure"))}}:{},...(r=i.derivedFields)!=null&&r.length?{derivedFields:i.derivedFields}:{}}}function B(i){return i.map(t=>{const e=a(t);if(!e.role)throw new Error(`semaphor.records field "${e.name}" needs an explicit role.`);return e})}function O(i){var e,r,o;const t=h(i);if(t.kind==="sql")throw new Error("semaphor.inputOptions requires a semantic or physical option source.");return{version:1,kind:"inputOptions",id:i.id,label:i.label,inputId:i.inputId,source:t,labelField:a(i.labelField,"dimension"),valueField:a(i.valueField,"dimension"),...i.searchField?{searchField:a(i.searchField,"dimension")}:{},...(e=i.disambiguationFields)!=null&&e.length?{disambiguationFields:i.disambiguationFields.map(n=>a(n,"dimension"))}:{},...i.population?{population:i.population}:{},...i.dependencies?{dependencies:i.dependencies}:{},search:i.search,limit:i.limit,...(r=i.inputs)!=null&&r.length?{inputs:i.inputs.map(n=>m(n))}:{},...(o=i.derivedFields)!=null&&o.length?{derivedFields:i.derivedFields}:{}}}function q(i){var t;return{version:1,kind:"sql",id:i.id,label:i.label,source:i.source,sql:i.sql,...i.defaultParameters?{defaultParameters:i.defaultParameters}:{},...i.pythonCode?{pythonCode:i.pythonCode}:{},...(t=i.fields)!=null&&t.length?{fields:i.fields.map(e=>a(e))}:{},inputs:u(i.inputs),limit:i.limit,...i.pagination?{pagination:i.pagination}:{},rationale:i.rationale}}function P(i){const{id:t,label:e,inputs:r,matrixWindowRequest:o,...n}=i,{queryKind:_,...S}=n;return l.matrixAnalyticalIntentSchema.parse({...S,kind:"matrix"})}function m(i){if("toAnalyticsInput"in i){const n=i.toAnalyticsInput();return{inputId:n.inputId,kind:n.kind,...n.controlRole?{controlRole:n.controlRole}:{},...n.operator?{operator:n.operator}:{},...n.field?{field:n.field}:{},...n.relationshipHint?{relationshipHint:n.relationshipHint}:{}}}if("id"in i){const n=f(i);return{inputId:n.inputId,kind:n.kind,...n.controlRole?{controlRole:n.controlRole}:{},...n.operator?{operator:n.operator}:{},...n.field?{field:n.field}:{},...n.relationshipHint?{relationshipHint:n.relationshipHint}:{}}}const t="kind"in i?i.kind:void 0,e="operator"in i?I(i.operator,i.inputId):void 0,r="controlRole"in i?i.controlRole:"role"in i?i.role:void 0,o=z(r)?r:void 0;return{inputId:i.inputId,...t?{kind:t}:{},...o?{controlRole:o}:{},...e?{operator:e}:{},...i.field?{field:i.field}:{},...i.relationshipHint?{relationshipHint:i.relationshipHint}:{}}}function z(i){return i==="grain"||i==="measure"||i==="dimension"||i==="aggregation"||i==="sqlParam"}function C(i){const t=u(i);return t.length>0?t:void 0}function c(i){return(i||[]).map(W)}function T(i){return c(i).filter(t=>t.isActive)}function f(i){if(i.kind==="filter"){const t=I(i.operator,i.id);return{inputId:i.id,kind:i.kind,label:i.label,field:a(i.field,"dimension"),operator:t||"in",...i.relationshipHint?{relationshipHint:i.relationshipHint}:{}}}return{inputId:i.id,kind:i.kind,label:i.label,controlRole:i.role}}function x(i=[]){return i.map(t=>typeof t=="object"?t:{label:String(t),value:t})}function s(i){return i==null?!1:Array.isArray(i)?i.length>0:typeof i=="string"?i.trim().length>0:!0}function W(i){if("toAnalyticsInput"in i)return i.toAnalyticsInput();if("kind"in i&&"isActive"in i)return i;if("id"in i){const t=f(i),e=Object.prototype.hasOwnProperty.call(i,"value")?i.value:i.defaultValue;return{inputId:t.inputId,kind:t.kind,label:t.label,...t.field?{field:t.field}:{},...t.operator?{operator:t.operator}:{},...t.controlRole?{controlRole:t.controlRole}:{},...t.relationshipHint?{relationshipHint:t.relationshipHint}:{},value:e,isActive:s(e)}}return{...i,kind:"filter",isActive:s(i.value),value:i.value}}function h(i){return i.source}function E(i){var t;return!!((t=i.fields)!=null&&t.length)}function a(i,t){return{...i,role:i.role||t}}function u(i){return(i||[]).map(m)}function $(i){if(i)return i}function I(i,t){if(i===void 0)return;const e=y.normalizeSemaphorInputOperator(i);if(!e)throw new Error(`useSemaphorInput "${t}" uses unsupported filter operator "${i}".`);return e}exports.hasSemaphorInputValue=s;exports.normalizeSemaphorInputOptions=x;exports.toSemaphorActiveInputSnapshots=T;exports.toSemaphorAnalysisIntent=v;exports.toSemaphorAnalysisQueryOptions=F;exports.toSemaphorInputBinding=m;exports.toSemaphorInputBindings=C;exports.toSemaphorInputOptionsIntent=O;exports.toSemaphorInputSnapshots=c;exports.toSemaphorInputSpec=f;exports.toSemaphorMatrixIntent=P;exports.toSemaphorMetricIntent=g;exports.toSemaphorRecordsIntent=A;exports.toSemaphorSqlIntent=q;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const v=require("../chunks/operators-DEfKaU_V.cjs"),l=require("../chunks/validators-DVYAnnX0.cjs"),g=require("../chunks/matrix-operation-contract-DoiWTUbT.cjs");function p(t){var e,r,o;const i=R(t);return{version:1,kind:"metric",id:t.id,label:t.label,source:f(t),measures:i,primaryMeasure:b(t,i),dateField:t.dateField?a(t.dateField,"date"):void 0,timeGrain:t.timeGrain,dimensions:(e=t.dimensions)==null?void 0:e.map(n=>a(n,"dimension")),comparison:G(t.comparison),orderBy:t.orderBy?{field:a(t.orderBy.field),direction:t.orderBy.direction}:void 0,inputs:s(t.inputs),...(r=t.filters)!=null&&r.length?{filters:t.filters}:{},...t.relationshipHint?{relationshipHint:t.relationshipHint}:{},limit:t.limit,...(o=t.derivedFields)!=null&&o.length?{derivedFields:t.derivedFields}:{}}}function F(t){return{...p(t),...t.timeWindow?{timeWindow:t.timeWindow}:{},...t.analysis?{analysis:t.analysis}:{}}}function M(t){return{...t.chartTitle?{chartTitle:t.chartTitle}:{},...t.chartType?{chartType:t.chartType}:{},...t.driverMode?{driverMode:t.driverMode}:{},...t.includePopulation!==void 0?{includePopulation:t.includePopulation}:{},...t.calendarContext?{calendarContext:t.calendarContext}:{}}}function b(t,i){if(!t.primaryMeasure)return i[0]||{name:"",role:"measure"};const e=a(t.primaryMeasure,"measure"),r=H(e,i),o=r.length===1?r[0]:void 0;return o?c(e,o):e}function R(t){const i=[];for(const e of t.measures.map(r=>a(r,"measure"))){if(!e.name)continue;const r=i.findIndex(o=>w(o,e));if(r===-1){i.push(e);continue}i[r]=c(i[r],e)}return i}function w(t,i){return l.semaphorFieldRefsMatch(t,i)&&d(t)===d(i)}function A(t,i){return d(i)===d(t)}function k(t,i){return i.name!==t.name||t.source&&!l.semaphorFieldRefsMatch(i,t)?!1:A(t,i)}function H(t,i){const e=i.filter(r=>k(t,r));return t.aggregate!==void 0,e}function d(t){return l.semaphorMetricAggregate(t)}function c(t,i){if(t.aggregate&&i.aggregate&&t.aggregate!==i.aggregate)throw new Error(`Measure "${t.name}" was requested with conflicting aggregate semantics: ${t.aggregate} and ${i.aggregate}.`);return{...l.preferSemaphorFieldRefMetadata(t,i),aggregate:t.aggregate||i.aggregate}}function B(t){var e,r;if("sort"in t)throw new Error("semaphor.records supports orderBy for a single deterministic sort. Multiple sort clauses are not supported by the analytics protocol yet.");if(!_(t))throw new Error("semaphor.records needs at least one field.");const i=O(t.fields);return{version:1,kind:"records",id:t.id,label:t.label,source:f(t),fields:i,dateField:t.dateField?a(t.dateField,"date"):void 0,timeGrain:t.timeGrain,...t.timeWindow?{timeWindow:t.timeWindow}:{},...(e=t.filters)!=null&&e.length?{filters:t.filters}:{},orderBy:t.orderBy?{field:a(t.orderBy.field),direction:t.orderBy.direction}:void 0,inputs:s(t.inputs),...t.relationshipHint?{relationshipHint:t.relationshipHint}:{},limit:t.limit,...t.pagination?{pagination:t.pagination}:{},...t.totals?{totals:{mode:"server",measures:t.totals.measures.map(o=>a(o,"measure"))}}:{},...(r=t.derivedFields)!=null&&r.length?{derivedFields:t.derivedFields}:{}}}function O(t){return t.map(i=>{const e=a(i);if(!e.role)throw new Error(`semaphor.records field "${e.name}" needs an explicit role.`);return e})}function q(t){var e,r,o;const i=f(t);if(i.kind==="sql")throw new Error("semaphor.inputOptions requires a semantic or physical option source.");return{version:1,kind:"inputOptions",id:t.id,label:t.label,inputId:t.inputId,source:i,labelField:a(t.labelField,"dimension"),valueField:a(t.valueField,"dimension"),...t.searchField?{searchField:a(t.searchField,"dimension")}:{},...(e=t.disambiguationFields)!=null&&e.length?{disambiguationFields:t.disambiguationFields.map(n=>a(n,"dimension"))}:{},...t.population?{population:t.population}:{},...t.dependencies?{dependencies:t.dependencies}:{},search:t.search,limit:t.limit,...(r=t.inputs)!=null&&r.length?{inputs:t.inputs.map(n=>m(n))}:{},...(o=t.derivedFields)!=null&&o.length?{derivedFields:t.derivedFields}:{}}}function z(t){var i;return{version:1,kind:"sql",id:t.id,label:t.label,source:t.source,sql:t.sql,...t.defaultParameters?{defaultParameters:t.defaultParameters}:{},...t.pythonCode?{pythonCode:t.pythonCode}:{},...(i=t.fields)!=null&&i.length?{fields:t.fields.map(e=>a(e))}:{},inputs:s(t.inputs),limit:t.limit,...t.pagination?{pagination:t.pagination}:{},rationale:t.rationale}}function C(t){const{id:i,label:e,inputs:r,matrixWindowRequest:o,...n}=t,{queryKind:j,...I}=n;return l.matrixAnalyticalIntentSchema.parse({...I,kind:"matrix"})}function m(t){if("toAnalyticsInput"in t){const n=t.toAnalyticsInput();return{inputId:n.inputId,kind:n.kind,...n.controlRole?{controlRole:n.controlRole}:{},...n.operator?{operator:n.operator}:{},...n.field?{field:n.field}:{},...n.relationshipHint?{relationshipHint:n.relationshipHint}:{}}}if("id"in t){const n=h(t);return{inputId:n.inputId,kind:n.kind,...n.controlRole?{controlRole:n.controlRole}:{},...n.operator?{operator:n.operator}:{},...n.field?{field:n.field}:{},...n.relationshipHint?{relationshipHint:n.relationshipHint}:{}}}const i="kind"in t?t.kind:void 0,e="operator"in t?y(t.operator,t.inputId):void 0,r="controlRole"in t?t.controlRole:"role"in t?t.role:void 0,o=P(r)?r:void 0;return{inputId:t.inputId,...i?{kind:i}:{},...o?{controlRole:o}:{},...e?{operator:e}:{},...t.field?{field:t.field}:{},...t.relationshipHint?{relationshipHint:t.relationshipHint}:{}}}function P(t){return t==="grain"||t==="measure"||t==="dimension"||t==="aggregation"||t==="sqlParam"}function x(t){const i=s(t);return i.length>0?i:void 0}function S(t){return(t||[]).map($)}function T(t){return S(t).filter(i=>i.isActive)}function W(t){const i=(t||[]).flatMap(e=>{const r="toAnalyticsSelection"in e?e.toAnalyticsSelection():e;return r?[g.analyticsSelectionSchema.parse(r)]:[]});return g.canonicalizeAnalyticsSelections(i)}function h(t){if(t.kind==="filter"){const i=y(t.operator,t.id);return{inputId:t.id,kind:t.kind,label:t.label,field:a(t.field,"dimension"),operator:i||"in",...t.relationshipHint?{relationshipHint:t.relationshipHint}:{}}}return{inputId:t.id,kind:t.kind,label:t.label,controlRole:t.role}}function E(t=[]){return t.map(i=>typeof i=="object"?i:{label:String(i),value:i})}function u(t){return t==null?!1:Array.isArray(t)?t.length>0:typeof t=="string"?t.trim().length>0:!0}function $(t){if("toAnalyticsInput"in t)return t.toAnalyticsInput();if("kind"in t&&"isActive"in t)return t;if("id"in t){const i=h(t),e=Object.prototype.hasOwnProperty.call(t,"value")?t.value:t.defaultValue;return{inputId:i.inputId,kind:i.kind,label:i.label,...i.field?{field:i.field}:{},...i.operator?{operator:i.operator}:{},...i.controlRole?{controlRole:i.controlRole}:{},...i.relationshipHint?{relationshipHint:i.relationshipHint}:{},value:e,isActive:u(e)}}return{...t,kind:"filter",isActive:u(t.value),value:t.value}}function f(t){return t.source}function _(t){var i;return!!((i=t.fields)!=null&&i.length)}function a(t,i){return{...t,role:t.role||i}}function s(t){return(t||[]).map(m)}function G(t){if(t)return t}function y(t,i){if(t===void 0)return;const e=v.normalizeSemaphorInputOperator(t);if(!e)throw new Error(`useSemaphorInput "${i}" uses unsupported filter operator "${t}".`);return e}exports.hasSemaphorInputValue=u;exports.normalizeSemaphorInputOptions=E;exports.toSemaphorActiveInputSnapshots=T;exports.toSemaphorAnalysisIntent=F;exports.toSemaphorAnalysisQueryOptions=M;exports.toSemaphorInputBinding=m;exports.toSemaphorInputBindings=x;exports.toSemaphorInputOptionsIntent=q;exports.toSemaphorInputSnapshots=S;exports.toSemaphorInputSpec=h;exports.toSemaphorMatrixIntent=C;exports.toSemaphorMetricIntent=p;exports.toSemaphorRecordsIntent=B;exports.toSemaphorSelectionSnapshots=W;exports.toSemaphorSqlIntent=z;

package/dist/data-app-sdk-adapters/index.js

@@ -1,21 +1,21 @@
 import { n as y } from "../chunks/operators-B3zZoskU.js";
 import { m as v, k as m, p as I, l as S } from "../chunks/validators-BDYzZFgs.js";
-import "../chunks/matrix-operation-contract-Cqy4EW2H.js";
-function F(i) {
-  var e, r, o;
-  const t = w(i);
+import { b as F, c as b } from "../chunks/matrix-operation-contract-xL8IhFzp.js";
+function w(i) {
+  var n, r, o;
+  const t = R(i);
   return {
     version: 1,
     kind: "metric",
     id: i.id,
     label: i.label,
-    source: u(i),
+    source: s(i),
     measures: t,
-    primaryMeasure: b(i, t),
+    primaryMeasure: M(i, t),
     dateField: i.dateField ? a(i.dateField, "date") : void 0,
     timeGrain: i.timeGrain,
-    dimensions: (e = i.dimensions) == null ? void 0 : e.map((n) => a(n, "dimension")),
-    comparison: z(i.comparison),
+    dimensions: (n = i.dimensions) == null ? void 0 : n.map((e) => a(e, "dimension")),
+    comparison: x(i.comparison),
     orderBy: i.orderBy ? {
       field: a(i.orderBy.field),
       direction: i.orderBy.direction
@@ -27,14 +27,14 @@ function F(i) {
     ...(o = i.derivedFields) != null && o.length ? { derivedFields: i.derivedFields } : {}
   };
 }
-function E(i) {
+function _(i) {
   return {
-    ...F(i),
+    ...w(i),
     ...i.timeWindow ? { timeWindow: i.timeWindow } : {},
     ...i.analysis ? { analysis: i.analysis } : {}
   };
 }
-function $(i) {
+function G(i) {
   return {
     ...i.chartTitle ? { chartTitle: i.chartTitle } : {},
     ...i.chartType ? { chartType: i.chartType } : {},
@@ -43,47 +43,47 @@ function $(i) {
     ...i.calendarContext ? { calendarContext: i.calendarContext } : {}
   };
 }
-function b(i, t) {
+function M(i, t) {
   if (!i.primaryMeasure)
     return t[0] || { name: "", role: "measure" };
-  const e = a(i.primaryMeasure, "measure"), r = H(e, t), o = r.length === 1 ? r[0] : void 0;
-  return o ? f(e, o) : e;
+  const n = a(i.primaryMeasure, "measure"), r = B(n, t), o = r.length === 1 ? r[0] : void 0;
+  return o ? f(n, o) : n;
 }
-function w(i) {
+function R(i) {
   const t = [];
-  for (const e of i.measures.map(
+  for (const n of i.measures.map(
     (r) => a(r, "measure")
   )) {
-    if (!e.name)
+    if (!n.name)
       continue;
     const r = t.findIndex(
-      (o) => R(o, e)
+      (o) => k(o, n)
     );
     if (r === -1) {
-      t.push(e);
+      t.push(n);
       continue;
     }
     t[r] = f(
       t[r],
-      e
+      n
     );
   }
   return t;
 }
-function R(i, t) {
+function k(i, t) {
   return m(i, t) && l(i) === l(t);
 }
-function M(i, t) {
+function H(i, t) {
   return l(t) === l(i);
 }
-function k(i, t) {
-  return t.name !== i.name || i.source && !m(t, i) ? !1 : M(i, t);
+function A(i, t) {
+  return t.name !== i.name || i.source && !m(t, i) ? !1 : H(i, t);
 }
-function H(i, t) {
-  const e = t.filter(
-    (r) => k(i, r)
+function B(i, t) {
+  const n = t.filter(
+    (r) => A(i, r)
   );
-  return i.aggregate !== void 0, e;
+  return i.aggregate !== void 0, n;
 }
 function l(i) {
   return S(i);
@@ -98,26 +98,26 @@ function f(i, t) {
     aggregate: i.aggregate || t.aggregate
   };
 }
-function _(i) {
-  var e, r;
+function j(i) {
+  var n, r;
   if ("sort" in i)
     throw new Error(
       "semaphor.records supports orderBy for a single deterministic sort. Multiple sort clauses are not supported by the analytics protocol yet."
     );
-  if (!P(i))
+  if (!q(i))
     throw new Error("semaphor.records needs at least one field.");
-  const t = A(i.fields);
+  const t = O(i.fields);
   return {
     version: 1,
     kind: "records",
     id: i.id,
     label: i.label,
-    source: u(i),
+    source: s(i),
     fields: t,
     dateField: i.dateField ? a(i.dateField, "date") : void 0,
     timeGrain: i.timeGrain,
     ...i.timeWindow ? { timeWindow: i.timeWindow } : {},
-    ...(e = i.filters) != null && e.length ? { filters: i.filters } : {},
+    ...(n = i.filters) != null && n.length ? { filters: i.filters } : {},
     orderBy: i.orderBy ? {
       field: a(i.orderBy.field),
       direction: i.orderBy.direction
@@ -137,19 +137,19 @@ function _(i) {
     ...(r = i.derivedFields) != null && r.length ? { derivedFields: i.derivedFields } : {}
   };
 }
-function A(i) {
+function O(i) {
   return i.map((t) => {
-    const e = a(t);
-    if (!e.role)
+    const n = a(t);
+    if (!n.role)
       throw new Error(
-        `semaphor.records field "${e.name}" needs an explicit role.`
+        `semaphor.records field "${n.name}" needs an explicit role.`
       );
-    return e;
+    return n;
   });
 }
-function G(i) {
-  var e, r, o;
-  const t = u(i);
+function K(i) {
+  var n, r, o;
+  const t = s(i);
   if (t.kind === "sql")
     throw new Error(
       "semaphor.inputOptions requires a semantic or physical option source."
@@ -164,20 +164,20 @@ function G(i) {
     labelField: a(i.labelField, "dimension"),
     valueField: a(i.valueField, "dimension"),
     ...i.searchField ? { searchField: a(i.searchField, "dimension") } : {},
-    ...(e = i.disambiguationFields) != null && e.length ? {
+    ...(n = i.disambiguationFields) != null && n.length ? {
       disambiguationFields: i.disambiguationFields.map(
-        (n) => a(n, "dimension")
+        (e) => a(e, "dimension")
       )
     } : {},
     ...i.population ? { population: i.population } : {},
     ...i.dependencies ? { dependencies: i.dependencies } : {},
     search: i.search,
     limit: i.limit,
-    ...(r = i.inputs) != null && r.length ? { inputs: i.inputs.map((n) => h(n)) } : {},
+    ...(r = i.inputs) != null && r.length ? { inputs: i.inputs.map((e) => h(e)) } : {},
     ...(o = i.derivedFields) != null && o.length ? { derivedFields: i.derivedFields } : {}
   };
 }
-function j(i) {
+function V(i) {
   var t;
   return {
     version: 1,
@@ -188,62 +188,69 @@ function j(i) {
     sql: i.sql,
     ...i.defaultParameters ? { defaultParameters: i.defaultParameters } : {},
     ...i.pythonCode ? { pythonCode: i.pythonCode } : {},
-    ...(t = i.fields) != null && t.length ? { fields: i.fields.map((e) => a(e)) } : {},
+    ...(t = i.fields) != null && t.length ? { fields: i.fields.map((n) => a(n)) } : {},
     inputs: d(i.inputs),
     limit: i.limit,
     ...i.pagination ? { pagination: i.pagination } : {},
     rationale: i.rationale
   };
 }
-function K(i) {
-  const { id: t, label: e, inputs: r, matrixWindowRequest: o, ...n } = i, { queryKind: q, ...p } = n;
+function Q(i) {
+  const { id: t, label: n, inputs: r, matrixWindowRequest: o, ...e } = i, { queryKind: T, ...p } = e;
   return v.parse({ ...p, kind: "matrix" });
 }
 function h(i) {
   if ("toAnalyticsInput" in i) {
-    const n = i.toAnalyticsInput();
+    const e = i.toAnalyticsInput();
     return {
-      inputId: n.inputId,
-      kind: n.kind,
-      ...n.controlRole ? { controlRole: n.controlRole } : {},
-      ...n.operator ? { operator: n.operator } : {},
-      ...n.field ? { field: n.field } : {},
-      ...n.relationshipHint ? { relationshipHint: n.relationshipHint } : {}
+      inputId: e.inputId,
+      kind: e.kind,
+      ...e.controlRole ? { controlRole: e.controlRole } : {},
+      ...e.operator ? { operator: e.operator } : {},
+      ...e.field ? { field: e.field } : {},
+      ...e.relationshipHint ? { relationshipHint: e.relationshipHint } : {}
     };
   }
   if ("id" in i) {
-    const n = g(i);
+    const e = g(i);
     return {
-      inputId: n.inputId,
-      kind: n.kind,
-      ...n.controlRole ? { controlRole: n.controlRole } : {},
-      ...n.operator ? { operator: n.operator } : {},
-      ...n.field ? { field: n.field } : {},
-      ...n.relationshipHint ? { relationshipHint: n.relationshipHint } : {}
+      inputId: e.inputId,
+      kind: e.kind,
+      ...e.controlRole ? { controlRole: e.controlRole } : {},
+      ...e.operator ? { operator: e.operator } : {},
+      ...e.field ? { field: e.field } : {},
+      ...e.relationshipHint ? { relationshipHint: e.relationshipHint } : {}
     };
   }
-  const t = "kind" in i ? i.kind : void 0, e = "operator" in i ? c(i.operator, i.inputId) : void 0, r = "controlRole" in i ? i.controlRole : "role" in i ? i.role : void 0, o = B(r) ? r : void 0;
+  const t = "kind" in i ? i.kind : void 0, n = "operator" in i ? c(i.operator, i.inputId) : void 0, r = "controlRole" in i ? i.controlRole : "role" in i ? i.role : void 0, o = z(r) ? r : void 0;
   return {
     inputId: i.inputId,
     ...t ? { kind: t } : {},
     ...o ? { controlRole: o } : {},
-    ...e ? { operator: e } : {},
+    ...n ? { operator: n } : {},
     ...i.field ? { field: i.field } : {},
     ...i.relationshipHint ? { relationshipHint: i.relationshipHint } : {}
   };
 }
-function B(i) {
+function z(i) {
   return i === "grain" || i === "measure" || i === "dimension" || i === "aggregation" || i === "sqlParam";
 }
-function V(i) {
+function D(i) {
   const t = d(i);
   return t.length > 0 ? t : void 0;
 }
-function O(i) {
-  return (i || []).map(C);
+function C(i) {
+  return (i || []).map(P);
 }
-function Q(i) {
-  return O(i).filter((t) => t.isActive);
+function J(i) {
+  return C(i).filter((t) => t.isActive);
+}
+function L(i) {
+  const t = (i || []).flatMap((n) => {
+    const r = "toAnalyticsSelection" in n ? n.toAnalyticsSelection() : n;
+    return r ? [F.parse(r)] : [];
+  });
+  return b(t);
 }
 function g(i) {
   if (i.kind === "filter") {
@@ -264,7 +271,7 @@ function g(i) {
     controlRole: i.role
   };
 }
-function D(i = []) {
+function N(i = []) {
   return i.map(
     (t) => typeof t == "object" ? t : {
       label: String(t),
@@ -272,16 +279,16 @@ function D(i = []) {
     }
   );
 }
-function s(i) {
+function u(i) {
   return i == null ? !1 : Array.isArray(i) ? i.length > 0 : typeof i == "string" ? i.trim().length > 0 : !0;
 }
-function C(i) {
+function P(i) {
   if ("toAnalyticsInput" in i)
     return i.toAnalyticsInput();
   if ("kind" in i && "isActive" in i)
     return i;
   if ("id" in i) {
-    const t = g(i), e = Object.prototype.hasOwnProperty.call(i, "value") ? i.value : i.defaultValue;
+    const t = g(i), n = Object.prototype.hasOwnProperty.call(i, "value") ? i.value : i.defaultValue;
     return {
       inputId: t.inputId,
       kind: t.kind,
@@ -290,23 +297,23 @@ function C(i) {
       ...t.operator ? { operator: t.operator } : {},
       ...t.controlRole ? { controlRole: t.controlRole } : {},
       ...t.relationshipHint ? { relationshipHint: t.relationshipHint } : {},
-      value: e,
-      isActive: s(e)
+      value: n,
+      isActive: u(n)
     };
   }
   return {
     ...i,
     kind: "filter",
-    isActive: s(
+    isActive: u(
       i.value
     ),
     value: i.value
   };
 }
-function u(i) {
+function s(i) {
   return i.source;
 }
-function P(i) {
+function q(i) {
   var t;
   return !!((t = i.fields) != null && t.length);
 }
@@ -319,33 +326,34 @@ function a(i, t) {
 function d(i) {
   return (i || []).map(h);
 }
-function z(i) {
+function x(i) {
   if (i)
     return i;
 }
 function c(i, t) {
   if (i === void 0)
     return;
-  const e = y(i);
-  if (!e)
+  const n = y(i);
+  if (!n)
     throw new Error(
       `useSemaphorInput "${t}" uses unsupported filter operator "${i}".`
     );
-  return e;
+  return n;
 }
 export {
-  s as hasSemaphorInputValue,
-  D as normalizeSemaphorInputOptions,
-  Q as toSemaphorActiveInputSnapshots,
-  E as toSemaphorAnalysisIntent,
-  $ as toSemaphorAnalysisQueryOptions,
+  u as hasSemaphorInputValue,
+  N as normalizeSemaphorInputOptions,
+  J as toSemaphorActiveInputSnapshots,
+  _ as toSemaphorAnalysisIntent,
+  G as toSemaphorAnalysisQueryOptions,
   h as toSemaphorInputBinding,
-  V as toSemaphorInputBindings,
-  G as toSemaphorInputOptionsIntent,
-  O as toSemaphorInputSnapshots,
+  D as toSemaphorInputBindings,
+  K as toSemaphorInputOptionsIntent,
+  C as toSemaphorInputSnapshots,
   g as toSemaphorInputSpec,
-  K as toSemaphorMatrixIntent,
-  F as toSemaphorMetricIntent,
-  _ as toSemaphorRecordsIntent,
-  j as toSemaphorSqlIntent
+  Q as toSemaphorMatrixIntent,
+  w as toSemaphorMetricIntent,
+  j as toSemaphorRecordsIntent,
+  L as toSemaphorSelectionSnapshots,
+  V as toSemaphorSqlIntent
 };

package/dist/data-app-sdk-validation/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const d=require("../chunks/validators-DVYAnnX0.cjs"),N=require("../chunks/matrix-operation-contract-D9dLX-Wr.cjs"),E=require("../chunks/report-runtime-context-DzvHBPxl.cjs"),K=require("../chunks/source-entity-resolution-CjbgnwyX.cjs"),y=require("../data-app-sdk-adapters/index.cjs"),Q=require("../chunks/matrix-card-CRXcmAjp.cjs");function W({intent:e,field:r,catalogField:t,relativePath:o}){const i=J({intent:e,field:r,relativePath:o});if(!i||i.allowedRelatedRoles.length===0)return!1;const n=I(r,i.selectedField),s=$(t),c=h(n);return P(s,i.allowedRelatedRoles)?c===s:!1}function U(e){return e.kind==="records"?L(e):e.kind==="metric"?X(e):[]}function $(e){const r=d.normalizeAnalyticsCatalogName(e.role);if(r==="measure")return"measure";if(r==="id")return"id";const t=d.normalizeAnalyticsCatalogDataType(e.dataType);if(r==="date"||t==="date"||t==="datetime")return"date";if(r==="dimension")return"dimension"}function P(e,r){return!!(e&&r.includes(e))}function I(e,r){const t=h(e);if(t)return e.role===t?e:{...e,role:t};const o=r?h(r):void 0;return o?{...e,role:o}:e}function v(e,r){return e.find(t=>T(t,r))}function J({intent:e,field:r,relativePath:t}){if(e.kind==="records")return V(e,r,t);if(e.kind==="metric")return G(e,r,t)}function V(e,r,t){if(t.startsWith("spec.fields."))return{allowedRelatedRoles:["dimension","date","id"]};if(t==="spec.dateField"&&!e.timeWindow)return{allowedRelatedRoles:["date"]};if(t==="spec.orderBy.field"){const o=v(H(e),r);return{selectedField:o,allowedRelatedRoles:o?k(o):[]}}}function G(e,r,t){if(t.startsWith("spec.dimensions."))return{allowedRelatedRoles:["dimension"]};if(t==="spec.orderBy.field"){const o=v(e.dimensions||[],r);return{selectedField:o,allowedRelatedRoles:o?["dimension"]:[]}}}function L(e){var o,i;const r=H(e),t=(o=e.orderBy)!=null&&o.field?v(r,e.orderBy.field):void 0;return b([...r.map(n=>p(n,k(n))),...(i=e.orderBy)!=null&&i.field?[p(I(e.orderBy.field,t),t?k(t):[],{unsupportedRelatedRoleMessage:"Joined records projections support related sort fields only when the same related field is included in spec.fields.",recommendedNextStep:"Add the related sort field to spec.fields, or keep orderBy fields on the base source."})]:[]])}function X(e){var t,o;const r=(t=e.orderBy)!=null&&t.field?v(e.dimensions||[],e.orderBy.field):void 0;return b([...e.measures.map(i=>p(i,[])),...e.primaryMeasure?[p(e.primaryMeasure,[])]:[],...(e.dimensions||[]).map(i=>p(i,["dimension"])),...e.dateField?[p({...e.dateField,role:"date"},[])]:[],...(o=e.orderBy)!=null&&o.field?[p(I(e.orderBy.field,r),r?["dimension"]:[],{unsupportedRelatedRoleMessage:"Joined metric projections support related orderBy fields only when the same related field is declared in spec.dimensions.",recommendedNextStep:"Add the related field as a metric dimension when it should participate in the grouped result, or keep orderBy fields on the base source."})]:[]])}function k(e){const r=e?h(e):void 0;return r==="dimension"?["dimension"]:r==="date"?["date"]:r==="id"?["id"]:["dimension","date","id"]}function p(e,r,t={}){return{field:I(e),allowedRelatedRoles:r,...t}}function b(e){const r=[];return e.forEach(t=>{r.some(o=>Y(o,t))||r.push(t)}),r}function H(e){const r=[...e.fields];return e.dateField&&!r.some(t=>w(t,e.dateField))&&r.push({...e.dateField,role:"date"}),r}function Y(e,r){return T(e.field,r.field)&&e.allowedRelatedRoles.join("|")===r.allowedRelatedRoles.join("|")&&(e.unsupportedRelatedRoleMessage||"")===(r.unsupportedRelatedRoleMessage||"")&&(e.recommendedNextStep||"")===(r.recommendedNextStep||"")}function w(e,r){return d.semaphorFieldRefsMatch(e,r)}function T(e,r){return w(e,r)&&Z(h(e),h(r))}function Z(e,r){return!!(e&&(!r||e===r))}function h(e){return $(e)}function j({intent:e,field:r,relativePath:t,baseCatalog:o,fieldCatalogs:i}){const n=g(r,e.source),s=d.semaphorSourcesReferToSameDataset(n,e.source);if(e.kind!=="matrix"&&!s&&!re(e.source,n))return{ok:!1,code:"invalid_source_ref",message:`Field "${r.name}" references a related Semaphor source outside the query's semantic domain.`,pathSuffix:".source",source:n};const c=s?o:S(i,n);if(!c)return{ok:!1,code:"invalid_source_ref",message:`Field "${r.name}" references a Semaphor source that is not present in the visible field catalog.`,pathSuffix:".source",source:n};const a=q(c,r,e.source);return a?e.kind!=="matrix"&&!s&&!ee({intent:e,field:r,catalogField:a,relativePath:t})?{ok:!1,code:"unsupported_joined_projection",message:`Field "${r.name}" references a related Semaphor source, but this query kind does not support joined projections for that field yet.`,pathSuffix:".source",source:n}:{ok:!0,source:n,catalogField:a,usesBaseSource:s}:{ok:!1,code:"missing_field",message:`Field "${r.name}" is not visible on the selected Semaphor source.`,source:n}}function ee({intent:e,field:r,catalogField:t,relativePath:o}){return W({intent:e,field:r,catalogField:t,relativePath:o})}function re(e,r){return e.kind==="semantic"&&r.kind==="semantic"&&e.domainId===r.domainId}function S(e,r){return e.find(t=>F(t,r))}function q(e,r,t){const o=g(r,t);if(F(e,o))return e.fields.find(i=>te(i,r)&&F(e,g(i,e.source)))}function R(e){return d.normalizeAnalyticsCatalogName(e)}function g(e,r){return e.source||r}function F(e,r){return[e.source,...e.sourceAliases||[]].some(t=>d.semaphorSourcesReferToSameDataset(t,r))}function te(e,r){return!!(e.name&&r.name&&e.name===r.name)}function oe(e){const r=[];if(!e.intent.filters)return r;const t=e.intent.source,i=d.mergeSemaphorSourcesByIdentity(e.fieldCatalogs.flatMap(a=>[a.source,...a.sourceAliases??[]])).filter(a=>t.kind==="semantic"?a.kind==="semantic"&&a.domainId===t.domainId:a.kind==="physical"&&a.connectionId===t.connectionId).map(a=>a.kind==="semantic"?{type:"dataset",name:a.datasetName,id:a.datasetId,domainId:a.domainId,connectionId:a.connectionId}:{type:"table",name:a.tableName,database:a.databaseName,schema:a.schemaName,connectionId:a.connectionId,connectionType:a.connectionType,dialect:a.dialect}),n=(a,u)=>{r.push({field:a,path:u,validation:j({...e,field:a,relativePath:u})})},s=(a,u)=>{if(a.derivedField)Object.entries(a.derivedField.inputs).forEach(([l,f])=>n(f.field,`${u}.derivedField.inputs.${l}.field`));else if(a.calculatedFormula)a.calculatedFormula.inputFields.forEach((l,f)=>s(l,`${u}.calculatedFormula.inputFields.${f}`));else{const l=K.resolveSemaphorSourceEntity({entities:i,semanticDomainId:t.kind==="semantic"?t.domainId:void 0,connectionId:t.connectionId,connectionType:t.kind==="physical"?t.connectionType:void 0,dialect:t.kind==="physical"?t.dialect:void 0,fieldEntityType:a.entityType,entityId:a.entityId,entityName:a.entityName,qualifiedHints:[a.qualifiedEntityName]});l.kind==="resolved"?n({name:a.name,source:l.source},u):r.push({field:{name:a.name},path:u,validation:{ok:!1,code:"invalid_source_ref",source:t,message:`Filter field "${a.name}" has no unambiguous source in the visible field catalog (${l.kind}).`}})}},c=(a,u)=>{a.conditions.forEach((l,f)=>s(l.field,`${u}.conditions.${f}.field`)),a.groups.forEach((l,f)=>c(l,`${u}.groups.${f}`))};return c(e.intent.filters,"spec.filters"),r}function M(e,r={}){const t=r.pathPrefix||"analysisOptions";if(e===void 0)return{ok:!0};if(!e||typeof e!="object"||Array.isArray(e))return m(t,"Data App analysis options must be an object.");const o=e,i={};if(o.chartTitle!==void 0){if(typeof o.chartTitle!="string")return m(`${t}.chartTitle`,'Data App analysis option "chartTitle" must be a string.');i.chartTitle=o.chartTitle}if(o.chartType!==void 0){if(typeof o.chartType!="string")return m(`${t}.chartType`,'Data App analysis option "chartType" must be a string.');i.chartType=o.chartType}if(o.driverMode!==void 0){if(!ne(o.driverMode))return m(`${t}.driverMode`,'Data App analysis option "driverMode" must be absolute_delta, largest_negative, largest_positive, positive_and_negative, or all.');i.driverMode=o.driverMode}if(o.includePopulation!==void 0){if(typeof o.includePopulation!="boolean")return m(`${t}.includePopulation`,'Data App analysis option "includePopulation" must be a boolean.');i.includePopulation=o.includePopulation}if(o.calendarContext!==void 0){const n=se(o.calendarContext,{pathPrefix:`${t}.calendarContext`,validateTimezone:r.validateTimezone});if(!n.ok)return n;i.calendarContext=n.calendarContext}return{ok:!0,analysisOptions:i}}function ie(e){const r=e.queries.map((i,n)=>ae(i,n,{fieldCatalogs:e.fieldCatalogs||[],requireFieldCatalog:!!e.requireFieldCatalog,validateTimezone:e.validateTimezone})),t=r.flatMap(i=>i.diagnostics),o=r.map(i=>i.executionResult);return{ok:t.every(i=>i.severity!=="error"),diagnostics:t,queries:r,intents:r.flatMap(i=>i.intent?[i.intent]:[]),executionResults:o}}function ae(e,r,t){const o=`queries.${r}`;try{const i=de(e),n=ke(e,i),s=d.validateSemaphorAnalyticsIntent(i),c=[...ge({querySpec:e,queryId:n,intent:i,pathPrefix:o}),...s.errors.map(u=>_(u,{queryHook:e.queryHook,queryId:n,pathPrefix:o,severity:"error",intent:i})),...s.warnings.map(u=>_(u,{queryHook:e.queryHook,queryId:n,pathPrefix:o,severity:"warning",intent:i})),...ce({querySpec:e,queryId:n,intent:i,pathPrefix:o,fieldCatalogs:t.fieldCatalogs,requireFieldCatalog:t.requireFieldCatalog}),...he({querySpec:e,queryId:n,intent:i,pathPrefix:o,validateTimezone:t.validateTimezone})],a=Se(s,c);return{queryHook:e.queryHook,queryId:n,intent:i,diagnostics:c,executionResult:x({intent:i,validation:a,diagnostics:c})}}catch(i){const n={severity:"error",code:"invalid_query_spec",message:i instanceof Error?i.message:String(i),path:o,queryHook:e.queryHook,queryId:O(e.spec)},s=z([n]);return{queryHook:e.queryHook,queryId:n.queryId,diagnostics:[n],executionResult:x({validation:s,diagnostics:[n]})}}}function m(e,r){return{ok:!1,issues:[{code:"invalid_analysis_option",message:r,path:e}]}}function D(e){return!!(e&&typeof e=="object"&&!Array.isArray(e))}function ne(e){return e==="absolute_delta"||e==="largest_negative"||e==="largest_positive"||e==="positive_and_negative"||e==="all"}function se(e,r){if(!e||typeof e!="object"||Array.isArray(e))return m(r.pathPrefix,'Data App analysis option "calendarContext" must be an object.');const t=e,o=t.tz;let i=o;if(typeof o=="string"&&r.validateTimezone&&(i=r.validateTimezone(o)),i===null)return m(`${r.pathPrefix}.tz`,'Data App analysis option "calendarContext.tz" must be a valid timezone string.');const n=E.parseCalendarContext({...t,tz:i});if(!n.ok){const s=n.issues[0];return m(s!=null&&s.path?`${r.pathPrefix}.${s.path}`:r.pathPrefix,`Data App analysis option "calendarContext" is invalid: ${(s==null?void 0:s.message)??"invalid value"}.`)}return{ok:!0,calendarContext:n.value}}function de(e){return le(e.spec)}function le(e){if(!D(e))throw new Error("useSemaphorQuery spec must be an object.");if(e.queryKind==="metric")return y.toSemaphorMetricIntent(e);if(e.queryKind==="analysis")return y.toSemaphorAnalysisIntent(e);if(e.queryKind==="records")return y.toSemaphorRecordsIntent(e);if(e.queryKind==="sql")return y.toSemaphorSqlIntent(e);if(e.queryKind==="matrix")return y.toSemaphorMatrixIntent(e);if(e.queryKind==="inputOptions")return y.toSemaphorInputOptionsIntent(e);throw new Error("useSemaphorQuery spec.queryKind must be metric, analysis, records, inputOptions, sql, or matrix.")}function ce(e){if(e.intent.kind==="sql")return[];if(e.fieldCatalogs.length===0&&!e.requireFieldCatalog)return[];const r=S(e.fieldCatalogs,e.intent.source);if(!r)return[{severity:"error",code:"invalid_source_ref",message:`Source ref for ${e.querySpec.queryHook} does not match a visible Semaphor source.`,path:`${e.pathPrefix}.spec.source`,queryHook:e.querySpec.queryHook,queryId:e.queryId,intentId:d.getAnalyticsIntentId(e.intent),source:e.intent.source}];const t=fe({...e,catalog:r}),o={...r,fields:[...r.fields,...ve(e.intent,r,e.intent.source)]};return[...t,...ue({...e,fieldCatalogs:e.fieldCatalogs}),...me({...e,catalog:o,fieldCatalogs:e.fieldCatalogs}),...pe({...e,catalog:o,fieldCatalogs:e.fieldCatalogs})]}function ue(e){var t;if(e.intent.kind!=="inputOptions"||((t=e.intent.population)==null?void 0:t.kind)!=="related_population")return[];const r=e.intent.population.baseSource;return S(e.fieldCatalogs,r)?[]:[{severity:"error",code:"invalid_source_ref",message:"Input options related population baseSource does not match a visible Semaphor source.",path:`${e.pathPrefix}.spec.population.baseSource`,queryHook:e.querySpec.queryHook,queryId:e.queryId,intentId:d.getAnalyticsIntentId(e.intent),source:r}]}function fe(e){const r=B(e.intent);if(r.length===0)return[];const t=[],o=new Set;return r.forEach((i,n)=>{const s=`${e.pathPrefix}.spec.derivedFields.${n}`,c=R(i.name);c&&(o.has(c)&&t.push({severity:"error",code:"duplicate_derived_field",message:`Derived field "${i.name}" is declared more than once.`,path:`${s}.name`,queryHook:e.querySpec.queryHook,queryId:e.queryId,intentId:d.getAnalyticsIntentId(e.intent),source:e.intent.source}),o.add(c),e.catalog.fields.some(a=>R(a.name)===c)&&t.push({severity:"error",code:"derived_field_name_collision",message:`Derived field "${i.name}" conflicts with a field already visible on the selected Semaphor source.`,path:`${s}.name`,queryHook:e.querySpec.queryHook,queryId:e.queryId,intentId:d.getAnalyticsIntentId(e.intent),source:e.intent.source})),Object.entries(i.inputs||{}).forEach(([a,u])=>{const l=qe(u);if(!l)return;const f=g(l,e.intent.source);if(!d.semaphorSourcesReferToSameDataset(f,e.intent.source)){t.push({severity:"error",code:"unsupported_derived_field_source",message:`Derived field "${i.name}" input "${a}" references a different Semaphor source. App-local derived fields must use fields from the query source.`,path:`${s}.inputs.${a}`,queryHook:e.querySpec.queryHook,queryId:e.queryId,intentId:d.getAnalyticsIntentId(e.intent),source:f,field:l});return}q(e.catalog,l,e.intent.source)||t.push({severity:"error",code:"missing_field",message:`Derived field "${i.name}" input "${a}" references field "${l.name}", which is not visible on the selected Semaphor source.`,path:`${s}.inputs.${a}`,queryHook:e.querySpec.queryHook,queryId:e.queryId,intentId:d.getAnalyticsIntentId(e.intent),source:f,field:l})})}),t}function me(e){const r=Ie(e.intent).map(({field:t,path:o})=>{const i=j({intent:e.intent,field:t,relativePath:o,baseCatalog:e.catalog,fieldCatalogs:e.fieldCatalogs});return{field:t,path:o,validation:i}});return e.intent.kind==="matrix"&&r.push(...oe({intent:e.intent,baseCatalog:e.catalog,fieldCatalogs:e.fieldCatalogs})),r.flatMap(({field:t,path:o,validation:i})=>i.ok?[]:[{severity:"error",code:i.code,message:i.message,path:`${e.pathPrefix}.${o}${i.pathSuffix||""}`,queryHook:e.querySpec.queryHook,queryId:e.queryId,intentId:d.getAnalyticsIntentId(e.intent),source:i.source,field:t}])}function pe(e){return("inputs"in e.intent?e.intent.inputs||[]:[]).flatMap((t,o)=>{if(!t.field)return[];const i=g(t.field,e.intent.source);if(!d.semaphorSourcesReferToSameDataset(i,e.intent.source)){if(ye(e.intent,i)){const n=S(e.fieldCatalogs,i);return n?q(n,t.field,i)?[]:[{severity:"error",code:"missing_field",message:`Input "${t.inputId}" references field "${t.field.name}", which is not visible on the selected Semaphor source.`,path:`${e.pathPrefix}.spec.inputs.${o}.field`,queryHook:e.querySpec.queryHook,queryId:e.queryId,intentId:d.getAnalyticsIntentId(e.intent),source:i,field:t.field}]:[{severity:"error",code:"invalid_source_ref",message:`Input "${t.inputId}" references a Semaphor source that is not present in the visible field catalog.`,path:`${e.pathPrefix}.spec.inputs.${o}.field.source`,queryHook:e.querySpec.queryHook,queryId:e.queryId,intentId:d.getAnalyticsIntentId(e.intent),source:i,field:t.field}]}return[{severity:"error",code:"unsupported_input_filter_composition",message:`Input "${t.inputId}" filters a different Semaphor source than the query, and no relationship-aware semantic validation path is available for this query kind.`,path:`${e.pathPrefix}.spec.inputs.${o}.field`,queryHook:e.querySpec.queryHook,queryId:e.queryId,intentId:d.getAnalyticsIntentId(e.intent),source:i,field:t.field}]}return q(e.catalog,t.field,e.intent.source)?[]:[{severity:"error",code:"missing_field",message:`Input "${t.inputId}" references field "${t.field.name}", which is not visible on the selected Semaphor source.`,path:`${e.pathPrefix}.spec.inputs.${o}.field`,queryHook:e.querySpec.queryHook,queryId:e.queryId,intentId:d.getAnalyticsIntentId(e.intent),source:i,field:t.field}]})}function ye(e,r){return e.source.kind==="semantic"&&r.kind==="semantic"&&r.domainId===e.source.domainId}function he(e){if(e.querySpec.spec.queryKind!=="analysis")return[];const r=M(e.querySpec.spec,{pathPrefix:`${e.pathPrefix}.spec`,validateTimezone:e.validateTimezone});return r.ok?[]:r.issues.map(t=>({severity:"error",code:t.code,message:t.message,path:t.path,queryHook:e.querySpec.queryHook,queryId:e.queryId,intentId:d.getAnalyticsIntentId(e.intent),source:e.intent.source}))}function ge(e){if(e.querySpec.spec.queryKind==="matrix"){const r=N.matrixWindowRequestSchema.safeParse(e.querySpec.spec.matrixWindowRequest);return r.success?[]:r.error.issues.map(t=>({severity:"error",code:"invalid_query_spec",message:t.message,path:[e.pathPrefix,"spec","matrixWindowRequest",...t.path].join("."),queryHook:e.querySpec.queryHook,queryId:e.queryId,intentId:d.getAnalyticsIntentId(e.intent)}))}return e.querySpec.spec.queryKind!=="sql"?[]:D(e.querySpec.spec)?Object.prototype.hasOwnProperty.call(e.querySpec.spec,"parameters")?[{severity:"error",code:"deprecated_sql_parameters",message:"semaphor.sql uses defaultParameters for static SQL param(...) fallback values. The legacy parameters field is not supported.",path:`${e.pathPrefix}.spec.parameters`,queryHook:e.querySpec.queryHook,queryId:e.queryId,intentId:d.getAnalyticsIntentId(e.intent)}]:[]:[]}function Ie(e){return e.kind==="metric"?[...e.measures.map((r,t)=>({field:r,path:`spec.measures.${t}`})),...e.primaryMeasure?[{field:e.primaryMeasure,path:"spec.primaryMeasure"}]:[],...e.dateField?[{field:e.dateField,path:"spec.dateField"}]:[],...(e.dimensions||[]).map((r,t)=>({field:r,path:`spec.dimensions.${t}`})),...e.orderBy?[{field:e.orderBy.field,path:"spec.orderBy.field"}]:[],...(e.filters||[]).map((r,t)=>({field:r.field,path:`spec.filters.${t}.field`}))]:e.kind==="records"?[...e.fields.map((r,t)=>({field:r,path:`spec.fields.${t}`})),...e.dateField?[{field:e.dateField,path:"spec.dateField"}]:[],...e.orderBy?[{field:e.orderBy.field,path:"spec.orderBy.field"}]:[],...(e.filters||[]).map((r,t)=>({field:r.field,path:`spec.filters.${t}.field`}))]:e.kind==="inputOptions"?[{field:e.labelField,path:"spec.labelField"},{field:e.valueField,path:"spec.valueField"},...e.searchField?[{field:e.searchField,path:"spec.searchField"}]:[],...(e.disambiguationFields||[]).map((r,t)=>({field:r,path:`spec.disambiguationFields.${t}`}))]:e.kind==="matrix"?Q.matrixDefinitionFields(e).flatMap((r,t)=>r.derivedField||r.name==="*"?[]:[{field:r,path:`spec.fields.${t}`}]):[]}function B(e){return!("derivedFields"in e)||!Array.isArray(e.derivedFields)?[]:e.derivedFields}function ve(e,r,t){return B(e).map(o=>({name:o.name,label:o.label,role:o.resultRole,dataType:o.dataType,source:r.source||t,...o.defaultAggregate?{aggregate:o.defaultAggregate}:{}}))}function qe(e){if(!(!e||typeof e!="object"))return e.field}function _(e,r){return{severity:r.severity,code:e.code||"invalid_analytics_intent",message:e.message,path:e.path?`${r.pathPrefix}.spec.${e.path}`:r.pathPrefix,queryHook:r.queryHook,queryId:r.queryId,intentId:d.getAnalyticsIntentId(r.intent),source:r.intent.source}}function Se(e,r){const t=z(r);return{ok:t.ok&&e.ok,errors:C([...e.errors,...t.errors]),warnings:C([...e.warnings,...t.warnings]),repairHints:[...e.repairHints,...t.repairHints]}}function z(e){const r=e.filter(o=>o.severity==="error").map(A),t=e.filter(o=>o.severity==="warning").map(A);return{ok:r.length===0,errors:r,warnings:t,repairHints:r.map(o=>{var i,n;return{code:o.code,message:o.message,fieldRole:o.fieldRole,invalidField:(i=o.repairHint)==null?void 0:i.invalidField,recommendedNextStep:((n=o.repairHint)==null?void 0:n.recommendedNextStep)||"Update the Data App SDK query spec to use visible Semaphor source and field refs."}})}}function A(e){var r;return{code:e.code,message:e.message,path:e.path,fieldRole:e.code==="invalid_source_ref"?"source":void 0,repairHint:{code:e.code,message:e.message,invalidField:(r=e.field)==null?void 0:r.name,fieldRole:e.code==="invalid_source_ref"?"source":void 0,recommendedNextStep:e.code==="unsupported_input_filter_composition"?"Use an input field from the same Semaphor source as the query, or split the query into separate source-scoped queries.":"Update the query spec to use a visible Semaphor source and field ref."}}}function C(e){const r=new Set;return e.filter(t=>{const o=`${t.code}:${t.path||""}:${t.message}`;return r.has(o)?!1:(r.add(o),!0)})}function x(e){var t;const r=e.diagnostics.filter(o=>o.severity==="error");return{intentId:d.getAnalyticsIntentId(e.intent),status:r.length?"failed":"answered",resultShape:(t=e.intent)==null?void 0:t.kind,intent:e.intent,validation:e.validation,coverage:{answeredObligations:r.length?[]:["query_spec_validation"],missingObligations:r.length?["query_spec_validation"]:[],warnings:e.validation.warnings},missingFields:r.filter(o=>o.code==="missing_field").flatMap(o=>{var i;return(i=o.field)!=null&&i.name?[o.field.name]:[]}),warnings:e.diagnostics.filter(o=>o.severity==="warning").map(o=>o.message),metadata:{validationKind:"data_app_sdk_query_spec"}}}function ke(e,r){return d.getAnalyticsIntentId(r)||O(e.spec)}function O(e){if(!e||typeof e!="object"||!("id"in e))return;const r=e.id;return typeof r=="string"&&r.trim()?r:void 0}exports.fieldWithSelectedProjectionRole=I;exports.findMatchingRelatedProjectionField=v;exports.isAllowedRelatedProjectionRole=P;exports.normalizeSemaphorAnalysisQueryOptions=M;exports.normalizeSemaphorFieldRole=$;exports.relatedProjectionFieldCandidatesForIntent=U;exports.validateSemaphorDataAppQuerySpecs=ie;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const d=require("../chunks/validators-DVYAnnX0.cjs"),N=require("../chunks/matrix-operation-contract-DoiWTUbT.cjs"),E=require("../chunks/report-runtime-context-DzvHBPxl.cjs"),K=require("../chunks/source-entity-resolution-CjbgnwyX.cjs"),y=require("../data-app-sdk-adapters/index.cjs"),Q=require("../chunks/matrix-card-U4c72doZ.cjs");function W({intent:e,field:r,catalogField:t,relativePath:o}){const i=J({intent:e,field:r,relativePath:o});if(!i||i.allowedRelatedRoles.length===0)return!1;const n=I(r,i.selectedField),s=$(t),c=h(n);return P(s,i.allowedRelatedRoles)?c===s:!1}function U(e){return e.kind==="records"?L(e):e.kind==="metric"?X(e):[]}function $(e){const r=d.normalizeAnalyticsCatalogName(e.role);if(r==="measure")return"measure";if(r==="id")return"id";const t=d.normalizeAnalyticsCatalogDataType(e.dataType);if(r==="date"||t==="date"||t==="datetime")return"date";if(r==="dimension")return"dimension"}function P(e,r){return!!(e&&r.includes(e))}function I(e,r){const t=h(e);if(t)return e.role===t?e:{...e,role:t};const o=r?h(r):void 0;return o?{...e,role:o}:e}function v(e,r){return e.find(t=>T(t,r))}function J({intent:e,field:r,relativePath:t}){if(e.kind==="records")return V(e,r,t);if(e.kind==="metric")return G(e,r,t)}function V(e,r,t){if(t.startsWith("spec.fields."))return{allowedRelatedRoles:["dimension","date","id"]};if(t==="spec.dateField"&&!e.timeWindow)return{allowedRelatedRoles:["date"]};if(t==="spec.orderBy.field"){const o=v(H(e),r);return{selectedField:o,allowedRelatedRoles:o?k(o):[]}}}function G(e,r,t){if(t.startsWith("spec.dimensions."))return{allowedRelatedRoles:["dimension"]};if(t==="spec.orderBy.field"){const o=v(e.dimensions||[],r);return{selectedField:o,allowedRelatedRoles:o?["dimension"]:[]}}}function L(e){var o,i;const r=H(e),t=(o=e.orderBy)!=null&&o.field?v(r,e.orderBy.field):void 0;return b([...r.map(n=>p(n,k(n))),...(i=e.orderBy)!=null&&i.field?[p(I(e.orderBy.field,t),t?k(t):[],{unsupportedRelatedRoleMessage:"Joined records projections support related sort fields only when the same related field is included in spec.fields.",recommendedNextStep:"Add the related sort field to spec.fields, or keep orderBy fields on the base source."})]:[]])}function X(e){var t,o;const r=(t=e.orderBy)!=null&&t.field?v(e.dimensions||[],e.orderBy.field):void 0;return b([...e.measures.map(i=>p(i,[])),...e.primaryMeasure?[p(e.primaryMeasure,[])]:[],...(e.dimensions||[]).map(i=>p(i,["dimension"])),...e.dateField?[p({...e.dateField,role:"date"},[])]:[],...(o=e.orderBy)!=null&&o.field?[p(I(e.orderBy.field,r),r?["dimension"]:[],{unsupportedRelatedRoleMessage:"Joined metric projections support related orderBy fields only when the same related field is declared in spec.dimensions.",recommendedNextStep:"Add the related field as a metric dimension when it should participate in the grouped result, or keep orderBy fields on the base source."})]:[]])}function k(e){const r=e?h(e):void 0;return r==="dimension"?["dimension"]:r==="date"?["date"]:r==="id"?["id"]:["dimension","date","id"]}function p(e,r,t={}){return{field:I(e),allowedRelatedRoles:r,...t}}function b(e){const r=[];return e.forEach(t=>{r.some(o=>Y(o,t))||r.push(t)}),r}function H(e){const r=[...e.fields];return e.dateField&&!r.some(t=>w(t,e.dateField))&&r.push({...e.dateField,role:"date"}),r}function Y(e,r){return T(e.field,r.field)&&e.allowedRelatedRoles.join("|")===r.allowedRelatedRoles.join("|")&&(e.unsupportedRelatedRoleMessage||"")===(r.unsupportedRelatedRoleMessage||"")&&(e.recommendedNextStep||"")===(r.recommendedNextStep||"")}function w(e,r){return d.semaphorFieldRefsMatch(e,r)}function T(e,r){return w(e,r)&&Z(h(e),h(r))}function Z(e,r){return!!(e&&(!r||e===r))}function h(e){return $(e)}function j({intent:e,field:r,relativePath:t,baseCatalog:o,fieldCatalogs:i}){const n=g(r,e.source),s=d.semaphorSourcesReferToSameDataset(n,e.source);if(e.kind!=="matrix"&&!s&&!re(e.source,n))return{ok:!1,code:"invalid_source_ref",message:`Field "${r.name}" references a related Semaphor source outside the query's semantic domain.`,pathSuffix:".source",source:n};const c=s?o:S(i,n);if(!c)return{ok:!1,code:"invalid_source_ref",message:`Field "${r.name}" references a Semaphor source that is not present in the visible field catalog.`,pathSuffix:".source",source:n};const a=q(c,r,e.source);return a?e.kind!=="matrix"&&!s&&!ee({intent:e,field:r,catalogField:a,relativePath:t})?{ok:!1,code:"unsupported_joined_projection",message:`Field "${r.name}" references a related Semaphor source, but this query kind does not support joined projections for that field yet.`,pathSuffix:".source",source:n}:{ok:!0,source:n,catalogField:a,usesBaseSource:s}:{ok:!1,code:"missing_field",message:`Field "${r.name}" is not visible on the selected Semaphor source.`,source:n}}function ee({intent:e,field:r,catalogField:t,relativePath:o}){return W({intent:e,field:r,catalogField:t,relativePath:o})}function re(e,r){return e.kind==="semantic"&&r.kind==="semantic"&&e.domainId===r.domainId}function S(e,r){return e.find(t=>F(t,r))}function q(e,r,t){const o=g(r,t);if(F(e,o))return e.fields.find(i=>te(i,r)&&F(e,g(i,e.source)))}function R(e){return d.normalizeAnalyticsCatalogName(e)}function g(e,r){return e.source||r}function F(e,r){return[e.source,...e.sourceAliases||[]].some(t=>d.semaphorSourcesReferToSameDataset(t,r))}function te(e,r){return!!(e.name&&r.name&&e.name===r.name)}function oe(e){const r=[];if(!e.intent.filters)return r;const t=e.intent.source,i=d.mergeSemaphorSourcesByIdentity(e.fieldCatalogs.flatMap(a=>[a.source,...a.sourceAliases??[]])).filter(a=>t.kind==="semantic"?a.kind==="semantic"&&a.domainId===t.domainId:a.kind==="physical"&&a.connectionId===t.connectionId).map(a=>a.kind==="semantic"?{type:"dataset",name:a.datasetName,id:a.datasetId,domainId:a.domainId,connectionId:a.connectionId}:{type:"table",name:a.tableName,database:a.databaseName,schema:a.schemaName,connectionId:a.connectionId,connectionType:a.connectionType,dialect:a.dialect}),n=(a,u)=>{r.push({field:a,path:u,validation:j({...e,field:a,relativePath:u})})},s=(a,u)=>{if(a.derivedField)Object.entries(a.derivedField.inputs).forEach(([l,f])=>n(f.field,`${u}.derivedField.inputs.${l}.field`));else if(a.calculatedFormula)a.calculatedFormula.inputFields.forEach((l,f)=>s(l,`${u}.calculatedFormula.inputFields.${f}`));else{const l=K.resolveSemaphorSourceEntity({entities:i,semanticDomainId:t.kind==="semantic"?t.domainId:void 0,connectionId:t.connectionId,connectionType:t.kind==="physical"?t.connectionType:void 0,dialect:t.kind==="physical"?t.dialect:void 0,fieldEntityType:a.entityType,entityId:a.entityId,entityName:a.entityName,qualifiedHints:[a.qualifiedEntityName]});l.kind==="resolved"?n({name:a.name,source:l.source},u):r.push({field:{name:a.name},path:u,validation:{ok:!1,code:"invalid_source_ref",source:t,message:`Filter field "${a.name}" has no unambiguous source in the visible field catalog (${l.kind}).`}})}},c=(a,u)=>{a.conditions.forEach((l,f)=>s(l.field,`${u}.conditions.${f}.field`)),a.groups.forEach((l,f)=>c(l,`${u}.groups.${f}`))};return c(e.intent.filters,"spec.filters"),r}function M(e,r={}){const t=r.pathPrefix||"analysisOptions";if(e===void 0)return{ok:!0};if(!e||typeof e!="object"||Array.isArray(e))return m(t,"Data App analysis options must be an object.");const o=e,i={};if(o.chartTitle!==void 0){if(typeof o.chartTitle!="string")return m(`${t}.chartTitle`,'Data App analysis option "chartTitle" must be a string.');i.chartTitle=o.chartTitle}if(o.chartType!==void 0){if(typeof o.chartType!="string")return m(`${t}.chartType`,'Data App analysis option "chartType" must be a string.');i.chartType=o.chartType}if(o.driverMode!==void 0){if(!ne(o.driverMode))return m(`${t}.driverMode`,'Data App analysis option "driverMode" must be absolute_delta, largest_negative, largest_positive, positive_and_negative, or all.');i.driverMode=o.driverMode}if(o.includePopulation!==void 0){if(typeof o.includePopulation!="boolean")return m(`${t}.includePopulation`,'Data App analysis option "includePopulation" must be a boolean.');i.includePopulation=o.includePopulation}if(o.calendarContext!==void 0){const n=se(o.calendarContext,{pathPrefix:`${t}.calendarContext`,validateTimezone:r.validateTimezone});if(!n.ok)return n;i.calendarContext=n.calendarContext}return{ok:!0,analysisOptions:i}}function ie(e){const r=e.queries.map((i,n)=>ae(i,n,{fieldCatalogs:e.fieldCatalogs||[],requireFieldCatalog:!!e.requireFieldCatalog,validateTimezone:e.validateTimezone})),t=r.flatMap(i=>i.diagnostics),o=r.map(i=>i.executionResult);return{ok:t.every(i=>i.severity!=="error"),diagnostics:t,queries:r,intents:r.flatMap(i=>i.intent?[i.intent]:[]),executionResults:o}}function ae(e,r,t){const o=`queries.${r}`;try{const i=de(e),n=ke(e,i),s=d.validateSemaphorAnalyticsIntent(i),c=[...ge({querySpec:e,queryId:n,intent:i,pathPrefix:o}),...s.errors.map(u=>_(u,{queryHook:e.queryHook,queryId:n,pathPrefix:o,severity:"error",intent:i})),...s.warnings.map(u=>_(u,{queryHook:e.queryHook,queryId:n,pathPrefix:o,severity:"warning",intent:i})),...ce({querySpec:e,queryId:n,intent:i,pathPrefix:o,fieldCatalogs:t.fieldCatalogs,requireFieldCatalog:t.requireFieldCatalog}),...he({querySpec:e,queryId:n,intent:i,pathPrefix:o,validateTimezone:t.validateTimezone})],a=Se(s,c);return{queryHook:e.queryHook,queryId:n,intent:i,diagnostics:c,executionResult:x({intent:i,validation:a,diagnostics:c})}}catch(i){const n={severity:"error",code:"invalid_query_spec",message:i instanceof Error?i.message:String(i),path:o,queryHook:e.queryHook,queryId:O(e.spec)},s=z([n]);return{queryHook:e.queryHook,queryId:n.queryId,diagnostics:[n],executionResult:x({validation:s,diagnostics:[n]})}}}function m(e,r){return{ok:!1,issues:[{code:"invalid_analysis_option",message:r,path:e}]}}function D(e){return!!(e&&typeof e=="object"&&!Array.isArray(e))}function ne(e){return e==="absolute_delta"||e==="largest_negative"||e==="largest_positive"||e==="positive_and_negative"||e==="all"}function se(e,r){if(!e||typeof e!="object"||Array.isArray(e))return m(r.pathPrefix,'Data App analysis option "calendarContext" must be an object.');const t=e,o=t.tz;let i=o;if(typeof o=="string"&&r.validateTimezone&&(i=r.validateTimezone(o)),i===null)return m(`${r.pathPrefix}.tz`,'Data App analysis option "calendarContext.tz" must be a valid timezone string.');const n=E.parseCalendarContext({...t,tz:i});if(!n.ok){const s=n.issues[0];return m(s!=null&&s.path?`${r.pathPrefix}.${s.path}`:r.pathPrefix,`Data App analysis option "calendarContext" is invalid: ${(s==null?void 0:s.message)??"invalid value"}.`)}return{ok:!0,calendarContext:n.value}}function de(e){return le(e.spec)}function le(e){if(!D(e))throw new Error("useSemaphorQuery spec must be an object.");if(e.queryKind==="metric")return y.toSemaphorMetricIntent(e);if(e.queryKind==="analysis")return y.toSemaphorAnalysisIntent(e);if(e.queryKind==="records")return y.toSemaphorRecordsIntent(e);if(e.queryKind==="sql")return y.toSemaphorSqlIntent(e);if(e.queryKind==="matrix")return y.toSemaphorMatrixIntent(e);if(e.queryKind==="inputOptions")return y.toSemaphorInputOptionsIntent(e);throw new Error("useSemaphorQuery spec.queryKind must be metric, analysis, records, inputOptions, sql, or matrix.")}function ce(e){if(e.intent.kind==="sql")return[];if(e.fieldCatalogs.length===0&&!e.requireFieldCatalog)return[];const r=S(e.fieldCatalogs,e.intent.source);if(!r)return[{severity:"error",code:"invalid_source_ref",message:`Source ref for ${e.querySpec.queryHook} does not match a visible Semaphor source.`,path:`${e.pathPrefix}.spec.source`,queryHook:e.querySpec.queryHook,queryId:e.queryId,intentId:d.getAnalyticsIntentId(e.intent),source:e.intent.source}];const t=fe({...e,catalog:r}),o={...r,fields:[...r.fields,...ve(e.intent,r,e.intent.source)]};return[...t,...ue({...e,fieldCatalogs:e.fieldCatalogs}),...me({...e,catalog:o,fieldCatalogs:e.fieldCatalogs}),...pe({...e,catalog:o,fieldCatalogs:e.fieldCatalogs})]}function ue(e){var t;if(e.intent.kind!=="inputOptions"||((t=e.intent.population)==null?void 0:t.kind)!=="related_population")return[];const r=e.intent.population.baseSource;return S(e.fieldCatalogs,r)?[]:[{severity:"error",code:"invalid_source_ref",message:"Input options related population baseSource does not match a visible Semaphor source.",path:`${e.pathPrefix}.spec.population.baseSource`,queryHook:e.querySpec.queryHook,queryId:e.queryId,intentId:d.getAnalyticsIntentId(e.intent),source:r}]}function fe(e){const r=B(e.intent);if(r.length===0)return[];const t=[],o=new Set;return r.forEach((i,n)=>{const s=`${e.pathPrefix}.spec.derivedFields.${n}`,c=R(i.name);c&&(o.has(c)&&t.push({severity:"error",code:"duplicate_derived_field",message:`Derived field "${i.name}" is declared more than once.`,path:`${s}.name`,queryHook:e.querySpec.queryHook,queryId:e.queryId,intentId:d.getAnalyticsIntentId(e.intent),source:e.intent.source}),o.add(c),e.catalog.fields.some(a=>R(a.name)===c)&&t.push({severity:"error",code:"derived_field_name_collision",message:`Derived field "${i.name}" conflicts with a field already visible on the selected Semaphor source.`,path:`${s}.name`,queryHook:e.querySpec.queryHook,queryId:e.queryId,intentId:d.getAnalyticsIntentId(e.intent),source:e.intent.source})),Object.entries(i.inputs||{}).forEach(([a,u])=>{const l=qe(u);if(!l)return;const f=g(l,e.intent.source);if(!d.semaphorSourcesReferToSameDataset(f,e.intent.source)){t.push({severity:"error",code:"unsupported_derived_field_source",message:`Derived field "${i.name}" input "${a}" references a different Semaphor source. App-local derived fields must use fields from the query source.`,path:`${s}.inputs.${a}`,queryHook:e.querySpec.queryHook,queryId:e.queryId,intentId:d.getAnalyticsIntentId(e.intent),source:f,field:l});return}q(e.catalog,l,e.intent.source)||t.push({severity:"error",code:"missing_field",message:`Derived field "${i.name}" input "${a}" references field "${l.name}", which is not visible on the selected Semaphor source.`,path:`${s}.inputs.${a}`,queryHook:e.querySpec.queryHook,queryId:e.queryId,intentId:d.getAnalyticsIntentId(e.intent),source:f,field:l})})}),t}function me(e){const r=Ie(e.intent).map(({field:t,path:o})=>{const i=j({intent:e.intent,field:t,relativePath:o,baseCatalog:e.catalog,fieldCatalogs:e.fieldCatalogs});return{field:t,path:o,validation:i}});return e.intent.kind==="matrix"&&r.push(...oe({intent:e.intent,baseCatalog:e.catalog,fieldCatalogs:e.fieldCatalogs})),r.flatMap(({field:t,path:o,validation:i})=>i.ok?[]:[{severity:"error",code:i.code,message:i.message,path:`${e.pathPrefix}.${o}${i.pathSuffix||""}`,queryHook:e.querySpec.queryHook,queryId:e.queryId,intentId:d.getAnalyticsIntentId(e.intent),source:i.source,field:t}])}function pe(e){return("inputs"in e.intent?e.intent.inputs||[]:[]).flatMap((t,o)=>{if(!t.field)return[];const i=g(t.field,e.intent.source);if(!d.semaphorSourcesReferToSameDataset(i,e.intent.source)){if(ye(e.intent,i)){const n=S(e.fieldCatalogs,i);return n?q(n,t.field,i)?[]:[{severity:"error",code:"missing_field",message:`Input "${t.inputId}" references field "${t.field.name}", which is not visible on the selected Semaphor source.`,path:`${e.pathPrefix}.spec.inputs.${o}.field`,queryHook:e.querySpec.queryHook,queryId:e.queryId,intentId:d.getAnalyticsIntentId(e.intent),source:i,field:t.field}]:[{severity:"error",code:"invalid_source_ref",message:`Input "${t.inputId}" references a Semaphor source that is not present in the visible field catalog.`,path:`${e.pathPrefix}.spec.inputs.${o}.field.source`,queryHook:e.querySpec.queryHook,queryId:e.queryId,intentId:d.getAnalyticsIntentId(e.intent),source:i,field:t.field}]}return[{severity:"error",code:"unsupported_input_filter_composition",message:`Input "${t.inputId}" filters a different Semaphor source than the query, and no relationship-aware semantic validation path is available for this query kind.`,path:`${e.pathPrefix}.spec.inputs.${o}.field`,queryHook:e.querySpec.queryHook,queryId:e.queryId,intentId:d.getAnalyticsIntentId(e.intent),source:i,field:t.field}]}return q(e.catalog,t.field,e.intent.source)?[]:[{severity:"error",code:"missing_field",message:`Input "${t.inputId}" references field "${t.field.name}", which is not visible on the selected Semaphor source.`,path:`${e.pathPrefix}.spec.inputs.${o}.field`,queryHook:e.querySpec.queryHook,queryId:e.queryId,intentId:d.getAnalyticsIntentId(e.intent),source:i,field:t.field}]})}function ye(e,r){return e.source.kind==="semantic"&&r.kind==="semantic"&&r.domainId===e.source.domainId}function he(e){if(e.querySpec.spec.queryKind!=="analysis")return[];const r=M(e.querySpec.spec,{pathPrefix:`${e.pathPrefix}.spec`,validateTimezone:e.validateTimezone});return r.ok?[]:r.issues.map(t=>({severity:"error",code:t.code,message:t.message,path:t.path,queryHook:e.querySpec.queryHook,queryId:e.queryId,intentId:d.getAnalyticsIntentId(e.intent),source:e.intent.source}))}function ge(e){if(e.querySpec.spec.queryKind==="matrix"){const r=N.matrixWindowRequestSchema.safeParse(e.querySpec.spec.matrixWindowRequest);return r.success?[]:r.error.issues.map(t=>({severity:"error",code:"invalid_query_spec",message:t.message,path:[e.pathPrefix,"spec","matrixWindowRequest",...t.path].join("."),queryHook:e.querySpec.queryHook,queryId:e.queryId,intentId:d.getAnalyticsIntentId(e.intent)}))}return e.querySpec.spec.queryKind!=="sql"?[]:D(e.querySpec.spec)?Object.prototype.hasOwnProperty.call(e.querySpec.spec,"parameters")?[{severity:"error",code:"deprecated_sql_parameters",message:"semaphor.sql uses defaultParameters for static SQL param(...) fallback values. The legacy parameters field is not supported.",path:`${e.pathPrefix}.spec.parameters`,queryHook:e.querySpec.queryHook,queryId:e.queryId,intentId:d.getAnalyticsIntentId(e.intent)}]:[]:[]}function Ie(e){return e.kind==="metric"?[...e.measures.map((r,t)=>({field:r,path:`spec.measures.${t}`})),...e.primaryMeasure?[{field:e.primaryMeasure,path:"spec.primaryMeasure"}]:[],...e.dateField?[{field:e.dateField,path:"spec.dateField"}]:[],...(e.dimensions||[]).map((r,t)=>({field:r,path:`spec.dimensions.${t}`})),...e.orderBy?[{field:e.orderBy.field,path:"spec.orderBy.field"}]:[],...(e.filters||[]).map((r,t)=>({field:r.field,path:`spec.filters.${t}.field`}))]:e.kind==="records"?[...e.fields.map((r,t)=>({field:r,path:`spec.fields.${t}`})),...e.dateField?[{field:e.dateField,path:"spec.dateField"}]:[],...e.orderBy?[{field:e.orderBy.field,path:"spec.orderBy.field"}]:[],...(e.filters||[]).map((r,t)=>({field:r.field,path:`spec.filters.${t}.field`}))]:e.kind==="inputOptions"?[{field:e.labelField,path:"spec.labelField"},{field:e.valueField,path:"spec.valueField"},...e.searchField?[{field:e.searchField,path:"spec.searchField"}]:[],...(e.disambiguationFields||[]).map((r,t)=>({field:r,path:`spec.disambiguationFields.${t}`}))]:e.kind==="matrix"?Q.matrixDefinitionFields(e).flatMap((r,t)=>r.derivedField||r.name==="*"?[]:[{field:r,path:`spec.fields.${t}`}]):[]}function B(e){return!("derivedFields"in e)||!Array.isArray(e.derivedFields)?[]:e.derivedFields}function ve(e,r,t){return B(e).map(o=>({name:o.name,label:o.label,role:o.resultRole,dataType:o.dataType,source:r.source||t,...o.defaultAggregate?{aggregate:o.defaultAggregate}:{}}))}function qe(e){if(!(!e||typeof e!="object"))return e.field}function _(e,r){return{severity:r.severity,code:e.code||"invalid_analytics_intent",message:e.message,path:e.path?`${r.pathPrefix}.spec.${e.path}`:r.pathPrefix,queryHook:r.queryHook,queryId:r.queryId,intentId:d.getAnalyticsIntentId(r.intent),source:r.intent.source}}function Se(e,r){const t=z(r);return{ok:t.ok&&e.ok,errors:C([...e.errors,...t.errors]),warnings:C([...e.warnings,...t.warnings]),repairHints:[...e.repairHints,...t.repairHints]}}function z(e){const r=e.filter(o=>o.severity==="error").map(A),t=e.filter(o=>o.severity==="warning").map(A);return{ok:r.length===0,errors:r,warnings:t,repairHints:r.map(o=>{var i,n;return{code:o.code,message:o.message,fieldRole:o.fieldRole,invalidField:(i=o.repairHint)==null?void 0:i.invalidField,recommendedNextStep:((n=o.repairHint)==null?void 0:n.recommendedNextStep)||"Update the Data App SDK query spec to use visible Semaphor source and field refs."}})}}function A(e){var r;return{code:e.code,message:e.message,path:e.path,fieldRole:e.code==="invalid_source_ref"?"source":void 0,repairHint:{code:e.code,message:e.message,invalidField:(r=e.field)==null?void 0:r.name,fieldRole:e.code==="invalid_source_ref"?"source":void 0,recommendedNextStep:e.code==="unsupported_input_filter_composition"?"Use an input field from the same Semaphor source as the query, or split the query into separate source-scoped queries.":"Update the query spec to use a visible Semaphor source and field ref."}}}function C(e){const r=new Set;return e.filter(t=>{const o=`${t.code}:${t.path||""}:${t.message}`;return r.has(o)?!1:(r.add(o),!0)})}function x(e){var t;const r=e.diagnostics.filter(o=>o.severity==="error");return{intentId:d.getAnalyticsIntentId(e.intent),status:r.length?"failed":"answered",resultShape:(t=e.intent)==null?void 0:t.kind,intent:e.intent,validation:e.validation,coverage:{answeredObligations:r.length?[]:["query_spec_validation"],missingObligations:r.length?["query_spec_validation"]:[],warnings:e.validation.warnings},missingFields:r.filter(o=>o.code==="missing_field").flatMap(o=>{var i;return(i=o.field)!=null&&i.name?[o.field.name]:[]}),warnings:e.diagnostics.filter(o=>o.severity==="warning").map(o=>o.message),metadata:{validationKind:"data_app_sdk_query_spec"}}}function ke(e,r){return d.getAnalyticsIntentId(r)||O(e.spec)}function O(e){if(!e||typeof e!="object"||!("id"in e))return;const r=e.id;return typeof r=="string"&&r.trim()?r:void 0}exports.fieldWithSelectedProjectionRole=I;exports.findMatchingRelatedProjectionField=v;exports.isAllowedRelatedProjectionRole=P;exports.normalizeSemaphorAnalysisQueryOptions=M;exports.normalizeSemaphorFieldRole=$;exports.relatedProjectionFieldCandidatesForIntent=U;exports.validateSemaphorDataAppQuerySpecs=ie;

package/dist/data-app-sdk-validation/index.js

@@ -1,9 +1,9 @@
 import { ah as b, ak as N, k as O, a_ as v, u as E, ac as K, aW as l } from "../chunks/validators-BDYzZFgs.js";
-import { u as Q } from "../chunks/matrix-operation-contract-Cqy4EW2H.js";
+import { Q } from "../chunks/matrix-operation-contract-xL8IhFzp.js";
 import { p as W } from "../chunks/report-runtime-context-DWvUf1HT.js";
 import { o as U } from "../chunks/source-entity-resolution-DZhUckix.js";
 import { toSemaphorMetricIntent as J, toSemaphorAnalysisIntent as V, toSemaphorRecordsIntent as G, toSemaphorSqlIntent as L, toSemaphorMatrixIntent as X, toSemaphorInputOptionsIntent as Y } from "../data-app-sdk-adapters/index.js";
-import { m as Z } from "../chunks/matrix-card-DACDwdTq.js";
+import { m as Z } from "../chunks/matrix-card-CnKQpnsj.js";
 function ee({
   intent: e,
   field: r,

package/dist/format-utils/index.cjs

@@ -1,3 +1,3 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const I=require("../chunks/semantic-format-BhIL1PXP.cjs"),c=require("../chunks/raw-temporal-BUeTpG76.cjs"),T=require("../chunks/matrix-formatter-7GLTcBuy.cjs"),n=require("../chunks/pivot-header-presentation-3wqWChFd.cjs"),x=require("../chunks/validators-DVYAnnX0.cjs"),h=require("../chunks/matrix-continuation-6nhDy-lF.cjs");require("../chunks/matrix-operation-contract-D9dLX-Wr.cjs");const q=require("../chunks/matrix-definition-CBJW_4ii.cjs"),C=require("../pdf-export-policy/index.cjs"),E=require("../chunks/pivot-result-lifecycle-DZ0ZSMoM.cjs"),d=require("../chunks/temporal-bucket-4YEPEKlJ.cjs"),X=require("../chunks/metric-comparison-DBQ3EJTz.cjs"),w=require("../chunks/pivot-result-identity-uTiylUNr.cjs"),N=require("../chunks/raw-temporal-contract-DECbTuzA.cjs");function O(e,r){const a=[];r.includeHeaders&&a.push(n.arrayToCSVRow(r.visibleColumns,r.delimiter));for(const o of e){const s=T.formatRowForExport(o,r);a.push(s.map(i=>n.escapeCSVValue(i,r.delimiter)).join(r.delimiter))}return a}function $(e,r,a=`
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const I=require("../chunks/semantic-format-BzH69TRq.cjs"),c=require("../chunks/raw-temporal-BUeTpG76.cjs"),T=require("../chunks/matrix-formatter-CveLJo6S.cjs"),n=require("../chunks/pivot-header-presentation-Cxz8-06f.cjs"),x=require("../chunks/validators-DVYAnnX0.cjs"),h=require("../chunks/matrix-continuation-6nhDy-lF.cjs");require("../chunks/matrix-operation-contract-DoiWTUbT.cjs");const q=require("../chunks/matrix-definition-CBJW_4ii.cjs"),C=require("../pdf-export-policy/index.cjs"),E=require("../chunks/pivot-result-lifecycle-BiERyXnS.cjs"),d=require("../chunks/temporal-bucket-4YEPEKlJ.cjs"),X=require("../chunks/metric-comparison-DBQ3EJTz.cjs"),w=require("../chunks/pivot-result-identity-uTiylUNr.cjs"),N=require("../chunks/raw-temporal-contract-DECbTuzA.cjs");function O(e,r){const a=[];r.includeHeaders&&a.push(n.arrayToCSVRow(r.visibleColumns,r.delimiter));for(const o of e){const s=T.formatRowForExport(o,r);a.push(s.map(i=>n.escapeCSVValue(i,r.delimiter)).join(r.delimiter))}return a}function $(e,r,a=`
 `){return O(e,r).join(a)}function V(e,r,a){for(const o of e){if(o.level<a){r[o.level].push(o.name);for(let s=1;s<o.colspan;s++)r[o.level].push("")}o.children?V(o.children,r,a):o.columnKey&&r[a].push(o.name)}}function k(e){const r=e.pivotByColumns.length,a=e.groupByColumns.length,o=Array.from({length:r+1},()=>[]);for(let s=0;s<r;s++)o[s].push(...Array(a).fill(""));if(o[r].push(...e.groupByColumns.map(s=>s.label||s.name)),V(e.columnHeadersTree,o,r),e.showRowTotals){for(let s=0;s<r;s++)o[s].push("");o[r].push("Total")}return o}function G(e,r,a){if(e==null)return"";if(!a.useFormattedValues)return String(e);const o=a.columnSettings[r];return typeof e=="number"&&(o==null?void 0:o.type)==="number"?c.formatNumberWithColumnSettings(e,o.numberFormat,a.locale):typeof e=="number"?e.toLocaleString(a.locale):String(e)}function L(e,r,a){const o=[];e.fieldValues.forEach((i,t)=>{e.isSubtotal&&t===0?o.push(`${i} Total`):e.isSubtotal?o.push(""):o.push(String(i??""))});let s=0;return r.columnHeaders.forEach(i=>{var u;const t=(u=e.cells[i])==null?void 0:u.value,m=G(t,i,a);o.push(m),r.showRowTotals&&typeof t=="number"&&(s+=t)}),r.showRowTotals&&o.push(s.toLocaleString(a.locale)),o}function H(e,r,a){const o=[];if(a.includeHeaders){const s=k(r);for(const i of s)o.push(n.arrayToCSVRow(i,a.delimiter))}for(const s of e){const i=L(s,r,a);o.push(i.map(t=>n.escapeCSVValue(t,a.delimiter)).join(a.delimiter))}return o}function B(e,r,a){const o=T.prepareMatrixFormatting(e.descriptors,r.presentation,a),s=e.columns.map(l=>{var p;return l.kind==="measure"&&((p=o.measureSemantics.get(l.measureId))==null?void 0:p.isNumeric)===!0}),i=l=>T.matrixMemberLabel([l],o.levels),t=(l,p,f)=>T.matrixAxisLabel(l,p,r.presentation.totals[f],o.levels),m=e.columns.map(l=>{if(l.kind!=="measure")return l.label;const p=l.columnPath.map(i);return l.role!=="member"&&p.push(t(l.columnPath,l.role,"columns")),[...p,l.label].join(" / ")}),u=Math.min(r.spec.columns.length,Math.max(0,...e.columns.map(l=>l.kind==="measure"?l.columnPath.length+(l.role!=="member"?1:0):0))),R=Array.from({length:u+1},(l,p)=>e.columns.map(f=>p===u?f.label:f.kind!=="measure"?"":p<f.columnPath.length?i(f.columnPath[p]):p===f.columnPath.length&&f.role!=="member"?t(f.columnPath,f.role,"columns"):"")),b=(l,p)=>{if(l.kind!=="layout")throw new Error("Layout presentation requires layout rows.");if(l.values.length!==e.columns.length)throw new Error("Matrix row does not match its frozen layout.");const f=T.matrixLevelLabels({path:l.rowPath,role:l.role,levelCount:Math.max(1,r.spec.rows.length),repeatLabels:r.presentation.layout.kind!=="tabular"||r.presentation.layout.repeatLabels,previousPath:p==null?void 0:p.rowPath});return e.columns.map((v,S)=>{if(v.kind==="hierarchy")return`${"  ".repeat(Math.max(0,l.rowPath.length-1))}${t(l.rowPath,l.role,"rows")}`;if(v.kind==="level"){const y=r.spec.rows.findIndex(D=>D.id===v.levelId),g=f[y];return g!=null&&g.visible?g.total?t(l.rowPath,l.role,"rows"):T.matrixMemberLabel(g.path,o.levels):""}const A=l.values[S],_=o.measures.get(v.measureId);if(A.kind==="value"&&!_)throw new Error("Matrix value is missing its measure descriptor.");return T.matrixCellText(A,_,r.presentation.absence)})},P=(l,p)=>b(l,p).map((f,v)=>{var y;const S=l.values[v],A=e.columns[v];return A.kind==="measure"&&!((y=o.measureSemantics.get(A.measureId))!=null&&y.hasTextAffixes)&&S.kind==="value"&&(typeof S.value=="number"||x.isExactNumericValue(S.value))?f:n.protectCSVText(f)});return{headers:m,headerBands:R,row:l=>b(l),numericColumns:s,csvRow:l=>P(l),csvRows:l=>l.map((p,f)=>P(p,l[f-1]))}}function U(e){return e.columns.map(r=>n.protectCSVText(r.label))}function j(e){if(e.kind!=="flat")throw new Error("Raw Matrix CSV requires flat rows.");return e.values.map(r=>r.kind!=="value"?null:x.isExactNumericValue(r.value)?r.value.value:typeof r.value=="string"?n.protectCSVText(r.value):typeof r.value=="boolean"?String(r.value):r.value)}function z(e){const r=B(e.layout,e.request,e.report),a=e.layout.columns.map((t,m)=>({index:m,columnId:`matrix:${m}`,label:r.headers[m],isNumeric:r.numericColumns[m]})),o=(t,m,u)=>({text:t,colspan:1,rowspan:1,columnId:a[m].columnId,isHeader:u,isNumeric:a[m].isNumeric,className:a[m].isNumeric?"numeric":e.layout.columns[m].kind==="hierarchy"?"matrix-hierarchy":""}),s=[],i=e.layout.columns.findIndex(t=>t.kind==="measure");e.request.spec.columns.length&&i>=0&&s.push({repeatHeader:!0,headerType:"pivot-axis",headerRowIndex:0,cells:[...i?[{...o("",0,!0),colspan:i}]:[],{...o(e.request.spec.columns.map(t=>q.getMatrixLevelLabel(t,e.request.presentation)).join(" / "),i,!0),colspan:e.layout.columns.length-i,isNumeric:!1,className:""}]});for(const[t,m]of r.headerBands.entries())s.push({repeatHeader:!0,headerType:t===r.headerBands.length-1?"metrics":"pivot-level",headerRowIndex:s.length,cells:m.map((u,R)=>o(u,R,!0))});return{headers:s,rows:e.rows.map((t,m)=>({index:m,type:t.kind==="layout"&&t.role!=="member"?"subtotal":"data",subtotalLevel:String(t.rowPath.length),cells:r.row(t).map((u,R)=>o(u,R,!1))})),grandTotal:null,metadata:{tableType:"pivot",totalRows:e.rows.length,totalColumns:a.length,rowLevels:e.layout.columns.filter(t=>t.kind!=="measure").length,pivotLevels:e.request.spec.columns.length,hasGrandTotal:!1,columnOrder:a.map(t=>t.columnId),columns:a}}}function F(e){if(e===null||typeof e!="object"||Array.isArray(e))return!1;const r=Object.getPrototypeOf(e);return r===null||r===Object.prototype}function M(e,r,a){const o=new Set(r),s=Object.keys(e).find(i=>!o.has(i));if(s)throw new Error(`${a} contains unknown property "${s}"`)}function K(e,r="tableTotalsRequest"){if(!F(e))throw new Error(`${r} must be an object`);if(M(e,["source","columns"],r),e.source!=="documentFlatTable")throw new Error(`${r}.source must be documentFlatTable`);if(!Array.isArray(e.columns)||e.columns.length===0)throw new Error(`${r}.columns must be a non-empty array`);let a=0;const o=e.columns.map((t,m)=>{const u=`${r}.columns.${m}`;if(!F(t))throw new Error(`${u} must be an object`);M(t,["fieldId","role","behavior","metricAlias","label"],u);const R=typeof t.fieldId=="string"?t.fieldId.trim():"";if(!R)throw new Error(`${u}.fieldId must be a non-empty string`);if(t.role!=="detail"&&t.role!=="groupby"&&t.role!=="metric")throw new Error(`${u}.role is invalid`);const b=t.role;if(t.behavior!=="sum"&&t.behavior!=="avg"&&t.behavior!=="count"&&t.behavior!=="label")throw new Error(`${u}.behavior is invalid`);const P=t.behavior,l=typeof t.metricAlias=="string"?t.metricAlias.trim():void 0;if(t.metricAlias!==void 0&&!l)throw new Error(`${u}.metricAlias must be a non-empty string`);if(l&&b!=="metric")throw new Error(`${u}.metricAlias requires metric role`);if(P==="label"){if(a+=1,b==="metric")throw new Error(`${u}.behavior label requires a non-metric role`)}else if(b!=="metric")throw new Error(`${u}.${P} requires metric role`);if(t.label!==void 0&&typeof t.label!="string")throw new Error(`${u}.label must be a string`);return{fieldId:R,role:b,behavior:P,...l?{metricAlias:l}:{},...t.label!==void 0?{label:t.label}:{}}}),s=new Map,i=new Set;for(const t of o){if(t.metricAlias){if(i.has(t.metricAlias))throw new Error(`${r}.columns duplicates metricAlias "${t.metricAlias}"`);i.add(t.metricAlias)}const m=s.get(t.fieldId)??[];m.push(t),s.set(t.fieldId,m)}for(const[t,m]of s)if(m.length!==1){for(const u of m)if(u.role!=="metric"||!u.metricAlias)throw new Error(`${r}.columns duplicates fieldId "${t}" without distinct metricAlias values`)}if(a>1)throw new Error(`${r}.columns may contain at most one label`);return{source:"documentFlatTable",columns:o}}function Y(e,r="tableTotalsByColumnId"){if(!F(e))throw new Error(`${r} must be an object`);const a={};for(const[o,s]of Object.entries(e)){if(!o.trim())throw new Error(`${r} contains an empty column id`);if(s!==null&&typeof s!="string"&&(typeof s!="number"||!Number.isFinite(s)))throw new Error(`${r}.${o} must be a string, finite number, or null`);a[o]=s}if(Object.keys(a).length===0)throw new Error(`${r} must not be empty`);return a}function W(e){if(typeof e=="number")return Number.isFinite(e)?e:null;if(!e.trim())return null;const r=Number(e);return Number.isFinite(r)?r:null}function Q(e){const r=e.visibleColumns.map(a=>{const s=Object.prototype.hasOwnProperty.call(e.totalsByColumnId,a)?e.totalsByColumnId[a]:a===e.labelColumnKey?"Total":null;if(s===null)return"";if(!e.useFormattedValues)return String(s);const i=E.findResolvedNumericFormat({snapshot:e.snapshot,scope:e.scope,target:{kind:"column",columnKey:a}}),t=i?W(s):null;return i&&t!==null?c.formatNumericCanonical(t,i):String(s)});return`${n.arrayToCSVRow(r,e.delimiter)}
 `}exports.fromSemanticFormat=I.fromSemanticFormat;exports.isNumericCanonicalFormat=I.isNumericCanonicalFormat;exports.RawTemporalFormatContractError=c.RawTemporalFormatContractError;exports.assertRawTemporalChunkClassificationAgreement=c.assertRawTemporalChunkClassificationAgreement;exports.classifyDeclaredSqlTemporalColumn=c.classifyDeclaredSqlTemporalColumn;exports.createRawTemporalChunkClassificationEvidence=c.createRawTemporalChunkClassificationEvidence;exports.formatCurrency=c.formatCurrency;exports.formatNumber=c.formatNumber;exports.formatNumberCustom=c.formatNumberCustom;exports.formatNumberWithColumnSettings=c.formatNumberWithColumnSettings;exports.formatNumericCanonical=c.formatNumericCanonical;exports.formatPercent=c.formatPercent;exports.formatRawTemporalValue=c.formatRawTemporalValue;exports.formatScientific=c.formatScientific;exports.parseNumericCanonicalFormat=c.parseNumericCanonicalFormat;exports.parseRawTemporalChunkClassificationEvidence=c.parseRawTemporalChunkClassificationEvidence;exports.parseResolvedNumericCanonicalFormat=c.parseResolvedNumericCanonicalFormat;exports.parseResolvedRawTemporalFormat=c.parseResolvedRawTemporalFormat;exports.prepareRawTemporalFormatter=c.prepareRawTemporalFormatter;exports.resolveCurrencyFractionDigits=c.resolveCurrencyFractionDigits;exports.resolveNumericPresentation=c.resolveNumericPresentation;exports.resolveRawTemporalFormat=c.resolveRawTemporalFormat;exports.validateCardExportNumericPresentationSnapshot=c.validateCardExportNumericPresentationSnapshot;exports.validateRawTemporalPattern=c.validateRawTemporalPattern;exports.formatCellValue=T.formatCellValue;exports.formatDate=T.formatDate;exports.formatDuration=T.formatDuration;exports.formatRelativeTime=T.formatRelativeTime;exports.formatRowForExport=T.formatRowForExport;exports.getTimezoneAbbreviation=T.getTimezoneAbbreviation;exports.getTimezoneName=T.getTimezoneName;exports.parseWithSourceTimezone=T.parseWithSourceTimezone;exports.resolveTimezone=T.resolveTimezone;exports.AGGREGATE_PDF_CONTINUATION_CLASS=n.PDF_GROUP_CONTINUATION_CLASS;exports.AGGREGATE_TOTAL_MEMBER_MARKER=n.AGGREGATE_TOTAL_MEMBER_MARKER;exports.DIRECT_CSV_EXPORT_MAX_ROWS=n.DIRECT_CSV_EXPORT_MAX_ROWS;exports.FULL_DATASET_CSV_EXPORT_MAX_ROWS=n.FULL_DATASET_CSV_EXPORT_MAX_ROWS;exports.MATRIX_EXPORT_MAX_ARTIFACT_BYTES=n.MATRIX_EXPORT_MAX_ARTIFACT_BYTES;exports.MATRIX_EXPORT_MAX_CELLS=n.MATRIX_EXPORT_MAX_CELLS;exports.MATRIX_EXPORT_MAX_ENCODED_BYTES=n.MATRIX_EXPORT_MAX_ENCODED_BYTES;exports.PDF_GROUP_CONTINUATION_CLASS=n.PDF_GROUP_CONTINUATION_CLASS;exports.PdfSafetyLimitError=n.PdfSafetyLimitError;exports.PivotHeaderPresentationError=n.PivotHeaderPresentationError;exports.arrayToCSV=n.arrayToCSV;exports.arrayToCSVRow=n.arrayToCSVRow;exports.escapeCSVValue=n.escapeCSVValue;exports.formatAggregateGrandTotalLabel=n.formatAggregateGrandTotalLabel;exports.formatAggregateGroupCell=n.formatAggregateGroupCell;exports.formatAggregateGroupRow=n.formatAggregateGroupRow;exports.formatAggregateSubtotalLabel=n.formatAggregateSubtotalLabel;exports.formatMetricComparison=n.formatMetricComparison;exports.isAggregateTotalMemberMarker=n.isAggregateTotalMemberMarker;exports.objectsToCSV=n.objectsToCSV;exports.presentAggregateGroupRow=n.presentAggregateGroupRow;exports.presentPivotHeader=n.presentPivotHeader;exports.protectCSVText=n.protectCSVText;exports.readPdfErrorResponse=n.readPdfErrorResponse;exports.requestStructuredPdf=n.requestStructuredPdf;exports.requiresChunkedCsvExport=n.requiresChunkedCsvExport;exports.resolveAggregateTablePresentationContext=n.resolveAggregateTablePresentationContext;exports.shouldPresentAggregateGroupValue=n.shouldPresentAggregateGroupValue;exports.SEMAPHOR_GENERATED_COUNT_METRIC_ID=x.SEMAPHOR_GENERATED_COUNT_METRIC_ID;exports.MATRIX_EXPORT_TRANSFER_BYTES=h.MATRIX_EXPORT_TRANSFER_BYTES;exports.assertMatrixBatchResponseSize=h.assertMatrixBatchResponseSize;exports.matrixAttemptKey=h.matrixAttemptKey;exports.matrixBatchInputSchema=h.matrixBatchInputSchema;exports.matrixBatchResponseSchema=h.matrixBatchResponseSchema;exports.matrixExportDeadlineSchema=h.matrixExportDeadlineSchema;exports.matrixManifestSchema=h.matrixManifestSchema;exports.parseMatrixAttemptKey=h.parseMatrixAttemptKey;exports.parseMatrixBatchResponse=h.parseMatrixBatchResponse;exports.parseMatrixManifest=h.parseMatrixManifest;exports.FAST_PDF_POLICY=C.FAST_PDF_POLICY;exports.PDF_SAFETY_LIMIT_EXCEEDED=C.PDF_SAFETY_LIMIT_EXCEEDED;exports.getUtf8ByteLength=C.getUtf8ByteLength;exports.isFastPdfOutputSizeEligible=C.isFastPdfOutputSizeEligible;exports.isFastPdfPageCountEligible=C.isFastPdfPageCountEligible;exports.isFastPdfRequestSizeEligible=C.isFastPdfRequestSizeEligible;exports.isFastPdfRowCountEligible=C.isFastPdfRowCountEligible;exports.MissingResolvedRawTemporalFormatError=E.MissingResolvedRawTemporalFormatError;exports.PivotResultLifecycleError=E.PivotResultLifecycleError;exports.PresentationExecutionSnapshotError=E.PresentationExecutionSnapshotError;exports.createCanonicalPivotResultTransport=E.createCanonicalPivotResultTransport;exports.createPresentationExecutionSnapshot=E.createPresentationExecutionSnapshot;exports.deriveMetricInstanceAliasExpectations=E.deriveMetricInstanceAliasExpectations;exports.derivePivotResultContractExpectations=E.derivePivotResultContractExpectations;exports.findResolvedNumericFormat=E.findResolvedNumericFormat;exports.findResolvedRawTemporalFormat=E.findResolvedRawTemporalFormat;exports.findResolvedTemporalBucketFormat=E.findResolvedTemporalBucketFormat;exports.parseCanonicalPivotResultTransport=E.parseCanonicalPivotResultTransport;exports.parsePresentationExecutionSnapshot=E.parsePresentationExecutionSnapshot;exports.parsePresentationScope=E.parsePresentationScope;exports.parseResolvedPresentationEntries=E.parseResolvedPresentationEntries;exports.validateCardExportPresentationSnapshot=E.validateCardExportPresentationSnapshot;exports.DEFAULT_RESOLVED_TEMPORAL_STYLE_SET=d.DEFAULT_RESOLVED_TEMPORAL_STYLE_SET;exports.TEMPORAL_BUCKET_PATTERN_TOKENS=d.TEMPORAL_BUCKET_PATTERN_TOKENS;exports.TemporalBucketContractError=d.TemporalBucketContractError;exports.formatTemporalBucket=d.formatTemporalBucket;exports.isTemporalBucketPreset=d.isTemporalBucketPreset;exports.parseResolvedTemporalBucketFormat=d.parseResolvedTemporalBucketFormat;exports.parseTemporalBucketValue=d.parseTemporalBucketValue;exports.resolveApplicableTemporalBucketFormat=d.resolveApplicableTemporalBucketFormat;exports.resolveTemporalBucketPresentation=d.resolveTemporalBucketPresentation;exports.tokenizeTemporalBucketPattern=d.tokenizeTemporalBucketPattern;exports.validateTemporalBucketFormatApplicability=d.validateTemporalBucketFormatApplicability;exports.resolveMetricResultAlias=X.resolveMetricResultAlias;exports.PivotResultIdentityError=w.PivotResultIdentityError;exports.isPivotEmptyTupleAllowed=w.isPivotEmptyTupleAllowed;exports.isPivotSubtotalPrefix=w.isPivotSubtotalPrefix;exports.requirePivotHeaderMembers=w.requirePivotHeaderMembers;exports.requirePivotResultColumnIdentities=w.requirePivotResultColumnIdentities;exports.resolveQueryColumnKeyMapEntry=w.resolveQueryColumnKeyMapEntry;exports.resolveUniqueQueryColumnKeyMapEntry=w.resolveUniqueQueryColumnKeyMapEntry;exports.parseRawTemporalValueMetadata=N.parseRawTemporalValueMetadata;exports.validateRawTemporalResultColumn=N.validateRawTemporalResultColumn;exports.buildFlatTableExportTotalsFooter=Q;exports.buildMatrixTableStructure=z;exports.formatPivotDataRow=L;exports.formatPivotTableForCSV=H;exports.formatTableForCSV=O;exports.generatePivotHeaders=k;exports.generateTableCSV=$;exports.matrixFlatCsvHeaders=U;exports.matrixFlatCsvRow=j;exports.parseFlatTableExportTotalsByColumnId=Y;exports.parseFlatTableExportTotalsRequest=K;exports.prepareMatrixExportPresentation=B;