react-semaphor 0.1.398 → 0.1.400

package/dist/chunks/analyze-result-contract-BUgK3759.js

@@ -0,0 +1,1833 @@
+import { z as e } from "zod";
+const B = {
+  answerSummary: "string",
+  responseDetail: "responseDetail",
+  mode: "string",
+  comparisonType: "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"
+}, K = "semaphor-data-app-codegen-summary/v1", Ht = "semaphor-data-app-codegen-summary-validator/v2", ge = /* @__PURE__ */ new Set([
+  "metric",
+  "records",
+  "matrix",
+  "analysis",
+  "sql_fallback"
+]), he = /* @__PURE__ */ new Set([
+  "semaphor.metric",
+  "semaphor.records",
+  "semaphor.matrix",
+  "semaphor.analysis",
+  "semaphor.sql"
+]), fe = /* @__PURE__ */ new Set([
+  "absolute_delta",
+  "largest_negative",
+  "largest_positive",
+  "positive_and_negative",
+  "all"
+]), W = /* @__PURE__ */ new Set([
+  "source",
+  "id",
+  "label",
+  "measures",
+  "primaryMeasure",
+  "dateField",
+  "timeGrain",
+  "dimensions",
+  "comparison",
+  "orderBy",
+  "filters",
+  "relationshipHint",
+  "limit",
+  "derivedFields"
+]), be = /* @__PURE__ */ new Set([
+  ...W,
+  "analysis",
+  "timeWindow",
+  "filters",
+  "driverMode",
+  "includePopulation",
+  "calendarContext",
+  "chartTitle",
+  "chartType"
+]), ye = /* @__PURE__ */ new Set([
+  "source",
+  "id",
+  "label",
+  "fields",
+  "dateField",
+  "timeGrain",
+  "timeWindow",
+  "filters",
+  "orderBy",
+  "relationshipHint",
+  "limit",
+  "pagination",
+  "totals",
+  "derivedFields"
+]), ve = /* @__PURE__ */ new Set([
+  "source",
+  "id",
+  "label",
+  "filters",
+  "relationshipHint",
+  "rows",
+  "columns",
+  "values",
+  "totals",
+  "sort",
+  "expansion",
+  "layout",
+  "displayLimits"
+]), $e = /* @__PURE__ */ new Set([
+  "source",
+  "id",
+  "label",
+  "sql",
+  "defaultParameters",
+  "pythonCode",
+  "fields",
+  "limit",
+  "pagination",
+  "rationale"
+]), Se = /* @__PURE__ */ new Set([
+  "kpi",
+  "line_chart",
+  "bar_chart",
+  "stacked_bar_chart",
+  "pie_chart",
+  "donut_chart",
+  "area_chart",
+  "table",
+  "matrix",
+  "narrative",
+  "text_block",
+  "custom"
+]), we = /* @__PURE__ */ new Set([
+  "missing_measure",
+  "missing_dimension",
+  "missing_date",
+  "missing_relationship",
+  "missing_semantic_role",
+  "missing_current_app_state",
+  "unsupported_change_intent",
+  "ambiguous_field_grounding",
+  "invalid_ranker_output",
+  "latest_snapshot_selector_not_modeled",
+  "unsupported_grain",
+  "requires_sql_escape_hatch",
+  "unsupported_sdk_capability"
+]);
+function Qt(i) {
+  return Z(i).ok;
+}
+function Z(i) {
+  const o = [];
+  if (!i || typeof i != "object")
+    return { ok: !1, issues: ["Summary must be an object."] };
+  const t = i;
+  return t.schemaVersion !== K && o.push(
+    `schemaVersion must be ${K}.`
+  ), (typeof t.title != "string" || !t.title.trim()) && o.push("title is required."), Array.isArray(t.sources) || o.push("sources must be an array."), Array.isArray(t.inputs) || o.push("inputs must be an array."), Array.isArray(t.views) || o.push("views must be an array."), Array.isArray(t.filterContracts) || o.push("filterContracts must be an array."), (!t.implementationChecklist || typeof t.implementationChecklist != "object") && o.push("implementationChecklist must be an object."), t.implementationChecklist && typeof t.implementationChecklist == "object" && o.push(
+    ...Ie(t.implementationChecklist)
+  ), Array.isArray(t.sources) && t.sources.forEach((s, n) => {
+    o.push(...w(s, `sources.${n}`));
+  }), Array.isArray(t.inputs) && t.inputs.forEach((s, n) => {
+    o.push(...Ae(s, `inputs.${n}`));
+  }), Array.isArray(t.views) && t.views.forEach((s, n) => {
+    o.push(..._e(s, `views.${n}`));
+  }), Array.isArray(t.filterContracts) && t.filterContracts.forEach((s, n) => {
+    o.push(
+      ...Ee(s, `filterContracts.${n}`)
+    );
+  }), t.unsupportedInsights !== void 0 && (Array.isArray(t.unsupportedInsights) ? t.unsupportedInsights.forEach((s, n) => {
+    o.push(
+      ...Ze(
+        s,
+        `unsupportedInsights.${n}`
+      )
+    );
+  }) : o.push("unsupportedInsights must be an array.")), o.push(...ke(t)), { ok: o.length === 0, issues: o };
+}
+function ke(i) {
+  const o = Array.isArray(i.unsupportedInsights) && i.unsupportedInsights.some(
+    (l) => {
+      var u;
+      return ((u = a(l)) == null ? void 0 : u.reason) === "missing_relationship";
+    }
+  ), t = Array.isArray(i.views) && i.views.some((l) => {
+    var c;
+    const u = a((c = a(l)) == null ? void 0 : c.computation);
+    return (u == null ? void 0 : u.kind) === "unsupported" && u.reason === "missing_relationship";
+  });
+  if (!o && !t)
+    return [];
+  const s = [], n = a(i.validation);
+  (n == null ? void 0 : n.status) !== "blocked" && s.push(
+    "validation.status must be blocked when missing_relationship gaps are present."
+  );
+  const r = a(i.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 missing_relationship gaps are present."
+  ), s;
+}
+function w(i, o) {
+  const t = a(i);
+  return t ? t.kind === "semantic" ? typeof t.domainId == "string" && t.domainId.trim() && typeof t.datasetName == "string" && t.datasetName.trim() ? [] : [`${o} 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() ? [] : [`${o} must include sourceKey or a supported source identity.`] : [`${o} must be an object.`];
+}
+function Ie(i) {
+  const o = a(i);
+  if (!o)
+    return ["implementationChecklist must be an object."];
+  const t = [], s = [
+    "requiredDevtools",
+    "requiredInputOptions",
+    "filterScopeByInput",
+    "bindingsByView",
+    "validationCommands",
+    "browserSmokeChecks"
+  ];
+  for (const r of s)
+    r in o || t.push(`implementationChecklist.${r} is required.`);
+  const n = a(o.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(o.requiredInputOptions) || t.push(
+    "implementationChecklist.requiredInputOptions must be an array."
+  ), Array.isArray(o.filterScopeByInput) || t.push("implementationChecklist.filterScopeByInput must be an array."), a(o.bindingsByView) || t.push("implementationChecklist.bindingsByView must be an object."), g(o.validationCommands) || t.push(
+    "implementationChecklist.validationCommands must be an array of strings."
+  ), g(o.browserSmokeChecks) || t.push(
+    "implementationChecklist.browserSmokeChecks must be an array of strings."
+  ), t;
+}
+function Ae(i, o) {
+  const t = a(i);
+  if (!t)
+    return [`${o} must be an object.`];
+  const s = [];
+  return (typeof t.id != "string" || !t.id.trim()) && s.push(`${o}.id is required.`), t.fieldRef && s.push(...p(t.fieldRef, `${o}.fieldRef`)), s.push(...X(t.optionQuery, `${o}.optionQuery`)), g(t.appliesToViewIds) || s.push(`${o}.appliesToViewIds must be an array of strings.`), t.bindings !== void 0 && !Array.isArray(t.bindings) && s.push(`${o}.bindings must be an array.`), Array.isArray(t.bindings) && t.bindings.forEach((n, r) => {
+    const l = a(n);
+    if (!l) {
+      s.push(`${o}.bindings.${r} must be an object.`);
+      return;
+    }
+    g(l.appliesToViewIds) || s.push(
+      `${o}.bindings.${r}.appliesToViewIds must be an array of strings.`
+    ), s.push(
+      ...p(
+        l.fieldRef,
+        `${o}.bindings.${r}.fieldRef`
+      )
+    );
+  }), s;
+}
+function _e(i, o) {
+  const t = a(i);
+  if (!t)
+    return [`${o} must be an object.`];
+  const s = [];
+  if ((typeof t.id != "string" || !t.id.trim()) && s.push(`${o}.id is required.`), t.visualSpec !== void 0 && s.push(...Ge(t.visualSpec, `${o}.visualSpec`)), t.computation !== void 0 && s.push(...We(t.computation, `${o}.computation`)), Le(t))
+    return s.push(...E(t, `${o}`)), t.fields !== void 0 && (Array.isArray(t.fields) ? t.fields.forEach((r, l) => {
+      s.push(...p(r, `${o}.fields.${l}`));
+    }) : s.push(`${o}.fields must be an array.`)), t.queryKind !== void 0 && s.push(`${o}.queryKind is not allowed for non-executable views.`), t.sdkBuilder !== void 0 && s.push(`${o}.sdkBuilder is not allowed for non-executable views.`), t.sdkSpec !== void 0 && s.push(`${o}.sdkSpec is not allowed for non-executable views.`), s;
+  if (!Array.isArray(t.fields))
+    return s.push(`${o}.fields must be an array.`), (t.sdkSpec !== void 0 || t.sdkBuilder !== void 0) && s.push(`${o}.fields must be an array for executable views.`), s.push(...E(t, `${o}`)), s;
+  t.fields.forEach((r, l) => {
+    s.push(...p(r, `${o}.fields.${l}`));
+  }), $(t.queryKind) || s.push(`${o}.queryKind must be a supported codegen query kind.`), t.sdkBuilder !== void 0 && !ee(t.sdkBuilder) && s.push(`${o}.sdkBuilder must be a supported SDK builder.`);
+  const n = a(t.computation);
+  return (n == null ? void 0 : n.kind) === "server_query" && $(t.queryKind) && $(n.queryKind) && n.queryKind !== t.queryKind && s.push(`${o}.computation.queryKind must match queryKind.`), s.push(
+    ...Fe({
+      value: t.sdkSpec,
+      path: `${o}.sdkSpec`,
+      queryKind: typeof t.queryKind == "string" ? t.queryKind : void 0,
+      sdkBuilder: typeof t.sdkBuilder == "string" ? t.sdkBuilder : void 0
+    }),
+    ...E(t, `${o}`)
+  ), s;
+}
+function E(i, o) {
+  var G;
+  const t = a((G = a(i.visualSpec)) == null ? void 0 : G.tableBehavior), s = a(i.sdkSpec), n = a(s == null ? void 0 : s.spec), r = typeof (s == null ? void 0 : s.builder) == "string" ? s.builder : void 0, l = r === "semaphor.records" ? a(n == null ? void 0 : n.totals) : void 0, u = [];
+  if (!t)
+    return l && u.push(
+      `${o}.sdkSpec.spec.totals is only allowed when tableBehavior.totals.mode is server.`
+    ), u;
+  const c = a(t.totals);
+  return c ? (c.mode === "server" && (r !== "semaphor.records" && u.push(
+    `${o}.visualSpec.tableBehavior.totals.mode server is only supported for semaphor.records views.`
+  ), !l || l.mode !== "server" ? u.push(
+    `${o}.sdkSpec.spec.totals.mode must be server when tableBehavior.totals.mode is server.`
+  ) : u.push(
+    ...je({
+      left: c.measures,
+      right: l.measures,
+      leftPath: `${o}.visualSpec.tableBehavior.totals.measures`,
+      rightPath: `${o}.sdkSpec.spec.totals.measures`
+    })
+  )), c.mode !== "server" && l && u.push(
+    `${o}.sdkSpec.spec.totals is only allowed when tableBehavior.totals.mode is server.`
+  ), r === "semaphor.sql" && c.mode !== "none" && u.push(
+    `${o}.visualSpec.tableBehavior.totals.mode must be none for semaphor.sql views.`
+  ), r === "semaphor.sql" && a(n == null ? void 0 : n.totals) && u.push(`${o}.sdkSpec.spec.totals is not supported for semaphor.sql.`), u) : (l && u.push(
+    `${o}.sdkSpec.spec.totals is only allowed when tableBehavior.totals.mode is server.`
+  ), u);
+}
+function je({
+  left: i,
+  right: o,
+  leftPath: t,
+  rightPath: s
+}) {
+  if (!Array.isArray(i) || !Array.isArray(o))
+    return [`${s} must match ${t}.`];
+  const n = [];
+  return i.length !== o.length ? (n.push(`${s} must match ${t}.`), n) : (i.forEach((r, l) => {
+    Re(
+      a(r),
+      a(o[l])
+    ) || n.push(`${s}.${l} must match ${t}.${l}.`);
+  }), n);
+}
+function Re(i, o) {
+  return !i || !o ? !1 : i.name === o.name && (i.role || "measure") === (o.role || "measure") && U(i) === U(o) && Ce(i, o);
+}
+function U(i) {
+  return typeof i.aggregate == "string" ? i.aggregate.toUpperCase() : "SUM";
+}
+function Ce(i, o) {
+  const t = a(i.source), s = a(o.source);
+  if (qe(t, s))
+    return !1;
+  const n = z(i), r = z(o);
+  if (n.size > 0 || r.size > 0) {
+    for (const l of n)
+      if (r.has(l))
+        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 qe(i, o) {
+  if (!i || !o || i.kind !== "semantic" || o.kind !== "semantic")
+    return !1;
+  const t = typeof i.datasetId == "string" ? i.datasetId.trim() : "", s = typeof o.datasetId == "string" ? o.datasetId.trim() : "";
+  return !!(t && s && t !== s);
+}
+function z(i) {
+  const o = typeof i.sourceKey == "string" ? i.sourceKey.trim() : "";
+  return o ? /* @__PURE__ */ new Set([o]) : xe(a(i.source));
+}
+function xe(i) {
+  const o = /* @__PURE__ */ new Set();
+  if (!i)
+    return o;
+  const t = typeof i.sourceKey == "string" ? i.sourceKey.trim() : "";
+  if (t && o.add(t), i.kind === "semantic") {
+    const s = typeof i.domainId == "string" ? i.domainId : "", n = typeof i.datasetName == "string" ? i.datasetName : "", r = typeof i.datasetId == "string" ? i.datasetId : "";
+    s && r && o.add(`semantic:${s}:datasetId:${r}`), s && n && o.add(`semantic:${s}:datasetName:${n}`);
+  }
+  if (i.kind === "physical") {
+    const s = typeof i.connectionId == "string" ? i.connectionId : "", n = typeof i.tableName == "string" ? i.tableName : "", r = typeof i.databaseName == "string" ? i.databaseName : "", l = typeof i.schemaName == "string" ? i.schemaName : "";
+    s && n && (o.add(
+      ["physical", s, r, l, n].join(":")
+    ), o.add(`physical:${s}:${n}`));
+  }
+  if (i.kind === "sql") {
+    const s = typeof i.connectionId == "string" ? i.connectionId : "", n = typeof i.dialect == "string" ? i.dialect : "", r = typeof i.label == "string" ? i.label : "";
+    s && (o.add(["sql", s, n, r].join(":")), o.add(`sql:${s}`));
+  }
+  return o;
+}
+function Ee(i, o) {
+  const t = a(i);
+  if (!t)
+    return [`${o} must be an object.`];
+  const s = [];
+  if (t.fieldRef && s.push(
+    ...p(t.fieldRef, `${o}.fieldRef`)
+  ), (typeof t.inputId != "string" || !t.inputId.trim()) && s.push(`${o}.inputId is required.`), s.push(
+    ...X(t.optionQuery, `${o}.optionQuery`)
+  ), g(t.appliesToViewIds) || s.push(`${o}.appliesToViewIds must be an array of strings.`), g(t.notAppliedToViewIds) || s.push(`${o}.notAppliedToViewIds must be an array of strings.`), !Array.isArray(t.bindings))
+    s.push(`${o}.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((l, u) => {
+      const c = a(l);
+      if (!c) {
+        s.push(`${o}.bindings.${u} must be an object.`);
+        return;
+      }
+      typeof c.viewId != "string" || !c.viewId ? s.push(`${o}.bindings.${u}.viewId is required.`) : (n && !n.has(c.viewId) && s.push(
+        `${o}.bindings.${u}.viewId must be included in appliesToViewIds.`
+      ), r != null && r.has(c.viewId) && s.push(
+        `${o}.bindings.${u}.viewId must not be listed in notAppliedToViewIds.`
+      )), s.push(
+        ...p(
+          c.fieldRef,
+          `${o}.bindings.${u}.fieldRef`
+        )
+      );
+    });
+  }
+  return s;
+}
+function X(i, o) {
+  if (i === void 0)
+    return [];
+  const t = a(i);
+  if (!t)
+    return [`${o} must be an object.`];
+  const s = [
+    ...h(
+      t.valueFieldRef,
+      `${o}.valueFieldRef`
+    ),
+    ...h(
+      t.labelFieldRef,
+      `${o}.labelFieldRef`
+    ),
+    ...h(
+      t.filterFieldRef,
+      `${o}.filterFieldRef`
+    )
+  ];
+  return t.builder !== "semaphor.inputOptions" && s.push(`${o}.builder must be semaphor.inputOptions.`), typeof t.sourceKey != "string" && t.source === void 0 && s.push(`${o} must include source or sourceKey.`), t.source !== void 0 && s.push(...w(t.source, `${o}.source`)), a(t.valueFieldRef) || s.push(`${o}.valueFieldRef is required.`), a(t.labelFieldRef) || s.push(`${o}.labelFieldRef is required.`), t.limit !== void 0 && (typeof t.limit != "number" || !Number.isInteger(t.limit) || t.limit <= 0) && s.push(`${o}.limit must be a positive integer.`), s;
+}
+function Fe(i) {
+  var n;
+  const o = a(i.value);
+  if (!o)
+    return [`${i.path} is required for executable views.`];
+  const t = [];
+  if (!ee(o.builder))
+    return t.push(`${i.path}.builder must be a supported SDK builder.`), t;
+  i.sdkBuilder && o.builder !== i.sdkBuilder && t.push(`${i.path}.builder must match sdkBuilder.`), i.queryKind && $(i.queryKind) && o.builder !== Ve(i.queryKind) && t.push(`${i.path}.builder must match queryKind.`);
+  const s = a(o.spec);
+  if (!s)
+    return t.push(`${i.path}.spec must be an object.`), t;
+  switch (o.builder) {
+    case "semaphor.metric":
+      t.push(
+        ...v(s, W, `${i.path}.spec`),
+        ...A(s, i.path),
+        ...F(s.measures, `${i.path}.spec.measures`),
+        ...h(
+          s.primaryMeasure,
+          `${i.path}.spec.primaryMeasure`
+        ),
+        ...h(
+          s.dateField,
+          `${i.path}.spec.dateField`
+        ),
+        ...N(
+          s.dimensions,
+          `${i.path}.spec.dimensions`
+        ),
+        ...T(s.orderBy, `${i.path}.spec.orderBy`),
+        ..._(s.filters, `${i.path}.spec.filters`)
+      );
+      break;
+    case "semaphor.analysis":
+      t.push(
+        ...v(s, be, `${i.path}.spec`),
+        ...A(s, i.path),
+        ...F(s.measures, `${i.path}.spec.measures`),
+        ...h(
+          s.primaryMeasure,
+          `${i.path}.spec.primaryMeasure`
+        ),
+        ...h(
+          s.dateField,
+          `${i.path}.spec.dateField`
+        ),
+        ...N(
+          s.dimensions,
+          `${i.path}.spec.dimensions`
+        ),
+        ...T(s.orderBy, `${i.path}.spec.orderBy`),
+        ..._(s.filters, `${i.path}.spec.filters`),
+        ...Ne(s, `${i.path}.spec`)
+      );
+      break;
+    case "semaphor.records":
+      t.push(
+        ...v(s, ye, `${i.path}.spec`),
+        ...A(s, i.path),
+        ...F(s.fields, `${i.path}.spec.fields`),
+        ...h(
+          s.dateField,
+          `${i.path}.spec.dateField`
+        ),
+        ...T(s.orderBy, `${i.path}.spec.orderBy`),
+        ..._(s.filters, `${i.path}.spec.filters`),
+        ...Te(
+          s.totals,
+          `${i.path}.spec.totals`
+        )
+      );
+      break;
+    case "semaphor.matrix":
+      t.push(
+        ...v(s, ve, `${i.path}.spec`),
+        ...De(s, i.path),
+        ...Ke(s.rows, `${i.path}.spec.rows`),
+        ...Oe(
+          s.columns,
+          `${i.path}.spec.columns`
+        ),
+        ...Me(s.values, `${i.path}.spec.values`),
+        ...Be(s.sort, `${i.path}.spec.sort`),
+        ..._(s.filters, `${i.path}.spec.filters`)
+      );
+      break;
+    case "semaphor.sql":
+      t.push(
+        ...v(s, $e, `${i.path}.spec`),
+        ...A(s, i.path)
+      ), ((n = a(s.source)) == null ? void 0 : n.kind) !== "sql" && t.push(`${i.path}.spec.source.kind must be sql.`), (typeof s.sql != "string" || !s.sql.trim()) && t.push(`${i.path}.spec.sql is required.`), t.push(
+        ...N(
+          s.fields,
+          `${i.path}.spec.fields`
+        )
+      );
+      break;
+  }
+  return t;
+}
+function Ne(i, o) {
+  const t = [];
+  if (i.driverMode !== void 0 && !fe.has(i.driverMode) && t.push(`${o}.driverMode must be a supported analysis driver mode.`), i.includePopulation !== void 0 && typeof i.includePopulation != "boolean" && t.push(`${o}.includePopulation must be a boolean.`), i.calendarContext !== void 0) {
+    const s = a(i.calendarContext);
+    if (!s)
+      t.push(`${o}.calendarContext must be an object.`);
+    else {
+      s.tz !== void 0 && typeof s.tz != "string" && t.push(`${o}.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(
+        `${o}.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(`${o}.calendarContext.anchor must be now or { iso }.`);
+      }
+    }
+  }
+  return t;
+}
+function Te(i, o) {
+  if (i === void 0)
+    return [];
+  const t = a(i);
+  if (!t)
+    return [`${o} must be an object.`];
+  const s = [];
+  return t.mode !== "server" && s.push(`${o}.mode must be server.`), !Array.isArray(t.measures) || t.measures.length === 0 ? s.push(`${o}.measures must include at least one measure.`) : t.measures.forEach((n, r) => {
+    var l;
+    s.push(
+      ...te(
+        n,
+        `${o}.measures.${r}`
+      )
+    ), ((l = a(n)) == null ? void 0 : l.role) !== "measure" && s.push(`${o}.measures.${r}.role must be measure.`);
+  }), s;
+}
+function v(i, o, t) {
+  const s = [];
+  return Object.keys(i).forEach((n) => {
+    o.has(n) || s.push(`${t}.${n} is not supported for this SDK builder.`);
+  }), s;
+}
+function A(i, o) {
+  return a(i.source) ? w(i.source, `${o}.spec.source`) : [`${o}.spec.source must be an object.`];
+}
+function De(i, o) {
+  const t = a(i.source);
+  if (!t)
+    return [`${o}.spec.source must be an object.`];
+  const s = w(i.source, `${o}.spec.source`);
+  return t.kind !== "semantic" && t.kind !== "physical" && s.push(`${o}.spec.source.kind must be semantic or physical.`), s;
+}
+function F(i, o) {
+  const t = P(i, o);
+  return Array.isArray(i) && i.forEach((s, n) => {
+    t.push(...p(s, `${o}.${n}`));
+  }), t;
+}
+function N(i, o) {
+  if (i === void 0)
+    return [];
+  if (!Array.isArray(i))
+    return [`${o} must be an array.`];
+  const t = [];
+  return i.forEach((s, n) => {
+    t.push(...p(s, `${o}.${n}`));
+  }), t;
+}
+function T(i, o) {
+  if (i === void 0)
+    return [];
+  const t = a(i);
+  return t ? [
+    ...p(t.field, `${o}.field`),
+    ...J(t.direction, `${o}.direction`)
+  ] : [`${o} must be an object.`];
+}
+function Ke(i, o) {
+  const t = P(i, o);
+  return Array.isArray(i) && i.forEach((s, n) => {
+    const r = a(s);
+    if (!r) {
+      t.push(`${o}.${n} must be an object.`);
+      return;
+    }
+    t.push(
+      ...p(r.field, `${o}.${n}.field`)
+    );
+  }), t;
+}
+function Oe(i, o) {
+  if (i === void 0)
+    return [];
+  const t = [];
+  return Array.isArray(i) ? (i.forEach((s, n) => {
+    const r = a(s);
+    if (!r) {
+      t.push(`${o}.${n} must be an object.`);
+      return;
+    }
+    t.push(
+      ...p(r.field, `${o}.${n}.field`)
+    );
+  }), t) : [`${o} must be an array.`];
+}
+function Me(i, o) {
+  const t = P(i, o);
+  return Array.isArray(i) && i.forEach((s, n) => {
+    const r = a(s);
+    if (!r) {
+      t.push(`${o}.${n} must be an object.`);
+      return;
+    }
+    t.push(
+      ...p(r.field, `${o}.${n}.field`)
+    );
+  }), t;
+}
+function Be(i, o) {
+  if (i === void 0)
+    return [];
+  if (!Array.isArray(i))
+    return [`${o} must be an array.`];
+  const t = [];
+  return i.forEach((s, n) => {
+    const r = a(s);
+    if (!r) {
+      t.push(`${o}.${n} must be an object.`);
+      return;
+    }
+    r.axis !== "row" && r.axis !== "column" && t.push(`${o}.${n}.axis must be row or column.`), t.push(
+      ...J(r.direction, `${o}.${n}.direction`),
+      ...Pe(r.by, `${o}.${n}.by`)
+    );
+  }), t;
+}
+function Pe(i, o) {
+  const t = a(i);
+  if (!t)
+    return [`${o} must be an object.`];
+  switch (t.kind) {
+    case "label":
+      return [];
+    case "field":
+      return p(t.field, `${o}.field`);
+    case "value":
+      return typeof t.valueId != "string" || !t.valueId.trim() ? [`${o}.valueId is required.`] : [];
+    default:
+      return [`${o}.kind must be label, field, or value.`];
+  }
+}
+function J(i, o) {
+  return i === "asc" || i === "desc" ? [] : [`${o} must be asc or desc.`];
+}
+function _(i, o) {
+  if (i === void 0)
+    return [];
+  if (!Array.isArray(i))
+    return [`${o} must be an array.`];
+  const t = [];
+  return i.forEach((s, n) => {
+    const r = a(s);
+    if (!r) {
+      t.push(`${o}.${n} must be an object.`);
+      return;
+    }
+    t.push(...p(r.field, `${o}.${n}.field`));
+  }), t;
+}
+function P(i, o) {
+  return !Array.isArray(i) || i.length === 0 ? [`${o} must be a non-empty array.`] : [];
+}
+function Ve(i) {
+  switch (i) {
+    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 Le(i) {
+  const o = a(i.computation), t = a(i.visualSpec);
+  return (o == null ? void 0 : o.kind) === "presentation_only" || (o == null ? void 0 : o.kind) === "derived" || (o == null ? void 0 : o.kind) === "unsupported" || i.visual === "text_block" || (t == null ? void 0 : t.visualType) === "text_block";
+}
+function Ge(i, o) {
+  const t = a(i);
+  if (!t)
+    return [`${o} must be an object.`];
+  const s = [];
+  return Se.has(t.visualType) || s.push(`${o}.visualType must be a supported visual type.`), t.limit !== void 0 && (typeof t.limit != "number" || !Number.isInteger(t.limit) || t.limit <= 0) && s.push(`${o}.limit must be a positive integer.`), t.tableBehavior !== void 0 && s.push(
+    ...Ue(
+      t.tableBehavior,
+      `${o}.tableBehavior`
+    )
+  ), s;
+}
+function Ue(i, o) {
+  const t = a(i);
+  if (!t)
+    return [`${o} must be an object.`];
+  const s = [];
+  return t.tableMode !== "bounded" && t.tableMode !== "server_paginated" && t.tableMode !== "server_windowed" && s.push(`${o}.tableMode must be a supported table mode.`), s.push(
+    ...ze(t.height, `${o}.height`),
+    ...He(t.pagination, `${o}.pagination`),
+    ...Qe(t.sorting, `${o}.sorting`),
+    ...Ye(t.totals, `${o}.totals`)
+  ), typeof t.serverSideRequired != "boolean" && s.push(`${o}.serverSideRequired must be a boolean.`), s;
+}
+function ze(i, o) {
+  const t = a(i);
+  if (!t)
+    return [`${o} must be an object.`];
+  const s = [];
+  return (typeof t.maxPx != "number" || !Number.isInteger(t.maxPx) || t.maxPx <= 0) && s.push(`${o}.maxPx must be a positive integer.`), t.scroll !== "vertical" && t.scroll !== "both" && s.push(`${o}.scroll must be vertical or both.`), typeof t.stickyHeader != "boolean" && s.push(`${o}.stickyHeader must be a boolean.`), s;
+}
+function He(i, o) {
+  const t = a(i);
+  if (!t)
+    return [`${o} must be an object.`];
+  const s = [];
+  return t.mode !== "none" && t.mode !== "server" && t.mode !== "client_for_bounded_rows" && s.push(`${o}.mode must be a supported pagination mode.`), t.pageSize !== void 0 && (typeof t.pageSize != "number" || !Number.isInteger(t.pageSize) || t.pageSize <= 0) && s.push(`${o}.pageSize must be a positive integer.`), t.readsFrom !== void 0 && t.readsFrom !== "result.pagination" && s.push(`${o}.readsFrom must be result.pagination.`), s;
+}
+function Qe(i, o) {
+  const t = a(i);
+  if (!t)
+    return [`${o} must be an object.`];
+  const s = [];
+  return t.mode !== "server" && t.mode !== "client_for_bounded_rows" && s.push(`${o}.mode must be a supported sorting mode.`), t.defaultField !== void 0 && (typeof t.defaultField != "string" || !t.defaultField.trim()) && s.push(`${o}.defaultField must be a non-empty string.`), t.defaultDirection !== void 0 && t.defaultDirection !== "asc" && t.defaultDirection !== "desc" && s.push(`${o}.defaultDirection must be asc or desc.`), t.resetPageOnChange !== void 0 && typeof t.resetPageOnChange != "boolean" && s.push(`${o}.resetPageOnChange must be a boolean.`), s;
+}
+function Ye(i, o) {
+  const t = a(i);
+  if (!t)
+    return [`${o} must be an object.`];
+  const s = [];
+  return t.mode !== "none" && t.mode !== "server" && t.mode !== "local" ? (s.push(`${o}.mode must be none, server, or local.`), s) : t.mode === "none" ? (t.measures !== void 0 && s.push(`${o}.measures is not allowed when mode is none.`), t.label !== void 0 && s.push(`${o}.label is not allowed when mode is none.`), s) : t.mode === "server" ? (!Array.isArray(t.measures) || t.measures.length === 0 ? s.push(`${o}.measures must include at least one measure when mode is server.`) : t.measures.forEach((n, r) => {
+    var l;
+    s.push(
+      ...te(
+        n,
+        `${o}.measures.${r}`
+      )
+    ), ((l = a(n)) == null ? void 0 : l.role) !== "measure" && s.push(`${o}.measures.${r}.role must be measure.`);
+  }), t.label !== void 0 && s.push(`${o}.label is not allowed when mode is server.`), s) : (t.mode === "local" && (t.label !== "Displayed rows" && t.label !== "Current page" && s.push(`${o}.label must be Displayed rows or Current page when mode is local.`), t.measures !== void 0 && s.push(`${o}.measures is not allowed when mode is local.`)), s);
+}
+function We(i, o) {
+  const t = a(i);
+  if (!t)
+    return [`${o} must be an object.`];
+  const s = [];
+  switch (t.kind) {
+    case "server_query":
+      $(t.queryKind) || s.push(`${o}.queryKind must be a supported codegen query kind.`), t.queryOwnership !== void 0 && t.queryOwnership !== "view_owned" && t.queryOwnership !== "shared_query" && s.push(
+        `${o}.queryOwnership must be view_owned or shared_query.`
+      ), t.sourceKeys !== void 0 && !g(t.sourceKeys) && s.push(`${o}.sourceKeys must be an array of strings.`), t.fieldNames !== void 0 && !g(t.fieldNames) && s.push(`${o}.fieldNames must be an array of strings.`);
+      break;
+    case "derived":
+      (typeof t.upstreamViewId != "string" || !t.upstreamViewId.trim()) && s.push(`${o}.upstreamViewId is required.`), (typeof t.derivation != "string" || !t.derivation.trim()) && s.push(`${o}.derivation is required.`);
+      break;
+    case "presentation_only":
+      break;
+    case "unsupported":
+      (typeof t.reason != "string" || !t.reason.trim()) && s.push(`${o}.reason is required.`), (typeof t.suggestedModelingFix != "string" || !t.suggestedModelingFix.trim()) && s.push(`${o}.suggestedModelingFix is required.`);
+      break;
+    default:
+      s.push(`${o}.kind must be a supported computation kind.`);
+  }
+  return s;
+}
+function Ze(i, o) {
+  const t = a(i);
+  if (!t)
+    return [`${o} must be an object.`];
+  const s = [];
+  for (const r of ["title", "requestedQuestion", "suggestedModelingFix"])
+    (typeof t[r] != "string" || !t[r].trim()) && s.push(`${o}.${r} is required.`);
+  return we.has(t.reason) || s.push(`${o}.reason must be a supported unsupported insight reason.`), (t.relationshipCandidate !== void 0 || t.nextRepairAction !== void 0) && t.reason !== "missing_relationship" && s.push(
+    `${o} relationship repair metadata is only valid for missing_relationship unsupported insights.`
+  ), t.relationshipCandidate !== void 0 && s.push(
+    ...Je(
+      t.relationshipCandidate,
+      `${o}.relationshipCandidate`
+    )
+  ), t.nextRepairAction !== void 0 && s.push(
+    ...Xe(
+      t.nextRepairAction,
+      `${o}.nextRepairAction`
+    )
+  ), s;
+}
+function Xe(i, o) {
+  const t = a(i);
+  if (!t)
+    return [`${o} must be an object.`];
+  const s = [], n = /* @__PURE__ */ new Set(["tool", "reason"]);
+  return Object.keys(t).forEach((r) => {
+    n.has(r) || s.push(
+      `${o}.${r} is not supported; repair actions support only tool and reason.`
+    );
+  }), t.tool !== "semaphor_propose_semantic_model_change" && s.push(
+    `${o}.tool must be semaphor_propose_semantic_model_change.`
+  ), t.reason !== "missing_relationship" && s.push(`${o}.reason must be missing_relationship.`), s;
+}
+function Je(i, o) {
+  const t = a(i);
+  if (!t)
+    return [`${o} must be an object.`];
+  const s = [], n = /* @__PURE__ */ new Set(["source", "sourceFields", "target", "targetFields"]);
+  Object.keys(t).forEach((r) => {
+    n.has(r) || s.push(
+      `${o}.${r} is not supported; relationship candidates support only source, sourceFields, target, and targetFields.`
+    );
+  }), s.push(
+    ...H(t.source, `${o}.source`)
+  ), s.push(
+    ...H(t.target, `${o}.target`)
+  );
+  for (const r of ["sourceFields", "targetFields"]) {
+    const l = t[r];
+    if (!Array.isArray(l) || l.length === 0) {
+      s.push(`${o}.${r} must be a non-empty endpoint field array.`);
+      continue;
+    }
+    l.forEach((u, c) => {
+      s.push(
+        ...et(u, `${o}.${r}.${c}`)
+      );
+    });
+  }
+  return s;
+}
+function et(i, o) {
+  const t = a(i);
+  if (!t)
+    return [`${o} must be an object.`];
+  const s = [], n = /* @__PURE__ */ new Set(["name", "label", "role", "dataType"]);
+  return Object.keys(t).forEach((r) => {
+    n.has(r) || s.push(
+      `${o}.${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(`${o}.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(`${o}.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(
+    `${o}.dataType must be string, number, boolean, date, datetime, or unknown.`
+  ), s;
+}
+function H(i, o) {
+  const t = a(i);
+  if (!t)
+    return [`${o} must be an object.`];
+  const s = [], n = /* @__PURE__ */ new Set([
+    "kind",
+    "domainId",
+    "datasetName",
+    "datasetId",
+    "label",
+    "sourceKey"
+  ]);
+  return Object.keys(t).forEach((r) => {
+    n.has(r) || s.push(
+      `${o}.${r} is not supported; relationship candidate sources support only semantic identity fields.`
+    );
+  }), t.kind !== "semantic" && s.push(`${o} must use semantic source identity.`), (typeof t.domainId != "string" || !t.domainId.trim() || typeof t.datasetName != "string" || !t.datasetName.trim()) && s.push(`${o} must include semantic domainId and datasetName.`), s;
+}
+function $(i) {
+  return ge.has(i);
+}
+function ee(i) {
+  return he.has(i);
+}
+function h(i, o) {
+  return i === void 0 ? [] : p(i, o);
+}
+function p(i, o) {
+  const t = a(i);
+  if (!t)
+    return [`${o} must be an object.`];
+  const s = [];
+  return (typeof t.name != "string" || !t.name.trim()) && s.push(`${o}.name is required.`), !t.source && typeof t.sourceKey != "string" && s.push(`${o} must include source or sourceKey.`), s;
+}
+function te(i, o) {
+  const t = a(i), s = p(i, o);
+  if (!t || typeof t.sourceKey == "string" && t.sourceKey.trim())
+    return s;
+  if (t.source !== void 0) {
+    const r = w(t.source, `${o}.source`);
+    return r.length === 0 || s.push(...r), s;
+  }
+  return s.includes(`${o} must include source or sourceKey.`) || s.push(`${o} must include source or sourceKey.`), s;
+}
+function a(i) {
+  return i && typeof i == "object" && !Array.isArray(i) ? i : void 0;
+}
+function g(i) {
+  return Array.isArray(i) && i.every((o) => typeof o == "string");
+}
+const m = e.record(e.string(), e.unknown()), R = e.array(m), d = e.enum([
+  "SUM",
+  "COUNT",
+  "AVG",
+  "MIN",
+  "MAX",
+  "MEDIAN",
+  "DISTINCT"
+]), C = e.enum([
+  "postgres",
+  "mysql",
+  "mssql",
+  "snowflake",
+  "clickhouse",
+  "bigquery",
+  "redshift",
+  "duckdb",
+  "sqlite",
+  "unknown"
+]), oe = e.enum([
+  "hour",
+  "day",
+  "week",
+  "month",
+  "quarter",
+  "year"
+]), q = e.enum([
+  "dimension",
+  "measure",
+  "date",
+  "id",
+  "unknown"
+]), x = e.enum([
+  "string",
+  "number",
+  "boolean",
+  "date",
+  "datetime",
+  "unknown"
+]), se = e.enum([
+  "semantic_model",
+  "caller_override",
+  "default_sum"
+]), j = e.union([e.number(), e.string(), e.null()]), D = e.enum([
+  "millisecond",
+  "second",
+  "minute",
+  "hour",
+  "day"
+]), ie = e.union([
+  e.object({
+    type: e.enum(["number", "currency", "percent", "percentage", "scientific"]),
+    locale: e.string().optional(),
+    minimumFractionDigits: e.number().optional(),
+    maximumFractionDigits: e.number().optional(),
+    useGrouping: e.boolean().optional(),
+    prefix: e.string().optional(),
+    suffix: e.string().optional(),
+    negativeStyle: e.enum(["minus", "parentheses"]).optional(),
+    compact: e.boolean().optional(),
+    scale: e.number().optional(),
+    currency: e.string().optional(),
+    percentValueMode: e.enum(["fraction", "whole"]).optional()
+  }).passthrough(),
+  e.object({
+    type: e.enum(["date", "datetime"]),
+    locale: e.string().optional(),
+    pattern: e.string().optional(),
+    relative: e.boolean().optional(),
+    timezone: e.string().optional(),
+    sourceTimezone: e.string().optional(),
+    prefix: e.string().optional(),
+    suffix: e.string().optional()
+  }).passthrough(),
+  e.object({
+    type: e.literal("duration"),
+    inputUnit: D.optional(),
+    outputStyle: e.enum(["compact", "digital", "long"]).optional(),
+    largestUnit: D.optional(),
+    smallestUnit: D.optional(),
+    maxUnits: e.number().optional(),
+    prefix: e.string().optional(),
+    suffix: e.string().optional(),
+    negativeStyle: e.enum(["minus", "parentheses"]).optional()
+  }).passthrough(),
+  e.object({
+    type: e.literal("string"),
+    prefix: e.string().optional(),
+    suffix: e.string().optional()
+  }).passthrough()
+]), tt = e.union([
+  e.object({ kind: e.literal("defaultAggregate") }).passthrough(),
+  e.object({ kind: e.literal("blank") }).passthrough(),
+  e.object({
+    kind: e.literal("labelOnly"),
+    label: e.string().optional()
+  }).passthrough(),
+  e.object({
+    kind: e.literal("customAggregate"),
+    aggregate: d
+  }).passthrough(),
+  e.object({ kind: e.literal("percentOfParent") }).passthrough(),
+  e.object({ kind: e.literal("percentOfGrandTotal") }).passthrough(),
+  e.object({
+    kind: e.literal("customExpression"),
+    expressionId: e.string()
+  }).passthrough()
+]);
+function k(i, o) {
+  return e.object(i).passthrough().superRefine((t, s) => {
+    for (const n of o)
+      Object.prototype.hasOwnProperty.call(t, n) || s.addIssue({
+        code: "custom",
+        path: [n],
+        message: `Required field "${n}" is missing.`
+      });
+  });
+}
+const ne = e.object({
+  kind: e.literal("semantic"),
+  domainId: e.string(),
+  datasetName: e.string(),
+  datasetId: e.string().optional(),
+  label: e.string().optional(),
+  connectionId: e.string().optional()
+}).passthrough(), ot = e.object({
+  kind: e.literal("physical"),
+  connectionId: e.string(),
+  connectionType: e.string().optional(),
+  tableName: e.string(),
+  databaseName: e.string().optional(),
+  schemaName: e.string().optional(),
+  label: e.string().optional(),
+  dialect: C.optional()
+}).passthrough(), st = e.object({
+  kind: e.literal("sql"),
+  connectionId: e.string(),
+  dialect: C.optional(),
+  label: e.string().optional()
+}).passthrough(), S = e.union([
+  ne,
+  ot,
+  st
+]), y = e.object({
+  name: e.string(),
+  label: e.string().optional(),
+  role: q.optional(),
+  dataType: x.optional(),
+  source: S.optional(),
+  aggregate: d.optional()
+}).passthrough(), it = e.object({
+  kind: e.literal("field"),
+  field: y,
+  aggregate: d.optional()
+}).passthrough(), re = e.object({
+  kind: e.literal("derived_field"),
+  name: e.string(),
+  label: e.string(),
+  description: e.string().optional(),
+  resultRole: q,
+  dataType: x,
+  computeStage: e.enum(["row", "aggregate"]),
+  expression: e.string(),
+  expressionLanguage: e.literal("semaphor_sql_template").optional(),
+  inputs: e.record(it),
+  defaultAggregate: d.optional(),
+  aggregationBehavior: e.enum([
+    "additive",
+    "non_additive",
+    "ratio_of_sums",
+    "weighted",
+    "pre_aggregated",
+    "snapshot"
+  ]).optional(),
+  aggregationStrategy: e.enum([
+    "default",
+    "symmetric_aggregate",
+    "aggregate_then_join",
+    "weighted"
+  ]).optional(),
+  format: ie.optional(),
+  tags: e.array(e.string()).optional()
+}).passthrough(), V = y.and(
+  e.object({
+    semanticAggregate: d.optional(),
+    effectiveAggregate: d.optional(),
+    aggregateSource: se.optional(),
+    derivedField: re.optional()
+  }).passthrough()
+), nt = ne, rt = e.object({
+  kind: e.literal("physical"),
+  connectionId: e.string().optional(),
+  connectionType: e.string().optional(),
+  tableName: e.string(),
+  databaseName: e.string().optional(),
+  schemaName: e.string().optional(),
+  label: e.string().optional(),
+  dialect: C.optional()
+}).passthrough(), at = e.object({
+  kind: e.literal("sql"),
+  connectionId: e.string().optional(),
+  dialect: C.optional(),
+  label: e.string().optional()
+}).passthrough(), lt = e.union([
+  nt,
+  rt,
+  at
+]), ut = e.object({
+  key: e.string().optional(),
+  name: e.string(),
+  label: e.string().optional(),
+  role: q.optional(),
+  dataType: x.optional(),
+  source: lt.optional(),
+  aggregate: d.optional(),
+  semanticAggregate: d.optional(),
+  effectiveAggregate: d.optional(),
+  aggregateSource: se.optional(),
+  derivedField: e.never().optional()
+}).passthrough(), O = e.object({
+  key: e.string(),
+  name: e.string(),
+  label: e.string(),
+  role: q.optional(),
+  dataType: x.optional(),
+  aggregate: d.optional(),
+  source: S.optional(),
+  derivedField: re.optional()
+}).passthrough(), ae = e.object({
+  code: e.string(),
+  message: e.string().optional(),
+  invalidField: e.string().optional(),
+  fieldRole: e.enum(["measure", "date", "dimension", "input", "source", "sql"]).optional(),
+  validMeasureCandidates: e.array(e.string()).optional(),
+  validDateCandidates: e.array(e.string()).optional(),
+  validDimensionCandidates: e.array(e.string()).optional(),
+  recommendedNextStep: e.string()
+}).passthrough(), M = e.object({
+  code: e.string(),
+  message: e.string(),
+  path: e.string().optional(),
+  fieldRole: e.enum(["measure", "date", "dimension", "input", "source", "sql"]).optional(),
+  repairHint: ae.optional()
+}).passthrough(), le = e.object({
+  ok: e.boolean(),
+  errors: e.array(M),
+  warnings: e.array(M),
+  repairHints: e.array(ae)
+}).passthrough(), dt = e.object({
+  page: e.number(),
+  pageSize: e.number(),
+  pageCount: e.number(),
+  totalCount: e.number(),
+  hasNextPage: e.boolean(),
+  hasPrevPage: e.boolean()
+}).passthrough(), I = {
+  intentId: e.string().optional(),
+  queryPath: e.enum(["query_spec", "sql", "sql_python"]),
+  warnings: e.array(e.string()).optional(),
+  rowCount: e.number().optional(),
+  rowLimitExceeded: e.boolean().optional(),
+  limit: e.number().optional(),
+  pagination: dt.optional()
+}, ct = e.object({
+  ...I,
+  kind: e.literal("metric"),
+  value: j,
+  measures: e.record(j).optional(),
+  comparison: e.object({
+    kind: e.enum(["previous_period", "previous_year", "target"]),
+    value: j.optional(),
+    delta: e.union([e.number(), e.null()]).optional(),
+    deltaPercent: e.union([e.number(), e.null()]).optional()
+  }).passthrough().optional(),
+  records: R.optional()
+}).passthrough(), pt = e.object({
+  ...I,
+  kind: e.literal("records"),
+  columns: e.array(O),
+  records: R,
+  totals: e.object({
+    mode: e.literal("server"),
+    scope: e.literal("filtered_result"),
+    row: e.record(e.string(), e.unknown()),
+    columns: e.array(O).optional()
+  }).passthrough().optional()
+}).passthrough(), mt = e.object({
+  ...I,
+  kind: e.literal("inputOptions"),
+  options: e.array(
+    k(
+      {
+        label: e.string(),
+        value: e.unknown(),
+        count: e.number().optional(),
+        disambiguation: e.array(e.string()).optional()
+      },
+      ["value"]
+    )
+  )
+}).passthrough(), gt = e.object({
+  ...I,
+  kind: e.literal("sql"),
+  columns: e.array(O),
+  records: R,
+  sqlShape: e.object({
+    statementType: e.string().optional(),
+    explicitLimit: e.number().optional(),
+    hasPythonCode: e.boolean().optional()
+  }).passthrough().optional()
+}).passthrough(), ht = e.object({
+  enabled: e.boolean().optional(),
+  position: e.enum(["before", "after"]).optional(),
+  label: e.string().optional()
+}).passthrough(), Q = e.object({
+  id: e.enum(["rows", "columns"]),
+  levels: e.array(
+    e.object({
+      instanceId: e.string(),
+      fieldKey: e.string(),
+      label: e.string(),
+      field: y,
+      grain: oe.optional(),
+      subtotal: ht.optional()
+    }).passthrough()
+  ),
+  nodeIds: e.array(e.string())
+}).passthrough(), b = k(
+  {
+    instanceId: e.string(),
+    fieldKey: e.string(),
+    value: e.unknown(),
+    label: e.string()
+  },
+  ["value"]
+), ft = e.union([
+  e.object({ kind: e.literal("label") }).passthrough(),
+  e.object({
+    kind: e.literal("field"),
+    field: y,
+    aggregate: d.optional()
+  }).passthrough(),
+  e.object({
+    kind: e.literal("value"),
+    valueId: e.string(),
+    rowPath: e.array(b).optional(),
+    columnPath: e.array(b).optional()
+  }).passthrough()
+]), bt = e.enum([
+  "present",
+  "presentNull",
+  "missing",
+  "densified"
+]), yt = e.enum([
+  "value",
+  "rowSubtotal",
+  "columnSubtotal",
+  "subtotalIntersection",
+  "rowGrandTotal",
+  "columnGrandTotal",
+  "matrixGrandTotal"
+]), vt = e.object({
+  instanceId: e.string(),
+  fieldKey: e.string(),
+  field: y,
+  role: e.enum(["row", "column", "measure", "sort", "filter"]),
+  label: e.string().optional()
+}).passthrough(), $t = e.union([
+  e.object({
+    kind: e.literal("additive"),
+    aggregate: d.optional()
+  }).passthrough(),
+  e.object({
+    kind: e.literal("semiAdditive"),
+    aggregate: d.optional(),
+    grain: oe.optional()
+  }).passthrough(),
+  e.object({
+    kind: e.literal("nonAdditive"),
+    aggregate: d.optional()
+  }).passthrough(),
+  e.object({
+    kind: e.literal("ratio"),
+    numeratorMeasureInstanceId: e.string().optional(),
+    denominatorMeasureInstanceId: e.string().optional()
+  }).passthrough(),
+  e.object({
+    kind: e.literal("custom"),
+    expressionId: e.string().optional()
+  }).passthrough()
+]), St = e.object({
+  instanceId: e.string(),
+  fieldKey: e.string(),
+  label: e.string(),
+  field: y,
+  aggregate: d.optional(),
+  format: ie.optional(),
+  totalBehavior: tt.optional(),
+  semantics: $t
+}).passthrough(), wt = e.object({
+  id: e.string(),
+  measureId: e.string(),
+  aggregate: d.optional(),
+  label: e.string().optional(),
+  source: e.enum([
+    "measureDefault",
+    "rowSubtotal",
+    "columnSubtotal",
+    "subtotalIntersection",
+    "rowGrandTotal",
+    "columnGrandTotal",
+    "matrixGrandTotal",
+    "custom"
+  ]),
+  scope: e.object({
+    rowLevelId: e.string().optional(),
+    columnLevelId: e.string().optional(),
+    rowNodeId: e.string().optional(),
+    columnNodeId: e.string().optional()
+  }).passthrough().optional()
+}).passthrough(), kt = e.object({
+  kind: e.string(),
+  label: e.string().optional(),
+  payload: e.record(e.string(), e.unknown()).optional()
+}).passthrough(), It = k(
+  {
+    id: e.string(),
+    axis: e.enum(["row", "column"]),
+    path: e.array(b),
+    level: e.number(),
+    label: e.string(),
+    value: e.unknown(),
+    parentId: e.string().optional(),
+    hasChildren: e.boolean(),
+    isExpanded: e.boolean().optional(),
+    isSubtotal: e.boolean().optional(),
+    isGrandTotal: e.boolean().optional(),
+    subtotalFunction: d.optional(),
+    childCount: e.number().optional(),
+    actions: e.array(kt).optional()
+  },
+  ["value"]
+), At = e.object({
+  rowHeaderLevels: e.array(
+    e.object({
+      id: e.string(),
+      label: e.string(),
+      fieldInstanceId: e.string()
+    }).passthrough()
+  ),
+  columnHeaderRows: e.array(
+    e.object({
+      id: e.string(),
+      cells: e.array(
+        e.object({
+          id: e.string(),
+          label: e.string(),
+          role: e.enum([
+            "rowHeader",
+            "columnHeader",
+            "measureHeader",
+            "subtotal",
+            "grandTotal"
+          ]),
+          colSpan: e.number(),
+          rowSpan: e.number(),
+          columnPath: e.array(b),
+          measureInstanceId: e.string().optional()
+        }).passthrough()
+      )
+    }).passthrough()
+  ),
+  columns: e.array(
+    e.object({
+      id: e.string(),
+      label: e.string(),
+      columnNodeId: e.string().optional(),
+      columnPath: e.array(b),
+      measureInstanceId: e.string(),
+      role: e.enum(["value", "columnSubtotal", "columnGrandTotal"])
+    }).passthrough()
+  )
+}).passthrough(), _t = k(
+  {
+    rowId: e.string(),
+    columnId: e.string().optional(),
+    measureId: e.string(),
+    value: e.unknown(),
+    formattedValue: e.string().optional(),
+    presence: bt,
+    role: yt,
+    calculationId: e.string().optional()
+  },
+  ["value"]
+), jt = e.object({
+  rows: e.boolean().optional(),
+  columns: e.boolean().optional(),
+  grandTotal: e.union([
+    e.boolean(),
+    e.object({
+      rows: e.boolean().optional(),
+      columns: e.boolean().optional()
+    }).passthrough()
+  ]).optional()
+}).passthrough(), Rt = k(
+  {
+    id: e.string(),
+    axis: e.enum(["row", "column"]),
+    targetInstanceId: e.string().optional(),
+    direction: e.enum(["asc", "desc"]),
+    nulls: e.enum(["warehouseDefault", "first", "last"]).optional(),
+    scope: e.enum(["global", "withinParent"]).optional(),
+    by: ft
+  },
+  ["by"]
+), Ct = e.object({
+  rowOffset: e.number().optional(),
+  rowLimit: e.number().optional(),
+  columnOffset: e.number().optional(),
+  columnLimit: e.number().optional(),
+  hasMoreRows: e.boolean().optional(),
+  hasMoreColumns: e.boolean().optional()
+}).passthrough(), qt = e.object({
+  axis: e.enum(["row", "column"]),
+  path: e.array(b),
+  depth: e.number().optional()
+}).passthrough(), xt = e.object({
+  rowLazyLoading: e.boolean().optional(),
+  columnLazyLoading: e.boolean().optional(),
+  expandableRowNodeIds: e.array(e.string()).optional(),
+  expandableColumnNodeIds: e.array(e.string()).optional(),
+  nextRequests: e.array(qt).optional()
+}).passthrough(), Et = e.object({
+  domains: e.record(
+    e.object({
+      min: e.number().optional(),
+      max: e.number().optional()
+    }).passthrough()
+  ).optional(),
+  rules: e.array(e.record(e.string(), e.unknown())).optional()
+}).passthrough(), Ft = e.object({
+  ...I,
+  kind: e.literal("matrix"),
+  schemaVersion: e.literal(1),
+  shape: e.enum(["hierarchical", "pivot"]),
+  capabilities: e.array(e.string()),
+  executionMetadata: e.record(e.string(), e.unknown()),
+  fieldsById: e.record(e.string(), vt),
+  measuresById: e.record(e.string(), St),
+  calculationsById: e.record(e.string(), wt).optional(),
+  axes: e.object({
+    rows: Q,
+    columns: Q
+  }).passthrough(),
+  nodesById: e.record(e.string(), It),
+  layout: At,
+  cells: e.array(_t),
+  totals: jt,
+  sort: e.array(Rt),
+  formattingContext: Et,
+  pageInfo: Ct.optional(),
+  expansion: xt.optional()
+}).passthrough(), Nt = e.union([
+  ct,
+  pt,
+  mt,
+  gt,
+  Ft
+]), Tt = e.object({
+  status: e.enum([
+    "not_required",
+    "resolved",
+    "missing",
+    "ambiguous",
+    "fanout_risk",
+    "unknown"
+  ]),
+  requiredSources: e.array(S).optional(),
+  relationshipsUsed: e.array(e.string()).optional(),
+  missingSources: e.array(e.string()).optional(),
+  warnings: e.array(e.string()).optional(),
+  message: e.string().optional(),
+  recommendedNextStep: e.string().optional(),
+  joinPlanSummary: e.object({
+    baseSource: S.optional(),
+    joinedSources: e.array(S).optional(),
+    joinCount: e.number().optional()
+  }).passthrough().optional(),
+  fanoutRisk: e.object({
+    status: e.enum(["none", "warning", "error", "unknown"]),
+    message: e.string().optional()
+  }).passthrough().optional()
+}).passthrough(), Y = e.enum([
+  "ambiguous_fields",
+  "empty_result",
+  "missing_grounded_fields",
+  "missing_relationship",
+  "no_grounded_query",
+  "partial_result",
+  "presentation_incomplete",
+  "query_validation_failed",
+  "unsafe_join"
+]), ue = e.object({
+  version: e.literal(1),
+  status: e.enum(["answered", "partial", "blocked"]),
+  summary: e.string(),
+  answered: e.array(
+    e.object({
+      slotId: e.string().optional(),
+      queryId: e.string().optional(),
+      summary: e.string(),
+      evidenceIds: e.array(e.string()).optional(),
+      fieldsUsed: e.array(V).optional()
+    }).passthrough()
+  ),
+  blocked: e.array(
+    e.object({
+      slotId: e.string().optional(),
+      queryId: e.string().optional(),
+      reasonCode: Y,
+      message: e.string(),
+      missingFields: e.array(e.string()).optional(),
+      availableFields: e.array(e.string()).optional(),
+      ambiguousFields: e.array(e.string()).optional(),
+      missingRelationships: e.array(e.string()).optional(),
+      evidenceIds: e.array(e.string()).optional(),
+      neededFromUser: e.array(e.string()).optional(),
+      recommendedNextStep: e.string().optional()
+    }).passthrough()
+  ),
+  semanticModelRecommendations: e.array(
+    e.object({
+      reasonCode: Y,
+      message: e.string(),
+      recommendedNextStep: e.string().optional()
+    }).passthrough()
+  ).optional()
+}).passthrough(), de = e.object({
+  scope: e.literal("filtered_query"),
+  measures: e.record(j)
+}).passthrough(), ce = e.object({
+  answeredObligations: e.array(e.string()),
+  missingObligations: e.array(e.string()),
+  warnings: e.array(M).optional()
+}).passthrough(), Dt = e.object({
+  intentId: e.string().optional(),
+  queryId: e.string().optional(),
+  status: e.enum(["answered", "partial", "failed"]),
+  resultShape: e.enum([
+    "metric",
+    "records",
+    "inputOptions",
+    "sql",
+    "matrix",
+    "period_change",
+    "analysis"
+  ]).optional(),
+  intent: e.unknown().optional(),
+  compiledQuery: e.unknown().optional(),
+  fieldsUsed: e.array(V).optional(),
+  result: Nt.optional(),
+  validation: le,
+  coverage: ce.optional(),
+  missingFields: e.array(e.string()).optional(),
+  warnings: e.array(e.string()).optional(),
+  relationshipDiagnostics: Tt.optional(),
+  diagnosticFeedback: ue.optional(),
+  population: de.optional(),
+  metadata: e.record(e.string(), e.unknown()).optional()
+}).passthrough();
+function Kt(i) {
+  switch (i) {
+    case "boolean":
+      return e.boolean().optional();
+    case "compactExecutionFieldArray":
+      return e.array(ut).optional();
+    case "coverage":
+      return ce.optional();
+    case "diagnosticFeedback":
+      return ue.optional();
+    case "executionFieldArray":
+      return e.array(V).optional();
+    case "executionResult":
+      return Dt.optional();
+    case "number":
+      return e.number().finite().optional();
+    case "population":
+      return de.optional();
+    case "record":
+      return m.optional();
+    case "recordArray":
+      return R.optional();
+    case "responseDetail":
+      return e.enum(["compact", "standard", "debug"]).optional();
+    case "string":
+      return e.string().optional();
+    case "stringArray":
+      return e.array(e.string()).optional();
+    case "unknown":
+      return e.unknown().optional();
+    case "unknownArray":
+      return e.array(e.unknown()).optional();
+    case "validationResult":
+      return le.optional();
+  }
+}
+const Ot = Object.fromEntries(
+  Object.entries(B).map(
+    ([i, o]) => [i, Kt(o)]
+  )
+), Mt = e.object(Ot).strict(), L = e.object({
+  sourceKey: e.string().optional(),
+  kind: e.enum(["semantic", "physical", "sql"]).optional(),
+  domainId: e.string().optional(),
+  datasetName: e.string().optional(),
+  datasetId: e.string().optional(),
+  connectionId: e.string().optional(),
+  tableName: e.string().optional(),
+  label: e.string().optional()
+}).passthrough(), f = e.object({
+  name: e.string(),
+  label: e.string().optional(),
+  role: e.enum(["dimension", "measure", "date", "id", "unknown"]).optional(),
+  dataType: e.enum(["string", "number", "boolean", "date", "datetime", "unknown"]).optional(),
+  aggregate: d.optional(),
+  sourceKey: e.string().optional(),
+  source: L.optional()
+}).passthrough(), pe = e.object({
+  id: e.string().optional(),
+  builder: e.literal("semaphor.inputOptions"),
+  source: L.optional(),
+  sourceKey: e.string().optional(),
+  valueFieldRef: f,
+  labelFieldRef: f,
+  filterFieldRef: f.optional(),
+  population: e.unknown().optional(),
+  dependencies: e.unknown().optional(),
+  limit: e.number().int().positive().optional(),
+  spec: m.optional()
+}).passthrough(), me = e.object({
+  appliesToViewIds: e.array(e.string()).optional(),
+  viewId: e.string().optional(),
+  fieldRef: f,
+  relationshipHint: e.unknown().optional(),
+  relationshipsUsed: e.array(m).optional()
+}).passthrough(), Bt = e.object({
+  id: e.string(),
+  label: e.string().optional(),
+  type: e.string().optional(),
+  serverSide: e.boolean().optional(),
+  fieldRef: f.optional(),
+  optionQuery: pe.optional(),
+  bindings: e.array(me).optional(),
+  appliesToViewIds: e.array(e.string()),
+  relationshipHint: e.unknown().optional(),
+  relationshipsUsed: e.array(m).optional()
+}).passthrough(), Pt = e.object({
+  builder: e.enum([
+    "semaphor.metric",
+    "semaphor.records",
+    "semaphor.matrix",
+    "semaphor.analysis",
+    "semaphor.sql"
+  ]),
+  spec: m,
+  fallbackReason: m.optional()
+}).passthrough(), Vt = e.object({
+  id: e.string(),
+  title: e.string().optional(),
+  purpose: e.string().optional(),
+  sourcePresentation: e.object({
+    sourceKeys: e.array(e.string()).optional(),
+    sourceLabels: e.array(e.string()).optional()
+  }).passthrough().optional(),
+  visual: e.string().optional(),
+  visualSpec: m.optional(),
+  queryKind: e.enum(["metric", "records", "matrix", "analysis", "sql_fallback"]).optional(),
+  sdkBuilder: e.enum([
+    "semaphor.metric",
+    "semaphor.records",
+    "semaphor.matrix",
+    "semaphor.analysis",
+    "semaphor.sql"
+  ]).optional(),
+  sdkSpec: Pt.optional(),
+  fields: e.array(f).optional(),
+  computation: m.optional(),
+  uxExpectations: e.array(e.string()).optional(),
+  validation: m.optional()
+}).passthrough(), Lt = e.object({
+  inputId: e.string(),
+  label: e.string().optional(),
+  type: e.string().optional(),
+  serverSide: e.boolean().optional(),
+  fieldRef: f.optional(),
+  optionQuery: pe.optional(),
+  bindings: e.array(me),
+  appliesToViewIds: e.array(e.string()),
+  notAppliedToViewIds: e.array(e.string())
+}).passthrough(), Yt = e.object({
+  schemaVersion: e.literal(K),
+  title: e.string(),
+  purpose: e.string().optional(),
+  userGoal: e.string().optional(),
+  nextStep: e.string().optional(),
+  sources: e.array(L),
+  inputs: e.array(Bt),
+  views: e.array(Vt),
+  filterContracts: e.array(Lt),
+  implementationChecklist: e.object({
+    schemaVersion: e.string().optional(),
+    requiredDevtools: e.object({
+      mountRootDevtools: e.boolean(),
+      providerDebugBridge: e.string().optional(),
+      panelPosition: e.string().optional(),
+      forbidden: e.array(e.string()).optional()
+    }).passthrough(),
+    requiredInputOptions: e.array(m),
+    filterScopeByInput: e.array(m),
+    bindingsByView: e.record(e.string(), e.array(m)),
+    validationCommands: e.array(e.string()),
+    browserSmokeChecks: e.array(e.string())
+  }).passthrough(),
+  nextRequiredTool: e.object({
+    name: e.string(),
+    reason: e.string().optional()
+  }).optional(),
+  unsupportedInsights: e.array(
+    e.object({
+      title: e.string(),
+      requestedQuestion: e.string(),
+      reason: e.string(),
+      suggestedModelingFix: e.string()
+    }).passthrough()
+  ).optional(),
+  assumptions: e.array(e.string()).optional(),
+  validation: m.optional()
+}).passthrough().superRefine((i, o) => {
+  const t = Z(i);
+  for (const s of t.issues)
+    o.addIssue({
+      code: e.ZodIssueCode.custom,
+      message: s
+    });
+}), Gt = new Set(
+  Object.keys(B)
+);
+function Wt() {
+  return Object.keys(
+    B
+  );
+}
+function Ut(i) {
+  return Gt.has(i);
+}
+function Zt(i) {
+  if (!i || typeof i != "object" || Array.isArray(i))
+    throw new Error("Semaphor analyze result must be an object.");
+  const t = Object.keys(i).filter(
+    (s) => !Ut(s)
+  );
+  if (t.length)
+    throw new Error(
+      `Semaphor analyze result contains unsupported top-level field(s): ${t.join(", ")}.`
+    );
+  return Mt.parse(i);
+}
+export {
+  ce as A,
+  Dt as B,
+  Ot as C,
+  Mt as D,
+  Yt as E,
+  K as S,
+  Ht as a,
+  Ut as b,
+  B as c,
+  ot as d,
+  st as e,
+  S as f,
+  Wt as g,
+  y as h,
+  Qt as i,
+  re as j,
+  V as k,
+  O as l,
+  M as m,
+  le as n,
+  ct as o,
+  Zt as p,
+  pt as q,
+  mt as r,
+  ne as s,
+  gt as t,
+  Ft as u,
+  Z as v,
+  Nt as w,
+  Tt as x,
+  ue as y,
+  de as z
+};