react-semaphor 0.1.325 → 0.1.326

package/dist/analytics-protocol/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function n(i,e,s){return s?{code:i,message:e,path:s}:{code:i,message:e}}function p(i){const e=new Set;for(const s of i){if(e.has(s))return s;e.add(s)}return null}function a(i){return typeof i=="string"&&i.trim().length>0}function l(i){return!!(i&&typeof i=="object"&&!Array.isArray(i))}function m(i,e,s){if(!i||typeof i!="object"){s.push(n("missing_source","Analytics intent needs a source.",e));return}if(i.kind==="semantic"){a(i.domainId)||s.push(n("missing_semantic_domain","Semantic source needs a domainId.",`${e}.domainId`)),a(i.datasetName)||s.push(n("missing_dataset_name","Semantic source needs a datasetName.",`${e}.datasetName`));return}if(i.kind==="physical"){a(i.connectionId)||s.push(n("missing_connection_id","Physical source needs a connectionId.",`${e}.connectionId`)),a(i.tableName)||s.push(n("missing_table_name","Physical source needs a tableName.",`${e}.tableName`));return}if(i.kind==="sql"){a(i.connectionId)||s.push(n("missing_connection_id","SQL source needs a connectionId.",`${e}.connectionId`)),a(i.sql)||s.push(n("missing_sql","SQL source needs SQL text.",`${e}.sql`));return}s.push(n("invalid_source_kind","Source kind is not supported.",e))}function h(i){var r;const e=[],s=[];return!i||typeof i!="object"?{ok:!1,errors:[n("invalid_analytics_intent","Analytics intent must be a structured object.")],warnings:s}:(m(i.source,"source",e),i.kind==="metric"?a(i.metric)||e.push(n("missing_metric","Metric intent needs a metric.","metric")):i.kind==="records"?(!Array.isArray(i.fields)||i.fields.length===0)&&e.push(n("missing_record_fields","Records intent needs at least one field.","fields")):i.kind==="inputOptions"?(!i.field||!a(i.field.name))&&e.push(n("missing_input_options_field","Input options intent needs a field.","field")):i.kind==="sql"?((r=i.source)==null?void 0:r.kind)!=="sql"&&e.push(n("invalid_sql_source","SQL analytics intent must use a SQL source.","source")):e.push(n("invalid_analytics_kind","Analytics kind is not supported.","kind")),{ok:e.length===0,errors:e,warnings:s})}function g(i,e,s,r){if(!i||typeof i!="object"){s.push(n("invalid_view","Dashboard view must be an object.",e));return}if(a(i.title)||s.push(n("missing_view_title","Dashboard view needs a title.",e)),!i.presentation||typeof i.presentation!="object"){s.push(n("missing_presentation","Dashboard view needs a presentation.",`${e}.presentation`));return}if(i.presentation.kind==="text"){a(i.text)||r.push(n("missing_text_content","Text views should include text content.",`${e}.text`));return}if(!i.analytics){s.push(n("missing_view_analytics","Non-text dashboard views need analytics intent.",`${e}.analytics`));return}const u=h(i.analytics);for(const o of u.errors)s.push(n(o.code,o.message,`${e}.analytics${o.path?`.${o.path}`:""}`));for(const o of u.warnings)r.push(n(o.code,o.message,`${e}.analytics${o.path?`.${o.path}`:""}`))}function v(i){const e=[],s=[];if(!i||typeof i!="object")return{ok:!1,errors:[n("invalid_dashboard_intent","Dashboard intent must be a structured object.")],warnings:s};i.version!==1&&e.push(n("invalid_version","Dashboard intent version must be 1.")),i.kind!=="dashboard"&&e.push(n("invalid_kind","Experience intent kind must be dashboard.")),a(i.title)||e.push(n("missing_title","Dashboard intent needs a title.","title"));const r=Array.isArray(i.inputs)?i.inputs:[],u=p(r.filter(l).map(d=>d.id).filter(d=>typeof d=="string"));u&&e.push(n("duplicate_input_id",`Duplicate input id: ${u}.`,"inputs"));for(const[d,t]of r.entries()){const c=`inputs.${d}`;if(!l(t)){e.push(n("invalid_input","Dashboard input must be an object.",c));continue}a(t.id)||e.push(n("missing_input_id","Input needs an id.",`${c}.id`)),a(t.label)||e.push(n("missing_input_label","Input needs a label.",`${c}.label`)),(!t.field||!a(t.field.name))&&e.push(n("missing_input_field","Input needs a field.",`${c}.field`)),t.source&&m(t.source,`${c}.source`,e)}const o=Array.isArray(i.sections)?i.sections:[];o.length===0&&e.push(n("missing_sections","Dashboard intent needs at least one section.","sections"));const _=o.flatMap(d=>d&&typeof d=="object"&&Array.isArray(d.views)?d.views.filter(l).map(t=>t.id).filter(t=>!!t):[]),f=p(_);f&&e.push(n("duplicate_view_id",`Duplicate dashboard view id: ${f}.`,"sections"));for(const[d,t]of o.entries()){const c=`sections.${d}`;if(!t||typeof t!="object"){e.push(n("invalid_section","Dashboard section must be an object.",c));continue}if(a(t.title)||e.push(n("missing_section_title","Dashboard section needs a title.",c)),!Array.isArray(t.views)||t.views.length===0){e.push(n("missing_section_views","Dashboard section needs at least one view.",`${c}.views`));continue}for(const[b,y]of t.views.entries())g(y,`${c}.views.${b}`,e,s)}return{ok:e.length===0,errors:e,warnings:s}}exports.validateSemaphorAnalyticsIntent=h;exports.validateSemaphorDashboardIntent=v;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const y=require("../chunks/validators-DJUMR5An.js");function o(e){return typeof e=="string"?e.trim().toLowerCase():""}function f(e){return String(e.column_name||e.name||e.qualifiedFieldName||"")}function v(e){return Array.from(new Set([e.column_name,e.name,e.qualifiedFieldName,e.alias].filter(i=>typeof i=="string"&&i.trim().length>0).map(i=>i.trim())))}function m(e){const i=o(e);return i?i.includes("int")||i.includes("numeric")||i.includes("decimal")||i.includes("double")||i.includes("float")||i.includes("number")||i.includes("real")||i.includes("money")?"number":i.includes("timestamp")||i.includes("datetime")||i==="time"||i.startsWith("time ")?"datetime":i.includes("date")?"date":i.includes("bool")?"boolean":"string":"unknown"}function A(e){const i=m(e);return i==="date"||i==="datetime"}function u(e){return A(e.dataType||e.data_type)}function p(e){const i=b(e);return i==="id"||i==="row_id"}function l(e){const i=b(e);return p(e)||i.endsWith("_id")||i.endsWith("_key")||i.endsWith("_number")}function b(e){return o(f(e)||e.name||e.alias).replace(/[^a-z0-9]+/g,"_").replace(/^_+|_+$/g,"")}function g(e,i={}){const n=o(e.role);return n==="metric"||n==="measure"?!i.excludeIdentifiers||!l(e):n==="groupby"||n==="dimension"||n==="date"||n==="id"?!1:m(e.dataType||e.data_type)==="number"&&(!i.excludeIdentifiers||!l(e))}function T(e){return!g(e)&&!u(e)}function F(e){return[e.column_name,e.name,e.label,e.alias,e.qualifiedFieldName].filter(i=>typeof i=="string"&&i.trim().length>0).map(i=>o(i).replace(/[^a-z0-9]+/g," ")).join(" ")}function d(e,i){return i.some(n=>{const t=n.replace(/[.*+?^${}()|[\]\\]/g,"\\$&");return new RegExp(`(^|\\s)${t}(\\s|$)`,"i").test(e)})}function C(e){const i=F(e);if(i)return d(i,["pct","percent","percentage","rate","ratio","share","conversion","retention","churn","growth","margin rate","margin pct","margin percent","margin percentage"])?{type:"percent",minimumFractionDigits:0,maximumFractionDigits:1,percentValueMode:"fraction"}:d(i,["revenue","sales","profit","arr","mrr","gmv","amount","price","cost","spend","expense","budget","income","value","booking","bookings"])?{type:"currency",currency:"USD",minimumFractionDigits:0,maximumFractionDigits:1,compact:!0}:d(i,["count","quantity","orders","order","users","customers","tickets","units","sessions","visits","items","rows"])?{type:"number",minimumFractionDigits:0,maximumFractionDigits:0,compact:!0}:{type:"number",minimumFractionDigits:0,maximumFractionDigits:1,compact:!0}}function D(e){const i=new Set,n=new Set,t=new Set;for(const s of e){if(p(s))continue;const c=v(s);if(c.length!==0){if(u(s)){c.forEach(a=>n.add(a));continue}if(g(s,{excludeIdentifiers:!0})){c.forEach(a=>i.add(a));continue}c.forEach(a=>t.add(a))}}return{validMetricCandidates:Array.from(i).sort(),validDateCandidates:Array.from(n).sort(),validDimensionCandidates:Array.from(t).sort()}}const r={kind:"semantic",domainId:"domain_sales",datasetName:"orders",connectionId:"conn_sales",label:"Orders"},_={revenueKpi:{version:1,kind:"metric",id:"revenue-kpi",label:"Revenue",source:r,metric:"revenue",comparison:{kind:"previous_period"},limit:1},revenueTrend:{version:1,kind:"records",id:"revenue-trend",label:"Revenue trend",source:r,fields:[{name:"order_date",role:"date",dataType:"date",label:"Order Date"}],measures:["revenue"],dateField:{name:"order_date",role:"date",dataType:"date"},timeGrain:"month",limit:100},topCustomersRecords:{version:1,kind:"records",id:"top-customers",label:"Top customers",source:r,fields:[{name:"customer_name",role:"dimension",dataType:"string"},{name:"segment",role:"dimension",dataType:"string"},{name:"revenue",role:"measure",dataType:"number"}],measures:["revenue"],orderBy:{field:"revenue",direction:"desc"},limit:20},regionInputOptions:{version:1,kind:"inputOptions",id:"region-options",label:"Region options",source:r,field:{name:"region",role:"dimension",dataType:"string"},limit:100},previousPeriodRevenueComparison:{version:1,kind:"metric",id:"revenue-previous-period",label:"Revenue previous period comparison",source:r,metric:"revenue",dateField:{name:"order_date",role:"date",dataType:"date"},timeGrain:"week",comparison:{kind:"previous_period"},limit:100},boundedSqlRanking:{version:1,kind:"sql",id:"top-customer-ranking-sql",label:"Top customer ranking SQL",source:{kind:"physical",connectionId:"conn_sales",databaseName:"warehouse",schemaName:"public",tableName:"orders",dialect:"postgres"},sql:"SELECT customer_name, SUM(revenue) AS revenue FROM public.orders GROUP BY customer_name ORDER BY revenue DESC LIMIT 20",limit:20,rationale:"Ranking is SQL-natural because it requires ordering grouped aggregate rows.",fields:[{name:"customer_name",role:"dimension",dataType:"string"},{name:"revenue",role:"measure",dataType:"number"}]}};exports.validateSemaphorAnalyticsIntent=y.validateSemaphorAnalyticsIntent;exports.validateSemaphorDashboardIntent=y.validateSemaphorDashboardIntent;exports.SEMAPHOR_ANALYTICS_INTENT_FIXTURES=_;exports.buildAnalyticsCatalogFieldSummary=D;exports.getAnalyticsCatalogFieldCandidates=v;exports.getAnalyticsCatalogFieldName=f;exports.inferAnalyticsMetricFormat=C;exports.isAnalyticsCatalogDateField=u;exports.isAnalyticsCatalogDimensionField=T;exports.isAnalyticsCatalogMetricField=g;exports.isAnalyticsDateLikeDataType=A;exports.isAnalyticsMetricIdentifierField=l;exports.isAnalyticsTechnicalIdentifierField=p;exports.normalizeAnalyticsCatalogDataType=m;exports.normalizeAnalyticsCatalogName=o;

package/dist/analytics-protocol/index.js

@@ -1,240 +1,274 @@
-function s(i, e, n) {
-  return n ? { code: i, message: e, path: n } : { code: i, message: e };
+import { v as C, a as S } from "../chunks/validators-DvTxl9i0.js";
+function d(e) {
+  return typeof e == "string" ? e.trim().toLowerCase() : "";
 }
-function p(i) {
-  const e = /* @__PURE__ */ new Set();
-  for (const n of i) {
-    if (e.has(n))
-      return n;
-    e.add(n);
-  }
-  return null;
+function f(e) {
+  return String(e.column_name || e.name || e.qualifiedFieldName || "");
 }
-function a(i) {
-  return typeof i == "string" && i.trim().length > 0;
+function v(e) {
+  return Array.from(
+    new Set(
+      [
+        e.column_name,
+        e.name,
+        e.qualifiedFieldName,
+        e.alias
+      ].filter(
+        (n) => typeof n == "string" && n.trim().length > 0
+      ).map((n) => n.trim())
+    )
+  );
 }
-function l(i) {
-  return !!(i && typeof i == "object" && !Array.isArray(i));
+function m(e) {
+  const n = d(e);
+  return n ? n.includes("int") || n.includes("numeric") || n.includes("decimal") || n.includes("double") || n.includes("float") || n.includes("number") || n.includes("real") || n.includes("money") ? "number" : n.includes("timestamp") || n.includes("datetime") || n === "time" || n.startsWith("time ") ? "datetime" : n.includes("date") ? "date" : n.includes("bool") ? "boolean" : "string" : "unknown";
 }
-function m(i, e, n) {
-  if (!i || typeof i != "object") {
-    n.push(s("missing_source", "Analytics intent needs a source.", e));
-    return;
-  }
-  if (i.kind === "semantic") {
-    a(i.domainId) || n.push(
-      s(
-        "missing_semantic_domain",
-        "Semantic source needs a domainId.",
-        `${e}.domainId`
-      )
-    ), a(i.datasetName) || n.push(
-      s(
-        "missing_dataset_name",
-        "Semantic source needs a datasetName.",
-        `${e}.datasetName`
-      )
-    );
-    return;
-  }
-  if (i.kind === "physical") {
-    a(i.connectionId) || n.push(
-      s(
-        "missing_connection_id",
-        "Physical source needs a connectionId.",
-        `${e}.connectionId`
-      )
-    ), a(i.tableName) || n.push(
-      s(
-        "missing_table_name",
-        "Physical source needs a tableName.",
-        `${e}.tableName`
-      )
-    );
-    return;
-  }
-  if (i.kind === "sql") {
-    a(i.connectionId) || n.push(
-      s(
-        "missing_connection_id",
-        "SQL source needs a connectionId.",
-        `${e}.connectionId`
-      )
-    ), a(i.sql) || n.push(s("missing_sql", "SQL source needs SQL text.", `${e}.sql`));
-    return;
-  }
-  n.push(s("invalid_source_kind", "Source kind is not supported.", e));
+function b(e) {
+  const n = m(e);
+  return n === "date" || n === "datetime";
 }
-function y(i) {
-  var r;
-  const e = [], n = [];
-  return !i || typeof i != "object" ? {
-    ok: !1,
-    errors: [
-      s(
-        "invalid_analytics_intent",
-        "Analytics intent must be a structured object."
-      )
-    ],
-    warnings: n
-  } : (m(i.source, "source", e), i.kind === "metric" ? a(i.metric) || e.push(
-    s("missing_metric", "Metric intent needs a metric.", "metric")
-  ) : i.kind === "records" ? (!Array.isArray(i.fields) || i.fields.length === 0) && e.push(
-    s(
-      "missing_record_fields",
-      "Records intent needs at least one field.",
-      "fields"
-    )
-  ) : i.kind === "inputOptions" ? (!i.field || !a(i.field.name)) && e.push(
-    s(
-      "missing_input_options_field",
-      "Input options intent needs a field.",
-      "field"
-    )
-  ) : i.kind === "sql" ? ((r = i.source) == null ? void 0 : r.kind) !== "sql" && e.push(
-    s(
-      "invalid_sql_source",
-      "SQL analytics intent must use a SQL source.",
-      "source"
-    )
-  ) : e.push(
-    s("invalid_analytics_kind", "Analytics kind is not supported.", "kind")
-  ), { ok: e.length === 0, errors: e, warnings: n });
+function l(e) {
+  return b(e.dataType || e.data_type);
 }
-function g(i, e, n, r) {
-  if (!i || typeof i != "object") {
-    n.push(s("invalid_view", "Dashboard view must be an object.", e));
-    return;
-  }
-  if (a(i.title) || n.push(s("missing_view_title", "Dashboard view needs a title.", e)), !i.presentation || typeof i.presentation != "object") {
-    n.push(
-      s(
-        "missing_presentation",
-        "Dashboard view needs a presentation.",
-        `${e}.presentation`
-      )
-    );
-    return;
-  }
-  if (i.presentation.kind === "text") {
-    a(i.text) || r.push(
-      s(
-        "missing_text_content",
-        "Text views should include text content.",
-        `${e}.text`
-      )
-    );
-    return;
-  }
-  if (!i.analytics) {
-    n.push(
-      s(
-        "missing_view_analytics",
-        "Non-text dashboard views need analytics intent.",
-        `${e}.analytics`
-      )
-    );
-    return;
-  }
-  const u = y(i.analytics);
-  for (const o of u.errors)
-    n.push(
-      s(o.code, o.message, `${e}.analytics${o.path ? `.${o.path}` : ""}`)
-    );
-  for (const o of u.warnings)
-    r.push(
-      s(
-        o.code,
-        o.message,
-        `${e}.analytics${o.path ? `.${o.path}` : ""}`
-      )
-    );
+function p(e) {
+  const n = g(e);
+  return n === "id" || n === "row_id";
+}
+function u(e) {
+  const n = g(e);
+  return p(e) || n.endsWith("_id") || n.endsWith("_key") || n.endsWith("_number");
+}
+function g(e) {
+  return d(
+    f(e) || e.name || e.alias
+  ).replace(/[^a-z0-9]+/g, "_").replace(/^_+|_+$/g, "");
+}
+function y(e, n = {}) {
+  const i = d(e.role);
+  return i === "metric" || i === "measure" ? !n.excludeIdentifiers || !u(e) : i === "groupby" || i === "dimension" || i === "date" || i === "id" ? !1 : m(
+    e.dataType || e.data_type
+  ) === "number" && (!n.excludeIdentifiers || !u(e));
+}
+function _(e) {
+  return !y(e) && !l(e);
 }
-function v(i) {
-  const e = [], n = [];
-  if (!i || typeof i != "object")
-    return {
-      ok: !1,
-      errors: [
-        s(
-          "invalid_dashboard_intent",
-          "Dashboard intent must be a structured object."
-        )
-      ],
-      warnings: n
+function T(e) {
+  return [
+    e.column_name,
+    e.name,
+    e.label,
+    e.alias,
+    e.qualifiedFieldName
+  ].filter(
+    (n) => typeof n == "string" && n.trim().length > 0
+  ).map(
+    (n) => d(n).replace(/[^a-z0-9]+/g, " ")
+  ).join(" ");
+}
+function c(e, n) {
+  return n.some((i) => {
+    const t = i.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    return new RegExp(`(^|\\s)${t}(\\s|$)`, "i").test(e);
+  });
+}
+function F(e) {
+  const n = T(e);
+  if (n)
+    return c(n, [
+      "pct",
+      "percent",
+      "percentage",
+      "rate",
+      "ratio",
+      "share",
+      "conversion",
+      "retention",
+      "churn",
+      "growth",
+      "margin rate",
+      "margin pct",
+      "margin percent",
+      "margin percentage"
+    ]) ? {
+      type: "percent",
+      minimumFractionDigits: 0,
+      maximumFractionDigits: 1,
+      percentValueMode: "fraction"
+    } : c(n, [
+      "revenue",
+      "sales",
+      "profit",
+      "arr",
+      "mrr",
+      "gmv",
+      "amount",
+      "price",
+      "cost",
+      "spend",
+      "expense",
+      "budget",
+      "income",
+      "value",
+      "booking",
+      "bookings"
+    ]) ? {
+      type: "currency",
+      currency: "USD",
+      minimumFractionDigits: 0,
+      maximumFractionDigits: 1,
+      compact: !0
+    } : c(n, [
+      "count",
+      "quantity",
+      "orders",
+      "order",
+      "users",
+      "customers",
+      "tickets",
+      "units",
+      "sessions",
+      "visits",
+      "items",
+      "rows"
+    ]) ? {
+      type: "number",
+      minimumFractionDigits: 0,
+      maximumFractionDigits: 0,
+      compact: !0
+    } : {
+      type: "number",
+      minimumFractionDigits: 0,
+      maximumFractionDigits: 1,
+      compact: !0
     };
-  i.version !== 1 && e.push(s("invalid_version", "Dashboard intent version must be 1.")), i.kind !== "dashboard" && e.push(s("invalid_kind", "Experience intent kind must be dashboard.")), a(i.title) || e.push(s("missing_title", "Dashboard intent needs a title.", "title"));
-  const r = Array.isArray(i.inputs) ? i.inputs : [], u = p(
-    r.filter(l).map((d) => d.id).filter((d) => typeof d == "string")
-  );
-  u && e.push(
-    s(
-      "duplicate_input_id",
-      `Duplicate input id: ${u}.`,
-      "inputs"
-    )
-  );
-  for (const [d, t] of r.entries()) {
-    const c = `inputs.${d}`;
-    if (!l(t)) {
-      e.push(s("invalid_input", "Dashboard input must be an object.", c));
-      continue;
-    }
-    a(t.id) || e.push(s("missing_input_id", "Input needs an id.", `${c}.id`)), a(t.label) || e.push(
-      s("missing_input_label", "Input needs a label.", `${c}.label`)
-    ), (!t.field || !a(t.field.name)) && e.push(
-      s("missing_input_field", "Input needs a field.", `${c}.field`)
-    ), t.source && m(t.source, `${c}.source`, e);
-  }
-  const o = Array.isArray(i.sections) ? i.sections : [];
-  o.length === 0 && e.push(
-    s(
-      "missing_sections",
-      "Dashboard intent needs at least one section.",
-      "sections"
-    )
-  );
-  const h = o.flatMap(
-    (d) => d && typeof d == "object" && Array.isArray(d.views) ? d.views.filter(l).map((t) => t.id).filter((t) => !!t) : []
-  ), f = p(h);
-  f && e.push(
-    s(
-      "duplicate_view_id",
-      `Duplicate dashboard view id: ${f}.`,
-      "sections"
-    )
-  );
-  for (const [d, t] of o.entries()) {
-    const c = `sections.${d}`;
-    if (!t || typeof t != "object") {
-      e.push(
-        s("invalid_section", "Dashboard section must be an object.", c)
-      );
-      continue;
-    }
-    if (a(t.title) || e.push(
-      s("missing_section_title", "Dashboard section needs a title.", c)
-    ), !Array.isArray(t.views) || t.views.length === 0) {
-      e.push(
-        s(
-          "missing_section_views",
-          "Dashboard section needs at least one view.",
-          `${c}.views`
-        )
-      );
+}
+function D(e) {
+  const n = /* @__PURE__ */ new Set(), i = /* @__PURE__ */ new Set(), t = /* @__PURE__ */ new Set();
+  for (const o of e) {
+    if (p(o))
       continue;
+    const s = v(o);
+    if (s.length !== 0) {
+      if (l(o)) {
+        s.forEach((r) => i.add(r));
+        continue;
+      }
+      if (y(o, { excludeIdentifiers: !0 })) {
+        s.forEach((r) => n.add(r));
+        continue;
+      }
+      s.forEach((r) => t.add(r));
     }
-    for (const [_, b] of t.views.entries())
-      g(
-        b,
-        `${c}.views.${_}`,
-        e,
-        n
-      );
   }
-  return { ok: e.length === 0, errors: e, warnings: n };
+  return {
+    validMetricCandidates: Array.from(n).sort(),
+    validDateCandidates: Array.from(i).sort(),
+    validDimensionCandidates: Array.from(t).sort()
+  };
 }
+const a = {
+  kind: "semantic",
+  domainId: "domain_sales",
+  datasetName: "orders",
+  connectionId: "conn_sales",
+  label: "Orders"
+}, h = {
+  revenueKpi: {
+    version: 1,
+    kind: "metric",
+    id: "revenue-kpi",
+    label: "Revenue",
+    source: a,
+    metric: "revenue",
+    comparison: { kind: "previous_period" },
+    limit: 1
+  },
+  revenueTrend: {
+    version: 1,
+    kind: "records",
+    id: "revenue-trend",
+    label: "Revenue trend",
+    source: a,
+    fields: [
+      { name: "order_date", role: "date", dataType: "date", label: "Order Date" }
+    ],
+    measures: ["revenue"],
+    dateField: { name: "order_date", role: "date", dataType: "date" },
+    timeGrain: "month",
+    limit: 100
+  },
+  topCustomersRecords: {
+    version: 1,
+    kind: "records",
+    id: "top-customers",
+    label: "Top customers",
+    source: a,
+    fields: [
+      { name: "customer_name", role: "dimension", dataType: "string" },
+      { name: "segment", role: "dimension", dataType: "string" },
+      { name: "revenue", role: "measure", dataType: "number" }
+    ],
+    measures: ["revenue"],
+    orderBy: { field: "revenue", direction: "desc" },
+    limit: 20
+  },
+  regionInputOptions: {
+    version: 1,
+    kind: "inputOptions",
+    id: "region-options",
+    label: "Region options",
+    source: a,
+    field: { name: "region", role: "dimension", dataType: "string" },
+    limit: 100
+  },
+  previousPeriodRevenueComparison: {
+    version: 1,
+    kind: "metric",
+    id: "revenue-previous-period",
+    label: "Revenue previous period comparison",
+    source: a,
+    metric: "revenue",
+    dateField: { name: "order_date", role: "date", dataType: "date" },
+    timeGrain: "week",
+    comparison: { kind: "previous_period" },
+    limit: 100
+  },
+  boundedSqlRanking: {
+    version: 1,
+    kind: "sql",
+    id: "top-customer-ranking-sql",
+    label: "Top customer ranking SQL",
+    source: {
+      kind: "physical",
+      connectionId: "conn_sales",
+      databaseName: "warehouse",
+      schemaName: "public",
+      tableName: "orders",
+      dialect: "postgres"
+    },
+    sql: "SELECT customer_name, SUM(revenue) AS revenue FROM public.orders GROUP BY customer_name ORDER BY revenue DESC LIMIT 20",
+    limit: 20,
+    rationale: "Ranking is SQL-natural because it requires ordering grouped aggregate rows.",
+    fields: [
+      { name: "customer_name", role: "dimension", dataType: "string" },
+      { name: "revenue", role: "measure", dataType: "number" }
+    ]
+  }
+};
 export {
-  y as validateSemaphorAnalyticsIntent,
-  v as validateSemaphorDashboardIntent
+  h as SEMAPHOR_ANALYTICS_INTENT_FIXTURES,
+  D as buildAnalyticsCatalogFieldSummary,
+  v as getAnalyticsCatalogFieldCandidates,
+  f as getAnalyticsCatalogFieldName,
+  F as inferAnalyticsMetricFormat,
+  l as isAnalyticsCatalogDateField,
+  _ as isAnalyticsCatalogDimensionField,
+  y as isAnalyticsCatalogMetricField,
+  b as isAnalyticsDateLikeDataType,
+  u as isAnalyticsMetricIdentifierField,
+  p as isAnalyticsTechnicalIdentifierField,
+  m as normalizeAnalyticsCatalogDataType,
+  d as normalizeAnalyticsCatalogName,
+  C as validateSemaphorAnalyticsIntent,
+  S as validateSemaphorDashboardIntent
 };