react-semaphor 0.1.381 → 0.1.382

package/DATA_APP_SDK.md

@@ -0,0 +1,238 @@
+# Data App SDK Quick Reference
+
+Use this as the public package quick reference for Semaphor Data Apps. Prefer
+these patterns over inspecting `dist/types` or SDK implementation files.
+
+## Imports
+
+```tsx
+import {
+  SemaphorDataAppProvider,
+  semaphor,
+  useClearInvalidSemaphorInputValue,
+  useSemaphorInput,
+  useSemaphorInputs,
+  useSemaphorQuery,
+} from "react-semaphor/data-app-sdk";
+
+import type {
+  SemaphorMetricQueryResult,
+  SemaphorRecordsField,
+  SemaphorRecordsQueryResult,
+  SemaphorSourceRef,
+} from "react-semaphor/data-app-sdk";
+```
+
+## Source And Fields
+
+```tsx
+const orders = semaphor.source.semantic({
+  domainId: "sales",
+  datasetName: "orders",
+  datasetId: "sales.orders",
+}) satisfies SemaphorSourceRef;
+
+const revenue = semaphor.field.measure("revenue", {
+  label: "Revenue",
+  dataType: "number",
+  aggregate: "SUM",
+  source: orders,
+}) satisfies SemaphorRecordsField;
+
+const segment = semaphor.field.dimension("segment", {
+  label: "Segment",
+  dataType: "string",
+  source: orders,
+}) satisfies SemaphorRecordsField;
+
+const orderDate = semaphor.field.date("order_date", {
+  label: "Order Date",
+  dataType: "date",
+  source: orders,
+});
+```
+
+## Metric
+
+```tsx
+const revenueKpi = semaphor.metric({
+  id: "revenue-kpi",
+  source: orders,
+  measures: [revenue],
+  primaryMeasure: revenue,
+  dateField: orderDate,
+});
+
+const result = useSemaphorQuery(revenueKpi);
+```
+
+## Records
+
+```tsx
+const revenueBySegment = semaphor.records({
+  id: "revenue-by-segment",
+  source: orders,
+  fields: [segment, revenue],
+  dateField: orderDate,
+  orderBy: { field: revenue, direction: "desc" },
+  limit: 10,
+});
+
+const result = useSemaphorQuery(revenueBySegment);
+```
+
+## Row Access
+
+Read row values with `columns[].key`; display `columns[].label`.
+
+```tsx
+function RecordsTable({ result }: { result: SemaphorRecordsQueryResult }) {
+  const records = result.records ?? [];
+  const columns = result.columns ?? [];
+
+  return (
+    <table>
+      <thead>
+        <tr>
+          {columns.map((column) => (
+            <th key={column.key}>{column.label || column.name}</th>
+          ))}
+        </tr>
+      </thead>
+      <tbody>
+        {records.map((row, rowIndex) => (
+          <tr key={rowIndex}>
+            {columns.map((column) => (
+              <td key={column.key}>{String(row[column.key] ?? "")}</td>
+            ))}
+          </tr>
+        ))}
+      </tbody>
+    </table>
+  );
+}
+```
+
+## Input Options
+
+```tsx
+const segmentFilter = semaphor.filter({
+  id: "segment",
+  label: "Segment",
+  field: segment,
+  operator: "in",
+});
+
+const segmentOptions = semaphor.inputOptions({
+  id: "segment-options",
+  inputId: "segment",
+  source: orders,
+  labelField: segment,
+  valueField: segment,
+  dependencies: { mode: "auto" },
+  limit: 100,
+});
+
+function SegmentFilter() {
+  const segmentHandle = useSemaphorInput(segmentFilter);
+  const optionsResult = useSemaphorQuery(segmentOptions, {
+    inputs: [segmentHandle],
+  });
+
+  useClearInvalidSemaphorInputValue(segmentHandle, optionsResult);
+}
+```
+
+Pass the full options query result to `useClearInvalidSemaphorInputValue`.
+Do not pass only `optionsResult.options`, because idle/loading results can also
+expose an empty options array.
+
+## Shared Inputs With Source-Specific Bindings
+
+Use `semaphor.bindInput(...)` when one visible input maps to different query
+fields.
+
+```tsx
+const dateRange = semaphor.filter({
+  id: "date_range",
+  label: "Date Range",
+  field: orderDate,
+  operator: "between",
+});
+
+function Dashboard() {
+  const dateRangeHandle = useSemaphorInput(dateRange);
+
+  const ordersResult = useSemaphorQuery(ordersQuery, {
+    inputs: [semaphor.bindInput(dateRangeHandle, { field: orderDate })],
+  });
+  const invoicesResult = useSemaphorQuery(invoicesQuery, {
+    inputs: [semaphor.bindInput(dateRangeHandle, { field: invoiceDate })],
+  });
+
+  const range = Array.isArray(dateRangeHandle.value)
+    ? dateRangeHandle.value
+    : [];
+}
+```
+
+## Related Dimension Filters
+
+Use a human-readable related dimension as the visible filter and preserve the
+relationship hint for each fact query.
+
+```tsx
+const material = semaphor.source.semantic({
+  domainId: "ops",
+  datasetName: "dim_material",
+});
+
+const materialFamily = semaphor.field.dimension("material_family", {
+  label: "Material Family",
+  dataType: "string",
+  source: material,
+});
+
+const materialFamilyFilter = semaphor.filter<string[]>({
+  id: "material_family",
+  label: "Material Family",
+  field: materialFamily,
+  operator: "in",
+  multi: true,
+});
+
+const materialOptions = semaphor.inputOptions({
+  id: "material-family-options",
+  inputId: "material_family",
+  source: material,
+  labelField: materialFamily,
+  valueField: materialFamily,
+  limit: 100,
+});
+
+function OpsViews() {
+  const materialHandle = useSemaphorInput(materialFamilyFilter);
+  useSemaphorQuery(materialOptions);
+
+  const purchase = useSemaphorQuery(purchaseQuery, {
+    inputs: [
+      semaphor.bindInput(materialHandle, {
+        field: materialFamily,
+        relationshipHint: { relationshipIds: ["purchase_material"] },
+      }),
+    ],
+  });
+
+  const sales = useSemaphorQuery(salesQuery, {
+    inputs: [
+      semaphor.bindInput(materialHandle, {
+        field: materialFamily,
+        relationshipHint: { relationshipIds: ["sales_material"] },
+      }),
+    ],
+  });
+}
+```
+
+The query result should remain governed by Semaphor. Do not fetch broad rows and
+filter or join them in React to simulate related-dimension behavior.

package/README.md

@@ -1,3 +1,10 @@
+## Data App SDK
+
+For agent-built or custom React data apps, use the public Data App SDK quick
+reference in [`DATA_APP_SDK.md`](./DATA_APP_SDK.md). It covers governed
+`metric` and `records` queries, shared inputs, `inputOptions`, relationship
+hints, and row access through `columns[].key`.
+
 Integrating dashboard into your React app is a straightforward three-step process.
 
 ### **1) Install Semaphor Package**

package/dist/analytics-protocol/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const t=require("../chunks/validators-jpoYhpHh.js"),r=require("../chunks/catalog-field-grounding-8L9I0zdg.js"),l=require("../chunks/source-identity-C-xaeE_I.js");function c(e,a={}){const i=d(e),s={connectionId:a.connectionId,connectionType:e,path:["database","schema","table"],labels:{database:"Database",schema:"Schema",table:"Table"},prefixLevels:["database","schema","table"],dialect:"postgres",supportsFilterClause:!0};return i.includes("postgres")?{...s,prefixLevels:["schema","table"],dialect:"postgres"}:i.includes("mysql")?{...s,prefixLevels:["database","table"],dialect:"mysql",supportsFilterClause:!1}:i.includes("mssql")||i.includes("sqlserver")?{...s,dialect:"mssql",supportsFilterClause:!1}:i.includes("redshift")?{...s,prefixLevels:["schema","table"],dialect:"redshift"}:i.includes("snowflake")?{...s,dialect:"snowflake"}:i.includes("clickhouse")?{connectionId:a.connectionId,connectionType:e,path:["database","table"],labels:{database:"Database",table:"Table"},prefixLevels:["database","table"],dialect:"clickhouse",supportsFilterClause:!1}:i==="s3"||i==="api"?{connectionId:a.connectionId,connectionType:e,path:["table"],labels:{table:i==="api"?"API Table":"File Table"},prefixLevels:["table"],dialect:"duckdb",supportsFilterClause:!0}:i==="googlesheets"||i==="fileupload"?{connectionId:a.connectionId,connectionType:e,path:["table"],labels:{table:"Table"},prefixLevels:["table"],dialect:"postgres",supportsFilterClause:!0}:i==="s3tables"?{...s,labels:{database:"Database",schema:"Namespace",table:"Table"},dialect:"duckdb"}:i==="bigquery"?{...s,labels:{database:"Project",schema:"Dataset",table:"Table"},prefixLevels:["schema","table"],dialect:"bigquery",supportsFilterClause:!1}:s}function u(e){const a=d(e);switch(a){case"mysql":case"bigquery":case"redshift":case"snowflake":case"clickhouse":case"duckdb":case"sqlite":return a;case"mssql":case"sqlserver":return"mssql";case"postgres":case"postgresql":return"postgres";default:return"unknown"}}function m(e){return e.capabilities.prefixLevels.every(a=>!!o(e.source,a))}function p(e){const a=e.quoteIdentifier??b;return e.capabilities.prefixLevels.map(i=>o(e.source,i)).filter(i=>!!i).map(i=>a(i,e.capabilities.dialect)).join(".")}function o(e,a){return a==="database"?e.databaseName:a==="schema"?e.schemaName:e.tableName}function b(e,a){return a==="mysql"||a==="bigquery"||a==="clickhouse"||a==="duckdb"?`\`${e.replace(/`/g,"``")}\``:a==="mssql"?`[${e.replace(/]/g,"]]")}]`:`"${e.replace(/"/g,'""')}"`}function d(e){if(typeof e!="string")return"";const a=[];for(const i of e.trim().toLowerCase())h(i)&&a.push(i);return a.join("")}function h(e){const a=e.charCodeAt(0);return a>=48&&a<=57||a>=97&&a<=122}const n={kind:"semantic",domainId:"domain_sales",datasetName:"orders",connectionId:"conn_sales",label:"Orders"},f={revenueKpi:{version:1,kind:"metric",id:"revenue-kpi",label:"Revenue",source:n,metrics:[{name:"revenue",role:"measure"}],primaryMetric:{name:"revenue",role:"measure"},comparison:{kind:"previous_period"},limit:1},revenueTrend:{version:1,kind:"records",id:"revenue-trend",label:"Revenue trend",source:n,fields:[{name:"order_date",role:"date",dataType:"date",label:"Order Date"},{name:"revenue",role:"measure",dataType:"number"}],dateField:{name:"order_date",role:"date",dataType:"date"},timeGrain:"month",limit:100},topCustomersRecords:{version:1,kind:"records",id:"top-customers",label:"Top customers",source:n,fields:[{name:"customer_name",role:"dimension",dataType:"string"},{name:"segment",role:"dimension",dataType:"string"},{name:"revenue",role:"measure",dataType:"number"}],orderBy:{field:{name:"revenue",role:"measure"},direction:"desc"},limit:20},regionInputOptions:{version:1,kind:"inputOptions",id:"region-options",label:"Region options",source:n,field:{name:"region",role:"dimension",dataType:"string"},limit:100},previousPeriodRevenueComparison:{version:1,kind:"metric",id:"revenue-previous-period",label:"Revenue previous period comparison",source:n,metrics:[{name:"revenue",role:"measure"}],primaryMetric:{name:"revenue",role:"measure"},dateField:{name:"order_date",role:"date",dataType:"date"},timeGrain:"week",comparison:{kind:"previous_period"},limit:100},inboundSupplierConcentration:{version:1,kind:"metric",id:"inbound-supplier-concentration",label:"Inbound supplier concentration",source:n,metrics:[{name:"net_tons",role:"measure"},{name:"ticket_value",role:"measure"}],primaryMetric:{name:"net_tons",role:"measure"},dateField:{name:"ticket_date",role:"date",dataType:"date"},timeWindow:{unit:"month",value:6,anchor:"latest_available"},dimensions:[{name:"supplier_id",role:"dimension",dataType:"number"}],filters:[{field:{name:"direction",role:"dimension",dataType:"string"},operator:"=",values:["Inbound"]}],limit:15},boundedSqlRanking:{version:1,kind:"sql",id:"top-customer-ranking-sql",label:"Top customer ranking SQL",source:{kind:"sql",connectionId:"conn_sales",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.normalizeSemaphorAnalyticsFilterOperator=t.normalizeSemaphorAnalyticsFilterOperator;exports.normalizeSemaphorInputOperator=t.normalizeSemaphorInputOperator;exports.parseSemaphorIsoTimeWindowBoundary=t.parseSemaphorIsoTimeWindowBoundary;exports.validateSemaphorAnalyticsIntent=t.validateSemaphorAnalyticsIntent;exports.validateSemaphorAnalyticsRecoveryPlan=t.validateSemaphorAnalyticsRecoveryPlan;exports.validateSemaphorDashboardIntent=t.validateSemaphorDashboardIntent;exports.validateSemaphorDerivedFieldDefinition=t.validateSemaphorDerivedFieldDefinition;exports.validateSemaphorOperationIntent=t.validateSemaphorOperationIntent;exports.validateSemaphorResultCalculation=t.validateSemaphorResultCalculation;exports.SEMAPHOR_ANALYZE_RESULT_FIELD_CONTRACT=r.SEMAPHOR_ANALYZE_RESULT_FIELD_CONTRACT;exports.buildAnalyticsCatalogFieldSummary=r.buildAnalyticsCatalogFieldSummary;exports.getAnalyticsCatalogFieldCandidates=r.getAnalyticsCatalogFieldCandidates;exports.getAnalyticsCatalogFieldName=r.getAnalyticsCatalogFieldName;exports.getSemaphorAnalyzeResultFieldNames=r.getSemaphorAnalyzeResultFieldNames;exports.isAnalyticsCatalogDateField=r.isAnalyticsCatalogDateField;exports.isAnalyticsCatalogDimensionField=r.isAnalyticsCatalogDimensionField;exports.isAnalyticsCatalogMetricField=r.isAnalyticsCatalogMetricField;exports.isAnalyticsDateLikeDataType=r.isAnalyticsDateLikeDataType;exports.isAnalyticsMetricIdentifierField=r.isAnalyticsMetricIdentifierField;exports.isAnalyticsTechnicalIdentifierField=r.isAnalyticsTechnicalIdentifierField;exports.isSemaphorAnalyzeResultFieldName=r.isSemaphorAnalyzeResultFieldName;exports.normalizeAnalyticsCatalogDataType=r.normalizeAnalyticsCatalogDataType;exports.normalizeAnalyticsCatalogName=r.normalizeAnalyticsCatalogName;exports.parseSemaphorAnalyzeResult=r.parseSemaphorAnalyzeResult;exports.preferSemaphorFieldRefMetadata=l.preferSemaphorFieldRefMetadata;exports.preferSemaphorSourceMetadata=l.preferSemaphorSourceMetadata;exports.semaphorFieldRefsMatch=l.semaphorFieldRefsMatch;exports.semaphorSourceIdentityKey=l.semaphorSourceIdentityKey;exports.semaphorSourcesReferToSameDataset=l.semaphorSourcesReferToSameDataset;exports.SEMAPHOR_ANALYTICS_INTENT_FIXTURES=f;exports.buildSemaphorQualifiedSourcePath=p;exports.getSemaphorConnectionCapabilities=c;exports.normalizeSemaphorDialect=u;exports.semaphorSourceHasRequiredCoordinates=m;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const d=require("../chunks/operators-DrTQsJXv.js"),s=require("../chunks/validators-lWo8m0Q7.js"),o=require("../chunks/analyze-result-contract-CtXfp3nv.js"),i=require("../chunks/catalog-field-grounding-Bnx-3tE0.js"),l=require("../chunks/source-identity-C-xaeE_I.js");function m(e,a={}){const r=c(e),t={connectionId:a.connectionId,connectionType:e,path:["database","schema","table"],labels:{database:"Database",schema:"Schema",table:"Table"},prefixLevels:["database","schema","table"],dialect:"postgres",supportsFilterClause:!0};return r.includes("postgres")?{...t,prefixLevels:["schema","table"],dialect:"postgres"}:r.includes("mysql")?{...t,prefixLevels:["database","table"],dialect:"mysql",supportsFilterClause:!1}:r.includes("mssql")||r.includes("sqlserver")?{...t,dialect:"mssql",supportsFilterClause:!1}:r.includes("redshift")?{...t,prefixLevels:["schema","table"],dialect:"redshift"}:r.includes("snowflake")?{...t,dialect:"snowflake"}:r.includes("clickhouse")?{connectionId:a.connectionId,connectionType:e,path:["database","table"],labels:{database:"Database",table:"Table"},prefixLevels:["database","table"],dialect:"clickhouse",supportsFilterClause:!1}:r==="s3"||r==="api"?{connectionId:a.connectionId,connectionType:e,path:["table"],labels:{table:r==="api"?"API Table":"File Table"},prefixLevels:["table"],dialect:"duckdb",supportsFilterClause:!0}:r==="googlesheets"||r==="fileupload"?{connectionId:a.connectionId,connectionType:e,path:["table"],labels:{table:"Table"},prefixLevels:["table"],dialect:"postgres",supportsFilterClause:!0}:r==="s3tables"?{...t,labels:{database:"Database",schema:"Namespace",table:"Table"},dialect:"duckdb"}:r==="bigquery"?{...t,labels:{database:"Project",schema:"Dataset",table:"Table"},prefixLevels:["schema","table"],dialect:"bigquery",supportsFilterClause:!1}:t}function p(e){const a=c(e);switch(a){case"mysql":case"bigquery":case"redshift":case"snowflake":case"clickhouse":case"duckdb":case"sqlite":return a;case"mssql":case"sqlserver":return"mssql";case"postgres":case"postgresql":return"postgres";default:return"unknown"}}function b(e){return e.capabilities.prefixLevels.every(a=>!!u(e.source,a))}function h(e){const a=e.quoteIdentifier??f;return e.capabilities.prefixLevels.map(r=>u(e.source,r)).filter(r=>!!r).map(r=>a(r,e.capabilities.dialect)).join(".")}function u(e,a){return a==="database"?e.databaseName:a==="schema"?e.schemaName:e.tableName}function f(e,a){return a==="mysql"||a==="bigquery"||a==="clickhouse"||a==="duckdb"?`\`${e.replace(/`/g,"``")}\``:a==="mssql"?`[${e.replace(/]/g,"]]")}]`:`"${e.replace(/"/g,'""')}"`}function c(e){if(typeof e!="string")return"";const a=[];for(const r of e.trim().toLowerCase())y(r)&&a.push(r);return a.join("")}function y(e){const a=e.charCodeAt(0);return a>=48&&a<=57||a>=97&&a<=122}const n={kind:"semantic",domainId:"domain_sales",datasetName:"orders",connectionId:"conn_sales",label:"Orders"},S={revenueKpi:{version:1,kind:"metric",id:"revenue-kpi",label:"Revenue",source:n,measures:[{name:"revenue",role:"measure"}],primaryMeasure:{name:"revenue",role:"measure"},comparison:{kind:"previous_period"},limit:1},revenueTrend:{version:1,kind:"records",id:"revenue-trend",label:"Revenue trend",source:n,fields:[{name:"order_date",role:"date",dataType:"date",label:"Order Date"},{name:"revenue",role:"measure",dataType:"number"}],dateField:{name:"order_date",role:"date",dataType:"date"},timeGrain:"month",limit:100},topCustomersRecords:{version:1,kind:"records",id:"top-customers",label:"Top customers",source:n,fields:[{name:"customer_name",role:"dimension",dataType:"string"},{name:"segment",role:"dimension",dataType:"string"},{name:"revenue",role:"measure",dataType:"number"}],orderBy:{field:{name:"revenue",role:"measure"},direction:"desc"},limit:20},regionInputOptions:{version:1,kind:"inputOptions",id:"region-options",label:"Region options",inputId:"region",source:n,labelField:{name:"region",role:"dimension",dataType:"string"},valueField:{name:"region",role:"dimension",dataType:"string"},limit:100},previousPeriodRevenueComparison:{version:1,kind:"metric",id:"revenue-previous-period",label:"Revenue previous period comparison",source:n,measures:[{name:"revenue",role:"measure"}],primaryMeasure:{name:"revenue",role:"measure"},dateField:{name:"order_date",role:"date",dataType:"date"},timeGrain:"week",comparison:{kind:"previous_period"},limit:100},inboundSupplierConcentration:{version:1,kind:"metric",id:"inbound-supplier-concentration",label:"Inbound supplier concentration",source:n,measures:[{name:"net_tons",role:"measure"},{name:"ticket_value",role:"measure"}],primaryMeasure:{name:"net_tons",role:"measure"},dateField:{name:"ticket_date",role:"date",dataType:"date"},timeWindow:{unit:"month",value:6,anchor:"latest_available"},dimensions:[{name:"supplier_id",role:"dimension",dataType:"number"}],filters:[{field:{name:"direction",role:"dimension",dataType:"string"},operator:"=",values:["Inbound"]}],limit:15},boundedSqlRanking:{version:1,kind:"sql",id:"top-customer-ranking-sql",label:"Top customer ranking SQL",source:{kind:"sql",connectionId:"conn_sales",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.normalizeSemaphorAnalyticsFilterOperator=d.normalizeSemaphorAnalyticsFilterOperator;exports.normalizeSemaphorInputOperator=d.normalizeSemaphorInputOperator;exports.parseSemaphorIsoTimeWindowBoundary=s.parseSemaphorIsoTimeWindowBoundary;exports.validateSemaphorAnalyticsIntent=s.validateSemaphorAnalyticsIntent;exports.validateSemaphorAnalyticsRecoveryPlan=s.validateSemaphorAnalyticsRecoveryPlan;exports.validateSemaphorDashboardIntent=s.validateSemaphorDashboardIntent;exports.validateSemaphorDerivedFieldDefinition=s.validateSemaphorDerivedFieldDefinition;exports.validateSemaphorOperationIntent=s.validateSemaphorOperationIntent;exports.validateSemaphorResultCalculation=s.validateSemaphorResultCalculation;exports.SEMAPHOR_ANALYZE_RESULT_FIELD_CONTRACT=o.SEMAPHOR_ANALYZE_RESULT_FIELD_CONTRACT;exports.getSemaphorAnalyzeResultFieldNames=o.getSemaphorAnalyzeResultFieldNames;exports.isSemaphorAnalyzeResultFieldName=o.isSemaphorAnalyzeResultFieldName;exports.parseSemaphorAnalyzeResult=o.parseSemaphorAnalyzeResult;exports.buildAnalyticsCatalogFieldSummary=i.buildAnalyticsCatalogFieldSummary;exports.getAnalyticsCatalogFieldCandidates=i.getAnalyticsCatalogFieldCandidates;exports.getAnalyticsCatalogFieldName=i.getAnalyticsCatalogFieldName;exports.isAnalyticsCatalogDateField=i.isAnalyticsCatalogDateField;exports.isAnalyticsCatalogDimensionField=i.isAnalyticsCatalogDimensionField;exports.isAnalyticsCatalogMetricField=i.isAnalyticsCatalogMetricField;exports.isAnalyticsDateLikeDataType=i.isAnalyticsDateLikeDataType;exports.isAnalyticsMetricIdentifierField=i.isAnalyticsMetricIdentifierField;exports.isAnalyticsTechnicalIdentifierField=i.isAnalyticsTechnicalIdentifierField;exports.normalizeAnalyticsCatalogDataType=i.normalizeAnalyticsCatalogDataType;exports.normalizeAnalyticsCatalogName=i.normalizeAnalyticsCatalogName;exports.preferSemaphorFieldRefMetadata=l.preferSemaphorFieldRefMetadata;exports.preferSemaphorSourceMetadata=l.preferSemaphorSourceMetadata;exports.semaphorFieldRefsMatch=l.semaphorFieldRefsMatch;exports.semaphorSourceIdentityKey=l.semaphorSourceIdentityKey;exports.semaphorSourcesReferToSameDataset=l.semaphorSourcesReferToSameDataset;exports.SEMAPHOR_ANALYTICS_INTENT_FIXTURES=S;exports.buildSemaphorQualifiedSourcePath=h;exports.getSemaphorConnectionCapabilities=m;exports.normalizeSemaphorDialect=p;exports.semaphorSourceHasRequiredCoordinates=b;

package/dist/analytics-protocol/index.js

@@ -1,6 +1,8 @@
-import { a as h, n as v, p as g, c as y, e as S, f as k, v as C, d as T, b as I } from "../chunks/validators-CtNmgsvG.js";
-import { S as F, l as q, b as R, a as _, g as L, e as D, k as N, j as x, d as M, h as O, f as z, i as E, c as w, n as P, p as B } from "../chunks/catalog-field-grounding-BK4BX8sZ.js";
-import { c as Q, p as U, b as Y, s as G, a as H } from "../chunks/source-identity-Dj3dryN9.js";
+import { a as h, n as v } from "../chunks/operators-C8TxpM4C.js";
+import { p as y, b as S, d as T, e as C, v as I, c as k, a as F } from "../chunks/validators-CHPH6ORs.js";
+import { S as q, g as R, i as _, p as L } from "../chunks/analyze-result-contract-DuhlklhI.js";
+import { j as x, a as N, g as M, c as O, h as z, f as E, i as w, e as P, d as B, b as j, n as Q } from "../chunks/catalog-field-grounding-CJKAqtiC.js";
+import { p as Y, c as G, s as H, a as $, b as K } from "../chunks/source-identity-CN4xiyKJ.js";
 function d(e, a = {}) {
   const r = n(e), s = {
     connectionId: a.connectionId,
@@ -86,7 +88,7 @@ function d(e, a = {}) {
     supportsFilterClause: !1
   } : s;
 }
-function c(e) {
+function u(e) {
   const a = n(e);
   switch (a) {
     case "mysql":
@@ -107,7 +109,7 @@ function c(e) {
       return "unknown";
   }
 }
-function u(e) {
+function c(e) {
   return e.capabilities.prefixLevels.every(
     (a) => !!t(e.source, a)
   );
@@ -147,8 +149,8 @@ const i = {
     id: "revenue-kpi",
     label: "Revenue",
     source: i,
-    metrics: [{ name: "revenue", role: "measure" }],
-    primaryMetric: { name: "revenue", role: "measure" },
+    measures: [{ name: "revenue", role: "measure" }],
+    primaryMeasure: { name: "revenue", role: "measure" },
     comparison: { kind: "previous_period" },
     limit: 1
   },
@@ -185,8 +187,10 @@ const i = {
     kind: "inputOptions",
     id: "region-options",
     label: "Region options",
+    inputId: "region",
     source: i,
-    field: { name: "region", role: "dimension", dataType: "string" },
+    labelField: { name: "region", role: "dimension", dataType: "string" },
+    valueField: { name: "region", role: "dimension", dataType: "string" },
     limit: 100
   },
   previousPeriodRevenueComparison: {
@@ -195,8 +199,8 @@ const i = {
     id: "revenue-previous-period",
     label: "Revenue previous period comparison",
     source: i,
-    metrics: [{ name: "revenue", role: "measure" }],
-    primaryMetric: { name: "revenue", role: "measure" },
+    measures: [{ name: "revenue", role: "measure" }],
+    primaryMeasure: { name: "revenue", role: "measure" },
     dateField: { name: "order_date", role: "date", dataType: "date" },
     timeGrain: "week",
     comparison: { kind: "previous_period" },
@@ -208,11 +212,11 @@ const i = {
     id: "inbound-supplier-concentration",
     label: "Inbound supplier concentration",
     source: i,
-    metrics: [
+    measures: [
       { name: "net_tons", role: "measure" },
       { name: "ticket_value", role: "measure" }
     ],
-    primaryMetric: { name: "net_tons", role: "measure" },
+    primaryMeasure: { name: "net_tons", role: "measure" },
     dateField: { name: "ticket_date", role: "date", dataType: "date" },
     timeWindow: { unit: "month", value: 6, anchor: "latest_available" },
     dimensions: [{ name: "supplier_id", role: "dimension", dataType: "number" }],
@@ -246,37 +250,37 @@ const i = {
 };
 export {
   p as SEMAPHOR_ANALYTICS_INTENT_FIXTURES,
-  F as SEMAPHOR_ANALYZE_RESULT_FIELD_CONTRACT,
-  q as buildAnalyticsCatalogFieldSummary,
+  q as SEMAPHOR_ANALYZE_RESULT_FIELD_CONTRACT,
+  x as buildAnalyticsCatalogFieldSummary,
   m as buildSemaphorQualifiedSourcePath,
-  R as getAnalyticsCatalogFieldCandidates,
-  _ as getAnalyticsCatalogFieldName,
-  L as getSemaphorAnalyzeResultFieldNames,
+  N as getAnalyticsCatalogFieldCandidates,
+  M as getAnalyticsCatalogFieldName,
+  R as getSemaphorAnalyzeResultFieldNames,
   d as getSemaphorConnectionCapabilities,
-  D as isAnalyticsCatalogDateField,
-  N as isAnalyticsCatalogDimensionField,
-  x as isAnalyticsCatalogMetricField,
-  M as isAnalyticsDateLikeDataType,
-  O as isAnalyticsMetricIdentifierField,
-  z as isAnalyticsTechnicalIdentifierField,
-  E as isSemaphorAnalyzeResultFieldName,
-  w as normalizeAnalyticsCatalogDataType,
-  P as normalizeAnalyticsCatalogName,
+  O as isAnalyticsCatalogDateField,
+  z as isAnalyticsCatalogDimensionField,
+  E as isAnalyticsCatalogMetricField,
+  w as isAnalyticsDateLikeDataType,
+  P as isAnalyticsMetricIdentifierField,
+  B as isAnalyticsTechnicalIdentifierField,
+  _ as isSemaphorAnalyzeResultFieldName,
+  j as normalizeAnalyticsCatalogDataType,
+  Q as normalizeAnalyticsCatalogName,
   h as normalizeSemaphorAnalyticsFilterOperator,
-  c as normalizeSemaphorDialect,
+  u as normalizeSemaphorDialect,
   v as normalizeSemaphorInputOperator,
-  B as parseSemaphorAnalyzeResult,
-  g as parseSemaphorIsoTimeWindowBoundary,
-  Q as preferSemaphorFieldRefMetadata,
-  U as preferSemaphorSourceMetadata,
-  Y as semaphorFieldRefsMatch,
-  u as semaphorSourceHasRequiredCoordinates,
-  G as semaphorSourceIdentityKey,
-  H as semaphorSourcesReferToSameDataset,
-  y as validateSemaphorAnalyticsIntent,
-  S as validateSemaphorAnalyticsRecoveryPlan,
-  k as validateSemaphorDashboardIntent,
-  C as validateSemaphorDerivedFieldDefinition,
-  T as validateSemaphorOperationIntent,
-  I as validateSemaphorResultCalculation
+  L as parseSemaphorAnalyzeResult,
+  y as parseSemaphorIsoTimeWindowBoundary,
+  Y as preferSemaphorFieldRefMetadata,
+  G as preferSemaphorSourceMetadata,
+  H as semaphorFieldRefsMatch,
+  c as semaphorSourceHasRequiredCoordinates,
+  $ as semaphorSourceIdentityKey,
+  K as semaphorSourcesReferToSameDataset,
+  S as validateSemaphorAnalyticsIntent,
+  T as validateSemaphorAnalyticsRecoveryPlan,
+  C as validateSemaphorDashboardIntent,
+  I as validateSemaphorDerivedFieldDefinition,
+  k as validateSemaphorOperationIntent,
+  F as validateSemaphorResultCalculation
 };

package/dist/brand-studio/index.cjs

@@ -1,4 +1,4 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("react/jsx-runtime"),m=require("react"),d=require("../chunks/switch-Jhyl63RF.js"),A=require("../chunks/index-DRlMUglg.js");require("../chunks/index-BxM99sFL.js");require("../chunks/catalog-field-grounding-8L9I0zdg.js");const V=require("../chunks/palette-SimHJELn.js"),ge=require("../chunks/braces-BT-ZyB-g.js"),be=require("../chunks/save-D2O96E5A.js"),fe=require("../chunks/layout-grid-DccceHv4.js");/**
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("react/jsx-runtime"),m=require("react"),d=require("../chunks/switch-k7kj6NRg.js"),A=require("../chunks/index-DRlMUglg.js");require("../chunks/index-BxM99sFL.js");require("../chunks/analyze-result-contract-CtXfp3nv.js");const V=require("../chunks/palette-9zLPGlj2.js"),ge=require("../chunks/braces-CGi-YFZp.js"),be=require("../chunks/save-8A_q6K4E.js"),fe=require("../chunks/layout-grid-jJQUqDN9.js");/**
  * @license lucide-react v0.453.0 - ISC
  *
  * This source code is licensed under the ISC license.

package/dist/brand-studio/index.js

@@ -1,13 +1,13 @@
 import { jsxs as d, jsx as r, Fragment as ce } from "react/jsx-runtime";
 import m from "react";
-import { c as ae, a as q, P as ge, b as be, B as C, d as fe, U as De, C as Ie, R as me, f as le, X as Je, S as se, e as je, T as Le, I as $e, J as U, K as _e, M, N as Ve, O as Ue, Q as Me, V as Ge, L as E, W as K, Y as Q, Z as ee, _ as he, $ as re, a0 as oe, a1 as ke, a2 as xe, a3 as ye, a4 as ve, a5 as Ce, a6 as We } from "../chunks/switch-DMPsMpHW.js";
+import { c as ae, a as q, P as ge, b as be, B as C, d as fe, U as De, C as Ie, R as me, f as le, X as Je, S as se, e as je, T as Le, I as $e, J as U, K as _e, M, N as Ve, O as Ue, Q as Me, V as Ge, L as E, W as K, Y as Q, Z as ee, _ as he, $ as re, a0 as oe, a1 as ke, a2 as xe, a3 as ye, a4 as ve, a5 as Ce, a6 as We } from "../chunks/switch-DArtNJZh.js";
 import { r as He, v as Ye, A as Xe, a as Ze, p as qe } from "../chunks/index-CJdxSyQq.js";
 import "../chunks/index-CuHybtft.js";
-import "../chunks/catalog-field-grounding-BK4BX8sZ.js";
-import { P as G } from "../chunks/palette-DCzLwqIw.js";
-import { B as Ke } from "../chunks/braces-DOxxfERN.js";
-import { S as Qe } from "../chunks/save-zNVYH02T.js";
-import { L as er } from "../chunks/layout-grid-DTbOIOsE.js";
+import "../chunks/analyze-result-contract-DuhlklhI.js";
+import { P as G } from "../chunks/palette-xU9Qt6bE.js";
+import { B as Ke } from "../chunks/braces-CP8BEzl3.js";
+import { S as Qe } from "../chunks/save-DzciESDh.js";
+import { L as er } from "../chunks/layout-grid-BsKH3TgY.js";
 /**
  * @license lucide-react v0.453.0 - ISC
  *

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

@@ -0,0 +1 @@
+"use strict";const t={answerSummary:"string",responseDetail:"responseDetail",mode:"string",comparisonType:"string",executionResult:"unknown",compiledQuery:"unknown",data:"unknown",resultSets:"record",columns:"unknownArray",records:"recordArray",rowCount:"number",rowLimitExceeded:"boolean",output:"string",querySpec:"unknown",metadata:"record",validation:"unknown",coverage:"unknown",diagnosticFeedback:"unknown",missingFields:"stringArray",warnings:"unknownArray",comparison:"unknown",population:"unknown",comparisons:"recordArray",fieldsUsed:"unknown",changes:"recordArray",largestNegativeChanges:"recordArray",largestPositiveChanges:"recordArray",drivers:"recordArray",absoluteDeltaDrivers:"recordArray",largestNegativeDrivers:"recordArray",largestPositiveDrivers:"recordArray",periodRows:"recordArray",sql:"unknown",omitted:"stringArray"},u=new Set(Object.keys(t)),y=new Set(["compact","standard","debug"]);function d(){return Object.keys(t)}function c(r){return u.has(r)}function A(r){if(!r||typeof r!="object"||Array.isArray(r))throw new Error("Semaphor analyze result must be an object.");const e=r,n=Object.keys(e).filter(o=>!c(o));if(n.length)throw new Error(`Semaphor analyze result contains unsupported top-level field(s): ${n.join(", ")}.`);for(const[o,s]of Object.entries(e)){if(s===void 0)continue;const a=t[o];if(!l(s,a))throw new Error(`Semaphor analyze result field "${o}" does not match contract kind "${a}".`)}return e}function l(r,e){switch(e){case"boolean":return typeof r=="boolean";case"number":return typeof r=="number"&&Number.isFinite(r);case"record":return i(r);case"recordArray":return Array.isArray(r)&&r.every(i);case"responseDetail":return typeof r=="string"&&y.has(r);case"string":return typeof r=="string";case"stringArray":return Array.isArray(r)&&r.every(n=>typeof n=="string");case"unknown":return!0;case"unknownArray":return Array.isArray(r)}}function i(r){return!!(r&&typeof r=="object"&&!Array.isArray(r))}exports.SEMAPHOR_ANALYZE_RESULT_FIELD_CONTRACT=t;exports.getSemaphorAnalyzeResultFieldNames=d;exports.isSemaphorAnalyzeResultFieldName=c;exports.parseSemaphorAnalyzeResult=A;

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

@@ -0,0 +1,102 @@
+const t = {
+  answerSummary: "string",
+  responseDetail: "responseDetail",
+  mode: "string",
+  comparisonType: "string",
+  executionResult: "unknown",
+  compiledQuery: "unknown",
+  data: "unknown",
+  resultSets: "record",
+  columns: "unknownArray",
+  records: "recordArray",
+  rowCount: "number",
+  rowLimitExceeded: "boolean",
+  output: "string",
+  querySpec: "unknown",
+  metadata: "record",
+  validation: "unknown",
+  coverage: "unknown",
+  diagnosticFeedback: "unknown",
+  missingFields: "stringArray",
+  warnings: "unknownArray",
+  comparison: "unknown",
+  population: "unknown",
+  comparisons: "recordArray",
+  fieldsUsed: "unknown",
+  changes: "recordArray",
+  largestNegativeChanges: "recordArray",
+  largestPositiveChanges: "recordArray",
+  drivers: "recordArray",
+  absoluteDeltaDrivers: "recordArray",
+  largestNegativeDrivers: "recordArray",
+  largestPositiveDrivers: "recordArray",
+  periodRows: "recordArray",
+  sql: "unknown",
+  omitted: "stringArray"
+}, c = new Set(
+  Object.keys(t)
+), u = /* @__PURE__ */ new Set([
+  "compact",
+  "standard",
+  "debug"
+]);
+function A() {
+  return Object.keys(
+    t
+  );
+}
+function y(r) {
+  return c.has(r);
+}
+function l(r) {
+  if (!r || typeof r != "object" || Array.isArray(r))
+    throw new Error("Semaphor analyze result must be an object.");
+  const e = r, n = Object.keys(e).filter(
+    (o) => !y(o)
+  );
+  if (n.length)
+    throw new Error(
+      `Semaphor analyze result contains unsupported top-level field(s): ${n.join(", ")}.`
+    );
+  for (const [o, s] of Object.entries(e)) {
+    if (s === void 0)
+      continue;
+    const a = t[o];
+    if (!d(s, a))
+      throw new Error(
+        `Semaphor analyze result field "${o}" does not match contract kind "${a}".`
+      );
+  }
+  return e;
+}
+function d(r, e) {
+  switch (e) {
+    case "boolean":
+      return typeof r == "boolean";
+    case "number":
+      return typeof r == "number" && Number.isFinite(r);
+    case "record":
+      return i(r);
+    case "recordArray":
+      return Array.isArray(r) && r.every(i);
+    case "responseDetail":
+      return typeof r == "string" && u.has(r);
+    case "string":
+      return typeof r == "string";
+    case "stringArray":
+      return Array.isArray(r) && r.every((n) => typeof n == "string");
+    case "unknown":
+      return !0;
+    case "unknownArray":
+      return Array.isArray(r);
+  }
+}
+function i(r) {
+  return !!(r && typeof r == "object" && !Array.isArray(r));
+}
+export {
+  t as S,
+  A as g,
+  y as i,
+  l as p
+};

package/dist/chunks/{braces-BT-ZyB-g.js → braces-CGi-YFZp.js}

@@ -1,4 +1,4 @@
-"use strict";const e=require("./switch-Jhyl63RF.js");/**
+"use strict";const e=require("./switch-k7kj6NRg.js");/**
  * @license lucide-react v0.453.0 - ISC
  *
  * This source code is licensed under the ISC license.

package/dist/chunks/{braces-DOxxfERN.js → braces-CP8BEzl3.js}

@@ -1,4 +1,4 @@
-import { c as a } from "./switch-DMPsMpHW.js";
+import { c as a } from "./switch-DArtNJZh.js";
 /**
  * @license lucide-react v0.453.0 - ISC
  *

package/dist/chunks/{calendar-preferences-dialog-Dsgs8WDv.js → calendar-preferences-dialog-CV4xF2Tp.js}

@@ -1,9 +1,9 @@
 import { jsx as r, jsxs as s, Fragment as X } from "react/jsx-runtime";
 import ee, { useState as h, useCallback as F, useEffect as ae, useMemo as H } from "react";
-import { u as re, b as te, c as se, d as ne, e as le, f as oe, R as W, g as O, C as ie, h as ce, i as de, j as ue, k as me, l as _, m as R, n as fe, o as he, p as N } from "./index-DlprYjr6.js";
-import { a as S, L as G, P as pe, b as ge, B as j, d as ve, e as V, f as be } from "./switch-DMPsMpHW.js";
+import { u as re, b as te, c as se, d as ne, e as le, f as oe, R as W, g as O, C as ie, h as ce, i as de, j as ue, k as me, l as _, m as R, n as fe, o as he, p as N } from "./index-BAsWLkZ8.js";
+import { a as S, L as G, P as pe, b as ge, B as j, d as ve, e as V, f as be } from "./switch-DArtNJZh.js";
 import "./index-CuHybtft.js";
-import "./catalog-field-grounding-BK4BX8sZ.js";
+import "./analyze-result-contract-DuhlklhI.js";
 function we(n = {}) {
   var C, A, E, L;
   const { authToken: c, tokenProps: e } = re(), p = n.enabled ?? !0, d = (c == null ? void 0 : c.accessToken) ?? null, u = (e == null ? void 0 : e.apiServiceUrl) ?? null, [I, k] = h(!1), [y, b] = h(!1), [m, g] = h(!1), [T, o] = h(null), [v, w] = h(null), P = v || {